@judo/i18n 0.1.0

package/LICENSE

@@ -0,0 +1,277 @@
+Eclipse Public License - v 2.0
+
+    THE ACCOMPANYING PROGRAM IS PROVIDED UNDER THE TERMS OF THIS ECLIPSE
+    PUBLIC LICENSE ("AGREEMENT"). ANY USE, REPRODUCTION OR DISTRIBUTION
+    OF THE PROGRAM CONSTITUTES RECIPIENT'S ACCEPTANCE OF THIS AGREEMENT.
+
+1. DEFINITIONS
+
+"Contribution" means:
+
+  a) in the case of the initial Contributor, the initial content
+     Distributed under this Agreement, and
+
+  b) in the case of each subsequent Contributor:
+     i) changes to the Program, and
+     ii) additions to the Program;
+  where such changes and/or additions to the Program originate from
+  and are Distributed by that particular Contributor. A Contribution
+  "originates" from a Contributor if it was added to the Program by
+  such Contributor itself or anyone acting on such Contributor's behalf.
+  Contributions do not include changes or additions to the Program that
+  are not Modified Works.
+
+"Contributor" means any person or entity that Distributes the Program.
+
+"Licensed Patents" mean patent claims licensable by a Contributor which
+are necessarily infringed by the use or sale of its Contribution alone
+or when combined with the Program.
+
+"Program" means the Contributions Distributed in accordance with this
+Agreement.
+
+"Recipient" means anyone who receives the Program under this Agreement
+or any Secondary License (as applicable), including Contributors.
+
+"Derivative Works" shall mean any work, whether in Source Code or other
+form, that is based on (or derived from) the Program and for which the
+editorial revisions, annotations, elaborations, or other modifications
+represent, as a whole, an original work of authorship.
+
+"Modified Works" shall mean any work in Source Code or other form that
+results from an addition to, deletion from, or modification of the
+contents of the Program, including, for purposes of clarity any new file
+in Source Code form that contains any contents of the Program. Modified
+Works shall not include works that contain only declarations,
+interfaces, types, classes, structures, or files of the Program solely
+in each case in order to link to, bind by name, or subclass the Program
+or Modified Works thereof.
+
+"Distribute" means the acts of a) distributing or b) making available
+in any manner that enables the transfer of a copy.
+
+"Source Code" means the form of a Program preferred for making
+modifications, including but not limited to software source code,
+documentation source, and configuration files.
+
+"Secondary License" means either the GNU General Public License,
+Version 2.0, or any later versions of that license, including any
+exceptions or additional permissions as identified by the initial
+Contributor.
+
+2. GRANT OF RIGHTS
+
+  a) Subject to the terms of this Agreement, each Contributor hereby
+  grants Recipient a non-exclusive, worldwide, royalty-free copyright
+  license to reproduce, prepare Derivative Works of, publicly display,
+  publicly perform, Distribute and sublicense the Contribution of such
+  Contributor, if any, and such Derivative Works.
+
+  b) Subject to the terms of this Agreement, each Contributor hereby
+  grants Recipient a non-exclusive, worldwide, royalty-free patent
+  license under Licensed Patents to make, use, sell, offer to sell,
+  import and otherwise transfer the Contribution of such Contributor,
+  if any, in Source Code or other form. This patent license shall
+  apply to the combination of the Contribution and the Program if, at
+  the time the Contribution is added by the Contributor, such addition
+  of the Contribution causes such combination to be covered by the
+  Licensed Patents. The patent license shall not apply to any other
+  combinations which include the Contribution. No hardware per se is
+  licensed hereunder.
+
+  c) Recipient understands that although each Contributor grants the
+  licenses to its Contributions set forth herein, no assurances are
+  provided by any Contributor that the Program does not infringe the
+  patent or other intellectual property rights of any other entity.
+  Each Contributor disclaims any liability to Recipient for claims
+  brought by any other entity based on infringement of intellectual
+  property rights or otherwise. As a condition to exercising the
+  rights and licenses granted hereunder, each Recipient hereby
+  assumes sole responsibility to secure any other intellectual
+  property rights needed, if any. For example, if a third party
+  patent license is required to allow Recipient to Distribute the
+  Program, it is Recipient's responsibility to acquire that license
+  before distributing the Program.
+
+  d) Each Contributor represents that to its knowledge it has
+  sufficient copyright rights in its Contribution, if any, to grant
+  the copyright license set forth in this Agreement.
+
+  e) Notwithstanding the terms of any Secondary License, no
+  Contributor makes additional grants to any Recipient (other than
+  those set forth in this Agreement) as a result of such Recipient's
+  receipt of the Program under the terms of a Secondary License
+  (if permitted under the terms of Section 3).
+
+3. REQUIREMENTS
+
+3.1 If a Contributor Distributes the Program in any form, then:
+
+  a) the Program must also be made available as Source Code, in
+  accordance with section 3.2, and the Contributor must accompany
+  the Program with a statement that the Source Code for the Program
+  is available under this Agreement, and informs Recipients how to
+  obtain it in a reasonable manner on or through a medium customarily
+  used for software exchange; and
+
+  b) the Contributor may Distribute the Program under a license
+  different than this Agreement, provided that such license:
+     i) effectively disclaims on behalf of all other Contributors all
+     warranties and conditions, express and implied, including
+     warranties or conditions of title and non-infringement, and
+     implied warranties or conditions of merchantability and fitness
+     for a particular purpose;
+
+     ii) effectively excludes on behalf of all other Contributors all
+     liability for damages, including direct, indirect, special,
+     incidental and consequential damages, such as lost profits;
+
+     iii) does not attempt to limit or alter the recipients' rights
+     in the Source Code under section 3.2; and
+
+     iv) requires any subsequent distribution of the Program by any
+     party to be under a license that satisfies the requirements
+     of this section 3.
+
+3.2 When the Program is Distributed as Source Code:
+
+  a) it must be made available under this Agreement, or if the
+  Program (i) is combined with other material in a separate file or
+  files made available under a Secondary License, and (ii) the initial
+  Contributor attached to the Source Code the notice described in
+  Exhibit A of this Agreement, then the Program may be made available
+  under the terms of such Secondary Licenses, and
+
+  b) a copy of this Agreement must be included with each copy of
+  the Program.
+
+3.3 Contributors may not remove or alter any copyright, patent,
+trademark, attribution notices, disclaimers of warranty, or limitations
+of liability ("notices") contained within the Program from any copy of
+the Program which they Distribute, provided that Contributors may add
+their own appropriate notices.
+
+4. COMMERCIAL DISTRIBUTION
+
+Commercial distributors of software may accept certain responsibilities
+with respect to end users, business partners and the like. While this
+license is intended to facilitate the commercial use of the Program,
+the Contributor who includes the Program in a commercial product
+offering should do so in a manner which does not create potential
+liability for other Contributors. Therefore, if a Contributor includes
+the Program in a commercial product offering, such Contributor
+("Commercial Contributor") hereby agrees to defend and indemnify every
+other Contributor ("Indemnified Contributor") against any losses,
+damages and costs (collectively "Losses") arising from claims, lawsuits
+and other legal actions brought by a third party against the Indemnified
+Contributor to the extent caused by the acts or omissions of such
+Commercial Contributor in connection with its distribution of the Program
+in a commercial product offering. The obligations in this section do not
+apply to any claims or Losses relating to any actual or alleged
+intellectual property infringement. In order to qualify, an Indemnified
+Contributor must: a) promptly notify the Commercial Contributor in
+writing of such claim, and b) allow the Commercial Contributor to control,
+and cooperate with the Commercial Contributor in, the defense and any
+related settlement negotiations. The Indemnified Contributor may
+participate in any such claim at its own expense.
+
+For example, a Contributor might include the Program in a commercial
+product offering, Product X. That Contributor is then a Commercial
+Contributor. If that Commercial Contributor then makes performance
+claims, or offers warranties related to Product X, those performance
+claims and warranties are such Commercial Contributor's responsibility
+alone. Under this section, the Commercial Contributor would have to
+defend claims against the other Contributors related to those performance
+claims and warranties, and if a court requires any other Contributor to
+pay any damages as a result, the Commercial Contributor must pay
+those damages.
+
+5. NO WARRANTY
+
+EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, AND TO THE EXTENT
+PERMITTED BY APPLICABLE LAW, THE PROGRAM IS PROVIDED ON AN "AS IS"
+BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, EITHER EXPRESS OR
+IMPLIED INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES OR CONDITIONS OF
+TITLE, NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
+PURPOSE. Each Recipient is solely responsible for determining the
+appropriateness of using and distributing the Program and assumes all
+risks associated with its exercise of rights under this Agreement,
+including but not limited to the risks and costs of program errors,
+compliance with applicable laws, damage to or loss of data, programs
+or equipment, and unavailability or interruption of operations.
+
+6. DISCLAIMER OF LIABILITY
+
+EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, AND TO THE EXTENT
+PERMITTED BY APPLICABLE LAW, NEITHER RECIPIENT NOR ANY CONTRIBUTORS
+SHALL HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING WITHOUT LIMITATION LOST
+PROFITS), HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OR DISTRIBUTION OF THE PROGRAM OR THE
+EXERCISE OF ANY RIGHTS GRANTED HEREUNDER, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGES.
+
+7. GENERAL
+
+If any provision of this Agreement is invalid or unenforceable under
+applicable law, it shall not affect the validity or enforceability of
+the remainder of the terms of this Agreement, and without further
+action by the parties hereto, such provision shall be reformed to the
+minimum extent necessary to make such provision valid and enforceable.
+
+If Recipient institutes patent litigation against any entity
+(including a cross-claim or counterclaim in a lawsuit) alleging that the
+Program itself (excluding combinations of the Program with other software
+or hardware) infringes such Recipient's patent(s), then such Recipient's
+rights granted under Section 2(b) shall terminate as of the date such
+litigation is filed.
+
+All Recipient's rights under this Agreement shall terminate if it
+fails to comply with any of the material terms or conditions of this
+Agreement and does not cure such failure in a reasonable period of
+time after becoming aware of such noncompliance. If all Recipient's
+rights under this Agreement terminate, Recipient agrees to cease use
+and distribution of the Program as soon as reasonably practicable.
+However, Recipient's obligations under this Agreement and any licenses
+granted by Recipient relating to the Program shall continue and survive.
+
+Everyone is permitted to copy and distribute copies of this Agreement,
+but in order to avoid inconsistency the Agreement is copyrighted and
+may only be modified in the following manner. The Agreement Steward
+reserves the right to publish new versions (including revisions) of
+this Agreement from time to time. No one other than the Agreement
+Steward has the right to modify this Agreement. The Eclipse Foundation
+is the initial Agreement Steward. The Eclipse Foundation may assign the
+responsibility to serve as the Agreement Steward to a suitable separate
+entity. Each new version of the Agreement will be given a distinguishing
+version number. The Program (including Contributions) may always be
+Distributed subject to the version of the Agreement under which it was
+received. In addition, after a new version of the Agreement is published,
+Contributor may elect to Distribute the Program (including its
+Contributions) under the new version.
+
+Except as expressly stated in Sections 2(a) and 2(b) above, Recipient
+receives no rights or licenses to the intellectual property of any
+Contributor under this Agreement, whether expressly, by implication,
+estoppel or otherwise. All rights in the Program not expressly granted
+under this Agreement are reserved. Nothing in this Agreement is intended
+to be enforceable by any entity that is not a Contributor or Recipient.
+No third-party beneficiary rights are created under this Agreement.
+
+Exhibit A - Form of Secondary Licenses Notice
+
+"This Source Code may also be made available under the following 
+Secondary Licenses when the conditions for such availability set forth 
+in the Eclipse Public License, v. 2.0 are satisfied: {name license(s),
+version(s), and exceptions or additional permissions here}."
+
+  Simply including a copy of this Agreement, including this Exhibit A
+  is not sufficient to license the Source Code under Secondary Licenses.
+
+  If it is not possible or desirable to put the notice in a particular
+  file, then You may include the notice in a location (such as a LICENSE
+  file in a relevant directory) where a recipient would be likely to
+  look for such a notice.
+
+  You may add additional accurate notices of copyright ownership.

package/README.md

@@ -0,0 +1,110 @@
+# @judo/i18n
+
+> Internationalization and localization support for JUDO UI Runtime
+
+## Purpose
+
+Provides translation key generation, locale-aware formatting, a system message catalog, a lightweight `I18nService`, and React integration via `react-i18next` (`I18nProvider`, locale hooks, `useModelLabel`). Supports runtime locale switching, codegen-based translation key maps, and passthrough mode for non-translated setups.
+
+## Architecture Layer
+
+**Layer 2 (Cross-cutting)** — consumed by components and higher layers for all text localization needs.
+
+## Dependencies
+
+- `@judo/model-api` — model type definitions (dependency + peer)
+- `date-fns` — date formatting and locale support (peer)
+- `i18next` — internationalization framework (peer)
+- `react` — React runtime (peer)
+- `react-i18next` — React bindings for i18next (peer)
+
+## File Structure
+
+```
+src/
+├── index.ts                   # Barrel re-export (pure utils + React integration)
+├── i18n-provider.tsx          # I18nProvider, useLocale, useLocaleOptional, LocaleContextType
+├── i18n-provider.test.tsx     # Provider + hook tests
+├── use-model-label.ts         # useModelLabel hook
+├── use-model-label.test.tsx   # useModelLabel tests
+├── i18n-service.ts            # I18nService interface + createI18nService factory
+├── i18n-service.test.ts       # Service tests
+├── translation-keys.ts        # Translation key generators for model elements
+├── translation-keys.test.ts   # Translation key tests
+├── formatters.ts              # Date/number/currency/percent formatting utilities
+├── formatters.test.ts         # Formatter tests
+├── system-messages.ts         # SYSTEM_MESSAGES catalog + getSystemMessage
+├── system-messages.test.ts    # System message tests
+└── locale-constants.ts        # LOCALE_STORAGE_KEY constant (HMR-safe)
+```
+
+## Exports Summary
+
+### Translation Key Generators
+
+| Function                                 | Description                                                                                                   |
+| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
+| `getTranslationKey(element, property?)`  | Generates `{type}.{sourceId\|name}.{property}` from a model element. Strips `ui:`/`data:` prefix, lowercases. |
+| `getSystemMessageKey(category, key)`     | Builds `system.{category}.{key}`.                                                                             |
+| `getColumnTranslationKey(column)`        | Generates `column.{sourceId\|name}.label` for a table column.                                                 |
+| `getEnumTranslationKey(enumName, value)` | Generates `enum.{enumName}.{value}` for an enum literal.                                                      |
+| `getNavItemTranslationKey(item)`         | Generates `nav.{sourceId\|name}.label` for a navigation item.                                                 |
+
+### Formatters
+
+| Export                                              | Kind      | Description                                                                                              |
+| --------------------------------------------------- | --------- | -------------------------------------------------------------------------------------------------------- |
+| `DateFormatOptions`                                 | interface | Options for date formatting — `dateStyle`, `timeStyle`, and custom `format` (date-fns pattern).          |
+| `NumberFormatOptions`                               | interface | Options for number formatting — maps to `Intl.NumberFormat` options.                                     |
+| `parseDate(value)`                                  | function  | Normalizes a date value (`Date`, ISO string, or timestamp) into a `Date` object.                         |
+| `getDateLocale(localeCode)`                         | function  | Resolves a locale code (e.g. `en-US`, `de`) to a date-fns `Locale` object. Supports `en`, `de`, `hu`.    |
+| `formatDate(date, localeCode, options?)`            | function  | Formats a date by locale. Custom date-fns pattern if provided, otherwise style-based, or default `"PP"`. |
+| `formatNumber(value, localeCode, options?)`         | function  | Formats a number via `Intl.NumberFormat`.                                                                |
+| `formatCurrency(value, localeCode, currency)`       | function  | Formats a currency value with currency symbol display.                                                   |
+| `formatRelativeTime(date, localeCode)`              | function  | Produces a human-readable relative time string (e.g. "2 days ago"). Auto-picks the best unit.            |
+| `formatPercent(value, localeCode, fractionDigits?)` | function  | Formats a value as a percentage (`0.1` → `"10%"`).                                                       |
+
+### System Messages
+
+| Export                      | Kind                  | Description                                                                                                                                                                                                              |
+| --------------------------- | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `SYSTEM_MESSAGES`           | constant (`as const`) | Deeply-nested readonly object with default English system messages organized by 12 categories: `action`, `validation`, `nav`, `session`, `loading`, `error`, `empty`, `pagination`, `table`, `dialog`, `auth`, `common`. |
+| `SystemMessageCategory`     | type                  | Union of top-level keys of `SYSTEM_MESSAGES`.                                                                                                                                                                            |
+| `SystemMessageKey`          | type                  | Union of all flattened dot-notation paths (e.g. `"action.save.success"`, `"error.notFound"`). Compile-time safe via recursive `FlattenKeys`.                                                                             |
+| `getSystemMessage(path)`    | function              | Retrieves a message string by dot-notation path. Returns `undefined` if path doesn't resolve.                                                                                                                            |
+| `getAllSystemMessageKeys()` | function              | Returns all leaf keys in flat dot-notation.                                                                                                                                                                              |
+
+### I18n Service
+
+| Export                          | Kind      | Description                                                                                                                                                                                                                  |
+| ------------------------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `TranslationOptions`            | interface | Options for `t()`: `defaultValue`, `count` (pluralization), plus arbitrary interpolation values.                                                                                                                             |
+| `I18nService`                   | interface | Contract for i18n implementations. Methods: `getLanguage`, `setLanguage`, `getAvailableLanguages`, `t`, `exists`, `formatDate`, `formatNumber`, `formatCurrency`, `formatRelativeTime`, `formatPercent`, `onLanguageChange`. |
+| `I18nServiceConfig`             | interface | Configuration: `defaultLanguage`, `supportedLanguages`, optional `resources` map.                                                                                                                                            |
+| `interpolate(template, values)` | function  | Simple `{{key}}` template interpolation. Replaces placeholders with values; leaves unresolved ones intact.                                                                                                                   |
+| `createI18nService(config)`     | function  | Factory that builds a lightweight `I18nService` implementation. Manages language state, translation lookup with fallback, interpolation, and language-change subscriptions.                                                  |
+
+### React Integration
+
+| Export                              | Kind      | Description                                                                                                                                             |
+| ----------------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `I18nProvider`                      | component | Wraps `I18nextProvider`, manages i18next instance lifecycle, supports `localeLoader`, `translationKeyMap`, and `persistLocale`.                         |
+| `I18nProviderProps`                 | interface | Props: `defaultLocale?`, `locales?`, `localeLoader?`, `translationKeyMap?`, `persistLocale?`, `children`.                                               |
+| `useLocale()`                       | hook      | Access locale context (current locale, setter, available locales). Throws if used outside `I18nProvider`.                                               |
+| `useLocaleOptional()`               | hook      | Access locale context (optional). Returns `null` outside `I18nProvider`.                                                                                |
+| `LocaleContextType`                 | interface | Context shape: `locale`, `setLocale`, `locales`, `hasTranslations`, `i18n`, `translationKeyMap?`.                                                       |
+| `useModelLabel(element, property?)` | hook      | Resolves translated label for a model element. Uses codegen key map if available, falls back to legacy format, then to `element.label ?? element.name`. |
+| `ModelLabelResult`                  | interface | Result: `label` (translated string), `translationKey` (key used for lookup).                                                                            |
+| `LOCALE_STORAGE_KEY`                | constant  | localStorage key (`"judo-locale"`) used by `I18nProvider` for locale persistence.                                                                       |
+
+## Key Patterns
+
+- **Two layers**: Pure utilities (translation keys, formatters, service, system messages) have no React dependency; React integration (`I18nProvider`, hooks) requires `react`, `i18next`, `react-i18next`.
+- **Interface + Factory**: `I18nService` is a pure interface; `createI18nService` is the default factory. Allows swapping in production implementations (e.g. `react-i18next`).
+- **Locale-aware formatting via Intl + date-fns**: Custom format patterns use date-fns `format()`; all other formatters use native `Intl` APIs.
+- **Translation fallback chain**: `t()` looks up in current language → falls back to `defaultLanguage` → returns `defaultValue` option → returns the raw key.
+- **Dual-path key resolution**: `useModelLabel` prefers codegen `translationKeyMap` (xmi:id → human-readable path), falls back to legacy `getTranslationKey()` format.
+- **Passthrough mode**: When no `localeLoader` is provided, `t(key, { defaultValue })` returns the `defaultValue` — model labels pass through unchanged.
+- **Subscription model**: `onLanguageChange()` returns an unsubscribe function, enabling React components to re-render on language switches.
+- **Deeply-typed system messages**: Recursive `FlattenKeys` utility type generates a union of every valid dot-notation path for compile-time safety.
+- **Key generation convention**: All translation-key generators follow a predictable `{type}.{sourceId}` pattern derived from model element metadata.

package/dist/formatters.d.ts

@@ -0,0 +1,79 @@
+import { Locale } from 'date-fns';
+/**
+ * Options for date formatting.
+ */
+export interface DateFormatOptions {
+    /** Predefined format style */
+    dateStyle?: "short" | "medium" | "long" | "full";
+    timeStyle?: "short" | "medium" | "long" | "full";
+    /** Custom format string (date-fns format) */
+    format?: string;
+}
+/**
+ * Options for number formatting.
+ */
+export interface NumberFormatOptions {
+    style?: "decimal" | "percent" | "currency";
+    minimumFractionDigits?: number;
+    maximumFractionDigits?: number;
+    useGrouping?: boolean;
+}
+/**
+ * Parse a date value into a Date object.
+ *
+ * @param date - Date value (Date, ISO string, or timestamp)
+ * @returns Parsed Date object
+ */
+export declare function parseDate(date: Date | string | number): Date;
+/**
+ * Get the date-fns locale object for a given locale code.
+ *
+ * @param localeCode - Locale code (e.g., 'en-US', 'de-DE')
+ * @returns date-fns Locale object, defaults to enUS
+ */
+export declare function getDateLocale(localeCode: string): Locale;
+/**
+ * Format a date according to the specified locale and options.
+ *
+ * @param date - Date to format
+ * @param localeCode - Locale code for formatting
+ * @param options - Format options
+ * @returns Formatted date string
+ */
+export declare function formatDate(date: Date | string | number, localeCode: string, options?: DateFormatOptions): string;
+/**
+ * Format a number according to the specified locale and options.
+ *
+ * @param value - Number to format
+ * @param localeCode - Locale code for formatting
+ * @param options - Format options
+ * @returns Formatted number string
+ */
+export declare function formatNumber(value: number, localeCode: string, options?: NumberFormatOptions): string;
+/**
+ * Format a currency value according to the specified locale.
+ *
+ * @param value - Number to format as currency
+ * @param localeCode - Locale code for formatting
+ * @param currency - Currency code (e.g., 'USD', 'EUR')
+ * @returns Formatted currency string
+ */
+export declare function formatCurrency(value: number, localeCode: string, currency: string): string;
+/**
+ * Format a relative time (e.g., "2 days ago", "in 3 hours").
+ *
+ * @param date - Date to format relative to now
+ * @param localeCode - Locale code for formatting
+ * @returns Formatted relative time string
+ */
+export declare function formatRelativeTime(date: Date | string | number, localeCode: string): string;
+/**
+ * Format a percentage value.
+ *
+ * @param value - Number to format as percentage (0.1 = 10%)
+ * @param localeCode - Locale code for formatting
+ * @param fractionDigits - Number of decimal places
+ * @returns Formatted percentage string
+ */
+export declare function formatPercent(value: number, localeCode: string, fractionDigits?: number): string;
+//# sourceMappingURL=formatters.d.ts.map

package/dist/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../src/formatters.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAevC;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,8BAA8B;IAC9B,SAAS,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;IACjD,SAAS,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;IACjD,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;IAC3C,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ5D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAmBhH;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAErG;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAK1F;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAqB3F;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,SAAI,GAAG,MAAM,CAM3F"}

package/dist/i18n-provider.d.ts

@@ -0,0 +1,83 @@
+import { i18n as I18nInstance } from 'i18next';
+import { ReactNode } from 'react';
+/**
+ * Locale context for managing the active locale and available locales.
+ */
+export interface LocaleContextType {
+    /** Current active locale code (e.g., "en-US") */
+    locale: string;
+    /** Change the active locale. Triggers async translation loading if a loader is configured. */
+    setLocale: (locale: string) => Promise<void>;
+    /** Map of supported locale codes to their display labels */
+    locales: Record<string, string>;
+    /** Whether translations are available (a locale loader was provided) */
+    hasTranslations: boolean;
+    /** The i18next instance */
+    i18n: I18nInstance;
+    /**
+     * Map of element sourceId (xmi:id) to human-readable translation key path.
+     * Generated by codegen. When present, useModelLabel uses this to resolve keys.
+     * When absent, falls back to the legacy type.sourceId.property format.
+     */
+    translationKeyMap?: Record<string, string>;
+}
+export interface I18nProviderProps {
+    /**
+     * Default locale from the Application model.
+     * Falls back to "en-US" if not specified.
+     */
+    defaultLocale?: string;
+    /**
+     * Supported locales. Keys are ISO locale codes, values are display labels.
+     * @example { "en-US": "English", "hu-HU": "Magyar" }
+     */
+    locales?: Record<string, string>;
+    /**
+     * Async locale loader function. Called with the locale code, must return
+     * a flat key→value translation map compatible with i18next.
+     *
+     * If not provided, translations are skipped and model labels are used via
+     * `defaultValue` fallback in `t()` calls.
+     */
+    localeLoader?: (locale: string) => Promise<Record<string, string>>;
+    /**
+     * Map of element sourceId (xmi:id) to human-readable translation key path.
+     * Generated by codegen (`_translation-key-map.ts`).
+     * When provided, useModelLabel() uses this map to resolve element translation keys
+     * instead of the legacy type-based format.
+     */
+    translationKeyMap?: Record<string, string>;
+    /**
+     * When true, persists the selected locale to localStorage and restores it
+     * on subsequent visits. The stored locale is only used if it appears in the
+     * supported `locales` map; otherwise the `defaultLocale` is used.
+     *
+     * @default false
+     */
+    persistLocale?: boolean;
+    children: ReactNode;
+}
+/**
+ * I18n provider that wraps the application with react-i18next.
+ *
+ * Initializes i18next with the model's default language and loads translations
+ * via the provided `localeLoader`. Supports runtime locale switching.
+ *
+ * If no `localeLoader` is provided, i18next is initialized in a passthrough
+ * mode where `t(key, { defaultValue })` always returns the `defaultValue`,
+ * effectively using model-defined labels directly.
+ */
+export declare function I18nProvider({ defaultLocale, locales, localeLoader, translationKeyMap, persistLocale, children, }: I18nProviderProps): import("react/jsx-runtime").JSX.Element | null;
+/**
+ * Hook to access locale context.
+ * Provides the current locale, a setter for changing it, and available locales.
+ *
+ * @throws If used outside I18nProvider.
+ */
+export declare function useLocale(): LocaleContextType;
+/**
+ * Hook to access locale context (optional).
+ * Returns null if used outside I18nProvider.
+ */
+export declare function useLocaleOptional(): LocaleContextType | null;
+//# sourceMappingURL=i18n-provider.d.ts.map

package/dist/i18n-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n-provider.d.ts","sourceRoot":"","sources":["../src/i18n-provider.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAgB,EAAE,KAAK,IAAI,IAAI,YAAY,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,EAAE,KAAK,SAAS,EAAgF,MAAM,OAAO,CAAC;AAmCrH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,8FAA8F;IAC9F,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,wEAAwE;IACxE,eAAe,EAAE,OAAO,CAAC;IACzB,2BAA2B;IAC3B,IAAI,EAAE,YAAY,CAAC;IACnB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AAQD,MAAM,WAAW,iBAAiB;IACjC;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAEnE;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE3C;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,QAAQ,EAAE,SAAS,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,EAC5B,aAAuB,EACvB,OAAO,EACP,YAAY,EACZ,iBAAiB,EACjB,aAAqB,EACrB,QAAQ,GACR,EAAE,iBAAiB,kDAiJnB;AAMD;;;;;GAKG;AACH,wBAAgB,SAAS,IAAI,iBAAiB,CAM7C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,iBAAiB,GAAG,IAAI,CAE5D"}

package/dist/i18n-service.d.ts

@@ -0,0 +1,70 @@
+import { DateFormatOptions, NumberFormatOptions } from './formatters';
+/**
+ * Options for translation function.
+ */
+export interface TranslationOptions {
+    /** Default value if key not found */
+    defaultValue?: string;
+    /** Count for pluralization */
+    count?: number;
+    /** Interpolation values */
+    [key: string]: unknown;
+}
+/**
+ * I18n service interface for internationalization.
+ * This interface defines the contract for i18n implementations.
+ */
+export interface I18nService {
+    /** Get current language */
+    getLanguage(): string;
+    /** Set language (triggers re-render in React context) */
+    setLanguage(lang: string): Promise<void>;
+    /** Get available languages */
+    getAvailableLanguages(): string[];
+    /** Translate a key */
+    t(key: string, options?: TranslationOptions): string;
+    /** Check if translation exists */
+    exists(key: string): boolean;
+    /** Format date according to current locale */
+    formatDate(date: Date | string | number, options?: DateFormatOptions): string;
+    /** Format number according to current locale */
+    formatNumber(value: number, options?: NumberFormatOptions): string;
+    /** Format currency */
+    formatCurrency(value: number, currency: string): string;
+    /** Format relative time */
+    formatRelativeTime(date: Date | string | number): string;
+    /** Format percentage */
+    formatPercent(value: number, fractionDigits?: number): string;
+    /** Subscribe to language changes */
+    onLanguageChange(callback: (lang: string) => void): () => void;
+}
+/**
+ * Configuration for creating an I18n service.
+ */
+export interface I18nServiceConfig {
+    /** Default language */
+    defaultLanguage: string;
+    /** Available languages */
+    supportedLanguages: string[];
+    /** Translation resources (language -> key -> value) */
+    resources?: Record<string, Record<string, string>>;
+}
+/**
+ * Simple interpolation for translation strings.
+ * Replaces {{key}} patterns with provided values.
+ *
+ * @param template - Template string with {{key}} patterns
+ * @param values - Values to interpolate
+ * @returns Interpolated string
+ */
+export declare function interpolate(template: string, values: Record<string, unknown>): string;
+/**
+ * Create a simple I18n service implementation.
+ * This is a lightweight implementation for testing and basic usage.
+ * In production, use react-i18next integration.
+ *
+ * @param config - I18n configuration
+ * @returns I18nService implementation
+ */
+export declare function createI18nService(config: I18nServiceConfig): I18nService;
+//# sourceMappingURL=i18n-service.d.ts.map

package/dist/i18n-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n-service.d.ts","sourceRoot":"","sources":["../src/i18n-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAG3E;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,qCAAqC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC3B,2BAA2B;IAC3B,WAAW,IAAI,MAAM,CAAC;IAEtB,yDAAyD;IACzD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzC,8BAA8B;IAC9B,qBAAqB,IAAI,MAAM,EAAE,CAAC;IAElC,sBAAsB;IACtB,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAAC;IAErD,kCAAkC;IAClC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAE7B,8CAA8C;IAC9C,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAAC;IAE9E,gDAAgD;IAChD,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAAC;IAEnE,sBAAsB;IACtB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAExD,2BAA2B;IAC3B,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAEzD,wBAAwB;IACxB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAE9D,oCAAoC;IACpC,gBAAgB,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAC/D;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,uBAAuB;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,0BAA0B;IAC1B,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACnD;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAKrF;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,CAsFxE"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @judo/i18n
+ *
+ * Internationalization and localization support for JUDO UI Runtime.
+ */
+export { getTranslationKey, getSystemMessageKey, getColumnTranslationKey, getEnumTranslationKey, getNavItemTranslationKey, } from './translation-keys';
+export { formatDate, formatNumber, formatCurrency, formatRelativeTime, formatPercent, parseDate, getDateLocale, type DateFormatOptions, type NumberFormatOptions, } from './formatters';
+export { SYSTEM_MESSAGES, getSystemMessage, getAllSystemMessageKeys, type SystemMessageCategory, type SystemMessageKey, } from './system-messages';
+export { createI18nService, interpolate, type I18nService, type I18nServiceConfig, type TranslationOptions, } from './i18n-service';
+export { I18nProvider, useLocale, useLocaleOptional, type I18nProviderProps, type LocaleContextType, } from './i18n-provider';
+export { LOCALE_STORAGE_KEY } from './locale-constants';
+export { useModelLabel, type ModelLabelResult } from './use-model-label';
+//# sourceMappingURL=index.d.ts.map