@forgeax/engine-pack 0.1.2

package/dist/config.d.ts

@@ -0,0 +1,6 @@
+export interface LoadAssetConfigResult {
+    readonly roots: readonly string[];
+    readonly paths: Record<string, string>;
+}
+export declare function loadAssetConfig(cwd: string): LoadAssetConfigResult;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,qBAAqB,CA2BlE"}

package/dist/config.mjs

@@ -0,0 +1,29 @@
+import { readFileSync } from 'fs';
+import { join } from 'path';
+
+// src/config.ts
+function loadAssetConfig(cwd) {
+  let pkg;
+  try {
+    pkg = JSON.parse(readFileSync(join(cwd, "package.json"), "utf-8"));
+  } catch {
+    return { roots: [join(cwd, "assets")], paths: {} };
+  }
+  const assets = pkg.forgeax?.assets;
+  const rawRoots = assets?.roots;
+  const roots = Array.isArray(rawRoots) && rawRoots.length > 0 ? rawRoots.map((r) => join(cwd, r)) : [join(cwd, "assets")];
+  const rawPaths = assets?.paths;
+  const paths = {};
+  if (rawPaths !== void 0 && rawPaths !== null && typeof rawPaths === "object") {
+    for (const [name, dir] of Object.entries(rawPaths)) {
+      if (typeof dir === "string") {
+        paths[name] = join(cwd, dir);
+      }
+    }
+  }
+  return { roots, paths };
+}
+
+export { loadAssetConfig };
+//# sourceMappingURL=config.mjs.map
+//# sourceMappingURL=config.mjs.map

package/dist/config.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config.ts"],"names":[],"mappings":";;;;AAQO,SAAS,gBAAgB,GAAA,EAAoC;AAClE,EAAA,IAAI,GAAA;AACJ,EAAA,IAAI;AACF,IAAA,GAAA,GAAM,IAAA,CAAK,MAAM,YAAA,CAAa,IAAA,CAAK,KAAK,cAAc,CAAA,EAAG,OAAO,CAAC,CAAA;AAAA,EACnE,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,EAAE,KAAA,EAAO,CAAC,IAAA,CAAK,GAAA,EAAK,QAAQ,CAAC,CAAA,EAAG,KAAA,EAAO,EAAC,EAAE;AAAA,EACnD;AAEA,EAAA,MAAM,MAAA,GAAS,IAAI,OAAA,EAAS,MAAA;AAE5B,EAAA,MAAM,WAAW,MAAA,EAAQ,KAAA;AACzB,EAAA,MAAM,KAAA,GACJ,MAAM,OAAA,CAAQ,QAAQ,KAAK,QAAA,CAAS,MAAA,GAAS,IACxC,QAAA,CAAsB,GAAA,CAAI,CAAC,CAAA,KAAM,IAAA,CAAK,KAAK,CAAC,CAAC,IAC9C,CAAC,IAAA,CAAK,GAAA,EAAK,QAAQ,CAAC,CAAA;AAE1B,EAAA,MAAM,WAAW,MAAA,EAAQ,KAAA;AACzB,EAAA,MAAM,QAAgC,EAAC;AACvC,EAAA,IAAI,aAAa,MAAA,IAAa,QAAA,KAAa,IAAA,IAAQ,OAAO,aAAa,QAAA,EAAU;AAC/E,IAAA,KAAA,MAAW,CAAC,IAAA,EAAM,GAAG,KAAK,MAAA,CAAO,OAAA,CAAQ,QAAmC,CAAA,EAAG;AAC7E,MAAA,IAAI,OAAO,QAAQ,QAAA,EAAU;AAC3B,QAAA,KAAA,CAAM,IAAI,CAAA,GAAI,IAAA,CAAK,GAAA,EAAK,GAAG,CAAA;AAAA,MAC7B;AAAA,IACF;AAAA,EACF;AAEA,EAAA,OAAO,EAAE,OAAO,KAAA,EAAM;AACxB","file":"config.mjs","sourcesContent":["import { readFileSync } from 'node:fs';\nimport { join } from 'node:path';\n\nexport interface LoadAssetConfigResult {\n  readonly roots: readonly string[];\n  readonly paths: Record<string, string>;\n}\n\nexport function loadAssetConfig(cwd: string): LoadAssetConfigResult {\n  let pkg: { forgeax?: { assets?: { roots?: unknown; paths?: unknown } } };\n  try {\n    pkg = JSON.parse(readFileSync(join(cwd, 'package.json'), 'utf-8'));\n  } catch {\n    return { roots: [join(cwd, 'assets')], paths: {} };\n  }\n\n  const assets = pkg.forgeax?.assets;\n\n  const rawRoots = assets?.roots;\n  const roots: readonly string[] =\n    Array.isArray(rawRoots) && rawRoots.length > 0\n      ? (rawRoots as string[]).map((r) => join(cwd, r))\n      : [join(cwd, 'assets')];\n\n  const rawPaths = assets?.paths;\n  const paths: Record<string, string> = {};\n  if (rawPaths !== undefined && rawPaths !== null && typeof rawPaths === 'object') {\n    for (const [name, dir] of Object.entries(rawPaths as Record<string, unknown>)) {\n      if (typeof dir === 'string') {\n        paths[name] = join(cwd, dir);\n      }\n    }\n  }\n\n  return { roots, paths };\n}\n"]}

package/dist/deriveAssetName.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Derive an asset's display name from package metadata.
+ *
+ * Pure function -- zero IO, zero side effects, browser-safe. Build-time
+ * (build-catalog) and runtime (resolveName) share this single source of truth
+ * for the XOR name-resolution rules (plan-strategy D-6).
+ *
+ * Branches:
+ *   1. single-asset package (assetCount === 1)      -> baseName(packagePath)
+ *   2. multi-asset package + storedName              -> storedName
+ *   3. multi-asset package + no storedName (AC-15.1) -> baseName(packagePath)
+ *   4. null packagePath + no storedName  (AC-15.2)   -> ''
+ */
+export declare function deriveAssetName(packagePath: string | null, assetCount: number, storedName?: string): string;
+//# sourceMappingURL=deriveAssetName.d.ts.map

package/dist/deriveAssetName.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deriveAssetName.d.ts","sourceRoot":"","sources":["../src/deriveAssetName.ts"],"names":[],"mappings":"AAaA;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,UAAU,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CAWR"}

package/dist/errors.d.ts

@@ -0,0 +1,30 @@
+import type { PackErrorCode, PackErrorDetail } from '@forgeax/engine-types';
+/**
+ * Structured error for the engine-pack disk scanner fail-fast chain.
+ *
+ * AI users consume via exhaustive switch on .code — no default case needed:
+ * ```ts
+ * switch (err.code) {
+ *   case 'pack-guid-collision':
+ *     console.error(err.detail.paths);
+ *     break;
+ *   case 'pack-cyclic-reference':
+ *     console.error(err.detail.cycle);
+ *     break;
+ *   // ...all 8 cases
+ * }
+ * ```
+ */
+export declare class PackError extends Error {
+    readonly code: PackErrorCode;
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail: PackErrorDetail;
+    constructor(args: {
+        code: PackErrorCode;
+        expected: string;
+        hint: string;
+        detail: PackErrorDetail;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE5E;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAClC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;gBAErB,IAAI,EAAE;QAChB,IAAI,EAAE,aAAa,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,eAAe,CAAC;KACzB;CAQF"}

package/dist/errors.mjs

@@ -0,0 +1,19 @@
+// 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;
+  }
+};
+
+export { PackError };
+//# sourceMappingURL=errors.mjs.map
+//# sourceMappingURL=errors.mjs.map

package/dist/errors.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts"],"names":[],"mappings":";AA2BO,IAAM,SAAA,GAAN,cAAwB,KAAA,CAAM;AAAA,EAC1B,IAAA;AAAA,EACA,QAAA;AAAA,EACA,IAAA;AAAA,EACA,MAAA;AAAA,EAET,YAAY,IAAA,EAKT;AACD,IAAA,KAAA,CAAM,CAAA,WAAA,EAAc,KAAK,IAAI,CAAA,YAAA,EAAe,KAAK,QAAQ,CAAA,QAAA,EAAW,IAAA,CAAK,IAAI,CAAA,CAAE,CAAA;AAC/E,IAAA,IAAA,CAAK,IAAA,GAAO,WAAA;AACZ,IAAA,IAAA,CAAK,OAAO,IAAA,CAAK,IAAA;AACjB,IAAA,IAAA,CAAK,WAAW,IAAA,CAAK,QAAA;AACrB,IAAA,IAAA,CAAK,OAAO,IAAA,CAAK,IAAA;AACjB,IAAA,IAAA,CAAK,SAAS,IAAA,CAAK,MAAA;AAAA,EACrB;AACF","file":"errors.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"]}

package/dist/evidence/material-cook.d.ts

@@ -0,0 +1,70 @@
+import type { MaterialAsset, MaterialParameter, MaterialPass, MaterialValue, Result } from '@forgeax/engine-types';
+export interface MaterialCookRefs {
+    readonly parent: readonly string[];
+    readonly textures: readonly string[];
+    readonly samplers: readonly string[];
+    readonly modules: readonly string[];
+}
+export interface MaterialCookArtifact {
+    readonly mediaType: string;
+    readonly path: string;
+    readonly digest: string;
+    readonly bytes: Uint8Array;
+}
+export interface MaterialCookReceipt {
+    readonly schemaVersion: 'material-cook/2';
+    readonly sourceClosure: readonly string[];
+    readonly profile: string;
+    readonly compilerVersion: string;
+    readonly inputDigest: string;
+    readonly outputDigest: string;
+    readonly layoutIdentity: string;
+    readonly derivedInterface: {
+        readonly layoutIdentity: string;
+    };
+    readonly publicationGeneration?: number;
+}
+export interface MaterialParameterContract {
+    readonly parameters: readonly MaterialParameter[];
+    readonly values: Readonly<Record<string, MaterialValue | null>>;
+}
+export interface CookedMaterialRecord {
+    readonly schemaVersion: 'material-cook/2';
+    readonly guid: string;
+    readonly authored?: MaterialAsset;
+    readonly materialGuid?: string;
+    readonly publicationGeneration?: number;
+    readonly specializationKey?: string;
+    readonly artifactDigest?: string;
+    readonly sourceClosure?: readonly string[];
+    readonly parameterContract?: MaterialParameterContract;
+    readonly resolved: {
+        readonly passes: readonly MaterialPass[];
+        readonly parameters: readonly MaterialParameter[];
+        readonly values: Readonly<Record<string, MaterialValue | null>>;
+    };
+    readonly refs: MaterialCookRefs;
+    readonly artifact: MaterialCookArtifact;
+    readonly receipt: MaterialCookReceipt;
+}
+export interface MaterialCookRecordError {
+    readonly code: 'material-cook-record-invalid';
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail: {
+        readonly field: string;
+    };
+}
+export interface MaterialCookIdentityExpectation {
+    readonly layoutIdentity?: string;
+    readonly artifactDigest?: string;
+    readonly inputDigest?: string;
+}
+export declare function collectMaterialCookRefs(material: Partial<MaterialAsset>): MaterialCookRefs;
+export declare function createMaterialArtifactDigest(bytes: Uint8Array): string;
+export declare function serializeCookedMaterialRecord(record: CookedMaterialRecord): string;
+export declare function serializeMaterialCookReceipt(receipt: MaterialCookReceipt): string;
+export declare function validateMaterialCookReceipt(value: unknown, expected?: MaterialCookIdentityExpectation): Result<MaterialCookReceipt, MaterialCookRecordError>;
+export declare function validateCookedMaterialRecord(value: unknown): Result<CookedMaterialRecord, MaterialCookRecordError>;
+export declare function projectCookedMaterialRecord(record: CookedMaterialRecord): Omit<CookedMaterialRecord, 'guid' | 'authored'>;
+//# sourceMappingURL=material-cook.d.ts.map

package/dist/evidence/material-cook.d.ts.map

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

package/dist/evidence/offline-evidence.d.ts

@@ -0,0 +1,25 @@
+import type { ArtifactDescriptor, ArtifactVerificationStatus, AssetEvidence, AssetEvidenceError, AssetEvidenceLocator, CookProduct, CookReceipt, PackageVerificationEvidence, SourceDeclarationEvidence } from '@forgeax/engine-types';
+import { type Result } from '@forgeax/engine-types';
+/** Pack artifact descriptor with verification supplied by an offline verifier. */
+export interface OfflineArtifactInput extends ArtifactDescriptor {
+    readonly verification?: ArtifactVerificationStatus;
+}
+/** Validated Pack v2 package facts consumed by the offline projector. */
+export interface OfflinePackageInput {
+    readonly guid: string;
+    readonly digest?: string;
+    readonly artifacts: Readonly<Record<string, OfflineArtifactInput>>;
+}
+/** Node/CLI input shape; it intentionally has no runtime or WebSocket fields. */
+export interface OfflineAssetEvidenceInput {
+    readonly guid: string;
+    readonly source?: SourceDeclarationEvidence;
+    readonly locator?: AssetEvidenceLocator;
+    readonly receipt?: CookReceipt;
+    readonly package?: OfflinePackageInput;
+    readonly product?: CookProduct;
+}
+/** Build the shared evidence view without loading runtime assets or opening WS. */
+export declare function buildOfflineAssetEvidence(input: OfflineAssetEvidenceInput): Promise<Result<AssetEvidence, AssetEvidenceError>>;
+export declare function packageVerification(input: OfflinePackageInput | undefined): PackageVerificationEvidence | undefined;
+//# sourceMappingURL=offline-evidence.d.ts.map

package/dist/evidence/offline-evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offline-evidence.d.ts","sourceRoot":"","sources":["../../src/evidence/offline-evidence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,0BAA0B,EAC1B,aAAa,EACb,kBAAkB,EAElB,oBAAoB,EACpB,WAAW,EACX,WAAW,EACX,2BAA2B,EAC3B,yBAAyB,EAC1B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAGL,KAAK,MAAM,EACZ,MAAM,uBAAuB,CAAC;AAE/B,kFAAkF;AAClF,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D,QAAQ,CAAC,YAAY,CAAC,EAAE,0BAA0B,CAAC;CACpD;AAED,yEAAyE;AACzE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC;CACpE;AAED,iFAAiF;AACjF,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,yBAAyB,CAAC;IAC5C,QAAQ,CAAC,OAAO,CAAC,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC;CAChC;AAkBD,mFAAmF;AACnF,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAAC,CAYpD;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,mBAAmB,GAAG,SAAS,GACrC,2BAA2B,GAAG,SAAS,CAczC"}

package/dist/evidence/source-inventory.d.ts

@@ -0,0 +1,29 @@
+import type { SourceDeclarationEvidence } from '@forgeax/engine-types';
+/** Project root and GUID used to locate an authoritative source declaration. */
+export interface SourceInventoryRequest {
+    readonly projectRoot: string;
+    readonly guid: string;
+}
+export interface ProducerSemanticIdentityInput {
+    readonly producerRoot: string;
+    readonly sourcePath: string;
+    readonly sourceDigest: string;
+    readonly schemaVersion: string;
+    readonly importer: string;
+    readonly codec: string;
+    readonly settings: unknown;
+    readonly producer: string;
+    readonly profile: string;
+    readonly declaredGuids?: readonly string[];
+}
+export interface ProducerRelativeDdcIdentity {
+    readonly logicalPath: string;
+    readonly sourceDigest: string;
+    readonly key: string;
+}
+export declare function producerRelativeLogicalPath(producerRoot: string, sourcePath: string): string;
+export declare function producerRelativeDdcKey(input: ProducerSemanticIdentityInput): string;
+export declare function producerRelativeDdcIdentity(input: ProducerSemanticIdentityInput): ProducerRelativeDdcIdentity;
+/** Read `.meta.json` or `.pack.json` source declarations without runtime imports. */
+export declare function readSourceInventory(request: SourceInventoryRequest): Promise<SourceDeclarationEvidence | undefined>;
+//# sourceMappingURL=source-inventory.d.ts.map

package/dist/evidence/source-inventory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-inventory.d.ts","sourceRoot":"","sources":["../../src/evidence/source-inventory.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAKvE,gFAAgF;AAChF,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAcD,wBAAgB,2BAA2B,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAa5F;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,6BAA6B,GAAG,MAAM,CAcnF;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,6BAA6B,GACnC,2BAA2B,CAM7B;AA0DD,qFAAqF;AACrF,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,yBAAyB,GAAG,SAAS,CAAC,CA+ChD"}

package/dist/guid.d.ts

@@ -0,0 +1,45 @@
+import { PackError } from './errors.js';
+/**
+ * 16-byte UUID branded ABI. Prevents assignment from plain Uint8Array or string.
+ * Brand field mirrors the declaration in @forgeax/engine-types for cross-package
+ * structural compatibility (both use __guidBrand: 'AssetGuid').
+ */
+export type AssetGuid = Uint8Array & {
+    readonly __guidBrand: 'AssetGuid';
+};
+/** Minimal Result alias for this module (structurally compatible with ScanResult). */
+export type GuidResult<T, E> = {
+    readonly ok: true;
+    readonly value: T;
+} | {
+    readonly ok: false;
+    readonly error: E;
+};
+export declare function isValidAssetGuidString(value: unknown): value is string;
+/**
+ * Utilities for the AssetGuid branded 16-byte UUID type.
+ * Declare the type via `import type { AssetGuid } from '@forgeax/engine-pack/guid'`
+ * or `import type { AssetGuid } from '@forgeax/engine-types'`.
+ */
+export declare const AssetGuid: {
+    /**
+     * Parse a 36-char RFC 4122 dash-form UUID string into an AssetGuid.
+     * Returns Ok(AssetGuid) on success or Err(PackError) with code 'pack-guid-malformed' on failure.
+     * Never throws for expected failures (requirements §4.2 / §14 / charter proposition 4).
+     */
+    readonly parse: (dashForm: string) => GuidResult<AssetGuid, PackError>;
+    /**
+     * Format an AssetGuid as a 36-char RFC 4122 lowercase dash-form string.
+     */
+    readonly format: (guid: AssetGuid) => string;
+    /**
+     * Test byte-by-byte equality between two AssetGuids.
+     */
+    readonly equals: (a: AssetGuid, b: AssetGuid) => boolean;
+    /**
+     * Mint a new time-ordered UUIDv7 as an AssetGuid.
+     * Works in both Node.js and browser environments.
+     */
+    readonly random: () => AssetGuid;
+};
+//# sourceMappingURL=guid.d.ts.map

package/dist/guid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guid.d.ts","sourceRoot":"","sources":["../src/guid.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG;IAAE,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;CAAE,CAAC;AAE3E,sFAAsF;AACtF,MAAM,MAAM,UAAU,CAAC,CAAC,EAAE,CAAC,IACvB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GACxC;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC;AAgB9C,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEtE;AAWD;;;;GAIG;AACH,eAAO,MAAM,SAAS;IACpB;;;;OAIG;+BACa,MAAM,KAAG,UAAU,CAAC,SAAS,EAAE,SAAS,CAAC;IAkBzD;;OAEG;4BACU,SAAS,KAAG,MAAM;IAI/B;;OAEG;yBACO,SAAS,KAAK,SAAS,KAAG,OAAO;IAO3C;;;OAGG;2BACO,SAAS;CAMX,CAAC"}

package/dist/guid.mjs

@@ -0,0 +1,94 @@
+import { uuidv7obj } from 'uuidv7';
+
+// src/guid.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/guid.ts
+function brand(bytes) {
+  return bytes;
+}
+var HEX_BYTE = Array.from({ length: 256 }, (_, i) => i.toString(16).padStart(2, "0"));
+function bytesToDashForm(bytes) {
+  const h = HEX_BYTE;
+  return `${h[bytes[0]]}${h[bytes[1]]}${h[bytes[2]]}${h[bytes[3]]}-${h[bytes[4]]}${h[bytes[5]]}-${h[bytes[6]]}${h[bytes[7]]}-${h[bytes[8]]}${h[bytes[9]]}-${h[bytes[10]]}${h[bytes[11]]}${h[bytes[12]]}${h[bytes[13]]}${h[bytes[14]]}${h[bytes[15]]}`;
+}
+var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function isValidAssetGuidString(value) {
+  return typeof value === "string" && UUID_RE.test(value);
+}
+function dashFormToBytes(dashForm) {
+  const hex = dashForm.replace(/-/g, "");
+  const bytes = new Uint8Array(16);
+  for (let i = 0; i < 16; i++) {
+    bytes[i] = parseInt(hex.slice(i * 2, i * 2 + 2), 16);
+  }
+  return bytes;
+}
+var AssetGuid = {
+  /**
+   * Parse a 36-char RFC 4122 dash-form UUID string into an AssetGuid.
+   * Returns Ok(AssetGuid) on success or Err(PackError) with code 'pack-guid-malformed' on failure.
+   * Never throws for expected failures (requirements §4.2 / §14 / charter proposition 4).
+   */
+  parse(dashForm) {
+    if (!isValidAssetGuidString(dashForm)) {
+      return {
+        ok: false,
+        error: new PackError({
+          code: "pack-guid-malformed",
+          expected: "36-char RFC 4122 dash-form UUID",
+          hint: "use AssetGuid.random() or a UUIDv7 generator; all GUID fields must be 36-char RFC 4122 dash-form",
+          detail: {
+            raw: dashForm,
+            reason: "expected 36-char RFC 4122 dash-form UUID"
+          }
+        })
+      };
+    }
+    return { ok: true, value: brand(dashFormToBytes(dashForm)) };
+  },
+  /**
+   * Format an AssetGuid as a 36-char RFC 4122 lowercase dash-form string.
+   */
+  format(guid) {
+    return bytesToDashForm(guid);
+  },
+  /**
+   * Test byte-by-byte equality between two AssetGuids.
+   */
+  equals(a, b) {
+    for (let i = 0; i < 16; i++) {
+      if (a[i] !== b[i]) return false;
+    }
+    return true;
+  },
+  /**
+   * Mint a new time-ordered UUIDv7 as an AssetGuid.
+   * Works in both Node.js and browser environments.
+   */
+  random() {
+    const uuid = uuidv7obj();
+    const bytes = new Uint8Array(16);
+    bytes.set(uuid.bytes);
+    return brand(bytes);
+  }
+};
+
+export { AssetGuid, isValidAssetGuidString };
+//# sourceMappingURL=guid.mjs.map
+//# sourceMappingURL=guid.mjs.map

package/dist/guid.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/guid.ts"],"names":[],"mappings":"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","file":"guid.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 { uuidv7obj } from 'uuidv7';\nimport { PackError } from './errors.js';\n\n/**\n * 16-byte UUID branded ABI. Prevents assignment from plain Uint8Array or string.\n * Brand field mirrors the declaration in @forgeax/engine-types for cross-package\n * structural compatibility (both use __guidBrand: 'AssetGuid').\n */\nexport type AssetGuid = Uint8Array & { readonly __guidBrand: 'AssetGuid' };\n\n/** Minimal Result alias for this module (structurally compatible with ScanResult). */\nexport type GuidResult<T, E> =\n  | { readonly ok: true; readonly value: T }\n  | { readonly ok: false; readonly error: E };\n\nfunction brand(bytes: Uint8Array): AssetGuid {\n  return bytes as AssetGuid;\n}\n\nconst HEX_BYTE = Array.from({ length: 256 }, (_, i) => i.toString(16).padStart(2, '0'));\n\nfunction bytesToDashForm(bytes: Uint8Array): string {\n  const h = HEX_BYTE;\n  // biome-ignore lint/style/noNonNullAssertion: length guaranteed 16\n  return `${h[bytes[0]!]}${h[bytes[1]!]}${h[bytes[2]!]}${h[bytes[3]!]}-${h[bytes[4]!]}${h[bytes[5]!]}-${h[bytes[6]!]}${h[bytes[7]!]}-${h[bytes[8]!]}${h[bytes[9]!]}-${h[bytes[10]!]}${h[bytes[11]!]}${h[bytes[12]!]}${h[bytes[13]!]}${h[bytes[14]!]}${h[bytes[15]!]}`;\n}\n\nconst UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;\n\nexport function isValidAssetGuidString(value: unknown): value is string {\n  return typeof value === 'string' && UUID_RE.test(value);\n}\n\nfunction dashFormToBytes(dashForm: string): Uint8Array {\n  const hex = dashForm.replace(/-/g, '');\n  const bytes = new Uint8Array(16);\n  for (let i = 0; i < 16; i++) {\n    bytes[i] = parseInt(hex.slice(i * 2, i * 2 + 2), 16);\n  }\n  return bytes;\n}\n\n/**\n * Utilities for the AssetGuid branded 16-byte UUID type.\n * Declare the type via `import type { AssetGuid } from '@forgeax/engine-pack/guid'`\n * or `import type { AssetGuid } from '@forgeax/engine-types'`.\n */\nexport const AssetGuid = {\n  /**\n   * Parse a 36-char RFC 4122 dash-form UUID string into an AssetGuid.\n   * Returns Ok(AssetGuid) on success or Err(PackError) with code 'pack-guid-malformed' on failure.\n   * Never throws for expected failures (requirements §4.2 / §14 / charter proposition 4).\n   */\n  parse(dashForm: string): GuidResult<AssetGuid, PackError> {\n    if (!isValidAssetGuidString(dashForm)) {\n      return {\n        ok: false,\n        error: new PackError({\n          code: 'pack-guid-malformed',\n          expected: '36-char RFC 4122 dash-form UUID',\n          hint: 'use AssetGuid.random() or a UUIDv7 generator; all GUID fields must be 36-char RFC 4122 dash-form',\n          detail: {\n            raw: dashForm,\n            reason: 'expected 36-char RFC 4122 dash-form UUID',\n          },\n        }),\n      };\n    }\n    return { ok: true, value: brand(dashFormToBytes(dashForm)) };\n  },\n\n  /**\n   * Format an AssetGuid as a 36-char RFC 4122 lowercase dash-form string.\n   */\n  format(guid: AssetGuid): string {\n    return bytesToDashForm(guid);\n  },\n\n  /**\n   * Test byte-by-byte equality between two AssetGuids.\n   */\n  equals(a: AssetGuid, b: AssetGuid): boolean {\n    for (let i = 0; i < 16; i++) {\n      if (a[i] !== b[i]) return false;\n    }\n    return true;\n  },\n\n  /**\n   * Mint a new time-ordered UUIDv7 as an AssetGuid.\n   * Works in both Node.js and browser environments.\n   */\n  random(): AssetGuid {\n    const uuid = uuidv7obj();\n    const bytes = new Uint8Array(16);\n    bytes.set(uuid.bytes);\n    return brand(bytes);\n  },\n} as const;\n"]}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export { type CookedMaterialRecord, collectMaterialCookRefs, createMaterialArtifactDigest, type MaterialCookArtifact, type MaterialCookIdentityExpectation, type MaterialCookReceipt, type MaterialCookRecordError, type MaterialCookRefs, projectCookedMaterialRecord, serializeCookedMaterialRecord, serializeMaterialCookReceipt, validateCookedMaterialRecord, validateMaterialCookReceipt, } from './evidence/material-cook.js';
+export { buildOfflineAssetEvidence, packageVerification } from './evidence/offline-evidence.js';
+export { decodeMeshBinHeader, MESH_BIN_DIGEST_BYTES, MESH_BIN_HEADER_V4_BYTES, MESH_BIN_PROJECTION_VERSION, MESH_BIN_VERSION, type MeshBinContractError, type MeshBinHeaderResult, type MeshBinHeaderV4, writeMeshBinHeader, } from './mesh-bin-contract.js';
+export { validateProducerContract, validateProducerOutputs } from './producer-contract.js';
+export { type AssetReader, isScriptablePackAssetKind, projectScriptablePackMeta, SCRIPTABLE_PACK_ASSET_KINDS, type ScriptablePackAssetDeclaration, type ScriptablePackAssetDeclarations, type ScriptablePackAssetFor, type ScriptablePackAssetKind, type ScriptablePackDefinition, type ScriptablePackError, type ScriptablePackExternalAssets, type ScriptablePackMetaJson, type ScriptablePackOutputs, type ScriptablePackPublicationEnvelope, type ScriptablePackReadError, validateScriptablePackDefinition, } from './scriptable-pack.js';
+export { calculateTopologyDiff, diffTopology } from './topology.js';
+import { type PackV2, type PackV2Error, type Result } from '@forgeax/engine-types';
+export type { ArtifactPathContext } from './artifact-path.js';
+export { validateArtifactPath } from './artifact-path.js';
+export type { AnimationClip, AnimationGraph, Asset, AudioClipAsset, EquirectAsset, FontAsset, MaterialAsset, MeshAsset, PackV2, PackV2Error, ParticleEffectAsset, RenderPipelineAsset, SamplerAsset, SceneAsset, SkeletonAsset, SkinAsset, TextureAsset, TilesetAsset, VideoAsset, } from '@forgeax/engine-types';
+export { type MaterialArtifactWriteInput, type MaterialArtifactWriteResult, writeMaterialArtifact, } from './material/artifact-writer.js';
+export { projectRuntimePack, type RuntimeAssetProjectionInput, type RuntimePackProjectionInput, } from './runtime-projection.js';
+export { validateMeta, validatePack, validatePackV2 } from './schema-compiled.js';
+export declare function parsePackV2(value: unknown): Result<PackV2, PackV2Error>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,KAAK,oBAAoB,EACzB,uBAAuB,EACvB,4BAA4B,EAC5B,KAAK,oBAAoB,EACzB,KAAK,+BAA+B,EACpC,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,2BAA2B,EAC3B,6BAA6B,EAC7B,4BAA4B,EAC5B,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAChG,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,EACxB,2BAA2B,EAC3B,gBAAgB,EAChB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAC3F,OAAO,EACL,KAAK,WAAW,EAChB,yBAAyB,EACzB,yBAAyB,EACzB,2BAA2B,EAC3B,KAAK,8BAA8B,EACnC,KAAK,+BAA+B,EACpC,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACxB,KAAK,4BAA4B,EACjC,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,iCAAiC,EACtC,KAAK,uBAAuB,EAC5B,gCAAgC,GACjC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAEpE,OAAO,EAAW,KAAK,MAAM,EAAE,KAAK,WAAW,EAAE,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE5F,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAI1D,YAAY,EACV,aAAa,EACb,cAAc,EACd,KAAK,EACL,cAAc,EACd,aAAa,EACb,SAAS,EACT,aAAa,EACb,SAAS,EACT,MAAM,EACN,WAAW,EACX,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,EACZ,UAAU,EACV,aAAa,EACb,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,UAAU,GACX,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,EAChC,qBAAqB,GACtB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,kBAAkB,EAClB,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,GAChC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAElF,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAWvE"}