human2ai 0.1.0

package/dist/domain/spatial/camera-box.d.ts

@@ -0,0 +1,13 @@
+import { OrthographicCamera } from "three";
+import { type SpatialBoxFace, type SpatialBoxView, type SpatialCamera, type SpatialCameraBox, type SpatialDraft } from "./types.ts";
+export declare function createSpatialCameraBox(id: string, name: string): SpatialCameraBox;
+export declare function cameraBoxImageSize(box: SpatialCameraBox, view: SpatialBoxView): {
+    width: number;
+    height: number;
+};
+export declare function cameraBoxView(box: SpatialCameraBox, face: SpatialBoxFace): {
+    source: SpatialCamera;
+    camera: OrthographicCamera;
+};
+/** Fit real posed mesh vertices in the box's own axes, including custom creature hands. */
+export declare function fitSpatialCameraBox(box: SpatialCameraBox, draft: SpatialDraft, region: "scene" | "hands"): SpatialCameraBox;

package/dist/domain/spatial/camera-box.js

@@ -0,0 +1,52 @@
+import { Box3, Mesh, OrthographicCamera, Vector3 } from "three";
+import { quaternion, vector } from "./kinematics.js";
+import { fingerPart } from "./hands.js";
+import { createSpatialScene, disposeSpatialScene } from "./scene.js";
+import { SPATIAL_BOX_GAP, SPATIAL_BOX_LABEL_HEIGHT } from "./types.js";
+// All directions are box-local. Top and bottom have explicit, non-degenerate up axes.
+const axes = {
+    front: { normal: [0, 0, 1], up: [0, 1, 0] }, back: { normal: [0, 0, -1], up: [0, 1, 0] },
+    left: { normal: [-1, 0, 0], up: [0, 1, 0] }, right: { normal: [1, 0, 0], up: [0, 1, 0] },
+    top: { normal: [0, 1, 0], up: [0, 0, -1] }, bottom: { normal: [0, -1, 0], up: [0, 0, 1] },
+};
+export function createSpatialCameraBox(id, name) {
+    return { id, name, position: [0, .9, 0], rotation: [0, 0, 0], size: 2.4, resolution: 512 };
+}
+export function cameraBoxImageSize(box, view) {
+    return view === "sheet" ? { width: box.resolution * 3 + SPATIAL_BOX_GAP * 2, height: (box.resolution + SPATIAL_BOX_LABEL_HEIGHT) * 2 + SPATIAL_BOX_GAP } : { width: box.resolution, height: box.resolution };
+}
+export function cameraBoxView(box, face) {
+    const rotation = quaternion(box.rotation), half = box.size / 2;
+    const position = vector(axes[face].normal).applyQuaternion(rotation).multiplyScalar(half).add(vector(box.position));
+    const camera = new OrthographicCamera(-half, half, half, -half, 0, box.size);
+    camera.position.copy(position);
+    camera.up.copy(vector(axes[face].up).applyQuaternion(rotation));
+    camera.lookAt(vector(box.position));
+    camera.updateMatrixWorld();
+    const source = { id: `${box.id}-${face}`, name: box.name, position: position.toArray(), target: [...box.position], projection: "orthographic", fov: 40, span: box.size, width: box.resolution, height: box.resolution, background: null };
+    return { source, camera };
+}
+/** Fit real posed mesh vertices in the box's own axes, including custom creature hands. */
+export function fitSpatialCameraBox(box, draft, region) {
+    const scene = createSpatialScene(draft), bounds = new Box3(), inverse = quaternion(box.rotation).invert(), point = new Vector3();
+    try {
+        scene.traverse(object => {
+            if (!(object instanceof Mesh))
+                return;
+            const part = String(object.userData.modelPart ?? "");
+            if (region === "hands" && !part.endsWith("-hand") && !fingerPart(part))
+                return;
+            const vertices = object.geometry.getAttribute("position");
+            for (let i = 0; i < vertices.count; i++)
+                bounds.expandByPoint(point.fromBufferAttribute(vertices, i).applyMatrix4(object.matrixWorld).applyQuaternion(inverse));
+        });
+    }
+    finally {
+        disposeSpatialScene(scene);
+    }
+    if (bounds.isEmpty())
+        return box;
+    const size = bounds.getSize(new Vector3());
+    return { ...box, position: bounds.getCenter(new Vector3()).applyQuaternion(quaternion(box.rotation)).toArray(), size: Math.max(.05, Math.max(size.x, size.y, size.z) * 1.15) };
+}
+//# sourceMappingURL=camera-box.js.map

package/dist/domain/spatial/camera-box.js.map

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

package/dist/domain/spatial/geometric-model.d.ts

@@ -0,0 +1,4 @@
+import { Group } from "three";
+import type { SpatialCharacter } from "./types.ts";
+/** Rigid primitives share the authored rig with the anatomical surface. */
+export declare function createGeometricCharacterModel(actor: SpatialCharacter): Group;

package/dist/domain/spatial/geometric-model.js

@@ -0,0 +1,101 @@
+import { Box3, BoxGeometry, Color, CylinderGeometry, Group, Matrix4, Mesh, MeshLambertMaterial, Quaternion, SphereGeometry, Vector3 } from "three";
+import { fingerPart, handRestMatrix, handRig } from "./hands.js";
+import { jointWorldTransforms, proportionedJointOffset, vector } from "./kinematics.js";
+import { footHeightScale, partWidth, spatialShape } from "./proportions.js";
+// Match anatomical digits across both hands and cloned limbs.
+const fingerColors = {
+    thumb: "#e49a45", index: "#499dd6", middle: "#45ad86", ring: "#a47bd4", little: "#dd6f8f",
+};
+/** Rigid primitives share the authored rig with the anatomical surface. */
+export function createGeometricCharacterModel(actor) {
+    const group = new Group(), world = jointWorldTransforms(actor), shape = spatialShape(actor.headRatio);
+    const up = new Vector3(0, 1, 0), bodyColor = new Color(actor.color);
+    const bodyLuminance = .2126 * bodyColor.r + .7152 * bodyColor.g + .0722 * bodyColor.b;
+    const jointColor = bodyColor.clone().lerp(new Color(bodyLuminance > .25 ? "#26384b" : "#dce5ef"), .75);
+    const radii = new Map(actor.bones.map(bone => {
+        const part = bone.modelPart, finger = fingerPart(part);
+        const factor = ["spine", "chest"].includes(part) ? .035 : part === "neck" ? .014
+            : /-(shoulder|hip)$/.test(part) ? .012 : part.endsWith("-wrist") ? .014
+                : part.endsWith("-elbow") ? .016 : part.endsWith("-knee") ? .022 : .019;
+        const radius = finger ? actor.height * .0033 * shape.hand * (actor.palmSize ?? 1) * (finger.finger === "little" ? .8 : 1)
+            : actor.height * factor * partWidth(shape, part);
+        const length = world[bone.startJointId].position.distanceTo(world[bone.endJointId].position);
+        return [bone.id, finger && finger.segment > 0 ? Math.min(radius, length * .35) : radius];
+    }));
+    const add = (geometry, position, rotation, data, color = bodyColor) => {
+        const mesh = new Mesh(geometry, new MeshLambertMaterial({ color }));
+        mesh.position.copy(position);
+        mesh.quaternion.copy(rotation);
+        mesh.userData = { characterId: actor.id, ...data };
+        group.add(mesh);
+        return mesh;
+    };
+    for (const bone of actor.bones) {
+        const start = world[bone.startJointId].position, end = world[bone.endJointId].position;
+        const offset = proportionedJointOffset(actor, actor.joints.find(j => j.id === bone.endJointId));
+        const rotation = world[bone.endJointId].rotation;
+        const direction = end.clone().sub(start), length = direction.length();
+        const center = start.clone().add(end).multiplyScalar(.5);
+        const aligned = rotation.clone().multiply(new Quaternion().setFromUnitVectors(up, offset.clone().normalize()));
+        const data = { boneId: bone.id, modelPart: bone.modelPart };
+        if (bone.modelPart === "head") {
+            const rx = length * .36, ry = length * .5, rz = length * .31 * shape.headDepth;
+            add(new SphereGeometry(1, 24, 16).scale(rx, ry, rz), center, aligned, data);
+            for (const side of [-1, 1]) {
+                const eye = new Vector3(side * rx * .34, ry * .12, rz * .94).applyQuaternion(aligned).add(center);
+                add(new SphereGeometry(1, 12, 8).scale(rx * .105, ry * .095, rz * .065), eye, aligned, { ...data, feature: "eye" }, new Color("#23313c"));
+            }
+        }
+        else if (bone.modelPart.endsWith("-hand")) {
+            // Fit a rigid palm to the wrist and fixed knuckles. Its frame follows
+            // wrist rotation, including twist; curled fingers cannot resize it.
+            const normal = new Vector3(0, 1, 0).transformDirection(handRestMatrix(actor, bone)).applyQuaternion(rotation);
+            const y = direction.clone().normalize(), x = y.clone().cross(normal).normalize(), z = x.clone().cross(y).normalize();
+            const frame = new Quaternion().setFromRotationMatrix(new Matrix4().makeBasis(x, y, z));
+            const inverse = frame.clone().invert(), bounds = new Box3().expandByPoint(new Vector3()).expandByPoint(direction.clone().applyQuaternion(inverse));
+            for (const root of actor.bones.filter(b => b.startJointId === bone.endJointId && fingerPart(b.modelPart)?.segment === 0 && fingerPart(b.modelPart)?.finger !== "thumb")) {
+                bounds.expandByPoint(world[root.endJointId].position.clone().sub(start).applyQuaternion(inverse));
+            }
+            const thickness = actor.height * .018 * shape.hand * (actor.palmSize ?? 1);
+            bounds.min.x -= thickness * .2;
+            bounds.max.x += thickness * .2;
+            bounds.min.y -= thickness * .25;
+            const size = bounds.getSize(new Vector3());
+            size.z = Math.max(size.z, thickness);
+            const palmCenter = bounds.getCenter(new Vector3()).applyQuaternion(frame).add(start);
+            add(new BoxGeometry(size.x, size.y, size.z), palmCenter, frame, data);
+        }
+        else if (bone.modelPart.endsWith("-foot")) {
+            // Use the same anatomical sole height as ankle lifting. The box remains
+            // flat in the rest pose and rotates as a whole about the ankle.
+            const rig = handRig(actor), source = rig.parts.find(p => p.id === bone.modelPart);
+            const base = vector(actor.joints.find(j => j.id === bone.endJointId).offset).length() / vector(source.end).sub(vector(source.start)).length();
+            const sole = (source.start[1] - rig.bottom) * base * footHeightScale(actor.footSize);
+            const width = actor.height * .055 * shape.foot * (actor.footSize ?? 1), heel = width * .45;
+            const top = actor.height * .006 * footHeightScale(actor.footSize);
+            const footCenter = new Vector3(offset.x / 2, (top - sole) / 2, (offset.z - heel) / 2).applyQuaternion(rotation).add(start);
+            add(new BoxGeometry(width, sole + top, Math.abs(offset.z) + heel), footCenter, rotation, data);
+        }
+        else {
+            const radius = radii.get(bone.id);
+            const finger = fingerPart(bone.modelPart);
+            add(new CylinderGeometry(radius, radius, length, 12), center, new Quaternion().setFromUnitVectors(up, direction.normalize()), data, finger ? new Color(fingerColors[finger.finger]) : bodyColor);
+        }
+    }
+    for (const joint of actor.joints) {
+        const incoming = actor.bones.find(b => b.endJointId === joint.id), part = incoming?.modelPart ?? "pelvis";
+        // Head-top and toe landmarks are inside their solid forms, not hinges.
+        if (joint.terminal && (part === "head" || part.endsWith("-foot")))
+            continue;
+        const finger = fingerPart(part);
+        const connected = actor.bones.filter(b => b.endJointId === joint.id || b.startJointId === joint.id);
+        const radius = finger ? Math.max(...connected.map(b => radii.get(b.id))) * 1.08
+            : part === "neck" ? actor.height * .016
+                : Math.max(actor.height * .009, ...connected.filter(b => b.modelPart !== "head" && !b.modelPart.endsWith("-hand") && !b.modelPart.endsWith("-foot")).map(b => radii.get(b.id))) * 1.14;
+        const color = finger ? new Color(fingerColors[finger.finger]).lerp(new Color("#ffffff"), .65) : jointColor;
+        add(new SphereGeometry(radius, 16, 10), world[joint.id].position, world[joint.id].rotation, { jointId: joint.id, modelPart: part }, color);
+    }
+    group.updateMatrixWorld(true);
+    return group;
+}
+//# sourceMappingURL=geometric-model.js.map

package/dist/domain/spatial/geometric-model.js.map

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

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

@@ -0,0 +1,36 @@
+import { Matrix4, Quaternion, Vector3 } from "three";
+import type { SpatialBone, SpatialCharacter, SpatialJoint } from "./types.ts";
+export declare const SPATIAL_FINGERS: readonly ["thumb", "index", "middle", "ring", "little"];
+export type SpatialFinger = typeof SPATIAL_FINGERS[number];
+export declare function fingerPart(part: string): {
+    side: string;
+    finger: SpatialFinger;
+    segment: number;
+} | null;
+export declare const isHandPart: (part: string) => boolean;
+export declare const handRig: (actor: SpatialCharacter) => {
+    height: number;
+    bottom: number;
+    parts: {
+        id: string;
+        start: number[];
+        end: number[];
+    }[];
+};
+/** Correct only untouched defaults once, keeping stored angles and custom bounds. */
+export declare function completeThumbLimits(actor: SpatialCharacter): void;
+export declare function owningHand(actor: SpatialCharacter, bone: SpatialBone): SpatialBone | undefined;
+/** Linear source-to-rest map shared by the palm, finger offsets and skin. */
+export declare function handRestMatrix(actor: SpatialCharacter, hand: SpatialBone, shaped?: boolean): Matrix4;
+/** Palm size sets thickness; a separate axial factor sets digit length. */
+export declare function fingerRestMatrix(actor: SpatialCharacter, hand: SpatialBone, modelPart: string): Matrix4;
+/** Finger angles use anatomical hinge axes, expressed in the parent's rest frame. */
+export declare function fingerBasis(actor: SpatialCharacter, bone: SpatialBone): Quaternion;
+export declare function fingerOffset(actor: SpatialCharacter, joint: SpatialJoint, hand: SpatialBone): Vector3;
+export declare function handJointIds(actor: SpatialCharacter, hand: SpatialBone): Set<string>;
+/** Add the source's five chains to a palm, including a fixed attachment per digit. */
+export declare function appendFingers(actor: SpatialCharacter, hand: SpatialBone): void;
+/** Complete only the current v2 Quaternius palm data; no retired model support. */
+export declare function completeCharacterHands(actor: SpatialCharacter): void;
+export declare const fingerCurlAngles: (finger: SpatialFinger) => number[];
+export declare const fingerSpreadAngles: Record<SpatialFinger, number>;

package/dist/domain/spatial/hands.js

@@ -0,0 +1,128 @@
+import { Matrix4, Quaternion, Vector3 } from "three";
+import maleRig from "./assets/quaternius-rig.json" with { type: "json" };
+import femaleRig from "./assets/quaternius-female-rig.json" with { type: "json" };
+import { spatialShape } from "./proportions.js";
+export const SPATIAL_FINGERS = ["thumb", "index", "middle", "ring", "little"];
+export function fingerPart(part) {
+    const match = /^(left|right)-(thumb|index|middle|ring|little)-([0-3])$/.exec(part);
+    return match ? { side: match[1], finger: match[2], segment: Number(match[3]) } : null;
+}
+export const isHandPart = (part) => part.endsWith("-hand") || Boolean(fingerPart(part));
+export const handRig = (actor) => actor.bodyType === "female" ? femaleRig : maleRig;
+function thumbLimits(side, segment) {
+    return segment === 2 ? { min: [0, 0, -45], max: [110, 0, 45] }
+        : { min: [0, 0, side === "left" ? -90 : 0], max: [0, 0, side === "left" ? 0 : 90] };
+}
+/** Correct only untouched defaults once, keeping stored angles and custom bounds. */
+export function completeThumbLimits(actor) {
+    if (actor.thumbLimitsVersion === 2)
+        return;
+    for (const bone of actor.bones) {
+        const part = fingerPart(bone.modelPart);
+        if (part?.finger !== "thumb" || part.segment < 2)
+            continue;
+        const oldMax = [part.segment === 2 ? 110 : 90, 0, 0];
+        if (!bone.limits.min.every(v => v === 0) || !bone.limits.max.every((v, i) => v === oldMax[i]))
+            continue;
+        // Invalid stored angles must still fail validation, rather than widening
+        // the corrected limits to accommodate malformed input.
+        if ([bone.rotation, bone.restRotation].some(values => values.some((v, i) => v < 0 || v > oldMax[i])))
+            continue;
+        bone.limits = thumbLimits(part.side, part.segment);
+        if (part.segment === 3)
+            bone.limits.max[0] = Math.max(bone.rotation[0], bone.restRotation[0]);
+    }
+    actor.thumbLimitsVersion = 2;
+}
+export function owningHand(actor, bone) {
+    let current = bone;
+    while (current) {
+        if (current.modelPart.endsWith("-hand"))
+            return current;
+        current = actor.bones.find(b => b.endJointId === current.startJointId);
+    }
+}
+/** Linear source-to-rest map shared by the palm, finger offsets and skin. */
+export function handRestMatrix(actor, hand, shaped = true) {
+    const rig = handRig(actor), source = rig.parts.find(p => p.id === hand.modelPart);
+    const direction = new Vector3(...source.end).sub(new Vector3(...source.start));
+    const offset = new Vector3(...actor.joints.find(j => j.id === hand.endJointId).offset);
+    const scale = offset.length() / direction.length(), shape = spatialShape(actor.headRatio);
+    const palmSize = shaped ? actor.palmSize ?? 1 : 1;
+    const width = shaped ? actor.height / rig.height * shape.hand * palmSize : scale;
+    const up = new Vector3(0, 1, 0);
+    return new Matrix4().compose(new Vector3(), new Quaternion().setFromUnitVectors(up, offset.normalize()), new Vector3(width, scale * (shaped ? shape.handLength : 1) * palmSize, width))
+        .multiply(new Matrix4().makeRotationFromQuaternion(new Quaternion().setFromUnitVectors(up, direction.normalize()).invert()));
+}
+/** Palm size sets thickness; a separate axial factor sets digit length. */
+export function fingerRestMatrix(actor, hand, modelPart) {
+    const rest = handRestMatrix(actor, hand);
+    if (fingerPart(modelPart)?.segment === 0 || (actor.fingerLength ?? 1) === (actor.palmSize ?? 1))
+        return rest;
+    const part = handRig(actor).parts.find(p => p.id === modelPart);
+    const direction = new Vector3(...part.end).sub(new Vector3(...part.start)).normalize();
+    const frame = new Matrix4().makeRotationFromQuaternion(new Quaternion().setFromUnitVectors(new Vector3(0, 1, 0), direction));
+    return rest.multiply(frame).multiply(new Matrix4().makeScale(1, (actor.fingerLength ?? 1) / (actor.palmSize ?? 1), 1)).multiply(frame.clone().invert());
+}
+/** Finger angles use anatomical hinge axes, expressed in the parent's rest frame. */
+export function fingerBasis(actor, bone) {
+    const finger = fingerPart(bone.modelPart), hand = finger && owningHand(actor, bone);
+    if (!finger || !hand || finger.segment === 0)
+        return new Quaternion();
+    const part = handRig(actor).parts.find(p => p.id === bone.modelPart);
+    const y = new Vector3(...part.end).sub(new Vector3(...part.start)).normalize();
+    const x = y.clone().cross(new Vector3(0, -1, 0)).normalize(), z = x.clone().cross(y).normalize();
+    const rest = handRestMatrix(actor, hand, false);
+    return new Quaternion().setFromRotationMatrix(new Matrix4().makeBasis(x.transformDirection(rest), y.transformDirection(rest), z.transformDirection(rest)));
+}
+export function fingerOffset(actor, joint, hand) {
+    const part = actor.bones.find(b => b.endJointId === joint.id).modelPart;
+    const map = fingerRestMatrix(actor, hand, part).multiply(handRestMatrix(actor, hand, false).invert());
+    return new Vector3(...joint.offset).applyMatrix4(map);
+}
+export function handJointIds(actor, hand) {
+    const ids = new Set([hand.endJointId]);
+    for (const id of ids)
+        for (const joint of actor.joints.filter(j => j.parentId === id))
+            ids.add(joint.id);
+    return ids;
+}
+/** Add the source's five chains to a palm, including a fixed attachment per digit. */
+export function appendFingers(actor, hand) {
+    const rig = handRig(actor), rest = handRestMatrix(actor, hand, false);
+    const prefix = hand.id.endsWith(hand.modelPart) ? hand.id.slice(0, -hand.modelPart.length) : `${hand.id}-`;
+    const side = hand.modelPart.startsWith("left") ? "left" : "right";
+    for (const finger of SPATIAL_FINGERS)
+        for (let segment = 0; segment < 4; segment++) {
+            const modelPart = `${side}-${finger}-${segment}`, id = `${prefix}${modelPart}`;
+            const source = rig.parts.find(p => p.id === modelPart);
+            const parentId = segment ? `${prefix}${side}-${finger}-${segment - 1}` : hand.endJointId;
+            const offset = new Vector3(...source.end).sub(new Vector3(...source.start)).applyMatrix4(rest).toArray();
+            const min = segment === 0 ? [0, 0, 0] : segment === 1 ? [-10, finger === "thumb" ? -70 : 0, finger === "thumb" ? -35 : -20] : [0, 0, 0];
+            const max = segment === 0 ? [0, 0, 0] : segment === 1 ? [95, finger === "thumb" ? 70 : 0, finger === "thumb" ? 35 : 20] : [segment === 2 ? 110 : 90, 0, 0];
+            actor.joints.push({ id, name: id, parentId, offset, radius: actor.height * .004, terminal: segment === 3, lockPosition: false });
+            const limits = finger === "thumb" && segment >= 2 ? thumbLimits(side, segment) : { min, max };
+            actor.bones.push({ id, name: id, startJointId: parentId, endJointId: id, rotation: [0, 0, 0], restRotation: [0, 0, 0], limits, lockRotation: false, modelPart });
+        }
+}
+/** Complete only the current v2 Quaternius palm data; no retired model support. */
+export function completeCharacterHands(actor) {
+    for (const hand of actor.bones.filter(b => b.modelPart === "left-hand" || b.modelPart === "right-hand")) {
+        const end = actor.joints.find(j => j.id === hand.endJointId);
+        if (!end?.terminal || actor.joints.some(j => j.parentId === end.id))
+            continue;
+        end.offset = end.offset.map(v => v * .35);
+        end.terminal = false;
+        end.radius = actor.height * .01;
+        const pinnedTip = end.lockPosition;
+        end.lockPosition = false;
+        appendFingers(actor, hand);
+        if (pinnedTip) {
+            const tip = actor.bones.find(b => b.modelPart === hand.modelPart.replace("hand", "middle-3") && handJointIds(actor, hand).has(b.endJointId));
+            actor.joints.find(j => j.id === tip.endJointId).lockPosition = true;
+        }
+    }
+}
+export const fingerCurlAngles = (finger) => finger === "thumb" ? [35, 50, 55] : [70, 95, 65];
+export const fingerSpreadAngles = { thumb: 0, index: 16, middle: 4, ring: -7, little: -18 };
+//# sourceMappingURL=hands.js.map

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

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

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

@@ -0,0 +1,30 @@
+import type { SpatialCamera, SpatialCharacter, SpatialDraft, SpatialBodyType, SpatialOperation } from "./types.ts";
+export * from "./types.ts";
+export * from "./kinematics.ts";
+export * from "./hands.ts";
+export { BODY_SHAPE_LIMITS } from "./proportions.ts";
+import type { SpatialAppearance, SpatialBodyShape } from "./types.ts";
+export * from "./camera-box.ts";
+export declare const TORSO_RATIO_LIMITS: {
+    readonly min: 0.3;
+    readonly max: 0.7;
+};
+export declare const DEFAULT_TORSO_RATIO: number;
+export declare class SpatialConstraintError extends Error {
+    readonly code = "SPATIAL_CONSTRAINT";
+}
+export declare function createSpatialCamera(id?: string, name?: string): SpatialCamera;
+export declare function createSpatialDraft(): SpatialDraft;
+export declare function createHumanoid(id: string, name: string, height?: number, headRatio?: number, torsoRatio?: number, bodyType?: SpatialBodyType, bodyShape?: SpatialBodyShape & {
+    appearance?: SpatialAppearance;
+}): SpatialCharacter;
+export declare function validateSpatialDraft(input: unknown): SpatialDraft;
+export declare function validateSpatialTransition(before: SpatialDraft, after: SpatialDraft, options?: {
+    allowLimitChanges?: boolean;
+    resetPoseCharacterId?: string;
+}): void;
+export declare function spatialDraftFingerprint(input: SpatialDraft): string;
+export declare function applySpatialOperations(input: SpatialDraft, operations: SpatialOperation[]): {
+    draft: SpatialDraft;
+    constrained: boolean;
+};