@kaufmann-lab/ui 0.1.13 → 0.1.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kaufmann-lab/ui",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "description": "Shared Angular component library for the Kaufmann frontends",
   "license": "MIT",
   "author": "Kaufmann Lab",

package/types/kaufmann-lab-ui.d.ts

@@ -31,7 +31,7 @@ import { ControlValueAccessor } from '@angular/forms';
  * de vehículos; reusarlo para "fijar" generaría ambigüedad con los markers
  * de mapa.
  */
-type IconName = 'activity' | 'alert-circle' | 'alert-octagon' | 'alert-triangle' | 'award' | 'bar-chart' | 'bell' | 'bus' | 'calculator' | 'calendar' | 'car' | 'cart' | 'check' | 'check-circle' | 'check-square' | 'chevron-down' | 'chevron-left' | 'chevron-left-bar' | 'chevron-right' | 'clipboard' | 'clock' | 'credit-card' | 'crosshair' | 'download' | 'edit' | 'external-link' | 'eye' | 'eye-off' | 'file' | 'filter' | 'gauge' | 'gift' | 'grid' | 'history' | 'home' | 'inbox' | 'layers' | 'list' | 'log-out' | 'map' | 'map-pin' | 'maximize' | 'menu' | 'message-circle' | 'mic' | 'mic-off' | 'minimize' | 'minus' | 'monitor' | 'more-vertical' | 'navigation' | 'pause' | 'phone' | 'pin' | 'play' | 'plus' | 'search' | 'settings' | 'shield-check' | 'sort' | 'star' | 'ticket' | 'tool' | 'trash' | 'truck' | 'upload-cloud' | 'user' | 'user-search' | 'video' | 'x' | 'zap';
+type IconName = 'activity' | 'alert-circle' | 'alert-octagon' | 'alert-triangle' | 'award' | 'bar-chart' | 'bell' | 'bus' | 'calculator' | 'calendar' | 'car' | 'cart' | 'check' | 'check-circle' | 'check-square' | 'chevron-down' | 'chevron-left' | 'chevron-left-bar' | 'chevron-right' | 'clipboard' | 'clock' | 'credit-card' | 'crosshair' | 'download' | 'edit' | 'external-link' | 'eye' | 'eye-off' | 'file' | 'filter' | 'gauge' | 'gift' | 'grid' | 'history' | 'home' | 'inbox' | 'layers' | 'list' | 'log-out' | 'mail' | 'map' | 'map-pin' | 'maximize' | 'menu' | 'message-circle' | 'mic' | 'mic-off' | 'minimize' | 'minus' | 'monitor' | 'more-vertical' | 'navigation' | 'pause' | 'phone' | 'pin' | 'play' | 'plus' | 'search' | 'settings' | 'shield-check' | 'sort' | 'star' | 'ticket' | 'tool' | 'trash' | 'truck' | 'upload-cloud' | 'user' | 'user-search' | 'video' | 'x' | 'zap';
 
 type IconSize = 'sm' | 'md' | 'lg';
 /** Ángulos de rotación soportados por `rotate` — cubre los casos reales del
@@ -724,6 +724,39 @@ declare class CompanySelector {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<CompanySelector, "kf-company-selector", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "companies": { "alias": "companies"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "meta": { "alias": "meta"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
 }
 
+/**
+ * Popover de "Datos de contacto" de una persona (asesor, ejecutivo — nombre
+ * genérico a propósito, sin lógica de negocio de ninguna pantalla concreta
+ * adentro). Cada canal (`whatsapp`/`phone`/`email`) se muestra SOLO si
+ * viene con dato — nunca los 3 fijos — y si ninguno viene, un estado vacío
+ * explícito en vez de un panel a medio llenar. Mismo criterio que ya
+ * resolvía `sitio-privado-one-way-frontend` (repo hermano de Chile) para
+ * el asesor de taller, ahora como pieza compartida del design system.
+ *
+ *   <kf-contact-popover
+ *     [name]="advisor.name"
+ *     [whatsapp]="advisor.whatsapp"
+ *     [phone]="advisor.phone"
+ *     [email]="advisor.email"
+ *   />
+ */
+declare class ContactPopover {
+    readonly name: _angular_core.InputSignal<string>;
+    readonly title: _angular_core.InputSignal<string>;
+    readonly whatsapp: _angular_core.InputSignal<string | null>;
+    readonly phone: _angular_core.InputSignal<string | null>;
+    readonly email: _angular_core.InputSignal<string | null>;
+    protected readonly open: _angular_core.WritableSignal<boolean>;
+    protected readonly whatsappHref: _angular_core.Signal<string | null>;
+    protected readonly phoneHref: _angular_core.Signal<string | null>;
+    protected readonly emailHref: _angular_core.Signal<string | null>;
+    protected readonly hasContactMethods: _angular_core.Signal<boolean>;
+    protected onToggle(): void;
+    protected onClose(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ContactPopover, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ContactPopover, "kf-contact-popover", never, { "name": { "alias": "name"; "required": true; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "whatsapp": { "alias": "whatsapp"; "required": false; "isSignal": true; }; "phone": { "alias": "phone"; "required": false; "isSignal": true; }; "email": { "alias": "email"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
 /**
  * Marcador genérico para contenido aún por definir (página 38) — comunica
  * "contenido disponible para uso" sin parecer un error, a diferencia de
@@ -1380,8 +1413,15 @@ declare class DropdownItem {
     readonly tone: _angular_core.InputSignal<DropdownItemTone>;
     /** Ícono opcional al inicio de la fila. */
     readonly icon: _angular_core.InputSignal<IconName | undefined>;
+    /**
+     * Deshabilita el ítem (ej. una acción cuyo endpoint todavía no existe,
+     * caso real de "Factura" en `kf-row-actions` de Taller). Default `false`
+     * a propósito — ningún consumidor existente (ej. el menú de sesión del
+     * Shell) pasa esta prop hoy, así que no cambia su comportamiento.
+     */
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DropdownItem, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DropdownItem, "kf-dropdown-item", never, { "tone": { "alias": "tone"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DropdownItem, "kf-dropdown-item", never, { "tone": { "alias": "tone"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
 type DropdownPanelVariant = 'solid' | 'dark';
@@ -2885,6 +2925,11 @@ declare class Modal {
     readonly open: _angular_core.ModelSignal<boolean>;
     /** Permite cerrar con el botón, `Escape` o clic en el backdrop. */
     readonly dismissible: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Ancho por defecto: `480px` (sin pasar nada). Un modal con contenido
+     *  tabular/ancho (ej. una lista de varios campos por fila) puede pedir
+     *  más, ej. `width="720px"` — sigue topeado por `100vw` en pantallas
+     *  angostas, mismo `min()` de siempre. */
+    readonly width: _angular_core.InputSignal<string | null>;
     protected readonly titleId: string;
     private readonly dialog;
     private readonly document;
@@ -2903,7 +2948,7 @@ declare class Modal {
      */
     protected onHostClick(event: MouseEvent): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<Modal, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<Modal, "kf-modal", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; "dismissible": { "alias": "dismissible"; "required": false; "isSignal": true; }; }, { "open": "openChange"; }, never, ["*", "[footer]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<Modal, "kf-modal", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; "dismissible": { "alias": "dismissible"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; }, { "open": "openChange"; }, never, ["*", "[footer]"], true, never>;
 }
 
 /** Color de la franja izquierda y del fondo. */
@@ -3510,6 +3555,59 @@ declare class ReserveBlock {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ReserveBlock, "kf-reserve-block", never, { "emptyLabel": { "alias": "emptyLabel"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": true; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "actionLabel": { "alias": "actionLabel"; "required": false; "isSignal": true; }; "actionHref": { "alias": "actionHref"; "required": false; "isSignal": true; }; "grow": { "alias": "grow"; "required": false; "isSignal": true; }; }, {}, never, ["[actions]"], true, never>;
 }
 
+type RowActionKind = 'link' | 'button';
+/**
+ * Una acción de fila — mismo shape que ya usaba `WorkshopRowAction` en
+ * `web-portal-latam-frontend` antes de este componente (Taller, tab
+ * "Trabajos terminados"), ahora compartido: `kind: 'link'` navega (necesita
+ * `href`, `onClick` se ignora), `kind: 'button'` dispara `onClick` en la
+ * pantalla actual. `disabled` aplica a ambos — un link sin `href` (o
+ * explícitamente `disabled`) se renderiza inerte en vez de clickeable, en
+ * vez de omitirse del todo: el consumidor decide que la acción EXISTE pero
+ * no está disponible todavía (ej. "Factura" mientras no exista el endpoint
+ * de descarga).
+ */
+interface RowAction {
+    readonly kind: RowActionKind;
+    readonly icon: IconName;
+    readonly label: string;
+    readonly href?: string | null;
+    readonly disabled?: boolean;
+    readonly onClick?: () => void;
+}
+type RowActionsMode = 'auto' | 'inline' | 'menu';
+/**
+ * Columna "Acciones" de cualquier tabla del ecosistema. Decide su propia
+ * forma según cuántas acciones recibe — no hace falta que cada tabla elija
+ * a mano entre "botones sueltos" y "menú":
+ *
+ * - `inline` (`actions().length <= inlineLimit()`, default 2): un
+ *   ícono-botón de 32px por acción, sin texto — el `label` vive en un
+ *   `kfTooltip`. Todas las acciones quedan visibles sin clic extra.
+ * - `menu` (más de `inlineLimit()`): un único botón "kebab" que abre un
+ *   `kf-dropdown-panel` con una fila por acción.
+ *
+ * `mode` fuerza uno de los dos modos sin importar cuántas acciones haya
+ * (ej. una tabla que prefiere el kebab siempre, aunque tenga una sola
+ * acción, por consistencia visual con otra columna).
+ *
+ *   <kf-row-actions [actions]="rowActions(row)" />
+ *   <kf-row-actions [actions]="rowActions(row)" mode="menu" />
+ */
+declare class RowActions {
+    readonly actions: _angular_core.InputSignal<readonly RowAction[]>;
+    readonly mode: _angular_core.InputSignal<RowActionsMode>;
+    /** Desde cuántas acciones el modo `auto` pasa de `inline` a `menu`. */
+    readonly inlineLimit: _angular_core.InputSignal<number>;
+    protected readonly menuOpen: _angular_core.WritableSignal<boolean>;
+    protected readonly effectiveMode: _angular_core.Signal<"menu" | "inline">;
+    protected onToggleMenu(): void;
+    protected onButtonAction(action: RowAction): void;
+    protected onMenuLinkClick(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<RowActions, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<RowActions, "kf-row-actions", never, { "actions": { "alias": "actions"; "required": true; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "inlineLimit": { "alias": "inlineLimit"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
 /**
  * Título de sub-sección con chip de ícono, pensado para anidarse dentro de
  * cards o paneles (a diferencia de `PageHeader`, que encabeza una página
@@ -4518,5 +4616,5 @@ declare class ViewToggle {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ViewToggle, "kf-view-toggle", never, { "view": { "alias": "view"; "required": true; "isSignal": true; }; }, { "viewChange": "viewChange"; }, never, never, true, never>;
 }
 
-export { ActionTile, AdminBadge, Alert, AlertRow, AuthLayout, AuthLayoutSso, Avatar, Badge, Breadcrumb, BucketProgress, Button, Card, Carousel, CarouselSlide, Checkbox, Chip, Collapsible, CompanySelector, ContentSlot, ContentState, ContentViewer, DEFAULT_PAGE_SIZE_OPTIONS, DataTable, Divider, DocumentRow, Drawer, DrawerLogout, DrawerSession, Dropdown, DropdownItem, DropdownPanel, EmptyState, EventTimeline, FeatureCard, Field, FieldLabel, Filter, FilterChips, FolderTabs, FolderTabsPanel, Footer, FormatInputDirective, Icon, Input, JourneyStepper, Link, MAP_CONFIG, MapControls, MapView, MetricCard, MobileFooter, MobileHeader, Modal, MultiSelect, NoteBlock, PageHeader, Pagination, Panel, PortalHeader, Progress, PulseDot, QuotePicker, ReserveBlock, STYLE_BY_THEME, SectionHeader, SectionNav, SectionNavItem, SectionNavSubsection, Segmented, Select, SelectableCardGroup, SidebarShell, Skeleton, Spinner, SsoButton, StatCard, StatTile, StatusPill, THEME_LABEL, THEME_ORDER, Tabs, Text, Textarea, TileGrid, ToastHost, ToastService, TooltipDirective, VehicleHeader, ViewToggle, dataTableViewSignal, formatChileanRut, formatClockTime, formatCurrency, formatNumber, isValidChileanRut, matchMediaSignal, parseCurrency, parseNumber, provideMapConfig, sanitizeDocumentId };
-export type { AlertRowTone, AlertTone, AuthLayoutBackground, BreadcrumbItem, BucketProgressItem, CompanySelectorMeta, ContentStateKind, ContentStateLoad, ContentViewerType, DataTableCardRole, DataTableColumn, DataTableDensity, DataTableSort, DataTableView, DividerOrientation, DocumentRowTone, DrawerSide, DropdownItemTone, DropdownPanelVariant, EventTimelineItem, EventTimelineTone, FilterFieldChange, FilterFieldConfig, FilterFieldType, FilterValue, FolderTabOption, FooterLink, FormatCurrencyOptions, FormatNumberOptions, IconName, IconRotation, IconSize, JourneyStep, JourneyStepStatus, JourneyStepperColorScheme, JourneyStepperSurface, LinkVariant, MapConfig, MapControlKind, MapLatLng, MapMarker, MapMarkerTone, MapPopupAction, MapSize, MapTheme, MapVariant, MultiSelectOption, NoteBlockTone, PageHeaderTitleSize, PaginationItem, PortalHeaderAdminAction, PortalHeaderNavItem, ProgressTone, QuotePickerChip, QuotePickerSortOption, SectionNavSubsectionData, SegmentedOption, SelectableCardOption, SidebarNavItemData, SkeletonVariant, SpinnerSize, SsoProvider, StatCardTone, StatTileTone, StatTileVariant, TabOption, TextAs, TextTone, TextVariant, ToastAction, ToastOptions, ToastPromiseMessages, ToastState, ToastTone, TooltipPosition, VehicleHeaderStatus, ViewToggleOption };
+export { ActionTile, AdminBadge, Alert, AlertRow, AuthLayout, AuthLayoutSso, Avatar, Badge, Breadcrumb, BucketProgress, Button, Card, Carousel, CarouselSlide, Checkbox, Chip, Collapsible, CompanySelector, ContactPopover, ContentSlot, ContentState, ContentViewer, DEFAULT_PAGE_SIZE_OPTIONS, DataTable, Divider, DocumentRow, Drawer, DrawerLogout, DrawerSession, Dropdown, DropdownItem, DropdownPanel, EmptyState, EventTimeline, FeatureCard, Field, FieldLabel, Filter, FilterChips, FolderTabs, FolderTabsPanel, Footer, FormatInputDirective, Icon, Input, JourneyStepper, Link, MAP_CONFIG, MapControls, MapView, MetricCard, MobileFooter, MobileHeader, Modal, MultiSelect, NoteBlock, PageHeader, Pagination, Panel, PortalHeader, Progress, PulseDot, QuotePicker, ReserveBlock, RowActions, STYLE_BY_THEME, SectionHeader, SectionNav, SectionNavItem, SectionNavSubsection, Segmented, Select, SelectableCardGroup, SidebarShell, Skeleton, Spinner, SsoButton, StatCard, StatTile, StatusPill, THEME_LABEL, THEME_ORDER, Tabs, Text, Textarea, TileGrid, ToastHost, ToastService, TooltipDirective, VehicleHeader, ViewToggle, dataTableViewSignal, formatChileanRut, formatClockTime, formatCurrency, formatNumber, isValidChileanRut, matchMediaSignal, parseCurrency, parseNumber, provideMapConfig, sanitizeDocumentId };
+export type { AlertRowTone, AlertTone, AuthLayoutBackground, BreadcrumbItem, BucketProgressItem, CompanySelectorMeta, ContentStateKind, ContentStateLoad, ContentViewerType, DataTableCardRole, DataTableColumn, DataTableDensity, DataTableSort, DataTableView, DividerOrientation, DocumentRowTone, DrawerSide, DropdownItemTone, DropdownPanelVariant, EventTimelineItem, EventTimelineTone, FilterFieldChange, FilterFieldConfig, FilterFieldType, FilterValue, FolderTabOption, FooterLink, FormatCurrencyOptions, FormatNumberOptions, IconName, IconRotation, IconSize, JourneyStep, JourneyStepStatus, JourneyStepperColorScheme, JourneyStepperSurface, LinkVariant, MapConfig, MapControlKind, MapLatLng, MapMarker, MapMarkerTone, MapPopupAction, MapSize, MapTheme, MapVariant, MultiSelectOption, NoteBlockTone, PageHeaderTitleSize, PaginationItem, PortalHeaderAdminAction, PortalHeaderNavItem, ProgressTone, QuotePickerChip, QuotePickerSortOption, RowAction, RowActionKind, RowActionsMode, SectionNavSubsectionData, SegmentedOption, SelectableCardOption, SidebarNavItemData, SkeletonVariant, SpinnerSize, SsoProvider, StatCardTone, StatTileTone, StatTileVariant, TabOption, TextAs, TextTone, TextVariant, ToastAction, ToastOptions, ToastPromiseMessages, ToastState, ToastTone, TooltipPosition, VehicleHeaderStatus, ViewToggleOption };