@alfadocs/ui-kit-debug 1.43.0 → 1.45.0

package/dist/components/rich-text-editor/rich-text-editor.d.ts

@@ -42,15 +42,71 @@ export interface RichTextEditorVariable {
     token: string;
     /** Human label shown in the menu (translated by the host). */
     label: string;
-    /** Optional second line in the menu. */
+    /** Optional second line in the menu (reserved for a future resolved-value
+     * preview — not rendered yet). */
     description?: string;
+    /**
+     * One of the fixed catalogue groups the VariablesMenu renders as section
+     * headers: `patient`, `appointment`, `practice`, `operator`, `document`.
+     * Any other value (or omitting it) lands the variable in the menu's
+     * "Other" group at the end.
+     */
+    group?: 'patient' | 'appointment' | 'practice' | 'operator' | 'document' | string;
+}
+/** A practice template the AI pill's Templates menu offers. */
+export interface RichTextEditorAiTemplate {
+    id: string;
+    name: string;
+    /** Second line in the menu. */
+    description?: string;
+    /** @deprecated The host's order is the menu order. Ignored. */
+    isDefault?: boolean;
+}
+/**
+ * What a one-shot AI action rewrites: the selection when there is one, else
+ * the whole document. Resolve with the rewritten HTML for that same scope.
+ */
+export interface RichTextEditorAiActionRequest {
+    html: string;
+    /** `html` as plain text. */
+    text: string;
+    scope: 'selection' | 'document';
+    signal: AbortSignal;
+}
+/** Practice templates as an AI pill segment (and in the selection bubble). */
+export interface RichTextEditorAiTemplates {
+    /** In menu order, first to last. */
+    templates: RichTextEditorAiTemplate[];
+    /** The AI call. Reject with an error named `AiCreditsExhaustedError` on 402. */
+    onRun: (request: RichTextEditorAiActionRequest & {
+        template: RichTextEditorAiTemplate;
+    }) => Promise<string>;
+    /** Shows "Manage templates" / "Create your first template". */
+    onManage?: (mode: 'list' | 'create') => void;
+}
+/** Fired after a one-shot AI action rewrote the note. */
+export interface RichTextEditorAiApplied {
+    action: 'proofread' | 'format' | 'template';
+    template?: RichTextEditorAiTemplate;
+    scope: 'selection' | 'document';
+    /** The document before the change. */
+    previousHtml: string;
+    /** Puts `previousHtml` back. */
+    undo: () => void;
 }
 /** What a host's own Help-me-write surface gets from `renderHelpMeWrite`. */
 export interface HelpMeWriteRenderContext {
     /** Whether the surface should show (consent is already granted). */
     open: boolean;
     onClose: () => void;
-    /** Text of the selection when the reader opened it; '' for a caret. */
+    /**
+     * What the reader asked about: `'document'` from the AI pill (use the
+     * whole note as context; `insertAtSelection` inserts at the caret) or
+     * `'selection'` from the selection bubble (`selectionText` is the context,
+     * and `insertAtSelection` replaces it).
+     */
+    scope: 'document' | 'selection';
+    /** Text of the selection when opened from the bubble; '' otherwise. */
     selectionText: string;
     getHTML: () => string;
     getText: () => string;
@@ -157,20 +213,31 @@ export interface RichTextEditorProps {
         onFinalTranscript: (text: string) => void;
     }) => Promise<void>;
     /**
-     * One-shot AI document actions (CONSUMER-PROVIDED backend). Each gets the
-     * current HTML + an AbortSignal and resolves with rewritten HTML; while one
-     * runs the editor is disabled with a spinner and the result replaces the whole
-     * document. `onProofread` corrects spelling/grammar; `onAutoFormat` tidies the
-     * document's structure/formatting. Each adds a FAB segment when provided.
+     * One-shot AI actions (CONSUMER-PROVIDED backend). Each gets the HTML to
+     * rewrite (the selection if there is one, else the whole document) and
+     * resolves with the rewritten HTML, which replaces that same scope. While
+     * one runs the editor is disabled with a spinner. `onProofread` corrects
+     * spelling/grammar; `onAutoFormat` tidies structure/formatting. Each adds a
+     * pill segment and a selection-bubble button. Gated by `aiConsent`.
      */
-    onProofread?: (ctx: {
-        html: string;
-        signal: AbortSignal;
-    }) => Promise<string>;
-    onAutoFormat?: (ctx: {
-        html: string;
-        signal: AbortSignal;
-    }) => Promise<string>;
+    onProofread?: (ctx: RichTextEditorAiActionRequest) => Promise<string>;
+    onAutoFormat?: (ctx: RichTextEditorAiActionRequest) => Promise<string>;
+    /** Practice templates: a Templates pill segment that runs one in one click. */
+    aiTemplates?: RichTextEditorAiTemplates;
+    /** After a one-shot action rewrote the note; use it to offer Undo. */
+    onAiApplied?: (applied: RichTextEditorAiApplied) => void;
+    /**
+     * Sparkle the AI pill when it appears, while an action runs and when the
+     * result lands. Default `true`; motion is off under reduced motion and in
+     * the accessible themes. The pill carries `data-ai-sparkle` for styling.
+     */
+    aiSparkle?: boolean;
+    /**
+     * A bubble over a text selection with quick formats and the AI actions.
+     * Default: on when the editor has any AI action (templates, proofread,
+     * auto-format or Help me write).
+     */
+    selectionToolbar?: boolean;
     /**
      * Template variables. When provided, the toolbar gains an "Insert variable"
      * menu that inserts `[[TOKEN]]` as a chip (Redactor's native `variable`
@@ -178,6 +245,20 @@ export interface RichTextEditorProps {
      * for these tokens in inbound content renders as a chip too.
      */
     variables?: RichTextEditorVariable[];
+    /**
+     * Most-recently-used variable tokens, most recent first. Rendered as a
+     * "Recent" group pinned above the catalogue (max 3 shown). The kit never
+     * persists this itself — the host owns storage (see `onVariableInserted`
+     * and the `usePersistentState` example in this component's `.mdx`).
+     */
+    recentVariableTokens?: string[];
+    /**
+     * Fires with the token whenever a variable is inserted from either the
+     * toolbar button or the `[[` caret menu — the seam a host uses to build
+     * `recentVariableTokens`. Does not fire for typed `[[TOKEN]]` text that
+     * becomes a chip on its own (only for a menu pick).
+     */
+    onVariableInserted?: (token: string) => void;
     /**
      * Decide whether a `[[TOKEN]]` is valid. Default: it is one of `variables`
      * (any letter case). Invalid tokens render as error chips with a message
@@ -213,6 +294,8 @@ export interface RichTextEditorHandle {
     getText: () => string;
     /** Always '' — Redactor has no native Markdown serializer (see MDX). */
     getMarkdown: () => string;
+    /** A one-shot AI action (template, spelling, auto-format) is running. */
+    isAiBusy: () => boolean;
     /** HTML goes through DOMPurify before reaching Redactor. */
     setContent: (html: string) => void;
     /**

package/dist/components/rich-text-editor/rich-text-editor.d.ts.map

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

package/dist/components/variables-menu/index.d.ts

@@ -0,0 +1,4 @@
+export { VariablesMenu } from './variables-menu';
+export type { VariablesMenuProps, VariablesMenuVariable, VariablesMenuGroup, VariablesMenuHandle, VariablesMenuCloseReason, } from './variables-menu';
+export { variablesMenuAgent } from './variables-menu.agent';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/variables-menu/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/variables-menu/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EACV,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/components/variables-menu/index.js

@@ -0,0 +1,6 @@
+import { V as r, v as s } from "../../_chunks/variables-menu-vXUaSBj4.js";
+export {
+  r as VariablesMenu,
+  s as variablesMenuAgent
+};
+//# sourceMappingURL=index.js.map

package/dist/components/variables-menu/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/components/variables-menu/variables-menu.agent.d.ts

@@ -0,0 +1,10 @@
+import type { AgentAdapter } from '../../agent/types';
+interface VariablesMenuAgentHandle {
+    getQuery: () => string;
+    getVisibleTokens: () => string[];
+    selectToken: (token: string) => void;
+    close: () => void;
+}
+export declare const variablesMenuAgent: AgentAdapter<VariablesMenuAgentHandle>;
+export {};
+//# sourceMappingURL=variables-menu.agent.d.ts.map

package/dist/components/variables-menu/variables-menu.agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variables-menu.agent.d.ts","sourceRoot":"","sources":["../../../src/components/variables-menu/variables-menu.agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,UAAU,wBAAwB;IAChC,QAAQ,EAAE,MAAM,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,MAAM,EAAE,CAAC;IACjC,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,eAAO,MAAM,kBAAkB,EAAE,YAAY,CAAC,wBAAwB,CAqErE,CAAC"}

package/dist/components/variables-menu/variables-menu.d.ts

@@ -0,0 +1,53 @@
+import { type KeyboardEvent as ReactKeyboardEvent } from 'react';
+export type VariablesMenuGroup = 'patient' | 'appointment' | 'practice' | 'operator' | 'document';
+/** A single merge variable the menu can insert. */
+export interface VariablesMenuVariable {
+    /** Inserted as `[[token]]`. Letters, digits and underscores only. */
+    token: string;
+    /** Localised label shown at the start of the row. */
+    label: string;
+    /** Optional second line (reserved for a future resolved-value preview). */
+    description?: string;
+    /** One of the fixed catalogue groups. Ungrouped variables land in "Other". */
+    group?: VariablesMenuGroup | string;
+}
+export type VariablesMenuCloseReason = 'escape' | 'select' | 'outside' | 'backspace';
+/** Imperative surface for a host that owns its own keydown handling (the
+ * caret anchor forwards key events from the editor's contenteditable region,
+ * which sits outside this component's own DOM subtree). */
+export interface VariablesMenuHandle {
+    /** Forward a keydown from the host. Returns true when the menu consumed
+     * it — the host should then call `preventDefault`/`stopPropagation`. */
+    handleKeyDown: (event: ReactKeyboardEvent | KeyboardEvent) => boolean;
+    /** Focus the search field (button anchor only — the caret anchor keeps
+     * focus in the editor and never calls this). */
+    focusSearch: () => void;
+}
+export interface VariablesMenuProps {
+    /** Stable id for agent registration / DOM addressing. */
+    id?: string;
+    className?: string;
+    /** The full catalogue on offer. */
+    variables: VariablesMenuVariable[];
+    /** Most-recently-used tokens, most recent first. Only the first 3 render. */
+    recentTokens?: string[];
+    /** Current filter text. Always controlled — the caret anchor mirrors the
+     * text the reader is typing into the document; the button anchor mirrors
+     * its own search field. */
+    query: string;
+    onQueryChange: (query: string) => void;
+    onSelect: (variable: VariablesMenuVariable) => void;
+    onClose: (reason: VariablesMenuCloseReason) => void;
+    /** False for the caret anchor: no search field at all — the text typed
+     * after `[[` in the document is the filter, the host's contenteditable
+     * keeps focus and forwards keys via the imperative handle. Default true. */
+    searchFocusable?: boolean;
+    'aria-label'?: string;
+    /** Fires whenever the active row's DOM id changes (including to
+     * `undefined` when the list is empty). The caret anchor mirrors this onto
+     * the editor's own `aria-activedescendant`, since focus — and so the
+     * combobox role — lives on the contenteditable, not in this component. */
+    onActiveDescendantChange?: (id: string | undefined) => void;
+}
+export declare const VariablesMenu: import("react").ForwardRefExoticComponent<VariablesMenuProps & import("react").RefAttributes<VariablesMenuHandle>>;
+//# sourceMappingURL=variables-menu.d.ts.map

package/dist/components/variables-menu/variables-menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variables-menu.d.ts","sourceRoot":"","sources":["../../../src/components/variables-menu/variables-menu.tsx"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,aAAa,IAAI,kBAAkB,EAEzC,MAAM,OAAO,CAAC;AAmBf,MAAM,MAAM,kBAAkB,GAC1B,SAAS,GACT,aAAa,GACb,UAAU,GACV,UAAU,GACV,UAAU,CAAC;AAEf,mDAAmD;AACnD,MAAM,WAAW,qBAAqB;IACpC,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAAC;CACrC;AAED,MAAM,MAAM,wBAAwB,GAChC,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,WAAW,CAAC;AAEhB;;2DAE2D;AAC3D,MAAM,WAAW,mBAAmB;IAClC;4EACwE;IACxE,aAAa,EAAE,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa,KAAK,OAAO,CAAC;IACtE;oDACgD;IAChD,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,yDAAyD;IACzD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,SAAS,EAAE,qBAAqB,EAAE,CAAC;IACnC,6EAA6E;IAC7E,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;+BAE2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,QAAQ,EAAE,CAAC,QAAQ,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACpD,OAAO,EAAE,CAAC,MAAM,EAAE,wBAAwB,KAAK,IAAI,CAAC;IACpD;;gFAE4E;IAC5E,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;8EAG0E;IAC1E,wBAAwB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;CAC7D;AA+JD,eAAO,MAAM,aAAa,oHAqTxB,CAAC"}

package/dist/hooks/index.d.ts

@@ -30,4 +30,5 @@ export { usePresenceTransition, type PresencePhase, type UsePresenceTransitionOp
 export { useListReflow, REFLOW_ROW_CLASS, type UseListReflowOptions, type UseListReflowReturn, } from './use-list-reflow';
 export { useClampOverflow } from './use-clamp-overflow';
 export { useScrollOverflow, type UseScrollOverflowReturn, } from './use-scroll-overflow';
+export { useAiSparkle, SHIMMER_CLASS as AI_SPARKLE_SHIMMER_CLASS, COMET_CLASS as AI_SPARKLE_COMET_CLASS, BURST_CLASS as AI_SPARKLE_BURST_CLASS, SPARKLE_GLYPHS as AI_SPARKLE_GLYPHS, COMET_TAIL as AI_SPARKLE_COMET_TAIL, COMET_WRAPPER_CLASS as AI_SPARKLE_COMET_WRAPPER_CLASS, type AiSparkleState, type UseAiSparkleOptions, type UseAiSparkleProps, type UseAiSparkleReturn, } from './use-ai-sparkle';
 //# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

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

package/dist/hooks/index.js

@@ -1,40 +1,41 @@
-import { u as h } from "../_chunks/use-prefers-reduced-motion-BMwIQRjB.js";
-import { u as y } from "../_chunks/use-media-query-CcAx5SMM.js";
-import { Z as D, u as R, a as _, b as F } from "../_chunks/use-zoom-drilldown-qCX34w9I.js";
-import { u as g } from "../_chunks/use-count-up-BLLetaZ8.js";
-import { u as k } from "../_chunks/use-locale-BkCIHujH.js";
-import { A as M, T as V, a as W, r as H, t as N, u as Y } from "../_chunks/use-theme-CAuo6EYT.js";
-import { u as q } from "../_chunks/use-controllable-state-BiY4xTzM.js";
-import { u as G } from "../_chunks/use-copy-to-clipboard-Cyfc_dlv.js";
+import { u as R } from "../_chunks/use-prefers-reduced-motion-BMwIQRjB.js";
+import { u as I } from "../_chunks/use-media-query-CcAx5SMM.js";
+import { Z as h, u as v, a as y, b as w } from "../_chunks/use-zoom-drilldown-qCX34w9I.js";
+import { u as K } from "../_chunks/use-count-up-BLLetaZ8.js";
+import { u as M } from "../_chunks/use-locale-BkCIHujH.js";
+import { A as k, T as H, a as W, r as B, t as V, u as Y } from "../_chunks/use-theme-CAuo6EYT.js";
+import { u as N } from "../_chunks/use-controllable-state-BiY4xTzM.js";
+import { u as Z } from "../_chunks/use-copy-to-clipboard-Cyfc_dlv.js";
 import { u as j } from "../_chunks/use-debounced-callback-BisrB-Fq.js";
-import { useState as b, useRef as x, useEffect as E } from "react";
+import { useState as A, useRef as S, useEffect as E } from "react";
 import { u as Q, a as J } from "../_chunks/use-direction-Dp8h70PP.js";
 import { u as $ } from "../_chunks/use-persistent-state-nZwZAnE9.js";
 import { u as te } from "../_chunks/use-isomorphic-layout-effect-BGfaCOP1.js";
-import { u as oe, a as ue } from "../_chunks/use-scroll-overflow-UbLrUfBo.js";
+import { u as oe, a as se } from "../_chunks/use-scroll-overflow-UbLrUfBo.js";
 import { c as ne, u as ae } from "../_chunks/use-priority-overflow-c9SjxZkZ.js";
 import { u as ce } from "../_chunks/use-web-otp-D_utzp6S.js";
 import { u as fe } from "../_chunks/use-visual-viewport-pin-ChurOsHM.js";
 import { u as de } from "../_chunks/use-edge-resize-BHesP0kg.js";
-import { u as xe } from "../_chunks/use-countdown-Yd6ts0_a.js";
-import { u as be } from "../_chunks/use-check-animation--I3cS00X.js";
-import { R as Te, u as Ce, a as Le } from "../_chunks/use-list-reflow-Cw43nxw5.js";
-import { u as Oe } from "../_chunks/use-presence-transition-cDwWUXV-.js";
-import { u as ve } from "../_chunks/use-clamp-overflow-DQE2kwZ9.js";
-function C(e, o) {
-  const [t, i] = b(e), u = x(null);
+import { u as Se } from "../_chunks/use-countdown-Yd6ts0_a.js";
+import { u as Ae } from "../_chunks/use-check-animation--I3cS00X.js";
+import { R as Le, u as _e, a as Ce } from "../_chunks/use-list-reflow-Cw43nxw5.js";
+import { u as be } from "../_chunks/use-presence-transition-cDwWUXV-.js";
+import { u as Oe } from "../_chunks/use-clamp-overflow-DQE2kwZ9.js";
+import { B as Pe, b as he, C as ve, a as ye, S as we, c as De, u as Ke } from "../_chunks/use-ai-sparkle-CyQSRTCe.js";
+function _(e, o) {
+  const [t, i] = A(e), s = S(null);
   return E(() => {
     if (o <= 0) {
-      u.current !== null && (clearTimeout(u.current), u.current = null), i(e);
+      s.current !== null && (clearTimeout(s.current), s.current = null), i(e);
       return;
     }
     const n = setTimeout(() => {
-      i(e), u.current = null;
+      i(e), s.current = null;
     }, o);
-    return u.current = n, () => clearTimeout(n);
+    return s.current = n, () => clearTimeout(n);
   }, [e, o]), t;
 }
-const S = [
+const x = [
   "a[href]",
   "button:not([disabled])",
   'input:not([disabled]):not([type="hidden"])',
@@ -47,7 +48,7 @@ const S = [
 ].join(",");
 function p(e) {
   return Array.from(
-    e.querySelectorAll(S)
+    e.querySelectorAll(x)
   ).filter((o) => {
     if (o.hidden) return !1;
     let t = o;
@@ -58,75 +59,82 @@ function p(e) {
     return !0;
   });
 }
-function L(e, o = {}) {
-  const { enabled: t = !0, autoFocus: i = !0, restoreFocus: u = !0 } = o, n = x(null);
+function C(e, o = {}) {
+  const { enabled: t = !0, autoFocus: i = !0, restoreFocus: s = !0 } = o, n = S(null);
   E(() => {
     if (!t) return;
     const a = e.current;
     if (!a) return;
     if (n.current = typeof document < "u" && document.activeElement instanceof HTMLElement ? document.activeElement : null, i) {
-      const s = p(a)[0] ?? (a.tabIndex >= -1 ? a : null);
-      s == null || s.focus();
+      const u = p(a)[0] ?? (a.tabIndex >= -1 ? a : null);
+      u == null || u.focus();
     }
     function f(r) {
       if (r.key !== "Tab") return;
-      const s = e.current;
-      if (!s) return;
-      const c = p(s);
+      const u = e.current;
+      if (!u) return;
+      const c = p(u);
       if (c.length === 0) {
         r.preventDefault();
         return;
       }
       const m = c[0], d = c[c.length - 1], l = document.activeElement;
-      r.shiftKey ? (l === m || !s.contains(l)) && (r.preventDefault(), d.focus()) : (l === d || !s.contains(l)) && (r.preventDefault(), m.focus());
+      r.shiftKey ? (l === m || !u.contains(l)) && (r.preventDefault(), d.focus()) : (l === d || !u.contains(l)) && (r.preventDefault(), m.focus());
     }
     return a.addEventListener("keydown", f), () => {
-      if (a.removeEventListener("keydown", f), u && n.current) {
+      if (a.removeEventListener("keydown", f), s && n.current) {
         const r = n.current;
         requestAnimationFrame(() => {
           r.isConnected && r.focus();
         });
       }
     };
-  }, [t, i, u, e]);
+  }, [t, i, s, e]);
 }
 export {
-  M as ACCESSIBILITY_STORAGE_KEY,
-  Te as REFLOW_ROW_CLASS,
-  V as THEME_CLASS,
+  k as ACCESSIBILITY_STORAGE_KEY,
+  Pe as AI_SPARKLE_BURST_CLASS,
+  he as AI_SPARKLE_COMET_CLASS,
+  ve as AI_SPARKLE_COMET_TAIL,
+  ye as AI_SPARKLE_COMET_WRAPPER_CLASS,
+  we as AI_SPARKLE_GLYPHS,
+  De as AI_SPARKLE_SHIMMER_CLASS,
+  Le as REFLOW_ROW_CLASS,
+  H as THEME_CLASS,
   W as THEME_STORAGE_KEY,
-  D as ZOOM_DRILLDOWN_TRANSITION_CLASS,
+  h as ZOOM_DRILLDOWN_TRANSITION_CLASS,
   ne as computePriorityLayout,
-  H as resolveTheme,
-  N as themeClassList,
-  be as useCheckAnimation,
-  ve as useClampOverflow,
-  q as useControllableState,
-  G as useCopyToClipboard,
-  g as useCountUp,
-  xe as useCountdown,
+  B as resolveTheme,
+  V as themeClassList,
+  Ke as useAiSparkle,
+  Ae as useCheckAnimation,
+  Oe as useClampOverflow,
+  N as useControllableState,
+  Z as useCopyToClipboard,
+  K as useCountUp,
+  Se as useCountdown,
   j as useDebouncedCallback,
-  C as useDebouncedValue,
+  _ as useDebouncedValue,
   Q as useDirection,
   J as useDocumentDirection,
   de as useEdgeResize,
-  Ce as useExitTransition,
-  L as useFocusTrap,
+  _e as useExitTransition,
+  C as useFocusTrap,
   te as useIsomorphicLayoutEffect,
-  Le as useListReflow,
-  k as useLocale,
-  y as useMediaQuery,
+  Ce as useListReflow,
+  M as useLocale,
+  I as useMediaQuery,
   oe as useOverflowCollapse,
   $ as usePersistentState,
-  h as usePrefersReducedMotion,
-  Oe as usePresenceTransition,
+  R as usePrefersReducedMotion,
+  be as usePresenceTransition,
   ae as usePriorityOverflow,
-  ue as useScrollOverflow,
-  R as useScrollToFirstError,
-  _ as useSigningSession,
+  se as useScrollOverflow,
+  v as useScrollToFirstError,
+  y as useSigningSession,
   Y as useTheme,
   fe as useVisualViewportPin,
   ce as useWebOtp,
-  F as useZoomDrilldown
+  w as useZoomDrilldown
 };
 //# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../src/hooks/use-debounced-value.ts","../../src/hooks/use-focus-trap.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\n\n/**\n * Returns a value that lags `input` by `delayMs`. Each new `input`\n * resets the timer; the returned value updates once `input` has been\n * stable for `delayMs` ms.\n *\n * Companion to `useDebouncedCallback` — use this when you want the\n * debounced *value* (to drive a derived effect, query, or render),\n * and use the callback hook when you want the debounced *action*.\n *\n * @example\n *   const [query, setQuery] = useState('');\n *   const debouncedQuery = useDebouncedValue(query, 250);\n *   useEffect(() => { void search(debouncedQuery); }, [debouncedQuery]);\n */\nexport function useDebouncedValue<T>(input: T, delayMs: number): T {\n  const [value, setValue] = useState<T>(input);\n  const timerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n  useEffect(() => {\n    if (delayMs <= 0) {\n      // Flush any pending timer so a stale queued value can't land\n      // after the synchronous update below.\n      if (timerRef.current !== null) {\n        clearTimeout(timerRef.current);\n        timerRef.current = null;\n      }\n      setValue(input);\n      return;\n    }\n    const timer = setTimeout(() => {\n      setValue(input);\n      timerRef.current = null;\n    }, delayMs);\n    timerRef.current = timer;\n    return () => clearTimeout(timer);\n  }, [input, delayMs]);\n\n  return value;\n}\n","import { useEffect, useRef, type RefObject } from 'react';\n\n/* -------------------------------------------------------------------- */\n/* Focus trap                                                           */\n/*                                                                      */\n/* Lightweight focus-trap hook for components that compose a Radix      */\n/* primitive without the overlay primitive (Dialog, AlertDialog, Sheet) */\n/* — those handle focus trapping for free via `@radix-ui/react-dialog`. */\n/*                                                                      */\n/* This hook is intentionally NOT a Radix `<FocusScope>` re-export — it */\n/* is a hook so it composes inside `forwardRef` components without      */\n/* nesting another wrapper element. If you need the full Radix         */\n/* contract (return-focus management, loop, asChild), use               */\n/* `@radix-ui/react-focus-scope` directly.                              */\n/* -------------------------------------------------------------------- */\n\nexport interface UseFocusTrapOptions {\n  /** When `false` the trap is inert. Defaults to `true`. */\n  enabled?: boolean;\n  /**\n   * When `true`, focus initial autofocus into the first focusable\n   * descendant on mount / enable. @default true\n   */\n  autoFocus?: boolean;\n  /**\n   * When `true`, restores focus to the previously-focused element on\n   * unmount / disable. @default true\n   */\n  restoreFocus?: boolean;\n}\n\nconst FOCUSABLE_SELECTOR = [\n  'a[href]',\n  'button:not([disabled])',\n  'input:not([disabled]):not([type=\"hidden\"])',\n  'select:not([disabled])',\n  'textarea:not([disabled])',\n  '[tabindex]:not([tabindex=\"-1\"])',\n  '[contenteditable=\"true\"]',\n  'audio[controls]',\n  'video[controls]',\n].join(',');\n\nfunction getFocusable(container: HTMLElement): HTMLElement[] {\n  return Array.from(\n    container.querySelectorAll<HTMLElement>(FOCUSABLE_SELECTOR),\n  ).filter((el) => {\n    if (el.hidden) return false;\n    // `inert` and `aria-hidden=\"true\"` block focus on the element AND\n    // all its descendants — walk the chain to catch either ancestor.\n    let node: HTMLElement | null = el;\n    while (node) {\n      if (node.hasAttribute('inert')) return false;\n      if (node.getAttribute('aria-hidden') === 'true') return false;\n      node = node.parentElement;\n    }\n    return true;\n  });\n}\n\n/**\n * Constrain Tab navigation to descendants of `containerRef`. Wraps Tab\n * forward from the last focusable to the first, and Shift+Tab back from\n * the first to the last. Optionally autofocuses on enable and restores\n * focus on disable.\n *\n * Use this for inline modal patterns or focus zones that don't ship\n * with their own Radix overlay. Don't stack it inside Dialog / Sheet —\n * Radix already traps focus in those.\n *\n * @example\n *   const ref = useRef<HTMLDivElement>(null);\n *   useFocusTrap(ref, { enabled: open });\n *   return <div ref={ref}>…</div>;\n */\nexport function useFocusTrap<T extends HTMLElement>(\n  containerRef: RefObject<T | null>,\n  options: UseFocusTrapOptions = {},\n): void {\n  const { enabled = true, autoFocus = true, restoreFocus = true } = options;\n  const previouslyFocused = useRef<HTMLElement | null>(null);\n\n  useEffect(() => {\n    if (!enabled) return;\n    const container = containerRef.current;\n    if (!container) return;\n\n    previouslyFocused.current =\n      typeof document !== 'undefined' &&\n      document.activeElement instanceof HTMLElement\n        ? document.activeElement\n        : null;\n\n    if (autoFocus) {\n      const focusable = getFocusable(container);\n      // Container itself is the fallback focus target — needs `tabIndex`\n      // to receive focus, but `-1` is fine.\n      const target =\n        focusable[0] ?? (container.tabIndex >= -1 ? container : null);\n      target?.focus();\n    }\n\n    function onKeyDown(event: KeyboardEvent) {\n      if (event.key !== 'Tab') return;\n      const root = containerRef.current;\n      if (!root) return;\n      const focusable = getFocusable(root);\n      if (focusable.length === 0) {\n        event.preventDefault();\n        return;\n      }\n      const first = focusable[0];\n      const last = focusable[focusable.length - 1];\n      const active = document.activeElement;\n\n      if (event.shiftKey) {\n        if (active === first || !root.contains(active)) {\n          event.preventDefault();\n          last.focus();\n        }\n      } else {\n        if (active === last || !root.contains(active)) {\n          event.preventDefault();\n          first.focus();\n        }\n      }\n    }\n\n    container.addEventListener('keydown', onKeyDown);\n\n    return () => {\n      container.removeEventListener('keydown', onKeyDown);\n      if (restoreFocus && previouslyFocused.current) {\n        // rAF lets parent unmounts settle before refocus — a microtask\n        // fires too early and can throw on a detached node.\n        const target = previouslyFocused.current;\n        requestAnimationFrame(() => {\n          if (target.isConnected) target.focus();\n        });\n      }\n    };\n  }, [enabled, autoFocus, restoreFocus, containerRef]);\n}\n"],"names":["useDebouncedValue","input","delayMs","value","setValue","useState","timerRef","useRef","useEffect","timer","FOCUSABLE_SELECTOR","getFocusable","container","el","node","useFocusTrap","containerRef","options","enabled","autoFocus","restoreFocus","previouslyFocused","target","onKeyDown","event","root","focusable","first","last","active"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAgBO,SAASA,EAAqBC,GAAUC,GAAoB;AACjE,QAAM,CAACC,GAAOC,CAAQ,IAAIC,EAAYJ,CAAK,GACrCK,IAAWC,EAA6C,IAAI;AAElE,SAAAC,EAAU,MAAM;AACd,QAAIN,KAAW,GAAG;AAGhB,MAAII,EAAS,YAAY,SACvB,aAAaA,EAAS,OAAO,GAC7BA,EAAS,UAAU,OAErBF,EAASH,CAAK;AACd;AAAA,IACF;AACA,UAAMQ,IAAQ,WAAW,MAAM;AAC7B,MAAAL,EAASH,CAAK,GACdK,EAAS,UAAU;AAAA,IACrB,GAAGJ,CAAO;AACV,WAAAI,EAAS,UAAUG,GACZ,MAAM,aAAaA,CAAK;AAAA,EACjC,GAAG,CAACR,GAAOC,CAAO,CAAC,GAEZC;AACT;ACTA,MAAMO,IAAqB;AAAA,EACzB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,EAAE,KAAK,GAAG;AAEV,SAASC,EAAaC,GAAuC;AAC3D,SAAO,MAAM;AAAA,IACXA,EAAU,iBAA8BF,CAAkB;AAAA,EAAA,EAC1D,OAAO,CAACG,MAAO;AACf,QAAIA,EAAG,OAAQ,QAAO;AAGtB,QAAIC,IAA2BD;AAC/B,WAAOC,KAAM;AAEX,UADIA,EAAK,aAAa,OAAO,KACzBA,EAAK,aAAa,aAAa,MAAM,OAAQ,QAAO;AACxD,MAAAA,IAAOA,EAAK;AAAA,IACd;AACA,WAAO;AAAA,EACT,CAAC;AACH;AAiBO,SAASC,EACdC,GACAC,IAA+B,IACzB;AACN,QAAM,EAAE,SAAAC,IAAU,IAAM,WAAAC,IAAY,IAAM,cAAAC,IAAe,OAASH,GAC5DI,IAAoBd,EAA2B,IAAI;AAEzD,EAAAC,EAAU,MAAM;AACd,QAAI,CAACU,EAAS;AACd,UAAMN,IAAYI,EAAa;AAC/B,QAAI,CAACJ,EAAW;AAQhB,QANAS,EAAkB,UAChB,OAAO,WAAa,OACpB,SAAS,yBAAyB,cAC9B,SAAS,gBACT,MAEFF,GAAW;AAIb,YAAMG,IAHYX,EAAaC,CAAS,EAI5B,CAAC,MAAMA,EAAU,YAAY,KAAKA,IAAY;AAC1D,MAAAU,KAAA,QAAAA,EAAQ;AAAA,IACV;AAEA,aAASC,EAAUC,GAAsB;AACvC,UAAIA,EAAM,QAAQ,MAAO;AACzB,YAAMC,IAAOT,EAAa;AAC1B,UAAI,CAACS,EAAM;AACX,YAAMC,IAAYf,EAAac,CAAI;AACnC,UAAIC,EAAU,WAAW,GAAG;AAC1B,QAAAF,EAAM,eAAA;AACN;AAAA,MACF;AACA,YAAMG,IAAQD,EAAU,CAAC,GACnBE,IAAOF,EAAUA,EAAU,SAAS,CAAC,GACrCG,IAAS,SAAS;AAExB,MAAIL,EAAM,YACJK,MAAWF,KAAS,CAACF,EAAK,SAASI,CAAM,OAC3CL,EAAM,eAAA,GACNI,EAAK,MAAA,MAGHC,MAAWD,KAAQ,CAACH,EAAK,SAASI,CAAM,OAC1CL,EAAM,eAAA,GACNG,EAAM,MAAA;AAAA,IAGZ;AAEA,WAAAf,EAAU,iBAAiB,WAAWW,CAAS,GAExC,MAAM;AAEX,UADAX,EAAU,oBAAoB,WAAWW,CAAS,GAC9CH,KAAgBC,EAAkB,SAAS;AAG7C,cAAMC,IAASD,EAAkB;AACjC,8BAAsB,MAAM;AAC1B,UAAIC,EAAO,eAAaA,EAAO,MAAA;AAAA,QACjC,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF,GAAG,CAACJ,GAASC,GAAWC,GAAcJ,CAAY,CAAC;AACrD;"}
+{"version":3,"file":"index.js","sources":["../../src/hooks/use-debounced-value.ts","../../src/hooks/use-focus-trap.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\n\n/**\n * Returns a value that lags `input` by `delayMs`. Each new `input`\n * resets the timer; the returned value updates once `input` has been\n * stable for `delayMs` ms.\n *\n * Companion to `useDebouncedCallback` — use this when you want the\n * debounced *value* (to drive a derived effect, query, or render),\n * and use the callback hook when you want the debounced *action*.\n *\n * @example\n *   const [query, setQuery] = useState('');\n *   const debouncedQuery = useDebouncedValue(query, 250);\n *   useEffect(() => { void search(debouncedQuery); }, [debouncedQuery]);\n */\nexport function useDebouncedValue<T>(input: T, delayMs: number): T {\n  const [value, setValue] = useState<T>(input);\n  const timerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n  useEffect(() => {\n    if (delayMs <= 0) {\n      // Flush any pending timer so a stale queued value can't land\n      // after the synchronous update below.\n      if (timerRef.current !== null) {\n        clearTimeout(timerRef.current);\n        timerRef.current = null;\n      }\n      setValue(input);\n      return;\n    }\n    const timer = setTimeout(() => {\n      setValue(input);\n      timerRef.current = null;\n    }, delayMs);\n    timerRef.current = timer;\n    return () => clearTimeout(timer);\n  }, [input, delayMs]);\n\n  return value;\n}\n","import { useEffect, useRef, type RefObject } from 'react';\n\n/* -------------------------------------------------------------------- */\n/* Focus trap                                                           */\n/*                                                                      */\n/* Lightweight focus-trap hook for components that compose a Radix      */\n/* primitive without the overlay primitive (Dialog, AlertDialog, Sheet) */\n/* — those handle focus trapping for free via `@radix-ui/react-dialog`. */\n/*                                                                      */\n/* This hook is intentionally NOT a Radix `<FocusScope>` re-export — it */\n/* is a hook so it composes inside `forwardRef` components without      */\n/* nesting another wrapper element. If you need the full Radix         */\n/* contract (return-focus management, loop, asChild), use               */\n/* `@radix-ui/react-focus-scope` directly.                              */\n/* -------------------------------------------------------------------- */\n\nexport interface UseFocusTrapOptions {\n  /** When `false` the trap is inert. Defaults to `true`. */\n  enabled?: boolean;\n  /**\n   * When `true`, focus initial autofocus into the first focusable\n   * descendant on mount / enable. @default true\n   */\n  autoFocus?: boolean;\n  /**\n   * When `true`, restores focus to the previously-focused element on\n   * unmount / disable. @default true\n   */\n  restoreFocus?: boolean;\n}\n\nconst FOCUSABLE_SELECTOR = [\n  'a[href]',\n  'button:not([disabled])',\n  'input:not([disabled]):not([type=\"hidden\"])',\n  'select:not([disabled])',\n  'textarea:not([disabled])',\n  '[tabindex]:not([tabindex=\"-1\"])',\n  '[contenteditable=\"true\"]',\n  'audio[controls]',\n  'video[controls]',\n].join(',');\n\nfunction getFocusable(container: HTMLElement): HTMLElement[] {\n  return Array.from(\n    container.querySelectorAll<HTMLElement>(FOCUSABLE_SELECTOR),\n  ).filter((el) => {\n    if (el.hidden) return false;\n    // `inert` and `aria-hidden=\"true\"` block focus on the element AND\n    // all its descendants — walk the chain to catch either ancestor.\n    let node: HTMLElement | null = el;\n    while (node) {\n      if (node.hasAttribute('inert')) return false;\n      if (node.getAttribute('aria-hidden') === 'true') return false;\n      node = node.parentElement;\n    }\n    return true;\n  });\n}\n\n/**\n * Constrain Tab navigation to descendants of `containerRef`. Wraps Tab\n * forward from the last focusable to the first, and Shift+Tab back from\n * the first to the last. Optionally autofocuses on enable and restores\n * focus on disable.\n *\n * Use this for inline modal patterns or focus zones that don't ship\n * with their own Radix overlay. Don't stack it inside Dialog / Sheet —\n * Radix already traps focus in those.\n *\n * @example\n *   const ref = useRef<HTMLDivElement>(null);\n *   useFocusTrap(ref, { enabled: open });\n *   return <div ref={ref}>…</div>;\n */\nexport function useFocusTrap<T extends HTMLElement>(\n  containerRef: RefObject<T | null>,\n  options: UseFocusTrapOptions = {},\n): void {\n  const { enabled = true, autoFocus = true, restoreFocus = true } = options;\n  const previouslyFocused = useRef<HTMLElement | null>(null);\n\n  useEffect(() => {\n    if (!enabled) return;\n    const container = containerRef.current;\n    if (!container) return;\n\n    previouslyFocused.current =\n      typeof document !== 'undefined' &&\n      document.activeElement instanceof HTMLElement\n        ? document.activeElement\n        : null;\n\n    if (autoFocus) {\n      const focusable = getFocusable(container);\n      // Container itself is the fallback focus target — needs `tabIndex`\n      // to receive focus, but `-1` is fine.\n      const target =\n        focusable[0] ?? (container.tabIndex >= -1 ? container : null);\n      target?.focus();\n    }\n\n    function onKeyDown(event: KeyboardEvent) {\n      if (event.key !== 'Tab') return;\n      const root = containerRef.current;\n      if (!root) return;\n      const focusable = getFocusable(root);\n      if (focusable.length === 0) {\n        event.preventDefault();\n        return;\n      }\n      const first = focusable[0];\n      const last = focusable[focusable.length - 1];\n      const active = document.activeElement;\n\n      if (event.shiftKey) {\n        if (active === first || !root.contains(active)) {\n          event.preventDefault();\n          last.focus();\n        }\n      } else {\n        if (active === last || !root.contains(active)) {\n          event.preventDefault();\n          first.focus();\n        }\n      }\n    }\n\n    container.addEventListener('keydown', onKeyDown);\n\n    return () => {\n      container.removeEventListener('keydown', onKeyDown);\n      if (restoreFocus && previouslyFocused.current) {\n        // rAF lets parent unmounts settle before refocus — a microtask\n        // fires too early and can throw on a detached node.\n        const target = previouslyFocused.current;\n        requestAnimationFrame(() => {\n          if (target.isConnected) target.focus();\n        });\n      }\n    };\n  }, [enabled, autoFocus, restoreFocus, containerRef]);\n}\n"],"names":["useDebouncedValue","input","delayMs","value","setValue","useState","timerRef","useRef","useEffect","timer","FOCUSABLE_SELECTOR","getFocusable","container","el","node","useFocusTrap","containerRef","options","enabled","autoFocus","restoreFocus","previouslyFocused","target","onKeyDown","event","root","focusable","first","last","active"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAgBO,SAASA,EAAqBC,GAAUC,GAAoB;AACjE,QAAM,CAACC,GAAOC,CAAQ,IAAIC,EAAYJ,CAAK,GACrCK,IAAWC,EAA6C,IAAI;AAElE,SAAAC,EAAU,MAAM;AACd,QAAIN,KAAW,GAAG;AAGhB,MAAII,EAAS,YAAY,SACvB,aAAaA,EAAS,OAAO,GAC7BA,EAAS,UAAU,OAErBF,EAASH,CAAK;AACd;AAAA,IACF;AACA,UAAMQ,IAAQ,WAAW,MAAM;AAC7B,MAAAL,EAASH,CAAK,GACdK,EAAS,UAAU;AAAA,IACrB,GAAGJ,CAAO;AACV,WAAAI,EAAS,UAAUG,GACZ,MAAM,aAAaA,CAAK;AAAA,EACjC,GAAG,CAACR,GAAOC,CAAO,CAAC,GAEZC;AACT;ACTA,MAAMO,IAAqB;AAAA,EACzB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,EAAE,KAAK,GAAG;AAEV,SAASC,EAAaC,GAAuC;AAC3D,SAAO,MAAM;AAAA,IACXA,EAAU,iBAA8BF,CAAkB;AAAA,EAAA,EAC1D,OAAO,CAACG,MAAO;AACf,QAAIA,EAAG,OAAQ,QAAO;AAGtB,QAAIC,IAA2BD;AAC/B,WAAOC,KAAM;AAEX,UADIA,EAAK,aAAa,OAAO,KACzBA,EAAK,aAAa,aAAa,MAAM,OAAQ,QAAO;AACxD,MAAAA,IAAOA,EAAK;AAAA,IACd;AACA,WAAO;AAAA,EACT,CAAC;AACH;AAiBO,SAASC,EACdC,GACAC,IAA+B,IACzB;AACN,QAAM,EAAE,SAAAC,IAAU,IAAM,WAAAC,IAAY,IAAM,cAAAC,IAAe,OAASH,GAC5DI,IAAoBd,EAA2B,IAAI;AAEzD,EAAAC,EAAU,MAAM;AACd,QAAI,CAACU,EAAS;AACd,UAAMN,IAAYI,EAAa;AAC/B,QAAI,CAACJ,EAAW;AAQhB,QANAS,EAAkB,UAChB,OAAO,WAAa,OACpB,SAAS,yBAAyB,cAC9B,SAAS,gBACT,MAEFF,GAAW;AAIb,YAAMG,IAHYX,EAAaC,CAAS,EAI5B,CAAC,MAAMA,EAAU,YAAY,KAAKA,IAAY;AAC1D,MAAAU,KAAA,QAAAA,EAAQ;AAAA,IACV;AAEA,aAASC,EAAUC,GAAsB;AACvC,UAAIA,EAAM,QAAQ,MAAO;AACzB,YAAMC,IAAOT,EAAa;AAC1B,UAAI,CAACS,EAAM;AACX,YAAMC,IAAYf,EAAac,CAAI;AACnC,UAAIC,EAAU,WAAW,GAAG;AAC1B,QAAAF,EAAM,eAAA;AACN;AAAA,MACF;AACA,YAAMG,IAAQD,EAAU,CAAC,GACnBE,IAAOF,EAAUA,EAAU,SAAS,CAAC,GACrCG,IAAS,SAAS;AAExB,MAAIL,EAAM,YACJK,MAAWF,KAAS,CAACF,EAAK,SAASI,CAAM,OAC3CL,EAAM,eAAA,GACNI,EAAK,MAAA,MAGHC,MAAWD,KAAQ,CAACH,EAAK,SAASI,CAAM,OAC1CL,EAAM,eAAA,GACNG,EAAM,MAAA;AAAA,IAGZ;AAEA,WAAAf,EAAU,iBAAiB,WAAWW,CAAS,GAExC,MAAM;AAEX,UADAX,EAAU,oBAAoB,WAAWW,CAAS,GAC9CH,KAAgBC,EAAkB,SAAS;AAG7C,cAAMC,IAASD,EAAkB;AACjC,8BAAsB,MAAM;AAC1B,UAAIC,EAAO,eAAaA,EAAO,MAAA;AAAA,QACjC,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF,GAAG,CAACJ,GAASC,GAAWC,GAAcJ,CAAY,CAAC;AACrD;"}