@ifc-lite/cli 0.21.0 → 0.22.0

package/dist/commands/diagnose-geometry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diagnose-geometry.d.ts","sourceRoot":"","sources":["../../src/commands/diagnose-geometry.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAqB,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAMjF,KAAK,SAAS,GAAG,mBAAmB,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,kFAAkF;AAClF,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,EAAE,EAClB,IAAI,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C,SAAS,EAAE,CAMb;AAED,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA6E3E"}
+{"version":3,"file":"diagnose-geometry.d.ts","sourceRoot":"","sources":["../../src/commands/diagnose-geometry.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAqB,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAMjF,KAAK,SAAS,GAAG,mBAAmB,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,kFAAkF;AAClF,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,EAAE,EAClB,IAAI,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C,SAAS,EAAE,CAMb;AAED,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAkF3E"}

package/dist/commands/diagnose-geometry.js

@@ -52,31 +52,37 @@ export async function diagnoseGeometryCommand(args) {
     const buf = await readFile(filePath);
     const bytes = new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength);
     const gp = new GeometryProcessor();
-    await gp.init();
-    let diag = gp.diagnoseGeometry(bytes);
-    if (diag && (productArg !== undefined || typeArg !== undefined)) {
-        let productId;
-        if (productArg !== undefined) {
-            if (isExpressId(productArg)) {
-                productId = parseInt(productArg, 10);
-            }
-            else {
-                // GlobalId: resolve via the columnar parser's entity table (the wasm
-                // diagnostics pass never surfaces GlobalIds, only express IDs). Parse
-                // the bytes ALREADY in memory rather than re-reading the file from disk
-                // — the geometry pass above already loaded them, so this avoids a
-                // redundant disk read (the wasm IfcAPI exposes no GlobalId lookup, so a
-                // columnar parse is still required to map GlobalId → expressId).
-                const store = await loadIfcBytes(bytes, filePath);
-                const resolved = store.entities.getExpressIdByGlobalId(productArg);
-                if (resolved === -1) {
-                    fatal(`--product: no entity found with GlobalId "${productArg}"`);
-                    return;
+    let diag;
+    try {
+        await gp.init();
+        diag = gp.diagnoseGeometry(bytes);
+        if (diag && (productArg !== undefined || typeArg !== undefined)) {
+            let productId;
+            if (productArg !== undefined) {
+                if (isExpressId(productArg)) {
+                    productId = parseInt(productArg, 10);
+                }
+                else {
+                    // GlobalId: resolve via the columnar parser's entity table (the wasm
+                    // diagnostics pass never surfaces GlobalIds, only express IDs). Parse
+                    // the bytes ALREADY in memory rather than re-reading the file from disk
+                    // — the geometry pass above already loaded them, so this avoids a
+                    // redundant disk read (the wasm IfcAPI exposes no GlobalId lookup, so a
+                    // columnar parse is still required to map GlobalId → expressId).
+                    const store = await loadIfcBytes(bytes, filePath);
+                    const resolved = store.entities.getExpressIdByGlobalId(productArg);
+                    if (resolved === -1) {
+                        fatal(`--product: no entity found with GlobalId "${productArg}"`);
+                        return;
+                    }
+                    productId = resolved;
                 }
-                productId = resolved;
             }
+            diag = { ...diag, worstHosts: filterWorstHosts(diag.worstHosts, { productId, ifcType: typeArg }) };
         }
-        diag = { ...diag, worstHosts: filterWorstHosts(diag.worstHosts, { productId, ifcType: typeArg }) };
+    }
+    finally {
+        gp.dispose();
     }
     if (asJson || outPath) {
         const json = JSON.stringify(diag ?? null, null, 2);

package/dist/commands/diagnose-geometry.js.map

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

package/dist/commands/diff-content.d.ts

@@ -0,0 +1,11 @@
+export interface ContentDiffOptions {
+    basePath: string;
+    headPath: string;
+    /** `--identity-in`: a sidecar to replay as key aliases. */
+    identityIn?: string;
+    /** `--identity-out`: where to write the sidecar this run establishes. */
+    identityOut?: string;
+    json: boolean;
+}
+export declare function contentDiffCommand(options: ContentDiffOptions): Promise<void>;
+//# sourceMappingURL=diff-content.d.ts.map

package/dist/commands/diff-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-content.d.ts","sourceRoot":"","sources":["../../src/commands/diff-content.ts"],"names":[],"mappings":"AAmCA,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqFnF"}

package/dist/commands/diff-content.js

@@ -0,0 +1,270 @@
+/* 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/. */
+/**
+ * `ifc-lite diff --by-content` — the engine-backed half of the diff command
+ * (issue #1891), plus the identity-map sidecar it can emit and consume.
+ *
+ * The loop this closes: run it once, review the `renamed` matches, keep the
+ * sidecar. On the next run the accepted claims come back in as key aliases, the
+ * re-GUIDed elements are matched by key, and they never show up as churn again.
+ * See `diff-engine.ts` for why this path is data-scope only.
+ */
+import { readFile, stat, writeFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { createIdentityMapSidecar, diffModels, identityMapFromContentMatches, identityMapSidecarMismatches, keyAliasesFromSidecar, parseIdentityMapSidecar, serializeIdentityMapSidecar, } from '@ifc-lite/diff';
+import { loadIfcBytes } from '../loader.js';
+import { fatal, printJson } from '../output.js';
+import { buildFileFingerprints, modelIdentityOf } from './diff-engine.js';
+export async function contentDiffCommand(options) {
+    const { basePath, headPath } = options;
+    // Before anything is read, and long before anything is written.
+    await refuseOverwritingAnInput(options);
+    const baseBytes = await readModel(basePath);
+    const headBytes = await readModel(headPath);
+    const baseIdentity = modelIdentityOf(basePath, baseBytes);
+    const headIdentity = modelIdentityOf(headPath, headBytes);
+    const incoming = options.identityIn
+        ? await readVerifiedSidecar(options.identityIn, baseIdentity, headIdentity)
+        : undefined;
+    process.stderr.write('Loading files...\n');
+    const baseStore = await loadIfcBytes(baseBytes, basePath);
+    const headStore = await loadIfcBytes(headBytes, headPath);
+    const diff = diffModels(buildFileFingerprints(baseStore), buildFileFingerprints(headStore), {
+        // No meshes in Node: `data` is the honest description of what this path can
+        // compare. See diff-engine.ts.
+        scope: 'data',
+        matchUnpairedByContent: true,
+        keyAliases: incoming ? keyAliasesFromSidecar(incoming) : undefined,
+    });
+    const applied = diff.appliedKeyAliases ?? new Map();
+    const ignored = incoming ? countClaims(incoming) - applied.size : 0;
+    let written;
+    if (options.identityOut) {
+        const entries = mergeIdentityClaims(incoming, applied, diff.contentMatches);
+        const sidecar = createIdentityMapSidecar({
+            base: baseIdentity,
+            head: headIdentity,
+            entries,
+            // Reproducible by construction: identical inputs write identical bytes.
+            // The builder sorts and de-duplicates so a checked-in sidecar produces an
+            // empty git diff when nothing changed, and stamping `Date.now()` here
+            // would throw that away — every rerun, including the
+            // `--identity-in x --identity-out x` carry-forward, would show a one-line
+            // diff that says nothing about the claims. An incoming `created` is
+            // preserved instead of refreshed: it dates the claims, not the rewrite,
+            // and the sidecar is addressed by the two model digests either way. There
+            // is deliberately no flag to request a fresh stamp — it would add CLI
+            // surface for a field the format already documents as informational and
+            // optional, and `git log` dates a reviewed, committed artifact better
+            // than a self-reported timestamp does.
+            created: incoming?.created,
+        });
+        await writeFile(options.identityOut, serializeIdentityMapSidecar(sidecar), 'utf-8');
+        written = { path: options.identityOut, entries: sidecar.entries };
+    }
+    if (options.json) {
+        printJson({
+            base: { path: basePath, hash: baseIdentity.hash, schema: baseStore.schemaVersion },
+            head: { path: headPath, hash: headIdentity.hash, schema: headStore.schemaVersion },
+            scope: diff.scope,
+            counts: diff.counts,
+            contentMatches: (diff.contentMatches ?? []).map((match) => ({
+                kind: match.kind,
+                base: match.base.map((entity) => entity.key),
+                head: match.head.map((entity) => entity.key),
+            })),
+            identityMap: {
+                in: options.identityIn
+                    ? { path: options.identityIn, applied: applied.size, ignored }
+                    : undefined,
+                out: written ? { path: written.path, entries: written.entries.length } : undefined,
+            },
+        });
+        return;
+    }
+    printReport({
+        basePath,
+        headPath,
+        diff,
+        appliedCount: applied.size,
+        ignoredCount: ignored,
+        identityIn: options.identityIn,
+        written,
+    });
+}
+/**
+ * Refuse to run at all if `--identity-out` names one of the two input models.
+ *
+ * The sidecar is a JSON document. Writing it over an IFC file destroys the
+ * user's model, and a mistyped or shell-completed path is all it takes — the
+ * two arguments right before it are IFC paths. So this is checked first, and
+ * the command exits without reading, comparing, or writing anything.
+ *
+ * Two independent tests, because a path string is not a file:
+ *
+ * 1. Resolved paths are equal. Catches `./v1.ifc` vs `v1.ifc` vs `sub/../v1.ifc`
+ *    with no filesystem access, and is the whole answer on a platform where
+ *    `stat` reports no usable inode.
+ * 2. The output already exists AND is the same file as an input, by device +
+ *    inode. This is the exhaustive test: it catches a symlink, a hard link, a
+ *    bind mount, and `V1.IFC` on a case-insensitive filesystem — every way two
+ *    different strings can name one file. It is also sufficient on its own for
+ *    the destructive case, because a path that does not resolve to an existing
+ *    file cannot be overwriting an input: the inputs must exist to be read.
+ *
+ * `--identity-in` and `--identity-out` naming the SAME sidecar is not checked
+ * here, because that is the carry-forward workflow this feature is built around
+ * (read the accepted claims, write back the ones that still held).
+ */
+async function refuseOverwritingAnInput(options) {
+    const { identityOut } = options;
+    if (identityOut === undefined)
+        return;
+    const out = resolve(identityOut);
+    const outStat = await statOrUndefined(identityOut);
+    for (const [label, input] of [
+        ['base model', options.basePath],
+        ['head model', options.headPath],
+    ]) {
+        if (resolve(input) !== out && !isSameFile(outStat, await statOrUndefined(input)))
+            continue;
+        fatal(`--identity-out ${identityOut} is the ${label} (${input}). ` +
+            'Writing the identity map there would overwrite the input file.');
+    }
+}
+async function statOrUndefined(path) {
+    // A missing or unreadable path cannot be an input file being overwritten;
+    // reading the models is what reports it, with its own message.
+    try {
+        return await stat(path);
+    }
+    catch {
+        return undefined;
+    }
+}
+function isSameFile(a, b) {
+    return a !== undefined && b !== undefined && a.dev === b.dev && a.ino === b.ino;
+}
+/**
+ * Read one of the two input models, reporting a missing or unreadable path the
+ * way the rest of the command reports problems rather than throwing a raw
+ * `ENOENT` stack at the user — the same treatment `readVerifiedSidecar` already
+ * gives the sidecar.
+ */
+async function readModel(path) {
+    try {
+        return await readFile(path);
+    }
+    catch (error) {
+        return fatal(`Cannot read ${path}: ${error.message}`);
+    }
+}
+/**
+ * Read a sidecar and refuse it unless it was verified against exactly these two
+ * files.
+ *
+ * This is the whole reason the sidecar pins both content digests. A rename list
+ * with no idea which revisions a human looked at when accepting it is not a
+ * claim, it is a guess with a filename; replayed against the wrong pair it
+ * either silently does nothing or asserts an identity nobody reviewed. There is
+ * deliberately no override flag: the fix for a mismatch is to re-run the
+ * comparison that produced the claims, which is one command.
+ */
+async function readVerifiedSidecar(path, base, head) {
+    let text;
+    try {
+        text = await readFile(path, 'utf-8');
+    }
+    catch (error) {
+        return fatal(`Cannot read identity map ${path}: ${error.message}`);
+    }
+    let sidecar;
+    try {
+        sidecar = parseIdentityMapSidecar(text);
+    }
+    catch (error) {
+        return fatal(error.message);
+    }
+    const problems = identityMapSidecarMismatches(sidecar, { base, head });
+    if (problems.length > 0) {
+        return fatal(`Identity map ${path} was not verified against these files:\n  ${problems.join('\n  ')}`);
+    }
+    return sidecar;
+}
+/** Distinct head keys a sidecar actually claims (self-claims and repeats are
+ *  no-ops the consumer drops, so counting raw entries would overstate what
+ *  could have applied). */
+function countClaims(sidecar) {
+    return keyAliasesFromSidecar(sidecar).size;
+}
+/**
+ * The claims the output sidecar should carry: the incoming ones that still
+ * applied, plus the ones this run's content matching established.
+ *
+ * Carrying the incoming claims forward is not bookkeeping, it is the point.
+ * An applied alias matches its pair by key, so that pair is no longer in
+ * `contentMatches` — deriving the output from the matches alone would drop
+ * exactly the claims that worked, and `--identity-in x --identity-out x` would
+ * erase the map a little more on every run. Their original `reason` is
+ * preserved so a hand-written claim does not silently become an engine-derived
+ * one. Incoming claims that did NOT apply (stale, or colliding) are dropped:
+ * the sidecar records what held against these two files, not what someone once
+ * hoped.
+ */
+function mergeIdentityClaims(incoming, applied, matches) {
+    const entries = [];
+    if (incoming) {
+        const reasons = new Map();
+        for (const entry of incoming.entries) {
+            if (!reasons.has(entry.here))
+                reasons.set(entry.here, entry.reason);
+        }
+        for (const [here, base] of applied) {
+            entries.push({ base, here, reason: reasons.get(here) ?? 'carried forward' });
+        }
+    }
+    entries.push(...identityMapFromContentMatches(matches));
+    return entries;
+}
+function printReport(report) {
+    const { diff } = report;
+    const out = (line) => {
+        process.stdout.write(`${line}\n`);
+    };
+    out('');
+    out(`  Base: ${report.basePath}`);
+    out(`  Head: ${report.headPath}`);
+    out(`  Scope: data (the CLI has no geometry pipeline)`);
+    out('');
+    out(`  Unchanged: ${diff.counts.unchanged}`);
+    out(`  Modified:  ${diff.counts.modified}`);
+    out(`  Added:     ${diff.counts.added}`);
+    out(`  Deleted:   ${diff.counts.deleted}`);
+    const byKind = new Map();
+    for (const match of diff.contentMatches ?? []) {
+        byKind.set(match.kind, (byKind.get(match.kind) ?? 0) + 1);
+    }
+    out('');
+    if (byKind.size === 0) {
+        out('  Content matches: none');
+    }
+    else {
+        out('  Content matches:');
+        for (const [kind, count] of [...byKind].sort()) {
+            out(`    ${kind.padEnd(13)} ${count}`);
+        }
+        out('    (renamed / moved / reshaped are resolved; the rest need a human)');
+    }
+    if (report.identityIn) {
+        out('');
+        out(`  Identity map in:  ${report.identityIn}`);
+        out(`    applied: ${report.appliedCount}, ignored: ${report.ignoredCount}`);
+    }
+    if (report.written) {
+        out('');
+        out(`  Identity map out: ${report.written.path} (${report.written.entries.length} claims)`);
+    }
+    out('');
+}
+//# sourceMappingURL=diff-content.js.map

package/dist/commands/diff-content.js.map

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

package/dist/commands/diff-engine.d.ts

@@ -0,0 +1,23 @@
+import { type EntityFingerprint, type ModelIdentity } from '@ifc-lite/diff';
+import { type IfcDataStore } from '@ifc-lite/parser';
+/** Adapter handle threaded through the diff: the entity's express id. */
+export type DiffRef = number;
+/**
+ * Content digest of a model's bytes, as written into the sidecar.
+ *
+ * The digest is over the file **as it sits on disk**, before any `.ifcZIP`
+ * unwrapping — that is the thing a user can reproduce with `shasum`, and the
+ * thing that changes when someone re-exports.
+ */
+export declare function modelIdentityOf(path: string, bytes: Uint8Array): ModelIdentity;
+/**
+ * Build one {@link EntityFingerprint} per `IfcObjectDefinition` in a store.
+ *
+ * `components` is populated as well as `dataHash`: the content pass's only
+ * defence against a `dataHash` collision retiring an unrelated add/delete pair
+ * is agreement on `ifcType` and on every component sub-hash, and the second
+ * check is inert unless both sides supply them (see the "Hash collisions"
+ * section of `docs/guide/model-diff.md`).
+ */
+export declare function buildFileFingerprints(store: IfcDataStore): EntityFingerprint<DiffRef>[];
+//# sourceMappingURL=diff-engine.d.ts.map

package/dist/commands/diff-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-engine.d.ts","sourceRoot":"","sources":["../../src/commands/diff-engine.ts"],"names":[],"mappings":"AA8BA,OAAO,EAIL,KAAK,iBAAiB,EACtB,KAAK,aAAa,EACnB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAML,KAAK,YAAY,EAClB,MAAM,kBAAkB,CAAC;AAG1B,yEAAyE;AACzE,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAE7B;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,aAAa,CAG9E;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,YAAY,GAAG,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAavF"}

package/dist/commands/diff-engine.js

@@ -0,0 +1,159 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+/**
+ * The CLI's adapter onto the real `@ifc-lite/diff` engine (issue #1891).
+ *
+ * `ifc-lite diff` on its own answers "what changed at the type and identity
+ * level" — counts per type, GlobalIds added and removed. That is useless the
+ * moment the two files came from a from-scratch re-export, because every
+ * GlobalId is new and the whole model reads as deleted-and-added. `--by-content`
+ * routes the same two files through the engine's content-keyed matching pass
+ * instead, and lets the accepted matches be written to (and replayed from) an
+ * identity-map sidecar.
+ *
+ * **Data scope only, on purpose.** The Node CLI has no geometry pipeline: no
+ * meshes, so no world geometry hash and no bounding box. Rather than pretend
+ * otherwise, it passes `scope: 'data'`, which is the honest description of what
+ * it can see — the engine then classifies every unambiguous 1:1 content match as
+ * `renamed` and reports every genuinely ambiguous group as a group, exactly as
+ * it does for a viewer session whose geometry hashing was unavailable.
+ *
+ * **Scope of the comparison: every `IfcObjectDefinition` in the file**, decided
+ * from the schema registry's inheritance chain rather than from what the
+ * columnar parser put in its `EntityTable`. That walk is `diff-scope.ts`, which
+ * documents the rule and the two silent defects it fixes; `--by-entity` runs on
+ * the same walk, so both modes of the command answer about the same entities.
+ */
+import { createHash } from 'node:crypto';
+import { buildComponentFingerprints, buildDataFingerprint, } from '@ifc-lite/diff';
+import { RelationshipType } from '@ifc-lite/data';
+import { EntityExtractor, extractAllEntityAttributes, extractPropertiesOnDemand, extractQuantitiesOnDemand, getAttributeNamesAcrossSchemas, } from '@ifc-lite/parser';
+import { comparableEntities } from './diff-scope.js';
+/**
+ * Content digest of a model's bytes, as written into the sidecar.
+ *
+ * The digest is over the file **as it sits on disk**, before any `.ifcZIP`
+ * unwrapping — that is the thing a user can reproduce with `shasum`, and the
+ * thing that changes when someone re-exports.
+ */
+export function modelIdentityOf(path, bytes) {
+    const digest = createHash('sha256').update(bytes).digest('hex');
+    return { hash: `sha256:${digest}`, path };
+}
+/**
+ * Build one {@link EntityFingerprint} per `IfcObjectDefinition` in a store.
+ *
+ * `components` is populated as well as `dataHash`: the content pass's only
+ * defence against a `dataHash` collision retiring an unrelated add/delete pair
+ * is agreement on `ifcType` and on every component sub-hash, and the second
+ * check is inert unless both sides supply them (see the "Hash collisions"
+ * section of `docs/guide/model-diff.md`).
+ */
+export function buildFileFingerprints(store) {
+    const fingerprints = [];
+    for (const { expressId, globalId, ifcType, source, isTypeObject } of comparableEntities(store)) {
+        const input = buildDataInput(store, expressId, ifcType, source, isTypeObject);
+        fingerprints.push({
+            key: globalId,
+            ifcType,
+            dataHash: buildDataFingerprint(input),
+            components: buildComponentFingerprints(input),
+            ref: expressId,
+        });
+    }
+    return fingerprints;
+}
+/**
+ * Assemble the canonical {@link DataFingerprintInput} for one entity.
+ *
+ * Mirrors the viewer adapter (`apps/viewer/src/lib/compare/buildFingerprints.ts`)
+ * minus its geometry-data filtering: that filter exists to keep placement data
+ * out of the *data* hash so a pure move reads as a geometry-only change, and
+ * this path has no geometry hash for such a change to land in. Dropping the
+ * filter here would make a moved element look unchanged.
+ */
+function buildDataInput(store, expressId, ifcType, 
+/** Set only when the entity is absent from the columnar `EntityTable`, whose
+ *  accessors then answer '' for every display attribute. */
+source, 
+/** `IfcTypeObject` subtype? Gates `Tag` into the fingerprint (issue #2021). */
+isTypeObject) {
+    const predefinedType = extractAllEntityAttributes(store, expressId).find((attribute) => attribute.name === 'PredefinedType')?.value;
+    // `Tag` for a TYPE OBJECT only. On an occurrence it is the authoring tool's
+    // element id, which changes across producers while the design does not, and
+    // `dataHash` is the content bucket key — hashing it there would stop the
+    // re-export matching this whole path exists for. On a type object it is the
+    // only thing separating same-named types with no geometry hash to fall back
+    // on (issue #2021, and `DataFingerprintInput.tag` for the full argument).
+    const tag = isTypeObject ? attributeAcrossSchemas(store, expressId, ifcType, 'Tag') : undefined;
+    const propertySets = extractPropertiesOnDemand(store, expressId).map((set) => ({
+        name: set.name,
+        properties: set.properties.map((property) => ({ name: property.name, value: property.value })),
+    }));
+    const quantitySets = extractQuantitiesOnDemand(store, expressId).map((set) => ({
+        name: set.name,
+        quantities: set.quantities.map((quantity) => ({
+            name: quantity.name,
+            // Rounded to 4 dp, matching the viewer: re-exporting a model with
+            // sub-tolerance float jitter must not flip the data hash on an otherwise
+            // identical element, which on this path would cost the pair its match.
+            value: roundQuantity(quantity.value),
+        })),
+    }));
+    const typeAssignments = store.relationships
+        .getRelated(expressId, RelationshipType.DefinesByType, 'inverse')
+        .map((typeId) => ({
+        globalId: store.entities.getGlobalId(typeId) || undefined,
+        name: store.entities.getName(typeId) || undefined,
+        type: store.entities.getTypeName(typeId) || undefined,
+    }));
+    return {
+        ifcType,
+        name: store.entities.getName(expressId) || source?.name || undefined,
+        description: store.entities.getDescription(expressId) || source?.description || undefined,
+        objectType: store.entities.getObjectType(expressId) || source?.objectType || undefined,
+        predefinedType: predefinedType != null ? String(predefinedType) : undefined,
+        tag: tag != null ? String(tag) : undefined,
+        propertySets,
+        quantitySets,
+        typeAssignments,
+    };
+}
+function roundQuantity(value) {
+    return Number.isFinite(value) ? Math.round(value * 1e4) / 1e4 : value;
+}
+/**
+ * One named attribute, read positionally through the **cross-schema** attribute
+ * list (issue #2021).
+ *
+ * `extractAllEntityAttributes` names attributes through the parser's IFC4
+ * codegen pin, which answers an EMPTY list for a class the pin does not carry —
+ * so a `.find(name === 'Tag')` over it silently finds nothing on every
+ * IFC4X3-only type object (`IfcRailType`, `IfcTrackElementType`,
+ * `IfcSignalType`, …) while working perfectly on IFC2X3 and IFC4. That is a
+ * no-op nobody would notice: the entity is in scope, its class name is right,
+ * `isTypeObject` is right, and only the evidence is missing.
+ *
+ * This is the same pinned-registry family as the membership defect `#2001`
+ * fixed, and it has to be answered from the same place: the inheritance chain
+ * decides *whether* to read a `Tag`, so the attribute list that decides *where*
+ * it sits must span the same schemas. `getAttributeNamesAcrossSchemas` returns
+ * the pinned result unchanged for every class the pin does know, so this is
+ * additive — no IFC2X3 or IFC4 entity's hash moves because of it.
+ *
+ * Reads the raw STEP slot rather than reusing `extractAllEntityAttributes`'
+ * display normalization: this value is hashed, not shown, so `$` (absent) is
+ * the only case that needs interpreting and it arrives as null.
+ */
+function attributeAcrossSchemas(store, expressId, ifcType, attributeName) {
+    const index = getAttributeNamesAcrossSchemas(ifcType).indexOf(attributeName);
+    if (index < 0)
+        return undefined;
+    const ref = store.entityIndex.byId.get(expressId);
+    if (!ref)
+        return undefined;
+    const raw = new EntityExtractor(store.source).extractEntity(ref)?.attributes?.[index];
+    return typeof raw === 'string' || typeof raw === 'number' ? String(raw) : undefined;
+}
+//# sourceMappingURL=diff-engine.js.map

package/dist/commands/diff-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-engine.js","sourceRoot":"","sources":["../../src/commands/diff-engine.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,GAIrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EACL,eAAe,EACf,0BAA0B,EAC1B,yBAAyB,EACzB,yBAAyB,EACzB,8BAA8B,GAE/B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAuB,MAAM,iBAAiB,CAAC;AAK1E;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,KAAiB;IAC7D,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAChE,OAAO,EAAE,IAAI,EAAE,UAAU,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC;AAC5C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAmB;IACvD,MAAM,YAAY,GAAiC,EAAE,CAAC;IACtD,KAAK,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/F,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;QAC9E,YAAY,CAAC,IAAI,CAAC;YAChB,GAAG,EAAE,QAAQ;YACb,OAAO;YACP,QAAQ,EAAE,oBAAoB,CAAC,KAAK,CAAC;YACrC,UAAU,EAAE,0BAA0B,CAAC,KAAK,CAAC;YAC7C,GAAG,EAAE,SAAS;SACf,CAAC,CAAC;IACL,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,cAAc,CACrB,KAAmB,EACnB,SAAiB,EACjB,OAAe;AACf;4DAC4D;AAC5D,MAAkC;AAClC,+EAA+E;AAC/E,YAAqB;IAErB,MAAM,cAAc,GAAG,0BAA0B,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,IAAI,CACtE,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,gBAAgB,CACnD,EAAE,KAAK,CAAC;IACT,4EAA4E;IAC5E,4EAA4E;IAC5E,yEAAyE;IACzE,4EAA4E;IAC5E,4EAA4E;IAC5E,0EAA0E;IAC1E,MAAM,GAAG,GAAG,YAAY,CAAC,CAAC,CAAC,sBAAsB,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEhG,MAAM,YAAY,GAAG,yBAAyB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC7E,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,UAAU,EAAE,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;KAC/F,CAAC,CAAC,CAAC;IAEJ,MAAM,YAAY,GAAG,yBAAyB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC7E,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,UAAU,EAAE,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAC5C,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,kEAAkE;YAClE,yEAAyE;YACzE,uEAAuE;YACvE,KAAK,EAAE,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC;SACrC,CAAC,CAAC;KACJ,CAAC,CAAC,CAAC;IAEJ,MAAM,eAAe,GAAG,KAAK,CAAC,aAAa;SACxC,UAAU,CAAC,SAAS,EAAE,gBAAgB,CAAC,aAAa,EAAE,SAAS,CAAC;SAChE,GAAG,CAAC,CAAC,MAAc,EAAE,EAAE,CAAC,CAAC;QACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,SAAS;QACzD,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,SAAS;QACjD,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,SAAS;KACtD,CAAC,CAAC,CAAC;IAEN,OAAO;QACL,OAAO;QACP,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,MAAM,EAAE,IAAI,IAAI,SAAS;QACpE,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC,SAAS,CAAC,IAAI,MAAM,EAAE,WAAW,IAAI,SAAS;QACzF,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,MAAM,EAAE,UAAU,IAAI,SAAS;QACtF,cAAc,EAAE,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,SAAS;QAC3E,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;QAC1C,YAAY;QACZ,YAAY;QACZ,eAAe;KAChB,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,KAAa;IAClC,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;AACxE,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,SAAS,sBAAsB,CAC7B,KAAmB,EACnB,SAAiB,EACjB,OAAe,EACf,aAAqB;IAErB,MAAM,KAAK,GAAG,8BAA8B,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC7E,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAChC,MAAM,GAAG,GAAG,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAClD,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,MAAM,GAAG,GAAG,IAAI,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC;IACtF,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACtF,CAAC"}