@weasel-js/hud 0.6.0 → 0.7.0

package/dist/attach.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attach.d.ts","sourceRoot":"","sources":["../src/attach.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,KAAK,EAAE,kBAAkB,EAAqD,MAAM,iBAAiB,CAAC;AAY7G,wBAAgB,SAAS,CAAC,GAAG,EAAE,kBAAkB,EAAE,GAAG,EAAE,GAAG,GAAG,MAAM,IAAI,CA+GvE"}
+{"version":3,"file":"attach.d.ts","sourceRoot":"","sources":["../src/attach.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,KAAK,EAAE,kBAAkB,EAAwC,MAAM,iBAAiB,CAAC;AAShG,wBAAgB,SAAS,CAAC,GAAG,EAAE,kBAAkB,EAAE,GAAG,EAAE,GAAG,GAAG,MAAM,IAAI,CAyFvE"}

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export { createHud, type Hud } from './hud';
 export { attachHud } from './attach';
+export { createHudTool, HUD_AFFORDANCE_KIND, type HudHitPayload } from './tool';
 export type { Widget, WidgetBounds, HudDrawCtx, HudPointerEvent, PointerClaim, } from './widget';
 export type { HudHost } from './host';
 export { DEFAULT_FONT_FAMILY, registerDefaultFont } from './fonts/registerDefaultFont';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,YAAY,EACV,MAAM,EACN,YAAY,EACZ,UAAU,EACV,eAAe,EACf,YAAY,GACb,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvF,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC9D,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC9D,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACjE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACjE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAChG,OAAO,EAAE,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,QAAQ,CAAC;AAChF,YAAY,EACV,MAAM,EACN,YAAY,EACZ,UAAU,EACV,eAAe,EACf,YAAY,GACb,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvF,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC9D,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC9D,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACjE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACjE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAChG,OAAO,EAAE,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -1,2 +1,2 @@
-import { a as e, i as t, n, r, t as i } from "./attach-VLoZGx-n.js";
-export { r as DEFAULT_FONT_FAMILY, i as attachHud, e as createHud, n as readTokens, t as registerDefaultFont };
+import { a as e, i as t, n, o as r, r as i, s as a, t as o } from "./tool-D2HHqsdo.js";
+export { e as DEFAULT_FONT_FAMILY, o as HUD_AFFORDANCE_KIND, i as attachHud, a as createHud, n as createHudTool, t as readTokens, r as registerDefaultFont };

package/dist/react/index.d.ts

@@ -1,2 +1,2 @@
-export { useHud } from './useHud';
+export { useHud, useHudTool } from './useHud';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC"}

package/dist/react/index.js

@@ -1,14 +1,17 @@
-import { a as e, t } from "../attach-VLoZGx-n.js";
-import { useEffect as n, useState as r } from "react";
+import { n as e, r as t, s as n } from "../tool-D2HHqsdo.js";
+import { useEffect as r, useMemo as i, useState as a } from "react";
 //#region src/react/useHud.ts
-function i(i) {
-	let [a] = r(() => e());
-	return n(() => {
-		let e = i.current;
-		if (e) return t(e, a);
-	}, [a]), a;
+function o(e) {
+	let [i] = a(() => n());
+	return r(() => {
+		let n = e.current;
+		if (n) return t(n, i);
+	}, [i]), i;
+}
+function s() {
+	return i(() => e(), []);
 }
 //#endregion
-export { i as useHud };
+export { o as useHud, s as useHudTool };
 
 //# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/react/useHud.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\nimport { createHud, type Hud } from '../hud';\nimport { attachHud } from '../attach';\nimport type { CanvasExtensionApi } from '@weasel-js/core';\n\n/**\n * Create a HUD and attach it to a Canvas via its imperative ref handle.\n * Returns the Hud immediately (unbound); attaches in an effect after the\n * canvas ref populates. Cleans up on unmount.\n *\n * Usage:\n *   const ref = useRef<CanvasExtensionApi>(null);\n *   const hud = useHud(ref);\n *   // ... later\n *   const btn = hud.button({ ... });\n */\nexport function useHud(canvasRef: { current: CanvasExtensionApi | null }): Hud {\n  const [hud] = useState(() => createHud());\n\n  useEffect(() => {\n    const api = canvasRef.current;\n    if (!api) return;\n    const detach = attachHud(api, hud);\n    return detach;\n    // canvasRef.current changing during component lifetime is unusual for\n    // canvas refs; treat as effectively-stable in v1. The dep on `hud` is\n    // also stable (it comes from useState's initializer, never changes).\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [hud]);\n\n  return hud;\n}\n"],"mappings":";;;AAgBA,SAAgB,EAAO,GAAwD;CAC7E,IAAM,CAAC,KAAO,QAAe,GAAW,CAAC;AAazC,QAXA,QAAgB;EACd,IAAM,IAAM,EAAU;AACjB,QAEL,QADe,EAAU,GAAK,EACvB;IAKN,CAAC,EAAI,CAAC,EAEF"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/react/useHud.ts"],"sourcesContent":["import { useEffect, useMemo, useState } from 'react';\nimport { createHud, type Hud } from '../hud';\nimport { attachHud } from '../attach';\nimport type { CanvasExtensionApi, Tool } from '@weasel-js/core';\nimport { createHudTool } from '../tool';\n\n/**\n * Create a HUD and attach it to a Canvas via its imperative ref handle.\n * Returns the Hud immediately (unbound); attaches in an effect after the\n * canvas ref populates. Cleans up on unmount.\n *\n * Usage:\n *   const ref = useRef<CanvasExtensionApi>(null);\n *   const hud = useHud(ref);\n *   // ... later\n *   const btn = hud.button({ ... });\n */\nexport function useHud(canvasRef: { current: CanvasExtensionApi | null }): Hud {\n  const [hud] = useState(() => createHud());\n\n  useEffect(() => {\n    const api = canvasRef.current;\n    if (!api) return;\n    const detach = attachHud(api, hud);\n    return detach;\n    // canvasRef.current changing during component lifetime is unusual for\n    // canvas refs; treat as effectively-stable in v1. The dep on `hud` is\n    // also stable (it comes from useState's initializer, never changes).\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [hud]);\n\n  return hud;\n}\n\n/**\n * Memoize the HUD's input tool. Pass the result to the canvas as an ambient\n * tool — see {@link createHudTool} for why ambient and how the routing works.\n *\n * The tool is stateless (its actions resolve the hit widget from the gesture's\n * affordance payload), so one instance serves any number of HUDs on the page.\n */\nexport function useHudTool(): Tool<null> {\n  return useMemo(() => createHudTool(), []);\n}\n"],"mappings":";;;AAiBA,SAAgB,EAAO,GAAwD;CAC7E,IAAM,CAAC,KAAO,QAAe,GAAW,CAAC;AAazC,QAXA,QAAgB;EACd,IAAM,IAAM,EAAU;AACjB,QAEL,QADe,EAAU,GAAK,EACvB;IAKN,CAAC,EAAI,CAAC,EAEF;;AAUT,SAAgB,IAAyB;AACvC,QAAO,QAAc,GAAe,EAAE,EAAE,CAAC"}

package/dist/react/useHud.d.ts

@@ -1,5 +1,5 @@
 import { type Hud } from '../hud';
-import type { CanvasExtensionApi } from '@weasel-js/core';
+import type { CanvasExtensionApi, Tool } from '@weasel-js/core';
 /**
  * Create a HUD and attach it to a Canvas via its imperative ref handle.
  * Returns the Hud immediately (unbound); attaches in an effect after the
@@ -14,4 +14,12 @@ import type { CanvasExtensionApi } from '@weasel-js/core';
 export declare function useHud(canvasRef: {
     current: CanvasExtensionApi | null;
 }): Hud;
+/**
+ * Memoize the HUD's input tool. Pass the result to the canvas as an ambient
+ * tool — see {@link createHudTool} for why ambient and how the routing works.
+ *
+ * The tool is stateless (its actions resolve the hit widget from the gesture's
+ * affordance payload), so one instance serves any number of HUDs on the page.
+ */
+export declare function useHudTool(): Tool<null>;
 //# sourceMappingURL=useHud.d.ts.map

package/dist/react/useHud.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useHud.d.ts","sourceRoot":"","sources":["../../src/react/useHud.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,KAAK,GAAG,EAAE,MAAM,QAAQ,CAAC;AAE7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D;;;;;;;;;;GAUG;AACH,wBAAgB,MAAM,CAAC,SAAS,EAAE;IAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAA;CAAE,GAAG,GAAG,CAe7E"}
+{"version":3,"file":"useHud.d.ts","sourceRoot":"","sources":["../../src/react/useHud.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,KAAK,GAAG,EAAE,MAAM,QAAQ,CAAC;AAE7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAGhE;;;;;;;;;;GAUG;AACH,wBAAgB,MAAM,CAAC,SAAS,EAAE;IAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAA;CAAE,GAAG,GAAG,CAe7E;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAAC,IAAI,CAAC,CAEvC"}

package/dist/{attach-VLoZGx-n.js → tool-D2HHqsdo.js}

@@ -1,5 +1,5 @@
 import { textCommand as e, viewToTransform as t, worldToScreen as n } from "@weasel-js/core";
-import { registerFont as r } from "@weasel-js/core/renderer";
+import { registerFont as r } from "@weasel-js/font";
 import { DEFAULT_TOKENS as i } from "@weasel-js/theme";
 //#region src/widgets/rect.ts
 function a(e) {
@@ -410,44 +410,7 @@ function _(e, r) {
 		},
 		hitTest: (e, r, i, o, s) => {
 			let [c, l] = n(e, r, t(o)), u = a(c, l);
-			return u ? {
-				drag: {
-					onStart: (e, r) => {
-						let [i, a] = n(r.worldX, r.worldY, t(r.view));
-						return r.scratch.widget.onPointer({
-							type: "down",
-							x: i,
-							y: a,
-							native: e
-						}), "claim";
-					},
-					onMove: (e, r) => {
-						let [i, a] = n(r.worldX, r.worldY, t(r.view));
-						return r.scratch.widget.onPointer({
-							type: "move",
-							x: i,
-							y: a,
-							native: e
-						}), "claim";
-					},
-					onEnd: (e, r) => {
-						let [i, a] = n(r.worldX, r.worldY, t(r.view));
-						return r.scratch.widget.onPointer({
-							type: "up",
-							x: i,
-							y: a,
-							native: e
-						}), "claim";
-					},
-					onCancel: (e) => {
-						e.scratch.widget.onPointer({
-							type: "cancel",
-							native: new Event("pointercancel")
-						});
-					}
-				},
-				initialScratch: { widget: u }
-			} : null;
+			return u ? { initialScratch: { widget: u } } : null;
 		},
 		onUncapturedMove: (r, o, s, c) => {
 			let [l, u] = n(r, o, t(c)), d = a(l, u);
@@ -476,6 +439,142 @@ function _(e, r) {
 	};
 }
 //#endregion
-export { u as a, m as i, g as n, p as r, _ as t };
+//#region src/tool.ts
+var v = "layer:weasel-hud", y = {
+	shift: "optional",
+	alt: "optional",
+	meta: "optional",
+	ctrl: "optional"
+};
+function b(e) {
+	return e?.kind === v;
+}
+function x(e) {
+	return e?.payload?.widget ?? null;
+}
+function S(e, r, i) {
+	let a = e.view?.get();
+	return a ? n(r, i, t(a)) : [r, i];
+}
+function C() {
+	return {
+		id: "hud.press",
+		label: "HUD — press widget",
+		requires: ["view"],
+		invoker: {
+			timing: "immediate",
+			run: (e, t) => {
+				let n = t, r = x(n?.affordance);
+				if (!r || n?.worldX === void 0 || n.worldY === void 0) return;
+				let [i, a] = S(e, n.worldX, n.worldY);
+				r.onPointer({
+					type: "down",
+					x: i,
+					y: a,
+					native: null
+				});
+			}
+		}
+	};
+}
+function w() {
+	return {
+		id: "hud.release",
+		label: "HUD — release widget",
+		requires: ["view"],
+		invoker: {
+			timing: "immediate",
+			run: (e, t) => {
+				let n = t, r = x(n?.affordance);
+				if (!r || n?.worldX === void 0 || n.worldY === void 0) return;
+				let [i, a] = S(e, n.worldX, n.worldY);
+				r.onPointer({
+					type: "up",
+					x: i,
+					y: a,
+					native: null
+				});
+			}
+		}
+	};
+}
+function T() {
+	return {
+		id: "hud.drag",
+		label: "HUD — drag widget",
+		requires: ["view"],
+		invoker: {
+			timing: "ongoing",
+			start: (e) => {
+				let t = x(e.drag?.affordance);
+				return t ? {
+					onMove: (e) => {
+						let [n, r] = S(e.deps, e.world.x, e.world.y);
+						t.onPointer({
+							type: "move",
+							x: n,
+							y: r,
+							native: null
+						});
+					},
+					onEnd: (e, n) => {
+						if (n === "cancel") {
+							t.onPointer({
+								type: "cancel",
+								native: null
+							});
+							return;
+						}
+						let [r, i] = S(e.deps, e.world.x, e.world.y);
+						t.onPointer({
+							type: "up",
+							x: r,
+							y: i,
+							native: null
+						});
+					}
+				} : {};
+			}
+		}
+	};
+}
+function E() {
+	return {
+		id: "weasel-hud",
+		actions: [
+			C(),
+			w(),
+			T()
+		],
+		bindings: [
+			{
+				spec: {
+					kind: "pointerDown",
+					target: { kindOf: b },
+					mods: y
+				},
+				actionId: "hud.press"
+			},
+			{
+				spec: {
+					kind: "click",
+					target: { kindOf: b },
+					mods: y
+				},
+				actionId: "hud.release"
+			},
+			{
+				spec: {
+					kind: "drag",
+					target: { kindOf: b },
+					mods: y
+				},
+				actionId: "hud.drag"
+			}
+		]
+	};
+}
+//#endregion
+export { p as a, g as i, E as n, m as o, _ as r, u as s, v as t };
 
-//# sourceMappingURL=attach-VLoZGx-n.js.map
+//# sourceMappingURL=tool-D2HHqsdo.js.map