@cellarnode/i18n 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CellarNode
+
+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,116 @@
+# @cellarnode/i18n
+
+Shared i18n configuration for CellarNode frontends — language constants, i18next factory, browser locale detection, and common translations.
+
+## Install
+
+```bash
+pnpm add @cellarnode/i18n react-i18next i18next i18next-http-backend i18next-browser-languagedetector
+```
+
+## Usage
+
+### Initialize i18next
+
+```ts
+// src/lib/i18n.ts
+import { createI18nInstance } from "@cellarnode/i18n";
+
+const i18n = createI18nInstance({
+  defaultNS: "common",
+  ns: ["common", "navigation"],
+  loadPath: "/locales/{{lng}}/{{ns}}.json",
+});
+
+export default i18n;
+```
+
+### Wrap your app
+
+```tsx
+import { I18nextProvider } from "react-i18next";
+import i18n from "@/lib/i18n";
+
+function App() {
+  return (
+    <I18nextProvider i18n={i18n}>
+      <YourApp />
+    </I18nextProvider>
+  );
+}
+```
+
+### Translate strings
+
+```tsx
+import { useTranslation } from "react-i18next";
+
+function MyComponent() {
+  const { t } = useTranslation("common");
+  return <button>{t("save")}</button>;
+}
+```
+
+### Detect browser language
+
+```ts
+import { resolveLanguageFromBrowser } from "@cellarnode/i18n";
+
+// Maps regional variants to supported languages
+resolveLanguageFromBrowser("fr-CA"); // "fr"
+resolveLanguageFromBrowser("zh-Hans-CN"); // "zh"
+resolveLanguageFromBrowser("ja"); // "en" (fallback)
+```
+
+### Copy common translations (build script)
+
+Add to your `package.json` scripts to copy shared `common.json` files into your project:
+
+```json
+{
+  "scripts": {
+    "predev": "node --input-type=module -e \"import '@cellarnode/i18n/scripts/copy-common'\"",
+    "prebuild": "node --input-type=module -e \"import '@cellarnode/i18n/scripts/copy-common'\""
+  }
+}
+```
+
+This copies `locales/{lang}/common.json` from the installed package into `public/locales/{lang}/common.json`.
+
+## Exports
+
+### `@cellarnode/i18n`
+
+| Export | Description |
+|--------|-------------|
+| `createI18nInstance(options)` | i18next factory with HttpBackend + LanguageDetector |
+| `resolveLanguageFromBrowser(locale)` | Maps browser locale to supported language |
+| `getLanguageDisplayName(lang)` | Returns native display name (e.g., "Svenska") |
+| `SUPPORTED_LANGUAGES` | `['en', 'zh', 'fr', 'de', 'it', 'es', 'sv']` |
+| `DEFAULT_LANGUAGE` | `'en'` |
+| `LANGUAGE_DISPLAY_NAMES` | Map of codes to native names |
+| `SupportedLanguage` | TypeScript union type |
+
+### `@cellarnode/i18n/locales/*`
+
+JSON translation files for all 7 languages. Currently includes `common.json`.
+
+### `@cellarnode/i18n/scripts/copy-common`
+
+CLI script that copies common locale files from the package into `public/locales/`.
+
+## Supported Languages
+
+| Code | Language | Native |
+|------|----------|--------|
+| `en` | English | English |
+| `zh` | Chinese (Simplified) | 中文 |
+| `fr` | French | Francais |
+| `de` | German | Deutsch |
+| `it` | Italian | Italiano |
+| `es` | Spanish | Espanol |
+| `sv` | Swedish | Svenska |
+
+## License
+
+MIT

package/dist/__tests__/constants.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/constants.test.js

@@ -0,0 +1,33 @@
+import { describe, it, expect } from 'vitest';
+import { SUPPORTED_LANGUAGES, DEFAULT_LANGUAGE, LANGUAGE_DISPLAY_NAMES, } from '../constants';
+describe('SUPPORTED_LANGUAGES', () => {
+    it('contains exactly 7 languages', () => {
+        expect(SUPPORTED_LANGUAGES).toHaveLength(7);
+    });
+    it('contains all required language codes', () => {
+        expect(SUPPORTED_LANGUAGES).toEqual(expect.arrayContaining(['en', 'zh', 'fr', 'de', 'it', 'es', 'sv']));
+    });
+    it('has en as the first element', () => {
+        expect(SUPPORTED_LANGUAGES[0]).toBe('en');
+    });
+});
+describe('DEFAULT_LANGUAGE', () => {
+    it('is en', () => {
+        expect(DEFAULT_LANGUAGE).toBe('en');
+    });
+    it('is included in SUPPORTED_LANGUAGES', () => {
+        expect(SUPPORTED_LANGUAGES).toContain(DEFAULT_LANGUAGE);
+    });
+});
+describe('LANGUAGE_DISPLAY_NAMES', () => {
+    it('has an entry for every supported language', () => {
+        for (const lang of SUPPORTED_LANGUAGES) {
+            expect(LANGUAGE_DISPLAY_NAMES[lang]).toBeDefined();
+        }
+    });
+    it('returns native display names', () => {
+        expect(LANGUAGE_DISPLAY_NAMES['sv']).toBe('Svenska');
+        expect(LANGUAGE_DISPLAY_NAMES['de']).toBe('Deutsch');
+        expect(LANGUAGE_DISPLAY_NAMES['zh']).toBe('中文');
+    });
+});

package/dist/__tests__/create-instance.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/create-instance.test.js

@@ -0,0 +1,30 @@
+import { describe, it, expect } from 'vitest';
+import { createI18nInstance } from '../create-instance';
+import { SUPPORTED_LANGUAGES } from '../constants';
+describe('createI18nInstance', () => {
+    it('returns an i18next instance', () => {
+        const i18n = createI18nInstance({ ns: ['common'] });
+        expect(i18n).toBeDefined();
+        expect(typeof i18n.t).toBe('function');
+    });
+    it('sets fallback language to en', () => {
+        const i18n = createI18nInstance({ ns: ['common'] });
+        expect(i18n.options.fallbackLng).toEqual(['en']);
+    });
+    it('sets supported languages', () => {
+        const i18n = createI18nInstance({ ns: ['common'] });
+        expect(i18n.options.supportedLngs).toEqual([...SUPPORTED_LANGUAGES, 'cimode']);
+    });
+    it('respects explicit lng option', () => {
+        const i18n = createI18nInstance({ ns: ['common'], lng: 'sv' });
+        expect(i18n.options.lng).toBe('sv');
+    });
+    it('sets default namespace', () => {
+        const i18n = createI18nInstance({ defaultNS: 'dashboard', ns: ['common', 'dashboard'] });
+        expect(i18n.options.defaultNS).toBe('dashboard');
+    });
+    it('configures fallback namespace as common', () => {
+        const i18n = createI18nInstance({ ns: ['common'] });
+        expect(i18n.options.fallbackNS).toEqual(['common']);
+    });
+});

package/dist/__tests__/display-names.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/display-names.test.js

@@ -0,0 +1,13 @@
+import { describe, it, expect } from 'vitest';
+import { getLanguageDisplayName } from '../display-names';
+describe('getLanguageDisplayName', () => {
+    it('returns native name', () => {
+        expect(getLanguageDisplayName('sv')).toBe('Svenska');
+        expect(getLanguageDisplayName('de')).toBe('Deutsch');
+        expect(getLanguageDisplayName('zh')).toBe('中文');
+        expect(getLanguageDisplayName('en')).toBe('English');
+    });
+    it('returns English name for unknown codes', () => {
+        expect(getLanguageDisplayName('xx')).toBe('English');
+    });
+});

package/dist/__tests__/resolve-language.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/resolve-language.test.js

@@ -0,0 +1,40 @@
+import { describe, it, expect } from 'vitest';
+import { resolveLanguageFromBrowser } from '../resolve-language';
+describe('resolveLanguageFromBrowser', () => {
+    it('returns exact match for supported language', () => {
+        expect(resolveLanguageFromBrowser('en')).toBe('en');
+        expect(resolveLanguageFromBrowser('sv')).toBe('sv');
+        expect(resolveLanguageFromBrowser('fr')).toBe('fr');
+    });
+    it('maps regional variants to base language', () => {
+        expect(resolveLanguageFromBrowser('fr-CA')).toBe('fr');
+        expect(resolveLanguageFromBrowser('de-AT')).toBe('de');
+        expect(resolveLanguageFromBrowser('de-CH')).toBe('de');
+        expect(resolveLanguageFromBrowser('es-MX')).toBe('es');
+        expect(resolveLanguageFromBrowser('es-AR')).toBe('es');
+    });
+    it('maps all Chinese variants to zh', () => {
+        expect(resolveLanguageFromBrowser('zh')).toBe('zh');
+        expect(resolveLanguageFromBrowser('zh-CN')).toBe('zh');
+        expect(resolveLanguageFromBrowser('zh-TW')).toBe('zh');
+        expect(resolveLanguageFromBrowser('zh-Hans')).toBe('zh');
+        expect(resolveLanguageFromBrowser('zh-Hant')).toBe('zh');
+        expect(resolveLanguageFromBrowser('zh-Hans-CN')).toBe('zh');
+    });
+    it('returns en for unsupported languages', () => {
+        expect(resolveLanguageFromBrowser('ja')).toBe('en');
+        expect(resolveLanguageFromBrowser('ko')).toBe('en');
+        expect(resolveLanguageFromBrowser('ar')).toBe('en');
+        expect(resolveLanguageFromBrowser('pt-BR')).toBe('en');
+    });
+    it('handles empty, null, and undefined input', () => {
+        expect(resolveLanguageFromBrowser('')).toBe('en');
+        expect(resolveLanguageFromBrowser(null)).toBe('en');
+        expect(resolveLanguageFromBrowser(undefined)).toBe('en');
+    });
+    it('is case-insensitive', () => {
+        expect(resolveLanguageFromBrowser('EN')).toBe('en');
+        expect(resolveLanguageFromBrowser('Fr-ca')).toBe('fr');
+        expect(resolveLanguageFromBrowser('ZH-HANS')).toBe('zh');
+    });
+});

package/dist/constants.d.ts

@@ -0,0 +1,4 @@
+export declare const SUPPORTED_LANGUAGES: readonly ["en", "zh", "fr", "de", "it", "es", "sv"];
+export declare const DEFAULT_LANGUAGE: "en";
+export type SupportedLanguage = (typeof SUPPORTED_LANGUAGES)[number];
+export declare const LANGUAGE_DISPLAY_NAMES: Record<SupportedLanguage, string>;

package/dist/constants.js

@@ -0,0 +1,13 @@
+export const SUPPORTED_LANGUAGES = [
+    'en', 'zh', 'fr', 'de', 'it', 'es', 'sv',
+];
+export const DEFAULT_LANGUAGE = 'en';
+export const LANGUAGE_DISPLAY_NAMES = {
+    en: 'English',
+    zh: '中文',
+    fr: 'Français',
+    de: 'Deutsch',
+    it: 'Italiano',
+    es: 'Español',
+    sv: 'Svenska',
+};

package/dist/create-instance.d.ts

@@ -0,0 +1,12 @@
+import { type i18n } from 'i18next';
+import type { I18nInstanceOptions } from './types';
+/**
+ * Creates and initializes an i18next instance.
+ * Each frontend project calls this once in src/lib/i18n.ts.
+ *
+ * NOTE: init() is called on the instance but translation loading is async.
+ * Options (fallbackLng, supportedLngs, etc.) are set immediately.
+ * Translations load in the background via i18next-http-backend.
+ * react-i18next handles the loading state via its `ready` prop / Suspense.
+ */
+export declare function createI18nInstance(options: I18nInstanceOptions): i18n;

package/dist/create-instance.js

@@ -0,0 +1,44 @@
+import i18next from 'i18next';
+import HttpBackend from 'i18next-http-backend';
+import LanguageDetector from 'i18next-browser-languagedetector';
+import { SUPPORTED_LANGUAGES, DEFAULT_LANGUAGE } from './constants';
+/**
+ * Creates and initializes an i18next instance.
+ * Each frontend project calls this once in src/lib/i18n.ts.
+ *
+ * NOTE: init() is called on the instance but translation loading is async.
+ * Options (fallbackLng, supportedLngs, etc.) are set immediately.
+ * Translations load in the background via i18next-http-backend.
+ * react-i18next handles the loading state via its `ready` prop / Suspense.
+ */
+export function createI18nInstance(options) {
+    const { defaultNS = 'common', ns = ['common'], loadPath = '/locales/{{lng}}/{{ns}}.json', lng, debug = false, } = options;
+    const instance = i18next.createInstance();
+    instance
+        .use(HttpBackend)
+        .use(LanguageDetector)
+        .init({
+        lng,
+        fallbackLng: [DEFAULT_LANGUAGE],
+        supportedLngs: [...SUPPORTED_LANGUAGES],
+        defaultNS,
+        ns,
+        fallbackNS: 'common',
+        debug,
+        interpolation: {
+            escapeValue: false, // React already escapes
+        },
+        detection: {
+            order: ['localStorage', 'navigator'],
+            lookupLocalStorage: 'cellarnode-language',
+            caches: ['localStorage'],
+        },
+        backend: {
+            loadPath,
+        },
+        react: {
+            useSuspense: false,
+        },
+    });
+    return instance;
+}

package/dist/display-names.d.ts

@@ -0,0 +1,6 @@
+import { type SupportedLanguage } from './constants';
+/**
+ * Returns the native display name for a language code.
+ * e.g., "Svenska" for sv, "Deutsch" for de.
+ */
+export declare function getLanguageDisplayName(lang: SupportedLanguage): string;

package/dist/display-names.js

@@ -0,0 +1,8 @@
+import { LANGUAGE_DISPLAY_NAMES, DEFAULT_LANGUAGE } from './constants';
+/**
+ * Returns the native display name for a language code.
+ * e.g., "Svenska" for sv, "Deutsch" for de.
+ */
+export function getLanguageDisplayName(lang) {
+    return LANGUAGE_DISPLAY_NAMES[lang] ?? LANGUAGE_DISPLAY_NAMES[DEFAULT_LANGUAGE];
+}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { SUPPORTED_LANGUAGES, DEFAULT_LANGUAGE, LANGUAGE_DISPLAY_NAMES, type SupportedLanguage, } from './constants';
+export type { TranslationNamespace, I18nInstanceOptions } from './types';
+export { resolveLanguageFromBrowser } from './resolve-language';
+export { createI18nInstance } from './create-instance';
+export { getLanguageDisplayName } from './display-names';

package/dist/index.js

@@ -0,0 +1,4 @@
+export { SUPPORTED_LANGUAGES, DEFAULT_LANGUAGE, LANGUAGE_DISPLAY_NAMES, } from './constants';
+export { resolveLanguageFromBrowser } from './resolve-language';
+export { createI18nInstance } from './create-instance';
+export { getLanguageDisplayName } from './display-names';

package/dist/resolve-language.d.ts

@@ -0,0 +1,7 @@
+import { type SupportedLanguage } from './constants';
+/**
+ * Maps a browser navigator.language string to a supported CellarNode language.
+ * Handles regional variants (fr-CA -> fr), Chinese scripts (zh-Hans -> zh),
+ * and unsupported languages (ja -> en).
+ */
+export declare function resolveLanguageFromBrowser(navigatorLanguage: string): SupportedLanguage;

package/dist/resolve-language.js

@@ -0,0 +1,23 @@
+import { SUPPORTED_LANGUAGES, DEFAULT_LANGUAGE } from './constants';
+const supportedSet = new Set(SUPPORTED_LANGUAGES);
+/**
+ * Maps a browser navigator.language string to a supported CellarNode language.
+ * Handles regional variants (fr-CA -> fr), Chinese scripts (zh-Hans -> zh),
+ * and unsupported languages (ja -> en).
+ */
+export function resolveLanguageFromBrowser(navigatorLanguage) {
+    if (!navigatorLanguage || typeof navigatorLanguage !== 'string') {
+        return DEFAULT_LANGUAGE;
+    }
+    const normalized = navigatorLanguage.toLowerCase().trim();
+    // Exact match
+    if (supportedSet.has(normalized)) {
+        return normalized;
+    }
+    // Extract base language (first segment before hyphen)
+    const base = normalized.split('-')[0];
+    if (supportedSet.has(base)) {
+        return base;
+    }
+    return DEFAULT_LANGUAGE;
+}

package/dist/scripts/copy-common.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/scripts/copy-common.js

@@ -0,0 +1,20 @@
+import { cpSync, mkdirSync, existsSync, readdirSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { createRequire } from 'node:module';
+// Resolve the locales directory relative to the installed package,
+// NOT relative to import.meta.url (which is wrong when run via `node -e`)
+const require = createRequire(import.meta.url);
+const pkgDir = dirname(require.resolve('@cellarnode/i18n/package.json'));
+const localesSource = join(pkgDir, 'locales');
+const targetDir = join(process.cwd(), 'public', 'locales');
+const languages = readdirSync(localesSource).filter((f) => !f.startsWith('.'));
+for (const lang of languages) {
+    const src = join(localesSource, lang, 'common.json');
+    const dest = join(targetDir, lang, 'common.json');
+    if (existsSync(src)) {
+        mkdirSync(dirname(dest), { recursive: true });
+        cpSync(src, dest);
+        console.log(`Copied common.json -> ${lang}`);
+    }
+}
+console.log(`Done. Copied ${languages.length} locale files.`);

package/dist/types.d.ts

@@ -0,0 +1,14 @@
+import type { SupportedLanguage } from './constants';
+export type TranslationNamespace = string;
+export interface I18nInstanceOptions {
+    /** Default namespace to use */
+    defaultNS?: string;
+    /** Namespaces to load */
+    ns?: string[];
+    /** Path template for loading translations. Use {{lng}} and {{ns}} placeholders. */
+    loadPath?: string;
+    /** Initial language (overrides detection) */
+    lng?: SupportedLanguage;
+    /** Enable debug logging */
+    debug?: boolean;
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/locales/de/common.json

@@ -0,0 +1,56 @@
+{
+  "save": "Save",
+  "cancel": "Cancel",
+  "delete": "Delete",
+  "edit": "Edit",
+  "create": "Create",
+  "confirm": "Confirm",
+  "close": "Close",
+  "back": "Back",
+  "next": "Next",
+  "submit": "Submit",
+  "loading": "Loading...",
+  "error": "Error",
+  "success": "Success",
+  "warning": "Warning",
+  "search": "Search",
+  "filter": "Filter",
+  "sort": "Sort",
+  "refresh": "Refresh",
+  "retry": "Retry",
+  "yes": "Yes",
+  "no": "No",
+  "ok": "OK",
+  "noResults": "No results found",
+  "required": "This field is required",
+  "invalidEmail": "Please enter a valid email",
+  "somethingWentWrong": "Something went wrong",
+  "tryAgain": "Please try again",
+  "unsavedChanges": "You have unsaved changes",
+  "areYouSure": "Are you sure?",
+  "copiedToClipboard": "Copied to clipboard",
+  "actions": "Actions",
+  "status": "Status",
+  "name": "Name",
+  "description": "Description",
+  "date": "Date",
+  "type": "Type",
+  "viewAll": "View all",
+  "showMore": "Show more",
+  "showLess": "Show less",
+  "selectAll": "Select all",
+  "deselectAll": "Deselect all",
+  "pagination": {
+    "previous": "Previous",
+    "next": "Next",
+    "page": "Page {{current}} of {{total}}",
+    "showing": "Showing {{from}}-{{to}} of {{total}}"
+  },
+  "validation": {
+    "required": "This field is required",
+    "minLength": "Must be at least {{min}} characters",
+    "maxLength": "Must be at most {{max}} characters",
+    "positiveNumber": "Must be a positive number",
+    "invalidFormat": "Invalid format"
+  }
+}

package/locales/en/common.json

@@ -0,0 +1,56 @@
+{
+  "save": "Save",
+  "cancel": "Cancel",
+  "delete": "Delete",
+  "edit": "Edit",
+  "create": "Create",
+  "confirm": "Confirm",
+  "close": "Close",
+  "back": "Back",
+  "next": "Next",
+  "submit": "Submit",
+  "loading": "Loading...",
+  "error": "Error",
+  "success": "Success",
+  "warning": "Warning",
+  "search": "Search",
+  "filter": "Filter",
+  "sort": "Sort",
+  "refresh": "Refresh",
+  "retry": "Retry",
+  "yes": "Yes",
+  "no": "No",
+  "ok": "OK",
+  "noResults": "No results found",
+  "required": "This field is required",
+  "invalidEmail": "Please enter a valid email",
+  "somethingWentWrong": "Something went wrong",
+  "tryAgain": "Please try again",
+  "unsavedChanges": "You have unsaved changes",
+  "areYouSure": "Are you sure?",
+  "copiedToClipboard": "Copied to clipboard",
+  "actions": "Actions",
+  "status": "Status",
+  "name": "Name",
+  "description": "Description",
+  "date": "Date",
+  "type": "Type",
+  "viewAll": "View all",
+  "showMore": "Show more",
+  "showLess": "Show less",
+  "selectAll": "Select all",
+  "deselectAll": "Deselect all",
+  "pagination": {
+    "previous": "Previous",
+    "next": "Next",
+    "page": "Page {{current}} of {{total}}",
+    "showing": "Showing {{from}}-{{to}} of {{total}}"
+  },
+  "validation": {
+    "required": "This field is required",
+    "minLength": "Must be at least {{min}} characters",
+    "maxLength": "Must be at most {{max}} characters",
+    "positiveNumber": "Must be a positive number",
+    "invalidFormat": "Invalid format"
+  }
+}

package/locales/es/common.json

@@ -0,0 +1,56 @@
+{
+  "save": "Save",
+  "cancel": "Cancel",
+  "delete": "Delete",
+  "edit": "Edit",
+  "create": "Create",
+  "confirm": "Confirm",
+  "close": "Close",
+  "back": "Back",
+  "next": "Next",
+  "submit": "Submit",
+  "loading": "Loading...",
+  "error": "Error",
+  "success": "Success",
+  "warning": "Warning",
+  "search": "Search",
+  "filter": "Filter",
+  "sort": "Sort",
+  "refresh": "Refresh",
+  "retry": "Retry",
+  "yes": "Yes",
+  "no": "No",
+  "ok": "OK",
+  "noResults": "No results found",
+  "required": "This field is required",
+  "invalidEmail": "Please enter a valid email",
+  "somethingWentWrong": "Something went wrong",
+  "tryAgain": "Please try again",
+  "unsavedChanges": "You have unsaved changes",
+  "areYouSure": "Are you sure?",
+  "copiedToClipboard": "Copied to clipboard",
+  "actions": "Actions",
+  "status": "Status",
+  "name": "Name",
+  "description": "Description",
+  "date": "Date",
+  "type": "Type",
+  "viewAll": "View all",
+  "showMore": "Show more",
+  "showLess": "Show less",
+  "selectAll": "Select all",
+  "deselectAll": "Deselect all",
+  "pagination": {
+    "previous": "Previous",
+    "next": "Next",
+    "page": "Page {{current}} of {{total}}",
+    "showing": "Showing {{from}}-{{to}} of {{total}}"
+  },
+  "validation": {
+    "required": "This field is required",
+    "minLength": "Must be at least {{min}} characters",
+    "maxLength": "Must be at most {{max}} characters",
+    "positiveNumber": "Must be a positive number",
+    "invalidFormat": "Invalid format"
+  }
+}

package/locales/fr/common.json

@@ -0,0 +1,56 @@
+{
+  "save": "Save",
+  "cancel": "Cancel",
+  "delete": "Delete",
+  "edit": "Edit",
+  "create": "Create",
+  "confirm": "Confirm",
+  "close": "Close",
+  "back": "Back",
+  "next": "Next",
+  "submit": "Submit",
+  "loading": "Loading...",
+  "error": "Error",
+  "success": "Success",
+  "warning": "Warning",
+  "search": "Search",
+  "filter": "Filter",
+  "sort": "Sort",
+  "refresh": "Refresh",
+  "retry": "Retry",
+  "yes": "Yes",
+  "no": "No",
+  "ok": "OK",
+  "noResults": "No results found",
+  "required": "This field is required",
+  "invalidEmail": "Please enter a valid email",
+  "somethingWentWrong": "Something went wrong",
+  "tryAgain": "Please try again",
+  "unsavedChanges": "You have unsaved changes",
+  "areYouSure": "Are you sure?",
+  "copiedToClipboard": "Copied to clipboard",
+  "actions": "Actions",
+  "status": "Status",
+  "name": "Name",
+  "description": "Description",
+  "date": "Date",
+  "type": "Type",
+  "viewAll": "View all",
+  "showMore": "Show more",
+  "showLess": "Show less",
+  "selectAll": "Select all",
+  "deselectAll": "Deselect all",
+  "pagination": {
+    "previous": "Previous",
+    "next": "Next",
+    "page": "Page {{current}} of {{total}}",
+    "showing": "Showing {{from}}-{{to}} of {{total}}"
+  },
+  "validation": {
+    "required": "This field is required",
+    "minLength": "Must be at least {{min}} characters",
+    "maxLength": "Must be at most {{max}} characters",
+    "positiveNumber": "Must be a positive number",
+    "invalidFormat": "Invalid format"
+  }
+}

package/locales/it/common.json

@@ -0,0 +1,56 @@
+{
+  "save": "Save",
+  "cancel": "Cancel",
+  "delete": "Delete",
+  "edit": "Edit",
+  "create": "Create",
+  "confirm": "Confirm",
+  "close": "Close",
+  "back": "Back",
+  "next": "Next",
+  "submit": "Submit",
+  "loading": "Loading...",
+  "error": "Error",
+  "success": "Success",
+  "warning": "Warning",
+  "search": "Search",
+  "filter": "Filter",
+  "sort": "Sort",
+  "refresh": "Refresh",
+  "retry": "Retry",
+  "yes": "Yes",
+  "no": "No",
+  "ok": "OK",
+  "noResults": "No results found",
+  "required": "This field is required",
+  "invalidEmail": "Please enter a valid email",
+  "somethingWentWrong": "Something went wrong",
+  "tryAgain": "Please try again",
+  "unsavedChanges": "You have unsaved changes",
+  "areYouSure": "Are you sure?",
+  "copiedToClipboard": "Copied to clipboard",
+  "actions": "Actions",
+  "status": "Status",
+  "name": "Name",
+  "description": "Description",
+  "date": "Date",
+  "type": "Type",
+  "viewAll": "View all",
+  "showMore": "Show more",
+  "showLess": "Show less",
+  "selectAll": "Select all",
+  "deselectAll": "Deselect all",
+  "pagination": {
+    "previous": "Previous",
+    "next": "Next",
+    "page": "Page {{current}} of {{total}}",
+    "showing": "Showing {{from}}-{{to}} of {{total}}"
+  },
+  "validation": {
+    "required": "This field is required",
+    "minLength": "Must be at least {{min}} characters",
+    "maxLength": "Must be at most {{max}} characters",
+    "positiveNumber": "Must be a positive number",
+    "invalidFormat": "Invalid format"
+  }
+}

package/locales/sv/common.json

@@ -0,0 +1,56 @@
+{
+  "save": "Save",
+  "cancel": "Cancel",
+  "delete": "Delete",
+  "edit": "Edit",
+  "create": "Create",
+  "confirm": "Confirm",
+  "close": "Close",
+  "back": "Back",
+  "next": "Next",
+  "submit": "Submit",
+  "loading": "Loading...",
+  "error": "Error",
+  "success": "Success",
+  "warning": "Warning",
+  "search": "Search",
+  "filter": "Filter",
+  "sort": "Sort",
+  "refresh": "Refresh",
+  "retry": "Retry",
+  "yes": "Yes",
+  "no": "No",
+  "ok": "OK",
+  "noResults": "No results found",
+  "required": "This field is required",
+  "invalidEmail": "Please enter a valid email",
+  "somethingWentWrong": "Something went wrong",
+  "tryAgain": "Please try again",
+  "unsavedChanges": "You have unsaved changes",
+  "areYouSure": "Are you sure?",
+  "copiedToClipboard": "Copied to clipboard",
+  "actions": "Actions",
+  "status": "Status",
+  "name": "Name",
+  "description": "Description",
+  "date": "Date",
+  "type": "Type",
+  "viewAll": "View all",
+  "showMore": "Show more",
+  "showLess": "Show less",
+  "selectAll": "Select all",
+  "deselectAll": "Deselect all",
+  "pagination": {
+    "previous": "Previous",
+    "next": "Next",
+    "page": "Page {{current}} of {{total}}",
+    "showing": "Showing {{from}}-{{to}} of {{total}}"
+  },
+  "validation": {
+    "required": "This field is required",
+    "minLength": "Must be at least {{min}} characters",
+    "maxLength": "Must be at most {{max}} characters",
+    "positiveNumber": "Must be a positive number",
+    "invalidFormat": "Invalid format"
+  }
+}

package/locales/zh/common.json

@@ -0,0 +1,56 @@
+{
+  "save": "Save",
+  "cancel": "Cancel",
+  "delete": "Delete",
+  "edit": "Edit",
+  "create": "Create",
+  "confirm": "Confirm",
+  "close": "Close",
+  "back": "Back",
+  "next": "Next",
+  "submit": "Submit",
+  "loading": "Loading...",
+  "error": "Error",
+  "success": "Success",
+  "warning": "Warning",
+  "search": "Search",
+  "filter": "Filter",
+  "sort": "Sort",
+  "refresh": "Refresh",
+  "retry": "Retry",
+  "yes": "Yes",
+  "no": "No",
+  "ok": "OK",
+  "noResults": "No results found",
+  "required": "This field is required",
+  "invalidEmail": "Please enter a valid email",
+  "somethingWentWrong": "Something went wrong",
+  "tryAgain": "Please try again",
+  "unsavedChanges": "You have unsaved changes",
+  "areYouSure": "Are you sure?",
+  "copiedToClipboard": "Copied to clipboard",
+  "actions": "Actions",
+  "status": "Status",
+  "name": "Name",
+  "description": "Description",
+  "date": "Date",
+  "type": "Type",
+  "viewAll": "View all",
+  "showMore": "Show more",
+  "showLess": "Show less",
+  "selectAll": "Select all",
+  "deselectAll": "Deselect all",
+  "pagination": {
+    "previous": "Previous",
+    "next": "Next",
+    "page": "Page {{current}} of {{total}}",
+    "showing": "Showing {{from}}-{{to}} of {{total}}"
+  },
+  "validation": {
+    "required": "This field is required",
+    "minLength": "Must be at least {{min}} characters",
+    "maxLength": "Must be at most {{max}} characters",
+    "positiveNumber": "Must be a positive number",
+    "invalidFormat": "Invalid format"
+  }
+}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@cellarnode/i18n",
+  "version": "0.1.0",
+  "description": "Shared i18n configuration for CellarNode frontends — language constants, i18next factory, browser locale detection, and common translations.",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/CellarNode/i18n.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./locales/*": "./locales/*",
+    "./scripts/copy-common": "./dist/scripts/copy-common.js"
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "locales"
+  ],
+  "keywords": [
+    "cellarnode",
+    "i18n",
+    "i18next",
+    "internationalization",
+    "localization"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "pnpm build"
+  },
+  "dependencies": {
+    "i18next": "^24.0.0",
+    "i18next-browser-languagedetector": "^8.0.0",
+    "i18next-http-backend": "^3.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "typescript": "^5.8.0",
+    "vitest": "^3.0.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}