@ifc-lite/create 2.5.0 → 2.7.0

package/dist/in-store/cost-reference-validation.js

@@ -0,0 +1,49 @@
+/* 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 { getInheritanceChainAcrossSchemas } from '@ifc-lite/parser';
+import { requireCostSchema } from '../cost-authoring-rules.js';
+/** Validate the caller's anchor against the schema of the loaded store. */
+export function requireMatchingCostSchema(editor, declaredSchema) {
+    const declared = requireCostSchema(declaredSchema);
+    const loaded = requireCostSchema(editor.getSchemaVersion());
+    if (declared !== loaded) {
+        throw new Error(`CostAnchor.schema ${declared} does not match the loaded model schema ${loaded}`);
+    }
+    return loaded;
+}
+/** Require a live entity of one exact IFC class. */
+export function requireEntityType(editor, id, expectedType, attribute, context) {
+    const actual = editor.getEntityType(id);
+    if (actual === undefined)
+        throw new Error(`${context}: ${attribute} #${id} does not exist in this model`);
+    if (actual.toUpperCase() !== expectedType.toUpperCase()) {
+        throw new Error(`${context}: ${attribute} #${id} must be an ${expectedType}, got ${actual}`);
+    }
+}
+/** Require a live entity whose exact class belongs to `allowedTypes`. */
+export function requireEntityTypeOneOf(editor, id, allowedTypes, attribute, context) {
+    const actual = editor.getEntityType(id);
+    if (actual === undefined)
+        throw new Error(`${context}: ${attribute} #${id} does not exist in this model`);
+    if (!allowedTypes.has(actual.toUpperCase())) {
+        throw new Error(`${context}: ${attribute} #${id} must be one of ${[...allowedTypes].join(', ')}, got ${actual}`);
+    }
+}
+/** Require a live entity that descends from one IFC schema supertype. */
+export function requireEntitySubtype(editor, id, supertype, attribute, context) {
+    const actual = editor.getEntityType(id);
+    if (actual === undefined)
+        throw new Error(`${context}: ${attribute} #${id} does not exist in this model`);
+    if (!getInheritanceChainAcrossSchemas(actual).includes(supertype)) {
+        throw new Error(`${context}: ${attribute} #${id} must be an ${supertype}, got ${actual}`);
+    }
+}
+/** Validate one cost-control relationship member against the IFC hierarchy. */
+export function requireAssignableIfcObjectDefinition(editor, id, relatingControlId, context) {
+    if (id === relatingControlId) {
+        throw new Error(`${context}: relatingControlId #${id} cannot also be one of relatedObjectIds`);
+    }
+    requireEntitySubtype(editor, id, 'IfcObjectDefinition', 'relatedObjectIds', context);
+}
+//# sourceMappingURL=cost-reference-validation.js.map

package/dist/in-store/cost-reference-validation.js.map

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

package/dist/in-store/cost-removal.d.ts

@@ -0,0 +1,40 @@
+/** Safe removal of loaded-model cost entities and their relationship references. */
+import type { StoreEditor } from '@ifc-lite/mutations';
+import type { CostAnchor } from './cost.js';
+/** Every reference the caller found pointing at the entity being removed. */
+export interface CostRemovalReferrers {
+    itemCostValues?: ReadonlyMap<number, readonly number[]>;
+    valueComponents?: ReadonlyMap<number, readonly number[]>;
+    valueAppliedValueRef?: ReadonlyMap<number, number>;
+    nestRelatedObjects?: ReadonlyMap<number, readonly number[]>;
+    assignmentRelatedObjects?: ReadonlyMap<number, readonly number[]>;
+    nestsAsParent?: readonly number[];
+    assignmentsAsControl?: readonly number[];
+    /** Other relationship list attributes that can retain their surviving members. */
+    otherRelationshipLists?: readonly {
+        relId: number;
+        attributeIndex: number;
+        relatedIds: readonly number[];
+    }[];
+    /** Relationships where the target occupies a required scalar endpoint. */
+    otherRelationships?: readonly number[];
+    /** Non-relationship entities whose optional scalar attribute references the target. */
+    optionalScalarReferrers?: readonly {
+        entityId: number;
+        attributeIndex: number;
+    }[];
+    /** Non-relationship entities whose optional list attribute contains the target. */
+    optionalListReferrers?: readonly {
+        entityId: number;
+        attributeIndex: number;
+        referencedIds: readonly number[];
+    }[];
+}
+/**
+ * Safe-delete an `IfcCostSchedule` / `IfcCostItem` / `IfcCostValue`, refusing
+ * live value references unless `detach` explicitly requests their rewrite.
+ */
+export declare function removeCostEntityInStore(editor: StoreEditor, anchor: CostAnchor, expressId: number, referrers: CostRemovalReferrers, options?: {
+    detach?: boolean;
+}): void;
+//# sourceMappingURL=cost-removal.d.ts.map

package/dist/in-store/cost-removal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-removal.d.ts","sourceRoot":"","sources":["../../src/in-store/cost-removal.ts"],"names":[],"mappings":"AAIA,oFAAoF;AAEpF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAI5C,6EAA6E;AAC7E,MAAM,WAAW,oBAAoB;IACnC,cAAc,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;IACxD,eAAe,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;IACzD,oBAAoB,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,kBAAkB,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;IAC5D,wBAAwB,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;IAClE,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,oBAAoB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,kFAAkF;IAClF,sBAAsB,CAAC,EAAE,SAAS;QAChC,KAAK,EAAE,MAAM,CAAC;QACd,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;KAC/B,EAAE,CAAC;IACJ,0EAA0E;IAC1E,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,uFAAuF;IACvF,uBAAuB,CAAC,EAAE,SAAS;QACjC,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;KACxB,EAAE,CAAC;IACJ,mFAAmF;IACnF,qBAAqB,CAAC,EAAE,SAAS;QAC/B,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;QACvB,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;KAClC,EAAE,CAAC;CACL;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,oBAAoB,EAC/B,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,IAAI,CAkFN"}

package/dist/in-store/cost-removal.js

@@ -0,0 +1,107 @@
+/* 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 { assertCostSchema } from '../cost-authoring-rules.js';
+import { requireEntityTypeOneOf, requireMatchingCostSchema } from './cost-reference-validation.js';
+const REMOVABLE_COST_ENTITY_TYPES = new Set(['IFCCOSTSCHEDULE', 'IFCCOSTITEM', 'IFCCOSTVALUE']);
+/**
+ * Safe-delete an `IfcCostSchedule` / `IfcCostItem` / `IfcCostValue`, refusing
+ * live value references unless `detach` explicitly requests their rewrite.
+ */
+export function removeCostEntityInStore(editor, anchor, expressId, referrers, options = {}) {
+    assertCostSchema(requireMatchingCostSchema(editor, anchor.schema), 'removeCostEntity');
+    requireEntityTypeOneOf(editor, expressId, REMOVABLE_COST_ENTITY_TYPES, 'expressId', 'removeCostEntity');
+    const blockers = [];
+    for (const [itemId, values] of referrers.itemCostValues ?? []) {
+        if (values.includes(expressId))
+            blockers.push(`IfcCostItem #${itemId}.CostValues`);
+    }
+    for (const [valueId, components] of referrers.valueComponents ?? []) {
+        if (components.includes(expressId))
+            blockers.push(`IfcCostValue #${valueId}.Components`);
+    }
+    for (const [valueId, ref] of referrers.valueAppliedValueRef ?? []) {
+        if (ref === expressId)
+            blockers.push(`IfcCostValue #${valueId}.AppliedValue (AppliedValueRef)`);
+    }
+    for (const ref of referrers.otherRelationshipLists ?? []) {
+        if (ref.relatedIds.includes(expressId))
+            blockers.push(`relationship #${ref.relId}`);
+    }
+    for (const relId of referrers.otherRelationships ?? [])
+        blockers.push(`relationship #${relId}`);
+    for (const ref of referrers.optionalScalarReferrers ?? []) {
+        blockers.push(`entity #${ref.entityId} attribute ${ref.attributeIndex}`);
+    }
+    for (const ref of referrers.optionalListReferrers ?? []) {
+        if (ref.referencedIds.includes(expressId)) {
+            blockers.push(`entity #${ref.entityId} attribute ${ref.attributeIndex}`);
+        }
+    }
+    if (blockers.length > 0 && !options.detach) {
+        throw new Error(`removeCostEntity: #${expressId} is still referenced by ${blockers.join(', ')}. `
+            + 'Pass { detach: true } to rewrite those lists first.');
+    }
+    if (blockers.length > 0) {
+        for (const [itemId, values] of referrers.itemCostValues ?? []) {
+            if (!values.includes(expressId))
+                continue;
+            const remaining = values.filter(id => id !== expressId);
+            editor.setPositionalAttribute(itemId, 7, remaining.length === 0 ? null : remaining.map(id => `#${id}`));
+        }
+        for (const [valueId, components] of referrers.valueComponents ?? []) {
+            if (!components.includes(expressId))
+                continue;
+            const remaining = components.filter(id => id !== expressId);
+            editor.setPositionalAttribute(valueId, 9, remaining.length === 0 ? null : remaining.map(id => `#${id}`));
+        }
+        for (const [valueId, ref] of referrers.valueAppliedValueRef ?? []) {
+            if (ref === expressId)
+                editor.setPositionalAttribute(valueId, 2, null);
+        }
+        for (const ref of referrers.otherRelationshipLists ?? []) {
+            if (!ref.relatedIds.includes(expressId))
+                continue;
+            const remaining = ref.relatedIds.filter(id => id !== expressId);
+            if (remaining.length === 0)
+                editor.removeEntity(ref.relId);
+            else
+                editor.setPositionalAttribute(ref.relId, ref.attributeIndex, remaining.map(id => `#${id}`));
+        }
+        for (const relId of referrers.otherRelationships ?? [])
+            editor.removeEntity(relId);
+        for (const ref of referrers.optionalScalarReferrers ?? []) {
+            editor.setPositionalAttribute(ref.entityId, ref.attributeIndex, null);
+        }
+        for (const ref of referrers.optionalListReferrers ?? []) {
+            if (!ref.referencedIds.includes(expressId))
+                continue;
+            const remaining = ref.referencedIds.filter(id => id !== expressId);
+            editor.setPositionalAttribute(ref.entityId, ref.attributeIndex, remaining.length === 0 ? null : remaining.map(id => `#${id}`));
+        }
+    }
+    for (const [relId, related] of referrers.nestRelatedObjects ?? []) {
+        if (!related.includes(expressId))
+            continue;
+        const remaining = related.filter(id => id !== expressId);
+        if (remaining.length === 0)
+            editor.removeEntity(relId);
+        else
+            editor.setPositionalAttribute(relId, 5, remaining.map(id => `#${id}`));
+    }
+    for (const [relId, related] of referrers.assignmentRelatedObjects ?? []) {
+        if (!related.includes(expressId))
+            continue;
+        const remaining = related.filter(id => id !== expressId);
+        if (remaining.length === 0)
+            editor.removeEntity(relId);
+        else
+            editor.setPositionalAttribute(relId, 4, remaining.map(id => `#${id}`));
+    }
+    for (const relId of referrers.nestsAsParent ?? [])
+        editor.removeEntity(relId);
+    for (const relId of referrers.assignmentsAsControl ?? [])
+        editor.removeEntity(relId);
+    editor.removeEntity(expressId);
+}
+//# sourceMappingURL=cost-removal.js.map

package/dist/in-store/cost-removal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-removal.js","sourceRoot":"","sources":["../../src/in-store/cost-removal.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAK/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAGnG,MAAM,2BAA2B,GAAG,IAAI,GAAG,CAAC,CAAC,iBAAiB,EAAE,aAAa,EAAE,cAAc,CAAC,CAAC,CAAC;AAgChG;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,MAAmB,EACnB,MAAkB,EAClB,SAAiB,EACjB,SAA+B,EAC/B,UAAgC,EAAE;IAElC,gBAAgB,CAAC,yBAAyB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,kBAAkB,CAAC,CAAC;IACvF,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,2BAA2B,EAAE,WAAW,EAAE,kBAAkB,CAAC,CAAC;IACxG,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,SAAS,CAAC,cAAc,IAAI,EAAE,EAAE,CAAC;QAC9D,IAAI,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,gBAAgB,MAAM,aAAa,CAAC,CAAC;IACrF,CAAC;IACD,KAAK,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,IAAI,SAAS,CAAC,eAAe,IAAI,EAAE,EAAE,CAAC;QACpE,IAAI,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,iBAAiB,OAAO,aAAa,CAAC,CAAC;IAC3F,CAAC;IACD,KAAK,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,SAAS,CAAC,oBAAoB,IAAI,EAAE,EAAE,CAAC;QAClE,IAAI,GAAG,KAAK,SAAS;YAAE,QAAQ,CAAC,IAAI,CAAC,iBAAiB,OAAO,iCAAiC,CAAC,CAAC;IAClG,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,SAAS,CAAC,sBAAsB,IAAI,EAAE,EAAE,CAAC;QACzD,IAAI,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,iBAAiB,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;IACtF,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,kBAAkB,IAAI,EAAE;QAAE,QAAQ,CAAC,IAAI,CAAC,iBAAiB,KAAK,EAAE,CAAC,CAAC;IAChG,KAAK,MAAM,GAAG,IAAI,SAAS,CAAC,uBAAuB,IAAI,EAAE,EAAE,CAAC;QAC1D,QAAQ,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,QAAQ,cAAc,GAAG,CAAC,cAAc,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,SAAS,CAAC,qBAAqB,IAAI,EAAE,EAAE,CAAC;QACxD,IAAI,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1C,QAAQ,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,QAAQ,cAAc,GAAG,CAAC,cAAc,EAAE,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CACb,sBAAsB,SAAS,2BAA2B,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;cAC/E,qDAAqD,CACxD,CAAC;IACJ,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,SAAS,CAAC,cAAc,IAAI,EAAE,EAAE,CAAC;YAC9D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAAE,SAAS;YAC1C,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC;YACxD,MAAM,CAAC,sBAAsB,CAAC,MAAM,EAAE,CAAC,EAAE,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;QAC1G,CAAC;QACD,KAAK,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,IAAI,SAAS,CAAC,eAAe,IAAI,EAAE,EAAE,CAAC;YACpE,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAAE,SAAS;YAC9C,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC;YAC5D,MAAM,CAAC,sBAAsB,CAAC,OAAO,EAAE,CAAC,EAAE,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;QAC3G,CAAC;QACD,KAAK,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,SAAS,CAAC,oBAAoB,IAAI,EAAE,EAAE,CAAC;YAClE,IAAI,GAAG,KAAK,SAAS;gBAAE,MAAM,CAAC,sBAAsB,CAAC,OAAO,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;QACzE,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,SAAS,CAAC,sBAAsB,IAAI,EAAE,EAAE,CAAC;YACzD,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAAE,SAAS;YAClD,MAAM,SAAS,GAAG,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC;YAChE,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;gBAAE,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;;gBACtD,MAAM,CAAC,sBAAsB,CAChC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,cAAc,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAC7D,CAAC;QACJ,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,kBAAkB,IAAI,EAAE;YAAE,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QACnF,KAAK,MAAM,GAAG,IAAI,SAAS,CAAC,uBAAuB,IAAI,EAAE,EAAE,CAAC;YAC1D,MAAM,CAAC,sBAAsB,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;QACxE,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,SAAS,CAAC,qBAAqB,IAAI,EAAE,EAAE,CAAC;YACxD,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAAE,SAAS;YACrD,MAAM,SAAS,GAAG,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC;YACnE,MAAM,CAAC,sBAAsB,CAC3B,GAAG,CAAC,QAAQ,EACZ,GAAG,CAAC,cAAc,EAClB,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAC9D,CAAC;QACJ,CAAC;IACH,CAAC;IACD,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,SAAS,CAAC,kBAAkB,IAAI,EAAE,EAAE,CAAC;QAClE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;YAAE,SAAS;QAC3C,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC;QACzD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;;YAClD,MAAM,CAAC,sBAAsB,CAAC,KAAK,EAAE,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;IAC9E,CAAC;IACD,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,SAAS,CAAC,wBAAwB,IAAI,EAAE,EAAE,CAAC;QACxE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;YAAE,SAAS;QAC3C,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC;QACzD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;;YAClD,MAAM,CAAC,sBAAsB,CAAC,KAAK,EAAE,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;IAC9E,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,aAAa,IAAI,EAAE;QAAE,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IAC9E,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,oBAAoB,IAAI,EAAE;QAAE,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IACrF,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;AACjC,CAAC"}

package/dist/in-store/cost.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Loaded-model cost authoring (#4857 PR A) — `bim.store.addCost*` / `nestCostItems`
+ * / `assignCostItemsToSchedule` / `assignToCostItem` / `setCostItemValues` /
+ * `removeCostEntity`. The counterpart of `ifc-creator-cost.ts` for a model
+ * that is already parsed and loaded rather than being built from scratch:
+ * same validation (`cost-authoring-rules.ts`, shared so a value illegal from
+ * one entry point is illegal from the other), different serialization —
+ * `StoreEditor.addEntity` takes a typed attribute array, not raw STEP text.
+ *
+ * Pure: no I/O, no parser access, no read of the store's OWN existing graph.
+ * `nestCostItemsInStore` (reparenting) and `removeCostEntityInStore`
+ * (safe-delete / cascade) both need to know what ALREADY references an
+ * entity, which only a graph READ can answer — the caller resolves referrers
+ * first and hands them in. The editor is the only mutable thing touched.
+ */
+import { type RandomSource } from '@ifc-lite/encoding';
+import type { StoreEditor } from '@ifc-lite/mutations';
+import { type CostSchema } from '../cost-authoring-rules.js';
+import type { CostItemParams, CostQuantityParams, CostScheduleParams, CostValueParams } from '../types-cost.js';
+/** What `nestCostItemsInStore` / `assign*InStore` / `removeCostEntityInStore` need to
+ *  reparent or detach cleanly — the model's owner history and target schema. */
+export interface CostAnchor {
+    /** IfcOwnerHistory expressId, or null when the model has none (written as `$`). */
+    ownerHistoryId: number | null;
+    /** Target schema; IFC2X3 is refused (see `assertCostSchema`). */
+    schema: CostSchema;
+    /** Optional seeded randomness for authored GlobalIds — see `SpatialAnchor.guidRandom`. */
+    guidRandom?: RandomSource;
+}
+/**
+ * Emit an `IfcCostSchedule` into the loaded model's overlay.
+ *
+ * [0] GlobalId, [1] OwnerHistory, [2] Name, [3] Description, [4] ObjectType,
+ * [5] Identification, [6] PredefinedType, [7] Status, [8] SubmittedOn,
+ * [9] UpdateDate — same IFC4 layout `emitCostSchedule` writes; refused for
+ * IFC2X3 (different layout, see `assertCostSchema`).
+ */
+export declare function addCostScheduleToStore(editor: StoreEditor, anchor: CostAnchor, params: CostScheduleParams): number;
+/**
+ * Emit an `IfcCostItem`. [0] GlobalId, [1] OwnerHistory, [2] Name,
+ * [3] Description, [4] ObjectType, [5] Identification, [6] PredefinedType,
+ * [7] CostValues, [8] CostQuantities — an empty `CostValues`/`CostQuantities`
+ * array is refused (EXPRESS `[1:?]`); use `attachCostValuesToItemInStore` to
+ * attach them after the fact instead.
+ */
+export declare function addCostItemToStore(editor: StoreEditor, anchor: CostAnchor, params: CostItemParams): number;
+/**
+ * Emit an `IfcCostValue`. [0] Name, [1] Description, [2] AppliedValue,
+ * [3] UnitBasis, [4] ApplicableDate, [5] FixedUntilDate, [6] Category,
+ * [7] Condition, [8] ArithmeticOperator, [9] Components.
+ *
+ * `AppliedValue` and `AppliedValueRef` are the two branches of one SELECT —
+ * at most one may be given (mirrors `emitCostValue`).
+ */
+export declare function addCostValueToStore(editor: StoreEditor, anchor: CostAnchor, params: CostValueParams): number;
+/**
+ * Emit an `IfcPhysicalSimpleQuantity` (the same subtypes `emitPhysicalQuantity`
+ * writes), for `IfcCostItem.CostQuantities`. [0] Name, [1] Description,
+ * [2] Unit, [3] `<Kind>Value`, [4] Formula.
+ */
+export declare function addCostQuantityToStore(editor: StoreEditor, anchor: CostAnchor, params: CostQuantityParams): number;
+/** One relationship the caller already found referencing an id, so the builders below
+ *  never need to scan the store themselves — see the module header. */
+export interface ExistingRelatedList {
+    relId: number;
+    /** The relationship's RelatingObject, when the caller is supplying a nesting graph. */
+    relatingId?: number;
+    /** The relationship's current RelatedObjects (or Components), in file order. */
+    relatedIds: readonly number[];
+    /**
+     * When a controller legally has MORE THAN ONE relationship of this kind
+     * (e.g. two separate `IfcRelAssignsToControl` records for the same
+     * schedule), every member across ALL of them — used only to decide which
+     * requested ids are genuinely new, never as the list written back. Writing
+     * this union into `relId`'s own slot would copy a secondary relationship's
+     * members into the primary one, duplicating membership while leaving the
+     * secondary relationship untouched. Defaults to `relatedIds` when absent
+     * (the single-relationship case, where the two are the same set).
+     */
+    allMemberIds?: readonly number[];
+}
+/**
+ * Nest `childIds` under `parentId` as `IfcRelNests.RelatedObjects` (slot 5),
+ * `RelatingObject` = parent.
+ *
+ * A child already nested under one or more DIFFERENT `IfcRelNests` is
+ * reparented: it is removed from EVERY one of those rels' `RelatedObjects`
+ * first (a file may legally list a child under more than one nest —
+ * `MULTIPLE_NESTING_PARENTS` is a diagnostic, not a refusal — so detaching
+ * from only the first one found would leave it still nested under the rest),
+ * tombstoning a rel if that empties it (`RelatedObjects` is `[1:?]`, so an
+ * emptied list cannot be left as `()`), then added to (or its own new) the
+ * target rel.
+ */
+export declare function nestCostItemsInStore(editor: StoreEditor, anchor: CostAnchor, parentId: number, childIds: number[], existingNestByChild: ReadonlyMap<number, readonly ExistingRelatedList[]>, existingTargetNest?: ExistingRelatedList): number;
+/** Assign `itemIds` (IfcCostItem) to `scheduleId` (IfcCostSchedule) as its controlled objects. */
+export declare function assignCostItemsToScheduleInStore(editor: StoreEditor, anchor: CostAnchor, scheduleId: number, itemIds: number[], existingAssignment?: ExistingRelatedList): number;
+/**
+ * Assign IFC objects (products, tasks, resources, etc.) to a cost item.
+ * The controlling item itself is not a legal related member.
+ */
+export declare function assignObjectsToCostItemInStore(editor: StoreEditor, anchor: CostAnchor, costItemId: number, objectIds: number[], existingAssignment?: ExistingRelatedList): number;
+/**
+ * Set (replace) `itemId`'s `IfcCostItem.CostValues` (slot 7). `valueIds` is
+ * REQUIRED, not optional: an empty array is how a caller CLEARS the list,
+ * written as `$` — never `()`, which `[1:?]` forbids.
+ */
+export declare function attachCostValuesToItemInStore(editor: StoreEditor, anchor: CostAnchor, itemId: number, valueIds: readonly number[]): void;
+//# sourceMappingURL=cost.d.ts.map

package/dist/in-store/cost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost.d.ts","sourceRoot":"","sources":["../../src/in-store/cost.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,KAAK,EAAE,WAAW,EAAqB,MAAM,qBAAqB,CAAC;AAM1E,OAAO,EAGL,KAAK,UAAU,EAChB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EACV,cAAc,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,eAAe,EACxE,MAAM,kBAAkB,CAAC;AAG1B;gFACgF;AAChF,MAAM,WAAW,UAAU;IACzB,mFAAmF;IACnF,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,iEAAiE;IACjE,MAAM,EAAE,UAAU,CAAC;IACnB,0FAA0F;IAC1F,UAAU,CAAC,EAAE,YAAY,CAAC;CAC3B;AAeD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAmBlH;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,GAAG,MAAM,CA0B1G;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,GAAG,MAAM,CAiC5G;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,kBAAkB,GAAG,MAAM,CA6BlH;AAED;uEACuE;AACvE,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,uFAAuF;IACvF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gFAAgF;IAChF,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAAE,EAClB,mBAAmB,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,mBAAmB,EAAE,CAAC,EACxE,kBAAkB,CAAC,EAAE,mBAAmB,GACvC,MAAM,CA6CR;AA4DD,kGAAkG;AAClG,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAC9E,kBAAkB,CAAC,EAAE,mBAAmB,GACvC,MAAM,CAIR;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAChF,kBAAkB,CAAC,EAAE,mBAAmB,GACvC,MAAM,CAGR;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,IAAI,CAcN"}