@astroscope/i18n 0.1.0

package/dist/types-DWhsmSPP.d.ts

@@ -0,0 +1,102 @@
+declare global {
+    interface Window {
+        __i18n__: I18nClientState;
+    }
+}
+/**
+ * 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);
+/**
+ * Request-scoped i18n context
+ */
+type I18nContext = {
+    locale: string;
+    translations: CompiledTranslations;
+    fallback: FallbackBehavior;
+    meta: Record<string, TranslationMeta>;
+};
+/**
+ * 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;
+
+export type { ChunkManifest as C, ExtractedKey as E, FallbackBehavior as F, I18nContext as I, RawTranslations as R, TranslationMeta as T, VariableDef as V, CompiledTranslations as a, CompiledTranslation as b, ExtractionManifest as c, TranslateFunction as d };

package/dist/types-DdprXGJ1.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, TranslateFunction as T, VariableDef as V, TranslationMeta as a, CompiledTranslation as b };

package/dist/types-DhVJ2ZIo.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 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 - Example string or full metadata object
+ * @param values - Runtime values for interpolation
+ *
+ * @example
+ * t('checkout.title', 'Bestellübersicht')
+ *
+ * @example
+ * t('cart.items', '{count, plural, one {# item} other {# items}}', { count: itemCount })
+ */
+type TranslateFunction = (key: string, meta: TranslationMeta | string, values?: Record<string, unknown>) => string;
+
+export type { CompiledTranslations as C, RawTranslations as R, TranslateFunction as T, VariableDef as V, TranslationMeta as a, CompiledTranslation as b };

package/dist/types-DnbOuM1L.d.ts

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

package/dist/types-DsNK_9sI.d.ts

@@ -0,0 +1,24 @@
+import { T as TranslationMeta } from './types-CiIDN2sW.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, ExtractedKey as E, ExtractionManifest as a };

package/dist/types-DvWBr9Xp.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Client-side types
+ */
+/**
+ * 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>;
+};
+declare global {
+    interface Window {
+        __i18n__: I18nClientState;
+    }
+}

package/dist/types-DwkIalh6.d.ts

@@ -0,0 +1,24 @@
+import { T as TranslationMeta } from './types-gn4aNKGx.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, ExtractedKey as E, ExtractionManifest as a };

package/dist/types-OYRgjtE_.d.ts

@@ -0,0 +1,110 @@
+/**
+ * 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>;
+};
+/**
+ * Integration options
+ */
+type I18nIntegrationOptions = {
+    /**
+     * Supported locales
+     */
+    locales: string[];
+    /**
+     * Default locale
+     */
+    defaultLocale: string;
+    /**
+     * Fallback behavior when translation is missing
+     * @default 'example'
+     */
+    fallback?: FallbackBehavior;
+    /**
+     * CMS adapter for fetching/syncing translations
+     */
+    cms: CmsAdapter;
+    /**
+     * Function to detect locale from request
+     * @default reads from Astro.currentLocale or Accept-Language header
+     */
+    detectLocale?: (request: Request) => string;
+};
+/**
+ * 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, I18nIntegrationOptions as I, RawTranslations as R, TranslationMeta as T, VariableDef as V, CompiledTranslation as a, CompiledTranslations as b, ChunkManifest as c, ExtractionManifest as d, I18nContext as e, I18nConfig as f };

package/dist/types-SV8S05GX.d.ts

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

package/dist/types-TYn9WnxY.d.ts

@@ -0,0 +1,46 @@
+/**
+ * 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;
+
+export type { CompiledTranslations as C, RawTranslations as R, TranslateFunction as T, VariableDef as V, TranslationMeta as a, CompiledTranslation as b };

package/dist/types-aXCBbdhq.d.ts

@@ -0,0 +1,55 @@
+/**
+ * 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, TranslateFunction as T, VariableDef as V, TranslationMeta as a, CompiledTranslation as b };

package/dist/types-gn4aNKGx.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, TranslationMeta as T, TranslateFunction as a };

package/dist/types-nippsMkm.d.ts

@@ -0,0 +1,54 @@
+/**
+ * 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>;
+/**
+ * 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, TranslationMeta as T, TranslateFunction as a };