@ifc-lite/geometry 7.7.0 → 7.9.0

package/dist/prepass-routing.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Pure planning helpers of the parallel pipeline (moved out of
+ * `geometry-parallel.ts`, which re-exports them): the pre-pass class-byte span
+ * lists and content-affinity job routing.
+ */
+/**
+ * Prepass class-byte layout, mirroring the `PREPASS_CLASS_*` definitions in
+ * `rust/processing/src/shard_classes.rs` (the source of truth — these are
+ * pinned to it by `prepass-class-spans.test.ts`).
+ *
+ * The producer packs a named code in the LOW bits and composes FLAG bits on
+ * top (`PREPASS_CLASS_FLAG_GEOMETRY_JOB` 0x80, `..._FLAG_TYPE_CANDIDATE`
+ * 0x40), so a consumer must mask before comparing — the Rust consumer does
+ * (`gpu_meshes/prepass_discovery.rs`), and so does {@link extractPrepassSpanLists}.
+ */
+export declare const PREPASS_CLASS_CODE_MASK = 63;
+/** `IFCSTYLEDITEM`. */
+export declare const PREPASS_CLASS_STYLED_ITEM = 4;
+/** `IFCINDEXEDCOLOURMAP`. */
+export declare const PREPASS_CLASS_INDEXED_COLOUR_MAP = 5;
+/** `IFCMATERIALDEFINITIONREPRESENTATION`. */
+export declare const PREPASS_CLASS_MATERIAL_DEF_REPR = 6;
+/** `IFCRELASSOCIATESMATERIAL`. */
+export declare const PREPASS_CLASS_REL_ASSOCIATES_MATERIAL = 7;
+/** `IFCRELVOIDSELEMENT`. */
+export declare const PREPASS_CLASS_REL_VOIDS = 8;
+/** `IFCRELFILLSELEMENT`. */
+export declare const PREPASS_CLASS_REL_FILLS = 9;
+/** `IFCRELAGGREGATES`. */
+export declare const PREPASS_CLASS_REL_AGGREGATES = 10;
+/**
+ * Build one `(id, start, length)` span list per host-consumed prepass class
+ * from the stitched shard columns, in FILE ORDER. Every comparison goes
+ * through {@link PREPASS_CLASS_CODE_MASK}, so a record that carries a flag bit
+ * alongside its named code still lands in its list instead of being dropped.
+ * Returns exact-size arrays (one entry per class in `HOST_SPAN_CLASSES`,
+ * empty when the file has none).
+ */
+export declare function extractPrepassSpanLists(classes: Uint8Array, ids: Uint32Array, starts: Uint32Array, lengths: Uint32Array): Map<number, Uint32Array>;
+/**
+ * Plan content-affinity routing for one chunk: assign each job (by index) to a
+ * worker bucket so that every job sharing an affinity key lands on the SAME
+ * worker — across the whole stream, since `keyToWorker` is the caller's sticky
+ * map. New keys are handed out round-robin from `startWorker`, so each worker
+ * owns roughly `1/workerCount` of the distinct keys (≈ distinct geometries, the
+ * dominant meshing cost). Pure: mutates only the passed `keyToWorker` and returns
+ * the advanced round-robin cursor. (#1130 follow-up — see `affinity_key` in Rust.)
+ */
+export declare function planAffinityRouting(affinity: Uint32Array, totalJobs: number, workerCount: number, keyToWorker: Map<number, number>, startWorker: number): {
+    buckets: number[][];
+    nextWorker: number;
+};
+//# sourceMappingURL=prepass-routing.d.ts.map

package/dist/prepass-routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepass-routing.d.ts","sourceRoot":"","sources":["../src/prepass-routing.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB,KAAO,CAAC;AAC5C,uBAAuB;AACvB,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAC3C,6BAA6B;AAC7B,eAAO,MAAM,gCAAgC,IAAI,CAAC;AAClD,6CAA6C;AAC7C,eAAO,MAAM,+BAA+B,IAAI,CAAC;AACjD,kCAAkC;AAClC,eAAO,MAAM,qCAAqC,IAAI,CAAC;AACvD,4BAA4B;AAC5B,eAAO,MAAM,uBAAuB,IAAI,CAAC;AACzC,4BAA4B;AAC5B,eAAO,MAAM,uBAAuB,IAAI,CAAC;AACzC,0BAA0B;AAC1B,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAa/C;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,UAAU,EACnB,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,WAAW,GACnB,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAmB1B;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,WAAW,EACrB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,WAAW,EAAE,MAAM,GAClB;IAAE,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAc7C"}

package/dist/prepass-routing.js

@@ -0,0 +1,100 @@
+/* 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/. */
+/**
+ * Pure planning helpers of the parallel pipeline (moved out of
+ * `geometry-parallel.ts`, which re-exports them): the pre-pass class-byte span
+ * lists and content-affinity job routing.
+ */
+/**
+ * Prepass class-byte layout, mirroring the `PREPASS_CLASS_*` definitions in
+ * `rust/processing/src/shard_classes.rs` (the source of truth — these are
+ * pinned to it by `prepass-class-spans.test.ts`).
+ *
+ * The producer packs a named code in the LOW bits and composes FLAG bits on
+ * top (`PREPASS_CLASS_FLAG_GEOMETRY_JOB` 0x80, `..._FLAG_TYPE_CANDIDATE`
+ * 0x40), so a consumer must mask before comparing — the Rust consumer does
+ * (`gpu_meshes/prepass_discovery.rs`), and so does {@link extractPrepassSpanLists}.
+ */
+export const PREPASS_CLASS_CODE_MASK = 0x3f;
+/** `IFCSTYLEDITEM`. */
+export const PREPASS_CLASS_STYLED_ITEM = 4;
+/** `IFCINDEXEDCOLOURMAP`. */
+export const PREPASS_CLASS_INDEXED_COLOUR_MAP = 5;
+/** `IFCMATERIALDEFINITIONREPRESENTATION`. */
+export const PREPASS_CLASS_MATERIAL_DEF_REPR = 6;
+/** `IFCRELASSOCIATESMATERIAL`. */
+export const PREPASS_CLASS_REL_ASSOCIATES_MATERIAL = 7;
+/** `IFCRELVOIDSELEMENT`. */
+export const PREPASS_CLASS_REL_VOIDS = 8;
+/** `IFCRELFILLSELEMENT`. */
+export const PREPASS_CLASS_REL_FILLS = 9;
+/** `IFCRELAGGREGATES`. */
+export const PREPASS_CLASS_REL_AGGREGATES = 10;
+/** The classes the host builds span lists for (every other code is ignored). */
+const HOST_SPAN_CLASSES = [
+    PREPASS_CLASS_STYLED_ITEM,
+    PREPASS_CLASS_INDEXED_COLOUR_MAP,
+    PREPASS_CLASS_MATERIAL_DEF_REPR,
+    PREPASS_CLASS_REL_ASSOCIATES_MATERIAL,
+    PREPASS_CLASS_REL_VOIDS,
+    PREPASS_CLASS_REL_FILLS,
+    PREPASS_CLASS_REL_AGGREGATES,
+];
+/**
+ * Build one `(id, start, length)` span list per host-consumed prepass class
+ * from the stitched shard columns, in FILE ORDER. Every comparison goes
+ * through {@link PREPASS_CLASS_CODE_MASK}, so a record that carries a flag bit
+ * alongside its named code still lands in its list instead of being dropped.
+ * Returns exact-size arrays (one entry per class in `HOST_SPAN_CLASSES`,
+ * empty when the file has none).
+ */
+export function extractPrepassSpanLists(classes, ids, starts, lengths) {
+    // Sized by the code mask rather than by the highest class the host consumes:
+    // a masked code is always < 64, so a class added on the Rust side cannot
+    // write out of bounds here (typed arrays discard such writes silently).
+    const counts = new Uint32Array(PREPASS_CLASS_CODE_MASK + 1);
+    for (let i = 0; i < classes.length; i++)
+        counts[classes[i] & PREPASS_CLASS_CODE_MASK]++;
+    const slots = new Map();
+    for (const k of HOST_SPAN_CLASSES)
+        slots.set(k, { arr: new Uint32Array(counts[k] * 3), w: 0 });
+    for (let i = 0; i < classes.length; i++) {
+        const slot = slots.get(classes[i] & PREPASS_CLASS_CODE_MASK);
+        if (!slot)
+            continue;
+        slot.arr[slot.w] = ids[i];
+        slot.arr[slot.w + 1] = starts[i];
+        slot.arr[slot.w + 2] = lengths[i];
+        slot.w += 3;
+    }
+    const spans = new Map();
+    for (const [k, slot] of slots)
+        spans.set(k, slot.arr);
+    return spans;
+}
+/**
+ * Plan content-affinity routing for one chunk: assign each job (by index) to a
+ * worker bucket so that every job sharing an affinity key lands on the SAME
+ * worker — across the whole stream, since `keyToWorker` is the caller's sticky
+ * map. New keys are handed out round-robin from `startWorker`, so each worker
+ * owns roughly `1/workerCount` of the distinct keys (≈ distinct geometries, the
+ * dominant meshing cost). Pure: mutates only the passed `keyToWorker` and returns
+ * the advanced round-robin cursor. (#1130 follow-up — see `affinity_key` in Rust.)
+ */
+export function planAffinityRouting(affinity, totalJobs, workerCount, keyToWorker, startWorker) {
+    const buckets = Array.from({ length: workerCount }, () => []);
+    let nextWorker = startWorker % workerCount;
+    for (let j = 0; j < totalJobs; j++) {
+        const key = affinity[j];
+        let w = keyToWorker.get(key);
+        if (w === undefined) {
+            w = nextWorker;
+            nextWorker = (nextWorker + 1) % workerCount;
+            keyToWorker.set(key, w);
+        }
+        buckets[w].push(j);
+    }
+    return { buckets, nextWorker };
+}
+//# sourceMappingURL=prepass-routing.js.map

package/dist/prepass-routing.js.map

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

package/dist/scan-proposals.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Typed entry to scan-to-BIM element proposals (#6894). The logic is Rust
+ * (`ifc_lite_processing::scan_proposals`): opposite wall faces pair into
+ * walls, floors and ceilings into slabs, vertical cylinders into columns and
+ * the rest into pipes. This module only types the JSON the wasm call takes
+ * and returns.
+ *
+ * Proposals are in the IFC model frame: Z up, metres. `scanToModel` maps the
+ * segmentation report's frame into it; for the viewer's Y-up, decode-relative
+ * scan sample that is the point cloud's placement composed with the Y-up to
+ * Z-up swap and the model's world offset.
+ */
+import type { IfcAPI } from '@ifc-lite/wasm';
+import type { ScanSegmentationReport, ScanVec3 } from './scan-segmentation.js';
+export type ProposalSchema = 'IFC2X3' | 'IFC4' | 'IFC4X3';
+/** Every field is optional; omitted fields take the Rust defaults below. */
+export interface ScanProposalOptions {
+    /**
+     * Row-major 4x4 similarity (rotation, uniform scale, translation) from the
+     * report's frame to the IFC model frame. Default identity. Reflections and
+     * non-uniform scale are refused.
+     */
+    scanToModel?: number[];
+    /** Decides the pipe class: IfcFlowSegment in IFC2X3, else IfcPipeSegment. Default IFC4. */
+    schema?: ProposalSchema;
+    /** Horizontal / vertical tolerance in the model frame. Default 10 degrees. */
+    classificationAngleDegrees?: number;
+    /** Wall faces pair when parallel within this. Default 5 degrees. */
+    pairingAngleDegrees?: number;
+    /** Paired wall faces lie this far apart or more. Default 0.05 m. */
+    minWallThicknessMetres?: number;
+    /** ... and at most this far. Default 0.6 m. */
+    maxWallThicknessMetres?: number;
+    /** Thickness of a wall seen from one side, placed behind the scanned side. Default 0.2 m. */
+    defaultWallThicknessMetres?: number;
+    /** Paired faces overlap along the wall by this share of the shorter one. Default 0.5. */
+    minWallOverlapFraction?: number;
+    /** Shorter vertical faces are not walls. Default 0.5 m. */
+    minWallLengthMetres?: number;
+    /** Lower vertical faces are not walls. Default 1 m. */
+    minWallHeightMetres?: number;
+    /** Smaller horizontal planes are not slabs. Default 1 m^2. */
+    minSlabAreaSquareMetres?: number;
+    /** Thickness of a slab seen from one side. Default 0.2 m. */
+    defaultSlabThicknessMetres?: number;
+    /** A ceiling and the floor above pair into one slab when this close (and at least `minWallThicknessMetres` apart). Default 0.6 m. */
+    maxSlabThicknessMetres?: number;
+    /** Wall and column ends within this of a floor or ceiling extend to it. Default 0.3 m. */
+    levelSnapMetres?: number;
+    /** A point inside the scanned space (model frame). Default: area-weighted plane centroid. */
+    interiorPoint?: ScanVec3 | null;
+}
+export type ProposalClass = 'IfcWall' | 'IfcSlab' | 'IfcColumn' | 'IfcPipeSegment' | 'IfcFlowSegment';
+/** How the proposal was derived. */
+export type ProposalBasis = 'pairedFaces' | 'singleFace' | 'floorCeilingPair' | 'floor' | 'ceiling' | 'cylinder';
+/** An index into the segmentation report's `planes` or `cylinders`. */
+export interface DetectionRef {
+    kind: 'plane' | 'cylinder';
+    index: number;
+}
+export interface ProposalFit {
+    /** Inlier-weighted RMS of the sources' residuals. */
+    rmsMetres: number;
+    inlierPoints: number;
+    inlierVoxels: number;
+    /** Measured area of the sources (cylinders: arc x radius x length). */
+    areaSquareMetres: number;
+}
+export type ProposalGeometry = 
+/** Axis line on the wall's centre plane, at its base elevation. */
+{
+    kind: 'wall';
+    start: ScanVec3;
+    end: ScanVec3;
+    thicknessMetres: number;
+    heightMetres: number;
+}
+/** Top face outline, counter-clockwise from above; the slab extends `thicknessMetres` below. */
+ | {
+    kind: 'slab';
+    outline: ScanVec3[];
+    thicknessMetres: number;
+}
+/** `radiusMetres`: the fitted radius; a polygonal column gets the circle of equal cross-section area. */
+ | {
+    kind: 'column';
+    base: ScanVec3;
+    heightMetres: number;
+    radiusMetres: number;
+} | {
+    kind: 'pipe';
+    start: ScanVec3;
+    end: ScanVec3;
+    radiusMetres: number;
+};
+export interface ScanElementProposal {
+    /** Stable within one report: `wall-0`, `slab-2`, `column-1`, `pipe-0`. */
+    id: string;
+    ifcClass: ProposalClass;
+    /** 0..1: prior(basis) x fit quality x coverage. */
+    confidence: number;
+    basis: ProposalBasis;
+    sources: DetectionRef[];
+    fit: ProposalFit;
+    geometry: ProposalGeometry;
+}
+export interface ScanProposalStats {
+    verticalPlanes: number;
+    horizontalPlanes: number;
+    slopedPlanes: number;
+    pairedWalls: number;
+    singleFaceWalls: number;
+    facesTooSmall: number;
+    pairedSlabs: number;
+    singleSlabs: number;
+    slabsTooSmall: number;
+    columns: number;
+    pipes: number;
+}
+export interface ScanProposalReport {
+    algorithm: string;
+    /** Walls, then slabs, columns and pipes; each class by descending support. */
+    proposals: ScanElementProposal[];
+    /** Uniform scale of `scanToModel`. */
+    transformScale: number;
+    stats: ScanProposalStats;
+}
+/** The wasm surface this needs: an initialised `IfcAPI` satisfies it. */
+export type ScanProposalEngine = Pick<IfcAPI, 'proposeScanElements'>;
+/** Propose IFC elements from `report`. Throws the Rust error message on invalid options. */
+export declare function proposeScanElements(engine: ScanProposalEngine, report: ScanSegmentationReport, options?: ScanProposalOptions): ScanProposalReport;
+//# sourceMappingURL=scan-proposals.d.ts.map

package/dist/scan-proposals.d.ts.map

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

package/dist/scan-proposals.js

@@ -0,0 +1,12 @@
+/* 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/. */
+/** Propose IFC elements from `report`. Throws the Rust error message on invalid options. */
+export function proposeScanElements(engine, report, options = {}) {
+    if (options.scanToModel && options.scanToModel.length !== 16) {
+        throw new RangeError(`scanToModel needs 16 row-major values, got ${options.scanToModel.length}`);
+    }
+    const bytes = engine.proposeScanElements(JSON.stringify(report), JSON.stringify(options));
+    return JSON.parse(new TextDecoder().decode(bytes));
+}
+//# sourceMappingURL=scan-proposals.js.map

package/dist/scan-proposals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-proposals.js","sourceRoot":"","sources":["../src/scan-proposals.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AA4H/D,4FAA4F;AAC5F,MAAM,UAAU,mBAAmB,CACjC,MAA0B,EAC1B,MAA8B,EAC9B,UAA+B,EAAE;IAEjC,IAAI,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QAC7D,MAAM,IAAI,UAAU,CAAC,8CAA8C,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;IACnG,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1F,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAuB,CAAC;AAC3E,CAAC"}

package/dist/scan-segmentation.d.ts

@@ -0,0 +1,205 @@
+/**
+ * Typed entry to plane and cylinder detection in point clouds (#6870, #6893). The algorithm is
+ * Rust (`ifc_lite_processing::scan_segmentation`); this module only frames
+ * the input and types the JSON report the wasm call returns.
+ *
+ * Coordinates are metres in the frame of the supplied positions, plus
+ * `options.origin` on output. The viewer's retained reservoir sample is Y-up
+ * and decode-relative: pass `upAxis: [0, 1, 0]`.
+ */
+import type { IfcAPI } from '@ifc-lite/wasm';
+export type ScanVec3 = [number, number, number];
+/** Axis-aligned crop box in the positions' frame (inclusive). */
+export interface ScanRegion {
+    min: ScanVec3;
+    max: ScanVec3;
+}
+/** Every field is optional; omitted fields take the Rust defaults below. */
+export interface ScanSegmentationOptions {
+    /** Averaging voxel edge. Default 0.03 m; 0.005..=1. */
+    voxelSizeMetres?: number;
+    /**
+     * Voxel budget; past it the voxel size doubles. Default 1,500,000. Memory
+     * is roughly 180 bytes per voxel: the 8,000,000 maximum (with 2 normal
+     * rings) peaks near 1.4 GB, more than a browser tab should spend.
+     */
+    maxVoxels?: number;
+    /** Normal neighbourhood: 1 = 26 neighbours (default), 2 = 124. */
+    normalNeighborRings?: number;
+    /** Occupied voxels (self included) a normal needs. Default 6. */
+    minNeighbors?: number;
+    /**
+     * Seed voxels have curvature at most this, or at most the curvature of the
+     * flattest 5 % of voxels when noise lifts even flat surfaces above it.
+     * Default 0.02.
+     */
+    maxSeedCurvature?: number;
+    /** Growth and merge angle tolerance. Default 10 degrees. */
+    maxNormalAngleDegrees?: number;
+    /** Growth and merge distance tolerance. Default 0.02 m. */
+    maxPlaneDistanceMetres?: number;
+    /** Robust refit band in MADs. Default 2.5. */
+    madScale?: number;
+    /** Regions whose normals turn faster than this (1/radius) are curved. Default 1 per metre. */
+    maxBendPerMetre?: number;
+    /** Smaller planes are dropped. Default 0.25 m^2. */
+    minPlaneAreaSquareMetres?: number;
+    /** Horizontal / vertical classification tolerance. Default 10 degrees. */
+    classificationAngleDegrees?: number;
+    /** Up direction of the positions' frame. Default [0, 0, 1]. */
+    upAxis?: ScanVec3;
+    /** When given, every plane normal faces the scanner. */
+    scannerPosition?: ScanVec3 | null;
+    /** Added to every output coordinate. Default [0, 0, 0]. */
+    origin?: ScanVec3;
+    /** Only points inside this box take part. */
+    region?: ScanRegion | null;
+    /** Largest planes kept. Default 10,000. */
+    maxPlanes?: number;
+    /** Look for cylinders (columns, pipes) among non-planar voxels. Default true. */
+    detectCylinders?: boolean;
+    /** Accepted cylinder radius range. The minimum defaults to two voxel edges (null), the maximum to 2 m. */
+    minCylinderRadiusMetres?: number | null;
+    maxCylinderRadiusMetres?: number;
+    /** Share of a group a candidate must fit. Default 0.6. */
+    minCylinderInlierFraction?: number;
+    /** Minimum circumference covered. Default 90 degrees. */
+    minCylinderArcDegrees?: number;
+    /** Minimum length along the axis. Default 0.3 m. */
+    minCylinderLengthMetres?: number;
+    /** RANSAC draws per candidate. Default 256. */
+    cylinderDraws?: number;
+    /** Voxels each draw is scored on. Default 2,048. */
+    cylinderScoreSample?: number;
+    /** Largest non-planar groups examined. Default 1,024. */
+    maxCylinderGroups?: number;
+}
+export type ScanPlaneOrientation = 'horizontal' | 'vertical' | 'sloped';
+/** `scanner`: the normal faces `scannerPosition`. `canonical`: horizontal planes face up, others a fixed axis sign. */
+export type ScanNormalSource = 'scanner' | 'canonical';
+export interface ScanPlaneExtent {
+    center: ScanVec3;
+    uAxis: ScanVec3;
+    vAxis: ScanVec3;
+    uLength: number;
+    vLength: number;
+    corners: [ScanVec3, ScanVec3, ScanVec3, ScanVec3];
+}
+export interface ScanPlane {
+    /** Unit normal; `normal . x + d = 0`. */
+    normal: ScanVec3;
+    d: number;
+    centroid: ScanVec3;
+    inlierPoints: number;
+    inlierVoxels: number;
+    areaSquareMetres: number;
+    rmsMetres: number;
+    extent: ScanPlaneExtent;
+    orientation: ScanPlaneOrientation;
+    normalSource: ScanNormalSource;
+}
+/** Axis relative to `upAxis`: vertical is a column, horizontal a pipe or beam. */
+export type ScanAxisOrientation = 'vertical' | 'horizontal' | 'sloped';
+/** The faces of a polygonal column: a regular polygon of `faces` sides about the axis. */
+export interface ScanFacets {
+    /** Sides of the whole polygon (6 or more), seen or not. */
+    faces: number;
+    /**
+     * Unit outward normal of one face, across the axis; the others follow at
+     * multiples of 360 / `faces` degrees. The face nearest the frame's +x
+     * (+y when the axis runs along x).
+     */
+    faceNormal: ScanVec3;
+    /** Distance from the axis to each face (inradius). */
+    apothem: number;
+}
+export interface ScanCylinder {
+    axisStart: ScanVec3;
+    axisEnd: ScanVec3;
+    /** Unit; points up unless horizontal. */
+    axisDirection: ScanVec3;
+    /** For a faceted column, the circumradius (axis to corner). */
+    radius: number;
+    length: number;
+    /** Lowest and highest axis end along `upAxis`. */
+    heightRange: [number, number];
+    /** Circumference covered by the inliers, in degrees; for pieces joined across a density gap, the larger piece's arc (a lower bound). */
+    arcDegrees: number;
+    inlierPoints: number;
+    inlierVoxels: number;
+    rmsMetres: number;
+    orientation: ScanAxisOrientation;
+    /** Set for a polygonal column (a ring of six or more flat faces); null when round. */
+    faceted: ScanFacets | null;
+}
+export interface ScanSegmentationStats {
+    inputPoints: number;
+    acceptedPoints: number;
+    rejectedPoints: number;
+    outsideRegionPoints: number;
+    /** f32 spacing at the largest coordinate: the finest resolution the positions carry. */
+    coordinateSpacingMetres: number;
+    voxelSizeMetres: number;
+    coarsenings: number;
+    voxels: number;
+    voxelsWithNormals: number;
+    seedVoxels: number;
+    /** The curvature gate the seeds passed: `maxSeedCurvature`, or higher on noisy data. */
+    seedCurvature: number;
+    regionsGrown: number;
+    regionsMerged: number;
+    curvedRegionsRejected: number;
+    smallRegionsRejected: number;
+    planarVoxels: number;
+    cylinderGroups: number;
+    cylindersRejectedAsSpheres: number;
+    cylinderCandidatesBelowShare: number;
+    cylinderRefitsFailed: number;
+    cylindersRejectedForRadius: number;
+    cylindersRejectedAsSparse: number;
+    cylindersRejectedAsFacets: number;
+    cylindersRejectedAsPierced: number;
+    cylindersRejectedForUnevenArc: number;
+    cylindersRejectedAsDuplicates: number;
+    cylindersJoinedAcrossGaps: number;
+    cylindersRejectedForArc: number;
+    cylindersRejectedForLength: number;
+    /** Rings of adjacent vertical planes about a common axis, examined as wide or polygonal columns. */
+    planeRings: number;
+    /** Rings neither round nor a regular polygon of six or more faces: they stay planes. */
+    planeRingsRejectedAsIrregular: number;
+    /** Rings with scanned surface inside their footprint (a bay or niche seen from the room). */
+    planeRingsRejectedAsHollow: number;
+    /** Planes removed because they lie on a reported cylinder or are a faceted column's faces. */
+    planesAbsorbedIntoCylinders: number;
+}
+/** Which bounds acted; a bound that acts is always reported. */
+export interface ScanSegmentationLimits {
+    voxelBudgetCoarsened: boolean;
+    planeLimitHit: boolean;
+    /** Positions too far from their frame origin for the voxel size; pass a local `origin`. */
+    coordinatePrecisionDegraded: boolean;
+    cylinderGroupLimitHit: boolean;
+}
+export interface ScanSegmentationReport {
+    algorithm: string;
+    /** Largest area first. A surface reported as a cylinder is not also a plane. */
+    planes: ScanPlane[];
+    /** Longest first; round and faceted columns, pipes. */
+    cylinders: ScanCylinder[];
+    stats: ScanSegmentationStats;
+    limits: ScanSegmentationLimits;
+}
+/**
+ * xyz positions; `count` limits them to a prefix, so a reservoir whose buffer
+ * is larger than its fill (the viewer's retained scan sample) passes as is.
+ */
+export interface ScanPointInput {
+    positions: Float32Array;
+    count?: number;
+}
+/** The wasm surface this needs: an initialised `IfcAPI` satisfies it. */
+export type ScanSegmentationEngine = Pick<IfcAPI, 'segmentScanPoints'>;
+/** Detect planes and cylinders in `input`. Throws the Rust error message on invalid options. */
+export declare function segmentScan(engine: ScanSegmentationEngine, input: ScanPointInput, options?: ScanSegmentationOptions): ScanSegmentationReport;
+//# sourceMappingURL=scan-segmentation.d.ts.map

package/dist/scan-segmentation.d.ts.map

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

package/dist/scan-segmentation.js

@@ -0,0 +1,17 @@
+/* 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/. */
+/** Detect planes and cylinders in `input`. Throws the Rust error message on invalid options. */
+export function segmentScan(engine, input, options = {}) {
+    const available = Math.floor(input.positions.length / 3);
+    const count = input.count ?? available;
+    if (!Number.isInteger(count) || count < 0 || count > available) {
+        throw new RangeError(`Scan point count ${count} must be an integer within 0..${available}`);
+    }
+    const positions = count === available && input.positions.length === count * 3
+        ? input.positions
+        : input.positions.subarray(0, count * 3);
+    const bytes = engine.segmentScanPoints(positions, JSON.stringify(options));
+    return JSON.parse(new TextDecoder().decode(bytes));
+}
+//# sourceMappingURL=scan-segmentation.js.map

package/dist/scan-segmentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-segmentation.js","sourceRoot":"","sources":["../src/scan-segmentation.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AA2N/D,gGAAgG;AAChG,MAAM,UAAU,WAAW,CACzB,MAA8B,EAC9B,KAAqB,EACrB,UAAmC,EAAE;IAErC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACzD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,SAAS,CAAC;IACvC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,SAAS,EAAE,CAAC;QAC/D,MAAM,IAAI,UAAU,CAAC,oBAAoB,KAAK,iCAAiC,SAAS,EAAE,CAAC,CAAC;IAC9F,CAAC;IACD,MAAM,SAAS,GAAG,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,KAAK,KAAK,GAAG,CAAC;QAC3E,CAAC,CAAC,KAAK,CAAC,SAAS;QACjB,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,iBAAiB,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3E,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAA2B,CAAC;AAC/E,CAAC"}

package/dist/warm-pool.d.ts

@@ -0,0 +1,27 @@
+/**
+ * The realm's one pool of prewarmed geometry workers (#7036) and the calls a
+ * host uses to fill and empty it. Behind the `warmPool` perf flag: with the
+ * experiment disabled, `getWarmGeometryWorkerPool()` is null, nothing is prewarmed
+ * and every load spawns its own workers exactly as before.
+ */
+import { GeometryWorkerPool, type GeometryWorkerPoolStats } from './geometry-worker-pool.js';
+/** The shared pool, or null when the flag is off or the realm has no workers. */
+export declare function getWarmGeometryWorkerPool(): GeometryWorkerPool | null;
+/**
+ * Fill the pool with the workers a parallel load of `fileSizeMB` will use (its
+ * geometry workers plus the pre-pass worker), each with the engine
+ * instantiated from the shared compiled module. Call it as soon as a load is
+ * requested, so the spawn overlaps the file read. Resolves to the number of
+ * workers started (0 when the pool is off, already holds them, or the module
+ * could not be compiled: the load then spawns as before).
+ */
+export declare function prewarmGeometryWorkers(options?: {
+    fileSizeMB?: number;
+    workerCountOverride?: number;
+    wasmUrl?: string;
+}): Promise<number>;
+/** Terminate every idle prewarmed worker (memory pressure, a hidden tab, a resource-limit retry). */
+export declare function releaseWarmGeometryWorkers(reason?: string): number;
+/** Idle-pool counters for `?perfMem=1` and the benchmark guards; null before the pool exists. */
+export declare function warmGeometryWorkerPoolStats(): GeometryWorkerPoolStats | null;
+//# sourceMappingURL=warm-pool.d.ts.map

package/dist/warm-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warm-pool.d.ts","sourceRoot":"","sources":["../src/warm-pool.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AAEH,OAAO,EAAE,kBAAkB,EAAE,KAAK,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAQ7F,iFAAiF;AACjF,wBAAgB,yBAAyB,IAAI,kBAAkB,GAAG,IAAI,CAGrE;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GACpF,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED,qGAAqG;AACrG,wBAAgB,0BAA0B,CAAC,MAAM,SAAY,GAAG,MAAM,CAErE;AAED,iGAAiG;AACjG,wBAAgB,2BAA2B,IAAI,uBAAuB,GAAG,IAAI,CAE5E"}

package/dist/warm-pool.js

@@ -0,0 +1,48 @@
+/* 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/. */
+/**
+ * The realm's one pool of prewarmed geometry workers (#7036) and the calls a
+ * host uses to fill and empty it. Behind the `warmPool` perf flag: with the
+ * experiment disabled, `getWarmGeometryWorkerPool()` is null, nothing is prewarmed
+ * and every load spawns its own workers exactly as before.
+ */
+import { GeometryWorkerPool } from './geometry-worker-pool.js';
+import { postGeometryWorkerInit } from './geometry-worker-init.js';
+import { readWarmPoolFlag } from './perf-flags.js';
+import { compileSharedWasmModule } from './wasm-shared-module.js';
+import { planLoadWorkerCount } from './worker-count.js';
+let shared = null;
+/** The shared pool, or null when the flag is off or the realm has no workers. */
+export function getWarmGeometryWorkerPool() {
+    if (typeof Worker === 'undefined' || !readWarmPoolFlag())
+        return null;
+    return (shared ??= new GeometryWorkerPool());
+}
+/**
+ * Fill the pool with the workers a parallel load of `fileSizeMB` will use (its
+ * geometry workers plus the pre-pass worker), each with the engine
+ * instantiated from the shared compiled module. Call it as soon as a load is
+ * requested, so the spawn overlaps the file read. Resolves to the number of
+ * workers started (0 when the pool is off, already holds them, or the module
+ * could not be compiled: the load then spawns as before).
+ */
+export async function prewarmGeometryWorkers(options = {}) {
+    const pool = getWarmGeometryWorkerPool();
+    if (!pool)
+        return 0;
+    const module = await compileSharedWasmModule(options.wasmUrl);
+    if (!module)
+        return 0;
+    const { count } = planLoadWorkerCount(options.fileSizeMB ?? 8, options.workerCountOverride);
+    return pool.prewarm(count + 1, options.wasmUrl ?? '', (worker) => postGeometryWorkerInit(worker, undefined, module));
+}
+/** Terminate every idle prewarmed worker (memory pressure, a hidden tab, a resource-limit retry). */
+export function releaseWarmGeometryWorkers(reason = 'release') {
+    return shared?.drain(reason) ?? 0;
+}
+/** Idle-pool counters for `?perfMem=1` and the benchmark guards; null before the pool exists. */
+export function warmGeometryWorkerPoolStats() {
+    return shared?.stats() ?? null;
+}
+//# sourceMappingURL=warm-pool.js.map

package/dist/warm-pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"warm-pool.js","sourceRoot":"","sources":["../src/warm-pool.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;GAKG;AAEH,OAAO,EAAE,kBAAkB,EAAgC,MAAM,2BAA2B,CAAC;AAC7F,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,IAAI,MAAM,GAA8B,IAAI,CAAC;AAE7C,iFAAiF;AACjF,MAAM,UAAU,yBAAyB;IACvC,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,CAAC,gBAAgB,EAAE;QAAE,OAAO,IAAI,CAAC;IACtE,OAAO,CAAC,MAAM,KAAK,IAAI,kBAAkB,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,UAAmF,EAAE;IAErF,MAAM,IAAI,GAAG,yBAAyB,EAAE,CAAC;IACzC,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,CAAC;IACpB,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9D,IAAI,CAAC,MAAM;QAAE,OAAO,CAAC,CAAC;IACtB,MAAM,EAAE,KAAK,EAAE,GAAG,mBAAmB,CAAC,OAAO,CAAC,UAAU,IAAI,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC5F,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,GAAG,CAAC,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;AACvH,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,0BAA0B,CAAC,MAAM,GAAG,SAAS;IAC3D,OAAO,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,2BAA2B;IACzC,OAAO,MAAM,EAAE,KAAK,EAAE,IAAI,IAAI,CAAC;AACjC,CAAC"}