npm - siesa-ui-kit - Versions diffs - 1.0.119 → 1.0.121 - Mend

siesa-ui-kit 1.0.119 → 1.0.121

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (187) hide show

package/dist/components/Card/Card.d.ts ADDED Viewed

@@ -0,0 +1,99 @@
+import type { CardProps, CardHeaderProps, CardTitleProps, CardDescriptionProps, CardActionProps, CardContentProps, CardFooterProps } from './Card.types';
+/**
+ * Componente Card del sistema de diseño Siesa
+ *
+ * Contenedor versátil tipo tarjeta compuesto por 7 sub-componentes:
+ * `Card`, `CardHeader`, `CardTitle`, `CardDescription`, `CardAction`,
+ * `CardContent` y `CardFooter`.
+ *
+ * **Estructura típica:**
+ * ```
+ * Card
+ *   ├── CardHeader
+ *   │     ├── CardTitle
+ *   │     ├── CardDescription
+ *   │     └── CardAction (opcional)
+ *   ├── CardContent
+ *   └── CardFooter (opcional)
+ * ```
+ *
+ * **Tokens de color Siesa utilizados:**
+ * - Fondo: `bg-bg-primary` / `dark:bg-dark-bg-secondary`
+ * - Texto: `text-content-primary` / `dark:text-dark-content-primary`
+ * - Texto secundario: `text-content-secondary` / `dark:text-dark-content-secondary`
+ * - Borde: `border-border-primary` / `dark:border-dark-border-primary`
+ *
+ * **Dark Mode:**
+ * Soporte completo mediante las clases `dark:` del sistema de diseño Siesa.
+ * Activar añadiendo la clase `dark` al elemento `<html>`.
+ *
+ * @example
+ * ```tsx
+ * // Tarjeta básica
+ * <Card>
+ *   <CardHeader>
+ *     <CardTitle>Título de la tarjeta</CardTitle>
+ *     <CardDescription>Descripción opcional del contenido</CardDescription>
+ *   </CardHeader>
+ *   <CardContent>
+ *     <p>Contenido principal de la tarjeta.</p>
+ *   </CardContent>
+ *   <CardFooter>
+ *     <Button type="default" size="base">Guardar</Button>
+ *   </CardFooter>
+ * </Card>
+ *
+ * // Tarjeta con acción en el header
+ * <Card>
+ *   <CardHeader>
+ *     <CardTitle>Resumen</CardTitle>
+ *     <CardAction>
+ *       <Button type="plain" size="sm" iconOnly leftIcon={<EditIcon />} ariaLabel="Editar" />
+ *     </CardAction>
+ *   </CardHeader>
+ *   <CardContent>Contenido</CardContent>
+ * </Card>
+ * ```
+ */
+export declare function Card({ className, ...props }: CardProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Cabecera de la tarjeta con grid layout.
+ *
+ * Cuando contiene un `CardAction`, el grid cambia automáticamente a 2 columnas
+ * para posicionar la acción en la esquina superior derecha.
+ * Soporta container queries (`@container/card-header`).
+ */
+export declare function CardHeader({ className, ...props }: CardHeaderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Título principal de la tarjeta.
+ *
+ * Usa tipografía semibold con `leading-none` para alineación precisa.
+ */
+export declare function CardTitle({ className, ...props }: CardTitleProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Descripción secundaria de la tarjeta.
+ *
+ * Renderizada con color de texto secundario del sistema de diseño Siesa.
+ */
+export declare function CardDescription({ className, ...props }: CardDescriptionProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Acción posicionada en la esquina superior derecha del `CardHeader`.
+ *
+ * Debe ser hijo directo de `CardHeader` para que el posicionamiento grid funcione.
+ * Ocupa las 2 filas del grid (título + descripción) en la columna derecha.
+ */
+export declare function CardAction({ className, ...props }: CardActionProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Área de contenido principal de la tarjeta.
+ *
+ * Aplica padding horizontal estándar de 24px (px-6) consistente con el header.
+ */
+export declare function CardContent({ className, ...props }: CardContentProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Pie de la tarjeta con layout flex horizontal.
+ *
+ * Cuando tiene borde superior (`border-t`), aplica padding vertical automático (pt-6).
+ * Ideal para agrupar acciones o información de estado.
+ */
+export declare function CardFooter({ className, ...props }: CardFooterProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=Card.d.ts.map

package/dist/components/Card/Card.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"Card.d.ts","sourceRoot":"","sources":["../../../src/components/Card/Card.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,eAAe,EAChB,MAAM,cAAc,CAAC;AAEtB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AACH,wBAAgB,IAAI,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,SAAS,2CAYtD;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,eAAe,2CAYlE;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,cAAc,2CAQhE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,oBAAoB,2CAW5E;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,eAAe,2CAWlE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,gBAAgB,2CAQpE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,eAAe,2CAQlE"}

package/dist/components/Card/Card.types.d.ts ADDED Viewed

@@ -0,0 +1,66 @@
+import type React from 'react';
+/**
+ * Props del componente Card
+ *
+ * Contenedor principal de la tarjeta. Acepta todos los atributos HTML de un `<div>`.
+ *
+ * @example
+ * ```tsx
+ * <Card className="max-w-sm">
+ *   <CardContent>Contenido</CardContent>
+ * </Card>
+ * ```
+ */
+export type CardProps = React.ComponentProps<'div'>;
+/**
+ * Props del componente CardHeader
+ *
+ * Cabecera de la tarjeta con grid layout. Cuando contiene un `CardAction`,
+ * el grid se convierte en 2 columnas posicionando la acción a la derecha.
+ */
+export type CardHeaderProps = React.ComponentProps<'div'>;
+/**
+ * Props del componente CardTitle
+ *
+ * Título principal de la tarjeta. Renderizado como un `<div>` con
+ * tipografía semibold y leading ajustado.
+ */
+export type CardTitleProps = React.ComponentProps<'div'>;
+/**
+ * Props del componente CardDescription
+ *
+ * Descripción secundaria de la tarjeta. Renderizado con color de texto
+ * secundario del sistema de diseño.
+ */
+export type CardDescriptionProps = React.ComponentProps<'div'>;
+/**
+ * Props del componente CardAction
+ *
+ * Elemento de acción posicionado en la esquina superior derecha del `CardHeader`.
+ * Debe ubicarse dentro de un `CardHeader` para que el posicionamiento funcione correctamente.
+ *
+ * @example
+ * ```tsx
+ * <CardHeader>
+ *   <CardTitle>Título</CardTitle>
+ *   <CardAction>
+ *     <Button type="plain" size="sm">Editar</Button>
+ *   </CardAction>
+ * </CardHeader>
+ * ```
+ */
+export type CardActionProps = React.ComponentProps<'div'>;
+/**
+ * Props del componente CardContent
+ *
+ * Área de contenido principal de la tarjeta con padding horizontal estándar.
+ */
+export type CardContentProps = React.ComponentProps<'div'>;
+/**
+ * Props del componente CardFooter
+ *
+ * Pie de la tarjeta con layout flex horizontal y padding estándar.
+ * Cuando tiene borde superior (`border-t`), aplica padding vertical automático.
+ */
+export type CardFooterProps = React.ComponentProps<'div'>;
+//# sourceMappingURL=Card.types.d.ts.map

package/dist/components/Card/Card.types.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"Card.types.d.ts","sourceRoot":"","sources":["../../../src/components/Card/Card.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,SAAS,GAAG,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;AAE/D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,eAAe,GAAG,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;AAE1D;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC"}

package/dist/components/Card/cn.d.ts ADDED Viewed

@@ -0,0 +1,3 @@
+import { type ClassValue } from 'clsx';
+export declare function cn(...inputs: ClassValue[]): string;
+//# sourceMappingURL=cn.d.ts.map

package/dist/components/Card/cn.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"cn.d.ts","sourceRoot":"","sources":["../../../src/components/Card/cn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAQ,MAAM,MAAM,CAAC;AAG7C,wBAAgB,EAAE,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAElD"}

package/dist/components/Card/index.d.ts ADDED Viewed

@@ -0,0 +1,3 @@
+export { Card, CardHeader, CardTitle, CardDescription, CardAction, CardContent, CardFooter } from './Card';
+export type { CardProps, CardHeaderProps, CardTitleProps, CardDescriptionProps, CardActionProps, CardContentProps, CardFooterProps, } from './Card.types';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/Card/index.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Card/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC3G,YAAY,EACV,SAAS,EACT,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,eAAe,GAChB,MAAM,cAAc,CAAC"}

package/dist/components/MasterCrud/index.d.ts CHANGED Viewed

@@ -3,6 +3,7 @@ export { MasterCrudTable } from './MasterCrudTable';
 export { MasterCrudForm } from './MasterCrudForm';
 export { MasterCrudToolbar } from './MasterCrudToolbar';
 export { MasterCRUDCard } from './MasterCRUDCard';
+export { LinkModal } from './LinkModal';
 export { MasterCrudDynamicEntities } from './MasterCrudDynamicEntities';
 export type { FieldType, ViewState, SelectFieldOption, FieldConfig, MasterCrudField, LookupConfig, GetAllParams, GetAllResponse, CrudService, MasterCrudProps, MasterCrudTableProps, MasterCrudFormProps, MasterCrudAction, MatchResult, MasterCrudToolbarProps, ToolbarViewType, SortOption, FilterOption, FormState, } from './MasterCrud.types';
 export { PencilIcon, TrashIcon, PlusIcon, SearchIcon, CloseIcon, BackIcon, FilterIcon, ChevronDownIcon, GridIcon, ListIcon, CalendarIcon, EllipsisHorizontalIcon, Bars3Icon, SortAscIcon, SortDescIcon, } from './icons';

package/dist/components/MasterCrud/index.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/MasterCrud/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAMxE,YAAY,EAEV,SAAS,EACT,SAAS,EAGT,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,YAAY,EAGZ,YAAY,EACZ,cAAc,EACd,WAAW,EAGX,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EAGnB,gBAAgB,EAGhB,WAAW,EAGX,sBAAsB,EACtB,eAAe,EACf,UAAU,EACV,YAAY,EAGZ,SAAS,GACV,MAAM,oBAAoB,CAAC;AAM5B,OAAO,EACL,UAAU,EACV,SAAS,EACT,QAAQ,EACR,UAAU,EACV,SAAS,EACT,QAAQ,EACR,UAAU,EACV,eAAe,EACf,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,sBAAsB,EACtB,SAAS,EACT,WAAW,EACX,YAAY,GACb,MAAM,SAAS,CAAC"}
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/MasterCrud/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAMxE,YAAY,EAEV,SAAS,EACT,SAAS,EAGT,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,YAAY,EAGZ,YAAY,EACZ,cAAc,EACd,WAAW,EAGX,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EAGnB,gBAAgB,EAGhB,WAAW,EAGX,sBAAsB,EACtB,eAAe,EACf,UAAU,EACV,YAAY,EAGZ,SAAS,GACV,MAAM,oBAAoB,CAAC;AAM5B,OAAO,EACL,UAAU,EACV,SAAS,EACT,QAAQ,EACR,UAAU,EACV,SAAS,EACT,QAAQ,EACR,UAAU,EACV,eAAe,EACf,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,sBAAsB,EACtB,SAAS,EACT,WAAW,EACX,YAAY,GACb,MAAM,SAAS,CAAC"}

package/dist/components/MasterPatternUI/MasterPatternUI.d.ts ADDED Viewed

@@ -0,0 +1,48 @@
+import type { MasterPatternUIProps } from './MasterPatternUI.types';
+/**
+ * MasterPatternUI — Vista hub de navegación para módulos de negocio
+ *
+ * Componente que implementa el patrón de vista maestra para un área de negocio.
+ * Renderiza una cuadrícula de tarjetas interactivas, donde cada tarjeta representa
+ * un sub-módulo o funcionalidad navegable (facturas, pagos, reportes, etc.).
+ *
+ * Diseñado para usarse como página de entrada de un módulo en el ecosistema Siesa.
+ *
+ * **Características:**
+ * - Cuadrícula responsive configurable (1–4 columnas)
+ * - Búsqueda local o controlada externamente
+ * - Estado de carga con esqueleto animado
+ * - Estado vacío personalizable
+ * - Badges de notificación por ítem (número o texto)
+ * - Control de visibilidad y estado deshabilitado por ítem
+ * - Acciones en la cabecera (slots)
+ * - Soporte completo para dark mode
+ * - Accesibilidad: navegación por teclado (Enter / Space)
+ *
+ * @example
+ * ```tsx
+ * // Uso básico
+ * <MasterPatternUI
+ *   title="Módulo Financiero"
+ *   description="Gestione facturas, pagos y cartera desde un solo lugar."
+ *   items={moduleItems}
+ *   columns={3}
+ *   showSearch
+ * />
+ *
+ * // Con búsqueda externa y acciones en header
+ * <MasterPatternUI
+ *   title="Configuración"
+ *   items={configItems}
+ *   columns={4}
+ *   showSearch
+ *   onSearch={handleSearch}
+ *   searchValue={searchQuery}
+ *   headerActions={<Button type="plain" size="sm">Actualizar</Button>}
+ * />
+ * ```
+ *
+ * @see MasterPatternUIProps para la especificación completa de props
+ */
+export declare function MasterPatternUI({ title, description, items, columns, showSearch, searchPlaceholder, onSearch, searchValue, loading, emptyState, headerActions, className, itemClassName, }: MasterPatternUIProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=MasterPatternUI.d.ts.map

package/dist/components/MasterPatternUI/MasterPatternUI.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"MasterPatternUI.d.ts","sourceRoot":"","sources":["../../../src/components/MasterPatternUI/MasterPatternUI.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,oBAAoB,EAIrB,MAAM,yBAAyB,CAAC;AA4OjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,WAAW,EACX,KAAK,EACL,OAAW,EACX,UAAkB,EAClB,iBAAsC,EACtC,QAAQ,EACR,WAAW,EACX,OAAe,EACf,UAAU,EACV,aAAa,EACb,SAAS,EACT,aAAa,GACd,EAAE,oBAAoB,2CAkHtB"}

package/dist/components/MasterPatternUI/MasterPatternUI.types.d.ts ADDED Viewed

@@ -0,0 +1,231 @@
+import type { ReactNode } from 'react';
+/**
+ * Colores disponibles para el badge de un ítem.
+ *
+ * Mapeados a los tokens de color del sistema de diseño Siesa.
+ */
+export type MasterPatternItemBadgeColor = 'blue' | 'green' | 'red' | 'yellow' | 'purple' | 'orange' | 'gray';
+/**
+ * Definición de un ítem de navegación dentro de `MasterPatternUI`.
+ *
+ * Cada ítem se renderiza como una tarjeta interactiva en la cuadrícula.
+ *
+ * @example
+ * ```ts
+ * const item: MasterPatternItem = {
+ *   id: 'facturas',
+ *   label: 'Facturas',
+ *   description: 'Gestión de facturas de venta y compra',
+ *   icon: <InvoiceIcon />,
+ *   badge: 12,
+ *   badgeColor: 'blue',
+ *   onClick: () => navigate('/finance/invoices'),
+ * };
+ * ```
+ */
+export interface MasterPatternItem {
+    /**
+     * Identificador único del ítem.
+     * Usado como `key` en el renderizado del grid.
+     */
+    id: string;
+    /**
+     * Título principal de la tarjeta.
+     * Se muestra en negrita como nombre del módulo o funcionalidad.
+     */
+    label: string;
+    /**
+     * Descripción secundaria de la tarjeta.
+     * Texto corto que explica el propósito del módulo.
+     */
+    description?: string;
+    /**
+     * Ícono del ítem, renderizado en la esquina superior izquierda de la tarjeta.
+     * Se recomienda usar íconos de 20x20px o 24x24px.
+     */
+    icon?: ReactNode;
+    /**
+     * Contenido del badge de notificación.
+     * Acepta un número (ej: cantidad de registros pendientes) o un string (ej: "Nuevo").
+     */
+    badge?: string | number;
+    /**
+     * Color del badge de notificación.
+     *
+     * @default 'blue'
+     */
+    badgeColor?: MasterPatternItemBadgeColor;
+    /**
+     * Si `true`, el ítem no es interactivo y aparece con opacidad reducida.
+     *
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Si `false`, el ítem no se renderiza en la cuadrícula.
+     * Útil para controlar visibilidad según permisos del usuario.
+     *
+     * @default true
+     */
+    visible?: boolean;
+    /**
+     * Función ejecutada al hacer click en la tarjeta.
+     * Si está definida junto con `href`, `onClick` tiene prioridad.
+     */
+    onClick?: () => void;
+    /**
+     * Clases CSS adicionales aplicadas a la tarjeta del ítem.
+     */
+    className?: string;
+}
+/**
+ * Configuración del estado vacío del componente.
+ *
+ * Se muestra cuando no hay ítems visibles (sin ítems definidos
+ * o cuando la búsqueda no arroja resultados).
+ */
+export interface MasterPatternEmptyState {
+    /**
+     * Título del estado vacío.
+     *
+     * @default 'Sin módulos disponibles'
+     */
+    title?: string;
+    /**
+     * Descripción del estado vacío.
+     *
+     * @default 'No hay módulos configurados para mostrar.'
+     */
+    description?: string;
+    /**
+     * Ícono ilustrativo del estado vacío.
+     * Si no se provee, se usa un ícono genérico de cuadrícula.
+     */
+    icon?: ReactNode;
+    /**
+     * Elemento de acción opcional (ej: botón para crear un módulo o limpiar el filtro).
+     */
+    action?: ReactNode;
+}
+/**
+ * Número de columnas de la cuadrícula de ítems en pantallas grandes (≥ lg).
+ * En pantallas medianas (sm) se usa la mitad (mínimo 1), en móvil siempre 1 columna.
+ *
+ * | columns | lg grid   | sm grid | xs grid |
+ * |---------|-----------|---------|---------|
+ * | 1       | 1 col     | 1 col   | 1 col   |
+ * | 2       | 2 cols    | 1 col   | 1 col   |
+ * | 3       | 3 cols    | 2 cols  | 1 col   |
+ * | 4       | 4 cols    | 2 cols  | 1 col   |
+ *
+ * @default 3
+ */
+export type MasterPatternColumns = 1 | 2 | 3 | 4;
+/**
+ * Props del componente `MasterPatternUI`.
+ *
+ * Componente de vista para el hub de navegación de un módulo de negocio.
+ * Renderiza una cuadrícula de tarjetas interactivas, cada una representando
+ * un sub-módulo o funcionalidad del área de negocio.
+ *
+ * @example
+ * ```tsx
+ * <MasterPatternUI
+ *   title="Módulo Financiero"
+ *   description="Acceda a las funcionalidades del área financiera."
+ *   items={[
+ *     {
+ *       id: 'facturas',
+ *       label: 'Facturas',
+ *       description: 'Registro y consulta de facturas',
+ *       icon: <FileTextIcon />,
+ *       badge: 5,
+ *       badgeColor: 'blue',
+ *       onClick: () => navigate('/finance/facturas'),
+ *     },
+ *     {
+ *       id: 'pagos',
+ *       label: 'Pagos',
+ *       description: 'Control de pagos y cartera',
+ *       icon: <CreditCardIcon />,
+ *       onClick: () => navigate('/finance/pagos'),
+ *     },
+ *   ]}
+ *   showSearch
+ *   columns={3}
+ * />
+ * ```
+ */
+export interface MasterPatternUIProps {
+    /**
+     * Título del módulo o área de negocio.
+     * Se muestra en la cabecera del componente como encabezado principal.
+     */
+    title: string;
+    /**
+     * Descripción breve del módulo.
+     * Se muestra debajo del título con estilo de texto secundario.
+     */
+    description?: string;
+    /**
+     * Lista de ítems de navegación a mostrar en la cuadrícula.
+     * Los ítems con `visible: false` son omitidos del renderizado.
+     */
+    items: MasterPatternItem[];
+    /**
+     * Número de columnas de la cuadrícula en pantallas grandes.
+     *
+     * @default 3
+     */
+    columns?: MasterPatternColumns;
+    /**
+     * Si `true`, muestra un campo de búsqueda en la cabecera.
+     * La búsqueda filtra ítems por `label` y `description` de forma local.
+     * Para búsqueda externa (asíncrona), use `onSearch`.
+     *
+     * @default false
+     */
+    showSearch?: boolean;
+    /**
+     * Placeholder del campo de búsqueda.
+     *
+     * @default 'Buscar módulo...'
+     */
+    searchPlaceholder?: string;
+    /**
+     * Callback ejecutado al cambiar el valor del campo de búsqueda.
+     * Si se provee, desactiva el filtrado interno y delega la lógica al padre.
+     * Si no se provee, el componente filtra los ítems localmente.
+     */
+    onSearch?: (query: string) => void;
+    /**
+     * Valor actual del campo de búsqueda (modo controlado).
+     * Úselo junto con `onSearch` para controlar externamente el estado de búsqueda.
+     */
+    searchValue?: string;
+    /**
+     * Si `true`, muestra un esqueleto de carga en lugar de la cuadrícula.
+     *
+     * @default false
+     */
+    loading?: boolean;
+    /**
+     * Configuración del estado vacío mostrado cuando no hay ítems.
+     */
+    emptyState?: MasterPatternEmptyState;
+    /**
+     * Elementos adicionales renderizados en la esquina derecha de la cabecera.
+     * Úselos para acciones globales (ej: botón de configuración, refresh).
+     */
+    headerActions?: ReactNode;
+    /**
+     * Clases CSS adicionales aplicadas al contenedor raíz del componente.
+     */
+    className?: string;
+    /**
+     * Clases CSS adicionales aplicadas a cada tarjeta de ítem.
+     * Complementa (no reemplaza) las clases base.
+     */
+    itemClassName?: string;
+}
+//# sourceMappingURL=MasterPatternUI.types.d.ts.map

package/dist/components/MasterPatternUI/MasterPatternUI.types.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"MasterPatternUI.types.d.ts","sourceRoot":"","sources":["../../../src/components/MasterPatternUI/MasterPatternUI.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAMvC;;;;GAIG;AACH,MAAM,MAAM,2BAA2B,GACnC,MAAM,GACN,OAAO,GACP,KAAK,GACL,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,MAAM,CAAC;AAEX;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;IAEjB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAExB;;;;OAIG;IACH,UAAU,CAAC,EAAE,2BAA2B,CAAC;IAEzC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAErB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;IAEjB;;OAEG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAMD;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAMjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,WAAW,oBAAoB;IAGnC;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAIrB;;;OAGG;IACH,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAI3B;;;;OAIG;IACH,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAI/B;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAEnC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAIrB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,UAAU,CAAC,EAAE,uBAAuB,CAAC;IAIrC;;;OAGG;IACH,aAAa,CAAC,EAAE,SAAS,CAAC;IAI1B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/dist/components/MasterPatternUI/icons.d.ts ADDED Viewed

@@ -0,0 +1,5 @@
+export declare function SearchIcon(): import("react/jsx-runtime").JSX.Element;
+export declare function ArrowRightIcon(): import("react/jsx-runtime").JSX.Element;
+export declare function GridEmptyIcon(): import("react/jsx-runtime").JSX.Element;
+export declare function SearchEmptyIcon(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=icons.d.ts.map

package/dist/components/MasterPatternUI/icons.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../../src/components/MasterPatternUI/icons.tsx"],"names":[],"mappings":"AACA,wBAAgB,UAAU,4CAkBzB;AAGD,wBAAgB,cAAc,4CAkB7B;AAGD,wBAAgB,aAAa,4CAoB5B;AAGD,wBAAgB,eAAe,4CAmB9B"}

package/dist/components/MasterPatternUI/index.d.ts ADDED Viewed

@@ -0,0 +1,4 @@
+export { MasterPatternUI } from './MasterPatternUI';
+export type { MasterPatternUIProps, MasterPatternItem, MasterPatternColumns, MasterPatternItemBadgeColor, MasterPatternEmptyState, } from './MasterPatternUI.types';
+export { SearchIcon, ArrowRightIcon, GridEmptyIcon, SearchEmptyIcon } from './icons';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/MasterPatternUI/index.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/MasterPatternUI/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EACV,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC"}

package/dist/components/MasterPatternView/components/InternalToastContainer.d.ts ADDED Viewed

@@ -0,0 +1,17 @@
+/**
+ * InternalToastContainer — self-contained toast system for master-pattern-ui.
+ *
+ * Uses a DOM CustomEvent bus so `useToast` can fire toasts without requiring
+ * the consumer to provide a `toast` prop or mount a ToastManager.
+ *
+ * Usage:
+ *   - `fireInternalToast(type, message)` — fire from anywhere in the package
+ *   - `<InternalToastContainer />` — mount once inside MasterPatternView
+ *
+ * @module components/InternalToastContainer
+ */
+import React from 'react';
+import type { ToastType } from '../hooks/useToast';
+export declare function fireInternalToast(type: ToastType, message: string): void;
+export declare function InternalToastContainer(): React.ReactElement | null;
+//# sourceMappingURL=InternalToastContainer.d.ts.map

package/dist/components/MasterPatternView/components/InternalToastContainer.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"InternalToastContainer.d.ts","sourceRoot":"","sources":["../../../../src/components/MasterPatternView/components/InternalToastContainer.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAA8B,MAAM,OAAO,CAAC;AAInD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAiBnD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAKxE;AAED,wBAAgB,sBAAsB,IAAI,KAAK,CAAC,YAAY,GAAG,IAAI,CAmClE"}

package/dist/components/MasterPatternView/components/MasterPatternView.d.ts ADDED Viewed

@@ -0,0 +1,32 @@
+/**
+ * MasterPatternView — root component for master data management.
+ *
+ * Composes all sub-systems: store context, toolbar, list, form panel,
+ * and modals. Exposes imperative ref API via MasterPatternViewRef.
+ *
+ * @module components/MasterPatternView
+ * @see FMPV-MVWC-E003-S006 I-001
+ */
+import React from 'react';
+import type { MasterPatternViewEntity } from '../types';
+import type { MasterPatternViewProps, MasterPatternViewRef } from '../types';
+/**
+ * MasterPatternView — complete master data management component.
+ *
+ * @example
+ * ```tsx
+ * const ref = useRef<MasterPatternViewRef>(null);
+ *
+ * <MasterPatternView
+ *   ref={ref}
+ *   definition={currencyDefinition}
+ *   service={currencyService}
+ *   title="Monedas"
+ *   entityName="Moneda"
+ * />
+ * ```
+ */
+export declare const MasterPatternView: <T extends MasterPatternViewEntity>(props: MasterPatternViewProps<T> & {
+    ref?: React.ForwardedRef<MasterPatternViewRef>;
+}) => React.ReactElement | null;
+//# sourceMappingURL=MasterPatternView.d.ts.map

package/dist/components/MasterPatternView/components/MasterPatternView.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"MasterPatternView.d.ts","sourceRoot":"","sources":["../../../../src/components/MasterPatternView/components/MasterPatternView.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAqG,MAAM,OAAO,CAAC;AAG1H,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,KAAK,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAw+B7E;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,iBAAiB,EAWxB,CAAC,CAAC,SAAS,uBAAuB,EACtC,KAAK,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAAG;IAAE,GAAG,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC,oBAAoB,CAAC,CAAA;CAAE,KAClF,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC"}

package/dist/components/MasterPatternView/components/form/BasicDataTab.d.ts ADDED Viewed

@@ -0,0 +1,16 @@
+import type { MasterPatternViewDefinition } from '../../types/definition.types';
+export interface BasicDataTabProps {
+    definition: MasterPatternViewDefinition;
+    values: Record<string, unknown>;
+    errors: Record<string, string>;
+    onChange: (field: string, value: unknown) => void;
+    headerFields?: string[];
+    readOnly?: boolean;
+    /** 'company' when a specific company is selected; 'global' otherwise */
+    fieldContext?: 'global' | 'company';
+    isShowGlobalValuesEnabled?: boolean;
+    globalValues?: Record<string, unknown>;
+    onFieldRevert?: (fieldName: string, globalValue: unknown) => void;
+}
+export declare function BasicDataTab({ definition, values, errors, onChange, headerFields, readOnly, fieldContext, isShowGlobalValuesEnabled, globalValues, onFieldRevert, }: BasicDataTabProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=BasicDataTab.d.ts.map

package/dist/components/MasterPatternView/components/form/BasicDataTab.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"BasicDataTab.d.ts","sourceRoot":"","sources":["../../../../../src/components/MasterPatternView/components/form/BasicDataTab.tsx"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAKhF,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,2BAA2B,CAAC;IACxC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAClD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wEAAwE;IACxE,YAAY,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IACpC,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,KAAK,IAAI,CAAC;CACnE;AAID,wBAAgB,YAAY,CAAC,EAC3B,UAAU,EACV,MAAM,EACN,MAAM,EACN,QAAQ,EACR,YAAoC,EACpC,QAAgB,EAChB,YAAY,EACZ,yBAAiC,EACjC,YAAiB,EACjB,aAAa,GACd,EAAE,iBAAiB,2CAqEnB"}

package/dist/components/MasterPatternView/components/form/ContentTab.d.ts ADDED Viewed

@@ -0,0 +1,15 @@
+import type { MasterPatternViewDefinition, MasterPatternViewTabConfig } from '../../types/definition.types';
+export interface ContentTabProps {
+    definition: MasterPatternViewDefinition;
+    tabConfig: MasterPatternViewTabConfig;
+    values: Record<string, unknown>;
+    errors: Record<string, string>;
+    onChange: (field: string, value: unknown) => void;
+    readOnly?: boolean;
+    fieldContext?: 'global' | 'company';
+    isShowGlobalValuesEnabled?: boolean;
+    globalValues?: Record<string, unknown>;
+    onFieldRevert?: (fieldName: string, globalValue: unknown) => void;
+}
+export declare function ContentTab({ definition, tabConfig, values, errors, onChange, readOnly, fieldContext, isShowGlobalValuesEnabled, globalValues, onFieldRevert, }: ContentTabProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ContentTab.d.ts.map

package/dist/components/MasterPatternView/components/form/ContentTab.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"ContentTab.d.ts","sourceRoot":"","sources":["../../../../../src/components/MasterPatternView/components/form/ContentTab.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAM5G,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,2BAA2B,CAAC;IACxC,SAAS,EAAE,0BAA0B,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAClD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IACpC,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,KAAK,IAAI,CAAC;CACnE;AAED,wBAAgB,UAAU,CAAC,EACzB,UAAU,EACV,SAAS,EACT,MAAM,EACN,MAAM,EACN,QAAQ,EACR,QAAgB,EAChB,YAAY,EACZ,yBAAiC,EACjC,YAAiB,EACjB,aAAa,GACd,EAAE,eAAe,2CAmEjB"}

package/dist/components/MasterPatternView/components/form/DetailTab.d.ts ADDED Viewed

@@ -0,0 +1,25 @@
+/**
+ * DetailTab — master-detail sub-entity mini-table with lazy loading.
+ *
+ * Features:
+ * - Lazy loads on first activation via TanStack Query (enabled=isActive)
+ * - Mini-table with showInList columns from config.fields
+ * - "+ Agregar {entityName}" button opens an inline modal
+ * - Row "Editar" opens the same modal pre-filled
+ * - Row "Eliminar" inline confirmation (row transforms — no modal-on-modal)
+ * - Validates via config.validate before each save
+ *
+ * @module components/form/DetailTab
+ * @see FMPV-MVWC-E005-S001
+ */
+import React from 'react';
+import type { MasterDetailTabConfig } from '../../types/detail.types';
+import type { MasterPatternViewEntity } from '../../types/service.types';
+export interface DetailTabProps<D extends MasterPatternViewEntity> {
+    config: MasterDetailTabConfig<D>;
+    masterId: string;
+    companyId?: string;
+    isActive: boolean;
+}
+export declare function DetailTab<D extends MasterPatternViewEntity>({ config, masterId, companyId, isActive, }: DetailTabProps<D>): React.ReactElement | null;
+//# sourceMappingURL=DetailTab.d.ts.map

package/dist/components/MasterPatternView/components/form/DetailTab.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"DetailTab.d.ts","sourceRoot":"","sources":["../../../../../src/components/MasterPatternView/components/form/DetailTab.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAmB,MAAM,OAAO,CAAC;AAKxC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAGzE,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,uBAAuB;IAC/D,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAsCD,wBAAgB,SAAS,CAAC,CAAC,SAAS,uBAAuB,EAAE,EAC3D,MAAM,EACN,QAAQ,EACR,SAAS,EACT,QAAQ,GACT,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAuO/C"}