@owlmeans/i18n 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 OwlMeans Common — Fullstack typescript framework
+
+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,323 @@
+# OwlMeans I18n — Common Library
+
+**@owlmeans/i18n** is a core implementation of the OwlMeans Common Internationalization Subsystem. It provides a flexible, multi-level translation system designed to work across different application contexts with namespace-based organization and priority-based resource loading.
+
+## Installation
+
+```bash
+npm install @owlmeans/i18n
+```
+
+## Core Concepts
+
+### Translation Levels
+The i18n system supports three levels of translations with different priorities:
+- **Library Level**: Lowest priority, used for basic library translations
+- **App Level**: Medium priority, used for application-specific translations  
+- **Service Level**: Highest priority, used for service-specific overrides
+
+### Namespaces
+Translations are organized into namespaces to avoid conflicts:
+- `translation` - Default namespace for general translations
+- `lib` - Library-specific translations
+- `service` - Service-specific translations
+- Custom namespaces can be defined as needed
+
+### Resources
+Each translation resource represents a collection of translations for a specific language and context, with optional priority settings for ordering.
+
+## API Reference
+
+### Types
+
+#### `I18nStorage`
+Main storage interface for the i18n system.
+```typescript
+interface I18nStorage {
+  data: I18nNamespaces
+}
+```
+
+#### `I18nNamespaces`
+Collection of namespaces, each containing resources.
+```typescript
+interface I18nNamespaces extends Record<string, I18nResources> { }
+```
+
+#### `I18nResources`
+Collection of resources within a namespace.
+```typescript
+interface I18nResources extends Record<string, I18nLanguages> { }
+```
+
+#### `I18nLanguages`
+Language-specific data containing resources and initialization status.
+```typescript
+interface I18nLanguages extends Record<string, {
+  resources: I18nResource[],
+  lngInitialized: string[]
+}> { }
+```
+
+#### `I18nResource`
+Individual translation resource with metadata.
+```typescript
+interface I18nResource {
+  ns?: string          // Namespace (optional)
+  lng?: string         // Language code (optional)
+  level: I18nLevel     // Translation level
+  resource: string     // Resource identifier
+  priority?: number    // Priority for ordering (optional)
+  data: Record<string, any>  // Translation data
+}
+```
+
+#### `I18nResourceOptions`
+Options for resource operations.
+```typescript
+interface I18nResourceOptions {
+  priroty?: number     // Priority for resource ordering (note: typo in source)
+  ns?: string          // Namespace override
+}
+```
+
+#### `I18nConfig`
+Configuration interface for the i18n system.
+```typescript
+interface I18nConfig {
+  defaultLng?: string  // Default language code
+  defaultNs?: string   // Default namespace
+}
+```
+
+#### `I18nLevel`
+Enumeration of translation levels.
+```typescript
+enum I18nLevel {
+  Library = 'library',
+  App = 'app', 
+  Service = 'service'
+}
+```
+
+### Functions
+
+#### `addI18nLib(lng, resource, data, opts?)`
+Add library-level translations.
+```typescript
+function addI18nLib(
+  lng: string,                              // Language code
+  resource: string,                         // Resource identifier
+  data: Record<string, any>,                // Translation data
+  opts?: I18nResourceOptions | string       // Options or namespace
+): void
+```
+
+**Example:**
+```typescript
+import { addI18nLib } from '@owlmeans/i18n'
+
+addI18nLib('en', 'common', {
+  'button.save': 'Save',
+  'button.cancel': 'Cancel'
+})
+```
+
+#### `addI18nApp(lng, resource, data, opts?)`
+Add application-level translations.
+```typescript
+function addI18nApp(
+  lng: string,                              // Language code
+  resource: string,                         // Resource identifier  
+  data: Record<string, any>,                // Translation data
+  opts?: I18nResourceOptions | string       // Options or namespace
+): void
+```
+
+**Example:**
+```typescript
+import { addI18nApp } from '@owlmeans/i18n'
+
+addI18nApp('en', 'user-profile', {
+  'title': 'User Profile',
+  'form.username': 'Username',
+  'form.email': 'Email Address'
+})
+```
+
+#### `addCommonI18n(lng, resource, data, opts?)`
+Add service-level translations (highest priority).
+```typescript
+function addCommonI18n(
+  lng: string,                              // Language code
+  resource: string,                         // Resource identifier
+  data: Record<string, any>,                // Translation data  
+  opts?: I18nResourceOptions | string       // Options or namespace
+): void
+```
+
+**Example:**
+```typescript
+import { addCommonI18n } from '@owlmeans/i18n'
+
+addCommonI18n('en', 'api-messages', {
+  'error.unauthorized': 'Access denied',
+  'error.notfound': 'Resource not found'
+})
+```
+
+#### `initI18nResource(lng, resource, ns?)`
+Initialize translation resources for a specific language and resource.
+```typescript
+function initI18nResource(
+  lng: string,                              // Language code
+  resource: string,                         // Resource identifier
+  ns?: string                               // Namespace (optional)
+): null | I18nResource[]
+```
+
+Returns `null` if the resource is already initialized, or an array of `I18nResource` objects sorted by level and priority.
+
+**Example:**
+```typescript
+import { initI18nResource } from '@owlmeans/i18n'
+
+const resources = initI18nResource('en', 'common')
+if (resources) {
+  // Process initialized resources
+  resources.forEach(resource => {
+    console.log(`Loading ${resource.level} level translations:`, resource.data)
+  })
+}
+```
+
+### Constants
+
+#### `DEFAULT_NAMESPACE`
+Default namespace for translations.
+```typescript
+const DEFAULT_NAMESPACE = 'translation'
+```
+
+#### `LIB_NAMESPACE`
+Namespace for library translations.
+```typescript
+const LIB_NAMESPACE = 'lib'
+```
+
+#### `SRV_NAMESPACE`
+Namespace for service translations.
+```typescript
+const SRV_NAMESPACE = 'service'
+```
+
+#### `DEFAULT_LNG`
+Default language code.
+```typescript
+const DEFAULT_LNG = 'en'
+```
+
+#### `MAX_PRIORITY`
+Maximum priority value for resource ordering.
+```typescript
+const MAX_PRIORITY = Number.MAX_SAFE_INTEGER
+```
+
+### Utils
+
+The package also exports utility functions under the `/utils` subpackage:
+
+```typescript
+import { ensureStructure, levelCost } from '@owlmeans/i18n/utils'
+```
+
+#### `ensureStructure(lng, resource, ns?)`
+Ensures the storage structure exists for the given language, resource, and namespace.
+```typescript
+function ensureStructure(
+  lng: string,                              // Language code
+  resource: string,                         // Resource identifier
+  ns?: string                               // Namespace (optional)
+): I18nLanguages[string]
+```
+
+#### `levelCost`
+Mapping of translation levels to their priority costs:
+```typescript
+const levelCost = {
+  [I18nLevel.Library]: 0,
+  [I18nLevel.App]: 1,
+  [I18nLevel.Service]: 2
+}
+```
+
+#### `_OwlMeansI18nStorage`
+Internal storage instance (use with caution):
+```typescript
+const _OwlMeansI18nStorage: I18nStorage
+```
+
+> **Note:** This is an internal storage variable. Direct manipulation is not recommended for normal usage.
+
+## Usage Examples
+
+### Basic Usage
+```typescript
+import { addI18nLib, addI18nApp, initI18nResource } from '@owlmeans/i18n'
+
+// Add library translations
+addI18nLib('en', 'common', {
+  'yes': 'Yes',
+  'no': 'No'
+})
+
+// Add app-specific translations
+addI18nApp('en', 'common', {
+  'yes': 'OK',  // This will override the library translation
+  'save': 'Save Changes'
+})
+
+// Initialize resources (sorted by level and priority)
+const resources = initI18nResource('en', 'common')
+// resources will contain both library and app translations, with app taking priority
+```
+
+### Working with Namespaces
+```typescript
+import { addI18nLib, addI18nApp } from '@owlmeans/i18n'
+
+// Add translations to specific namespace
+addI18nLib('en', 'buttons', {
+  'save': 'Save',
+  'cancel': 'Cancel'
+}, 'ui')
+
+// Add with namespace in options
+addI18nApp('en', 'forms', {
+  'required': 'This field is required'
+}, { ns: 'validation' })
+```
+
+### Priority-based Loading
+```typescript
+import { addI18nLib, addI18nApp, addCommonI18n } from '@owlmeans/i18n'
+
+// Add translations with different priorities
+addI18nLib('en', 'messages', { 'welcome': 'Welcome' })
+addI18nApp('en', 'messages', { 'welcome': 'Welcome to App' })
+addCommonI18n('en', 'messages', { 'welcome': 'Service Welcome' })
+
+// When initialized, service translation will have highest priority
+const resources = initI18nResource('en', 'messages')
+// The 'welcome' key will resolve to 'Service Welcome'
+```
+
+## Integration with OwlMeans Common
+
+This package follows the OwlMeans Common library structure:
+- **types**: TypeScript interfaces and type definitions
+- **consts**: Static values and constants
+- **helper**: Consumer-facing utility functions
+- **utils**: Internal utility functions for storage management
+
+The i18n system is designed to integrate seamlessly with other OwlMeans Common packages and can be extended with custom resource loaders and translation providers.

package/build/consts.d.ts

@@ -0,0 +1,11 @@
+export declare const DEFAULT_NAMESPACE = "translation";
+export declare const LIB_NAMESPACE = "lib";
+export declare const DEFAULT_LNG = "en";
+export declare const SRV_NAMESPACE = "service";
+export declare const MAX_PRIORITY: number;
+export declare enum I18nLevel {
+    Library = "library",
+    App = "app",
+    Service = "service"
+}
+//# sourceMappingURL=consts.d.ts.map

package/build/consts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,iBAAiB,gBAAgB,CAAA;AAE9C,eAAO,MAAM,aAAa,QAAQ,CAAA;AAElC,eAAO,MAAM,WAAW,OAAO,CAAA;AAE/B,eAAO,MAAM,aAAa,YAAY,CAAA;AAEtC,eAAO,MAAM,YAAY,QAA0B,CAAA;AAEnD,oBAAY,SAAS;IACnB,OAAO,YAAY;IACnB,GAAG,QAAQ;IACX,OAAO,YAAY;CACpB"}

package/build/consts.js

@@ -0,0 +1,12 @@
+export const DEFAULT_NAMESPACE = 'translation';
+export const LIB_NAMESPACE = 'lib';
+export const DEFAULT_LNG = 'en';
+export const SRV_NAMESPACE = 'service';
+export const MAX_PRIORITY = Number.MAX_SAFE_INTEGER;
+export var I18nLevel;
+(function (I18nLevel) {
+    I18nLevel["Library"] = "library";
+    I18nLevel["App"] = "app";
+    I18nLevel["Service"] = "service";
+})(I18nLevel || (I18nLevel = {}));
+//# sourceMappingURL=consts.js.map

package/build/consts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.js","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AACA,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAAA;AAE9C,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAA;AAElC,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAA;AAE/B,MAAM,CAAC,MAAM,aAAa,GAAG,SAAS,CAAA;AAEtC,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,gBAAgB,CAAA;AAEnD,MAAM,CAAN,IAAY,SAIX;AAJD,WAAY,SAAS;IACnB,gCAAmB,CAAA;IACnB,wBAAW,CAAA;IACX,gCAAmB,CAAA;AACrB,CAAC,EAJW,SAAS,KAAT,SAAS,QAIpB"}

package/build/helper.d.ts

@@ -0,0 +1,6 @@
+import type { I18nLeveledResourceSignature, I18nResource } from './types.js';
+export declare const addI18nLib: I18nLeveledResourceSignature;
+export declare const addI18nApp: I18nLeveledResourceSignature;
+export declare const addCommonI18n: I18nLeveledResourceSignature;
+export declare const initI18nResource: (lng: string, resource: string, ns?: string) => null | I18nResource[];
+//# sourceMappingURL=helper.d.ts.map

package/build/helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../src/helper.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,4BAA4B,EAAE,YAAY,EAA8C,MAAM,YAAY,CAAA;AA6BxH,eAAO,MAAM,UAAU,EAAE,4BAGxB,CAAA;AAED,eAAO,MAAM,UAAU,EAAE,4BAGxB,CAAA;AAED,eAAO,MAAM,aAAa,EAAE,4BAG3B,CAAA;AAED,eAAO,MAAM,gBAAgB,QAAS,MAAM,YAAY,MAAM,OAAO,MAAM,KAAG,IAAI,GAAG,YAAY,EAoBhG,CAAA"}

package/build/helper.js

@@ -0,0 +1,54 @@
+import { DEFAULT_NAMESPACE, I18nLevel, LIB_NAMESPACE, MAX_PRIORITY } from './consts.js';
+import { levelCost } from './utils/consts.js';
+import { ensureStructure } from './utils/storage.js';
+const prepareOptions = (opts, ns) => {
+    if (typeof opts === 'string') {
+        opts = { ns: opts };
+    }
+    else if (typeof opts === 'undefined') {
+        opts = {};
+    }
+    if (opts.ns == null && ns != null) {
+        opts.ns = ns;
+    }
+    return opts;
+};
+const _addI18n = (level, lng, resource, data, opts) => {
+    opts = prepareOptions(opts);
+    const storage = ensureStructure(lng, resource, opts.ns);
+    const ns = opts.ns ?? DEFAULT_NAMESPACE;
+    const translation = {
+        ns, lng, level, resource, data, priority: opts.priroty
+    };
+    storage.resources.push(translation);
+};
+export const addI18nLib = (lng, resource, data, opts) => {
+    opts = prepareOptions(opts, LIB_NAMESPACE);
+    _addI18n(I18nLevel.Library, lng, resource, data, opts);
+};
+export const addI18nApp = (lng, resource, data, opts) => {
+    opts = prepareOptions(opts, resource);
+    _addI18n(I18nLevel.App, lng, resource, data, opts);
+};
+export const addCommonI18n = (lng, resource, data, opts) => {
+    opts = prepareOptions(opts);
+    _addI18n(I18nLevel.Service, lng, resource, data, opts);
+};
+export const initI18nResource = (lng, resource, ns) => {
+    ns = ns ?? DEFAULT_NAMESPACE;
+    const translation = ensureStructure(lng, resource, ns);
+    if (translation.lngInitialized.includes(lng)) {
+        return null;
+    }
+    const result = [...translation.resources].sort((a, b) => {
+        const aLev = levelCost[a.level];
+        const bLev = levelCost[b.level];
+        if (aLev !== bLev) {
+            return aLev - bLev;
+        }
+        return (a.priority ?? MAX_PRIORITY) - (b.priority ?? MAX_PRIORITY);
+    });
+    translation.lngInitialized.push(lng);
+    return result;
+};
+//# sourceMappingURL=helper.js.map

package/build/helper.js.map

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

package/build/index.d.ts

@@ -0,0 +1,4 @@
+export type * from './types.js';
+export * from './helper.js';
+export * from './consts.js';
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,mBAAmB,YAAY,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA"}

package/build/index.js

@@ -0,0 +1,3 @@
+export * from './helper.js';
+export * from './consts.js';
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA"}

package/build/types.d.ts

@@ -0,0 +1,36 @@
+import type { I18nLevel } from './consts.js';
+export interface I18nStorage {
+    data: I18nNamespaces;
+}
+export interface I18nNamespaces extends Record<string, I18nResources> {
+}
+export interface I18nResources extends Record<string, I18nLanguages> {
+}
+export interface I18nLanguages extends Record<string, {
+    resources: I18nResource[];
+    lngInitialized: string[];
+}> {
+}
+export interface I18nResource {
+    ns?: string;
+    lng?: string;
+    level: I18nLevel;
+    resource: string;
+    priority?: number;
+    data: Record<string, any>;
+}
+export interface I18nResourceOptions {
+    priroty?: number;
+    ns?: string;
+}
+export interface I18nResourceSignature {
+    (level: I18nLevel, lng: string, resource: string, data: Record<string, any>, opts?: I18nResourceOptions | string): void;
+}
+export interface I18nLeveledResourceSignature {
+    (lng: string, resource: string, data: Record<string, any>, opts?: I18nResourceOptions | string): void;
+}
+export interface I18nConfig {
+    defaultLng?: string;
+    defaultNs?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE5C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,cAAc,CAAA;CACrB;AAED,MAAM,WAAW,cAAe,SAAQ,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC;CAAI;AAEzE,MAAM,WAAW,aAAc,SAAQ,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC;CAAI;AAExE,MAAM,WAAW,aAAc,SAAQ,MAAM,CAAC,MAAM,EAAE;IACpD,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,cAAc,EAAE,MAAM,EAAE,CAAA;CACzB,CAAC;CAAI;AAEN,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,SAAS,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,EAAE,CAAC,EAAE,MAAM,CAAA;CACZ;AAED,MAAM,WAAW,qBAAqB;IACpC,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,EAAE,mBAAmB,GAAG,MAAM,GAAG,IAAI,CAAA;CACxH;AAED,MAAM,WAAW,4BAA4B;IAC3C,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,EAAE,mBAAmB,GAAG,MAAM,GAAG,IAAI,CAAA;CACtG;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB"}

package/build/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/build/utils/consts.d.ts

@@ -0,0 +1,6 @@
+export declare const levelCost: {
+    library: number;
+    app: number;
+    service: number;
+};
+//# sourceMappingURL=consts.d.ts.map

package/build/utils/consts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../../src/utils/consts.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,SAAS;;;;CAIrB,CAAA"}

package/build/utils/consts.js

@@ -0,0 +1,7 @@
+import { I18nLevel } from '../consts.js';
+export const levelCost = {
+    [I18nLevel.Library]: 0,
+    [I18nLevel.App]: 1,
+    [I18nLevel.Service]: 2
+};
+//# sourceMappingURL=consts.js.map

package/build/utils/consts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.js","sourceRoot":"","sources":["../../src/utils/consts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAExC,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;IACtB,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;IAClB,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;CACvB,CAAA"}

package/build/utils/index.d.ts

@@ -0,0 +1,3 @@
+export * from './storage.js';
+export * from './consts.js';
+//# sourceMappingURL=index.d.ts.map

package/build/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AACA,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA"}

package/build/utils/index.js

@@ -0,0 +1,3 @@
+export * from './storage.js';
+export * from './consts.js';
+//# sourceMappingURL=index.js.map

package/build/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AACA,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA"}

package/build/utils/storage.d.ts

@@ -0,0 +1,7 @@
+import type { I18nStorage } from '../types.js';
+export declare const _OwlMeansI18nStorage: I18nStorage;
+export declare const ensureStructure: (lng: string, resource: string, ns?: string) => {
+    resources: import("../types.js").I18nResource[];
+    lngInitialized: string[];
+};
+//# sourceMappingURL=storage.d.ts.map

package/build/utils/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/utils/storage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C,eAAO,MAAM,oBAAoB,EAAE,WAElC,CAAA;AAED,eAAO,MAAM,eAAe,QAAS,MAAM,YAAY,MAAM,OAAO,MAAM;;;CAgBzE,CAAA"}

package/build/utils/storage.js

@@ -0,0 +1,21 @@
+import { DEFAULT_NAMESPACE } from '../consts.js';
+export const _OwlMeansI18nStorage = {
+    data: {}
+};
+export const ensureStructure = (lng, resource, ns) => {
+    ns = ns ?? DEFAULT_NAMESPACE;
+    if (!_OwlMeansI18nStorage.data[ns]) {
+        _OwlMeansI18nStorage.data[ns] = {};
+    }
+    if (!_OwlMeansI18nStorage.data[ns][resource]) {
+        _OwlMeansI18nStorage.data[ns][resource] = {};
+    }
+    if (!_OwlMeansI18nStorage.data[ns][resource][lng]) {
+        _OwlMeansI18nStorage.data[ns][resource][lng] = {
+            resources: [],
+            lngInitialized: []
+        };
+    }
+    return _OwlMeansI18nStorage.data[ns][resource][lng];
+};
+//# sourceMappingURL=storage.js.map

package/build/utils/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../src/utils/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAGhD,MAAM,CAAC,MAAM,oBAAoB,GAAgB;IAC/C,IAAI,EAAE,EAAE;CACT,CAAA;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,GAAW,EAAE,QAAgB,EAAE,EAAW,EAAE,EAAE;IAC5E,EAAE,GAAG,EAAE,IAAI,iBAAiB,CAAA;IAC5B,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QACnC,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,CAAA;IACpC,CAAC;IACD,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7C,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAA;IAC9C,CAAC;IACD,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;QAClD,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,GAAG;YAC7C,SAAS,EAAE,EAAE;YACb,cAAc,EAAE,EAAE;SACnB,CAAA;IACH,CAAC;IAED,OAAO,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAA;AACrD,CAAC,CAAA"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@owlmeans/i18n",
+  "version": "0.1.0",
+  "type": "module",
+  "scripts": {
+    "build": "tsc -b",
+    "dev": "sleep 168 && nodemon -e ts,tsx,json --watch src --exec \"tsc -p ./tsconfig.json\"",
+    "watch": "tsc -b -w --preserveWatchOutput --pretty"
+  },
+  "main": "build/index.js",
+  "module": "build/index.js",
+  "types": "build/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./build/index.js",
+      "require": "./build/index.js",
+      "default": "./build/index.js",
+      "module": "./build/index.js",
+      "types": "./build/index.d.ts"
+    },
+    "./utils": {
+      "import": "./build/utils/index.js",
+      "require": "./build/utils/index.js",
+      "default": "./build/utils/index.js",
+      "module": "./build/utils/index.js",
+      "types": "./build/utils/index.d.ts"
+    }
+  },
+  "devDependencies": {
+    "nodemon": "^3.1.7",
+    "typescript": "^5.6.3"
+  },
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/consts.ts

@@ -0,0 +1,16 @@
+
+export const DEFAULT_NAMESPACE = 'translation'
+
+export const LIB_NAMESPACE = 'lib'
+
+export const DEFAULT_LNG = 'en'
+
+export const SRV_NAMESPACE = 'service'
+
+export const MAX_PRIORITY = Number.MAX_SAFE_INTEGER
+
+export enum I18nLevel {
+  Library = 'library',
+  App = 'app',
+  Service = 'service'
+}

package/src/helper.ts

@@ -0,0 +1,66 @@
+import { DEFAULT_NAMESPACE, I18nLevel, LIB_NAMESPACE, MAX_PRIORITY } from './consts.js'
+import type { I18nLeveledResourceSignature, I18nResource, I18nResourceOptions, I18nResourceSignature } from './types.js'
+import { levelCost } from './utils/consts.js'
+import { ensureStructure } from './utils/storage.js'
+
+const prepareOptions: (opts: I18nResourceOptions | string | undefined, ns?: string) => I18nResourceOptions = (opts, ns) => {
+  if (typeof opts === 'string') {
+    opts = { ns: opts }
+  } else if (typeof opts === 'undefined') {
+    opts = {}
+  }
+  if (opts.ns == null && ns != null) {
+    opts.ns = ns
+  }
+  return opts
+}
+
+const _addI18n: I18nResourceSignature = (level, lng, resource, data, opts) => {
+  opts = prepareOptions(opts)
+  const storage = ensureStructure(lng, resource, opts.ns)
+
+  const ns = opts.ns ?? DEFAULT_NAMESPACE
+
+  const translation: I18nResource = {
+    ns, lng, level, resource, data, priority: opts.priroty
+  }
+
+  storage.resources.push(translation)
+}
+
+export const addI18nLib: I18nLeveledResourceSignature = (lng, resource, data, opts) => {
+  opts = prepareOptions(opts, LIB_NAMESPACE)
+  _addI18n(I18nLevel.Library, lng, resource, data, opts)
+}
+
+export const addI18nApp: I18nLeveledResourceSignature = (lng, resource, data, opts) => {
+  opts = prepareOptions(opts, resource)
+  _addI18n(I18nLevel.App, lng, resource, data, opts)
+}
+
+export const addCommonI18n: I18nLeveledResourceSignature = (lng, resource, data, opts) => {
+  opts = prepareOptions(opts)
+  _addI18n(I18nLevel.Service, lng, resource, data, opts)
+}
+
+export const initI18nResource = (lng: string, resource: string, ns?: string): null | I18nResource[] => {
+  ns = ns ?? DEFAULT_NAMESPACE
+  const translation = ensureStructure(lng, resource, ns)
+  if (translation.lngInitialized.includes(lng)) {
+    return null
+  }
+
+  const result = [...translation.resources].sort((a, b) => {
+    const aLev = levelCost[a.level]
+    const bLev = levelCost[b.level]
+    if (aLev !== bLev) {
+      return aLev - bLev
+    }
+
+    return (a.priority ?? MAX_PRIORITY) - (b.priority ?? MAX_PRIORITY)
+  })
+
+  translation.lngInitialized.push(lng)
+
+  return result
+}

package/src/index.ts

@@ -0,0 +1,4 @@
+
+export type * from './types.js'
+export * from './helper.js'
+export * from './consts.js'

package/src/types.ts

@@ -0,0 +1,41 @@
+import type { I18nLevel } from './consts.js'
+
+export interface I18nStorage {
+  data: I18nNamespaces
+}
+
+export interface I18nNamespaces extends Record<string, I18nResources> { }
+
+export interface I18nResources extends Record<string, I18nLanguages> { }
+
+export interface I18nLanguages extends Record<string, {
+  resources: I18nResource[],
+  lngInitialized: string[]
+}> { }
+
+export interface I18nResource {
+  ns?: string
+  lng?: string
+  level: I18nLevel
+  resource: string
+  priority?: number
+  data: Record<string, any>
+}
+
+export interface I18nResourceOptions {
+  priroty?: number
+  ns?: string
+}
+
+export interface I18nResourceSignature {
+  (level: I18nLevel, lng: string, resource: string, data: Record<string, any>, opts?: I18nResourceOptions | string): void
+}
+
+export interface I18nLeveledResourceSignature {
+  (lng: string, resource: string, data: Record<string, any>, opts?: I18nResourceOptions | string): void
+}
+
+export interface I18nConfig {
+  defaultLng?: string
+  defaultNs?: string
+}

package/src/utils/consts.ts

@@ -0,0 +1,7 @@
+import { I18nLevel } from '../consts.js'
+
+export const levelCost = {
+  [I18nLevel.Library]: 0,
+  [I18nLevel.App]: 1,
+  [I18nLevel.Service]: 2
+}

package/src/utils/index.ts

@@ -0,0 +1,3 @@
+
+export * from './storage.js'
+export * from './consts.js'

package/src/utils/storage.ts

@@ -0,0 +1,24 @@
+import { DEFAULT_NAMESPACE } from '../consts.js'
+import type { I18nStorage } from '../types.js'
+
+export const _OwlMeansI18nStorage: I18nStorage = {
+  data: {}
+}
+
+export const ensureStructure = (lng: string, resource: string, ns?: string) => {
+  ns = ns ?? DEFAULT_NAMESPACE
+  if (!_OwlMeansI18nStorage.data[ns]) {
+    _OwlMeansI18nStorage.data[ns] = {}
+  }
+  if (!_OwlMeansI18nStorage.data[ns][resource]) {
+    _OwlMeansI18nStorage.data[ns][resource] = {}
+  }
+  if (!_OwlMeansI18nStorage.data[ns][resource][lng]) {
+    _OwlMeansI18nStorage.data[ns][resource][lng] = {
+      resources: [],
+      lngInitialized: []
+    }
+  }
+
+  return _OwlMeansI18nStorage.data[ns][resource][lng]
+}

package/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "extends": [
+    "../tsconfig.default.json",
+    "../tsconfig.react.json",
+  ],
+  "compilerOptions": {
+    "rootDir": "./src/", /* Specify the root folder within your source files. */
+    "outDir": "./build/", /* Specify an output folder for all emitted files. */
+    "moduleResolution": "Bundler"
+  },
+  "exclude": [
+    "./dist/**/*",
+    "./build/**/*",
+    "./*.ts"
+  ]
+}

package/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["./src/consts.ts","./src/helper.ts","./src/index.ts","./src/types.ts","./src/utils/consts.ts","./src/utils/index.ts","./src/utils/storage.ts"],"version":"5.6.3"}