@ifc-lite/export 3.0.1 → 4.0.0

package/dist/anonymize-placement.js

@@ -0,0 +1,266 @@
+/* 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 { attrIndex, readEntityArgs } from './subset-entity-reader.js';
+import { splitTopLevelArgs } from './step-argument-parser.js';
+import { entityRef, stepReal } from './step-serialization.js';
+const IFC_SITE_ADDRESS_ATTRIBUTES = [
+    'RefLatitude',
+    'RefLongitude',
+    'RefElevation',
+    'LandTitleNumber',
+    'SiteAddress',
+];
+/**
+ * Zero every root `IfcLocalPlacement` translation reachable from
+ * `includedIds`, zero `WorldCoordinateSystem` on every
+ * `IfcGeometricRepresentationContext` (always exported — it is an
+ * `INFRASTRUCTURE_TYPES` member, `reference-collector.ts`), and blank
+ * `IfcSite` / `IfcBuilding` georeferencing and address attributes.
+ *
+ * `store`/`index` are read from (never mutated directly) — every change goes
+ * through `editor` (new entities, positional overrides) or `view` (named
+ * attribute overrides), so the private `MutablePropertyView` overlay the
+ * orchestrator built stays the ONE place this export's edits live.
+ */
+export function applyPlacementAnonymization(store, index, includedIds, editor, view, opts) {
+    const warnings = [];
+    const zeroedPlacements = [];
+    if (opts?.zeroRootPlacement !== false) {
+        zeroRootPlacements(store, index, includedIds, editor, warnings, zeroedPlacements);
+        zeroWorldCoordinateSystems(store, index, editor, warnings);
+    }
+    if (opts?.removeGeoreferencing !== false) {
+        blankSiteAndBuildingAddresses(index, includedIds, view);
+    }
+    return { zeroedPlacements, warnings };
+}
+function zeroRootPlacements(store, index, includedIds, editor, warnings, zeroedPlacements) {
+    // Memoised by placementId: the root a placement chain terminates at is a
+    // pure function of that id ("Bounding walks", AGENTS.md — global memoising
+    // is the right scope here, not path-scoped, since the answer never
+    // accumulates across callers), and many products in a subset commonly
+    // share one storey/building placement chain.
+    const rootCache = new Map();
+    const localPlacementRoots = new Set();
+    for (const id of includedIds) {
+        const rec = readEntityArgs(store, index, id);
+        if (!rec)
+            continue;
+        const objectPlacementIdx = attrIndex(rec.type, 'ObjectPlacement'); // declared on IfcProduct itself — slot order checked identical across ENTITIES_IFC2X3/_IFC4/_IFC4X3, no `schema` arg needed (#3309)
+        if (objectPlacementIdx < 0 || objectPlacementIdx >= rec.args.length)
+            continue;
+        const placementId = parseRef(rec.args[objectPlacementIdx]);
+        if (placementId === null)
+            continue;
+        let root = rootCache.get(placementId);
+        if (root === undefined) {
+            root = findRootPlacement(store, index, placementId, warnings);
+            rootCache.set(placementId, root);
+        }
+        if (!root)
+            continue;
+        if (root.rootType !== 'IFCLOCALPLACEMENT') {
+            warnings.push(`#${root.rootId} (${root.rootType}) is a root placement this export cannot zero — only ` +
+                `IfcLocalPlacement roots are supported; left untouched, so its absolute position is still in the file.`);
+            continue;
+        }
+        localPlacementRoots.add(root.rootId);
+    }
+    for (const rootId of localPlacementRoots) {
+        const translation = zeroAxisPlacementSlot(store, index, editor, rootId, 'IFCLOCALPLACEMENT', 'RelativePlacement', warnings);
+        if (translation)
+            zeroedPlacements.push({ expressId: rootId, translation });
+    }
+    if (zeroedPlacements.length > 1) {
+        warnings.push(`${zeroedPlacements.length} independent root placements were each zeroed to the origin; ` +
+            `their original relative offset from one another is not preserved.`);
+    }
+}
+/**
+ * Follow `PlacementRelTo` from `startPlacementId` while the current record is
+ * an `IfcLocalPlacement`, and return the terminal placement — either an
+ * `IfcLocalPlacement` with `PlacementRelTo = $` (a zeroable root) or a
+ * non-`IfcLocalPlacement` record the chain cannot continue past (an
+ * `IfcGridPlacement` / `IfcLinearPlacement`, reported by the caller). `null`
+ * when the chain could not be safely walked at all — a cycle, a hop past the
+ * 256-hop cap, or a link that does not resolve to a readable record — each
+ * case appending its own warning before returning.
+ */
+function findRootPlacement(store, index, startPlacementId, warnings) {
+    const visited = new Set();
+    let currentId = startPlacementId;
+    let hops = 0;
+    for (;;) {
+        if (visited.has(currentId)) {
+            warnings.push(`Placement chain from #${startPlacementId} revisits #${currentId} (PlacementRelTo cycle); left untouched.`);
+            return null;
+        }
+        visited.add(currentId);
+        hops++;
+        if (hops > 256) {
+            warnings.push(`Placement chain from #${startPlacementId} exceeds 256 hops; left untouched rather than followed indefinitely.`);
+            return null;
+        }
+        const rec = readEntityArgs(store, index, currentId);
+        if (!rec) {
+            warnings.push(`Placement #${currentId} in the chain from #${startPlacementId} could not be read; left untouched.`);
+            return null;
+        }
+        if (rec.type !== 'IFCLOCALPLACEMENT') {
+            return { rootId: currentId, rootType: rec.type };
+        }
+        const relToIdx = attrIndex(rec.type, 'PlacementRelTo'); // `rec.type` is always IFCLOCALPLACEMENT here — order verified identical across all 3 schemas (#3309)
+        const parentId = relToIdx >= 0 && relToIdx < rec.args.length ? parseRef(rec.args[relToIdx]) : null;
+        if (parentId === null) {
+            return { rootId: currentId, rootType: rec.type };
+        }
+        currentId = parentId;
+    }
+}
+// ---------------------------------------------------------------------------
+// IfcGeometricRepresentationContext.WorldCoordinateSystem
+// ---------------------------------------------------------------------------
+/**
+ * Every `IfcGeometricRepresentationContext` in the model — not just
+ * `includedIds` — because it is an `INFRASTRUCTURE_TYPES` member
+ * (`reference-collector.ts`) and is therefore always carried into the
+ * export regardless of what the caller selected. A plain, non-recursive
+ * pass over `index`: bounded by the model's own (small) count of
+ * representation contexts, not a reference walk that needs its own guard.
+ */
+function zeroWorldCoordinateSystems(store, index, editor, warnings) {
+    for (const [id, ref] of index) {
+        if (index.effectiveType(id, ref.type) !== 'IFCGEOMETRICREPRESENTATIONCONTEXT')
+            continue;
+        // `TrueNorth` is deliberately left alone — only the origin offset is
+        // identifying; the survey rotation is exactly the kind of
+        // geometry-relevant signal this feature is written to keep (#2934).
+        zeroAxisPlacementSlot(store, index, editor, id, 'IFCGEOMETRICREPRESENTATIONCONTEXT', 'WorldCoordinateSystem', warnings);
+    }
+}
+// ---------------------------------------------------------------------------
+// Shared clone-and-repoint primitive
+// ---------------------------------------------------------------------------
+/**
+ * Zero the `IfcCartesianPoint.Location` reachable through
+ * `entityId.<slotName>` → `IfcAxis2Placement2D|3D` → `Location`, by CLONING
+ * the point and the axis placement (never rewriting either — see the module
+ * doc) and repointing `entityId.<slotName>` at the clone.
+ *
+ * Returns the original (pre-zero) coordinates when a zero-clone was
+ * performed, or `null` when there was nothing to do: the slot is `$`, it
+ * does not resolve to an `IfcAxis2Placement2D/3D` → `IfcCartesianPoint`
+ * chain (warned), or the point is already at the origin.
+ */
+function zeroAxisPlacementSlot(store, index, editor, entityId, entityType, slotName, warnings) {
+    const slotIdx = attrIndex(entityType, slotName); // entityType/slotName always fixed literals, order verified identical across all 3 schemas (#3309)
+    if (slotIdx < 0)
+        return null;
+    const rec = readEntityArgs(store, index, entityId);
+    if (!rec || slotIdx >= rec.args.length)
+        return null;
+    const axisId = parseRef(rec.args[slotIdx]);
+    if (axisId === null)
+        return null; // `$` — nothing placed here to zero.
+    const axisRec = readEntityArgs(store, index, axisId);
+    if (!axisRec) {
+        warnings.push(`#${entityId} ${slotName} references #${axisId}, which could not be read; left untouched.`);
+        return null;
+    }
+    const is3D = axisRec.type === 'IFCAXIS2PLACEMENT3D';
+    const is2D = axisRec.type === 'IFCAXIS2PLACEMENT2D';
+    if (!is3D && !is2D) {
+        warnings.push(`#${entityId} ${slotName} resolves to #${axisId} (${axisRec.type}), not an ` +
+            `IfcAxis2Placement2D/3D; left untouched.`);
+        return null;
+    }
+    const locationIdx = attrIndex(axisRec.type, 'Location'); // IfcAxis2Placement2D/3D — same verified-stable guarantee as slotIdx above (#3309)
+    const pointId = locationIdx >= 0 ? parseRef(axisRec.args[locationIdx]) : null;
+    if (pointId === null)
+        return null;
+    const pointRec = readEntityArgs(store, index, pointId);
+    if (!pointRec || pointRec.type !== 'IFCCARTESIANPOINT') {
+        warnings.push(`#${entityId} ${slotName} → #${axisId} → Location #${pointId} is not an IfcCartesianPoint; left untouched.`);
+        return null;
+    }
+    const coords = parseCoordinateList(pointRec.args[0]);
+    if (!coords || coords.every((c) => c === 0))
+        return null; // absent, or already at the origin.
+    // Clone the point at the origin, same dimensionality.
+    const newPoint = editor.addEntity('IfcCartesianPoint', [coords.map(() => stepReal(0))]);
+    // Clone the axis placement, carrying `Axis`/`RefDirection` over VERBATIM —
+    // the rotation is exactly what a reproduction needs to keep.
+    const newAxisAttrs = [entityRef(newPoint.expressId)];
+    for (const name of is3D ? ['Axis', 'RefDirection'] : ['RefDirection']) {
+        const idx = attrIndex(axisRec.type, name); // same guarantee as locationIdx above (#3309)
+        newAxisAttrs.push(idx >= 0 ? verbatimAttr(axisRec.args[idx]) : null);
+    }
+    const newAxis = editor.addEntity(is3D ? 'IfcAxis2Placement3D' : 'IfcAxis2Placement2D', newAxisAttrs);
+    editor.setPositionalAttribute(entityId, slotIdx, entityRef(newAxis.expressId));
+    return coords;
+}
+// ---------------------------------------------------------------------------
+// IfcSite / IfcBuilding georeferencing + address blanking
+// ---------------------------------------------------------------------------
+/**
+ * `IfcMapConversion(Scaled)` / `IfcProjectedCRS` need no handling here, and the
+ * reason is conditional since #3351: `IDENTIFYING_TYPES` and inverse-only, so
+ * `removeGeoreferencing` ON leaves them absent, while OFF must ROOT them —
+ * merely not excluding an inverse-only entity still drops it silently.
+ *
+ * All six blanked slots are OPTIONAL but not all STRING-typed — a LIST OF
+ * INTEGER, a REAL, and two entity refs among them — so `$` (via
+ * `setPositionalAttribute` + `null`) is the only blank valid for all of them;
+ * `setAttribute` only emits a quoted STEP string and would corrupt the rest.
+ */
+function blankSiteAndBuildingAddresses(index, includedIds, view) {
+    for (const id of includedIds) {
+        const type = index.typeOf(id);
+        if (type === 'IFCSITE') {
+            for (const attr of IFC_SITE_ADDRESS_ATTRIBUTES) {
+                const idx = attrIndex(type, attr); // IfcSite's address slots verified stable across all 3 schemas (#3309)
+                if (idx >= 0)
+                    view.setPositionalAttribute(id, idx, null);
+            }
+        }
+        else if (type === 'IFCBUILDING') {
+            const idx = attrIndex(type, 'BuildingAddress'); // verified stable across all 3 schemas (#3309)
+            if (idx >= 0)
+                view.setPositionalAttribute(id, idx, null);
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Token helpers
+// ---------------------------------------------------------------------------
+/** `"#42"` → `42`; anything else (`$`, a literal, missing) → `null`. */
+function parseRef(token) {
+    if (!token)
+        return null;
+    const match = /^#(\d+)$/.exec(token.trim());
+    return match ? Number(match[1]) : null;
+}
+/** Carry a verbatim STEP token (`$` or `#N`) into `StoreEditor.addEntity`'s
+ *  attribute conventions: `$` becomes `null`, a reference token is passed
+ *  through as the `"#42"` string `addEntity` recognizes. */
+function verbatimAttr(token) {
+    if (!token)
+        return null;
+    const trimmed = token.trim();
+    return trimmed === '$' || trimmed === '' ? null : trimmed;
+}
+/** Parse an `IfcCartesianPoint.Coordinates` token — a parenthesized,
+ *  top-level-comma-separated REAL list (`(1000.,2000.,30.)`) — into numbers.
+ *  `null` when the token isn't a list, or any member doesn't parse as a
+ *  finite number. */
+function parseCoordinateList(token) {
+    if (!token)
+        return null;
+    const trimmed = token.trim();
+    if (!trimmed.startsWith('(') || !trimmed.endsWith(')'))
+        return null;
+    const numbers = splitTopLevelArgs(trimmed.slice(1, -1)).map((part) => Number(part.trim()));
+    return numbers.every((n) => Number.isFinite(n)) ? numbers : null;
+}
+//# sourceMappingURL=anonymize-placement.js.map

package/dist/anonymize-placement.js.map

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

package/dist/anonymize-scrub.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Scrub pass for the "anonymized isolated export" feature (#2934, plan A5):
+ * deterministic per-type pseudonyms for `Name`/`LongName`/`Description`/`Tag`
+ * on every included `IfcRoot`, `GlobalId` regeneration (the old->new map is
+ * handed back as `guidMap` rather than written into the file — see
+ * `AnonymizeResult.guidMap` on `anonymize-types.ts`), owner-history scrubbing
+ * (`IfcPerson`/`IfcOrganization`/`IfcPersonAndOrganization`), and clearing an
+ * included `IfcTypeObject`'s `HasPropertySets` slot.
+ *
+ * Expressed as mutations on a private `MutablePropertyView`, never as a text
+ * rewrite — see the plan's "Key mechanism choice": the effective-index
+ * closure walk (`effective-index.ts`) already reacts to a queued
+ * `setAttribute`/`setPositionalAttribute`, so these mutations are visible to
+ * `step-collection.ts`'s subset closure the same way any other overlay edit
+ * is, with no second code path that could disagree about what got scrubbed.
+ *
+ * Deliberately does NOT use `store.entities.getTypeName` for the pseudonym
+ * label despite the plan sketch spelling it that way: that table only
+ * indexes product-ish entities and answers `'Unknown'` for the rest (see its
+ * own doc) — including `IfcPropertySet` (an `IfcRoot` descendant this module
+ * must be able to pseudonymize under `keepPropertySets`) and every
+ * `IfcRel*` relationship (also `IfcRoot` descendants, per `IFC_ROOT_TYPES`).
+ * `'Unknown-1'`, `'Unknown-2'`, … colliding across every such class would be
+ * both a worse pseudonym AND a residual identifying signal (two entities
+ * sharing a label leaks that they were originally the SAME kind of thing).
+ * `normalizeIfcTypeName` off the effective index's own class answer has no
+ * such gap.
+ */
+import type { IfcSourceBytes } from '@ifc-lite/parser';
+import type { MutablePropertyView } from '@ifc-lite/mutations';
+import type { EffectiveEntityIndex } from './effective-index.js';
+import type { AnonymizeOptions } from './anonymize-types.js';
+/** The subset of `AnonymizeOptions` this pass reads. */
+export type ScrubOptions = Pick<AnonymizeOptions, 'pseudonymizeNames' | 'pseudonymizeAllNames' | 'regenerateGlobalIds' | 'scrubOwnerHistory' | 'neutralizeCurrency' | 'keepPropertySets' | 'guidRandom'>;
+/** What one `applyScrub` call produced. */
+export interface ScrubResult {
+    /** Original `GlobalId` -> regenerated `GlobalId`, one entry per
+     *  `includedIds` `IfcRoot` entity whose GlobalId this pass actually
+     *  regenerated. Empty when `regenerateGlobalIds` is `false`. */
+    guidMap: Map<string, string>;
+    /** How many entities this pass wrote at least one mutation for: every
+     *  scrubbed `includedIds` root, plus every `IfcPerson`/`IfcOrganization`/
+     *  `IfcPersonAndOrganization` found anywhere in `index` and scrubbed. */
+    scrubbedCount: number;
+    /** Non-fatal notices — an `includedIds` root this pass could not read (no
+     *  source bytes, or a record that does not parse) or whose `GlobalId`
+     *  could not be decoded, left untouched by the affected sub-step. */
+    warnings: string[];
+}
+/**
+ * Scrub `includedIds`' `IfcRoot` entities plus every owner-history entity in
+ * `index`, queuing every change on `view` (never writing into `store`).
+ *
+ * `index` must be the EFFECTIVE index (`getEffectiveEntityIndex`), not a
+ * bare source index — see that module's doc for why an overlay-created or
+ * retyped entity answers differently through it. `store` need only expose
+ * `source`: `readEntityArgs` reads SOURCE-backed records only, which is the
+ * entire domain of what this pass mutates (it creates no entities).
+ */
+export declare function applyScrub(store: {
+    readonly source: IfcSourceBytes;
+    readonly schemaVersion?: string;
+}, index: EffectiveEntityIndex, includedIds: ReadonlySet<number>, view: MutablePropertyView, opts?: ScrubOptions): ScrubResult;
+//# sourceMappingURL=anonymize-scrub.d.ts.map

package/dist/anonymize-scrub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anonymize-scrub.d.ts","sourceRoot":"","sources":["../src/anonymize-scrub.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AA0C7D,wDAAwD;AACxD,MAAM,MAAM,YAAY,GAAG,IAAI,CAC7B,gBAAgB,EACd,mBAAmB,GACnB,sBAAsB,GACtB,qBAAqB,GACrB,mBAAmB,GACnB,oBAAoB,GACpB,kBAAkB,GAClB,YAAY,CACf,CAAC;AAEF,2CAA2C;AAC3C,MAAM,WAAW,WAAW;IAC1B;;oEAEgE;IAChE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B;;6EAEyE;IACzE,aAAa,EAAE,MAAM,CAAC;IACtB;;yEAEqE;IACrE,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,EAC3E,KAAK,EAAE,oBAAoB,EAC3B,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,EAChC,IAAI,EAAE,mBAAmB,EACzB,IAAI,GAAE,YAAiB,GACtB,WAAW,CAsIb"}