abstract-3d 3.1.2 → 4.0.0-beta.10

package/lib/renderers/three/gizmo.js

@@ -0,0 +1,172 @@
+import { Matrix4, Quaternion, Vector3 } from "three";
+const SIZE = 110;
+export function createGizmo(container, helper, onClick) {
+    const { alignment = "bottom-right", margin = [80, 80] } = helper.props ?? {};
+    const [vertical, horizontal] = alignment.split("-");
+    const root = document.createElement("div");
+    Object.assign(root.style, {
+        position: "absolute",
+        width: `${SIZE}px`,
+        height: `${SIZE}px`,
+        ...(horizontal === "left"
+            ? { left: `${margin[0] - SIZE / 2}px` }
+            : horizontal === "right"
+                ? { right: `${margin[0] - SIZE / 2}px` }
+                : { left: `calc(50% - ${SIZE / 2}px)` }),
+        ...(vertical === "top"
+            ? { top: `${margin[1] - SIZE / 2}px` }
+            : vertical === "bottom"
+                ? { bottom: `${margin[1] - SIZE / 2}px` }
+                : { top: `calc(50% - ${SIZE / 2}px)` }),
+        userSelect: "none",
+    });
+    container.append(root);
+    const content = helper.type === "Viewcube" ? createViewcube(root, helper.viewcubeProps ?? {}, onClick) : createAxes(root, helper.viewportProps ?? {}, onClick);
+    const last = new Quaternion(NaN, NaN, NaN, NaN);
+    return {
+        update: (camera) => {
+            if (!last.equals(camera.quaternion)) {
+                last.copy(camera.quaternion);
+                content.turn(inverse.copy(camera.quaternion).invert());
+            }
+        },
+        resetZoomAndPanOnClick: (helper.type === "Viewcube" ? helper.viewcubeProps?.resetZoomAndPanOnClick : helper.viewportProps?.resetZoomAndPanOnClick) ?? false,
+        dispose: () => root.remove(),
+    };
+}
+const inverse = new Quaternion();
+const CUBE = 64;
+const LABEL = 128;
+const edgeFraction = 0.2;
+/** A face's CSS transform, and its normal and CSS x and y axes in three.js coordinates, to tell a click near an edge or corner */
+const cubeFaces = [
+    { transform: "rotateY(90deg)", normal: new Vector3(1, 0, 0), x: new Vector3(0, 0, -1), y: new Vector3(0, -1, 0) },
+    { transform: "rotateY(-90deg)", normal: new Vector3(-1, 0, 0), x: new Vector3(0, 0, 1), y: new Vector3(0, -1, 0) },
+    { transform: "rotateX(90deg)", normal: new Vector3(0, 1, 0), x: new Vector3(1, 0, 0), y: new Vector3(0, 0, 1) },
+    { transform: "rotateX(-90deg)", normal: new Vector3(0, -1, 0), x: new Vector3(1, 0, 0), y: new Vector3(0, 0, -1) },
+    { transform: "", normal: new Vector3(0, 0, 1), x: new Vector3(1, 0, 0), y: new Vector3(0, -1, 0) },
+    { transform: "rotateY(180deg)", normal: new Vector3(0, 0, -1), x: new Vector3(-1, 0, 0), y: new Vector3(0, -1, 0) },
+];
+const defaultFaces = ["Right", "Left", "Top", "Bottom", "Front", "Back"];
+function createViewcube(root, options, onClick) {
+    const { font = "600 24px Helvetica, Arial, sans-serif", opacity = 1, color = "#f4f5f7", hoverColor = "#cfe0ff", textColor = "#333", strokeColor = "#9aa0a6", } = options;
+    const labels = options.faces ?? defaultFaces;
+    const cube = document.createElement("div");
+    Object.assign(cube.style, {
+        position: "absolute",
+        left: `${(SIZE - CUBE) / 2}px`,
+        top: `${(SIZE - CUBE) / 2}px`,
+        width: `${CUBE}px`,
+        height: `${CUBE}px`,
+        transformStyle: "preserve-3d",
+    });
+    root.append(cube);
+    cubeFaces.forEach((face, i) => {
+        const element = document.createElement("div");
+        // Laid out on drei's 128 px label texture and scaled to the face, so fonts sized for drei's viewcube keep their size
+        const label = document.createElement("div");
+        label.textContent = (labels[i] ?? "").toUpperCase();
+        Object.assign(label.style, {
+            width: `${LABEL}px`,
+            height: `${LABEL}px`,
+            flex: "none",
+            display: "flex",
+            alignItems: "center",
+            justifyContent: "center",
+            font,
+            transform: `scale(${CUBE / LABEL})`,
+            // Clicks land on the face, whose offsets tell edges and corners
+            pointerEvents: "none",
+        });
+        element.append(label);
+        Object.assign(element.style, {
+            position: "absolute",
+            inset: "0",
+            display: "flex",
+            alignItems: "center",
+            justifyContent: "center",
+            overflow: "hidden",
+            boxSizing: "border-box",
+            border: `1px solid ${strokeColor}`,
+            background: color,
+            color: textColor,
+            opacity: String(opacity),
+            cursor: "pointer",
+            backfaceVisibility: "hidden",
+            transform: `${face.transform} translateZ(${CUBE / 2}px)`,
+        });
+        element.addEventListener("pointerenter", () => (element.style.background = hoverColor));
+        element.addEventListener("pointerleave", () => (element.style.background = color));
+        element.addEventListener("click", (event) => {
+            const u = event.offsetX / CUBE - 0.5;
+            const v = event.offsetY / CUBE - 0.5;
+            onClick(face.normal.clone().addScaledVector(face.x, snap(u)).addScaledVector(face.y, snap(v)).normalize());
+        });
+        cube.append(element);
+    });
+    const matrix = new Matrix4();
+    return {
+        turn: (rotation) => {
+            // CSS has y down, so the rotation is mirrored in y
+            const e = matrix.makeRotationFromQuaternion(rotation).elements;
+            const css = e.map((v, i) => ((i % 4 === 1) !== (Math.floor(i / 4) === 1) ? -v : v));
+            cube.style.transform = `matrix3d(${css.join(",")})`;
+        },
+    };
+}
+const snap = (offset) => (offset > 0.5 - edgeFraction ? 1 : offset < -(0.5 - edgeFraction) ? -1 : 0);
+const svgNamespace = "http://www.w3.org/2000/svg";
+/** Colored axes with labeled heads, drawn back to front; a click on a head looks along its axis */
+function createAxes(root, options, onClick) {
+    const { axisColors = ["#ff3653", "#8adb00", "#2c8fff"], labels = ["X", "Y", "Z"], labelColor = "#000", font = "600 11px Helvetica, Arial, sans-serif", hideNegativeAxes = false, hideAxisHeads = false, disabled = false, } = options;
+    const svg = document.createElementNS(svgNamespace, "svg");
+    svg.setAttribute("width", String(SIZE));
+    svg.setAttribute("height", String(SIZE));
+    root.append(svg);
+    const axes = [new Vector3(1, 0, 0), new Vector3(0, 1, 0), new Vector3(0, 0, 1)];
+    const heads = axes.flatMap((axis, i) => [
+        { direction: axis, color: axisColors[i], label: labels[i], radius: 9, line: true },
+        ...(hideNegativeAxes ? [] : [{ direction: axis.clone().negate(), color: axisColors[i], label: "", radius: 6, line: false }]),
+    ]);
+    const elements = heads.map((head) => {
+        const group = document.createElementNS(svgNamespace, "g");
+        const line = document.createElementNS(svgNamespace, "line");
+        Object.entries({ stroke: head.color, "stroke-width": "2", x1: String(SIZE / 2), y1: String(SIZE / 2) }).forEach(([k, v]) => line.setAttribute(k, v));
+        const circle = document.createElementNS(svgNamespace, "circle");
+        Object.entries({ r: String(head.radius), fill: head.color, "fill-opacity": head.line ? "1" : "0.5" }).forEach(([k, v]) => circle.setAttribute(k, v));
+        const text = document.createElementNS(svgNamespace, "text");
+        Object.entries({ fill: labelColor, "text-anchor": "middle", "dominant-baseline": "central" }).forEach(([k, v]) => text.setAttribute(k, v));
+        text.style.font = font;
+        text.textContent = head.label;
+        if (head.line) {
+            group.append(line);
+        }
+        if (!hideAxisHeads) {
+            group.append(circle, text);
+            group.style.cursor = disabled ? "" : "pointer";
+            group.addEventListener("click", () => !disabled && onClick(head.direction.clone()));
+        }
+        svg.append(group);
+        return { group, line, circle, text };
+    });
+    const projected = new Vector3();
+    const reach = SIZE / 2 - 12;
+    return {
+        turn: (rotation) => {
+            const depths = heads.map((head, i) => {
+                projected.copy(head.direction).applyQuaternion(rotation);
+                const [x, y] = [SIZE / 2 + projected.x * reach, SIZE / 2 - projected.y * reach];
+                const { line, circle, text } = elements[i];
+                line.setAttribute("x2", String(x));
+                line.setAttribute("y2", String(y));
+                circle.setAttribute("cx", String(x));
+                circle.setAttribute("cy", String(y));
+                text.setAttribute("x", String(x));
+                text.setAttribute("y", String(y));
+                return { group: elements[i].group, z: projected.z };
+            });
+            depths.sort((a, b) => a.z - b.z).forEach(({ group }) => svg.append(group));
+        },
+    };
+}
+//# sourceMappingURL=gizmo.js.map

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

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

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

@@ -0,0 +1,16 @@
+export { createViewer, updateViewer, disposeViewer, invalidate } from "./viewer/viewer.js";
+export type { Viewer } from "./viewer/viewer.js";
+export type { ViewerOptions, Popover, SceneEvent } from "./viewer/options.js";
+export type { MountedOverlay, MountOverlays } from "./viewer/overlays.js";
+export { compileScene } from "./compile/compile.js";
+export type { CompiledScene } from "./compile/compile.js";
+export { buildScene, disposeScene } from "./build/build.js";
+export type { BuildOptions, BuiltScene } from "./build/build.js";
+export { createGlyphAtlas } from "./text/text.js";
+export { ERROR_IMG_KEY } from "./appearance/appearance.js";
+export type { MaterialState } from "./appearance/appearance.js";
+export type { CameraOptions, BufferZones } from "./camera/camera.js";
+export type { ControlsOptions } from "./camera/controls.js";
+export type { ControlsHelper, ViewcubeOptions, AxesOptions, GizmoAlignment } from "./camera/gizmo.js";
+export type { Quality, Tier } from "./quality/quality.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/renderers/three/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC3F,YAAY,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,YAAY,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC9E,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC5D,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,YAAY,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACrE,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACtG,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC"}

package/lib/renderers/three/index.js

@@ -0,0 +1,6 @@
+export { createViewer, updateViewer, disposeViewer, invalidate } from "./viewer/viewer.js";
+export { compileScene } from "./compile/compile.js";
+export { buildScene, disposeScene } from "./build/build.js";
+export { createGlyphAtlas } from "./text/text.js";
+export { ERROR_IMG_KEY } from "./appearance/appearance.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/renderers/three/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAI3F,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAE5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC"}

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

@@ -0,0 +1,25 @@
+import { Vector2, type Vector3 } from "three";
+/** Pointer input on the canvas: one pick per frame at most, hover changes, clicks that weren't drags, and context menus */
+export type PointerHit = {
+    readonly item: number;
+    /** What hover is tracked by, e.g. the item's target */
+    readonly key: number;
+    readonly point: Vector3;
+};
+export type InputHandlers = {
+    /** The interactive item under the pointer, at normalized device coordinates */
+    readonly pick: (ndc: Vector2) => PointerHit | undefined;
+    /** Picking pauses while the camera is dragged */
+    readonly isPaused: () => boolean;
+    readonly onHover: (hit: PointerHit | undefined, previous: PointerHit | undefined, event: PointerEvent) => void;
+    readonly onClick: (hit: PointerHit, event: MouseEvent) => void;
+    readonly onContextMenu: (hit: PointerHit, event: MouseEvent) => void;
+};
+export type Input = {
+    readonly hovered: () => PointerHit | undefined;
+    /** Picks again at the last pointer position, e.g. after the scene changed */
+    readonly refresh: () => void;
+    readonly dispose: () => void;
+};
+export declare function createInput(canvas: HTMLCanvasElement, handlers: InputHandlers): Input;
+//# sourceMappingURL=input.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../../src/renderers/three/input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,OAAO,CAAC;AAE9C,2HAA2H;AAE3H,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,UAAU,GAAG,SAAS,CAAC;IACxD,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,UAAU,GAAG,SAAS,EAAE,QAAQ,EAAE,UAAU,GAAG,SAAS,EAAE,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IAC/G,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IAC/D,QAAQ,CAAC,aAAa,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;CACtE,CAAC;AAEF,MAAM,MAAM,KAAK,GAAG;IAClB,QAAQ,CAAC,OAAO,EAAE,MAAM,UAAU,GAAG,SAAS,CAAC;IAC/C,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B,CAAC;AAKF,wBAAgB,WAAW,CAAC,MAAM,EAAE,iBAAiB,EAAE,QAAQ,EAAE,aAAa,GAAG,KAAK,CAwErF"}

package/lib/renderers/three/input.js

@@ -0,0 +1,71 @@
+import { Vector2 } from "three";
+/** Pointer travel in CSS pixels below which a press and release is a click, not a drag */
+const clickTolerance = 4;
+export function createInput(canvas, handlers) {
+    const ndc = new Vector2();
+    const state = { frame: 0 };
+    const pickAt = (event) => {
+        const rect = canvas.getBoundingClientRect();
+        return handlers.pick(ndc.set(((event.clientX - rect.left) / rect.width) * 2 - 1, -((event.clientY - rect.top) / rect.height) * 2 + 1));
+    };
+    const setHovered = (hit, event) => {
+        const previous = state.hovered;
+        state.hovered = hit;
+        canvas.style.cursor = hit ? "pointer" : "";
+        if (hit?.key !== previous?.key) {
+            handlers.onHover(hit, previous, event);
+        }
+    };
+    const hover = () => {
+        state.frame = 0;
+        if (state.last && !handlers.isPaused()) {
+            setHovered(pickAt(state.last), state.last);
+        }
+    };
+    const onPointerMove = (event) => {
+        state.last = event;
+        state.frame ||= requestAnimationFrame(hover);
+    };
+    const onPointerLeave = (event) => {
+        state.last = undefined;
+        setHovered(undefined, event);
+    };
+    const onPointerDown = (event) => {
+        state.down = { x: event.clientX, y: event.clientY };
+    };
+    const onClick = (event) => {
+        const down = state.down;
+        const hit = down && Math.hypot(event.clientX - down.x, event.clientY - down.y) <= clickTolerance ? pickAt(event) : undefined;
+        if (hit) {
+            handlers.onClick(hit, event);
+        }
+    };
+    const onContextMenu = (event) => {
+        const hit = pickAt(event);
+        if (hit) {
+            handlers.onContextMenu(hit, event);
+        }
+    };
+    canvas.addEventListener("pointermove", onPointerMove);
+    canvas.addEventListener("pointerleave", onPointerLeave);
+    canvas.addEventListener("pointerdown", onPointerDown);
+    canvas.addEventListener("click", onClick);
+    canvas.addEventListener("contextmenu", onContextMenu);
+    return {
+        hovered: () => state.hovered,
+        refresh: () => {
+            if (state.last) {
+                onPointerMove(state.last);
+            }
+        },
+        dispose: () => {
+            cancelAnimationFrame(state.frame);
+            canvas.removeEventListener("pointermove", onPointerMove);
+            canvas.removeEventListener("pointerleave", onPointerLeave);
+            canvas.removeEventListener("pointerdown", onPointerDown);
+            canvas.removeEventListener("click", onClick);
+            canvas.removeEventListener("contextmenu", onContextMenu);
+        },
+    };
+}
+//# sourceMappingURL=input.js.map

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

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

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

@@ -0,0 +1,16 @@
+import { Vector3 } from "three";
+import type { Vec3 } from "../../abstract-3d.js";
+import type { Part } from "./build.js";
+/** Lines of one pixel thickness in one draw call; culled lines are hidden while their normal faces away from the camera */
+export type Segment = {
+    readonly start: Vec3;
+    readonly end: Vec3;
+    /** The front facing direction of a culled line */
+    readonly normal?: Vec3;
+};
+export type LinePart = Part & {
+    /** Hides the culled lines facing away from a camera at `cameraPosition` */
+    readonly cull: (cameraPosition: Vector3) => void;
+};
+export declare function createLinePart(segments: ReadonlyArray<Segment>, thickness: number): LinePart;
+//# sourceMappingURL=lines.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lines.d.ts","sourceRoot":"","sources":["../../../src/renderers/three/lines.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,OAAO,EAAE,MAAM,OAAO,CAAC;AAI9C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,2HAA2H;AAE3H,MAAM,MAAM,OAAO,GAAG;IACpB,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC;IACnB,kDAAkD;IAClD,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG;IAC5B,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,CAAC,cAAc,EAAE,OAAO,KAAK,IAAI,CAAC;CAClD,CAAC;AAEF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,QAAQ,CAgE5F"}

package/lib/renderers/three/lines.js

@@ -0,0 +1,63 @@
+import { Vector3 } from "three";
+import { LineSegmentsGeometry } from "three/addons/lines/LineSegmentsGeometry.js";
+import { LineSegments2 } from "three/addons/lines/webgpu/LineSegments2.js";
+import { Line2NodeMaterial } from "three/webgpu";
+export function createLinePart(segments, thickness) {
+    const count = segments.length;
+    const geometry = new LineSegmentsGeometry();
+    geometry.setPositions(new Float32Array(count * 6));
+    geometry.setColors(new Float32Array(count * 6));
+    const material = new Line2NodeMaterial({ linewidth: thickness, vertexColors: true });
+    const line = new LineSegments2(geometry, material);
+    // Positions change after the geometry's bounds were computed
+    line.frustumCulled = false;
+    const positions = geometry.getAttribute("instanceStart");
+    const colors = geometry.getAttribute("instanceColorStart");
+    /** World start, end and normal of each segment, while positions hold collapsed segments for culled lines */
+    const world = new Float32Array(count * 9);
+    const visible = new Uint8Array(count).fill(1);
+    const writePosition = (slot) => {
+        const [w, p] = [slot * 9, slot * 6];
+        positions.data.array.set(visible[slot] ? world.subarray(w, w + 6) : [world[w], world[w + 1], world[w + 2], world[w], world[w + 1], world[w + 2]], p);
+    };
+    return {
+        object: line,
+        place: (slot, matrix) => {
+            const { start, end, normal } = segments[slot];
+            const s = scratch.set(start.x, start.y, start.z).applyMatrix4(matrix);
+            world.set([s.x, s.y, s.z], slot * 9);
+            const e = scratch.set(end.x, end.y, end.z).applyMatrix4(matrix);
+            world.set([e.x, e.y, e.z], slot * 9 + 3);
+            const n = normal ? scratch.set(normal.x, normal.y, normal.z).transformDirection(matrix) : scratch.set(0, 0, 0);
+            world.set([n.x, n.y, n.z], slot * 9 + 6);
+            writePosition(slot);
+        },
+        paint: (slot, color) => colors.data.array.set([color.x, color.y, color.z, color.x, color.y, color.z], slot * 6),
+        flush: () => {
+            positions.data.needsUpdate = true;
+            colors.data.needsUpdate = true;
+        },
+        cull: (cameraPosition) => {
+            segments.forEach((segment, slot) => {
+                if (!segment.normal) {
+                    return;
+                }
+                const w = slot * 9;
+                const toCamera = scratch.set(cameraPosition.x - (world[w] + world[w + 3]) / 2, cameraPosition.y - (world[w + 1] + world[w + 4]) / 2, cameraPosition.z - (world[w + 2] + world[w + 5]) / 2);
+                const facing = toCamera.dot(normalScratch.fromArray(world, w + 6)) > 0 ? 1 : 0;
+                if (facing !== visible[slot]) {
+                    visible[slot] = facing;
+                    writePosition(slot);
+                    positions.data.needsUpdate = true;
+                }
+            });
+        },
+        dispose: () => {
+            geometry.dispose();
+            material.dispose();
+        },
+    };
+}
+const scratch = new Vector3();
+const normalScratch = new Vector3();
+//# sourceMappingURL=lines.js.map

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

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

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

@@ -0,0 +1,15 @@
+import { type Material, MeshBasicMaterial, type Texture } from "three";
+import type { Image } from "../../abstract-3d.js";
+import type { MaterialClass, MaterialState } from "./appearance.js";
+/** White materials, colored per instance, for each material class; images' materials and textures */
+export declare function createClassMaterial(c: MaterialClass): Material;
+export declare function createImageMaterial(backfaceCulling: boolean | undefined, useAlphaTest: boolean): MeshBasicMaterial;
+export declare function getImageUrl(image: Image, materialState: MaterialState | undefined, materialStateImages: Record<string, string> | undefined): string;
+export type TextureLoad = (url: string) => Promise<Texture | undefined>;
+export type TextureCache = {
+    readonly load: TextureLoad;
+    readonly dispose: () => void;
+};
+/** Loads each url's texture once, SVGs rasterized at up to 512 px */
+export declare function createTextureCache(): TextureCache;
+//# sourceMappingURL=materials.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"materials.d.ts","sourceRoot":"","sources":["../../../src/renderers/three/materials.ts"],"names":[],"mappings":"AACA,OAAO,EAOL,KAAK,QAAQ,EACb,iBAAiB,EAGjB,KAAK,OAAO,EAEb,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGpE,qGAAqG;AAErG,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,aAAa,GAAG,QAAQ,CAI9D;AAED,wBAAgB,mBAAmB,CAAC,eAAe,EAAE,OAAO,GAAG,SAAS,EAAE,YAAY,EAAE,OAAO,GAAG,iBAAiB,CAElH;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,aAAa,GAAG,SAAS,EAAE,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GAAG,MAAM,CAGnJ;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;AAExE,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B,CAAC;AAEF,qEAAqE;AACrE,wBAAgB,kBAAkB,IAAI,YAAY,CAiBjD"}

package/lib/renderers/three/materials.js

@@ -0,0 +1,70 @@
+import { createSVG } from "abstract-image";
+import { BackSide, CanvasTexture, DoubleSide, FrontSide, LinearFilter, LinearMipmapLinearFilter, MeshBasicMaterial, MeshStandardMaterial, SRGBColorSpace, TextureLoader, } from "three";
+import { ERROR_IMG_KEY } from "./appearance.js";
+/** White materials, colored per instance, for each material class; images' materials and textures */
+export function createClassMaterial(c) {
+    const side = c.side === "front" ? FrontSide : c.side === "back" ? BackSide : DoubleSide;
+    const common = { side, transparent: c.transparent, depthWrite: !c.transparent };
+    return c.lit ? new MeshStandardMaterial({ ...common, metalness: c.metalness, roughness: c.roughness }) : new MeshBasicMaterial(common);
+}
+export function createImageMaterial(backfaceCulling, useAlphaTest) {
+    return new MeshBasicMaterial({ side: backfaceCulling ? FrontSide : DoubleSide, alphaTest: useAlphaTest ? 0.8 : 0, transparent: true });
+}
+export function getImageUrl(image, materialState, materialStateImages) {
+    const errorUrl = materialState === "Error" ? materialStateImages?.[ERROR_IMG_KEY] : undefined;
+    return errorUrl ?? (image.type === "AbstractImage" ? `data:image/svg+xml,${createSVG(image.image)}` : image.url);
+}
+/** Loads each url's texture once, SVGs rasterized at up to 512 px */
+export function createTextureCache() {
+    const textures = new Map();
+    return {
+        load: (url) => {
+            const cached = textures.get(url);
+            if (cached) {
+                return cached;
+            }
+            const loading = (isSvg(url) ? loadSvg(url) : loadImage(url)).then((texture) => texture && applyFilters(texture));
+            textures.set(url, loading);
+            return loading;
+        },
+        dispose: () => {
+            textures.forEach((loading) => void loading.then((texture) => texture?.dispose()));
+            textures.clear();
+        },
+    };
+}
+const isSvg = (url) => url.startsWith("data:image/svg+xml") || url.endsWith(".svg") || url.includes(".svg?");
+const svgMaxSize = 512;
+function loadSvg(url) {
+    return new Promise((resolve) => {
+        const img = new Image();
+        img.addEventListener("load", () => {
+            const [w, h] = [img.naturalWidth, img.naturalHeight];
+            const canvas = document.createElement("canvas");
+            canvas.width = w >= h ? svgMaxSize : svgMaxSize * (w / h);
+            canvas.height = h >= w ? svgMaxSize : svgMaxSize * (h / w);
+            const ctx = canvas.getContext("2d");
+            if (!ctx) {
+                resolve(undefined);
+                return;
+            }
+            ctx.imageSmoothingQuality = "high";
+            ctx.drawImage(img, 0, 0, canvas.width, canvas.height);
+            resolve(new CanvasTexture(canvas));
+        });
+        img.addEventListener("error", () => resolve(undefined));
+        img.src = url;
+    });
+}
+const loader = new TextureLoader();
+const loadImage = (url) => new Promise((resolve) => loader.load(url, (texture) => resolve(texture), undefined, () => resolve(undefined)));
+function applyFilters(texture) {
+    texture.colorSpace = SRGBColorSpace;
+    texture.minFilter = LinearMipmapLinearFilter;
+    texture.magFilter = LinearFilter;
+    texture.generateMipmaps = true;
+    texture.anisotropy = 4;
+    texture.needsUpdate = true;
+    return texture;
+}
+//# sourceMappingURL=materials.js.map

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

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

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

@@ -0,0 +1,68 @@
+import type { Object3D, Texture } from "three";
+import type { Group, Relation, Scene, Vec3, View } from "../../abstract-3d.js";
+import type { MaterialState } from "./appearance.js";
+import type { BufferZones, CameraOptions } from "./camera.js";
+import type { ControlsOptions } from "./controls.js";
+import type { ControlsHelper } from "./gizmo.js";
+import type { MountOverlays } from "./overlays.js";
+import type { Quality } from "./quality.js";
+/** The viewer's options, and which of them changed in an update, so each change does only the work it needs */
+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;
+};
+export type GroupCallback = (id: string | undefined, rootData: Record<string, string> | undefined, data: Record<string, string> | undefined, event: SceneEvent) => void;
+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;
+    readonly camera?: CameraOptions;
+    readonly view?: View;
+    readonly bufferZones?: BufferZones;
+    readonly fitPadding?: number;
+    /** Smooth controls by default; `orbit` keeps the OrbitControls of the r3f renderer */
+    readonly controls?: ControlsOptions;
+    readonly gizmo?: ControlsHelper;
+    /** Replace the default lights */
+    readonly lights?: ReadonlyArray<Object3D> | ((scene: Scene) => ReadonlyArray<Object3D>);
+    /** An environment map, or `room` for a neutral studio, lighting metal surfaces */
+    readonly environment?: Texture | "room";
+    readonly environmentIntensity?: number;
+    /** Of the default directional lights */
+    readonly lightIntensity?: number;
+    readonly quality?: Quality;
+    /** WebGL 2 by default; read once, when the viewer is created */
+    readonly backend?: "webgl" | "webgpu";
+    readonly useAlphaTest?: boolean;
+    readonly materialStateImages?: Record<string, string>;
+    readonly popovers?: ReadonlyArray<Popover<Content>>;
+    readonly getTooltips?: (id: string) => ReadonlyArray<Popover<Content>>;
+    /** Shown while loading, and while there's no scene */
+    readonly fallback?: Content;
+    /** Mounts popover, tooltip and fallback content, e.g. as React portals; without it, strings and DOM nodes are mounted directly */
+    readonly onOverlays?: MountOverlays<Content>;
+    readonly onClickGroup?: GroupCallback;
+    readonly onHoverGroup?: GroupCallback;
+    readonly onContextMenuGroup?: (id: string, rootData: Record<string, string> | undefined, data: Record<string, string> | undefined, left: number, top: number, event: SceneEvent) => void;
+    readonly onClickRelation?: (relation: Relation, event: SceneEvent) => void;
+};
+/** What an update has to redo, from the most work to the least */
+export type Change = "compile" | "build" | "camera" | "rig" | "fit" | "gizmo" | "lights" | "quality" | "paint" | "dimensions" | "overlays";
+export declare function getChanges<Content>(previous: ViewerOptions<Content>, next: ViewerOptions<Content>): ReadonlySet<Change>;
+//# sourceMappingURL=options.d.ts.map

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

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