@ifc-lite/ifcx 1.2.1 → 1.3.0

package/dist/federated-composition.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Federated Composition Engine for IFCX
+ *
+ * Composes multiple IFCX files (layers) into a unified stage using
+ * USD-inspired layer semantics:
+ * - Higher layers (lower index) have stronger opinions
+ * - Attributes merge with strongest layer winning
+ * - Children accumulate across layers
+ * - null values remove attributes/children
+ * - Inheritance is resolved across layer boundaries
+ */
+import type { IfcxFile, ComposedNode } from './types.js';
+import { LayerStack } from './layer-stack.js';
+import { PathIndex } from './path-resolver.js';
+/**
+ * Options for federated composition.
+ */
+export interface ComposeOptions {
+    /** Progress callback */
+    onProgress?: (phase: string, percent: number) => void;
+    /** Maximum inheritance depth (default: 10) */
+    maxInheritDepth?: number;
+}
+/**
+ * Extended ComposedNode with source tracking.
+ */
+export interface ComposedNodeWithSources extends ComposedNode {
+    /** Track which layer contributed each attribute */
+    attributeSources: Map<string, {
+        layerId: string;
+        layerName: string;
+    }>;
+    /** All layers that contributed to this node */
+    contributingLayers: Set<string>;
+}
+/**
+ * Result of federated composition.
+ */
+export interface FederatedCompositionResult {
+    /** Composed nodes by path */
+    composed: Map<string, ComposedNodeWithSources>;
+    /** Path index for lookups */
+    pathIndex: PathIndex;
+    /** Root nodes (no parent) */
+    roots: ComposedNodeWithSources[];
+    /** Statistics */
+    stats: {
+        totalNodes: number;
+        layersUsed: number;
+        inheritanceResolutions: number;
+        crossLayerReferences: number;
+    };
+}
+/**
+ * Compose multiple IFCX layers into a unified stage.
+ *
+ * Algorithm:
+ * 1. Build path index across all layers
+ * 2. Collect all unique paths
+ * 3. For each path, merge nodes from all layers (strongest first)
+ * 4. Resolve inheritance references (may cross layers)
+ * 5. Build parent-child tree from children references
+ */
+export declare function composeFederated(layerStack: LayerStack, options?: ComposeOptions): FederatedCompositionResult;
+/**
+ * Compose a single IFCX file (convenience wrapper).
+ */
+export declare function composeSingleFile(file: IfcxFile): FederatedCompositionResult;
+//# sourceMappingURL=federated-composition.d.ts.map

package/dist/federated-composition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"federated-composition.d.ts","sourceRoot":"","sources":["../src/federated-composition.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAY,YAAY,EAAE,MAAM,YAAY,CAAC;AAEnE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAa,MAAM,oBAAoB,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,wBAAwB;IACxB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACtD,8CAA8C;IAC9C,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAgBD;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,YAAY;IAC3D,mDAAmD;IACnD,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtE,+CAA+C;IAC/C,kBAAkB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,6BAA6B;IAC7B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;IAC/C,6BAA6B;IAC7B,SAAS,EAAE,SAAS,CAAC;IACrB,6BAA6B;IAC7B,KAAK,EAAE,uBAAuB,EAAE,CAAC;IACjC,iBAAiB;IACjB,KAAK,EAAE;QACL,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,sBAAsB,EAAE,MAAM,CAAC;QAC/B,oBAAoB,EAAE,MAAM,CAAC;KAC9B,CAAC;CACH;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,UAAU,EACtB,OAAO,GAAE,cAAmB,GAC3B,0BAA0B,CAiG5B;AAmQD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,GAAG,0BAA0B,CAI5E"}

package/dist/federated-composition.js

@@ -0,0 +1,300 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+import { LayerStack } from './layer-stack.js';
+import { PathIndex } from './path-resolver.js';
+/**
+ * Compose multiple IFCX layers into a unified stage.
+ *
+ * Algorithm:
+ * 1. Build path index across all layers
+ * 2. Collect all unique paths
+ * 3. For each path, merge nodes from all layers (strongest first)
+ * 4. Resolve inheritance references (may cross layers)
+ * 5. Build parent-child tree from children references
+ */
+export function composeFederated(layerStack, options = {}) {
+    const { onProgress, maxInheritDepth = 10 } = options;
+    onProgress?.('indexing', 0);
+    // Get enabled layers in strength order
+    const layers = layerStack.getEnabledLayers();
+    if (layers.length === 0) {
+        return {
+            composed: new Map(),
+            pathIndex: new PathIndex(),
+            roots: [],
+            stats: {
+                totalNodes: 0,
+                layersUsed: 0,
+                inheritanceResolutions: 0,
+                crossLayerReferences: 0,
+            },
+        };
+    }
+    // Build path index
+    const pathIndex = new PathIndex();
+    pathIndex.buildIndex(layers);
+    onProgress?.('indexing', 100);
+    onProgress?.('merging', 0);
+    // Phase 1: Collect and merge all nodes by path
+    const preComposed = new Map();
+    const allPaths = layerStack.getAllPaths();
+    let pathCount = 0;
+    const totalPaths = allPaths.size;
+    for (const path of allPaths) {
+        // Skip hierarchical paths - they're references, not definitions
+        if (path.includes('/'))
+            continue;
+        const pre = mergeNodesForPath(path, layers);
+        preComposed.set(path, pre);
+        pathCount++;
+        if (pathCount % 100 === 0) {
+            onProgress?.('merging', Math.round((pathCount / totalPaths) * 100));
+        }
+    }
+    onProgress?.('merging', 100);
+    onProgress?.('inheritance', 0);
+    // Phase 2: Resolve inheritance
+    let inheritanceResolutions = 0;
+    let crossLayerReferences = 0;
+    const visited = new Set();
+    for (const [path, pre] of preComposed) {
+        const result = resolveInheritance(path, pre, preComposed, pathIndex, visited, new Set(), maxInheritDepth);
+        inheritanceResolutions += result.resolutions;
+        crossLayerReferences += result.crossLayer;
+    }
+    onProgress?.('inheritance', 100);
+    onProgress?.('tree', 0);
+    // Phase 3: Build composed tree
+    const composed = new Map();
+    for (const [path] of preComposed) {
+        if (!composed.has(path)) {
+            composeNode(path, preComposed, composed, new Set(), layers, pathIndex);
+        }
+    }
+    onProgress?.('tree', 100);
+    // Find roots
+    const roots = findRoots(composed);
+    return {
+        composed,
+        pathIndex,
+        roots,
+        stats: {
+            totalNodes: composed.size,
+            layersUsed: layers.length,
+            inheritanceResolutions,
+            crossLayerReferences,
+        },
+    };
+}
+/**
+ * Merge all nodes for a path across layers.
+ * Layers are processed in strength order (strongest first).
+ */
+function mergeNodesForPath(path, layers) {
+    const result = {
+        path,
+        children: {},
+        inherits: {},
+        attributes: {},
+        attributeSources: new Map(),
+        definedInLayers: new Set(),
+    };
+    // Process layers in reverse order (weakest first) so stronger layers override
+    for (let i = layers.length - 1; i >= 0; i--) {
+        const layer = layers[i];
+        const nodes = layer.nodesByPath.get(path);
+        if (!nodes)
+            continue;
+        result.definedInLayers.add(layer.id);
+        // Process all nodes for this path in this layer
+        for (const node of nodes) {
+            // Merge children
+            if (node.children) {
+                for (const [key, value] of Object.entries(node.children)) {
+                    if (value === null) {
+                        // null removes the child
+                        delete result.children[key];
+                    }
+                    else {
+                        result.children[key] = value;
+                    }
+                }
+            }
+            // Merge inherits
+            if (node.inherits) {
+                for (const [key, value] of Object.entries(node.inherits)) {
+                    if (value === null) {
+                        delete result.inherits[key];
+                    }
+                    else {
+                        result.inherits[key] = value;
+                    }
+                }
+            }
+            // Merge attributes
+            if (node.attributes) {
+                for (const [key, value] of Object.entries(node.attributes)) {
+                    result.attributes[key] = value;
+                    result.attributeSources.set(key, layer.id);
+                }
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Resolve inheritance for a pre-composed node.
+ */
+function resolveInheritance(path, pre, allNodes, pathIndex, resolved, visiting, maxDepth, depth = 0) {
+    if (resolved.has(path)) {
+        return { resolutions: 0, crossLayer: 0 };
+    }
+    if (visiting.has(path)) {
+        // Circular inheritance - skip
+        console.warn(`Circular inheritance detected at path: ${path}`);
+        return { resolutions: 0, crossLayer: 0 };
+    }
+    if (depth > maxDepth) {
+        console.warn(`Max inheritance depth exceeded at path: ${path}`);
+        return { resolutions: 0, crossLayer: 0 };
+    }
+    visiting.add(path);
+    let resolutions = 0;
+    let crossLayer = 0;
+    // Resolve each inherit reference
+    for (const [, inheritPath] of Object.entries(pre.inherits)) {
+        if (!inheritPath)
+            continue;
+        // Try to resolve the path (may be in different layer)
+        const resolvedPath = pathIndex.resolvePath(inheritPath);
+        if (!resolvedPath)
+            continue;
+        const inherited = allNodes.get(resolvedPath);
+        if (!inherited)
+            continue;
+        // Check if cross-layer reference
+        const inheritedLayers = inherited.definedInLayers;
+        const hasCommonLayer = [...pre.definedInLayers].some((l) => inheritedLayers.has(l));
+        if (!hasCommonLayer) {
+            crossLayer++;
+        }
+        // Recursively resolve inheritance of the inherited node first
+        const subResult = resolveInheritance(resolvedPath, inherited, allNodes, pathIndex, resolved, visiting, maxDepth, depth + 1);
+        resolutions += subResult.resolutions;
+        crossLayer += subResult.crossLayer;
+        // Merge inherited data (inherited values are weaker - don't override existing)
+        for (const [key, value] of Object.entries(inherited.attributes)) {
+            if (!(key in pre.attributes)) {
+                pre.attributes[key] = value;
+                // Track source from inherited node
+                const inheritedSource = inherited.attributeSources.get(key);
+                if (inheritedSource) {
+                    pre.attributeSources.set(key, inheritedSource);
+                }
+            }
+        }
+        for (const [key, value] of Object.entries(inherited.children)) {
+            if (!(key in pre.children)) {
+                pre.children[key] = value;
+            }
+        }
+        resolutions++;
+    }
+    visiting.delete(path);
+    resolved.add(path);
+    return { resolutions, crossLayer };
+}
+/**
+ * Compose a single node and its children.
+ */
+function composeNode(path, preComposed, composed, visiting, layers, pathIndex) {
+    // Already composed?
+    const existing = composed.get(path);
+    if (existing)
+        return existing;
+    // Cycle detection
+    if (visiting.has(path)) {
+        // Return a stub to break the cycle
+        const stub = {
+            path,
+            attributes: new Map(),
+            children: new Map(),
+            attributeSources: new Map(),
+            contributingLayers: new Set(),
+        };
+        composed.set(path, stub);
+        return stub;
+    }
+    visiting.add(path);
+    const pre = preComposed.get(path);
+    const node = {
+        path,
+        attributes: new Map(),
+        children: new Map(),
+        attributeSources: new Map(),
+        contributingLayers: new Set(pre?.definedInLayers || []),
+    };
+    if (pre) {
+        // Copy attributes
+        for (const [key, value] of Object.entries(pre.attributes)) {
+            node.attributes.set(key, value);
+            // Track source
+            const sourceLayerId = pre.attributeSources.get(key);
+            if (sourceLayerId) {
+                const layer = layers.find((l) => l.id === sourceLayerId);
+                if (layer) {
+                    node.attributeSources.set(key, {
+                        layerId: layer.id,
+                        layerName: layer.name,
+                    });
+                }
+            }
+        }
+        // Resolve and add children
+        for (const [name, childPath] of Object.entries(pre.children)) {
+            if (!childPath)
+                continue;
+            // Child path might be hierarchical (uuid/ChildName) - resolve via pathIndex
+            const resolvedChildPath = pathIndex.resolvePath(childPath) || childPath;
+            const childPre = preComposed.get(resolvedChildPath);
+            if (childPre) {
+                const child = composeNode(resolvedChildPath, preComposed, composed, visiting, layers, pathIndex);
+                child.parent = node;
+                node.children.set(name, child);
+            }
+        }
+    }
+    visiting.delete(path);
+    composed.set(path, node);
+    return node;
+}
+/**
+ * Find root nodes (nodes with no parent).
+ */
+function findRoots(composed) {
+    const childPaths = new Set();
+    // Collect all child paths
+    for (const node of composed.values()) {
+        for (const child of node.children.values()) {
+            childPaths.add(child.path);
+        }
+    }
+    // Roots are nodes not referenced as children
+    const roots = [];
+    for (const node of composed.values()) {
+        if (!childPaths.has(node.path) && !node.parent) {
+            roots.push(node);
+        }
+    }
+    return roots;
+}
+/**
+ * Compose a single IFCX file (convenience wrapper).
+ */
+export function composeSingleFile(file) {
+    const stack = new LayerStack();
+    stack.addLayer(file, new ArrayBuffer(0), 'single');
+    return composeFederated(stack);
+}
+//# sourceMappingURL=federated-composition.js.map

package/dist/federated-composition.js.map

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

package/dist/index.d.ts

@@ -1,12 +1,17 @@
 import { type MeshData } from './geometry-extractor.js';
 import { StringTable } from '@ifc-lite/data';
 import type { SpatialHierarchy, EntityTable, PropertyTable, QuantityTable, RelationshipGraph } from '@ifc-lite/data';
+import { LayerStack } from './layer-stack.js';
+import { PathIndex } from './path-resolver.js';
 export * from './types.js';
 export { composeIfcx, findRoots, getDescendants, getPathToRoot } from './composition.js';
 export { extractEntities } from './entity-extractor.js';
 export { extractProperties, isQuantityProperty } from './property-extractor.js';
 export { extractGeometry, type MeshData } from './geometry-extractor.js';
 export { buildHierarchy } from './hierarchy-builder.js';
+export { LayerStack, createLayerStack, type IfcxLayer, type LayerSource, } from './layer-stack.js';
+export { PathIndex, createPathIndex, parsePath, type ParsedPath, type PathEntry, } from './path-resolver.js';
+export { composeFederated, type ComposeOptions, type FederatedCompositionResult, type ComposedNodeWithSources, } from './federated-composition.js';
 /**
  * Result of parsing an IFCX file.
  * Compatible with existing ifc-lite data structures.
@@ -54,4 +59,64 @@ export declare function parseIfcx(buffer: ArrayBuffer, options?: IfcxParseOption
  * Detect if a buffer contains IFCX (JSON) or IFC (STEP) format.
  */
 export declare function detectFormat(buffer: ArrayBuffer): 'ifcx' | 'ifc' | 'unknown';
+/**
+ * Input for federated parsing - a buffer with a name.
+ */
+export interface FederatedFileInput {
+    buffer: ArrayBuffer;
+    name: string;
+}
+/**
+ * Options for federated IFCX parsing.
+ */
+export interface FederatedParseOptions extends IfcxParseOptions {
+    /** Maximum inheritance depth (default: 10) */
+    maxInheritDepth?: number;
+}
+/**
+ * Result of parsing federated IFCX files.
+ * Extends the standard result with layer information.
+ */
+export interface FederatedIfcxParseResult extends IfcxParseResult {
+    /** Layer stack with all loaded layers */
+    layerStack: LayerStack;
+    /** Path index for cross-file lookups */
+    pathIndex: PathIndex;
+    /** Composition statistics */
+    compositionStats: {
+        layersUsed: number;
+        inheritanceResolutions: number;
+        crossLayerReferences: number;
+    };
+    /** Map from path to layer IDs that define it */
+    pathToLayers: Map<string, string[]>;
+}
+/**
+ * Parse multiple IFCX files as federated layers.
+ *
+ * Files are loaded as layers with the first file being the base (weakest)
+ * and subsequent files being overlays (stronger). Layer order can be
+ * adjusted after parsing using the returned LayerStack.
+ *
+ * @param files - Array of file buffers with names
+ * @param options - Parse options
+ * @returns Federated parse result with layer information
+ *
+ * @example
+ * ```typescript
+ * const result = await parseFederatedIfcx([
+ *   { buffer: baseBuffer, name: 'hello-wall.ifcx' },
+ *   { buffer: overlayBuffer, name: 'add-fire-rating.ifcx' },
+ * ]);
+ *
+ * // Wall now has FireRating property from overlay
+ * const wallProps = result.properties.getForEntity(wallId);
+ * ```
+ */
+export declare function parseFederatedIfcx(files: FederatedFileInput[], options?: FederatedParseOptions): Promise<FederatedIfcxParseResult>;
+/**
+ * Add an overlay layer to an existing federated result.
+ * Returns a new result with the overlay applied.
+ */
+export declare function addIfcxOverlay(baseResult: FederatedIfcxParseResult, overlayBuffer: ArrayBuffer, overlayName: string, options?: FederatedParseOptions): Promise<FederatedIfcxParseResult>;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAeA,OAAO,EAAmB,KAAK,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAEzE,OAAO,EACL,WAAW,EAIZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGrH,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACzF,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,KAAK,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,QAAQ,EAAE,WAAW,CAAC;IACtB,8BAA8B;IAC9B,UAAU,EAAE,aAAa,CAAC;IAC1B,8BAA8B;IAC9B,UAAU,EAAE,aAAa,CAAC;IAC1B,yBAAyB;IACzB,aAAa,EAAE,iBAAiB,CAAC;IACjC,wBAAwB;IACxB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,wCAAwC;IACxC,OAAO,EAAE,WAAW,CAAC;IACrB,sCAAsC;IACtC,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,2CAA2C;IAC3C,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,2CAA2C;IAC3C,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,qBAAqB;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,wBAAwB;IACxB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CACrE;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CAwE1B;AAiHD;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,CAe5E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -7,6 +7,9 @@ import { extractProperties, isQuantityProperty } from './property-extractor.js';
 import { extractGeometry } from './geometry-extractor.js';
 import { buildHierarchy } from './hierarchy-builder.js';
 import { StringTable, RelationshipGraphBuilder, RelationshipType, QuantityTableBuilder, } from '@ifc-lite/data';
+// Federated composition imports
+import { createLayerStack } from './layer-stack.js';
+import { composeFederated, } from './federated-composition.js';
 // Re-export types
 export * from './types.js';
 export { composeIfcx, findRoots, getDescendants, getPathToRoot } from './composition.js';
@@ -14,6 +17,10 @@ export { extractEntities } from './entity-extractor.js';
 export { extractProperties, isQuantityProperty } from './property-extractor.js';
 export { extractGeometry } from './geometry-extractor.js';
 export { buildHierarchy } from './hierarchy-builder.js';
+// Re-export federated composition
+export { LayerStack, createLayerStack, } from './layer-stack.js';
+export { PathIndex, createPathIndex, parsePath, } from './path-resolver.js';
+export { composeFederated, } from './federated-composition.js';
 /**
  * Parse an IFCX file and return data compatible with existing ifc-lite pipeline.
  */
@@ -186,4 +193,165 @@ export function detectFormat(buffer) {
     }
     return 'unknown';
 }
+/**
+ * Parse multiple IFCX files as federated layers.
+ *
+ * Files are loaded as layers with the first file being the base (weakest)
+ * and subsequent files being overlays (stronger). Layer order can be
+ * adjusted after parsing using the returned LayerStack.
+ *
+ * @param files - Array of file buffers with names
+ * @param options - Parse options
+ * @returns Federated parse result with layer information
+ *
+ * @example
+ * ```typescript
+ * const result = await parseFederatedIfcx([
+ *   { buffer: baseBuffer, name: 'hello-wall.ifcx' },
+ *   { buffer: overlayBuffer, name: 'add-fire-rating.ifcx' },
+ * ]);
+ *
+ * // Wall now has FireRating property from overlay
+ * const wallProps = result.properties.getForEntity(wallId);
+ * ```
+ */
+export async function parseFederatedIfcx(files, options = {}) {
+    const startTime = performance.now();
+    if (files.length === 0) {
+        throw new Error('At least one IFCX file is required');
+    }
+    options.onProgress?.({ phase: 'parse', percent: 0 });
+    // Phase 1: Parse all files and build layer stack
+    const layerStack = createLayerStack();
+    let totalSize = 0;
+    for (let i = 0; i < files.length; i++) {
+        const { buffer, name } = files[i];
+        totalSize += buffer.byteLength;
+        const text = new TextDecoder().decode(buffer);
+        let file;
+        try {
+            file = JSON.parse(text);
+        }
+        catch (e) {
+            throw new Error(`Invalid IFCX file "${name}": JSON parse error - ${e}`);
+        }
+        // Validate header
+        if (!file.header?.ifcxVersion?.toLowerCase().includes('ifcx')) {
+            throw new Error(`Invalid IFCX file "${name}": missing or invalid header.ifcxVersion`);
+        }
+        // Add as layer (first file is weakest, last is strongest)
+        // We add at position 0 so later files become strongest
+        layerStack.addLayerAt(file, buffer, name, 0, {
+            type: 'file',
+            filename: name,
+            size: buffer.byteLength,
+        });
+        options.onProgress?.({
+            phase: 'parse',
+            percent: Math.round(((i + 1) / files.length) * 100),
+        });
+    }
+    options.onProgress?.({ phase: 'compose', percent: 0 });
+    // Phase 2: Compose federated layers
+    const compositionResult = composeFederated(layerStack, {
+        onProgress: (phase, percent) => {
+            options.onProgress?.({ phase: `compose-${phase}`, percent });
+        },
+        maxInheritDepth: options.maxInheritDepth,
+    });
+    options.onProgress?.({ phase: 'compose', percent: 100 });
+    // Convert composed nodes to standard ComposedNode format for extractors
+    const composed = new Map();
+    for (const [path, node] of compositionResult.composed) {
+        composed.set(path, node);
+    }
+    // Phase 3: Extract entities
+    options.onProgress?.({ phase: 'entities', percent: 0 });
+    const strings = new StringTable();
+    const { entities, pathToId, idToPath } = extractEntities(composed, strings);
+    options.onProgress?.({ phase: 'entities', percent: 100 });
+    // Phase 4: Extract properties
+    options.onProgress?.({ phase: 'properties', percent: 0 });
+    const properties = extractProperties(composed, pathToId, strings);
+    options.onProgress?.({ phase: 'properties', percent: 100 });
+    // Phase 5: Extract geometry
+    options.onProgress?.({ phase: 'geometry', percent: 0 });
+    const meshes = extractGeometry(composed, pathToId);
+    options.onProgress?.({ phase: 'geometry', percent: 100 });
+    // Phase 6: Build hierarchy
+    options.onProgress?.({ phase: 'hierarchy', percent: 0 });
+    const spatialHierarchy = buildHierarchy(composed, pathToId);
+    options.onProgress?.({ phase: 'hierarchy', percent: 100 });
+    // Phase 7: Build relationships
+    options.onProgress?.({ phase: 'relationships', percent: 0 });
+    const relationships = buildRelationships(composed, pathToId);
+    options.onProgress?.({ phase: 'relationships', percent: 100 });
+    // Phase 8: Build quantities
+    const quantities = buildQuantities(composed, pathToId, strings);
+    // Build path-to-layers map
+    const pathToLayers = new Map();
+    for (const [path, node] of compositionResult.composed) {
+        pathToLayers.set(path, Array.from(node.contributingLayers));
+    }
+    const parseTime = performance.now() - startTime;
+    return {
+        entities,
+        properties,
+        quantities,
+        relationships,
+        spatialHierarchy,
+        strings,
+        meshes,
+        pathToId,
+        idToPath,
+        schemaVersion: 'IFC5',
+        fileSize: totalSize,
+        entityCount: entities.count,
+        parseTime,
+        // Federated-specific fields
+        layerStack,
+        pathIndex: compositionResult.pathIndex,
+        compositionStats: {
+            layersUsed: compositionResult.stats.layersUsed,
+            inheritanceResolutions: compositionResult.stats.inheritanceResolutions,
+            crossLayerReferences: compositionResult.stats.crossLayerReferences,
+        },
+        pathToLayers,
+    };
+}
+/**
+ * Add an overlay layer to an existing federated result.
+ * Returns a new result with the overlay applied.
+ */
+export async function addIfcxOverlay(baseResult, overlayBuffer, overlayName, options = {}) {
+    // Parse overlay file
+    const text = new TextDecoder().decode(overlayBuffer);
+    let file;
+    try {
+        file = JSON.parse(text);
+    }
+    catch (e) {
+        throw new Error(`Invalid IFCX overlay "${overlayName}": JSON parse error - ${e}`);
+    }
+    // Validate header
+    if (!file.header?.ifcxVersion?.toLowerCase().includes('ifcx')) {
+        throw new Error(`Invalid IFCX overlay "${overlayName}": missing or invalid header.ifcxVersion`);
+    }
+    // Add to layer stack (at top = strongest)
+    baseResult.layerStack.addLayer(file, overlayBuffer, overlayName, {
+        type: 'file',
+        filename: overlayName,
+        size: overlayBuffer.byteLength,
+    });
+    // Re-compose with new layer
+    // Collect all files from the layer stack
+    const files = baseResult.layerStack
+        .getLayers()
+        .map((layer) => ({
+        buffer: layer.buffer,
+        name: layer.name,
+    }))
+        .reverse(); // Reverse because layers are stored strongest-first
+    return parseFederatedIfcx(files, options);
+}
 //# sourceMappingURL=index.js.map