@grida/hud 0.1.0 → 0.2.1

package/dist/index.d.mts

@@ -1,2 +1,107 @@
-import { A as HUDPolyline, C as marqueeToHUDDraw, D as HUDCanvasOptions, E as HUDCanvas, M as HUDRule, N as HUDScreenRect, O as HUDDraw, S as lassoToHUDDraw, T as snapGuideToHUDDraw, _ as Modifiers, a as RenderShape, b as SurfaceEvent, c as HUDStyle, d as Intent, f as IntentPhase, g as RotationCorner, h as ResizeDirection, i as OverlayElement, j as HUDRect, k as HUDLine, l as SelectionGroup, m as CursorIcon, n as MIN_CHROME_VISIBLE_SIZE, o as Surface, p as SurfaceGesture, r as MIN_HIT_SIZE, s as SurfaceOptions, t as HitShape, u as SelectionShape, v as NO_MODS, w as measurementToHUDDraw, x as SurfaceResponse, y as PointerButton } from "./index-CBqCh-ZM.mjs";
-export { type CursorIcon, HUDCanvas, type HUDCanvasOptions, type HUDDraw, type HUDLine, type HUDPolyline, type HUDRect, type HUDRule, type HUDScreenRect, type HUDStyle, type HitShape, type Intent, type IntentPhase, MIN_CHROME_VISIBLE_SIZE, MIN_HIT_SIZE, type Modifiers, NO_MODS, type OverlayElement, type PointerButton, type RenderShape, type ResizeDirection, type RotationCorner, type SelectionGroup, type SelectionShape, Surface, type SurfaceEvent, type SurfaceGesture, type SurfaceOptions, type SurfaceResponse, lassoToHUDDraw, marqueeToHUDDraw, measurementToHUDDraw, snapGuideToHUDDraw };
+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 cursorEquals, i as RotationCorner, n as CursorRenderer, o as cursorToCss, r as ResizeDirection, t as CursorIcon } from "./cursor-CxS8EMvm.mjs";
+import { $ as computeStripesTileGeometry, $t as DEFAULT_RULER_STRIP, A as TransformBoxHover, At as resolveCenterDragAnchor, B as PointerButton, Bt as compose, C as MIN_CHROME_VISIBLE_SIZE, Ct as DrawCornerRadiusParams, D as VectorHover, Dt as cornerRadiusHandlePosRect, E as RenderShape, Et as cornerRadiusHandlePosLine, F as Intent, Ft as SelectionShape, G as measurementToHUDDraw, Gt as DEFAULT_RULER_ACCENT_BACKGROUND, H as SurfaceResponse, Ht as decompose, I as IntentPhase, It as AffineTransform, J as DEFAULT_STRIPES_ANGLE_DEG, Jt as DEFAULT_RULER_COLOR, K as snapGuideToHUDDraw, Kt as DEFAULT_RULER_ACCENT_COLOR, L as SelectMode, Lt as TransformBoxAction, M as PaddingHover, Mt as Rect, N as PaddingOverlayInput, Nt as SurfaceGesture, O as VectorSubSelection, Ot as cornerRadiusLayoutGroups, P as HUDStyle, Pt as SelectionGroup, Q as buildStripesTile, Qt as DEFAULT_RULER_STEPS, R as Modifiers, Rt as TransformBoxCorners, S as HitShape, St as DEFAULT_CORNER_RADIUS_HIT_SIZE, T as OverlayElement, Tt as cornerRadiusAnchorSign, U as lassoToHUDDraw, Ut as getTransformBoxCorners, V as SurfaceEvent, Vt as cornersToBoxTransform, W as marqueeToHUDDraw, Wt as reduceTransformBox, X as DEFAULT_STRIPES_THICKNESS_PX, Xt as DEFAULT_RULER_FONT, Y as DEFAULT_STRIPES_SPACING_PX, Yt as DEFAULT_RULER_DRAG_THRESHOLD, Z as ResolvedPaint, Zt as DEFAULT_RULER_OVERLAP_THRESHOLD, _ as PADDING_HANDLE_PRIORITY, _t as CornerRadiusHandleLayout, a as SurfaceVisibilityPolicy, an as RulerMark, at as DEFAULT_PARAMETRIC_HIT_SIZE, b as VectorOverlay, bt as DEFAULT_CORNER_RADIUS_HANDLE_INSET, c as VectorSelectionMode, cn as DEFAULT_PIXEL_GRID_COLOR, ct as ParametricHandleGroup, d as TRANSFORM_BOX_CORNER_HIT_SIZE, dn as PixelGridConfig, dt as computeParametricHandleLayout, en as DEFAULT_RULER_TEXT_SIDE_OFFSET, et as resolvePaint, f as TRANSFORM_BOX_CORNER_PRIORITY, fn as drawPixelGrid, ft as drawParametricHandles, g as PADDING_HANDLE_LENGTH, gt as CornerRadiusAnchor, h as buildPaddingOverlay, ht as resolveParametricHandleByDirection, i as SurfaceVisibilityContext, in as RulerConfig, it as DEFAULT_PARAMETRIC_HANDLE_SIZE, j as TransformBoxInput, jt as resolveCornerDragAnchor, k as TransformBoxActiveOp, kt as drawCornerRadius, l as buildTransformBox, ln as DEFAULT_PIXEL_GRID_STEPS, lt as ParametricHandleInput, m as TRANSFORM_BOX_SIDE_PRIORITY, mt as projectParametricHandleValue, n as SurfaceOptions, nn as DrawRulerParams, nt as HUDCanvasOptions, o as VectorBendMode, on as RulerRange, ot as DrawParametricHandlesParams, p as TRANSFORM_BOX_SIDE_HIT_THICKNESS, pt as parametricHandleLayoutGroups, q as filterHUDDrawByGroup, qt as DEFAULT_RULER_BACKGROUND, r as SurfaceVisibility, rn as RulerAxis, rt as DEFAULT_PARAMETRIC_HANDLE_INSET, s as VectorInsertionMode, sn as drawRuler, st as ParametricHandle, t as Surface, tn as DEFAULT_RULER_TICK_HEIGHT, tt as HUDCanvas, u as TRANSFORM_BOX_BODY_PRIORITY, un as DrawPixelGridParams, ut as ParametricHandleLayout, v as PADDING_HANDLE_THICKNESS, vt as CornerRadiusInput, w as MIN_HIT_SIZE, wt as computeCornerRadiusLayout, x as SurfaceChromeGroups, xt as DEFAULT_CORNER_RADIUS_HANDLE_SIZE, y as PADDING_REGION_PRIORITY, yt as CornerRadiusRectangular, z as NO_MODS, zt as TransformBoxOptions } from "./index-Cmbe2X5b.mjs";
+
+//#region event/selection-controls.d.ts
+declare const HUDHitPriority: {
+  /** Line endpoints — sole resize affordance on lines; nothing outranks them. */readonly ENDPOINT_HANDLE: 10;
+  /** Edge priority when promoted (parallel axis violated). Edge strip
+   *  extends into the body interior on the perpendicular axis when that
+   *  axis is comfortable; in that case the edge must outrank the
+   *  (also-promoted) body to keep the resize affordance. */
+  readonly RESIZE_HANDLE_EDGE_SMALL: 22;
+  /** Body priority when promoted (any axis violated). Lets the user drag
+   *  from anywhere inside small selections (instead of the corner
+   *  extension stealing the interior). */
+  readonly TRANSLATE_BODY_SMALL: 25;
+  /** Side resize handles (N/S/W/E). Lower than corner so that on the 1-px
+   *  shared boundary between an edge strip and an adjacent corner slot,
+   *  edge wins ("sides take priority over corners"). */
+  readonly RESIZE_HANDLE_EDGE: 30; /** Corner resize handles (NW/NE/SE/SW). */
+  readonly RESIZE_HANDLE_CORNER: 31; /** Translate-body — default value. */
+  readonly TRANSLATE_BODY: 40;
+  /** Rotation halo wraps each resize corner — the rotation hit rect
+   *  overlaps body, edges, and the resize corner itself, but has the
+   *  LOWEST priority of any selection-control zone. It only "wins"
+   *  (becomes the topmost hit) where no other affordance claims the
+   *  pixel: the L-strip immediately outside the resize-corner outer
+   *  edges. This is what gives rotation a gap-free wrap around the
+   *  corner with zero pixel-overlap on the cursor, without ever
+   *  intruding on the body, the edge resize strips, or the corner
+   *  resize knob. Do not place anything below this. */
+  readonly ROTATE_HANDLE: 50;
+};
+/** The principle constant — the minimum guaranteed length for the body
+ *  interior on each axis AND for each side strip along its parallel
+ *  axis. Tunable; everything else derives. */
+declare const MIN_GUARANTEED_INTERACTIVE_DIM = 20;
+/** Below this axis dim, body promotes above corner. Derived from the
+ *  principle. */
+declare const BODY_FLIP_THRESHOLD: number;
+type SelectionControlRole = {
+  kind: "translate";
+} | {
+  kind: "resize_corner";
+  direction: "nw" | "ne" | "se" | "sw";
+} | {
+  kind: "resize_edge";
+  direction: "n" | "e" | "s" | "w";
+} | {
+  kind: "rotate";
+  corner: RotationCorner;
+};
+interface SelectionControlZone {
+  rect: Rect;
+  priority: number;
+  role: SelectionControlRole;
+  /** Stable semantic identifier; matches the OverlayElement.label that
+   *  the chrome builder forwards downstream. */
+  label: string;
+}
+interface SelectionControlLayout {
+  /** Zones in declaration order. Hit-test resolution is by priority; order
+   *  serves as tie-break only. */
+  zones: SelectionControlZone[];
+  /** Whether knobs render visually. False below MIN_CHROME_VISIBLE_SIZE.
+   *  The body zone exists and is hit-able regardless. */
+  controls_visible: boolean;
+  /** True when at least one axis is shorter than BODY_FLIP_THRESHOLD,
+   *  promoting body above corner. */
+  small_mode: boolean;
+}
+/**
+ * @returns { corner, edge } — lengths in screen-px summing to `total`
+ * (corner * 2 + edge === total). Each is `>= 0`.
+ *
+ * Three phases:
+ *  - **comfortable** (`total >= 2 * corner_preferred + edge_min`):
+ *    corners at preferred, edge takes the surplus.
+ *  - **squeezed** (`total >= edge_min`): edge at its min, corners share
+ *    the remainder.
+ *  - **tiny** (`total < edge_min`): edge takes everything, corners 0.
+ */
+declare function negotiateAxis(total: number, corner_preferred: number, edge_min: number): {
+  corner: number;
+  edge: number;
+};
+/**
+ * Compute the selection control layout for a screen-space rect.
+ *
+ * Pure: no DOM, no global state. Same inputs → same zones.
+ *
+ * The perimeter ring straddles the bbox edge with `extension =
+ * hit_size / 2` overhang outside. Along each axis the run of length
+ * `axis_dim + 2 * extension` is split via {@link negotiateAxis} into
+ * `[corner | edge | corner]`. The 4 corners and 4 edges in 2D then tile
+ * the ring as a strict 3×3 grid of cells — **non-overlapping**. Body
+ * sits at rect_screen and may overlap with the ring's inside-bbox half
+ * in comfortable mode; priority resolves those overlaps.
+ *
+ * See the comment block in this file for the full principle.
+ */
+declare function computeSelectionControlLayout(rect_screen: Rect, opts: {
+  handle_size: number;
+  show_rotation: boolean;
+}): SelectionControlLayout;
+//#endregion
+export { type AffineTransform, BODY_FLIP_THRESHOLD, type CornerRadiusAnchor, type CornerRadiusHandleLayout, type CornerRadiusInput, type CornerRadiusRectangular, type CursorIcon, type CursorRenderer, DEFAULT_CORNER_RADIUS_HANDLE_INSET, DEFAULT_CORNER_RADIUS_HANDLE_SIZE, DEFAULT_CORNER_RADIUS_HIT_SIZE, DEFAULT_PARAMETRIC_HANDLE_INSET, DEFAULT_PARAMETRIC_HANDLE_SIZE, DEFAULT_PARAMETRIC_HIT_SIZE, DEFAULT_PIXEL_GRID_COLOR, DEFAULT_PIXEL_GRID_STEPS, DEFAULT_RULER_ACCENT_BACKGROUND, DEFAULT_RULER_ACCENT_COLOR, DEFAULT_RULER_BACKGROUND, DEFAULT_RULER_COLOR, DEFAULT_RULER_DRAG_THRESHOLD, DEFAULT_RULER_FONT, DEFAULT_RULER_OVERLAP_THRESHOLD, DEFAULT_RULER_STEPS, DEFAULT_RULER_STRIP, DEFAULT_RULER_TEXT_SIDE_OFFSET, DEFAULT_RULER_TICK_HEIGHT, DEFAULT_STRIPES_ANGLE_DEG, DEFAULT_STRIPES_SPACING_PX, DEFAULT_STRIPES_THICKNESS_PX, type DrawCornerRadiusParams, type DrawParametricHandlesParams, type DrawPixelGridParams, type DrawRulerParams, HUDCanvas, type HUDCanvasOptions, type HUDDraw, HUDHitPriority, type HUDLine, type HUDPaint, type HUDPaintSolid, type HUDPaintStripes, type HUDPoint, type HUDPolyline, type HUDRect, type HUDRule, type HUDScreenRect, type HUDSemantic, type HUDSemanticGroup, type HUDStyle, type HitShape, type Intent, type IntentPhase, MIN_CHROME_VISIBLE_SIZE, MIN_GUARANTEED_INTERACTIVE_DIM, MIN_HIT_SIZE, type Modifiers, NO_MODS, type OverlayElement, PADDING_HANDLE_LENGTH, PADDING_HANDLE_PRIORITY, PADDING_HANDLE_THICKNESS, PADDING_REGION_PRIORITY, type PaddingHover, type PaddingOverlayInput, type ParametricHandle, type ParametricHandleGroup, type ParametricHandleInput, type ParametricHandleLayout, type PixelGridConfig, type PointerButton, type RenderShape, type ResizeDirection, type ResolvedPaint, type RotationCorner, type RulerAxis, type RulerConfig, type RulerMark, type RulerRange, type SelectMode, type SelectionControlLayout, type SelectionControlRole, type SelectionControlZone, type SelectionGroup, type SelectionShape, Surface, type SurfaceChromeGroups, type SurfaceEvent, type SurfaceGesture, type SurfaceOptions, type SurfaceResponse, type SurfaceVisibility, type SurfaceVisibilityContext, type SurfaceVisibilityPolicy, TRANSFORM_BOX_BODY_PRIORITY, TRANSFORM_BOX_CORNER_HIT_SIZE, TRANSFORM_BOX_CORNER_PRIORITY, TRANSFORM_BOX_SIDE_HIT_THICKNESS, TRANSFORM_BOX_SIDE_PRIORITY, type TransformBoxAction, type TransformBoxActiveOp, type TransformBoxCorners, type TransformBoxHover, type TransformBoxInput, type TransformBoxOptions, type VectorBendMode, type VectorHover, type VectorInsertionMode, type VectorOverlay, type VectorSelectionMode, type VectorSubSelection, buildPaddingOverlay, buildStripesTile, buildTransformBox, compose as composeTransformBox, computeCornerRadiusLayout, computeParametricHandleLayout, computeSelectionControlLayout, computeStripesTileGeometry, cornerRadiusAnchorSign, cornerRadiusHandlePosLine, cornerRadiusHandlePosRect, cornerRadiusLayoutGroups, cornersToBoxTransform, cursorEquals, cursorToCss, decompose as decomposeTransformBox, drawCornerRadius, drawParametricHandles, drawPixelGrid, drawRuler, filterHUDDrawByGroup, getTransformBoxCorners, lassoToHUDDraw, marqueeToHUDDraw, measurementToHUDDraw, negotiateAxis, parametricHandleLayoutGroups, projectParametricHandleValue, reduceTransformBox, resolveCenterDragAnchor, resolveCornerDragAnchor, resolvePaint, resolveParametricHandleByDirection, snapGuideToHUDDraw };

package/dist/index.d.ts

@@ -1,2 +1,107 @@
-import { A as HUDPolyline, C as marqueeToHUDDraw, D as HUDCanvasOptions, E as HUDCanvas, M as HUDRule, N as HUDScreenRect, O as HUDDraw, S as lassoToHUDDraw, T as snapGuideToHUDDraw, _ as Modifiers, a as RenderShape, b as SurfaceEvent, c as HUDStyle, d as Intent, f as IntentPhase, g as RotationCorner, h as ResizeDirection, i as OverlayElement, j as HUDRect, k as HUDLine, l as SelectionGroup, m as CursorIcon, n as MIN_CHROME_VISIBLE_SIZE, o as Surface, p as SurfaceGesture, r as MIN_HIT_SIZE, s as SurfaceOptions, t as HitShape, u as SelectionShape, v as NO_MODS, w as measurementToHUDDraw, x as SurfaceResponse, y as PointerButton } from "./index-DRBeSiI2.js";
-export { type CursorIcon, HUDCanvas, type HUDCanvasOptions, type HUDDraw, type HUDLine, type HUDPolyline, type HUDRect, type HUDRule, type HUDScreenRect, type HUDStyle, type HitShape, type Intent, type IntentPhase, MIN_CHROME_VISIBLE_SIZE, MIN_HIT_SIZE, type Modifiers, NO_MODS, type OverlayElement, type PointerButton, type RenderShape, type ResizeDirection, type RotationCorner, type SelectionGroup, type SelectionShape, Surface, type SurfaceEvent, type SurfaceGesture, type SurfaceOptions, type SurfaceResponse, lassoToHUDDraw, marqueeToHUDDraw, measurementToHUDDraw, snapGuideToHUDDraw };
+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 cursorEquals, i as RotationCorner, n as CursorRenderer, o as cursorToCss, r as ResizeDirection, t as CursorIcon } from "./cursor-CxS8EMvm.js";
+import { $ as computeStripesTileGeometry, $t as DEFAULT_RULER_STRIP, A as TransformBoxHover, At as resolveCenterDragAnchor, B as PointerButton, Bt as compose, C as MIN_CHROME_VISIBLE_SIZE, Ct as DrawCornerRadiusParams, D as VectorHover, Dt as cornerRadiusHandlePosRect, E as RenderShape, Et as cornerRadiusHandlePosLine, F as Intent, Ft as SelectionShape, G as measurementToHUDDraw, Gt as DEFAULT_RULER_ACCENT_BACKGROUND, H as SurfaceResponse, Ht as decompose, I as IntentPhase, It as AffineTransform, J as DEFAULT_STRIPES_ANGLE_DEG, Jt as DEFAULT_RULER_COLOR, K as snapGuideToHUDDraw, Kt as DEFAULT_RULER_ACCENT_COLOR, L as SelectMode, Lt as TransformBoxAction, M as PaddingHover, Mt as Rect, N as PaddingOverlayInput, Nt as SurfaceGesture, O as VectorSubSelection, Ot as cornerRadiusLayoutGroups, P as HUDStyle, Pt as SelectionGroup, Q as buildStripesTile, Qt as DEFAULT_RULER_STEPS, R as Modifiers, Rt as TransformBoxCorners, S as HitShape, St as DEFAULT_CORNER_RADIUS_HIT_SIZE, T as OverlayElement, Tt as cornerRadiusAnchorSign, U as lassoToHUDDraw, Ut as getTransformBoxCorners, V as SurfaceEvent, Vt as cornersToBoxTransform, W as marqueeToHUDDraw, Wt as reduceTransformBox, X as DEFAULT_STRIPES_THICKNESS_PX, Xt as DEFAULT_RULER_FONT, Y as DEFAULT_STRIPES_SPACING_PX, Yt as DEFAULT_RULER_DRAG_THRESHOLD, Z as ResolvedPaint, Zt as DEFAULT_RULER_OVERLAP_THRESHOLD, _ as PADDING_HANDLE_PRIORITY, _t as CornerRadiusHandleLayout, a as SurfaceVisibilityPolicy, an as RulerMark, at as DEFAULT_PARAMETRIC_HIT_SIZE, b as VectorOverlay, bt as DEFAULT_CORNER_RADIUS_HANDLE_INSET, c as VectorSelectionMode, cn as DEFAULT_PIXEL_GRID_COLOR, ct as ParametricHandleGroup, d as TRANSFORM_BOX_CORNER_HIT_SIZE, dn as PixelGridConfig, dt as computeParametricHandleLayout, en as DEFAULT_RULER_TEXT_SIDE_OFFSET, et as resolvePaint, f as TRANSFORM_BOX_CORNER_PRIORITY, fn as drawPixelGrid, ft as drawParametricHandles, g as PADDING_HANDLE_LENGTH, gt as CornerRadiusAnchor, h as buildPaddingOverlay, ht as resolveParametricHandleByDirection, i as SurfaceVisibilityContext, in as RulerConfig, it as DEFAULT_PARAMETRIC_HANDLE_SIZE, j as TransformBoxInput, jt as resolveCornerDragAnchor, k as TransformBoxActiveOp, kt as drawCornerRadius, l as buildTransformBox, ln as DEFAULT_PIXEL_GRID_STEPS, lt as ParametricHandleInput, m as TRANSFORM_BOX_SIDE_PRIORITY, mt as projectParametricHandleValue, n as SurfaceOptions, nn as DrawRulerParams, nt as HUDCanvasOptions, o as VectorBendMode, on as RulerRange, ot as DrawParametricHandlesParams, p as TRANSFORM_BOX_SIDE_HIT_THICKNESS, pt as parametricHandleLayoutGroups, q as filterHUDDrawByGroup, qt as DEFAULT_RULER_BACKGROUND, r as SurfaceVisibility, rn as RulerAxis, rt as DEFAULT_PARAMETRIC_HANDLE_INSET, s as VectorInsertionMode, sn as drawRuler, st as ParametricHandle, t as Surface, tn as DEFAULT_RULER_TICK_HEIGHT, tt as HUDCanvas, u as TRANSFORM_BOX_BODY_PRIORITY, un as DrawPixelGridParams, ut as ParametricHandleLayout, v as PADDING_HANDLE_THICKNESS, vt as CornerRadiusInput, w as MIN_HIT_SIZE, wt as computeCornerRadiusLayout, x as SurfaceChromeGroups, xt as DEFAULT_CORNER_RADIUS_HANDLE_SIZE, y as PADDING_REGION_PRIORITY, yt as CornerRadiusRectangular, z as NO_MODS, zt as TransformBoxOptions } from "./index-BrfEdWbQ.js";
+
+//#region event/selection-controls.d.ts
+declare const HUDHitPriority: {
+  /** Line endpoints — sole resize affordance on lines; nothing outranks them. */readonly ENDPOINT_HANDLE: 10;
+  /** Edge priority when promoted (parallel axis violated). Edge strip
+   *  extends into the body interior on the perpendicular axis when that
+   *  axis is comfortable; in that case the edge must outrank the
+   *  (also-promoted) body to keep the resize affordance. */
+  readonly RESIZE_HANDLE_EDGE_SMALL: 22;
+  /** Body priority when promoted (any axis violated). Lets the user drag
+   *  from anywhere inside small selections (instead of the corner
+   *  extension stealing the interior). */
+  readonly TRANSLATE_BODY_SMALL: 25;
+  /** Side resize handles (N/S/W/E). Lower than corner so that on the 1-px
+   *  shared boundary between an edge strip and an adjacent corner slot,
+   *  edge wins ("sides take priority over corners"). */
+  readonly RESIZE_HANDLE_EDGE: 30; /** Corner resize handles (NW/NE/SE/SW). */
+  readonly RESIZE_HANDLE_CORNER: 31; /** Translate-body — default value. */
+  readonly TRANSLATE_BODY: 40;
+  /** Rotation halo wraps each resize corner — the rotation hit rect
+   *  overlaps body, edges, and the resize corner itself, but has the
+   *  LOWEST priority of any selection-control zone. It only "wins"
+   *  (becomes the topmost hit) where no other affordance claims the
+   *  pixel: the L-strip immediately outside the resize-corner outer
+   *  edges. This is what gives rotation a gap-free wrap around the
+   *  corner with zero pixel-overlap on the cursor, without ever
+   *  intruding on the body, the edge resize strips, or the corner
+   *  resize knob. Do not place anything below this. */
+  readonly ROTATE_HANDLE: 50;
+};
+/** The principle constant — the minimum guaranteed length for the body
+ *  interior on each axis AND for each side strip along its parallel
+ *  axis. Tunable; everything else derives. */
+declare const MIN_GUARANTEED_INTERACTIVE_DIM = 20;
+/** Below this axis dim, body promotes above corner. Derived from the
+ *  principle. */
+declare const BODY_FLIP_THRESHOLD: number;
+type SelectionControlRole = {
+  kind: "translate";
+} | {
+  kind: "resize_corner";
+  direction: "nw" | "ne" | "se" | "sw";
+} | {
+  kind: "resize_edge";
+  direction: "n" | "e" | "s" | "w";
+} | {
+  kind: "rotate";
+  corner: RotationCorner;
+};
+interface SelectionControlZone {
+  rect: Rect;
+  priority: number;
+  role: SelectionControlRole;
+  /** Stable semantic identifier; matches the OverlayElement.label that
+   *  the chrome builder forwards downstream. */
+  label: string;
+}
+interface SelectionControlLayout {
+  /** Zones in declaration order. Hit-test resolution is by priority; order
+   *  serves as tie-break only. */
+  zones: SelectionControlZone[];
+  /** Whether knobs render visually. False below MIN_CHROME_VISIBLE_SIZE.
+   *  The body zone exists and is hit-able regardless. */
+  controls_visible: boolean;
+  /** True when at least one axis is shorter than BODY_FLIP_THRESHOLD,
+   *  promoting body above corner. */
+  small_mode: boolean;
+}
+/**
+ * @returns { corner, edge } — lengths in screen-px summing to `total`
+ * (corner * 2 + edge === total). Each is `>= 0`.
+ *
+ * Three phases:
+ *  - **comfortable** (`total >= 2 * corner_preferred + edge_min`):
+ *    corners at preferred, edge takes the surplus.
+ *  - **squeezed** (`total >= edge_min`): edge at its min, corners share
+ *    the remainder.
+ *  - **tiny** (`total < edge_min`): edge takes everything, corners 0.
+ */
+declare function negotiateAxis(total: number, corner_preferred: number, edge_min: number): {
+  corner: number;
+  edge: number;
+};
+/**
+ * Compute the selection control layout for a screen-space rect.
+ *
+ * Pure: no DOM, no global state. Same inputs → same zones.
+ *
+ * The perimeter ring straddles the bbox edge with `extension =
+ * hit_size / 2` overhang outside. Along each axis the run of length
+ * `axis_dim + 2 * extension` is split via {@link negotiateAxis} into
+ * `[corner | edge | corner]`. The 4 corners and 4 edges in 2D then tile
+ * the ring as a strict 3×3 grid of cells — **non-overlapping**. Body
+ * sits at rect_screen and may overlap with the ring's inside-bbox half
+ * in comfortable mode; priority resolves those overlaps.
+ *
+ * See the comment block in this file for the full principle.
+ */
+declare function computeSelectionControlLayout(rect_screen: Rect, opts: {
+  handle_size: number;
+  show_rotation: boolean;
+}): SelectionControlLayout;
+//#endregion
+export { type AffineTransform, BODY_FLIP_THRESHOLD, type CornerRadiusAnchor, type CornerRadiusHandleLayout, type CornerRadiusInput, type CornerRadiusRectangular, type CursorIcon, type CursorRenderer, DEFAULT_CORNER_RADIUS_HANDLE_INSET, DEFAULT_CORNER_RADIUS_HANDLE_SIZE, DEFAULT_CORNER_RADIUS_HIT_SIZE, DEFAULT_PARAMETRIC_HANDLE_INSET, DEFAULT_PARAMETRIC_HANDLE_SIZE, DEFAULT_PARAMETRIC_HIT_SIZE, DEFAULT_PIXEL_GRID_COLOR, DEFAULT_PIXEL_GRID_STEPS, DEFAULT_RULER_ACCENT_BACKGROUND, DEFAULT_RULER_ACCENT_COLOR, DEFAULT_RULER_BACKGROUND, DEFAULT_RULER_COLOR, DEFAULT_RULER_DRAG_THRESHOLD, DEFAULT_RULER_FONT, DEFAULT_RULER_OVERLAP_THRESHOLD, DEFAULT_RULER_STEPS, DEFAULT_RULER_STRIP, DEFAULT_RULER_TEXT_SIDE_OFFSET, DEFAULT_RULER_TICK_HEIGHT, DEFAULT_STRIPES_ANGLE_DEG, DEFAULT_STRIPES_SPACING_PX, DEFAULT_STRIPES_THICKNESS_PX, type DrawCornerRadiusParams, type DrawParametricHandlesParams, type DrawPixelGridParams, type DrawRulerParams, HUDCanvas, type HUDCanvasOptions, type HUDDraw, HUDHitPriority, type HUDLine, type HUDPaint, type HUDPaintSolid, type HUDPaintStripes, type HUDPoint, type HUDPolyline, type HUDRect, type HUDRule, type HUDScreenRect, type HUDSemantic, type HUDSemanticGroup, type HUDStyle, type HitShape, type Intent, type IntentPhase, MIN_CHROME_VISIBLE_SIZE, MIN_GUARANTEED_INTERACTIVE_DIM, MIN_HIT_SIZE, type Modifiers, NO_MODS, type OverlayElement, PADDING_HANDLE_LENGTH, PADDING_HANDLE_PRIORITY, PADDING_HANDLE_THICKNESS, PADDING_REGION_PRIORITY, type PaddingHover, type PaddingOverlayInput, type ParametricHandle, type ParametricHandleGroup, type ParametricHandleInput, type ParametricHandleLayout, type PixelGridConfig, type PointerButton, type RenderShape, type ResizeDirection, type ResolvedPaint, type RotationCorner, type RulerAxis, type RulerConfig, type RulerMark, type RulerRange, type SelectMode, type SelectionControlLayout, type SelectionControlRole, type SelectionControlZone, type SelectionGroup, type SelectionShape, Surface, type SurfaceChromeGroups, type SurfaceEvent, type SurfaceGesture, type SurfaceOptions, type SurfaceResponse, type SurfaceVisibility, type SurfaceVisibilityContext, type SurfaceVisibilityPolicy, TRANSFORM_BOX_BODY_PRIORITY, TRANSFORM_BOX_CORNER_HIT_SIZE, TRANSFORM_BOX_CORNER_PRIORITY, TRANSFORM_BOX_SIDE_HIT_THICKNESS, TRANSFORM_BOX_SIDE_PRIORITY, type TransformBoxAction, type TransformBoxActiveOp, type TransformBoxCorners, type TransformBoxHover, type TransformBoxInput, type TransformBoxOptions, type VectorBendMode, type VectorHover, type VectorInsertionMode, type VectorOverlay, type VectorSelectionMode, type VectorSubSelection, buildPaddingOverlay, buildStripesTile, buildTransformBox, compose as composeTransformBox, computeCornerRadiusLayout, computeParametricHandleLayout, computeSelectionControlLayout, computeStripesTileGeometry, cornerRadiusAnchorSign, cornerRadiusHandlePosLine, cornerRadiusHandlePosRect, cornerRadiusLayoutGroups, cornersToBoxTransform, cursorEquals, cursorToCss, decompose as decomposeTransformBox, drawCornerRadius, drawParametricHandles, drawPixelGrid, drawRuler, filterHUDDrawByGroup, getTransformBoxCorners, lassoToHUDDraw, marqueeToHUDDraw, measurementToHUDDraw, negotiateAxis, parametricHandleLayoutGroups, projectParametricHandleValue, reduceTransformBox, resolveCenterDragAnchor, resolveCornerDragAnchor, resolvePaint, resolveParametricHandleByDirection, snapGuideToHUDDraw };

package/dist/index.js

@@ -1,11 +1,76 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_surface = require("./surface-CNlBaEXn.js");
+const require_surface = require("./surface-BHQVvRFC.js");
+const require_cursor = require("./cursor-FGiJBdU-.js");
+exports.BODY_FLIP_THRESHOLD = require_surface.BODY_FLIP_THRESHOLD;
+exports.DEFAULT_CORNER_RADIUS_HANDLE_INSET = require_surface.DEFAULT_CORNER_RADIUS_HANDLE_INSET;
+exports.DEFAULT_CORNER_RADIUS_HANDLE_SIZE = require_surface.DEFAULT_CORNER_RADIUS_HANDLE_SIZE;
+exports.DEFAULT_CORNER_RADIUS_HIT_SIZE = require_surface.DEFAULT_CORNER_RADIUS_HIT_SIZE;
+exports.DEFAULT_PARAMETRIC_HANDLE_INSET = require_surface.DEFAULT_PARAMETRIC_HANDLE_INSET;
+exports.DEFAULT_PARAMETRIC_HANDLE_SIZE = require_surface.DEFAULT_PARAMETRIC_HANDLE_SIZE;
+exports.DEFAULT_PARAMETRIC_HIT_SIZE = require_surface.DEFAULT_PARAMETRIC_HIT_SIZE;
+exports.DEFAULT_PIXEL_GRID_COLOR = require_surface.DEFAULT_PIXEL_GRID_COLOR;
+exports.DEFAULT_PIXEL_GRID_STEPS = require_surface.DEFAULT_PIXEL_GRID_STEPS;
+exports.DEFAULT_RULER_ACCENT_BACKGROUND = require_surface.DEFAULT_RULER_ACCENT_BACKGROUND;
+exports.DEFAULT_RULER_ACCENT_COLOR = require_surface.DEFAULT_RULER_ACCENT_COLOR;
+exports.DEFAULT_RULER_BACKGROUND = require_surface.DEFAULT_RULER_BACKGROUND;
+exports.DEFAULT_RULER_COLOR = require_surface.DEFAULT_RULER_COLOR;
+exports.DEFAULT_RULER_DRAG_THRESHOLD = require_surface.DEFAULT_RULER_DRAG_THRESHOLD;
+exports.DEFAULT_RULER_FONT = require_surface.DEFAULT_RULER_FONT;
+exports.DEFAULT_RULER_OVERLAP_THRESHOLD = require_surface.DEFAULT_RULER_OVERLAP_THRESHOLD;
+exports.DEFAULT_RULER_STEPS = require_surface.DEFAULT_RULER_STEPS;
+exports.DEFAULT_RULER_STRIP = require_surface.DEFAULT_RULER_STRIP;
+exports.DEFAULT_RULER_TEXT_SIDE_OFFSET = require_surface.DEFAULT_RULER_TEXT_SIDE_OFFSET;
+exports.DEFAULT_RULER_TICK_HEIGHT = require_surface.DEFAULT_RULER_TICK_HEIGHT;
+exports.DEFAULT_STRIPES_ANGLE_DEG = require_surface.DEFAULT_STRIPES_ANGLE_DEG;
+exports.DEFAULT_STRIPES_SPACING_PX = require_surface.DEFAULT_STRIPES_SPACING_PX;
+exports.DEFAULT_STRIPES_THICKNESS_PX = require_surface.DEFAULT_STRIPES_THICKNESS_PX;
 exports.HUDCanvas = require_surface.HUDCanvas;
+exports.HUDHitPriority = require_surface.HUDHitPriority;
 exports.MIN_CHROME_VISIBLE_SIZE = require_surface.MIN_CHROME_VISIBLE_SIZE;
+exports.MIN_GUARANTEED_INTERACTIVE_DIM = require_surface.MIN_GUARANTEED_INTERACTIVE_DIM;
 exports.MIN_HIT_SIZE = require_surface.MIN_HIT_SIZE;
 exports.NO_MODS = require_surface.NO_MODS;
+exports.PADDING_HANDLE_LENGTH = require_surface.PADDING_HANDLE_LENGTH;
+exports.PADDING_HANDLE_PRIORITY = require_surface.PADDING_HANDLE_PRIORITY;
+exports.PADDING_HANDLE_THICKNESS = require_surface.PADDING_HANDLE_THICKNESS;
+exports.PADDING_REGION_PRIORITY = require_surface.PADDING_REGION_PRIORITY;
 exports.Surface = require_surface.Surface;
+exports.TRANSFORM_BOX_BODY_PRIORITY = require_surface.TRANSFORM_BOX_BODY_PRIORITY;
+exports.TRANSFORM_BOX_CORNER_HIT_SIZE = require_surface.TRANSFORM_BOX_CORNER_HIT_SIZE;
+exports.TRANSFORM_BOX_CORNER_PRIORITY = require_surface.TRANSFORM_BOX_CORNER_PRIORITY;
+exports.TRANSFORM_BOX_SIDE_HIT_THICKNESS = require_surface.TRANSFORM_BOX_SIDE_HIT_THICKNESS;
+exports.TRANSFORM_BOX_SIDE_PRIORITY = require_surface.TRANSFORM_BOX_SIDE_PRIORITY;
+exports.buildPaddingOverlay = require_surface.buildPaddingOverlay;
+exports.buildStripesTile = require_surface.buildStripesTile;
+exports.buildTransformBox = require_surface.buildTransformBox;
+exports.composeTransformBox = require_surface.compose;
+exports.computeCornerRadiusLayout = require_surface.computeCornerRadiusLayout;
+exports.computeParametricHandleLayout = require_surface.computeParametricHandleLayout;
+exports.computeSelectionControlLayout = require_surface.computeSelectionControlLayout;
+exports.computeStripesTileGeometry = require_surface.computeStripesTileGeometry;
+exports.cornerRadiusAnchorSign = require_surface.cornerRadiusAnchorSign;
+exports.cornerRadiusHandlePosLine = require_surface.cornerRadiusHandlePosLine;
+exports.cornerRadiusHandlePosRect = require_surface.cornerRadiusHandlePosRect;
+exports.cornerRadiusLayoutGroups = require_surface.cornerRadiusLayoutGroups;
+exports.cornersToBoxTransform = require_surface.cornersToBoxTransform;
+exports.cursorEquals = require_cursor.cursorEquals;
+exports.cursorToCss = require_cursor.cursorToCss;
+exports.decomposeTransformBox = require_surface.decompose;
+exports.drawCornerRadius = require_surface.drawCornerRadius;
+exports.drawParametricHandles = require_surface.drawParametricHandles;
+exports.drawPixelGrid = require_surface.drawPixelGrid;
+exports.drawRuler = require_surface.drawRuler;
+exports.filterHUDDrawByGroup = require_surface.filterHUDDrawByGroup;
+exports.getTransformBoxCorners = require_surface.getTransformBoxCorners;
 exports.lassoToHUDDraw = require_surface.lassoToHUDDraw;
 exports.marqueeToHUDDraw = require_surface.marqueeToHUDDraw;
 exports.measurementToHUDDraw = require_surface.measurementToHUDDraw;
+exports.negotiateAxis = require_surface.negotiateAxis;
+exports.parametricHandleLayoutGroups = require_surface.parametricHandleLayoutGroups;
+exports.projectParametricHandleValue = require_surface.projectParametricHandleValue;
+exports.reduceTransformBox = require_surface.reduceTransformBox;
+exports.resolveCenterDragAnchor = require_surface.resolveCenterDragAnchor;
+exports.resolveCornerDragAnchor = require_surface.resolveCornerDragAnchor;
+exports.resolvePaint = require_surface.resolvePaint;
+exports.resolveParametricHandleByDirection = require_surface.resolveParametricHandleByDirection;
 exports.snapGuideToHUDDraw = require_surface.snapGuideToHUDDraw;

package/dist/index.mjs

@@ -1,2 +1,3 @@
-import { a as lassoToHUDDraw, c as snapGuideToHUDDraw, i as NO_MODS, l as HUDCanvas, n as MIN_CHROME_VISIBLE_SIZE, o as marqueeToHUDDraw, r as MIN_HIT_SIZE, s as measurementToHUDDraw, t as Surface } from "./surface-hUEeEVdL.mjs";
-export { HUDCanvas, MIN_CHROME_VISIBLE_SIZE, MIN_HIT_SIZE, NO_MODS, Surface, lassoToHUDDraw, marqueeToHUDDraw, measurementToHUDDraw, snapGuideToHUDDraw };
+import { $ as DEFAULT_RULER_BACKGROUND, A as filterHUDDrawByGroup, B as drawCornerRadius, C as PADDING_REGION_PRIORITY, D as marqueeToHUDDraw, E as lassoToHUDDraw, F as computeCornerRadiusLayout, G as DEFAULT_PARAMETRIC_HIT_SIZE, H as resolveCornerDragAnchor, I as cornerRadiusAnchorSign, J as parametricHandleLayoutGroups, K as computeParametricHandleLayout, L as cornerRadiusHandlePosLine, M as DEFAULT_CORNER_RADIUS_HANDLE_INSET, N as DEFAULT_CORNER_RADIUS_HANDLE_SIZE, O as measurementToHUDDraw, P as DEFAULT_CORNER_RADIUS_HIT_SIZE, Q as DEFAULT_RULER_ACCENT_COLOR, R as cornerRadiusHandlePosRect, S as PADDING_HANDLE_THICKNESS, T as MIN_HIT_SIZE, U as DEFAULT_PARAMETRIC_HANDLE_INSET, V as resolveCenterDragAnchor, W as DEFAULT_PARAMETRIC_HANDLE_SIZE, X as resolveParametricHandleByDirection, Y as projectParametricHandleValue, Z as DEFAULT_RULER_ACCENT_BACKGROUND, _ as getTransformBoxCorners, _t as resolvePaint, a as computeSelectionControlLayout, at as DEFAULT_RULER_STRIP, b as PADDING_HANDLE_LENGTH, c as buildTransformBox, ct as drawRuler, d as TRANSFORM_BOX_CORNER_PRIORITY, dt as drawPixelGrid, et as DEFAULT_RULER_COLOR, f as TRANSFORM_BOX_SIDE_HIT_THICKNESS, ft as DEFAULT_STRIPES_ANGLE_DEG, g as decompose, gt as computeStripesTileGeometry, h as cornersToBoxTransform, ht as buildStripesTile, i as MIN_GUARANTEED_INTERACTIVE_DIM, it as DEFAULT_RULER_STEPS, j as HUDCanvas, k as snapGuideToHUDDraw, l as TRANSFORM_BOX_BODY_PRIORITY, lt as DEFAULT_PIXEL_GRID_COLOR, m as compose, mt as DEFAULT_STRIPES_THICKNESS_PX, n as BODY_FLIP_THRESHOLD, nt as DEFAULT_RULER_FONT, o as negotiateAxis, ot as DEFAULT_RULER_TEXT_SIDE_OFFSET, p as TRANSFORM_BOX_SIDE_PRIORITY, pt as DEFAULT_STRIPES_SPACING_PX, q as drawParametricHandles, r as HUDHitPriority, rt as DEFAULT_RULER_OVERLAP_THRESHOLD, s as NO_MODS, st as DEFAULT_RULER_TICK_HEIGHT, t as Surface, tt as DEFAULT_RULER_DRAG_THRESHOLD, u as TRANSFORM_BOX_CORNER_HIT_SIZE, ut as DEFAULT_PIXEL_GRID_STEPS, v as reduceTransformBox, w as MIN_CHROME_VISIBLE_SIZE, x as PADDING_HANDLE_PRIORITY, y as buildPaddingOverlay, z as cornerRadiusLayoutGroups } from "./surface-NHSzUR8r.mjs";
+import { i as cursorToCss, r as cursorEquals } from "./cursor-DW-uAPVE.mjs";
+export { BODY_FLIP_THRESHOLD, DEFAULT_CORNER_RADIUS_HANDLE_INSET, DEFAULT_CORNER_RADIUS_HANDLE_SIZE, DEFAULT_CORNER_RADIUS_HIT_SIZE, DEFAULT_PARAMETRIC_HANDLE_INSET, DEFAULT_PARAMETRIC_HANDLE_SIZE, DEFAULT_PARAMETRIC_HIT_SIZE, DEFAULT_PIXEL_GRID_COLOR, DEFAULT_PIXEL_GRID_STEPS, DEFAULT_RULER_ACCENT_BACKGROUND, DEFAULT_RULER_ACCENT_COLOR, DEFAULT_RULER_BACKGROUND, DEFAULT_RULER_COLOR, DEFAULT_RULER_DRAG_THRESHOLD, DEFAULT_RULER_FONT, DEFAULT_RULER_OVERLAP_THRESHOLD, DEFAULT_RULER_STEPS, DEFAULT_RULER_STRIP, DEFAULT_RULER_TEXT_SIDE_OFFSET, DEFAULT_RULER_TICK_HEIGHT, DEFAULT_STRIPES_ANGLE_DEG, DEFAULT_STRIPES_SPACING_PX, DEFAULT_STRIPES_THICKNESS_PX, HUDCanvas, HUDHitPriority, MIN_CHROME_VISIBLE_SIZE, MIN_GUARANTEED_INTERACTIVE_DIM, MIN_HIT_SIZE, NO_MODS, PADDING_HANDLE_LENGTH, PADDING_HANDLE_PRIORITY, PADDING_HANDLE_THICKNESS, PADDING_REGION_PRIORITY, Surface, TRANSFORM_BOX_BODY_PRIORITY, TRANSFORM_BOX_CORNER_HIT_SIZE, TRANSFORM_BOX_CORNER_PRIORITY, TRANSFORM_BOX_SIDE_HIT_THICKNESS, TRANSFORM_BOX_SIDE_PRIORITY, buildPaddingOverlay, buildStripesTile, buildTransformBox, compose as composeTransformBox, computeCornerRadiusLayout, computeParametricHandleLayout, computeSelectionControlLayout, computeStripesTileGeometry, cornerRadiusAnchorSign, cornerRadiusHandlePosLine, cornerRadiusHandlePosRect, cornerRadiusLayoutGroups, cornersToBoxTransform, cursorEquals, cursorToCss, decompose as decomposeTransformBox, drawCornerRadius, drawParametricHandles, drawPixelGrid, drawRuler, filterHUDDrawByGroup, getTransformBoxCorners, lassoToHUDDraw, marqueeToHUDDraw, measurementToHUDDraw, negotiateAxis, parametricHandleLayoutGroups, projectParametricHandleValue, reduceTransformBox, resolveCenterDragAnchor, resolveCornerDragAnchor, resolvePaint, resolveParametricHandleByDirection, snapGuideToHUDDraw };

package/dist/overlay-CVV4s3IL.d.ts

@@ -0,0 +1,241 @@
+import { f as HUDSemanticGroup, r as HUDPaint } from "./types-3wwFisZs.js";
+import cmath from "@grida/cmath";
+
+//#region primitives/cursor.d.ts
+/** 8 cardinal/diagonal resize directions. */
+type ResizeDirection = "n" | "ne" | "e" | "se" | "s" | "sw" | "w" | "nw";
+/** 4 corner positions for rotation handles. */
+type RotationCorner = "nw" | "ne" | "se" | "sw";
+/**
+ * Logical cursor icon names.
+ *
+ * `baseAngle` (radians) tilts the rendered arrow by an additional
+ * amount on top of the variant's canonical orientation; the
+ * orchestrator sets it when a gesture rotates a selection so the
+ * cursor tracks live rotation.
+ */
+type CursorIcon = "default" | "pointer" | "move" | "crosshair" | "grab" | "grabbing" | "text" | {
+  kind: "resize";
+  direction: ResizeDirection;
+  baseAngle?: number;
+} | {
+  kind: "rotate";
+  corner: RotationCorner;
+  baseAngle?: number;
+};
+/**
+ * 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.
+ */
+declare const CURSOR_ANGLE_BUCKET_RAD: number;
+/** Quantize an angle (radians) to its `CURSOR_ANGLE_BUCKET_RAD` bucket. */
+declare function angleBucket(rad: number | undefined): number;
+/**
+ * Pluggable cursor renderer — maps a logical `CursorIcon` to a CSS
+ * `cursor:` value. Bedrock ships {@link cursorToCss} as the default;
+ * hosts compose their own to substitute SVG data-URLs or platform
+ * extensions.
+ */
+type CursorRenderer = (icon: CursorIcon) => string;
+/**
+ * Default mapping from `CursorIcon` to CSS `cursor` value.
+ */
+declare function cursorToCss(c: CursorIcon): string;
+/**
+ * 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).
+ */
+declare function cursorEquals(a: CursorIcon, b: CursorIcon): boolean;
+//#endregion
+//#region primitives/overlay.d.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.
+ */
+declare 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.
+ */
+declare const MIN_CHROME_VISIBLE_SIZE = 12;
+/**
+ * The hit region of a `HUDObject`. Always screen-space; the variants
+ * differ on how the region is anchored.
+ *
+ * **Variants** (closed taxonomy — no host extension):
+ *
+ *  - `screen_rect_at_doc` — fixed screen-pixel rect, anchored to a
+ *    doc-space point. The hit region tracks the document under camera
+ *    changes; dimensions stay constant in CSS px. Used by handles.
+ *
+ *  - `screen_aabb` — pre-projected screen-space AABB. Used for
+ *    overlays whose layout is already screen-space (edge strips).
+ *
+ *  - `screen_obb` — oriented bounding box. `rect` is axis-aligned in
+ *    a shadow space; `inverse_transform` maps screen → shadow. Lets
+ *    rotated chrome stay exact without AABB inflation.
+ *
+ *  - `screen_circle_at_doc` — fixed screen-pixel circle, anchored to a
+ *    doc-space point. Used by vector-handle dots and parametric-handle
+ *    knobs where a square hit region would feel wrong at the corners.
+ *
+ *  - `screen_polygon` — pre-projected screen-space polygon. Used by
+ *    curved zones (variable-width controls, lasso previews) where AABB
+ *    plus a `customHitTest` callback would otherwise leak host code
+ *    into bedrock.
+ */
+type HitShape = {
+  readonly kind: "screen_rect_at_doc";
+  readonly anchor_doc: cmath.Vector2; /** Screen-space size in CSS px. */
+  readonly width: number;
+  readonly height: number; /** Which point of the rect sits on the anchor. Default: "center". */
+  readonly placement?: "center" | "tl" | "tr" | "bl" | "br";
+} | {
+  readonly kind: "screen_aabb";
+  readonly rect: cmath.Rectangle;
+} | {
+  readonly kind: "screen_obb"; /** Axis-aligned rect in shadow space. */
+  readonly rect: cmath.Rectangle; /** screen → shadow. Applied to the pointer before AABB containment. */
+  readonly inverse_transform: cmath.Transform;
+} | {
+  readonly kind: "screen_circle_at_doc";
+  readonly anchor_doc: cmath.Vector2; /** Radius in screen CSS px. */
+  readonly radius: number;
+} | {
+  readonly kind: "screen_polygon"; /** Pre-projected screen-space polygon vertices. */
+  readonly points: ReadonlyArray<readonly [number, number]>;
+};
+/**
+ * The visual representation of a `HUDObject`. Maps directly onto the
+ * primitive layer's `HUDDraw` entries; the consumer (or the deferred
+ * orchestrator) fans these into one merged `HUDDraw` per frame.
+ *
+ * Closed taxonomy — same set as the legacy `OverlayElement.render`
+ * union (`screen_rect`, `doc_rect`, `doc_line`, `doc_polyline`). No
+ * new variants in bedrock; new render kinds land here only with ≥2
+ * internal consumers shaped (sdk-design promotion bar).
+ */
+type RenderShape = {
+  readonly kind: "screen_rect";
+  readonly anchor_doc: cmath.Vector2;
+  readonly width: number;
+  readonly height: number;
+  readonly placement?: "center" | "tl" | "tr" | "bl" | "br";
+  readonly fill?: boolean;
+  readonly stroke?: boolean;
+  readonly fillColor?: string;
+  readonly strokeColor?: string;
+  readonly angle?: number;
+  readonly shape?: "rect" | "circle";
+} | {
+  readonly kind: "doc_rect";
+  readonly x: number;
+  readonly y: number;
+  readonly width: number;
+  readonly height: number;
+  readonly stroke?: boolean;
+  readonly fill?: boolean;
+  readonly fillOpacity?: number;
+  readonly dashed?: boolean;
+} | {
+  readonly kind: "doc_line";
+  readonly x1: number;
+  readonly y1: number;
+  readonly x2: number;
+  readonly y2: number;
+  readonly dashed?: boolean;
+  readonly strokeWidth?: number;
+  readonly color?: string;
+} | {
+  readonly kind: "doc_polyline";
+  readonly points: ReadonlyArray<readonly [number, number]>;
+  readonly stroke?: boolean;
+  readonly fill?: boolean;
+  readonly fillOpacity?: number;
+  readonly strokeOpacity?: number;
+  readonly strokeWidth?: number;
+  readonly dashed?: boolean;
+  readonly color?: string;
+  readonly fillPaint?: HUDPaint;
+};
+/**
+ * Fields common to every `HUDObject` variant.
+ */
+interface HUDObjectCommon {
+  /** Optional debug label. Stable semantic identifier, e.g.
+   *  `"resize_handle:nw"`, `"my-class:knob"`. */
+  readonly label?: string;
+  /** Semantic group, used by the consumer for visibility filtering. */
+  readonly group?: HUDSemanticGroup;
+  /** Lower wins on overlap. The consumer assigns the integer; bedrock
+   *  treats it opaquely (sort key only). */
+  readonly priority: number;
+}
+/**
+ * Paint-only object: visual chrome that is never hit-tested.
+ * `render` is required; `hit`, `intent`, `cursor` are forbidden.
+ */
+interface HUDObjectPaintOnly extends HUDObjectCommon {
+  readonly render: RenderShape;
+  readonly hit?: never;
+  readonly intent?: never;
+  readonly cursor?: never;
+}
+/**
+ * Interactive object: hit-testable; may also paint, carry an intent,
+ * and a cursor. `hit` is required; the rest are optional.
+ *
+ * Sub-states (none enforced; documented for readers):
+ *  - `intent` absent → silent / hover-only.
+ *  - `intent` present → fully interactive.
+ *  - `render` absent → silent affordance (invisible hit padding around
+ *    a pre-painted target).
+ */
+interface HUDObjectInteractive<I = unknown> extends HUDObjectCommon {
+  readonly hit: HitShape;
+  readonly render?: RenderShape;
+  readonly intent?: I;
+  readonly cursor?: CursorIcon;
+  /**
+   * Optional refinement applied AFTER `hit` containment passes. Return
+   * `false` to reject the hit even though the shape contained the point.
+   *
+   * The point passed is the same screen-space point handed to
+   * `HitRegistry.queryPoint`. Used by curve-shaped affordances (a path
+   * segment's hit region is the bezier's bbox; the refinement asks "are
+   * you actually near the curve in screen-px?") — the one real case that
+   * an AABB/circle/polygon cannot express on its own.
+   *
+   * This is a deliberate, narrow escape hatch, restored after the
+   * vector-path consumer proved an AABB-only hit model drops the
+   * curve-near refinement. It is NOT a general "host runs arbitrary code
+   * in the hit loop" door: it only *narrows* a shape that already
+   * matched; it cannot widen one.
+   */
+  readonly refine?: (p: cmath.Vector2) => boolean;
+}
+/**
+ * The canonical bedrock primitive — the value type a consumer
+ * constructs to participate in HUD.
+ *
+ * Generic over the opaque intent type `I` the consumer supplies; both
+ * bedrock and `HitRegistry<I>` propagate `I` unchanged.
+ *
+ * The discriminated union enforces the (`render` ∨ `hit`) invariant
+ * at compile time: an object with neither field is not assignable to
+ * either variant.
+ */
+type HUDObject<I = unknown> = HUDObjectPaintOnly | HUDObjectInteractive<I>;
+//#endregion
+export { MIN_CHROME_VISIBLE_SIZE as a, CURSOR_ANGLE_BUCKET_RAD as c, ResizeDirection as d, RotationCorner as f, cursorToCss as h, HitShape as i, CursorIcon as l, cursorEquals as m, HUDObjectInteractive as n, MIN_HIT_SIZE as o, angleBucket as p, HUDObjectPaintOnly as r, RenderShape as s, HUDObject as t, CursorRenderer as u };