hayao 0.2.0 → 0.3.0

package/dist/input/source.d.ts

@@ -1,4 +1,5 @@
-import { type InputMap } from './actions';
+import { type InputMap, type InputState } from './actions';
+import type { Vec2 } from '../core/math';
 export declare class KeyboardSource {
     private keysDown;
     /** Virtual action taps (from DOM buttons etc.) pending consumption by a step. */
@@ -23,3 +24,53 @@ export declare class KeyboardSource {
     setMap(map: InputMap): void;
     dispose(): void;
 }
+/** A live pointer reading, in DESIGN space (already un-letterboxed). */
+export interface PointerReadout {
+    /** Design-space x. Falls outside 0..width when the pointer leaves the letterbox. */
+    x: number;
+    y: number;
+    /** Is the primary pointer/finger currently pressed? */
+    down: boolean;
+    /** Has the pointer ever produced an event (else x/y are a neutral 0,0)? */
+    active: boolean;
+}
+/** What a PointerSource needs from a renderer: the DOM node + the design mapper. */
+export interface PointerTarget {
+    readonly element?: HTMLElement | SVGElement;
+    toDesign?(clientX: number, clientY: number): Vec2;
+}
+/**
+ * Continuous pointer / touch input — the sibling of KeyboardSource for games
+ * driven by *where* the cursor is (slice, aim, drag, point-and-click, placement).
+ * It listens on the renderer's canvas, converts every event to DESIGN space via
+ * `renderer.toDesign`, and each fixed step writes the sample into InputState's
+ * analog axes: `pointer.x`, `pointer.y`, `pointer.down` (1/0). Sim code then
+ * reads `world.input.axis('pointer.x')` — no out-of-engine letterbox glue.
+ *
+ * Determinism note: axes are host-sampled live input and are NOT part of the
+ * string input log or the world hash. `sample()` QUANTIZES design coords to a
+ * 1/8-px grid so a recorded axes log (Studio sessions) replays bit-exactly —
+ * the sim only ever sees the quantized values, live or replayed. For lockstep
+ * netplay, still prefer discrete actions (map a tap to a key via
+ * KeyboardSource.press, or snap position to a grid cell). See docs/CONVENTIONS.md.
+ */
+export declare class PointerSource {
+    private clientX;
+    private clientY;
+    private isDown;
+    private seen;
+    private target;
+    private el;
+    private onMove;
+    private onDown;
+    private onUp;
+    constructor(target: PointerTarget);
+    /** The current pointer position in design space + press state. */
+    read(): PointerReadout;
+    /**
+     * Write the current sample into an InputState's axes as pointer.x / pointer.y /
+     * pointer.down. Call once per step (the browser driver does this before advance).
+     */
+    sample(input: InputState): void;
+    dispose(): void;
+}