@crustjs/crust-linux-x64 0.4.1 → 0.5.0

package/bin/crust-bun-linux-x64

@@ -1,4 +1,4 @@
 [diffend] Oversized file quarantined before diffing.
 name: package/bin/crust-bun-linux-x64
-size: 81446368 bytes
-sha256: 955217b1525763b803323a8913d88223c40f6abddf7ef9f22bf8ce9d9b1cf363
+size: 81483232 bytes
+sha256: 26e605fc91569c507f4560d18517271384362d1c5f1513a61cc2538494eec6ca

package/bin/dist/index.d.ts

@@ -1,6 +1,13 @@
 import { BuildReport, BuildReport as BuildReport$1 } from "@crustjs/core";
 import "@crustjs/core/tooling";
 //#region src/utils/distribute.d.ts
+/**
+ * What one build distributes: a runtime `package` (a root-only JavaScript
+ * bundle that needs the runtime installed) or standalone `binary` executables
+ * in platform packages behind a Node launcher.
+ */
+declare const ARTIFACT_KINDS: readonly ["package", "binary"];
+type ArtifactKind = (typeof ARTIFACT_KINDS)[number];
 /**
  * One file `crust build` generated or compiled into the staged tree. `target`
  * is the canonical compiler target of a platform package (`bun-linux-x64`),
@@ -31,10 +38,17 @@ type BuildArtifact = {
 type BuildOptions = {
   /** Project root whose package.json `bin` and `crust` are read. Default: `process.cwd()`. */
   cwd?: string;
+  /**
+   * `"package"` for a runtime package (a root-only JavaScript bundle that runs
+   * on the installed runtime) or `"binary"` for standalone executables in
+   * platform packages. Overrides package.json `crust.artifact`; one of the two
+   * is required.
+   */
+  artifact?: ArtifactKind;
   /**
    * Canonical compiler targets, or `"host"` for this machine. Overrides
-   * package.json `crust.targets`; omit both to stage every Bun/Deno target.
-   * Rejected for the node runtime.
+   * package.json `crust.targets`; omit both to stage every target of the
+   * binary compiler. Rejected for runtime packages.
    */
   targets?: readonly string[];
   /** Env files inlining `PUBLIC_*` build-time constants, resolved against `cwd`. Rejected for deno. */
@@ -55,19 +69,23 @@ type BuildResult = {
   reports?: Record<string, BuildReport$1>;
 };
 /**
- * Stages the publishable npm tree in `<cwd>/.crust`: a root package with one
- * `bin/<command>.js` per package.json `bin` entry, each a Node launcher (Bun,
- * Deno) or the bundle itself (Node), plus one platform package per target for
- * Bun and Deno holding one binary per command. Command names and source
- * entries come from `bin`; the runtime, Bun plugins, and extra directories
- * from package.json `crust`. Compilation and Command Snapshots run in bun
+ * Stages the publishable npm tree in `<cwd>/.crust` for one runtime/artifact
+ * combination: a root package with one `bin/<command>.js` per package.json
+ * `bin` entry, each the command's bundle (artifact `package`) or a Node
+ * launcher (artifact `binary`), plus for binaries one platform package per
+ * target holding one executable per command. Command names and source entries
+ * come from `bin`; the runtime, artifact, Bun plugins, and extra directories
+ * from package.json `crust`. Bundling and Command Snapshots run in bun
  * subprocesses (bun on PATH, or the running Bun executable), so this works
- * under Node as well when Bun is installed.
+ * under Node as well when Bun is installed; Deno binaries and Deno runtime
+ * packages (experimental, deno 2.5.0 or newer) need deno on PATH, and Node
+ * binaries a node on PATH that Crust's tsdown can build executables with.
  *
- * Throws on any failure. Planning failures (bad options or package.json) leave
- * the previous `.crust/` stage untouched; failures after planning leave a
- * wiped stage without a completion `manifest.json`. Overlapping calls for the
- * same real project directory in this process are rejected before staging.
+ * Throws on any failure. Planning and compiler-selection failures (bad
+ * options or package.json, a missing or hung compiler, an engines mismatch) leave the
+ * previous `.crust/` stage untouched; later failures leave a wiped stage
+ * without a completion `manifest.json`. Overlapping calls for the same real
+ * project directory in this process are rejected before staging.
  */
 export declare function build(options?: BuildOptions): Promise<BuildResult>;
 //#endregion