abstract-3d 4.0.8 → 4.0.10

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

@@ -0,0 +1,58 @@
+import { Matrix4 } from "three";
+import type { Group, Mesh, Relation, Scene, Vec3 } from "../../abstract-3d.js";
+/** Scene → flat items with world matrices, with no GPU objects, so everything here is testable in Node */
+/** How the item's geometry is drawn */
+export type Role = "solid" | "text" | "line" | "image";
+/** What the item belongs to, which decides its material and whether it's shown */
+export type Style = "group" | "dimension" | "relation" | "outline";
+/** What a pointer event on an item is about, and what hover and selection apply to */
+export type Target = {
+    readonly kind: "group";
+    readonly id: string;
+    readonly root: number;
+    readonly rootData: Record<string, string> | undefined;
+} | {
+    readonly kind: "dimension";
+    readonly id: string | undefined;
+} | {
+    readonly kind: "relation";
+    readonly relation: Relation;
+};
+export type Item = {
+    readonly mesh: Mesh;
+    readonly role: Role;
+    readonly style: Style;
+    /** World matrix, or for an animated item its matrix relative to its animation's group */
+    readonly matrix: Matrix4;
+    readonly target: number;
+    /** The data of the group the mesh is in */
+    readonly data: Record<string, string> | undefined;
+    readonly animation: number | undefined;
+};
+export type Animation = {
+    readonly parent: number | undefined;
+    /** The matrix of the group's parent, in world space or relative to the parent animation's group */
+    readonly base: Matrix4;
+    readonly pos: Vec3;
+    readonly rot: Vec3;
+    /** Radians per second around x, y and z */
+    readonly speed: Vec3;
+};
+export type CompiledScene = {
+    readonly items: ReadonlyArray<Item>;
+    readonly targets: ReadonlyArray<Target>;
+    readonly animations: ReadonlyArray<Animation>;
+    /** World matrix of the scene's root, from its deprecated center and rotation */
+    readonly matrix: Matrix4;
+    /** World matrix of each top-level group */
+    readonly roots: ReadonlyArray<Matrix4>;
+};
+export type CompileOptions = {
+    readonly createGroupId?: (g: Group) => string;
+};
+export declare function compileScene(scene: Scene, options?: CompileOptions): CompiledScene;
+/** The item's world matrix at `seconds` into its animations, written to `out` */
+export declare function itemWorldMatrix(compiled: CompiledScene, item: Item, seconds: number, out: Matrix4): Matrix4;
+/** Translation, then XYZ Euler rotation, then scale, as on a three.js Object3D */
+export declare function transform(pos: Vec3, rot: Vec3 | undefined, out?: Matrix4, size?: Vec3 | undefined): Matrix4;
+//# sourceMappingURL=compile.d.ts.map

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

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

package/lib/renderers/three/compile.js

@@ -0,0 +1,89 @@
+import { Euler, Matrix4, Quaternion, Vector3 } from "three";
+import { dimensionConvertToTypeMesh, vec3, vec3Scale, vec3Zero } from "../../abstract-3d.js";
+const outlineScale = 1.0125;
+export function compileScene(scene, options = {}) {
+    const items = [];
+    const targets = [];
+    const animations = [];
+    const sceneMatrix = new Matrix4()
+        .makeTranslation(-(scene.center_deprecated?.x ?? 0), -(scene.center_deprecated?.y ?? 0), -(scene.center_deprecated?.z ?? 0))
+        .multiply(transform(vec3Zero, scene.rotation_deprecated));
+    const addMeshes = (meshes, parent, item) => meshes?.forEach((mesh) => {
+        items.push({ ...item, mesh, role: getRole(mesh), matrix: parent });
+        if (item.style === "relation" && mesh.geometry.type === "Box") {
+            const outline = { ...mesh.geometry, size: vec3Scale(mesh.geometry.size, outlineScale) };
+            items.push({ ...item, style: "outline", mesh: { ...mesh, geometry: outline }, role: "solid", matrix: parent });
+        }
+    });
+    const addGroup = (g, parent, animation, item) => {
+        const animated = g.animation !== undefined;
+        const ownAnimation = animated ? animations.push(createAnimation(g, parent, animation)) - 1 : animation;
+        const matrix = animated ? new Matrix4() : parent.clone().multiply(transform(g.pos, g.rot));
+        addMeshes(g.meshes, matrix, { ...item, data: g.data, animation: ownAnimation });
+        g.groups?.forEach((child) => addGroup(child, matrix, ownAnimation, item));
+        return matrix;
+    };
+    const roots = scene.groups.map((g, root) => {
+        const target = targets.push({ kind: "group", id: options.createGroupId?.(g) ?? "", root, rootData: g.data }) - 1;
+        addGroup(g, sceneMatrix, undefined, { style: "group", target });
+        return sceneMatrix.clone().multiply(transform(g.pos, g.rot));
+    });
+    scene.dimensions_deprecated?.dimensions.forEach((dimension) => {
+        const target = targets.push({ kind: "dimension", id: dimension.id }) - 1;
+        const mesh = dimensionConvertToTypeMesh(dimension, scene.rotation_deprecated ?? vec3Zero, scene.dimensions_deprecated?.material);
+        const matrix = sceneMatrix.clone().multiply(transform(mesh.pos, mesh.rot));
+        addMeshes(mesh.meshes, matrix, { style: "dimension", target, data: undefined, animation: undefined });
+    });
+    scene.relations?.forEach((relation) => {
+        const target = targets.push({ kind: "relation", relation }) - 1;
+        relation.groups?.forEach((g) => addGroup(g, sceneMatrix, undefined, { style: "relation", target }));
+    });
+    return { items, targets, animations, matrix: sceneMatrix, roots };
+}
+/** The item's world matrix at `seconds` into its animations, written to `out` */
+export function itemWorldMatrix(compiled, item, seconds, out) {
+    return item.animation === undefined
+        ? out.copy(item.matrix)
+        : animationMatrix(compiled.animations, item.animation, seconds, out).multiply(item.matrix);
+}
+const scratchAnimation = new Matrix4();
+function animationMatrix(animations, index, seconds, out) {
+    const a = animations[index];
+    const rot = vec3(a.rot.x + a.speed.x * seconds, a.rot.y + a.speed.y * seconds, a.rot.z + a.speed.z * seconds);
+    const local = out.copy(a.base).multiply(transform(a.pos, rot, scratchAnimation));
+    return a.parent === undefined ? local : local.premultiply(animationMatrix(animations, a.parent, seconds, new Matrix4()));
+}
+function createAnimation(g, parent, parentAnimation) {
+    const { transform: { rot }, duration, } = g.animation;
+    const perSecond = 1000 / duration;
+    return {
+        parent: parentAnimation,
+        base: parent.clone(),
+        pos: g.pos,
+        rot: g.rot ?? vec3Zero,
+        speed: vec3(rot.x * perSecond, rot.y * perSecond, rot.z * perSecond),
+    };
+}
+function getRole(mesh) {
+    switch (mesh.geometry.type) {
+        case "Text":
+            return "text";
+        case "Line":
+        case "CulledLine":
+            return "line";
+        case "Image":
+            return "image";
+        default:
+            return "solid";
+    }
+}
+const euler = new Euler();
+const quaternion = new Quaternion();
+const position = new Vector3();
+const scale = new Vector3();
+/** Translation, then XYZ Euler rotation, then scale, as on a three.js Object3D */
+export function transform(pos, rot, out = new Matrix4(), size = undefined) {
+    quaternion.setFromEuler(euler.set(rot?.x ?? 0, rot?.y ?? 0, rot?.z ?? 0));
+    return out.compose(position.set(pos.x, pos.y, pos.z), quaternion, size ? scale.set(size.x, size.y, size.z) : scale.set(1, 1, 1));
+}
+//# sourceMappingURL=compile.js.map

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

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

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

@@ -0,0 +1,27 @@
+import CameraControls from "camera-controls";
+import { type OrthographicCamera, type PerspectiveCamera, Vector3 } from "three";
+import { OrbitControls } from "three/addons/controls/OrbitControls.js";
+export type SmoothControlsOptions = Partial<Pick<CameraControls, "enabled" | "smoothTime" | "draggingSmoothTime" | "minDistance" | "maxDistance" | "minZoom" | "maxZoom" | "minPolarAngle" | "maxPolarAngle" | "minAzimuthAngle" | "maxAzimuthAngle" | "azimuthRotateSpeed" | "polarRotateSpeed" | "dollySpeed" | "truckSpeed" | "dollyToCursor">>;
+export type OrbitControlsOptions = Partial<Pick<OrbitControls, "enabled" | "enableDamping" | "dampingFactor" | "enableZoom" | "zoomSpeed" | "enableRotate" | "rotateSpeed" | "enablePan" | "panSpeed" | "screenSpacePanning" | "minDistance" | "maxDistance" | "minZoom" | "maxZoom" | "minPolarAngle" | "maxPolarAngle" | "minAzimuthAngle" | "maxAzimuthAngle" | "zoomToCursor" | "autoRotate" | "autoRotateSpeed" | "keyPanSpeed">> & {
+    readonly onStart?: () => void;
+    readonly onChange?: () => void;
+    readonly onEnd?: () => void;
+};
+export type ControlsOptions = {
+    readonly type: "smooth";
+    readonly options?: SmoothControlsOptions;
+} | {
+    readonly type: "orbit";
+    readonly options?: OrbitControlsOptions;
+};
+export type Rig = {
+    /** Moves the camera by input and transitions, true while it moves */
+    readonly update: (delta: number) => boolean;
+    readonly setPose: (position: Vector3, target: Vector3, animate: boolean) => void;
+    readonly getTarget: (out: Vector3) => Vector3;
+    /** The user drags the camera, and it has moved since the drag started */
+    readonly isDragging: () => boolean;
+    readonly dispose: () => void;
+};
+export declare function createRig(controls: ControlsOptions, camera: PerspectiveCamera | OrthographicCamera, element: HTMLElement, onInput: () => void): Rig;
+//# sourceMappingURL=controls.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"controls.d.ts","sourceRoot":"","sources":["../../../src/renderers/three/controls.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAIL,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EAMtB,OAAO,EAER,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AASvE,MAAM,MAAM,qBAAqB,GAAG,OAAO,CACzC,IAAI,CACF,cAAc,EACZ,SAAS,GACT,YAAY,GACZ,oBAAoB,GACpB,aAAa,GACb,aAAa,GACb,SAAS,GACT,SAAS,GACT,eAAe,GACf,eAAe,GACf,iBAAiB,GACjB,iBAAiB,GACjB,oBAAoB,GACpB,kBAAkB,GAClB,YAAY,GACZ,YAAY,GACZ,eAAe,CAClB,CACF,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,OAAO,CACxC,IAAI,CACF,aAAa,EACX,SAAS,GACT,eAAe,GACf,eAAe,GACf,YAAY,GACZ,WAAW,GACX,cAAc,GACd,aAAa,GACb,WAAW,GACX,UAAU,GACV,oBAAoB,GACpB,aAAa,GACb,aAAa,GACb,SAAS,GACT,SAAS,GACT,eAAe,GACf,eAAe,GACf,iBAAiB,GACjB,iBAAiB,GACjB,cAAc,GACd,YAAY,GACZ,iBAAiB,GACjB,aAAa,CAChB,CACF,GAAG;IACF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,qBAAqB,CAAA;CAAE,GACrE;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,oBAAoB,CAAA;CAAE,CAAC;AAExE,MAAM,MAAM,GAAG,GAAG;IAChB,qEAAqE;IACrE,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACjF,QAAQ,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC;IAC9C,yEAAyE;IACzE,QAAQ,CAAC,UAAU,EAAE,MAAM,OAAO,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B,CAAC;AAEF,wBAAgB,SAAS,CAAC,QAAQ,EAAE,eAAe,EAAE,MAAM,EAAE,iBAAiB,GAAG,kBAAkB,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,IAAI,GAAG,GAAG,CAInJ"}

package/lib/renderers/three/controls.js

@@ -0,0 +1,115 @@
+import CameraControls from "camera-controls";
+import { Box3, MathUtils, Matrix4, Quaternion, Raycaster, Sphere, Spherical, Vector2, Vector3, Vector4, } from "three";
+import { OrbitControls } from "three/addons/controls/OrbitControls.js";
+/**
+ * Camera controls: smooth by default (camera-controls), or the r3f renderer's OrbitControls, kept as an option with its behavior: damping, callbacks
+ * and an animated turn to the gizmo's views
+ */
+CameraControls.install({ THREE: { Vector2, Vector3, Vector4, Quaternion, Matrix4, Spherical, Box3, Sphere, Raycaster } });
+export function createRig(controls, camera, element, onInput) {
+    return controls.type === "orbit"
+        ? createOrbitRig(controls.options ?? {}, camera, element, onInput)
+        : createSmoothRig(controls.options ?? {}, camera, element, onInput);
+}
+function createSmoothRig(options, camera, element, onInput) {
+    const controls = new CameraControls(camera, element);
+    Object.assign(controls, { smoothTime: 0.15, draggingSmoothTime: 0.08, ...options });
+    const drag = { active: false, moved: false };
+    controls.addEventListener("controlstart", () => {
+        Object.assign(drag, { active: true, moved: false });
+        onInput();
+    });
+    controls.addEventListener("control", () => {
+        drag.moved = drag.active;
+        onInput();
+    });
+    controls.addEventListener("controlend", () => Object.assign(drag, { active: false, moved: false }));
+    // The wheel doesn't emit control events
+    element.addEventListener("wheel", onInput, { passive: true });
+    return {
+        update: (delta) => controls.update(delta),
+        setPose: (position, target, animate) => void controls.setLookAt(position.x, position.y, position.z, target.x, target.y, target.z, animate),
+        getTarget: (out) => controls.getTarget(out),
+        isDragging: () => drag.moved,
+        dispose: () => {
+            element.removeEventListener("wheel", onInput);
+            controls.dispose();
+        },
+    };
+}
+const turnSeconds = 0.4;
+function createOrbitRig(options, camera, element, onInput) {
+    const { onStart, onChange, onEnd, ...properties } = options;
+    const controls = new OrbitControls(camera, element);
+    // drei's OrbitControls default
+    Object.assign(controls, { enableDamping: true, ...properties });
+    const drag = { active: false, moved: false };
+    controls.addEventListener("start", () => {
+        Object.assign(drag, { active: true, moved: false });
+        onStart?.();
+        onInput();
+    });
+    controls.addEventListener("change", () => {
+        drag.moved = drag.active;
+        onChange?.();
+        onInput();
+    });
+    controls.addEventListener("end", () => {
+        Object.assign(drag, { active: false, moved: false });
+        onEnd?.();
+    });
+    // A turn to a new pose, rotating around the target on a sphere while the distance and target move linearly
+    const turn = {
+        elapsed: turnSeconds,
+        fromTarget: new Vector3(),
+        toTarget: new Vector3(),
+        from: new Quaternion(),
+        to: new Quaternion(),
+        fromDistance: 0,
+        toDistance: 0,
+    };
+    const direction = new Vector3();
+    const forward = new Vector3(0, 0, 1);
+    const step = (delta) => {
+        if (turn.elapsed >= turnSeconds) {
+            return false;
+        }
+        turn.elapsed = Math.min(turnSeconds, turn.elapsed + delta);
+        const t = MathUtils.smootherstep(turn.elapsed / turnSeconds, 0, 1);
+        controls.target.lerpVectors(turn.fromTarget, turn.toTarget, t);
+        direction.copy(forward).applyQuaternion(scratchQuaternion.slerpQuaternions(turn.from, turn.to, t));
+        camera.position.copy(controls.target).addScaledVector(direction, MathUtils.lerp(turn.fromDistance, turn.toDistance, t));
+        return true;
+    };
+    return {
+        update: (delta) => {
+            const turning = step(delta);
+            return controls.update(delta) || turning;
+        },
+        setPose: (position, target, animate) => {
+            if (!animate) {
+                turn.elapsed = turnSeconds;
+                controls.target.copy(target);
+                camera.position.copy(position);
+                controls.update();
+                return;
+            }
+            const fromOffset = scratchVector.subVectors(camera.position, controls.target);
+            turn.fromDistance = fromOffset.length();
+            turn.from.setFromUnitVectors(forward, fromOffset.normalize());
+            const toOffset = scratchVector.subVectors(position, target);
+            turn.toDistance = toOffset.length();
+            turn.to.setFromUnitVectors(forward, toOffset.normalize());
+            turn.fromTarget.copy(controls.target);
+            turn.toTarget.copy(target);
+            turn.elapsed = 0;
+            onInput();
+        },
+        getTarget: (out) => out.copy(controls.target),
+        isDragging: () => drag.moved,
+        dispose: () => controls.dispose(),
+    };
+}
+const scratchVector = new Vector3();
+const scratchQuaternion = new Quaternion();
+//# sourceMappingURL=controls.js.map

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

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

package/lib/renderers/three/geometry/geometry.test.d.ts

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

package/lib/renderers/three/geometry/geometry.test.d.ts.map

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

package/lib/renderers/three/geometry/geometry.test.js

@@ -0,0 +1,80 @@
+import { Vector3 } from "three";
+import { describe, expect, it } from "vitest";
+import { box, circleCurve, cone, cylinder, plane, polygon, roundHole, shape, sphere, tube, vec2, vec3, vec3Zero } from "../../../abstract-3d.js";
+import { createSolidGeometry, getSolidShape, keepGeometries } from "./geometry.js";
+const m = { normal: "rgb(0,0,0)" };
+const local = (mesh, x, y, z) => new Vector3(x, y, z)
+    .applyMatrix4(getSolidShape(mesh.geometry).local)
+    .toArray()
+    .map((v) => Math.round(v * 1000) / 1000 + 0);
+const key = (mesh) => getSolidShape(mesh.geometry).key;
+const bounds = (mesh) => {
+    const geometry = createSolidGeometry(mesh.geometry);
+    geometry.computeBoundingBox();
+    return [...geometry.boundingBox.min.toArray(), ...geometry.boundingBox.max.toArray()].map((v) => Math.round(v * 1000) / 1000 + 0);
+};
+describe("getSolidShape", () => {
+    it("shares unit geometries between primitives of any size, scaled by the local matrix", () => {
+        expect(key(box(vec3(1, 2, 3), m))).toBe(key(box(vec3(4, 5, 6), m)));
+        expect(local(box(vec3(2, 4, 6), m, vec3(10, 0, 0)), 0.5, 0.5, 0.5)).toEqual([11, 2, 3]);
+        expect(local(plane(vec3Zero, vec2(2, 4), m), 0.5, 0.5, 0)).toEqual([1, 2, 0]);
+        expect(local(sphere(3, m, vec3(1, 0, 0)), 1, 0, 0)).toEqual([4, 0, 0]);
+        expect(local(cone(vec3Zero, 2, 10, m), 1, 0.5, 0)).toEqual([2, 5, 0]);
+    });
+    it("scales cylinders by their largest radius, with a geometry per radius ratio", () => {
+        expect(key(cylinder(vec3Zero, 1, 2, m))).toBe(key(cylinder(vec3Zero, 5, 7, m)));
+        expect(key(cylinder(vec3Zero, 1, 2, m))).not.toBe(key(cylinder(vec3Zero, 1, 2, m, vec3Zero, false, [], 0, Math.PI * 2, 2)));
+        expect(local(cylinder(vec3Zero, 1, 10, m, vec3Zero, false, [], 0, Math.PI * 2, 4), 1, 0.5, 0)).toEqual([4, 5, 0]);
+    });
+    it("ignores zero holes", () => {
+        expect(key(box(vec3(1, 1, 1), m, vec3Zero, vec3Zero, [roundHole(vec2(0, 0), 0)]))).toBe(key(box(vec3(2, 2, 2), m)));
+    });
+    it("extrudes primitives with holes into their own geometry, centered", () => {
+        const holed = box(vec3(10, 10, 2), m, vec3(1, 0, 0), vec3Zero, [roundHole(vec2(0, 0), 2)]);
+        expect(key(holed)).not.toBe(key(box(vec3(10, 10, 2), m)));
+        expect(local(holed, 0, 0, 0)).toEqual([1, 0, 0]);
+        expect(bounds(holed)).toEqual([-5, -5, -1, 5, 5, 1]);
+        expect(bounds(cylinder(vec3Zero, 2, 10, m, vec3Zero, false, [roundHole(vec2(0, 0), 1)]))).toEqual([-2, -5, -2, 2, 5, 2]);
+    });
+});
+describe("createSolidGeometry", () => {
+    it("closes partial cylinders with walls", () => {
+        const whole = createSolidGeometry(cylinder(vec3Zero, 1, 1, m).geometry);
+        const half = createSolidGeometry(cylinder(vec3Zero, 1, 1, m, vec3Zero, false, [], 0, Math.PI).geometry);
+        expect(half.getAttribute("position").count).toBeGreaterThan(whole.getAttribute("position").count / 2);
+    });
+    it("draws 4-point polygons as a quad and other polygons as a triangle list", () => {
+        expect(createSolidGeometry(polygon([vec3(0, 0, 0), vec3(1, 0, 0), vec3(1, 1, 0), vec3(0, 1, 0)], m).geometry).index.count).toBe(6);
+        expect(createSolidGeometry(polygon([vec3(0, 0, 0), vec3(1, 0, 0), vec3(1, 1, 0)], m).geometry).index.count).toBe(3);
+    });
+    it("gives every geometry an index, normals and uvs, so they can share a batch", () => {
+        const meshes = [
+            box(vec3(1, 1, 1), m),
+            box(vec3(1, 1, 1), m, vec3Zero, vec3Zero, [roundHole(vec2(0, 0), 0.1)]),
+            polygon([vec3(0, 0, 0), vec3(1, 0, 0), vec3(1, 1, 0)], m),
+            cylinder(vec3Zero, 1, 1, m, vec3Zero, false, [], 0, Math.PI),
+            shape([vec2(0, 0), vec2(1, 0), vec2(0, 1)], vec3Zero, m, 1),
+            tube(circleCurve(10, 0, Math.PI), 1, m),
+        ];
+        meshes.forEach((mesh) => {
+            const geometry = createSolidGeometry(mesh.geometry);
+            expect(geometry.index.count).toBeGreaterThan(0);
+            expect(Object.keys(geometry.attributes).toSorted()).toEqual(["normal", "position", "uv"]);
+        });
+    });
+});
+describe("keepGeometries", () => {
+    it("disposes the geometries a build no longer uses", () => {
+        const [kept, unused] = [createSolidGeometry(box(vec3(1, 1, 1), m).geometry), createSolidGeometry(sphere(1, m).geometry)];
+        const cache = new Map([
+            ["Box", kept],
+            ["Sphere", unused],
+        ]);
+        const disposed = [];
+        unused.addEventListener("dispose", () => disposed.push("Sphere"));
+        keepGeometries(cache, new Set(["Box"]));
+        expect(disposed).toEqual(["Sphere"]);
+        expect([...cache.keys()]).toEqual(["Box"]);
+    });
+});
+//# sourceMappingURL=geometry.test.js.map

package/lib/renderers/three/geometry/geometry.test.js.map

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

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

@@ -0,0 +1,20 @@
+import { type BufferGeometry, Matrix4 } from "three";
+import type { Mesh } from "../../abstract-3d.js";
+/** Solid geometries by key, so identical shapes share one geometry; primitives are unit geometries scaled by their local matrix */
+export type SolidShape = {
+    readonly key: string;
+    readonly create: () => BufferGeometry;
+    /** Position, rotation and, for unit geometries, scale, relative to the item's matrix */
+    readonly local: Matrix4;
+};
+/** The shape of a solid geometry, undefined for text, lines and images; it creates indexed geometries with position, normal and uv */
+export declare function getSolidShape(geometry: Mesh["geometry"]): SolidShape | undefined;
+export type GeometryCache = {
+    /** The shape's geometry, created on first use */
+    readonly get: (shape: SolidShape) => BufferGeometry;
+    /** Disposes the geometries whose keys aren't in `keys` */
+    readonly keepOnly: (keys: ReadonlySet<string>) => void;
+    readonly dispose: () => void;
+};
+export declare function createGeometryCache(): GeometryCache;
+//# sourceMappingURL=geometry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../../../src/renderers/three/geometry.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EAOnB,OAAO,EAMR,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAiB,IAAI,EAAe,MAAM,sBAAsB,CAAC;AAK7E,mIAAmI;AAEnI,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,cAAc,CAAC;IACtC,wFAAwF;IACxF,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,sIAAsI;AACtI,wBAAgB,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,GAAG,UAAU,GAAG,SAAS,CAGhF;AAkED,MAAM,MAAM,aAAa,GAAG;IAC1B,iDAAiD;IACjD,QAAQ,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,cAAc,CAAC;IACpD,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IACvD,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B,CAAC;AAEF,wBAAgB,mBAAmB,IAAI,aAAa,CAsBnD"}

package/lib/renderers/three/geometry.js

@@ -0,0 +1,164 @@
+import { BoxGeometry, BufferGeometry as ThreeBufferGeometry, CatmullRomCurve3, ConeGeometry, CylinderGeometry, ExtrudeGeometry, Float32BufferAttribute, Matrix4, PlaneGeometry, Shape, SphereGeometry, TubeGeometry, Vector3, } from "three";
+import { mergeGeometries } from "three/addons/utils/BufferGeometryUtils.js";
+import { isZero, vec2Scale, vec3, vec3Zero } from "../../abstract-3d.js";
+import { addHoles, CircleCurve, CYLINDER_SEGMENTS, cylinderCutPositions, nonZeroHoles } from "../shared/three-geometry.js";
+import { transform } from "./compile.js";
+/** The shape of a solid geometry, undefined for text, lines and images; it creates indexed geometries with position, normal and uv */
+export function getSolidShape(geometry) {
+    const shape = getShape(geometry);
+    return shape && { ...shape, create: () => normalized(shape.create()) };
+}
+function getShape(geometry) {
+    switch (geometry.type) {
+        case "Box": {
+            const { pos, rot, size } = geometry;
+            return nonZeroHoles(geometry.holes).length === 0
+                ? { key: "box", create: () => new BoxGeometry(), local: transform(pos, rot, new Matrix4(), size) }
+                : extrudedRectangle("box", geometry, size.z);
+        }
+        case "Plane": {
+            const { pos, rot, size } = geometry;
+            return nonZeroHoles(geometry.holes).length === 0
+                ? { key: "plane", create: () => new PlaneGeometry(), local: transform(pos, rot, new Matrix4(), vec3(size.x, size.y, 1)) }
+                : extrudedRectangle("plane", geometry, 0);
+        }
+        case "Sphere":
+            return {
+                key: "sphere",
+                create: () => new SphereGeometry(1, 12, 12),
+                local: transform(geometry.pos, vec3Zero, new Matrix4(), vec3(geometry.radius, geometry.radius, geometry.radius)),
+            };
+        case "Cone": {
+            const { pos, rot, radius, length } = geometry;
+            return { key: "cone", create: () => new ConeGeometry(1, 1, 16, 1), local: transform(pos, rot, new Matrix4(), vec3(radius, length, radius)) };
+        }
+        case "Cylinder":
+            return cylinderShape(geometry);
+        case "Shape": {
+            const { points, holes, thickness, pos, rot } = geometry;
+            return {
+                key: `shape:${JSON.stringify([points, nonZeroHoles(holes), thickness])}`,
+                create: () => {
+                    const shape = new Shape();
+                    points.forEach((p, i) => (i === 0 ? shape.moveTo(p.x, p.y) : shape.lineTo(p.x, p.y)));
+                    shape.closePath();
+                    addHoles(holes, shape);
+                    return new ExtrudeGeometry(shape, { depth: thickness, bevelEnabled: false }).translate(0, 0, -thickness / 2);
+                },
+                local: transform(pos, rot),
+            };
+        }
+        case "Polygon": {
+            const { points, pos, rot } = geometry;
+            return { key: `polygon:${JSON.stringify(points)}`, create: () => polygonGeometry(points), local: transform(pos, rot) };
+        }
+        case "Tube": {
+            const { curve, radius, pos, rot } = geometry;
+            return {
+                key: `tube:${JSON.stringify([curve, radius])}`,
+                create: () => new TubeGeometry(curve.type === "SplineCurve" ? new CatmullRomCurve3(curve.points.map((p) => new Vector3(p.x, p.y, p.z))) : new CircleCurve(curve), 9, radius, 9, false),
+                local: transform(pos, rot),
+            };
+        }
+        default:
+            return undefined;
+    }
+}
+export function createGeometryCache() {
+    const geometries = new Map();
+    const keepOnly = (keys) => geometries.forEach((geometry, key) => {
+        if (!keys.has(key)) {
+            geometry.dispose();
+            geometries.delete(key);
+        }
+    });
+    return {
+        get: (shape) => {
+            const cached = geometries.get(shape.key);
+            if (cached) {
+                return cached;
+            }
+            const geometry = shape.create();
+            geometries.set(shape.key, geometry);
+            return geometry;
+        },
+        keepOnly,
+        dispose: () => keepOnly(new Set()),
+    };
+}
+function cylinderShape(geometry) {
+    const { pos, rot, radius, radiusEnd = radius, length, holes, open = false, angleStart = 0, angleLength = Math.PI * 2 } = geometry;
+    const isWhole = isZero(Math.PI * 2 - angleLength);
+    // Holes are extruded along the length, which can't taper
+    if (isWhole && radiusEnd === radius && nonZeroHoles(holes).length > 0) {
+        return {
+            key: `cylinder-holes:${JSON.stringify([radius, length, nonZeroHoles(holes)])}`,
+            create: () => {
+                const shape = new Shape();
+                shape.moveTo(0, radius).absellipse(0, 0, radius, radius, 0, Math.PI * 2, true);
+                addHoles(holes, shape);
+                return new ExtrudeGeometry(shape, { depth: length, bevelEnabled: false }).rotateX(Math.PI / 2).translate(0, length / 2, 0);
+            },
+            local: transform(pos, rot),
+        };
+    }
+    // Unit geometry scaled by the largest radius, so only the radius ratio needs its own geometry
+    const maxRadius = Math.max(radius, radiusEnd);
+    const top = radiusEnd / (maxRadius || 1);
+    const bottom = radius / (maxRadius || 1);
+    const local = transform(pos, rot, new Matrix4(), vec3(maxRadius, length, maxRadius));
+    return isWhole
+        ? { key: `cylinder:${top}:${bottom}:${open}`, create: () => new CylinderGeometry(top, bottom, 1, CYLINDER_SEGMENTS, 1, open), local }
+        : {
+            key: `cylinder-part:${top}:${bottom}:${angleStart}:${angleLength}`,
+            create: () => {
+                const walls = new ThreeBufferGeometry();
+                walls.setAttribute("position", new Float32BufferAttribute(cylinderCutPositions(top, bottom, 1, angleStart, angleLength), 3));
+                walls.computeVertexNormals();
+                const mantle = new CylinderGeometry(top, bottom, 1, CYLINDER_SEGMENTS, 1, false, angleStart, angleLength);
+                return mergeGeometries([normalized(mantle), normalized(walls)]);
+            },
+            local,
+        };
+}
+function extrudedRectangle(kind, geometry, depth) {
+    const half = vec2Scale(geometry.size, 0.5);
+    return {
+        key: `${kind}-holes:${JSON.stringify([geometry.size, nonZeroHoles(geometry.holes)])}`,
+        create: () => {
+            const shape = new Shape();
+            shape.moveTo(-half.x, -half.y).lineTo(-half.x, half.y).lineTo(half.x, half.y).lineTo(half.x, -half.y).closePath();
+            addHoles(geometry.holes, shape);
+            return new ExtrudeGeometry(shape, { depth, bevelEnabled: false }).translate(0, 0, -depth / 2);
+        },
+        local: transform(geometry.pos, geometry.rot),
+    };
+}
+/** A quad for 4 points, else a list of triangles, as the points are given */
+function polygonGeometry(points) {
+    const corners = points.length === 4 ? [0, 1, 2, 2, 3, 0] : points.slice(0, Math.floor(points.length / 3) * 3).map((_, i) => i);
+    const geometry = new ThreeBufferGeometry();
+    geometry.setAttribute("position", new Float32BufferAttribute(points.flatMap((p) => [p.x, p.y, p.z]), 3));
+    geometry.setIndex(corners);
+    geometry.computeVertexNormals();
+    return geometry;
+}
+/** Indexed, with exactly position, normal and uv attributes and no groups, as a BatchedMesh needs */
+function normalized(geometry) {
+    const count = geometry.getAttribute("position").count;
+    if (!geometry.index) {
+        geometry.setIndex(Array.from({ length: count }, (_, i) => i));
+    }
+    if (!geometry.hasAttribute("normal")) {
+        geometry.computeVertexNormals();
+    }
+    if (!geometry.hasAttribute("uv")) {
+        geometry.setAttribute("uv", new Float32BufferAttribute(new Float32Array(count * 2), 2));
+    }
+    Object.keys(geometry.attributes)
+        .filter((name) => name !== "position" && name !== "normal" && name !== "uv")
+        .forEach((name) => geometry.deleteAttribute(name));
+    geometry.clearGroups();
+    return geometry;
+}
+//# sourceMappingURL=geometry.js.map