abstract-3d 3.1.2 → 4.0.0-beta.0

package/lib/renderers/three/text.js

@@ -0,0 +1,151 @@
+import TinySDF from "@mapbox/tiny-sdf";
+import { Color, DataTexture, FrontSide, InstancedBufferAttribute, InstancedMesh, LinearFilter, Matrix4, PlaneGeometry, RedFormat, UnsignedByteType, Vector3, } from "three";
+import { float, fwidth, instancedBufferAttribute, smoothstep, texture as textureNode, uv } from "three/tsl";
+import { MeshBasicNodeMaterial } from "three/webgpu";
+/** Text as signed distance field glyphs from the system font, packed into one atlas texture, so all text draws in one call */
+export const RASTER_SIZE = 40;
+export const SDF_BUFFER = 4;
+const SDF_RADIUS = 10;
+/** The distance field's value at the glyph's edge, from tiny-sdf's default cutoff of 0.25 */
+export const SDF_EDGE = 0.75;
+const FONT_FAMILY = "Helvetica, Arial, sans-serif";
+const LINE_HEIGHT = 1.5;
+const LETTER_SPACING = 0.001;
+/** Of the font size, above the baseline, to center a line's glyphs in it */
+const ASCENT = 0.8;
+/** Rasterizes with the OS's built-in Helvetica or Arial, on a canvas created at first use */
+export function createSystemFontRasterizer() {
+    const sdf = {};
+    return (char) => {
+        sdf.current ??= new TinySDF({ fontSize: RASTER_SIZE, buffer: SDF_BUFFER, radius: SDF_RADIUS, fontFamily: FONT_FAMILY });
+        return sdf.current.draw(char);
+    };
+}
+export function createGlyphAtlas(rasterize = createSystemFontRasterizer(), size = 1024) {
+    const data = new Uint8Array(size * size);
+    const texture = new DataTexture(data, size, size, RedFormat, UnsignedByteType);
+    texture.minFilter = LinearFilter;
+    texture.magFilter = LinearFilter;
+    texture.generateMipmaps = false;
+    const glyphs = new Map();
+    const shelf = { x: 0, y: 0, height: 0 };
+    const pack = (bitmap) => {
+        if (shelf.x + bitmap.width > size) {
+            Object.assign(shelf, { x: 0, y: shelf.y + shelf.height, height: 0 });
+        }
+        if (shelf.y + bitmap.height > size) {
+            return undefined;
+        }
+        const [x, y] = [shelf.x, shelf.y];
+        for (let row = 0; row < bitmap.height; row++) {
+            data.set(bitmap.data.subarray(row * bitmap.width, (row + 1) * bitmap.width), (y + row) * size + x);
+        }
+        Object.assign(shelf, { x: x + bitmap.width, height: Math.max(shelf.height, bitmap.height) });
+        texture.needsUpdate = true;
+        // Bitmap rows run top down from the texture's v = 0, while the quad's uv runs bottom up
+        return [x / size, (y + bitmap.height) / size, bitmap.width / size, -bitmap.height / size];
+    };
+    const getGlyph = (char) => {
+        const cached = glyphs.get(char);
+        if (cached) {
+            return cached;
+        }
+        const bitmap = rasterize(char);
+        const hasInk = bitmap.width > 2 * SDF_BUFFER && bitmap.height > 2 * SDF_BUFFER;
+        const rect = hasInk ? pack(bitmap) : undefined;
+        const glyph = {
+            rect: rect ?? [0, 0, 0, 0],
+            left: (bitmap.glyphLeft - SDF_BUFFER) / RASTER_SIZE,
+            top: (bitmap.glyphTop + SDF_BUFFER) / RASTER_SIZE,
+            width: rect ? bitmap.width / RASTER_SIZE : 0,
+            height: rect ? bitmap.height / RASTER_SIZE : 0,
+            advance: bitmap.glyphAdvance / RASTER_SIZE,
+        };
+        glyphs.set(char, glyph);
+        return glyph;
+    };
+    return { texture, getGlyph, dispose: () => texture.dispose() };
+}
+/** Lays out the text centered on the origin, each line centered, as drei's Text did */
+export function layoutText(text, fontSize, getGlyph) {
+    const lineHeight = LINE_HEIGHT * fontSize;
+    const lines = text.split("\n");
+    const top = (lines.length * lineHeight) / 2;
+    return lines.flatMap((line, i) => {
+        const glyphs = Array.from(line, getGlyph);
+        const advances = glyphs.map((g) => (g.advance + LETTER_SPACING) * fontSize);
+        const baseline = top - i * lineHeight - (lineHeight - fontSize) / 2 - ASCENT * fontSize;
+        const starts = advances.reduce((acc, a, j) => [...acc, acc[j] + a], [-advances.reduce((sum, a) => sum + a, 0) / 2]);
+        return glyphs.flatMap((glyph, j) => glyph.width === 0
+            ? []
+            : [
+                {
+                    glyph,
+                    x: starts[j] + (glyph.left + glyph.width / 2) * fontSize,
+                    y: baseline + (glyph.top - glyph.height / 2) * fontSize,
+                    width: glyph.width * fontSize,
+                    height: glyph.height * fontSize,
+                },
+            ]);
+    });
+}
+/** All texts of a part as glyph quads of one instanced mesh, each slot a text */
+export function createTextPart(entries, atlas) {
+    const layouts = entries.map((e) => layoutText(e.text, e.fontSize, atlas.getGlyph));
+    const firsts = layouts.reduce((acc, quads, i) => [...acc, acc[i] + quads.length], [0]);
+    const count = firsts[layouts.length];
+    const quads = layouts.flat();
+    const slotOfGlyph = Int32Array.from(layouts.flatMap((l, slot) => l.map(() => slot)));
+    const rects = new InstancedBufferAttribute(Float32Array.from(quads.flatMap((q) => q.glyph.rect)), 4);
+    const opacities = new InstancedBufferAttribute(new Float32Array(count).fill(1), 1);
+    const glyphMatrices = quads.map((q) => new Matrix4().makeTranslation(q.x, q.y, 0).scale(scale.set(q.width, q.height, 1)));
+    const geometry = new PlaneGeometry();
+    const mesh = new InstancedMesh(geometry, createTextMaterial(atlas.texture, rects, opacities), count);
+    // Drawn after the opaque batches, and never culled as a whole, as its glyphs move with their items
+    mesh.renderOrder = 1;
+    mesh.frustumCulled = false;
+    return {
+        object: mesh,
+        place: (slot, matrix) => {
+            const text = scratch.multiplyMatrices(matrix, entries[slot].local);
+            for (let i = firsts[slot]; i < firsts[slot + 1]; i++) {
+                mesh.setMatrixAt(i, glyph.multiplyMatrices(text, glyphMatrices[i]));
+            }
+            mesh.boundingSphere = null;
+        },
+        paint: (slot, rgba) => {
+            color.setRGB(rgba.x, rgba.y, rgba.z);
+            for (let i = firsts[slot]; i < firsts[slot + 1]; i++) {
+                mesh.setColorAt(i, color);
+                opacities.setX(i, rgba.w);
+            }
+        },
+        flush: () => {
+            mesh.instanceMatrix.needsUpdate = true;
+            if (mesh.instanceColor) {
+                mesh.instanceColor.needsUpdate = true;
+            }
+            opacities.needsUpdate = true;
+        },
+        pickSlot: (hit) => (hit.instanceId === undefined ? undefined : slotOfGlyph[hit.instanceId]),
+        dispose: () => {
+            geometry.dispose();
+            mesh.material.dispose();
+            mesh.dispose();
+        },
+    };
+}
+/** White glyphs, colored per instance, with antialiased edges from the distance field's screen-space gradient */
+function createTextMaterial(atlas, rects, opacities) {
+    const material = new MeshBasicNodeMaterial({ side: FrontSide, transparent: true, depthWrite: false });
+    const rect = instancedBufferAttribute(rects, "vec4");
+    const distance = textureNode(atlas, uv().mul(rect.zw).add(rect.xy)).r;
+    const edge = fwidth(distance).mul(0.7);
+    material.opacityNode = smoothstep(float(SDF_EDGE).sub(edge), float(SDF_EDGE).add(edge), distance).mul(instancedBufferAttribute(opacities, "float"));
+    return material;
+}
+const scratch = new Matrix4();
+const glyph = new Matrix4();
+const scale = new Vector3();
+const color = new Color();
+//# sourceMappingURL=text.js.map

package/lib/renderers/three/text.js.map

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

package/lib/renderers/three/viewer/options.d.ts

@@ -0,0 +1,71 @@
+import type { Object3D, Texture } from "three";
+import type { Group, Relation, Scene, Vec3, View } from "../../../abstract-3d.js";
+import type { MaterialState } from "../appearance/appearance.js";
+import type { BufferZones, CameraOptions } from "../camera/camera.js";
+import type { ControlsOptions } from "../camera/controls.js";
+import type { ControlsHelper } from "../camera/gizmo.js";
+import type { Quality } from "../quality/quality.js";
+import type { MountOverlays } from "./overlays.js";
+/** The viewer's options, and what passing each of them in an update redoes; telling which actually changed is the caller's, e.g. React's dependencies */
+export type Popover<Content> = {
+    readonly id: string;
+    readonly pos: Vec3;
+    readonly content: Content;
+};
+export type SceneEvent = {
+    readonly nativeEvent: MouseEvent;
+    /** Where the pointer hit, in world space */
+    readonly point: Vec3;
+};
+/** A group's data: of the top-level group, and of the group the hit mesh is in */
+type Data = Record<string, string> | undefined;
+export type ViewerOptions<Content> = {
+    /** Undefined shows the fallback */
+    readonly scene?: Scene;
+    /** The id of a top-level group, which its hover, selection, material state and events are by; groups without an id can't be clicked */
+    readonly createGroupId?: (g: Group) => string;
+    readonly selectedIds?: Record<string, boolean>;
+    readonly hoveredIds?: ReadonlyArray<string>;
+    readonly activeComponents?: Record<string, MaterialState>;
+    /**
+     * The ids of the relations whose shape is drawn to be clicked, e.g. where a component can be inserted. While defined, even when empty, only the
+     * groups whose material state is Accept can be clicked
+     */
+    readonly activeRelations?: ReadonlyArray<string>;
+    readonly showDimensions?: boolean;
+    /** View, buffer zones and padding are read when the scene is fitted: first, and for a new camera or canvas size */
+    readonly camera?: CameraOptions;
+    readonly view?: View;
+    readonly bufferZones?: BufferZones;
+    readonly fitPadding?: number;
+    readonly controls?: ControlsOptions;
+    readonly gizmo?: ControlsHelper;
+    /** Replace the default lights, a weak ambient light, a key light from the upper left and two fills */
+    readonly lights?: ReadonlyArray<Object3D> | ((scene: Scene) => ReadonlyArray<Object3D>);
+    /** Lights faces by which way they turn and gives metal reflections: `studio` by default, `room` for three's RoomEnvironment, or null for none */
+    readonly environment?: Texture | "studio" | "room" | null;
+    readonly environmentIntensity?: number;
+    /** `low` by default, without ambient occlusion */
+    readonly quality?: Quality;
+    readonly useAlphaTest?: boolean;
+    readonly materialStateImages?: Record<string, string>;
+    readonly popovers?: ReadonlyArray<Popover<Content>>;
+    readonly getTooltips?: (id: string) => ReadonlyArray<Popover<Content>>;
+    /** Mounts popover and tooltip content, e.g. as React portals; without it, strings and DOM nodes are mounted directly */
+    readonly onOverlays?: MountOverlays<Content>;
+    /** A built scene's shaders are compiled, so its first frame renders without a stall, e.g. to hide a fallback */
+    readonly onLoad?: () => void;
+    readonly onClickGroup?: (id: string, rootData: Data, data: Data, event: SceneEvent) => void;
+    /** Called with no id when the pointer leaves the group */
+    readonly onHoverGroup?: (id: string | undefined, rootData: Data, data: Data, event: SceneEvent) => void;
+    readonly onContextMenuGroup?: (id: string, rootData: Data, data: Data, left: number, top: number, event: SceneEvent) => void;
+    readonly onClickRelation?: (relation: Relation, event: SceneEvent) => void;
+};
+/** What an update has to redo, in the order it's redone */
+export type Change = "compile" | "build" | "camera" | "controls" | "gizmo" | "lights" | "quality" | "paint" | "dimensions" | "overlays";
+/** What passing each option redoes; callbacks and what's read later need nothing */
+export declare const effects: {
+    readonly [K in keyof ViewerOptions<unknown>]-?: ReadonlyArray<Change>;
+};
+export {};
+//# sourceMappingURL=options.d.ts.map

package/lib/renderers/three/viewer/options.d.ts.map

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

package/lib/renderers/three/viewer/options.js

@@ -0,0 +1,31 @@
+/** What passing each option redoes; callbacks and what's read later need nothing */
+export const effects = {
+    scene: ["compile", "build", "lights", "overlays"],
+    createGroupId: ["compile", "build"],
+    activeComponents: ["build"],
+    activeRelations: ["build"],
+    useAlphaTest: ["build"],
+    materialStateImages: ["build"],
+    selectedIds: ["paint"],
+    hoveredIds: ["paint"],
+    showDimensions: ["dimensions"],
+    camera: ["camera"],
+    view: [],
+    bufferZones: [],
+    fitPadding: [],
+    controls: ["controls"],
+    gizmo: ["gizmo"],
+    lights: ["lights"],
+    environment: ["lights"],
+    environmentIntensity: ["lights"],
+    quality: ["quality"],
+    popovers: ["overlays"],
+    getTooltips: ["overlays"],
+    onOverlays: [],
+    onLoad: [],
+    onClickGroup: ["paint"],
+    onHoverGroup: [],
+    onContextMenuGroup: [],
+    onClickRelation: [],
+};
+//# sourceMappingURL=options.js.map

package/lib/renderers/three/viewer/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../../src/renderers/three/viewer/options.ts"],"names":[],"mappings":"AAoEA,oFAAoF;AACpF,MAAM,CAAC,MAAM,OAAO,GAA8E;IAChG,KAAK,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC;IACjD,aAAa,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC;IACnC,gBAAgB,EAAE,CAAC,OAAO,CAAC;IAC3B,eAAe,EAAE,CAAC,OAAO,CAAC;IAC1B,YAAY,EAAE,CAAC,OAAO,CAAC;IACvB,mBAAmB,EAAE,CAAC,OAAO,CAAC;IAC9B,WAAW,EAAE,CAAC,OAAO,CAAC;IACtB,UAAU,EAAE,CAAC,OAAO,CAAC;IACrB,cAAc,EAAE,CAAC,YAAY,CAAC;IAC9B,MAAM,EAAE,CAAC,QAAQ,CAAC;IAClB,IAAI,EAAE,EAAE;IACR,WAAW,EAAE,EAAE;IACf,UAAU,EAAE,EAAE;IACd,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,KAAK,EAAE,CAAC,OAAO,CAAC;IAChB,MAAM,EAAE,CAAC,QAAQ,CAAC;IAClB,WAAW,EAAE,CAAC,QAAQ,CAAC;IACvB,oBAAoB,EAAE,CAAC,QAAQ,CAAC;IAChC,OAAO,EAAE,CAAC,SAAS,CAAC;IACpB,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,WAAW,EAAE,CAAC,UAAU,CAAC;IACzB,UAAU,EAAE,EAAE;IACd,MAAM,EAAE,EAAE;IACV,YAAY,EAAE,CAAC,OAAO,CAAC;IACvB,YAAY,EAAE,EAAE;IAChB,kBAAkB,EAAE,EAAE;IACtB,eAAe,EAAE,EAAE;CACpB,CAAC"}

package/lib/renderers/three/viewer/options.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=options.test.d.ts.map

package/lib/renderers/three/viewer/options.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.test.d.ts","sourceRoot":"","sources":["../../../../src/renderers/three/viewer/options.test.ts"],"names":[],"mappings":""}

package/lib/renderers/three/viewer/options.test.js

@@ -0,0 +1,38 @@
+import { describe, expect, it } from "vitest";
+import { vec3 } from "../../../abstract-3d.js";
+import { getChanges } from "./options.js";
+const scene = { size_deprecated: vec3(1, 1, 1), groups: [] };
+const changes = (a, b) => [...getChanges(a, b)].toSorted();
+describe("getChanges", () => {
+    it("changes nothing for equal options, even when records and arrays are new objects", () => {
+        const a = {
+            scene,
+            selectedIds: { a: true },
+            hoveredIds: ["a"],
+            camera: { type: "Perspective", fov: 45 },
+            onClickGroup: () => undefined,
+        };
+        expect(changes(a, { ...a, selectedIds: { a: true }, hoveredIds: ["a"], camera: { type: "Perspective", fov: 45 } })).toEqual([]);
+    });
+    it("only repaints for a new selection or hover", () => {
+        expect(changes({ selectedIds: { a: true } }, { selectedIds: { b: true } })).toEqual(["paint"]);
+        expect(changes({ hoveredIds: ["a"] }, { hoveredIds: [] })).toEqual(["paint"]);
+    });
+    it("rebuilds for a new scene, and recompiles it", () => {
+        expect(changes({ scene }, { scene: { ...scene } })).toEqual(["build", "compile", "lights", "overlays"]);
+    });
+    it("rebuilds without compiling for new material states and active relations", () => {
+        expect(changes({}, { activeComponents: { a: "Accept" } })).toEqual(["build"]);
+        expect(changes({}, { activeRelations: [] })).toEqual(["build"]);
+    });
+    it("leaves view, buffer zones and padding for the next fit, which a new camera does", () => {
+        expect(changes({ view: "front" }, { view: "top" })).toEqual([]);
+        expect(changes({}, { bufferZones: { left: 10 } })).toEqual([]);
+        expect(changes({ camera: { type: "Perspective" } }, { camera: { type: "Orthographic" } })).toEqual(["camera"]);
+    });
+    it("only stores new callbacks, except that clicking dimensions depends on onClickGroup", () => {
+        expect(changes({ onHoverGroup: () => undefined }, { onHoverGroup: () => undefined })).toEqual([]);
+        expect(changes({}, { onClickGroup: () => undefined })).toEqual(["paint"]);
+    });
+});
+//# sourceMappingURL=options.test.js.map

package/lib/renderers/three/viewer/options.test.js.map

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

package/lib/renderers/three/viewer/overlays.d.ts

@@ -0,0 +1,31 @@
+import { Scene, type Vector3 } from "three";
+import { CSS2DObject, CSS2DRenderer } from "three/addons/renderers/CSS2DRenderer.js";
+/**
+ * HTML elements over the canvas at 3D anchors, e.g. popovers and tooltips, placed by three.js's CSS2DRenderer; their content is mounted by the app,
+ * or directly
+ */
+export type Overlay<Content> = {
+    readonly key: string;
+    /** In world space */
+    readonly position: Vector3;
+    readonly content: Content;
+};
+export type MountedOverlay<Content> = {
+    readonly key: string;
+    readonly element: HTMLElement;
+    readonly content: Content;
+};
+/** Mounts the overlays' content into their elements, called when the set of overlays or their content changes */
+export type MountOverlays<Content> = (overlays: ReadonlyArray<MountedOverlay<Content>>) => void;
+export type OverlayLayer<Content> = {
+    readonly renderer: CSS2DRenderer;
+    readonly scene: Scene;
+    readonly mounted: Map<string, {
+        readonly object: CSS2DObject;
+        overlay: Overlay<Content>;
+    }>;
+};
+export declare function createOverlayLayer<Content>(container: HTMLElement): OverlayLayer<Content>;
+/** Without `mount`, strings and DOM nodes are mounted as they are */
+export declare function setOverlays<Content>(layer: OverlayLayer<Content>, overlays: ReadonlyArray<Overlay<Content>>, mount: MountOverlays<Content> | undefined): void;
+//# sourceMappingURL=overlays.d.ts.map

package/lib/renderers/three/viewer/overlays.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlays.d.ts","sourceRoot":"","sources":["../../../../src/renderers/three/viewer/overlays.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,OAAO,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAErF;;;GAGG;AAEH,MAAM,MAAM,OAAO,CAAC,OAAO,IAAI;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,qBAAqB;IACrB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,cAAc,CAAC,OAAO,IAAI;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC;AAEzH,iHAAiH;AACjH,MAAM,MAAM,aAAa,CAAC,OAAO,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,CAAC;AAEhG,MAAM,MAAM,YAAY,CAAC,OAAO,IAAI;IAClC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;CAC5F,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,SAAS,EAAE,WAAW,GAAG,YAAY,CAAC,OAAO,CAAC,CAKzF;AAED,qEAAqE;AACrE,wBAAgB,WAAW,CAAC,OAAO,EACjC,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,EAC5B,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,EACzC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,SAAS,GACxC,IAAI,CAgCN"}

package/lib/renderers/three/viewer/overlays.js

@@ -0,0 +1,43 @@
+import { Scene } from "three";
+import { CSS2DObject, CSS2DRenderer } from "three/addons/renderers/CSS2DRenderer.js";
+export function createOverlayLayer(container) {
+    const renderer = new CSS2DRenderer();
+    renderer.domElement.style.cssText = "position:absolute;inset:0;overflow:hidden;pointer-events:none";
+    container.append(renderer.domElement);
+    return { renderer, scene: new Scene(), mounted: new Map() };
+}
+/** Without `mount`, strings and DOM nodes are mounted as they are */
+export function setOverlays(layer, overlays, mount) {
+    const keys = new Set();
+    const changed = { current: false };
+    overlays.forEach((overlay) => {
+        keys.add(overlay.key);
+        const existing = layer.mounted.get(overlay.key);
+        changed.current ||= existing?.overlay.content !== overlay.content;
+        const object = existing?.object ?? new CSS2DObject(document.createElement("div"));
+        object.position.copy(overlay.position);
+        if (existing) {
+            existing.overlay = overlay;
+        }
+        else {
+            object.element.style.pointerEvents = "none";
+            layer.scene.add(object);
+            layer.mounted.set(overlay.key, { object, overlay });
+        }
+    });
+    layer.mounted.forEach(({ object }, key) => {
+        if (!keys.has(key)) {
+            // Its element is removed with it
+            layer.scene.remove(object);
+            layer.mounted.delete(key);
+            changed.current = true;
+        }
+    });
+    if (changed.current && mount) {
+        mount(Array.from(layer.mounted, ([key, { object, overlay }]) => ({ key, element: object.element, content: overlay.content })));
+    }
+    else if (changed.current) {
+        layer.mounted.forEach(({ object, overlay: { content } }) => object.element.replaceChildren(content instanceof Node ? content : String(content ?? "")));
+    }
+}
+//# sourceMappingURL=overlays.js.map

package/lib/renderers/three/viewer/overlays.js.map

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

package/lib/renderers/three/viewer/viewer.d.ts

@@ -0,0 +1,90 @@
+import { type BufferGeometry, Group, OrthographicCamera, PerspectiveCamera, Scene as ThreeScene, type Texture, Vector3, WebGLRenderer } from "three";
+import type { ViewportGizmo } from "three-viewport-gizmo";
+import type { StructureState } from "../appearance/appearance.js";
+import type { BuiltScene } from "../build/build.js";
+import type { TextureCache } from "../build/materials.js";
+import type { Controls } from "../camera/controls.js";
+import type { CompiledScene } from "../compile/compile.js";
+import type { RenderPath, TierGovernor } from "../quality/quality.js";
+import type { GlyphAtlas } from "../text/text.js";
+import type { Change, ViewerOptions } from "./options.js";
+import type { OverlayLayer } from "./overlays.js";
+/**
+ * The interactive viewer: renderer, render on demand, camera, controls, pointer input, overlays and gizmo. Updates are batched into the next frame,
+ * as r3f applies props; render on demand and `invalidate` are r3f's `frameloop="demand"`; the state with functions instead of a class keeps it free
+ * of `this`
+ */
+type Hit = {
+    readonly item: number;
+    readonly target: number;
+    readonly point: Vector3;
+};
+export type Viewer<Content> = {
+    options: ViewerOptions<Content>;
+    readonly container: HTMLElement;
+    readonly canvas: HTMLCanvasElement;
+    readonly renderer: WebGLRenderer;
+    /** Apps can add their own objects, then `invalidate` */
+    readonly scene: ThreeScene;
+    readonly lights: Group;
+    readonly cameras: {
+        readonly Perspective: PerspectiveCamera;
+        readonly Orthographic: OrthographicCamera;
+    };
+    camera: PerspectiveCamera | OrthographicCamera;
+    readonly controls: Controls;
+    readonly geometries: Map<string, BufferGeometry>;
+    readonly atlas: GlyphAtlas;
+    readonly textures: TextureCache;
+    readonly overlays: OverlayLayer<Content>;
+    readonly size: {
+        width: number;
+        height: number;
+    };
+    readonly listeners: AbortController;
+    readonly resizeObserver: ResizeObserver;
+    readonly pointer: {
+        last?: PointerEvent;
+        down?: {
+            readonly x: number;
+            readonly y: number;
+        };
+        hovered?: Hit;
+        frame: number;
+    };
+    readonly loop: {
+        frame: number;
+        last: number;
+        wasMoving: boolean;
+        seconds: number;
+    };
+    /** What the next frame redoes, from the options passed since the last */
+    readonly pending: Set<Change>;
+    /** CPU times in ms of the last frame, pick and repaint, and the last frame's draw calls, post-processing included */
+    readonly stats: {
+        frames: number;
+        frameMs: number;
+        drawCalls: number;
+        pickMs: number;
+        paintMs: number;
+    };
+    structure: StructureState;
+    compiled?: CompiledScene;
+    built?: BuiltScene;
+    gizmo?: ViewportGizmo;
+    path?: RenderPath;
+    governor?: TierGovernor;
+    readonly environments: Partial<Record<"studio" | "room", Texture>>;
+    /** The scene is built and its shaders compiled */
+    loaded: boolean;
+    fitted: boolean;
+    disposed: boolean;
+};
+export declare function createViewer<Content>(container: HTMLElement, options: ViewerOptions<Content>): Viewer<Content>;
+/** Sets the options passed, redone in the next frame; what each redoes is in `effects`, so pass only the ones that changed */
+export declare function updateViewer<Content>(v: Viewer<Content>, options: Partial<ViewerOptions<Content>>): void;
+/** Renders a frame on the next animation frame, e.g. after changing objects added to `scene` */
+export declare function invalidate<Content>(v: Viewer<Content>): void;
+export declare function disposeViewer<Content>(v: Viewer<Content>): void;
+export {};
+//# sourceMappingURL=viewer.d.ts.map

package/lib/renderers/three/viewer/viewer.d.ts.map

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