cross-packer 0.1.0

package/README.md

@@ -0,0 +1,151 @@
+# cross-packer
+
+[**English**](README.md) | [**简体中文**](README.zh-CN.md)
+
+Cross-platform Electron app packager: assemble **Windows (NSIS)**, **macOS (.app/.zip)**, and **Linux (.deb)** artifacts on any host operating system, with no dependency on `electron-builder`, `app-builder-bin`, or platform-specific toolchains.
+
+## How It Works
+
+`cross-packer` is a Node.js command-line tool and library that turns a built Electron app payload into distributable artifacts:
+
+```
+cross-packer.config.mjs
+   │  load & normalize config
+   ▼
+Project file collection
+   │  app dist + package.json + pruned production node_modules,
+   │  smart-unpack detection, prebuilt native module substitution
+   ▼
+Asar archive
+   │  packed per-target with integrity hashes and optional unpacked dir
+   ▼
+Platform packers (run concurrently)
+   ├─ Windows: NSIS installer / portable exe (auto-acquired NSIS toolchain, rcedit-style icon & metadata)
+   ├─ macOS:   renamed .app bundle in a zip, generated Info.plist, asar integrity, electron-updater metadata
+   └─ Linux:   .deb package from templates (control, desktop entry, maintainer scripts)
+   ▼
+Update artifacts (optional)
+      latest.yml + *.blockmap, electron-updater compatible
+```
+
+Key design points:
+
+- **Host-OS independent**: Windows, macOS, and Linux artifacts can all be built from any host operating system; the Electron distribution for each target is downloaded on demand, and the download mirror is configurable.
+- **No electron-builder**: the NSIS toolchain is acquired automatically, .deb assembly is template-driven, and Info.plist generation uses structured `plist` data instead of string templating.
+- **Pluggable signing**: signing is opt-in via hooks (`sign.win` / `sign.mac`); the packer itself never signs artifacts. Reference implementations for [osslsigncode](https://github.com/mtrojnar/osslsigncode) and a customized `rcodesign` fork are provided in `examples/signing-hooks.ts`.
+- **Cross-platform macOS tooling**: macOS artifacts can be signed and packaged on any host operating system; cross-platform signing uses the customized [rcodesign](https://github.com/Sg4Dylan/zip2dmg) fork, and `.dmg` images are generated with [zip2dmg](https://github.com/Sg4Dylan/zip2dmg).
+- **Prebuilt native modules**: projects shipping prebuilt native modules (such as `better-sqlite3` and `@napi-rs/canvas-*`) can declare substitution rules per platform and architecture without rebuilding from source.
+
+## Basic Usage
+
+Create a config file at your project root (see `examples/basic.config.ts`):
+
+```js
+// cross-packer.config.mjs
+export default {
+  name: 'my-app',
+  productName: 'My App',
+  appId: 'com.example.my-app',
+  version: '1.0.0',
+  author: 'Example Team',
+  electronVersion: '33.2.0',
+
+  files: {
+    appDistDir: 'dist', // built app payload, collected together with package.json
+  },
+  asarUnpack: ['**/*.node'],
+
+  mac: {
+    bundleName: 'MyApp',
+    iconFile: 'build/icon.icns',
+    // Extra Info.plist entries merged on top of the generated keys
+    // plist: { NSCameraUsageDescription: 'Camera access is required' },
+    // urlSchemes: ['my-app'],
+  },
+  win: { iconFile: 'build/icon.ico' },
+  linux: { maintainer: 'Example Team <dev@example.com>' },
+
+  update: { channel: 'latest', generateMetadata: true },
+}
+```
+
+Build artifacts:
+
+```bash
+# Windows NSIS installer (amd64)
+npx cross-packer --win
+
+# macOS .app zip (arm64)
+npx cross-packer --mac --arm64
+
+# All platforms, both architectures
+npx cross-packer --all-platforms --all-arch
+
+# Validate config and targets without building
+npx cross-packer --linux --dry-run
+```
+
+Main options:
+
+| Option | Description |
+| :--- | :--- |
+| `--win` / `--mac` / `--linux` | Target platform(s) |
+| `--all-platforms` | Equivalent to `--win --mac --linux` |
+| `--amd64` / `--arm64` / `--all-arch` | Target architecture(s) |
+| `--arch <list>` | Comma-separated architecture list, for example `--arch amd64,arm64` |
+| `--config <path>` | Config file path (`.mjs` or `.json`), default `cross-packer.config.mjs` |
+| `--output <path>` | Output directory (default: `dist-<timestamp>`) |
+| `--channel <name>` | Update channel override (for example, `latest` or `beta`) |
+| `--sign` | Enable code signing hooks (see `config.sign`) |
+| `--dry-run` | Validate config and targets without building |
+
+The packer is also usable as a library: `runPack`, `loadConfig`, `generateUpdateMetadata`, and `buildBlockMap` are exported from the package root (see `src/index.ts`).
+
+Programmatic API usage:
+
+```ts
+import { loadConfig, runPack } from 'cross-packer'
+
+const config = await loadConfig('cross-packer.config.mjs')
+const result = await runPack(config, {
+  platforms: ['win', 'mac', 'linux'],
+  arches: ['amd64'],
+  output: 'dist-release',
+})
+```
+
+## Dependencies
+
+Runtime dependencies (bundled with the command-line tool):
+
+| Component | License | Usage |
+| :--- | :--- | :--- |
+| [archiver](https://github.com/archiverjs/node-archiver) | MIT | Streaming ZIP assembly (macOS .app zip) |
+| [jszip](https://github.com/Stuk/jszip) | MIT / Apache-2.0 | Reading Electron distribution zips |
+| [tar](https://github.com/isaacs/node-tar) | ISC | Electron dist archive handling |
+| [7zip-bin](https://github.com/develar/7zip-bin) | MIT | Embedded 7za binary for archive extraction |
+| [plist](https://github.com/TooTallNate/plist.js) | MIT | Structured Info.plist generation and rewriting |
+| [resedit](https://github.com/lemon-s/resedit) | MIT | Windows PE resource editing (icon, version info) |
+| [js-yaml](https://github.com/nodeca/js-yaml) | MIT | NSIS messages and app-update.yml rendering |
+| [minimatch](https://github.com/isaacs/minimatch) | ISC | Glob matching for file sets and filters |
+| [@noble/hashes](https://github.com/paulmillr/noble-hashes) | MIT | SHA-256 checksums for asar integrity and blockmaps |
+| [fs-extra](https://github.com/jprichardson/node-fs-extra) | MIT | File system helpers |
+| [chromium-pickle-js](https://github.com/electron/node-chromium-pickle-js) | MIT | Asar header (pickle) serialization |
+
+The Windows packer acquires the NSIS toolchain automatically (downloaded on first use and cached locally), so no manual NSIS installation is required on the build host. macOS artifacts are produced unsigned by design; signing is opt-in via the `sign.mac` hook, using either the customized [rcodesign](https://github.com/Sg4Dylan/zip2dmg) fork on any host operating system or `codesign` on macOS (reference implementations are provided in `examples/signing-hooks.ts`). To produce a `.dmg` image from the generated `.app` zip on any host operating system, use [zip2dmg](https://github.com/Sg4Dylan/zip2dmg).
+
+## License
+
+### Project License
+This project is licensed under the **AGPLv3 License**; see the [LICENSE](LICENSE) file for details.
+
+### AI Disclosure & Disclaimer
+Parts of this project are generated or optimized by AI coding tools. While the maintainers strive for quality, the AI-generated code is provided **"AS IS" without warranty of any kind**, express or implied. The authors do not guarantee the absolute accuracy, security, or reliability of the AI-contributed logic. Users are encouraged to review the source code independently. In no event shall the authors be liable for any claim, damages, or other liability arising from the use of AI-generated content.
+
+### Third-Party Software Notices
+This project integrates or makes use of the following open-source components, with gratitude to the original authors; see the table above under **Dependencies** for the full list with licenses.
+
+---
+
+Copyright (c) 2026-Present project contributors.  
+Licensed under the AGPLv3 License.

package/README.zh-CN.md

@@ -0,0 +1,151 @@
+# cross-packer
+
+[**English**](README.md) | [**简体中文**](README.zh-CN.md)
+
+跨平台 Electron 应用打包器：在任意宿主操作系统上产出 **Windows（NSIS）**、**macOS（.app/.zip）** 与 **Linux（.deb）** 产物，不依赖 `electron-builder`、`app-builder-bin` 或任何平台专属工具链。
+
+## 工作原理
+
+`cross-packer` 是一个 Node.js 命令行工具与程序库，可将构建完成的 Electron 应用载荷转换为可分发产物：
+
+```
+cross-packer.config.mjs
+   │  加载并归一化配置
+   ▼
+项目文件收集
+   │  应用构建产物、package.json 与裁剪后的生产依赖 node_modules，
+   │  智能 unpack 检测、预构建原生模块替换
+   ▼
+Asar 归档
+   │  按目标平台打包，附带完整性哈希与可选的 unpacked 目录
+   ▼
+平台打包器（并发执行）
+   ├─ Windows: NSIS 安装包 / 便携版 exe（自动获取 NSIS 工具链，rcedit 风格的图标与元数据）
+   ├─ macOS:   重命名后的 .app bundle（zip 格式）、生成的 Info.plist、asar 完整性、electron-updater 元数据
+   └─ Linux:   基于模板（control、desktop 入口、维护者脚本）组装的 .deb 包
+   ▼
+更新产物（可选）
+      latest.yml + *.blockmap，兼容 electron-updater
+```
+
+关键设计点：
+
+- **宿主操作系统无关**：Windows、macOS、Linux 产物均可在任意宿主操作系统上构建；各目标的 Electron 发行版按需下载，下载镜像可配置。
+- **不依赖 electron-builder**：NSIS 工具链自动获取，.deb 组装由模板驱动，Info.plist 生成基于结构化 `plist` 数据而非字符串模板。
+- **可插拔签名**：签名通过钩子（`sign.win` / `sign.mac`）选配启用，打包器自身不执行签名。`examples/signing-hooks.ts` 提供了 [osslsigncode](https://github.com/mtrojnar/osslsigncode) 与定制版 `rcodesign` 分支的参考实现。
+- **跨平台 macOS 工具链**：macOS 产物可在任意宿主操作系统上完成签名与镜像封装：跨平台签名使用定制版 [rcodesign](https://github.com/Sg4Dylan/zip2dmg)，`.dmg` 镜像由 [zip2dmg](https://github.com/Sg4Dylan/zip2dmg) 生成。
+- **预构建原生模块**：交付预构建原生模块（如 `better-sqlite3`、`@napi-rs/canvas-*`）的项目可按平台与架构声明替换规则，无需从源码重新编译。
+
+## 基本用法
+
+在项目根目录创建配置文件（参见 `examples/basic.config.ts`）：
+
+```js
+// cross-packer.config.mjs
+export default {
+  name: 'my-app',
+  productName: 'My App',
+  appId: 'com.example.my-app',
+  version: '1.0.0',
+  author: 'Example Team',
+  electronVersion: '33.2.0',
+
+  files: {
+    appDistDir: 'dist', // 应用构建产物目录，与 package.json 共同收集
+  },
+  asarUnpack: ['**/*.node'],
+
+  mac: {
+    bundleName: 'MyApp',
+    iconFile: 'build/icon.icns',
+    // 额外的 Info.plist 条目，合并到生成的键之上
+    // plist: { NSCameraUsageDescription: '需要访问摄像头' },
+    // urlSchemes: ['my-app'],
+  },
+  win: { iconFile: 'build/icon.ico' },
+  linux: { maintainer: 'Example Team <dev@example.com>' },
+
+  update: { channel: 'latest', generateMetadata: true },
+}
+```
+
+构建产物：
+
+```bash
+# Windows NSIS 安装包（amd64）
+npx cross-packer --win
+
+# macOS .app zip（arm64）
+npx cross-packer --mac --arm64
+
+# 全平台、双架构
+npx cross-packer --all-platforms --all-arch
+
+# 仅校验配置与目标，不执行构建
+npx cross-packer --linux --dry-run
+```
+
+主要选项：
+
+| 选项 | 说明 |
+| :--- | :--- |
+| `--win` / `--mac` / `--linux` | 目标平台 |
+| `--all-platforms` | 等价于 `--win --mac --linux` |
+| `--amd64` / `--arm64` / `--all-arch` | 目标架构 |
+| `--arch <list>` | 逗号分隔的架构列表，如 `--arch amd64,arm64` |
+| `--config <path>` | 配置文件路径（`.mjs` 或 `.json`），默认 `cross-packer.config.mjs` |
+| `--output <path>` | 输出目录（默认：`dist-<timestamp>`） |
+| `--channel <name>` | 更新通道覆盖（如 `latest`、`beta`） |
+| `--sign` | 启用代码签名钩子（见 `config.sign`） |
+| `--dry-run` | 仅校验配置与目标，不执行构建 |
+
+本打包器亦可作为程序库使用：`runPack`、`loadConfig`、`generateUpdateMetadata`、`buildBlockMap` 均自包根导出（见 `src/index.ts`）。
+
+编程式 API 用法：
+
+```ts
+import { loadConfig, runPack } from 'cross-packer'
+
+const config = await loadConfig('cross-packer.config.mjs')
+const result = await runPack(config, {
+  platforms: ['win', 'mac', 'linux'],
+  arches: ['amd64'],
+  output: 'dist-release',
+})
+```
+
+## 依赖说明
+
+运行时依赖（随命令行工具一并提供）：
+
+| 组件 | 许可证 | 用途 |
+| :--- | :--- | :--- |
+| [archiver](https://github.com/archiverjs/node-archiver) | MIT | 流式 ZIP 组装（macOS .app zip） |
+| [jszip](https://github.com/Stuk/jszip) | MIT / Apache-2.0 | 读取 Electron 发行版 zip |
+| [tar](https://github.com/isaacs/node-tar) | ISC | Electron 发行版归档处理 |
+| [7zip-bin](https://github.com/develar/7zip-bin) | MIT | 内嵌 7za 二进制，用于归档解压 |
+| [plist](https://github.com/TooTallNate/plist.js) | MIT | 结构化 Info.plist 的生成与改写 |
+| [resedit](https://github.com/lemon-s/resedit) | MIT | Windows PE 资源编辑（图标、版本信息） |
+| [js-yaml](https://github.com/nodeca/js-yaml) | MIT | NSIS 消息与 app-update.yml 渲染 |
+| [minimatch](https://github.com/isaacs/minimatch) | ISC | 文件集与过滤器的 glob 匹配 |
+| [@noble/hashes](https://github.com/paulmillr/noble-hashes) | MIT | asar 完整性与 blockmap 的 SHA-256 校验和 |
+| [fs-extra](https://github.com/jprichardson/node-fs-extra) | MIT | 文件系统辅助工具 |
+| [chromium-pickle-js](https://github.com/electron/node-chromium-pickle-js) | MIT | Asar 头部（pickle）序列化 |
+
+Windows 打包器自动获取 NSIS 工具链（首次使用时下载并缓存于本地），构建主机无需手动安装 NSIS。macOS 产物默认不签名，签名通过 `sign.mac` 钩子选配启用：可使用定制版 [rcodesign](https://github.com/Sg4Dylan/zip2dmg) 在任意宿主操作系统上完成签名，或在 macOS 上使用 `codesign`（参考实现见 `examples/signing-hooks.ts`）。如需在任意宿主操作系统上将生成的 `.app` zip 转换为 `.dmg` 镜像，请使用 [zip2dmg](https://github.com/Sg4Dylan/zip2dmg)。
+
+## 许可证
+
+### 项目许可证
+本项目基于 **AGPLv3 许可证**授权，详见 [LICENSE](LICENSE) 文件。
+
+### AI 披露与免责声明
+本项目的部分代码由 AI 编程工具生成或优化。维护者尽力保证质量，但 AI 生成的代码按**「原样」提供，不附带任何明示或默示的保证**。作者不保证 AI 贡献逻辑的绝对准确性、安全性或可靠性，建议用户自行审阅源代码。对于因使用 AI 生成内容而产生的任何索赔、损害或其他责任，作者概不负责。
+
+### 第三方软件声明
+本项目集成或使用了以下开源组件，谨向原作者致谢。完整清单及许可证见上方**「依赖说明」**表格。
+
+---
+
+Copyright (c) 2026-Present 项目贡献者。  
+基于 AGPLv3 许可证授权。

package/dist/archive/ar.d.ts

@@ -0,0 +1,12 @@
+import { Buffer } from 'node:buffer';
+export interface ArEntry {
+    name: string;
+    content: Buffer;
+    mode?: number;
+    mtime?: number;
+}
+/**
+ * Minimal `ar` archive writer, sufficient for .deb assembly
+ * (debian-binary + control.tar.xz + data.tar.xz).
+ */
+export declare function createArArchive(files: ArEntry[]): Buffer;

package/dist/archive/seven-za.d.ts

@@ -0,0 +1,32 @@
+export interface CompressOptions {
+    src: string;
+    dest: string;
+    format?: '7z' | 'xz';
+    level?: number;
+    threads?: number;
+    solid?: boolean;
+    sevenZipPath?: string;
+}
+export interface CompressResult {
+    level: number;
+    threads: number;
+    solid: boolean;
+}
+export declare function get7zaPath(): string;
+/**
+ * Parses `7z l` output for the total uncompressed size, used for the
+ * NSIS ESTIMATED_SIZE define. Returns 0 when listing fails.
+ */
+export declare function computeEstimatedSize(sevenZipPath: string, archiveFile: string): number;
+export declare function compress({ src, dest, format, level, threads, solid, sevenZipPath: sevenZipPathOption, }: CompressOptions): CompressResult;
+export declare function build7zaAddArgs({ src, dest, format, level, threads, solid, }: {
+    src: string;
+    dest: string;
+    format?: '7z' | 'xz';
+    level: number;
+    threads: number;
+    solid: boolean;
+}): {
+    args: string[];
+    cwd: string | undefined;
+};

package/dist/archive/tar.d.ts

@@ -0,0 +1,30 @@
+export type TarEntry = {
+    type: 'dir';
+    path: string;
+    mode?: number;
+} | {
+    type: 'file';
+    path: string;
+    mode?: number;
+    content?: Buffer;
+    filePath?: string;
+    getBuffer?: () => Promise<Buffer>;
+} | {
+    type: 'link';
+    path: string;
+    mode?: number;
+    target?: string;
+    getTarget?: () => Promise<string>;
+};
+/** Packs entries into an uncompressed tar at destPath. */
+export declare function writeTarFromEntries(entries: TarEntry[], destPath: string): Promise<void>;
+export interface CollectDirectoryOptions {
+    includeSymlinks?: boolean;
+    resolveFileMode?: (input: {
+        filePath: string;
+        relativePath: string;
+        sourceMode: number;
+    }) => number | undefined | undefined;
+}
+/** Flattens a directory on disk into tar entries rooted at prefix. */
+export declare function collectDirectoryEntries(dirPath: string, prefix: string, options?: CollectDirectoryOptions): Promise<TarEntry[]>;

package/dist/archive/zip-reader.d.ts

@@ -0,0 +1,17 @@
+import type { JSZipObject } from 'jszip';
+import JSZip from 'jszip';
+export interface ZipEntry {
+    path: string;
+    dir: boolean;
+    symlink: boolean;
+    mode: string | number;
+    entry: JSZipObject;
+}
+export declare function readZip(zipPath: string): Promise<{
+    entries: ZipEntry[];
+    zip: JSZip;
+}>;
+export declare function getEntryBuffer(entry: JSZipObject): Promise<Buffer>;
+export declare function getSymlinkTarget(entry: JSZipObject): Promise<string>;
+export declare function isSymlink(zipEntry: ZipEntry): boolean;
+export declare function isDefaultAppEntry(entryPath: string): boolean;

package/dist/asar/dependency/collect.d.ts

@@ -0,0 +1,2 @@
+import { type HoistedNodeModule } from './utils.ts';
+export declare function collectProductionDeps(projectDir: string, workspaceRoot: string | undefined): Promise<HoistedNodeModule[]>;

package/dist/asar/dependency/detector.d.ts

@@ -0,0 +1,8 @@
+export declare enum PackageManager {
+    NPM = "npm",
+    YARN = "yarn",
+    YARN_BERRY = "yarn-berry",
+    PNPM = "pnpm",
+    BUN = "bun"
+}
+export declare function detectPackageManager(projectDir: string): Promise<PackageManager>;

package/dist/asar/dependency/hoister.d.ts

@@ -0,0 +1,27 @@
+/** Input tree produced by transformToHoisterTree. */
+export interface HoisterTreeNode {
+    name: string;
+    identName: string;
+    reference: string;
+    peerNames: Set<string>;
+    dependencies: Set<HoisterTreeNode>;
+    hoistPriority?: number;
+    dependencyKind?: number;
+}
+/** Immutable shrunk tree returned by hoist. */
+export interface ShrunkNode {
+    name: string;
+    identName: string;
+    references: Set<string>;
+    dependencies: Set<ShrunkNode>;
+}
+interface HoistOptions {
+    debugLevel?: number;
+    check?: boolean;
+    hoistingLimits?: Map<string, Set<string>>;
+}
+export declare function hoist(tree: HoisterTreeNode, opts?: HoistOptions): ShrunkNode;
+export declare function transformToHoisterTree(productionGraph: Record<string, {
+    dependencies?: string[];
+}>, key: string, nodes?: Map<string, HoisterTreeNode>): HoisterTreeNode;
+export {};

package/dist/asar/dependency/utils.d.ts

@@ -0,0 +1,59 @@
+/** Raw dependency info extracted from a package manager's dependency graph. */
+export interface RawDependencyInfo {
+    name: string;
+    version: string;
+    path?: string;
+    _dependencies?: Record<string, string>;
+    dependencies?: Record<string, RawDependencyInfo>;
+    optionalDependencies?: Record<string, RawDependencyInfo>;
+}
+/** Flattened dependency entry stored in allDependencies. */
+export interface FlatDependency {
+    name: string;
+    version: string;
+    path: string;
+    _dependencies?: Record<string, string>;
+    dependencies?: Record<string, RawDependencyInfo>;
+    optionalDependencies?: Record<string, RawDependencyInfo>;
+}
+/** Node in the hoisted node_modules output tree. */
+export interface HoistedNodeModule {
+    name: string;
+    version: string;
+    dir: string;
+    dependencies?: HoistedNodeModule[];
+}
+export declare function execCommand(command: string, args: string[], cwd?: string): Promise<{
+    stdout: string;
+    stderr: string;
+    error: Error | null;
+}>;
+/** Parse JSON from a command output, tolerating surrounding log noise. */
+export declare function extractJsonFromOutput(output: string): unknown;
+export declare function resolvePackageDir(nmDir: string, pkgName: string): string | null;
+export declare function isProdDependency(depName: string, pkg: Pick<RawDependencyInfo, '_dependencies' | 'dependencies' | 'optionalDependencies'>): boolean;
+/** Read the root package.json and derive its locator key. */
+export declare function readRootPkgJson(projectDir: string): Promise<{
+    name: string;
+    version: string;
+    rootKey: string;
+}>;
+export declare function runHoistPipeline(allDependencies: Map<string, FlatDependency>, productionGraph: Record<string, {
+    dependencies: string[];
+}>, rootKey: string): Promise<{
+    nodeModules: HoistedNodeModule[];
+}>;
+/** Detect npm's duplicated-dependency marker entries (no deps of their own). */
+export declare function isDuplicatedNpmDependency(info: RawDependencyInfo | FlatDependency): boolean;
+export declare function collectFromObjectTree(deps: Record<string, RawDependencyInfo> | undefined, allDependencies: Map<string, FlatDependency>): void;
+export declare function extractProdGraphFromObjectTree(tree: RawDependencyInfo | undefined, dependencyId: string, productionGraph: Record<string, {
+    dependencies: string[];
+}>, allDependencies: Map<string, FlatDependency>): void;
+export declare function buildProductionGraphFromFlat(allDependencies: Map<string, FlatDependency>, productionGraph: Record<string, {
+    dependencies: string[];
+}>, rootKey: string): void;
+/** Split a "name@version" identifier into its parts. */
+export declare function parseNameVersion(identifier: string): {
+    name: string;
+    version: string;
+};

package/dist/asar/fileset/matcher.d.ts

@@ -0,0 +1,12 @@
+import type { Minimatch } from 'minimatch';
+import { type FileFilter, type FileStat } from '../../shared/types.ts';
+export declare const excludedNames: string;
+export declare const excludedExts: string;
+export declare const excludedFiles: Set<string>;
+export declare const topLevelExcludedFiles: Set<string>;
+export declare function hasMagic(pattern: Minimatch): boolean;
+/** Ensure a path string ends with the platform separator. */
+export declare function ensureEndSlash(s: string): string;
+export declare function getRelativePath(file: string, srcWithEndSlash: string, stat: FileStat): string;
+export declare function minimatchAll(p: string, patterns: Minimatch[], stat: FileStat): boolean;
+export declare function createFilter(src: string, patterns: Minimatch[], excludePatterns?: Minimatch[] | null): FileFilter;

package/dist/asar/fileset/platform-fileset.d.ts

@@ -0,0 +1,36 @@
+import { type Arch, NodePlatform } from '../../shared/platform.ts';
+import { type FileSet } from '../../shared/types.ts';
+/**
+ * A prebuilt native-module replacement rule: replace the node_modules copy
+ * of `moduleName` with files from `<projectDir>/<from>` in the packed fileset,
+ * optionally renaming the module directory.
+ */
+export interface PrebuiltModuleRule {
+    /** Module name as it appears in node_modules (may be scoped). */
+    moduleName: string;
+    /** Source directory (relative to projectDir) holding the prebuilt files. */
+    from: string;
+    /**
+     * Rename the module directory in the packed fileset (e.g. `@napi-rs/canvas-darwin-arm64`
+     * → `@napi-rs/canvas-<suffix>`); omit to keep the original name.
+     */
+    renameTo?: string;
+}
+/**
+ * Resolver producing the replacement rules for a platform/arch. Returning
+ * undefined/null skips prebuilt replacement and node_modules copies are
+ * used as-is.
+ */
+export type PrebuiltModuleRuleResolver = (platform: NodePlatform, arch: Arch) => ReadonlyArray<PrebuiltModuleRule> | null | undefined;
+/**
+ * Install the resolver used to derive prebuilt module replacement rules.
+ * Hosts inject their own rules through config.nativeModules.prebuiltRules.
+ */
+export declare function setPrebuiltDirResolver(resolver: PrebuiltModuleRuleResolver | null): void;
+export declare function derivePlatformFileSet(fileSet: FileSet, platform: NodePlatform, arch: Arch, projectDir: string): FileSet;
+/** Parse a file path inside node_modules into module name / subpath info. */
+export declare function parseModuleInfo(filePath: string): {
+    moduleName: string;
+    moduleRootPath: string;
+} | null;
+export declare function isExcludedPlatformPath(filePath: string, moduleRootPath: string, targetPlatform: NodePlatform, moduleName: string): boolean;

package/dist/asar/fileset/transformer.d.ts

@@ -0,0 +1,2 @@
+import type { JsonObject } from '../../shared/types.ts';
+export declare function createTransformer(srcDir: string, extraMetadata: JsonObject | undefined, extraTransformer?: (file: string) => Promise<string | null> | string | null): (file: string) => Promise<string | null> | string | null;

package/dist/asar/fileset/unpack-detector.d.ts

@@ -0,0 +1,10 @@
+import type { FileStat } from '../../shared/types.ts';
+/**
+ * Check whether a file is a native binary library or executable that
+ * should be unpacked from the asar archive by default.
+ */
+export declare function isLibOrExe(file: string): boolean;
+export declare function detectUnpackedDirs(fileSet: {
+    files: string[];
+    metadata: Map<string, FileStat>;
+}, autoUnpackDirs: Set<string>): void;

package/dist/asar/fileset/walker.d.ts

@@ -0,0 +1,14 @@
+import type { FileStat } from '../../shared/types.ts';
+export declare function walkDirectory(dirPath: string, files: string[], metadata: Map<string, FileStat>, projectDir: string): void;
+export declare function mergeFileSets(set1: {
+    files: string[];
+    metadata: Map<string, FileStat>;
+}, set2: {
+    files: string[];
+    metadata: Map<string, FileStat>;
+}): {
+    files: string[];
+    metadata: Map<string, FileStat>;
+};
+/** Derive the deepest common ancestor directory of a file list. */
+export declare function deriveProjectDir(files: string[]): string;

package/dist/asar/pack.d.ts

@@ -0,0 +1,23 @@
+import type { NormalizedConfig } from '../config/index.ts';
+import { type Arch, Platform } from '../shared/platform.ts';
+import type { FileSet } from '../shared/types.ts';
+type Transformer = (file: string) => Promise<string | null> | string | null;
+export declare function collectProjectFiles(projectDir: string, config: NormalizedConfig): Promise<{
+    appFileSet: FileSet;
+    nmFileSets: FileSet[];
+    transformer: (file: string) => Promise<string | null> | string | null;
+}>;
+export declare function packAsarForTarget({ platform, arch, appFileSet, nmFileSets, transformer, config, projectDir, stagingDir, }: {
+    platform: Platform;
+    arch: Arch;
+    appFileSet: FileSet;
+    nmFileSets: FileSet[];
+    transformer: Transformer;
+    config: NormalizedConfig;
+    projectDir: string;
+    stagingDir: string;
+}): Promise<{
+    asarPath: string;
+    unpackedDir: string | undefined;
+}>;
+export {};

package/dist/asar/packer/app-collector.d.ts

@@ -0,0 +1,2 @@
+import { type FileSet } from '../../shared/types.ts';
+export declare function collectAppFileSet(projectDir: string, distDir: string, includePdb: boolean): Promise<FileSet>;

package/dist/asar/packer/collector.d.ts

@@ -0,0 +1,18 @@
+import type { NodePlatform } from '../../shared/platform.ts';
+import type { FileFilter, FileSet, FileVisitor } from '../../shared/types.ts';
+export interface CollectAllFilesOptions {
+    platform: NodePlatform;
+    /** Directory under projectDir holding the built app (e.g. "out" for electron-vite). */
+    appDistDir: string;
+    includePdb: boolean;
+    disableDefaultIgnoredFiles: boolean;
+    workspaceRoot?: string;
+    extraMetadata?: Record<string, unknown>;
+    nodeModuleFileFilter?: FileFilter;
+    onNodeModuleFile?: FileVisitor;
+}
+export declare function collectAllFiles(projectDir: string, { platform, appDistDir, includePdb, disableDefaultIgnoredFiles, workspaceRoot, extraMetadata, nodeModuleFileFilter, onNodeModuleFile, }: CollectAllFilesOptions): Promise<{
+    appFileSet: FileSet;
+    nmFileSets: FileSet[];
+    transformer: (file: string) => Promise<string | null> | string | null;
+}>;

package/dist/asar/packer/concurrency.d.ts

@@ -0,0 +1 @@
+export declare function mapWithConcurrency<T, R>(items: T[], concurrency: number, mapper: (item: T, index: number) => Promise<R>): Promise<R[]>;

package/dist/asar/packer/integrity.d.ts

@@ -0,0 +1,8 @@
+export declare function readAsarHeader(archive: string): Promise<{
+    header: string;
+    size: number;
+}>;
+export declare function hashHeader(file: string): Promise<{
+    algorithm: string;
+    hash: string;
+}>;

package/dist/asar/packer/nm-collector.d.ts

@@ -0,0 +1,7 @@
+import { NodePlatform } from '../../shared/platform.ts';
+import { type FileFilter, type FileStat, type FileVisitor } from '../../shared/types.ts';
+export declare function getNodeModuleExcludedExts(platform: NodePlatform, includePdb: boolean): string[];
+export declare function collectNodeModuleFiles(moduleDir: string, moduleName: string, moduleRootPath: string, platform: NodePlatform, includePdb: boolean, disableDefaultIgnoredFiles: boolean, filter?: FileFilter | undefined, onNodeModuleFile?: FileVisitor | undefined): Promise<{
+    files: string[];
+    metadata: Map<string, FileStat>;
+}>;