@astroscope/i18n 0.1.0

package/dist/types-C6rOJFY2.d.ts

@@ -0,0 +1,24 @@
+import { a as TranslationMeta } from './types-CLWZeQhD.js';
+
+/**
+ * Extracted metadata for a single translation key
+ */
+type ExtractedKey = {
+    key: string;
+    meta: TranslationMeta;
+    file: string;
+    line: number;
+};
+/**
+ * Chunk-to-keys mapping produced by Vite plugin
+ */
+type ChunkManifest = Record<string, string[]>;
+/**
+ * Full extraction manifest
+ */
+type ExtractionManifest = {
+    keys: ExtractedKey[];
+    chunks: ChunkManifest;
+};
+
+export type { ChunkManifest as C, ExtractionManifest as E, ExtractedKey as a };

package/dist/types-C7lD-Woj.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Variable definition for CMS/documentation
+ */
+type VariableDef = {
+    fallback?: string | undefined;
+    description?: string | undefined;
+};
+/**
+ * Metadata for a translation key - extracted at build time, synced to CMS
+ */
+type TranslationMeta = {
+    fallback: string;
+    variables?: Record<string, VariableDef> | undefined;
+    description?: string | undefined;
+};
+/**
+ * Compiled translation ready for runtime use
+ */
+type CompiledTranslation = (values?: Record<string, unknown> | undefined) => string;
+/**
+ * Map of translation keys to compiled functions
+ */
+type CompiledTranslations = Record<string, CompiledTranslation>;
+/**
+ * Raw translation strings from CMS (before compilation)
+ */
+type RawTranslations = Record<string, string>;
+/**
+ * Translate function signature
+ *
+ * @param key - Translation key (e.g., 'checkout.title')
+ * @param meta - Fallback string or full metadata object
+ * @param values - Runtime values for interpolation
+ *
+ * @example
+ * t('checkout.title', 'Order Summary')
+ *
+ * @example
+ * t('cart.items', '{count, plural, one {# item} other {# items}}', { count: itemCount })
+ *
+ * @example
+ * t('cart.total', { fallback: 'Total: {amount}', description: 'Cart total' }, { amount: '$49.99' })
+ */
+type TranslateFunction = (key: string, meta: TranslationMeta | string, values?: Record<string, unknown> | undefined) => string;
+/**
+ * Normalize meta argument to TranslationMeta object
+ */
+declare function normalizeMeta(meta: TranslationMeta | string): TranslationMeta;
+
+export { type CompiledTranslations as C, type RawTranslations as R, type TranslateFunction as T, type VariableDef as V, type TranslationMeta as a, type CompiledTranslation as b, normalizeMeta as n };

package/dist/types-CLWZeQhD.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Variable definition for documentation
+ */
+type VariableDef = {
+    fallback?: string | undefined;
+    description?: string | undefined;
+};
+/**
+ * Metadata for a translation key - extracted at build time
+ */
+type TranslationMeta = {
+    fallback: string;
+    variables?: Record<string, VariableDef> | undefined;
+    description?: string | undefined;
+};
+/**
+ * Compiled translation ready for runtime use
+ */
+type CompiledTranslation = (values?: Record<string, unknown> | undefined) => string;
+/**
+ * Map of translation keys to compiled functions
+ */
+type CompiledTranslations = Record<string, CompiledTranslation>;
+/**
+ * Raw translation strings (before compilation)
+ */
+type RawTranslations = Record<string, string>;
+/**
+ * Client-side i18n state injected into window.__i18n__
+ */
+type I18nClientState = {
+    locale: string;
+    hashes: Record<string, string>;
+    translations: Record<string, string>;
+};
+/**
+ * Translate function signature
+ *
+ * @param key - Translation key (e.g., 'checkout.title')
+ * @param meta - Fallback string or full metadata object
+ * @param values - Runtime values for interpolation
+ *
+ * @example
+ * t('checkout.title', 'Order Summary')
+ *
+ * @example
+ * t('cart.items', '{count, plural, one {# item} other {# items}}', { count: itemCount })
+ *
+ * @example
+ * t('cart.total', { fallback: 'Total: {amount}', description: 'Cart total' }, { amount: '$49.99' })
+ */
+type TranslateFunction = (key: string, meta: TranslationMeta | string, values?: Record<string, unknown> | undefined) => string;
+
+export type { CompiledTranslations as C, I18nClientState as I, RawTranslations as R, TranslateFunction as T, TranslationMeta as a };

package/dist/types-COXt613w.d.ts

@@ -0,0 +1,19 @@
+type I18nClientState = {
+    /**
+     * Current locale
+     */
+    locale: string;
+    /**
+     * Mapping of chunk keys to the translation content hash
+     */
+    hashes: Record<string, string>;
+    /**
+     * Mapping of loaded translation keys to translated strings
+     */
+    translations: Record<string, string>;
+};
+declare global {
+    interface Window {
+        __i18n__: I18nClientState;
+    }
+}

package/dist/types-CUlkbl9-.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Variable definition for CMS/documentation
+ */
+type VariableDef = {
+    fallback?: string;
+    description?: string;
+};
+/**
+ * Metadata for a translation key - extracted at build time, synced to CMS
+ */
+type TranslationMeta = {
+    fallback: string;
+    variables?: Record<string, VariableDef>;
+    description?: string;
+};
+/**
+ * Compiled translation ready for runtime use
+ */
+type CompiledTranslation = (values?: Record<string, unknown>) => string;
+/**
+ * Map of translation keys to compiled functions
+ */
+type CompiledTranslations = Record<string, CompiledTranslation>;
+/**
+ * Raw translation strings from CMS (before compilation)
+ */
+type RawTranslations = Record<string, string>;
+/**
+ * Translate function signature
+ *
+ * @param key - Translation key (e.g., 'checkout.title')
+ * @param meta - Fallback string or full metadata object
+ * @param values - Runtime values for interpolation
+ *
+ * @example
+ * t('checkout.title', 'Order Summary')
+ *
+ * @example
+ * t('cart.items', '{count, plural, one {# item} other {# items}}', { count: itemCount })
+ *
+ * @example
+ * t('cart.total', { fallback: 'Total: {amount}', description: 'Cart total' }, { amount: '$49.99' })
+ */
+type TranslateFunction = (key: string, meta: TranslationMeta | string, values?: Record<string, unknown>) => string;
+/**
+ * Normalize meta argument to TranslationMeta object
+ */
+declare function normalizeMeta(meta: TranslationMeta | string): TranslationMeta;
+
+export { type CompiledTranslations as C, type RawTranslations as R, type TranslateFunction as T, type VariableDef as V, type TranslationMeta as a, type CompiledTranslation as b, normalizeMeta as n };

package/dist/types-CVv7GGPj.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Variable definition for CMS/documentation
+ */
+type VariableDef = {
+    fallback?: string | undefined;
+    description?: string | undefined;
+};
+/**
+ * Metadata for a translation key - extracted at build time, synced to CMS
+ */
+type TranslationMeta = {
+    fallback: string;
+    variables?: Record<string, VariableDef> | undefined;
+    description?: string | undefined;
+};
+/**
+ * Compiled translation ready for runtime use
+ */
+type CompiledTranslation = (values?: Record<string, unknown> | undefined) => string;
+/**
+ * Map of translation keys to compiled functions
+ */
+type CompiledTranslations = Record<string, CompiledTranslation>;
+/**
+ * Raw translation strings from CMS (before compilation)
+ */
+type RawTranslations = Record<string, string>;
+/**
+ * Translate function signature
+ *
+ * @param key - Translation key (e.g., 'checkout.title')
+ * @param meta - Fallback string or full metadata object
+ * @param values - Runtime values for interpolation
+ *
+ * @example
+ * t('checkout.title', 'Order Summary')
+ *
+ * @example
+ * t('cart.items', '{count, plural, one {# item} other {# items}}', { count: itemCount })
+ *
+ * @example
+ * t('cart.total', { fallback: 'Total: {amount}', description: 'Cart total' }, { amount: '$49.99' })
+ */
+type TranslateFunction = (key: string, meta: TranslationMeta | string, values?: Record<string, unknown> | undefined) => string;
+
+export type { CompiledTranslations as C, RawTranslations as R, TranslationMeta as T, TranslateFunction as a };

package/dist/types-CiIDN2sW.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Variable definition for documentation
+ */
+type VariableDef = {
+    fallback?: string | undefined;
+    description?: string | undefined;
+};
+/**
+ * Metadata for a translation key - extracted at build time
+ */
+type TranslationMeta = {
+    fallback: string;
+    variables?: Record<string, VariableDef> | undefined;
+    description?: string | undefined;
+};
+/**
+ * Compiled translation ready for runtime use
+ */
+type CompiledTranslation = (values?: Record<string, unknown> | undefined) => string;
+/**
+ * Map of translation keys to compiled functions
+ */
+type CompiledTranslations = Record<string, CompiledTranslation>;
+/**
+ * Raw translation strings (before compilation)
+ */
+type RawTranslations = Record<string, string>;
+/**
+ * Client-side i18n state injected into window.__i18n__
+ */
+type I18nClientState = {
+    locale: string;
+    hashes: Record<string, string>;
+    translations: Record<string, string>;
+};
+/**
+ * Translate function signature
+ *
+ * In development, the second argument is required (fallback string or meta object).
+ * In production, fallbacks are stripped by the Babel plugin, so the second argument
+ * becomes optional or contains only interpolation values.
+ *
+ * @param key - Translation key (e.g., 'checkout.title')
+ * @param metaOrValues - Fallback string, meta object, or interpolation values (production)
+ * @param values - Runtime values for interpolation (when meta is provided)
+ *
+ * @example
+ * // Development (with fallback)
+ * t('checkout.title', 'Order Summary')
+ * t('cart.items', '{count, plural, one {# item} other {# items}}', { count: itemCount })
+ * t('cart.total', { fallback: 'Total: {amount}' }, { amount: '$49.99' })
+ *
+ * @example
+ * // Production (fallbacks stripped)
+ * t('checkout.title')
+ * t('cart.items', { count: itemCount })
+ * t('cart.total', { amount: '$49.99' })
+ */
+type TranslateFunction = {
+    (key: string, meta: TranslationMeta | string, values?: Record<string, unknown> | undefined): string;
+    (key: string, values?: Record<string, unknown> | undefined): string;
+};
+
+export type { CompiledTranslations as C, I18nClientState as I, RawTranslations as R, TranslationMeta as T, TranslateFunction as a };

package/dist/types-Cr86qjYl.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Shared types used by both server and client
+ */
+/**
+ * Variable definition with optional example for CMS/documentation
+ */
+type VariableDef = {
+    example?: string;
+    description?: string;
+};
+/**
+ * Metadata for a translation key - extracted at build time, synced to CMS
+ */
+type TranslationMeta = {
+    example: string;
+    variables?: Record<string, VariableDef>;
+    description?: string;
+};
+/**
+ * Compiled translation ready for runtime use
+ */
+type CompiledTranslation = (values?: Record<string, unknown>) => string;
+/**
+ * Map of translation keys to compiled functions
+ */
+type CompiledTranslations = Record<string, CompiledTranslation>;
+/**
+ * Raw translation strings from CMS (before compilation)
+ */
+type RawTranslations = Record<string, string>;
+/**
+ * Translate function signature
+ *
+ * @param key - Translation key (e.g., 'checkout.title')
+ * @param meta - Metadata with example and variable definitions (extracted at build time)
+ * @param values - Runtime values for interpolation
+ * @returns Translated string
+ *
+ * @example
+ * // Simple
+ * t('checkout.title', { example: 'Bestellübersicht' })
+ *
+ * @example
+ * // With variables
+ * t('checkout.tax', {
+ *   example: 'Enthält {name} MwSt.',
+ *   variables: { name: { example: '19%' } }
+ * }, { name: taxRate })
+ *
+ * @example
+ * // Pluralization (ICU)
+ * t('cart.items', {
+ *   example: '{count, plural, one {# item} other {# items}}'
+ * }, { count: itemCount })
+ */
+type TranslateFunction = (key: string, meta: TranslationMeta, values?: Record<string, unknown>) => string;
+
+export type { CompiledTranslations as C, RawTranslations as R, TranslationMeta as T, VariableDef as V, CompiledTranslation as a, TranslateFunction as b };

package/dist/types-CxnObiEO.d.ts

@@ -0,0 +1,7 @@
+import { I as I18nClientState } from './types-CiIDN2sW.js';
+
+declare global {
+    interface Window {
+        __i18n__: I18nClientState;
+    }
+}

package/dist/types-D44mFUjA.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Variable definition with optional example for CMS/documentation
+ */
+type VariableDef = {
+    example?: string;
+    description?: string;
+};
+/**
+ * Metadata for a translation key - extracted at build time, synced to CMS
+ */
+type TranslationMeta = {
+    example: string;
+    variables?: Record<string, VariableDef>;
+    description?: string;
+};
+/**
+ * Compiled translation ready for runtime use
+ */
+type CompiledTranslation = (values?: Record<string, unknown>) => string;
+/**
+ * Map of translation keys to compiled functions
+ */
+type CompiledTranslations = Record<string, CompiledTranslation>;
+/**
+ * Raw translation strings from CMS (before compilation)
+ */
+type RawTranslations = Record<string, string>;
+/**
+ * Extracted metadata for a single translation key
+ */
+type ExtractedKey = {
+    key: string;
+    meta: TranslationMeta;
+    file: string;
+    line: number;
+};
+/**
+ * Chunk-to-keys mapping produced by Vite plugin
+ */
+type ChunkManifest = Record<string, string[]>;
+/**
+ * Full extraction manifest
+ */
+type ExtractionManifest = {
+    keys: ExtractedKey[];
+    chunks: ChunkManifest;
+};
+/**
+ * Fallback behavior when translation is missing
+ */
+type FallbackBehavior = 'key' | 'example' | 'throw' | ((key: string, meta?: TranslationMeta) => string);
+/**
+ * CMS adapter interface
+ */
+type CmsAdapter = {
+    /**
+     * Fetch translations for given locale and keys
+     */
+    fetch: (locale: string, keys: string[]) => Promise<RawTranslations>;
+    /**
+     * Sync extracted keys to CMS (push metadata)
+     */
+    sync?: (manifest: ExtractionManifest) => Promise<void>;
+};
+/**
+ * User's i18n.ts exports
+ */
+type I18nUserConfig = {
+    /**
+     * CMS adapter for fetching/syncing translations
+     */
+    cms: CmsAdapter;
+    /**
+     * Optional chunk manifest for per-chunk loading
+     * In production, this should be loaded from build output
+     */
+    chunkManifest?: ChunkManifest;
+};
+/**
+ * Request-scoped i18n context
+ */
+type I18nContext = {
+    locale: string;
+    translations: CompiledTranslations;
+    fallback: FallbackBehavior;
+    meta: Record<string, TranslationMeta>;
+};
+/**
+ * Global i18n config (from virtual module)
+ */
+type I18nConfig = {
+    locales: string[];
+    defaultLocale: string;
+    fallback: FallbackBehavior;
+};
+
+export type { CmsAdapter as C, ExtractedKey as E, FallbackBehavior as F, I18nUserConfig as I, RawTranslations as R, TranslationMeta as T, VariableDef as V, ChunkManifest as a, CompiledTranslation as b, CompiledTranslations as c, ExtractionManifest as d, I18nContext as e, I18nConfig as f };

package/dist/types-D85m9UTC.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Variable definition with optional example for CMS/documentation
+ */
+type VariableDef = {
+    example?: string;
+    description?: string;
+};
+/**
+ * Metadata for a translation key - extracted at build time, synced to CMS
+ */
+type TranslationMeta = {
+    example: string;
+    variables?: Record<string, VariableDef>;
+    description?: string;
+};
+/**
+ * Compiled translation ready for runtime use
+ */
+type CompiledTranslation = (values?: Record<string, unknown>) => string;
+/**
+ * Map of translation keys to compiled functions
+ */
+type CompiledTranslations = Record<string, CompiledTranslation>;
+/**
+ * Raw translation strings from CMS (before compilation)
+ */
+type RawTranslations = Record<string, string>;
+/**
+ * Extracted metadata for a single translation key
+ */
+type ExtractedKey = {
+    key: string;
+    meta: TranslationMeta;
+    file: string;
+    line: number;
+};
+/**
+ * Chunk-to-keys mapping produced by Vite plugin
+ */
+type ChunkManifest = Record<string, string[]>;
+/**
+ * Full extraction manifest
+ */
+type ExtractionManifest = {
+    keys: ExtractedKey[];
+    chunks: ChunkManifest;
+};
+/**
+ * Fallback behavior when translation is missing
+ */
+type FallbackBehavior = 'key' | 'example' | 'throw' | ((key: string, meta?: TranslationMeta) => string);
+/**
+ * CMS adapter interface
+ */
+type CmsAdapter = {
+    /**
+     * Fetch translations for given locale and keys
+     */
+    fetch: (locale: string, keys: string[]) => Promise<RawTranslations>;
+    /**
+     * Sync extracted keys to CMS (push metadata)
+     */
+    sync?: (manifest: ExtractionManifest) => Promise<void>;
+};
+/**
+ * User's i18n.ts exports
+ */
+type I18nUserConfig = {
+    /**
+     * CMS adapter for fetching/syncing translations
+     */
+    cms: CmsAdapter;
+    /**
+     * Optional chunk manifest for per-chunk loading
+     * In production, this should be loaded from build output
+     */
+    chunkManifest?: ChunkManifest;
+};
+/**
+ * Request-scoped i18n context
+ */
+type I18nContext = {
+    locale: string;
+    translations: CompiledTranslations;
+    fallback: FallbackBehavior;
+    meta: Record<string, TranslationMeta>;
+};
+/**
+ * Global i18n config (from virtual module)
+ */
+type I18nConfig = {
+    locales: string[];
+    defaultLocale: string;
+    fallback: FallbackBehavior;
+};
+/**
+ * Client-side i18n state stored on window.__i18n__
+ * Fallback is handled server-side; client just uses example from t() call if missing
+ */
+type I18nClientState = {
+    locale: string;
+    hashes: Record<string, string>;
+    translations: Record<string, string>;
+};
+/**
+ * Translate function signature
+ *
+ * @param key - Translation key (e.g., 'checkout.title')
+ * @param meta - Metadata with example and variable definitions (extracted at build time)
+ * @param values - Runtime values for interpolation
+ * @returns Translated string
+ *
+ * @example
+ * // Simple
+ * t('checkout.title', { example: 'Bestellübersicht' })
+ *
+ * @example
+ * // With variables
+ * t('checkout.tax', {
+ *   example: 'Enthält {name} MwSt.',
+ *   variables: { name: { example: '19%' } }
+ * }, { name: taxRate })
+ *
+ * @example
+ * // Pluralization (ICU)
+ * t('cart.items', {
+ *   example: '{count, plural, one {# item} other {# items}}'
+ * }, { count: itemCount })
+ */
+type TranslateFunction = (key: string, meta: TranslationMeta, values?: Record<string, unknown>) => string;
+declare global {
+    interface Window {
+        __i18n__?: I18nClientState;
+    }
+}
+
+export type { CmsAdapter as C, ExtractedKey as E, FallbackBehavior as F, I18nUserConfig as I, RawTranslations as R, TranslationMeta as T, VariableDef as V, ChunkManifest as a, CompiledTranslation as b, CompiledTranslations as c, ExtractionManifest as d, I18nContext as e, I18nConfig as f, TranslateFunction as g };