stitchkit 0.104.1 → 0.104.2

package/CHANGELOG.md

@@ -15,6 +15,16 @@ additive**; the first breaking change landed in 0.10.0. Grep the file for
 
 ## [Unreleased]
 
+## [0.104.2] - 2026-10-04
+
+### Added
+
+- `stitchkit/files/packaging`: one multi-target companion plugin packages both Darwin addons into a universal JS artifact; explicit per-architecture output paths preserve single-target and embedded recipes.
+
+### Fixed
+
+- Native qualification waits for the helper’s actual first write instead of inferring readiness from startup timing.
+
 ## [0.104.1] - 2026-10-04
 
 ### Added

package/dist/entrypoints/files/packaging.js

@@ -33,18 +33,54 @@ function nativeLoaderSource(assets) {
 
 // src/files/native-packaging.ts
 var OutputPathSchema = z2.string().min(1).refine((value) => !value.startsWith("/") && !/^[a-z]:/i.test(value) && !value.includes("\\") && value.split("/").every((part) => part !== ".." && part !== "." && part.length > 0), "Expected a relative output path without traversal");
-var OptionsSchema = z2.object({
+var ArchitectureSchema = z2.enum(["arm64", "x64"]);
+var CommonOptions = {
   platform: z2.string().min(1),
+  entryPath: OutputPathSchema.refine((value) => !value.includes("[") && !value.includes("]"), "Expected a fixed entry path without Bun naming templates")
+};
+var SingleOptionsSchema = z2.object({
+  ...CommonOptions,
   architecture: z2.string().min(1),
   delivery: z2.enum(["companion", "embedded"]),
-  entryPath: OutputPathSchema.refine((value) => !value.includes("[") && !value.includes("]"), "Expected a fixed entry path without Bun naming templates"),
   assetPath: OutputPathSchema
-}).refine((input) => input.entryPath !== input.assetPath && !input.entryPath.startsWith(`${input.assetPath}/`) && !input.assetPath.startsWith(`${input.entryPath}/`), "Entry and addon must have non-overlapping paths");
+});
+var MultipleOptionsSchema = z2.object({
+  ...CommonOptions,
+  architecture: z2.array(z2.string().min(1)).min(1),
+  delivery: z2.literal("companion"),
+  assetPath: z2.record(z2.string().min(1), OutputPathSchema)
+});
+var OptionsSchema = z2.union([SingleOptionsSchema, MultipleOptionsSchema]).superRefine((input, ctx) => {
+  const targets = typeof input.architecture === "string" ? [input.architecture] : input.architecture;
+  if (new Set(targets).size !== targets.length)
+    ctx.addIssue({ code: "custom", message: "Architecture targets must be unique" });
+  const assetPaths = typeof input.assetPath === "string" ? [input.assetPath] : Object.values(input.assetPath);
+  const assetMap = input.assetPath;
+  if (typeof assetMap !== "string" && (Object.keys(assetMap).length !== targets.length || targets.some((target) => !Object.hasOwn(assetMap, target))))
+    ctx.addIssue({
+      code: "custom",
+      message: "Asset paths must name exactly the declared architectures"
+    });
+  const paths = [input.entryPath, ...assetPaths];
+  for (let at = 0;at < paths.length; at++) {
+    const left = paths[at];
+    if (!left)
+      continue;
+    for (const right of paths.slice(at + 1)) {
+      if (left === right || left.startsWith(`${right}/`) || right.startsWith(`${left}/`))
+        ctx.addIssue({
+          code: "custom",
+          message: "Entry and addons must have non-overlapping paths"
+        });
+    }
+  }
+});
 var AssetSchema = z2.object({
   sourcePath: z2.string(),
   outputPath: z2.string(),
   sha256: z2.string().regex(/^[a-f0-9]{64}$/)
 });
+var TargetAssetSchema = AssetSchema.extend({ architecture: ArchitectureSchema });
 var RefusalSchema = z2.object({
   state: z2.enum(["unsupported", "missing"]),
   platform: z2.string(),
@@ -65,48 +101,63 @@ function installedPackageRoot() {
 }
 function createNativePackaging(options) {
   const input = OptionsSchema.parse(options);
-  if (input.platform !== "darwin" || input.architecture !== "arm64" && input.architecture !== "x64") {
-    return {
-      state: "unsupported",
-      platform: input.platform,
-      architecture: input.architecture,
-      code: "NATIVE_TARGET_UNSUPPORTED"
-    };
+  const declared = typeof input.architecture === "string" ? [input.architecture] : input.architecture;
+  const architectures = [];
+  for (const architecture of declared) {
+    const target = ArchitectureSchema.safeParse(architecture);
+    if (input.platform !== "darwin" || !target.success)
+      return {
+        state: "unsupported",
+        platform: input.platform,
+        architecture,
+        code: "NATIVE_TARGET_UNSUPPORTED"
+      };
+    architectures.push(target.data);
   }
   const root = installedPackageRoot();
   const layout = NativeLayoutSchema.parse(JSON.parse(readFileSync(resolve(root, "native-assets.json"), "utf8")));
   const manifest = z2.object({ name: z2.literal("stitchkit"), version: z2.string().min(1) }).parse(JSON.parse(readFileSync(resolve(root, "package.json"), "utf8")));
   const loaderPath = resolve(root, layout.loader);
-  const sourcePath = resolve(root, layout.assets[input.architecture]);
-  let bytes;
-  try {
-    bytes = readFileSync(sourcePath);
-  } catch (cause) {
-    if (cause instanceof Error && "code" in cause && cause.code === "ENOENT") {
-      return {
-        state: "missing",
-        platform: input.platform,
-        architecture: input.architecture,
-        code: "NATIVE_ASSET_MISSING"
-      };
+  const assets = [];
+  const specifiers = {};
+  for (const architecture of architectures) {
+    const sourcePath = resolve(root, layout.assets[architecture]);
+    const outputPath = typeof input.assetPath === "string" ? input.assetPath : input.assetPath[architecture];
+    if (!outputPath)
+      throw new Error("Declared architecture has no output path");
+    let bytes;
+    try {
+      bytes = readFileSync(sourcePath);
+    } catch (cause) {
+      if (cause instanceof Error && "code" in cause && cause.code === "ENOENT")
+        return {
+          state: "missing",
+          platform: input.platform,
+          architecture,
+          code: "NATIVE_ASSET_MISSING"
+        };
+      throw cause;
     }
-    throw cause;
+    const outputSpecifier = relative(dirname(input.entryPath), outputPath).split("\\").join("/");
+    specifiers[architecture] = input.delivery === "embedded" ? sourcePath : outputSpecifier.startsWith(".") ? outputSpecifier : `./${outputSpecifier}`;
+    const asset = {
+      sourcePath,
+      outputPath,
+      sha256: createHash("sha256").update(bytes).digest("hex")
+    };
+    assets.push(typeof input.architecture === "string" ? asset : { ...asset, architecture });
   }
-  const outputSpecifier = relative(dirname(input.entryPath), input.assetPath).split("\\").join("/");
-  const specifier = input.delivery === "embedded" ? sourcePath : outputSpecifier.startsWith(".") ? outputSpecifier : `./${outputSpecifier}`;
-  const contents = nativeLoaderSource({ [input.architecture]: specifier });
+  const first = architectures[0];
+  if (!first)
+    throw new Error("Native packaging has no declared targets");
+  const contents = nativeLoaderSource(specifiers);
+  const external = new Set(Object.values(specifiers));
   return {
     state: "ready",
     platform: "darwin",
-    architecture: input.architecture,
+    architecture: typeof input.architecture === "string" ? first : architectures,
     packageVersion: manifest.version,
-    assets: [
-      {
-        sourcePath,
-        outputPath: input.assetPath,
-        sha256: createHash("sha256").update(bytes).digest("hex")
-      }
-    ],
+    assets,
     plugin: {
       name: "stitchkit-native-packaging",
       setup(build) {
@@ -122,7 +173,7 @@ function createNativePackaging(options) {
         }
         build.onLoad({ filter: /\.[cm]?js$/ }, (args) => args.path === loaderPath ? { contents, loader: "js" } : undefined);
         if (input.delivery === "companion") {
-          build.onResolve({ filter: /./ }, (args) => args.importer === loaderPath && args.path === specifier ? { path: specifier, external: true } : undefined);
+          build.onResolve({ filter: /./ }, (args) => args.importer === loaderPath && external.has(args.path) ? { path: args.path, external: true } : undefined);
         }
       }
     }

package/dist/files/native-packaging.d.ts

@@ -1,19 +1,39 @@
 import { z } from 'zod';
-declare const OptionsSchema: z.ZodObject<{
+declare const ArchitectureSchema: z.ZodEnum<{
+    arm64: "arm64";
+    x64: "x64";
+}>;
+declare const SingleOptionsSchema: z.ZodObject<{
     platform: z.ZodString;
+    entryPath: z.ZodString;
     architecture: z.ZodString;
     delivery: z.ZodEnum<{
         companion: "companion";
         embedded: "embedded";
     }>;
-    entryPath: z.ZodString;
     assetPath: z.ZodString;
 }, z.core.$strip>;
+declare const MultipleOptionsSchema: z.ZodObject<{
+    platform: z.ZodString;
+    entryPath: z.ZodString;
+    architecture: z.ZodArray<z.ZodString>;
+    delivery: z.ZodLiteral<"companion">;
+    assetPath: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strip>;
 declare const AssetSchema: z.ZodObject<{
     sourcePath: z.ZodString;
     outputPath: z.ZodString;
     sha256: z.ZodString;
 }, z.core.$strip>;
+declare const TargetAssetSchema: z.ZodObject<{
+    sourcePath: z.ZodString;
+    outputPath: z.ZodString;
+    sha256: z.ZodString;
+    architecture: z.ZodEnum<{
+        arm64: "arm64";
+        x64: "x64";
+    }>;
+}, z.core.$strip>;
 declare const RefusalSchema: z.ZodObject<{
     state: z.ZodEnum<{
         missing: "missing";
@@ -26,8 +46,8 @@ declare const RefusalSchema: z.ZodObject<{
         NATIVE_TARGET_UNSUPPORTED: "NATIVE_TARGET_UNSUPPORTED";
     }>;
 }, z.core.$strip>;
-export type NativePackagingOptions = z.input<typeof OptionsSchema>;
-export type NativePackagingAsset = z.infer<typeof AssetSchema>;
+export type NativePackagingOptions<Multiple extends boolean = false> = Multiple extends true ? z.input<typeof MultipleOptionsSchema> : z.input<typeof SingleOptionsSchema>;
+export type NativePackagingAsset<Multiple extends boolean = false> = Multiple extends true ? z.infer<typeof TargetAssetSchema> : z.infer<typeof AssetSchema>;
 /** Structural Bun plugin protocol: declarations need no Bun runtime or ambient types. */
 export type NativePackagingPlugin = {
     name: string;
@@ -58,15 +78,17 @@ export type NativePackagingPlugin = {
         } | undefined) => unknown;
     }) => void;
 };
-export type NativePackagingResult = z.infer<typeof RefusalSchema> | {
+export type NativePackagingResult<Multiple extends boolean = false> = z.infer<typeof RefusalSchema> | {
     state: 'ready';
     platform: 'darwin';
-    architecture: 'arm64' | 'x64';
+    architecture: Multiple extends true ? z.infer<typeof ArchitectureSchema>[] : z.infer<typeof ArchitectureSchema>;
     packageVersion: string;
-    assets: NativePackagingAsset[];
+    assets: NativePackagingAsset<Multiple>[];
     plugin: NativePackagingPlugin;
 };
 /** Resolve this installed package's asset graph, without parsing downstream loader text. */
 export declare function createNativePackaging(options: NativePackagingOptions): NativePackagingResult;
+export declare function createNativePackaging(options: NativePackagingOptions<true>): NativePackagingResult<true>;
+export declare function createNativePackaging(options: NativePackagingOptions<boolean>): NativePackagingResult<boolean>;
 export {};
 //# sourceMappingURL=native-packaging.d.ts.map

package/dist/files/native-packaging.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"native-packaging.d.ts","sourceRoot":"","sources":["../../src/files/native-packaging.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAcxB,QAAA,MAAM,aAAa;;;;;;;;;iBAiBhB,CAAC;AACJ,QAAA,MAAM,WAAW;;;;iBAIf,CAAC;AACH,QAAA,MAAM,aAAa;;;;;;;;;;;iBAKjB,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACnE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAE/D,yFAAyF;AACzF,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,CAAC,KAAK,EAAE;QACb,MAAM,EAAE;YACN,SAAS,CAAC,EAAE,OAAO,CAAC;YACpB,MAAM,CAAC,EAAE,MAAM,GAAG;gBAAE,KAAK,CAAC,EAAE,MAAM,CAAA;aAAE,CAAC;YACrC,WAAW,EAAE,MAAM,EAAE,CAAC;SACvB,CAAC;QACF,MAAM,EAAE,CACN,OAAO,EAAE;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,EAC3B,QAAQ,EAAE,CAAC,IAAI,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,KAAK;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,IAAI,CAAA;SAAE,GAAG,SAAS,KACjF,OAAO,CAAC;QACb,SAAS,EAAE,CACT,OAAO,EAAE;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,EAC3B,QAAQ,EAAE,CAAC,IAAI,EAAE;YACf,IAAI,EAAE,MAAM,CAAC;YACb,QAAQ,EAAE,MAAM,CAAC;SAClB,KAAK;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,OAAO,CAAA;SAAE,GAAG,SAAS,KAClD,OAAO,CAAC;KACd,KAAK,IAAI,CAAC;CACZ,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAC7B,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,GAC7B;IACE,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;IACnB,YAAY,EAAE,OAAO,GAAG,KAAK,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,MAAM,EAAE,qBAAqB,CAAC;CAC/B,CAAC;AAaN,4FAA4F;AAC5F,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,qBAAqB,CAoF5F"}
+{"version":3,"file":"native-packaging.d.ts","sourceRoot":"","sources":["../../src/files/native-packaging.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAcxB,QAAA,MAAM,kBAAkB;;;EAA2B,CAAC;AAQpD,QAAA,MAAM,mBAAmB;;;;;;;;;iBAKvB,CAAC;AACH,QAAA,MAAM,qBAAqB;;;;;;iBAKzB,CAAC;AAiCH,QAAA,MAAM,WAAW;;;;iBAIf,CAAC;AACH,QAAA,MAAM,iBAAiB;;;;;;;;iBAA2D,CAAC;AACnF,QAAA,MAAM,aAAa;;;;;;;;;;;iBAKjB,CAAC;AAEH,MAAM,MAAM,sBAAsB,CAAC,QAAQ,SAAS,OAAO,GAAG,KAAK,IAAI,QAAQ,SAAS,IAAI,GACxF,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,GACrC,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACxC,MAAM,MAAM,oBAAoB,CAAC,QAAQ,SAAS,OAAO,GAAG,KAAK,IAAI,QAAQ,SAAS,IAAI,GACtF,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,GACjC,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEhC,yFAAyF;AACzF,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,CAAC,KAAK,EAAE;QACb,MAAM,EAAE;YACN,SAAS,CAAC,EAAE,OAAO,CAAC;YACpB,MAAM,CAAC,EAAE,MAAM,GAAG;gBAAE,KAAK,CAAC,EAAE,MAAM,CAAA;aAAE,CAAC;YACrC,WAAW,EAAE,MAAM,EAAE,CAAC;SACvB,CAAC;QACF,MAAM,EAAE,CACN,OAAO,EAAE;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,EAC3B,QAAQ,EAAE,CAAC,IAAI,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,KAAK;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,IAAI,CAAA;SAAE,GAAG,SAAS,KACjF,OAAO,CAAC;QACb,SAAS,EAAE,CACT,OAAO,EAAE;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,EAC3B,QAAQ,EAAE,CAAC,IAAI,EAAE;YACf,IAAI,EAAE,MAAM,CAAC;YACb,QAAQ,EAAE,MAAM,CAAC;SAClB,KAAK;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,OAAO,CAAA;SAAE,GAAG,SAAS,KAClD,OAAO,CAAC;KACd,KAAK,IAAI,CAAC;CACZ,CAAC;AAEF,MAAM,MAAM,qBAAqB,CAAC,QAAQ,SAAS,OAAO,GAAG,KAAK,IAC9D,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,GAC7B;IACE,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;IACnB,YAAY,EAAE,QAAQ,SAAS,IAAI,GAC/B,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,EAAE,GACpC,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;IACvC,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,oBAAoB,CAAC,QAAQ,CAAC,EAAE,CAAC;IACzC,MAAM,EAAE,qBAAqB,CAAC;CAC/B,CAAC;AAaN,4FAA4F;AAC5F,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,qBAAqB,CAAC;AAC9F,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,sBAAsB,CAAC,IAAI,CAAC,GACpC,qBAAqB,CAAC,IAAI,CAAC,CAAC;AAC/B,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,sBAAsB,CAAC,OAAO,CAAC,GACvC,qBAAqB,CAAC,OAAO,CAAC,CAAC"}

package/llms/files-packaging.txt

@@ -20,7 +20,14 @@ It resolves the installed package's target/version and original addon SHA256.
 `platform`, `architecture`, `delivery`, `entryPath` and `assetPath` are explicit public inputs.
 The result is `ready` with assets and a structural Bun plugin, or `unsupported`/`missing` with a safe code.
 Malformed options/metadata and other filesystem errors fail rather than masquerade as missing.
-Companion mode places an external addon relative to the emitted entry; embedded mode lets
+Companion accepts a single `architecture` string with an `assetPath` string, or an architecture
+array with an exact per-architecture `assetPath` map. `NativePackagingOptions<true>` and
+`NativePackagingResult<true>` describe the array form; default types preserve single-target signatures.
+A ready array-form result carries the architecture array; `NativePackagingAsset<true>` identifies
+each asset architecture. Default asset types and single-target runtime objects retain their three fields.
+Targets must be unique; entry and all asset paths must be disjoint. One lazy loader chooses only
+the actual runtime architecture, with no fallback.
+Companion mode places external addons relative to the emitted entry; embedded mode lets
 Bun compile retain the matching addon. Keep JS builds without splitting, preserve every output,
 and copy each original asset to its `outputPath` after verifying `sha256`.
 This evolving entrypoint is a build dependency; runtime imports do not reach it.

package/llms/process.txt

@@ -341,6 +341,27 @@ Archive the complete output directory with an integrity manifest, unpack to a cl
 verify the same hashes there, and run offline without the build tree or `node_modules`.
 A digest provides integrity, not authenticity: signature and trust policy remain application-owned.
 
+From 0.104.2, one JS artifact can run on both Darwin architectures; change only the packaging inputs:
+
+```ts
+const native = createNativePackaging({
+  platform: 'darwin', architecture: ['arm64', 'x64'], delivery: 'companion',
+  entryPath: 'app/native.js',
+  assetPath: { arm64: 'addons/arm.node', x64: 'addons/intel.node' },
+})
+```
+
+Use the same single plugin and copy loop above. A single-target loader deliberately refuses the
+other architecture; two competing plugins cannot produce a universal loader. The array form
+requires exactly one distinct output path per declared target. A ready result carries the target
+array and both original asset hashes; `NativePackagingOptions<true>` /
+`NativePackagingResult<true>` describe this form when explicitly annotating variables.
+The loader selects only `process.arch`: a missing or wrong-architecture selected addon refuses,
+even when the other valid addon is present. Linux runtime imports remain lazy and use Linux
+process primitives without loading Darwin assets. Qualify the exact same JS bytes on real
+Darwin arm64 and x64 machines, with both companions preserved through archive delivery.
+Build-machine architecture and cross-build success cannot establish universal native support.
+
 For a standalone executable use `delivery: 'embedded'` and the same plugin in `Bun.build`
 with `compile: { outfile: ... }`. Bun embeds the selected addon; `assets` identifies its
 original bytes for qualification, not a companion that must be installed beside the executable.

package/llms-full.txt

@@ -8457,6 +8457,27 @@ Archive the complete output directory with an integrity manifest, unpack to a cl
 verify the same hashes there, and run offline without the build tree or `node_modules`.
 A digest provides integrity, not authenticity: signature and trust policy remain application-owned.
 
+From 0.104.2, one JS artifact can run on both Darwin architectures; change only the packaging inputs:
+
+```ts
+const native = createNativePackaging({
+  platform: 'darwin', architecture: ['arm64', 'x64'], delivery: 'companion',
+  entryPath: 'app/native.js',
+  assetPath: { arm64: 'addons/arm.node', x64: 'addons/intel.node' },
+})
+```
+
+Use the same single plugin and copy loop above. A single-target loader deliberately refuses the
+other architecture; two competing plugins cannot produce a universal loader. The array form
+requires exactly one distinct output path per declared target. A ready result carries the target
+array and both original asset hashes; `NativePackagingOptions<true>` /
+`NativePackagingResult<true>` describe this form when explicitly annotating variables.
+The loader selects only `process.arch`: a missing or wrong-architecture selected addon refuses,
+even when the other valid addon is present. Linux runtime imports remain lazy and use Linux
+process primitives without loading Darwin assets. Qualify the exact same JS bytes on real
+Darwin arm64 and x64 machines, with both companions preserved through archive delivery.
+Build-machine architecture and cross-build success cannot establish universal native support.
+
 For a standalone executable use `delivery: 'embedded'` and the same plugin in `Bun.build`
 with `compile: { outfile: ... }`. Bun embeds the selected addon; `assets` identifies its
 original bytes for qualification, not a companion that must be installed beside the executable.
@@ -21993,7 +22014,14 @@ It resolves the installed package's target/version and original addon SHA256.
 `platform`, `architecture`, `delivery`, `entryPath` and `assetPath` are explicit public inputs.
 The result is `ready` with assets and a structural Bun plugin, or `unsupported`/`missing` with a safe code.
 Malformed options/metadata and other filesystem errors fail rather than masquerade as missing.
-Companion mode places an external addon relative to the emitted entry; embedded mode lets
+Companion accepts a single `architecture` string with an `assetPath` string, or an architecture
+array with an exact per-architecture `assetPath` map. `NativePackagingOptions<true>` and
+`NativePackagingResult<true>` describe the array form; default types preserve single-target signatures.
+A ready array-form result carries the architecture array; `NativePackagingAsset<true>` identifies
+each asset architecture. Default asset types and single-target runtime objects retain their three fields.
+Targets must be unique; entry and all asset paths must be disjoint. One lazy loader chooses only
+the actual runtime architecture, with no fallback.
+Companion mode places external addons relative to the emitted entry; embedded mode lets
 Bun compile retain the matching addon. Keep JS builds without splitting, preserve every output,
 and copy each original asset to its `outputPath` after verifying `sha256`.
 This evolving entrypoint is a build dependency; runtime imports do not reach it.

package/llms.txt

@@ -56,8 +56,8 @@ Load the slice for each entrypoint your code imports — `import … from 'stitc
 - **stitchkit/agent-runtime/react**: [llms/agent-runtime-react.txt](llms/agent-runtime-react.txt) 1.0 KB
 - **stitchkit/agent-runtime/realtime**: [llms/agent-runtime-realtime.txt](llms/agent-runtime-realtime.txt) 1.8 KB
 - **stitchkit/agent-runtime/harness-tools**: [llms/agent-runtime-harness-tools.txt](llms/agent-runtime-harness-tools.txt) 1.3 KB
-- **stitchkit/process**: [llms/process.txt](llms/process.txt) 25.4 KB
-- **stitchkit/files/packaging**: [llms/files-packaging.txt](llms/files-packaging.txt) 1.5 KB
+- **stitchkit/process**: [llms/process.txt](llms/process.txt) 26.6 KB
+- **stitchkit/files/packaging**: [llms/files-packaging.txt](llms/files-packaging.txt) 2.1 KB
 
 ## Upgrading slices
 - **Upgrading — how to move across versions**: [llms/upgrading.txt](llms/upgrading.txt) 10.3 KB

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stitchkit",
-  "version": "0.104.1",
+  "version": "0.104.2",
   "description": "Contract-first backend framework — one defineContract() into an HTTP API, MCP tools, AI-agent tools and a typed client. Bun and Node.",
   "keywords": [
     "bun",