@hazeljs/i18n 0.2.0-beta.57

package/dist/translation.loader.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translation.loader.test.d.ts","sourceRoot":"","sources":["../src/translation.loader.test.ts"],"names":[],"mappings":""}

package/dist/translation.loader.test.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const translation_loader_1 = require("./translation.loader");
+jest.mock('fs/promises', () => ({
+    readdir: jest.fn(),
+    readFile: jest.fn(),
+}));
+const promises_1 = require("fs/promises");
+const mockReaddir = promises_1.readdir;
+const mockReadFile = promises_1.readFile;
+describe('TranslationLoader', () => {
+    beforeEach(() => {
+        jest.clearAllMocks();
+    });
+    describe('load()', () => {
+        it('returns an empty store when directory does not exist', async () => {
+            mockReaddir.mockRejectedValue(Object.assign(new Error('ENOENT'), { code: 'ENOENT' }));
+            const store = await translation_loader_1.TranslationLoader.load('/nonexistent/path');
+            expect(store.size).toBe(0);
+        });
+        it('returns an empty store when directory is empty', async () => {
+            mockReaddir.mockResolvedValue([]);
+            const store = await translation_loader_1.TranslationLoader.load('/empty/dir');
+            expect(store.size).toBe(0);
+        });
+        it('ignores non-JSON files', async () => {
+            mockReaddir.mockResolvedValue(['README.md', 'notes.txt']);
+            const store = await translation_loader_1.TranslationLoader.load('/some/dir');
+            expect(store.size).toBe(0);
+            expect(mockReadFile).not.toHaveBeenCalled();
+        });
+        it('loads a single JSON file and stores translations by locale', async () => {
+            mockReaddir.mockResolvedValue(['en.json']);
+            mockReadFile.mockResolvedValue('{"hello":"Hello","bye":"Goodbye"}');
+            const store = await translation_loader_1.TranslationLoader.load('/translations');
+            expect(store.has('en')).toBe(true);
+            expect(store.get('en')).toEqual({ hello: 'Hello', bye: 'Goodbye' });
+        });
+        it('loads multiple JSON files into separate locale entries', async () => {
+            mockReaddir.mockResolvedValue(['en.json', 'fr.json']);
+            mockReadFile
+                .mockResolvedValueOnce('{"hello":"Hello"}')
+                .mockResolvedValueOnce('{"hello":"Bonjour"}');
+            const store = await translation_loader_1.TranslationLoader.load('/translations');
+            expect(store.size).toBe(2);
+            expect(store.get('en')).toEqual({ hello: 'Hello' });
+            expect(store.get('fr')).toEqual({ hello: 'Bonjour' });
+        });
+        it('handles locale codes with hyphens (zh-TW.json)', async () => {
+            mockReaddir.mockResolvedValue(['zh-TW.json']);
+            mockReadFile.mockResolvedValue('{"greeting":"你好"}');
+            const store = await translation_loader_1.TranslationLoader.load('/translations');
+            expect(store.has('zh-TW')).toBe(true);
+        });
+        it('skips malformed JSON files and writes to stderr', async () => {
+            const stderrSpy = jest.spyOn(process.stderr, 'write').mockImplementation(() => true);
+            mockReaddir.mockResolvedValue(['en.json', 'bad.json']);
+            mockReadFile
+                .mockResolvedValueOnce('{"ok":true}')
+                .mockResolvedValueOnce('{ invalid json');
+            const store = await translation_loader_1.TranslationLoader.load('/translations');
+            expect(store.has('en')).toBe(true);
+            expect(store.has('bad')).toBe(false);
+            expect(stderrSpy).toHaveBeenCalledWith(expect.stringContaining('[@hazeljs/i18n]'));
+            stderrSpy.mockRestore();
+        });
+        it('writes non-Error exception to stderr as string', async () => {
+            const stderrSpy = jest.spyOn(process.stderr, 'write').mockImplementation(() => true);
+            mockReaddir.mockResolvedValue(['broken.json']);
+            mockReadFile.mockRejectedValue('string error');
+            const store = await translation_loader_1.TranslationLoader.load('/translations');
+            expect(store.has('broken')).toBe(false);
+            expect(stderrSpy).toHaveBeenCalledWith(expect.stringContaining('string error'));
+            stderrSpy.mockRestore();
+        });
+        it('loads nested translation objects', async () => {
+            mockReaddir.mockResolvedValue(['en.json']);
+            mockReadFile.mockResolvedValue(JSON.stringify({ errors: { notFound: 'Not found', invalid: 'Invalid' } }));
+            const store = await translation_loader_1.TranslationLoader.load('/translations');
+            expect(store.get('en')).toEqual({
+                errors: { notFound: 'Not found', invalid: 'Invalid' },
+            });
+        });
+    });
+});

package/dist/types.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Supported locale detection strategies, in order of priority.
+ */
+export type LocaleDetectionStrategy = 'query' | 'cookie' | 'header';
+/**
+ * A flat or nested map of translation keys to values.
+ * Nested objects represent namespaced keys (e.g. "errors.notFound").
+ * Leaf values are translation strings, which may contain {placeholder} tokens
+ * and optional plural forms via a "one"/"other" sub-object.
+ */
+export type TranslationValue = string | {
+    one: string;
+    other: string;
+    [form: string]: string;
+} | {
+    [key: string]: TranslationValue;
+};
+export type TranslationMap = Record<string, TranslationValue>;
+/**
+ * In-memory store: locale → flat translation map.
+ */
+export type LocaleStore = Map<string, TranslationMap>;
+/**
+ * Options for interpolating variables and selecting plural forms.
+ */
+export interface TranslateOptions {
+    /**
+     * Used for plural rule selection.
+     */
+    count?: number;
+    /**
+     * Key-value pairs substituted into {placeholder} tokens.
+     */
+    vars?: Record<string, string | number>;
+    /**
+     * Override the locale for this single call.
+     */
+    locale?: string;
+}
+/**
+ * Configuration options for I18nModule.forRoot().
+ */
+export interface I18nOptions {
+    /**
+     * The locale used when no locale can be detected.
+     * @default 'en'
+     */
+    defaultLocale?: string;
+    /**
+     * The locale to fall back to when a key is missing in the requested locale.
+     * @default same as defaultLocale
+     */
+    fallbackLocale?: string;
+    /**
+     * Absolute or relative path to the directory containing JSON translation files.
+     * Files must be named <locale>.json (e.g. en.json, fr.json).
+     * @default './translations'
+     */
+    translationsPath?: string;
+    /**
+     * Ordered list of locale-detection strategies to apply per request.
+     * @default ['query', 'cookie', 'header']
+     */
+    detection?: LocaleDetectionStrategy[];
+    /**
+     * Name of the query-string parameter to check.
+     * @default 'lang'
+     */
+    queryParam?: string;
+    /**
+     * Name of the cookie to check.
+     * @default 'locale'
+     */
+    cookieName?: string;
+    /**
+     * Whether to register this module globally so it does not need to be
+     * imported in every feature module.
+     * @default true
+     */
+    isGlobal?: boolean;
+}
+/**
+ * Fully resolved options with all defaults applied.
+ */
+export type ResolvedI18nOptions = Required<I18nOptions>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEpE;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GACtD;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAAA;CAAE,CAAC;AAExC,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IAEvC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,SAAS,CAAC,EAAE,uBAAuB,EAAE,CAAC;IAEtC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@hazeljs/i18n",
+  "version": "0.2.0-beta.57",
+  "description": "Internationalization (i18n) module for HazelJS framework",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "jest --coverage",
+    "lint": "eslint \"src/**/*.ts\"",
+    "lint:fix": "eslint \"src/**/*.ts\" --fix",
+    "clean": "rm -rf dist"
+  },
+  "devDependencies": {
+    "@types/node": "^20.17.50",
+    "@typescript-eslint/eslint-plugin": "^8.18.2",
+    "@typescript-eslint/parser": "^8.18.2",
+    "eslint": "^8.56.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.2",
+    "typescript": "^5.3.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hazel-js/hazeljs.git",
+    "directory": "packages/i18n"
+  },
+  "keywords": [
+    "hazeljs",
+    "i18n",
+    "internationalization",
+    "localization",
+    "translation"
+  ],
+  "author": "Muhammad Arslan <muhammad.arslan@hazeljs.com>",
+  "license": "Apache-2.0",
+  "bugs": {
+    "url": "https://github.com/hazeljs/hazel-js/issues"
+  },
+  "homepage": "https://hazeljs.com",
+  "peerDependencies": {
+    "@hazeljs/core": ">=0.2.0-beta.0"
+  },
+  "gitHead": "98c84683e8f487c660e344c2beda3a8dcaaff07f"
+}