@cocoar/vue-localization 0.1.0-beta.24 → 0.1.0-beta.34

package/dist/composables.d.ts

@@ -0,0 +1,54 @@
+import { ComputedRef, Ref } from 'vue';
+import { CoarLocalizationService } from './localization-service';
+import { CoarLocalizationData } from './types';
+/**
+ * Access the full localization service.
+ * Returns null if the localization plugin is not installed.
+ */
+export declare function useLocalization(): CoarLocalizationService | null;
+/**
+ * Reactive localization composable with formatting utilities.
+ * Provides reactive language, locale data, and formatting functions
+ * that automatically update when the language changes.
+ */
+export declare function useL10n(): {
+    /** Current language (reactive) */
+    language: Ref<string, string>;
+    /** Current locale data (reactive) */
+    localeData: ComputedRef<CoarLocalizationData | undefined>;
+    /** Format a number */
+    fmtNumber: (value: number, decimals?: number) => string;
+    /** Format a currency value */
+    fmtCurrency: (value: number, currencyCode?: string) => string;
+    /** Format a percentage (0.25 → "25%") */
+    fmtPercent: (value: number, decimals?: number) => string;
+    /** Format a date */
+    fmtDate: (value: Date | string, includeTime?: boolean) => string;
+};
+/**
+ * i18n composable for translations.
+ * Provides a reactive translation function.
+ */
+export declare function useI18n(): {
+    /** Current language (reactive) */
+    language: Readonly<Ref<string, string>>;
+    /**
+     * Translate a key. Returns the key if no translation found.
+     * Reactive — updates when language changes.
+     */
+    t: (key: string, params?: Record<string, unknown>, fallback?: string) => string;
+    /**
+     * Create a computed translation ref that reacts to language changes.
+     */
+    tRef: (key: string, params?: Record<string, unknown>, fallback?: string) => ComputedRef<string>;
+};
+/**
+ * Timezone composable.
+ */
+export declare function useTimezone(): {
+    /** Current timezone (reactive IANA identifier) */
+    timezone: Readonly<Ref<string, string>>;
+    /** Re-resolve timezone from providers */
+    refresh: () => void | undefined;
+};
+//# sourceMappingURL=composables.d.ts.map

package/dist/composables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composables.d.ts","sourceRoot":"","sources":["../src/composables.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,WAAW,EAAE,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAEnE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAGpD;;;GAGG;AACH,wBAAgB,eAAe,IAAI,uBAAuB,GAAG,IAAI,CAEhE;AAED;;;;GAIG;AACH,wBAAgB,OAAO;IAYnB,kCAAkC;;IAElC,qCAAqC;;IAErC,sBAAsB;uBACH,MAAM,aAAa,MAAM,KAAG,MAAM;IAKrD,8BAA8B;yBACT,MAAM,iBAAiB,MAAM,KAAG,MAAM;IAK3D,yCAAyC;wBACrB,MAAM,aAAa,MAAM,KAAG,MAAM;IAKtD,oBAAoB;qBACH,IAAI,GAAG,MAAM,4BAAwB,MAAM;EAM/D;AAED;;;GAGG;AACH,wBAAgB,OAAO;IAInB,kCAAkC;;IAGlC;;;OAGG;aACM,MAAM,WAAW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,MAAM,KAAG,MAAM;IAK7E;;OAEG;gBACS,MAAM,WAAW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,MAAM,KAAG,WAAW,CAAC,MAAM,CAAC;EAKhG;AAED;;GAEG;AACH,wBAAgB,WAAW;IAIvB,kDAAkD;;IAUlD,yCAAyC;;EAG5C"}

package/dist/i18n/interpolate.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Interpolate parameters into a translation string.
+ * Replaces {param} placeholders with values from the params object.
+ * Missing params are replaced with empty string (Angular-compatible behavior).
+ *
+ * @example
+ * interpolate('Hello, {name}!', { name: 'Alice' }) → 'Hello, Alice!'
+ * interpolate('{count} items', { count: 42 }) → '42 items'
+ * interpolate('Hello, {name}!', {}) → 'Hello, !'
+ */
+export declare function interpolate(template: string, params?: Record<string, unknown>): string;
+/**
+ * Check if a returned translation value is actually missing.
+ * Missing means: null, undefined, empty, whitespace-only, or equals the key itself.
+ */
+export declare function isMissingTranslation(key: string, value: string | null | undefined): boolean;
+//# sourceMappingURL=interpolate.d.ts.map

package/dist/i18n/interpolate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpolate.d.ts","sourceRoot":"","sources":["../../src/i18n/interpolate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,MAAM,CAOR;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAI3F"}

package/dist/i18n/intl-translation-source.d.ts

@@ -0,0 +1,16 @@
+import { CoarTranslationSource, CoarTranslations } from '../types';
+/**
+ * Generates common translations from browser Intl APIs.
+ * Always registered as the first translation source so HTTP translations can override.
+ *
+ * Generated keys:
+ * - common.today, common.yesterday, common.tomorrow (Intl.RelativeTimeFormat)
+ * - common.month.1–12 (full month names, 1=January)
+ * - common.month.short.1–12 (abbreviated month names)
+ * - common.weekday.1–7 (full day names, 1=Monday, 7=Sunday)
+ * - common.weekday.short.1–7 (abbreviated day names)
+ */
+export declare class IntlTranslationSource implements CoarTranslationSource {
+    load(language: string): Promise<CoarTranslations | null>;
+}
+//# sourceMappingURL=intl-translation-source.d.ts.map

package/dist/i18n/intl-translation-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intl-translation-source.d.ts","sourceRoot":"","sources":["../../src/i18n/intl-translation-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAExE;;;;;;;;;;GAUG;AACH,qBAAa,qBAAsB,YAAW,qBAAqB;IAC3D,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;CA0C/D"}

package/dist/i18n/translation-store.d.ts

@@ -0,0 +1,47 @@
+import { Ref, ComputedRef } from 'vue';
+import { CoarTranslations } from '../types';
+/**
+ * Reactive store for translations.
+ * Stores flat key-value maps per language, supports nested JSON flattening.
+ */
+export declare class CoarTranslationStore {
+    private readonly data;
+    private readonly _version;
+    /** Reactive version counter — use in computed() to react to changes */
+    readonly version: Readonly<Ref<number>>;
+    /** Reactive set of loaded language codes */
+    readonly loadedLanguages: ComputedRef<Set<string>>;
+    /**
+     * Set translations for a language. Replaces any existing translations.
+     * Nested objects are flattened to dot-separated keys.
+     */
+    setTranslations(language: string, translations: CoarTranslations): void;
+    /**
+     * Merge additional translations into existing ones for a language.
+     */
+    updateTranslations(language: string, translations: CoarTranslations): void;
+    /**
+     * Get a single translation by key.
+     */
+    getTranslation(language: string, key: string): string | undefined;
+    /**
+     * Get all translations for a language.
+     */
+    getTranslations(language: string): Map<string, string> | undefined;
+    /**
+     * Set a single translation.
+     */
+    setTranslation(language: string, key: string, value: string): void;
+    hasLanguage(language: string): boolean;
+    /**
+     * Remove all translations for a specific language.
+     */
+    clearLanguage(language: string): void;
+    /**
+     * Bump version to trigger reactivity without changing data.
+     * Useful after external data updates.
+     */
+    touch(): void;
+    clear(): void;
+}
+//# sourceMappingURL=translation-store.d.ts.map

package/dist/i18n/translation-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translation-store.d.ts","sourceRoot":"","sources":["../../src/i18n/translation-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,GAAG,EAAE,KAAK,WAAW,EAAE,MAAM,KAAK,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD;;;GAGG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA0C;IAC/D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;IAEnC,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAiB;IAExD,4CAA4C;IAC5C,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAG/C;IAEH;;;OAGG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,gBAAgB,GAAG,IAAI;IAOvE;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,gBAAgB,GAAG,IAAI;IAO1E;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAKjE;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS;IAKlE;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAUlE,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAKtC;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKrC;;;OAGG;IACH,KAAK,IAAI,IAAI;IAIb,KAAK,IAAI,IAAI;CAId"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export type { CoarLocalizationData, CoarDateFormatData, CoarNumberFormatData, CoarCurrencyFormatData, CoarPercentFormatData, CoarLocalizationConfig, CoarTimezoneProvider, CoarTranslations, CoarLocaleDataSource, CoarTranslationSource, } from './types';
+export { CoarLocalizationService } from './localization-service';
+export { CoarLocalizationDataStore } from './l10n/localization-data-store';
+export { IntlLocaleDataSource } from './l10n/intl-locale-data-source';
+export { mergeLocalizationData } from './l10n/merge-localization-data';
+export { formatNumber, formatCurrency, formatPercent, formatDate } from './l10n/formatters';
+export { CoarTranslationStore } from './i18n/translation-store';
+export { interpolate, isMissingTranslation } from './i18n/interpolate';
+export { IntlTranslationSource } from './i18n/intl-translation-source';
+export { CoarTimezoneService, BrowserTimezoneProvider } from './timezone/timezone-service';
+export { createCoarLocalization } from './plugin';
+export { COAR_LOCALIZATION_KEY } from './injection-keys';
+export { useLocalization, useL10n, useI18n, useTimezone } from './composables';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAGjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG5F,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAGvE,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAG3F,OAAO,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/injection-keys.d.ts

@@ -0,0 +1,9 @@
+import { InjectionKey } from 'vue';
+import { CoarLocalizationService } from './localization-service';
+/**
+ * Injection key for the localization service.
+ * Used by useLocalization(), useI18n(), and useTimezone() composables.
+ * Also used by vue-ui components for optional inject.
+ */
+export declare const COAR_LOCALIZATION_KEY: InjectionKey<CoarLocalizationService>;
+//# sourceMappingURL=injection-keys.d.ts.map

package/dist/injection-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"injection-keys.d.ts","sourceRoot":"","sources":["../src/injection-keys.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,KAAK,CAAC;AACxC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEtE;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,YAAY,CAAC,uBAAuB,CAC3C,CAAC"}

package/dist/l10n/formatters.d.ts

@@ -0,0 +1,19 @@
+import { CoarLocalizationData, CoarNumberFormatData, CoarDateFormatData } from '../types';
+/**
+ * Format a number using locale-specific separators.
+ */
+export declare function formatNumber(value: number, data: CoarNumberFormatData, decimals?: number): string;
+/**
+ * Format a number as currency.
+ */
+export declare function formatCurrency(value: number, data: CoarLocalizationData, currencyCode?: string): string;
+/**
+ * Format a decimal value as percent (0.25 → "25%").
+ */
+export declare function formatPercent(value: number, data: CoarLocalizationData, decimals?: number): string;
+/**
+ * Format a Date using locale date format data.
+ * Supports Date objects and ISO date strings.
+ */
+export declare function formatDate(value: Date | string, data: CoarDateFormatData, includeTime?: boolean): string;
+//# sourceMappingURL=formatters.d.ts.map

package/dist/l10n/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../src/l10n/formatters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,UAAU,CAAC;AAElB;;GAEG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,oBAAoB,EAC1B,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAqBR;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,oBAAoB,EAC1B,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,CAWR;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,oBAAoB,EAC1B,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAMR;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,IAAI,GAAG,MAAM,EACpB,IAAI,EAAE,kBAAkB,EACxB,WAAW,UAAQ,GAClB,MAAM,CAgCR"}

package/dist/l10n/intl-locale-data-source.d.ts

@@ -0,0 +1,9 @@
+import { CoarLocalizationData, CoarLocaleDataSource } from '../types';
+/**
+ * Extracts locale formatting data from the browser's Intl API.
+ * Always available as the base/fallback data source.
+ */
+export declare class IntlLocaleDataSource implements CoarLocaleDataSource {
+    load(language: string): Promise<CoarLocalizationData>;
+}
+//# sourceMappingURL=intl-locale-data-source.d.ts.map

package/dist/l10n/intl-locale-data-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intl-locale-data-source.d.ts","sourceRoot":"","sources":["../../src/l10n/intl-locale-data-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EAKpB,oBAAoB,EACrB,MAAM,UAAU,CAAC;AAElB;;;GAGG;AACH,qBAAa,oBAAqB,YAAW,oBAAoB;IACzD,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAS5D"}

package/dist/l10n/localization-data-store.d.ts

@@ -0,0 +1,18 @@
+import { Ref } from 'vue';
+import { CoarLocalizationData } from '../types';
+/**
+ * Reactive store for locale-specific formatting data.
+ * Uses a Map keyed by locale code with a version counter for reactivity.
+ */
+export declare class CoarLocalizationDataStore {
+    private readonly data;
+    private readonly _version;
+    /** Reactive version counter — watch this to react to data changes */
+    readonly version: Readonly<Ref<number>>;
+    setLocaleData(locale: string, data: CoarLocalizationData): void;
+    getLocaleData(locale: string): CoarLocalizationData | undefined;
+    hasLocaleData(locale: string): boolean;
+    removeLocaleData(locale: string): void;
+    clear(): void;
+}
+//# sourceMappingURL=localization-data-store.d.ts.map

package/dist/l10n/localization-data-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localization-data-store.d.ts","sourceRoot":"","sources":["../../src/l10n/localization-data-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAErD;;;GAGG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA2C;IAChE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;IAEnC,qEAAqE;IACrE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAiB;IAExD,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,IAAI;IAK/D,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS;IAM/D,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAKtC,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAKtC,KAAK,IAAI,IAAI;CAId"}

package/dist/l10n/merge-localization-data.d.ts

@@ -0,0 +1,7 @@
+import { CoarLocalizationData } from '../types';
+/**
+ * Deep-merge partial locale data into a base locale data object.
+ * Partial values override base values; arrays and objects are merged at one level.
+ */
+export declare function mergeLocalizationData(base: CoarLocalizationData, partial: Partial<CoarLocalizationData>): CoarLocalizationData;
+//# sourceMappingURL=merge-localization-data.d.ts.map

package/dist/l10n/merge-localization-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-localization-data.d.ts","sourceRoot":"","sources":["../../src/l10n/merge-localization-data.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAErD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,oBAAoB,EAC1B,OAAO,EAAE,OAAO,CAAC,oBAAoB,CAAC,GACrC,oBAAoB,CActB"}

package/dist/localization-service.d.ts

@@ -0,0 +1,61 @@
+import { Ref, ComputedRef } from 'vue';
+import { CoarLocalizationConfig, CoarLocalizationData, CoarLocaleDataSource, CoarTranslationSource } from './types';
+import { CoarLocalizationDataStore } from './l10n/localization-data-store';
+import { CoarTranslationStore } from './i18n/translation-store';
+import { CoarTimezoneService } from './timezone/timezone-service';
+/**
+ * Core localization service.
+ * Manages language state, locale data loading, translations, and timezone.
+ */
+export declare class CoarLocalizationService {
+    private readonly defaultLanguage;
+    private readonly _language;
+    private readonly _loading;
+    readonly l10nStore: CoarLocalizationDataStore;
+    readonly i18nStore: CoarTranslationStore;
+    readonly timezoneService: CoarTimezoneService;
+    private readonly l10nSources;
+    private readonly i18nSources;
+    /** Reactive current language */
+    get language(): Readonly<Ref<string>>;
+    /** Reactive loading state */
+    get loading(): Readonly<Ref<boolean>>;
+    /** Computed current locale data — reactive, updates on language change */
+    readonly localeData: ComputedRef<CoarLocalizationData | undefined>;
+    constructor(config?: CoarLocalizationConfig);
+    /** Get the configured default language */
+    getDefaultLanguage(): string;
+    /**
+     * Change the current language.
+     * Loads locale data and translations if not already cached.
+     */
+    setLanguage(language: string): Promise<void>;
+    /**
+     * Preload data for a language without switching to it.
+     */
+    preloadLanguage(language: string): Promise<void>;
+    /**
+     * Force reload data for a language from all sources, clearing the cache.
+     * Useful when external data changes at runtime (e.g. SignalR push, user profile update).
+     * If no language is specified, reloads the current language.
+     */
+    reloadLanguage(language?: string): Promise<void>;
+    /**
+     * Translate a key using the current language.
+     * For regional locales (e.g. de-AT), falls back to the base language (de).
+     * Returns the key itself if no translation is found.
+     */
+    t(key: string, params?: Record<string, unknown>, fallback?: string): string;
+    /**
+     * Add a custom locale data source (loaded after Intl, before HTTP).
+     */
+    addLocaleDataSource(source: CoarLocaleDataSource): void;
+    /**
+     * Add a custom translation source.
+     */
+    addTranslationSource(source: CoarTranslationSource): void;
+    private loadDataForLanguage;
+    private loadLocaleData;
+    private loadTranslations;
+}
+//# sourceMappingURL=localization-service.d.ts.map

package/dist/localization-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localization-service.d.ts","sourceRoot":"","sources":["../src/localization-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,GAAG,EAAE,KAAK,WAAW,EAAE,MAAM,KAAK,CAAC;AAChE,OAAO,KAAK,EACV,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EAEtB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAG3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAGhE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAElE;;;GAGG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IAExC,QAAQ,CAAC,SAAS,EAAE,yBAAyB,CAAC;IAC9C,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;IACzC,QAAQ,CAAC,eAAe,EAAE,mBAAmB,CAAC;IAE9C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyB;IACrD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0B;IAEtD,gCAAgC;IAChC,IAAI,QAAQ,IAAI,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAEpC;IAED,6BAA6B;IAC7B,IAAI,OAAO,IAAI,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAEpC;IAED,0EAA0E;IAC1E,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,oBAAoB,GAAG,SAAS,CAAC,CAAC;gBAEvD,MAAM,GAAE,sBAA2B;IA+B/C,0CAA0C;IAC1C,kBAAkB,IAAI,MAAM;IAI5B;;;OAGG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUlD;;OAEG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItD;;;;OAIG;IACG,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAetD;;;;OAIG;IACH,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM;IAY3E;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI;IAUvD;;OAEG;IACH,oBAAoB,CAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI;YAI3C,mBAAmB;YAgBnB,cAAc;YAuBd,gBAAgB;CAqB/B"}

package/dist/plugin.d.ts

@@ -0,0 +1,22 @@
+import { Plugin } from 'vue';
+import { CoarLocalizationConfig } from './types';
+import { CoarLocalizationService } from './localization-service';
+/**
+ * Create the Coar Localization Vue plugin.
+ *
+ * @example
+ * ```ts
+ * import { createCoarLocalization } from '@cocoar/vue-localization';
+ *
+ * const app = createApp(App);
+ * app.use(createCoarLocalization({
+ *   defaultLanguage: 'en',
+ *   i18nUrl: (lang) => `/i18n/${lang}.json`,
+ *   l10nUrl: (lang) => `/locales/${lang}.json`,
+ * }));
+ * ```
+ */
+export declare function createCoarLocalization(config?: CoarLocalizationConfig): Plugin & {
+    service: CoarLocalizationService;
+};
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAO,MAAM,EAAE,MAAM,KAAK,CAAC;AACvC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAGjE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,GAAE,sBAA2B,GAAG,MAAM,GAAG;IACpF,OAAO,EAAE,uBAAuB,CAAC;CAClC,CAWA"}

package/dist/timezone/timezone-service.d.ts

@@ -0,0 +1,23 @@
+import { Ref } from 'vue';
+import { CoarTimezoneProvider } from '../types';
+/**
+ * Default timezone provider using the browser's Intl API.
+ */
+export declare class BrowserTimezoneProvider implements CoarTimezoneProvider {
+    getTimezone(): string | null;
+}
+/**
+ * Reactive timezone service.
+ * Resolves timezone from pluggable providers with browser fallback.
+ */
+export declare class CoarTimezoneService {
+    private readonly providers;
+    private readonly _timezone;
+    /** Reactive current timezone (IANA identifier) */
+    get timezone(): Readonly<Ref<string>>;
+    constructor(customProviders?: CoarTimezoneProvider[]);
+    /** Re-resolve the timezone from providers and update the reactive value */
+    refresh(): void;
+    private resolve;
+}
+//# sourceMappingURL=timezone-service.d.ts.map

package/dist/timezone/timezone-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timezone-service.d.ts","sourceRoot":"","sources":["../../src/timezone/timezone-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAErD;;GAEG;AACH,qBAAa,uBAAwB,YAAW,oBAAoB;IAClE,WAAW,IAAI,MAAM,GAAG,IAAI;CAO7B;AAED;;;GAGG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;IAExC,kDAAkD;IAClD,IAAI,QAAQ,IAAI,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAEpC;gBAEW,eAAe,GAAE,oBAAoB,EAAO;IAKxD,2EAA2E;IAC3E,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,OAAO;CAOhB"}

package/dist/types.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Date format data for a locale.
+ */
+export interface CoarDateFormatData {
+    /** Date pattern, e.g. 'dd.mm.yyyy', 'mm/dd/yyyy' */
+    pattern: 'dd.mm.yyyy' | 'dd/mm/yyyy' | 'mm/dd/yyyy' | 'yyyy-mm-dd';
+    /** First day of week: 0=Sunday, 1=Monday, ..., 6=Saturday */
+    firstDayOfWeek: number;
+    /** Full month names, e.g. ['January', 'February', ...] */
+    monthNames: string[];
+    /** Abbreviated month names, e.g. ['Jan', 'Feb', ...] */
+    monthNamesShort: string[];
+    /** Full day names, e.g. ['Sunday', 'Monday', ...] */
+    dayNames: string[];
+    /** Abbreviated day names, e.g. ['Sun', 'Mon', ...] */
+    dayNamesShort: string[];
+    /** AM/PM labels */
+    amPm: [string, string];
+}
+/**
+ * Number format data for a locale.
+ */
+export interface CoarNumberFormatData {
+    /** Decimal separator, e.g. '.' or ',' */
+    decimal: string;
+    /** Grouping separator, e.g. ',' or '.' */
+    group: string;
+    /** Grouping sizes, e.g. [3] for standard 3-digit grouping */
+    grouping: number[];
+}
+/**
+ * Currency format data for a locale.
+ */
+export interface CoarCurrencyFormatData {
+    /** Default currency code, e.g. 'USD', 'EUR' */
+    default: string;
+    /** Map of currency code → symbol, e.g. { USD: '$', EUR: '€' } */
+    symbols: Record<string, string>;
+    /** Symbol position relative to the number */
+    position: 'before' | 'after';
+    /** Whether there's a space between symbol and number */
+    spacing: boolean;
+    /** Default number of decimal places */
+    decimals: number;
+}
+/**
+ * Percent format data for a locale.
+ */
+export interface CoarPercentFormatData {
+    /** Percent symbol */
+    symbol: string;
+    /** Whether there's a space between number and symbol */
+    spacing: boolean;
+    /** Default number of decimal places */
+    decimals: number;
+}
+/**
+ * Complete localization data for a single locale.
+ */
+export interface CoarLocalizationData {
+    /** Locale code, e.g. 'en', 'de', 'en-US' */
+    code: string;
+    /** Date formatting data */
+    date: CoarDateFormatData;
+    /** Number formatting data */
+    number: CoarNumberFormatData;
+    /** Currency formatting data */
+    currency: CoarCurrencyFormatData;
+    /** Percent formatting data */
+    percent: CoarPercentFormatData;
+}
+/**
+ * Configuration for the localization system.
+ */
+export interface CoarLocalizationConfig {
+    /** Default language to use. Defaults to 'en'. */
+    defaultLanguage?: string;
+    /** Custom timezone providers (checked before browser default) */
+    timezoneProviders?: CoarTimezoneProvider[];
+    /** HTTP URL builder for loading locale data. Receives language code, returns URL. */
+    l10nUrl?: (language: string) => string;
+    /** HTTP URL builder for loading translations. Receives language code, returns URL. */
+    i18nUrl?: (language: string) => string;
+}
+/**
+ * A pluggable timezone provider.
+ * Returns the current IANA timezone identifier, or null if unknown.
+ */
+export interface CoarTimezoneProvider {
+    /** Returns the current timezone, or null to defer to next provider */
+    getTimezone(): string | null;
+}
+/**
+ * Nested or flat translation object.
+ * Nested objects are flattened to dot-separated keys.
+ */
+export interface CoarTranslations {
+    [key: string]: string | CoarTranslations;
+}
+/**
+ * A source that can load locale data for a given language.
+ */
+export interface CoarLocaleDataSource {
+    load(language: string): Promise<Partial<CoarLocalizationData> | null>;
+}
+/**
+ * A source that can load translations for a given language.
+ */
+export interface CoarTranslationSource {
+    load(language: string): Promise<CoarTranslations | null>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,oDAAoD;IACpD,OAAO,EAAE,YAAY,GAAG,YAAY,GAAG,YAAY,GAAG,YAAY,CAAC;IACnE,6DAA6D;IAC7D,cAAc,EAAE,MAAM,CAAC;IACvB,0DAA0D;IAC1D,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,wDAAwD;IACxD,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,qDAAqD;IACrD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,sDAAsD;IACtD,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,mBAAmB;IACnB,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,6CAA6C;IAC7C,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC7B,wDAAwD;IACxD,OAAO,EAAE,OAAO,CAAC;IACjB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,OAAO,EAAE,OAAO,CAAC;IACjB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,IAAI,EAAE,kBAAkB,CAAC;IACzB,6BAA6B;IAC7B,MAAM,EAAE,oBAAoB,CAAC;IAC7B,+BAA+B;IAC/B,QAAQ,EAAE,sBAAsB,CAAC;IACjC,8BAA8B;IAC9B,OAAO,EAAE,qBAAqB,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,iDAAiD;IACjD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iEAAiE;IACjE,iBAAiB,CAAC,EAAE,oBAAoB,EAAE,CAAC;IAC3C,qFAAqF;IACrF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;IACvC,sFAAsF;IACtF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;CACxC;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,sEAAsE;IACtE,WAAW,IAAI,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,gBAAgB,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,oBAAoB,CAAC,GAAG,IAAI,CAAC,CAAC;CACvE;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;CAC1D"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cocoar/vue-localization",
-  "version": "0.1.0-beta.24",
+  "version": "0.1.0-beta.34",
   "type": "module",
   "sideEffects": false,
   "main": "./dist/index.js",