@imj_media/ui 1.5.0 → 1.6.0

package/dist/shared/types/badge.d.ts

@@ -3,35 +3,86 @@ import { IconType, IconFontColor, AnyIconDefinition } from './types';
 export type BadgeColor = 'accent' | 'gray' | 'success' | 'warning' | 'danger' | 'info';
 export type BadgeTheme = 'solid' | 'soft';
 export type BadgeSize = 'dot' | 'sm' | 'md' | 'lg';
-export interface BadgeProps {
-    label?: string;
+export interface BadgeSharedProps {
+    className?: string;
+}
+/** Color, tamaño, tema y borde. */
+export interface BadgeAppearanceProps {
     color?: BadgeColor;
     theme?: BadgeTheme;
     size?: BadgeSize;
     customColor?: string;
     stroke?: boolean;
-    /**
-     * Si es `false`, el badge no participa como objetivo de puntero (`pointer-events: none`): útil en chips donde el
+}
+/** Icono Font Awesome / slot y duotone. */
+export interface BadgeGlyphProps {
+    icon?: IconType | AnyIconDefinition;
+    /** Si se define, sustituye el render del icono Font Awesome (p. ej. LegacyIcon). */
+    iconSlot?: ReactNode;
+    iconDuotonePrimary?: IconFontColor;
+    iconDuotoneSecondary?: IconFontColor;
+    iconDuotoneOpacityPrimary?: number;
+    iconDuotoneOpacitySecondary?: number;
+}
+/** Texto y truncado. */
+export interface BadgeTextProps {
+    label?: string;
+    truncateLabel?: boolean;
+    /** Si es true y truncateLabel es true, muestra tooltip con el texto completo al hacer hover cuando está truncado. Por defecto false. */
+    truncateTooltip?: boolean;
+}
+/** Carga, disabled y puntero. */
+export interface BadgeStateProps {
+    /** Si es `false`, el badge no participa como objetivo de puntero (`pointer-events: none`): útil en chips donde el
      * remarcado lo define el padre (p. ej. tarjeta con `group-hover`) y no el hover sobre el propio badge.
-     * Por defecto `true`.
-     */
+     * Por defecto `true`. */
+    hover?: boolean;
+    disabled?: boolean;
+    /** Si es true, muestra un spinner de carga en lugar del contenido del badge */
+    loading?: boolean;
+}
+/** Bloques opcionales; cada clave gana sobre la prop plana homónima (fusión en el componente). */
+export interface BadgeGroupedBlocks {
+    appearance?: BadgeAppearanceProps;
+    glyph?: BadgeGlyphProps;
+    text?: BadgeTextProps;
+    state?: BadgeStateProps;
+}
+/**
+ * Props planas (compatibilidad). Preferir {@link BadgeGroupedBlocks}.
+ * @deprecated Preferir `appearance`, `glyph`, `text`, `state`.
+ */
+export interface BadgeFlatDeprecated {
+    label?: string;
+    color?: BadgeColor;
+    theme?: BadgeTheme;
+    size?: BadgeSize;
+    customColor?: string;
+    stroke?: boolean;
     hover?: boolean;
     disabled?: boolean;
-    className?: string;
     icon?: IconType | AnyIconDefinition;
-    /** Si se define, sustituye el render del icono Font Awesome (p. ej. LegacyIcon). */
     iconSlot?: ReactNode;
     iconDuotonePrimary?: IconFontColor;
     iconDuotoneSecondary?: IconFontColor;
     iconDuotoneOpacityPrimary?: number;
     iconDuotoneOpacitySecondary?: number;
-    /** Si es true, muestra un spinner de carga en lugar del contenido del badge */
     loading?: boolean;
-    /** Si true, el label se trunca con "..." si no cabe en el espacio disponible */
     truncateLabel?: boolean;
-    /** Si true y truncateLabel es true, muestra tooltip con el texto completo al hacer hover cuando está truncado. Por defecto false. */
     truncateTooltip?: boolean;
 }
+/**
+ * Props públicas de {@link Badge}: API preferida por bloques (`appearance`, `glyph`, `text`, `state`);
+ * las props planas siguen admitidas (compatibilidad).
+ */
+export type BadgeProps = BadgeSharedProps & BadgeGroupedBlocks & BadgeFlatDeprecated;
+/**
+ * Forma plana tras fusión (uso interno del componente).
+ * @internal
+ */
+export interface BadgePropsFlat extends BadgeFlatDeprecated {
+    className?: string;
+}
 /** @deprecated Usa BadgeProps en su lugar */
 export type IBadgeProps = BadgeProps;
 //# sourceMappingURL=badge.d.ts.map

package/dist/shared/types/badge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"badge.d.ts","sourceRoot":"","sources":["../../../src/shared/types/badge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAErE,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AACvF,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;AAC1C,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEnD,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,QAAQ,GAAG,iBAAiB,CAAC;IACpC,oFAAoF;IACpF,QAAQ,CAAC,EAAE,SAAS,CAAC;IAErB,kBAAkB,CAAC,EAAE,aAAa,CAAC;IACnC,oBAAoB,CAAC,EAAE,aAAa,CAAC;IACrC,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,+EAA+E;IAC/E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gFAAgF;IAChF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,qIAAqI;IACrI,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,6CAA6C;AAC7C,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC"}
+{"version":3,"file":"badge.d.ts","sourceRoot":"","sources":["../../../src/shared/types/badge.ts"],"names":[],"mappings":"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"}

package/dist/shared/types/dropdown.d.ts

@@ -1,10 +1,14 @@
 import { Colors, IconFontColor, InputSize, PillSize, VisualSlotType } from './types';
 import { ButtonTooltipConfig } from './buttonConfig';
 import { ListItemCheckboxSelectionTone } from './list';
-/** Cómo se muestran las tags seleccionadas en el campo (solo `multiple` + `selectedItemsDisplay="tags"`). */
+/** Cómo se resume la selección en el trigger cuando `multiple`: chips, contador o texto (un solo modo; sin fila extra de tags). */
+export type DropdownSelectionSummary = 'tags' | 'count' | 'text';
+/** Cómo se muestran las tags en el campo cuando `selectionSummary="tags"` (wrap vs una línea + chip +n). */
 export type DropdownTagsOverflow = 'wrap' | 'single-line';
 /** Variantes de lista que el dropdown puede renderizar */
-export type DropdownListVariant = 'default' | 'list-default' | 'radio' | 'toggle' | 'user' | 'checkbox-item' | 'filters';
+export type DropdownListVariant = 'default' | 'list-default' | 'radio' | 'toggle' | 'user' | 'checkbox-item' | 'filters'
+/** Lista tipo OBP/Figma: `ListBase` variante `search-multi-checkbox` (búsqueda, cabecera tri‑estado, checks). */
+ | 'search-multi-checkbox';
 export interface DropdownOption {
     label: string;
     value?: string | number;
@@ -30,90 +34,284 @@ export interface DropdownOption {
     avatarUrl?: string;
     [key: string]: unknown;
 }
-export interface DropdownProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'size' | 'onChange' | 'value' | 'defaultValue'> {
+/**
+ * Buscador del panel cuando `listVariant="search-multi-checkbox"` (dentro de {@link DropdownSearchMultiCheckboxConfig}).
+ */
+export interface DropdownSearchMultiCheckboxSearchProps {
+    /**
+     * Muestra el buscador dentro de la lista.
+     * @default true
+     */
+    show?: boolean;
+    /**
+     * Placeholder del campo en la lista; si no se define, se usa `menuSearch.searchPlaceholder` o la raíz.
+     */
+    placeholder?: string;
+}
+/** Texto e id de la fila de cabecera «seleccionar todo» del panel (estado tri‑estado lo calcula el Dropdown). */
+export interface DropdownSearchMultiCheckboxHeaderProps {
+    id: string;
+    label: string;
+}
+/**
+ * Configuración del panel cuando `listVariant="search-multi-checkbox"` y `multiple`
+ * (buscador en lista, cabecera «seleccionar todo», botón «Limpiar selección»).
+ * Narrativa: `packages/ui/DEVELOPMENT_GUIDE.md` — *ListBase y Dropdown*.
+ */
+export interface DropdownSearchMultiCheckboxConfig {
+    search?: Partial<DropdownSearchMultiCheckboxSearchProps>;
+    header?: DropdownSearchMultiCheckboxHeaderProps;
+    /**
+     * Muestra el botón «Limpiar selección» bajo la lista.
+     * @default true
+     */
+    showClearSelection?: boolean;
+}
+/** Etiqueta, validación, tamaño, placeholder y caret del control. */
+export interface DropdownFieldProps {
+    label?: string;
+    error?: string;
+    helperText?: string;
+    placeholder?: string;
+    disabled?: boolean;
+    size?: InputSize;
+    color?: Colors;
+    caret?: boolean;
+}
+/** Tooltip informativo del campo y envoltorio `Tooltip` opcional. */
+export interface DropdownHintProps {
+    infoTooltip?: string;
+    tooltipProps?: ButtonTooltipConfig;
+}
+/** Iconos laterales y variante pill del input. */
+export interface DropdownSlotsProps {
+    leftSlot?: VisualSlotType;
+    rightSlot?: VisualSlotType;
+    pill?: PillSize;
+}
+/** Opciones del menú y mapeo de claves; opción placeholder inicial. */
+export interface DropdownItemsProps {
+    options?: DropdownOption[];
+    valueName?: string;
+    idName?: string;
+    defaultOptionSelected?: boolean;
+}
+/** Valor controlado / por defecto y bandera de “hay actual”. */
+export interface DropdownValuesProps {
+    value?: string | number | (string | number)[];
+    defaultValue?: string | number | (string | number)[];
+    hasCurrent?: boolean;
+}
+/** Búsqueda y textos vacíos en el menú desplegable (no el buscador del panel `search-multi-checkbox`). */
+export interface DropdownMenuSearchProps {
+    searchable?: boolean;
+    searchPlaceholder?: string;
+    noResultsText?: string;
+    noResultsDescription?: string;
+}
+/** Multiselección, resumen en el trigger, límites y botón limpiar del trigger. */
+export interface DropdownMultiProps {
+    multiple?: boolean;
+    maxSelectedItems?: number;
+    /** Cómo se muestra la selección múltiple en el campo (`tags` = chips en el trigger; `count` / `text` = solo resumen en el input). */
+    selectionSummary?: DropdownSelectionSummary;
+    /** @deprecated Usar `selectionSummary`. */
+    selectedItemsDisplay?: DropdownSelectionSummary;
+    tagsOverflow?: DropdownTagsOverflow;
+    tagsOverflowPopoverPlacement?: 'top' | 'bottom';
+    tagsOverflowPopoverZIndex?: number;
+    tagsOverflowPopoverTitle?: string;
+    preventDeselectFromOptionsList?: boolean;
+    showTriggerClearButton?: boolean;
+}
+/** Portal, dimensiones, id y pie del panel. */
+export interface DropdownPopoverProps {
+    maxHeight?: string;
+    closeOnClickOutside?: boolean;
+    dropdownId?: string;
+    fullWidth?: boolean;
+    auto?: boolean;
+    absolute?: boolean;
+    popoverZIndex?: number;
+    footer?: boolean;
+}
+/** Modo checklist en filas del menú. */
+export interface DropdownCheckboxProps {
+    withCheckbox?: boolean;
+    checkboxSelectionTone?: ListItemCheckboxSelectionTone;
+    checkboxPosition?: 'start' | 'end';
+    checkboxListDensity?: 'default' | 'compact';
+}
+/** Variante de lista, título de filtros y panel plazas (`searchMultiCheckbox`). */
+export interface DropdownListBlockProps {
+    listVariant?: DropdownListVariant;
+    filtersTitle?: string;
+    searchMultiCheckbox?: DropdownSearchMultiCheckboxConfig;
+}
+/** Callbacks de valor, opción, check, toggle y aceptar. */
+export interface DropdownEventsProps {
+    onValueChange?: (value: string | number | (string | number)[]) => void;
+    onOptionSelect?: (option: DropdownOption) => void;
+    onCheckboxChange?: (option: DropdownOption, checked: boolean) => void;
+    onToggleChange?: (option: DropdownOption, checked: boolean) => void;
+    onHandleAccept?: (selectedOptions: DropdownOption[]) => void;
+}
+/** Estado de UI no ligado al valor (p. ej. carga en el panel). */
+export interface DropdownStatusProps {
+    loading?: boolean;
+}
+/**
+ * Props del `Dropdown`. **Preferir bloques:** `field`, `tooltip`, `slots`, `items`, `values`, `menuSearch`,
+ * `multi` (`selectionSummary`, `tagsOverflow`…), `popover`, `checkbox`, `list`, `events`, `status`; la raíz sigue admitida (compatibilidad).
+ */
+export interface DropdownProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'size' | 'onChange' | 'value' | 'defaultValue' | 'list'> {
+    field?: Partial<DropdownFieldProps>;
+    tooltip?: Partial<DropdownHintProps>;
+    slots?: Partial<DropdownSlotsProps>;
+    items?: Partial<DropdownItemsProps>;
+    values?: Partial<DropdownValuesProps>;
+    menuSearch?: Partial<DropdownMenuSearchProps>;
+    multi?: Partial<DropdownMultiProps>;
+    popover?: Partial<DropdownPopoverProps>;
+    checkbox?: Partial<DropdownCheckboxProps>;
+    list?: Partial<DropdownListBlockProps>;
+    events?: Partial<DropdownEventsProps>;
+    status?: Partial<DropdownStatusProps>;
+    /** @deprecated Usar `field.label`. */
     label?: string;
+    /** @deprecated Usar `field.error`. */
     error?: string;
+    /** @deprecated Usar `field.helperText`. */
     helperText?: string;
+    /** @deprecated Usar `tooltip.infoTooltip`. */
     infoTooltip?: string;
+    /** @deprecated Usar `field.size`. */
     size?: InputSize;
+    /** @deprecated Usar `field.color`. */
     color?: Colors;
+    /** @deprecated Usar `slots.leftSlot`. */
     leftSlot?: VisualSlotType;
+    /** @deprecated Usar `slots.rightSlot`. */
     rightSlot?: VisualSlotType;
+    /** @deprecated Usar `menuSearch.searchPlaceholder`. */
     searchPlaceholder?: string;
+    /** @deprecated Usar `menuSearch.noResultsText`. */
     noResultsText?: string;
+    /** @deprecated Usar `menuSearch.noResultsDescription`. */
     noResultsDescription?: string;
+    /** @deprecated Usar `field.caret`. */
     caret?: boolean;
     disabled?: boolean;
+    /** @deprecated Usar `values.defaultValue`. */
     defaultValue?: string | number | (string | number)[];
+    /** @deprecated Usar `field.placeholder`. */
     placeholder?: string;
+    /** @deprecated Usar `items.options`. */
     options?: DropdownOption[];
+    /** @deprecated Usar `values.value`. */
     value?: string | number | (string | number)[];
+    /** @deprecated Usar `items.valueName`. */
     valueName?: string;
+    /** @deprecated Usar `items.idName`. */
     idName?: string;
+    /** @deprecated Usar `events.onValueChange`. */
     onValueChange?: (value: string | number | (string | number)[]) => void;
+    /** @deprecated Usar `events.onOptionSelect`. */
     onOptionSelect?: (option: DropdownOption) => void;
+    /** @deprecated Usar `events.onCheckboxChange`. */
     onCheckboxChange?: (option: DropdownOption, checked: boolean) => void;
+    /** @deprecated Usar `menuSearch.searchable`. */
     searchable?: boolean;
+    /** @deprecated Usar `popover.maxHeight`. */
     maxHeight?: string;
+    /** @deprecated Usar `popover.closeOnClickOutside`. */
     closeOnClickOutside?: boolean;
+    /** @deprecated Usar `popover.dropdownId`. */
     dropdownId?: string;
+    /** @deprecated Usar `popover.fullWidth`. */
     fullWidth?: boolean;
+    /** @deprecated Usar `popover.auto`. */
     auto?: boolean;
+    /** @deprecated Usar `multi.multiple`. */
     multiple?: boolean;
+    /** @deprecated Usar `multi.maxSelectedItems`. */
     maxSelectedItems?: number;
-    selectedItemsDisplay?: 'tags' | 'count' | 'text';
-    /**
-     * Con `selectedItemsDisplay="tags"`: `wrap` (por defecto) permite varias líneas; `single-line` mantiene
-     * una sola fila dentro del ancho del control, chip `+n` para el resto y panel flotante con el listado en texto.
-     */
+    /** @deprecated Usar `multi.selectionSummary`. */
+    selectionSummary?: DropdownSelectionSummary;
+    /** @deprecated Usar `multi.selectionSummary`. */
+    selectedItemsDisplay?: DropdownSelectionSummary;
+    /** @deprecated Usar `multi.tagsOverflow`. */
     tagsOverflow?: DropdownTagsOverflow;
-    /** Con `tagsOverflow="single-line"`: `bottom` (por defecto) abre el panel bajo el chip; `top` lo abre encima. */
+    /** @deprecated Usar `multi.tagsOverflowPopoverPlacement`. */
     tagsOverflowPopoverPlacement?: 'top' | 'bottom';
-    /** Z-index del panel de tags desbordadas (por encima del menú del dropdown). */
+    /** @deprecated Usar `multi.tagsOverflowPopoverZIndex`. */
     tagsOverflowPopoverZIndex?: number;
-    /**
-     * Título de la **cabecera** del panel del chip `+n` cuando `tagsOverflow="single-line"` (texto configurable; p. ej. «Tipos de medio»).
-     * El cuerpo del panel sigue siendo una línea de texto con las etiquetas ocultas, separadas por comas.
-     */
+    /** @deprecated Usar `multi.tagsOverflowPopoverTitle`. */
     tagsOverflowPopoverTitle?: string;
-    /**
-     * Si es true, no se puede quitar una opción ya seleccionada al usar la fila/opción del menú como toggle
-     * (`handleOptionSelect`). Con `withCheckbox`, **sí** se puede desmarcar desde la casilla; también quitar
-     * desde tags del campo, «Limpiar selección», etc.
-     */
+    /** @deprecated Usar `multi.preventDeselectFromOptionsList`. */
     preventDeselectFromOptionsList?: boolean;
-    /**
-     * Muestra una X en el control para vaciar la selección y el texto de búsqueda del panel cuando aplique.
-     * Single, múltiple, tags y listas con check.
-     * @default true
-     */
+    /** @deprecated Usar `multi.showTriggerClearButton`. */
     showTriggerClearButton?: boolean;
+    /** @deprecated Usar `popover.absolute`. */
     absolute?: boolean;
-    /** Z-index del menú desplegable. Útil en tablas para que el menú quede por debajo de columnas sticky (acciones). */
+    /** @deprecated Usar `popover.popoverZIndex`. */
     popoverZIndex?: number;
+    /** @deprecated Usar `popover.footer`. */
     footer?: boolean;
+    /** @deprecated Usar `items.defaultOptionSelected`. */
     defaultOptionSelected?: boolean;
+    /** @deprecated Usar `checkbox.withCheckbox`. */
     withCheckbox?: boolean;
-    /**
-     * Con `withCheckbox`: tono de fila seleccionada. `brand` = fondo azul; `subtle` = gris suave (`ui-bg-fill-hover`), alineado a listas Figma (p. ej. selección de usuarios).
-     */
+    /** @deprecated Usar `checkbox.checkboxSelectionTone`. */
     checkboxSelectionTone?: ListItemCheckboxSelectionTone;
-    /** Con `withCheckbox`: checkbox a la izquierda (por defecto) o a la derecha (lista tipo Figma). */
+    /** @deprecated Usar `checkbox.checkboxPosition`. */
     checkboxPosition?: 'start' | 'end';
-    /** Con `withCheckbox`: lista más densa (menos padding en el panel y en cada fila). */
+    /** @deprecated Usar `checkbox.checkboxListDensity`. */
     checkboxListDensity?: 'default' | 'compact';
+    /** @deprecated Usar `values.hasCurrent`. */
     hasCurrent?: boolean;
+    /** @deprecated Usar `events.onHandleAccept`. */
     onHandleAccept?: (selectedOptions: DropdownOption[]) => void;
+    /** @deprecated Usar `slots.pill`. */
     pill?: PillSize;
-    /** Variante de lista para renderizar items del dropdown */
+    /** @deprecated Usar `list.listVariant`. */
     listVariant?: DropdownListVariant;
-    /** Callback cuando cambia un toggle (variante 'toggle') */
+    /**
+     * @deprecated Usar `list.searchMultiCheckbox`.
+     * @example
+     * ```tsx
+     * <Dropdown
+     *   list={{
+     *     listVariant: 'search-multi-checkbox',
+     *     searchMultiCheckbox: {
+     *       search: { placeholder: 'Buscar plaza…' },
+     *       header: { id: 'all-plazas', label: 'Todas las plazas' },
+     *       showClearSelection: true,
+     *     },
+     *   }}
+     *   multi={{ multiple: true }}
+     *   items={{ options }}
+     *   menuSearch={{ searchable: false }}
+     * />
+     * ```
+     */
+    searchMultiCheckbox?: DropdownSearchMultiCheckboxConfig;
+    /** @deprecated Panel: usar `list.searchMultiCheckbox` o props planas internas vía fusión. */
+    searchMultiCheckboxHeader?: {
+        id: string;
+        label: string;
+    };
+    /** @deprecated */
+    searchMultiCheckboxShowSearch?: boolean;
+    /** @deprecated */
+    searchMultiCheckboxShowClearSelection?: boolean;
+    /** @deprecated Usar `events.onToggleChange`. */
     onToggleChange?: (option: DropdownOption, checked: boolean) => void;
-    /** Título para la variante 'filters' (se muestra antes del separador) */
+    /** @deprecated Usar `list.filtersTitle`. */
     filtersTitle?: string;
-    /** Configuración del tooltip del dropdown */
+    /** @deprecated Usar `tooltip.tooltipProps`. */
     tooltipProps?: ButtonTooltipConfig;
-    /** Si true, muestra un icono de carga dentro del dropdown (en el área de opciones) */
+    /** @deprecated Usar `status.loading`. */
     loading?: boolean;
 }
 export interface DropdownRef {