@ifc-lite/cli 0.28.0 → 0.29.1

package/dist/commands/subset-relations.js

@@ -0,0 +1,277 @@
+// 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/.
+/**
+ * Spatial-structure relations, as `[relatingAttributeIndex, relatedAttributeIndex]`.
+ * `IfcRelAggregates` names the whole (`RelatingObject`) first; the two containment
+ * relations name the parts (`RelatedElements`) first. Same table as `STRUCTURE_RELATIONS`
+ * in `@ifc-lite/export`'s `merged-empty-containers.ts`, which reads the same three
+ * records, copied rather than imported because that module is internal to
+ * `@ifc-lite/export` and exporting it would widen a published API surface for a
+ * three-line constant.
+ *
+ * `IfcRelReferencedInSpatialStructure` is here for the same reason the other two are:
+ * same shape (one relating parent, one related SET), same one-per-storey authoring,
+ * same claim in the command's own docs that the output "parses and renders on its
+ * own". It used to be missing entirely, so a referenced-but-not-contained product was
+ * always orphaned.
+ */
+export const STRUCTURE_RELATIONS = {
+    IFCRELAGGREGATES: [4, 5],
+    IFCRELCONTAINEDINSPATIALSTRUCTURE: [5, 4],
+    IFCRELREFERENCEDINSPATIALSTRUCTURE: [5, 4],
+};
+/**
+ * All three are `GlobalId, OwnerHistory, Name, Description` plus the relating/related
+ * pair: exactly 6 attributes in every schema that defines them. A record that does not
+ * split into 6 was mis-scanned (or is not the entity the type name claims), so it falls
+ * back to keep-whole-or-drop-whole rather than having a slot index written into
+ * whatever it did split into.
+ *
+ * A relation type with a different attribute COUNT (`IfcRelAssignsToGroup` has 7)
+ * therefore cannot simply be added as a row above: it would fail this check on every
+ * record and fall silently back to keep-whole-or-drop-whole, which is the bug this
+ * module exists to fix. Such a type needs the count moved into the table value first,
+ * or the whole table derived from the schema registry, which returns 7 for that entity
+ * and would make row four safe rather than forbidden. Filed as #4123.
+ */
+export const STRUCTURE_RELATION_ATTRS = 6;
+/** A single `#id` and nothing else: an object reference in one slot. */
+export const SINGLE_REF_RE = /^#(\d+)$/;
+/**
+ * Decide every spatial-structure relation against a kept-id set.
+ *
+ * Pure in both arguments: adding relation ids to `keep` afterwards cannot
+ * change any verdict, because a relation of these types references products,
+ * spatial containers and an OwnerHistory, never another relation.
+ */
+export function planSpatialRelations(instances, keep) {
+    const add = [];
+    const rewritten = new Map();
+    const blockedOn = [];
+    for (const inst of instances) {
+        const slots = STRUCTURE_RELATIONS[inst.type];
+        if (slots === undefined)
+            continue;
+        const line = relationLine(inst, slots, keep, blockedOn);
+        if (line === null)
+            continue;
+        add.push(inst.id);
+        if (line !== inst.full)
+            rewritten.set(inst.id, line);
+    }
+    return { add, rewritten, blockedOn };
+}
+/**
+ * The record text this relation contributes to the subset, or null to drop it.
+ * Returns `inst.full` unchanged when nothing was filtered out. Appends ONE entry
+ * to `blocked` when the ONLY thing standing in the way is unkept non-SET
+ * references; see {@link SpatialRelationPlan.blockedOn}.
+ */
+function relationLine(inst, [relatingIdx, relatedIdx], keep, blocked) {
+    // A null is a REJECTED scan, not an empty list: its parts are wherever the
+    // scanner happened to be, so reading `args[relatingIdx]` or writing
+    // `args[relatedIdx]` by index would land on the wrong attribute (#2470).
+    const args = splitTopLevelArgs(inst.body);
+    if (args === null || args.length !== STRUCTURE_RELATION_ATTRS)
+        return keepWhole(inst, keep);
+    const setText = args[relatedIdx];
+    if (!setText.startsWith('(') || !setText.endsWith(')'))
+        return keepWhole(inst, keep);
+    const members = splitTopLevelArgs(setText.slice(1, -1));
+    if (members === null)
+        return keepWhole(inst, keep);
+    const memberIds = [];
+    for (const member of members) {
+        const ref = SINGLE_REF_RE.exec(member);
+        // A SET member that is not a plain object reference is not something this
+        // rewrite understands; fall back rather than guess at it.
+        if (ref === null)
+            return keepWhole(inst, keep);
+        memberIds.push(Number(ref[1]));
+    }
+    // The relating parent must be a real, kept reference. The `every reference
+    // outside the SET is kept` loop below would pass VACUOUSLY on a `$` here,
+    // emitting a containment with no parent.
+    const relating = SINGLE_REF_RE.exec(args[relatingIdx]);
+    if (relating === null || !keep.has(Number(relating[1])))
+        return null;
+    const kept = memberIds.filter((id) => keep.has(id));
+    if (kept.length === 0)
+        return null;
+    // Every other non-set reference (OwnerHistory) must be kept or the emitted
+    // record dangles. Ordered AFTER the intersection so `blocked` names only the
+    // references of a relation that would OTHERWISE survive; both checks drop the
+    // relation, so which one runs first changes no verdict.
+    const unkept = [];
+    for (let i = 0; i < args.length; i++) {
+        if (i === relatedIdx)
+            continue;
+        for (const id of refsOutsideStrings(args[i])) {
+            if (!keep.has(id))
+                unkept.push(id);
+        }
+    }
+    if (unkept.length > 0) {
+        blocked.push(unkept);
+        return null;
+    }
+    if (kept.length === memberIds.length)
+        return inst.full;
+    return spliceArgument(inst, args, relatedIdx, `(${kept.map((id) => `#${id}`).join(',')})`);
+}
+/**
+ * The `#id` object references in one argument, ignoring any that sit inside a
+ * STEP string literal.
+ *
+ * A relation's `Name` and `Description` are free TEXT, and free text contains
+ * `#`; `parseStep` tokenizes rather than regexes precisely because Revit
+ * writes names like that. Read raw, the `#99` in `'Level #99 contents'` looks
+ * like a reference to entity 99, and one unkept lookalike drops the WHOLE
+ * relation: the orphaned-storey bug this module exists to fix, re-created for
+ * any model that names a relation that way.
+ *
+ * Correct only on an argument whose split VALIDATED, so the quote boundaries
+ * are the record's own. {@link keepWhole} deliberately does NOT use this. It
+ * runs when the split FAILED, and also when it succeeded but the record is not
+ * the six-attribute shape this module rewrites, so its boundaries are not
+ * established in general. There, over-counting references (drop the record) is
+ * the safe error, while under-counting (emit a dangling `#id`) is not.
+ *
+ * Exported for `extract-entities.ts`'s `forwardClosure`, which has the same
+ * hazard scanning a whole record body for its reference closure: nothing here
+ * assumes `arg` is one split ARGUMENT rather than a whole body, since a comma
+ * or `)` outside a string does not affect the in-string/out-of-string state
+ * this walks.
+ */
+export function refsOutsideStrings(arg) {
+    const ids = [];
+    let inString = false;
+    for (let i = 0; i < arg.length; i++) {
+        const char = arg[i];
+        if (inString) {
+            if (char === "'") {
+                if (arg[i + 1] === "'")
+                    i++;
+                else
+                    inString = false;
+            }
+            continue;
+        }
+        if (char === "'") {
+            inString = true;
+        }
+        else if (char === '#') {
+            let end = i + 1;
+            while (end < arg.length && arg[end] >= '0' && arg[end] <= '9')
+                end++;
+            if (end > i + 1)
+                ids.push(Number(arg.slice(i + 1, end)));
+            i = end - 1;
+        }
+    }
+    return ids;
+}
+/**
+ * Keep-whole-or-drop-whole, for a record this module could not scan, or could
+ * not read as its six attributes. Reads references straight off the raw body,
+ * so it needs no argument boundaries to be correct. Same no-dangling guarantee,
+ * no rewriting.
+ */
+function keepWhole(inst, keep) {
+    const refs = [...inst.body.matchAll(/#(\d+)/g)].map((m) => Number(m[1]));
+    return refs.length > 0 && refs.every((r) => keep.has(r)) ? inst.full : null;
+}
+/**
+ * Re-emit the record with ONE top-level argument replaced. Rejoining the split
+ * arguments normalizes only the whitespace BETWEEN them (each argument's own
+ * text is untouched), and this runs only for a relation that actually lost a
+ * member, so an unfiltered subset stays byte-identical.
+ */
+function spliceArgument(inst, args, index, replacement) {
+    const open = inst.full.indexOf('(');
+    // `body` is by construction the slice of `full` between its first `(` and the
+    // matching `)`: the id and type name that precede it hold no parenthesis. A
+    // mismatch would mean the parser and this module disagree about where the
+    // arguments are, and splicing on that offset corrupts the record, so drop it
+    // instead of emitting something malformed.
+    if (open < 0 || inst.full.slice(open + 1, open + 1 + inst.body.length) !== inst.body)
+        return null;
+    const next = [...args];
+    next[index] = replacement;
+    return inst.full.slice(0, open + 1) + next.join(',') + inst.full.slice(open + 1 + inst.body.length);
+}
+/**
+ * Skip a `/* ... *\/` comment atomically: index of `/` in, index past its
+ * close marker (or end-of-text when unterminated) out. Byte-identical copy of
+ * `@ifc-lite/export`'s `skipStepComment` (not imported, see the module
+ * header): #4227's third copy of the same missing logic.
+ */
+function skipStepComment(text, i) {
+    const end = text.indexOf('*/', i + 2);
+    return end === -1 ? text.length : end + 2;
+}
+/**
+ * Split a STEP argument list on top-level commas, respecting nested parens,
+ * quoted strings, doubled-quote escapes, and `/* ... *\/` comments (#4227).
+ * Returns null on an unterminated string, an unbalanced paren depth, or a
+ * depth that ever goes negative -- {@link relationLine} writes a slot by
+ * index (#2470), so a mis-scanned list must not hand back parts that look
+ * like success. A comma/paren/quote inside a comment is skipped with it (see
+ * {@link skipStepComment}): unskipped, its comma shifts every later slot
+ * boundary and `relationLine` either mis-splices a member or falls back to
+ * {@link keepWhole}, dropping a relation that should have survived -- the
+ * orphaned-storey symptom (#4126) this module exists to fix, by a different
+ * route. An EMPTY INTERIOR slot (`a,,b`) is one part, not rejected.
+ *
+ * Near-twin of `@ifc-lite/export`'s `splitTopLevelStepArguments` (see the
+ * module header). Two differences: each part is `trim`med (because
+ * {@link SINGLE_REF_RE} is anchored), and a TRAILING empty slot (`a,b,`)
+ * yields 2 parts, not 3.
+ */
+export function splitTopLevelArgs(text) {
+    const parts = [];
+    let start = 0;
+    let depth = 0;
+    let inString = false;
+    for (let i = 0; i < text.length; i++) {
+        const char = text[i];
+        if (inString) {
+            if (char === "'") {
+                // A doubled quote is an escaped quote, not the end of the string.
+                if (text[i + 1] === "'")
+                    i++;
+                else
+                    inString = false;
+            }
+            continue;
+        }
+        if (char === '/' && text[i + 1] === '*') {
+            // See skipStepComment's docstring: its content is skipped as one unit,
+            // not read as argument-list structure.
+            i = skipStepComment(text, i) - 1;
+        }
+        else if (char === "'") {
+            inString = true;
+        }
+        else if (char === '(') {
+            depth++;
+        }
+        else if (char === ')') {
+            depth--;
+            if (depth < 0)
+                return null;
+        }
+        else if (char === ',' && depth === 0) {
+            parts.push(text.slice(start, i).trim());
+            start = i + 1;
+        }
+    }
+    if (inString || depth !== 0)
+        return null;
+    const tail = text.slice(start).trim();
+    if (tail)
+        parts.push(tail);
+    return parts;
+}
+//# sourceMappingURL=subset-relations.js.map

package/dist/commands/subset-relations.js.map

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

package/dist/commands/where-filter.d.ts

@@ -14,6 +14,7 @@ import { normalizeBooleanValue } from '@ifc-lite/query';
  *   PsetName.PropName>=Value    (greater or equal)
  *   PsetName.PropName<=Value    (less or equal)
  *   PsetName.PropName~Value     (contains)
+ *   PsetName.PropName~=Pattern  (regex match — see `matches` on FilterComparisonOp)
  *   PsetName.PropName           (exists)
  */
 export declare function parseWhereFilter(filter: string): {

package/dist/commands/where-filter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"where-filter.d.ts","sourceRoot":"","sources":["../../src/commands/where-filter.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AAEH,OAAO,EAIL,qBAAqB,EAEtB,MAAM,iBAAiB,CAAC;AAGzB;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAsBzH;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,EAAE,GAAG,EAAE,GAAG,GAAG,GAAG,EAAE,CAoB9G;AAMD,wBAAgB,aAAa,CAAC,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAGlG;AAED,OAAO,EAAE,qBAAqB,EAAE,CAAC"}
+{"version":3,"file":"where-filter.d.ts","sourceRoot":"","sources":["../../src/commands/where-filter.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AAEH,OAAO,EAIL,qBAAqB,EAEtB,MAAM,iBAAiB,CAAC;AAGzB;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAyBzH;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,EAAE,GAAG,EAAE,GAAG,GAAG,GAAG,EAAE,CAoB9G;AAMD,wBAAgB,aAAa,CAAC,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAGlG;AAED,OAAO,EAAE,qBAAqB,EAAE,CAAC"}

package/dist/commands/where-filter.js

@@ -18,6 +18,7 @@ import { fatal } from '../output.js';
  *   PsetName.PropName>=Value    (greater or equal)
  *   PsetName.PropName<=Value    (less or equal)
  *   PsetName.PropName~Value     (contains)
+ *   PsetName.PropName~=Pattern  (regex match — see `matches` on FilterComparisonOp)
  *   PsetName.PropName           (exists)
  */
 export function parseWhereFilter(filter) {
@@ -27,13 +28,16 @@ export function parseWhereFilter(filter) {
     }
     const psetName = filter.slice(0, dotIdx);
     const rest = filter.slice(dotIdx + 1);
-    // Try multi-char operators first, then single-char
-    for (const op of ['!=', '>=', '<=', '>', '<', '=', '~']) {
+    // Try multi-char operators first, then single-char. `~=` MUST be checked
+    // before both `=` and `~` — either alone would split "Prop~=pattern" wrong
+    // (matching bare `=` mid-token, or bare `~` and leaving a stray `=` in the
+    // value).
+    for (const op of ['!=', '>=', '<=', '~=', '>', '<', '=', '~']) {
         const opIdx = rest.indexOf(op);
         if (opIdx > 0) {
             const propName = rest.slice(0, opIdx);
             const value = rest.slice(opIdx + op.length);
-            const mappedOp = op === '~' ? 'contains' : op;
+            const mappedOp = op === '~' ? 'contains' : op === '~=' ? 'matches' : op;
             return { psetName, propName, operator: mappedOp, value };
         }
     }

package/dist/commands/where-filter.js.map

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

package/dist/index.js

@@ -145,7 +145,7 @@ const HELP = `
     ifc-lite diagnose-geometry model.ifc --type IfcWall
     ifc-lite diagnose-geometry model.ifc --product 0YvCT2_$X3_xJG3rzD8L_8
     ifc-lite ids model.ifc requirements.ids --json
-    ifc-lite bcf create --title "Missing door" --out issue.bcf
+    ifc-lite bcf create --title "Missing door" --out topic.bcf
     ifc-lite clash model.ifc --matrix --json
     ifc-lite clash model.ifc --a "IfcDuct*|IfcPipe*" --b "IfcWall*" --mode clearance --clearance 0.05
     ifc-lite clash model.ifc --matrix --bcf clashes.bcfzip

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ifc-lite/cli",
-  "version": "0.28.0",
+  "version": "0.29.1",
   "description": "CLI toolkit for IFC files — query, validate, export, create, and script BIM data",
   "type": "module",
   "bin": {
@@ -20,28 +20,28 @@
     "README.md"
   ],
   "dependencies": {
-    "@ifc-lite/bcf": "^3.0.0",
-    "@ifc-lite/clash": "^2.1.0",
-    "@ifc-lite/create": "^2.2.1",
-    "@ifc-lite/data": "^4.0.0",
+    "@ifc-lite/bcf": "^4.0.0",
+    "@ifc-lite/clash": "^2.1.2",
+    "@ifc-lite/create": "^2.4.0",
+    "@ifc-lite/data": "^4.2.0",
     "@ifc-lite/diff": "^0.8.0",
-    "@ifc-lite/export": "^4.0.0",
-    "@ifc-lite/geometry": "^4.2.0",
-    "@ifc-lite/ids": "^1.15.54",
+    "@ifc-lite/export": "^4.2.0",
+    "@ifc-lite/geometry": "^5.0.0",
+    "@ifc-lite/extensions": "^0.7.0",
+    "@ifc-lite/ids": "^1.16.2",
+    "@ifc-lite/ifcx": "^4.1.0",
     "@ifc-lite/merge": "^0.4.5",
-    "@ifc-lite/extensions": "^0.6.0",
-    "@ifc-lite/ifcx": "^4.0.0",
-    "@ifc-lite/mcp": "^0.13.0",
-    "@ifc-lite/mutations": "^2.0.0",
-    "@ifc-lite/query": "^2.1.0",
-    "@ifc-lite/sandbox": "^2.2.2",
-    "@ifc-lite/parser": "^5.1.0",
-    "@ifc-lite/sdk": "^4.0.1",
-    "@ifc-lite/viewer-core": "^0.2.15",
-    "@ifc-lite/wasm": "^6.3.0"
+    "@ifc-lite/mutations": "^2.2.0",
+    "@ifc-lite/parser": "^6.1.0",
+    "@ifc-lite/query": "^2.3.1",
+    "@ifc-lite/sdk": "^5.0.0",
+    "@ifc-lite/mcp": "^0.14.1",
+    "@ifc-lite/viewer-core": "^0.2.16",
+    "@ifc-lite/wasm": "^7.0.0",
+    "@ifc-lite/sandbox": "^2.2.4"
   },
   "devDependencies": {
-    "@types/node": "^26.4.0",
+    "@types/node": "^26.4.1",
     "typescript": "^6.0.3",
     "vitest": "^4.1.11"
   },