ai-i18n-tools 1.0.0

package/dist/runtime/i18next-helpers.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Framework-agnostic i18next setup helpers for key-as-default projects.
+ *
+ * These helpers do NOT import from `i18next` or `react-i18next` directly -
+ * they accept a loose `I18nLike` interface so you are not locked to a specific version.
+ *
+ * Typical usage in a React / Next.js project:
+ *
+ * ```js
+ * // src/i18n.js
+ * import i18n from 'i18next';
+ * import { initReactI18next } from 'react-i18next';
+ * import uiLanguages from './locales/ui-languages.json';
+ * import {
+ *   defaultI18nInitOptions, wrapI18nWithKeyTrim,
+ *   makeLoadLocale, applyDirection,
+ * } from 'ai-i18n-tools/runtime';
+ *
+ * // Must match sourceLocale in ai-i18n-tools.config.json
+ * export const SOURCE_LOCALE = 'en-GB';
+ *
+ * void i18n.use(initReactI18next).init(defaultI18nInitOptions(SOURCE_LOCALE));
+ * wrapI18nWithKeyTrim(i18n);
+ * i18n.on('languageChanged', applyDirection);
+ * applyDirection(i18n.language);
+ *
+ * const localeLoaders = Object.fromEntries(
+ *   uiLanguages
+ *     .filter(({ code }) => code !== SOURCE_LOCALE)
+ *     .map(({ code }) => [code, () => import(`./locales/${code}.json`)])
+ * );
+ * export const loadLocale = makeLoadLocale(i18n, localeLoaders, SOURCE_LOCALE);
+ * export default i18n;
+ * ```
+ */
+/**
+ * BCP-47 base language codes that use a right-to-left script.
+ * Covers Arabic script (ar, fa, ur, ps, sd, ug), Hebrew (he, yi), Syriac (syr, aii, cld),
+ * Thaana (dv), Adlam (ff), N'Ko (nqo), Hanifi Rohingya (rhg).
+ */
+export declare const RTL_LANGS: ReadonlySet<string>;
+/**
+ * Detect text direction from a BCP-47 locale code.
+ * Strips region/script subtags and checks the base language against {@link RTL_LANGS}.
+ *
+ * @example getTextDirection('ar')      // 'rtl'
+ * @example getTextDirection('fa-IR')   // 'rtl'
+ * @example getTextDirection('en-GB')   // 'ltr'
+ */
+export declare function getTextDirection(lng: string): "ltr" | "rtl";
+/**
+ * Minimal DOM interface needed by {@link applyDirection}. Compatible with the browser
+ * `Element` type without requiring a `lib: ["dom"]` tsconfig entry.
+ */
+export interface DirectionTarget {
+    setAttribute(name: string, value: string): void;
+}
+/**
+ * Set the `dir` attribute on an element (defaults to `document.documentElement`).
+ * Safe to call in Node.js - checks for `document` existence before accessing DOM.
+ *
+ * @example i18n.on('languageChanged', applyDirection);
+ */
+export declare function applyDirection(lng: string, element?: DirectionTarget): void;
+/**
+ * Standard i18next `init()` options for key-as-default projects.
+ *
+ * - `parseMissingKeyHandler` returns the key itself, so missing translations
+ *   display the source-language string rather than an error.
+ * - `nsSeparator: false` allows keys that contain colons (e.g. `"Label:"`).
+ * - `interpolation.escapeValue: false` - safe to disable: React escapes values itself,
+ *   and Node.js / CLI output has no HTML to escape.
+ *
+ * Spread into `i18n.init()`:
+ * ```js
+ * i18n.use(initReactI18next).init(defaultI18nInitOptions('en-GB'));
+ * ```
+ *
+ * @param sourceLocale - BCP-47 code used as `lng` and `fallbackLng`. Defaults to `'en'`.
+ */
+export declare function defaultI18nInitOptions(sourceLocale?: string): {
+    resources: Record<string, never>;
+    lng: string;
+    fallbackLng: string;
+    parseMissingKeyHandler: (key: string) => string;
+    interpolation: {
+        escapeValue: false;
+    };
+    nsSeparator: false;
+};
+/**
+ * Minimal interface for an i18next instance (or any compatible translate object).
+ * Accepts the full i18next instance without requiring an import of `i18next` itself.
+ */
+export interface I18nLike {
+    t: (key: string, ...rest: unknown[]) => string;
+}
+/**
+ * Wrap `i18n.t` so that:
+ * 1. Keys are trimmed before lookup - the extract script stores keys trimmed
+ *    (e.g. `"Label"` not `"Label "`), so `t("Label ")` would miss the cache without this.
+ * 2. Source-locale `{{var}}` interpolation is applied as a fallback - in key-as-default
+ *    mode `parseMissingKeyHandler` returns the raw key string without running
+ *    interpolation, so `t("Hello {{name}}", { name })` would return `"Hello {{name}}"`
+ *    instead of `"Hello World"` for the source locale. This wrapper detects that case
+ *    (result === trimmed key) and applies `interpolateTemplate` automatically.
+ *
+ * Mutates the `t` property on the passed instance in-place.
+ *
+ * @example wrapI18nWithKeyTrim(i18n);
+ */
+export declare function wrapI18nWithKeyTrim(i18n: I18nLike): void;
+/**
+ * Extended i18next interface that includes the resource bundle API needed by `makeLoadLocale`.
+ */
+export interface I18nWithResources extends I18nLike {
+    addResourceBundle(lng: string, ns: string, resources: Record<string, string>, deep?: boolean, overwrite?: boolean): void;
+}
+/**
+ * Create a `loadLocale(lang)` function for dynamic locale loading.
+ *
+ * Pass a map of `{ [localeCode]: () => import('./locales/<code>.json') }` and the
+ * returned function handles loading on demand, skipping the source locale (no file needed).
+ *
+ * @param i18n - i18next instance (must have `addResourceBundle`).
+ * @param localeLoaders - map of locale code → dynamic import factory.
+ * @param sourceLocale - locale code that requires no file (key-as-default); defaults to `'en'`.
+ *
+ * @example
+ * ```js
+ * const localeLoaders = Object.fromEntries(
+ *   uiLanguages
+ *     .filter(({ code }) => code !== SOURCE_LOCALE)
+ *     .map(({ code }) => [code, () => import(`./locales/${code}.json`)])
+ * );
+ * export const loadLocale = makeLoadLocale(i18n, localeLoaders, SOURCE_LOCALE);
+ *
+ * // Later, when the user changes language:
+ * await loadLocale('de');
+ * i18n.changeLanguage('de');
+ * ```
+ */
+export declare function makeLoadLocale(i18n: I18nWithResources, localeLoaders: Record<string, () => Promise<{
+    default?: unknown;
+} | unknown>>, sourceLocale?: string): (lang: string) => Promise<void>;
+//# sourceMappingURL=i18next-helpers.d.ts.map

package/dist/runtime/i18next-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18next-helpers.d.ts","sourceRoot":"","sources":["../../src/runtime/i18next-helpers.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,WAAW,CAAC,MAAM,CAgBxC,CAAC;AAEH;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,GAAG,KAAK,CAG3D;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACjD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CAa3E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,SAAO,GAAG;IAC3D,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,sBAAsB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IAChD,aAAa,EAAE;QAAE,WAAW,EAAE,KAAK,CAAA;KAAE,CAAC;IACtC,WAAW,EAAE,KAAK,CAAC;CACpB,CASA;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,MAAM,CAAC;CAChD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAgBxD;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,QAAQ;IACjD,iBAAiB,CACf,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,IAAI,CAAC,EAAE,OAAO,EACd,SAAS,CAAC,EAAE,OAAO,GAClB,IAAI,CAAC;CACT;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,iBAAiB,EACvB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,CAAC,EAC7E,YAAY,SAAO,GAClB,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAsBjC"}

package/dist/runtime/i18next-helpers.js

@@ -0,0 +1,192 @@
+import { interpolateTemplate } from "./template.js";
+/**
+ * Framework-agnostic i18next setup helpers for key-as-default projects.
+ *
+ * These helpers do NOT import from `i18next` or `react-i18next` directly -
+ * they accept a loose `I18nLike` interface so you are not locked to a specific version.
+ *
+ * Typical usage in a React / Next.js project:
+ *
+ * ```js
+ * // src/i18n.js
+ * import i18n from 'i18next';
+ * import { initReactI18next } from 'react-i18next';
+ * import uiLanguages from './locales/ui-languages.json';
+ * import {
+ *   defaultI18nInitOptions, wrapI18nWithKeyTrim,
+ *   makeLoadLocale, applyDirection,
+ * } from 'ai-i18n-tools/runtime';
+ *
+ * // Must match sourceLocale in ai-i18n-tools.config.json
+ * export const SOURCE_LOCALE = 'en-GB';
+ *
+ * void i18n.use(initReactI18next).init(defaultI18nInitOptions(SOURCE_LOCALE));
+ * wrapI18nWithKeyTrim(i18n);
+ * i18n.on('languageChanged', applyDirection);
+ * applyDirection(i18n.language);
+ *
+ * const localeLoaders = Object.fromEntries(
+ *   uiLanguages
+ *     .filter(({ code }) => code !== SOURCE_LOCALE)
+ *     .map(({ code }) => [code, () => import(`./locales/${code}.json`)])
+ * );
+ * export const loadLocale = makeLoadLocale(i18n, localeLoaders, SOURCE_LOCALE);
+ * export default i18n;
+ * ```
+ */
+/**
+ * BCP-47 base language codes that use a right-to-left script.
+ * Covers Arabic script (ar, fa, ur, ps, sd, ug), Hebrew (he, yi), Syriac (syr, aii, cld),
+ * Thaana (dv), Adlam (ff), N'Ko (nqo), Hanifi Rohingya (rhg).
+ */
+export const RTL_LANGS = new Set([
+    "ar",
+    "he",
+    "fa",
+    "ur",
+    "yi",
+    "ps",
+    "sd",
+    "ug",
+    "dv",
+    "ff",
+    "syr",
+    "aii",
+    "cld",
+    "rhg",
+    "nqo",
+]);
+/**
+ * Detect text direction from a BCP-47 locale code.
+ * Strips region/script subtags and checks the base language against {@link RTL_LANGS}.
+ *
+ * @example getTextDirection('ar')      // 'rtl'
+ * @example getTextDirection('fa-IR')   // 'rtl'
+ * @example getTextDirection('en-GB')   // 'ltr'
+ */
+export function getTextDirection(lng) {
+    const base = (lng && lng.split(/[-_]/)[0]) || "";
+    return RTL_LANGS.has(base) ? "rtl" : "ltr";
+}
+/**
+ * Set the `dir` attribute on an element (defaults to `document.documentElement`).
+ * Safe to call in Node.js - checks for `document` existence before accessing DOM.
+ *
+ * @example i18n.on('languageChanged', applyDirection);
+ */
+export function applyDirection(lng, element) {
+    const dir = getTextDirection(lng);
+    if (element) {
+        element.setAttribute("dir", dir);
+        return;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const doc = globalThis["document"];
+    if (doc?.documentElement) {
+        doc.documentElement.setAttribute("dir", dir);
+    }
+}
+/**
+ * Standard i18next `init()` options for key-as-default projects.
+ *
+ * - `parseMissingKeyHandler` returns the key itself, so missing translations
+ *   display the source-language string rather than an error.
+ * - `nsSeparator: false` allows keys that contain colons (e.g. `"Label:"`).
+ * - `interpolation.escapeValue: false` - safe to disable: React escapes values itself,
+ *   and Node.js / CLI output has no HTML to escape.
+ *
+ * Spread into `i18n.init()`:
+ * ```js
+ * i18n.use(initReactI18next).init(defaultI18nInitOptions('en-GB'));
+ * ```
+ *
+ * @param sourceLocale - BCP-47 code used as `lng` and `fallbackLng`. Defaults to `'en'`.
+ */
+export function defaultI18nInitOptions(sourceLocale = "en") {
+    return {
+        resources: {},
+        lng: sourceLocale,
+        fallbackLng: sourceLocale,
+        parseMissingKeyHandler: (key) => key,
+        interpolation: { escapeValue: false },
+        nsSeparator: false,
+    };
+}
+/**
+ * Wrap `i18n.t` so that:
+ * 1. Keys are trimmed before lookup - the extract script stores keys trimmed
+ *    (e.g. `"Label"` not `"Label "`), so `t("Label ")` would miss the cache without this.
+ * 2. Source-locale `{{var}}` interpolation is applied as a fallback - in key-as-default
+ *    mode `parseMissingKeyHandler` returns the raw key string without running
+ *    interpolation, so `t("Hello {{name}}", { name })` would return `"Hello {{name}}"`
+ *    instead of `"Hello World"` for the source locale. This wrapper detects that case
+ *    (result === trimmed key) and applies `interpolateTemplate` automatically.
+ *
+ * Mutates the `t` property on the passed instance in-place.
+ *
+ * @example wrapI18nWithKeyTrim(i18n);
+ */
+export function wrapI18nWithKeyTrim(i18n) {
+    const originalT = i18n.t.bind(i18n);
+    i18n.t = function (key, ...rest) {
+        const normalizedKey = typeof key === "string" ? key.trim() : key;
+        const result = originalT(normalizedKey, ...rest);
+        const options = rest[0];
+        if (result === normalizedKey &&
+            options !== null &&
+            typeof options === "object" &&
+            !Array.isArray(options)) {
+            return interpolateTemplate(result, options);
+        }
+        return result;
+    };
+}
+/**
+ * Create a `loadLocale(lang)` function for dynamic locale loading.
+ *
+ * Pass a map of `{ [localeCode]: () => import('./locales/<code>.json') }` and the
+ * returned function handles loading on demand, skipping the source locale (no file needed).
+ *
+ * @param i18n - i18next instance (must have `addResourceBundle`).
+ * @param localeLoaders - map of locale code → dynamic import factory.
+ * @param sourceLocale - locale code that requires no file (key-as-default); defaults to `'en'`.
+ *
+ * @example
+ * ```js
+ * const localeLoaders = Object.fromEntries(
+ *   uiLanguages
+ *     .filter(({ code }) => code !== SOURCE_LOCALE)
+ *     .map(({ code }) => [code, () => import(`./locales/${code}.json`)])
+ * );
+ * export const loadLocale = makeLoadLocale(i18n, localeLoaders, SOURCE_LOCALE);
+ *
+ * // Later, when the user changes language:
+ * await loadLocale('de');
+ * i18n.changeLanguage('de');
+ * ```
+ */
+export function makeLoadLocale(i18n, localeLoaders, sourceLocale = "en") {
+    return async function loadLocale(lang) {
+        if (lang === sourceLocale || lang === "en")
+            return;
+        const loader = localeLoaders[lang];
+        if (!loader) {
+            console.warn("[i18n] locale not supported:", lang);
+            return;
+        }
+        try {
+            const module = await loader();
+            const data = module !== null &&
+                typeof module === "object" &&
+                "default" in module &&
+                module.default !== undefined
+                ? module.default
+                : module;
+            i18n.addResourceBundle(lang, "translation", data, true, true);
+        }
+        catch (e) {
+            console.warn("[i18n] locale not found:", lang, e instanceof Error ? e.message : e);
+        }
+    };
+}
+//# sourceMappingURL=i18next-helpers.js.map

package/dist/runtime/i18next-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18next-helpers.js","sourceRoot":"","sources":["../../src/runtime/i18next-helpers.ts"],"names":[],"mappings":"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"}

package/dist/runtime/index.d.ts

@@ -0,0 +1,4 @@
+export { interpolateTemplate, flipUiArrowsForRtl } from "./template.js";
+export { getUILanguageLabel, getUILanguageLabelNative, type TranslateFn, } from "./ui-language-display.js";
+export { RTL_LANGS, getTextDirection, applyDirection, defaultI18nInitOptions, wrapI18nWithKeyTrim, makeLoadLocale, type I18nLike, type I18nWithResources, } from "./i18next-helpers.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,KAAK,WAAW,GACjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,sBAAsB,EACtB,mBAAmB,EACnB,cAAc,EACd,KAAK,QAAQ,EACb,KAAK,iBAAiB,GACvB,MAAM,sBAAsB,CAAC"}

package/dist/runtime/index.js

@@ -0,0 +1,4 @@
+export { interpolateTemplate, flipUiArrowsForRtl } from "./template.js";
+export { getUILanguageLabel, getUILanguageLabelNative, } from "./ui-language-display.js";
+export { RTL_LANGS, getTextDirection, applyDirection, defaultI18nInitOptions, wrapI18nWithKeyTrim, makeLoadLocale, } from "./i18next-helpers.js";
+//# sourceMappingURL=index.js.map

package/dist/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EACL,kBAAkB,EAClB,wBAAwB,GAEzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,sBAAsB,EACtB,mBAAmB,EACnB,cAAc,GAGf,MAAM,sBAAsB,CAAC"}

package/dist/runtime/template.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Small string helpers for i18next key-as-default setups.
+ * No i18n dependency - safe for browser or Node.
+ */
+/**
+ * Replace `{{key}}` placeholders (ASCII word keys only) in a pre-translated string.
+ * Use for non-i18next contexts: CLI output, Node.js scripts, or strings already
+ * returned by `t()` that need further substitution outside the React tree.
+ *
+ * In React/i18next components, prefer `t('key {{var}}', { var })` directly -
+ * i18next handles interpolation natively in key-as-default mode.
+ *
+ * @example interpolateTemplate(t("Hello {{name}}"), { name: userName })
+ */
+export declare function interpolateTemplate(str: string, vars: Record<string, string | number | boolean>): string;
+/**
+ * Map U+2192 (→) to U+2190 (←) when the UI is RTL so arrows match reading direction.
+ * Apply to user-visible strings that may contain → (including translated text).
+ */
+export declare function flipUiArrowsForRtl(text: string | null | undefined, isRtl: boolean): string | null | undefined;
+//# sourceMappingURL=template.d.ts.map

package/dist/runtime/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../src/runtime/template.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAC9C,MAAM,CAER;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC/B,KAAK,EAAE,OAAO,GACb,MAAM,GAAG,IAAI,GAAG,SAAS,CAK3B"}

package/dist/runtime/template.js

@@ -0,0 +1,28 @@
+/**
+ * Small string helpers for i18next key-as-default setups.
+ * No i18n dependency - safe for browser or Node.
+ */
+/**
+ * Replace `{{key}}` placeholders (ASCII word keys only) in a pre-translated string.
+ * Use for non-i18next contexts: CLI output, Node.js scripts, or strings already
+ * returned by `t()` that need further substitution outside the React tree.
+ *
+ * In React/i18next components, prefer `t('key {{var}}', { var })` directly -
+ * i18next handles interpolation natively in key-as-default mode.
+ *
+ * @example interpolateTemplate(t("Hello {{name}}"), { name: userName })
+ */
+export function interpolateTemplate(str, vars) {
+    return str.replace(/\{\{(\w+)\}\}/g, (_, key) => String(vars[key] ?? ""));
+}
+/**
+ * Map U+2192 (→) to U+2190 (←) when the UI is RTL so arrows match reading direction.
+ * Apply to user-visible strings that may contain → (including translated text).
+ */
+export function flipUiArrowsForRtl(text, isRtl) {
+    if (!isRtl || text == null || typeof text !== "string") {
+        return text;
+    }
+    return text.replace(/\u2192/g, "\u2190");
+}
+//# sourceMappingURL=template.js.map

package/dist/runtime/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../src/runtime/template.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CACjC,GAAW,EACX,IAA+C;IAE/C,OAAO,GAAG,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC,EAAE,GAAW,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AACpF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAA+B,EAC/B,KAAc;IAEd,IAAI,CAAC,KAAK,IAAI,IAAI,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACvD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAC3C,CAAC"}

package/dist/runtime/ui-language-display.d.ts

@@ -0,0 +1,16 @@
+import type { UiLanguageEntry } from "../core/ui-languages.js";
+/** Minimal translate function (e.g. react-i18next `t`). */
+export type TranslateFn = (key: string) => string;
+/**
+ * Display label for a language row: `englishName`, or `englishName / t(englishName)` when
+ * the translated name differs from the English name.
+ * Uses `" / "` between parts (avoids nested parentheses in long names).
+ */
+export declare function getUILanguageLabel(lang: UiLanguageEntry, t: TranslateFn): string;
+/**
+ * Display label using manifest fields only (no `t()` on the row).
+ * Returns `englishName / label` when they differ (e.g. `German / Deutsch`),
+ * or a single string when they are the same. Suitable for header language menus.
+ */
+export declare function getUILanguageLabelNative(lang: UiLanguageEntry): string;
+//# sourceMappingURL=ui-language-display.d.ts.map

package/dist/runtime/ui-language-display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-language-display.d.ts","sourceRoot":"","sources":["../../src/runtime/ui-language-display.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,2DAA2D;AAC3D,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;AAElD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,EAAE,CAAC,EAAE,WAAW,GAAG,MAAM,CAOhF;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAMtE"}

package/dist/runtime/ui-language-display.js

@@ -0,0 +1,26 @@
+/**
+ * Display label for a language row: `englishName`, or `englishName / t(englishName)` when
+ * the translated name differs from the English name.
+ * Uses `" / "` between parts (avoids nested parentheses in long names).
+ */
+export function getUILanguageLabel(lang, t) {
+    const { englishName } = lang;
+    const translated = t(englishName);
+    if (translated === englishName) {
+        return englishName;
+    }
+    return `${englishName} / ${translated}`;
+}
+/**
+ * Display label using manifest fields only (no `t()` on the row).
+ * Returns `englishName / label` when they differ (e.g. `German / Deutsch`),
+ * or a single string when they are the same. Suitable for header language menus.
+ */
+export function getUILanguageLabelNative(lang) {
+    const { englishName, label } = lang;
+    if (label === englishName) {
+        return label;
+    }
+    return `${englishName} / ${label}`;
+}
+//# sourceMappingURL=ui-language-display.js.map

package/dist/runtime/ui-language-display.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-language-display.js","sourceRoot":"","sources":["../../src/runtime/ui-language-display.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAqB,EAAE,CAAc;IACtE,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IAC7B,MAAM,UAAU,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC;IAClC,IAAI,UAAU,KAAK,WAAW,EAAE,CAAC;QAC/B,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,OAAO,GAAG,WAAW,MAAM,UAAU,EAAE,CAAC;AAC1C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAqB;IAC5D,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;IACpC,IAAI,KAAK,KAAK,WAAW,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,GAAG,WAAW,MAAM,KAAK,EAAE,CAAC;AACrC,CAAC"}

package/dist/server/translation-editor.d.ts

@@ -0,0 +1,25 @@
+import express from "express";
+import { TranslationCache } from "../core/cache.js";
+export interface TranslationEditorOptions {
+    cwd: string;
+    /** Resolved absolute or cwd-relative path to strings.json (workspace B). */
+    stringsJsonPath?: string | null;
+    /** Resolved path to glossary-user.csv (workspace C). */
+    glossaryUserPath?: string | null;
+    /** BCP-47 locale for source / original strings (from config `sourceLocale`). */
+    sourceLocale: string;
+    targetLocales: string[];
+    /**
+     * `documentation.jsonSource` (cwd-relative). Used to print full paths for JSON segments
+     * that were stored relative to this root (e.g. `code.json` → `docs-site/i18n/en/code.json`).
+     */
+    jsonSource?: string | null;
+}
+/** Normalize cache filepath for console log-links (JSON rows may omit jsonSource prefix). */
+export declare function resolveSegmentLogFilepath(filepath: string, jsonSource: string | null | undefined): string;
+/**
+ * Express app: workspace A (cache) + B (strings.json) + C (glossary CSV).
+ */
+export declare function createTranslationEditorApp(cache: TranslationCache, opts: TranslationEditorOptions): express.Application;
+export declare function resolveEditCacheStaticDir(): string;
+//# sourceMappingURL=translation-editor.d.ts.map

package/dist/server/translation-editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translation-editor.d.ts","sourceRoot":"","sources":["../../src/server/translation-editor.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAM9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AA2BpD,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,4EAA4E;IAC5E,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,wDAAwD;IACxD,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,gFAAgF;IAChF,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,6FAA6F;AAC7F,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACpC,MAAM,CAOR;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,WAAW,CA4lBrB;AAED,wBAAgB,yBAAyB,IAAI,MAAM,CAElD"}