@ifc-lite/flow-nodes 0.2.0

package/dist/index.js

@@ -0,0 +1,50 @@
+/* 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 { NodeRegistry } from '@ifc-lite/flow';
+import { applyTableNode } from './apply-table-node.js';
+import { connectorNodes } from './connector-nodes.js';
+import { coreNodes } from './core-nodes.js';
+import { csvNodes } from './csv-nodes.js';
+import { elementNodes } from './element-nodes.js';
+import { modelNodes } from './model-nodes.js';
+import { scriptListNode, scriptNode } from './script-node.js';
+import { tableNodes } from './table-nodes.js';
+import { viewerNodes } from './viewer-nodes.js';
+import { writeNodes } from './write-nodes.js';
+import { xlsxNodes } from './xlsx-nodes.js';
+export { requireCapability, toRef, toSdkRef, resolveByGlobalId, rememberGlobalId, forgetGlobalId, invalidateGlobalIdIndex } from './host.js';
+export { columnTypeOf, VALUE_TYPE_BY_COLUMN_TYPE } from './table-nodes.js';
+export { readXlsxTable, writeXlsxTable } from './xlsx-io.js';
+/** Every standard node, in one registry. */
+export function createStandardRegistry() {
+    return new NodeRegistry().registerAll([
+        ...coreNodes,
+        ...modelNodes,
+        ...tableNodes,
+        ...viewerNodes,
+        ...writeNodes,
+        ...elementNodes,
+        ...csvNodes,
+        ...xlsxNodes,
+        ...connectorNodes,
+        applyTableNode,
+        scriptNode,
+        scriptListNode,
+    ]);
+}
+/** What a viewer-embedded host offers. Secrets are never available in the browser. */
+export const BROWSER_FEATURES = {
+    backend: new Set(['viewer', 'visibility', 'selection', 'mutate', 'store', 'files', 'sandbox']),
+    network: false,
+    secrets: new Set(),
+};
+/**
+ * What the CLI's `HeadlessBackend` offers. It implements the viewer
+ * methods as inert no-ops, so `viewer`/`visibility`/`selection` are
+ * deliberately absent here: a viewer node must report `noop`, not pretend.
+ */
+export function headlessFeatures(secrets = []) {
+    return { backend: new Set(['mutate', 'store', 'files', 'sandbox']), network: false, secrets: new Set(secrets) };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D,OAAO,EAAE,YAAY,EAAqB,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAC7I,OAAO,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAE3E,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG7D,4CAA4C;AAC5C,MAAM,UAAU,sBAAsB;IACpC,OAAO,IAAI,YAAY,EAAY,CAAC,WAAW,CAAC;QAC9C,GAAG,SAAS;QACZ,GAAG,UAAU;QACb,GAAG,UAAU;QACb,GAAG,WAAW;QACd,GAAG,UAAU;QACb,GAAG,YAAY;QACf,GAAG,QAAQ;QACX,GAAG,SAAS;QACZ,GAAG,cAAc;QACjB,cAAc;QACd,UAAU;QACV,cAAc;KACf,CAAC,CAAC;AACL,CAAC;AAED,sFAAsF;AACtF,MAAM,CAAC,MAAM,gBAAgB,GAAiB;IAC5C,OAAO,EAAE,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IAC9F,OAAO,EAAE,KAAK;IACd,OAAO,EAAE,IAAI,GAAG,EAAE;CACnB,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAA4B,EAAE;IAC7D,OAAO,EAAE,OAAO,EAAE,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;AAClH,CAAC"}

package/dist/model-nodes.d.ts

@@ -0,0 +1,3 @@
+import { type FlowNodeDef } from './host.js';
+export declare const modelNodes: FlowNodeDef[];
+//# sourceMappingURL=model-nodes.d.ts.map

package/dist/model-nodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-nodes.d.ts","sourceRoot":"","sources":["../src/model-nodes.ts"],"names":[],"mappings":"AAaA,OAAO,EAUL,KAAK,WAAW,EACjB,MAAM,WAAW,CAAC;AAanB,eAAO,MAAM,UAAU,EAAE,WAAW,EAwLnC,CAAC"}

package/dist/model-nodes.js

@@ -0,0 +1,200 @@
+/* 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 { ENTITY_GROUP, ENTITY_ITEM, ENTITY_LIST, SCALAR_ITEM, entityOf, requireCapability, toRef, toSdkRef, } from './host.js';
+const str = (v, name) => {
+    if (typeof v !== 'string' || v.length === 0)
+        throw new Error(`"${name}" must be a non-empty string`);
+    return v;
+};
+function query(ctx, modelId) {
+    const q = ctx.host.bim.query();
+    const id = typeof modelId === 'string' && modelId.length > 0 ? modelId : ctx.host.defaultModelId;
+    return id ? q.model(id) : q;
+}
+export const modelNodes = [
+    {
+        type: 'model.select',
+        title: 'Select',
+        category: 'model',
+        doc: 'Entities matching an IfcOpenShell-style selector, e.g. `IfcWall, Pset_WallCommon.IsExternal=TRUE`.',
+        inputs: [],
+        outputs: [{ name: 'entities', type: ENTITY_LIST }],
+        params: [
+            { name: 'selector', kind: 'string', default: 'IfcWall' },
+            { name: 'model', kind: 'string', doc: 'Model id; the default model when empty.' },
+        ],
+        capabilities: ['model.read'],
+        reads: 'model',
+        run: (ctx, _i, p) => {
+            requireCapability(ctx, 'model.read');
+            return { entities: query(ctx, p.model).select(str(p.selector, 'selector')).toArray().map(toRef) };
+        },
+    },
+    {
+        type: 'model.byType',
+        title: 'By type',
+        category: 'model',
+        inputs: [],
+        outputs: [{ name: 'entities', type: ENTITY_LIST }],
+        params: [
+            { name: 'type', kind: 'string', default: 'IfcWall' },
+            { name: 'model', kind: 'string' },
+        ],
+        capabilities: ['model.read'],
+        reads: 'model',
+        run: (ctx, _i, p) => {
+            requireCapability(ctx, 'model.read');
+            return { entities: query(ctx, p.model).byType(str(p.type, 'type')).toArray().map(toRef) };
+        },
+    },
+    {
+        type: 'model.attribute',
+        title: 'Attribute',
+        category: 'model',
+        doc: 'Name, Type, Description, ObjectType or GlobalId of an entity.',
+        inputs: [{ name: 'entity', type: ENTITY_ITEM }],
+        outputs: [{ name: 'value', type: SCALAR_ITEM }],
+        params: [{ name: 'attribute', kind: 'enum', default: 'Name', options: ['Name', 'Type', 'Description', 'ObjectType', 'GlobalId'] }],
+        capabilities: ['model.read'],
+        reads: 'model',
+        run: (ctx, i, p) => {
+            requireCapability(ctx, 'model.read');
+            const e = entityOf(ctx, i.entity);
+            switch (p.attribute) {
+                case 'Name': return { value: e.name };
+                case 'Type': return { value: e.type };
+                case 'Description': return { value: e.description };
+                case 'ObjectType': return { value: e.objectType };
+                case 'GlobalId': return { value: e.globalId };
+                default: throw new Error(`unknown attribute "${String(p.attribute)}"`);
+            }
+        },
+    },
+    {
+        type: 'model.property',
+        title: 'Property',
+        category: 'model',
+        inputs: [{ name: 'entity', type: ENTITY_ITEM }],
+        outputs: [{ name: 'value', type: SCALAR_ITEM }],
+        params: [
+            { name: 'pset', kind: 'string', default: 'Pset_WallCommon' },
+            { name: 'property', kind: 'string', default: 'IsExternal' },
+        ],
+        capabilities: ['model.read'],
+        reads: 'model',
+        run: (ctx, i, p) => {
+            requireCapability(ctx, 'model.read');
+            return { value: ctx.host.bim.property(toSdkRef(ctx, i.entity), str(p.pset, 'pset'), str(p.property, 'property')) };
+        },
+    },
+    {
+        type: 'model.quantity',
+        title: 'Quantity',
+        category: 'model',
+        inputs: [{ name: 'entity', type: ENTITY_ITEM }],
+        outputs: [{ name: 'value', type: SCALAR_ITEM }],
+        params: [
+            { name: 'qset', kind: 'string', doc: 'Optional quantity set name.' },
+            { name: 'quantity', kind: 'string', default: 'NetVolume' },
+        ],
+        capabilities: ['model.read'],
+        reads: 'model',
+        run: (ctx, i, p) => {
+            requireCapability(ctx, 'model.read');
+            const ref = toSdkRef(ctx, i.entity);
+            const q = str(p.quantity, 'quantity');
+            const value = typeof p.qset === 'string' && p.qset.length > 0 ? ctx.host.bim.quantity(ref, p.qset, q) : ctx.host.bim.quantity(ref, q);
+            return { value };
+        },
+    },
+    {
+        type: 'model.related',
+        title: 'Related',
+        category: 'model',
+        doc: 'Entities linked by an IFC relationship, e.g. IfcRelVoidsElement forward = openings of a wall.',
+        inputs: [{ name: 'entity', type: ENTITY_ITEM }],
+        outputs: [{ name: 'related', type: ENTITY_LIST }],
+        params: [
+            { name: 'relationship', kind: 'string', default: 'IfcRelVoidsElement' },
+            { name: 'direction', kind: 'enum', default: 'forward', options: ['forward', 'inverse'] },
+        ],
+        capabilities: ['model.read'],
+        reads: 'model',
+        run: (ctx, i, p) => {
+            requireCapability(ctx, 'model.read');
+            const dir = p.direction === 'inverse' ? 'inverse' : 'forward';
+            return { related: ctx.host.bim.related(toSdkRef(ctx, i.entity), str(p.relationship, 'relationship'), dir).map(toRef) };
+        },
+    },
+    {
+        type: 'model.storey',
+        title: 'Storey',
+        category: 'model',
+        inputs: [{ name: 'entity', type: ENTITY_ITEM }],
+        outputs: [{ name: 'storey', type: ENTITY_ITEM }],
+        params: [],
+        capabilities: ['model.read'],
+        reads: 'model',
+        run: (ctx, i) => {
+            requireCapability(ctx, 'model.read');
+            const s = ctx.host.bim.storey(toSdkRef(ctx, i.entity));
+            return { storey: s ? toRef(s) : null };
+        },
+    },
+    {
+        type: 'model.contains',
+        title: 'Contained elements',
+        category: 'model',
+        inputs: [{ name: 'container', type: ENTITY_ITEM }],
+        outputs: [{ name: 'entities', type: ENTITY_LIST }],
+        params: [],
+        capabilities: ['model.read'],
+        reads: 'model',
+        run: (ctx, i) => {
+            requireCapability(ctx, 'model.read');
+            return { entities: ctx.host.bim.contains(toSdkRef(ctx, i.container)).map(toRef) };
+        },
+    },
+    {
+        type: 'model.groupByStorey',
+        title: 'Group by storey',
+        category: 'model',
+        doc: 'Entities under their storey GlobalId; entities with no storey go under "".',
+        inputs: [{ name: 'entities', type: ENTITY_LIST }],
+        outputs: [{ name: 'group', type: ENTITY_GROUP }],
+        params: [],
+        capabilities: ['model.read'],
+        reads: 'model',
+        run: (ctx, i) => {
+            requireCapability(ctx, 'model.read');
+            const group = new Map();
+            for (const ref of i.entities) {
+                const s = ctx.host.bim.storey(toSdkRef(ctx, ref));
+                const key = s?.globalId ?? '';
+                (group.get(key) ?? group.set(key, []).get(key)).push(ref);
+            }
+            return { group };
+        },
+    },
+    {
+        type: 'model.groupByType',
+        title: 'Group by type',
+        category: 'model',
+        inputs: [{ name: 'entities', type: ENTITY_LIST }],
+        outputs: [{ name: 'group', type: ENTITY_GROUP }],
+        params: [],
+        capabilities: ['model.read'],
+        reads: 'model',
+        run: (ctx, i) => {
+            requireCapability(ctx, 'model.read');
+            const group = new Map();
+            for (const ref of i.entities) {
+                const key = entityOf(ctx, ref).type;
+                (group.get(key) ?? group.set(key, []).get(key)).push(ref);
+            }
+            return { group };
+        },
+    },
+];
+//# sourceMappingURL=model-nodes.js.map

package/dist/model-nodes.js.map

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

package/dist/script-node.d.ts

@@ -0,0 +1,4 @@
+import { type FlowNodeDef } from './host.js';
+export declare const scriptNode: FlowNodeDef;
+export declare const scriptListNode: FlowNodeDef;
+//# sourceMappingURL=script-node.d.ts.map

package/dist/script-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"script-node.d.ts","sourceRoot":"","sources":["../src/script-node.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAmD,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAiF9F,eAAO,MAAM,UAAU,EAAE,WAgBxB,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,WAsB5B,CAAC"}

package/dist/script-node.js

@@ -0,0 +1,140 @@
+/* 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/. */
+/**
+ * `script.run` and `script.list` — the two nodes that execute user code, in
+ * the QuickJS sandbox (`bim.sandbox`), with the sandbox's own `bim` API.
+ * This is the Dynamo "Python Script" analog: the code sees `inputs.a/b/c`
+ * and the value of its last expression is the output.
+ *
+ * The two differ only in the access their ports declare, which is what
+ * decides whether the scheduler lifts them: `script.run` takes items, so a
+ * list arriving on `a` runs the code once per element; `script.list` takes
+ * whole lists and returns one, which is what ranking, sorting, and any
+ * whole-set computation needs (and what a per-item node cannot express).
+ *
+ * The sandbox `bim` is *not* the SDK `bim` the built-in nodes use (it has
+ * no `bcf`, `ids`, `spatial`); that difference is documented, not papered
+ * over. Sandbox permissions are derived from the graph's grants: mutation
+ * is only enabled when a `model.mutate` grant exists.
+ */
+import { createSandbox } from '@ifc-lite/sandbox';
+import { ANY_ITEM, ANY_LIST, requireCapability } from './host.js';
+/**
+ * One sandbox per (BimContext, permission set), kept for the lifetime of
+ * the context: QuickJS module init is the expensive part, and a graph with
+ * several Script nodes (or a re-run) must not pay it per lane. Created here
+ * rather than through `bim.sandbox` because that path dynamically imports
+ * `@ifc-lite/sandbox` relative to the SDK package, which a pnpm-isolated
+ * install cannot resolve headlessly.
+ */
+const sandboxes = new WeakMap();
+function sandboxFor(bim, permissions, timeoutMs) {
+    const key = JSON.stringify({ permissions, timeoutMs });
+    let perContext = sandboxes.get(bim);
+    if (!perContext) {
+        perContext = new Map();
+        sandboxes.set(bim, perContext);
+    }
+    let pending = perContext.get(key);
+    if (!pending) {
+        // A rejected creation (a wasm load failure, a transient resource limit)
+        // must not be cached: every later lane would await the same rejection for
+        // the lifetime of the context, turning one hiccup into a dead node.
+        pending = createSandbox(bim, { permissions, limits: { timeoutMs } }).catch((err) => {
+            if (perContext.get(key) === pending)
+                perContext.delete(key);
+            throw err;
+        });
+        perContext.set(key, pending);
+    }
+    return pending;
+}
+/** Evaluate `params.code` with `inputs` in scope and return its last expression. */
+async function evaluate(ctx, inputs, params) {
+    // The node declares `model.read`; without this check a graph granted
+    // nothing still got a sandbox with query+model on, so user code could
+    // read the model through a capability the graph never had.
+    requireCapability(ctx, 'model.read');
+    const grants = ctx.host.grants;
+    const has = (scope, action) => !grants || grants.some((g) => g.scope === scope && g.action === action);
+    const permissions = {
+        query: true,
+        model: true,
+        viewer: has('viewer', 'colorize') || has('viewer', 'isolate') || has('viewer', 'fly') || has('viewer', 'section'),
+        mutate: has('model', 'mutate'),
+        store: has('model', 'create'),
+        export: has('export', 'create'),
+        lens: true,
+        files: true,
+    };
+    const injected = JSON.stringify({ a: inputs.a ?? null, b: inputs.b ?? null, c: inputs.c ?? null });
+    // Every lane shares one sandbox, and QuickJS evaluates a program in the
+    // GLOBAL lexical scope — so a second lane re-running `const inputs = …`,
+    // or any `const` the user wrote, died with "redeclaration of 'x'". Every
+    // lane but the first then logged an error and yielded null, which a
+    // downstream filter reads as a legitimate answer. Running the source
+    // through a direct `eval` inside a function gives each lane its own
+    // variable environment while keeping the two things the node promises:
+    // `inputs` in scope, and the last expression as the value (`eval` returns
+    // its program's completion value, which a function body would not).
+    const code = `(function (inputs) { return eval(${JSON.stringify(String(params.code ?? ''))}); })(${injected})`;
+    const sandbox = await sandboxFor(ctx.host.bim, permissions, Number(params.timeoutMs) || 30_000);
+    // Plain JavaScript by contract: skipping the TypeScript strip avoids
+    // initialising esbuild-wasm, which only works in the browser. It is also
+    // what keeps the wrapper above honest — the source reaches `eval`
+    // verbatim, not as something a transpiler rewrote.
+    const result = await sandbox.eval(code, { typescript: false });
+    for (const entry of result.logs) {
+        const level = entry.level === 'error' ? 'error' : entry.level === 'warn' ? 'warn' : 'info';
+        ctx.log(level, entry.args.map((a) => (typeof a === 'string' ? a : JSON.stringify(a))).join(' '));
+    }
+    return result.value ?? null;
+}
+/** The shared editable surface, so the two nodes cannot drift apart. */
+const SCRIPT_PARAMS = [
+    { name: 'code', kind: 'code', language: 'javascript', default: 'inputs.a', doc: 'JavaScript (not TypeScript). The value of the last expression is the output.' },
+    { name: 'timeoutMs', kind: 'number', default: 30_000, doc: 'Hard limit per evaluation; the sandbox is interrupted when it is exceeded.' },
+];
+export const scriptNode = {
+    type: 'script.run',
+    title: 'Script',
+    category: 'script',
+    doc: 'Runs JavaScript (not TypeScript) in the sandbox with `inputs.a`, `inputs.b`, `inputs.c` and the sandbox `bim` API; the last expression is `result`. A list on an input runs the code once per element. An entity arrives as `{ globalId, modelId, expressId }`, which is also a `bim.*` ref.',
+    inputs: [
+        { name: 'a', type: ANY_ITEM, optional: true, nullable: true },
+        { name: 'b', type: ANY_ITEM, optional: true, nullable: true },
+        { name: 'c', type: ANY_ITEM, optional: true, nullable: true },
+    ],
+    outputs: [{ name: 'result', type: ANY_ITEM }],
+    params: [...SCRIPT_PARAMS],
+    capabilities: ['model.read'],
+    reads: 'model',
+    requires: { backend: ['sandbox'] },
+    run: async (ctx, inputs, params) => ({ result: await evaluate(ctx, inputs, params) }),
+};
+export const scriptListNode = {
+    type: 'script.list',
+    title: 'Script (list)',
+    category: 'script',
+    doc: 'Like Script, but `inputs.a/b/c` are whole lists and the last expression must be an array — for sorting, ranking, and anything that needs the whole set at once.',
+    inputs: [
+        { name: 'a', type: ANY_LIST, optional: true },
+        { name: 'b', type: ANY_LIST, optional: true },
+        { name: 'c', type: ANY_LIST, optional: true },
+    ],
+    outputs: [{ name: 'items', type: ANY_LIST }],
+    params: [...SCRIPT_PARAMS],
+    capabilities: ['model.read'],
+    reads: 'model',
+    requires: { backend: ['sandbox'] },
+    run: async (ctx, inputs, params) => {
+        const value = await evaluate(ctx, inputs, params);
+        // An `items` port hands its value straight to downstream list ports; a
+        // non-array here would reach them as a list-shaped value that is not one.
+        if (!Array.isArray(value))
+            throw new Error(`script.list must end in an array, got ${value === null ? 'null' : typeof value}`);
+        return { items: value };
+    },
+};
+//# sourceMappingURL=script-node.js.map

package/dist/script-node.js.map

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

package/dist/strict-cell.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Is a spreadsheet cell's text a COMPLETE value of its column's type?
+ *
+ * `@ifc-lite/mutations`' `parseValue` is lenient by construction: `parseFloat`
+ * reads the longest numeric prefix, so `"12,5"` becomes 12 and `"60abc"`
+ * becomes 60, and every string other than true/yes/1 becomes `false`. A
+ * European CSV (`12,5` in a Real column) therefore wrote 12 into the model
+ * with nothing reported. This check runs first at every table→value boundary
+ * (the CSV and XLSX readers, and `model.applyTable`), so a value is either
+ * exactly what the cell says or reported and left unwritten (#5377 review).
+ */
+import type { ColumnType } from '@ifc-lite/flow';
+import { PARSE_INVALID, type PropertyValue } from '@ifc-lite/mutations';
+/**
+ * Parse a cell as its column's type, or {@link PARSE_INVALID}. The text is
+ * trimmed ONCE and the same text is both checked and parsed: checking the
+ * trimmed text but parsing the raw one accepted `" true "` and wrote `false`.
+ */
+export declare function parseStrictCell(raw: string, type: ColumnType): PropertyValue | typeof PARSE_INVALID;
+//# sourceMappingURL=strict-cell.d.ts.map

package/dist/strict-cell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strict-cell.d.ts","sourceRoot":"","sources":["../src/strict-cell.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAc,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAuBpF;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,aAAa,GAAG,OAAO,aAAa,CAGnG"}

package/dist/strict-cell.js

@@ -0,0 +1,33 @@
+/* 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 { PARSE_INVALID, parseValue } from '@ifc-lite/mutations';
+import { VALUE_TYPE_BY_COLUMN_TYPE } from './table-nodes.js';
+const REAL = /^[+-]?(\d+\.?\d*|\.\d+)([eE][+-]?\d+)?$/;
+const INTEGER = /^[+-]?\d+$/;
+/**
+ * IFC LOGICAL's UNKNOWN is deliberately absent: the property model carries a
+ * boolean, and writing UNKNOWN as `false` would state a fact the sheet did not.
+ */
+const BOOLEAN = /^(true|false|yes|no|1|0)$/i;
+function isStrictlyTyped(text, type) {
+    switch (type) {
+        // The syntax alone admits `1e309` (Infinity) and integers past 2^53
+        // (silently rounded), so the value itself is checked too.
+        case 'real': return REAL.test(text) && Number.isFinite(Number(text));
+        case 'integer': return INTEGER.test(text) && Number.isSafeInteger(Number(text));
+        case 'boolean':
+        case 'logical': return BOOLEAN.test(text);
+        default: return true;
+    }
+}
+/**
+ * Parse a cell as its column's type, or {@link PARSE_INVALID}. The text is
+ * trimmed ONCE and the same text is both checked and parsed: checking the
+ * trimmed text but parsing the raw one accepted `" true "` and wrote `false`.
+ */
+export function parseStrictCell(raw, type) {
+    const text = raw.trim();
+    return isStrictlyTyped(text, type) ? parseValue(text, VALUE_TYPE_BY_COLUMN_TYPE[type]) : PARSE_INVALID;
+}
+//# sourceMappingURL=strict-cell.js.map

package/dist/strict-cell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strict-cell.js","sourceRoot":"","sources":["../src/strict-cell.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAe/D,OAAO,EAAE,aAAa,EAAE,UAAU,EAAsB,MAAM,qBAAqB,CAAC;AACpF,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAE7D,MAAM,IAAI,GAAG,yCAAyC,CAAC;AACvD,MAAM,OAAO,GAAG,YAAY,CAAC;AAC7B;;;GAGG;AACH,MAAM,OAAO,GAAG,4BAA4B,CAAC;AAE7C,SAAS,eAAe,CAAC,IAAY,EAAE,IAAgB;IACrD,QAAQ,IAAI,EAAE,CAAC;QACb,oEAAoE;QACpE,0DAA0D;QAC1D,KAAK,MAAM,CAAC,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QACrE,KAAK,SAAS,CAAC,CAAC,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QAChF,KAAK,SAAS,CAAC;QACf,KAAK,SAAS,CAAC,CAAC,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1C,OAAO,CAAC,CAAC,OAAO,IAAI,CAAC;IACvB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW,EAAE,IAAgB;IAC3D,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACxB,OAAO,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,yBAAyB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;AACzG,CAAC"}

package/dist/table-nodes.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `table.*` — typed tables to and from entities.
+ *
+ * `table.fromEntities` is the Excel export loop's first half: one row per
+ * entity, keyed by GlobalId, every column stamped with the IFC value type
+ * and (for properties) its pset/prop binding so `ApplyTable` can write it
+ * back without guessing. `table.longFormat` is the canonical
+ * (GlobalId, Pset, Prop, Value, Type) shape that `pivot` widens.
+ */
+import { PropertyValueType } from '@ifc-lite/data';
+import { type ColumnType, type Table } from '@ifc-lite/flow';
+import { type FlowNodeDef } from './host.js';
+export declare function columnTypeOf(valueType: number): ColumnType;
+export declare const VALUE_TYPE_BY_COLUMN_TYPE: Readonly<Record<ColumnType, PropertyValueType>>;
+export declare function tableOf(v: unknown): Table;
+export declare const tableNodes: FlowNodeDef[];
+//# sourceMappingURL=table-nodes.d.ts.map

package/dist/table-nodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-nodes.d.ts","sourceRoot":"","sources":["../src/table-nodes.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAA2D,KAAK,UAAU,EAA2C,KAAK,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE/J,OAAO,EAAuG,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAgBlJ,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,CAE1D;AAED,eAAO,MAAM,yBAAyB,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAYrF,CAAC;AAIF,wBAAgB,OAAO,CAAC,CAAC,EAAE,OAAO,GAAG,KAAK,CAIzC;AASD,eAAO,MAAM,UAAU,EAAE,WAAW,EAwInC,CAAC"}