@konce-pt/i18n 0.8.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 konce.pt
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,48 @@
+<p align="center">
+  <img src="https://ui.konce.pt/images/koncept_ui_lib.png" alt="Koncept UI — Angular component library" width="100%" />
+</p>
+
+# @konce-pt/i18n
+
+Kontrakt tłumaczeń i słowniki bazowe (EN, PL) dla [Koncept UI](https://gitlab.com/konce-pt/koncept-ui).
+Czysty TypeScript, **zero zależności runtime**, bez wiązania z frameworkiem — jedno źródło prawdy
+dla `@konce-pt/angular` i `@konce-pt/react`.
+
+Zwykle nie instalujesz tego pakietu samodzielnie: biblioteki komponentów re-eksportują jego API
+(`provideKptI18n` / `KptI18n` w Angularze, `KptI18nProvider` / `useKptI18n` w Reakcie).
+Sięgnij po niego wprost, gdy piszesz własny słownik albo własne wiązanie frameworkowe.
+
+```bash
+npm i @konce-pt/i18n
+```
+
+```ts
+import { KPT_MESSAGES_PL, translate } from '@konce-pt/i18n';
+
+translate(KPT_MESSAGES_PL, 'paginator.range', { start: 1, end: 10, total: 42 });
+// '1–10 z 42'
+
+translate(KPT_MESSAGES_PL, 'nope.missing');
+// 'nope.missing' — brak klucza spada na EN, a potem na sam klucz
+```
+
+## API
+
+| Eksport | Typ | Opis |
+|---|---|---|
+| `KptMessages` | `interface` | Kontrakt wszystkich etykiet UI biblioteki |
+| `KptLocale` | `type` | `'en' \| 'pl' \| (string & {})` — otwarty kod języka |
+| `KPT_MESSAGES_EN` / `KPT_MESSAGES_PL` | `KptMessages` | Słowniki bazowe |
+| `translate(dict, key, params?)` | `string` | Klucz kropkowy + interpolacja `{name}`, fallback → EN → klucz |
+| `lookup(dict, key)` | `string \| undefined` | Surowa wartość spod klucza kropkowego |
+| `deepMerge(base, patch)` | `T` | Nakłada częściowy słownik na pełny |
+| `weekdayNames(locale)` | `string[]` | Skrócone nazwy dni, od poniedziałku |
+| `monthNames(locale)` | `string[]` | Pełne nazwy miesięcy |
+| `DeepPartial<T>`, `KptI18nConfig` | `type` | Typy używane przez wiązania frameworkowe |
+
+Nazw dni i miesięcy nie ma w słowniku — wyliczają się z `Intl` dla aktywnego locale, więc
+kalendarze działają także w języku, którego nikt nie tłumaczył ręcznie.
+
+## Licencja
+
+MIT © konce.pt

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { KPT_MESSAGES_EN, KPT_MESSAGES_PL } from './messages.ts';
+export type { KptLocale, KptMessages } from './messages.ts';
+export { deepMerge, lookup, translate } from './translate.ts';
+export type { DeepPartial, KptI18nConfig } from './types.ts';
+export { monthNames, weekdayNames } from './intl.ts';

package/dist/index.js

@@ -0,0 +1,10 @@
+/*
+ * @konce-pt/i18n — kontrakt tłumaczeń i słowniki bazowe Koncept UI.
+ *
+ * Czysty TypeScript, zero zależności runtime. Współdzielony przez
+ * `@konce-pt/angular` (serwis na sygnałach) i `@konce-pt/react` (Context + hook),
+ * żeby oba porty miały jedno źródło prawdy dla etykiet EN/PL.
+ */
+export { KPT_MESSAGES_EN, KPT_MESSAGES_PL } from "./messages.js";
+export { deepMerge, lookup, translate } from "./translate.js";
+export { monthNames, weekdayNames } from "./intl.js";

package/dist/intl.d.ts

@@ -0,0 +1,4 @@
+/** Krótkie nazwy dni tygodnia, zaczynając od poniedziałku (Pn…Nd). */
+export declare function weekdayNames(locale: string): string[];
+/** Pełne nazwy miesięcy (styczeń…grudzień / January…December). */
+export declare function monthNames(locale: string): string[];

package/dist/intl.js

@@ -0,0 +1,16 @@
+/*
+ * Pomocniki nazw dni/miesięcy wyliczane z `Intl` — sterowane bieżącym locale i18n.
+ * Dzięki temu kalendarze (`kpt-datepicker`, `kpt-date-range`) nie trzymają
+ * zaszytych tablic nazw i działają dla dowolnego języka.
+ */
+/** Krótkie nazwy dni tygodnia, zaczynając od poniedziałku (Pn…Nd). */
+export function weekdayNames(locale) {
+    const fmt = new Intl.DateTimeFormat(locale, { weekday: 'short' });
+    // 2024-01-01 (UTC) to poniedziałek.
+    return Array.from({ length: 7 }, (_, i) => fmt.format(new Date(Date.UTC(2024, 0, 1 + i))));
+}
+/** Pełne nazwy miesięcy (styczeń…grudzień / January…December). */
+export function monthNames(locale) {
+    const fmt = new Intl.DateTimeFormat(locale, { month: 'long' });
+    return Array.from({ length: 12 }, (_, i) => fmt.format(new Date(Date.UTC(2024, i, 1))));
+}

package/dist/messages.d.ts

@@ -0,0 +1,367 @@
+/** Kod języka. Otwarty string — EN/PL mają podpowiedzi, ale dozwolony dowolny. */
+export type KptLocale = 'en' | 'pl' | (string & {});
+/** Pełny słownik etykiet UI używanych przez komponenty biblioteki. */
+export 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;
+    };
+    roadmap: {
+        empty: string;
+        /** Prefiks numeru tygodnia na osi, np. „W" w „W35". */
+        week: string;
+        today: string;
+        milestone: string;
+        expandGroup: string;
+        collapseGroup: string;
+    };
+    map: {
+        /** Pozycja menu po kliknięciu mapy prawym przyciskiem. */
+        addLocation: string;
+        chooseCategory: string;
+        myLocation: string;
+        locateMe: string;
+        locationDenied: string;
+        locationUnavailable: string;
+        zoomIn: string;
+        zoomOut: string;
+        legend: string;
+        /** Interpolacja: {category}. */
+        showCategory: string;
+        /** Interpolacja: {category}. */
+        hideCategory: string;
+        /** Etykieta grupy znaczników dla czytnika ekranu. Interpolacja: {count}. */
+        cluster: string;
+        /** Nagłówek listy pokazywanej, gdy grupy nie da się rozbić zoomem. */
+        clusterItems: string;
+        /** Interpolacja: {label}. */
+        fieldRequired: string;
+        /** Notka w formularzu, gdy trwa geokodowanie wsteczne. */
+        lookingUpAddress: string;
+        /** Notka, gdy geokoder nie ustalił adresu dla klikniętego punktu. */
+        addressNotFound: string;
+        latitude: string;
+        longitude: string;
+        empty: string;
+        save: string;
+        cancel: string;
+        /** Karta miejsca (`kpt-map-poi-card`). */
+        poi: {
+            /** Interpolacja: {distance}. */
+            distanceAway: string;
+            openNow: string;
+            closedNow: string;
+            /** Interpolacja: {time}. */
+            opensAt: string;
+            /** Interpolacja: {time}. */
+            closesAt: string;
+            alwaysOpen: string;
+            openingHours: string;
+            closedDay: string;
+            call: string;
+            sendEmail: string;
+            openWebsite: string;
+            coordinates: string;
+            copy: string;
+            copied: string;
+            share: string;
+            addFavourite: string;
+            removeFavourite: string;
+            noPhoto: string;
+        };
+        /** Wyszukiwarka adresów (`kpt-map-search`). */
+        search: {
+            /** Podpowiedź w pustym polu. */
+            placeholder: string;
+            /** Nazwa dostępna pola — nie ma przy nim widocznej etykiety. */
+            label: string;
+            /** Etykieta listy podpowiedzi dla czytnika ekranu. */
+            results: string;
+            clear: string;
+            noResults: string;
+            /** Fraza za krótka. Interpolacja: {count}. */
+            minLength: string;
+            searching: string;
+            /** Liczba znalezionych podpowiedzi dla czytnika. Interpolacja: {count}. */
+            found: string;
+        };
+        /** Pola formularza „dodaj lokalizację" poza wspólnymi komunikatami. */
+        field: {
+            invalidEmail: string;
+            invalidUrl: string;
+            /** Interpolacja: {max}. */
+            imageTooLarge: string;
+            pickImage: string;
+            orPasteUrl: string;
+            removeImage: string;
+            imagePreview: string;
+            hoursClosed: string;
+            hoursFrom: string;
+            hoursTo: string;
+            hoursSameAllWeek: string;
+            hoursAddRange: string;
+            hoursRemoveRange: string;
+            /** Interpolacja: {day}. */
+            hoursIncomplete: 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;
+        /** Interpolacja: {column}. Aria-label edytowalnej komórki. */
+        editCell: string;
+        /** Domyślna etykieta wiersza podsumowania (input `summaryLabel` ma priorytet). */
+        total: 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;
+        prevDecades: string;
+        nextDecades: string;
+        chooseMonth: string;
+        chooseYear: string;
+        chooseDecade: 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];
+    };
+    rating: {
+        /** Etykieta gwiazdki; interpolacja `{value}` i `{max}`. */
+        star: string;
+    };
+    tree: {
+        expand: string;
+        collapse: string;
+    };
+    spinner: {
+        label: string;
+    };
+    speedDial: {
+        actions: string;
+    };
+    scrollTop: {
+        label: string;
+    };
+    splitButton: {
+        more: string;
+    };
+    panel: {
+        toggle: string;
+    };
+    appShell: {
+        /** Etykieta przycisku otwierającego i zamykającego panel boczny. */
+        toggleNavigation: string;
+        /** Etykieta dostępności panelu bocznego. */
+        navigation: 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;
+        indent: string;
+        outdent: 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;
+        };
+    };
+    /** Ekran uwierzytelniania (kpt-auth). */
+    auth: {
+        signInTitle: string;
+        signInSubtitle: string;
+        signUpTitle: string;
+        signUpSubtitle: string;
+        forgotTitle: string;
+        forgotSubtitle: string;
+        name: string;
+        email: string;
+        emailPlaceholder: string;
+        password: string;
+        /** Interpolacja: {min} — minimalna długość hasła. */
+        passwordHint: string;
+        confirmPassword: string;
+        remember: string;
+        terms: string;
+        forgotLink: string;
+        backToSignIn: string;
+        signInSubmit: string;
+        signUpSubmit: string;
+        resetSubmit: string;
+        orContinueWith: string;
+        /** Interpolacja: {provider} — nazwa dostawcy (etykieta przycisku). */
+        continueWith: string;
+        noAccount: string;
+        haveAccount: string;
+        signInSwitch: string;
+        signUpSwitch: string;
+        errorRequired: string;
+        errorEmail: string;
+        /** Interpolacja: {min}. */
+        errorMinLength: string;
+        errorMismatch: string;
+        errorInvalid: string;
+        /** Treść panelu promocyjnego — zachęca do trybu przeciwnego niż bieżący. */
+        promo: {
+            signInTitle: string;
+            signInText: string;
+            signUpTitle: string;
+            signUpText: string;
+        };
+    };
+}
+export declare const KPT_MESSAGES_EN: KptMessages;
+export declare const KPT_MESSAGES_PL: KptMessages;

package/dist/messages.js

@@ -0,0 +1,642 @@
+/*
+ * Kontrakt tłumaczeń Koncept UI + słowniki bazowe (EN, PL).
+ *
+ * Plik jest celowo wolny od zależności frameworka — to czysty TypeScript/JSON.
+ * Dzięki temu ten sam kontrakt (`KptMessages`) i te same słowniki obsługują
+ * `@konce-pt/angular` (serwis na sygnałach) i `@konce-pt/react` (Context + hook).
+ *
+ * Autor nowego języka wypełnia strukturę `KptMessages` (np. `de.json`) i podaje
+ * ją przez `provideKptI18n({ locale: 'de', messages: { de } })` w Angularze albo
+ * `<KptI18nProvider locale="de" messages={{ de }}>` w Reakcie. Brakujące klucze
+ * spadają na fallback EN.
+ */
+export const KPT_MESSAGES_EN = {
+    common: {
+        close: 'Close',
+        remove: 'Remove',
+        previous: 'Previous',
+        next: 'Next',
+        clear: 'Clear',
+        done: 'Done',
+        all: 'All',
+    },
+    paginator: {
+        rowsPerPage: 'Rows:',
+        range: '{start}–{end} of {total}',
+        prevPage: 'Previous page',
+        nextPage: 'Next page',
+    },
+    select: {
+        search: 'Search…',
+        noResults: 'No results',
+        removeChip: 'Remove',
+    },
+    listbox: {
+        search: 'Search…',
+        empty: 'No items',
+    },
+    dataView: {
+        list: 'List',
+        grid: 'Grid',
+        empty: 'No items',
+        count: '{count} items',
+    },
+    roadmap: {
+        empty: 'No items on the roadmap',
+        week: 'W',
+        today: 'Today',
+        milestone: 'Milestone',
+        expandGroup: 'Expand group',
+        collapseGroup: 'Collapse group',
+    },
+    map: {
+        addLocation: 'Add location',
+        chooseCategory: 'Choose a category',
+        myLocation: 'My location',
+        locateMe: 'Centre on my location',
+        locationDenied: 'Location access denied',
+        locationUnavailable: 'Location unavailable',
+        zoomIn: 'Zoom in',
+        zoomOut: 'Zoom out',
+        legend: 'Legend',
+        showCategory: 'Show {category}',
+        hideCategory: 'Hide {category}',
+        cluster: 'Group of {count} locations',
+        clusterItems: 'Locations in this group',
+        fieldRequired: '{label} is required',
+        lookingUpAddress: 'Looking up the address…',
+        addressNotFound: 'No address found for this point',
+        latitude: 'Latitude',
+        longitude: 'Longitude',
+        empty: 'No locations',
+        save: 'Save',
+        cancel: 'Cancel',
+        poi: {
+            distanceAway: '{distance} away',
+            openNow: 'Open',
+            closedNow: 'Closed',
+            opensAt: 'opens at {time}',
+            closesAt: 'closes at {time}',
+            alwaysOpen: 'Open 24/7',
+            openingHours: 'Opening hours',
+            closedDay: 'Closed',
+            call: 'Call',
+            sendEmail: 'Send an e-mail',
+            openWebsite: 'Open the website',
+            coordinates: 'Coordinates',
+            copy: 'Copy',
+            copied: 'Copied',
+            share: 'Share',
+            addFavourite: 'Add to favourites',
+            removeFavourite: 'Remove from favourites',
+            noPhoto: 'No photo',
+        },
+        search: {
+            placeholder: 'Search for an address…',
+            label: 'Search for an address',
+            results: 'Address suggestions',
+            clear: 'Clear the search',
+            noResults: 'No matching places',
+            minLength: 'Type at least {count} characters',
+            searching: 'Searching…',
+            found: '{count} suggestions',
+        },
+        field: {
+            invalidEmail: 'Enter a valid e-mail address',
+            invalidUrl: 'Enter an address starting with http:// or https://',
+            imageTooLarge: 'The picture must be no larger than {max}',
+            pickImage: 'Pick a picture',
+            orPasteUrl: 'or paste a picture address',
+            removeImage: 'Remove the picture',
+            imagePreview: 'Picture preview',
+            hoursClosed: 'Closed',
+            hoursFrom: 'From',
+            hoursTo: 'To',
+            hoursSameAllWeek: 'Same all week',
+            hoursAddRange: 'Add a second range',
+            hoursRemoveRange: 'Remove the range',
+            hoursIncomplete: 'Set both times for {day} or mark the day as closed',
+        },
+    },
+    dataTable: {
+        search: 'Search…',
+        exportCsv: 'Export CSV',
+        loading: 'Loading…',
+        empty: 'No data',
+        selectAll: 'Select all',
+        selectRow: 'Select row',
+        expandRow: 'Expand row',
+        filter: 'Filter: {column}',
+        filterMin: 'Filter min: {column}',
+        filterMax: 'Filter max: {column}',
+        all: 'All',
+        dateRange: 'Date range',
+        min: 'min',
+        max: 'max',
+        editCell: 'Edit: {column}',
+        total: 'Total',
+    },
+    confirm: {
+        header: 'Confirmation',
+        accept: 'Confirm',
+        reject: 'Cancel',
+    },
+    fileUpload: {
+        hint: '<strong>Click</strong> or drag files here',
+        remove: 'Remove',
+    },
+    chipsInput: {
+        placeholder: 'Add and press Enter…',
+    },
+    dateRange: {
+        placeholder: 'Select range',
+        from: 'From',
+        to: 'To',
+        fromTime: 'From (time)',
+        toTime: 'To (time)',
+    },
+    datepicker: {
+        prevMonth: 'Previous month',
+        nextMonth: 'Next month',
+        prevYear: 'Previous year',
+        nextYear: 'Next year',
+        prevYears: 'Previous years',
+        nextYears: 'Next years',
+        prevDecades: 'Previous decades',
+        nextDecades: 'Next decades',
+        chooseMonth: 'Choose month',
+        chooseYear: 'Choose year',
+        chooseDecade: 'Choose decade',
+        calendar: 'Calendar',
+        month: 'Month',
+        time: 'Time',
+    },
+    pickList: {
+        available: 'Available',
+        selected: 'Selected',
+        moveAllRight: 'Move all right',
+        moveRight: 'Move right',
+        moveLeft: 'Move left',
+        moveAllLeft: 'Move all left',
+    },
+    orderList: {
+        up: 'Up',
+        down: 'Down',
+    },
+    inputNumber: {
+        decrement: 'Decrease',
+        increment: 'Increase',
+    },
+    password: {
+        show: 'Show password',
+        hide: 'Hide password',
+        strength: ['Very weak', 'Weak', 'Medium', 'Good', 'Strong'],
+    },
+    rating: {
+        star: '{value} of {max}',
+    },
+    tree: {
+        expand: 'Expand',
+        collapse: 'Collapse',
+    },
+    spinner: {
+        label: 'Loading',
+    },
+    speedDial: {
+        actions: 'Actions',
+    },
+    scrollTop: {
+        label: 'Scroll to top',
+    },
+    splitButton: {
+        more: 'More actions',
+    },
+    panel: {
+        toggle: 'Collapse / expand',
+    },
+    appShell: {
+        toggleNavigation: 'Toggle navigation',
+        navigation: 'Main navigation',
+    },
+    breadcrumb: {
+        label: 'breadcrumb',
+    },
+    galleria: {
+        image: 'Image {index}',
+    },
+    carousel: {
+        slide: 'Slide {index}',
+    },
+    richText: {
+        copy: 'Copy',
+        paste: 'Paste with formatting',
+        pasteText: 'Paste without formatting',
+        heading: 'Style',
+        bold: 'Bold',
+        italic: 'Italic',
+        underline: 'Underline',
+        strike: 'Strikethrough',
+        ul: 'Bulleted list',
+        ol: 'Numbered list',
+        indent: 'Increase indent',
+        outdent: 'Decrease indent',
+        foreColor: 'Text color',
+        backColor: 'Text background color',
+        alignLeft: 'Align left',
+        alignCenter: 'Center',
+        alignRight: 'Align right',
+        alignJustify: 'Justify',
+        link: 'Insert link',
+        table: 'Table',
+        clear: 'Clear formatting',
+        html: 'HTML preview',
+        styleNormal: 'Normal',
+        styleHeading: 'Heading {level}',
+        linkPrompt: 'URL:',
+        htmlSource: 'HTML source',
+        paletteCustom: 'Custom…',
+        menu: {
+            column: 'Column',
+            row: 'Row',
+            cell: 'Cell',
+            insertLeft: 'Insert left',
+            insertRight: 'Insert right',
+            headerColumn: 'Header column',
+            deleteColumn: 'Delete column',
+            insertAbove: 'Insert above',
+            insertBelow: 'Insert below',
+            headerRow: 'Header row',
+            deleteRow: 'Delete row',
+            cellBackground: 'Background color',
+            alignLeft: 'Left',
+            alignCenter: 'Center',
+            alignRight: 'Right',
+            mergeCells: 'Merge cells',
+            splitCell: 'Split cell',
+            border: 'Border…',
+            deleteTable: 'Delete table',
+        },
+        border: {
+            table: 'Table',
+            cell: 'Cell',
+            none: 'None',
+            thin: 'Thin',
+            medium: 'Medium',
+            thick: 'Thick',
+            customColor: 'Color…',
+        },
+    },
+    auth: {
+        signInTitle: 'Sign in',
+        signInSubtitle: 'Use your e-mail and password.',
+        signUpTitle: 'Create account',
+        signUpSubtitle: 'It takes less than a minute.',
+        forgotTitle: 'Reset password',
+        forgotSubtitle: 'We will send a reset link to your e-mail.',
+        name: 'Full name',
+        email: 'E-mail',
+        emailPlaceholder: 'you@company.com',
+        password: 'Password',
+        passwordHint: 'At least {min} characters.',
+        confirmPassword: 'Repeat password',
+        remember: 'Remember me',
+        terms: 'I accept the terms of service',
+        forgotLink: 'Forgot password?',
+        backToSignIn: 'Back to sign in',
+        signInSubmit: 'Sign in',
+        signUpSubmit: 'Create account',
+        resetSubmit: 'Send reset link',
+        orContinueWith: 'or continue with',
+        continueWith: 'Continue with {provider}',
+        noAccount: 'No account yet?',
+        haveAccount: 'Already have an account?',
+        signInSwitch: 'Sign in',
+        signUpSwitch: 'Sign up',
+        errorRequired: 'This field is required',
+        errorEmail: 'Enter a valid e-mail address',
+        errorMinLength: 'Use at least {min} characters',
+        errorMismatch: 'Passwords do not match',
+        errorInvalid: 'Invalid value',
+        promo: {
+            signInTitle: 'Welcome back',
+            signInText: 'Sign in to pick up where you left off.',
+            signUpTitle: 'New here?',
+            signUpText: 'Create an account and start in a minute.',
+        },
+    },
+};
+export const KPT_MESSAGES_PL = {
+    common: {
+        close: 'Zamknij',
+        remove: 'Usuń',
+        previous: 'Poprzedni',
+        next: 'Następny',
+        clear: 'Wyczyść',
+        done: 'Gotowe',
+        all: 'Wszystkie',
+    },
+    paginator: {
+        rowsPerPage: 'Wierszy:',
+        range: '{start}–{end} z {total}',
+        prevPage: 'Poprzednia strona',
+        nextPage: 'Następna strona',
+    },
+    select: {
+        search: 'Szukaj…',
+        noResults: 'Brak wyników',
+        removeChip: 'Usuń',
+    },
+    listbox: {
+        search: 'Szukaj…',
+        empty: 'Brak pozycji',
+    },
+    dataView: {
+        list: 'Lista',
+        grid: 'Siatka',
+        empty: 'Brak elementów',
+        count: '{count} elementów',
+    },
+    roadmap: {
+        empty: 'Brak elementów na roadmapie',
+        week: 'T',
+        today: 'Dziś',
+        milestone: 'Kamień milowy',
+        expandGroup: 'Rozwiń grupę',
+        collapseGroup: 'Zwiń grupę',
+    },
+    map: {
+        addLocation: 'Dodaj lokalizację',
+        chooseCategory: 'Wybierz kategorię',
+        myLocation: 'Moje położenie',
+        locateMe: 'Wyśrodkuj na moim położeniu',
+        locationDenied: 'Brak zgody na dostęp do lokalizacji',
+        locationUnavailable: 'Położenie niedostępne',
+        zoomIn: 'Przybliż',
+        zoomOut: 'Oddal',
+        legend: 'Legenda',
+        showCategory: 'Pokaż: {category}',
+        hideCategory: 'Ukryj: {category}',
+        cluster: 'Grupa {count} lokalizacji',
+        clusterItems: 'Lokalizacje w tej grupie',
+        fieldRequired: 'Pole „{label}" jest wymagane',
+        lookingUpAddress: 'Szukam adresu…',
+        addressNotFound: 'Nie znaleziono adresu dla tego punktu',
+        latitude: 'Szerokość',
+        longitude: 'Długość',
+        empty: 'Brak lokalizacji',
+        save: 'Zapisz',
+        cancel: 'Anuluj',
+        poi: {
+            distanceAway: '{distance} od Ciebie',
+            openNow: 'Otwarte',
+            closedNow: 'Zamknięte',
+            opensAt: 'otwarcie o {time}',
+            closesAt: 'zamknięcie o {time}',
+            alwaysOpen: 'Czynne całą dobę',
+            openingHours: 'Godziny otwarcia',
+            closedDay: 'Zamknięte',
+            call: 'Zadzwoń',
+            sendEmail: 'Napisz wiadomość',
+            openWebsite: 'Otwórz stronę',
+            coordinates: 'Współrzędne',
+            copy: 'Kopiuj',
+            copied: 'Skopiowano',
+            share: 'Udostępnij',
+            addFavourite: 'Dodaj do ulubionych',
+            removeFavourite: 'Usuń z ulubionych',
+            noPhoto: 'Brak zdjęcia',
+        },
+        search: {
+            placeholder: 'Szukaj adresu…',
+            label: 'Szukaj adresu',
+            results: 'Podpowiedzi adresów',
+            clear: 'Wyczyść wyszukiwanie',
+            noResults: 'Brak pasujących miejsc',
+            minLength: 'Wpisz więcej znaków (minimum: {count})',
+            searching: 'Szukam…',
+            found: 'Podpowiedzi: {count}',
+        },
+        field: {
+            invalidEmail: 'Podaj poprawny adres e-mail',
+            invalidUrl: 'Podaj adres zaczynający się od http:// albo https://',
+            imageTooLarge: 'Zdjęcie może mieć najwyżej {max}',
+            pickImage: 'Wybierz zdjęcie',
+            orPasteUrl: 'albo wklej adres zdjęcia',
+            removeImage: 'Usuń zdjęcie',
+            imagePreview: 'Podgląd zdjęcia',
+            hoursClosed: 'Zamknięte',
+            hoursFrom: 'Od',
+            hoursTo: 'Do',
+            hoursSameAllWeek: 'Tak samo przez cały tydzień',
+            hoursAddRange: 'Dodaj drugi przedział',
+            hoursRemoveRange: 'Usuń przedział',
+            hoursIncomplete: 'Podaj obie godziny dla dnia {day} albo oznacz go jako zamknięty',
+        },
+    },
+    dataTable: {
+        search: 'Szukaj…',
+        exportCsv: 'Eksport CSV',
+        loading: 'Ładowanie…',
+        empty: 'Brak danych',
+        selectAll: 'Zaznacz wszystkie',
+        selectRow: 'Zaznacz wiersz',
+        expandRow: 'Rozwiń wiersz',
+        filter: 'Filtr: {column}',
+        filterMin: 'Filtr min: {column}',
+        filterMax: 'Filtr max: {column}',
+        all: 'Wszystkie',
+        dateRange: 'Zakres dat',
+        min: 'min',
+        max: 'max',
+        editCell: 'Edytuj: {column}',
+        total: 'Razem',
+    },
+    confirm: {
+        header: 'Potwierdzenie',
+        accept: 'Potwierdź',
+        reject: 'Anuluj',
+    },
+    fileUpload: {
+        hint: '<strong>Kliknij</strong> lub przeciągnij pliki tutaj',
+        remove: 'Usuń',
+    },
+    chipsInput: {
+        placeholder: 'Dodaj i naciśnij Enter…',
+    },
+    dateRange: {
+        placeholder: 'Wybierz zakres',
+        from: 'Od',
+        to: 'Koniec',
+        fromTime: 'Od (godzina)',
+        toTime: 'Koniec (godzina)',
+    },
+    datepicker: {
+        prevMonth: 'Poprzedni miesiąc',
+        nextMonth: 'Następny miesiąc',
+        prevYear: 'Poprzedni rok',
+        nextYear: 'Następny rok',
+        prevYears: 'Poprzednie lata',
+        nextYears: 'Następne lata',
+        prevDecades: 'Poprzednie dekady',
+        nextDecades: 'Następne dekady',
+        chooseMonth: 'Wybierz miesiąc',
+        chooseYear: 'Wybierz rok',
+        chooseDecade: 'Wybierz dekadę',
+        calendar: 'Kalendarz',
+        month: 'Miesiąc',
+        time: 'Godzina',
+    },
+    pickList: {
+        available: 'Dostępne',
+        selected: 'Wybrane',
+        moveAllRight: 'Przenieś wszystko w prawo',
+        moveRight: 'Przenieś w prawo',
+        moveLeft: 'Przenieś w lewo',
+        moveAllLeft: 'Przenieś wszystko w lewo',
+    },
+    orderList: {
+        up: 'W górę',
+        down: 'W dół',
+    },
+    inputNumber: {
+        decrement: 'Zmniejsz',
+        increment: 'Zwiększ',
+    },
+    password: {
+        show: 'Pokaż hasło',
+        hide: 'Ukryj hasło',
+        strength: ['Bardzo słabe', 'Słabe', 'Średnie', 'Dobre', 'Silne'],
+    },
+    rating: {
+        star: '{value} z {max}',
+    },
+    tree: {
+        expand: 'Rozwiń',
+        collapse: 'Zwiń',
+    },
+    spinner: {
+        label: 'Ładowanie',
+    },
+    speedDial: {
+        actions: 'Akcje',
+    },
+    scrollTop: {
+        label: 'Przewiń do góry',
+    },
+    splitButton: {
+        more: 'Więcej akcji',
+    },
+    panel: {
+        toggle: 'Zwiń / rozwiń',
+    },
+    appShell: {
+        toggleNavigation: 'Przełącz nawigację',
+        navigation: 'Nawigacja główna',
+    },
+    breadcrumb: {
+        label: 'breadcrumb',
+    },
+    galleria: {
+        image: 'Obraz {index}',
+    },
+    carousel: {
+        slide: 'Slajd {index}',
+    },
+    richText: {
+        copy: 'Kopiuj',
+        paste: 'Wklej z formatowaniem',
+        pasteText: 'Wklej bez formatowania',
+        heading: 'Styl',
+        bold: 'Pogrubienie',
+        italic: 'Kursywa',
+        underline: 'Podkreślenie',
+        strike: 'Przekreślenie',
+        ul: 'Lista punktowana',
+        ol: 'Lista numerowana',
+        indent: 'Dodaj wcięcie',
+        outdent: 'Usuń wcięcie',
+        foreColor: 'Kolor tekstu',
+        backColor: 'Kolor tła tekstu',
+        alignLeft: 'Wyrównaj do lewej',
+        alignCenter: 'Wyśrodkuj',
+        alignRight: 'Wyrównaj do prawej',
+        alignJustify: 'Wyjustuj',
+        link: 'Wstaw link',
+        table: 'Tabela',
+        clear: 'Usuń formatowanie',
+        html: 'Podgląd HTML',
+        styleNormal: 'Normalny',
+        styleHeading: 'Nagłówek {level}',
+        linkPrompt: 'Adres URL:',
+        htmlSource: 'Źródło HTML',
+        paletteCustom: 'Własny…',
+        menu: {
+            column: 'Kolumna',
+            row: 'Wiersz',
+            cell: 'Komórka',
+            insertLeft: 'Wstaw z lewej',
+            insertRight: 'Wstaw z prawej',
+            headerColumn: 'Nagłówek kolumny',
+            deleteColumn: 'Usuń kolumnę',
+            insertAbove: 'Wstaw powyżej',
+            insertBelow: 'Wstaw poniżej',
+            headerRow: 'Nagłówek wiersza',
+            deleteRow: 'Usuń wiersz',
+            cellBackground: 'Kolor tła',
+            alignLeft: 'Do lewej',
+            alignCenter: 'Wyśrodkuj',
+            alignRight: 'Do prawej',
+            mergeCells: 'Scal komórki',
+            splitCell: 'Podziel komórkę',
+            border: 'Obramowanie…',
+            deleteTable: 'Usuń tabelę',
+        },
+        border: {
+            table: 'Tabela',
+            cell: 'Komórka',
+            none: 'Bez',
+            thin: 'Cienkie',
+            medium: 'Średnie',
+            thick: 'Grube',
+            customColor: 'Kolor…',
+        },
+    },
+    auth: {
+        signInTitle: 'Zaloguj się',
+        signInSubtitle: 'Użyj adresu e-mail i hasła.',
+        signUpTitle: 'Załóż konto',
+        signUpSubtitle: 'Zajmie mniej niż minutę.',
+        forgotTitle: 'Zresetuj hasło',
+        forgotSubtitle: 'Wyślemy link do zmiany hasła na podany adres.',
+        name: 'Imię i nazwisko',
+        email: 'E-mail',
+        emailPlaceholder: 'jan@firma.pl',
+        password: 'Hasło',
+        passwordHint: 'Co najmniej {min} znaków.',
+        confirmPassword: 'Powtórz hasło',
+        remember: 'Zapamiętaj mnie',
+        terms: 'Akceptuję regulamin',
+        forgotLink: 'Nie pamiętasz hasła?',
+        backToSignIn: 'Wróć do logowania',
+        signInSubmit: 'Zaloguj się',
+        signUpSubmit: 'Załóż konto',
+        resetSubmit: 'Wyślij link',
+        orContinueWith: 'lub kontynuuj przez',
+        continueWith: 'Kontynuuj przez {provider}',
+        noAccount: 'Nie masz jeszcze konta?',
+        haveAccount: 'Masz już konto?',
+        signInSwitch: 'Zaloguj się',
+        signUpSwitch: 'Załóż konto',
+        errorRequired: 'To pole jest wymagane',
+        errorEmail: 'Podaj poprawny adres e-mail',
+        errorMinLength: 'Użyj co najmniej {min} znaków',
+        errorMismatch: 'Hasła nie są takie same',
+        errorInvalid: 'Nieprawidłowa wartość',
+        promo: {
+            signInTitle: 'Witaj ponownie',
+            signInText: 'Zaloguj się, by wrócić do pracy.',
+            signUpTitle: 'Pierwszy raz u nas?',
+            signUpText: 'Załóż konto i zacznij w minutę.',
+        },
+    },
+};

package/dist/translate.d.ts

@@ -0,0 +1,11 @@
+import { type KptMessages } from './messages.ts';
+import type { DeepPartial } from './types.ts';
+/** Deep-merge `patch` na kopię `base` (łączy tylko obiekty, wartości nadpisuje). */
+export declare function deepMerge<T>(base: T, patch: DeepPartial<T>): T;
+/** Zwraca string spod klucza w notacji kropkowej albo `undefined`, gdy go nie ma. */
+export declare function lookup(dict: KptMessages, key: string): string | undefined;
+/**
+ * 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.
+ */
+export declare function translate(dict: KptMessages, key: string, params?: Record<string, string | number>): string;

package/dist/translate.js

@@ -0,0 +1,45 @@
+/*
+ * Rdzeń tłumaczeń — czysty TypeScript, bez zależności od frameworka.
+ *
+ * Angular owija te funkcje w serwis na sygnałach (`KptI18n`), React w Context
+ * i hook (`useKptI18n`). Semantyka wyszukiwania, fallbacku i interpolacji żyje
+ * tutaj, żeby oba porty zachowywały się identycznie.
+ */
+import { KPT_MESSAGES_EN } from "./messages.js";
+/** Deep-merge `patch` na kopię `base` (łączy tylko obiekty, wartości nadpisuje). */
+export function deepMerge(base, patch) {
+    const out = { ...base };
+    for (const [key, value] of Object.entries(patch)) {
+        const current = out[key];
+        if (value && typeof value === 'object' && !Array.isArray(value) && current && typeof current === 'object') {
+            out[key] = deepMerge(current, value);
+        }
+        else if (value !== undefined) {
+            out[key] = value;
+        }
+    }
+    return out;
+}
+/** Zwraca string spod klucza w notacji kropkowej albo `undefined`, gdy go nie ma. */
+export function lookup(dict, key) {
+    let node = dict;
+    for (const part of key.split('.')) {
+        if (node && typeof node === 'object' && part in node) {
+            node = node[part];
+        }
+        else {
+            return undefined;
+        }
+    }
+    return typeof node === 'string' ? node : undefined;
+}
+/**
+ * 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.
+ */
+export function translate(dict, key, params) {
+    const raw = lookup(dict, key) ?? lookup(KPT_MESSAGES_EN, key) ?? key;
+    if (!params)
+        return raw;
+    return raw.replace(/\{(\w+)\}/g, (_, name) => String(params[name] ?? `{${name}}`));
+}

package/dist/types.d.ts

@@ -0,0 +1,16 @@
+import type { KptLocale, KptMessages } from './messages.ts';
+/** Głęboko-opcjonalna wersja typu — dla nadpisań/częściowych słowników. */
+export type DeepPartial<T> = {
+    [K in keyof T]?: T[K] extends object ? DeepPartial<T[K]> : T[K];
+};
+/** Konfiguracja i18n — wspólna dla portu Angulara i Reacta. */
+export 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>>;
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@konce-pt/i18n",
+  "version": "0.8.0",
+  "description": "Translation contract and base dictionaries (EN, PL) for Koncept UI — shared by the Angular and React ports. Pure TypeScript, zero runtime dependencies.",
+  "license": "MIT",
+  "author": "konce.pt",
+  "homepage": "https://ui.konce.pt/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitlab.com/konce-pt/koncept-ui.git",
+    "directory": "packages/i18n"
+  },
+  "bugs": {
+    "url": "https://gitlab.com/konce-pt/koncept-ui/-/issues"
+  },
+  "keywords": [
+    "i18n",
+    "internationalization",
+    "translations",
+    "design-system",
+    "koncept-ui",
+    "kpt"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "devDependencies": {
+    "typescript": "~6.0.3"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\""
+  }
+}