@ifc-lite/flow-nodes 0.2.0 → 0.5.0

package/dist/speckle/mapping.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Speckle object graph → planned IFC elements (mapping v1). Pure: no I/O,
+ * no model access. See docs/architecture/speckle-mapping.md for the table.
+ *
+ *   Objects.BuiltElements.Wall    → IfcWall   (straight location line, height, WALL_ATTR_WIDTH_PARAM)
+ *   Objects.BuiltElements.Floor   → IfcSlab   (flat polygonal outline, FLOOR_ATTR_THICKNESS_PARAM)
+ *   Objects.BuiltElements.Roof    → IfcRoof   (flat polygonal footprint, ROOF_ATTR_THICKNESS_PARAM)
+ *   Objects.BuiltElements.Column  → IfcColumn (vertical, unrotated location line, `b` × `h`)
+ *   Objects.BuiltElements.Beam    → IfcBeam   (straight location line, `b` × `h`)
+ *
+ * The body is rebuilt parametrically through the same `bim.store.add*`
+ * builders `model.addElement` uses; `bim.store` has no tessellated-body
+ * writer, so display meshes are counted and reported, never written.
+ * Coordinates are made relative to the element's own Speckle level and
+ * written into the one target storey.
+ *
+ * The walk is iterative with a global visited set (the output for an id is
+ * a pure function of that id, so revisits are skipped, not re-counted).
+ */
+import type { AddBeamInStoreParams, AddColumnInStoreParams, AddRoofPolygonParams, AddSlabPolygonParams, AddWallInStoreParams } from '@ifc-lite/sdk';
+import type { SpeckleObject } from './client.js';
+import { type ParamValue } from './parameters.js';
+import { RefusalLog, type SpeckleRefusal } from './refusals.js';
+export declare const PSET_SOURCE = "Speckle_Source";
+export declare const PSET_TYPE = "Speckle_TypeParameters";
+export declare const PSET_INSTANCE = "Speckle_InstanceParameters";
+export type PlannedElement = {
+    /** Stable identity across versions: the Revit `applicationId`, else the Speckle id. */
+    readonly key: string;
+    readonly speckleType: string;
+    readonly speckleId: string;
+    readonly psets: Readonly<Record<string, Readonly<Record<string, ParamValue>>>>;
+    readonly displayMeshes: number;
+    readonly skippedEntries: number;
+} & ({
+    readonly kind: 'wall';
+    readonly params: AddWallInStoreParams;
+} | {
+    readonly kind: 'slab';
+    readonly params: AddSlabPolygonParams;
+} | {
+    readonly kind: 'roof';
+    readonly params: AddRoofPolygonParams;
+} | {
+    readonly kind: 'column';
+    readonly params: AddColumnInStoreParams;
+} | {
+    readonly kind: 'beam';
+    readonly params: AddBeamInStoreParams;
+});
+export interface MappingOptions {
+    /** Only elements on this Speckle level (by name); empty = every level. */
+    readonly level?: string;
+}
+export interface MappingResult {
+    readonly planned: PlannedElement[];
+    readonly refusals: RefusalLog;
+}
+/** Walk the fetched graph from its root and plan every mappable element. */
+export declare function mapSpeckleGraph(objects: ReadonlyMap<string, SpeckleObject>, rootId: string, opts?: MappingOptions): MappingResult;
+export type { SpeckleRefusal };
+//# sourceMappingURL=mapping.d.ts.map

package/dist/speckle/mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping.d.ts","sourceRoot":"","sources":["../../src/speckle/mapping.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACpJ,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD,OAAO,EAAuC,KAAK,UAAU,EAAyB,MAAM,iBAAiB,CAAC;AAC9G,OAAO,EAAE,UAAU,EAAE,KAAK,cAAc,EAA6B,MAAM,eAAe,CAAC;AAG3F,eAAO,MAAM,WAAW,mBAAmB,CAAC;AAC5C,eAAO,MAAM,SAAS,2BAA2B,CAAC;AAClD,eAAO,MAAM,aAAa,+BAA+B,CAAC;AAI1D,MAAM,MAAM,cAAc,GAAG;IAC3B,uFAAuF;IACvF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/E,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC,GAAG,CACA;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAA;CAAE,GAChE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAA;CAAE,GAChE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAA;CAAE,GAChE;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAA;CAAE,GACpE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAA;CAAE,CACnE,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,cAAc,EAAE,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;CAC/B;AAiKD,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,cAAmB,GAAG,aAAa,CAwBrI;AAED,YAAY,EAAE,cAAc,EAAE,CAAC"}

package/dist/speckle/mapping.js

@@ -0,0 +1,208 @@
+/* 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 { DISPLAY_KEYS } from './client.js';
+import { isA, leafType, lineOf, outlineOf, resolverFor } from './geometry.js';
+import { dimension, psetRows, readParameters } from './parameters.js';
+import { RefusalLog } from './refusals.js';
+import { lengthScale } from './units.js';
+export const PSET_SOURCE = 'Speckle_Source';
+export const PSET_TYPE = 'Speckle_TypeParameters';
+export const PSET_INSTANCE = 'Speckle_InstanceParameters';
+const KINDS = [
+    ['Objects.BuiltElements.Wall', 'wall'],
+    ['Objects.BuiltElements.Floor', 'slab'],
+    ['Objects.BuiltElements.Roof', 'roof'],
+    ['Objects.BuiltElements.Column', 'column'],
+    ['Objects.BuiltElements.Beam', 'beam'],
+];
+const kindOf = (o) => KINDS.find(([base]) => isA(o, base))?.[1];
+function isContainer(o) {
+    const t = typeof o.speckle_type === 'string' ? o.speckle_type : 'Base';
+    return t === 'Base' || isA(o, 'Speckle.Core.Models.Collections.Collection') || t.startsWith('Objects.Organization.');
+}
+/** Child slots a container is walked through: `elements` and dynamic `@`-detached members. */
+function childSlots(o) {
+    const out = [];
+    for (const [k, v] of Object.entries(o)) {
+        if (DISPLAY_KEYS.has(k) || (k !== 'elements' && !k.startsWith('@')))
+            continue;
+        if (Array.isArray(v))
+            out.push(...v);
+        else if (v !== null && typeof v === 'object')
+            out.push(v);
+    }
+    return out;
+}
+/** Display geometry under every key the client skips; a bare object counts as one. */
+function displayCount(o) {
+    let n = 0;
+    for (const key of DISPLAY_KEYS) {
+        const v = o[key];
+        if (Array.isArray(v))
+            n += v.length;
+        else if (v !== null && typeof v === 'object')
+            n += 1;
+    }
+    return n;
+}
+class Refused extends Error {
+    reason;
+    constructor(reason, detail) {
+        super(detail);
+        this.reason = reason;
+    }
+}
+const TOL = 1e-4;
+const str = (v) => (typeof v === 'string' && v.length > 0 ? v : v === null || v === undefined ? undefined : String(v));
+const xy = (p) => [p[0], p[1]];
+function required(params, internal, label) {
+    const d = dimension(params, internal);
+    if ('reason' in d)
+        throw new Refused('missing-dimension', `${d.reason} (${label})`);
+    return d.value;
+}
+function line(resolve, o) {
+    const l = lineOf(resolve, o.baseLine, o.units);
+    if ('reason' in l)
+        throw new Refused('geometry', l.reason);
+    return l;
+}
+function flatOutline(resolve, o) {
+    if (typeof o.slope === 'number' && Math.abs(o.slope) > 1e-9)
+        throw new Refused('geometry', 'is sloped; v1 writes flat slabs and roofs only');
+    if (Array.isArray(o.voids) && o.voids.length > 0)
+        throw new Refused('openings', 'has openings (voids), which a v1 extrusion would fill in');
+    const outline = outlineOf(resolve, o.outline, o.units);
+    if ('reason' in outline)
+        throw new Refused('geometry', outline.reason);
+    return outline.points;
+}
+function plan(resolve, o, kind, params, elevation) {
+    const header = {
+        Name: [str(o.family), str(o.type)].filter((s) => s !== undefined).join(': ') || leafType(o),
+        ObjectType: str(o.type),
+        Tag: str(o.elementId),
+    };
+    const local = (p) => [p[0], p[1], p[2] - elevation];
+    switch (kind) {
+        case 'wall': {
+            const { start, end } = line(resolve, o);
+            if (Math.abs(start[2] - end[2]) > TOL)
+                throw new Refused('geometry', 'has a location line that is not horizontal');
+            const height = typeof o.height === 'number' && o.height > 0 ? o.height * (lengthScale(o.units) ?? Number.NaN) : Number.NaN;
+            if (!Number.isFinite(height))
+                throw new Refused('missing-dimension', 'no positive height');
+            return { kind, params: { ...header, Start: local(start), End: local(end), Height: height, Thickness: required(params, 'WALL_ATTR_WIDTH_PARAM', 'Width') } };
+        }
+        case 'slab': {
+            const points = flatOutline(resolve, o);
+            const thickness = required(params, 'FLOOR_ATTR_THICKNESS_PARAM', 'Thickness');
+            // A Revit floor's outline is its top face at the level: the slab hangs below it.
+            return { kind, params: { ...header, Profile: 'polygon', OuterCurve: points.map(xy), Position: [0, 0, points[0][2] - elevation - thickness], Thickness: thickness } };
+        }
+        case 'roof': {
+            if (isA(o, 'Objects.BuiltElements.Revit.RevitRoof.RevitExtrusionRoof'))
+                throw new Refused('geometry', 'is an extrusion roof (a profile swept along a path)');
+            const points = flatOutline(resolve, o);
+            const thickness = required(params, 'ROOF_ATTR_THICKNESS_PARAM', 'Thickness');
+            return { kind, params: { ...header, Profile: 'polygon', OuterCurve: points.map(xy), Position: [0, 0, points[0][2] - elevation], Thickness: thickness } };
+        }
+        case 'column': {
+            const { start, end } = line(resolve, o);
+            if (Math.abs(start[0] - end[0]) > TOL || Math.abs(start[1] - end[1]) > TOL)
+                throw new Refused('geometry', 'is slanted; v1 writes vertical columns only');
+            if (typeof o.rotation === 'number' && Math.abs(o.rotation) > 1e-9)
+                throw new Refused('geometry', 'is rotated about its axis, which the column writer cannot express');
+            const base = start[2] <= end[2] ? start : end;
+            const height = Math.abs(end[2] - start[2]);
+            if (height <= TOL)
+                throw new Refused('missing-dimension', 'no height (zero-length location line)');
+            return { kind, params: { ...header, Position: local(base), Height: height, Width: required(params, 'b', 'b'), Depth: required(params, 'h', 'h') } };
+        }
+        case 'beam': {
+            const { start, end } = line(resolve, o);
+            return { kind, params: { ...header, Start: local(start), End: local(end), Width: required(params, 'b', 'b'), Height: required(params, 'h', 'h') } };
+        }
+    }
+}
+function sourcePset(o, levelName) {
+    const rows = { SpeckleId: o.id, SpeckleType: String(o.speckle_type) };
+    const add = (k, v) => {
+        const s = str(v);
+        if (s !== undefined)
+            rows[k] = s;
+    };
+    add('ApplicationId', o.applicationId);
+    add('Category', o.category);
+    add('Family', o.family);
+    add('Type', o.type);
+    add('ElementId', o.elementId);
+    add('Level', levelName);
+    add('SourceUnits', o.units);
+    return rows;
+}
+function mapElement(resolve, o, kind, opts, log, planned) {
+    const type = leafType(o);
+    const level = resolve(o.level);
+    const levelName = str(level?.name);
+    if (opts.level && levelName !== opts.level) {
+        log.add(type, 'other-level', `on level "${levelName ?? '(none)'}", not the requested level "${opts.level}"`, o.id);
+        return;
+    }
+    const scale = lengthScale(o.units);
+    if (scale === undefined) {
+        log.add(type, 'no-units', `units "${String(o.units ?? '(none)')}" is not a length unit`, o.id);
+        return;
+    }
+    const elevation = typeof level?.elevation === 'number' ? level.elevation * (lengthScale(level.units) ?? scale) : 0;
+    const { parameters, skipped } = readParameters(resolve, o);
+    try {
+        const p = plan(resolve, o, kind, parameters, elevation);
+        planned.push({
+            ...p,
+            key: str(o.applicationId) ?? o.id,
+            speckleType: type,
+            speckleId: o.id,
+            psets: { [PSET_SOURCE]: sourcePset(o, levelName), [PSET_TYPE]: psetRows(parameters, 'type'), [PSET_INSTANCE]: psetRows(parameters, 'instance') },
+            displayMeshes: displayCount(o),
+            skippedEntries: skipped,
+        });
+    }
+    catch (err) {
+        if (!(err instanceof Refused))
+            throw err;
+        log.add(type, err.reason, err.message, o.id);
+    }
+}
+/** Walk the fetched graph from its root and plan every mappable element. */
+export function mapSpeckleGraph(objects, rootId, opts = {}) {
+    const resolve = resolverFor(objects);
+    const log = new RefusalLog();
+    const planned = [];
+    const root = objects.get(rootId);
+    if (!root)
+        throw new Error(`speckle.receive: root object ${rootId} was not fetched`);
+    const seen = new Set();
+    const stack = [root];
+    while (stack.length > 0) {
+        const o = resolve(stack.pop());
+        if (!o || typeof o.id !== 'string' || seen.has(o.id))
+            continue;
+        seen.add(o.id);
+        const kind = kindOf(o);
+        if (kind)
+            mapElement(resolve, o, kind, opts, log, planned);
+        else if (!isContainer(o)) {
+            log.add(leafType(o), 'unmapped-type', 'has no v1 mapping', o.id);
+            continue;
+        }
+        // Containers, and hosted elements under a mapped one (a stacked wall's
+        // layers, a wall's doors), are walked in document order.
+        const children = kind ? (Array.isArray(o.elements) ? o.elements : []) : childSlots(o);
+        for (let i = children.length - 1; i >= 0; i--)
+            stack.push(children[i]);
+    }
+    return { planned, refusals: log };
+}
+//# sourceMappingURL=mapping.js.map

package/dist/speckle/mapping.js.map

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

package/dist/speckle/parameters.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Revit parameters on a Speckle object, in both shapes the Revit connector
+ * has written:
+ *
+ *   - `properties["Type Parameters" | "Instance Parameters"][group][name]`
+ *     = `{ name, value, units?, internalDefinitionName }` (current v2 output);
+ *   - `parameters[internalName]` = `Objects.BuiltElements.Revit.Parameter`
+ *     `{ name, value, units, isTypeParameter, applicationInternalName }` (older).
+ *
+ * Lengths, areas and volumes are converted to metres / m² / m³; every other
+ * unit is carried as authored. An entry with no scalar `value` (a compound
+ * structure layer, a nested table) is not a parameter and is counted so the
+ * caller can report it.
+ */
+import type { Resolver } from './geometry.js';
+import { type Quantity } from './units.js';
+export type ParamValue = string | number | boolean;
+export interface SpeckleParameter {
+    readonly scope: 'type' | 'instance';
+    readonly name: string;
+    /** Revit's BuiltInParameter / shared-parameter name, e.g. `WALL_ATTR_WIDTH_PARAM`. */
+    readonly internalName?: string;
+    /** Converted to SI when the unit is a length, area or volume. */
+    readonly value: ParamValue;
+    /** What `value` was converted as; absent when it is carried as authored (no unit, or one the tables do not know). */
+    readonly quantity?: Quantity;
+    /** The unit label as authored, if any. */
+    readonly units?: string;
+}
+export interface ParameterRead {
+    readonly parameters: SpeckleParameter[];
+    /** Entries under a parameter scope that carry no scalar value. */
+    readonly skipped: number;
+}
+export declare function readParameters(resolve: Resolver, obj: Record<string, unknown>): ParameterRead;
+/**
+ * A positive length parameter by internal name, in metres, instance before
+ * type — or why there is none. Only a value that was actually CONVERTED as a
+ * length counts: a unit label outside the tables ("Feet and fractional
+ * inches", "Fractional inches", none at all) is never read as metres.
+ */
+export declare function dimension(params: readonly SpeckleParameter[], internalName: string): {
+    value: number;
+} | {
+    reason: string;
+};
+/** Property-set rows for one scope; a repeated display name keeps both, the later one qualified by its internal name. */
+export declare function psetRows(params: readonly SpeckleParameter[], scope: 'type' | 'instance'): Record<string, ParamValue>;
+//# sourceMappingURL=parameters.d.ts.map

package/dist/speckle/parameters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameters.d.ts","sourceRoot":"","sources":["../../src/speckle/parameters.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3D,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEnD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sFAAsF;IACtF,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,qHAAqH;IACrH,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC7B,0CAA0C;IAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,EAAE,gBAAgB,EAAE,CAAC;IACxC,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AA0BD,wBAAgB,cAAc,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,aAAa,CA2B7F;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,EAAE,YAAY,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAQ3H;AAED,yHAAyH;AACzH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAYpH"}

package/dist/speckle/parameters.js

@@ -0,0 +1,95 @@
+/* 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 { parameterScale } from './units.js';
+const isScalar = (v) => typeof v === 'string' || typeof v === 'boolean' || (typeof v === 'number' && Number.isFinite(v));
+function convert(value, units) {
+    if (typeof value !== 'number')
+        return { value };
+    const scale = parameterScale(units);
+    return scale ? { value: value * scale.factor, quantity: scale.quantity } : { value };
+}
+function entry(scope, key, raw) {
+    if (!isScalar(raw.value))
+        return undefined;
+    const name = typeof raw.name === 'string' && raw.name.length > 0 ? raw.name : key;
+    const internal = raw.internalDefinitionName ?? raw.applicationInternalName;
+    return {
+        scope,
+        name,
+        internalName: typeof internal === 'string' ? internal : undefined,
+        ...convert(raw.value, raw.units),
+        units: typeof raw.units === 'string' ? raw.units : undefined,
+    };
+}
+const SCOPES = [['Type Parameters', 'type'], ['Instance Parameters', 'instance']];
+export function readParameters(resolve, obj) {
+    const parameters = [];
+    let skipped = 0;
+    const properties = resolve(obj.properties);
+    for (const [key, scope] of SCOPES) {
+        const groups = resolve(properties?.[key]);
+        for (const group of Object.values(groups ?? {})) {
+            const g = resolve(group);
+            if (!g)
+                continue;
+            for (const [name, raw] of Object.entries(g)) {
+                const r = resolve(raw);
+                if (!r)
+                    continue;
+                const p = entry(scope, name, r);
+                if (p)
+                    parameters.push(p);
+                else
+                    skipped++;
+            }
+        }
+    }
+    const legacy = resolve(obj.parameters);
+    for (const [key, raw] of Object.entries(legacy ?? {})) {
+        const r = resolve(raw);
+        if (!r || !('value' in r))
+            continue; // `id`, `speckle_type`, … of the container itself
+        const p = entry(r.isTypeParameter === true ? 'type' : 'instance', key, r);
+        if (p)
+            parameters.push(p);
+        else
+            skipped++;
+    }
+    return { parameters, skipped };
+}
+/**
+ * A positive length parameter by internal name, in metres, instance before
+ * type — or why there is none. Only a value that was actually CONVERTED as a
+ * length counts: a unit label outside the tables ("Feet and fractional
+ * inches", "Fractional inches", none at all) is never read as metres.
+ */
+export function dimension(params, internalName) {
+    const hits = params.filter((p) => p.internalName === internalName && typeof p.value === 'number' && p.value > 0);
+    const pick = (ps) => ps.find((p) => p.scope === 'instance') ?? ps[0];
+    const converted = pick(hits.filter((p) => p.quantity === 'length'));
+    if (converted)
+        return { value: converted.value };
+    const other = pick(hits);
+    if (other)
+        return { reason: `${internalName} has unit "${other.units ?? '(none)'}", which is not a supported length unit` };
+    return { reason: `no positive ${internalName} parameter` };
+}
+/** Property-set rows for one scope; a repeated display name keeps both, the later one qualified by its internal name. */
+export function psetRows(params, scope) {
+    // Null prototype: parameter names come from the server, and `__proto__`,
+    // `constructor` or `toString` must be ordinary keys, not Object.prototype.
+    const rows = Object.create(null);
+    for (const p of params) {
+        if (p.scope !== scope)
+            continue;
+        let key = p.name;
+        if (key in rows)
+            key = `${p.name} (${p.internalName ?? 'duplicate'})`;
+        for (let n = 2; key in rows; n++)
+            key = `${p.name} (${p.internalName ?? 'duplicate'} ${n})`;
+        rows[key] = p.value;
+    }
+    return rows;
+}
+//# sourceMappingURL=parameters.js.map

package/dist/speckle/parameters.js.map

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

package/dist/speckle/refusals.d.ts

@@ -0,0 +1,45 @@
+/**
+ * What a Speckle receive did NOT write, by name and count.
+ *
+ * Same contract as the LandXML mapping's refusals (`@ifc-lite/create`
+ * `landxml/refusals.ts`): nothing is dropped silently. "14 RevitElement
+ * objects have no v1 mapping" is actionable; an element that is simply
+ * absent from the IFC is not even noticeable.
+ */
+export type SpeckleRefusalReason = 
+/** The object's type has no v1 mapping at all. */
+'unmapped-type'
+/** A mapped type whose geometry v1 cannot reproduce (curved, sloped, slanted, rotated, …). */
+ | 'geometry'
+/** A mapped type missing a dimension its IFC builder needs (thickness, section size, height). */
+ | 'missing-dimension'
+/** A floor or roof with openings, which v1 would fill in. */
+ | 'openings'
+/** No length unit to convert from. */
+ | 'no-units'
+/** Excluded by the node's `level` filter. */
+ | 'other-level'
+/** The IFC writer rejected the mapped element. */
+ | 'write-failed'
+/** Re-receive: the new version was rejected, and the element from the earlier receive was KEPT (not replaced). */
+ | 'write-failed-kept-previous'
+/** Display meshes of written elements, which are not carried (the body is rebuilt parametrically). */
+ | 'display-meshes'
+/** Property entries that are not scalar parameters (compound structure layers, nested tables). */
+ | 'non-parameter-entries';
+export interface SpeckleRefusal {
+    /** The most-derived `speckle_type` link, e.g. `RevitWall`. */
+    readonly speckleType: string;
+    readonly reason: SpeckleRefusalReason;
+    readonly count: number;
+    readonly message: string;
+    /** Up to five Speckle object ids, so the operator can find them. */
+    readonly examples: readonly string[];
+}
+export declare class RefusalLog {
+    private readonly buckets;
+    /** Count `n` refused things of one type, for one reason, with one explanation. */
+    add(speckleType: string, reason: SpeckleRefusalReason, detail: string, id: string | undefined, n?: number): void;
+    list(): SpeckleRefusal[];
+}
+//# sourceMappingURL=refusals.d.ts.map

package/dist/speckle/refusals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refusals.d.ts","sourceRoot":"","sources":["../../src/speckle/refusals.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AAEH,MAAM,MAAM,oBAAoB;AAC9B,kDAAkD;AAChD,eAAe;AACjB,8FAA8F;GAC5F,UAAU;AACZ,iGAAiG;GAC/F,mBAAmB;AACrB,6DAA6D;GAC3D,UAAU;AACZ,sCAAsC;GACpC,UAAU;AACZ,6CAA6C;GAC3C,aAAa;AACf,kDAAkD;GAChD,cAAc;AAChB,kHAAkH;GAChH,4BAA4B;AAC9B,sGAAsG;GACpG,gBAAgB;AAClB,kGAAkG;GAChG,uBAAuB,CAAC;AAE5B,MAAM,WAAW,cAAc;IAC7B,8DAA8D;IAC9D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAYD,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IAErD,kFAAkF;IAClF,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC,SAAI,GAAG,IAAI;IAS3G,IAAI,IAAI,cAAc,EAAE;CASzB"}

package/dist/speckle/refusals.js

@@ -0,0 +1,40 @@
+/* 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/. */
+const MAX_EXAMPLES = 5;
+export class RefusalLog {
+    buckets = new Map();
+    /** Count `n` refused things of one type, for one reason, with one explanation. */
+    add(speckleType, reason, detail, id, n = 1) {
+        if (n <= 0)
+            return;
+        const key = `${speckleType}\u0000${reason}\u0000${detail}`;
+        let b = this.buckets.get(key);
+        if (!b)
+            this.buckets.set(key, (b = { speckleType, reason, detail, count: 0, examples: [] }));
+        b.count += n;
+        if (id !== undefined && b.examples.length < MAX_EXAMPLES && !b.examples.includes(id))
+            b.examples.push(id);
+    }
+    list() {
+        return [...this.buckets.values()].map((b) => ({
+            speckleType: b.speckleType,
+            reason: b.reason,
+            count: b.count,
+            message: messageOf(b),
+            examples: b.examples,
+        }));
+    }
+}
+function messageOf(b) {
+    const plural = b.count === 1 ? '' : 's';
+    switch (b.reason) {
+        case 'display-meshes':
+            return `${b.count} display mesh${b.count === 1 ? '' : 'es'} on written ${b.speckleType} elements not carried: ${b.detail}.`;
+        case 'non-parameter-entries':
+            return `${b.count} property entr${b.count === 1 ? 'y' : 'ies'} on written ${b.speckleType} elements not carried: ${b.detail}.`;
+        default:
+            return `${b.count} ${b.speckleType} object${plural} not written: ${b.detail}.`;
+    }
+}
+//# sourceMappingURL=refusals.js.map

package/dist/speckle/refusals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refusals.js","sourceRoot":"","sources":["../../src/speckle/refusals.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AA2C/D,MAAM,YAAY,GAAG,CAAC,CAAC;AAUvB,MAAM,OAAO,UAAU;IACJ,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAErD,kFAAkF;IAClF,GAAG,CAAC,WAAmB,EAAE,MAA4B,EAAE,MAAc,EAAE,EAAsB,EAAE,CAAC,GAAG,CAAC;QAClG,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO;QACnB,MAAM,GAAG,GAAG,GAAG,WAAW,SAAS,MAAM,SAAS,MAAM,EAAE,CAAC;QAC3D,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,CAAC,CAAC;YAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QAC7F,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;QACb,IAAI,EAAE,KAAK,SAAS,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,YAAY,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5G,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5C,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;YACrB,QAAQ,EAAE,CAAC,CAAC,QAAQ;SACrB,CAAC,CAAC,CAAC;IACN,CAAC;CACF;AAED,SAAS,SAAS,CAAC,CAAS;IAC1B,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;IACxC,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC;QACjB,KAAK,gBAAgB;YACnB,OAAO,GAAG,CAAC,CAAC,KAAK,gBAAgB,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,eAAe,CAAC,CAAC,WAAW,0BAA0B,CAAC,CAAC,MAAM,GAAG,CAAC;QAC9H,KAAK,uBAAuB;YAC1B,OAAO,GAAG,CAAC,CAAC,KAAK,iBAAiB,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,eAAe,CAAC,CAAC,WAAW,0BAA0B,CAAC,CAAC,MAAM,GAAG,CAAC;QACjI;YACE,OAAO,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,WAAW,UAAU,MAAM,iBAAiB,CAAC,CAAC,MAAM,GAAG,CAAC;IACnF,CAAC;AACH,CAAC"}

package/dist/speckle/units.d.ts

@@ -0,0 +1,13 @@
+/** Metres per one `units`, or undefined when `units` is not a length unit (including Speckle's `none`). */
+export declare function lengthScale(units: unknown): number | undefined;
+export type Quantity = 'length' | 'area' | 'volume';
+/**
+ * The quantity and SI factor of a parameter unit, e.g. `Square meters` →
+ * area × 1, `Cubic feet` → volume × 0.0283…; undefined for anything else
+ * (`Currency`, `Degrees`, …).
+ */
+export declare function parameterScale(units: unknown): {
+    quantity: Quantity;
+    factor: number;
+} | undefined;
+//# sourceMappingURL=units.d.ts.map

package/dist/speckle/units.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"units.d.ts","sourceRoot":"","sources":["../../src/speckle/units.ts"],"names":[],"mappings":"AA2BA,2GAA2G;AAC3G,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAG9D;AAED,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEpD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAiBjG"}

package/dist/speckle/units.js

@@ -0,0 +1,59 @@
+/* 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/. */
+/**
+ * Speckle unit strings → SI scale factors.
+ *
+ * Geometry carries Speckle's own unit vocabulary (`mm`, `cm`, `m`, `km`,
+ * `in`, `ft`, `yd`, `mi` and their spelled-out aliases, per specklepy's
+ * `UNITS_STRINGS`). Revit parameters carry Revit's display names instead
+ * (`Centimeters`, `Square meters`, `Cubic feet`). Both are handled; a unit
+ * outside these tables is not a length/area/volume and its value is carried
+ * unconverted, never guessed.
+ */
+const LENGTH_TO_METRES = {
+    mm: 0.001, mil: 0.001, millimeter: 0.001, millimeters: 0.001, millimetre: 0.001, millimetres: 0.001,
+    cm: 0.01, centimeter: 0.01, centimeters: 0.01, centimetre: 0.01, centimetres: 0.01,
+    dm: 0.1, decimeter: 0.1, decimeters: 0.1, decimetre: 0.1, decimetres: 0.1,
+    m: 1, meter: 1, meters: 1, metre: 1, metres: 1,
+    km: 1000, kilometer: 1000, kilometers: 1000, kilometre: 1000, kilometres: 1000,
+    in: 0.0254, inch: 0.0254, inches: 0.0254,
+    ft: 0.3048, foot: 0.3048, feet: 0.3048,
+    yd: 0.9144, yard: 0.9144, yards: 0.9144,
+    mi: 1609.34, mile: 1609.34, miles: 1609.34,
+};
+/** Metres per one `units`, or undefined when `units` is not a length unit (including Speckle's `none`). */
+export function lengthScale(units) {
+    if (typeof units !== 'string')
+        return undefined;
+    return LENGTH_TO_METRES[units.trim().toLowerCase()];
+}
+/**
+ * The quantity and SI factor of a parameter unit, e.g. `Square meters` →
+ * area × 1, `Cubic feet` → volume × 0.0283…; undefined for anything else
+ * (`Currency`, `Degrees`, …).
+ */
+export function parameterScale(units) {
+    if (typeof units !== 'string')
+        return undefined;
+    const u = units.trim().toLowerCase();
+    const direct = LENGTH_TO_METRES[u];
+    if (direct !== undefined)
+        return { quantity: 'length', factor: direct };
+    const sq = /^(?:square\s+(.+)|(.+?)(?:²|2))$/.exec(u);
+    if (sq) {
+        const f = LENGTH_TO_METRES[(sq[1] ?? sq[2]).trim()];
+        if (f !== undefined)
+            return { quantity: 'area', factor: f * f };
+    }
+    const cu = /^(?:cubic\s+(.+)|(.+?)(?:³|3))$/.exec(u);
+    if (cu) {
+        const f = LENGTH_TO_METRES[(cu[1] ?? cu[2]).trim()];
+        if (f !== undefined)
+            return { quantity: 'volume', factor: f * f * f };
+    }
+    if (u === 'liters' || u === 'litres' || u === 'l')
+        return { quantity: 'volume', factor: 0.001 };
+    return undefined;
+}
+//# sourceMappingURL=units.js.map

package/dist/speckle/units.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"units.js","sourceRoot":"","sources":["../../src/speckle/units.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;;;;;GASG;AAEH,MAAM,gBAAgB,GAAqC;IACzD,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK;IACnG,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI;IAClF,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG;IACzE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9C,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI;IAC9E,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IACxC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IACtC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IACvC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO;CAC3C,CAAC;AAEF,2GAA2G;AAC3G,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChD,OAAO,gBAAgB,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;AACtD,CAAC;AAID;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,MAAM,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;IACnC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IACxE,MAAM,EAAE,GAAG,kCAAkC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACtD,IAAI,EAAE,EAAE,CAAC;QACP,MAAM,CAAC,GAAG,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC,KAAK,SAAS;YAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;IAClE,CAAC;IACD,MAAM,EAAE,GAAG,iCAAiC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACrD,IAAI,EAAE,EAAE,CAAC;QACP,MAAM,CAAC,GAAG,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC,KAAK,SAAS;YAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;IACxE,CAAC;IACD,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,GAAG;QAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAChG,OAAO,SAAS,CAAC;AACnB,CAAC"}