@adea-ai/ui 0.108.0 → 0.109.0

package/dist/NOTICE

@@ -427,6 +427,19 @@ The shared component owns reusable geometry and pointer/keyboard controls only.
 T3 runtime state, streaming, Electron services, native picture-in-picture,
 notifications and content rendering are not included.
 
+## Annotation viewport adapted from Adea Dev View
+
+`packages/ui/src/components/ui/annotation-surface/` supplies the shared,
+pixel-free viewport, normalized pointer capture and keyboard start behavior for
+Adea's BrowserPane annotation adapter. That adapter is issue #718 and traces its
+region drag interaction to t3code's annotation implementation, pinned at
+`77bca8b2d76a1f42552e5eee7d277fcb1160347a`; the MIT license and copyright for
+that revision are recorded in the t3code section above. Adea's host captures a
+screenshot only when an annotation is submitted, so this shared component never
+reads or renders live pixels and receives no screenshot or permission authority.
+It owns presentation and pointer capture; the host owns normalized domain
+geometry, keyboard edits, annotation commands and capture timing.
+
 ## Catalog browser translated from KiroCrew (issue #425 selected unit)
 
 `packages/ui/src/components/composites/catalog-browser/` translates the

package/dist/components/ui/annotation-surface/annotation-surface.css

@@ -0,0 +1,27 @@
+.dev-annotation-surface {
+  touch-action: none;
+  cursor: crosshair;
+  background-image: repeating-linear-gradient(
+    45deg,
+    color-mix(in oklch, var(--muted) 55%, transparent) 0 calc(var(--spacing) * 2),
+    transparent calc(var(--spacing) * 2) calc(var(--spacing) * 4)
+  );
+}
+
+.dev-annotation-surface[data-tool='point'] {
+  cursor: cell;
+}
+
+.dev-annotation-surface[data-dragging='true'] {
+  cursor: grabbing;
+}
+
+.dev-annotation-surface[aria-disabled='true'] {
+  touch-action: auto;
+  cursor: default;
+}
+
+.dev-annotation-surface__region,
+.dev-annotation-surface__hint {
+  pointer-events: none;
+}

package/dist/components/ui/annotation-surface/annotation-surface.d.ts

@@ -0,0 +1,66 @@
+import { type JSX } from 'solid-js';
+import './annotation-surface.css';
+import { type AnnotationSurfacePoint } from './geometry';
+export type AnnotationSurfaceRegion = Readonly<{
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}>;
+export type AnnotationSurfaceDrag = Readonly<{
+    start: AnnotationSurfacePoint;
+    current: AnnotationSurfacePoint;
+}>;
+export type AnnotationSurfaceTool = 'region' | 'point';
+export type AnnotationSurfaceDragPhase = 'start' | 'move' | 'end' | 'cancel' | 'keyboard';
+export type AnnotationSurfacePointerEvent = PointerEvent & {
+    currentTarget: HTMLDivElement;
+};
+export type AnnotationSurfaceKeyboardEvent = KeyboardEvent & {
+    currentTarget: HTMLDivElement;
+};
+export type AnnotationSurfaceInputEvent = AnnotationSurfacePointerEvent | AnnotationSurfaceKeyboardEvent;
+type SurfaceElementProps = Pick<JSX.HTMLAttributes<HTMLDivElement>, 'id' | 'aria-describedby'>;
+export type AnnotationSurfaceProps = SurfaceElementProps & {
+    /** Accessible instructions for the keyboard-operated surface. */
+    label: string;
+    /** Region draws a captured drag; point reports a single placement point. */
+    tool: AnnotationSurfaceTool;
+    /** Normalized 0..1 geometry supplied by the host; absent means no region. */
+    region?: AnnotationSurfaceRegion;
+    /** Visible idle guidance. It is hidden while a region is present. */
+    hint?: JSX.Element;
+    /** Disable new drawing while the host is busy. Defaults to true. */
+    interactive?: boolean;
+    /** Changing this value cancels an in-flight drag owned by the host context. */
+    resetKey?: string | number;
+    /** Receives one normalized point in point mode. */
+    onPoint?: (point: AnnotationSurfacePoint, event: AnnotationSurfaceInputEvent) => void;
+    /** Receives drag phases; cancel has no drag and fires at most once per capture. */
+    onDragChange?: (drag: AnnotationSurfaceDrag | undefined, phase: AnnotationSurfaceDragPhase, event?: AnnotationSurfaceInputEvent) => void;
+    /** Domain keyboard policy stays with the host and receives the native event. */
+    onKeyDown?: (event: AnnotationSurfaceKeyboardEvent) => void;
+    /** Ref to the actual focusable and pointer-capturing HTMLDivElement. */
+    ref?: (element: HTMLDivElement) => void;
+    /** Layout only; appearance remains owned by the shared component. */
+    class?: string;
+};
+/**
+ * AnnotationSurface.
+ *
+ * A keyboard-focusable, viewport-shaped drawing surface for hosts that own an
+ * annotation domain. It renders normalized region geometry and idle guidance,
+ * captures region drags, and reports normalized points without reading or
+ * rendering screenshot pixels. The host keeps tool policy, domain geometry,
+ * persistence and capture commands.
+ *
+ * This bespoke application widget is necessary because a generic button or
+ * slider cannot represent a two-dimensional drawing viewport. Its keyboard
+ * behavior is supplied by the host and forwarded as a native key event. Space
+ * creates a centered region or places a point at the center; Escape is left to
+ * the host first, which can prevent the default gesture cancellation while it
+ * applies its own draft and mode rules.
+ */
+export declare function AnnotationSurface(props: AnnotationSurfaceProps): JSX.Element;
+export {};
+//# sourceMappingURL=annotation-surface.d.ts.map

package/dist/components/ui/annotation-surface/annotation-surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotation-surface.d.ts","sourceRoot":"","sources":["../../../../src/components/ui/annotation-surface/annotation-surface.tsx"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,GAAG,EACT,MAAM,UAAU,CAAA;AAEjB,OAAO,0BAA0B,CAAA;AACjC,OAAO,EAGL,KAAK,sBAAsB,EAC5B,MAAM,YAAY,CAAA;AAEnB,MAAM,MAAM,uBAAuB,GAAG,QAAQ,CAAC;IAC7C,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf,CAAC,CAAA;AAEF,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC;IAC3C,KAAK,EAAE,sBAAsB,CAAA;IAC7B,OAAO,EAAE,sBAAsB,CAAA;CAChC,CAAC,CAAA;AAEF,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,OAAO,CAAA;AACtD,MAAM,MAAM,0BAA0B,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,UAAU,CAAA;AACzF,MAAM,MAAM,6BAA6B,GAAG,YAAY,GAAG;IAAE,aAAa,EAAE,cAAc,CAAA;CAAE,CAAA;AAC5F,MAAM,MAAM,8BAA8B,GAAG,aAAa,GAAG;IAAE,aAAa,EAAE,cAAc,CAAA;CAAE,CAAA;AAC9F,MAAM,MAAM,2BAA2B,GACnC,6BAA6B,GAC7B,8BAA8B,CAAA;AAElC,KAAK,mBAAmB,GAAG,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,IAAI,GAAG,kBAAkB,CAAC,CAAA;AAE9F,MAAM,MAAM,sBAAsB,GAAG,mBAAmB,GAAG;IACzD,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAA;IACb,4EAA4E;IAC5E,IAAI,EAAE,qBAAqB,CAAA;IAC3B,6EAA6E;IAC7E,MAAM,CAAC,EAAE,uBAAuB,CAAA;IAChC,qEAAqE;IACrE,IAAI,CAAC,EAAE,GAAG,CAAC,OAAO,CAAA;IAClB,oEAAoE;IACpE,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC1B,mDAAmD;IACnD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,sBAAsB,EAAE,KAAK,EAAE,2BAA2B,KAAK,IAAI,CAAA;IACrF,mFAAmF;IACnF,YAAY,CAAC,EAAE,CACb,IAAI,EAAE,qBAAqB,GAAG,SAAS,EACvC,KAAK,EAAE,0BAA0B,EACjC,KAAK,CAAC,EAAE,2BAA2B,KAChC,IAAI,CAAA;IACT,gFAAgF;IAChF,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,8BAA8B,KAAK,IAAI,CAAA;IAC3D,wEAAwE;IACxE,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAA;IACvC,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAYD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,eA6N9D"}

package/dist/components/ui/annotation-surface/annotation-surface.js

@@ -0,0 +1,244 @@
+import { cn } from "../../../lib/utils.js";
+import { clampSurfaceFraction, normalizedSurfacePoint } from "./geometry.js";
+import { className, createComponent, delegateEvents, effect, insert, memo, setAttribute, template, use } from "solid-js/web";
+import { Show, createEffect, createSignal, createUniqueId, onCleanup, splitProps } from "solid-js";
+import "./annotation-surface.css";
+//#region src/components/ui/annotation-surface/annotation-surface.tsx
+var _tmpl$ = /*#__PURE__*/ template(`<span class="dev-annotation-surface__hint pointer-events-none absolute inset-0 grid place-items-center p-4 text-center text-xs text-muted-foreground">`);
+var _tmpl$2 = /*#__PURE__*/ template(`<div role=application aria-roledescription="annotation surface"tabindex=0>`);
+var _tmpl$3 = /*#__PURE__*/ template(`<svg class="dev-annotation-surface__region pointer-events-none absolute inset-0 size-full"viewBox="0 0 10000 10000"preserveAspectRatio=none aria-hidden=true><rect class="fill-primary-subtle stroke-primary"stroke-width=1.5 vector-effect=non-scaling-stroke>`);
+function pointFrom(event, target) {
+	const bounds = target.getBoundingClientRect();
+	return normalizedSurfacePoint(event.clientX, event.clientY, bounds);
+}
+/**
+* AnnotationSurface.
+*
+* A keyboard-focusable, viewport-shaped drawing surface for hosts that own an
+* annotation domain. It renders normalized region geometry and idle guidance,
+* captures region drags, and reports normalized points without reading or
+* rendering screenshot pixels. The host keeps tool policy, domain geometry,
+* persistence and capture commands.
+*
+* This bespoke application widget is necessary because a generic button or
+* slider cannot represent a two-dimensional drawing viewport. Its keyboard
+* behavior is supplied by the host and forwarded as a native key event. Space
+* creates a centered region or places a point at the center; Escape is left to
+* the host first, which can prevent the default gesture cancellation while it
+* applies its own draft and mode rules.
+*/
+function AnnotationSurface(props) {
+	const [local] = splitProps(props, [
+		"id",
+		"aria-describedby",
+		"label",
+		"tool",
+		"region",
+		"hint",
+		"interactive",
+		"resetKey",
+		"onPoint",
+		"onDragChange",
+		"onKeyDown",
+		"ref",
+		"class"
+	]);
+	const [dragging, setDragging] = createSignal(false);
+	const hintId = createUniqueId();
+	let activeDrag;
+	let previousResetKey = local.resetKey;
+	let previousTool = local.tool;
+	const isInteractive = () => local.interactive ?? true;
+	function releaseCapture(drag) {
+		try {
+			if (drag.target.hasPointerCapture(drag.pointerId)) drag.target.releasePointerCapture(drag.pointerId);
+		} catch {}
+	}
+	function cancelDrag(event, release = true) {
+		const drag = activeDrag;
+		if (!drag) return;
+		activeDrag = void 0;
+		setDragging(false);
+		if (release) releaseCapture(drag);
+		local.onDragChange?.(void 0, "cancel", event);
+	}
+	createEffect(() => {
+		const resetKey = local.resetKey;
+		const tool = local.tool;
+		const interactive = isInteractive();
+		if (activeDrag && (resetKey !== previousResetKey || tool !== previousTool || !interactive)) cancelDrag();
+		previousResetKey = resetKey;
+		previousTool = tool;
+	});
+	onCleanup(() => cancelDrag());
+	function handlePointerDown(event) {
+		if (!isInteractive() || !event.isPrimary || event.button !== 0) return;
+		event.preventDefault();
+		event.currentTarget.focus({ preventScroll: true });
+		const point = pointFrom(event, event.currentTarget);
+		if (activeDrag) return;
+		if (local.tool === "point") {
+			local.onPoint?.(point, event);
+			return;
+		}
+		try {
+			event.currentTarget.setPointerCapture(event.pointerId);
+		} catch {
+			return;
+		}
+		activeDrag = {
+			pointerId: event.pointerId,
+			target: event.currentTarget,
+			start: point,
+			current: point
+		};
+		setDragging(true);
+		local.onDragChange?.({
+			start: point,
+			current: point
+		}, "start", event);
+	}
+	function handlePointerMove(event) {
+		const drag = activeDrag;
+		if (!drag || drag.pointerId !== event.pointerId) return;
+		const current = pointFrom(event, event.currentTarget);
+		activeDrag = {
+			...drag,
+			current
+		};
+		local.onDragChange?.({
+			start: drag.start,
+			current
+		}, "move", event);
+	}
+	function handlePointerUp(event) {
+		const drag = activeDrag;
+		if (!drag || drag.pointerId !== event.pointerId) return;
+		const current = pointFrom(event, event.currentTarget);
+		activeDrag = void 0;
+		setDragging(false);
+		releaseCapture(drag);
+		local.onDragChange?.({
+			start: drag.start,
+			current
+		}, "end", event);
+	}
+	function handlePointerCancel(event) {
+		if (activeDrag?.pointerId === event.pointerId) cancelDrag(event);
+	}
+	function handleLostPointerCapture(event) {
+		if (activeDrag?.pointerId === event.pointerId) cancelDrag(event, false);
+	}
+	function handleKeyDown(event) {
+		local.onKeyDown?.(event);
+		if (event.key === "Escape") {
+			if (!event.defaultPrevented) cancelDrag();
+			return;
+		}
+		if (event.defaultPrevented || !isInteractive() || event.key !== " " || event.repeat || event.isComposing || event.altKey || event.ctrlKey || event.metaKey || activeDrag) return;
+		event.preventDefault();
+		if (local.tool === "point") {
+			local.onPoint?.({
+				x: .5,
+				y: .5
+			}, event);
+			return;
+		}
+		local.onDragChange?.({
+			start: {
+				x: .25,
+				y: .25
+			},
+			current: {
+				x: .75,
+				y: .75
+			}
+		}, "keyboard", event);
+	}
+	const visibleRegion = () => {
+		const region = local.region;
+		if (!region) return void 0;
+		const x = clampSurfaceFraction(region.x);
+		const y = clampSurfaceFraction(region.y);
+		return {
+			x,
+			y,
+			width: Math.min(clampSurfaceFraction(region.width), 1 - x),
+			height: Math.min(clampSurfaceFraction(region.height), 1 - y)
+		};
+	};
+	const describedBy = () => [local["aria-describedby"], local.hint && !visibleRegion() ? hintId : void 0].filter(Boolean).join(" ") || void 0;
+	return (() => {
+		var _el$ = _tmpl$2();
+		_el$.$$keydown = handleKeyDown;
+		_el$.addEventListener("lostpointercapture", handleLostPointerCapture);
+		_el$.addEventListener("pointercancel", handlePointerCancel);
+		_el$.$$pointerup = handlePointerUp;
+		_el$.$$pointermove = handlePointerMove;
+		_el$.$$pointerdown = handlePointerDown;
+		use((element) => local.ref?.(element), _el$);
+		insert(_el$, createComponent(Show, {
+			get when() {
+				return visibleRegion();
+			},
+			children: (region) => (() => {
+				var _el$3 = _tmpl$3(), _el$4 = _el$3.firstChild;
+				effect((_p$) => {
+					var _v$8 = region().x * 1e4, _v$9 = region().y * 1e4, _v$0 = region().width * 1e4, _v$1 = region().height * 1e4;
+					_v$8 !== _p$.e && setAttribute(_el$4, "x", _p$.e = _v$8);
+					_v$9 !== _p$.t && setAttribute(_el$4, "y", _p$.t = _v$9);
+					_v$0 !== _p$.a && setAttribute(_el$4, "width", _p$.a = _v$0);
+					_v$1 !== _p$.o && setAttribute(_el$4, "height", _p$.o = _v$1);
+					return _p$;
+				}, {
+					e: void 0,
+					t: void 0,
+					a: void 0,
+					o: void 0
+				});
+				return _el$3;
+			})()
+		}), null);
+		insert(_el$, createComponent(Show, {
+			get when() {
+				return memo(() => !!local.hint)() && !visibleRegion();
+			},
+			get children() {
+				var _el$2 = _tmpl$();
+				setAttribute(_el$2, "id", hintId);
+				insert(_el$2, () => local.hint);
+				return _el$2;
+			}
+		}), null);
+		effect((_p$) => {
+			var _v$ = local.id, _v$2 = describedBy(), _v$3 = local.label, _v$4 = isInteractive() ? void 0 : "true", _v$5 = local.tool, _v$6 = dragging() ? "true" : "false", _v$7 = cn("dev-annotation-surface relative isolate block w-full aspect-video select-none overflow-hidden rounded-md border border-border bg-muted/20 text-muted-foreground outline-none focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-primary-subtle", local.class);
+			_v$ !== _p$.e && setAttribute(_el$, "id", _p$.e = _v$);
+			_v$2 !== _p$.t && setAttribute(_el$, "aria-describedby", _p$.t = _v$2);
+			_v$3 !== _p$.a && setAttribute(_el$, "aria-label", _p$.a = _v$3);
+			_v$4 !== _p$.o && setAttribute(_el$, "aria-disabled", _p$.o = _v$4);
+			_v$5 !== _p$.i && setAttribute(_el$, "data-tool", _p$.i = _v$5);
+			_v$6 !== _p$.n && setAttribute(_el$, "data-dragging", _p$.n = _v$6);
+			_v$7 !== _p$.s && className(_el$, _p$.s = _v$7);
+			return _p$;
+		}, {
+			e: void 0,
+			t: void 0,
+			a: void 0,
+			o: void 0,
+			i: void 0,
+			n: void 0,
+			s: void 0
+		});
+		return _el$;
+	})();
+}
+delegateEvents([
+	"pointerdown",
+	"pointermove",
+	"pointerup",
+	"keydown"
+]);
+//#endregion
+export { AnnotationSurface };
+
+//# sourceMappingURL=annotation-surface.js.map

package/dist/components/ui/annotation-surface/annotation-surface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotation-surface.js","names":["createEffect","createSignal","createUniqueId","onCleanup","Show","splitProps","JSX","cn","clampSurfaceFraction","normalizedSurfacePoint","AnnotationSurfacePoint","AnnotationSurfaceRegion","Readonly","x","y","width","height","AnnotationSurfaceDrag","start","current","AnnotationSurfaceTool","AnnotationSurfaceDragPhase","AnnotationSurfacePointerEvent","PointerEvent","currentTarget","HTMLDivElement","AnnotationSurfaceKeyboardEvent","KeyboardEvent","AnnotationSurfaceInputEvent","SurfaceElementProps","Pick","HTMLAttributes","AnnotationSurfaceProps","label","tool","region","hint","Element","interactive","resetKey","onPoint","point","event","onDragChange","drag","phase","onKeyDown","ref","element","class","ActiveDrag","pointerId","target","pointFrom","bounds","getBoundingClientRect","clientX","clientY","AnnotationSurface","props","local","dragging","setDragging","hintId","activeDrag","previousResetKey","previousTool","isInteractive","releaseCapture","hasPointerCapture","releasePointerCapture","cancelDrag","release","undefined","handlePointerDown","isPrimary","button","preventDefault","focus","preventScroll","setPointerCapture","handlePointerMove","handlePointerUp","handlePointerCancel","handleLostPointerCapture","handleKeyDown","key","defaultPrevented","repeat","isComposing","altKey","ctrlKey","metaKey","visibleRegion","Math","min","describedBy","filter","Boolean","join","_el$","_tmpl$2","$$keydown","addEventListener","$$pointerup","$$pointermove","$$pointerdown","_$use","_$insert","_$createComponent","when","children","_el$3","_tmpl$3","_el$4","firstChild","_$effect","_p$","_v$8","_v$9","_v$0","_v$1","e","_$setAttribute","t","a","o","_$memo","_el$2","_tmpl$","_v$","id","_v$2","_v$3","_v$4","_v$5","_v$6","_v$7","i","n","s","_$className","_$delegateEvents","_$createComponent","_$setAttribute","_$memo","_$className","_$delegateEvents"],"sources":["../../../../src/components/ui/annotation-surface/annotation-surface.tsx"],"sourcesContent":["import {\n  createEffect,\n  createSignal,\n  createUniqueId,\n  onCleanup,\n  Show,\n  splitProps,\n  type JSX,\n} from 'solid-js'\nimport { cn } from '#lib/utils'\nimport './annotation-surface.css'\nimport {\n  clampSurfaceFraction,\n  normalizedSurfacePoint,\n  type AnnotationSurfacePoint,\n} from './geometry'\n\nexport type AnnotationSurfaceRegion = Readonly<{\n  x: number\n  y: number\n  width: number\n  height: number\n}>\n\nexport type AnnotationSurfaceDrag = Readonly<{\n  start: AnnotationSurfacePoint\n  current: AnnotationSurfacePoint\n}>\n\nexport type AnnotationSurfaceTool = 'region' | 'point'\nexport type AnnotationSurfaceDragPhase = 'start' | 'move' | 'end' | 'cancel' | 'keyboard'\nexport type AnnotationSurfacePointerEvent = PointerEvent & { currentTarget: HTMLDivElement }\nexport type AnnotationSurfaceKeyboardEvent = KeyboardEvent & { currentTarget: HTMLDivElement }\nexport type AnnotationSurfaceInputEvent =\n  | AnnotationSurfacePointerEvent\n  | AnnotationSurfaceKeyboardEvent\n\ntype SurfaceElementProps = Pick<JSX.HTMLAttributes<HTMLDivElement>, 'id' | 'aria-describedby'>\n\nexport type AnnotationSurfaceProps = SurfaceElementProps & {\n  /** Accessible instructions for the keyboard-operated surface. */\n  label: string\n  /** Region draws a captured drag; point reports a single placement point. */\n  tool: AnnotationSurfaceTool\n  /** Normalized 0..1 geometry supplied by the host; absent means no region. */\n  region?: AnnotationSurfaceRegion\n  /** Visible idle guidance. It is hidden while a region is present. */\n  hint?: JSX.Element\n  /** Disable new drawing while the host is busy. Defaults to true. */\n  interactive?: boolean\n  /** Changing this value cancels an in-flight drag owned by the host context. */\n  resetKey?: string | number\n  /** Receives one normalized point in point mode. */\n  onPoint?: (point: AnnotationSurfacePoint, event: AnnotationSurfaceInputEvent) => void\n  /** Receives drag phases; cancel has no drag and fires at most once per capture. */\n  onDragChange?: (\n    drag: AnnotationSurfaceDrag | undefined,\n    phase: AnnotationSurfaceDragPhase,\n    event?: AnnotationSurfaceInputEvent\n  ) => void\n  /** Domain keyboard policy stays with the host and receives the native event. */\n  onKeyDown?: (event: AnnotationSurfaceKeyboardEvent) => void\n  /** Ref to the actual focusable and pointer-capturing HTMLDivElement. */\n  ref?: (element: HTMLDivElement) => void\n  /** Layout only; appearance remains owned by the shared component. */\n  class?: string\n}\n\ntype ActiveDrag = AnnotationSurfaceDrag & {\n  pointerId: number\n  target: HTMLDivElement\n}\n\nfunction pointFrom(event: PointerEvent, target: HTMLDivElement): AnnotationSurfacePoint {\n  const bounds = target.getBoundingClientRect()\n  return normalizedSurfacePoint(event.clientX, event.clientY, bounds)\n}\n\n/**\n * AnnotationSurface.\n *\n * A keyboard-focusable, viewport-shaped drawing surface for hosts that own an\n * annotation domain. It renders normalized region geometry and idle guidance,\n * captures region drags, and reports normalized points without reading or\n * rendering screenshot pixels. The host keeps tool policy, domain geometry,\n * persistence and capture commands.\n *\n * This bespoke application widget is necessary because a generic button or\n * slider cannot represent a two-dimensional drawing viewport. Its keyboard\n * behavior is supplied by the host and forwarded as a native key event. Space\n * creates a centered region or places a point at the center; Escape is left to\n * the host first, which can prevent the default gesture cancellation while it\n * applies its own draft and mode rules.\n */\nexport function AnnotationSurface(props: AnnotationSurfaceProps) {\n  const [local] = splitProps(props, [\n    'id',\n    'aria-describedby',\n    'label',\n    'tool',\n    'region',\n    'hint',\n    'interactive',\n    'resetKey',\n    'onPoint',\n    'onDragChange',\n    'onKeyDown',\n    'ref',\n    'class',\n  ])\n\n  const [dragging, setDragging] = createSignal(false)\n  const hintId = createUniqueId()\n  let activeDrag: ActiveDrag | undefined\n  let previousResetKey = local.resetKey\n  let previousTool = local.tool\n\n  const isInteractive = () => local.interactive ?? true\n\n  function releaseCapture(drag: ActiveDrag): void {\n    try {\n      if (drag.target.hasPointerCapture(drag.pointerId))\n        drag.target.releasePointerCapture(drag.pointerId)\n    } catch {\n      // The browser may release capture while a host reset or unmount is running.\n    }\n  }\n\n  function cancelDrag(event?: AnnotationSurfaceInputEvent, release = true): void {\n    const drag = activeDrag\n    if (!drag) return\n\n    activeDrag = undefined\n    setDragging(false)\n    if (release) releaseCapture(drag)\n    local.onDragChange?.(undefined, 'cancel', event)\n  }\n\n  createEffect(() => {\n    const resetKey = local.resetKey\n    const tool = local.tool\n    const interactive = isInteractive()\n    if (activeDrag && (resetKey !== previousResetKey || tool !== previousTool || !interactive)) {\n      cancelDrag()\n    }\n    previousResetKey = resetKey\n    previousTool = tool\n  })\n\n  onCleanup(() => cancelDrag())\n\n  function handlePointerDown(event: AnnotationSurfacePointerEvent): void {\n    if (!isInteractive() || !event.isPrimary || event.button !== 0) return\n    event.preventDefault()\n    event.currentTarget.focus({ preventScroll: true })\n    const point = pointFrom(event, event.currentTarget)\n    if (activeDrag) return\n\n    if (local.tool === 'point') {\n      local.onPoint?.(point, event)\n      return\n    }\n\n    try {\n      event.currentTarget.setPointerCapture(event.pointerId)\n    } catch {\n      // A drag without real pointer capture can lose its final coordinates.\n      return\n    }\n\n    const drag: ActiveDrag = {\n      pointerId: event.pointerId,\n      target: event.currentTarget,\n      start: point,\n      current: point,\n    }\n    activeDrag = drag\n    setDragging(true)\n    local.onDragChange?.({ start: point, current: point }, 'start', event)\n  }\n\n  function handlePointerMove(event: AnnotationSurfacePointerEvent): void {\n    const drag = activeDrag\n    if (!drag || drag.pointerId !== event.pointerId) return\n\n    const current = pointFrom(event, event.currentTarget)\n    activeDrag = { ...drag, current }\n    local.onDragChange?.({ start: drag.start, current }, 'move', event)\n  }\n\n  function handlePointerUp(event: AnnotationSurfacePointerEvent): void {\n    const drag = activeDrag\n    if (!drag || drag.pointerId !== event.pointerId) return\n\n    const current = pointFrom(event, event.currentTarget)\n    activeDrag = undefined\n    setDragging(false)\n    releaseCapture(drag)\n    local.onDragChange?.({ start: drag.start, current }, 'end', event)\n  }\n\n  function handlePointerCancel(event: AnnotationSurfacePointerEvent): void {\n    if (activeDrag?.pointerId === event.pointerId) cancelDrag(event)\n  }\n\n  function handleLostPointerCapture(event: AnnotationSurfacePointerEvent): void {\n    if (activeDrag?.pointerId === event.pointerId) cancelDrag(event, false)\n  }\n\n  function handleKeyDown(event: AnnotationSurfaceKeyboardEvent): void {\n    local.onKeyDown?.(event)\n    if (event.key === 'Escape') {\n      if (!event.defaultPrevented) cancelDrag()\n      return\n    }\n    if (\n      event.defaultPrevented ||\n      !isInteractive() ||\n      event.key !== ' ' ||\n      event.repeat ||\n      event.isComposing ||\n      event.altKey ||\n      event.ctrlKey ||\n      event.metaKey ||\n      activeDrag\n    )\n      return\n\n    event.preventDefault()\n    if (local.tool === 'point') {\n      local.onPoint?.({ x: 0.5, y: 0.5 }, event)\n      return\n    }\n\n    local.onDragChange?.(\n      {\n        start: { x: 0.25, y: 0.25 },\n        current: { x: 0.75, y: 0.75 },\n      },\n      'keyboard',\n      event\n    )\n  }\n\n  const visibleRegion = (): AnnotationSurfaceRegion | undefined => {\n    const region = local.region\n    if (!region) return undefined\n    const x = clampSurfaceFraction(region.x)\n    const y = clampSurfaceFraction(region.y)\n    return {\n      x,\n      y,\n      width: Math.min(clampSurfaceFraction(region.width), 1 - x),\n      height: Math.min(clampSurfaceFraction(region.height), 1 - y),\n    }\n  }\n\n  const describedBy = () =>\n    [local['aria-describedby'], local.hint && !visibleRegion() ? hintId : undefined]\n      .filter(Boolean)\n      .join(' ') || undefined\n\n  return (\n    <div\n      id={local.id}\n      aria-describedby={describedBy()}\n      role=\"application\"\n      aria-roledescription=\"annotation surface\"\n      aria-label={local.label}\n      aria-disabled={isInteractive() ? undefined : 'true'}\n      tabIndex={0}\n      data-tool={local.tool}\n      data-dragging={dragging() ? 'true' : 'false'}\n      class={cn(\n        'dev-annotation-surface relative isolate block w-full aspect-video select-none overflow-hidden rounded-md border border-border bg-muted/20 text-muted-foreground outline-none focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-primary-subtle',\n        local.class\n      )}\n      ref={(element) => local.ref?.(element)}\n      onPointerDown={handlePointerDown}\n      onPointerMove={handlePointerMove}\n      onPointerUp={handlePointerUp}\n      onPointerCancel={handlePointerCancel}\n      onLostPointerCapture={handleLostPointerCapture}\n      onKeyDown={handleKeyDown}\n    >\n      <Show when={visibleRegion()}>\n        {(region) => (\n          <svg\n            class=\"dev-annotation-surface__region pointer-events-none absolute inset-0 size-full\"\n            viewBox=\"0 0 10000 10000\"\n            preserveAspectRatio=\"none\"\n            aria-hidden=\"true\"\n          >\n            <rect\n              class=\"fill-primary-subtle stroke-primary\"\n              x={region().x * 10_000}\n              y={region().y * 10_000}\n              width={region().width * 10_000}\n              height={region().height * 10_000}\n              stroke-width=\"1.5\"\n              vector-effect=\"non-scaling-stroke\"\n            />\n          </svg>\n        )}\n      </Show>\n      <Show when={local.hint && !visibleRegion()}>\n        <span\n          id={hintId}\n          class=\"dev-annotation-surface__hint pointer-events-none absolute inset-0 grid place-items-center p-4 text-center text-xs text-muted-foreground\"\n        >\n          {local.hint}\n        </span>\n      </Show>\n    </div>\n  )\n}\n"],"mappings":"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"}

package/dist/components/ui/annotation-surface/geometry.d.ts

@@ -0,0 +1,10 @@
+export type AnnotationSurfacePoint = Readonly<{
+    x: number;
+    y: number;
+}>;
+type SurfaceBounds = Readonly<Pick<DOMRectReadOnly, 'left' | 'top' | 'width' | 'height'>>;
+/** Pointer coordinates normalized to the surface; degenerate bounds resolve to the origin. */
+export declare function normalizedSurfacePoint(clientX: number, clientY: number, bounds: SurfaceBounds): AnnotationSurfacePoint;
+export declare function clampSurfaceFraction(value: number): number;
+export {};
+//# sourceMappingURL=geometry.d.ts.map

package/dist/components/ui/annotation-surface/geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../../../../src/components/ui/annotation-surface/geometry.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,sBAAsB,GAAG,QAAQ,CAAC;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AAEvE,KAAK,aAAa,GAAG,QAAQ,CAAC,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAA;AAczF,8FAA8F;AAC9F,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,aAAa,GACpB,sBAAsB,CAKxB;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE1D"}

package/dist/components/ui/annotation-surface/geometry.js

@@ -0,0 +1,19 @@
+//#region src/components/ui/annotation-surface/geometry.ts
+function fraction(client, start, length) {
+	if (!Number.isFinite(client) || !Number.isFinite(start) || !Number.isFinite(length) || length <= 0) return 0;
+	return Math.min(1, Math.max(0, (client - start) / length));
+}
+/** Pointer coordinates normalized to the surface; degenerate bounds resolve to the origin. */
+function normalizedSurfacePoint(clientX, clientY, bounds) {
+	return {
+		x: fraction(clientX, bounds.left, bounds.width),
+		y: fraction(clientY, bounds.top, bounds.height)
+	};
+}
+function clampSurfaceFraction(value) {
+	return Number.isFinite(value) ? Math.min(1, Math.max(0, value)) : 0;
+}
+//#endregion
+export { clampSurfaceFraction, normalizedSurfacePoint };
+
+//# sourceMappingURL=geometry.js.map

package/dist/components/ui/annotation-surface/geometry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.js","names":[],"sources":["../../../../src/components/ui/annotation-surface/geometry.ts"],"sourcesContent":["export type AnnotationSurfacePoint = Readonly<{ x: number; y: number }>\n\ntype SurfaceBounds = Readonly<Pick<DOMRectReadOnly, 'left' | 'top' | 'width' | 'height'>>\n\nfunction fraction(client: number, start: number, length: number): number {\n  if (\n    !Number.isFinite(client) ||\n    !Number.isFinite(start) ||\n    !Number.isFinite(length) ||\n    length <= 0\n  )\n    return 0\n\n  return Math.min(1, Math.max(0, (client - start) / length))\n}\n\n/** Pointer coordinates normalized to the surface; degenerate bounds resolve to the origin. */\nexport function normalizedSurfacePoint(\n  clientX: number,\n  clientY: number,\n  bounds: SurfaceBounds\n): AnnotationSurfacePoint {\n  return {\n    x: fraction(clientX, bounds.left, bounds.width),\n    y: fraction(clientY, bounds.top, bounds.height),\n  }\n}\n\nexport function clampSurfaceFraction(value: number): number {\n  return Number.isFinite(value) ? Math.min(1, Math.max(0, value)) : 0\n}\n"],"mappings":";AAIA,SAAS,SAAS,QAAgB,OAAe,QAAwB;CACvE,IACE,CAAC,OAAO,SAAS,MAAM,KACvB,CAAC,OAAO,SAAS,KAAK,KACtB,CAAC,OAAO,SAAS,MAAM,KACvB,UAAU,GAEV,OAAO;CAET,OAAO,KAAK,IAAI,GAAG,KAAK,IAAI,IAAI,SAAS,SAAS,MAAM,CAAC;AAC3D;;AAGA,SAAgB,uBACd,SACA,SACA,QACwB;CACxB,OAAO;EACL,GAAG,SAAS,SAAS,OAAO,MAAM,OAAO,KAAK;EAC9C,GAAG,SAAS,SAAS,OAAO,KAAK,OAAO,MAAM;CAChD;AACF;AAEA,SAAgB,qBAAqB,OAAuB;CAC1D,OAAO,OAAO,SAAS,KAAK,IAAI,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,KAAK,CAAC,IAAI;AACpE"}

package/dist/components/ui/annotation-surface/index.d.ts

@@ -0,0 +1,4 @@
+/** Keyboard-operable normalized drawing surface; hosts retain domain geometry and actions. */
+export { AnnotationSurface, type AnnotationSurfaceDrag, type AnnotationSurfaceDragPhase, type AnnotationSurfaceInputEvent, type AnnotationSurfaceKeyboardEvent, type AnnotationSurfacePointerEvent, type AnnotationSurfaceProps, type AnnotationSurfaceRegion, type AnnotationSurfaceTool, } from './annotation-surface';
+export type { AnnotationSurfacePoint } from './geometry';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/ui/annotation-surface/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/ui/annotation-surface/index.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,OAAO,EACL,iBAAiB,EACjB,KAAK,qBAAqB,EAC1B,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,EAChC,KAAK,8BAA8B,EACnC,KAAK,6BAA6B,EAClC,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,GAC3B,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA"}

package/dist/components/ui/annotation-surface/index.js

@@ -0,0 +1,2 @@
+import { AnnotationSurface } from "./annotation-surface.js";
+export { AnnotationSurface };

package/dist/components/ui/sheet/sheet.d.ts

@@ -32,7 +32,7 @@ import { type VariantProps } from '#lib/variants';
  * sheet opens.
  */
 declare const sheetVariants: (props?: ({
-    side?: "end" | "start" | "bottom" | "top" | null | undefined;
+    side?: "top" | "bottom" | "start" | "end" | null | undefined;
     variant?: "inset" | "edge" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 export type SheetContentProps = ComponentProps<typeof KobalteDialogContent> & VariantProps<typeof sheetVariants> & {

package/dist/index.d.ts

@@ -16,6 +16,7 @@
 export * from './components/ui/accordion';
 export * from './components/ui/alert';
 export * from './components/ui/alert-dialog';
+export * from './components/ui/annotation-surface';
 export * from './components/ui/aspect-ratio';
 export * from './components/ui/avatar';
 export * from './components/ui/board';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -4,6 +4,7 @@ import { controlInteractive, controlSize, controlSizeIcon, controlSizes, cva, su
 import { Alert, AlertDescription, AlertTitle, alertVariants } from "./components/ui/alert/alert.js";
 import { Heading, Text, headingElement, headingVariants, textElement, textVariants } from "./components/ui/typography/typography.js";
 import { AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger } from "./components/ui/alert-dialog/alert-dialog.js";
+import { AnnotationSurface } from "./components/ui/annotation-surface/annotation-surface.js";
 import { AspectRatio } from "./components/ui/aspect-ratio/aspect-ratio.js";
 import { Avatar, AvatarFallback, AvatarImage, initialsFrom } from "./components/ui/avatar/avatar.js";
 import { Badge, badgeVariants } from "./components/ui/badge/badge.js";
@@ -128,4 +129,4 @@ import { AboutDialog } from "./components/composites/about-dialog/about-dialog.j
 import { HelpCenter } from "./components/composites/help-center/help-center.js";
 import { WorkspaceMark } from "./components/composites/workspace-mark/workspace-mark.js";
 import { writeClipboardText } from "./lib/clipboard.js";
-export { APPEARANCE_EDITOR_FONT_AXES, APPEARANCE_EDITOR_FONT_SIZE_MAX, APPEARANCE_EDITOR_FONT_SIZE_MIN, AboutDialog, Accordion, AccordionContent, AccordionItem, AccordionTrigger, AccountMenu, ActionButton, Alert, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AlertTitle, AppShell, AppShellBody, AppShellContent, AppShellMain, AppearanceEditor, AppearanceEditorActions, AppearanceFontSettingsGroup, AppearancePanel, AppearancePopover, AspectRatio, AttachmentCard, Avatar, AvatarFallback, AvatarImage, Badge, Board, BoardCardBody, BoardCardTitle, BoardCardTrigger, Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbSeparator, BusySendButton, Button, ButtonGroup, ButtonGroupSeparator, ButtonGroupText, CalendarSurface, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, CatalogBrowser, CatalogDetail, CatalogDetailSection, ChatComposer, Checkbox, CheckboxDescription, CheckboxLabel, CodeBlock, Collapsible, CollapsibleContent, CollapsibleTrigger, Combobox, ComboboxClear, ComboboxContent, ComboboxControl, ComboboxInput, ComboboxItem, ComboboxSection, ComboboxTrigger, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandLoading, CommandSeparator, CommandShortcut, ComposerAttachmentButton, ComposerHint, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, ContextualSidebar, ConversationAvatar, ConversationSurface, DEFAULT_APPEARANCE_EDITOR_FONT_SETTINGS, DatePicker, DetailPanel, DetailPanelBody, DetailPanelField, DetailPanelHeader, DetailPanelSection, Dialog, DialogClose, DialogCloseButton, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DiffBlock, DiffSummary, Drawer, DrawerBody, DrawerCloseButton, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, Empty, EmptyContent, EmptyDescription, EmptyHeader, EmptyMedia, EmptyState, EmptyTitle, EntityIcon, FLOATING_PREVIEW_CORNER_RADIUS, FLOATING_PREVIEW_EDGE_GAP, Field, FieldDescription, FieldError, FieldGroup, FieldInput, FieldLabel, FieldLegend, FieldSeparator, FieldSet, FieldTextArea, FloatingPreview, FormField, Heading, HelpCenter, HoverCard, HoverCardContent, HoverCardTrigger, InlineCode, Input, InputControl, InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, InputGroupText, InputOtp, InputOtpCaret, Item, ItemDescription, ItemEmpty, ItemGroup, ItemGroupEntry, ItemTitle, Kbd, KbdChord, KbdGroup, Label, ListGroup, ListRow, ListRowControl, MAX_LAYOUT_DEPTH, MAX_LAYOUT_LEAVES, MAX_SPLIT_RATIO, MIN_SPLIT_RATIO, Menubar, MenubarCheckboxItem, MenubarContent, MenubarGroup, MenubarItem, MenubarLabel, MenubarMenu, MenubarRadioGroup, MenubarRadioItem, MenubarSeparator, MenubarSub, MenubarSubContent, MenubarSubTrigger, MenubarTrigger, MessageBody, MessageComposer, MessageDayDivider, MessageGroup, MessageRow, ModalDialog, Motion, NO_FLOATING_PREVIEW_OBSTACLES, NO_PREVIEW_MINI_PLAYER_OBSTACLES, NativeSelect, NavigationMenu, NavigationMenuContent, NavigationMenuGroup, NavigationMenuGroupLabel, NavigationMenuItem, NavigationMenuMenu, NavigationMenuSeparator, NavigationMenuTrigger, NavigationMenuViewport, NumberField, OrbitItem, OrbitLayout, PASTE_THRESHOLD_CHARS, PASTE_THRESHOLD_LINES, PASTE_TOKEN_REGEX, PREVIEW_MINI_PLAYER_CORNER_RADIUS, PREVIEW_MINI_PLAYER_EDGE_GAP, Page, PageHeader, PageHeaderActions, PageHeaderContent, PageHeaderDescription, PageHeaderTitle, PageSection, Pagination, PaginationEllipsis, PaginationItem, PaginationNext, PaginationPrevious, PalettePreview, Panel, PanelActions, PanelBody, PanelCard, PanelDescription, PanelFooter, PanelHeader, PanelPlaceholder, PanelTitle, PanelToolbar, PixelResizeHandle, Popover, PopoverAnchor, PopoverCloseButton, PopoverContent, PopoverDescription, PopoverTitle, PopoverTrigger, Presence, Progress, PropertyList, PropertyRow, PropertyTerm, PropertyValue, RadioGroup, RadioGroupItem, ResizableHandle, ResizablePanel, ResizablePanelGroup, SceneControls, ScrollArea, SecretInputGroup, Select, SelectChevronsUpDown, SelectContent, SelectItem, SelectLabel, SelectSection, SelectTrigger, SelectValue, Separator, SettingsField, SettingsLayout, SettingsNavigation, SettingsPage, SettingsRow, SettingsSection, Sheet, SheetBody, SheetCloseButton, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger, SideRail, SideRailButton, SideRailContent, SideRailFooter, SideRailHeader, SideRailItem, SideRailSection, SidebarNav, SidebarNavButton, SidebarNavContent, SidebarNavFooter, SidebarNavHeader, SidebarNavItem, SidebarNavLabel, SidebarNavResizeHandle, SidebarNavRow, SidebarNavSection, SidebarNavTitle, Skeleton, SkipLink, Slider, Spinner, SplitLayout, Stat, StatGroup, StatusBar, StatusBarItem, StatusBarSpacer, StatusChip, StatusList, Switch, SwitchDescription, SwitchLabel, TALL_CODE_BLOCK_PX, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableNumericCell, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, Text, TextLink, Textarea, ThemeMiniature, ThemeMiniatureSplit, ThemeModeToggle, ThemePicker, ThemePreview, ThemeProvider, ThemeSwatch, ThemeToggle, ThreadPanel, Toaster, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, TopBar, TopBarBreadcrumb, TopBarPill, TopBarSearch, TopBarSection, TopBarTitle, TranscriptComposition, Tree, TreeRow, UpdateDialog, ValueCombobox, VirtualWindow, WorkspaceMark, accentPresets, alertVariants, allTokens, appearancePreviewThemes, applyAppearanceFontSettings, badgeVariants, boardCardTitleVariants, builtinThemes, buttonVariants, clampFloatingPreviewPosition, clampPreviewMiniPlayerPosition, closePane, cn, colorTokens, computeLayoutFrames, contrastRatio, controlInteractive, controlSize, controlSizeIcon, controlSizes, countLeaves, countLines, createAppMenuItems, createLayoutState, cva, defaultDarkThemeId, defaultLightThemeId, defaultThemeSelection, densityTokens, designTokens, diffLineVariants, diffStats, diffTargetPath, elevationTokens, entityIconVariants, expandAll, findTokenRanges, focusPane, fontOptions, fontSettingsBootstrapScript, formatBytes, formatReleaseDate, formatToken, headingElement, headingVariants, initialsFrom, inlineScriptLiteral, isPasteBlock, isThemeAccentId, itemVariants, kbdChordKeys, kbdGroupVariants, kbdVariants, keyedRows, layoutDepth, listLeaves, monogram, motionTokens, movePane, neighborLeaf, nextSeq, normalizeAppearanceEditorFontSettings, normalizeAppearanceEditorFontSize, normalizeLayout, parseDiff, plainTextFromMarkdown, pruneBlocks, radiusTokens, recollapsePastes, remapCarriedBlocks, resizeFloatingPreview, resizePreviewMiniPlayer, resizeSplit, resolveAccentPreset, resolveFloatingPreviewFrame, resolvePreviewMiniPlayerFrame, resolvedDensity, sheetVariants, shouldCollapse, sidebarNavItemClass, sidebarNavItemStateClass, splitPane, statusDotVariants, stripTrailingBlankLines, surfaceInteractive, swapPanes, textElement, textVariants, textareaVariants, themeAccentsFor, themeById, themeCssVariables, themeFamilies, themeRecordById, themeRecords, themeScript, themesForAppearance, toast, toaster, toggleVariants, tokenRangeAt, transcriptDisclosureKey, typographyTokens, undoClosePane, undocumentedTokenAliases, useSideRail, useTheme, validateTheme, validateThemeRegistry, withAccent, writeClipboardText, zIndexTokens };
+export { APPEARANCE_EDITOR_FONT_AXES, APPEARANCE_EDITOR_FONT_SIZE_MAX, APPEARANCE_EDITOR_FONT_SIZE_MIN, AboutDialog, Accordion, AccordionContent, AccordionItem, AccordionTrigger, AccountMenu, ActionButton, Alert, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AlertTitle, AnnotationSurface, AppShell, AppShellBody, AppShellContent, AppShellMain, AppearanceEditor, AppearanceEditorActions, AppearanceFontSettingsGroup, AppearancePanel, AppearancePopover, AspectRatio, AttachmentCard, Avatar, AvatarFallback, AvatarImage, Badge, Board, BoardCardBody, BoardCardTitle, BoardCardTrigger, Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbSeparator, BusySendButton, Button, ButtonGroup, ButtonGroupSeparator, ButtonGroupText, CalendarSurface, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, CatalogBrowser, CatalogDetail, CatalogDetailSection, ChatComposer, Checkbox, CheckboxDescription, CheckboxLabel, CodeBlock, Collapsible, CollapsibleContent, CollapsibleTrigger, Combobox, ComboboxClear, ComboboxContent, ComboboxControl, ComboboxInput, ComboboxItem, ComboboxSection, ComboboxTrigger, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandLoading, CommandSeparator, CommandShortcut, ComposerAttachmentButton, ComposerHint, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, ContextualSidebar, ConversationAvatar, ConversationSurface, DEFAULT_APPEARANCE_EDITOR_FONT_SETTINGS, DatePicker, DetailPanel, DetailPanelBody, DetailPanelField, DetailPanelHeader, DetailPanelSection, Dialog, DialogClose, DialogCloseButton, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DiffBlock, DiffSummary, Drawer, DrawerBody, DrawerCloseButton, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, Empty, EmptyContent, EmptyDescription, EmptyHeader, EmptyMedia, EmptyState, EmptyTitle, EntityIcon, FLOATING_PREVIEW_CORNER_RADIUS, FLOATING_PREVIEW_EDGE_GAP, Field, FieldDescription, FieldError, FieldGroup, FieldInput, FieldLabel, FieldLegend, FieldSeparator, FieldSet, FieldTextArea, FloatingPreview, FormField, Heading, HelpCenter, HoverCard, HoverCardContent, HoverCardTrigger, InlineCode, Input, InputControl, InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, InputGroupText, InputOtp, InputOtpCaret, Item, ItemDescription, ItemEmpty, ItemGroup, ItemGroupEntry, ItemTitle, Kbd, KbdChord, KbdGroup, Label, ListGroup, ListRow, ListRowControl, MAX_LAYOUT_DEPTH, MAX_LAYOUT_LEAVES, MAX_SPLIT_RATIO, MIN_SPLIT_RATIO, Menubar, MenubarCheckboxItem, MenubarContent, MenubarGroup, MenubarItem, MenubarLabel, MenubarMenu, MenubarRadioGroup, MenubarRadioItem, MenubarSeparator, MenubarSub, MenubarSubContent, MenubarSubTrigger, MenubarTrigger, MessageBody, MessageComposer, MessageDayDivider, MessageGroup, MessageRow, ModalDialog, Motion, NO_FLOATING_PREVIEW_OBSTACLES, NO_PREVIEW_MINI_PLAYER_OBSTACLES, NativeSelect, NavigationMenu, NavigationMenuContent, NavigationMenuGroup, NavigationMenuGroupLabel, NavigationMenuItem, NavigationMenuMenu, NavigationMenuSeparator, NavigationMenuTrigger, NavigationMenuViewport, NumberField, OrbitItem, OrbitLayout, PASTE_THRESHOLD_CHARS, PASTE_THRESHOLD_LINES, PASTE_TOKEN_REGEX, PREVIEW_MINI_PLAYER_CORNER_RADIUS, PREVIEW_MINI_PLAYER_EDGE_GAP, Page, PageHeader, PageHeaderActions, PageHeaderContent, PageHeaderDescription, PageHeaderTitle, PageSection, Pagination, PaginationEllipsis, PaginationItem, PaginationNext, PaginationPrevious, PalettePreview, Panel, PanelActions, PanelBody, PanelCard, PanelDescription, PanelFooter, PanelHeader, PanelPlaceholder, PanelTitle, PanelToolbar, PixelResizeHandle, Popover, PopoverAnchor, PopoverCloseButton, PopoverContent, PopoverDescription, PopoverTitle, PopoverTrigger, Presence, Progress, PropertyList, PropertyRow, PropertyTerm, PropertyValue, RadioGroup, RadioGroupItem, ResizableHandle, ResizablePanel, ResizablePanelGroup, SceneControls, ScrollArea, SecretInputGroup, Select, SelectChevronsUpDown, SelectContent, SelectItem, SelectLabel, SelectSection, SelectTrigger, SelectValue, Separator, SettingsField, SettingsLayout, SettingsNavigation, SettingsPage, SettingsRow, SettingsSection, Sheet, SheetBody, SheetCloseButton, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger, SideRail, SideRailButton, SideRailContent, SideRailFooter, SideRailHeader, SideRailItem, SideRailSection, SidebarNav, SidebarNavButton, SidebarNavContent, SidebarNavFooter, SidebarNavHeader, SidebarNavItem, SidebarNavLabel, SidebarNavResizeHandle, SidebarNavRow, SidebarNavSection, SidebarNavTitle, Skeleton, SkipLink, Slider, Spinner, SplitLayout, Stat, StatGroup, StatusBar, StatusBarItem, StatusBarSpacer, StatusChip, StatusList, Switch, SwitchDescription, SwitchLabel, TALL_CODE_BLOCK_PX, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableNumericCell, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, Text, TextLink, Textarea, ThemeMiniature, ThemeMiniatureSplit, ThemeModeToggle, ThemePicker, ThemePreview, ThemeProvider, ThemeSwatch, ThemeToggle, ThreadPanel, Toaster, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, TopBar, TopBarBreadcrumb, TopBarPill, TopBarSearch, TopBarSection, TopBarTitle, TranscriptComposition, Tree, TreeRow, UpdateDialog, ValueCombobox, VirtualWindow, WorkspaceMark, accentPresets, alertVariants, allTokens, appearancePreviewThemes, applyAppearanceFontSettings, badgeVariants, boardCardTitleVariants, builtinThemes, buttonVariants, clampFloatingPreviewPosition, clampPreviewMiniPlayerPosition, closePane, cn, colorTokens, computeLayoutFrames, contrastRatio, controlInteractive, controlSize, controlSizeIcon, controlSizes, countLeaves, countLines, createAppMenuItems, createLayoutState, cva, defaultDarkThemeId, defaultLightThemeId, defaultThemeSelection, densityTokens, designTokens, diffLineVariants, diffStats, diffTargetPath, elevationTokens, entityIconVariants, expandAll, findTokenRanges, focusPane, fontOptions, fontSettingsBootstrapScript, formatBytes, formatReleaseDate, formatToken, headingElement, headingVariants, initialsFrom, inlineScriptLiteral, isPasteBlock, isThemeAccentId, itemVariants, kbdChordKeys, kbdGroupVariants, kbdVariants, keyedRows, layoutDepth, listLeaves, monogram, motionTokens, movePane, neighborLeaf, nextSeq, normalizeAppearanceEditorFontSettings, normalizeAppearanceEditorFontSize, normalizeLayout, parseDiff, plainTextFromMarkdown, pruneBlocks, radiusTokens, recollapsePastes, remapCarriedBlocks, resizeFloatingPreview, resizePreviewMiniPlayer, resizeSplit, resolveAccentPreset, resolveFloatingPreviewFrame, resolvePreviewMiniPlayerFrame, resolvedDensity, sheetVariants, shouldCollapse, sidebarNavItemClass, sidebarNavItemStateClass, splitPane, statusDotVariants, stripTrailingBlankLines, surfaceInteractive, swapPanes, textElement, textVariants, textareaVariants, themeAccentsFor, themeById, themeCssVariables, themeFamilies, themeRecordById, themeRecords, themeScript, themesForAppearance, toast, toaster, toggleVariants, tokenRangeAt, transcriptDisclosureKey, typographyTokens, undoClosePane, undocumentedTokenAliases, useSideRail, useTheme, validateTheme, validateThemeRegistry, withAccent, writeClipboardText, zIndexTokens };

package/dist/r/annotation-surface.json

@@ -0,0 +1,32 @@
+{
+  "name": "annotation-surface",
+  "type": "registry:ui",
+  "title": "Annotation Surface",
+  "description": "Keyboard-operable normalized drawing surface; hosts retain domain geometry and actions.",
+  "dependencies": [],
+  "registryDependencies": [
+    "lib"
+  ],
+  "files": [
+    {
+      "path": "src/components/ui/annotation-surface/annotation-surface.css",
+      "type": "registry:ui",
+      "target": "components/ui/annotation-surface/annotation-surface.css"
+    },
+    {
+      "path": "src/components/ui/annotation-surface/annotation-surface.tsx",
+      "type": "registry:ui",
+      "target": "components/ui/annotation-surface/annotation-surface.tsx"
+    },
+    {
+      "path": "src/components/ui/annotation-surface/geometry.ts",
+      "type": "registry:ui",
+      "target": "components/ui/annotation-surface/geometry.ts"
+    },
+    {
+      "path": "src/components/ui/annotation-surface/index.ts",
+      "type": "registry:ui",
+      "target": "components/ui/annotation-surface/index.ts"
+    }
+  ]
+}

package/dist/r/registry.json

@@ -77,6 +77,38 @@
         }
       ]
     },
+    {
+      "name": "annotation-surface",
+      "type": "registry:ui",
+      "title": "Annotation Surface",
+      "description": "Keyboard-operable normalized drawing surface; hosts retain domain geometry and actions.",
+      "dependencies": [],
+      "registryDependencies": [
+        "lib"
+      ],
+      "files": [
+        {
+          "path": "src/components/ui/annotation-surface/annotation-surface.css",
+          "type": "registry:ui",
+          "target": "components/ui/annotation-surface/annotation-surface.css"
+        },
+        {
+          "path": "src/components/ui/annotation-surface/annotation-surface.tsx",
+          "type": "registry:ui",
+          "target": "components/ui/annotation-surface/annotation-surface.tsx"
+        },
+        {
+          "path": "src/components/ui/annotation-surface/geometry.ts",
+          "type": "registry:ui",
+          "target": "components/ui/annotation-surface/geometry.ts"
+        },
+        {
+          "path": "src/components/ui/annotation-surface/index.ts",
+          "type": "registry:ui",
+          "target": "components/ui/annotation-surface/index.ts"
+        }
+      ]
+    },
     {
       "name": "aspect-ratio",
       "type": "registry:ui",