@forgeax/engine-pack 0.1.3 → 0.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (95) hide show
  1. package/README.md +51 -3
  2. package/dist/.tsbuildinfo +1 -1
  3. package/dist/__tests__/owner-chain.integration.test.d.ts +2 -0
  4. package/dist/__tests__/owner-chain.integration.test.d.ts.map +1 -0
  5. package/dist/__tests__/package-finalizer.contract.test.d.ts +2 -0
  6. package/dist/__tests__/package-finalizer.contract.test.d.ts.map +1 -0
  7. package/dist/__tests__/runtime.browser.test.d.ts +2 -0
  8. package/dist/__tests__/runtime.browser.test.d.ts.map +1 -0
  9. package/dist/__tests__/scanner-inventory.contract.test.d.ts +2 -0
  10. package/dist/__tests__/scanner-inventory.contract.test.d.ts.map +1 -0
  11. package/dist/artifact-path.mjs +53 -0
  12. package/dist/artifact-path.mjs.map +1 -0
  13. package/dist/atlas/shelf-pack.d.ts.map +1 -1
  14. package/dist/build.d.ts +17 -0
  15. package/dist/build.d.ts.map +1 -0
  16. package/dist/build.mjs +10168 -0
  17. package/dist/build.mjs.map +1 -0
  18. package/dist/builtin.d.ts +20 -0
  19. package/dist/builtin.d.ts.map +1 -1
  20. package/dist/builtin.mjs +141 -0
  21. package/dist/builtin.mjs.map +1 -0
  22. package/dist/catalog-builder.d.ts +43 -0
  23. package/dist/catalog-builder.d.ts.map +1 -0
  24. package/dist/catalog-delta.d.ts +11 -0
  25. package/dist/catalog-delta.d.ts.map +1 -0
  26. package/dist/catalog-projection.d.ts +91 -0
  27. package/dist/catalog-projection.d.ts.map +1 -0
  28. package/dist/cli-asset.mjs +231 -484
  29. package/dist/cli-asset.mjs.map +1 -1
  30. package/dist/index.mjs +83 -1
  31. package/dist/index.mjs.map +1 -1
  32. package/dist/material-cook.d.ts +2 -0
  33. package/dist/material-cook.d.ts.map +1 -0
  34. package/dist/material-cook.mjs +193 -0
  35. package/dist/material-cook.mjs.map +1 -0
  36. package/dist/mesh-bin-contract.mjs +96 -0
  37. package/dist/mesh-bin-contract.mjs.map +1 -0
  38. package/dist/native-cooker-registry.d.ts +19 -0
  39. package/dist/native-cooker-registry.d.ts.map +1 -1
  40. package/dist/native-cooker.mjs +37 -0
  41. package/dist/native-cooker.mjs.map +1 -1
  42. package/dist/package-finalizer.d.ts +121 -0
  43. package/dist/package-finalizer.d.ts.map +1 -0
  44. package/dist/resolve-asset-source.d.ts.map +1 -1
  45. package/dist/resolve-asset-source.mjs +16 -6
  46. package/dist/resolve-asset-source.mjs.map +1 -1
  47. package/dist/runtime-publication.d.ts +44 -0
  48. package/dist/runtime-publication.d.ts.map +1 -0
  49. package/dist/runtime.d.ts +8 -0
  50. package/dist/runtime.d.ts.map +1 -0
  51. package/dist/runtime.mjs +7261 -0
  52. package/dist/runtime.mjs.map +1 -0
  53. package/dist/scanner.d.ts +87 -54
  54. package/dist/scanner.d.ts.map +1 -1
  55. package/dist/scanner.mjs +258 -454
  56. package/dist/scanner.mjs.map +1 -1
  57. package/dist/scriptable-pack-node.d.ts +3 -8
  58. package/dist/scriptable-pack-node.d.ts.map +1 -1
  59. package/dist/scriptable-pack-node.mjs +93 -9
  60. package/dist/scriptable-pack-node.mjs.map +1 -1
  61. package/dist/scriptable-pack-worker.mjs +1 -0
  62. package/dist/scriptable-pack-worker.mjs.map +1 -1
  63. package/dist/scriptable-pack.d.ts +33 -0
  64. package/dist/scriptable-pack.d.ts.map +1 -1
  65. package/dist/scriptable-pack.mjs +91 -2
  66. package/dist/scriptable-pack.mjs.map +1 -1
  67. package/dist/topology.d.ts +1 -1
  68. package/dist/topology.d.ts.map +1 -1
  69. package/package.json +27 -2
  70. package/src/__tests__/mesh-bin-consumer-surface.unit.test.ts +2 -1
  71. package/src/__tests__/owner-chain.integration.test.ts +78 -0
  72. package/src/__tests__/package-finalizer.contract.test.ts +105 -0
  73. package/src/__tests__/runtime.browser.test.ts +15 -0
  74. package/src/__tests__/scanner-inventory.contract.test.ts +167 -0
  75. package/src/__tests__/scanner-inventory.test.ts +16 -12
  76. package/src/__tests__/scriptable-pack.unit.test.ts +42 -0
  77. package/src/atlas/shelf-pack.ts +20 -24
  78. package/src/build.ts +137 -0
  79. package/src/builtin.ts +38 -0
  80. package/src/catalog-builder.ts +313 -0
  81. package/src/catalog-delta.ts +189 -0
  82. package/src/catalog-projection.ts +344 -0
  83. package/src/cli-asset.ts +1 -5
  84. package/src/index.ts +2 -2
  85. package/src/material-cook.ts +13 -0
  86. package/src/native-cooker-registry.ts +72 -0
  87. package/src/package-finalizer.ts +394 -0
  88. package/src/resolve-asset-source.ts +2 -7
  89. package/src/runtime-publication.ts +190 -0
  90. package/src/runtime.ts +23 -0
  91. package/src/scanner.ts +289 -290
  92. package/src/scriptable-pack-node.ts +27 -23
  93. package/src/scriptable-pack-worker.ts +2 -0
  94. package/src/scriptable-pack.ts +123 -1
  95. package/src/topology.ts +2 -1
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/errors.ts","../src/guid.ts","../src/scriptable-pack.ts"],"names":[],"mappings":"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","file":"scriptable-pack.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","import type { Asset, AssetGuid, AssetPublicationEnvelope, Result } from '@forgeax/engine-types';\nimport { err, ok } from '@forgeax/engine-types';\nimport { AssetGuid as AssetGuidCodec } from './guid.js';\n\n/** Closed ordinary kind vocabulary shared by authoring, producers, and loaders. */\nexport type ScriptablePackAssetKind = Asset['kind'];\n\n/** Complete ordinary Asset kind vocabulary exposed by ScriptablePack discovery. */\nexport const SCRIPTABLE_PACK_ASSET_KINDS = [\n 'mesh',\n 'material',\n 'scene',\n 'texture',\n 'equirect',\n 'sampler',\n 'font',\n 'render-pipeline',\n 'tileset',\n 'video',\n 'skeleton',\n 'skin',\n 'animation-clip',\n 'animation-graph',\n 'audio',\n 'particle-effect',\n] as const satisfies readonly ScriptablePackAssetKind[];\n\nexport function isScriptablePackAssetKind(value: string): value is ScriptablePackAssetKind {\n return (SCRIPTABLE_PACK_ASSET_KINDS as readonly string[]).includes(value);\n}\n\nexport interface ScriptablePackAssetDeclaration<\n TKind extends ScriptablePackAssetKind = ScriptablePackAssetKind,\n> {\n readonly guid: AssetGuid;\n readonly kind: TKind;\n readonly name?: string;\n}\n\nexport type ScriptablePackAssetDeclarations = Readonly<\n Record<string, ScriptablePackAssetDeclaration>\n>;\n\nexport type ScriptablePackExternalAssets = Readonly<Record<string, AssetGuid>>;\n\n/** Pack-facing name for the shared Engine publication envelope. */\nexport type ScriptablePackPublicationEnvelope = AssetPublicationEnvelope;\n\n/** Structured domain failure permitted to cross the isolated build-time AssetReader seam. */\nexport interface ScriptablePackErrorProvenance {\n /** Published source generation observed by the reader, when available. */\n readonly generation?: number;\n /** Stable producer identity for the failed output, when available. */\n readonly sourceKey?: string;\n /** GUID associated with the failed read or output, when available. */\n readonly guid?: string;\n}\n\nexport interface ScriptablePackReadError {\n readonly code: string;\n readonly expected: string;\n readonly hint: string;\n readonly detail?: unknown;\n readonly provenance?: ScriptablePackErrorProvenance;\n}\n\nexport type ScriptablePackAssetFor<TDescriptor extends ScriptablePackAssetDeclaration> =\n TDescriptor extends { readonly kind: infer TKind extends ScriptablePackAssetKind }\n ? Extract<Asset, { readonly kind: TKind }>\n : never;\n\nexport type ScriptablePackOutputs<TAssets extends ScriptablePackAssetDeclarations> = {\n readonly [TKey in keyof TAssets]: TAssets[TKey] extends ScriptablePackAssetDeclaration\n ? ScriptablePackAssetFor<TAssets[TKey]>\n : never;\n};\n\nexport interface AssetReader {\n /** Load a declared GUID as a durable payload; this never mints a World handle. */\n readByGuid<TAsset extends Asset = Asset>(\n guid: AssetGuid,\n ): Promise<Result<TAsset, ScriptablePackReadError>>;\n}\n\nexport type ScriptablePackBuildResult<\n TAssets extends ScriptablePackAssetDeclarations,\n TError,\n> = Result<ScriptablePackOutputs<TAssets>, TError>;\n\nexport interface ScriptablePackDefinition<\n TAssets extends ScriptablePackAssetDeclarations = ScriptablePackAssetDeclarations,\n TExternal extends ScriptablePackExternalAssets = ScriptablePackExternalAssets,\n TError = ScriptablePackReadError,\n> {\n readonly schemaVersion: '1.0.0';\n readonly packageId: AssetGuid;\n readonly name?: string;\n readonly assets: TAssets;\n readonly externalAssets: TExternal;\n readonly build: (\n assetReader: AssetReader,\n ) =>\n | ScriptablePackBuildResult<TAssets, TError>\n | Promise<ScriptablePackBuildResult<TAssets, TError>>;\n}\n\nexport interface ScriptablePackMetaJson {\n readonly schemaVersion: '1.0.0';\n readonly kind: 'external-asset-package';\n readonly packageId: string;\n readonly name?: string;\n readonly importer: 'pack-ts';\n readonly source: string;\n readonly importSettings: {\n readonly contractVersion: '1.0.0';\n readonly externalAssets: readonly {\n readonly alias: string;\n readonly guid: string;\n }[];\n };\n readonly subAssets: readonly {\n readonly guid: string;\n readonly sourceIndex: number;\n readonly sourceKey: string;\n readonly kind: ScriptablePackAssetKind;\n readonly name?: string;\n }[];\n}\n\nexport interface ScriptablePackOperationEnvelope {\n readonly requestId: string;\n readonly expectedRevision?: string;\n}\n\nexport type ScriptablePackGatewayOperation =\n | (ScriptablePackOperationEnvelope & {\n readonly kind: 'preflight';\n readonly sourcePath: string;\n })\n | (ScriptablePackOperationEnvelope & {\n readonly kind: 'create-scriptable-pack';\n readonly sourcePath: string;\n readonly name?: string;\n readonly initialOutput: {\n readonly sourceKey: string;\n readonly kind: ScriptablePackAssetKind;\n readonly name?: string;\n };\n })\n | (ScriptablePackOperationEnvelope & {\n readonly kind: 'add-output';\n readonly sourcePath: string;\n readonly sourceKey: string;\n readonly assetKind: ScriptablePackAssetKind;\n readonly name?: string;\n })\n | (ScriptablePackOperationEnvelope & {\n readonly kind: 'add-external-asset';\n readonly sourcePath: string;\n readonly alias: string;\n readonly guid: AssetGuid;\n })\n | (ScriptablePackOperationEnvelope & {\n readonly kind: 'rename-display';\n readonly sourcePath: string;\n readonly target:\n | { readonly kind: 'package' }\n | { readonly kind: 'output'; readonly sourceKey: string };\n readonly name: string;\n })\n | (ScriptablePackOperationEnvelope & {\n readonly kind: 'remove-output';\n readonly sourcePath: string;\n readonly sourceKey: string;\n /** Exact incoming reference identities acknowledged by the caller. */\n readonly confirmIncomingRefs?: readonly string[];\n })\n | (ScriptablePackOperationEnvelope & {\n readonly kind: 'clone-scriptable-pack';\n readonly sourcePath: string;\n readonly targetPath: string;\n })\n | (ScriptablePackOperationEnvelope & {\n readonly kind: 'inspect-meta';\n readonly sourcePath: string;\n })\n | (ScriptablePackOperationEnvelope & {\n readonly kind: 'rebuild' | 'cold-cook';\n readonly sourcePath: string;\n });\n\nexport interface ScriptablePackMutationCapabilities {\n readonly inspect: true;\n readonly rebuild: true;\n readonly coldCook: true;\n readonly create?: true;\n readonly addOutput?: true;\n readonly addExternalAsset?: true;\n readonly renameDisplay?: true;\n readonly removeOutput?: true;\n readonly clone?: true;\n readonly reason?: string;\n}\n\nexport interface ScriptablePackPreflight {\n readonly sourcePath: string;\n readonly revision: string;\n readonly meta: ScriptablePackMetaJson;\n readonly capabilities: ScriptablePackMutationCapabilities;\n readonly incomingRefs: readonly string[];\n}\n\nexport interface ScriptablePackGatewayMutation {\n readonly sourcePath: string;\n readonly revision: string;\n readonly meta: ScriptablePackMetaJson;\n}\n\nexport interface ScriptablePackAuthoringGateway {\n execute(\n operation: ScriptablePackGatewayOperation,\n ): Promise<Result<ScriptablePackGatewayMutation | ScriptablePackPreflight, ScriptablePackError>>;\n}\n\nexport type ScriptablePackAuthoringMutation =\n | (ScriptablePackOperationEnvelope & {\n readonly kind: 'create-scriptable-pack';\n readonly sourcePath: string;\n readonly packageId: AssetGuid;\n readonly name?: string;\n readonly initialOutput: {\n readonly sourceKey: string;\n readonly kind: ScriptablePackAssetKind;\n readonly guid: AssetGuid;\n readonly name?: string;\n };\n })\n | (ScriptablePackOperationEnvelope & {\n readonly kind: 'add-output';\n readonly sourcePath: string;\n readonly sourceKey: string;\n readonly assetKind: ScriptablePackAssetKind;\n readonly guid: AssetGuid;\n readonly name?: string;\n })\n | Extract<\n ScriptablePackGatewayOperation,\n { readonly kind: 'add-external-asset' | 'rename-display' | 'remove-output' }\n >\n | (ScriptablePackOperationEnvelope & {\n readonly kind: 'clone-scriptable-pack';\n readonly sourcePath: string;\n readonly targetPath: string;\n readonly packageId: AssetGuid;\n readonly outputGuids: Readonly<Record<string, AssetGuid>>;\n });\n\nexport interface ScriptablePackAuthoringPort {\n preflight(\n sourcePath: string,\n ): Promise<Result<Omit<ScriptablePackPreflight, 'sourcePath'>, ScriptablePackError>>;\n mutate(\n operation: ScriptablePackAuthoringMutation,\n ): Promise<\n Result<{ readonly sourcePath: string; readonly revision: string }, ScriptablePackError>\n >;\n inspect(\n sourcePath: string,\n ): Promise<\n Result<\n { readonly revision: string; readonly meta: ScriptablePackMetaJson },\n ScriptablePackError\n >\n >;\n rebuild(\n sourcePath: string,\n mode: 'rebuild' | 'cold-cook',\n ): Promise<\n Result<\n { readonly revision: string; readonly meta: ScriptablePackMetaJson },\n ScriptablePackError\n >\n >;\n}\n\n/** Keep GUID allocation and multi-identity operations in one auditable gateway transaction. */\nexport function createScriptablePackAuthoringGateway(\n port: ScriptablePackAuthoringPort,\n allocateGuid: () => AssetGuid = AssetGuidCodec.random,\n): ScriptablePackAuthoringGateway {\n const requests = new Map<\n string,\n {\n readonly fingerprint: string;\n readonly result: Promise<\n Result<ScriptablePackGatewayMutation | ScriptablePackPreflight, ScriptablePackError>\n >;\n }\n >();\n\n async function mutationResult(\n result: Awaited<ReturnType<ScriptablePackAuthoringPort['mutate']>>,\n ): Promise<Result<ScriptablePackGatewayMutation, ScriptablePackError>> {\n if (!result.ok) return result;\n const inspected = await port.inspect(result.value.sourcePath);\n if (!inspected.ok) return inspected;\n return ok({\n sourcePath: result.value.sourcePath,\n revision: inspected.value.revision,\n meta: inspected.value.meta,\n });\n }\n\n async function dispatch(\n operation: ScriptablePackGatewayOperation,\n ): Promise<Result<ScriptablePackGatewayMutation | ScriptablePackPreflight, ScriptablePackError>> {\n switch (operation.kind) {\n case 'preflight': {\n const preflight = await port.preflight(operation.sourcePath);\n return preflight.ok\n ? ok({ sourcePath: operation.sourcePath, ...preflight.value })\n : preflight;\n }\n case 'inspect-meta': {\n const inspected = await port.inspect(operation.sourcePath);\n return inspected.ok\n ? ok({ sourcePath: operation.sourcePath, ...inspected.value })\n : inspected;\n }\n case 'rebuild':\n case 'cold-cook': {\n const preflight = await port.preflight(operation.sourcePath);\n if (!preflight.ok) return preflight;\n if (\n operation.expectedRevision !== undefined &&\n operation.expectedRevision !== preflight.value.revision\n ) {\n return err({\n code: 'pack-source-revision-conflict',\n expected: operation.expectedRevision,\n actual: preflight.value.revision,\n hint: 'inspect the current source revision, then retry the build with a new requestId',\n retryable: true,\n recoveryActions: ['asset.preflight', 'mint-request-id'],\n detail: { requestId: operation.requestId, sourcePath: operation.sourcePath },\n });\n }\n const rebuilt = await port.rebuild(operation.sourcePath, operation.kind);\n return rebuilt.ok ? ok({ sourcePath: operation.sourcePath, ...rebuilt.value }) : rebuilt;\n }\n case 'create-scriptable-pack':\n return mutationResult(\n await port.mutate({\n ...operation,\n packageId: allocateGuid(),\n initialOutput: { ...operation.initialOutput, guid: allocateGuid() },\n }),\n );\n case 'add-output':\n return mutationResult(await port.mutate({ ...operation, guid: allocateGuid() }));\n case 'clone-scriptable-pack': {\n const inspected = await port.inspect(operation.sourcePath);\n if (!inspected.ok) return inspected;\n const outputGuids = Object.fromEntries(\n inspected.value.meta.subAssets.map((asset) => [asset.sourceKey, allocateGuid()]),\n );\n return mutationResult(\n await port.mutate({\n ...operation,\n packageId: allocateGuid(),\n outputGuids,\n }),\n );\n }\n case 'add-external-asset':\n case 'rename-display':\n case 'remove-output':\n return mutationResult(await port.mutate(operation));\n }\n }\n\n return {\n execute(operation) {\n if (operation.requestId.trim().length === 0) {\n return Promise.resolve(\n err({\n code: 'pack-source-operation-committed',\n expected: 'a non-empty caller-minted requestId',\n actual: operation.requestId,\n hint: 'mint a new requestId and retry the operation once',\n retryable: true,\n recoveryActions: ['mint-request-id'],\n detail: { requestId: operation.requestId, sourcePath: operation.sourcePath },\n }),\n );\n }\n const fingerprint = JSON.stringify(operation);\n const prior = requests.get(operation.requestId);\n if (prior !== undefined) {\n if (prior.fingerprint === fingerprint) return prior.result;\n return Promise.resolve(\n err({\n code: 'pack-source-operation-committed',\n expected: 'one immutable operation per requestId',\n actual: operation.kind,\n hint: 'read the original operation result or mint a new requestId',\n retryable: false,\n recoveryActions: ['read-operation-run', 'mint-request-id'],\n detail: { requestId: operation.requestId, sourcePath: operation.sourcePath },\n }),\n );\n }\n const result = dispatch(operation);\n requests.set(operation.requestId, { fingerprint, result });\n return result;\n },\n };\n}\n\nconst SCRIPTABLE_PACK_REQUEST_ID_SCHEMA = {\n type: 'string',\n minLength: 1,\n maxLength: 128,\n pattern: '^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$',\n description: 'Caller-minted identity for one idempotent ScriptablePack operation.',\n} as const;\nconst SCRIPTABLE_PACK_SOURCE_PATH_SCHEMA = {\n type: 'string',\n minLength: 8,\n pattern: '^[^/].*\\\\.pack\\\\.ts$',\n description: 'Game-root-relative ScriptablePack source path.',\n} as const;\nconst SCRIPTABLE_PACK_OWNER_GUID_SCHEMA = {\n type: 'string',\n format: 'uuid',\n description: 'Catalog GUID used to resolve the producer-owned source subject.',\n} as const;\nconst SCRIPTABLE_PACK_REVISION_SCHEMA = {\n type: 'string',\n minLength: 64,\n maxLength: 64,\n pattern: '^[a-f0-9]{64}$',\n description: 'SHA-256 source revision returned by preflight.',\n} as const;\nconst SCRIPTABLE_PACK_SOURCE_KEY_SCHEMA = { type: 'string', minLength: 1 } as const;\nconst SCRIPTABLE_PACK_ASSET_KIND_SCHEMA = {\n enum: SCRIPTABLE_PACK_ASSET_KINDS,\n description: 'Ordinary Asset kind supported by the ScriptablePack producer/loader matrix.',\n} as const;\nconst SCRIPTABLE_PACK_NAME_SCHEMA = { type: 'string', minLength: 1 } as const;\n\nfunction scriptablePackArgsSchema(\n properties: Readonly<Record<string, unknown>>,\n required: readonly string[],\n options: { readonly subject?: boolean; readonly guidSubject?: boolean } = {},\n) {\n const subjectRequired = ['requestId', ...required];\n return {\n type: 'object',\n properties: {\n sourcePath: SCRIPTABLE_PACK_SOURCE_PATH_SCHEMA,\n ownerGuid: SCRIPTABLE_PACK_OWNER_GUID_SCHEMA,\n requestId: SCRIPTABLE_PACK_REQUEST_ID_SCHEMA,\n ...properties,\n },\n required: subjectRequired,\n ...(options.subject === false\n ? {}\n : {\n anyOf: [\n { required: [...subjectRequired, 'sourcePath'] },\n { required: [...subjectRequired, 'ownerGuid'] },\n ...(options.guidSubject === false ? [] : [{ required: [...subjectRequired, 'guid'] }]),\n ],\n }),\n additionalProperties: false,\n } as const;\n}\n\nexport const SOURCE_AUTHORING_OPERATION_DESCRIPTORS = [\n {\n id: 'asset-source.create',\n kind: 'create',\n domain: 'session',\n title: 'Create Asset Source',\n argsSchema: scriptablePackArgsSchema(\n {\n name: SCRIPTABLE_PACK_NAME_SCHEMA,\n initialOutput: {\n type: 'object',\n properties: {\n sourceKey: SCRIPTABLE_PACK_SOURCE_KEY_SCHEMA,\n kind: SCRIPTABLE_PACK_ASSET_KIND_SCHEMA,\n name: SCRIPTABLE_PACK_NAME_SCHEMA,\n },\n required: ['sourceKey', 'kind'],\n additionalProperties: false,\n },\n },\n ['sourcePath', 'initialOutput'],\n { subject: false },\n ),\n },\n {\n id: 'asset-source.add-output',\n kind: 'add-output',\n domain: 'session',\n title: 'Add Asset Source Output',\n argsSchema: scriptablePackArgsSchema(\n {\n sourceKey: SCRIPTABLE_PACK_SOURCE_KEY_SCHEMA,\n assetKind: SCRIPTABLE_PACK_ASSET_KIND_SCHEMA,\n name: SCRIPTABLE_PACK_NAME_SCHEMA,\n expectedRevision: SCRIPTABLE_PACK_REVISION_SCHEMA,\n },\n ['sourceKey', 'assetKind', 'expectedRevision'],\n ),\n },\n {\n id: 'asset-source.add-external-asset',\n kind: 'add-external-asset',\n domain: 'session',\n title: 'Add Asset Source External Asset',\n argsSchema: scriptablePackArgsSchema(\n {\n alias: SCRIPTABLE_PACK_SOURCE_KEY_SCHEMA,\n guid: { type: 'string', format: 'uuid' },\n expectedRevision: SCRIPTABLE_PACK_REVISION_SCHEMA,\n },\n ['alias', 'guid', 'expectedRevision'],\n { guidSubject: false },\n ),\n },\n {\n id: 'asset-source.rename',\n kind: 'rename',\n domain: 'session',\n title: 'Rename Asset Source Display Name',\n argsSchema: scriptablePackArgsSchema(\n {\n target: {\n oneOf: [\n {\n type: 'object',\n properties: { kind: { const: 'package' } },\n required: ['kind'],\n additionalProperties: false,\n },\n {\n type: 'object',\n properties: {\n kind: { const: 'output' },\n sourceKey: SCRIPTABLE_PACK_SOURCE_KEY_SCHEMA,\n },\n required: ['kind', 'sourceKey'],\n additionalProperties: false,\n },\n ],\n },\n name: SCRIPTABLE_PACK_NAME_SCHEMA,\n expectedRevision: SCRIPTABLE_PACK_REVISION_SCHEMA,\n },\n ['target', 'name', 'expectedRevision'],\n ),\n },\n {\n id: 'asset-source.remove-output',\n kind: 'remove-output',\n domain: 'session',\n title: 'Remove Asset Source Output',\n destructive: true,\n argsSchema: scriptablePackArgsSchema(\n {\n sourceKey: SCRIPTABLE_PACK_SOURCE_KEY_SCHEMA,\n confirmIncomingRefs: { type: 'array', items: { type: 'string' } },\n expectedRevision: SCRIPTABLE_PACK_REVISION_SCHEMA,\n },\n ['sourceKey', 'expectedRevision'],\n ),\n },\n {\n id: 'asset-source.clone',\n kind: 'clone',\n domain: 'session',\n title: 'Clone Asset Source',\n argsSchema: scriptablePackArgsSchema(\n {\n targetPath: SCRIPTABLE_PACK_SOURCE_PATH_SCHEMA,\n expectedRevision: SCRIPTABLE_PACK_REVISION_SCHEMA,\n },\n ['targetPath', 'expectedRevision'],\n ),\n },\n {\n id: 'asset-source.rebuild',\n kind: 'rebuild',\n domain: 'session',\n title: 'Rebuild Asset Source',\n argsSchema: scriptablePackArgsSchema({ expectedRevision: SCRIPTABLE_PACK_REVISION_SCHEMA }, [\n 'expectedRevision',\n ]),\n },\n {\n id: 'asset-source.cold-cook',\n kind: 'cold-cook',\n domain: 'session',\n title: 'Cold Cook Asset Source',\n argsSchema: scriptablePackArgsSchema({ expectedRevision: SCRIPTABLE_PACK_REVISION_SCHEMA }, [\n 'expectedRevision',\n ]),\n },\n] as const;\n\nexport type ScriptablePackError =\n | {\n readonly code: 'pack-source-load-failed';\n readonly expected: string;\n readonly hint: string;\n readonly detail: {\n readonly sourcePath: string;\n readonly reason: 'module-load' | 'timeout' | 'source-changed';\n readonly phase: 'module-load' | 'build';\n readonly diagnostic: string;\n readonly timeoutMs?: number;\n };\n }\n | {\n readonly code: 'pack-source-definition-invalid';\n readonly expected: string;\n readonly hint: string;\n readonly detail: {\n readonly sourcePath?: string;\n readonly propertyPath: string;\n readonly actual: string;\n };\n }\n | {\n readonly code: 'pack-source-output-invalid';\n readonly expected: string;\n readonly hint: string;\n readonly detail: {\n readonly missingGuids: readonly string[];\n readonly unexpectedSourceKeys: readonly string[];\n readonly kindMismatches: readonly {\n readonly sourceKey: string;\n readonly expected: string;\n readonly actual: string;\n }[];\n };\n }\n | {\n readonly code: 'pack-source-external-closure-mismatch';\n readonly expected: string;\n readonly hint: string;\n readonly detail: {\n readonly undeclaredReferencedGuids: readonly string[];\n readonly undeclaredReadGuids: readonly string[];\n readonly unusedDeclaredGuids: readonly string[];\n };\n }\n | {\n readonly code:\n | 'pack-source-path-invalid'\n | 'pack-source-revision-conflict'\n | 'pack-source-mutation-unsupported'\n | 'pack-source-reference-conflict'\n | 'pack-source-write-failed'\n | 'pack-source-build-cycle'\n | 'pack-source-publication-timeout'\n | 'pack-source-operation-committed';\n readonly expected: string;\n readonly actual?: string;\n readonly hint: string;\n readonly retryable: boolean;\n readonly recoveryActions: readonly string[];\n readonly detail: {\n readonly requestId?: string;\n readonly sourcePath?: string;\n readonly packageId?: string;\n readonly sourceKey?: string;\n readonly incomingRefs?: readonly string[];\n };\n };\n\nfunction actual(value: unknown): string {\n if (value === null) return 'null';\n if (Array.isArray(value)) return 'array';\n if (ArrayBuffer.isView(value)) return value.constructor.name;\n return typeof value;\n}\n\nfunction invalid(\n propertyPath: string,\n expected: string,\n value: unknown,\n sourcePath?: string,\n): Result<never, ScriptablePackError> {\n return err({\n code: 'pack-source-definition-invalid',\n expected,\n hint: 'repair the default exported ScriptablePack definition, then inspect Meta again',\n detail: {\n ...(sourcePath === undefined ? {} : { sourcePath }),\n propertyPath,\n actual: actual(value),\n },\n });\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n return value !== null && typeof value === 'object' && !Array.isArray(value);\n}\n\nfunction isAssetGuid(value: unknown): value is AssetGuid {\n return value instanceof Uint8Array && value.byteLength === 16;\n}\n\nfunction guidKey(guid: AssetGuid): string {\n return AssetGuidCodec.format(guid);\n}\n\nfunction freezeDefinition(\n definition: ScriptablePackDefinition,\n): Readonly<ScriptablePackDefinition> {\n const assets = Object.fromEntries(\n Object.entries(definition.assets).map(([sourceKey, descriptor]) => [\n sourceKey,\n Object.freeze({ ...descriptor, guid: descriptor.guid.slice() as AssetGuid }),\n ]),\n );\n const externalAssets = Object.fromEntries(\n Object.entries(definition.externalAssets).map(([alias, guid]) => [\n alias,\n guid.slice() as AssetGuid,\n ]),\n );\n return Object.freeze({\n ...definition,\n packageId: definition.packageId.slice() as AssetGuid,\n assets: Object.freeze(assets),\n externalAssets: Object.freeze(externalAssets),\n });\n}\n\nexport function validateScriptablePackDefinition(\n value: unknown,\n sourcePath?: string,\n): Result<Readonly<ScriptablePackDefinition>, ScriptablePackError> {\n if (!isRecord(value))\n return invalid('$', 'a ScriptablePack definition object', value, sourcePath);\n if (value.schemaVersion !== '1.0.0') {\n return invalid('$.schemaVersion', \"the literal '1.0.0'\", value.schemaVersion, sourcePath);\n }\n if (!isAssetGuid(value.packageId)) {\n return invalid('$.packageId', 'a 16-byte AssetGuid', value.packageId, sourcePath);\n }\n if (value.name !== undefined && typeof value.name !== 'string') {\n return invalid('$.name', 'a string when present', value.name, sourcePath);\n }\n if (!isRecord(value.assets) || Object.keys(value.assets).length === 0) {\n return invalid(\n '$.assets',\n 'a non-empty sourceKey to descriptor object',\n value.assets,\n sourcePath,\n );\n }\n if (!isRecord(value.externalAssets)) {\n return invalid(\n '$.externalAssets',\n 'an alias to AssetGuid object',\n value.externalAssets,\n sourcePath,\n );\n }\n if (typeof value.build !== 'function') {\n return invalid('$.build', 'a build(assetReader) function', value.build, sourcePath);\n }\n\n const packageGuid = guidKey(value.packageId);\n const localGuids = new Set<string>();\n for (const [sourceKey, descriptor] of Object.entries(value.assets)) {\n if (sourceKey.trim().length === 0) {\n return invalid('$.assets', 'non-empty sourceKey object keys', sourceKey, sourcePath);\n }\n if (!isRecord(descriptor)) {\n return invalid(\n `$.assets[${JSON.stringify(sourceKey)}]`,\n 'an asset descriptor',\n descriptor,\n sourcePath,\n );\n }\n if (!isAssetGuid(descriptor.guid)) {\n return invalid(\n `$.assets[${JSON.stringify(sourceKey)}].guid`,\n 'a 16-byte AssetGuid',\n descriptor.guid,\n sourcePath,\n );\n }\n if (typeof descriptor.kind !== 'string' || !isScriptablePackAssetKind(descriptor.kind)) {\n return invalid(\n `$.assets[${JSON.stringify(sourceKey)}].kind`,\n 'one of SCRIPTABLE_PACK_ASSET_KINDS',\n descriptor.kind,\n sourcePath,\n );\n }\n if (descriptor.name !== undefined && typeof descriptor.name !== 'string') {\n return invalid(\n `$.assets[${JSON.stringify(sourceKey)}].name`,\n 'a string when present',\n descriptor.name,\n sourcePath,\n );\n }\n const guid = guidKey(descriptor.guid);\n if (guid === packageGuid || localGuids.has(guid)) {\n return invalid(\n `$.assets[${JSON.stringify(sourceKey)}].guid`,\n 'a GUID unique within the package and distinct from packageId',\n descriptor.guid,\n sourcePath,\n );\n }\n localGuids.add(guid);\n }\n\n const externalGuids = new Set<string>();\n for (const [alias, guidValue] of Object.entries(value.externalAssets)) {\n if (alias.trim().length === 0) {\n return invalid('$.externalAssets', 'non-empty alias object keys', alias, sourcePath);\n }\n if (!isAssetGuid(guidValue)) {\n return invalid(\n `$.externalAssets[${JSON.stringify(alias)}]`,\n 'a 16-byte AssetGuid',\n guidValue,\n sourcePath,\n );\n }\n const guid = guidKey(guidValue);\n if (guid === packageGuid || localGuids.has(guid) || externalGuids.has(guid)) {\n return invalid(\n `$.externalAssets[${JSON.stringify(alias)}]`,\n 'a unique foreign GUID not owned by this package',\n guidValue,\n sourcePath,\n );\n }\n externalGuids.add(guid);\n }\n\n return ok(freezeDefinition(value as unknown as ScriptablePackDefinition));\n}\n\nexport function projectScriptablePackMeta(\n definition: ScriptablePackDefinition,\n source: string,\n): ScriptablePackMetaJson {\n const subAssets = Object.entries(definition.assets)\n .sort(([left], [right]) => left.localeCompare(right))\n .map(([sourceKey, descriptor], sourceIndex) => ({\n guid: guidKey(descriptor.guid),\n sourceIndex,\n sourceKey,\n kind: descriptor.kind,\n ...(descriptor.name === undefined ? {} : { name: descriptor.name }),\n }));\n const externalAssets = Object.entries(definition.externalAssets)\n .sort(([left], [right]) => left.localeCompare(right))\n .map(([alias, guid]) => ({ alias, guid: guidKey(guid) }));\n return {\n schemaVersion: '1.0.0',\n kind: 'external-asset-package',\n packageId: guidKey(definition.packageId),\n ...(definition.name === undefined ? {} : { name: definition.name }),\n importer: 'pack-ts',\n source,\n importSettings: { contractVersion: '1.0.0', externalAssets },\n subAssets,\n };\n}\n"]}
1
+ {"version":3,"sources":["../src/errors.ts","../src/guid.ts","../src/scriptable-pack.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,CAAA;;;AC/BA,SAAS,MAAM,KAAA,EAA8B;AAC3C,EAAA,OAAO,KAAA;AACT;AAEA,IAAM,WAAW,KAAA,CAAM,IAAA,CAAK,EAAE,MAAA,EAAQ,KAAI,EAAG,CAAC,CAAA,EAAG,CAAA,KAAM,EAAE,QAAA,CAAS,EAAE,EAAE,QAAA,CAAS,CAAA,EAAG,GAAG,CAAC,CAAA;AAEtF,SAAS,gBAAgB,KAAA,EAA2B;AAClD,EAAA,MAAM,CAAA,GAAI,QAAA;AAEV,EAAA,OAAO,CAAA,EAAG,EAAE,KAAA,CAAM,CAAC,CAAE,CAAC,CAAA,EAAG,EAAE,KAAA,CAAM,CAAC,CAAE,CAAC,CAAA,EAAG,EAAE,KAAA,CAAM,CAAC,CAAE,CAAC,CAAA,EAAG,EAAE,KAAA,CAAM,CAAC,CAAE,CAAC,CAAA,CAAA,EAAI,EAAE,KAAA,CAAM,CAAC,CAAE,CAAC,CAAA,EAAG,EAAE,KAAA,CAAM,CAAC,CAAE,CAAC,CAAA,CAAA,EAAI,EAAE,KAAA,CAAM,CAAC,CAAE,CAAC,CAAA,EAAG,CAAA,CAAE,KAAA,CAAM,CAAC,CAAE,CAAC,CAAA,CAAA,EAAI,CAAA,CAAE,MAAM,CAAC,CAAE,CAAC,CAAA,EAAG,CAAA,CAAE,MAAM,CAAC,CAAE,CAAC,CAAA,CAAA,EAAI,CAAA,CAAE,MAAM,EAAE,CAAE,CAAC,CAAA,EAAG,CAAA,CAAE,KAAA,CAAM,EAAE,CAAE,CAAC,GAAG,CAAA,CAAE,KAAA,CAAM,EAAE,CAAE,CAAC,GAAG,CAAA,CAAE,KAAA,CAAM,EAAE,CAAE,CAAC,GAAG,CAAA,CAAE,KAAA,CAAM,EAAE,CAAE,CAAC,GAAG,CAAA,CAAE,KAAA,CAAM,EAAE,CAAE,CAAC,CAAA,CAAA;AACnQ;AAEA,IAAM,OAAA,GAAU,iEAAA;AAET,SAAS,uBAAuB,KAAA,EAAiC;AACtE,EAAA,OAAO,OAAO,KAAA,KAAU,QAAA,IAAY,OAAA,CAAQ,KAAK,KAAK,CAAA;AACxD;AAEA,SAAS,gBAAgB,QAAA,EAA8B;AACrD,EAAA,MAAM,GAAA,GAAM,QAAA,CAAS,OAAA,CAAQ,IAAA,EAAM,EAAE,CAAA;AACrC,EAAA,MAAM,KAAA,GAAQ,IAAI,UAAA,CAAW,EAAE,CAAA;AAC/B,EAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,EAAA,EAAI,CAAA,EAAA,EAAK;AAC3B,IAAA,KAAA,CAAM,CAAC,CAAA,GAAI,QAAA,CAAS,GAAA,CAAI,KAAA,CAAM,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,CAAA,GAAI,CAAC,CAAA,EAAG,EAAE,CAAA;AAAA,EACrD;AACA,EAAA,OAAO,KAAA;AACT;AAOO,IAAM,SAAA,GAAY;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMvB,MAAM,QAAA,EAAoD;AACxD,IAAA,IAAI,CAAC,sBAAA,CAAuB,QAAQ,CAAA,EAAG;AACrC,MAAA,OAAO;AAAA,QACL,EAAA,EAAI,KAAA;AAAA,QACJ,KAAA,EAAO,IAAI,SAAA,CAAU;AAAA,UACnB,IAAA,EAAM,qBAAA;AAAA,UACN,QAAA,EAAU,iCAAA;AAAA,UACV,IAAA,EAAM,kGAAA;AAAA,UACN,MAAA,EAAQ;AAAA,YACN,GAAA,EAAK,QAAA;AAAA,YACL,MAAA,EAAQ;AAAA;AACV,SACD;AAAA,OACH;AAAA,IACF;AACA,IAAA,OAAO,EAAE,IAAI,IAAA,EAAM,KAAA,EAAO,MAAM,eAAA,CAAgB,QAAQ,CAAC,CAAA,EAAE;AAAA,EAC7D,CAAA;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,IAAA,EAAyB;AAC9B,IAAA,OAAO,gBAAgB,IAAI,CAAA;AAAA,EAC7B,CAAA;AAAA;AAAA;AAAA;AAAA,EAKA,MAAA,CAAO,GAAc,CAAA,EAAuB;AAC1C,IAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,EAAA,EAAI,CAAA,EAAA,EAAK;AAC3B,MAAA,IAAI,EAAE,CAAC,CAAA,KAAM,CAAA,CAAE,CAAC,GAAG,OAAO,KAAA;AAAA,IAC5B;AACA,IAAA,OAAO,IAAA;AAAA,EACT,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAA,GAAoB;AAClB,IAAA,MAAM,OAAO,SAAA,EAAU;AACvB,IAAA,MAAM,KAAA,GAAQ,IAAI,UAAA,CAAW,EAAE,CAAA;AAC/B,IAAA,KAAA,CAAM,GAAA,CAAI,KAAK,KAAK,CAAA;AACpB,IAAA,OAAO,MAAM,KAAK,CAAA;AAAA,EACpB;AACF,CAAA;;;AC1FO,IAAM,2BAAA,GAA8B;AAAA,EACzC,MAAA;AAAA,EACA,UAAA;AAAA,EACA,OAAA;AAAA,EACA,SAAA;AAAA,EACA,UAAA;AAAA,EACA,SAAA;AAAA,EACA,MAAA;AAAA,EACA,iBAAA;AAAA,EACA,SAAA;AAAA,EACA,OAAA;AAAA,EACA,UAAA;AAAA,EACA,MAAA;AAAA,EACA,gBAAA;AAAA,EACA,iBAAA;AAAA,EACA,OAAA;AAAA,EACA;AACF;AAGO,IAAM,mCAAA,GAAsC;AAAA,EACjD,UAAA,EAAY,2BAAA;AAAA,EACZ,cAAA,EAAgB,IAAA;AAAA,EAChB,IAAA,EAAM,IAAA;AAAA,EACN,SAAA,EAAW,IAAA;AAAA,EACX,gBAAA,EAAkB,CAAC,eAAA,EAAiB,YAAA,EAAc,kBAAkB;AACtE;AAEO,SAAS,0BAA0B,KAAA,EAAiD;AACzF,EAAA,OAAQ,2BAAA,CAAkD,SAAS,KAAK,CAAA;AAC1E;AAgCA,SAAS,wBAAwB,KAAA,EAAoC;AACnE,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,EAAU,OAAO,KAAA;AACtC,EAAA,IAAI,QAAA,CAAS,KAAK,CAAA,IAAK,OAAO,MAAM,IAAA,KAAS,QAAA,SAAiB,KAAA,CAAM,IAAA;AACpE,EAAA,OAAO,MAAA;AACT;AAGO,SAAS,qCACd,UAAA,EACyC;AACzC,EAAA,OAAA,CAAQ,UAAA,IAAc,EAAC,EAAG,GAAA,CAAI,CAAC,SAAA,MAAe;AAAA,IAC5C,MAAM,SAAA,CAAU,IAAA;AAAA,IAChB,QAAQ,MAAA,CAAO,WAAA;AAAA,MACb,MAAA,CAAO,OAAA,CAAQ,SAAA,CAAU,MAAM,CAAA,CAAE,IAAI,CAAC,CAAC,SAAA,EAAW,KAAK,CAAA,KAAM;AAAA,QAC3D,SAAA;AAAA,QACA,wBAAwB,KAAK;AAAA,OAC9B;AAAA;AACH,GACF,CAAE,CAAA;AACJ;AA0PO,SAAS,oCAAA,CACd,IAAA,EACA,YAAA,GAAgC,SAAA,CAAe,MAAA,EACf;AAChC,EAAA,MAAM,QAAA,uBAAe,GAAA,EAQnB;AAEF,EAAA,eAAe,eACb,MAAA,EACqE;AACrE,IAAA,IAAI,CAAC,MAAA,CAAO,EAAA,EAAI,OAAO,MAAA;AACvB,IAAA,MAAM,YAAY,MAAM,IAAA,CAAK,OAAA,CAAQ,MAAA,CAAO,MAAM,UAAU,CAAA;AAC5D,IAAA,IAAI,CAAC,SAAA,CAAU,EAAA,EAAI,OAAO,SAAA;AAC1B,IAAA,OAAO,EAAA,CAAG;AAAA,MACR,UAAA,EAAY,OAAO,KAAA,CAAM,UAAA;AAAA,MACzB,QAAA,EAAU,UAAU,KAAA,CAAM,QAAA;AAAA,MAC1B,IAAA,EAAM,UAAU,KAAA,CAAM;AAAA,KACvB,CAAA;AAAA,EACH;AAEA,EAAA,eAAe,SACb,SAAA,EAC+F;AAC/F,IAAA,QAAQ,UAAU,IAAA;AAAM,MACtB,KAAK,WAAA,EAAa;AAChB,QAAA,MAAM,SAAA,GAAY,MAAM,IAAA,CAAK,SAAA,CAAU,UAAU,UAAU,CAAA;AAC3D,QAAA,OAAO,SAAA,CAAU,EAAA,GACb,EAAA,CAAG,EAAE,UAAA,EAAY,SAAA,CAAU,UAAA,EAAY,GAAG,SAAA,CAAU,KAAA,EAAO,CAAA,GAC3D,SAAA;AAAA,MACN;AAAA,MACA,KAAK,cAAA,EAAgB;AACnB,QAAA,MAAM,SAAA,GAAY,MAAM,IAAA,CAAK,OAAA,CAAQ,UAAU,UAAU,CAAA;AACzD,QAAA,OAAO,SAAA,CAAU,EAAA,GACb,EAAA,CAAG,EAAE,UAAA,EAAY,SAAA,CAAU,UAAA,EAAY,GAAG,SAAA,CAAU,KAAA,EAAO,CAAA,GAC3D,SAAA;AAAA,MACN;AAAA,MACA,KAAK,SAAA;AAAA,MACL,KAAK,WAAA,EAAa;AAChB,QAAA,MAAM,SAAA,GAAY,MAAM,IAAA,CAAK,SAAA,CAAU,UAAU,UAAU,CAAA;AAC3D,QAAA,IAAI,CAAC,SAAA,CAAU,EAAA,EAAI,OAAO,SAAA;AAC1B,QAAA,IACE,UAAU,gBAAA,KAAqB,MAAA,IAC/B,UAAU,gBAAA,KAAqB,SAAA,CAAU,MAAM,QAAA,EAC/C;AACA,UAAA,OAAO,GAAA,CAAI;AAAA,YACT,IAAA,EAAM,+BAAA;AAAA,YACN,UAAU,SAAA,CAAU,gBAAA;AAAA,YACpB,MAAA,EAAQ,UAAU,KAAA,CAAM,QAAA;AAAA,YACxB,IAAA,EAAM,gFAAA;AAAA,YACN,SAAA,EAAW,IAAA;AAAA,YACX,eAAA,EAAiB,CAAC,iBAAA,EAAmB,iBAAiB,CAAA;AAAA,YACtD,QAAQ,EAAE,SAAA,EAAW,UAAU,SAAA,EAAW,UAAA,EAAY,UAAU,UAAA;AAAW,WAC5E,CAAA;AAAA,QACH;AACA,QAAA,MAAM,UAAU,MAAM,IAAA,CAAK,QAAQ,SAAA,CAAU,UAAA,EAAY,UAAU,IAAI,CAAA;AACvE,QAAA,OAAO,OAAA,CAAQ,EAAA,GAAK,EAAA,CAAG,EAAE,UAAA,EAAY,SAAA,CAAU,UAAA,EAAY,GAAG,OAAA,CAAQ,KAAA,EAAO,CAAA,GAAI,OAAA;AAAA,MACnF;AAAA,MACA,KAAK,wBAAA;AACH,QAAA,OAAO,cAAA;AAAA,UACL,MAAM,KAAK,MAAA,CAAO;AAAA,YAChB,GAAG,SAAA;AAAA,YACH,WAAW,YAAA,EAAa;AAAA,YACxB,eAAe,EAAE,GAAG,UAAU,aAAA,EAAe,IAAA,EAAM,cAAa;AAAE,WACnE;AAAA,SACH;AAAA,MACF,KAAK,YAAA;AACH,QAAA,OAAO,cAAA,CAAe,MAAM,IAAA,CAAK,MAAA,CAAO,EAAE,GAAG,SAAA,EAAW,IAAA,EAAM,YAAA,EAAa,EAAG,CAAC,CAAA;AAAA,MACjF,KAAK,uBAAA,EAAyB;AAC5B,QAAA,MAAM,SAAA,GAAY,MAAM,IAAA,CAAK,OAAA,CAAQ,UAAU,UAAU,CAAA;AACzD,QAAA,IAAI,CAAC,SAAA,CAAU,EAAA,EAAI,OAAO,SAAA;AAC1B,QAAA,MAAM,cAAc,MAAA,CAAO,WAAA;AAAA,UACzB,SAAA,CAAU,KAAA,CAAM,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,CAAC,KAAA,KAAU,CAAC,KAAA,CAAM,SAAA,EAAW,YAAA,EAAc,CAAC;AAAA,SACjF;AACA,QAAA,OAAO,cAAA;AAAA,UACL,MAAM,KAAK,MAAA,CAAO;AAAA,YAChB,GAAG,SAAA;AAAA,YACH,WAAW,YAAA,EAAa;AAAA,YACxB;AAAA,WACD;AAAA,SACH;AAAA,MACF;AAAA,MACA,KAAK,oBAAA;AAAA,MACL,KAAK,gBAAA;AAAA,MACL,KAAK,eAAA;AACH,QAAA,OAAO,cAAA,CAAe,MAAM,IAAA,CAAK,MAAA,CAAO,SAAS,CAAC,CAAA;AAAA;AACtD,EACF;AAEA,EAAA,OAAO;AAAA,IACL,QAAQ,SAAA,EAAW;AACjB,MAAA,IAAI,SAAA,CAAU,SAAA,CAAU,IAAA,EAAK,CAAE,WAAW,CAAA,EAAG;AAC3C,QAAA,OAAO,OAAA,CAAQ,OAAA;AAAA,UACb,GAAA,CAAI;AAAA,YACF,IAAA,EAAM,iCAAA;AAAA,YACN,QAAA,EAAU,qCAAA;AAAA,YACV,QAAQ,SAAA,CAAU,SAAA;AAAA,YAClB,IAAA,EAAM,mDAAA;AAAA,YACN,SAAA,EAAW,IAAA;AAAA,YACX,eAAA,EAAiB,CAAC,iBAAiB,CAAA;AAAA,YACnC,QAAQ,EAAE,SAAA,EAAW,UAAU,SAAA,EAAW,UAAA,EAAY,UAAU,UAAA;AAAW,WAC5E;AAAA,SACH;AAAA,MACF;AACA,MAAA,MAAM,WAAA,GAAc,IAAA,CAAK,SAAA,CAAU,SAAS,CAAA;AAC5C,MAAA,MAAM,KAAA,GAAQ,QAAA,CAAS,GAAA,CAAI,SAAA,CAAU,SAAS,CAAA;AAC9C,MAAA,IAAI,UAAU,MAAA,EAAW;AACvB,QAAA,IAAI,KAAA,CAAM,WAAA,KAAgB,WAAA,EAAa,OAAO,KAAA,CAAM,MAAA;AACpD,QAAA,OAAO,OAAA,CAAQ,OAAA;AAAA,UACb,GAAA,CAAI;AAAA,YACF,IAAA,EAAM,iCAAA;AAAA,YACN,QAAA,EAAU,uCAAA;AAAA,YACV,QAAQ,SAAA,CAAU,IAAA;AAAA,YAClB,IAAA,EAAM,4DAAA;AAAA,YACN,SAAA,EAAW,KAAA;AAAA,YACX,eAAA,EAAiB,CAAC,oBAAA,EAAsB,iBAAiB,CAAA;AAAA,YACzD,QAAQ,EAAE,SAAA,EAAW,UAAU,SAAA,EAAW,UAAA,EAAY,UAAU,UAAA;AAAW,WAC5E;AAAA,SACH;AAAA,MACF;AACA,MAAA,MAAM,MAAA,GAAS,SAAS,SAAS,CAAA;AACjC,MAAA,QAAA,CAAS,IAAI,SAAA,CAAU,SAAA,EAAW,EAAE,WAAA,EAAa,QAAQ,CAAA;AACzD,MAAA,OAAO,MAAA;AAAA,IACT;AAAA,GACF;AACF;AAEA,IAAM,iCAAA,GAAoC;AAAA,EACxC,IAAA,EAAM,QAAA;AAAA,EACN,SAAA,EAAW,CAAA;AAAA,EACX,SAAA,EAAW,GAAA;AAAA,EACX,OAAA,EAAS,qCAAA;AAAA,EACT,WAAA,EAAa;AACf,CAAA;AACA,IAAM,kCAAA,GAAqC;AAAA,EACzC,IAAA,EAAM,QAAA;AAAA,EACN,SAAA,EAAW,CAAA;AAAA,EACX,OAAA,EAAS,sBAAA;AAAA,EACT,WAAA,EAAa;AACf,CAAA;AACA,IAAM,iCAAA,GAAoC;AAAA,EACxC,IAAA,EAAM,QAAA;AAAA,EACN,MAAA,EAAQ,MAAA;AAAA,EACR,WAAA,EAAa;AACf,CAAA;AACA,IAAM,+BAAA,GAAkC;AAAA,EACtC,IAAA,EAAM,QAAA;AAAA,EACN,SAAA,EAAW,EAAA;AAAA,EACX,SAAA,EAAW,EAAA;AAAA,EACX,OAAA,EAAS,gBAAA;AAAA,EACT,WAAA,EAAa;AACf,CAAA;AACA,IAAM,iCAAA,GAAoC,EAAE,IAAA,EAAM,QAAA,EAAU,WAAW,CAAA,EAAE;AACzE,IAAM,iCAAA,GAAoC;AAAA,EACxC,IAAA,EAAM,2BAAA;AAAA,EACN,WAAA,EAAa;AACf,CAAA;AACA,IAAM,2BAAA,GAA8B,EAAE,IAAA,EAAM,QAAA,EAAU,WAAW,CAAA,EAAE;AAEnE,SAAS,wBAAA,CACP,UAAA,EACA,QAAA,EACA,OAAA,GAA0E,EAAC,EAC3E;AACA,EAAA,MAAM,eAAA,GAAkB,CAAC,WAAA,EAAa,GAAG,QAAQ,CAAA;AACjD,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,QAAA;AAAA,IACN,UAAA,EAAY;AAAA,MACV,UAAA,EAAY,kCAAA;AAAA,MACZ,SAAA,EAAW,iCAAA;AAAA,MACX,SAAA,EAAW,iCAAA;AAAA,MACX,GAAG;AAAA,KACL;AAAA,IACA,QAAA,EAAU,eAAA;AAAA,IACV,GAAI,OAAA,CAAQ,OAAA,KAAY,KAAA,GACpB,EAAC,GACD;AAAA,MACE,KAAA,EAAO;AAAA,QACL,EAAE,QAAA,EAAU,CAAC,GAAG,eAAA,EAAiB,YAAY,CAAA,EAAE;AAAA,QAC/C,EAAE,QAAA,EAAU,CAAC,GAAG,eAAA,EAAiB,WAAW,CAAA,EAAE;AAAA,QAC9C,GAAI,OAAA,CAAQ,WAAA,KAAgB,KAAA,GAAQ,EAAC,GAAI,CAAC,EAAE,QAAA,EAAU,CAAC,GAAG,eAAA,EAAiB,MAAM,GAAG;AAAA;AACtF,KACF;AAAA,IACJ,oBAAA,EAAsB;AAAA,GACxB;AACF;AAEO,IAAM,sCAAA,GAAyC;AAAA,EACpD;AAAA,IACE,EAAA,EAAI,qBAAA;AAAA,IACJ,IAAA,EAAM,QAAA;AAAA,IACN,MAAA,EAAQ,SAAA;AAAA,IACR,KAAA,EAAO,qBAAA;AAAA,IACP,UAAA,EAAY,wBAAA;AAAA,MACV;AAAA,QACE,IAAA,EAAM,2BAAA;AAAA,QACN,aAAA,EAAe;AAAA,UACb,IAAA,EAAM,QAAA;AAAA,UACN,UAAA,EAAY;AAAA,YACV,SAAA,EAAW,iCAAA;AAAA,YACX,IAAA,EAAM,iCAAA;AAAA,YACN,IAAA,EAAM;AAAA,WACR;AAAA,UACA,QAAA,EAAU,CAAC,WAAA,EAAa,MAAM,CAAA;AAAA,UAC9B,oBAAA,EAAsB;AAAA;AACxB,OACF;AAAA,MACA,CAAC,cAAc,eAAe,CAAA;AAAA,MAC9B,EAAE,SAAS,KAAA;AAAM;AACnB,GACF;AAAA,EACA;AAAA,IACE,EAAA,EAAI,yBAAA;AAAA,IACJ,IAAA,EAAM,YAAA;AAAA,IACN,MAAA,EAAQ,SAAA;AAAA,IACR,KAAA,EAAO,yBAAA;AAAA,IACP,UAAA,EAAY,wBAAA;AAAA,MACV;AAAA,QACE,SAAA,EAAW,iCAAA;AAAA,QACX,SAAA,EAAW,iCAAA;AAAA,QACX,IAAA,EAAM,2BAAA;AAAA,QACN,gBAAA,EAAkB;AAAA,OACpB;AAAA,MACA,CAAC,WAAA,EAAa,WAAA,EAAa,kBAAkB;AAAA;AAC/C,GACF;AAAA,EACA;AAAA,IACE,EAAA,EAAI,iCAAA;AAAA,IACJ,IAAA,EAAM,oBAAA;AAAA,IACN,MAAA,EAAQ,SAAA;AAAA,IACR,KAAA,EAAO,iCAAA;AAAA,IACP,UAAA,EAAY,wBAAA;AAAA,MACV;AAAA,QACE,KAAA,EAAO,iCAAA;AAAA,QACP,IAAA,EAAM,EAAE,IAAA,EAAM,QAAA,EAAU,QAAQ,MAAA,EAAO;AAAA,QACvC,gBAAA,EAAkB;AAAA,OACpB;AAAA,MACA,CAAC,OAAA,EAAS,MAAA,EAAQ,kBAAkB,CAAA;AAAA,MACpC,EAAE,aAAa,KAAA;AAAM;AACvB,GACF;AAAA,EACA;AAAA,IACE,EAAA,EAAI,qBAAA;AAAA,IACJ,IAAA,EAAM,QAAA;AAAA,IACN,MAAA,EAAQ,SAAA;AAAA,IACR,KAAA,EAAO,kCAAA;AAAA,IACP,UAAA,EAAY,wBAAA;AAAA,MACV;AAAA,QACE,MAAA,EAAQ;AAAA,UACN,KAAA,EAAO;AAAA,YACL;AAAA,cACE,IAAA,EAAM,QAAA;AAAA,cACN,YAAY,EAAE,IAAA,EAAM,EAAE,KAAA,EAAO,WAAU,EAAE;AAAA,cACzC,QAAA,EAAU,CAAC,MAAM,CAAA;AAAA,cACjB,oBAAA,EAAsB;AAAA,aACxB;AAAA,YACA;AAAA,cACE,IAAA,EAAM,QAAA;AAAA,cACN,UAAA,EAAY;AAAA,gBACV,IAAA,EAAM,EAAE,KAAA,EAAO,QAAA,EAAS;AAAA,gBACxB,SAAA,EAAW;AAAA,eACb;AAAA,cACA,QAAA,EAAU,CAAC,MAAA,EAAQ,WAAW,CAAA;AAAA,cAC9B,oBAAA,EAAsB;AAAA;AACxB;AACF,SACF;AAAA,QACA,IAAA,EAAM,2BAAA;AAAA,QACN,gBAAA,EAAkB;AAAA,OACpB;AAAA,MACA,CAAC,QAAA,EAAU,MAAA,EAAQ,kBAAkB;AAAA;AACvC,GACF;AAAA,EACA;AAAA,IACE,EAAA,EAAI,4BAAA;AAAA,IACJ,IAAA,EAAM,eAAA;AAAA,IACN,MAAA,EAAQ,SAAA;AAAA,IACR,KAAA,EAAO,4BAAA;AAAA,IACP,WAAA,EAAa,IAAA;AAAA,IACb,UAAA,EAAY,wBAAA;AAAA,MACV;AAAA,QACE,SAAA,EAAW,iCAAA;AAAA,QACX,mBAAA,EAAqB,EAAE,IAAA,EAAM,OAAA,EAAS,OAAO,EAAE,IAAA,EAAM,UAAS,EAAE;AAAA,QAChE,gBAAA,EAAkB;AAAA,OACpB;AAAA,MACA,CAAC,aAAa,kBAAkB;AAAA;AAClC,GACF;AAAA,EACA;AAAA,IACE,EAAA,EAAI,oBAAA;AAAA,IACJ,IAAA,EAAM,OAAA;AAAA,IACN,MAAA,EAAQ,SAAA;AAAA,IACR,KAAA,EAAO,oBAAA;AAAA,IACP,UAAA,EAAY,wBAAA;AAAA,MACV;AAAA,QACE,UAAA,EAAY,kCAAA;AAAA,QACZ,gBAAA,EAAkB;AAAA,OACpB;AAAA,MACA,CAAC,cAAc,kBAAkB;AAAA;AACnC,GACF;AAAA,EACA;AAAA,IACE,EAAA,EAAI,sBAAA;AAAA,IACJ,IAAA,EAAM,SAAA;AAAA,IACN,MAAA,EAAQ,SAAA;AAAA,IACR,KAAA,EAAO,sBAAA;AAAA,IACP,UAAA,EAAY,wBAAA,CAAyB,EAAE,gBAAA,EAAkB,iCAAgC,EAAG;AAAA,MAC1F;AAAA,KACD;AAAA,GACH;AAAA,EACA;AAAA,IACE,EAAA,EAAI,wBAAA;AAAA,IACJ,IAAA,EAAM,WAAA;AAAA,IACN,MAAA,EAAQ,SAAA;AAAA,IACR,KAAA,EAAO,wBAAA;AAAA,IACP,UAAA,EAAY,wBAAA,CAAyB,EAAE,gBAAA,EAAkB,iCAAgC,EAAG;AAAA,MAC1F;AAAA,KACD;AAAA;AAEL;AAyEA,SAAS,OAAO,KAAA,EAAwB;AACtC,EAAA,IAAI,KAAA,KAAU,MAAM,OAAO,MAAA;AAC3B,EAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,EAAG,OAAO,OAAA;AACjC,EAAA,IAAI,YAAY,MAAA,CAAO,KAAK,CAAA,EAAG,OAAO,MAAM,WAAA,CAAY,IAAA;AACxD,EAAA,OAAO,OAAO,KAAA;AAChB;AAEA,SAAS,OAAA,CACP,YAAA,EACA,QAAA,EACA,KAAA,EACA,UAAA,EACoC;AACpC,EAAA,OAAO,GAAA,CAAI;AAAA,IACT,IAAA,EAAM,gCAAA;AAAA,IACN,QAAA;AAAA,IACA,IAAA,EAAM,gFAAA;AAAA,IACN,MAAA,EAAQ;AAAA,MACN,GAAI,UAAA,KAAe,MAAA,GAAY,EAAC,GAAI,EAAE,UAAA,EAAW;AAAA,MACjD,YAAA;AAAA,MACA,MAAA,EAAQ,OAAO,KAAK;AAAA;AACtB,GACD,CAAA;AACH;AAEO,SAAS,SAAS,KAAA,EAAkD;AACzE,EAAA,OAAO,KAAA,KAAU,QAAQ,OAAO,KAAA,KAAU,YAAY,CAAC,KAAA,CAAM,QAAQ,KAAK,CAAA;AAC5E;AAEA,SAAS,YAAY,KAAA,EAAoC;AACvD,EAAA,OAAO,KAAA,YAAiB,UAAA,IAAc,KAAA,CAAM,UAAA,KAAe,EAAA;AAC7D;AAEA,SAAS,QAAQ,IAAA,EAAyB;AACxC,EAAA,OAAO,SAAA,CAAe,OAAO,IAAI,CAAA;AACnC;AAEA,SAAS,iBACP,UAAA,EACoC;AACpC,EAAA,MAAM,SAAS,MAAA,CAAO,WAAA;AAAA,IACpB,MAAA,CAAO,OAAA,CAAQ,UAAA,CAAW,MAAM,CAAA,CAAE,IAAI,CAAC,CAAC,SAAA,EAAW,UAAU,CAAA,KAAM;AAAA,MACjE,SAAA;AAAA,MACA,MAAA,CAAO,MAAA,CAAO,EAAE,GAAG,UAAA,EAAY,MAAM,UAAA,CAAW,IAAA,CAAK,KAAA,EAAM,EAAgB;AAAA,KAC5E;AAAA,GACH;AACA,EAAA,MAAM,iBAAiB,MAAA,CAAO,WAAA;AAAA,IAC5B,MAAA,CAAO,OAAA,CAAQ,UAAA,CAAW,cAAc,CAAA,CAAE,IAAI,CAAC,CAAC,KAAA,EAAO,IAAI,CAAA,KAAM;AAAA,MAC/D,KAAA;AAAA,MACA,KAAK,KAAA;AAAM,KACZ;AAAA,GACH;AACA,EAAA,MAAM,eAAA,GACJ,UAAA,CAAW,eAAA,KAAoB,MAAA,GAC3B,SACA,MAAA,CAAO,MAAA;AAAA,IACL,oCAAA,CAAqC,UAAA,CAAW,eAAe,CAAA,CAAE,GAAA;AAAA,MAAI,CAAC,SAAA,KACpE,MAAA,CAAO,MAAA,CAAO;AAAA,QACZ,GAAG,SAAA;AAAA,QACH,QAAQ,MAAA,CAAO,MAAA,CAAO,EAAE,GAAG,SAAA,CAAU,QAAQ;AAAA,OAC9C;AAAA;AACH,GACF;AACN,EAAA,OAAO,OAAO,MAAA,CAAO;AAAA,IACnB,GAAG,UAAA;AAAA,IACH,SAAA,EAAW,UAAA,CAAW,SAAA,CAAU,KAAA,EAAM;AAAA,IACtC,MAAA,EAAQ,MAAA,CAAO,MAAA,CAAO,MAAM,CAAA;AAAA,IAC5B,cAAA,EAAgB,MAAA,CAAO,MAAA,CAAO,cAAc,CAAA;AAAA,IAC5C,GAAI,eAAA,KAAoB,MAAA,GAAY,EAAC,GAAI,EAAE,eAAA;AAAgB,GAC5D,CAAA;AACH;AAEO,SAAS,gCAAA,CACd,OACA,UAAA,EACiE;AACjE,EAAA,IAAI,CAAC,SAAS,KAAK,CAAA;AACjB,IAAA,OAAO,OAAA,CAAQ,GAAA,EAAK,oCAAA,EAAsC,KAAA,EAAO,UAAU,CAAA;AAC7E,EAAA,IAAI,KAAA,CAAM,kBAAkB,OAAA,EAAS;AACnC,IAAA,OAAO,OAAA,CAAQ,iBAAA,EAAmB,qBAAA,EAAuB,KAAA,CAAM,eAAe,UAAU,CAAA;AAAA,EAC1F;AACA,EAAA,IAAI,CAAC,WAAA,CAAY,KAAA,CAAM,SAAS,CAAA,EAAG;AACjC,IAAA,OAAO,OAAA,CAAQ,aAAA,EAAe,qBAAA,EAAuB,KAAA,CAAM,WAAW,UAAU,CAAA;AAAA,EAClF;AACA,EAAA,IAAI,MAAM,IAAA,KAAS,MAAA,IAAa,OAAO,KAAA,CAAM,SAAS,QAAA,EAAU;AAC9D,IAAA,OAAO,OAAA,CAAQ,QAAA,EAAU,uBAAA,EAAyB,KAAA,CAAM,MAAM,UAAU,CAAA;AAAA,EAC1E;AACA,EAAA,IAAI,CAAC,QAAA,CAAS,KAAA,CAAM,MAAM,CAAA,IAAK,MAAA,CAAO,IAAA,CAAK,KAAA,CAAM,MAAM,CAAA,CAAE,MAAA,KAAW,CAAA,EAAG;AACrE,IAAA,OAAO,OAAA;AAAA,MACL,UAAA;AAAA,MACA,4CAAA;AAAA,MACA,KAAA,CAAM,MAAA;AAAA,MACN;AAAA,KACF;AAAA,EACF;AACA,EAAA,IAAI,CAAC,QAAA,CAAS,KAAA,CAAM,cAAc,CAAA,EAAG;AACnC,IAAA,OAAO,OAAA;AAAA,MACL,kBAAA;AAAA,MACA,8BAAA;AAAA,MACA,KAAA,CAAM,cAAA;AAAA,MACN;AAAA,KACF;AAAA,EACF;AACA,EAAA,IAAI,KAAA,CAAM,oBAAoB,MAAA,EAAW;AACvC,IAAA,IAAI,CAAC,KAAA,CAAM,OAAA,CAAQ,KAAA,CAAM,eAAe,CAAA,EAAG;AACzC,MAAA,OAAO,OAAA;AAAA,QACL,mBAAA;AAAA,QACA,kEAAA;AAAA,QACA,KAAA,CAAM,eAAA;AAAA,QACN;AAAA,OACF;AAAA,IACF;AACA,IAAA,MAAM,cAAA,uBAAqB,GAAA,EAAY;AACvC,IAAA,KAAA,MAAW,CAAC,cAAA,EAAgB,SAAS,KAAK,KAAA,CAAM,eAAA,CAAgB,SAAQ,EAAG;AACzE,MAAA,IAAI,CAAC,QAAA,CAAS,SAAS,CAAA,EAAG;AACxB,QAAA,OAAO,OAAA;AAAA,UACL,qBAAqB,cAAc,CAAA,CAAA,CAAA;AAAA,UACnC,yCAAA;AAAA,UACA,SAAA;AAAA,UACA;AAAA,SACF;AAAA,MACF;AACA,MAAA,IAAI,OAAO,UAAU,IAAA,KAAS,QAAA,IAAY,UAAU,IAAA,CAAK,IAAA,EAAK,CAAE,MAAA,KAAW,CAAA,EAAG;AAC5E,QAAA,OAAO,OAAA;AAAA,UACL,qBAAqB,cAAc,CAAA,MAAA,CAAA;AAAA,UACnC,4BAAA;AAAA,UACA,SAAA,CAAU,IAAA;AAAA,UACV;AAAA,SACF;AAAA,MACF;AACA,MAAA,IAAI,cAAA,CAAe,GAAA,CAAI,SAAA,CAAU,IAAI,CAAA,EAAG;AACtC,QAAA,OAAO,OAAA;AAAA,UACL,qBAAqB,cAAc,CAAA,MAAA,CAAA;AAAA,UACnC,wDAAA;AAAA,UACA,SAAA,CAAU,IAAA;AAAA,UACV;AAAA,SACF;AAAA,MACF;AACA,MAAA,cAAA,CAAe,GAAA,CAAI,UAAU,IAAI,CAAA;AACjC,MAAA,IAAI,CAAC,QAAA,CAAS,SAAA,CAAU,MAAM,CAAA,EAAG;AAC/B,QAAA,OAAO,OAAA;AAAA,UACL,qBAAqB,cAAc,CAAA,QAAA,CAAA;AAAA,UACnC,oCAAA;AAAA,UACA,SAAA,CAAU,MAAA;AAAA,UACV;AAAA,SACF;AAAA,MACF;AACA,MAAA,KAAA,MAAW,CAAC,WAAW,KAAK,CAAA,IAAK,OAAO,OAAA,CAAQ,SAAA,CAAU,MAAM,CAAA,EAAG;AACjE,QAAA,MAAM,IAAA,GAAO,wBAAwB,KAAK,CAAA;AAC1C,QAAA,IAAI,SAAA,CAAU,IAAA,EAAK,CAAE,MAAA,KAAW,CAAA,IAAK,IAAA,KAAS,MAAA,IAAa,IAAA,CAAK,IAAA,EAAK,CAAE,MAAA,KAAW,CAAA,EAAG;AACnF,UAAA,OAAO,OAAA;AAAA,YACL,qBAAqB,cAAc,CAAA,QAAA,CAAA;AAAA,YACnC,gDAAA;AAAA,YACA,KAAA;AAAA,YACA;AAAA,WACF;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACA,EAAA,IAAI,OAAO,KAAA,CAAM,KAAA,KAAU,UAAA,EAAY;AACrC,IAAA,OAAO,OAAA,CAAQ,SAAA,EAAW,+BAAA,EAAiC,KAAA,CAAM,OAAO,UAAU,CAAA;AAAA,EACpF;AAEA,EAAA,MAAM,WAAA,GAAc,OAAA,CAAQ,KAAA,CAAM,SAAS,CAAA;AAC3C,EAAA,MAAM,UAAA,uBAAiB,GAAA,EAAY;AACnC,EAAA,KAAA,MAAW,CAAC,WAAW,UAAU,CAAA,IAAK,OAAO,OAAA,CAAQ,KAAA,CAAM,MAAM,CAAA,EAAG;AAClE,IAAA,IAAI,SAAA,CAAU,IAAA,EAAK,CAAE,MAAA,KAAW,CAAA,EAAG;AACjC,MAAA,OAAO,OAAA,CAAQ,UAAA,EAAY,iCAAA,EAAmC,SAAA,EAAW,UAAU,CAAA;AAAA,IACrF;AACA,IAAA,IAAI,CAAC,QAAA,CAAS,UAAU,CAAA,EAAG;AACzB,MAAA,OAAO,OAAA;AAAA,QACL,CAAA,SAAA,EAAY,IAAA,CAAK,SAAA,CAAU,SAAS,CAAC,CAAA,CAAA,CAAA;AAAA,QACrC,qBAAA;AAAA,QACA,UAAA;AAAA,QACA;AAAA,OACF;AAAA,IACF;AACA,IAAA,IAAI,CAAC,WAAA,CAAY,UAAA,CAAW,IAAI,CAAA,EAAG;AACjC,MAAA,OAAO,OAAA;AAAA,QACL,CAAA,SAAA,EAAY,IAAA,CAAK,SAAA,CAAU,SAAS,CAAC,CAAA,MAAA,CAAA;AAAA,QACrC,qBAAA;AAAA,QACA,UAAA,CAAW,IAAA;AAAA,QACX;AAAA,OACF;AAAA,IACF;AACA,IAAA,IAAI,OAAO,WAAW,IAAA,KAAS,QAAA,IAAY,CAAC,yBAAA,CAA0B,UAAA,CAAW,IAAI,CAAA,EAAG;AACtF,MAAA,OAAO,OAAA;AAAA,QACL,CAAA,SAAA,EAAY,IAAA,CAAK,SAAA,CAAU,SAAS,CAAC,CAAA,MAAA,CAAA;AAAA,QACrC,oCAAA;AAAA,QACA,UAAA,CAAW,IAAA;AAAA,QACX;AAAA,OACF;AAAA,IACF;AACA,IAAA,IAAI,WAAW,IAAA,KAAS,MAAA,IAAa,OAAO,UAAA,CAAW,SAAS,QAAA,EAAU;AACxE,MAAA,OAAO,OAAA;AAAA,QACL,CAAA,SAAA,EAAY,IAAA,CAAK,SAAA,CAAU,SAAS,CAAC,CAAA,MAAA,CAAA;AAAA,QACrC,uBAAA;AAAA,QACA,UAAA,CAAW,IAAA;AAAA,QACX;AAAA,OACF;AAAA,IACF;AACA,IAAA,MAAM,IAAA,GAAO,OAAA,CAAQ,UAAA,CAAW,IAAI,CAAA;AACpC,IAAA,IAAI,IAAA,KAAS,WAAA,IAAe,UAAA,CAAW,GAAA,CAAI,IAAI,CAAA,EAAG;AAChD,MAAA,OAAO,OAAA;AAAA,QACL,CAAA,SAAA,EAAY,IAAA,CAAK,SAAA,CAAU,SAAS,CAAC,CAAA,MAAA,CAAA;AAAA,QACrC,8DAAA;AAAA,QACA,UAAA,CAAW,IAAA;AAAA,QACX;AAAA,OACF;AAAA,IACF;AACA,IAAA,UAAA,CAAW,IAAI,IAAI,CAAA;AAAA,EACrB;AAEA,EAAA,MAAM,aAAA,uBAAoB,GAAA,EAAY;AACtC,EAAA,KAAA,MAAW,CAAC,OAAO,SAAS,CAAA,IAAK,OAAO,OAAA,CAAQ,KAAA,CAAM,cAAc,CAAA,EAAG;AACrE,IAAA,IAAI,KAAA,CAAM,IAAA,EAAK,CAAE,MAAA,KAAW,CAAA,EAAG;AAC7B,MAAA,OAAO,OAAA,CAAQ,kBAAA,EAAoB,6BAAA,EAA+B,KAAA,EAAO,UAAU,CAAA;AAAA,IACrF;AACA,IAAA,IAAI,CAAC,WAAA,CAAY,SAAS,CAAA,EAAG;AAC3B,MAAA,OAAO,OAAA;AAAA,QACL,CAAA,iBAAA,EAAoB,IAAA,CAAK,SAAA,CAAU,KAAK,CAAC,CAAA,CAAA,CAAA;AAAA,QACzC,qBAAA;AAAA,QACA,SAAA;AAAA,QACA;AAAA,OACF;AAAA,IACF;AACA,IAAA,MAAM,IAAA,GAAO,QAAQ,SAAS,CAAA;AAC9B,IAAA,IAAI,IAAA,KAAS,eAAe,UAAA,CAAW,GAAA,CAAI,IAAI,CAAA,IAAK,aAAA,CAAc,GAAA,CAAI,IAAI,CAAA,EAAG;AAC3E,MAAA,OAAO,OAAA;AAAA,QACL,CAAA,iBAAA,EAAoB,IAAA,CAAK,SAAA,CAAU,KAAK,CAAC,CAAA,CAAA,CAAA;AAAA,QACzC,iDAAA;AAAA,QACA,SAAA;AAAA,QACA;AAAA,OACF;AAAA,IACF;AACA,IAAA,aAAA,CAAc,IAAI,IAAI,CAAA;AAAA,EACxB;AAEA,EAAA,OAAO,EAAA,CAAG,gBAAA,CAAiB,KAA4C,CAAC,CAAA;AAC1E;AAEO,SAAS,yBAAA,CACd,YACA,MAAA,EACwB;AACxB,EAAA,MAAM,SAAA,GAAY,MAAA,CAAO,OAAA,CAAQ,UAAA,CAAW,MAAM,EAC/C,IAAA,CAAK,CAAC,CAAC,IAAI,CAAA,EAAG,CAAC,KAAK,CAAA,KAAM,IAAA,CAAK,aAAA,CAAc,KAAK,CAAC,CAAA,CACnD,GAAA,CAAI,CAAC,CAAC,SAAA,EAAW,UAAU,CAAA,EAAG,WAAA,MAAiB;AAAA,IAC9C,IAAA,EAAM,OAAA,CAAQ,UAAA,CAAW,IAAI,CAAA;AAAA,IAC7B,WAAA;AAAA,IACA,SAAA;AAAA,IACA,MAAM,UAAA,CAAW,IAAA;AAAA,IACjB,GAAI,WAAW,IAAA,KAAS,MAAA,GAAY,EAAC,GAAI,EAAE,IAAA,EAAM,UAAA,CAAW,IAAA;AAAK,GACnE,CAAE,CAAA;AACJ,EAAA,MAAM,cAAA,GAAiB,MAAA,CAAO,OAAA,CAAQ,UAAA,CAAW,cAAc,CAAA,CAC5D,IAAA,CAAK,CAAC,CAAC,IAAI,CAAA,EAAG,CAAC,KAAK,CAAA,KAAM,IAAA,CAAK,aAAA,CAAc,KAAK,CAAC,CAAA,CACnD,GAAA,CAAI,CAAC,CAAC,KAAA,EAAO,IAAI,CAAA,MAAO,EAAE,KAAA,EAAO,IAAA,EAAM,OAAA,CAAQ,IAAI,GAAE,CAAE,CAAA;AAC1D,EAAA,OAAO;AAAA,IACL,aAAA,EAAe,OAAA;AAAA,IACf,IAAA,EAAM,wBAAA;AAAA,IACN,SAAA,EAAW,OAAA,CAAQ,UAAA,CAAW,SAAS,CAAA;AAAA,IACvC,GAAI,WAAW,IAAA,KAAS,MAAA,GAAY,EAAC,GAAI,EAAE,IAAA,EAAM,UAAA,CAAW,IAAA,EAAK;AAAA,IACjE,QAAA,EAAU,SAAA;AAAA,IACV,MAAA;AAAA,IACA,cAAA,EAAgB,EAAE,eAAA,EAAiB,OAAA,EAAS,cAAA,EAAe;AAAA,IAC3D;AAAA,GACF;AACF","file":"scriptable-pack.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","import type { Asset, AssetGuid, AssetPublicationEnvelope, Result } from '@forgeax/engine-types';\nimport { err, ok } from '@forgeax/engine-types';\nimport { AssetGuid as AssetGuidCodec } from './guid.js';\n\n/** Closed ordinary kind vocabulary shared by authoring, producers, and loaders. */\nexport type ScriptablePackAssetKind = Asset['kind'];\n\n/** Complete ordinary Asset kind vocabulary exposed by ScriptablePack discovery. */\nexport const SCRIPTABLE_PACK_ASSET_KINDS = [\n 'mesh',\n 'material',\n 'scene',\n 'texture',\n 'equirect',\n 'sampler',\n 'font',\n 'render-pipeline',\n 'tileset',\n 'video',\n 'skeleton',\n 'skin',\n 'animation-clip',\n 'animation-graph',\n 'audio',\n 'particle-effect',\n] as const satisfies readonly ScriptablePackAssetKind[];\n\n/** Machine-readable producer/loader floor owned by engine-pack. */\nexport const SCRIPTABLE_PACK_CAPABILITY_MANIFEST = {\n assetKinds: SCRIPTABLE_PACK_ASSET_KINDS,\n durablePayload: true,\n refs: true,\n artifacts: true,\n hostCapabilities: ['audio-install', 'video-play', 'particle-execute'] as const,\n} as const;\n\nexport function isScriptablePackAssetKind(value: string): value is ScriptablePackAssetKind {\n return (SCRIPTABLE_PACK_ASSET_KINDS as readonly string[]).includes(value);\n}\n\nexport interface ScriptablePackAssetDeclaration<\n TKind extends ScriptablePackAssetKind = ScriptablePackAssetKind,\n> {\n readonly guid: AssetGuid;\n readonly kind: TKind;\n readonly name?: string;\n}\n\nexport type ScriptablePackAssetDeclarations = Readonly<\n Record<string, ScriptablePackAssetDeclaration>\n>;\n\nexport type ScriptablePackExternalAssets = Readonly<Record<string, AssetGuid>>;\n\n/**\n * Component-shaped input accepted by a ScriptablePack scene declaration.\n * Engine component tokens satisfy this shape; plain `{ type }` rows keep the\n * Pack contract independent of ECS and survive the isolated module worker.\n */\nexport interface ScriptablePackSceneComponentInput {\n readonly name: string;\n readonly fields: Readonly<Record<string, string | { readonly type: string }>>;\n}\n\n/** Neutral scene schema projection owned by the Pack definition. */\nexport interface ScriptablePackSceneComponent {\n readonly name: string;\n readonly fields: Readonly<Record<string, string>>;\n}\n\nfunction sceneComponentFieldType(value: unknown): string | undefined {\n if (typeof value === 'string') return value;\n if (isRecord(value) && typeof value.type === 'string') return value.type;\n return undefined;\n}\n\n/** Derive the frozen, ECS-neutral schema used by scene output producers. */\nexport function projectScriptablePackSceneComponents(\n components: readonly ScriptablePackSceneComponentInput[] | undefined,\n): readonly ScriptablePackSceneComponent[] {\n return (components ?? []).map((component) => ({\n name: component.name,\n fields: Object.fromEntries(\n Object.entries(component.fields).map(([fieldName, field]) => [\n fieldName,\n sceneComponentFieldType(field) as string,\n ]),\n ),\n }));\n}\n\n/** Pack-facing name for the shared Engine publication envelope. */\nexport type ScriptablePackPublicationEnvelope = AssetPublicationEnvelope;\n\n/** Structured domain failure permitted to cross the isolated build-time AssetReader seam. */\nexport interface ScriptablePackErrorProvenance {\n /** Published source generation observed by the reader, when available. */\n readonly generation?: number;\n /** Stable producer identity for the failed output, when available. */\n readonly sourceKey?: string;\n /** GUID associated with the failed read or output, when available. */\n readonly guid?: string;\n}\n\nexport interface ScriptablePackReadError {\n readonly code: string;\n readonly expected: string;\n readonly hint: string;\n readonly detail?: unknown;\n readonly provenance?: ScriptablePackErrorProvenance;\n}\n\nexport type ScriptablePackAssetFor<TDescriptor extends ScriptablePackAssetDeclaration> =\n TDescriptor extends { readonly kind: infer TKind extends ScriptablePackAssetKind }\n ? Extract<Asset, { readonly kind: TKind }>\n : never;\n\nexport type ScriptablePackOutputs<TAssets extends ScriptablePackAssetDeclarations> = {\n readonly [TKey in keyof TAssets]: TAssets[TKey] extends ScriptablePackAssetDeclaration\n ? ScriptablePackAssetFor<TAssets[TKey]>\n : never;\n};\n\nexport interface AssetReader {\n /** Load a declared GUID as a durable payload; this never mints a World handle. */\n readByGuid<TAsset extends Asset = Asset>(\n guid: AssetGuid,\n ): Promise<Result<TAsset, ScriptablePackReadError>>;\n}\n\nexport type ScriptablePackBuildResult<\n TAssets extends ScriptablePackAssetDeclarations,\n TError,\n> = Result<ScriptablePackOutputs<TAssets>, TError>;\n\nexport interface ScriptablePackDefinition<\n TAssets extends ScriptablePackAssetDeclarations = ScriptablePackAssetDeclarations,\n TExternal extends ScriptablePackExternalAssets = ScriptablePackExternalAssets,\n TError = ScriptablePackReadError,\n> {\n readonly schemaVersion: '1.0.0';\n readonly packageId: AssetGuid;\n readonly name?: string;\n readonly assets: TAssets;\n /** Component tokens/schema rows used by scene ref externalization. */\n readonly sceneComponents?: readonly ScriptablePackSceneComponentInput[];\n readonly externalAssets: TExternal;\n readonly build: (\n assetReader: AssetReader,\n ) =>\n | ScriptablePackBuildResult<TAssets, TError>\n | Promise<ScriptablePackBuildResult<TAssets, TError>>;\n}\n\nexport interface ScriptablePackSourceClosureEntry {\n readonly path: string;\n readonly digest: string;\n}\n\nexport interface ScriptablePackMetaJson {\n readonly schemaVersion: '1.0.0';\n readonly kind: 'external-asset-package';\n readonly packageId: string;\n readonly name?: string;\n readonly importer: 'pack-ts';\n readonly source: string;\n readonly importSettings: {\n readonly contractVersion: '1.0.0';\n readonly externalAssets: readonly {\n readonly alias: string;\n readonly guid: string;\n }[];\n };\n readonly subAssets: readonly {\n readonly guid: string;\n readonly sourceIndex: number;\n readonly sourceKey: string;\n readonly kind: ScriptablePackAssetKind;\n readonly name?: string;\n }[];\n}\n\nexport interface ScriptablePackOperationEnvelope {\n readonly requestId: string;\n readonly expectedRevision?: string;\n}\n\nexport type ScriptablePackGatewayOperation =\n | (ScriptablePackOperationEnvelope & {\n readonly kind: 'preflight';\n readonly sourcePath: string;\n })\n | (ScriptablePackOperationEnvelope & {\n readonly kind: 'create-scriptable-pack';\n readonly sourcePath: string;\n readonly name?: string;\n readonly initialOutput: {\n readonly sourceKey: string;\n readonly kind: ScriptablePackAssetKind;\n readonly name?: string;\n };\n })\n | (ScriptablePackOperationEnvelope & {\n readonly kind: 'add-output';\n readonly sourcePath: string;\n readonly sourceKey: string;\n readonly assetKind: ScriptablePackAssetKind;\n readonly name?: string;\n })\n | (ScriptablePackOperationEnvelope & {\n readonly kind: 'add-external-asset';\n readonly sourcePath: string;\n readonly alias: string;\n readonly guid: AssetGuid;\n })\n | (ScriptablePackOperationEnvelope & {\n readonly kind: 'rename-display';\n readonly sourcePath: string;\n readonly target:\n | { readonly kind: 'package' }\n | { readonly kind: 'output'; readonly sourceKey: string };\n readonly name: string;\n })\n | (ScriptablePackOperationEnvelope & {\n readonly kind: 'remove-output';\n readonly sourcePath: string;\n readonly sourceKey: string;\n /** Exact incoming reference identities acknowledged by the caller. */\n readonly confirmIncomingRefs?: readonly string[];\n })\n | (ScriptablePackOperationEnvelope & {\n readonly kind: 'clone-scriptable-pack';\n readonly sourcePath: string;\n readonly targetPath: string;\n })\n | (ScriptablePackOperationEnvelope & {\n readonly kind: 'inspect-meta';\n readonly sourcePath: string;\n })\n | (ScriptablePackOperationEnvelope & {\n readonly kind: 'rebuild' | 'cold-cook';\n readonly sourcePath: string;\n });\n\nexport interface ScriptablePackMutationCapabilities {\n readonly inspect: true;\n readonly rebuild: true;\n readonly coldCook: true;\n readonly create?: true;\n readonly addOutput?: true;\n readonly addExternalAsset?: true;\n readonly renameDisplay?: true;\n readonly removeOutput?: true;\n readonly clone?: true;\n readonly reason?: string;\n}\n\nexport interface ScriptablePackPreflight {\n readonly sourcePath: string;\n readonly revision: string;\n readonly meta: ScriptablePackMetaJson;\n readonly capabilities: ScriptablePackMutationCapabilities;\n readonly incomingRefs: readonly string[];\n}\n\nexport interface ScriptablePackGatewayMutation {\n readonly sourcePath: string;\n readonly revision: string;\n readonly meta: ScriptablePackMetaJson;\n}\n\nexport interface ScriptablePackAuthoringGateway {\n execute(\n operation: ScriptablePackGatewayOperation,\n ): Promise<Result<ScriptablePackGatewayMutation | ScriptablePackPreflight, ScriptablePackError>>;\n}\n\nexport type ScriptablePackAuthoringMutation =\n | (ScriptablePackOperationEnvelope & {\n readonly kind: 'create-scriptable-pack';\n readonly sourcePath: string;\n readonly packageId: AssetGuid;\n readonly name?: string;\n readonly initialOutput: {\n readonly sourceKey: string;\n readonly kind: ScriptablePackAssetKind;\n readonly guid: AssetGuid;\n readonly name?: string;\n };\n })\n | (ScriptablePackOperationEnvelope & {\n readonly kind: 'add-output';\n readonly sourcePath: string;\n readonly sourceKey: string;\n readonly assetKind: ScriptablePackAssetKind;\n readonly guid: AssetGuid;\n readonly name?: string;\n })\n | Extract<\n ScriptablePackGatewayOperation,\n { readonly kind: 'add-external-asset' | 'rename-display' | 'remove-output' }\n >\n | (ScriptablePackOperationEnvelope & {\n readonly kind: 'clone-scriptable-pack';\n readonly sourcePath: string;\n readonly targetPath: string;\n readonly packageId: AssetGuid;\n readonly outputGuids: Readonly<Record<string, AssetGuid>>;\n });\n\nexport interface ScriptablePackAuthoringPort {\n preflight(\n sourcePath: string,\n ): Promise<Result<Omit<ScriptablePackPreflight, 'sourcePath'>, ScriptablePackError>>;\n mutate(\n operation: ScriptablePackAuthoringMutation,\n ): Promise<\n Result<{ readonly sourcePath: string; readonly revision: string }, ScriptablePackError>\n >;\n inspect(\n sourcePath: string,\n ): Promise<\n Result<\n { readonly revision: string; readonly meta: ScriptablePackMetaJson },\n ScriptablePackError\n >\n >;\n rebuild(\n sourcePath: string,\n mode: 'rebuild' | 'cold-cook',\n ): Promise<\n Result<\n { readonly revision: string; readonly meta: ScriptablePackMetaJson },\n ScriptablePackError\n >\n >;\n}\n\n/** Keep GUID allocation and multi-identity operations in one auditable gateway transaction. */\nexport function createScriptablePackAuthoringGateway(\n port: ScriptablePackAuthoringPort,\n allocateGuid: () => AssetGuid = AssetGuidCodec.random,\n): ScriptablePackAuthoringGateway {\n const requests = new Map<\n string,\n {\n readonly fingerprint: string;\n readonly result: Promise<\n Result<ScriptablePackGatewayMutation | ScriptablePackPreflight, ScriptablePackError>\n >;\n }\n >();\n\n async function mutationResult(\n result: Awaited<ReturnType<ScriptablePackAuthoringPort['mutate']>>,\n ): Promise<Result<ScriptablePackGatewayMutation, ScriptablePackError>> {\n if (!result.ok) return result;\n const inspected = await port.inspect(result.value.sourcePath);\n if (!inspected.ok) return inspected;\n return ok({\n sourcePath: result.value.sourcePath,\n revision: inspected.value.revision,\n meta: inspected.value.meta,\n });\n }\n\n async function dispatch(\n operation: ScriptablePackGatewayOperation,\n ): Promise<Result<ScriptablePackGatewayMutation | ScriptablePackPreflight, ScriptablePackError>> {\n switch (operation.kind) {\n case 'preflight': {\n const preflight = await port.preflight(operation.sourcePath);\n return preflight.ok\n ? ok({ sourcePath: operation.sourcePath, ...preflight.value })\n : preflight;\n }\n case 'inspect-meta': {\n const inspected = await port.inspect(operation.sourcePath);\n return inspected.ok\n ? ok({ sourcePath: operation.sourcePath, ...inspected.value })\n : inspected;\n }\n case 'rebuild':\n case 'cold-cook': {\n const preflight = await port.preflight(operation.sourcePath);\n if (!preflight.ok) return preflight;\n if (\n operation.expectedRevision !== undefined &&\n operation.expectedRevision !== preflight.value.revision\n ) {\n return err({\n code: 'pack-source-revision-conflict',\n expected: operation.expectedRevision,\n actual: preflight.value.revision,\n hint: 'inspect the current source revision, then retry the build with a new requestId',\n retryable: true,\n recoveryActions: ['asset.preflight', 'mint-request-id'],\n detail: { requestId: operation.requestId, sourcePath: operation.sourcePath },\n });\n }\n const rebuilt = await port.rebuild(operation.sourcePath, operation.kind);\n return rebuilt.ok ? ok({ sourcePath: operation.sourcePath, ...rebuilt.value }) : rebuilt;\n }\n case 'create-scriptable-pack':\n return mutationResult(\n await port.mutate({\n ...operation,\n packageId: allocateGuid(),\n initialOutput: { ...operation.initialOutput, guid: allocateGuid() },\n }),\n );\n case 'add-output':\n return mutationResult(await port.mutate({ ...operation, guid: allocateGuid() }));\n case 'clone-scriptable-pack': {\n const inspected = await port.inspect(operation.sourcePath);\n if (!inspected.ok) return inspected;\n const outputGuids = Object.fromEntries(\n inspected.value.meta.subAssets.map((asset) => [asset.sourceKey, allocateGuid()]),\n );\n return mutationResult(\n await port.mutate({\n ...operation,\n packageId: allocateGuid(),\n outputGuids,\n }),\n );\n }\n case 'add-external-asset':\n case 'rename-display':\n case 'remove-output':\n return mutationResult(await port.mutate(operation));\n }\n }\n\n return {\n execute(operation) {\n if (operation.requestId.trim().length === 0) {\n return Promise.resolve(\n err({\n code: 'pack-source-operation-committed',\n expected: 'a non-empty caller-minted requestId',\n actual: operation.requestId,\n hint: 'mint a new requestId and retry the operation once',\n retryable: true,\n recoveryActions: ['mint-request-id'],\n detail: { requestId: operation.requestId, sourcePath: operation.sourcePath },\n }),\n );\n }\n const fingerprint = JSON.stringify(operation);\n const prior = requests.get(operation.requestId);\n if (prior !== undefined) {\n if (prior.fingerprint === fingerprint) return prior.result;\n return Promise.resolve(\n err({\n code: 'pack-source-operation-committed',\n expected: 'one immutable operation per requestId',\n actual: operation.kind,\n hint: 'read the original operation result or mint a new requestId',\n retryable: false,\n recoveryActions: ['read-operation-run', 'mint-request-id'],\n detail: { requestId: operation.requestId, sourcePath: operation.sourcePath },\n }),\n );\n }\n const result = dispatch(operation);\n requests.set(operation.requestId, { fingerprint, result });\n return result;\n },\n };\n}\n\nconst SCRIPTABLE_PACK_REQUEST_ID_SCHEMA = {\n type: 'string',\n minLength: 1,\n maxLength: 128,\n pattern: '^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$',\n description: 'Caller-minted identity for one idempotent ScriptablePack operation.',\n} as const;\nconst SCRIPTABLE_PACK_SOURCE_PATH_SCHEMA = {\n type: 'string',\n minLength: 8,\n pattern: '^[^/].*\\\\.pack\\\\.ts$',\n description: 'Game-root-relative ScriptablePack source path.',\n} as const;\nconst SCRIPTABLE_PACK_OWNER_GUID_SCHEMA = {\n type: 'string',\n format: 'uuid',\n description: 'Catalog GUID used to resolve the producer-owned source subject.',\n} as const;\nconst SCRIPTABLE_PACK_REVISION_SCHEMA = {\n type: 'string',\n minLength: 64,\n maxLength: 64,\n pattern: '^[a-f0-9]{64}$',\n description: 'SHA-256 source revision returned by preflight.',\n} as const;\nconst SCRIPTABLE_PACK_SOURCE_KEY_SCHEMA = { type: 'string', minLength: 1 } as const;\nconst SCRIPTABLE_PACK_ASSET_KIND_SCHEMA = {\n enum: SCRIPTABLE_PACK_ASSET_KINDS,\n description: 'Ordinary Asset kind supported by the ScriptablePack producer/loader matrix.',\n} as const;\nconst SCRIPTABLE_PACK_NAME_SCHEMA = { type: 'string', minLength: 1 } as const;\n\nfunction scriptablePackArgsSchema(\n properties: Readonly<Record<string, unknown>>,\n required: readonly string[],\n options: { readonly subject?: boolean; readonly guidSubject?: boolean } = {},\n) {\n const subjectRequired = ['requestId', ...required];\n return {\n type: 'object',\n properties: {\n sourcePath: SCRIPTABLE_PACK_SOURCE_PATH_SCHEMA,\n ownerGuid: SCRIPTABLE_PACK_OWNER_GUID_SCHEMA,\n requestId: SCRIPTABLE_PACK_REQUEST_ID_SCHEMA,\n ...properties,\n },\n required: subjectRequired,\n ...(options.subject === false\n ? {}\n : {\n anyOf: [\n { required: [...subjectRequired, 'sourcePath'] },\n { required: [...subjectRequired, 'ownerGuid'] },\n ...(options.guidSubject === false ? [] : [{ required: [...subjectRequired, 'guid'] }]),\n ],\n }),\n additionalProperties: false,\n } as const;\n}\n\nexport const SOURCE_AUTHORING_OPERATION_DESCRIPTORS = [\n {\n id: 'asset-source.create',\n kind: 'create',\n domain: 'session',\n title: 'Create Asset Source',\n argsSchema: scriptablePackArgsSchema(\n {\n name: SCRIPTABLE_PACK_NAME_SCHEMA,\n initialOutput: {\n type: 'object',\n properties: {\n sourceKey: SCRIPTABLE_PACK_SOURCE_KEY_SCHEMA,\n kind: SCRIPTABLE_PACK_ASSET_KIND_SCHEMA,\n name: SCRIPTABLE_PACK_NAME_SCHEMA,\n },\n required: ['sourceKey', 'kind'],\n additionalProperties: false,\n },\n },\n ['sourcePath', 'initialOutput'],\n { subject: false },\n ),\n },\n {\n id: 'asset-source.add-output',\n kind: 'add-output',\n domain: 'session',\n title: 'Add Asset Source Output',\n argsSchema: scriptablePackArgsSchema(\n {\n sourceKey: SCRIPTABLE_PACK_SOURCE_KEY_SCHEMA,\n assetKind: SCRIPTABLE_PACK_ASSET_KIND_SCHEMA,\n name: SCRIPTABLE_PACK_NAME_SCHEMA,\n expectedRevision: SCRIPTABLE_PACK_REVISION_SCHEMA,\n },\n ['sourceKey', 'assetKind', 'expectedRevision'],\n ),\n },\n {\n id: 'asset-source.add-external-asset',\n kind: 'add-external-asset',\n domain: 'session',\n title: 'Add Asset Source External Asset',\n argsSchema: scriptablePackArgsSchema(\n {\n alias: SCRIPTABLE_PACK_SOURCE_KEY_SCHEMA,\n guid: { type: 'string', format: 'uuid' },\n expectedRevision: SCRIPTABLE_PACK_REVISION_SCHEMA,\n },\n ['alias', 'guid', 'expectedRevision'],\n { guidSubject: false },\n ),\n },\n {\n id: 'asset-source.rename',\n kind: 'rename',\n domain: 'session',\n title: 'Rename Asset Source Display Name',\n argsSchema: scriptablePackArgsSchema(\n {\n target: {\n oneOf: [\n {\n type: 'object',\n properties: { kind: { const: 'package' } },\n required: ['kind'],\n additionalProperties: false,\n },\n {\n type: 'object',\n properties: {\n kind: { const: 'output' },\n sourceKey: SCRIPTABLE_PACK_SOURCE_KEY_SCHEMA,\n },\n required: ['kind', 'sourceKey'],\n additionalProperties: false,\n },\n ],\n },\n name: SCRIPTABLE_PACK_NAME_SCHEMA,\n expectedRevision: SCRIPTABLE_PACK_REVISION_SCHEMA,\n },\n ['target', 'name', 'expectedRevision'],\n ),\n },\n {\n id: 'asset-source.remove-output',\n kind: 'remove-output',\n domain: 'session',\n title: 'Remove Asset Source Output',\n destructive: true,\n argsSchema: scriptablePackArgsSchema(\n {\n sourceKey: SCRIPTABLE_PACK_SOURCE_KEY_SCHEMA,\n confirmIncomingRefs: { type: 'array', items: { type: 'string' } },\n expectedRevision: SCRIPTABLE_PACK_REVISION_SCHEMA,\n },\n ['sourceKey', 'expectedRevision'],\n ),\n },\n {\n id: 'asset-source.clone',\n kind: 'clone',\n domain: 'session',\n title: 'Clone Asset Source',\n argsSchema: scriptablePackArgsSchema(\n {\n targetPath: SCRIPTABLE_PACK_SOURCE_PATH_SCHEMA,\n expectedRevision: SCRIPTABLE_PACK_REVISION_SCHEMA,\n },\n ['targetPath', 'expectedRevision'],\n ),\n },\n {\n id: 'asset-source.rebuild',\n kind: 'rebuild',\n domain: 'session',\n title: 'Rebuild Asset Source',\n argsSchema: scriptablePackArgsSchema({ expectedRevision: SCRIPTABLE_PACK_REVISION_SCHEMA }, [\n 'expectedRevision',\n ]),\n },\n {\n id: 'asset-source.cold-cook',\n kind: 'cold-cook',\n domain: 'session',\n title: 'Cold Cook Asset Source',\n argsSchema: scriptablePackArgsSchema({ expectedRevision: SCRIPTABLE_PACK_REVISION_SCHEMA }, [\n 'expectedRevision',\n ]),\n },\n] as const;\n\nexport type ScriptablePackError =\n | {\n readonly code: 'pack-source-load-failed';\n readonly expected: string;\n readonly hint: string;\n readonly detail: {\n readonly sourcePath: string;\n readonly reason: 'module-load' | 'timeout' | 'source-changed';\n readonly phase: 'module-load' | 'build';\n readonly diagnostic: string;\n readonly timeoutMs?: number;\n };\n }\n | {\n readonly code: 'pack-source-definition-invalid';\n readonly expected: string;\n readonly hint: string;\n readonly detail: {\n readonly sourcePath?: string;\n readonly propertyPath: string;\n readonly actual: string;\n };\n }\n | {\n readonly code: 'pack-source-output-invalid';\n readonly expected: string;\n readonly hint: string;\n readonly detail: {\n readonly missingGuids: readonly string[];\n readonly unexpectedSourceKeys: readonly string[];\n readonly kindMismatches: readonly {\n readonly sourceKey: string;\n readonly expected: string;\n readonly actual: string;\n }[];\n };\n }\n | {\n readonly code: 'pack-source-external-closure-mismatch';\n readonly expected: string;\n readonly hint: string;\n readonly detail: {\n readonly undeclaredReferencedGuids: readonly string[];\n readonly undeclaredReadGuids: readonly string[];\n readonly unusedDeclaredGuids: readonly string[];\n };\n }\n | {\n readonly code:\n | 'pack-source-path-invalid'\n | 'pack-source-revision-conflict'\n | 'pack-source-mutation-unsupported'\n | 'pack-source-reference-conflict'\n | 'pack-source-write-failed'\n | 'pack-source-build-cycle'\n | 'pack-source-publication-timeout'\n | 'pack-source-operation-committed';\n readonly expected: string;\n readonly actual?: string;\n readonly hint: string;\n readonly retryable: boolean;\n readonly recoveryActions: readonly string[];\n readonly detail: {\n readonly requestId?: string;\n readonly sourcePath?: string;\n readonly packageId?: string;\n readonly sourceKey?: string;\n readonly incomingRefs?: readonly string[];\n };\n };\n\nfunction actual(value: unknown): string {\n if (value === null) return 'null';\n if (Array.isArray(value)) return 'array';\n if (ArrayBuffer.isView(value)) return value.constructor.name;\n return typeof value;\n}\n\nfunction invalid(\n propertyPath: string,\n expected: string,\n value: unknown,\n sourcePath?: string,\n): Result<never, ScriptablePackError> {\n return err({\n code: 'pack-source-definition-invalid',\n expected,\n hint: 'repair the default exported ScriptablePack definition, then inspect Meta again',\n detail: {\n ...(sourcePath === undefined ? {} : { sourcePath }),\n propertyPath,\n actual: actual(value),\n },\n });\n}\n\nexport function isRecord(value: unknown): value is Record<string, unknown> {\n return value !== null && typeof value === 'object' && !Array.isArray(value);\n}\n\nfunction isAssetGuid(value: unknown): value is AssetGuid {\n return value instanceof Uint8Array && value.byteLength === 16;\n}\n\nfunction guidKey(guid: AssetGuid): string {\n return AssetGuidCodec.format(guid);\n}\n\nfunction freezeDefinition(\n definition: ScriptablePackDefinition,\n): Readonly<ScriptablePackDefinition> {\n const assets = Object.fromEntries(\n Object.entries(definition.assets).map(([sourceKey, descriptor]) => [\n sourceKey,\n Object.freeze({ ...descriptor, guid: descriptor.guid.slice() as AssetGuid }),\n ]),\n );\n const externalAssets = Object.fromEntries(\n Object.entries(definition.externalAssets).map(([alias, guid]) => [\n alias,\n guid.slice() as AssetGuid,\n ]),\n );\n const sceneComponents =\n definition.sceneComponents === undefined\n ? undefined\n : Object.freeze(\n projectScriptablePackSceneComponents(definition.sceneComponents).map((component) =>\n Object.freeze({\n ...component,\n fields: Object.freeze({ ...component.fields }),\n }),\n ),\n );\n return Object.freeze({\n ...definition,\n packageId: definition.packageId.slice() as AssetGuid,\n assets: Object.freeze(assets),\n externalAssets: Object.freeze(externalAssets),\n ...(sceneComponents === undefined ? {} : { sceneComponents }),\n });\n}\n\nexport function validateScriptablePackDefinition(\n value: unknown,\n sourcePath?: string,\n): Result<Readonly<ScriptablePackDefinition>, ScriptablePackError> {\n if (!isRecord(value))\n return invalid('$', 'a ScriptablePack definition object', value, sourcePath);\n if (value.schemaVersion !== '1.0.0') {\n return invalid('$.schemaVersion', \"the literal '1.0.0'\", value.schemaVersion, sourcePath);\n }\n if (!isAssetGuid(value.packageId)) {\n return invalid('$.packageId', 'a 16-byte AssetGuid', value.packageId, sourcePath);\n }\n if (value.name !== undefined && typeof value.name !== 'string') {\n return invalid('$.name', 'a string when present', value.name, sourcePath);\n }\n if (!isRecord(value.assets) || Object.keys(value.assets).length === 0) {\n return invalid(\n '$.assets',\n 'a non-empty sourceKey to descriptor object',\n value.assets,\n sourcePath,\n );\n }\n if (!isRecord(value.externalAssets)) {\n return invalid(\n '$.externalAssets',\n 'an alias to AssetGuid object',\n value.externalAssets,\n sourcePath,\n );\n }\n if (value.sceneComponents !== undefined) {\n if (!Array.isArray(value.sceneComponents)) {\n return invalid(\n '$.sceneComponents',\n 'an array of component tokens or neutral schema rows when present',\n value.sceneComponents,\n sourcePath,\n );\n }\n const componentNames = new Set<string>();\n for (const [componentIndex, component] of value.sceneComponents.entries()) {\n if (!isRecord(component)) {\n return invalid(\n `$.sceneComponents[${componentIndex}]`,\n 'a component token or neutral schema row',\n component,\n sourcePath,\n );\n }\n if (typeof component.name !== 'string' || component.name.trim().length === 0) {\n return invalid(\n `$.sceneComponents[${componentIndex}].name`,\n 'a non-empty component name',\n component.name,\n sourcePath,\n );\n }\n if (componentNames.has(component.name)) {\n return invalid(\n `$.sceneComponents[${componentIndex}].name`,\n 'component names to be unique within one ScriptablePack',\n component.name,\n sourcePath,\n );\n }\n componentNames.add(component.name);\n if (!isRecord(component.fields)) {\n return invalid(\n `$.sceneComponents[${componentIndex}].fields`,\n 'a field-name to schema-type object',\n component.fields,\n sourcePath,\n );\n }\n for (const [fieldName, field] of Object.entries(component.fields)) {\n const type = sceneComponentFieldType(field);\n if (fieldName.trim().length === 0 || type === undefined || type.trim().length === 0) {\n return invalid(\n `$.sceneComponents[${componentIndex}].fields`,\n 'field names with non-empty string schema types',\n field,\n sourcePath,\n );\n }\n }\n }\n }\n if (typeof value.build !== 'function') {\n return invalid('$.build', 'a build(assetReader) function', value.build, sourcePath);\n }\n\n const packageGuid = guidKey(value.packageId);\n const localGuids = new Set<string>();\n for (const [sourceKey, descriptor] of Object.entries(value.assets)) {\n if (sourceKey.trim().length === 0) {\n return invalid('$.assets', 'non-empty sourceKey object keys', sourceKey, sourcePath);\n }\n if (!isRecord(descriptor)) {\n return invalid(\n `$.assets[${JSON.stringify(sourceKey)}]`,\n 'an asset descriptor',\n descriptor,\n sourcePath,\n );\n }\n if (!isAssetGuid(descriptor.guid)) {\n return invalid(\n `$.assets[${JSON.stringify(sourceKey)}].guid`,\n 'a 16-byte AssetGuid',\n descriptor.guid,\n sourcePath,\n );\n }\n if (typeof descriptor.kind !== 'string' || !isScriptablePackAssetKind(descriptor.kind)) {\n return invalid(\n `$.assets[${JSON.stringify(sourceKey)}].kind`,\n 'one of SCRIPTABLE_PACK_ASSET_KINDS',\n descriptor.kind,\n sourcePath,\n );\n }\n if (descriptor.name !== undefined && typeof descriptor.name !== 'string') {\n return invalid(\n `$.assets[${JSON.stringify(sourceKey)}].name`,\n 'a string when present',\n descriptor.name,\n sourcePath,\n );\n }\n const guid = guidKey(descriptor.guid);\n if (guid === packageGuid || localGuids.has(guid)) {\n return invalid(\n `$.assets[${JSON.stringify(sourceKey)}].guid`,\n 'a GUID unique within the package and distinct from packageId',\n descriptor.guid,\n sourcePath,\n );\n }\n localGuids.add(guid);\n }\n\n const externalGuids = new Set<string>();\n for (const [alias, guidValue] of Object.entries(value.externalAssets)) {\n if (alias.trim().length === 0) {\n return invalid('$.externalAssets', 'non-empty alias object keys', alias, sourcePath);\n }\n if (!isAssetGuid(guidValue)) {\n return invalid(\n `$.externalAssets[${JSON.stringify(alias)}]`,\n 'a 16-byte AssetGuid',\n guidValue,\n sourcePath,\n );\n }\n const guid = guidKey(guidValue);\n if (guid === packageGuid || localGuids.has(guid) || externalGuids.has(guid)) {\n return invalid(\n `$.externalAssets[${JSON.stringify(alias)}]`,\n 'a unique foreign GUID not owned by this package',\n guidValue,\n sourcePath,\n );\n }\n externalGuids.add(guid);\n }\n\n return ok(freezeDefinition(value as unknown as ScriptablePackDefinition));\n}\n\nexport function projectScriptablePackMeta(\n definition: ScriptablePackDefinition,\n source: string,\n): ScriptablePackMetaJson {\n const subAssets = Object.entries(definition.assets)\n .sort(([left], [right]) => left.localeCompare(right))\n .map(([sourceKey, descriptor], sourceIndex) => ({\n guid: guidKey(descriptor.guid),\n sourceIndex,\n sourceKey,\n kind: descriptor.kind,\n ...(descriptor.name === undefined ? {} : { name: descriptor.name }),\n }));\n const externalAssets = Object.entries(definition.externalAssets)\n .sort(([left], [right]) => left.localeCompare(right))\n .map(([alias, guid]) => ({ alias, guid: guidKey(guid) }));\n return {\n schemaVersion: '1.0.0',\n kind: 'external-asset-package',\n packageId: guidKey(definition.packageId),\n ...(definition.name === undefined ? {} : { name: definition.name }),\n importer: 'pack-ts',\n source,\n importSettings: { contractVersion: '1.0.0', externalAssets },\n subAssets,\n };\n}\n"]}
@@ -5,6 +5,6 @@ import type { ExistingOutput, ProposedOutput, TopologyDiff } from '@forgeax/engi
5
5
  * multi-output declarations without one are explicitly ambiguous.
6
6
  */
7
7
  export declare function diffTopology(previous: readonly ExistingOutput[], next: readonly ProposedOutput[]): TopologyDiff;
8
- /** Alias named after the producer-facing contract wording. */
9
8
  export declare const calculateTopologyDiff: typeof diffTopology;
9
+ /** Alias named after the producer-facing contract wording. */
10
10
  //# sourceMappingURL=topology.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"topology.d.ts","sourceRoot":"","sources":["../src/topology.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EAId,cAAc,EACd,YAAY,EAEb,MAAM,uBAAuB,CAAC;AAsC/B;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,SAAS,cAAc,EAAE,EACnC,IAAI,EAAE,SAAS,cAAc,EAAE,GAC9B,YAAY,CAkGd;AAED,8DAA8D;AAC9D,eAAO,MAAM,qBAAqB,qBAAe,CAAC"}
1
+ {"version":3,"file":"topology.d.ts","sourceRoot":"","sources":["../src/topology.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EAId,cAAc,EACd,YAAY,EAEb,MAAM,uBAAuB,CAAC;AAsC/B;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,SAAS,cAAc,EAAE,EACnC,IAAI,EAAE,SAAS,cAAc,EAAE,GAC9B,YAAY,CAkGd;AAED,eAAO,MAAM,qBAAqB,qBAAe,CAAC;AAElD,8DAA8D"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@forgeax/engine-pack",
3
- "version": "0.1.3",
3
+ "version": "0.1.4",
4
4
  "private": false,
5
5
  "type": "module",
6
6
  "license": "Apache-2.0",
@@ -14,6 +14,11 @@
14
14
  "types": "./dist/index.d.ts",
15
15
  "import": "./dist/index.mjs"
16
16
  },
17
+ "./build": {
18
+ "types": "./dist/build.d.ts",
19
+ "node": "./dist/build.mjs",
20
+ "default": null
21
+ },
17
22
  "./schema": {
18
23
  "types": "./dist/schema-compiled.d.ts",
19
24
  "import": "./dist/schema.mjs"
@@ -22,6 +27,10 @@
22
27
  "types": "./dist/guid.d.ts",
23
28
  "import": "./dist/guid.mjs"
24
29
  },
30
+ "./builtin": {
31
+ "types": "./dist/builtin.d.ts",
32
+ "import": "./dist/builtin.mjs"
33
+ },
25
34
  "./errors": {
26
35
  "types": "./dist/errors.d.ts",
27
36
  "import": "./dist/errors.mjs"
@@ -34,6 +43,22 @@
34
43
  "types": "./dist/scanner.d.ts",
35
44
  "import": "./dist/scanner.mjs"
36
45
  },
46
+ "./runtime": {
47
+ "types": "./dist/runtime.d.ts",
48
+ "import": "./dist/runtime.mjs"
49
+ },
50
+ "./artifact-path": {
51
+ "types": "./dist/artifact-path.d.ts",
52
+ "import": "./dist/artifact-path.mjs"
53
+ },
54
+ "./material-cook": {
55
+ "types": "./dist/material-cook.d.ts",
56
+ "import": "./dist/material-cook.mjs"
57
+ },
58
+ "./mesh-bin-contract": {
59
+ "types": "./dist/mesh-bin-contract.d.ts",
60
+ "import": "./dist/mesh-bin-contract.mjs"
61
+ },
37
62
  "./cli-asset": {
38
63
  "types": "./dist/cli-asset.d.ts",
39
64
  "node": "./dist/cli-asset.mjs",
@@ -111,7 +136,7 @@
111
136
  }
112
137
  },
113
138
  "dependencies": {
114
- "@forgeax/engine-types": "0.1.3",
139
+ "@forgeax/engine-types": "0.1.4",
115
140
  "@noble/hashes": "^2.2.0",
116
141
  "fast-glob": "^3.3.3",
117
142
  "typescript": "^5.8.3",
@@ -12,8 +12,9 @@ const decoderSource = readFileSync(
12
12
 
13
13
  describe('mesh-bin consumer owner surface', () => {
14
14
  it('routes both production halves through Pack-owned facts', () => {
15
+ expect(encoderSource).toContain("from '@forgeax/engine-pack/mesh-bin-contract'");
16
+ expect(decoderSource).toContain("from '@forgeax/engine-pack'");
15
17
  for (const source of [encoderSource, decoderSource]) {
16
- expect(source).toContain("from '@forgeax/engine-pack'");
17
18
  expect(source).toContain('MESH_BIN_HEADER_V4_BYTES');
18
19
  expect(source).not.toContain('const HEADER_V2_BYTES = 28');
19
20
  }
@@ -0,0 +1,78 @@
1
+ import { mkdtemp, rm, writeFile } from 'node:fs/promises';
2
+ import { tmpdir } from 'node:os';
3
+ import { join } from 'node:path';
4
+ import { afterEach, describe, expect, it } from 'vitest';
5
+ import { finalizePackageProduct } from '../package-finalizer.js';
6
+ import { scanInventory } from '../scanner.js';
7
+
8
+ const GUID = '019e3969-1d48-7c3b-ac24-6d68f457065f';
9
+
10
+ describe('Pack owner chain', () => {
11
+ const roots: string[] = [];
12
+
13
+ afterEach(async () => {
14
+ await Promise.all(roots.splice(0).map((root) => rm(root, { recursive: true, force: true })));
15
+ });
16
+
17
+ it('scans source identity and finalizes the terminal package product', async () => {
18
+ const root = await mkdtemp(join(tmpdir(), 'forgeax-owner-chain-'));
19
+ roots.push(root);
20
+ await writeFile(
21
+ join(root, 'hero.pack.json'),
22
+ JSON.stringify({
23
+ schemaVersion: '2.0.0',
24
+ kind: 'internal-text-package',
25
+ assets: [
26
+ {
27
+ guid: GUID,
28
+ kind: 'texture',
29
+ sourceKey: 'hero/albedo',
30
+ sourceIndex: 0,
31
+ payload: {},
32
+ refs: [],
33
+ artifacts: {},
34
+ },
35
+ ],
36
+ }),
37
+ );
38
+ const inventory = await scanInventory([root]);
39
+ expect(inventory.ok).toBe(true);
40
+ if (!inventory.ok) return;
41
+ const writes: string[] = [];
42
+ const result = await finalizePackageProduct(
43
+ {
44
+ assets: [
45
+ {
46
+ guid: GUID,
47
+ kind: 'texture',
48
+ payload: { kind: 'texture' },
49
+ refs: [],
50
+ artifacts: {
51
+ body: { mediaType: 'application/octet-stream', bytes: new Uint8Array([1]) },
52
+ },
53
+ },
54
+ ],
55
+ receipts: [
56
+ {
57
+ guid: GUID,
58
+ origin: 'sourceMeta',
59
+ status: 'succeeded',
60
+ inputFingerprint: inventory.value.inventory[0]?.sourceRevision ?? 'missing',
61
+ },
62
+ ],
63
+ diagnostics: [],
64
+ sourceRevision: inventory.value.inventory[0]?.sourceRevision ?? 'missing',
65
+ },
66
+ {
67
+ base: '/assets',
68
+ packagePath: 'hero.pack.json',
69
+ artifactPath: (guid, key) => `${guid}/${key}.bin`,
70
+ sink: (path) => {
71
+ writes.push(path);
72
+ },
73
+ },
74
+ );
75
+ expect(result.ok).toBe(true);
76
+ if (result.ok) expect(writes).toEqual([`${GUID}/body.bin`, 'hero.pack.json']);
77
+ });
78
+ });
@@ -0,0 +1,105 @@
1
+ import { describe, expect, it } from 'vitest';
2
+ import {
3
+ finalizePackageProduct,
4
+ type PackageProduct,
5
+ packageTransportRevision,
6
+ } from '../package-finalizer.js';
7
+
8
+ const GUID = '019e3969-1d48-7c3b-ac24-6d68f457065f';
9
+
10
+ function product(overrides: Partial<PackageProduct> = {}): PackageProduct {
11
+ return {
12
+ assets: [
13
+ {
14
+ guid: GUID,
15
+ kind: 'texture',
16
+ payload: { kind: 'texture', width: 1, height: 1 },
17
+ refs: [],
18
+ artifacts: {
19
+ source: { mediaType: 'image/png', bytes: new Uint8Array([1, 2, 3]) },
20
+ },
21
+ },
22
+ ],
23
+ receipts: [
24
+ {
25
+ guid: GUID,
26
+ origin: 'sourceMeta',
27
+ status: 'succeeded',
28
+ inputFingerprint: 'sha256:source',
29
+ },
30
+ ],
31
+ diagnostics: [],
32
+ sourceRevision: 'sha256:source',
33
+ sourceKey: 'texture/source',
34
+ ...overrides,
35
+ };
36
+ }
37
+
38
+ describe('engine-pack terminal product and finalizer contract', () => {
39
+ it('finalizes one complete product with source identity and receipts', async () => {
40
+ const result = await finalizePackageProduct(product(), {
41
+ base: '/assets',
42
+ packagePath: 'packages/texture.pack.json',
43
+ artifactPath: (guid, key) => `artifacts/${guid}/${key}.bin`,
44
+ });
45
+
46
+ expect(result.ok).toBe(true);
47
+ if (!result.ok) return;
48
+ expect(result.value.pack.assets).toHaveLength(1);
49
+ expect(result.value.digest).toMatch(/^sha256:/);
50
+ expect(result.value.receipts).toHaveLength(1);
51
+ expect(result.value.sourceRevision).toBe('sha256:source');
52
+ expect(result.value.sourceKey).toBe('texture/source');
53
+ });
54
+
55
+ it('fails closed on duplicate GUIDs and incomplete receipt evidence', async () => {
56
+ const firstAsset = product().assets[0];
57
+ if (firstAsset === undefined) throw new Error('test product asset is missing');
58
+ const duplicate = product({ assets: [firstAsset, firstAsset] });
59
+ const duplicateResult = await finalizePackageProduct(duplicate, {
60
+ base: '/',
61
+ packagePath: 'packages/duplicate.pack.json',
62
+ artifactPath: (guid, key) => `${guid}/${key}.bin`,
63
+ });
64
+ expect(duplicateResult.ok).toBe(false);
65
+
66
+ const missingReceipt = product({ receipts: [] });
67
+ const missingReceiptResult = await finalizePackageProduct(missingReceipt, {
68
+ base: '/',
69
+ packagePath: 'packages/missing-receipt.pack.json',
70
+ artifactPath: (guid, key) => `${guid}/${key}.bin`,
71
+ });
72
+ expect(missingReceiptResult.ok).toBe(false);
73
+ });
74
+
75
+ it('hashes and transports large artifact bodies without JSON-expanding the bytes', async () => {
76
+ const body = new Uint8Array(4 * 1024 * 1024);
77
+ const artifact = { mediaType: 'application/octet-stream', bytes: body };
78
+ const asset = product().assets[0];
79
+ if (asset === undefined) throw new Error('test product asset is missing');
80
+ const large = product({
81
+ assets: [{ ...asset, artifacts: { body: artifact } }],
82
+ });
83
+
84
+ const revision = packageTransportRevision(large);
85
+ expect(revision).toMatch(/^[0-9a-f]{64}$/);
86
+
87
+ const writes = new Map<string, Uint8Array>();
88
+ const result = await finalizePackageProduct(large, {
89
+ base: '/',
90
+ packagePath: 'large.pack.json',
91
+ artifactPath: (guid, key) => `${guid}/${key}.bin`,
92
+ sink: (path, bytes) => {
93
+ writes.set(path, bytes);
94
+ },
95
+ });
96
+ expect(result.ok).toBe(true);
97
+ const packageBytes = writes.get('large.pack.json');
98
+ expect(packageBytes).toBeDefined();
99
+ const published = JSON.parse(new TextDecoder().decode(packageBytes)) as {
100
+ assets: readonly [{ artifacts: { body: { byteLength: number } } }];
101
+ };
102
+ expect(published.assets[0]?.artifacts.body.byteLength).toBe(body.byteLength);
103
+ expect(writes.get(`${GUID}/body.bin`)).toBe(body);
104
+ });
105
+ });
@@ -0,0 +1,15 @@
1
+ import { parsePackV2 } from '@forgeax/engine-pack/runtime';
2
+ import { describe, expect, it } from 'vitest';
3
+
4
+ describe('Pack runtime entry', () => {
5
+ it('parses a Pack v2 envelope in a browser without the Node scanner barrel', () => {
6
+ const result = parsePackV2({
7
+ schemaVersion: '2.0.0',
8
+ kind: 'internal-text-package',
9
+ packageId: 'browser-runtime',
10
+ assets: [],
11
+ });
12
+
13
+ expect(result.ok).toBe(true);
14
+ });
15
+ });