@ifc-lite/sdk 9.5.0 → 9.6.0

package/dist/headless/overlay.d.ts

@@ -0,0 +1,170 @@
+/**
+ * The pending-mutation overlay, in the shape the server's read surface needs to
+ * read it. One reader for every tool: `model_diff` (#2000) and, since #2004, the
+ * query backend, `model_info` and `count_entities`.
+ *
+ * A `model_id` on this server does not name a file — it names a session model,
+ * and `entity_set_property` / `entity_set_attribute` / `entity_create` /
+ * `entity_delete` queue their edits in a `MutablePropertyView` overlay that the
+ * parsed `IfcDataStore` never sees (the store's buffer and index are immutable;
+ * the overlay materialises at `export_ifc` / `model_save` time).
+ *
+ * Read straight from the store, a tool therefore answers about the file as it
+ * was parsed. That is the wrong answer for the caller most likely to ask: an
+ * agent edits, reads back to confirm, and is told its edit did not happen — and
+ * the natural recovery from that is to edit again.
+ *
+ * **Reads fold the overlay in silently; the payload then says how many edits are
+ * queued.** Folding is what makes "what is there now" answerable at all, and
+ * `query_entities`' filters make it non-negotiable: a query for the value an
+ * agent just wrote has to find it, and a tool that reported the divergence
+ * instead of folding would still return the pre-edit row set. Reporting is what
+ * keeps the answer honest about not being on disk yet — `pendingMutations` is
+ * absent, not zero, on a session that has never been edited, so nothing changes
+ * for a read-only caller.
+ */
+import { type PropertySet, type QuantitySet } from '@ifc-lite/data';
+import { type MutablePropertyView } from '@ifc-lite/mutations';
+import { effectiveRelationshipEdges, type IfcDataStore } from '@ifc-lite/parser';
+/** An entity that exists only in the overlay (`entity_create`). */
+export interface CreatedEntity {
+    expressId: number;
+    /** IFC class as authored, e.g. `IfcWall`. */
+    ifcType: string;
+    /** Empty for a created entity that carries none — an `IfcCartesianPoint`, or
+     *  a root the caller left unidentified. Never empty in {@link
+     *  PendingOverlay.created}, which is the cross-model-identity list. */
+    globalId: string;
+    name?: string;
+    description?: string;
+    /** The positional STEP attributes exactly as authored. */
+    attributes: readonly unknown[];
+}
+/**
+ * Attribute writes queued for an entity, keyed by IFC attribute name.
+ *
+ * **Not a fixed set of fields, deliberately.** This used to project the three
+ * names the fingerprint hashes (`Name` / `Description` / `ObjectType`) while
+ * `entity_set_attribute` accepted four, so a written `Tag` was queued and never
+ * read back (#2014). A projection that enumerates has to be kept in step with
+ * the write tool's enum by hand, and was not. Passing every queued write through
+ * means the read surface cannot fall behind the write surface again: whatever
+ * the enum grows, the readback carries.
+ */
+type AttributeOverrides = ReadonlyMap<string, string>;
+/** The overlay's read surface, as every folding tool consumes it. */
+export interface PendingOverlay {
+    /** Express ids tombstoned by `entity_delete`. Empty is the common case.
+     *  Since #2012 this includes an entity the session created and then deleted:
+     *  `deleteEntity` tombstones it as well as forgetting it, so that "was this
+     *  deleted" has a true answer to find. A count therefore has to intersect
+     *  this with the store rather than subtracting its size — see
+     *  {@link foldedEntityCount}. */
+    readonly deleted: ReadonlySet<number>;
+    /** Entities queued by `entity_create` that carry a GlobalId, in creation
+     *  order. The identity list: `model_diff` compares on it, and
+     *  `get_entity(global_id)` resolves against it. A created entity without one
+     *  is reachable through {@link createdEntity} by expressId. */
+    readonly created: readonly CreatedEntity[];
+    /** Every queued entity, GlobalId-bearing or not, in creation order. What a
+     *  *count* is about: a created `IfcCartesianPoint` has no identity to compare
+     *  but is still one more entity in the model. `entity_delete` on a queued
+     *  entity drops it from this list, so a created-then-deleted entity appears
+     *  here not at all and in {@link deleted} once. */
+    readonly createdAll: readonly CreatedEntity[];
+    /** Queued mutations on this model — the same number `mutation_diff` reports.
+     *  Echoed back so a caller can tell an answer that includes uncommitted edits
+     *  from one taken over the file as parsed. */
+    readonly pendingMutations: number;
+    /** Any queued entity by expressId, GlobalId-bearing or not. Null when the id
+     *  is not one this session created. */
+    createdEntity(expressId: number): CreatedEntity | null;
+    /** The class a queued `setEntityType` gives the entity (`IfcWall` spelling),
+     *  or null when it keeps its authored class. Every read that names an
+     *  entity's type must go through this, or it disagrees with what export
+     *  writes (#5009 review). */
+    effectiveType(expressId: number): string | null;
+    /** Sparse queued class changes for effective whole-model enumeration. */
+    typeMutations?(): ReadonlyMap<number, {
+        readonly newType: string;
+    }>;
+    /** Sparse retype intents for aggregate class counts; absent in older read shims. */
+    getTypeMutations?(): ReadonlyMap<number, {
+        readonly newType: string;
+    }>;
+    attributes(expressId: number): AttributeOverrides;
+    positionalAttributes(expressId: number): ReadonlyMap<number, unknown>;
+    /** Every entity with a queued attribute write, keyed by expressId. For loops
+     *  over a whole model: `attributes(id)` builds a map per call, which is fine
+     *  for one entity and not for a million. */
+    attributesByEntity(): ReadonlyMap<number, AttributeOverrides>;
+    /** Base property sets with the overlay's edits applied. */
+    propertySets(expressId: number): PropertySet[];
+    /** Base quantity sets with the overlay's edits applied. */
+    quantitySets(expressId: number): QuantitySet[];
+    relationshipEdges(expressId: number, ifcRelType?: string): ReturnType<typeof effectiveRelationshipEdges>;
+    readonly supersededRelationshipIds: ReadonlySet<number>;
+}
+/**
+ * The model's pending overlay, or `null` when it has none.
+ *
+ * Null is the answer for every model that was only ever read: the backend
+ * creates the view lazily on the first mutation, so an unedited session pays
+ * nothing and every caller keeps its original store-only path.
+ */
+export declare function pendingOverlay(model: {
+    backend: {
+        pendingOverlay(): PendingOverlay | null;
+    };
+}): PendingOverlay | null;
+/**
+ * The same reader, built from the view directly.
+ *
+ * The backend owns its `MutablePropertyView` and folds the overlay into its own
+ * query adapter, so it cannot go through `pendingOverlay` — that would need a
+ * `LoadedModel`, which is the registry entry wrapped *around* the backend.
+ */
+export declare function overlayFromView(view: MutablePropertyView | null, store: IfcDataStore): PendingOverlay | null;
+/**
+ * Entity count per STEP type key, with queued creates, deletes and retypes
+ * applied by the shared aggregate accessor. A created entity is counted under
+ * its effective uppercase class, matching the parsed type buckets.
+ */
+export declare function foldedTypeCounts(store: IfcDataStore, overlay: PendingOverlay | null): Map<string, number>;
+/**
+ * The model's entity count with the session's creates and deletes applied.
+ *
+ * Adjusts the parser's own total rather than re-summing `byType`, so an unedited
+ * model's number is byte-for-byte what it always was.
+ *
+ * Only tombstones that name a STORE entity are subtracted. A created-then-
+ * deleted entity is already absent from `createdAll`, so counting its tombstone
+ * too would subtract it a second time and report one entity fewer than the file
+ * has (#2012). This also makes a tombstone on an id the store never had — which
+ * `entity_delete` rejects, but nothing here relies on that — unable to drive the
+ * count below the truth.
+ */
+export declare function foldedEntityCount(store: IfcDataStore, overlay: PendingOverlay | null): number;
+/**
+ * `{ pendingMutations: n }` when any of the sessions has queued edits, `{}`
+ * otherwise — spread into a tool payload so an unedited session's shape is
+ * untouched.
+ *
+ * Always a scalar, at every level of every payload. `model_diff` used to publish
+ * a `{ base, head }` object under the same name inside `contentDiff`, so one
+ * field name meant two shapes depending on where a caller found it; the split is
+ * now `pendingMutationsBySide`.
+ */
+export declare function pendingMutationsField(...overlays: Array<PendingOverlay | null>): Record<string, number>;
+/**
+ * Unwrap one authored STEP attribute to plain text.
+ *
+ * `StoreEditor.addEntity` documents both `"'literal'"` and a bare string as
+ * ways to write a string attribute, so the quotes have to come off before the
+ * value is hashed — otherwise a created entity could never content-match the
+ * same entity read back out of a file. `$` (unset), `*` (derived) and `#42`
+ * (a reference) are not text.
+ */
+export declare function stepText(value: unknown): string | undefined;
+export {};
+//# sourceMappingURL=overlay.d.ts.map

package/dist/headless/overlay.d.ts.map

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

package/dist/headless/overlay.js

@@ -0,0 +1,285 @@
+/* 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/. */
+/**
+ * The pending-mutation overlay, in the shape the server's read surface needs to
+ * read it. One reader for every tool: `model_diff` (#2000) and, since #2004, the
+ * query backend, `model_info` and `count_entities`.
+ *
+ * A `model_id` on this server does not name a file — it names a session model,
+ * and `entity_set_property` / `entity_set_attribute` / `entity_create` /
+ * `entity_delete` queue their edits in a `MutablePropertyView` overlay that the
+ * parsed `IfcDataStore` never sees (the store's buffer and index are immutable;
+ * the overlay materialises at `export_ifc` / `model_save` time).
+ *
+ * Read straight from the store, a tool therefore answers about the file as it
+ * was parsed. That is the wrong answer for the caller most likely to ask: an
+ * agent edits, reads back to confirm, and is told its edit did not happen — and
+ * the natural recovery from that is to edit again.
+ *
+ * **Reads fold the overlay in silently; the payload then says how many edits are
+ * queued.** Folding is what makes "what is there now" answerable at all, and
+ * `query_entities`' filters make it non-negotiable: a query for the value an
+ * agent just wrote has to find it, and a tool that reported the divergence
+ * instead of folding would still return the pre-edit row set. Reporting is what
+ * keeps the answer honest about not being on disk yet — `pendingMutations` is
+ * absent, not zero, on a session that has never been edited, so nothing changes
+ * for a read-only caller.
+ */
+import { countEffectiveEntityTypes } from '@ifc-lite/data';
+import { storeHasSourceEntity } from '@ifc-lite/mutations';
+import { getInheritanceChainAcrossSchemas, effectiveRelationshipEdges, resolveEffectiveEntityRecord, resolveEffectiveRelationshipOverlay, normalizeIfcTypeName, } from '@ifc-lite/parser';
+import { effectiveSourceIds, pendingEntityMembership } from './effective-entity-membership.js';
+const NO_POSITIONAL_ATTRIBUTES = new Map();
+/**
+ * The model's pending overlay, or `null` when it has none.
+ *
+ * Null is the answer for every model that was only ever read: the backend
+ * creates the view lazily on the first mutation, so an unedited session pays
+ * nothing and every caller keeps its original store-only path.
+ */
+export function pendingOverlay(model) {
+    return model.backend.pendingOverlay();
+}
+/**
+ * The same reader, built from the view directly.
+ *
+ * The backend owns its `MutablePropertyView` and folds the overlay into its own
+ * query adapter, so it cannot go through `pendingOverlay` — that would need a
+ * `LoadedModel`, which is the registry entry wrapped *around* the backend.
+ */
+export function overlayFromView(view, store) {
+    if (!view || !view.hasPendingChanges())
+        return null;
+    return new ViewOverlay(view, store);
+}
+/**
+ * **Everything derived is lazy, and the point lookup does not derive at all.**
+ *
+ * A fresh `ViewOverlay` is built on every overlay read — that is what keeps it
+ * honest, because there is no revision counter on `MutablePropertyView` to cache
+ * against and `getMutations().length` is not one (`mutation_undo` splices the
+ * history, so a later write can land back on the same length). A stale overlay
+ * after a mutation is a correctness bug; rebuilding is not.
+ *
+ * So the rebuild is made cheap instead. The constructor does no work, each
+ * derived collection is computed once per instance on first use, and
+ * `createdEntity` — the one called per entity by `entityData` — goes straight to
+ * the view's own id map rather than materialising the whole created list.
+ * Measured on a 20k-wall model with 2,000 queued creates, a 1,000-id
+ * `get_entities_bulk` went from ~1,960ms to ~7ms (median of five), and
+ * `getMutations()` (which copies the whole history) is no longer touched unless
+ * a payload reports the count.
+ */
+class ViewOverlay {
+    view;
+    store;
+    tombstones = null;
+    all = null;
+    identified = null;
+    count = null;
+    effectiveRelations = null;
+    constructor(view, store) {
+        this.view = view;
+        this.store = store;
+    }
+    get deleted() {
+        if (!this.tombstones)
+            this.tombstones = this.view.getTombstones();
+        return this.tombstones;
+    }
+    /** The created entity as export writes it: effective class, name-relaid attributes, edits applied. */
+    effectiveCreatedEntity(entity) {
+        const record = resolveEffectiveEntityRecord(entity, {
+            retype: this.view.getEntityTypeMutation(entity.expressId)?.newType,
+            named: this.view.getAttributeMutationsForEntity(entity.expressId).map(({ name, value }) => [name, value]),
+            positional: this.view.getPositionalMutationsForEntity(entity.expressId) ?? [],
+        }, this.store.schemaVersion);
+        return toCreatedEntity({ ...entity, type: record.type, attributes: record.attributes });
+    }
+    get createdAll() {
+        if (!this.all)
+            this.all = this.view.getNewEntities().map(entity => this.effectiveCreatedEntity(entity));
+        return this.all;
+    }
+    get created() {
+        if (!this.identified)
+            this.identified = this.createdAll.filter((entity) => entity.globalId !== '');
+        return this.identified;
+    }
+    get pendingMutations() {
+        // `getMutations()` copies the whole history, so it is paid once per overlay
+        // and only when something actually reports the number.
+        if (this.count === null)
+            this.count = this.view.getMutations().length;
+        return this.count;
+    }
+    createdEntity(expressId) {
+        // The view already indexes new entities by id; going through `createdAll`
+        // here made every `entityData` call O(number of queued creates).
+        const raw = this.view.getNewEntity(expressId);
+        return raw ? this.effectiveCreatedEntity(raw) : null;
+    }
+    effectiveType(expressId) {
+        const retype = this.view.getEntityTypeMutation(expressId)?.newType;
+        return retype ? normalizeIfcTypeName(retype) : null;
+    }
+    typeMutations() {
+        return this.view.getTypeMutations();
+    }
+    getTypeMutations() {
+        return this.view.getTypeMutations();
+    }
+    attributes(expressId) {
+        // Every queued write, not a chosen few. Last write wins, which is what
+        // `getAttributeMutationsForEntity` already orders for us.
+        const out = new Map();
+        for (const { name, value } of this.view.getAttributeMutationsForEntity(expressId)) {
+            out.set(name, value);
+        }
+        return out;
+    }
+    positionalAttributes(expressId) {
+        return this.view.getPositionalMutationsForEntity(expressId) ?? NO_POSITIONAL_ATTRIBUTES;
+    }
+    attributesByEntity() {
+        return this.view.getAttributeMutationsByEntity();
+    }
+    get relationshipOverlay() {
+        if (!this.effectiveRelations)
+            this.effectiveRelations = resolveEffectiveRelationshipOverlay(this.store, {
+                createdEntities: () => this.view.getNewEntities(),
+                mutatedEntityIds: () => this.view.getEffectiveChanges().map(change => change.entityId),
+                namedAttributes: id => this.view.getAttributeMutationsForEntity(id).map(({ name, value }) => [name, value]),
+                positionalAttributes: id => this.view.getPositionalMutationsForEntity(id) ?? [],
+                entityType: id => this.view.getEntityTypeMutation(id)?.newType,
+                isDeleted: id => this.view.isDeleted(id),
+            });
+        return this.effectiveRelations;
+    }
+    relationshipEdges(expressId, ifcRelType) {
+        return effectiveRelationshipEdges(this.relationshipOverlay, id => this.view.isDeleted(id), expressId, ifcRelType);
+    }
+    get supersededRelationshipIds() {
+        return this.relationshipOverlay.supersededSourceIds;
+    }
+    propertySets(expressId) {
+        return this.view.getForEntity(expressId);
+    }
+    quantitySets(expressId) {
+        return this.view.getQuantitiesForEntity(expressId);
+    }
+}
+/**
+ * Entity count per STEP type key, with queued creates, deletes and retypes
+ * applied by the shared aggregate accessor. A created entity is counted under
+ * its effective uppercase class, matching the parsed type buckets.
+ */
+export function foldedTypeCounts(store, overlay) {
+    return countEffectiveEntityTypes(store, pendingEntityMembership(overlay), effectiveSourceIds(store));
+}
+/**
+ * The model's entity count with the session's creates and deletes applied.
+ *
+ * Adjusts the parser's own total rather than re-summing `byType`, so an unedited
+ * model's number is byte-for-byte what it always was.
+ *
+ * Only tombstones that name a STORE entity are subtracted. A created-then-
+ * deleted entity is already absent from `createdAll`, so counting its tombstone
+ * too would subtract it a second time and report one entity fewer than the file
+ * has (#2012). This also makes a tombstone on an id the store never had — which
+ * `entity_delete` rejects, but nothing here relies on that — unable to drive the
+ * count below the truth.
+ */
+export function foldedEntityCount(store, overlay) {
+    if (!overlay)
+        return store.entityCount;
+    let deletedFromStore = 0;
+    for (const id of overlay.deleted) {
+        if (storeHasSourceEntity(store, id))
+            deletedFromStore++;
+    }
+    return store.entityCount + overlay.createdAll.length - deletedFromStore;
+}
+/**
+ * `{ pendingMutations: n }` when any of the sessions has queued edits, `{}`
+ * otherwise — spread into a tool payload so an unedited session's shape is
+ * untouched.
+ *
+ * Always a scalar, at every level of every payload. `model_diff` used to publish
+ * a `{ base, head }` object under the same name inside `contentDiff`, so one
+ * field name meant two shapes depending on where a caller found it; the split is
+ * now `pendingMutationsBySide`.
+ */
+export function pendingMutationsField(...overlays) {
+    if (overlays.every((overlay) => overlay === null))
+        return {};
+    return { pendingMutations: overlays.reduce((total, overlay) => total + (overlay?.pendingMutations ?? 0), 0) };
+}
+/**
+ * Read the IfcRoot header of an overlay-created entity.
+ *
+ * `NewEntity.attributes` is the positional STEP list the caller authored, so
+ * slots 0/2/3 are `GlobalId`/`Name`/`Description` **for an `IfcRoot` subtype**
+ * in every schema version — that part of the layout is fixed. Nothing further
+ * along is: slot 4 is `ObjectType` on an `IfcObject` but `ApplicableOccurrence`
+ * on an `IfcTypeObject`, so `objectType` and `PredefinedType` are read from the
+ * store for store entities and simply absent for created ones.
+ *
+ * **The `IfcRoot` half of that sentence is a precondition, not a description**,
+ * and `entity_create` accepts any IFC class. Slot 0 of an
+ * `IfcPropertySingleValue` is its `Name`, so reading it positionally turned
+ * `entity_create('IfcPropertySingleValue', ["'Width'", …])` into an entity whose
+ * GlobalId was `Width` — which then joined the cross-model identity list, so
+ * `get_entity(global_id: 'Width')` resolved to a property value, `model_diff`
+ * reported `Width` as an added entity, and `get_entities_bulk` could call it an
+ * ambiguous GlobalId. The columnar parser hits the same hazard when it keys an
+ * `IfcMaterial` on the Name in slot 0.
+ *
+ * So the header is read only when the class actually derives from `IfcRoot`,
+ * cross-schema (#2003) so an IFC2X3- or IFC4X3-only root is not judged by the
+ * IFC4 pin. A class no bundled schema declares has no chain to prove it is a
+ * root, so it keeps an empty header — the same deliberate vendor gap
+ * `diff-scope.ts` documents, and the safe direction: an unidentified entity is
+ * merely unreachable by GlobalId, whereas a wrongly identified one corrupts the
+ * identity space every other tool shares.
+ *
+ * `globalId` also comes back empty when slot 0 holds none — a created
+ * `IfcCartesianPoint` has no cross-model identity, and neither has a created
+ * root the caller left unidentified. Those are excluded from `created` (nothing
+ * can compare or look them up by key) but stay reachable by expressId, because
+ * `get_entity(express_id)` on an id this session just handed out must not answer
+ * "not found", and they are still counted.
+ */
+function toCreatedEntity(entity) {
+    const rooted = getInheritanceChainAcrossSchemas(entity.type).includes('IfcRoot');
+    return {
+        expressId: entity.expressId,
+        ifcType: entity.type,
+        globalId: (rooted ? stepText(entity.attributes[0]) : undefined) ?? '',
+        name: rooted ? stepText(entity.attributes[2]) : undefined,
+        description: rooted ? stepText(entity.attributes[3]) : undefined,
+        attributes: entity.attributes,
+    };
+}
+/**
+ * Unwrap one authored STEP attribute to plain text.
+ *
+ * `StoreEditor.addEntity` documents both `"'literal'"` and a bare string as
+ * ways to write a string attribute, so the quotes have to come off before the
+ * value is hashed — otherwise a created entity could never content-match the
+ * same entity read back out of a file. `$` (unset), `*` (derived) and `#42`
+ * (a reference) are not text.
+ */
+export function stepText(value) {
+    if (typeof value !== 'string')
+        return undefined;
+    const trimmed = value.trim();
+    if (trimmed === '' || trimmed === '$' || trimmed === '*' || trimmed.startsWith('#'))
+        return undefined;
+    if (trimmed.length >= 2 && trimmed.startsWith("'") && trimmed.endsWith("'")) {
+        return trimmed.slice(1, -1).replace(/''/g, "'") || undefined;
+    }
+    return trimmed;
+}
+//# sourceMappingURL=overlay.js.map

package/dist/headless/overlay.js.map

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

package/dist/headless/schema-tables.d.ts

@@ -0,0 +1,42 @@
+/**
+ * The bundled IFC schema tables, kept per schema rather than merged.
+ *
+ * The parser's `getAttributeNamesAcrossSchemas` answers from the IFC4 codegen
+ * pin whenever the pin knows the class, and from a merged union otherwise —
+ * which is the right default for a reader that does not know which schema it is
+ * looking at. Two callers here do know: `schema_describe` is told the class, and
+ * the query backend is told the model. For them a merged answer can be the wrong
+ * schema's answer:
+ *
+ * - `IfcControl` has five attributes in IFC2X3 and six in IFC4 (which added
+ *   `Identification`), so subtracting the merged count from an IFC2X3 leaf like
+ *   `IfcScheduleTimeControl` ate one of the leaf's own attributes.
+ * - `IfcRelCoversSpaces` names slot 4 `RelatedSpace` in IFC2X3 and
+ *   `RelatingSpace` in IFC4, so reading a created one back in an IFC2X3 model
+ *   reported an attribute name the file will not serialise.
+ *
+ * Later schemas still win when no schema is named, matching the parser's union.
+ */
+import { type IfcEntityInfo } from '@ifc-lite/data';
+/** One schema's row for a class, or undefined. `schema` is matched case- and
+ *  punctuation-insensitively, so `Ifc4x3` and `IFC4X3` both resolve. */
+export declare function entityInfoInSchema(type: string, schema: string | undefined): IfcEntityInfo | undefined;
+/**
+ * A class's row and the bundled schema that answered for it, later schemas
+ * winning — the same precedence the parser's union map applies.
+ */
+export declare function entityInfoAcrossSchemas(type: string): {
+    info: IfcEntityInfo;
+    schema: string;
+} | undefined;
+/**
+ * Attribute names in STEP positional order, preferring the named schema's
+ * spelling.
+ *
+ * Falls back to the parser's cross-schema answer when the model's schema does
+ * not declare the class — a vendor extension, or a class the file's declared
+ * schema does not have. That fallback is the pre-existing behaviour and is
+ * strictly better than nothing.
+ */
+export declare function attributeNamesForSchema(type: string, schema: string | undefined): readonly string[];
+//# sourceMappingURL=schema-tables.d.ts.map

package/dist/headless/schema-tables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-tables.d.ts","sourceRoot":"","sources":["../../src/headless/schema-tables.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAA2D,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAuB7G;wEACwE;AACxE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,CAGtG;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAQzG;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,MAAM,EAAE,CAGnG"}

package/dist/headless/schema-tables.js

@@ -0,0 +1,77 @@
+/* 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/. */
+/**
+ * The bundled IFC schema tables, kept per schema rather than merged.
+ *
+ * The parser's `getAttributeNamesAcrossSchemas` answers from the IFC4 codegen
+ * pin whenever the pin knows the class, and from a merged union otherwise —
+ * which is the right default for a reader that does not know which schema it is
+ * looking at. Two callers here do know: `schema_describe` is told the class, and
+ * the query backend is told the model. For them a merged answer can be the wrong
+ * schema's answer:
+ *
+ * - `IfcControl` has five attributes in IFC2X3 and six in IFC4 (which added
+ *   `Identification`), so subtracting the merged count from an IFC2X3 leaf like
+ *   `IfcScheduleTimeControl` ate one of the leaf's own attributes.
+ * - `IfcRelCoversSpaces` names slot 4 `RelatedSpace` in IFC2X3 and
+ *   `RelatingSpace` in IFC4, so reading a created one back in an IFC2X3 model
+ *   reported an attribute name the file will not serialise.
+ *
+ * Later schemas still win when no schema is named, matching the parser's union.
+ */
+import { ENTITIES_IFC2X3, ENTITIES_IFC4_EXPRESS, ENTITIES_IFC4X3 } from '@ifc-lite/data';
+import { getAttributeNamesAcrossSchemas } from '@ifc-lite/parser';
+/** Bundled schemas, oldest first. */
+const SCHEMA_TABLES = [
+    ['IFC2X3', ENTITIES_IFC2X3],
+    // Checked against the IFC4 EXPRESS registry, so an agent asking about IFC4
+    // is not told about entities or attributes IFC4 lacks (#5204).
+    ['IFC4', ENTITIES_IFC4_EXPRESS],
+    ['IFC4X3', ENTITIES_IFC4X3],
+];
+let bySchema = null;
+function tables() {
+    if (!bySchema) {
+        bySchema = new Map(SCHEMA_TABLES.map(([schema, list]) => [
+            schema,
+            new Map(list.map((entity) => [entity.name.toUpperCase(), entity])),
+        ]));
+    }
+    return bySchema;
+}
+/** One schema's row for a class, or undefined. `schema` is matched case- and
+ *  punctuation-insensitively, so `Ifc4x3` and `IFC4X3` both resolve. */
+export function entityInfoInSchema(type, schema) {
+    if (!schema)
+        return undefined;
+    return tables().get(schema.toUpperCase().replace(/[^A-Z0-9]/g, ''))?.get(type.toUpperCase());
+}
+/**
+ * A class's row and the bundled schema that answered for it, later schemas
+ * winning — the same precedence the parser's union map applies.
+ */
+export function entityInfoAcrossSchemas(type) {
+    const upper = type.toUpperCase();
+    for (let i = SCHEMA_TABLES.length - 1; i >= 0; i--) {
+        const schema = SCHEMA_TABLES[i][0];
+        const info = tables().get(schema)?.get(upper);
+        if (info)
+            return { info, schema };
+    }
+    return undefined;
+}
+/**
+ * Attribute names in STEP positional order, preferring the named schema's
+ * spelling.
+ *
+ * Falls back to the parser's cross-schema answer when the model's schema does
+ * not declare the class — a vendor extension, or a class the file's declared
+ * schema does not have. That fallback is the pre-existing behaviour and is
+ * strictly better than nothing.
+ */
+export function attributeNamesForSchema(type, schema) {
+    const info = entityInfoInSchema(type, schema);
+    return info ? info.attributes : getAttributeNamesAcrossSchemas(type);
+}
+//# sourceMappingURL=schema-tables.js.map

package/dist/headless/schema-tables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-tables.js","sourceRoot":"","sources":["../../src/headless/schema-tables.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,eAAe,EAAsB,MAAM,gBAAgB,CAAC;AAC7G,OAAO,EAAE,8BAA8B,EAAE,MAAM,kBAAkB,CAAC;AAElE,qCAAqC;AACrC,MAAM,aAAa,GAA+D;IAChF,CAAC,QAAQ,EAAE,eAAe,CAAC;IAC3B,2EAA2E;IAC3E,+DAA+D;IAC/D,CAAC,MAAM,EAAE,qBAAqB,CAAC;IAC/B,CAAC,QAAQ,EAAE,eAAe,CAAC;CAC5B,CAAC;AAEF,IAAI,QAAQ,GAAmD,IAAI,CAAC;AACpE,SAAS,MAAM;IACb,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,QAAQ,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;YACvD,MAAM;YACN,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;SACnE,CAAC,CAAC,CAAC;IACN,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;wEACwE;AACxE,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,MAA0B;IACzE,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,OAAO,MAAM,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;AAC/F,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,KAAK,IAAI,CAAC,GAAG,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACnD,MAAM,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;QAC9C,IAAI,IAAI;YAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACpC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAY,EAAE,MAA0B;IAC9E,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC9C,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,8BAA8B,CAAC,IAAI,CAAC,CAAC;AACvE,CAAC"}

package/dist/headless/session.d.ts

@@ -0,0 +1,23 @@
+import { type ParseModelOptions, type ParsedModel } from '@ifc-lite/parser';
+import { type BimContext } from '../context.js';
+import { type HeadlessCapability, type HeadlessOperation } from './capabilities.js';
+import type { HeadlessBackendOptions } from './options.js';
+export declare class HeadlessSessionClosedError extends Error {
+    readonly code = "SESSION_CLOSED";
+    constructor();
+}
+export interface OpenModelOptions extends ParseModelOptions {
+    modelId?: string;
+    modelName?: string;
+    backend?: HeadlessBackendOptions;
+}
+export interface HeadlessModelSession extends ParsedModel {
+    readonly bim: BimContext;
+    readonly closed: boolean;
+    capability(operation: HeadlessOperation): HeadlessCapability;
+    /** Idempotent. Releases host preparation caches and refuses later backend calls. */
+    close(): void;
+}
+/** Open STEP/IFCZIP bytes for headless queries, mutations and export. No I/O or renderer is created. */
+export declare function openModel(input: Uint8Array | ArrayBuffer, options?: OpenModelOptions): Promise<HeadlessModelSession>;
+//# sourceMappingURL=session.d.ts.map

package/dist/headless/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/headless/session.ts"],"names":[],"mappings":"AAIA,OAAO,EAAc,KAAK,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACxF,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAElE,OAAO,EAAmD,KAAK,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACrI,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAG3D,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,QAAQ,CAAC,IAAI,oBAAoB;;CAElC;AACD,MAAM,WAAW,gBAAiB,SAAQ,iBAAiB;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,sBAAsB,CAAC;CAClC;AACD,MAAM,WAAW,oBAAqB,SAAQ,WAAW;IACvD,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,SAAS,EAAE,iBAAiB,GAAG,kBAAkB,CAAC;IAC7D,oFAAoF;IACpF,KAAK,IAAI,IAAI,CAAC;CACf;AAmED,wGAAwG;AACxG,wBAAsB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAoC9H"}