@edv4h/usketch-plugin-character 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 EdV4H
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,84 @@
+# @edv4h/usketch-plugin-character
+
+A controllable character for uSketch: place it at a chosen spot on screen, drive it
+with customizable keys (WASD by default), keep track of which way it faces, and have
+the camera follow it — either keeping the world upright or turning the world with
+the character's heading (racing view, via the Core viewport `rotation`). Other
+users' characters appear alongside yours through Yjs awareness.
+
+**The plugin draws nothing.** It computes positions and headings and hands them to
+your `renderCharacter`, so the look (sprite, car, avatar, labels, animation) is
+entirely the host's.
+
+```ts
+import { createCharacterPlugin } from "@edv4h/usketch-plugin-character";
+
+createCharacterPlugin({
+  renderCharacter: ({ screenHeading, appearance, name }) => (
+    <div style={{ transform: `rotate(${screenHeading}deg)`, color: String(appearance.color) }}>▲</div>
+  ),
+  appearance: { color: "#e44" },   // broadcast, so others draw you the same way
+  wsProvider,                      // optional: omit for single-player
+  userName: "Alice",
+  keys: { up: ["KeyW", "ArrowUp"] }, // KeyboardEvent.code values
+  cameraMode: "rotate",            // "fixed" | "rotate" | "free"
+  controlScheme: "vehicle",        // "directional" | "vehicle"
+  screenAnchor: { x: 0.5, y: 0.75 },
+});
+```
+
+## Concepts
+
+- **Heading**: degrees, `0` = up (world −y), clockwise-positive — the same convention
+  as CSS `rotate()` and the viewport `rotation`.
+- **Render props**: `heading` (world), `screenHeading` (= `heading + viewport.rotation`,
+  what to rotate a top-down sprite by), `moving`, `speed`, `zoom`, `appearance`,
+  `name`, `isSelf`, `id`. Each character is placed centered on its screen position
+  in one screen-space layer, so self and remote characters look the same under zoom
+  and camera rotation.
+- **Control schemes**
+  - `directional` — keys move in screen directions (camera-relative); the heading
+    turns toward the movement at `turnRate`. With the `rotate` camera, left/right
+    therefore circle (the camera follows the turn).
+  - `vehicle` — up/down throttle and reverse, left/right steer. Steering scales
+    with speed (a stopped car can't turn) and inverts in reverse.
+- **Camera modes**
+  - `fixed` — follow, world stays upright.
+  - `rotate` — follow and turn the world by `-heading` (character always faces up).
+  - `free` — don't move the camera.
+
+  Panning by hand pauses following; press a movement key to resume. Zooming keeps
+  following. Turning the character off turns the camera back upright.
+- **Multiplayer**: pass `wsProvider` (anything with a y-protocols `awareness`). Your
+  character is published under the `character` awareness field (~20 Hz, only when it
+  changes) and others are eased between updates. It's ephemeral: a character
+  vanishes when its owner disconnects or turns it off. Nothing is stored as shapes.
+- **Input**: held keys are tracked from window `keydown`/`keyup` (capture phase,
+  `event.code`), swallowed while the character is on so single-letter tool
+  shortcuts don't fire. Typing in text fields, and key chords with Ctrl/Cmd/Alt,
+  are ignored.
+
+## HUD
+
+A "キャラクター" settings group (on/off, camera, scheme, speed, turn rate, screen
+position, camera lag) plus actions to toggle the character and to place it at the
+screen position.
+
+## Service
+
+```ts
+import { getCharacterApi } from "@edv4h/usketch-plugin-character";
+
+const api = getCharacterApi(app.services);
+api?.enable();
+api?.setCameraMode("rotate");
+api?.setRenderer(myRenderer);
+api?.getPose(); // { x, y, heading, speed, moving }
+```
+
+## Limitations
+
+While the camera is rotated, overlays that compute screen positions themselves
+(snap guides, resize handles, connectors, comment badges, the background grid)
+are not rotation-aware yet. Tools that go through the Core `screenToWorld` get
+correct coordinates.

package/dist/character-camera.d.ts

@@ -0,0 +1,33 @@
+import { type Point, type Viewport } from "@edv4h/usketch-shared";
+/**
+ * - `fixed`:  follow; the world stays axis-aligned (rotation 0) and the character
+ *             turns on screen.
+ * - `rotate`: follow AND turn the world by `-heading`, so the character always
+ *             faces screen-up (racing view).
+ * - `free`:   don't touch the camera.
+ */
+export type CameraMode = "fixed" | "rotate" | "free";
+/** The smoothed camera target: the world point pinned to the anchor + rotation. */
+export interface CameraFocus {
+    focus: Point;
+    rotation: number;
+}
+/** The camera rotation a mode wants for a heading. */
+export declare function targetRotation(mode: CameraMode, heading: number): number;
+/**
+ * Frame-rate-independent smoothing factor: `smoothing` 0 = rigid (always 1),
+ * approaching 1 = heavier lag. It is the fraction LEFT after 1/60 s.
+ */
+export declare function smoothingAlpha(smoothing: number, dt: number): number;
+/** Ease `current` toward `target` by `alpha` (rotation the short way round). */
+export declare function easeFocus(current: CameraFocus, target: CameraFocus, alpha: number): CameraFocus;
+/** Screen-pixel anchor from a fractional anchor and the canvas size. */
+export declare function anchorPx(anchor: Point, size: {
+    width: number;
+    height: number;
+}): Point;
+/** The viewport that pins `cam.focus` to `anchor` (px) at `zoom`, turned by `cam.rotation`. */
+export declare function followViewport(cam: CameraFocus, anchor: Point, zoom: number): Viewport;
+/** True when two viewports are the same to within sub-pixel / sub-degree noise. */
+export declare function sameViewport(a: Viewport, b: Viewport): boolean;
+//# sourceMappingURL=character-camera.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"character-camera.d.ts","sourceRoot":"","sources":["../src/character-camera.ts"],"names":[],"mappings":"AAEA,OAAO,EACN,KAAK,KAAK,EAEV,KAAK,QAAQ,EAGb,MAAM,uBAAuB,CAAC;AAE/B;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAErD,mFAAmF;AACnF,MAAM,WAAW,WAAW;IAC3B,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,sDAAsD;AACtD,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAExE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAIpE;AAED,gFAAgF;AAChF,wBAAgB,SAAS,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAW/F;AAED,wEAAwE;AACxE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,KAAK,CAEtF;AAED,+FAA+F;AAC/F,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,CAEtF;AAED,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAO9D"}

package/dist/character-camera.js

@@ -0,0 +1,45 @@
+// Pure follow-camera math: where the viewport should be so the character sits at
+// its screen anchor, optionally turning the world so the character faces up.
+import { shortestAngleDelta, viewportAnchoredAt, wrapDeg, } from "@edv4h/usketch-shared";
+/** The camera rotation a mode wants for a heading. */
+export function targetRotation(mode, heading) {
+    return mode === "rotate" ? wrapDeg(-heading) : 0;
+}
+/**
+ * Frame-rate-independent smoothing factor: `smoothing` 0 = rigid (always 1),
+ * approaching 1 = heavier lag. It is the fraction LEFT after 1/60 s.
+ */
+export function smoothingAlpha(smoothing, dt) {
+    const s = Math.min(0.99, Math.max(0, smoothing));
+    if (s === 0)
+        return 1;
+    return 1 - s ** (dt * 60);
+}
+/** Ease `current` toward `target` by `alpha` (rotation the short way round). */
+export function easeFocus(current, target, alpha) {
+    if (alpha >= 1)
+        return target;
+    return {
+        focus: {
+            x: current.focus.x + (target.focus.x - current.focus.x) * alpha,
+            y: current.focus.y + (target.focus.y - current.focus.y) * alpha,
+        },
+        rotation: wrapDeg(current.rotation + shortestAngleDelta(current.rotation, target.rotation) * alpha),
+    };
+}
+/** Screen-pixel anchor from a fractional anchor and the canvas size. */
+export function anchorPx(anchor, size) {
+    return { x: anchor.x * size.width, y: anchor.y * size.height };
+}
+/** The viewport that pins `cam.focus` to `anchor` (px) at `zoom`, turned by `cam.rotation`. */
+export function followViewport(cam, anchor, zoom) {
+    return viewportAnchoredAt(cam.focus, anchor, zoom, cam.rotation);
+}
+/** True when two viewports are the same to within sub-pixel / sub-degree noise. */
+export function sameViewport(a, b) {
+    return (Math.abs(a.x - b.x) < 0.01 &&
+        Math.abs(a.y - b.y) < 0.01 &&
+        Math.abs(a.zoom - b.zoom) < 1e-6 &&
+        Math.abs(shortestAngleDelta(a.rotation ?? 0, b.rotation ?? 0)) < 1e-4);
+}
+//# sourceMappingURL=character-camera.js.map

package/dist/character-camera.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"character-camera.js","sourceRoot":"","sources":["../src/character-camera.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,6EAA6E;AAC7E,OAAO,EAEN,kBAAkB,EAElB,kBAAkB,EAClB,OAAO,GACP,MAAM,uBAAuB,CAAC;AAiB/B,sDAAsD;AACtD,MAAM,UAAU,cAAc,CAAC,IAAgB,EAAE,OAAe;IAC/D,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAClD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB,EAAE,EAAU;IAC3D,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;IACjD,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;AAC3B,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,SAAS,CAAC,OAAoB,EAAE,MAAmB,EAAE,KAAa;IACjF,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC;IAC9B,OAAO;QACN,KAAK,EAAE;YACN,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK;YAC/D,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK;SAC/D;QACD,QAAQ,EAAE,OAAO,CAChB,OAAO,CAAC,QAAQ,GAAG,kBAAkB,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,KAAK,CAChF;KACD,CAAC;AACH,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,QAAQ,CAAC,MAAa,EAAE,IAAuC;IAC9E,OAAO,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;AAChE,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,cAAc,CAAC,GAAgB,EAAE,MAAa,EAAE,IAAY;IAC3E,OAAO,kBAAkB,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;AAClE,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,YAAY,CAAC,CAAW,EAAE,CAAW;IACpD,OAAO,CACN,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;QAC1B,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;QAC1B,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI;QAChC,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,EAAE,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CACrE,CAAC;AACH,CAAC"}

package/dist/character-input.d.ts

@@ -0,0 +1,18 @@
+import type { MoveInput } from "./character-physics.js";
+import type { CharacterKeys } from "./character-types.js";
+export interface KeyInput {
+    /** The currently held directions. */
+    read(): MoveInput;
+    /** Whether any bound key is held. */
+    anyHeld(): boolean;
+    /** Replace the key bindings (held state is cleared). */
+    setKeys(keys: CharacterKeys): void;
+    dispose(): void;
+}
+/**
+ * Listen for the bound keys on `window`. `isActive()` gates everything: while it is
+ * false no key is captured (and none is swallowed). Held keys are cleared on window
+ * blur / tab hide so a key released elsewhere can't get stuck "down".
+ */
+export declare function createKeyInput(initialKeys: CharacterKeys, isActive: () => boolean): KeyInput;
+//# sourceMappingURL=character-input.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"character-input.d.ts","sourceRoot":"","sources":["../src/character-input.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,WAAW,QAAQ;IACxB,qCAAqC;IACrC,IAAI,IAAI,SAAS,CAAC;IAClB,qCAAqC;IACrC,OAAO,IAAI,OAAO,CAAC;IACnB,wDAAwD;IACxD,OAAO,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;IACnC,OAAO,IAAI,IAAI,CAAC;CAChB;AAuBD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,OAAO,GAAG,QAAQ,CA6D5F"}

package/dist/character-input.js

@@ -0,0 +1,89 @@
+/** `<input type>`s that don't take typed text (a focused HUD checkbox must not eat WASD). */
+const NON_TEXT_INPUTS = new Set([
+    "checkbox",
+    "radio",
+    "button",
+    "submit",
+    "reset",
+    "range",
+    "color",
+    "file",
+    "image",
+]);
+function isTextInput(target) {
+    const el = target;
+    if (!el || typeof el.tagName !== "string")
+        return false;
+    const tag = el.tagName;
+    if (tag === "INPUT")
+        return !NON_TEXT_INPUTS.has((el.type ?? "text").toLowerCase());
+    return tag === "TEXTAREA" || tag === "SELECT" || el.isContentEditable === true;
+}
+/**
+ * Listen for the bound keys on `window`. `isActive()` gates everything: while it is
+ * false no key is captured (and none is swallowed). Held keys are cleared on window
+ * blur / tab hide so a key released elsewhere can't get stuck "down".
+ */
+export function createKeyInput(initialKeys, isActive) {
+    let keys = initialKeys;
+    const held = new Set();
+    const directionOf = (code) => {
+        for (const dir of ["up", "down", "left", "right"]) {
+            if (keys[dir].includes(code))
+                return dir;
+        }
+        return null;
+    };
+    const onKeyDown = (e) => {
+        if (!isActive() || isTextInput(e.target))
+            return;
+        if (e.ctrlKey || e.metaKey || e.altKey)
+            return; // leave chords (Cmd+S …) alone
+        if (!directionOf(e.code))
+            return;
+        held.add(e.code);
+        e.preventDefault();
+        e.stopImmediatePropagation();
+    };
+    const onKeyUp = (e) => {
+        if (!held.delete(e.code))
+            return;
+        e.preventDefault();
+        e.stopImmediatePropagation();
+    };
+    const clear = () => held.clear();
+    const onVisibility = () => {
+        if (typeof document !== "undefined" && document.hidden)
+            clear();
+    };
+    const hasWindow = typeof window !== "undefined";
+    if (hasWindow) {
+        window.addEventListener("keydown", onKeyDown, true);
+        window.addEventListener("keyup", onKeyUp, true);
+        window.addEventListener("blur", clear);
+        document.addEventListener("visibilitychange", onVisibility);
+    }
+    const isHeld = (dir) => keys[dir].some((c) => held.has(c));
+    return {
+        read: () => ({
+            up: isHeld("up"),
+            down: isHeld("down"),
+            left: isHeld("left"),
+            right: isHeld("right"),
+        }),
+        anyHeld: () => held.size > 0,
+        setKeys(next) {
+            keys = next;
+            held.clear();
+        },
+        dispose() {
+            if (!hasWindow)
+                return;
+            window.removeEventListener("keydown", onKeyDown, true);
+            window.removeEventListener("keyup", onKeyUp, true);
+            window.removeEventListener("blur", clear);
+            document.removeEventListener("visibilitychange", onVisibility);
+        },
+    };
+}
+//# sourceMappingURL=character-input.js.map

package/dist/character-input.js.map

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

package/dist/character-layer.d.ts

@@ -0,0 +1,7 @@
+import { type Viewport } from "@edv4h/usketch-shared";
+import type { CharacterStore } from "./character-store.js";
+export declare function CharacterLayer({ store, viewport }: {
+    store: CharacterStore;
+    viewport: Viewport;
+}): import("react").JSX.Element | null;
+//# sourceMappingURL=character-layer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"character-layer.d.ts","sourceRoot":"","sources":["../src/character-layer.tsx"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,QAAQ,EAA4C,MAAM,uBAAuB,CAAC;AAEhG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AA0B3D,wBAAgB,cAAc,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;IAAE,KAAK,EAAE,cAAc,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,sCAuDhG"}

package/dist/character-layer.js

@@ -0,0 +1,53 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// The one fixed (screen-space) layer that places every character — self and remote
+// — at `worldToScreen(position)`. It draws NOTHING itself: each spot is a zero-size,
+// pointer-transparent wrapper whose content is the host's `renderCharacter`. One
+// screen-space layer keeps self/remote consistent (same size under zoom, same
+// `screenHeading` math under camera rotation).
+import { viewportRotation, worldToScreen, wrapDeg } from "@edv4h/usketch-shared";
+import { useSyncExternalStore } from "react";
+function Spot({ x, y, renderer, props, }) {
+    return (_jsx("div", { "data-character-id": props.id, style: { position: "absolute", left: x, top: y, width: 0, height: 0, pointerEvents: "none" }, children: _jsx("div", { style: { position: "absolute", left: 0, top: 0, transform: "translate(-50%, -50%)" }, children: renderer(props) }) }));
+}
+export function CharacterLayer({ store, viewport }) {
+    const state = useSyncExternalStore(store.subscribe, store.getState, store.getState);
+    const renderer = store.getRenderer();
+    if (!renderer)
+        return null; // headless: no look supplied → draw nothing
+    const rot = viewportRotation(viewport);
+    const spots = [];
+    for (const r of state.remotes.values()) {
+        const p = worldToScreen(r.x, r.y, viewport);
+        spots.push(_jsx(Spot, { x: p.x, y: p.y, renderer: renderer, props: {
+                id: r.id,
+                isSelf: false,
+                heading: r.heading,
+                screenHeading: wrapDeg(r.heading + rot),
+                moving: r.moving,
+                speed: r.speed,
+                zoom: viewport.zoom,
+                appearance: r.appearance,
+                name: r.name,
+            } }, `remote-${r.id}`));
+    }
+    if (state.enabled && state.spawned) {
+        const { pose } = state;
+        const p = worldToScreen(pose.x, pose.y, viewport);
+        // Self last → drawn on top of the others.
+        spots.push(_jsx(Spot, { x: p.x, y: p.y, renderer: renderer, props: {
+                id: "self",
+                isSelf: true,
+                heading: pose.heading,
+                screenHeading: wrapDeg(pose.heading + rot),
+                moving: pose.moving,
+                speed: pose.speed,
+                zoom: viewport.zoom,
+                appearance: state.appearance,
+                name: state.name,
+            } }, "self"));
+    }
+    if (spots.length === 0)
+        return null;
+    return _jsx("div", { style: { position: "absolute", inset: 0, pointerEvents: "none" }, children: spots });
+}
+//# sourceMappingURL=character-layer.js.map

package/dist/character-layer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"character-layer.js","sourceRoot":"","sources":["../src/character-layer.tsx"],"names":[],"mappings":";AAAA,mFAAmF;AACnF,qFAAqF;AACrF,iFAAiF;AACjF,8EAA8E;AAC9E,+CAA+C;AAC/C,OAAO,EAAiB,gBAAgB,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChG,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAI7C,SAAS,IAAI,CAAC,EACb,CAAC,EACD,CAAC,EACD,QAAQ,EACR,KAAK,GAML;IACA,OAAO,CACN,mCACoB,KAAK,CAAC,EAAE,EAC3B,KAAK,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,aAAa,EAAE,MAAM,EAAE,YAE5F,cAAK,KAAK,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,SAAS,EAAE,uBAAuB,EAAE,YACvF,QAAQ,CAAC,KAAK,CAAC,GACX,GACD,CACN,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAiD;IAChG,MAAM,KAAK,GAAG,oBAAoB,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACpF,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IACrC,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC,CAAC,4CAA4C;IAExE,MAAM,GAAG,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,EAAE,CAAC;IACjB,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QACxC,MAAM,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QAC5C,KAAK,CAAC,IAAI,CACT,KAAC,IAAI,IAEJ,CAAC,EAAE,CAAC,CAAC,CAAC,EACN,CAAC,EAAE,CAAC,CAAC,CAAC,EACN,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE;gBACN,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,MAAM,EAAE,KAAK;gBACb,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,GAAG,GAAG,CAAC;gBACvC,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,UAAU,EAAE,CAAC,CAAC,UAAU;gBACxB,IAAI,EAAE,CAAC,CAAC,IAAI;aACZ,IAdI,UAAU,CAAC,CAAC,EAAE,EAAE,CAepB,CACF,CAAC;IACH,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QACpC,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;QACvB,MAAM,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QAClD,0CAA0C;QAC1C,KAAK,CAAC,IAAI,CACT,KAAC,IAAI,IAEJ,CAAC,EAAE,CAAC,CAAC,CAAC,EACN,CAAC,EAAE,CAAC,CAAC,CAAC,EACN,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE;gBACN,EAAE,EAAE,MAAM;gBACV,MAAM,EAAE,IAAI;gBACZ,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,aAAa,EAAE,OAAO,CAAC,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC;gBAC1C,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,IAAI,EAAE,KAAK,CAAC,IAAI;aAChB,IAdG,MAAM,CAeT,CACF,CAAC;IACH,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,OAAO,cAAK,KAAK,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,EAAE,aAAa,EAAE,MAAM,EAAE,YAAG,KAAK,GAAO,CAAC;AAC7F,CAAC"}

package/dist/character-physics.d.ts

@@ -0,0 +1,55 @@
+export type ControlScheme = "directional" | "vehicle";
+/** Which movement directions are currently held. */
+export interface MoveInput {
+    up: boolean;
+    down: boolean;
+    left: boolean;
+    right: boolean;
+}
+export declare const NO_INPUT: MoveInput;
+export interface CharacterPose {
+    /** World position. */
+    x: number;
+    y: number;
+    /** Facing, degrees (0 = up / -y, clockwise). */
+    heading: number;
+    /** Signed speed along the heading, world units / s (negative = reversing). */
+    speed: number;
+    /** Whether the character moved this step. */
+    moving: boolean;
+}
+export interface MotionParams {
+    /** Top speed, world units / s. */
+    moveSpeed: number;
+    /** Turn rate, degrees / s. */
+    turnRate: number;
+    /** Vehicle: throttle acceleration, world units / s². */
+    acceleration: number;
+    /** Vehicle: coasting / braking deceleration, world units / s². */
+    friction: number;
+    /** Vehicle: reverse top speed as a fraction of `moveSpeed`. */
+    reverseRatio: number;
+}
+export declare const DEFAULT_MOTION: MotionParams;
+/** Unit vector of a heading in world space (0° → (0, -1), 90° → (1, 0)). */
+export declare function headingVector(deg: number): {
+    x: number;
+    y: number;
+};
+/** Heading (degrees) of a non-zero world vector. */
+export declare function vectorHeading(x: number, y: number): number;
+/** Move `from` toward `to` by at most `maxStep` degrees, the short way round. */
+export declare function turnToward(from: number, to: number, maxStep: number): number;
+/**
+ * Advance `pose` by `dt` seconds.
+ *
+ * - `directional`: the held keys give a SCREEN-space direction (up = screen up),
+ *   turned into world space through the camera rotation; the character moves that
+ *   way at `moveSpeed` and its heading turns toward it at `turnRate`. (Turning
+ *   rather than snapping keeps a heading-following camera from spinning.)
+ * - `vehicle`: up/down are throttle/reverse along the heading, left/right steer.
+ *   Steering authority scales with speed (a stopped car can't turn) and inverts
+ *   when reversing, like a car.
+ */
+export declare function stepCharacter(pose: CharacterPose, input: MoveInput, dt: number, scheme: ControlScheme, params: MotionParams, cameraRotation?: number): CharacterPose;
+//# sourceMappingURL=character-physics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"character-physics.d.ts","sourceRoot":"","sources":["../src/character-physics.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG,SAAS,CAAC;AAEtD,oDAAoD;AACpD,MAAM,WAAW,SAAS;IACzB,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CACf;AAED,eAAO,MAAM,QAAQ,EAAE,SAAiE,CAAC;AAEzF,MAAM,WAAW,aAAa;IAC7B,sBAAsB;IACtB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,MAAM,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC5B,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,YAAY,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,cAAc,EAAE,YAM5B,CAAC;AAEF,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAGnE;AAED,oDAAoD;AACpD,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,iFAAiF;AACjF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAI5E;AAOD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC5B,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,SAAS,EAChB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,YAAY,EACpB,cAAc,SAAI,GAChB,aAAa,CAoDf"}

package/dist/character-physics.js

@@ -0,0 +1,97 @@
+// Pure motion model (no React / DOM): input + dt → next pose. Headings are degrees,
+// 0 = up (world -y), clockwise-positive — the same convention as CSS `rotate()` and
+// the Core viewport `rotation`, so `screenHeading = heading + viewport.rotation`.
+import { shortestAngleDelta, wrapDeg } from "@edv4h/usketch-shared";
+export const NO_INPUT = { up: false, down: false, left: false, right: false };
+export const DEFAULT_MOTION = {
+    moveSpeed: 400,
+    turnRate: 240,
+    acceleration: 900,
+    friction: 700,
+    reverseRatio: 0.5,
+};
+/** Unit vector of a heading in world space (0° → (0, -1), 90° → (1, 0)). */
+export function headingVector(deg) {
+    const rad = (deg * Math.PI) / 180;
+    return { x: Math.sin(rad), y: -Math.cos(rad) };
+}
+/** Heading (degrees) of a non-zero world vector. */
+export function vectorHeading(x, y) {
+    return wrapDeg((Math.atan2(x, -y) * 180) / Math.PI);
+}
+/** Move `from` toward `to` by at most `maxStep` degrees, the short way round. */
+export function turnToward(from, to, maxStep) {
+    const d = shortestAngleDelta(from, to);
+    if (Math.abs(d) <= maxStep)
+        return wrapDeg(to);
+    return wrapDeg(from + Math.sign(d) * maxStep);
+}
+function approach(v, target, step) {
+    if (v < target)
+        return Math.min(target, v + step);
+    return Math.max(target, v - step);
+}
+/**
+ * Advance `pose` by `dt` seconds.
+ *
+ * - `directional`: the held keys give a SCREEN-space direction (up = screen up),
+ *   turned into world space through the camera rotation; the character moves that
+ *   way at `moveSpeed` and its heading turns toward it at `turnRate`. (Turning
+ *   rather than snapping keeps a heading-following camera from spinning.)
+ * - `vehicle`: up/down are throttle/reverse along the heading, left/right steer.
+ *   Steering authority scales with speed (a stopped car can't turn) and inverts
+ *   when reversing, like a car.
+ */
+export function stepCharacter(pose, input, dt, scheme, params, cameraRotation = 0) {
+    if (dt <= 0)
+        return pose;
+    if (scheme === "directional") {
+        const sx = (input.right ? 1 : 0) - (input.left ? 1 : 0);
+        const sy = (input.down ? 1 : 0) - (input.up ? 1 : 0);
+        if (sx === 0 && sy === 0) {
+            return pose.moving || pose.speed !== 0 ? { ...pose, speed: 0, moving: false } : pose;
+        }
+        // Screen direction → world direction: undo the camera rotation.
+        const target = wrapDeg(vectorHeading(sx, sy) - cameraRotation);
+        const dir = headingVector(target);
+        const dist = params.moveSpeed * dt;
+        return {
+            x: pose.x + dir.x * dist,
+            y: pose.y + dir.y * dist,
+            heading: turnToward(pose.heading, target, params.turnRate * dt),
+            speed: params.moveSpeed,
+            moving: true,
+        };
+    }
+    const throttle = (input.up ? 1 : 0) - (input.down ? 1 : 0);
+    let speed = pose.speed;
+    if (throttle > 0) {
+        // Braking from reverse uses friction + throttle for a snappier stop.
+        const accel = speed < 0 ? params.acceleration + params.friction : params.acceleration;
+        speed = approach(speed, params.moveSpeed, accel * dt);
+    }
+    else if (throttle < 0) {
+        const accel = speed > 0 ? params.acceleration + params.friction : params.acceleration;
+        speed = approach(speed, -params.moveSpeed * params.reverseRatio, accel * dt);
+    }
+    else {
+        speed = approach(speed, 0, params.friction * dt);
+    }
+    const steer = (input.right ? 1 : 0) - (input.left ? 1 : 0);
+    const authority = Math.min(1, (Math.abs(speed) / Math.max(1, params.moveSpeed)) * 3);
+    const heading = steer === 0 || authority === 0
+        ? pose.heading
+        : wrapDeg(pose.heading + steer * Math.sign(speed) * authority * params.turnRate * dt);
+    if (speed === 0 && heading === pose.heading) {
+        return pose.moving || pose.speed !== 0 ? { ...pose, speed: 0, moving: false } : pose;
+    }
+    const dir = headingVector(heading);
+    return {
+        x: pose.x + dir.x * speed * dt,
+        y: pose.y + dir.y * speed * dt,
+        heading,
+        speed,
+        moving: speed !== 0,
+    };
+}
+//# sourceMappingURL=character-physics.js.map

package/dist/character-physics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"character-physics.js","sourceRoot":"","sources":["../src/character-physics.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,oFAAoF;AACpF,kFAAkF;AAClF,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAYpE,MAAM,CAAC,MAAM,QAAQ,GAAc,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AA2BzF,MAAM,CAAC,MAAM,cAAc,GAAiB;IAC3C,SAAS,EAAE,GAAG;IACd,QAAQ,EAAE,GAAG;IACb,YAAY,EAAE,GAAG;IACjB,QAAQ,EAAE,GAAG;IACb,YAAY,EAAE,GAAG;CACjB,CAAC;AAEF,4EAA4E;AAC5E,MAAM,UAAU,aAAa,CAAC,GAAW;IACxC,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC;IAClC,OAAO,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;AAChD,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,aAAa,CAAC,CAAS,EAAE,CAAS;IACjD,OAAO,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;AACrD,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,EAAU,EAAE,OAAe;IACnE,MAAM,CAAC,GAAG,kBAAkB,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACvC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC,EAAE,CAAC,CAAC;IAC/C,OAAO,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,QAAQ,CAAC,CAAS,EAAE,MAAc,EAAE,IAAY;IACxD,IAAI,CAAC,GAAG,MAAM;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;IAClD,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAC5B,IAAmB,EACnB,KAAgB,EAChB,EAAU,EACV,MAAqB,EACrB,MAAoB,EACpB,cAAc,GAAG,CAAC;IAElB,IAAI,EAAE,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,MAAM,KAAK,aAAa,EAAE,CAAC;QAC9B,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACxD,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACrD,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACtF,CAAC;QACD,gEAAgE;QAChE,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,cAAc,CAAC,CAAC;QAC/D,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;QAClC,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,GAAG,EAAE,CAAC;QACnC,OAAO;YACN,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,IAAI;YACxB,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,IAAI;YACxB,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,QAAQ,GAAG,EAAE,CAAC;YAC/D,KAAK,EAAE,MAAM,CAAC,SAAS;YACvB,MAAM,EAAE,IAAI;SACZ,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3D,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACvB,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QAClB,qEAAqE;QACrE,MAAM,KAAK,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC;QACtF,KAAK,GAAG,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,KAAK,GAAG,EAAE,CAAC,CAAC;IACvD,CAAC;SAAM,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC;QACtF,KAAK,GAAG,QAAQ,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,SAAS,GAAG,MAAM,CAAC,YAAY,EAAE,KAAK,GAAG,EAAE,CAAC,CAAC;IAC9E,CAAC;SAAM,CAAC;QACP,KAAK,GAAG,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,MAAM,CAAC,QAAQ,GAAG,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACrF,MAAM,OAAO,GACZ,KAAK,KAAK,CAAC,IAAI,SAAS,KAAK,CAAC;QAC7B,CAAC,CAAC,IAAI,CAAC,OAAO;QACd,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,GAAG,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,SAAS,GAAG,MAAM,CAAC,QAAQ,GAAG,EAAE,CAAC,CAAC;IAExF,IAAI,KAAK,KAAK,CAAC,IAAI,OAAO,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;QAC7C,OAAO,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACtF,CAAC;IACD,MAAM,GAAG,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACnC,OAAO;QACN,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,KAAK,GAAG,EAAE;QAC9B,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,KAAK,GAAG,EAAE;QAC9B,OAAO;QACP,KAAK;QACL,MAAM,EAAE,KAAK,KAAK,CAAC;KACnB,CAAC;AACH,CAAC"}

package/dist/character-runtime.d.ts

@@ -0,0 +1,30 @@
+import { type PluginContext, type Point } from "@edv4h/usketch-shared";
+import type { CharacterStore } from "./character-store.js";
+import { type CharacterAwareness } from "./character-sync.js";
+import type { CharacterKeys } from "./character-types.js";
+export declare const CHARACTER_LAYER_ID = "character";
+/** `viewport:claimed` priority: above start-position (10), below deep links (100). */
+export declare const CHARACTER_VIEWPORT_PRIORITY = 20;
+/**
+ * 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 declare function canvasSize(): {
+    width: number;
+    height: number;
+};
+export interface CharacterRuntimeOptions {
+    keys: CharacterKeys;
+    awareness?: CharacterAwareness;
+}
+export interface CharacterRuntime {
+    /** Move the character to the world point under its screen anchor. */
+    placeAtAnchor(): void;
+    /** The screen-px anchor (for rotating the camera about the character's spot). */
+    anchorPoint(): Point;
+    setKeys(keys: CharacterKeys): void;
+    dispose(): void;
+}
+export declare function setupCharacterRuntime(ctx: PluginContext, store: CharacterStore, options: CharacterRuntimeOptions): CharacterRuntime;
+//# sourceMappingURL=character-runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"character-runtime.d.ts","sourceRoot":"","sources":["../src/character-runtime.tsx"],"names":[],"mappings":"AAGA,OAAO,EACN,KAAK,aAAa,EAClB,KAAK,KAAK,EAIV,MAAM,uBAAuB,CAAC;AAa/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EACN,KAAK,kBAAkB,EAIvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,aAAa,EAAmB,MAAM,sBAAsB,CAAC;AAE3E,eAAO,MAAM,kBAAkB,cAAc,CAAC;AAG9C,sFAAsF;AACtF,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAe9C;;;;GAIG;AACH,wBAAgB,UAAU,IAAI;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAkB9D;AAED,MAAM,WAAW,uBAAuB;IACvC,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,CAAC,EAAE,kBAAkB,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAChC,qEAAqE;IACrE,aAAa,IAAI,IAAI,CAAC;IACtB,iFAAiF;IACjF,WAAW,IAAI,KAAK,CAAC;IACrB,OAAO,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;IACnC,OAAO,IAAI,IAAI,CAAC;CAChB;AAED,wBAAgB,qBAAqB,CACpC,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,uBAAuB,GAC9B,gBAAgB,CAmKlB"}