@alfadocs/ui-kit 1.44.0 → 1.46.0

package/dist/components/hover-card/hover-card.d.ts

@@ -65,6 +65,10 @@ export interface HoverCardContentProps extends Omit<ComponentPropsWithoutRef<typ
 export interface HoverCardHeadingProps extends HTMLAttributes<HTMLHeadingElement> {
     as?: 'h2' | 'h3' | 'h4' | 'h5' | 'h6';
 }
+export declare function useHoverCardTiming(): {
+    cancelClose: () => void;
+    closeWithDelay: () => void;
+};
 export declare const HoverCard: typeof HoverCardRoot & {
     Root: typeof HoverCardRoot;
     Trigger: import("react").ForwardRefExoticComponent<Omit<RadixPopover.PopoverTriggerProps & import("react").RefAttributes<HTMLButtonElement>, "ref"> & import("react").RefAttributes<HTMLButtonElement>>;

package/dist/components/hover-card/index.d.ts

@@ -1,4 +1,4 @@
-export { HoverCard } from './hover-card';
+export { HoverCard, useHoverCardTiming } from './hover-card';
 export type { HoverCardProps, HoverCardContentProps, HoverCardHeadingProps, HoverCardTriggerProps, HoverCardAnchorProps, HoverCardHandle, HoverCardSide, } from './hover-card';
 export { hoverCardAgent } from './hover-card.agent';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/hover-card/index.js

@@ -1,6 +1,7 @@
-import { H as e, h as o } from "../../_chunks/hover-card-BMJBVqIf.js";
+import { H as e, h as o, u as s } from "../../_chunks/hover-card-nUae8NPJ.js";
 export {
   e as HoverCard,
-  o as hoverCardAgent
+  o as hoverCardAgent,
+  s as useHoverCardTiming
 };
 //# sourceMappingURL=index.js.map

package/dist/components/icon-button-group/index.js

@@ -1,4 +1,4 @@
-import { I as t } from "../../_chunks/icon-button-group-DkkdIygu.js";
+import { I as t } from "../../_chunks/icon-button-group-DZKC6KGf.js";
 export {
   t as IconButtonGroup
 };

package/dist/components/index.d.ts

@@ -1,5 +1,5 @@
-export { usePrefersReducedMotion, useMediaQuery, useScrollToFirstError, useLocale, useTheme, resolveTheme, themeClassList, THEME_CLASS, THEME_STORAGE_KEY, ACCESSIBILITY_STORAGE_KEY, useSigningSession, useZoomDrilldown, ZOOM_DRILLDOWN_TRANSITION_CLASS, } from '../hooks';
-export type { LocaleDir, UseLocaleReturn, UseScrollToFirstErrorOptions, ThemePreference, AccessibilityPreference, ResolvedTheme, UseThemeReturn, SigningField, SigningFieldBase, UseSigningSessionReturn, UseZoomDrilldownOptions, UseZoomDrilldownReturn, } from '../hooks';
+export { usePrefersReducedMotion, useMediaQuery, useScrollToFirstError, useLocale, useTheme, resolveTheme, themeClassList, THEME_CLASS, THEME_STORAGE_KEY, ACCESSIBILITY_STORAGE_KEY, useSigningSession, useZoomDrilldown, ZOOM_DRILLDOWN_TRANSITION_CLASS, useAiSparkle, } from '../hooks';
+export type { LocaleDir, UseLocaleReturn, UseScrollToFirstErrorOptions, ThemePreference, AccessibilityPreference, ResolvedTheme, UseThemeReturn, SigningField, SigningFieldBase, UseSigningSessionReturn, UseZoomDrilldownOptions, UseZoomDrilldownReturn, AiSparkleState, UseAiSparkleOptions, UseAiSparkleReturn, } from '../hooks';
 export * from './button';
 export * from './button-group';
 export * from './floating-action-button';
@@ -117,7 +117,8 @@ export * from './tabs';
 export * from './theme-toggle';
 export * from './agenda-card';
 export * from './agenda-tray';
-export * from './ai-consent-banner';
+export * from './ai-permission-notice';
+export * from './ai-credits-notice';
 export * from './alert';
 export * from './appointment-card';
 export * from './appointment-peek';
@@ -161,6 +162,7 @@ export * from './unit-converter';
 export * from './visually-hidden';
 export * from './chart';
 export * from './ai-prompt-input';
+export * from './ai-sparkle';
 export * from './audio-recorder';
 export * from './audio-visualiser';
 export * from './chat-container';

package/dist/components/notes-panel/index.js

@@ -1,4 +1,4 @@
-import { N as a } from "../../_chunks/notes-panel-CY4KmDo-.js";
+import { N as a } from "../../_chunks/notes-panel-CHbDDMx8.js";
 export {
   a as NotesPanel
 };

package/dist/components/notes-panel/notes-panel.d.ts

@@ -169,6 +169,16 @@ export interface NotesPanelProps extends Omit<HTMLAttributes<HTMLElement>, 'titl
     onUploadImage?: RichTextEditorProps['onUploadImage'];
     /** An AI call ran out of credits. See `RichTextEditor`. */
     onAiCreditsExhausted?: RichTextEditorProps['onAiCreditsExhausted'];
+    /** Show the editor extensions affordance. See `RichTextEditor`. */
+    showExtensions?: RichTextEditorProps['showExtensions'];
+    extensions?: RichTextEditorProps['extensions'];
+    extensionContext?: RichTextEditorProps['extensionContext'];
+    onExtensionRun?: RichTextEditorProps['onExtensionRun'];
+    /**
+     * Shows the AI-credits/bundles hover card on every AI action trigger in
+     * the composer. See `RichTextEditor`.
+     */
+    aiCreditsNotice?: RichTextEditorProps['aiCreditsNotice'];
     /**
      * Rendered just above the composer — e.g. the Help-me-write templates
      * pattern's `undoNotice`. Renders in both add and edit mode, whenever the

package/dist/components/patient-details/index.js

@@ -1,4 +1,4 @@
-import { P as e, p as i } from "../../_chunks/patient-details-C8ImUrVg.js";
+import { P as e, p as i } from "../../_chunks/patient-details-DUj1htsH.js";
 export {
   e as PatientDetails,
   i as patientDetailsAgent

package/dist/components/patient-summary-card/index.js

@@ -1,4 +1,4 @@
-import { P as t, p as m } from "../../_chunks/patient-summary-card-BhmKB2KR.js";
+import { P as t, p as m } from "../../_chunks/patient-summary-card-DNzdYjxE.js";
 export {
   t as PatientSummaryCard,
   m as patientSummaryCardAgent

package/dist/components/patient-table/index.js

@@ -1,4 +1,4 @@
-import { B as s, C as l, N as n, P as t, a as C, T as i, b as o, g as T, u as p } from "../../_chunks/balance-badge-cell-o6LldMUA.js";
+import { B as s, C as l, N as n, P as t, a as C, T as i, b as o, g as T, u as p } from "../../_chunks/balance-badge-cell-YGrYdrvR.js";
 export {
   s as BalanceBadgeCell,
   l as CarePlanStatusCell,

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

@@ -0,0 +1,54 @@
+import type { ReactNode } from 'react';
+import type { TFunction } from 'i18next';
+import type { InsertPayload } from '../_shared/insert-result';
+import type { HelpMeWriteRenderContext } from './rich-text-editor';
+export type EditorExtensionContext = 'note' | 'diagnosis' | 'document' | string;
+export interface EditorExtensionRenderContext {
+    html: string;
+    text: string;
+    selectionText: HelpMeWriteRenderContext['selectionText'];
+    scope: HelpMeWriteRenderContext['scope'];
+    /** Inserts at the captured selection, then closes. Image modes require an upload seam. */
+    insert: (payload: InsertPayload) => Promise<void>;
+    close: () => void;
+    signal: AbortSignal;
+}
+export type EditorExtensionRunContext = EditorExtensionRenderContext;
+/** Outcomes contain no editor content or host error messages. */
+export type EditorExtensionRunResult = {
+    status: 'success';
+} | {
+    status: 'error';
+} | {
+    status: 'aborted';
+};
+export interface EditorExtension {
+    id: string;
+    /** Translated host label, or a kit translation key. */
+    label: string;
+    description?: string;
+    icon?: ReactNode;
+    /** Absent means everywhere. Restricted entries require a matching editor context. */
+    contexts?: EditorExtensionContext[];
+    source?: {
+        kind: 'kit' | 'marketplace';
+        appName?: string;
+        appIconUrl?: string;
+    };
+    kind: 'panel' | 'action';
+    render?: (ctx: EditorExtensionRenderContext) => ReactNode;
+    run?: (ctx: EditorExtensionRunContext) => Promise<InsertPayload | null>;
+}
+/**
+ * Resolve an extension's `label` for display.
+ *
+ * `label` is either a kit translation key or a string the host has already
+ * translated, so it has to survive the round trip untouched when it is the
+ * latter. i18next reads `:` as its namespace separator and splits any key on
+ * it unless the key also carries a space, comma, `?`, `!` or `;` — so a host
+ * label like `ICD-10:lookup` came back as `lookup`, the prefix silently eaten
+ * (caught in review on #183). `nsSeparator: false` turns that parse off, and
+ * `defaultValue` returns the label verbatim when there is no key to look up.
+ */
+export declare function resolveExtensionLabel(t: TFunction, label: string): string;
+//# sourceMappingURL=editor-extensions.d.ts.map

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

@@ -31,6 +31,7 @@ export interface EditorToolbarProps {
      * wired to a menu.
      */
     showExtensions?: boolean;
+    extensionControl?: ReactNode;
     /** Template variables for the "Insert variable" menu (hidden when empty). */
     variables?: RichTextEditorVariable[];
     /** Most-recently-used tokens, most recent first — rendered as the menu's
@@ -100,5 +101,5 @@ export interface SelectionFloatingToolbarProps {
     children?: ReactNode;
 }
 export declare function SelectionFloatingToolbar({ active, run, areaRef, getEditorRoot, suppressed, holdOpen, children, }: SelectionFloatingToolbarProps): React.JSX.Element | null;
-export declare function EditorToolbar({ run, active, preset, insertHtml, insertTable, saveSelection, restoreSelection, getSelectedText, uploadImage, enableColor, enableImage, enableTable, showExtensions, variables, recentVariableTokens, insertVariable, }: EditorToolbarProps): React.JSX.Element;
+export declare function EditorToolbar({ run, active, preset, insertHtml, insertTable, saveSelection, restoreSelection, getSelectedText, uploadImage, enableColor, enableImage, enableTable, showExtensions, extensionControl, variables, recentVariableTokens, insertVariable, }: EditorToolbarProps): React.JSX.Element;
 //# sourceMappingURL=editor-toolbar.d.ts.map

package/dist/components/rich-text-editor/help-me-write-overlay.d.ts

@@ -21,5 +21,9 @@ export interface HelpMeWriteOverlayProps {
         onFinalTranscript: (text: string) => void;
     }) => Promise<void>;
 }
+/** Shared safe failure surface for requests made from the editor dock. */
+export declare function EditorRequestError({ id }: {
+    id?: string;
+}): React.JSX.Element;
 export declare function HelpMeWriteOverlay({ open, onClose, onRequestAiDraft, onInsert, previewAsHtml, privacyNotice, onDictate, }: HelpMeWriteOverlayProps): React.JSX.Element;
 //# sourceMappingURL=help-me-write-overlay.d.ts.map

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

@@ -1,4 +1,6 @@
 export { RichTextEditor, wrapperVariants } from './rich-text-editor';
 export type { RichTextEditorHandle, RichTextEditorProps, RichTextEditorToolbar, RedactorFactory, AiConsentGate, RichTextEditorVariable, HelpMeWriteRenderContext, RichTextEditorAiTemplate, RichTextEditorAiTemplates, RichTextEditorAiActionRequest, RichTextEditorAiApplied, } from './rich-text-editor';
 export { richTextEditorAgent } from './rich-text-editor.agent';
+export type { EditorExtension, EditorExtensionContext, EditorExtensionRenderContext, EditorExtensionRunContext, EditorExtensionRunResult, } from './editor-extensions';
+export { kitEditorExtensions } from './kit-extensions';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/rich-text-editor/index.js

@@ -1,7 +1,9 @@
-import { R as a, r as e, w as i } from "../../_chunks/rich-text-editor-BYE6kK4u.js";
+import { R as i, r as o, w as a } from "../../_chunks/rich-text-editor-BwDV2XkZ.js";
+import { k as s } from "../../_chunks/kit-extensions-DuoFF1R3.js";
 export {
-  a as RichTextEditor,
-  e as richTextEditorAgent,
-  i as wrapperVariants
+  i as RichTextEditor,
+  s as kitEditorExtensions,
+  o as richTextEditorAgent,
+  a as wrapperVariants
 };
 //# sourceMappingURL=index.js.map

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

@@ -0,0 +1,4 @@
+import type { EditorExtension } from './editor-extensions';
+/** Labels are resolved by the editor's useTranslation, including live locale changes. */
+export declare const kitEditorExtensions: EditorExtension[];
+//# sourceMappingURL=kit-extensions.d.ts.map

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

@@ -1,6 +1,8 @@
 import { type ReactNode } from 'react';
 import '../../tokens/themes/bridges/redactor-theme.css';
-import { type AiConsentBannerHeadingLevel } from '../ai-consent-banner';
+import { type AiConsentBannerHeadingLevel } from '../ai-permission-notice';
+import type { EditorExtension, EditorExtensionContext, EditorExtensionRunResult } from './editor-extensions';
+import { type AiCreditsNoticeProps } from '../ai-credits-notice';
 export type RedactorFactory = (selector: string | HTMLElement, command?: unknown, ...args: unknown[]) => unknown;
 export type RichTextEditorToolbar = 'minimal' | 'standard' | 'full';
 /**
@@ -149,8 +151,11 @@ export interface RichTextEditorProps {
     ariaLabel?: string;
     /** Size variant for the minimum block-size of the editing region. */
     minHeight?: 'sm' | 'md' | 'lg' | 'fill';
-    /** Show a right-aligned editor-extensions affordance (visual placeholder). */
+    /** @deprecated Pass extensions instead. Forces the disabled placeholder for one release. */
     showExtensions?: boolean;
+    extensions?: EditorExtension[];
+    extensionContext?: EditorExtensionContext;
+    onExtensionRun?: (id: string, result: EditorExtensionRunResult) => void;
     /** Extra class names on the wrapper. */
     className?: string;
     /** Inject the Redactor factory explicitly; else `window.$R` / `window.Redactor`. */
@@ -285,6 +290,17 @@ export interface RichTextEditorProps {
      * error line shows.
      */
     onAiCreditsExhausted?: () => void;
+    /**
+     * Shows an `AiCreditsNotice` hover card on every AI action trigger — the
+     * pill's segments (dictation, templates, proofread, auto-format,
+     * Help me write), the selection bubble's AI buttons, and both mics. Omit
+     * it for today's ungated behaviour: no card, no change. Present, it
+     * replaces any tooltip a wrapped trigger would otherwise show (one
+     * floating layer per trigger, never two) and never interferes with the
+     * consent gate — the button's own click still runs the action, or opens
+     * the gate, exactly as it does without this prop.
+     */
+    aiCreditsNotice?: AiCreditsNoticeProps;
 }
 /** Block/inline formats the editor can toggle via `applyFormat`. */
 export type EditorFormat = 'bold' | 'italic' | 'strikethrough' | 'bulletedList' | 'numberedList' | 'heading' | 'quote' | 'paragraph';

package/dist/components/tasks-panel/index.js

@@ -1,4 +1,4 @@
-import { T as e, t } from "../../_chunks/tasks-panel-CpcikOeY.js";
+import { T as e, t } from "../../_chunks/tasks-panel-DncuBPIZ.js";
 export {
   e as TasksPanel,
   t as tasksPanelAgent

package/dist/components/theme-toggle/index.js

@@ -1,4 +1,4 @@
-import { T as o, t } from "../../_chunks/theme-toggle-bI0pgDDv.js";
+import { T as o, t } from "../../_chunks/theme-toggle-BP0XRGMM.js";
 export {
   o as ThemeToggle,
   t as themeToggleAgent

package/dist/components/workflow-status/index.js

@@ -1,4 +1,4 @@
-import { W as a, a as s, w as r } from "../../_chunks/workflow-status-xeaJTzD3.js";
+import { W as a, a as s, w as r } from "../../_chunks/workflow-status-CuJAOuKL.js";
 export {
   a as WorkflowStatusControl,
   s as WorkflowStatusDisplay,

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, 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.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 O } from "../_chunks/use-prefers-reduced-motion-BMwIQRjB.js";
+import { u as h } from "../_chunks/use-media-query-CcAx5SMM.js";
+import { Z as y, u as I, a as w, b as D } from "../_chunks/use-zoom-drilldown-qCX34w9I.js";
+import { u as F } from "../_chunks/use-count-up-BLLetaZ8.js";
+import { u as K } from "../_chunks/use-locale-BkCIHujH.js";
+import { A as k, T as W, a as H, r as V, 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 j } from "../_chunks/use-debounced-callback-BisrB-Fq.js";
-import { useState as b, useRef as x, useEffect as E } from "react";
+import { useState as x, useRef as E, useEffect as S } 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";
+import { u as Ee } from "../_chunks/use-countdown-Yd6ts0_a.js";
+import { u as xe } from "../_chunks/use-check-animation--I3cS00X.js";
+import { R as be, u as Ce, a as Le } from "../_chunks/use-list-reflow-Cw43nxw5.js";
+import { u as _e } from "../_chunks/use-presence-transition-cDwWUXV-.js";
+import { u as Re } from "../_chunks/use-clamp-overflow-DQE2kwZ9.js";
+import { b as ve, C as ye, a as Ie, S as we, u as De } from "../_chunks/use-ai-sparkle-Cf4yVTLB.js";
 function C(e, o) {
-  const [t, i] = b(e), u = x(null);
-  return E(() => {
+  const [t, i] = x(e), s = E(null);
+  return S(() => {
     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 A = [
   "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(A)
   ).filter((o) => {
     if (o.hidden) return !1;
     let t = o;
@@ -59,52 +60,57 @@ function p(e) {
   });
 }
 function L(e, o = {}) {
-  const { enabled: t = !0, autoFocus: i = !0, restoreFocus: u = !0 } = o, n = x(null);
-  E(() => {
+  const { enabled: t = !0, autoFocus: i = !0, restoreFocus: s = !0 } = o, n = E(null);
+  S(() => {
     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,
-  W as THEME_STORAGE_KEY,
-  D as ZOOM_DRILLDOWN_TRANSITION_CLASS,
+  k as ACCESSIBILITY_STORAGE_KEY,
+  ve as AI_SPARKLE_COMET_CLASS,
+  ye as AI_SPARKLE_COMET_TAIL,
+  Ie as AI_SPARKLE_COMET_WRAPPER_CLASS,
+  we as AI_SPARKLE_SHIMMER_CLASS,
+  be as REFLOW_ROW_CLASS,
+  W as THEME_CLASS,
+  H as THEME_STORAGE_KEY,
+  y as ZOOM_DRILLDOWN_TRANSITION_CLASS,
   ne as computePriorityLayout,
-  H as resolveTheme,
+  V as resolveTheme,
   N as themeClassList,
-  be as useCheckAnimation,
-  ve as useClampOverflow,
+  De as useAiSparkle,
+  xe as useCheckAnimation,
+  Re as useClampOverflow,
   q as useControllableState,
   G as useCopyToClipboard,
-  g as useCountUp,
-  xe as useCountdown,
+  F as useCountUp,
+  Ee as useCountdown,
   j as useDebouncedCallback,
   C as useDebouncedValue,
   Q as useDirection,
@@ -114,19 +120,19 @@ export {
   L as useFocusTrap,
   te as useIsomorphicLayoutEffect,
   Le as useListReflow,
-  k as useLocale,
-  y as useMediaQuery,
+  K as useLocale,
+  h as useMediaQuery,
   oe as useOverflowCollapse,
   $ as usePersistentState,
-  h as usePrefersReducedMotion,
-  Oe as usePresenceTransition,
+  O as usePrefersReducedMotion,
+  _e as usePresenceTransition,
   ae as usePriorityOverflow,
-  ue as useScrollOverflow,
-  R as useScrollToFirstError,
-  _ as useSigningSession,
+  se as useScrollOverflow,
+  I as useScrollToFirstError,
+  w as useSigningSession,
   Y as useTheme,
   fe as useVisualViewportPin,
   ce as useWebOtp,
-  F as useZoomDrilldown
+  D as useZoomDrilldown
 };
 //# sourceMappingURL=index.js.map

package/dist/hooks/use-ai-sparkle.d.ts

@@ -0,0 +1,91 @@
+/** Where the sparkle is: on first show, while an action runs, as it lands. */
+export type AiSparkleState = 'intro' | 'working' | 'landed';
+export declare const SHIMMER_CLASS: Record<AiSparkleState, string>;
+export declare const COMET_CLASS: Record<AiSparkleState, string>;
+export declare const COMET_WRAPPER_CLASS = "ds:pointer-events-none ds:absolute ds:[inset-block-start:0] ds:[inset-inline-start:0] ds:opacity-0 ds:[offset-path:inset(0_round_var(--radius-full))] ds:[offset-rotate:0deg]";
+export declare const COMET_TAIL: readonly [{
+    readonly key: 1;
+    readonly lag: "ds:[animation-delay:calc(var(--animation-duration)*0.2)]";
+    readonly dot: "ds:size-2.5 ds:opacity-[var(--opacity-90)]";
+}, {
+    readonly key: 2;
+    readonly lag: "ds:[animation-delay:calc(var(--animation-duration)*0.4)]";
+    readonly dot: "ds:size-2 ds:opacity-[var(--opacity-70)]";
+}, {
+    readonly key: 3;
+    readonly lag: "ds:[animation-delay:calc(var(--animation-duration)*0.6)]";
+    readonly dot: "ds:size-2 ds:opacity-[var(--opacity-50)]";
+}, {
+    readonly key: 4;
+    readonly lag: "ds:[animation-delay:calc(var(--animation-duration)*0.8)]";
+    readonly dot: "ds:size-1.5 ds:opacity-[var(--opacity-30)]";
+}, {
+    readonly key: 5;
+    readonly lag: "ds:[animation-delay:calc(var(--animation-duration)*1)]";
+    readonly dot: "ds:size-1.5 ds:opacity-[var(--opacity-20)]";
+}, {
+    readonly key: 6;
+    readonly lag: "ds:[animation-delay:calc(var(--animation-duration)*1.2)]";
+    readonly dot: "ds:size-1 ds:opacity-[var(--opacity-10)]";
+}];
+export interface UseAiSparkleOptions {
+    /**
+     * Whether the sparkle is available at all. Read once, at mount, to seed
+     * the initial `'intro'` phase — matches how the RichTextEditor's
+     * `aiSparkle` prop only ever gated the very first render. Default `true`.
+     */
+    enabled?: boolean;
+    /**
+     * `'auto'` (default) reads `prefers-reduced-motion` via
+     * `usePrefersReducedMotion`. `'off'` forces full motion regardless of the
+     * OS preference — useful for a story that wants to show the animated
+     * states side by side with a reduced one.
+     */
+    reducedMotion?: 'auto' | 'off';
+}
+export interface UseAiSparkleProps {
+    /** Spread (or picked) onto the host element as a pure styling hook. */
+    'data-ai-sparkle': AiSparkleState | undefined;
+    /**
+     * The shimmer animation class for the current state — empty when at rest.
+     * Layer it over the host's own base positioning classes; the comet layer
+     * needs real DOM and lives in the `AiSparkle` component instead.
+     */
+    className: string;
+}
+export interface UseAiSparkleReturn {
+    /** `null` at rest — nothing to render for the comet layer either. */
+    state: AiSparkleState | null;
+    props: UseAiSparkleProps;
+    /** An AI action started: swap to the looping `'working'` phase. */
+    start: () => void;
+    /** An action's result landed: swap to the one-off `'landed'` phase. */
+    land: () => void;
+    /**
+     * Settle after an action ends. Clears back to rest only when still
+     * `'working'` (the action errored or was cancelled before `land()`);
+     * leaves `'landed'` alone so the one-off animation gets to play out.
+     */
+    reset: () => void;
+}
+/**
+ * Drives the AI-pill sparkle: lit on first show, looping while an action
+ * runs, and a one-off flourish as the result lands.
+ *
+ * The hook owns the state machine and the timing only — it paints nothing.
+ * `props['data-ai-sparkle']` is a plain styling hook for the host element;
+ * `props.className` carries the shimmer layer's animation class from the
+ * same lookup table the RichTextEditor's pill originally inlined. The
+ * comet layer needs actual DOM (a head and a tail of dots), so it lives in
+ * the sibling `AiSparkle` component, keyed off the same `state`.
+ *
+ * Both `intro` and `landed` are one-off: this hook clears them back to
+ * `null` on a timer sized to the comet's lap plus a small buffer, at the
+ * default 200ms `--animation-duration`. Under reduced
+ * motion (`prefers-reduced-motion` or `reducedMotion: 'auto'`'s system
+ * read) the CSS animations already collapse to 0ms, so the clear fires at
+ * the next tick instead of waiting out the full lap — the pill still gets
+ * its `data-ai-sparkle` attribute for a moment, but nothing visibly moves.
+ */
+export declare function useAiSparkle(options?: UseAiSparkleOptions): UseAiSparkleReturn;
+//# sourceMappingURL=use-ai-sparkle.d.ts.map

package/dist/host-compat.css

@@ -87,8 +87,8 @@
 .ds\:\[--carousel-item-inline-size\:28rem\] {
   --carousel-item-inline-size:448px;
 }
-.ds\:\[--inc1-nav-block-size\:3\.5rem\] {
-  --inc1-nav-block-size:56px;
+.ds\:\[--inc1-nav-block-size\:2\.5rem\] {
+  --inc1-nav-block-size:40px;
 }
 .ds\:\[--map-block-size\:14rem\] {
   --map-block-size:224px;