@groupteknology/vuno 2.0.0 → 3.0.0

package/dist/runtime/app/theme/shared.js

@@ -18,7 +18,8 @@ export const radiusByStep = (...slots) => {
     "2xl": step("rounded-2xl"),
     "3xl": step("rounded-3xl"),
     "4xl": step("rounded-4xl"),
-    full: step("rounded-full")
+    full: step("rounded-full"),
+    none: step("rounded-none")
   };
 };
 export const skipLink = "sr-only rounded-sm bg-vuno-surface text-vuno-body focus:not-sr-only focus:outline-vuno-primary focus:z-10 focus:inline-block focus:px-3 focus:py-1.5 focus:text-sm focus:outline-2 focus:outline-offset-2";

package/dist/runtime/app/types/app.d.ts

@@ -47,8 +47,10 @@ export type VunoNotifyRequest = {
     title: string;
 };
 export interface VunoContext {
-    notifications: VunoNotification[];
-    overlays: VunoOverlayEntry[];
+    /** Estado observable de los avisos; solo `notify` y `dismiss` lo modifican. */
+    readonly notifications: readonly Readonly<VunoNotification>[];
+    /** Estado observable de las capas; solo las operaciones del contexto lo modifican. */
+    readonly overlays: readonly Readonly<VunoOverlayEntry>[];
     /**
      * Informa de algo y espera a que se den por enterados.
      *

package/dist/runtime/app/types/base.d.ts

@@ -32,39 +32,21 @@ export type VunoColor = 'error' | 'info' | 'neutral' | 'primary' | 'secondary' |
  * Los ocho escalones son los que Tailwind publica de `rounded-xs` a
  * `rounded-4xl`; Vuno no mantiene una escala paralela ni tokens propios.
  *
- * `full` no es un escalón sino una forma: no se deriva de nada y sirve para el
- * círculo y la píldora. Por eso está aquí y no en la escala.
+ * `none` elimina la curvatura. `full` no es un escalón sino una forma: no se
+ * deriva de nada y sirve para el círculo y la píldora.
  */
-export type VunoRadius = '2xl' | '3xl' | '4xl' | 'full' | 'lg' | 'md' | 'sm' | 'xl' | 'xs';
-/**
- * El nivel de un encabezado, del 1 al 6.
- *
- * Existe porque **un componente que pinta un título no siempre es la página**.
- * `VPage` pinta un `<h1>`, que es lo correcto cuando ocupa la pantalla y lo
- * incorrecto en cuanto va embebido dentro de otra cosa: ahí aparecen dos `h1`
- * y, peor, un salto de nivel en lo que venga debajo. Se vio en el catálogo, que
- * monta varias instancias dentro de una página que ya tiene el suyo, y el
- * recorrido por encabezados salía `h1 → h2 → h1 → h3`.
- *
- * No se deriva del sitio ni se adivina: lo dice quien monta el componente,
- * porque es el único que sabe qué hay por encima.
- */
-export type VunoHeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
-/** Ancho del diálogo; `full` ocupa todo el viewport en ambas dimensiones. */
-export type VunoModalSize = '2xl' | '3xl' | '4xl' | 'full' | 'lg' | 'md' | 'sm' | 'xl';
+export type VunoRadius = '2xl' | '3xl' | '4xl' | 'full' | 'lg' | 'md' | 'none' | 'sm' | 'xl' | 'xs';
 /** Ubicación preferida de algo flotante respecto a su disparador. */
 export type VunoPlacement = 'bottom' | 'bottom-end' | 'bottom-start' | 'left' | 'left-end' | 'left-start' | 'right' | 'right-end' | 'right-start' | 'top' | 'top-end' | 'top-start';
 /** Selector donde montar una capa flotante, o `true` para usar `body`. */
 export type VunoPortalTarget = string | true;
 /**
- * La escala de tamaño, común a todo lo que tiene tamaño.
+ * La escala completa de tamaño que los componentes pueden seleccionar.
  *
  * Se llamaba `VunoFieldSize` y de los diecisiete ficheros que la usaban, cinco
  * no tenían nada que ver con un formulario.
  */
-export type VunoSize = 'lg' | 'md' | 'sm' | 'xl' | 'xs';
-/** Ancho de un panel lateral. La posición se declara por separado. */
-export type VunoSlideoverSize = 'lg' | 'md' | 'sm' | 'xl';
+export type VunoSize = '2xl' | '3xl' | '4xl' | '5xl' | '6xl' | '7xl' | '8xl' | 'full' | 'lg' | 'md' | 'sm' | 'xl' | 'xs';
 /**
  * El mapa de clases por slot: lo que acepta la prop `ui` de cualquier
  * componente y lo que guarda cada clave del tema.

package/dist/runtime/app/types/field.d.ts

@@ -31,6 +31,8 @@ type VunoFieldControlThemeKey = {
 type VunoFieldThemeKey<TType extends VunoFieldType> = TType extends VunoFieldInputType ? 'fieldInput' : `field${Capitalize<TType>}`;
 type VunoFieldUiKey<TType extends VunoFieldType> = VunoFieldControlThemeKey[TType] | VunoFieldThemeKey<TType>;
 export type VunoFieldColumns = VunoResponsiveColumns | VunoResponsiveColumnSpan;
+/** Escala de los controles de formulario, derivada de la escala global. */
+export type VunoFieldSize = Extract<VunoSize, 'lg' | 'md' | 'sm' | 'xl' | 'xs'>;
 /** Posición de la etiqueta respecto al control. */
 export type VunoFieldOrientation = 'horizontal' | 'vertical';
 /** Dirección interna de controles que también tienen una disposición propia. */
@@ -63,7 +65,7 @@ export type VunoFieldBase<TType extends VunoFieldType = VunoFieldType> = {
     /** Etiqueta arriba por defecto, o al costado del control. */
     orientation?: VunoFieldOrientation;
     required?: boolean;
-    size?: VunoSize;
+    size?: VunoFieldSize;
     ui?: VunoUi<VunoFieldUiKey<TType>>;
 };
 /**

package/dist/runtime/app/types/form.d.ts

@@ -1,6 +1,5 @@
 import type { ComputedRef } from 'vue';
-import type { VunoSize } from './base.js';
-import type { VunoField, VunoFieldColumns } from './field.js';
+import type { VunoField, VunoFieldColumns, VunoFieldSize } from './field.js';
 /** Cómo se disponen las secciones del formulario. */
 export type VunoFormLayout = 'sections' | 'tabs';
 export type VunoFormSection = {
@@ -21,7 +20,7 @@ export type VunoFormDefinition = {
     layout?: VunoFormLayout;
     sections: VunoFormSection[];
     /** Tamaño aplicado a los campos que no declaran el suyo. */
-    size?: VunoSize;
+    size?: VunoFieldSize;
 };
 export type VunoFormState = Record<string, unknown>;
 /** Un segmento de ruta admitido por el contrato Standard Schema. */
@@ -53,7 +52,7 @@ export type VunoSchema<TValue = unknown> = {
 export interface VunoFormContext<TState extends VunoFormState = VunoFormState> {
     dirty: ComputedRef<boolean>;
     initialState: TState;
-    size: ComputedRef<undefined | VunoSize>;
+    size: ComputedRef<undefined | VunoFieldSize>;
     touched: Record<string, boolean>;
     /** El error de un campo, solo cuando toca enseñarlo. */
     errorFor(name: string): string | undefined;

package/dist/runtime/app/types/index.d.ts

@@ -1,16 +1,64 @@
-export type { VunoAlertProps } from './alert.js';
+export type * from '#vuno/components/Alert/Alert.types';
+export type * from '#vuno/components/App/App.types';
+export type * from '#vuno/components/Avatar/Avatar.types';
+export type * from '#vuno/components/Badge/Badge.types';
+export type * from '#vuno/components/Breadcrumb/Breadcrumb.types';
+export type * from '#vuno/components/Button/Button.types';
+export type * from '#vuno/components/Card/Card.types';
+export type * from '#vuno/components/Code/Code.types';
+export type * from '#vuno/components/Collapsible/Collapsible.types';
+export type * from '#vuno/components/ColorModeButton/ColorModeButton.types';
+export type * from '#vuno/components/Confirm/Confirm.types';
+export type * from '#vuno/components/Container/Container.types';
+export type * from '#vuno/components/ControlGroup/ControlGroup.types';
+export type * from '#vuno/components/DataTable/DataTable.types';
+export type * from '#vuno/components/FieldArray/FieldArray.types';
+export type * from '#vuno/components/FieldCheckbox/FieldCheckbox.types';
+export type * from '#vuno/components/FieldColor/FieldColor.types';
+export type * from '#vuno/components/FieldCurrency/FieldCurrency.types';
+export type * from '#vuno/components/FieldFile/FieldFile.types';
+export type * from '#vuno/components/FieldInput/FieldInput.types';
+export type * from '#vuno/components/FieldNumber/FieldNumber.types';
+export type * from '#vuno/components/FieldPassword/FieldPassword.types';
+export type * from '#vuno/components/FieldRadio/FieldRadio.types';
+export type * from '#vuno/components/FieldSearch/FieldSearch.types';
+export type * from '#vuno/components/FieldSelect/FieldSelect.types';
+export type * from '#vuno/components/FieldSlug/FieldSlug.types';
+export type * from '#vuno/components/FieldSwitch/FieldSwitch.types';
+export type * from '#vuno/components/FieldTags/FieldTags.types';
+export type * from '#vuno/components/FieldTextarea/FieldTextarea.types';
+export type * from '#vuno/components/Form/Form.types';
+export type * from '#vuno/components/FormField/FormField.types';
+export type * from '#vuno/components/FormModal/FormModal.types';
+export type * from '#vuno/components/FormSection/FormSection.types';
+export type * from '#vuno/components/Icon/Icon.types';
+export type * from '#vuno/components/Menu/Menu.types';
+export type * from '#vuno/components/Modal/Modal.types';
+export type * from '#vuno/components/Navbar/Navbar.types';
+export type * from '#vuno/components/NavigationList/NavigationList.types';
+export type * from '#vuno/components/NavigationMenu/NavigationMenu.types';
+export type * from '#vuno/components/NavigationToc/NavigationToc.types';
+export type * from '#vuno/components/Pagination/Pagination.types';
+export type * from '#vuno/components/Slideover/Slideover.types';
+export type * from '#vuno/components/State/State.types';
+export type * from '#vuno/components/Table/Table.types';
+export type * from '#vuno/components/Tabs/Tabs.types';
+export type * from '#vuno/components/Text/Text.types';
+export type * from '#vuno/components/Toolbar/Toolbar.types';
+export type * from '#vuno/components/Tooltip/Tooltip.types';
 export type { VunoAlertRequest, VunoConfirmRequest, VunoContext, VunoNotification, VunoNotificationColor, VunoNotifyRequest, VunoOverlayEntry } from './app.js';
 export * from './app-config.js';
-export type { VunoColor, VunoHeadingLevel, VunoModalSize, VunoPlacement, VunoPortalTarget, VunoRadius, VunoSize, VunoSlideoverSize, VunoSlots } from './base.js';
+export type { VunoColor, VunoPlacement, VunoPortalTarget, VunoRadius, VunoSize, VunoSlots } from './base.js';
 export type { VunoConfirmOptions } from './confirm.js';
 export type { VunoCrud, VunoCrudMessages, VunoCrudOptions, VunoCrudPage } from './crud.js';
-export type { VunoControlOrientation, VunoField, VunoFieldArray, VunoFieldBase, VunoFieldByType, VunoFieldCheckbox, VunoFieldColor, VunoFieldColumns, VunoFieldCurrency, VunoFieldDate, VunoFieldEmail, VunoFieldFile, VunoFieldInput, VunoFieldNumber, VunoFieldOf, VunoFieldOption, VunoFieldOptionValue, VunoFieldOrientation, VunoFieldPassword, VunoFieldPhone, VunoFieldRadio, VunoFieldSearch, VunoFieldSelect, VunoFieldSlug, VunoFieldSwitch, VunoFieldTags, VunoFieldText, VunoFieldTextarea, VunoFieldUrl } from './field.js';
+export type { VunoControlOrientation, VunoField, VunoFieldArray, VunoFieldBase, VunoFieldByType, VunoFieldCheckbox, VunoFieldColor, VunoFieldColumns, VunoFieldCurrency, VunoFieldDate, VunoFieldEmail, VunoFieldFile, VunoFieldInput, VunoFieldNumber, VunoFieldOf, VunoFieldOption, VunoFieldOptionValue, VunoFieldOrientation, VunoFieldPassword, VunoFieldPhone, VunoFieldRadio, VunoFieldSearch, VunoFieldSelect, VunoFieldSize, VunoFieldSlug, VunoFieldSwitch, VunoFieldTags, VunoFieldText, VunoFieldTextarea, VunoFieldUrl } from './field.js';
 export type { VunoFieldInputType, VunoFieldType } from './field-type.js';
 export type { VunoFormContext, VunoFormDefinition, VunoFormLayout, VunoFormSection, VunoFormState, VunoSchema, VunoSchemaIssue, VunoSchemaPathSegment, VunoSchemaResult } from './form.js';
-export type { VunoBreadcrumbItem, VunoContainerSize, VunoNavigationItem, VunoNavigationTocItem, VunoTabItem } from './page.js';
+export type { VunoMenuAction, VunoMenuItem, VunoMenuSubmenu } from './menu.js';
+export type { VunoBreadcrumbItem, VunoNavigationItem, VunoNavigationTocItem, VunoTabItem, VunoTabsVariant } from './page.js';
 export type { VunoResponsiveColumns, VunoResponsiveColumnSpan } from './responsive.js';
 export type { VunoShortcut, VunoShortcutHandler, VunoShortcuts, VunoShortcutsOptions } from './shortcuts.js';
 export type { VunoResolvedSlots, VunoSlotOf, VunoUi, VunoVariantOf, VunoVariantsOf } from './slots.js';
-export type { VunoStateEmptyProps, VunoStateFailureProps, VunoStateProps } from './state.js';
-export type { VunoTableAction, VunoTableAlign, VunoTableBadgeMap, VunoTableCellColumn, VunoTableCellProps, VunoTableCellType, VunoTableColumn, VunoTableColumnActions, VunoTableColumnBadge, VunoTableColumnBase, VunoTableColumnBoolean, VunoTableColumnCurrency, VunoTableColumnCustom, VunoTableColumnDate, VunoTableColumnImage, VunoTableColumnNumber, VunoTableColumnOf, VunoTableColumnText, VunoTableColumnType, VunoTableDefinition, VunoTableEmpty, VunoTableFailure, VunoTableFilters, VunoTableQuery, VunoTableQueryOptions, VunoTableRow, VunoTableSort, VunoTableSortDirection } from './table.js';
-export type { VunoAppConfig, VunoIcons, VunoMessages, VunoThemeCompoundVariant, VunoThemeConfig, VunoThemeEntry, VunoThemeKey, VunoThemeVariants } from './theme.js';
+export type { VunoDataTableDefinition, VunoTableAction, VunoTableAlign, VunoTableBadgeMap, VunoTableCellColumn, VunoTableCellProps, VunoTableCellType, VunoTableColumn, VunoTableColumnActions, VunoTableColumnBadge, VunoTableColumnBase, VunoTableColumnBoolean, VunoTableColumnCurrency, VunoTableColumnCustom, VunoTableColumnDate, VunoTableColumnImage, VunoTableColumnNumber, VunoTableColumnOf, VunoTableColumnText, VunoTableColumnType, VunoTableDefinition, VunoTableDensity, VunoTableEmpty, VunoTableFailure, VunoTableFilters, VunoTableQuery, VunoTableQueryOptions, VunoTableRow, VunoTableSort, VunoTableSortDirection, VunoTableSticky } from './table.js';
+export type { VunoTextTag, VunoTextTone, VunoTextVariant } from './text.js';
+export type { VunoAppConfig, VunoComponentsConfig, VunoIcons, VunoMessages, VunoThemeCompoundVariant, VunoThemeConfig, VunoThemeEntry, VunoThemeKey, VunoThemeVariants } from './theme.js';

package/dist/runtime/app/types/menu.d.ts

@@ -0,0 +1,22 @@
+import type { VunoColor } from './base.js';
+type VunoMenuItemBase = {
+    color?: VunoColor;
+    disabled?: boolean;
+    icon?: string;
+    label: string;
+    /** Dibuja una línea encima, para separar grupos de opciones. */
+    separator?: boolean;
+};
+/** Una acción final: ejecuta su callback y cierra toda la cascada. */
+export type VunoMenuAction = VunoMenuItemBase & {
+    onSelect: () => void;
+    children?: never;
+};
+/** Una rama: abre otro nivel y no ejecuta una acción propia. */
+export type VunoMenuSubmenu = VunoMenuItemBase & {
+    onSelect?: never;
+    children: VunoMenuItem[];
+};
+/** Una entrada puede ser una acción final o una rama con más entradas. */
+export type VunoMenuItem = VunoMenuAction | VunoMenuSubmenu;
+export {};

package/dist/runtime/app/types/page.d.ts

@@ -1,8 +1,8 @@
 import type { VunoColor } from './base.js';
-/** Elemento de la miga de pan; se corresponde con el de Nuxt UI. */
+/** Segmento que `VBreadcrumb` muestra dentro de una ruta de navegación. */
 export type VunoBreadcrumbItem = {
     icon?: string;
-    label?: string;
+    label: string;
     to?: string;
 };
 /**
@@ -49,13 +49,9 @@ export type VunoTabItem = {
     };
     icon?: string;
     label: string;
+    /** Destino opcional. Con `to`, la pestaña navega y su estado activo sigue la ruta actual. */
+    to?: string;
     value: string;
 };
-/**
- * El ancho máximo de un contenedor, con la escala de Tailwind.
- *
- * `full` no es «sin contenedor»: es sin tope de ancho pero con el relleno
- * lateral, que es lo que se quiere en una pantalla que ocupa todo y aun así no
- * debe pegar el texto al borde.
- */
-export type VunoContainerSize = '2xl' | '3xl' | '4xl' | '5xl' | '6xl' | '7xl' | '8xl' | 'full' | 'lg' | 'md' | 'sm' | 'xl';
+/** Apariencia de la barra de pestañas. */
+export type VunoTabsVariant = 'segmented' | 'underline';

package/dist/runtime/app/types/slots.d.ts

@@ -20,11 +20,15 @@ export type VunoSlotOf<TKey extends VunoThemeKey> = TKey extends VunoThemeKey ?
 /** Override `ui` de una clave concreta, con autocompletado y rechazo de errores tipográficos. */
 export type VunoUi<TKey extends VunoThemeKey> = VunoSlots<[VunoSlotOf<TKey>] extends [never] ? string : VunoSlotOf<TKey>>;
 /** Las dimensiones de variante que una clave admite. */
-export type VunoVariantOf<TKey extends VunoThemeKey> = DefaultTheme[TKey] extends {
+export type VunoVariantOf<TKey extends VunoThemeKey> = TKey extends VunoThemeKey ? (DefaultTheme[TKey] extends {
     variants: infer TVariants;
-} ? Extract<keyof TVariants, string> : string;
-/** Las variantes activas de una clave, con el valor elegido. */
-export type VunoVariantsOf<TKey extends VunoThemeKey> = Partial<Record<VunoVariantOf<TKey>, string | undefined>>;
+} ? Extract<keyof TVariants, string> : never) : never;
+/** Las variantes activas de una clave, con sus valores literales válidos. */
+export type VunoVariantsOf<TKey extends VunoThemeKey> = TKey extends VunoThemeKey ? (DefaultTheme[TKey] extends {
+    variants: infer TVariants extends Record<string, Record<string, unknown>>;
+} ? {
+    [TDimension in keyof TVariants]?: Extract<keyof TVariants[TDimension], string> | undefined;
+} : Record<never, never>) : never;
 /** Slots resueltos por `useTheme`: todas sus clases ya son una cadena. */
 export type VunoResolvedSlots<TKey extends VunoThemeKey> = Record<[VunoSlotOf<TKey>] extends [never] ? string : VunoSlotOf<TKey>, string>;
 export {};

package/dist/runtime/app/types/table.d.ts

@@ -51,6 +51,8 @@ export type VunoTableEmpty = {
     title?: string;
 };
 export type VunoTableAlign = 'center' | 'end' | 'start';
+export type VunoTableDensity = 'compact' | 'default';
+export type VunoTableSticky = 'end' | 'start';
 /**
  * Una fila. `object` y no `Record<string, unknown>` a propósito: un `interface`
  * de TypeScript no tiene firma de índice implícita, así que no satisface un
@@ -80,6 +82,8 @@ export type VunoTableColumnBase<TRow extends VunoTableRow = VunoTableRow> = {
     key: string;
     label?: string;
     sortable?: boolean;
+    /** Fija la columna al borde lógico del contenedor cuando la tabla se desplaza horizontalmente. */
+    sticky?: VunoTableSticky;
     ui?: VunoUi<'avatar' | 'badge' | 'cellBoolean' | 'cellCurrency' | 'cellDate' | 'cellNumber' | 'cellText' | 'menu'>;
     width?: string;
     /**
@@ -130,7 +134,7 @@ export type VunoTableColumnImage<TRow extends VunoTableRow = VunoTableRow> = Vun
     alt?: string;
     /** Clave de la fila de la que sacar el texto alternativo. */
     altKey?: string;
-    size?: Exclude<VunoSize, 'xl'>;
+    size?: Extract<VunoSize, 'lg' | 'md' | 'sm' | 'xs'>;
 };
 /** Delega el contenido en el slot `cell-<key>`. */
 export type VunoTableColumnCustom<TRow extends VunoTableRow = VunoTableRow> = VunoTableColumnBase<TRow>;
@@ -180,23 +184,15 @@ export type VunoTableCellProps<TType extends VunoTableCellType = VunoTableCellTy
     value: unknown;
 };
 export type VunoTableDefinition<TRow extends VunoTableRow = VunoTableRow> = {
+    /** Texto visible que nombra la tabla mediante su `<caption>` nativo. */
+    caption?: string;
     columns: VunoTableColumn<TRow>[];
-    /** Texto e icono cuando no hay ninguna fila. */
-    empty?: VunoTableEmpty;
-    /**
-     * Campos del panel lateral de filtros. Son los mismos de un formulario, así
-     * que un filtro se declara igual que se declara un campo.
-     */
-    filters?: VunoField[];
-    /** Tamaños ofrecidos en el selector de filas por página. */
-    pageSizes?: number[];
-    /**
-     * Si el endpoint pagina. Por defecto `true`.
-     *
-     * En `false` desaparecen el paginador y el selector de tamaño, y el pie
-     * pasa a decir cuántos resultados hay y nada más.
-     */
-    paginated?: boolean;
+    /** Densidad visual de las cabeceras y celdas. */
+    density?: VunoTableDensity;
+    /** Hace que cada fila sea enfocable y active `rowClick` con Enter o Espacio. */
+    interactive?: boolean;
+    /** Identificador del título externo que nombra la tabla. No se combina con `caption`. */
+    labelledBy?: string;
     /** Campo que identifica la fila; se usa como clave de selección. */
     rowKey?: string;
     /**
@@ -229,19 +225,23 @@ export type VunoTableDefinition<TRow extends VunoTableRow = VunoTableRow> = {
      * otra, sin que nada lo dijera.
      */
     rowLabel?: ((row: TRow) => string) | string;
-    /**
-     * Si el endpoint busca. Por defecto `true`.
-     *
-     * En `false` no se pinta la barra de búsqueda. No es cosmética: una barra
-     * que no filtra es una promesa que la pantalla no puede cumplir, y como
-     * funciona visualmente nadie la reporta como defecto.
-     *
-     * Es del endpoint y no de cada columna: quien decide sobre qué campos se
-     * busca es el servidor, no la tabla.
-     */
+    selectable?: boolean;
+    /** Fija la cabecera al borde superior de un contenedor con altura limitada. */
+    stickyHeader?: boolean;
+};
+/** Configuración del componente compuesto que consulta y presenta una tabla. */
+export type VunoDataTableDefinition<TRow extends VunoTableRow = VunoTableRow> = VunoTableDefinition<TRow> & {
+    /** Texto e icono cuando no hay ninguna fila. */
+    empty?: VunoTableEmpty;
+    /** Campos del panel lateral de filtros. */
+    filters?: VunoField[];
+    /** Tamaños ofrecidos en el selector de filas por página. */
+    pageSizes?: number[];
+    /** Si el endpoint pagina. Por defecto `true`. */
+    paginated?: boolean;
+    /** Si el endpoint busca. Por defecto `true`. */
     searchable?: boolean;
     searchPlaceholder?: string;
-    selectable?: boolean;
 };
 export type VunoTableQueryOptions = {
     /**

package/dist/runtime/app/types/text.d.ts

@@ -0,0 +1,6 @@
+/** Elemento semántico que puede pintar `VText`. */
+export type VunoTextTag = 'code' | 'div' | 'em' | 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'p' | 'small' | 'span' | 'strong';
+/** Jerarquía cromática del texto, independiente de su tamaño o etiqueta. */
+export type VunoTextTone = 'body' | 'inherit' | 'inverse' | 'muted' | 'strong' | 'subtle';
+/** Rol visual completo: tamaño, peso, interlineado y espaciado. */
+export type VunoTextVariant = 'body' | 'caption' | 'code' | 'display' | 'heading' | 'inherit' | 'label' | 'title';

package/dist/runtime/app/types/theme.d.ts

@@ -1,8 +1,8 @@
-import type { VunoSlots } from './base.js';
+import type { VunoRadius, VunoSlots } from './base.js';
 import type { VunoFieldInputType, VunoFieldType } from './field-type.js';
 /**
  * Claves tematizables, y **cada una se llama como su componente sin la `V`**:
- * `VCard` se personaliza con `card`, `VNumberInput` con `numberInput`.
+ * `VCard` se personaliza con `card`; el control numérico interno, con `numberInput`.
  *
  * No siempre fue así y por eso está escrito aquí: llegaron a convivir un
  * prefijo `base` en veinte claves y un `app` en tres, que no describían el
@@ -28,7 +28,7 @@ import type { VunoFieldInputType, VunoFieldType } from './field-type.js';
  * a mirar; queda dicho aquí para que quien añada una excepción sepa que no hay
  * red debajo.
  */
-export type VunoThemeKey = 'alert' | 'avatar' | 'badge' | 'button' | 'card' | 'cellBoolean' | 'cellCurrency' | 'cellDate' | 'cellNumber' | 'cellText' | 'checkbox' | 'code' | 'confirm' | 'container' | 'control' | 'controlGroup' | 'fieldInput' | 'fileUpload' | 'form' | 'formField' | 'formModal' | 'formSection' | 'input' | 'menu' | 'modal' | 'navbar' | 'navigationList' | 'navigationMenu' | 'navigationToc' | 'numberInput' | 'page' | 'pagination' | 'radioGroup' | 'select' | 'slideover' | 'state' | 'switch' | 'table' | 'tabs' | 'tagsInput' | 'textarea' | 'toast' | 'toaster' | 'tooltip' | `field${Capitalize<Exclude<VunoFieldType, VunoFieldInputType>>}`;
+export type VunoThemeKey = 'alert' | 'avatar' | 'badge' | 'breadcrumb' | 'button' | 'card' | 'cellBoolean' | 'cellCurrency' | 'cellDate' | 'cellNumber' | 'cellText' | 'checkbox' | 'code' | 'collapsible' | 'confirm' | 'container' | 'control' | 'controlGroup' | 'dataTable' | 'fieldInput' | 'fileUpload' | 'form' | 'formField' | 'formModal' | 'formSection' | 'input' | 'menu' | 'modal' | 'navbar' | 'navigationList' | 'navigationMenu' | 'navigationToc' | 'numberInput' | 'pagination' | 'radioGroup' | 'select' | 'slideover' | 'state' | 'switch' | 'table' | 'tabs' | 'tagsInput' | 'text' | 'textarea' | 'toast' | 'toaster' | 'toolbar' | 'tooltip' | `field${Capitalize<Exclude<VunoFieldType, VunoFieldInputType>>}`;
 /**
  * Slots que se aplican cuando una dimensión toma cierto valor: `color: 'error'`
  * o `variant: 'solid'`. Se funden sobre los slots base en el orden en que el
@@ -52,7 +52,7 @@ export type VunoThemeVariants = Record<string, Record<string, VunoSlots>>;
  */
 export type VunoThemeCompoundVariant = {
     class: VunoSlots;
-} & Record<string, string | undefined | VunoSlots>;
+} & Record<string, string | string[] | undefined | VunoSlots>;
 export type VunoThemeEntry = {
     /**
      * Las combinaciones, que se aplican **después** de las variantes sueltas de
@@ -75,9 +75,14 @@ export type VunoThemeEntry = {
      */
     variants?: VunoThemeVariants;
 };
-export type VunoThemeConfig = {
+/** Configuración tematizable de cada componente, agrupada por su clave pública. */
+export type VunoComponentsConfig = {
     [TKey in VunoThemeKey]?: VunoThemeEntry;
 };
+/** Defaults visuales compartidos por los componentes que exponen esa capacidad. */
+export type VunoThemeConfig = {
+    radius?: VunoRadius;
+};
 export type VunoIcons = {
     actions: string;
     addItem: string;
@@ -186,6 +191,8 @@ export type VunoMessages = {
     numberDecrement: string;
     numberIncrement: string;
     of: string;
+    /** Acción accesible de una fila interactiva, seguida por el nombre de la fila. */
+    openRow: string;
     /** Compone el nombre de cada número: «Página 3». */
     page: string;
     /** Nombre accesible del selector de filas por página. */
@@ -236,7 +243,8 @@ export type VunoMessages = {
     updated: string;
 };
 /** Forma de `app.config.ts` → `vuno`. */
-export type VunoAppConfig = VunoThemeConfig & {
+export type VunoAppConfig = {
+    components?: VunoComponentsConfig;
     icons?: Partial<VunoIcons>;
     /**
      * Con qué idioma se formatean las fechas, los números y las monedas.
@@ -248,4 +256,5 @@ export type VunoAppConfig = VunoThemeConfig & {
      */
     locale?: string;
     messages?: Partial<VunoMessages>;
+    theme?: VunoThemeConfig;
 };

package/dist/runtime/app/utils/format.js

@@ -1,6 +1,6 @@
 export function formatSlug(value) {
   if (!value) return "";
-  return value.normalize("NFD").replace(/[\u0300-\u036f]/g, "").toLowerCase().trim().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+  return value.normalize("NFD").replace(/[\u0300-\u036f]/g, "").toLowerCase().trim().replace(/[^a-z0-9]+/g, "-").replace(/^-/, "").replace(/-$/, "");
 }
 export function formatNumber(value, locale, decimals) {
   if (value === null || value === void 0 || value === "") return "";
@@ -24,7 +24,8 @@ export function formatCurrency(value, locale, currency = "EUR", decimals) {
 }
 export function formatDate(value, locale, options) {
   if (value === null || value === void 0 || value === "") return "";
-  const date = value instanceof Date ? value : new Date(String(value));
+  if (!(value instanceof Date) && typeof value !== "string" && typeof value !== "number") return "";
+  const date = value instanceof Date ? value : new Date(value);
   if (Number.isNaN(date.getTime())) return "";
   return new Intl.DateTimeFormat(locale, options ?? { dateStyle: "medium" }).format(date);
 }

package/dist/runtime/app/utils/path.js

@@ -37,7 +37,7 @@ export function setPath(object, path, value) {
 export function cloneValue(value) {
   if (value === null || typeof value !== "object") return value;
   if (isBinary(value)) return value;
-  if (value instanceof Date) return new Date(value.getTime());
+  if (value instanceof Date) return new Date(value);
   if (Array.isArray(value)) return value.map((item) => cloneValue(item));
   if (isPlainObject(value)) {
     const result = {};

package/dist/runtime/app/{internal → utils}/slots.d.ts

@@ -16,7 +16,7 @@ export declare function firstElement(nodes?: unknown): undefined | VNode;
  * contiene, así que mirar solo el primer nivel cuenta ese fragmento como
  * contenido. La primera versión de esto se equivocaba justo ahí.
  *
- * Vive en `internal/` porque es una utilidad y no un composable: como global
- * pisaría cualquier `filled` del proyecto que instale el módulo.
+ * Es una utilidad privada del runtime: se importa explícitamente y no ocupa
+ * ningún nombre global en el proyecto que instala el módulo.
  */
 export declare function filled(slot?: () => unknown): boolean;

package/dist/runtime/app/utils/theme.d.ts

@@ -1,44 +1,11 @@
-import { type ClassValue } from 'clsx';
+import { type CnOptions } from 'tailwind-variants';
 import type { VunoSlots } from '#vuno/types/base';
-import type { VunoThemeCompoundVariant, VunoThemeEntry, VunoThemeKey, VunoThemeVariants } from '#vuno/types/theme';
-/**
- * Los slots de las variantes activas.
- *
- * **El orden en que se devuelven es el de declaración**, y ese orden decide
- * quién gana cuando dos dimensiones escriben el mismo slot. No es de fiar:
- * perfectionist ordena las claves alfabéticamente, así que renombrar una
- * dimensión puede cambiar el resultado sin que nadie lo relacione. Si una
- * dimensión tiene que ganar a otra, que publique una variable y la otra la
- * consuma, en lugar de confiar en quién funde después.
- */
-export declare function selectVariants(variants: undefined | VunoThemeVariants, active: Record<string, string | undefined> | undefined): (undefined | VunoSlots)[];
-/**
- * Las combinaciones que se cumplen enteras.
- *
- * Todas sus condiciones o ninguna: una entrada con `color` y `variant` solo
- * entra si las dos coinciden con lo activo. Una condición cuya dimensión no
- * esté activa **no** cuenta como cumplida, que es lo que evita que una
- * combinación se cuele en un componente que ni declara esa variante.
- *
- * Se aplican después de `selectVariants` del mismo nivel, y ese orden es lo que
- * las hace útiles: lo específico llega al final y gana el conflicto.
- */
-export declare function selectCompoundVariants(compounds: undefined | VunoThemeCompoundVariant[], active: Record<string, string | undefined> | undefined): (undefined | VunoSlots)[];
-/** Une un slot escrito como array en una sola cadena, descartando lo vacío. */
-export declare function toClassString(value: string | string[] | undefined): string;
-/**
- * Funde slots en orden de prioridad creciente: tema → app.config → prop.
- *
- * Resuelve los conflictos con `tailwind-merge`, y eso no siempre fue así: antes
- * se concatenaba y se confiaba en que lo hiciera Nuxt UI al recibir el resultado
- * por su prop `ui`. Con componentes propios —que solo escriben las clases en el
- * elemento— esa red desapareció, y un `max-w-lg` del tema convivía con el
- * `max-w-3xl` de quien lo sobreescribía: ganaba el que Tailwind hubiera puesto
- * más tarde en la hoja, no el más específico.
- */
-export declare function mergeSlots(...sources: (undefined | VunoSlots)[]): Record<string, string | undefined>;
+import type { VunoThemeEntry, VunoThemeKey } from '#vuno/types/theme';
 /** Compone clases condicionales y resuelve conflictos de Tailwind de izquierda a derecha. */
-export declare function cn(...inputs: ClassValue[]): string;
-export declare function twObj<T extends Record<string, string>>(obj: T): T;
-/** Define una sola entrada de tema y conserva sus slots y variantes literales. */
+export declare function cn(...inputs: CnOptions): string;
+/** Funde slots en orden de prioridad creciente: tema → app.config → prop. */
+export declare function mergeSlots(...sources: (undefined | VunoSlots)[]): Record<string, string | undefined>;
+/** Resuelve una capa de tema con Tailwind Variants y devuelve clases por slot. */
+export declare function resolveTheme(entry: undefined | VunoThemeEntry, active?: Record<string, string | undefined>, inheritedSlots?: readonly string[]): VunoSlots;
+/** Define una sola entrada de tema, conserva sus literales y prepara su receta. */
 export declare function defineTheme<const TKey extends VunoThemeKey, const TEntry extends VunoThemeEntry>(key: TKey, entry: TEntry): Record<TKey, TEntry>;

package/dist/runtime/app/utils/theme.js

@@ -1,43 +1,45 @@
-import { clsx } from "clsx";
-import { twMerge } from "tailwind-merge";
-export function selectVariants(variants, active) {
-  if (!variants || !active) return [];
-  return Object.entries(variants).map(([dimension, values]) => {
-    const chosen = active[dimension];
-    return chosen === void 0 ? void 0 : values[chosen];
-  });
-}
-export function selectCompoundVariants(compounds, active) {
-  if (!compounds || !active) return [];
-  return compounds.filter(
-    (compound) => Object.entries(compound).every(([dimension, expected]) => {
-      if (dimension === "class") return true;
-      return active[dimension] === expected;
-    })
-  ).map((compound) => compound.class);
-}
-export function toClassString(value) {
-  if (!value) return "";
-  return Array.isArray(value) ? value.filter(Boolean).join(" ") : value;
+import { cn as mergeClasses, tv } from "tailwind-variants";
+const themeRecipes = /* @__PURE__ */ new WeakMap();
+export function cn(...inputs) {
+  return mergeClasses(...inputs) ?? "";
 }
 export function mergeSlots(...sources) {
   const merged = {};
   for (const source of sources) {
     if (!source) continue;
     for (const [slot, value] of Object.entries(source)) {
-      const className = toClassString(value);
-      if (!className) continue;
-      merged[slot] = merged[slot] ? twMerge(merged[slot], className) : className;
+      const className = cn(merged[slot], value);
+      if (className) merged[slot] = className;
     }
   }
   return merged;
 }
-export function cn(...inputs) {
-  return twMerge(clsx(inputs));
-}
-export function twObj(obj) {
-  return obj;
+export function resolveTheme(entry, active, inheritedSlots = []) {
+  if (!entry) return {};
+  const slots = recipeFor(entry, inheritedSlots)(active);
+  const resolved = {};
+  for (const [slot, resolve] of Object.entries(slots)) {
+    const className = resolve();
+    if (className) resolved[slot] = className;
+  }
+  return resolved;
 }
 export function defineTheme(key, entry) {
+  themeRecipes.set(entry, createThemeRecipe(entry));
   return { [key]: entry };
 }
+function createThemeRecipe(entry, inheritedSlots = []) {
+  const slots = Object.fromEntries(inheritedSlots.map((slot) => [slot, ""]));
+  const recipe = tv({
+    compoundVariants: entry.compoundVariants,
+    slots: { ...slots, ...entry.slots },
+    variants: entry.variants
+  });
+  return (active) => recipe(active);
+}
+function recipeFor(entry, inheritedSlots) {
+  if (inheritedSlots.length) return createThemeRecipe(entry, inheritedSlots);
+  const cached = themeRecipes.get(entry);
+  if (cached) return cached;
+  return createThemeRecipe(entry);
+}