@hoardodile/i18n 0.0.0

package/dist/core.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Locale plumbing shared by the web SPA, the Electron shell and the plugin
+ * SDK: the supported-language set and pure helpers. **This module must
+ * stay free of catalog imports** — the sandboxed preload imports
+ * `isSupportedLanguage` from here, and the catalogs (which weigh far
+ * more than this file) live in `./catalogs.ts` (`CATALOGS`,
+ * `catalogFor`), `./catalogs/ui.ts` (`UI_CATALOGS`, `uiCatalogFor`) plus
+ * the per-language JSON modules.
+ *
+ * `catalogs/*.json` (the app `translation` namespace) and `ui/*.json`
+ * (the shared `ui` namespace consumed by `@hoardodile/ui` and the plugin
+ * SDK iframes) must stay in lockstep internally: identical flat key
+ * sets, matching interpolation placeholders, and complete `_one`/`_other`
+ * pairs. `src/parity.test.ts` enforces this — run it after touching any
+ * catalog. `CATALOGS: Record<SupportedLanguage, typeof en>` and
+ * `UI_CATALOGS: Record<SupportedLanguage, typeof uiEn>` additionally
+ * make any key drift a compile error in `tsc`.
+ */
+declare const SUPPORTED_LANGUAGES: readonly ["en", "zh", "ja", "de", "es"];
+type SupportedLanguage = (typeof SUPPORTED_LANGUAGES)[number];
+declare function isSupportedLanguage(value: string): value is SupportedLanguage;
+/**
+ * Map a BCP-47 locale string (e.g. `navigator.language`,
+ * `app.getLocale()`, a stored pref) onto the supported set, taking the
+ * base code: `"ja-JP"` → `"ja"`, `"de-DE"` → `"de"`, `"es-MX"` → `"es"`,
+ * `"zh-CN"`/`"zh-TW"` → `"zh"` (any Chinese base maps to the `zh`
+ * catalog, preserving historical behavior). Unknown or missing values
+ * fall back to `"en"`.
+ */
+declare function resolveSystemLanguage(raw: string | undefined): SupportedLanguage;
+
+export { SUPPORTED_LANGUAGES, type SupportedLanguage, isSupportedLanguage, resolveSystemLanguage };

package/dist/core.js

@@ -0,0 +1,14 @@
+// src/core.ts
+var SUPPORTED_LANGUAGES = ["en", "zh", "ja", "de", "es"];
+function isSupportedLanguage(value) {
+  return SUPPORTED_LANGUAGES.includes(value);
+}
+function resolveSystemLanguage(raw) {
+  const base = raw?.toLowerCase().split("-")[0];
+  if (base !== void 0 && isSupportedLanguage(base)) return base;
+  return "en";
+}
+
+export { SUPPORTED_LANGUAGES, isSupportedLanguage, resolveSystemLanguage };
+//# sourceMappingURL=core.js.map
+//# sourceMappingURL=core.js.map

package/dist/core.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core.ts"],"names":[],"mappings":";AAkBO,IAAM,sBAAsB,CAAC,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,MAAM,IAAI;AAGzD,SAAS,oBAAoB,KAAA,EAA2C;AAC9E,EAAA,OAAQ,mBAAA,CAA0C,SAAS,KAAK,CAAA;AACjE;AAUO,SAAS,sBACf,GAAA,EACoB;AACpB,EAAA,MAAM,OAAO,GAAA,EAAK,WAAA,GAAc,KAAA,CAAM,GAAG,EAAE,CAAC,CAAA;AAC5C,EAAA,IAAI,IAAA,KAAS,MAAA,IAAa,mBAAA,CAAoB,IAAI,GAAG,OAAO,IAAA;AAC5D,EAAA,OAAO,IAAA;AACR","file":"core.js","sourcesContent":["/**\n * Locale plumbing shared by the web SPA, the Electron shell and the plugin\n * SDK: the supported-language set and pure helpers. **This module must\n * stay free of catalog imports** — the sandboxed preload imports\n * `isSupportedLanguage` from here, and the catalogs (which weigh far\n * more than this file) live in `./catalogs.ts` (`CATALOGS`,\n * `catalogFor`), `./catalogs/ui.ts` (`UI_CATALOGS`, `uiCatalogFor`) plus\n * the per-language JSON modules.\n *\n * `catalogs/*.json` (the app `translation` namespace) and `ui/*.json`\n * (the shared `ui` namespace consumed by `@hoardodile/ui` and the plugin\n * SDK iframes) must stay in lockstep internally: identical flat key\n * sets, matching interpolation placeholders, and complete `_one`/`_other`\n * pairs. `src/parity.test.ts` enforces this — run it after touching any\n * catalog. `CATALOGS: Record<SupportedLanguage, typeof en>` and\n * `UI_CATALOGS: Record<SupportedLanguage, typeof uiEn>` additionally\n * make any key drift a compile error in `tsc`.\n */\nexport const SUPPORTED_LANGUAGES = [\"en\", \"zh\", \"ja\", \"de\", \"es\"] as const\nexport type SupportedLanguage = (typeof SUPPORTED_LANGUAGES)[number]\n\nexport function isSupportedLanguage(value: string): value is SupportedLanguage {\n\treturn (SUPPORTED_LANGUAGES as readonly string[]).includes(value)\n}\n\n/**\n * Map a BCP-47 locale string (e.g. `navigator.language`,\n * `app.getLocale()`, a stored pref) onto the supported set, taking the\n * base code: `\"ja-JP\"` → `\"ja\"`, `\"de-DE\"` → `\"de\"`, `\"es-MX\"` → `\"es\"`,\n * `\"zh-CN\"`/`\"zh-TW\"` → `\"zh\"` (any Chinese base maps to the `zh`\n * catalog, preserving historical behavior). Unknown or missing values\n * fall back to `\"en\"`.\n */\nexport function resolveSystemLanguage(\n\traw: string | undefined,\n): SupportedLanguage {\n\tconst base = raw?.toLowerCase().split(\"-\")[0]\n\tif (base !== undefined && isSupportedLanguage(base)) return base\n\treturn \"en\"\n}\n"]}

package/dist/create-i18n.d.ts

@@ -0,0 +1,35 @@
+import { InitOptions, i18n } from 'i18next';
+
+/**
+ * The i18next instance factory every React root uses: the web SPA, the
+ * desktop wizard/shell pages, the workbench and the plugin SDK iframes
+ * all boot their instance with the same options so catalog behavior
+ * (fallback, plurals, interpolation, type safety) never diverges between
+ * surfaces.
+ *
+ * This module is deliberately free of catalog imports — plugin iframe
+ * bundles import the factory through this subpath and ship only the
+ * small `ui`/`plugin` namespaces (the full app catalog would otherwise
+ * be pulled into every bundle). Host surfaces use `createI18n` from
+ * `@hoardodile/i18n`, which wraps this factory with the shared catalogs.
+ *
+ * React-free on purpose: the Electron main process and the sandboxed
+ * preload keep using `catalogFor` / `uiCatalogFor` directly, and each
+ * React root adds its own `react-i18next` binding (e.g.
+ * `setI18n(instance)`).
+ */
+
+type CreateI18nOptions = Omit<InitOptions, "lng" | "resources"> & {
+    /** Initial language; undefined lets i18next resolve its default (fallback → "en"). */
+    readonly lng?: string;
+    /** Resource map — the shared catalogs (or the smaller ui/plugin set). */
+    readonly resources: InitOptions["resources"];
+};
+/**
+ * Create an i18next instance with the canonical option set. Callers
+ * supply the resources explicitly (hosts via the `@hoardodile/i18n`
+ * wrapper, plugins via the SDK).
+ */
+declare function createI18n(options: CreateI18nOptions): i18n;
+
+export { type CreateI18nOptions, createI18n };

package/dist/create-i18n.js

@@ -0,0 +1,30 @@
+import i18next from 'i18next';
+
+// src/create-i18n.ts
+
+// src/core.ts
+var SUPPORTED_LANGUAGES = ["en", "zh", "ja", "de", "es"];
+
+// src/create-i18n.ts
+function createI18n(options) {
+  const { lng, resources, ...rest } = options;
+  const instance = i18next.createInstance();
+  void instance.init({
+    resources,
+    lng,
+    fallbackLng: "en",
+    supportedLngs: [...SUPPORTED_LANGUAGES],
+    nonExplicitSupportedLngs: true,
+    interpolation: { escapeValue: false },
+    returnNull: false,
+    returnEmptyString: false,
+    compatibilityJSON: "v4",
+    pluralSeparator: "_",
+    ...rest
+  });
+  return instance;
+}
+
+export { createI18n };
+//# sourceMappingURL=create-i18n.js.map
+//# sourceMappingURL=create-i18n.js.map

package/dist/create-i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core.ts","../src/create-i18n.ts"],"names":[],"mappings":";;;;;AAkBO,IAAM,sBAAsB,CAAC,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,MAAM,IAAI,CAAA;;;ACgBzD,SAAS,WAAW,OAAA,EAA0C;AACpE,EAAA,MAAM,EAAE,GAAA,EAAK,SAAA,EAAW,GAAG,MAAK,GAAI,OAAA;AACpC,EAAA,MAAM,QAAA,GAAW,QAAQ,cAAA,EAAe;AACxC,EAAA,KAAK,SAAS,IAAA,CAAK;AAAA,IAClB,SAAA;AAAA,IACA,GAAA;AAAA,IACA,WAAA,EAAa,IAAA;AAAA,IACb,aAAA,EAAe,CAAC,GAAG,mBAAmB,CAAA;AAAA,IACtC,wBAAA,EAA0B,IAAA;AAAA,IAC1B,aAAA,EAAe,EAAE,WAAA,EAAa,KAAA,EAAM;AAAA,IACpC,UAAA,EAAY,KAAA;AAAA,IACZ,iBAAA,EAAmB,KAAA;AAAA,IACnB,iBAAA,EAAmB,IAAA;AAAA,IACnB,eAAA,EAAiB,GAAA;AAAA,IACjB,GAAG;AAAA,GACmB,CAAA;AACvB,EAAA,OAAO,QAAA;AACR","file":"create-i18n.js","sourcesContent":["/**\n * Locale plumbing shared by the web SPA, the Electron shell and the plugin\n * SDK: the supported-language set and pure helpers. **This module must\n * stay free of catalog imports** — the sandboxed preload imports\n * `isSupportedLanguage` from here, and the catalogs (which weigh far\n * more than this file) live in `./catalogs.ts` (`CATALOGS`,\n * `catalogFor`), `./catalogs/ui.ts` (`UI_CATALOGS`, `uiCatalogFor`) plus\n * the per-language JSON modules.\n *\n * `catalogs/*.json` (the app `translation` namespace) and `ui/*.json`\n * (the shared `ui` namespace consumed by `@hoardodile/ui` and the plugin\n * SDK iframes) must stay in lockstep internally: identical flat key\n * sets, matching interpolation placeholders, and complete `_one`/`_other`\n * pairs. `src/parity.test.ts` enforces this — run it after touching any\n * catalog. `CATALOGS: Record<SupportedLanguage, typeof en>` and\n * `UI_CATALOGS: Record<SupportedLanguage, typeof uiEn>` additionally\n * make any key drift a compile error in `tsc`.\n */\nexport const SUPPORTED_LANGUAGES = [\"en\", \"zh\", \"ja\", \"de\", \"es\"] as const\nexport type SupportedLanguage = (typeof SUPPORTED_LANGUAGES)[number]\n\nexport function isSupportedLanguage(value: string): value is SupportedLanguage {\n\treturn (SUPPORTED_LANGUAGES as readonly string[]).includes(value)\n}\n\n/**\n * Map a BCP-47 locale string (e.g. `navigator.language`,\n * `app.getLocale()`, a stored pref) onto the supported set, taking the\n * base code: `\"ja-JP\"` → `\"ja\"`, `\"de-DE\"` → `\"de\"`, `\"es-MX\"` → `\"es\"`,\n * `\"zh-CN\"`/`\"zh-TW\"` → `\"zh\"` (any Chinese base maps to the `zh`\n * catalog, preserving historical behavior). Unknown or missing values\n * fall back to `\"en\"`.\n */\nexport function resolveSystemLanguage(\n\traw: string | undefined,\n): SupportedLanguage {\n\tconst base = raw?.toLowerCase().split(\"-\")[0]\n\tif (base !== undefined && isSupportedLanguage(base)) return base\n\treturn \"en\"\n}\n","/**\n * The i18next instance factory every React root uses: the web SPA, the\n * desktop wizard/shell pages, the workbench and the plugin SDK iframes\n * all boot their instance with the same options so catalog behavior\n * (fallback, plurals, interpolation, type safety) never diverges between\n * surfaces.\n *\n * This module is deliberately free of catalog imports — plugin iframe\n * bundles import the factory through this subpath and ship only the\n * small `ui`/`plugin` namespaces (the full app catalog would otherwise\n * be pulled into every bundle). Host surfaces use `createI18n` from\n * `@hoardodile/i18n`, which wraps this factory with the shared catalogs.\n *\n * React-free on purpose: the Electron main process and the sandboxed\n * preload keep using `catalogFor` / `uiCatalogFor` directly, and each\n * React root adds its own `react-i18next` binding (e.g.\n * `setI18n(instance)`).\n */\n\nimport i18next, { type i18n as I18nInstance, type InitOptions } from \"i18next\"\nimport { SUPPORTED_LANGUAGES } from \"./core.ts\"\n\nexport type CreateI18nOptions = Omit<InitOptions, \"lng\" | \"resources\"> & {\n\t/** Initial language; undefined lets i18next resolve its default (fallback → \"en\"). */\n\treadonly lng?: string\n\t/** Resource map — the shared catalogs (or the smaller ui/plugin set). */\n\treadonly resources: InitOptions[\"resources\"]\n}\n\n/**\n * Create an i18next instance with the canonical option set. Callers\n * supply the resources explicitly (hosts via the `@hoardodile/i18n`\n * wrapper, plugins via the SDK).\n */\nexport function createI18n(options: CreateI18nOptions): I18nInstance {\n\tconst { lng, resources, ...rest } = options\n\tconst instance = i18next.createInstance()\n\tvoid instance.init({\n\t\tresources,\n\t\tlng,\n\t\tfallbackLng: \"en\",\n\t\tsupportedLngs: [...SUPPORTED_LANGUAGES],\n\t\tnonExplicitSupportedLngs: true,\n\t\tinterpolation: { escapeValue: false },\n\t\treturnNull: false,\n\t\treturnEmptyString: false,\n\t\tcompatibilityJSON: \"v4\",\n\t\tpluralSeparator: \"_\",\n\t\t...rest,\n\t} satisfies InitOptions)\n\treturn instance\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,42 @@
+import { e as en } from './catalogs-BF4px4Mm.js';
+export { C as CATALOGS, c as catalogFor } from './catalogs-BF4px4Mm.js';
+import { u as uiEn } from './ui-CJPMCZT7.js';
+export { U as UI_CATALOGS, a as uiCatalogFor } from './ui-CJPMCZT7.js';
+import { i18n } from 'i18next';
+import { CreateI18nOptions } from './create-i18n.js';
+export { SUPPORTED_LANGUAGES, SupportedLanguage, isSupportedLanguage, resolveSystemLanguage } from './core.js';
+
+/**
+ * Type the `t()` keys of every consumer against the catalogs: a wrong key
+ * (typo or a key added to one catalog but not the others) becomes a
+ * compile error instead of a silently rendered key name. Declared once
+ * here so the web SPA, the desktop surfaces, the workbench and the plugin
+ * SDK all resolve the same resources. The `plugin` namespace is typed
+ * loosely on purpose — its strings are authored per plugin (their
+ * bundles vary), and `@hoardodile/sdk-react`'s `useTranslation` wrapper
+ * returns that loose signature to plugin code.
+ */
+declare module "i18next" {
+    interface CustomTypeOptions {
+        defaultNS: "translation";
+        resources: {
+            translation: typeof en;
+            ui: typeof uiEn;
+            plugin: Record<string, string>;
+        };
+        returnNull: false;
+        returnEmptyString: false;
+    }
+}
+
+/**
+ * Host-surface factory: an i18next instance preloaded with the shared
+ * catalogs (`translation` + `ui`, all five languages). React roots boot
+ * it with the same options everywhere. Plugin iframes use the `createI18n`
+ * factory from `@hoardodile/i18n/create-i18n` instead with a resource
+ * subset (ui + plugin namespaces) so the full app catalog never enters
+ * their bundles.
+ */
+declare function createI18n(options?: Omit<CreateI18nOptions, "resources">): i18n;
+
+export { CreateI18nOptions, createI18n };