@grida/hud 0.2.0 → 0.2.2

package/dist/primitives/bedrock.d.mts

@@ -0,0 +1,47 @@
+import { a as HUDPaintStripes, c as HUDRect, d as HUDSemantic, f as HUDSemanticGroup, i as HUDPaintSolid, l as HUDRule, n as HUDLine, o as HUDPoint, r as HUDPaint, s as HUDPolyline, t as HUDDraw, u as HUDScreenRect } from "../types-3wwFisZs.mjs";
+import { a as MIN_CHROME_VISIBLE_SIZE, c as CURSOR_ANGLE_BUCKET_RAD, d as ResizeDirection, f as RotationCorner, h as cursorToCss, i as HitShape, l as CursorIcon, m as cursorEquals, n as HUDObjectInteractive, o as MIN_HIT_SIZE, p as angleBucket, r as HUDObjectPaintOnly, s as RenderShape, t as HUDObject, u as CursorRenderer } from "../overlay-dsG32baA.mjs";
+import cmath from "@grida/cmath";
+
+//#region primitives/painter.d.ts
+/**
+ * Per-frame viewport state handed to `beginFrame`.
+ */
+interface PainterViewport {
+  /** Width in CSS pixels. */
+  readonly w: number;
+  /** Height in CSS pixels. */
+  readonly h: number;
+  /** Device-pixel ratio. */
+  readonly dpr: number;
+}
+/**
+ * Backend-agnostic chrome painter.
+ *
+ * Bedrock contract — exactly four methods. Concrete implementations
+ * (`primitives/painter-canvas2d.ts` ships canvas2d) may add private
+ * helpers, but the public interface is frozen at this shape.
+ *
+ * Frame lifecycle:
+ *
+ *   1. `beginFrame(viewport)` — clear or prepare the backing surface.
+ *   2. `setTransform(t)` — set the camera (doc → screen affine). May
+ *      be called multiple times within a frame.
+ *   3. `draw(d)` — submit a `HUDDraw` payload. May be called multiple
+ *      times within a frame; payloads accumulate.
+ *   4. `endFrame()` — commit. The backing surface displays the frame.
+ *
+ * Implementations MAY no-op `endFrame` (canvas2d does); SVG/DOM
+ * backends use it to flush DOM mutations in a single batch.
+ */
+interface Painter {
+  /** Start a new frame. Implementations clear / reset state here. */
+  beginFrame(viewport: PainterViewport): void;
+  /** Set the camera (doc → screen). */
+  setTransform(t: cmath.Transform): void;
+  /** Paint a `HUDDraw` payload. Calls accumulate within a frame. */
+  draw(d: HUDDraw): void;
+  /** Commit the frame. Implementations flush their backing surface. */
+  endFrame(): void;
+}
+//#endregion
+export { CURSOR_ANGLE_BUCKET_RAD, type CursorIcon, type CursorRenderer, type HUDDraw, type HUDLine, type HUDObject, type HUDObjectInteractive, type HUDObjectPaintOnly, type HUDPaint, type HUDPaintSolid, type HUDPaintStripes, type HUDPoint, type HUDPolyline, type HUDRect, type HUDRule, type HUDScreenRect, type HUDSemantic, type HUDSemanticGroup, type HitShape, MIN_CHROME_VISIBLE_SIZE, MIN_HIT_SIZE, type Painter, type PainterViewport, type RenderShape, type ResizeDirection, type RotationCorner, angleBucket, cursorEquals, cursorToCss };

package/dist/primitives/bedrock.d.ts

@@ -0,0 +1,47 @@
+import { a as HUDPaintStripes, c as HUDRect, d as HUDSemantic, f as HUDSemanticGroup, i as HUDPaintSolid, l as HUDRule, n as HUDLine, o as HUDPoint, r as HUDPaint, s as HUDPolyline, t as HUDDraw, u as HUDScreenRect } from "../types-3wwFisZs.js";
+import { a as MIN_CHROME_VISIBLE_SIZE, c as CURSOR_ANGLE_BUCKET_RAD, d as ResizeDirection, f as RotationCorner, h as cursorToCss, i as HitShape, l as CursorIcon, m as cursorEquals, n as HUDObjectInteractive, o as MIN_HIT_SIZE, p as angleBucket, r as HUDObjectPaintOnly, s as RenderShape, t as HUDObject, u as CursorRenderer } from "../overlay-CVV4s3IL.js";
+import cmath from "@grida/cmath";
+
+//#region primitives/painter.d.ts
+/**
+ * Per-frame viewport state handed to `beginFrame`.
+ */
+interface PainterViewport {
+  /** Width in CSS pixels. */
+  readonly w: number;
+  /** Height in CSS pixels. */
+  readonly h: number;
+  /** Device-pixel ratio. */
+  readonly dpr: number;
+}
+/**
+ * Backend-agnostic chrome painter.
+ *
+ * Bedrock contract — exactly four methods. Concrete implementations
+ * (`primitives/painter-canvas2d.ts` ships canvas2d) may add private
+ * helpers, but the public interface is frozen at this shape.
+ *
+ * Frame lifecycle:
+ *
+ *   1. `beginFrame(viewport)` — clear or prepare the backing surface.
+ *   2. `setTransform(t)` — set the camera (doc → screen affine). May
+ *      be called multiple times within a frame.
+ *   3. `draw(d)` — submit a `HUDDraw` payload. May be called multiple
+ *      times within a frame; payloads accumulate.
+ *   4. `endFrame()` — commit. The backing surface displays the frame.
+ *
+ * Implementations MAY no-op `endFrame` (canvas2d does); SVG/DOM
+ * backends use it to flush DOM mutations in a single batch.
+ */
+interface Painter {
+  /** Start a new frame. Implementations clear / reset state here. */
+  beginFrame(viewport: PainterViewport): void;
+  /** Set the camera (doc → screen). */
+  setTransform(t: cmath.Transform): void;
+  /** Paint a `HUDDraw` payload. Calls accumulate within a frame. */
+  draw(d: HUDDraw): void;
+  /** Commit the frame. Implementations flush their backing surface. */
+  endFrame(): void;
+}
+//#endregion
+export { CURSOR_ANGLE_BUCKET_RAD, type CursorIcon, type CursorRenderer, type HUDDraw, type HUDLine, type HUDObject, type HUDObjectInteractive, type HUDObjectPaintOnly, type HUDPaint, type HUDPaintSolid, type HUDPaintStripes, type HUDPoint, type HUDPolyline, type HUDRect, type HUDRule, type HUDScreenRect, type HUDSemantic, type HUDSemanticGroup, type HitShape, MIN_CHROME_VISIBLE_SIZE, MIN_HIT_SIZE, type Painter, type PainterViewport, type RenderShape, type ResizeDirection, type RotationCorner, angleBucket, cursorEquals, cursorToCss };

package/dist/primitives/bedrock.js

@@ -0,0 +1,71 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region primitives/overlay.ts
+/**
+* Minimum hit-target size in screen-px.
+*
+* Visual knobs are typically 8px; the hit region is 16px so the user
+* does not need pixel-perfect aim (Fitts'). Bedrock constant — value
+* mirrors the legacy `event/overlay.ts` constant during the additive
+* migration.
+*/
+const MIN_HIT_SIZE = 16;
+/**
+* Below this selection size (in screen-px on either axis), chrome is
+* suppressed — both the visual handles AND the hit regions. The
+* consumer enforces this when computing per-frame `HUDObject`s.
+*/
+const MIN_CHROME_VISIBLE_SIZE = 12;
+//#endregion
+//#region primitives/cursor.ts
+/**
+* Angle quantization bucket — 0.5° in radians. Two rotated cursors
+* compare equal when their `baseAngle`s round to the same bucket.
+*
+* 0.5° is below human perception for cursor orientation, so the
+* quantization is visually free.
+*/
+const CURSOR_ANGLE_BUCKET_RAD = Math.PI / 360;
+/** Quantize an angle (radians) to its `CURSOR_ANGLE_BUCKET_RAD` bucket. */
+function angleBucket(rad) {
+	if (rad === void 0 || rad === 0) return 0;
+	return Math.round(rad / CURSOR_ANGLE_BUCKET_RAD);
+}
+/**
+* Default mapping from `CursorIcon` to CSS `cursor` value.
+*/
+function cursorToCss(c) {
+	if (typeof c === "string") switch (c) {
+		case "default": return "default";
+		case "pointer": return "pointer";
+		case "move": return "move";
+		case "crosshair": return "crosshair";
+		case "grab": return "grab";
+		case "grabbing": return "grabbing";
+		case "text": return "text";
+	}
+	if (c.kind === "resize") return `${c.direction}-resize`;
+	return "crosshair";
+}
+/**
+* Cursor equality with `baseAngle` bucketing.
+*
+* Lets a hot path (a rotate-in-progress gesture's per-frame setCursor)
+* emit `cursorChanged` only on visible motion (≥ one bucket of
+* rotation).
+*/
+function cursorEquals(a, b) {
+	if (typeof a === "string" && typeof b === "string") return a === b;
+	if (typeof a !== "string" && typeof b !== "string") {
+		if (a.kind === "resize" && b.kind === "resize") return a.direction === b.direction && angleBucket(a.baseAngle) === angleBucket(b.baseAngle);
+		if (a.kind === "rotate" && b.kind === "rotate") return a.corner === b.corner && angleBucket(a.baseAngle) === angleBucket(b.baseAngle);
+		return false;
+	}
+	return false;
+}
+//#endregion
+exports.CURSOR_ANGLE_BUCKET_RAD = CURSOR_ANGLE_BUCKET_RAD;
+exports.MIN_CHROME_VISIBLE_SIZE = MIN_CHROME_VISIBLE_SIZE;
+exports.MIN_HIT_SIZE = MIN_HIT_SIZE;
+exports.angleBucket = angleBucket;
+exports.cursorEquals = cursorEquals;
+exports.cursorToCss = cursorToCss;

package/dist/primitives/bedrock.mjs

@@ -0,0 +1,65 @@
+//#region primitives/overlay.ts
+/**
+* Minimum hit-target size in screen-px.
+*
+* Visual knobs are typically 8px; the hit region is 16px so the user
+* does not need pixel-perfect aim (Fitts'). Bedrock constant — value
+* mirrors the legacy `event/overlay.ts` constant during the additive
+* migration.
+*/
+const MIN_HIT_SIZE = 16;
+/**
+* Below this selection size (in screen-px on either axis), chrome is
+* suppressed — both the visual handles AND the hit regions. The
+* consumer enforces this when computing per-frame `HUDObject`s.
+*/
+const MIN_CHROME_VISIBLE_SIZE = 12;
+//#endregion
+//#region primitives/cursor.ts
+/**
+* Angle quantization bucket — 0.5° in radians. Two rotated cursors
+* compare equal when their `baseAngle`s round to the same bucket.
+*
+* 0.5° is below human perception for cursor orientation, so the
+* quantization is visually free.
+*/
+const CURSOR_ANGLE_BUCKET_RAD = Math.PI / 360;
+/** Quantize an angle (radians) to its `CURSOR_ANGLE_BUCKET_RAD` bucket. */
+function angleBucket(rad) {
+	if (rad === void 0 || rad === 0) return 0;
+	return Math.round(rad / CURSOR_ANGLE_BUCKET_RAD);
+}
+/**
+* Default mapping from `CursorIcon` to CSS `cursor` value.
+*/
+function cursorToCss(c) {
+	if (typeof c === "string") switch (c) {
+		case "default": return "default";
+		case "pointer": return "pointer";
+		case "move": return "move";
+		case "crosshair": return "crosshair";
+		case "grab": return "grab";
+		case "grabbing": return "grabbing";
+		case "text": return "text";
+	}
+	if (c.kind === "resize") return `${c.direction}-resize`;
+	return "crosshair";
+}
+/**
+* Cursor equality with `baseAngle` bucketing.
+*
+* Lets a hot path (a rotate-in-progress gesture's per-frame setCursor)
+* emit `cursorChanged` only on visible motion (≥ one bucket of
+* rotation).
+*/
+function cursorEquals(a, b) {
+	if (typeof a === "string" && typeof b === "string") return a === b;
+	if (typeof a !== "string" && typeof b !== "string") {
+		if (a.kind === "resize" && b.kind === "resize") return a.direction === b.direction && angleBucket(a.baseAngle) === angleBucket(b.baseAngle);
+		if (a.kind === "rotate" && b.kind === "rotate") return a.corner === b.corner && angleBucket(a.baseAngle) === angleBucket(b.baseAngle);
+		return false;
+	}
+	return false;
+}
+//#endregion
+export { CURSOR_ANGLE_BUCKET_RAD, MIN_CHROME_VISIBLE_SIZE, MIN_HIT_SIZE, angleBucket, cursorEquals, cursorToCss };

package/dist/react.d.mts

@@ -1,6 +1,7 @@
-import { L as HUDDraw, n as SurfaceOptions, t as Surface } from "./index-DhGdcuQz.mjs";
-import { Measurement } from "@grida/cmath/_measurement";
+import { t as HUDDraw } from "./types-3wwFisZs.mjs";
+import { n as SurfaceOptions, t as Surface } from "./index-BQtDtpHM.mjs";
 import cmath from "@grida/cmath";
+import { Measurement } from "@grida/cmath/_measurement";
 import * as React from "react";
 import { SnapResult } from "@grida/cmath/_snap";
 

package/dist/react.d.ts

@@ -1,4 +1,5 @@
-import { L as HUDDraw, n as SurfaceOptions, t as Surface } from "./index-Cp0X4SV7.js";
+import { t as HUDDraw } from "./types-3wwFisZs.js";
+import { n as SurfaceOptions, t as Surface } from "./index-BlfZbeEJ.js";
 import cmath from "@grida/cmath";
 import { SnapResult } from "@grida/cmath/_snap";
 import { Measurement } from "@grida/cmath/_measurement";

package/dist/react.js

@@ -1,6 +1,6 @@
 "use client";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_surface = require("./surface-ofSNTJ8H.js");
+const require_surface = require("./surface-BHDH6P6p.js");
 let react = require("react");
 react = require_surface.__toESM(react);
 let _grida_cmath__snap = require("@grida/cmath/_snap");
@@ -22,15 +22,18 @@ function useHUDSurface(canvasRef, options) {
 	const pickRef = react.useRef(options.pick);
 	const shapeOfRef = react.useRef(options.shapeOf);
 	const onIntentRef = react.useRef(options.onIntent);
+	const onTapRef = react.useRef(options.onTap);
 	pickRef.current = options.pick;
 	shapeOfRef.current = options.shapeOf;
 	onIntentRef.current = options.onIntent;
+	onTapRef.current = options.onTap;
 	react.useLayoutEffect(() => {
 		if (!canvasRef.current) return;
 		const s = new require_surface.Surface(canvasRef.current, {
 			pick: (p) => pickRef.current(p),
 			shapeOf: (id) => shapeOfRef.current(id),
 			onIntent: (i) => onIntentRef.current(i),
+			onTap: (t) => onTapRef.current?.(t),
 			style: options.style,
 			readonly: options.readonly,
 			color: options.color,

package/dist/react.mjs

@@ -1,5 +1,5 @@
 "use client";
-import { d as marqueeToHUDDraw, f as measurementToHUDDraw, h as HUDCanvas, p as snapGuideToHUDDraw, t as Surface, u as lassoToHUDDraw } from "./surface-BvMmXoEl.mjs";
+import { D as marqueeToHUDDraw, E as lassoToHUDDraw, O as measurementToHUDDraw, j as HUDCanvas, k as snapGuideToHUDDraw, t as Surface } from "./surface-B_8w6VWG.mjs";
 import * as React from "react";
 import { guide } from "@grida/cmath/_snap";
 import { jsx } from "react/jsx-runtime";
@@ -20,15 +20,18 @@ function useHUDSurface(canvasRef, options) {
 	const pickRef = React.useRef(options.pick);
 	const shapeOfRef = React.useRef(options.shapeOf);
 	const onIntentRef = React.useRef(options.onIntent);
+	const onTapRef = React.useRef(options.onTap);
 	pickRef.current = options.pick;
 	shapeOfRef.current = options.shapeOf;
 	onIntentRef.current = options.onIntent;
+	onTapRef.current = options.onTap;
 	React.useLayoutEffect(() => {
 		if (!canvasRef.current) return;
 		const s = new Surface(canvasRef.current, {
 			pick: (p) => pickRef.current(p),
 			shapeOf: (id) => shapeOfRef.current(id),
 			onIntent: (i) => onIntentRef.current(i),
+			onTap: (t) => onTapRef.current?.(t),
 			style: options.style,
 			readonly: options.readonly,
 			color: options.color,