@forgeax/engine-gltf 0.0.0-dev.8d955ade1c79

package/dist/parse-glb-chunks.d.ts

@@ -0,0 +1,25 @@
+import { type GltfError, type Result } from './errors.js';
+import { parseGltfHeader } from './parse-gltf-header.js';
+export type { GltfHeaderJson } from './parse-gltf-header.js';
+export { parseGltfHeader };
+/** Result payload of {@link parseGlbChunks}. */
+export interface GlbChunks {
+    readonly version: number;
+    readonly length: number;
+    readonly jsonChunk: Uint8Array;
+    readonly binChunk?: Uint8Array;
+}
+/**
+ * Split a GLB 2.0 binary container into its `JSON` chunk and optional
+ * `BIN` chunk. Returns the declared `version` and `length` for the caller
+ * to surface in diagnostics.
+ *
+ * Failure path returns one of:
+ *   - `gltf-malformed-header` (magic / chunk shape / declared length / missing JSON)
+ *   - `gltf-version-unsupported` (version != 2)
+ *
+ * The function is pure: no fs / network access; the caller passes the
+ * already-loaded ArrayBuffer.
+ */
+export declare function parseGlbChunks(buffer: ArrayBuffer, filePath: string): Result<GlbChunks, GltfError>;
+//# sourceMappingURL=parse-glb-chunks.d.ts.map

package/dist/parse-glb-chunks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-glb-chunks.d.ts","sourceRoot":"","sources":["../src/parse-glb-chunks.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAO,KAAK,SAAS,EAAe,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,CAAC;AAQ3B,gDAAgD;AAChD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC;CAChC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,MAAM,GACf,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,CA4G9B"}

package/dist/parse-glb.d.ts

@@ -0,0 +1,3 @@
+export type { ExternalLoader, GltfDoc } from './parse-gltf.js';
+export { parseGlb } from './parse-gltf.js';
+//# sourceMappingURL=parse-glb.d.ts.map

package/dist/parse-glb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-glb.d.ts","sourceRoot":"","sources":["../src/parse-glb.ts"],"names":[],"mappings":"AAcA,YAAY,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/parse-gltf-header.d.ts

@@ -0,0 +1,18 @@
+import type { GltfError } from './errors.js';
+import { type Result } from './errors.js';
+/** Minimal JSON shape touched by the version gate. */
+export interface GltfHeaderJson {
+    readonly asset?: {
+        readonly version?: string;
+    };
+}
+/**
+ * Validate the top-level `asset.version` field of a parsed glTF document.
+ *
+ * On success the JSON object is echoed back unchanged (caller already owns
+ * the parsed representation). On failure, the closed `GltfErrorCode`
+ * surface narrows to either `gltf-malformed-header` (asset block missing)
+ * or `gltf-version-unsupported` (version != "2.0").
+ */
+export declare function parseGltfHeader(json: unknown, filePath: string): Result<GltfHeaderJson, GltfError>;
+//# sourceMappingURL=parse-gltf-header.d.ts.map

package/dist/parse-gltf-header.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-gltf-header.d.ts","sourceRoot":"","sources":["../src/parse-gltf-header.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAoB,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAE5D,sDAAsD;AACtD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,MAAM,GACf,MAAM,CAAC,cAAc,EAAE,SAAS,CAAC,CA2BnC"}

package/dist/parse-gltf.d.ts

@@ -0,0 +1,263 @@
+import { ImportError } from '@forgeax/engine-types';
+import { COMPONENT_TYPE } from './accessor/decode-accessor.js';
+import { type GltfError, type Result } from './errors.js';
+import { type GltfBufferViewDecodeCapability } from './meshopt-decode.js';
+import { type GltfAnimationClipRecord } from './parse-animation.js';
+import { type GltfSkeletonRecord } from './parse-skin.js';
+import { type GltfMetaJson, type GltfSubAssetEntry } from './reimport-reuse-meta.js';
+import type { GltfSourceKeyError } from './source-key.js';
+import { type DecomposedTransform } from './transform.js';
+export interface MeshPrimitiveJson {
+    readonly attributes?: Record<string, number>;
+    readonly indices?: number;
+    readonly material?: number;
+    readonly mode?: number;
+    readonly targets?: ReadonlyArray<Record<string, number>>;
+}
+export interface MeshJson {
+    readonly name?: string;
+    readonly weights?: readonly number[];
+    readonly primitives: readonly MeshPrimitiveJson[];
+}
+export interface GltfMeshIr {
+    readonly name?: string;
+    readonly positions: Float32Array;
+    readonly normals?: Float32Array;
+    readonly texcoord0?: Float32Array;
+    /** TEXCOORD_1 per-vertex UV set 1 (Float32Array, 2 per vertex). feat-20260629-multi-uv-set-support m1-w2. */
+    readonly texcoord1?: Float32Array;
+    /** TEXCOORD_2 per-vertex UV set 2 (Float32Array, 2 per vertex). */
+    readonly texcoord2?: Float32Array;
+    /** TEXCOORD_3 per-vertex UV set 3 (Float32Array, 2 per vertex). */
+    readonly texcoord3?: Float32Array;
+    /** TEXCOORD_4 per-vertex UV set 4 (Float32Array, 2 per vertex). */
+    readonly texcoord4?: Float32Array;
+    /** TEXCOORD_5 per-vertex UV set 5 (Float32Array, 2 per vertex). */
+    readonly texcoord5?: Float32Array;
+    /** TEXCOORD_6 per-vertex UV set 6 (Float32Array, 2 per vertex). */
+    readonly texcoord6?: Float32Array;
+    /** TEXCOORD_7 per-vertex UV set 7 (Float32Array, 2 per vertex). */
+    readonly texcoord7?: Float32Array;
+    readonly tangents?: Float32Array;
+    /** COLOR_0 importer carrier; bridge projects it to the canonical color attribute. */
+    readonly colors0?: Float32Array;
+    /** JOINTS_0 per-vertex joint indices (Uint16Array, 4 per vertex). UBYTE source is width-converted to U16 at parse time (D-3). */
+    readonly joints0?: Uint16Array;
+    /** WEIGHTS_0 per-vertex skin weights (Float32Array, 4 per vertex). */
+    readonly weights0?: Float32Array;
+    readonly morphTargets?: readonly {
+        readonly position?: Float32Array;
+        readonly normal?: Float32Array;
+        readonly tangent?: Float32Array;
+    }[];
+    readonly morphWeights?: Float32Array;
+    /**
+     * Optional per-glTF-spec: when omitted, primitive declares non-indexed
+     * geometry (vertex buffer is consumed in vertex order, every 3 verts =
+     * 1 triangle for triangle-list). bridge.ts handles undefined by routing
+     * MeshAsset.indices to undefined and submesh.indexCount=0 (vertexCount
+     * carries the draw count for `pass.draw(vertexCount)`).
+     * bug-20260612 hello-skin visual layered gate: prior shape coerced
+     * undefined into Uint16Array(0) and tripped MeshAsset.indices !==
+     * undefined branches downstream into drawIndexed(0).
+     * U16 (incl. widened U8) or U32 — width preserved from the source accessor;
+     * bridge.ts narrows U32 to U16 when the merged maxIndex fits.
+     */
+    readonly indices?: Uint16Array | Uint32Array;
+    readonly materialIndex: number | null;
+    /**
+     * Owning glTF mesh index in the original document (`gltf.meshes[meshIndex]`).
+     * After OOS-7 flattening, multiple GltfMeshIr entries may share the same
+     * meshIndex (one per primitive). Bridge layer uses this to filter material
+     * collection per node, fixing the verify-r1 charter-defect where multi
+     * glTF-mesh documents would silently misalign materials across nodes.
+     */
+    readonly meshIndex: number;
+}
+export interface GltfTextureIr {
+    readonly sampler?: number;
+    readonly source: number;
+    readonly name?: string;
+}
+export interface GltfTextureTransformIr {
+    readonly offset?: readonly [number, number];
+    readonly rotation?: number;
+    readonly scale?: readonly [number, number];
+}
+export interface GltfTextureInfoIr {
+    readonly texture: number;
+    readonly sampler?: number;
+    readonly texCoord?: number;
+    readonly transform?: GltfTextureTransformIr;
+}
+export interface GltfNormalTextureInfoIr extends GltfTextureInfoIr {
+    readonly scale?: number;
+}
+export interface GltfOcclusionTextureInfoIr extends GltfTextureInfoIr {
+    readonly strength?: number;
+}
+export interface GltfImageIr {
+    readonly uri?: string;
+    readonly mimeType?: string;
+    readonly bufferView?: number;
+    readonly name?: string;
+}
+export interface GltfSamplerIr {
+    readonly magFilter?: number;
+    readonly minFilter?: number;
+    readonly wrapS: number;
+    readonly wrapT: number;
+    readonly name?: string;
+}
+export interface GltfMaterialIr {
+    readonly name?: string;
+    readonly baseColorFactor: readonly [number, number, number, number];
+    /** glTF emissiveFactor; omitted means the glTF default [0, 0, 0]. */
+    readonly emissiveFactor?: readonly [number, number, number];
+    readonly baseColorTexture?: GltfTextureInfoIr | number;
+    /** Texture binding for the emissive map. */
+    readonly emissiveTexture?: GltfTextureInfoIr | number;
+    readonly metallicFactor: number;
+    readonly roughnessFactor: number;
+    readonly metallicRoughnessTexture?: GltfTextureInfoIr | number;
+    readonly normalTexture?: GltfNormalTextureInfoIr | number;
+    readonly occlusionTexture?: GltfOcclusionTextureInfoIr | number;
+    /**
+     * glTF `alphaMode` (`'OPAQUE'` | `'MASK'` | `'BLEND'`). Absent -> `'OPAQUE'`
+     * (glTF spec default). Drives the bridge's transparent / alpha-test routing.
+     */
+    readonly alphaMode?: 'OPAQUE' | 'MASK' | 'BLEND';
+    /** glTF `alphaCutoff` (MASK-mode threshold; glTF spec default 0.5). */
+    readonly alphaCutoff?: number;
+    /**
+     * glTF `doubleSided`. Absent -> false (the glTF spec default). The bridge
+     * maps this to a no-cull material pass so reverse-facing glass and cards
+     * remain visible without changing their authored winding.
+     */
+    readonly doubleSided?: boolean;
+    /**
+     * baseColorTexture UV-set index (glTF `baseColorTexture.texCoord`). Absent
+     * -> 0. Selects which interleaved UV set the base-color sampler reads.
+     */
+    readonly baseColorTexCoord?: number;
+}
+export interface NodeInstancingIr {
+    /** Number of instances. All TRS attribute accessors share this count. */
+    readonly count: number;
+    /** N column-major mat4 transforms packed into one Float32Array (length = N*16). */
+    readonly transforms: Float32Array;
+}
+export type GltfPunctualLightType = 'directional' | 'point' | 'spot';
+export interface GltfPunctualLightIr {
+    readonly type: GltfPunctualLightType;
+    readonly color: readonly [number, number, number];
+    readonly intensity: number;
+    readonly range?: number;
+    readonly spot?: {
+        readonly innerConeAngle: number;
+        readonly outerConeAngle: number;
+    };
+}
+export interface GltfNodeIr {
+    readonly name?: string;
+    readonly transform: DecomposedTransform;
+    readonly meshIndex: number | null;
+    /** Node-authored morph weights override mesh defaults at instantiation. */
+    readonly morphWeights?: Float32Array;
+    /** Valid when node carries `skin` reference. Null when no skin. */
+    readonly skinIndex: number | null;
+    readonly children: readonly number[];
+    /** Present when node carries EXT_mesh_gpu_instancing (feat-20260518). */
+    readonly instancing?: NodeInstancingIr;
+    /** glTF camera index. Null when the node does not reference a camera. */
+    readonly camera: number | null;
+    /** KHR_lights_punctual light index. Null when the node has no light. */
+    readonly lightIndex?: number | null;
+}
+export interface GltfSceneIr {
+    readonly name?: string;
+    readonly nodes: readonly number[];
+}
+export interface GltfDiagnosticsIr {
+    readonly nodeNames: readonly string[];
+    readonly unsupportedExtensions: readonly string[];
+    readonly matrixTrsCoexistNodes: readonly number[];
+}
+export interface GltfDoc {
+    readonly meshes: readonly GltfMeshIr[];
+    readonly materials: readonly GltfMaterialIr[];
+    readonly nodes: readonly GltfNodeIr[];
+    readonly scenes: readonly GltfSceneIr[];
+    readonly textures: readonly GltfTextureIr[] | undefined;
+    readonly images: readonly GltfImageIr[] | undefined;
+    readonly samplers: readonly GltfSamplerIr[] | undefined;
+    readonly skeletons: readonly GltfSkeletonRecord[];
+    readonly animationClips: readonly GltfAnimationClipRecord[];
+    readonly defaultSceneIndex: number;
+    readonly diagnostics: GltfDiagnosticsIr;
+    /** KHR_lights_punctual author facts, kept in source units for the bridge. */
+    readonly lights?: readonly GltfPunctualLightIr[];
+    /** Raw extension projection retained for bridge-only hand-constructed docs. */
+    readonly extensions?: {
+        readonly KHR_lights_punctual?: {
+            readonly lights?: readonly GltfPunctualLightIr[];
+        };
+    };
+    /**
+     * Original glTF-mesh-index -> number of primitives that mesh expanded into
+     * (feat-20260608 round-2). parseGltf flattens N glTF meshes with M_i
+     * primitives into sum(M_i) GltfMeshIr entries; this map preserves the M_i so
+     * downstream consumers (gltfDocToSceneAsset's `meshPrimitiveCount` param)
+     * can map a glTF mesh index back to the flat-GltfMeshIr offset range without
+     * re-parsing JSON.
+     *
+     * Optional for backwards compatibility with hand-constructed test
+     * fixtures; producers from parseGltf / parseGlb always populate it.
+     */
+    readonly meshPrimitiveCount?: ReadonlyMap<number, number>;
+}
+export type ExternalLoader = (uri: string) => Promise<ArrayBuffer>;
+type GltfParseError = GltfError | ImportError;
+export interface GltfParseOptions {
+    readonly meshopt?: GltfBufferViewDecodeCapability;
+}
+/**
+ * Parse a glTF 2.0 JSON document. The `externalLoader` resolves
+ * `buffers[].uri` references that are NOT data: URIs (callers in Node
+ * land typically wrap fs.readFile; browser callers wrap fetch).
+ *
+ * Pure function modulo `externalLoader` (caller-provided I/O is the
+ * only side effect). No global state, no fs / network direct call.
+ */
+export declare function parseGltfForImporter(json: unknown, externalLoader: ExternalLoader, filePath: string, options?: GltfParseOptions): Promise<Result<GltfDoc, GltfParseError>>;
+export declare function parseGltf(json: unknown, externalLoader: ExternalLoader, filePath: string, options?: GltfParseOptions): Promise<Result<GltfDoc, GltfError>>;
+/**
+ * Parse a GLB 2.0 binary container: split into JSON + BIN chunks via
+ * `parseGlbChunks`, then run the JSON document through `parseGltf` with
+ * the BIN chunk wired in as buffer-0 backing storage.
+ */
+export declare function parseGlbForImporter(buffer: ArrayBuffer, filePath: string, options?: GltfParseOptions): Promise<Result<GltfDoc, GltfParseError>>;
+export declare function parseGlb(buffer: ArrayBuffer, filePath: string, options?: GltfParseOptions): Promise<Result<GltfDoc, GltfError>>;
+export interface GltfAssetPack {
+    readonly meta: GltfMetaJson;
+    readonly subAssets: readonly GltfSubAssetEntry[];
+}
+export type GltfAssetPackResult = Result<GltfAssetPack, GltfSourceKeyError>;
+/**
+ * Project a parsed `GltfDoc` into the disk-shape `<source>.meta.json` plus
+ * the freshly minted `subAssets[]` list (UUIDv7 + reimport-reuse-meta
+ * two-stage match per plan-strategy section 2.4). Source-key conflicts are
+ * returned before GUID minting or serialization.
+ *
+ * `existingMeta` is the previously-written `<source>.meta.json` parsed back
+ * into memory (callers typically read + JSON.parse it before invoking).
+ * `undefined` triggers first-pass full-fresh GUID minting.
+ *
+ * Sub-asset ordering: meshes first, then materials, then scenes - the
+ * order is stable across reimports so AC-13 byte-identical holds when
+ * source content does not change. Stable semantic sourceKey values are
+ * assigned by the producer reuse boundary; sourceIndex remains a locator.
+ */
+export declare function toAssetPack(doc: GltfDoc, existingMeta: GltfMetaJson | undefined, source: string): GltfAssetPackResult;
+export { COMPONENT_TYPE };
+//# sourceMappingURL=parse-gltf.d.ts.map

package/dist/parse-gltf.d.ts.map

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

package/dist/parse-skin.d.ts

@@ -0,0 +1,70 @@
+import { type GltfError, type Result } from './errors.js';
+/** Maximum joints per skin (glTF spec practical limit). */
+declare const MAX_JOINTS = 256;
+/**
+ * Skeleton intermediate representation produced by parseSkin.
+ *
+ * Each entry corresponds to one glTF skin[] index. `jointPaths` is a
+ * parallel array to the skeleton's joints; each path is the sequence of
+ * Name-component values from the scene root to the joint node.
+ */
+export interface GltfSkeletonRecord {
+    /** Number of joints in this skeleton (= IBM length / 16). */
+    readonly jointCount: number;
+    /** Inverse bind matrices, Float32Array of length jointCount * 16. */
+    readonly inverseBindMatrices: Float32Array;
+    /** Per-joint Name path from scene root (parallel to joints array). */
+    readonly jointPaths: readonly string[];
+}
+interface SkinJson {
+    readonly name?: string;
+    readonly joints: readonly number[];
+    readonly inverseBindMatrices?: number;
+}
+interface NodeJson {
+    readonly name?: string;
+    readonly mesh?: number;
+    readonly children?: readonly number[];
+    readonly skin?: number;
+}
+interface AccessorJson {
+    readonly bufferView?: number;
+    readonly componentType: number;
+    readonly type: string;
+    readonly count: number;
+    readonly byteOffset?: number;
+}
+interface BufferViewJson {
+    readonly buffer: number;
+    readonly byteOffset?: number;
+    readonly byteLength: number;
+    readonly byteStride?: number;
+}
+/**
+ * Parse glTF skins[] array into GltfSkeletonRecord[].
+ *
+ * For each skin:
+ * 1. Decode IBM accessor (or fill identity if absent)
+ * 2. Resolve jointPaths from scene node hierarchy
+ * 3. Fail-fast on joint count > MAX_JOINTS or missing joint names
+ */
+export declare function parseSkin(skinsJson: readonly SkinJson[] | undefined, nodesJson: readonly NodeJson[], accessors: readonly AccessorJson[], bufferViews: readonly BufferViewJson[], buffers: readonly Uint8Array[]): Result<readonly GltfSkeletonRecord[], GltfError>;
+/**
+ * Compute the BindPose static AABB for a skinned mesh's vertex positions.
+ *
+ * At bind pose, joint_bind = IBM^{-1}, so skinning collapses:
+ *   world_pos = Sum(w_i * joint_bind_i * IBM_i * local_pos) = local_pos
+ * Therefore the BindPose AABB is simply the local position bounds.
+ *
+ * Per-frame zero cost: stored in mesh asset metadata at importer time.
+ * Dynamic AABB for animated poses is deferred to OOS-skin-dyn-bounds.
+ *
+ * Returns { min: [x,y,z], max: [x,y,z] } or undefined if positions is empty.
+ */
+export declare function computeBindPoseAABB(positions: Float32Array): {
+    readonly min: readonly [number, number, number];
+    readonly max: readonly [number, number, number];
+} | undefined;
+/** Re-export MAX_JOINTS for use by downstream modules. */
+export { MAX_JOINTS };
+//# sourceMappingURL=parse-skin.d.ts.map

package/dist/parse-skin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-skin.d.ts","sourceRoot":"","sources":["../src/parse-skin.ts"],"names":[],"mappings":"AAeA,OAAO,EAAO,KAAK,SAAS,EAAe,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAG5E,2DAA2D;AAC3D,QAAA,MAAM,UAAU,MAAM,CAAC;AAEvB;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,6DAA6D;IAC7D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,qEAAqE;IACrE,QAAQ,CAAC,mBAAmB,EAAE,YAAY,CAAC;IAC3C,sEAAsE;IACtE,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED,UAAU,QAAQ;IAChB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CACvC;AAED,UAAU,QAAQ;IAChB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,YAAY;IACpB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,UAAU,cAAc;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AA6CD;;;;;;;GAOG;AACH,wBAAgB,SAAS,CACvB,SAAS,EAAE,SAAS,QAAQ,EAAE,GAAG,SAAS,EAC1C,SAAS,EAAE,SAAS,QAAQ,EAAE,EAC9B,SAAS,EAAE,SAAS,YAAY,EAAE,EAClC,WAAW,EAAE,SAAS,cAAc,EAAE,EACtC,OAAO,EAAE,SAAS,UAAU,EAAE,GAC7B,MAAM,CAAC,SAAS,kBAAkB,EAAE,EAAE,SAAS,CAAC,CAyElD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,YAAY,GACvD;IACE,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACjD,GACD,SAAS,CAoBZ;AAED,0DAA0D;AAC1D,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/reimport-reuse-meta.d.ts

@@ -0,0 +1,48 @@
+import { type Result } from './errors.js';
+import { type GltfSourceKeyError } from './source-key.js';
+import { type GltfDocItemLike, subAssetKey } from './sub-asset-key.js';
+export type { SubAssetKey } from './sub-asset-key.js';
+export { subAssetKey };
+export type GltfDocItem = GltfDocItemLike;
+/** Subset of `<source>.meta.json` fields (importer=gltf arm) touched by the reuse algorithm. */
+export interface GltfSubAssetEntry {
+    readonly guid: string;
+    readonly sourceIndex: number;
+    readonly kind: string;
+    readonly sourceKey?: string;
+    /** Optional display name copied from the current glTF output. */
+    readonly name?: string;
+}
+export interface GltfMetaJson {
+    readonly schemaVersion: 1;
+    readonly kind: 'external-asset-package';
+    readonly importer: 'gltf';
+    readonly source: string;
+    readonly subAssets: readonly GltfSubAssetEntry[];
+    readonly sourceOverrides?: Readonly<Record<string, Readonly<Record<string, unknown>>>>;
+    readonly sourceOverrideDescriptors?: readonly import('@forgeax/engine-types').SourceOverrideDescriptor[];
+    readonly importSettings: {
+        readonly defaultSceneIndex: number;
+        readonly standardMaterialGuid?: string;
+        readonly downscaleMaxDimension?: number;
+        readonly diagnostics: {
+            readonly nodeNames: readonly string[];
+            readonly unsupportedExtensions: readonly string[];
+            readonly matrixTrsCoexistNodes: readonly number[];
+        };
+    };
+}
+export interface ReimportReuseValue {
+    readonly subAssets: readonly GltfSubAssetEntry[];
+}
+export type ReimportReuseResult = Result<ReimportReuseValue, GltfSourceKeyError>;
+/**
+ * Apply the two-stage reuse algorithm to a freshly parsed item list.
+ * Returns the new `subAssets[]` array (preserving item order), or a
+ * structured source-key conflict before any output is published.
+ *
+ * Pure function: no fs / network / global state. `AssetGuid.random()` is
+ * the only entropy source; deterministic in absence of new items.
+ */
+export declare function reimportReuseMeta(items: readonly GltfDocItem[], existingMeta: GltfMetaJson | undefined): ReimportReuseResult;
+//# sourceMappingURL=reimport-reuse-meta.d.ts.map

package/dist/reimport-reuse-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reimport-reuse-meta.d.ts","sourceRoot":"","sources":["../src/reimport-reuse-meta.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAEL,KAAK,kBAAkB,EAExB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,KAAK,eAAe,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEvE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,CAAC;AACvB,MAAM,MAAM,WAAW,GAAG,eAAe,CAAC;AAE1C,gGAAgG;AAChG,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,iEAAiE;IACjE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACjD,QAAQ,CAAC,eAAe,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACvF,QAAQ,CAAC,yBAAyB,CAAC,EAAE,SAAS,OAAO,uBAAuB,EAAE,wBAAwB,EAAE,CAAC;IACzG,QAAQ,CAAC,cAAc,EAAE;QACvB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;QACnC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;QACvC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;QACxC,QAAQ,CAAC,WAAW,EAAE;YACpB,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;YACtC,QAAQ,CAAC,qBAAqB,EAAE,SAAS,MAAM,EAAE,CAAC;YAClD,QAAQ,CAAC,qBAAqB,EAAE,SAAS,MAAM,EAAE,CAAC;SACnD,CAAC;KACH,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAClD;AAED,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,CAAC;AAEjF;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,WAAW,EAAE,EAC7B,YAAY,EAAE,YAAY,GAAG,SAAS,GACrC,mBAAmB,CAmDrB"}

package/dist/serialize-meta.d.ts

@@ -0,0 +1,2 @@
+export declare function serializeMetaJson(meta: unknown): string;
+//# sourceMappingURL=serialize-meta.d.ts.map

package/dist/serialize-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize-meta.d.ts","sourceRoot":"","sources":["../src/serialize-meta.ts"],"names":[],"mappings":"AAqBA,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAEvD"}

package/dist/source-key.d.ts

@@ -0,0 +1,44 @@
+import type { GltfDocItemLike } from './sub-asset-key.js';
+interface GltfSourceKeyErrorBase {
+    readonly expected: string;
+    readonly hint: string;
+}
+export interface GltfSourceKeyConflictEntry {
+    readonly kind: string;
+    readonly name: string | null;
+    readonly sourceIndex: number;
+}
+export type GltfSourceKeyError = (GltfSourceKeyErrorBase & {
+    readonly code: 'missing-source-key';
+    readonly detail: {
+        readonly sourceIndices: readonly number[];
+    };
+}) | (GltfSourceKeyErrorBase & {
+    readonly code: 'duplicate-source-key' | 'ambiguous-source-key';
+    readonly detail: {
+        readonly key: string;
+        readonly sourceIndices: readonly number[];
+        readonly entries: readonly GltfSourceKeyConflictEntry[];
+    };
+}) | (GltfSourceKeyErrorBase & {
+    readonly code: 'mesh-material-slot-topology-change';
+    readonly detail: {
+        readonly sourceIndices: readonly number[];
+        readonly previousIndices: readonly number[];
+    };
+});
+export type GltfSourceKeyErrorCode = GltfSourceKeyError['code'];
+export type GltfSourceKeyResult = {
+    readonly ok: true;
+    readonly keys: readonly string[];
+    readonly conflicts: readonly [];
+} | {
+    readonly ok: false;
+    readonly error: GltfSourceKeyError;
+};
+/** Derive a semantic glTF key; sourceIndex and source path are never inputs. */
+export declare function sourceKeyForGltfOutput(item: Pick<GltfDocItemLike, 'kind' | 'name'>): string | undefined;
+/** Require every output in a multi-output declaration to carry a unique key. */
+export declare function deriveGltfSourceKeys(items: readonly GltfDocItemLike[]): GltfSourceKeyResult;
+export {};
+//# sourceMappingURL=source-key.d.ts.map

package/dist/source-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-key.d.ts","sourceRoot":"","sources":["../src/source-key.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,UAAU,sBAAsB;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,MAAM,kBAAkB,GAC1B,CAAC,sBAAsB,GAAG;IACxB,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC;CAChE,CAAC,GACF,CAAC,sBAAsB,GAAG;IACxB,QAAQ,CAAC,IAAI,EAAE,sBAAsB,GAAG,sBAAsB,CAAC;IAC/D,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;QAC1C,QAAQ,CAAC,OAAO,EAAE,SAAS,0BAA0B,EAAE,CAAC;KACzD,CAAC;CACH,CAAC,GACF,CAAC,sBAAsB,GAAG;IACxB,QAAQ,CAAC,IAAI,EAAE,oCAAoC,CAAC;IACpD,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;QAC1C,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;KAC7C,CAAC;CACH,CAAC,CAAC;AAEP,MAAM,MAAM,sBAAsB,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAEhE,MAAM,MAAM,mBAAmB,GAC3B;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,CAAA;CAAE,GACxF;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAE/D,gFAAgF;AAChF,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAAC,GAC3C,MAAM,GAAG,SAAS,CAKpB;AAED,gFAAgF;AAChF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,GAAG,mBAAmB,CAsD3F"}

package/dist/sub-asset-key.d.ts

@@ -0,0 +1,12 @@
+export interface GltfDocItemLike {
+    readonly kind: string;
+    readonly sourceIndex: number;
+    readonly name?: string;
+}
+export interface SubAssetKey {
+    readonly kind: string;
+    readonly name: string | null;
+    readonly indexFallback: string;
+}
+export declare function subAssetKey(item: GltfDocItemLike): SubAssetKey;
+//# sourceMappingURL=sub-asset-key.d.ts.map

package/dist/sub-asset-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sub-asset-key.d.ts","sourceRoot":"","sources":["../src/sub-asset-key.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AA2BD,wBAAgB,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,WAAW,CAM9D"}

package/dist/to-asset-pack.d.ts

@@ -0,0 +1,2 @@
+export { toAssetPack } from './parse-gltf.js';
+//# sourceMappingURL=to-asset-pack.d.ts.map

package/dist/to-asset-pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-asset-pack.d.ts","sourceRoot":"","sources":["../src/to-asset-pack.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/transform.d.ts

@@ -0,0 +1,37 @@
+/** glTF VEC3 literal accepted by node.translation / node.scale. */
+export type Vec3Tuple = readonly [number, number, number];
+/** glTF VEC4 quaternion literal accepted by node.rotation. */
+export type Vec4Tuple = readonly [number, number, number, number];
+/** Minimal node JSON shape touched by the decomposer. */
+export interface NodeTransformJson {
+    readonly matrix?: readonly number[];
+    readonly translation?: readonly number[];
+    readonly rotation?: readonly number[];
+    readonly scale?: readonly number[];
+}
+/** Mutable diagnostics accumulator (writes to .matrixTrsCoexistNodes only). */
+export interface TransformDiagnostics {
+    matrixTrsCoexistNodes: number[];
+}
+export interface DecomposedTransform {
+    readonly translation: Vec3Tuple;
+    readonly rotation: Vec4Tuple;
+    readonly scale: Vec3Tuple;
+}
+/**
+ * Decompose a glTF node's transform into a POD readonly TRS triple.
+ *
+ * Decision tree:
+ *   1. matrix present                -> mat4.decompose 3-arg in-place; if
+ *                                       any TRS field is also present,
+ *                                       stderr warn + push nodeIndex into
+ *                                       diagnostics.matrixTrsCoexistNodes.
+ *   2. only TRS fields present       -> use them verbatim (defaults filled).
+ *   3. nothing present               -> identity (0/0/0, 0/0/0/1, 1/1/1).
+ *
+ * Return type is `readonly` POD tuple, deliberately not Vec3/Quat from
+ * @forgeax/engine-math, so the importer's IR stays brand-free
+ * (plan-strategy decision section 2.7 / OQ-2).
+ */
+export declare function decomposeNodeTransform(node: NodeTransformJson, nodeIndex: number, diagnostics: TransformDiagnostics): DecomposedTransform;
+//# sourceMappingURL=transform.d.ts.map

package/dist/transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../src/transform.ts"],"names":[],"mappings":"AAmBA,mEAAmE;AACnE,MAAM,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAC1D,8DAA8D;AAC9D,MAAM,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAElE,yDAAyD;AACzD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED,+EAA+E;AAC/E,MAAM,WAAW,oBAAoB;IACnC,qBAAqB,EAAE,MAAM,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,WAAW,EAAE,SAAS,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;CAC3B;AAuBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,iBAAiB,EACvB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,oBAAoB,GAChC,mBAAmB,CAiCrB"}