@ifc-lite/create 1.16.4 → 2.0.0

package/README.md

@@ -1,6 +1,6 @@
 # @ifc-lite/create
 
-Create valid IFC4 STEP files from scratch, programmatically. `IfcCreator` builds a complete spatial structure (project, site, building, storeys) and adds building elements with real geometry, property sets, quantities, and materials. Inputs are in metres and elements are placed relative to an identity placement unless you specify otherwise.
+Create valid IFC4 STEP files from scratch, programmatically. `IfcCreator` builds a complete spatial structure (project, site, building, storeys) and adds building elements with real geometry, property sets, quantities, and materials. Inputs are in metres. Element coordinates are relative to the storey you add the element to: the storey placement carries `Elevation` and every element chains to it, so an element standing on a storey at `Elevation: 3` is created with `Z = 0`.
 
 ## Install
 

package/dist/ifc-creator.d.ts

@@ -14,6 +14,27 @@
  * All values in metres unless LengthUnit is overridden.
  */
 import type { Point3D, Point2D, Placement3D, ElementAttributes, ProfileDef, GenericElementParams, AxisElementParams, WallParams, SlabParams, ColumnParams, BeamParams, StairParams, RoofParams, GableRoofParams, WallDoorParams, WallWindowParams, DoorParams, WindowParams, RampParams, RailingParams, PlateParams, MemberParams, FootingParams, PileParams, SpaceParams, CurtainWallParams, FurnishingParams, ProxyParams, ProjectParams, StoreyParams, PropertySetDef, QuantitySetDef, MaterialDef, WorkScheduleParams, WorkPlanParams, TaskParams, SequenceParams, CreateResult } from './types.js';
+/**
+ * PLACEMENT CONTRACT
+ *
+ * Every `addIfcXxx(storeyId, …)` / `addElement(storeyId, …)` method takes the
+ * storey as its first argument and emits an `IfcRelContainedInSpatialStructure`
+ * putting the product in that storey. The product's `IfcLocalPlacement` is
+ * therefore chained to the STOREY's placement, never to the world: the
+ * placement hierarchy has to agree with the containment hierarchy, or moving a
+ * storey leaves its own contents behind.
+ *
+ * Consequence for callers: **coordinates passed to these methods are
+ * storey-relative.** `IfcBuildingStorey.Elevation` is applied exactly once, by
+ * the storey's own placement (`[0, 0, Elevation]`, the only placement in this
+ * class that is chained to the world). A wall whose floor sits on a storey at
+ * `Elevation: 3` is created with `Z = 0`, not `Z = 3`.
+ *
+ * Before 2.0.0 only `addIfcWall`, `addIfcSlab`, `addIfcColumn`, `addIfcBeam`,
+ * `addIfcStair`, `addIfcRoof` and `addIfcGableRoof` behaved this way; the other
+ * 21 constructors chained to the world, so a caller mixing them on a storey
+ * with a non-zero elevation got two different datums in one model.
+ */
 export declare class IfcCreator {
     private nextId;
     private lines;
@@ -50,12 +71,27 @@ export declare class IfcCreator {
     /** Wall expressId → wall thickness */
     private wallThicknesses;
     private projectParams;
+    /** Fixed creation instant (epoch ms) for header/owner-history; null = wall clock. */
+    private readonly fixedTimestampMs;
+    /** Deterministic GlobalId source; null = platform CSPRNG. */
+    private readonly guidSource;
     constructor(params?: ProjectParams);
+    /** The creation instant used everywhere: the fixed Timestamp when provided, else the wall clock. */
+    private nowMs;
     /** Generate a spec-valid 22-character IFC GlobalId (canonical encoder from @ifc-lite/encoding). */
     private newGlobalId;
     /** Add a building storey. Returns the storey expressId for use with element creation. */
     addIfcBuildingStorey(params: StoreyParams): number;
-    /** Get the IfcLocalPlacement for a storey (falls back to world if unknown) */
+    /**
+     * The `IfcLocalPlacement` every product of this storey chains to.
+     *
+     * Throws on an unknown storey rather than falling back to the world
+     * placement: the fallback silently produced a product on a different datum
+     * from its siblings, which is the exact failure this parent is here to make
+     * impossible. `trackElement` rejects the same id a few lines later anyway,
+     * so failing here only means the half-built placement entities are never
+     * emitted.
+     */
     private getStoreyPlacement;
     /**
      * Create a wall from Start to End with given Thickness and Height.

package/dist/ifc-creator.d.ts.map

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

package/dist/ifc-creator.js

@@ -2,7 +2,7 @@
  * 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 { esc, stepLine, num, vecLen, vecNorm, vecCross, NON_ELEMENT_TYPES, } from './ifc-creator-math.js';
-import { generateIfcGuid } from '@ifc-lite/encoding';
+import { generateIfcGuid, isValidIfcGuid } from '@ifc-lite/encoding';
 // ============================================================================
 // STEP attribute helpers (scheduling — optional strings / enums / numbers)
 // ============================================================================
@@ -25,6 +25,27 @@ function optReal(v) {
 // ============================================================================
 // IfcCreator
 // ============================================================================
+/**
+ * PLACEMENT CONTRACT
+ *
+ * Every `addIfcXxx(storeyId, …)` / `addElement(storeyId, …)` method takes the
+ * storey as its first argument and emits an `IfcRelContainedInSpatialStructure`
+ * putting the product in that storey. The product's `IfcLocalPlacement` is
+ * therefore chained to the STOREY's placement, never to the world: the
+ * placement hierarchy has to agree with the containment hierarchy, or moving a
+ * storey leaves its own contents behind.
+ *
+ * Consequence for callers: **coordinates passed to these methods are
+ * storey-relative.** `IfcBuildingStorey.Elevation` is applied exactly once, by
+ * the storey's own placement (`[0, 0, Elevation]`, the only placement in this
+ * class that is chained to the world). A wall whose floor sits on a storey at
+ * `Elevation: 3` is created with `Z = 0`, not `Z = 3`.
+ *
+ * Before 2.0.0 only `addIfcWall`, `addIfcSlab`, `addIfcColumn`, `addIfcBeam`,
+ * `addIfcStair`, `addIfcRoof` and `addIfcGableRoof` behaved this way; the other
+ * 21 constructors chained to the world, so a caller mixing them on a storey
+ * with a non-zero elevation got two different datums in one model.
+ */
 export class IfcCreator {
     nextId = 1;
     lines = [];
@@ -67,19 +88,48 @@ export class IfcCreator {
     /** Wall expressId → wall thickness */
     wallThicknesses = new Map();
     projectParams;
+    /** Fixed creation instant (epoch ms) for header/owner-history; null = wall clock. */
+    fixedTimestampMs;
+    /** Deterministic GlobalId source; null = platform CSPRNG. */
+    guidSource;
     constructor(params = {}) {
         this.projectParams = params;
         this.schema = params.Schema ?? 'IFC4';
+        this.fixedTimestampMs = params.Timestamp === undefined
+            ? null
+            : typeof params.Timestamp === 'number' ? params.Timestamp : params.Timestamp.getTime();
+        // Finite is not enough: epoch-ms past ±8.64e15 is outside the Date range,
+        // so it survives `Number.isFinite` and only blows up later in
+        // `toISOString()` while writing the header. Reject it here, where the
+        // message can still name the offending parameter.
+        if (this.fixedTimestampMs !== null
+            && (!Number.isFinite(this.fixedTimestampMs) || Number.isNaN(new Date(this.fixedTimestampMs).getTime()))) {
+            throw new Error('IfcCreator: Timestamp must be a finite epoch-milliseconds number within the Date range, or a valid Date');
+        }
+        this.guidSource = params.GuidSource ?? null;
         this.buildPreamble(params);
     }
+    /** The creation instant used everywhere: the fixed Timestamp when provided, else the wall clock. */
+    nowMs() {
+        return this.fixedTimestampMs ?? Date.now();
+    }
     /** Generate a spec-valid 22-character IFC GlobalId (canonical encoder from @ifc-lite/encoding). */
     newGlobalId() {
-        let result;
-        do {
-            result = generateIfcGuid();
-        } while (this.usedGlobalIds.has(result));
-        this.usedGlobalIds.add(result);
-        return result;
+        const generate = this.guidSource ?? generateIfcGuid;
+        // Bounded retry: with the default CSPRNG a collision is astronomically
+        // unlikely; with a user GuidSource the bound turns a repeating source into
+        // a clear error instead of an infinite loop.
+        for (let attempt = 0; attempt < 100; attempt += 1) {
+            const result = generate();
+            if (this.guidSource !== null && !isValidIfcGuid(result)) {
+                throw new Error(`IfcCreator: GuidSource returned an invalid IFC GlobalId: '${result}' (must be 22 characters of the IFC base64 alphabet)`);
+            }
+            if (!this.usedGlobalIds.has(result)) {
+                this.usedGlobalIds.add(result);
+                return result;
+            }
+        }
+        throw new Error('IfcCreator: could not generate a unique GlobalId after 100 attempts - the GuidSource is repeating already-used values');
     }
     // ============================================================================
     // Public API — Spatial Structure
@@ -102,9 +152,22 @@ export class IfcCreator {
         this.entities.push({ expressId: id, type: 'IfcBuildingStorey', Name: name });
         return id;
     }
-    /** Get the IfcLocalPlacement for a storey (falls back to world if unknown) */
+    /**
+     * The `IfcLocalPlacement` every product of this storey chains to.
+     *
+     * Throws on an unknown storey rather than falling back to the world
+     * placement: the fallback silently produced a product on a different datum
+     * from its siblings, which is the exact failure this parent is here to make
+     * impossible. `trackElement` rejects the same id a few lines later anyway,
+     * so failing here only means the half-built placement entities are never
+     * emitted.
+     */
     getStoreyPlacement(storeyId) {
-        return this.storeyPlacements.get(storeyId) ?? this.worldPlacementId;
+        const placementId = this.storeyPlacements.get(storeyId);
+        if (placementId === undefined) {
+            throw new Error(`Unknown storeyId #${storeyId} — call addIfcBuildingStorey() first`);
+        }
+        return placementId;
     }
     // ============================================================================
     // Public API — Building Elements
@@ -470,7 +533,7 @@ export class IfcCreator {
      * Create a door element. Width × Height × Thickness panel.
      */
     addIfcDoor(storeyId, params) {
-        const placementId = this.addLocalPlacement(this.worldPlacementId, {
+        const placementId = this.addLocalPlacement(this.getStoreyPlacement(storeyId), {
             Location: params.Position,
         });
         const thickness = params.Thickness ?? 0.05;
@@ -496,7 +559,7 @@ export class IfcCreator {
      * Create a window element. Width × Height × Thickness frame.
      */
     addIfcWindow(storeyId, params) {
-        const placementId = this.addLocalPlacement(this.worldPlacementId, {
+        const placementId = this.addLocalPlacement(this.getStoreyPlacement(storeyId), {
             Location: params.Position,
         });
         const thickness = params.Thickness ?? 0.05;
@@ -530,7 +593,7 @@ export class IfcCreator {
             axis = [Math.sin(slopeAngle), 0, Math.cos(slopeAngle)];
             refDir = [Math.cos(slopeAngle), 0, -Math.sin(slopeAngle)];
         }
-        const placementId = this.addLocalPlacement(this.worldPlacementId, {
+        const placementId = this.addLocalPlacement(this.getStoreyPlacement(storeyId), {
             Location: params.Position,
             Axis: axis,
             RefDirection: refDir,
@@ -561,7 +624,7 @@ export class IfcCreator {
         const railLen = Math.sqrt(dx * dx + dy * dy + dz * dz);
         const dir = vecNorm([dx, dy, dz]);
         // Use identity orientation so posts can extrude vertically along world Z
-        const placementId = this.addLocalPlacement(this.worldPlacementId, {
+        const placementId = this.addLocalPlacement(this.getStoreyPlacement(storeyId), {
             Location: params.Start,
         });
         const railWidth = params.Width ?? 0.05;
@@ -609,7 +672,7 @@ export class IfcCreator {
      * Create a plate (thin flat element, e.g. steel plate).
      */
     addIfcPlate(storeyId, params) {
-        const placementId = this.addLocalPlacement(this.worldPlacementId, {
+        const placementId = this.addLocalPlacement(this.getStoreyPlacement(storeyId), {
             Location: params.Position,
         });
         let profileId;
@@ -643,7 +706,7 @@ export class IfcCreator {
         const dz = params.End[2] - params.Start[2];
         const memberLen = Math.sqrt(dx * dx + dy * dy + dz * dz);
         const dir = vecNorm([dx, dy, dz]);
-        const placementId = this.addLocalPlacement(this.worldPlacementId, {
+        const placementId = this.addLocalPlacement(this.getStoreyPlacement(storeyId), {
             Location: params.Start,
             Axis: dir,
             RefDirection: this.computeRefDirection(dir),
@@ -669,7 +732,7 @@ export class IfcCreator {
      */
     addIfcFooting(storeyId, params) {
         // Offset placement downward so extrusion starts at bottom
-        const placementId = this.addLocalPlacement(this.worldPlacementId, {
+        const placementId = this.addLocalPlacement(this.getStoreyPlacement(storeyId), {
             Location: [params.Position[0], params.Position[1], params.Position[2] - params.Height],
         });
         const profileId = this.addRectangleProfile(params.Width, params.Depth);
@@ -694,7 +757,7 @@ export class IfcCreator {
      * Uses circular cross-section by default, rectangular if IsRectangular is set.
      */
     addIfcPile(storeyId, params) {
-        const placementId = this.addLocalPlacement(this.worldPlacementId, {
+        const placementId = this.addLocalPlacement(this.getStoreyPlacement(storeyId), {
             Location: [params.Position[0], params.Position[1], params.Position[2] - params.Length],
         });
         let profileId;
@@ -724,7 +787,7 @@ export class IfcCreator {
      * Create a space (room volume).
      */
     addIfcSpace(storeyId, params) {
-        const placementId = this.addLocalPlacement(this.worldPlacementId, {
+        const placementId = this.addLocalPlacement(this.getStoreyPlacement(storeyId), {
             Location: params.Position,
         });
         let profileId;
@@ -760,7 +823,7 @@ export class IfcCreator {
         const wallLen = Math.sqrt(dx * dx + dy * dy + dz * dz);
         const dir = vecNorm([dx, dy, dz]);
         const thickness = params.Thickness ?? 0.05;
-        const placementId = this.addLocalPlacement(this.worldPlacementId, {
+        const placementId = this.addLocalPlacement(this.getStoreyPlacement(storeyId), {
             Location: params.Start,
             RefDirection: dir,
         });
@@ -785,7 +848,7 @@ export class IfcCreator {
      */
     addIfcFurnishingElement(storeyId, params) {
         const direction = params.Direction ?? 0;
-        const placementId = this.addLocalPlacement(this.worldPlacementId, {
+        const placementId = this.addLocalPlacement(this.getStoreyPlacement(storeyId), {
             Location: params.Position,
             RefDirection: direction !== 0 ? [Math.cos(direction), Math.sin(direction), 0] : undefined,
         });
@@ -809,7 +872,7 @@ export class IfcCreator {
      * Create a proxy element (generic element for custom/unclassified objects).
      */
     addIfcBuildingElementProxy(storeyId, params) {
-        const placementId = this.addLocalPlacement(this.worldPlacementId, {
+        const placementId = this.addLocalPlacement(this.getStoreyPlacement(storeyId), {
             Location: params.Position,
         });
         let profileId;
@@ -842,7 +905,7 @@ export class IfcCreator {
      * Create a column with circular cross-section.
      */
     addIfcCircularColumn(storeyId, params) {
-        const placementId = this.addLocalPlacement(this.worldPlacementId, {
+        const placementId = this.addLocalPlacement(this.getStoreyPlacement(storeyId), {
             Location: params.Position,
         });
         const profileId = this.addCircleProfile(params.Radius);
@@ -870,7 +933,7 @@ export class IfcCreator {
         const dz = params.End[2] - params.Start[2];
         const beamLen = Math.sqrt(dx * dx + dy * dy + dz * dz);
         const dir = vecNorm([dx, dy, dz]);
-        const placementId = this.addLocalPlacement(this.worldPlacementId, {
+        const placementId = this.addLocalPlacement(this.getStoreyPlacement(storeyId), {
             Location: params.Start,
             Axis: dir,
             RefDirection: this.computeRefDirection(dir),
@@ -900,7 +963,7 @@ export class IfcCreator {
         const dz = params.End[2] - params.Start[2];
         const memberLen = Math.sqrt(dx * dx + dy * dy + dz * dz);
         const dir = vecNorm([dx, dy, dz]);
-        const placementId = this.addLocalPlacement(this.worldPlacementId, {
+        const placementId = this.addLocalPlacement(this.getStoreyPlacement(storeyId), {
             Location: params.Start,
             Axis: dir,
             RefDirection: this.computeRefDirection(dir),
@@ -930,7 +993,7 @@ export class IfcCreator {
         const dz = params.End[2] - params.Start[2];
         const memberLen = Math.sqrt(dx * dx + dy * dy + dz * dz);
         const dir = vecNorm([dx, dy, dz]);
-        const placementId = this.addLocalPlacement(this.worldPlacementId, {
+        const placementId = this.addLocalPlacement(this.getStoreyPlacement(storeyId), {
             Location: params.Start,
             Axis: dir,
             RefDirection: this.computeRefDirection(dir),
@@ -960,7 +1023,7 @@ export class IfcCreator {
         const dz = params.End[2] - params.Start[2];
         const memberLen = Math.sqrt(dx * dx + dy * dy + dz * dz);
         const dir = vecNorm([dx, dy, dz]);
-        const placementId = this.addLocalPlacement(this.worldPlacementId, {
+        const placementId = this.addLocalPlacement(this.getStoreyPlacement(storeyId), {
             Location: params.Start,
             Axis: dir,
             RefDirection: this.computeRefDirection(dir),
@@ -985,7 +1048,7 @@ export class IfcCreator {
      * Create a column or pile with hollow circular cross-section.
      */
     addIfcHollowCircularColumn(storeyId, params) {
-        const placementId = this.addLocalPlacement(this.worldPlacementId, {
+        const placementId = this.addLocalPlacement(this.getStoreyPlacement(storeyId), {
             Location: params.Position,
         });
         const profileId = this.addCircleHollowProfile(params.Radius, params.WallThickness);
@@ -1013,7 +1076,7 @@ export class IfcCreator {
         const dz = params.End[2] - params.Start[2];
         const beamLen = Math.sqrt(dx * dx + dy * dy + dz * dz);
         const dir = vecNorm([dx, dy, dz]);
-        const placementId = this.addLocalPlacement(this.worldPlacementId, {
+        const placementId = this.addLocalPlacement(this.getStoreyPlacement(storeyId), {
             Location: params.Start,
             Axis: dir,
             RefDirection: this.computeRefDirection(dir),
@@ -1314,7 +1377,7 @@ export class IfcCreator {
         const desc = optStr(params.Description);
         const objType = '$';
         const ident = optStr(params.Identification);
-        const creationDate = params.CreationDate ?? new Date().toISOString().slice(0, 19);
+        const creationDate = params.CreationDate ?? new Date(this.nowMs()).toISOString().slice(0, 19);
         const purpose = optStr(params.Purpose);
         const duration = optStr(params.Duration);
         const totalFloat = optStr(params.TotalFloat);
@@ -1354,7 +1417,7 @@ export class IfcCreator {
         };
     }
     buildHeader() {
-        const now = new Date().toISOString().replace(/[-:]/g, '').split('.')[0];
+        const now = new Date(this.nowMs()).toISOString().replace(/[-:]/g, '').split('.')[0];
         const desc = 'Created by ifc-lite';
         const author = this.projectParams.Author ?? '';
         const org = this.projectParams.Organization ?? '';
@@ -1381,7 +1444,7 @@ ENDSEC;
         const appId = this.id();
         this.line(appId, 'IFCAPPLICATION', `#${orgId},'1.0','ifc-lite','ifc-lite'`);
         this.ownerHistoryId = this.id();
-        const timestamp = Math.floor(Date.now() / 1000);
+        const timestamp = Math.floor(this.nowMs() / 1000);
         this.line(this.ownerHistoryId, 'IFCOWNERHISTORY', `#${personOrgId},#${appId},$,.NOCHANGE.,$,$,$,${timestamp}`);
         // Shared geometry primitives
         this.originId = this.addCartesianPoint([0, 0, 0]);
@@ -1812,7 +1875,7 @@ ENDSEC;
      * ```
      */
     addElement(storeyId, params) {
-        const placementId = this.addLocalPlacement(this.worldPlacementId, params.Placement);
+        const placementId = this.addLocalPlacement(this.getStoreyPlacement(storeyId), params.Placement);
         const profileId = this.createProfile(params.Profile);
         // Handle custom extrusion direction
         let extrusionDirId;
@@ -1882,7 +1945,7 @@ ENDSEC;
             perp = vecCross(dir, [1, 0, 0]);
         }
         perp = vecNorm(perp);
-        const placementId = this.addLocalPlacement(this.worldPlacementId, {
+        const placementId = this.addLocalPlacement(this.getStoreyPlacement(storeyId), {
             Location: params.Start,
             Axis: dir, // local Z = along axis (extrusion direction)
             RefDirection: perp, // local X = perpendicular to axis