@ifc-lite/export 1.7.0 → 1.8.0

package/dist/reference-collector.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Reference collector for IFC STEP export filtering.
+ *
+ * Walks #ID references transitively from a set of root entities to build
+ * the complete closure of all entities that must be included for a valid
+ * STEP file. Used for visible-only export and merged export.
+ *
+ * KEY DESIGN: In IFC STEP files, the reference graph is:
+ *   - Products reference geometry (Product → Placement → CartesianPoint)
+ *   - Relationships reference products (Rel → Product, NOT Product → Rel)
+ *   - Properties are reached via relationships (Rel → PropertySet → Property)
+ *
+ * For visible-only export, we need:
+ *   1. Infrastructure + spatial structure (always included)
+ *   2. Visible product entities (checked against hidden/isolated)
+ *   3. Relationship entities (always included as roots — they reference products)
+ *   4. Forward closure from the above roots pulls in geometry, properties, etc.
+ *   5. Hidden product IDs are BLOCKED during the closure walk so their
+ *      exclusively-referenced geometry doesn't get pulled in.
+ *   6. IfcStyledItem entities are collected in a reverse pass after the closure
+ *      because they reference geometry but nothing references them back.
+ *   7. Openings whose parent element is hidden are also excluded
+ *      (via IfcRelVoidsElement propagation).
+ */
+import type { IfcDataStore } from '@ifc-lite/parser';
+/**
+ * Collect all entity IDs transitively referenced from a set of root entities.
+ *
+ * Starting from `rootIds`, reads each entity's raw bytes from the source buffer
+ * and extracts all `#ID` references via byte-level scanning (no string
+ * allocation). Recursively follows references to build a complete closure
+ * that guarantees referential integrity.
+ *
+ * @param rootIds - Seed entity IDs to start the walk from
+ * @param source - The original STEP file source buffer
+ * @param entityIndex - Map of expressId → byte position in source
+ * @param excludeIds - Entity IDs to NEVER follow during the walk.
+ *
+ * Performance: O(total bytes of included entities). Each entity visited once.
+ * Uses byte-level scanning — no TextDecoder, no regex, no string allocation.
+ */
+export declare function collectReferencedEntityIds(rootIds: Set<number>, source: Uint8Array, entityIndex: Map<number, {
+    byteOffset: number;
+    byteLength: number;
+}>, excludeIds?: Set<number>): Set<number>;
+/**
+ * Compute the root entity set and hidden product IDs for a visible-only export.
+ *
+ * Returns:
+ * - `roots`: Entity IDs that form the seed set for the reference closure.
+ *   Includes infrastructure, spatial structure, relationship entities, and
+ *   visible product entities.
+ * - `hiddenProductIds`: Product entity IDs that are hidden/not isolated.
+ *   These should be passed as `excludeIds` to `collectReferencedEntityIds`
+ *   to prevent the closure from walking into hidden products' geometry.
+ *
+ * Also propagates hidden status from building elements to their openings
+ * via IfcRelVoidsElement, so orphaned openings are excluded.
+ */
+export declare function getVisibleEntityIds(dataStore: IfcDataStore, hiddenIds: Set<number>, isolatedIds: Set<number> | null): {
+    roots: Set<number>;
+    hiddenProductIds: Set<number>;
+};
+/**
+ * Collect style entities (IFCSTYLEDITEM, etc.) that reference geometry already
+ * in the closure, then transitively follow their style references.
+ *
+ * In IFC STEP, IFCSTYLEDITEM references a geometry RepresentationItem, but
+ * nothing references the StyledItem back. So the forward closure walk misses
+ * them entirely. This function does a reverse pass using the byType index:
+ * for each styled item, check if any referenced ID is in the closure. If yes,
+ * add the styled item and walk its style chain into the closure.
+ *
+ * Uses byType for O(styledItems) instead of O(allEntities), and byte-level
+ * scanning for #ID extraction.
+ *
+ * Must be called AFTER collectReferencedEntityIds so the closure is complete.
+ *
+ * @param closure - The existing closure set (mutated in place)
+ * @param source - The original STEP file source buffer
+ * @param entityIndex - Full entity index with type info and byType lookup
+ */
+export declare function collectStyleEntities(closure: Set<number>, source: Uint8Array, entityIndex: {
+    byId: Map<number, {
+        type: string;
+        byteOffset: number;
+        byteLength: number;
+    }>;
+    byType: Map<string, number[]>;
+}): void;
+//# sourceMappingURL=reference-collector.d.ts.map

package/dist/reference-collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-collector.d.ts","sourceRoot":"","sources":["../src/reference-collector.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA+MrD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,EACpB,MAAM,EAAE,UAAU,EAClB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,EACpE,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GACvB,GAAG,CAAC,MAAM,CAAC,CAqCb;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,YAAY,EACvB,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,EACtB,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,GAC9B;IAAE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAAC,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAAE,CAkEvD;AAkDD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,EACpB,MAAM,EAAE,UAAU,EAClB,WAAW,EAAE;IACX,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5E,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAC/B,GACA,IAAI,CAoDN"}

package/dist/reference-collector.js

@@ -0,0 +1,428 @@
+/* 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/. */
+/** ASCII code points for byte-level scanning. */
+const HASH = 0x23; // '#'
+const ZERO = 0x30; // '0'
+const NINE = 0x39; // '9'
+/** Entity types that form the shared file infrastructure and must always be included. */
+const INFRASTRUCTURE_TYPES = new Set([
+    'IFCOWNERHISTORY',
+    'IFCAPPLICATION',
+    'IFCPERSON',
+    'IFCORGANIZATION',
+    'IFCPERSONANDORGANIZATION',
+    'IFCUNITASSIGNMENT',
+    'IFCSIUNIT',
+    'IFCDERIVEDUNIT',
+    'IFCDERIVEDUNITELEMENT',
+    'IFCCONVERSIONBASEDUNIT',
+    'IFCMEASUREWITHUNIT',
+    'IFCDIMENSIONALEXPONENTS',
+    'IFCMONETARYUNIT',
+    'IFCGEOMETRICREPRESENTATIONCONTEXT',
+    'IFCGEOMETRICREPRESENTATIONSUBCONTEXT',
+]);
+/**
+ * Spatial structure entity types — always included as roots.
+ * Covers IFC4 and IFC4X3 (bridges, roads, railways, marine facilities).
+ * Derived from all subtypes of IfcSpatialElement in the IFC schema,
+ * excluding IfcSpace (which users can toggle visibility on).
+ */
+const SPATIAL_STRUCTURE_TYPES = new Set([
+    'IFCPROJECT',
+    // IFC4 spatial structure
+    'IFCSITE', 'IFCBUILDING', 'IFCBUILDINGSTOREY',
+    // IFC4X3 spatial structure (subtypes of IfcFacility / IfcSpatialElement)
+    'IFCBRIDGE', 'IFCBRIDGEPART',
+    'IFCFACILITY', 'IFCFACILITYPART', 'IFCFACILITYPARTCOMMON',
+    'IFCMARINEFACILITY', 'IFCMARINEPART',
+    'IFCRAILWAY', 'IFCRAILWAYPART',
+    'IFCROAD', 'IFCROADPART',
+    // Abstract spatial types (rarely instantiated but handle gracefully)
+    'IFCSPATIALELEMENT', 'IFCSPATIALSTRUCTUREELEMENT', 'IFCSPATIALZONE',
+    'IFCEXTERNALSPATIALELEMENT', 'IFCEXTERNALSPATIALSTRUCTUREELEMENT',
+]);
+/**
+ * Complete set of all IfcProduct subtypes from the IFC4 + IFC4X3 schemas,
+ * excluding spatial structure types (handled above). Generated from the
+ * schema registry's inheritanceChain metadata.
+ *
+ * 202 types — full IFC schema coverage. The hiddenIds fallback below
+ * catches any types that may exist in future schema versions.
+ */
+const PRODUCT_TYPES = new Set([
+    // IfcElement > IfcBuildingElement
+    'IFCBEAM', 'IFCBEAMSTANDARDCASE', 'IFCBUILDINGELEMENT',
+    'IFCBUILDINGELEMENTPART', 'IFCBUILDINGELEMENTPROXY', 'IFCBUILTELEMENT',
+    'IFCCHIMNEY', 'IFCCOLUMN', 'IFCCOLUMNSTANDARDCASE',
+    'IFCCOVERING', 'IFCCURTAINWALL',
+    'IFCDEEPFOUNDATION', 'IFCDOOR', 'IFCDOORSTANDARDCASE',
+    'IFCFOOTING', 'IFCMEMBER', 'IFCMEMBERSTANDARDCASE',
+    'IFCPILE', 'IFCPLATE', 'IFCPLATESTANDARDCASE',
+    'IFCRAILING', 'IFCRAMP', 'IFCRAMPFLIGHT',
+    'IFCROOF', 'IFCSHADINGDEVICE',
+    'IFCSLAB', 'IFCSLABELEMENTEDCASE', 'IFCSLABSTANDARDCASE',
+    'IFCSTAIR', 'IFCSTAIRFLIGHT',
+    'IFCWALL', 'IFCWALLELEMENTEDCASE', 'IFCWALLSTANDARDCASE',
+    'IFCWINDOW', 'IFCWINDOWSTANDARDCASE',
+    // IfcElement > IfcDistributionElement
+    'IFCDISTRIBUTIONELEMENT', 'IFCDISTRIBUTIONCONTROLELEMENT',
+    'IFCDISTRIBUTIONFLOWELEMENT', 'IFCDISTRIBUTIONCHAMBERELEMENT',
+    'IFCDISTRIBUTIONPORT', 'IFCDISTRIBUTIONBOARD',
+    // IfcDistributionControlElement subtypes
+    'IFCACTUATOR', 'IFCALARM', 'IFCCONTROLLER',
+    'IFCFLOWINSTRUMENT', 'IFCPROTECTIVEDEVICETRIPPINGUNIT',
+    'IFCSENSOR', 'IFCUNITARYCONTROLELEMENT',
+    // IfcFlowController subtypes
+    'IFCAIRTERMINALBOX', 'IFCDAMPER', 'IFCELECTRICDISTRIBUTIONBOARD',
+    'IFCELECTRICTIMECONTROL', 'IFCFLOWCONTROLLER', 'IFCFLOWMETER',
+    'IFCPROTECTIVEDEVICE', 'IFCSWITCHINGDEVICE', 'IFCVALVE',
+    // IfcFlowFitting subtypes
+    'IFCCABLECARRIERFITTING', 'IFCCABLEFITTING',
+    'IFCDUCTFITTING', 'IFCFLOWFITTING', 'IFCJUNCTIONBOX', 'IFCPIPEFITTING',
+    // IfcFlowMovingDevice subtypes
+    'IFCCOMPRESSOR', 'IFCFAN', 'IFCFLOWMOVINGDEVICE', 'IFCPUMP',
+    // IfcFlowSegment subtypes
+    'IFCCABLECARRIERSEGMENT', 'IFCCABLESEGMENT', 'IFCCONVEYORSEGMENT',
+    'IFCDUCTSEGMENT', 'IFCFLOWSEGMENT', 'IFCPIPESEGMENT',
+    // IfcFlowStorageDevice subtypes
+    'IFCELECTRICFLOWSTORAGEDEVICE', 'IFCFLOWSTORAGEDEVICE', 'IFCTANK',
+    // IfcFlowTerminal subtypes
+    'IFCAIRTERMINAL', 'IFCAUDIOVISUALAPPLIANCE', 'IFCCOMMUNICATIONSAPPLIANCE',
+    'IFCELECTRICAPPLIANCE', 'IFCFIRESUPPRESSIONTERMINAL', 'IFCFLOWTERMINAL',
+    'IFCLAMP', 'IFCLIGHTFIXTURE', 'IFCLIQUIDTERMINAL',
+    'IFCMEDICALDEVICE', 'IFCMOBILETELECOMMUNICATIONSAPPLIANCE',
+    'IFCOUTLET', 'IFCSANITARYTERMINAL', 'IFCSPACEHEATER',
+    'IFCSTACKTERMINAL', 'IFCWASTETERMINAL',
+    // IfcFlowTreatmentDevice subtypes
+    'IFCDUCTSILENCER', 'IFCELECTRICFLOWTREATMENTDEVICE',
+    'IFCFILTER', 'IFCFLOWTREATMENTDEVICE', 'IFCINTERCEPTOR',
+    // IfcEnergyConversionDevice subtypes
+    'IFCAIRTOAIRHEATRECOVERY', 'IFCBOILER', 'IFCBURNER',
+    'IFCCHILLER', 'IFCCOIL', 'IFCCONDENSER',
+    'IFCCOOLEDBEAM', 'IFCCOOLINGTOWER',
+    'IFCELECTRICGENERATOR', 'IFCELECTRICMOTOR',
+    'IFCENERGYCONVERSIONDEVICE', 'IFCENGINE',
+    'IFCEVAPORATIVECOOLER', 'IFCEVAPORATOR',
+    'IFCHEATEXCHANGER', 'IFCHUMIDIFIER', 'IFCMOTORCONNECTION',
+    'IFCSOLARDEVICE', 'IFCTRANSFORMER', 'IFCTUBEBUNDLE',
+    'IFCUNITARYEQUIPMENT',
+    // IfcElement > IfcElementAssembly
+    'IFCELEMENT', 'IFCELEMENTASSEMBLY',
+    // IfcElement > IfcElementComponent
+    'IFCELEMENTCOMPONENT', 'IFCFASTENER',
+    'IFCMECHANICALFASTENER', 'IFCDISCRETEACCESSORY',
+    'IFCVIBRATIONDAMPER', 'IFCVIBRATIONISOLATOR',
+    'IFCIMPACTPROTECTIONDEVICE',
+    // IfcElement > IfcFeatureElement
+    'IFCFEATUREELEMENT', 'IFCFEATUREELEMENTADDITION', 'IFCFEATUREELEMENTSUBTRACTION',
+    'IFCOPENINGELEMENT', 'IFCOPENINGSTANDARDCASE',
+    'IFCPROJECTIONELEMENT', 'IFCSURFACEFEATURE', 'IFCVOIDINGFEATURE',
+    // IfcElement > IfcFurnishingElement
+    'IFCFURNISHINGELEMENT', 'IFCFURNITURE', 'IFCSYSTEMFURNITUREELEMENT',
+    // IfcElement > IfcGeographicElement / IfcCivilElement
+    'IFCGEOGRAPHICELEMENT', 'IFCCIVILELEMENT',
+    // IfcElement > IfcTransportElement / IfcTransportationDevice / IfcVehicle
+    'IFCTRANSPORTELEMENT', 'IFCTRANSPORTATIONDEVICE', 'IFCVEHICLE',
+    // IfcElement > IfcReinforcingElement
+    'IFCREINFORCINGELEMENT', 'IFCREINFORCINGBAR', 'IFCREINFORCINGMESH',
+    'IFCTENDON', 'IFCTENDONANCHOR', 'IFCTENDONCONDUIT',
+    // IfcElement > IFC4X3 additions
+    'IFCBEARING', 'IFCCAISSONFOUNDATION', 'IFCCOURSE',
+    'IFCEARTHWORKSCUT', 'IFCEARTHWORKSELEMENT', 'IFCEARTHWORKSFILL',
+    'IFCKERB', 'IFCMOORINGDEVICE', 'IFCNAVIGATIONELEMENT',
+    'IFCPAVEMENT', 'IFCRAIL', 'IFCREINFORCEDSOIL', 'IFCSIGN', 'IFCSIGNAL',
+    'IFCTRACKELEMENT',
+    // IFC4X3 alignment and positioning
+    'IFCALIGNMENT', 'IFCALIGNMENTCANT', 'IFCALIGNMENTHORIZONTAL',
+    'IFCALIGNMENTSEGMENT', 'IFCALIGNMENTVERTICAL',
+    'IFCLINEARELEMENT', 'IFCLINEARPOSITIONINGELEMENT',
+    'IFCPOSITIONINGELEMENT', 'IFCREFERENT',
+    // IFC4X3 geotechnical
+    'IFCBOREHOLE', 'IFCGEOMODEL', 'IFCGEOSLICE',
+    'IFCGEOTECHNICALASSEMBLY', 'IFCGEOTECHNICALELEMENT', 'IFCGEOTECHNICALSTRATUM',
+    // IfcProduct (non-element)
+    'IFCANNOTATION', 'IFCGRID', 'IFCPORT', 'IFCPROXY',
+    'IFCSPACE', 'IFCVIRTUALELEMENT',
+    // IfcStructuralItem / IfcStructuralActivity
+    'IFCSTRUCTURALACTION', 'IFCSTRUCTURALACTIVITY',
+    'IFCSTRUCTURALCONNECTION', 'IFCSTRUCTURALCURVEACTION',
+    'IFCSTRUCTURALCURVECONNECTION', 'IFCSTRUCTURALCURVEMEMBER',
+    'IFCSTRUCTURALCURVEMEMBERVARYING', 'IFCSTRUCTURALCURVEREACTION',
+    'IFCSTRUCTURALITEM', 'IFCSTRUCTURALLINEARACTION',
+    'IFCSTRUCTURALMEMBER', 'IFCSTRUCTURALPLANARACTION',
+    'IFCSTRUCTURALPOINTACTION', 'IFCSTRUCTURALPOINTCONNECTION',
+    'IFCSTRUCTURALPOINTREACTION', 'IFCSTRUCTURALREACTION',
+    'IFCSTRUCTURALSURFACEACTION', 'IFCSTRUCTURALSURFACECONNECTION',
+    'IFCSTRUCTURALSURFACEMEMBER', 'IFCSTRUCTURALSURFACEMEMBERVARYING',
+    'IFCSTRUCTURALSURFACEREACTION',
+]);
+// ---------------------------------------------------------------------------
+// Byte-level #ID reference extraction
+// ---------------------------------------------------------------------------
+/**
+ * Extract all #ID references from a raw STEP entity byte range.
+ *
+ * Scans the Uint8Array directly for '#' (0x23) followed by ASCII digits,
+ * avoiding TextDecoder string allocation and regex overhead. Each entity
+ * is visited at most once, and IDs are parsed inline from bytes.
+ *
+ * ~4-15x faster than TextDecoder + regex for large closures.
+ */
+function extractRefsFromBytes(source, byteOffset, byteLength, out) {
+    const end = byteOffset + byteLength;
+    let i = byteOffset;
+    while (i < end) {
+        if (source[i] === HASH) {
+            i++;
+            // Check if followed by at least one digit
+            if (i < end && source[i] >= ZERO && source[i] <= NINE) {
+                let id = source[i] - ZERO;
+                i++;
+                while (i < end && source[i] >= ZERO && source[i] <= NINE) {
+                    id = id * 10 + (source[i] - ZERO);
+                    i++;
+                }
+                out.push(id);
+            }
+        }
+        else {
+            i++;
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Core closure walk
+// ---------------------------------------------------------------------------
+/**
+ * Collect all entity IDs transitively referenced from a set of root entities.
+ *
+ * Starting from `rootIds`, reads each entity's raw bytes from the source buffer
+ * and extracts all `#ID` references via byte-level scanning (no string
+ * allocation). Recursively follows references to build a complete closure
+ * that guarantees referential integrity.
+ *
+ * @param rootIds - Seed entity IDs to start the walk from
+ * @param source - The original STEP file source buffer
+ * @param entityIndex - Map of expressId → byte position in source
+ * @param excludeIds - Entity IDs to NEVER follow during the walk.
+ *
+ * Performance: O(total bytes of included entities). Each entity visited once.
+ * Uses byte-level scanning — no TextDecoder, no regex, no string allocation.
+ */
+export function collectReferencedEntityIds(rootIds, source, entityIndex, excludeIds) {
+    const visited = new Set();
+    const queue = [];
+    // Seed the queue with roots that exist in the entity index
+    for (const id of rootIds) {
+        if (entityIndex.has(id) && !visited.has(id)) {
+            visited.add(id);
+            queue.push(id);
+        }
+    }
+    // Reusable buffer for extracted refs (avoids per-entity allocation)
+    const refs = [];
+    while (queue.length > 0) {
+        const entityId = queue.pop();
+        const ref = entityIndex.get(entityId);
+        if (!ref)
+            continue;
+        // Extract #ID references directly from bytes
+        refs.length = 0;
+        extractRefsFromBytes(source, ref.byteOffset, ref.byteLength, refs);
+        for (let i = 0; i < refs.length; i++) {
+            const referencedId = refs[i];
+            if (!visited.has(referencedId) && entityIndex.has(referencedId)) {
+                if (excludeIds && excludeIds.has(referencedId)) {
+                    continue;
+                }
+                visited.add(referencedId);
+                queue.push(referencedId);
+            }
+        }
+    }
+    return visited;
+}
+// ---------------------------------------------------------------------------
+// Visibility classification
+// ---------------------------------------------------------------------------
+/**
+ * Compute the root entity set and hidden product IDs for a visible-only export.
+ *
+ * Returns:
+ * - `roots`: Entity IDs that form the seed set for the reference closure.
+ *   Includes infrastructure, spatial structure, relationship entities, and
+ *   visible product entities.
+ * - `hiddenProductIds`: Product entity IDs that are hidden/not isolated.
+ *   These should be passed as `excludeIds` to `collectReferencedEntityIds`
+ *   to prevent the closure from walking into hidden products' geometry.
+ *
+ * Also propagates hidden status from building elements to their openings
+ * via IfcRelVoidsElement, so orphaned openings are excluded.
+ */
+export function getVisibleEntityIds(dataStore, hiddenIds, isolatedIds) {
+    const roots = new Set();
+    const hiddenProductIds = new Set();
+    for (const [expressId, entityRef] of dataStore.entityIndex.byId) {
+        const typeUpper = entityRef.type.toUpperCase();
+        // Always include infrastructure entities (units, contexts, owner history)
+        if (INFRASTRUCTURE_TYPES.has(typeUpper)) {
+            roots.add(expressId);
+            continue;
+        }
+        // Always include spatial structure (project, site, building, storey, facility)
+        if (SPATIAL_STRUCTURE_TYPES.has(typeUpper)) {
+            roots.add(expressId);
+            continue;
+        }
+        // Always include relationship entities as roots.
+        // Relationships reference products (not vice versa), so they must be roots
+        // for properties, materials, and type definitions to be reachable.
+        if (typeUpper.startsWith('IFCREL')) {
+            roots.add(expressId);
+            continue;
+        }
+        // For product/element entities: check visibility
+        if (PRODUCT_TYPES.has(typeUpper)) {
+            const isHidden = hiddenIds.has(expressId);
+            const isNotIsolated = isolatedIds !== null && !isolatedIds.has(expressId);
+            if (isHidden || isNotIsolated) {
+                hiddenProductIds.add(expressId);
+            }
+            else {
+                roots.add(expressId);
+            }
+            continue;
+        }
+        // Fallback: if the entity ID is explicitly hidden by the viewer, block it
+        // even if its type isn't in PRODUCT_TYPES (catches future schema additions)
+        if (hiddenIds.has(expressId)) {
+            hiddenProductIds.add(expressId);
+            continue;
+        }
+        // Fallback: if isolation is active and this entity IS isolated, it must be
+        // a product the user wants to see — make it a root
+        if (isolatedIds !== null && isolatedIds.has(expressId)) {
+            roots.add(expressId);
+            continue;
+        }
+        // All other entity types (geometry, properties, materials, type objects, etc.)
+        // are NOT roots. They will only be included if transitively referenced by
+        // a root entity during the closure walk. This ensures hidden products'
+        // exclusively-referenced geometry is excluded.
+    }
+    // Propagate hidden status to openings whose parent element is hidden.
+    // IfcRelVoidsElement(_, _, _, _, #RelatingElement, #RelatedOpening) — if
+    // the relating element is hidden, the opening must be excluded too.
+    propagateOpeningExclusions(dataStore, roots, hiddenProductIds);
+    return { roots, hiddenProductIds };
+}
+/**
+ * Propagate hidden status from building elements to their openings.
+ *
+ * Uses byte-level scanning on IfcRelVoidsElement entities (via byType index)
+ * to extract the last two #ID refs (RelatingBuildingElement, RelatedOpening).
+ */
+function propagateOpeningExclusions(dataStore, roots, hiddenProductIds) {
+    const source = dataStore.source;
+    if (!source)
+        return;
+    const relVoidsIds = dataStore.entityIndex.byType.get('IFCRELVOIDSELEMENT') ?? [];
+    if (relVoidsIds.length === 0)
+        return;
+    const refs = [];
+    for (const relId of relVoidsIds) {
+        const entityRef = dataStore.entityIndex.byId.get(relId);
+        if (!entityRef)
+            continue;
+        // Find the opening paren to skip the leading #ID=TYPE(
+        let parenPos = entityRef.byteOffset;
+        const end = entityRef.byteOffset + entityRef.byteLength;
+        while (parenPos < end && source[parenPos] !== 0x28 /* '(' */)
+            parenPos++;
+        if (parenPos >= end)
+            continue;
+        refs.length = 0;
+        extractRefsFromBytes(source, parenPos, end - parenPos, refs);
+        if (refs.length < 2)
+            continue;
+        const relatingElementId = refs[refs.length - 2];
+        const relatedOpeningId = refs[refs.length - 1];
+        if (hiddenProductIds.has(relatingElementId)) {
+            hiddenProductIds.add(relatedOpeningId);
+            roots.delete(relId);
+            roots.delete(relatedOpeningId);
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Style entity collection (reverse pass)
+// ---------------------------------------------------------------------------
+/**
+ * Collect style entities (IFCSTYLEDITEM, etc.) that reference geometry already
+ * in the closure, then transitively follow their style references.
+ *
+ * In IFC STEP, IFCSTYLEDITEM references a geometry RepresentationItem, but
+ * nothing references the StyledItem back. So the forward closure walk misses
+ * them entirely. This function does a reverse pass using the byType index:
+ * for each styled item, check if any referenced ID is in the closure. If yes,
+ * add the styled item and walk its style chain into the closure.
+ *
+ * Uses byType for O(styledItems) instead of O(allEntities), and byte-level
+ * scanning for #ID extraction.
+ *
+ * Must be called AFTER collectReferencedEntityIds so the closure is complete.
+ *
+ * @param closure - The existing closure set (mutated in place)
+ * @param source - The original STEP file source buffer
+ * @param entityIndex - Full entity index with type info and byType lookup
+ */
+export function collectStyleEntities(closure, source, entityIndex) {
+    const queue = [];
+    const refs = [];
+    // Use byType index for direct lookup — O(styledItems) not O(allEntities)
+    const styledItemIds = entityIndex.byType.get('IFCSTYLEDITEM') ?? [];
+    const styledRepIds = entityIndex.byType.get('IFCSTYLEDREPRESENTATION') ?? [];
+    for (const ids of [styledItemIds, styledRepIds]) {
+        for (const expressId of ids) {
+            if (closure.has(expressId))
+                continue;
+            const entityRef = entityIndex.byId.get(expressId);
+            if (!entityRef)
+                continue;
+            // Check if any referenced ID is in the closure
+            refs.length = 0;
+            extractRefsFromBytes(source, entityRef.byteOffset, entityRef.byteLength, refs);
+            let referencesClosureEntity = false;
+            for (let i = 0; i < refs.length; i++) {
+                if (closure.has(refs[i])) {
+                    referencesClosureEntity = true;
+                    break;
+                }
+            }
+            if (referencesClosureEntity) {
+                closure.add(expressId);
+                queue.push(expressId);
+            }
+        }
+    }
+    // Walk forward from newly added style entities to pull in their style chain
+    // (IfcPresentationStyleAssignment → IfcSurfaceStyle → IfcSurfaceStyleRendering → IfcColourRgb)
+    while (queue.length > 0) {
+        const entityId = queue.pop();
+        const ref = entityIndex.byId.get(entityId);
+        if (!ref)
+            continue;
+        refs.length = 0;
+        extractRefsFromBytes(source, ref.byteOffset, ref.byteLength, refs);
+        for (let i = 0; i < refs.length; i++) {
+            const referencedId = refs[i];
+            if (!closure.has(referencedId) && entityIndex.byId.has(referencedId)) {
+                closure.add(referencedId);
+                queue.push(referencedId);
+            }
+        }
+    }
+}
+//# sourceMappingURL=reference-collector.js.map

package/dist/reference-collector.js.map

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

package/dist/step-exporter.d.ts

@@ -34,6 +34,12 @@ export interface StepExportOptions {
     applyMutations?: boolean;
     /** Only export entities with mutations (delta export) */
     deltaOnly?: boolean;
+    /** Only export entities currently visible in the viewer */
+    visibleOnly?: boolean;
+    /** Hidden entity IDs (local expressIds) — required when visibleOnly is true */
+    hiddenEntityIds?: Set<number>;
+    /** Isolated entity IDs (local expressIds, null = no isolation active) */
+    isolatedEntityIds?: Set<number> | null;
 }
 /**
  * Result of STEP export

package/dist/step-exporter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"step-exporter.d.ts","sourceRoot":"","sources":["../src/step-exporter.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AASrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAI/D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,yBAAyB;IACzB,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;IACrC,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,yDAAyD;IACzD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,4CAA4C;IAC5C,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,4CAA4C;IAC5C,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,4CAA4C;IAC5C,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAE/B,2EAA2E;IAC3E,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,yDAAyD;IACzD,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,KAAK,EAAE;QACL,8BAA8B;QAC9B,WAAW,EAAE,MAAM,CAAC;QACpB,yCAAyC;QACzC,cAAc,EAAE,MAAM,CAAC;QACvB,qCAAqC;QACrC,mBAAmB,EAAE,MAAM,CAAC;QAC5B,yBAAyB;QACzB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAe;IAChC,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,aAAa,CAAS;gBAElB,SAAS,EAAE,YAAY,EAAE,YAAY,CAAC,EAAE,mBAAmB;IAOvE;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,iBAAiB,GAAG,gBAAgB;IAmJpD;;OAEG;IACH,oBAAoB,CAAC,OAAO,EAAE,IAAI,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,GAAG,gBAAgB;IAQ3F;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAgDnC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA2C9B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IASxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;OAEG;IACH,OAAO,CAAC,UAAU;IAKlB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAqCxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAuB1B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAe7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAe1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAqB5B;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,YAAY,EACvB,OAAO,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GACnC,MAAM,CAOR"}
+{"version":3,"file":"step-exporter.d.ts","sourceRoot":"","sources":["../src/step-exporter.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AASrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAK/D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,yBAAyB;IACzB,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;IACrC,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,yDAAyD;IACzD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,4CAA4C;IAC5C,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,4CAA4C;IAC5C,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,4CAA4C;IAC5C,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAE/B,2EAA2E;IAC3E,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,yDAAyD;IACzD,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,+EAA+E;IAC/E,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,yEAAyE;IACzE,iBAAiB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,KAAK,EAAE;QACL,8BAA8B;QAC9B,WAAW,EAAE,MAAM,CAAC;QACpB,yCAAyC;QACzC,cAAc,EAAE,MAAM,CAAC;QACvB,qCAAqC;QACrC,mBAAmB,EAAE,MAAM,CAAC;QAC5B,yBAAyB;QACzB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAe;IAChC,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,aAAa,CAAS;gBAElB,SAAS,EAAE,YAAY,EAAE,YAAY,CAAC,EAAE,mBAAmB;IAOvE;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,iBAAiB,GAAG,gBAAgB;IAgLpD;;OAEG;IACH,oBAAoB,CAAC,OAAO,EAAE,IAAI,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,GAAG,gBAAgB;IAQ3F;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAgDnC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA2C9B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IASxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;OAEG;IACH,OAAO,CAAC,UAAU;IAKlB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAqCxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAuB1B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAe7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAe1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAqB5B;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,YAAY,EACvB,OAAO,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GACnC,MAAM,CAOR"}

package/dist/step-exporter.js

@@ -3,6 +3,7 @@
  * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
 import { generateHeader, serializeValue, ref, } from '@ifc-lite/parser';
 import { PropertyValueType } from '@ifc-lite/data';
+import { collectReferencedEntityIds, getVisibleEntityIds, collectStyleEntities } from './reference-collector.js';
 /**
  * IFC STEP file exporter
  */
@@ -102,12 +103,26 @@ export class StepExporter {
                 },
             };
         }
+        // Build visible-only closure if requested
+        let allowedEntityIds = null;
+        if (options.visibleOnly && this.dataStore.source) {
+            const { roots, hiddenProductIds } = getVisibleEntityIds(this.dataStore, options.hiddenEntityIds ?? new Set(), options.isolatedEntityIds ?? null);
+            allowedEntityIds = collectReferencedEntityIds(roots, this.dataStore.source, this.dataStore.entityIndex.byId, hiddenProductIds);
+            // Second pass: collect IFCSTYLEDITEM entities that reference included
+            // geometry. Styled items reference geometry items but nothing references
+            // them back, so the forward closure misses them.
+            collectStyleEntities(allowedEntityIds, this.dataStore.source, this.dataStore.entityIndex);
+        }
         // Export original entities from source buffer, SKIPPING modified property sets
         if (!options.deltaOnly && this.dataStore.source) {
             const decoder = new TextDecoder();
             const source = this.dataStore.source;
             // Extract existing entities from source
             for (const [expressId, entityRef] of this.dataStore.entityIndex.byId) {
+                // Skip entities outside the visible closure
+                if (allowedEntityIds !== null && !allowedEntityIds.has(expressId)) {
+                    continue;
+                }
                 // Skip property sets/relationships that are being replaced
                 if (skipPropertySetIds.has(expressId) || skipRelationshipIds.has(expressId)) {
                     continue;