@363045841yyt/klinechart-core 0.8.11-alpha.0 → 0.8.12

package/dist/input/gesture.js

@@ -0,0 +1,249 @@
+/**
+ * Pointer gesture recognizer — 1-pointer pan/swipe + 2-pointer pinch.
+ *
+ * Pure-data state machine: no DOM. Consumers feed `PointerEventLike`
+ * records via `onPointerDown` / `onPointerMove` / `onPointerUp`, and
+ * read recognized gestures off the `events` signal.
+ *
+ * The recognizer is **framework-agnostic** for the same reason as the
+ * shortcut registry: every consumer touches a different event surface
+ * (`PointerEvent`, `MouseEvent`, `TouchEvent`, synthetic events from a
+ * Vue composable). Defining the minimal `PointerEventLike` interface
+ * means none of them have to adapt to ours — they adapt to themselves
+ * and hand us the four fields we need.
+ *
+ * State diagram (simplified):
+ *
+ *     idle ──[1 down]──▶ tracking (1 pointer)
+ *      ▲                      │ ├──[move past deadzone]──▶ pan
+ *      │                      │ ├──[up + velocity > min]──▶ swipe → idle
+ *      │                      │ └──[up + small move]──▶ tap → idle
+ *      │                      │
+ *      │                      └─[2nd down]──▶ pinch (2 pointers)
+ *      │                                      │
+ *      └─[all up / cancel]────────────────────┘
+ *
+ * Pan / pinch emit continuous deltas. Tap and swipe are terminal.
+ *
+ * Why no long-press / double-tap in v1: those are heuristic-laden and
+ * usually better delegated to the host platform. The four gestures
+ * above cover 95 % of finance-chart interactions (pan to scroll
+ * history, pinch to zoom, swipe to flick-scroll, tap to inspect).
+ */
+import { createSignal } from '../reactivity';
+import { KLineChartError } from '../errors';
+// ---------------------------------------------------------------------------
+// Implementation
+// ---------------------------------------------------------------------------
+const DEFAULT_OPTS = {
+    panDeadzone: 6,
+    swipeMinVelocity: 0.5,
+    swipeVelocityWindowMs: 100,
+};
+export function createGestureRecognizer(opts = {}) {
+    if (opts.panDeadzone !== undefined && opts.panDeadzone < 0) {
+        throw new KLineChartError('INVALID_PARAM', `createGestureRecognizer: panDeadzone must be >= 0, got ${opts.panDeadzone}`);
+    }
+    if (opts.swipeMinVelocity !== undefined && opts.swipeMinVelocity < 0) {
+        throw new KLineChartError('INVALID_PARAM', `createGestureRecognizer: swipeMinVelocity must be >= 0, got ${opts.swipeMinVelocity}`);
+    }
+    const cfg = { ...DEFAULT_OPTS, ...opts };
+    const state = createSignal('idle');
+    const events = createSignal(null);
+    let disposed = false;
+    const active = new Map();
+    // pinchStartDistance captured when transitioning into 'pinch'
+    let pinchStartDistance = 0;
+    function emit(event) {
+        if (disposed)
+            return;
+        events.set(event);
+    }
+    function dist(a, b) {
+        const dx = a.lastX - b.lastX;
+        const dy = a.lastY - b.lastY;
+        return Math.sqrt(dx * dx + dy * dy);
+    }
+    function centroid(a, b) {
+        return { cx: (a.lastX + b.lastX) / 2, cy: (a.lastY + b.lastY) / 2 };
+    }
+    function pushHistory(p, e) {
+        p.history.push({ x: e.x, y: e.y, ts: e.timestamp });
+        // Trim history older than the velocity window from the latest
+        const cutoff = e.timestamp - cfg.swipeVelocityWindowMs;
+        while (p.history.length > 0 && p.history[0].ts < cutoff) {
+            p.history.shift();
+        }
+    }
+    function recentVelocity(p) {
+        if (p.history.length < 2)
+            return { vx: 0, vy: 0 };
+        const first = p.history[0];
+        const last = p.history[p.history.length - 1];
+        const dt = last.ts - first.ts;
+        if (dt <= 0)
+            return { vx: 0, vy: 0 };
+        return { vx: (last.x - first.x) / dt, vy: (last.y - first.y) / dt };
+    }
+    function onPointerDown(e) {
+        if (disposed)
+            return;
+        const p = {
+            pointerId: e.pointerId,
+            startX: e.x,
+            startY: e.y,
+            startTs: e.timestamp,
+            lastX: e.x,
+            lastY: e.y,
+            lastTs: e.timestamp,
+            history: [{ x: e.x, y: e.y, ts: e.timestamp }],
+        };
+        active.set(e.pointerId, p);
+        if (active.size === 1) {
+            state.set('tracking');
+        }
+        else if (active.size === 2) {
+            const [a, b] = [...active.values()];
+            const c = centroid(a, b);
+            pinchStartDistance = Math.max(dist(a, b), 1e-9);
+            state.set('pinch');
+            emit({
+                type: 'pinchStart',
+                cx: c.cx,
+                cy: c.cy,
+                distance: pinchStartDistance,
+                timestamp: e.timestamp,
+            });
+        }
+        // Extra pointers (3+) are ignored — we don't recognise 3-finger
+        // gestures in v1.
+    }
+    function onPointerMove(e) {
+        if (disposed)
+            return;
+        const p = active.get(e.pointerId);
+        if (p === undefined)
+            return;
+        const dx = e.x - p.lastX;
+        const dy = e.y - p.lastY;
+        p.lastX = e.x;
+        p.lastY = e.y;
+        p.lastTs = e.timestamp;
+        pushHistory(p, e);
+        if (state.peek() === 'pinch' && active.size >= 2) {
+            const [a, b] = [...active.values()];
+            const c = centroid(a, b);
+            const d = dist(a, b);
+            emit({
+                type: 'pinch',
+                cx: c.cx,
+                cy: c.cy,
+                distance: d,
+                scale: d / pinchStartDistance,
+                timestamp: e.timestamp,
+            });
+            return;
+        }
+        // Single-pointer path: maybe promote tracking → pan
+        if (state.peek() === 'tracking') {
+            const ddx = e.x - p.startX;
+            const ddy = e.y - p.startY;
+            if (Math.sqrt(ddx * ddx + ddy * ddy) > cfg.panDeadzone) {
+                state.set('pan');
+                emit({ type: 'panStart', x: e.x, y: e.y, timestamp: e.timestamp });
+                // Also emit the first pan event right away. dx/dy carry
+                // the full delta from the down position so the consumer
+                // doesn't have to wait for a second move to react.
+                emit({
+                    type: 'pan',
+                    x: e.x,
+                    y: e.y,
+                    dx: ddx,
+                    dy: ddy,
+                    timestamp: e.timestamp,
+                });
+            }
+            return;
+        }
+        if (state.peek() === 'pan') {
+            emit({ type: 'pan', x: e.x, y: e.y, dx, dy, timestamp: e.timestamp });
+        }
+    }
+    function onPointerUp(e) {
+        if (disposed)
+            return;
+        const p = active.get(e.pointerId);
+        if (p === undefined)
+            return;
+        if (state.peek() === 'pinch') {
+            // Decommit pinch; if exactly one pointer remains, drop back into
+            // 'tracking' on it (the remaining finger can still pan).
+            active.delete(e.pointerId);
+            const remaining = active.values().next().value;
+            const c = remaining
+                ? { cx: remaining.lastX, cy: remaining.lastY }
+                : { cx: e.x, cy: e.y };
+            emit({ type: 'pinchEnd', cx: c.cx, cy: c.cy, timestamp: e.timestamp });
+            if (active.size === 1 && remaining !== undefined) {
+                // Re-baseline the remaining pointer so panDeadzone applies
+                // afresh and we don't immediately fall into a pan-tracking
+                // weirdness using the original press position.
+                remaining.startX = remaining.lastX;
+                remaining.startY = remaining.lastY;
+                remaining.startTs = e.timestamp;
+                remaining.history = [
+                    { x: remaining.lastX, y: remaining.lastY, ts: e.timestamp },
+                ];
+                state.set('tracking');
+            }
+            else {
+                state.set('idle');
+            }
+            return;
+        }
+        // Single-pointer end paths: tap, swipe, panEnd, or just clean up.
+        active.delete(e.pointerId);
+        const ddx = p.lastX - p.startX;
+        const ddy = p.lastY - p.startY;
+        const distMoved = Math.sqrt(ddx * ddx + ddy * ddy);
+        if (state.peek() === 'pan') {
+            const { vx, vy } = recentVelocity(p);
+            const speed = Math.sqrt(vx * vx + vy * vy);
+            if (speed >= cfg.swipeMinVelocity) {
+                emit({
+                    type: 'swipe',
+                    x: e.x,
+                    y: e.y,
+                    vx,
+                    vy,
+                    timestamp: e.timestamp,
+                });
+            }
+            else {
+                emit({ type: 'panEnd', x: e.x, y: e.y, timestamp: e.timestamp });
+            }
+        }
+        else if (state.peek() === 'tracking') {
+            if (distMoved <= cfg.panDeadzone) {
+                emit({ type: 'tap', x: e.x, y: e.y, timestamp: e.timestamp });
+            }
+            // else: aborted gesture, no emit (movement was below deadzone
+            // forever; nothing meaningful happened)
+        }
+        state.set(active.size === 0 ? 'idle' : 'tracking');
+    }
+    function cancel() {
+        if (disposed)
+            return;
+        active.clear();
+        state.set('idle');
+    }
+    function dispose() {
+        if (disposed)
+            return;
+        disposed = true;
+        active.clear();
+    }
+    return { state, events, onPointerDown, onPointerMove, onPointerUp, cancel, dispose };
+}
+//# sourceMappingURL=gesture.js.map

package/dist/input/gesture.js.map

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

package/dist/input/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @klinechart-quant/core/input — framework-agnostic input layer.
+ *
+ * Shipping module: {@link createShortcutRegistry}. See `./keyboard.ts`
+ * for the design notes.
+ */
+export { createShortcutRegistry, parseCombo, canonicalCombo, type ShortcutRegistry, type ShortcutRegistryOptions, type ShortcutDef, type ParsedCombo, type ModifierState, type KeyboardEventLike, } from './keyboard';
+export { createGestureRecognizer, type GestureRecognizer, type GestureRecognizerOptions, type GestureEvent, type GestureState, type PointerEventLike, } from './gesture';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/input/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACH,sBAAsB,EACtB,UAAU,EACV,cAAc,EACd,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,iBAAiB,GACzB,MAAM,YAAY,CAAA;AACnB,OAAO,EACH,uBAAuB,EACvB,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,gBAAgB,GACxB,MAAM,WAAW,CAAA"}

package/dist/input/index.js

@@ -0,0 +1,9 @@
+/**
+ * @klinechart-quant/core/input — framework-agnostic input layer.
+ *
+ * Shipping module: {@link createShortcutRegistry}. See `./keyboard.ts`
+ * for the design notes.
+ */
+export { createShortcutRegistry, parseCombo, canonicalCombo, } from './keyboard';
+export { createGestureRecognizer, } from './gesture';
+//# sourceMappingURL=index.js.map

package/dist/input/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/input/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACH,sBAAsB,EACtB,UAAU,EACV,cAAc,GAOjB,MAAM,YAAY,CAAA;AACnB,OAAO,EACH,uBAAuB,GAM1B,MAAM,WAAW,CAAA"}

package/dist/input/keyboard.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Keyboard shortcut registry — framework-agnostic, signal-based.
+ *
+ * Why this exists: every chart library either hard-codes shortcuts (TV-style
+ * inflexibility) or punts to the host app (every adapter reinvents the
+ * wheel). The registry below is the shared primitive: controllers and
+ * adapters publish `ShortcutDef[]`s, host apps query by combo, and the
+ * normalisation/conflict layer lives in one place.
+ *
+ * Design choices:
+ *
+ *   - Combos are STRINGS like `'Mod+K'`, `'Shift+ArrowRight'`,
+ *     `'Alt+Mod+0'`. Parsed deterministically; whitespace ignored;
+ *     modifier order in the source doesn't matter (`'Shift+Mod+K'`
+ *     and `'Mod+Shift+K'` normalise to the same canonical form).
+ *
+ *   - `Mod` is platform-agnostic: maps to `Meta` on macOS and `Ctrl`
+ *     elsewhere. Host apps query with their own `KeyboardEvent` and
+ *     the registry hands back the matching shortcut.
+ *
+ *   - Conflict detection: registering two `ShortcutDef`s with the same
+ *     normalised combo throws `KLineChartError('INPUT_SHORTCUT_CONFLICT')`.
+ *     Pulls the prior registration into the error message so the
+ *     developer sees both ids.
+ *
+ *   - The signal-based shape mirrors every other controller in this
+ *     package (alerts, indicators, drawing). Subscribers — typically
+ *     a debug-overlay or settings UI — see the live registration list.
+ *
+ *   - Pure data: no `addEventListener`, no `window` access. The bridge
+ *     to DOM events is the *consumer's* job, and a one-liner:
+ *
+ *       document.addEventListener('keydown', e => {
+ *         const hit = registry.findByKeyboardEvent(e)
+ *         if (hit !== null) {
+ *           e.preventDefault()
+ *           runCommand(hit.command, hit.args)
+ *         }
+ *       })
+ */
+import { type Signal } from '../reactivity';
+/**
+ * Modifier flag set. Booleans match `KeyboardEvent` getter names so consumers
+ * can pass an event directly.
+ */
+export interface ModifierState {
+    readonly ctrlKey: boolean;
+    readonly metaKey: boolean;
+    readonly altKey: boolean;
+    readonly shiftKey: boolean;
+}
+/**
+ * Result of parsing a combo string. `key` is the case-preserved KeyboardEvent
+ * `key` value (e.g. `'k'`, `'ArrowRight'`, `'F5'`). Modifiers are split into
+ * the four boolean flags.
+ *
+ * `Mod` from the source string is recorded in `requiresMod`: true means
+ * "match if Ctrl on non-mac OR Meta on mac"; false means the combo doesn't
+ * use the platform modifier.
+ */
+export interface ParsedCombo {
+    readonly key: string;
+    readonly requiresMod: boolean;
+    readonly ctrlKey: boolean;
+    readonly metaKey: boolean;
+    readonly altKey: boolean;
+    readonly shiftKey: boolean;
+}
+/**
+ * The shape registered via `registry.register({...})`. `args` is opaque to
+ * the registry; consumers pass it through to their command runner.
+ */
+export interface ShortcutDef<TArgs = unknown> {
+    /** Stable id (e.g. `'pan.left'`). Used for unregister + error messages. */
+    readonly id: string;
+    /** Human label for tooltips / settings UI. */
+    readonly label: string;
+    /** Combo source string. See module header for the grammar. */
+    readonly combo: string;
+    /** Opaque command identifier — typically a key into your command map. */
+    readonly command: string;
+    /** Optional opaque arg payload for the command. */
+    readonly args?: TArgs;
+    /**
+     * Optional gating predicate. Evaluated at `findByKeyboardEvent` time
+     * with no arguments. Returning false means the shortcut won't match.
+     * Use this for context-sensitive bindings (e.g. only fire `ESC` when
+     * a drawing tool is active).
+     */
+    readonly when?: () => boolean;
+}
+export interface ShortcutRegistry {
+    /** Read-only signal of all currently-registered shortcuts. */
+    readonly shortcuts: Signal<ReadonlyArray<ShortcutDef>>;
+    register<TArgs = unknown>(def: ShortcutDef<TArgs>): void;
+    unregister(id: string): void;
+    /** Lookup by raw combo string (normalised). */
+    findByCombo(combo: string): ShortcutDef | null;
+    /**
+     * Lookup by KeyboardEvent. The platform is detected once at registry
+     * construction time (override via `opts.platform` for testing).
+     */
+    findByKeyboardEvent(event: KeyboardEventLike): ShortcutDef | null;
+    /** Returns the canonical form of a combo, useful for tests + tooltips. */
+    canonical(combo: string): string;
+    dispose(): void;
+}
+/**
+ * The fields of `KeyboardEvent` we consume. Declaring this locally avoids
+ * pulling in DOM types and lets server-side smoke tests pass plain objects.
+ */
+export interface KeyboardEventLike {
+    readonly key: string;
+    readonly ctrlKey: boolean;
+    readonly metaKey: boolean;
+    readonly altKey: boolean;
+    readonly shiftKey: boolean;
+}
+export interface ShortcutRegistryOptions {
+    /**
+     * Override platform detection. `'mac'` makes `Mod → Meta`; everything
+     * else (`'win'`, `'linux'`, etc.) makes `Mod → Ctrl`. Default:
+     * sniff `navigator.platform` if available, else assume non-mac.
+     */
+    readonly platform?: 'mac' | 'win' | 'linux' | string;
+}
+/**
+ * Parse a combo source string into the normalised {@link ParsedCombo}.
+ * Throws `KLineChartError('INVALID_PARAM')` on malformed input — empty,
+ * modifiers without a key, unknown modifier token.
+ */
+export declare function parseCombo(source: string): ParsedCombo;
+/**
+ * Canonicalise a combo source string. Sorts modifiers into the
+ * canonical order (Mod, Ctrl, Meta, Alt, Shift) and lower-cases
+ * single-letter keys. `'shift+mod+k'` → `'Mod+Shift+K'`.
+ */
+export declare function canonicalCombo(source: string): string;
+export declare function createShortcutRegistry(opts?: ShortcutRegistryOptions): ShortcutRegistry;
+//# sourceMappingURL=keyboard.d.ts.map

package/dist/input/keyboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.d.ts","sourceRoot":"","sources":["../../src/input/keyboard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,eAAe,CAAA;AAOzD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;CAC7B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW,CAAC,KAAK,GAAG,OAAO;IACxC,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,mDAAmD;IACnD,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,CAAA;IACrB;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,OAAO,CAAA;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC7B,8DAA8D;IAC9D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAA;IACtD,QAAQ,CAAC,KAAK,GAAG,OAAO,EAAE,GAAG,EAAE,WAAW,CAAC,KAAK,CAAC,GAAG,IAAI,CAAA;IACxD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,+CAA+C;IAC/C,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAA;IAC9C;;;OAGG;IACH,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,GAAG,WAAW,GAAG,IAAI,CAAA;IACjE,0EAA0E;IAC1E,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;IAChC,OAAO,IAAI,IAAI,CAAA;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;CAC7B;AAED,MAAM,WAAW,uBAAuB;IACpC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,CAAA;CACvD;AAkBD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAkEtD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAUrD;AAgBD,wBAAgB,sBAAsB,CAClC,IAAI,CAAC,EAAE,uBAAuB,GAC/B,gBAAgB,CA+GlB"}