shirkasoft-ui-components 1.2.0 → 1.3.0

package/types/shirkasoft-ui-components-table.d.ts

@@ -0,0 +1,293 @@
+import * as _angular_core from '@angular/core';
+import { FormGroup } from '@angular/forms';
+import { TagSeverity } from 'shirkasoft-ui-components/tag';
+
+interface Column {
+    field: string;
+    header: string;
+    sortable?: boolean;
+    filter?: boolean;
+    filterPlaceholder?: string;
+    width?: string;
+    defaultSort?: true;
+    filterType?: 'text' | 'exact' | 'select';
+    filterOptions?: {
+        label: string;
+        value: any;
+    }[];
+    template?: 'text' | 'tag';
+    format?: (row: any) => string;
+    tagValue?: (row: any) => string;
+    tagSeverity?: (row: any) => TagSeverity | undefined;
+    tagRounded?: boolean | ((row: any) => boolean);
+    tagIcon?: string | ((row: any) => string);
+    tagStyle?: (row: any) => Record<string, string | number> | undefined;
+}
+interface TableAction {
+    label: string;
+    icon: string | any;
+    onClick: () => void;
+    class?: string;
+    isVisible?: () => boolean;
+    isDisabled?: () => boolean;
+}
+interface RowAction {
+    label: string | ((data: any) => string);
+    icon: string | ((data: any) => any) | any;
+    onClick: (rowData: any) => void;
+    class?: string | ((data: any) => string);
+    isVisible?: (rowData: any) => boolean;
+    isDisabled?: (rowData: any) => boolean;
+}
+interface PageChangeEvent {
+    first: number;
+    rows: number;
+    page: number;
+    pageCount: number;
+}
+interface FilterChangeEvent {
+    filters: {
+        [key: string]: any;
+    };
+}
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/**
+ * Data table with sorting, column filters, global search, pagination,
+ * row/header actions, tag cells and optional server-side mode.
+ */
+declare class TableComponent {
+    private fb;
+    private cdr;
+    private transloco;
+    private destroyRef;
+    /** Maps icon names to lucide components, falling back to a plus icon. */
+    protected getIcon: (name: any) => any;
+    /**
+     * Minimum width applied to each column (except `actions`, which keeps its
+     * own computed width) only on narrow screens. On wide screens columns
+     * stretch normally to fill the container width. Can be overridden per
+     * column via `col.width`.
+     */
+    protected readonly DEFAULT_COLUMN_WIDTH = "140px";
+    /** Returns the effective CSS width for a column ('actions' included). */
+    getColumnWidth(col: Column): string;
+    /** Signal with the translated "Actions" header label. */
+    private actionsHeaderLabel;
+    /** Signal reacting to language changes so imperative translations are recomputed. */
+    private currentLang;
+    /** Reactive signal of loaded translations so pageReport is not stuck with raw keys. */
+    private translations;
+    /** Full dataset. In server-side mode only the current page rows. */
+    data: _angular_core.InputSignal<any[]>;
+    /** Column definitions (field, header, filterable, tag cell options, etc.). */
+    columns: _angular_core.InputSignal<Column[]>;
+    /** Number of rows displayed per page. */
+    rowsPerPage: _angular_core.InputSignal<number>;
+    /** Options shown in the rows-per-page selector. */
+    rowsPerPageOptions: _angular_core.InputSignal<number[]>;
+    /** Whether the table is in loading state (shows the overlay/skeleton). */
+    loading: _angular_core.InputSignal<boolean>;
+    /** Whether to render the row actions column. */
+    showActionRow: _angular_core.InputSignal<boolean>;
+    /** Custom cell/header templates keyed by column field. */
+    customTemplates: _angular_core.InputSignal<{
+        [key: string]: any;
+    }>;
+    /** Actions rendered in the table header. */
+    headerActions: _angular_core.InputSignal<TableAction[]>;
+    /** Actions rendered per row (icon, label, class, visibility/disabled). */
+    rowActions: _angular_core.InputSignal<RowAction[]>;
+    /** Whether the table container renders a drop shadow. */
+    hasShadow: _angular_core.InputSignal<boolean>;
+    /** Field used as the default initial sort. */
+    defaultSortField: _angular_core.InputSignal<string>;
+    /** Order used by the default initial sort (1 asc, -1 desc). */
+    defaultSortOrder: _angular_core.InputSignal<number>;
+    /** Whether the global search input is shown. */
+    showSearch: _angular_core.InputSignal<boolean>;
+    /** Placeholder for the global search input. */
+    searchPlaceholder: _angular_core.InputSignal<string>;
+    /** Message shown when there are no rows. */
+    emptyMessage: _angular_core.InputSignal<string>;
+    /** Enables server-side pagination/filtering/sorting mode. */
+    serverSide: _angular_core.InputSignal<boolean>;
+    /** Total number of records in server-side mode (for pagination math). */
+    totalRecords: _angular_core.InputSignal<number>;
+    /** Optional prebuilt filter chips (label + value) shown above the table. */
+    filters: _angular_core.InputSignal<{
+        label: string;
+        value: string;
+    }[]>;
+    /** Currently active filter chip value. */
+    activeFilter: _angular_core.InputSignal<string>;
+    /** Emits when the user clicks the refresh button. */
+    refresh: _angular_core.OutputEmitterRef<void>;
+    /** Emits page changes (server-side mode) with first/rows/page info. */
+    pageChange: _angular_core.OutputEmitterRef<PageChangeEvent>;
+    /** Emits the active column filters. */
+    filterChange: _angular_core.OutputEmitterRef<FilterChangeEvent>;
+    /** Emits the debounced global search term. */
+    searchChange: _angular_core.OutputEmitterRef<string>;
+    /** Emits when a filter chip is clicked. */
+    filterClick: _angular_core.OutputEmitterRef<string>;
+    /** Internal copy of the input data used as the base for search/filter. */
+    private originalData;
+    /** Rows after the global search is applied. */
+    searchedData: _angular_core.WritableSignal<any[]>;
+    /** Rows after column filters are applied. */
+    filteredData: _angular_core.WritableSignal<any[]>;
+    /** Rows belonging to the current page (after slicing). */
+    displayedData: _angular_core.WritableSignal<any[]>;
+    /** Local total records after filtering (client mode). */
+    localTotalRecords: _angular_core.WritableSignal<number>;
+    /** Index of the first row of the current page. */
+    first: _angular_core.WritableSignal<number>;
+    /** Visibility map for each column filter input. */
+    showFilterInput: _angular_core.WritableSignal<{
+        [key: string]: boolean;
+    }>;
+    /** Current global search term. */
+    searchQuery: _angular_core.WritableSignal<string>;
+    /** Currently sorted field. */
+    sortField: _angular_core.WritableSignal<string>;
+    /** Current sort direction (1 asc, -1 desc). */
+    sortOrder: _angular_core.WritableSignal<number>;
+    /** Local rows per page, kept in sync with the `rowsPerPage` input. */
+    rowsPerPageLocal: _angular_core.WritableSignal<number>;
+    /** Total number of pages based on the effective record count. */
+    totalPages: _angular_core.Signal<number>;
+    /** Current page number (1-based). */
+    currentPage: _angular_core.Signal<number>;
+    /** Reactive form holding the value of each column filter. */
+    columnFiltersForm: FormGroup;
+    /** Subjects used to debounce column filters (server mode) and search. */
+    private filterSubject;
+    private searchSubject;
+    /**
+     * Signature of the last built set of filterable fields (+filter type) to
+     * avoid rebuilding the form (and losing user input) on reference changes.
+     */
+    private lastFilterFieldsSignature;
+    private columnFilterSubscriptions;
+    /** Columns array with the leading `actions` column when row actions exist. */
+    columnsWithActions: _angular_core.Signal<Column[]>;
+    /** Total records: server-provided in server mode, locally computed otherwise. */
+    effectiveTotalRecords: _angular_core.Signal<number>;
+    /**
+     * Rows rendered by the template: the input data in server-side mode or the
+     * locally sliced/page current rows otherwise.
+     */
+    effectiveDisplayedData: _angular_core.Signal<any[]>;
+    /**
+     * Reactive "X to Y of Z" report. Depends on loaded translations and the
+     * active language so it always reflects the translated template.
+     */
+    pageReport: _angular_core.Signal<string>;
+    constructor();
+    /**
+     * Builds (or keeps) the reactive form with one control per filterable
+     * column. The form is only rebuilt when the set of filterable
+     * fields/filter types changes, preserving the values already typed by the
+     * user otherwise. Previous subscriptions are unsubscribed to avoid leaks.
+     */
+    private setupColumnFilters;
+    /** Collects the non-empty column filter values and emits them. */
+    private emitFilterChange;
+    /** Applies the global search over the original data (client mode). */
+    private applySearch;
+    /** Entry point that applies search (which cascades into column filters). */
+    private applyFilters;
+    /**
+     * Applies every column filter on top of the searched data using each
+     * column's `filterType` ('select', 'exact' or text contains).
+     */
+    private applyColumnFilters;
+    /** Slices the filtered rows for the current page. */
+    private updateDisplayedData;
+    /** Emits the filter chip clicked in the template. */
+    onFilterClick(value: string): void;
+    /** Toggles the sort direction of a column (first click sorts ascending). */
+    toggleSort(field: string): void;
+    /**
+     * Sorts the filtered rows by the current field. Rows with null/undefined
+     * values are always kept at the end regardless of sort direction.
+     */
+    private applySort;
+    /** Handles the global search input (updates query, resets page, debounces server mode). */
+    onSearchInput(value: string): void;
+    /** Clears a column filter value and hides its input. */
+    clearFilter(field: string): void;
+    /** Toggles the visibility of a column filter input. */
+    toggleFilter(field: string): void;
+    /**
+     * Whether a column filter is non-empty. Avoids treating the number 0 as
+     * "no value".
+     */
+    hasFilterValue(field: string): boolean;
+    /** Returns the reactive page report string (template helper). */
+    getPageReport(): string;
+    /** Goes to the first page (emits pageChange in server-side mode). */
+    goToFirst(): void;
+    /** Goes to the last page (emits pageChange in server-side mode). */
+    goToLast(): void;
+    /** Updates rows-per-page and resets to the first page. */
+    onRowsPerPageChange(rows: number): void;
+    /** Emits the refresh output. */
+    refreshData(): void;
+    /** Whether the current page is the first one. */
+    isFirstPage(): boolean;
+    /** Whether the current page is the last one. */
+    isLastPage(): boolean;
+    /** Moves to the next page (emits pageChange in server-side mode). */
+    next(): void;
+    /** Moves to the previous page (emits pageChange in server mode). */
+    prev(): void;
+    /** Resets the table to the first page. */
+    reset(): void;
+    /** Resolves the row action label, static or per-row function. */
+    getRowActionLabel(action: RowAction, rowData: any): string;
+    /**
+     * Resolves the row action icon: a lucide component, a function returning
+     * the icon name, or a raw string resolved by the central icon map.
+     */
+    getRowActionIconName(action: RowAction, rowData: any): any;
+    /** Resolves the CSS class of a row action, static or per-row function. */
+    getRowActionClass(action: RowAction, rowData: any): string;
+    /** Whether a header action is disabled. */
+    isHeaderActionDisabled(action: TableAction): boolean;
+    /** Whether a header action is visible. */
+    isHeaderActionVisible(action: TableAction): boolean;
+    /** Whether a row action is disabled for the given row. */
+    isRowActionDisabled(action: RowAction, rowData: any): boolean;
+    /** Whether a row action is visible for the given row. */
+    isRowActionVisible(action: RowAction, rowData: any): boolean;
+    /** Truncates a value with an ellipsis past the given character limit. */
+    truncate(value: any, limit?: number): string;
+    /** Resolves the value displayed inside a tag cell, static or per-row function. */
+    getTagValue(col: Column, rowData: any): string;
+    /** Resolves and validates the tag severity, falling back to 'secondary'. */
+    getTagSeverity(col: Column, rowData: any): TagSeverity;
+    /** Resolves whether the tag in a cell is rounded, static or per-row function. */
+    getTagRounded(col: Column, rowData: any): boolean;
+    /** Resolves the icon shown inside a tag cell, static or per-row function. */
+    getTagIcon(col: Column, rowData: any): string;
+    /** Resolves the CSS styles of a tag cell, static or per-row function. */
+    getTagStyle(col: Column, rowData: any): Record<string, string | number>;
+    /**
+     * trackBy for row identity: prefers `id`/`_id` and falls back to the index.
+     */
+    trackByRow(row: any, index: number): any;
+    /** Keyboard support (Enter/Space) for sorting a column header. */
+    onHeaderKeydown(event: KeyboardEvent, col: Column): void;
+    /** Accessible aria-sort value for a given column header. */
+    getAriaSort(col: Column): 'ascending' | 'descending' | 'none';
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TableComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TableComponent, "shk-table", never, { "data": { "alias": "data"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "rowsPerPage": { "alias": "rowsPerPage"; "required": false; "isSignal": true; }; "rowsPerPageOptions": { "alias": "rowsPerPageOptions"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "showActionRow": { "alias": "showActionRow"; "required": false; "isSignal": true; }; "customTemplates": { "alias": "customTemplates"; "required": false; "isSignal": true; }; "headerActions": { "alias": "headerActions"; "required": false; "isSignal": true; }; "rowActions": { "alias": "rowActions"; "required": false; "isSignal": true; }; "hasShadow": { "alias": "hasShadow"; "required": false; "isSignal": true; }; "defaultSortField": { "alias": "defaultSortField"; "required": false; "isSignal": true; }; "defaultSortOrder": { "alias": "defaultSortOrder"; "required": false; "isSignal": true; }; "showSearch": { "alias": "showSearch"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; "isSignal": true; }; "serverSide": { "alias": "serverSide"; "required": false; "isSignal": true; }; "totalRecords": { "alias": "totalRecords"; "required": false; "isSignal": true; }; "filters": { "alias": "filters"; "required": false; "isSignal": true; }; "activeFilter": { "alias": "activeFilter"; "required": false; "isSignal": true; }; }, { "refresh": "refresh"; "pageChange": "pageChange"; "filterChange": "filterChange"; "searchChange": "searchChange"; "filterClick": "filterClick"; }, never, never, true, never>;
+}
+
+export { TableComponent };
+export type { Column, FilterChangeEvent, PageChangeEvent, RowAction, TableAction };

package/types/shirkasoft-ui-components-tabs.d.ts

@@ -0,0 +1,102 @@
+import * as i0 from '@angular/core';
+
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/** Shared state between shk-abs and its tab/tabpanel children. */
+declare class TabsService {
+    /** Currently active tab value. */
+    readonly active: i0.WritableSignal<any>;
+    /** Sets the active tab to the given value. */
+    select(value: any): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<TabsService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<TabsService>;
+}
+
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/** Container for tab panels. Renders its projected shk-tablist/shh-tab content. */
+declare class TabsComponent {
+    /** Currently active tab value. Two-way bindable with [(value)]. */
+    value: i0.ModelSignal<any>;
+    /** Allows the tab header to scroll horizontally when it overflows. */
+    scrollable: i0.InputSignal<boolean>;
+    /** Shared service used to sync the active tab with the children. */
+    protected tabsSvc: TabsService;
+    constructor();
+    static ɵfac: i0.ɵɵFactoryDeclaration<TabsComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<TabsComponent, "shk-tabs", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "scrollable": { "alias": "scrollable"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, ["*"], true, never>;
+}
+
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/** Horizontal bar that contains the shk-tab headers. */
+declare class TablistComponent {
+    /** Allows the header to scroll horizontally when it overflows. */
+    scrollable: i0.InputSignal<boolean>;
+    /** Extra CSS classes. */
+    styleClass: i0.InputSignal<string>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<TablistComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<TablistComponent, "shk-tablist", never, { "scrollable": { "alias": "scrollable"; "required": false; "isSignal": true; }; "styleClass": { "alias": "styleClass"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/** A single tab header. Clicking it activates the matching panel. */
+declare class TabComponent {
+    /** Value that links this tab to its panel. */
+    value: i0.InputSignal<any>;
+    /** Disables the tab. */
+    disabled: i0.InputSignal<boolean>;
+    /** Extra CSS classes. */
+    styleClass: i0.InputSignal<string>;
+    /** Shared service used to read the active tab value. */
+    protected tabsSvc: TabsService;
+    /** Whether this tab is the active one. */
+    protected active: i0.Signal<boolean>;
+    /** Activates this tab through the shared service. */
+    select(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<TabComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<TabComponent, "shk-tab", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "styleClass": { "alias": "styleClass"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/** Container that groups the shk-tabpanel content sections. */
+declare class TabpanelsComponent {
+    static ɵfac: i0.ɵɵFactoryDeclaration<TabpanelsComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<TabpanelsComponent, "shk-tabpanels", never, {}, {}, never, ["*"], true, never>;
+}
+
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/** Content section shown only while its value is the active tab. */
+declare class TabPanelComponent {
+    /** Value that links this panel to its tab. */
+    value: i0.InputSignal<any>;
+    /** Shared service used to read the active tab value. */
+    protected tabsSvc: TabsService;
+    /** Whether this panel is the active one. */
+    protected active: i0.Signal<boolean>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<TabPanelComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<TabPanelComponent, "shk-tabpanel", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
+export { TabComponent, TabPanelComponent, TablistComponent, TabpanelsComponent, TabsComponent, TabsService };

package/types/shirkasoft-ui-components-tag.d.ts

@@ -0,0 +1,31 @@
+import * as _angular_core from '@angular/core';
+import { getIcon } from 'shirkasoft-ui-components/utils';
+
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+type TagSeverity = 'secondary' | 'success' | 'info' | 'warning' | 'danger' | 'contrast';
+/** Small label used to highlight a value, status or category. */
+declare class TagComponent {
+    /** Text shown inside the tag. */
+    value: _angular_core.InputSignal<string | number>;
+    /** Color variant. Defaults to 'secondary'. */
+    severity: _angular_core.InputSignal<TagSeverity>;
+    /** Renders the tag with fully rounded corners (pill). */
+    rounded: _angular_core.InputSignal<boolean>;
+    /** Optional leading lucide icon name or component. */
+    icon: _angular_core.InputSignal<any>;
+    /** Inline styles applied to the tag. */
+    style: _angular_core.InputSignal<Record<string, string | number>>;
+    /** Extra CSS classes. */
+    styleClass: _angular_core.InputSignal<string>;
+    protected getIcon: typeof getIcon;
+    protected tagClass: _angular_core.Signal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TagComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TagComponent, "shk-tag", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "severity": { "alias": "severity"; "required": false; "isSignal": true; }; "rounded": { "alias": "rounded"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "style": { "alias": "style"; "required": false; "isSignal": true; }; "styleClass": { "alias": "styleClass"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
+export { TagComponent };
+export type { TagSeverity };

package/types/shirkasoft-ui-components-text-field.d.ts

@@ -0,0 +1,120 @@
+import * as _angular_core from '@angular/core';
+import { ElementRef } from '@angular/core';
+import { ControlValueAccessor, FormGroup, FormControl } from '@angular/forms';
+
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/**
+ * Text input (or textarea) that implements ControlValueAccessor with built-in
+ * validation messages, card/number formatting, password reveal and search mode.
+ */
+declare class TextFieldComponent implements ControlValueAccessor {
+    private cdr;
+    /** id attribute applied to the native input. */
+    id: _angular_core.InputSignal<string>;
+    /** Formats the value as a credit card number (XXXX-XXXX-XXXX-XXXX). */
+    formatCard: _angular_core.InputSignal<boolean>;
+    /** Blocks the minus sign from being typed. */
+    preventNegative: _angular_core.InputSignal<boolean>;
+    /** Label rendered above the field. */
+    label: _angular_core.InputSignal<string>;
+    /** Native input type ('text', 'password', 'number', etc.). */
+    type: _angular_core.InputSignal<string>;
+    /** Allows digits only, stripping any other character. */
+    numbersOnly: _angular_core.InputSignal<boolean>;
+    /** When true, allows decimals and normalizes ',' to '.'. */
+    allowDecimals: _angular_core.InputSignal<boolean>;
+    /** Maximum number of characters the user can type. */
+    maxLength: _angular_core.InputSignal<number | undefined>;
+    /** Placeholder text of the native input. */
+    placeholder: _angular_core.InputSignal<string>;
+    /** Custom messages keyed by validation error name. */
+    errorMessages: _angular_core.InputSignal<{
+        [key: string]: string;
+    }>;
+    /** Parent reactive form used to resolve the control by label. */
+    formGroup: _angular_core.InputSignal<FormGroup<any> | undefined>;
+    /** Reactive control bound directly to this field. */
+    control: _angular_core.InputSignal<FormControl<any> | undefined>;
+    /** Disables the field. */
+    disabled: _angular_core.InputSignal<boolean>;
+    /** Custom error message shown regardless of validation errors. */
+    errorMessage: _angular_core.InputSignal<string>;
+    /** Renders a textarea instead of an input. */
+    isTextArea: _angular_core.InputSignal<boolean>;
+    /** Height classes applied when `isTextArea` is true. */
+    textAreaHeight: _angular_core.InputSignal<string>;
+    /** Renders the field as a read-only search trigger. */
+    searchMode: _angular_core.InputSignal<boolean>;
+    /** Value shown when `searchMode` is enabled. */
+    displayValue: _angular_core.InputSignal<string>;
+    /** Native autocomplete attribute. */
+    autocomplete: _angular_core.InputSignal<string>;
+    /** Emitted when the search button is clicked (search mode). */
+    searchButtonClick: _angular_core.OutputEmitterRef<void>;
+    protected readonly getIcon: (name: any) => any;
+    /** Reference to the native input element. */
+    inputElement: _angular_core.Signal<ElementRef<HTMLInputElement> | undefined>;
+    /** Reference to the native textarea element. */
+    textareaElement: _angular_core.Signal<ElementRef<HTMLTextAreaElement> | undefined>;
+    /** Internal raw value of the field. */
+    private _value;
+    /** Reactive disabled state from the form control. */
+    private _disabledState;
+    /** Whether the password is currently revealed. */
+    showPassword: _angular_core.WritableSignal<boolean>;
+    /** Tracks whether the control was in error at some point (for "was fixed" UX). */
+    hadError: _angular_core.WritableSignal<boolean>;
+    /** Counter bumped to trigger recomputation of derived error signals. */
+    private errorTracker;
+    /** Text displayed in search mode when `displayValue` is set. */
+    displayLabel: _angular_core.Signal<string>;
+    /** Prevents re-subscribing to the same form control. */
+    private subscribed;
+    /** Effective disabled state combining the input and the form binding. */
+    isDisabled: _angular_core.Signal<boolean>;
+    /** Current field value. */
+    value: _angular_core.Signal<any>;
+    /** Resolves the reactive control: explicit `control` or `formGroup.get(label)`. */
+    actualControl: _angular_core.Signal<FormControl<any> | undefined>;
+    /** True when the resolved control is invalid and dirty or touched. */
+    shouldShowError: _angular_core.Signal<boolean | undefined>;
+    /** True when the control had an error before and is now valid (success state). */
+    wasFixedError: _angular_core.Signal<boolean | undefined>;
+    /** Resolved list of error messages for the current control state. */
+    getErrorMessages: _angular_core.Signal<string[]>;
+    /** Effective input type (handles textarea and password reveal). */
+    effectiveType: _angular_core.Signal<string>;
+    private transloco;
+    /** Callback notified with the new value (ControlValueAccessor). */
+    private onChange;
+    /** Callback notified when the field is touched (ControlValueAccessor). */
+    private onTouched;
+    private destroyRef;
+    constructor();
+    /** Prevents disallowed characters based on the `numbersOnly`/`allowDecimals` config. */
+    numberValidation(event: KeyboardEvent): void;
+    /** Marks the field as touched and refreshes the error state. */
+    onBlur(): void;
+    /** Formats the raw input as a credit card number and notifies the control. */
+    onCardInput(event: Event): void;
+    /** Handles raw input: applies number/card/max-length formatting and notifies the control. */
+    onInput(event: Event): void;
+    /** Toggles the visibility of a password field. */
+    togglePasswordVisibility(): void;
+    /** Sets the value from the form control applying the same formatting rules. */
+    writeValue(value: any): void;
+    /** Registers the callback invoked on value changes (ControlValueAccessor). */
+    registerOnChange(fn: any): void;
+    /** Registers the callback invoked when the field is touched. */
+    registerOnTouched(fn: any): void;
+    /** Reflects the disabled state of the form control. */
+    setDisabledState(isDisabled: boolean): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TextFieldComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TextFieldComponent, "shk-text-field", never, { "id": { "alias": "id"; "required": false; "isSignal": true; }; "formatCard": { "alias": "formatCard"; "required": false; "isSignal": true; }; "preventNegative": { "alias": "preventNegative"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "numbersOnly": { "alias": "numbersOnly"; "required": false; "isSignal": true; }; "allowDecimals": { "alias": "allowDecimals"; "required": false; "isSignal": true; }; "maxLength": { "alias": "maxLength"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "errorMessages": { "alias": "errorMessages"; "required": false; "isSignal": true; }; "formGroup": { "alias": "formGroup"; "required": false; "isSignal": true; }; "control": { "alias": "control"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "errorMessage": { "alias": "errorMessage"; "required": false; "isSignal": true; }; "isTextArea": { "alias": "isTextArea"; "required": false; "isSignal": true; }; "textAreaHeight": { "alias": "textAreaHeight"; "required": false; "isSignal": true; }; "searchMode": { "alias": "searchMode"; "required": false; "isSignal": true; }; "displayValue": { "alias": "displayValue"; "required": false; "isSignal": true; }; "autocomplete": { "alias": "autocomplete"; "required": false; "isSignal": true; }; }, { "searchButtonClick": "searchButtonClick"; }, never, never, true, never>;
+}
+
+export { TextFieldComponent };