Class StoreEditor

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)

Attach a property set to an entity via the property view, so it surfaces in the properties panel AND exports to IfcPropertySet — the single source the rest of the app reads (the panel doesn't resolve raw overlay entities).

Attach a quantity set to an entity via the property view, so it surfaces in the properties panel (getQuantitiesForEntity) AND exports to IfcElementQuantity — the single source the rest of the app reads. Prefer this over emitting raw quantity / element-quantity entities, which the panel doesn't resolve.

The entity's CURRENT IFC class — canonical, from whichever layer is authoritative: a pending retype, an overlay-created entity's authored type, or the source record's declared type — or undefined when the id is deleted or resolves to nothing at all. The one place a builder that takes "an id of a specific class" (e.g. bim.store.addCostValue's UnitBasis) checks what it actually got, rather than trusting the caller.

The live overlay this editor writes to, for effective read boundaries.

All overlay-created entities, in insertion order.

Look up the overlay record for a freshly-added entity.

The schema declared by the loaded model, if the store exposes it.

Whether an id resolves to a live source or overlay entity.

Cooperatively prepare owned entity operations without exposing a draft. Construction establishes the live allocator watermark before this action; cancellation changes no live overlay state. Final exact validation is synchronous.

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.

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.

Stage one synchronous IFC edit; failure publishes no partial overlay (#4243). Prepare image/worker resources before calling this. Returned entity IDs are valid after success; the draft editor is detached after this callback.

Edit a named root attribute (Name, Description, ObjectType, …).

Change an entity's IFC class in place ("retype" / reassign class).

The entity keeps its expressId, so its geometry, placement, representation and every IfcRel* reference (all keyed by #id) carry over unchanged. The STEP exporter re-lays-out the entity's attributes BY NAME against the target class's declared layout — mirroring IfcOpenShell's reassign_class. Best suited to compatible reassignments such as the building-element subtypes (IfcBuildingElementProxy ↔ IfcColumn / IfcBeam / IfcMember / IfcPlate / IfcWall) which share the IfcElement attribute layout.

Returns false if the id is not known to the store or the overlay.

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.