@ifc-lite/renderer 3.2.0 → 4.2.0

package/dist/aabb-edges.d.ts

@@ -3,4 +3,14 @@
  * of a world-space AABB. Used to draw the clash-overlap wireframe box (#1277).
  */
 export declare function aabbEdgeLineList(min: readonly [number, number, number], max: readonly [number, number, number]): Float32Array;
+/**
+ * The same twelve edges in a local f32 frame.  Clash diagnostics receive
+ * world-f64 bounds, so materialising their corners as absolute f32 values at a
+ * national-grid coordinate would collapse a centimetre-wide interference box
+ * before the renderer can apply its RTE contract.
+ */
+export declare function anchoredAabbEdgeLineList(min: readonly [number, number, number], max: readonly [number, number, number]): {
+    localVertices: Float32Array;
+    origin: [number, number, number];
+};
 //# sourceMappingURL=aabb-edges.d.ts.map

package/dist/aabb-edges.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aabb-edges.d.ts","sourceRoot":"","sources":["../src/aabb-edges.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACtC,GAAG,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GACrC,YAAY,CAqBd"}
+{"version":3,"file":"aabb-edges.d.ts","sourceRoot":"","sources":["../src/aabb-edges.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACtC,GAAG,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GACrC,YAAY,CAqBd;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACtC,GAAG,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GACrC;IAAE,aAAa,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CASnE"}

package/dist/aabb-edges.js

@@ -31,4 +31,17 @@ export function aabbEdgeLineList(min, max) {
     }
     return out;
 }
+/**
+ * The same twelve edges in a local f32 frame.  Clash diagnostics receive
+ * world-f64 bounds, so materialising their corners as absolute f32 values at a
+ * national-grid coordinate would collapse a centimetre-wide interference box
+ * before the renderer can apply its RTE contract.
+ */
+export function anchoredAabbEdgeLineList(min, max) {
+    const origin = [min[0], min[1], min[2]];
+    return {
+        localVertices: aabbEdgeLineList([0, 0, 0], [max[0] - origin[0], max[1] - origin[1], max[2] - origin[2]]),
+        origin,
+    };
+}
 //# sourceMappingURL=aabb-edges.js.map

package/dist/aabb-edges.js.map

@@ -1 +1 @@
-{"version":3,"file":"aabb-edges.js","sourceRoot":"","sources":["../src/aabb-edges.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,GAAsC,EACtC,GAAsC;IAEtC,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC;IACzB,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC;IACzB,YAAY;IACZ,MAAM,CAAC,GAAG;QACR,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,UAAU;QAClE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,UAAU;KACnE,CAAC;IACF,iCAAiC;IACjC,MAAM,KAAK,GAAG;QACZ,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU;QAC1C,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU;QAC1C,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,YAAY;KAC7C,CAAC;IACF,MAAM,GAAG,GAAG,IAAI,YAAY,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACnD,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC;QAC3B,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3D,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}
+{"version":3,"file":"aabb-edges.js","sourceRoot":"","sources":["../src/aabb-edges.ts"],"names":[],"mappings":"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"}

package/dist/ao-params.d.ts

@@ -0,0 +1,85 @@
+import type { ContactShadingQuality, Mat4 } from './types.js';
+export type AoQuality = Exclude<ContactShadingQuality, 'off'>;
+export interface AoQualityPreset {
+    /** AO target is the drawing buffer divided by this (2 = half resolution). */
+    resolutionDivisor: 1 | 2;
+    /** Depth taps per AO texel. */
+    samples: number;
+    /** Turns of the sampling spiral; coprime-ish with `samples` so taps do not line up. */
+    spiralTurns: number;
+}
+export declare const AO_QUALITY_PRESETS: Readonly<Record<AoQuality, AoQualityPreset>>;
+/** Kernel slots in the uniform; every preset must fit. */
+export declare const AO_MAX_SAMPLES = 16;
+/**
+ * Accepted `contactShading.radius`, in world units (metres for IFC models,
+ * which the geometry pipeline normalises to metres).
+ */
+export declare const AO_RADIUS_RANGE: {
+    readonly min: 0.05;
+    readonly max: 10;
+};
+/**
+ * Cap on the projected radius, as a fraction of the drawing-buffer height.
+ * Close to the camera a 1 m radius covers most of the screen; the cap keeps
+ * the taps local (and texture-cache friendly) at the cost of a smaller
+ * effective radius there.
+ */
+export declare const AO_MAX_RADIUS_FRACTION = 0.15;
+/**
+ * Cosine bias: a tap must rise at least this far above the tangent plane to
+ * occlude. Suppresses self-occlusion from depth quantisation on flat faces.
+ */
+export declare const AO_COSINE_BIAS = 0.1;
+/**
+ * Relative depth difference at which the bilateral blur and the upsample
+ * stop mixing two AO texels (a silhouette or a step, not the same surface).
+ */
+export declare const AO_DEPTH_TOLERANCE = 0.04;
+/**
+ * The composite darkens by `min(occlusion * AO_GAIN * intensity,
+ * AO_MAX_DARKEN)`. `occlusion` is the tap average in [0, 1]: 1 would need
+ * every tap straight above the tangent plane and at zero distance, so real
+ * corners read well below it and the gain lifts them into view.
+ */
+export declare const AO_GAIN = 2;
+/** Darkening never exceeds this, so a crevice keeps its colour. */
+export declare const AO_MAX_DARKEN = 0.85;
+/** Size of the AO target for a drawing buffer at `quality`. */
+export declare function aoTargetSize(width: number, height: number, quality: AoQuality): {
+    width: number;
+    height: number;
+};
+/**
+ * Unit-disk sample offsets on a spiral (the SAO pattern): tap `i` sits at
+ * radius `(i + 0.5) / samples` and angle `radius * turns * 2pi`. Radii grow
+ * linearly, so taps crowd towards the centre where contact occlusion lives.
+ * Returns `AO_MAX_SAMPLES` (x, y) pairs; slots past `samples` are zero.
+ */
+export declare function spiralKernel(samples: number, turns: number): Float32Array;
+/** Float offsets of the `AoParams` struct fields in `shaders/ao.wgsl.ts`. */
+export declare const AO_UNIFORM_LAYOUT: {
+    readonly depthParams: 0;
+    readonly xyParams: 4;
+    readonly viewport: 8;
+    readonly ao: 12;
+    readonly misc: 16;
+    readonly kernel: 20;
+};
+/** Byte size of `AoParams` (13 vec4s: five of parameters, eight of kernel). */
+export declare const AO_UNIFORM_BYTES: number;
+export interface AoFrameParams {
+    /** Camera projection the frame was drawn with (reverse-Z). */
+    projection: Mat4;
+    /** Drawing-buffer size in pixels. */
+    width: number;
+    height: number;
+    quality: AoQuality;
+    /** World-space radius, already clamped to `AO_RADIUS_RANGE`. */
+    radius: number;
+    /** Darkening strength, already clamped to [0, 1]. */
+    intensity: number;
+}
+/** Pack one frame's `AoParams` into `out` (`AO_UNIFORM_BYTES / 4` floats). */
+export declare function packAoUniforms(out: Float32Array, frame: AoFrameParams): void;
+//# sourceMappingURL=ao-params.d.ts.map

package/dist/ao-params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ao-params.d.ts","sourceRoot":"","sources":["../src/ao-params.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,qBAAqB,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAE9D,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;AAE9D,MAAM,WAAW,eAAe;IAC9B,6EAA6E;IAC7E,iBAAiB,EAAE,CAAC,GAAG,CAAC,CAAC;IACzB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,uFAAuF;IACvF,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,eAAe,CAAC,CAG3E,CAAC;AAEF,0DAA0D;AAC1D,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC;;;GAGG;AACH,eAAO,MAAM,eAAe;;;CAAkC,CAAC;AAE/D;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,cAAc,MAAM,CAAC;AAElC;;;GAGG;AACH,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC;;;;;GAKG;AACH,eAAO,MAAM,OAAO,IAAM,CAAC;AAE3B,mEAAmE;AACnE,eAAO,MAAM,aAAa,OAAO,CAAC;AAElC,+DAA+D;AAC/D,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAGjH;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,CAYzE;AAQD,6EAA6E;AAC7E,eAAO,MAAM,iBAAiB;;;;;;;CAOpB,CAAC;AAEX,+EAA+E;AAC/E,eAAO,MAAM,gBAAgB,QAAsD,CAAC;AAEpF,MAAM,WAAW,aAAa;IAC5B,8DAA8D;IAC9D,UAAU,EAAE,IAAI,CAAC;IACjB,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,SAAS,CAAC;IACnB,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI,CAmB5E"}

package/dist/ao-params.js

@@ -0,0 +1,109 @@
+/* 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/. */
+/**
+ * CPU side of the screen-space ambient occlusion pass (#5384): quality
+ * presets, the sampling kernel and the uniform layout shared with
+ * `shaders/ao.wgsl.ts`. Pure functions, so the numbers the GPU sees are
+ * unit-tested.
+ */
+import { depthReconstructParams, pixelsPerWorldUnit } from './depth-reconstruct.js';
+export const AO_QUALITY_PRESETS = {
+    low: { resolutionDivisor: 2, samples: 12, spiralTurns: 5 },
+    high: { resolutionDivisor: 1, samples: 16, spiralTurns: 7 },
+};
+/** Kernel slots in the uniform; every preset must fit. */
+export const AO_MAX_SAMPLES = 16;
+/**
+ * Accepted `contactShading.radius`, in world units (metres for IFC models,
+ * which the geometry pipeline normalises to metres).
+ */
+export const AO_RADIUS_RANGE = { min: 0.05, max: 10 };
+/**
+ * Cap on the projected radius, as a fraction of the drawing-buffer height.
+ * Close to the camera a 1 m radius covers most of the screen; the cap keeps
+ * the taps local (and texture-cache friendly) at the cost of a smaller
+ * effective radius there.
+ */
+export const AO_MAX_RADIUS_FRACTION = 0.15;
+/**
+ * Cosine bias: a tap must rise at least this far above the tangent plane to
+ * occlude. Suppresses self-occlusion from depth quantisation on flat faces.
+ */
+export const AO_COSINE_BIAS = 0.1;
+/**
+ * Relative depth difference at which the bilateral blur and the upsample
+ * stop mixing two AO texels (a silhouette or a step, not the same surface).
+ */
+export const AO_DEPTH_TOLERANCE = 0.04;
+/**
+ * The composite darkens by `min(occlusion * AO_GAIN * intensity,
+ * AO_MAX_DARKEN)`. `occlusion` is the tap average in [0, 1]: 1 would need
+ * every tap straight above the tangent plane and at zero distance, so real
+ * corners read well below it and the gain lifts them into view.
+ */
+export const AO_GAIN = 2.0;
+/** Darkening never exceeds this, so a crevice keeps its colour. */
+export const AO_MAX_DARKEN = 0.85;
+/** Size of the AO target for a drawing buffer at `quality`. */
+export function aoTargetSize(width, height, quality) {
+    const d = AO_QUALITY_PRESETS[quality].resolutionDivisor;
+    return { width: Math.max(1, Math.ceil(width / d)), height: Math.max(1, Math.ceil(height / d)) };
+}
+/**
+ * Unit-disk sample offsets on a spiral (the SAO pattern): tap `i` sits at
+ * radius `(i + 0.5) / samples` and angle `radius * turns * 2pi`. Radii grow
+ * linearly, so taps crowd towards the centre where contact occlusion lives.
+ * Returns `AO_MAX_SAMPLES` (x, y) pairs; slots past `samples` are zero.
+ */
+export function spiralKernel(samples, turns) {
+    if (!Number.isInteger(samples) || samples < 1 || samples > AO_MAX_SAMPLES) {
+        throw new RangeError(`AO sample count must be an integer in [1, ${AO_MAX_SAMPLES}], got ${samples}`);
+    }
+    const out = new Float32Array(AO_MAX_SAMPLES * 2);
+    for (let i = 0; i < samples; i++) {
+        const r = (i + 0.5) / samples;
+        const a = r * turns * 2 * Math.PI;
+        out[i * 2] = r * Math.cos(a);
+        out[i * 2 + 1] = r * Math.sin(a);
+    }
+    return out;
+}
+/** Each preset's kernel, built once. */
+const PRESET_KERNELS = {
+    low: spiralKernel(AO_QUALITY_PRESETS.low.samples, AO_QUALITY_PRESETS.low.spiralTurns),
+    high: spiralKernel(AO_QUALITY_PRESETS.high.samples, AO_QUALITY_PRESETS.high.spiralTurns),
+};
+/** Float offsets of the `AoParams` struct fields in `shaders/ao.wgsl.ts`. */
+export const AO_UNIFORM_LAYOUT = {
+    depthParams: 0,
+    xyParams: 4,
+    viewport: 8,
+    ao: 12,
+    misc: 16,
+    kernel: 20,
+};
+/** Byte size of `AoParams` (13 vec4s: five of parameters, eight of kernel). */
+export const AO_UNIFORM_BYTES = (AO_UNIFORM_LAYOUT.kernel + AO_MAX_SAMPLES * 2) * 4;
+/** Pack one frame's `AoParams` into `out` (`AO_UNIFORM_BYTES / 4` floats). */
+export function packAoUniforms(out, frame) {
+    const preset = AO_QUALITY_PRESETS[frame.quality];
+    const recon = depthReconstructParams(frame.projection);
+    const L = AO_UNIFORM_LAYOUT;
+    out.set(recon.depth, L.depthParams);
+    out.set(recon.xy, L.xyParams);
+    out[L.viewport] = frame.width;
+    out[L.viewport + 1] = frame.height;
+    out[L.viewport + 2] = 1 / frame.width;
+    out[L.viewport + 3] = 1 / frame.height;
+    out[L.ao] = frame.radius;
+    out[L.ao + 1] = pixelsPerWorldUnit(frame.projection, frame.height);
+    out[L.ao + 2] = AO_MAX_RADIUS_FRACTION * frame.height;
+    out[L.ao + 3] = frame.intensity;
+    out[L.misc] = preset.resolutionDivisor;
+    out[L.misc + 1] = preset.samples;
+    out[L.misc + 2] = AO_COSINE_BIAS;
+    out[L.misc + 3] = AO_DEPTH_TOLERANCE;
+    out.set(PRESET_KERNELS[frame.quality], L.kernel);
+}
+//# sourceMappingURL=ao-params.js.map

package/dist/ao-params.js.map

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

package/dist/ao-pass.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Screen-space ambient occlusion pass (#5384): the GPU side of
+ * `shaders/ao.wgsl.ts`. It reads the scene depth attachment after the main
+ * pass and multiplies the resolved colour by the occlusion it finds.
+ *
+ * Passes per frame: AO (half resolution at `low`, full at `high`), a
+ * horizontal and a vertical bilateral blur at the same resolution, and a
+ * full-resolution composite onto the canvas with the darken blend the other
+ * overlays use (`dst * (1 - srcAlpha)`).
+ *
+ * Owns two `rg16float` targets (occlusion + linear depth, and the blur
+ * scratch). They follow the drawing-buffer size and the quality, are
+ * rebuilt when either changes, and are released by `destroy()`; the renderer
+ * drops the whole pass when AO is switched off and on teardown (device loss
+ * re-creates it on the next AO frame).
+ */
+import { type AoFrameParams } from './ao-params.js';
+export interface AoPassFrame {
+    encoder: GPUCommandEncoder;
+    /** Resolved colour to darken (the canvas texture). */
+    targetView: GPUTextureView;
+    /** Depth-only view of the scene depth attachment. */
+    depthView: GPUTextureView;
+    params: AoFrameParams;
+}
+export declare class AoPass {
+    private readonly device;
+    private readonly uniformBuffer;
+    private readonly uniformScratch;
+    private readonly aoLayout;
+    private readonly filterLayout;
+    private readonly aoPipeline;
+    private readonly blurHPipeline;
+    private readonly blurVPipeline;
+    private readonly compositePipeline;
+    private targets;
+    private bindGroups;
+    private destroyed;
+    constructor(device: GPUDevice, colorFormat: GPUTextureFormat, sampleCount: number);
+    encode(frame: AoPassFrame): void;
+    private ensureTargets;
+    private ensureBindGroups;
+    private releaseTargets;
+    /** Release every GPU resource. Idempotent; the pass is unusable afterwards. */
+    destroy(): void;
+}
+//# sourceMappingURL=ao-pass.d.ts.map

package/dist/ao-pass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ao-pass.d.ts","sourceRoot":"","sources":["../src/ao-pass.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAkD,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAKpG,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,sDAAsD;IACtD,UAAU,EAAE,cAAc,CAAC;IAC3B,qDAAqD;IACrD,SAAS,EAAE,cAAc,CAAC;IAC1B,MAAM,EAAE,aAAa,CAAC;CACvB;AAmBD,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAY;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA0C;IACzE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAoB;IAClD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAoB;IAClD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoB;IACtD,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,UAAU,CAA6B;IAC/C,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM;IAkDjF,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAyBhC,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,gBAAgB;IAoBxB,OAAO,CAAC,cAAc;IAQtB,+EAA+E;IAC/E,OAAO,IAAI,IAAI;CAMhB"}

package/dist/ao-pass.js

@@ -0,0 +1,157 @@
+/* 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/. */
+/**
+ * Screen-space ambient occlusion pass (#5384): the GPU side of
+ * `shaders/ao.wgsl.ts`. It reads the scene depth attachment after the main
+ * pass and multiplies the resolved colour by the occlusion it finds.
+ *
+ * Passes per frame: AO (half resolution at `low`, full at `high`), a
+ * horizontal and a vertical bilateral blur at the same resolution, and a
+ * full-resolution composite onto the canvas with the darken blend the other
+ * overlays use (`dst * (1 - srcAlpha)`).
+ *
+ * Owns two `rg16float` targets (occlusion + linear depth, and the blur
+ * scratch). They follow the drawing-buffer size and the quality, are
+ * rebuilt when either changes, and are released by `destroy()`; the renderer
+ * drops the whole pass when AO is switched off and on teardown (device loss
+ * re-creates it on the next AO frame).
+ */
+import { AO_UNIFORM_BYTES, aoTargetSize, packAoUniforms } from './ao-params.js';
+import { aoShaderSource } from './shaders/ao.wgsl.js';
+const AO_TARGET_FORMAT = 'rg16float';
+export class AoPass {
+    device;
+    uniformBuffer;
+    uniformScratch = new Float32Array(AO_UNIFORM_BYTES / 4);
+    aoLayout;
+    filterLayout;
+    aoPipeline;
+    blurHPipeline;
+    blurVPipeline;
+    compositePipeline;
+    targets = null;
+    bindGroups = null;
+    destroyed = false;
+    constructor(device, colorFormat, sampleCount) {
+        this.device = device;
+        this.uniformBuffer = device.createBuffer({
+            label: 'ao-uniforms',
+            size: AO_UNIFORM_BYTES,
+            usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST,
+        });
+        const depthEntry = {
+            binding: 0,
+            visibility: GPUShaderStage.FRAGMENT,
+            texture: { sampleType: 'depth', viewDimension: '2d', multisampled: sampleCount > 1 },
+        };
+        const paramsEntry = {
+            binding: 1,
+            visibility: GPUShaderStage.FRAGMENT,
+            buffer: { type: 'uniform' },
+        };
+        this.aoLayout = device.createBindGroupLayout({ label: 'ao-bgl', entries: [depthEntry, paramsEntry] });
+        this.filterLayout = device.createBindGroupLayout({
+            label: 'ao-filter-bgl',
+            entries: [
+                depthEntry,
+                paramsEntry,
+                { binding: 2, visibility: GPUShaderStage.FRAGMENT, texture: { sampleType: 'unfilterable-float' } },
+            ],
+        });
+        const module = device.createShaderModule({ label: 'ao-shader', code: aoShaderSource(sampleCount > 1) });
+        const make = (label, layout, entryPoint, target) => device.createRenderPipeline({
+            label,
+            layout: device.createPipelineLayout({ bindGroupLayouts: [layout] }),
+            vertex: { module, entryPoint: 'vs_fullscreen' },
+            fragment: { module, entryPoint, targets: [target] },
+            primitive: { topology: 'triangle-list', cullMode: 'none' },
+        });
+        this.aoPipeline = make('ao-pipeline', this.aoLayout, 'fs_ao', { format: AO_TARGET_FORMAT });
+        this.blurHPipeline = make('ao-blur-h-pipeline', this.filterLayout, 'fs_blur_h', { format: AO_TARGET_FORMAT });
+        this.blurVPipeline = make('ao-blur-v-pipeline', this.filterLayout, 'fs_blur_v', { format: AO_TARGET_FORMAT });
+        this.compositePipeline = make('ao-composite-pipeline', this.filterLayout, 'fs_composite', {
+            format: colorFormat,
+            // Darken overlay: dst' = dst * (1 - srcAlpha); canvas alpha untouched.
+            blend: {
+                color: { srcFactor: 'zero', dstFactor: 'one-minus-src-alpha' },
+                alpha: { srcFactor: 'zero', dstFactor: 'one' },
+            },
+        });
+    }
+    encode(frame) {
+        if (this.destroyed)
+            return;
+        const { width, height } = aoTargetSize(frame.params.width, frame.params.height, frame.params.quality);
+        const targets = this.ensureTargets(width, height);
+        const groups = this.ensureBindGroups(targets, frame.depthView);
+        packAoUniforms(this.uniformScratch, frame.params);
+        this.device.queue.writeBuffer(this.uniformBuffer, 0, this.uniformScratch);
+        const run = (label, view, pipeline, group, load) => {
+            const pass = frame.encoder.beginRenderPass({
+                label,
+                colorAttachments: [{ view, loadOp: load, storeOp: 'store', clearValue: { r: 0, g: 0, b: 0, a: 0 } }],
+            });
+            pass.setPipeline(pipeline);
+            pass.setBindGroup(0, group);
+            pass.draw(3, 1, 0, 0);
+            pass.end();
+        };
+        run('ao', targets.aoView, this.aoPipeline, groups.ao, 'clear');
+        run('ao-blur-h', targets.scratchView, this.blurHPipeline, groups.blurH, 'clear');
+        run('ao-blur-v', targets.aoView, this.blurVPipeline, groups.blurV, 'clear');
+        run('ao-composite', frame.targetView, this.compositePipeline, groups.composite, 'load');
+    }
+    ensureTargets(width, height) {
+        const current = this.targets;
+        if (current && current.width === width && current.height === height)
+            return current;
+        this.releaseTargets();
+        const make = (label) => this.device.createTexture({
+            label,
+            size: { width, height },
+            format: AO_TARGET_FORMAT,
+            usage: GPUTextureUsage.RENDER_ATTACHMENT | GPUTextureUsage.TEXTURE_BINDING,
+        });
+        const ao = make('ao-target');
+        const scratch = make('ao-scratch');
+        this.targets = { width, height, ao, scratch, aoView: ao.createView(), scratchView: scratch.createView() };
+        return this.targets;
+    }
+    ensureBindGroups(targets, depthView) {
+        const current = this.bindGroups;
+        if (current && current.depthView === depthView)
+            return current;
+        const params = { binding: 1, resource: { buffer: this.uniformBuffer } };
+        const depth = { binding: 0, resource: depthView };
+        const filter = (label, input) => this.device.createBindGroup({
+            label,
+            layout: this.filterLayout,
+            entries: [depth, params, { binding: 2, resource: input }],
+        });
+        this.bindGroups = {
+            depthView,
+            ao: this.device.createBindGroup({ label: 'ao-bg', layout: this.aoLayout, entries: [depth, params] }),
+            blurH: filter('ao-blur-h-bg', targets.aoView),
+            blurV: filter('ao-blur-v-bg', targets.scratchView),
+            composite: filter('ao-composite-bg', targets.aoView),
+        };
+        return this.bindGroups;
+    }
+    releaseTargets() {
+        this.targets?.ao.destroy();
+        this.targets?.scratch.destroy();
+        this.targets = null;
+        // Bind groups reference the old views.
+        this.bindGroups = null;
+    }
+    /** Release every GPU resource. Idempotent; the pass is unusable afterwards. */
+    destroy() {
+        if (this.destroyed)
+            return;
+        this.destroyed = true;
+        this.releaseTargets();
+        this.uniformBuffer.destroy();
+    }
+}
+//# sourceMappingURL=ao-pass.js.map

package/dist/ao-pass.js.map

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

package/dist/camera-matrices.d.ts

@@ -1,4 +1,7 @@
+import { type RelativeToEyeFrame } from './relative-to-eye.js';
 import type { CameraInternalState } from './camera-state.js';
+/** Mirror lookAt's effective eye without rewriting the caller's malformed pose. */
+export declare function updateCameraRelativeFrame(state: CameraInternalState, frame: RelativeToEyeFrame): void;
 export declare function updateCameraMatrices(state: CameraInternalState): void;
 /**
  * Compute tight near/far for orthographic mode by projecting the scene

package/dist/camera-matrices.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"camera-matrices.d.ts","sourceRoot":"","sources":["../src/camera-matrices.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAG7D,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,CA4DrE;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,mBAAmB,EAC1B,QAAQ,EAAE,MAAM,GACf;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAyE/B"}
+{"version":3,"file":"camera-matrices.d.ts","sourceRoot":"","sources":["../src/camera-matrices.ts"],"names":[],"mappings":"AAwBA,OAAO,EAA6B,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAG7D,mFAAmF;AACnF,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,mBAAmB,EAAE,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAQrG;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,CA4DrE;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,mBAAmB,EAC1B,QAAQ,EAAE,MAAM,GACf;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAyE/B"}

package/dist/camera-matrices.js

@@ -19,8 +19,19 @@
  * `orthographicReverseZ` and `multiply` each already return a fresh `Mat4`,
  * and the ortho branch already returned a fresh `{near, far}` per frame.
  */
-import { MathUtils } from './math.js';
+import { MathUtils, viewBasis } from './math.js';
+import { MAX_RTE_SOURCE_ABS_METRES } from './relative-to-eye.js';
 import { DEFAULT_ORTHO_SIZE, usableOrthoSize } from './camera-guards.js';
+/** Mirror lookAt's effective eye without rewriting the caller's malformed pose. */
+export function updateCameraRelativeFrame(state, frame) {
+    const eye = viewBasis(state.camera.position, state.camera.target, state.camera.up).eye;
+    if ([eye.x, eye.y, eye.z].some(value => !Number.isFinite(value) || Math.abs(value) > MAX_RTE_SOURCE_ABS_METRES)
+        || !state.projMatrix.m.every(Number.isFinite) || !state.viewMatrix.m.every(Number.isFinite)) {
+        frame.invalidate();
+        return;
+    }
+    frame.update(eye, state.projMatrix, state.viewMatrix);
+}
 export function updateCameraMatrices(state) {
     const dx = state.camera.position.x - state.camera.target.x;
     const dy = state.camera.position.y - state.camera.target.y;

package/dist/camera-matrices.js.map

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

package/dist/camera-orientation.d.ts

@@ -0,0 +1,62 @@
+import type { CameraInternalState } from './camera-state.js';
+import type { CameraAnimator } from './camera-animation.js';
+/** Absolute orientation and readouts share the camera's authored f64 pose. */
+export declare class CameraOrientation {
+    private readonly state;
+    private readonly animator;
+    private readonly updateMatrices;
+    constructor(state: CameraInternalState, animator: CameraAnimator, updateMatrices: () => void);
+    /**
+     * Get distance from camera position to target.
+     *
+     * Deliberately **unsanitized**: it reports the pose as it actually is, so a
+     * malformed one (a BCF viewpoint restored from a file reaches the public
+     * setters unvalidated) yields NaN rather than a substituted number. This is
+     * a measurement, not a control input: it is what `useBCF` reads back when
+     * restoring a viewpoint and what the BCF overlay scales markers by. There is
+     * no substitute that is right for every reader — a plausible-looking `1`
+     * would place every restored target one unit from the eye — and returning a
+     * number here would contradict `getPosition()`/`getTarget()`, which are raw,
+     * leaving callers no way to tell that the pose is broken. Gesture code inside
+     * this package guards with {@link isUsableDistance} instead; each gesture
+     * needs a different fallback. Callers OUTSIDE the package cannot use that
+     * predicate (it is package-internal) and are not all guarded — see #2466 for
+     * the viewpoint-restore path (#2441).
+     */
+    getDistance(): number;
+    /**
+     * Get current camera rotation angles in degrees
+     * Returns { azimuth, elevation } where:
+     * - azimuth: horizontal rotation (0-360), 0 = front
+     * - elevation: vertical rotation (-90 to 90), 0 = horizon
+     */
+    getRotation(): {
+        azimuth: number;
+        elevation: number;
+    };
+    /**
+     * Place the camera at an ABSOLUTE orientation around its current target,
+     * in the same angle convention {@link getRotation} reports — the exact
+     * inverse of it, so `setRotation(a, e)` then `getRotation()` returns
+     * `{ azimuth: a, elevation: e }` (modulo the normalisation and pole clamp
+     * below).
+     *
+     * This is the only absolute-orientation entry point on the camera. Everything
+     * else is relative (`orbit`, and the viewer's 90° rotate steppers built on it)
+     * or names a direction rather than an angle (`setPresetView`), which is why a
+     * host command that says "go to azimuth 120°, elevation 30°" had nothing to
+     * call and silently did nothing (#2934).
+     *
+     * The orbit radius and the target are preserved — this rotates the camera on
+     * its current sphere, it does not reframe. `up` is reset to world Y, matching
+     * `orbit`, so the reported azimuth comes back through `getRotation`'s
+     * position-based branch.
+     *
+     * @param azimuth Horizontal angle in degrees; normalised into [0, 360).
+     * @param elevation Vertical angle in degrees, 0 = horizon. Clamped to just
+     *   inside ±90° (the same `MIN_PHI` margin `orbit` uses) — the exact poles
+     *   collapse `cross(forward, up)` and flip the model.
+     */
+    setRotation(azimuth: number, elevation: number): void;
+}
+//# sourceMappingURL=camera-orientation.d.ts.map

package/dist/camera-orientation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera-orientation.d.ts","sourceRoot":"","sources":["../src/camera-orientation.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAI5D,8EAA8E;AAC9E,qBAAa,iBAAiB;IAE1B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,cAAc;gBAFd,KAAK,EAAE,mBAAmB,EAC1B,QAAQ,EAAE,cAAc,EACxB,cAAc,EAAE,MAAM,IAAI;IAG7C;;;;;;;;;;;;;;;;OAgBG;IACH,WAAW,IAAI,MAAM;IASrB;;;;;OAKG;IACH,WAAW,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;IA6CrD;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;CAmDtD"}