@weasel-js/hud 0.6.0 → 0.7.1

package/dist/tool.d.ts

@@ -0,0 +1,40 @@
+import type { Tool } from '@weasel-js/core';
+import type { Widget } from './widget';
+/** What the HUD layer's `hitTest` resolves and hands to the actions below. */
+export interface HudHitPayload {
+    widget: Widget;
+}
+/** Affordance kind `<SceneCanvas>` stamps on a hit from the HUD's layer:
+ *  `layer:<RenderLayer.id>`, and the HUD's layer id is `weasel-hud`. */
+export declare const HUD_AFFORDANCE_KIND = "layer:weasel-hud";
+/**
+ * A `Tool` carrying the HUD's input routing. Pass it to the canvas as an
+ * AMBIENT tool — the HUD is chrome floating over whatever tool is active, so
+ * it must not occupy the active slot:
+ *
+ * ```tsx
+ * const hud = useHud(ref);
+ * const hudTool = useHudTool();
+ * <SceneCanvas ref={ref} ambient={[hudTool]} … />
+ * ```
+ *
+ * Three bindings, because the widget protocol (`down` / `move` / `up`) spans
+ * two gesture kinds:
+ *
+ * - `pointerDown` sends `down` at press time, before the dispatcher knows
+ *   whether this becomes a click or a drag. A button that highlights on press
+ *   has to know then, not on release.
+ * - `click` sends the `up` for a press that never crossed the drag threshold —
+ *   the common case for a button.
+ * - `drag` pumps `move` and closes with `up` / `cancel`.
+ *
+ * All three gate on the affordance kind, so they fire only for presses the
+ * HUD's own layer hit-test claimed. That gate is also why ambient scope is
+ * safe: nothing else produces a `layer:weasel-hud` hit, and kit tools decline
+ * presses that landed on chrome.
+ *
+ * This replaces a `DragChannel` the HUD's `hitTest` used to hand back for the
+ * tool-routing dispatcher to drive. That dispatcher is gone.
+ */
+export declare function createHudTool(): Tool<null>;
+//# sourceMappingURL=tool.d.ts.map

package/dist/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAqC,IAAI,EAAQ,MAAM,iBAAiB,CAAC;AAErF,OAAO,KAAK,EAAE,MAAM,EAAmB,MAAM,UAAU,CAAC;AAExD,8EAA8E;AAC9E,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;wEACwE;AACxE,eAAO,MAAM,mBAAmB,qBAAqB,CAAC;AAgGtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAAC,IAAI,CAAC,CAU1C"}

package/dist/widget.d.ts

@@ -19,29 +19,40 @@ export interface HudDrawCtx {
      *  take effect on the next state-driven redraw. */
     tokens: ResolvedTokens;
 }
+/**
+ * Input handed to a widget, in screen space.
+ *
+ * `native` is the originating DOM event when there is one, and `null`
+ * otherwise — it is **not** guaranteed. Hover is driven by a direct DOM
+ * listener in `attachHud`, so `hovermove` carries the real `PointerEvent`.
+ * Press / move / release arrive through the gesture dispatcher, which hands
+ * actions normalized input rather than the event that produced it, so those
+ * arms carry `null`. A widget that needs `native` must handle its absence;
+ * prefer the normalized `x` / `y` and the event `type`.
+ */
 export type HudPointerEvent = {
     type: 'down';
     x: number;
     y: number;
-    native: PointerEvent;
+    native: PointerEvent | null;
 } | {
     type: 'move';
     x: number;
     y: number;
-    native: PointerEvent;
+    native: PointerEvent | null;
 } | {
     type: 'up';
     x: number;
     y: number;
-    native: PointerEvent;
+    native: PointerEvent | null;
 } | {
     type: 'cancel';
-    native: PointerEvent;
+    native: PointerEvent | null;
 } | {
     type: 'hovermove';
     x: number;
     y: number;
-    native: PointerEvent;
+    native: PointerEvent | null;
 } | {
     type: 'hoverleave';
     native: PointerEvent | null;

package/dist/widget.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"widget.d.ts","sourceRoot":"","sources":["../src/widget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,UAAU;IACzB,iCAAiC;IACjC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB;;uDAEmD;IACnD,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAA;CAAE,CAAC;AAExD,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,CAAC;AAE5C,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,IAAI,CAAC,GAAG,EAAE,UAAU,GAAG,WAAW,EAAE,CAAC;IACrC,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACvC,SAAS,CAAC,GAAG,EAAE,eAAe,GAAG,YAAY,CAAC;IAC9C,2EAA2E;IAC3E,OAAO,IAAI,IAAI,CAAC;CACjB"}
+{"version":3,"file":"widget.d.ts","sourceRoot":"","sources":["../src/widget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,UAAU;IACzB,iCAAiC;IACjC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB;;uDAEmD;IACnD,MAAM,EAAE,cAAc,CAAC;CACxB;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAA;CAAE,GACnE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAA;CAAE,GACnE;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAA;CAAE,GACxE;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAA;CAAE,CAAC;AAExD,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,CAAC;AAE5C,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,IAAI,CAAC,GAAG,EAAE,UAAU,GAAG,WAAW,EAAE,CAAC;IACrC,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACvC,SAAS,CAAC,GAAG,EAAE,eAAe,GAAG,YAAY,CAAC;IAC9C,2EAA2E;IAC3E,OAAO,IAAI,IAAI,CAAC;CACjB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weasel-js/hud",
-  "version": "0.6.0",
+  "version": "0.7.1",
   "description": "WebGL-rendered UI widgets that composite into a weasel canvas",
   "license": "MIT",
   "type": "module",
@@ -23,7 +23,8 @@
     "@weasel-js/core": ">=0.4.0"
   },
   "dependencies": {
-    "@weasel-js/theme": "0.6.0"
+    "@weasel-js/font": "0.7.1",
+    "@weasel-js/theme": "0.7.1"
   },
   "author": "orochi235",
   "homepage": "https://orochi235.github.io/weasel/",