@ifc-lite/create 3.2.0 → 4.0.0

package/dist/in-store/profile.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Shared parametric-profile factory for the in-store builders (#6232).
+ *
+ * One discriminated union covers the cross-sections a beam, column or member
+ * can carry: the default rectangle plus the steel/hollow sections IfcCreator
+ * offers (`addIShapeProfile`, `addLShapeProfile`, ...). Every profile is
+ * centred on its own origin, the IFC convention for parameterised profiles,
+ * so an extrusion along the element axis runs through the section's centre.
+ *
+ * Attributes are laid out from the target schema's registry by name
+ * (`schemaAttributes`, decision D2): IFC2X3 and IFC4/IFC4X3 differ in the
+ * optional tail of several of these classes (IFC2X3 has `CentreOfGravityIn*`,
+ * IFC4 has `FlangeEdgeRadius`, `FlangeSlope`, ...), and IFC5 is refused.
+ *
+ * Params are metres; dimensions are converted to the file's native length
+ * unit on emit, like every other in-store builder.
+ */
+import type { StoreEditor } from '@ifc-lite/mutations';
+import { type SpatialAnchor } from './anchor.js';
+import { schemaRegistry } from './schema-attributes.js';
+/** Centred rectangle, XDim along profile X, YDim along profile Y. */
+export interface RectangleSection {
+    Type: 'Rectangle';
+    XDim: number;
+    YDim: number;
+}
+/** I / H section (`IfcIShapeProfileDef`). Depth along profile Y. */
+export interface ISection {
+    Type: 'I';
+    OverallWidth: number;
+    OverallDepth: number;
+    WebThickness: number;
+    FlangeThickness: number;
+    FilletRadius?: number;
+}
+/** Angle (`IfcLShapeProfileDef`). Depth along profile Y, Width along X. */
+export interface LSection {
+    Type: 'L';
+    Depth: number;
+    Width: number;
+    Thickness: number;
+    FilletRadius?: number;
+}
+/** Tee (`IfcTShapeProfileDef`). Flange at +Y. */
+export interface TSection {
+    Type: 'T';
+    Depth: number;
+    FlangeWidth: number;
+    WebThickness: number;
+    FlangeThickness: number;
+    FilletRadius?: number;
+}
+/** Channel (`IfcUShapeProfileDef`). Web at -X, flanges towards +X. */
+export interface USection {
+    Type: 'U';
+    Depth: number;
+    FlangeWidth: number;
+    WebThickness: number;
+    FlangeThickness: number;
+    FilletRadius?: number;
+}
+/** Cold-formed lipped channel (`IfcCShapeProfileDef`). */
+export interface CSection {
+    Type: 'C';
+    Depth: number;
+    Width: number;
+    WallThickness: number;
+    Girth: number;
+    InternalFilletRadius?: number;
+}
+/** Solid circle (`IfcCircleProfileDef`). */
+export interface CircleSection {
+    Type: 'Circle';
+    Radius: number;
+}
+/** Rectangular hollow section / tube (`IfcRectangleHollowProfileDef`). */
+export interface RectangleHollowSection {
+    Type: 'RectangleHollow';
+    XDim: number;
+    YDim: number;
+    WallThickness: number;
+    InnerFilletRadius?: number;
+    OuterFilletRadius?: number;
+}
+/** Circular hollow section / pipe (`IfcCircleHollowProfileDef`). */
+export interface CircleHollowSection {
+    Type: 'CircleHollow';
+    Radius: number;
+    WallThickness: number;
+}
+/** A parameterised cross-section for a beam, column or member. Metres. */
+export type ProfileSection = RectangleSection | ISection | LSection | TSection | USection | CSection | CircleSection | RectangleHollowSection | CircleHollowSection;
+export type ProfileSectionType = ProfileSection['Type'];
+/** The IFC profile class a section is written as. */
+export declare function profileSectionIfcClass(section: ProfileSection): string;
+/**
+ * Refuse a section the mesher could not build or would build inside out:
+ * non-positive dimensions, and walls, webs or flanges that do not fit in the
+ * outer size. Throws with `op` in the message.
+ */
+export declare function validateProfileSection(section: ProfileSection, op: string): void;
+/**
+ * The section's axis-aligned extent in its own frame (metres):
+ * `[along profile X, along profile Y]`. Profiles are centred, so the section
+ * spans half of each on either side of the element axis. For callers that
+ * need the outer size without meshing (fallback meshes, snapping, HUDs).
+ */
+export declare function profileSectionExtent(section: ProfileSection): [number, number];
+/**
+ * Everything `emitProfileSection` would refuse, checked without emitting, so a
+ * builder can validate its whole input before it writes its first entity.
+ */
+export declare function assertProfileSectionAuthorable(anchor: Pick<SpatialAnchor, 'schema'>, section: ProfileSection, op: string): ReturnType<typeof schemaRegistry>;
+/**
+ * Emit a centred parameterised profile (`IfcAxis2Placement2D` at the origin +
+ * the profile class for `section.Type`) and return the profile's expressId.
+ * Validates the section, converts it to native units, and lays the attributes
+ * out for `anchor.schema` (IFC5 refused).
+ */
+export declare function emitProfileSection(editor: StoreEditor, anchor: Pick<SpatialAnchor, 'schema' | 'lengthUnitScale'>, section: ProfileSection, op?: string): number;
+/** A linear element's validated section: the default rectangle or a `Profile`. */
+export type LinearSection = {
+    Profile: ProfileSection;
+    Width?: undefined;
+    Height?: undefined;
+} | {
+    Width: number;
+    Height: number;
+    Profile?: undefined;
+};
+/**
+ * Validate a beam's or member's section params: exactly one of the rectangle
+ * (`Width` + `Height`, finite and positive) or a `Profile`, checked before
+ * anything is emitted.
+ */
+export declare function linearSection(anchor: Pick<SpatialAnchor, 'schema'>, params: {
+    Width?: number;
+    Height?: number;
+    Profile?: ProfileSection;
+}, op: string): LinearSection;
+//# sourceMappingURL=profile.d.ts.map

package/dist/in-store/profile.d.ts.map

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

package/dist/in-store/profile.js

@@ -0,0 +1,174 @@
+/* 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 { assertPositiveFinite } from './_emit-helpers.js';
+import { toNativeLength } from './anchor.js';
+import { schemaAttributes, schemaRegistry } from './schema-attributes.js';
+const IFC_CLASS = {
+    Rectangle: 'IfcRectangleProfileDef',
+    I: 'IfcIShapeProfileDef',
+    L: 'IfcLShapeProfileDef',
+    T: 'IfcTShapeProfileDef',
+    U: 'IfcUShapeProfileDef',
+    C: 'IfcCShapeProfileDef',
+    Circle: 'IfcCircleProfileDef',
+    RectangleHollow: 'IfcRectangleHollowProfileDef',
+    CircleHollow: 'IfcCircleHollowProfileDef',
+};
+/** The IFC profile class a section is written as. */
+export function profileSectionIfcClass(section) {
+    const cls = IFC_CLASS[section?.Type];
+    if (!cls)
+        throw new Error(`profile: unknown section Type ${String(section?.Type)}`);
+    return cls;
+}
+/** The section's dimension fields (everything but `Type`), keyed by IFC attribute name. */
+function dimensions(section) {
+    const { Type: _type, ...dims } = section;
+    return dims;
+}
+/** Mandatory dimensions per section: finite and > 0. Optional ones (fillets): finite and >= 0 when set. */
+const REQUIRED = {
+    Rectangle: ['XDim', 'YDim'],
+    I: ['OverallWidth', 'OverallDepth', 'WebThickness', 'FlangeThickness'],
+    L: ['Depth', 'Width', 'Thickness'],
+    T: ['Depth', 'FlangeWidth', 'WebThickness', 'FlangeThickness'],
+    U: ['Depth', 'FlangeWidth', 'WebThickness', 'FlangeThickness'],
+    C: ['Depth', 'Width', 'WallThickness', 'Girth'],
+    Circle: ['Radius'],
+    RectangleHollow: ['XDim', 'YDim', 'WallThickness'],
+    CircleHollow: ['Radius', 'WallThickness'],
+};
+/**
+ * Refuse a section the mesher could not build or would build inside out:
+ * non-positive dimensions, and walls, webs or flanges that do not fit in the
+ * outer size. Throws with `op` in the message.
+ */
+export function validateProfileSection(section, op) {
+    const cls = profileSectionIfcClass(section);
+    const dims = dimensions(section);
+    const required = REQUIRED[section.Type];
+    for (const [name, value] of Object.entries(dims)) {
+        if (value === undefined)
+            continue;
+        if (!required.includes(name) && !isNonNegativeFinite(value)) {
+            throw new Error(`${op}: ${cls}.${name} must be a finite number >= 0`);
+        }
+    }
+    for (const name of required) {
+        const value = dims[name];
+        if (typeof value !== 'number' || !Number.isFinite(value) || value <= 0) {
+            throw new Error(`${op}: ${cls}.${name} must be a finite positive number`);
+        }
+    }
+    const fits = (ok, what) => {
+        if (!ok)
+            throw new Error(`${op}: ${cls} ${what}`);
+    };
+    switch (section.Type) {
+        case 'I':
+            fits(section.WebThickness < section.OverallWidth, 'WebThickness must be less than OverallWidth');
+            fits(2 * section.FlangeThickness < section.OverallDepth, 'two FlangeThicknesses must be less than OverallDepth');
+            break;
+        case 'L':
+            fits(section.Thickness < section.Depth && section.Thickness < section.Width, 'Thickness must be less than Depth and Width');
+            break;
+        case 'T':
+            fits(section.WebThickness < section.FlangeWidth, 'WebThickness must be less than FlangeWidth');
+            fits(section.FlangeThickness < section.Depth, 'FlangeThickness must be less than Depth');
+            break;
+        case 'U':
+            fits(section.WebThickness < section.FlangeWidth, 'WebThickness must be less than FlangeWidth');
+            fits(2 * section.FlangeThickness < section.Depth, 'two FlangeThicknesses must be less than Depth');
+            break;
+        case 'C':
+            fits(2 * section.WallThickness < section.Width, 'two WallThicknesses must be less than Width');
+            fits(2 * section.Girth < section.Depth, 'two Girths must be less than Depth');
+            fits(section.WallThickness < section.Girth, 'WallThickness must be less than Girth');
+            break;
+        case 'RectangleHollow':
+            fits(2 * section.WallThickness < Math.min(section.XDim, section.YDim), 'two WallThicknesses must be less than XDim and YDim');
+            break;
+        case 'CircleHollow':
+            fits(section.WallThickness < section.Radius, 'WallThickness must be less than Radius');
+            break;
+        default:
+            break;
+    }
+}
+function isNonNegativeFinite(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value >= 0;
+}
+/**
+ * The section's axis-aligned extent in its own frame (metres):
+ * `[along profile X, along profile Y]`. Profiles are centred, so the section
+ * spans half of each on either side of the element axis. For callers that
+ * need the outer size without meshing (fallback meshes, snapping, HUDs).
+ */
+export function profileSectionExtent(section) {
+    switch (section.Type) {
+        case 'Rectangle':
+        case 'RectangleHollow':
+            return [section.XDim, section.YDim];
+        case 'I':
+            return [section.OverallWidth, section.OverallDepth];
+        case 'L':
+        case 'C':
+            return [section.Width, section.Depth];
+        case 'T':
+        case 'U':
+            return [section.FlangeWidth, section.Depth];
+        case 'Circle':
+        case 'CircleHollow':
+            return [2 * section.Radius, 2 * section.Radius];
+    }
+}
+/**
+ * Everything `emitProfileSection` would refuse, checked without emitting, so a
+ * builder can validate its whole input before it writes its first entity.
+ */
+export function assertProfileSectionAuthorable(anchor, section, op) {
+    validateProfileSection(section, op);
+    return schemaRegistry(anchor.schema, op);
+}
+/**
+ * Emit a centred parameterised profile (`IfcAxis2Placement2D` at the origin +
+ * the profile class for `section.Type`) and return the profile's expressId.
+ * Validates the section, converts it to native units, and lays the attributes
+ * out for `anchor.schema` (IFC5 refused).
+ */
+export function emitProfileSection(editor, anchor, section, op = 'emitProfileSection') {
+    const registry = assertProfileSectionAuthorable(anchor, section, op);
+    const cls = profileSectionIfcClass(section);
+    const native = {};
+    for (const [name, value] of Object.entries(dimensions(section))) {
+        if (value !== undefined)
+            native[name] = toNativeLength(anchor, value);
+    }
+    const originPt = editor.addEntity('IfcCartesianPoint', [[0, 0]]).expressId;
+    const position = editor.addEntity('IfcAxis2Placement2D', [`#${originPt}`, null]).expressId;
+    const attrs = schemaAttributes(registry, cls, {
+        ProfileType: 'AREA',
+        Position: `#${position}`,
+        ...native,
+    }, op);
+    return editor.addEntity(cls, attrs).expressId;
+}
+/**
+ * Validate a beam's or member's section params: exactly one of the rectangle
+ * (`Width` + `Height`, finite and positive) or a `Profile`, checked before
+ * anything is emitted.
+ */
+export function linearSection(anchor, params, op) {
+    if (params.Profile !== undefined) {
+        if (params.Width !== undefined || params.Height !== undefined) {
+            throw new Error(`${op}: give either Width and Height or a Profile, not both`);
+        }
+        assertProfileSectionAuthorable(anchor, params.Profile, op);
+        return { Profile: params.Profile };
+    }
+    const { Width, Height } = params;
+    assertPositiveFinite([Width, Height], `${op}: Width and Height must be positive`);
+    return { Width, Height };
+}
+//# sourceMappingURL=profile.js.map

package/dist/in-store/profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.js","sourceRoot":"","sources":["../../src/in-store/profile.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAqB/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAsB,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAsE1E,MAAM,SAAS,GAAuC;IACpD,SAAS,EAAE,wBAAwB;IACnC,CAAC,EAAE,qBAAqB;IACxB,CAAC,EAAE,qBAAqB;IACxB,CAAC,EAAE,qBAAqB;IACxB,CAAC,EAAE,qBAAqB;IACxB,CAAC,EAAE,qBAAqB;IACxB,MAAM,EAAE,qBAAqB;IAC7B,eAAe,EAAE,8BAA8B;IAC/C,YAAY,EAAE,2BAA2B;CAC1C,CAAC;AAEF,qDAAqD;AACrD,MAAM,UAAU,sBAAsB,CAAC,OAAuB;IAC5D,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACrC,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,MAAM,CAAE,OAA8B,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5G,OAAO,GAAG,CAAC;AACb,CAAC;AAED,2FAA2F;AAC3F,SAAS,UAAU,CAAC,OAAuB;IACzC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IACzC,OAAO,IAA0C,CAAC;AACpD,CAAC;AAED,2GAA2G;AAC3G,MAAM,QAAQ,GAAkD;IAC9D,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;IAC3B,CAAC,EAAE,CAAC,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,iBAAiB,CAAC;IACtE,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC;IAClC,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,iBAAiB,CAAC;IAC9D,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,iBAAiB,CAAC;IAC9D,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,OAAO,CAAC;IAC/C,MAAM,EAAE,CAAC,QAAQ,CAAC;IAClB,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC;IAClD,YAAY,EAAE,CAAC,QAAQ,EAAE,eAAe,CAAC;CAC1C,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAuB,EAAE,EAAU;IACxE,MAAM,GAAG,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACjC,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACjD,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5D,MAAM,IAAI,KAAK,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,IAAI,+BAA+B,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;QACzB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACvE,MAAM,IAAI,KAAK,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,IAAI,mCAAmC,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,EAAW,EAAE,IAAY,EAAE,EAAE;QACzC,IAAI,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC,CAAC;IACF,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,GAAG;YACN,IAAI,CAAC,OAAO,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,EAAE,6CAA6C,CAAC,CAAC;YACjG,IAAI,CAAC,CAAC,GAAG,OAAO,CAAC,eAAe,GAAG,OAAO,CAAC,YAAY,EAAE,sDAAsD,CAAC,CAAC;YACjH,MAAM;QACR,KAAK,GAAG;YACN,IAAI,CAAC,OAAO,CAAC,SAAS,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,SAAS,GAAG,OAAO,CAAC,KAAK,EAAE,6CAA6C,CAAC,CAAC;YAC5H,MAAM;QACR,KAAK,GAAG;YACN,IAAI,CAAC,OAAO,CAAC,YAAY,GAAG,OAAO,CAAC,WAAW,EAAE,4CAA4C,CAAC,CAAC;YAC/F,IAAI,CAAC,OAAO,CAAC,eAAe,GAAG,OAAO,CAAC,KAAK,EAAE,yCAAyC,CAAC,CAAC;YACzF,MAAM;QACR,KAAK,GAAG;YACN,IAAI,CAAC,OAAO,CAAC,YAAY,GAAG,OAAO,CAAC,WAAW,EAAE,4CAA4C,CAAC,CAAC;YAC/F,IAAI,CAAC,CAAC,GAAG,OAAO,CAAC,eAAe,GAAG,OAAO,CAAC,KAAK,EAAE,+CAA+C,CAAC,CAAC;YACnG,MAAM;QACR,KAAK,GAAG;YACN,IAAI,CAAC,CAAC,GAAG,OAAO,CAAC,aAAa,GAAG,OAAO,CAAC,KAAK,EAAE,6CAA6C,CAAC,CAAC;YAC/F,IAAI,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,EAAE,oCAAoC,CAAC,CAAC;YAC9E,IAAI,CAAC,OAAO,CAAC,aAAa,GAAG,OAAO,CAAC,KAAK,EAAE,uCAAuC,CAAC,CAAC;YACrF,MAAM;QACR,KAAK,iBAAiB;YACpB,IAAI,CAAC,CAAC,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,qDAAqD,CAAC,CAAC;YAC9H,MAAM;QACR,KAAK,cAAc;YACjB,IAAI,CAAC,OAAO,CAAC,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,wCAAwC,CAAC,CAAC;YACvF,MAAM;QACR;YACE,MAAM;IACV,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAc;IACzC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAC3E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAuB;IAC1D,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,WAAW,CAAC;QACjB,KAAK,iBAAiB;YACpB,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QACtC,KAAK,GAAG;YACN,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;QACtD,KAAK,GAAG,CAAC;QACT,KAAK,GAAG;YACN,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACxC,KAAK,GAAG,CAAC;QACT,KAAK,GAAG;YACN,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QAC9C,KAAK,QAAQ,CAAC;QACd,KAAK,cAAc;YACjB,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpD,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,8BAA8B,CAC5C,MAAqC,EACrC,OAAuB,EACvB,EAAU;IAEV,sBAAsB,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACpC,OAAO,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAmB,EACnB,MAAyD,EACzD,OAAuB,EACvB,EAAE,GAAG,oBAAoB;IAEzB,MAAM,QAAQ,GAAG,8BAA8B,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;IACrE,MAAM,GAAG,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QAChE,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACxE,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3E,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,qBAAqB,EAAE,CAAC,IAAI,QAAQ,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3F,MAAM,KAAK,GAAG,gBAAgB,CAAC,QAAQ,EAAE,GAAG,EAAE;QAC5C,WAAW,EAAE,MAAM;QACnB,QAAQ,EAAE,IAAI,QAAQ,EAAE;QACxB,GAAG,MAAM;KACV,EAAE,EAAE,CAAC,CAAC;IACP,OAAO,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,KAAgD,CAAC,CAAC,SAAS,CAAC;AAC3F,CAAC;AAOD;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAqC,EACrC,MAAqE,EACrE,EAAU;IAEV,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACjC,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9D,MAAM,IAAI,KAAK,CAAC,GAAG,EAAE,uDAAuD,CAAC,CAAC;QAChF,CAAC;QACD,8BAA8B,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;IACrC,CAAC;IACD,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAA2C,CAAC;IACtE,oBAAoB,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,qCAAqC,CAAC,CAAC;IAClF,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC3B,CAAC"}

package/dist/in-store/railing.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Anchored builder for IfcRailing along a polyline path (#6232).
+ *
+ * `IfcCreator.addIfcRailing` draws one straight run (a square rail box plus a
+ * post at each end). This builder takes a whole path: the handrail is one
+ * IfcSweptDiskSolid swept along an IfcPolyline, so corners stay continuous,
+ * and circular posts (IfcExtrudedAreaSolid of an IfcCircleProfileDef) stand at
+ * every path vertex, plus intermediate ones when `PostSpacing` is set.
+ *
+ * `Height` is the height of the top of the handrail above the path, so the
+ * rail's centreline runs at `Height - RailDiameter / 2` and the posts stop
+ * there. The path is the railing's base line in storey coordinates; it may
+ * slope (a stair or ramp railing).
+ *
+ * Schema gating (D2): attributes are laid out from the target schema's
+ * registry; IFC2X3's mandatory `IfcSweptDiskSolid.StartParam`/`EndParam` are
+ * written as the polyline's full parameter range, and IFC5 is refused.
+ */
+import type { StoreEditor } from '@ifc-lite/mutations';
+import { type SpatialAnchor } from './anchor.js';
+type Vec3 = [number, number, number];
+export interface RailingInStoreParams {
+    /** Base line of the railing, storey-local (metres). At least two distinct consecutive points. */
+    Path: ReadonlyArray<readonly [number, number, number]>;
+    /** Height of the top of the handrail above the path (metres). */
+    Height: number;
+    /** Handrail diameter (metres). Default 0.05. */
+    RailDiameter?: number;
+    /** Post diameter (metres). Default `RailDiameter`. */
+    PostDiameter?: number;
+    /**
+     * Largest distance between posts along a segment (metres). Posts always
+     * stand at every path vertex; with a spacing, each segment gets evenly
+     * spaced intermediate posts no further apart than this.
+     */
+    PostSpacing?: number;
+    /** IfcRailing PredefinedType. Default `HANDRAIL`. */
+    PredefinedType?: string;
+    Name?: string;
+    Description?: string;
+    ObjectType?: string;
+    Tag?: string;
+    /** Explicit GlobalId (22-char IFC GUID); generated when omitted. */
+    GlobalId?: string;
+}
+export interface RailingBuildResult {
+    railingId: number;
+    placementId: number;
+    /** The handrail's IfcSweptDiskSolid. */
+    railSolidId: number;
+    /** One IfcExtrudedAreaSolid per post, in path order. */
+    postSolidIds: number[];
+    shapeRepId: number;
+    productShapeId: number;
+    relContainedId: number;
+}
+/**
+ * Post base points along `path` (vertices, plus intermediates at `spacing`).
+ * `spacing`, when given, must be finite and positive: a zero spacing would
+ * need infinitely many posts, and NaN would silently drop segment ends.
+ */
+export declare function railingPostPoints(path: ReadonlyArray<Vec3>, spacing?: number): Vec3[];
+export declare function addRailingToStore(editor: StoreEditor, anchor: SpatialAnchor, params: RailingInStoreParams): RailingBuildResult;
+export {};
+//# sourceMappingURL=railing.d.ts.map

package/dist/in-store/railing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"railing.d.ts","sourceRoot":"","sources":["../../src/in-store/railing.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,EAAkC,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAWjF,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAIrC,MAAM,WAAW,oBAAoB;IACnC,iGAAiG;IACjG,IAAI,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACvD,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB;AAKD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,CAUrF;AAoBD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,oBAAoB,GAC3B,kBAAkB,CA6EpB"}

package/dist/in-store/railing.js

@@ -0,0 +1,112 @@
+/* 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 { assertFinitePoint3 } from '../ifc-creator-math.js';
+import { toNativeLength, toNativePoint3 } from './anchor.js';
+import { assertPositiveFinite, emitLocalPlacement, emitRelContainedInSpatialStructure, ownerHistoryRef, productGuid, } from './_emit-helpers.js';
+import { schemaAttributes, schemaRegistry } from './schema-attributes.js';
+const DEFAULT_RAIL_DIAMETER = 0.05;
+const sub = (a, b) => [a[0] - b[0], a[1] - b[1], a[2] - b[2]];
+const lerp = (a, b, t) => [a[0] + (b[0] - a[0]) * t, a[1] + (b[1] - a[1]) * t, a[2] + (b[2] - a[2]) * t];
+/**
+ * Post base points along `path` (vertices, plus intermediates at `spacing`).
+ * `spacing`, when given, must be finite and positive: a zero spacing would
+ * need infinitely many posts, and NaN would silently drop segment ends.
+ */
+export function railingPostPoints(path, spacing) {
+    if (spacing !== undefined)
+        assertPositiveFinite([spacing], 'railingPostPoints: spacing must be a finite positive number');
+    const posts = [path[0]];
+    for (let i = 1; i < path.length; i++) {
+        const a = path[i - 1];
+        const b = path[i];
+        const bays = spacing === undefined ? 1 : Math.max(1, Math.ceil(Math.hypot(...sub(b, a)) / spacing - 1e-9));
+        for (let k = 1; k <= bays; k++)
+            posts.push(lerp(a, b, k / bays));
+    }
+    return posts;
+}
+function assertRailingParams(params, op) {
+    if (!Array.isArray(params.Path) || params.Path.length < 2) {
+        throw new Error(`${op}: Path needs at least two points`);
+    }
+    params.Path.forEach((p, i) => assertFinitePoint3({ [`Path[${i}]`]: p }, op));
+    for (let i = 1; i < params.Path.length; i++) {
+        if (Math.hypot(...sub(params.Path[i], params.Path[i - 1])) <= 1e-9) {
+            throw new Error(`${op}: Path[${i - 1}] and Path[${i}] must be distinct points`);
+        }
+    }
+    const rail = params.RailDiameter ?? DEFAULT_RAIL_DIAMETER;
+    assertPositiveFinite([params.Height, rail, params.PostDiameter ?? rail], `${op}: Height, RailDiameter and PostDiameter must be finite positive numbers`);
+    if (params.Height <= rail)
+        throw new Error(`${op}: Height must be greater than RailDiameter`);
+    if (params.PostSpacing !== undefined) {
+        assertPositiveFinite([params.PostSpacing], `${op}: PostSpacing must be a finite positive number`);
+    }
+}
+export function addRailingToStore(editor, anchor, params) {
+    const op = 'addRailingToStore';
+    assertRailingParams(params, op);
+    const registry = schemaRegistry(anchor.schema, op);
+    const isIfc2x3 = registry.name.toUpperCase() === 'IFC2X3';
+    const railDiameter = params.RailDiameter ?? DEFAULT_RAIL_DIAMETER;
+    const railRadius = toNativeLength(anchor, railDiameter / 2);
+    const postRadius = toNativeLength(anchor, (params.PostDiameter ?? railDiameter) / 2);
+    const railAxisHeight = toNativeLength(anchor, params.Height - railDiameter / 2);
+    const path = params.Path.map((p) => toNativePoint3(anchor, p));
+    const origin = path[0];
+    const local = path.map((p) => sub(p, origin));
+    const spacing = params.PostSpacing === undefined ? undefined : toNativeLength(anchor, params.PostSpacing);
+    // Lay the railing record out before the first emit so a bad PredefinedType
+    // or a missing IFC2X3 OwnerHistory refuses cleanly.
+    const globalId = productGuid(params, anchor.guidRandom);
+    const railingValues = (placement, shape) => ({
+        GlobalId: globalId,
+        OwnerHistory: ownerHistoryRef(anchor.ownerHistoryId),
+        Name: params.Name ?? 'Railing',
+        Description: params.Description,
+        ObjectType: params.ObjectType,
+        ObjectPlacement: placement,
+        Representation: shape,
+        Tag: params.Tag,
+        PredefinedType: params.PredefinedType ?? 'HANDRAIL',
+    });
+    schemaAttributes(registry, 'IfcRailing', railingValues(null, null), op);
+    // Placement at the first path point, explicit axes so it can be turned later.
+    const placementId = emitLocalPlacement(editor, anchor.storeyPlacementId, origin, [0, 0, 1], [1, 0, 0]);
+    // Handrail: a disk swept along the path lifted to the rail's centreline.
+    const directrixPoints = local.map((p) => editor.addEntity('IfcCartesianPoint', [[p[0], p[1], p[2] + railAxisHeight]]).expressId);
+    const directrix = editor.addEntity('IfcPolyline', [directrixPoints.map((id) => `#${id}`)]).expressId;
+    const railSolidId = editor.addEntity('IfcSweptDiskSolid', schemaAttributes(registry, 'IfcSweptDiskSolid', {
+        Directrix: `#${directrix}`,
+        Radius: railRadius,
+        // IfcPolyline's parameter is the point index; IFC2X3 requires the range.
+        ...(isIfc2x3 ? { StartParam: 0, EndParam: local.length - 1 } : {}),
+    }, op)).expressId;
+    // Posts: circular, from the path up to the rail's centreline. One shared
+    // profile and extrusion direction.
+    const postOriginPt = editor.addEntity('IfcCartesianPoint', [[0, 0]]).expressId;
+    const postProfilePos = editor.addEntity('IfcAxis2Placement2D', [`#${postOriginPt}`, null]).expressId;
+    const postProfile = editor.addEntity('IfcCircleProfileDef', schemaAttributes(registry, 'IfcCircleProfileDef', {
+        ProfileType: 'AREA',
+        Position: `#${postProfilePos}`,
+        Radius: postRadius,
+    }, op)).expressId;
+    const up = editor.addEntity('IfcDirection', [[0, 0, 1]]).expressId;
+    const postSolidIds = railingPostPoints(local, spacing).map((p) => {
+        const pt = editor.addEntity('IfcCartesianPoint', [p]).expressId;
+        const position = editor.addEntity('IfcAxis2Placement3D', [`#${pt}`, null, null]).expressId;
+        return editor.addEntity('IfcExtrudedAreaSolid', [`#${postProfile}`, `#${position}`, `#${up}`, railAxisHeight]).expressId;
+    });
+    const shapeRepId = editor.addEntity('IfcShapeRepresentation', [
+        `#${anchor.bodyContextId}`,
+        'Body',
+        'SolidModel',
+        [railSolidId, ...postSolidIds].map((id) => `#${id}`),
+    ]).expressId;
+    const productShapeId = editor.addEntity('IfcProductDefinitionShape', [null, null, [`#${shapeRepId}`]]).expressId;
+    const railingId = editor.addEntity('IfcRailing', schemaAttributes(registry, 'IfcRailing', railingValues(`#${placementId}`, `#${productShapeId}`), op)).expressId;
+    const relContainedId = emitRelContainedInSpatialStructure(editor, anchor.ownerHistoryId, railingId, anchor.storeyId, anchor.guidRandom);
+    return { railingId, placementId, railSolidId, postSolidIds, shapeRepId, productShapeId, relContainedId };
+}
+//# sourceMappingURL=railing.js.map

package/dist/in-store/railing.js.map

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

package/dist/in-store/rel-connects-path.d.ts

@@ -0,0 +1,43 @@
+/**
+ * `IfcRelConnectsPathElements`: two path elements (walls) joined at their
+ * start, end or along the path (#6232 D1). The attribute layout comes from the
+ * target schema's registry, so IFC2X3, IFC4 and IFC4X3 are all written right;
+ * IFC5 / IFCX are refused.
+ *
+ *   GlobalId, OwnerHistory?, Name?, Description?, ConnectionGeometry?,
+ *   RelatingElement, RelatedElement, RelatingPriorities, RelatedPriorities,
+ *   RelatedConnectionType, RelatingConnectionType
+ *
+ * The priorities are the material-layer priorities at the joint; they are
+ * mandatory lists, written empty when the caller has none.
+ *
+ * Pure: writes through the editor only.
+ */
+import { type RandomSource } from '@ifc-lite/encoding';
+import type { StoreEditor } from '@ifc-lite/mutations';
+import type { SpatialAnchorSchema } from './anchor.js';
+import type { WallConnectionType } from './wall-join.js';
+/** The anchor fields the relationship needs. A full `SpatialAnchor` or an `AuthoringAnchor` both fit. */
+export interface RelConnectsAnchor {
+    ownerHistoryId: number | null;
+    /** Default IFC4. */
+    schema?: SpatialAnchorSchema;
+    guidRandom?: RandomSource;
+}
+export interface RelConnectsPathElementsParams {
+    /** The element that runs through (for a T, the one whose path is joined). */
+    RelatingElement: number;
+    RelatedElement: number;
+    RelatingConnectionType: WallConnectionType;
+    RelatedConnectionType: WallConnectionType;
+    /** Layer priorities of the relating element at the joint. Default empty. */
+    RelatingPriorities?: readonly number[];
+    /** Layer priorities of the related element at the joint. Default empty. */
+    RelatedPriorities?: readonly number[];
+    Name?: string;
+    Description?: string;
+}
+export declare function addRelConnectsPathElementsToStore(editor: StoreEditor, anchor: RelConnectsAnchor, params: RelConnectsPathElementsParams): number;
+/** Validate `params` and lay out the relationship's attributes, without writing anything. */
+export declare function relConnectsPathElementsAttributes(editor: StoreEditor, anchor: RelConnectsAnchor, params: RelConnectsPathElementsParams, op: string): unknown[];
+//# sourceMappingURL=rel-connects-path.d.ts.map

package/dist/in-store/rel-connects-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rel-connects-path.d.ts","sourceRoot":"","sources":["../../src/in-store/rel-connects-path.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD,yGAAyG;AACzG,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,oBAAoB;IACpB,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,UAAU,CAAC,EAAE,YAAY,CAAC;CAC3B;AAED,MAAM,WAAW,6BAA6B;IAC5C,6EAA6E;IAC7E,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,sBAAsB,EAAE,kBAAkB,CAAC;IAC3C,qBAAqB,EAAE,kBAAkB,CAAC;IAC1C,4EAA4E;IAC5E,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,2EAA2E;IAC3E,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAID,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,6BAA6B,GACpC,MAAM,CAGR;AAED,6FAA6F;AAC7F,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,6BAA6B,EACrC,EAAE,EAAE,MAAM,GACT,OAAO,EAAE,CAiCX"}

package/dist/in-store/rel-connects-path.js

@@ -0,0 +1,65 @@
+/* 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/. */
+/**
+ * `IfcRelConnectsPathElements`: two path elements (walls) joined at their
+ * start, end or along the path (#6232 D1). The attribute layout comes from the
+ * target schema's registry, so IFC2X3, IFC4 and IFC4X3 are all written right;
+ * IFC5 / IFCX are refused.
+ *
+ *   GlobalId, OwnerHistory?, Name?, Description?, ConnectionGeometry?,
+ *   RelatingElement, RelatedElement, RelatingPriorities, RelatedPriorities,
+ *   RelatedConnectionType, RelatingConnectionType
+ *
+ * The priorities are the material-layer priorities at the joint; they are
+ * mandatory lists, written empty when the caller has none.
+ *
+ * Pure: writes through the editor only.
+ */
+import { generateIfcGuid } from '@ifc-lite/encoding';
+import { ownerHistoryRef } from './_emit-helpers.js';
+import { conformsTo, schemaAttributes, schemaRegistry } from './schema-attributes.js';
+const CONNECTION_TYPES = ['ATSTART', 'ATEND', 'ATPATH'];
+export function addRelConnectsPathElementsToStore(editor, anchor, params) {
+    const attributes = relConnectsPathElementsAttributes(editor, anchor, params, 'addRelConnectsPathElementsToStore');
+    return editor.addEntity('IfcRelConnectsPathElements', attributes).expressId;
+}
+/** Validate `params` and lay out the relationship's attributes, without writing anything. */
+export function relConnectsPathElementsAttributes(editor, anchor, params, op) {
+    const registry = schemaRegistry(anchor.schema, op);
+    const { RelatingElement: relating, RelatedElement: related } = params;
+    for (const id of [relating, related]) {
+        if (!Number.isInteger(id) || id <= 0 || !editor.hasEntity(id))
+            throw new Error(`${op}: #${id} is not a live entity`);
+        const type = editor.getEntityType(id);
+        if (!type || !conformsTo(registry, type, 'IfcElement')) {
+            throw new Error(`${op}: #${id} is ${type ?? 'unknown'}, not an IfcElement`);
+        }
+    }
+    if (relating === related)
+        throw new Error(`${op}: an element cannot connect to itself`);
+    for (const value of [params.RelatingConnectionType, params.RelatedConnectionType]) {
+        if (!CONNECTION_TYPES.includes(value))
+            throw new Error(`${op}: connection type must be ATSTART, ATEND or ATPATH; got ${String(value)}`);
+    }
+    const priorities = (list, name) => {
+        const values = [...(list ?? [])];
+        if (values.some((v) => !Number.isInteger(v) || v < 0 || v > 100)) {
+            throw new Error(`${op}: ${name} must be integers between 0 and 100`);
+        }
+        return values;
+    };
+    return schemaAttributes(registry, 'IfcRelConnectsPathElements', {
+        GlobalId: generateIfcGuid(anchor.guidRandom),
+        OwnerHistory: ownerHistoryRef(anchor.ownerHistoryId),
+        Name: params.Name,
+        Description: params.Description,
+        RelatingElement: `#${relating}`,
+        RelatedElement: `#${related}`,
+        RelatingPriorities: priorities(params.RelatingPriorities, 'RelatingPriorities'),
+        RelatedPriorities: priorities(params.RelatedPriorities, 'RelatedPriorities'),
+        RelatedConnectionType: params.RelatedConnectionType,
+        RelatingConnectionType: params.RelatingConnectionType,
+    }, op);
+}
+//# sourceMappingURL=rel-connects-path.js.map