@bquery/bquery 1.7.0 → 1.8.1

package/src/i18n/formatting.ts

@@ -1,67 +1,67 @@
-/**
- * Number and date formatting helpers using Intl APIs.
- * @module bquery/i18n
- */
-
-import type { DateFormatOptions, NumberFormatOptions } from './types';
-
-/**
- * Formats a number using the Intl.NumberFormat API.
- *
- * @param value - The number to format
- * @param locale - The locale code (e.g. 'en-US', 'de-DE')
- * @param options - Intl.NumberFormat options
- * @returns The formatted number string
- *
- * @example
- * ```ts
- * formatNumber(1234.56, 'en-US'); // '1,234.56'
- * formatNumber(1234.56, 'de-DE'); // '1.234,56'
- * formatNumber(0.42, 'en-US', { style: 'percent' }); // '42%'
- * formatNumber(9.99, 'en-US', { style: 'currency', currency: 'USD' }); // '$9.99'
- * ```
- */
-export const formatNumber = (
-  value: number,
-  locale: string,
-  options?: NumberFormatOptions
-): string => {
-  const { locale: _ignored, ...intlOptions } = options ?? {};
-  try {
-    return new Intl.NumberFormat(locale, intlOptions).format(value);
-  } catch {
-    // Fall back to basic toString on Intl errors
-    return String(value);
-  }
-};
-
-/**
- * Formats a date using the Intl.DateTimeFormat API.
- *
- * @param value - The date to format (Date object or timestamp)
- * @param locale - The locale code
- * @param options - Intl.DateTimeFormat options
- * @returns The formatted date string
- *
- * @example
- * ```ts
- * const date = new Date('2026-03-26');
- * formatDate(date, 'en-US'); // '3/26/2026'
- * formatDate(date, 'de-DE'); // '26.3.2026'
- * formatDate(date, 'en-US', { dateStyle: 'long' }); // 'March 26, 2026'
- * ```
- */
-export const formatDate = (
-  value: Date | number,
-  locale: string,
-  options?: DateFormatOptions
-): string => {
-  const { locale: _ignored, ...intlOptions } = options ?? {};
-  const date = typeof value === 'number' ? new Date(value) : value;
-  try {
-    return new Intl.DateTimeFormat(locale, intlOptions).format(date);
-  } catch {
-    // Fall back to toLocaleString on Intl errors
-    return date.toLocaleString();
-  }
-};
+/**
+ * Number and date formatting helpers using Intl APIs.
+ * @module bquery/i18n
+ */
+
+import type { DateFormatOptions, NumberFormatOptions } from './types';
+
+/**
+ * Formats a number using the Intl.NumberFormat API.
+ *
+ * @param value - The number to format
+ * @param locale - The locale code (e.g. 'en-US', 'de-DE')
+ * @param options - Intl.NumberFormat options
+ * @returns The formatted number string
+ *
+ * @example
+ * ```ts
+ * formatNumber(1234.56, 'en-US'); // '1,234.56'
+ * formatNumber(1234.56, 'de-DE'); // '1.234,56'
+ * formatNumber(0.42, 'en-US', { style: 'percent' }); // '42%'
+ * formatNumber(9.99, 'en-US', { style: 'currency', currency: 'USD' }); // '$9.99'
+ * ```
+ */
+export const formatNumber = (
+  value: number,
+  locale: string,
+  options?: NumberFormatOptions
+): string => {
+  const { locale: _ignored, ...intlOptions } = options ?? {};
+  try {
+    return new Intl.NumberFormat(locale, intlOptions).format(value);
+  } catch {
+    // Fall back to basic toString on Intl errors
+    return String(value);
+  }
+};
+
+/**
+ * Formats a date using the Intl.DateTimeFormat API.
+ *
+ * @param value - The date to format (Date object or timestamp)
+ * @param locale - The locale code
+ * @param options - Intl.DateTimeFormat options
+ * @returns The formatted date string
+ *
+ * @example
+ * ```ts
+ * const date = new Date('2026-03-26');
+ * formatDate(date, 'en-US'); // '3/26/2026'
+ * formatDate(date, 'de-DE'); // '26.3.2026'
+ * formatDate(date, 'en-US', { dateStyle: 'long' }); // 'March 26, 2026'
+ * ```
+ */
+export const formatDate = (
+  value: Date | number,
+  locale: string,
+  options?: DateFormatOptions
+): string => {
+  const { locale: _ignored, ...intlOptions } = options ?? {};
+  const date = typeof value === 'number' ? new Date(value) : value;
+  try {
+    return new Intl.DateTimeFormat(locale, intlOptions).format(date);
+  } catch {
+    // Fall back to toLocaleString on Intl errors
+    return date.toLocaleString();
+  }
+};

package/src/i18n/i18n.ts

@@ -1,200 +1,200 @@
-/**
- * Core i18n factory function.
- * @module bquery/i18n
- */
-
-import { computed, signal } from '../reactive/index';
-import { isPrototypePollutionKey } from '../core/utils/object';
-import { formatDate, formatNumber } from './formatting';
-import { deepMerge, translate } from './translate';
-import type {
-  DateFormatOptions,
-  I18nConfig,
-  I18nInstance,
-  LocaleLoader,
-  LocaleMessages,
-  Messages,
-  NumberFormatOptions,
-  TranslateParams,
-} from './types';
-
-/**
- * Creates a reactive internationalization instance.
- *
- * The returned object provides:
- * - `$locale` — a reactive signal for the current locale
- * - `t()` — translation with interpolation and pluralization
- * - `tc()` — reactive translation that auto-updates on locale change
- * - `loadLocale()` — register lazy-loaded locale files
- * - `n()` — locale-aware number formatting
- * - `d()` — locale-aware date formatting
- *
- * @param config - Initial configuration
- * @returns An i18n instance
- *
- * @example
- * ```ts
- * import { createI18n } from '@bquery/bquery/i18n';
- *
- * const i18n = createI18n({
- *   locale: 'en',
- *   fallbackLocale: 'en',
- *   messages: {
- *     en: {
- *       greeting: 'Hello, {name}!',
- *       items: '{count} item | {count} items',
- *     },
- *     de: {
- *       greeting: 'Hallo, {name}!',
- *       items: '{count} Gegenstand | {count} Gegenstände',
- *     },
- *   },
- * });
- *
- * i18n.t('greeting', { name: 'Ada' }); // 'Hello, Ada!'
- * i18n.t('items', { count: 3 });       // '3 items'
- *
- * // Switch locale reactively
- * i18n.$locale.value = 'de';
- * i18n.t('greeting', { name: 'Ada' }); // 'Hallo, Ada!'
- * ```
- */
-export const createI18n = (config: I18nConfig): I18nInstance => {
-  const { locale: initialLocale, messages: initialMessages, fallbackLocale } = config;
-
-  const sanitizeLocaleMessages = (localeMessages: LocaleMessages): LocaleMessages =>
-    deepMerge(Object.create(null) as LocaleMessages, localeMessages);
-
-  // Deep-clone initial messages to prevent external mutation
-  const messages = Object.create(null) as Messages;
-  for (const [loc, msgs] of Object.entries(initialMessages)) {
-    if (isPrototypePollutionKey(loc)) {
-      continue;
-    }
-    messages[loc] = sanitizeLocaleMessages(msgs);
-  }
-
-  // Reactive locale signal
-  const $locale = signal(initialLocale);
-
-  // Lazy-loader registry
-  const loaders = new Map<string, LocaleLoader>();
-
-  // Track which loaders have been invoked to avoid duplicate loads
-  const loadedLocales = new Set<string>(Object.keys(messages));
-
-  /**
-   * Get messages for a locale, or undefined if not loaded.
-   */
-  const getMessages = (loc: string): LocaleMessages | undefined => {
-    if (isPrototypePollutionKey(loc)) {
-      return undefined;
-    }
-    return messages[loc];
-  };
-
-  /**
-   * Register a lazy-loader for a locale.
-   */
-  const loadLocale = (loc: string, loader: LocaleLoader): void => {
-    if (isPrototypePollutionKey(loc)) {
-      return;
-    }
-    loaders.set(loc, loader);
-  };
-
-  /**
-   * Ensure a locale's messages are loaded.
-   */
-  const ensureLocale = async (loc: string): Promise<void> => {
-    if (isPrototypePollutionKey(loc)) return;
-    if (loadedLocales.has(loc)) return;
-
-    const loader = loaders.get(loc);
-    if (!loader) {
-      throw new Error(`bQuery i18n: No messages or loader registered for locale "${loc}".`);
-    }
-
-    const loaded = await loader();
-    // Handle both default exports and direct objects
-    const msgs = (loaded as { default?: LocaleMessages }).default ?? (loaded as LocaleMessages);
-    messages[loc] = sanitizeLocaleMessages(msgs);
-    loadedLocales.add(loc);
-  };
-
-  /**
-   * Translate a key path.
-   */
-  const t = (key: string, params: TranslateParams = {}): string => {
-    const currentLocale = $locale.value;
-    const currentMessages = messages[currentLocale];
-    const fallbackMessages = fallbackLocale ? messages[fallbackLocale] : undefined;
-
-    return translate(currentMessages, key, params, fallbackMessages);
-  };
-
-  /**
-   * Reactive translation — returns a computed signal.
-   */
-  const tc = (key: string, params: TranslateParams = {}) => {
-    return computed(() => {
-      // Reading $locale.value creates a reactive dependency
-      const currentLocale = $locale.value;
-      const currentMessages = messages[currentLocale];
-      const fallbackMessages = fallbackLocale ? messages[fallbackLocale] : undefined;
-
-      return translate(currentMessages, key, params, fallbackMessages);
-    });
-  };
-
-  /**
-   * Format a number with the current (or overridden) locale.
-   */
-  const n = (value: number, options?: NumberFormatOptions): string => {
-    const loc = options?.locale ?? $locale.value;
-    return formatNumber(value, loc, options);
-  };
-
-  /**
-   * Format a date with the current (or overridden) locale.
-   */
-  const d = (value: Date | number, options?: DateFormatOptions): string => {
-    const loc = options?.locale ?? $locale.value;
-    return formatDate(value, loc, options);
-  };
-
-  /**
-   * Merge additional messages into a locale.
-   */
-  const mergeMessages = (loc: string, newMessages: LocaleMessages): void => {
-    if (isPrototypePollutionKey(loc)) {
-      return;
-    }
-    if (!messages[loc]) {
-      messages[loc] = Object.create(null) as LocaleMessages;
-      loadedLocales.add(loc);
-    }
-    messages[loc] = deepMerge(messages[loc], sanitizeLocaleMessages(newMessages));
-  };
-
-  /**
-   * List all available locales (loaded + registered loaders).
-   */
-  const availableLocales = (): string[] => {
-    const locales = new Set<string>([...loadedLocales, ...loaders.keys()]);
-    return Array.from(locales).sort();
-  };
-
-  return {
-    $locale,
-    t,
-    tc,
-    loadLocale,
-    ensureLocale,
-    n,
-    d,
-    getMessages,
-    mergeMessages,
-    availableLocales,
-  };
-};
+/**
+ * Core i18n factory function.
+ * @module bquery/i18n
+ */
+
+import { computed, signal } from '../reactive/index';
+import { isPrototypePollutionKey } from '../core/utils/object';
+import { formatDate, formatNumber } from './formatting';
+import { deepMerge, translate } from './translate';
+import type {
+  DateFormatOptions,
+  I18nConfig,
+  I18nInstance,
+  LocaleLoader,
+  LocaleMessages,
+  Messages,
+  NumberFormatOptions,
+  TranslateParams,
+} from './types';
+
+/**
+ * Creates a reactive internationalization instance.
+ *
+ * The returned object provides:
+ * - `$locale` — a reactive signal for the current locale
+ * - `t()` — translation with interpolation and pluralization
+ * - `tc()` — reactive translation that auto-updates on locale change
+ * - `loadLocale()` — register lazy-loaded locale files
+ * - `n()` — locale-aware number formatting
+ * - `d()` — locale-aware date formatting
+ *
+ * @param config - Initial configuration
+ * @returns An i18n instance
+ *
+ * @example
+ * ```ts
+ * import { createI18n } from '@bquery/bquery/i18n';
+ *
+ * const i18n = createI18n({
+ *   locale: 'en',
+ *   fallbackLocale: 'en',
+ *   messages: {
+ *     en: {
+ *       greeting: 'Hello, {name}!',
+ *       items: '{count} item | {count} items',
+ *     },
+ *     de: {
+ *       greeting: 'Hallo, {name}!',
+ *       items: '{count} Gegenstand | {count} Gegenstände',
+ *     },
+ *   },
+ * });
+ *
+ * i18n.t('greeting', { name: 'Ada' }); // 'Hello, Ada!'
+ * i18n.t('items', { count: 3 });       // '3 items'
+ *
+ * // Switch locale reactively
+ * i18n.$locale.value = 'de';
+ * i18n.t('greeting', { name: 'Ada' }); // 'Hallo, Ada!'
+ * ```
+ */
+export const createI18n = (config: I18nConfig): I18nInstance => {
+  const { locale: initialLocale, messages: initialMessages, fallbackLocale } = config;
+
+  const sanitizeLocaleMessages = (localeMessages: LocaleMessages): LocaleMessages =>
+    deepMerge(Object.create(null) as LocaleMessages, localeMessages);
+
+  // Deep-clone initial messages to prevent external mutation
+  const messages = Object.create(null) as Messages;
+  for (const [loc, msgs] of Object.entries(initialMessages)) {
+    if (isPrototypePollutionKey(loc)) {
+      continue;
+    }
+    messages[loc] = sanitizeLocaleMessages(msgs);
+  }
+
+  // Reactive locale signal
+  const $locale = signal(initialLocale);
+
+  // Lazy-loader registry
+  const loaders = new Map<string, LocaleLoader>();
+
+  // Track which loaders have been invoked to avoid duplicate loads
+  const loadedLocales = new Set<string>(Object.keys(messages));
+
+  /**
+   * Get messages for a locale, or undefined if not loaded.
+   */
+  const getMessages = (loc: string): LocaleMessages | undefined => {
+    if (isPrototypePollutionKey(loc)) {
+      return undefined;
+    }
+    return messages[loc];
+  };
+
+  /**
+   * Register a lazy-loader for a locale.
+   */
+  const loadLocale = (loc: string, loader: LocaleLoader): void => {
+    if (isPrototypePollutionKey(loc)) {
+      return;
+    }
+    loaders.set(loc, loader);
+  };
+
+  /**
+   * Ensure a locale's messages are loaded.
+   */
+  const ensureLocale = async (loc: string): Promise<void> => {
+    if (isPrototypePollutionKey(loc)) return;
+    if (loadedLocales.has(loc)) return;
+
+    const loader = loaders.get(loc);
+    if (!loader) {
+      throw new Error(`bQuery i18n: No messages or loader registered for locale "${loc}".`);
+    }
+
+    const loaded = await loader();
+    // Handle both default exports and direct objects
+    const msgs = (loaded as { default?: LocaleMessages }).default ?? (loaded as LocaleMessages);
+    messages[loc] = sanitizeLocaleMessages(msgs);
+    loadedLocales.add(loc);
+  };
+
+  /**
+   * Translate a key path.
+   */
+  const t = (key: string, params: TranslateParams = {}): string => {
+    const currentLocale = $locale.value;
+    const currentMessages = messages[currentLocale];
+    const fallbackMessages = fallbackLocale ? messages[fallbackLocale] : undefined;
+
+    return translate(currentMessages, key, params, fallbackMessages);
+  };
+
+  /**
+   * Reactive translation — returns a computed signal.
+   */
+  const tc = (key: string, params: TranslateParams = {}) => {
+    return computed(() => {
+      // Reading $locale.value creates a reactive dependency
+      const currentLocale = $locale.value;
+      const currentMessages = messages[currentLocale];
+      const fallbackMessages = fallbackLocale ? messages[fallbackLocale] : undefined;
+
+      return translate(currentMessages, key, params, fallbackMessages);
+    });
+  };
+
+  /**
+   * Format a number with the current (or overridden) locale.
+   */
+  const n = (value: number, options?: NumberFormatOptions): string => {
+    const loc = options?.locale ?? $locale.value;
+    return formatNumber(value, loc, options);
+  };
+
+  /**
+   * Format a date with the current (or overridden) locale.
+   */
+  const d = (value: Date | number, options?: DateFormatOptions): string => {
+    const loc = options?.locale ?? $locale.value;
+    return formatDate(value, loc, options);
+  };
+
+  /**
+   * Merge additional messages into a locale.
+   */
+  const mergeMessages = (loc: string, newMessages: LocaleMessages): void => {
+    if (isPrototypePollutionKey(loc)) {
+      return;
+    }
+    if (!messages[loc]) {
+      messages[loc] = Object.create(null) as LocaleMessages;
+      loadedLocales.add(loc);
+    }
+    messages[loc] = deepMerge(messages[loc], sanitizeLocaleMessages(newMessages));
+  };
+
+  /**
+   * List all available locales (loaded + registered loaders).
+   */
+  const availableLocales = (): string[] => {
+    const locales = new Set<string>([...loadedLocales, ...loaders.keys()]);
+    return Array.from(locales).sort();
+  };
+
+  return {
+    $locale,
+    t,
+    tc,
+    loadLocale,
+    ensureLocale,
+    n,
+    d,
+    getMessages,
+    mergeMessages,
+    availableLocales,
+  };
+};

package/src/i18n/index.ts

@@ -1,67 +1,67 @@
-/**
- * Internationalization (i18n) module for bQuery.js.
- *
- * Provides a reactive, TypeScript-first internationalization API
- * with interpolation, pluralization, lazy-loading, and locale-aware
- * formatting — all backed by bQuery's signal-based reactivity system.
- *
- * @module bquery/i18n
- *
- * @example
- * ```ts
- * import { createI18n } from '@bquery/bquery/i18n';
- *
- * const i18n = createI18n({
- *   locale: 'en',
- *   fallbackLocale: 'en',
- *   messages: {
- *     en: {
- *       greeting: 'Hello, {name}!',
- *       items: '{count} item | {count} items',
- *       nested: { deep: { key: 'Found it!' } },
- *     },
- *     de: {
- *       greeting: 'Hallo, {name}!',
- *       items: '{count} Gegenstand | {count} Gegenstände',
- *     },
- *   },
- * });
- *
- * // Basic translation
- * i18n.t('greeting', { name: 'Ada' }); // 'Hello, Ada!'
- *
- * // Pluralization
- * i18n.t('items', { count: 1 }); // '1 item'
- * i18n.t('items', { count: 5 }); // '5 items'
- *
- * // Reactive translation (auto-updates on locale change)
- * const label = i18n.tc('greeting', { name: 'Ada' });
- * console.log(label.value); // 'Hello, Ada!'
- *
- * i18n.$locale.value = 'de';
- * console.log(label.value); // 'Hallo, Ada!'
- *
- * // Number & date formatting
- * i18n.n(1234.56);                              // '1,234.56' (en)
- * i18n.d(new Date(), { dateStyle: 'long' });     // 'March 26, 2026'
- *
- * // Lazy-load a locale
- * i18n.loadLocale('fr', () => import('./locales/fr.json'));
- * await i18n.ensureLocale('fr');
- * i18n.$locale.value = 'fr';
- * ```
- */
-
-export { createI18n } from './i18n';
-export { formatDate, formatNumber } from './formatting';
-
-export type {
-  DateFormatOptions,
-  I18nConfig,
-  I18nInstance,
-  LocaleLoader,
-  LocaleMessages,
-  Messages,
-  NumberFormatOptions,
-  TranslateParams,
-} from './types';
+/**
+ * Internationalization (i18n) module for bQuery.js.
+ *
+ * Provides a reactive, TypeScript-first internationalization API
+ * with interpolation, pluralization, lazy-loading, and locale-aware
+ * formatting — all backed by bQuery's signal-based reactivity system.
+ *
+ * @module bquery/i18n
+ *
+ * @example
+ * ```ts
+ * import { createI18n } from '@bquery/bquery/i18n';
+ *
+ * const i18n = createI18n({
+ *   locale: 'en',
+ *   fallbackLocale: 'en',
+ *   messages: {
+ *     en: {
+ *       greeting: 'Hello, {name}!',
+ *       items: '{count} item | {count} items',
+ *       nested: { deep: { key: 'Found it!' } },
+ *     },
+ *     de: {
+ *       greeting: 'Hallo, {name}!',
+ *       items: '{count} Gegenstand | {count} Gegenstände',
+ *     },
+ *   },
+ * });
+ *
+ * // Basic translation
+ * i18n.t('greeting', { name: 'Ada' }); // 'Hello, Ada!'
+ *
+ * // Pluralization
+ * i18n.t('items', { count: 1 }); // '1 item'
+ * i18n.t('items', { count: 5 }); // '5 items'
+ *
+ * // Reactive translation (auto-updates on locale change)
+ * const label = i18n.tc('greeting', { name: 'Ada' });
+ * console.log(label.value); // 'Hello, Ada!'
+ *
+ * i18n.$locale.value = 'de';
+ * console.log(label.value); // 'Hallo, Ada!'
+ *
+ * // Number & date formatting
+ * i18n.n(1234.56);                              // '1,234.56' (en)
+ * i18n.d(new Date(), { dateStyle: 'long' });     // 'March 26, 2026'
+ *
+ * // Lazy-load a locale
+ * i18n.loadLocale('fr', () => import('./locales/fr.json'));
+ * await i18n.ensureLocale('fr');
+ * i18n.$locale.value = 'fr';
+ * ```
+ */
+
+export { createI18n } from './i18n';
+export { formatDate, formatNumber } from './formatting';
+
+export type {
+  DateFormatOptions,
+  I18nConfig,
+  I18nInstance,
+  LocaleLoader,
+  LocaleMessages,
+  Messages,
+  NumberFormatOptions,
+  TranslateParams,
+} from './types';