@edv4h/usketch-plugin-character 0.2.0

package/dist/character-runtime.js

@@ -0,0 +1,229 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// The runtime loop: held keys → physics step → follow camera → awareness publish,
+// plus smoothing of remote characters. One rAF loop that runs only while the local
+// character is enabled or a remote one is still easing into place.
+import { screenToWorld, viewportRotation, } from "@edv4h/usketch-shared";
+import { anchorPx, easeFocus, followViewport, sameViewport, smoothingAlpha, targetRotation, } from "./character-camera.js";
+import { createKeyInput } from "./character-input.js";
+import { CharacterLayer } from "./character-layer.js";
+import { stepCharacter } from "./character-physics.js";
+import { createCharacterSync, easeRemotes, } from "./character-sync.js";
+export const CHARACTER_LAYER_ID = "character";
+/** Above shapes and most overlays, below the HUD (9999). */
+const CHARACTER_LAYER_ORDER = 700;
+/** `viewport:claimed` priority: above start-position (10), below deep links (100). */
+export const CHARACTER_VIEWPORT_PRIORITY = 20;
+/** Remote pose smoothing (see `smoothingAlpha`). */
+const REMOTE_SMOOTHING = 0.75;
+/** Largest simulated step, so a background-tab pause doesn't teleport the character. */
+const MAX_DT = 0.05;
+function scheduleFrame(fn) {
+    if (typeof requestAnimationFrame === "function")
+        return requestAnimationFrame(fn);
+    return setTimeout(() => fn(Date.now()), 16);
+}
+function cancelFrame(handle) {
+    if (typeof cancelAnimationFrame === "function")
+        cancelAnimationFrame(handle);
+    else
+        clearTimeout(handle);
+}
+/**
+ * The main canvas's pixel size. Found via `[data-layer-id]` wrappers' parent (the
+ * app build strips `data-testid`, so `canvas-container` can't be queried); the
+ * largest wins when a minimap also renders layers. Falls back to the window.
+ */
+export function canvasSize() {
+    if (typeof document !== "undefined") {
+        let best = null;
+        const seen = new Set();
+        for (const el of document.querySelectorAll("[data-layer-id]")) {
+            const parent = el.parentElement;
+            if (!parent || seen.has(parent))
+                continue;
+            seen.add(parent);
+            const r = parent.getBoundingClientRect();
+            if (!best || r.width * r.height > best.width * best.height) {
+                best = { width: r.width, height: r.height };
+            }
+        }
+        if (best && best.width > 0 && best.height > 0)
+            return best;
+    }
+    if (typeof window !== "undefined")
+        return { width: window.innerWidth, height: window.innerHeight };
+    return { width: 0, height: 0 };
+}
+export function setupCharacterRuntime(ctx, store, options) {
+    const keys = createKeyInput(options.keys, () => store.getState().enabled);
+    let cam = null;
+    let display = new Map();
+    let rafId = null;
+    let lastFrame = null;
+    // Set while WE write the viewport, so our own writes don't read as a user pan.
+    let writing = false;
+    const anchorPoint = () => anchorPx(store.getState().anchor, canvasSize());
+    const sync = options.awareness
+        ? createCharacterSync(options.awareness, store, () => ensureLoop())
+        : null;
+    const placeAtAnchor = () => {
+        const vp = ctx.store.getViewport();
+        const a = anchorPoint();
+        store.setPosition(screenToWorld(a.x, a.y, vp));
+        cam = null;
+    };
+    const writeViewport = (vp) => {
+        writing = true;
+        try {
+            ctx.store.setViewport(vp);
+        }
+        finally {
+            writing = false;
+        }
+    };
+    // A hoisted declaration: the awareness sync (created above) can request a frame
+    // during its initial read, before this point in setup has run.
+    function frame(now) {
+        rafId = null;
+        const dt = lastFrame === null ? 0 : Math.min(MAX_DT, Math.max(0, (now - lastFrame) / 1000));
+        lastFrame = now;
+        let s = store.getState();
+        if (s.enabled) {
+            if (!s.spawned) {
+                placeAtAnchor();
+                // Face screen-up in whatever way the camera is currently turned.
+                store.setHeading(-viewportRotation(ctx.store.getViewport()));
+                s = store.getState();
+            }
+            const input = keys.read();
+            if (s.followSuspended && keys.anyHeld())
+                store.setFollowSuspended(false);
+            const vp = ctx.store.getViewport();
+            const pose = stepCharacter(s.pose, input, dt, s.controlScheme, s.motion, viewportRotation(vp));
+            store.setPose(pose);
+            s = store.getState();
+            if (s.cameraMode !== "free" && !s.followSuspended) {
+                const target = {
+                    focus: { x: pose.x, y: pose.y },
+                    rotation: targetRotation(s.cameraMode, pose.heading),
+                };
+                const anchor = anchorPoint();
+                // (Re)seed from what's on screen now, so resuming/switching eases instead of jumping.
+                const from = cam ?? {
+                    focus: screenToWorld(anchor.x, anchor.y, vp),
+                    rotation: viewportRotation(vp),
+                };
+                cam = easeFocus(from, target, smoothingAlpha(s.followSmoothing, dt));
+                const next = followViewport(cam, anchor, vp.zoom);
+                if (!sameViewport(vp, next))
+                    writeViewport(next);
+            }
+            sync?.publish();
+        }
+        let settling = false;
+        if (sync) {
+            const eased = easeRemotes(display, sync.targets(), smoothingAlpha(REMOTE_SMOOTHING, dt));
+            settling = eased.settling;
+            if (!sameRemotes(display, eased.next)) {
+                display = eased.next;
+                store.setRemotes(display);
+            }
+        }
+        if (store.getState().enabled || settling)
+            ensureLoop();
+        else
+            lastFrame = null;
+    }
+    function ensureLoop() {
+        if (rafId === null)
+            rafId = scheduleFrame(frame);
+    }
+    // Enable/disable + mode transitions.
+    let prev = store.getState();
+    const unsubscribe = store.subscribe(() => {
+        const s = store.getState();
+        if (s.enabled !== prev.enabled) {
+            if (s.enabled) {
+                cam = null;
+                // Tell load-time camera plugins (start-position, …) to stand down.
+                ctx.events.emit("viewport:claimed", {
+                    source: "character",
+                    priority: CHARACTER_VIEWPORT_PRIORITY,
+                });
+            }
+            else {
+                cam = null;
+                // Hand the camera back upright.
+                if (viewportRotation(ctx.store.getViewport()) !== 0) {
+                    ctx.store.rotateTo(0, anchorPoint(), { animate: true });
+                }
+            }
+            sync?.publish(true);
+        }
+        if (s.cameraMode !== prev.cameraMode || s.followSuspended !== prev.followSuspended) {
+            // Re-seed the smoothed camera from the live viewport so resuming never jumps.
+            cam = null;
+        }
+        prev = s;
+        if (s.enabled)
+            ensureLoop();
+    });
+    // A viewport change we didn't make: zoom (wheel / keys) is welcome — the follow
+    // keeps the character on its anchor at the new zoom. A pure pan means the user
+    // wants to look around, so pause following until a movement key is pressed.
+    let lastZoom = ctx.store.getViewport().zoom;
+    const offViewport = ctx.store.onMutation((e) => {
+        if (e.type !== "viewport:changed")
+            return;
+        const vp = ctx.store.getViewport();
+        const zoomChanged = Math.abs(vp.zoom - lastZoom) > 1e-9;
+        lastZoom = vp.zoom;
+        if (writing || zoomChanged)
+            return;
+        const s = store.getState();
+        if (s.enabled && s.cameraMode !== "free")
+            store.setFollowSuspended(true);
+    });
+    ctx.layers.register({
+        id: CHARACTER_LAYER_ID,
+        order: CHARACTER_LAYER_ORDER,
+        fixed: true,
+        render: (rc) => _jsx(CharacterLayer, { store: store, viewport: rc.viewport }),
+    });
+    if (store.getState().enabled || sync)
+        ensureLoop();
+    return {
+        placeAtAnchor,
+        anchorPoint,
+        setKeys: (k) => keys.setKeys(k),
+        dispose() {
+            if (rafId !== null)
+                cancelFrame(rafId);
+            rafId = null;
+            unsubscribe();
+            offViewport();
+            keys.dispose();
+            sync?.dispose();
+            ctx.layers.unregister(CHARACTER_LAYER_ID);
+        },
+    };
+}
+function sameRemotes(a, b) {
+    if (a.size !== b.size)
+        return false;
+    for (const [id, r] of b) {
+        const o = a.get(id);
+        if (!o ||
+            o.x !== r.x ||
+            o.y !== r.y ||
+            o.heading !== r.heading ||
+            o.moving !== r.moving ||
+            o.speed !== r.speed ||
+            o.name !== r.name ||
+            o.appearance !== r.appearance) {
+            return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=character-runtime.js.map

package/dist/character-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"character-runtime.js","sourceRoot":"","sources":["../src/character-runtime.tsx"],"names":[],"mappings":";AAAA,kFAAkF;AAClF,mFAAmF;AACnF,mEAAmE;AACnE,OAAO,EAGN,aAAa,EAEb,gBAAgB,GAChB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACN,QAAQ,EAER,SAAS,EACT,cAAc,EACd,YAAY,EACZ,cAAc,EACd,cAAc,GACd,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,EAGN,mBAAmB,EACnB,WAAW,GACX,MAAM,qBAAqB,CAAC;AAG7B,MAAM,CAAC,MAAM,kBAAkB,GAAG,WAAW,CAAC;AAC9C,4DAA4D;AAC5D,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAClC,sFAAsF;AACtF,MAAM,CAAC,MAAM,2BAA2B,GAAG,EAAE,CAAC;AAC9C,oDAAoD;AACpD,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAC9B,wFAAwF;AACxF,MAAM,MAAM,GAAG,IAAI,CAAC;AAEpB,SAAS,aAAa,CAAC,EAAyB;IAC/C,IAAI,OAAO,qBAAqB,KAAK,UAAU;QAAE,OAAO,qBAAqB,CAAC,EAAE,CAAC,CAAC;IAClF,OAAO,UAAU,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAsB,CAAC;AAClE,CAAC;AACD,SAAS,WAAW,CAAC,MAAc;IAClC,IAAI,OAAO,oBAAoB,KAAK,UAAU;QAAE,oBAAoB,CAAC,MAAM,CAAC,CAAC;;QACxE,YAAY,CAAC,MAAM,CAAC,CAAC;AAC3B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU;IACzB,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;QACrC,IAAI,IAAI,GAA6C,IAAI,CAAC;QAC1D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAW,CAAC;QAChC,KAAK,MAAM,EAAE,IAAI,QAAQ,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,EAAE,CAAC;YAC/D,MAAM,MAAM,GAAG,EAAE,CAAC,aAAa,CAAC;YAChC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;gBAAE,SAAS;YAC1C,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACjB,MAAM,CAAC,GAAG,MAAM,CAAC,qBAAqB,EAAE,CAAC;YACzC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;gBAC5D,IAAI,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;YAC7C,CAAC;QACF,CAAC;QACD,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;IAC5D,CAAC;IACD,IAAI,OAAO,MAAM,KAAK,WAAW;QAChC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC;IACjE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;AAChC,CAAC;AAgBD,MAAM,UAAU,qBAAqB,CACpC,GAAkB,EAClB,KAAqB,EACrB,OAAgC;IAEhC,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC;IAC1E,IAAI,GAAG,GAAuB,IAAI,CAAC;IACnC,IAAI,OAAO,GAAyC,IAAI,GAAG,EAAE,CAAC;IAC9D,IAAI,KAAK,GAAkB,IAAI,CAAC;IAChC,IAAI,SAAS,GAAkB,IAAI,CAAC;IACpC,+EAA+E;IAC/E,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,MAAM,WAAW,GAAG,GAAU,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IAEjF,MAAM,IAAI,GAAyB,OAAO,CAAC,SAAS;QACnD,CAAC,CAAC,mBAAmB,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,UAAU,EAAE,CAAC;QACnE,CAAC,CAAC,IAAI,CAAC;IAER,MAAM,aAAa,GAAG,GAAS,EAAE;QAChC,MAAM,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QACnC,MAAM,CAAC,GAAG,WAAW,EAAE,CAAC;QACxB,KAAK,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QAC/C,GAAG,GAAG,IAAI,CAAC;IACZ,CAAC,CAAC;IAEF,MAAM,aAAa,GAAG,CAAC,EAAY,EAAQ,EAAE;QAC5C,OAAO,GAAG,IAAI,CAAC;QACf,IAAI,CAAC;YACJ,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAC3B,CAAC;gBAAS,CAAC;YACV,OAAO,GAAG,KAAK,CAAC;QACjB,CAAC;IACF,CAAC,CAAC;IAEF,gFAAgF;IAChF,+DAA+D;IAC/D,SAAS,KAAK,CAAC,GAAW;QACzB,KAAK,GAAG,IAAI,CAAC;QACb,MAAM,EAAE,GAAG,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;QAC5F,SAAS,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;QAEzB,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;YACf,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;gBAChB,aAAa,EAAE,CAAC;gBAChB,iEAAiE;gBACjE,KAAK,CAAC,UAAU,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;gBAC7D,CAAC,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;YACtB,CAAC;YACD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAC1B,IAAI,CAAC,CAAC,eAAe,IAAI,IAAI,CAAC,OAAO,EAAE;gBAAE,KAAK,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;YAEzE,MAAM,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;YACnC,MAAM,IAAI,GAAG,aAAa,CACzB,CAAC,CAAC,IAAI,EACN,KAAK,EACL,EAAE,EACF,CAAC,CAAC,aAAa,EACf,CAAC,CAAC,MAAM,EACR,gBAAgB,CAAC,EAAE,CAAC,CACpB,CAAC;YACF,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACpB,CAAC,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;YAErB,IAAI,CAAC,CAAC,UAAU,KAAK,MAAM,IAAI,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC;gBACnD,MAAM,MAAM,GAAgB;oBAC3B,KAAK,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE;oBAC/B,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC;iBACpD,CAAC;gBACF,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC;gBAC7B,sFAAsF;gBACtF,MAAM,IAAI,GAAG,GAAG,IAAI;oBACnB,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,EAAE,CAAC;oBAC5C,QAAQ,EAAE,gBAAgB,CAAC,EAAE,CAAC;iBAC9B,CAAC;gBACF,GAAG,GAAG,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC,CAAC;gBACrE,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;gBAClD,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,IAAI,CAAC;oBAAE,aAAa,CAAC,IAAI,CAAC,CAAC;YAClD,CAAC;YACD,IAAI,EAAE,OAAO,EAAE,CAAC;QACjB,CAAC;QAED,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,IAAI,IAAI,EAAE,CAAC;YACV,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,cAAc,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC,CAAC;YACzF,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;YAC1B,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBACvC,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC;gBACrB,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YAC3B,CAAC;QACF,CAAC;QAED,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC,OAAO,IAAI,QAAQ;YAAE,UAAU,EAAE,CAAC;;YAClD,SAAS,GAAG,IAAI,CAAC;IACvB,CAAC;IAED,SAAS,UAAU;QAClB,IAAI,KAAK,KAAK,IAAI;YAAE,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC;IAED,qCAAqC;IACrC,IAAI,IAAI,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC5B,MAAM,WAAW,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACxC,MAAM,CAAC,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC3B,IAAI,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;YAChC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;gBACf,GAAG,GAAG,IAAI,CAAC;gBACX,mEAAmE;gBACnE,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE;oBACnC,MAAM,EAAE,WAAW;oBACnB,QAAQ,EAAE,2BAA2B;iBACrC,CAAC,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACP,GAAG,GAAG,IAAI,CAAC;gBACX,gCAAgC;gBAChC,IAAI,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;oBACrD,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;gBACzD,CAAC;YACF,CAAC;YACD,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;QACD,IAAI,CAAC,CAAC,UAAU,KAAK,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC,eAAe,KAAK,IAAI,CAAC,eAAe,EAAE,CAAC;YACpF,8EAA8E;YAC9E,GAAG,GAAG,IAAI,CAAC;QACZ,CAAC;QACD,IAAI,GAAG,CAAC,CAAC;QACT,IAAI,CAAC,CAAC,OAAO;YAAE,UAAU,EAAE,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,gFAAgF;IAChF,+EAA+E;IAC/E,4EAA4E;IAC5E,IAAI,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC;IAC5C,MAAM,WAAW,GAAG,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE;QAC9C,IAAI,CAAC,CAAC,IAAI,KAAK,kBAAkB;YAAE,OAAO;QAC1C,MAAM,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QACnC,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,GAAG,QAAQ,CAAC,GAAG,IAAI,CAAC;QACxD,QAAQ,GAAG,EAAE,CAAC,IAAI,CAAC;QACnB,IAAI,OAAO,IAAI,WAAW;YAAE,OAAO;QACnC,MAAM,CAAC,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC3B,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,UAAU,KAAK,MAAM;YAAE,KAAK,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC;QACnB,EAAE,EAAE,kBAAkB;QACtB,KAAK,EAAE,qBAAqB;QAC5B,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,KAAC,cAAc,IAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,GAAI;KACvE,CAAC,CAAC;IAEH,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC,OAAO,IAAI,IAAI;QAAE,UAAU,EAAE,CAAC;IAEnD,OAAO;QACN,aAAa;QACb,WAAW;QACX,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QAC/B,OAAO;YACN,IAAI,KAAK,KAAK,IAAI;gBAAE,WAAW,CAAC,KAAK,CAAC,CAAC;YACvC,KAAK,GAAG,IAAI,CAAC;YACb,WAAW,EAAE,CAAC;YACd,WAAW,EAAE,CAAC;YACd,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,IAAI,EAAE,OAAO,EAAE,CAAC;YAChB,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;QAC3C,CAAC;KACD,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CACnB,CAAuC,EACvC,CAAuC;IAEvC,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACpC,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpB,IACC,CAAC,CAAC;YACF,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;YACX,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;YACX,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO;YACvB,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;YACrB,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK;YACnB,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI;YACjB,CAAC,CAAC,UAAU,KAAK,CAAC,CAAC,UAAU,EAC5B,CAAC;YACF,OAAO,KAAK,CAAC;QACd,CAAC;IACF,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC"}

package/dist/character-service.d.ts

@@ -0,0 +1,47 @@
+import { type Point, type ServiceRegistry } from "@edv4h/usketch-shared";
+import type { CameraMode } from "./character-camera.js";
+import type { CharacterPose, ControlScheme, MotionParams } from "./character-physics.js";
+import type { CharacterRuntime } from "./character-runtime.js";
+import type { CharacterStore } from "./character-store.js";
+import type { CharacterAppearance, CharacterKeys, CharacterRenderer, RemoteCharacter } from "./character-types.js";
+export interface CharacterApi {
+    isEnabled(): boolean;
+    enable(): void;
+    disable(): void;
+    toggle(): void;
+    /** Local character pose (world position, heading, speed). */
+    getPose(): CharacterPose;
+    /** Teleport the local character (world coordinates). */
+    setPosition(p: Point): void;
+    /** Face a direction (degrees, 0 = up, clockwise). */
+    setHeading(deg: number): void;
+    /** Move the character to the world point under its screen anchor. */
+    placeAtAnchor(): void;
+    getCameraMode(): CameraMode;
+    setCameraMode(mode: CameraMode): void;
+    getControlScheme(): ControlScheme;
+    setControlScheme(scheme: ControlScheme): void;
+    getMotion(): MotionParams;
+    setMotion(motion: Partial<MotionParams>): void;
+    /** Screen anchor as canvas fractions (0..1). */
+    getAnchor(): Point;
+    setAnchor(anchor: Partial<Point>): void;
+    /** Follow smoothing (0 = rigid … 0.99 = heavy lag). */
+    getFollowSmoothing(): number;
+    setFollowSmoothing(value: number): void;
+    /** Replace the movement key bindings (`KeyboardEvent.code` values). */
+    setKeys(keys: CharacterKeys): void;
+    /** Swap the character renderer (`undefined` = draw nothing). */
+    setRenderer(renderer: CharacterRenderer | undefined): void;
+    /** Replace the broadcast appearance data. */
+    setAppearance(appearance: CharacterAppearance): void;
+    /** Other clients' live characters. */
+    getRemotes(): ReadonlyMap<string, RemoteCharacter>;
+    /** Fire on any state change. Returns an unsubscribe. */
+    onChange(listener: () => void): () => void;
+}
+export declare const characterService: import("@edv4h/usketch-shared").ServiceHandle<CharacterApi>;
+export declare function createCharacterApi(store: CharacterStore, runtime: CharacterRuntime): CharacterApi;
+/** Host accessor: `getCharacterApi(app.services)?.enable()`. Undefined when inactive. */
+export declare function getCharacterApi(services: ServiceRegistry): CharacterApi | undefined;
+//# sourceMappingURL=character-service.d.ts.map

package/dist/character-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"character-service.d.ts","sourceRoot":"","sources":["../src/character-service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,KAAK,KAAK,EAAE,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACzF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EACX,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,YAAY;IAC5B,SAAS,IAAI,OAAO,CAAC;IACrB,MAAM,IAAI,IAAI,CAAC;IACf,OAAO,IAAI,IAAI,CAAC;IAChB,MAAM,IAAI,IAAI,CAAC;IACf,6DAA6D;IAC7D,OAAO,IAAI,aAAa,CAAC;IACzB,wDAAwD;IACxD,WAAW,CAAC,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IAC5B,qDAAqD;IACrD,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,qEAAqE;IACrE,aAAa,IAAI,IAAI,CAAC;IACtB,aAAa,IAAI,UAAU,CAAC;IAC5B,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IACtC,gBAAgB,IAAI,aAAa,CAAC;IAClC,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IAC9C,SAAS,IAAI,YAAY,CAAC;IAC1B,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;IAC/C,gDAAgD;IAChD,SAAS,IAAI,KAAK,CAAC;IACnB,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IACxC,uDAAuD;IACvD,kBAAkB,IAAI,MAAM,CAAC;IAC7B,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,uEAAuE;IACvE,OAAO,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;IACnC,gEAAgE;IAChE,WAAW,CAAC,QAAQ,EAAE,iBAAiB,GAAG,SAAS,GAAG,IAAI,CAAC;IAC3D,6CAA6C;IAC7C,aAAa,CAAC,UAAU,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACrD,sCAAsC;IACtC,UAAU,IAAI,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACnD,wDAAwD;IACxD,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;CAC3C;AAED,eAAO,MAAM,gBAAgB,6DAA0D,CAAC;AAExF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,gBAAgB,GAAG,YAAY,CA0BjG;AAED,yFAAyF;AACzF,wBAAgB,eAAe,CAAC,QAAQ,EAAE,eAAe,GAAG,YAAY,GAAG,SAAS,CAEnF"}

package/dist/character-service.js

@@ -0,0 +1,36 @@
+// Host-facing API on the `ctx.services` seam: everything the HUD does, plus the
+// render/appearance hooks, as typed calls a host or another plugin can drive.
+import { defineService } from "@edv4h/usketch-shared";
+export const characterService = defineService("usketch-plugin-character");
+export function createCharacterApi(store, runtime) {
+    return {
+        isEnabled: () => store.getState().enabled,
+        enable: () => store.setEnabled(true),
+        disable: () => store.setEnabled(false),
+        toggle: () => store.setEnabled(!store.getState().enabled),
+        getPose: () => store.getState().pose,
+        setPosition: (p) => store.setPosition(p),
+        setHeading: (deg) => store.setHeading(deg),
+        placeAtAnchor: () => runtime.placeAtAnchor(),
+        getCameraMode: () => store.getState().cameraMode,
+        setCameraMode: (mode) => store.setCameraMode(mode),
+        getControlScheme: () => store.getState().controlScheme,
+        setControlScheme: (scheme) => store.setControlScheme(scheme),
+        getMotion: () => store.getState().motion,
+        setMotion: (motion) => store.setMotion(motion),
+        getAnchor: () => store.getState().anchor,
+        setAnchor: (anchor) => store.setAnchor(anchor),
+        getFollowSmoothing: () => store.getState().followSmoothing,
+        setFollowSmoothing: (v) => store.setFollowSmoothing(v),
+        setKeys: (keys) => runtime.setKeys(keys),
+        setRenderer: (r) => store.setRenderer(r),
+        setAppearance: (a) => store.setAppearance(a),
+        getRemotes: () => store.getState().remotes,
+        onChange: (listener) => store.subscribe(listener),
+    };
+}
+/** Host accessor: `getCharacterApi(app.services)?.enable()`. Undefined when inactive. */
+export function getCharacterApi(services) {
+    return characterService.get(services);
+}
+//# sourceMappingURL=character-service.js.map

package/dist/character-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"character-service.js","sourceRoot":"","sources":["../src/character-service.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,8EAA8E;AAC9E,OAAO,EAAE,aAAa,EAAoC,MAAM,uBAAuB,CAAC;AAiDxF,MAAM,CAAC,MAAM,gBAAgB,GAAG,aAAa,CAAe,0BAA0B,CAAC,CAAC;AAExF,MAAM,UAAU,kBAAkB,CAAC,KAAqB,EAAE,OAAyB;IAClF,OAAO;QACN,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,OAAO;QACzC,MAAM,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC;QACpC,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC;QACtC,MAAM,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC;QACzD,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,IAAI;QACpC,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;QACxC,UAAU,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;QAC1C,aAAa,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE;QAC5C,aAAa,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,UAAU;QAChD,aAAa,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC;QAClD,gBAAgB,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,aAAa;QACtD,gBAAgB,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC;QAC5D,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,MAAM;QACxC,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC;QAC9C,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,MAAM;QACxC,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC;QAC9C,kBAAkB,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,eAAe;QAC1D,kBAAkB,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC;QACtD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;QACxC,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;QACxC,aAAa,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;QAC5C,UAAU,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,OAAO;QAC1C,QAAQ,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC;KACjD,CAAC;AACH,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,eAAe,CAAC,QAAyB;IACxD,OAAO,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACvC,CAAC"}

package/dist/character-store.d.ts

@@ -0,0 +1,55 @@
+import { type Point } from "@edv4h/usketch-shared";
+import type { CameraMode } from "./character-camera.js";
+import { type CharacterPose, type ControlScheme, type MotionParams } from "./character-physics.js";
+import type { CharacterAppearance, CharacterRenderer, RemoteCharacter } from "./character-types.js";
+export interface CharacterState {
+    enabled: boolean;
+    pose: CharacterPose;
+    /** Whether the pose has been placed yet (the first enable spawns at the anchor). */
+    spawned: boolean;
+    cameraMode: CameraMode;
+    controlScheme: ControlScheme;
+    motion: MotionParams;
+    /** Screen anchor as fractions of the canvas (0..1). */
+    anchor: Point;
+    /** 0 = rigid follow … 0.99 = heavy lag. */
+    followSmoothing: number;
+    /** True after the user panned by hand; a movement key resumes following. */
+    followSuspended: boolean;
+    appearance: CharacterAppearance;
+    name?: string;
+    /** Other clients' characters, keyed by id (display poses, smoothed). */
+    remotes: ReadonlyMap<string, RemoteCharacter>;
+}
+export interface CharacterStoreInit {
+    enabled?: boolean;
+    cameraMode?: CameraMode;
+    controlScheme?: ControlScheme;
+    motion?: Partial<MotionParams>;
+    anchor?: Partial<Point>;
+    followSmoothing?: number;
+    appearance?: CharacterAppearance;
+    name?: string;
+    renderer?: CharacterRenderer;
+}
+export declare function createCharacterStore(init?: CharacterStoreInit): {
+    getState: () => CharacterState;
+    subscribe(listener: () => void): () => void;
+    getRenderer: () => CharacterRenderer | undefined;
+    setRenderer(fn: CharacterRenderer | undefined): void;
+    setEnabled(enabled: boolean): void;
+    setPose(pose: CharacterPose): void;
+    setPosition(p: Point): void;
+    setHeading(deg: number): void;
+    setCameraMode(cameraMode: CameraMode): void;
+    setControlScheme(controlScheme: ControlScheme): void;
+    setMotion(m: Partial<MotionParams>): void;
+    setAnchor(a: Partial<Point>): void;
+    setFollowSmoothing(v: number): void;
+    setFollowSuspended(followSuspended: boolean): void;
+    setAppearance(appearance: CharacterAppearance): void;
+    setName(name: string | undefined): void;
+    setRemotes(remotes: ReadonlyMap<string, RemoteCharacter>): void;
+};
+export type CharacterStore = ReturnType<typeof createCharacterStore>;
+//# sourceMappingURL=character-store.d.ts.map

package/dist/character-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"character-store.d.ts","sourceRoot":"","sources":["../src/character-store.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,KAAK,EAAW,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EACN,KAAK,aAAa,EAClB,KAAK,aAAa,EAElB,KAAK,YAAY,EACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEpG,MAAM,WAAW,cAAc;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,aAAa,CAAC;IACpB,oFAAoF;IACpF,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,UAAU,CAAC;IACvB,aAAa,EAAE,aAAa,CAAC;IAC7B,MAAM,EAAE,YAAY,CAAC;IACrB,uDAAuD;IACvD,MAAM,EAAE,KAAK,CAAC;IACd,2CAA2C;IAC3C,eAAe,EAAE,MAAM,CAAC;IACxB,4EAA4E;IAC5E,eAAe,EAAE,OAAO,CAAC;IACzB,UAAU,EAAE,mBAAmB,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,kBAAkB;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC7B;AAeD,wBAAgB,oBAAoB,CAAC,IAAI,GAAE,kBAAuB;IAwBhE,QAAQ,QAAM,cAAc;IAC5B,SAAS,WAAW,MAAM,IAAI,GAAG,MAAM,IAAI;IAI3C,WAAW,QAAM,iBAAiB,GAAG,SAAS;IAC9C,WAAW,KAAK,iBAAiB,GAAG,SAAS,GAAG,IAAI;IAIpD,UAAU,UAAU,OAAO,GAAG,IAAI;IAGlC,OAAO,OAAO,aAAa,GAAG,IAAI;IAGlC,WAAW,IAAI,KAAK,GAAG,IAAI;IAG3B,UAAU,MAAM,MAAM,GAAG,IAAI;IAG7B,aAAa,aAAa,UAAU,GAAG,IAAI;IAG3C,gBAAgB,gBAAgB,aAAa,GAAG,IAAI;IAKpD,SAAS,IAAI,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI;IAGzC,SAAS,IAAI,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI;IAKlC,kBAAkB,IAAI,MAAM,GAAG,IAAI;IAGnC,kBAAkB,kBAAkB,OAAO,GAAG,IAAI;IAGlD,aAAa,aAAa,mBAAmB,GAAG,IAAI;IAGpD,OAAO,OAAO,MAAM,GAAG,SAAS,GAAG,IAAI;IAGvC,UAAU,UAAU,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,IAAI;EAIhE;AAED,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/character-store.js

@@ -0,0 +1,100 @@
+// The plugin's per-viewer state (never persisted as shapes — it is ephemeral, and
+// shared with others only through awareness). A tiny subscribe/notify store so the
+// layer, HUD and service all read the same source of truth.
+import { wrapDeg } from "@edv4h/usketch-shared";
+import { DEFAULT_MOTION, } from "./character-physics.js";
+const clamp01 = (v) => Math.min(1, Math.max(0, v));
+const positive = (v, fallback) => (Number.isFinite(v) && v > 0 ? v : fallback);
+function sanitizeMotion(m, base) {
+    return {
+        moveSpeed: positive(m.moveSpeed ?? base.moveSpeed, base.moveSpeed),
+        turnRate: positive(m.turnRate ?? base.turnRate, base.turnRate),
+        acceleration: positive(m.acceleration ?? base.acceleration, base.acceleration),
+        friction: positive(m.friction ?? base.friction, base.friction),
+        reverseRatio: clamp01(m.reverseRatio ?? base.reverseRatio),
+    };
+}
+export function createCharacterStore(init = {}) {
+    let state = {
+        enabled: init.enabled ?? false,
+        pose: { x: 0, y: 0, heading: 0, speed: 0, moving: false },
+        spawned: false,
+        cameraMode: init.cameraMode ?? "fixed",
+        controlScheme: init.controlScheme ?? "directional",
+        motion: sanitizeMotion(init.motion ?? {}, DEFAULT_MOTION),
+        anchor: { x: clamp01(init.anchor?.x ?? 0.5), y: clamp01(init.anchor?.y ?? 0.5) },
+        followSmoothing: Math.min(0.99, Math.max(0, init.followSmoothing ?? 0)),
+        followSuspended: false,
+        appearance: init.appearance ?? {},
+        name: init.name,
+        remotes: new Map(),
+    };
+    let renderer = init.renderer;
+    const listeners = new Set();
+    const set = (patch) => {
+        state = { ...state, ...patch };
+        for (const l of listeners)
+            l();
+    };
+    return {
+        getState: () => state,
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => listeners.delete(listener);
+        },
+        getRenderer: () => renderer,
+        setRenderer(fn) {
+            renderer = fn;
+            set({}); // re-render with the new look
+        },
+        setEnabled(enabled) {
+            if (enabled !== state.enabled)
+                set({ enabled, followSuspended: false });
+        },
+        setPose(pose) {
+            if (pose !== state.pose)
+                set({ pose, spawned: true });
+        },
+        setPosition(p) {
+            set({ pose: { ...state.pose, x: p.x, y: p.y, speed: 0, moving: false }, spawned: true });
+        },
+        setHeading(deg) {
+            set({ pose: { ...state.pose, heading: wrapDeg(deg) } });
+        },
+        setCameraMode(cameraMode) {
+            if (cameraMode !== state.cameraMode)
+                set({ cameraMode, followSuspended: false });
+        },
+        setControlScheme(controlScheme) {
+            if (controlScheme !== state.controlScheme) {
+                set({ controlScheme, pose: { ...state.pose, speed: 0, moving: false } });
+            }
+        },
+        setMotion(m) {
+            set({ motion: sanitizeMotion(m, state.motion) });
+        },
+        setAnchor(a) {
+            set({
+                anchor: { x: clamp01(a.x ?? state.anchor.x), y: clamp01(a.y ?? state.anchor.y) },
+            });
+        },
+        setFollowSmoothing(v) {
+            if (Number.isFinite(v))
+                set({ followSmoothing: Math.min(0.99, Math.max(0, v)) });
+        },
+        setFollowSuspended(followSuspended) {
+            if (followSuspended !== state.followSuspended)
+                set({ followSuspended });
+        },
+        setAppearance(appearance) {
+            set({ appearance });
+        },
+        setName(name) {
+            set({ name });
+        },
+        setRemotes(remotes) {
+            set({ remotes });
+        },
+    };
+}
+//# sourceMappingURL=character-store.js.map

package/dist/character-store.js.map

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

package/dist/character-sync.d.ts

@@ -0,0 +1,42 @@
+import type { CharacterStore } from "./character-store.js";
+import type { CharacterAppearance, RemoteCharacter } from "./character-types.js";
+/** The slice of a y-protocols `Awareness` this plugin uses. */
+export interface CharacterAwareness {
+    clientID: number;
+    setLocalStateField(field: string, value: unknown): void;
+    getStates(): Map<number, Record<string, unknown>>;
+    on(event: "change", handler: () => void): void;
+    off(event: "change", handler: () => void): void;
+}
+export declare const AWARENESS_FIELD = "character";
+/** The wire shape published under the `character` awareness field. */
+export interface CharacterWireState {
+    x: number;
+    y: number;
+    heading: number;
+    speed: number;
+    moving: boolean;
+    appearance: CharacterAppearance;
+    name?: string;
+}
+/** Validate an untrusted awareness payload (other clients can send anything). */
+export declare function parseWireState(v: unknown): CharacterWireState | null;
+/** Minimum interval between broadcasts (≈20 Hz) — remote views interpolate between. */
+export declare const BROADCAST_INTERVAL_MS = 50;
+export interface CharacterSync {
+    /** Publish the local character now if due (throttled) or `force`d. */
+    publish(force?: boolean): void;
+    /** Latest received remote targets (raw, not smoothed). */
+    targets(): ReadonlyMap<string, RemoteCharacter>;
+    dispose(): void;
+}
+export declare function createCharacterSync(awareness: CharacterAwareness, store: CharacterStore, onTargetsChanged: () => void, now?: () => number): CharacterSync;
+/**
+ * Ease displayed remote poses toward their latest targets (hides the ~20 Hz
+ * update steps). Returns the next display map and whether anything is still moving.
+ */
+export declare function easeRemotes(display: ReadonlyMap<string, RemoteCharacter>, targets: ReadonlyMap<string, RemoteCharacter>, alpha: number): {
+    next: Map<string, RemoteCharacter>;
+    settling: boolean;
+};
+//# sourceMappingURL=character-sync.d.ts.map

package/dist/character-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"character-sync.d.ts","sourceRoot":"","sources":["../src/character-sync.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEjF,+DAA+D;AAC/D,MAAM,WAAW,kBAAkB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACxD,SAAS,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAClD,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC/C,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CAChD;AAED,eAAO,MAAM,eAAe,cAAc,CAAC;AAE3C,sEAAsE;AACtE,MAAM,WAAW,kBAAkB;IAClC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,mBAAmB,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,GAAG,kBAAkB,GAAG,IAAI,CAsBpE;AAED,uFAAuF;AACvF,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,MAAM,WAAW,aAAa;IAC7B,sEAAsE;IACtE,OAAO,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/B,0DAA0D;IAC1D,OAAO,IAAI,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAChD,OAAO,IAAI,IAAI,CAAC;CAChB;AAED,wBAAgB,mBAAmB,CAClC,SAAS,EAAE,kBAAkB,EAC7B,KAAK,EAAE,cAAc,EACrB,gBAAgB,EAAE,MAAM,IAAI,EAC5B,GAAG,GAAE,MAAM,MAAyB,GAClC,aAAa,CAoDf;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAC1B,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,EAC7C,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,EAC7C,KAAK,EAAE,MAAM,GACX;IAAE,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAyB3D"}