@ifc-lite/mutations 1.14.5 → 1.15.1

package/dist/store-editor.d.ts

@@ -0,0 +1,89 @@
+/**
+ * StoreEditor — high-level facade for editing a parsed `IfcDataStore` via the
+ * `MutablePropertyView` overlay.
+ *
+ * Implements the `store.addEntity()` / `store.removeEntity()` /
+ * `store.setPositionalAttribute()` API requested in LTplus-AG/ifc-lite#592.
+ *
+ * The underlying store buffer and entity index are never mutated. Changes
+ * accumulate in the overlay and materialise during
+ * `StepExporter.export({ applyMutations })`. Overlay-created entities are
+ * visible via `getNewEntity()` / `getNewEntities()`; they are intentionally
+ * NOT inserted into `store.entityIndex.byId`, because that index may be a
+ * `CompactEntityIndex` whose backing typed arrays are immutable.
+ */
+import type { MutablePropertyView } from './mutable-property-view.js';
+import type { IfcAttributeValue, MutationEntityRef as EntityRef, MutationStoreShape as IfcDataStore, NewEntity } from './types.js';
+/** Sentinel byteOffset that flags an `EntityRef` as overlay-only (no source bytes). */
+export declare const OVERLAY_BYTE_OFFSET = -1;
+/**
+ * Schema-aware normaliser injected from outside the package.
+ *
+ * `@ifc-lite/mutations` cannot import `@ifc-lite/parser` (cycle), so
+ * the canonical-name registry isn't reachable here. The SDK / viewer
+ * boundary calls `setEntityTypeNormalizer` once at startup with the
+ * parser's `normalizeIfcTypeName` helper, and from then on every
+ * `addEntity()` call resolves to canonical PascalCase before forwarding
+ * to the overlay. Direct callers that don't wire a normalizer fall
+ * back to the lightweight regex check below — typos still surface,
+ * just without registry-grade rejection.
+ */
+export type EntityTypeNormalizer = (type: string) => string;
+/**
+ * Register the canonical-name resolver. Pass `null` to clear it (used
+ * by tests). Calling repeatedly is fine — last write wins.
+ */
+export declare function setEntityTypeNormalizer(fn: EntityTypeNormalizer | null): void;
+export declare class StoreEditor {
+    private store;
+    private view;
+    private maxExistingId;
+    constructor(store: IfcDataStore, view: MutablePropertyView);
+    /**
+     * Re-scan the store and bump the express-id watermark if the store has
+     * grown since construction (e.g. after lazy index hydration or
+     * federating in another model). Cheap to call — `MutablePropertyView`
+     * keeps the high watermark, so re-seeding with a stale value is a
+     * no-op.
+     */
+    refreshWatermark(): void;
+    /**
+     * Add a new entity to the store overlay. Returns a synthetic `EntityRef`
+     * with a freshly-allocated expressId; pass it back to other APIs (other
+     * `addEntity` calls, `setPositionalAttribute`, exporters) to reference
+     * the new record.
+     *
+     * Pass `type` as the canonical IFC EXPRESS PascalCase name
+     * (e.g. `'IfcRectangleProfileDef'`). UPPERCASE STEP tokens are also
+     * accepted — both are normalized to the same internal form.
+     *
+     * Attribute conventions (mirrors `EntityExtractor.extractEntity()` output):
+     *   - numbers → STEP integer / REAL literal
+     *   - `"#42"` → STEP entity reference
+     *   - `"'literal'"` or any plain string → quoted STEP string
+     *   - `".AREA."` (dot-wrapped) → enum
+     *   - `null` / `undefined` → `$`
+     *   - arrays → STEP list `(a,b,c)`
+     */
+    addEntity(type: string, attributes: IfcAttributeValue[]): EntityRef;
+    /**
+     * Remove an entity. Existing entities are tombstoned and skipped during
+     * export; overlay-only entities are forgotten. Returns false if the id is
+     * not known to the store or the overlay.
+     */
+    removeEntity(expressId: number): boolean;
+    /**
+     * Edit a positional STEP argument on any entity by zero-based index.
+     * Use this for non-IfcRoot edits like `IfcRectangleProfileDef.XDim`
+     * where the attribute has no symbolic name.
+     */
+    setPositionalAttribute(expressId: number, index: number, value: IfcAttributeValue): void;
+    /** Edit a named root attribute (Name, Description, ObjectType, …). */
+    setAttribute(expressId: number, attrName: string, value: string): void;
+    /** Look up the overlay record for a freshly-added entity. */
+    getNewEntity(expressId: number): NewEntity | null;
+    /** All overlay-created entities, in insertion order. */
+    getNewEntities(): NewEntity[];
+    private computeMaxExistingId;
+}
+//# sourceMappingURL=store-editor.d.ts.map

package/dist/store-editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-editor.d.ts","sourceRoot":"","sources":["../src/store-editor.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,IAAI,SAAS,EAC9B,kBAAkB,IAAI,YAAY,EAClC,SAAS,EACV,MAAM,YAAY,CAAC;AAEpB,uFAAuF;AACvF,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;AAI5D;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,oBAAoB,GAAG,IAAI,GAAG,IAAI,CAE7E;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,IAAI,CAAsB;IAClC,OAAO,CAAC,aAAa,CAAS;gBAElB,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,mBAAmB;IAO1D;;;;;;OAMG;IACH,gBAAgB,IAAI,IAAI;IAQxB;;;;;;;;;;;;;;;;;OAiBG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,iBAAiB,EAAE,GAAG,SAAS;IAgEnE;;;;OAIG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAQxC;;;;OAIG;IACH,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAIxF,sEAAsE;IACtE,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAItE,6DAA6D;IAC7D,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAIjD,wDAAwD;IACxD,cAAc,IAAI,SAAS,EAAE;IAI7B,OAAO,CAAC,oBAAoB;CAO7B"}

package/dist/store-editor.js

@@ -0,0 +1,155 @@
+/* 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/. */
+/** Sentinel byteOffset that flags an `EntityRef` as overlay-only (no source bytes). */
+export const OVERLAY_BYTE_OFFSET = -1;
+let configuredNormalizer = null;
+/**
+ * Register the canonical-name resolver. Pass `null` to clear it (used
+ * by tests). Calling repeatedly is fine — last write wins.
+ */
+export function setEntityTypeNormalizer(fn) {
+    configuredNormalizer = fn;
+}
+export class StoreEditor {
+    store;
+    view;
+    maxExistingId;
+    constructor(store, view) {
+        this.store = store;
+        this.view = view;
+        this.maxExistingId = this.computeMaxExistingId();
+        this.view.setExpressIdWatermark(this.maxExistingId);
+    }
+    /**
+     * Re-scan the store and bump the express-id watermark if the store has
+     * grown since construction (e.g. after lazy index hydration or
+     * federating in another model). Cheap to call — `MutablePropertyView`
+     * keeps the high watermark, so re-seeding with a stale value is a
+     * no-op.
+     */
+    refreshWatermark() {
+        const fresh = this.computeMaxExistingId();
+        if (fresh > this.maxExistingId) {
+            this.maxExistingId = fresh;
+        }
+        this.view.setExpressIdWatermark(this.maxExistingId);
+    }
+    /**
+     * Add a new entity to the store overlay. Returns a synthetic `EntityRef`
+     * with a freshly-allocated expressId; pass it back to other APIs (other
+     * `addEntity` calls, `setPositionalAttribute`, exporters) to reference
+     * the new record.
+     *
+     * Pass `type` as the canonical IFC EXPRESS PascalCase name
+     * (e.g. `'IfcRectangleProfileDef'`). UPPERCASE STEP tokens are also
+     * accepted — both are normalized to the same internal form.
+     *
+     * Attribute conventions (mirrors `EntityExtractor.extractEntity()` output):
+     *   - numbers → STEP integer / REAL literal
+     *   - `"#42"` → STEP entity reference
+     *   - `"'literal'"` or any plain string → quoted STEP string
+     *   - `".AREA."` (dot-wrapped) → enum
+     *   - `null` / `undefined` → `$`
+     *   - arrays → STEP list `(a,b,c)`
+     */
+    addEntity(type, attributes) {
+        // Defense in depth: reject obviously-invalid `type` at the editor
+        // boundary so a typo doesn't end up as an invalid STEP record on
+        // export. The SDK normalizes via the parser registry; this guard
+        // catches direct-editor callers (CLI scripts, sandbox bridge,
+        // unit tests) that don't go through that path.
+        if (typeof type !== 'string') {
+            throw new TypeError(`StoreEditor.addEntity: type must be a string, got ${typeof type}`);
+        }
+        const trimmed = type.trim();
+        if (trimmed.length === 0) {
+            throw new Error('StoreEditor.addEntity: type cannot be empty');
+        }
+        // STEP entity tokens always start with "IFC" / "Ifc". Accept either
+        // PascalCase (`IfcWall`) or the all-caps STEP form (`IFCWALL`).
+        // Underscore is allowed in body chars to accommodate vendor-extension
+        // names (e.g. `IfcVendor_Foo`). The exporter handles the case
+        // conversion at the file-format boundary.
+        if (!/^[Ii][Ff][Cc][A-Za-z][A-Za-z0-9_]*$/.test(trimmed)) {
+            throw new Error(`StoreEditor.addEntity: type "${type}" is not a recognizable IFC entity name (expected e.g. "IfcWall")`);
+        }
+        // When a schema-aware normaliser is configured, resolve the
+        // canonical PascalCase name (e.g. "IFCWALL" → "IfcWall") and
+        // reject typos that aren't in the registry. The `Ifc${string}`
+        // shape passes the regex above but `IfcWal` would slip through;
+        // the normaliser is what catches that.
+        let canonical = trimmed;
+        if (configuredNormalizer) {
+            const resolved = configuredNormalizer(trimmed);
+            if (!resolved) {
+                throw new Error(`StoreEditor.addEntity: type "${type}" is not in the IFC schema registry (typo? vendor extension?)`);
+            }
+            canonical = resolved;
+        }
+        // Re-seed every call: cheap (one comparison + at most one write inside
+        // the view), and recovers from `view.clear()`, which resets the
+        // allocator to 0 and would otherwise hand out colliding ids on the
+        // next addEntity().
+        this.view.setExpressIdWatermark(this.maxExistingId);
+        // Defence against a stale watermark — the store may have grown after
+        // construction (lazy index hydration, federated merge) without
+        // notifying us. Check whether the allocator's next id collides with
+        // the current source index BEFORE calling createEntity, so we don't
+        // emit phantom CREATE_ENTITY / DELETE_ENTITY pairs into the mutation
+        // history just to fix our own bookkeeping.
+        if (this.store.entityIndex.byId.has(this.view.peekNextExpressId())) {
+            this.refreshWatermark();
+        }
+        const created = this.view.createEntity(canonical, attributes);
+        return {
+            expressId: created.expressId,
+            type: created.type,
+            byteOffset: OVERLAY_BYTE_OFFSET,
+            byteLength: 0,
+            lineNumber: -1,
+        };
+    }
+    /**
+     * Remove an entity. Existing entities are tombstoned and skipped during
+     * export; overlay-only entities are forgotten. Returns false if the id is
+     * not known to the store or the overlay.
+     */
+    removeEntity(expressId) {
+        if (this.view.getNewEntity(expressId) !== null) {
+            return this.view.deleteEntity(expressId);
+        }
+        if (!this.store.entityIndex.byId.has(expressId))
+            return false;
+        return this.view.deleteEntity(expressId);
+    }
+    /**
+     * Edit a positional STEP argument on any entity by zero-based index.
+     * Use this for non-IfcRoot edits like `IfcRectangleProfileDef.XDim`
+     * where the attribute has no symbolic name.
+     */
+    setPositionalAttribute(expressId, index, value) {
+        this.view.setPositionalAttribute(expressId, index, value);
+    }
+    /** Edit a named root attribute (Name, Description, ObjectType, …). */
+    setAttribute(expressId, attrName, value) {
+        this.view.setAttribute(expressId, attrName, value);
+    }
+    /** Look up the overlay record for a freshly-added entity. */
+    getNewEntity(expressId) {
+        return this.view.getNewEntity(expressId);
+    }
+    /** All overlay-created entities, in insertion order. */
+    getNewEntities() {
+        return this.view.getNewEntities();
+    }
+    computeMaxExistingId() {
+        let max = 0;
+        for (const id of this.store.entityIndex.byId.keys()) {
+            if (id > max)
+                max = id;
+        }
+        return max;
+    }
+}
+//# sourceMappingURL=store-editor.js.map

package/dist/store-editor.js.map

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

package/dist/types.d.ts

@@ -2,6 +2,13 @@
  * Types for IFC mutation tracking
  */
 import type { PropertyValueType } from '@ifc-lite/data';
+/**
+ * IFC STEP attribute value, as produced by `EntityExtractor.extractEntity()`.
+ *
+ * Mirrors the parser's `IfcAttributeValue` to keep `@ifc-lite/mutations` free
+ * of a `@ifc-lite/parser` dependency (parser → ifcx → mutations would cycle).
+ */
+export type IfcAttributeValue = string | number | boolean | null | IfcAttributeValue[];
 /**
  * Property value types supported by mutations
  */
@@ -9,7 +16,7 @@ export type PropertyValue = string | number | boolean | null | PropertyValue[];
 /**
  * Types of mutations that can be applied to IFC data
  */
-export type MutationType = 'CREATE_PROPERTY' | 'UPDATE_PROPERTY' | 'DELETE_PROPERTY' | 'CREATE_PROPERTY_SET' | 'DELETE_PROPERTY_SET' | 'CREATE_QUANTITY' | 'UPDATE_QUANTITY' | 'DELETE_QUANTITY' | 'UPDATE_ATTRIBUTE';
+export type MutationType = 'CREATE_PROPERTY' | 'UPDATE_PROPERTY' | 'DELETE_PROPERTY' | 'CREATE_PROPERTY_SET' | 'DELETE_PROPERTY_SET' | 'CREATE_QUANTITY' | 'UPDATE_QUANTITY' | 'DELETE_QUANTITY' | 'UPDATE_ATTRIBUTE' | 'UPDATE_POSITIONAL_ATTRIBUTE' | 'CREATE_ENTITY' | 'DELETE_ENTITY';
 /**
  * A single mutation operation
  */
@@ -91,6 +98,50 @@ export interface AttributeMutation {
     /** Previous value (for undo) */
     oldValue?: string;
 }
+/**
+ * In-memory record for an entity created via the overlay.
+ *
+ * `attributes` is the positional STEP argument list for the entity, in the
+ * same shape that `EntityExtractor.extractEntity()` produces. Numbers become
+ * STEP integer/REAL literals; strings/booleans/null are emitted literally;
+ * nested arrays are emitted as STEP lists. Use a string `"#42"` for entity
+ * references, `".AREA."` for enums, `"$"` for explicit unset.
+ */
+export interface NewEntity {
+    expressId: number;
+    type: string;
+    attributes: IfcAttributeValue[];
+}
+/**
+ * Minimal `EntityRef` shape consumed by `StoreEditor`. Structurally compatible
+ * with `@ifc-lite/parser`'s `EntityRef`.
+ */
+export interface MutationEntityRef {
+    expressId: number;
+    type: string;
+    byteOffset: number;
+    byteLength: number;
+    lineNumber: number;
+}
+/**
+ * Minimal entity-by-id index shape. Compatible with `Map<number, EntityRef>`
+ * and the parser's `CompactEntityIndex`. Only the read methods are required
+ * — the overlay never mutates the underlying index.
+ */
+export interface MutationEntityByIdIndex {
+    get(expressId: number): MutationEntityRef | undefined;
+    has(expressId: number): boolean;
+    readonly size: number;
+    keys(): IterableIterator<number>;
+}
+/**
+ * Minimal `IfcDataStore` shape consumed by `StoreEditor`.
+ */
+export interface MutationStoreShape {
+    entityIndex: {
+        byId: MutationEntityByIdIndex;
+    };
+}
 /**
  * Generate a unique ID for mutations
  */

package/dist/types.d.ts.map

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

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAqH/D;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AAC3E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,MAAM,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AAC1E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,QAAgB,EAAE,QAAgB;IAC9E,OAAO,GAAG,QAAQ,IAAI,QAAQ,IAAI,QAAQ,EAAE,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,QAAgB,EAAE,SAAiB;IAC/E,OAAO,GAAG,QAAQ,IAAI,QAAQ,IAAI,SAAS,EAAE,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,aAAqB;IAClE,OAAO,GAAG,QAAQ,SAAS,aAAa,EAAE,CAAC;AAC7C,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAqL/D;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AAC3E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,MAAM,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AAC1E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,QAAgB,EAAE,QAAgB;IAC9E,OAAO,GAAG,QAAQ,IAAI,QAAQ,IAAI,QAAQ,EAAE,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,QAAgB,EAAE,SAAiB;IAC/E,OAAO,GAAG,QAAQ,IAAI,QAAQ,IAAI,SAAS,EAAE,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,aAAqB;IAClE,OAAO,GAAG,QAAQ,SAAS,aAAa,EAAE,CAAC;AAC7C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ifc-lite/mutations",
-  "version": "1.14.5",
+  "version": "1.15.1",
   "description": "Mutation tracking and property editing for IFC-Lite",
   "type": "module",
   "main": "./dist/index.js",
@@ -12,21 +12,21 @@
     }
   },
   "dependencies": {
-    "@ifc-lite/data": "^1.15.1"
+    "@ifc-lite/data": "^2.0.0"
   },
   "devDependencies": {
-    "typescript": "^5.3.0",
+    "typescript": "^6.0.3",
     "vitest": "^1.6.0"
   },
   "license": "MPL-2.0",
   "author": "Louis True",
   "repository": {
     "type": "git",
-    "url": "https://github.com/louistrue/ifc-lite.git",
+    "url": "https://github.com/LTplus-AG/ifc-lite.git",
     "directory": "packages/mutations"
   },
-  "homepage": "https://louistrue.github.io/ifc-lite/",
-  "bugs": "https://github.com/louistrue/ifc-lite/issues",
+  "homepage": "https://ltplus-ag.github.io/ifc-lite/",
+  "bugs": "https://github.com/LTplus-AG/ifc-lite/issues",
   "keywords": [
     "ifc",
     "bim",