@ifc-lite/renderer 1.17.0 → 1.20.0

package/dist/point-picker.js

@@ -0,0 +1,223 @@
+/* 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 { POINT_QUAD_VERTS, POINT_VERTEX_BYTES } from './pointcloud/point-pipeline.js';
+const POINT_PICK_MARKER = 0x80000000;
+const POINT_PICK_MASK = 0x7fffffff;
+export function decodePickSample(value) {
+    if (value === 0) {
+        return { meshIndexPlusOne: 0, pointExpressId: 0, kind: 'none' };
+    }
+    if ((value & POINT_PICK_MARKER) !== 0) {
+        return {
+            meshIndexPlusOne: 0,
+            pointExpressId: value & POINT_PICK_MASK,
+            kind: 'point',
+        };
+    }
+    return { meshIndexPlusOne: value, pointExpressId: 0, kind: 'mesh' };
+}
+// mat4x4 (64) + vec4 viewport (16) + vec4 sizing (16) + vec4 entityIdOverride (16)
+const UNIFORM_BYTES = 112;
+export class PointPicker {
+    device;
+    pipeline;
+    bindGroupLayout;
+    uniformBuffer;
+    bindGroup;
+    uniformScratch = new Float32Array(UNIFORM_BYTES / 4);
+    uniformU32 = new Uint32Array(this.uniformScratch.buffer);
+    destroyed = false;
+    constructor(device) {
+        this.device = device.getDevice();
+        this.bindGroupLayout = this.device.createBindGroupLayout({
+            entries: [
+                {
+                    binding: 0,
+                    visibility: GPUShaderStage.VERTEX | GPUShaderStage.FRAGMENT,
+                    buffer: { type: 'uniform' },
+                },
+            ],
+        });
+        this.uniformBuffer = this.device.createBuffer({
+            size: UNIFORM_BYTES,
+            usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST,
+        });
+        this.bindGroup = this.device.createBindGroup({
+            layout: this.bindGroupLayout,
+            entries: [{ binding: 0, resource: { buffer: this.uniformBuffer } }],
+        });
+        const shader = this.device.createShaderModule({
+            code: `
+struct U {
+  viewProj: mat4x4<f32>,
+  viewport: vec4<f32>,        // x, y = w, h; z, w = unused
+  sizing: vec4<f32>,          // x = sizeMode, y = worldRadius,
+                              // z = pointSizePx, w = clickToleranceExtraPx
+  // x = assetExpressId override (federation-aware globalId);
+  // 0 means "use the per-vertex entityId attribute".
+  entityIdOverride: vec4<u32>,
+}
+@binding(0) @group(0) var<uniform> u: U;
+
+struct VIn {
+  @location(0) position: vec3<f32>,
+  @location(1) entityId: u32,
+}
+
+struct VOut {
+  @builtin(position) pos: vec4<f32>,
+  @location(0) @interpolate(flat) entityId: u32,
+  @location(1) quadUv: vec2<f32>,
+}
+
+@vertex
+fn vs_main(input: VIn, @builtin(vertex_index) vId: u32) -> VOut {
+  var corners = array<vec2<f32>, 6>(
+    vec2<f32>(-1.0, -1.0),
+    vec2<f32>( 1.0, -1.0),
+    vec2<f32>( 1.0,  1.0),
+    vec2<f32>(-1.0, -1.0),
+    vec2<f32>( 1.0,  1.0),
+    vec2<f32>(-1.0,  1.0),
+  );
+  let corner = corners[vId];
+
+  var clip = u.viewProj * vec4<f32>(input.position, 1.0);
+
+  let sizeMode = u32(u.sizing.x);
+  let worldRadius = u.sizing.y;
+  let pointSizePx = u.sizing.z;
+  let extraPx = u.sizing.w;
+  let viewport = u.viewport.xy;
+
+  // halfPx is the RADIUS; pointSizePx is the user-facing diameter, so /2.
+  var halfPx: f32;
+  if (sizeMode == 0u) {
+    halfPx = max(0.5, pointSizePx * 0.5);
+  } else {
+    let edgePos = u.viewProj * vec4<f32>(input.position + vec3<f32>(worldRadius, 0.0, 0.0), 1.0);
+    let centerNdcX = clip.x / max(abs(clip.w), 1e-6);
+    let edgeNdcX = edgePos.x / max(abs(edgePos.w), 1e-6);
+    let projectedPx = abs(edgeNdcX - centerNdcX) * 0.5 * viewport.x;
+    if (sizeMode == 2u) {
+      halfPx = clamp(projectedPx, 0.5, max(0.5, pointSizePx * 0.5));
+    } else {
+      halfPx = max(0.5, projectedPx);
+    }
+  }
+  // Extra click-tolerance pixels on every side.
+  halfPx = halfPx + extraPx;
+
+  let halfClip = vec2<f32>(halfPx) / max(viewport, vec2<f32>(1.0)) * 2.0 * abs(clip.w);
+  clip.x = clip.x + corner.x * halfClip.x;
+  clip.y = clip.y + corner.y * halfClip.y;
+
+  var o: VOut;
+  o.pos = clip;
+  o.entityId = input.entityId;
+  o.quadUv = corner;
+  return o;
+}
+
+@fragment
+fn fs_main(input: VOut) -> @location(0) u32 {
+  // Round mask — picking ignores the corner area outside the unit disc
+  // so users can't accidentally select a point by clicking 1.4 splat-
+  // radii away from its centre.
+  if (dot(input.quadUv, input.quadUv) > 1.0) {
+    discard;
+  }
+  // Prefer the asset-level expressId override when set (federation
+  // relabels apply post-stream so the per-vertex attribute can go
+  // stale). Fallback to the per-vertex value when no override is set.
+  let id = select(input.entityId, u.entityIdOverride.x, u.entityIdOverride.x != 0u);
+  return 0x80000000u | (id & 0x7FFFFFFFu);
+}
+`,
+        });
+        this.pipeline = this.device.createRenderPipeline({
+            layout: this.device.createPipelineLayout({ bindGroupLayouts: [this.bindGroupLayout] }),
+            vertex: {
+                module: shader,
+                entryPoint: 'vs_main',
+                buffers: [
+                    {
+                        arrayStride: POINT_VERTEX_BYTES,
+                        stepMode: 'instance',
+                        attributes: [
+                            { shaderLocation: 0, offset: 0, format: 'float32x3' },
+                            // Skip color (offset 12) and intensity (offset 16) — picker
+                            // doesn't need them. EntityId lives at offset 20.
+                            { shaderLocation: 1, offset: 20, format: 'uint32' },
+                        ],
+                    },
+                ],
+            },
+            fragment: {
+                module: shader,
+                entryPoint: 'fs_main',
+                targets: [{ format: 'r32uint' }],
+            },
+            primitive: { topology: 'triangle-list' },
+            depthStencil: {
+                format: 'depth32float',
+                depthWriteEnabled: true,
+                depthCompare: 'greater',
+            },
+        });
+    }
+    /**
+     * Draw point pick splats into the (already-open) render pass. The
+     * caller is responsible for clearing the color + depth attachments
+     * and ending the pass.
+     */
+    drawIntoPass(pass, nodes, viewProj, viewport, sizing) {
+        if (this.destroyed || nodes.length === 0)
+            return;
+        pass.setPipeline(this.pipeline);
+        pass.setBindGroup(0, this.bindGroup);
+        // Per-node uniform write so federation-relabelled IDs surface in
+        // the picker too. The per-vertex `entityId` attribute is baked at
+        // upload time and goes stale once the FederationRegistry assigns
+        // an idOffset to the model — the override forces the picker to
+        // emit the asset's CURRENT expressId regardless.
+        for (const node of nodes) {
+            this.writeUniforms(viewProj, viewport, sizing, node.expressId >>> 0);
+            for (const chunk of node.chunks) {
+                if (chunk.pointCount === 0)
+                    continue;
+                pass.setVertexBuffer(0, chunk.vertexBuffer);
+                pass.draw(POINT_QUAD_VERTS, chunk.pointCount, 0, 0);
+            }
+        }
+    }
+    writeUniforms(viewProj, viewport, sizing, entityIdOverride) {
+        const u = this.uniformScratch;
+        const u32 = this.uniformU32;
+        u.set(viewProj.subarray(0, 16), 0);
+        u[16] = Math.max(1, viewport.width);
+        u[17] = Math.max(1, viewport.height);
+        u[18] = 0;
+        u[19] = 0;
+        u[20] = sizing.sizeMode;
+        u[21] = sizing.worldRadius;
+        u[22] = sizing.pointSizePx;
+        u[23] = sizing.clickTolerancePx;
+        // entityIdOverride at u32 offset 24..27. 0 means "use per-vertex
+        // attribute" (the shader's select(...) will pick the per-vertex
+        // value); any non-zero value wins.
+        u32[24] = entityIdOverride >>> 0;
+        u32[25] = 0;
+        u32[26] = 0;
+        u32[27] = 0;
+        this.device.queue.writeBuffer(this.uniformBuffer, 0, u.buffer, u.byteOffset, UNIFORM_BYTES);
+    }
+    destroy() {
+        if (this.destroyed)
+            return;
+        this.destroyed = true;
+        this.uniformBuffer.destroy();
+    }
+}
+//# sourceMappingURL=point-picker.js.map

package/dist/point-picker.js.map

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

package/dist/pointcloud/point-cloud-node.d.ts

@@ -0,0 +1,63 @@
+/**
+ * GPU resources for one point cloud asset.
+ *
+ * Phase 1+ supports multi-chunk assets: streaming sources push chunks
+ * into a node one at a time, each becoming its own GPU vertex buffer.
+ * Each chunk is drawn with one draw call sharing the asset's bind group.
+ */
+import type { PointCloudAsset } from '@ifc-lite/geometry';
+import type { PointRenderPipeline } from './point-pipeline.js';
+export interface PointCloudGpuChunk {
+    vertexBuffer: GPUBuffer;
+    /**
+     * Per-point signed-distance buffer. Always allocated alongside the
+     * vertex buffer (4 bytes per point) so the compute pass and splat
+     * pipeline can both bind it without a "deviation present?" branch.
+     * Initialised to zeros — `Renderer.computeDeviations` overwrites.
+     */
+    deviationBuffer: GPUBuffer;
+    pointCount: number;
+    bbox: {
+        min: [number, number, number];
+        max: [number, number, number];
+    };
+}
+/** Inputs to a single chunk upload. */
+export interface PointCloudChunkInput {
+    positions: Float32Array;
+    /** RGB in 0..1; undefined → defaults to gray. */
+    colors?: Float32Array;
+    /** Per-point u8 LAS classification; undefined → 0. */
+    classifications?: Uint8Array;
+    /** Per-point u16 intensity; undefined → 0. */
+    intensities?: Uint16Array;
+    pointCount: number;
+    bbox: {
+        min: [number, number, number];
+        max: [number, number, number];
+    };
+}
+export interface PointCloudNodeMeta {
+    expressId: number;
+    ifcType?: string;
+    modelIndex?: number;
+}
+export interface PointCloudNode {
+    meta: PointCloudNodeMeta;
+    uniformBuffer: GPUBuffer;
+    bindGroup: GPUBindGroup;
+    chunks: PointCloudGpuChunk[];
+    bounds: {
+        min: [number, number, number];
+        max: [number, number, number];
+    };
+    pointCount: number;
+}
+/** Build an empty node — chunks are appended via `appendChunkToNode`. */
+export declare function createNode(device: GPUDevice, pipeline: PointRenderPipeline, meta: PointCloudNodeMeta): PointCloudNode;
+/** Convert a renderer-agnostic chunk into a GPU vertex buffer + metadata. */
+export declare function appendChunkToNode(device: GPUDevice, node: PointCloudNode, chunk: PointCloudChunkInput): PointCloudGpuChunk;
+/** One-shot upload — produces a node with a single GPU chunk. */
+export declare function uploadAssetToGpu(device: GPUDevice, pipeline: PointRenderPipeline, asset: PointCloudAsset): PointCloudNode;
+export declare function destroyNode(node: PointCloudNode): void;
+//# sourceMappingURL=point-cloud-node.d.ts.map

package/dist/pointcloud/point-cloud-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"point-cloud-node.d.ts","sourceRoot":"","sources":["../../src/pointcloud/point-cloud-node.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG/D,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,SAAS,CAAC;IACxB;;;;;OAKG;IACH,eAAe,EAAE,SAAS,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE;QAAE,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;CACxE;AAED,uCAAuC;AACvC,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,YAAY,CAAC;IACxB,iDAAiD;IACjD,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,sDAAsD;IACtD,eAAe,CAAC,EAAE,UAAU,CAAC;IAC7B,8CAA8C;IAC9C,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE;QAAE,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;CACxE;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,kBAAkB,CAAC;IACzB,aAAa,EAAE,SAAS,CAAC;IACzB,SAAS,EAAE,YAAY,CAAC;IACxB,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,MAAM,EAAE;QAAE,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;IACzE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,yEAAyE;AACzE,wBAAgB,UAAU,CACxB,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,mBAAmB,EAC7B,IAAI,EAAE,kBAAkB,GACvB,cAAc,CAehB;AAYD,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,oBAAoB,GAC1B,kBAAkB,CAiFpB;AAED,iEAAiE;AACjE,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,mBAAmB,EAC7B,KAAK,EAAE,eAAe,GACrB,cAAc,CAehB;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAQtD"}

package/dist/pointcloud/point-cloud-node.js

@@ -0,0 +1,149 @@
+/* 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 { POINT_VERTEX_BYTES } from './point-pipeline.js';
+/** Build an empty node — chunks are appended via `appendChunkToNode`. */
+export function createNode(device, pipeline, meta) {
+    void device;
+    const uniformBuffer = pipeline.createUniformBuffer();
+    const bindGroup = pipeline.createBindGroup(uniformBuffer);
+    return {
+        meta,
+        uniformBuffer,
+        bindGroup,
+        chunks: [],
+        bounds: {
+            min: [Infinity, Infinity, Infinity],
+            max: [-Infinity, -Infinity, -Infinity],
+        },
+        pointCount: 0,
+    };
+}
+/**
+ * Per-page-session counter for the vertex-buffer class-byte
+ * diagnostic. Mirrors the host-side log in `pointCloudIngest.ts`
+ * so the two can be cross-checked: if the host log shows non-zero
+ * classes but the vertex log shows all 0, the packing path is
+ * dropping them.
+ */
+const DEBUG_VERTEX_CLASS_LOG_LIMIT = 3;
+let debugVertexClassLogs = 0;
+/** Convert a renderer-agnostic chunk into a GPU vertex buffer + metadata. */
+export function appendChunkToNode(device, node, chunk) {
+    const count = chunk.pointCount;
+    const bytes = new ArrayBuffer(count * POINT_VERTEX_BYTES);
+    const f32 = new Float32Array(bytes);
+    const u8 = new Uint8Array(bytes);
+    const u32 = new Uint32Array(bytes);
+    const positions = chunk.positions;
+    const colors = chunk.colors;
+    const classes = chunk.classifications;
+    const intensities = chunk.intensities;
+    const expressId = node.meta.expressId >>> 0;
+    for (let i = 0; i < count; i++) {
+        const fOff = i * 6;
+        f32[fOff] = positions[i * 3];
+        f32[fOff + 1] = positions[i * 3 + 1];
+        f32[fOff + 2] = positions[i * 3 + 2];
+        const byteOff = i * POINT_VERTEX_BYTES + 12;
+        if (colors) {
+            u8[byteOff] = clamp01(colors[i * 3]) * 255;
+            u8[byteOff + 1] = clamp01(colors[i * 3 + 1]) * 255;
+            u8[byteOff + 2] = clamp01(colors[i * 3 + 2]) * 255;
+        }
+        else {
+            u8[byteOff] = 200;
+            u8[byteOff + 1] = 200;
+            u8[byteOff + 2] = 200;
+        }
+        u8[byteOff + 3] = classes ? classes[i] : 0;
+        // intensity at offset +16, low 16 bits of a u32
+        u32[i * 6 + 4] = intensities ? intensities[i] & 0xffff : 0;
+        u32[i * 6 + 5] = expressId;
+    }
+    // Sanity-check the packed buffer: read back the class byte for
+    // the first few vertices so the console shows exactly what the
+    // splat shader will see at `rgbAndClass.a * 255`. Catches the
+    // case where the chunk had non-trivial classes but they got
+    // zeroed during packing (e.g. a buffer-view mismatch).
+    if (debugVertexClassLogs < DEBUG_VERTEX_CLASS_LOG_LIMIT && classes) {
+        debugVertexClassLogs++;
+        const sample = [];
+        for (let i = 0; i < Math.min(8, count); i++) {
+            sample.push(u8[i * POINT_VERTEX_BYTES + 15]);
+        }
+        console.log(`[pointcloud-debug] vertex-buffer chunk #${debugVertexClassLogs}: `
+            + `packed class bytes (offset +15) first8=[${sample.join(',')}]`);
+    }
+    const vertexBuffer = device.createBuffer({
+        size: bytes.byteLength,
+        // STORAGE so the deviation compute shader can read positions
+        // straight from the vertex buffer (avoids a duplicate copy).
+        usage: GPUBufferUsage.VERTEX | GPUBufferUsage.COPY_DST | GPUBufferUsage.STORAGE,
+    });
+    device.queue.writeBuffer(vertexBuffer, 0, bytes);
+    // Pre-allocate the per-point deviation buffer (zero-initialised).
+    // Bound as a vertex attribute by the splat pipeline AND as a
+    // storage buffer by the deviation compute pass.
+    const deviationBuffer = device.createBuffer({
+        size: count * 4,
+        usage: GPUBufferUsage.VERTEX | GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_DST,
+    });
+    // Zero-init explicitly — WebGPU spec doesn't promise zeroed buffers
+    // and some implementations skip the initial clear when STORAGE is set.
+    device.queue.writeBuffer(deviationBuffer, 0, new Float32Array(count));
+    const gpuChunk = {
+        vertexBuffer,
+        deviationBuffer,
+        pointCount: count,
+        bbox: chunk.bbox,
+    };
+    node.chunks.push(gpuChunk);
+    node.pointCount += count;
+    growBounds(node.bounds, chunk.bbox);
+    return gpuChunk;
+}
+/** One-shot upload — produces a node with a single GPU chunk. */
+export function uploadAssetToGpu(device, pipeline, asset) {
+    const node = createNode(device, pipeline, {
+        expressId: asset.expressId,
+        ifcType: asset.ifcType,
+        modelIndex: asset.modelIndex,
+    });
+    appendChunkToNode(device, node, {
+        positions: asset.chunk.positions,
+        colors: asset.chunk.colors,
+        classifications: asset.chunk.classifications,
+        intensities: asset.chunk.intensities,
+        pointCount: asset.chunk.pointCount,
+        bbox: asset.chunk.bbox,
+    });
+    return node;
+}
+export function destroyNode(node) {
+    for (const chunk of node.chunks) {
+        chunk.vertexBuffer.destroy();
+        chunk.deviationBuffer.destroy();
+    }
+    node.uniformBuffer.destroy();
+    node.chunks = [];
+    node.pointCount = 0;
+}
+function growBounds(bounds, bbox) {
+    if (bbox.min[0] < bounds.min[0])
+        bounds.min[0] = bbox.min[0];
+    if (bbox.min[1] < bounds.min[1])
+        bounds.min[1] = bbox.min[1];
+    if (bbox.min[2] < bounds.min[2])
+        bounds.min[2] = bbox.min[2];
+    if (bbox.max[0] > bounds.max[0])
+        bounds.max[0] = bbox.max[0];
+    if (bbox.max[1] > bounds.max[1])
+        bounds.max[1] = bbox.max[1];
+    if (bbox.max[2] > bounds.max[2])
+        bounds.max[2] = bbox.max[2];
+}
+function clamp01(v) {
+    return v < 0 ? 0 : v > 1 ? 1 : v;
+}
+//# sourceMappingURL=point-cloud-node.js.map

package/dist/pointcloud/point-cloud-node.js.map

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

package/dist/pointcloud/point-cloud-renderer.d.ts

@@ -0,0 +1,166 @@
+/**
+ * Manages point cloud assets in the renderer.
+ *
+ * Supports two ingest modes:
+ *   - One-shot: `addAsset(asset)` for inline IFCx pointclouds.
+ *   - Streaming: `beginAsset(meta) → handle`, `appendChunk(handle, chunk)`,
+ *     `endAsset(handle)` for LAS/LAZ files arriving in chunks.
+ *
+ * The renderer owns the pipeline, per-asset GPU resources, and the per-frame
+ * draw call. Designed to slot into the existing `Renderer.render()` so points
+ * share the depth buffer and section-plane state with triangle meshes.
+ */
+import type { PointCloudAsset } from '@ifc-lite/geometry';
+import { type PointCloudChunkInput, type PointCloudNode, type PointCloudNodeMeta } from './point-cloud-node.js';
+import { type PointColorMode, type PointSizeMode } from './point-cloud-uniforms.js';
+export interface ResolvedSectionPlane {
+    normal: [number, number, number];
+    distance: number;
+    enabled: boolean;
+    flipped?: boolean;
+}
+export type { PointColorMode, PointSizeMode };
+/**
+ * How to size a splat on screen.
+ *   - `fixed-px`        every splat is `pointSize` pixels wide
+ *   - `adaptive-world`  splat covers `worldRadius` metres in source space,
+ *                       projected each frame (closer → bigger)
+ *   - `attenuated`      adaptive but clamped between 1 px and `pointSize`
+ *                       so splats stay visible at the far plane and don't
+ *                       blow up to half the screen when you nose into the
+ *                       cloud — usually the best default for nav.
+ */
+export interface PointCloudDrawState {
+    /** column-major view-projection matrix (16 floats) */
+    viewProj: Float32Array;
+    /** Section plane already resolved by the main render path. */
+    sectionPlane?: ResolvedSectionPlane | null;
+    /** Viewport size in pixels — needed by the splat shader to convert
+     *  pixel sizes into clip-space offsets. */
+    viewport?: {
+        width: number;
+        height: number;
+    };
+}
+export interface PointCloudRenderOptions {
+    /** How to color points each frame. Defaults to 'rgb'. */
+    colorMode?: PointColorMode;
+    /** RGBA in 0..1, used when colorMode === 'fixed'. */
+    fixedColor?: [number, number, number, number];
+    /** Splat size in pixels (mode='fixed-px'/'attenuated') or maximum size cap. */
+    pointSize?: number;
+    /** Splat sizing strategy. Defaults to `attenuated`. */
+    sizeMode?: PointSizeMode;
+    /** World-space splat radius in metres for adaptive / attenuated modes.
+     *  Defaults to 0.02 m which works well for typical 5–20 mm scan spacing. */
+    worldRadius?: number;
+    /** Render splats as discs instead of squares. Defaults to true. */
+    roundShape?: boolean;
+    /**
+     * Per-ASPRS-class visibility bitmask. Bit `i` set → class `i` is
+     * visible. Defaults to `0xFFFFFFFF` (all 32 classes shown). Only
+     * affects points carrying classifications; meshes ignore it.
+     * Stored as an unsigned 32-bit integer in the uniform block.
+     */
+    classMask?: number;
+    /**
+     * Stride-cull factor for the splat shader: 1 = render every point,
+     * 2 = every other, 4 = every fourth, etc. Used by the section-plane
+     * preview path so dragging a slider over a 100M-point scan stays
+     * responsive — UI flips this to e.g. 4 on drag start and back to 1
+     * on drag end. Default 1.
+     */
+    previewStride?: number;
+    /**
+     * BIM↔scan deviation heatmap range. `centerOffset` shifts the
+     * "white" point off zero (handy when a scan has a global offset
+     * from the model); `halfRange` is the metres mapped to ±1 on the
+     * blue→white→red ramp. Defaults to (0, 0.05) → ±5cm.
+     * Only consulted when `colorMode === 'deviation'`.
+     */
+    deviationRange?: {
+        centerOffset: number;
+        halfRange: number;
+    };
+}
+export interface PointCloudAssetHandle {
+    readonly id: number;
+}
+export declare class PointCloudRenderer {
+    private device;
+    private pipeline;
+    private nodes;
+    private nodeOwners;
+    private nextHandleId;
+    private uniformScratch;
+    private uniformScratchU32;
+    private options;
+    constructor(device: GPUDevice, colorFormat: GPUTextureFormat, depthFormat: GPUTextureFormat, sampleCount: number);
+    setOptions(opts: PointCloudRenderOptions): void;
+    getOptions(): Readonly<Required<PointCloudRenderOptions>>;
+    /**
+     * Replace every IFCx-owned asset with `assets`. Streamed assets are
+     * untouched. Use this from the viewer's IFCx sync hook.
+     */
+    setAssets(assets: ReadonlyArray<PointCloudAsset>): void;
+    addAsset(asset: PointCloudAsset): PointCloudAssetHandle;
+    /** Open an empty asset that chunks will be appended to. */
+    beginAsset(meta: PointCloudNodeMeta): PointCloudAssetHandle;
+    appendChunk(handle: PointCloudAssetHandle, chunk: PointCloudChunkInput): void;
+    /** Mark streaming complete. No-op for now — kept for symmetry. */
+    endAsset(handle: PointCloudAssetHandle): void;
+    removeAsset(handle: PointCloudAssetHandle): void;
+    /**
+     * Reassign a streamed asset's `expressId` after upload — used by
+     * `useIfcFederation` when the FederationRegistry hands out an
+     * `idOffset` for the model. The shader reads expressId from a
+     * per-asset uniform (flags.x), so this is just a metadata update;
+     * the next frame writes the new value into the GPU uniform without
+     * touching the per-vertex attributes.
+     */
+    relabelAsset(handle: PointCloudAssetHandle, newExpressId: number): void;
+    clear(): void;
+    private clearOwner;
+    hasAssets(): boolean;
+    getNodeCount(): number;
+    /**
+     * Iterate every uploaded node. Exposed so the deviation compute
+     * pass can reach each node's vertex + deviation buffers without
+     * the renderer having to mirror its internal map.
+     */
+    getInternalNodes(): Iterable<PointCloudNode>;
+    /** Total number of points currently uploaded across all assets. */
+    getPointCount(): number;
+    getBounds(): {
+        min: [number, number, number];
+        max: [number, number, number];
+    } | null;
+    /**
+     * Issue draw calls into an already-open render pass. The caller owns
+     * the encoder/pass and is responsible for the depth attachment.
+     */
+    draw(pass: GPURenderPassEncoder, state: PointCloudDrawState): void;
+    /**
+     * Resolve a packed objectId rgba8 sample back to the asset that owns it.
+     * Returns null when the sample doesn't match any asset's expressId.
+     */
+    resolvePick(expressId: number): {
+        handle: PointCloudAssetHandle;
+        meta: PointCloudNodeMeta;
+    } | null;
+    /**
+     * Snapshot of nodes shaped for the picker — only the data the GPU
+     * picking pass actually needs (expressId, modelIndex, chunk vertex
+     * buffers + counts). Returns a fresh array; callers may iterate
+     * freely without worrying about mutation during a pick.
+     */
+    getPickNodes(): Array<{
+        expressId: number;
+        modelIndex?: number;
+        chunks: Array<{
+            vertexBuffer: GPUBuffer;
+            pointCount: number;
+        }>;
+    }>;
+}
+//# sourceMappingURL=point-cloud-renderer.d.ts.map

package/dist/pointcloud/point-cloud-renderer.d.ts.map

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