@grida/hud 0.2.4 → 0.3.0

package/dist/{index-DHVvd2ak.d.mts → index-Df4QB6Yr.d.mts}

@@ -1,4 +1,4 @@
-import { a as HUDPaintStripes, f as HUDSemanticGroup, r as HUDPaint, t as HUDDraw } from "./types-3wwFisZs.mjs";
+import { a as HUDPaintStripes, f as HUDSemanticGroup, r as HUDPaint, s as HUDPolyline, t as HUDDraw, u as HUDScreenRect } from "./types-3wwFisZs.mjs";
 import { i as RotationCorner, n as CursorRenderer, r as ResizeDirection, t as CursorIcon } from "./cursor-CxS8EMvm.mjs";
 import cmath from "@grida/cmath";
 import { Measurement } from "@grida/cmath/_measurement";
@@ -385,6 +385,10 @@ type SurfaceGesture = {
    */
   initial_shape: SelectionShape; /** Anchor (pointer-down) in document-space. */
   anchor_doc: cmath.Vector2;
+  /** Most-recent pointer position in document-space (= `anchor_doc`
+   *  until the first move). Lets a mid-drag modifier toggle recompute
+   *  `preview_shape` from the live delta without a pointer move. */
+  last_doc: cmath.Vector2;
   /** Current shape during the gesture. Same kind as `initial_shape`.
    *  Opposite-anchored — feeds the emitted `resize` intent (move +
    *  commit). The host derives its own anchor (e.g. Alt → center)
@@ -2830,6 +2834,109 @@ declare function buildTransformBox(input: {
   active_op?: TransformBoxActiveOp;
 }): OverlayElement[];
 //#endregion
+//#region classes/text-edit/input.d.ts
+/**
+ * Caret as two LOCAL endpoints (top, bottom) — NOT a position + height. Two
+ * endpoints let the `transform` tilt/scale the caret as a true affine of a
+ * line segment, which a `{x, top, height}` triple cannot. This is the honest
+ * shape for rotated text and the future per-run textPath case; the common
+ * axis-aligned caret maps trivially (`top=[x, m.top]`, `bottom=[x, m.top+h]`).
+ *
+ * @unstable
+ */
+interface TextEditCaret {
+  /** Caret top endpoint, local space. */
+  top: cmath.Vector2;
+  /** Caret bottom endpoint, local space. */
+  bottom: cmath.Vector2;
+}
+/** One selection-highlight rect in LOCAL space. @unstable */
+interface TextEditSelectionRect {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+}
+/** Optional visual overrides; the builder supplies defaults when absent. @unstable */
+interface TextEditChromeStyle {
+  /** Caret fill color. Default `#2563eb`. */
+  caretColor?: string;
+  /** Caret on-screen thickness in CSS px (zoom-independent). Default 1.5. */
+  caretScreenWidth?: number;
+  /** Selection fill color. Default `#2563eb`. */
+  selectionColor?: string;
+  /** Selection fill opacity, 0–1. Default 0.25. */
+  selectionOpacity?: number;
+}
+/**
+ * Host-pushed text-edit chrome (caret + selection highlights). All geometry
+ * is LOCAL; `transform` maps local → world/doc. The HUD composes `transform`
+ * with its own camera (world → screen) at draw time, so the chrome places
+ * correctly under arbitrary affines (rotated text, nested `<g>` transforms).
+ *
+ * This is the focused generalization that anticipates `<textPath>` WITHOUT
+ * per-glyph path-following: a textPath host emits per-run caret/rects in each
+ * run's local frame and the same composition applies. A single affine cannot
+ * express a curved baseline — that remains out of scope.
+ *
+ * Schema-level feature flag — pass `null` to `setTextEditChrome` to disable.
+ * The caret blinks via the host re-pushing with a flipped `caretVisible`.
+ *
+ * @unstable
+ */
+interface TextEditChromeInput {
+  /** local → world/doc affine. cmath.Transform is a full 2×3 (carries shear). */
+  transform: cmath.Transform;
+  /** Caret geometry; omit when there is no caret (e.g. read-only highlight). */
+  caret?: TextEditCaret;
+  /** Caret blink/visibility. The caret draws only when `caret` is set AND this is true. */
+  caretVisible?: boolean;
+  /** Selection-highlight rects, local space. Empty/omitted = no selection. */
+  selectionRects?: readonly TextEditSelectionRect[];
+  /** Visual overrides; builder defaults when absent. */
+  style?: TextEditChromeStyle;
+  /**
+   * Optional semantic group for the visibility policy. Stamped on every
+   * emitted primitive so a host can suppress the whole chrome atomically.
+   * Default: always rendered while set (the active edit locus has no gesture
+   * during which you'd want it hidden).
+   */
+  group?: HUDSemanticGroup;
+}
+//#endregion
+//#region classes/text-edit/surface.d.ts
+/** On-screen caret thickness in CSS px — zoom-independent by construction. */
+declare const DEFAULT_CARET_SCREEN_WIDTH = 1.5;
+/**
+ * The primitives the text-edit chrome contributes to a frame. Decoration-only,
+ * so this is raw draw primitives (not `OverlayElement`s with hit regions):
+ *
+ * - `polylines` — selection fills, doc-space polygons (the HUD applies the
+ *   camera). Merge into the decoration `polylines` band.
+ * - `screenRects` — the caret, a screen-sized rect anchored at a doc point.
+ *   Merge into the `screenRects` band (above the selection box → never occluded).
+ */
+interface TextEditChromeDraw {
+  polylines: HUDPolyline[];
+  screenRects: HUDScreenRect[];
+}
+/**
+ * Build the per-frame text-edit chrome.
+ *
+ * Composition mirrors `chrome.ts:pushTransformedChrome`:
+ * `local_to_screen = multiply(camera, chrome.transform)`. The selection rects
+ * project to doc space via `chrome.transform` (the HUD applies the camera when
+ * painting); the caret anchor projects the same way, while its on-screen
+ * length + angle come from `local_to_screen` so the bar tracks the projected
+ * glyph height and rotates with the text.
+ *
+ * @param camera the HUD's world→screen transform (`state.getTransform()`).
+ */
+declare function buildTextEditChrome(input: {
+  chrome: TextEditChromeInput;
+  camera: cmath.Transform;
+}): TextEditChromeDraw;
+//#endregion
 //#region surface/surface.d.ts
 interface SurfaceVisibilityContext {
   gesture: SurfaceGesture;
@@ -2986,6 +3093,12 @@ declare class Surface {
    * `setPaddingOverlay`.
    */
   private paddingOverlay;
+  /**
+   * Text-edit chrome input (caret + selection). `null` = no chrome drawn.
+   * Hosts push on inline content-edit (and on every caret move / blink tick /
+   * selection change / camera change); clear on exit. See `setTextEditChrome`.
+   */
+  private textEditChrome;
   private colorOverride;
   private width;
   private height;
@@ -3088,6 +3201,26 @@ declare class Surface {
    * paint/hit/priority details.
    */
   setPaddingOverlay(input: PaddingOverlayInput | null): void;
+  /**
+   * Configure or clear the built-in text-edit chrome — caret + selection
+   * highlights for inline text content-edit. `null` = no chrome drawn
+   * (schema-level feature flag).
+   *
+   * One atomic setter (not separate setCaret / setSelection): caret and
+   * selection are one visual state of one editing session, and a blink tick
+   * only flips `caretVisible` while the selection is unchanged — re-pushing
+   * the whole struct keeps the two from tearing across frames and matches the
+   * Skia `TextEditingDecorations` model. Re-push on every caret move /
+   * selection change / blink tick / camera change. The host owns redraw
+   * timing (this only stores state; `draw()` paints it next frame).
+   *
+   * The caret is drawn ABOVE the selection box (it's a screen-sized rect in
+   * the screenRects band) at a constant on-screen thickness, so it is never
+   * occluded and never scales with zoom. See `@grida/hud/classes/text-edit`.
+   *
+   * @unstable
+   */
+  setTextEditChrome(input: TextEditChromeInput | null): void;
   /**
    * Push a transform-box input — the `transform-box` named class for
    * a 2×3 affine transform manipulated via quad outline + 4 corners +
@@ -3222,4 +3355,4 @@ declare class Surface {
   private registerParametricHandleHitRegions;
 }
 //#endregion
-export { ResolvedPaint as $, DEFAULT_RULER_OVERLAP_THRESHOLD as $t, TransformBoxHover as A, cornerRadiusLayoutGroups as At, Modifiers as B, TransformBoxCorners as Bt, MIN_CHROME_VISIBLE_SIZE as C, DEFAULT_CORNER_RADIUS_HANDLE_SIZE as Ct, VectorHover as D, cornerRadiusAnchorSign as Dt, RenderShape as E, computeCornerRadiusLayout as Et, TapHandler as F, SurfaceGesture as Ft, lassoToHUDDraw as G, getTransformBoxCorners as Gt, PointerButton as H, compose as Ht, TapOutcome as I, SelectionGroup as It, snapGuideToHUDDraw as J, DEFAULT_RULER_ACCENT_COLOR as Jt, marqueeToHUDDraw as K, reduceTransformBox as Kt, Intent as L, SelectionShape as Lt, PaddingHover as M, resolveCenterDragAnchor as Mt, PaddingOverlayInput as N, resolveCornerDragAnchor as Nt, VectorSubSelection as O, cornerRadiusHandlePosLine as Ot, HUDStyle as P, Rect as Pt, DEFAULT_STRIPES_THICKNESS_PX as Q, DEFAULT_RULER_FONT as Qt, IntentPhase as R, AffineTransform as Rt, HitShape as S, DEFAULT_CORNER_RADIUS_HANDLE_INSET as St, OverlayElement as T, DrawCornerRadiusParams as Tt, SurfaceEvent as U, cornersToBoxTransform as Ut, NO_MODS as V, TransformBoxOptions as Vt, SurfaceResponse as W, decompose as Wt, DEFAULT_STRIPES_ANGLE_DEG as X, DEFAULT_RULER_COLOR as Xt, filterHUDDrawByGroup as Y, DEFAULT_RULER_BACKGROUND as Yt, DEFAULT_STRIPES_SPACING_PX as Z, DEFAULT_RULER_DRAG_THRESHOLD as Zt, PADDING_HANDLE_PRIORITY as _, resolveParametricHandleByDirection as _t, SurfaceVisibilityPolicy as a, RulerAxis as an, DEFAULT_PARAMETRIC_HANDLE_INSET as at, VectorOverlay as b, CornerRadiusInput as bt, VectorSelectionMode as c, RulerRange as cn, DrawParametricHandlesParams as ct, TRANSFORM_BOX_CORNER_HIT_SIZE as d, DEFAULT_PIXEL_GRID_STEPS as dn, ParametricHandleInput as dt, DEFAULT_RULER_STEPS as en, buildStripesTile as et, TRANSFORM_BOX_CORNER_PRIORITY as f, DrawPixelGridParams as fn, ParametricHandleLayout as ft, PADDING_HANDLE_LENGTH as g, projectParametricHandleValue as gt, buildPaddingOverlay as h, parametricHandleLayoutGroups as ht, SurfaceVisibilityContext as i, DrawRulerParams as in, HUDCanvasOptions as it, TransformBoxInput as j, drawCornerRadius as jt, TransformBoxActiveOp as k, cornerRadiusHandlePosRect as kt, buildTransformBox as l, drawRuler as ln, ParametricHandle as lt, TRANSFORM_BOX_SIDE_PRIORITY as m, drawPixelGrid as mn, drawParametricHandles as mt, SurfaceOptions as n, DEFAULT_RULER_TEXT_SIDE_OFFSET as nn, resolvePaint as nt, VectorBendMode as o, RulerConfig as on, DEFAULT_PARAMETRIC_HANDLE_SIZE as ot, TRANSFORM_BOX_SIDE_HIT_THICKNESS as p, PixelGridConfig as pn, computeParametricHandleLayout as pt, measurementToHUDDraw as q, DEFAULT_RULER_ACCENT_BACKGROUND as qt, SurfaceVisibility as r, DEFAULT_RULER_TICK_HEIGHT as rn, HUDCanvas as rt, VectorInsertionMode as s, RulerMark as sn, DEFAULT_PARAMETRIC_HIT_SIZE as st, Surface as t, DEFAULT_RULER_STRIP as tn, computeStripesTileGeometry as tt, TRANSFORM_BOX_BODY_PRIORITY as u, DEFAULT_PIXEL_GRID_COLOR as un, ParametricHandleGroup as ut, PADDING_HANDLE_THICKNESS as v, CornerRadiusAnchor as vt, MIN_HIT_SIZE as w, DEFAULT_CORNER_RADIUS_HIT_SIZE as wt, SurfaceChromeGroups as x, CornerRadiusRectangular as xt, PADDING_REGION_PRIORITY as y, CornerRadiusHandleLayout as yt, SelectMode as z, TransformBoxAction as zt };
+export { marqueeToHUDDraw as $, reduceTransformBox as $t, MIN_CHROME_VISIBLE_SIZE as A, DEFAULT_CORNER_RADIUS_HANDLE_SIZE as At, PaddingOverlayInput as B, resolveCornerDragAnchor as Bt, PADDING_HANDLE_LENGTH as C, projectParametricHandleValue as Ct, VectorOverlay as D, CornerRadiusInput as Dt, PADDING_REGION_PRIORITY as E, CornerRadiusHandleLayout as Et, VectorSubSelection as F, cornerRadiusHandlePosLine as Ft, IntentPhase as G, AffineTransform as Gt, TapHandler as H, SurfaceGesture as Ht, TransformBoxActiveOp as I, cornerRadiusHandlePosRect as It, NO_MODS as J, TransformBoxOptions as Jt, SelectMode as K, TransformBoxAction as Kt, TransformBoxHover as L, cornerRadiusLayoutGroups as Lt, OverlayElement as M, DrawCornerRadiusParams as Mt, RenderShape as N, computeCornerRadiusLayout as Nt, SurfaceChromeGroups as O, CornerRadiusRectangular as Ot, VectorHover as P, cornerRadiusAnchorSign as Pt, lassoToHUDDraw as Q, getTransformBoxCorners as Qt, TransformBoxInput as R, drawCornerRadius as Rt, buildPaddingOverlay as S, parametricHandleLayoutGroups as St, PADDING_HANDLE_THICKNESS as T, CornerRadiusAnchor as Tt, TapOutcome as U, SelectionGroup as Ut, HUDStyle as V, Rect as Vt, Intent as W, SelectionShape as Wt, SurfaceEvent as X, cornersToBoxTransform as Xt, PointerButton as Y, compose as Yt, SurfaceResponse as Z, decompose as Zt, TRANSFORM_BOX_BODY_PRIORITY as _, DEFAULT_PIXEL_GRID_COLOR as _n, ParametricHandleGroup as _t, SurfaceVisibilityPolicy as a, DEFAULT_RULER_FONT as an, DEFAULT_STRIPES_THICKNESS_PX as at, TRANSFORM_BOX_SIDE_HIT_THICKNESS as b, PixelGridConfig as bn, computeParametricHandleLayout as bt, VectorSelectionMode as c, DEFAULT_RULER_STRIP as cn, computeStripesTileGeometry as ct, buildTextEditChrome as d, DrawRulerParams as dn, HUDCanvasOptions as dt, DEFAULT_RULER_ACCENT_BACKGROUND as en, measurementToHUDDraw as et, TextEditCaret as f, RulerAxis as fn, DEFAULT_PARAMETRIC_HANDLE_INSET as ft, buildTransformBox as g, drawRuler as gn, ParametricHandle as gt, TextEditSelectionRect as h, RulerRange as hn, DrawParametricHandlesParams as ht, SurfaceVisibilityContext as i, DEFAULT_RULER_DRAG_THRESHOLD as in, DEFAULT_STRIPES_SPACING_PX as it, MIN_HIT_SIZE as j, DEFAULT_CORNER_RADIUS_HIT_SIZE as jt, HitShape as k, DEFAULT_CORNER_RADIUS_HANDLE_INSET as kt, DEFAULT_CARET_SCREEN_WIDTH as l, DEFAULT_RULER_TEXT_SIDE_OFFSET as ln, resolvePaint as lt, TextEditChromeStyle as m, RulerMark as mn, DEFAULT_PARAMETRIC_HIT_SIZE as mt, SurfaceOptions as n, DEFAULT_RULER_BACKGROUND as nn, filterHUDDrawByGroup as nt, VectorBendMode as o, DEFAULT_RULER_OVERLAP_THRESHOLD as on, ResolvedPaint as ot, TextEditChromeInput as p, RulerConfig as pn, DEFAULT_PARAMETRIC_HANDLE_SIZE as pt, Modifiers as q, TransformBoxCorners as qt, SurfaceVisibility as r, DEFAULT_RULER_COLOR as rn, DEFAULT_STRIPES_ANGLE_DEG as rt, VectorInsertionMode as s, DEFAULT_RULER_STEPS as sn, buildStripesTile as st, Surface as t, DEFAULT_RULER_ACCENT_COLOR as tn, snapGuideToHUDDraw as tt, TextEditChromeDraw as u, DEFAULT_RULER_TICK_HEIGHT as un, HUDCanvas as ut, TRANSFORM_BOX_CORNER_HIT_SIZE as v, DEFAULT_PIXEL_GRID_STEPS as vn, ParametricHandleInput as vt, PADDING_HANDLE_PRIORITY as w, resolveParametricHandleByDirection as wt, TRANSFORM_BOX_SIDE_PRIORITY as x, drawPixelGrid as xn, drawParametricHandles as xt, TRANSFORM_BOX_CORNER_PRIORITY as y, DrawPixelGridParams as yn, ParametricHandleLayout as yt, PaddingHover as z, resolveCenterDragAnchor as zt };

package/dist/{index-KI1k5HJX.d.ts → index-E7n0yPim.d.ts}

@@ -1,4 +1,4 @@
-import { a as HUDPaintStripes, f as HUDSemanticGroup, r as HUDPaint, t as HUDDraw } from "./types-3wwFisZs.js";
+import { a as HUDPaintStripes, f as HUDSemanticGroup, r as HUDPaint, s as HUDPolyline, t as HUDDraw, u as HUDScreenRect } from "./types-3wwFisZs.js";
 import { i as RotationCorner, n as CursorRenderer, r as ResizeDirection, t as CursorIcon } from "./cursor-CxS8EMvm.js";
 import cmath from "@grida/cmath";
 import { guide } from "@grida/cmath/_snap";
@@ -385,6 +385,10 @@ type SurfaceGesture = {
    */
   initial_shape: SelectionShape; /** Anchor (pointer-down) in document-space. */
   anchor_doc: cmath.Vector2;
+  /** Most-recent pointer position in document-space (= `anchor_doc`
+   *  until the first move). Lets a mid-drag modifier toggle recompute
+   *  `preview_shape` from the live delta without a pointer move. */
+  last_doc: cmath.Vector2;
   /** Current shape during the gesture. Same kind as `initial_shape`.
    *  Opposite-anchored — feeds the emitted `resize` intent (move +
    *  commit). The host derives its own anchor (e.g. Alt → center)
@@ -2830,6 +2834,109 @@ declare function buildTransformBox(input: {
   active_op?: TransformBoxActiveOp;
 }): OverlayElement[];
 //#endregion
+//#region classes/text-edit/input.d.ts
+/**
+ * Caret as two LOCAL endpoints (top, bottom) — NOT a position + height. Two
+ * endpoints let the `transform` tilt/scale the caret as a true affine of a
+ * line segment, which a `{x, top, height}` triple cannot. This is the honest
+ * shape for rotated text and the future per-run textPath case; the common
+ * axis-aligned caret maps trivially (`top=[x, m.top]`, `bottom=[x, m.top+h]`).
+ *
+ * @unstable
+ */
+interface TextEditCaret {
+  /** Caret top endpoint, local space. */
+  top: cmath.Vector2;
+  /** Caret bottom endpoint, local space. */
+  bottom: cmath.Vector2;
+}
+/** One selection-highlight rect in LOCAL space. @unstable */
+interface TextEditSelectionRect {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+}
+/** Optional visual overrides; the builder supplies defaults when absent. @unstable */
+interface TextEditChromeStyle {
+  /** Caret fill color. Default `#2563eb`. */
+  caretColor?: string;
+  /** Caret on-screen thickness in CSS px (zoom-independent). Default 1.5. */
+  caretScreenWidth?: number;
+  /** Selection fill color. Default `#2563eb`. */
+  selectionColor?: string;
+  /** Selection fill opacity, 0–1. Default 0.25. */
+  selectionOpacity?: number;
+}
+/**
+ * Host-pushed text-edit chrome (caret + selection highlights). All geometry
+ * is LOCAL; `transform` maps local → world/doc. The HUD composes `transform`
+ * with its own camera (world → screen) at draw time, so the chrome places
+ * correctly under arbitrary affines (rotated text, nested `<g>` transforms).
+ *
+ * This is the focused generalization that anticipates `<textPath>` WITHOUT
+ * per-glyph path-following: a textPath host emits per-run caret/rects in each
+ * run's local frame and the same composition applies. A single affine cannot
+ * express a curved baseline — that remains out of scope.
+ *
+ * Schema-level feature flag — pass `null` to `setTextEditChrome` to disable.
+ * The caret blinks via the host re-pushing with a flipped `caretVisible`.
+ *
+ * @unstable
+ */
+interface TextEditChromeInput {
+  /** local → world/doc affine. cmath.Transform is a full 2×3 (carries shear). */
+  transform: cmath.Transform;
+  /** Caret geometry; omit when there is no caret (e.g. read-only highlight). */
+  caret?: TextEditCaret;
+  /** Caret blink/visibility. The caret draws only when `caret` is set AND this is true. */
+  caretVisible?: boolean;
+  /** Selection-highlight rects, local space. Empty/omitted = no selection. */
+  selectionRects?: readonly TextEditSelectionRect[];
+  /** Visual overrides; builder defaults when absent. */
+  style?: TextEditChromeStyle;
+  /**
+   * Optional semantic group for the visibility policy. Stamped on every
+   * emitted primitive so a host can suppress the whole chrome atomically.
+   * Default: always rendered while set (the active edit locus has no gesture
+   * during which you'd want it hidden).
+   */
+  group?: HUDSemanticGroup;
+}
+//#endregion
+//#region classes/text-edit/surface.d.ts
+/** On-screen caret thickness in CSS px — zoom-independent by construction. */
+declare const DEFAULT_CARET_SCREEN_WIDTH = 1.5;
+/**
+ * The primitives the text-edit chrome contributes to a frame. Decoration-only,
+ * so this is raw draw primitives (not `OverlayElement`s with hit regions):
+ *
+ * - `polylines` — selection fills, doc-space polygons (the HUD applies the
+ *   camera). Merge into the decoration `polylines` band.
+ * - `screenRects` — the caret, a screen-sized rect anchored at a doc point.
+ *   Merge into the `screenRects` band (above the selection box → never occluded).
+ */
+interface TextEditChromeDraw {
+  polylines: HUDPolyline[];
+  screenRects: HUDScreenRect[];
+}
+/**
+ * Build the per-frame text-edit chrome.
+ *
+ * Composition mirrors `chrome.ts:pushTransformedChrome`:
+ * `local_to_screen = multiply(camera, chrome.transform)`. The selection rects
+ * project to doc space via `chrome.transform` (the HUD applies the camera when
+ * painting); the caret anchor projects the same way, while its on-screen
+ * length + angle come from `local_to_screen` so the bar tracks the projected
+ * glyph height and rotates with the text.
+ *
+ * @param camera the HUD's world→screen transform (`state.getTransform()`).
+ */
+declare function buildTextEditChrome(input: {
+  chrome: TextEditChromeInput;
+  camera: cmath.Transform;
+}): TextEditChromeDraw;
+//#endregion
 //#region surface/surface.d.ts
 interface SurfaceVisibilityContext {
   gesture: SurfaceGesture;
@@ -2986,6 +3093,12 @@ declare class Surface {
    * `setPaddingOverlay`.
    */
   private paddingOverlay;
+  /**
+   * Text-edit chrome input (caret + selection). `null` = no chrome drawn.
+   * Hosts push on inline content-edit (and on every caret move / blink tick /
+   * selection change / camera change); clear on exit. See `setTextEditChrome`.
+   */
+  private textEditChrome;
   private colorOverride;
   private width;
   private height;
@@ -3088,6 +3201,26 @@ declare class Surface {
    * paint/hit/priority details.
    */
   setPaddingOverlay(input: PaddingOverlayInput | null): void;
+  /**
+   * Configure or clear the built-in text-edit chrome — caret + selection
+   * highlights for inline text content-edit. `null` = no chrome drawn
+   * (schema-level feature flag).
+   *
+   * One atomic setter (not separate setCaret / setSelection): caret and
+   * selection are one visual state of one editing session, and a blink tick
+   * only flips `caretVisible` while the selection is unchanged — re-pushing
+   * the whole struct keeps the two from tearing across frames and matches the
+   * Skia `TextEditingDecorations` model. Re-push on every caret move /
+   * selection change / blink tick / camera change. The host owns redraw
+   * timing (this only stores state; `draw()` paints it next frame).
+   *
+   * The caret is drawn ABOVE the selection box (it's a screen-sized rect in
+   * the screenRects band) at a constant on-screen thickness, so it is never
+   * occluded and never scales with zoom. See `@grida/hud/classes/text-edit`.
+   *
+   * @unstable
+   */
+  setTextEditChrome(input: TextEditChromeInput | null): void;
   /**
    * Push a transform-box input — the `transform-box` named class for
    * a 2×3 affine transform manipulated via quad outline + 4 corners +
@@ -3222,4 +3355,4 @@ declare class Surface {
   private registerParametricHandleHitRegions;
 }
 //#endregion
-export { ResolvedPaint as $, DEFAULT_RULER_OVERLAP_THRESHOLD as $t, TransformBoxHover as A, cornerRadiusLayoutGroups as At, Modifiers as B, TransformBoxCorners as Bt, MIN_CHROME_VISIBLE_SIZE as C, DEFAULT_CORNER_RADIUS_HANDLE_SIZE as Ct, VectorHover as D, cornerRadiusAnchorSign as Dt, RenderShape as E, computeCornerRadiusLayout as Et, TapHandler as F, SurfaceGesture as Ft, lassoToHUDDraw as G, getTransformBoxCorners as Gt, PointerButton as H, compose as Ht, TapOutcome as I, SelectionGroup as It, snapGuideToHUDDraw as J, DEFAULT_RULER_ACCENT_COLOR as Jt, marqueeToHUDDraw as K, reduceTransformBox as Kt, Intent as L, SelectionShape as Lt, PaddingHover as M, resolveCenterDragAnchor as Mt, PaddingOverlayInput as N, resolveCornerDragAnchor as Nt, VectorSubSelection as O, cornerRadiusHandlePosLine as Ot, HUDStyle as P, Rect as Pt, DEFAULT_STRIPES_THICKNESS_PX as Q, DEFAULT_RULER_FONT as Qt, IntentPhase as R, AffineTransform as Rt, HitShape as S, DEFAULT_CORNER_RADIUS_HANDLE_INSET as St, OverlayElement as T, DrawCornerRadiusParams as Tt, SurfaceEvent as U, cornersToBoxTransform as Ut, NO_MODS as V, TransformBoxOptions as Vt, SurfaceResponse as W, decompose as Wt, DEFAULT_STRIPES_ANGLE_DEG as X, DEFAULT_RULER_COLOR as Xt, filterHUDDrawByGroup as Y, DEFAULT_RULER_BACKGROUND as Yt, DEFAULT_STRIPES_SPACING_PX as Z, DEFAULT_RULER_DRAG_THRESHOLD as Zt, PADDING_HANDLE_PRIORITY as _, resolveParametricHandleByDirection as _t, SurfaceVisibilityPolicy as a, RulerAxis as an, DEFAULT_PARAMETRIC_HANDLE_INSET as at, VectorOverlay as b, CornerRadiusInput as bt, VectorSelectionMode as c, RulerRange as cn, DrawParametricHandlesParams as ct, TRANSFORM_BOX_CORNER_HIT_SIZE as d, DEFAULT_PIXEL_GRID_STEPS as dn, ParametricHandleInput as dt, DEFAULT_RULER_STEPS as en, buildStripesTile as et, TRANSFORM_BOX_CORNER_PRIORITY as f, DrawPixelGridParams as fn, ParametricHandleLayout as ft, PADDING_HANDLE_LENGTH as g, projectParametricHandleValue as gt, buildPaddingOverlay as h, parametricHandleLayoutGroups as ht, SurfaceVisibilityContext as i, DrawRulerParams as in, HUDCanvasOptions as it, TransformBoxInput as j, drawCornerRadius as jt, TransformBoxActiveOp as k, cornerRadiusHandlePosRect as kt, buildTransformBox as l, drawRuler as ln, ParametricHandle as lt, TRANSFORM_BOX_SIDE_PRIORITY as m, drawPixelGrid as mn, drawParametricHandles as mt, SurfaceOptions as n, DEFAULT_RULER_TEXT_SIDE_OFFSET as nn, resolvePaint as nt, VectorBendMode as o, RulerConfig as on, DEFAULT_PARAMETRIC_HANDLE_SIZE as ot, TRANSFORM_BOX_SIDE_HIT_THICKNESS as p, PixelGridConfig as pn, computeParametricHandleLayout as pt, measurementToHUDDraw as q, DEFAULT_RULER_ACCENT_BACKGROUND as qt, SurfaceVisibility as r, DEFAULT_RULER_TICK_HEIGHT as rn, HUDCanvas as rt, VectorInsertionMode as s, RulerMark as sn, DEFAULT_PARAMETRIC_HIT_SIZE as st, Surface as t, DEFAULT_RULER_STRIP as tn, computeStripesTileGeometry as tt, TRANSFORM_BOX_BODY_PRIORITY as u, DEFAULT_PIXEL_GRID_COLOR as un, ParametricHandleGroup as ut, PADDING_HANDLE_THICKNESS as v, CornerRadiusAnchor as vt, MIN_HIT_SIZE as w, DEFAULT_CORNER_RADIUS_HIT_SIZE as wt, SurfaceChromeGroups as x, CornerRadiusRectangular as xt, PADDING_REGION_PRIORITY as y, CornerRadiusHandleLayout as yt, SelectMode as z, TransformBoxAction as zt };
+export { marqueeToHUDDraw as $, reduceTransformBox as $t, MIN_CHROME_VISIBLE_SIZE as A, DEFAULT_CORNER_RADIUS_HANDLE_SIZE as At, PaddingOverlayInput as B, resolveCornerDragAnchor as Bt, PADDING_HANDLE_LENGTH as C, projectParametricHandleValue as Ct, VectorOverlay as D, CornerRadiusInput as Dt, PADDING_REGION_PRIORITY as E, CornerRadiusHandleLayout as Et, VectorSubSelection as F, cornerRadiusHandlePosLine as Ft, IntentPhase as G, AffineTransform as Gt, TapHandler as H, SurfaceGesture as Ht, TransformBoxActiveOp as I, cornerRadiusHandlePosRect as It, NO_MODS as J, TransformBoxOptions as Jt, SelectMode as K, TransformBoxAction as Kt, TransformBoxHover as L, cornerRadiusLayoutGroups as Lt, OverlayElement as M, DrawCornerRadiusParams as Mt, RenderShape as N, computeCornerRadiusLayout as Nt, SurfaceChromeGroups as O, CornerRadiusRectangular as Ot, VectorHover as P, cornerRadiusAnchorSign as Pt, lassoToHUDDraw as Q, getTransformBoxCorners as Qt, TransformBoxInput as R, drawCornerRadius as Rt, buildPaddingOverlay as S, parametricHandleLayoutGroups as St, PADDING_HANDLE_THICKNESS as T, CornerRadiusAnchor as Tt, TapOutcome as U, SelectionGroup as Ut, HUDStyle as V, Rect as Vt, Intent as W, SelectionShape as Wt, SurfaceEvent as X, cornersToBoxTransform as Xt, PointerButton as Y, compose as Yt, SurfaceResponse as Z, decompose as Zt, TRANSFORM_BOX_BODY_PRIORITY as _, DEFAULT_PIXEL_GRID_COLOR as _n, ParametricHandleGroup as _t, SurfaceVisibilityPolicy as a, DEFAULT_RULER_FONT as an, DEFAULT_STRIPES_THICKNESS_PX as at, TRANSFORM_BOX_SIDE_HIT_THICKNESS as b, PixelGridConfig as bn, computeParametricHandleLayout as bt, VectorSelectionMode as c, DEFAULT_RULER_STRIP as cn, computeStripesTileGeometry as ct, buildTextEditChrome as d, DrawRulerParams as dn, HUDCanvasOptions as dt, DEFAULT_RULER_ACCENT_BACKGROUND as en, measurementToHUDDraw as et, TextEditCaret as f, RulerAxis as fn, DEFAULT_PARAMETRIC_HANDLE_INSET as ft, buildTransformBox as g, drawRuler as gn, ParametricHandle as gt, TextEditSelectionRect as h, RulerRange as hn, DrawParametricHandlesParams as ht, SurfaceVisibilityContext as i, DEFAULT_RULER_DRAG_THRESHOLD as in, DEFAULT_STRIPES_SPACING_PX as it, MIN_HIT_SIZE as j, DEFAULT_CORNER_RADIUS_HIT_SIZE as jt, HitShape as k, DEFAULT_CORNER_RADIUS_HANDLE_INSET as kt, DEFAULT_CARET_SCREEN_WIDTH as l, DEFAULT_RULER_TEXT_SIDE_OFFSET as ln, resolvePaint as lt, TextEditChromeStyle as m, RulerMark as mn, DEFAULT_PARAMETRIC_HIT_SIZE as mt, SurfaceOptions as n, DEFAULT_RULER_BACKGROUND as nn, filterHUDDrawByGroup as nt, VectorBendMode as o, DEFAULT_RULER_OVERLAP_THRESHOLD as on, ResolvedPaint as ot, TextEditChromeInput as p, RulerConfig as pn, DEFAULT_PARAMETRIC_HANDLE_SIZE as pt, Modifiers as q, TransformBoxCorners as qt, SurfaceVisibility as r, DEFAULT_RULER_COLOR as rn, DEFAULT_STRIPES_ANGLE_DEG as rt, VectorInsertionMode as s, DEFAULT_RULER_STEPS as sn, buildStripesTile as st, Surface as t, DEFAULT_RULER_ACCENT_COLOR as tn, snapGuideToHUDDraw as tt, TextEditChromeDraw as u, DEFAULT_RULER_TICK_HEIGHT as un, HUDCanvas as ut, TRANSFORM_BOX_CORNER_HIT_SIZE as v, DEFAULT_PIXEL_GRID_STEPS as vn, ParametricHandleInput as vt, PADDING_HANDLE_PRIORITY as w, resolveParametricHandleByDirection as wt, TRANSFORM_BOX_SIDE_PRIORITY as x, drawPixelGrid as xn, drawParametricHandles as xt, TRANSFORM_BOX_CORNER_PRIORITY as y, DrawPixelGridParams as yn, ParametricHandleLayout as yt, PaddingHover as z, resolveCenterDragAnchor as zt };

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 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 ResolvedPaint, $t as DEFAULT_RULER_OVERLAP_THRESHOLD, A as TransformBoxHover, At as cornerRadiusLayoutGroups, B as Modifiers, Bt as TransformBoxCorners, C as MIN_CHROME_VISIBLE_SIZE, Ct as DEFAULT_CORNER_RADIUS_HANDLE_SIZE, D as VectorHover, Dt as cornerRadiusAnchorSign, E as RenderShape, Et as computeCornerRadiusLayout, F as TapHandler, Ft as SurfaceGesture, G as lassoToHUDDraw, Gt as getTransformBoxCorners, H as PointerButton, Ht as compose, I as TapOutcome, It as SelectionGroup, J as snapGuideToHUDDraw, Jt as DEFAULT_RULER_ACCENT_COLOR, K as marqueeToHUDDraw, Kt as reduceTransformBox, L as Intent, Lt as SelectionShape, M as PaddingHover, Mt as resolveCenterDragAnchor, N as PaddingOverlayInput, Nt as resolveCornerDragAnchor, O as VectorSubSelection, Ot as cornerRadiusHandlePosLine, P as HUDStyle, Pt as Rect, Q as DEFAULT_STRIPES_THICKNESS_PX, Qt as DEFAULT_RULER_FONT, R as IntentPhase, Rt as AffineTransform, S as HitShape, St as DEFAULT_CORNER_RADIUS_HANDLE_INSET, T as OverlayElement, Tt as DrawCornerRadiusParams, U as SurfaceEvent, Ut as cornersToBoxTransform, V as NO_MODS, Vt as TransformBoxOptions, W as SurfaceResponse, Wt as decompose, X as DEFAULT_STRIPES_ANGLE_DEG, Xt as DEFAULT_RULER_COLOR, Y as filterHUDDrawByGroup, Yt as DEFAULT_RULER_BACKGROUND, Z as DEFAULT_STRIPES_SPACING_PX, Zt as DEFAULT_RULER_DRAG_THRESHOLD, _ as PADDING_HANDLE_PRIORITY, _t as resolveParametricHandleByDirection, a as SurfaceVisibilityPolicy, an as RulerAxis, at as DEFAULT_PARAMETRIC_HANDLE_INSET, b as VectorOverlay, bt as CornerRadiusInput, c as VectorSelectionMode, cn as RulerRange, ct as DrawParametricHandlesParams, d as TRANSFORM_BOX_CORNER_HIT_SIZE, dn as DEFAULT_PIXEL_GRID_STEPS, dt as ParametricHandleInput, en as DEFAULT_RULER_STEPS, et as buildStripesTile, f as TRANSFORM_BOX_CORNER_PRIORITY, fn as DrawPixelGridParams, ft as ParametricHandleLayout, g as PADDING_HANDLE_LENGTH, gt as projectParametricHandleValue, h as buildPaddingOverlay, ht as parametricHandleLayoutGroups, i as SurfaceVisibilityContext, in as DrawRulerParams, it as HUDCanvasOptions, j as TransformBoxInput, jt as drawCornerRadius, k as TransformBoxActiveOp, kt as cornerRadiusHandlePosRect, l as buildTransformBox, ln as drawRuler, lt as ParametricHandle, m as TRANSFORM_BOX_SIDE_PRIORITY, mn as drawPixelGrid, mt as drawParametricHandles, n as SurfaceOptions, nn as DEFAULT_RULER_TEXT_SIDE_OFFSET, nt as resolvePaint, o as VectorBendMode, on as RulerConfig, ot as DEFAULT_PARAMETRIC_HANDLE_SIZE, p as TRANSFORM_BOX_SIDE_HIT_THICKNESS, pn as PixelGridConfig, pt as computeParametricHandleLayout, q as measurementToHUDDraw, qt as DEFAULT_RULER_ACCENT_BACKGROUND, r as SurfaceVisibility, rn as DEFAULT_RULER_TICK_HEIGHT, rt as HUDCanvas, s as VectorInsertionMode, sn as RulerMark, st as DEFAULT_PARAMETRIC_HIT_SIZE, t as Surface, tn as DEFAULT_RULER_STRIP, tt as computeStripesTileGeometry, u as TRANSFORM_BOX_BODY_PRIORITY, un as DEFAULT_PIXEL_GRID_COLOR, ut as ParametricHandleGroup, v as PADDING_HANDLE_THICKNESS, vt as CornerRadiusAnchor, w as MIN_HIT_SIZE, wt as DEFAULT_CORNER_RADIUS_HIT_SIZE, x as SurfaceChromeGroups, xt as CornerRadiusRectangular, y as PADDING_REGION_PRIORITY, yt as CornerRadiusHandleLayout, z as SelectMode, zt as TransformBoxAction } from "./index-DHVvd2ak.mjs";
+import { $ as marqueeToHUDDraw, $t as reduceTransformBox, A as MIN_CHROME_VISIBLE_SIZE, At as DEFAULT_CORNER_RADIUS_HANDLE_SIZE, B as PaddingOverlayInput, Bt as resolveCornerDragAnchor, C as PADDING_HANDLE_LENGTH, Ct as projectParametricHandleValue, D as VectorOverlay, Dt as CornerRadiusInput, E as PADDING_REGION_PRIORITY, Et as CornerRadiusHandleLayout, F as VectorSubSelection, Ft as cornerRadiusHandlePosLine, G as IntentPhase, Gt as AffineTransform, H as TapHandler, Ht as SurfaceGesture, I as TransformBoxActiveOp, It as cornerRadiusHandlePosRect, J as NO_MODS, Jt as TransformBoxOptions, K as SelectMode, Kt as TransformBoxAction, L as TransformBoxHover, Lt as cornerRadiusLayoutGroups, M as OverlayElement, Mt as DrawCornerRadiusParams, N as RenderShape, Nt as computeCornerRadiusLayout, O as SurfaceChromeGroups, Ot as CornerRadiusRectangular, P as VectorHover, Pt as cornerRadiusAnchorSign, Q as lassoToHUDDraw, Qt as getTransformBoxCorners, R as TransformBoxInput, Rt as drawCornerRadius, S as buildPaddingOverlay, St as parametricHandleLayoutGroups, T as PADDING_HANDLE_THICKNESS, Tt as CornerRadiusAnchor, U as TapOutcome, Ut as SelectionGroup, V as HUDStyle, Vt as Rect, W as Intent, Wt as SelectionShape, X as SurfaceEvent, Xt as cornersToBoxTransform, Y as PointerButton, Yt as compose, Z as SurfaceResponse, Zt as decompose, _ as TRANSFORM_BOX_BODY_PRIORITY, _n as DEFAULT_PIXEL_GRID_COLOR, _t as ParametricHandleGroup, a as SurfaceVisibilityPolicy, an as DEFAULT_RULER_FONT, at as DEFAULT_STRIPES_THICKNESS_PX, b as TRANSFORM_BOX_SIDE_HIT_THICKNESS, bn as PixelGridConfig, bt as computeParametricHandleLayout, c as VectorSelectionMode, cn as DEFAULT_RULER_STRIP, ct as computeStripesTileGeometry, d as buildTextEditChrome, dn as DrawRulerParams, dt as HUDCanvasOptions, en as DEFAULT_RULER_ACCENT_BACKGROUND, et as measurementToHUDDraw, f as TextEditCaret, fn as RulerAxis, ft as DEFAULT_PARAMETRIC_HANDLE_INSET, g as buildTransformBox, gn as drawRuler, gt as ParametricHandle, h as TextEditSelectionRect, hn as RulerRange, ht as DrawParametricHandlesParams, i as SurfaceVisibilityContext, in as DEFAULT_RULER_DRAG_THRESHOLD, it as DEFAULT_STRIPES_SPACING_PX, j as MIN_HIT_SIZE, jt as DEFAULT_CORNER_RADIUS_HIT_SIZE, k as HitShape, kt as DEFAULT_CORNER_RADIUS_HANDLE_INSET, l as DEFAULT_CARET_SCREEN_WIDTH, ln as DEFAULT_RULER_TEXT_SIDE_OFFSET, lt as resolvePaint, m as TextEditChromeStyle, mn as RulerMark, mt as DEFAULT_PARAMETRIC_HIT_SIZE, n as SurfaceOptions, nn as DEFAULT_RULER_BACKGROUND, nt as filterHUDDrawByGroup, o as VectorBendMode, on as DEFAULT_RULER_OVERLAP_THRESHOLD, ot as ResolvedPaint, p as TextEditChromeInput, pn as RulerConfig, pt as DEFAULT_PARAMETRIC_HANDLE_SIZE, q as Modifiers, qt as TransformBoxCorners, r as SurfaceVisibility, rn as DEFAULT_RULER_COLOR, rt as DEFAULT_STRIPES_ANGLE_DEG, s as VectorInsertionMode, sn as DEFAULT_RULER_STEPS, st as buildStripesTile, t as Surface, tn as DEFAULT_RULER_ACCENT_COLOR, tt as snapGuideToHUDDraw, u as TextEditChromeDraw, un as DEFAULT_RULER_TICK_HEIGHT, ut as HUDCanvas, v as TRANSFORM_BOX_CORNER_HIT_SIZE, vn as DEFAULT_PIXEL_GRID_STEPS, vt as ParametricHandleInput, w as PADDING_HANDLE_PRIORITY, wt as resolveParametricHandleByDirection, x as TRANSFORM_BOX_SIDE_PRIORITY, xn as drawPixelGrid, xt as drawParametricHandles, y as TRANSFORM_BOX_CORNER_PRIORITY, yn as DrawPixelGridParams, yt as ParametricHandleLayout, z as PaddingHover, zt as resolveCenterDragAnchor } from "./index-Df4QB6Yr.mjs";
 
 //#region event/selection-controls.d.ts
 declare const HUDHitPriority: {
@@ -104,4 +104,4 @@ declare function computeSelectionControlLayout(rect_screen: Rect, opts: {
   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 TapHandler, type TapOutcome, 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 };
+export { type AffineTransform, BODY_FLIP_THRESHOLD, type CornerRadiusAnchor, type CornerRadiusHandleLayout, type CornerRadiusInput, type CornerRadiusRectangular, type CursorIcon, type CursorRenderer, DEFAULT_CARET_SCREEN_WIDTH, 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 TapHandler, type TapOutcome, type TextEditCaret, type TextEditChromeDraw, type TextEditChromeInput, type TextEditChromeStyle, type TextEditSelectionRect, 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, buildTextEditChrome, 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,6 +1,6 @@
 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 ResolvedPaint, $t as DEFAULT_RULER_OVERLAP_THRESHOLD, A as TransformBoxHover, At as cornerRadiusLayoutGroups, B as Modifiers, Bt as TransformBoxCorners, C as MIN_CHROME_VISIBLE_SIZE, Ct as DEFAULT_CORNER_RADIUS_HANDLE_SIZE, D as VectorHover, Dt as cornerRadiusAnchorSign, E as RenderShape, Et as computeCornerRadiusLayout, F as TapHandler, Ft as SurfaceGesture, G as lassoToHUDDraw, Gt as getTransformBoxCorners, H as PointerButton, Ht as compose, I as TapOutcome, It as SelectionGroup, J as snapGuideToHUDDraw, Jt as DEFAULT_RULER_ACCENT_COLOR, K as marqueeToHUDDraw, Kt as reduceTransformBox, L as Intent, Lt as SelectionShape, M as PaddingHover, Mt as resolveCenterDragAnchor, N as PaddingOverlayInput, Nt as resolveCornerDragAnchor, O as VectorSubSelection, Ot as cornerRadiusHandlePosLine, P as HUDStyle, Pt as Rect, Q as DEFAULT_STRIPES_THICKNESS_PX, Qt as DEFAULT_RULER_FONT, R as IntentPhase, Rt as AffineTransform, S as HitShape, St as DEFAULT_CORNER_RADIUS_HANDLE_INSET, T as OverlayElement, Tt as DrawCornerRadiusParams, U as SurfaceEvent, Ut as cornersToBoxTransform, V as NO_MODS, Vt as TransformBoxOptions, W as SurfaceResponse, Wt as decompose, X as DEFAULT_STRIPES_ANGLE_DEG, Xt as DEFAULT_RULER_COLOR, Y as filterHUDDrawByGroup, Yt as DEFAULT_RULER_BACKGROUND, Z as DEFAULT_STRIPES_SPACING_PX, Zt as DEFAULT_RULER_DRAG_THRESHOLD, _ as PADDING_HANDLE_PRIORITY, _t as resolveParametricHandleByDirection, a as SurfaceVisibilityPolicy, an as RulerAxis, at as DEFAULT_PARAMETRIC_HANDLE_INSET, b as VectorOverlay, bt as CornerRadiusInput, c as VectorSelectionMode, cn as RulerRange, ct as DrawParametricHandlesParams, d as TRANSFORM_BOX_CORNER_HIT_SIZE, dn as DEFAULT_PIXEL_GRID_STEPS, dt as ParametricHandleInput, en as DEFAULT_RULER_STEPS, et as buildStripesTile, f as TRANSFORM_BOX_CORNER_PRIORITY, fn as DrawPixelGridParams, ft as ParametricHandleLayout, g as PADDING_HANDLE_LENGTH, gt as projectParametricHandleValue, h as buildPaddingOverlay, ht as parametricHandleLayoutGroups, i as SurfaceVisibilityContext, in as DrawRulerParams, it as HUDCanvasOptions, j as TransformBoxInput, jt as drawCornerRadius, k as TransformBoxActiveOp, kt as cornerRadiusHandlePosRect, l as buildTransformBox, ln as drawRuler, lt as ParametricHandle, m as TRANSFORM_BOX_SIDE_PRIORITY, mn as drawPixelGrid, mt as drawParametricHandles, n as SurfaceOptions, nn as DEFAULT_RULER_TEXT_SIDE_OFFSET, nt as resolvePaint, o as VectorBendMode, on as RulerConfig, ot as DEFAULT_PARAMETRIC_HANDLE_SIZE, p as TRANSFORM_BOX_SIDE_HIT_THICKNESS, pn as PixelGridConfig, pt as computeParametricHandleLayout, q as measurementToHUDDraw, qt as DEFAULT_RULER_ACCENT_BACKGROUND, r as SurfaceVisibility, rn as DEFAULT_RULER_TICK_HEIGHT, rt as HUDCanvas, s as VectorInsertionMode, sn as RulerMark, st as DEFAULT_PARAMETRIC_HIT_SIZE, t as Surface, tn as DEFAULT_RULER_STRIP, tt as computeStripesTileGeometry, u as TRANSFORM_BOX_BODY_PRIORITY, un as DEFAULT_PIXEL_GRID_COLOR, ut as ParametricHandleGroup, v as PADDING_HANDLE_THICKNESS, vt as CornerRadiusAnchor, w as MIN_HIT_SIZE, wt as DEFAULT_CORNER_RADIUS_HIT_SIZE, x as SurfaceChromeGroups, xt as CornerRadiusRectangular, y as PADDING_REGION_PRIORITY, yt as CornerRadiusHandleLayout, z as SelectMode, zt as TransformBoxAction } from "./index-KI1k5HJX.js";
+import { $ as marqueeToHUDDraw, $t as reduceTransformBox, A as MIN_CHROME_VISIBLE_SIZE, At as DEFAULT_CORNER_RADIUS_HANDLE_SIZE, B as PaddingOverlayInput, Bt as resolveCornerDragAnchor, C as PADDING_HANDLE_LENGTH, Ct as projectParametricHandleValue, D as VectorOverlay, Dt as CornerRadiusInput, E as PADDING_REGION_PRIORITY, Et as CornerRadiusHandleLayout, F as VectorSubSelection, Ft as cornerRadiusHandlePosLine, G as IntentPhase, Gt as AffineTransform, H as TapHandler, Ht as SurfaceGesture, I as TransformBoxActiveOp, It as cornerRadiusHandlePosRect, J as NO_MODS, Jt as TransformBoxOptions, K as SelectMode, Kt as TransformBoxAction, L as TransformBoxHover, Lt as cornerRadiusLayoutGroups, M as OverlayElement, Mt as DrawCornerRadiusParams, N as RenderShape, Nt as computeCornerRadiusLayout, O as SurfaceChromeGroups, Ot as CornerRadiusRectangular, P as VectorHover, Pt as cornerRadiusAnchorSign, Q as lassoToHUDDraw, Qt as getTransformBoxCorners, R as TransformBoxInput, Rt as drawCornerRadius, S as buildPaddingOverlay, St as parametricHandleLayoutGroups, T as PADDING_HANDLE_THICKNESS, Tt as CornerRadiusAnchor, U as TapOutcome, Ut as SelectionGroup, V as HUDStyle, Vt as Rect, W as Intent, Wt as SelectionShape, X as SurfaceEvent, Xt as cornersToBoxTransform, Y as PointerButton, Yt as compose, Z as SurfaceResponse, Zt as decompose, _ as TRANSFORM_BOX_BODY_PRIORITY, _n as DEFAULT_PIXEL_GRID_COLOR, _t as ParametricHandleGroup, a as SurfaceVisibilityPolicy, an as DEFAULT_RULER_FONT, at as DEFAULT_STRIPES_THICKNESS_PX, b as TRANSFORM_BOX_SIDE_HIT_THICKNESS, bn as PixelGridConfig, bt as computeParametricHandleLayout, c as VectorSelectionMode, cn as DEFAULT_RULER_STRIP, ct as computeStripesTileGeometry, d as buildTextEditChrome, dn as DrawRulerParams, dt as HUDCanvasOptions, en as DEFAULT_RULER_ACCENT_BACKGROUND, et as measurementToHUDDraw, f as TextEditCaret, fn as RulerAxis, ft as DEFAULT_PARAMETRIC_HANDLE_INSET, g as buildTransformBox, gn as drawRuler, gt as ParametricHandle, h as TextEditSelectionRect, hn as RulerRange, ht as DrawParametricHandlesParams, i as SurfaceVisibilityContext, in as DEFAULT_RULER_DRAG_THRESHOLD, it as DEFAULT_STRIPES_SPACING_PX, j as MIN_HIT_SIZE, jt as DEFAULT_CORNER_RADIUS_HIT_SIZE, k as HitShape, kt as DEFAULT_CORNER_RADIUS_HANDLE_INSET, l as DEFAULT_CARET_SCREEN_WIDTH, ln as DEFAULT_RULER_TEXT_SIDE_OFFSET, lt as resolvePaint, m as TextEditChromeStyle, mn as RulerMark, mt as DEFAULT_PARAMETRIC_HIT_SIZE, n as SurfaceOptions, nn as DEFAULT_RULER_BACKGROUND, nt as filterHUDDrawByGroup, o as VectorBendMode, on as DEFAULT_RULER_OVERLAP_THRESHOLD, ot as ResolvedPaint, p as TextEditChromeInput, pn as RulerConfig, pt as DEFAULT_PARAMETRIC_HANDLE_SIZE, q as Modifiers, qt as TransformBoxCorners, r as SurfaceVisibility, rn as DEFAULT_RULER_COLOR, rt as DEFAULT_STRIPES_ANGLE_DEG, s as VectorInsertionMode, sn as DEFAULT_RULER_STEPS, st as buildStripesTile, t as Surface, tn as DEFAULT_RULER_ACCENT_COLOR, tt as snapGuideToHUDDraw, u as TextEditChromeDraw, un as DEFAULT_RULER_TICK_HEIGHT, ut as HUDCanvas, v as TRANSFORM_BOX_CORNER_HIT_SIZE, vn as DEFAULT_PIXEL_GRID_STEPS, vt as ParametricHandleInput, w as PADDING_HANDLE_PRIORITY, wt as resolveParametricHandleByDirection, x as TRANSFORM_BOX_SIDE_PRIORITY, xn as drawPixelGrid, xt as drawParametricHandles, y as TRANSFORM_BOX_CORNER_PRIORITY, yn as DrawPixelGridParams, yt as ParametricHandleLayout, z as PaddingHover, zt as resolveCenterDragAnchor } from "./index-E7n0yPim.js";
 
 //#region event/selection-controls.d.ts
 declare const HUDHitPriority: {
@@ -104,4 +104,4 @@ declare function computeSelectionControlLayout(rect_screen: Rect, opts: {
   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 TapHandler, type TapOutcome, 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 };
+export { type AffineTransform, BODY_FLIP_THRESHOLD, type CornerRadiusAnchor, type CornerRadiusHandleLayout, type CornerRadiusInput, type CornerRadiusRectangular, type CursorIcon, type CursorRenderer, DEFAULT_CARET_SCREEN_WIDTH, 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 TapHandler, type TapOutcome, type TextEditCaret, type TextEditChromeDraw, type TextEditChromeInput, type TextEditChromeStyle, type TextEditSelectionRect, 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, buildTextEditChrome, 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,7 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_surface = require("./surface-pUdCqwPj.js");
+const require_surface = require("./surface-Bd6zw8O0.js");
 const require_cursor = require("./cursor-FGiJBdU-.js");
 exports.BODY_FLIP_THRESHOLD = require_surface.BODY_FLIP_THRESHOLD;
+exports.DEFAULT_CARET_SCREEN_WIDTH = require_surface.DEFAULT_CARET_SCREEN_WIDTH;
 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;
@@ -42,6 +43,7 @@ exports.TRANSFORM_BOX_SIDE_HIT_THICKNESS = require_surface.TRANSFORM_BOX_SIDE_HI
 exports.TRANSFORM_BOX_SIDE_PRIORITY = require_surface.TRANSFORM_BOX_SIDE_PRIORITY;
 exports.buildPaddingOverlay = require_surface.buildPaddingOverlay;
 exports.buildStripesTile = require_surface.buildStripesTile;
+exports.buildTextEditChrome = require_surface.buildTextEditChrome;
 exports.buildTransformBox = require_surface.buildTransformBox;
 exports.composeTransformBox = require_surface.compose;
 exports.computeCornerRadiusLayout = require_surface.computeCornerRadiusLayout;

package/dist/index.mjs

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

@@ -1,5 +1,5 @@
 import { t as HUDDraw } from "./types-3wwFisZs.mjs";
-import { n as SurfaceOptions, t as Surface } from "./index-DHVvd2ak.mjs";
+import { n as SurfaceOptions, t as Surface } from "./index-Df4QB6Yr.mjs";
 import cmath from "@grida/cmath";
 import { Measurement } from "@grida/cmath/_measurement";
 import * as React from "react";

package/dist/react.d.ts

@@ -1,5 +1,5 @@
 import { t as HUDDraw } from "./types-3wwFisZs.js";
-import { n as SurfaceOptions, t as Surface } from "./index-KI1k5HJX.js";
+import { n as SurfaceOptions, t as Surface } from "./index-E7n0yPim.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-pUdCqwPj.js");
+const require_surface = require("./surface-Bd6zw8O0.js");
 let react = require("react");
 react = require_surface.__toESM(react);
 let _grida_cmath__snap = require("@grida/cmath/_snap");

package/dist/react.mjs

@@ -1,5 +1,5 @@
 "use client";
-import { D as marqueeToHUDDraw, E as lassoToHUDDraw, O as measurementToHUDDraw, j as HUDCanvas, k as snapGuideToHUDDraw, t as Surface } from "./surface-Dh43cAhb.mjs";
+import { A as measurementToHUDDraw, N as HUDCanvas, O as lassoToHUDDraw, j as snapGuideToHUDDraw, k as marqueeToHUDDraw, t as Surface } from "./surface-CNF9XW6b.mjs";
 import * as React from "react";
 import { guide } from "@grida/cmath/_snap";
 import { jsx } from "react/jsx-runtime";

package/dist/{surface-pUdCqwPj.js → surface-Bd6zw8O0.js}

@@ -3600,12 +3600,31 @@ var SurfaceState = class {
 				return this.onPointerUp(event.x, event.y, event.button, deps);
 			case "modifiers":
 				this.modifiers = event.mods;
+				if (this.gesture.kind === "resize") {
+					const g = this.gesture;
+					const dx = g.last_doc[0] - g.anchor_doc[0];
+					const dy = g.last_doc[1] - g.anchor_doc[1];
+					this.gesture = {
+						...g,
+						preview_shape: this.resizePreviewShape(g, dx, dy, g.current_shape)
+					};
+					const response = emptyResponse();
+					response.needsRedraw = true;
+					return response;
+				}
 				return emptyResponse();
 			case "wheel":
 			case "key": return emptyResponse();
 			case "blur": return this.onBlur(deps);
 		}
 	}
+	/** The dashed-preview shape for a resize: center-symmetric under Alt,
+	*  else the opposite-anchored `opposite` shape (which the intent carries).
+	*  One rule, shared by the pointer-move handler and the modifier-toggle
+	*  refresh so the preview can't go stale on a mid-drag Alt flip. */
+	resizePreviewShape(g, dx, dy, opposite) {
+		return this.modifiers.alt ? applyResize(g.initial_shape, g.direction, dx, dy, { fromCenter: true }) : opposite;
+	}
 	onPointerMove(sx, sy, mods, deps) {
 		this.modifiers = mods;
 		const response = emptyResponse();
@@ -3773,11 +3792,12 @@ var SurfaceState = class {
 				const dx = point_doc[0] - g.anchor_doc[0];
 				const dy = point_doc[1] - g.anchor_doc[1];
 				const next_shape = applyResize(g.initial_shape, g.direction, dx, dy);
-				const preview_shape = this.modifiers.alt ? applyResize(g.initial_shape, g.direction, dx, dy, { fromCenter: true }) : next_shape;
+				const preview_shape = this.resizePreviewShape(g, dx, dy, next_shape);
 				this.gesture = {
 					...g,
 					current_shape: next_shape,
-					preview_shape
+					preview_shape,
+					last_doc: point_doc
 				};
 				deps.emitIntent({
 					kind: "resize",
@@ -4246,6 +4266,7 @@ var SurfaceState = class {
 					direction: decision.direction,
 					initial_shape: decision.initial_shape,
 					anchor_doc: point_doc,
+					last_doc: point_doc,
 					current_shape: decision.initial_shape,
 					preview_shape: decision.initial_shape
 				};
@@ -6425,6 +6446,83 @@ function emit_tangent_handle(args) {
 	});
 }
 //#endregion
+//#region classes/text-edit/surface.ts
+/** On-screen caret thickness in CSS px — zoom-independent by construction. */
+const DEFAULT_CARET_SCREEN_WIDTH = 1.5;
+const DEFAULT_CARET_COLOR = "#2563eb";
+const DEFAULT_SELECTION_COLOR = "#2563eb";
+const DEFAULT_SELECTION_OPACITY = .25;
+/**
+* Build the per-frame text-edit chrome.
+*
+* Composition mirrors `chrome.ts:pushTransformedChrome`:
+* `local_to_screen = multiply(camera, chrome.transform)`. The selection rects
+* project to doc space via `chrome.transform` (the HUD applies the camera when
+* painting); the caret anchor projects the same way, while its on-screen
+* length + angle come from `local_to_screen` so the bar tracks the projected
+* glyph height and rotates with the text.
+*
+* @param camera the HUD's world→screen transform (`state.getTransform()`).
+*/
+function buildTextEditChrome(input) {
+	const { chrome, camera } = input;
+	const style = chrome.style ?? {};
+	const caretColor = style.caretColor ?? DEFAULT_CARET_COLOR;
+	const caretScreenWidth = style.caretScreenWidth ?? 1.5;
+	const selectionColor = style.selectionColor ?? DEFAULT_SELECTION_COLOR;
+	const selectionOpacity = style.selectionOpacity ?? DEFAULT_SELECTION_OPACITY;
+	const { group } = chrome;
+	const polylines = [];
+	const screenRects = [];
+	const local_to_screen = _grida_cmath.default.transform.multiply(camera, chrome.transform);
+	for (const r of chrome.selectionRects ?? []) {
+		const corners = _grida_cmath.default.rect.toCorners({
+			x: r.x,
+			y: r.y,
+			width: r.width,
+			height: r.height
+		}).map((p) => _grida_cmath.default.vector2.transform(p, chrome.transform));
+		polylines.push({
+			points: [...corners, corners[0]],
+			stroke: false,
+			fill: true,
+			fillPaint: {
+				kind: "solid",
+				color: selectionColor,
+				opacity: selectionOpacity
+			},
+			group
+		});
+	}
+	if (chrome.caret && chrome.caretVisible) {
+		const { top, bottom } = chrome.caret;
+		const mid_local = [(top[0] + bottom[0]) / 2, (top[1] + bottom[1]) / 2];
+		const anchor_doc = _grida_cmath.default.vector2.transform(mid_local, chrome.transform);
+		const top_screen = _grida_cmath.default.vector2.transform(top, local_to_screen);
+		const bottom_screen = _grida_cmath.default.vector2.transform(bottom, local_to_screen);
+		const dx = bottom_screen[0] - top_screen[0];
+		const dy = bottom_screen[1] - top_screen[1];
+		const screen_len = Math.hypot(dx, dy);
+		const angle_rad = Math.atan2(dy, dx) - Math.PI / 2;
+		screenRects.push({
+			x: anchor_doc[0],
+			y: anchor_doc[1],
+			width: caretScreenWidth,
+			height: screen_len,
+			anchor: "center",
+			angle: angle_rad,
+			fill: true,
+			stroke: false,
+			fillColor: caretColor,
+			group
+		});
+	}
+	return {
+		polylines,
+		screenRects
+	};
+}
+//#endregion
 //#region surface/surface.ts
 /**
 * Top-level wired surface.
@@ -6439,6 +6537,7 @@ var Surface = class {
 		this.cornerRadius = [];
 		this.parametricHandles = [];
 		this.paddingOverlay = null;
+		this.textEditChrome = null;
 		this.width = 0;
 		this.height = 0;
 		this.cursor_renderer = null;
@@ -6578,6 +6677,28 @@ var Surface = class {
 		this.paddingOverlay = input;
 	}
 	/**
+	* Configure or clear the built-in text-edit chrome — caret + selection
+	* highlights for inline text content-edit. `null` = no chrome drawn
+	* (schema-level feature flag).
+	*
+	* One atomic setter (not separate setCaret / setSelection): caret and
+	* selection are one visual state of one editing session, and a blink tick
+	* only flips `caretVisible` while the selection is unchanged — re-pushing
+	* the whole struct keeps the two from tearing across frames and matches the
+	* Skia `TextEditingDecorations` model. Re-push on every caret move /
+	* selection change / blink tick / camera change. The host owns redraw
+	* timing (this only stores state; `draw()` paints it next frame).
+	*
+	* The caret is drawn ABOVE the selection box (it's a screen-sized rect in
+	* the screenRects band) at a constant on-screen thickness, so it is never
+	* occluded and never scales with zoom. See `@grida/hud/classes/text-edit`.
+	*
+	* @unstable
+	*/
+	setTextEditChrome(input) {
+		this.textEditChrome = input;
+	}
+	/**
 	* Push a transform-box input — the `transform-box` named class for
 	* a 2×3 affine transform manipulated via quad outline + 4 corners +
 	* 4 sides + body. `null` = no chrome drawn (schema-level feature
@@ -6754,12 +6875,18 @@ var Surface = class {
 			}
 			this.hudCanvas.setParametricHandles(all_parametric);
 		} else this.hudCanvas.setParametricHandles(null);
-		const decoration_with_extras = lines.length > 0 || polylines.length > 0 ? {
+		const text_edit = this.textEditChrome ? buildTextEditChrome({
+			chrome: this.textEditChrome,
+			camera: this.state.getTransform()
+		}) : null;
+		const all_polylines = text_edit ? [...polylines, ...text_edit.polylines] : polylines;
+		const decoration_with_extras = lines.length > 0 || all_polylines.length > 0 ? {
 			...decoration,
 			lines: lines.length > 0 ? [...decoration.lines ?? [], ...lines] : decoration.lines,
-			polylines: polylines.length > 0 ? [...decoration.polylines ?? [], ...polylines] : decoration.polylines
+			polylines: all_polylines.length > 0 ? [...decoration.polylines ?? [], ...all_polylines] : decoration.polylines
 		} : decoration;
-		this.hudCanvas.draw(filterHUDDrawByGroup(mergeDraws(decoration_with_extras, extra, screenRects), { hidden }));
+		const all_screenRects = text_edit ? [...screenRects, ...text_edit.screenRects] : screenRects;
+		this.hudCanvas.draw(filterHUDDrawByGroup(mergeDraws(decoration_with_extras, extra, all_screenRects), { hidden }));
 	}
 	/** Convenience: clear the canvas (e.g. when the host stops the surface). */
 	clear() {
@@ -6969,6 +7096,12 @@ Object.defineProperty(exports, "BODY_FLIP_THRESHOLD", {
 		return BODY_FLIP_THRESHOLD;
 	}
 });
+Object.defineProperty(exports, "DEFAULT_CARET_SCREEN_WIDTH", {
+	enumerable: true,
+	get: function() {
+		return DEFAULT_CARET_SCREEN_WIDTH;
+	}
+});
 Object.defineProperty(exports, "DEFAULT_CORNER_RADIUS_HANDLE_INSET", {
 	enumerable: true,
 	get: function() {
@@ -7215,6 +7348,12 @@ Object.defineProperty(exports, "buildStripesTile", {
 		return buildStripesTile;
 	}
 });
+Object.defineProperty(exports, "buildTextEditChrome", {
+	enumerable: true,
+	get: function() {
+		return buildTextEditChrome;
+	}
+});
 Object.defineProperty(exports, "buildTransformBox", {
 	enumerable: true,
 	get: function() {

package/dist/{surface-Dh43cAhb.mjs → surface-CNF9XW6b.mjs}

@@ -3577,12 +3577,31 @@ var SurfaceState = class {
 				return this.onPointerUp(event.x, event.y, event.button, deps);
 			case "modifiers":
 				this.modifiers = event.mods;
+				if (this.gesture.kind === "resize") {
+					const g = this.gesture;
+					const dx = g.last_doc[0] - g.anchor_doc[0];
+					const dy = g.last_doc[1] - g.anchor_doc[1];
+					this.gesture = {
+						...g,
+						preview_shape: this.resizePreviewShape(g, dx, dy, g.current_shape)
+					};
+					const response = emptyResponse();
+					response.needsRedraw = true;
+					return response;
+				}
 				return emptyResponse();
 			case "wheel":
 			case "key": return emptyResponse();
 			case "blur": return this.onBlur(deps);
 		}
 	}
+	/** The dashed-preview shape for a resize: center-symmetric under Alt,
+	*  else the opposite-anchored `opposite` shape (which the intent carries).
+	*  One rule, shared by the pointer-move handler and the modifier-toggle
+	*  refresh so the preview can't go stale on a mid-drag Alt flip. */
+	resizePreviewShape(g, dx, dy, opposite) {
+		return this.modifiers.alt ? applyResize(g.initial_shape, g.direction, dx, dy, { fromCenter: true }) : opposite;
+	}
 	onPointerMove(sx, sy, mods, deps) {
 		this.modifiers = mods;
 		const response = emptyResponse();
@@ -3750,11 +3769,12 @@ var SurfaceState = class {
 				const dx = point_doc[0] - g.anchor_doc[0];
 				const dy = point_doc[1] - g.anchor_doc[1];
 				const next_shape = applyResize(g.initial_shape, g.direction, dx, dy);
-				const preview_shape = this.modifiers.alt ? applyResize(g.initial_shape, g.direction, dx, dy, { fromCenter: true }) : next_shape;
+				const preview_shape = this.resizePreviewShape(g, dx, dy, next_shape);
 				this.gesture = {
 					...g,
 					current_shape: next_shape,
-					preview_shape
+					preview_shape,
+					last_doc: point_doc
 				};
 				deps.emitIntent({
 					kind: "resize",
@@ -4223,6 +4243,7 @@ var SurfaceState = class {
 					direction: decision.direction,
 					initial_shape: decision.initial_shape,
 					anchor_doc: point_doc,
+					last_doc: point_doc,
 					current_shape: decision.initial_shape,
 					preview_shape: decision.initial_shape
 				};
@@ -6402,6 +6423,83 @@ function emit_tangent_handle(args) {
 	});
 }
 //#endregion
+//#region classes/text-edit/surface.ts
+/** On-screen caret thickness in CSS px — zoom-independent by construction. */
+const DEFAULT_CARET_SCREEN_WIDTH = 1.5;
+const DEFAULT_CARET_COLOR = "#2563eb";
+const DEFAULT_SELECTION_COLOR = "#2563eb";
+const DEFAULT_SELECTION_OPACITY = .25;
+/**
+* Build the per-frame text-edit chrome.
+*
+* Composition mirrors `chrome.ts:pushTransformedChrome`:
+* `local_to_screen = multiply(camera, chrome.transform)`. The selection rects
+* project to doc space via `chrome.transform` (the HUD applies the camera when
+* painting); the caret anchor projects the same way, while its on-screen
+* length + angle come from `local_to_screen` so the bar tracks the projected
+* glyph height and rotates with the text.
+*
+* @param camera the HUD's world→screen transform (`state.getTransform()`).
+*/
+function buildTextEditChrome(input) {
+	const { chrome, camera } = input;
+	const style = chrome.style ?? {};
+	const caretColor = style.caretColor ?? DEFAULT_CARET_COLOR;
+	const caretScreenWidth = style.caretScreenWidth ?? 1.5;
+	const selectionColor = style.selectionColor ?? DEFAULT_SELECTION_COLOR;
+	const selectionOpacity = style.selectionOpacity ?? DEFAULT_SELECTION_OPACITY;
+	const { group } = chrome;
+	const polylines = [];
+	const screenRects = [];
+	const local_to_screen = cmath.transform.multiply(camera, chrome.transform);
+	for (const r of chrome.selectionRects ?? []) {
+		const corners = cmath.rect.toCorners({
+			x: r.x,
+			y: r.y,
+			width: r.width,
+			height: r.height
+		}).map((p) => cmath.vector2.transform(p, chrome.transform));
+		polylines.push({
+			points: [...corners, corners[0]],
+			stroke: false,
+			fill: true,
+			fillPaint: {
+				kind: "solid",
+				color: selectionColor,
+				opacity: selectionOpacity
+			},
+			group
+		});
+	}
+	if (chrome.caret && chrome.caretVisible) {
+		const { top, bottom } = chrome.caret;
+		const mid_local = [(top[0] + bottom[0]) / 2, (top[1] + bottom[1]) / 2];
+		const anchor_doc = cmath.vector2.transform(mid_local, chrome.transform);
+		const top_screen = cmath.vector2.transform(top, local_to_screen);
+		const bottom_screen = cmath.vector2.transform(bottom, local_to_screen);
+		const dx = bottom_screen[0] - top_screen[0];
+		const dy = bottom_screen[1] - top_screen[1];
+		const screen_len = Math.hypot(dx, dy);
+		const angle_rad = Math.atan2(dy, dx) - Math.PI / 2;
+		screenRects.push({
+			x: anchor_doc[0],
+			y: anchor_doc[1],
+			width: caretScreenWidth,
+			height: screen_len,
+			anchor: "center",
+			angle: angle_rad,
+			fill: true,
+			stroke: false,
+			fillColor: caretColor,
+			group
+		});
+	}
+	return {
+		polylines,
+		screenRects
+	};
+}
+//#endregion
 //#region surface/surface.ts
 /**
 * Top-level wired surface.
@@ -6416,6 +6514,7 @@ var Surface = class {
 		this.cornerRadius = [];
 		this.parametricHandles = [];
 		this.paddingOverlay = null;
+		this.textEditChrome = null;
 		this.width = 0;
 		this.height = 0;
 		this.cursor_renderer = null;
@@ -6555,6 +6654,28 @@ var Surface = class {
 		this.paddingOverlay = input;
 	}
 	/**
+	* Configure or clear the built-in text-edit chrome — caret + selection
+	* highlights for inline text content-edit. `null` = no chrome drawn
+	* (schema-level feature flag).
+	*
+	* One atomic setter (not separate setCaret / setSelection): caret and
+	* selection are one visual state of one editing session, and a blink tick
+	* only flips `caretVisible` while the selection is unchanged — re-pushing
+	* the whole struct keeps the two from tearing across frames and matches the
+	* Skia `TextEditingDecorations` model. Re-push on every caret move /
+	* selection change / blink tick / camera change. The host owns redraw
+	* timing (this only stores state; `draw()` paints it next frame).
+	*
+	* The caret is drawn ABOVE the selection box (it's a screen-sized rect in
+	* the screenRects band) at a constant on-screen thickness, so it is never
+	* occluded and never scales with zoom. See `@grida/hud/classes/text-edit`.
+	*
+	* @unstable
+	*/
+	setTextEditChrome(input) {
+		this.textEditChrome = input;
+	}
+	/**
 	* Push a transform-box input — the `transform-box` named class for
 	* a 2×3 affine transform manipulated via quad outline + 4 corners +
 	* 4 sides + body. `null` = no chrome drawn (schema-level feature
@@ -6731,12 +6852,18 @@ var Surface = class {
 			}
 			this.hudCanvas.setParametricHandles(all_parametric);
 		} else this.hudCanvas.setParametricHandles(null);
-		const decoration_with_extras = lines.length > 0 || polylines.length > 0 ? {
+		const text_edit = this.textEditChrome ? buildTextEditChrome({
+			chrome: this.textEditChrome,
+			camera: this.state.getTransform()
+		}) : null;
+		const all_polylines = text_edit ? [...polylines, ...text_edit.polylines] : polylines;
+		const decoration_with_extras = lines.length > 0 || all_polylines.length > 0 ? {
 			...decoration,
 			lines: lines.length > 0 ? [...decoration.lines ?? [], ...lines] : decoration.lines,
-			polylines: polylines.length > 0 ? [...decoration.polylines ?? [], ...polylines] : decoration.polylines
+			polylines: all_polylines.length > 0 ? [...decoration.polylines ?? [], ...all_polylines] : decoration.polylines
 		} : decoration;
-		this.hudCanvas.draw(filterHUDDrawByGroup(mergeDraws(decoration_with_extras, extra, screenRects), { hidden }));
+		const all_screenRects = text_edit ? [...screenRects, ...text_edit.screenRects] : screenRects;
+		this.hudCanvas.draw(filterHUDDrawByGroup(mergeDraws(decoration_with_extras, extra, all_screenRects), { hidden }));
 	}
 	/** Convenience: clear the canvas (e.g. when the host stops the surface). */
 	clear() {
@@ -6940,4 +7067,4 @@ function filterOverlaysByGroup(overlays, hidden) {
 	});
 }
 //#endregion
-export { DEFAULT_RULER_BACKGROUND as $, filterHUDDrawByGroup as A, drawCornerRadius as B, PADDING_REGION_PRIORITY as C, marqueeToHUDDraw as D, lassoToHUDDraw as E, computeCornerRadiusLayout as F, DEFAULT_PARAMETRIC_HIT_SIZE as G, resolveCornerDragAnchor$1 as H, cornerRadiusAnchorSign as I, parametricHandleLayoutGroups as J, computeParametricHandleLayout as K, cornerRadiusHandlePosLine as L, DEFAULT_CORNER_RADIUS_HANDLE_INSET as M, DEFAULT_CORNER_RADIUS_HANDLE_SIZE as N, measurementToHUDDraw as O, DEFAULT_CORNER_RADIUS_HIT_SIZE as P, DEFAULT_RULER_ACCENT_COLOR as Q, cornerRadiusHandlePosRect as R, PADDING_HANDLE_THICKNESS as S, MIN_HIT_SIZE as T, DEFAULT_PARAMETRIC_HANDLE_INSET as U, resolveCenterDragAnchor as V, DEFAULT_PARAMETRIC_HANDLE_SIZE as W, resolveParametricHandleByDirection as X, projectParametricHandleValue as Y, DEFAULT_RULER_ACCENT_BACKGROUND as Z, getTransformBoxCorners as _, resolvePaint as _t, computeSelectionControlLayout as a, DEFAULT_RULER_STRIP as at, PADDING_HANDLE_LENGTH as b, buildTransformBox as c, drawRuler as ct, TRANSFORM_BOX_CORNER_PRIORITY as d, drawPixelGrid as dt, DEFAULT_RULER_COLOR as et, TRANSFORM_BOX_SIDE_HIT_THICKNESS as f, DEFAULT_STRIPES_ANGLE_DEG as ft, decompose as g, computeStripesTileGeometry as gt, cornersToBoxTransform as h, buildStripesTile as ht, MIN_GUARANTEED_INTERACTIVE_DIM as i, DEFAULT_RULER_STEPS as it, HUDCanvas as j, snapGuideToHUDDraw as k, TRANSFORM_BOX_BODY_PRIORITY as l, DEFAULT_PIXEL_GRID_COLOR as lt, compose as m, DEFAULT_STRIPES_THICKNESS_PX as mt, BODY_FLIP_THRESHOLD as n, DEFAULT_RULER_FONT as nt, negotiateAxis as o, DEFAULT_RULER_TEXT_SIDE_OFFSET as ot, TRANSFORM_BOX_SIDE_PRIORITY as p, DEFAULT_STRIPES_SPACING_PX as pt, drawParametricHandles as q, HUDHitPriority as r, DEFAULT_RULER_OVERLAP_THRESHOLD as rt, NO_MODS as s, DEFAULT_RULER_TICK_HEIGHT as st, Surface as t, DEFAULT_RULER_DRAG_THRESHOLD as tt, TRANSFORM_BOX_CORNER_HIT_SIZE as u, DEFAULT_PIXEL_GRID_STEPS as ut, reduceTransformBox as v, MIN_CHROME_VISIBLE_SIZE as w, PADDING_HANDLE_PRIORITY as x, buildPaddingOverlay as y, cornerRadiusLayoutGroups as z };
+export { DEFAULT_RULER_ACCENT_BACKGROUND as $, measurementToHUDDraw as A, cornerRadiusHandlePosRect as B, PADDING_HANDLE_PRIORITY as C, MIN_HIT_SIZE as D, MIN_CHROME_VISIBLE_SIZE as E, DEFAULT_CORNER_RADIUS_HANDLE_SIZE as F, DEFAULT_PARAMETRIC_HANDLE_INSET as G, drawCornerRadius as H, DEFAULT_CORNER_RADIUS_HIT_SIZE as I, computeParametricHandleLayout as J, DEFAULT_PARAMETRIC_HANDLE_SIZE as K, computeCornerRadiusLayout as L, filterHUDDrawByGroup as M, HUDCanvas as N, lassoToHUDDraw as O, DEFAULT_CORNER_RADIUS_HANDLE_INSET as P, resolveParametricHandleByDirection as Q, cornerRadiusAnchorSign as R, PADDING_HANDLE_LENGTH as S, PADDING_REGION_PRIORITY as T, resolveCenterDragAnchor as U, cornerRadiusLayoutGroups as V, resolveCornerDragAnchor$1 as W, parametricHandleLayoutGroups as X, drawParametricHandles as Y, projectParametricHandleValue as Z, cornersToBoxTransform as _, buildStripesTile as _t, HUDHitPriority as a, DEFAULT_RULER_OVERLAP_THRESHOLD as at, reduceTransformBox as b, negotiateAxis as c, DEFAULT_RULER_TEXT_SIDE_OFFSET as ct, TRANSFORM_BOX_BODY_PRIORITY as d, DEFAULT_PIXEL_GRID_COLOR as dt, DEFAULT_RULER_ACCENT_COLOR as et, TRANSFORM_BOX_CORNER_HIT_SIZE as f, DEFAULT_PIXEL_GRID_STEPS as ft, compose as g, DEFAULT_STRIPES_THICKNESS_PX as gt, TRANSFORM_BOX_SIDE_PRIORITY as h, DEFAULT_STRIPES_SPACING_PX as ht, BODY_FLIP_THRESHOLD as i, DEFAULT_RULER_FONT as it, snapGuideToHUDDraw as j, marqueeToHUDDraw as k, NO_MODS as l, DEFAULT_RULER_TICK_HEIGHT as lt, TRANSFORM_BOX_SIDE_HIT_THICKNESS as m, DEFAULT_STRIPES_ANGLE_DEG as mt, DEFAULT_CARET_SCREEN_WIDTH as n, DEFAULT_RULER_COLOR as nt, MIN_GUARANTEED_INTERACTIVE_DIM as o, DEFAULT_RULER_STEPS as ot, TRANSFORM_BOX_CORNER_PRIORITY as p, drawPixelGrid as pt, DEFAULT_PARAMETRIC_HIT_SIZE as q, buildTextEditChrome as r, DEFAULT_RULER_DRAG_THRESHOLD as rt, computeSelectionControlLayout as s, DEFAULT_RULER_STRIP as st, Surface as t, DEFAULT_RULER_BACKGROUND as tt, buildTransformBox as u, drawRuler as ut, decompose as v, computeStripesTileGeometry as vt, PADDING_HANDLE_THICKNESS as w, buildPaddingOverlay as x, getTransformBoxCorners as y, resolvePaint as yt, cornerRadiusHandlePosLine as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grida/hud",
-  "version": "0.2.4",
+  "version": "0.3.0",
   "private": false,
   "description": "Canvas-based heads-up display for the Grida editor viewport",
   "keywords": [