@crustjs/crust-linux-x64-musl 0.3.6 → 0.4.0

package/bin/crust-bun-linux-x64-musl

@@ -1,4 +1,4 @@
 [diffend] Oversized file quarantined before diffing.
 name: package/bin/crust-bun-linux-x64-musl
-size: 75408944 bytes
-sha256: 1d6089513d87ee63100d3ee30671548cffea9eada451453d0adf5ca628dfecb0
+size: 75417136 bytes
+sha256: f3aaedc89054e2d0f31ef4275d5edfe99319dd99a1e87573d4ef02e261174bbe

package/bin/dist/index.d.ts

@@ -0,0 +1,74 @@
+import { BuildReport, BuildReport as BuildReport$1 } from "@crustjs/core";
+import "@crustjs/core/tooling";
+//#region src/utils/distribute.d.ts
+/**
+ * One file `crust build` generated or compiled into the staged tree. `target`
+ * is the canonical compiler target of a platform package (`bun-linux-x64`),
+ * absent for the root package. Extension build hook output is reported by
+ * command in the `BuildReport`s instead, not repeated here.
+ */
+type BuildArtifact = {
+  kind: "package-json";
+  path: string;
+  target?: string;
+} | {
+  kind: "launcher";
+  path: string;
+  command: string;
+} | {
+  kind: "executable";
+  path: string;
+  command: string;
+  target: string;
+} | {
+  kind: "bundle";
+  path: string;
+  command: string;
+};
+//#endregion
+//#region src/commands/build.d.ts
+/** Options of the programmatic {@link build}; `crust build` maps its flags onto them. */
+type BuildOptions = {
+  /** Project root whose package.json `bin` and `crust` are read. Default: `process.cwd()`. */
+  cwd?: string;
+  /**
+   * 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.
+   */
+  targets?: readonly string[];
+  /** Env files inlining `PUBLIC_*` build-time constants, resolved against `cwd`. Rejected for deno. */
+  envFiles?: readonly string[];
+  /** Minify the output. Default: true for bun and node; an explicit `true` is rejected for deno. */
+  minify?: boolean;
+  /** Materialize Command Snapshots and run Extension build hooks before compiling. Default: true. */
+  validate?: boolean;
+  /** Receives each progress line `crust build` would print; silent when omitted. Warnings arrive as `"stderr"`. */
+  onLog?: (line: string, stream: "stdout" | "stderr") => void;
+};
+/** What {@link build} staged in `stageDir` (`<cwd>/.crust`). */
+type BuildResult = {
+  stageDir: string;
+  /** Generated package.json files, launchers, and compiled commands; see {@link BuildArtifact}. */
+  artifacts: BuildArtifact[];
+  /** Extension build hook output per command; absent when `validate` was false. */
+  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
+ * subprocesses (bun on PATH, or the running Bun executable), so this works
+ * under Node as well when Bun is installed.
+ *
+ * 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.
+ */
+export declare function build(options?: BuildOptions): Promise<BuildResult>;
+//#endregion
+export type { BuildArtifact, BuildOptions, BuildReport, BuildResult };