CodeSampleX

示例

electron 33.4.11: dialog

已验证示例 — npm electron 33.4.11: dialog. contract 在 node 22 · linux alpine/x64 · docker 上运行并通过: electron type definitions declare Dialog interface with…

sha256:2998987c1d14b13239a9965973126c513f41554a40a75a165aeddbdb512fba4c

本网络只提供一件事:能构建的样本。它在沙箱中运行并保留签名回执。它不评级、不担保——同样的代码能否在你的环境构建,它没有测量过。 提交了通过的契约回执的不同签名密钥数量。为 1 表示只有作者;大于 1 表示还有其他人构建过。密钥是自行生成的,背后没有注册身份,因此计的是密钥而非人。 MIT-0

执行证据

声明的环境与签名的运行分开呈现,你可以看到这个样本究竟运行了什么、在哪里运行。

证据依据
签名契约通过
验证回执
1
构建过它的签名密钥
1
声明的环境 node 22.23 linux 24 · ubuntu · glibc 2.39 x64 node 22.23 javascript npm 10

验证运行环境

环境 契约 阶段 运行日期
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-27

案例

HOW
目标
verify electron.dialog in pkg:npm/electron@33.4.11
包
符号
  • electron.dialog
环境
node 22.23.2
创建时间
2026-08-27T17:01:30Z

契约

  1. electron type definitions declare Dialog interface with showOpenDialog, showOpenDialogSync, showSaveDialog, showSaveDialogSync, showMessageBox, showMessageBoxSync, showErrorBox, and showCertificateTrustDialog methods
  2. dialog showOpenDialog and showOpenDialogSync validate options and return selected file paths or cancellation structure
  3. dialog showSaveDialog and showSaveDialogSync validate options and return chosen file path or cancellation structure
  4. dialog showMessageBox and showMessageBoxSync display message boxes and return selected button index and checkbox state
  5. dialog showErrorBox validates string arguments and records title and content

文件

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

下载源代码构件 (tar.gz)

源代码

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.dialog 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.dialog

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:386e8038db723adf1da329704f4ed2d8c04b4dcb2f42877e3283667a234c83ef","contract":["electron type definitions declare Dialog interface with showOpenDialog, showOpenDialogSync, showSaveDialog, showSaveDialogSync, showMessageBox, showMessageBoxSync, showErrorBox, and showCertificateTrustDialog methods","dialog showOpenDialog and showOpenDialogSync validate options and return selected file paths or cancellation structure","dialog showSaveDialog and showSaveDialogSync validate options and return chosen file path or cancellation structure","dialog showMessageBox and showMessageBoxSync display message boxes and return selected button index and checkbox state","dialog showErrorBox validates string arguments and records title and content"],"goal":"verify electron.dialog in pkg:npm/electron@33.4.11","kind":"HOW","packages":["pkg:npm/electron@33.4.11"],"schemaVersion":1,"symbols":["electron.dialog"]},"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.dialog"],"verifierAdapter":"node-typescript@1"}
index.js
'use strict';

const fs = require('node:fs');
const path = require('node:path');

/**
 * Reads and verifies electron.dialog TypeScript definitions from the electron package.
 * @returns {{
 *   methods: string[],
 *   hasAllMethods: boolean,
 *   isMainExported: boolean,
 *   isCrossProcessExported: boolean,
 *   hasOpenDialogInterfaces: boolean,
 *   hasSaveDialogInterfaces: boolean,
 *   hasMessageBoxInterfaces: boolean,
 *   hasCertificateTrustInterface: boolean
 * }}
 */
function getDialogDeclarations() {
  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 methods = [];
  const interfaceMatch = dtsContent.match(/interface\s+Dialog\s*\{([\s\S]*?)\n\s*\}/);
  if (interfaceMatch) {
    const body = interfaceMatch[1];
    const expectedMethods = [
      'showCertificateTrustDialog',
      'showErrorBox',
      'showMessageBox',
      'showMessageBoxSync',
      'showOpenDialog',
      'showOpenDialogSync',
      'showSaveDialog',
      'showSaveDialogSync',
    ];
    for (const method of expectedMethods) {
      if (body.includes(method)) {
        methods.push(method);
      }
    }
  }

  const isMainExported = /namespace\s+Main\s*\{[\s\S]*?dialog:\s*Dialog/m.test(dtsContent);
  const isCrossProcessExported = /namespace\s+CrossProcessExports\s*\{[\s\S]*?dialog:\s*Dialog/m.test(dtsContent);
  const hasOpenDialogInterfaces = /interface\s+OpenDialogOptions\s*\{/m.test(dtsContent) &&
    /interface\s+OpenDialogReturnValue\s*\{/m.test(dtsContent);
  const hasSaveDialogInterfaces = /interface\s+SaveDialogOptions\s*\{/m.test(dtsContent) &&
    /interface\s+SaveDialogReturnValue\s*\{/m.test(dtsContent);
  const hasMessageBoxInterfaces = /interface\s+MessageBoxOptions\s*\{/m.test(dtsContent) &&
    /interface\s+MessageBoxReturnValue\s*\{/m.test(dtsContent);
  const hasCertificateTrustInterface = /interface\s+CertificateTrustDialogOptions\s*\{/m.test(dtsContent);

  return {
    methods,
    hasAllMethods: methods.length === 8,
    isMainExported,
    isCrossProcessExported,
    hasOpenDialogInterfaces,
    hasSaveDialogInterfaces,
    hasMessageBoxInterfaces,
    hasCertificateTrustInterface,
  };
}

/**
 * Normalizes overloaded method arguments where first argument may be a parent window.
 * @param {any} windowOrOptions
 * @param {any} [maybeOptions]
 * @returns {{ window: any | null, options: any }}
 */
function normalizeDialogArgs(windowOrOptions, maybeOptions) {
  if (maybeOptions !== undefined) {
    return {
      window: windowOrOptions,
      options: maybeOptions || {},
    };
  }
  if (windowOrOptions && typeof windowOrOptions === 'object' && !('webContents' in windowOrOptions) && !('id' in windowOrOptions)) {
    return {
      window: null,
      options: windowOrOptions,
    };
  }
  return {
    window: windowOrOptions || null,
    options: {},
  };
}

/**
 * Validates file filters in dialog options.
 * @param {any[]} [filters]
 */
function validateFileFilters(filters) {
  if (!filters) return;
  if (!Array.isArray(filters)) {
    throw new TypeError('Filters must be an array');
  }
  for (const filter of filters) {
    if (!filter || typeof filter.name !== 'string' || !Array.isArray(filter.extensions)) {
      throw new TypeError('Each filter must have a string name and an array of extensions');
    }
    for (const ext of filter.extensions) {
      if (typeof ext !== 'string' || ext.startsWith('.') || ext.startsWith('*.')) {
        throw new Error(`Filter extension '${ext}' must not contain dots or wildcards`);
      }
    }
  }
}

/**
 * In-memory Dialog emulator adhering to Electron's dialog contract.
 */
class DialogEmulator {
  constructor() {
    this._mockOpenResult = null;
    this._mockSaveResult = null;
    this._mockMessageBoxResult = null;
    this._lastErrorBox = null;
  }

  setMockOpenResult(result) {
    this._mockOpenResult = result;
  }

  setMockSaveResult(result) {
    this._mockSaveResult = result;
  }

  setMockMessageBoxResult(result) {
    this._mockMessageBoxResult = result;
  }

  getLastErrorBox() {
    return this._lastErrorBox;
  }

  /**
   * Displays an open file/directory dialog asynchronously.
   * @param {any} [windowOrOptions]
   * @param {any} [maybeOptions]
   * @returns {Promise<{ canceled: boolean, filePaths: string[], bookmarks?: string[] }>}
   */
  async showOpenDialog(windowOrOptions, maybeOptions) {
    const { options } = normalizeDialogArgs(windowOrOptions, maybeOptions);
    if (options.filters) {
      validateFileFilters(options.filters);
    }

    if (this._mockOpenResult) {
      const res = typeof this._mockOpenResult === 'function' ? this._mockOpenResult(options) : this._mockOpenResult;
      return {
        canceled: Boolean(res.canceled),
        filePaths: res.canceled ? [] : (res.filePaths || []),
        ...(res.bookmarks ? { bookmarks: res.bookmarks } : {}),
      };
    }

    return {
      canceled: false,
      filePaths: options.defaultPath ? [options.defaultPath] : [],
    };
  }

  /**
   * Displays an open file/directory dialog synchronously.
   * @param {any} [windowOrOptions]
   * @param {any} [maybeOptions]
   * @returns {string[] | undefined}
   */
  showOpenDialogSync(windowOrOptions, maybeOptions) {
    const { options } = normalizeDialogArgs(windowOrOptions, maybeOptions);
    if (options.filters) {
      validateFileFilters(options.filters);
    }

    if (this._mockOpenResult) {
      const res = typeof this._mockOpenResult === 'function' ? this._mockOpenResult(options) : this._mockOpenResult;
      if (res.canceled) {
        return undefined;
      }
      return res.filePaths || [];
    }

    return options.defaultPath ? [options.defaultPath] : [];
  }

  /**
   * Displays a save dialog asynchronously.
   * @param {any} [windowOrOptions]
   * @param {any} [maybeOptions]
   * @returns {Promise<{ canceled: boolean, filePath: string, bookmark?: string }>}
   */
  async showSaveDialog(windowOrOptions, maybeOptions) {
    const { options } = normalizeDialogArgs(windowOrOptions, maybeOptions);
    if (options.filters) {
      validateFileFilters(options.filters);
    }

    if (this._mockSaveResult) {
      const res = typeof this._mockSaveResult === 'function' ? this._mockSaveResult(options) : this._mockSaveResult;
      return {
        canceled: Boolean(res.canceled),
        filePath: res.canceled ? '' : (res.filePath || ''),
        ...(res.bookmark ? { bookmark: res.bookmark } : {}),
      };
    }

    return {
      canceled: false,
      filePath: options.defaultPath || '',
    };
  }

  /**
   * Displays a save dialog synchronously.
   * @param {any} [windowOrOptions]
   * @param {any} [maybeOptions]
   * @returns {string}
   */
  showSaveDialogSync(windowOrOptions, maybeOptions) {
    const { options } = normalizeDialogArgs(windowOrOptions, maybeOptions);
    if (options.filters) {
      validateFileFilters(options.filters);
    }

    if (this._mockSaveResult) {
      const res = typeof this._mockSaveResult === 'function' ? this._mockSaveResult(options) : this._mockSaveResult;
      if (res.canceled) {
        return '';
      }
      return res.filePath || '';
    }

    return options.defaultPath || '';
  }

  /**
   * Displays a message box asynchronously.
   * @param {any} [windowOrOptions]
   * @param {any} [maybeOptions]
   * @returns {Promise<{ response: number, checkboxChecked: boolean }>}
   */
  async showMessageBox(windowOrOptions, maybeOptions) {
    const { options } = normalizeDialogArgs(windowOrOptions, maybeOptions);
    if (typeof options.message !== 'string') {
      throw new TypeError('Message must be a string');
    }
    const validTypes = ['none', 'info', 'error', 'question', 'warning'];
    if (options.type && !validTypes.includes(options.type)) {
      throw new TypeError(`Invalid dialog type: ${options.type}`);
    }

    if (this._mockMessageBoxResult) {
      const res = typeof this._mockMessageBoxResult === 'function' ? this._mockMessageBoxResult(options) : this._mockMessageBoxResult;
      return {
        response: typeof res.response === 'number' ? res.response : (options.defaultId || 0),
        checkboxChecked: Boolean(res.checkboxChecked),
      };
    }

    return {
      response: options.defaultId || 0,
      checkboxChecked: Boolean(options.checkboxChecked),
    };
  }

  /**
   * Displays a message box synchronously.
   * @param {any} [windowOrOptions]
   * @param {any} [maybeOptions]
   * @returns {number}
   */
  showMessageBoxSync(windowOrOptions, maybeOptions) {
    const { options } = normalizeDialogArgs(windowOrOptions, maybeOptions);
    if (typeof options.message !== 'string') {
      throw new TypeError('Message must be a string');
    }
    const validTypes = ['none', 'info', 'error', 'question', 'warning'];
    if (options.type && !validTypes.includes(options.type)) {
      throw new TypeError(`Invalid dialog type: ${options.type}`);
    }

    if (this._mockMessageBoxResult) {
      const res = typeof this._mockMessageBoxResult === 'function' ? this._mockMessageBoxResult(options) : this._mockMessageBoxResult;
      return typeof res.response === 'number' ? res.response : (options.defaultId || 0);
    }

    return options.defaultId || 0;
  }

  /**
   * Displays a modal dialog that shows an error message.
   * @param {string} title
   * @param {string} content
   */
  showErrorBox(title, content) {
    if (typeof title !== 'string') {
      throw new TypeError('Error box title must be a string');
    }
    if (typeof content !== 'string') {
      throw new TypeError('Error box content must be a string');
    }
    this._lastErrorBox = {
      title,
      content,
      timestamp: Date.now(),
    };
  }

  /**
   * Displays certificate trust dialog.
   * @param {any} [windowOrOptions]
   * @param {any} [maybeOptions]
   * @returns {Promise<void>}
   */
  async showCertificateTrustDialog(windowOrOptions, maybeOptions) {
    const { options } = normalizeDialogArgs(windowOrOptions, maybeOptions);
    if (!options.certificate) {
      throw new TypeError('Certificate must be provided');
    }
    if (typeof options.message !== 'string') {
      throw new TypeError('Message must be a string');
    }
  }
}

/**
 * Creates a new Dialog emulator instance.
 * @returns {DialogEmulator}
 */
function createDialog() {
  return new DialogEmulator();
}

module.exports = {
  getDialogDeclarations,
  DialogEmulator,
  createDialog,
  normalizeDialogArgs,
  validateFileFilters,
};
package-lock.json
{
  "name": "sample-electron-dialog",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-electron-dialog",
      "version": "1.0.0",
      "license": "MIT-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-dialog",
  "version": "1.0.0",
  "description": "verify electron.dialog in pkg:npm/electron@33.4.11",
  "main": "index.js",
  "type": "commonjs",
  "license": "MIT-0",
  "dependencies": {
    "electron": "33.4.11"
  }
}
spec.json
{
  "schemaVersion": 1,
  "goal": "verify electron.dialog in pkg:npm/electron@33.4.11",
  "kind": "HOW",
  "packages": [
    "pkg:npm/electron@33.4.11"
  ],
  "symbols": [
    "electron.dialog"
  ]
}
test/contract.cjs
'use strict';

const assert = require('node:assert');
const {
  getDialogDeclarations,
  DialogEmulator,
  createDialog,
  normalizeDialogArgs,
  validateFileFilters,
} = require('../index.js');

async function runTests() {
  // Contract 1: electron type definitions declare Dialog interface with showOpenDialog, showOpenDialogSync, showSaveDialog, showSaveDialogSync, showMessageBox, showMessageBoxSync, showErrorBox, and showCertificateTrustDialog methods
  {
    const decl = getDialogDeclarations();
    assert.strictEqual(decl.hasAllMethods, true, 'Dialog interface must declare all 8 expected methods');
    assert.ok(decl.methods.includes('showOpenDialog'), 'Must include showOpenDialog');
    assert.ok(decl.methods.includes('showOpenDialogSync'), 'Must include showOpenDialogSync');
    assert.ok(decl.methods.includes('showSaveDialog'), 'Must include showSaveDialog');
    assert.ok(decl.methods.includes('showSaveDialogSync'), 'Must include showSaveDialogSync');
    assert.ok(decl.methods.includes('showMessageBox'), 'Must include showMessageBox');
    assert.ok(decl.methods.includes('showMessageBoxSync'), 'Must include showMessageBoxSync');
    assert.ok(decl.methods.includes('showErrorBox'), 'Must include showErrorBox');
    assert.ok(decl.methods.includes('showCertificateTrustDialog'), 'Must include showCertificateTrustDialog');
    assert.strictEqual(decl.isMainExported, true, 'dialog must be exported in Main namespace');
    assert.strictEqual(decl.isCrossProcessExported, true, 'dialog must be exported in CrossProcessExports namespace');
    assert.strictEqual(decl.hasOpenDialogInterfaces, true, 'OpenDialog interfaces must be declared');
    assert.strictEqual(decl.hasSaveDialogInterfaces, true, 'SaveDialog interfaces must be declared');
    assert.strictEqual(decl.hasMessageBoxInterfaces, true, 'MessageBox interfaces must be declared');
    assert.strictEqual(decl.hasCertificateTrustInterface, true, 'CertificateTrust interface must be declared');
  }

  // Contract 2: dialog showOpenDialog and showOpenDialogSync validate options and return selected file paths or cancellation structure
  {
    const dlg = createDialog();

    // Async selection
    dlg.setMockOpenResult({ canceled: false, filePaths: ['/workspace/project/README.md'] });
    const openRes = await dlg.showOpenDialog({
      title: 'Select Readme',
      properties: ['openFile'],
      filters: [{ name: 'Markdown', extensions: ['md', 'markdown'] }],
    });
    assert.strictEqual(openRes.canceled, false);
    assert.deepStrictEqual(openRes.filePaths, ['/workspace/project/README.md']);

    // Async cancellation
    dlg.setMockOpenResult({ canceled: true });
    const cancelRes = await dlg.showOpenDialog({ properties: ['openFile'] });
    assert.strictEqual(cancelRes.canceled, true);
    assert.deepStrictEqual(cancelRes.filePaths, []);

    // Sync selection & cancellation
    dlg.setMockOpenResult({ canceled: false, filePaths: ['/workspace/project/doc.pdf'] });
    const syncPaths = dlg.showOpenDialogSync({ properties: ['openFile'] });
    assert.deepStrictEqual(syncPaths, ['/workspace/project/doc.pdf']);

    dlg.setMockOpenResult({ canceled: true });
    const syncCancel = dlg.showOpenDialogSync({ properties: ['openFile'] });
    assert.strictEqual(syncCancel, undefined);

    // Filter validation error on wildcard or dot in extensions
    assert.throws(
      () => {
        dlg.showOpenDialogSync({
          filters: [{ name: 'Images', extensions: ['*.png', '.jpg'] }],
        });
      },
      /must not contain dots or wildcards/,
      'Must reject extensions containing wildcards or dots'
    );
  }

  // Contract 3: dialog showSaveDialog and showSaveDialogSync validate options and return chosen file path or cancellation structure
  {
    const dlg = createDialog();

    // Async save success
    dlg.setMockSaveResult({ canceled: false, filePath: '/workspace/project/export.json' });
    const saveRes = await dlg.showSaveDialog({
      title: 'Export Data',
      defaultPath: 'export.json',
      filters: [{ name: 'JSON', extensions: ['json'] }],
    });
    assert.strictEqual(saveRes.canceled, false);
    assert.strictEqual(saveRes.filePath, '/workspace/project/export.json');

    // Async save cancellation
    dlg.setMockSaveResult({ canceled: true });
    const saveCancel = await dlg.showSaveDialog({ defaultPath: 'export.json' });
    assert.strictEqual(saveCancel.canceled, true);
    assert.strictEqual(saveCancel.filePath, '');

    // Sync save success & cancellation
    dlg.setMockSaveResult({ canceled: false, filePath: '/workspace/project/backup.zip' });
    const syncSavePath = dlg.showSaveDialogSync({ defaultPath: 'backup.zip' });
    assert.strictEqual(syncSavePath, '/workspace/project/backup.zip');

    dlg.setMockSaveResult({ canceled: true });
    const syncSaveCancel = dlg.showSaveDialogSync({});
    assert.strictEqual(syncSaveCancel, '');
  }

  // Contract 4: dialog showMessageBox and showMessageBoxSync display message boxes and return selected button index and checkbox state
  {
    const dlg = createDialog();

    // Async message box with custom button response and checkbox
    dlg.setMockMessageBoxResult({ response: 1, checkboxChecked: true });
    const msgRes = await dlg.showMessageBox({
      type: 'question',
      buttons: ['Cancel', 'OK'],
      defaultId: 1,
      title: 'Confirmation',
      message: 'Do you want to save changes?',
      checkboxLabel: 'Remember my decision',
    });
    assert.strictEqual(msgRes.response, 1);
    assert.strictEqual(msgRes.checkboxChecked, true);

    // Sync message box
    dlg.setMockMessageBoxResult({ response: 0 });
    const syncMsgRes = dlg.showMessageBoxSync({
      type: 'info',
      buttons: ['OK'],
      message: 'Operation completed successfully.',
    });
    assert.strictEqual(syncMsgRes, 0);

    // Invalid message type throws
    await assert.rejects(
      async () => {
        await dlg.showMessageBox({
          type: 'invalid-dialog-type',
          message: 'Test message',
        });
      },
      /Invalid dialog type/,
      'Invalid dialog type must throw TypeError'
    );
  }

  // Contract 5: dialog showErrorBox validates string arguments and records title and content
  {
    const dlg = createDialog();

    dlg.showErrorBox('Fatal Error', 'An unexpected initialization error occurred.');
    const errorBox = dlg.getLastErrorBox();
    assert.ok(errorBox, 'Error box payload must be recorded');
    assert.strictEqual(errorBox.title, 'Fatal Error');
    assert.strictEqual(errorBox.content, 'An unexpected initialization error occurred.');

    // Non-string arguments throw TypeError
    assert.throws(
      () => {
        dlg.showErrorBox(123, 'Content string');
      },
      /Error box title must be a string/,
      'Non-string title must throw TypeError'
    );
    assert.throws(
      () => {
        dlg.showErrorBox('Title string', null);
      },
      /Error box content must be a string/,
      'Non-string content must throw TypeError'
    );
  }

  console.log('All 5 contracts passed successfully.');
}

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

原始种子者

匿名