@ifc-lite/sdk 9.5.0 → 9.6.0

package/dist/headless/backend.js

@@ -0,0 +1,317 @@
+/* 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/. */
+import { createCostBackend, createEffectiveEntityCheck, createHeadlessMutateAdapter } from '../index.js';
+import { applyStylesInStore } from '@ifc-lite/create';
+import { describeHeadlessOperation } from './capabilities.js';
+import { createHeadlessStoreAdapter } from './headless-backend-store.js';
+import { configureSourceMutationView } from './mutation-base.js';
+import { MutablePropertyView, StoreEditor, storeHasSourceEntity } from '@ifc-lite/mutations';
+import { extractScheduleOnDemand, } from '@ifc-lite/parser';
+import { escapeCsvCell, exportToStep, StepExporter } from '@ifc-lite/export';
+import { findPropertyInSets, findQuantityInSets } from '@ifc-lite/query';
+import { createStructuralAdapter } from './headless-backend-structural.js';
+import { createQueryAdapter } from './backend-query.js';
+import { overlayFromView } from './overlay.js';
+export class HeadlessBackend {
+    model;
+    query;
+    selection;
+    /**
+     * Mutable so the MCP server can swap in streaming adapters when the
+     * viewer subprocess starts, then revert when it closes. Marked
+     * `readonly` on the BimBackend interface but the underlying instance
+     * is ours to manage.
+     */
+    visibility;
+    viewer;
+    mutate;
+    style;
+    store;
+    spatial;
+    export;
+    lens;
+    files;
+    schedule;
+    structural;
+    cost;
+    dataStore;
+    modelName;
+    modelId;
+    /** Every model id this backend answers for, so the schedule assert, the
+     *  `bim.mutate.*` guard and `bim.store.addEntity` cannot differ (#3764). The
+     *  legacy-host aliases are accepted only when explicitly supplied. */
+    acceptedModelIds;
+    /** The reference check `bim.mutate.*` is gated on (`null` when writable,
+     *  else the reason), exposed because the mutation TOOLS write into
+     *  `getMutationView()` directly and need the same gate (#3764). */
+    checkEntityRef;
+    mutationView = null;
+    storeEditor = null;
+    disposeRoomCommands;
+    viewerAttached = false;
+    options;
+    peerScopes = () => [];
+    capability(operation) { return describeHeadlessOperation(this, operation, this.options, this.viewerAttached); }
+    setPeerScopes(provider) { this.peerScopes = provider; }
+    dispose() { this.disposeRoomCommands(); }
+    constructor(store, modelName, modelId, options = {}, modelAliases = []) {
+        this.options = { ...options };
+        this.dataStore = store;
+        this.modelName = modelName;
+        this.modelId = modelId;
+        this.acceptedModelIds = [...new Set([modelId, ...modelAliases])];
+        this.model = this.createModelAdapter();
+        // The read surface folds this session's queued mutations in (#2004). The
+        // overlay is passed as a getter because it is built lazily on the first
+        // mutation, so a session that is only ever read stays on the store-only
+        // path and pays nothing.
+        this.query = createQueryAdapter(store, modelId, () => this.pendingOverlay(), () => this.getMutationView());
+        this.selection = this.createSelectionAdapter();
+        this.visibility = { hide() { }, show() { }, isolate() { }, reset() { } };
+        this.viewer = {
+            colorize() { }, colorizeAll() { }, resetColors() { },
+            flyTo() { }, setSection() { }, getSection() { return null; },
+            setCamera() { }, getCamera() { return { mode: 'perspective' }; },
+        };
+        this.checkEntityRef = createEffectiveEntityCheck({
+            acceptedModelIds: this.acceptedModelIds,
+            // Both halves of the source index (byId + deferred property atoms, #5222).
+            hasSourceEntity: id => storeHasSourceEntity(this.dataStore, id),
+            overlay: () => this.mutationView,
+        });
+        this.mutate = createHeadlessMutateAdapter(() => this.getOrCreateMutationView(), this.checkEntityRef);
+        // Same arrangement as the CLI backend: the work happens in @ifc-lite/create
+        // against the shared StoreEditor, so the new entities land in the overlay
+        // this backend's export adapter already reads.
+        this.style = {
+            applyColors: (batches, options) => applyStylesInStore(this.getOrCreateStoreEditor(), this.dataStore, batches.map(batch => ({
+                products: batch.refs.map(r => r.expressId),
+                color: batch.color,
+                name: batch.name,
+            })), options),
+        };
+        const storeAdapter = createHeadlessStoreAdapter(store, modelId, () => this.getOrCreateStoreEditor(), id => this.assertKnownModelId(id), () => this.peerScopes(), options);
+        this.store = storeAdapter;
+        this.disposeRoomCommands = storeAdapter.disposeRooms;
+        this.spatial = { queryBounds() { return []; }, raycast() { return []; }, queryFrustum() { return []; } };
+        this.export = this.createExportAdapter();
+        this.lens = { presets() { return []; }, create() { return null; }, activate() { }, deactivate() { }, getActive() { return null; } };
+        this.files = { list() { return []; }, text() { return null; }, csv() { return null; }, csvColumns() { return []; } };
+        this.schedule = this.createScheduleAdapter();
+        this.structural = createStructuralAdapter(this.dataStore, modelId => this.assertKnownModelId(modelId));
+        this.cost = createCostBackend(modelId => {
+            if (modelId)
+                this.assertKnownModelId(modelId);
+            return { modelId: this.modelId, store: this.dataStore, mutationView: this.mutationView ?? undefined };
+        });
+    }
+    subscribe(_event, _handler) {
+        return () => { };
+    }
+    createModelAdapter() {
+        const store = this.dataStore;
+        const name = this.modelName;
+        const id = this.modelId;
+        return {
+            list() {
+                return [{
+                        id,
+                        name,
+                        schema: store.schemaVersion,
+                        schemaVersion: store.schemaVersion,
+                        entityCount: store.entityCount,
+                        fileSize: store.fileSize,
+                        loadedAt: Date.now(),
+                    }];
+            },
+            activeId() { return id; },
+            loadIfc() { },
+        };
+    }
+    /** This session's queued edits, or null when it has none. */
+    pendingOverlay() {
+        return overlayFromView(this.mutationView, this.dataStore);
+    }
+    createSelectionAdapter() {
+        let selection = [];
+        return {
+            get() { return selection; },
+            set(refs) { selection = refs; },
+        };
+    }
+    getOrCreateStoreEditor() {
+        if (this.storeEditor)
+            return this.storeEditor;
+        this.mutationView = new MutablePropertyView(this.dataStore.properties || null, this.modelId);
+        // All source owners, including type definitions, contribute their full
+        // property and quantity sets before an edit rewrites them (#8056).
+        configureSourceMutationView(this.dataStore, this.mutationView);
+        this.storeEditor = new StoreEditor(this.dataStore, this.mutationView);
+        return this.storeEditor;
+    }
+    /** Expose the mutation view so tools can inspect pending mutations. */
+    getMutationView() {
+        return this.mutationView;
+    }
+    /**
+     * The overlay every `bim.mutate.*` write goes through, created on first use
+     * so a read-only session still pays nothing. Built by `getOrCreateStoreEditor`
+     * to keep the extractor wiring in one place.
+     */
+    /** The view `bim.mutate` writes through — public so `run_flow`'s `tables()` reads the same overlay. */
+    getOrCreateMutationView() {
+        this.getOrCreateStoreEditor();
+        // Non-null immediately after: the two fields are assigned together and
+        // never cleared.
+        return this.mutationView;
+    }
+    /** Force creation of the editor (used by mutation tools that always need it). */
+    ensureEditor() {
+        return this.getOrCreateStoreEditor();
+    }
+    /** Replace the viewer/visibility adapters at runtime (for ViewerManager). */
+    attachStreamingAdapters(viewer, visibility) {
+        this.viewerAttached = true;
+        this.viewer = viewer;
+        this.visibility = visibility;
+    }
+    /** Restore no-op viewer/visibility adapters (for ViewerManager close). */
+    detachStreamingAdapters() {
+        this.viewerAttached = false;
+        this.viewer = {
+            colorize() { }, colorizeAll() { }, resetColors() { },
+            flyTo() { }, setSection() { }, getSection() { return null; },
+            setCamera() { }, getCamera() { return { mode: 'perspective' }; },
+        };
+        this.visibility = { hide() { }, show() { }, isolate() { }, reset() { } };
+    }
+    /** Whether `modelId` names the one model this backend holds. */
+    acceptsModelId(modelId) {
+        return this.acceptedModelIds.includes(modelId);
+    }
+    /** Refuse an unknown model id loudly, at whichever surface was handed it. */
+    assertKnownModelId(modelId) {
+        if (this.acceptsModelId(modelId))
+            return;
+        throw new Error(`Unknown modelId '${modelId}': this backend answers for ${this.acceptedModelIds.map(id => `'${id}'`).join(' or ')}`);
+    }
+    createExportAdapter() {
+        const store = this.dataStore;
+        const queryAdapter = this.query;
+        /**
+         * RFC 4180 quoting + the CWE-1236 formula-injection guard, delegated to
+         * `@ifc-lite/export`'s single escaper. The copy that used to live here
+         * tested the trigger anchored at offset 0, so a BOM/ZWSP/LRM/NBSP/U+2028
+         * in front of `=` walked past it.
+         */
+        const escapeCsv = (value, sep) => escapeCsvCell(value, { delimiter: sep });
+        const resolveColumn = (data, col, props, qsets) => {
+            if (col === 'Name' || col === 'name')
+                return data.name;
+            if (col === 'Type' || col === 'type')
+                return data.type;
+            if (col === 'GlobalId' || col === 'globalId')
+                return data.globalId;
+            if (col === 'Description' || col === 'description')
+                return data.description;
+            if (col === 'ObjectType' || col === 'objectType')
+                return data.objectType;
+            const dot = col.indexOf('.');
+            if (dot > 0) {
+                const setName = col.slice(0, dot);
+                const valueName = col.slice(dot + 1);
+                if (props) {
+                    const prop = findPropertyInSets(props, setName, valueName);
+                    if (prop?.value != null)
+                        return String(prop.value);
+                }
+                if (qsets) {
+                    const qty = findQuantityInSets(qsets, setName, valueName);
+                    if (qty?.value != null)
+                        return String(qty.value);
+                }
+            }
+            return '';
+        };
+        return {
+            csv(refs, options) {
+                const entityRefs = refs;
+                const opts = options;
+                const sep = opts.separator ?? ',';
+                const hasDot = opts.columns.some((c) => c.indexOf('.') > 0);
+                const rows = [opts.columns];
+                for (const ref of entityRefs) {
+                    const data = queryAdapter.entityData(ref);
+                    if (!data)
+                        continue;
+                    const props = hasDot ? queryAdapter.properties(ref) : null;
+                    const qsets = hasDot ? queryAdapter.quantities(ref) : null;
+                    rows.push(opts.columns.map((c) => resolveColumn(data, c, props, qsets)));
+                }
+                return rows.map((r) => r.map((c) => escapeCsv(c, sep)).join(sep)).join('\n');
+            },
+            json(refs, columns) {
+                const entityRefs = refs;
+                const cols = columns;
+                const hasDot = cols.some((c) => c.indexOf('.') > 0);
+                const result = [];
+                for (const ref of entityRefs) {
+                    const data = queryAdapter.entityData(ref);
+                    if (!data)
+                        continue;
+                    const props = hasDot ? queryAdapter.properties(ref) : null;
+                    const qsets = hasDot ? queryAdapter.quantities(ref) : null;
+                    const row = {};
+                    for (const col of cols) {
+                        const v = resolveColumn(data, col, props, qsets);
+                        row[col] = v || null;
+                    }
+                    result.push(row);
+                }
+                return result;
+            },
+            ifc: (refs, options) => {
+                const opts = (options ?? {});
+                const schema = opts.schema ?? store.schemaVersion ?? 'IFC4';
+                const exportOpts = { schema };
+                // `undefined` is the only "no isolation filter": an empty list is a filter
+                // that matched nothing, refused in `ExportNamespace.ifc` (#4738).
+                if (refs != null) {
+                    const isolatedIds = new Set(refs.map((r) => r.expressId));
+                    exportOpts.visibleOnly = true;
+                    exportOpts.isolatedEntityIds = isolatedIds;
+                    exportOpts.hiddenEntityIds = new Set();
+                }
+                if (this.mutationView) {
+                    const exporter = new StepExporter(store, this.mutationView);
+                    const result = exporter.export({ schema, ...exportOpts });
+                    return new TextDecoder().decode(result.content);
+                }
+                return exportToStep(store, exportOpts);
+            },
+            download() { },
+        };
+    }
+    createScheduleAdapter() {
+        const store = this.dataStore;
+        let cached = null;
+        const assert = (modelId) => {
+            if (modelId)
+                this.assertKnownModelId(modelId);
+        };
+        const extract = (modelId) => {
+            assert(modelId);
+            if (!cached)
+                cached = extractScheduleOnDemand(store);
+            return cached;
+        };
+        return {
+            data: (m) => extract(m),
+            tasks: (m) => extract(m).tasks,
+            workSchedules: (m) => extract(m).workSchedules,
+            sequences: (m) => extract(m).sequences,
+        };
+    }
+}
+//# sourceMappingURL=backend.js.map

package/dist/headless/backend.js.map

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

package/dist/headless/capabilities.d.ts

@@ -0,0 +1,22 @@
+import type { BimBackend } from '../types.js';
+import type { HeadlessBackendOptions } from './options.js';
+type Namespace = Exclude<keyof BimBackend, 'subscribe'>;
+export type HeadlessOperation = 'subscribe' | {
+    [K in Namespace]-?: `${K}.${Extract<keyof NonNullable<BimBackend[K]>, string>}`;
+}[Namespace];
+export interface HeadlessCapability {
+    readonly operation: HeadlessOperation;
+    readonly supported: boolean;
+    readonly reason?: string;
+}
+export declare class UnsupportedOperationError extends Error {
+    readonly operation: HeadlessOperation;
+    readonly reason: string;
+    readonly code = "UNSUPPORTED_OPERATION";
+    constructor(operation: HeadlessOperation, reason: string, message?: string);
+}
+export declare function unsupportedOperation(operation: HeadlessOperation, message: string): (...args: unknown[]) => never;
+/** Supported means implemented/configured, not that every input or runtime will succeed. */
+export declare function describeHeadlessOperation(backend: BimBackend, operation: HeadlessOperation, options: HeadlessBackendOptions, viewerAttached: boolean): HeadlessCapability;
+export {};
+//# sourceMappingURL=capabilities.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/headless/capabilities.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAE3D,KAAK,SAAS,GAAG,OAAO,CAAC,MAAM,UAAU,EAAE,WAAW,CAAC,CAAC;AACxD,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG;KAC3C,CAAC,IAAI,SAAS,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE;CAChF,CAAC,SAAS,CAAC,CAAC;AACb,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AACD,qBAAa,yBAA0B,SAAQ,KAAK;IAEtC,QAAQ,CAAC,SAAS,EAAE,iBAAiB;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM;IAD1E,QAAQ,CAAC,IAAI,2BAA2B;gBACnB,SAAS,EAAE,iBAAiB,EAAW,MAAM,EAAE,MAAM,EAAE,OAAO,SAA4B;CAIhH;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,KAAK,CAMjH;AAED,4FAA4F;AAC5F,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,iBAAiB,EACzF,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,OAAO,GAAG,kBAAkB,CAoB9E"}

package/dist/headless/capabilities.js

@@ -0,0 +1,52 @@
+/* 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/. */
+export class UnsupportedOperationError extends Error {
+    operation;
+    reason;
+    code = 'UNSUPPORTED_OPERATION';
+    constructor(operation, reason, message = `${operation}: ${reason}`) {
+        super(message);
+        this.operation = operation;
+        this.reason = reason;
+        this.name = 'UnsupportedOperationError';
+    }
+}
+const refusals = new WeakMap();
+export function unsupportedOperation(operation, message) {
+    const reason = 'This headless backend does not implement this authoring operation';
+    const capability = { operation, supported: false, reason };
+    const refuse = () => { throw new UnsupportedOperationError(operation, reason, message); };
+    refusals.set(refuse, capability);
+    return refuse;
+}
+/** Supported means implemented/configured, not that every input or runtime will succeed. */
+export function describeHeadlessOperation(backend, operation, options, viewerAttached) {
+    const unavailable = (reason) => ({ operation, supported: false, reason });
+    if (operation === 'subscribe')
+        return unavailable('This headless backend has no event source');
+    const [namespace, method] = operation.split('.');
+    const object = Reflect.get(backend, namespace);
+    if (!object || typeof object !== 'object')
+        return unavailable('This headless backend does not implement the namespace');
+    const fn = Object.hasOwn(object, method) ? Reflect.get(object, method) : undefined;
+    if (typeof fn !== 'function')
+        return unavailable('This headless backend does not implement the method');
+    const refusal = refusals.get(fn);
+    if (refusal)
+        return { ...refusal, operation };
+    if ((namespace === 'viewer' || namespace === 'visibility') && !viewerAttached)
+        return unavailable('Attach a viewer adapter to use viewer operations');
+    if (['spatial', 'lens', 'files'].includes(namespace))
+        return unavailable('This headless backend has no provider for this namespace');
+    if (operation === 'model.loadIfc')
+        return unavailable('Open another model session to load a new model');
+    if (operation === 'export.download')
+        return unavailable('Write the export bytes using your application file API');
+    if (operation === 'store.alignElements' && !options.alignGeometry)
+        return unavailable('Align requires a host geometry provider');
+    if (operation === 'store.roomCommand' && !options.roomGeometry)
+        return unavailable('Room requires a host geometry provider');
+    return { operation, supported: true };
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/headless/capabilities.js.map

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

package/dist/headless/effective-entity-membership.d.ts

@@ -0,0 +1,8 @@
+/** Adapt the MCP session overlay to the shared effective-entity boundary. */
+import type { EffectiveEntityOverlay } from '@ifc-lite/data';
+import type { IfcDataStore } from '@ifc-lite/parser';
+import type { PendingOverlay } from './overlay.js';
+export declare function pendingEntityMembership(overlay: PendingOverlay | null): EffectiveEntityOverlay | null;
+/** IFCX has columnar rows but no STEP type buckets; give the shared iterator its source domain. */
+export declare function effectiveSourceIds(store: IfcDataStore): Iterable<number> | undefined;
+//# sourceMappingURL=effective-entity-membership.d.ts.map

package/dist/headless/effective-entity-membership.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effective-entity-membership.d.ts","sourceRoot":"","sources":["../../src/headless/effective-entity-membership.ts"],"names":[],"mappings":"AAIA,6EAA6E;AAC7E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,GAAG,sBAAsB,GAAG,IAAI,CAYrG;AAED,mGAAmG;AACnG,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,SAAS,CAGpF"}

package/dist/headless/effective-entity-membership.js

@@ -0,0 +1,23 @@
+/* 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/. */
+export function pendingEntityMembership(overlay) {
+    if (!overlay)
+        return null;
+    return {
+        isDeleted: (id) => overlay.deleted.has(id),
+        getTombstones: () => overlay.deleted,
+        getTypeMutations: () => overlay.getTypeMutations?.() ?? overlay.typeMutations?.() ?? new Map(),
+        getNewEntities: () => overlay.createdAll.map((entity) => ({ expressId: entity.expressId, type: entity.ifcType })),
+        getNewEntity: (id) => {
+            const entity = overlay.createdEntity(id);
+            return entity ? { type: entity.ifcType } : null;
+        },
+    };
+}
+/** IFCX has columnar rows but no STEP type buckets; give the shared iterator its source domain. */
+export function effectiveSourceIds(store) {
+    // @raw-entity-enumeration-ok detect an indexless IFCX source; its columnar IDs are passed through the canonical accessor
+    return store.entityIndex.byType.size === 0 ? store.entities.expressId : undefined;
+}
+//# sourceMappingURL=effective-entity-membership.js.map

package/dist/headless/effective-entity-membership.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effective-entity-membership.js","sourceRoot":"","sources":["../../src/headless/effective-entity-membership.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAO/D,MAAM,UAAU,uBAAuB,CAAC,OAA8B;IACpE,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,OAAO;QACL,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1C,aAAa,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO;QACpC,gBAAgB,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,IAAI,OAAO,CAAC,aAAa,EAAE,EAAE,IAAI,IAAI,GAAG,EAA+B;QAC3H,cAAc,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QACjH,YAAY,EAAE,CAAC,EAAE,EAAE,EAAE;YACnB,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;YACzC,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAClD,CAAC;KACF,CAAC;AACJ,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,kBAAkB,CAAC,KAAmB;IACpD,yHAAyH;IACzH,OAAO,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AACpF,CAAC"}

package/dist/headless/headless-backend-cost-store.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `bim.store.addCost*` / `nestCostItems` / `assignCostItemsToSchedule` /
+ * `assignToCostItem` / `setCostItemValues` / `removeCostEntity` stubs for the
+ * MCP v0.1 headless backend (#4857 PR A) — the same convention
+ * `headless-backend.ts`'s `addColumn`/`addWall`/etc. already use: agent flows
+ * go through `entity_create` with raw attributes, not the high-level
+ * builders, so these throw loudly rather than silently no-op. `bim.cost`
+ * READS already observe whatever `entity_create` authors, once the model's
+ * `MutablePropertyView` is threaded into `createCostBackend` — see
+ * `headless-backend.ts`'s `this.cost` construction.
+ */
+import type { CostStoreBackendMethods } from '../index.js';
+export declare function costStoreStubs(): CostStoreBackendMethods;
+//# sourceMappingURL=headless-backend-cost-store.d.ts.map

package/dist/headless/headless-backend-cost-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headless-backend-cost-store.d.ts","sourceRoot":"","sources":["../../src/headless/headless-backend-cost-store.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAI3D,wBAAgB,cAAc,IAAI,uBAAuB,CAYxD"}

package/dist/headless/headless-backend-cost-store.js

@@ -0,0 +1,18 @@
+/* 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/. */
+import { unsupportedOperation } from './capabilities.js';
+export function costStoreStubs() {
+    return {
+        addCostSchedule: unsupportedOperation('store.addCostSchedule', 'addCostSchedule not supported in MCP v0.1; use entity_create'),
+        addCostItem: unsupportedOperation('store.addCostItem', 'addCostItem not supported in MCP v0.1; use entity_create'),
+        addCostValue: unsupportedOperation('store.addCostValue', 'addCostValue not supported in MCP v0.1; use entity_create'),
+        addCostQuantity: unsupportedOperation('store.addCostQuantity', 'addCostQuantity not supported in MCP v0.1; use entity_create'),
+        nestCostItems: unsupportedOperation('store.nestCostItems', 'nestCostItems not supported in MCP v0.1; use entity_create'),
+        assignCostItemsToSchedule: unsupportedOperation('store.assignCostItemsToSchedule', 'assignCostItemsToSchedule not supported in MCP v0.1; use entity_create'),
+        assignToCostItem: unsupportedOperation('store.assignToCostItem', 'assignToCostItem not supported in MCP v0.1; use entity_create'),
+        setCostItemValues: unsupportedOperation('store.setCostItemValues', 'setCostItemValues not supported in MCP v0.1; use entity_create'),
+        removeCostEntity: unsupportedOperation('store.removeCostEntity', 'removeCostEntity not supported in MCP v0.1; use entity_create'),
+    };
+}
+//# sourceMappingURL=headless-backend-cost-store.js.map

package/dist/headless/headless-backend-cost-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"headless-backend-cost-store.js","sourceRoot":"","sources":["../../src/headless/headless-backend-cost-store.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAgB/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzD,MAAM,UAAU,cAAc;IAC5B,OAAO;QACL,eAAe,EAAE,oBAAoB,CAAC,uBAAuB,EAAE,8DAA8D,CAAC;QAC9H,WAAW,EAAE,oBAAoB,CAAC,mBAAmB,EAAE,0DAA0D,CAAC;QAClH,YAAY,EAAE,oBAAoB,CAAC,oBAAoB,EAAE,2DAA2D,CAAC;QACrH,eAAe,EAAE,oBAAoB,CAAC,uBAAuB,EAAE,8DAA8D,CAAC;QAC9H,aAAa,EAAE,oBAAoB,CAAC,qBAAqB,EAAE,4DAA4D,CAAC;QACxH,yBAAyB,EAAE,oBAAoB,CAAC,iCAAiC,EAAE,wEAAwE,CAAC;QAC5J,gBAAgB,EAAE,oBAAoB,CAAC,wBAAwB,EAAE,+DAA+D,CAAC;QACjI,iBAAiB,EAAE,oBAAoB,CAAC,yBAAyB,EAAE,gEAAgE,CAAC;QACpI,gBAAgB,EAAE,oBAAoB,CAAC,wBAAwB,EAAE,+DAA+D,CAAC;KAClI,CAAC;AACJ,CAAC"}

package/dist/headless/headless-backend-modelling.d.ts

@@ -0,0 +1,50 @@
+/** Ordinary creation, placement and wall joins use the shared SDK factories (#6232 D5).
+ * Shared compound recording preserves every earlier overlay record for undo. */
+import { type ModellingStoreModelResolver } from '../index.js';
+export declare function createRecordedModellingBackend(resolve: ModellingStoreModelResolver): {
+    transformElements: (modelId: string, expressIds: readonly number[], operation: import("@ifc-lite/create").StoreyTransformOp) => import("../types.js").EntityRef[];
+    setElementSize: (ref: import("../types.js").EntityRef, patch: import("../store-physical-types.js").PhysicalSizePatch) => import("../types.js").EntityRef[];
+    resizeWall: (ref: import("../types.js").EntityRef, start: [number, number, number], end: [number, number, number], options?: {
+        moveJoinedEnds?: boolean;
+    } | undefined) => import("../types.js").EntityRef[];
+    splitElements: (modelId: string, requests: readonly import("@ifc-lite/create").ElementSplitRequest[]) => {
+        source: import("../types.js").EntityRef;
+        added: import("../types.js").EntityRef;
+        left: import("../types.js").EntityRef;
+        right: import("../types.js").EntityRef;
+    }[];
+    trimExtendElement: (ref: import("../types.js").EntityRef, params: import("@ifc-lite/create").ElementTrimExtendParams) => import("../types.js").EntityRef[];
+    copyElements: (modelId: string, expressIds: readonly number[], transforms: readonly import("@ifc-lite/create").CopyTransform[]) => import("../types.js").EntityRef[];
+    duplicateElement: (ref: import("../types.js").EntityRef, options: {
+        offset: [number, number, number];
+        Name?: string;
+    }) => import("../types.js").EntityRef;
+    arrayElements: (modelId: string, expressIds: readonly number[], params: import("@ifc-lite/create").CopyArrayParams) => import("../types.js").EntityRef[];
+    editHostedElement: (ref: import("../types.js").EntityRef, patch: import("@ifc-lite/create").HostedElementEdit) => import("../types.js").EntityRef;
+    addCurtainWall: (modelId: string, storeyExpressId: number, params: import("@ifc-lite/create").CurtainWallInStoreParams) => import("../types.js").EntityRef;
+    addGrid: (modelId: string, storeyExpressId: number, params: import("@ifc-lite/create").GridInStoreParams) => import("../types.js").EntityRef;
+    addColumnOnGrid: (modelId: string, storeyExpressId: number, params: import("@ifc-lite/create").ColumnInStoreParams | import("@ifc-lite/create").ProfiledColumnInStoreParams, binding: import("@ifc-lite/create").GridColumnBinding) => import("../types.js").EntityRef;
+    replaceElement: (ref: import("../types.js").EntityRef, storeyExpressId: number, element: import("@ifc-lite/create").InStoreReplacementElement) => import("../types.js").EntityRef;
+    removeStair: (ref: Parameters<NonNullable<((ref: import("../types.js").EntityRef) => boolean) | undefined>>[0]) => boolean;
+    addStair: (modelId: string, storeyExpressId: number, params: import("@ifc-lite/create").StairInStoreParams) => import("../types.js").EntityRef;
+    addRailing: (modelId: string, storeyExpressId: number, params: import("@ifc-lite/create").RailingInStoreParams) => import("../types.js").EntityRef;
+    addElementType: (modelId: string, params: import("@ifc-lite/create").ElementTypeInStoreParams) => import("../types.js").EntityRef;
+    assignType: (modelId: string, typeExpressId: number, objectExpressIds: number[]) => import("../types.js").EntityRef;
+    addMaterial: (modelId: string, params: import("@ifc-lite/create").MaterialInStoreParams) => import("../types.js").EntityRef;
+    addMaterialLayerSet: (modelId: string, params: import("@ifc-lite/create").MaterialLayerSetInStoreParams) => import("../types.js").EntityRef;
+    addMaterialLayerSetUsage: (modelId: string, params: import("@ifc-lite/create").MaterialLayerSetUsageInStoreParams) => import("../types.js").EntityRef;
+    assignMaterial: (modelId: string, materialExpressId: number, objectExpressIds: number[]) => import("../types.js").EntityRef;
+    addOpening: (modelId: string, hostExpressId: number, params: import("@ifc-lite/create").OpeningInStoreParams) => import("../types.js").EntityRef;
+    addHostedDoor: (modelId: string, hostExpressId: number, params: import("@ifc-lite/create").HostedDoorInStoreParams) => import("../types.js").EntityRef;
+    addHostedWindow: (modelId: string, hostExpressId: number, params: import("@ifc-lite/create").HostedWindowInStoreParams) => import("../types.js").EntityRef;
+    joinWalls: (modelId: string, aExpressId: number, bExpressId: number, options?: import("@ifc-lite/create").WallJoinApplyOptions | undefined) => import("../types.js").EntityRef;
+    addWall: (modelId: string, storeyExpressId: number, params: import("../types.js").AddWallInStoreParams) => import("../types.js").EntityRef;
+    addColumn: (modelId: string, storeyExpressId: number, params: import("@ifc-lite/create").ProfiledColumnInStoreParams | import("../types.js").AddColumnInStoreParams) => import("../types.js").EntityRef;
+    addSlab: (modelId: string, storeyExpressId: number, params: import("../types.js").AddSlabInStoreParams) => import("../types.js").EntityRef;
+    addBeam: (modelId: string, storeyExpressId: number, params: import("../types.js").AddBeamInStoreParams | import("@ifc-lite/create").ProfiledBeamInStoreParams) => import("../types.js").EntityRef;
+    addSpace: (modelId: string, storeyExpressId: number, params: import("../types.js").AddSpaceInStoreParams) => import("../types.js").EntityRef;
+    addRoof: (modelId: string, storeyExpressId: number, params: import("../types.js").AddRoofInStoreParams) => import("../types.js").EntityRef;
+    addPlate: (modelId: string, storeyExpressId: number, params: import("../types.js").AddPlateInStoreParams) => import("../types.js").EntityRef;
+    addMember: (modelId: string, storeyExpressId: number, params: import("../types.js").AddMemberInStoreParams | import("@ifc-lite/create").ProfiledMemberInStoreParams) => import("../types.js").EntityRef;
+};
+//# sourceMappingURL=headless-backend-modelling.d.ts.map

package/dist/headless/headless-backend-modelling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headless-backend-modelling.d.ts","sourceRoot":"","sources":["../../src/headless/headless-backend-modelling.ts"],"names":[],"mappings":"AAIA;gFACgF;AAChF,OAAO,EAAsF,KAAK,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAGnJ,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;uBAsE5D,UAAU,CAAC,WAAW,iEAAwB,CAAC,CAAC,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;EAkCxE"}