@tekus/design-system 5.33.1 → 5.35.0

package/types/tekus-design-system-components-process-steps.d.ts

@@ -0,0 +1,57 @@
+import * as _angular_core from '@angular/core';
+
+type StepState = 'waiting' | 'active' | 'done' | 'error' | 'warning';
+interface ProcessStep {
+    label: string;
+    state: StepState;
+}
+/**
+ * Overall result of the process:
+ * - `progress`: shows the spinner header and the step list.
+ * - `success` | `error` | `warning`: replaces the progress view with a
+ *   final result message (used once polling finishes).
+ */
+type ProcessStepsStatus = 'progress' | 'success' | 'error' | 'warning';
+
+declare class ProcessStepsComponent {
+    readonly steps: _angular_core.InputSignal<ProcessStep[]>;
+    readonly title: _angular_core.InputSignal<string>;
+    readonly description: _angular_core.InputSignal<string | undefined>;
+    readonly icon: _angular_core.InputSignal<string>;
+    readonly status: _angular_core.InputSignal<ProcessStepsStatus>;
+    /** Specific problems to list inside the result message box (ignored when `status` is `success`). */
+    readonly errors: _angular_core.InputSignal<string[]>;
+    /** Seconds until the countdown finishes; omit to disable it. */
+    readonly countdownSeconds: _angular_core.InputSignal<number | undefined>;
+    /**
+     * Countdown text; `{seconds}` is replaced with the seconds left. Defaults to a "closing"
+     * message, but the countdown isn't only for closing — override it to match what
+     * `(countdownFinished)` actually does.
+     */
+    readonly countdownLabel: _angular_core.InputSignal<string>;
+    /** Emitted once when the countdown reaches zero — the consumer decides what happens next (close a modal, show a toast, etc.). */
+    readonly countdownFinished: _angular_core.OutputEmitterRef<void>;
+    /** Seconds left in the countdown, or `undefined` while it's disabled. */
+    readonly remainingSeconds: _angular_core.WritableSignal<number | undefined>;
+    constructor();
+    /** Starts (or disables) the countdown whenever `status`/`countdownSeconds` change. */
+    private runCountdown;
+    /** Decrements `remainingSeconds` by one and emits `countdownFinished` once it bottoms out. */
+    private tickCountdown;
+    /**
+     * Accessible suffix announced per step since state is otherwise
+     * conveyed only through color/icon.
+     */
+    stepStatusLabel(state: StepState): string;
+    readonly resultIcon: _angular_core.Signal<string>;
+    readonly resultColor: _angular_core.Signal<"warning" | "success" | "danger">;
+    /** Severity for the message box wrapping `description`/`errors` (success has no box). */
+    readonly resultMessageSeverity: _angular_core.Signal<"error" | "warn">;
+    /** `countdownLabel` with `{seconds}` filled in, or `undefined` while the countdown is disabled. */
+    readonly countdownText: _angular_core.Signal<string | undefined>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ProcessStepsComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ProcessStepsComponent, "tk-process-steps", never, { "steps": { "alias": "steps"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": true; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "countdownSeconds": { "alias": "countdownSeconds"; "required": false; "isSignal": true; }; "countdownLabel": { "alias": "countdownLabel"; "required": false; "isSignal": true; }; }, { "countdownFinished": "countdownFinished"; }, never, never, true, never>;
+}
+
+export { ProcessStepsComponent };
+export type { ProcessStep, ProcessStepsStatus, StepState };

package/types/tekus-design-system-components-table.d.ts

@@ -97,7 +97,11 @@ declare class TableComponent<T = unknown> {
     /** Tracks which column's filter overlay is currently open */
     readonly activeFilterColumn: _angular_core.WritableSignal<string | null>;
     /** Stores the selected filter value per column field (null = no filter) */
-    readonly columnFilters: _angular_core.WritableSignal<Record<string, string | null>>;
+    readonly columnFilters: _angular_core.ModelSignal<Record<string, string | null>>;
+    /** Two-way bindable signal for the active sort field */
+    readonly sortField: _angular_core.ModelSignal<string | null>;
+    /** Two-way bindable signal for the active sort order (1 for asc, -1 for desc) */
+    readonly sortOrder: _angular_core.ModelSignal<1 | -1 | null>;
     /** Position of the filter overlay (fixed, relative to viewport) */
     readonly filterOverlayPosition: _angular_core.WritableSignal<{
         top: number;
@@ -221,7 +225,7 @@ declare class TableComponent<T = unknown> {
      */
     onImageError(event: Event, fallback?: string): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TableComponent<any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TableComponent<any>, "tk-table", never, { "data": { "alias": "data"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "selectionMode": { "alias": "selectionMode"; "required": false; "isSignal": true; }; "selection": { "alias": "selection"; "required": false; "isSignal": true; }; "dataKey": { "alias": "dataKey"; "required": false; "isSignal": true; }; }, { "selection": "selectionChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TableComponent<any>, "tk-table", never, { "data": { "alias": "data"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "selectionMode": { "alias": "selectionMode"; "required": false; "isSignal": true; }; "selection": { "alias": "selection"; "required": false; "isSignal": true; }; "dataKey": { "alias": "dataKey"; "required": false; "isSignal": true; }; "columnFilters": { "alias": "columnFilters"; "required": false; "isSignal": true; }; "sortField": { "alias": "sortField"; "required": false; "isSignal": true; }; "sortOrder": { "alias": "sortOrder"; "required": false; "isSignal": true; }; }, { "selection": "selectionChange"; "columnFilters": "columnFiltersChange"; "sortField": "sortFieldChange"; "sortOrder": "sortOrderChange"; }, never, never, true, never>;
 }
 
 export { TableComponent };

package/types/tekus-design-system-components-toolbar.d.ts

@@ -1,156 +1,243 @@
 import * as _angular_core from '@angular/core';
+import { MenuItem } from 'primeng/api';
+import { Popover } from 'primeng/popover';
+import { TkAction } from '@tekus/design-system/components/action-group';
+import { MultiSelectOption } from '@tekus/design-system/components/multiselect';
+import { ButtonSeverity, Variant } from '@tekus/design-system/components/button';
+
+/**
+ * Configuration for a toolbar filter item.
+ */
+interface TkToolbarFilterConfig {
+    key: string;
+    label: string;
+    options: MultiSelectOption[];
+}
+/**
+ * Definition for toolbar selection or mass actions.
+ */
+interface TkToolbarAction {
+    icon?: string;
+    label: string;
+    action: () => void;
+    disabled?: boolean;
+    severity?: ButtonSeverity;
+    variant?: Variant;
+}
 
 declare class ToolbarComponent {
+    private readonly breakpointObserver;
+    /** Responsive flag using BreakpointObserver */
+    isMobile: _angular_core.Signal<boolean>;
     /**
-     * @property {ModelSignal<string>} searchModel
-     * @description
      * Two-way bindable signal for the search input value.
-     * Supports [(searchModel)]="variable" syntax for two-way binding.
-     * @default ''
      */
     searchModel: _angular_core.ModelSignal<string>;
     /**
-     * @property {ModelSignal<Record<string, string> | null>} filterModel
-     * @description
-     * Two-way bindable signal for the filter select value.
-     * Supports [(filterModel)]="variable" syntax for two-way binding.
-     * @default null
+     * Label/placeholder text displayed inside the search input.
+     * @default 'Buscar'
      */
-    filterModel: _angular_core.ModelSignal<Record<string, string> | null>;
+    searchFloatLabel: _angular_core.InputSignal<string>;
     /**
-     * @property {WritableSignal<boolean>} showSearchInput
-     * @description
-     * Controls the visibility of the search input. Toggles when the search button is clicked.
-     * @default false
+     * Controls the visibility of the search input field.
+     * @default true
+     */
+    searchVisible: _angular_core.InputSignal<boolean>;
+    /**
+     * Two-way bindable signal for the layout view toggle ('table' or 'cards').
+     * @default 'table'
      */
-    showSearchInput: _angular_core.WritableSignal<boolean>;
+    view: _angular_core.ModelSignal<"table" | "cards">;
     /**
-     * @property {WritableSignal<boolean>} showFilterSelect
-     * @description
-     * Controls the visibility of the filter select. Toggles when the filter button is clicked.
+     * Controls the visibility of the layout view toggle button.
      * @default false
      */
-    showFilterSelect: _angular_core.WritableSignal<boolean>;
-    /**
-     * @property {InputSignal<Array<{ label: string; value: string }>>} filterOptions
-     * @description
-     * Array of options available in the filter select dropdown.
-     * Each option is an object with `label` (displayed text) and `value` (internal identifier).
-     *
-     * @default
-     * [
-     *   { label: 'Option 1', value: 'option1' },
-     *   { label: 'Option 2', value: 'option2' },
-     *   { label: 'Option 3', value: 'option3' }
-     * ]
-     */
-    filterOptions: _angular_core.InputSignal<{
-        label: string;
-        value: string;
-    }[]>;
+    viewToggleVisible: _angular_core.InputSignal<boolean>;
     /**
-     * @property {InputSignal<string>} filterOptionLabel
-     * @description
-     * Property name used to display the label in the select dropdown options.
-     * This corresponds to the key in each option object that contains the display text.
-     *
-     * @default 'label'
+     * Dynamic list of filters and their available selection options.
+     * @default []
      */
+    filters: _angular_core.InputSignal<TkToolbarFilterConfig[]>;
+    /** Backwards compatibility: Writable model signal for the selected option in a single filter select (deprecated) */
+    filterModel: _angular_core.ModelSignal<Record<string, string> | null>;
+    /** Backwards compatibility: Input for dropdown options (deprecated) */
+    filterOptions: _angular_core.InputSignal<any[]>;
+    /** Backwards compatibility: Input for the option label key (deprecated) */
     filterOptionLabel: _angular_core.InputSignal<string>;
+    /** Backwards compatibility: Input for the label of the single select dropdown (deprecated) */
+    filterFloatLabel: _angular_core.InputSignal<string>;
+    /** Backwards compatibility: Controls whether filter button is shown (deprecated) */
+    filterVisible: _angular_core.InputSignal<boolean>;
     /**
-     * @property {InputSignal<string>} filterFloatLabel
-     * @description
-     * Label text displayed above the filter select input using the FloatLabel wrapper.
-     * This is the placeholder/label that floats when the select is focused or has a value.
-     *
-     * @default 'Filtrar'
+     * Two-way bindable signal for currently selected filter values.
+     * Format: { [filterKey]: MultiSelectOption[] }
+     * @default {}
      */
-    filterFloatLabel: _angular_core.InputSignal<string>;
+    filterValues: _angular_core.ModelSignal<Record<string, MultiSelectOption[]>>;
     /**
-     * @property {InputSignal<string>} searchFloatLabel
-     * @description
-     * Label text displayed above the search input using the FloatLabel wrapper.
-     * This is the placeholder/label that floats when the search input is focused or has a value.
-     *
-     * @default 'Buscar'
+     * Label/text for the clear button.
+     * @default 'Limpiar'
      */
-    searchFloatLabel: _angular_core.InputSignal<string>;
+    clearLabel: _angular_core.InputSignal<string>;
     /**
-     * @property {InputSignal<boolean>} searchVisible
-     * @description
-     * Controls the visibility of the search button.
-     * @default true
+     * Label/text for the delete action button.
+     * @default 'Eliminar'
      */
-    searchVisible: _angular_core.InputSignal<boolean>;
+    deleteLabel: _angular_core.InputSignal<string>;
     /**
-     * @property {InputSignal<boolean>} filterVisible
-     * @description
-     * Controls the visibility of the filter button.
-     * @default true
+     * Label/text for the filters header.
+     * @default 'Filtros'
      */
-    filterVisible: _angular_core.InputSignal<boolean>;
+    filterLabel: _angular_core.InputSignal<string>;
+    /** Label for selected item singular form (e.g. 'seleccionado') */
+    selectedLabel: _angular_core.InputSignal<string>;
+    /** Label for selected item plural form (e.g. 'seleccionados') */
+    selectedPluralLabel: _angular_core.InputSignal<string>;
+    /** Label/text for the apply button in overlays (e.g. 'Aplicar') */
+    applyLabel: _angular_core.InputSignal<string>;
+    /** Tooltip text for the reload action button (e.g. 'Actualizar') */
+    reloadTooltip: _angular_core.InputSignal<string>;
+    /** Tooltip text for the sort action button (e.g. 'Ordenar') */
+    sortTooltip: _angular_core.InputSignal<string>;
+    /** Tooltip text for view cards layout button (e.g. 'Vista tarjeta') */
+    viewCardsTooltip: _angular_core.InputSignal<string>;
+    /** Tooltip text for view table layout button (e.g. 'Vista tabla') */
+    viewTableTooltip: _angular_core.InputSignal<string>;
+    /**
+     * Available list of sorting options.
+     * @default []
+     */
+    sortOptions: _angular_core.InputSignal<{
+        label: string;
+        value: string;
+    }[]>;
+    /**
+     * Label/text for the sorting header.
+     * @default 'Ordenar por'
+     */
+    sortLabel: _angular_core.InputSignal<string>;
+    /**
+     * Two-way bindable signal for the active sort option value.
+     * @default null
+     */
+    sortValue: _angular_core.ModelSignal<string | null>;
     /**
-     * @property {InputSignal<boolean>} reloadVisible
-     * @description
      * Controls the visibility of the reload button.
      * @default false
      */
     reloadVisible: _angular_core.InputSignal<boolean>;
     /**
-     * @property {InputSignal<number | null>} reloadInterval
-     * @description
      * Sets the interval for automatic reload in milliseconds.
      * If null, automatic reload is disabled.
      * @default null
      */
     reloadInterval: _angular_core.InputSignal<number | null>;
     /**
-     * @property {InputSignal<boolean>} loading
-     * @description
      * Controls the loading state of the reload button, triggering a rotation animation.
      * @default false
      */
     loading: _angular_core.InputSignal<boolean>;
     /**
-     * @property {OutputEmitter<void>} reload
-     * @description
-     * Emits an event when the reload button is clicked or the automatic interval is reached.
+     * Secondary or mass actions collapsed into the tk-action-group dropdown.
+     * @default []
      */
-    reload: _angular_core.OutputEmitterRef<void>;
+    globalActions: _angular_core.InputSignal<TkAction[]>;
     /**
-     * @method constructor
-     * @description
-     * Initializes the automatic reload logic using a declarative RxJS approach.
+     * Number of items selected in the list.
+     * @default 0
      */
-    constructor();
+    selectionCount: _angular_core.InputSignal<number>;
+    /**
+     * Two-way bindable signal for checking/unchecking the select-all checkbox.
+     * @default false
+     */
+    allSelected: _angular_core.ModelSignal<boolean>;
     /**
-     * @method toggleSearchInput
-     * @description
-     * Toggles the visibility of the search input field.
+     * Two-way bindable signal for the indeterminate state of the select-all checkbox.
+     * @default false
      */
-    toggleSearchInput(): void;
+    indeterminate: _angular_core.ModelSignal<boolean>;
     /**
-     * @method toggleFilterSelect
-     * @description
-     * Toggles the visibility of the filter select dropdown.
+     * Actions available when one or more items are selected.
+     * @default []
      */
-    toggleFilterSelect(): void;
+    selectionActions: _angular_core.InputSignal<TkToolbarAction[]>;
     /**
-     * @method onSelectedOption
-     * @description
-     * Handles filter select changes and updates the filterModel signal.
-     *
-     * @param value - Selected option value from tk-select
+     * Maximum number of selection action buttons visible directly before grouping the rest.
+     * @default 1
      */
-    onSelectedOption(value: Record<string, string> | null): void;
+    maxVisibleSelectionActions: _angular_core.InputSignal<number>;
     /**
-     * @method onReload
-     * @description
-     * Emits the reload event.
+     * Emits an event when the reload button is clicked or the automatic interval is reached.
      */
+    reload: _angular_core.OutputEmitterRef<void>;
+    /**
+     * Emits when filters are applied.
+     */
+    appliedFilters: _angular_core.OutputEmitterRef<Record<string, MultiSelectOption[]>>;
+    /**
+     * Emits when sorting changes.
+     */
+    appliedSort: _angular_core.OutputEmitterRef<string | null>;
+    /** Temporary filter values held before the user clicks "Aplicar" */
+    tempFilterValues: _angular_core.WritableSignal<Record<string, MultiSelectOption[]>>;
+    /** Temporary sort value held before the user clicks "Aplicar" in mobile drawer */
+    tempSortValue: _angular_core.WritableSignal<string | null>;
+    /** Controls visibility of mobile drawers */
+    showFilterDrawer: _angular_core.WritableSignal<boolean>;
+    showSortDrawer: _angular_core.WritableSignal<boolean>;
+    filterPopover: _angular_core.Signal<Popover | undefined>;
+    sortPopover: _angular_core.Signal<Popover | undefined>;
+    /** Computes whether any filters are currently active */
+    hasActiveFilters: _angular_core.Signal<boolean>;
+    /** Computes whether sorting is active */
+    hasActiveSort: _angular_core.Signal<boolean>;
+    /** Reload button visibility: only visible if reload is allowed AND filters or sorting is active */
+    shouldShowReload: _angular_core.Signal<boolean>;
+    /** Computes the final filters configuration, adapting old filterOptions format to the new filters schema */
+    derivedFilters: _angular_core.Signal<TkToolbarFilterConfig[]>;
+    /** Active chips representing individual filter selections */
+    activeChips: _angular_core.Signal<{
+        filterKey: string;
+        code: string;
+        label: string;
+    }[]>;
+    /** Visibility of the active filters bar (below tools) */
+    shouldShowActiveFiltersBar: _angular_core.Signal<boolean>;
+    /** Visible selection actions as buttons */
+    visibleSelectionActions: _angular_core.Signal<TkToolbarAction[]>;
+    /** Overflow selection actions as menu items for dropdown */
+    overflowSelectionActions: _angular_core.Signal<MenuItem[]>;
+    constructor();
+    /** Toggles filters overlay and initializes temporary state */
+    openFilters(event: Event): void;
+    /** Updates temporary filter values for a specific filter key */
+    onTempFilterChange(key: string, value: MultiSelectOption[]): void;
+    /** Saves temporary filter selections and triggers apply */
+    applyFilters(): void;
+    /** Clears temporary filters inside popover/drawer */
+    clearTempFilters(): void;
+    /** Clears all applied filters */
+    clearAllFilters(): void;
+    /** Removes a single filter chip */
+    removeChip(chip: {
+        filterKey: string;
+        code: string;
+    }): void;
+    /** Toggles sorting overlay */
+    openSort(event: Event): void;
+    /** Selects a sort option (toggles if already selected) and hides overlay */
+    selectSortOption(value: string, isMobileDrawer?: boolean): void;
+    /** Toggles temporary sorting selection on mobile drawer */
+    toggleSortOptionMobile(value: string): void;
+    /** Applies selected sorting on mobile */
+    applySortMobile(): void;
+    /** Toggle layout view */
+    toggleView(): void;
     onReload(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ToolbarComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ToolbarComponent, "tk-toolbar", never, { "searchModel": { "alias": "searchModel"; "required": false; "isSignal": true; }; "filterModel": { "alias": "filterModel"; "required": false; "isSignal": true; }; "filterOptions": { "alias": "filterOptions"; "required": false; "isSignal": true; }; "filterOptionLabel": { "alias": "filterOptionLabel"; "required": false; "isSignal": true; }; "filterFloatLabel": { "alias": "filterFloatLabel"; "required": false; "isSignal": true; }; "searchFloatLabel": { "alias": "searchFloatLabel"; "required": false; "isSignal": true; }; "searchVisible": { "alias": "searchVisible"; "required": false; "isSignal": true; }; "filterVisible": { "alias": "filterVisible"; "required": false; "isSignal": true; }; "reloadVisible": { "alias": "reloadVisible"; "required": false; "isSignal": true; }; "reloadInterval": { "alias": "reloadInterval"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; }, { "searchModel": "searchModelChange"; "filterModel": "filterModelChange"; "reload": "reload"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ToolbarComponent, "tk-toolbar", never, { "searchModel": { "alias": "searchModel"; "required": false; "isSignal": true; }; "searchFloatLabel": { "alias": "searchFloatLabel"; "required": false; "isSignal": true; }; "searchVisible": { "alias": "searchVisible"; "required": false; "isSignal": true; }; "view": { "alias": "view"; "required": false; "isSignal": true; }; "viewToggleVisible": { "alias": "viewToggleVisible"; "required": false; "isSignal": true; }; "filters": { "alias": "filters"; "required": false; "isSignal": true; }; "filterModel": { "alias": "filterModel"; "required": false; "isSignal": true; }; "filterOptions": { "alias": "filterOptions"; "required": false; "isSignal": true; }; "filterOptionLabel": { "alias": "filterOptionLabel"; "required": false; "isSignal": true; }; "filterFloatLabel": { "alias": "filterFloatLabel"; "required": false; "isSignal": true; }; "filterVisible": { "alias": "filterVisible"; "required": false; "isSignal": true; }; "filterValues": { "alias": "filterValues"; "required": false; "isSignal": true; }; "clearLabel": { "alias": "clearLabel"; "required": false; "isSignal": true; }; "deleteLabel": { "alias": "deleteLabel"; "required": false; "isSignal": true; }; "filterLabel": { "alias": "filterLabel"; "required": false; "isSignal": true; }; "selectedLabel": { "alias": "selectedLabel"; "required": false; "isSignal": true; }; "selectedPluralLabel": { "alias": "selectedPluralLabel"; "required": false; "isSignal": true; }; "applyLabel": { "alias": "applyLabel"; "required": false; "isSignal": true; }; "reloadTooltip": { "alias": "reloadTooltip"; "required": false; "isSignal": true; }; "sortTooltip": { "alias": "sortTooltip"; "required": false; "isSignal": true; }; "viewCardsTooltip": { "alias": "viewCardsTooltip"; "required": false; "isSignal": true; }; "viewTableTooltip": { "alias": "viewTableTooltip"; "required": false; "isSignal": true; }; "sortOptions": { "alias": "sortOptions"; "required": false; "isSignal": true; }; "sortLabel": { "alias": "sortLabel"; "required": false; "isSignal": true; }; "sortValue": { "alias": "sortValue"; "required": false; "isSignal": true; }; "reloadVisible": { "alias": "reloadVisible"; "required": false; "isSignal": true; }; "reloadInterval": { "alias": "reloadInterval"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "globalActions": { "alias": "globalActions"; "required": false; "isSignal": true; }; "selectionCount": { "alias": "selectionCount"; "required": false; "isSignal": true; }; "allSelected": { "alias": "allSelected"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "required": false; "isSignal": true; }; "selectionActions": { "alias": "selectionActions"; "required": false; "isSignal": true; }; "maxVisibleSelectionActions": { "alias": "maxVisibleSelectionActions"; "required": false; "isSignal": true; }; }, { "searchModel": "searchModelChange"; "view": "viewChange"; "filterModel": "filterModelChange"; "filterValues": "filterValuesChange"; "sortValue": "sortValueChange"; "allSelected": "allSelectedChange"; "indeterminate": "indeterminateChange"; "reload": "reload"; "appliedFilters": "appliedFilters"; "appliedSort": "appliedSort"; }, never, never, true, never>;
 }
 
 export { ToolbarComponent };
+export type { TkToolbarAction, TkToolbarFilterConfig };