@konce-pt/angular 0.3.0 → 0.4.0

package/dist/types/konce-pt-angular.d.ts

@@ -1,5 +1,5 @@
 import * as _angular_core from '@angular/core';
-import { TemplateRef, OnDestroy } from '@angular/core';
+import { InjectionToken, EnvironmentProviders, TemplateRef, OnDestroy } from '@angular/core';
 import { FormValueControl, WithOptionalFieldTree, ValidationError, FormCheckboxControl } from '@angular/forms/signals';
 import { ConnectedPosition } from '@angular/cdk/overlay';
 import * as _konce_pt_angular from '@konce-pt/angular';
@@ -99,6 +99,259 @@ declare class KptFab {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptFab, "kpt-fab", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "extended": { "alias": "extended"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
+/** Kod języka. Otwarty string — EN/PL mają podpowiedzi, ale dozwolony dowolny. */
+type KptLocale = 'en' | 'pl' | (string & {});
+/** Pełny słownik etykiet UI używanych przez komponenty biblioteki. */
+interface KptMessages {
+    /** Etykiety współdzielone przez wiele komponentów (przyciski ikonowe itp.). */
+    common: {
+        close: string;
+        remove: string;
+        previous: string;
+        next: string;
+        clear: string;
+        done: string;
+        all: string;
+    };
+    paginator: {
+        rowsPerPage: string;
+        /** Interpolacja: {start}, {end}, {total}. */
+        range: string;
+        prevPage: string;
+        nextPage: string;
+    };
+    select: {
+        search: string;
+        noResults: string;
+        removeChip: string;
+    };
+    listbox: {
+        search: string;
+        empty: string;
+    };
+    dataView: {
+        list: string;
+        grid: string;
+        empty: string;
+        /** Interpolacja: {count}. */
+        count: string;
+    };
+    dataTable: {
+        search: string;
+        exportCsv: string;
+        loading: string;
+        empty: string;
+        selectAll: string;
+        selectRow: string;
+        expandRow: string;
+        /** Interpolacja: {column}. */
+        filter: string;
+        /** Interpolacja: {column}. */
+        filterMin: string;
+        /** Interpolacja: {column}. */
+        filterMax: string;
+        all: string;
+        dateRange: string;
+        min: string;
+        max: string;
+    };
+    confirm: {
+        header: string;
+        accept: string;
+        reject: string;
+    };
+    fileUpload: {
+        /** Może zawierać `<strong>…</strong>`. */
+        hint: string;
+        remove: string;
+    };
+    chipsInput: {
+        placeholder: string;
+    };
+    dateRange: {
+        placeholder: string;
+        from: string;
+        to: string;
+        fromTime: string;
+        toTime: string;
+    };
+    datepicker: {
+        prevMonth: string;
+        nextMonth: string;
+        prevYear: string;
+        nextYear: string;
+        prevYears: string;
+        nextYears: string;
+        calendar: string;
+        month: string;
+        time: string;
+    };
+    pickList: {
+        available: string;
+        selected: string;
+        moveAllRight: string;
+        moveRight: string;
+        moveLeft: string;
+        moveAllLeft: string;
+    };
+    orderList: {
+        up: string;
+        down: string;
+    };
+    inputNumber: {
+        decrement: string;
+        increment: string;
+    };
+    password: {
+        show: string;
+        hide: string;
+        /** Etykiety miernika siły (indeksy 0–4). */
+        strength: [string, string, string, string, string];
+    };
+    spinner: {
+        label: string;
+    };
+    speedDial: {
+        actions: string;
+    };
+    scrollTop: {
+        label: string;
+    };
+    splitButton: {
+        more: string;
+    };
+    panel: {
+        toggle: string;
+    };
+    breadcrumb: {
+        label: string;
+    };
+    galleria: {
+        /** Interpolacja: {index}. */
+        image: string;
+    };
+    carousel: {
+        /** Interpolacja: {index}. */
+        slide: string;
+    };
+    richText: {
+        copy: string;
+        paste: string;
+        pasteText: string;
+        heading: string;
+        bold: string;
+        italic: string;
+        underline: string;
+        strike: string;
+        ul: string;
+        ol: string;
+        foreColor: string;
+        backColor: string;
+        alignLeft: string;
+        alignCenter: string;
+        alignRight: string;
+        alignJustify: string;
+        link: string;
+        table: string;
+        clear: string;
+        html: string;
+        /** Styl bloku „Normalny" (select). */
+        styleNormal: string;
+        /** Interpolacja: {level}. */
+        styleHeading: string;
+        linkPrompt: string;
+        htmlSource: string;
+        /** Etykieta „Własny…" przy pickerze koloru. */
+        paletteCustom: string;
+        /** Menu kontekstowe tabeli. */
+        menu: {
+            column: string;
+            row: string;
+            cell: string;
+            insertLeft: string;
+            insertRight: string;
+            headerColumn: string;
+            deleteColumn: string;
+            insertAbove: string;
+            insertBelow: string;
+            headerRow: string;
+            deleteRow: string;
+            cellBackground: string;
+            alignLeft: string;
+            alignCenter: string;
+            alignRight: string;
+            mergeCells: string;
+            splitCell: string;
+            border: string;
+            deleteTable: string;
+        };
+        /** Popover obramowania. */
+        border: {
+            table: string;
+            cell: string;
+            none: string;
+            thin: string;
+            medium: string;
+            thick: string;
+            customColor: string;
+        };
+    };
+}
+declare const KPT_MESSAGES_EN: KptMessages;
+declare const KPT_MESSAGES_PL: KptMessages;
+
+/** Głęboko-opcjonalna wersja typu — dla nadpisań/częściowych słowników. */
+type DeepPartial<T> = {
+    [K in keyof T]?: T[K] extends object ? DeepPartial<T[K]> : T[K];
+};
+/** Konfiguracja i18n przekazywana do `provideKptI18n`. */
+interface KptI18nConfig {
+    /** Język początkowy (domyślnie 'en'). */
+    locale?: KptLocale;
+    /**
+     * Słowniki do zarejestrowania lub nadpisania, kluczowane kodem języka.
+     * Może dodać nowy język (`{ de: {...} }`) lub nadpisać istniejący
+     * (`{ en: { paginator: { rowsPerPage: 'Rows:' } } }`). Deep-merge z bazą EN/PL.
+     */
+    messages?: Record<string, DeepPartial<KptMessages>>;
+}
+/** Token konfiguracji i18n. Konsumowany przez `KptI18n`. */
+declare const KPT_I18N_CONFIG: InjectionToken<KptI18nConfig>;
+
+/**
+ * Serwis tłumaczeń Koncept UI. Trzyma rejestr słowników per język, bieżący locale
+ * (sygnał) i funkcję `t()` z interpolacją. Skonfiguruj przez `provideKptI18n(...)`.
+ *
+ * Domyślnie EN. Języki bazowe: EN, PL. Dowolny inny język dodaje się jednym
+ * słownikiem (`registerMessages` lub `provideKptI18n({ messages: { de } })`);
+ * brakujące klucze spadają na EN.
+ */
+declare class KptI18n {
+    /** Rejestr słowników: język → pełny `KptMessages`. */
+    private readonly registry;
+    private readonly _locale;
+    /** Bieżący język (tylko do odczytu). */
+    readonly locale: _angular_core.Signal<KptLocale>;
+    /** Aktywny słownik (z fallbackiem na EN, gdy język nieznany). */
+    readonly messages: _angular_core.Signal<KptMessages>;
+    constructor();
+    /** Ustawia bieżący język. Zmiana jest reaktywna dla wszystkich komponentów. */
+    setLocale(locale: KptLocale): void;
+    /**
+     * Rejestruje lub nadpisuje słownik języka. Częściowy słownik deep-merge'uje się
+     * na istniejący (lub EN dla nowego języka) → brakujące klucze mają wartość EN.
+     */
+    registerMessages(locale: KptLocale, patch: DeepPartial<KptMessages>): void;
+    /**
+     * Tłumaczy klucz w notacji kropkowej (np. `'paginator.range'`), z opcjonalną
+     * interpolacją `{name}`. Brakujący klucz spada na EN, a w ostateczności zwraca sam klucz.
+     */
+    t(key: string, params?: Record<string, string | number>): string;
+    private lookup;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptI18n, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<KptI18n>;
+}
+
 interface KptMenuItem<T = unknown> {
     label?: string;
     value?: T;
@@ -145,6 +398,7 @@ declare class KptSplitButton<T = unknown> {
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly primaryClick: _angular_core.OutputEmitterRef<void>;
     readonly select: _angular_core.OutputEmitterRef<KptMenuItem<T>>;
+    protected readonly i18n: KptI18n;
     protected readonly open: _angular_core.WritableSignal<boolean>;
     protected readonly positions: ConnectedPosition[];
     protected pick(item: KptMenuItem<T>): void;
@@ -195,6 +449,27 @@ declare class KptIconRegistry {
 
 type KptIconName = 'menu' | 'x' | 'chevron-up' | 'chevron-down' | 'chevron-left' | 'chevron-right' | 'check' | 'search' | 'grip-vertical' | 'info' | 'alert-triangle' | 'circle-check' | 'circle-x' | 'calendar' | 'copy' | 'link' | 'code' | 'bold' | 'italic' | 'underline' | 'strikethrough' | 'list' | 'list-numbers' | 'clear-formatting' | 'star' | 'plus' | 'upload' | 'dots-vertical' | 'photo' | 'trash' | 'eye' | 'eye-off' | 'minus' | 'arrow-up' | 'arrow-down' | 'zoom-in' | 'info-circle' | 'phone' | 'map-pin' | 'world' | 'clock' | 'align-left' | 'align-center' | 'align-right' | 'align-justified' | 'palette' | 'highlight' | 'clipboard' | 'clipboard-text' | 'table' | 'pencil';
 
+/**
+ * Konfiguruje i18n Koncept UI. Ustawia język początkowy i rejestruje/nadpisuje
+ * słowniki. Języki bazowe (EN, PL) są dostępne bez konfiguracji.
+ *
+ * @example
+ * // main.ts — polski interfejs
+ * bootstrapApplication(App, {
+ *   providers: [provideKptI18n({ locale: 'pl' })],
+ * });
+ *
+ * @example
+ * // Własny język jednym plikiem JSON (brakujące klucze → EN)
+ * import de from './i18n/de.json';
+ * provideKptI18n({ locale: 'de', messages: { de } });
+ *
+ * @example
+ * // Nadpisanie pojedynczych etykiet istniejącego języka
+ * provideKptI18n({ messages: { en: { paginator: { rowsPerPage: 'Rows per page:' } } } });
+ */
+declare function provideKptI18n(config?: KptI18nConfig): EnvironmentProviders;
+
 type KptBadgeVariant = 'neutral' | 'primary' | 'success' | 'danger' | 'warning' | 'info';
 /**
  * Znacznik (badge) — licznik lub kropka statusu. Standalone lub nałożony na treść (`overlay`).
@@ -228,6 +503,7 @@ declare class KptChip {
     readonly removable: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly removed: _angular_core.OutputEmitterRef<void>;
+    protected readonly i18n: KptI18n;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptChip, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptChip, "kpt-chip", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "removable": { "alias": "removable"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "removed": "removed"; }, never, ["*"], true, never>;
 }
@@ -262,7 +538,10 @@ declare class KptAvatar {
  */
 declare class KptSpinner {
     readonly size: _angular_core.InputSignal<string>;
-    readonly label: _angular_core.InputSignal<string>;
+    /** Etykieta a11y; bez wartości używa i18n (`spinner.label`). */
+    readonly label: _angular_core.InputSignal<string | undefined>;
+    private readonly i18n;
+    protected readonly effectiveLabel: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptSpinner, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptSpinner, "kpt-spinner", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
@@ -500,6 +779,7 @@ declare class KptSelect<T = unknown> implements FormValueControl<unknown> {
     /** Wartość: pojedyncza (T) lub tablica (T[]) w trybie multiple. */
     readonly value: _angular_core.ModelSignal<unknown>;
     readonly touch: _angular_core.OutputEmitterRef<void>;
+    protected readonly i18n: KptI18n;
     protected readonly open: _angular_core.WritableSignal<boolean>;
     protected readonly filterText: _angular_core.WritableSignal<string>;
     protected readonly activeIndex: _angular_core.WritableSignal<number>;
@@ -569,7 +849,9 @@ declare class KptDatepicker implements FormValueControl<string> {
     readonly minDate: _angular_core.InputSignal<string | null>;
     readonly maxDate: _angular_core.InputSignal<string | null>;
     protected readonly effectivePlaceholder: _angular_core.Signal<string>;
-    protected readonly weekdays: string[];
+    protected readonly i18n: KptI18n;
+    protected readonly weekdays: _angular_core.Signal<string[]>;
+    private readonly months;
     protected readonly open: _angular_core.WritableSignal<boolean>;
     private readonly today;
     private readonly view;
@@ -705,6 +987,7 @@ declare class KptRichText implements FormValueControl<string> {
     readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly touch: _angular_core.OutputEmitterRef<void>;
+    protected readonly i18n: KptI18n;
     protected readonly swatches: string[];
     private readonly editor;
     private savedRange;
@@ -731,10 +1014,10 @@ declare class KptRichText implements FormValueControl<string> {
     private selAnchor;
     private selecting;
     private canSplitCtx;
-    protected readonly styleOptions: {
+    protected readonly styleOptions: _angular_core.Signal<{
         tag: string;
         label: string;
-    }[];
+    }[]>;
     protected readonly styleLabel: _angular_core.Signal<string>;
     protected readonly activeCmds: _angular_core.WritableSignal<Set<string>>;
     protected readonly currentBlock: _angular_core.WritableSignal<string>;
@@ -885,6 +1168,7 @@ declare class KptFileUpload implements FormValueControl<File[]> {
     readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly touch: _angular_core.OutputEmitterRef<void>;
+    protected readonly i18n: KptI18n;
     protected readonly dragover: _angular_core.WritableSignal<boolean>;
     protected onSelect(event: Event): void;
     protected onDragOver(event: DragEvent): void;
@@ -946,12 +1230,16 @@ declare class KptDateRange implements FormValueControl<KptDateRangeValue> {
     readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly touch: _angular_core.OutputEmitterRef<void>;
-    readonly placeholder: _angular_core.InputSignal<string>;
+    /** Placeholder; bez wartości używa i18n (`dateRange.placeholder`). */
+    readonly placeholder: _angular_core.InputSignal<string | undefined>;
     readonly displayFormat: _angular_core.InputSignal<"pl" | "iso">;
     readonly mode: _angular_core.InputSignal<KptDateRangeMode>;
     readonly hourFormat: _angular_core.InputSignalWithTransform<number, unknown>;
     readonly minuteStep: _angular_core.InputSignalWithTransform<number, unknown>;
-    protected readonly weekdays: string[];
+    protected readonly i18n: KptI18n;
+    protected readonly weekdays: _angular_core.Signal<string[]>;
+    private readonly months;
+    protected readonly effectivePlaceholder: _angular_core.Signal<string>;
     protected readonly open: _angular_core.WritableSignal<boolean>;
     private readonly today;
     private readonly view;
@@ -996,6 +1284,7 @@ declare class KptInputNumber implements FormValueControl<number | null> {
     readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly touch: _angular_core.OutputEmitterRef<void>;
+    protected readonly i18n: KptI18n;
     protected readonly display: _angular_core.Signal<string>;
     protected readonly canInc: _angular_core.Signal<boolean>;
     protected readonly canDec: _angular_core.Signal<boolean>;
@@ -1024,6 +1313,7 @@ declare class KptPassword implements FormValueControl<string> {
     readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly touch: _angular_core.OutputEmitterRef<void>;
+    protected readonly i18n: KptI18n;
     protected readonly visible: _angular_core.WritableSignal<boolean>;
     protected readonly strength: _angular_core.Signal<Strength>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptPassword, never>;
@@ -1065,12 +1355,15 @@ declare class KptInputOtp implements FormValueControl<string> {
  */
 declare class KptChipsInput implements FormValueControl<string[]> {
     readonly value: _angular_core.ModelSignal<string[]>;
-    readonly placeholder: _angular_core.InputSignal<string>;
+    /** Placeholder; bez wartości używa i18n (`chipsInput.placeholder`). */
+    readonly placeholder: _angular_core.InputSignal<string | undefined>;
     readonly allowDuplicates: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly touch: _angular_core.OutputEmitterRef<void>;
+    protected readonly i18n: KptI18n;
+    protected readonly effectivePlaceholder: _angular_core.Signal<string>;
     protected onKeydown(event: KeyboardEvent): void;
     protected commit(el: HTMLInputElement): void;
     protected removeAt(index: number): void;
@@ -1116,6 +1409,7 @@ declare class KptListbox<T = unknown> implements FormValueControl<T | T[] | null
     readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly touch: _angular_core.OutputEmitterRef<void>;
+    protected readonly i18n: KptI18n;
     protected readonly query: _angular_core.WritableSignal<string>;
     protected readonly visible: _angular_core.Signal<KptOption<T>[]>;
     protected isSelected(v: T): boolean;
@@ -1268,6 +1562,7 @@ declare class KptPanel {
     readonly collapsed: _angular_core.ModelSignal<boolean>;
     readonly animated: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly animationDuration: _angular_core.InputSignal<number>;
+    protected readonly i18n: KptI18n;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptPanel, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptPanel, "kpt-panel", never, { "header": { "alias": "header"; "required": false; "isSignal": true; }; "toggleable": { "alias": "toggleable"; "required": false; "isSignal": true; }; "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "animated": { "alias": "animated"; "required": false; "isSignal": true; }; "animationDuration": { "alias": "animationDuration"; "required": false; "isSignal": true; }; }, { "collapsed": "collapsedChange"; }, never, ["[kptPanelActions]", "*"], true, never>;
 }
@@ -1323,6 +1618,7 @@ declare class KptSplitter {
 declare class KptScrollTop {
     readonly threshold: _angular_core.InputSignal<number>;
     readonly target: _angular_core.InputSignal<string | null>;
+    protected readonly i18n: KptI18n;
     protected readonly visible: _angular_core.WritableSignal<boolean>;
     private scroller;
     constructor();
@@ -1343,6 +1639,7 @@ declare class KptImage {
     readonly alt: _angular_core.InputSignal<string>;
     readonly width: _angular_core.InputSignal<string | null>;
     readonly preview: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    protected readonly i18n: KptI18n;
     protected readonly open: _angular_core.WritableSignal<boolean>;
     protected openPreview(): void;
     protected close(): void;
@@ -1500,6 +1797,7 @@ interface KptBreadcrumbItem {
  */
 declare class KptBreadcrumb {
     readonly items: _angular_core.InputSignal<KptBreadcrumbItem[]>;
+    protected readonly i18n: KptI18n;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptBreadcrumb, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptBreadcrumb, "kpt-breadcrumb", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
@@ -1557,9 +1855,11 @@ declare class KptPaginator {
     readonly pageIndex: _angular_core.ModelSignal<number>;
     /** Dostępne rozmiary strony. */
     readonly pageSizeOptions: _angular_core.InputSignal<number[]>;
+    protected readonly i18n: KptI18n;
     readonly totalPages: _angular_core.Signal<number>;
     readonly rangeStart: _angular_core.Signal<number>;
     readonly rangeEnd: _angular_core.Signal<number>;
+    protected readonly rangeLabel: _angular_core.Signal<string>;
     readonly canPrev: _angular_core.Signal<boolean>;
     readonly canNext: _angular_core.Signal<boolean>;
     constructor();
@@ -1638,7 +1938,8 @@ declare class KptDataTable<T = Record<string, unknown>> {
     readonly pageSizeOptions: _angular_core.InputSignal<number[]>;
     readonly selectable: _angular_core.InputSignal<"none" | "single" | "multiple">;
     readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    readonly emptyMessage: _angular_core.InputSignal<string>;
+    /** Komunikat pustej tabeli; bez wartości używa i18n (`dataTable.empty`). */
+    readonly emptyMessage: _angular_core.InputSignal<string | undefined>;
     /** Pole identyfikujące wiersz (dla zaznaczania). Bez niego — porównanie po referencji. */
     readonly rowKey: _angular_core.InputSignal<string | null>;
     /** Wysokość przewijalnego obszaru (np. '400px'); sticky header pozostaje widoczny. */
@@ -1667,6 +1968,9 @@ declare class KptDataTable<T = Record<string, unknown>> {
     readonly rowClick: _angular_core.OutputEmitterRef<T>;
     /** Emitowane w trybie lazy przy zmianie sortowania/filtra/strony. */
     readonly lazyLoad: _angular_core.OutputEmitterRef<KptTableLazyState>;
+    protected readonly i18n: KptI18n;
+    /** Komunikat pustej tabeli (input albo domyślny z i18n). */
+    protected readonly emptyText: _angular_core.Signal<string>;
     /** Kolumny w bieżącej kolejności (po ewentualnym przestawieniu). */
     protected readonly orderedColumns: _angular_core.WritableSignal<readonly KptColumn[]>;
     private readonly scrollEl;
@@ -1852,6 +2156,7 @@ declare class KptTimeline {
 declare class KptCarousel<T = unknown> {
     readonly items: _angular_core.InputSignal<T[]>;
     readonly activeIndex: _angular_core.ModelSignal<number>;
+    protected readonly i18n: KptI18n;
     protected readonly slideTpl: _angular_core.Signal<TemplateRef<any>>;
     next(): void;
     prev(): void;
@@ -1874,6 +2179,7 @@ declare class KptDataView<T = unknown> {
     readonly layout: _angular_core.ModelSignal<"list" | "grid">;
     readonly pageSize: _angular_core.InputSignal<number>;
     readonly paginated: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    protected readonly i18n: KptI18n;
     protected readonly itemTpl: _angular_core.Signal<TemplateRef<any>>;
     protected readonly pageIndex: _angular_core.ModelSignal<number>;
     protected readonly showPager: _angular_core.Signal<boolean>;
@@ -1894,9 +2200,14 @@ declare class KptDataView<T = unknown> {
 declare class KptPickList<T = unknown> {
     readonly source: _angular_core.ModelSignal<T[]>;
     readonly target: _angular_core.ModelSignal<T[]>;
-    readonly sourceHeader: _angular_core.InputSignal<string>;
-    readonly targetHeader: _angular_core.InputSignal<string>;
+    /** Nagłówek listy źródłowej; bez wartości używa i18n (`pickList.available`). */
+    readonly sourceHeader: _angular_core.InputSignal<string | undefined>;
+    /** Nagłówek listy docelowej; bez wartości używa i18n (`pickList.selected`). */
+    readonly targetHeader: _angular_core.InputSignal<string | undefined>;
     protected readonly itemTpl: _angular_core.Signal<TemplateRef<any>>;
+    protected readonly i18n: KptI18n;
+    protected readonly effectiveSourceHeader: _angular_core.Signal<string>;
+    protected readonly effectiveTargetHeader: _angular_core.Signal<string>;
     protected readonly selSource: _angular_core.WritableSignal<Set<T>>;
     protected readonly selTarget: _angular_core.WritableSignal<Set<T>>;
     protected toggle(side: 'source' | 'target', item: T): void;
@@ -1917,6 +2228,7 @@ declare class KptPickList<T = unknown> {
 declare class KptOrderList<T = unknown> {
     readonly items: _angular_core.ModelSignal<T[]>;
     readonly header: _angular_core.InputSignal<string>;
+    protected readonly i18n: KptI18n;
     protected readonly itemTpl: _angular_core.Signal<TemplateRef<any>>;
     protected readonly selected: _angular_core.WritableSignal<number | null>;
     protected moveSelected(dir: -1 | 1): void;
@@ -1939,6 +2251,7 @@ declare class KptGalleria {
     readonly items: _angular_core.InputSignal<KptGalleriaItem[]>;
     readonly activeIndex: _angular_core.ModelSignal<number>;
     readonly showThumbnails: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    protected readonly i18n: KptI18n;
     protected readonly current: _angular_core.Signal<KptGalleriaItem>;
     protected next(): void;
     protected prev(): void;
@@ -1958,6 +2271,7 @@ declare class KptAlert {
     readonly title: _angular_core.InputSignal<string>;
     readonly dismissible: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly closed: _angular_core.OutputEmitterRef<void>;
+    protected readonly i18n: KptI18n;
     protected readonly visible: _angular_core.WritableSignal<boolean>;
     protected iconName(): KptIconName;
     protected dismiss(): void;
@@ -1984,6 +2298,7 @@ declare class KptDialog {
     readonly header: _angular_core.InputSignal<string>;
     /** Pozwala zamknąć klawiszem Esc / przyciskiem ×. */
     readonly dismissible: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    protected readonly i18n: KptI18n;
     private readonly dialogRef;
     constructor();
     protected onCancel(event: Event): void;
@@ -2025,6 +2340,7 @@ declare class KptToastService {
  */
 declare class KptToastContainer {
     private readonly service;
+    protected readonly i18n: KptI18n;
     protected readonly toasts: _angular_core.Signal<_konce_pt_angular.KptToast[]>;
     protected dismiss(id: number): void;
     protected icon(variant: KptAlertVariant): KptIconName;
@@ -2117,6 +2433,7 @@ declare class KptDrawer {
     readonly header: _angular_core.InputSignal<string>;
     readonly dismissible: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly closeOnBackdrop: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    protected readonly i18n: KptI18n;
     protected onBackdrop(): void;
     protected close(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptDrawer, never>;
@@ -2224,6 +2541,7 @@ declare class KptConfirmService {
  * Umieść raz w aplikacji (np. obok `<kpt-toast-container />`).
  */
 declare class KptConfirmContainer {
+    protected readonly i18n: KptI18n;
     protected readonly service: KptConfirmService;
     protected readonly req: _angular_core.Signal<_konce_pt_angular.KptConfirmRequest | null>;
     protected readonly isOpen: _angular_core.Signal<boolean>;
@@ -2244,6 +2562,7 @@ declare class KptBottomSheet {
     readonly open: _angular_core.ModelSignal<boolean>;
     readonly header: _angular_core.InputSignal<string>;
     readonly closeOnBackdrop: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    protected readonly i18n: KptI18n;
     protected onBackdrop(): void;
     protected close(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KptBottomSheet, never>;
@@ -2261,8 +2580,11 @@ declare class KptSpeedDial<T = unknown> {
     readonly items: _angular_core.InputSignal<KptMenuItem<T>[]>;
     readonly direction: _angular_core.InputSignal<KptSpeedDialDirection>;
     readonly icon: _angular_core.InputSignal<string>;
-    readonly ariaLabel: _angular_core.InputSignal<string>;
+    /** Etykieta a11y FAB (stan zamknięty); bez wartości używa i18n (`speedDial.actions`). */
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
     readonly select: _angular_core.OutputEmitterRef<KptMenuItem<T>>;
+    protected readonly i18n: KptI18n;
+    protected readonly effectiveAriaLabel: _angular_core.Signal<string>;
     protected readonly open: _angular_core.WritableSignal<boolean>;
     protected toggle(): void;
     protected close(): void;
@@ -2271,5 +2593,5 @@ declare class KptSpeedDial<T = unknown> {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<KptSpeedDial<any>, "kpt-speed-dial", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "direction": { "alias": "direction"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "select": "select"; }, never, never, true, never>;
 }
 
-export { KptAccordion, KptAccordionPanel, KptAlert, KptAppShell, KptAutocomplete, KptAvatar, KptAvatarGroup, KptBadge, KptBottomSheet, KptBreadcrumb, KptButton, KptButtonGroup, KptCard, KptCarousel, KptCellDef, KptCheckbox, KptChip, KptChipsInput, KptClock, KptColorPicker, KptConfirmContainer, KptConfirmService, KptContextMenu, KptDataTable, KptDataView, KptDateRange, KptDatepicker, KptDialog, KptDivider, KptDrawer, KptEmpty, KptFab, KptFieldset, KptFileUpload, KptFormField, KptGalleria, KptIcon, KptIconButton, KptIconRegistry, KptImage, KptInput, KptInputMask, KptInputNumber, KptInputOtp, KptKnob, KptListbox, KptMegamenu, KptMenu, KptMenubar, KptMeterGroup, KptOrderList, KptPaginator, KptPanel, KptPassword, KptPickList, KptPopover, KptProgress, KptRadioGroup, KptRating, KptRichText, KptRowDetailDef, KptScrollTop, KptSelect, KptSidenav, KptSkeleton, KptSlider, KptSpeedDial, KptSpinner, KptSplitButton, KptSplitter, KptStep, KptStepper, KptSwitch, KptSwitchGroup, KptTab, KptTabs, KptTextarea, KptTimeline, KptToastContainer, KptToastService, KptToolbar, KptTooltip, KptTree };
-export type { KptAlertVariant, KptAvatarItem, KptAvatarShape, KptAvatarSize, KptBadgeVariant, KptBreadcrumbItem, KptButtonSize, KptButtonVariant, KptCardVariant, KptChipVariant, KptColumn, KptConfirmOptions, KptConfirmRequest, KptDateRangeValue, KptDividerOrientation, KptDrawerPosition, KptGalleriaItem, KptIconName, KptInputType, KptMenuItem, KptMeterItem, KptOption, KptProgressVariant, KptRichTool, KptRichToolbar, KptSidenavMode, KptSkeletonVariant, KptSliderValue, KptSpeedDialDirection, KptSplitterOrientation, KptTableLazyState, KptTimelineItem, KptToast, KptToastOptions, KptTooltipPosition, KptTreeNode };
+export { KPT_I18N_CONFIG, KPT_MESSAGES_EN, KPT_MESSAGES_PL, KptAccordion, KptAccordionPanel, KptAlert, KptAppShell, KptAutocomplete, KptAvatar, KptAvatarGroup, KptBadge, KptBottomSheet, KptBreadcrumb, KptButton, KptButtonGroup, KptCard, KptCarousel, KptCellDef, KptCheckbox, KptChip, KptChipsInput, KptClock, KptColorPicker, KptConfirmContainer, KptConfirmService, KptContextMenu, KptDataTable, KptDataView, KptDateRange, KptDatepicker, KptDialog, KptDivider, KptDrawer, KptEmpty, KptFab, KptFieldset, KptFileUpload, KptFormField, KptGalleria, KptI18n, KptIcon, KptIconButton, KptIconRegistry, KptImage, KptInput, KptInputMask, KptInputNumber, KptInputOtp, KptKnob, KptListbox, KptMegamenu, KptMenu, KptMenubar, KptMeterGroup, KptOrderList, KptPaginator, KptPanel, KptPassword, KptPickList, KptPopover, KptProgress, KptRadioGroup, KptRating, KptRichText, KptRowDetailDef, KptScrollTop, KptSelect, KptSidenav, KptSkeleton, KptSlider, KptSpeedDial, KptSpinner, KptSplitButton, KptSplitter, KptStep, KptStepper, KptSwitch, KptSwitchGroup, KptTab, KptTabs, KptTextarea, KptTimeline, KptToastContainer, KptToastService, KptToolbar, KptTooltip, KptTree, provideKptI18n };
+export type { DeepPartial, KptAlertVariant, KptAvatarItem, KptAvatarShape, KptAvatarSize, KptBadgeVariant, KptBreadcrumbItem, KptButtonSize, KptButtonVariant, KptCardVariant, KptChipVariant, KptColumn, KptConfirmOptions, KptConfirmRequest, KptDateRangeValue, KptDividerOrientation, KptDrawerPosition, KptGalleriaItem, KptI18nConfig, KptIconName, KptInputType, KptLocale, KptMenuItem, KptMessages, KptMeterItem, KptOption, KptProgressVariant, KptRichTool, KptRichToolbar, KptSidenavMode, KptSkeletonVariant, KptSliderValue, KptSpeedDialDirection, KptSplitterOrientation, KptTableLazyState, KptTimelineItem, KptToast, KptToastOptions, KptTooltipPosition, KptTreeNode };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@konce-pt/angular",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Open-source Angular 22 component library on Signals & Signal Forms — 70+ components, rich data table, zoneless, fully tokenized. Selektory kpt-*, klasy Kpt*.",
   "license": "MIT",
   "author": "konce.pt",