@ifc-lite/parser 5.1.0 → 6.1.0

package/dist/structural-extractor.js

@@ -0,0 +1,310 @@
+/* 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/. */
+/**
+ * Structural analysis extractor — parses IfcStructuralAnalysisModel,
+ * IfcStructuralMember / IfcStructuralConnection subtypes, IfcStructuralAction /
+ * IfcStructuralReaction subtypes, IfcStructuralLoadGroup / IfcStructuralLoadCase,
+ * IfcStructuralResultGroup, IfcBoundaryCondition, IfcRelConnectsStructuralMember,
+ * IfcRelConnectsStructuralActivity and IfcRelAssignsToGroup from a parsed
+ * IfcDataStore into a connected `StructuralExtraction`.
+ *
+ * On-demand, like the schedule extractor: nothing here runs during a normal
+ * parse, and a model with no structural entity costs one `byType` sweep.
+ *
+ * The two structural connects-relationships are read from the type index
+ * directly rather than from the relationship graph, because that graph's
+ * `REL_TYPE_MAP` carries neither of them — the rows are retained, but nothing
+ * indexes member↔connection or item↔activity edges for a query traversal to
+ * follow.
+ *
+ * Two things are schema-derived rather than hand-tabulated, because the
+ * alternative is a table that silently mis-reads the next subtype to appear:
+ *
+ * - **Which types count.** Every `IFCSTRUCTURAL*` key in the type index is
+ *   classified by its inheritance chain, so `IfcStructuralCurveMemberVarying`
+ *   is a member and `IfcStructuralLinearAction` is an action without either
+ *   being named here.
+ * - **Where each attribute sits.** Positions come from the generated registry
+ *   by EXPRESS attribute name, never from a literal index.
+ *
+ * IFC2X3 support is best-effort and the divergences are known, not assumed:
+ * 2X3 has no IfcStructuralCurveAction, IfcStructuralSurfaceAction,
+ * IfcStructuralCurveReaction, IfcStructuralLoadCase or
+ * IfcStructuralLoadConfiguration at all, and its IfcStructuralCurveMember has
+ * no `Axis`. Positions resolve against the parser's IFC4 registry pin, which
+ * agrees with 2X3 on the attributes both schemas share for every type read
+ * here; a 2X3-only attribute reads as absent rather than as the wrong slot.
+ */
+import { EntityExtractor } from './entity-extractor.js';
+import { getInheritanceChain } from './ifc-schema.js';
+import { extractBoundaryCondition, extractStructuralLoad, } from './structural-load-extractor.js';
+import { addUnique, asBoolean, asEnum, asNumber, asNumberList, asRef, asRefList, asString, readAttr, readEntities, } from './structural-step-values.js';
+function emptyExtraction() {
+    return {
+        analysisModels: [],
+        members: [],
+        connections: [],
+        activities: [],
+        loadGroups: [],
+        resultGroups: [],
+        hasStructural: false,
+        loadsTruncated: false,
+    };
+}
+/** Chain marker → role. Every marker is disjoint, so match order is not load-bearing. */
+const ROLE_BY_SUPERTYPE = [
+    ['IFCSTRUCTURALANALYSISMODEL', 'analysisModel'],
+    ['IFCSTRUCTURALRESULTGROUP', 'resultGroup'],
+    ['IFCSTRUCTURALLOADGROUP', 'loadGroup'],
+    ['IFCSTRUCTURALMEMBER', 'member'],
+    ['IFCSTRUCTURALCONNECTION', 'connection'],
+    ['IFCSTRUCTURALACTIVITY', 'activity'],
+];
+/**
+ * Classify a concrete type by inheritance, not by name. Returns undefined for
+ * an `IFCSTRUCTURAL*` type that is none of the six roles — `IfcStructuralLoad`
+ * leaves and `IfcStructuralProfileProperties` reach here and are read through
+ * their owners instead.
+ */
+function roleOf(type) {
+    const chain = getInheritanceChain(type).map((c) => c.toUpperCase());
+    for (const [marker, role] of ROLE_BY_SUPERTYPE) {
+        if (chain.includes(marker))
+            return role;
+    }
+    return undefined;
+}
+function activityKind(type) {
+    const chain = getInheritanceChain(type).map((c) => c.toUpperCase());
+    if (chain.includes('IFCSTRUCTURALACTION'))
+        return 'Action';
+    if (chain.includes('IFCSTRUCTURALREACTION'))
+        return 'Reaction';
+    return 'Unknown';
+}
+/** IfcRoot attribute 2 is Name, 3 Description; IfcObject adds ObjectType at 4. */
+function rootFields(e) {
+    return {
+        name: asString(e.attrs[2]),
+        description: asString(e.attrs[3]),
+        objectType: asString(e.attrs[4]),
+    };
+}
+/**
+ * Extract all structural analysis data from a parsed IFC store.
+ */
+export function extractStructuralOnDemand(store) {
+    if (!store.source?.length)
+        return emptyExtraction();
+    const byType = store.entityIndex.byType;
+    // Partition every IFCSTRUCTURAL* type present into the six roles.
+    const idsByRole = new Map();
+    for (const [typeKey, ids] of byType) {
+        if (!typeKey.startsWith('IFCSTRUCTURAL'))
+            continue;
+        const role = roleOf(typeKey);
+        if (!role)
+            continue;
+        const bucket = idsByRole.get(role);
+        if (bucket)
+            bucket.push(...ids);
+        else
+            idsByRole.set(role, [...ids]);
+    }
+    const relMemberIds = byType.get('IFCRELCONNECTSSTRUCTURALMEMBER') ?? [];
+    const relActivityIds = byType.get('IFCRELCONNECTSSTRUCTURALACTIVITY') ?? [];
+    const relGroupIds = byType.get('IFCRELASSIGNSTOGROUP') ?? [];
+    // Behaviour-neutral early-out, not a guard: with no structural entity the
+    // passes below already produce an empty extraction. It exists so the common
+    // case — a model with no structural analysis at all — never constructs an
+    // EntityExtractor over the whole source buffer.
+    if (idsByRole.size === 0)
+        return emptyExtraction();
+    const extractor = new EntityExtractor(store.source);
+    const read = (role) => readEntities(extractor, store, idsByRole.get(role) ?? []);
+    const memberRaw = read('member');
+    const connectionRaw = read('connection');
+    const activityRaw = read('activity');
+    const loadGroupRaw = read('loadGroup');
+    const resultGroupRaw = read('resultGroup');
+    const analysisModelRaw = read('analysisModel');
+    /** expressId → globalId, over every structural entity we resolved. */
+    const globalIdById = new Map();
+    for (const list of [
+        memberRaw,
+        connectionRaw,
+        activityRaw,
+        loadGroupRaw,
+        resultGroupRaw,
+        analysisModelRaw,
+    ]) {
+        for (const e of list)
+            if (e.globalId)
+                globalIdById.set(e.expressId, e.globalId);
+    }
+    // ── Relationship passes ────────────────────────────────────────────────
+    const connectionsOfMember = new Map();
+    const membersOfConnection = new Map();
+    for (const rel of readEntities(extractor, store, relMemberIds)) {
+        const memberId = asRef(readAttr(rel.type, rel.attrs, 'RelatingStructuralMember'));
+        const connectionId = asRef(readAttr(rel.type, rel.attrs, 'RelatedStructuralConnection'));
+        if (memberId === undefined || connectionId === undefined)
+            continue;
+        const memberGid = globalIdById.get(memberId);
+        const connectionGid = globalIdById.get(connectionId);
+        if (connectionGid)
+            addUnique(connectionsOfMember, memberId, connectionGid);
+        if (memberGid)
+            addUnique(membersOfConnection, connectionId, memberGid);
+    }
+    const activitiesOfItem = new Map();
+    /** activity expressId → the item globalId it applies to. */
+    const itemOfActivity = new Map();
+    for (const rel of readEntities(extractor, store, relActivityIds)) {
+        const itemId = asRef(readAttr(rel.type, rel.attrs, 'RelatingElement'));
+        const activityId = asRef(readAttr(rel.type, rel.attrs, 'RelatedStructuralActivity'));
+        if (itemId === undefined || activityId === undefined)
+            continue;
+        const activityGid = globalIdById.get(activityId);
+        const itemGid = globalIdById.get(itemId);
+        if (activityGid)
+            addUnique(activitiesOfItem, itemId, activityGid);
+        if (itemGid)
+            itemOfActivity.set(activityId, itemGid);
+    }
+    // IfcRelAssignsToGroup is shared with every other grouping in the file, so
+    // only the rows whose RelatingGroup is a structural group are read.
+    const groupsOfObject = new Map();
+    const objectsOfGroup = new Map();
+    for (const rel of readEntities(extractor, store, relGroupIds)) {
+        const groupId = asRef(readAttr(rel.type, rel.attrs, 'RelatingGroup'));
+        if (groupId === undefined)
+            continue;
+        const groupGid = globalIdById.get(groupId);
+        if (!groupGid)
+            continue;
+        for (const objectId of asRefList(readAttr(rel.type, rel.attrs, 'RelatedObjects'))) {
+            addUnique(groupsOfObject, objectId, groupGid);
+            const objectGid = globalIdById.get(objectId);
+            if (objectGid)
+                addUnique(objectsOfGroup, groupId, objectGid);
+        }
+    }
+    /**
+     * A group's `RelatedObjects` may hold anything, and IfcRelAssignsToGroup is
+     * not structural-specific, so each of the three directions below is narrowed
+     * to the role its field name promises rather than reporting the raw set.
+     */
+    const gidsOf = (lists) => new Set(lists.flat().map((e) => e.globalId).filter((g) => g.length > 0));
+    const analysisModelGids = gidsOf([analysisModelRaw]);
+    const activityGids = gidsOf([activityRaw]);
+    const itemGids = gidsOf([memberRaw, connectionRaw]);
+    /** Only those of `expressId`'s groups that are analysis models. */
+    const modelsOf = (expressId) => (groupsOfObject.get(expressId) ?? []).filter((g) => analysisModelGids.has(g));
+    /** Only the activities assigned into the group `expressId`. */
+    const activitiesIn = (expressId) => (objectsOfGroup.get(expressId) ?? []).filter((g) => activityGids.has(g));
+    /** Only the members and connections assigned into the group `expressId`. */
+    const itemsIn = (expressId) => (objectsOfGroup.get(expressId) ?? []).filter((g) => itemGids.has(g));
+    const resolveGids = (value) => asRefList(value)
+        .map((id) => globalIdById.get(id))
+        .filter((g) => g !== undefined);
+    // ── Assemble ───────────────────────────────────────────────────────────
+    const members = memberRaw.map((e) => ({
+        expressId: e.expressId,
+        globalId: e.globalId,
+        type: e.type,
+        ...rootFields(e),
+        predefinedType: asEnum(readAttr(e.type, e.attrs, 'PredefinedType')),
+        thickness: asNumber(readAttr(e.type, e.attrs, 'Thickness')),
+        connectionGlobalIds: connectionsOfMember.get(e.expressId) ?? [],
+        activityGlobalIds: activitiesOfItem.get(e.expressId) ?? [],
+        analysisModelGlobalIds: modelsOf(e.expressId),
+    }));
+    const connections = connectionRaw.map((e) => {
+        const conditionId = asRef(readAttr(e.type, e.attrs, 'AppliedCondition'));
+        return {
+            expressId: e.expressId,
+            globalId: e.globalId,
+            type: e.type,
+            ...rootFields(e),
+            appliedCondition: conditionId === undefined
+                ? undefined
+                : extractBoundaryCondition(extractor, store, conditionId),
+            memberGlobalIds: membersOfConnection.get(e.expressId) ?? [],
+            activityGlobalIds: activitiesOfItem.get(e.expressId) ?? [],
+            analysisModelGlobalIds: modelsOf(e.expressId),
+        };
+    });
+    const activities = activityRaw.map((e) => {
+        const loadId = asRef(readAttr(e.type, e.attrs, 'AppliedLoad'));
+        return {
+            expressId: e.expressId,
+            globalId: e.globalId,
+            type: e.type,
+            kind: activityKind(e.type),
+            ...rootFields(e),
+            predefinedType: asEnum(readAttr(e.type, e.attrs, 'PredefinedType')),
+            globalOrLocal: asEnum(readAttr(e.type, e.attrs, 'GlobalOrLocal')),
+            destabilizingLoad: asBoolean(readAttr(e.type, e.attrs, 'DestabilizingLoad')),
+            appliedLoad: loadId === undefined ? undefined : extractStructuralLoad(extractor, store, loadId),
+            appliesToGlobalId: itemOfActivity.get(e.expressId),
+            groupGlobalIds: groupsOfObject.get(e.expressId) ?? [],
+        };
+    });
+    const loadGroups = loadGroupRaw.map((e) => ({
+        expressId: e.expressId,
+        globalId: e.globalId,
+        type: e.type,
+        ...rootFields(e),
+        predefinedType: asEnum(readAttr(e.type, e.attrs, 'PredefinedType')),
+        actionType: asEnum(readAttr(e.type, e.attrs, 'ActionType')),
+        actionSource: asEnum(readAttr(e.type, e.attrs, 'ActionSource')),
+        coefficient: asNumber(readAttr(e.type, e.attrs, 'Coefficient')),
+        purpose: asString(readAttr(e.type, e.attrs, 'Purpose')),
+        selfWeightCoefficients: asNumberList(readAttr(e.type, e.attrs, 'SelfWeightCoefficients')),
+        activityGlobalIds: activitiesIn(e.expressId),
+    }));
+    const resultGroups = resultGroupRaw.map((e) => {
+        const forLoadGroup = asRef(readAttr(e.type, e.attrs, 'ResultForLoadGroup'));
+        return {
+            expressId: e.expressId,
+            globalId: e.globalId,
+            ...rootFields(e),
+            theoryType: asEnum(readAttr(e.type, e.attrs, 'TheoryType')),
+            isLinear: asBoolean(readAttr(e.type, e.attrs, 'IsLinear')),
+            resultForLoadGroupGlobalId: forLoadGroup === undefined ? undefined : globalIdById.get(forLoadGroup),
+            activityGlobalIds: activitiesIn(e.expressId),
+        };
+    });
+    const analysisModels = analysisModelRaw.map((e) => ({
+        expressId: e.expressId,
+        globalId: e.globalId,
+        ...rootFields(e),
+        predefinedType: asEnum(readAttr(e.type, e.attrs, 'PredefinedType')),
+        loadGroupGlobalIds: resolveGids(readAttr(e.type, e.attrs, 'LoadedBy')),
+        resultGroupGlobalIds: resolveGids(readAttr(e.type, e.attrs, 'HasResults')),
+        itemGlobalIds: itemsIn(e.expressId),
+    }));
+    return {
+        analysisModels,
+        members,
+        connections,
+        activities,
+        loadGroups,
+        resultGroups,
+        hasStructural: analysisModels.length +
+            members.length +
+            connections.length +
+            activities.length +
+            loadGroups.length +
+            resultGroups.length >
+            0,
+        // Derived from the loads rather than tracked alongside them, so the
+        // extraction cannot claim a completeness its own tree contradicts. A
+        // nested configuration propagates its truncation to its parent, so the
+        // top-level load carries the whole subtree's answer.
+        loadsTruncated: activities.some((a) => a.appliedLoad?.configuration?.truncated === true),
+    };
+}
+//# sourceMappingURL=structural-extractor.js.map

package/dist/structural-extractor.js.map

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

package/dist/structural-load-extractor.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Structural load and boundary-condition readers — the leaf resources an
+ * activity's `AppliedLoad` and a connection's `AppliedCondition` point at.
+ *
+ * Both readers are **schema-derived**: they ask the generated registry for the
+ * entity's attribute names in STEP positional order and emit every numeric
+ * component under its exact EXPRESS name, rather than carrying a hand-written
+ * table per `IfcStructuralLoadStatic` / `IfcBoundaryCondition` subtype. A
+ * subtype the registry knows therefore reads correctly the day it appears in a
+ * file, and `IfcStructuralLoadSingleForceWarping.WarpingMoment` needs no
+ * separate case from `IfcStructuralLoadSingleForce.ForceX`.
+ */
+import type { EntityExtractor } from './entity-extractor.js';
+import type { IfcDataStore } from './columnar-parser.js';
+/**
+ * One `IfcStructuralLoadOrResult` leaf — a force, displacement, temperature or
+ * planar/linear force — reduced to its named numeric components.
+ */
+export interface StructuralLoadInfo {
+    expressId: number;
+    /** Canonical EXPRESS type name, e.g. `IfcStructuralLoadSingleForce`. */
+    type: string;
+    name?: string;
+    /**
+     * Numeric components keyed by their exact EXPRESS attribute name
+     * (`ForceX`, `MomentZ`, `DisplacementY`, `DeltaTConstant`, …). Only
+     * attributes the file actually carries a finite number for appear; an
+     * omitted (`$`) optional is absent rather than zero, because zero is a
+     * meaningful load value and conflating the two would invent data.
+     */
+    components: Record<string, number>;
+    /**
+     * Present only for `IfcStructuralLoadConfiguration`: the nested loads and
+     * the parametric locations they apply at, as {@link StructuralLoadConfigurationInfo}.
+     */
+    configuration?: StructuralLoadConfigurationInfo;
+}
+/**
+ * Why one `Values` slot carries no nested load.
+ *
+ * The first three are **our** bounds firing — the file may hold more than we
+ * agreed to read, and {@link StructuralLoadConfigurationInfo.truncated} is set.
+ * The last three are the file's own data: there is nothing further to read, so
+ * they are not truncation.
+ */
+export type StructuralLoadDropReason = 
+/** Below the nesting cap: the chain is longer than this reader follows. */
+'depth'
+/** The slot re-enters a configuration already open on this path. */
+ | 'cycle'
+/** The node budget for this top-level load was spent before this slot. */
+ | 'budget'
+/** The slot is not an entity reference at all (`$`, an inline value, …). */
+ | 'invalid-reference'
+/** The referenced expressId is in no index — a dangling reference. */
+ | 'unresolved'
+/** The referenced record is indexed but did not parse. */
+ | 'unreadable';
+/** One `Values` slot of an `IfcStructuralLoadConfiguration`, with its location. */
+export interface StructuralLoadConfigurationEntry {
+    /** The nested load, absent when the slot could not be read. */
+    value?: StructuralLoadInfo;
+    /** Why {@link value} is absent; absent whenever `value` is present. */
+    dropped?: StructuralLoadDropReason;
+    /**
+     * The `Locations` row at this same slot, when the file carries one. Absent
+     * when the file omits the optional `Locations`, lists fewer rows than
+     * `Values` has slots, or writes this row as `$` / with a non-numeric cell
+     * (the row keeps its position as an empty placeholder in `locations`).
+     */
+    location?: number[];
+}
+/** The `Values`/`Locations` pair of an `IfcStructuralLoadConfiguration`. */
+export interface StructuralLoadConfigurationInfo {
+    /**
+     * One entry per `Values` slot, in file order. The pairing the schema
+     * requires — the i-th location positions the i-th value — is carried inside
+     * the entry rather than across two arrays, so a slot this reader could not
+     * resolve keeps its place with `value` absent and `dropped` naming why. A
+     * dropped slot that instead shifted its successors left would report a later
+     * load as applied at an earlier station, which reads as real data.
+     */
+    entries: StructuralLoadConfigurationEntry[];
+    /**
+     * `Locations` as the file writes it, absent when the file omits it or writes
+     * it unusably. Kept beside {@link entries} for the malformed case where it is
+     * longer than `Values`: those extra rows belong to no slot and would
+     * otherwise be lost. Consumers pairing a load with its station read
+     * `entries[i].location`, never this list.
+     */
+    locations?: number[][];
+    /**
+     * True when a bound of this reader — the depth cap, the node budget, or the
+     * cycle guard — dropped a slot in this configuration or anywhere beneath it.
+     * It separates "the file holds no more" from "we stopped reading", which a
+     * truncated tree otherwise reports identically to a genuinely small one.
+     */
+    truncated: boolean;
+}
+/** An `IfcBoundaryCondition` leaf reduced to its named stiffness components. */
+export interface BoundaryConditionInfo {
+    expressId: number;
+    /** Canonical EXPRESS type name, e.g. `IfcBoundaryNodeCondition`. */
+    type: string;
+    name?: string;
+    /**
+     * Stiffness components keyed by their exact EXPRESS attribute name
+     * (`TranslationalStiffnessX`, `RotationalStiffnessZ`, …).
+     *
+     * The value is a number when the file gives a stiffness magnitude, and a
+     * boolean when it uses the select's `IfcBoolean` branch — which is how a
+     * fully fixed or fully free degree of freedom is written (`.T.` = fixed).
+     * Collapsing the boolean branch to a number would report a rigid support as
+     * stiffness 1.
+     */
+    components: Record<string, number | boolean>;
+}
+/**
+ * Read one `IfcStructuralLoad` entity by expressId, resolving an
+ * `IfcStructuralLoadConfiguration` down through the loads its `Values` name.
+ *
+ * The `Values` edge is the only recursive one here, and it is
+ * exporter-controlled, so it is bounded three ways — none of which is
+ * redundant:
+ *
+ * - a **path-local** cycle set stops a configuration that reaches itself. It
+ *   has to be path-local rather than shared across siblings, because `Values`
+ *   is a LIST and may legitimately name one load twice; a shared set would
+ *   suppress the repeat as if it were a cycle and report one load where the
+ *   file applies two.
+ * - a **depth cap** bounds one chain's length, which the cycle set alone does
+ *   not for a long acyclic chain.
+ * - a **node budget** bounds total work. The first two still admit `k`
+ *   children each recursing `k` deep, which is O(k^depth) — an abort turned
+ *   into a hang, and a hang reports nothing.
+ *
+ * All three bounds, and every reference this reader cannot follow for the
+ * file's own reasons, keep the `Values` slot they gave up on: the slot becomes
+ * an entry with no `value` and a `dropped` reason naming which it was, so
+ * the station a `Locations` row names still belongs to the load the file put
+ * there. Only the three bounds set `truncated`, since only they mean the file
+ * holds more than this reader agreed to walk.
+ */
+export declare function extractStructuralLoad(extractor: EntityExtractor, store: IfcDataStore, expressId: number): StructuralLoadInfo | undefined;
+/** Read one `IfcBoundaryCondition` entity by expressId. */
+export declare function extractBoundaryCondition(extractor: EntityExtractor, store: IfcDataStore, expressId: number): BoundaryConditionInfo | undefined;
+//# sourceMappingURL=structural-load-extractor.d.ts.map

package/dist/structural-load-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structural-load-extractor.d.ts","sourceRoot":"","sources":["../src/structural-load-extractor.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAkBzD;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;OAMG;IACH,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC;;;OAGG;IACH,aAAa,CAAC,EAAE,+BAA+B,CAAC;CACjD;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,wBAAwB;AAClC,2EAA2E;AACzE,OAAO;AACT,oEAAoE;GAClE,OAAO;AACT,0EAA0E;GACxE,QAAQ;AACV,4EAA4E;GAC1E,mBAAmB;AACrB,sEAAsE;GACpE,YAAY;AACd,0DAA0D;GACxD,YAAY,CAAC;AAEjB,mFAAmF;AACnF,MAAM,WAAW,gCAAgC;IAC/C,+DAA+D;IAC/D,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,uEAAuE;IACvE,OAAO,CAAC,EAAE,wBAAwB,CAAC;IACnC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,4EAA4E;AAC5E,MAAM,WAAW,+BAA+B;IAC9C;;;;;;;OAOG;IACH,OAAO,EAAE,gCAAgC,EAAE,CAAC;IAC5C;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;IACvB;;;;;OAKG;IACH,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,gFAAgF;AAChF,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;;;OASG;IACH,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;CAC9C;AA0BD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,eAAe,EAC1B,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,MAAM,GAChB,kBAAkB,GAAG,SAAS,CAEhC;AA8FD,2DAA2D;AAC3D,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,eAAe,EAC1B,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,MAAM,GAChB,qBAAqB,GAAG,SAAS,CA0BnC"}

package/dist/structural-load-extractor.js

@@ -0,0 +1,178 @@
+/* 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 { getAttributeNames, normalizeIfcTypeName } from './ifc-schema.js';
+import { asBoolean, asNumber, asString } from './structural-step-values.js';
+/** Attributes that every load/condition carries from its supertype, not a component. */
+const NAME_ATTR = 'Name';
+/**
+ * `IfcStructuralLoadConfiguration` positional attributes. Named here rather
+ * than resolved by name because this is the one load whose components are
+ * references and lists instead of measures.
+ */
+const LOAD_CONFIGURATION_ATTR = {
+    Name: 0,
+    Values: 1,
+    Locations: 2,
+};
+/**
+ * Read the `Locations` attribute of an `IfcStructuralLoadConfiguration`: a
+ * list of 1..2-element lists of `IfcLengthMeasure`.
+ */
+function readLocations(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    // A flat scalar list (`(0.,4.5)` instead of `((0.),(4.5))`) is unusable as
+    // a whole. Otherwise keep one row per slot so `Values[i]` still pairs with
+    // `Locations[i]`: a `$` row or a row with a non-numeric cell becomes an
+    // EMPTY placeholder rather than being dropped (which would shift every
+    // later row onto the wrong slot) or compacted.
+    if (!value.some((row) => Array.isArray(row)))
+        return undefined;
+    return value.map((row) => {
+        if (!Array.isArray(row))
+            return [];
+        const nums = row.map(asNumber);
+        return nums.every((n) => n !== undefined) ? nums : [];
+    });
+}
+/** Longest chain of nested configurations followed before giving up. */
+const MAX_LOAD_DEPTH = 4;
+/** Ceiling on entities expanded by one top-level load read. */
+const MAX_LOAD_NODES = 256;
+/**
+ * Read one `IfcStructuralLoad` entity by expressId, resolving an
+ * `IfcStructuralLoadConfiguration` down through the loads its `Values` name.
+ *
+ * The `Values` edge is the only recursive one here, and it is
+ * exporter-controlled, so it is bounded three ways — none of which is
+ * redundant:
+ *
+ * - a **path-local** cycle set stops a configuration that reaches itself. It
+ *   has to be path-local rather than shared across siblings, because `Values`
+ *   is a LIST and may legitimately name one load twice; a shared set would
+ *   suppress the repeat as if it were a cycle and report one load where the
+ *   file applies two.
+ * - a **depth cap** bounds one chain's length, which the cycle set alone does
+ *   not for a long acyclic chain.
+ * - a **node budget** bounds total work. The first two still admit `k`
+ *   children each recursing `k` deep, which is O(k^depth) — an abort turned
+ *   into a hang, and a hang reports nothing.
+ *
+ * All three bounds, and every reference this reader cannot follow for the
+ * file's own reasons, keep the `Values` slot they gave up on: the slot becomes
+ * an entry with no `value` and a `dropped` reason naming which it was, so
+ * the station a `Locations` row names still belongs to the load the file put
+ * there. Only the three bounds set `truncated`, since only they mean the file
+ * holds more than this reader agreed to walk.
+ */
+export function extractStructuralLoad(extractor, store, expressId) {
+    return readLoad(extractor, store, expressId, new Set(), { remaining: MAX_LOAD_NODES }, 0).value;
+}
+function readLoad(extractor, store, expressId, path, budget, depth) {
+    if (depth > MAX_LOAD_DEPTH)
+        return { dropped: 'depth', truncated: true };
+    if (path.has(expressId))
+        return { dropped: 'cycle', truncated: true };
+    if (budget.remaining <= 0)
+        return { dropped: 'budget', truncated: true };
+    const ref = store.entityIndex.byId.get(expressId);
+    if (!ref)
+        return { dropped: 'unresolved', truncated: false };
+    const entity = extractor.extractEntity(ref);
+    if (!entity)
+        return { dropped: 'unreadable', truncated: false };
+    budget.remaining--;
+    const type = normalizeIfcTypeName(entity.type);
+    const attrs = entity.attributes || [];
+    if (type.toUpperCase() === 'IFCSTRUCTURALLOADCONFIGURATION') {
+        const locations = readLocations(attrs[LOAD_CONFIGURATION_ATTR.Locations]);
+        const entries = [];
+        let truncated = false;
+        const values = attrs[LOAD_CONFIGURATION_ATTR.Values];
+        if (Array.isArray(values)) {
+            // On this node's path only — removed again below so a sibling that
+            // names the same load still reads it.
+            path.add(expressId);
+            for (let i = 0; i < values.length; i++) {
+                const v = values[i];
+                const row = locations?.[i];
+                const location = row && row.length > 0 ? row : undefined; // empty = placeholder for an unusable row
+                const slot = typeof v === 'number' && Number.isInteger(v) && v > 0
+                    ? readLoad(extractor, store, v, path, budget, depth + 1)
+                    : { dropped: 'invalid-reference', truncated: false };
+                if (slot.truncated)
+                    truncated = true;
+                entries.push({ value: slot.value, dropped: slot.dropped, location });
+            }
+            path.delete(expressId);
+        }
+        return {
+            value: {
+                expressId,
+                type,
+                name: asString(attrs[LOAD_CONFIGURATION_ATTR.Name]),
+                components: {},
+                configuration: { entries, locations, truncated },
+            },
+            truncated,
+        };
+    }
+    return {
+        value: {
+            expressId,
+            type,
+            name: asString(attrs[0]),
+            components: readNumericComponents(type, attrs),
+        },
+        truncated: false,
+    };
+}
+/**
+ * Every attribute the registry names for `type`, except the inherited `Name`,
+ * that the record carries a finite number for.
+ */
+function readNumericComponents(type, attrs) {
+    const components = {};
+    const names = getAttributeNames(type);
+    for (let i = 0; i < names.length; i++) {
+        const attrName = names[i];
+        if (attrName === NAME_ATTR)
+            continue;
+        const n = asNumber(attrs[i]);
+        if (n !== undefined)
+            components[attrName] = n;
+    }
+    return components;
+}
+/** Read one `IfcBoundaryCondition` entity by expressId. */
+export function extractBoundaryCondition(extractor, store, expressId) {
+    const ref = store.entityIndex.byId.get(expressId);
+    if (!ref)
+        return undefined;
+    const entity = extractor.extractEntity(ref);
+    if (!entity)
+        return undefined;
+    const type = normalizeIfcTypeName(entity.type);
+    const attrs = entity.attributes || [];
+    const components = {};
+    const names = getAttributeNames(type);
+    for (let i = 0; i < names.length; i++) {
+        const attrName = names[i];
+        if (attrName === NAME_ATTR)
+            continue;
+        // The stiffness selects admit either a measure or IfcBoolean; read the
+        // boolean branch first, since a bare `.T.` would not survive the numeric
+        // test and a number is never a valid boolean token.
+        const b = asBoolean(attrs[i]);
+        if (b !== undefined) {
+            components[attrName] = b;
+            continue;
+        }
+        const n = asNumber(attrs[i]);
+        if (n !== undefined)
+            components[attrName] = n;
+    }
+    return { expressId, type, name: asString(attrs[0]), components };
+}
+//# sourceMappingURL=structural-load-extractor.js.map