@ifc-lite/parser 4.3.2 → 5.1.0

package/dist/property-set-merge.js

@@ -2,30 +2,27 @@
  * 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/. */
 /**
- * Compose an occurrence's own property sets with those it inherits from its
- * `IfcTypeProduct`, the way IFC defines the inheritance: **per property, not
- * per property set**.
- *
- * An occurrence and its type routinely both carry a set of the same name —
- * `Pset_CoveringCommon` holding `IsExternal`/`Reference` on the occurrence and
- * `SurfaceSpreadOfFlame`/`Combustible` on the type is a plain Revit export.
- * Dropping the whole inherited set on a name collision makes every type-only
- * property in it invisible, which is what made IDS report a present property as
- * missing (#1913). Where both define the same property name, the occurrence
- * wins — it is the more specific definition.
+ * How property/quantity sets coming from two different sources compose: an
+ * occurrence's own sets with the ones it inherits from its `IfcTypeProduct`
+ * ({@link mergeInheritedPropertySets}, {@link mergeInheritedQuantitySets}),
+ * and a type's `HasPropertySets` list with the sets attached to it by
+ * `IfcRelDefinesByProperties` ({@link appendSetsFromSecondSource}).
  *
- * An occurrence may carry **several** sets of one name (one per
- * `IfcRelDefinesByProperties`; nothing dedupes them, and merged/federated
- * exports produce them). Inherited properties are merged into *every* one of
- * them, not just the first: IDS requires every set matching the facet's
- * `propertySet` constraint to satisfy it, so augmenting one and leaving its
- * twin bare would reintroduce the same false "not found" this rule exists to
- * prevent.
+ * Their own module rather than a corner of `on-demand-extractors.ts`: the rules
+ * are independent of how either side was extracted, and every consumer that
+ * resolves sets from more than one source needs the same answer.
+ */
+/**
+ * Compose an occurrence's own named sets with those it inherits from its
+ * `IfcTypeProduct`, the way IFC defines the inheritance: **per item (property
+ * or quantity), not per set**. Shared core for {@link mergeInheritedPropertySets}
+ * and {@link mergeInheritedQuantitySets} — see those for the rule this
+ * implements and why.
  *
- * Neither input is mutated: a set that gains inherited properties is returned
- * as a new object, so cached extractor results stay intact.
+ * `getItems`/`withItems` isolate the one difference between the two: which
+ * field holds the named children (`properties` vs `quantities`).
  */
-export function mergeInheritedPropertySets(ownSets, inheritedSets) {
+function mergeInheritedNamedSets(ownSets, inheritedSets, getItems, withItems) {
     if (inheritedSets.length === 0)
         return ownSets.slice();
     const merged = ownSets.slice();
@@ -38,7 +35,13 @@ export function mergeInheritedPropertySets(ownSets, inheritedSets) {
             indicesByName.set(merged[i].name, [i]);
     }
     for (const inherited of inheritedSets) {
-        const indices = indicesByName.get(inherited.name);
+        // An UNNAMED set matches nothing: since #3530 every set the source left
+        // without a Name reports `''`, so keying on it would fold an unnamed
+        // inherited set into an unrelated unnamed occurrence set and lose any
+        // item the two happen to share. Before #3530 the two carried distinct
+        // placeholder names and were kept apart here; an absent name is
+        // evidence of nothing, least of all of sameness.
+        const indices = inherited.name ? indicesByName.get(inherited.name) : undefined;
         if (!indices) {
             // Appended as-is, and deliberately NOT recorded in `indicesByName`:
             // that index tracks OCCURRENCE sets only. Recording it would make a
@@ -50,17 +53,115 @@ export function mergeInheritedPropertySets(ownSets, inheritedSets) {
         }
         for (const index of indices) {
             const own = merged[index];
-            const ownPropNames = new Set(own.properties.map((p) => p.name));
-            const additions = inherited.properties.filter((p) => !ownPropNames.has(p.name));
+            const ownItems = getItems(own);
+            const ownNames = new Set(ownItems.map((p) => p.name));
+            const additions = getItems(inherited).filter((p) => !ownNames.has(p.name));
             if (additions.length === 0)
                 continue;
-            // `as T`: the spread reproduces every field of `own` and replaces
-            // only `properties` with a superset of the same element type, but
-            // TypeScript cannot narrow a spread of an unresolved generic back
-            // to that generic.
-            merged[index] = { ...own, properties: [...own.properties, ...additions] };
+            merged[index] = withItems(own, [...ownItems, ...additions]);
         }
     }
     return merged;
 }
+/**
+ * Compose an occurrence's own property sets with those it inherits from its
+ * `IfcTypeProduct`, the way IFC defines the inheritance: **per property, not
+ * per property set**.
+ *
+ * An occurrence and its type routinely both carry a set of the same name —
+ * `Pset_CoveringCommon` holding `IsExternal`/`Reference` on the occurrence and
+ * `SurfaceSpreadOfFlame`/`Combustible` on the type is a plain Revit export.
+ * Dropping the whole inherited set on a name collision makes every type-only
+ * property in it invisible, which is what made IDS report a present property as
+ * missing (#1913). Where both define the same property name, the occurrence
+ * wins — it is the more specific definition.
+ *
+ * An occurrence may carry **several** sets of one name (one per
+ * `IfcRelDefinesByProperties`; nothing dedupes them, and merged/federated
+ * exports produce them). Inherited properties are merged into *every* one of
+ * them, not just the first: IDS requires every set matching the facet's
+ * `propertySet` constraint to satisfy it, so augmenting one and leaving its
+ * twin bare would reintroduce the same false "not found" this rule exists to
+ * prevent.
+ *
+ * Neither input is mutated: a set that gains inherited properties is returned
+ * as a new object, so cached extractor results stay intact.
+ */
+export function mergeInheritedPropertySets(ownSets, inheritedSets) {
+    return mergeInheritedNamedSets(ownSets, inheritedSets, (set) => set.properties, 
+    // `as T`: the spread reproduces every field of `set` and replaces only
+    // `properties` with a superset of the same element type, but
+    // TypeScript cannot narrow a spread of an unresolved generic back to
+    // that generic.
+    (set, properties) => ({ ...set, properties }));
+}
+/**
+ * Compose an occurrence's own quantity sets (`IfcElementQuantity`) with those
+ * it inherits from its `IfcTypeProduct`, applying the same per-item rule
+ * {@link mergeInheritedPropertySets} applies to property sets: a same-named
+ * set does not replace or get replaced wholesale, it is topped up quantity by
+ * quantity, and the occurrence wins a same-named-quantity collision.
+ *
+ * IFC does not distinguish properties from quantities for this purpose —
+ * both live in the type's `HasPropertySets` list alongside each other — so a
+ * consumer that resolves inherited properties this way but resolves
+ * quantities by only ever looking at the occurrence's own sets silently
+ * drops every quantity a type-level `Qto_*` set carries (e.g.
+ * `Qto_WallBaseQuantities` attached to `IfcWallType` rather than each wall).
+ */
+export function mergeInheritedQuantitySets(ownSets, inheritedSets) {
+    return mergeInheritedNamedSets(ownSets, inheritedSets, (set) => set.quantities, (set, quantities) => ({ ...set, quantities }));
+}
+/**
+ * Identity key for a property/quantity set: `(name, globalId)` joined with a
+ * NUL separator, the same convention `groupPropertySetsByInstance`/
+ * `groupQuantitySetsByInstance` (`@ifc-lite/data`) use for the occurrence-level
+ * `PropertyTable`/`QuantityTable` (#3603, #3606). A name alone is only a proxy
+ * for identity: two distinct `IfcPropertySet`/`IfcElementQuantity` instances
+ * routinely share a literal name (a federated merge, or an exporter emitting
+ * the same `Qto_` set twice), and a name-only key folds one into the other,
+ * silently dropping whichever loses (#3722). Those helpers operate on
+ * columnar `Uint32Array` string-table indices and this module on
+ * already-extracted set objects, so the identity-key SHAPE is shared but not
+ * the function itself.
+ */
+export function setIdentityKey(set) {
+    return set.name + '\u0000' + (set.globalId ?? '');
+}
+/**
+ * Append the sets a type carries via `IfcRelDefinesByProperties` to the ones
+ * already collected from its `HasPropertySets` attribute, listing a set that is
+ * reachable BOTH ways only once.
+ *
+ * The dedupe is by express id first. A name is only a proxy for identity, and
+ * since #3530 it stopped being even that: every set the source left unnamed
+ * now reports `''`, so a name-only check would fold every unnamed set from the
+ * second source into the first unnamed one from the first and drop its
+ * properties outright. The identity-key check ({@link setIdentityKey}) is still
+ * applied on top for genuinely named sets, where an empty set from one source
+ * must not shadow a populated same-named set from the other -- but it keys on
+ * `(name, globalId)`, not name alone, so two distinct same-named instances
+ * (different GlobalId) both survive (#3722); only a second row of the SAME
+ * instance still collapses.
+ *
+ * `extract` is called at most once, with the ids the first source did not
+ * already contribute.
+ */
+export function appendSetsFromSecondSource(into, firstSourceIds, firstSourceKeys, candidateIds, extract) {
+    const fresh = candidateIds.filter((id) => !firstSourceIds.has(id));
+    if (fresh.length === 0)
+        return;
+    const acceptedKeys = new Set();
+    for (const set of extract(fresh)) {
+        // A set with either a name or a globalId has an identity worth
+        // deduplicating on; only a set with neither passes through unkeyed.
+        if (set.name || set.globalId) {
+            const key = setIdentityKey(set);
+            if (firstSourceKeys.has(key) || acceptedKeys.has(key))
+                continue;
+            acceptedKeys.add(key);
+        }
+        into.push(set);
+    }
+}
 //# sourceMappingURL=property-set-merge.js.map

package/dist/property-set-merge.js.map

@@ -1 +1 @@
-{"version":3,"file":"property-set-merge.js","sourceRoot":"","sources":["../src/property-set-merge.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAsB/D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,0BAA0B,CACtC,OAAqB,EACrB,aAA2B;IAE3B,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC,KAAK,EAAE,CAAC;IAEvD,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAC/B,MAAM,aAAa,GAAG,IAAI,GAAG,EAAoB,CAAC;IAClD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,MAAM;YAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;;YACtB,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,MAAM,SAAS,IAAI,aAAa,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,oEAAoE;YACpE,oEAAoE;YACpE,oEAAoE;YACpE,iEAAiE;YACjE,wCAAwC;YACxC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACvB,SAAS;QACb,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC1B,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YAC1B,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YAChE,MAAM,SAAS,GAAG,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YAChF,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YACrC,kEAAkE;YAClE,kEAAkE;YAClE,kEAAkE;YAClE,mBAAmB;YACnB,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,GAAG,EAAE,UAAU,EAAE,CAAC,GAAG,GAAG,CAAC,UAAU,EAAE,GAAG,SAAS,CAAC,EAAO,CAAC;QACnF,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC"}
+{"version":3,"file":"property-set-merge.js","sourceRoot":"","sources":["../src/property-set-merge.ts"],"names":[],"mappings":"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"}

package/dist/property-value-parser.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Property VALUE parsing for the on-demand STEP extraction path: decodes a
+ * single `IfcProperty` subtype entity (IfcPropertySingleValue,
+ * IfcPropertyEnumeratedValue, IfcPropertyBoundedValue, IfcPropertyListValue,
+ * IfcPropertyTableValue, IfcPropertyReferenceValue, IfcComplexProperty) into
+ * the `{ type, value, values?, dataType? }` shape the property panel/query
+ * layer consumes. Split out of on-demand-extractors.ts to stay under the
+ * module-size budget.
+ */
+import type { IfcEntity } from './types.js';
+import type { EntityExtractor } from './entity-extractor.js';
+import type { PropertyValue } from '@ifc-lite/data';
+import type { IfcDataStore } from './columnar-parser.js';
+/**
+ * Parse a property entity's value based on its IFC type.
+ * Handles all 6 IfcProperty subtypes:
+ * - IfcPropertySingleValue: direct value
+ * - IfcPropertyEnumeratedValue: list of enum values → joined string
+ * - IfcPropertyBoundedValue: upper/lower bounds → "value [min – max]"
+ * - IfcPropertyListValue: list of values → joined string
+ * - IfcPropertyTableValue: defining/defined value pairs → "Table(N rows)"
+ * - IfcPropertyReferenceValue: entity reference → "Reference #ID"
+ */
+export declare function parsePropertyValue(propEntity: IfcEntity): {
+    type: number;
+    value: PropertyValue;
+    values?: string[];
+    dataType?: string;
+};
+/** Extract a numeric value from a possibly typed STEP value. */
+export declare function extractNumericValue(attr: unknown): number | null;
+/**
+ * Resolve an `IfcComplexProperty`'s nested `HasProperties` (EXPRESS:
+ * `[Name, Description, UsageName, HasProperties]`, index 3) into a display
+ * value plus a flat `values` candidate list, recursing into any further
+ * nested `IfcComplexProperty`. Without this, {@link parsePropertyValue}'s
+ * default branch reads attribute index 2 as if it were a `NominalValue`,
+ * which for `IfcComplexProperty` is `UsageName` — a label, not a value — and
+ * every nested property silently vanishes from the panel/query output.
+ */
+export declare function resolveComplexPropertyValue(store: IfcDataStore, extractor: EntityExtractor, propEntity: IfcEntity, depth?: number): {
+    type: number;
+    value: PropertyValue;
+    values?: string[];
+    dataType?: string;
+};
+/** Dispatch a pset member to {@link resolveComplexPropertyValue} for
+ *  `IfcComplexProperty`, else the single-entity {@link parsePropertyValue}. */
+export declare function parsePropertyValueWithComplex(store: IfcDataStore, extractor: EntityExtractor, propEntity: IfcEntity): {
+    type: number;
+    value: PropertyValue;
+    values?: string[];
+    dataType?: string;
+};
+//# sourceMappingURL=property-value-parser.d.ts.map

package/dist/property-value-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"property-value-parser.d.ts","sourceRoot":"","sources":["../src/property-value-parser.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAMzD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,aAAa,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CA4LtI;AAED,gEAAgE;AAChE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAIhE;AAOD;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACvC,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,eAAe,EAC1B,UAAU,EAAE,SAAS,EACrB,KAAK,SAAI,GACV;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,aAAa,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAoC9E;AAED;+EAC+E;AAC/E,wBAAgB,6BAA6B,CACzC,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,eAAe,EAC1B,UAAU,EAAE,SAAS,GACtB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,aAAa,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAK9E"}

package/dist/property-value-parser.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/. */
+import { PropertyValueType } from '@ifc-lite/data';
+// ============================================================================
+// Property Value Parsing Helpers
+// ============================================================================
+/**
+ * Parse a property entity's value based on its IFC type.
+ * Handles all 6 IfcProperty subtypes:
+ * - IfcPropertySingleValue: direct value
+ * - IfcPropertyEnumeratedValue: list of enum values → joined string
+ * - IfcPropertyBoundedValue: upper/lower bounds → "value [min – max]"
+ * - IfcPropertyListValue: list of values → joined string
+ * - IfcPropertyTableValue: defining/defined value pairs → "Table(N rows)"
+ * - IfcPropertyReferenceValue: entity reference → "Reference #ID"
+ */
+export function parsePropertyValue(propEntity) {
+    const attrs = propEntity.attributes || [];
+    const typeUpper = propEntity.type.toUpperCase();
+    switch (typeUpper) {
+        case 'IFCPROPERTYENUMERATEDVALUE': {
+            // [Name, Description, EnumerationValues (list), EnumerationReference]
+            const enumValues = attrs[2];
+            if (Array.isArray(enumValues)) {
+                const values = enumValues.map(v => {
+                    if (Array.isArray(v) && v.length === 2)
+                        return String(v[1]); // Typed value
+                    return String(v);
+                }).filter(v => v !== 'null' && v !== 'undefined');
+                // Surface the raw value list separately so IDS facet
+                // checks can iterate "any matching value passes". The
+                // joined display string remains the primary `value`
+                // for visualisation/property-table consumers.
+                return { type: 0, value: values.join(', ') || null, values };
+            }
+            return { type: 0, value: null };
+        }
+        case 'IFCPROPERTYBOUNDEDVALUE': {
+            // [Name, Description, UpperBoundValue, LowerBoundValue, Unit, SetPointValue]
+            const upper = extractNumericValue(attrs[2]);
+            const lower = extractNumericValue(attrs[3]);
+            const setPoint = extractNumericValue(attrs[5]);
+            const displayValue = setPoint ?? upper ?? lower;
+            let display = displayValue != null ? String(displayValue) : '';
+            if (lower != null && upper != null) {
+                display += ` [${lower} – ${upper}]`;
+            }
+            // Surface every defined bound as a candidate value — IDS
+            // bounded-property checks pass when ANY of the bounds /
+            // setpoint matches the constraint, per upstream ifctester.
+            const candidates = [];
+            if (lower != null)
+                candidates.push(String(lower));
+            if (upper != null && upper !== lower)
+                candidates.push(String(upper));
+            if (setPoint != null && setPoint !== lower && setPoint !== upper) {
+                candidates.push(String(setPoint));
+            }
+            // Carry the IFC-declared measure tag so the IDS-side data
+            // type comparison and unit conversion both work.
+            const inferDataType = (attr) => {
+                if (Array.isArray(attr) && attr.length === 2) {
+                    return String(attr[0]).toUpperCase();
+                }
+                return undefined;
+            };
+            const dataType = inferDataType(attrs[5]) ||
+                inferDataType(attrs[2]) ||
+                inferDataType(attrs[3]);
+            return {
+                type: displayValue != null ? 1 : 0,
+                value: display || null,
+                ...(candidates.length > 0 ? { values: candidates } : {}),
+                ...(dataType ? { dataType } : {}),
+            };
+        }
+        case 'IFCPROPERTYLISTVALUE': {
+            // [Name, Description, ListValues (list), Unit]
+            const listValues = attrs[2];
+            if (Array.isArray(listValues)) {
+                const values = listValues.map(v => {
+                    if (Array.isArray(v) && v.length === 2)
+                        return String(v[1]);
+                    return String(v);
+                }).filter(v => v !== 'null' && v !== 'undefined');
+                return { type: 0, value: values.join(', ') || null, values };
+            }
+            return { type: 0, value: null };
+        }
+        case 'IFCPROPERTYTABLEVALUE': {
+            // [Name, Description, DefiningValues, DefinedValues, ...]
+            const definingValues = attrs[2];
+            const definedValues = attrs[3];
+            const rowCount = Array.isArray(definingValues) ? definingValues.length : 0;
+            if (rowCount > 0 && Array.isArray(definedValues) && Array.isArray(definingValues)) {
+                // Surface both defining and defined values as candidate
+                // matches — IDS table-value checks pass when ANY entry
+                // matches the constraint (per upstream ifctester).
+                const stringify = (v) => {
+                    if (Array.isArray(v) && v.length === 2)
+                        return String(v[1]);
+                    return String(v);
+                };
+                const values = [
+                    ...definingValues.map(stringify),
+                    ...definedValues.map(stringify),
+                ].filter(v => v !== 'null' && v !== 'undefined');
+                // Tables mix types per column (label / length / …),
+                // so we can't surface a single representative
+                // dataType. Leaving it unset lets the IDS check fall
+                // through to a pure value match against any of the
+                // candidates — which is what upstream ifctester does
+                // for table values.
+                return {
+                    type: 0,
+                    value: `Table (${rowCount} rows)`,
+                    values,
+                };
+            }
+            return { type: 0, value: null };
+        }
+        case 'IFCPROPERTYREFERENCEVALUE': {
+            // [Name, Description, PropertyReference]
+            const refValue = attrs[2];
+            if (typeof refValue === 'number') {
+                return { type: 0, value: `#${refValue}` };
+            }
+            return { type: 0, value: null };
+        }
+        default: {
+            // IfcPropertySingleValue and fallback: [Name, Description, NominalValue, Unit]
+            const nominalValue = attrs[2];
+            let type = PropertyValueType.String;
+            let value = nominalValue;
+            let dataType;
+            // Handle typed values like IFCBOOLEAN(.T.), IFCREAL(1.5)
+            if (Array.isArray(nominalValue) && nominalValue.length === 2) {
+                const innerValue = nominalValue[1];
+                const typeName = String(nominalValue[0]).toUpperCase();
+                dataType = typeName;
+                if (typeName.includes('BOOLEAN')) {
+                    type = PropertyValueType.Boolean;
+                    value = innerValue === '.T.' || innerValue === true;
+                }
+                else if (typeName.includes('LOGICAL')) {
+                    type = PropertyValueType.Logical;
+                    // Preserve .U. (unknown) as null; .T./.F. as boolean
+                    if (innerValue === '.U.' || innerValue === '.X.') {
+                        value = null;
+                    }
+                    else {
+                        value = innerValue === '.T.' || innerValue === true;
+                    }
+                }
+                else if (typeof innerValue === 'number') {
+                    // Preserve the IFC-declared numeric measure (IFCREAL,
+                    // IFCINTEGER, IFCLENGTHMEASURE, IFCAREAMEASURE, …) —
+                    // the source explicitly tagged the value, so don't
+                    // re-infer from JS number-ness (which would
+                    // misclassify e.g. `IFCREAL(0.0)` as integer).
+                    if (typeName === 'IFCINTEGER' || typeName === 'IFCCOUNTMEASURE') {
+                        type = PropertyValueType.Integer;
+                    }
+                    else if (typeName === 'IFCREAL' ||
+                        typeName.endsWith('MEASURE') ||
+                        typeName.endsWith('RATIO')) {
+                        type = PropertyValueType.Real;
+                    }
+                    else if (Number.isInteger(innerValue)) {
+                        type = PropertyValueType.Integer;
+                    }
+                    else {
+                        type = PropertyValueType.Real;
+                    }
+                    value = innerValue;
+                }
+                else {
+                    type = PropertyValueType.String;
+                    value = String(innerValue);
+                }
+            }
+            else if (typeof nominalValue === 'number') {
+                type = Number.isInteger(nominalValue) ? PropertyValueType.Integer : PropertyValueType.Real;
+            }
+            else if (typeof nominalValue === 'boolean') {
+                type = PropertyValueType.Boolean;
+            }
+            else if (nominalValue !== null && nominalValue !== undefined) {
+                // Normalize untagged STEP enumeration tokens. Conformant IFC wraps
+                // booleans as IFCBOOLEAN(.T.) (handled above), but some authoring
+                // tools emit the bare tokens directly in the NominalValue slot.
+                if (nominalValue === '.T.') {
+                    type = PropertyValueType.Boolean;
+                    value = true;
+                }
+                else if (nominalValue === '.F.') {
+                    type = PropertyValueType.Boolean;
+                    value = false;
+                }
+                else if (nominalValue === '.U.' || nominalValue === '.X.') {
+                    type = PropertyValueType.Logical;
+                    value = null;
+                }
+                else {
+                    value = String(nominalValue);
+                }
+            }
+            return { type, value, ...(dataType ? { dataType } : {}) };
+        }
+    }
+}
+/** Extract a numeric value from a possibly typed STEP value. */
+export function extractNumericValue(attr) {
+    if (typeof attr === 'number')
+        return attr;
+    if (Array.isArray(attr) && attr.length === 2 && typeof attr[1] === 'number')
+        return attr[1];
+    return null;
+}
+/** Guards {@link resolveComplexPropertyValue} against a pathological/cyclic
+ *  HasProperties chain; real IFC nests IfcComplexProperty at most a couple of
+ *  levels deep (e.g. Pset "sub-properties"). */
+const MAX_COMPLEX_PROPERTY_DEPTH = 8;
+/**
+ * Resolve an `IfcComplexProperty`'s nested `HasProperties` (EXPRESS:
+ * `[Name, Description, UsageName, HasProperties]`, index 3) into a display
+ * value plus a flat `values` candidate list, recursing into any further
+ * nested `IfcComplexProperty`. Without this, {@link parsePropertyValue}'s
+ * default branch reads attribute index 2 as if it were a `NominalValue`,
+ * which for `IfcComplexProperty` is `UsageName` — a label, not a value — and
+ * every nested property silently vanishes from the panel/query output.
+ */
+export function resolveComplexPropertyValue(store, extractor, propEntity, depth = 0) {
+    const attrs = propEntity.attributes || [];
+    const usageName = typeof attrs[2] === 'string' ? attrs[2] : '';
+    const hasProperties = attrs[3];
+    if (!Array.isArray(hasProperties) || depth >= MAX_COMPLEX_PROPERTY_DEPTH) {
+        return { type: PropertyValueType.String, value: usageName || null };
+    }
+    const parts = [];
+    const values = [];
+    for (const ref of hasProperties) {
+        if (typeof ref !== 'number')
+            continue;
+        const nestedRef = store.entityIndex.byId.get(ref) ?? store.deferredEntityIndex?.get(ref);
+        if (!nestedRef)
+            continue;
+        const nestedEntity = extractor.extractEntity(nestedRef);
+        if (!nestedEntity)
+            continue;
+        const nestedAttrs = nestedEntity.attributes || [];
+        const nestedName = typeof nestedAttrs[0] === 'string' ? nestedAttrs[0] : '';
+        const nestedParsed = nestedEntity.type.toUpperCase() === 'IFCCOMPLEXPROPERTY'
+            ? resolveComplexPropertyValue(store, extractor, nestedEntity, depth + 1)
+            : parsePropertyValue(nestedEntity);
+        const display = nestedParsed.value != null ? String(nestedParsed.value) : '';
+        if (!display)
+            continue;
+        parts.push(nestedName ? `${nestedName}: ${display}` : display);
+        values.push(display);
+    }
+    return {
+        type: PropertyValueType.String,
+        value: parts.length > 0 ? parts.join(', ') : (usageName || null),
+        ...(values.length > 0 ? { values } : {}),
+    };
+}
+/** Dispatch a pset member to {@link resolveComplexPropertyValue} for
+ *  `IfcComplexProperty`, else the single-entity {@link parsePropertyValue}. */
+export function parsePropertyValueWithComplex(store, extractor, propEntity) {
+    if (propEntity.type.toUpperCase() === 'IFCCOMPLEXPROPERTY') {
+        return resolveComplexPropertyValue(store, extractor, propEntity);
+    }
+    return parsePropertyValue(propEntity);
+}
+//# sourceMappingURL=property-value-parser.js.map

package/dist/property-value-parser.js.map

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

package/dist/quantity-collect.d.ts

@@ -1,10 +1,14 @@
 import type { EntityRef } from './types.js';
 import type { EntityExtractor } from './entity-extractor.js';
+import { type ProjectUnits } from './project-units.js';
 /** One extracted quantity, in the shape both call sites report. */
 export interface CollectedQuantity {
     name: string;
     type: number;
     value: number;
+    /** SI factor of this quantity's explicit `Unit`, when it declares one.
+     *  An omitted unit inherits the project's unit assignment. */
+    explicitUnitSiScale?: number;
 }
 /**
  * The part of `IfcDataStore` this walk needs, declared structurally so the
@@ -65,6 +69,8 @@ export declare function collectQuantitiesFromRefs(store: QuantityLookupStore, ex
 /** One extracted quantity set, in the shape both call sites report. */
 export interface CollectedQuantitySet {
     name: string;
+    /** `GlobalId` of the source `IfcElementQuantity` instance, when read as a string. */
+    globalId?: string;
     quantities: CollectedQuantity[];
 }
 /**
@@ -80,17 +86,50 @@ export interface CollectedQuantitySet {
  *
  * `SET [1:?]` admits no empty set, so a set that walks to zero quantities —
  * written empty, or filled only with members this reader cannot report, such as
- * an unresolvable reference or an `IfcPhysicalComplexQuantity` (#3254) — is
- * non-conformant data. Reporting it anyway would assert "this element has
+ * an unresolvable reference, an `IfcPhysicalComplexQuantity` (#3254), or a
+ * measure outside the IEEE-754 double range — is non-conformant data. Reporting it anyway would assert "this element has
  * quantities" on the strength of a name alone, and the consumers act on exactly
  * that: `validate` counts the element as quantified in its quantity-completeness
  * figure, an IDS quantity-set existence check passes, and the viewer's fallback
  * to the element's TYPE quantities is suppressed by the phantom occurrence set,
  * hiding the real numbers the type carries. So it is dropped (#3259).
  *
+ * That applies unchanged when every member was dropped for being
+ * unrepresentable: the set then vanishes rather than surviving empty. Keeping
+ * an empty shell would make exactly the claim #3259 removed — "this element is
+ * quantified" — while carrying no number to back it, and it would still
+ * suppress the type-quantity fallback. The reason each quantity went is on the
+ * console; the reason the set went is that nothing in it survived.
+ *
  * The instance path and the type path both go through here, so the drop cannot
  * come apart between them again: it used to be inlined at each site, and the
  * type site dropped while the instance site kept.
  */
-export declare function readQuantitySet(store: QuantityLookupStore, extractor: EntityExtractor, qsetRef: EntityRef, qsetId: number): CollectedQuantitySet | null;
+export declare function readQuantitySet(store: QuantityLookupStore, extractor: EntityExtractor, qsetRef: EntityRef): CollectedQuantitySet | null;
+/**
+ * SI scale factor for a `Qto_` value, preferring its explicit `Unit` and then
+ * resolving against the project's declared units.
+ *
+ * An `IfcQuantityLength`/`Area`/`Volume` is stored in the project's raw
+ * author unit exactly like an `IfcPropertySingleValue` of the matching
+ * measure type — the value is not pre-converted to SI by the exporter. A
+ * consumer that hashes or otherwise compares `CollectedQuantity.value`
+ * across two files (or against a base-SI literal) as-is therefore reads a
+ * project's choice of length unit as a change in the design itself: the
+ * same 2 m wall authored in millimetres carries the raw value `2000`
+ * instead of `2`.
+ *
+ * `1` for `Count`/`Weight`/`Time`/`Number` — this only scales the three
+ * quantity types that are themselves `IfcLengthMeasure`-family measures.
+ *
+ * Area and Volume scale by the SQUARE and CUBE of the length factor (a
+ * millimetre-authored 1 m² is stored as `1e6`, not `1e3`) — but only as a
+ * FALLBACK: `IFC` lets a project declare an explicit `AREAUNIT`/`VOLUMEUNIT`
+ * with no arithmetic relationship to `LENGTHUNIT`, so the file's own
+ * declaration is preferred and the length-derived power is used only when
+ * the project declares none. An explicit member `Unit` always wins; IFC uses
+ * it specifically to let a quantity depart from its containing project's
+ * assignment.
+ */
+export declare function quantitySiScale(quantity: CollectedQuantity, units: ProjectUnits): number;
 //# sourceMappingURL=quantity-collect.d.ts.map

package/dist/quantity-collect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"quantity-collect.d.ts","sourceRoot":"","sources":["../src/quantity-collect.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAG7D,mEAAmE;AACnE,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAChC,WAAW,EAAE;QAAE,IAAI,EAAE;YAAE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAA;SAAE,CAAA;KAAE,CAAC;IAClE,mBAAmB,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAA;KAAE,CAAC;CACpE;AA2BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,yBAAyB,CACrC,KAAK,EAAE,mBAAmB,EAC1B,SAAS,EAAE,eAAe,EAC1B,IAAI,EAAE,OAAO,GACd,iBAAiB,EAAE,CA4BrB;AASD,uEAAuE;AACvE,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,iBAAiB,EAAE,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,eAAe,CAC3B,KAAK,EAAE,mBAAmB,EAC1B,SAAS,EAAE,eAAe,EAC1B,OAAO,EAAE,SAAS,EAClB,MAAM,EAAE,MAAM,GACf,oBAAoB,GAAG,IAAI,CAU7B"}
+{"version":3,"file":"quantity-collect.d.ts","sourceRoot":"","sources":["../src/quantity-collect.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAG7D,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEzE,mEAAmE;AACnE,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd;kEAC8D;IAC9D,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAChC,WAAW,EAAE;QAAE,IAAI,EAAE;YAAE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAA;SAAE,CAAA;KAAE,CAAC;IAClE,mBAAmB,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAA;KAAE,CAAC;CACpE;AA2BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,yBAAyB,CACrC,KAAK,EAAE,mBAAmB,EAC1B,SAAS,EAAE,eAAe,EAC1B,IAAI,EAAE,OAAO,GACd,iBAAiB,EAAE,CA2ErB;AAUD,uEAAuE;AACvE,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,qFAAqF;IACrF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,iBAAiB,EAAE,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,eAAe,CAC3B,KAAK,EAAE,mBAAmB,EAC1B,SAAS,EAAE,eAAe,EAC1B,OAAO,EAAE,SAAS,GACnB,oBAAoB,GAAG,IAAI,CAe7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,iBAAiB,EAAE,KAAK,EAAE,YAAY,GAAG,MAAM,CAqBxF"}