abstract-3d 3.1.1 → 4.0.0-beta.0

package/lib/renderers/three/camera/camera.js

@@ -0,0 +1,51 @@
+import { exhaustiveCheck } from "ts-exhaustive-check";
+import { vec3 } from "../../../abstract-3d.js";
+/** Sets the camera's projection to fit the scene into the usable area of the canvas, and returns where to place it */
+export function fitCamera(camera, { view, size: sceneSize, canvas, bufferZones, fitPadding }) {
+    if (canvas.width === 0 || canvas.height === 0) {
+        return undefined;
+    }
+    const [direction, size, sceneAspect] = getViewTransform(view, sceneSize);
+    const { left = 0, right = 0, top = 0, bottom = 0 } = bufferZones;
+    const usableW = Math.max(1, canvas.width - left - right);
+    const usableH = Math.max(1, canvas.height - top - bottom);
+    const usableAspect = usableW / usableH;
+    camera.zoom = 1;
+    if ("isOrthographicCamera" in camera) {
+        const pad = 1 + fitPadding;
+        // Constrained by the scene's width when it's wider than the usable area, else by its height
+        const [halfW, halfH] = sceneAspect > usableAspect
+            ? [(size.x / 2) * pad, (size.x / 2 / usableAspect) * pad]
+            : [((usableAspect * size.y) / 2) * pad, (size.y / 2) * pad];
+        // Extended by the buffer zones, at the world units per CSS pixel of the usable area
+        const [wpp, hpp] = [(halfW * 2) / usableW, (halfH * 2) / usableH];
+        Object.assign(camera, { left: -halfW - left * wpp, right: halfW + right * wpp, top: halfH + top * hpp, bottom: -halfH - bottom * hpp });
+        camera.updateProjectionMatrix();
+        const fovTan = Math.tan((45 * Math.PI) / 360);
+        return { distance: size.z * 0.5 + Math.max(size.x, size.y) * 2 * fovTan, direction };
+    }
+    // The field of view describes the usable area; the view offset extends the rendered frustum from it to the full canvas
+    const tan = Math.tan((camera.fov * Math.PI) / 360);
+    const distance = Math.max(size.y / 2 / tan, size.x / 2 / (tan * usableAspect)) + size.z * 0.5;
+    camera.aspect = usableAspect;
+    camera.setViewOffset(usableW, usableH, -left, -top, canvas.width, canvas.height);
+    camera.updateProjectionMatrix();
+    return { distance: distance * (1 + fitPadding), direction };
+}
+/** The direction to look from, the scene's size as seen on screen and its aspect */
+function getViewTransform(view, size) {
+    switch (view) {
+        case "front":
+        case "back":
+            return [vec3(0, 0, view === "front" ? 1 : -1), size, size.x / size.y];
+        case "top":
+        case "bottom":
+            return [vec3(0, view === "top" ? 1 : -1, 0), vec3(size.x, size.z, size.y), size.x / size.z];
+        case "right":
+        case "left":
+            return [vec3(view === "right" ? 1 : -1, 0, 0), vec3(size.z, size.y, size.x), size.z / size.y];
+        default:
+            return exhaustiveCheck(view);
+    }
+}
+//# sourceMappingURL=camera.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,46 @@
+import { OrthographicCamera, PerspectiveCamera } from "three";
+import { describe, expect, it } from "vitest";
+import { vec3 } from "../../../abstract-3d.js";
+import { fitCamera } from "./camera.js";
+const input = { view: "front", size: vec3(4000, 2000, 1000), canvas: { width: 800, height: 400 }, bufferZones: {}, fitPadding: 0 };
+const tan = Math.tan((45 * Math.PI) / 360);
+const fitPerspective = (partial = {}) => {
+    const camera = new PerspectiveCamera(45);
+    return [camera, fitCamera(camera, { ...input, ...partial })];
+};
+const fitOrthographic = (partial = {}) => {
+    const camera = new OrthographicCamera();
+    fitCamera(camera, { ...input, ...partial });
+    return [camera.left, camera.right, camera.top, camera.bottom, camera.zoom];
+};
+describe("fitCamera", () => {
+    it("fits nothing into an empty canvas", () => {
+        expect(fitPerspective({ canvas: { width: 0, height: 400 } })[1]).toBeUndefined();
+    });
+    it("backs a perspective camera off until the scene's width and height fit, plus half its depth", () => {
+        const [camera, placement] = fitPerspective();
+        expect(placement.distance).toBeCloseTo(Math.max(1000 / tan, 2000 / (tan * 2)) + 500);
+        expect(placement.direction).toEqual(vec3(0, 0, 1));
+        expect(camera.aspect).toBe(2);
+    });
+    it("pads the distance", () => {
+        expect(fitPerspective({ fitPadding: 0.1 })[1].distance).toBeCloseTo(fitPerspective()[1].distance * 1.1);
+    });
+    it("fits into the area inside the buffer zones, and offsets the view to it", () => {
+        const [camera] = fitPerspective({ bufferZones: { left: 200, top: 100 } });
+        expect(camera.aspect).toBeCloseTo(600 / 300);
+        expect(camera.view).toMatchObject({ enabled: true, fullWidth: 600, fullHeight: 300, offsetX: -200, offsetY: -100, width: 800, height: 400 });
+    });
+    it("looks along each view, with the scene's size seen from it", () => {
+        expect(fitPerspective({ view: "top" })[1].direction).toEqual(vec3(0, 1, 0));
+        expect(fitPerspective({ view: "left" })[1].direction).toEqual(vec3(-1, 0, 0));
+        // From the top, the scene is 4000 wide and 1000 high on screen, and 2000 deep
+        expect(fitPerspective({ view: "top" })[1].distance).toBeCloseTo(Math.max(500 / tan, 2000 / (tan * 2)) + 1000);
+    });
+    it("frames orthographic cameras around the scene, extended by the buffer zones", () => {
+        expect(fitOrthographic()).toEqual([-2000, 2000, 1000, -1000, 1]);
+        // The usable area is 400 x 400, so the scene's 4000 width sets 10 world units per pixel
+        expect(fitOrthographic({ bufferZones: { right: 400 } })).toEqual([-2000, 6000, 2000, -2000, 1]);
+    });
+});
+//# sourceMappingURL=camera.test.js.map

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

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

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

@@ -0,0 +1,24 @@
+import type { OrthographicCamera, PerspectiveCamera, Vector3 } from "three";
+import { OrbitControls } from "three/addons/controls/OrbitControls.js";
+/** The r3f renderer's OrbitControls, with drei's damping default */
+export type ControlsOptions = Partial<Omit<OrbitControls, "object" | "domElement" | "target" | "cursor">> & {
+    readonly onStart?: () => void;
+    readonly onChange?: () => void;
+    readonly onEnd?: () => void;
+};
+export type Controls = {
+    readonly orbit: OrbitControls;
+    readonly current: {
+        options: ControlsOptions;
+    };
+    /** The user drags the camera, and it moved since the drag started */
+    readonly drag: {
+        active: boolean;
+        moved: boolean;
+    };
+};
+export declare function createControls(camera: PerspectiveCamera | OrthographicCamera, element: HTMLElement, options: ControlsOptions, onInput: () => void): Controls;
+/** Sets the options that are defined, so ones left out keep their defaults */
+export declare function configureControls(controls: Controls, options: ControlsOptions): void;
+export declare function setPose(controls: Controls, position: Vector3, target: Vector3): void;
+//# sourceMappingURL=controls.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"controls.d.ts","sourceRoot":"","sources":["../../../../src/renderers/three/camera/controls.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAEvE,oEAAoE;AAEpE,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,GAAG,YAAY,GAAG,QAAQ,GAAG,QAAQ,CAAC,CAAC,GAAG;IAC1G,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,QAAQ,GAAG;IACrB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,eAAe,CAAA;KAAE,CAAC;IAC/C,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;CACpD,CAAC;AAEF,wBAAgB,cAAc,CAC5B,MAAM,EAAE,iBAAiB,GAAG,kBAAkB,EAC9C,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,MAAM,IAAI,GAClB,QAAQ,CAOV;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI,CAQpF;AAED,wBAAgB,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAIpF"}

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

@@ -0,0 +1,39 @@
+import { OrbitControls } from "three/addons/controls/OrbitControls.js";
+export function createControls(camera, element, options, onInput) {
+    const controls = { orbit: new OrbitControls(camera, element), current: { options }, drag: { active: false, moved: false } };
+    configureControls(controls, options);
+    controls.orbit.addEventListener("start", () => onDragStart(controls, onInput));
+    controls.orbit.addEventListener("change", () => onDragChange(controls, onInput));
+    controls.orbit.addEventListener("end", () => onDragEnd(controls));
+    return controls;
+}
+/** Sets the options that are defined, so ones left out keep their defaults */
+export function configureControls(controls, options) {
+    controls.current.options = options;
+    controls.orbit.enableDamping = true;
+    Object.entries(options).forEach(([key, value]) => {
+        if (value !== undefined && typeof value !== "function") {
+            Object.assign(controls.orbit, { [key]: value });
+        }
+    });
+}
+export function setPose(controls, position, target) {
+    controls.orbit.target.copy(target);
+    controls.orbit.object.position.copy(position);
+    controls.orbit.update();
+}
+function onDragStart(controls, onInput) {
+    Object.assign(controls.drag, { active: true, moved: false });
+    controls.current.options.onStart?.();
+    onInput();
+}
+function onDragChange(controls, onInput) {
+    controls.drag.moved = controls.drag.active;
+    controls.current.options.onChange?.();
+    onInput();
+}
+function onDragEnd(controls) {
+    Object.assign(controls.drag, { active: false, moved: false });
+    controls.current.options.onEnd?.();
+}
+//# sourceMappingURL=controls.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"controls.js","sourceRoot":"","sources":["../../../../src/renderers/three/camera/controls.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAiBvE,MAAM,UAAU,cAAc,CAC5B,MAA8C,EAC9C,OAAoB,EACpB,OAAwB,EACxB,OAAmB;IAEnB,MAAM,QAAQ,GAAa,EAAE,KAAK,EAAE,IAAI,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC;IACtI,iBAAiB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACrC,QAAQ,CAAC,KAAK,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/E,QAAQ,CAAC,KAAK,CAAC,gBAAgB,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IACjF,QAAQ,CAAC,KAAK,CAAC,gBAAgB,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;IAClE,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,iBAAiB,CAAC,QAAkB,EAAE,OAAwB;IAC5E,QAAQ,CAAC,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC;IACnC,QAAQ,CAAC,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC;IACpC,MAAM,CAAC,OAAO,CAAC,OAAkC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QAC1E,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;YACvD,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAClD,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,QAAkB,EAAE,QAAiB,EAAE,MAAe;IAC5E,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9C,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;AAC1B,CAAC;AAED,SAAS,WAAW,CAAC,QAAkB,EAAE,OAAmB;IAC1D,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7D,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;IACrC,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,YAAY,CAAC,QAAkB,EAAE,OAAmB;IAC3D,QAAQ,CAAC,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;IAC3C,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;IACtC,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,SAAS,CAAC,QAAkB;IACnC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9D,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;AACrC,CAAC"}

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

@@ -0,0 +1,44 @@
+import type { OrthographicCamera, PerspectiveCamera, WebGLRenderer } from "three";
+import { ViewportGizmo } from "three-viewport-gizmo";
+/**
+ * A viewcube or axes in a corner of the canvas that turns with the camera; clicking it turns the camera to look from that side. three-viewport-gizmo,
+ * with the options of drei's GizmoViewcube and GizmoViewport that the r3f renderer took
+ */
+export type GizmoAlignment = `${"top" | "center" | "bottom"}-${"left" | "center" | "right"}`;
+export type ViewcubeOptions = {
+    /** A CSS font; its weight and family are used */
+    readonly font?: string;
+    readonly opacity?: number;
+    readonly color?: string;
+    readonly hoverColor?: string;
+    readonly textColor?: string;
+    readonly strokeColor?: string;
+    /** Labels of the +x, -x, +y, -y, +z and -z faces */
+    readonly faces?: ReadonlyArray<string>;
+    /** Clicking also moves the target back to the scene's center and fits the scene */
+    readonly resetZoomAndPanOnClick?: boolean;
+};
+export type AxesOptions = {
+    readonly axisColors?: readonly [string, string, string];
+    readonly labels?: readonly [string, string, string];
+    readonly labelColor?: string;
+    readonly hideNegativeAxes?: boolean;
+    readonly disabled?: boolean;
+    readonly font?: string;
+    readonly resetZoomAndPanOnClick?: boolean;
+};
+export type ControlsHelper = ({
+    readonly type: "Viewcube";
+    readonly viewcubeProps?: ViewcubeOptions;
+} | {
+    readonly type: "Viewport";
+    readonly viewportProps?: AxesOptions;
+}) & {
+    /** The margin is from the canvas' corner to the gizmo's center, in CSS pixels */
+    readonly props?: {
+        readonly alignment?: GizmoAlignment;
+        readonly margin?: readonly [number, number];
+    };
+};
+export declare function createGizmo(camera: PerspectiveCamera | OrthographicCamera, renderer: WebGLRenderer, container: HTMLElement, helper: ControlsHelper): ViewportGizmo;
+//# sourceMappingURL=gizmo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gizmo.d.ts","sourceRoot":"","sources":["../../../../src/renderers/three/camera/gizmo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAElF,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD;;;GAGG;AAEH,MAAM,MAAM,cAAc,GAAG,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,IAAI,MAAM,GAAG,QAAQ,GAAG,OAAO,EAAE,CAAC;AAE7F,MAAM,MAAM,eAAe,GAAG;IAC5B,iDAAiD;IACjD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,oDAAoD;IACpD,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACvC,mFAAmF;IACnF,QAAQ,CAAC,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACxD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACpD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,CACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,eAAe,CAAA;CAAE,GACvE;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,WAAW,CAAA;CAAE,CACtE,GAAG;IACF,iFAAiF;IACjF,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;CACvG,CAAC;AAKF,wBAAgB,WAAW,CACzB,MAAM,EAAE,iBAAiB,GAAG,kBAAkB,EAC9C,QAAQ,EAAE,aAAa,EACvB,SAAS,EAAE,WAAW,EACtB,MAAM,EAAE,cAAc,GACrB,aAAa,CAef"}

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

@@ -0,0 +1,42 @@
+import { ViewportGizmo } from "three-viewport-gizmo";
+const size = 110;
+const axes = ["x", "nx", "y", "ny", "z", "nz"];
+export function createGizmo(camera, renderer, container, helper) {
+    const [mx, my] = helper.props?.margin ?? [80, 80];
+    const options = helper.type === "Viewcube" ? helper.viewcubeProps : helper.viewportProps;
+    // "600 24px Helvetica, Arial" is weight 600 of Helvetica, Arial
+    const [, weight = 600, family = "Helvetica, Arial, sans-serif"] = /^(?:(\S+)\s+)?[\d.]+px\s+(.+)$/.exec(options?.font ?? "") ?? [];
+    const gizmo = new ViewportGizmo(camera, renderer, {
+        container,
+        size,
+        placement: helper.props?.alignment ?? "bottom-right",
+        offset: { left: mx - size / 2, right: mx - size / 2, top: my - size / 2, bottom: my - size / 2 },
+        font: { family, weight },
+        ...(helper.type === "Viewcube" ? getViewcubeOptions(helper.viewcubeProps ?? {}) : getAxesOptions(helper.viewportProps ?? {})),
+    });
+    gizmo.enabled = !(helper.type === "Viewport" && helper.viewportProps?.disabled);
+    return gizmo;
+}
+function getViewcubeOptions(options) {
+    const { opacity = 1, color = "#f4f5f7", hoverColor = "#cfe0ff", textColor = "#333", strokeColor = "#9aa0a6" } = options;
+    const labels = options.faces ?? ["Right", "Left", "Top", "Bottom", "Front", "Back"];
+    const face = { color, opacity, labelColor: textColor, hover: { color: hoverColor, labelColor: textColor, opacity } };
+    return {
+        type: "cube",
+        background: { color: strokeColor, opacity, hover: { color: strokeColor, opacity } },
+        corners: { color, hover: { color: hoverColor } },
+        edges: { color, hover: { color: hoverColor } },
+        ...Object.fromEntries(axes.map((axis, i) => [axis, { ...face, label: (labels[i] ?? "").toUpperCase() }])),
+    };
+}
+function getAxesOptions(options) {
+    const { axisColors = ["#ff3653", "#8adb00", "#2c8fff"], labels = ["X", "Y", "Z"], labelColor = "#000" } = options;
+    return {
+        type: "sphere",
+        ...Object.fromEntries(axes.map((axis, i) => [
+            axis,
+            { color: axisColors[Math.floor(i / 2)], labelColor, ...(i % 2 ? { enabled: !options.hideNegativeAxes } : { label: labels[i / 2] }) },
+        ])),
+    };
+}
+//# sourceMappingURL=gizmo.js.map

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

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

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

@@ -0,0 +1,63 @@
+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 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;
+    readonly camera: CameraOptions;
+    /** In CSS pixels */
+    readonly canvas: {
+        readonly width: number;
+        readonly height: number;
+    };
+    readonly bufferZones: BufferZones;
+    readonly fitPadding: number;
+};
+type FitPlacement = {
+    /** The camera's distance from the target */
+    readonly distance: number;
+    /** From the target to the camera */
+    readonly direction: Vec3;
+};
+export type Fit = (FitPlacement & {
+    readonly type: "Perspective";
+    readonly fov: number;
+    readonly aspect: number;
+    readonly viewOffset: {
+        readonly fullWidth: number;
+        readonly fullHeight: number;
+        readonly x: number;
+        readonly y: number;
+        readonly width: number;
+        readonly height: number;
+    };
+}) | (FitPlacement & {
+    readonly type: "Orthographic";
+    readonly left: number;
+    readonly right: number;
+    readonly top: number;
+    readonly bottom: number;
+});
+export declare function fitCamera({ view, size: sceneSize, camera, canvas, bufferZones, fitPadding }: FitInput): Fit | undefined;
+/** Sets the camera's projection from the fit; the caller places the camera */
+export declare function applyFit(fit: Fit, camera: PerspectiveCamera | OrthographicCamera): void;
+export {};
+//# sourceMappingURL=camera.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"camera.d.ts","sourceRoot":"","sources":["../../../src/renderers/three/camera.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAEnE,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAGvD,yIAAyI;AAEzI,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;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,uBAAuB;IACvB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,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,KAAK,YAAY,GAAG;IAClB,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,oCAAoC;IACpC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,GAAG,GACX,CAAC,YAAY,GAAG;IACd,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE;QACnB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB,CAAC;CACH,CAAC,GACF,CAAC,YAAY,GAAG;IACd,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC,CAAC;AAEP,wBAAgB,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,QAAQ,GAAG,GAAG,GAAG,SAAS,CA6CvH;AAED,8EAA8E;AAC9E,wBAAgB,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,iBAAiB,GAAG,kBAAkB,GAAG,IAAI,CAevF"}

package/lib/renderers/three/camera.js

@@ -0,0 +1,85 @@
+import { exhaustiveCheck } from "ts-exhaustive-check";
+import { vec3 } from "../../abstract-3d.js";
+export function fitCamera({ view, size: sceneSize, camera, canvas, bufferZones, fitPadding }) {
+    if (canvas.width === 0 || canvas.height === 0) {
+        return undefined;
+    }
+    const [direction, size, sceneAspect] = getViewTransform(view, sceneSize);
+    const fov = camera.type === "Perspective" ? (camera.fov ?? 45) : 45;
+    const { left = 0, right = 0, top = 0, bottom = 0 } = bufferZones;
+    const usableW = Math.max(1, canvas.width - left - right);
+    const usableH = Math.max(1, canvas.height - top - bottom);
+    const usableAspect = usableW / usableH;
+    if (camera.type === "Orthographic") {
+        const padFactor = 1 + fitPadding;
+        // Constrained by the scene's width when it's wider than the usable area, else by its height
+        const [halfW, halfH] = sceneAspect > usableAspect
+            ? [(size.x / 2) * padFactor, (size.x / 2 / usableAspect) * padFactor]
+            : [((usableAspect * size.y) / 2) * padFactor, (size.y / 2) * padFactor];
+        // World units per CSS pixel in the usable area
+        const wpp = (halfW * 2) / usableW;
+        const hpp = (halfH * 2) / usableH;
+        return {
+            type: "Orthographic",
+            distance: cameraDistance(size, fov),
+            direction,
+            left: -halfW - left * wpp,
+            right: halfW + right * wpp,
+            top: halfH + top * hpp,
+            bottom: -halfH - bottom * hpp,
+        };
+    }
+    // The field of view describes the usable area; the view offset extends the rendered frustum from it to the full canvas
+    const fovRad = (fov * Math.PI) / 180;
+    const fovHRad = 2 * Math.atan(Math.tan(fovRad / 2) * usableAspect);
+    const distForH = size.y / 2 / Math.tan(fovRad / 2) + size.z * 0.5;
+    const distForW = size.x / 2 / Math.tan(fovHRad / 2) + size.z * 0.5;
+    return {
+        type: "Perspective",
+        distance: Math.max(distForH, distForW) * (1 + fitPadding),
+        direction,
+        fov,
+        aspect: usableAspect,
+        viewOffset: { fullWidth: usableW, fullHeight: usableH, x: -left, y: -top, width: canvas.width, height: canvas.height },
+    };
+}
+/** Sets the camera's projection from the fit; the caller places the camera */
+export function applyFit(fit, camera) {
+    if (fit.type === "Perspective" && "isPerspectiveCamera" in camera) {
+        const { fullWidth, fullHeight, x, y, width, height } = fit.viewOffset;
+        camera.fov = fit.fov;
+        camera.aspect = fit.aspect;
+        camera.zoom = 1;
+        camera.setViewOffset(fullWidth, fullHeight, x, y, width, height);
+    }
+    else if (fit.type === "Orthographic" && "isOrthographicCamera" in camera) {
+        camera.left = fit.left;
+        camera.right = fit.right;
+        camera.top = fit.top;
+        camera.bottom = fit.bottom;
+        camera.zoom = 1;
+    }
+    camera.updateProjectionMatrix();
+}
+/** The distance an orthographic camera is placed at, far enough to see the scene's depth */
+const cameraDistance = (size, fov) => size.z * 0.5 + (size.x > size.y ? size.x : size.y) / (1 / 2 / Math.tan((Math.PI * fov) / 180 / 2));
+/** The direction to look from, the scene's size as seen on screen and its aspect */
+function getViewTransform(view, size) {
+    switch (view) {
+        case "front":
+            return [vec3(0, 0, 1), size, size.x / size.y];
+        case "back":
+            return [vec3(0, 0, -1), size, size.x / size.y];
+        case "top":
+            return [vec3(0, 1, 0), vec3(size.x, size.z, size.y), size.x / size.z];
+        case "bottom":
+            return [vec3(0, -1, 0), vec3(size.x, size.z, size.y), size.x / size.z];
+        case "right":
+            return [vec3(1, 0, 0), vec3(size.z, size.y, size.x), size.z / size.y];
+        case "left":
+            return [vec3(-1, 0, 0), vec3(size.z, size.y, size.x), size.z / size.y];
+        default:
+            return exhaustiveCheck(view);
+    }
+}
+//# sourceMappingURL=camera.js.map

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

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

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

@@ -0,0 +1,59 @@
+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; groups transform as the r3f renderer's
+ * react-group.tsx
+ */
+/** 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>;
+};
+/** Targets are the top-level groups, then the dimensions, then the relations */
+export declare function compileScene(scene: Scene, createGroupId?: (g: Group) => string): CompiledScene;
+/** The item's world matrix at `seconds` into its animations, written to `out` */
+export declare function getItemMatrix(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): Matrix4;
+//# sourceMappingURL=compile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../../../src/renderers/three/compile/compile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,OAAO,EAAuB,MAAM,OAAO,CAAC;AAC5D,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAGlF;;;GAGG;AAEH,uCAAuC;AACvC,MAAM,MAAM,IAAI,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AACvD,kFAAkF;AAClF,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC;AAEnE,sFAAsF;AACtF,MAAM,MAAM,MAAM,GACd;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAA;CAAE,GAC7H;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAC/D;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,CAAC;AAE/D,MAAM,MAAM,IAAI,GAAG;IACjB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,yFAAyF;IACzF,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAClD,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,mGAAmG;IACnG,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC;IACnB,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC;IACnB,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IAC9C,gFAAgF;IAChF,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;CACxC,CAAC;AAOF,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,aAAa,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,KAAK,MAAM,GAAG,aAAa,CAqB9F;AAoBD,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAIzG;AA0CD,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,GAAG,SAAS,EAAE,GAAG,UAAgB,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,OAAO,CAGrG"}

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

@@ -0,0 +1,88 @@
+import { Euler, Matrix4, Quaternion, Vector3 } from "three";
+import { dimensionConvertToTypeMesh, vec3, vec3Scale, vec3Zero } from "../../../abstract-3d.js";
+const outlineScale = 1.0125;
+/** Targets are the top-level groups, then the dimensions, then the relations */
+export function compileScene(scene, createGroupId) {
+    const out = { items: [], animations: [] };
+    const center = scene.center_deprecated ?? vec3Zero;
+    const matrix = new Matrix4().makeTranslation(-center.x, -center.y, -center.z).multiply(transform(vec3Zero, scene.rotation_deprecated));
+    const dimensions = scene.dimensions_deprecated?.dimensions ?? [];
+    const relations = scene.relations ?? [];
+    const targets = [
+        ...scene.groups.map((g, root) => ({ kind: "group", id: createGroupId?.(g) ?? "", root, rootData: g.data })),
+        ...dimensions.map((d) => ({ kind: "dimension", id: d.id })),
+        ...relations.map((relation) => ({ kind: "relation", relation })),
+    ];
+    scene.groups.forEach((g, i) => addGroup(out, g, matrix, undefined, "group", i));
+    dimensions.forEach((dimension, i) => {
+        const mesh = dimensionConvertToTypeMesh(dimension, scene.rotation_deprecated ?? vec3Zero, scene.dimensions_deprecated?.material);
+        const base = { style: "dimension", target: scene.groups.length + i, data: undefined, animation: undefined };
+        addMeshes(out, mesh.meshes, matrix.clone().multiply(transform(mesh.pos, mesh.rot)), base);
+    });
+    relations.forEach((relation, i) => relation.groups?.forEach((g) => addGroup(out, g, matrix, undefined, "relation", scene.groups.length + dimensions.length + i)));
+    return { ...out, targets, matrix, roots: scene.groups.map((g) => matrix.clone().multiply(transform(g.pos, g.rot))) };
+}
+function addGroup(out, g, parent, parentAnimation, style, target) {
+    const animation = g.animation ? out.animations.push(createAnimation(g, parent, parentAnimation)) - 1 : parentAnimation;
+    // An animated group's items are relative to it, so its animation can move them
+    const matrix = g.animation ? new Matrix4() : parent.clone().multiply(transform(g.pos, g.rot));
+    addMeshes(out, g.meshes ?? [], matrix, { style, target, data: g.data, animation });
+    g.groups?.forEach((child) => addGroup(out, child, matrix, animation, style, target));
+}
+function addMeshes(out, meshes, matrix, base) {
+    meshes.forEach((mesh) => {
+        out.items.push({ ...base, mesh, role: getRole(mesh), matrix });
+        if (base.style === "relation" && mesh.geometry.type === "Box") {
+            const outline = { ...mesh, geometry: { ...mesh.geometry, size: vec3Scale(mesh.geometry.size, outlineScale) } };
+            out.items.push({ ...base, style: "outline", mesh: outline, role: "solid", matrix });
+        }
+    });
+}
+/** The item's world matrix at `seconds` into its animations, written to `out` */
+export function getItemMatrix(compiled, item, seconds, out) {
+    return item.animation === undefined
+        ? out.copy(item.matrix)
+        : getAnimationMatrix(compiled.animations, item.animation, seconds, out).multiply(item.matrix);
+}
+function getAnimationMatrix(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);
+    out.copy(a.base).multiply(transform(a.pos, rot, scratch));
+    return a.parent === undefined ? out : out.premultiply(getAnimationMatrix(animations, a.parent, seconds, new Matrix4()));
+}
+/** The r3f renderer turned an animated group by its rotation per duration in milliseconds */
+function createAnimation(g, parent, parentAnimation) {
+    const { rot } = g.animation.transform;
+    const perSecond = 1000 / g.animation.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 scratch = new Matrix4();
+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) {
+    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, scale.set(size?.x ?? 1, size?.y ?? 1, size?.z ?? 1));
+}
+//# sourceMappingURL=compile.js.map