@flighthq/interaction 0.1.0 → 0.2.1-next.410.a23f189

package/dist/cursorBackend.d.ts

@@ -0,0 +1,12 @@
+import type { CursorBackend } from '@flighthq/types';
+/**
+ * Web cursor backend: applies the resolved rollover cursor to a DOM element's `style.cursor`
+ * (typically the render canvas). `setCursor(null)` clears back to the element's default. Pass the
+ * result to `createInteractionManager` via `cursorBackend`, or assign it to `manager.cursorBackend`.
+ *
+ * The backend is held per manager rather than globally, so multiple canvases each drive their own
+ * cursor zone. Import side-effect-free: this only constructs the backend; nothing is applied until
+ * pointer dispatch resolves a rollover.
+ */
+export declare function createWebCursorBackend(element: HTMLElement): CursorBackend;
+//# sourceMappingURL=cursorBackend.d.ts.map

package/dist/cursorBackend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursorBackend.d.ts","sourceRoot":"","sources":["../src/cursorBackend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAU,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE7D;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,WAAW,GAAG,aAAa,CAM1E"}

package/dist/cursorBackend.js

@@ -0,0 +1,17 @@
+/**
+ * Web cursor backend: applies the resolved rollover cursor to a DOM element's `style.cursor`
+ * (typically the render canvas). `setCursor(null)` clears back to the element's default. Pass the
+ * result to `createInteractionManager` via `cursorBackend`, or assign it to `manager.cursorBackend`.
+ *
+ * The backend is held per manager rather than globally, so multiple canvases each drive their own
+ * cursor zone. Import side-effect-free: this only constructs the backend; nothing is applied until
+ * pointer dispatch resolves a rollover.
+ */
+export function createWebCursorBackend(element) {
+    return {
+        setCursor(cursor) {
+            element.style.cursor = cursor ?? '';
+        },
+    };
+}
+//# sourceMappingURL=cursorBackend.js.map

package/dist/cursorBackend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursorBackend.js","sourceRoot":"","sources":["../src/cursorBackend.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAoB;IACzD,OAAO;QACL,SAAS,CAAC,MAAqB;YAC7B,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,IAAI,EAAE,CAAC;QACtC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/displayHitTests.d.ts

@@ -1,13 +1,12 @@
 import type { NodeAny } from '@flighthq/types';
-export declare function defaultBitmapHitTestPointHandler(source: NodeAny, x: number, y: number, _shapeFlag: boolean): boolean;
-export declare function defaultDisplayObjectHitTestPointHandler(_source: NodeAny, _x: number, _y: number, _shapeFlag: boolean): boolean;
-export declare function defaultHtmlViewHitTestPointHandler(_source: NodeAny, _x: number, _y: number, _shapeFlag: boolean): boolean;
-export declare function defaultMovieClipHitTestPointHandler(_source: NodeAny, _x: number, _y: number, _shapeFlag: boolean): boolean;
-export declare function defaultRenderViewHitTestPointHandler(source: NodeAny, x: number, y: number, _shapeFlag: boolean): boolean;
-export declare function defaultRichTextHitTestPointHandler(source: NodeAny, x: number, y: number, _shapeFlag: boolean): boolean;
-export declare function defaultShapeHitTestPointHandler(source: NodeAny, x: number, y: number, _shapeFlag: boolean): boolean;
-export declare function defaultStageHitTestPointHandler(_source: NodeAny, _x: number, _y: number, _shapeFlag: boolean): boolean;
-export declare function defaultTextHitTestPointHandler(source: NodeAny, x: number, y: number, _shapeFlag: boolean): boolean;
-export declare function defaultTextInputHitTestPointHandler(source: NodeAny, x: number, y: number, _shapeFlag: boolean): boolean;
-export declare function defaultVideoHitTestPointHandler(source: NodeAny, x: number, y: number, _shapeFlag: boolean): boolean;
+export declare function defaultBitmapHitTestHandler(source: NodeAny, x: number, y: number): boolean;
+export declare function defaultDisplayObjectHitTestHandler(_source: NodeAny, _x: number, _y: number): boolean;
+export declare function defaultHtmlViewHitTestHandler(_source: NodeAny, _x: number, _y: number): boolean;
+export declare function defaultMovieClipHitTestHandler(_source: NodeAny, _x: number, _y: number): boolean;
+export declare function defaultRenderViewHitTestHandler(source: NodeAny, x: number, y: number): boolean;
+export declare function defaultRichTextHitTestHandler(source: NodeAny, x: number, y: number): boolean;
+export declare function defaultShapeHitTestHandler(source: NodeAny, x: number, y: number): boolean;
+export declare function defaultTextHitTestHandler(source: NodeAny, x: number, y: number): boolean;
+export declare function defaultTextInputHitTestHandler(source: NodeAny, x: number, y: number): boolean;
+export declare function defaultVideoHitTestHandler(source: NodeAny, x: number, y: number): boolean;
 //# sourceMappingURL=displayHitTests.d.ts.map

package/dist/displayHitTests.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"displayHitTests.d.ts","sourceRoot":"","sources":["../src/displayHitTests.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAI/C,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,OAAO,CAEpH;AAED,wBAAgB,uCAAuC,CACrD,OAAO,EAAE,OAAO,EAChB,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,OAAO,GAClB,OAAO,CAET;AAED,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,OAAO,EAChB,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,OAAO,GAClB,OAAO,CAGT;AAED,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,OAAO,EAChB,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,OAAO,GAClB,OAAO,CAGT;AAED,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,OAAO,EACf,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,UAAU,EAAE,OAAO,GAClB,OAAO,CAET;AAED,wBAAgB,kCAAkC,CAChD,MAAM,EAAE,OAAO,EACf,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,UAAU,EAAE,OAAO,GAClB,OAAO,CAET;AAED,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,OAAO,CAEnH;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,OAAO,EAChB,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,OAAO,GAClB,OAAO,CAGT;AAED,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,OAAO,CAElH;AAED,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,OAAO,EACf,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,UAAU,EAAE,OAAO,GAClB,OAAO,CAET;AAED,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,OAAO,CAEnH"}
+{"version":3,"file":"displayHitTests.d.ts","sourceRoot":"","sources":["../src/displayHitTests.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAI/C,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAE1F;AAED,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAEpG;AAED,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAG/F;AAED,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAGhG;AAED,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAE9F;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAE5F;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAIzF;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAExF;AAED,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAE7F;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAEzF"}

package/dist/displayHitTests.js

@@ -1,38 +1,36 @@
 import { hitTestGraphLocalBounds } from './hitTests';
-export function defaultBitmapHitTestPointHandler(source, x, y, _shapeFlag) {
+export function defaultBitmapHitTestHandler(source, x, y) {
     return hitTestGraphLocalBounds(source, x, y);
 }
-export function defaultDisplayObjectHitTestPointHandler(_source, _x, _y, _shapeFlag) {
+export function defaultDisplayObjectHitTestHandler(_source, _x, _y) {
     return false;
 }
-export function defaultHtmlViewHitTestPointHandler(_source, _x, _y, _shapeFlag) {
+export function defaultHtmlViewHitTestHandler(_source, _x, _y) {
     // HtmlView elements handle pointer events through the browser — not the canvas interaction system.
     return false;
 }
-export function defaultMovieClipHitTestPointHandler(_source, _x, _y, _shapeFlag) {
+export function defaultMovieClipHitTestHandler(_source, _x, _y) {
     // Containers have no self hit area — findGraphHitTarget traverses children separately.
     return false;
 }
-export function defaultRenderViewHitTestPointHandler(source, x, y, _shapeFlag) {
+export function defaultRenderViewHitTestHandler(source, x, y) {
     return hitTestGraphLocalBounds(source, x, y);
 }
-export function defaultRichTextHitTestPointHandler(source, x, y, _shapeFlag) {
+export function defaultRichTextHitTestHandler(source, x, y) {
     return hitTestGraphLocalBounds(source, x, y);
 }
-export function defaultShapeHitTestPointHandler(source, x, y, _shapeFlag) {
+export function defaultShapeHitTestHandler(source, x, y) {
+    // Coarse bounds box. Shape-accurate winding is opt-in via `registerShapeHitTest` so the
+    // default registrar stays free of `@flighthq/shape` / `@flighthq/path`.
     return hitTestGraphLocalBounds(source, x, y);
 }
-export function defaultStageHitTestPointHandler(_source, _x, _y, _shapeFlag) {
-    // Containers have no self hit area — findGraphHitTarget traverses children separately.
-    return false;
-}
-export function defaultTextHitTestPointHandler(source, x, y, _shapeFlag) {
+export function defaultTextHitTestHandler(source, x, y) {
     return hitTestGraphLocalBounds(source, x, y);
 }
-export function defaultTextInputHitTestPointHandler(source, x, y, _shapeFlag) {
+export function defaultTextInputHitTestHandler(source, x, y) {
     return hitTestGraphLocalBounds(source, x, y);
 }
-export function defaultVideoHitTestPointHandler(source, x, y, _shapeFlag) {
+export function defaultVideoHitTestHandler(source, x, y) {
     return hitTestGraphLocalBounds(source, x, y);
 }
 //# sourceMappingURL=displayHitTests.js.map

package/dist/displayHitTests.js.map

@@ -1 +1 @@
-{"version":3,"file":"displayHitTests.js","sourceRoot":"","sources":["../src/displayHitTests.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,UAAU,gCAAgC,CAAC,MAAe,EAAE,CAAS,EAAE,CAAS,EAAE,UAAmB;IACzG,OAAO,uBAAuB,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,uCAAuC,CACrD,OAAgB,EAChB,EAAU,EACV,EAAU,EACV,UAAmB;IAEnB,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,kCAAkC,CAChD,OAAgB,EAChB,EAAU,EACV,EAAU,EACV,UAAmB;IAEnB,mGAAmG;IACnG,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,mCAAmC,CACjD,OAAgB,EAChB,EAAU,EACV,EAAU,EACV,UAAmB;IAEnB,uFAAuF;IACvF,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,oCAAoC,CAClD,MAAe,EACf,CAAS,EACT,CAAS,EACT,UAAmB;IAEnB,OAAO,uBAAuB,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,kCAAkC,CAChD,MAAe,EACf,CAAS,EACT,CAAS,EACT,UAAmB;IAEnB,OAAO,uBAAuB,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,MAAe,EAAE,CAAS,EAAE,CAAS,EAAE,UAAmB;IACxG,OAAO,uBAAuB,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,OAAgB,EAChB,EAAU,EACV,EAAU,EACV,UAAmB;IAEnB,uFAAuF;IACvF,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,MAAe,EAAE,CAAS,EAAE,CAAS,EAAE,UAAmB;IACvG,OAAO,uBAAuB,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,mCAAmC,CACjD,MAAe,EACf,CAAS,EACT,CAAS,EACT,UAAmB;IAEnB,OAAO,uBAAuB,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,MAAe,EAAE,CAAS,EAAE,CAAS,EAAE,UAAmB;IACxG,OAAO,uBAAuB,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC"}
+{"version":3,"file":"displayHitTests.js","sourceRoot":"","sources":["../src/displayHitTests.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,UAAU,2BAA2B,CAAC,MAAe,EAAE,CAAS,EAAE,CAAS;IAC/E,OAAO,uBAAuB,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,kCAAkC,CAAC,OAAgB,EAAE,EAAU,EAAE,EAAU;IACzF,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,OAAgB,EAAE,EAAU,EAAE,EAAU;IACpF,mGAAmG;IACnG,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,OAAgB,EAAE,EAAU,EAAE,EAAU;IACrF,uFAAuF;IACvF,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,MAAe,EAAE,CAAS,EAAE,CAAS;IACnF,OAAO,uBAAuB,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,MAAe,EAAE,CAAS,EAAE,CAAS;IACjF,OAAO,uBAAuB,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,MAAe,EAAE,CAAS,EAAE,CAAS;IAC9E,wFAAwF;IACxF,wEAAwE;IACxE,OAAO,uBAAuB,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,MAAe,EAAE,CAAS,EAAE,CAAS;IAC7E,OAAO,uBAAuB,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,MAAe,EAAE,CAAS,EAAE,CAAS;IAClF,OAAO,uBAAuB,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,MAAe,EAAE,CAAS,EAAE,CAAS;IAC9E,OAAO,uBAAuB,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC"}

package/dist/enableInteractionGuards.d.ts

@@ -0,0 +1,23 @@
+import type { NodeAny } from '@flighthq/types';
+/** Plain-data result of `explainInteractionHitEligibility`. */
+export interface InteractionHitEligibility {
+    eligible: boolean;
+    hasEligibleInSubtree: boolean;
+}
+/** Uninstalls the guard installed by `enableInteractionGuards`. */
+export declare function disableInteractionGuards(): void;
+/**
+ * Installs the caller-facing interaction guard (opt-in, dev-only). It warns once — through
+ * `@flighthq/log` — when a pointer listener is connected to a node whose subtree contains no
+ * hit-testable node, i.e. the "I added a click handler but nothing fires" footgun under opt-in
+ * eligibility. Because hit testing is opt-in, this catches forgetting `setNodeHitTestEnabled`.
+ *
+ * Assumes opt-in precedes the connect (the recommended order); a node opted in *after* connecting a
+ * listener would warn spuriously. Not importing this module costs production nothing — the message and
+ * the `@flighthq/log` dependency live only here.
+ */
+export declare function enableInteractionGuards(): void;
+/** Reports whether a node is a hit candidate and whether any node in its subtree is — the seam a
+ * developer queries to understand why events do or do not reach a node. */
+export declare function explainInteractionHitEligibility(node: Readonly<NodeAny>): InteractionHitEligibility;
+//# sourceMappingURL=enableInteractionGuards.d.ts.map

package/dist/enableInteractionGuards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enableInteractionGuards.d.ts","sourceRoot":"","sources":["../src/enableInteractionGuards.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAyB,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAMtE,+DAA+D;AAC/D,MAAM,WAAW,yBAAyB;IAExC,QAAQ,EAAE,OAAO,CAAC;IAElB,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED,mEAAmE;AACnE,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AAED;2EAC2E;AAC3E,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,yBAAyB,CAKnG"}

package/dist/enableInteractionGuards.js

@@ -0,0 +1,75 @@
+import { logOnce } from '@flighthq/log';
+import { getNodeRuntime } from '@flighthq/node';
+import { LogLevel } from '@flighthq/types';
+import { setInteractionConnectGuard } from './interactionManager';
+import { isNodeFocusable, isNodeHitTestEnabled } from './nodeInteractionState';
+/** Uninstalls the guard installed by `enableInteractionGuards`. */
+export function disableInteractionGuards() {
+    setInteractionConnectGuard(null);
+}
+/**
+ * Installs the caller-facing interaction guard (opt-in, dev-only). It warns once — through
+ * `@flighthq/log` — when a pointer listener is connected to a node whose subtree contains no
+ * hit-testable node, i.e. the "I added a click handler but nothing fires" footgun under opt-in
+ * eligibility. Because hit testing is opt-in, this catches forgetting `setNodeHitTestEnabled`.
+ *
+ * Assumes opt-in precedes the connect (the recommended order); a node opted in *after* connecting a
+ * listener would warn spuriously. Not importing this module costs production nothing — the message and
+ * the `@flighthq/log` dependency live only here.
+ */
+export function enableInteractionGuards() {
+    setInteractionConnectGuard(warnOnInertInteractionTarget);
+}
+/** Reports whether a node is a hit candidate and whether any node in its subtree is — the seam a
+ * developer queries to understand why events do or do not reach a node. */
+export function explainInteractionHitEligibility(node) {
+    return {
+        eligible: isNodeHitTestEnabled(node),
+        hasEligibleInSubtree: hasEligibleNodeInSubtree(node),
+    };
+}
+function hasEligibleNodeInSubtree(node) {
+    if (isNodeHitTestEnabled(node))
+        return true;
+    const children = getNodeRuntime(node).children;
+    if (children !== null) {
+        for (const child of children) {
+            if (hasEligibleNodeInSubtree(child))
+                return true;
+        }
+    }
+    return false;
+}
+function hasFocusableNodeInSubtree(node) {
+    if (isNodeFocusable(node))
+        return true;
+    const children = getNodeRuntime(node).children;
+    if (children !== null) {
+        for (const child of children) {
+            if (hasFocusableNodeInSubtree(child))
+                return true;
+        }
+    }
+    return false;
+}
+function warnOnInertInteractionTarget(target, name) {
+    // Keyboard signals dispatch to the manager root regardless of eligibility, so they are exempt.
+    if (name === 'onKeyDown' || name === 'onKeyUp')
+        return;
+    // Focus signals dispatch from the focus manager based on `focusable`, not hit eligibility, so they get
+    // the symmetric check: warn when nothing in the subtree is a focus stop (forgot setNodeFocusable).
+    if (name === 'onFocusIn' || name === 'onFocusOut') {
+        if (hasFocusableNodeInSubtree(target))
+            return;
+        logOnce('interaction:focus-listener-on-non-focusable', LogLevel.Warn, {
+            message: `connectInteractionSignal('${name}'): target has no focusable node in its subtree — call setNodeFocusable(node, true) so it can receive focus events`,
+        }, 'interaction');
+        return;
+    }
+    if (hasEligibleNodeInSubtree(target))
+        return;
+    logOnce('interaction:listener-on-inert-node', LogLevel.Warn, {
+        message: `connectInteractionSignal('${name}'): target has no hit-testable node in its subtree — call setNodeHitTestEnabled(node, true) so it can receive pointer events`,
+    }, 'interaction');
+}
+//# sourceMappingURL=enableInteractionGuards.js.map

package/dist/enableInteractionGuards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enableInteractionGuards.js","sourceRoot":"","sources":["../src/enableInteractionGuards.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAU/E,mEAAmE;AACnE,MAAM,UAAU,wBAAwB;IACtC,0BAA0B,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,uBAAuB;IACrC,0BAA0B,CAAC,4BAA4B,CAAC,CAAC;AAC3D,CAAC;AAED;2EAC2E;AAC3E,MAAM,UAAU,gCAAgC,CAAC,IAAuB;IACtE,OAAO;QACL,QAAQ,EAAE,oBAAoB,CAAC,IAAI,CAAC;QACpC,oBAAoB,EAAE,wBAAwB,CAAC,IAAI,CAAC;KACrD,CAAC;AACJ,CAAC;AAED,SAAS,wBAAwB,CAAC,IAAuB;IACvD,IAAI,oBAAoB,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5C,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC;IAC/C,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC7B,IAAI,wBAAwB,CAAC,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;QACnD,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,yBAAyB,CAAC,IAAuB;IACxD,IAAI,eAAe,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC;IAC/C,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC7B,IAAI,yBAAyB,CAAC,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;QACpD,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,4BAA4B,CAAC,MAAe,EAAE,IAA2B;IAChF,+FAA+F;IAC/F,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO;IAEvD,uGAAuG;IACvG,mGAAmG;IACnG,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;QAClD,IAAI,yBAAyB,CAAC,MAAM,CAAC;YAAE,OAAO;QAC9C,OAAO,CACL,6CAA6C,EAC7C,QAAQ,CAAC,IAAI,EACb;YACE,OAAO,EAAE,6BAA6B,IAAI,oHAAoH;SAC/J,EACD,aAAa,CACd,CAAC;QACF,OAAO;IACT,CAAC;IAED,IAAI,wBAAwB,CAAC,MAAM,CAAC;QAAE,OAAO;IAC7C,OAAO,CACL,oCAAoC,EACpC,QAAQ,CAAC,IAAI,EACb;QACE,OAAO,EAAE,6BAA6B,IAAI,8HAA8H;KACzK,EACD,aAAa,CACd,CAAC;AACJ,CAAC"}

package/dist/focusManager.d.ts

@@ -0,0 +1,46 @@
+import type { FocusDirection, FocusManager, FocusManagerOptions, FocusNavigationInput, FocusNavigationOptions, NodeAny } from '@flighthq/types';
+/** Clears focus: the previously focused node (if any) receives `onFocusOut` and the manager holds none. */
+export declare function clearFocus<N extends NodeAny>(manager: FocusManager<N>): void;
+/**
+ * Wires a keyboard source into a focus manager: Tab advances focus, Shift+Tab retreats, and — when
+ * `options.arrowKeys` is set — the arrow keys drive directional (spatial) navigation. Returns a disconnect
+ * function. The manager owns focus state; this only translates keys into navigation calls, so an app can
+ * equally drive `focusNextNode` / `focusNodeInDirection` from its own input handling instead.
+ **/
+export declare function connectFocusNavigation<N extends NodeAny>(input: FocusNavigationInput, manager: FocusManager<N>, options?: Readonly<FocusNavigationOptions>): () => void;
+/** Allocates a focus manager for `root`. `wrap` (default `true`) cycles tab navigation past the ends. */
+export declare function createFocusManager<N extends NodeAny>(root: N, options?: Readonly<FocusManagerOptions>): FocusManager<N>;
+/**
+ * Moves focus to the next stop in tab order and returns it, or `null` if there is nowhere to go (no
+ * focusable nodes, or already at the last stop with `wrap` off). With nothing focused, focuses the first.
+ **/
+export declare function focusNextNode<N extends NodeAny>(manager: FocusManager<N>): N | null;
+/**
+ * Moves focus to the nearest focus stop in `direction` from the focused node's world-bounds center and
+ * returns it, or `null` when nothing is focused yet or no stop lies that way. The D-pad / analog-stick
+ * navigation model: candidates are scored by distance along the axis plus a perpendicular-offset penalty,
+ * so the most directly-aligned stop wins.
+ **/
+export declare function focusNodeInDirection<N extends NodeAny>(manager: FocusManager<N>, direction: FocusDirection): N | null;
+/** Moves focus to the previous stop in tab order; the reverse of `focusNextNode`. */
+export declare function focusPreviousNode<N extends NodeAny>(manager: FocusManager<N>): N | null;
+/** The node currently holding focus, or `null`. */
+export declare function getFocusedNode<N extends NodeAny>(manager: FocusManager<N>): N | null;
+/**
+ * Fills `out` (cleared first) with the manager's focus stops in tab order and returns it: every focusable,
+ * enabled node in the subtree, with explicit `tabIndex >= 0` stops sorted ascending ahead of the natural
+ * tree-order stops (`tabIndex -1`). A disabled node and its whole subtree are skipped. This is the engine
+ * primitive the navigation functions walk; call it directly to render a focus ring or inspect tab order.
+ **/
+export declare function getFocusOrder<N extends NodeAny>(manager: FocusManager<N>, out?: N[]): N[];
+/** Whether `node` is the manager's currently focused node. */
+export declare function isNodeFocused<N extends NodeAny>(manager: FocusManager<N>, node: N): boolean;
+/**
+ * Focuses a specific node (or `null` to clear focus), firing `onFocusOut` on the previously focused node
+ * and `onFocusIn` on the new one — both bubbling up to `root`, with `relatedTarget` set to the node on the
+ * other side of the change. Returns `false` without changing anything if `node` is non-null but not
+ * focusable (`setNodeFocusable` was never called); `true` otherwise, including a no-op refocus of the same
+ * node. `node` is assumed to live in the managed subtree; ancestry is not validated.
+ **/
+export declare function setFocusedNode<N extends NodeAny>(manager: FocusManager<N>, node: N | null): boolean;
+//# sourceMappingURL=focusManager.d.ts.map

package/dist/focusManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focusManager.d.ts","sourceRoot":"","sources":["../src/focusManager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,cAAc,EAEd,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EAEtB,OAAO,EAGR,MAAM,iBAAiB,CAAC;AAKzB,2GAA2G;AAC3G,wBAAgB,UAAU,CAAC,CAAC,SAAS,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,CAE5E;AAED;;;;;IAKI;AACJ,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,OAAO,EACtD,KAAK,EAAE,oBAAoB,EAC3B,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EACxB,OAAO,GAAE,QAAQ,CAAC,sBAAsB,CAAM,GAC7C,MAAM,IAAI,CAcZ;AAED,yGAAyG;AACzG,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,OAAO,EAClD,IAAI,EAAE,CAAC,EACP,OAAO,GAAE,QAAQ,CAAC,mBAAmB,CAAM,GAC1C,YAAY,CAAC,CAAC,CAAC,CAMjB;AAED;;;IAGI;AACJ,wBAAgB,aAAa,CAAC,CAAC,SAAS,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAEnF;AAED;;;;;IAKI;AACJ,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,cAAc,GAAG,CAAC,GAAG,IAAI,CAqBrH;AAED,qFAAqF;AACrF,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAEvF;AAED,mDAAmD;AACnD,wBAAgB,cAAc,CAAC,CAAC,SAAS,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAEpF;AAED;;;;;IAKI;AACJ,wBAAgB,aAAa,CAAC,CAAC,SAAS,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,GAAG,GAAE,CAAC,EAAO,GAAG,CAAC,EAAE,CAK7F;AAED,8DAA8D;AAC9D,wBAAgB,aAAa,CAAC,CAAC,SAAS,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAE3F;AAED;;;;;;IAMI;AACJ,wBAAgB,cAAc,CAAC,CAAC,SAAS,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,GAAG,OAAO,CASnG"}

package/dist/focusManager.js

@@ -0,0 +1,243 @@
+import { getNodeParent, getNodeRuntime, getNodeWorldBoundsRectangle } from '@flighthq/node';
+import { connectSignal, disconnectSignal, emitSignal } from '@flighthq/signals';
+import { getInteractionSignals } from './interactionManager';
+import { getNodeTabIndex, isNodeFocusable } from './nodeInteractionState';
+/** Clears focus: the previously focused node (if any) receives `onFocusOut` and the manager holds none. */
+export function clearFocus(manager) {
+    setFocusedNode(manager, null);
+}
+/**
+ * Wires a keyboard source into a focus manager: Tab advances focus, Shift+Tab retreats, and — when
+ * `options.arrowKeys` is set — the arrow keys drive directional (spatial) navigation. Returns a disconnect
+ * function. The manager owns focus state; this only translates keys into navigation calls, so an app can
+ * equally drive `focusNextNode` / `focusNodeInDirection` from its own input handling instead.
+ **/
+export function connectFocusNavigation(input, manager, options = {}) {
+    const arrowKeys = options.arrowKeys ?? false;
+    const onKeyDown = (data) => {
+        if (data.key === 'Tab') {
+            if (data.shiftKey)
+                focusPreviousNode(manager);
+            else
+                focusNextNode(manager);
+            return;
+        }
+        if (!arrowKeys)
+            return;
+        const direction = arrowKeyDirection(data.key);
+        if (direction !== null)
+            focusNodeInDirection(manager, direction);
+    };
+    connectSignal(input.onKeyDown, onKeyDown);
+    return () => disconnectSignal(input.onKeyDown, onKeyDown);
+}
+/** Allocates a focus manager for `root`. `wrap` (default `true`) cycles tab navigation past the ends. */
+export function createFocusManager(root, options = {}) {
+    return {
+        focused: null,
+        root,
+        wrap: options.wrap ?? true,
+    };
+}
+/**
+ * Moves focus to the next stop in tab order and returns it, or `null` if there is nowhere to go (no
+ * focusable nodes, or already at the last stop with `wrap` off). With nothing focused, focuses the first.
+ **/
+export function focusNextNode(manager) {
+    return stepFocus(manager, 1);
+}
+/**
+ * Moves focus to the nearest focus stop in `direction` from the focused node's world-bounds center and
+ * returns it, or `null` when nothing is focused yet or no stop lies that way. The D-pad / analog-stick
+ * navigation model: candidates are scored by distance along the axis plus a perpendicular-offset penalty,
+ * so the most directly-aligned stop wins.
+ **/
+export function focusNodeInDirection(manager, direction) {
+    const current = manager.focused;
+    if (current === null)
+        return null;
+    const order = getFocusOrder(manager, _orderScratch);
+    const origin = boundsCenter(current, _originCenter);
+    const originX = origin.x;
+    const originY = origin.y;
+    let best = null;
+    let bestScore = Number.POSITIVE_INFINITY;
+    for (const candidate of order) {
+        if (candidate === current)
+            continue;
+        const center = boundsCenter(candidate, _candidateCenter);
+        const score = directionScore(direction, originX, originY, center.x, center.y);
+        if (score < bestScore) {
+            bestScore = score;
+            best = candidate;
+        }
+    }
+    if (best !== null)
+        setFocusedNode(manager, best);
+    return best;
+}
+/** Moves focus to the previous stop in tab order; the reverse of `focusNextNode`. */
+export function focusPreviousNode(manager) {
+    return stepFocus(manager, -1);
+}
+/** The node currently holding focus, or `null`. */
+export function getFocusedNode(manager) {
+    return manager.focused;
+}
+/**
+ * Fills `out` (cleared first) with the manager's focus stops in tab order and returns it: every focusable,
+ * enabled node in the subtree, with explicit `tabIndex >= 0` stops sorted ascending ahead of the natural
+ * tree-order stops (`tabIndex -1`). A disabled node and its whole subtree are skipped. This is the engine
+ * primitive the navigation functions walk; call it directly to render a focus ring or inspect tab order.
+ **/
+export function getFocusOrder(manager, out = []) {
+    out.length = 0;
+    collectFocusStops(manager.root, out);
+    out.sort(byTabIndexOrder);
+    return out;
+}
+/** Whether `node` is the manager's currently focused node. */
+export function isNodeFocused(manager, node) {
+    return manager.focused === node;
+}
+/**
+ * Focuses a specific node (or `null` to clear focus), firing `onFocusOut` on the previously focused node
+ * and `onFocusIn` on the new one — both bubbling up to `root`, with `relatedTarget` set to the node on the
+ * other side of the change. Returns `false` without changing anything if `node` is non-null but not
+ * focusable (`setNodeFocusable` was never called); `true` otherwise, including a no-op refocus of the same
+ * node. `node` is assumed to live in the managed subtree; ancestry is not validated.
+ **/
+export function setFocusedNode(manager, node) {
+    if (node !== null && !isNodeFocusable(node))
+        return false;
+    const previous = manager.focused;
+    if (node === previous)
+        return true;
+    manager.focused = node;
+    if (previous !== null)
+        emitFocusSignal(previous, manager.root, 'onFocusOut', node);
+    if (node !== null)
+        emitFocusSignal(node, manager.root, 'onFocusIn', previous);
+    return true;
+}
+function arrowKeyDirection(key) {
+    switch (key) {
+        case 'ArrowDown':
+            return 'down';
+        case 'ArrowLeft':
+            return 'left';
+        case 'ArrowRight':
+            return 'right';
+        case 'ArrowUp':
+            return 'up';
+        default:
+            return null;
+    }
+}
+// Writes the world-bounds center of a node into `out` and returns it. Directional navigation compares
+// these centers; the node is treated as a 2D spatial node (all display objects are).
+function boundsCenter(node, out) {
+    const bounds = getNodeWorldBoundsRectangle(node);
+    out.x = bounds.x + bounds.width / 2;
+    out.y = bounds.y + bounds.height / 2;
+    return out;
+}
+// Stable-sort comparator: explicit `tabIndex >= 0` stops ascending, then natural (`-1`) stops. A stable
+// sort keeps the DFS (tree) order among equal keys, so natural stops stay in document order.
+function byTabIndexOrder(a, b) {
+    return focusOrderKey(a) - focusOrderKey(b);
+}
+function collectFocusStops(node, out) {
+    if (!node.enabled)
+        return;
+    if (isNodeFocusable(node))
+        out.push(node);
+    const children = getNodeRuntime(node).children;
+    if (children !== null) {
+        for (const child of children)
+            collectFocusStops(child, out);
+    }
+}
+// Scores a candidate center against the origin for `direction`: distance along the axis plus twice the
+// perpendicular offset (so aligned stops beat far-off-axis ones). Returns Infinity for anything not on the
+// requested side, excluding it.
+function directionScore(direction, ox, oy, cx, cy) {
+    const dx = cx - ox;
+    const dy = cy - oy;
+    let along;
+    let perpendicular;
+    switch (direction) {
+        case 'right':
+            along = dx;
+            perpendicular = dy;
+            break;
+        case 'left':
+            along = -dx;
+            perpendicular = dy;
+            break;
+        case 'down':
+            along = dy;
+            perpendicular = dx;
+            break;
+        default:
+            along = -dy;
+            perpendicular = dx;
+            break;
+    }
+    if (along <= DIRECTION_EPSILON)
+        return Number.POSITIVE_INFINITY;
+    return along + 2 * Math.abs(perpendicular);
+}
+// Bubbles a focus signal from `target` up to `root`, reusing the shared `_focusData` payload. Focus
+// signals bubble (like pointer signals) but are not cancelable — there is no meaningful "prevent" for a
+// focus change that has already happened.
+function emitFocusSignal(target, root, name, relatedTarget) {
+    _focusData.relatedTarget = relatedTarget;
+    _focusData.target = target;
+    let current = target;
+    while (current !== null) {
+        _focusData.currentTarget = current;
+        const signals = getInteractionSignals(current);
+        const signal = signals !== null ? signals[name] : null;
+        if (signal !== null)
+            emitSignal(signal, _focusData);
+        if (current === root)
+            break;
+        current = getNodeParent(current);
+    }
+}
+function focusOrderKey(node) {
+    const tabIndex = getNodeTabIndex(node);
+    return tabIndex < 0 ? Number.POSITIVE_INFINITY : tabIndex;
+}
+// Advances focus by `delta` (+1 next, -1 previous) through the current focus order, wrapping when the
+// manager allows it. Captures the target before emitting, so a slot re-entering navigation cannot corrupt
+// the returned value. Returns the newly focused node, or `null` when there is nowhere to move.
+function stepFocus(manager, delta) {
+    const order = getFocusOrder(manager, _orderScratch);
+    if (order.length === 0)
+        return null;
+    const current = manager.focused;
+    const from = current !== null ? order.indexOf(current) : -1;
+    let index;
+    if (from === -1) {
+        index = delta > 0 ? 0 : order.length - 1;
+    }
+    else {
+        index = from + delta;
+        if (index < 0 || index >= order.length) {
+            if (!manager.wrap)
+                return null;
+            index = (index + order.length) % order.length;
+        }
+    }
+    const next = order[index];
+    setFocusedNode(manager, next);
+    return next;
+}
+const DIRECTION_EPSILON = 0.0001;
+const _candidateCenter = { x: 0, y: 0 };
+const _focusData = { currentTarget: null, relatedTarget: null, target: null };
+const _orderScratch = [];
+const _originCenter = { x: 0, y: 0 };
+//# sourceMappingURL=focusManager.js.map

package/dist/focusManager.js.map

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