@endora-commerce/mod-dictionaries 0.100.0

package/dist/migrations/20260506T112634_dictionaries_dictionary_init.js

@@ -0,0 +1,157 @@
+import { Migration } from '@mikro-orm/migrations';
+/**
+ * Dictionary module — feature 017 / data-model.md.
+ *
+ * Schema changes (one atomic migration):
+ *   - new tables: countries, dictionary_translations, language_countries.
+ *   - ALTER `languages` ADD COLUMN native_label, is_rtl, fallback_code (self-FK).
+ *   - ALTER `currencies` ADD COLUMN symbol_position, decimal_places (CHECKs).
+ *   - partial unique index `uniq_countries_one_default` for the "exactly one
+ *     default" invariant (mirrors the analogous indexes on languages and
+ *     currencies introduced by migration 012).
+ *   - partial unique index `uniq_language_countries_primary_per_country`
+ *     for the "at most one primary language per country" invariant.
+ *   - btree indexes: `idx_countries_active`, `idx_countries_sort`,
+ *     `idx_dict_translations_lang`, `idx_language_countries_country`.
+ *   - FK `countries.default_currency_code` → `currencies(code)` ON DELETE
+ *     SET NULL — added LAST (after seed inserts run via the runtime
+ *     SeedReconciler) so the constraint is satisfied for every seeded row
+ *     without the migration carrying ~250 inline INSERTs.
+ *
+ * No seed rows in this migration. The countries seed, the Polish
+ * translations seed, the en-US/pl-PL language↔country primary associations,
+ * and the back-fill of `currencies.symbol_position` / `decimal_places`
+ * and `languages.native_label` / `is_rtl` are inserted by the runtime
+ * `SeedReconciler` in `services/seed-reconciler.ts` so admin edits across
+ * deploys stay safe (R6 + R8). The reconciler is idempotent and runs on
+ * every backend boot via the dictionaries module plugin.
+ */
+export class Migration20260506T112634DictionariesDictionaryInit extends Migration {
+    async up() {
+        // ────────────────────────────────────────────────────────────────────
+        // 1) countries — ISO 3166-1 alpha-2 territories
+        //    FK to currencies(code) is added LAST in this migration (step 8).
+        // ────────────────────────────────────────────────────────────────────
+        this.addSql(`
+      create table "countries" (
+        "code" varchar(2) not null,
+        "alpha3_code" varchar(3) not null,
+        "numeric_code" varchar(3) not null,
+        "label" varchar(120) not null,
+        "region" varchar(32) not null,
+        "subregion" varchar(64) null,
+        "dial_code" varchar(8) null,
+        "is_eu_member" boolean not null default false,
+        "default_currency_code" varchar(3) null,
+        "is_active" boolean not null default true,
+        "is_default" boolean not null default false,
+        "sort_order" int not null default 0,
+        "created_at" timestamptz not null,
+        "updated_at" timestamptz not null,
+        constraint "countries_pkey" primary key ("code"),
+        constraint "countries_alpha3_uniq" unique ("alpha3_code"),
+        constraint "countries_numeric_uniq" unique ("numeric_code"),
+        constraint "countries_region_check" check ("region" in
+          ('Africa','Americas','Asia','Europe','Oceania','Antarctic'))
+      );
+    `);
+        this.addSql(`create unique index "uniq_countries_one_default" on "countries" ("is_default") where "is_default" = true;`);
+        this.addSql(`create index "idx_countries_active" on "countries" ("is_active");`);
+        this.addSql(`create index "idx_countries_sort" on "countries" ("sort_order", "label");`);
+        // ────────────────────────────────────────────────────────────────────
+        // 2) ALTER languages — extended fields (native_label, is_rtl, fallback_code)
+        // ────────────────────────────────────────────────────────────────────
+        this.addSql(`alter table "languages" add column "native_label" varchar(64) not null default '';`);
+        this.addSql(`alter table "languages" add column "is_rtl" boolean not null default false;`);
+        this.addSql(`alter table "languages" add column "fallback_code" varchar(12) null;`);
+        this.addSql(`
+      alter table "languages"
+        add constraint "languages_fallback_fk"
+        foreign key ("fallback_code") references "languages" ("code")
+        on delete set null;
+    `);
+        // ────────────────────────────────────────────────────────────────────
+        // 3) ALTER currencies — extended fields (symbol_position, decimal_places)
+        // ────────────────────────────────────────────────────────────────────
+        this.addSql(`alter table "currencies" add column "symbol_position" varchar(8) not null default 'suffix';`);
+        this.addSql(`alter table "currencies" add column "decimal_places" smallint not null default 2;`);
+        this.addSql(`
+      alter table "currencies"
+        add constraint "currencies_symbol_position_check"
+        check ("symbol_position" in ('prefix','suffix'));
+    `);
+        this.addSql(`
+      alter table "currencies"
+        add constraint "currencies_decimal_places_check"
+        check ("decimal_places" >= 0 and "decimal_places" <= 6);
+    `);
+        // ────────────────────────────────────────────────────────────────────
+        // 4) dictionary_translations — polymorphic per-Language label override
+        //    (parent-existence enforced at the service layer, R3)
+        // ────────────────────────────────────────────────────────────────────
+        this.addSql(`
+      create table "dictionary_translations" (
+        "entry_type" varchar(16) not null,
+        "entry_code" varchar(12) not null,
+        "language_code" varchar(12) not null,
+        "label" varchar(160) not null,
+        "created_at" timestamptz not null,
+        "updated_at" timestamptz not null,
+        constraint "dictionary_translations_pkey"
+          primary key ("entry_type", "entry_code", "language_code"),
+        constraint "dictionary_translations_lang_fk"
+          foreign key ("language_code") references "languages" ("code") on delete cascade,
+        constraint "dictionary_translations_entry_type_check"
+          check ("entry_type" in ('country','currency','language'))
+      );
+    `);
+        this.addSql(`create index "idx_dict_translations_lang" on "dictionary_translations" ("language_code");`);
+        // ────────────────────────────────────────────────────────────────────
+        // 5) language_countries — Language ↔ Country M2M with primary flag
+        // ────────────────────────────────────────────────────────────────────
+        this.addSql(`
+      create table "language_countries" (
+        "language_code" varchar(12) not null,
+        "country_code" varchar(2) not null,
+        "is_primary" boolean not null default false,
+        "created_at" timestamptz not null,
+        constraint "language_countries_pkey"
+          primary key ("language_code", "country_code"),
+        constraint "language_countries_lang_fk"
+          foreign key ("language_code") references "languages" ("code") on delete cascade,
+        constraint "language_countries_country_fk"
+          foreign key ("country_code") references "countries" ("code") on delete cascade
+      );
+    `);
+        this.addSql(`create unique index "uniq_language_countries_primary_per_country" on "language_countries" ("country_code") where "is_primary" = true;`);
+        this.addSql(`create index "idx_language_countries_country" on "language_countries" ("country_code");`);
+        // ────────────────────────────────────────────────────────────────────
+        // 6) FK countries.default_currency_code → currencies(code)
+        //    Added LAST so the runtime SeedReconciler can backfill
+        //    `default_currency_code` referring to currencies that may not yet
+        //    exist when the migration runs against an empty database. The FK
+        //    itself is enforced from this point forward.
+        // ────────────────────────────────────────────────────────────────────
+        this.addSql(`
+      alter table "countries"
+        add constraint "countries_default_currency_fk"
+        foreign key ("default_currency_code") references "currencies" ("code")
+        on delete set null;
+    `);
+    }
+    async down() {
+        this.addSql(`alter table "countries" drop constraint if exists "countries_default_currency_fk";`);
+        this.addSql(`drop table if exists "language_countries" cascade;`);
+        this.addSql(`drop table if exists "dictionary_translations" cascade;`);
+        this.addSql(`alter table "currencies" drop constraint if exists "currencies_decimal_places_check";`);
+        this.addSql(`alter table "currencies" drop constraint if exists "currencies_symbol_position_check";`);
+        this.addSql(`alter table "currencies" drop column if exists "decimal_places";`);
+        this.addSql(`alter table "currencies" drop column if exists "symbol_position";`);
+        this.addSql(`alter table "languages" drop constraint if exists "languages_fallback_fk";`);
+        this.addSql(`alter table "languages" drop column if exists "fallback_code";`);
+        this.addSql(`alter table "languages" drop column if exists "is_rtl";`);
+        this.addSql(`alter table "languages" drop column if exists "native_label";`);
+        this.addSql(`drop table if exists "countries" cascade;`);
+    }
+}
+//# sourceMappingURL=20260506T112634_dictionaries_dictionary_init.js.map

package/dist/migrations/20260506T112634_dictionaries_dictionary_init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"20260506T112634_dictionaries_dictionary_init.js","sourceRoot":"","sources":["../../src/migrations/20260506T112634_dictionaries_dictionary_init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,OAAO,kDAAmD,SAAQ,SAAS;IACtE,KAAK,CAAC,EAAE;QACf,uEAAuE;QACvE,gDAAgD;QAChD,sEAAsE;QACtE,uEAAuE;QACvE,IAAI,CAAC,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;KAsBX,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CACT,2GAA2G,CAC5G,CAAC;QACF,IAAI,CAAC,MAAM,CAAC,mEAAmE,CAAC,CAAC;QACjF,IAAI,CAAC,MAAM,CAAC,2EAA2E,CAAC,CAAC;QAEzF,uEAAuE;QACvE,6EAA6E;QAC7E,uEAAuE;QACvE,IAAI,CAAC,MAAM,CAAC,oFAAoF,CAAC,CAAC;QAClG,IAAI,CAAC,MAAM,CAAC,6EAA6E,CAAC,CAAC;QAC3F,IAAI,CAAC,MAAM,CAAC,sEAAsE,CAAC,CAAC;QACpF,IAAI,CAAC,MAAM,CAAC;;;;;KAKX,CAAC,CAAC;QAEH,uEAAuE;QACvE,0EAA0E;QAC1E,uEAAuE;QACvE,IAAI,CAAC,MAAM,CACT,6FAA6F,CAC9F,CAAC;QACF,IAAI,CAAC,MAAM,CAAC,mFAAmF,CAAC,CAAC;QACjG,IAAI,CAAC,MAAM,CAAC;;;;KAIX,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC;;;;KAIX,CAAC,CAAC;QAEH,uEAAuE;QACvE,uEAAuE;QACvE,0DAA0D;QAC1D,uEAAuE;QACvE,IAAI,CAAC,MAAM,CAAC;;;;;;;;;;;;;;;KAeX,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CACT,2FAA2F,CAC5F,CAAC;QAEF,uEAAuE;QACvE,mEAAmE;QACnE,uEAAuE;QACvE,IAAI,CAAC,MAAM,CAAC;;;;;;;;;;;;;KAaX,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CACT,uIAAuI,CACxI,CAAC;QACF,IAAI,CAAC,MAAM,CACT,yFAAyF,CAC1F,CAAC;QAEF,uEAAuE;QACvE,2DAA2D;QAC3D,2DAA2D;QAC3D,sEAAsE;QACtE,qEAAqE;QACrE,iDAAiD;QACjD,uEAAuE;QACvE,IAAI,CAAC,MAAM,CAAC;;;;;KAKX,CAAC,CAAC;IACL,CAAC;IAEQ,KAAK,CAAC,IAAI;QACjB,IAAI,CAAC,MAAM,CAAC,oFAAoF,CAAC,CAAC;QAClG,IAAI,CAAC,MAAM,CAAC,oDAAoD,CAAC,CAAC;QAClE,IAAI,CAAC,MAAM,CAAC,yDAAyD,CAAC,CAAC;QACvE,IAAI,CAAC,MAAM,CAAC,uFAAuF,CAAC,CAAC;QACrG,IAAI,CAAC,MAAM,CAAC,wFAAwF,CAAC,CAAC;QACtG,IAAI,CAAC,MAAM,CAAC,kEAAkE,CAAC,CAAC;QAChF,IAAI,CAAC,MAAM,CAAC,mEAAmE,CAAC,CAAC;QACjF,IAAI,CAAC,MAAM,CAAC,4EAA4E,CAAC,CAAC;QAC1F,IAAI,CAAC,MAAM,CAAC,gEAAgE,CAAC,CAAC;QAC9E,IAAI,CAAC,MAAM,CAAC,yDAAyD,CAAC,CAAC;QACvE,IAAI,CAAC,MAAM,CAAC,+DAA+D,CAAC,CAAC;QAC7E,IAAI,CAAC,MAAM,CAAC,2CAA2C,CAAC,CAAC;IAC3D,CAAC;CACF"}

package/dist/migrations/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * The `./migrations` subpath — every migration class this module owns, as one
+ * ordered `migrations` array.
+ *
+ * The array is what the platform reads when this module is **installed**:
+ * `src/packages/package-runtime.ts` takes `exported['migrations']` and refuses
+ * the package outright when it is absent (D-168).
+ *
+ * Listed in ascending timestamp, which is the order of this module's own
+ * migrations and of nothing else (feature 081): a manifest `dependencies` array
+ * is the only thing ordering this block against another module's.
+ *
+ * The **named** exports stay beside the array, and the asymmetry with
+ * `./backend` — which publishes an array and no named class (D-168) — is
+ * deliberate. `db/migrations-registry.generated.ts` imports each class by name
+ * from this specifier, and a migration class name is contract in a way an entity
+ * class name is not: `mikro_orm_migrations` persists it, so it is a string every
+ * already-migrated database holds.
+ *
+ * A class that is in neither the array nor the barrel is a migration that does
+ * not run: `migration:pending` reports nothing pending and the first symptom is
+ * a query against a table nobody created.
+ */
+import { Migration20260506T112634DictionariesDictionaryInit } from './20260506T112634_dictionaries_dictionary_init.js';
+export declare const migrations: (typeof Migration20260506T112634DictionariesDictionaryInit)[];
+export { Migration20260506T112634DictionariesDictionaryInit, };
+//# sourceMappingURL=index.d.ts.map

package/dist/migrations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,kDAAkD,EAAE,MAAM,mDAAmD,CAAC;AAEvH,eAAO,MAAM,UAAU,+DAEtB,CAAC;AAEF,OAAO,EACL,kDAAkD,GACnD,CAAC"}

package/dist/migrations/index.js

@@ -0,0 +1,29 @@
+/**
+ * The `./migrations` subpath — every migration class this module owns, as one
+ * ordered `migrations` array.
+ *
+ * The array is what the platform reads when this module is **installed**:
+ * `src/packages/package-runtime.ts` takes `exported['migrations']` and refuses
+ * the package outright when it is absent (D-168).
+ *
+ * Listed in ascending timestamp, which is the order of this module's own
+ * migrations and of nothing else (feature 081): a manifest `dependencies` array
+ * is the only thing ordering this block against another module's.
+ *
+ * The **named** exports stay beside the array, and the asymmetry with
+ * `./backend` — which publishes an array and no named class (D-168) — is
+ * deliberate. `db/migrations-registry.generated.ts` imports each class by name
+ * from this specifier, and a migration class name is contract in a way an entity
+ * class name is not: `mikro_orm_migrations` persists it, so it is a string every
+ * already-migrated database holds.
+ *
+ * A class that is in neither the array nor the barrel is a migration that does
+ * not run: `migration:pending` reports nothing pending and the first symptom is
+ * a query against a table nobody created.
+ */
+import { Migration20260506T112634DictionariesDictionaryInit } from './20260506T112634_dictionaries_dictionary_init.js';
+export const migrations = [
+    Migration20260506T112634DictionariesDictionaryInit,
+];
+export { Migration20260506T112634DictionariesDictionaryInit, };
+//# sourceMappingURL=index.js.map

package/dist/migrations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,kDAAkD,EAAE,MAAM,mDAAmD,CAAC;AAEvH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,kDAAkD;CACnD,CAAC;AAEF,OAAO,EACL,kDAAkD,GACnD,CAAC"}

package/docs/dictionaries/index.md

@@ -0,0 +1,89 @@
+---
+title: Dictionary
+sidebar_position: 1
+description: Seeded reference data — Countries, Currencies, Languages — with admin reordering
+---
+
+# Dictionary
+
+The Dictionary module is the platform registry for country, currency, and
+language codes. It gives operators one Admin UI for the common reference data
+used by addresses, tax rules, warehouses, sales channels, promotions,
+megamenu bindings, and blog language scopes.
+
+The module does not replace the legacy Languages and Currencies HTTP surfaces.
+Those endpoints stay available for backward compatibility, while new admin and
+storefront work should read through the Dictionary module.
+
+## Operator Workflow
+
+Open `Admin -> Operations -> Dictionary`. The page has three tabs:
+
+- **Countries** — ISO country code, active flag, storefront visibility, default
+  label, localized labels, and allowed languages for each country.
+- **Currencies** — ISO currency code, symbol, decimal precision, active flag,
+  storefront visibility, default label, and localized labels.
+- **Languages** — BCP-47 language code, native name, active flag, storefront
+  visibility, default label, and localized labels.
+
+Deactivating an entry prevents new writes from selecting that code, but
+historical records can keep reading the existing value. This is intentional:
+orders, addresses, content scopes, and configuration records must remain
+auditable after a code is retired from active use.
+
+Localized labels are edited from each row. Storefront registry reads choose the
+requested locale when present and fall back to the default label when a
+translation is missing.
+
+## Storefront Registry
+
+Storefront clients read the combined registry through:
+
+```http
+GET /api/v1/dictionary?locale=pl-PL
+```
+
+The response contains only entries that are active and visible on the
+storefront. It is cached in Redis when Redis is available. Admin writes and the
+operator cache-invalidation endpoint clear that registry cache.
+
+Use the registry for UI pickers instead of hard-coded country, currency, or
+language lists. The module ships shared picker components for admin and
+storefront code paths.
+
+## Validator Port
+
+Backend consumers receive the shared validator from the composition root:
+
+```ts
+dictionaryValidator: dictionaries.handle.validator
+```
+
+The port exposes:
+
+- `validateCountryCode(code, mode)`
+- `validateCurrencyCode(code, mode)`
+- `validateLanguageCode(code, mode)`
+
+Use `create-or-change` for a new code assignment. Use `unchanged` only when an
+update keeps the same historical code already stored on that record. Unknown
+codes are always rejected. Inactive codes are rejected for new assignments and
+accepted only for unchanged historical values.
+
+The validator has a short in-process LRU. Dictionary writes invalidate the LRU
+and Redis registry cache together.
+
+## Extension Points
+
+When a module stores a country, currency, or language code:
+
+1. Accept the validator through the module plugin options.
+2. Validate at the service boundary before writing.
+3. Convert `DictionaryReferenceError` into a `409` response with the affected
+   field path.
+4. Preserve historical reads; do not cascade-edit consumer rows when a
+   dictionary entry is deactivated.
+
+Settings currently has no typed country/currency/language setting value kind,
+so its dictionary validator option is reserved for future metadata-driven
+settings.

package/i18n/en.json

@@ -0,0 +1,88 @@
+{
+  "languagePicker.selectLanguage": "Select language",
+  "languagePicker.inactiveGroup": "Inactive",
+  "languagePicker.inactiveLabel": "{label} (inactive)",
+  "badge.default": "Default",
+  "badge.active": "Active",
+  "badge.inactive": "Inactive",
+  "badge.translationsPending": "Translations pending",
+  "badge.translationsComplete": "Translations complete",
+  "badge.translationsPartial": "Translations partial",
+  "translations.title": "Translations",
+  "translations.inactive": "(inactive)",
+  "translations.save": "Save",
+  "translations.remove": "Remove",
+  "translations.noLanguages": "No languages registered.",
+  "translations.confirmRemove": "Remove {languageCode} translation?",
+  "translations.error.load": "Failed to load translations.",
+  "translations.error.save": "Save failed.",
+  "translations.error.remove": "Remove failed.",
+  "audit.page.title": "Dictionary audit",
+  "audit.page.description": "Unresolved country, currency, and language references across platform consumers.",
+  "audit.refresh": "Refresh",
+  "audit.copyCsv": "Copy CSV",
+  "audit.invalidateCache": "Invalidate cache",
+  "audit.generatedAt": "Generated {date}",
+  "audit.orphanReferences": "Orphan references",
+  "audit.loading": "Loading",
+  "audit.groupCount": "{count} groups",
+  "audit.column.dictionary": "Dictionary",
+  "audit.column.consumer": "Consumer",
+  "audit.column.table": "Table",
+  "audit.column.column": "Column",
+  "audit.column.code": "Code",
+  "audit.column.rows": "Rows",
+  "audit.loadingReport": "Loading audit report.",
+  "audit.empty": "No unresolved references found.",
+  "audit.info.copied": "Copied audit report as CSV.",
+  "audit.info.invalidated": "Dictionary cache invalidated.",
+  "audit.error.load": "Failed to load audit report.",
+  "audit.error.copy": "Could not copy CSV to clipboard.",
+  "audit.error.invalidate": "Cache invalidation failed.",
+  "action.moveUp": "Move up",
+  "action.moveDown": "Move down",
+  "action.edit": "Edit",
+  "action.delete": "Delete",
+  "action.setDefault": "Set default",
+  "countries.title": "Countries",
+  "countries.searchPlaceholder": "Search code, label, region",
+  "countries.addCountry": "Add country",
+  "countries.loading": "Loading countries…",
+  "countries.editor.newCountry": "New country",
+  "countries.editor.editTitle": "Edit {code}",
+  "countries.editor.title": "Country editor",
+  "countries.editor.selectHint": "Select a country or create a new one.",
+  "countries.editor.euMember": "EU member",
+  "currencies.title": "Currencies",
+  "currencies.searchPlaceholder": "Search code, label, symbol",
+  "currencies.addCurrency": "Add currency",
+  "currencies.loading": "Loading currencies…",
+  "currencies.decimalPlaces": "{count} decimal places",
+  "currencies.editor.newCurrency": "New currency",
+  "currencies.editor.editTitle": "Edit {code}",
+  "currencies.editor.title": "Currency editor",
+  "currencies.editor.selectHint": "Select a currency or create a new one.",
+  "languages.title": "Languages",
+  "languages.searchPlaceholder": "Search code or label",
+  "languages.addLanguage": "Add language",
+  "languages.loading": "Loading languages…",
+  "languages.editor.newLanguage": "New language",
+  "languages.editor.editTitle": "Edit {code}",
+  "languages.editor.title": "Language editor",
+  "languages.editor.selectHint": "Select a language or create a new one.",
+  "languages.editor.associatedCountries": "Associated countries",
+  "errors.DICTIONARY_ENTRY_NOT_FOUND": "Dictionary Entry Not Found.",
+  "errors.DICTIONARY_ENTRY_INACTIVE": "Dictionary Entry Inactive.",
+  "errors.DICTIONARY_ENTRY_HAS_DEPENDENTS": "Dictionary Entry Has Dependents.",
+  "errors.DICTIONARY_LAST_ACTIVE_ENTRY": "Dictionary Last Active Entry.",
+  "errors.DICTIONARY_DEFAULT_CANNOT_BE_DEACTIVATED": "Dictionary Default Cannot Be Deactivated.",
+  "errors.DICTIONARY_FALLBACK_CYCLE": "Dictionary Fallback Cycle.",
+  "errors.DICTIONARY_CODE_IMMUTABLE": "Dictionary Code Immutable.",
+  "errors.DICTIONARY_TRANSLATION_LANGUAGE_INACTIVE": "Dictionary Translation Language Inactive.",
+  "nav.dictionary.label": "Dictionary",
+  "nav.dictionaryAudit.label": "Dictionary audit",
+  "actions.openDictionary.label": "Dictionary",
+  "actions.openDictionary.description": "Countries, currencies, languages",
+  "actions.openDictionaryAudit.label": "Dictionary audit",
+  "actions.openDictionaryAudit.description": "Unresolved registry references"
+}

package/i18n/pl.json

@@ -0,0 +1,88 @@
+{
+  "languagePicker.selectLanguage": "Wybierz język",
+  "languagePicker.inactiveGroup": "Nieaktywne",
+  "languagePicker.inactiveLabel": "{label} (nieaktywny)",
+  "badge.default": "Domyślny",
+  "badge.active": "Aktywny",
+  "badge.inactive": "Nieaktywny",
+  "badge.translationsPending": "Tłumaczenia oczekujące",
+  "badge.translationsComplete": "Tłumaczenia kompletne",
+  "badge.translationsPartial": "Tłumaczenia częściowe",
+  "translations.title": "Tłumaczenia",
+  "translations.inactive": "(nieaktywny)",
+  "translations.save": "Zapisz",
+  "translations.remove": "Usuń",
+  "translations.noLanguages": "Brak zarejestrowanych języków.",
+  "translations.confirmRemove": "Usunąć tłumaczenie dla języka {languageCode}?",
+  "translations.error.load": "Nie udało się załadować tłumaczeń.",
+  "translations.error.save": "Zapis nie powiódł się.",
+  "translations.error.remove": "Usunięcie nie powiodło się.",
+  "audit.page.title": "Audyt słowników",
+  "audit.page.description": "Nierozwiązane referencje krajów, walut i języków u konsumentów platformy.",
+  "audit.refresh": "Odśwież",
+  "audit.copyCsv": "Kopiuj CSV",
+  "audit.invalidateCache": "Unieważnij cache",
+  "audit.generatedAt": "Wygenerowano {date}",
+  "audit.orphanReferences": "Sieroce referencje",
+  "audit.loading": "Ładowanie",
+  "audit.groupCount": "{count} grup",
+  "audit.column.dictionary": "Słownik",
+  "audit.column.consumer": "Konsument",
+  "audit.column.table": "Tabela",
+  "audit.column.column": "Kolumna",
+  "audit.column.code": "Kod",
+  "audit.column.rows": "Wierszy",
+  "audit.loadingReport": "Ładowanie raportu audytu.",
+  "audit.empty": "Nie znaleziono nierozwiązanych referencji.",
+  "audit.info.copied": "Skopiowano raport audytu jako CSV.",
+  "audit.info.invalidated": "Cache słownika unieważniony.",
+  "audit.error.load": "Nie udało się załadować raportu audytu.",
+  "audit.error.copy": "Nie udało się skopiować CSV do schowka.",
+  "audit.error.invalidate": "Unieważnienie cache nie powiodło się.",
+  "action.moveUp": "Przesuń w górę",
+  "action.moveDown": "Przesuń w dół",
+  "action.edit": "Edytuj",
+  "action.delete": "Usuń",
+  "action.setDefault": "Ustaw jako domyślny",
+  "countries.title": "Kraje",
+  "countries.searchPlaceholder": "Szukaj kodu, nazwy, regionu",
+  "countries.addCountry": "Dodaj kraj",
+  "countries.loading": "Ładowanie krajów…",
+  "countries.editor.newCountry": "Nowy kraj",
+  "countries.editor.editTitle": "Edytuj {code}",
+  "countries.editor.title": "Edytor krajów",
+  "countries.editor.selectHint": "Wybierz kraj lub utwórz nowy.",
+  "countries.editor.euMember": "Członek UE",
+  "currencies.title": "Waluty",
+  "currencies.searchPlaceholder": "Szukaj kodu, nazwy, symbolu",
+  "currencies.addCurrency": "Dodaj walutę",
+  "currencies.loading": "Ładowanie walut…",
+  "currencies.decimalPlaces": "{count} miejsc dziesiętnych",
+  "currencies.editor.newCurrency": "Nowa waluta",
+  "currencies.editor.editTitle": "Edytuj {code}",
+  "currencies.editor.title": "Edytor walut",
+  "currencies.editor.selectHint": "Wybierz walutę lub utwórz nową.",
+  "languages.title": "Języki",
+  "languages.searchPlaceholder": "Szukaj kodu lub nazwy",
+  "languages.addLanguage": "Dodaj język",
+  "languages.loading": "Ładowanie języków…",
+  "languages.editor.newLanguage": "Nowy język",
+  "languages.editor.editTitle": "Edytuj {code}",
+  "languages.editor.title": "Edytor języków",
+  "languages.editor.selectHint": "Wybierz język lub utwórz nowy.",
+  "languages.editor.associatedCountries": "Powiązane kraje",
+  "errors.DICTIONARY_ENTRY_NOT_FOUND": "Błąd: dictionary entry not found.",
+  "errors.DICTIONARY_ENTRY_INACTIVE": "Błąd: dictionary entry inactive.",
+  "errors.DICTIONARY_ENTRY_HAS_DEPENDENTS": "Błąd: dictionary entry has dependents.",
+  "errors.DICTIONARY_LAST_ACTIVE_ENTRY": "Błąd: dictionary last active entry.",
+  "errors.DICTIONARY_DEFAULT_CANNOT_BE_DEACTIVATED": "Błąd: dictionary default cannot be deactivated.",
+  "errors.DICTIONARY_FALLBACK_CYCLE": "Błąd: dictionary fallback cycle.",
+  "errors.DICTIONARY_CODE_IMMUTABLE": "Błąd: dictionary code immutable.",
+  "errors.DICTIONARY_TRANSLATION_LANGUAGE_INACTIVE": "Błąd: dictionary translation language inactive.",
+  "nav.dictionary.label": "Słownik",
+  "nav.dictionaryAudit.label": "Audyt słownika",
+  "actions.openDictionary.label": "Słownik",
+  "actions.openDictionary.description": "Kraje, waluty, języki",
+  "actions.openDictionaryAudit.label": "Audyt słownika",
+  "actions.openDictionaryAudit.description": "Nierozwiązane referencje rejestrów"
+}

package/package.json

@@ -0,0 +1,99 @@
+{
+  "name": "@endora-commerce/mod-dictionaries",
+  "version": "0.100.0",
+  "type": "module",
+  "sideEffects": false,
+  "description": "Cross-module registry of countries, languages, and currencies — backs every dropdown, validator, and address-form picker on the storefront and admin.",
+  "license": "MIT",
+  "endora": {
+    "type": "module",
+    "id": "dictionaries"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/endora-commerce/endora-commerce.git",
+    "directory": "packages/modules/dictionaries"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/manifest.d.ts",
+      "default": "./dist/manifest.js"
+    },
+    "./backend": {
+      "types": "./dist/backend/index.d.ts",
+      "default": "./dist/backend/index.js"
+    },
+    "./migrations": {
+      "types": "./dist/migrations/index.d.ts",
+      "default": "./dist/migrations/index.js"
+    },
+    "./admin": {
+      "types": "./dist/admin/index.d.ts",
+      "default": "./dist/admin/index.js"
+    },
+    "./tailwind.css": "./tailwind.css",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "i18n",
+    "docs",
+    "tailwind.css"
+  ],
+  "engines": {
+    "node": ">=22.18.0"
+  },
+  "peerDependencies": {
+    "@mikro-orm/core": "^6",
+    "@mikro-orm/migrations": "^6",
+    "@mikro-orm/postgresql": "^6",
+    "fastify": "^5",
+    "ioredis": "^5",
+    "lucide-react": "^1",
+    "react": "^19",
+    "react-router-dom": "^7",
+    "zod": "^4",
+    "@endora-commerce/admin-kit": "0.100.0",
+    "@endora-commerce/contracts": "0.100.0",
+    "@endora-commerce/platform": "0.100.0"
+  },
+  "peerDependenciesMeta": {
+    "@endora-commerce/admin-kit": {
+      "optional": true
+    },
+    "lucide-react": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "react-router-dom": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@mikro-orm/core": "^6.6.13",
+    "@mikro-orm/migrations": "^6.6.13",
+    "@mikro-orm/postgresql": "^6.6.13",
+    "@types/node": "^22.9.0",
+    "@types/react": "^19.2.14",
+    "fastify": "^5.12.5",
+    "ioredis": "^5.10.1",
+    "lucide-react": "^1.11.0",
+    "react": "^19.2.5",
+    "react-router-dom": "^7.18.2",
+    "typescript": "^5.9.3",
+    "zod": "^4.2.0",
+    "@endora-commerce/admin-kit": "0.100.0",
+    "@endora-commerce/platform": "0.100.0",
+    "@endora-commerce/contracts": "0.100.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && tsc -p tsconfig.ui.json",
+    "typecheck": "tsc -p tsconfig.json && tsc -p tsconfig.ui.json --noEmit",
+    "lint": "eslint src"
+  }
+}

package/tailwind.css

@@ -0,0 +1,14 @@
+/* @endora-commerce/mod-dictionaries — AUTO-GENERATED by `pnpm --filter backend run manifests:generate`.
+ *
+ * The `@source` directives this package asks its host to scan
+ * (`specs/110-instance-repository/contracts/admin-stylesheet-composition.md` R1).
+ * They resolve relative to **this file**, so they hold wherever the package is
+ * installed — a workspace link here, `node_modules` in a client's instance.
+ *
+ * The `dist` line is what a published tarball ships and is what an instance
+ * scans; the `src` line is inert there and is what keeps `pnpm --filter admin
+ * run dev` reading source in this repository. Do not edit: run
+ * `pnpm --filter backend run manifests:generate`.
+ */
+@source "./dist/admin";
+@source "./src/admin";