@pyreon/i18n 0.11.4 → 0.11.6

package/src/create-i18n.ts

@@ -1,22 +1,22 @@
-import { computed, signal } from "@pyreon/reactivity"
-import { interpolate } from "./interpolation"
-import { resolvePluralCategory } from "./pluralization"
-import type { I18nInstance, I18nOptions, InterpolationValues, TranslationDictionary } from "./types"
+import { computed, signal } from '@pyreon/reactivity'
+import { interpolate } from './interpolation'
+import { resolvePluralCategory } from './pluralization'
+import type { I18nInstance, I18nOptions, InterpolationValues, TranslationDictionary } from './types'
 
 /**
  * Resolve a dot-separated key path in a nested dictionary.
  * E.g. "user.greeting" → dictionary.user.greeting
  */
 function resolveKey(dict: TranslationDictionary, keyPath: string): string | undefined {
-  const parts = keyPath.split(".")
+  const parts = keyPath.split('.')
   let current: TranslationDictionary | string = dict
 
   for (const part of parts) {
-    if (current == null || typeof current === "string") return undefined
+    if (current == null || typeof current === 'string') return undefined
     current = current[part] as TranslationDictionary | string
   }
 
-  return typeof current === "string" ? current : undefined
+  return typeof current === 'string' ? current : undefined
 }
 
 /**
@@ -31,13 +31,13 @@ function nestFlatKeys(messages: TranslationDictionary): TranslationDictionary {
 
   for (const key of Object.keys(messages)) {
     const value = messages[key]
-    if (key.includes(".") && typeof value === "string") {
+    if (key.includes('.') && typeof value === 'string') {
       hasFlatKeys = true
-      const parts = key.split(".")
+      const parts = key.split('.')
       let current: TranslationDictionary = result
       for (let i = 0; i < parts.length - 1; i++) {
         const part = parts[i] as string
-        if (!(part in current) || typeof current[part] !== "object") {
+        if (!(part in current) || typeof current[part] !== 'object') {
           current[part] = {}
         }
         current = current[part] as TranslationDictionary
@@ -56,13 +56,13 @@ function nestFlatKeys(messages: TranslationDictionary): TranslationDictionary {
  */
 function deepMerge(target: TranslationDictionary, source: TranslationDictionary): void {
   for (const key of Object.keys(source)) {
-    if (key === "__proto__" || key === "constructor" || key === "prototype") continue
+    if (key === '__proto__' || key === 'constructor' || key === 'prototype') continue
     const sourceVal = source[key]
     const targetVal = target[key]
     if (
-      typeof sourceVal === "object" &&
+      typeof sourceVal === 'object' &&
       sourceVal !== null &&
-      typeof targetVal === "object" &&
+      typeof targetVal === 'object' &&
       targetVal !== null
     ) {
       deepMerge(targetVal as TranslationDictionary, sourceVal as TranslationDictionary)
@@ -103,7 +103,7 @@ function deepMerge(target: TranslationDictionary, source: TranslationDictionary)
  * i18n.t('auth:errors.invalid') // looks up "errors.invalid" in "auth" namespace
  */
 export function createI18n(options: I18nOptions): I18nInstance {
-  const { fallbackLocale, loader, defaultNamespace = "common", pluralRules, onMissingKey } = options
+  const { fallbackLocale, loader, defaultNamespace = 'common', pluralRules, onMissingKey } = options
 
   // ── Reactive state ──────────────────────────────────────────────────
 
@@ -172,14 +172,14 @@ export function createI18n(options: I18nOptions): I18nInstance {
     let namespace = defaultNamespace
     let keyPath = key
 
-    const colonIndex = key.indexOf(":")
+    const colonIndex = key.indexOf(':')
     if (colonIndex > 0) {
       namespace = key.slice(0, colonIndex)
       keyPath = key.slice(colonIndex + 1)
     }
 
     // Handle pluralization: if values contain `count`, try plural suffixes
-    if (values && "count" in values) {
+    if (values && 'count' in values) {
       const count = Number(values.count)
       const category = resolvePluralCategory(currentLocale, count, pluralRules)
 
@@ -257,7 +257,7 @@ export function createI18n(options: I18nOptions): I18nInstance {
 
     let namespace = defaultNamespace
     let keyPath = key
-    const colonIndex = key.indexOf(":")
+    const colonIndex = key.indexOf(':')
     if (colonIndex > 0) {
       namespace = key.slice(0, colonIndex)
       keyPath = key.slice(colonIndex + 1)

package/src/devtools.ts

@@ -56,7 +56,7 @@ function safeRead(
 ): unknown {
   try {
     const val = obj[key]
-    return typeof val === "function" ? (val as () => unknown)() : fallback
+    return typeof val === 'function' ? (val as () => unknown)() : fallback
   } catch {
     return fallback
   }
@@ -68,12 +68,12 @@ function safeRead(
 export function getI18nSnapshot(name: string): Record<string, unknown> | undefined {
   const instance = getI18nInstance(name) as Record<string, unknown> | undefined
   if (!instance) return undefined
-  const ns = safeRead(instance, "loadedNamespaces", new Set())
+  const ns = safeRead(instance, 'loadedNamespaces', new Set())
   return {
-    locale: safeRead(instance, "locale"),
-    availableLocales: safeRead(instance, "availableLocales", []),
+    locale: safeRead(instance, 'locale'),
+    availableLocales: safeRead(instance, 'availableLocales', []),
     loadedNamespaces: ns instanceof Set ? [...ns] : [],
-    isLoading: safeRead(instance, "isLoading", false),
+    isLoading: safeRead(instance, 'isLoading', false),
   }
 }
 

package/src/index.ts

@@ -1,10 +1,10 @@
-export type { I18nProviderProps } from "./context"
-export { I18nContext, I18nProvider, useI18n } from "./context"
-export { createI18n } from "./create-i18n"
-export { interpolate } from "./interpolation"
-export { resolvePluralCategory } from "./pluralization"
-export type { TransProps } from "./trans"
-export { parseRichText, Trans } from "./trans"
+export type { I18nProviderProps } from './context'
+export { I18nContext, I18nProvider, useI18n } from './context'
+export { createI18n } from './create-i18n'
+export { interpolate } from './interpolation'
+export { resolvePluralCategory } from './pluralization'
+export type { TransProps } from './trans'
+export { parseRichText, Trans } from './trans'
 export type {
   I18nInstance,
   I18nOptions,
@@ -13,4 +13,4 @@ export type {
   PluralRules,
   TranslationDictionary,
   TranslationMessages,
-} from "./types"
+} from './types'

package/src/interpolation.ts

@@ -1,4 +1,4 @@
-import type { InterpolationValues } from "./types"
+import type { InterpolationValues } from './types'
 
 const INTERPOLATION_RE = /\{\{(\s*\w+\s*)\}\}/g
 
@@ -8,14 +8,14 @@ const INTERPOLATION_RE = /\{\{(\s*\w+\s*)\}\}/g
  * Unmatched placeholders are left as-is.
  */
 export function interpolate(template: string, values?: InterpolationValues): string {
-  if (!values || !template.includes("{{")) return template
+  if (!values || !template.includes('{{')) return template
   return template.replace(INTERPOLATION_RE, (_, key: string) => {
     const trimmed = key.trim()
     const value = values[trimmed]
     if (value === undefined) return `{{${trimmed}}}`
     // Safely coerce — guard against malicious toString/valueOf
     try {
-      return typeof value === "object" && value !== null ? JSON.stringify(value) : `${value}`
+      return typeof value === 'object' && value !== null ? JSON.stringify(value) : `${value}`
     } catch {
       return `{{${trimmed}}}`
     }

package/src/pluralization.ts

@@ -1,4 +1,4 @@
-import type { PluralRules } from "./types"
+import type { PluralRules } from './types'
 
 /**
  * Resolve the plural category for a given count and locale.
@@ -17,7 +17,7 @@ export function resolvePluralCategory(
   }
 
   // Use Intl.PluralRules if available
-  if (typeof Intl !== "undefined" && Intl.PluralRules) {
+  if (typeof Intl !== 'undefined' && Intl.PluralRules) {
     try {
       const pr = new Intl.PluralRules(locale)
       return pr.select(count)
@@ -27,5 +27,5 @@ export function resolvePluralCategory(
   }
 
   // Basic fallback
-  return count === 1 ? "one" : "other"
+  return count === 1 ? 'one' : 'other'
 }

package/src/tests/devtools.test.ts

@@ -1,4 +1,4 @@
-import { createI18n } from "../create-i18n"
+import { createI18n } from '../create-i18n'
 import {
   _resetDevtools,
   getActiveI18nInstances,
@@ -7,62 +7,62 @@ import {
   onI18nChange,
   registerI18n,
   unregisterI18n,
-} from "../devtools"
+} from '../devtools'
 
 afterEach(() => _resetDevtools())
 
-describe("i18n devtools", () => {
-  test("getActiveI18nInstances returns empty initially", () => {
+describe('i18n devtools', () => {
+  test('getActiveI18nInstances returns empty initially', () => {
     expect(getActiveI18nInstances()).toEqual([])
   })
 
-  test("registerI18n makes instance visible", () => {
-    const i18n = createI18n({ locale: "en", messages: { en: { hi: "Hello" } } })
-    registerI18n("app", i18n)
-    expect(getActiveI18nInstances()).toEqual(["app"])
+  test('registerI18n makes instance visible', () => {
+    const i18n = createI18n({ locale: 'en', messages: { en: { hi: 'Hello' } } })
+    registerI18n('app', i18n)
+    expect(getActiveI18nInstances()).toEqual(['app'])
   })
 
-  test("getI18nInstance returns the registered instance", () => {
-    const i18n = createI18n({ locale: "en", messages: { en: { hi: "Hello" } } })
-    registerI18n("app", i18n)
-    expect(getI18nInstance("app")).toBe(i18n)
+  test('getI18nInstance returns the registered instance', () => {
+    const i18n = createI18n({ locale: 'en', messages: { en: { hi: 'Hello' } } })
+    registerI18n('app', i18n)
+    expect(getI18nInstance('app')).toBe(i18n)
   })
 
-  test("getI18nInstance returns undefined for unregistered name", () => {
-    expect(getI18nInstance("nope")).toBeUndefined()
+  test('getI18nInstance returns undefined for unregistered name', () => {
+    expect(getI18nInstance('nope')).toBeUndefined()
   })
 
-  test("unregisterI18n removes the instance", () => {
-    const i18n = createI18n({ locale: "en" })
-    registerI18n("app", i18n)
-    unregisterI18n("app")
+  test('unregisterI18n removes the instance', () => {
+    const i18n = createI18n({ locale: 'en' })
+    registerI18n('app', i18n)
+    unregisterI18n('app')
     expect(getActiveI18nInstances()).toEqual([])
   })
 
-  test("getI18nSnapshot returns current state", () => {
+  test('getI18nSnapshot returns current state', () => {
     const i18n = createI18n({
-      locale: "en",
-      messages: { en: { hi: "Hello" }, de: { hi: "Hallo" } },
+      locale: 'en',
+      messages: { en: { hi: 'Hello' }, de: { hi: 'Hallo' } },
     })
-    registerI18n("app", i18n)
-    const snapshot = getI18nSnapshot("app")
+    registerI18n('app', i18n)
+    const snapshot = getI18nSnapshot('app')
     expect(snapshot).toBeDefined()
-    expect(snapshot!.locale).toBe("en")
-    expect(snapshot!.availableLocales).toEqual(expect.arrayContaining(["en", "de"]))
+    expect(snapshot!.locale).toBe('en')
+    expect(snapshot!.availableLocales).toEqual(expect.arrayContaining(['en', 'de']))
     expect(snapshot!.isLoading).toBe(false)
   })
 
-  test("getI18nSnapshot handles instance with non-function properties", () => {
+  test('getI18nSnapshot handles instance with non-function properties', () => {
     // Register a plain object where properties are NOT functions
     // This covers the false branches of typeof checks in getI18nSnapshot
     const plainInstance = {
-      locale: "not-a-function",
+      locale: 'not-a-function',
       availableLocales: 42,
       loadedNamespaces: null,
       isLoading: undefined,
     }
-    registerI18n("plain", plainInstance)
-    const snapshot = getI18nSnapshot("plain")
+    registerI18n('plain', plainInstance)
+    const snapshot = getI18nSnapshot('plain')
     expect(snapshot).toBeDefined()
     expect(snapshot!.locale).toBeUndefined()
     expect(snapshot!.availableLocales).toEqual([])
@@ -70,56 +70,56 @@ describe("i18n devtools", () => {
     expect(snapshot!.isLoading).toBe(false)
   })
 
-  test("getI18nSnapshot reflects locale change", () => {
-    const i18n = createI18n({ locale: "en", messages: { en: {}, de: {} } })
-    registerI18n("app", i18n)
-    i18n.locale.set("de")
-    const snapshot = getI18nSnapshot("app")
-    expect(snapshot!.locale).toBe("de")
+  test('getI18nSnapshot reflects locale change', () => {
+    const i18n = createI18n({ locale: 'en', messages: { en: {}, de: {} } })
+    registerI18n('app', i18n)
+    i18n.locale.set('de')
+    const snapshot = getI18nSnapshot('app')
+    expect(snapshot!.locale).toBe('de')
   })
 
-  test("getI18nSnapshot returns undefined for unregistered name", () => {
-    expect(getI18nSnapshot("nope")).toBeUndefined()
+  test('getI18nSnapshot returns undefined for unregistered name', () => {
+    expect(getI18nSnapshot('nope')).toBeUndefined()
   })
 
-  test("onI18nChange fires on register", () => {
+  test('onI18nChange fires on register', () => {
     const calls: number[] = []
     const unsub = onI18nChange(() => calls.push(1))
 
-    registerI18n("app", createI18n({ locale: "en" }))
+    registerI18n('app', createI18n({ locale: 'en' }))
     expect(calls.length).toBe(1)
 
     unsub()
   })
 
-  test("onI18nChange fires on unregister", () => {
-    registerI18n("app", createI18n({ locale: "en" }))
+  test('onI18nChange fires on unregister', () => {
+    registerI18n('app', createI18n({ locale: 'en' }))
 
     const calls: number[] = []
     const unsub = onI18nChange(() => calls.push(1))
-    unregisterI18n("app")
+    unregisterI18n('app')
     expect(calls.length).toBe(1)
 
     unsub()
   })
 
-  test("onI18nChange unsubscribe stops notifications", () => {
+  test('onI18nChange unsubscribe stops notifications', () => {
     const calls: number[] = []
     const unsub = onI18nChange(() => calls.push(1))
     unsub()
 
-    registerI18n("app", createI18n({ locale: "en" }))
+    registerI18n('app', createI18n({ locale: 'en' }))
     expect(calls.length).toBe(0)
   })
 
-  test("multiple instances are tracked", () => {
-    registerI18n("app", createI18n({ locale: "en" }))
-    registerI18n("admin", createI18n({ locale: "en" }))
-    expect(getActiveI18nInstances().sort()).toEqual(["admin", "app"])
+  test('multiple instances are tracked', () => {
+    registerI18n('app', createI18n({ locale: 'en' }))
+    registerI18n('admin', createI18n({ locale: 'en' }))
+    expect(getActiveI18nInstances().sort()).toEqual(['admin', 'app'])
   })
 
-  test("getI18nInstance cleans up and returns undefined when WeakRef is dead", () => {
-    const instance = createI18n({ locale: "en" })
+  test('getI18nInstance cleans up and returns undefined when WeakRef is dead', () => {
+    const instance = createI18n({ locale: 'en' })
     const originalWeakRef = globalThis.WeakRef
     let mockDerefResult: object | undefined = instance
     const MockWeakRef = class {
@@ -130,18 +130,18 @@ describe("i18n devtools", () => {
     globalThis.WeakRef = MockWeakRef as any
 
     _resetDevtools()
-    registerI18n("mock-instance", instance)
-    expect(getI18nInstance("mock-instance")).toBe(instance)
+    registerI18n('mock-instance', instance)
+    expect(getI18nInstance('mock-instance')).toBe(instance)
 
     // Simulate GC
     mockDerefResult = undefined
-    expect(getI18nInstance("mock-instance")).toBeUndefined()
+    expect(getI18nInstance('mock-instance')).toBeUndefined()
 
     globalThis.WeakRef = originalWeakRef
   })
 
-  test("getActiveI18nInstances cleans up garbage-collected WeakRefs", () => {
-    const instance = createI18n({ locale: "en" })
+  test('getActiveI18nInstances cleans up garbage-collected WeakRefs', () => {
+    const instance = createI18n({ locale: 'en' })
     const originalWeakRef = globalThis.WeakRef
     let mockDerefResult: object | undefined = instance
     const MockWeakRef = class {
@@ -152,8 +152,8 @@ describe("i18n devtools", () => {
     globalThis.WeakRef = MockWeakRef as any
 
     _resetDevtools()
-    registerI18n("gc-instance", instance)
-    expect(getActiveI18nInstances()).toEqual(["gc-instance"])
+    registerI18n('gc-instance', instance)
+    expect(getActiveI18nInstances()).toEqual(['gc-instance'])
 
     // Simulate GC
     mockDerefResult = undefined