@ifc-lite/export 2.5.3 → 2.7.0

package/dist/attribute-real-slots.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Schema-aware detection of REAL-typed STEP attribute slots.
+ *
+ * ISO 10303-21 requires a REAL-typed attribute (`IfcLengthMeasure` and every
+ * other `<real>`-backed defined type) to carry a decimal point — `450.`, never
+ * `450`. A bare JavaScript number is ambiguous at the value level (it could be
+ * an `IfcInteger`), so `serializeStepValue` defaults to emitting whole numbers
+ * as STEP INTEGER literals. That default silently produces strict-invalid files
+ * whenever a whole number lands in a REAL slot — the natural
+ * `setPositionalAttribute(profId, 3, 450)` call, `addEntity` args, and the
+ * geometry the in-store builders emit themselves (millimetre models round to
+ * whole numbers, making this the common case). See LTplus-AG/ifc-lite#1839.
+ *
+ * The slot's declared type is statically known from the schema registry, so we
+ * resolve it once per (entity, version) and force a REAL literal on those slots
+ * at serialization time — no caller change, no `{ real }` marker required.
+ */
+import type { IfcAttributeValue } from '@ifc-lite/parser';
+import type { IfcSchemaVersion } from './schema-converter.js';
+/**
+ * True for the write-only `{ real }` / `{ typed }` markers — an explicit caller
+ * intent that `serializeStepValue` handles directly and that must bypass the
+ * schema-driven SELECT/REAL inference below.
+ */
+export declare function isTypedMarker(value: IfcAttributeValue): boolean;
+/**
+ * Serialize one positional attribute slot to its STEP token, composing the
+ * schema-aware passes in priority order:
+ *   1. an explicit `{ real }` / `{ typed }` marker wins outright;
+ *   2. a SELECT slot auto-qualifies an unambiguous bare value (`IFCBOOLEAN(.T.)`);
+ *   3. otherwise a REAL-backed slot forces a decimal point (#1839);
+ *   4. otherwise the default value serialization.
+ */
+export declare function serializeAttributeSlot(entityType: string, index: number, value: IfcAttributeValue, version: IfcSchemaVersion): string;
+/**
+ * The set of zero-based positional attribute indices on `entityType` whose
+ * declared type is unambiguously REAL-backed (`xs:double`, and NOT also
+ * `xs:integer`). An index that also admits an integer — a genuine
+ * `SELECT(IfcInteger, IfcReal)` — stays out of the set: it is truly ambiguous,
+ * and the explicit `{ real }` marker is the caller's way to disambiguate it.
+ *
+ * Returns an empty set for entities the registry does not know (vendor
+ * extensions, unmapped schema), preserving the historical default there.
+ */
+export declare function getRealTypedSlots(entityType: string, version: IfcSchemaVersion): Set<number>;
+/**
+ * Serialize a full positional attribute list for an entity to a STEP body,
+ * schema-aware per slot (SELECT qualification + REAL forcing). Used for
+ * freshly-emitted overlay entities (`addEntity`, the in-store builders) whose
+ * numbers never pass through a source token.
+ */
+export declare function serializeEntityArgs(entityType: string, values: readonly IfcAttributeValue[], version: IfcSchemaVersion): string;
+//# sourceMappingURL=attribute-real-slots.d.ts.map

package/dist/attribute-real-slots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attribute-real-slots.d.ts","sourceRoot":"","sources":["../src/attribute-real-slots.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAI9D;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAO/D;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,gBAAgB,GACxB,MAAM,CAKR;AA0BD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,GAAG,CAAC,MAAM,CAAC,CAsB5F;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,SAAS,iBAAiB,EAAE,EACpC,OAAO,EAAE,gBAAgB,GACxB,MAAM,CAER"}

package/dist/attribute-real-slots.js

@@ -0,0 +1,99 @@
+/* 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 { getAttributeNamesAcrossSchemas } from '@ifc-lite/parser';
+import { getAttributeXsdTypes } from '@ifc-lite/data';
+import { serializeStepValue } from './step-serialization.js';
+import { serializeQualifiedSelectSlot } from './select-qualification.js';
+/**
+ * True for the write-only `{ real }` / `{ typed }` markers — an explicit caller
+ * intent that `serializeStepValue` handles directly and that must bypass the
+ * schema-driven SELECT/REAL inference below.
+ */
+export function isTypedMarker(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        !Array.isArray(value) &&
+        ('real' in value || 'typed' in value));
+}
+/**
+ * Serialize one positional attribute slot to its STEP token, composing the
+ * schema-aware passes in priority order:
+ *   1. an explicit `{ real }` / `{ typed }` marker wins outright;
+ *   2. a SELECT slot auto-qualifies an unambiguous bare value (`IFCBOOLEAN(.T.)`);
+ *   3. otherwise a REAL-backed slot forces a decimal point (#1839);
+ *   4. otherwise the default value serialization.
+ */
+export function serializeAttributeSlot(entityType, index, value, version) {
+    if (isTypedMarker(value))
+        return serializeStepValue(value);
+    const qualified = serializeQualifiedSelectSlot(entityType, index, value);
+    if (qualified !== null)
+        return qualified;
+    return serializeStepValue(value, getRealTypedSlots(entityType, version).has(index));
+}
+/**
+ * Map the exporter's schema tag to the version the attribute XSD index is keyed
+ * by. `IFC4X3_ADD2` is not an exporter tag; `IFC5` has no bundled XSD table.
+ * REAL-vs-INTEGER of a geometry slot is version-invariant, so any unmapped tag
+ * falls back to IFC4 — a slot missing from that version simply won't be forced.
+ */
+function toDataSchemaVersion(v) {
+    switch (v) {
+        case 'IFC2X3':
+            return 'IFC2X3';
+        case 'IFC4X3':
+            return 'IFC4X3';
+        case 'IFC4':
+            return 'IFC4';
+        default:
+            return 'IFC4';
+    }
+}
+// Memoized `version|ENTITY` → set of positional slot indices that are
+// unambiguously REAL-backed. Keyed by upper-case type so `IfcColumn`/`IFCCOLUMN`
+// collapse to one entry.
+const realSlotCache = new Map();
+/**
+ * The set of zero-based positional attribute indices on `entityType` whose
+ * declared type is unambiguously REAL-backed (`xs:double`, and NOT also
+ * `xs:integer`). An index that also admits an integer — a genuine
+ * `SELECT(IfcInteger, IfcReal)` — stays out of the set: it is truly ambiguous,
+ * and the explicit `{ real }` marker is the caller's way to disambiguate it.
+ *
+ * Returns an empty set for entities the registry does not know (vendor
+ * extensions, unmapped schema), preserving the historical default there.
+ */
+export function getRealTypedSlots(entityType, version) {
+    const dataVersion = toDataSchemaVersion(version);
+    const upperType = entityType.toUpperCase();
+    const key = `${dataVersion}|${upperType}`;
+    const cached = realSlotCache.get(key);
+    if (cached)
+        return cached;
+    // Resolve positional names across the bundled schema union (2X3 + 4 + 4X3),
+    // not just the parser's IFC4-pinned registry — otherwise IFC4X3-only leaves
+    // (IfcAlignmentHorizontalSegment and the civil/alignment geometry this fix
+    // targets) return no names, and their REAL slots (StartDirection,
+    // SegmentLength, …) would still emit bare INTEGER literals.
+    const names = getAttributeNamesAcrossSchemas(entityType);
+    const slots = new Set();
+    for (let i = 0; i < names.length; i++) {
+        const xsd = getAttributeXsdTypes(dataVersion, upperType, names[i]);
+        if (xsd && xsd.includes('xs:double') && !xsd.includes('xs:integer')) {
+            slots.add(i);
+        }
+    }
+    realSlotCache.set(key, slots);
+    return slots;
+}
+/**
+ * Serialize a full positional attribute list for an entity to a STEP body,
+ * schema-aware per slot (SELECT qualification + REAL forcing). Used for
+ * freshly-emitted overlay entities (`addEntity`, the in-store builders) whose
+ * numbers never pass through a source token.
+ */
+export function serializeEntityArgs(entityType, values, version) {
+    return values.map((value, i) => serializeAttributeSlot(entityType, i, value, version)).join(',');
+}
+//# sourceMappingURL=attribute-real-slots.js.map

package/dist/attribute-real-slots.js.map

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

package/dist/demesh-prune.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Demesher prune: ONE global reverse-reference mark-and-sweep over the
+ * replaced products' detached geometry subgraphs (see `demesh-writer.ts` for
+ * the authoring side). An old geometry entity is tombstoned only when every
+ * entity that references it is itself being tombstoned, so shared
+ * representations (`IfcMappedItem` sources, an `IfcProductDefinitionShape`
+ * shared by several products) and type-library geometry survive partial
+ * selections by construction.
+ *
+ * The reverse index is built from the UNMODIFIED source bytes via the
+ * string-literal-aware `#N` scanner in `reference-collector.ts`; overlay
+ * entities added by the writer are invisible to it, which is why shared
+ * infrastructure (`PROTECTED_TYPES`) must never fall even when orphaned.
+ */
+import { type IfcDataStore } from '@ifc-lite/parser';
+import type { DemeshApplyReport, DemeshEditorLike } from './demesh-writer.js';
+/**
+ * Global reverse-reference mark-and-sweep over the replaced products' old
+ * geometry subgraphs (see the module doc). Also strips void relationships
+ * for replaced hosts and filters `IfcPresentationLayerAssignment` item
+ * lists that pointed at pruned geometry.
+ */
+export declare function pruneReplacedSubgraphs(store: IfcDataStore, editor: DemeshEditorLike, replacedOldRep: Map<number, number | null>, stripOpenings: boolean, report: DemeshApplyReport): void;
+//# sourceMappingURL=demesh-prune.d.ts.map

package/dist/demesh-prune.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"demesh-prune.d.ts","sourceRoot":"","sources":["../src/demesh-prune.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAqB9E;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,gBAAgB,EACxB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,EAC1C,aAAa,EAAE,OAAO,EACtB,MAAM,EAAE,iBAAiB,GACxB,IAAI,CAqIN"}

package/dist/demesh-prune.js

@@ -0,0 +1,185 @@
+/* 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/. */
+/**
+ * Demesher prune: ONE global reverse-reference mark-and-sweep over the
+ * replaced products' detached geometry subgraphs (see `demesh-writer.ts` for
+ * the authoring side). An old geometry entity is tombstoned only when every
+ * entity that references it is itself being tombstoned, so shared
+ * representations (`IfcMappedItem` sources, an `IfcProductDefinitionShape`
+ * shared by several products) and type-library geometry survive partial
+ * selections by construction.
+ *
+ * The reverse index is built from the UNMODIFIED source bytes via the
+ * string-literal-aware `#N` scanner in `reference-collector.ts`; overlay
+ * entities added by the writer are invisible to it, which is why shared
+ * infrastructure (`PROTECTED_TYPES`) must never fall even when orphaned.
+ */
+import { EntityExtractor } from '@ifc-lite/parser';
+import { collectReferencedEntityIds, collectRefsInByteRange } from './reference-collector.js';
+/**
+ * Entity types the sweep must never tombstone even when they fall inside a
+ * replaced subgraph's closure: shared model infrastructure that the NEW
+ * overlay entities (invisible to the source-byte reverse index) or the rest
+ * of the file may reference.
+ */
+const PROTECTED_TYPES = new Set([
+    'IFCGEOMETRICREPRESENTATIONCONTEXT',
+    'IFCGEOMETRICREPRESENTATIONSUBCONTEXT',
+    'IFCUNITASSIGNMENT',
+    'IFCSIUNIT',
+    'IFCCONVERSIONBASEDUNIT',
+    'IFCOWNERHISTORY',
+    'IFCPERSON',
+    'IFCORGANIZATION',
+    'IFCPERSONANDORGANIZATION',
+    'IFCAPPLICATION',
+]);
+/**
+ * Global reverse-reference mark-and-sweep over the replaced products' old
+ * geometry subgraphs (see the module doc). Also strips void relationships
+ * for replaced hosts and filters `IfcPresentationLayerAssignment` item
+ * lists that pointed at pruned geometry.
+ */
+export function pruneReplacedSubgraphs(store, editor, replacedOldRep, stripOpenings, report) {
+    const source = store.source;
+    const byId = store.entityIndex.byId;
+    const extractor = new EntityExtractor(source);
+    const indexAdapter = {
+        get: (id) => byId.get(id),
+        has: (id) => byId.has(id),
+    };
+    // -- Roots: the detached representation subgraphs.
+    const roots = new Set();
+    for (const oldRep of replacedOldRep.values()) {
+        if (oldRep !== null && byId.has(oldRep))
+            roots.add(oldRep);
+    }
+    // -- Openings of replaced hosts: the rel is deleted outright (its cut is
+    // baked into the new mesh); the opening element and its geometry join the
+    // candidate closure and fall to the ordinary sweep.
+    const deleted = new Set();
+    if (stripOpenings) {
+        for (const [id, ref] of byId) {
+            if (ref.type.toUpperCase() !== 'IFCRELVOIDSELEMENT')
+                continue;
+            const rel = extractor.extractEntity(ref);
+            const relating = rel?.attributes?.[4];
+            const opening = rel?.attributes?.[5];
+            if (typeof relating !== 'number' || !replacedOldRep.has(relating))
+                continue;
+            deleted.add(id);
+            if (typeof opening === 'number' && byId.has(opening)) {
+                roots.add(opening);
+            }
+        }
+    }
+    if (roots.size === 0 && deleted.size === 0)
+        return;
+    // -- Candidate closure: everything transitively reachable from the roots.
+    const closure = collectReferencedEntityIds(roots, source, indexAdapter);
+    // Style/annotation entities hang OFF the geometry (IfcStyledItem.Item →
+    // geometry item), so forward reachability misses them; pull in styled
+    // items whose target is in the closure, plus what they reference (shared
+    // surface styles survive via their other referrers).
+    const styledItemRoots = new Set();
+    for (const [id, ref] of byId) {
+        if (closure.has(id) || ref.type.toUpperCase() !== 'IFCSTYLEDITEM')
+            continue;
+        const refs = collectRefsInByteRange(source, ref.byteOffset, ref.byteLength);
+        if (refs.some((target) => target !== id && closure.has(target))) {
+            styledItemRoots.add(id);
+        }
+    }
+    if (styledItemRoots.size > 0) {
+        for (const id of collectReferencedEntityIds(styledItemRoots, source, indexAdapter)) {
+            closure.add(id);
+        }
+    }
+    // -- Reverse-reference index, restricted to edges INTO the closure.
+    const referrers = new Map();
+    for (const [id, ref] of byId) {
+        // Presentation layers ANNOTATE geometry, they don't own it: counting
+        // their edges as referrers would keep replaced geometry alive forever
+        // (the layer itself is outside the closure and never falls), defeating
+        // the AssignedItems filtering below. Skip them so layer-only-referenced
+        // geometry prunes and the filter then cleans the surviving layer's list.
+        if (ref.type.toUpperCase() === 'IFCPRESENTATIONLAYERASSIGNMENT')
+            continue;
+        const refs = collectRefsInByteRange(source, ref.byteOffset, ref.byteLength);
+        for (const target of refs) {
+            if (target === id || !closure.has(target))
+                continue;
+            let set = referrers.get(target);
+            if (!set) {
+                set = new Set();
+                referrers.set(target, set);
+            }
+            set.add(id);
+        }
+    }
+    // The representation swap detached product → old-PDS: remove those edges
+    // (the reverse index was built from the unmodified source bytes).
+    for (const [productId, oldRep] of replacedOldRep) {
+        if (oldRep !== null)
+            referrers.get(oldRep)?.delete(productId);
+    }
+    // -- Sweep to fixpoint: tombstone an entity once every referrer is
+    // tombstoned. Protected infrastructure never falls, even if orphaned.
+    let changed = true;
+    while (changed) {
+        changed = false;
+        for (const id of closure) {
+            if (deleted.has(id))
+                continue;
+            const ref = byId.get(id);
+            if (!ref || PROTECTED_TYPES.has(ref.type.toUpperCase()))
+                continue;
+            const incoming = referrers.get(id);
+            let live = false;
+            if (incoming) {
+                for (const from of incoming) {
+                    if (!deleted.has(from)) {
+                        live = true;
+                        break;
+                    }
+                }
+            }
+            if (!live) {
+                deleted.add(id);
+                changed = true;
+            }
+        }
+    }
+    // -- Apply tombstones.
+    let openingCount = 0;
+    for (const id of deleted) {
+        const type = byId.get(id)?.type.toUpperCase();
+        if (type === 'IFCRELVOIDSELEMENT' || type === 'IFCOPENINGELEMENT')
+            openingCount++;
+        if (editor.removeEntity(id))
+            report.prunedEntityCount++;
+    }
+    report.strippedOpeningCount = openingCount;
+    // -- Presentation layers: filter tombstoned items out of AssignedItems;
+    // a layer left empty is tombstoned too (an empty list is schema-invalid).
+    for (const [id, ref] of byId) {
+        if (deleted.has(id) || ref.type.toUpperCase() !== 'IFCPRESENTATIONLAYERASSIGNMENT')
+            continue;
+        const layer = extractor.extractEntity(ref);
+        const items = layer?.attributes?.[2];
+        if (!Array.isArray(items))
+            continue;
+        const kept = items.filter((item) => typeof item === 'number' && !deleted.has(item));
+        if (kept.length === items.length)
+            continue;
+        if (kept.length === 0) {
+            if (editor.removeEntity(id))
+                report.prunedEntityCount++;
+        }
+        else {
+            editor.setPositionalAttribute(id, 2, kept.map((item) => `#${item}`));
+        }
+    }
+}
+//# sourceMappingURL=demesh-prune.js.map

package/dist/demesh-prune.js.map

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

package/dist/demesh-session.d.ts

@@ -0,0 +1,136 @@
+/**
+ * DemeshSession — interactive selective mesh simplification with deferred
+ * IFC export (the "demesher").
+ *
+ * Workflow (one session per loaded model):
+ *   1. `simplify(expressIds)` — each call escalates the selection one level
+ *      (1-4 = cavity removal + vertex-clustering decimation at
+ *      0.5/0.25/0.10/0.03 triangle ratio, 5 = bounding box). Simplification
+ *      ALWAYS re-runs from the ORIGINAL meshes at the new level — quality
+ *      never degrades cumulatively, and `reset()` is trivial. The returned
+ *      render meshes go straight into the scene:
+ *      `scene.removeMeshesForEntities(ids)` + `scene.addMeshes(renderMeshes)`.
+ *   2. `exportIfc()` — separately, when the user is done: loads the original
+ *      bytes into a store, swaps each simplified element's representation
+ *      for an `IfcTriangulatedFaceSet` (via `applySimplifiedGeometry`),
+ *      prunes the orphaned geometry, and writes the lighter IFC. IFC2X3
+ *      sources are upconverted to IFC4 first (`IfcTriangulatedFaceSet` is
+ *      IFC4+).
+ *
+ * The model file is parsed at most twice per session (once for meshes unless
+ * the caller supplies the ones it already holds, once at export); button
+ * presses between those touch only mesh data in wasm.
+ */
+import { GeometryProcessor, type MeshData } from '@ifc-lite/geometry';
+import { type DemeshApplyReport } from './demesh-writer.js';
+export interface DemeshSessionOptions {
+    /**
+     * Already-produced meshes for this model (the viewer's `MeshData[]`) —
+     * supply them together with `originShift` from the load's
+     * `coordinateInfo` to skip the session's own meshing pass. When omitted,
+     * the session meshes the bytes itself on first use.
+     */
+    meshes?: MeshData[];
+    /** `coordinateInfo.originShift` of the load that produced `meshes`. */
+    originShift?: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    /** Metres per project length unit; extracted from the file when omitted. */
+    unitScale?: number;
+    /** Reuse the app's initialized GeometryProcessor instead of creating one. */
+    geometryProcessor?: GeometryProcessor;
+}
+export interface DemeshSimplifyResult {
+    /** Replacement render meshes for the scene (one per simplified element). */
+    renderMeshes: MeshData[];
+    /** Per-element outcome, including the level now applied. */
+    elements: Array<{
+        expressId: number;
+        level: number;
+        trisBefore: number;
+        trisAfter: number;
+        cavitiesDropped: number;
+    }>;
+    /** Elements that could not be simplified (keep their original meshes). */
+    skipped: Array<{
+        expressId: number;
+        reason: string;
+    }>;
+}
+export interface DemeshExportResult {
+    bytes: Uint8Array;
+    report: DemeshApplyReport;
+    /** True when an IFC2X3 source was upconverted to IFC4 for the export. */
+    upconverted: boolean;
+    bytesBefore: number;
+    bytesAfter: number;
+}
+export declare class DemeshSession {
+    private readonly source;
+    private readonly options;
+    private gp;
+    private ownsGp;
+    private meshes;
+    private originShift;
+    private unitScale;
+    private gpPromise;
+    private meshesPromise;
+    private unitScalePromise;
+    /** expressId -> state of the CURRENT simplification (from-original). */
+    private readonly applied;
+    constructor(source: Uint8Array | ArrayBuffer, options?: DemeshSessionOptions);
+    /** The level currently applied to an element (0 = untouched). */
+    levelOf(expressId: number): number;
+    /**
+     * The coordinate-frame shift of the meshes this session works with (the
+     * supplied `originShift`, or the session's own load's after self-meshing).
+     * A viewer whose scene uses a different anchor (multi-model federation
+     * with a shared RTC) translates render-mesh origins by the difference.
+     */
+    getOriginShift(): {
+        x: number;
+        y: number;
+        z: number;
+    };
+    /**
+     * The ORIGINAL mesh records of `expressIds` (session frame, untouched by
+     * any simplification) — lets a viewer restore an element's real geometry
+     * in the scene after `reset()`. Meshes the source on first use.
+     */
+    originalMeshesFor(expressIds: number[]): Promise<MeshData[]>;
+    /** Express ids currently carrying simplified geometry. */
+    simplifiedIds(): number[];
+    /**
+     * Simplify `expressIds` at `level`, or — when `level` is omitted — one
+     * level past each element's current one (the button behavior: press,
+     * press again, ...; capped at 5).
+     */
+    simplify(expressIds: number[], level?: number): Promise<DemeshSimplifyResult>;
+    /**
+     * Forget the simplification state for `expressIds` (all when omitted).
+     * The caller restores the elements' original meshes in the scene.
+     */
+    reset(expressIds?: number[]): void;
+    /**
+     * The `n` heaviest elements by triangle count — demesh candidates for the
+     * UI. Requires meshes (supplied or produced on first `simplify`).
+     */
+    heaviest(n: number): Promise<Array<{
+        expressId: number;
+        triangles: number;
+    }>>;
+    /**
+     * Write the lighter IFC: original bytes + tessellated replacements for
+     * every currently simplified element. Does not mutate session state — the
+     * user can keep simplifying and export again.
+     */
+    exportIfc(): Promise<DemeshExportResult>;
+    /** Release the session's own GeometryProcessor (a shared one is untouched). */
+    destroy(): void;
+    private ensureProcessor;
+    private ensureMeshes;
+    private ensureUnitScale;
+}
+//# sourceMappingURL=demesh-session.d.ts.map

package/dist/demesh-session.d.ts.map

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