@forgeax/engine-pack 0.1.2

package/dist/material/artifact-writer.d.ts

@@ -0,0 +1,14 @@
+export interface MaterialArtifactWriteInput {
+    readonly key: string;
+    readonly bytes: Uint8Array;
+    readonly mediaType?: string;
+}
+export interface MaterialArtifactWriteResult {
+    readonly key: string;
+    readonly bytes: Uint8Array;
+    readonly mediaType: string;
+    readonly digest: string;
+}
+/** Pack owns the immutable cooked material artifact tuple. */
+export declare function writeMaterialArtifact(input: MaterialArtifactWriteInput): MaterialArtifactWriteResult;
+//# sourceMappingURL=artifact-writer.d.ts.map

package/dist/material/artifact-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-writer.d.ts","sourceRoot":"","sources":["../../src/material/artifact-writer.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,8DAA8D;AAC9D,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,0BAA0B,GAChC,2BAA2B,CAO7B"}

package/dist/mesh-bin-contract.d.ts

@@ -0,0 +1,36 @@
+/** Canonical mesh binary wire facts shared by build-time and runtime owners. */
+export declare const MESH_BIN_VERSION: 4;
+export declare const MESH_BIN_PROJECTION_VERSION: 1;
+export declare const MESH_BIN_HEADER_V4_BYTES = 80;
+export declare const MESH_BIN_DIGEST_BYTES = 32;
+export interface MeshBinHeaderV4 {
+    readonly version: 4;
+    readonly projectionVersion: 1;
+    readonly mask: number;
+    readonly digest: string;
+    readonly stride: number;
+    readonly vertexCount: number;
+    readonly vertexBytes: number;
+    readonly indexCount: number;
+    readonly indexWidth: 0 | 2 | 4;
+    readonly indexBytes: number;
+    readonly jsonBytes: number;
+}
+export interface MeshBinContractError {
+    readonly code: 'mesh-bin-header-truncated' | 'mesh-bin-version-unsupported' | 'mesh-bin-header-invalid';
+    readonly subject: 'mesh-bin';
+    readonly sourceKey: string;
+    readonly expected: string;
+    readonly actual: string;
+    readonly recovery: string;
+}
+export type MeshBinHeaderResult = {
+    readonly ok: true;
+    readonly value: MeshBinHeaderV4;
+} | {
+    readonly ok: false;
+    readonly error: MeshBinContractError;
+};
+export declare function writeMeshBinHeader(header: MeshBinHeaderV4, out: Uint8Array): void;
+export declare function decodeMeshBinHeader(bytes: Uint8Array, sourceKey?: string): MeshBinHeaderResult;
+//# sourceMappingURL=mesh-bin-contract.d.ts.map

package/dist/mesh-bin-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mesh-bin-contract.d.ts","sourceRoot":"","sources":["../src/mesh-bin-contract.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAEhF,eAAO,MAAM,gBAAgB,EAAG,CAAU,CAAC;AAC3C,eAAO,MAAM,2BAA2B,EAAG,CAAU,CAAC;AACtD,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAC3C,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EACT,2BAA2B,GAC3B,8BAA8B,GAC9B,yBAAyB,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,mBAAmB,GAC3B;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAA;CAAE,GACtD;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAA;CAAE,CAAC;AA+BjE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI,CAgBjF;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,UAAU,EACjB,SAAS,SAA0B,GAClC,mBAAmB,CA8DrB"}

package/dist/name.mjs

@@ -0,0 +1,22 @@
+// src/deriveAssetName.ts
+function baseName(p) {
+  const trimmed = p.replace(/[/\\]+$/, "");
+  const idx = Math.max(trimmed.lastIndexOf("/"), trimmed.lastIndexOf("\\"));
+  return idx === -1 ? trimmed : trimmed.slice(idx + 1);
+}
+function deriveAssetName(packagePath, assetCount, storedName) {
+  if (packagePath === null) {
+    return storedName ?? "";
+  }
+  if (assetCount === 1) {
+    return baseName(packagePath);
+  }
+  if (storedName !== void 0) {
+    return storedName;
+  }
+  return baseName(packagePath);
+}
+
+export { deriveAssetName };
+//# sourceMappingURL=name.mjs.map
+//# sourceMappingURL=name.mjs.map

package/dist/name.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/deriveAssetName.ts"],"names":[],"mappings":";AAOA,SAAS,SAAS,CAAA,EAAmB;AACnC,EAAA,MAAM,OAAA,GAAU,CAAA,CAAE,OAAA,CAAQ,SAAA,EAAW,EAAE,CAAA;AACvC,EAAA,MAAM,GAAA,GAAM,IAAA,CAAK,GAAA,CAAI,OAAA,CAAQ,WAAA,CAAY,GAAG,CAAA,EAAG,OAAA,CAAQ,WAAA,CAAY,IAAI,CAAC,CAAA;AACxE,EAAA,OAAO,QAAQ,EAAA,GAAK,OAAA,GAAU,OAAA,CAAQ,KAAA,CAAM,MAAM,CAAC,CAAA;AACrD;AAeO,SAAS,eAAA,CACd,WAAA,EACA,UAAA,EACA,UAAA,EACQ;AACR,EAAA,IAAI,gBAAgB,IAAA,EAAM;AACxB,IAAA,OAAO,UAAA,IAAc,EAAA;AAAA,EACvB;AACA,EAAA,IAAI,eAAe,CAAA,EAAG;AACpB,IAAA,OAAO,SAAS,WAAW,CAAA;AAAA,EAC7B;AACA,EAAA,IAAI,eAAe,MAAA,EAAW;AAC5B,IAAA,OAAO,UAAA;AAAA,EACT;AACA,EAAA,OAAO,SAAS,WAAW,CAAA;AAC7B","file":"name.mjs","sourcesContent":["/**\n * Last path segment of a `/`- or `\\`-separated path, trailing separators\n * stripped. Inlined rather than imported from `node:path` so this module stays\n * browser-safe: the dev-server pack path (`vite-plugin-pack` `/__pack/`) runs\n * `buildCatalog` -> `deriveAssetName` in client code where `node:path` is\n * externalized and `path.basename` throws.\n */\nfunction baseName(p: string): string {\n  const trimmed = p.replace(/[/\\\\]+$/, '');\n  const idx = Math.max(trimmed.lastIndexOf('/'), trimmed.lastIndexOf('\\\\'));\n  return idx === -1 ? trimmed : trimmed.slice(idx + 1);\n}\n\n/**\n * Derive an asset's display name from package metadata.\n *\n * Pure function -- zero IO, zero side effects, browser-safe. Build-time\n * (build-catalog) and runtime (resolveName) share this single source of truth\n * for the XOR name-resolution rules (plan-strategy D-6).\n *\n * Branches:\n *   1. single-asset package (assetCount === 1)      -> baseName(packagePath)\n *   2. multi-asset package + storedName              -> storedName\n *   3. multi-asset package + no storedName (AC-15.1) -> baseName(packagePath)\n *   4. null packagePath + no storedName  (AC-15.2)   -> ''\n */\nexport function deriveAssetName(\n  packagePath: string | null,\n  assetCount: number,\n  storedName?: string,\n): string {\n  if (packagePath === null) {\n    return storedName ?? '';\n  }\n  if (assetCount === 1) {\n    return baseName(packagePath);\n  }\n  if (storedName !== undefined) {\n    return storedName;\n  }\n  return baseName(packagePath);\n}\n"]}

package/dist/native-cooker-registry.d.ts

@@ -0,0 +1,28 @@
+import type { AssetCodec, AssetStageError, CookProduct, Result } from '@forgeax/engine-types';
+export interface NativeCookArtifact {
+    readonly mediaType: string;
+    readonly assetCodec?: AssetCodec;
+    readonly bytes: Uint8Array;
+}
+export interface NativeCookDraft<P = unknown> {
+    readonly guid: string;
+    readonly payload: P;
+    readonly refs: readonly string[];
+    readonly artifacts: Readonly<Record<string, NativeCookArtifact>>;
+    readonly inputFingerprint: string;
+}
+export interface NativeCooker<P = unknown, I = unknown> {
+    readonly key: string;
+    readonly discover?: (input: unknown) => I | Promise<I>;
+    cook(input: I): NativeCookDraft<P> | Promise<NativeCookDraft<P>>;
+}
+/** Injectable build-time table for native authored Pack producers. */
+export declare class NativeCookerRegistry {
+    private readonly cookers;
+    register(cooker: NativeCooker): void;
+    get(key: string): NativeCooker | undefined;
+    registeredCookers(): readonly string[];
+    runDraft<P = unknown, I = unknown>(key: string, input: I): Promise<Result<NativeCookDraft<P>, AssetStageError>>;
+    run<P = unknown, I = unknown>(key: string, input: I): Promise<Result<CookProduct<P>, AssetStageError>>;
+}
+//# sourceMappingURL=native-cooker-registry.d.ts.map

package/dist/native-cooker-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-cooker-registry.d.ts","sourceRoot":"","sources":["../src/native-cooker-registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,UAAU,EACV,eAAe,EACf,WAAW,EACX,MAAM,EACP,MAAM,uBAAuB,CAAC;AAG/B,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC;IACjE,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO;IACpD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACvD,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;CAClE;AAyCD,sEAAsE;AACtE,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAE3D,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAUpC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAI1C,iBAAiB,IAAI,SAAS,MAAM,EAAE;IAIhC,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EACrC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,GACP,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;IAkCjD,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EAChC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,GACP,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;CA+BpD"}

package/dist/native-cooker.d.ts

@@ -0,0 +1,3 @@
+/** Node/build-time native cooker registry. The browser-safe pack root excludes this seam. */
+export * from './native-cooker-registry.js';
+//# sourceMappingURL=native-cooker.d.ts.map

package/dist/native-cooker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-cooker.d.ts","sourceRoot":"","sources":["../src/native-cooker.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,cAAc,6BAA6B,CAAC"}

package/dist/native-cooker.mjs

@@ -0,0 +1,105 @@
+import { createHash } from 'crypto';
+import { ok, err } from '@forgeax/engine-types';
+
+// src/native-cooker-registry.ts
+function canonicalize(value) {
+  if (value instanceof Uint8Array) return Buffer.from(value).toString("base64");
+  if (Array.isArray(value)) return value.map(canonicalize);
+  if (typeof value !== "object" || value === null) return value;
+  return Object.fromEntries(
+    Object.entries(value).sort(([left], [right]) => left.localeCompare(right)).map(([key, nested]) => [key, canonicalize(nested)])
+  );
+}
+function digestDraft(draft) {
+  const bytes = JSON.stringify(
+    canonicalize({
+      guid: draft.guid,
+      payload: draft.payload,
+      refs: draft.refs,
+      artifacts: draft.artifacts
+    })
+  );
+  return `sha256:${createHash("sha256").update(bytes).digest("hex")}`;
+}
+function failure(key, detail) {
+  return err({
+    stage: "native-cook",
+    code: "native-cook-failed",
+    expected: "a registered native cooker to produce a complete draft",
+    hint: "register the cooker or repair its draft, then rerun recovery",
+    detail,
+    recovery: { action: `rerun native cooker ${key}`, retryable: true }
+  });
+}
+var NativeCookerRegistry = class {
+  cookers = /* @__PURE__ */ new Map();
+  register(cooker) {
+    if (typeof cooker.key !== "string" || cooker.key.length === 0) {
+      throw new TypeError("NativeCookerRegistry.register: key must be a non-empty string");
+    }
+    if (typeof cooker.cook !== "function") {
+      throw new TypeError(`NativeCookerRegistry.register: cooker ${cooker.key} must expose cook`);
+    }
+    this.cookers.set(cooker.key, cooker);
+  }
+  get(key) {
+    return this.cookers.get(key);
+  }
+  registeredCookers() {
+    return [...this.cookers.keys()];
+  }
+  async runDraft(key, input) {
+    const cooker = this.cookers.get(key);
+    if (cooker === void 0) {
+      return failure(key, { guid: "unknown", producer: key });
+    }
+    let draft;
+    try {
+      const typedInput = cooker.discover === void 0 ? input : await cooker.discover(input);
+      draft = await cooker.cook(typedInput);
+    } catch (error) {
+      return failure(key, { guid: "unknown", producer: String(error) });
+    }
+    if (draft.guid.length === 0 || draft.inputFingerprint.length === 0 || !Array.isArray(draft.refs) || typeof draft.payload !== "object" || draft.payload === null || typeof draft.artifacts !== "object" || draft.artifacts === null || Object.entries(draft.artifacts).some(
+      ([, artifact]) => artifact === null || typeof artifact !== "object" || typeof artifact.mediaType !== "string" || artifact.mediaType.length === 0 || !(artifact.bytes instanceof Uint8Array)
+    )) {
+      return failure(key, { guid: draft.guid || "unknown", producer: key });
+    }
+    return ok(draft);
+  }
+  async run(key, input) {
+    const draftResult = await this.runDraft(key, input);
+    if (!draftResult.ok) return draftResult;
+    const draft = draftResult.value;
+    const digest = digestDraft(draft);
+    const artifacts = {};
+    for (const [path, artifact] of Object.entries(draft.artifacts)) {
+      artifacts[path] = {
+        path,
+        mediaType: artifact.mediaType,
+        ...artifact.assetCodec === void 0 ? {} : { assetCodec: artifact.assetCodec },
+        byteLength: artifact.bytes.byteLength
+      };
+    }
+    const receipt = {
+      guid: draft.guid,
+      origin: "authoredPack",
+      status: "succeeded",
+      inputFingerprint: draft.inputFingerprint,
+      outputDigest: digest
+    };
+    const product = {
+      guid: draft.guid,
+      payload: draft.payload,
+      refs: draft.refs,
+      artifacts,
+      digest,
+      receipt
+    };
+    return ok(product);
+  }
+};
+
+export { NativeCookerRegistry };
+//# sourceMappingURL=native-cooker.mjs.map
+//# sourceMappingURL=native-cooker.mjs.map

package/dist/native-cooker.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/native-cooker-registry.ts"],"names":[],"mappings":"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","file":"native-cooker.mjs","sourcesContent":["import { createHash } from 'node:crypto';\nimport type {\n  ArtifactDescriptor,\n  AssetCodec,\n  AssetStageError,\n  CookProduct,\n  Result,\n} from '@forgeax/engine-types';\nimport { err, ok } from '@forgeax/engine-types';\n\nexport interface NativeCookArtifact {\n  readonly mediaType: string;\n  readonly assetCodec?: AssetCodec;\n  readonly bytes: Uint8Array;\n}\n\nexport interface NativeCookDraft<P = unknown> {\n  readonly guid: string;\n  readonly payload: P;\n  readonly refs: readonly string[];\n  readonly artifacts: Readonly<Record<string, NativeCookArtifact>>;\n  readonly inputFingerprint: string;\n}\n\nexport interface NativeCooker<P = unknown, I = unknown> {\n  readonly key: string;\n  readonly discover?: (input: unknown) => I | Promise<I>;\n  cook(input: I): NativeCookDraft<P> | Promise<NativeCookDraft<P>>;\n}\n\nfunction canonicalize(value: unknown): unknown {\n  if (value instanceof Uint8Array) return Buffer.from(value).toString('base64');\n  if (Array.isArray(value)) return value.map(canonicalize);\n  if (typeof value !== 'object' || value === null) return value;\n  return Object.fromEntries(\n    Object.entries(value)\n      .sort(([left], [right]) => left.localeCompare(right))\n      .map(([key, nested]) => [key, canonicalize(nested)]),\n  );\n}\n\nfunction digestDraft<P>(draft: NativeCookDraft<P>): string {\n  const bytes = JSON.stringify(\n    canonicalize({\n      guid: draft.guid,\n      payload: draft.payload,\n      refs: draft.refs,\n      artifacts: draft.artifacts,\n    }),\n  );\n  return `sha256:${createHash('sha256').update(bytes).digest('hex')}`;\n}\n\ntype NativeCookErrorDetail = Extract<\n  AssetStageError['detail'],\n  { readonly guid: string; readonly producer: string }\n>;\n\nfunction failure(key: string, detail: NativeCookErrorDetail): Result<never, AssetStageError> {\n  return err({\n    stage: 'native-cook',\n    code: 'native-cook-failed',\n    expected: 'a registered native cooker to produce a complete draft',\n    hint: 'register the cooker or repair its draft, then rerun recovery',\n    detail,\n    recovery: { action: `rerun native cooker ${key}`, retryable: true },\n  });\n}\n\n/** Injectable build-time table for native authored Pack producers. */\nexport class NativeCookerRegistry {\n  private readonly cookers = new Map<string, NativeCooker>();\n\n  register(cooker: NativeCooker): void {\n    if (typeof cooker.key !== 'string' || cooker.key.length === 0) {\n      throw new TypeError('NativeCookerRegistry.register: key must be a non-empty string');\n    }\n    if (typeof cooker.cook !== 'function') {\n      throw new TypeError(`NativeCookerRegistry.register: cooker ${cooker.key} must expose cook`);\n    }\n    this.cookers.set(cooker.key, cooker);\n  }\n\n  get(key: string): NativeCooker | undefined {\n    return this.cookers.get(key);\n  }\n\n  registeredCookers(): readonly string[] {\n    return [...this.cookers.keys()];\n  }\n\n  async runDraft<P = unknown, I = unknown>(\n    key: string,\n    input: I,\n  ): Promise<Result<NativeCookDraft<P>, AssetStageError>> {\n    const cooker = this.cookers.get(key) as NativeCooker<P, I> | undefined;\n    if (cooker === undefined) {\n      return failure(key, { guid: 'unknown', producer: key });\n    }\n    let draft: NativeCookDraft<P>;\n    try {\n      const typedInput = cooker.discover === undefined ? input : await cooker.discover(input);\n      draft = await cooker.cook(typedInput);\n    } catch (error) {\n      return failure(key, { guid: 'unknown', producer: String(error) });\n    }\n    if (\n      draft.guid.length === 0 ||\n      draft.inputFingerprint.length === 0 ||\n      !Array.isArray(draft.refs) ||\n      typeof draft.payload !== 'object' ||\n      draft.payload === null ||\n      typeof draft.artifacts !== 'object' ||\n      draft.artifacts === null ||\n      Object.entries(draft.artifacts).some(\n        ([, artifact]) =>\n          artifact === null ||\n          typeof artifact !== 'object' ||\n          typeof artifact.mediaType !== 'string' ||\n          artifact.mediaType.length === 0 ||\n          !(artifact.bytes instanceof Uint8Array),\n      )\n    ) {\n      return failure(key, { guid: draft.guid || 'unknown', producer: key });\n    }\n    return ok(draft);\n  }\n\n  async run<P = unknown, I = unknown>(\n    key: string,\n    input: I,\n  ): Promise<Result<CookProduct<P>, AssetStageError>> {\n    const draftResult = await this.runDraft<P, I>(key, input);\n    if (!draftResult.ok) return draftResult;\n    const draft = draftResult.value;\n    const digest = digestDraft(draft);\n    const artifacts: Record<string, ArtifactDescriptor> = {};\n    for (const [path, artifact] of Object.entries(draft.artifacts)) {\n      artifacts[path] = {\n        path,\n        mediaType: artifact.mediaType,\n        ...(artifact.assetCodec === undefined ? {} : { assetCodec: artifact.assetCodec }),\n        byteLength: artifact.bytes.byteLength,\n      };\n    }\n    const receipt = {\n      guid: draft.guid,\n      origin: 'authoredPack' as const,\n      status: 'succeeded' as const,\n      inputFingerprint: draft.inputFingerprint,\n      outputDigest: digest,\n    };\n    const product: CookProduct<P> = {\n      guid: draft.guid,\n      payload: draft.payload,\n      refs: draft.refs,\n      artifacts,\n      digest,\n      receipt,\n    };\n    return ok(product);\n  }\n}\n"]}

package/dist/producer-contract.d.ts

@@ -0,0 +1,19 @@
+import type { ImportedOutputDeclaration, ProducerContractResult } from '@forgeax/engine-types';
+type ProducerObject = Record<string, unknown>;
+/**
+ * Validate one package or imported-output producer declaration.
+ *
+ * The accepted fields mirror the engine-types POD contract. This function
+ * validates that schema without creating a second schema or interpreting
+ * diagnostic messages.
+ */
+export declare function validateProducerContract(value: unknown): ProducerContractResult<ProducerObject>;
+/**
+ * Validate output topology without ever treating `sourceIndex` as identity.
+ *
+ * AI-readable callers should use the discriminated result and its structured
+ * `code`, `expected`, `actual`, and `hint` fields for recovery decisions.
+ */
+export declare function validateProducerOutputs(outputs: readonly ImportedOutputDeclaration[]): ProducerContractResult<readonly ImportedOutputDeclaration[]>;
+export {};
+//# sourceMappingURL=producer-contract.d.ts.map

package/dist/producer-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"producer-contract.d.ts","sourceRoot":"","sources":["../src/producer-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,yBAAyB,EAEzB,sBAAsB,EAEvB,MAAM,uBAAuB,CAAC;AAG/B,KAAK,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AA4I9C;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,CAAC,cAAc,CAAC,CAiF/F;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,SAAS,yBAAyB,EAAE,GAC5C,sBAAsB,CAAC,SAAS,yBAAyB,EAAE,CAAC,CA6B9D"}

package/dist/resolve-asset-source.d.ts

@@ -0,0 +1,4 @@
+import type { Result } from '@forgeax/engine-types';
+import { PackError } from './errors.js';
+export declare function resolveAssetSource(metaPath: string, source: string | undefined, paths: Record<string, string>): Result<string, PackError>;
+//# sourceMappingURL=resolve-asset-source.d.ts.map

package/dist/resolve-asset-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-asset-source.d.ts","sourceRoot":"","sources":["../src/resolve-asset-source.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAmBxC,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5B,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAkE3B"}

package/dist/resolve-asset-source.mjs

@@ -0,0 +1,99 @@
+import { dirname, resolve, posix } from 'path';
+import { ok, err, PACK_ERROR_HINTS } from '@forgeax/engine-types';
+
+// src/resolve-asset-source.ts
+
+// src/errors.ts
+var PackError = class extends Error {
+  code;
+  expected;
+  hint;
+  detail;
+  constructor(args) {
+    super(`[PackError ${args.code}] expected: ${args.expected}; hint: ${args.hint}`);
+    this.name = "PackError";
+    this.code = args.code;
+    this.expected = args.expected;
+    this.hint = args.hint;
+    this.detail = args.detail;
+  }
+};
+
+// src/resolve-asset-source.ts
+function baseName(p) {
+  const trimmed = p.replace(/[/\\]+$/, "");
+  const idx = Math.max(trimmed.lastIndexOf("/"), trimmed.lastIndexOf("\\"));
+  return idx === -1 ? trimmed : trimmed.slice(idx + 1);
+}
+function deriveSourceName(metaFileName) {
+  return metaFileName.replace(/\.meta\.json$/, "");
+}
+var PATH_REF_RE = /^@([^/]+)\/(.+)$/;
+function isPathEscape(pathDir, resolved) {
+  const rel = posix.relative(pathDir, resolved);
+  return rel.startsWith("..") || posix.isAbsolute(rel);
+}
+function resolveAssetSource(metaPath, source, paths) {
+  if (source === void 0) {
+    const metaDir = dirname(metaPath);
+    const metaName = baseName(metaPath);
+    const derived = deriveSourceName(metaName);
+    return ok(resolve(metaDir, derived));
+  }
+  if (source.startsWith("@")) {
+    const match = source.match(PATH_REF_RE);
+    if (!match) {
+      return err(
+        new PackError({
+          code: "pack-malformed-path-ref",
+          expected: "source in format @<name>/<rest>",
+          hint: PACK_ERROR_HINTS["pack-malformed-path-ref"],
+          detail: {
+            code: "pack-malformed-path-ref",
+            reason: "format",
+            rawSource: source,
+            expectedFormat: "@<name>/<rest>"
+          }
+        })
+      );
+    }
+    const [, name, rest] = match;
+    const pathDir = paths[name];
+    if (pathDir === void 0) {
+      return err(
+        new PackError({
+          code: "pack-unknown-path",
+          expected: "path name found in package.json#forgeax.assets.paths",
+          hint: PACK_ERROR_HINTS["pack-unknown-path"],
+          detail: {
+            code: "pack-unknown-path",
+            pathName: name,
+            knownNames: Object.keys(paths)
+          }
+        })
+      );
+    }
+    const resolved = resolve(pathDir, rest);
+    if (isPathEscape(pathDir, resolved)) {
+      return err(
+        new PackError({
+          code: "pack-malformed-path-ref",
+          expected: "rest path must not escape the declared path directory",
+          hint: PACK_ERROR_HINTS["pack-malformed-path-ref"],
+          detail: {
+            code: "pack-malformed-path-ref",
+            reason: "escape",
+            rawSource: source,
+            expectedFormat: "@<name>/<rest>"
+          }
+        })
+      );
+    }
+    return ok(resolved);
+  }
+  return ok(resolve(dirname(metaPath), source));
+}
+
+export { resolveAssetSource };
+//# sourceMappingURL=resolve-asset-source.mjs.map
+//# sourceMappingURL=resolve-asset-source.mjs.map

package/dist/resolve-asset-source.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/resolve-asset-source.ts"],"names":["resultOk","resultErr"],"mappings":"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","file":"resolve-asset-source.mjs","sourcesContent":["// errors.ts — PackError class (feat-20260513-guid-asset-package-system w15)\n//\n// Four-field surface: .code / .expected / .hint / .detail\n// Structurally parallel to AssetError / RhiError / RemoteError\n// (charter proposition 5 consistent abstraction).\n//\n// .detail is narrowed per .code via PackErrorDetail discriminated union\n// (requirements §6.2 AC-07; plan-strategy §D-5).\n\nimport type { PackErrorCode, PackErrorDetail } from '@forgeax/engine-types';\n\n/**\n * Structured error for the engine-pack disk scanner fail-fast chain.\n *\n * AI users consume via exhaustive switch on .code — no default case needed:\n * ```ts\n * switch (err.code) {\n *   case 'pack-guid-collision':\n *     console.error(err.detail.paths);\n *     break;\n *   case 'pack-cyclic-reference':\n *     console.error(err.detail.cycle);\n *     break;\n *   // ...all 8 cases\n * }\n * ```\n */\nexport class PackError extends Error {\n  readonly code: PackErrorCode;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: PackErrorDetail;\n\n  constructor(args: {\n    code: PackErrorCode;\n    expected: string;\n    hint: string;\n    detail: PackErrorDetail;\n  }) {\n    super(`[PackError ${args.code}] expected: ${args.expected}; hint: ${args.hint}`);\n    this.name = 'PackError';\n    this.code = args.code;\n    this.expected = args.expected;\n    this.hint = args.hint;\n    this.detail = args.detail;\n  }\n}\n","import { dirname, posix, resolve } from 'node:path';\nimport type { Result } from '@forgeax/engine-types';\nimport { PACK_ERROR_HINTS, err as resultErr, ok as resultOk } from '@forgeax/engine-types';\nimport { PackError } from './errors.js';\n\nfunction baseName(p: string): string {\n  const trimmed = p.replace(/[/\\\\]+$/, '');\n  const idx = Math.max(trimmed.lastIndexOf('/'), trimmed.lastIndexOf('\\\\'));\n  return idx === -1 ? trimmed : trimmed.slice(idx + 1);\n}\n\nfunction deriveSourceName(metaFileName: string): string {\n  return metaFileName.replace(/\\.meta\\.json$/, '');\n}\n\nconst PATH_REF_RE = /^@([^/]+)\\/(.+)$/;\n\nfunction isPathEscape(pathDir: string, resolved: string): boolean {\n  const rel = posix.relative(pathDir, resolved);\n  return rel.startsWith('..') || posix.isAbsolute(rel);\n}\n\nexport function resolveAssetSource(\n  metaPath: string,\n  source: string | undefined,\n  paths: Record<string, string>,\n): Result<string, PackError> {\n  if (source === undefined) {\n    const metaDir = dirname(metaPath);\n    const metaName = baseName(metaPath);\n    const derived = deriveSourceName(metaName);\n    return resultOk(resolve(metaDir, derived));\n  }\n\n  if (source.startsWith('@')) {\n    const match = source.match(PATH_REF_RE);\n    if (!match) {\n      return resultErr(\n        new PackError({\n          code: 'pack-malformed-path-ref',\n          expected: 'source in format @<name>/<rest>',\n          hint: PACK_ERROR_HINTS['pack-malformed-path-ref'],\n          detail: {\n            code: 'pack-malformed-path-ref',\n            reason: 'format',\n            rawSource: source,\n            expectedFormat: '@<name>/<rest>',\n          },\n        }),\n      );\n    }\n\n    const [, name, rest] = match as [string, string, string];\n    const pathDir = paths[name];\n\n    if (pathDir === undefined) {\n      return resultErr(\n        new PackError({\n          code: 'pack-unknown-path',\n          expected: 'path name found in package.json#forgeax.assets.paths',\n          hint: PACK_ERROR_HINTS['pack-unknown-path'],\n          detail: {\n            code: 'pack-unknown-path',\n            pathName: name,\n            knownNames: Object.keys(paths),\n          },\n        }),\n      );\n    }\n\n    const resolved = resolve(pathDir, rest);\n\n    if (isPathEscape(pathDir, resolved)) {\n      return resultErr(\n        new PackError({\n          code: 'pack-malformed-path-ref',\n          expected: 'rest path must not escape the declared path directory',\n          hint: PACK_ERROR_HINTS['pack-malformed-path-ref'],\n          detail: {\n            code: 'pack-malformed-path-ref',\n            reason: 'escape',\n            rawSource: source,\n            expectedFormat: '@<name>/<rest>',\n          },\n        }),\n      );\n    }\n\n    return resultOk(resolved);\n  }\n\n  return resultOk(resolve(dirname(metaPath), source));\n}\n"]}

package/dist/runtime-projection.d.ts

@@ -0,0 +1,14 @@
+import type { AssetPublicationTuple, AssetRuntimeArtifactDescriptor, PackV2, PackV2Error, Result } from '@forgeax/engine-types';
+export interface RuntimeAssetProjectionInput<P = unknown> {
+    readonly guid: string;
+    readonly kind: string;
+    readonly payload: P;
+    readonly refs: readonly string[];
+    readonly artifacts: Readonly<Record<string, AssetRuntimeArtifactDescriptor>>;
+}
+export interface RuntimePackProjectionInput<P = unknown> extends AssetPublicationTuple {
+    readonly assets: readonly RuntimeAssetProjectionInput<P>[];
+}
+/** Project producer facts into the only runtime Pack v2 envelope. */
+export declare function projectRuntimePack<P = unknown>(value: unknown): Result<PackV2<P>, PackV2Error>;
+//# sourceMappingURL=runtime-projection.d.ts.map

package/dist/runtime-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-projection.d.ts","sourceRoot":"","sources":["../src/runtime-projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,qBAAqB,EACrB,8BAA8B,EAC9B,MAAM,EACN,WAAW,EACX,MAAM,EACP,MAAM,uBAAuB,CAAC;AAG/B,MAAM,WAAW,2BAA2B,CAAC,CAAC,GAAG,OAAO;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,8BAA8B,CAAC,CAAC,CAAC;CAC9E;AAED,MAAM,WAAW,0BAA0B,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,qBAAqB;IACpF,QAAQ,CAAC,MAAM,EAAE,SAAS,2BAA2B,CAAC,CAAC,CAAC,EAAE,CAAC;CAC5D;AA2CD,qEAAqE;AACrE,wBAAgB,kBAAkB,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAmC9F"}

package/dist/scanner.d.ts

@@ -0,0 +1,80 @@
+import { PackError } from './errors.js';
+import { type ScriptablePackMetaJson } from './scriptable-pack.js';
+import { type LoadScriptablePackOptions, type ScriptablePackSourceClosureEntry } from './scriptable-pack-node.js';
+export type ScanResult<T, E> = {
+    readonly ok: true;
+    readonly value: T;
+} | {
+    readonly ok: false;
+    readonly error: E;
+};
+/** Host-owned source paths that should not enter the Pack catalog. */
+export interface ScanOptions {
+    readonly ignorePath?: (path: string) => boolean;
+    /** Timeout/executor owner for ScriptablePack metadata loading. */
+    readonly scriptablePackLoad?: LoadScriptablePackOptions;
+}
+export type AssetInventoryProducerKind = 'direct-pack' | 'source-meta' | 'scriptable-pack';
+export interface AssetInventoryOutput {
+    readonly guid: string;
+    readonly sourceKey?: string;
+    readonly sourceIndex?: number;
+    readonly kind: string;
+    readonly name?: string;
+    readonly execution?: 'direct' | 'cooked';
+    readonly refs: readonly string[];
+}
+export interface AssetInventoryProjectedMeta {
+    readonly schemaVersion?: string;
+    readonly packageId?: string;
+    readonly importer?: string;
+    readonly source?: string;
+    readonly name?: string;
+    readonly outputs: readonly AssetInventoryOutput[];
+    readonly externalGuids: readonly string[];
+}
+export interface AssetInventoryDiagnostic {
+    readonly code: string;
+    readonly message: string;
+}
+export interface AssetInventoryDeclaration {
+    readonly sourcePath: string;
+    readonly canonicalSourcePath: string;
+    readonly producer: AssetInventoryProducerKind;
+    readonly packageId?: string;
+    readonly projectedMeta: AssetInventoryProjectedMeta;
+    readonly outputs: readonly AssetInventoryOutput[];
+    readonly externalGuids: readonly string[];
+    readonly sourceClosure?: readonly ScriptablePackSourceClosureEntry[];
+    readonly diagnostics: readonly AssetInventoryDiagnostic[];
+}
+export interface AssetInventory {
+    readonly paths: readonly string[];
+    readonly scriptablePackMeta: ReadonlyMap<string, ScriptablePackMetaJson>;
+    /** One declaration record per authored package/source, keyed by source path. */
+    readonly declarations: readonly AssetInventoryDeclaration[];
+    readonly declarationsByPath: ReadonlyMap<string, AssetInventoryDeclaration>;
+    /** Producer ownership map used by Catalog, watcher, and demand cook. */
+    readonly sourceByGuid: ReadonlyMap<string, string>;
+    readonly metaByGuid: ReadonlyMap<string, string>;
+}
+export declare const SCANNER_BLACKLIST: ReadonlySet<string>;
+/**
+ * Scan one or more root directories for `.meta.json`, `.pack.json`, and `.pack.ts` files.
+ * Runs a 7-step fail-fast validation chain (w17 + M7-T01):
+ *   Step 1 - collect all .meta.json + .pack.json + .pack.ts paths (blacklist skipped)
+ *   Step 2 - schema validation (ajv strict)
+ *   Step 3 - GUID string format validation
+ *   Step 4 - GUID collision detection
+ *   Step 5 - orphan .meta.json detection
+ *   Step 6 - cyclic reference detection (hand-written DFS)
+ *   Step 7 - complete pack and source closure validation
+ *
+ * Returns one reusable `AssetInventory` or `Err(PackError)` on the first violation.
+ *
+ * NOTE: source files without a .meta.json are logged but not fatal (requirements §5).
+ */
+export declare function scanInventory(roots: readonly string[], opts?: ScanOptions): Promise<ScanResult<AssetInventory, PackError>>;
+/** Compatibility projection for callers that only need discovered paths. */
+export declare function scan(roots: readonly string[], opts?: ScanOptions): Promise<ScanResult<string[], PackError>>;
+//# sourceMappingURL=scanner.d.ts.map

package/dist/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"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"}