human2ai 0.1.3 → 0.1.4

package/dist/domain/spatial/render-inputs.js

@@ -1,6 +1,14 @@
 import { canonicalJson } from "../fingerprint.js";
+const keys = new WeakMap();
 /** Authored names and instructions do not alter spatial geometry or camera output. */
-export function spatialEntityRenderKey({ name: _name, note: _note, ...data }) {
-    return canonicalJson(data);
+export function spatialEntityRenderKey(entity) {
+    const { name: _name, note: _note, ...data } = entity;
+    // A cheap snapshot also detects in-place edits; reference identity alone is unsafe.
+    const raw = JSON.stringify(data), previous = keys.get(entity);
+    if (previous?.raw === raw)
+        return previous.key;
+    const key = canonicalJson(data);
+    keys.set(entity, { raw, key });
+    return key;
 }
 //# sourceMappingURL=render-inputs.js.map

package/dist/domain/spatial/render-inputs.js.map

@@ -1 +1 @@
-{"version":3,"file":"render-inputs.js","sourceRoot":"","sources":["../../../src/domain/spatial/render-inputs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,sFAAsF;AACtF,MAAM,UAAU,sBAAsB,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,EAAoC;IAC5G,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC"}
+{"version":3,"file":"render-inputs.js","sourceRoot":"","sources":["../../../src/domain/spatial/render-inputs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,MAAM,IAAI,GAAG,IAAI,OAAO,EAAkE,CAAC;AAE3F,sFAAsF;AACtF,MAAM,UAAU,sBAAsB,CAAC,MAAwC;IAC7E,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;IACrD,oFAAoF;IACpF,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9D,IAAI,QAAQ,EAAE,GAAG,KAAK,GAAG;QAAE,OAAO,QAAQ,CAAC,GAAG,CAAC;IAC/C,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;IAC/B,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/domain/spatial/scene-cache.d.ts

@@ -1,15 +1,27 @@
-import { Group } from "three";
+import { Color, Group, Mesh } from "three";
 import type { SpatialDraft } from "./types.ts";
+interface SceneCacheOptions {
+    shade?(draft: SpatialDraft): Promise<Float32Array[]>;
+    onShaded?(): void;
+}
 /** Editor-owned meshes; deterministic exports continue to use createSpatialScene. */
 export declare class SpatialSceneCache {
+    private options;
     readonly scene: Group<import("three").Object3DEventMap>;
     private entries;
+    readonly baseColors: WeakMap<Mesh<import("three").BufferGeometry<import("three").NormalBufferAttributes, import("three").BufferGeometryEventMap>, import("three").Material<import("three").MaterialEventMap> | import("three").Material<import("three").MaterialEventMap>[], import("three").Object3DEventMap>, Color>;
     private shadedKey?;
     private shadedTopology?;
     private colors?;
+    private desired?;
+    private shading;
+    private disposed;
+    constructor(options?: SceneCacheOptions);
     update(draft: SpatialDraft, options?: {
         showRig?: boolean;
         dragging?: boolean;
     }): boolean;
+    private scheduleShading;
     dispose(): void;
 }
+export {};

package/dist/domain/spatial/scene-cache.js

@@ -1,14 +1,24 @@
 import { Group } from "three";
-import { createSpatialScene, disposeSpatialScene } from "./scene.js";
+import { createSpatialScene, disposeSpatialScene, updateSpatialRig } from "./scene.js";
 import { applySpatialContactShading, spatialSurfaces } from "./lighting.js";
 import { spatialEntityRenderKey } from "./render-inputs.js";
+import { entityMatrix, rememberSpatialColors, updateSpatialGeometry } from "./scene-update.js";
+import { updateCharacterModel } from "./model.js";
 /** Editor-owned meshes; deterministic exports continue to use createSpatialScene. */
 export class SpatialSceneCache {
+    options;
     scene = new Group();
     entries = new Map();
+    baseColors = new WeakMap();
     shadedKey;
     shadedTopology;
     colors;
+    desired;
+    shading = false;
+    disposed = false;
+    constructor(options = {}) {
+        this.options = options;
+    }
     update(draft, options = {}) {
         const next = new Map();
         let changed = false;
@@ -16,14 +26,49 @@ export class SpatialSceneCache {
             const key = JSON.stringify([spatialEntityRenderKey(entity), Boolean(options.showRig)]);
             let entry = this.entries.get(entity.id);
             if (entry?.key !== key) {
-                if (entry) {
-                    this.scene.remove(entry.group);
-                    disposeSpatialScene(entry.group);
+                const shapeKey = JSON.stringify([spatialEntityRenderKey({ ...entity, position: [0, 0, 0], rotation: [0, 0, 0] }), Boolean(options.showRig)]);
+                if (entry?.shapeKey === shapeKey) {
+                    entry.group.matrixAutoUpdate = false;
+                    entry.group.matrix.copy(entityMatrix(entity).multiply(entry.origin));
+                    entry.group.matrixWorldNeedsUpdate = true;
+                    entry.key = key;
+                }
+                else {
+                    const part = "bones" in entity
+                        ? { ...draft, characters: [entity], objects: [] }
+                        : { ...draft, characters: [], objects: [entity] };
+                    const rig = entry?.group.children.filter(object => object.userData.rig) ?? [];
+                    if (rig.length)
+                        entry.group.remove(...rig);
+                    const model = entry?.group.children[0];
+                    if (entry && "bones" in entity && model instanceof Group && updateCharacterModel(model, entity)) {
+                        entry.group.matrixAutoUpdate = true;
+                        entry.group.matrix.identity();
+                        entry = { key, shapeKey, group: entry.group, origin: entityMatrix(entity).invert() };
+                    }
+                    else {
+                        const fresh = createSpatialScene(part);
+                        if (entry && updateSpatialGeometry(entry.group, fresh)) {
+                            disposeSpatialScene(fresh);
+                            entry = { key, shapeKey, group: entry.group, origin: entityMatrix(entity).invert() };
+                        }
+                        else {
+                            if (entry) {
+                                this.scene.remove(entry.group);
+                                disposeSpatialScene(entry.group);
+                            }
+                            entry = { key, shapeKey, group: fresh, origin: entityMatrix(entity).invert() };
+                        }
+                    }
+                    if ("bones" in entity && options.showRig && entity.appearance !== "geometric") {
+                        if (rig.length)
+                            entry.group.add(...rig);
+                        updateSpatialRig(entry.group, entity, true);
+                    }
+                    else if (rig.length)
+                        disposeSpatialScene(new Group().add(...rig));
+                    rememberSpatialColors(entry.group, this.baseColors);
                 }
-                const part = "bones" in entity
-                    ? { ...draft, characters: [entity], objects: [] }
-                    : { ...draft, characters: [], objects: [entity] };
-                entry = { key, group: createSpatialScene(part, options) };
                 changed = true;
             }
             next.set(entity.id, entry);
@@ -45,10 +90,22 @@ export class SpatialSceneCache {
         if (changed)
             this.scene.updateMatrixWorld(true);
         // Cameras, selection, helpers and light switches do not affect contact rays.
-        const surfaceKey = JSON.stringify([draft.characters.map(spatialEntityRenderKey), draft.objects.map(spatialEntityRenderKey)]);
+        const surfaceKey = JSON.stringify([...next.values()].map(entry => entry.key));
         const meshes = spatialSurfaces(this.scene);
         const topology = meshes.map(mesh => JSON.stringify([mesh.userData, mesh.geometry.getAttribute("position").count])).join("/");
-        if (!this.colors || topology !== this.shadedTopology || (!options.dragging && surfaceKey !== this.shadedKey)) {
+        const needsShading = !this.colors || topology !== this.shadedTopology || surfaceKey !== this.shadedKey;
+        this.desired = !options.dragging && needsShading ? { draft, key: surfaceKey, topology } : undefined;
+        if (this.options.shade) {
+            if (!this.colors || topology !== this.shadedTopology) {
+                this.colors = meshes.map(mesh => new Float32Array(mesh.geometry.getAttribute("position").count * 3).fill(1));
+                this.shadedTopology = topology;
+                this.shadedKey = undefined;
+            }
+            if (changed)
+                applySpatialContactShading(this.scene, draft, this.colors);
+            this.scheduleShading();
+        }
+        else if (!this.colors || topology !== this.shadedTopology || (!options.dragging && needsShading)) {
             this.colors = applySpatialContactShading(this.scene, draft);
             this.shadedKey = surfaceKey;
             this.shadedTopology = topology;
@@ -58,7 +115,28 @@ export class SpatialSceneCache {
         }
         return changed;
     }
+    scheduleShading() {
+        if (this.shading || !this.desired || this.disposed)
+            return;
+        const request = this.desired;
+        this.shading = true;
+        void this.options.shade(request.draft).then(colors => {
+            if (this.disposed || this.desired?.key !== request.key || this.desired.topology !== request.topology)
+                return;
+            this.colors = applySpatialContactShading(this.scene, request.draft, colors);
+            this.shadedKey = request.key;
+            this.shadedTopology = request.topology;
+            this.desired = undefined;
+            this.options.onShaded?.();
+        }).catch(() => {
+            // Keep the last valid colors; a subsequent scene change can retry the worker.
+            if (this.desired?.key === request.key)
+                this.desired = undefined;
+        }).finally(() => { this.shading = false; this.scheduleShading(); });
+    }
     dispose() {
+        this.disposed = true;
+        this.desired = undefined;
         disposeSpatialScene(this.scene);
         this.scene.clear();
         this.entries.clear();

package/dist/domain/spatial/scene-cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"scene-cache.js","sourceRoot":"","sources":["../../../src/domain/spatial/scene-cache.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"scene-cache.js","sourceRoot":"","sources":["../../../src/domain/spatial/scene-cache.ts"],"names":[],"mappings":"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"}

package/dist/domain/spatial/scene-update.d.ts

@@ -0,0 +1,6 @@
+import { Color, Group, Matrix4, Mesh } from "three";
+import type { SpatialCharacter, SpatialObject } from "./types.ts";
+export declare const entityMatrix: (entity: SpatialCharacter | SpatialObject) => Matrix4;
+/** Preserve GPU buffers and picking identity when authored topology stays the same. */
+export declare function updateSpatialGeometry(target: Group, source: Group): boolean;
+export declare function rememberSpatialColors(group: Group, colors: WeakMap<Mesh, Color>): void;

package/dist/domain/spatial/scene-update.js

@@ -0,0 +1,52 @@
+import { LineSegments, Matrix4, Mesh, MeshLambertMaterial, Vector3 } from "three";
+import { quaternion, vector } from "./kinematics.js";
+export const entityMatrix = (entity) => new Matrix4().compose(vector(entity.position), quaternion(entity.rotation), new Vector3(1, 1, 1));
+const drawable = (object) => object instanceof Mesh || object instanceof LineSegments;
+/** Preserve GPU buffers and picking identity when authored topology stays the same. */
+export function updateSpatialGeometry(target, source) {
+    const before = [], after = [];
+    target.traverse(object => before.push(object));
+    source.traverse(object => after.push(object));
+    if (before.length !== after.length || before.some((object, i) => {
+        const next = after[i];
+        if (object.type !== next.type || JSON.stringify(object.userData) !== JSON.stringify(next.userData))
+            return true;
+        if (!drawable(object) || !drawable(next))
+            return false;
+        return object.geometry.getAttribute("position").count !== next.geometry.getAttribute("position").count
+            || object.geometry.index?.count !== next.geometry.index?.count
+            || Object.entries(next.geometry.attributes).some(([name, attribute]) => object.geometry.getAttribute(name)?.array.length !== attribute.array.length);
+    }))
+        return false;
+    before.forEach((object, i) => {
+        const next = after[i];
+        object.position.copy(next.position);
+        object.quaternion.copy(next.quaternion);
+        object.scale.copy(next.scale);
+        object.matrixAutoUpdate = next.matrixAutoUpdate;
+        object.matrix.copy(next.matrix);
+        if (!drawable(object) || !drawable(next))
+            return;
+        for (const [name, attribute] of Object.entries(next.geometry.attributes)) {
+            const previous = object.geometry.getAttribute(name);
+            previous.array.set(attribute.array);
+            previous.needsUpdate = true;
+        }
+        if (object.geometry.index && next.geometry.index) {
+            object.geometry.index.array.set(next.geometry.index.array);
+            object.geometry.index.needsUpdate = true;
+        }
+        object.geometry.boundingBox = null;
+        object.geometry.boundingSphere = null;
+        if (!Array.isArray(object.material) && !Array.isArray(next.material))
+            object.material.copy(next.material);
+    });
+    return true;
+}
+export function rememberSpatialColors(group, colors) {
+    group.traverse(object => {
+        if (object instanceof Mesh && object.material instanceof MeshLambertMaterial)
+            colors.set(object, object.material.color.clone());
+    });
+}
+//# sourceMappingURL=scene-update.js.map

package/dist/domain/spatial/scene-update.js.map

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

package/dist/domain/spatial/scene.d.ts

@@ -1,8 +1,10 @@
 import { Group, OrthographicCamera, PerspectiveCamera } from "three";
-import type { SpatialCamera, SpatialDraft } from "./types.ts";
+import type { SpatialCamera, SpatialCharacter, SpatialDraft } from "./types.ts";
 export declare function createOutputCamera(source: SpatialCamera): OrthographicCamera | PerspectiveCamera;
 export declare function createSpatialScene(draft: SpatialDraft, options?: {
     showRig?: boolean;
     handCreases?: boolean;
 }): Group;
+/** Unit helper geometry survives pose/proportion changes; only transforms change. */
+export declare function updateSpatialRig(scene: Group, actor: SpatialCharacter, batch?: boolean): void;
 export declare function disposeSpatialScene(scene: Group): void;

package/dist/domain/spatial/scene.js

@@ -1,4 +1,4 @@
-import { BoxGeometry, Color, CylinderGeometry, DoubleSide, Group, Mesh, MeshLambertMaterial, LineSegments, OrthographicCamera, PerspectiveCamera, Quaternion, SphereGeometry, Vector3, } from "three";
+import { BoxGeometry, Color, CylinderGeometry, DoubleSide, Group, InstancedMesh, Matrix4, Mesh, MeshLambertMaterial, LineSegments, OrthographicCamera, PerspectiveCamera, Quaternion, SphereGeometry, Vector3, } from "three";
 import { createCharacterModel } from "./model.js";
 import { jointWorldTransforms, quaternion, vector } from "./kinematics.js";
 import { fingerPart } from "./hands.js";
@@ -27,25 +27,7 @@ export function createSpatialScene(draft, options = {}) {
         scene.add(createCharacterModel(actor, options));
         if (!options.showRig || actor.appearance === "geometric")
             continue;
-        const world = jointWorldTransforms(actor);
-        const overlay = (mesh) => {
-            mesh.material.depthTest = false;
-            mesh.renderOrder = 2;
-        };
-        for (const joint of actor.joints.filter(j => !j.terminal || Boolean(fingerPart(actor.bones.find(b => b.endJointId === j.id)?.modelPart ?? "")))) {
-            overlay(add(new SphereGeometry(joint.radius, 12, 8), "#e6a65c", world[joint.id].position, world[joint.id].rotation, { characterId: actor.id, jointId: joint.id, rig: "joint" }));
-        }
-        for (const bone of actor.bones) {
-            const finger = fingerPart(bone.modelPart);
-            if (finger?.segment === 0)
-                continue;
-            const start = world[bone.startJointId].position, end = world[bone.endJointId].position;
-            const direction = end.clone().sub(start), length = direction.length();
-            const data = { characterId: actor.id, boneId: bone.id, rig: "bone" };
-            const radius = actor.height * (finger ? .0018 : .009);
-            const mesh = add(new CylinderGeometry(radius, radius, length, 10), "#728aa1", start.clone().add(end).multiplyScalar(.5), new Quaternion().setFromUnitVectors(new Vector3(0, 1, 0), direction.normalize()), data);
-            overlay(mesh);
-        }
+        updateSpatialRig(scene, actor);
     }
     for (const object of draft.objects) {
         const size = vector(object.size);
@@ -57,9 +39,85 @@ export function createSpatialScene(draft, options = {}) {
     scene.updateMatrixWorld(true);
     return scene;
 }
+/** Unit helper geometry survives pose/proportion changes; only transforms change. */
+export function updateSpatialRig(scene, actor, batch = false) {
+    const parts = spatialRigParts(actor);
+    if (batch) {
+        const matrix = new Matrix4();
+        for (const rig of ["joint", "bone"]) {
+            const instances = parts.filter(part => part.data.rig === rig);
+            let mesh = scene.children.find(object => object instanceof InstancedMesh && object.userData.characterId === actor.id && object.userData.rig === rig);
+            if (mesh && mesh.count !== instances.length) {
+                scene.remove(mesh);
+                disposeSpatialScene(new Group().add(mesh));
+                mesh = undefined;
+            }
+            if (!mesh) {
+                mesh = new InstancedMesh(rigGeometry(rig), new MeshLambertMaterial({ side: DoubleSide, depthTest: false }), instances.length);
+                mesh.renderOrder = 2;
+                scene.add(mesh);
+            }
+            mesh.userData = { characterId: actor.id, rig, instances: instances.map(part => part.data) };
+            const color = new Color(rig === "joint" ? "#e6a65c" : "#728aa1");
+            instances.forEach((part, i) => {
+                mesh.setMatrixAt(i, matrix.compose(part.position, part.rotation, part.scale));
+                mesh.setColorAt(i, color);
+            });
+            mesh.instanceMatrix.needsUpdate = true;
+            if (mesh.instanceColor)
+                mesh.instanceColor.needsUpdate = true;
+            mesh.computeBoundingSphere();
+        }
+        return;
+    }
+    const existing = new Map(scene.children.filter(object => object.userData.rig && object.userData.characterId === actor.id)
+        .map(object => [`${object.userData.rig}/${object.userData.jointId ?? object.userData.boneId}`, object]));
+    const add = (rig, id) => {
+        const key = `${rig}/${id}`;
+        let mesh = existing.get(key);
+        existing.delete(key);
+        if (!mesh) {
+            mesh = new Mesh(rigGeometry(rig), new MeshLambertMaterial({ side: DoubleSide, depthTest: false }));
+            mesh.userData = { characterId: actor.id, rig, [rig === "joint" ? "jointId" : "boneId"]: id };
+            mesh.renderOrder = 2;
+            scene.add(mesh);
+        }
+        mesh.material.color.set(rig === "joint" ? "#e6a65c" : "#728aa1");
+        return mesh;
+    };
+    for (const part of parts) {
+        const mesh = add(part.data.rig, part.data.jointId ?? part.data.boneId);
+        mesh.position.copy(part.position);
+        mesh.quaternion.copy(part.rotation);
+        mesh.scale.copy(part.scale);
+    }
+    for (const mesh of existing.values()) {
+        scene.remove(mesh);
+        mesh.geometry.dispose();
+        mesh.material.dispose();
+    }
+}
+const rigGeometry = (rig) => rig === "joint" ? new SphereGeometry(1, 12, 8) : new CylinderGeometry(1, 1, 1, 10);
+function spatialRigParts(actor) {
+    const world = jointWorldTransforms(actor), parts = [];
+    for (const joint of actor.joints.filter(j => !j.terminal || Boolean(fingerPart(actor.bones.find(b => b.endJointId === j.id)?.modelPart ?? "")))) {
+        parts.push({ data: { characterId: actor.id, rig: "joint", jointId: joint.id }, position: world[joint.id].position, rotation: world[joint.id].rotation, scale: new Vector3().setScalar(joint.radius) });
+    }
+    for (const bone of actor.bones) {
+        const finger = fingerPart(bone.modelPart);
+        if (finger?.segment === 0)
+            continue;
+        const start = world[bone.startJointId].position, end = world[bone.endJointId].position;
+        const direction = end.clone().sub(start), length = direction.length(), radius = actor.height * (finger ? .0018 : .009);
+        parts.push({ data: { characterId: actor.id, rig: "bone", boneId: bone.id }, position: start.clone().add(end).multiplyScalar(.5), rotation: new Quaternion().setFromUnitVectors(new Vector3(0, 1, 0), direction.normalize()), scale: new Vector3(radius, length, radius) });
+    }
+    return parts;
+}
 export function disposeSpatialScene(scene) {
     scene.traverse(object => {
         if (object instanceof Mesh || object instanceof LineSegments) {
+            if (object instanceof InstancedMesh)
+                object.dispose();
             object.geometry.dispose();
             for (const material of Array.isArray(object.material) ? object.material : [object.material])
                 material.dispose();

package/dist/domain/spatial/scene.js.map

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

package/dist/domain/style/model-input.d.ts

@@ -0,0 +1,3 @@
+export declare const MAX_STYLE_MODEL_BYTES: number;
+/** Accept a self-contained, static GLB example, never executable generator code. */
+export declare function validStyleModel(data: Buffer): boolean;

package/dist/domain/style/model-input.js

@@ -0,0 +1,36 @@
+export const MAX_STYLE_MODEL_BYTES = 10 * 1024 * 1024;
+/** Accept a self-contained, static GLB example, never executable generator code. */
+export function validStyleModel(data) {
+    if (!Buffer.isBuffer(data) || data.length < 28 || data.length > MAX_STYLE_MODEL_BYTES)
+        return false;
+    if (data.readUInt32LE(0) !== 0x46546c67 || data.readUInt32LE(4) !== 2 || data.readUInt32LE(8) !== data.length)
+        return false;
+    const jsonLength = data.readUInt32LE(12);
+    if (jsonLength % 4 || 20 + jsonLength > data.length || data.readUInt32LE(16) !== 0x4e4f534a)
+        return false;
+    try {
+        const document = JSON.parse(data.subarray(20, 20 + jsonLength).toString("utf8"));
+        if (document.asset?.version !== "2.0" || !document.scenes?.length || !document.nodes?.length || !document.meshes?.length)
+            return false;
+        // Textures and geometry must live in this file, with no decoder dependencies.
+        if (document.extensionsRequired?.some((name) => ["KHR_draco_mesh_compression", "EXT_meshopt_compression", "KHR_texture_basisu"].includes(name)))
+            return false;
+        if (JSON.stringify(document).includes('"uri":'))
+            return false;
+        const binaryOffset = 20 + jsonLength;
+        if (binaryOffset + 8 > data.length || data.readUInt32LE(binaryOffset + 4) !== 0x004e4942)
+            return false;
+        const binaryLength = data.readUInt32LE(binaryOffset);
+        if (binaryLength % 4 || binaryOffset + 8 + binaryLength !== data.length)
+            return false;
+        if (document.buffers?.length !== 1 || !Number.isInteger(document.buffers[0].byteLength) || document.buffers[0].byteLength <= 0 || document.buffers[0].byteLength > binaryLength)
+            return false;
+        return Array.isArray(document.bufferViews) && document.bufferViews.every((view) => (view.buffer === 0 && Number.isInteger(view.byteOffset ?? 0) && (view.byteOffset ?? 0) >= 0
+            && Number.isInteger(view.byteLength) && view.byteLength > 0
+            && (view.byteOffset ?? 0) + view.byteLength <= document.buffers[0].byteLength));
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=model-input.js.map

package/dist/domain/style/model-input.js.map

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

package/dist/domain/style/types.d.ts

@@ -22,10 +22,17 @@ export interface StyleEntry {
     description: string;
     promptSummary: string;
     referenceImages: StyleReferenceImage[];
+    previewModel?: StylePreviewModel;
     revision: number;
     createdAt: string;
     updatedAt: string;
 }
+export interface StylePreviewModel {
+    id: string;
+    originalFilename: string;
+    byteSize: number;
+    createdAt: string;
+}
 export interface SessionStyleState {
     session: Session;
     style: StyleEntry | null;

package/dist/server/routes/spatial-sessions.js

@@ -1,6 +1,8 @@
 import schema from "../../../schemas/spatial-draft.schema.json" with { type: "json" };
 import { createSpatialDraft, SpatialConstraintError } from "../../domain/spatial/index.js";
-import { renderSpatialPng, renderSpatialCameraBoxPng } from "../spatial-render.js";
+import { SpatialRenderService } from "../spatial-render-service.js";
+import { SpatialCameraRenderKeys } from "../../domain/spatial/camera-render-key.js";
+import { cameraBoxView } from "../../domain/spatial/camera-box.js";
 import { SPATIAL_BOX_FACES, SPATIAL_RENDER_PASSES } from "../../domain/spatial/types.js";
 import { parseSpatialBoxViews } from "../../domain/spatial/camera-box-sheet.js";
 import en from "../../../locales/en/common.json" with { type: "json" };
@@ -10,15 +12,25 @@ export function registerSpatialSessionRoutes(server, repository) {
     server.addSchema(fastifySchema);
     registerDraftVersionRoutes(server, { routePrefix: "/api/v1/sessions/:sessionId/spatial", draftSchema: { $ref: schema.$id }, repository });
     const cache = new Map();
+    const inFlight = new Map();
+    const renderer = new SpatialRenderService(), renderKeys = new SpatialCameraRenderKeys();
+    server.addHook("onClose", () => renderer.close());
     const cached = (key, render) => {
-        let pending = cache.get(key);
+        const image = cache.get(key);
+        if (image) {
+            cache.delete(key);
+            cache.set(key, image);
+            return Promise.resolve(image);
+        }
+        let pending = inFlight.get(key);
         if (!pending) {
-            pending = render();
-            cache.set(key, pending);
-            if (cache.size > 24)
-                cache.delete(cache.keys().next().value);
-            void pending.catch(() => { if (cache.get(key) === pending)
-                cache.delete(key); });
+            pending = render().then(image => {
+                cache.set(key, image);
+                if (cache.size > 24)
+                    cache.delete(cache.keys().next().value);
+                return image;
+            }).finally(() => { inFlight.delete(key); });
+            inFlight.set(key, pending);
         }
         return pending;
     };
@@ -46,8 +58,8 @@ export function registerSpatialSessionRoutes(server, repository) {
             if (!camera)
                 return reply.code(404).send({ code: "SPATIAL_CAMERA_NOT_FOUND", message: "Camera not found" });
             const pass = request.query.pass ?? "color";
-            const key = JSON.stringify([sessionId, version?.revision ?? 0, cameraId, pass]);
-            const pending = cached(key, () => renderSpatialPng(draft, camera, pass));
+            const key = JSON.stringify([sessionId, cameraId, renderKeys.key(draft, camera, pass)]);
+            const pending = cached(key, () => renderer.render({ draft, camera, pass }));
             return reply.header("cache-control", request.query.revision ? "private, max-age=31536000, immutable" : "no-cache")
                 .header("x-spatial-revision", version?.revision ?? 0).header("x-spatial-render-pass", pass).type("image/png").send(await pending);
         }
@@ -71,8 +83,12 @@ export function registerSpatialSessionRoutes(server, repository) {
             if (!box || !version)
                 return reply.code(404).send({ code: "SPATIAL_CAMERA_NOT_FOUND", message: "Camera box not found" });
             const pass = request.query.pass ?? "color", view = views ?? request.query.view ?? "sheet";
-            const key = JSON.stringify([sessionId, version.revision, "camera-box", boxId, view, pass]);
-            const png = cached(key, () => renderSpatialCameraBoxPng(version.draft, box, view, pass));
+            const faces = typeof view === "string" ? view === "sheet" ? SPATIAL_BOX_FACES : [view] : view;
+            const key = JSON.stringify([sessionId, "camera-box", boxId, view, faces.map(face => {
+                    const { source, camera } = cameraBoxView(box, face);
+                    return renderKeys.key(version.draft, source, pass, camera);
+                })]);
+            const png = cached(key, () => renderer.render({ draft: version.draft, box, view, pass }));
             return reply.header("cache-control", request.query.revision ? "private, max-age=31536000, immutable" : "no-cache")
                 .header("x-spatial-revision", version.revision).header("x-spatial-render-pass", pass).header("x-spatial-box-view", typeof view === "string" ? view : "sheet")
                 .header("x-spatial-box-views", views?.join(",") ?? (view === "sheet" ? SPATIAL_BOX_FACES.join(",") : view)).type("image/png").send(await png);