@objectstack/core 3.2.4 → 3.2.6

package/dist/index.d.cts

@@ -1647,6 +1647,40 @@ declare function createMemoryJob(): {
     listJobs(): Promise<string[]>;
 };
 
+/**
+ * Resolve a locale code against available locales with fallback.
+ *
+ * Fallback chain:
+ *   1. Exact match (e.g. `zh-CN` → `zh-CN`)
+ *   2. Case-insensitive match (e.g. `zh-cn` → `zh-CN`)
+ *   3. Base language match (e.g. `zh-CN` → `zh`)
+ *   4. Variant expansion (e.g. `zh` → `zh-CN`)
+ *
+ * Returns the matched locale code, or `undefined` when no match is found.
+ */
+declare function resolveLocale(requestedLocale: string, availableLocales: string[]): string | undefined;
+/**
+ * In-memory i18n service fallback.
+ *
+ * Implements the II18nService contract with basic translate/load/getLocales
+ * operations.  Used by ObjectKernel as an automatic fallback when no real
+ * i18n plugin (e.g. I18nServicePlugin) is registered.
+ *
+ * Supports runtime translation loading, locale management, and
+ * locale code fallback (e.g. `zh` → `zh-CN`).
+ * Does not load files from disk — operates purely in-memory.
+ */
+declare function createMemoryI18n(): {
+    _fallback: boolean;
+    _serviceName: string;
+    t(key: string, locale: string, params?: Record<string, unknown>): string;
+    getTranslations(locale: string): Record<string, unknown>;
+    loadTranslations(locale: string, data: Record<string, unknown>): void;
+    getLocales(): string[];
+    getDefaultLocale(): string;
+    setDefaultLocale(locale: string): void;
+};
+
 /**
  * Map of core-criticality service names to their in-memory fallback factories.
  * Used by ObjectKernel.validateSystemRequirements() to auto-inject fallbacks
@@ -2079,4 +2113,4 @@ declare class PackageManager {
     getSnapshot(packageId: string): PackageSnapshot | undefined;
 }
 
-export { ApiRegistry, type ApiRegistryPluginConfig, CORE_FALLBACK_FACTORIES, DependencyResolver, HotReloadManager, type InstallResult, type InstalledPackageRecord, type KernelState, LiteKernel, type NamespaceCheckResult, type NamespaceConflict, type NamespaceEntry, NamespaceResolver, ObjectKernel, ObjectKernelBase, type ObjectKernelConfig, ObjectLogger, PackageManager, type PackageSnapshot, type PermissionCheckResult$1 as PermissionCheckResult, type PermissionGrant, type Plugin, PluginConfigValidator, type PluginContext, PluginHealthMonitor, type PluginHealthStatus, type PluginLoadResult, PluginLoader, type PluginMetadata, type PermissionCheckResult as PluginPermissionCheckResult, PluginPermissionEnforcer, PluginPermissionManager, type PluginPermissions, PluginSandboxRuntime, PluginSecurityScanner, type PluginSignatureConfig, PluginSignatureVerifier, type PluginStartupResult, index as QA, type ResourceUsage, type RollbackResult, type SandboxContext, type ScanTarget, SecurePluginContext, type SecurityIssue, SemanticVersionManager, type ServiceFactory, ServiceLifecycle, type ServiceRegistration, type SignatureVerificationResult, type UpgradeResult, type VersionCompatibility, createApiRegistryPlugin, createLogger, createMemoryCache, createMemoryJob, createMemoryQueue, createPluginConfigValidator, createPluginPermissionEnforcer, getEnv, getMemoryUsage, isNode, safeExit };
+export { ApiRegistry, type ApiRegistryPluginConfig, CORE_FALLBACK_FACTORIES, DependencyResolver, HotReloadManager, type InstallResult, type InstalledPackageRecord, type KernelState, LiteKernel, type NamespaceCheckResult, type NamespaceConflict, type NamespaceEntry, NamespaceResolver, ObjectKernel, ObjectKernelBase, type ObjectKernelConfig, ObjectLogger, PackageManager, type PackageSnapshot, type PermissionCheckResult$1 as PermissionCheckResult, type PermissionGrant, type Plugin, PluginConfigValidator, type PluginContext, PluginHealthMonitor, type PluginHealthStatus, type PluginLoadResult, PluginLoader, type PluginMetadata, type PermissionCheckResult as PluginPermissionCheckResult, PluginPermissionEnforcer, PluginPermissionManager, type PluginPermissions, PluginSandboxRuntime, PluginSecurityScanner, type PluginSignatureConfig, PluginSignatureVerifier, type PluginStartupResult, index as QA, type ResourceUsage, type RollbackResult, type SandboxContext, type ScanTarget, SecurePluginContext, type SecurityIssue, SemanticVersionManager, type ServiceFactory, ServiceLifecycle, type ServiceRegistration, type SignatureVerificationResult, type UpgradeResult, type VersionCompatibility, createApiRegistryPlugin, createLogger, createMemoryCache, createMemoryI18n, createMemoryJob, createMemoryQueue, createPluginConfigValidator, createPluginPermissionEnforcer, getEnv, getMemoryUsage, isNode, resolveLocale, safeExit };

package/dist/index.d.ts

@@ -1647,6 +1647,40 @@ declare function createMemoryJob(): {
     listJobs(): Promise<string[]>;
 };
 
+/**
+ * Resolve a locale code against available locales with fallback.
+ *
+ * Fallback chain:
+ *   1. Exact match (e.g. `zh-CN` → `zh-CN`)
+ *   2. Case-insensitive match (e.g. `zh-cn` → `zh-CN`)
+ *   3. Base language match (e.g. `zh-CN` → `zh`)
+ *   4. Variant expansion (e.g. `zh` → `zh-CN`)
+ *
+ * Returns the matched locale code, or `undefined` when no match is found.
+ */
+declare function resolveLocale(requestedLocale: string, availableLocales: string[]): string | undefined;
+/**
+ * In-memory i18n service fallback.
+ *
+ * Implements the II18nService contract with basic translate/load/getLocales
+ * operations.  Used by ObjectKernel as an automatic fallback when no real
+ * i18n plugin (e.g. I18nServicePlugin) is registered.
+ *
+ * Supports runtime translation loading, locale management, and
+ * locale code fallback (e.g. `zh` → `zh-CN`).
+ * Does not load files from disk — operates purely in-memory.
+ */
+declare function createMemoryI18n(): {
+    _fallback: boolean;
+    _serviceName: string;
+    t(key: string, locale: string, params?: Record<string, unknown>): string;
+    getTranslations(locale: string): Record<string, unknown>;
+    loadTranslations(locale: string, data: Record<string, unknown>): void;
+    getLocales(): string[];
+    getDefaultLocale(): string;
+    setDefaultLocale(locale: string): void;
+};
+
 /**
  * Map of core-criticality service names to their in-memory fallback factories.
  * Used by ObjectKernel.validateSystemRequirements() to auto-inject fallbacks
@@ -2079,4 +2113,4 @@ declare class PackageManager {
     getSnapshot(packageId: string): PackageSnapshot | undefined;
 }
 
-export { ApiRegistry, type ApiRegistryPluginConfig, CORE_FALLBACK_FACTORIES, DependencyResolver, HotReloadManager, type InstallResult, type InstalledPackageRecord, type KernelState, LiteKernel, type NamespaceCheckResult, type NamespaceConflict, type NamespaceEntry, NamespaceResolver, ObjectKernel, ObjectKernelBase, type ObjectKernelConfig, ObjectLogger, PackageManager, type PackageSnapshot, type PermissionCheckResult$1 as PermissionCheckResult, type PermissionGrant, type Plugin, PluginConfigValidator, type PluginContext, PluginHealthMonitor, type PluginHealthStatus, type PluginLoadResult, PluginLoader, type PluginMetadata, type PermissionCheckResult as PluginPermissionCheckResult, PluginPermissionEnforcer, PluginPermissionManager, type PluginPermissions, PluginSandboxRuntime, PluginSecurityScanner, type PluginSignatureConfig, PluginSignatureVerifier, type PluginStartupResult, index as QA, type ResourceUsage, type RollbackResult, type SandboxContext, type ScanTarget, SecurePluginContext, type SecurityIssue, SemanticVersionManager, type ServiceFactory, ServiceLifecycle, type ServiceRegistration, type SignatureVerificationResult, type UpgradeResult, type VersionCompatibility, createApiRegistryPlugin, createLogger, createMemoryCache, createMemoryJob, createMemoryQueue, createPluginConfigValidator, createPluginPermissionEnforcer, getEnv, getMemoryUsage, isNode, safeExit };
+export { ApiRegistry, type ApiRegistryPluginConfig, CORE_FALLBACK_FACTORIES, DependencyResolver, HotReloadManager, type InstallResult, type InstalledPackageRecord, type KernelState, LiteKernel, type NamespaceCheckResult, type NamespaceConflict, type NamespaceEntry, NamespaceResolver, ObjectKernel, ObjectKernelBase, type ObjectKernelConfig, ObjectLogger, PackageManager, type PackageSnapshot, type PermissionCheckResult$1 as PermissionCheckResult, type PermissionGrant, type Plugin, PluginConfigValidator, type PluginContext, PluginHealthMonitor, type PluginHealthStatus, type PluginLoadResult, PluginLoader, type PluginMetadata, type PermissionCheckResult as PluginPermissionCheckResult, PluginPermissionEnforcer, PluginPermissionManager, type PluginPermissions, PluginSandboxRuntime, PluginSecurityScanner, type PluginSignatureConfig, PluginSignatureVerifier, type PluginStartupResult, index as QA, type ResourceUsage, type RollbackResult, type SandboxContext, type ScanTarget, SecurePluginContext, type SecurityIssue, SemanticVersionManager, type ServiceFactory, ServiceLifecycle, type ServiceRegistration, type SignatureVerificationResult, type UpgradeResult, type VersionCompatibility, createApiRegistryPlugin, createLogger, createMemoryCache, createMemoryI18n, createMemoryJob, createMemoryQueue, createPluginConfigValidator, createPluginPermissionEnforcer, getEnv, getMemoryUsage, isNode, resolveLocale, safeExit };

package/dist/index.js

@@ -1030,11 +1030,73 @@ function createMemoryJob() {
   };
 }
 
+// src/fallbacks/memory-i18n.ts
+function resolveLocale(requestedLocale, availableLocales) {
+  if (availableLocales.length === 0) return void 0;
+  if (availableLocales.includes(requestedLocale)) return requestedLocale;
+  const lower = requestedLocale.toLowerCase();
+  const caseMatch = availableLocales.find((l) => l.toLowerCase() === lower);
+  if (caseMatch) return caseMatch;
+  const baseLang = requestedLocale.split("-")[0].toLowerCase();
+  const baseMatch = availableLocales.find((l) => l.toLowerCase() === baseLang);
+  if (baseMatch) return baseMatch;
+  const variantMatch = availableLocales.find((l) => l.split("-")[0].toLowerCase() === baseLang);
+  if (variantMatch) return variantMatch;
+  return void 0;
+}
+function createMemoryI18n() {
+  const translations = /* @__PURE__ */ new Map();
+  let defaultLocale = "en";
+  function resolveKey(data, key) {
+    const parts = key.split(".");
+    let current = data;
+    for (const part of parts) {
+      if (current == null || typeof current !== "object") return void 0;
+      current = current[part];
+    }
+    return typeof current === "string" ? current : void 0;
+  }
+  function resolveTranslations(locale) {
+    if (translations.has(locale)) return translations.get(locale);
+    const resolved = resolveLocale(locale, [...translations.keys()]);
+    if (resolved) return translations.get(resolved);
+    return void 0;
+  }
+  return {
+    _fallback: true,
+    _serviceName: "i18n",
+    t(key, locale, params) {
+      const data = resolveTranslations(locale) ?? translations.get(defaultLocale);
+      const value = data ? resolveKey(data, key) : void 0;
+      if (value == null) return key;
+      if (!params) return value;
+      return value.replace(/\{\{(\w+)\}\}/g, (_, name) => String(params[name] ?? `{{${name}}}`));
+    },
+    getTranslations(locale) {
+      return resolveTranslations(locale) ?? {};
+    },
+    loadTranslations(locale, data) {
+      const existing = translations.get(locale) ?? {};
+      translations.set(locale, { ...existing, ...data });
+    },
+    getLocales() {
+      return [...translations.keys()];
+    },
+    getDefaultLocale() {
+      return defaultLocale;
+    },
+    setDefaultLocale(locale) {
+      defaultLocale = locale;
+    }
+  };
+}
+
 // src/fallbacks/index.ts
 var CORE_FALLBACK_FACTORIES = {
   cache: createMemoryCache,
   queue: createMemoryQueue,
-  job: createMemoryJob
+  job: createMemoryJob,
+  i18n: createMemoryI18n
 };
 
 // src/kernel.ts
@@ -4856,6 +4918,7 @@ export {
   createApiRegistryPlugin,
   createLogger,
   createMemoryCache,
+  createMemoryI18n,
   createMemoryJob,
   createMemoryQueue,
   createPluginConfigValidator,
@@ -4863,6 +4926,7 @@ export {
   getEnv,
   getMemoryUsage,
   isNode,
+  resolveLocale,
   safeExit
 };
 //# sourceMappingURL=index.js.map