@ifc-lite/create 1.14.4 → 1.15.0

package/dist/in-store/duplicate.js

@@ -0,0 +1,122 @@
+/* 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/. */
+/**
+ * Duplicate an existing IfcRoot product in place via the StoreEditor
+ * overlay. Geometry is shared (the new entity points at the source's
+ * Representation by reference), and the new placement is offset from
+ * the source's so the duplicate is visible — the user can refine the
+ * position via Raw STEP editing or, in a future PR, a place-mode
+ * cursor flow.
+ *
+ * What lands in the overlay (4 new entities + 1 new spatial rel):
+ *   1. IfcCartesianPoint — the new world position
+ *   2. IfcAxis2Placement3D — wraps the new point, reuses source axes
+ *   3. IfcLocalPlacement — chains to the source's parent placement
+ *   4. {SourceType} — new GUID + new placement, same Representation ref
+ *   5. IfcRelContainedInSpatialStructure — anchors the new entity to
+ *      the same storey the source belongs to (or skipped if the
+ *      source isn't spatially contained)
+ *
+ * The function is pure — no I/O, no parser access. It accepts the
+ * already-extracted source attributes and does the bookkeeping.
+ */
+import { generateIfcGuid } from '@ifc-lite/encoding';
+/**
+ * Emit a duplicate of the source product into the editor overlay.
+ * Returns the new expressIds. Throws if the source attributes don't
+ * have at least 7 slots (the minimum IfcProduct surface).
+ */
+export function duplicateInStore(editor, source, options = {}) {
+    if (source.attributes.length < 7) {
+        throw new Error(`duplicateInStore: source has ${source.attributes.length} attributes, need ≥7 for an IfcProduct`);
+    }
+    const offset = options.offset ?? [1, 0, 0];
+    const newLocation = [
+        source.sourceLocation[0] + offset[0],
+        source.sourceLocation[1] + offset[1],
+        source.sourceLocation[2] + offset[2],
+    ];
+    // 1. New IfcCartesianPoint at the offset position.
+    const point = editor.addEntity('IfcCartesianPoint', [
+        [newLocation[0], newLocation[1], newLocation[2]],
+    ]);
+    // 2. New IfcAxis2Placement3D wrapping the new point. Reuse source
+    //    axis + ref-direction so the duplicate keeps the source's
+    //    rotation. The two ref args are passed through as the verbatim
+    //    STEP tokens captured at extraction time (`"#N"` or `"$"`).
+    const axisPlacement = editor.addEntity('IfcAxis2Placement3D', [
+        `#${point.expressId}`,
+        source.axisRef,
+        source.refDirectionRef,
+    ]);
+    // 3. New IfcLocalPlacement chained to the source's parent (or `$`
+    //    if the source sat at the spatial root).
+    const placement = editor.addEntity('IfcLocalPlacement', [
+        source.parentPlacementId !== null ? `#${source.parentPlacementId}` : null,
+        `#${axisPlacement.expressId}`,
+    ]);
+    // 4. The duplicate IfcRoot. New GUID; new ObjectPlacement; same
+    //    Representation reference (geometry shared); name suffix unless
+    //    the caller provided one.
+    const sourceName = source.attributes[2];
+    const duplicateName = options.name !== undefined
+        ? options.name
+        : (typeof sourceName === 'string' && sourceName.length > 0
+            ? `${sourceName} (copy)`
+            : sourceName);
+    const cloned = source.attributes.slice();
+    cloned[0] = generateIfcGuid(); // GlobalId
+    cloned[1] = source.ownerHistoryId !== null
+        ? `#${source.ownerHistoryId}`
+        : null; // OwnerHistory (preserved; null when source omitted it)
+    cloned[2] = duplicateName; // Name
+    cloned[5] = `#${placement.expressId}`; // ObjectPlacement
+    // cloned[6] (Representation) intentionally untouched — share geometry.
+    // cloned[7] (Tag) — leave the source tag; STEP allows duplicate tags.
+    const duplicate = editor.addEntity(source.type, cloned);
+    // 5. Optional: new IfcRelContainedInSpatialStructure anchoring the
+    //    new entity to the same storey. Skipped when the source had no
+    //    storey context.
+    let relContainedId = null;
+    if (source.storeyId !== null) {
+        const rel = editor.addEntity('IfcRelContainedInSpatialStructure', [
+            generateIfcGuid(), // GlobalId
+            source.ownerHistoryId !== null ? `#${source.ownerHistoryId}` : null, // OwnerHistory
+            null, // Name
+            null, // Description
+            [`#${duplicate.expressId}`], // RelatedElements
+            `#${source.storeyId}`, // RelatingStructure
+        ]);
+        relContainedId = rel.expressId;
+    }
+    // 6. Replay every IfcRelDefines* / IfcRelAssociates* edge that
+    //    references the source. Emits one fresh rel per association so
+    //    the duplicate carries identical psets, qsets, material,
+    //    classifications, documents, and type binding in the exported
+    //    STEP. Modifies no existing rel — each new rel has just the
+    //    duplicate in its RelatedObjects list.
+    const associationRelIds = [];
+    if (source.associations && source.associations.length > 0) {
+        for (const assoc of source.associations) {
+            const rel = editor.addEntity(assoc.relType, [
+                generateIfcGuid(), // GlobalId
+                assoc.ownerHistoryId !== null ? `#${assoc.ownerHistoryId}` : null, // OwnerHistory
+                assoc.name, // Name (parsed; may be null)
+                assoc.description, // Description
+                [`#${duplicate.expressId}`], // RelatedObjects
+                `#${assoc.relatingExpressId}`, // Relating*
+            ]);
+            associationRelIds.push(rel.expressId);
+        }
+    }
+    return {
+        newId: duplicate.expressId,
+        newPlacementId: placement.expressId,
+        newPointId: point.expressId,
+        newAxisPlacementId: axisPlacement.expressId,
+        relContainedId,
+        associationRelIds,
+    };
+}
+//# sourceMappingURL=duplicate.js.map

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

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

package/dist/in-store/extract-walls.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Pull every wall axis on a given storey from a parsed `IfcDataStore`
+ * plus an optional overlay (`MutablePropertyView`-style new-entities
+ * map). The resulting 2D segments feed `detectEnclosedAreas`.
+ *
+ * Two extraction strategies, tried in order:
+ *
+ *   1. **Axis representation** (preferred).
+ *      `IfcShapeRepresentation` with `RepresentationIdentifier = 'Axis'`
+ *      is the standard way authoring tools (Revit, ArchiCAD, etc.) ship
+ *      a wall's centreline. Items are usually `IfcPolyline` (2 points →
+ *      start, end) or `IfcTrimmedCurve` (treated as polyline endpoints).
+ *      The endpoints are read in storey-local space, walked through the
+ *      placement chain, and projected to the storey-floor plane.
+ *
+ *   2. **Body fallback — placement + IfcRectangleProfileDef.XDim**.
+ *      Matches the convention emitted by `addWallToStore` /
+ *      `IfcCreator.addIfcWall`: placement origin = wall Start,
+ *      RefDirection = wall axis, profile XDim = wall length. Used for
+ *      walls authored by the Add Element tool or anything else that
+ *      mirrors that shape.
+ *
+ * Walls that match neither shape are skipped with a recorded reason —
+ * `WallExtractionResult.skipped[]` carries `{ wallId, reason }` so
+ * callers (and the viewer's Auto Spaces UI) can surface why a wall
+ * didn't contribute to the planar graph.
+ */
+import { type IfcDataStore, type IfcAttributeValue } from '@ifc-lite/parser';
+import type { Segment } from './auto-space-detect.js';
+/**
+ * Optional overlay reader. If supplied, overlay walls (entities
+ * created via `editor.addEntity('IfcWall', ...)` since the model was
+ * parsed) are included alongside the source walls.
+ */
+export interface OverlayWallReader {
+    /** Iterate every overlay-created entity. */
+    getNewEntities(): Iterable<{
+        expressId: number;
+        type: string;
+        attributes: IfcAttributeValue[];
+    }>;
+    /** Resolve a positional attribute (with mutations applied). */
+    getAttribute?(expressId: number, index: number): IfcAttributeValue | undefined;
+}
+export type WallSkipReason = 'no-source-bytes' | 'wall-not-parsed' | 'no-placement' | 'no-representation' | 'placement-not-resolvable' | 'no-axis-or-rect-profile' | 'zero-length-axis' | 'sloped-axis';
+export interface WallSkip {
+    wallId: number;
+    reason: WallSkipReason;
+}
+export interface WallExtractionResult {
+    segments: Segment[];
+    /** Wall expressIds that contributed an axis segment. */
+    contributingWallIds: number[];
+    /** Walls dropped by the extractor, with the reason. */
+    skipped: WallSkip[];
+    /** Best-effort total wall count visible on the storey (existing + overlay). */
+    considered: number;
+    /**
+     * Length-unit scale that was applied to the extracted segments
+     * (e.g. `0.001` for a millimetre model). Reported so callers can
+     * scale their snap tolerance / min area to match.
+     */
+    lengthUnitScale: number;
+}
+export interface ExtractWallSegmentsOptions {
+    /**
+     * When true, the extractor emits `console.debug` messages for the
+     * containment scan + per-wall extraction step. Useful for diagnosing
+     * "no enclosed regions detected" in the Auto Spaces flow.
+     */
+    debug?: boolean;
+    /**
+     * Additional element types to treat as space dividers. Defaults to
+     * the standard wall set; pass extras here to broaden coverage on
+     * unusual models. Names are case-insensitive (`'IfcMember'` etc.).
+     */
+    extraDividerTypes?: string[];
+}
+export declare function extractWallSegmentsForStorey(store: IfcDataStore, storeyExpressId: number, overlay?: OverlayWallReader, options?: ExtractWallSegmentsOptions): WallExtractionResult;
+//# sourceMappingURL=extract-walls.d.ts.map

package/dist/in-store/extract-walls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-walls.d.ts","sourceRoot":"","sources":["../../src/in-store/extract-walls.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,OAAO,EAAQ,MAAM,wBAAwB,CAAC;AAE5D;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,4CAA4C;IAC5C,cAAc,IAAI,QAAQ,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,iBAAiB,EAAE,CAAA;KAAE,CAAC,CAAC;IACjG,+DAA+D;IAC/D,YAAY,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAAC;CAChF;AAED,MAAM,MAAM,cAAc,GACtB,iBAAiB,GACjB,iBAAiB,GACjB,cAAc,GACd,mBAAmB,GACnB,0BAA0B,GAC1B,yBAAyB,GACzB,kBAAkB,GAClB,aAAa,CAAC;AAElB,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,wDAAwD;IACxD,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,uDAAuD;IACvD,OAAO,EAAE,QAAQ,EAAE,CAAC;IACpB,+EAA+E;IAC/E,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,0BAA0B;IACzC;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AAuBD,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,YAAY,EACnB,eAAe,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,iBAAiB,EAC3B,OAAO,GAAE,0BAA+B,GACvC,oBAAoB,CAmFtB"}