@ifc-lite/export 3.0.0 → 3.1.0

package/README.md

@@ -61,6 +61,39 @@ const blob = new Blob([stepText], { type: 'application/x-step' });
 
 `exportToStep` is the round-trip path for property edits. Edit via `@ifc-lite/mutations`, export with `applyMutations: true`, ship the resulting `.ifc` to whatever consumes IFC.
 
+## Anonymized isolated export — for bug reports
+
+`collectRelatedEntities` + `exportAnonymizedSubset` pick a seed selection,
+expand it by relationship context (host, openings/fillers, type, materials,
+spatial containment), and export exactly that subset with every
+project-identifying signal removed — while local placement rotations and
+non-orthogonal cuts survive, so a parsing/geometry bug reproduction still
+reproduces:
+
+```typescript
+import { collectRelatedEntities, exportAnonymizedSubset } from '@ifc-lite/export';
+
+const related = collectRelatedEntities(store, new Set([312])); // seed expressId(s)
+const result = exportAnonymizedSubset(store, related.all);
+await saveFile('anonymized.ifc', result.content);
+```
+
+Every `AnonymizeOptions` field defaults to the maximally-scrubbed direction
+(names pseudonymized, `GlobalId`s regenerated, property sets dropped, owner
+history and georeferencing scrubbed) — `ObjectType` and material/style names
+are pseudonymized right along with everything else under the default
+`pseudonymizeAllNames`, and the STEP header's `originating_system` is
+blanked under the default `scrubOwnerHistory`. What stays in the file by
+decision: geometry and local placement rotations/non-orthogonal cuts (only
+the root placement's translation is zeroed), structural entity types,
+material *assignments* (which material, just not its original name), and
+the header's `preprocessor_version` (from `IfcApplication`, defaults to
+`'ifc-lite'`) — that is what makes the file useful for a bug repro. See the
+[Exporting
+Guide](https://ifclite.dev/docs/guide/exporting/#anonymized-isolated-export)
+for the full option list, including how to opt back into authored names via
+`--keep-other-names`.
+
 ## Apache Parquet — for analytics
 
 ```typescript
@@ -134,6 +167,7 @@ const lod1 = await generateLod1(bytes, { quality: 'medium' });
 ## Also exported
 
 - `MergedExporter` - merge several parsed models into one STEP export
+- `collectRelatedEntities` / `exportAnonymizedSubset` - anonymized isolated export (see above)
 - `convertEntityType` / `convertStepLine` / `needsConversion` - IFC2X3 / IFC4 / IFC4X3 schema conversion helpers
 - `parseGLB` / `parseGLBToMeshData` / `extractGlbMapping` - GLB round-trip readers
 

package/dist/anonymize-export.d.ts

@@ -0,0 +1,60 @@
+/**
+ * `exportAnonymizedSubset` (#2934, the "anonymized isolated export" feature,
+ * plan A2 "Orchestrator" row): given a caller-picked `includedIds` selection
+ * (typically `RelatedEntities.all` from `related-entities.ts`), produces a
+ * STEP file that contains ONLY that subset, with every project-identifying
+ * signal removed while the geometry-relevant local transformations
+ * (rotations, non-orthogonal cuts) survive — so a parsing bug reproduction
+ * keeps reproducing.
+ *
+ * Per the plan's "Key mechanism choice": anonymization is expressed as
+ * mutations on a PRIVATE `MutablePropertyView` + `StoreEditor` — never a text
+ * post-pass — fed to the same `StepExporter` every other export mode uses.
+ * The overlay is scoped to one call: nothing here writes into `store`, and
+ * the view is discarded once `export()` returns, so two calls against the
+ * same `store` never interact.
+ *
+ * Call order matters and is fixed:
+ *  1. `pruneUnresolvableRelationships` — ahead of everything else, so a
+ *     relationship this export cannot legally emit (its own mandatory,
+ *     single-valued reference — or every member of a SET/LIST reference —
+ *     names an entity outside `includedIds`) is removed from the ROOT set
+ *     BEFORE `StepExporter` ever sees it, rather than discovered mid-closure
+ *     and withheld with the generic `relationshipWithheldWarning`
+ *     (`step-export-types.ts`). Reported distinctly, as
+ *     `stats.prunedRelationshipIds`, for exactly this reason: a caller
+ *     should be able to tell "this association is gone because the anonymizer
+ *     pruned it" from "this association is gone for some other export-time
+ *     reason" without grepping warning text.
+ *  2. `applyPlacementAnonymization` (`anonymize-placement.ts`) — root
+ *     placement zeroing and georeferencing/address blanking.
+ *  3. `applyScrub` (`anonymize-scrub.ts`) — pseudonyms, GlobalId
+ *     regeneration, owner-history scrub, `HasPropertySets` clearing.
+ *  4. `StepExporter.export` with `subsetEntityIds` set to the PRUNED id set
+ *     and the header scrubbed (`author`/`organization`/`authorization`
+ *     blanked, per the decision doc — `originating_system` and
+ *     `preprocessor_version` are deliberately left alone).
+ *
+ * 2 and 3 both read `store`/`index` and queue their edits onto the SAME
+ * `view`/`editor` pair, so `StepExporter`'s closure walk (which reads the
+ * overlay through `effective-index.ts`) sees every edit from both passes at
+ * once — never two overlays that could disagree about the same entity.
+ */
+import type { IfcDataStore } from '@ifc-lite/parser';
+import type { AnonymizeOptions, AnonymizeResult } from './anonymize-types.js';
+/**
+ * Export `includedIds` (plus infrastructure and their forward closure — see
+ * `subset-roots.ts`) as an anonymized STEP file. Every `AnonymizeOptions`
+ * field defaults to the maximally-scrubbed direction (see that interface's
+ * own doc), so calling this with no options at all is the intended common
+ * case, not a partial anonymization a caller must opt further into.
+ *
+ * Throws when `store` has no source bytes to read entity records from — a
+ * server-parsed or synthetic store with `source.byteLength === 0` has
+ * nothing for `readEntityArgs`/`StepExporter`'s source-iteration pass to
+ * read, and every module this orchestrator calls assumes source-backed
+ * records exist for at least the infrastructure/relationship entities it
+ * touches.
+ */
+export declare function exportAnonymizedSubset(store: IfcDataStore, includedIds: ReadonlySet<number>, options?: AnonymizeOptions): AnonymizeResult;
+//# sourceMappingURL=anonymize-export.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"anonymize-export.d.ts","sourceRoot":"","sources":["../src/anonymize-export.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAkB,MAAM,kBAAkB,CAAC;AAUrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAmD9E;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,YAAY,EACnB,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,EAChC,OAAO,GAAE,gBAAqB,GAC7B,eAAe,CA0DjB"}

package/dist/anonymize-export.js

@@ -0,0 +1,117 @@
+/* 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 { MutablePropertyView, StoreEditor } from '@ifc-lite/mutations';
+import { getEffectiveEntityIndex } from './effective-index.js';
+import { getSubsetEntityIds, IFC_ROOT_TYPES } from './subset-roots.js';
+import { readEntityArgs } from './subset-entity-reader.js';
+import { refGroupFromArg, relationshipRefsSurviveExclusion } from './reference-collector.js';
+import { applyPlacementAnonymization } from './anonymize-placement.js';
+import { applyScrub } from './anonymize-scrub.js';
+import { StepExporter } from './step-exporter.js';
+/**
+ * Every id in `includedIds` whose EXPRESS type is an `IfcRel*` (an
+ * `IFC_ROOT_TYPES` member starting `IFCREL`), and whose own STEP record
+ * `relationshipRefsSurviveExclusion` would refuse to bridge or emit — i.e.
+ * one that names, in a single-valued attribute, an id NOT in `includedIds`
+ * (and not infrastructure), or whose every member of a SET/LIST attribute is
+ * likewise excluded. Everything ELSE in `includedIds` is left exactly as the
+ * caller passed it: this only ever REMOVES relationship ids, never adds or
+ * removes anything else.
+ *
+ * "Excluded" here is computed the same way the export's own closure would
+ * (`getSubsetEntityIds`'s `excludedIds` — every `IFC_ROOT_TYPES` /
+ * `IDENTIFYING_TYPES` id not in `includedIds`), so a relationship this
+ * function prunes is exactly one `StepExporter` would otherwise have had to
+ * withhold on its own.
+ */
+function pruneUnresolvableRelationships(store, index, includedIds) {
+    const { excludedIds } = getSubsetEntityIds(index, includedIds);
+    const isExcluded = (id) => excludedIds.has(id);
+    const relationshipIds = [...includedIds]
+        .filter((id) => (index.typeOf(id) ?? '').startsWith('IFCREL'))
+        .sort((a, b) => a - b);
+    const prunedRelationshipIds = [];
+    const finalIncludedIds = new Set(includedIds);
+    for (const id of relationshipIds) {
+        const record = readEntityArgs(store, index, id);
+        // Unreadable (no source bytes, or an unparseable line): leave it for
+        // `StepExporter`'s own gates to decide, rather than guessing here.
+        if (!record)
+            continue;
+        const groups = record.args
+            .map(refGroupFromArg)
+            .filter((g) => g !== undefined);
+        if (!relationshipRefsSurviveExclusion(groups, isExcluded)) {
+            prunedRelationshipIds.push(id);
+            finalIncludedIds.delete(id);
+        }
+    }
+    return { prunedRelationshipIds, finalIncludedIds };
+}
+/**
+ * Export `includedIds` (plus infrastructure and their forward closure — see
+ * `subset-roots.ts`) as an anonymized STEP file. Every `AnonymizeOptions`
+ * field defaults to the maximally-scrubbed direction (see that interface's
+ * own doc), so calling this with no options at all is the intended common
+ * case, not a partial anonymization a caller must opt further into.
+ *
+ * Throws when `store` has no source bytes to read entity records from — a
+ * server-parsed or synthetic store with `source.byteLength === 0` has
+ * nothing for `readEntityArgs`/`StepExporter`'s source-iteration pass to
+ * read, and every module this orchestrator calls assumes source-backed
+ * records exist for at least the infrastructure/relationship entities it
+ * touches.
+ */
+export function exportAnonymizedSubset(store, includedIds, options = {}) {
+    if (!store.source || store.source.byteLength <= 0) {
+        throw new Error('exportAnonymizedSubset: the store has no source bytes to export from '
+            + '(a server-parsed or synthetic store with source.byteLength === 0 '
+            + 'cannot be anonymized — this feature reads and rewrites the original '
+            + 'STEP records).');
+    }
+    // One private overlay for this call only — never the caller's own
+    // mutation view, and never written into `store`. See the module doc.
+    const view = new MutablePropertyView(null, 'anonymize');
+    const editor = new StoreEditor(store, view);
+    const index = getEffectiveEntityIndex(store, view, true);
+    const { prunedRelationshipIds, finalIncludedIds } = pruneUnresolvableRelationships(store, index, includedIds);
+    const placementResult = applyPlacementAnonymization(store, index, finalIncludedIds, editor, view, options);
+    const scrubResult = applyScrub(store, index, finalIncludedIds, view, options);
+    const exportResult = new StepExporter(store, view).export({
+        schema: store.schemaVersion,
+        subsetEntityIds: finalIncludedIds,
+        filename: options.filename ?? 'anonymized.ifc',
+        // Header scrub per the decision doc: author/organization/authorization
+        // blanked outright (never inherited from the source header — an empty
+        // string is a deliberate override, not "no override", per
+        // `step-header.ts`'s `??` wiring). `originating_system` is blanked under
+        // `scrubOwnerHistory` (a vendor build string such as `26.0.0 NOR FULL`
+        // encodes the licence region); `preprocessor_version` comes from
+        // `application`, left unset here (defaults to 'ifc-lite').
+        author: '',
+        organization: '',
+        authorization: '',
+        ...((options.scrubOwnerHistory ?? true) ? { originatingSystem: '' } : {}),
+        timeStamp: options.timeStamp,
+        guidRandom: options.guidRandom,
+    });
+    const includedRootEntityCount = [...finalIncludedIds]
+        .filter((id) => IFC_ROOT_TYPES.has(index.typeOf(id) ?? '')).length;
+    return {
+        content: exportResult.content,
+        guidMap: scrubResult.guidMap,
+        stats: {
+            entityCount: exportResult.stats.entityCount,
+            includedRootEntityCount,
+            prunedRelationshipIds,
+            zeroedPlacements: placementResult.zeroedPlacements,
+            warnings: [
+                ...placementResult.warnings,
+                ...scrubResult.warnings,
+                ...exportResult.stats.warnings,
+            ],
+        },
+    };
+}
+//# sourceMappingURL=anonymize-export.js.map

package/dist/anonymize-export.js.map

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

package/dist/anonymize-placement.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Root-placement zeroing and georeferencing/address blanking for the
+ * "anonymized isolated export" feature (#2934, plan section A4).
+ *
+ * Coordinates are the strongest identifying signal a reproduction carries —
+ * an absolute site position pins the model to a real address — but the
+ * ROTATION in the placement chain and any non-orthogonal cuts are exactly
+ * what a parsing bug reproduction needs to keep. So this module zeroes only
+ * the TRANSLATION of each root `IfcLocalPlacement` (`PlacementRelTo = $`),
+ * leaving `Axis`/`RefDirection` and every child placement untouched.
+ *
+ * **Clone, never rewrite.** `IfcCartesianPoint` and `IfcAxis2Placement3D` /
+ * `2D` records are routinely SHARED — two storeys placed at the same origin,
+ * or a template point reused across a model — so rewriting one in place would
+ * silently move every other placement that happens to reference the same
+ * point. Each zeroed root gets its own freshly-cloned point and axis via
+ * `StoreEditor.addEntity`, and only the root's `RelativePlacement` slot is
+ * repointed (`setPositionalAttribute`) to the clone. Nothing else in the
+ * model ever sees the edit.
+ *
+ * The same clone-and-repoint mechanism handles
+ * `IfcGeometricRepresentationContext.WorldCoordinateSystem` (a second, less
+ * obvious place a survey offset can live — #2934's plan A4 step 4) and is
+ * shared between both call sites as {@link zeroAxisPlacementSlot}.
+ *
+ * `IfcGridPlacement` / `IfcLinearPlacement` roots have no `RelativePlacement`
+ * → `IfcCartesianPoint` chain to clone against, so they are left untouched
+ * and reported as a warning rather than silently ignored or corrupted.
+ *
+ * Reads go through {@link readEntityArgs} / {@link attrIndex}
+ * (`subset-entity-reader.ts`) so a positional slot is always resolved BY
+ * EXPRESS NAME against the schema registry, never a hand-counted index that
+ * would silently drift the day an entity's attribute layout changes.
+ */
+import type { IfcSourceBytes } from '@ifc-lite/parser';
+import type { MutablePropertyView, StoreEditor } from '@ifc-lite/mutations';
+import type { EffectiveEntityIndex } from './effective-index.js';
+import type { AnonymizeOptions } from './anonymize-types.js';
+/** The slice of {@link AnonymizeOptions} this module reads. */
+export type PlacementAnonymizationOptions = Pick<AnonymizeOptions, 'zeroRootPlacement' | 'removeGeoreferencing'>;
+/** What {@link applyPlacementAnonymization} did — folded into
+ *  `AnonymizeResult.stats` by the orchestrator (`anonymize-export.ts`). */
+export interface PlacementAnonymizationResult {
+    /** Each root `IfcLocalPlacement` this call zeroed, and the ORIGINAL
+     *  (pre-zero) translation it removed. */
+    zeroedPlacements: {
+        expressId: number;
+        translation: number[];
+    }[];
+    /** Non-fatal notices: an unsupported root placement kind, an unreadable
+     *  chain, multiple roots collapsing onto one origin, or a chain this walk
+     *  bounded before it reached one (256-hop cap, see "Bounding walks over
+     *  file-supplied references", AGENTS.md). */
+    warnings: string[];
+}
+/**
+ * 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 declare function applyPlacementAnonymization(store: {
+    readonly source: IfcSourceBytes;
+}, index: EffectiveEntityIndex, includedIds: ReadonlySet<number>, editor: StoreEditor, view: MutablePropertyView, opts?: PlacementAnonymizationOptions): PlacementAnonymizationResult;
+//# sourceMappingURL=anonymize-placement.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"anonymize-placement.d.ts","sourceRoot":"","sources":["../src/anonymize-placement.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAE5E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAK7D,+DAA+D;AAC/D,MAAM,MAAM,6BAA6B,GAAG,IAAI,CAC9C,gBAAgB,EAChB,mBAAmB,GAAG,sBAAsB,CAC7C,CAAC;AAEF;2EAC2E;AAC3E,MAAM,WAAW,4BAA4B;IAC3C;6CACyC;IACzC,gBAAgB,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;IACjE;;;iDAG6C;IAC7C,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAUD;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;CAAE,EAC1C,KAAK,EAAE,oBAAoB,EAC3B,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,EAChC,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,mBAAmB,EACzB,IAAI,CAAC,EAAE,6BAA6B,GACnC,4BAA4B,CAc9B"}

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: they
+ * are `IDENTIFYING_TYPES` (`subset-roots.ts`), excluded from the export
+ * outright, and only inverse-referenced from these fields — so they are
+ * simply absent from the output once nothing still points at them.
+ *
+ * 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":"AAAA;;+DAE+D;AA0C/D,OAAO,EAAE,SAAS,EAAE,cAAc,EAA6B,MAAM,2BAA2B,CAAC;AACjG,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAqB9D,MAAM,2BAA2B,GAAG;IAClC,aAAa;IACb,cAAc;IACd,cAAc;IACd,iBAAiB;IACjB,aAAa;CACL,CAAC;AAEX;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,2BAA2B,CACzC,KAA0C,EAC1C,KAA2B,EAC3B,WAAgC,EAChC,MAAmB,EACnB,IAAyB,EACzB,IAAoC;IAEpC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,gBAAgB,GAAmD,EAAE,CAAC;IAE5E,IAAI,IAAI,EAAE,iBAAiB,KAAK,KAAK,EAAE,CAAC;QACtC,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAAC;QAClF,0BAA0B,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC7D,CAAC;IAED,IAAI,IAAI,EAAE,oBAAoB,KAAK,KAAK,EAAE,CAAC;QACzC,6BAA6B,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;IAC1D,CAAC;IAED,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,CAAC;AACxC,CAAC;AAWD,SAAS,kBAAkB,CACzB,KAA0C,EAC1C,KAA2B,EAC3B,WAAgC,EAChC,MAAmB,EACnB,QAAkB,EAClB,gBAAgE;IAEhE,yEAAyE;IACzE,2EAA2E;IAC3E,mEAAmE;IACnE,sEAAsE;IACtE,6CAA6C;IAC7C,MAAM,SAAS,GAAG,IAAI,GAAG,EAAgC,CAAC;IAC1D,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAAU,CAAC;IAE9C,KAAK,MAAM,EAAE,IAAI,WAAW,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QAC7C,IAAI,CAAC,GAAG;YAAE,SAAS;QACnB,MAAM,kBAAkB,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,oIAAoI;QACvM,IAAI,kBAAkB,GAAG,CAAC,IAAI,kBAAkB,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM;YAAE,SAAS;QAC9E,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC;QAC3D,IAAI,WAAW,KAAK,IAAI;YAAE,SAAS;QAEnC,IAAI,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACtC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,IAAI,GAAG,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;YAC9D,SAAS,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QACnC,CAAC;QACD,IAAI,CAAC,IAAI;YAAE,SAAS;QAEpB,IAAI,IAAI,CAAC,QAAQ,KAAK,mBAAmB,EAAE,CAAC;YAC1C,QAAQ,CAAC,IAAI,CACX,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,QAAQ,uDAAuD;gBACtF,uGAAuG,CAC1G,CAAC;YACF,SAAS;QACX,CAAC;QACD,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,mBAAmB,EAAE,CAAC;QACzC,MAAM,WAAW,GAAG,qBAAqB,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,QAAQ,CAAC,CAAC;QAC5H,IAAI,WAAW;YAAE,gBAAgB,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,QAAQ,CAAC,IAAI,CACX,GAAG,gBAAgB,CAAC,MAAM,+DAA+D;YACvF,mEAAmE,CACtE,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,iBAAiB,CACxB,KAA0C,EAC1C,KAA2B,EAC3B,gBAAwB,EACxB,QAAkB;IAElB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,IAAI,SAAS,GAAG,gBAAgB,CAAC;IACjC,IAAI,IAAI,GAAG,CAAC,CAAC;IAEb,SAAS,CAAC;QACR,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3B,QAAQ,CAAC,IAAI,CACX,yBAAyB,gBAAgB,cAAc,SAAS,0CAA0C,CAC3G,CAAC;YACF,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACvB,IAAI,EAAE,CAAC;QACP,IAAI,IAAI,GAAG,GAAG,EAAE,CAAC;YACf,QAAQ,CAAC,IAAI,CACX,yBAAyB,gBAAgB,sEAAsE,CAChH,CAAC;YACF,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,GAAG,GAAG,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;QACpD,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,QAAQ,CAAC,IAAI,CACX,cAAc,SAAS,uBAAuB,gBAAgB,qCAAqC,CACpG,CAAC;YACF,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,GAAG,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;YACrC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;QACnD,CAAC;QAED,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,sGAAsG;QAC9J,MAAM,QAAQ,GAAG,QAAQ,IAAI,CAAC,IAAI,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACnG,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;QACnD,CAAC;QACD,SAAS,GAAG,QAAQ,CAAC;IACvB,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,0DAA0D;AAC1D,8EAA8E;AAE9E;;;;;;;GAOG;AACH,SAAS,0BAA0B,CACjC,KAA0C,EAC1C,KAA2B,EAC3B,MAAmB,EACnB,QAAkB;IAElB,KAAK,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,KAAK,EAAE,CAAC;QAC9B,IAAI,KAAK,CAAC,aAAa,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,mCAAmC;YAAE,SAAS;QACxF,qEAAqE;QACrE,0DAA0D;QAC1D,oEAAoE;QACpE,qBAAqB,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,mCAAmC,EAAE,uBAAuB,EAAE,QAAQ,CAAC,CAAC;IAC1H,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,qCAAqC;AACrC,8EAA8E;AAE9E;;;;;;;;;;GAUG;AACH,SAAS,qBAAqB,CAC5B,KAA0C,EAC1C,KAA2B,EAC3B,MAAmB,EACnB,QAAgB,EAChB,UAAkB,EAClB,QAAgB,EAChB,QAAkB;IAElB,MAAM,OAAO,GAAG,SAAS,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,mGAAmG;IACpJ,IAAI,OAAO,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAE7B,MAAM,GAAG,GAAG,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IACnD,IAAI,CAAC,GAAG,IAAI,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACpD,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3C,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC,CAAC,qCAAqC;IAEvE,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IACrD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,QAAQ,CAAC,IAAI,CACX,IAAI,QAAQ,IAAI,QAAQ,gBAAgB,MAAM,4CAA4C,CAC3F,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,KAAK,qBAAqB,CAAC;IACpD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,KAAK,qBAAqB,CAAC;IACpD,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACnB,QAAQ,CAAC,IAAI,CACX,IAAI,QAAQ,IAAI,QAAQ,iBAAiB,MAAM,KAAK,OAAO,CAAC,IAAI,YAAY;YAC1E,yCAAyC,CAC5C,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,WAAW,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,mFAAmF;IAC5I,MAAM,OAAO,GAAG,WAAW,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9E,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAElC,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACvD,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;QACvD,QAAQ,CAAC,IAAI,CACX,IAAI,QAAQ,IAAI,QAAQ,OAAO,MAAM,gBAAgB,OAAO,+CAA+C,CAC5G,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAAG,mBAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,oCAAoC;IAE9F,sDAAsD;IACtD,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,mBAAmB,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAExF,2EAA2E;IAC3E,6DAA6D;IAC7D,MAAM,YAAY,GAAwB,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;IAC1E,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,CAAC,CAAE,CAAC,MAAM,EAAE,cAAc,CAAW,CAAC,CAAC,CAAE,CAAC,cAAc,CAAW,EAAE,CAAC;QAC5F,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,8CAA8C;QACzF,YAAY,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACvE,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,qBAAqB,EAAE,YAAY,CAAC,CAAC;IAErG,MAAM,CAAC,sBAAsB,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;IAC/E,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,8EAA8E;AAC9E,0DAA0D;AAC1D,8EAA8E;AAE9E;;;;;;;;;;GAUG;AACH,SAAS,6BAA6B,CACpC,KAA2B,EAC3B,WAAgC,EAChC,IAAyB;IAEzB,KAAK,MAAM,EAAE,IAAI,WAAW,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC9B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,KAAK,MAAM,IAAI,IAAI,2BAA2B,EAAE,CAAC;gBAC/C,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,uEAAuE;gBAC1G,IAAI,GAAG,IAAI,CAAC;oBAAE,IAAI,CAAC,sBAAsB,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC;aAAM,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;YAClC,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,+CAA+C;YAC/F,IAAI,GAAG,IAAI,CAAC;gBAAE,IAAI,CAAC,sBAAsB,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E,wEAAwE;AACxE,SAAS,QAAQ,CAAC,KAAyB;IACzC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5C,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACzC,CAAC;AAED;;4DAE4D;AAC5D,SAAS,YAAY,CAAC,KAAyB;IAC7C,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,OAAO,KAAK,GAAG,IAAI,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;AAC5D,CAAC;AAED;;;qBAGqB;AACrB,SAAS,mBAAmB,CAAC,KAAyB;IACpD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACpE,MAAM,OAAO,GAAG,iBAAiB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC3F,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AACnE,CAAC"}