abstract-3d 3.1.1 → 4.0.0-beta.0

package/lib/renderers/three/build/parts.d.ts

@@ -0,0 +1,65 @@
+import { BatchedMesh, type BufferGeometry, InstancedBufferAttribute, InstancedMesh, type InterleavedBuffer, type Intersection, type Material, Matrix4, Mesh, type MeshBasicMaterial, Vector3, type Vector4 } from "three";
+import { LineSegments2 } from "three/addons/lines/LineSegments2.js";
+import type { Vec3 } from "../../../abstract-3d.js";
+import type { GlyphAtlas } from "../text/text.js";
+/** The drawn objects: solids of a material class in one batch, all text in one instanced mesh, lines per thickness, images as meshes; each item a slot */
+export type Segment = {
+    readonly start: Vec3;
+    readonly end: Vec3;
+    /** The front facing direction of a culled line, hidden while it faces away from the camera */
+    readonly normal?: Vec3;
+};
+export type TextEntry = {
+    readonly text: string;
+    readonly fontSize: number;
+    readonly local: Matrix4;
+};
+export type Part = {
+    readonly kind: "solid";
+    readonly object: BatchedMesh;
+    readonly locals: ReadonlyArray<Matrix4>;
+} | {
+    readonly kind: "text";
+    readonly object: InstancedMesh;
+    readonly locals: ReadonlyArray<Matrix4>;
+    readonly glyphs: ReadonlyArray<Matrix4>;
+    /** The first glyph of each slot, and one past the last */
+    readonly firsts: ReadonlyArray<number>;
+    readonly slotOfGlyph: Int32Array;
+    readonly colors: InstancedBufferAttribute;
+} | {
+    readonly kind: "line";
+    readonly object: LineSegments2;
+    readonly segments: ReadonlyArray<Segment>;
+    /** World start, end and normal of each segment, while the drawn positions collapse hidden ones */
+    readonly world: Float32Array;
+    readonly visible: Uint8Array;
+    readonly positions: InterleavedBuffer;
+    readonly colors: InterleavedBuffer;
+} | {
+    readonly kind: "image";
+    readonly object: Mesh<BufferGeometry, MeshBasicMaterial>;
+    readonly local: Matrix4;
+};
+/** Per-instance color for hover and selection, as three.js's BatchedMesh examples color instances */
+export declare function createSolidPart(entries: ReadonlyArray<{
+    readonly geometry: BufferGeometry;
+    readonly local: Matrix4;
+}>, material: Material): Part;
+export declare function createTextPart(entries: ReadonlyArray<TextEntry>, atlas: GlyphAtlas): Part;
+export declare function createLinePart(segments: ReadonlyArray<Segment>, thickness: number): Part;
+/** Hidden until its texture is set */
+export declare function createImagePart(geometry: BufferGeometry, local: Matrix4, material: MeshBasicMaterial): Extract<Part, {
+    readonly kind: "image";
+}>;
+/** Places the slot's item by its world matrix */
+export declare function placeSlot(part: Part, slot: number, matrix: Matrix4): void;
+export declare function paintSlot(part: Part, slot: number, rgba: Vector4): void;
+/** Uploads what placing and painting changed, and the bounds for culling and picking when slots moved */
+export declare function flushPart(part: Part, moved: boolean): void;
+/** The slot of a hit on the part's object; lines aren't picked */
+export declare function getHitSlot(part: Part, hit: Intersection): number | undefined;
+/** Hides the culled lines facing away from a camera at `cameraPosition`; the r3f renderer's culled line shader's test, on the CPU per camera move */
+export declare function cullLines(part: Part, cameraPosition: Vector3): void;
+export declare function disposePart(part: Part): void;
+//# sourceMappingURL=parts.d.ts.map

package/lib/renderers/three/build/parts.d.ts.map

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

package/lib/renderers/three/build/parts.js

@@ -0,0 +1,203 @@
+import { BatchedMesh, FrontSide, InstancedBufferAttribute, InstancedMesh, Matrix4, Mesh, PlaneGeometry, ShaderMaterial, Vector3, } from "three";
+import { LineMaterial } from "three/addons/lines/LineMaterial.js";
+import { LineSegments2 } from "three/addons/lines/LineSegments2.js";
+import { LineSegmentsGeometry } from "three/addons/lines/LineSegmentsGeometry.js";
+import { layoutText, SDF_EDGE } from "../text/text.js";
+/** Per-instance color for hover and selection, as three.js's BatchedMesh examples color instances */
+export function createSolidPart(entries, material) {
+    const geometries = [...new Set(entries.map((e) => e.geometry))];
+    const vertexCount = geometries.reduce((sum, g) => sum + g.getAttribute("position").count, 0);
+    const batch = new BatchedMesh(entries.length, vertexCount, geometries.reduce((sum, g) => sum + g.index.count, 0), material);
+    const ids = new Map(geometries.map((g) => [g, batch.addGeometry(g)]));
+    entries.forEach((e) => batch.addInstance(ids.get(e.geometry)));
+    return { kind: "solid", object: batch, locals: entries.map((e) => e.local) };
+}
+export function createTextPart(entries, atlas) {
+    const layouts = entries.map((e) => layoutText(atlas, e.text, e.fontSize));
+    const quads = layouts.flat();
+    const geometry = new PlaneGeometry();
+    geometry.setAttribute("glyphRect", new InstancedBufferAttribute(Float32Array.from(quads.flatMap((q) => q.glyph.rect)), 4));
+    const colors = new InstancedBufferAttribute(new Float32Array(quads.length * 4), 4);
+    geometry.setAttribute("glyphColor", colors);
+    // Glyphs colored per instance, one draw call as troika's BatchedText; edges antialiased by the distance field's fwidth, as troika does
+    const material = new ShaderMaterial({
+        side: FrontSide,
+        transparent: true,
+        depthWrite: false,
+        uniforms: { atlas: { value: atlas.texture } },
+        defines: { SDF_EDGE },
+        vertexShader: textVertexShader,
+        fragmentShader: textFragmentShader,
+    });
+    const mesh = new InstancedMesh(geometry, material, quads.length);
+    // Drawn after the opaque batches, and never culled as a whole, as its glyphs move with their items
+    Object.assign(mesh, { renderOrder: 1, frustumCulled: false });
+    return {
+        kind: "text",
+        object: mesh,
+        locals: entries.map((e) => e.local),
+        glyphs: quads.map((q) => new Matrix4().makeTranslation(q.x, q.y, 0).scale(new Vector3(q.width, q.height, 1))),
+        firsts: layouts.reduce((acc, l, i) => [...acc, acc[i] + l.length], [0]),
+        slotOfGlyph: Int32Array.from(layouts.flatMap((l, slot) => l.map(() => slot))),
+        colors,
+    };
+}
+export function createLinePart(segments, thickness) {
+    const geometry = new LineSegmentsGeometry().setPositions(new Float32Array(segments.length * 6)).setColors(new Float32Array(segments.length * 6));
+    const line = new LineSegments2(geometry, new LineMaterial({ linewidth: thickness, vertexColors: true }));
+    // Positions change after the geometry's bounds were computed
+    line.frustumCulled = false;
+    return {
+        kind: "line",
+        object: line,
+        segments,
+        world: new Float32Array(segments.length * 9),
+        visible: new Uint8Array(segments.length).fill(1),
+        positions: geometry.getAttribute("instanceStart").data,
+        colors: geometry.getAttribute("instanceColorStart").data,
+    };
+}
+/** Hidden until its texture is set */
+export function createImagePart(geometry, local, material) {
+    const mesh = new Mesh(geometry, material);
+    Object.assign(mesh, { matrixAutoUpdate: false, visible: false });
+    return { kind: "image", object: mesh, local };
+}
+/** Places the slot's item by its world matrix */
+export function placeSlot(part, slot, matrix) {
+    switch (part.kind) {
+        case "solid":
+            part.object.setMatrixAt(slot, scratch.multiplyMatrices(matrix, part.locals[slot]));
+            break;
+        case "text": {
+            const text = scratch.multiplyMatrices(matrix, part.locals[slot]);
+            for (let i = part.firsts[slot]; i < part.firsts[slot + 1]; i++) {
+                part.object.setMatrixAt(i, glyph.multiplyMatrices(text, part.glyphs[i]));
+            }
+            break;
+        }
+        case "line": {
+            const { start, end, normal } = part.segments[slot];
+            part.world.set(vector.set(start.x, start.y, start.z).applyMatrix4(matrix).toArray(), slot * 9);
+            part.world.set(vector.set(end.x, end.y, end.z).applyMatrix4(matrix).toArray(), slot * 9 + 3);
+            part.world.set(normal ? vector.set(normal.x, normal.y, normal.z).transformDirection(matrix).toArray() : [0, 0, 0], slot * 9 + 6);
+            writeSegment(part, slot);
+            break;
+        }
+        default:
+            part.object.matrix.multiplyMatrices(matrix, part.local);
+            part.object.matrixWorldNeedsUpdate = true;
+    }
+}
+export function paintSlot(part, slot, rgba) {
+    switch (part.kind) {
+        case "solid":
+            part.object.setColorAt(slot, rgba);
+            break;
+        case "text":
+            for (let i = part.firsts[slot]; i < part.firsts[slot + 1]; i++) {
+                part.colors.setXYZW(i, rgba.x, rgba.y, rgba.z, rgba.w);
+            }
+            break;
+        case "line":
+            part.colors.array.set([rgba.x, rgba.y, rgba.z, rgba.x, rgba.y, rgba.z], slot * 6);
+            break;
+        default:
+            part.object.material.color.setRGB(rgba.x, rgba.y, rgba.z);
+            part.object.material.opacity = rgba.w;
+    }
+}
+/** Uploads what placing and painting changed, and the bounds for culling and picking when slots moved */
+export function flushPart(part, moved) {
+    switch (part.kind) {
+        case "solid":
+            if (moved) {
+                part.object.computeBoundingBox();
+                part.object.computeBoundingSphere();
+            }
+            break;
+        case "text":
+            part.object.instanceMatrix.needsUpdate = true;
+            part.colors.needsUpdate = true;
+            part.object.boundingSphere = null;
+            break;
+        case "line":
+            part.positions.needsUpdate = true;
+            part.colors.needsUpdate = true;
+            break;
+        default:
+    }
+}
+/** The slot of a hit on the part's object; lines aren't picked */
+export function getHitSlot(part, hit) {
+    switch (part.kind) {
+        case "solid":
+            return hit.batchId;
+        case "text":
+            return hit.instanceId === undefined ? undefined : part.slotOfGlyph[hit.instanceId];
+        case "line":
+            return undefined;
+        default:
+            return 0;
+    }
+}
+/** Hides the culled lines facing away from a camera at `cameraPosition`; the r3f renderer's culled line shader's test, on the CPU per camera move */
+export function cullLines(part, cameraPosition) {
+    if (part.kind !== "line") {
+        return;
+    }
+    part.segments.forEach((segment, slot) => {
+        const w = slot * 9;
+        const mid = vector
+            .fromArray(part.world, w)
+            .add(normal.fromArray(part.world, w + 3))
+            .multiplyScalar(0.5);
+        const facing = !segment.normal || normal.fromArray(part.world, w + 6).dot(mid.subVectors(cameraPosition, mid)) > 0 ? 1 : 0;
+        if (facing !== part.visible[slot]) {
+            part.visible[slot] = facing;
+            writeSegment(part, slot);
+            part.positions.needsUpdate = true;
+        }
+    });
+}
+export function disposePart(part) {
+    if (part.kind === "solid") {
+        part.object.dispose();
+    }
+    else if (part.kind !== "image") {
+        part.object.geometry.dispose();
+    }
+    const materials = part.object.material;
+    (Array.isArray(materials) ? materials : [materials]).forEach((m) => m.dispose());
+}
+/** A hidden segment collapses to its start */
+function writeSegment(part, slot) {
+    const w = slot * 9;
+    part.positions.array.set(part.visible[slot] ? part.world.subarray(w, w + 6) : [...part.world.subarray(w, w + 3), ...part.world.subarray(w, w + 3)], slot * 6);
+}
+const textVertexShader = /* glsl */ `
+attribute vec4 glyphRect;
+attribute vec4 glyphColor;
+varying vec2 vUv;
+varying vec4 vColor;
+void main() {
+  vUv = glyphRect.xy + uv * glyphRect.zw;
+  vColor = glyphColor;
+  gl_Position = projectionMatrix * modelViewMatrix * instanceMatrix * vec4(position, 1.0);
+}`;
+const textFragmentShader = /* glsl */ `
+uniform sampler2D atlas;
+varying vec2 vUv;
+varying vec4 vColor;
+void main() {
+  float distance = texture2D(atlas, vUv).r;
+  float edge = fwidth(distance) * 0.7;
+  gl_FragColor = vec4(vColor.rgb, vColor.a * smoothstep(SDF_EDGE - edge, SDF_EDGE + edge, distance));
+  #include <tonemapping_fragment>
+  #include <colorspace_fragment>
+}`;
+const scratch = new Matrix4();
+const glyph = new Matrix4();
+const vector = new Vector3();
+const normal = new Vector3();
+//# sourceMappingURL=parts.js.map

package/lib/renderers/three/build/parts.js.map

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

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

@@ -0,0 +1,50 @@
+import { Group, type Intersection, Matrix4, type Object3D, type Vector3, Vector4 } from "three";
+import type { PaintState, StructureState } from "./appearance.js";
+import type { CompiledScene } from "./compile.js";
+import type { GeometryCache } from "./geometry.js";
+import type { TextureLoad } from "./materials.js";
+import type { GlyphAtlas } from "./text.js";
+/** Compiled items → three.js objects: a batch per material class, one text mesh and a line mesh per thickness, images as meshes */
+/** Drawn objects of items, each item a slot */
+export type Part = {
+    readonly object: Object3D;
+    /** Places the slot's item by its world matrix */
+    readonly place: (slot: number, matrix: Matrix4) => void;
+    readonly paint: (slot: number, color: Vector4) => void;
+    /** Uploads what place and paint changed */
+    readonly flush: () => void;
+    /** The slot of a hit on the object, for parts that can be picked */
+    readonly pickSlot?: (hit: Intersection) => number | undefined;
+    readonly dispose: () => void;
+};
+export type BuildOptions = {
+    readonly structure: StructureState;
+    readonly activeRelations?: ReadonlyArray<string>;
+    readonly geometries: GeometryCache;
+    readonly glyphs: GlyphAtlas;
+    /** Loads images' textures; without it images aren't shown */
+    readonly loadTexture?: TextureLoad;
+    readonly materialStateImages?: Record<string, string>;
+    readonly useAlphaTest?: boolean;
+    readonly onTextureLoaded?: () => void;
+};
+export type BuiltScene = {
+    readonly root: Group;
+    /** Holds the dimensions, shown or hidden by its `visible` */
+    readonly dimensions: Group;
+    /** The shown objects that can be picked */
+    readonly getPickables: () => ReadonlyArray<Object3D>;
+    /** The index of the compiled item hit */
+    readonly getPickedItem: (hit: Intersection) => number | undefined;
+    /** Repaints the targets whose highlight changed */
+    readonly paint: (state: PaintState) => void;
+    readonly animated: boolean;
+    /** Moves the animated items to `seconds` into their animations */
+    readonly animate: (seconds: number) => void;
+    /** Hides the culled lines facing away from a camera at `cameraPosition` */
+    readonly cull: (cameraPosition: Vector3) => void;
+    readonly drawCalls: number;
+    readonly dispose: () => void;
+};
+export declare function buildScene(compiled: CompiledScene, options: BuildOptions): BuiltScene;
+//# sourceMappingURL=build.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/renderers/three/build.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,EACL,KAAK,YAAY,EAEjB,OAAO,EAGP,KAAK,QAAQ,EACb,KAAK,OAAO,EACZ,OAAO,EACR,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAElE,OAAO,KAAK,EAAE,aAAa,EAAQ,MAAM,cAAc,CAAC;AAExD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,KAAK,EAAE,UAAU,EAAa,MAAM,WAAW,CAAC;AAGvD,mIAAmI;AAEnI,+CAA+C;AAC/C,MAAM,MAAM,IAAI,GAAG;IACjB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IACxD,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACvD,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;IAC3B,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,MAAM,GAAG,SAAS,CAAC;IAC9D,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,eAAe,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACjD,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,6DAA6D;IAC7D,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IACnC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtD,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,6DAA6D;IAC7D,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC;IAC3B,2CAA2C;IAC3C,QAAQ,CAAC,YAAY,EAAE,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;IACrD,yCAAyC;IACzC,QAAQ,CAAC,aAAa,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,MAAM,GAAG,SAAS,CAAC;IAClE,mDAAmD;IACnD,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,CAAC,cAAc,EAAE,OAAO,KAAK,IAAI,CAAC;IACjD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B,CAAC;AAEF,wBAAgB,UAAU,CAAC,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,YAAY,GAAG,UAAU,CA+JrF"}

package/lib/renderers/three/build.js

@@ -0,0 +1,210 @@
+import { BatchedMesh, Group, Matrix4, Mesh, Vector4, } from "three";
+import { vec3Zero } from "../../abstract-3d.js";
+import { getHighlight, getItemColor, getMaterialClass, getMaterialState, materialClassKey } from "./appearance.js";
+import { itemWorldMatrix, transform } from "./compile.js";
+import { getSolidShape } from "./geometry.js";
+import { createLinePart } from "./lines.js";
+import { createClassMaterial, createImageMaterial, getImageUrl } from "./materials.js";
+import { createTextPart } from "./text.js";
+export function buildScene(compiled, options) {
+    const { items, targets } = compiled;
+    const root = new Group();
+    const dimensions = new Group();
+    root.add(dimensions);
+    const disposed = { current: false };
+    const active = new Set(options.activeRelations);
+    const included = items.flatMap((item, i) => {
+        const target = targets[item.target];
+        return target.kind !== "relation" || active.has(target.relation.id) ? [i] : [];
+    });
+    // Items grouped by the part that draws them, in the order they're first met
+    const groups = new Map();
+    included.forEach((i) => {
+        const key = getPartKey(items[i], i, options.structure, compiled);
+        groups.set(key, [...(groups.get(key) ?? []), i]);
+    });
+    const usedShapes = new Set();
+    const partOfItem = new Int32Array(items.length).fill(-1);
+    const slotOfItem = new Int32Array(items.length).fill(-1);
+    const itemsOfPart = [];
+    const lineParts = [];
+    const parts = Array.from(groups.values(), (indices, p) => {
+        indices.forEach((i, slot) => {
+            partOfItem[i] = p;
+            slotOfItem[i] = slot;
+        });
+        itemsOfPart.push(indices);
+        const part = createPart(indices.map((i) => items[i]));
+        (items[indices[0]].style === "dimension" ? dimensions : root).add(part.object);
+        return part;
+    });
+    function createPart(partItems) {
+        const first = partItems[0];
+        switch (first.role) {
+            case "text":
+                return createTextPart(partItems.map(toTextEntry), options.glyphs);
+            case "line": {
+                const part = createLinePart(partItems.map(toSegment), getThickness(first));
+                lineParts.push(part);
+                return part;
+            }
+            case "image":
+                return createImagePart(first);
+            default: {
+                const shapes = partItems.map((item) => getSolidShape(item.mesh.geometry));
+                shapes.forEach((shape) => usedShapes.add(shape.key));
+                const material = createClassMaterial(getMaterialClass(first, targets[first.target], options.structure));
+                return createSolidPart(shapes.map((shape) => ({ geometry: options.geometries.get(shape), local: shape.local })), material);
+            }
+        }
+    }
+    function createImagePart(item) {
+        const g = item.mesh.geometry;
+        const shape = getSolidShape(g.type === "Image" ? { type: "Plane", pos: g.pos, rot: g.rot, size: g.size } : g);
+        usedShapes.add(shape.key);
+        const material = createImageMaterial(item.mesh.material.backfaceCulling, options.useAlphaTest ?? true);
+        const mesh = new Mesh(options.geometries.get(shape), material);
+        mesh.matrixAutoUpdate = false;
+        mesh.visible = false;
+        if (g.type === "Image" && options.loadTexture) {
+            const url = getImageUrl(g.image, getMaterialState(targets[item.target], options.structure), options.materialStateImages);
+            void options.loadTexture(url).then((texture) => {
+                if (texture && !disposed.current) {
+                    material.map = texture;
+                    material.needsUpdate = true;
+                    mesh.visible = true;
+                    options.onTextureLoaded?.();
+                }
+            });
+        }
+        return {
+            object: mesh,
+            place: (_, matrix) => {
+                mesh.matrix.multiplyMatrices(matrix, shape.local);
+                mesh.matrixWorldNeedsUpdate = true;
+            },
+            paint: (_, color) => paintImage(material, color),
+            flush: () => undefined,
+            pickSlot: () => 0,
+            dispose: () => material.dispose(),
+        };
+    }
+    options.geometries.keepOnly(usedShapes);
+    const itemsOfTarget = targets.map(() => []);
+    included.forEach((i) => itemsOfTarget[items[i].target].push(i));
+    const highlights = new Int8Array(targets.length).fill(-1);
+    const color = new Vector4();
+    const world = new Matrix4();
+    const flush = (partIndices) => {
+        for (const p of partIndices) {
+            parts[p].flush();
+        }
+    };
+    const paint = (state) => {
+        const touched = new Set();
+        targets.forEach((target, t) => {
+            const highlight = getHighlight(target, t, state);
+            if (highlight === highlights[t]) {
+                return;
+            }
+            highlights[t] = highlight;
+            itemsOfTarget[t].forEach((i) => {
+                const item = items[i];
+                parts[partOfItem[i]].paint(slotOfItem[i], getItemColor(item, target, highlight, options.structure, color));
+                touched.add(partOfItem[i]);
+            });
+        });
+        flush(touched);
+    };
+    const animatedItems = included.filter((i) => items[i].animation !== undefined);
+    const animate = (seconds) => {
+        animatedItems.forEach((i) => parts[partOfItem[i]].place(slotOfItem[i], itemWorldMatrix(compiled, items[i], seconds, world)));
+        flush(new Set(animatedItems.map((i) => partOfItem[i])));
+    };
+    included.forEach((i) => parts[partOfItem[i]].place(slotOfItem[i], itemWorldMatrix(compiled, items[i], 0, world)));
+    paint({ ...options.structure, dimensionsClickable: false });
+    flush(parts.keys());
+    const partOfObject = new Map(parts.map((part, p) => [part.object, p]));
+    const isShown = (object) => object.visible && (object.parent === null || isShown(object.parent));
+    return {
+        root,
+        dimensions,
+        getPickables: () => parts.filter((part) => part.pickSlot && isShown(part.object)).map((part) => part.object),
+        getPickedItem: (hit) => {
+            const p = partOfObject.get(hit.object);
+            const slot = p === undefined ? undefined : parts[p].pickSlot?.(hit);
+            return slot === undefined ? undefined : itemsOfPart[p][slot];
+        },
+        paint,
+        animated: animatedItems.length > 0,
+        animate,
+        cull: (cameraPosition) => lineParts.forEach((part) => {
+            part.cull(cameraPosition);
+        }),
+        drawCalls: parts.length,
+        dispose: () => {
+            disposed.current = true;
+            parts.forEach((part) => part.dispose());
+            root.clear();
+        },
+    };
+}
+/** Items of the same part key are drawn by one part */
+function getPartKey(item, index, structure, compiled) {
+    const container = item.style === "dimension" ? "dimension" : "scene";
+    switch (item.role) {
+        case "text":
+            return `${container}|text`;
+        case "line":
+            return `${container}|line|${getThickness(item)}`;
+        case "image":
+            return `image|${index}`;
+        default:
+            return `${container}|solid|${materialClassKey(getMaterialClass(item, compiled.targets[item.target], structure))}`;
+    }
+}
+/** Solids of one material class as instances of one BatchedMesh, each slot an instance */
+function createSolidPart(entries, material) {
+    const geometries = [...new Set(entries.map((e) => e.geometry))];
+    const vertexCount = geometries.reduce((sum, g) => sum + g.getAttribute("position").count, 0);
+    const indexCount = geometries.reduce((sum, g) => sum + (g.index?.count ?? 0), 0);
+    const batch = new BatchedMesh(entries.length, vertexCount, indexCount, material);
+    const geometryIds = new Map(geometries.map((g) => [g, batch.addGeometry(g)]));
+    entries.forEach((e) => batch.addInstance(geometryIds.get(e.geometry)));
+    const bounds = { dirty: true };
+    return {
+        object: batch,
+        place: (slot, matrix) => {
+            batch.setMatrixAt(slot, scratch.multiplyMatrices(matrix, entries[slot].local));
+            bounds.dirty = true;
+        },
+        paint: (slot, color) => {
+            batch.setColorAt(slot, color);
+        },
+        flush: () => {
+            if (bounds.dirty) {
+                batch.computeBoundingBox();
+                batch.computeBoundingSphere();
+                bounds.dirty = false;
+            }
+        },
+        pickSlot: (hit) => hit.batchId,
+        dispose: () => {
+            batch.dispose();
+            material.dispose();
+        },
+    };
+}
+function paintImage(material, color) {
+    material.color.setRGB(color.x, color.y, color.z);
+    material.opacity = color.w;
+}
+const toTextEntry = ({ mesh: { geometry: g } }) => g.type === "Text" ? { text: g.text, fontSize: g.fontSize, local: transform(g.pos, g.rot) } : { text: "", fontSize: 0, local: new Matrix4() };
+const toSegment = ({ mesh: { geometry: g } }) => g.type === "CulledLine"
+    ? { start: g.start, end: g.end, normal: g.normal }
+    : g.type === "Line"
+        ? { start: g.start, end: g.end }
+        : { start: vec3Zero, end: vec3Zero };
+const getThickness = ({ mesh: { geometry: g } }) => (g.type === "Line" || g.type === "CulledLine" ? g.thickness : 0);
+const scratch = new Matrix4();
+//# sourceMappingURL=build.js.map

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

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

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

@@ -0,0 +1,40 @@
+import type { OrthographicCamera, PerspectiveCamera } from "three";
+import type { Vec3, View } from "../../../abstract-3d.js";
+/** Fitting the camera to the scene, inside buffer zones of the canvas that UI covers; the fit math of the r3f renderer's react-camera.tsx */
+export type CameraOptions = {
+    readonly type: "Perspective";
+    readonly near?: number;
+    readonly far?: number;
+    readonly fov?: number;
+} | {
+    readonly type: "Orthographic";
+    readonly near?: number;
+    readonly far?: number;
+};
+/** Margins of the canvas, in CSS pixels, that the scene is fitted inside of */
+export type BufferZones = {
+    readonly left?: number;
+    readonly right?: number;
+    readonly top?: number;
+    readonly bottom?: number;
+};
+export type FitInput = {
+    readonly view: View;
+    /** The scene's size */
+    readonly size: Vec3;
+    /** In CSS pixels */
+    readonly canvas: {
+        readonly width: number;
+        readonly height: number;
+    };
+    readonly bufferZones: BufferZones;
+    readonly fitPadding: number;
+};
+/** Where to place the camera: its distance from the target, and the direction from the target to it */
+export type Placement = {
+    readonly distance: number;
+    readonly direction: Vec3;
+};
+/** Sets the camera's projection to fit the scene into the usable area of the canvas, and returns where to place it */
+export declare function fitCamera(camera: PerspectiveCamera | OrthographicCamera, { view, size: sceneSize, canvas, bufferZones, fitPadding }: FitInput): Placement | undefined;
+//# sourceMappingURL=camera.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"camera.d.ts","sourceRoot":"","sources":["../../../../src/renderers/three/camera/camera.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAEnE,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAG1D,6IAA6I;AAE7I,MAAM,MAAM,aAAa,GACrB;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GACtG;IAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAErF,+EAA+E;AAC/E,MAAM,MAAM,WAAW,GAAG;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/H,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,uBAAuB;IACvB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,oBAAoB;IACpB,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACrE,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,uGAAuG;AACvG,MAAM,MAAM,SAAS,GAAG;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAA;CAAE,CAAC;AAEhF,sHAAsH;AACtH,wBAAgB,SAAS,CACvB,MAAM,EAAE,iBAAiB,GAAG,kBAAkB,EAC9C,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,QAAQ,GACnE,SAAS,GAAG,SAAS,CAiCvB"}