@things-factory/i18n-base 10.1.147 → 10.1.150

package/dist-server/index.d.ts

@@ -2,6 +2,8 @@ import './routes';
 export * from './service';
 export * from './apis';
 export * from './middlewares';
+export { translatorFor, loadTranslations } from './translator';
+export type { Translate } from './translator';
 export * from './controllers/clear-cache-for-translation.js';
 export * from './ai-entry/terminology-entry-targets';
 export type { EntryTargetDeclaration as TerminologyEntryTarget } from './ai-entry/entry-target-shape';

package/dist-server/index.js

@@ -1,10 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadTranslations = exports.translatorFor = void 0;
 const tslib_1 = require("tslib");
 require("./routes");
 tslib_1.__exportStar(require("./service"), exports);
 tslib_1.__exportStar(require("./apis"), exports);
 tslib_1.__exportStar(require("./middlewares"), exports);
+var translator_1 = require("./translator");
+Object.defineProperty(exports, "translatorFor", { enumerable: true, get: function () { return translator_1.translatorFor; } });
+Object.defineProperty(exports, "loadTranslations", { enumerable: true, get: function () { return translator_1.loadTranslations; } });
 tslib_1.__exportStar(require("./controllers/clear-cache-for-translation.js"), exports);
 tslib_1.__exportStar(require("./ai-entry/terminology-entry-targets"), exports);
 //# sourceMappingURL=index.js.map

package/dist-server/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../server/index.ts"],"names":[],"mappings":";;;AAAA,oBAAiB;AAEjB,oDAAyB;AACzB,iDAAsB;AACtB,wDAA6B;AAC7B,uFAA4D;AAC5D,+EAAoD","sourcesContent":["import './routes'\n\nexport * from './service'\nexport * from './apis'\nexport * from './middlewares'\nexport * from './controllers/clear-cache-for-translation.js'\nexport * from './ai-entry/terminology-entry-targets'\nexport type { EntryTargetDeclaration as TerminologyEntryTarget } from './ai-entry/entry-target-shape'\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../server/index.ts"],"names":[],"mappings":";;;;AAAA,oBAAiB;AAEjB,oDAAyB;AACzB,iDAAsB;AACtB,wDAA6B;AAC7B,2CAA8D;AAArD,2GAAA,aAAa,OAAA;AAAE,8GAAA,gBAAgB,OAAA;AAExC,uFAA4D;AAC5D,+EAAoD","sourcesContent":["import './routes'\n\nexport * from './service'\nexport * from './apis'\nexport * from './middlewares'\nexport { translatorFor, loadTranslations } from './translator'\nexport type { Translate } from './translator'\nexport * from './controllers/clear-cache-for-translation.js'\nexport * from './ai-entry/terminology-entry-targets'\nexport type { EntryTargetDeclaration as TerminologyEntryTarget } from './ai-entry/entry-target-shape'\n"]}

package/dist-server/middlewares/index.js

@@ -2,30 +2,14 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.initMiddlewares = initMiddlewares;
 const tslib_1 = require("tslib");
-const fs_1 = tslib_1.__importDefault(require("fs"));
-const i18next_1 = tslib_1.__importDefault(require("i18next"));
 const koa_i18next_1 = tslib_1.__importDefault(require("./koa-i18next"));
-const translations_1 = require("./translations");
-i18next_1.default.init({
-    debug: false,
-    ns: ['translations'],
-    defaultNS: 'translations',
-    preload: ['ko', 'en', 'ja', 'zh', 'ms', 'es'],
-    fallbackLng: 'en',
-    interpolation: {
-        prefix: '{',
-        suffix: '}'
-    },
-    load: 'languageOnly',
-    keySeparator: false
-});
-(0, translations_1.build)(fs_1.default);
-process.on('client-rebuilt', (app, fs) => {
-    /* rebuild once done webpacking assets. only for development mode. */
-    (0, translations_1.build)(fs);
+const translator_1 = require("../translator");
+process.on('client-rebuilt', () => {
+    /* A dev build ran — the sources may have changed. Reload from them, not from what webpack wrote. */
+    (0, translator_1.loadTranslations)();
 });
 function initMiddlewares(app) {
-    app.use((0, koa_i18next_1.default)(i18next_1.default, {
+    app.use((0, koa_i18next_1.default)(translator_1.i18next, {
         lookupCookie: 'i18next',
         order: ['cookie', 'header'],
         next: true // if koa is version 2

package/dist-server/middlewares/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../server/middlewares/index.ts"],"names":[],"mappings":";;AA2BA,0CAQC;;AAnCD,oDAAmB;AACnB,8DAA6B;AAE7B,wEAAsC;AACtC,iDAAsC;AAEtC,iBAAO,CAAC,IAAI,CAAC;IACX,KAAK,EAAE,KAAK;IACZ,EAAE,EAAE,CAAC,cAAc,CAAC;IACpB,SAAS,EAAE,cAAc;IACzB,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;IAC7C,WAAW,EAAE,IAAI;IACjB,aAAa,EAAE;QACb,MAAM,EAAE,GAAG;QACX,MAAM,EAAE,GAAG;KACZ;IACD,IAAI,EAAE,cAAc;IACpB,YAAY,EAAE,KAAK;CACpB,CAAC,CAAA;AAEF,IAAA,oBAAK,EAAC,YAAE,CAAC,CAAA;AAET,OAAO,CAAC,EAAE,CAAC,gBAAuB,EAAE,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE;IAC9C,qEAAqE;IACrE,IAAA,oBAAK,EAAC,EAAE,CAAC,CAAA;AACX,CAAC,CAAC,CAAA;AAEF,SAAgB,eAAe,CAAC,GAAQ;IACtC,GAAG,CAAC,GAAG,CACL,IAAA,qBAAU,EAAC,iBAAO,EAAE;QAClB,YAAY,EAAE,SAAS;QACvB,KAAK,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;QAC3B,IAAI,EAAE,IAAI,CAAC,sBAAsB;KAClC,CAAC,CACH,CAAA;AACH,CAAC","sourcesContent":["import fs from 'fs'\nimport i18next from 'i18next'\n\nimport koaI18next from './koa-i18next'\nimport { build } from './translations'\n\ni18next.init({\n  debug: false,\n  ns: ['translations'],\n  defaultNS: 'translations',\n  preload: ['ko', 'en', 'ja', 'zh', 'ms', 'es'],\n  fallbackLng: 'en',\n  interpolation: {\n    prefix: '{',\n    suffix: '}'\n  },\n  load: 'languageOnly',\n  keySeparator: false\n})\n\nbuild(fs)\n\nprocess.on('client-rebuilt' as any, (app, fs) => {\n  /* rebuild once done webpacking assets. only for development mode. */\n  build(fs)\n})\n\nexport function initMiddlewares(app: any) {\n  app.use(\n    koaI18next(i18next, {\n      lookupCookie: 'i18next',\n      order: ['cookie', 'header'],\n      next: true // if koa is version 2\n    })\n  )\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../server/middlewares/index.ts"],"names":[],"mappings":";;AAQA,0CAQC;;AAhBD,wEAAsC;AACtC,8CAAyD;AAEzD,OAAO,CAAC,EAAE,CAAC,gBAAuB,EAAE,GAAG,EAAE;IACvC,oGAAoG;IACpG,IAAA,6BAAgB,GAAE,CAAA;AACpB,CAAC,CAAC,CAAA;AAEF,SAAgB,eAAe,CAAC,GAAQ;IACtC,GAAG,CAAC,GAAG,CACL,IAAA,qBAAU,EAAC,oBAAO,EAAE;QAClB,YAAY,EAAE,SAAS;QACvB,KAAK,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;QAC3B,IAAI,EAAE,IAAI,CAAC,sBAAsB;KAClC,CAAC,CACH,CAAA;AACH,CAAC","sourcesContent":["import koaI18next from './koa-i18next'\nimport { i18next, loadTranslations } from '../translator'\n\nprocess.on('client-rebuilt' as any, () => {\n  /* A dev build ran — the sources may have changed. Reload from them, not from what webpack wrote. */\n  loadTranslations()\n})\n\nexport function initMiddlewares(app: any) {\n  app.use(\n    koaI18next(i18next, {\n      lookupCookie: 'i18next',\n      order: ['cookie', 'header'],\n      next: true // if koa is version 2\n    })\n  )\n}\n"]}

package/dist-server/translator.d.ts

@@ -0,0 +1,29 @@
+import i18next from 'i18next';
+/**
+ * The server's translations — loaded from the sources, not from the webpack output.
+ *
+ * ── What was wrong (2026-10-11) ──────────────────────────────────────────
+ * The server read only `dist-app/translations`, which webpack writes. A test run never has it, and a
+ * dev server has it only after its first webpack pass. Server code that froze a sentence before then
+ * got the key back. The sources are every module's `translations/` folder and the application's own,
+ * merged by the same rule the bundler uses (`collectTranslations` in env).
+ *
+ * This file is light on purpose — no routes, no entities — so server code and tests can take a
+ * translator without loading the whole module (`@things-factory/i18n-base/translator`).
+ */
+export declare const NAMESPACE = "translations";
+/** Load every locale from the sources. Called once here, and again when a dev build changes them. */
+export declare function loadTranslations(): void;
+export type Translate = (key: string, options?: {
+    [name: string]: unknown;
+}) => string;
+/**
+ * A translator for one language that **does not fall back** to another.
+ *
+ * A request's translator falls back to English, which is right for a screen. A sentence the server
+ * stores is not: an English sentence filed as the Korean one is wrong and nobody sees why. So a key
+ * missing in this language — with its `context` form and without — answers `options.defaultValue`,
+ * and the caller decides what that means.
+ */
+export declare function translatorFor(lng: string): Translate;
+export { i18next };

package/dist-server/translator.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.i18next = exports.NAMESPACE = void 0;
+exports.loadTranslations = loadTranslations;
+exports.translatorFor = translatorFor;
+const tslib_1 = require("tslib");
+const i18next_1 = tslib_1.__importDefault(require("i18next"));
+exports.i18next = i18next_1.default;
+const env_1 = require("@things-factory/env");
+/**
+ * The server's translations — loaded from the sources, not from the webpack output.
+ *
+ * ── What was wrong (2026-10-11) ──────────────────────────────────────────
+ * The server read only `dist-app/translations`, which webpack writes. A test run never has it, and a
+ * dev server has it only after its first webpack pass. Server code that froze a sentence before then
+ * got the key back. The sources are every module's `translations/` folder and the application's own,
+ * merged by the same rule the bundler uses (`collectTranslations` in env).
+ *
+ * This file is light on purpose — no routes, no entities — so server code and tests can take a
+ * translator without loading the whole module (`@things-factory/i18n-base/translator`).
+ */
+exports.NAMESPACE = 'translations';
+i18next_1.default.init({
+    initImmediate: false,
+    debug: false,
+    ns: [exports.NAMESPACE],
+    defaultNS: exports.NAMESPACE,
+    preload: ['ko', 'en', 'ja', 'zh', 'ms', 'es'],
+    fallbackLng: 'en',
+    interpolation: {
+        prefix: '{',
+        suffix: '}'
+    },
+    load: 'languageOnly',
+    keySeparator: false
+});
+/** Load every locale from the sources. Called once here, and again when a dev build changes them. */
+function loadTranslations() {
+    const all = (0, env_1.collectTranslations)(exports.NAMESPACE);
+    for (const lng of Object.keys(all)) {
+        i18next_1.default.removeResourceBundle(lng, exports.NAMESPACE);
+        i18next_1.default.addResourceBundle(lng, exports.NAMESPACE, all[lng], true, true);
+    }
+}
+loadTranslations();
+/**
+ * A translator for one language that **does not fall back** to another.
+ *
+ * A request's translator falls back to English, which is right for a screen. A sentence the server
+ * stores is not: an English sentence filed as the Korean one is wrong and nobody sees why. So a key
+ * missing in this language — with its `context` form and without — answers `options.defaultValue`,
+ * and the caller decides what that means.
+ */
+function translatorFor(lng) {
+    const fixed = i18next_1.default.getFixedT(lng, exports.NAMESPACE);
+    const has = (key) => i18next_1.default.getResource(lng, exports.NAMESPACE, key) !== undefined;
+    return (key, options = {}) => {
+        const context = options.context === undefined || options.context === null ? '' : String(options.context);
+        if ((context && has(`${key}_${context}`)) || has(key)) {
+            return fixed(key, options);
+        }
+        return options.defaultValue ?? key;
+    };
+}
+//# sourceMappingURL=translator.js.map

package/dist-server/translator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"translator.js","sourceRoot":"","sources":["../server/translator.ts"],"names":[],"mappings":";;;AAkCA,4CAOC;AAcD,sCAaC;;AApED,8DAA6B;AAsEpB,kBAtEF,iBAAO,CAsEE;AApEhB,6CAAyD;AAEzD;;;;;;;;;;;GAWG;AACU,QAAA,SAAS,GAAG,cAAc,CAAA;AAEvC,iBAAO,CAAC,IAAI,CAAC;IACX,aAAa,EAAE,KAAK;IACpB,KAAK,EAAE,KAAK;IACZ,EAAE,EAAE,CAAC,iBAAS,CAAC;IACf,SAAS,EAAE,iBAAS;IACpB,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;IAC7C,WAAW,EAAE,IAAI;IACjB,aAAa,EAAE;QACb,MAAM,EAAE,GAAG;QACX,MAAM,EAAE,GAAG;KACZ;IACD,IAAI,EAAE,cAAc;IACpB,YAAY,EAAE,KAAK;CACpB,CAAC,CAAA;AAEF,qGAAqG;AACrG,SAAgB,gBAAgB;IAC9B,MAAM,GAAG,GAAG,IAAA,yBAAmB,EAAC,iBAAS,CAAC,CAAA;IAE1C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,iBAAO,CAAC,oBAAoB,CAAC,GAAG,EAAE,iBAAS,CAAC,CAAA;QAC5C,iBAAO,CAAC,iBAAiB,CAAC,GAAG,EAAE,iBAAS,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;IACjE,CAAC;AACH,CAAC;AAED,gBAAgB,EAAE,CAAA;AAIlB;;;;;;;GAOG;AACH,SAAgB,aAAa,CAAC,GAAW;IACvC,MAAM,KAAK,GAAG,iBAAO,CAAC,SAAS,CAAC,GAAG,EAAE,iBAAS,CAAC,CAAA;IAC/C,MAAM,GAAG,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,iBAAO,CAAC,WAAW,CAAC,GAAG,EAAE,iBAAS,EAAE,GAAG,CAAC,KAAK,SAAS,CAAA;IAEnF,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,EAAE,EAAE,EAAE;QAC3B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QAExG,IAAI,CAAC,OAAO,IAAI,GAAG,CAAC,GAAG,GAAG,IAAI,OAAO,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACtD,OAAO,KAAK,CAAC,GAAG,EAAE,OAAc,CAAW,CAAA;QAC7C,CAAC;QAED,OAAQ,OAAO,CAAC,YAAuB,IAAI,GAAG,CAAA;IAChD,CAAC,CAAA;AACH,CAAC","sourcesContent":["import i18next from 'i18next'\n\nimport { collectTranslations } from '@things-factory/env'\n\n/**\n * The server's translations — loaded from the sources, not from the webpack output.\n *\n * ── What was wrong (2026-10-11) ──────────────────────────────────────────\n * The server read only `dist-app/translations`, which webpack writes. A test run never has it, and a\n * dev server has it only after its first webpack pass. Server code that froze a sentence before then\n * got the key back. The sources are every module's `translations/` folder and the application's own,\n * merged by the same rule the bundler uses (`collectTranslations` in env).\n *\n * This file is light on purpose — no routes, no entities — so server code and tests can take a\n * translator without loading the whole module (`@things-factory/i18n-base/translator`).\n */\nexport const NAMESPACE = 'translations'\n\ni18next.init({\n  initImmediate: false,\n  debug: false,\n  ns: [NAMESPACE],\n  defaultNS: NAMESPACE,\n  preload: ['ko', 'en', 'ja', 'zh', 'ms', 'es'],\n  fallbackLng: 'en',\n  interpolation: {\n    prefix: '{',\n    suffix: '}'\n  },\n  load: 'languageOnly',\n  keySeparator: false\n})\n\n/** Load every locale from the sources. Called once here, and again when a dev build changes them. */\nexport function loadTranslations(): void {\n  const all = collectTranslations(NAMESPACE)\n\n  for (const lng of Object.keys(all)) {\n    i18next.removeResourceBundle(lng, NAMESPACE)\n    i18next.addResourceBundle(lng, NAMESPACE, all[lng], true, true)\n  }\n}\n\nloadTranslations()\n\nexport type Translate = (key: string, options?: { [name: string]: unknown }) => string\n\n/**\n * A translator for one language that **does not fall back** to another.\n *\n * A request's translator falls back to English, which is right for a screen. A sentence the server\n * stores is not: an English sentence filed as the Korean one is wrong and nobody sees why. So a key\n * missing in this language — with its `context` form and without — answers `options.defaultValue`,\n * and the caller decides what that means.\n */\nexport function translatorFor(lng: string): Translate {\n  const fixed = i18next.getFixedT(lng, NAMESPACE)\n  const has = (key: string) => i18next.getResource(lng, NAMESPACE, key) !== undefined\n\n  return (key, options = {}) => {\n    const context = options.context === undefined || options.context === null ? '' : String(options.context)\n\n    if ((context && has(`${key}_${context}`)) || has(key)) {\n      return fixed(key, options as any) as string\n    }\n\n    return (options.defaultValue as string) ?? key\n  }\n}\n\nexport { i18next }\n"]}