CodeSampleX

Sample

electron 33.4.11: BrowserWindow

Verified sample for npm electron 33.4.11: BrowserWindow. The contract ran on node 22 · linux alpine/x64 · docker and passed: electron type definitions…

sha256:ca5b20ab10e8ad1ac85c77b95287bc7a00753540b987fd900857a5cad8ff079b

This network offers one thing: a sample that builds. It ran the sample in a sandbox and kept the signed receipt. It grades nothing and warrants nothing — whether the same code builds where you are is not something it measured. How many distinct signing keys filed a passing contract receipt. One is the author alone; more than one means somebody else built it too. A key is self-generated with nothing registered behind it, so it counts keys, not people. MIT-0

Execution evidence

The declared environment and the signed runs are kept apart, so you can see exactly what this sample ran and where.

Evidence basis
Signed contract pass
Verification receipts
1
Signing keys that built it
1
Declared environment node 22.23 linux 24 · ubuntu · glibc 2.39 x64 node 22.23 javascript npm 10

Verification-run environments

Environment Contract Stages Run
node 22 · linux alpine/x64 · docker ed25519:c1973797be207ac4 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · node-typescript@1node:22-alpine@sha256:c610fcdfb1d5…
2026-08-26

Case

HOW
Goal
verify electron.BrowserWindow in pkg:npm/electron@33.4.11
Packages
Symbols
  • electron.BrowserWindow
Environment
node 22.23.2
Created
2026-08-26T07:50:22Z

Contract

  1. electron type definitions declare BrowserWindow class with lifecycle methods, window state management, and static window lookup helpers
  2. BrowserWindow constructor validates options and initializes default window geometry and web preferences
  3. BrowserWindow manages window visibility, focus, and state transitions with corresponding event emissions
  4. BrowserWindow tracks window bounds, title, and destruction lifecycle across window instances
  5. BrowserWindow static registry maintains active instances and resolves windows by numeric ID
  6. BrowserWindow webContents handles URL and file navigation states

Files

  • PROMPT.md
  • csx.json
  • index.js
  • package-lock.json
  • package.json
  • spec.json
  • test/contract.cjs

Download the source artifact (tar.gz)

Source

PROMPT.md
Clean-room public code sample — generation instructions

Write a brand-new, minimal, self-contained code sample in this clean-room directory.
Do not copy, paraphrase, or reference any existing project source. Work only from this spec.

A csx.json manifest scaffold already exists. Do not recreate it from memory. Preserve its case.goal, packages and symbols; fill its empty case.contract with exact assertions and correct its environment, commands and verifierAdapter for the files you generate.

Goal: verify electron.BrowserWindow in pkg:npm/electron@33.4.11
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/electron@33.4.11
Demonstrate these symbols/APIs:
  - electron.BrowserWindow
Constraints:
  - executionContext: node
Required runtime conditions:
  - ecosystem: npm
  - language: javascript
  - moduleSystem: cjs
  - packageManager: npm@10.9.8
  - runtime: node@22.23.2

Rules:
  - One focused purpose; the smallest project that proves the goal.
  - Include a contract test (test/contract.*) that runs OFFLINE and exits 0 exactly when the goal behavior works.
  - Pin every dependency with a lockfile so resolution is reproducible.
  - No secrets, credentials, or tokens. No real URLs (only example.com or localhost). No absolute paths.
  - No personal names, emails, company names, or project identifiers of any kind.
  - No binaries and no generated output (node_modules, dist, target, venv, .git, .env).
  - Keep it under 200 files and 256KB packed.
csx.json
{"case":{"caseId":"case:sha256:2a656b3bd345dce94321cb07ef0ab35203ea41306128289879f70f90e0280077","constraints":{"executionContext":"node"},"contract":["electron type definitions declare BrowserWindow class with lifecycle methods, window state management, and static window lookup helpers","BrowserWindow constructor validates options and initializes default window geometry and web preferences","BrowserWindow manages window visibility, focus, and state transitions with corresponding event emissions","BrowserWindow tracks window bounds, title, and destruction lifecycle across window instances","BrowserWindow static registry maintains active instances and resolves windows by numeric ID","BrowserWindow webContents handles URL and file navigation states"],"goal":"verify electron.BrowserWindow in pkg:npm/electron@33.4.11","kind":"HOW","packages":["pkg:npm/electron@33.4.11"],"schemaVersion":1,"symbols":["electron.BrowserWindow"]},"contractCommand":["node","test/contract.cjs"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"npm","executionContext":"node","language":"javascript","libc":"glibc","libcVersion":"2.39","moduleSystem":"cjs","os":"linux","osVersionBucket":"24","packageManager":"npm","packageManagerVersion":"10.9.8","runtime":"node","runtimeVersion":"22.23.2","schemaVersion":1},"license":"MIT-0","packages":["pkg:npm/electron@33.4.11"],"schemaVersion":1,"subject":"pkg:npm/electron@33.4.11","symbols":["electron.BrowserWindow"],"verifierAdapter":"node-typescript@1"}
index.js
'use strict';

const fs = require('node:fs');
const path = require('node:path');
const { EventEmitter } = require('node:events');

/**
 * Reads and verifies electron.BrowserWindow TypeScript definitions from the electron package.
 * @returns {{
 *   staticMethods: string[],
 *   instanceMethods: string[],
 *   isMainExported: boolean,
 *   isCommonExported: boolean,
 *   isCrossProcessExported: boolean,
 *   hasBrowserWindow: boolean
 * }}
 */
function getBrowserWindowDeclarations() {
  const electronDir = path.dirname(require.resolve('electron/package.json'));
  const dtsPath = path.join(electronDir, 'electron.d.ts');
  const dtsContent = fs.readFileSync(dtsPath, 'utf-8');

  const staticMethods = [];
  const instanceMethods = [];

  const bwIndex = dtsContent.indexOf('class BrowserWindow extends BaseWindow');
  const optIndex = dtsContent.indexOf('interface BrowserWindowConstructorOptions');

  if (bwIndex !== -1 && optIndex !== -1) {
    const bwSection = dtsContent.slice(bwIndex, optIndex);

    const expectedStaticMethods = [
      'getAllWindows',
      'getFocusedWindow',
      'fromId',
      'fromWebContents',
      'fromBrowserView',
    ];
    for (const sm of expectedStaticMethods) {
      if (bwSection.includes(`static ${sm}(`)) {
        staticMethods.push(sm);
      }
    }

    const expectedInstanceMethods = [
      'loadURL',
      'loadFile',
      'show',
      'hide',
      'close',
      'destroy',
      'isDestroyed',
      'isFocused',
      'isVisible',
      'minimize',
      'maximize',
      'restore',
      'reload',
      'setFullScreen',
      'isFullScreen',
      'setTitle',
      'getTitle',
      'setBounds',
      'getBounds',
    ];
    for (const im of expectedInstanceMethods) {
      if (bwSection.includes(`${im}(`)) {
        instanceMethods.push(im);
      }
    }
  }

  const isMainExported =
    /namespace\s+Main\s*\{[\s\S]*?BrowserWindow:\s*typeof\s+BrowserWindow/m.test(dtsContent) ||
    /namespace\s+Main\s*\{[\s\S]*?class\s+BrowserWindow/m.test(dtsContent);
  const isCommonExported = /namespace\s+Common\s*\{[\s\S]*?BrowserWindow/m.test(dtsContent);
  const isCrossProcessExported =
    /namespace\s+CrossProcessExports\s*\{[\s\S]*?BrowserWindow/m.test(dtsContent);

  return {
    staticMethods,
    instanceMethods,
    isMainExported,
    isCommonExported,
    isCrossProcessExported,
    hasBrowserWindow: staticMethods.length === 5 && instanceMethods.length === 19,
  };
}

/**
 * Validates and normalizes BrowserWindowConstructorOptions.
 * @param {Record<string, any>} [options={}]
 * @returns {Record<string, any>} Normalized options
 */
function validateWindowOptions(options = {}) {
  if (options !== null && typeof options !== 'object') {
    throw new TypeError('Window options must be an object');
  }

  const width = options.width !== undefined ? options.width : 800;
  const height = options.height !== undefined ? options.height : 600;
  const x = options.x !== undefined ? options.x : 0;
  const y = options.y !== undefined ? options.y : 0;
  const show = options.show !== undefined ? Boolean(options.show) : true;
  const frame = options.frame !== undefined ? Boolean(options.frame) : true;
  const title = options.title !== undefined ? String(options.title) : '';

  if (typeof width !== 'number' || Number.isNaN(width) || width <= 0) {
    throw new RangeError('Window width must be a positive number');
  }
  if (typeof height !== 'number' || Number.isNaN(height) || height <= 0) {
    throw new RangeError('Window height must be a positive number');
  }
  if (typeof x !== 'number' || Number.isNaN(x)) {
    throw new TypeError('Window x coordinate must be a number');
  }
  if (typeof y !== 'number' || Number.isNaN(y)) {
    throw new TypeError('Window y coordinate must be a number');
  }

  const webPreferences = Object.assign(
    {
      nodeIntegration: false,
      contextIsolation: true,
      sandbox: true,
      javascript: true,
    },
    options.webPreferences || {}
  );

  return {
    width,
    height,
    x,
    y,
    show,
    frame,
    title,
    webPreferences,
  };
}

/**
 * In-memory MockWebContents emulator.
 */
class MockWebContents extends EventEmitter {
  constructor(id) {
    super();
    this.id = id;
    this._url = '';
    this._title = '';
    this._loading = false;
    this._destroyed = false;
  }

  getURL() {
    return this._url;
  }

  getTitle() {
    return this._title;
  }

  isLoading() {
    return this._loading;
  }

  isDestroyed() {
    return this._destroyed;
  }

  async loadURL(url) {
    if (this._destroyed) {
      throw new Error('WebContents is destroyed');
    }
    if (typeof url !== 'string' || !url) {
      throw new TypeError('URL must be a non-empty string');
    }
    this._loading = true;
    this.emit('did-start-loading');
    this._url = url;
    this._loading = false;
    this.emit('did-finish-load');
  }

  async loadFile(filePath) {
    if (this._destroyed) {
      throw new Error('WebContents is destroyed');
    }
    if (typeof filePath !== 'string' || !filePath) {
      throw new TypeError('File path must be a non-empty string');
    }
    this._loading = true;
    this.emit('did-start-loading');
    this._url = `file://${path.resolve(filePath)}`;
    this._loading = false;
    this.emit('did-finish-load');
  }

  reload() {
    if (this._destroyed) {
      throw new Error('WebContents is destroyed');
    }
    this.emit('did-start-loading');
    this.emit('did-finish-load');
  }

  destroy() {
    if (!this._destroyed) {
      this._destroyed = true;
      this.emit('destroyed');
      this.removeAllListeners();
    }
  }
}

let nextWindowId = 1;
const activeWindows = new Map();
let currentFocusedWindow = null;

/**
 * In-memory BrowserWindow emulator implementing Electron's BrowserWindow contract.
 */
class BrowserWindowMock extends EventEmitter {
  constructor(options = {}) {
    super();
    const validated = validateWindowOptions(options);

    this.id = nextWindowId++;
    this._options = validated;
    this._bounds = {
      x: validated.x,
      y: validated.y,
      width: validated.width,
      height: validated.height,
    };
    this._title = validated.title;
    this._visible = validated.show;
    this._focused = validated.show;
    this._maximized = false;
    this._minimized = false;
    this._fullScreen = false;
    this._destroyed = false;

    this.webContents = new MockWebContents(this.id);

    activeWindows.set(this.id, this);
    if (this._focused) {
      currentFocusedWindow = this;
    }

    process.nextTick(() => {
      if (!this._destroyed) {
        this.emit('ready-to-show');
      }
    });
  }

  static getAllWindows() {
    return Array.from(activeWindows.values()).filter((win) => !win._destroyed);
  }

  static getFocusedWindow() {
    if (currentFocusedWindow && !currentFocusedWindow._destroyed) {
      return currentFocusedWindow;
    }
    return null;
  }

  static fromId(id) {
    const win = activeWindows.get(id);
    return win && !win._destroyed ? win : null;
  }

  static fromWebContents(webContents) {
    if (!webContents) return null;
    for (const win of activeWindows.values()) {
      if (!win._destroyed && win.webContents === webContents) {
        return win;
      }
    }
    return null;
  }

  static fromBrowserView() {
    return null;
  }

  static _resetRegistry() {
    activeWindows.clear();
    currentFocusedWindow = null;
    nextWindowId = 1;
  }

  show() {
    if (this._destroyed) return;
    const wasVisible = this._visible;
    this._visible = true;
    this._minimized = false;
    this.focus();
    if (!wasVisible) {
      this.emit('show');
    }
  }

  hide() {
    if (this._destroyed) return;
    const wasVisible = this._visible;
    this._visible = false;
    if (currentFocusedWindow === this) {
      this.blur();
    }
    if (wasVisible) {
      this.emit('hide');
    }
  }

  isVisible() {
    return !this._destroyed && this._visible;
  }

  focus() {
    if (this._destroyed) return;
    const wasFocused = this._focused;
    if (currentFocusedWindow && currentFocusedWindow !== this) {
      currentFocusedWindow.blur();
    }
    this._focused = true;
    currentFocusedWindow = this;
    if (!wasFocused) {
      this.emit('focus');
    }
  }

  blur() {
    if (this._destroyed) return;
    const wasFocused = this._focused;
    this._focused = false;
    if (currentFocusedWindow === this) {
      currentFocusedWindow = null;
    }
    if (wasFocused) {
      this.emit('blur');
    }
  }

  isFocused() {
    return !this._destroyed && this._focused;
  }

  maximize() {
    if (this._destroyed || this._maximized) return;
    this._maximized = true;
    this._minimized = false;
    this.emit('maximize');
  }

  unmaximize() {
    if (this._destroyed || !this._maximized) return;
    this._maximized = false;
    this.emit('unmaximize');
  }

  isMaximized() {
    return !this._destroyed && this._maximized;
  }

  minimize() {
    if (this._destroyed || this._minimized) return;
    this._minimized = true;
    this.blur();
    this.emit('minimize');
  }

  restore() {
    if (this._destroyed || !this._minimized) return;
    this._minimized = false;
    this.emit('restore');
  }

  isMinimized() {
    return !this._destroyed && this._minimized;
  }

  setFullScreen(flag) {
    if (this._destroyed) return;
    const target = Boolean(flag);
    if (this._fullScreen !== target) {
      this._fullScreen = target;
      if (target) {
        this.emit('enter-full-screen');
      } else {
        this.emit('leave-full-screen');
      }
    }
  }

  isFullScreen() {
    return !this._destroyed && this._fullScreen;
  }

  setTitle(title) {
    if (this._destroyed) return;
    this._title = String(title);
    this.emit('page-title-updated', { preventDefault: () => {} }, this._title);
  }

  getTitle() {
    return this._title;
  }

  setBounds(bounds) {
    if (this._destroyed) return;
    if (bounds !== null && typeof bounds !== 'object') {
      throw new TypeError('Bounds must be an object');
    }
    const newBounds = Object.assign({}, this._bounds);
    let moved = false;
    let resized = false;

    if (typeof bounds.x === 'number') {
      newBounds.x = bounds.x;
      moved = true;
    }
    if (typeof bounds.y === 'number') {
      newBounds.y = bounds.y;
      moved = true;
    }
    if (typeof bounds.width === 'number') {
      if (bounds.width <= 0) throw new RangeError('Width must be positive');
      newBounds.width = bounds.width;
      resized = true;
    }
    if (typeof bounds.height === 'number') {
      if (bounds.height <= 0) throw new RangeError('Height must be positive');
      newBounds.height = bounds.height;
      resized = true;
    }

    this._bounds = newBounds;
    if (moved) this.emit('move');
    if (resized) this.emit('resize');
  }

  getBounds() {
    return Object.assign({}, this._bounds);
  }

  async loadURL(url) {
    return this.webContents.loadURL(url);
  }

  async loadFile(filePath) {
    return this.webContents.loadFile(filePath);
  }

  reload() {
    this.webContents.reload();
  }

  close() {
    if (this._destroyed) return;
    let prevented = false;
    const event = {
      preventDefault: () => {
        prevented = true;
      },
      defaultPrevented: false,
    };
    this.emit('close', event);
    if (!prevented) {
      this.destroy();
    }
  }

  destroy() {
    if (this._destroyed) return;
    this._destroyed = true;
    this._visible = false;
    this._focused = false;
    if (currentFocusedWindow === this) {
      currentFocusedWindow = null;
    }
    activeWindows.delete(this.id);
    this.webContents.destroy();
    this.emit('closed');
    this.removeAllListeners();
  }

  isDestroyed() {
    return this._destroyed;
  }
}

module.exports = {
  getBrowserWindowDeclarations,
  validateWindowOptions,
  BrowserWindowMock,
  MockWebContents,
};
package-lock.json
{
  "name": "sample-electron-browser-window",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-electron-browser-window",
      "version": "1.0.0",
      "dependencies": {
        "electron": "33.4.11"
      }
    },
    "node_modules/@electron/get": {
      "version": "2.0.3",
      "resolved": "https://registry.npmjs.org/@electron/get/-/get-2.0.3.tgz",
      "integrity": "sha512-Qkzpg2s9GnVV2I2BjRksUi43U5e6+zaQMcjoJy0C+C5oxaKl+fmckGDQFtRpZpZV0NQekuZZ+tGz7EA9TVnQtQ==",
      "license": "MIT",
      "dependencies": {
        "debug": "^4.1.1",
        "env-paths": "^2.2.0",
        "fs-extra": "^8.1.0",
        "got": "^11.8.5",
        "progress": "^2.0.3",
        "semver": "^6.2.0",
        "sumchecker": "^3.0.1"
      },
      "engines": {
        "node": ">=12"
      },
      "optionalDependencies": {
        "global-agent": "^3.0.0"
      }
    },
    "node_modules/@sindresorhus/is": {
      "version": "4.6.0",
      "resolved": "https://registry.npmjs.org/@sindresorhus/is/-/is-4.6.0.tgz",
      "integrity": "sha512-t09vSN3MdfsyCHoFcTRCH/iUtG7OJ0CsjzB8cjAmKc/va/kIgeDI/TxsigdncE/4be734m0cvIYwNaV4i2XqAw==",
      "license": "MIT",
      "engines": {
        "node": ">=10"
      },
      "funding": {
        "url": "https://github.com/sindresorhus/is?sponsor=1"
      }
    },
    "node_modules/@szmarczak/http-timer": {
      "version": "4.0.6",
      "resolved": "https://registry.npmjs.org/@szmarczak/http-timer/-/http-timer-4.0.6.tgz",
      "integrity": "sha512-4BAffykYOgO+5nzBWYwE3W90sBgLJoUPRWWcL8wlyiM8IB8ipJz3UMJ9KXQd1RKQXpKp8Tutn80HZtWsu2u76w==",
      "license": "MIT",
      "dependencies": {
        "defer-to-connect": "^2.0.0"
      },
      "engines": {
        "node": ">=10"
      }
    },
    "node_modules/@types/cacheable-request": {
      "version": "6.0.3",
      "resolved": "https://registry.npmjs.org/@types/cacheable-request/-/cacheable-request-6.0.3.tgz",
      "integrity": "sha512-IQ3EbTzGxIigb1I3qPZc1rWJnH0BmSKv5QYTalEwweFvyBDLSAe24zP0le/hyi7ecGfZVlIVAg4BZqb8WBwKqw==",
      "license": "MIT",
      "dependencies": {
        "@types/http-cache-semantics": "*",
        "@types/keyv": "^3.1.4",
        "@types/node": "*",
        "@types/responselike": "^1.0.0"
      }
    },
    "node_modules/@types/http-cache-semantics": {
      "version": "4.2.0",
      "resolved": "https://registry.npmjs.org/@types/http-cache-semantics/-/http-cache-semantics-4.2.0.tgz",
      "integrity": "sha512-L3LgimLHXtGkWikKnsPg0/VFx9OGZaC+eN1u4r+OB1XRqH3meBIAVC2zr1WdMH+RHmnRkqliQAOHNJ/E0j/e0Q==",
      "license": "MIT"
    },
    "node_modules/@types/keyv": {
      "version": "3.1.4",
      "resolved": "https://registry.npmjs.org/@types/keyv/-/keyv-3.1.4.tgz",
      "integrity": "sha512-BQ5aZNSCpj7D6K2ksrRCTmKRLEpnPvWDiLPfoGyhZ++8YtiK9d/3DBKPJgry359X/P1PfruyYwvnvwFjuEiEIg==",
      "license": "MIT",
      "dependencies": {
        "@types/node": "*"
      }
    },
    "node_modules/@types/node": {
      "version": "20.19.43",
      "resolved": "https://registry.npmjs.org/@types/node/-/node-20.19.43.tgz",
      "integrity": "sha512-6oYBAi5ikg4Pl+kGsoYtawUMBT2zZMCvPNF7pVLnHZfd1zf38DRiWn/gT01RYCdUqkv7Fhr+C9ot4/tb+2sVvA==",
      "license": "MIT",
      "dependencies": {
        "undici-types": "~6.21.0"
      }
    },
    "node_modules/@types/responselike": {
      "version": "1.0.3",
      "resolved": "https://registry.npmjs.org/@types/responselike/-/responselike-1.0.3.tgz",
      "integrity": "sha512-H/+L+UkTV33uf49PH5pCAUBVPNj2nDBXTN+qS1dOwyyg24l3CcicicCA7ca+HMvJBZcFgl5r8e+RR6elsb4Lyw==",
      "license": "MIT",
      "dependencies": {
        "@types/node": "*"
      }
    },
    "node_modules/@types/yauzl": {
      "version": "2.10.3",
      "resolved": "https://registry.npmjs.org/@types/yauzl/-/yauzl-2.10.3.tgz",
      "integrity": "sha512-oJoftv0LSuaDZE3Le4DbKX+KS9G36NzOeSap90UIK0yMA/NhKJhqlSGtNDORNRaIbQfzjXDrQa0ytJ6mNRGz/Q==",
      "license": "MIT",
      "optional": true,
      "dependencies": {
        "@types/node": "*"
      }
    },
    "node_modules/boolean": {
      "version": "3.2.0",
      "resolved": "https://registry.npmjs.org/boolean/-/boolean-3.2.0.tgz",
      "integrity": "sha512-d0II/GO9uf9lfUHH2BQsjxzRJZBdsjgsBiW4BvhWk/3qoKwQFjIDVN19PfX8F2D/r9PCMTtLWjYVCFrpeYUzsw==",
      "deprecated": "Package no longer supported. Contact Support at https://www.npmjs.com/support for more info.",
      "license": "MIT",
      "optional": true
    },
    "node_modules/buffer-crc32": {
      "version": "0.2.13",
      "resolved": "https://registry.npmjs.org/buffer-crc32/-/buffer-crc32-0.2.13.tgz",
      "integrity": "sha512-VO9Ht/+p3SN7SKWqcrgEzjGbRSJYTx+Q1pTQC0wrWqHx0vpJraQ6GtHx8tvcg1rlK1byhU5gccxgOgj7B0TDkQ==",
      "license": "MIT",
      "engines": {
        "node": "*"
      }
    },
    "node_modules/cacheable-lookup": {
      "version": "5.0.4",
      "resolved": "https://registry.npmjs.org/cacheable-lookup/-/cacheable-lookup-5.0.4.tgz",
      "integrity": "sha512-2/kNscPhpcxrOigMZzbiWF7dz8ilhb/nIHU3EyZiXWXpeq/au8qJ8VhdftMkty3n7Gj6HIGalQG8oiBNB3AJgA==",
      "license": "MIT",
      "engines": {
        "node": ">=10.6.0"
      }
    },
    "node_modules/cacheable-request": {
      "version": "7.0.4",
      "resolved": "https://registry.npmjs.org/cacheable-request/-/cacheable-request-7.0.4.tgz",
      "integrity": "sha512-v+p6ongsrp0yTGbJXjgxPow2+DL93DASP4kXCDKb8/bwRtt9OEF3whggkkDkGNzgcWy2XaF4a8nZglC7uElscg==",
      "license": "MIT",
      "dependencies": {
        "clone-response": "^1.0.2",
        "get-stream": "^5.1.0",
        "http-cache-semantics": "^4.0.0",
        "keyv": "^4.0.0",
        "lowercase-keys": "^2.0.0",
        "normalize-url": "^6.0.1",
        "responselike": "^2.0.0"
      },
      "engines": {
        "node": ">=8"
      }
    },
    "node_modules/clone-response": {
      "version": "1.0.3",
      "resolved": "https://registry.npmjs.org/clone-response/-/clone-response-1.0.3.tgz",
      "integrity": "sha512-ROoL94jJH2dUVML2Y/5PEDNaSHgeOdSDicUyS7izcF63G6sTc/FTjLub4b8Il9S8S0beOfYt0TaA5qvFK+w0wA==",
      "license": "MIT",
      "dependencies": {
        "mimic-response": "^1.0.0"
      },
      "funding": {
        "url": "https://github.com/sponsors/sindresorhus"
      }
    },
    "node_modules/debug": {
      "version": "4.4.3",
      "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz",
      "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==",
      "license": "MIT",
      "dependencies": {
        "ms": "^2.1.3"
      },
      "engines": {
        "node": ">=6.0"
      },
      "peerDependenciesMeta": {
        "supports-color": {
          "optional": true
        }
      }
    },
    "node_modules/decompress-response": {
      "version": "6.0.0",
      "resolved": "https://registry.npmjs.org/decompress-response/-/decompress-response-6.0.0.tgz",
      "integrity": "sha512-aW35yZM6Bb/4oJlZncMH2LCoZtJXTRxES17vE3hoRiowU2kWHaJKFkSBDnDR+cm9J+9QhXmREyIfv0pji9ejCQ==",
      "license": "MIT",
      "dependencies": {
        "mimic-response": "^3.1.0"
      },
      "engines": {
        "node": ">=10"
      },
      "funding": {
        "url": "https://github.com/sponsors/sindresorhus"
      }
    },
    "node_modules/decompress-response/node_modules/mimic-response": {
      "version": "3.1.0",
      "resolved": "https://registry.npmjs.org/mimic-response/-/mimic-response-3.1.0.tgz",
      "integrity": "sha512-z0yWI+4FDrrweS8Zmt4Ej5HdJmky15+L2e6Wgn3+iK5fWzb6T3fhNFq2+MeTRb064c6Wr4N/wv0DzQTjNzHNGQ==",
      "license": "MIT",
      "engines": {
        "node": ">=10"
      },
      "funding": {
        "url": "https://github.com/sponsors/sindresorhus"
      }
    },
    "node_modules/defer-to-connect": {
      "version": "2.0.1",
      "resolved": "https://registry.npmjs.org/defer-to-connect/-/defer-to-connect-2.0.1.tgz",
      "integrity": "sha512-4tvttepXG1VaYGrRibk5EwJd1t4udunSOVMdLSAL6mId1ix438oPwPZMALY41FCijukO1L0twNcGsdzS7dHgDg==",
      "license": "MIT",
      "engines": {
        "node": ">=10"
      }
    },
    "node_modules/define-data-property": {
      "version": "1.1.4",
      "resolved": "https://registry.npmjs.org/define-data-property/-/define-data-property-1.1.4.tgz",
      "integrity": "sha512-rBMvIzlpA8v6E+SJZoo++HAYqsLrkg7MSfIinMPFhmkorw7X+dOXVJQs+QT69zGkzMyfDnIMN2Wid1+NbL3T+A==",
      "license": "MIT",
      "optional": true,
      "dependencies": {
        "es-define-property": "^1.0.0",
        "es-errors": "^1.3.0",
        "gopd": "^1.0.1"
      },
      "engines": {
        "node": ">= 0.4"
      },
      "funding": {
        "url": "https://github.com/sponsors/ljharb"
      }
    },
    "node_modules/define-properties": {
      "version": "1.2.1",
      "resolved": "https://registry.npmjs.org/define-properties/-/define-properties-1.2.1.tgz",
      "integrity": "sha512-8QmQKqEASLd5nx0U1B1okLElbUuuttJ/AnYmRXbbbGDWh6uS208EjD4Xqq/I9wK7u0v6O08XhTWnt5XtEbR6Dg==",
      "license": "MIT",
      "optional": true,
      "dependencies": {
        "define-data-property": "^1.0.1",
        "has-property-descriptors": "^1.0.0",
        "object-keys": "^1.1.1"
      },
      "engines": {
        "node": ">= 0.4"
      },
      "funding": {
        "url": "https://github.com/sponsors/ljharb"
      }
    },
    "node_modules/detect-node": {
      "version": "2.1.0",
      "resolved": "https://registry.npmjs.org/detect-node/-/detect-node-2.1.0.tgz",
      "integrity": "sha512-T0NIuQpnTvFDATNuHN5roPwSBG83rFsuO+MXXH9/3N1eFbn4wcPjttvjMLEPWJ0RGUYgQE7cGgS3tNxbqCGM7g==",
      "license": "MIT",
      "optional": true
    },
    "node_modules/electron": {
      "version": "33.4.11",
      "resolved": "https://registry.npmjs.org/electron/-/electron-33.4.11.tgz",
      "integrity": "sha512-xmdAs5QWRkInC7TpXGNvzo/7exojubk+72jn1oJL7keNeIlw7xNglf8TGtJtkR4rWC5FJq0oXiIXPS9BcK2Irg==",
      "hasInstallScript": true,
      "license": "MIT",
      "dependencies": {
        "@electron/get": "^2.0.0",
        "@types/node": "^20.9.0",
        "extract-zip": "^2.0.1"
      },
      "bin": {
        "electron": "cli.js"
      },
      "engines": {
        "node": ">= 12.20.55"
      }
    },
    "node_modules/end-of-stream": {
      "version": "1.4.5",
      "resolved": "https://registry.npmjs.org/end-of-stream/-/end-of-stream-1.4.5.tgz",
      "integrity": "sha512-ooEGc6HP26xXq/N+GCGOT0JKCLDGrq2bQUZrQ7gyrJiZANJ/8YDTxTpQBXGMn+WbIQXNVpyWymm7KYVICQnyOg==",
      "license": "MIT",
      "dependencies": {
        "once": "^1.4.0"
      }
    },
    "node_modules/env-paths": {
      "version": "2.2.1",
      "resolved": "https://registry.npmjs.org/env-paths/-/env-paths-2.2.1.tgz",
      "integrity": "sha512-+h1lkLKhZMTYjog1VEpJNG7NZJWcuc2DDk/qsqSTRRCOXiLjeQ1d1/udrUGhqMxUgAlwKNZ0cf2uqan5GLuS2A==",
      "license": "MIT",
      "engines": {
        "node": ">=6"
      }
    },
    "node_modules/es-define-property": {
      "version": "1.0.1",
      "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz",
      "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==",
      "license": "MIT",
      "optional": true,
      "engines": {
        "node": ">= 0.4"
      }
    },
    "node_modules/es-errors": {
      "version": "1.3.0",
      "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz",
      "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==",
      "license": "MIT",
      "optional": true,
      "engines": {
        "node": ">= 0.4"
      }
    },
    "node_modules/es6-error": {
      "version": "4.1.1",
      "resolved": "https://registry.npmjs.org/es6-error/-/es6-error-4.1.1.tgz",
      "integrity": "sha512-Um/+FxMr9CISWh0bi5Zv0iOD+4cFh5qLeks1qhAopKVAJw3drgKbKySikp7wGhDL0HPeaja0P5ULZrxLkniUVg==",
      "license": "MIT",
      "optional": true
    },
    "node_modules/escape-string-regexp": {
      "version": "4.0.0",
      "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-4.0.0.tgz",
      "integrity": "sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==",
      "license": "MIT",
      "optional": true,
      "engines": {
        "node": ">=10"
      },
      "funding": {
        "url": "https://github.com/sponsors/sindresorhus"
      }
    },
    "node_modules/extract-zip": {
      "version": "2.0.1",
      "resolved": "https://registry.npmjs.org/extract-zip/-/extract-zip-2.0.1.tgz",
      "integrity": "sha512-GDhU9ntwuKyGXdZBUgTIe+vXnWj0fppUEtMDL0+idd5Sta8TGpHssn/eusA9mrPr9qNDym6SxAYZjNvCn/9RBg==",
      "license": "BSD-2-Clause",
      "dependencies": {
        "debug": "^4.1.1",
        "get-stream": "^5.1.0",
        "yauzl": "^2.10.0"
      },
      "bin": {
        "extract-zip": "cli.js"
      },
      "engines": {
        "node": ">= 10.17.0"
      },
      "optionalDependencies": {
        "@types/yauzl": "^2.9.1"
      }
    },
    "node_modules/fd-slicer": {
      "version": "1.1.0",
      "resolved": "https://registry.npmjs.org/fd-slicer/-/fd-slicer-1.1.0.tgz",
      "integrity": "sha512-cE1qsB/VwyQozZ+q1dGxR8LBYNZeofhEdUNGSMbQD3Gw2lAzX9Zb3uIU6Ebc/Fmyjo9AWWfnn0AUCHqtevs/8g==",
      "license": "MIT",
      "dependencies": {
        "pend": "~1.2.0"
      }
    },
    "node_modules/fs-extra": {
      "version": "8.1.0",
      "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-8.1.0.tgz",
      "integrity": "sha512-yhlQgA6mnOJUKOsRUFsgJdQCvkKhcz8tlZG5HBQfReYZy46OwLcY+Zia0mtdHsOo9y/hP+CxMN0TU9QxoOtG4g==",
      "license": "MIT",
      "dependencies": {
        "graceful-fs": "^4.2.0",
        "jsonfile": "^4.0.0",
        "universalify": "^0.1.0"
      },
      "engines": {
        "node": ">=6 <7 || >=8"
      }
    },
    "node_modules/get-stream": {
      "version": "5.2.0",
      "resolved": "https://registry.npmjs.org/get-stream/-/get-stream-5.2.0.tgz",
      "integrity": "sha512-nBF+F1rAZVCu/p7rjzgA+Yb4lfYXrpl7a6VmJrU8wF9I1CKvP/QwPNZHnOlwbTkY6dvtFIzFMSyQXbLoTQPRpA==",
      "license": "MIT",
      "dependencies": {
        "pump": "^3.0.0"
      },
      "engines": {
        "node": ">=8"
      },
      "funding": {
        "url": "https://github.com/sponsors/sindresorhus"
      }
    },
    "node_modules/global-agent": {
      "version": "3.0.0",
      "resolved": "https://registry.npmjs.org/global-agent/-/global-agent-3.0.0.tgz",
      "integrity": "sha512-PT6XReJ+D07JvGoxQMkT6qji/jVNfX/h364XHZOWeRzy64sSFr+xJ5OX7LI3b4MPQzdL4H8Y8M0xzPpsVMwA8Q==",
      "license": "BSD-3-Clause",
      "optional": true,
      "dependencies": {
        "boolean": "^3.0.1",
        "es6-error": "^4.1.1",
        "matcher": "^3.0.0",
        "roarr": "^2.15.3",
        "semver": "^7.3.2",
        "serialize-error": "^7.0.1"
      },
      "engines": {
        "node": ">=10.0"
      }
    },
    "node_modules/global-agent/node_modules/semver": {
      "version": "7.8.5",
      "resolved": "https://registry.npmjs.org/semver/-/semver-7.8.5.tgz",
      "integrity": "sha512-Y7/KDsb8LjooZpwaqGyulO6DQlksgCncchHGk+sZIY4SBvUocMBEFH5Ur1fI4dV+Jvl0w6cjvucaIi40puRioA==",
      "license": "ISC",
      "optional": true,
      "bin": {
        "semver": "bin/semver.js"
      },
      "engines": {
        "node": ">=10"
      }
    },
    "node_modules/globalthis": {
      "version": "1.0.4",
      "resolved": "https://registry.npmjs.org/globalthis/-/globalthis-1.0.4.tgz",
      "integrity": "sha512-DpLKbNU4WylpxJykQujfCcwYWiV/Jhm50Goo0wrVILAv5jOr9d+H+UR3PhSCD2rCCEIg0uc+G+muBTwD54JhDQ==",
      "license": "MIT",
      "optional": true,
      "dependencies": {
        "define-properties": "^1.2.1",
        "gopd": "^1.0.1"
      },
      "engines": {
        "node": ">= 0.4"
      },
      "funding": {
        "url": "https://github.com/sponsors/ljharb"
      }
    },
    "node_modules/gopd": {
      "version": "1.2.0",
      "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz",
      "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==",
      "license": "MIT",
      "optional": true,
      "engines": {
        "node": ">= 0.4"
      },
      "funding": {
        "url": "https://github.com/sponsors/ljharb"
      }
    },
    "node_modules/got": {
      "version": "11.8.6",
      "resolved": "https://registry.npmjs.org/got/-/got-11.8.6.tgz",
      "integrity": "sha512-6tfZ91bOr7bOXnK7PRDCGBLa1H4U080YHNaAQ2KsMGlLEzRbk44nsZF2E1IeRc3vtJHPVbKCYgdFbaGO2ljd8g==",
      "license": "MIT",
      "dependencies": {
        "@sindresorhus/is": "^4.0.0",
        "@szmarczak/http-timer": "^4.0.5",
        "@types/cacheable-request": "^6.0.1",
        "@types/responselike": "^1.0.0",
        "cacheable-lookup": "^5.0.3",
        "cacheable-request": "^7.0.2",
        "decompress-response": "^6.0.0",
        "http2-wrapper": "^1.0.0-beta.5.2",
        "lowercase-keys": "^2.0.0",
        "p-cancelable": "^2.0.0",
        "responselike": "^2.0.0"
      },
      "engines": {
        "node": ">=10.19.0"
      },
      "funding": {
        "url": "https://github.com/sindresorhus/got?sponsor=1"
      }
    },
    "node_modules/graceful-fs": {
      "version": "4.2.11",
      "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.11.tgz",
      "integrity": "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==",
      "license": "ISC"
    },
    "node_modules/has-property-descriptors": {
      "version": "1.0.2",
      "resolved": "https://registry.npmjs.org/has-property-descriptors/-/has-property-descriptors-1.0.2.tgz",
      "integrity": "sha512-55JNKuIW+vq4Ke1BjOTjM2YctQIvCT7GFzHwmfZPGo5wnrgkid0YQtnAleFSqumZm4az3n2BS+erby5ipJdgrg==",
      "license": "MIT",
      "optional": true,
      "dependencies": {
        "es-define-property": "^1.0.0"
      },
      "funding": {
        "url": "https://github.com/sponsors/ljharb"
      }
    },
    "node_modules/http-cache-semantics": {
      "version": "4.2.0",
      "resolved": "https://registry.npmjs.org/http-cache-semantics/-/http-cache-semantics-4.2.0.tgz",
      "integrity": "sha512-dTxcvPXqPvXBQpq5dUr6mEMJX4oIEFv6bwom3FDwKRDsuIjjJGANqhBuoAn9c1RQJIdAKav33ED65E2ys+87QQ==",
      "license": "BSD-2-Clause"
    },
    "node_modules/http2-wrapper": {
      "version": "1.0.3",
      "resolved": "https://registry.npmjs.org/http2-wrapper/-/http2-wrapper-1.0.3.tgz",
      "integrity": "sha512-V+23sDMr12Wnz7iTcDeJr3O6AIxlnvT/bmaAAAP/Xda35C90p9599p0F1eHR/N1KILWSoWVAiOMFjBBXaXSMxg==",
      "license": "MIT",
      "dependencies": {
        "quick-lru": "^5.1.1",
        "resolve-alpn": "^1.0.0"
      },
      "engines": {
        "node": ">=10.19.0"
      }
    },
    "node_modules/json-buffer": {
      "version": "3.0.1",
      "resolved": "https://registry.npmjs.org/json-buffer/-/json-buffer-3.0.1.tgz",
      "integrity": "sha512-4bV5BfR2mqfQTJm+V5tPPdf+ZpuhiIvTuAB5g8kcrXOZpTT/QwwVRWBywX1ozr6lEuPdbHxwaJlm9G6mI2sfSQ==",
      "license": "MIT"
    },
    "node_modules/json-stringify-safe": {
      "version": "5.0.1",
      "resolved": "https://registry.npmjs.org/json-stringify-safe/-/json-stringify-safe-5.0.1.tgz",
      "integrity": "sha512-ZClg6AaYvamvYEE82d3Iyd3vSSIjQ+odgjaTzRuO3s7toCdFKczob2i0zCh7JE8kWn17yvAWhUVxvqGwUalsRA==",
      "license": "ISC",
      "optional": true
    },
    "node_modules/jsonfile": {
      "version": "4.0.0",
      "resolved": "https://registry.npmjs.org/jsonfile/-/jsonfile-4.0.0.tgz",
      "integrity": "sha512-m6F1R3z8jjlf2imQHS2Qez5sjKWQzbuuhuJ/FKYFRZvPE3PuHcSMVZzfsLhGVOkfd20obL5SWEBew5ShlquNxg==",
      "license": "MIT",
      "optionalDependencies": {
        "graceful-fs": "^4.1.6"
      }
    },
    "node_modules/keyv": {
      "version": "4.5.4",
      "resolved": "https://registry.npmjs.org/keyv/-/keyv-4.5.4.tgz",
      "integrity": "sha512-oxVHkHR/EJf2CNXnWxRLW6mg7JyCCUcG0DtEGmL2ctUo1PNTin1PUil+r/+4r5MpVgC/fn1kjsx7mjSujKqIpw==",
      "license": "MIT",
      "dependencies": {
        "json-buffer": "3.0.1"
      }
    },
    "node_modules/lowercase-keys": {
      "version": "2.0.0",
      "resolved": "https://registry.npmjs.org/lowercase-keys/-/lowercase-keys-2.0.0.tgz",
      "integrity": "sha512-tqNXrS78oMOE73NMxK4EMLQsQowWf8jKooH9g7xPavRT706R6bkQJ6DY2Te7QukaZsulxa30wQ7bk0pm4XiHmA==",
      "license": "MIT",
      "engines": {
        "node": ">=8"
      }
    },
    "node_modules/matcher": {
      "version": "3.0.0",
      "resolved": "https://registry.npmjs.org/matcher/-/matcher-3.0.0.tgz",
      "integrity": "sha512-OkeDaAZ/bQCxeFAozM55PKcKU0yJMPGifLwV4Qgjitu+5MoAfSQN4lsLJeXZ1b8w0x+/Emda6MZgXS1jvsapng==",
      "license": "MIT",
      "optional": true,
      "dependencies": {
        "escape-string-regexp": "^4.0.0"
      },
      "engines": {
        "node": ">=10"
      }
    },
    "node_modules/mimic-response": {
      "version": "1.0.1",
      "resolved": "https://registry.npmjs.org/mimic-response/-/mimic-response-1.0.1.tgz",
      "integrity": "sha512-j5EctnkH7amfV/q5Hgmoal1g2QHFJRraOtmx0JpIqkxhBhI/lJSl1nMpQ45hVarwNETOoWEimndZ4QK0RHxuxQ==",
      "license": "MIT",
      "engines": {
        "node": ">=4"
      }
    },
    "node_modules/ms": {
      "version": "2.1.3",
      "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
      "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
      "license": "MIT"
    },
    "node_modules/normalize-url": {
      "version": "6.1.0",
      "resolved": "https://registry.npmjs.org/normalize-url/-/normalize-url-6.1.0.tgz",
      "integrity": "sha512-DlL+XwOy3NxAQ8xuC0okPgK46iuVNAK01YN7RueYBqqFeGsBjV9XmCAzAdgt+667bCl5kPh9EqKKDwnaPG1I7A==",
      "license": "MIT",
      "engines": {
        "node": ">=10"
      },
      "funding": {
        "url": "https://github.com/sponsors/sindresorhus"
      }
    },
    "node_modules/object-keys": {
      "version": "1.1.1",
      "resolved": "https://registry.npmjs.org/object-keys/-/object-keys-1.1.1.tgz",
      "integrity": "sha512-NuAESUOUMrlIXOfHKzD6bpPu3tYt3xvjNdRIQ+FeT0lNb4K8WR70CaDxhuNguS2XG+GjkyMwOzsN5ZktImfhLA==",
      "license": "MIT",
      "optional": true,
      "engines": {
        "node": ">= 0.4"
      }
    },
    "node_modules/once": {
      "version": "1.4.0",
      "resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz",
      "integrity": "sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==",
      "license": "ISC",
      "dependencies": {
        "wrappy": "1"
      }
    },
    "node_modules/p-cancelable": {
      "version": "2.1.1",
      "resolved": "https://registry.npmjs.org/p-cancelable/-/p-cancelable-2.1.1.tgz",
      "integrity": "sha512-BZOr3nRQHOntUjTrH8+Lh54smKHoHyur8We1V8DSMVrl5A2malOOwuJRnKRDjSnkoeBh4at6BwEnb5I7Jl31wg==",
      "license": "MIT",
      "engines": {
        "node": ">=8"
      }
    },
    "node_modules/pend": {
      "version": "1.2.0",
      "resolved": "https://registry.npmjs.org/pend/-/pend-1.2.0.tgz",
      "integrity": "sha512-F3asv42UuXchdzt+xXqfW1OGlVBe+mxa2mqI0pg5yAHZPvFmY3Y6drSf/GQ1A86WgWEN9Kzh/WrgKa6iGcHXLg==",
      "license": "MIT"
    },
    "node_modules/progress": {
      "version": "2.0.3",
      "resolved": "https://registry.npmjs.org/progress/-/progress-2.0.3.tgz",
      "integrity": "sha512-7PiHtLll5LdnKIMw100I+8xJXR5gW2QwWYkT6iJva0bXitZKa/XMrSbdmg3r2Xnaidz9Qumd0VPaMrZlF9V9sA==",
      "license": "MIT",
      "engines": {
        "node": ">=0.4.0"
      }
    },
    "node_modules/pump": {
      "version": "3.0.4",
      "resolved": "https://registry.npmjs.org/pump/-/pump-3.0.4.tgz",
      "integrity": "sha512-VS7sjc6KR7e1ukRFhQSY5LM2uBWAUPiOPa/A3mkKmiMwSmRFUITt0xuj+/lesgnCv+dPIEYlkzrcyXgquIHMcA==",
      "license": "MIT",
      "dependencies": {
        "end-of-stream": "^1.1.0",
        "once": "^1.3.1"
      }
    },
    "node_modules/quick-lru": {
      "version": "5.1.1",
      "resolved": "https://registry.npmjs.org/quick-lru/-/quick-lru-5.1.1.tgz",
      "integrity": "sha512-WuyALRjWPDGtt/wzJiadO5AXY+8hZ80hVpe6MyivgraREW751X3SbhRvG3eLKOYN+8VEvqLcf3wdnt44Z4S4SA==",
      "license": "MIT",
      "engines": {
        "node": ">=10"
      },
      "funding": {
        "url": "https://github.com/sponsors/sindresorhus"
      }
    },
    "node_modules/resolve-alpn": {
      "version": "1.2.1",
      "resolved": "https://registry.npmjs.org/resolve-alpn/-/resolve-alpn-1.2.1.tgz",
      "integrity": "sha512-0a1F4l73/ZFZOakJnQ3FvkJ2+gSTQWz/r2KE5OdDY0TxPm5h4GkqkWWfM47T7HsbnOtcJVEF4epCVy6u7Q3K+g==",
      "license": "MIT"
    },
    "node_modules/responselike": {
      "version": "2.0.1",
      "resolved": "https://registry.npmjs.org/responselike/-/responselike-2.0.1.tgz",
      "integrity": "sha512-4gl03wn3hj1HP3yzgdI7d3lCkF95F21Pz4BPGvKHinyQzALR5CapwC8yIi0Rh58DEMQ/SguC03wFj2k0M/mHhw==",
      "license": "MIT",
      "dependencies": {
        "lowercase-keys": "^2.0.0"
      },
      "funding": {
        "url": "https://github.com/sponsors/sindresorhus"
      }
    },
    "node_modules/roarr": {
      "version": "2.15.4",
      "resolved": "https://registry.npmjs.org/roarr/-/roarr-2.15.4.tgz",
      "integrity": "sha512-CHhPh+UNHD2GTXNYhPWLnU8ONHdI+5DI+4EYIAOaiD63rHeYlZvyh8P+in5999TTSFgUYuKUAjzRI4mdh/p+2A==",
      "license": "BSD-3-Clause",
      "optional": true,
      "dependencies": {
        "boolean": "^3.0.1",
        "detect-node": "^2.0.4",
        "globalthis": "^1.0.1",
        "json-stringify-safe": "^5.0.1",
        "semver-compare": "^1.0.0",
        "sprintf-js": "^1.1.2"
      },
      "engines": {
        "node": ">=8.0"
      }
    },
    "node_modules/semver": {
      "version": "6.3.1",
      "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
      "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
      "license": "ISC",
      "bin": {
        "semver": "bin/semver.js"
      }
    },
    "node_modules/semver-compare": {
      "version": "1.0.0",
      "resolved": "https://registry.npmjs.org/semver-compare/-/semver-compare-1.0.0.tgz",
      "integrity": "sha512-YM3/ITh2MJ5MtzaM429anh+x2jiLVjqILF4m4oyQB18W7Ggea7BfqdH/wGMK7dDiMghv/6WG7znWMwUDzJiXow==",
      "license": "MIT",
      "optional": true
    },
    "node_modules/serialize-error": {
      "version": "7.0.1",
      "resolved": "https://registry.npmjs.org/serialize-error/-/serialize-error-7.0.1.tgz",
      "integrity": "sha512-8I8TjW5KMOKsZQTvoxjuSIa7foAwPWGOts+6o7sgjz41/qMD9VQHEDxi6PBvK2l0MXUmqZyNpUK+T2tQaaElvw==",
      "license": "MIT",
      "optional": true,
      "dependencies": {
        "type-fest": "^0.13.1"
      },
      "engines": {
        "node": ">=10"
      },
      "funding": {
        "url": "https://github.com/sponsors/sindresorhus"
      }
    },
    "node_modules/sprintf-js": {
      "version": "1.1.3",
      "resolved": "https://registry.npmjs.org/sprintf-js/-/sprintf-js-1.1.3.tgz",
      "integrity": "sha512-Oo+0REFV59/rz3gfJNKQiBlwfHaSESl1pcGyABQsnnIfWOFt6JNj5gCog2U6MLZ//IGYD+nA8nI+mTShREReaA==",
      "license": "BSD-3-Clause",
      "optional": true
    },
    "node_modules/sumchecker": {
      "version": "3.0.1",
      "resolved": "https://registry.npmjs.org/sumchecker/-/sumchecker-3.0.1.tgz",
      "integrity": "sha512-MvjXzkz/BOfyVDkG0oFOtBxHX2u3gKbMHIF/dXblZsgD3BWOFLmHovIpZY7BykJdAjcqRCBi1WYBNdEC9yI7vg==",
      "license": "Apache-2.0",
      "dependencies": {
        "debug": "^4.1.0"
      },
      "engines": {
        "node": ">= 8.0"
      }
    },
    "node_modules/type-fest": {
      "version": "0.13.1",
      "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-0.13.1.tgz",
      "integrity": "sha512-34R7HTnG0XIJcBSn5XhDd7nNFPRcXYRZrBB2O2jdKqYODldSzBAqzsWoZYYvduky73toYS/ESqxPvkDf/F0XMg==",
      "license": "(MIT OR CC0-1.0)",
      "optional": true,
      "engines": {
        "node": ">=10"
      },
      "funding": {
        "url": "https://github.com/sponsors/sindresorhus"
      }
    },
    "node_modules/undici-types": {
      "version": "6.21.0",
      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.21.0.tgz",
      "integrity": "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==",
      "license": "MIT"
    },
    "node_modules/universalify": {
      "version": "0.1.2",
      "resolved": "https://registry.npmjs.org/universalify/-/universalify-0.1.2.tgz",
      "integrity": "sha512-rBJeI5CXAlmy1pV+617WB9J63U6XcazHHF2f2dbJix4XzpUF0RS3Zbj0FGIOCAva5P/d/GBOYaACQ1w+0azUkg==",
      "license": "MIT",
      "engines": {
        "node": ">= 4.0.0"
      }
    },
    "node_modules/wrappy": {
      "version": "1.0.2",
      "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz",
      "integrity": "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==",
      "license": "ISC"
    },
    "node_modules/yauzl": {
      "version": "2.10.0",
      "resolved": "https://registry.npmjs.org/yauzl/-/yauzl-2.10.0.tgz",
      "integrity": "sha512-p4a9I6X6nu6IhoGmBqAcbJy1mlC4j27vEPZX9F4L4/vZT3Lyq1VkFHw/V/PUcB9Buo+DG3iHkT0x3Qya58zc3g==",
      "license": "MIT",
      "dependencies": {
        "buffer-crc32": "~0.2.3",
        "fd-slicer": "~1.1.0"
      }
    }
  }
}
package.json
{
  "name": "sample-electron-browser-window",
  "version": "1.0.0",
  "private": true,
  "description": "verify electron.BrowserWindow in pkg:npm/electron@33.4.11",
  "main": "index.js",
  "scripts": {
    "test": "node test/contract.cjs"
  },
  "dependencies": {
    "electron": "33.4.11"
  }
}
spec.json
{
  "schemaVersion": 1,
  "goal": "verify electron.BrowserWindow in pkg:npm/electron@33.4.11",
  "kind": "HOW",
  "packages": [
    "pkg:npm/electron@33.4.11"
  ],
  "symbols": [
    "electron.BrowserWindow"
  ],
  "constraints": {
    "executionContext": "node"
  },
  "runtimeConditions": {
    "ecosystem": "npm",
    "language": "javascript",
    "moduleSystem": "cjs",
    "packageManager": "npm@10.9.8",
    "runtime": "node@22.23.2"
  }
}
test/contract.cjs
'use strict';

const assert = require('node:assert');
const path = require('node:path');
const {
  getBrowserWindowDeclarations,
  validateWindowOptions,
  BrowserWindowMock,
} = require('../index.js');

async function runContract() {
  // 1. electron type definitions declare BrowserWindow class with lifecycle methods, window state management, and static window lookup helpers
  {
    const decls = getBrowserWindowDeclarations();
    assert.strictEqual(decls.hasBrowserWindow, true, 'BrowserWindow declarations should be complete');
    assert.strictEqual(decls.isMainExported, true, 'BrowserWindow should be declared in Main namespace');
    assert.strictEqual(decls.isCommonExported, true, 'BrowserWindow should be declared in Common namespace');
    assert.strictEqual(decls.isCrossProcessExported, true, 'BrowserWindow should be declared in CrossProcessExports');
    
    assert.ok(decls.staticMethods.includes('getAllWindows'), 'static getAllWindows declared');
    assert.ok(decls.staticMethods.includes('getFocusedWindow'), 'static getFocusedWindow declared');
    assert.ok(decls.staticMethods.includes('fromId'), 'static fromId declared');
    assert.ok(decls.staticMethods.includes('fromWebContents'), 'static fromWebContents declared');

    assert.ok(decls.instanceMethods.includes('loadURL'), 'instance loadURL declared');
    assert.ok(decls.instanceMethods.includes('loadFile'), 'instance loadFile declared');
    assert.ok(decls.instanceMethods.includes('show'), 'instance show declared');
    assert.ok(decls.instanceMethods.includes('hide'), 'instance hide declared');
    assert.ok(decls.instanceMethods.includes('close'), 'instance close declared');
    assert.ok(decls.instanceMethods.includes('destroy'), 'instance destroy declared');
    assert.ok(decls.instanceMethods.includes('isDestroyed'), 'instance isDestroyed declared');
    assert.ok(decls.instanceMethods.includes('isVisible'), 'instance isVisible declared');
    assert.ok(decls.instanceMethods.includes('isFocused'), 'instance isFocused declared');
    assert.ok(decls.instanceMethods.includes('setBounds'), 'instance setBounds declared');
    assert.ok(decls.instanceMethods.includes('getBounds'), 'instance getBounds declared');
  }

  // 2. BrowserWindow constructor validates options and initializes default window geometry and web preferences
  {
    const defaults = validateWindowOptions();
    assert.strictEqual(defaults.width, 800);
    assert.strictEqual(defaults.height, 600);
    assert.strictEqual(defaults.x, 0);
    assert.strictEqual(defaults.y, 0);
    assert.strictEqual(defaults.show, true);
    assert.strictEqual(defaults.frame, true);
    assert.strictEqual(defaults.webPreferences.contextIsolation, true);
    assert.strictEqual(defaults.webPreferences.nodeIntegration, false);

    const custom = validateWindowOptions({
      width: 1024,
      height: 768,
      x: 100,
      y: 50,
      show: false,
      title: 'Custom Window',
      webPreferences: {
        nodeIntegration: true,
        contextIsolation: false,
      },
    });
    assert.strictEqual(custom.width, 1024);
    assert.strictEqual(custom.height, 768);
    assert.strictEqual(custom.x, 100);
    assert.strictEqual(custom.y, 50);
    assert.strictEqual(custom.show, false);
    assert.strictEqual(custom.title, 'Custom Window');
    assert.strictEqual(custom.webPreferences.nodeIntegration, true);
    assert.strictEqual(custom.webPreferences.contextIsolation, false);

    assert.throws(() => validateWindowOptions({ width: -100 }), RangeError);
    assert.throws(() => validateWindowOptions({ height: 0 }), RangeError);
    assert.throws(() => validateWindowOptions('invalid'), TypeError);
  }

  // 3. BrowserWindow manages window visibility, focus, and state transitions with corresponding event emissions
  {
    BrowserWindowMock._resetRegistry();
    const win = new BrowserWindowMock({ show: false });
    assert.strictEqual(win.isVisible(), false);
    assert.strictEqual(win.isFocused(), false);

    let showEmitted = false;
    let focusEmitted = false;
    let hideEmitted = false;
    let blurEmitted = false;

    win.on('show', () => { showEmitted = true; });
    win.on('focus', () => { focusEmitted = true; });
    win.on('hide', () => { hideEmitted = true; });
    win.on('blur', () => { blurEmitted = true; });

    win.show();
    assert.strictEqual(win.isVisible(), true);
    assert.strictEqual(win.isFocused(), true);
    assert.strictEqual(showEmitted, true);
    assert.strictEqual(focusEmitted, true);

    win.hide();
    assert.strictEqual(win.isVisible(), false);
    assert.strictEqual(win.isFocused(), false);
    assert.strictEqual(hideEmitted, true);
    assert.strictEqual(blurEmitted, true);

    // Maximize / minimize / fullscreen states
    let maxEmitted = false;
    let minEmitted = false;
    win.on('maximize', () => { maxEmitted = true; });
    win.on('minimize', () => { minEmitted = true; });

    win.maximize();
    assert.strictEqual(win.isMaximized(), true);
    assert.strictEqual(maxEmitted, true);

    win.unmaximize();
    assert.strictEqual(win.isMaximized(), false);

    win.minimize();
    assert.strictEqual(win.isMinimized(), true);
    assert.strictEqual(minEmitted, true);

    win.restore();
    assert.strictEqual(win.isMinimized(), false);

    win.setFullScreen(true);
    assert.strictEqual(win.isFullScreen(), true);
    win.setFullScreen(false);
    assert.strictEqual(win.isFullScreen(), false);

    win.destroy();
  }

  // 4. BrowserWindow tracks window bounds, title, and destruction lifecycle across window instances
  {
    BrowserWindowMock._resetRegistry();
    const win = new BrowserWindowMock({ width: 640, height: 480, title: 'Initial Title' });
    assert.strictEqual(win.getTitle(), 'Initial Title');

    let titleUpdated = false;
    win.on('page-title-updated', (event, title) => {
      titleUpdated = true;
      assert.strictEqual(title, 'New App Title');
    });
    win.setTitle('New App Title');
    assert.strictEqual(win.getTitle(), 'New App Title');
    assert.strictEqual(titleUpdated, true);

    const bounds = win.getBounds();
    assert.strictEqual(bounds.width, 640);
    assert.strictEqual(bounds.height, 480);

    let resized = false;
    win.on('resize', () => { resized = true; });
    win.setBounds({ width: 1200, height: 900 });
    assert.strictEqual(resized, true);
    assert.deepStrictEqual(win.getBounds(), { x: 0, y: 0, width: 1200, height: 900 });

    let closed = false;
    win.on('closed', () => { closed = true; });
    assert.strictEqual(win.isDestroyed(), false);
    win.close();
    assert.strictEqual(win.isDestroyed(), true);
    assert.strictEqual(closed, true);
  }

  // 5. BrowserWindow static registry maintains active instances and resolves windows by numeric ID
  {
    BrowserWindowMock._resetRegistry();
    const win1 = new BrowserWindowMock({ title: 'Window 1' });
    const win2 = new BrowserWindowMock({ title: 'Window 2' });

    const all = BrowserWindowMock.getAllWindows();
    assert.strictEqual(all.length, 2);
    assert.strictEqual(BrowserWindowMock.fromId(win1.id), win1);
    assert.strictEqual(BrowserWindowMock.fromId(win2.id), win2);
    assert.strictEqual(BrowserWindowMock.fromId(9999), null);

    assert.strictEqual(BrowserWindowMock.fromWebContents(win1.webContents), win1);
    assert.strictEqual(BrowserWindowMock.fromWebContents(win2.webContents), win2);

    win1.destroy();
    assert.strictEqual(BrowserWindowMock.getAllWindows().length, 1);
    assert.strictEqual(BrowserWindowMock.fromId(win1.id), null);

    win2.destroy();
    assert.strictEqual(BrowserWindowMock.getAllWindows().length, 0);
  }

  // 6. BrowserWindow webContents handles URL and file navigation states
  {
    BrowserWindowMock._resetRegistry();
    const win = new BrowserWindowMock();
    const wc = win.webContents;

    let startLoadingEmitted = false;
    let finishLoadingEmitted = false;

    wc.on('did-start-loading', () => { startLoadingEmitted = true; });
    wc.on('did-finish-load', () => { finishLoadingEmitted = true; });

    await win.loadURL('https://example.com/app');
    assert.strictEqual(wc.getURL(), 'https://example.com/app');
    assert.strictEqual(startLoadingEmitted, true);
    assert.strictEqual(finishLoadingEmitted, true);

    await win.loadFile('index.html');
    assert.ok(wc.getURL().startsWith('file://'));
    assert.ok(wc.getURL().endsWith('index.html'));

    win.destroy();
    assert.strictEqual(wc.isDestroyed(), true);
  }

  console.log('All contract assertions passed successfully.');
}

runContract().catch((err) => {
  console.error('Contract test failed:', err);
  process.exit(1);
});

Origin Seeder

anonymous