@i18n-micro/node 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+ 
+ Copyright (c) 2016 
+ 
+ Permission is hereby granted, free of charge, to any person obtaining a copy
+ of this software and associated documentation files (the "Software"), to deal
+ in the Software without restriction, including without limitation the rights
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ copies of the Software, and to permit persons to whom the Software is
+ furnished to do so, subject to the following conditions:
+ 
+ The above copyright notice and this permission notice shall be included in all
+ copies or substantial portions of the Software.
+ 
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ SOFTWARE.

package/README.md

@@ -0,0 +1,43 @@
+# @i18n-micro/node
+
+Node.js runtime for nuxt-i18n-micro - use i18n translations in any Node.js application, CLI tool, or backend service.
+
+## Installation
+
+```bash
+pnpm add @i18n-micro/node
+# or
+npm install @i18n-micro/node
+# or
+yarn add @i18n-micro/node
+```
+
+## Quick Start
+
+```typescript
+import { createI18n } from '@i18n-micro/node'
+
+// 1. Create I18n instance
+const i18n = createI18n({
+  locale: 'en',
+  fallbackLocale: 'en',
+  translationDir: './locales', // Path to your locales directory
+  disablePageLocales: false, // If true, ignores pages/ folder and treats all files as global translations
+})
+
+// 2. Load translations from directory (recursive, supports pages structure)
+await i18n.loadTranslations()
+
+// 3. Use translations
+console.log(i18n.t('greeting', { name: 'John' })) // "Hello, John!"
+console.log(i18n.tc('apples', 5)) // "5 apples"
+```
+
+## Resources
+
+- **Repository**: [https://github.com/s00d/nuxt-i18n-micro](https://github.com/s00d/nuxt-i18n-micro)
+- **Documentation**: [https://s00d.github.io/nuxt-i18n-micro/](https://s00d.github.io/nuxt-i18n-micro/)
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const b=require("node:fs/promises"),f=require("node:path"),c=require("@i18n-micro/core");async function g(l,e=!1){const t={global:{},routes:{}};try{const r=await b.readdir(l,{recursive:!0,withFileTypes:!0});for(const a of r){if(!a.isFile()||!a.name.endsWith(".json"))continue;const s=f.join(a.path,a.name),o=f.relative(l,s).split(f.sep),i=f.basename(a.name,".json");try{const h=await b.readFile(s,"utf-8"),u=JSON.parse(h);if(!e&&o[0]==="pages"&&o.length>=2){const m=o.slice(1,-1);if(m.length>0){const d=m.join("-");t.routes[d]||(t.routes[d]={}),t.routes[d][i]=u}}else t.global[i]=u}catch(h){console.error(`Failed to load translation file ${s}:`,h)}}}catch(r){r&&typeof r=="object"&&"code"in r&&r.code!=="ENOENT"&&console.error(`Failed to read directory ${l}:`,r)}return t}async function T(l,e=!1){const{global:t}=await g(l,e);return t}class p{constructor(e){this.currentRoute="general",this.cache={generalLocaleCache:{},routeLocaleCache:{},dynamicTranslationsCaches:[],serverTranslationCache:{}},this.helper=c.useTranslationHelper(this.cache),this.formatter=new c.FormatService,this.locale=e.locale,this.fallbackLocale=e.fallbackLocale||e.locale,this.translationDir=e.translationDir,this.disablePageLocales=e.disablePageLocales??!1,this.pluralFunc=e.plural||c.defaultPlural,this.missingWarn=e.missingWarn??!1,this.missingHandler=e.missingHandler}setRoute(e){this.currentRoute=e}getRoute(){return this.currentRoute}t(e,t,r,a){if(!e)return"";const s=a||this.currentRoute;let n=this.helper.getTranslation(this.locale,s,e);return!n&&this.locale!==this.fallbackLocale&&(n=this.helper.getTranslation(this.fallbackLocale,s,e)),n||(this.missingHandler?this.missingHandler(this.locale,e,s):this.missingWarn&&console.warn(`[i18n] Translation key '${e}' not found for locale '${this.locale}' (route: '${s}').`),n=r===void 0?e:r||e),typeof n=="string"&&t?c.interpolate(n,t):n||e}ts(e,t,r,a){return this.t(e,t,r,a)?.toString()??r??e}tc(e,t,r){const{count:a,...s}=typeof t=="number"?{count:t}:t;if(a===void 0)return r??e;const n=(i,h,u)=>this.t(i,h,u);return this.pluralFunc(e,Number.parseInt(a.toString()),s,this.locale,n)??r??e}tn(e,t){return this.formatter.formatNumber(e,this.locale,t)}td(e,t){return this.formatter.formatDate(e,this.locale,t)}tdr(e,t){return this.formatter.formatRelativeTime(e,this.locale,t)}async loadTranslations(e){const t=e||this.translationDir;if(!t){console.warn("[i18n-node] No translation directory specified");return}const{global:r,routes:a}=await g(t,this.disablePageLocales);for(const[s,n]of Object.entries(r))this.helper.mergeGlobalTranslation(s,n,!0);for(const[s,n]of Object.entries(a))for(const[o,i]of Object.entries(n))await this.helper.loadPageTranslations(o,s,i)}async reload(){this.helper.clearCache(),await this.loadTranslations(),console.log("[i18n-node] Cache cleared and translations reloaded.")}addTranslations(e,t,r=!0){r?this.helper.mergeGlobalTranslation(e,t,!0):this.helper.loadTranslations(e,t)}addRouteTranslations(e,t,r,a=!0){a?this.helper.mergeTranslation(e,t,r,!0):this.helper.loadPageTranslations(e,t,r)}hasTranslation(e){return this.helper.hasTranslation(this.locale,e)}clear(){this.helper.clearCache()}}function v(l){return new p(l)}Object.defineProperty(exports,"FormatService",{enumerable:!0,get:()=>c.FormatService});Object.defineProperty(exports,"interpolate",{enumerable:!0,get:()=>c.interpolate});exports.I18n=p;exports.createI18n=v;exports.loadGlobalTranslations=T;exports.loadTranslations=g;

package/dist/index.d.ts

@@ -0,0 +1,144 @@
+import { CleanTranslation } from '@i18n-micro/types';
+import { FormatService } from '@i18n-micro/core';
+import { Getter } from '@i18n-micro/types';
+import { interpolate } from '@i18n-micro/core';
+import { Locale } from '@i18n-micro/types';
+import { LocaleCode } from '@i18n-micro/types';
+import { Params } from '@i18n-micro/types';
+import { PluralFunc } from '@i18n-micro/types';
+import { TranslationKey } from '@i18n-micro/types';
+import { Translations } from '@i18n-micro/types';
+
+export { CleanTranslation }
+
+/**
+ * Create a new I18n instance
+ */
+export declare function createI18n(options: I18nOptions): I18n;
+
+export { FormatService }
+
+export { Getter }
+
+/**
+ * Node.js I18n Adapter
+ *
+ * Provides a standalone i18n instance that uses the shared core logic from nuxt-i18n-micro.
+ * Fully compatible with the file structure and caching mechanisms of the Nuxt module.
+ */
+export declare class I18n {
+    locale: string;
+    fallbackLocale: string;
+    translationDir?: string;
+    private disablePageLocales;
+    /**
+     * Current active route name for translations.
+     * Defaults to 'general' (global translations only).
+     * Change this using setRoute() to access page-specific translations.
+     */
+    currentRoute: string;
+    private cache;
+    readonly helper: {
+        hasCache(locale: string, page: string): boolean;
+        getCache(locale: string, routeName: string): Map<string, unknown> | undefined;
+        setCache(locale: string, routeName: string, cache: Map<string, Translations | unknown>): void;
+        mergeTranslation(locale: string, routeName: string, newTranslations: Translations, force?: boolean): void;
+        mergeGlobalTranslation(locale: string, newTranslations: Translations, force?: boolean): void;
+        hasGeneralTranslation(locale: string): boolean;
+        hasPageTranslation(locale: string, routeName: string): boolean;
+        hasTranslation: (locale: string, key: TranslationKey) => boolean;
+        getTranslation: <T = unknown>(locale: string, routeName: string, key: TranslationKey) => T | null;
+        loadPageTranslations(locale: string, routeName: string, translations: Translations): Promise<void>;
+        loadTranslations(locale: string, translations: Translations): Promise<void>;
+        clearCache(): void;
+    };
+    private formatter;
+    private pluralFunc;
+    private missingWarn;
+    private missingHandler?;
+    constructor(options: I18nOptions);
+    /**
+     * Set the current route name context.
+     * Useful when processing a specific page request in Node.
+     */
+    setRoute(routeName: string): void;
+    getRoute(): string;
+    /**
+     * Get translation for a key
+     *
+     * Search order:
+     * 1. Current Locale + Current Route (Specific)
+     * 2. Current Locale + General (Global)
+     * 3. Fallback Locale + Current Route
+     * 4. Fallback Locale + General
+     */
+    t(key: TranslationKey, params?: Params, defaultValue?: string | null, routeName?: string): string;
+    /**
+     * Get translation as string
+     */
+    ts(key: TranslationKey, params?: Params, defaultValue?: string, routeName?: string): string;
+    /**
+     * Plural translation
+     */
+    tc(key: TranslationKey, count: number | Params, defaultValue?: string): string;
+    tn(value: number, options?: Intl.NumberFormatOptions): string;
+    td(value: Date | number | string, options?: Intl.DateTimeFormatOptions): string;
+    tdr(value: Date | number | string, options?: Intl.RelativeTimeFormatOptions): string;
+    /**
+     * Load translations from directory.
+     */
+    loadTranslations(dir?: string): Promise<void>;
+    /**
+     * Clear cache and reload translations from disk
+     */
+    reload(): Promise<void>;
+    addTranslations(locale: string, translations: Translations, merge?: boolean): void;
+    addRouteTranslations(locale: string, routeName: string, translations: Translations, merge?: boolean): void;
+    hasTranslation(key: TranslationKey): boolean;
+    clear(): void;
+}
+
+export declare interface I18nOptions {
+    locale: string;
+    fallbackLocale?: string;
+    translationDir?: string;
+    plural?: PluralFunc;
+    missingWarn?: boolean;
+    missingHandler?: (locale: string, key: string, routeName: string) => void;
+    disablePageLocales?: boolean;
+}
+
+export { interpolate }
+
+export declare interface LoadedTranslations {
+    global: Record<string, Translations>;
+    routes: Record<string, Record<string, Translations>>;
+}
+
+/**
+ * Load only global translations from a directory
+ * @param dir - Directory path containing translation files
+ * @param disablePageLocales - If true, ignores pages/ folder and treats all files as global translations
+ */
+export declare function loadGlobalTranslations(dir: string, disablePageLocales?: boolean): Promise<Record<string, Translations>>;
+
+/**
+ * Load translations from a directory
+ * Supports both flat structure (locales/{lang}.json) and nested structure (locales/pages/{page}/{lang}.json)
+ * @param dir - Directory path containing translation files
+ * @param disablePageLocales - If true, ignores pages/ folder and treats all files as global translations
+ * @returns Object with global and route-specific translations
+ */
+export declare function loadTranslations(dir: string, disablePageLocales?: boolean): Promise<LoadedTranslations>;
+
+export { Locale }
+
+export { LocaleCode }
+
+export { Params }
+
+export { PluralFunc }
+
+export { Translations }
+
+export { }

package/dist/index.mjs

@@ -0,0 +1,154 @@
+import { readdir as m, readFile as g } from "node:fs/promises";
+import { join as p, relative as T, sep as b, basename as v } from "node:path";
+import { useTranslationHelper as w, FormatService as L, defaultPlural as P, interpolate as F } from "@i18n-micro/core";
+import { FormatService as $, interpolate as y } from "@i18n-micro/core";
+async function d(o, e = !1) {
+  const t = {
+    global: {},
+    routes: {}
+  };
+  try {
+    const r = await m(o, { recursive: !0, withFileTypes: !0 });
+    for (const a of r) {
+      if (!a.isFile() || !a.name.endsWith(".json"))
+        continue;
+      const s = p(a.path, a.name), n = T(o, s).split(b), i = v(a.name, ".json");
+      try {
+        const c = await g(s, "utf-8"), h = JSON.parse(c);
+        if (!e && n[0] === "pages" && n.length >= 2) {
+          const f = n.slice(1, -1);
+          if (f.length > 0) {
+            const u = f.join("-");
+            t.routes[u] || (t.routes[u] = {}), t.routes[u][i] = h;
+          }
+        } else
+          t.global[i] = h;
+      } catch (c) {
+        console.error(`Failed to load translation file ${s}:`, c);
+      }
+    }
+  } catch (r) {
+    r && typeof r == "object" && "code" in r && r.code !== "ENOENT" && console.error(`Failed to read directory ${o}:`, r);
+  }
+  return t;
+}
+async function D(o, e = !1) {
+  const { global: t } = await d(o, e);
+  return t;
+}
+class j {
+  constructor(e) {
+    this.currentRoute = "general", this.cache = {
+      generalLocaleCache: {},
+      routeLocaleCache: {},
+      dynamicTranslationsCaches: [],
+      serverTranslationCache: {}
+    }, this.helper = w(this.cache), this.formatter = new L(), this.locale = e.locale, this.fallbackLocale = e.fallbackLocale || e.locale, this.translationDir = e.translationDir, this.disablePageLocales = e.disablePageLocales ?? !1, this.pluralFunc = e.plural || P, this.missingWarn = e.missingWarn ?? !1, this.missingHandler = e.missingHandler;
+  }
+  /**
+   * Set the current route name context.
+   * Useful when processing a specific page request in Node.
+   */
+  setRoute(e) {
+    this.currentRoute = e;
+  }
+  getRoute() {
+    return this.currentRoute;
+  }
+  /**
+   * Get translation for a key
+   *
+   * Search order:
+   * 1. Current Locale + Current Route (Specific)
+   * 2. Current Locale + General (Global)
+   * 3. Fallback Locale + Current Route
+   * 4. Fallback Locale + General
+   */
+  t(e, t, r, a) {
+    if (!e) return "";
+    const s = a || this.currentRoute;
+    let l = this.helper.getTranslation(this.locale, s, e);
+    return !l && this.locale !== this.fallbackLocale && (l = this.helper.getTranslation(this.fallbackLocale, s, e)), l || (this.missingHandler ? this.missingHandler(this.locale, e, s) : this.missingWarn && console.warn(
+      `[i18n] Translation key '${e}' not found for locale '${this.locale}' (route: '${s}').`
+    ), l = r === void 0 ? e : r || e), typeof l == "string" && t ? F(l, t) : l || e;
+  }
+  /**
+   * Get translation as string
+   */
+  ts(e, t, r, a) {
+    return this.t(e, t, r, a)?.toString() ?? r ?? e;
+  }
+  /**
+   * Plural translation
+   */
+  tc(e, t, r) {
+    const { count: a, ...s } = typeof t == "number" ? { count: t } : t;
+    if (a === void 0)
+      return r ?? e;
+    const l = (i, c, h) => this.t(i, c, h);
+    return this.pluralFunc(
+      e,
+      Number.parseInt(a.toString()),
+      s,
+      this.locale,
+      l
+    ) ?? r ?? e;
+  }
+  // --- Formatters ---
+  tn(e, t) {
+    return this.formatter.formatNumber(e, this.locale, t);
+  }
+  td(e, t) {
+    return this.formatter.formatDate(e, this.locale, t);
+  }
+  tdr(e, t) {
+    return this.formatter.formatRelativeTime(e, this.locale, t);
+  }
+  // --- Loader & Cache Management ---
+  /**
+   * Load translations from directory.
+   */
+  async loadTranslations(e) {
+    const t = e || this.translationDir;
+    if (!t) {
+      console.warn("[i18n-node] No translation directory specified");
+      return;
+    }
+    const { global: r, routes: a } = await d(t, this.disablePageLocales);
+    for (const [s, l] of Object.entries(r))
+      this.helper.mergeGlobalTranslation(s, l, !0);
+    for (const [s, l] of Object.entries(a))
+      for (const [n, i] of Object.entries(l))
+        await this.helper.loadPageTranslations(n, s, i);
+  }
+  /**
+   * Clear cache and reload translations from disk
+   */
+  async reload() {
+    this.helper.clearCache(), await this.loadTranslations(), console.log("[i18n-node] Cache cleared and translations reloaded.");
+  }
+  // --- Manual Manipulation ---
+  addTranslations(e, t, r = !0) {
+    r ? this.helper.mergeGlobalTranslation(e, t, !0) : this.helper.loadTranslations(e, t);
+  }
+  addRouteTranslations(e, t, r, a = !0) {
+    a ? this.helper.mergeTranslation(e, t, r, !0) : this.helper.loadPageTranslations(e, t, r);
+  }
+  hasTranslation(e) {
+    return this.helper.hasTranslation(this.locale, e);
+  }
+  clear() {
+    this.helper.clearCache();
+  }
+}
+function H(o) {
+  return new j(o);
+}
+export {
+  $ as FormatService,
+  j as I18n,
+  H as createI18n,
+  y as interpolate,
+  D as loadGlobalTranslations,
+  d as loadTranslations
+};

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@i18n-micro/node",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@i18n-micro/core": "1.0.27",
+    "@i18n-micro/types": "1.0.15"
+  },
+  "devDependencies": {
+    "@types/node": "^20.17.10",
+    "vite": "^5.0.0",
+    "vite-plugin-dts": "^4.3.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.2",
+    "@types/jest": "^29.5.0"
+  },
+  "scripts": {
+    "build": "vite build",
+    "dev": "cd playground && npm run dev",
+    "test": "jest",
+    "typecheck": "tsc --noEmit"
+  }
+}