electron 38.8.6: WebContentsView

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.WebContentsView in pkg:npm/electron@38.8.6
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/electron@38.8.6
Demonstrate these symbols/APIs:
  - electron.WebContentsView

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.

{"case":{"caseId":"case:sha256:3e93d401101da68264e18b1ec4ec470f09aaf812c580335982f6dc7ece759e44","contract":["electron type definitions declare WebContentsView class extending View and constructor options interface","WebContentsView constructor initializes default view properties or adopts custom webPreferences and existing WebContents","WebContentsView manages view geometry bounds and emits bounds-changed lifecycle events","WebContentsView manages visibility state and visual properties including background color and border radius","WebContentsView view hierarchy supports adding, reordering, and removing child views","WebContentsView webContents property provides navigation, content loading, and lifecycle destruction teardown"],"goal":"verify electron.WebContentsView in pkg:npm/electron@38.8.6","kind":"HOW","packages":["pkg:npm/electron@38.8.6"],"schemaVersion":1,"symbols":["electron.WebContentsView"]},"contractCommand":["node","test/contract.cjs"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"npm","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@38.8.6"],"schemaVersion":1,"subject":"pkg:npm/electron@38.8.6","symbols":["electron.WebContentsView"],"verifierAdapter":"node-typescript@1"}

'use strict';

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

/**
 * Reads and verifies electron.WebContentsView TypeScript definitions from the electron package.
 * @returns {{
 *   hasWebContentsViewClass: boolean,
 *   hasViewClass: boolean,
 *   hasConstructorOptionsInterface: boolean,
 *   viewMethods: string[],
 *   webContentsViewProperties: string[],
 *   isMainExported: boolean,
 *   isCommonExported: boolean,
 *   isCrossProcessExported: boolean,
 *   allDeclared: boolean
 * }}
 */
function getWebContentsViewDeclarations() {
  const electronDir = path.dirname(require.resolve('electron/package.json'));
  const dtsPath = path.join(electronDir, 'electron.d.ts');
  const dtsContent = fs.readFileSync(dtsPath, 'utf-8');

  // Check WebContentsView class declaration
  const hasWebContentsViewClass = dtsContent.includes('class WebContentsView extends View');
  const hasViewClass = dtsContent.includes('class View extends NodeEventEmitter');
  const hasConstructorOptionsInterface = dtsContent.includes('interface WebContentsViewConstructorOptions');

  // Check View methods in electron.d.ts
  const checkViewMethods = [
    'addChildView',
    'removeChildView',
    'getBounds',
    'setBounds',
    'getVisible',
    'setVisible',
    'setBackgroundColor',
    'setBorderRadius',
  ];
  const viewMethods = checkViewMethods.filter((method) => {
    return dtsContent.includes(`${method}(`);
  });

  // Check WebContentsView properties
  const checkProps = ['webContents'];
  const webContentsViewProperties = checkProps.filter((prop) => {
    return dtsContent.includes(`readonly ${prop}: WebContents;`) || dtsContent.includes(`${prop}: WebContents;`);
  });

  // Namespace export checks
  const isMainExported = dtsContent.includes('class WebContentsView extends Electron.WebContentsView');
  const isCommonExported = dtsContent.includes('type WebContentsViewConstructorOptions = Electron.WebContentsViewConstructorOptions');
  const isCrossProcessExported = dtsContent.includes('WebContentsView') && dtsContent.includes('interface CrossProcessExports');

  const allDeclared =
    hasWebContentsViewClass &&
    hasViewClass &&
    hasConstructorOptionsInterface &&
    viewMethods.length === checkViewMethods.length &&
    webContentsViewProperties.length === checkProps.length;

  return {
    hasWebContentsViewClass,
    hasViewClass,
    hasConstructorOptionsInterface,
    viewMethods,
    webContentsViewProperties,
    isMainExported,
    isCommonExported,
    isCrossProcessExported,
    allDeclared,
  };
}

/**
 * Lightweight mock of Electron's View base class.
 */
class ViewMock extends EventEmitter {
  constructor() {
    super();
    this._bounds = { x: 0, y: 0, width: 0, height: 0 };
    this._visible = true;
    this._backgroundColor = null;
    this._borderRadius = 0;
    this._children = [];
    this._parent = null;
    this._destroyed = false;
  }

  /**
   * Adds a child view, optionally at a specific index.
   * If the view is already a child, it is reordered.
   * @param {ViewMock} view
   * @param {number} [index]
   */
  addChildView(view, index) {
    if (!(view instanceof ViewMock)) {
      throw new TypeError('Expected an instance of View');
    }
    if (this._destroyed) {
      throw new Error('View is destroyed');
    }

    const existingIndex = this._children.indexOf(view);
    if (existingIndex !== -1) {
      this._children.splice(existingIndex, 1);
    }

    if (typeof index === 'number') {
      if (index < 0 || index > this._children.length) {
        throw new RangeError('Index out of range');
      }
      this._children.splice(index, 0, view);
    } else {
      this._children.push(view);
    }
    view._parent = this;
  }

  /**
   * Removes a child view. No-op if view is not a child.
   * @param {ViewMock} view
   */
  removeChildView(view) {
    if (!(view instanceof ViewMock)) {
      throw new TypeError('Expected an instance of View');
    }
    const idx = this._children.indexOf(view);
    if (idx !== -1) {
      this._children.splice(idx, 1);
      view._parent = null;
    }
  }

  /**
   * Returns a copy of child views.
   * @returns {ViewMock[]}
   */
  get children() {
    return [...this._children];
  }

  /**
   * Gets the bounds rectangle of this View.
   * @returns {{ x: number, y: number, width: number, height: number }}
   */
  getBounds() {
    return { ...this._bounds };
  }

  /**
   * Sets the bounds rectangle of this View.
   * @param {{ x?: number, y?: number, width?: number, height?: number }} bounds
   */
  setBounds(bounds) {
    if (!bounds || typeof bounds !== 'object') {
      throw new TypeError('Bounds must be an object');
    }
    if (this._destroyed) {
      throw new Error('View is destroyed');
    }

    const newX = typeof bounds.x === 'number' ? bounds.x : this._bounds.x;
    const newY = typeof bounds.y === 'number' ? bounds.y : this._bounds.y;
    const newWidth = typeof bounds.width === 'number' ? bounds.width : this._bounds.width;
    const newHeight = typeof bounds.height === 'number' ? bounds.height : this._bounds.height;

    if (newWidth < 0 || newHeight < 0) {
      throw new RangeError('Width and height must be non-negative');
    }

    const changed =
      newX !== this._bounds.x ||
      newY !== this._bounds.y ||
      newWidth !== this._bounds.width ||
      newHeight !== this._bounds.height;

    this._bounds = { x: newX, y: newY, width: newWidth, height: newHeight };

    if (changed) {
      this.emit('bounds-changed');
    }
  }

  /**
   * Gets visibility of the view.
   * @returns {boolean}
   */
  getVisible() {
    return this._visible;
  }

  /**
   * Sets visibility of the view.
   * @param {boolean} visible
   */
  setVisible(visible) {
    if (this._destroyed) {
      throw new Error('View is destroyed');
    }
    this._visible = Boolean(visible);
  }

  /**
   * Sets background color.
   * @param {string} color
   */
  setBackgroundColor(color) {
    if (typeof color !== 'string') {
      throw new TypeError('Color must be a string');
    }
    const colorRegex = /^#([0-9a-fA-F]{3,4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$|^rgb\(|^rgba\(|^hsl\(|^hsla\(|^[a-zA-Z]+$/;
    if (!colorRegex.test(color.trim())) {
      throw new TypeError('Invalid color format');
    }
    this._backgroundColor = color;
  }

  /**
   * Sets border radius.
   * @param {number} radius
   */
  setBorderRadius(radius) {
    if (typeof radius !== 'number' || Number.isNaN(radius)) {
      throw new TypeError('Radius must be a number');
    }
    if (radius < 0) {
      throw new RangeError('Radius must be non-negative');
    }
    this._borderRadius = radius;
  }
}

let nextWebContentsId = 1;

/**
 * Lightweight mock of Electron's WebContents for WebContentsView.
 */
class WebContentsMock extends EventEmitter {
  constructor(options = {}) {
    super();
    this.id = nextWebContentsId++;
    this._url = '';
    this._title = '';
    this._isLoading = false;
    this._destroyed = false;
    this._webPreferences = options.webPreferences || {
      contextIsolation: true,
      nodeIntegration: false,
    };
    this._ownerView = null;
  }

  async loadURL(url) {
    if (this._destroyed) {
      throw new Error('WebContents is destroyed');
    }
    if (typeof url !== 'string' || (!url.startsWith('http://') && !url.startsWith('https://') && !url.startsWith('file://'))) {
      throw new TypeError('Invalid URL string');
    }
    this._isLoading = true;
    this.emit('did-start-loading');
    this._url = url;
    this._isLoading = false;
    this.emit('did-finish-load');
  }

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

  getURL() {
    return this._url;
  }

  isLoading() {
    return this._isLoading;
  }

  isDestroyed() {
    return this._destroyed;
  }

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

const activeViews = new Set();

/**
 * Mock implementation of Electron's WebContentsView.
 */
class WebContentsViewMock extends ViewMock {
  constructor(options = {}) {
    super();
    if (options !== undefined && (typeof options !== 'object' || options === null)) {
      throw new TypeError('WebContentsViewConstructorOptions must be an object');
    }

    if (options && options.webContents) {
      if (!(options.webContents instanceof WebContentsMock)) {
        throw new TypeError('Expected an instance of WebContents');
      }
      if (options.webContents.isDestroyed()) {
        throw new Error('Cannot adopt a destroyed WebContents');
      }
      if (options.webContents._ownerView !== null) {
        throw new Error('A WebContents may only be presented in one WebContentsView at a time');
      }
      this._webContents = options.webContents;
      this._webContents._ownerView = this;
    } else {
      this._webContents = new WebContentsMock({
        webPreferences: options ? options.webPreferences : undefined,
      });
      this._webContents._ownerView = this;
    }

    activeViews.add(this);
  }

  static _resetRegistry() {
    activeViews.clear();
    nextWebContentsId = 1;
  }

  static get activeViews() {
    return Array.from(activeViews).filter((v) => !v._destroyed);
  }

  /**
   * The WebContents displayed by this view.
   * @returns {WebContentsMock}
   */
  get webContents() {
    return this._webContents;
  }

  /**
   * Destroys this view and its underlying WebContents.
   */
  destroy() {
    if (this._destroyed) return;
    this._destroyed = true;

    if (this._parent) {
      this._parent.removeChildView(this);
    }

    for (const child of [...this._children]) {
      this.removeChildView(child);
    }

    if (this._webContents && !this._webContents.isDestroyed()) {
      this._webContents.destroy();
    }

    activeViews.delete(this);
    this.emit('destroyed');
    this.removeAllListeners();
  }

  isDestroyed() {
    return this._destroyed;
  }
}

module.exports = {
  getWebContentsViewDeclarations,
  ViewMock,
  WebContentsMock,
  WebContentsViewMock,
};

{
  "name": "sample-electron-web-contents-view",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-electron-web-contents-view",
      "version": "1.0.0",
      "dependencies": {
        "electron": "38.8.6"
      }
    },
    "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": "22.20.1",
      "resolved": "https://registry.npmjs.org/@types/node/-/node-22.20.1.tgz",
      "integrity": "sha512-EANqOCF9QFyra+4pfxUcX9STKJpCLjMbObVzljIJomAWSnuSIEAvyzEU53GaajbXJEgdh0iEcPL+DGvpUd4k1Q==",
      "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": "38.8.6",
      "resolved": "https://registry.npmjs.org/electron/-/electron-38.8.6.tgz",
      "integrity": "sha512-lyBhcVi9QYAZL6FO6r5twAWAjWnYomo3iVDvrb5SJZlq928BGemHOKG0tPIq41NOLaCu9f3XdEEjMkjQPjprRg==",
      "hasInstallScript": true,
      "license": "MIT",
      "dependencies": {
        "@electron/get": "^2.0.0",
        "@types/node": "^22.7.7",
        "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"
      }
    }
  }
}

{
  "name": "sample-electron-web-contents-view",
  "version": "1.0.0",
  "private": true,
  "description": "verify electron.WebContentsView in pkg:npm/electron@38.8.6",
  "main": "index.js",
  "scripts": {
    "test": "node test/contract.cjs"
  },
  "dependencies": {
    "electron": "38.8.6"
  }
}

{
  "schemaVersion": 1,
  "goal": "verify electron.WebContentsView in pkg:npm/electron@38.8.6",
  "kind": "HOW",
  "packages": [
    "pkg:npm/electron@38.8.6"
  ],
  "symbols": [
    "electron.WebContentsView"
  ]
}

'use strict';

const assert = require('node:assert');
const path = require('node:path');
const {
  getWebContentsViewDeclarations,
  ViewMock,
  WebContentsMock,
  WebContentsViewMock,
} = require('../index.js');

async function runContract() {
  // 1. electron type definitions declare WebContentsView class extending View and constructor options interface
  {
    const decls = getWebContentsViewDeclarations();
    assert.strictEqual(decls.hasWebContentsViewClass, true, 'WebContentsView class must extend View in d.ts');
    assert.strictEqual(decls.hasViewClass, true, 'View class must extend NodeEventEmitter in d.ts');
    assert.strictEqual(decls.hasConstructorOptionsInterface, true, 'WebContentsViewConstructorOptions interface must exist in d.ts');

    const expectedViewMethods = [
      'addChildView',
      'removeChildView',
      'getBounds',
      'setBounds',
      'getVisible',
      'setVisible',
      'setBackgroundColor',
      'setBorderRadius',
    ];
    for (const vm of expectedViewMethods) {
      assert.ok(decls.viewMethods.includes(vm), `View method ${vm} should be declared in d.ts`);
    }

    assert.ok(decls.webContentsViewProperties.includes('webContents'), 'webContents property declared on WebContentsView');
    assert.strictEqual(decls.isMainExported, true, 'WebContentsView exported in Main namespace');
    assert.strictEqual(decls.isCommonExported, true, 'WebContentsViewConstructorOptions exported in Common types');
    assert.strictEqual(decls.allDeclared, true, 'All type declarations must be verified');
  }

  // 2. WebContentsView constructor initializes default view properties or adopts custom webPreferences and existing WebContents
  {
    WebContentsViewMock._resetRegistry();

    // Default construction
    const viewDefault = new WebContentsViewMock();
    assert.ok(viewDefault.webContents instanceof WebContentsMock);
    assert.strictEqual(viewDefault.getVisible(), true);
    assert.deepStrictEqual(viewDefault.getBounds(), { x: 0, y: 0, width: 0, height: 0 });
    assert.strictEqual(viewDefault.children.length, 0);

    // Custom webPreferences construction
    const viewCustom = new WebContentsViewMock({
      webPreferences: {
        contextIsolation: false,
        nodeIntegration: true,
      },
    });
    assert.strictEqual(viewCustom.webContents._webPreferences.contextIsolation, false);
    assert.strictEqual(viewCustom.webContents._webPreferences.nodeIntegration, true);

    // Adopting existing WebContents
    const existingWc = new WebContentsMock();
    const viewAdopted = new WebContentsViewMock({ webContents: existingWc });
    assert.strictEqual(viewAdopted.webContents, existingWc);

    // Reusing same WebContents in a second view should throw
    assert.throws(() => {
      new WebContentsViewMock({ webContents: existingWc });
    }, /A WebContents may only be presented in one WebContentsView at a time/);

    // Adopting destroyed WebContents should throw
    const destroyedWc = new WebContentsMock();
    destroyedWc.destroy();
    assert.throws(() => {
      new WebContentsViewMock({ webContents: destroyedWc });
    }, /Cannot adopt a destroyed WebContents/);

    // Invalid options type
    assert.throws(() => new WebContentsViewMock('invalid'), TypeError);

    viewDefault.destroy();
    viewCustom.destroy();
    viewAdopted.destroy();
  }

  // 3. WebContentsView manages view geometry bounds and emits bounds-changed lifecycle events
  {
    WebContentsViewMock._resetRegistry();
    const view = new WebContentsViewMock();

    assert.deepStrictEqual(view.getBounds(), { x: 0, y: 0, width: 0, height: 0 });

    let boundsChangedCount = 0;
    view.on('bounds-changed', () => {
      boundsChangedCount++;
    });

    view.setBounds({ x: 50, y: 100, width: 800, height: 600 });
    assert.deepStrictEqual(view.getBounds(), { x: 50, y: 100, width: 800, height: 600 });
    assert.strictEqual(boundsChangedCount, 1);

    // Partial bounds update
    view.setBounds({ width: 1024 });
    assert.deepStrictEqual(view.getBounds(), { x: 50, y: 100, width: 1024, height: 600 });
    assert.strictEqual(boundsChangedCount, 2);

    // Setting same bounds does not re-emit
    view.setBounds({ x: 50, y: 100, width: 1024, height: 600 });
    assert.strictEqual(boundsChangedCount, 2);

    // Negative dimensions error
    assert.throws(() => view.setBounds({ width: -50 }), RangeError);
    assert.throws(() => view.setBounds({ height: -10 }), RangeError);
    assert.throws(() => view.setBounds(null), TypeError);

    view.destroy();
  }

  // 4. WebContentsView manages visibility state and visual properties including background color and border radius
  {
    WebContentsViewMock._resetRegistry();
    const view = new WebContentsViewMock();

    // Visibility
    assert.strictEqual(view.getVisible(), true);
    view.setVisible(false);
    assert.strictEqual(view.getVisible(), false);
    view.setVisible(true);
    assert.strictEqual(view.getVisible(), true);

    // Background Color
    view.setBackgroundColor('#ff0000');
    assert.strictEqual(view._backgroundColor, '#ff0000');

    view.setBackgroundColor('rgba(255, 0, 0, 0.5)');
    assert.strictEqual(view._backgroundColor, 'rgba(255, 0, 0, 0.5)');

    view.setBackgroundColor('blueviolet');
    assert.strictEqual(view._backgroundColor, 'blueviolet');

    assert.throws(() => view.setBackgroundColor(123), TypeError);
    assert.throws(() => view.setBackgroundColor('not a valid color!'), TypeError);

    // Border Radius
    view.setBorderRadius(12);
    assert.strictEqual(view._borderRadius, 12);

    assert.throws(() => view.setBorderRadius(-5), RangeError);
    assert.throws(() => view.setBorderRadius('12px'), TypeError);

    view.destroy();
  }

  // 5. WebContentsView view hierarchy supports adding, reordering, and removing child views
  {
    WebContentsViewMock._resetRegistry();
    const parentView = new WebContentsViewMock();
    const child1 = new WebContentsViewMock();
    const child2 = new WebContentsViewMock();
    const child3 = new WebContentsViewMock();

    parentView.addChildView(child1);
    parentView.addChildView(child2);
    assert.deepStrictEqual(parentView.children, [child1, child2]);
    assert.strictEqual(child1._parent, parentView);
    assert.strictEqual(child2._parent, parentView);

    // Insert child3 at index 1
    parentView.addChildView(child3, 1);
    assert.deepStrictEqual(parentView.children, [child1, child3, child2]);

    // Reordering: adding existing child1 pushes it to topmost (end)
    parentView.addChildView(child1);
    assert.deepStrictEqual(parentView.children, [child3, child2, child1]);

    // Remove child
    parentView.removeChildView(child2);
    assert.deepStrictEqual(parentView.children, [child3, child1]);
    assert.strictEqual(child2._parent, null);

    // Removing non-child is safe no-op
    parentView.removeChildView(child2);
    assert.deepStrictEqual(parentView.children, [child3, child1]);

    assert.throws(() => parentView.addChildView({}), TypeError);
    assert.throws(() => parentView.addChildView(child2, 999), RangeError);

    parentView.destroy();
    child1.destroy();
    child2.destroy();
    child3.destroy();
  }

  // 6. WebContentsView webContents property provides navigation, content loading, and lifecycle destruction teardown
  {
    WebContentsViewMock._resetRegistry();
    const view = new WebContentsViewMock();
    const wc = view.webContents;

    let startLoadingCount = 0;
    let finishLoadingCount = 0;

    wc.on('did-start-loading', () => {
      startLoadingCount++;
    });
    wc.on('did-finish-load', () => {
      finishLoadingCount++;
    });

    await wc.loadURL('https://example.com/home');
    assert.strictEqual(wc.getURL(), 'https://example.com/home');
    assert.strictEqual(startLoadingCount, 1);
    assert.strictEqual(finishLoadingCount, 1);

    const fixturePath = path.join(__dirname, 'fixture.html');
    await wc.loadFile(fixturePath);
    assert.ok(wc.getURL().startsWith('file://'));
    assert.ok(wc.getURL().endsWith('fixture.html'));
    assert.strictEqual(startLoadingCount, 2);
    assert.strictEqual(finishLoadingCount, 2);

    // Destruction teardown
    let viewDestroyedEmitted = false;
    let wcDestroyedEmitted = false;

    view.on('destroyed', () => {
      viewDestroyedEmitted = true;
    });
    wc.on('destroyed', () => {
      wcDestroyedEmitted = true;
    });

    assert.strictEqual(view.isDestroyed(), false);
    assert.strictEqual(wc.isDestroyed(), false);

    view.destroy();

    assert.strictEqual(view.isDestroyed(), true);
    assert.strictEqual(wc.isDestroyed(), true);
    assert.strictEqual(viewDestroyedEmitted, true);
    assert.strictEqual(wcDestroyedEmitted, true);

    // Post-destruction assertions
    assert.throws(() => view.setBounds({ width: 500 }), /View is destroyed/);
    assert.throws(() => view.setVisible(false), /View is destroyed/);
    await assert.rejects(async () => wc.loadURL('https://example.com'), /WebContents is destroyed/);
  }

  console.log('All 6 electron.WebContentsView contracts passed successfully.');
}

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

<!DOCTYPE html>
<html>
<head><title>WebContentsView Fixture</title></head>
<body><h1>WebContentsView Contract Fixture</h1></body>
</html>