@yewdiel21/motion-kit 0.10.0 → 0.15.0

package/dist/react/index.d.ts

@@ -1,15 +1,16 @@
 import * as react from 'react';
-import { useLayoutEffect, RefObject, DependencyList, ReactNode, CSSProperties, Component, ButtonHTMLAttributes, DialogHTMLAttributes, HTMLAttributes, MutableRefObject, ContextType, TextareaHTMLAttributes, MouseEvent } from 'react';
+import { useLayoutEffect, RefObject, DependencyList, ReactNode, CSSProperties, Component, ButtonHTMLAttributes, DialogHTMLAttributes, HTMLAttributes, MutableRefObject, ContextType, TextareaHTMLAttributes, MouseEvent, FormHTMLAttributes, InputHTMLAttributes, Ref, ReactElement } from 'react';
 import { I as Instance } from '../types-BkS_raL8.js';
-import { b5 as SpringCardsOptions, a3 as CurvedCarouselOptions, C as CurvedCarouselInstance, aJ as PileOptions, bk as WordsOptions, bj as WordsInstance, ak as FlowOptions, aj as FlowInstance, aL as PopOptions, aK as PopInstance, ah as FitTextOptions, ag as FitTextInstance, ba as StretchFooterOptions, aN as RadialMenuOptions, aM as RadialMenuInstance, bc as TabsOptions, bb as TabsInstance, a2 as CounterOptions, a1 as CounterInstance, aU as RevealRecipeOptions, aT as RevealInstance, aP as ReflowOptions, aO as ReflowInstance, a_ as SlotTextOptions, aZ as SlotTextInstance, b3 as SortableOptions, b1 as SortableInstance, aE as MaskTextOptions, aD as MaskTextInstance, _ as CascadeOptions, Z as CascadeInstance, be as TextRollOptions, bd as TextRollInstance, ay as LettersOptions, ax as LettersInstance, aG as ParallaxOptions, aF as ParallaxInstance, a5 as DepthGridOptions, a4 as DepthGridInstance, aq as FrameZoomOptions, ap as FrameZoomInstance, a0 as ContrastOptions, $ as ContrastInstance, aC as MarqueeOptions, aB as MarqueeInstance, Y as CardDockOptions, X as CardDockInstance, b0 as SnapStripOptions, a$ as SnapStripInstance, ad as FillTextOptions, ac as FillTextInstance, T as TicketMenuOptions, au as InfiniteReelOptions, at as InfiniteReelInstance, aS as RepelBentoOptions, aR as RepelBentoInstance, aW as RotatorOptions, aV as RotatorInstance, a9 as DragRulerOptions, a8 as DragRulerInstance, a7 as DockPillOptions, a6 as DockPillInstance, aw as JoinedCtaOptions, av as JoinedCtaInstance, as as ImageZoomOptions, ar as ImageZoomInstance, ao as FontCycleOptions, an as FontCycleInstance, bg as ThumbnailNavOptions, bf as ThumbnailNavInstance, V as ActionButtonOptions, U as ActionButtonInstance, af as FilmHeroOptions, ae as FilmHeroInstance, ab as EditorialRevealOptions, aa as EditorialRevealInstance, bi as WeightHoverOptions, bh as WeightHoverInstance, b7 as StickerOptions, b6 as StickerInstance, aY as ScrollDockOptions, aX as ScrollDockInstance, aA as LocalClockOptions, az as LocalClockInstance } from '../reduced-BmBzKH94.js';
-export { S as MK_HEAD_SCRIPT, aI as PileLayer, aQ as ReorderDetail, bq as moveItem, br as pileLayers, bs as pileStyle } from '../reduced-BmBzKH94.js';
-import { M as MenuInstance, s as DialogOptions, D as DialogInstance, z as QuantityOptions, y as PaginationOptions, v as HoverCardOptions, w as InputOtpOptions, K as StudioDockOptions, S as StudioDockInstance, O as TrailerOptions, T as TrailerInstance, n as CalendarOptions, F as SlotPickerOptions } from '../reveal-jsX-uwUz.js';
+import { b9 as SpringCardsOptions, a4 as CurvedCarouselOptions, C as CurvedCarouselInstance, aN as PileOptions, bo as WordsOptions, bn as WordsInstance, ao as FlowOptions, an as FlowInstance, aP as PopOptions, aO as PopInstance, al as FitTextOptions, ak as FitTextInstance, be as StretchFooterOptions, aR as RadialMenuOptions, aQ as RadialMenuInstance, bg as TabsOptions, bf as TabsInstance, a3 as CounterOptions, a2 as CounterInstance, aY as RevealRecipeOptions, aX as RevealInstance, aT as ReflowOptions, aS as ReflowInstance, b2 as SlotTextOptions, b1 as SlotTextInstance, b7 as SortableOptions, b5 as SortableInstance, aI as MaskTextOptions, aH as MaskTextInstance, $ as CascadeOptions, _ as CascadeInstance, bi as TextRollOptions, bh as TextRollInstance, aC as LettersOptions, aB as LettersInstance, aK as ParallaxOptions, aJ as ParallaxInstance, a6 as DepthGridOptions, a5 as DepthGridInstance, au as FrameZoomOptions, at as FrameZoomInstance, a1 as ContrastOptions, a0 as ContrastInstance, aG as MarqueeOptions, aF as MarqueeInstance, Z as CardDockOptions, Y as CardDockInstance, b4 as SnapStripOptions, b3 as SnapStripInstance, ah as FillTextOptions, ag as FillTextInstance, T as TicketMenuOptions, ay as InfiniteReelOptions, ax as InfiniteReelInstance, aW as RepelBentoOptions, aV as RepelBentoInstance, a_ as RotatorOptions, aZ as RotatorInstance, aa as DragRulerOptions, a9 as DragRulerInstance, a8 as DockPillOptions, a7 as DockPillInstance, aA as JoinedCtaOptions, az as JoinedCtaInstance, aw as ImageZoomOptions, av as ImageZoomInstance, as as FontCycleOptions, ar as FontCycleInstance, bk as ThumbnailNavOptions, bj as ThumbnailNavInstance, W as ActionButtonOptions, V as ActionButtonInstance, aj as FilmHeroOptions, ai as FilmHeroInstance, af as EditorialRevealOptions, ae as EditorialRevealInstance, bm as WeightHoverOptions, bl as WeightHoverInstance, bb as StickerOptions, ba as StickerInstance, b0 as ScrollDockOptions, a$ as ScrollDockInstance, aE as LocalClockOptions, aD as LocalClockInstance, ad as DrawerSide } from '../reduced-6X_bns60.js';
+export { U as MK_HEAD_SCRIPT, aM as PileLayer, aU as ReorderDetail, bu as moveItem, bv as pileLayers, bw as pileStyle } from '../reduced-6X_bns60.js';
+import { bX as MenuInstance, bd as DialogOptions, bb as DialogInstance, ci as QuantityOptions, c4 as PaginationOptions, bH as HoverCardOptions, bN as InputOtpOptions, d1 as StudioDockOptions, d0 as StudioDockInstance, dh as TrailerOptions, dg as TrailerInstance, as as CalendarOptions, cR as SlotPickerOptions, af as AttachmentOptions, ai as AttachmentStatus, ad as AttachmentInstance, cN as SkeletonOptions, cj as QuestionnaireAnswers, cl as QuestionnaireLabels, ck as QuestionnaireInstance, aG as CodeBlockOptions, bf as DialogVariant, aU as ContextMenuInstance, bS as LinkPreviewOptions, cf as ProgressOptions, cq as RangeSliderOptions, cr as RangeValue$2, ax as ChartOptions, aw as ChartInstance, aZ as CreditCardOptions, aX as CreditCardInstance, aR as CommandItem, aS as CommandSearchInstance, bF as HoldConfirmOptions, bL as ImagePreviewOptions, bK as ImagePreviewInstance, c0 as NotificationBellInstance, c9 as PasswordStrengthOptions, cE as ScratchCardOptions, cD as ScratchCardInstance, cZ as StarRatingOptions, aQ as ColorSliderOptions, aI as ColorAreaOptions, aL as ColorFieldOptions, aO as ColorPickerOptions, d8 as TimeFieldOptions, co as RangeCalendarOptions, a4 as DateInput, b8 as DateRangePickerOptions, df as TooltipOptions, cd as PopoverOptions, bV as LoadingButtonOptions, bW as LoadingState, am as BreadcrumbOptions, al as BreadcrumbItem, bn as EmptyStateOptions, c$ as StatCardOptions, aB as ChartTooltipOptions, b$ as MultiSelectOptions, d6 as TagInputOptions, ba as DateTimePickerOptions, bx as FilterBuilderOptions, bA as FilterGroup, dc as TimelineOptions, da as TimelineEvent, a7 as ActivityFeedOptions, a8 as ActivityItem, dk as TreeViewOptions, di as TreeNode, dj as TreeViewInstance, bs as FileExplorerOptions, bq as FileEntry, br as FileExplorerInstance, bQ as JsonViewerOptions, bP as JsonViewerInstance, dn as VirtualListOptions, dq as VirtualScrollOptions, ct as ResizablePanelOptions, cs as ResizablePanelInstance, cX as SplitViewOptions, cW as SplitViewInstance, b2 as DataRow, b5 as DataTableOptions, b4 as DataTableInstance, bi as EditableTableOptions, bh as EditableTableInstance, cz as RichTextEditorOptions, cy as RichTextEditorInstance, cJ as SelectOptions, ab as AddToCartOptions, aa as AddToCartInstance, cG as ScrollIslandOptions } from '../reveal-BfyKKsw4.js';
+export { a5 as ActivityActor, a9 as ActivityKind, a$ as DataAction, b0 as DataColumn, b3 as DataSort, bg as EditableColumn, bj as EditorKind, bp as FileChange, bv as FileView, cx as RichCommand, cA as RowChange, cB as RowId, dd as TimelineStatus } from '../reveal-BfyKKsw4.js';
 import { LiquidBlendOptions, ShaderEffectInstance, MatcapOptions, ShaderGrainOptions, ShaderBlurOptions, ParticleHeroOptions, ParticleHeroInstance } from '../gl/index.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { T as ThemeState, s as setTheme, a as setMode, I as InitThemeOptions, b as ThemeMode } from '../theme-Bjf9qIIy.js';
 export { M as MK_THEME_HEAD_SCRIPT, t as themeHeadScript } from '../theme-Bjf9qIIy.js';
-import { n as ThemePickerOptions, s as ToasterLabels, e as ChatLabels, C as ChatInstance, v as capturePending, b as ChatRole, c as NavStyle, h as CursorVariant, g as CursorOptions, i as IslandOptions, I as IslandInstance } from '../store-DYb3tTsZ.js';
-export { j as NAV_STYLES, o as ToastAction, q as ToastOptions, r as ToastTone, x as clearToasts, F as dismissToast, t as toast } from '../store-DYb3tTsZ.js';
+import { F as ThemePickerOptions, Q as ToasterLabels, b as ChatLabels, C as ChatInstance, _ as capturePending, d as ChatRole, n as NavStyle, o as NavStyleAlias, g as CursorVariant, f as CursorOptions, j as IslandOptions, I as IslandInstance, W as ToolbarOptions, V as ToolbarInstance, a as BidirectionalSliderOptions, B as BidirectionalSliderInstance, Y as VoiceDotsOptions, X as VoiceDotsInstance, s as PieChartOptions, r as PieChartInstance, u as RadarChartOptions, R as RadarChartInstance, x as RadialChartOptions, w as RadialChartInstance, z as SankeyChartOptions, S as SankeyChartInstance, h as HeatmapChartOptions, H as HeatmapChartInstance, q as OrbitMenuOptions, O as OrbitMenuInstance } from '../store-CA2Qcun_.js';
+export { N as NAV_STYLES, k as NAV_STYLE_ALIASES, G as ToastAction, K as ToastOptions, L as ToastTone, a0 as clearToasts, ag as dismissToast, am as toNavStyle, an as toast } from '../store-CA2Qcun_.js';
 import { C as CapturedLayout } from '../confetti-BSX1CLLV.js';
 export { A as ANIMATIONS, b as AnimationName, d as ConfettiOptions, e as animate, g as confetti, l as leave } from '../confetti-BSX1CLLV.js';
 import 'gsap/SplitText';
@@ -225,15 +226,15 @@ interface SurfaceRootProps extends SurfaceOptions {
     onOpenChange?: (open: boolean) => void;
     children?: ReactNode;
 }
-declare function Root$3(props: SurfaceRootProps): react_jsx_runtime.JSX.Element;
+declare function Root$6(props: SurfaceRootProps): react_jsx_runtime.JSX.Element;
 /** A button that opens the dialog and is the shape it grows from. */
-declare function Trigger$1({ onClick, children, ...props }: ButtonHTMLAttributes<HTMLButtonElement>): react_jsx_runtime.JSX.Element;
+declare function Trigger$2({ onClick, children, ...props }: ButtonHTMLAttributes<HTMLButtonElement>): react_jsx_runtime.JSX.Element;
 interface DialogContentProps extends Omit<DialogHTMLAttributes<HTMLDialogElement>, 'open'> {
     size?: 'sm' | 'md' | 'lg' | 'xl';
     /** Skip the base class (style it yourself). */
     unstyled?: boolean;
 }
-declare function Content$1({ size, unstyled, className, children, ...props }: DialogContentProps): react_jsx_runtime.JSX.Element;
+declare function Content$2({ size, unstyled, className, children, ...props }: DialogContentProps): react_jsx_runtime.JSX.Element;
 declare function Close({ children, label, ...props }: ButtonHTMLAttributes<HTMLButtonElement> & {
     label?: string;
 }): react_jsx_runtime.JSX.Element;
@@ -246,9 +247,9 @@ declare function Handle({ children, ...props }: ButtonHTMLAttributes<HTMLButtonE
  * </Dialog.Content></Dialog.Root>
  */
 declare const Dialog: {
-    Root: typeof Root$3;
-    Trigger: typeof Trigger$1;
-    Content: typeof Content$1;
+    Root: typeof Root$6;
+    Trigger: typeof Trigger$2;
+    Content: typeof Content$2;
     Header: ({ children, ...props }: HTMLAttributes<HTMLElement>) => react_jsx_runtime.JSX.Element;
     Title: ({ children, ...props }: HTMLAttributes<HTMLElement>) => react_jsx_runtime.JSX.Element;
     Description: ({ children, ...props }: HTMLAttributes<HTMLElement>) => react_jsx_runtime.JSX.Element;
@@ -271,18 +272,18 @@ interface MenuRootProps extends Omit<SurfaceRootProps, 'placement' | 'backdrop'
     closeOnSelect?: boolean;
     children?: ReactNode;
 }
-declare function Root$2({ onSelect, closeOnSelect, ticket, children, ...props }: MenuRootProps): react_jsx_runtime.JSX.Element;
-declare function Trigger({ onClick, children, ...props }: ButtonHTMLAttributes<HTMLButtonElement>): react_jsx_runtime.JSX.Element;
-declare function Content({ className, children, ...props }: Omit<DialogHTMLAttributes<HTMLDialogElement>, 'open'>): react_jsx_runtime.JSX.Element;
+declare function Root$5({ onSelect, closeOnSelect, ticket, children, ...props }: MenuRootProps): react_jsx_runtime.JSX.Element;
+declare function Trigger$1({ onClick, children, ...props }: ButtonHTMLAttributes<HTMLButtonElement>): react_jsx_runtime.JSX.Element;
+declare function Content$1({ className, children, ...props }: Omit<DialogHTMLAttributes<HTMLDialogElement>, 'open'>): react_jsx_runtime.JSX.Element;
 declare function Item({ value, children, ...props }: ButtonHTMLAttributes<HTMLButtonElement> & {
     value?: string;
 }): react_jsx_runtime.JSX.Element;
 declare function Separator(): react_jsx_runtime.JSX.Element;
 /** options menu: <Menu.Root onSelect><Menu.Trigger/><Menu.Content><Menu.Item value/>…</Menu.Content></Menu.Root>. */
 declare const Menu: {
-    Root: typeof Root$2;
-    Trigger: typeof Trigger;
-    Content: typeof Content;
+    Root: typeof Root$5;
+    Trigger: typeof Trigger$1;
+    Content: typeof Content$1;
     Item: typeof Item;
     Separator: typeof Separator;
 };
@@ -314,7 +315,7 @@ interface ChatRootProps extends HTMLAttributes<HTMLDivElement> {
     labels?: ChatLabels;
     children?: ReactNode;
 }
-declare function Root$1({ onSend, animateExisting, labels, className, children, ...props }: ChatRootProps): react_jsx_runtime.JSX.Element;
+declare function Root$4({ onSend, animateExisting, labels, className, children, ...props }: ChatRootProps): react_jsx_runtime.JSX.Element;
 interface ChatMessagesProps {
     /** Waiting for an answer: "Pensando…" shows after 500 ms and morphs into the next assistant message. */
     pending?: boolean;
@@ -358,7 +359,7 @@ declare function Confirm({ children, ...props }: HTMLAttributes<HTMLDivElement>)
  * <Chat.Message role>)}</Chat.Messages><Chat.Composer /></Chat.Root>.
  */
 declare const Chat: {
-    Root: typeof Root$1;
+    Root: typeof Root$4;
     Messages: typeof Messages;
     Message: typeof Message;
     Composer: typeof Composer;
@@ -381,7 +382,7 @@ interface NavProps extends Omit<HTMLAttributes<HTMLElement>, 'onSelect'> {
     /** Value of the current page. */
     active?: string;
     onSelect?: (value: string, event: MouseEvent<HTMLElement>) => void;
-    navStyle?: NavStyle;
+    navStyle?: NavStyle | NavStyleAlias;
     accent?: boolean;
     /** Reveal the surrounding .mk-shell from the first button on mount. */
     reveal?: boolean;
@@ -402,7 +403,7 @@ interface StepsProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange'> {
     duration?: number;
     children?: ReactNode;
 }
-declare function Root({ index, onChange, busy, duration, className, children, ...props }: StepsProps): react_jsx_runtime.JSX.Element;
+declare function Root$3({ index, onChange, busy, duration, className, children, ...props }: StepsProps): react_jsx_runtime.JSX.Element;
 declare function Step({ children, ...props }: HTMLAttributes<HTMLElement>): react_jsx_runtime.JSX.Element;
 /** The step number; the engine rolls it (React only writes the first value). */
 declare function Counter(props: HTMLAttributes<HTMLSpanElement>): react_jsx_runtime.JSX.Element;
@@ -410,7 +411,7 @@ declare function Counter(props: HTMLAttributes<HTMLSpanElement>): react_jsx_runt
  * onboarding: <Steps index={i} busy={working}><ChatBackground /><Steps.Counter />
  * <Steps.Step><h2 data-mk-flow-item>…</h2></Steps.Step>…</Steps>. Steps must be direct children.
  */
-declare const Steps: typeof Root & {
+declare const Steps: typeof Root$3 & {
     Step: typeof Step;
     Counter: typeof Counter;
 };
@@ -572,4 +573,665 @@ declare const useScrollDock: (ref: RefObject<HTMLElement | null>, options?: Scro
 
 declare const useLocalClock: (ref: RefObject<HTMLElement | null>, options?: LocalClockOptions, deps?: DependencyList) => RefObject<LocalClockInstance | null>;
 
-export { AnimatedNumber, type AnimatedNumberProps, Calendar, type CalendarProps, Chat, ChatBackground, type ChatBackgroundProps, type ChatComposerProps, type ChatMessageProps, type ChatMessagesProps, type ChatRootProps, Cursor, type CursorProps, Dialog, type DialogContentProps, FlipGroup, type FlipGroupProps, Frost, type FrostProps, HoverCard, type HoverCardProps, InputOtp, type InputOtpProps, Island, IslandDots, type IslandPanel, type IslandProps, Menu, type MenuRootProps, MkIcon, Nav, type NavItem, type NavProps, NavStyle, Pagination, type PaginationProps, Quantity, type QuantityProps, SlotPicker, type SlotPickerProps, SlotText, type SlotTextProps, Steps, type StepsProps, StudioDock, type StudioDockProps, type SurfaceRootProps, type ThemeContextValue, ThemePicker, type ThemePickerProps, ThemeProvider, type ThemeProviderProps, Toaster, type ToasterProps, Trailer, type TrailerProps, type UseStretchFooterOptions, useActionButton, useCardDock, useCascade, useChat, useContrast, useCounter, useCurvedCarousel, useDepthGrid, useDetails, useDialog, useDockPill, useDragRuler, useEditorialReveal, useFillText, useFilmHero, useFitText, useFlow, useFontCycle, useFrameZoom, useImageZoom, useInfiniteReel, useIsomorphicLayoutEffect, useJoinedCta, useLatest, useLetters, useLiquidBlend, useLocalClock, useMarquee, useMaskText, useMatcap, useParallax, useParticleHero, usePile, usePop, useRadialMenu, useRecipe, useReflow, useRepelBento, useReveal, useRotator, useScrollDock, useShaderBlur, useShaderGrain, useSlotText, useSnapStrip, useSortable, useSpringCards, useSticker, useStretchFooter, useStudioDock, useTabs, useTextRoll, useTheme, useThumbnailNav, useTicketMenu, useTrailer, useWeightHover, useWords };
+interface AttachmentUpload {
+    progress: number;
+    status?: AttachmentStatus;
+}
+interface AttachmentProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'>, AttachmentOptions {
+    /** Upload state by file id, reported by the app (from onFiles ids). */
+    uploads?: Record<string, AttachmentUpload>;
+    /** Receives the live instance (addFiles, remove, setProgress…). */
+    instanceRef?: MutableRefObject<AttachmentInstance | null>;
+}
+/**
+ * <Attachment multiple accept="image/*,.pdf" maxSize={5_000_000} onFiles={upload} uploads={progressById} />.
+ * The engine draws the chooser and cards; picked files survive rerenders and option changes.
+ */
+declare function Attachment({ accept, multiple, maxFiles, maxSize, disabled, name, initialFiles, hint, labels, onFiles, onRemove, onReject, uploads, instanceRef, className, ...props }: AttachmentProps): react_jsx_runtime.JSX.Element;
+
+interface SkeletonProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'>, SkeletonOptions {
+    /** The real content, shown when loading ends. */
+    children?: ReactNode;
+    /** Custom placeholder instead of the shape's bones. */
+    placeholder?: ReactNode;
+}
+/**
+ * <Skeleton loading={pending} shape="card" label="Cargando perfil"><ProfileCard /></Skeleton>.
+ * React owns placeholder and content; the engine only toggles hidden and the busy state.
+ */
+declare function Skeleton({ loading, animation, shape, lines, label, placeholder, children, className, ...props }: SkeletonProps): react_jsx_runtime.JSX.Element;
+
+type QuestionType = 'text' | 'textarea' | 'single' | 'multiple';
+interface QuestionOption {
+    value: string;
+    label: string;
+}
+interface Question {
+    /** Field name and answer key. */
+    id: string;
+    label: string;
+    type: QuestionType;
+    options?: Array<string | QuestionOption>;
+    required?: boolean;
+    description?: string;
+    placeholder?: string;
+}
+interface QuestionnaireProps extends Omit<FormHTMLAttributes<HTMLFormElement>, 'onChange' | 'children'> {
+    questions: Question[];
+    /** Answers the fields start with. */
+    defaultAnswers?: QuestionnaireAnswers;
+    labels?: QuestionnaireLabels & {
+        next?: string;
+        prev?: string;
+        finish?: string;
+        restart?: string;
+        step?: (index: number, count: number) => ReactNode;
+    };
+    onChange?: (index: number, answers: QuestionnaireAnswers) => void;
+    onComplete?: (answers: QuestionnaireAnswers) => void;
+    /** Shown after the last step; a function receives the answers. */
+    complete?: ReactNode | ((answers: QuestionnaireAnswers) => ReactNode);
+    instanceRef?: {
+        current: QuestionnaireInstance | null;
+    };
+}
+/**
+ * <Questionnaire questions={[{ id: 'name', label: 'Nombre', type: 'text', required: true }, …]} onComplete={save} />.
+ * Fields are native and uncontrolled, so answers survive steps and rerenders; the app owns persistence.
+ */
+declare function Questionnaire({ questions, defaultAnswers, labels, onChange, onComplete, complete, instanceRef, className, ...props }: QuestionnaireProps): react_jsx_runtime.JSX.Element;
+
+/** `onCopy` is the copy result (not the DOM clipboard event). */
+interface CodeBlockProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'title' | 'onCopy'>, Omit<CodeBlockOptions, 'code'> {
+    code: string;
+}
+/**
+ * <CodeBlock code={source} language="ts" title="main.ts" lineNumbers />.
+ * React renders the highlighted lines (text only); the engine copies the current text and owns the feedback.
+ */
+declare function CodeBlock({ code, language, title, lineNumbers, highlight, highlightLines, copyLabel, copiedLabel, errorLabel, onCopy, className, ...props }: CodeBlockProps): react_jsx_runtime.JSX.Element;
+
+interface ContextMenuProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onSelect'> {
+    /** The options: <ContextMenu.Item value="…">, <ContextMenu.Separator />. */
+    menu: ReactNode;
+    /** Accessible name of the menu. */
+    label?: string;
+    onSelect?: (value: string, item: HTMLElement) => void;
+    onOpenChange?: (open: boolean) => void;
+    closeOnSelect?: boolean;
+    overrideEditable?: boolean;
+    longPress?: number;
+    variant?: Exclude<DialogVariant, 'sheet' | 'drawer'>;
+    instanceRef?: {
+        current: ContextMenuInstance | null;
+    };
+}
+declare function Root$2({ menu, label, onSelect, onOpenChange, closeOnSelect, overrideEditable, longPress, variant, instanceRef, className, children, ...props }: ContextMenuProps): react_jsx_runtime.JSX.Element;
+/**
+ * context menu for React: the children are the area that answers a right click,
+ * Menu key, Shift+F10 or long press; `menu` holds the options.
+ * <ContextMenu menu={<><ContextMenu.Item value="rename">Renombrar</ContextMenu.Item><ContextMenu.Separator /></>} onSelect={run}>…</ContextMenu>
+ */
+declare const ContextMenu: typeof Root$2 & {
+    Item: ({ value, children, ...props }: react.ButtonHTMLAttributes<HTMLButtonElement> & {
+        value?: string;
+    }) => react_jsx_runtime.JSX.Element;
+    Separator: () => react_jsx_runtime.JSX.Element;
+};
+
+interface DrawerRootProps extends Omit<SurfaceRootProps, 'variant' | 'placement' | 'float' | 'anchor' | 'animateContent'> {
+    side?: DrawerSide;
+    children?: ReactNode;
+}
+declare function Root$1({ side, children, ...props }: DrawerRootProps): react_jsx_runtime.JSX.Element;
+/** A button that opens the drawer; focus returns to it on close. */
+declare function Trigger({ onClick, children, ...props }: ButtonHTMLAttributes<HTMLButtonElement>): react_jsx_runtime.JSX.Element;
+declare function Content({ className, children, ...props }: Omit<DialogHTMLAttributes<HTMLDialogElement>, 'open'>): react_jsx_runtime.JSX.Element;
+/**
+ * drawer for React (the Dialog parts inside):
+ * <Drawer.Root side="left"><Drawer.Trigger>Filtros</Drawer.Trigger><Drawer.Content>
+ *   <Drawer.Header><Drawer.Title>…</Drawer.Title><Drawer.Close /></Drawer.Header>
+ *   <Drawer.Body>…</Drawer.Body><Drawer.Footer>…</Drawer.Footer>
+ * </Drawer.Content></Drawer.Root>
+ */
+declare const Drawer: {
+    Root: typeof Root$1;
+    Trigger: typeof Trigger;
+    Content: typeof Content;
+    Header: ({ children, ...props }: react.HTMLAttributes<HTMLElement>) => react_jsx_runtime.JSX.Element;
+    Title: ({ children, ...props }: react.HTMLAttributes<HTMLElement>) => react_jsx_runtime.JSX.Element;
+    Description: ({ children, ...props }: react.HTMLAttributes<HTMLElement>) => react_jsx_runtime.JSX.Element;
+    Actions: ({ children, ...props }: react.HTMLAttributes<HTMLElement>) => react_jsx_runtime.JSX.Element;
+    Body: ({ children, ...props }: react.HTMLAttributes<HTMLElement>) => react_jsx_runtime.JSX.Element;
+    Footer: ({ children, ...props }: react.HTMLAttributes<HTMLElement>) => react_jsx_runtime.JSX.Element;
+    Close: ({ children, label, ...props }: ButtonHTMLAttributes<HTMLButtonElement> & {
+        label?: string;
+    }) => react_jsx_runtime.JSX.Element;
+};
+/** Open state of the surrounding <Drawer.Root>. */
+declare function useDrawer(): {
+    open: boolean;
+    setOpen: (open: boolean) => void;
+    side: DrawerSide;
+    instance: react.MutableRefObject<DialogInstance | null>;
+};
+
+interface LinkPreviewProps extends Omit<HTMLAttributes<HTMLElement>, 'title'>, LinkPreviewOptions {
+}
+/**
+ * <LinkPreview url="https://…" title="…" description="…" image="/thumb.jpg" siteName="Blog" />, or
+ * variant="hover" for a link that previews the card on pointer, focus or tap. Metadata comes from the app.
+ */
+declare function LinkPreview({ url, title, description, image, imageAlt, siteName, variant, label, target, openDelay, closeDelay, placement, onOpenChange, className, ...props }: LinkPreviewProps): react_jsx_runtime.JSX.Element;
+
+interface ProgressProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'>, ProgressOptions {
+}
+/** <Progress value={42} label="Subida" showValue />; value={null} is indeterminate. The engine owns the drawing and ARIA. */
+declare function Progress({ value, min, max, label, variant, showValue, formatValue, className, ...props }: ProgressProps): react_jsx_runtime.JSX.Element;
+
+interface RangeSliderProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'onInput' | 'defaultValue'>, RangeSliderOptions {
+    /** Uncontrolled start; an array makes an interval. */
+    defaultValue?: RangeValue$2;
+    /** Show the formatted value beside the track (default true). */
+    showOutput?: boolean;
+}
+/**
+ * <RangeSlider min={0} max={100} defaultValue={[20, 80]} label="Precio" onChange={setRange} />.
+ * Controlled with `value`; otherwise the edited value survives rerenders and new bounds.
+ */
+declare function RangeSlider({ min, max, step, value, defaultValue, disabled, name, label, formatValue, onInput, onChange, showOutput, className, ...props }: RangeSliderProps): react_jsx_runtime.JSX.Element;
+
+interface ChartProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onSelect' | 'children'>, ChartOptions {
+    instanceRef?: {
+        current: ChartInstance | null;
+    };
+}
+/**
+ * <Chart type="bar" stacked labels={weeks} series={[{ name: 'Ana', values }]} formatValue={money} label="Sesiones por semana" />.
+ * Data changes redraw in place; the selection survives when its point still exists.
+ */
+declare function Chart({ type, labels, series, points, stacked, formatValue, label, height, emptyLabel, legend, tooltip, axis, endLabel, onSelect, instanceRef, className, ...props }: ChartProps): react_jsx_runtime.JSX.Element;
+
+interface CreditCardProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'children'>, CreditCardOptions {
+    instanceRef?: MutableRefObject<CreditCardInstance | null>;
+}
+/**
+ * <CreditCard onComplete={() => setReady(true)} /> inside a <form>: the engine makes the card and the
+ * native cc-* fields; the app reads the form when it submits. Callbacks carry no card data.
+ */
+declare function CreditCard({ labels, names, tilt, onChange, onComplete, instanceRef, className, ...props }: CreditCardProps): react_jsx_runtime.JSX.Element;
+
+interface CommandSearchProps extends Omit<HTMLAttributes<HTMLSpanElement>, 'onSelect' | 'children'> {
+    items: CommandItem[];
+    placeholder?: string;
+    emptyLabel?: string;
+    label?: string;
+    shortcut?: boolean;
+    limit?: number;
+    /** The trigger's content (default: «Buscar» and the shortcut). null hides the trigger. */
+    trigger?: ReactNode;
+    onSelect?: (item: CommandItem) => void;
+    onOpenChange?: (open: boolean) => void;
+    instanceRef?: MutableRefObject<CommandSearchInstance | null>;
+}
+/** <CommandSearch items={commands} onSelect={(item) => navigate(item.id)} />: ⌘K / Ctrl+K or the trigger opens it. */
+declare function CommandSearch({ items, placeholder, emptyLabel, label, shortcut, limit, trigger, onSelect, onOpenChange, instanceRef, className, ...props }: CommandSearchProps): react_jsx_runtime.JSX.Element;
+
+interface HoldConfirmProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'children' | 'onClick'>, HoldConfirmOptions {
+    children?: ReactNode;
+}
+/**
+ * <HoldConfirm onConfirm={removeAccount}>Eliminar cuenta</HoldConfirm>: hold the button to confirm.
+ * The engine moves the label into its own span, so pass plain text or inline content.
+ */
+declare function HoldConfirm({ duration, resetAfter, holdingLabel, doneLabel, hint, disabled, onConfirm, className, children, ...props }: HoldConfirmProps): react_jsx_runtime.JSX.Element;
+
+interface PreviewImage {
+    src: string;
+    /** Smaller image for the thumbnail (default: src). */
+    thumb?: string;
+    alt: string;
+    caption?: string;
+}
+interface ImagePreviewProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange'>, ImagePreviewOptions {
+    images: PreviewImage[];
+    instanceRef?: MutableRefObject<ImagePreviewInstance | null>;
+}
+/** <ImagePreview images={[{ src, thumb, alt, caption }]} />: a grid of thumbnails that open a viewer. */
+declare function ImagePreview({ images, labels, loop, strip, onChange, onOpenChange, instanceRef, className, ...props }: ImagePreviewProps): react_jsx_runtime.JSX.Element;
+
+interface LikeButtonProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'onChange' | 'children'> {
+    /** Controlled state; without it the button keeps its own. */
+    liked?: boolean;
+    defaultLiked?: boolean;
+    count?: number;
+    label?: string;
+    hideCount?: boolean;
+    onChange?: (liked: boolean, count: number) => void;
+}
+/** <LikeButton count={128} onChange={(liked, count) => save(liked)} />. */
+declare function LikeButton({ liked, defaultLiked, count, label, hideCount, onChange, className, ...props }: LikeButtonProps): react_jsx_runtime.JSX.Element;
+
+interface NotificationBellProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'children'> {
+    /** Unread count. A higher count than before rings the bell. */
+    count?: number;
+    /** The newest message: a new value rings the bell and shows it. */
+    message?: string;
+    label?: string;
+    messageDuration?: number;
+    max?: number;
+    onOpen?: () => void;
+    instanceRef?: MutableRefObject<NotificationBellInstance | null>;
+}
+/** <NotificationBell count={unread} message={latest} onOpen={openPanel} />. */
+declare function NotificationBell({ count, message, label, messageDuration, max, onOpen, instanceRef, className, ...props }: NotificationBellProps): react_jsx_runtime.JSX.Element;
+
+interface PasswordStrengthProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'type' | 'onChange'>, Omit<PasswordStrengthOptions, 'onChange'> {
+    onStrength?: PasswordStrengthOptions['onChange'];
+    /** The text of the field as it changes. */
+    onValueChange?: (value: string) => void;
+}
+/** <PasswordStrength name="password" aria-label="Contraseña" requireScore={3} onStrength={setResult} />. The field stays uncontrolled. */
+declare function PasswordStrength({ minLength, score, requireScore, labels, onStrength, onValueChange, className, ...props }: PasswordStrengthProps): react_jsx_runtime.JSX.Element;
+
+interface ScratchCardProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'onProgress'>, ScratchCardOptions {
+    /** What the cover hides. */
+    children?: ReactNode;
+    instanceRef?: MutableRefObject<ScratchCardInstance | null>;
+}
+/** <ScratchCard onReveal={claim}><Coupon code="OTOÑO25" /></ScratchCard>. */
+declare function ScratchCard({ threshold, brush, coverLabel, revealLabel, revealedLabel, celebrate, onProgress, onReveal, instanceRef, className, children, ...props }: ScratchCardProps): react_jsx_runtime.JSX.Element;
+
+interface StarRatingProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue'>, Omit<StarRatingOptions, 'value'> {
+    /** Controlled value; without it the stars keep their own (defaultValue). */
+    value?: number;
+    defaultValue?: number;
+}
+/** <StarRating value={stars} onChange={setStars} allowClear /> or <StarRating readonly value={4.5} />. */
+declare function StarRating({ value, defaultValue, max, name, label, labels, readonly, allowClear, disabled, onChange, className, ...props }: StarRatingProps): react_jsx_runtime.JSX.Element;
+
+interface SwipeAction {
+    id: string;
+    label: string;
+    /** Glyph or icon inside the round button. */
+    icon?: ReactNode;
+    tone?: 'neutral' | 'danger' | 'accent';
+    /** The row folds away after it runs (the app then removes it). */
+    remove?: boolean;
+    /** Run by a long swipe on its side. */
+    primary?: boolean;
+}
+interface SwipeRowProps extends Omit<HTMLAttributes<HTMLLIElement>, 'children'> {
+    left?: SwipeAction[];
+    right?: SwipeAction[];
+    children?: ReactNode;
+}
+/** One row: its face (children) and the actions behind each side. */
+declare function Row({ left, right, children, ...props }: SwipeRowProps): react_jsx_runtime.JSX.Element;
+interface SwipeActionsProps extends Omit<HTMLAttributes<HTMLUListElement>, 'onChange'> {
+    fullSwipe?: number;
+    /** An action ran (a removing one after its row folded away): update your data here. */
+    onAction?: (action: string, row: HTMLElement) => void;
+    children?: ReactNode;
+}
+declare function Root({ fullSwipe, onAction, className, children, ...props }: SwipeActionsProps): react_jsx_runtime.JSX.Element;
+/**
+ * <SwipeActions onAction={(id, row) => …}><SwipeActions.Row key={mail.id} data-id={mail.id} right={[{ id: 'delete', label: 'Eliminar', remove: true, tone: 'danger' }]}>…</SwipeActions.Row></SwipeActions>
+ */
+declare const SwipeActions: typeof Root & {
+    Row: typeof Row;
+};
+
+interface ColorSliderProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onInput' | 'onChange' | 'defaultValue'>, Omit<ColorSliderOptions, 'value'> {
+    /** Controlled colour; without it the slider keeps its own (defaultValue). */
+    value?: string;
+    defaultValue?: string;
+}
+/** <ColorSlider channel="hue" value={color} onInput={setColor} />. */
+declare function ColorSlider({ value, defaultValue, channel, label, orientation, step, showValue, name, disabled, onInput, onChange, className, ...props }: ColorSliderProps): react_jsx_runtime.JSX.Element;
+
+interface ColorAreaProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onInput' | 'onChange' | 'defaultValue'>, Omit<ColorAreaOptions, 'value'> {
+    /** Controlled colour; without it the area keeps its own (defaultValue). */
+    value?: string;
+    defaultValue?: string;
+}
+/** <ColorArea value={color} onInput={setColor} />. */
+declare function ColorArea({ value, defaultValue, label, step, name, disabled, onInput, onChange, className, ...props }: ColorAreaProps): react_jsx_runtime.JSX.Element;
+
+interface ColorFieldProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue'>, Omit<ColorFieldOptions, 'value'> {
+    /** Controlled colour; without it the field keeps its own (defaultValue). */
+    value?: string;
+    defaultValue?: string;
+}
+/** <ColorField value={color} onChange={setColor} format="rgb" />. The engine creates the input. */
+declare function ColorField({ value, defaultValue, format, alpha, label, name, disabled, readOnly, onChange, className, ...props }: ColorFieldProps): react_jsx_runtime.JSX.Element;
+
+interface ColorPickerProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onInput' | 'onChange' | 'defaultValue'>, Omit<ColorPickerOptions, 'value'> {
+    /** Controlled colour; without it the picker keeps its own (defaultValue). */
+    value?: string;
+    defaultValue?: string;
+}
+/** <ColorPicker value={color} onInput={setColor} alpha /> or <ColorPicker inline … />. */
+declare function ColorPicker({ value, defaultValue, alpha, format, swatches, label, name, disabled, inline, eyedropper, onInput, onChange, className, ...props }: ColorPickerProps): react_jsx_runtime.JSX.Element;
+
+interface TimeFieldProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue'>, Omit<TimeFieldOptions, 'value'> {
+    /** Controlled time ('HH:MM', 24 h); without it the field keeps its own (defaultValue). */
+    value?: string | null;
+    defaultValue?: string | null;
+}
+/** <TimeField value={time} onChange={setTime} minuteStep={15} />. */
+declare function TimeField({ value, defaultValue, locale, hourCycle, seconds, minuteStep, min, max, label, name, disabled, readOnly, onChange, className, ...props }: TimeFieldProps): react_jsx_runtime.JSX.Element;
+
+type RangeValue$1 = {
+    start: DateInput;
+    end: DateInput;
+} | null;
+interface RangeCalendarProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue'>, Omit<RangeCalendarOptions, 'value'> {
+    /** Controlled range; without it the calendar keeps its own (defaultValue). */
+    value?: RangeValue$1;
+    defaultValue?: RangeValue$1;
+}
+/** <RangeCalendar value={range} onChange={setRange} visibleMonths={2} />. */
+declare function RangeCalendar({ value, defaultValue, month, visibleMonths, firstDay, min, max, unavailable, locale, today, labels, onChange, className, ...props }: RangeCalendarProps): react_jsx_runtime.JSX.Element;
+
+type RangeValue = {
+    start: DateInput;
+    end: DateInput;
+} | null;
+interface DateRangePickerProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue'>, Omit<DateRangePickerOptions, 'value'> {
+    /** Controlled range; without it the picker keeps its own (defaultValue). */
+    value?: RangeValue;
+    defaultValue?: RangeValue;
+}
+/** <DateRangePicker value={range} onChange={setRange} presets={[…]} />. */
+declare function DateRangePicker({ value, defaultValue, min, max, unavailable, firstDay, locale, today, label, name, presets, disabled, onChange, className, ...props }: DateRangePickerProps): react_jsx_runtime.JSX.Element;
+
+interface TooltipProps extends HTMLAttributes<HTMLSpanElement>, TooltipOptions {
+}
+/** <Tooltip content="Copiar enlace"><button>…</button></Tooltip>: the first focusable child is the trigger. */
+declare function Tooltip({ content, placement, openDelay, closeDelay, interactive, arrow, onOpenChange, className, children, ...props }: TooltipProps): react_jsx_runtime.JSX.Element;
+
+interface PopoverProps extends Omit<HTMLAttributes<HTMLDivElement>, 'content'>, PopoverOptions {
+    /** The control that opens it (a button). */
+    trigger: ReactNode;
+    /** Controlled open state (optional). */
+    open?: boolean;
+    /** Extra class for the panel. */
+    panelClassName?: string;
+}
+interface PopoverHandle {
+    open(): void;
+    close(): void;
+}
+/** <Popover trigger={<button>Filtros</button>}>…</Popover>: the panel grows out of the trigger. */
+declare const Popover: react.ForwardRefExoticComponent<PopoverProps & react.RefAttributes<PopoverHandle>>;
+
+interface LoadingButtonProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'onClick'>, Omit<LoadingButtonOptions, 'action'> {
+    /** Runs on click; its promise drives loading → success / error. */
+    action?: () => unknown;
+    /** Controlled state (optional): drive it yourself instead of `action`. */
+    state?: LoadingState;
+}
+/** <LoadingButton action={save} className="mk-button">Guardar</LoadingButton>. */
+declare function LoadingButton({ action, state, labels, compact, resetAfter, onStateChange, className, children, type, ...props }: LoadingButtonProps): react_jsx_runtime.JSX.Element;
+
+interface BreadcrumbProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'>, Omit<BreadcrumbOptions, 'items'> {
+    items: BreadcrumbItem[];
+}
+/** <Breadcrumb items={path} onNavigate={(item, i, event) => { event.preventDefault(); go(item.href) }} />. */
+declare function Breadcrumb({ items, label, maxItems, onNavigate, className, ...props }: BreadcrumbProps): react_jsx_runtime.JSX.Element;
+
+interface EmptyStateProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title' | 'children'>, EmptyStateOptions {
+}
+/** <EmptyState illustration="search" title="Sin resultados" actions={[{ id: 'clear', label: 'Borrar filtros' }]} onAction={…} />. */
+declare function EmptyState({ illustration, title, description, actions, loop, onAction, className, ...props }: EmptyStateProps): react_jsx_runtime.JSX.Element;
+
+interface StatCardProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'>, StatCardOptions {
+}
+/** <StatCard label="Ingresos" value={128400} previous={118900} format={{ style: 'currency', currency: 'MXN' }} series={week} />. */
+declare function StatCard({ label, value, previous, format, locale, positive, comparison, series, target, countOnView, className, ...props }: StatCardProps): react_jsx_runtime.JSX.Element;
+
+interface ChartTooltipProps extends HTMLAttributes<HTMLDivElement>, ChartTooltipOptions {
+}
+/**
+ * <ChartTooltip share><Chart tooltip={false} … /></ChartTooltip>, or over any chart with labels, series,
+ * inset, min and max.
+ */
+declare function ChartTooltip({ labels, series, align, inset, min, max, formatValue, delta, share, total, sort, pin, label, onIndexChange, className, children, ...props }: ChartTooltipProps): react_jsx_runtime.JSX.Element;
+
+interface MultiSelectProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue'>, MultiSelectOptions {
+    /** Controlled values; without it the field keeps its own (defaultValue). */
+    value?: string[];
+    defaultValue?: string[];
+}
+/** <MultiSelect options={people} value={chosen} onChange={setChosen} max={3} />. */
+declare function MultiSelect({ options, value, defaultValue, placeholder, label, name, max, closeOnSelect, disabled, onChange, className, ...props }: MultiSelectProps): react_jsx_runtime.JSX.Element;
+
+interface TagInputProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue'>, TagInputOptions {
+    /** Controlled tags; without it the field keeps its own (defaultValue). */
+    value?: string[];
+    defaultValue?: string[];
+}
+/** <TagInput value={tags} onChange={setTags} suggestions={known} max={8} />. */
+declare function TagInput({ value, defaultValue, suggestions, placeholder, label, name, max, restrict, allowDuplicates, validate, transform, disabled, onChange, className, ...props }: TagInputProps): react_jsx_runtime.JSX.Element;
+
+interface DateTimePickerProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue'>, Omit<DateTimePickerOptions, 'value'> {
+    /** Controlled value (Date or 'YYYY-MM-DDTHH:MM'); without it the picker keeps its own (defaultValue). */
+    value?: DateInput | null;
+    defaultValue?: DateInput | null;
+}
+/** <DateTimePicker value={when} onChange={setWhen} minuteStep={15} />. */
+declare function DateTimePicker({ value, defaultValue, min, max, locale, hourCycle, minuteStep, firstDay, unavailable, today, label, name, disabled, onChange, className, ...props }: DateTimePickerProps): react_jsx_runtime.JSX.Element;
+
+interface FilterBuilderProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue'>, FilterBuilderOptions {
+    /** Controlled filter; without it the builder keeps its own (defaultValue). */
+    value?: FilterGroup;
+    defaultValue?: FilterGroup;
+}
+/** <FilterBuilder fields={fields} value={filter} onChange={setFilter} />. */
+declare function FilterBuilder({ fields, value, defaultValue, maxDepth, label, summary, onChange, className, ...props }: FilterBuilderProps): react_jsx_runtime.JSX.Element;
+
+interface TimelineProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'>, Omit<TimelineOptions, 'events'> {
+    events: TimelineEvent[];
+}
+/**
+ * <Timeline events={history} group />. Changing `events` updates in place: an event added at either end grows in,
+ * one that changes state recolours its dot, one that goes folds away.
+ */
+declare function Timeline({ events, layout, group, relative, locale, label, className, ...props }: TimelineProps): react_jsx_runtime.JSX.Element;
+
+interface ActivityFeedProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'>, Omit<ActivityFeedOptions, 'items'> {
+    /** Initial entries; later activity goes through the handle (prepend / append). */
+    items?: ActivityItem[];
+}
+interface ActivityFeedHandle {
+    prepend(items: ActivityItem[]): void;
+    append(items: ActivityItem[]): void;
+}
+/** <ActivityFeed ref={feed} items={recent} onLoadMore={loadOlder} />, then feed.current.prepend(live). */
+declare const ActivityFeed: react.ForwardRefExoticComponent<ActivityFeedProps & react.RefAttributes<ActivityFeedHandle>>;
+
+interface TreeViewProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onSelect' | 'children' | 'draggable'>, Omit<TreeViewOptions, 'nodes'> {
+    nodes: TreeNode[];
+}
+type TreeViewHandle = Pick<TreeViewInstance, 'expand' | 'collapse' | 'expandAll' | 'collapseAll' | 'reveal' | 'filter'>;
+/** <TreeView nodes={tree} checkable checked={ids} onCheck={setIds} search />. */
+declare const TreeView: react.ForwardRefExoticComponent<TreeViewProps & react.RefAttributes<TreeViewHandle>>;
+
+interface FileExplorerProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'children'>, Omit<FileExplorerOptions, 'files'> {
+    files: FileEntry[];
+}
+type FileExplorerHandle = Pick<FileExplorerInstance, 'open' | 'up' | 'setView' | 'select' | 'createFolder' | 'rename' | 'remove' | 'move'>;
+/**
+ * <FileExplorer files={files} onChange={setFiles} onOpen={preview} />. Hand back what onChange gives (or nothing:
+ * the explorer keeps its own copy); different files from the app replace the shown ones.
+ */
+declare const FileExplorer: react.ForwardRefExoticComponent<FileExplorerProps & react.RefAttributes<FileExplorerHandle>>;
+
+interface JsonViewerProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onSelect' | 'onCopy' | 'children'>, JsonViewerOptions {
+}
+type JsonViewerHandle = Pick<JsonViewerInstance, 'expandAll' | 'collapseAll' | 'reveal' | 'filter' | 'copy'>;
+/** <JsonViewer data={response} expandDepth={2} search />. New data keeps what was open and flashes what changed. */
+declare const JsonViewer: react.ForwardRefExoticComponent<JsonViewerProps & react.RefAttributes<JsonViewerHandle>>;
+
+interface VirtualListProps<T> extends Omit<HTMLAttributes<HTMLDivElement>, 'onSelect' | 'children'>, Omit<VirtualListOptions<T>, 'items' | 'renderItem' | 'onRange'> {
+    items: T[];
+    /** A row's content; without it, its text. */
+    renderItem?: (item: T, index: number) => ReactNode;
+}
+interface VirtualListHandle {
+    scrollToIndex(index: number, options?: VirtualScrollOptions): void;
+}
+declare const VirtualList: <T>(props: VirtualListProps<T> & {
+    ref?: Ref<VirtualListHandle>;
+}) => ReactElement;
+
+interface ResizablePanelProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onResize'>, ResizablePanelOptions {
+}
+type ResizablePanelHandle = Pick<ResizablePanelInstance, 'setSizes' | 'collapse' | 'expand' | 'toggle' | 'reset'>;
+/**
+ * <ResizablePanel sizes={[25, 75]} collapsible={[0]} onResizeEnd={save}><aside /><main /></ResizablePanel>.
+ * New `sizes` glide there; adding or taking away a panel starts it again.
+ */
+declare const ResizablePanel: react.ForwardRefExoticComponent<ResizablePanelProps & react.RefAttributes<ResizablePanelHandle>>;
+
+interface SplitViewProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'children'>, SplitViewOptions {
+    /** The two areas. */
+    children: [ReactNode, ReactNode];
+}
+type SplitViewHandle = Pick<SplitViewInstance, 'setRatio' | 'collapse' | 'expand' | 'toggle'>;
+/** <SplitView ratio={0.35} stackBelow={640} labels={['Bandeja', 'Mensaje']}><List /><Detail /></SplitView>. A new `ratio` glides there. */
+declare const SplitView: react.ForwardRefExoticComponent<SplitViewProps & react.RefAttributes<SplitViewHandle>>;
+
+interface DataTableProps<T extends DataRow> extends Omit<HTMLAttributes<HTMLDivElement>, 'children'>, Omit<DataTableOptions<T>, 'rows'> {
+    rows: T[];
+}
+type DataTableHandle<T extends DataRow = DataRow> = Pick<DataTableInstance<T>, 'sortBy' | 'setPage' | 'setPageSize' | 'setQuery' | 'setFilter' | 'setColumnVisible' | 'select' | 'removeRows' | 'updateRow'>;
+declare const DataTable: <T extends DataRow>(props: DataTableProps<T> & {
+    ref?: Ref<DataTableHandle<T>>;
+}) => ReactElement;
+
+interface EditableTableProps<T extends DataRow> extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'children'>, Omit<EditableTableOptions<T>, 'rows'> {
+    rows: T[];
+}
+type EditableTableHandle<T extends DataRow = DataRow> = Pick<EditableTableInstance<T>, 'edit' | 'setValue' | 'addRow' | 'removeRows' | 'save' | 'discard'>;
+declare const EditableTable: <T extends DataRow>(props: EditableTableProps<T> & {
+    ref?: Ref<EditableTableHandle<T>>;
+}) => ReactElement;
+
+interface RichTextEditorProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'children' | 'defaultValue'>, RichTextEditorOptions {
+}
+type RichTextEditorHandle = Pick<RichTextEditorInstance, 'focus' | 'exec' | 'setValue'>;
+/**
+ * <RichTextEditor value={html} onChange={(html) => setHtml(html)} maxLength={500} />.
+ * `value` is the first content; later a different value from the app replaces it (the echo of onChange does not).
+ */
+declare const RichTextEditor: react.ForwardRefExoticComponent<RichTextEditorProps & react.RefAttributes<RichTextEditorHandle>>;
+
+interface SelectProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue'>, Omit<SelectOptions, 'value'> {
+    /** Controlled value; without it the select keeps its own (defaultValue). */
+    value?: string;
+    defaultValue?: string;
+}
+/** <Select label="Equipo" options={teams} value={team} onChange={setTeam} />. */
+declare function Select({ options, value, defaultValue, name, label, placeholder, disabled, onChange, className, ...props }: SelectProps): react_jsx_runtime.JSX.Element;
+
+interface AddToCartProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onAdd'>, AddToCartOptions {
+    instanceRef?: MutableRefObject<AddToCartInstance | null>;
+}
+/** <AddToCart target="#carrito" onAdd={setCount}><button className="mk-button">Agregar</button></AddToCart>. */
+declare function AddToCart({ target, image, quantity, count, label, onAdd, onLand, instanceRef, className, children, ...props }: AddToCartProps): react_jsx_runtime.JSX.Element;
+
+interface ScrollIslandProps extends HTMLAttributes<HTMLDivElement>, ScrollIslandOptions {
+}
+/**
+ * <ScrollIsland style={{ height: 400, overflow: 'auto' }}>…</ScrollIsland> scrolls its children with the island;
+ * <ScrollIsland page /> puts it on the page (it renders nothing of its own then).
+ */
+declare function ScrollIsland({ sections, reach, idle, page, onSection, className, children, ...props }: ScrollIslandProps): react_jsx_runtime.JSX.Element | null;
+
+interface PillButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    /** Start as the circle and spread into the pill on hover. */
+    expand?: boolean;
+    /** The icon (default: an arrow). */
+    icon?: ReactNode;
+}
+/** <PillButton onClick={ask}>Haz una pregunta</PillButton> */
+declare function PillButton({ expand, icon, className, children, type, ...props }: PillButtonProps): react_jsx_runtime.JSX.Element;
+
+interface ToolbarProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange'>, ToolbarOptions {
+    instanceRef?: MutableRefObject<ToolbarInstance | null>;
+}
+/** <Toolbar aria-label="Herramientas" value={tool} onChange={setTool}><button data-mk-tool="lapiz" aria-label="Lápiz">…</button></Toolbar> */
+declare function Toolbar({ value, orientation, tips, onChange, instanceRef, className, children, ...props }: ToolbarProps): react_jsx_runtime.JSX.Element;
+
+interface BidirectionalSliderProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'onInput'>, BidirectionalSliderOptions {
+    instanceRef?: MutableRefObject<BidirectionalSliderInstance | null>;
+}
+/** <BidirectionalSlider label="Volumen" icons="volume" value={volume} onChange={setVolume} /> */
+declare function BidirectionalSlider({ min, max, origin, step, value, disabled, name, label, icons, formatValue, onInput, onChange, instanceRef, className, ...props }: BidirectionalSliderProps): react_jsx_runtime.JSX.Element;
+
+interface VoiceDotsProps extends HTMLAttributes<HTMLDivElement>, VoiceDotsOptions {
+    /** A microphone stream or a playing <audio>/<video> to follow. */
+    source?: MediaStream | HTMLMediaElement | null;
+    /** The voice's level, 0…1 (one or one per dot), when the app measures it. */
+    level?: number | number[];
+    instanceRef?: MutableRefObject<VoiceDotsInstance | null>;
+}
+/** <VoiceDots state={listening ? 'listening' : 'idle'} source={micStream} /> */
+declare function VoiceDots({ state, count, colorful, size, labels, source, level, instanceRef, className, ...props }: VoiceDotsProps): react_jsx_runtime.JSX.Element;
+
+interface PieChartProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onSelect' | 'children'>, PieChartOptions {
+    instanceRef?: {
+        current: PieChartInstance | null;
+    };
+}
+/** <PieChart label="Ventas por canal" data={[{ label: 'Tienda', value: 420 }, …]} formatValue={money} /> */
+declare function PieChart({ data, donut, gap, size, label, totalLabel, legend, emptyLabel, formatValue, onSelect, instanceRef, className, ...props }: PieChartProps): react_jsx_runtime.JSX.Element;
+
+interface RadarChartProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onSelect' | 'children'>, RadarChartOptions {
+    instanceRef?: {
+        current: RadarChartInstance | null;
+    };
+}
+/** <RadarChart label="Perfil" axes={['Velocidad', 'Calidad', …]} series={[{ name: 'Ana', values }]} /> */
+declare function RadarChart({ axes, series, max, levels, grid, size, label, legend, emptyLabel, formatValue, onSelect, instanceRef, className, ...props }: RadarChartProps): react_jsx_runtime.JSX.Element;
+
+interface RadialChartProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onSelect' | 'children'>, RadialChartOptions {
+    instanceRef?: {
+        current: RadialChartInstance | null;
+    };
+}
+/** <RadialChart label="Metas" data={[{ label: 'Pasos', value: 7400, max: 10000 }, …]} /> */
+declare function RadialChart({ data, max, sweep, size, thickness, label, totalLabel, legend, emptyLabel, formatValue, onSelect, instanceRef, className, ...props }: RadialChartProps): react_jsx_runtime.JSX.Element;
+
+interface SankeyChartProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onSelect' | 'children'>, SankeyChartOptions {
+    instanceRef?: {
+        current: SankeyChartInstance | null;
+    };
+}
+/** <SankeyChart label="Embudo" nodes={[{ id: 'visitas' }, …]} links={[{ source: 'visitas', target: 'carrito', value: 420 }, …]} /> */
+declare function SankeyChart({ nodes, links, height, nodeWidth, nodePadding, label, emptyLabel, formatValue, onSelect, instanceRef, className, ...props }: SankeyChartProps): react_jsx_runtime.JSX.Element;
+
+interface HeatmapChartProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onSelect' | 'children'>, HeatmapChartOptions {
+    instanceRef?: {
+        current: HeatmapChartInstance | null;
+    };
+}
+declare function HeatmapChart({ data, end, weeks, firstDay, locale, levels, color, unit, label, legend, formatValue, emptyLabel, onSelect, instanceRef, className, ...props }: HeatmapChartProps): react_jsx_runtime.JSX.Element;
+
+interface OrbitMenuItem {
+    value: string;
+    label: string;
+    icon: ReactNode;
+}
+interface OrbitMenuProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onSelect' | 'onToggle'>, OrbitMenuOptions {
+    items: OrbitMenuItem[];
+    /** The middle button's name (default 'Menú'). */
+    label?: string;
+    instanceRef?: MutableRefObject<OrbitMenuInstance | null>;
+}
+/** <OrbitMenu label="Acciones" items={[{ value: 'nuevo', label: 'Nuevo', icon: <Plus /> }, …]} onSelect={run} /> */
+declare function OrbitMenu({ items, label, radius, start, closeOnSelect, onToggle, onSelect, instanceRef, className, ...props }: OrbitMenuProps): react_jsx_runtime.JSX.Element;
+
+export { ActivityFeed, type ActivityFeedHandle, type ActivityFeedProps, ActivityItem, AddToCart, type AddToCartProps, AnimatedNumber, type AnimatedNumberProps, Attachment, type AttachmentProps, type AttachmentUpload, BidirectionalSlider, type BidirectionalSliderProps, Breadcrumb, type BreadcrumbProps, Calendar, type CalendarProps, Chart, type ChartProps, ChartTooltip, type ChartTooltipProps, Chat, ChatBackground, type ChatBackgroundProps, type ChatComposerProps, type ChatMessageProps, type ChatMessagesProps, type ChatRootProps, CodeBlock, type CodeBlockProps, ColorArea, type ColorAreaProps, ColorField, type ColorFieldProps, ColorPicker, type ColorPickerProps, ColorSlider, type ColorSliderProps, CommandItem, CommandSearch, type CommandSearchProps, ContextMenu, type ContextMenuProps, CreditCard, type CreditCardProps, Cursor, type CursorProps, DataRow, DataTable, type DataTableHandle, type DataTableProps, DateRangePicker, type DateRangePickerProps, DateTimePicker, type DateTimePickerProps, Dialog, type DialogContentProps, Drawer, type DrawerRootProps, EditableTable, type EditableTableHandle, type EditableTableProps, EmptyState, type EmptyStateProps, FileEntry, FileExplorer, type FileExplorerHandle, type FileExplorerProps, FilterBuilder, type FilterBuilderProps, FlipGroup, type FlipGroupProps, Frost, type FrostProps, HeatmapChart, type HeatmapChartProps, HoldConfirm, type HoldConfirmProps, HoverCard, type HoverCardProps, ImagePreview, type ImagePreviewProps, InputOtp, type InputOtpProps, Island, IslandDots, type IslandPanel, type IslandProps, JsonViewer, type JsonViewerHandle, type JsonViewerProps, LikeButton, type LikeButtonProps, LinkPreview, type LinkPreviewProps, LoadingButton, type LoadingButtonProps, Menu, type MenuRootProps, MkIcon, MultiSelect, type MultiSelectProps, Nav, type NavItem, type NavProps, NavStyle, NavStyleAlias, NotificationBell, type NotificationBellProps, OrbitMenu, type OrbitMenuProps, Pagination, type PaginationProps, PasswordStrength, type PasswordStrengthProps, PieChart, type PieChartProps, PillButton, type PillButtonProps, Popover, type PopoverProps, type PreviewImage, Progress, type ProgressProps, Quantity, type QuantityProps, type Question, type QuestionOption, type QuestionType, Questionnaire, type QuestionnaireProps, RadarChart, type RadarChartProps, RadialChart, type RadialChartProps, RangeCalendar, type RangeCalendarProps, RangeSlider, type RangeSliderProps, ResizablePanel, type ResizablePanelHandle, type ResizablePanelProps, RichTextEditor, type RichTextEditorHandle, type RichTextEditorProps, SankeyChart, type SankeyChartProps, ScratchCard, type ScratchCardProps, ScrollIsland, type ScrollIslandProps, Select, type SelectProps, Skeleton, type SkeletonProps, SlotPicker, type SlotPickerProps, SlotText, type SlotTextProps, SplitView, type SplitViewHandle, type SplitViewProps, StarRating, type StarRatingProps, StatCard, type StatCardProps, Steps, type StepsProps, StudioDock, type StudioDockProps, type SurfaceRootProps, type SwipeAction, SwipeActions, type SwipeActionsProps, type SwipeRowProps, TagInput, type TagInputProps, type ThemeContextValue, ThemePicker, type ThemePickerProps, ThemeProvider, type ThemeProviderProps, TimeField, type TimeFieldProps, Timeline, TimelineEvent, type TimelineProps, Toaster, type ToasterProps, Toolbar, type ToolbarProps, Tooltip, type TooltipProps, Trailer, type TrailerProps, TreeNode, TreeView, type TreeViewHandle, type TreeViewProps, type UseStretchFooterOptions, VirtualList, type VirtualListHandle, type VirtualListProps, VoiceDots, type VoiceDotsProps, useActionButton, useCardDock, useCascade, useChat, useContrast, useCounter, useCurvedCarousel, useDepthGrid, useDetails, useDialog, useDockPill, useDragRuler, useDrawer, useEditorialReveal, useFillText, useFilmHero, useFitText, useFlow, useFontCycle, useFrameZoom, useImageZoom, useInfiniteReel, useIsomorphicLayoutEffect, useJoinedCta, useLatest, useLetters, useLiquidBlend, useLocalClock, useMarquee, useMaskText, useMatcap, useParallax, useParticleHero, usePile, usePop, useRadialMenu, useRecipe, useReflow, useRepelBento, useReveal, useRotator, useScrollDock, useShaderBlur, useShaderGrain, useSlotText, useSnapStrip, useSortable, useSpringCards, useSticker, useStretchFooter, useStudioDock, useTabs, useTextRoll, useTheme, useThumbnailNav, useTicketMenu, useTrailer, useWeightHover, useWords };