@babylonjs/loaders 9.12.0 → 9.12.1

package/FBX/interpreter/connections.js

@@ -0,0 +1,233 @@
+/* eslint-disable @typescript-eslint/naming-convention, jsdoc/require-param, jsdoc/require-returns */
+import { cleanFBXName, findDocumentNode, getPropertyValue, getSafeFBXObjectId } from "../types/fbxTypes.js";
+/**
+ * Build a connection graph from a parsed FBX document.
+ * Maps object IDs to their FBXNode and resolves parent-child relationships.
+ */
+export function resolveConnections(doc) {
+    const objects = new Map();
+    const objectEntries = [];
+    const childrenOf = new Map();
+    const parentOf = new Map();
+    const connections = [];
+    const connectionEntries = [];
+    const diagnostics = [];
+    const legacyIds = new Map();
+    const syntheticLegacyIds = new Map();
+    let nextLegacyId = -1;
+    const getLegacyId = (name) => {
+        let id = legacyIds.get(name);
+        if (id === undefined) {
+            id = nextLegacyId--;
+            legacyIds.set(name, id);
+        }
+        return id;
+    };
+    const getSyntheticLegacyId = (role, name) => {
+        let idsByName = syntheticLegacyIds.get(role);
+        if (!idsByName) {
+            idsByName = new Map();
+            syntheticLegacyIds.set(role, idsByName);
+        }
+        let id = idsByName.get(name);
+        if (id === undefined) {
+            id = nextLegacyId--;
+            idsByName.set(name, id);
+        }
+        return id;
+    };
+    // Build object map from Objects section
+    const objectsNode = findDocumentNode(doc, "Objects");
+    if (objectsNode) {
+        for (const obj of objectsNode.children) {
+            const idProp = obj.properties[0];
+            if (idProp) {
+                const id = toObjectNumber(idProp.value);
+                if (id !== undefined) {
+                    objects.set(id, obj);
+                    objectEntries.push({ id, node: obj, source: "Objects", synthetic: false });
+                }
+                else if (typeof idProp.value === "string") {
+                    const legacyName = cleanFBXName(idProp.value);
+                    const id = getLegacyId(legacyName);
+                    const normalized = normalizeLegacyObject(obj, id);
+                    objects.set(id, normalized);
+                    objectEntries.push({ id, node: normalized, source: "Objects", legacyName, synthetic: false });
+                    if (obj.name === "Model" && getPropertyValue(obj, 1) === "Mesh") {
+                        const geometryId = getSyntheticLegacyId("Geometry", legacyName);
+                        const geometry = createLegacyGeometry(obj, geometryId);
+                        objects.set(geometryId, geometry);
+                        objectEntries.push({ id: geometryId, node: geometry, source: "legacySyntheticGeometry", legacyName, synthetic: true });
+                        addConnection(connections, childrenOf, parentOf, diagnostics, "OO", geometryId, id);
+                    }
+                }
+            }
+        }
+    }
+    // Parse connections
+    const connectionsNode = findDocumentNode(doc, "Connections");
+    if (connectionsNode) {
+        for (const c of connectionsNode.children) {
+            if (c.name !== "C" && c.name !== "Connect") {
+                continue;
+            }
+            const connectionIndex = connectionEntries.length;
+            const type = getPropertyValue(c, 0);
+            const childIdRaw = c.properties[1]?.value;
+            const parentIdRaw = c.properties[2]?.value;
+            const entry = {
+                source: c.name,
+                rawType: type,
+                accepted: false,
+            };
+            connectionEntries.push(entry);
+            if (type !== "OO" && type !== "OP") {
+                const childId = childIdRaw === undefined ? undefined : toObjectId(childIdRaw, legacyIds);
+                const parentId = parentIdRaw === undefined ? undefined : toObjectId(parentIdRaw, legacyIds);
+                diagnostics.push({
+                    reason: "unsupported-connection-type",
+                    message: `Unsupported FBX connection type '${type ?? ""}' was not added to the graph.`,
+                    connectionIndex,
+                    type,
+                    childId,
+                    parentId,
+                });
+                continue;
+            }
+            if (childIdRaw === undefined || parentIdRaw === undefined) {
+                diagnostics.push({
+                    reason: "missing-connection-endpoint",
+                    message: "FBX connection is missing a child or parent endpoint.",
+                    connectionIndex,
+                    type,
+                });
+                continue;
+            }
+            const childId = toObjectId(childIdRaw, legacyIds);
+            const parentId = toObjectId(parentIdRaw, legacyIds);
+            if (childId === undefined || parentId === undefined) {
+                diagnostics.push({
+                    reason: "unresolved-legacy-endpoint",
+                    message: "FBX connection references a legacy string endpoint that is not present in the object table.",
+                    connectionIndex,
+                    type,
+                });
+                continue;
+            }
+            const propertyName = type === "OP" && c.properties.length > 3 ? getPropertyValue(c, 3) : undefined;
+            entry.childId = childId;
+            entry.parentId = parentId;
+            entry.propertyName = propertyName;
+            if (childId === parentId) {
+                diagnostics.push({
+                    reason: "self-loop",
+                    message: "FBX connection references the same object as child and parent.",
+                    connectionIndex,
+                    type,
+                    childId,
+                    parentId,
+                    propertyName,
+                });
+            }
+            if (!objects.has(childId)) {
+                diagnostics.push({
+                    reason: "unresolved-object-reference",
+                    message: "FBX connection child ID is not present in the object table.",
+                    connectionIndex,
+                    type,
+                    childId,
+                    parentId,
+                    propertyName,
+                });
+            }
+            if (parentId !== 0 && !objects.has(parentId)) {
+                diagnostics.push({
+                    reason: "unresolved-object-reference",
+                    message: "FBX connection parent ID is not present in the object table.",
+                    connectionIndex,
+                    type,
+                    childId,
+                    parentId,
+                    propertyName,
+                });
+            }
+            addConnection(connections, childrenOf, parentOf, diagnostics, type, childId, parentId, propertyName, connectionIndex);
+            entry.accepted = true;
+        }
+    }
+    return { objects, objectEntries, childrenOf, parentOf, connections, connectionEntries, diagnostics };
+}
+/** Get all child objects of a given parent ID, optionally filtered by node name */
+export function getChildren(map, parentId, nodeName) {
+    const children = map.childrenOf.get(parentId) ?? [];
+    const result = [];
+    for (const child of children) {
+        const node = map.objects.get(child.id);
+        if (node && (!nodeName || node.name === nodeName)) {
+            result.push({ id: child.id, node, propertyName: child.propertyName });
+        }
+    }
+    return result;
+}
+function toObjectNumber(value) {
+    return getSafeFBXObjectId(value);
+}
+function toObjectId(value, legacyIds) {
+    const numericId = toObjectNumber(value);
+    if (numericId !== undefined) {
+        return numericId;
+    }
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const legacyName = cleanFBXName(value);
+    if (legacyName === "Scene") {
+        return 0;
+    }
+    return legacyIds.get(legacyName);
+}
+function addConnection(connections, childrenOf, parentOf, diagnostics, type, childId, parentId, propertyName, connectionIndex) {
+    connections.push({ type, childId, parentId, propertyName });
+    if (!childrenOf.has(parentId)) {
+        childrenOf.set(parentId, []);
+    }
+    childrenOf.get(parentId).push({ id: childId, propertyName });
+    const existingParent = parentOf.get(childId);
+    if (existingParent) {
+        diagnostics.push({
+            reason: "duplicate-parent",
+            message: "FBX object has multiple parents; preserving the existing last-parent behavior.",
+            connectionIndex,
+            type,
+            childId,
+            parentId,
+            propertyName,
+        });
+    }
+    parentOf.set(childId, { id: parentId, propertyName });
+}
+function normalizeLegacyObject(node, id) {
+    const name = cleanFBXName(getPropertyValue(node, 0) ?? node.name);
+    const subType = getPropertyValue(node, 1) ?? "";
+    return {
+        ...node,
+        properties: [
+            { type: "int64", value: id },
+            { type: "string", value: name },
+            { type: "string", value: subType },
+        ],
+    };
+}
+function createLegacyGeometry(modelNode, geometryId) {
+    const name = cleanFBXName(getPropertyValue(modelNode, 0) ?? "Geometry");
+    return {
+        name: "Geometry",
+        properties: [
+            { type: "int64", value: geometryId },
+            { type: "string", value: name },
+            { type: "string", value: "Mesh" },
+        ],
+        children: modelNode.children,
+    };
+}
+//# sourceMappingURL=connections.js.map

package/FBX/interpreter/connections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connections.js","sourceRoot":"","sources":["../../../../../dev/loaders/src/FBX/interpreter/connections.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable @typescript-eslint/naming-convention, jsdoc/require-param, jsdoc/require-returns */\r\nimport { type FBXDocument, type FBXNode, cleanFBXName, findDocumentNode, getPropertyValue, getSafeFBXObjectId } from \"../types/fbxTypes\";\r\n\r\n/** Connection type: OO = object-to-object, OP = object-to-property */\r\nexport type ConnectionType = \"OO\" | \"OP\";\r\n\r\n/** A resolved FBX object connection. */\r\nexport interface FBXConnection {\r\n    /** Connection type. */\r\n    type: ConnectionType;\r\n    /** Child object ID. */\r\n    childId: number;\r\n    /** Parent object ID. */\r\n    parentId: number;\r\n    /** For OP connections, the property name on the parent (e.g. \"DiffuseColor\") */\r\n    propertyName?: string;\r\n}\r\n\r\n/** Object table entry used by the FBX connection graph. */\r\nexport interface FBXObjectEntry {\r\n    /** Object ID. */\r\n    id: number;\r\n    /** Object node. */\r\n    node: FBXNode;\r\n    /** Source of the object entry. */\r\n    source: \"Objects\" | \"legacySyntheticGeometry\";\r\n    /** Legacy string object name, when applicable. */\r\n    legacyName?: string;\r\n    /** True if the object was synthesized for legacy compatibility. */\r\n    synthetic: boolean;\r\n}\r\n\r\n/** Raw connection-table entry and import status. */\r\nexport interface FBXConnectionEntry {\r\n    /** Source node name. */\r\n    source: \"C\" | \"Connect\";\r\n    /** Raw connection type. */\r\n    rawType?: string;\r\n    /** Child object ID, when resolved. */\r\n    childId?: number;\r\n    /** Parent object ID, when resolved. */\r\n    parentId?: number;\r\n    /** OP connection property name, when present. */\r\n    propertyName?: string;\r\n    /** True if the connection was accepted into the resolved graph. */\r\n    accepted: boolean;\r\n}\r\n\r\n/** Reason a connection produced a diagnostic. */\r\nexport type FBXConnectionDiagnosticReason =\r\n    | \"unsupported-connection-type\"\r\n    | \"missing-connection-endpoint\"\r\n    | \"unresolved-legacy-endpoint\"\r\n    | \"unresolved-object-reference\"\r\n    | \"duplicate-parent\"\r\n    | \"self-loop\";\r\n\r\n/** Recoverable connection graph issue. */\r\nexport interface FBXConnectionDiagnostic {\r\n    /** Diagnostic reason. */\r\n    reason: FBXConnectionDiagnosticReason;\r\n    /** Human-readable diagnostic message. */\r\n    message: string;\r\n    /** Connection-table index associated with the diagnostic, if applicable. */\r\n    connectionIndex?: number;\r\n    /** Connection type associated with the diagnostic, if applicable. */\r\n    type?: string;\r\n    /** Child object ID associated with the diagnostic, if applicable. */\r\n    childId?: number;\r\n    /** Parent object ID associated with the diagnostic, if applicable. */\r\n    parentId?: number;\r\n    /** OP connection property name associated with the diagnostic, if applicable. */\r\n    propertyName?: string;\r\n}\r\n\r\n/** Resolved FBX object and connection graph. */\r\nexport interface FBXObjectMap {\r\n    /** All objects by their unique ID */\r\n    objects: Map<number, FBXNode>;\r\n    /** Object table entries, including synthetic compatibility objects */\r\n    objectEntries: FBXObjectEntry[];\r\n    /** Children of each object ID */\r\n    childrenOf: Map<number, { id: number; propertyName?: string }[]>;\r\n    /** Parent of each object ID */\r\n    parentOf: Map<number, { id: number; propertyName?: string }>;\r\n    /** Raw connection list */\r\n    connections: FBXConnection[];\r\n    /** Raw connection-table entries and whether they were accepted into the graph */\r\n    connectionEntries: FBXConnectionEntry[];\r\n    /** Unsupported or suspicious connection shapes encountered while preserving graph behavior */\r\n    diagnostics: FBXConnectionDiagnostic[];\r\n}\r\n\r\n/**\r\n * Build a connection graph from a parsed FBX document.\r\n * Maps object IDs to their FBXNode and resolves parent-child relationships.\r\n */\r\nexport function resolveConnections(doc: FBXDocument): FBXObjectMap {\r\n    const objects = new Map<number, FBXNode>();\r\n    const objectEntries: FBXObjectEntry[] = [];\r\n    const childrenOf = new Map<number, { id: number; propertyName?: string }[]>();\r\n    const parentOf = new Map<number, { id: number; propertyName?: string }>();\r\n    const connections: FBXConnection[] = [];\r\n    const connectionEntries: FBXConnectionEntry[] = [];\r\n    const diagnostics: FBXConnectionDiagnostic[] = [];\r\n    const legacyIds = new Map<string, number>();\r\n    const syntheticLegacyIds = new Map<string, Map<string, number>>();\r\n    let nextLegacyId = -1;\r\n\r\n    const getLegacyId = (name: string): number => {\r\n        let id = legacyIds.get(name);\r\n        if (id === undefined) {\r\n            id = nextLegacyId--;\r\n            legacyIds.set(name, id);\r\n        }\r\n        return id;\r\n    };\r\n\r\n    const getSyntheticLegacyId = (role: string, name: string): number => {\r\n        let idsByName = syntheticLegacyIds.get(role);\r\n        if (!idsByName) {\r\n            idsByName = new Map();\r\n            syntheticLegacyIds.set(role, idsByName);\r\n        }\r\n\r\n        let id = idsByName.get(name);\r\n        if (id === undefined) {\r\n            id = nextLegacyId--;\r\n            idsByName.set(name, id);\r\n        }\r\n        return id;\r\n    };\r\n\r\n    // Build object map from Objects section\r\n    const objectsNode = findDocumentNode(doc, \"Objects\");\r\n    if (objectsNode) {\r\n        for (const obj of objectsNode.children) {\r\n            const idProp = obj.properties[0];\r\n            if (idProp) {\r\n                const id = toObjectNumber(idProp.value);\r\n                if (id !== undefined) {\r\n                    objects.set(id, obj);\r\n                    objectEntries.push({ id, node: obj, source: \"Objects\", synthetic: false });\r\n                } else if (typeof idProp.value === \"string\") {\r\n                    const legacyName = cleanFBXName(idProp.value);\r\n                    const id = getLegacyId(legacyName);\r\n                    const normalized = normalizeLegacyObject(obj, id);\r\n                    objects.set(id, normalized);\r\n                    objectEntries.push({ id, node: normalized, source: \"Objects\", legacyName, synthetic: false });\r\n\r\n                    if (obj.name === \"Model\" && getPropertyValue<string>(obj, 1) === \"Mesh\") {\r\n                        const geometryId = getSyntheticLegacyId(\"Geometry\", legacyName);\r\n                        const geometry = createLegacyGeometry(obj, geometryId);\r\n                        objects.set(geometryId, geometry);\r\n                        objectEntries.push({ id: geometryId, node: geometry, source: \"legacySyntheticGeometry\", legacyName, synthetic: true });\r\n                        addConnection(connections, childrenOf, parentOf, diagnostics, \"OO\", geometryId, id);\r\n                    }\r\n                }\r\n            }\r\n        }\r\n    }\r\n\r\n    // Parse connections\r\n    const connectionsNode = findDocumentNode(doc, \"Connections\");\r\n    if (connectionsNode) {\r\n        for (const c of connectionsNode.children) {\r\n            if (c.name !== \"C\" && c.name !== \"Connect\") {\r\n                continue;\r\n            }\r\n\r\n            const connectionIndex = connectionEntries.length;\r\n            const type = getPropertyValue<string>(c, 0);\r\n            const childIdRaw = c.properties[1]?.value;\r\n            const parentIdRaw = c.properties[2]?.value;\r\n            const entry: FBXConnectionEntry = {\r\n                source: c.name,\r\n                rawType: type,\r\n                accepted: false,\r\n            };\r\n            connectionEntries.push(entry);\r\n\r\n            if (type !== \"OO\" && type !== \"OP\") {\r\n                const childId = childIdRaw === undefined ? undefined : toObjectId(childIdRaw, legacyIds);\r\n                const parentId = parentIdRaw === undefined ? undefined : toObjectId(parentIdRaw, legacyIds);\r\n                diagnostics.push({\r\n                    reason: \"unsupported-connection-type\",\r\n                    message: `Unsupported FBX connection type '${type ?? \"\"}' was not added to the graph.`,\r\n                    connectionIndex,\r\n                    type,\r\n                    childId,\r\n                    parentId,\r\n                });\r\n                continue;\r\n            }\r\n\r\n            if (childIdRaw === undefined || parentIdRaw === undefined) {\r\n                diagnostics.push({\r\n                    reason: \"missing-connection-endpoint\",\r\n                    message: \"FBX connection is missing a child or parent endpoint.\",\r\n                    connectionIndex,\r\n                    type,\r\n                });\r\n                continue;\r\n            }\r\n\r\n            const childId = toObjectId(childIdRaw, legacyIds);\r\n            const parentId = toObjectId(parentIdRaw, legacyIds);\r\n            if (childId === undefined || parentId === undefined) {\r\n                diagnostics.push({\r\n                    reason: \"unresolved-legacy-endpoint\",\r\n                    message: \"FBX connection references a legacy string endpoint that is not present in the object table.\",\r\n                    connectionIndex,\r\n                    type,\r\n                });\r\n                continue;\r\n            }\r\n\r\n            const propertyName = type === \"OP\" && c.properties.length > 3 ? getPropertyValue<string>(c, 3) : undefined;\r\n\r\n            entry.childId = childId;\r\n            entry.parentId = parentId;\r\n            entry.propertyName = propertyName;\r\n\r\n            if (childId === parentId) {\r\n                diagnostics.push({\r\n                    reason: \"self-loop\",\r\n                    message: \"FBX connection references the same object as child and parent.\",\r\n                    connectionIndex,\r\n                    type,\r\n                    childId,\r\n                    parentId,\r\n                    propertyName,\r\n                });\r\n            }\r\n            if (!objects.has(childId)) {\r\n                diagnostics.push({\r\n                    reason: \"unresolved-object-reference\",\r\n                    message: \"FBX connection child ID is not present in the object table.\",\r\n                    connectionIndex,\r\n                    type,\r\n                    childId,\r\n                    parentId,\r\n                    propertyName,\r\n                });\r\n            }\r\n            if (parentId !== 0 && !objects.has(parentId)) {\r\n                diagnostics.push({\r\n                    reason: \"unresolved-object-reference\",\r\n                    message: \"FBX connection parent ID is not present in the object table.\",\r\n                    connectionIndex,\r\n                    type,\r\n                    childId,\r\n                    parentId,\r\n                    propertyName,\r\n                });\r\n            }\r\n\r\n            addConnection(connections, childrenOf, parentOf, diagnostics, type, childId, parentId, propertyName, connectionIndex);\r\n            entry.accepted = true;\r\n        }\r\n    }\r\n\r\n    return { objects, objectEntries, childrenOf, parentOf, connections, connectionEntries, diagnostics };\r\n}\r\n\r\n/** Get all child objects of a given parent ID, optionally filtered by node name */\r\nexport function getChildren(map: FBXObjectMap, parentId: number, nodeName?: string): { id: number; node: FBXNode; propertyName?: string }[] {\r\n    const children = map.childrenOf.get(parentId) ?? [];\r\n    const result: { id: number; node: FBXNode; propertyName?: string }[] = [];\r\n\r\n    for (const child of children) {\r\n        const node = map.objects.get(child.id);\r\n        if (node && (!nodeName || node.name === nodeName)) {\r\n            result.push({ id: child.id, node, propertyName: child.propertyName });\r\n        }\r\n    }\r\n\r\n    return result;\r\n}\r\n\r\nfunction toObjectNumber(value: unknown): number | undefined {\r\n    return getSafeFBXObjectId(value);\r\n}\r\n\r\nfunction toObjectId(value: unknown, legacyIds: Map<string, number>): number | undefined {\r\n    const numericId = toObjectNumber(value);\r\n    if (numericId !== undefined) {\r\n        return numericId;\r\n    }\r\n    if (typeof value !== \"string\") {\r\n        return undefined;\r\n    }\r\n    const legacyName = cleanFBXName(value);\r\n    if (legacyName === \"Scene\") {\r\n        return 0;\r\n    }\r\n    return legacyIds.get(legacyName);\r\n}\r\n\r\nfunction addConnection(\r\n    connections: FBXConnection[],\r\n    childrenOf: Map<number, { id: number; propertyName?: string }[]>,\r\n    parentOf: Map<number, { id: number; propertyName?: string }>,\r\n    diagnostics: FBXConnectionDiagnostic[],\r\n    type: ConnectionType,\r\n    childId: number,\r\n    parentId: number,\r\n    propertyName?: string,\r\n    connectionIndex?: number\r\n): void {\r\n    connections.push({ type, childId, parentId, propertyName });\r\n\r\n    if (!childrenOf.has(parentId)) {\r\n        childrenOf.set(parentId, []);\r\n    }\r\n    childrenOf.get(parentId)!.push({ id: childId, propertyName });\r\n    const existingParent = parentOf.get(childId);\r\n    if (existingParent) {\r\n        diagnostics.push({\r\n            reason: \"duplicate-parent\",\r\n            message: \"FBX object has multiple parents; preserving the existing last-parent behavior.\",\r\n            connectionIndex,\r\n            type,\r\n            childId,\r\n            parentId,\r\n            propertyName,\r\n        });\r\n    }\r\n    parentOf.set(childId, { id: parentId, propertyName });\r\n}\r\n\r\nfunction normalizeLegacyObject(node: FBXNode, id: number): FBXNode {\r\n    const name = cleanFBXName(getPropertyValue<string>(node, 0) ?? node.name);\r\n    const subType = getPropertyValue<string>(node, 1) ?? \"\";\r\n    return {\r\n        ...node,\r\n        properties: [\r\n            { type: \"int64\", value: id },\r\n            { type: \"string\", value: name },\r\n            { type: \"string\", value: subType },\r\n        ],\r\n    };\r\n}\r\n\r\nfunction createLegacyGeometry(modelNode: FBXNode, geometryId: number): FBXNode {\r\n    const name = cleanFBXName(getPropertyValue<string>(modelNode, 0) ?? \"Geometry\");\r\n    return {\r\n        name: \"Geometry\",\r\n        properties: [\r\n            { type: \"int64\", value: geometryId },\r\n            { type: \"string\", value: name },\r\n            { type: \"string\", value: \"Mesh\" },\r\n        ],\r\n        children: modelNode.children,\r\n    };\r\n}\r\n"]}

package/FBX/interpreter/fbxInterpreter.d.ts

@@ -0,0 +1,149 @@
+import { type FBXDocument } from "../types/fbxTypes.js";
+import { type FBXGeometryData } from "./geometry.js";
+import { type FBXMaterialData } from "./materials.js";
+import { type FBXSkinData } from "./skeleton.js";
+import { type FBXRigData } from "./rig.js";
+import { type FBXAnimationStackData } from "./animation.js";
+import { type FBXBlendShapeData } from "./blendShapes.js";
+import { type FBXSceneDiagnostic } from "./sceneDiagnostics.js";
+/** Represents a model (transform node) in the FBX scene */
+export interface FBXModelData {
+    id: number;
+    name: string;
+    subType: string;
+    /** Geometry attached to this model (if it's a Mesh type) */
+    geometry?: FBXGeometryData;
+    /** Materials assigned to this model */
+    materials: FBXMaterialData[];
+    /** Child models */
+    children: FBXModelData[];
+    /** Transform properties */
+    translation: [number, number, number];
+    rotation: [number, number, number];
+    scale: [number, number, number];
+    /** PreRotation (applied before Lcl Rotation, in degrees) */
+    preRotation: [number, number, number];
+    /** PostRotation (applied after Lcl Rotation, inverted, in degrees) */
+    postRotation: [number, number, number];
+    /** RotationPivot — point around which rotation occurs */
+    rotationPivot: [number, number, number];
+    /** ScalingPivot — point around which scaling occurs */
+    scalingPivot: [number, number, number];
+    /** RotationOffset — translation after rotation pivot */
+    rotationOffset: [number, number, number];
+    /** ScalingOffset — translation after scaling pivot */
+    scalingOffset: [number, number, number];
+    /** Geometric transforms — applied to geometry only, do not affect children */
+    geometricTranslation: [number, number, number];
+    geometricRotation: [number, number, number];
+    geometricScaling: [number, number, number];
+    /** Rotation order: 0=XYZ, 1=XZY, 2=YZX, 3=YXZ, 4=ZXY, 5=ZYX */
+    rotationOrder: number;
+    /** FBX transform inheritance mode. 0=RrSs, 1=RSrs, 2=Rrs */
+    inheritType: number;
+    /** Whether backface culling is disabled ("CullingOff") */
+    cullingOff: boolean;
+    /** User-defined custom properties from Properties70 */
+    customProperties?: Record<string, string | number | boolean>;
+    /** Recoverable model import diagnostics */
+    diagnostics: string[];
+}
+/** Camera data extracted from FBX */
+export interface FBXCameraData {
+    /** Model ID this camera is attached to */
+    modelId: number;
+    /** Camera name */
+    name: string;
+    /** Field of view in degrees */
+    fieldOfView: number;
+    /** Near clip plane */
+    nearPlane: number;
+    /** Far clip plane */
+    farPlane: number;
+    /** Aspect ratio (width/height), 0 = use viewport */
+    aspectRatio: number;
+    /** Projection type */
+    projectionType: "perspective" | "orthographic";
+    /** Focal length in millimeters when present */
+    focalLength?: number;
+    /** Filmback width in inches when present */
+    filmWidth?: number;
+    /** Filmback height in inches when present */
+    filmHeight?: number;
+    /** Orthographic zoom/height when present */
+    orthoZoom?: number;
+    /** Camera roll in degrees when present */
+    roll?: number;
+    /** Known unsupported or unrecognized camera properties */
+    unknownProperties: string[];
+    /** Recoverable camera import diagnostics */
+    diagnostics: string[];
+}
+/** Light data extracted from FBX */
+export interface FBXLightData {
+    /** Model ID this light is attached to */
+    modelId: number;
+    /** Light name */
+    name: string;
+    /** Light type: 0=Point, 1=Directional, 2=Spot */
+    lightType: number;
+    /** Color [r,g,b] 0-1 */
+    color: [number, number, number];
+    /** Intensity multiplier */
+    intensity: number;
+    /** Cone angle in degrees (for spot lights) */
+    coneAngle: number;
+    /** Decay type: 0=None, 1=Linear, 2=Quadratic */
+    decayType: number;
+    /** Inner cone angle in degrees for spot lights */
+    innerAngle?: number;
+    /** Outer cone angle in degrees for spot lights */
+    outerAngle?: number;
+    /** Distance at which FBX attenuation starts; preserved as metadata */
+    decayStart?: number;
+    /** Whether FBX near attenuation is enabled */
+    enableNearAttenuation?: boolean;
+    /** Whether FBX far attenuation is enabled */
+    enableFarAttenuation?: boolean;
+    /** Whether the source light requested shadow casting */
+    castShadows?: boolean;
+    /** Known unsupported or unrecognized light properties */
+    unknownProperties: string[];
+    /** Recoverable light import diagnostics */
+    diagnostics: string[];
+}
+/** Result of interpreting an FBX document */
+export interface FBXSceneData {
+    /** All root-level models */
+    rootModels: FBXModelData[];
+    /** All geometries in the scene */
+    geometries: FBXGeometryData[];
+    /** All materials in the scene */
+    materials: FBXMaterialData[];
+    /** Skin deformers (skeletons + vertex weights) */
+    skins: FBXSkinData[];
+    /** Resolved deformation rigs shared by one or more skins */
+    rigs: FBXRigData[];
+    /** Blend shape deformers (morph targets) */
+    blendShapes: FBXBlendShapeData[];
+    /** Animation stacks (clips) */
+    animations: FBXAnimationStackData[];
+    /** Cameras */
+    cameras: FBXCameraData[];
+    /** Lights */
+    lights: FBXLightData[];
+    /** Scene-level unsupported feature diagnostics */
+    diagnostics: FBXSceneDiagnostic[];
+    /** Global settings */
+    upAxis: number;
+    upAxisSign: number;
+    frontAxis: number;
+    frontAxisSign: number;
+    coordAxis: number;
+    coordAxisSign: number;
+    unitScaleFactor: number;
+}
+/**
+ * Interpret a parsed FBX document into scene data.
+ */
+export declare function interpretFBX(doc: FBXDocument): FBXSceneData;