@ifc-lite/create 2.7.0 → 2.8.0

package/dist/in-store/structural-action.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Anchored builders for `IfcStructuralPointAction` and
+ * `IfcStructuralLinearAction` — the two `IfcStructuralActivity` subtypes
+ * task S.1 asks for (#5167).
+ *
+ * Schema targeted: IFC4 (IFC4_ADD2_TC1.exp), verified against the generated
+ * IFC4 registry's `allAttributes`:
+ *   `IfcStructuralPointAction`: `GlobalId, OwnerHistory?, Name?,
+ *    Description?, ObjectType?, ObjectPlacement?, Representation?,
+ *    AppliedLoad, GlobalOrLocal, DestabilizingLoad?`
+ *   `IfcStructuralLinearAction`: the same seven inherited attributes plus
+ *    `ProjectedOrTrue?, PredefinedType` (from `IfcStructuralCurveAction`).
+ *   `AppliedLoad`/`GlobalOrLocal` are MANDATORY on `IfcStructuralActivity`
+ *   (no `?` in the registry) — both always written below, `GlobalOrLocal`
+ *   defaulting to `GLOBAL_COORDS`.
+ *   `IfcStructuralLinearAction`'s `ConstPredefinedType` WHERE rule forces
+ *   `PredefinedType = CONST` — this builder hardcodes it; there is no
+ *   parameter for it, because any other value is an EXPRESS violation.
+ *   Each action's `AppliedLoad` is narrowed to the load types the
+ *   `SuitableLoadType` WHERE rule accepts for that subtype:
+ *   `IfcStructuralLoadSingleForce` for the point action,
+ *   `IfcStructuralLoadLinearForce` for the linear action (both are also
+ *   `IfcStructuralLoadStatic` → `IfcStructuralLoadOrResult` → `IfcStructuralLoad`).
+ *
+ * REPRESENTATION OWNERSHIP: neither action gets an `ObjectPlacement` or
+ * `Representation` (both left `$`) — an action's location is implied by the
+ * structural item it is connected to via `IfcRelConnectsStructuralActivity`
+ * (`connectStructuralActivityToItemInStore` in `structural-relationships.ts`).
+ * The schema makes both optional specifically to allow this; giving an
+ * action independent geometry would create a second, easily-diverging
+ * source of location truth for no read-side benefit
+ * (`StructuralActivityInfo` carries no geometry field). The `AppliedLoad`
+ * entity (`IfcStructuralLoadSingleForce`/`IfcStructuralLoadLinearForce`) IS
+ * owned exclusively by its action — freshly created per call, never shared.
+ *
+ * Pure: no I/O, no parser access — operates entirely through the editor.
+ */
+import type { StoreEditor } from '@ifc-lite/mutations';
+import type { SpatialAnchor } from './anchor.js';
+export type StructuralGlobalOrLocal = 'GLOBAL_COORDS' | 'LOCAL_COORDS';
+export interface StructuralPointActionInStoreParams {
+    Name?: string;
+    Description?: string;
+    ObjectType?: string;
+    GlobalOrLocal?: StructuralGlobalOrLocal;
+    DestabilizingLoad?: boolean;
+    /** `IfcStructuralLoadSingleForce` components (all optional, at least one should be given). */
+    LoadName?: string;
+    ForceX?: number;
+    ForceY?: number;
+    ForceZ?: number;
+    MomentX?: number;
+    MomentY?: number;
+    MomentZ?: number;
+    /** Explicit GlobalId (22-char IFC GUID); generated when omitted. */
+    GlobalId?: string;
+}
+export interface StructuralPointActionBuildResult {
+    activityId: number;
+    loadId: number;
+}
+export declare function addStructuralPointActionToStore(editor: StoreEditor, anchor: Pick<SpatialAnchor, 'ownerHistoryId' | 'guidRandom' | 'schema'>, params: StructuralPointActionInStoreParams): StructuralPointActionBuildResult;
+export interface StructuralLinearActionInStoreParams {
+    Name?: string;
+    Description?: string;
+    ObjectType?: string;
+    GlobalOrLocal?: StructuralGlobalOrLocal;
+    DestabilizingLoad?: boolean;
+    /** `IfcStructuralLoadLinearForce` components (all optional, at least one should be given). */
+    LoadName?: string;
+    LinearForceX?: number;
+    LinearForceY?: number;
+    LinearForceZ?: number;
+    LinearMomentX?: number;
+    LinearMomentY?: number;
+    LinearMomentZ?: number;
+    /** Explicit GlobalId (22-char IFC GUID); generated when omitted. */
+    GlobalId?: string;
+}
+export interface StructuralLinearActionBuildResult {
+    activityId: number;
+    loadId: number;
+}
+export declare function addStructuralLinearActionToStore(editor: StoreEditor, anchor: Pick<SpatialAnchor, 'ownerHistoryId' | 'guidRandom' | 'schema'>, params: StructuralLinearActionInStoreParams): StructuralLinearActionBuildResult;
+//# sourceMappingURL=structural-action.d.ts.map

package/dist/in-store/structural-action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structural-action.d.ts","sourceRoot":"","sources":["../../src/in-store/structural-action.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD,MAAM,MAAM,uBAAuB,GAAG,eAAe,GAAG,cAAc,CAAC;AAQvE,MAAM,WAAW,kCAAkC;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,uBAAuB,CAAC;IACxC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gCAAgC;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAaD,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,gBAAgB,GAAG,YAAY,GAAG,QAAQ,CAAC,EACvE,MAAM,EAAE,kCAAkC,GACzC,gCAAgC,CAgClC;AAID,MAAM,WAAW,mCAAmC;IAClD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,uBAAuB,CAAC;IACxC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iCAAiC;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,gBAAgB,GAAG,YAAY,GAAG,QAAQ,CAAC,EACvE,MAAM,EAAE,mCAAmC,GAC1C,iCAAiC,CAkCnC"}

package/dist/in-store/structural-action.js

@@ -0,0 +1,83 @@
+/* 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 { ownerHistoryRef, productGuid } from './_emit-helpers.js';
+function boolAttr(v) {
+    return v === undefined ? null : v ? '.T.' : '.F.';
+}
+/**
+ * An action whose load carries no component at all is not a load: it
+ * serializes an `IfcStructuralLoad*` with every value `$` and reports success,
+ * so a caller that forgot to supply one gets a silently weightless model
+ * (#5167 review). Refusing here keeps the absence from reading as success.
+ */
+function assertLoadHasComponent(builder, components) {
+    if (components.some((value) => value !== undefined))
+        return;
+    throw new Error(`${builder}: supply at least one force or moment component; an action with no load component is not a load`);
+}
+export function addStructuralPointActionToStore(editor, anchor, params) {
+    if (anchor.schema === 'IFC2X3') {
+        throw new Error('addStructuralPointActionToStore: IFC2X3 has no IfcStructuralPointAction — target IFC4 or later');
+    }
+    assertLoadHasComponent('addStructuralPointActionToStore', [
+        params.ForceX, params.ForceY, params.ForceZ,
+        params.MomentX, params.MomentY, params.MomentZ,
+    ]);
+    const loadId = editor.addEntity('IfcStructuralLoadSingleForce', [
+        params.LoadName ?? null,
+        params.ForceX ?? null,
+        params.ForceY ?? null,
+        params.ForceZ ?? null,
+        params.MomentX ?? null,
+        params.MomentY ?? null,
+        params.MomentZ ?? null,
+    ]).expressId;
+    const activityId = editor.addEntity('IfcStructuralPointAction', [
+        productGuid(params, anchor.guidRandom),
+        ownerHistoryRef(anchor.ownerHistoryId),
+        params.Name ?? 'Point Action',
+        params.Description ?? null,
+        params.ObjectType ?? null,
+        null, // ObjectPlacement — see module doc
+        null, // Representation
+        `#${loadId}`,
+        `.${params.GlobalOrLocal ?? 'GLOBAL_COORDS'}.`,
+        boolAttr(params.DestabilizingLoad),
+    ]).expressId;
+    return { activityId, loadId };
+}
+export function addStructuralLinearActionToStore(editor, anchor, params) {
+    if (anchor.schema === 'IFC2X3') {
+        throw new Error('addStructuralLinearActionToStore: IFC2X3 has no IfcStructuralLinearAction — target IFC4 or later');
+    }
+    assertLoadHasComponent('addStructuralLinearActionToStore', [
+        params.LinearForceX, params.LinearForceY, params.LinearForceZ,
+        params.LinearMomentX, params.LinearMomentY, params.LinearMomentZ,
+    ]);
+    const loadId = editor.addEntity('IfcStructuralLoadLinearForce', [
+        params.LoadName ?? null,
+        params.LinearForceX ?? null,
+        params.LinearForceY ?? null,
+        params.LinearForceZ ?? null,
+        params.LinearMomentX ?? null,
+        params.LinearMomentY ?? null,
+        params.LinearMomentZ ?? null,
+    ]).expressId;
+    const activityId = editor.addEntity('IfcStructuralLinearAction', [
+        productGuid(params, anchor.guidRandom),
+        ownerHistoryRef(anchor.ownerHistoryId),
+        params.Name ?? 'Linear Action',
+        params.Description ?? null,
+        params.ObjectType ?? null,
+        null, // ObjectPlacement — see module doc
+        null, // Representation
+        `#${loadId}`,
+        `.${params.GlobalOrLocal ?? 'GLOBAL_COORDS'}.`,
+        boolAttr(params.DestabilizingLoad),
+        null, // ProjectedOrTrue
+        '.CONST.', // PredefinedType — EXPRESS ConstPredefinedType WHERE rule
+    ]).expressId;
+    return { activityId, loadId };
+}
+//# sourceMappingURL=structural-action.js.map

package/dist/in-store/structural-action.js.map

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

package/dist/in-store/structural-analysis-model.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Anchored builder for `IfcStructuralAnalysisModel` — the container that
+ * turns a bag of structural members/connections/loads into an analytical
+ * *model* (#5167 task S.1).
+ *
+ * `IfcStructuralAnalysisModel` is `IfcSystem` → `IfcGroup` → `IfcObject`,
+ * never `IfcProduct` — it has no `ObjectPlacement`/`Representation` at all
+ * (confirmed against the generated IFC4 registry's `allAttributes`), so
+ * unlike every other in-store builder in this directory it emits no
+ * placement or geometry sub-graph. Membership (which members/connections
+ * belong to the model) is NOT one of this entity's own attributes; it is
+ * established separately via `IfcRelAssignsToGroup`
+ * (`assignToStructuralGroupInStore` in `structural-relationships.ts`),
+ * matching what `extractStructuralOnDemand` in `@ifc-lite/parser` reads
+ * back (`StructuralAnalysisModelInfo.itemGlobalIds`).
+ *
+ * `LoadedBy` / `HasResults`, by contrast, ARE direct attributes on this
+ * entity (`SET OF IfcStructuralLoadGroup` / `SET OF IfcStructuralResultGroup`
+ * — no relationship indirection), so a load group's expressId is passed
+ * straight through here.
+ *
+ * Schema targeted: IFC4 (IFC4_ADD2_TC1.exp) — `IfcStructuralAnalysisModel`
+ * is unchanged from IFC4 to IFC4X3, so this builder is schema-neutral within
+ * ifc-lite's supported IFC4+ range. Not offered for IFC2X3, which has no
+ * structural-analysis schema module at all.
+ *
+ * Pure: no I/O, no parser access — operates entirely through the editor.
+ */
+import type { StoreEditor } from '@ifc-lite/mutations';
+import type { SpatialAnchor } from './anchor.js';
+export type StructuralAnalysisModelType = 'IN_PLANE_LOADING_2D' | 'OUT_PLANE_LOADING_2D' | 'LOADING_3D' | 'USERDEFINED' | 'NOTDEFINED';
+export interface StructuralAnalysisModelInStoreParams {
+    Name?: string;
+    Description?: string;
+    /** Required by the EXPRESS `HasObjectType` WHERE rule when `PredefinedType` is `'USERDEFINED'`. */
+    ObjectType?: string;
+    PredefinedType?: StructuralAnalysisModelType;
+    /** `IfcStructuralAnalysisModel.LoadedBy` — expressIds of existing `IfcStructuralLoadGroup`/`IfcStructuralLoadCase` entities. */
+    LoadGroupIds?: readonly number[];
+    /** `IfcStructuralAnalysisModel.HasResults` — expressIds of existing `IfcStructuralResultGroup` entities. */
+    ResultGroupIds?: readonly number[];
+    /** Explicit GlobalId (22-char IFC GUID); generated when omitted. */
+    GlobalId?: string;
+}
+export interface StructuralAnalysisModelBuildResult {
+    analysisModelId: number;
+}
+export declare function addStructuralAnalysisModelToStore(editor: StoreEditor, anchor: Pick<SpatialAnchor, 'ownerHistoryId' | 'guidRandom' | 'schema'>, params: StructuralAnalysisModelInStoreParams): StructuralAnalysisModelBuildResult;
+//# sourceMappingURL=structural-analysis-model.d.ts.map

package/dist/in-store/structural-analysis-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structural-analysis-model.d.ts","sourceRoot":"","sources":["../../src/in-store/structural-analysis-model.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD,MAAM,MAAM,2BAA2B,GACnC,qBAAqB,GAAG,sBAAsB,GAAG,YAAY,GAC7D,aAAa,GAAG,YAAY,CAAC;AAEjC,MAAM,WAAW,oCAAoC;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mGAAmG;IACnG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,2BAA2B,CAAC;IAC7C,gIAAgI;IAChI,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,4GAA4G;IAC5G,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kCAAkC;IACjD,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,gBAAgB,GAAG,YAAY,GAAG,QAAQ,CAAC,EACvE,MAAM,EAAE,oCAAoC,GAC3C,kCAAkC,CA0BpC"}

package/dist/in-store/structural-analysis-model.js

@@ -0,0 +1,29 @@
+/* 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 { ownerHistoryRef, productGuid } from './_emit-helpers.js';
+export function addStructuralAnalysisModelToStore(editor, anchor, params) {
+    if (anchor.schema === 'IFC2X3') {
+        throw new Error('addStructuralAnalysisModelToStore: IFC2X3 has no IfcStructuralAnalysisModel — target IFC4 or later');
+    }
+    const predefinedType = params.PredefinedType ?? 'NOTDEFINED';
+    if (predefinedType === 'USERDEFINED' && !params.ObjectType) {
+        throw new Error('addStructuralAnalysisModelToStore: ObjectType is required when PredefinedType is USERDEFINED');
+    }
+    const loadGroupIds = params.LoadGroupIds ?? [];
+    const resultGroupIds = params.ResultGroupIds ?? [];
+    const analysisModelId = editor.addEntity('IfcStructuralAnalysisModel', [
+        productGuid(params, anchor.guidRandom),
+        ownerHistoryRef(anchor.ownerHistoryId),
+        params.Name ?? 'Structural Analysis Model',
+        params.Description ?? null,
+        params.ObjectType ?? null,
+        `.${predefinedType}.`,
+        null, // OrientationOf2DPlane
+        loadGroupIds.length > 0 ? loadGroupIds.map((id) => `#${id}`) : null, // LoadedBy
+        resultGroupIds.length > 0 ? resultGroupIds.map((id) => `#${id}`) : null, // HasResults
+        null, // SharedPlacement
+    ]).expressId;
+    return { analysisModelId };
+}
+//# sourceMappingURL=structural-analysis-model.js.map

package/dist/in-store/structural-analysis-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structural-analysis-model.js","sourceRoot":"","sources":["../../src/in-store/structural-analysis-model.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAiC/D,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAwBlE,MAAM,UAAU,iCAAiC,CAC/C,MAAmB,EACnB,MAAuE,EACvE,MAA4C;IAE5C,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,oGAAoG,CAAC,CAAC;IACxH,CAAC;IACD,MAAM,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,YAAY,CAAC;IAC7D,IAAI,cAAc,KAAK,aAAa,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,8FAA8F,CAAC,CAAC;IAClH,CAAC;IAED,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC;IAC/C,MAAM,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,EAAE,CAAC;IAEnD,MAAM,eAAe,GAAG,MAAM,CAAC,SAAS,CAAC,4BAA4B,EAAE;QACrE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC;QACtC,eAAe,CAAC,MAAM,CAAC,cAAc,CAAC;QACtC,MAAM,CAAC,IAAI,IAAI,2BAA2B;QAC1C,MAAM,CAAC,WAAW,IAAI,IAAI;QAC1B,MAAM,CAAC,UAAU,IAAI,IAAI;QACzB,IAAI,cAAc,GAAG;QACrB,IAAI,EAAE,uBAAuB;QAC7B,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,WAAW;QAChF,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,aAAa;QACtF,IAAI,EAAE,kBAAkB;KACzB,CAAC,CAAC,SAAS,CAAC;IAEb,OAAO,EAAE,eAAe,EAAE,CAAC;AAC7B,CAAC"}

package/dist/in-store/structural-curve-member.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Anchored builder for `IfcStructuralCurveMember` — a straight analytical
+ * line member (beam/column/brace idealisation) between `Start` and `End`
+ * (#5167 task S.1).
+ *
+ * Schema targeted: IFC4 (IFC4_ADD2_TC1.exp), verified against the generated
+ * IFC4 registry's `allAttributes` for `IfcStructuralCurveMember`:
+ *   `GlobalId, OwnerHistory?, Name?, Description?, ObjectType?,
+ *    ObjectPlacement?, Representation?, PredefinedType, Axis`
+ * `PredefinedType` (`IfcStructuralCurveMemberTypeEnum`) and `Axis`
+ * (`IfcDirection`, mandatory — NOT an inline list) are both own attributes
+ * of this entity, not inherited.
+ *
+ * REPRESENTATION OWNERSHIP (the part the task brief calls out explicitly):
+ *
+ *   `ObjectPlacement`: an `IfcLocalPlacement` chained from the storey's
+ *   placement, origin at `Start`, local Z = member axis — same shape as
+ *   `addBeamToStore`/`addMemberToStore`'s physical-element placements.
+ *   OWNED exclusively by this member: nothing else in the model ever
+ *   references it, so there is no reference-counting question, only a
+ *   lifetime one (see removal note below).
+ *
+ *   `Representation`: an `IfcTopologyRepresentation` (`RepresentationType:
+ *   'Edge'`, verified against the EXPRESS `IfcTopologyRepresentationTypes`
+ *   WHERE function, which accepts `'Edge'` for a `SET` of `IfcEdge` items)
+ *   holding one `IfcEdge` between two `IfcVertexPoint`s at the placement-
+ *   local origin and `(0, 0, length)`. This is the buildingSMART-documented
+ *   shape for an analytical member's line geometry — lighter than a solid,
+ *   and the read side (`extractStructuralOnDemand`) does not need it at all
+ *   (member geometry isn't part of `StructuralMemberInfo`), so it is
+ *   authored for downstream tools/viewers that walk `Representation`, not
+ *   for this package's own round trip. Every entity in the chain
+ *   (2 points, 2 vertices, 1 edge, the topology rep, the product shape) is
+ *   OWNED exclusively by this member — freshly created per call, never
+ *   deduplicated or shared across members, so — like the placement — a
+ *   member's owned sub-graph is a closed set with no external references
+ *   to reason about.
+ *
+ *   What is NOT owned by the member: `anchor.axisContextId` (the model's
+ *   shared `IfcGeometricRepresentationSubContext`, an existing entity this
+ *   builder only references) and `anchor.storeyPlacementId` (ditto).
+ *
+ *   Removal: `bim.store.removeEntity` tombstones only the product row (the
+ *   known #592-era gap column.ts's header comment references), so removing
+ *   a member built here would currently orphan its placement chain AND its
+ *   topology sub-graph — the same defect, not a new one, and NOT fixed by
+ *   this builder. What this builder does instead: because nothing is
+ *   shared, EVERY id in `StructuralCurveMemberBuildResult` is safe to
+ *   delete unconditionally once the member itself is gone (no other entity
+ *   in the model can be pointing at any of them) — so a future
+ *   `removeStructuralEntityInStore` (mirroring `cost-removal.ts`'s pattern)
+ *   can walk this result's ids directly with no reference-discovery pass.
+ *   That follow-up function does not exist yet; this is deliberately left
+ *   unresolved rather than silently ignored (see the task's PR description
+ *   for the explicit call-out).
+ *
+ * Pure: no I/O, no parser access — operates entirely through the editor.
+ */
+import type { StoreEditor } from '@ifc-lite/mutations';
+import { type SpatialAnchor } from './anchor.js';
+export type StructuralCurveMemberType = 'RIGID_JOINED_MEMBER' | 'PIN_JOINED_MEMBER' | 'CABLE' | 'TENSION_MEMBER' | 'COMPRESSION_MEMBER' | 'USERDEFINED' | 'NOTDEFINED';
+export interface StructuralCurveMemberInStoreParams {
+    Start: [number, number, number];
+    End: [number, number, number];
+    PredefinedType?: StructuralCurveMemberType;
+    Name?: string;
+    Description?: string;
+    /** Required by the EXPRESS `HasObjectType` WHERE rule when `PredefinedType` is `'USERDEFINED'`. */
+    ObjectType?: string;
+    /** Explicit GlobalId (22-char IFC GUID); generated when omitted. */
+    GlobalId?: string;
+}
+/** Every expressId this builder emits — the member's full owned sub-graph (see removal note above). */
+export interface StructuralCurveMemberBuildResult {
+    memberId: number;
+    placementId: number;
+    axisDirectionId: number;
+    /** The `IfcCartesianPoint` each `IfcVertexPoint` below is built on. Exposed
+     *  because they are owned too: a cascade delete driven by this result would
+     *  otherwise orphan both points (#5167 review). */
+    point1Id: number;
+    point2Id: number;
+    vertex1Id: number;
+    vertex2Id: number;
+    edgeId: number;
+    topologyRepId: number;
+    productShapeId: number;
+}
+export declare function addStructuralCurveMemberToStore(editor: StoreEditor, anchor: SpatialAnchor, params: StructuralCurveMemberInStoreParams): StructuralCurveMemberBuildResult;
+//# sourceMappingURL=structural-curve-member.d.ts.map

package/dist/in-store/structural-curve-member.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structural-curve-member.d.ts","sourceRoot":"","sources":["../../src/in-store/structural-curve-member.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGvD,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjE,MAAM,MAAM,yBAAyB,GACjC,qBAAqB,GAAG,mBAAmB,GAAG,OAAO,GAAG,gBAAgB,GACxE,oBAAoB,GAAG,aAAa,GAAG,YAAY,CAAC;AAExD,MAAM,WAAW,kCAAkC;IACjD,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,cAAc,CAAC,EAAE,yBAAyB,CAAC;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mGAAmG;IACnG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,uGAAuG;AACvG,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB;;uDAEmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB;AAOD,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,kCAAkC,GACzC,gCAAgC,CA6ElC"}

package/dist/in-store/structural-curve-member.js

@@ -0,0 +1,83 @@
+/* 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 { vecCross, vecNorm, assertFinitePoint3 } from '../ifc-creator-math.js';
+import { toNativePoint3 } from './anchor.js';
+import { emitLocalPlacement, ownerHistoryRef, productGuid } from './_emit-helpers.js';
+function computeRefDirection(axis) {
+    const up = Math.abs(axis[2]) < 0.9 ? [0, 0, 1] : [1, 0, 0];
+    return vecNorm(vecCross(up, axis));
+}
+export function addStructuralCurveMemberToStore(editor, anchor, params) {
+    if ((anchor.schema ?? 'IFC4') === 'IFC2X3') {
+        throw new Error('addStructuralCurveMemberToStore: IFC2X3 has no IfcStructuralCurveMember — target IFC4 or later');
+    }
+    const predefinedType = params.PredefinedType ?? 'NOTDEFINED';
+    if (predefinedType === 'USERDEFINED' && !params.ObjectType) {
+        throw new Error('addStructuralCurveMemberToStore: ObjectType is required when PredefinedType is USERDEFINED');
+    }
+    assertFinitePoint3({ Start: params.Start, End: params.End }, 'addStructuralCurveMemberToStore');
+    params = {
+        ...params,
+        Start: toNativePoint3(anchor, params.Start),
+        End: toNativePoint3(anchor, params.End),
+    };
+    const dx = params.End[0] - params.Start[0];
+    const dy = params.End[1] - params.Start[1];
+    const dz = params.End[2] - params.Start[2];
+    const length = Math.sqrt(dx * dx + dy * dy + dz * dz);
+    if (length <= 0) {
+        throw new Error('addStructuralCurveMemberToStore: Start and End must be distinct points');
+    }
+    const dir = vecNorm([dx, dy, dz]);
+    const refDir = computeRefDirection(dir);
+    // Placement at Start, local Z along the member axis (mirrors addBeamToStore).
+    const placementId = emitLocalPlacement(editor, anchor.storeyPlacementId, params.Start, dir, refDir);
+    // `IfcStructuralCurveMember.Axis` is expressed in the placement's LOCAL
+    // frame, and the placement's own local Z is already the member direction
+    // (set above), so the member's local axis is always world +Z here.
+    const axisDirectionId = editor.addEntity('IfcDirection', [[0, 0, 1]]).expressId;
+    // Topology geometry: an edge from the local origin to (0, 0, length) —
+    // `length` is already in the file's native unit (Start/End were converted
+    // above) — wholly owned by this member (see module doc).
+    const pt1Id = editor.addEntity('IfcCartesianPoint', [[0, 0, 0]]).expressId;
+    const pt2Id = editor.addEntity('IfcCartesianPoint', [[0, 0, length]]).expressId;
+    const vertex1Id = editor.addEntity('IfcVertexPoint', [`#${pt1Id}`]).expressId;
+    const vertex2Id = editor.addEntity('IfcVertexPoint', [`#${pt2Id}`]).expressId;
+    const edgeId = editor.addEntity('IfcEdge', [`#${vertex1Id}`, `#${vertex2Id}`]).expressId;
+    const topologyRepId = editor.addEntity('IfcTopologyRepresentation', [
+        `#${anchor.axisContextId}`,
+        'Axis',
+        'Edge',
+        [`#${edgeId}`],
+    ]).expressId;
+    const productShapeId = editor.addEntity('IfcProductDefinitionShape', [
+        null,
+        null,
+        [`#${topologyRepId}`],
+    ]).expressId;
+    const memberId = editor.addEntity('IfcStructuralCurveMember', [
+        productGuid(params, anchor.guidRandom),
+        ownerHistoryRef(anchor.ownerHistoryId),
+        params.Name ?? 'Structural Curve Member',
+        params.Description ?? null,
+        params.ObjectType ?? null,
+        `#${placementId}`,
+        `#${productShapeId}`,
+        `.${predefinedType}.`,
+        `#${axisDirectionId}`,
+    ]).expressId;
+    return {
+        memberId,
+        placementId,
+        axisDirectionId,
+        point1Id: pt1Id,
+        point2Id: pt2Id,
+        vertex1Id,
+        vertex2Id,
+        edgeId,
+        topologyRepId,
+        productShapeId,
+    };
+}
+//# sourceMappingURL=structural-curve-member.js.map

package/dist/in-store/structural-curve-member.js.map

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

package/dist/in-store/structural-load-group.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Anchored builder for `IfcStructuralLoadGroup` / `IfcStructuralLoadCase`
+ * (#5167 task S.1).
+ *
+ * `IfcStructuralLoadGroup` is `IfcGroup` → `IfcObject`, never `IfcProduct` —
+ * no `ObjectPlacement`/`Representation` — so, like
+ * `structural-analysis-model.ts`, this builder emits no geometry.
+ *
+ * Schema targeted: IFC4 (IFC4_ADD2_TC1.exp), verified against the generated
+ * IFC4 registry's `allAttributes`:
+ *   `IfcStructuralLoadGroup`: `GlobalId, OwnerHistory?, Name?, Description?,
+ *    ObjectType?, PredefinedType, ActionType, ActionSource, Coefficient?,
+ *    Purpose?`
+ *   `IfcStructuralLoadCase` adds exactly one attribute after its parent's:
+ *    `SelfWeightCoefficients?` (a `LIST [3:3] OF IfcRatioMeasure`).
+ *   The EXPRESS `IsLoadCasePredefinedType` WHERE rule on
+ *   `IfcStructuralLoadCase` requires `PredefinedType = LOAD_CASE`
+ *   whenever `SelfWeightCoefficients` is present — enforced below rather
+ *   than left for export/import to discover as a malformed file.
+ *
+ * A load group's members (the activities assigned to it) are established
+ * separately via `IfcRelAssignsToGroup`
+ * (`assignToStructuralGroupInStore` in `structural-relationships.ts`) —
+ * this mirrors `extractStructuralOnDemand`'s read side
+ * (`StructuralLoadGroupInfo.activityGlobalIds`).
+ *
+ * Pure: no I/O, no parser access — operates entirely through the editor.
+ */
+import type { StoreEditor } from '@ifc-lite/mutations';
+import type { SpatialAnchor } from './anchor.js';
+export type StructuralLoadGroupType = 'LOAD_GROUP' | 'LOAD_CASE' | 'LOAD_COMBINATION' | 'USERDEFINED' | 'NOTDEFINED';
+export type StructuralActionType = 'PERMANENT_G' | 'VARIABLE_Q' | 'EXTRAORDINARY_A' | 'USERDEFINED' | 'NOTDEFINED';
+export type StructuralActionSourceType = 'DEAD_LOAD_G' | 'COMPLETION_G1' | 'LIVE_LOAD_Q' | 'SNOW_S' | 'WIND_W' | 'PRESTRESSING_P' | 'SETTLEMENT_U' | 'TEMPERATURE_T' | 'EARTHQUAKE_E' | 'FIRE' | 'IMPULSE' | 'IMPACT' | 'TRANSPORT' | 'ERECTION' | 'PROPPING' | 'SYSTEM_IMPERFECTION' | 'SHRINKAGE' | 'CREEP' | 'LACK_OF_FIT' | 'BUOYANCY' | 'ICE' | 'CURRENT' | 'WAVE' | 'RAIN' | 'BRAKES' | 'USERDEFINED' | 'NOTDEFINED';
+export interface StructuralLoadGroupInStoreParams {
+    Name?: string;
+    Description?: string;
+    /** Required by the combined `HasObjectType` WHERE rule when `PredefinedType`/`ActionType`/`ActionSource` is `'USERDEFINED'`. */
+    ObjectType?: string;
+    PredefinedType?: StructuralLoadGroupType;
+    ActionType: StructuralActionType;
+    ActionSource: StructuralActionSourceType;
+    Coefficient?: number;
+    Purpose?: string;
+    /**
+     * Exactly 3 ratios `[x, y, z]`. Presence emits `IfcStructuralLoadCase`
+     * instead of `IfcStructuralLoadGroup` and forces `PredefinedType` to
+     * `'LOAD_CASE'` (see the EXPRESS WHERE rule in the module doc) — passing
+     * both this AND a conflicting `PredefinedType` is refused rather than
+     * silently overridden.
+     */
+    SelfWeightCoefficients?: [number, number, number];
+    /** Explicit GlobalId (22-char IFC GUID); generated when omitted. */
+    GlobalId?: string;
+}
+export interface StructuralLoadGroupBuildResult {
+    loadGroupId: number;
+    /** `'IfcStructuralLoadCase'` when `SelfWeightCoefficients` was supplied, else `'IfcStructuralLoadGroup'`. */
+    type: 'IfcStructuralLoadGroup' | 'IfcStructuralLoadCase';
+}
+export declare function addStructuralLoadGroupToStore(editor: StoreEditor, anchor: Pick<SpatialAnchor, 'ownerHistoryId' | 'guidRandom' | 'schema'>, params: StructuralLoadGroupInStoreParams): StructuralLoadGroupBuildResult;
+//# sourceMappingURL=structural-load-group.d.ts.map

package/dist/in-store/structural-load-group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structural-load-group.d.ts","sourceRoot":"","sources":["../../src/in-store/structural-load-group.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD,MAAM,MAAM,uBAAuB,GAAG,YAAY,GAAG,WAAW,GAAG,kBAAkB,GAAG,aAAa,GAAG,YAAY,CAAC;AACrH,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG,YAAY,GAAG,iBAAiB,GAAG,aAAa,GAAG,YAAY,CAAC;AACnH,MAAM,MAAM,0BAA0B,GAClC,aAAa,GAAG,eAAe,GAAG,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,gBAAgB,GACxF,cAAc,GAAG,eAAe,GAAG,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,GAC/F,UAAU,GAAG,UAAU,GAAG,qBAAqB,GAAG,WAAW,GAAG,OAAO,GAAG,aAAa,GAAG,UAAU,GACpG,KAAK,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,aAAa,GAAG,YAAY,CAAC;AAElF,MAAM,WAAW,gCAAgC;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gIAAgI;IAChI,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,uBAAuB,CAAC;IACzC,UAAU,EAAE,oBAAoB,CAAC;IACjC,YAAY,EAAE,0BAA0B,CAAC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,sBAAsB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAClD,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,8BAA8B;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,6GAA6G;IAC7G,IAAI,EAAE,wBAAwB,GAAG,uBAAuB,CAAC;CAC1D;AAED,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,gBAAgB,GAAG,YAAY,GAAG,QAAQ,CAAC,EACvE,MAAM,EAAE,gCAAgC,GACvC,8BAA8B,CAyChC"}

package/dist/in-store/structural-load-group.js

@@ -0,0 +1,38 @@
+/* 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 { ownerHistoryRef, productGuid } from './_emit-helpers.js';
+export function addStructuralLoadGroupToStore(editor, anchor, params) {
+    if (anchor.schema === 'IFC2X3') {
+        throw new Error('addStructuralLoadGroupToStore: IFC2X3 has no IfcStructuralLoadGroup — target IFC4 or later');
+    }
+    const isLoadCase = params.SelfWeightCoefficients !== undefined;
+    if (isLoadCase && params.PredefinedType !== undefined && params.PredefinedType !== 'LOAD_CASE') {
+        throw new Error(`addStructuralLoadGroupToStore: SelfWeightCoefficients requires PredefinedType 'LOAD_CASE' `
+            + `(EXPRESS IsLoadCasePredefinedType), got '${params.PredefinedType}'`);
+    }
+    const predefinedType = params.PredefinedType ?? (isLoadCase ? 'LOAD_CASE' : 'LOAD_GROUP');
+    if ((predefinedType === 'USERDEFINED' || params.ActionType === 'USERDEFINED' || params.ActionSource === 'USERDEFINED')
+        && !params.ObjectType) {
+        throw new Error('addStructuralLoadGroupToStore: ObjectType is required when PredefinedType, ActionType, or ActionSource is USERDEFINED');
+    }
+    const baseAttrs = [
+        productGuid(params, anchor.guidRandom),
+        ownerHistoryRef(anchor.ownerHistoryId),
+        params.Name ?? (isLoadCase ? 'Load Case' : 'Load Group'),
+        params.Description ?? null,
+        params.ObjectType ?? null,
+        `.${predefinedType}.`,
+        `.${params.ActionType}.`,
+        `.${params.ActionSource}.`,
+        params.Coefficient ?? null,
+        params.Purpose ?? null,
+    ];
+    const type = isLoadCase ? 'IfcStructuralLoadCase' : 'IfcStructuralLoadGroup';
+    const attrs = isLoadCase
+        ? [...baseAttrs, [...params.SelfWeightCoefficients]]
+        : baseAttrs;
+    const loadGroupId = editor.addEntity(type, attrs).expressId;
+    return { loadGroupId, type };
+}
+//# sourceMappingURL=structural-load-group.js.map

package/dist/in-store/structural-load-group.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structural-load-group.js","sourceRoot":"","sources":["../../src/in-store/structural-load-group.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAiC/D,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAsClE,MAAM,UAAU,6BAA6B,CAC3C,MAAmB,EACnB,MAAuE,EACvE,MAAwC;IAExC,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,4FAA4F,CAAC,CAAC;IAChH,CAAC;IACD,MAAM,UAAU,GAAG,MAAM,CAAC,sBAAsB,KAAK,SAAS,CAAC;IAC/D,IAAI,UAAU,IAAI,MAAM,CAAC,cAAc,KAAK,SAAS,IAAI,MAAM,CAAC,cAAc,KAAK,WAAW,EAAE,CAAC;QAC/F,MAAM,IAAI,KAAK,CACb,4FAA4F;cAC1F,4CAA4C,MAAM,CAAC,cAAc,GAAG,CACvE,CAAC;IACJ,CAAC;IACD,MAAM,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;IAC1F,IACE,CAAC,cAAc,KAAK,aAAa,IAAI,MAAM,CAAC,UAAU,KAAK,aAAa,IAAI,MAAM,CAAC,YAAY,KAAK,aAAa,CAAC;WAC/G,CAAC,MAAM,CAAC,UAAU,EACrB,CAAC;QACD,MAAM,IAAI,KAAK,CACb,uHAAuH,CACxH,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAc;QAC3B,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC;QACtC,eAAe,CAAC,MAAM,CAAC,cAAc,CAAC;QACtC,MAAM,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC;QACxD,MAAM,CAAC,WAAW,IAAI,IAAI;QAC1B,MAAM,CAAC,UAAU,IAAI,IAAI;QACzB,IAAI,cAAc,GAAG;QACrB,IAAI,MAAM,CAAC,UAAU,GAAG;QACxB,IAAI,MAAM,CAAC,YAAY,GAAG;QAC1B,MAAM,CAAC,WAAW,IAAI,IAAI;QAC1B,MAAM,CAAC,OAAO,IAAI,IAAI;KACvB,CAAC;IAEF,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,wBAAwB,CAAC;IAC7E,MAAM,KAAK,GAAG,UAAU;QACtB,CAAC,CAAC,CAAC,GAAG,SAAS,EAAE,CAAC,GAAI,MAAM,CAAC,sBAAmD,CAAC,CAAC;QAClF,CAAC,CAAC,SAAS,CAAC;IAEd,MAAM,WAAW,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,KAAgD,CAAC,CAAC,SAAS,CAAC;IACvG,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;AAC/B,CAAC"}