@ifc-lite/cli 0.21.1 → 0.22.0

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

@@ -0,0 +1,77 @@
+/**
+ * Which entities of a file take part in an `ifc-lite diff`, and under what key
+ * (issue #1891).
+ *
+ * One answer for both comparison modes: `--by-entity`, which reports GlobalIds
+ * added / removed / common, and `--by-content`, which fingerprints the same
+ * entities for the `@ifc-lite/diff` engine (see `diff-engine.ts`). They were
+ * two answers, and the older one was wrong in ways the user could not see.
+ *
+ * **Scope: every `IfcObjectDefinition` in the file.** IFC's three `IfcRoot`
+ * branches are not equally comparable. An `IfcObjectDefinition` (every
+ * `IfcObject` — product, task, actor, control, resource, group — plus
+ * `IfcTypeObject` and `IfcContext`) is an independently identifiable thing, and
+ * is precisely what a diff can make a claim about. The other two branches are
+ * dependent and stay out:
+ *
+ * - `IfcRelationship`: its identity is its endpoints. Re-GUIDing an
+ *   `IfcRelAggregates` while both ends are untouched is not a change anyone
+ *   wants reported, and on a re-export it is most of the reported churn.
+ * - `IfcPropertyDefinition`: a property set's content already travels with its
+ *   owner, so comparing it again double-reports every edited property — once on
+ *   the element, once on the pset.
+ *
+ * **Membership is decided from the inheritance chain of every bundled schema**
+ * (IFC2X3 + IFC4 + IFC4X3), not from what the columnar parser happened to put
+ * in its `EntityTable`, not from whichever attribute sits in slot 0 of a STEP
+ * record, and not from the IFC4 codegen pin alone. That is the whole fix for
+ * two silent defects:
+ *
+ * 1. The parser fills the table's GlobalId column positionally, and slot 0 of a
+ *    resource entity is a **Name**. An `IfcMaterial`, `IfcSurfaceStyle`,
+ *    `IfcClassification` or `IfcProjectedCRS` was therefore compared under its
+ *    name — and two of them sharing a name arrived as one entity. On the four
+ *    bundled sample models that was 4-9 colliding keys and 16-25 non-`IfcRoot`
+ *    entries per file. None of them is an `IfcRoot`, so the chain check leaves
+ *    them out and the key set is unique again.
+ * 2. The `EntityTable` only holds the categories the viewer renders, so
+ *    `IfcTask`, `IfcActor`, `IfcWorkPlan` and every other non-product
+ *    `IfcObject` answer '' from `getGlobalId` even though their STEP records
+ *    carry one. Those are read straight from the source record here.
+ *
+ * Classification happens once per *type*, so the geometry buckets — which are
+ * the bulk of a real file — are dismissed without touching a single row.
+ */
+import { extractRootAttributesFromEntity, type IfcDataStore } from '@ifc-lite/parser';
+/** The IfcRoot-family attributes read from a STEP record when the columnar
+ *  `EntityTable` does not hold the entity. */
+export type RootAttributes = ReturnType<typeof extractRootAttributesFromEntity>;
+/** One entity that takes part in the comparison. */
+export interface ComparableEntity {
+    expressId: number;
+    /** Non-empty by construction: an entity without one has no cross-file
+     *  identity and is not yielded at all. */
+    globalId: string;
+    /** The registry's PascalCase spelling where the `EntityTable` has no row (and
+     *  so answers `'Unknown'`), the table's own type name otherwise. */
+    ifcType: string;
+    /** Set only when the entity is absent from the `EntityTable`, whose display
+     *  accessors then answer '' for every attribute. */
+    source: RootAttributes | undefined;
+    /** True for an `IfcTypeObject` subtype (issue #2021). Decided from the same
+     *  cross-schema inheritance chain as {@link ComparableEntity.ifcType}, so a
+     *  type class no bundled schema declares is `false` rather than guessed —
+     *  the fingerprint then simply carries no `Tag`, which is the same answer as
+     *  a type object that has none. */
+    isTypeObject: boolean;
+}
+/**
+ * Walk a store's entity index and yield every entity the comparison covers.
+ *
+ * Lazy on purpose: `--by-entity` only needs the keys, and a generator lets it
+ * collect them without materialising a second array per file.
+ */
+export declare function comparableEntities(store: IfcDataStore): Generator<ComparableEntity>;
+/** The comparison's key set for one file: every covered entity's GlobalId. */
+export declare function comparableGlobalIds(store: IfcDataStore): Set<string>;
+//# sourceMappingURL=diff-scope.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diff-scope.d.ts","sourceRoot":"","sources":["../../src/commands/diff-scope.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,OAAO,EAEL,+BAA+B,EAE/B,KAAK,YAAY,EAClB,MAAM,kBAAkB,CAAC;AAE1B;8CAC8C;AAC9C,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAEhF,oDAAoD;AACpD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB;8CAC0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB;wEACoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB;wDACoD;IACpD,MAAM,EAAE,cAAc,GAAG,SAAS,CAAC;IACnC;;;;uCAImC;IACnC,YAAY,EAAE,OAAO,CAAC;CACvB;AAgED;;;;;GAKG;AACH,wBAAiB,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,CAAC,gBAAgB,CAAC,CAqCpF;AAED,8EAA8E;AAC9E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,GAAG,CAAC,MAAM,CAAC,CAIpE"}

package/dist/commands/diff-scope.js

@@ -0,0 +1,160 @@
+/* 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/. */
+/**
+ * Which entities of a file take part in an `ifc-lite diff`, and under what key
+ * (issue #1891).
+ *
+ * One answer for both comparison modes: `--by-entity`, which reports GlobalIds
+ * added / removed / common, and `--by-content`, which fingerprints the same
+ * entities for the `@ifc-lite/diff` engine (see `diff-engine.ts`). They were
+ * two answers, and the older one was wrong in ways the user could not see.
+ *
+ * **Scope: every `IfcObjectDefinition` in the file.** IFC's three `IfcRoot`
+ * branches are not equally comparable. An `IfcObjectDefinition` (every
+ * `IfcObject` — product, task, actor, control, resource, group — plus
+ * `IfcTypeObject` and `IfcContext`) is an independently identifiable thing, and
+ * is precisely what a diff can make a claim about. The other two branches are
+ * dependent and stay out:
+ *
+ * - `IfcRelationship`: its identity is its endpoints. Re-GUIDing an
+ *   `IfcRelAggregates` while both ends are untouched is not a change anyone
+ *   wants reported, and on a re-export it is most of the reported churn.
+ * - `IfcPropertyDefinition`: a property set's content already travels with its
+ *   owner, so comparing it again double-reports every edited property — once on
+ *   the element, once on the pset.
+ *
+ * **Membership is decided from the inheritance chain of every bundled schema**
+ * (IFC2X3 + IFC4 + IFC4X3), not from what the columnar parser happened to put
+ * in its `EntityTable`, not from whichever attribute sits in slot 0 of a STEP
+ * record, and not from the IFC4 codegen pin alone. That is the whole fix for
+ * two silent defects:
+ *
+ * 1. The parser fills the table's GlobalId column positionally, and slot 0 of a
+ *    resource entity is a **Name**. An `IfcMaterial`, `IfcSurfaceStyle`,
+ *    `IfcClassification` or `IfcProjectedCRS` was therefore compared under its
+ *    name — and two of them sharing a name arrived as one entity. On the four
+ *    bundled sample models that was 4-9 colliding keys and 16-25 non-`IfcRoot`
+ *    entries per file. None of them is an `IfcRoot`, so the chain check leaves
+ *    them out and the key set is unique again.
+ * 2. The `EntityTable` only holds the categories the viewer renders, so
+ *    `IfcTask`, `IfcActor`, `IfcWorkPlan` and every other non-product
+ *    `IfcObject` answer '' from `getGlobalId` even though their STEP records
+ *    carry one. Those are read straight from the source record here.
+ *
+ * Classification happens once per *type*, so the geometry buckets — which are
+ * the bulk of a real file — are dismissed without touching a single row.
+ */
+import { EntityExtractor, extractRootAttributesFromEntity, getInheritanceChainAcrossSchemas, } from '@ifc-lite/parser';
+/**
+ * Classify one STEP type against the three `IfcRoot` branches.
+ *
+ * The chain has to come from **every bundled schema**, not from the parser's
+ * IFC4 codegen pin. `getInheritanceChainForEntity` answers an empty chain for
+ * any class the pin does not carry, and that is not a rare corner: IFC2X3 alone
+ * puts 23 `IfcObjectDefinition` classes there (`IfcMove`, `IfcOrderAction`,
+ * `IfcScheduleTimeControl`, `IfcSpaceProgram`, `IfcServiceLife`, …) and IFC4X3
+ * another 77. Judging those as `unknown` dropped the ones the `EntityTable`
+ * does not hold — real objects with real GlobalIds, which the walk this
+ * replaced did compare — and let through the IFC2X3-only *resource* classes it
+ * does hold under a `…STYLE` name, keyed on the Name in slot 0. Both are wrong
+ * answers about an IFC2X3 file, which is still most of what is in the wild.
+ *
+ * `unknown` is still not `dependent`: a vendor extension no schema declares has
+ * no chain to judge, so it keeps exactly the reach the `EntityTable` gives it —
+ * which for a `…TYPE` class is a genuine GlobalId, since the parser's
+ * type-object branch is name-based and takes those in. Guessing that an
+ * unrecognised class is an `IfcObject` and reading its source record instead
+ * would cost one STEP extraction per row of every unrecognised bucket in the
+ * file, on every file, to reach entities almost no file has. The price of that
+ * choice is that a vendor `IfcRoot` subtype whose name does not end in `TYPE`
+ * stays uncompared.
+ *
+ * The one name the chain is not needed for is `IFCREL…`: that prefix is the
+ * parser's own rule for taking an unrecognised relationship into the table, and
+ * a relationship is excluded here whether any schema can confirm it or not.
+ * Without this, an unrecognised `IfcRelXxx` would be the single class of entity
+ * that got in through the relationship branch the comparison deliberately shuts.
+ */
+function classifyType(typeKey) {
+    const upper = typeKey.toUpperCase();
+    const chain = getInheritanceChainAcrossSchemas(upper);
+    if (chain.length === 0) {
+        return {
+            role: upper.startsWith('IFCREL') ? 'dependent' : 'unknown',
+            name: typeKey,
+            typeObject: false,
+        };
+    }
+    // The chain holds the class itself plus its supertypes; which end the leaf
+    // sits at is the schema source's business, so find it by name.
+    const name = chain.find((ancestor) => ancestor.toUpperCase() === upper) ?? typeKey;
+    const typeObject = chain.includes('IfcTypeObject');
+    if (!chain.includes('IfcRoot'))
+        return { role: 'dependent', name, typeObject };
+    return {
+        role: chain.includes('IfcObjectDefinition') ? 'independent' : 'dependent',
+        name,
+        typeObject,
+    };
+}
+/**
+ * Walk a store's entity index and yield every entity the comparison covers.
+ *
+ * Lazy on purpose: `--by-entity` only needs the keys, and a generator lets it
+ * collect them without materialising a second array per file.
+ */
+export function* comparableEntities(store) {
+    const seen = new Set();
+    // One extractor for the whole file: it holds a buffer reference, and the
+    // source read below only fires for the (small) set of object types the
+    // EntityTable declines to hold.
+    const extractor = new EntityExtractor(store.source);
+    for (const [typeKey, ids] of store.entityIndex.byType) {
+        const type = classifyType(typeKey);
+        if (type.role === 'dependent')
+            continue;
+        for (const expressId of ids) {
+            if (seen.has(expressId))
+                continue;
+            seen.add(expressId);
+            let globalId = store.entities.getGlobalId(expressId);
+            let source;
+            if (!globalId && type.role === 'independent') {
+                // In the file but not in the table: a schedule task, an actor, a work
+                // plan. Its GlobalId is in the STEP record, so read it there.
+                source = readRootAttributes(extractor, store, expressId);
+                globalId = source?.globalId ?? '';
+            }
+            // Still nothing: the entity is not an IfcRoot at all (a placement, a
+            // profile, a representation item), so it has no cross-file identity.
+            if (!globalId)
+                continue;
+            const tableType = store.entities.getTypeName(expressId);
+            // `getTypeName` answers 'Unknown' for a row the table never took in. The
+            // registry's own spelling is the honest answer, and on the content path
+            // it has to be a real type name: `ifcType` is hashed into the fingerprint
+            // and cross-checked on every match, so 'Unknown' would pair a task with
+            // an actor.
+            const ifcType = source && (!tableType || tableType === 'Unknown') ? type.name : tableType;
+            yield { expressId, globalId, ifcType, source, isTypeObject: type.typeObject };
+        }
+    }
+}
+/** The comparison's key set for one file: every covered entity's GlobalId. */
+export function comparableGlobalIds(store) {
+    const keys = new Set();
+    for (const entity of comparableEntities(store))
+        keys.add(entity.globalId);
+    return keys;
+}
+/** IfcRoot attributes straight from the entity's STEP record, for the rows the
+ *  columnar `EntityTable` never took in. */
+function readRootAttributes(extractor, store, expressId) {
+    const ref = store.entityIndex.byId.get(expressId);
+    if (!ref)
+        return undefined;
+    const entity = extractor.extractEntity(ref);
+    return entity ? extractRootAttributesFromEntity(entity) : undefined;
+}
+//# sourceMappingURL=diff-scope.js.map

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

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

package/dist/commands/diff-test-helpers.d.ts

@@ -0,0 +1,70 @@
+/** Shared STEP fixtures for the `diff --by-content` test suites (issue #1891). */
+/** A 22-character IFC GlobalId from a short mnemonic. */
+export declare function guid(mnemonic: string): string;
+/** A minimal but real model: project, units, context, storey, two named walls
+ *  with a spatial containment relation. `wallA`/`wallB` are the GlobalIds, so a
+ *  "re-export" is the same call with different ones. */
+export declare function model(wallA: string, wallB: string): string;
+/**
+ * One entity from each `IfcRoot` branch, plus classes that are not `IfcRoot` at
+ * all and classes no schema registry knows.
+ *
+ * - `IfcTask` / `IfcActor` are `IfcObjectDefinition`s the columnar parser does
+ *   not put in its `EntityTable` (they are not `IfcProduct` subtypes), so their
+ *   GlobalId has to come from the STEP record.
+ * - `IfcRelDefinesByProperties` is an `IfcRelationship` and `IfcPropertySet` is
+ *   an `IfcPropertyDefinition`: both carry GlobalIds, both stay out.
+ * - `IfcMaterial` has no GlobalId at all — its first attribute is a Name, which
+ *   the parser's positional extraction stores in the table's GlobalId column.
+ * - `IfcVendorTask`, `IfcVendorWallType` and `IfcRelVendorLink` are in no schema
+ *   registry. The parser's two name-based branches (`…TYPE`, `IFCREL…`) still
+ *   take the last two into its table.
+ */
+export declare function scheduleModel(taskGuid: string): string;
+/**
+ * An IFC2X3 file whose objects are classes IFC4 dropped, so the parser's IFC4
+ * codegen pin knows none of them.
+ *
+ * - `IfcMove` (an `IfcTask` subtype) and `IfcSpaceProgram` (an `IfcControl`)
+ *   are `IfcObjectDefinition`s with real GlobalIds in slot 0, and are not
+ *   `IfcProduct`s, so the `EntityTable` does not hold them.
+ * - `IfcSymbolStyle` is a *resource*: no GlobalId at all, a Name in slot 0. Its
+ *   class name ends in `STYLE`, which is one of the parser's two name-based
+ *   branches, so the table does hold it — with `hatch` in the GlobalId column.
+ * - `IfcGasTerminalType` is a real `IfcTypeObject`, reached through the other
+ *   name-based branch (`…TYPE`).
+ *
+ * Deciding membership from the IFC4 pin alone gets all three wrong at once.
+ */
+export declare function legacyScheduleModel(moveGuid: string): string;
+/**
+ * The `Tag` scoping fixture (issue #2021), in both directions at once.
+ *
+ * Two `IfcWallType`s that agree on everything the fingerprint hashed before
+ * `Tag` did — same Name, same ElementType, same PredefinedType, no properties —
+ * and differ only in `Tag`. That is Duplex's eight `'800 mm'`
+ * `IfcFurnitureType`s reduced to two, and a type object has no geometry hash,
+ * so before #2021 nothing could separate them.
+ *
+ * Two `IfcWall`s built the same way, differing only in `Tag`. An occurrence's
+ * `Tag` is the authoring tool's element id rather than design content, so it
+ * must stay OUT of the hash — these two must keep hashing identically.
+ */
+export declare function typeTagModel(): string;
+/**
+ * The same `Tag` question on a class the IFC4 codegen pin does not carry.
+ *
+ * `IfcRailType` is IFC4X3-only. Its inheritance chain resolves across the
+ * bundled schemas, so it is correctly in scope and correctly an `IfcTypeObject`
+ * — but its *attribute names* do not resolve through the pinned registry
+ * (`getAttributeNames('IfcRailType')` is empty, `getAttributeNamesAcrossSchemas`
+ * gives all ten with `Tag` at index 7). A `Tag` lookup that goes through the pin
+ * therefore finds nothing and silently no-ops on exactly the infrastructure
+ * classes IFC4X3 exists for, while passing every test written against IFC2X3 and
+ * IFC4. Same pinned-registry family as #2001/#2003.
+ */
+export declare function railTypeModel(): string;
+export declare const BASE_MODEL: string;
+/** Same building, re-exported: the two walls carry brand-new GlobalIds. */
+export declare const HEAD_MODEL: string;
+//# sourceMappingURL=diff-test-helpers.d.ts.map

package/dist/commands/diff-test-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-test-helpers.d.ts","sourceRoot":"","sources":["../../src/commands/diff-test-helpers.ts"],"names":[],"mappings":"AAIA,kFAAkF;AAElF,yDAAyD;AACzD,wBAAgB,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;wDAEwD;AACxD,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CA4B1D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA+BtD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA0B5D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAwBrC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAmBtC;AAED,eAAO,MAAM,UAAU,QAAoC,CAAC;AAC5D,2EAA2E;AAC3E,eAAO,MAAM,UAAU,QAAoC,CAAC"}

package/dist/commands/diff-test-helpers.js

@@ -0,0 +1,203 @@
+/* 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/. */
+/** Shared STEP fixtures for the `diff --by-content` test suites (issue #1891). */
+/** A 22-character IFC GlobalId from a short mnemonic. */
+export function guid(mnemonic) {
+    return (mnemonic + '0'.repeat(22)).slice(0, 22);
+}
+/** A minimal but real model: project, units, context, storey, two named walls
+ *  with a spatial containment relation. `wallA`/`wallB` are the GlobalIds, so a
+ *  "re-export" is the same call with different ones. */
+export function model(wallA, wallB) {
+    return `ISO-10303-21;
+HEADER;
+FILE_DESCRIPTION((''),'2;1');
+FILE_NAME('m','2026',(''),(''),'','','');
+FILE_SCHEMA(('IFC4'));
+ENDSEC;
+DATA;
+#1= IFCPROJECT('${guid('PROJ')}',$,'Proj',$,$,$,$,(#20),#30);
+#20= IFCGEOMETRICREPRESENTATIONCONTEXT($,'Model',3,1.E-5,#21,$);
+#21= IFCAXIS2PLACEMENT3D(#22,$,$);
+#22= IFCCARTESIANPOINT((0.,0.,0.));
+#30= IFCUNITASSIGNMENT((#31));
+#31= IFCSIUNIT(*,.LENGTHUNIT.,$,.METRE.);
+#40= IFCLOCALPLACEMENT($,#21);
+#41= IFCBUILDINGSTOREY('${guid('STOR')}',$,'L01',$,$,#40,$,$,.ELEMENT.,0.);
+#50= IFCLOCALPLACEMENT(#40,#21);
+#60= IFCRECTANGLEPROFILEDEF(.AREA.,$,#21,2.,0.2);
+#61= IFCEXTRUDEDAREASOLID(#60,#21,#62,3.);
+#62= IFCDIRECTION((0.,0.,1.));
+#63= IFCSHAPEREPRESENTATION(#20,'Body','SweptSolid',(#61));
+#64= IFCPRODUCTDEFINITIONSHAPE($,$,(#63));
+#70= IFCWALL('${wallA}',$,'Wall A',$,$,#50,#64,'tagA',$);
+#71= IFCWALL('${wallB}',$,'Wall B',$,$,#50,#64,'tagB',$);
+#80= IFCRELCONTAINEDINSPATIALSTRUCTURE('${guid('RELC')}',$,$,$,(#70,#71),#41);
+ENDSEC;
+END-ISO-10303-21;
+`;
+}
+/**
+ * One entity from each `IfcRoot` branch, plus classes that are not `IfcRoot` at
+ * all and classes no schema registry knows.
+ *
+ * - `IfcTask` / `IfcActor` are `IfcObjectDefinition`s the columnar parser does
+ *   not put in its `EntityTable` (they are not `IfcProduct` subtypes), so their
+ *   GlobalId has to come from the STEP record.
+ * - `IfcRelDefinesByProperties` is an `IfcRelationship` and `IfcPropertySet` is
+ *   an `IfcPropertyDefinition`: both carry GlobalIds, both stay out.
+ * - `IfcMaterial` has no GlobalId at all — its first attribute is a Name, which
+ *   the parser's positional extraction stores in the table's GlobalId column.
+ * - `IfcVendorTask`, `IfcVendorWallType` and `IfcRelVendorLink` are in no schema
+ *   registry. The parser's two name-based branches (`…TYPE`, `IFCREL…`) still
+ *   take the last two into its table.
+ */
+export function scheduleModel(taskGuid) {
+    return `ISO-10303-21;
+HEADER;
+FILE_DESCRIPTION((''),'2;1');
+FILE_NAME('m','2026',(''),(''),'','','');
+FILE_SCHEMA(('IFC4'));
+ENDSEC;
+DATA;
+#1= IFCPROJECT('${guid('PROJ')}',$,'Proj',$,$,$,$,(#20),#30);
+#20= IFCGEOMETRICREPRESENTATIONCONTEXT($,'Model',3,1.E-5,#21,$);
+#21= IFCAXIS2PLACEMENT3D(#22,$,$);
+#22= IFCCARTESIANPOINT((0.,0.,0.));
+#30= IFCUNITASSIGNMENT((#31));
+#31= IFCSIUNIT(*,.LENGTHUNIT.,$,.METRE.);
+#40= IFCLOCALPLACEMENT($,#21);
+#41= IFCBUILDINGSTOREY('${guid('STOR')}',$,'L01',$,$,#40,$,$,.ELEMENT.,0.);
+#70= IFCWALL('${guid('WALL')}',$,'Wall A',$,$,#40,$,'tagA',$);
+#80= IFCMATERIAL('brick',$,$);
+#81= IFCPROPERTYSET('${guid('PSET')}',$,'Pset_X',$,(#82));
+#82= IFCPROPERTYSINGLEVALUE('P',$,IFCLABEL('v'),$);
+#83= IFCRELDEFINESBYPROPERTIES('${guid('RELP')}',$,$,$,(#70),#81);
+#90= IFCTASK('${taskGuid}',$,'Pour slab',$,$,$,$,'ID1',$,.F.,$,$,.CONSTRUCTION.);
+#91= IFCACTOR('${guid('ACTR')}',$,'Site manager',$,$,#92,$);
+#92= IFCPERSON($,'Doe','Jane',$,$,$,$,$);
+#96= IFCRELCONTAINEDINSPATIALSTRUCTURE('${guid('RELC')}',$,$,$,(#70),#41);
+#97= IFCVENDORTASK('${guid('VEND')}',$,'Custom',$);
+#98= IFCVENDORWALLTYPE('${guid('VTYP')}',$,'Custom type',$,$,$,$,$,$,$);
+#99= IFCRELVENDORLINK('${guid('VREL')}',$,$,$,(#70),#41);
+ENDSEC;
+END-ISO-10303-21;
+`;
+}
+/**
+ * An IFC2X3 file whose objects are classes IFC4 dropped, so the parser's IFC4
+ * codegen pin knows none of them.
+ *
+ * - `IfcMove` (an `IfcTask` subtype) and `IfcSpaceProgram` (an `IfcControl`)
+ *   are `IfcObjectDefinition`s with real GlobalIds in slot 0, and are not
+ *   `IfcProduct`s, so the `EntityTable` does not hold them.
+ * - `IfcSymbolStyle` is a *resource*: no GlobalId at all, a Name in slot 0. Its
+ *   class name ends in `STYLE`, which is one of the parser's two name-based
+ *   branches, so the table does hold it — with `hatch` in the GlobalId column.
+ * - `IfcGasTerminalType` is a real `IfcTypeObject`, reached through the other
+ *   name-based branch (`…TYPE`).
+ *
+ * Deciding membership from the IFC4 pin alone gets all three wrong at once.
+ */
+export function legacyScheduleModel(moveGuid) {
+    return `ISO-10303-21;
+HEADER;
+FILE_DESCRIPTION((''),'2;1');
+FILE_NAME('m','2026',(''),(''),'','','');
+FILE_SCHEMA(('IFC2X3'));
+ENDSEC;
+DATA;
+#1= IFCPROJECT('${guid('PROJ')}',$,'Proj',$,$,$,$,(#20),#30);
+#20= IFCGEOMETRICREPRESENTATIONCONTEXT($,'Model',3,1.E-5,#21,$);
+#21= IFCAXIS2PLACEMENT3D(#22,$,$);
+#22= IFCCARTESIANPOINT((0.,0.,0.));
+#30= IFCUNITASSIGNMENT((#31));
+#31= IFCSIUNIT(*,.LENGTHUNIT.,$,.METRE.);
+#40= IFCLOCALPLACEMENT($,#21);
+#41= IFCBUILDINGSTOREY('${guid('STOR')}',$,'L01',$,$,#40,$,$,.ELEMENT.,0.);
+#70= IFCWALLSTANDARDCASE('${guid('WALL')}',$,'Wall A',$,$,#40,$,'tagA');
+#90= IFCMOVE('${moveGuid}',$,'Move A',$,$,'ID1',$,$,.F.,$,#41,#41,$);
+#91= IFCSPACEPROGRAM('${guid('SPGM')}',$,'Program A',$,$,'SP1',$,$,$,$);
+#92= IFCSYMBOLSTYLE('hatch',#93);
+#93= IFCDEFINEDSYMBOL($,$);
+#94= IFCGASTERMINALTYPE('${guid('GTTY')}',$,'GT',$,$,$,$,$,$,.GASAPPLIANCE.);
+#96= IFCRELCONTAINEDINSPATIALSTRUCTURE('${guid('RELC')}',$,$,$,(#70),#41);
+ENDSEC;
+END-ISO-10303-21;
+`;
+}
+/**
+ * The `Tag` scoping fixture (issue #2021), in both directions at once.
+ *
+ * Two `IfcWallType`s that agree on everything the fingerprint hashed before
+ * `Tag` did — same Name, same ElementType, same PredefinedType, no properties —
+ * and differ only in `Tag`. That is Duplex's eight `'800 mm'`
+ * `IfcFurnitureType`s reduced to two, and a type object has no geometry hash,
+ * so before #2021 nothing could separate them.
+ *
+ * Two `IfcWall`s built the same way, differing only in `Tag`. An occurrence's
+ * `Tag` is the authoring tool's element id rather than design content, so it
+ * must stay OUT of the hash — these two must keep hashing identically.
+ */
+export function typeTagModel() {
+    return `ISO-10303-21;
+HEADER;
+FILE_DESCRIPTION((''),'2;1');
+FILE_NAME('m','2026',(''),(''),'','','');
+FILE_SCHEMA(('IFC4'));
+ENDSEC;
+DATA;
+#1= IFCPROJECT('${guid('PROJ')}',$,'Proj',$,$,$,$,(#20),#30);
+#20= IFCGEOMETRICREPRESENTATIONCONTEXT($,'Model',3,1.E-5,#21,$);
+#21= IFCAXIS2PLACEMENT3D(#22,$,$);
+#22= IFCCARTESIANPOINT((0.,0.,0.));
+#30= IFCUNITASSIGNMENT((#31));
+#31= IFCSIUNIT(*,.LENGTHUNIT.,$,.METRE.);
+#40= IFCLOCALPLACEMENT($,#21);
+#41= IFCBUILDINGSTOREY('${guid('STOR')}',$,'L01',$,$,#40,$,$,.ELEMENT.,0.);
+#50= IFCWALLTYPE('${guid('TYPA')}',$,'800 mm',$,$,$,$,'157200','800 mm',.STANDARD.);
+#51= IFCWALLTYPE('${guid('TYPB')}',$,'800 mm',$,$,$,$,'157607','800 mm',.STANDARD.);
+#70= IFCWALL('${guid('WALA')}',$,'Wall',$,$,#40,$,'tagA',.STANDARD.);
+#71= IFCWALL('${guid('WALB')}',$,'Wall',$,$,#40,$,'tagB',.STANDARD.);
+#80= IFCRELCONTAINEDINSPATIALSTRUCTURE('${guid('RELC')}',$,$,$,(#70,#71),#41);
+ENDSEC;
+END-ISO-10303-21;
+`;
+}
+/**
+ * The same `Tag` question on a class the IFC4 codegen pin does not carry.
+ *
+ * `IfcRailType` is IFC4X3-only. Its inheritance chain resolves across the
+ * bundled schemas, so it is correctly in scope and correctly an `IfcTypeObject`
+ * — but its *attribute names* do not resolve through the pinned registry
+ * (`getAttributeNames('IfcRailType')` is empty, `getAttributeNamesAcrossSchemas`
+ * gives all ten with `Tag` at index 7). A `Tag` lookup that goes through the pin
+ * therefore finds nothing and silently no-ops on exactly the infrastructure
+ * classes IFC4X3 exists for, while passing every test written against IFC2X3 and
+ * IFC4. Same pinned-registry family as #2001/#2003.
+ */
+export function railTypeModel() {
+    return `ISO-10303-21;
+HEADER;
+FILE_DESCRIPTION((''),'2;1');
+FILE_NAME('m','2026',(''),(''),'','','');
+FILE_SCHEMA(('IFC4X3'));
+ENDSEC;
+DATA;
+#1= IFCPROJECT('${guid('PROJ')}',$,'Proj',$,$,$,$,(#20),#30);
+#20= IFCGEOMETRICREPRESENTATIONCONTEXT($,'Model',3,1.E-5,#21,$);
+#21= IFCAXIS2PLACEMENT3D(#22,$,$);
+#22= IFCCARTESIANPOINT((0.,0.,0.));
+#30= IFCUNITASSIGNMENT((#31));
+#31= IFCSIUNIT(*,.LENGTHUNIT.,$,.METRE.);
+#50= IFCRAILTYPE('${guid('RALA')}',$,'60E1',$,$,$,$,'157200','60E1',.RACKRAIL.);
+#51= IFCRAILTYPE('${guid('RALB')}',$,'60E1',$,$,$,$,'157607','60E1',.RACKRAIL.);
+ENDSEC;
+END-ISO-10303-21;
+`;
+}
+export const BASE_MODEL = model(guid('OLDA'), guid('OLDB'));
+/** Same building, re-exported: the two walls carry brand-new GlobalIds. */
+export const HEAD_MODEL = model(guid('NEWA'), guid('NEWB'));
+//# sourceMappingURL=diff-test-helpers.js.map

package/dist/commands/diff-test-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-test-helpers.js","sourceRoot":"","sources":["../../src/commands/diff-test-helpers.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D,kFAAkF;AAElF,yDAAyD;AACzD,MAAM,UAAU,IAAI,CAAC,QAAgB;IACnC,OAAO,CAAC,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClD,CAAC;AAED;;wDAEwD;AACxD,MAAM,UAAU,KAAK,CAAC,KAAa,EAAE,KAAa;IAChD,OAAO;;;;;;;kBAOS,IAAI,CAAC,MAAM,CAAC;;;;;;;0BAOJ,IAAI,CAAC,MAAM,CAAC;;;;;;;gBAOtB,KAAK;gBACL,KAAK;0CACqB,IAAI,CAAC,MAAM,CAAC;;;CAGrD,CAAC;AACF,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,OAAO;;;;;;;kBAOS,IAAI,CAAC,MAAM,CAAC;;;;;;;0BAOJ,IAAI,CAAC,MAAM,CAAC;gBACtB,IAAI,CAAC,MAAM,CAAC;;uBAEL,IAAI,CAAC,MAAM,CAAC;;kCAED,IAAI,CAAC,MAAM,CAAC;gBAC9B,QAAQ;iBACP,IAAI,CAAC,MAAM,CAAC;;0CAEa,IAAI,CAAC,MAAM,CAAC;sBAChC,IAAI,CAAC,MAAM,CAAC;0BACR,IAAI,CAAC,MAAM,CAAC;yBACb,IAAI,CAAC,MAAM,CAAC;;;CAGpC,CAAC;AACF,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAClD,OAAO;;;;;;;kBAOS,IAAI,CAAC,MAAM,CAAC;;;;;;;0BAOJ,IAAI,CAAC,MAAM,CAAC;4BACV,IAAI,CAAC,MAAM,CAAC;gBACxB,QAAQ;wBACA,IAAI,CAAC,MAAM,CAAC;;;2BAGT,IAAI,CAAC,MAAM,CAAC;0CACG,IAAI,CAAC,MAAM,CAAC;;;CAGrD,CAAC;AACF,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO;;;;;;;kBAOS,IAAI,CAAC,MAAM,CAAC;;;;;;;0BAOJ,IAAI,CAAC,MAAM,CAAC;oBAClB,IAAI,CAAC,MAAM,CAAC;oBACZ,IAAI,CAAC,MAAM,CAAC;gBAChB,IAAI,CAAC,MAAM,CAAC;gBACZ,IAAI,CAAC,MAAM,CAAC;0CACc,IAAI,CAAC,MAAM,CAAC;;;CAGrD,CAAC;AACF,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO;;;;;;;kBAOS,IAAI,CAAC,MAAM,CAAC;;;;;;oBAMV,IAAI,CAAC,MAAM,CAAC;oBACZ,IAAI,CAAC,MAAM,CAAC;;;CAG/B,CAAC;AACF,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AAC5D,2EAA2E;AAC3E,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC"}

package/dist/commands/diff.d.ts

@@ -1,2 +1,3 @@
+export declare function diffPositionals(args: string[]): string[];
 export declare function diffCommand(args: string[]): Promise<void>;
 //# sourceMappingURL=diff.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/commands/diff.ts"],"names":[],"mappings":"AAgBA,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAqG/D"}
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/commands/diff.ts"],"names":[],"mappings":"AAmCA,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAWxD;AAYD,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA8G/D"}