@ifc-lite/create 1.14.0

package/dist/ifc-creator.js

@@ -0,0 +1,861 @@
+/* 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/. */
+// ============================================================================
+// Internal helpers
+// ============================================================================
+/** Generate a 22-character IFC GlobalId (base64-ish) */
+function newGlobalId() {
+    const chars = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz_$';
+    let result = '';
+    for (let i = 0; i < 22; i++) {
+        result += chars[Math.floor(Math.random() * 64)];
+    }
+    return result;
+}
+/** Escape a string for STEP format */
+function esc(str) {
+    return str.replace(/\\/g, '\\\\').replace(/'/g, "''");
+}
+/** Format a STEP line: #ID=TYPE(args); */
+function stepLine(id, type, args) {
+    return `#${id}=${type}(${args});`;
+}
+/** Serialize a number in STEP format (always with decimal point, no exponent notation) */
+function num(v) {
+    // Exponent notation (e.g. 1e-7) is not valid STEP — use fixed decimal
+    const s = v.toString();
+    if (s.includes('e') || s.includes('E'))
+        return v.toFixed(10).replace(/0+$/, '0');
+    return s.includes('.') ? s : s + '.';
+}
+/** Vector length */
+function vecLen(v) {
+    return Math.sqrt(v[0] * v[0] + v[1] * v[1] + v[2] * v[2]);
+}
+/** Normalize vector — throws on zero-length (indicates geometry bug like Start === End) */
+function vecNorm(v) {
+    const len = vecLen(v);
+    if (len === 0)
+        throw new Error('Cannot normalize zero-length vector (check that Start and End are not identical)');
+    return [v[0] / len, v[1] / len, v[2] / len];
+}
+/** Cross product */
+function vecCross(a, b) {
+    return [
+        a[1] * b[2] - a[2] * b[1],
+        a[2] * b[0] - a[0] * b[2],
+        a[0] * b[1] - a[1] * b[0],
+    ];
+}
+// ============================================================================
+// IfcCreator
+// ============================================================================
+export class IfcCreator {
+    nextId = 1;
+    lines = [];
+    entities = [];
+    schema;
+    // Shared entity IDs (created in constructor)
+    projectId = 0;
+    siteId = 0;
+    buildingId = 0;
+    ownerHistoryId = 0;
+    contextId = 0;
+    subContextBody = 0;
+    subContextAxis = 0;
+    originId = 0;
+    dirZ = 0;
+    dirX = 0;
+    worldPlacementId = 0;
+    unitAssignmentId = 0;
+    // Guard against repeated toIfc() calls (relationships are not idempotent)
+    finalized = false;
+    // Default surface style (applied to elements without custom color)
+    defaultStyleId = 0;
+    // Per-element style tracking (deferred to finalization)
+    elementSolids = new Map();
+    elementColors = new Map();
+    // Material tracking (deferred IfcRelAssociatesMaterial at finalization)
+    materialCache = new Map(); // name → IfcMaterial id
+    elementMaterials = new Map(); // elementId → materialRefId
+    // Tracking for spatial aggregation
+    storeyIds = [];
+    storeyElements = new Map();
+    projectParams;
+    constructor(params = {}) {
+        this.projectParams = params;
+        this.schema = params.Schema ?? 'IFC4';
+        this.buildPreamble(params);
+    }
+    // ============================================================================
+    // Public API — Spatial Structure
+    // ============================================================================
+    /** Add a building storey. Returns the storey expressId for use with element creation. */
+    addIfcBuildingStorey(params) {
+        const id = this.id();
+        const globalId = newGlobalId();
+        const name = params.Name ?? 'Storey';
+        const desc = params.Description ? `'${esc(params.Description)}'` : '$';
+        const elevation = num(params.Elevation);
+        this.line(id, 'IFCBUILDINGSTOREY', `'${globalId}',#${this.ownerHistoryId},'${esc(name)}',${desc},$,$,#${this.worldPlacementId},$,.ELEMENT.,${elevation}`);
+        this.storeyIds.push(id);
+        this.storeyElements.set(id, []);
+        this.entities.push({ expressId: id, type: 'IfcBuildingStorey', Name: name });
+        return id;
+    }
+    // ============================================================================
+    // Public API — Building Elements
+    // ============================================================================
+    /**
+     * Create a wall from Start to End with given Thickness and Height.
+     *
+     * Geometry: placement at Start. Profile offset so the solid extends
+     * exactly from Start to End, centered on the thickness axis. Extruded
+     * upward by Height.
+     */
+    addIfcWall(storeyId, params) {
+        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 wallLen = Math.sqrt(dx * dx + dy * dy + dz * dz);
+        const dir = vecNorm([dx, dy, dz]);
+        // Placement at Start. Local X = wall direction, Z = up (default).
+        const placementId = this.addLocalPlacement(this.worldPlacementId, {
+            Location: params.Start,
+            RefDirection: dir,
+        });
+        // Rectangle profile centered at (wallLen/2, 0) so it spans 0..wallLen along local X
+        // and -thickness/2..+thickness/2 along local Y.
+        const profileId = this.addRectangleProfile(wallLen, params.Thickness, [wallLen / 2, 0]);
+        // Extrude along Z (up) by Height
+        const solidId = this.addExtrudedAreaSolid(profileId, params.Height);
+        const shapeId = this.addShapeRepresentation('Body', [solidId]);
+        const prodShapeId = this.addProductDefinitionShape([shapeId]);
+        const wallId = this.id();
+        const globalId = newGlobalId();
+        const name = params.Name ?? 'Wall';
+        const desc = params.Description ? `'${esc(params.Description)}'` : '$';
+        const objType = params.ObjectType ? `'${esc(params.ObjectType)}'` : '$';
+        const tag = params.Tag ? `'${esc(params.Tag)}'` : '$';
+        this.line(wallId, 'IFCWALL', `'${globalId}',#${this.ownerHistoryId},'${esc(name)}',${desc},${objType},#${placementId},#${prodShapeId},${tag},.STANDARD.`);
+        this.elementSolids.set(wallId, [solidId]);
+        this.trackElement(storeyId, wallId);
+        this.entities.push({ expressId: wallId, type: 'IfcWall', Name: name });
+        // Add openings
+        if (params.Openings) {
+            for (const opening of params.Openings) {
+                this.addWallOpening(wallId, placementId, opening, params.Thickness);
+            }
+        }
+        return wallId;
+    }
+    /**
+     * Create a slab. Position is the minimum corner.
+     * Width along +X, Depth along +Y, Thickness extruded along +Z.
+     */
+    addIfcSlab(storeyId, params) {
+        const placementId = this.addLocalPlacement(this.worldPlacementId, {
+            Location: params.Position,
+        });
+        let profileId;
+        if (params.Profile && params.Profile.length >= 3) {
+            profileId = this.addArbitraryProfile(params.Profile);
+        }
+        else {
+            const w = params.Width ?? 5;
+            const d = params.Depth ?? 5;
+            // Profile centered at (w/2, d/2) so slab starts at Position corner
+            profileId = this.addRectangleProfile(w, d, [w / 2, d / 2]);
+        }
+        const solidId = this.addExtrudedAreaSolid(profileId, params.Thickness);
+        const shapeId = this.addShapeRepresentation('Body', [solidId]);
+        const prodShapeId = this.addProductDefinitionShape([shapeId]);
+        const slabId = this.id();
+        const globalId = newGlobalId();
+        const name = params.Name ?? 'Slab';
+        const desc = params.Description ? `'${esc(params.Description)}'` : '$';
+        const objType = params.ObjectType ? `'${esc(params.ObjectType)}'` : '$';
+        const tag = params.Tag ? `'${esc(params.Tag)}'` : '$';
+        this.line(slabId, 'IFCSLAB', `'${globalId}',#${this.ownerHistoryId},'${esc(name)}',${desc},${objType},#${placementId},#${prodShapeId},${tag},.FLOOR.`);
+        this.elementSolids.set(slabId, [solidId]);
+        this.trackElement(storeyId, slabId);
+        this.entities.push({ expressId: slabId, type: 'IfcSlab', Name: name });
+        if (params.Openings) {
+            for (const opening of params.Openings) {
+                this.addSlabOpening(slabId, placementId, opening, params.Thickness);
+            }
+        }
+        return slabId;
+    }
+    /**
+     * Create a column. Position is the base center.
+     * Cross-section centered, extruded upward by Height.
+     */
+    addIfcColumn(storeyId, params) {
+        const placementId = this.addLocalPlacement(this.worldPlacementId, {
+            Location: params.Position,
+        });
+        // Centered profile — column base center = Position
+        const profileId = this.addRectangleProfile(params.Width, params.Depth);
+        const solidId = this.addExtrudedAreaSolid(profileId, params.Height);
+        const shapeId = this.addShapeRepresentation('Body', [solidId]);
+        const prodShapeId = this.addProductDefinitionShape([shapeId]);
+        const colId = this.id();
+        const globalId = newGlobalId();
+        const name = params.Name ?? 'Column';
+        const desc = params.Description ? `'${esc(params.Description)}'` : '$';
+        const objType = params.ObjectType ? `'${esc(params.ObjectType)}'` : '$';
+        const tag = params.Tag ? `'${esc(params.Tag)}'` : '$';
+        this.line(colId, 'IFCCOLUMN', `'${globalId}',#${this.ownerHistoryId},'${esc(name)}',${desc},${objType},#${placementId},#${prodShapeId},${tag},.COLUMN.`);
+        this.elementSolids.set(colId, [solidId]);
+        this.trackElement(storeyId, colId);
+        this.entities.push({ expressId: colId, type: 'IfcColumn', Name: name });
+        return colId;
+    }
+    /**
+     * Create a beam from Start to End.
+     * Cross-section (Width × Height) centered on the beam axis.
+     */
+    addIfcBeam(storeyId, params) {
+        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 beamLen = Math.sqrt(dx * dx + dy * dy + dz * dz);
+        const dir = vecNorm([dx, dy, dz]);
+        // Local Z = beam direction, so extrusion along Z = along beam.
+        // Local X, Y define the cross-section plane.
+        const placementId = this.addLocalPlacement(this.worldPlacementId, {
+            Location: params.Start,
+            Axis: dir,
+            RefDirection: this.computeRefDirection(dir),
+        });
+        // Centered cross-section
+        const profileId = this.addRectangleProfile(params.Width, params.Height);
+        const solidId = this.addExtrudedAreaSolid(profileId, beamLen);
+        const shapeId = this.addShapeRepresentation('Body', [solidId]);
+        const prodShapeId = this.addProductDefinitionShape([shapeId]);
+        const beamId = this.id();
+        const globalId = newGlobalId();
+        const name = params.Name ?? 'Beam';
+        const desc = params.Description ? `'${esc(params.Description)}'` : '$';
+        const objType = params.ObjectType ? `'${esc(params.ObjectType)}'` : '$';
+        const tag = params.Tag ? `'${esc(params.Tag)}'` : '$';
+        this.line(beamId, 'IFCBEAM', `'${globalId}',#${this.ownerHistoryId},'${esc(name)}',${desc},${objType},#${placementId},#${prodShapeId},${tag},.BEAM.`);
+        this.elementSolids.set(beamId, [solidId]);
+        this.trackElement(storeyId, beamId);
+        this.entities.push({ expressId: beamId, type: 'IfcBeam', Name: name });
+        return beamId;
+    }
+    /**
+     * Create a straight-run stair.
+     * Position is the nose of the first tread. Treads advance along local +X
+     * (rotated into world space by Direction). Width extends along local +Y.
+     */
+    addIfcStair(storeyId, params) {
+        if (params.NumberOfRisers <= 0)
+            throw new Error('addStair: NumberOfRisers must be > 0');
+        if (params.RiserHeight <= 0)
+            throw new Error('addStair: RiserHeight must be > 0');
+        if (params.TreadLength <= 0)
+            throw new Error('addStair: TreadLength must be > 0');
+        if (params.Width <= 0)
+            throw new Error('addStair: Width must be > 0');
+        const direction = params.Direction ?? 0;
+        // Use LocalPlacement rotation so both step positions AND profiles rotate together
+        const placementId = this.addLocalPlacement(this.worldPlacementId, {
+            Location: params.Position,
+            RefDirection: direction !== 0 ? [Math.cos(direction), Math.sin(direction), 0] : undefined,
+        });
+        const stepSolids = [];
+        for (let i = 0; i < params.NumberOfRisers; i++) {
+            // Steps in stair-local coordinates: +X = run direction, +Z = up
+            const stepOriginId = this.addCartesianPoint([
+                i * params.TreadLength,
+                0,
+                i * params.RiserHeight,
+            ]);
+            const stepAxis2Id = this.addAxis2Placement3D(stepOriginId);
+            // Profile: TreadLength along local X, Width along local Y, offset from origin corner
+            const profileId = this.addRectangleProfile(params.TreadLength, params.Width, [params.TreadLength / 2, params.Width / 2]);
+            const solidId = this.id();
+            this.line(solidId, 'IFCEXTRUDEDAREASOLID', `#${profileId},#${stepAxis2Id},#${this.dirZ},${num(params.RiserHeight)}`);
+            stepSolids.push(solidId);
+        }
+        const shapeId = this.addShapeRepresentation('Body', stepSolids);
+        const prodShapeId = this.addProductDefinitionShape([shapeId]);
+        const stairId = this.id();
+        const globalId = newGlobalId();
+        const name = params.Name ?? 'Stair';
+        const desc = params.Description ? `'${esc(params.Description)}'` : '$';
+        const objType = params.ObjectType ? `'${esc(params.ObjectType)}'` : '$';
+        const tag = params.Tag ? `'${esc(params.Tag)}'` : '$';
+        this.line(stairId, 'IFCSTAIR', `'${globalId}',#${this.ownerHistoryId},'${esc(name)}',${desc},${objType},#${placementId},#${prodShapeId},${tag},.STRAIGHT_RUN_STAIR.`);
+        this.elementSolids.set(stairId, [...stepSolids]);
+        this.trackElement(storeyId, stairId);
+        this.entities.push({ expressId: stairId, type: 'IfcStair', Name: name });
+        return stairId;
+    }
+    /**
+     * Create a roof. Position is the minimum corner.
+     * Width along +X, Depth along +Y, Thickness extruded upward.
+     * Optional Slope rotates the extrusion around the Y axis.
+     */
+    addIfcRoof(storeyId, params) {
+        const slope = params.Slope ?? 0;
+        let axis = [0, 0, 1];
+        let refDir = [1, 0, 0];
+        if (slope > 0) {
+            axis = [Math.sin(slope), 0, Math.cos(slope)];
+            refDir = [Math.cos(slope), 0, -Math.sin(slope)];
+        }
+        const placementId = this.addLocalPlacement(this.worldPlacementId, {
+            Location: params.Position,
+            Axis: axis,
+            RefDirection: refDir,
+        });
+        // Profile from corner, like slab
+        const profileId = this.addRectangleProfile(params.Width, params.Depth, [params.Width / 2, params.Depth / 2]);
+        const solidId = this.addExtrudedAreaSolid(profileId, params.Thickness);
+        const shapeId = this.addShapeRepresentation('Body', [solidId]);
+        const prodShapeId = this.addProductDefinitionShape([shapeId]);
+        const roofId = this.id();
+        const globalId = newGlobalId();
+        const name = params.Name ?? 'Roof';
+        const desc = params.Description ? `'${esc(params.Description)}'` : '$';
+        const objType = params.ObjectType ? `'${esc(params.ObjectType)}'` : '$';
+        const tag = params.Tag ? `'${esc(params.Tag)}'` : '$';
+        this.line(roofId, 'IFCROOF', `'${globalId}',#${this.ownerHistoryId},'${esc(name)}',${desc},${objType},#${placementId},#${prodShapeId},${tag},.FLAT_ROOF.`);
+        this.elementSolids.set(roofId, [solidId]);
+        this.trackElement(storeyId, roofId);
+        this.entities.push({ expressId: roofId, type: 'IfcRoof', Name: name });
+        return roofId;
+    }
+    // ============================================================================
+    // Public API — Properties & Quantities
+    // ============================================================================
+    /** Attach a property set to an element */
+    addIfcPropertySet(elementId, pset) {
+        const propIds = [];
+        for (const prop of pset.Properties) {
+            const propId = this.id();
+            const valueStr = this.serializePropertyValue(prop);
+            this.line(propId, 'IFCPROPERTYSINGLEVALUE', `'${esc(prop.Name)}',$,${valueStr},$`);
+            propIds.push(propId);
+        }
+        const psetId = this.id();
+        const globalId = newGlobalId();
+        const refs = propIds.map(id => `#${id}`).join(',');
+        this.line(psetId, 'IFCPROPERTYSET', `'${globalId}',#${this.ownerHistoryId},'${esc(pset.Name)}',$,(${refs})`);
+        const relId = this.id();
+        const relGlobalId = newGlobalId();
+        this.line(relId, 'IFCRELDEFINESBYPROPERTIES', `'${relGlobalId}',#${this.ownerHistoryId},$,$,(#${elementId}),#${psetId}`);
+        return psetId;
+    }
+    /** Attach element quantities to an element */
+    addIfcElementQuantity(elementId, qset) {
+        const qtyIds = [];
+        for (const qty of qset.Quantities) {
+            const qtyId = this.id();
+            const valueField = this.quantityValueField(qty);
+            this.line(qtyId, qty.Kind.toUpperCase(), `'${esc(qty.Name)}',$,${valueField}`);
+            qtyIds.push(qtyId);
+        }
+        const qsetId = this.id();
+        const globalId = newGlobalId();
+        const refs = qtyIds.map(id => `#${id}`).join(',');
+        this.line(qsetId, 'IFCELEMENTQUANTITY', `'${globalId}',#${this.ownerHistoryId},'${esc(qset.Name)}',$,$,(${refs})`);
+        const relId = this.id();
+        const relGlobalId = newGlobalId();
+        this.line(relId, 'IFCRELDEFINESBYPROPERTIES', `'${relGlobalId}',#${this.ownerHistoryId},$,$,(#${elementId}),#${qsetId}`);
+        return qsetId;
+    }
+    // ============================================================================
+    // Public API — Styling
+    // ============================================================================
+    /**
+     * Assign a named colour to an element. Call before toIfc().
+     * Elements without a custom colour get the default grey.
+     *
+     * @param elementId The expressId returned by addWall/addSlab/…
+     * @param name      Material name shown in IFC viewers (e.g. 'Concrete')
+     * @param rgb       [r, g, b] each 0‒1
+     */
+    setColor(elementId, name, rgb) {
+        this.elementColors.set(elementId, { name, rgb });
+    }
+    // ============================================================================
+    // Public API — Materials
+    // ============================================================================
+    /**
+     * Assign an IFC material to an element. Creates proper IfcMaterial entities
+     * and links them via IfcRelAssociatesMaterial during finalization.
+     *
+     * Simple material:   `{ Name: 'Concrete', Category: 'Structural' }`
+     * Layered material:  `{ Name: 'Wall Assembly', Layers: [{ Name: 'Concrete', Thickness: 0.2 }, …] }`
+     */
+    addIfcMaterial(elementId, def) {
+        let materialRefId;
+        if (def.Layers && def.Layers.length > 0) {
+            // IfcMaterialLayerSet path
+            const layerIds = [];
+            for (const layer of def.Layers) {
+                const matId = this.getOrCreateMaterial(layer.Name, layer.Category);
+                const layerId = this.id();
+                const ventilated = layer.IsVentilated ? '.T.' : '.F.';
+                const layerName = `'${esc(layer.Name)}'`;
+                const layerCategory = layer.Category ? `'${esc(layer.Category)}'` : '$';
+                // IFC4: Material, LayerThickness, IsVentilated, Name, Description, Category, Priority
+                this.line(layerId, 'IFCMATERIALLAYER', `#${matId},${num(layer.Thickness)},${ventilated},${layerName},$,${layerCategory},$`);
+                layerIds.push(layerId);
+            }
+            const layerRefs = layerIds.map(id => `#${id}`).join(',');
+            materialRefId = this.id();
+            // IFC4: MaterialLayers, LayerSetName, Description
+            this.line(materialRefId, 'IFCMATERIALLAYERSET', `(${layerRefs}),'${esc(def.Name)}',$`);
+        }
+        else {
+            // Simple IfcMaterial
+            materialRefId = this.getOrCreateMaterial(def.Name, def.Category);
+        }
+        this.elementMaterials.set(elementId, materialRefId);
+    }
+    // ============================================================================
+    // Public API — Export
+    // ============================================================================
+    /** Generate the complete IFC STEP file. May only be called once. */
+    toIfc() {
+        if (this.finalized)
+            throw new Error('toIfc() has already been called — creator is not reusable');
+        this.finalized = true;
+        this.finalizeStyles();
+        this.finalizeMaterials();
+        this.finalizeRelationships();
+        const header = this.buildHeader();
+        const data = this.lines.join('\n');
+        const content = `${header}DATA;\n${data}\nENDSEC;\nEND-ISO-10303-21;\n`;
+        return {
+            content,
+            entities: [...this.entities],
+            stats: {
+                entityCount: this.lines.length,
+                fileSize: new TextEncoder().encode(content).length,
+            },
+        };
+    }
+    buildHeader() {
+        const now = new Date().toISOString().replace(/[-:]/g, '').split('.')[0];
+        const desc = 'Created by ifc-lite';
+        const author = this.projectParams.Author ?? '';
+        const org = this.projectParams.Organization ?? '';
+        const app = 'ifc-lite';
+        const filename = 'created.ifc';
+        return `ISO-10303-21;
+HEADER;
+FILE_DESCRIPTION(('${esc(desc)}'),'2;1');
+FILE_NAME('${filename}','${now}',('${esc(author)}'),('${esc(org)}'),'${app}','${app}','');
+FILE_SCHEMA(('${this.schema}'));
+ENDSEC;
+`;
+    }
+    // ============================================================================
+    // Internal — Preamble (project, site, building, contexts, units, style)
+    // ============================================================================
+    buildPreamble(params) {
+        const personId = this.id();
+        this.line(personId, 'IFCPERSON', "$,$,'',$,$,$,$,$");
+        const orgId = this.id();
+        this.line(orgId, 'IFCORGANIZATION', `$,'${esc(params.Organization ?? 'ifc-lite')}',$,$,$`);
+        const personOrgId = this.id();
+        this.line(personOrgId, 'IFCPERSONANDORGANIZATION', `#${personId},#${orgId},$`);
+        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);
+        this.line(this.ownerHistoryId, 'IFCOWNERHISTORY', `#${personOrgId},#${appId},$,.NOCHANGE.,$,$,$,${timestamp}`);
+        // Shared geometry primitives
+        this.originId = this.addCartesianPoint([0, 0, 0]);
+        this.dirZ = this.addDirection([0, 0, 1]);
+        this.dirX = this.addDirection([1, 0, 0]);
+        // World coordinate placement
+        const worldAxisId = this.id();
+        this.line(worldAxisId, 'IFCAXIS2PLACEMENT3D', `#${this.originId},#${this.dirZ},#${this.dirX}`);
+        this.worldPlacementId = this.id();
+        this.line(this.worldPlacementId, 'IFCLOCALPLACEMENT', `$,#${worldAxisId}`);
+        // Geometric representation context
+        this.contextId = this.id();
+        this.line(this.contextId, 'IFCGEOMETRICREPRESENTATIONCONTEXT', `$,'Model',3,1.0E-5,#${worldAxisId},$`);
+        this.subContextBody = this.id();
+        this.line(this.subContextBody, 'IFCGEOMETRICREPRESENTATIONSUBCONTEXT', `$,'Body',*,*,*,*,#${this.contextId},$,.MODEL_VIEW.,$`);
+        this.subContextAxis = this.id();
+        this.line(this.subContextAxis, 'IFCGEOMETRICREPRESENTATIONSUBCONTEXT', `$,'Axis',*,*,*,*,#${this.contextId},$,.GRAPH_VIEW.,$`);
+        // Units
+        this.unitAssignmentId = this.buildUnits(params.LengthUnit ?? 'METRE');
+        // Default surface style — light grey with some specularity
+        this.defaultStyleId = this.buildDefaultStyle();
+        // IfcProject
+        this.projectId = this.id();
+        const projectGlobalId = newGlobalId();
+        const projectName = params.Name ?? 'Project';
+        const projectDesc = params.Description ? `'${esc(params.Description)}'` : '$';
+        this.line(this.projectId, 'IFCPROJECT', `'${projectGlobalId}',#${this.ownerHistoryId},'${esc(projectName)}',${projectDesc},$,$,$,(#${this.contextId}),#${this.unitAssignmentId}`);
+        this.entities.push({ expressId: this.projectId, type: 'IfcProject', Name: projectName });
+        // IfcSite
+        this.siteId = this.id();
+        const siteGlobalId = newGlobalId();
+        this.line(this.siteId, 'IFCSITE', `'${siteGlobalId}',#${this.ownerHistoryId},'Site',$,$,#${this.worldPlacementId},$,$,.ELEMENT.,$,$,$,$,$`);
+        this.entities.push({ expressId: this.siteId, type: 'IfcSite', Name: 'Site' });
+        // IfcBuilding
+        this.buildingId = this.id();
+        const buildingGlobalId = newGlobalId();
+        this.line(this.buildingId, 'IFCBUILDING', `'${buildingGlobalId}',#${this.ownerHistoryId},'Building',$,$,#${this.worldPlacementId},$,$,.ELEMENT.,$,$,$`);
+        this.entities.push({ expressId: this.buildingId, type: 'IfcBuilding', Name: 'Building' });
+    }
+    buildUnits(lengthUnit) {
+        const dimExpId = this.id();
+        this.line(dimExpId, 'IFCDIMENSIONALEXPONENTS', '0,0,0,0,0,0,0');
+        const siLengthId = this.id();
+        this.line(siLengthId, 'IFCSIUNIT', `*,.LENGTHUNIT.,$,.METRE.`);
+        let lengthUnitId = siLengthId;
+        if (lengthUnit === 'MILLIMETRE') {
+            const prefixId = this.id();
+            this.line(prefixId, 'IFCSIUNIT', `*,.LENGTHUNIT.,.MILLI.,.METRE.`);
+            lengthUnitId = prefixId;
+        }
+        const siAreaId = this.id();
+        this.line(siAreaId, 'IFCSIUNIT', `*,.AREAUNIT.,$,.SQUARE_METRE.`);
+        const siVolumeId = this.id();
+        this.line(siVolumeId, 'IFCSIUNIT', `*,.VOLUMEUNIT.,$,.CUBIC_METRE.`);
+        const siAngleId = this.id();
+        this.line(siAngleId, 'IFCSIUNIT', `*,.PLANEANGLEUNIT.,$,.RADIAN.`);
+        const assignmentId = this.id();
+        this.line(assignmentId, 'IFCUNITASSIGNMENT', `(#${lengthUnitId},#${siAreaId},#${siVolumeId},#${siAngleId})`);
+        return assignmentId;
+    }
+    /** Create a default IfcSurfaceStyle with a neutral colour (RGB 0.75, 0.73, 0.68) */
+    buildDefaultStyle() {
+        // IfcColourRgb — warm concrete grey
+        const colourId = this.id();
+        this.line(colourId, 'IFCCOLOURRGB', `$,0.75,0.73,0.68`);
+        // IfcSurfaceStyleRendering — surface + specular
+        const renderingId = this.id();
+        this.line(renderingId, 'IFCSURFACESTYLERENDERING', `#${colourId},0.,$,$,$,$,IFCNORMALISEDRATIOMEASURE(0.5),IFCSPECULAREXPONENT(64.),.NOTDEFINED.`);
+        // IfcSurfaceStyle
+        const styleId = this.id();
+        this.line(styleId, 'IFCSURFACESTYLE', `'Default',.BOTH.,(#${renderingId})`);
+        return styleId;
+    }
+    /** Create all IfcStyledItem entities — custom colour or default per element */
+    finalizeStyles() {
+        // Cache: colour key → styleId so identical colours share one style entity
+        const styleCache = new Map();
+        for (const [elementId, solidIds] of this.elementSolids) {
+            const color = this.elementColors.get(elementId);
+            let styleId;
+            if (color) {
+                const key = `${color.name}|${color.rgb.join(',')}`;
+                const cached = styleCache.get(key);
+                if (cached !== undefined) {
+                    styleId = cached;
+                }
+                else {
+                    styleId = this.buildColorStyle(color.name, color.rgb);
+                    styleCache.set(key, styleId);
+                }
+            }
+            else {
+                styleId = this.defaultStyleId;
+            }
+            for (const solidId of solidIds) {
+                const styledItemId = this.id();
+                this.line(styledItemId, 'IFCSTYLEDITEM', `#${solidId},(#${styleId}),$`);
+            }
+        }
+    }
+    /** Create a named IfcSurfaceStyle with the given RGB colour */
+    buildColorStyle(name, rgb) {
+        const colourId = this.id();
+        this.line(colourId, 'IFCCOLOURRGB', `$,${num(rgb[0])},${num(rgb[1])},${num(rgb[2])}`);
+        const renderingId = this.id();
+        this.line(renderingId, 'IFCSURFACESTYLERENDERING', `#${colourId},0.,$,$,$,$,IFCNORMALISEDRATIOMEASURE(0.5),IFCSPECULAREXPONENT(64.),.NOTDEFINED.`);
+        const styleId = this.id();
+        this.line(styleId, 'IFCSURFACESTYLE', `'${esc(name)}',.BOTH.,(#${renderingId})`);
+        return styleId;
+    }
+    // ============================================================================
+    // Internal — Material helpers
+    // ============================================================================
+    /** Get or create a shared IfcMaterial entity (IFC4: Name, Description, Category) */
+    getOrCreateMaterial(name, category) {
+        const cached = this.materialCache.get(name);
+        if (cached !== undefined)
+            return cached;
+        const matId = this.id();
+        const cat = category ? `'${esc(category)}'` : '$';
+        this.line(matId, 'IFCMATERIAL', `'${esc(name)}',$,${cat}`);
+        this.materialCache.set(name, matId);
+        return matId;
+    }
+    /** Create IfcRelAssociatesMaterial entities — one per unique material ref (batched) */
+    finalizeMaterials() {
+        // Group elements by materialRefId so elements sharing a material get one rel
+        const groups = new Map();
+        for (const [elementId, materialRefId] of this.elementMaterials) {
+            const group = groups.get(materialRefId);
+            if (group)
+                group.push(elementId);
+            else
+                groups.set(materialRefId, [elementId]);
+        }
+        for (const [materialRefId, elementIds] of groups) {
+            const relId = this.id();
+            const globalId = newGlobalId();
+            const refs = elementIds.map(id => `#${id}`).join(',');
+            this.line(relId, 'IFCRELASSOCIATESMATERIAL', `'${globalId}',#${this.ownerHistoryId},$,$,(${refs}),#${materialRefId}`);
+        }
+    }
+    // ============================================================================
+    // Internal — Geometry helpers
+    // ============================================================================
+    addCartesianPoint(p) {
+        const id = this.id();
+        this.line(id, 'IFCCARTESIANPOINT', `(${num(p[0])},${num(p[1])},${num(p[2])})`);
+        return id;
+    }
+    addCartesianPoint2D(p) {
+        const id = this.id();
+        this.line(id, 'IFCCARTESIANPOINT', `(${num(p[0])},${num(p[1])})`);
+        return id;
+    }
+    addDirection(d) {
+        const id = this.id();
+        this.line(id, 'IFCDIRECTION', `(${num(d[0])},${num(d[1])},${num(d[2])})`);
+        return id;
+    }
+    addAxis2Placement3D(originId, axisId, refDirId) {
+        const id = this.id();
+        const axis = axisId ? `#${axisId}` : '$';
+        const refDir = refDirId ? `#${refDirId}` : '$';
+        this.line(id, 'IFCAXIS2PLACEMENT3D', `#${originId},${axis},${refDir}`);
+        return id;
+    }
+    addLocalPlacement(relativeTo, placement) {
+        const originId = this.addCartesianPoint(placement.Location);
+        let axisId;
+        let refDirId;
+        if (placement.Axis) {
+            axisId = this.addDirection(placement.Axis);
+        }
+        if (placement.RefDirection) {
+            refDirId = this.addDirection(placement.RefDirection);
+        }
+        const axis2Id = this.addAxis2Placement3D(originId, axisId, refDirId);
+        const id = this.id();
+        this.line(id, 'IFCLOCALPLACEMENT', `#${relativeTo},#${axis2Id}`);
+        return id;
+    }
+    /**
+     * Create a rectangle profile.
+     * @param xDim Width of rectangle
+     * @param yDim Height of rectangle
+     * @param center Optional 2D offset for the profile centre. Default [0,0] = centred at origin.
+     */
+    addRectangleProfile(xDim, yDim, center) {
+        const cx = center?.[0] ?? 0;
+        const cy = center?.[1] ?? 0;
+        const profileOriginId = this.addCartesianPoint2D([cx, cy]);
+        const profileAxis2dId = this.id();
+        this.line(profileAxis2dId, 'IFCAXIS2PLACEMENT2D', `#${profileOriginId},$`);
+        const id = this.id();
+        this.line(id, 'IFCRECTANGLEPROFILEDEF', `.AREA.,$,#${profileAxis2dId},${num(xDim)},${num(yDim)}`);
+        return id;
+    }
+    addArbitraryProfile(points) {
+        const pointIds = points.map(p => this.addCartesianPoint2D(p));
+        if (points.length > 0) {
+            pointIds.push(pointIds[0]); // close the polyline
+        }
+        const refs = pointIds.map(id => `#${id}`).join(',');
+        const polylineId = this.id();
+        this.line(polylineId, 'IFCPOLYLINE', `(${refs})`);
+        const id = this.id();
+        this.line(id, 'IFCARBITRARYCLOSEDPROFILEDEF', `.AREA.,$,#${polylineId}`);
+        return id;
+    }
+    addExtrudedAreaSolid(profileId, depth, extrusionDir) {
+        const originId = this.addCartesianPoint([0, 0, 0]);
+        const axis2Id = this.addAxis2Placement3D(originId);
+        const dirRef = extrusionDir ?? this.dirZ;
+        const id = this.id();
+        this.line(id, 'IFCEXTRUDEDAREASOLID', `#${profileId},#${axis2Id},#${dirRef},${num(depth)}`);
+        return id;
+    }
+    addShapeRepresentation(repType, itemIds) {
+        const contextRef = repType === 'Axis' ? this.subContextAxis : this.subContextBody;
+        const refs = itemIds.map(id => `#${id}`).join(',');
+        const repId = this.id();
+        const repIdentifier = repType === 'Axis' ? 'Axis' : 'Body';
+        const repTypeName = itemIds.length > 1 ? 'SolidModel' : 'SweptSolid';
+        this.line(repId, 'IFCSHAPEREPRESENTATION', `#${contextRef},'${repIdentifier}','${repTypeName}',(${refs})`);
+        return repId;
+    }
+    addProductDefinitionShape(repIds) {
+        const refs = repIds.map(id => `#${id}`).join(',');
+        const id = this.id();
+        this.line(id, 'IFCPRODUCTDEFINITIONSHAPE', `$,$,(${refs})`);
+        return id;
+    }
+    // ============================================================================
+    // Internal — Openings
+    // ============================================================================
+    /**
+     * Add an opening in a wall.
+     * Opening Position: [distance_along_wall, 0, sill_height]
+     * The opening extrudes through the wall perpendicular to its face (local Y).
+     */
+    addWallOpening(hostId, hostPlacementId, opening, wallThickness) {
+        // In wall local CS: X = along wall, Y = thickness, Z = up.
+        // Opening needs to cut through the wall in the Y direction.
+        // So we orient the opening's local Z = wall's local Y = [0,1,0],
+        // and opening's local X = wall's local X = [1,0,0].
+        // Opening local Y then = cross(Z,X) = cross([0,1,0],[1,0,0]) = [0,0,-1].
+        // To get Y pointing up, flip: Axis = [0,-1,0].
+        // Then: local X = [1,0,0], local Y = cross([0,-1,0],[1,0,0]) = [0,0,1], local Z = [0,-1,0].
+        // Profile XY: X = along wall (Width), Y = up (Height). Extrusion Z = through wall.
+        // Offset Y so extrusion starts just outside the +Y face and cuts clean through
+        const openingOriginId = this.addCartesianPoint([
+            opening.Position[0],
+            wallThickness / 2 + 0.05,
+            opening.Position[2],
+        ]);
+        const openingAxisId = this.addDirection([0, -1, 0]);
+        const openingRefDirId = this.addDirection([1, 0, 0]);
+        const openingAxis2Id = this.addAxis2Placement3D(openingOriginId, openingAxisId, openingRefDirId);
+        const openingPlacementId = this.id();
+        this.line(openingPlacementId, 'IFCLOCALPLACEMENT', `#${hostPlacementId},#${openingAxis2Id}`);
+        // Profile: Width along wall (X), Height upward (Y), centered on position.
+        // Extrude through wall thickness + margin.
+        const profileId = this.addRectangleProfile(opening.Width, opening.Height, [0, opening.Height / 2]);
+        const extrusionDepth = wallThickness + 0.1; // enough to cut clean through
+        const solidId = this.addExtrudedAreaSolid(profileId, extrusionDepth);
+        const shapeId = this.addShapeRepresentation('Body', [solidId]);
+        const prodShapeId = this.addProductDefinitionShape([shapeId]);
+        const openingId = this.id();
+        const globalId = newGlobalId();
+        const name = opening.Name ?? 'Opening';
+        this.line(openingId, 'IFCOPENINGELEMENT', `'${globalId}',#${this.ownerHistoryId},'${esc(name)}',$,$,#${openingPlacementId},#${prodShapeId},$,.OPENING.`);
+        const relId = this.id();
+        const relGlobalId = newGlobalId();
+        this.line(relId, 'IFCRELVOIDSELEMENT', `'${relGlobalId}',#${this.ownerHistoryId},$,$,#${hostId},#${openingId}`);
+        this.entities.push({ expressId: openingId, type: 'IfcOpeningElement', Name: name });
+        return openingId;
+    }
+    /**
+     * Add an opening in a slab.
+     * Opening Position: [x_offset, y_offset, 0] relative to slab placement.
+     * The opening extrudes through the slab along Z.
+     */
+    addSlabOpening(hostId, hostPlacementId, opening, slabThickness) {
+        const placementId = this.addLocalPlacement(hostPlacementId, {
+            Location: opening.Position,
+        });
+        const profileId = this.addRectangleProfile(opening.Width, opening.Height);
+        const extrusionDepth = slabThickness + 0.1; // enough to cut clean through
+        const solidId = this.addExtrudedAreaSolid(profileId, extrusionDepth);
+        const shapeId = this.addShapeRepresentation('Body', [solidId]);
+        const prodShapeId = this.addProductDefinitionShape([shapeId]);
+        const openingId = this.id();
+        const globalId = newGlobalId();
+        const name = opening.Name ?? 'Opening';
+        this.line(openingId, 'IFCOPENINGELEMENT', `'${globalId}',#${this.ownerHistoryId},'${esc(name)}',$,$,#${placementId},#${prodShapeId},$,.OPENING.`);
+        const relId = this.id();
+        const relGlobalId = newGlobalId();
+        this.line(relId, 'IFCRELVOIDSELEMENT', `'${relGlobalId}',#${this.ownerHistoryId},$,$,#${hostId},#${openingId}`);
+        this.entities.push({ expressId: openingId, type: 'IfcOpeningElement', Name: name });
+        return openingId;
+    }
+    // ============================================================================
+    // Internal — Property/quantity serialization
+    // ============================================================================
+    serializePropertyValue(prop) {
+        const val = prop.NominalValue;
+        if (typeof val === 'string') {
+            const typeName = prop.Type ?? 'IfcLabel';
+            return `${typeName.toUpperCase()}('${esc(val)}')`;
+        }
+        if (typeof val === 'number') {
+            const typeName = prop.Type ?? (Number.isInteger(val) ? 'IfcInteger' : 'IfcReal');
+            if (typeName === 'IfcInteger') {
+                return `IFCINTEGER(${Math.round(val)})`;
+            }
+            return `IFCREAL(${num(val)})`;
+        }
+        if (typeof val === 'boolean') {
+            return `IFCBOOLEAN(${val ? '.T.' : '.F.'})`;
+        }
+        return '$';
+    }
+    quantityValueField(qty) {
+        switch (qty.Kind) {
+            case 'IfcQuantityLength':
+            case 'IfcQuantityArea':
+            case 'IfcQuantityVolume':
+            case 'IfcQuantityWeight':
+                return `$,${num(qty.Value)}`;
+            case 'IfcQuantityCount':
+                return `$,${Math.round(qty.Value)}`;
+            default:
+                return `$,${num(qty.Value)}`;
+        }
+    }
+    // ============================================================================
+    // Internal — Relationship finalization
+    // ============================================================================
+    finalizeRelationships() {
+        this.addIfcRelAggregates(this.projectId, [this.siteId]);
+        this.addIfcRelAggregates(this.siteId, [this.buildingId]);
+        if (this.storeyIds.length > 0) {
+            this.addIfcRelAggregates(this.buildingId, this.storeyIds);
+        }
+        for (const [storeyId, elementIds] of this.storeyElements) {
+            if (elementIds.length > 0) {
+                this.addIfcRelContainedInSpatialStructure(storeyId, elementIds);
+            }
+        }
+    }
+    addIfcRelAggregates(relatingId, relatedIds) {
+        const relId = this.id();
+        const globalId = newGlobalId();
+        const refs = relatedIds.map(id => `#${id}`).join(',');
+        this.line(relId, 'IFCRELAGGREGATES', `'${globalId}',#${this.ownerHistoryId},$,$,#${relatingId},(${refs})`);
+    }
+    addIfcRelContainedInSpatialStructure(storeyId, elementIds) {
+        const relId = this.id();
+        const globalId = newGlobalId();
+        const refs = elementIds.map(id => `#${id}`).join(',');
+        this.line(relId, 'IFCRELCONTAINEDINSPATIALSTRUCTURE', `'${globalId}',#${this.ownerHistoryId},$,$,(${refs}),#${storeyId}`);
+    }
+    // ============================================================================
+    // Internal — Utilities
+    // ============================================================================
+    id() {
+        return this.nextId++;
+    }
+    line(id, type, args) {
+        this.lines.push(stepLine(id, type, args));
+    }
+    trackElement(storeyId, elementId) {
+        const elements = this.storeyElements.get(storeyId);
+        if (!elements) {
+            throw new Error(`Unknown storeyId #${storeyId} — call addIfcBuildingStorey() first`);
+        }
+        elements.push(elementId);
+    }
+    /** Compute a stable RefDirection perpendicular to a given Axis */
+    computeRefDirection(axis) {
+        const up = Math.abs(axis[2]) < 0.9 ? [0, 0, 1] : [1, 0, 0];
+        const cross = vecCross(up, axis);
+        return vecNorm(cross);
+    }
+}
+//# sourceMappingURL=ifc-creator.js.map