@bquery/bquery 1.9.0 → 1.11.0

package/dist/{i18n-kuF6Ekj6.js → i18n--p7PM-9r.js}

@@ -1,6 +1,6 @@
 import { a as v, i as l, r as p } from "./object-BCk-1c8T.js";
-import { n as y } from "./core-DdtZHzsS.js";
-import { r as L } from "./untrack-D0fnO5k2.js";
+import { n as y } from "./core-CongXJuo.js";
+import { r as L } from "./untrack-bjWDNdyE.js";
 var O = (n, o, s) => {
   const { locale: e, ...t } = s ?? {};
   try {
@@ -86,4 +86,4 @@ export {
   x as t
 };
 
-//# sourceMappingURL=i18n-kuF6Ekj6.js.map
+//# sourceMappingURL=i18n--p7PM-9r.js.map

package/dist/{i18n-kuF6Ekj6.js.map → i18n--p7PM-9r.js.map}

@@ -1 +1 @@
-{"version":3,"file":"i18n-kuF6Ekj6.js","names":[],"sources":["../src/i18n/formatting.ts","../src/i18n/translate.ts","../src/i18n/i18n.ts"],"sourcesContent":["/**\n * Number and date formatting helpers using Intl APIs.\n * @module bquery/i18n\n */\n\nimport type { DateFormatOptions, NumberFormatOptions } from './types';\n\n/**\n * Formats a number using the Intl.NumberFormat API.\n *\n * @param value - The number to format\n * @param locale - The locale code (e.g. 'en-US', 'de-DE')\n * @param options - Intl.NumberFormat options\n * @returns The formatted number string\n *\n * @example\n * ```ts\n * formatNumber(1234.56, 'en-US'); // '1,234.56'\n * formatNumber(1234.56, 'de-DE'); // '1.234,56'\n * formatNumber(0.42, 'en-US', { style: 'percent' }); // '42%'\n * formatNumber(9.99, 'en-US', { style: 'currency', currency: 'USD' }); // '$9.99'\n * ```\n */\nexport const formatNumber = (\n  value: number,\n  locale: string,\n  options?: NumberFormatOptions\n): string => {\n  const { locale: _ignored, ...intlOptions } = options ?? {};\n  try {\n    return new Intl.NumberFormat(locale, intlOptions).format(value);\n  } catch {\n    // Fall back to basic toString on Intl errors\n    return String(value);\n  }\n};\n\n/**\n * Formats a date using the Intl.DateTimeFormat API.\n *\n * @param value - The date to format (Date object or timestamp)\n * @param locale - The locale code\n * @param options - Intl.DateTimeFormat options\n * @returns The formatted date string\n *\n * @example\n * ```ts\n * const date = new Date('2026-03-26');\n * formatDate(date, 'en-US'); // '3/26/2026'\n * formatDate(date, 'de-DE'); // '26.3.2026'\n * formatDate(date, 'en-US', { dateStyle: 'long' }); // 'March 26, 2026'\n * ```\n */\nexport const formatDate = (\n  value: Date | number,\n  locale: string,\n  options?: DateFormatOptions\n): string => {\n  const { locale: _ignored, ...intlOptions } = options ?? {};\n  const date = typeof value === 'number' ? new Date(value) : value;\n  try {\n    return new Intl.DateTimeFormat(locale, intlOptions).format(date);\n  } catch {\n    // Fall back to toLocaleString on Intl errors\n    return date.toLocaleString();\n  }\n};\n","/**\n * Translation resolution helpers.\n * @module bquery/i18n\n * @internal\n */\n\nimport { isPlainObject, isPrototypePollutionKey, merge } from '../core/utils/object';\nimport type { LocaleMessages, TranslateParams } from './types';\n\n/**\n * Resolves a dot-delimited key path against a messages object.\n *\n * @param messages - The locale messages\n * @param key - Dot-delimited key (e.g. 'user.welcome')\n * @returns The resolved string, or `undefined` if not found\n *\n * @internal\n */\nexport const resolveKey = (messages: LocaleMessages, key: string): string | undefined => {\n  const parts = key.split('.');\n  let current: LocaleMessages | string = messages;\n\n  for (const part of parts) {\n    if (typeof current === 'string') return undefined;\n    if (current[part] === undefined) return undefined;\n    current = current[part];\n  }\n\n  return typeof current === 'string' ? current : undefined;\n};\n\n/**\n * Interpolates `{param}` placeholders in a string.\n *\n * @param template - The template string with `{key}` placeholders\n * @param params - Key-value pairs for replacement\n * @returns The interpolated string\n *\n * @example\n * ```ts\n * interpolate('Hello, {name}!', { name: 'Ada' });\n * // → 'Hello, Ada!'\n * ```\n *\n * @internal\n */\nexport const interpolate = (template: string, params: TranslateParams): string => {\n  return template.replace(/\\{(\\w+)\\}/g, (match, key: string) => {\n    if (key in params) {\n      return String(params[key]);\n    }\n    return match; // Leave unmatched placeholders as-is\n  });\n};\n\n/**\n * Selects the correct plural form from a pipe-delimited string.\n *\n * Supports two formats:\n * - **Two forms:** `\"singular | plural\"` — singular when count === 1\n * - **Three forms:** `\"zero | one | many\"` — zero when count === 0,\n *   one when count === 1, many otherwise\n *\n * The `count` parameter must be present in `params` for pluralization.\n * If no `count` param exists or the string has no pipes, the string is\n * returned as-is.\n *\n * @param template - Pipe-delimited plural forms\n * @param params - Must include a `count` key for plural selection\n * @returns The selected form\n *\n * @example\n * ```ts\n * pluralize('{count} item | {count} items', { count: 1 });\n * // → '{count} item'\n *\n * pluralize('no items | {count} item | {count} items', { count: 0 });\n * // → 'no items'\n * ```\n *\n * @internal\n */\nexport const pluralize = (template: string, params: TranslateParams): string => {\n  if (!template.includes('|')) return template;\n  if (!('count' in params)) return template;\n\n  const count = Number(params.count);\n  const forms = template.split('|').map((s) => s.trim());\n\n  if (forms.length === 3) {\n    // zero | one | many\n    if (count === 0) return forms[0];\n    if (count === 1) return forms[1];\n    return forms[2];\n  }\n\n  if (forms.length === 2) {\n    // singular | plural\n    return count === 1 ? forms[0] : forms[1];\n  }\n\n  // More than 3 forms: use last form for \"many\"\n  if (count === 0 && forms.length > 0) return forms[0];\n  if (count === 1 && forms.length > 1) return forms[1];\n  return forms[forms.length - 1];\n};\n\n/**\n * Full translation pipeline: resolve → pluralize → interpolate.\n *\n * @param messages - Locale messages\n * @param key - Dot-delimited key path\n * @param params - Interpolation + pluralization params\n * @param fallbackMessages - Optional fallback locale messages\n * @returns The translated string, or the key if not found\n *\n * @internal\n */\nexport const translate = (\n  messages: LocaleMessages | undefined,\n  key: string,\n  params: TranslateParams,\n  fallbackMessages?: LocaleMessages\n): string => {\n  let template: string | undefined;\n\n  // Try current locale\n  if (messages) {\n    template = resolveKey(messages, key);\n  }\n\n  // Fallback locale\n  if (template === undefined && fallbackMessages) {\n    template = resolveKey(fallbackMessages, key);\n  }\n\n  // Key not found — return key as-is\n  if (template === undefined) {\n    return key;\n  }\n\n  // Pluralize first, then interpolate\n  const pluralized = pluralize(template, params);\n  return interpolate(pluralized, params);\n};\n\n/**\n * Deep merges source into target and returns a sanitized, prototype-safe copy.\n *\n * @param target - Target messages object\n * @param source - Source messages to merge\n * @returns A new merged, sanitized messages object\n *\n * @internal\n */\nexport const deepMerge = (target: LocaleMessages, source: LocaleMessages): LocaleMessages => {\n  const merged = merge(\n    target as Record<string, unknown>,\n    source as Record<string, unknown>\n  ) as LocaleMessages;\n\n  const cloneSafeMessages = (value: unknown): unknown => {\n    if (Array.isArray(value)) {\n      return value.map((entry) => cloneSafeMessages(entry));\n    }\n\n    if (!isPlainObject(value)) {\n      return value;\n    }\n\n    const safeObject = Object.create(null) as Record<string, unknown>;\n    for (const [key, entry] of Object.entries(value)) {\n      if (isPrototypePollutionKey(key)) {\n        continue;\n      }\n      safeObject[key] = cloneSafeMessages(entry);\n    }\n    return safeObject;\n  };\n\n  return cloneSafeMessages(merged) as LocaleMessages;\n};\n","/**\n * Core i18n factory function.\n * @module bquery/i18n\n */\n\nimport { computed, signal } from '../reactive/index';\nimport { isPrototypePollutionKey } from '../core/utils/object';\nimport { formatDate, formatNumber } from './formatting';\nimport { deepMerge, translate } from './translate';\nimport type {\n  DateFormatOptions,\n  I18nConfig,\n  I18nInstance,\n  LocaleLoader,\n  LocaleMessages,\n  Messages,\n  NumberFormatOptions,\n  TranslateParams,\n} from './types';\n\n/**\n * Creates a reactive internationalization instance.\n *\n * The returned object provides:\n * - `$locale` — a reactive signal for the current locale\n * - `t()` — translation with interpolation and pluralization\n * - `tc()` — reactive translation that auto-updates on locale change\n * - `loadLocale()` — register lazy-loaded locale files\n * - `n()` — locale-aware number formatting\n * - `d()` — locale-aware date formatting\n *\n * @param config - Initial configuration\n * @returns An i18n instance\n *\n * @example\n * ```ts\n * import { createI18n } from '@bquery/bquery/i18n';\n *\n * const i18n = createI18n({\n *   locale: 'en',\n *   fallbackLocale: 'en',\n *   messages: {\n *     en: {\n *       greeting: 'Hello, {name}!',\n *       items: '{count} item | {count} items',\n *     },\n *     de: {\n *       greeting: 'Hallo, {name}!',\n *       items: '{count} Gegenstand | {count} Gegenstände',\n *     },\n *   },\n * });\n *\n * i18n.t('greeting', { name: 'Ada' }); // 'Hello, Ada!'\n * i18n.t('items', { count: 3 });       // '3 items'\n *\n * // Switch locale reactively\n * i18n.$locale.value = 'de';\n * i18n.t('greeting', { name: 'Ada' }); // 'Hallo, Ada!'\n * ```\n */\nexport const createI18n = (config: I18nConfig): I18nInstance => {\n  const { locale: initialLocale, messages: initialMessages, fallbackLocale } = config;\n\n  const sanitizeLocaleMessages = (localeMessages: LocaleMessages): LocaleMessages =>\n    deepMerge(Object.create(null) as LocaleMessages, localeMessages);\n\n  // Deep-clone initial messages to prevent external mutation\n  const messages = Object.create(null) as Messages;\n  for (const [loc, msgs] of Object.entries(initialMessages)) {\n    if (isPrototypePollutionKey(loc)) {\n      continue;\n    }\n    messages[loc] = sanitizeLocaleMessages(msgs);\n  }\n\n  // Reactive locale signal\n  const $locale = signal(initialLocale);\n\n  // Lazy-loader registry\n  const loaders = new Map<string, LocaleLoader>();\n\n  // Track which loaders have been invoked to avoid duplicate loads\n  const loadedLocales = new Set<string>(Object.keys(messages));\n\n  /**\n   * Get messages for a locale, or undefined if not loaded.\n   */\n  const getMessages = (loc: string): LocaleMessages | undefined => {\n    if (isPrototypePollutionKey(loc)) {\n      return undefined;\n    }\n    return messages[loc];\n  };\n\n  /**\n   * Register a lazy-loader for a locale.\n   */\n  const loadLocale = (loc: string, loader: LocaleLoader): void => {\n    if (isPrototypePollutionKey(loc)) {\n      return;\n    }\n    loaders.set(loc, loader);\n  };\n\n  /**\n   * Ensure a locale's messages are loaded.\n   */\n  const ensureLocale = async (loc: string): Promise<void> => {\n    if (isPrototypePollutionKey(loc)) return;\n    if (loadedLocales.has(loc)) return;\n\n    const loader = loaders.get(loc);\n    if (!loader) {\n      throw new Error(`bQuery i18n: No messages or loader registered for locale \"${loc}\".`);\n    }\n\n    const loaded = await loader();\n    // Handle both default exports and direct objects\n    const msgs = (loaded as { default?: LocaleMessages }).default ?? (loaded as LocaleMessages);\n    messages[loc] = sanitizeLocaleMessages(msgs);\n    loadedLocales.add(loc);\n  };\n\n  /**\n   * Translate a key path.\n   */\n  const t = (key: string, params: TranslateParams = {}): string => {\n    const currentLocale = $locale.value;\n    const currentMessages = messages[currentLocale];\n    const fallbackMessages = fallbackLocale ? messages[fallbackLocale] : undefined;\n\n    return translate(currentMessages, key, params, fallbackMessages);\n  };\n\n  /**\n   * Reactive translation — returns a computed signal.\n   */\n  const tc = (key: string, params: TranslateParams = {}) => {\n    return computed(() => {\n      // Reading $locale.value creates a reactive dependency\n      const currentLocale = $locale.value;\n      const currentMessages = messages[currentLocale];\n      const fallbackMessages = fallbackLocale ? messages[fallbackLocale] : undefined;\n\n      return translate(currentMessages, key, params, fallbackMessages);\n    });\n  };\n\n  /**\n   * Format a number with the current (or overridden) locale.\n   */\n  const n = (value: number, options?: NumberFormatOptions): string => {\n    const loc = options?.locale ?? $locale.value;\n    return formatNumber(value, loc, options);\n  };\n\n  /**\n   * Format a date with the current (or overridden) locale.\n   */\n  const d = (value: Date | number, options?: DateFormatOptions): string => {\n    const loc = options?.locale ?? $locale.value;\n    return formatDate(value, loc, options);\n  };\n\n  /**\n   * Merge additional messages into a locale.\n   */\n  const mergeMessages = (loc: string, newMessages: LocaleMessages): void => {\n    if (isPrototypePollutionKey(loc)) {\n      return;\n    }\n    if (!messages[loc]) {\n      messages[loc] = Object.create(null) as LocaleMessages;\n      loadedLocales.add(loc);\n    }\n    messages[loc] = deepMerge(messages[loc], sanitizeLocaleMessages(newMessages));\n  };\n\n  /**\n   * List all available locales (loaded + registered loaders).\n   */\n  const availableLocales = (): string[] => {\n    const locales = new Set<string>([...loadedLocales, ...loaders.keys()]);\n    return Array.from(locales).sort();\n  };\n\n  return {\n    $locale,\n    t,\n    tc,\n    loadLocale,\n    ensureLocale,\n    n,\n    d,\n    getMessages,\n    mergeMessages,\n    availableLocales,\n  };\n};\n"],"mappings":"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"}
+{"version":3,"file":"i18n--p7PM-9r.js","names":[],"sources":["../src/i18n/formatting.ts","../src/i18n/translate.ts","../src/i18n/i18n.ts"],"sourcesContent":["/**\n * Number and date formatting helpers using Intl APIs.\n * @module bquery/i18n\n */\n\nimport type { DateFormatOptions, NumberFormatOptions } from './types';\n\n/**\n * Formats a number using the Intl.NumberFormat API.\n *\n * @param value - The number to format\n * @param locale - The locale code (e.g. 'en-US', 'de-DE')\n * @param options - Intl.NumberFormat options\n * @returns The formatted number string\n *\n * @example\n * ```ts\n * formatNumber(1234.56, 'en-US'); // '1,234.56'\n * formatNumber(1234.56, 'de-DE'); // '1.234,56'\n * formatNumber(0.42, 'en-US', { style: 'percent' }); // '42%'\n * formatNumber(9.99, 'en-US', { style: 'currency', currency: 'USD' }); // '$9.99'\n * ```\n */\nexport const formatNumber = (\n  value: number,\n  locale: string,\n  options?: NumberFormatOptions\n): string => {\n  const { locale: _ignored, ...intlOptions } = options ?? {};\n  try {\n    return new Intl.NumberFormat(locale, intlOptions).format(value);\n  } catch {\n    // Fall back to basic toString on Intl errors\n    return String(value);\n  }\n};\n\n/**\n * Formats a date using the Intl.DateTimeFormat API.\n *\n * @param value - The date to format (Date object or timestamp)\n * @param locale - The locale code\n * @param options - Intl.DateTimeFormat options\n * @returns The formatted date string\n *\n * @example\n * ```ts\n * const date = new Date('2026-03-26');\n * formatDate(date, 'en-US'); // '3/26/2026'\n * formatDate(date, 'de-DE'); // '26.3.2026'\n * formatDate(date, 'en-US', { dateStyle: 'long' }); // 'March 26, 2026'\n * ```\n */\nexport const formatDate = (\n  value: Date | number,\n  locale: string,\n  options?: DateFormatOptions\n): string => {\n  const { locale: _ignored, ...intlOptions } = options ?? {};\n  const date = typeof value === 'number' ? new Date(value) : value;\n  try {\n    return new Intl.DateTimeFormat(locale, intlOptions).format(date);\n  } catch {\n    // Fall back to toLocaleString on Intl errors\n    return date.toLocaleString();\n  }\n};\n","/**\n * Translation resolution helpers.\n * @module bquery/i18n\n * @internal\n */\n\nimport { isPlainObject, isPrototypePollutionKey, merge } from '../core/utils/object';\nimport type { LocaleMessages, TranslateParams } from './types';\n\n/**\n * Resolves a dot-delimited key path against a messages object.\n *\n * @param messages - The locale messages\n * @param key - Dot-delimited key (e.g. 'user.welcome')\n * @returns The resolved string, or `undefined` if not found\n *\n * @internal\n */\nexport const resolveKey = (messages: LocaleMessages, key: string): string | undefined => {\n  const parts = key.split('.');\n  let current: LocaleMessages | string = messages;\n\n  for (const part of parts) {\n    if (typeof current === 'string') return undefined;\n    if (current[part] === undefined) return undefined;\n    current = current[part];\n  }\n\n  return typeof current === 'string' ? current : undefined;\n};\n\n/**\n * Interpolates `{param}` placeholders in a string.\n *\n * @param template - The template string with `{key}` placeholders\n * @param params - Key-value pairs for replacement\n * @returns The interpolated string\n *\n * @example\n * ```ts\n * interpolate('Hello, {name}!', { name: 'Ada' });\n * // → 'Hello, Ada!'\n * ```\n *\n * @internal\n */\nexport const interpolate = (template: string, params: TranslateParams): string => {\n  return template.replace(/\\{(\\w+)\\}/g, (match, key: string) => {\n    if (key in params) {\n      return String(params[key]);\n    }\n    return match; // Leave unmatched placeholders as-is\n  });\n};\n\n/**\n * Selects the correct plural form from a pipe-delimited string.\n *\n * Supports two formats:\n * - **Two forms:** `\"singular | plural\"` — singular when count === 1\n * - **Three forms:** `\"zero | one | many\"` — zero when count === 0,\n *   one when count === 1, many otherwise\n *\n * The `count` parameter must be present in `params` for pluralization.\n * If no `count` param exists or the string has no pipes, the string is\n * returned as-is.\n *\n * @param template - Pipe-delimited plural forms\n * @param params - Must include a `count` key for plural selection\n * @returns The selected form\n *\n * @example\n * ```ts\n * pluralize('{count} item | {count} items', { count: 1 });\n * // → '{count} item'\n *\n * pluralize('no items | {count} item | {count} items', { count: 0 });\n * // → 'no items'\n * ```\n *\n * @internal\n */\nexport const pluralize = (template: string, params: TranslateParams): string => {\n  if (!template.includes('|')) return template;\n  if (!('count' in params)) return template;\n\n  const count = Number(params.count);\n  const forms = template.split('|').map((s) => s.trim());\n\n  if (forms.length === 3) {\n    // zero | one | many\n    if (count === 0) return forms[0];\n    if (count === 1) return forms[1];\n    return forms[2];\n  }\n\n  if (forms.length === 2) {\n    // singular | plural\n    return count === 1 ? forms[0] : forms[1];\n  }\n\n  // More than 3 forms: use last form for \"many\"\n  if (count === 0 && forms.length > 0) return forms[0];\n  if (count === 1 && forms.length > 1) return forms[1];\n  return forms[forms.length - 1];\n};\n\n/**\n * Full translation pipeline: resolve → pluralize → interpolate.\n *\n * @param messages - Locale messages\n * @param key - Dot-delimited key path\n * @param params - Interpolation + pluralization params\n * @param fallbackMessages - Optional fallback locale messages\n * @returns The translated string, or the key if not found\n *\n * @internal\n */\nexport const translate = (\n  messages: LocaleMessages | undefined,\n  key: string,\n  params: TranslateParams,\n  fallbackMessages?: LocaleMessages\n): string => {\n  let template: string | undefined;\n\n  // Try current locale\n  if (messages) {\n    template = resolveKey(messages, key);\n  }\n\n  // Fallback locale\n  if (template === undefined && fallbackMessages) {\n    template = resolveKey(fallbackMessages, key);\n  }\n\n  // Key not found — return key as-is\n  if (template === undefined) {\n    return key;\n  }\n\n  // Pluralize first, then interpolate\n  const pluralized = pluralize(template, params);\n  return interpolate(pluralized, params);\n};\n\n/**\n * Deep merges source into target and returns a sanitized, prototype-safe copy.\n *\n * @param target - Target messages object\n * @param source - Source messages to merge\n * @returns A new merged, sanitized messages object\n *\n * @internal\n */\nexport const deepMerge = (target: LocaleMessages, source: LocaleMessages): LocaleMessages => {\n  const merged = merge(\n    target as Record<string, unknown>,\n    source as Record<string, unknown>\n  ) as LocaleMessages;\n\n  const cloneSafeMessages = (value: unknown): unknown => {\n    if (Array.isArray(value)) {\n      return value.map((entry) => cloneSafeMessages(entry));\n    }\n\n    if (!isPlainObject(value)) {\n      return value;\n    }\n\n    const safeObject = Object.create(null) as Record<string, unknown>;\n    for (const [key, entry] of Object.entries(value)) {\n      if (isPrototypePollutionKey(key)) {\n        continue;\n      }\n      safeObject[key] = cloneSafeMessages(entry);\n    }\n    return safeObject;\n  };\n\n  return cloneSafeMessages(merged) as LocaleMessages;\n};\n","/**\n * Core i18n factory function.\n * @module bquery/i18n\n */\n\nimport { computed, signal } from '../reactive/index';\nimport { isPrototypePollutionKey } from '../core/utils/object';\nimport { formatDate, formatNumber } from './formatting';\nimport { deepMerge, translate } from './translate';\nimport type {\n  DateFormatOptions,\n  I18nConfig,\n  I18nInstance,\n  LocaleLoader,\n  LocaleMessages,\n  Messages,\n  NumberFormatOptions,\n  TranslateParams,\n} from './types';\n\n/**\n * Creates a reactive internationalization instance.\n *\n * The returned object provides:\n * - `$locale` — a reactive signal for the current locale\n * - `t()` — translation with interpolation and pluralization\n * - `tc()` — reactive translation that auto-updates on locale change\n * - `loadLocale()` — register lazy-loaded locale files\n * - `n()` — locale-aware number formatting\n * - `d()` — locale-aware date formatting\n *\n * @param config - Initial configuration\n * @returns An i18n instance\n *\n * @example\n * ```ts\n * import { createI18n } from '@bquery/bquery/i18n';\n *\n * const i18n = createI18n({\n *   locale: 'en',\n *   fallbackLocale: 'en',\n *   messages: {\n *     en: {\n *       greeting: 'Hello, {name}!',\n *       items: '{count} item | {count} items',\n *     },\n *     de: {\n *       greeting: 'Hallo, {name}!',\n *       items: '{count} Gegenstand | {count} Gegenstände',\n *     },\n *   },\n * });\n *\n * i18n.t('greeting', { name: 'Ada' }); // 'Hello, Ada!'\n * i18n.t('items', { count: 3 });       // '3 items'\n *\n * // Switch locale reactively\n * i18n.$locale.value = 'de';\n * i18n.t('greeting', { name: 'Ada' }); // 'Hallo, Ada!'\n * ```\n */\nexport const createI18n = (config: I18nConfig): I18nInstance => {\n  const { locale: initialLocale, messages: initialMessages, fallbackLocale } = config;\n\n  const sanitizeLocaleMessages = (localeMessages: LocaleMessages): LocaleMessages =>\n    deepMerge(Object.create(null) as LocaleMessages, localeMessages);\n\n  // Deep-clone initial messages to prevent external mutation\n  const messages = Object.create(null) as Messages;\n  for (const [loc, msgs] of Object.entries(initialMessages)) {\n    if (isPrototypePollutionKey(loc)) {\n      continue;\n    }\n    messages[loc] = sanitizeLocaleMessages(msgs);\n  }\n\n  // Reactive locale signal\n  const $locale = signal(initialLocale);\n\n  // Lazy-loader registry\n  const loaders = new Map<string, LocaleLoader>();\n\n  // Track which loaders have been invoked to avoid duplicate loads\n  const loadedLocales = new Set<string>(Object.keys(messages));\n\n  /**\n   * Get messages for a locale, or undefined if not loaded.\n   */\n  const getMessages = (loc: string): LocaleMessages | undefined => {\n    if (isPrototypePollutionKey(loc)) {\n      return undefined;\n    }\n    return messages[loc];\n  };\n\n  /**\n   * Register a lazy-loader for a locale.\n   */\n  const loadLocale = (loc: string, loader: LocaleLoader): void => {\n    if (isPrototypePollutionKey(loc)) {\n      return;\n    }\n    loaders.set(loc, loader);\n  };\n\n  /**\n   * Ensure a locale's messages are loaded.\n   */\n  const ensureLocale = async (loc: string): Promise<void> => {\n    if (isPrototypePollutionKey(loc)) return;\n    if (loadedLocales.has(loc)) return;\n\n    const loader = loaders.get(loc);\n    if (!loader) {\n      throw new Error(`bQuery i18n: No messages or loader registered for locale \"${loc}\".`);\n    }\n\n    const loaded = await loader();\n    // Handle both default exports and direct objects\n    const msgs = (loaded as { default?: LocaleMessages }).default ?? (loaded as LocaleMessages);\n    messages[loc] = sanitizeLocaleMessages(msgs);\n    loadedLocales.add(loc);\n  };\n\n  /**\n   * Translate a key path.\n   */\n  const t = (key: string, params: TranslateParams = {}): string => {\n    const currentLocale = $locale.value;\n    const currentMessages = messages[currentLocale];\n    const fallbackMessages = fallbackLocale ? messages[fallbackLocale] : undefined;\n\n    return translate(currentMessages, key, params, fallbackMessages);\n  };\n\n  /**\n   * Reactive translation — returns a computed signal.\n   */\n  const tc = (key: string, params: TranslateParams = {}) => {\n    return computed(() => {\n      // Reading $locale.value creates a reactive dependency\n      const currentLocale = $locale.value;\n      const currentMessages = messages[currentLocale];\n      const fallbackMessages = fallbackLocale ? messages[fallbackLocale] : undefined;\n\n      return translate(currentMessages, key, params, fallbackMessages);\n    });\n  };\n\n  /**\n   * Format a number with the current (or overridden) locale.\n   */\n  const n = (value: number, options?: NumberFormatOptions): string => {\n    const loc = options?.locale ?? $locale.value;\n    return formatNumber(value, loc, options);\n  };\n\n  /**\n   * Format a date with the current (or overridden) locale.\n   */\n  const d = (value: Date | number, options?: DateFormatOptions): string => {\n    const loc = options?.locale ?? $locale.value;\n    return formatDate(value, loc, options);\n  };\n\n  /**\n   * Merge additional messages into a locale.\n   */\n  const mergeMessages = (loc: string, newMessages: LocaleMessages): void => {\n    if (isPrototypePollutionKey(loc)) {\n      return;\n    }\n    if (!messages[loc]) {\n      messages[loc] = Object.create(null) as LocaleMessages;\n      loadedLocales.add(loc);\n    }\n    messages[loc] = deepMerge(messages[loc], sanitizeLocaleMessages(newMessages));\n  };\n\n  /**\n   * List all available locales (loaded + registered loaders).\n   */\n  const availableLocales = (): string[] => {\n    const locales = new Set<string>([...loadedLocales, ...loaders.keys()]);\n    return Array.from(locales).sort();\n  };\n\n  return {\n    $locale,\n    t,\n    tc,\n    loadLocale,\n    ensureLocale,\n    n,\n    d,\n    getMessages,\n    mergeMessages,\n    availableLocales,\n  };\n};\n"],"mappings":"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"}

package/dist/i18n.es.mjs

@@ -1,4 +1,4 @@
-import { n as a, r as t, t as e } from "./i18n-kuF6Ekj6.js";
+import { n as a, r as t, t as e } from "./i18n--p7PM-9r.js";
 export {
   e as createI18n,
   a as formatDate,

package/dist/index.d.ts

@@ -9,6 +9,7 @@
  */
 export * from './core/index';
 export * from './reactive/index';
+export * from './concurrency/index';
 export * from './component/index';
 export * from './motion/index';
 export * from './security/index';
@@ -27,4 +28,5 @@ export * from './devtools/index';
 export { renderComponent, flushEffects, mockSignal, mockRouter, fireEvent, waitFor, } from './testing/index';
 export type { FireEventOptions, MockRouter, MockRouterOptions, MockSignal, RenderComponentOptions, RenderResult, TestRoute, WaitForOptions, } from './testing/index';
 export * from './ssr/index';
+export * from './server/index';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,cAAc,cAAc,CAAC;AAG7B,cAAc,kBAAkB,CAAC;AAGjC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,kBAAkB,CAAC;AAGjC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,eAAe,CAAC;AAG9B,cAAc,cAAc,CAAC;AAG7B,cAAc,eAAe,CAAC;AAG9B,cAAc,cAAc,CAAC;AAM7B,OAAO,EACL,sBAAsB,EACtB,SAAS,EACT,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,cAAc,EACd,QAAQ,EACR,SAAS,GACV,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,aAAa,EACb,WAAW,EACX,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAGtB,cAAc,aAAa,CAAC;AAG5B,cAAc,eAAe,CAAC;AAG9B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EACL,eAAe,EACf,YAAY,EACZ,UAAU,EACV,UAAU,EACV,SAAS,EACT,OAAO,GACR,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,gBAAgB,EAChB,UAAU,EACV,iBAAiB,EACjB,UAAU,EACV,sBAAsB,EACtB,YAAY,EACZ,SAAS,EACT,cAAc,GACf,MAAM,iBAAiB,CAAC;AAGzB,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,cAAc,cAAc,CAAC;AAG7B,cAAc,kBAAkB,CAAC;AAGjC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,kBAAkB,CAAC;AAGjC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,eAAe,CAAC;AAG9B,cAAc,cAAc,CAAC;AAG7B,cAAc,eAAe,CAAC;AAG9B,cAAc,cAAc,CAAC;AAM7B,OAAO,EACL,sBAAsB,EACtB,SAAS,EACT,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,cAAc,EACd,QAAQ,EACR,SAAS,GACV,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,aAAa,EACb,WAAW,EACX,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAGtB,cAAc,aAAa,CAAC;AAG5B,cAAc,eAAe,CAAC;AAG9B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EACL,eAAe,EACf,YAAY,EACZ,UAAU,EACV,UAAU,EACV,SAAS,EACT,OAAO,GACR,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,gBAAgB,EAChB,UAAU,EACV,iBAAiB,EACjB,UAAU,EACV,sBAAsB,EACtB,YAAY,EACZ,SAAS,EACT,cAAc,GACf,MAAM,iBAAiB,CAAC;AAGzB,cAAc,aAAa,CAAC;AAG5B,cAAc,gBAAgB,CAAC"}