@rydr/game-sdk 8.10.0 → 8.12.0

package/dist/three/controller/three-pad-renderer.js

@@ -0,0 +1,433 @@
+/**
+ * THE 3D PAD RENDERER — a Joy-Con pair in three.js, drop-in wherever the flat drawing goes.
+ *
+ * ```ts
+ * import { createThreePadRenderer } from "@rydr/game-sdk/three";
+ * import { mountControllerMap } from "@rydr/game-sdk/ui";
+ *
+ * mountControllerMap(host, { press: session, actions, renderer: createThreePadRenderer });
+ * ```
+ *
+ * It satisfies `PadRenderer` (see `ui/controller/renderer.ts`), which is the entire contract the five
+ * controller views speak. So the map's leader lines, the combo demo's timeline, the spotlight's
+ * captions and the guided lesson's gating all work against it **unchanged** — none of them knows or
+ * cares that there is a WebGL canvas where an `<svg>` used to be.
+ *
+ * ## What the third dimension actually buys
+ *
+ * Two things the flat pad could not say:
+ *
+ *   1. **The triggers are visible.** `ZL`/`ZR` live on the back of each half. The flat drawing had to
+ *      float them above the shell (that's what the `y −20` band in `PAD_VIEWBOX` is for). Here they sit
+ *      where they really are, and the pad tilts forward just enough to show them.
+ *   2. **A press is a press.** The flat pad simulates depth by dropping a shape onto its own drop
+ *      shadow. Here the button actually moves along the viewing axis, and a stick actually leans.
+ *
+ * ## Only the Joy-Con
+ *
+ * `brand: "joycon"` is the one silhouette modelled — it's what PLAT-1556 asked for, and it happens to
+ * be the most tractable shape in the kit (two rounded slabs rather than one organic shell). Ask this
+ * renderer for any other brand and it says so and draws the Joy-Con anyway, rather than failing: a
+ * caller who pinned `brand` has a bug, and a blank canvas hides it.
+ *
+ * ## Cost
+ *
+ * One WebGL context per mounted pad, and browsers cap those (~8–16). A page showing several 3D views at
+ * once is close to that ceiling — which is why the render loop is shared, idle-skipping and paused on a
+ * hidden tab: a pad nobody is touching costs nothing per frame, exactly like the flat one's dirty-guard.
+ */
+import * as THREE from "three";
+import { FAINT_PARTS, SHELL_OWNED_PARTS, STICK_LIT_DEADZONE } from "../../ui/controller/pad-svg.js";
+import { partRectOf, } from "../../ui/controller/renderer.js";
+import { JOYCON_DESIGNS } from "./joycon-designs.js";
+import { VIEW, W } from "./joycon-spec.js";
+import { glyphTexture } from "./glyph-texture.js";
+/** The four things a part can say, as colours. Same grammar and same hues as the flat pad's CSS. */
+const STATE_COLOR = {
+    off: 0x8ea3bd,
+    hint: 0xf2f6ff,
+    on: 0x38bdf8,
+    done: 0x22c55e,
+};
+/** Emissive strength per state — what makes a lit button read as lit rather than merely repainted. */
+const STATE_EMISSIVE = { off: 0, hint: 0.5, on: 0.85, done: 0.7 };
+/** Glyph ink. A lit face goes bright, so its letter has to go dark to stay readable. */
+const GLYPH_INK = {
+    off: "#eaf2ff",
+    hint: "#0b0f17",
+    on: "#06121a",
+    done: "#05210f",
+};
+/** How far a pressed key sinks, world units. A press is real travel here, not a simulated shadow. */
+const PRESS_TRAVEL = W * 0.06;
+/** Cap tilt at full stick deflection, radians. A stick leans; it doesn't slide. */
+const STICK_TILT = 0.42;
+/** Opacity for a part the rider's device doesn't have. Matches `.unavailable` on the flat pad. */
+const UNAVAILABLE_OPACITY = 0.22;
+/**
+ * Frames the pad fills of the canvas height. Below 1 leaves the margin the tilt needs — a tilted pad is
+ * taller than its flat footprint, and a camera framed on the flat one clips the triggers off the top.
+ */
+const FRAME_FILL = 0.82;
+/**
+ * Build a three.js pad renderer. Matches {@link PadRendererFactory}, so it can be handed straight to
+ * any controller view's `renderer` option.
+ */
+export function createThreePadRenderer(layout, opts = {}) {
+    if (layout.brand !== "joycon") {
+        console.warn(`[rydr] createThreePadRenderer only models the Joy-Con pair; got brand "${layout.brand}". ` +
+            `Drawing the Joy-Con. Pass brand: "joycon" to the view to make this explicit.`);
+    }
+    const canvas = document.createElement("canvas");
+    // Give the canvas the layout's own aspect ratio, so it behaves exactly like the `<svg>` it replaces:
+    // `.rydr-pad > svg` is `width:100%; height:auto`, and an SVG supplies its own ratio through its
+    // viewBox. A canvas has NO intrinsic ratio, so without this it collapses to zero height inside every
+    // host that doesn't happen to set one — the pad would simply not appear.
+    const [, , vbW, vbH] = layout.viewBox;
+    canvas.style.cssText = `display:block; width:100%; height:auto; aspect-ratio:${vbW} / ${vbH};`;
+    const renderer = new THREE.WebGLRenderer({ canvas, antialias: true, alpha: true });
+    renderer.setClearAlpha(0);
+    renderer.outputColorSpace = THREE.SRGBColorSpace;
+    const scene = new THREE.Scene();
+    const camera = new THREE.PerspectiveCamera(30, 1, 0.1, 100);
+    camera.position.set(0, 0, 9);
+    const design = JOYCON_DESIGNS.find((d) => d.id === (opts.design ?? "toy")) ?? JOYCON_DESIGNS[1];
+    const model = design.build();
+    // Lighting belongs to the art direction, so the design supplies it. A separate rig here would make
+    // the same pad look different in a game than in the showcase that chose it.
+    design.light(scene);
+    // Two groups: `yawGroup` turns, `pivot` tilts. Separate so a yaw never introduces roll.
+    const pivot = new THREE.Group();
+    pivot.rotation.x = opts.tilt ?? VIEW.pitch;
+    pivot.add(model.group);
+    const yawGroup = new THREE.Group();
+    yawGroup.rotation.y = opts.yaw ?? 0;
+    yawGroup.add(pivot);
+    scene.add(yawGroup);
+    // Accent is themable on the flat pad through a CSS variable; here it has to reach the materials.
+    const accent = opts.accent ? new THREE.Color(opts.accent).getHex() : STATE_COLOR.on;
+    /** Every part this model actually draws. */
+    const ALL_PARTS = [...model.controls.keys()];
+    /**
+     * The mesh and material behind a part.
+     *
+     * `JoyconBuild` keys its controls by name and hands back plain `Object3D`s, so this resolves one to
+     * something paintable. A stick's entry is its cap mesh, which is what should light and sink.
+     */
+    function visualOf(part) {
+        const node = model.controls.get(part);
+        if (!node)
+            return undefined;
+        const mesh = node;
+        const mat = mesh.material;
+        if (!mat || !("color" in mat))
+            return undefined;
+        let rest = restZ.get(part);
+        if (rest === undefined) {
+            rest = node.position.z;
+            restZ.set(part, rest);
+        }
+        return { node, material: mat, restZ: rest };
+    }
+    /** Resting z per part, captured on first paint so a press is absolute, not cumulative. */
+    const restZ = new Map();
+    // ── state ───────────────────────────────────────────────────────────────────────────────────────
+    /** Dirty-guard, same intent as the flat driver's: an idle pad must do no work per frame. */
+    const lastVal = new Map();
+    const STATE_CODE = { off: 0, on: 1, hint: 2, done: 3 };
+    let unavailable = new Set();
+    let referenced = new Set();
+    /** Set whenever something changed; the loop renders only then. */
+    let dirty = true;
+    function applyOpacity(part) {
+        const v = visualOf(part);
+        if (!v)
+            return;
+        const dim = unavailable.has(part);
+        // `referenced` only ever RAISES a faint part back to full, exactly as the flat pad's rule does.
+        const faint = FAINT_PARTS.has(part) && !referenced.has(part);
+        const o = dim ? UNAVAILABLE_OPACITY : faint ? 0.4 : 1;
+        v.material.transparent = o < 1;
+        v.material.opacity = o;
+    }
+    function paint(part, state) {
+        const v = visualOf(part);
+        if (!v)
+            return;
+        const color = state === "on" ? accent : STATE_COLOR[state];
+        v.material.color.setHex(color);
+        v.material.emissive.setHex(state === "off" ? 0x000000 : color);
+        v.material.emissiveIntensity = STATE_EMISSIVE[state];
+        // A press is real travel here — the flat pad had to fake it with a drop shadow.
+        v.node.position.z = v.restZ - (state === "on" || state === "done" ? PRESS_TRAVEL : 0);
+        applyOpacity(part);
+        dirty = true;
+    }
+    /** What's printed on a part — read back off the built glyph so it can be re-inked per state. */
+    const glyphTexts = new Map();
+    function glyphTextOf(part) {
+        return glyphTexts.get(part) ?? "";
+    }
+    for (const [name, spec] of [
+        ["faceTop", layout.face.top],
+        ["faceRight", layout.face.right],
+        ["faceBottom", layout.face.bottom],
+        ["faceLeft", layout.face.left],
+        ["select", layout.system?.select],
+        ["start", layout.system?.start],
+        ["lb", layout.bumpers?.l],
+        ["rb", layout.bumpers?.r],
+        ["lt", layout.triggers?.l],
+        ["rt", layout.triggers?.r],
+    ]) {
+        if (spec?.glyph)
+            glyphTexts.set(name, spec.glyph);
+    }
+    // ── the driver ──────────────────────────────────────────────────────────────────────────────────
+    const setPartState = (part, state) => {
+        if (SHELL_OWNED_PARTS.has(part) && !opts.allowShellOwned)
+            return;
+        if (lastVal.get(part) === STATE_CODE[state])
+            return;
+        lastVal.set(part, STATE_CODE[state]);
+        paint(part, state);
+        // A lit trigger rolls the pad forward so it can actually be seen — see `triggerTilt`.
+        if (part === "lt" || part === "rt") {
+            if (state === "off")
+                litTriggers.delete(part);
+            else
+                litTriggers.add(part);
+            aimRoll();
+        }
+    };
+    const setStick = (side, x, y, lit = "auto") => {
+        const pivot = model.sticks[side];
+        if (!pivot)
+            return;
+        const litKey = `${side}lit`;
+        const resolved = lit === "auto" ? (Math.hypot(x, y) > STICK_LIT_DEADZONE ? "on" : "off") : lit;
+        const code = resolved === "on" ? 1 : resolved === "hint" ? 2 : resolved === "done" ? 3 : 0;
+        if (lastVal.get(litKey) !== code) {
+            lastVal.set(litKey, code);
+            // Colour lives on the CAP, which is registered as the stick-click part.
+            const cap = visualOf(side === "l" ? "lstickPress" : "rstickPress");
+            if (cap) {
+                const state = resolved;
+                const color = state === "on" ? accent : STATE_COLOR[state];
+                cap.material.color.setHex(color);
+                cap.material.emissive.setHex(state === "off" ? 0x000000 : color);
+                cap.material.emissiveIntensity = STATE_EMISSIVE[state];
+            }
+            dirty = true;
+        }
+        // A real stick LEANS. `y` is up-positive in the SDK's convention, and a push "up" tips the cap away
+        // from the viewer — a negative rotation about x — so the sign works out without the flat
+        // renderer's y-negation.
+        const rx = -y * STICK_TILT;
+        const ry = x * STICK_TILT;
+        if (Math.abs(rx - (lastVal.get(`${side}rx`) ?? 0)) < 0.002 &&
+            Math.abs(ry - (lastVal.get(`${side}ry`) ?? 0)) < 0.002) {
+            return;
+        }
+        lastVal.set(`${side}rx`, rx);
+        lastVal.set(`${side}ry`, ry);
+        pivot.rotation.x = rx;
+        pivot.rotation.y = ry;
+        dirty = true;
+    };
+    const driver = {
+        setPartState,
+        setPart: (part, on) => setPartState(part, on ? "on" : "off"),
+        setStick,
+        setMeter(side, v01) {
+            // The generated model draws no travel meter: in this protocol LT/RT are plain clicks (see
+            // `protocol/buttons.ts`), so the trigger simply lights, which `setPart` already does.
+            void side;
+            void v01;
+        },
+        setAvailable(available) {
+            unavailable = available == null
+                ? new Set()
+                : new Set(ALL_PARTS.filter((p) => !available.includes(p) && !SHELL_OWNED_PARTS.has(p)));
+            for (const part of ALL_PARTS)
+                applyOpacity(part);
+            dirty = true;
+        },
+        clearAll() {
+            for (const part of ALL_PARTS) {
+                lastVal.set(part, 0);
+                paint(part, "off");
+            }
+            litTriggers.clear();
+            aimRoll();
+            for (const side of ["l", "r"]) {
+                lastVal.delete(`${side}lit`);
+                setStick(side, 0, 0, "off");
+                this.setMeter(side, 0);
+            }
+        },
+    };
+    // Paint every part once so a part's material starts in a known state rather than its build colour.
+    for (const part of ALL_PARTS)
+        paint(part, "off");
+    // ── sizing ──────────────────────────────────────────────────────────────────────────────────────
+    function resize() {
+        const w = canvas.clientWidth || 1;
+        const h = canvas.clientHeight || 1;
+        renderer.setPixelRatio(Math.min(window.devicePixelRatio, opts.maxPixelRatio ?? 2));
+        renderer.setSize(w, h, false);
+        camera.aspect = w / h;
+        // Frame from the model's bounding SPHERE, which is invariant under rotation: one number frames
+        // every tilt and yaw without the framing pumping as the pad turns.
+        yawGroup.updateMatrixWorld(true);
+        const box = new THREE.Box3().setFromObject(yawGroup);
+        const sphere = box.getBoundingSphere(new THREE.Sphere());
+        const fovV = (camera.fov * Math.PI) / 180;
+        const fovH = 2 * Math.atan(Math.tan(fovV / 2) * camera.aspect);
+        const fill = opts.fill ?? 0.82;
+        const dist = Math.max(sphere.radius / Math.sin(fovV / 2), sphere.radius / Math.sin(fovH / 2)) / fill;
+        // Offsets are expressed as fractions of the visible frame at the pad's distance, so they mean the
+        // same thing whatever the fill or the aspect.
+        const halfH = Math.tan(fovV / 2) * dist;
+        const halfW = halfH * camera.aspect;
+        camera.position.set(sphere.center.x - (opts.offsetX ?? 0) * halfW * 2, sphere.center.y - (opts.offsetY ?? 0) * halfH * 2, sphere.center.z + dist);
+        camera.lookAt(camera.position.x, camera.position.y, sphere.center.z);
+        camera.updateProjectionMatrix();
+        dirty = true;
+    }
+    const ro = new ResizeObserver(() => resize());
+    ro.observe(canvas);
+    // ── the trigger roll ────────────────────────────────────────────────────────────────────────────
+    /** Which triggers are currently lit. The pad rolls while this is non-empty. */
+    const litTriggers = new Set();
+    const restTilt = opts.tilt ?? VIEW.pitch;
+    const extraTilt = opts.triggerTilt ?? 0.38;
+    const rollMs = opts.triggerTiltMs ?? 420;
+    /** 0 = at rest, 1 = fully rolled forward. */
+    let roll = 0;
+    let rollFrom = 0;
+    let rollTarget = 0;
+    let rollStart = 0;
+    const projectionCbs = new Set();
+    function aimRoll() {
+        const want = litTriggers.size > 0 ? 1 : 0;
+        if (want === rollTarget)
+            return;
+        rollFrom = roll;
+        rollTarget = want;
+        rollStart = performance.now();
+        start();
+    }
+    /** Advance the roll. Returns true while it is still moving. */
+    function stepRoll(now) {
+        if (roll === rollTarget)
+            return false;
+        const t = Math.min(1, (now - rollStart) / rollMs);
+        // Ease in-out: the pad should settle rather than snap, or the labels riding on it jitter.
+        const e = t < 0.5 ? 2 * t * t : 1 - Math.pow(-2 * t + 2, 2) / 2;
+        roll = rollFrom + (rollTarget - rollFrom) * e;
+        if (t >= 1)
+            roll = rollTarget;
+        pivot.rotation.x = restTilt + extraTilt * roll;
+        dirty = true;
+        // Anything positioned from partRect has to follow, so tell it every frame of the roll.
+        for (const cb of projectionCbs)
+            cb();
+        return roll !== rollTarget;
+    }
+    // ── the loop ────────────────────────────────────────────────────────────────────────────────────
+    // Renders only on a change. An untouched pad therefore costs one `requestAnimationFrame` callback and
+    // no GPU work at all — the 3D equivalent of the flat driver's dirty-guard.
+    let raf = 0;
+    function frame() {
+        raf = requestAnimationFrame(frame);
+        stepRoll(performance.now());
+        if (!dirty)
+            return;
+        dirty = false;
+        renderer.render(scene, camera);
+    }
+    function start() {
+        if (!raf)
+            raf = requestAnimationFrame(frame);
+    }
+    function stop() {
+        if (raf)
+            cancelAnimationFrame(raf);
+        raf = 0;
+    }
+    const onVisibility = () => {
+        if (document.visibilityState === "hidden")
+            stop();
+        else {
+            dirty = true;
+            start();
+        }
+    };
+    document.addEventListener("visibilitychange", onVisibility);
+    start();
+    // ── projection ──────────────────────────────────────────────────────────────────────────────────
+    return {
+        node: canvas,
+        driver,
+        layout,
+        // A shaded object, not a flat diagram — so a caption sitting ON the pad drops its opaque chip.
+        perspective: true,
+        partRect(part) {
+            const v = visualOf(part);
+            if (!v)
+                return null;
+            const box = canvas.getBoundingClientRect();
+            if (box.width < 1 || box.height < 1)
+                return null;
+            // Corners come from the part's own bounding box, in WORLD space.
+            //
+            // `setFromObject` already walks the object's `matrixWorld`, so the box it returns is world-space
+            // and includes the pad's tilt. Running the corners through `pivot.localToWorld` afterwards — as
+            // this did — applied that rotation a SECOND time, which is why leader lines and captions landed
+            // beside their control instead of on it.
+            pivot.updateMatrixWorld(true);
+            const world = new THREE.Box3().setFromObject(v.node);
+            const p3 = new THREE.Vector3();
+            let minX = Infinity;
+            let minY = Infinity;
+            let maxX = -Infinity;
+            let maxY = -Infinity;
+            for (let i = 0; i < 8; i++) {
+                p3.set(i & 1 ? world.max.x : world.min.x, i & 2 ? world.max.y : world.min.y, i & 4 ? world.max.z : world.min.z);
+                p3.project(camera);
+                const sx = box.left + ((p3.x + 1) / 2) * box.width;
+                const sy = box.top + ((1 - p3.y) / 2) * box.height;
+                minX = Math.min(minX, sx);
+                maxX = Math.max(maxX, sx);
+                minY = Math.min(minY, sy);
+                maxY = Math.max(maxY, sy);
+            }
+            return partRectOf(minX, minY, maxX - minX, maxY - minY);
+        },
+        setReferenced(parts) {
+            referenced = parts;
+            for (const part of ALL_PARTS)
+                applyOpacity(part);
+            dirty = true;
+        },
+        resize,
+        onProjectionChange(cb) {
+            projectionCbs.add(cb);
+            return () => projectionCbs.delete(cb);
+        },
+        dispose() {
+            stop();
+            document.removeEventListener("visibilitychange", onVisibility);
+            ro.disconnect();
+            for (const d of model.disposables)
+                d.dispose();
+            renderer.dispose();
+            // Hand the context back rather than waiting for GC: browsers cap live WebGL contexts, and a page
+            // that mounts and unmounts several 3D pads would otherwise run out and start killing old ones.
+            renderer.forceContextLoss();
+            canvas.remove();
+        },
+    };
+}
+//# sourceMappingURL=three-pad-renderer.js.map

package/dist/three/controller/three-pad-renderer.js.map

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

package/dist/three/index.d.ts

@@ -11,4 +11,6 @@ export * from "./perf-marks.js";
 export * from "./perf-overlay.js";
 export * from "./screen-anchor.js";
 export * from "./waypoint-beacon.js";
+export * from "./controller/index.js";
+export * from "./rider/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/three/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/three/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/three/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC"}

package/dist/three/index.js

@@ -11,4 +11,6 @@ export * from "./perf-marks.js";
 export * from "./perf-overlay.js";
 export * from "./screen-anchor.js";
 export * from "./waypoint-beacon.js";
+export * from "./controller/index.js";
+export * from "./rider/index.js";
 //# sourceMappingURL=index.js.map

package/dist/three/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/three/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/three/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC"}

package/dist/three/rider/cyclist-pose.d.ts

@@ -0,0 +1,62 @@
+/**
+ * POSE A HUMANOID AS A CYCLIST — the bridge from the flat rig's solved joints to a skeleton's
+ * rotations.
+ *
+ * `mountRiderRig` already solves every joint the pose needs: hip, shoulder, head, elbow, both knees
+ * and both pedals, as points in the flat 200×200 drawing space. So there is no cycling *animation*
+ * to author here and no clip to bake — the gait already exists, and this file only re-expresses it.
+ * That is why the rider can be a real character without anyone producing a `Cycling` clip.
+ *
+ * ## Why this is rotations and not positions
+ *
+ * The skeleton is a parented chain (`hips → chest → shoulder → elbow → hand`, `hips → hipL → kneeL`)
+ * whose limbs hang along **−Y** at rest. You cannot place a knee: you rotate the hip until the knee
+ * lands there. And because each joint inherits its parent's rotation, a joint's own angle is the
+ * WORLD angle it needs MINUS the world angle its parent already has — which is the whole of
+ * {@link segmentAngle} and the subtractions below.
+ *
+ * The bike is drawn side-on, in a plane, so every rotation is about Z alone. Rotating the rest
+ * direction `(0, −1)` by θ gives `(sin θ, −cos θ)`, so the angle that points a segment along `d` is
+ * `atan2(dx, −dy)`. All of the trigonometry in this file is that one identity.
+ *
+ * ## The lengths have to agree
+ *
+ * A rotation can aim a limb but cannot stretch it, so if the skeleton's thigh is not the thigh the IK
+ * solved with, the knee lands in the right *direction* at the wrong *distance* and the foot leaves the
+ * pedal. {@link cyclistProportions} builds the character to the drawing's own dimensions instead of
+ * re-solving the IK against the character's — one conversion, and the feet stay on the pedals.
+ */
+import * as THREE from "three";
+import type { RigPose } from "../../ui/rider-rig.js";
+import type { Joints, Proportions, RiderTickPose } from "../character/index.js";
+/**
+ * The dimensions the character must be built to, in metres — everything else is the variant's own.
+ *
+ * `scale` is the flat-units-to-metres factor the renderer already uses, so every length here is the
+ * same length the IK solved with. Only the lengths the pose depends on are forced; `spine` and `neck`
+ * stay the variant's, because those are its silhouette rather than its reach.
+ *
+ * Worth knowing: this rider's legs are long for the wheel — the flat drawing is a stylised stick
+ * figure whose limbs were tuned to read at a glance, not to anatomy, and that only becomes visible
+ * once a correctly-proportioned character stands next to it. Forcing the drawing's lengths keeps the
+ * two renderers showing the same rider; deriving them from anatomy instead would put the feet through
+ * the cranks.
+ */
+export declare function cyclistOverrides(scale: number): Partial<Proportions>;
+/**
+ * The group to add to the scene: it carries the quarter-turn that makes the character face the way the
+ * bike does, and it parks the rig at the saddle so every joint below it works in local space.
+ */
+export declare function mountCyclist(riderRoot: THREE.Object3D, scale: number): THREE.Group;
+/**
+ * Drive one frame. Every joint the flat pose solved gets its rotation; nothing is re-derived.
+ *
+ * The rise out of the saddle goes on `body`, which is the joint the rig documents as owning bob and
+ * lean — so it lifts the whole rider without disturbing the skeleton's own hip height. `chest` carries
+ * the fold onto the bars, and the arms and head inherit it, which is why a folded rider's head tucks
+ * without a second calculation.
+ */
+export declare function poseCyclist(joints: Joints, pose: RigPose, scale: number): void;
+/** What a variant's own flourishes read. The crank angle is the gait phase for a cyclist. */
+export declare function tickPose(pose: RigPose, time: number): RiderTickPose;
+//# sourceMappingURL=cyclist-pose.d.ts.map

package/dist/three/rider/cyclist-pose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cyclist-pose.d.ts","sourceRoot":"","sources":["../../../src/three/rider/cyclist-pose.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAY,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAE/D,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAyChF;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAqBpE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC,KAAK,CAOlF;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAiD9E;AAED,6FAA6F;AAC7F,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CAEnE"}