@ifc-lite/parser 6.4.0 → 7.0.0

package/README.md

@@ -107,6 +107,27 @@ if (georef?.hasGeoreference) {
 }
 ```
 
+## Read cost data
+
+```typescript
+import { evaluateCostItem, extractCostOnDemand } from '@ifc-lite/parser';
+
+const cost = extractCostOnDemand(store);
+const result = evaluateCostItem(cost, cost.CostItems[0].expressId);
+console.log(result.Amount, result.Currency, result.Diagnostics);
+```
+
+The read model preserves ordered `CostValues`, direct `CostQuantities`, shared
+references, and the original `IfcRelNests`/assignment relationship endpoints.
+Rates use only `IfcCostItem.CostQuantities`; product Qto values are never used as
+an implicit fallback. Direct quantities make the item's values unit costs even
+when `UnitBasis` is absent. IFC4 and IFC4X3 support exact-decimal arithmetic,
+currencies, compatible `UnitBasis` conversion, and named or `*` nested-category
+totals. Invalid quantities or incompatible dimensions produce diagnostics and
+withhold the total instead of returning a partial result. IFC2X3 cost metadata and legacy
+relationships remain inspectable, with an explicit partial-read diagnostic;
+IFC2X3 evaluation is intentionally unsupported.
+
 ## Performance
 
 | Model size | Parse time |

package/dist/cost-category-buckets.d.ts

@@ -0,0 +1,5 @@
+import { combineCosts, type EvaluatedCost } from './cost-evaluation-arithmetic.js';
+import { type ValueEvaluationSession } from './cost-value-evaluation-session.js';
+export declare function appendCategoryValues(target: Map<string, EvaluatedCost[]>, category: string, values: readonly EvaluatedCost[], session: ValueEvaluationSession, onExhausted: () => void): boolean;
+export declare function combineCategoryValues(category: string, totals: ReadonlyMap<string, readonly EvaluatedCost[]> | undefined, valueId: number, session: ValueEvaluationSession, onExhausted: () => void, onDiagnostic: Parameters<typeof combineCosts>[3]): EvaluatedCost;
+//# sourceMappingURL=cost-category-buckets.d.ts.map

package/dist/cost-category-buckets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-category-buckets.d.ts","sourceRoot":"","sources":["../src/cost-category-buckets.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,iCAAiC,CAAC;AACnF,OAAO,EACuB,KAAK,sBAAsB,EACxD,MAAM,oCAAoC,CAAC;AAE5C,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,aAAa,EAAE,EACxF,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,IAAI,GACvD,OAAO,CAYT;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,EACpG,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,IAAI,EACxD,YAAY,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC,GAC/C,aAAa,CAaf"}

package/dist/cost-category-buckets.js

@@ -0,0 +1,37 @@
+/* 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 { combineCosts } from './cost-evaluation-arithmetic.js';
+import { consumeValueEvaluationWork, } from './cost-value-evaluation-session.js';
+export function appendCategoryValues(target, category, values, session, onExhausted) {
+    const bucket = target.get(category) ?? [];
+    if (!target.has(category))
+        target.set(category, bucket);
+    for (const value of values) {
+        const wasExhausted = session.exhausted;
+        if (!consumeValueEvaluationWork(session)) {
+            if (!wasExhausted)
+                onExhausted();
+            return false;
+        }
+        bucket.push(value);
+    }
+    return true;
+}
+export function combineCategoryValues(category, totals, valueId, session, onExhausted, onDiagnostic) {
+    const cached = session.categoryMemo.get(category);
+    if (cached)
+        return cached;
+    const categorized = totals?.get(category) ?? [];
+    const uncategorized = category === '*' ? [] : totals?.get('') ?? [];
+    const wasExhausted = session.exhausted;
+    if (!consumeValueEvaluationWork(session, categorized.length + uncategorized.length)) {
+        if (!wasExhausted)
+            onExhausted();
+        return { invalid: true };
+    }
+    const evaluated = combineCosts('ADD', [...categorized, ...uncategorized], valueId, onDiagnostic);
+    session.categoryMemo.set(category, evaluated);
+    return evaluated;
+}
+//# sourceMappingURL=cost-category-buckets.js.map

package/dist/cost-category-buckets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-category-buckets.js","sourceRoot":"","sources":["../src/cost-category-buckets.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D,OAAO,EAAE,YAAY,EAAsB,MAAM,iCAAiC,CAAC;AACnF,OAAO,EACL,0BAA0B,GAC3B,MAAM,oCAAoC,CAAC;AAE5C,MAAM,UAAU,oBAAoB,CAClC,MAAoC,EAAE,QAAgB,EAAE,MAAgC,EACxF,OAA+B,EAAE,WAAuB;IAExD,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC1C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACxD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC;QACvC,IAAI,CAAC,0BAA0B,CAAC,OAAO,CAAC,EAAE,CAAC;YACzC,IAAI,CAAC,YAAY;gBAAE,WAAW,EAAE,CAAC;YACjC,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,QAAgB,EAAE,MAAiE,EAAE,OAAe,EACpG,OAA+B,EAAE,WAAuB,EACxD,YAAgD;IAEhD,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAClD,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,MAAM,WAAW,GAAG,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAChD,MAAM,aAAa,GAAG,QAAQ,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;IACpE,MAAM,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC;IACvC,IAAI,CAAC,0BAA0B,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QACpF,IAAI,CAAC,YAAY;YAAE,WAAW,EAAE,CAAC;QACjC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IACD,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,EAAE,CAAC,GAAG,WAAW,EAAE,GAAG,aAAa,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;IACjG,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC9C,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/cost-compatibility-tree.d.ts

@@ -0,0 +1,4 @@
+import type { CostDiagnostic, CostValueInfo } from './cost-types.js';
+/** Build bounded legacy nested value views while canonical Components stay intact. */
+export declare function compatibilityTreeBuilder(values: Map<number | undefined, CostValueInfo>, diagnostics: CostDiagnostic[]): (root: number) => CostValueInfo[] | undefined;
+//# sourceMappingURL=cost-compatibility-tree.d.ts.map

package/dist/cost-compatibility-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-compatibility-tree.d.ts","sourceRoot":"","sources":["../src/cost-compatibility-tree.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAIrE,sFAAsF;AACtF,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,SAAS,EAAE,aAAa,CAAC,EAC9C,WAAW,EAAE,cAAc,EAAE,GAC5B,CAAC,IAAI,EAAE,MAAM,KAAK,aAAa,EAAE,GAAG,SAAS,CAmC/C"}

package/dist/cost-compatibility-tree.js

@@ -0,0 +1,46 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+const COMPONENT_BUDGET = 100_000;
+/** Build bounded legacy nested value views while canonical Components stay intact. */
+export function compatibilityTreeBuilder(values, diagnostics) {
+    let remaining = COMPONENT_BUDGET;
+    let budgetReported = false;
+    const reportBudget = (expressId) => {
+        if (budgetReported)
+            return;
+        budgetReported = true;
+        diagnostics.push({
+            Code: 'INVALID_LIST',
+            Message: `Compatibility IfcAppliedValue trees exceed the shared ${COMPONENT_BUDGET}-component budget`,
+            Severity: 'warning', expressId,
+        });
+    };
+    const build = (root, depth = 0, visiting = new Set()) => {
+        if (depth > 20 || visiting.has(root))
+            return undefined;
+        const source = values.get(root);
+        if (!source)
+            return undefined;
+        visiting.add(root);
+        const components = [];
+        for (const id of source.Components ?? []) {
+            if (remaining <= 0) {
+                reportBudget(root);
+                break;
+            }
+            remaining--;
+            const child = values.get(id);
+            if (!child || visiting.has(id))
+                continue;
+            const { components: omitted, ...copy } = child;
+            void omitted;
+            const nested = build(id, depth + 1, visiting);
+            components.push({ ...copy, ...(nested?.length ? { components: nested } : {}) });
+        }
+        visiting.delete(root);
+        return components.length ? components : undefined;
+    };
+    return build;
+}
+//# sourceMappingURL=cost-compatibility-tree.js.map

package/dist/cost-compatibility-tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-compatibility-tree.js","sourceRoot":"","sources":["../src/cost-compatibility-tree.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAI/D,MAAM,gBAAgB,GAAG,OAAO,CAAC;AAEjC,sFAAsF;AACtF,MAAM,UAAU,wBAAwB,CACtC,MAA8C,EAC9C,WAA6B;IAE7B,IAAI,SAAS,GAAG,gBAAgB,CAAC;IACjC,IAAI,cAAc,GAAG,KAAK,CAAC;IAC3B,MAAM,YAAY,GAAG,CAAC,SAAiB,EAAQ,EAAE;QAC/C,IAAI,cAAc;YAAE,OAAO;QAC3B,cAAc,GAAG,IAAI,CAAC;QACtB,WAAW,CAAC,IAAI,CAAC;YACf,IAAI,EAAE,cAAc;YACpB,OAAO,EAAE,yDAAyD,gBAAgB,mBAAmB;YACrG,QAAQ,EAAE,SAAS,EAAE,SAAS;SAC/B,CAAC,CAAC;IACL,CAAC,CAAC;IACF,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,KAAK,GAAG,CAAC,EAAE,WAAW,IAAI,GAAG,EAAU,EAA+B,EAAE;QACnG,IAAI,KAAK,GAAG,EAAE,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,SAAS,CAAC;QACvD,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QAC9B,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnB,MAAM,UAAU,GAAoB,EAAE,CAAC;QACvC,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,UAAU,IAAI,EAAE,EAAE,CAAC;YACzC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;gBACnB,YAAY,CAAC,IAAI,CAAC,CAAC;gBACnB,MAAM;YACR,CAAC;YACD,SAAS,EAAE,CAAC;YACZ,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC7B,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,SAAS;YACzC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;YAC/C,KAAK,OAAO,CAAC;YACb,MAAM,MAAM,GAAG,KAAK,CAAC,EAAE,EAAE,KAAK,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;YAC9C,UAAU,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAClF,CAAC;QACD,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACtB,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;IACpD,CAAC,CAAC;IACF,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/cost-evaluation-arithmetic.d.ts

@@ -0,0 +1,16 @@
+import type { Decimal } from 'decimal.js';
+import type { CostDiagnostic, CostQuantityDimension } from './cost-types.js';
+export interface EvaluatedCost {
+    amount?: Decimal;
+    currency?: string;
+    dimension?: CostQuantityDimension | 'ratio';
+    rateDimension?: CostQuantityDimension;
+    quantityApplied?: Decimal;
+    /** Distinguishes currency-less monetary values from dimensionless ratios. */
+    monetary?: boolean;
+    invalid?: boolean;
+}
+export type CostDiagnosticSink = (Code: CostDiagnostic['Code'], Message: string, expressId: number, Severity?: CostDiagnostic['Severity']) => void;
+export type ImplicitRateNormalizer = (operand: EvaluatedCost, dimension: CostQuantityDimension) => EvaluatedCost;
+export declare function combineCosts(operator: string, operands: EvaluatedCost[], valueId: number, report: CostDiagnosticSink, normalizeImplicitRate?: ImplicitRateNormalizer): EvaluatedCost;
+//# sourceMappingURL=cost-evaluation-arithmetic.d.ts.map

package/dist/cost-evaluation-arithmetic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-evaluation-arithmetic.d.ts","sourceRoot":"","sources":["../src/cost-evaluation-arithmetic.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAE7E,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC;IAC5C,aAAa,CAAC,EAAE,qBAAqB,CAAC;IACtC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,kBAAkB,GAAG,CAC/B,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAChE,QAAQ,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,KAClC,IAAI,CAAC;AAEV,MAAM,MAAM,sBAAsB,GAAG,CACnC,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,qBAAqB,KACrD,aAAa,CAAC;AAyFnB,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,EACxF,qBAAqB,CAAC,EAAE,sBAAsB,GAC7C,aAAa,CA0Ff"}

package/dist/cost-evaluation-arithmetic.js

@@ -0,0 +1,181 @@
+/* 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/. */
+function sameIdentity(left, right) {
+    return left.currency === right.currency && left.dimension === right.dimension &&
+        left.rateDimension === right.rateDimension;
+}
+function finite(result, valueId, report) {
+    if (result.amount?.isFinite())
+        return result;
+    report('INVALID_NUMBER', `IfcCostValue #${valueId} produced a non-finite decimal`, valueId);
+    return { invalid: true };
+}
+function combinedRateDimension(operands, valueId, report) {
+    const dimensions = new Set(operands.map(entry => entry.rateDimension).filter(entry => entry !== undefined));
+    if (dimensions.size <= 1)
+        return dimensions.values().next().value;
+    report('INCOMPATIBLE_UNIT', 'Cannot combine cost rates with different quantity dimensions', valueId);
+    return false;
+}
+function multiplicationDimensions(operands, valueId, report) {
+    let moneyExponent = 0;
+    const dimensions = new Map();
+    operands.forEach((operand) => {
+        const sign = 1;
+        if (operand.monetary || operand.currency !== undefined)
+            moneyExponent += sign;
+        else if (operand.dimension !== undefined && operand.dimension !== 'ratio') {
+            dimensions.set(operand.dimension, (dimensions.get(operand.dimension) ?? 0) + sign);
+        }
+        if (operand.rateDimension !== undefined) {
+            dimensions.set(operand.rateDimension, (dimensions.get(operand.rateDimension) ?? 0) - sign);
+        }
+    });
+    const nonzero = [...dimensions].filter(([, exponent]) => exponent !== 0);
+    const scalar = moneyExponent === 0 && nonzero.length === 0;
+    const quantity = moneyExponent === 0 && nonzero.length === 1 && nonzero[0][1] === 1;
+    const money = moneyExponent === 1 && nonzero.length === 0;
+    const rate = moneyExponent === 1 && nonzero.length === 1 && nonzero[0][1] === -1;
+    if (scalar)
+        return { dimension: 'ratio', monetary: false };
+    if (quantity)
+        return { dimension: nonzero[0][0], monetary: false };
+    if (money)
+        return {
+            currency: operands.find(entry => entry.monetary || entry.currency !== undefined)?.currency,
+            monetary: true,
+        };
+    if (rate)
+        return {
+            currency: operands.find(entry => entry.monetary || entry.currency !== undefined)?.currency,
+            rateDimension: nonzero[0][0], monetary: true,
+        };
+    report('INCOMPATIBLE_UNIT', 'Multiplication produces an unsupported compound dimension', valueId);
+    return false;
+}
+function divisionDimensions(operands, valueId, report) {
+    const currencies = new Set(operands.map(operand => operand.currency).filter((entry) => entry !== undefined));
+    if (currencies.size > 1) {
+        report('MIXED_CURRENCY', 'Division cannot combine different currencies', valueId);
+        return false;
+    }
+    const signed = operands.map((operand, index) => ({ operand, sign: index === 0 ? 1 : -1 }));
+    let moneyExponent = 0;
+    const dimensions = new Map();
+    for (const { operand, sign } of signed) {
+        if (operand.monetary || operand.currency !== undefined)
+            moneyExponent += sign;
+        else if (operand.dimension !== undefined && operand.dimension !== 'ratio') {
+            dimensions.set(operand.dimension, (dimensions.get(operand.dimension) ?? 0) + sign);
+        }
+        if (operand.rateDimension !== undefined) {
+            dimensions.set(operand.rateDimension, (dimensions.get(operand.rateDimension) ?? 0) - sign);
+        }
+    }
+    const nonzero = [...dimensions].filter(([, exponent]) => exponent !== 0);
+    if (moneyExponent === 0 && nonzero.length === 0)
+        return { dimension: 'ratio', monetary: false };
+    if (moneyExponent === 0 && nonzero.length === 1 && nonzero[0][1] === 1) {
+        return { dimension: nonzero[0][0], monetary: false };
+    }
+    if (moneyExponent === 1 && nonzero.length === 0)
+        return { currency: operands[0].currency, monetary: true };
+    if (moneyExponent === 1 && nonzero.length === 1 && nonzero[0][1] === -1) {
+        return { currency: operands[0].currency, rateDimension: nonzero[0][0], monetary: true };
+    }
+    report('INCOMPATIBLE_UNIT', 'Division produces an unsupported inverse or compound dimension', valueId);
+    return false;
+}
+export function combineCosts(operator, operands, valueId, report, normalizeImplicitRate) {
+    if (operands.length === 0) {
+        report('MISSING_VALUE', `IfcCostValue #${valueId} has no arithmetic operands`, valueId);
+        return { invalid: true };
+    }
+    if (operands.some(entry => entry.invalid || entry.amount === undefined)) {
+        report('MISSING_VALUE', `IfcCostValue #${valueId} depends on an invalid arithmetic operand`, valueId);
+        return { invalid: true };
+    }
+    const amounts = operands.map(entry => entry.amount);
+    if (operator === 'ADD' || operator === 'SUBTRACT') {
+        const explicitRateDimensions = new Set(operands.map(entry => entry.rateDimension).filter(entry => entry !== undefined));
+        if (explicitRateDimensions.size === 1 && normalizeImplicitRate) {
+            const dimension = explicitRateDimensions.values().next().value;
+            operands = operands.map(entry => entry.rateDimension === undefined && entry.currency !== undefined
+                ? normalizeImplicitRate(entry, dimension)
+                : entry);
+            if (operands.some(entry => entry.invalid || entry.amount === undefined))
+                return { invalid: true };
+        }
+        if (operands.slice(1).some(entry => !sameIdentity(operands[0], entry))) {
+            const currencies = new Set(operands.map(entry => entry.currency).filter(Boolean));
+            report(currencies.size > 1 ? 'MIXED_CURRENCY' : 'INCOMPATIBLE_UNIT', `Cannot ${operator.toLowerCase()} values with different units`, valueId);
+            return { invalid: true };
+        }
+        const rateDimension = combinedRateDimension(operands, valueId, report);
+        if (rateDimension === false)
+            return { invalid: true };
+        const normalizedAmounts = operands.map(entry => entry.amount);
+        let amount = normalizedAmounts[0];
+        for (const next of normalizedAmounts.slice(1)) {
+            const combined = operator === 'ADD' ? amount.plus(next) : amount.minus(next);
+            const exactlyZero = operator === 'ADD' ? amount.eq(next.negated()) : amount.eq(next);
+            if (combined.isZero() && !exactlyZero) {
+                report('INVALID_NUMBER', `IfcCostValue #${valueId} underflowed during ${operator.toLowerCase()}`, valueId);
+                return { invalid: true };
+            }
+            amount = combined;
+        }
+        return finite({
+            amount, currency: operands[0].currency, dimension: operands[0].dimension,
+            rateDimension, monetary: operands[0].monetary,
+            quantityApplied: operands.find(entry => entry.quantityApplied)?.quantityApplied,
+        }, valueId, report);
+    }
+    if (operator === 'MULTIPLY') {
+        const identity = multiplicationDimensions(operands, valueId, report);
+        if (!identity) {
+            return { invalid: true };
+        }
+        let amount = amounts[0];
+        for (const next of amounts.slice(1)) {
+            const multiplied = amount.mul(next);
+            if (multiplied.isZero() && !amount.isZero() && !next.isZero()) {
+                report('INVALID_NUMBER', `IfcCostValue #${valueId} underflowed during multiplication`, valueId);
+                return { invalid: true };
+            }
+            amount = multiplied;
+        }
+        return finite({
+            amount, ...identity,
+            quantityApplied: operands.find(entry => entry.quantityApplied)?.quantityApplied,
+        }, valueId, report);
+    }
+    if (operator === 'DIVIDE') {
+        for (const divisor of amounts.slice(1)) {
+            if (divisor.isZero()) {
+                report('DIVISION_BY_ZERO', `IfcCostValue #${valueId} divides by zero`, valueId);
+                return { invalid: true };
+            }
+        }
+        const dimensions = divisionDimensions(operands, valueId, report);
+        if (dimensions === false)
+            return { invalid: true };
+        let amount = amounts[0];
+        for (const next of amounts.slice(1)) {
+            const divided = amount.div(next);
+            if (divided.isZero() && !amount.isZero()) {
+                report('INVALID_NUMBER', `IfcCostValue #${valueId} underflowed during division`, valueId);
+                return { invalid: true };
+            }
+            amount = divided;
+        }
+        return finite({
+            amount, ...dimensions,
+            quantityApplied: operands.find(entry => entry.quantityApplied)?.quantityApplied,
+        }, valueId, report);
+    }
+    report('UNSUPPORTED_APPLIED_VALUE', `Arithmetic operator ${operator || '(missing)'} is not supported`, valueId);
+    return { invalid: true };
+}
+//# sourceMappingURL=cost-evaluation-arithmetic.js.map

package/dist/cost-evaluation-arithmetic.js.map

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

package/dist/cost-evaluation-context.d.ts

@@ -0,0 +1,20 @@
+import { Decimal } from 'decimal.js';
+import { type QuantityEvaluationCache } from './cost-quantity-evaluator.js';
+import type { CostDiagnostic, CostEvaluationOptions, CostGraphExtraction, CostMeasureWithUnitInfo, CostQuantityDimension, CostQuantityInfo, CostUnitInfo, CostValueInfo } from './cost-types.js';
+export interface CostEvaluationContext {
+    DecimalValue: Decimal.Constructor;
+    extraction: CostGraphExtraction;
+    values: Map<number, CostValueInfo>;
+    quantities: Map<number, CostQuantityInfo>;
+    units: Map<number, CostUnitInfo>;
+    measures: Map<number, CostMeasureWithUnitInfo>;
+    mixedProjectCurrency: boolean;
+    quantityCache: QuantityEvaluationCache;
+    diagnostics: CostDiagnostic[];
+    invalidOptions: boolean;
+}
+export declare function diagnostic(context: CostEvaluationContext, Code: CostDiagnostic['Code'], Message: string, expressId: number, Severity?: CostDiagnostic['Severity']): void;
+export declare function decimal(value: string, expressId: number, context: CostEvaluationContext): Decimal | undefined;
+export declare function projectUnit(dimension: CostQuantityDimension, context: CostEvaluationContext): CostUnitInfo | undefined;
+export declare function createContext(extraction: CostGraphExtraction, options?: CostEvaluationOptions): CostEvaluationContext;
+//# sourceMappingURL=cost-evaluation-context.d.ts.map

package/dist/cost-evaluation-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-evaluation-context.d.ts","sourceRoot":"","sources":["../src/cost-evaluation-context.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAA2B,KAAK,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAErG,OAAO,KAAK,EACV,cAAc,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,uBAAuB,EACnF,qBAAqB,EAAE,gBAAgB,EAAE,YAAY,EAAE,aAAa,EACrE,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,OAAO,CAAC,WAAW,CAAC;IAClC,UAAU,EAAE,mBAAmB,CAAC;IAChC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACnC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC1C,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACjC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;IAC/C,oBAAoB,EAAE,OAAO,CAAC;IAC9B,aAAa,EAAE,uBAAuB,CAAC;IACvC,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,qBAAqB,EAAE,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,EACtG,SAAS,EAAE,MAAM,EAAE,QAAQ,GAAE,cAAc,CAAC,UAAU,CAAW,GAAG,IAAI,CAEzE;AAED,wBAAgB,OAAO,CACrB,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAC/D,OAAO,GAAG,SAAS,CAUrB;AAED,wBAAgB,WAAW,CACzB,SAAS,EAAE,qBAAqB,EAAE,OAAO,EAAE,qBAAqB,GAC/D,YAAY,GAAG,SAAS,CAG1B;AAED,wBAAgB,aAAa,CAC3B,UAAU,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAC/D,qBAAqB,CAwBvB"}

package/dist/cost-evaluation-context.js

@@ -0,0 +1,54 @@
+/* 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 { Decimal } from 'decimal.js';
+import { quantityEvaluationCache } from './cost-quantity-evaluator.js';
+import { isZeroCostNumericLexeme } from './cost-step-lexemes.js';
+export function diagnostic(context, Code, Message, expressId, Severity = 'error') {
+    context.diagnostics.push({ Code, Message, Severity, expressId });
+}
+export function decimal(value, expressId, context) {
+    try {
+        const parsed = new context.DecimalValue(value);
+        if (parsed.isFinite() && !(parsed.isZero() && !isZeroCostNumericLexeme(value)))
+            return parsed;
+    }
+    catch (error) {
+        diagnostic(context, 'INVALID_NUMBER', `#${expressId} contains an invalid decimal: ${String(error)}`, expressId);
+        return undefined;
+    }
+    diagnostic(context, 'INVALID_NUMBER', `#${expressId} contains a non-finite or underflowed decimal`, expressId);
+    return undefined;
+}
+export function projectUnit(dimension, context) {
+    const id = context.extraction.ProjectUnits[dimension];
+    return id === undefined ? undefined : context.units.get(id);
+}
+export function createContext(extraction, options) {
+    const maximumPrecision = 10_000;
+    const requestedPrecision = options?.Precision;
+    const invalidOptions = requestedPrecision !== undefined &&
+        (!Number.isInteger(requestedPrecision) || requestedPrecision < 1 || requestedPrecision > maximumPrecision);
+    const diagnostics = invalidOptions ? [{
+            Code: 'INVALID_NUMBER',
+            Message: `Cost evaluation Precision must be an integer from 1 through ${maximumPrecision}; received ${String(requestedPrecision)}`,
+            Severity: 'error',
+        }] : [];
+    const DecimalValue = Decimal.clone({
+        precision: invalidOptions ? 34 : requestedPrecision ?? 34,
+        rounding: Decimal.ROUND_HALF_EVEN, maxE: 6144, minE: -6144,
+    });
+    const values = new Map();
+    for (const value of extraction.CostValues)
+        if (value.expressId !== undefined)
+            values.set(value.expressId, value);
+    return {
+        DecimalValue, extraction, values,
+        quantities: new Map(extraction.CostQuantities.map(value => [value.expressId, value])),
+        units: new Map(extraction.Units.map(value => [value.expressId, value])),
+        measures: new Map(extraction.MeasuresWithUnit.map(value => [value.expressId, value])),
+        mixedProjectCurrency: extraction.Diagnostics.some(entry => entry.Code === 'MIXED_CURRENCY'),
+        quantityCache: quantityEvaluationCache(), diagnostics, invalidOptions,
+    };
+}
+//# sourceMappingURL=cost-evaluation-context.js.map

package/dist/cost-evaluation-context.js.map

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

package/dist/cost-evaluation-result.d.ts

@@ -0,0 +1,5 @@
+import type { EvaluatedCost } from './cost-evaluation-arithmetic.js';
+import type { CostDiagnostic, CostEvaluationResult, CostGraphExtraction } from './cost-types.js';
+export declare function unsupportedCostEvaluation(extraction: CostGraphExtraction, expressId: number): CostEvaluationResult | undefined;
+export declare function costEvaluationResult(expressId: number, value: EvaluatedCost, diagnostics: CostDiagnostic[]): CostEvaluationResult;
+//# sourceMappingURL=cost-evaluation-result.d.ts.map

package/dist/cost-evaluation-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-evaluation-result.d.ts","sourceRoot":"","sources":["../src/cost-evaluation-result.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEjG,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,GACjD,oBAAoB,GAAG,SAAS,CAOlC;AAED,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,GACrE,oBAAoB,CAMtB"}

package/dist/cost-evaluation-result.js

@@ -0,0 +1,20 @@
+/* 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/. */
+export function unsupportedCostEvaluation(extraction, expressId) {
+    if (extraction.SchemaVersion !== 'IFC2X3' && extraction.SchemaVersion !== 'IFC5')
+        return undefined;
+    return { expressId, Diagnostics: [{
+                Code: extraction.SchemaVersion === 'IFC2X3' ? 'IFC2X3_PARTIAL_READ' : 'UNSUPPORTED_SCHEMA',
+                Message: `${extraction.SchemaVersion} cost values are preserved for inspection but not evaluated`,
+                Severity: 'warning', expressId,
+            }] };
+}
+export function costEvaluationResult(expressId, value, diagnostics) {
+    return {
+        expressId, Amount: value.invalid ? undefined : value.amount?.toString(), Currency: value.currency,
+        Dimension: value.rateDimension ?? value.dimension, QuantityApplied: value.quantityApplied?.toString(),
+        Diagnostics: diagnostics,
+    };
+}
+//# sourceMappingURL=cost-evaluation-result.js.map

package/dist/cost-evaluation-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-evaluation-result.js","sourceRoot":"","sources":["../src/cost-evaluation-result.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAK/D,MAAM,UAAU,yBAAyB,CACvC,UAA+B,EAAE,SAAiB;IAElD,IAAI,UAAU,CAAC,aAAa,KAAK,QAAQ,IAAI,UAAU,CAAC,aAAa,KAAK,MAAM;QAAE,OAAO,SAAS,CAAC;IACnG,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;gBAChC,IAAI,EAAE,UAAU,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,oBAAoB;gBAC1F,OAAO,EAAE,GAAG,UAAU,CAAC,aAAa,6DAA6D;gBACjG,QAAQ,EAAE,SAAS,EAAE,SAAS;aAC/B,CAAC,EAAE,CAAC;AACP,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,SAAiB,EAAE,KAAoB,EAAE,WAA6B;IAEtE,OAAO;QACL,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACjG,SAAS,EAAE,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC,SAAS,EAAE,eAAe,EAAE,KAAK,CAAC,eAAe,EAAE,QAAQ,EAAE;QACrG,WAAW,EAAE,WAAW;KACzB,CAAC;AACJ,CAAC"}

package/dist/cost-evaluator.d.ts

@@ -0,0 +1,6 @@
+import type { CostEvaluationOptions, CostEvaluationResult, CostGraphExtraction } from './cost-types.js';
+/** Evaluate one IFC4/IFC4X3 applied-value expression using decimal arithmetic. */
+export declare function evaluateCostValue(extraction: CostGraphExtraction, expressId: number, options?: CostEvaluationOptions): CostEvaluationResult;
+/** Evaluate a cost item, including IFC category-based totals of nested cost items. */
+export declare function evaluateCostItem(extraction: CostGraphExtraction, expressId: number, options?: CostEvaluationOptions): CostEvaluationResult;
+//# sourceMappingURL=cost-evaluator.d.ts.map

package/dist/cost-evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-evaluator.d.ts","sourceRoot":"","sources":["../src/cost-evaluator.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,mBAAmB,EACtC,MAAM,iBAAiB,CAAC;AAuOhE,kFAAkF;AAClF,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,EAClF,OAAO,CAAC,EAAE,qBAAqB,GAAG,oBAAoB,CAMvD;AAED,sFAAsF;AACtF,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,EACjF,OAAO,CAAC,EAAE,qBAAqB,GAAG,oBAAoB,CAqIvD"}