@ifc-lite/parser 5.2.0 → 6.2.1

package/dist/schedule-types.js

@@ -0,0 +1,221 @@
+/* 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 { parseIso8601Duration } from './iso8601-duration.js';
+/** IFC4 STEP attribute indices for IfcTask. */
+export const TASK_ATTR = {
+    GlobalId: 0,
+    Name: 2,
+    Description: 3,
+    ObjectType: 4,
+    Identification: 5,
+    LongDescription: 6,
+    Status: 7,
+    WorkMethod: 8,
+    IsMilestone: 9,
+    Priority: 10,
+    TaskTime: 11,
+    PredefinedType: 12,
+};
+/**
+ * IFC2X3 IfcTask layout — the attributes IfcTask itself adds over IfcObject
+ * (TaskId, Status, WorkMethod, IsMilestone, Priority). IFC2X3 schedule times
+ * live on `IfcScheduleTimeControl` and link to IfcTask via `IfcRelAssignsTasks`
+ * — we don't resolve those here yet; best-effort 2x3 models only surface task
+ * metadata without dates.
+ */
+export const TASK_ATTR_2X3 = {
+    GlobalId: 0,
+    Name: 2,
+    Description: 3,
+    ObjectType: 4,
+    TaskId: 5,
+    Status: 6,
+    WorkMethod: 7,
+    IsMilestone: 8,
+    Priority: 9,
+};
+const TASK_TIME_ATTR = {
+    Name: 0,
+    DurationType: 3,
+    ScheduleDuration: 4,
+    ScheduleStart: 5,
+    ScheduleFinish: 6,
+    EarlyStart: 7,
+    EarlyFinish: 8,
+    LateStart: 9,
+    LateFinish: 10,
+    FreeFloat: 11,
+    TotalFloat: 12,
+    IsCritical: 13,
+    StatusTime: 14,
+    ActualDuration: 15,
+    ActualStart: 16,
+    ActualFinish: 17,
+    RemainingTime: 18,
+    Completion: 19,
+};
+export const REL_SEQUENCE_ATTR = {
+    GlobalId: 0,
+    RelatingProcess: 4,
+    RelatedProcess: 5,
+    TimeLag: 6,
+    SequenceType: 7,
+    UserDefinedSequenceType: 8,
+};
+export const REL_ASSIGNS_TO_PROCESS_ATTR = {
+    RelatedObjects: 4,
+    RelatingProcess: 6,
+};
+export const REL_ASSIGNS_TO_CONTROL_ATTR = {
+    RelatedObjects: 4,
+    RelatingControl: 6,
+};
+export const REL_NESTS_ATTR = {
+    RelatingObject: 4,
+    RelatedObjects: 5,
+};
+export const WORK_SCHEDULE_ATTR = {
+    GlobalId: 0,
+    Name: 2,
+    Description: 3,
+    ObjectType: 4,
+    Identification: 5,
+    CreationDate: 6,
+    Purpose: 8,
+    Duration: 9,
+    TotalFloat: 10,
+    StartTime: 11,
+    FinishTime: 12,
+    PredefinedType: 13,
+};
+export const WORK_PLAN_ATTR = WORK_SCHEDULE_ATTR;
+const LAG_TIME_ATTR = {
+    LagValue: 3,
+    DurationType: 4,
+};
+export function asString(v) {
+    if (typeof v === 'string' && v.length > 0)
+        return v;
+    return undefined;
+}
+export function asNumber(v) {
+    if (typeof v === 'number' && Number.isFinite(v))
+        return v;
+    return undefined;
+}
+export function asBoolean(v) {
+    if (typeof v === 'boolean')
+        return v;
+    // STEP booleans are typically stored as '.T.' / '.F.' after parsing
+    if (typeof v === 'string') {
+        if (v === '.T.' || v === 'T')
+            return true;
+        if (v === '.F.' || v === 'F')
+            return false;
+    }
+    return undefined;
+}
+export function asEnum(v) {
+    if (typeof v !== 'string' || v.length === 0)
+        return undefined;
+    // STEP enum looks like .PLANNED.
+    const match = v.match(/^\.([A-Z_]+)\.$/);
+    return match ? match[1] : undefined;
+}
+export function asRef(v) {
+    if (typeof v === 'number' && Number.isInteger(v) && v > 0)
+        return v;
+    return undefined;
+}
+export function asRefList(v) {
+    if (!Array.isArray(v))
+        return [];
+    const out = [];
+    for (const x of v) {
+        const id = asRef(x);
+        if (id !== undefined)
+            out.push(id);
+    }
+    return out;
+}
+export function sequenceTypeFromString(s) {
+    switch (s) {
+        case 'START_START':
+        case 'START_FINISH':
+        case 'FINISH_START':
+        case 'FINISH_FINISH':
+        case 'USERDEFINED':
+        case 'NOTDEFINED':
+            return s;
+        default:
+            return 'FINISH_START';
+    }
+}
+function durationTypeFromString(s) {
+    switch (s) {
+        case 'WORKTIME':
+        case 'ELAPSEDTIME':
+        case 'NOTDEFINED':
+            return s;
+        default:
+            return undefined;
+    }
+}
+export function extractTaskTime(extractor, store, taskTimeId) {
+    const ref = store.entityIndex.byId.get(taskTimeId);
+    if (!ref)
+        return undefined;
+    const entity = extractor.extractEntity(ref);
+    if (!entity)
+        return undefined;
+    const t = entity.type.toUpperCase();
+    if (t !== 'IFCTASKTIME' && t !== 'IFCTASKTIMERECURRING')
+        return undefined;
+    const a = entity.attributes || [];
+    return {
+        durationType: durationTypeFromString(asEnum(a[TASK_TIME_ATTR.DurationType])),
+        scheduleDuration: asString(a[TASK_TIME_ATTR.ScheduleDuration]),
+        scheduleStart: asString(a[TASK_TIME_ATTR.ScheduleStart]),
+        scheduleFinish: asString(a[TASK_TIME_ATTR.ScheduleFinish]),
+        earlyStart: asString(a[TASK_TIME_ATTR.EarlyStart]),
+        earlyFinish: asString(a[TASK_TIME_ATTR.EarlyFinish]),
+        lateStart: asString(a[TASK_TIME_ATTR.LateStart]),
+        lateFinish: asString(a[TASK_TIME_ATTR.LateFinish]),
+        freeFloat: asString(a[TASK_TIME_ATTR.FreeFloat]),
+        totalFloat: asString(a[TASK_TIME_ATTR.TotalFloat]),
+        isCritical: asBoolean(a[TASK_TIME_ATTR.IsCritical]),
+        statusTime: asString(a[TASK_TIME_ATTR.StatusTime]),
+        actualDuration: asString(a[TASK_TIME_ATTR.ActualDuration]),
+        actualStart: asString(a[TASK_TIME_ATTR.ActualStart]),
+        actualFinish: asString(a[TASK_TIME_ATTR.ActualFinish]),
+        remainingTime: asString(a[TASK_TIME_ATTR.RemainingTime]),
+        completion: asNumber(a[TASK_TIME_ATTR.Completion]),
+    };
+}
+export function extractLagTimeSeconds(extractor, store, lagId) {
+    const ref = store.entityIndex.byId.get(lagId);
+    if (!ref)
+        return {};
+    const entity = extractor.extractEntity(ref);
+    if (!entity)
+        return {};
+    if (entity.type.toUpperCase() !== 'IFCLAGTIME')
+        return {};
+    const a = entity.attributes || [];
+    const lagValue = a[LAG_TIME_ATTR.LagValue];
+    // lagValue is an IfcTimeOrRatioSelect — either a typed wrapper like
+    // ['IFCDURATION', 'P1D'] or a direct ratio number.
+    if (Array.isArray(lagValue) && lagValue.length === 2) {
+        const typeName = String(lagValue[0]).toUpperCase();
+        const inner = lagValue[1];
+        if (typeName === 'IFCDURATION' && typeof inner === 'string') {
+            return { seconds: parseIso8601Duration(inner), duration: inner };
+        }
+    }
+    else if (typeof lagValue === 'string') {
+        return { seconds: parseIso8601Duration(lagValue), duration: lagValue };
+    }
+    return {};
+}
+//# sourceMappingURL=schedule-types.js.map

package/dist/schedule-types.js.map

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

package/dist/spatial-hierarchy-ambiguity.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Detects elements whose direct storey containment is ambiguous in the
+ * SOURCE FILE itself, i.e. more than one `IfcRelContainedInSpatialStructure`
+ * edge names a *different* storey-like spatial structure as the RelatingStructure
+ * for the same element (#4311).
+ *
+ * `elementToStorey` resolves each of these to a single winner, but this
+ * module deliberately treats HOW that winner is picked as an implementation
+ * detail it does not depend on or describe: as shipped on this branch
+ * (pre-#4310), spatial-hierarchy-builder.ts's direct-containment loop
+ * assigns `elementToStorey` unconditionally on every storey it visits, so
+ * the last storey reached in the aggregation-driven tree walk wins, NOT the
+ * first-declared `IfcRelContainedInSpatialStructure` edge - the tie-break is
+ * aggregation-order dependent, not declaration-order dependent. #4310
+ * changes that to first-declared-wins. Either way, this module answers the
+ * question that resolution silently discards - was there more than one
+ * candidate at all. The input is `byStorey`, the per-storey list of
+ * DIRECTLY contained elements that `SpatialHierarchyBuilder.assemble()`
+ * already produces regardless of tie-break strategy, so this stays correct
+ * across past and future changes to the resolution logic without needing to
+ * change with it.
+ *
+ * Two edges that repeat the SAME (storey, element) pair are not ambiguous -
+ * `RelationshipGraphBuilder` dedupes same-source/target/type `IfcRel*`
+ * instances into one edge before either side of this ever sees them
+ * (`relationship-graph.ts`), so a genuine duplicate declaration of the exact
+ * same fact never reaches `byStorey` twice for the same storey. Only a
+ * SECOND, DIFFERENT storey claiming the element counts.
+ */
+/** elementId -> storeyId, DIRECT storey containment only (one entry per
+ *  storey; see `SpatialHierarchy.byStorey`). */
+export type ByStorey = ReadonlyMap<number, readonly number[]>;
+/**
+ * Returns the set of element ids that appear under more than one distinct
+ * storey in `byStorey`. O(total direct storey-element pairs); no extra graph
+ * traversal beyond what `byStorey` already required to build.
+ */
+export declare function computeAmbiguousStorey(byStorey: ByStorey): Set<number>;
+//# sourceMappingURL=spatial-hierarchy-ambiguity.d.ts.map

package/dist/spatial-hierarchy-ambiguity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spatial-hierarchy-ambiguity.d.ts","sourceRoot":"","sources":["../src/spatial-hierarchy-ambiguity.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH;gDACgD;AAChD,MAAM,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;AAE9D;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,CActE"}

package/dist/spatial-hierarchy-ambiguity.js

@@ -0,0 +1,25 @@
+/* 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/. */
+/**
+ * Returns the set of element ids that appear under more than one distinct
+ * storey in `byStorey`. O(total direct storey-element pairs); no extra graph
+ * traversal beyond what `byStorey` already required to build.
+ */
+export function computeAmbiguousStorey(byStorey) {
+    const firstStorey = new Map();
+    const ambiguous = new Set();
+    for (const [storeyId, elementIds] of byStorey) {
+        for (const elementId of elementIds) {
+            const seen = firstStorey.get(elementId);
+            if (seen === undefined) {
+                firstStorey.set(elementId, storeyId);
+            }
+            else if (seen !== storeyId) {
+                ambiguous.add(elementId);
+            }
+        }
+    }
+    return ambiguous;
+}
+//# sourceMappingURL=spatial-hierarchy-ambiguity.js.map

package/dist/spatial-hierarchy-ambiguity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spatial-hierarchy-ambiguity.js","sourceRoot":"","sources":["../src/spatial-hierarchy-ambiguity.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAoC/D;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAkB;IACvD,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC9C,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,KAAK,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,IAAI,QAAQ,EAAE,CAAC;QAC9C,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACxC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,WAAW,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YACvC,CAAC;iBAAM,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC7B,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/spatial-hierarchy-attributes.d.ts

@@ -0,0 +1,54 @@
+import type { EntityRef } from './types.js';
+import { EntityExtractor } from './entity-extractor.js';
+import type { IfcSourceBytes } from './source-bytes.js';
+/** Source bytes needed to read on-demand attributes off the raw records
+ *  (storey elevation, LongName). Present on the fresh-parse / cache-with-source
+ *  path, absent on the source-less `buildFromCache` fallback. */
+export interface AttributeSource {
+    source: Uint8Array | IfcSourceBytes;
+    entityIndex: {
+        byId: {
+            get(expressId: number): EntityRef | undefined;
+        };
+    };
+    lengthUnitScale: number;
+}
+/**
+ * Read an entity's LongName by schema attribute *name*. IfcSite / IfcBuilding /
+ * IfcBuildingStorey / IfcSpace (and the IFC4.3 facility/infra containers)
+ * declare LongName at index 7, but IfcProject carries it at a different slot,
+ * so resolving by name (not a fixed index) stays correct across the IfcRoot
+ * family. The lookup spans every bundled schema, so IFC4.3 leaves outside the
+ * parser's IFC4 codegen pin resolve too. Returns the trimmed value, or
+ * undefined when the type declares no LongName, it is empty, or no source
+ * buffer is available (the buildFromCache path).
+ */
+export declare function extractLongName(expressId: number, attrSource: AttributeSource | undefined, attrExtractor: EntityExtractor | undefined): string | undefined;
+/**
+ * Extract elevation from an IfcBuildingStorey. Elevation is attribute index 9
+ * in both IFC2x3 and IFC4 (GlobalId, OwnerHistory, Name, Description,
+ * ObjectType, ObjectPlacement, Representation, LongName, CompositionType,
+ * Elevation).
+ */
+export declare function extractElevation(expressId: number, source: Uint8Array | IfcSourceBytes, entityIndex: {
+    byId: {
+        get(expressId: number): EntityRef | undefined;
+    };
+}): number | undefined;
+/**
+ * Resolve a storey's elevation from its ObjectPlacement, used as a fallback when
+ * the Elevation attribute is null. Walks
+ *   IfcBuildingStorey.ObjectPlacement (IfcLocalPlacement)
+ *     -> RelativePlacement (IfcAxis2Placement3D)
+ *       -> Location (IfcCartesianPoint).Coordinates[2]
+ * i.e. the storey's Z relative to its parent spatial container, which matches
+ * the semantics of the Elevation attribute and avoids folding in any site-level
+ * georeferencing Z. Returns the raw (unscaled) Z, or undefined when the chain
+ * can't be resolved.
+ */
+export declare function extractPlacementElevation(expressId: number, source: Uint8Array | IfcSourceBytes, entityIndex: {
+    byId: {
+        get(expressId: number): EntityRef | undefined;
+    };
+}): number | undefined;
+//# sourceMappingURL=spatial-hierarchy-attributes.d.ts.map

package/dist/spatial-hierarchy-attributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spatial-hierarchy-attributes.d.ts","sourceRoot":"","sources":["../src/spatial-hierarchy-attributes.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAKxD;;iEAEiE;AACjE,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,UAAU,GAAG,cAAc,CAAC;IACpC,WAAW,EAAE;QAAE,IAAI,EAAE;YAAE,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAA;SAAE,CAAA;KAAE,CAAC;IACzE,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,eAAe,GAAG,SAAS,EACvC,aAAa,EAAE,eAAe,GAAG,SAAS,GACzC,MAAM,GAAG,SAAS,CAmBpB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,UAAU,GAAG,cAAc,EACnC,WAAW,EAAE;IAAE,IAAI,EAAE;QAAE,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAA;KAAE,CAAA;CAAE,GACvE,MAAM,GAAG,SAAS,CAqCpB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,UAAU,GAAG,cAAc,EACnC,WAAW,EAAE;IAAE,IAAI,EAAE;QAAE,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAA;KAAE,CAAA;CAAE,GACvE,MAAM,GAAG,SAAS,CAoCpB"}

package/dist/spatial-hierarchy-attributes.js

@@ -0,0 +1,145 @@
+/* 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/. */
+/**
+ * Attribute extraction for spatial hierarchy nodes - reads a node's LongName,
+ * its IfcBuildingStorey Elevation, and the ObjectPlacement-Z fallback
+ * straight off the raw IFC records via `EntityExtractor`.
+ *
+ * Split out of spatial-hierarchy-builder.ts: these three functions share one
+ * concern - resolving values from source bytes when a source is available -
+ * distinct from the tree-building recursion in `buildNode` that calls them.
+ * Same pattern as spatial-hierarchy-canonical-parent.ts, which split out the
+ * cycle-safe canonical-parent resolution for the same reason.
+ */
+import { createLogger, IFC_BUILDING_STOREY_ELEVATION_INDEX, IFC_BUILDING_STOREY_PLACEMENT_INDEX, } from '@ifc-lite/data';
+import { EntityExtractor } from './entity-extractor.js';
+import { getAttributeNamesAcrossSchemas } from './ifc-schema.js';
+const log = createLogger('SpatialHierarchy');
+/**
+ * Read an entity's LongName by schema attribute *name*. IfcSite / IfcBuilding /
+ * IfcBuildingStorey / IfcSpace (and the IFC4.3 facility/infra containers)
+ * declare LongName at index 7, but IfcProject carries it at a different slot,
+ * so resolving by name (not a fixed index) stays correct across the IfcRoot
+ * family. The lookup spans every bundled schema, so IFC4.3 leaves outside the
+ * parser's IFC4 codegen pin resolve too. Returns the trimmed value, or
+ * undefined when the type declares no LongName, it is empty, or no source
+ * buffer is available (the buildFromCache path).
+ */
+export function extractLongName(expressId, attrSource, attrExtractor) {
+    if (!attrSource || !attrExtractor)
+        return undefined;
+    const ref = attrSource.entityIndex.byId.get(expressId);
+    if (!ref)
+        return undefined;
+    try {
+        const entity = attrExtractor.extractEntity(ref);
+        if (!entity)
+            return undefined;
+        const idx = getAttributeNamesAcrossSchemas(entity.type).indexOf('LongName');
+        if (idx < 0)
+            return undefined;
+        const raw = (entity.attributes || [])[idx];
+        const value = typeof raw === 'string' ? raw.trim() : '';
+        return value.length > 0 ? value : undefined;
+    }
+    catch (error) {
+        log.caught('Failed to extract LongName', error, {
+            operation: 'extractLongName',
+            entityId: expressId,
+        });
+        return undefined;
+    }
+}
+/**
+ * Extract elevation from an IfcBuildingStorey. Elevation is attribute index 9
+ * in both IFC2x3 and IFC4 (GlobalId, OwnerHistory, Name, Description,
+ * ObjectType, ObjectPlacement, Representation, LongName, CompositionType,
+ * Elevation).
+ */
+export function extractElevation(expressId, source, entityIndex) {
+    const ref = entityIndex.byId.get(expressId);
+    if (!ref)
+        return undefined;
+    try {
+        const extractor = new EntityExtractor(source);
+        const entity = extractor.extractEntity(ref);
+        if (!entity)
+            return undefined;
+        const attrs = entity.attributes || [];
+        // Number from a raw value or a typed value like ['IFCLENGTHMEASURE', 3.0].
+        const extractNumber = (val) => {
+            if (typeof val === 'number')
+                return val;
+            if (Array.isArray(val) && val.length === 2 && typeof val[1] === 'number') {
+                return val[1];
+            }
+            return undefined;
+        };
+        // Read ONLY the Elevation slot: a previous "scan every attribute for a
+        // number < 10000" fallback wrongly treated reference attributes (parsed as
+        // bare express-id numbers, e.g. OwnerHistory #3628 -> 3628) as elevations,
+        // so a storey with a null Elevation got a garbage value instead of falling
+        // through to the ObjectPlacement-Z fallback below (#1289).
+        if (attrs.length > IFC_BUILDING_STOREY_ELEVATION_INDEX) {
+            return extractNumber(attrs[IFC_BUILDING_STOREY_ELEVATION_INDEX]);
+        }
+    }
+    catch (error) {
+        log.caught('Failed to extract elevation', error, {
+            operation: 'extractElevation',
+            entityId: expressId,
+            entityType: 'IfcBuildingStorey',
+        });
+    }
+    return undefined;
+}
+/**
+ * Resolve a storey's elevation from its ObjectPlacement, used as a fallback when
+ * the Elevation attribute is null. Walks
+ *   IfcBuildingStorey.ObjectPlacement (IfcLocalPlacement)
+ *     -> RelativePlacement (IfcAxis2Placement3D)
+ *       -> Location (IfcCartesianPoint).Coordinates[2]
+ * i.e. the storey's Z relative to its parent spatial container, which matches
+ * the semantics of the Elevation attribute and avoids folding in any site-level
+ * georeferencing Z. Returns the raw (unscaled) Z, or undefined when the chain
+ * can't be resolved.
+ */
+export function extractPlacementElevation(expressId, source, entityIndex) {
+    try {
+        const extractor = new EntityExtractor(source);
+        const readAttrs = (id) => {
+            const ref = entityIndex.byId.get(id);
+            if (!ref)
+                return undefined;
+            return extractor.extractEntity(ref)?.attributes ?? undefined;
+        };
+        const placementId = readAttrs(expressId)?.[IFC_BUILDING_STOREY_PLACEMENT_INDEX];
+        if (typeof placementId !== 'number')
+            return undefined;
+        // IfcLocalPlacement(PlacementRelTo, RelativePlacement) - RelativePlacement
+        // (index 1) is the IfcAxis2Placement3D carrying this storey's own offset.
+        const axisId = readAttrs(placementId)?.[1];
+        if (typeof axisId !== 'number')
+            return undefined;
+        // IfcAxis2Placement3D(Location, Axis, RefDirection) - Location (index 0) is
+        // an IfcCartesianPoint.
+        const locationId = readAttrs(axisId)?.[0];
+        if (typeof locationId !== 'number')
+            return undefined;
+        // IfcCartesianPoint.Coordinates (index 0) is a list [x, y, z].
+        const coords = readAttrs(locationId)?.[0];
+        if (Array.isArray(coords) && coords.length >= 3 && typeof coords[2] === 'number') {
+            return coords[2];
+        }
+    }
+    catch (error) {
+        log.caught('Failed to extract placement elevation', error, {
+            operation: 'extractPlacementElevation',
+            entityId: expressId,
+            entityType: 'IfcBuildingStorey',
+        });
+    }
+    return undefined;
+}
+//# sourceMappingURL=spatial-hierarchy-attributes.js.map

package/dist/spatial-hierarchy-attributes.js.map

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

package/dist/spatial-hierarchy-builder.d.ts

@@ -30,35 +30,5 @@ export declare class SpatialHierarchyBuilder {
     buildFromCache(entities: EntityTable, relationships: RelationshipGraph): SpatialHierarchy | undefined;
     private assemble;
     private buildNode;
-    /**
-     * Read an entity's LongName by schema attribute *name*. IfcSite / IfcBuilding /
-     * IfcBuildingStorey / IfcSpace (and the IFC4.3 facility/infra containers)
-     * declare LongName at index 7, but IfcProject carries it at a different slot,
-     * so resolving by name (not a fixed index) stays correct across the IfcRoot
-     * family. The lookup spans every bundled schema, so IFC4.3 leaves outside the
-     * parser's IFC4 codegen pin resolve too. Returns the trimmed value, or
-     * undefined when the type declares no LongName, it is empty, or no source
-     * buffer is available (the buildFromCache path).
-     */
-    private extractLongName;
-    /**
-     * Extract elevation from an IfcBuildingStorey. Elevation is attribute index 9
-     * in both IFC2x3 and IFC4 (GlobalId, OwnerHistory, Name, Description,
-     * ObjectType, ObjectPlacement, Representation, LongName, CompositionType,
-     * Elevation).
-     */
-    private extractElevation;
-    /**
-     * Resolve a storey's elevation from its ObjectPlacement, used as a fallback when
-     * the Elevation attribute is null. Walks
-     *   IfcBuildingStorey.ObjectPlacement (IfcLocalPlacement)
-     *     -> RelativePlacement (IfcAxis2Placement3D)
-     *       -> Location (IfcCartesianPoint).Coordinates[2]
-     * i.e. the storey's Z relative to its parent spatial container, which matches
-     * the semantics of the Elevation attribute and avoids folding in any site-level
-     * georeferencing Z. Returns the raw (unscaled) Z, or undefined when the chain
-     * can't be resolved.
-     */
-    private extractPlacementElevation;
 }
 //# sourceMappingURL=spatial-hierarchy-builder.d.ts.map

package/dist/spatial-hierarchy-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spatial-hierarchy-builder.d.ts","sourceRoot":"","sources":["../src/spatial-hierarchy-builder.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,iBAAiB,EAAE,gBAAgB,EAAe,MAAM,gBAAgB,CAAC;AAajH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAmCxD,qBAAa,uBAAuB;IAClC;;;;;OAKG;IACH,KAAK,CACH,QAAQ,EAAE,WAAW,EACrB,aAAa,EAAE,iBAAiB,EAChC,QAAQ,EAAE,WAAW,EACrB,MAAM,EAAE,UAAU,GAAG,cAAc,EACnC,WAAW,EAAE;QAAE,IAAI,EAAE;YAAE,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAA;SAAE,CAAA;KAAE,EACxE,eAAe,GAAE,MAAY,GAC5B,gBAAgB;IAMnB;;;OAGG;IACH,cAAc,CACZ,QAAQ,EAAE,WAAW,EACrB,aAAa,EAAE,iBAAiB,GAC/B,gBAAgB,GAAG,SAAS;IAI/B,OAAO,CAAC,QAAQ;IAoGhB,OAAO,CAAC,SAAS;IA8JjB;;;;;;;;;OASG;IACH,OAAO,CAAC,eAAe;IAqBvB;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IA2CxB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,yBAAyB;CAyClC"}
+{"version":3,"file":"spatial-hierarchy-builder.d.ts","sourceRoot":"","sources":["../src/spatial-hierarchy-builder.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,iBAAiB,EAAE,gBAAgB,EAAe,MAAM,gBAAgB,CAAC;AAWjH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAiCxD,qBAAa,uBAAuB;IAClC;;;;;OAKG;IACH,KAAK,CACH,QAAQ,EAAE,WAAW,EACrB,aAAa,EAAE,iBAAiB,EAChC,QAAQ,EAAE,WAAW,EACrB,MAAM,EAAE,UAAU,GAAG,cAAc,EACnC,WAAW,EAAE;QAAE,IAAI,EAAE;YAAE,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAA;SAAE,CAAA;KAAE,EACxE,eAAe,GAAE,MAAY,GAC5B,gBAAgB;IAMnB;;;OAGG;IACH,cAAc,CACZ,QAAQ,EAAE,WAAW,EACrB,aAAa,EAAE,iBAAiB,GAC/B,gBAAgB,GAAG,SAAS;IAI/B,OAAO,CAAC,QAAQ;IA6EhB,OAAO,CAAC,SAAS;CAwLlB"}