@revolist/ui 4.0.4-rc → 4.0.4

package/configurator-field-icon.d.ts

@@ -0,0 +1,10 @@
+export interface ConfiguratorFieldMetadata {
+    columnType?: string;
+    dataType?: 'string' | 'number' | 'date' | 'boolean';
+}
+/** Shared descriptive field identity; never infers or formats source values. */
+export declare function resolveConfiguratorFieldIcon(dimension?: ConfiguratorFieldMetadata): {
+    kind: string;
+    svg: string;
+    label: string;
+};

package/configurator-field-icon.js

@@ -0,0 +1 @@
+export { t as resolveConfiguratorFieldIcon } from "./_chunks/configurator-field-icon-CmcM_sPs.js";

package/configurator-focus.d.ts

@@ -0,0 +1,4 @@
+/** Return focus only from this editor. Release a temporary tab stop on blur or disposal. */
+export declare function focusConfiguratorOrigin(origin: HTMLElement, root: HTMLElement | null): () => void;
+/** A single mounted owner's lease; synchronous focus callbacks cannot revive a disposed lease. */
+export declare function useConfiguratorOriginFocus(): (origin: HTMLElement, root: HTMLElement | null) => void;

package/configurator-focus.js

@@ -0,0 +1,39 @@
+import { r as e, t } from "./_chunks/hooks.module-CG3gN83z.js";
+//#region package/configurator-focus.ts
+var n = () => {};
+function r(e, t) {
+	if (!e.isConnected || !t?.isConnected || e.ownerDocument !== t.ownerDocument) return !1;
+	let n = e.ownerDocument.activeElement;
+	return !n || n === e.ownerDocument.body || n === e || t.contains(n);
+}
+function i(e, t) {
+	if (!r(e, t)) return n;
+	let i = e.ownerDocument, a = i.activeElement;
+	if (e.focus({ preventScroll: !0 }), i.activeElement === e || e.hasAttribute("tabindex") || !e.isConnected || !t.isConnected || i.activeElement !== a && i.activeElement !== i.body) return n;
+	let o = !0, s = () => {
+		o && (o = !1, e.removeEventListener("blur", s), e.getAttribute("tabindex") === "-1" && e.removeAttribute("tabindex"));
+	};
+	e.setAttribute("tabindex", "-1"), e.addEventListener("blur", s);
+	try {
+		e.focus({ preventScroll: !0 }), (i.activeElement !== e || !e.isConnected || !t.isConnected) && s();
+	} catch (e) {
+		throw s(), e;
+	}
+	return s;
+}
+function a() {
+	let a = t(n), o = t(0), s = t(!0);
+	return e(() => (s.current = !0, () => {
+		s.current = !1, o.current++;
+		let e = a.current;
+		a.current = n, e();
+	}), []), (e, t) => {
+		if (!s.current || !r(e, t)) return;
+		let c = ++o.current, l = a.current;
+		if (a.current = n, l(), !s.current || c !== o.current) return;
+		let u = i(e, t);
+		!s.current || c !== o.current ? u() : a.current = u;
+	};
+}
+//#endregion
+export { i as focusConfiguratorOrigin, a as useConfiguratorOriginFocus };

package/configurator-sections.d.ts

@@ -0,0 +1,42 @@
+import { h, ComponentChildren } from './_vendor/preact/src/index';
+/** Application-owned content. Return cleanup when mounting another framework or UI. */
+export interface ConfiguratorSection {
+    id: string;
+    label: string;
+    hidden?: boolean;
+    disabled?: boolean;
+    render?: () => ComponentChildren;
+    mount?: (host: HTMLElement) => void | (() => void);
+}
+export interface ConfiguratorSectionsConfig {
+    /** Custom tabs appended after the built-in tabs. IDs must be unique and cannot replace built-ins. */
+    sections?: readonly ConfiguratorSection[];
+    initialSection?: string;
+    onSectionChange?: (id: string) => void;
+}
+/** Selection follows current availability, without discarding mounted editor drafts. */
+export declare function useConfiguratorSections(config: ConfiguratorSectionsConfig, builtins: readonly ConfiguratorSection[], disabled?: boolean): {
+    sections: ConfiguratorSection[];
+    custom: ConfiguratorSection[];
+    active: string | undefined;
+    select: (id: string) => void;
+};
+/** Shared switch spacing and opaque sticky backdrop for every configurator. */
+export declare function ConfiguratorHeader({ children, className, }: {
+    children?: ComponentChildren;
+    className?: string;
+}): h.JSX.Element;
+export declare function ConfiguratorSectionTabs({ sections, active, onChange, prefix, label, className, }: {
+    sections: readonly ConfiguratorSection[];
+    active?: string;
+    onChange: (id: string) => void;
+    prefix: string;
+    label: string;
+    className?: string;
+}): h.JSX.Element;
+/** Inactive sections retain chat transcripts and host drafts until removed. */
+export declare function ConfiguratorSectionPanels({ sections, active, prefix, }: {
+    sections: readonly ConfiguratorSection[];
+    active?: string;
+    prefix: string;
+}): h.JSX.Element;

package/configurator-sections.js

@@ -0,0 +1,71 @@
+import { i as e } from "./_chunks/preact.module-BBM36DnO.js";
+import { i as t, r as n, t as r } from "./_chunks/hooks.module-CG3gN83z.js";
+import { t as i } from "./_chunks/jsxRuntime.module-F6UFnpT-.js";
+import { SegmentedSwitch as a } from "./segmented-switch/index.js";
+//#region package/configurator-sections.tsx
+function o(e, n, r = !1) {
+	let i = new Set(n.map((e) => e.id)), a = (e.sections ?? []).filter((e) => !e.id || i.has(e.id) ? !1 : (i.add(e.id), !0)), o = [...n, ...a].filter((e) => !e.hidden).map((e) => r ? {
+		...e,
+		disabled: !0
+	} : e), [s, c] = t(e.initialSection ?? n[0]?.id), l = o.find((e) => e.id === s && (r || !e.disabled))?.id ?? o.find((e) => !e.disabled)?.id ?? (r ? o[0]?.id : void 0);
+	return {
+		sections: o,
+		custom: o.filter((e) => !n.some((t) => t.id === e.id)),
+		active: l,
+		select: (t) => {
+			t !== l && o.some((e) => e.id === t && !e.disabled) && (c(t), e.onSectionChange?.(t));
+		}
+	};
+}
+function s({ children: e, className: t = "" }) {
+	return /* @__PURE__ */ i("header", {
+		className: `rv-configurator-header ${t}`,
+		children: e
+	});
+}
+function c({ sections: e, active: t, onChange: n, prefix: r, label: o, className: s = "" }) {
+	return /* @__PURE__ */ i(a, {
+		value: t ?? "",
+		ariaLabel: o,
+		role: "tablist",
+		className: `rv-configurator-section-tabs ${s}`,
+		options: e.map((e) => ({
+			value: e.id,
+			label: e.label,
+			disabled: e.disabled,
+			id: `${r}-tab-${e.id}`,
+			ariaControls: `${r}-panel-${e.id}`
+		})),
+		onChange: n
+	});
+}
+function l({ section: e }) {
+	let t = r(null);
+	return n(() => {
+		if (t.current && e.mount) return e.mount(t.current);
+	}, [e.mount]), /* @__PURE__ */ i("div", {
+		ref: t,
+		class: "rv-configurator-section-content",
+		children: e.render?.()
+	});
+}
+function u({ sections: t, active: n, prefix: r }) {
+	return /* @__PURE__ */ i(e, { children: t.map((e) => /* @__PURE__ */ i(d, {
+		section: e,
+		active: n === e.id,
+		prefix: r
+	}, e.id)) });
+}
+function d({ section: e, active: t, prefix: n }) {
+	let a = r(!1);
+	return t && (a.current = !0), /* @__PURE__ */ i("section", {
+		hidden: !t,
+		role: "tabpanel",
+		id: `${n}-panel-${e.id}`,
+		"aria-labelledby": `${n}-tab-${e.id}`,
+		class: "rv-configurator-custom-section",
+		children: a.current && /* @__PURE__ */ i(l, { section: e })
+	});
+}
+//#endregion
+export { s as ConfiguratorHeader, u as ConfiguratorSectionPanels, c as ConfiguratorSectionTabs, o as useConfiguratorSections };

package/control-attributes.js

@@ -1,4 +1,4 @@
-//#region src/control-attributes.ts
+//#region package/control-attributes.ts
 function e(...e) {
 	e = e.map((e) => e && typeof e == "object" && "value" in e && "subscribe" in e ? e.value : e);
 	let t = e.flatMap((e) => typeof e == "string" ? e.split(/\s+/) : e && typeof e == "object" ? Object.entries(e).filter(([, e]) => e).map(([e]) => e) : []);

package/control-presentation.d.ts

@@ -1,2 +1,8 @@
-/** Compatibility entry; markup is owned by the Preact TSX implementation. */
-export * from './control-presentation.view';
+import { ControlTag, ControlAttributes } from './control-attributes';
+export * from './control-attributes';
+export declare function renderControl<H extends (...args: any[]) => any>(h: H, tag: ControlTag, attributes?: ControlAttributes | null, ...children: any[]): ReturnType<H>;
+export declare function createControl<K extends ControlTag>(document: Document, tag: K, attributes?: ControlAttributes): HTMLElementTagNameMap[K];
+export declare function registerControl<T extends object>(component: T, tag: ControlTag): T;
+export declare function nativeControlTag(type: unknown): string | undefined;
+/** Decorate a native icon control after installing its trusted bundled SVG. */
+export declare function decorateIconAction(element: HTMLElement, label: string): void;

package/control-presentation.js

@@ -1,36 +1,41 @@
 import { c as e } from "./_chunks/preact.module-BBM36DnO.js";
 import { t } from "./_chunks/jsxRuntime.module-F6UFnpT-.js";
 import { createPreactElement as n } from "./preact-mount.js";
-import { controlAttributes as r, controlClassName as i } from "./control-attributes.js";
-//#region src/control-presentation.view.tsx
-function a(e, t, n, ...i) {
+import { TooltipController as r } from "./core/popover-controller.js";
+import { controlAttributes as i, controlClassName as a } from "./control-attributes.js";
+//#region package/control-presentation.tsx
+function o(e, t, n, ...r) {
 	let a = n ?? {};
 	if (t === "button" && a.busy === !0) {
-		let n = i.length ? i : [a.children];
-		return e(t, r(t, a), e("span", {
+		let n = r.length ? r : [a.children];
+		return e(t, i(t, a), e("span", {
 			class: "rv-button-spinner",
 			"aria-hidden": "true"
 		}), ...n);
 	}
-	return e(t, r(t, a), ...i);
+	return e(t, i(t, a), ...r);
 }
-function o(t, r, i = {}) {
-	let o = a(e, r, i);
-	return i.onChange && !(r === "button" && i.busy) && Object.assign(o.props, { onChange: i.onChange }), n(t, o);
+function s(t, r, i = {}) {
+	let a = o(e, r, i);
+	return i.onChange && !(r === "button" && i.busy) && Object.assign(a.props, { onChange: i.onChange }), n(t, a);
 }
-var s = /* @__PURE__ */ new WeakMap();
-function c(e, t) {
-	return s.set(e, t), e;
+var c = /* @__PURE__ */ new WeakMap();
+function l(e, t) {
+	return c.set(e, t), e;
 }
-function l(e) {
-	return typeof e == "string" ? e : e && (typeof e == "function" || typeof e == "object") ? s.get(e) : void 0;
+function u(e) {
+	return typeof e == "string" ? e : e && (typeof e == "function" || typeof e == "object") ? c.get(e) : void 0;
 }
-function u(e, r) {
-	e.classList.add("rv-btn", "rv-btn-ghost", "rv-btn-icon"), e.setAttribute("aria-label", r), e.title = r, e.querySelector(".rv-control-tooltip")?.remove(), e.append(n(e.ownerDocument, /* @__PURE__ */ t("span", {
+var d = /* @__PURE__ */ new WeakMap();
+function f(e, i) {
+	e.classList.add("rv-btn", "rv-btn-ghost", "rv-btn-icon"), e.setAttribute("aria-label", i), d.get(e)?.(), e.removeAttribute("title"), e.querySelector(".rv-control-tooltip")?.remove();
+	let a = n(e.ownerDocument, /* @__PURE__ */ t("span", {
 		class: "rv-control-tooltip",
-		"aria-hidden": "true",
-		children: r
-	})));
+		role: "tooltip",
+		hidden: !0,
+		children: i
+	}));
+	e.append(a), d.set(e, new r().bind(e, i, { surface: a }));
 }
 //#endregion
-export { r as controlAttributes, i as controlClassName, o as createControl, u as decorateIconAction, l as nativeControlTag, c as registerControl, a as renderControl };
+export { i as controlAttributes, a as controlClassName, s as createControl, f as decorateIconAction, u as nativeControlTag, l as registerControl, o as renderControl };

package/controls.d.ts

@@ -1,4 +1,3 @@
-import { BadgeOptions } from './badge';
 import { h, ComponentChildren, JSX } from './_vendor/preact/src/index';
 import { SegmentedSwitchProps, SegmentedSwitchValue } from './segmented-switch';
 import { EditorPane, EditorSplitLayout } from './editor-layout';
@@ -106,7 +105,7 @@ export declare function Panel({ children, className, label }: ShellProps): h.JSX
 export declare function Toolbar({ children, className, label }: ShellProps): h.JSX.Element;
 export declare function ToolbarGroup({ children, className, label }: ShellProps): h.JSX.Element;
 export declare function ToolbarSeparator(): h.JSX.Element;
-export declare function Badge({ children, className, variant, shape, }: ShellProps & BadgeOptions): h.JSX.Element;
+export { Badge } from './badge.view';
 export declare function CountBadge({ count, label }: {
     count: number;
     label: string;
@@ -134,6 +133,17 @@ export declare function Submenu({ label, children }: ShellProps & {
     label: string;
 }): h.JSX.Element;
 export declare function ResizeHandle(props: ResizeOptions): h.JSX.Element;
+export interface PanelResizeHandleProps extends Omit<ResizeOptions, 'value' | 'direction'> {
+    edge: 'left' | 'right';
+    initialWidth: number;
+    anchorRef?: {
+        current: HTMLDivElement | null;
+    };
+    /** Measure the outer host when it owns the resized width. */
+    resizeParent?: boolean;
+}
+/** Measures the containing panel and places a width control on its physical edge. */
+export declare function PanelResizeHandle({ edge, initialWidth, anchorRef, resizeParent, max, ...props }: PanelResizeHandleProps): h.JSX.Element;
 export type PaginationDirection = 'first' | 'previous' | 'next' | 'last';
 export type PaginationButtonOptions = Pick<ButtonProps, 'disabled' | 'variant' | 'className' | 'title'>;
 export interface PaginationProps {

package/controls.js

@@ -1,3 +1,4 @@
-import { A as e, C as t, D as n, E as r, F as i, I as a, L as o, M as s, N as c, O as l, P as u, R as d, S as f, T as p, _ as m, a as h, b as g, c as _, d as v, f as y, g as b, h as x, i as S, j as C, k as w, l as T, m as E, n as D, o as O, p as k, r as A, s as j, t as M, u as N, v as P, w as F, x as I, y as L } from "./_chunks/controls-DsNi8V8I.js";
-import { EditorList as R, EditorListGroup as z, EditorListItem as B, EditorListItemContent as V, EditorPane as H, EditorSplitLayout as U } from "./editor-layout/index.js";
-export { d as Alert, M as Badge, D as Button, A as ButtonGroup, S as Chip, h as CircularProgress, O as CountBadge, j as DateInput, _ as DateTimeInput, T as Disclosure, N as EmptyState, v as FieldError, y as FieldHint, k as FormSection, E as IconButton, R as Listbox, z as ListboxGroup, B as ListboxOption, V as ListboxOptionContent, x as LoadingOverlay, b as Menu, m as MenuItem, P as MenuSeparator, L as NumberInput, g as NumberStepper, I as Pagination, H as Pane, f as Panel, t as RadioGroup, F as Rating, p as ResizeHandle, r as SegmentedControl, n as Spinner, U as SplitLayout, l as Submenu, w as TabPanel, e as Tabs, C as TextInput, s as Textarea, c as TimeInput, u as ToggleButton, i as Toolbar, a as ToolbarGroup, o as ToolbarSeparator };
+import { t as e } from "./_chunks/selection-list-tooltips-m00U3L6z.js";
+import { A as t, B as n, C as r, D as i, E as a, F as o, I as s, L as c, M as l, N as u, O as d, P as f, R as p, S as m, T as h, _ as g, a as _, b as v, c as y, d as b, f as x, g as S, h as C, i as w, j as T, k as E, l as D, m as O, n as k, o as A, p as j, r as M, s as N, t as P, u as F, v as I, w as L, x as R, y as z } from "./_chunks/controls-B3EgM_DS.js";
+import { EditorList as B, EditorListGroup as V, EditorListItem as H, EditorListItemContent as U, EditorPane as W, EditorSplitLayout as G } from "./editor-layout/index.js";
+export { p as Alert, n as Badge, P as Button, k as ButtonGroup, M as Chip, w as CircularProgress, _ as CountBadge, A as DateInput, N as DateTimeInput, y as Disclosure, D as EmptyState, F as FieldError, b as FieldHint, x as FormSection, j as IconButton, B as Listbox, V as ListboxGroup, H as ListboxOption, U as ListboxOptionContent, O as LoadingOverlay, C as Menu, S as MenuItem, g as MenuSeparator, I as NumberInput, z as NumberStepper, v as Pagination, W as Pane, R as Panel, m as PanelResizeHandle, r as RadioGroup, L as Rating, h as ResizeHandle, a as SegmentedControl, i as Spinner, G as SplitLayout, d as Submenu, E as TabPanel, t as Tabs, T as TextInput, l as Textarea, u as TimeInput, f as ToggleButton, o as Toolbar, s as ToolbarGroup, c as ToolbarSeparator, e as useSelectionListTooltips };

package/core/anchored-popover.js

@@ -1,4 +1,4 @@
-//#region src/core/anchored-popover.ts
+//#region package/core/anchored-popover.ts
 function e(e, t, n, r = 4, i = 8) {
 	let a = e.bottom + r, o = e.top - t.height - r, s = a + t.height <= n.height - i || o < i ? "below" : "above", c = e.left, l = e.right - t.width, u = c + t.width <= n.width - i || l < i ? "left" : "right";
 	return {

package/core/control-id.js

@@ -1,4 +1,4 @@
-//#region src/core/control-id.ts
+//#region package/core/control-id.ts
 function e(e = "rv-control") {
 	return `${e}-${globalThis.crypto?.randomUUID ? globalThis.crypto.randomUUID() : `${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`}`;
 }

package/core/editor-popup-position.d.ts

@@ -1,8 +1,12 @@
-/** Keep the owning field visible, scrolling the popup on the roomier side when necessary. */
+/** Prefer keeping the field visible, with an optional viewport fit for larger editors. */
 export declare function calculateEditorPopupPosition(anchor: Pick<DOMRect, 'left' | 'right' | 'top' | 'bottom'>, popup: Pick<DOMRect, 'width' | 'height'>, viewport: {
     width: number;
     height: number;
-}, gap?: number, inset?: number): {
+}, { gap, inset, fitViewport }?: {
+    gap?: number | undefined;
+    inset?: number | undefined;
+    fitViewport?: boolean | undefined;
+}): {
     placementY: string;
     maxHeight: number;
     top: number;

package/core/editor-popup.d.ts

@@ -6,6 +6,10 @@ export interface EditorPopupHandle {
 export interface EditorPopupOptions {
     label: string;
     className?: string;
+    /** Allow overlap with the anchor when the popup needs more vertical room. */
+    fitViewport?: boolean;
+    /** A separate trigger can toggle the popup without applying the draft. */
+    trigger?: HTMLElement;
     onClose?: () => void;
     isAvailable?: () => boolean;
 }

package/core/editor-popup.js

@@ -1 +1 @@
-export { t as mountEditorPopup } from "../_chunks/editor-popup-WDdtVDNA.js";
+export { t as mountEditorPopup } from "../_chunks/editor-popup-NNP9Fh9U.js";

package/core/motion.js

@@ -1,4 +1,4 @@
-//#region src/core/motion.ts
+//#region package/core/motion.ts
 function e(e) {
 	let t = [];
 	for (let n = e; n;) {

package/core/popover-controller.d.ts

@@ -0,0 +1,35 @@
+export interface PopoverOptions {
+    anchor: HTMLElement | SVGElement;
+    placement?: 'above';
+    content: HTMLElement;
+    /** Defaults to the document body. */
+    appendTo?: HTMLElement;
+    onClose?: () => void;
+    restoreFocus?: boolean;
+    closeOnOutside?: boolean;
+    closeOnEscape?: boolean;
+    display?: string;
+}
+/** One owner for native top-layer promotion, viewport positioning and disposal. */
+export declare class PopoverController {
+    private active?;
+    get isOpen(): boolean;
+    open(options: PopoverOptions): {
+        close: (restoreFocus?: boolean) => void;
+        refresh: () => void;
+    };
+    refresh(): void;
+    close(restoreFocus?: boolean): void;
+    destroy(): void;
+}
+export declare function createTooltipElement(document: Document, className?: string): HTMLDivElement;
+/** Imperative binding adapter over the same session used by useTooltip. */
+export declare class TooltipController {
+    private release?;
+    bind(anchor: HTMLElement | SVGElement, text: string, options?: {
+        trigger?: 'hover' | 'click';
+        surface?: HTMLElement;
+        onEscape?: () => void;
+    }): () => void;
+    destroy(): void;
+}

package/core/popover-controller.js

@@ -0,0 +1,102 @@
+import { calculateAnchoredPopoverPosition as e } from "./anchored-popover.js";
+import { t } from "../_chunks/jsxRuntime.module-F6UFnpT-.js";
+import { createPreactElement as n, releasePreactElement as r } from "../preact-mount.js";
+import { o as i, r as a, t as o } from "../_chunks/top-layer-popup-CKJ7VJOF.js";
+import { t as s } from "../_chunks/tooltip-session-CBtRMBPr.js";
+import { createControlId as c } from "./control-id.js";
+import { inheritUiMotion as l } from "./motion.js";
+//#region package/core/popover-controller.tsx
+var u = /* @__PURE__ */ new WeakMap(), d = class {
+	active;
+	get isOpen() {
+		return !!this.active;
+	}
+	open(t) {
+		this.close(!1);
+		let { anchor: n, content: r } = t, s = n.ownerDocument, c = s.defaultView, d = u.get(s) ?? [];
+		u.set(s, d);
+		let f = r.parentNode, p = r.nextSibling, m = r.hidden, h = r.getAttribute("style"), g = r.getAttribute("popover"), _ = l(n, r), v = () => {
+			if (!n.isConnected) {
+				x(!1);
+				return;
+			}
+			let a = (t.placement === "above" ? i : e)(n.getBoundingClientRect(), r.getBoundingClientRect(), {
+				width: s.documentElement.clientWidth || c?.innerWidth || 0,
+				height: s.documentElement.clientHeight || c?.innerHeight || 0
+			});
+			Object.assign(r.style, {
+				left: `${a.left}px`,
+				top: `${a.top}px`
+			});
+		}, y, b = !1, x = (e = t.restoreFocus !== !1) => {
+			if (b) return;
+			b = !0, s.removeEventListener("pointerdown", S, !0), r.removeEventListener("keydown", C), s.removeEventListener("keydown", C), c?.removeEventListener("resize", v), s.removeEventListener("scroll", v, !0), w?.disconnect();
+			let i = d.indexOf(r);
+			i !== -1 && d.splice(i, 1), o(r, y), _(), f?.isConnected ? f.insertBefore(r, p?.parentNode === f ? p : null) : r.remove(), h === null ? r.removeAttribute("style") : r.setAttribute("style", h), r.hidden = m, g === null ? r.removeAttribute("popover") : r.setAttribute("popover", g), this.active?.content === r && (this.active = void 0), e && n.isConnected && n.focus({ preventScroll: !0 }), t.onClose?.();
+		}, S = (e) => {
+			if (d.at(-1) !== r) return;
+			let i = e.composedPath();
+			t.closeOnOutside !== !1 && !i.includes(n) && !i.includes(r) && x(!1);
+		}, C = (e) => {
+			d.at(-1) === r && e.key === "Escape" && t.closeOnEscape !== !1 && !e.defaultPrevented && (e.preventDefault(), e.stopPropagation(), x());
+		};
+		(t.appendTo ?? s.body).append(r), r.hidden = !1, Object.assign(r.style, {
+			position: "fixed",
+			inset: "auto",
+			margin: "0"
+		}), y = a(r, t.display ?? "block");
+		let w = c?.ResizeObserver ? new c.ResizeObserver(v) : void 0;
+		return w?.observe(n), w?.observe(r), this.active = {
+			content: r,
+			close: x,
+			position: v
+		}, d.push(r), s.addEventListener("pointerdown", S, !0), r.addEventListener("keydown", C), s.addEventListener("keydown", C), c?.addEventListener("resize", v), s.addEventListener("scroll", v, !0), v(), {
+			close: x,
+			refresh: v
+		};
+	}
+	refresh() {
+		this.active?.position();
+	}
+	close(e) {
+		this.active?.close(e);
+	}
+	destroy() {
+		this.close(!1);
+	}
+};
+function f(e, r = "grid-tooltip") {
+	return n(e, /* @__PURE__ */ t("div", {
+		id: c("rv-tooltip"),
+		class: r,
+		role: "tooltip",
+		hidden: !0
+	}));
+}
+var p = class {
+	release;
+	bind(e, t, n = {}) {
+		this.destroy();
+		let i = n.surface ?? f(e.ownerDocument, "rv-tooltip");
+		i.textContent = t;
+		let a = new s();
+		a.setSurface(i), a.onEscape = n.onEscape;
+		let o = n.trigger === "click", c = e.getAttribute("aria-expanded");
+		o && e.setAttribute("aria-expanded", "false"), a.onHide = () => {
+			o && e.setAttribute("aria-expanded", "false");
+		};
+		let l = () => {
+			a.show(e), o && e.setAttribute("aria-expanded", String(a.isOpen));
+		}, u = () => a.isOpen ? a.hide() : l(), d = () => a.focus(e), p = () => a.blur(), m = () => a.leave(e), h = () => {
+			a.pointerDown(), a.hide();
+		}, g = (e) => a.keyDown(e);
+		return o ? e.addEventListener("click", u) : (e.addEventListener("pointerenter", l), e.addEventListener("pointerleave", m), e.addEventListener("focus", d), e.addEventListener("blur", p), e.addEventListener("pointerdown", h), e.addEventListener("keydown", g)), this.release = () => {
+			a.destroy(), e.removeEventListener("click", u), e.removeEventListener("pointerenter", l), e.removeEventListener("pointerleave", m), e.removeEventListener("focus", d), e.removeEventListener("blur", p), e.removeEventListener("pointerdown", h), e.removeEventListener("keydown", g), o && (c === null ? e.removeAttribute("aria-expanded") : e.setAttribute("aria-expanded", c)), n.surface || r(i);
+		}, () => this.destroy();
+	}
+	destroy() {
+		this.release?.(), this.release = void 0;
+	}
+};
+//#endregion
+export { d as PopoverController, p as TooltipController, f as createTooltipElement };

package/core/popup-ownership.d.ts

@@ -0,0 +1,2 @@
+/** Includes portalled descendants linked by their owning trigger's aria-controls. */
+export declare function ownsPopupTarget(root: HTMLElement | null | undefined, target: Node | null): boolean;

package/core/selection-list-tooltips.d.ts

@@ -0,0 +1,2 @@
+/** One delegated binding per list, including options rendered by custom templates. */
+export declare function useSelectionListTooltips(optionSelector?: string): (root: HTMLElement | null) => void;

package/core/title-tooltip.d.ts

@@ -0,0 +1,2 @@
+/** Native title replacement, without wrappers or changes to consumer handlers. */
+export declare function useTitleTooltip<T extends HTMLElement | SVGElement>(title?: string, onEscape?: () => void): import('../_vendor/preact/src/index').RefObject<T>;

package/core/tooltip-session.d.ts

@@ -0,0 +1,29 @@
+export type TooltipAnchor = HTMLElement | SVGElement;
+/** One lifecycle for declarative and imperative tooltip adapters. */
+export declare class TooltipSession {
+    private anchor?;
+    private surface?;
+    private timer?;
+    private mode?;
+    private cleanup?;
+    private mounted;
+    private pointerFocus;
+    private open;
+    private addedDescription;
+    onHide?: () => void;
+    onEscape?: () => void;
+    delay: number;
+    get isOpen(): boolean;
+    get isPending(): boolean;
+    setSurface(surface: HTMLElement | null): void;
+    show(anchor: TooltipAnchor): void;
+    private present;
+    hide(): void;
+    focus(anchor: TooltipAnchor): void;
+    blur(): void;
+    pointerDown(): void;
+    leave(anchor?: TooltipAnchor): void;
+    keyDown(event: KeyboardEvent): void;
+    destroy(): void;
+    private listen;
+}

package/core/tooltip-surface.d.ts

@@ -0,0 +1,13 @@
+/** Shared presentation for text hints and rich product/chart tooltip content. */
+export declare const TOOLTIP_STYLES = "\n.rv-tooltip.rv-tooltip {\n  box-sizing: border-box;\n  position: fixed;\n  z-index: 100000;\n  margin: 0;\n  inset: auto;\n  transform: none;\n  opacity: 1;\n  visibility: visible;\n  padding: 6px 10px;\n  border: 0;\n  border-radius: 6px;\n  background: var(--rv-tooltip-bg, #191919);\n  color: var(--rv-tooltip-fg, #fff);\n  box-shadow: 0 4px 14px var(--rv-ui-shadow, rgb(0 0 0 / 18%));\n  font: 12px/1.4 var(--rv-ui-font-family, Inter, ui-sans-serif, system-ui, sans-serif);\n  font-weight: 400;\n  text-align: start;\n  white-space: pre-wrap;\n  overflow-wrap: anywhere;\n  max-width: min(360px, calc(100vw - 16px));\n  max-height: calc(100dvh - 16px);\n  overflow: auto;\n  pointer-events: none;\n}\n.rv-tooltip[hidden], .rv-tooltip[data-visible=\"false\"] { display: none; }\n.rv-tooltip[data-overflow] { pointer-events: auto; }\n@media (forced-colors: active) {\n  .rv-tooltip.rv-tooltip { color: CanvasText; background: Canvas; border: 1px solid CanvasText; }\n}\n";
+/** Also installs into shadow roots/fullscreen roots used by standalone charts. */
+export declare function ensureTooltipStyles(root: Document | ShadowRoot): void;
+export declare function prepareTooltipSurface(element: HTMLElement): void;
+/** Shared hint placement: centered above the trigger, with a bounded below fallback. */
+export declare function calculateTooltipPosition(anchor: DOMRect, popup: DOMRect, viewport: {
+    width: number;
+    height: number;
+}): import('./anchored-popover').AnchoredPopoverPosition | {
+    left: number;
+    top: number;
+};

package/core/tooltip-text.d.ts

@@ -0,0 +1,6 @@
+import { JSX } from '../_vendor/preact/src/index';
+/** Wrapper-free shared hint for otherwise native text and label elements. */
+export declare function TooltipText({ as, title, children, ...attributes }: Omit<JSX.HTMLAttributes<HTMLElement>, 'title'> & {
+    as?: 'span' | 'label' | 'div';
+    title?: string;
+}): JSX.Element;

package/core/tooltip.d.ts

@@ -0,0 +1,35 @@
+import { h, ComponentChildren, TargetedEvent } from '../_vendor/preact/src/index';
+type TooltipPresentation = {
+    className?: string;
+    placement?: 'above';
+    delay?: number;
+    content?: ComponentChildren;
+};
+/** Preact adapter; the session owns all tooltip behavior and DOM lifecycle. */
+export declare function useControlTooltip(text: string, _floating?: boolean, presentation?: TooltipPresentation): {
+    readonly id: string;
+    readonly hide: () => void;
+    readonly triggerProps: {
+        readonly 'aria-describedby': string;
+        readonly onFocus: (event: TargetedEvent<HTMLElement>) => void;
+        readonly onBlur: () => void;
+        readonly onMouseEnter: (event: TargetedEvent<HTMLElement>) => void;
+        readonly onMouseLeave: (event?: TargetedEvent<HTMLElement>) => void;
+        readonly onPointerDown: (_event: TargetedEvent<HTMLElement>) => void;
+        readonly onPointerCancel: () => void;
+        readonly onKeyDown: (event: KeyboardEvent) => void;
+    };
+    readonly tooltip: h.JSX.Element;
+};
+/** Controlled surface adapter retained for existing consumers. */
+export declare function ControlTooltip({ id, text, content, visible, anchor, className, }: {
+    readonly id: string;
+    readonly text: string;
+    readonly content?: ComponentChildren;
+    readonly visible: boolean;
+    readonly anchor?: HTMLElement | null;
+    readonly className?: string;
+    readonly placement?: 'above';
+}): h.JSX.Element;
+export declare const useTooltip: typeof useControlTooltip;
+export {};

package/core/top-layer-popup.d.ts

@@ -1,3 +1,5 @@
+export { ensureTooltipStyles, prepareTooltipSurface, TOOLTIP_STYLES, } from './tooltip-surface';
+export { ownsPopupTarget } from './popup-ownership';
 export type TopLayerPopupMode = 'popover' | 'fallback';
 export type TopLayerPopupElement = HTMLElement & {
     showPopover?: () => void;
@@ -7,3 +9,5 @@ export type TopLayerPopupElement = HTMLElement & {
 export declare function showTopLayerPopup(element: TopLayerPopupElement, visibleDisplay?: string): TopLayerPopupMode;
 /** Hides an overlay opened by `showTopLayerPopup`; safe to call repeatedly. */
 export declare function hideTopLayerPopup(element: TopLayerPopupElement, mode?: TopLayerPopupMode): void;
+/** Includes portalled popup content linked by descendant aria-controls triggers. */
+export declare function popupOwnsTarget(panel: HTMLElement, target: Node | null): boolean;

package/core/top-layer-popup.js

@@ -1,23 +1 @@
-//#region src/core/top-layer-popup.ts
-var e = /* @__PURE__ */ new WeakMap();
-function t(t, n = "flex") {
-	if (e.has(t) || e.set(t, t.getAttribute("data-rv-ui-surface")), t.setAttribute("data-rv-ui-surface", ""), t.style.display = n, typeof t.showPopover == "function") {
-		t.setAttribute("popover", "manual");
-		try {
-			return t.showPopover(), "popover";
-		} catch {
-			t.removeAttribute("popover");
-		}
-	}
-	return t.style.display = n, "fallback";
-}
-function n(t, n) {
-	let r = e.get(t);
-	if (r !== void 0 && (r === null ? t.removeAttribute("data-rv-ui-surface") : t.setAttribute("data-rv-ui-surface", r), e.delete(t)), n === "popover" && typeof t.hidePopover == "function") try {
-		t.hidePopover(), t.style.removeProperty("display");
-		return;
-	} catch {}
-	t.style.display = "none";
-}
-//#endregion
-export { n as hideTopLayerPopup, t as showTopLayerPopup };
+export { a as TOOLTIP_STYLES, s as ensureTooltipStyles, t as hideTopLayerPopup, i as ownsPopupTarget, n as popupOwnsTarget, c as prepareTooltipSurface, r as showTopLayerPopup } from "../_chunks/top-layer-popup-CKJ7VJOF.js";