@kurone-kito/sea-builder 0.20.0-alpha.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Kuroné Kito (黒音キト)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,51 @@
+# 🟦 `@kurone-kito/sea-builder`
+
+SEA (Single Executable Application) Builder for the Node.js apps
+
+## System Requirements
+
+- Node.js: Any of the following versions
+  - Iron LTS (`^20.11.x`)
+  - Jod LTS (`^22.x.x`)
+  - Latest (`>=24.x.x`)
+
+## Usage
+
+The package provides two commands: `sea-builder` for building the binary
+and `sea-cache` for fetching Node.js archives used by the builder.
+
+### 1. **Cache Node.js archives**
+
+```sh
+sea-cache  # cache for current platform
+sea-cache linux-x64 win32-x64  # cache archives for multiple targets
+```
+
+Archives are downloaded to `node_modules/.cache/xsea` if not already
+present.
+
+### 2. **Build the SEA binary**
+
+```sh
+sea-builder  # build for current platform
+sea-builder linux-x64 win32-x64  # build for multiple targets
+```
+
+When no targets are specified, the current platform and architecture are
+used.
+
+### Options
+
+Both commands accept target strings in the format `<platform>-<arch>` such
+as `linux-x64` or `win32-x64`. `sea-builder` automatically invokes
+`pnpm exec xsea` with the downloaded archives to create the binary under
+`sea/pwt-cli`.
+
+### Cache directory
+
+All downloaded archives are stored in `node_modules/.cache/xsea`. You can
+delete this folder to clear the cache at any time.
+
+## LICENSE
+
+MIT

package/dist/builder.mjs

@@ -0,0 +1,105 @@
+#!/usr/bin/env node --enable-source-maps
+import { realpathSync, existsSync, mkdirSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { isNativeError } from "node:util/types";
+import { execa } from "execa";
+import { Listr } from "listr2";
+import { n as normalizeTargets, createCacheTasks } from "./cache.mjs";
+import { parseArgs } from "node:util";
+import "node:http";
+import "node:https";
+import "node:path";
+import "node:stream/promises";
+const staticConfig = {
+  allowPositionals: true,
+  options: {
+    help: { default: false, short: "h", type: "boolean" },
+    targets: { type: "string" }
+  }
+};
+const parseCliArgs = (argv) => {
+  const {
+    values,
+    positionals: [base]
+  } = parseArgs({ ...staticConfig, args: [...argv] });
+  if (values.help) {
+    return { help: true };
+  }
+  if (!base) {
+    throw new Error("Output file base name is required");
+  }
+  const list = values.targets?.split(",").filter(Boolean) ?? [];
+  return { help: false, basename: base, targets: list };
+};
+const usage = () => console.log(
+  "Usage: sea-builder --targets=<target>[,<target>[,...]] <output>"
+);
+const buildTask = (runExeca) => ({
+  title: "Build",
+  task: () => runExeca("pnpm", ["run", "build"], { stdio: "inherit" })
+});
+const cacheTask = (opts) => ({
+  title: "Download the Node.js archives",
+  task: () => createCacheTasks(opts).run()
+});
+const seaTask = (runExeca, targets, basename) => ({
+  title: "Linking the SEA binary",
+  task: () => {
+    const args = [
+      "exec",
+      "xsea",
+      "dist/index.mjs",
+      "-o",
+      `sea/${basename}`,
+      ...targets.flatMap((t) => ["-t", t])
+    ];
+    return runExeca("pnpm", args, { stdio: "inherit" });
+  }
+});
+const run = (options) => {
+  const {
+    arch = process.arch,
+    basename,
+    download: runDownload,
+    execa: runExeca = execa,
+    existsSync: runExistsSync = existsSync,
+    mkdirSync: runMkdirSync = mkdirSync,
+    nodeVersion = `v${process.versions.node}`,
+    platform = process.platform,
+    projectRoot,
+    targets = []
+  } = options;
+  const list = normalizeTargets(targets, platform, arch);
+  return new Listr([
+    buildTask(runExeca),
+    cacheTask({
+      targets: list,
+      download: runDownload,
+      existsSync: runExistsSync,
+      mkdirSync: runMkdirSync,
+      projectRoot,
+      nodeVersion
+    }),
+    seaTask(runExeca, list, basename)
+  ]).run();
+};
+const [__, bin = "", ...rawArgs] = process.argv;
+if (realpathSync(bin) === fileURLToPath(import.meta.url)) {
+  try {
+    const args = parseCliArgs(rawArgs);
+    if (args.help) {
+      usage();
+    } else {
+      await run(args);
+    }
+  } catch (err) {
+    if (isNativeError(err)) {
+      console.error(err.message);
+    }
+    process.exitCode = 1;
+  }
+}
+export {
+  run
+};
+//# sourceMappingURL=builder.mjs.map

package/dist/builder.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.mjs","sources":["../src/parseArgs.mts","../src/usage.mts","../src/builder.mts"],"sourcesContent":["import type { ParseArgsConfig } from 'node:util';\nimport { parseArgs } from 'node:util';\n\n/** Type definition for parsed CLI arguments. */\nexport interface HelpParsedArgs {\n  /** Indicates that help was requested. */\n  readonly help: true;\n}\n\n/** Type definition for parsed CLI arguments. */\nexport interface TargetsParsedArgs {\n  /** Indicates that help was not requested. */\n  readonly help: false;\n\n  /** The base name for the output file. */\n  readonly basename: string;\n\n  /** A list of target platforms. */\n  readonly targets: readonly string[];\n}\n\n/** Static configuration for CLI argument parsing. */\nconst staticConfig = {\n  allowPositionals: true,\n  options: {\n    help: { default: false, short: 'h', type: 'boolean' },\n    targets: { type: 'string' },\n  },\n} as const satisfies ParseArgsConfig;\n\n/**\n * Parse CLI arguments into options for {@link run}.\n * @param argv CLI arguments.\n * @returns Parsed values.\n */\nexport const parseCliArgs = (\n  argv: readonly string[],\n): HelpParsedArgs | TargetsParsedArgs => {\n  const {\n    values,\n    positionals: [base],\n  } = parseArgs({ ...staticConfig, args: [...argv] });\n  if (values.help) {\n    return { help: true };\n  }\n  if (!base) {\n    throw new Error('Output file base name is required');\n  }\n  const list = values.targets?.split(',').filter(Boolean) ?? [];\n  return { help: false, basename: base, targets: list };\n};\n","/** Display help message. */\nexport const usage = (): void =>\n  console.log(\n    'Usage: sea-builder --targets=<target>[,<target>[,...]] <output>',\n  );\n","#!/usr/bin/env node --enable-source-maps\n\nimport { existsSync, mkdirSync, realpathSync } from 'node:fs';\nimport { fileURLToPath } from 'node:url';\nimport { isNativeError } from 'node:util/types';\nimport { execa } from 'execa';\nimport { Listr } from 'listr2';\nimport type { CacheOptions } from './cache.mjs';\nimport { createCacheTasks } from './cache.mjs';\nimport { parseCliArgs } from './parseArgs.mts';\nimport { normalizeTargets } from './targets.mjs';\nimport { usage } from './usage.mjs';\n\n/** Options accepted by {@link run}. */\nexport interface RunOptions extends CacheOptions {\n  /** `execa` implementation. */\n  readonly execa?: typeof execa | undefined;\n\n  /** Output file base name. */\n  readonly basename: string;\n}\n\n/**\n * Create a task for building the project.\n * @param runExeca The implementation of {@link execa} to use.\n * @returns Listr task object.\n */\nconst buildTask = (runExeca: typeof execa) => ({\n  title: 'Build',\n  task: () => runExeca('pnpm', ['run', 'build'], { stdio: 'inherit' }),\n});\n\n/**\n * Create a task for caching Node.js archives.\n * @param opts Options for cache creation including targets.\n * @returns Listr task object.\n */\nconst cacheTask = (\n  opts: CacheOptions & { readonly targets: readonly string[] },\n) => ({\n  title: 'Download the Node.js archives',\n  task: () => createCacheTasks(opts).run(),\n});\n\n/**\n * Create a task for generating the SEA binary.\n * @param runExeca The implementation of {@link execa} to use.\n * @param targets  Normalized target strings.\n * @param basename Base name for the output file.\n * @returns Listr task object.\n */\nconst seaTask = (\n  runExeca: typeof execa,\n  targets: readonly string[],\n  basename: string,\n) => ({\n  title: 'Linking the SEA binary',\n  task: () => {\n    const args = [\n      'exec',\n      'xsea',\n      'dist/index.mjs',\n      '-o',\n      `sea/${basename}`,\n      ...targets.flatMap((t) => ['-t', t]),\n    ];\n    return runExeca('pnpm', args, { stdio: 'inherit' });\n  },\n});\n\n/**\n * Execute SEA build process.\n *\n * This function runs a series of tasks to build the project, download\n * required Node.js archives and finally generate the SEA binary.\n * @param options Options controlling the build behaviour.\n */\nexport const run = (options: RunOptions): Promise<void> => {\n  const {\n    arch = process.arch,\n    basename,\n    download: runDownload,\n    execa: runExeca = execa,\n    existsSync: runExistsSync = existsSync,\n    mkdirSync: runMkdirSync = mkdirSync,\n    nodeVersion = `v${process.versions.node}`,\n    platform = process.platform,\n    projectRoot,\n    targets = [],\n  } = options;\n  const list = normalizeTargets(targets, platform, arch);\n  return new Listr([\n    buildTask(runExeca),\n    cacheTask({\n      targets: list,\n      download: runDownload,\n      existsSync: runExistsSync,\n      mkdirSync: runMkdirSync,\n      projectRoot,\n      nodeVersion,\n    }),\n    seaTask(runExeca, list, basename),\n  ]).run();\n};\n\nconst [__, bin = '', ...rawArgs] = process.argv;\nif (realpathSync(bin) === fileURLToPath(import.meta.url)) {\n  try {\n    const args = parseCliArgs(rawArgs);\n    if (args.help) {\n      usage();\n    } else {\n      await run(args);\n    }\n  } catch (err) {\n    if (isNativeError(err)) {\n      console.error(err.message);\n    }\n    process.exitCode = 1;\n  }\n}\n"],"names":[],"mappings":";;;;;;;;;;;;AAsBA,MAAM,eAAe;AAAA,EACnB,kBAAkB;AAAA,EAClB,SAAS;AAAA,IACP,MAAM,EAAE,SAAS,OAAO,OAAO,KAAK,MAAM,UAAA;AAAA,IAC1C,SAAS,EAAE,MAAM,SAAA;AAAA,EAAS;AAE9B;AAOO,MAAM,eAAe,CAC1B,SACuC;AACvC,QAAM;AAAA,IACJ;AAAA,IACA,aAAa,CAAC,IAAI;AAAA,EAAA,IAChB,UAAU,EAAE,GAAG,cAAc,MAAM,CAAC,GAAG,IAAI,GAAG;AAClD,MAAI,OAAO,MAAM;AACf,WAAO,EAAE,MAAM,KAAA;AAAA,EAAK;AAEtB,MAAI,CAAC,MAAM;AACT,UAAM,IAAI,MAAM,mCAAmC;AAAA,EAAA;AAErD,QAAM,OAAO,OAAO,SAAS,MAAM,GAAG,EAAE,OAAO,OAAO,KAAK,CAAA;AAC3D,SAAO,EAAE,MAAM,OAAO,UAAU,MAAM,SAAS,KAAA;AACjD;ACjDO,MAAM,QAAQ,MACnB,QAAQ;AAAA,EACN;AACF;ACuBF,MAAM,YAAY,CAAC,cAA4B;AAAA,EAC7C,OAAO;AAAA,EACP,MAAM,MAAM,SAAS,QAAQ,CAAC,OAAO,OAAO,GAAG,EAAE,OAAO,UAAA,CAAW;AACrE;AAOA,MAAM,YAAY,CAChB,UACI;AAAA,EACJ,OAAO;AAAA,EACP,MAAM,MAAM,iBAAiB,IAAI,EAAE,IAAA;AACrC;AASA,MAAM,UAAU,CACd,UACA,SACA,cACI;AAAA,EACJ,OAAO;AAAA,EACP,MAAM,MAAM;AACV,UAAM,OAAO;AAAA,MACX;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,OAAO,QAAQ;AAAA,MACf,GAAG,QAAQ,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAAA,IAAA;AAErC,WAAO,SAAS,QAAQ,MAAM,EAAE,OAAO,WAAW;AAAA,EAAA;AAEtD;AASO,MAAM,MAAM,CAAC,YAAuC;AACzD,QAAM;AAAA,IACJ,OAAO,QAAQ;AAAA,IACf;AAAA,IACA,UAAU;AAAA,IACV,OAAO,WAAW;AAAA,IAClB,YAAY,gBAAgB;AAAA,IAC5B,WAAW,eAAe;AAAA,IAC1B,cAAc,IAAI,QAAQ,SAAS,IAAI;AAAA,IACvC,WAAW,QAAQ;AAAA,IACnB;AAAA,IACA,UAAU,CAAA;AAAA,EAAC,IACT;AACJ,QAAM,OAAO,iBAAiB,SAAS,UAAU,IAAI;AACrD,SAAO,IAAI,MAAM;AAAA,IACf,UAAU,QAAQ;AAAA,IAClB,UAAU;AAAA,MACR,SAAS;AAAA,MACT,UAAU;AAAA,MACV,YAAY;AAAA,MACZ,WAAW;AAAA,MACX;AAAA,MACA;AAAA,IAAA,CACD;AAAA,IACD,QAAQ,UAAU,MAAM,QAAQ;AAAA,EAAA,CACjC,EAAE,IAAA;AACL;AAEA,MAAM,CAAC,IAAI,MAAM,IAAI,GAAG,OAAO,IAAI,QAAQ;AAC3C,IAAI,aAAa,GAAG,MAAM,cAAc,YAAY,GAAG,GAAG;AACxD,MAAI;AACF,UAAM,OAAO,aAAa,OAAO;AACjC,QAAI,KAAK,MAAM;AACb,YAAA;AAAA,IAAM,OACD;AACL,YAAM,IAAI,IAAI;AAAA,IAAA;AAAA,EAChB,SACO,KAAK;AACZ,QAAI,cAAc,GAAG,GAAG;AACtB,cAAQ,MAAM,IAAI,OAAO;AAAA,IAAA;AAE3B,YAAQ,WAAW;AAAA,EAAA;AAEvB;"}

package/dist/cache.mjs

@@ -0,0 +1,95 @@
+#!/usr/bin/env node --enable-source-maps
+import { realpathSync, existsSync, mkdirSync, createWriteStream } from "node:fs";
+import http from "node:http";
+import https from "node:https";
+import { join, dirname } from "node:path";
+import { pipeline } from "node:stream/promises";
+import { fileURLToPath } from "node:url";
+import { Listr } from "listr2";
+const normalizeTargets = (targets, platform, arch) => targets.length ? [...targets] : [`${platform}-${arch}`];
+const findProjectRoot = (startPath, runExistsSync) => {
+  let currentPath = startPath;
+  let parentPath = dirname(currentPath);
+  while (currentPath !== parentPath) {
+    if (runExistsSync(join(currentPath, "package.json")) || runExistsSync(join(currentPath, "node_modules"))) {
+      return currentPath;
+    }
+    currentPath = parentPath;
+    parentPath = dirname(currentPath);
+  }
+  return startPath;
+};
+const createMetaFactory = (cacheDir, nodeVersion) => (target) => {
+  const ext = target.startsWith("win") ? "zip" : "tar.gz";
+  const archive = `node-${nodeVersion}-${target}.${ext}`;
+  return {
+    target,
+    archivePath: join(cacheDir, archive),
+    url: `https://nodejs.org/dist/${nodeVersion}/${archive}`
+  };
+};
+const downloadFile = async (url, dest) => {
+  const { protocol } = new URL(url);
+  const getter = protocol === "http:" ? http.get : https.get;
+  await new Promise((resolve, reject) => {
+    getter(url, (res) => {
+      if (res.statusCode && res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+        downloadFile(res.headers.location, dest).then(resolve, reject);
+        return;
+      }
+      if (res.statusCode !== 200) {
+        reject(new Error(`Failed to download: ${res.statusCode}`));
+        return;
+      }
+      const file = createWriteStream(dest);
+      pipeline(res, file).then(resolve).catch(reject);
+    }).on("error", reject);
+  });
+};
+const createTaskFactory = (runDownload, runExistsSync, runMkdirSync, cacheDir) => ({ target, archivePath, url }) => ({
+  title: target,
+  task: async () => {
+    runMkdirSync(cacheDir, { recursive: true });
+    if (!runExistsSync(archivePath)) {
+      await runDownload(url, archivePath);
+    }
+  }
+});
+const createCacheTasks = (options = {}) => {
+  const {
+    arch = process.arch,
+    download: runDownload = downloadFile,
+    existsSync: runExistsSync = existsSync,
+    mkdirSync: runMkdirSync = mkdirSync,
+    nodeVersion = `v${process.versions.node}`,
+    platform = process.platform,
+    projectRoot,
+    targets = []
+  } = options;
+  const list = normalizeTargets(targets, platform, arch);
+  const detectedRoot = projectRoot || findProjectRoot(process.cwd(), runExistsSync);
+  const cacheDir = join(detectedRoot, "node_modules/.cache/xsea");
+  const metaFor = createMetaFactory(cacheDir, nodeVersion);
+  const toTask = createTaskFactory(
+    runDownload,
+    runExistsSync,
+    runMkdirSync,
+    cacheDir
+  );
+  return new Listr(
+    list.map((t) => toTask(metaFor(t))),
+    { concurrent: true }
+  );
+};
+const cache = async (options = {}) => {
+  await createCacheTasks(options).run();
+};
+if (realpathSync(process.argv[1]) === fileURLToPath(import.meta.url)) {
+  await cache({ targets: process.argv.slice(2) });
+}
+export {
+  cache,
+  createCacheTasks,
+  normalizeTargets as n
+};
+//# sourceMappingURL=cache.mjs.map

package/dist/cache.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.mjs","sources":["../src/targets.mts","../src/cache.mts"],"sourcesContent":["/**\n * Normalize target list for SEA build.\n *\n * When {@link targets} is empty, this function falls back to the current\n * {@link platform} and {@link arch} to create a single target string.\n * @param targets Target strings such as `linux-x64`.\n * @param platform Host platform name.\n * @param arch Host architecture name.\n * @returns Normalized target array.\n */\nexport const normalizeTargets = (\n  targets: readonly string[],\n  platform: NodeJS.Platform,\n  arch: string,\n): readonly string[] =>\n  targets.length ? [...targets] : [`${platform}-${arch}`];\n","#!/usr/bin/env node --enable-source-maps\n\nimport {\n  createWriteStream,\n  existsSync,\n  mkdirSync,\n  realpathSync,\n} from 'node:fs';\nimport http from 'node:http';\nimport https from 'node:https';\nimport { dirname, join } from 'node:path';\nimport { pipeline } from 'node:stream/promises';\nimport { fileURLToPath } from 'node:url';\nimport { Listr } from 'listr2';\nimport { normalizeTargets } from './targets.mjs';\n\n/**\n * Find the project root by looking for package.json or node_modules.\n * @param startPath Starting directory path.\n * @param runExistsSync File existence check function.\n * @returns Project root directory path.\n */\nconst findProjectRoot = (\n  startPath: string,\n  runExistsSync: typeof existsSync,\n): string => {\n  let currentPath = startPath;\n  let parentPath = dirname(currentPath);\n\n  while (currentPath !== parentPath) {\n    if (\n      runExistsSync(join(currentPath, 'package.json')) ||\n      runExistsSync(join(currentPath, 'node_modules'))\n    ) {\n      return currentPath;\n    }\n    currentPath = parentPath;\n    parentPath = dirname(currentPath);\n  }\n\n  // If no project root is found, fall back to the starting path\n  return startPath;\n};\n\n/** Metadata for a Node.js archive. */\ninterface ArchiveMeta {\n  /** Local archive path. */\n  readonly archivePath: string;\n\n  /** Target string such as `linux-x64`. */\n  readonly target: string;\n\n  /** Download URL of the archive. */\n  readonly url: string;\n}\n\n/** Options accepted by {@link cache} and {@link createCacheTasks}. */\nexport interface CacheOptions {\n  /** Target strings such as `linux-x64`. */\n  readonly targets?: readonly string[] | undefined;\n\n  /** File download function used to fetch archives. */\n  readonly download?:\n    | ((url: string, dest: string) => Promise<void>)\n    | undefined;\n\n  /** `fs.existsSync` implementation. */\n  readonly existsSync?: typeof existsSync | undefined;\n\n  /** `fs.mkdirSync` implementation. */\n  readonly mkdirSync?: typeof mkdirSync | undefined;\n\n  /** Project root directory path. If not provided, will be auto-detected. */\n  readonly projectRoot?: string | undefined;\n\n  /** Platform identifier. */\n  readonly platform?: NodeJS.Platform | undefined;\n\n  /** Architecture identifier. */\n  readonly arch?: string | undefined;\n\n  /** Node.js version string. */\n  readonly nodeVersion?: string | undefined;\n}\n\n/**\n * Create a function that generates metadata for a given target.\n * @param cacheDir Directory to store archives in.\n * @param nodeVersion Node.js version string.\n * @returns Function producing {@link ArchiveMeta} objects.\n */\nconst createMetaFactory =\n  (cacheDir: string, nodeVersion: string) =>\n  (target: string): ArchiveMeta => {\n    const ext = target.startsWith('win') ? 'zip' : 'tar.gz';\n    const archive = `node-${nodeVersion}-${target}.${ext}`;\n    return {\n      target,\n      archivePath: join(cacheDir, archive),\n      url: `https://nodejs.org/dist/${nodeVersion}/${archive}`,\n    };\n  };\n\n/**\n * Download a file from the given URL.\n * @param url Source URL.\n * @param dest Destination file path.\n */\nconst downloadFile = async (url: string, dest: string): Promise<void> => {\n  const { protocol } = new URL(url);\n  const getter = protocol === 'http:' ? http.get : https.get;\n  await new Promise<void>((resolve, reject) => {\n    getter(url, (res) => {\n      if (\n        res.statusCode &&\n        res.statusCode >= 300 &&\n        res.statusCode < 400 &&\n        res.headers.location\n      ) {\n        downloadFile(res.headers.location, dest).then(resolve, reject);\n        return;\n      }\n      if (res.statusCode !== 200) {\n        reject(new Error(`Failed to download: ${res.statusCode}`));\n        return;\n      }\n      const file = createWriteStream(dest);\n      pipeline(res, file).then(resolve).catch(reject);\n    }).on('error', reject);\n  });\n};\n\n/**\n * Create a function that converts metadata into a Listr task.\n * @param runDownload File download function.\n * @param runExistsSync File existence check function.\n * @param runMkdirSync Directory creation function.\n * @param cacheDir Directory for cached archives.\n * @returns Function producing Listr tasks.\n */\nconst createTaskFactory =\n  (\n    runDownload: (url: string, dest: string) => Promise<void>,\n    runExistsSync: typeof existsSync,\n    runMkdirSync: typeof mkdirSync,\n    cacheDir: string,\n  ) =>\n  ({ target, archivePath, url }: ArchiveMeta) => ({\n    title: target,\n    task: async () => {\n      runMkdirSync(cacheDir, { recursive: true });\n      if (!runExistsSync(archivePath)) {\n        await runDownload(url, archivePath);\n      }\n    },\n  });\n\n/**\n * Create Listr tasks for downloading Node.js archives.\n * @param options Options controlling the task generation.\n * @returns Configured {@link Listr} instance.\n */\nexport const createCacheTasks = (options: CacheOptions = {}): Listr => {\n  const {\n    arch = process.arch,\n    download: runDownload = downloadFile,\n    existsSync: runExistsSync = existsSync,\n    mkdirSync: runMkdirSync = mkdirSync,\n    nodeVersion = `v${process.versions.node}`,\n    platform = process.platform,\n    projectRoot,\n    targets = [],\n  } = options;\n  const list = normalizeTargets(targets, platform, arch);\n  const detectedRoot =\n    projectRoot || findProjectRoot(process.cwd(), runExistsSync);\n  const cacheDir = join(detectedRoot, 'node_modules/.cache/xsea');\n  const metaFor = createMetaFactory(cacheDir, nodeVersion);\n  const toTask = createTaskFactory(\n    runDownload,\n    runExistsSync,\n    runMkdirSync,\n    cacheDir,\n  );\n  return new Listr(\n    list.map((t) => toTask(metaFor(t))),\n    { concurrent: true },\n  );\n};\n\n/**\n * Download Node.js archives if they are not cached.\n * @param options Options controlling the download behaviour.\n */\nexport const cache = async (options: CacheOptions = {}): Promise<void> => {\n  await createCacheTasks(options).run();\n};\n// @ts-expect-error\nif (realpathSync(process.argv[1]) === fileURLToPath(import.meta.url)) {\n  await cache({ targets: process.argv.slice(2) });\n}\n"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@kurone-kito/sea-builder",
+  "version": "0.20.0-alpha.3",
+  "description": "The Single Executable App (SEA) builder for the Node.js",
+  "keywords": [
+    "sea",
+    "builder",
+    "boilerplate",
+    "template"
+  ],
+  "homepage": "https://github.com/kurone-kito/builder-config#readme",
+  "bugs": "https://github.com/kurone-kito/builder-config/issues",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kurone-kito/builder-config.git",
+    "directory": "packages/sea-builder"
+  },
+  "license": "MIT",
+  "author": "kurone-kito <krone@kit.black> (https://kit.black/)",
+  "type": "module",
+  "bin": {
+    "sea-builder": "./dist/builder.mjs",
+    "sea-cache": "./dist/cache.mjs"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "execa": "^9.6.0",
+    "listr2": "^8.3.3"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.4",
+    "@vitest/coverage-v8": "^3.2.4",
+    "cpy-cli": "^5.0.0",
+    "rimraf": "^6.0.1",
+    "typescript": "~5.8.3",
+    "vite": "^7.0.0",
+    "vitest": "^3.2.4",
+    "@kurone-kito/typescript-config": "^0.20.0-alpha.3",
+    "@kurone-kito/vite-lib-config": "^0.20.0-alpha.3"
+  },
+  "peerDependencies": {
+    "xsea": "*"
+  },
+  "peerDependenciesMeta": {
+    "xsea": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": "^20.11 || ^22 || >=24"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "vite build",
+    "clean": "rimraf -g \"*.tgz\" \"*.tsbuildinfo\" coverage dist LICENSE node_modules/.cache",
+    "dev": "vite build --watch",
+    "devPreinstall": "pnpm dlx mkdirp dist && pnpm run \"/devPreinstall:.+/\"",
+    "devPreinstall:builder": "pnpm dlx shx head -n 1 src/builder.mts > dist/builder.mjs",
+    "devPreinstall:cache": "pnpm dlx shx head -n 1 src/cache.mts > dist/cache.mjs",
+    "prebuild": "cpy --flat ../../LICENSE .",
+    "test": "vitest run --coverage"
+  }
+}