@sonenta/astro 0.1.0

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/virtual.ts","../src/integration.ts","../src/types.ts","../src/cdn.ts","../src/resolver.ts"],"sourcesContent":["/**\n * `@sonenta/astro` — official Astro integration for Sonenta i18n.\n *\n * v0.1 (standalone, pre-`@sonenta/i18n-core`): build-time CDN fetch + string\n * resolution + `{var}` interpolation + source-language fallback, with ZERO\n * client-side JS (pure SSG). The public API here is frozen forward-compatible:\n * the 0.2.0 core-backed release swaps the internals and adds surfaces / a11y /\n * CLDR plurals / variants ADDITIVELY, without changing anything below.\n *\n * Default export = the integration; named exports = the build-time runtime\n * helpers (also available standalone at `@sonenta/astro/runtime`).\n */\n\nimport { sonenta } from \"./integration\";\n\nexport { sonenta } from \"./integration\";\nexport default sonenta;\n\nexport {\n  createSonentaI18n,\n  createT,\n} from \"./resolver\";\n\nexport {\n  buildBundleUrl,\n  fetchBundle,\n  fetchNamespace,\n  fetchAll,\n  resolveCdnBase,\n  type Bundle,\n} from \"./cdn\";\n\nexport type {\n  Locale,\n  Namespace,\n  Vars,\n  TFn,\n  SonentaI18n,\n  SonentaI18nOptions,\n} from \"./types\";\n","/**\n * Vite plugin that serves the `sonenta:i18n` virtual module. The integration\n * wires this into the consumer's Astro/Vite build; the generated module pulls\n * the configured bundles at build time (via `@sonenta/astro/runtime`) and\n * re-exports a ready `getT`.\n */\n\nimport type { Plugin } from \"vite\";\nimport type { SonentaI18nOptions } from \"./types\";\n\n/** Public virtual id and its Vite-internal resolved form. */\nconst VIRTUAL_ID = \"sonenta:i18n\";\nconst RESOLVED_ID = \"\\0sonenta:i18n\";\n\n/**\n * Options that can cross the build/runtime boundary: everything except the\n * non-serializable `fetchImpl` (build always uses the global `fetch`).\n */\nfunction serializableOptions(\n  options: SonentaI18nOptions,\n): Omit<SonentaI18nOptions, \"fetchImpl\"> {\n  const { fetchImpl: _omit, ...rest } = options;\n  return rest;\n}\n\n/** The generated source of the `sonenta:i18n` module. */\nfunction moduleSource(options: SonentaI18nOptions): string {\n  const opts = JSON.stringify(serializableOptions(options));\n  return [\n    `import { createSonentaI18n } from \"@sonenta/astro/runtime\";`,\n    `const __i18n = await createSonentaI18n(${opts});`,\n    `export const getT = (locale) => __i18n.getT(locale);`,\n    `export const locales = __i18n.locales;`,\n    `export const defaultLocale = __i18n.defaultLocale;`,\n    `export const getCatalog = (locale, ns) => __i18n.getCatalog(locale, ns);`,\n    `export default __i18n;`,\n    ``,\n  ].join(\"\\n\");\n}\n\n/** Build the Vite plugin that resolves and loads `sonenta:i18n`. */\nexport function sonentaI18nVitePlugin(options: SonentaI18nOptions): Plugin {\n  return {\n    name: \"sonenta:astro-i18n\",\n    enforce: \"pre\",\n    resolveId(id) {\n      if (id === VIRTUAL_ID) return RESOLVED_ID;\n      return null;\n    },\n    load(id) {\n      if (id === RESOLVED_ID) return moduleSource(options);\n      return null;\n    },\n  };\n}\n\nexport { VIRTUAL_ID, RESOLVED_ID };\n","/**\n * The Sonenta Astro integration — default export of `@sonenta/astro`.\n *\n * Usage (astro.config.mjs):\n *\n *   import { defineConfig } from \"astro/config\";\n *   import sonenta from \"@sonenta/astro\";\n *\n *   export default defineConfig({\n *     integrations: [\n *       sonenta({\n *         project: \"your-project-uuid\",\n *         locales: [\"fr\", \"en\", \"es\"],\n *         defaultLocale: \"fr\",\n *         namespaces: [\"common\"],\n *       }),\n *     ],\n *   });\n *\n * Then in any `.astro` page:\n *\n *   ---\n *   import { getT } from \"sonenta:i18n\";\n *   const t = getT(Astro.currentLocale ?? \"fr\");\n *   ---\n *   <h1>{t(\"home.title\")}</h1>\n *   <p>{t(\"home.greeting\", { name: \"Ada\" })}</p>\n */\n\nimport type { AstroIntegration } from \"astro\";\nimport { sonentaI18nVitePlugin } from \"./virtual\";\nimport type { SonentaI18nOptions } from \"./types\";\n\n/** Ambient types injected for the `sonenta:i18n` virtual module. */\nconst VIRTUAL_DTS = `declare module \"sonenta:i18n\" {\n  import type { SonentaI18n, TFn, Locale, Namespace } from \"@sonenta/astro/runtime\";\n  /** Translation function bound to \\`locale\\`. */\n  export const getT: (locale: Locale) => TFn;\n  /** Locales fetched and frozen into the build. */\n  export const locales: Locale[];\n  /** Resolved source/default locale. */\n  export const defaultLocale: Locale;\n  /** Raw fetched dictionary for a locale/namespace, or null when absent. */\n  export const getCatalog: (\n    locale: Locale,\n    namespace?: Namespace,\n  ) => Record<string, unknown> | null;\n  const i18n: SonentaI18n;\n  export default i18n;\n}\n`;\n\n/**\n * Create the Sonenta i18n integration. Bundles are fetched at build time and\n * exposed through the `sonenta:i18n` virtual module (zero client-side JS).\n */\nexport function sonenta(options: SonentaI18nOptions): AstroIntegration {\n  if (!options?.project) {\n    throw new Error(\"[@sonenta/astro] `project` (UUID) is required.\");\n  }\n  if (!options.locales?.length) {\n    throw new Error(\"[@sonenta/astro] `locales` must be a non-empty array.\");\n  }\n  return {\n    name: \"@sonenta/astro\",\n    hooks: {\n      \"astro:config:setup\": ({ updateConfig, logger }) => {\n        if (options.fetchImpl) {\n          logger.warn(\n            \"`fetchImpl` is ignored by the integration; the build uses the global fetch. Use `@sonenta/astro/runtime` directly if you need a custom fetch.\",\n          );\n        }\n        updateConfig({\n          vite: { plugins: [sonentaI18nVitePlugin(options)] },\n        });\n        logger.info(\n          `i18n wired for project ${options.project} (${options.locales.length} locales, build-time CDN fetch).`,\n        );\n      },\n      \"astro:config:done\": ({ injectTypes }) => {\n        injectTypes({ filename: \"sonenta-i18n.d.ts\", content: VIRTUAL_DTS });\n      },\n    },\n  };\n}\n\nexport default sonenta;\n","/**\n * Public types for `@sonenta/astro` v0.1 (standalone, pre-core).\n *\n * FORWARD-COMPATIBILITY CONTRACT (frozen day-one — see CONTRACT.md): every\n * option key here is the SAME key the future `@sonenta/i18n-core`-backed\n * release will consume, so the later refactor (0.2.0) is a non-breaking,\n * additive internal swap. New capabilities (surfaces, a11y accessors, CLDR\n * plurals, variants) arrive ADDITIVELY; nothing here changes meaning.\n */\n\n/** A BCP-47 locale code, e.g. `\"fr\"`, `\"en\"`, `\"fr-CA\"`. */\nexport type Locale = string;\n\n/** A bundle namespace (the `{ns}.json` file on the CDN), e.g. `\"common\"`. */\nexport type Namespace = string;\n\n/** Interpolation variables for a `t()` call: `t(\"greeting\", { name: \"Ada\" })`. */\nexport type Vars = Record<string, string | number>;\n\n/** A resolved, per-locale translation function. */\nexport type TFn = (key: string, vars?: Vars) => string;\n\n/**\n * Configuration for the Sonenta Astro integration / runtime.\n *\n * Bundles are fetched at BUILD time from\n * `{cdnBase}/p/{project}/{version}/latest/{locale}/{namespace}.json`\n * (the canonical Sonenta CDN layout, identical to `@sonenta/react-i18next`).\n */\nexport interface SonentaI18nOptions {\n  /** Project UUID from your Sonenta dashboard. Required. */\n  project: string;\n\n  /**\n   * Released version slug or pinned content hash. Default `\"main\"`.\n   * The CDN serves the latest release of this version under `/latest/`.\n   */\n  version?: string;\n\n  /**\n   * Locales to fetch and freeze into the static build. Required, non-empty.\n   * A locale whose bundle 404s (e.g. a plan-limit-blocked language) is kept\n   * as `null` and transparently falls back to the source language.\n   */\n  locales: Locale[];\n\n  /**\n   * Source / default locale. Default = `locales[0]`. Used as the implicit\n   * final fallback target and as Astro's source language.\n   */\n  defaultLocale?: Locale;\n\n  /**\n   * Ordered fallback chain applied when a key is missing in the active\n   * locale. Default = `[defaultLocale]`. v0.1 applies these locales in\n   * order; BCP-47 variant→base inheritance (`fr-CA → fr`) is deliberately\n   * left to the core-backed release.\n   */\n  fallbackLng?: Locale | Locale[];\n\n  /**\n   * Namespaces (bundle files) to fetch. Default `[\"common\"]`. The first\n   * entry is the default namespace for un-prefixed keys; address others with\n   * the i18next-style `\"ns:key\"` syntax.\n   */\n  namespaces?: Namespace[];\n\n  /**\n   * CDN host root for translation bundles, WITHOUT the `/p` segment.\n   * Default `\"https://cdn.sonenta.com\"`. Overridable via the\n   * `SONENTA_CDN_BASE` env var (also a bare host; for local dev point it at\n   * your translation CDN). The `/p/{project}/{version}/latest/...` path is\n   * appended by the loader.\n   */\n  cdnBase?: string;\n\n  /**\n   * API host root. Reserved for forward-compatibility (the core-backed\n   * release uses it for the public language manifest and dev-mode runtime\n   * fetch). Default `\"https://api.sonenta.dev\"`. Unused by v0.1's prod\n   * build-time path.\n   */\n  apiBase?: string;\n\n  /**\n   * Injectable `fetch` implementation (testing / proxies / custom agents).\n   * Defaults to the global `fetch`.\n   */\n  fetchImpl?: typeof fetch;\n}\n\n/**\n * The resolved Sonenta i18n handle returned by `createSonentaI18n` and\n * exposed through the `sonenta:i18n` virtual module.\n */\nexport interface SonentaI18n {\n  /** Build a translation function bound to `locale`. */\n  getT(locale: Locale): TFn;\n  /** The locales that were fetched (the configured `locales`). */\n  readonly locales: Locale[];\n  /** The resolved source/default locale. */\n  readonly defaultLocale: Locale;\n  /**\n   * Raw fetched dictionary for `locale` / `namespace` (default namespace when\n   * omitted), or `null` when that bundle was absent (404 / plan-limit).\n   */\n  getCatalog(locale: Locale, namespace?: Namespace): Record<string, unknown> | null;\n}\n\n/** Default CDN host (no `/p`). */\nexport const DEFAULT_CDN_BASE = \"https://cdn.sonenta.com\";\n/** Default API host. */\nexport const DEFAULT_API_BASE = \"https://api.sonenta.dev\";\n/** Default version slug. */\nexport const DEFAULT_VERSION = \"main\";\n/** Default namespace. */\nexport const DEFAULT_NAMESPACE = \"common\";\n","/**\n * Build-time CDN loader for Sonenta translation bundles.\n *\n * Mirrors the canonical Sonenta CDN layout used by `@sonenta/react-i18next`:\n *   `{cdnBase}/p/{project}/{version}/latest/{locale}/{namespace}.json`\n *\n * Pure data fetch — no DOM, no React, no runtime. Called during `astro build`\n * so the strings inline into the static HTML (zero client JS).\n */\n\nimport {\n  DEFAULT_CDN_BASE,\n  DEFAULT_VERSION,\n  type Locale,\n  type Namespace,\n  type SonentaI18nOptions,\n} from \"./types\";\n\n/** A fetched bundle (a flat or nested dictionary of message strings). */\nexport type Bundle = Record<string, unknown>;\n\n/** Strip trailing slashes so URL joins never double up. */\nfunction trimSlashes(s: string): string {\n  return s.replace(/\\/+$/, \"\");\n}\n\n/**\n * Resolve the effective CDN host (no `/p`): explicit option wins, then the\n * `SONENTA_CDN_BASE` env var, then the production default.\n */\nexport function resolveCdnBase(opts: Pick<SonentaI18nOptions, \"cdnBase\">): string {\n  const env =\n    typeof process !== \"undefined\" ? process.env?.SONENTA_CDN_BASE : undefined;\n  return trimSlashes(opts.cdnBase ?? env ?? DEFAULT_CDN_BASE);\n}\n\n/**\n * Build the bundle URL for one `(locale, namespace)` pair.\n * `{cdnBase}/p/{project}/{version}/latest/{locale}/{namespace}.json`\n */\nexport function buildBundleUrl(\n  opts: Pick<SonentaI18nOptions, \"project\" | \"version\" | \"cdnBase\">,\n  locale: Locale,\n  namespace: Namespace,\n): string {\n  const base = resolveCdnBase(opts);\n  const version = opts.version ?? DEFAULT_VERSION;\n  return `${base}/p/${opts.project}/${version}/latest/${locale}/${namespace}.json`;\n}\n\n/**\n * Fetch a single bundle. Resolves to `null` on 404 (locale absent from the\n * project — e.g. a plan-limit-blocked language) so callers fall back to the\n * source language. Any other non-OK status or transport error throws so a\n * misconfigured build fails loudly rather than silently shipping empty pages.\n */\nexport async function fetchBundle(\n  opts: Pick<SonentaI18nOptions, \"project\" | \"version\" | \"cdnBase\" | \"fetchImpl\">,\n  locale: Locale,\n  namespace: Namespace,\n): Promise<Bundle | null> {\n  const url = buildBundleUrl(opts, locale, namespace);\n  const doFetch = opts.fetchImpl ?? fetch;\n  let res: Response;\n  try {\n    res = await doFetch(url, { method: \"GET\" });\n  } catch (e) {\n    throw new Error(\n      `[@sonenta/astro] CDN fetch failed for ${locale}/${namespace}: ${\n        (e as Error).message\n      }`,\n    );\n  }\n  if (!res.ok) {\n    if (res.status === 404) return null;\n    throw new Error(`[@sonenta/astro] CDN ${res.status} on ${url}`);\n  }\n  return (await res.json()) as Bundle;\n}\n\n/**\n * Fetch one namespace across every locale, in parallel. Absent locales map to\n * `null`. Returns `Record<Locale, Bundle | null>`.\n */\nexport async function fetchNamespace(\n  opts: Pick<\n    SonentaI18nOptions,\n    \"project\" | \"version\" | \"cdnBase\" | \"fetchImpl\"\n  >,\n  locales: Locale[],\n  namespace: Namespace,\n): Promise<Record<Locale, Bundle | null>> {\n  const entries = await Promise.all(\n    locales.map(\n      async (l) => [l, await fetchBundle(opts, l, namespace)] as const,\n    ),\n  );\n  return Object.fromEntries(entries) as Record<Locale, Bundle | null>;\n}\n\n/**\n * Fetch every `(locale, namespace)` pair. Returns a nested map keyed by\n * locale then namespace: `data[locale][namespace] = Bundle | null`.\n */\nexport async function fetchAll(\n  opts: Pick<\n    SonentaI18nOptions,\n    \"project\" | \"version\" | \"cdnBase\" | \"fetchImpl\"\n  >,\n  locales: Locale[],\n  namespaces: Namespace[],\n): Promise<Record<Locale, Record<Namespace, Bundle | null>>> {\n  const out: Record<Locale, Record<Namespace, Bundle | null>> = {};\n  for (const l of locales) out[l] = {};\n  await Promise.all(\n    locales.flatMap((l) =>\n      namespaces.map(async (ns) => {\n        out[l]![ns] = await fetchBundle(opts, l, ns);\n      }),\n    ),\n  );\n  return out;\n}\n","/**\n * Build-time translation resolver.\n *\n * v0.1 SCOPE (frozen — see CONTRACT.md): string resolution + `{var}`\n * interpolation + source-language fallback ONLY. Deliberately NO CLDR\n * plurals, NO surfaces, NO a11y accessors, NO BCP-47 variant→base\n * inheritance — those carry real i18n SEMANTICS owned by `@sonenta/i18n-core`\n * and arrive additively in 0.2.0. Keeping them out of v0.1 means there is no\n * naive semantics to break when the core swaps in underneath this same API.\n */\n\nimport { fetchAll, type Bundle } from \"./cdn\";\nimport {\n  DEFAULT_NAMESPACE,\n  type Locale,\n  type Namespace,\n  type SonentaI18n,\n  type SonentaI18nOptions,\n  type TFn,\n  type Vars,\n} from \"./types\";\n\n/** Normalize `fallbackLng` (scalar | array | undefined) into a locale list. */\nfunction normalizeFallback(\n  fallbackLng: SonentaI18nOptions[\"fallbackLng\"],\n  defaultLocale: Locale,\n): Locale[] {\n  if (fallbackLng == null) return [defaultLocale];\n  return Array.isArray(fallbackLng) ? fallbackLng : [fallbackLng];\n}\n\n/** Split an i18next-style `\"ns:key\"` into `[namespace, key]`. */\nfunction splitKey(key: string, defaultNamespace: Namespace): [Namespace, string] {\n  const i = key.indexOf(\":\");\n  if (i === -1) return [defaultNamespace, key];\n  return [key.slice(0, i), key.slice(i + 1)];\n}\n\n/** Walk a dotted path (`\"home.title\"`) through a bundle; `undefined` on miss. */\nfunction walk(bundle: Bundle | null | undefined, path: string): unknown {\n  if (!bundle) return undefined;\n  let cursor: unknown = bundle;\n  for (const part of path.split(\".\")) {\n    if (cursor && typeof cursor === \"object\" && part in cursor) {\n      cursor = (cursor as Record<string, unknown>)[part];\n    } else {\n      return undefined;\n    }\n  }\n  return cursor;\n}\n\n/** Substitute `{var}` placeholders; unknown placeholders are left intact. */\nfunction interpolate(template: string, vars?: Vars): string {\n  if (!vars) return template;\n  return template.replace(/\\{(\\w+)\\}/g, (_, name: string) =>\n    name in vars ? String(vars[name]) : `{${name}}`,\n  );\n}\n\n/**\n * Build a `t()` bound to `locale`, given the fetched data and resolution\n * order. Lookup: active locale's namespace dict → each fallback locale's same\n * namespace dict → the raw key (i18next-parity missing-key behaviour).\n */\nexport function createT(\n  data: Record<Locale, Record<Namespace, Bundle | null>>,\n  locale: Locale,\n  fallbackChain: Locale[],\n  defaultNamespace: Namespace,\n): TFn {\n  // De-duped resolution order: active locale first, then configured\n  // fallbacks (skipping the active one if it reappears).\n  const order = [locale, ...fallbackChain.filter((l) => l !== locale)];\n  return function t(key: string, vars?: Vars): string {\n    const [ns, rest] = splitKey(key, defaultNamespace);\n    for (const l of order) {\n      const hit = walk(data[l]?.[ns], rest);\n      if (typeof hit === \"string\") return interpolate(hit, vars);\n    }\n    // Missing everywhere → return the raw key (unchanged), i18next-style.\n    return key;\n  };\n}\n\n/**\n * Fetch every configured bundle at build time and return a resolved\n * {@link SonentaI18n} handle. Call once (top-level `await`) and reuse its\n * `getT(locale)` across pages.\n */\nexport async function createSonentaI18n(\n  options: SonentaI18nOptions,\n): Promise<SonentaI18n> {\n  if (!options.project) {\n    throw new Error(\"[@sonenta/astro] `project` (UUID) is required.\");\n  }\n  if (!options.locales?.length) {\n    throw new Error(\"[@sonenta/astro] `locales` must be a non-empty array.\");\n  }\n  const locales = options.locales;\n  const defaultLocale = options.defaultLocale ?? locales[0]!;\n  const namespaces =\n    options.namespaces?.length ? options.namespaces : [DEFAULT_NAMESPACE];\n  const defaultNamespace = namespaces[0]!;\n  const fallbackChain = normalizeFallback(options.fallbackLng, defaultLocale);\n\n  const data = await fetchAll(options, locales, namespaces);\n\n  return {\n    locales,\n    defaultLocale,\n    getT(locale: Locale): TFn {\n      return createT(data, locale, fallbackChain, defaultNamespace);\n    },\n    getCatalog(locale: Locale, namespace?: Namespace): Bundle | null {\n      return data[locale]?.[namespace ?? defaultNamespace] ?? null;\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,53 @@
+import { AstroIntegration } from 'astro';
+import { SonentaI18nOptions } from './runtime.cjs';
+export { Bundle, Locale, Namespace, SonentaI18n, TFn, Vars, buildBundleUrl, createSonentaI18n, createT, fetchAll, fetchBundle, fetchNamespace, resolveCdnBase } from './runtime.cjs';
+
+/**
+ * The Sonenta Astro integration — default export of `@sonenta/astro`.
+ *
+ * Usage (astro.config.mjs):
+ *
+ *   import { defineConfig } from "astro/config";
+ *   import sonenta from "@sonenta/astro";
+ *
+ *   export default defineConfig({
+ *     integrations: [
+ *       sonenta({
+ *         project: "your-project-uuid",
+ *         locales: ["fr", "en", "es"],
+ *         defaultLocale: "fr",
+ *         namespaces: ["common"],
+ *       }),
+ *     ],
+ *   });
+ *
+ * Then in any `.astro` page:
+ *
+ *   ---
+ *   import { getT } from "sonenta:i18n";
+ *   const t = getT(Astro.currentLocale ?? "fr");
+ *   ---
+ *   <h1>{t("home.title")}</h1>
+ *   <p>{t("home.greeting", { name: "Ada" })}</p>
+ */
+
+/**
+ * Create the Sonenta i18n integration. Bundles are fetched at build time and
+ * exposed through the `sonenta:i18n` virtual module (zero client-side JS).
+ */
+declare function sonenta(options: SonentaI18nOptions): AstroIntegration;
+
+/**
+ * `@sonenta/astro` — official Astro integration for Sonenta i18n.
+ *
+ * v0.1 (standalone, pre-`@sonenta/i18n-core`): build-time CDN fetch + string
+ * resolution + `{var}` interpolation + source-language fallback, with ZERO
+ * client-side JS (pure SSG). The public API here is frozen forward-compatible:
+ * the 0.2.0 core-backed release swaps the internals and adds surfaces / a11y /
+ * CLDR plurals / variants ADDITIVELY, without changing anything below.
+ *
+ * Default export = the integration; named exports = the build-time runtime
+ * helpers (also available standalone at `@sonenta/astro/runtime`).
+ */
+
+export { SonentaI18nOptions, sonenta as default, sonenta };

package/dist/index.d.ts

@@ -0,0 +1,53 @@
+import { AstroIntegration } from 'astro';
+import { SonentaI18nOptions } from './runtime.js';
+export { Bundle, Locale, Namespace, SonentaI18n, TFn, Vars, buildBundleUrl, createSonentaI18n, createT, fetchAll, fetchBundle, fetchNamespace, resolveCdnBase } from './runtime.js';
+
+/**
+ * The Sonenta Astro integration — default export of `@sonenta/astro`.
+ *
+ * Usage (astro.config.mjs):
+ *
+ *   import { defineConfig } from "astro/config";
+ *   import sonenta from "@sonenta/astro";
+ *
+ *   export default defineConfig({
+ *     integrations: [
+ *       sonenta({
+ *         project: "your-project-uuid",
+ *         locales: ["fr", "en", "es"],
+ *         defaultLocale: "fr",
+ *         namespaces: ["common"],
+ *       }),
+ *     ],
+ *   });
+ *
+ * Then in any `.astro` page:
+ *
+ *   ---
+ *   import { getT } from "sonenta:i18n";
+ *   const t = getT(Astro.currentLocale ?? "fr");
+ *   ---
+ *   <h1>{t("home.title")}</h1>
+ *   <p>{t("home.greeting", { name: "Ada" })}</p>
+ */
+
+/**
+ * Create the Sonenta i18n integration. Bundles are fetched at build time and
+ * exposed through the `sonenta:i18n` virtual module (zero client-side JS).
+ */
+declare function sonenta(options: SonentaI18nOptions): AstroIntegration;
+
+/**
+ * `@sonenta/astro` — official Astro integration for Sonenta i18n.
+ *
+ * v0.1 (standalone, pre-`@sonenta/i18n-core`): build-time CDN fetch + string
+ * resolution + `{var}` interpolation + source-language fallback, with ZERO
+ * client-side JS (pure SSG). The public API here is frozen forward-compatible:
+ * the 0.2.0 core-backed release swaps the internals and adds surfaces / a11y /
+ * CLDR plurals / variants ADDITIVELY, without changing anything below.
+ *
+ * Default export = the integration; named exports = the build-time runtime
+ * helpers (also available standalone at `@sonenta/astro/runtime`).
+ */
+
+export { SonentaI18nOptions, sonenta as default, sonenta };

package/dist/index.js

@@ -0,0 +1,107 @@
+import {
+  buildBundleUrl,
+  createSonentaI18n,
+  createT,
+  fetchAll,
+  fetchBundle,
+  fetchNamespace,
+  resolveCdnBase
+} from "./chunk-CK2DAB6G.js";
+
+// src/virtual.ts
+var VIRTUAL_ID = "sonenta:i18n";
+var RESOLVED_ID = "\0sonenta:i18n";
+function serializableOptions(options) {
+  const { fetchImpl: _omit, ...rest } = options;
+  return rest;
+}
+function moduleSource(options) {
+  const opts = JSON.stringify(serializableOptions(options));
+  return [
+    `import { createSonentaI18n } from "@sonenta/astro/runtime";`,
+    `const __i18n = await createSonentaI18n(${opts});`,
+    `export const getT = (locale) => __i18n.getT(locale);`,
+    `export const locales = __i18n.locales;`,
+    `export const defaultLocale = __i18n.defaultLocale;`,
+    `export const getCatalog = (locale, ns) => __i18n.getCatalog(locale, ns);`,
+    `export default __i18n;`,
+    ``
+  ].join("\n");
+}
+function sonentaI18nVitePlugin(options) {
+  return {
+    name: "sonenta:astro-i18n",
+    enforce: "pre",
+    resolveId(id) {
+      if (id === VIRTUAL_ID) return RESOLVED_ID;
+      return null;
+    },
+    load(id) {
+      if (id === RESOLVED_ID) return moduleSource(options);
+      return null;
+    }
+  };
+}
+
+// src/integration.ts
+var VIRTUAL_DTS = `declare module "sonenta:i18n" {
+  import type { SonentaI18n, TFn, Locale, Namespace } from "@sonenta/astro/runtime";
+  /** Translation function bound to \`locale\`. */
+  export const getT: (locale: Locale) => TFn;
+  /** Locales fetched and frozen into the build. */
+  export const locales: Locale[];
+  /** Resolved source/default locale. */
+  export const defaultLocale: Locale;
+  /** Raw fetched dictionary for a locale/namespace, or null when absent. */
+  export const getCatalog: (
+    locale: Locale,
+    namespace?: Namespace,
+  ) => Record<string, unknown> | null;
+  const i18n: SonentaI18n;
+  export default i18n;
+}
+`;
+function sonenta(options) {
+  if (!options?.project) {
+    throw new Error("[@sonenta/astro] `project` (UUID) is required.");
+  }
+  if (!options.locales?.length) {
+    throw new Error("[@sonenta/astro] `locales` must be a non-empty array.");
+  }
+  return {
+    name: "@sonenta/astro",
+    hooks: {
+      "astro:config:setup": ({ updateConfig, logger }) => {
+        if (options.fetchImpl) {
+          logger.warn(
+            "`fetchImpl` is ignored by the integration; the build uses the global fetch. Use `@sonenta/astro/runtime` directly if you need a custom fetch."
+          );
+        }
+        updateConfig({
+          vite: { plugins: [sonentaI18nVitePlugin(options)] }
+        });
+        logger.info(
+          `i18n wired for project ${options.project} (${options.locales.length} locales, build-time CDN fetch).`
+        );
+      },
+      "astro:config:done": ({ injectTypes }) => {
+        injectTypes({ filename: "sonenta-i18n.d.ts", content: VIRTUAL_DTS });
+      }
+    }
+  };
+}
+
+// src/index.ts
+var index_default = sonenta;
+export {
+  buildBundleUrl,
+  createSonentaI18n,
+  createT,
+  index_default as default,
+  fetchAll,
+  fetchBundle,
+  fetchNamespace,
+  resolveCdnBase,
+  sonenta
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/virtual.ts","../src/integration.ts","../src/index.ts"],"sourcesContent":["/**\n * Vite plugin that serves the `sonenta:i18n` virtual module. The integration\n * wires this into the consumer's Astro/Vite build; the generated module pulls\n * the configured bundles at build time (via `@sonenta/astro/runtime`) and\n * re-exports a ready `getT`.\n */\n\nimport type { Plugin } from \"vite\";\nimport type { SonentaI18nOptions } from \"./types\";\n\n/** Public virtual id and its Vite-internal resolved form. */\nconst VIRTUAL_ID = \"sonenta:i18n\";\nconst RESOLVED_ID = \"\\0sonenta:i18n\";\n\n/**\n * Options that can cross the build/runtime boundary: everything except the\n * non-serializable `fetchImpl` (build always uses the global `fetch`).\n */\nfunction serializableOptions(\n  options: SonentaI18nOptions,\n): Omit<SonentaI18nOptions, \"fetchImpl\"> {\n  const { fetchImpl: _omit, ...rest } = options;\n  return rest;\n}\n\n/** The generated source of the `sonenta:i18n` module. */\nfunction moduleSource(options: SonentaI18nOptions): string {\n  const opts = JSON.stringify(serializableOptions(options));\n  return [\n    `import { createSonentaI18n } from \"@sonenta/astro/runtime\";`,\n    `const __i18n = await createSonentaI18n(${opts});`,\n    `export const getT = (locale) => __i18n.getT(locale);`,\n    `export const locales = __i18n.locales;`,\n    `export const defaultLocale = __i18n.defaultLocale;`,\n    `export const getCatalog = (locale, ns) => __i18n.getCatalog(locale, ns);`,\n    `export default __i18n;`,\n    ``,\n  ].join(\"\\n\");\n}\n\n/** Build the Vite plugin that resolves and loads `sonenta:i18n`. */\nexport function sonentaI18nVitePlugin(options: SonentaI18nOptions): Plugin {\n  return {\n    name: \"sonenta:astro-i18n\",\n    enforce: \"pre\",\n    resolveId(id) {\n      if (id === VIRTUAL_ID) return RESOLVED_ID;\n      return null;\n    },\n    load(id) {\n      if (id === RESOLVED_ID) return moduleSource(options);\n      return null;\n    },\n  };\n}\n\nexport { VIRTUAL_ID, RESOLVED_ID };\n","/**\n * The Sonenta Astro integration — default export of `@sonenta/astro`.\n *\n * Usage (astro.config.mjs):\n *\n *   import { defineConfig } from \"astro/config\";\n *   import sonenta from \"@sonenta/astro\";\n *\n *   export default defineConfig({\n *     integrations: [\n *       sonenta({\n *         project: \"your-project-uuid\",\n *         locales: [\"fr\", \"en\", \"es\"],\n *         defaultLocale: \"fr\",\n *         namespaces: [\"common\"],\n *       }),\n *     ],\n *   });\n *\n * Then in any `.astro` page:\n *\n *   ---\n *   import { getT } from \"sonenta:i18n\";\n *   const t = getT(Astro.currentLocale ?? \"fr\");\n *   ---\n *   <h1>{t(\"home.title\")}</h1>\n *   <p>{t(\"home.greeting\", { name: \"Ada\" })}</p>\n */\n\nimport type { AstroIntegration } from \"astro\";\nimport { sonentaI18nVitePlugin } from \"./virtual\";\nimport type { SonentaI18nOptions } from \"./types\";\n\n/** Ambient types injected for the `sonenta:i18n` virtual module. */\nconst VIRTUAL_DTS = `declare module \"sonenta:i18n\" {\n  import type { SonentaI18n, TFn, Locale, Namespace } from \"@sonenta/astro/runtime\";\n  /** Translation function bound to \\`locale\\`. */\n  export const getT: (locale: Locale) => TFn;\n  /** Locales fetched and frozen into the build. */\n  export const locales: Locale[];\n  /** Resolved source/default locale. */\n  export const defaultLocale: Locale;\n  /** Raw fetched dictionary for a locale/namespace, or null when absent. */\n  export const getCatalog: (\n    locale: Locale,\n    namespace?: Namespace,\n  ) => Record<string, unknown> | null;\n  const i18n: SonentaI18n;\n  export default i18n;\n}\n`;\n\n/**\n * Create the Sonenta i18n integration. Bundles are fetched at build time and\n * exposed through the `sonenta:i18n` virtual module (zero client-side JS).\n */\nexport function sonenta(options: SonentaI18nOptions): AstroIntegration {\n  if (!options?.project) {\n    throw new Error(\"[@sonenta/astro] `project` (UUID) is required.\");\n  }\n  if (!options.locales?.length) {\n    throw new Error(\"[@sonenta/astro] `locales` must be a non-empty array.\");\n  }\n  return {\n    name: \"@sonenta/astro\",\n    hooks: {\n      \"astro:config:setup\": ({ updateConfig, logger }) => {\n        if (options.fetchImpl) {\n          logger.warn(\n            \"`fetchImpl` is ignored by the integration; the build uses the global fetch. Use `@sonenta/astro/runtime` directly if you need a custom fetch.\",\n          );\n        }\n        updateConfig({\n          vite: { plugins: [sonentaI18nVitePlugin(options)] },\n        });\n        logger.info(\n          `i18n wired for project ${options.project} (${options.locales.length} locales, build-time CDN fetch).`,\n        );\n      },\n      \"astro:config:done\": ({ injectTypes }) => {\n        injectTypes({ filename: \"sonenta-i18n.d.ts\", content: VIRTUAL_DTS });\n      },\n    },\n  };\n}\n\nexport default sonenta;\n","/**\n * `@sonenta/astro` — official Astro integration for Sonenta i18n.\n *\n * v0.1 (standalone, pre-`@sonenta/i18n-core`): build-time CDN fetch + string\n * resolution + `{var}` interpolation + source-language fallback, with ZERO\n * client-side JS (pure SSG). The public API here is frozen forward-compatible:\n * the 0.2.0 core-backed release swaps the internals and adds surfaces / a11y /\n * CLDR plurals / variants ADDITIVELY, without changing anything below.\n *\n * Default export = the integration; named exports = the build-time runtime\n * helpers (also available standalone at `@sonenta/astro/runtime`).\n */\n\nimport { sonenta } from \"./integration\";\n\nexport { sonenta } from \"./integration\";\nexport default sonenta;\n\nexport {\n  createSonentaI18n,\n  createT,\n} from \"./resolver\";\n\nexport {\n  buildBundleUrl,\n  fetchBundle,\n  fetchNamespace,\n  fetchAll,\n  resolveCdnBase,\n  type Bundle,\n} from \"./cdn\";\n\nexport type {\n  Locale,\n  Namespace,\n  Vars,\n  TFn,\n  SonentaI18n,\n  SonentaI18nOptions,\n} from \"./types\";\n"],"mappings":";;;;;;;;;;;AAWA,IAAM,aAAa;AACnB,IAAM,cAAc;AAMpB,SAAS,oBACP,SACuC;AACvC,QAAM,EAAE,WAAW,OAAO,GAAG,KAAK,IAAI;AACtC,SAAO;AACT;AAGA,SAAS,aAAa,SAAqC;AACzD,QAAM,OAAO,KAAK,UAAU,oBAAoB,OAAO,CAAC;AACxD,SAAO;AAAA,IACL;AAAA,IACA,0CAA0C,IAAI;AAAA,IAC9C;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,EAAE,KAAK,IAAI;AACb;AAGO,SAAS,sBAAsB,SAAqC;AACzE,SAAO;AAAA,IACL,MAAM;AAAA,IACN,SAAS;AAAA,IACT,UAAU,IAAI;AACZ,UAAI,OAAO,WAAY,QAAO;AAC9B,aAAO;AAAA,IACT;AAAA,IACA,KAAK,IAAI;AACP,UAAI,OAAO,YAAa,QAAO,aAAa,OAAO;AACnD,aAAO;AAAA,IACT;AAAA,EACF;AACF;;;ACpBA,IAAM,cAAc;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAsBb,SAAS,QAAQ,SAA+C;AACrE,MAAI,CAAC,SAAS,SAAS;AACrB,UAAM,IAAI,MAAM,gDAAgD;AAAA,EAClE;AACA,MAAI,CAAC,QAAQ,SAAS,QAAQ;AAC5B,UAAM,IAAI,MAAM,uDAAuD;AAAA,EACzE;AACA,SAAO;AAAA,IACL,MAAM;AAAA,IACN,OAAO;AAAA,MACL,sBAAsB,CAAC,EAAE,cAAc,OAAO,MAAM;AAClD,YAAI,QAAQ,WAAW;AACrB,iBAAO;AAAA,YACL;AAAA,UACF;AAAA,QACF;AACA,qBAAa;AAAA,UACX,MAAM,EAAE,SAAS,CAAC,sBAAsB,OAAO,CAAC,EAAE;AAAA,QACpD,CAAC;AACD,eAAO;AAAA,UACL,0BAA0B,QAAQ,OAAO,KAAK,QAAQ,QAAQ,MAAM;AAAA,QACtE;AAAA,MACF;AAAA,MACA,qBAAqB,CAAC,EAAE,YAAY,MAAM;AACxC,oBAAY,EAAE,UAAU,qBAAqB,SAAS,YAAY,CAAC;AAAA,MACrE;AAAA,IACF;AAAA,EACF;AACF;;;ACpEA,IAAO,gBAAQ;","names":[]}

package/dist/runtime.cjs

@@ -0,0 +1,163 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/runtime.ts
+var runtime_exports = {};
+__export(runtime_exports, {
+  buildBundleUrl: () => buildBundleUrl,
+  createSonentaI18n: () => createSonentaI18n,
+  createT: () => createT,
+  fetchAll: () => fetchAll,
+  fetchBundle: () => fetchBundle,
+  fetchNamespace: () => fetchNamespace,
+  resolveCdnBase: () => resolveCdnBase
+});
+module.exports = __toCommonJS(runtime_exports);
+
+// src/types.ts
+var DEFAULT_CDN_BASE = "https://cdn.sonenta.com";
+var DEFAULT_VERSION = "main";
+var DEFAULT_NAMESPACE = "common";
+
+// src/cdn.ts
+function trimSlashes(s) {
+  return s.replace(/\/+$/, "");
+}
+function resolveCdnBase(opts) {
+  const env = typeof process !== "undefined" ? process.env?.SONENTA_CDN_BASE : void 0;
+  return trimSlashes(opts.cdnBase ?? env ?? DEFAULT_CDN_BASE);
+}
+function buildBundleUrl(opts, locale, namespace) {
+  const base = resolveCdnBase(opts);
+  const version = opts.version ?? DEFAULT_VERSION;
+  return `${base}/p/${opts.project}/${version}/latest/${locale}/${namespace}.json`;
+}
+async function fetchBundle(opts, locale, namespace) {
+  const url = buildBundleUrl(opts, locale, namespace);
+  const doFetch = opts.fetchImpl ?? fetch;
+  let res;
+  try {
+    res = await doFetch(url, { method: "GET" });
+  } catch (e) {
+    throw new Error(
+      `[@sonenta/astro] CDN fetch failed for ${locale}/${namespace}: ${e.message}`
+    );
+  }
+  if (!res.ok) {
+    if (res.status === 404) return null;
+    throw new Error(`[@sonenta/astro] CDN ${res.status} on ${url}`);
+  }
+  return await res.json();
+}
+async function fetchNamespace(opts, locales, namespace) {
+  const entries = await Promise.all(
+    locales.map(
+      async (l) => [l, await fetchBundle(opts, l, namespace)]
+    )
+  );
+  return Object.fromEntries(entries);
+}
+async function fetchAll(opts, locales, namespaces) {
+  const out = {};
+  for (const l of locales) out[l] = {};
+  await Promise.all(
+    locales.flatMap(
+      (l) => namespaces.map(async (ns) => {
+        out[l][ns] = await fetchBundle(opts, l, ns);
+      })
+    )
+  );
+  return out;
+}
+
+// src/resolver.ts
+function normalizeFallback(fallbackLng, defaultLocale) {
+  if (fallbackLng == null) return [defaultLocale];
+  return Array.isArray(fallbackLng) ? fallbackLng : [fallbackLng];
+}
+function splitKey(key, defaultNamespace) {
+  const i = key.indexOf(":");
+  if (i === -1) return [defaultNamespace, key];
+  return [key.slice(0, i), key.slice(i + 1)];
+}
+function walk(bundle, path) {
+  if (!bundle) return void 0;
+  let cursor = bundle;
+  for (const part of path.split(".")) {
+    if (cursor && typeof cursor === "object" && part in cursor) {
+      cursor = cursor[part];
+    } else {
+      return void 0;
+    }
+  }
+  return cursor;
+}
+function interpolate(template, vars) {
+  if (!vars) return template;
+  return template.replace(
+    /\{(\w+)\}/g,
+    (_, name) => name in vars ? String(vars[name]) : `{${name}}`
+  );
+}
+function createT(data, locale, fallbackChain, defaultNamespace) {
+  const order = [locale, ...fallbackChain.filter((l) => l !== locale)];
+  return function t(key, vars) {
+    const [ns, rest] = splitKey(key, defaultNamespace);
+    for (const l of order) {
+      const hit = walk(data[l]?.[ns], rest);
+      if (typeof hit === "string") return interpolate(hit, vars);
+    }
+    return key;
+  };
+}
+async function createSonentaI18n(options) {
+  if (!options.project) {
+    throw new Error("[@sonenta/astro] `project` (UUID) is required.");
+  }
+  if (!options.locales?.length) {
+    throw new Error("[@sonenta/astro] `locales` must be a non-empty array.");
+  }
+  const locales = options.locales;
+  const defaultLocale = options.defaultLocale ?? locales[0];
+  const namespaces = options.namespaces?.length ? options.namespaces : [DEFAULT_NAMESPACE];
+  const defaultNamespace = namespaces[0];
+  const fallbackChain = normalizeFallback(options.fallbackLng, defaultLocale);
+  const data = await fetchAll(options, locales, namespaces);
+  return {
+    locales,
+    defaultLocale,
+    getT(locale) {
+      return createT(data, locale, fallbackChain, defaultNamespace);
+    },
+    getCatalog(locale, namespace) {
+      return data[locale]?.[namespace ?? defaultNamespace] ?? null;
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildBundleUrl,
+  createSonentaI18n,
+  createT,
+  fetchAll,
+  fetchBundle,
+  fetchNamespace,
+  resolveCdnBase
+});
+//# sourceMappingURL=runtime.cjs.map

package/dist/runtime.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/runtime.ts","../src/types.ts","../src/cdn.ts","../src/resolver.ts"],"sourcesContent":["/**\n * `@sonenta/astro/runtime` — the framework-agnostic build-time resolver.\n *\n * Two ways to use it:\n *  1. Via the integration (default export of `@sonenta/astro`): the generated\n *     `sonenta:i18n` virtual module imports `createSonentaI18n` from here.\n *  2. Directly, if you prefer the explicit website-style top-level `await`\n *     without the integration:\n *\n *       // src/i18n.ts\n *       import { createSonentaI18n } from \"@sonenta/astro/runtime\";\n *       export const i18n = await createSonentaI18n({ project, locales });\n *       export const getT = i18n.getT;\n */\n\nexport {\n  createSonentaI18n,\n  createT,\n} from \"./resolver\";\n\nexport {\n  buildBundleUrl,\n  fetchBundle,\n  fetchNamespace,\n  fetchAll,\n  resolveCdnBase,\n  type Bundle,\n} from \"./cdn\";\n\nexport type {\n  Locale,\n  Namespace,\n  Vars,\n  TFn,\n  SonentaI18n,\n  SonentaI18nOptions,\n} from \"./types\";\n","/**\n * Public types for `@sonenta/astro` v0.1 (standalone, pre-core).\n *\n * FORWARD-COMPATIBILITY CONTRACT (frozen day-one — see CONTRACT.md): every\n * option key here is the SAME key the future `@sonenta/i18n-core`-backed\n * release will consume, so the later refactor (0.2.0) is a non-breaking,\n * additive internal swap. New capabilities (surfaces, a11y accessors, CLDR\n * plurals, variants) arrive ADDITIVELY; nothing here changes meaning.\n */\n\n/** A BCP-47 locale code, e.g. `\"fr\"`, `\"en\"`, `\"fr-CA\"`. */\nexport type Locale = string;\n\n/** A bundle namespace (the `{ns}.json` file on the CDN), e.g. `\"common\"`. */\nexport type Namespace = string;\n\n/** Interpolation variables for a `t()` call: `t(\"greeting\", { name: \"Ada\" })`. */\nexport type Vars = Record<string, string | number>;\n\n/** A resolved, per-locale translation function. */\nexport type TFn = (key: string, vars?: Vars) => string;\n\n/**\n * Configuration for the Sonenta Astro integration / runtime.\n *\n * Bundles are fetched at BUILD time from\n * `{cdnBase}/p/{project}/{version}/latest/{locale}/{namespace}.json`\n * (the canonical Sonenta CDN layout, identical to `@sonenta/react-i18next`).\n */\nexport interface SonentaI18nOptions {\n  /** Project UUID from your Sonenta dashboard. Required. */\n  project: string;\n\n  /**\n   * Released version slug or pinned content hash. Default `\"main\"`.\n   * The CDN serves the latest release of this version under `/latest/`.\n   */\n  version?: string;\n\n  /**\n   * Locales to fetch and freeze into the static build. Required, non-empty.\n   * A locale whose bundle 404s (e.g. a plan-limit-blocked language) is kept\n   * as `null` and transparently falls back to the source language.\n   */\n  locales: Locale[];\n\n  /**\n   * Source / default locale. Default = `locales[0]`. Used as the implicit\n   * final fallback target and as Astro's source language.\n   */\n  defaultLocale?: Locale;\n\n  /**\n   * Ordered fallback chain applied when a key is missing in the active\n   * locale. Default = `[defaultLocale]`. v0.1 applies these locales in\n   * order; BCP-47 variant→base inheritance (`fr-CA → fr`) is deliberately\n   * left to the core-backed release.\n   */\n  fallbackLng?: Locale | Locale[];\n\n  /**\n   * Namespaces (bundle files) to fetch. Default `[\"common\"]`. The first\n   * entry is the default namespace for un-prefixed keys; address others with\n   * the i18next-style `\"ns:key\"` syntax.\n   */\n  namespaces?: Namespace[];\n\n  /**\n   * CDN host root for translation bundles, WITHOUT the `/p` segment.\n   * Default `\"https://cdn.sonenta.com\"`. Overridable via the\n   * `SONENTA_CDN_BASE` env var (also a bare host; for local dev point it at\n   * your translation CDN). The `/p/{project}/{version}/latest/...` path is\n   * appended by the loader.\n   */\n  cdnBase?: string;\n\n  /**\n   * API host root. Reserved for forward-compatibility (the core-backed\n   * release uses it for the public language manifest and dev-mode runtime\n   * fetch). Default `\"https://api.sonenta.dev\"`. Unused by v0.1's prod\n   * build-time path.\n   */\n  apiBase?: string;\n\n  /**\n   * Injectable `fetch` implementation (testing / proxies / custom agents).\n   * Defaults to the global `fetch`.\n   */\n  fetchImpl?: typeof fetch;\n}\n\n/**\n * The resolved Sonenta i18n handle returned by `createSonentaI18n` and\n * exposed through the `sonenta:i18n` virtual module.\n */\nexport interface SonentaI18n {\n  /** Build a translation function bound to `locale`. */\n  getT(locale: Locale): TFn;\n  /** The locales that were fetched (the configured `locales`). */\n  readonly locales: Locale[];\n  /** The resolved source/default locale. */\n  readonly defaultLocale: Locale;\n  /**\n   * Raw fetched dictionary for `locale` / `namespace` (default namespace when\n   * omitted), or `null` when that bundle was absent (404 / plan-limit).\n   */\n  getCatalog(locale: Locale, namespace?: Namespace): Record<string, unknown> | null;\n}\n\n/** Default CDN host (no `/p`). */\nexport const DEFAULT_CDN_BASE = \"https://cdn.sonenta.com\";\n/** Default API host. */\nexport const DEFAULT_API_BASE = \"https://api.sonenta.dev\";\n/** Default version slug. */\nexport const DEFAULT_VERSION = \"main\";\n/** Default namespace. */\nexport const DEFAULT_NAMESPACE = \"common\";\n","/**\n * Build-time CDN loader for Sonenta translation bundles.\n *\n * Mirrors the canonical Sonenta CDN layout used by `@sonenta/react-i18next`:\n *   `{cdnBase}/p/{project}/{version}/latest/{locale}/{namespace}.json`\n *\n * Pure data fetch — no DOM, no React, no runtime. Called during `astro build`\n * so the strings inline into the static HTML (zero client JS).\n */\n\nimport {\n  DEFAULT_CDN_BASE,\n  DEFAULT_VERSION,\n  type Locale,\n  type Namespace,\n  type SonentaI18nOptions,\n} from \"./types\";\n\n/** A fetched bundle (a flat or nested dictionary of message strings). */\nexport type Bundle = Record<string, unknown>;\n\n/** Strip trailing slashes so URL joins never double up. */\nfunction trimSlashes(s: string): string {\n  return s.replace(/\\/+$/, \"\");\n}\n\n/**\n * Resolve the effective CDN host (no `/p`): explicit option wins, then the\n * `SONENTA_CDN_BASE` env var, then the production default.\n */\nexport function resolveCdnBase(opts: Pick<SonentaI18nOptions, \"cdnBase\">): string {\n  const env =\n    typeof process !== \"undefined\" ? process.env?.SONENTA_CDN_BASE : undefined;\n  return trimSlashes(opts.cdnBase ?? env ?? DEFAULT_CDN_BASE);\n}\n\n/**\n * Build the bundle URL for one `(locale, namespace)` pair.\n * `{cdnBase}/p/{project}/{version}/latest/{locale}/{namespace}.json`\n */\nexport function buildBundleUrl(\n  opts: Pick<SonentaI18nOptions, \"project\" | \"version\" | \"cdnBase\">,\n  locale: Locale,\n  namespace: Namespace,\n): string {\n  const base = resolveCdnBase(opts);\n  const version = opts.version ?? DEFAULT_VERSION;\n  return `${base}/p/${opts.project}/${version}/latest/${locale}/${namespace}.json`;\n}\n\n/**\n * Fetch a single bundle. Resolves to `null` on 404 (locale absent from the\n * project — e.g. a plan-limit-blocked language) so callers fall back to the\n * source language. Any other non-OK status or transport error throws so a\n * misconfigured build fails loudly rather than silently shipping empty pages.\n */\nexport async function fetchBundle(\n  opts: Pick<SonentaI18nOptions, \"project\" | \"version\" | \"cdnBase\" | \"fetchImpl\">,\n  locale: Locale,\n  namespace: Namespace,\n): Promise<Bundle | null> {\n  const url = buildBundleUrl(opts, locale, namespace);\n  const doFetch = opts.fetchImpl ?? fetch;\n  let res: Response;\n  try {\n    res = await doFetch(url, { method: \"GET\" });\n  } catch (e) {\n    throw new Error(\n      `[@sonenta/astro] CDN fetch failed for ${locale}/${namespace}: ${\n        (e as Error).message\n      }`,\n    );\n  }\n  if (!res.ok) {\n    if (res.status === 404) return null;\n    throw new Error(`[@sonenta/astro] CDN ${res.status} on ${url}`);\n  }\n  return (await res.json()) as Bundle;\n}\n\n/**\n * Fetch one namespace across every locale, in parallel. Absent locales map to\n * `null`. Returns `Record<Locale, Bundle | null>`.\n */\nexport async function fetchNamespace(\n  opts: Pick<\n    SonentaI18nOptions,\n    \"project\" | \"version\" | \"cdnBase\" | \"fetchImpl\"\n  >,\n  locales: Locale[],\n  namespace: Namespace,\n): Promise<Record<Locale, Bundle | null>> {\n  const entries = await Promise.all(\n    locales.map(\n      async (l) => [l, await fetchBundle(opts, l, namespace)] as const,\n    ),\n  );\n  return Object.fromEntries(entries) as Record<Locale, Bundle | null>;\n}\n\n/**\n * Fetch every `(locale, namespace)` pair. Returns a nested map keyed by\n * locale then namespace: `data[locale][namespace] = Bundle | null`.\n */\nexport async function fetchAll(\n  opts: Pick<\n    SonentaI18nOptions,\n    \"project\" | \"version\" | \"cdnBase\" | \"fetchImpl\"\n  >,\n  locales: Locale[],\n  namespaces: Namespace[],\n): Promise<Record<Locale, Record<Namespace, Bundle | null>>> {\n  const out: Record<Locale, Record<Namespace, Bundle | null>> = {};\n  for (const l of locales) out[l] = {};\n  await Promise.all(\n    locales.flatMap((l) =>\n      namespaces.map(async (ns) => {\n        out[l]![ns] = await fetchBundle(opts, l, ns);\n      }),\n    ),\n  );\n  return out;\n}\n","/**\n * Build-time translation resolver.\n *\n * v0.1 SCOPE (frozen — see CONTRACT.md): string resolution + `{var}`\n * interpolation + source-language fallback ONLY. Deliberately NO CLDR\n * plurals, NO surfaces, NO a11y accessors, NO BCP-47 variant→base\n * inheritance — those carry real i18n SEMANTICS owned by `@sonenta/i18n-core`\n * and arrive additively in 0.2.0. Keeping them out of v0.1 means there is no\n * naive semantics to break when the core swaps in underneath this same API.\n */\n\nimport { fetchAll, type Bundle } from \"./cdn\";\nimport {\n  DEFAULT_NAMESPACE,\n  type Locale,\n  type Namespace,\n  type SonentaI18n,\n  type SonentaI18nOptions,\n  type TFn,\n  type Vars,\n} from \"./types\";\n\n/** Normalize `fallbackLng` (scalar | array | undefined) into a locale list. */\nfunction normalizeFallback(\n  fallbackLng: SonentaI18nOptions[\"fallbackLng\"],\n  defaultLocale: Locale,\n): Locale[] {\n  if (fallbackLng == null) return [defaultLocale];\n  return Array.isArray(fallbackLng) ? fallbackLng : [fallbackLng];\n}\n\n/** Split an i18next-style `\"ns:key\"` into `[namespace, key]`. */\nfunction splitKey(key: string, defaultNamespace: Namespace): [Namespace, string] {\n  const i = key.indexOf(\":\");\n  if (i === -1) return [defaultNamespace, key];\n  return [key.slice(0, i), key.slice(i + 1)];\n}\n\n/** Walk a dotted path (`\"home.title\"`) through a bundle; `undefined` on miss. */\nfunction walk(bundle: Bundle | null | undefined, path: string): unknown {\n  if (!bundle) return undefined;\n  let cursor: unknown = bundle;\n  for (const part of path.split(\".\")) {\n    if (cursor && typeof cursor === \"object\" && part in cursor) {\n      cursor = (cursor as Record<string, unknown>)[part];\n    } else {\n      return undefined;\n    }\n  }\n  return cursor;\n}\n\n/** Substitute `{var}` placeholders; unknown placeholders are left intact. */\nfunction interpolate(template: string, vars?: Vars): string {\n  if (!vars) return template;\n  return template.replace(/\\{(\\w+)\\}/g, (_, name: string) =>\n    name in vars ? String(vars[name]) : `{${name}}`,\n  );\n}\n\n/**\n * Build a `t()` bound to `locale`, given the fetched data and resolution\n * order. Lookup: active locale's namespace dict → each fallback locale's same\n * namespace dict → the raw key (i18next-parity missing-key behaviour).\n */\nexport function createT(\n  data: Record<Locale, Record<Namespace, Bundle | null>>,\n  locale: Locale,\n  fallbackChain: Locale[],\n  defaultNamespace: Namespace,\n): TFn {\n  // De-duped resolution order: active locale first, then configured\n  // fallbacks (skipping the active one if it reappears).\n  const order = [locale, ...fallbackChain.filter((l) => l !== locale)];\n  return function t(key: string, vars?: Vars): string {\n    const [ns, rest] = splitKey(key, defaultNamespace);\n    for (const l of order) {\n      const hit = walk(data[l]?.[ns], rest);\n      if (typeof hit === \"string\") return interpolate(hit, vars);\n    }\n    // Missing everywhere → return the raw key (unchanged), i18next-style.\n    return key;\n  };\n}\n\n/**\n * Fetch every configured bundle at build time and return a resolved\n * {@link SonentaI18n} handle. Call once (top-level `await`) and reuse its\n * `getT(locale)` across pages.\n */\nexport async function createSonentaI18n(\n  options: SonentaI18nOptions,\n): Promise<SonentaI18n> {\n  if (!options.project) {\n    throw new Error(\"[@sonenta/astro] `project` (UUID) is required.\");\n  }\n  if (!options.locales?.length) {\n    throw new Error(\"[@sonenta/astro] `locales` must be a non-empty array.\");\n  }\n  const locales = options.locales;\n  const defaultLocale = options.defaultLocale ?? locales[0]!;\n  const namespaces =\n    options.namespaces?.length ? options.namespaces : [DEFAULT_NAMESPACE];\n  const defaultNamespace = namespaces[0]!;\n  const fallbackChain = normalizeFallback(options.fallbackLng, defaultLocale);\n\n  const data = await fetchAll(options, locales, namespaces);\n\n  return {\n    locales,\n    defaultLocale,\n    getT(locale: Locale): TFn {\n      return createT(data, locale, fallbackChain, defaultNamespace);\n    },\n    getCatalog(locale: Locale, namespace?: Namespace): Bundle | null {\n      return data[locale]?.[namespace ?? defaultNamespace] ?? null;\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;AC8GO,IAAM,mBAAmB;AAIzB,IAAM,kBAAkB;AAExB,IAAM,oBAAoB;;;AC9FjC,SAAS,YAAY,GAAmB;AACtC,SAAO,EAAE,QAAQ,QAAQ,EAAE;AAC7B;AAMO,SAAS,eAAe,MAAmD;AAChF,QAAM,MACJ,OAAO,YAAY,cAAc,QAAQ,KAAK,mBAAmB;AACnE,SAAO,YAAY,KAAK,WAAW,OAAO,gBAAgB;AAC5D;AAMO,SAAS,eACd,MACA,QACA,WACQ;AACR,QAAM,OAAO,eAAe,IAAI;AAChC,QAAM,UAAU,KAAK,WAAW;AAChC,SAAO,GAAG,IAAI,MAAM,KAAK,OAAO,IAAI,OAAO,WAAW,MAAM,IAAI,SAAS;AAC3E;AAQA,eAAsB,YACpB,MACA,QACA,WACwB;AACxB,QAAM,MAAM,eAAe,MAAM,QAAQ,SAAS;AAClD,QAAM,UAAU,KAAK,aAAa;AAClC,MAAI;AACJ,MAAI;AACF,UAAM,MAAM,QAAQ,KAAK,EAAE,QAAQ,MAAM,CAAC;AAAA,EAC5C,SAAS,GAAG;AACV,UAAM,IAAI;AAAA,MACR,yCAAyC,MAAM,IAAI,SAAS,KACzD,EAAY,OACf;AAAA,IACF;AAAA,EACF;AACA,MAAI,CAAC,IAAI,IAAI;AACX,QAAI,IAAI,WAAW,IAAK,QAAO;AAC/B,UAAM,IAAI,MAAM,wBAAwB,IAAI,MAAM,OAAO,GAAG,EAAE;AAAA,EAChE;AACA,SAAQ,MAAM,IAAI,KAAK;AACzB;AAMA,eAAsB,eACpB,MAIA,SACA,WACwC;AACxC,QAAM,UAAU,MAAM,QAAQ;AAAA,IAC5B,QAAQ;AAAA,MACN,OAAO,MAAM,CAAC,GAAG,MAAM,YAAY,MAAM,GAAG,SAAS,CAAC;AAAA,IACxD;AAAA,EACF;AACA,SAAO,OAAO,YAAY,OAAO;AACnC;AAMA,eAAsB,SACpB,MAIA,SACA,YAC2D;AAC3D,QAAM,MAAwD,CAAC;AAC/D,aAAW,KAAK,QAAS,KAAI,CAAC,IAAI,CAAC;AACnC,QAAM,QAAQ;AAAA,IACZ,QAAQ;AAAA,MAAQ,CAAC,MACf,WAAW,IAAI,OAAO,OAAO;AAC3B,YAAI,CAAC,EAAG,EAAE,IAAI,MAAM,YAAY,MAAM,GAAG,EAAE;AAAA,MAC7C,CAAC;AAAA,IACH;AAAA,EACF;AACA,SAAO;AACT;;;ACnGA,SAAS,kBACP,aACA,eACU;AACV,MAAI,eAAe,KAAM,QAAO,CAAC,aAAa;AAC9C,SAAO,MAAM,QAAQ,WAAW,IAAI,cAAc,CAAC,WAAW;AAChE;AAGA,SAAS,SAAS,KAAa,kBAAkD;AAC/E,QAAM,IAAI,IAAI,QAAQ,GAAG;AACzB,MAAI,MAAM,GAAI,QAAO,CAAC,kBAAkB,GAAG;AAC3C,SAAO,CAAC,IAAI,MAAM,GAAG,CAAC,GAAG,IAAI,MAAM,IAAI,CAAC,CAAC;AAC3C;AAGA,SAAS,KAAK,QAAmC,MAAuB;AACtE,MAAI,CAAC,OAAQ,QAAO;AACpB,MAAI,SAAkB;AACtB,aAAW,QAAQ,KAAK,MAAM,GAAG,GAAG;AAClC,QAAI,UAAU,OAAO,WAAW,YAAY,QAAQ,QAAQ;AAC1D,eAAU,OAAmC,IAAI;AAAA,IACnD,OAAO;AACL,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO;AACT;AAGA,SAAS,YAAY,UAAkB,MAAqB;AAC1D,MAAI,CAAC,KAAM,QAAO;AAClB,SAAO,SAAS;AAAA,IAAQ;AAAA,IAAc,CAAC,GAAG,SACxC,QAAQ,OAAO,OAAO,KAAK,IAAI,CAAC,IAAI,IAAI,IAAI;AAAA,EAC9C;AACF;AAOO,SAAS,QACd,MACA,QACA,eACA,kBACK;AAGL,QAAM,QAAQ,CAAC,QAAQ,GAAG,cAAc,OAAO,CAAC,MAAM,MAAM,MAAM,CAAC;AACnE,SAAO,SAAS,EAAE,KAAa,MAAqB;AAClD,UAAM,CAAC,IAAI,IAAI,IAAI,SAAS,KAAK,gBAAgB;AACjD,eAAW,KAAK,OAAO;AACrB,YAAM,MAAM,KAAK,KAAK,CAAC,IAAI,EAAE,GAAG,IAAI;AACpC,UAAI,OAAO,QAAQ,SAAU,QAAO,YAAY,KAAK,IAAI;AAAA,IAC3D;AAEA,WAAO;AAAA,EACT;AACF;AAOA,eAAsB,kBACpB,SACsB;AACtB,MAAI,CAAC,QAAQ,SAAS;AACpB,UAAM,IAAI,MAAM,gDAAgD;AAAA,EAClE;AACA,MAAI,CAAC,QAAQ,SAAS,QAAQ;AAC5B,UAAM,IAAI,MAAM,uDAAuD;AAAA,EACzE;AACA,QAAM,UAAU,QAAQ;AACxB,QAAM,gBAAgB,QAAQ,iBAAiB,QAAQ,CAAC;AACxD,QAAM,aACJ,QAAQ,YAAY,SAAS,QAAQ,aAAa,CAAC,iBAAiB;AACtE,QAAM,mBAAmB,WAAW,CAAC;AACrC,QAAM,gBAAgB,kBAAkB,QAAQ,aAAa,aAAa;AAE1E,QAAM,OAAO,MAAM,SAAS,SAAS,SAAS,UAAU;AAExD,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,KAAK,QAAqB;AACxB,aAAO,QAAQ,MAAM,QAAQ,eAAe,gBAAgB;AAAA,IAC9D;AAAA,IACA,WAAW,QAAgB,WAAsC;AAC/D,aAAO,KAAK,MAAM,IAAI,aAAa,gBAAgB,KAAK;AAAA,IAC1D;AAAA,EACF;AACF;","names":[]}

package/dist/runtime.d.cts

@@ -0,0 +1,160 @@
+/**
+ * Public types for `@sonenta/astro` v0.1 (standalone, pre-core).
+ *
+ * FORWARD-COMPATIBILITY CONTRACT (frozen day-one — see CONTRACT.md): every
+ * option key here is the SAME key the future `@sonenta/i18n-core`-backed
+ * release will consume, so the later refactor (0.2.0) is a non-breaking,
+ * additive internal swap. New capabilities (surfaces, a11y accessors, CLDR
+ * plurals, variants) arrive ADDITIVELY; nothing here changes meaning.
+ */
+/** A BCP-47 locale code, e.g. `"fr"`, `"en"`, `"fr-CA"`. */
+type Locale = string;
+/** A bundle namespace (the `{ns}.json` file on the CDN), e.g. `"common"`. */
+type Namespace = string;
+/** Interpolation variables for a `t()` call: `t("greeting", { name: "Ada" })`. */
+type Vars = Record<string, string | number>;
+/** A resolved, per-locale translation function. */
+type TFn = (key: string, vars?: Vars) => string;
+/**
+ * Configuration for the Sonenta Astro integration / runtime.
+ *
+ * Bundles are fetched at BUILD time from
+ * `{cdnBase}/p/{project}/{version}/latest/{locale}/{namespace}.json`
+ * (the canonical Sonenta CDN layout, identical to `@sonenta/react-i18next`).
+ */
+interface SonentaI18nOptions {
+    /** Project UUID from your Sonenta dashboard. Required. */
+    project: string;
+    /**
+     * Released version slug or pinned content hash. Default `"main"`.
+     * The CDN serves the latest release of this version under `/latest/`.
+     */
+    version?: string;
+    /**
+     * Locales to fetch and freeze into the static build. Required, non-empty.
+     * A locale whose bundle 404s (e.g. a plan-limit-blocked language) is kept
+     * as `null` and transparently falls back to the source language.
+     */
+    locales: Locale[];
+    /**
+     * Source / default locale. Default = `locales[0]`. Used as the implicit
+     * final fallback target and as Astro's source language.
+     */
+    defaultLocale?: Locale;
+    /**
+     * Ordered fallback chain applied when a key is missing in the active
+     * locale. Default = `[defaultLocale]`. v0.1 applies these locales in
+     * order; BCP-47 variant→base inheritance (`fr-CA → fr`) is deliberately
+     * left to the core-backed release.
+     */
+    fallbackLng?: Locale | Locale[];
+    /**
+     * Namespaces (bundle files) to fetch. Default `["common"]`. The first
+     * entry is the default namespace for un-prefixed keys; address others with
+     * the i18next-style `"ns:key"` syntax.
+     */
+    namespaces?: Namespace[];
+    /**
+     * CDN host root for translation bundles, WITHOUT the `/p` segment.
+     * Default `"https://cdn.sonenta.com"`. Overridable via the
+     * `SONENTA_CDN_BASE` env var (also a bare host; for local dev point it at
+     * your translation CDN). The `/p/{project}/{version}/latest/...` path is
+     * appended by the loader.
+     */
+    cdnBase?: string;
+    /**
+     * API host root. Reserved for forward-compatibility (the core-backed
+     * release uses it for the public language manifest and dev-mode runtime
+     * fetch). Default `"https://api.sonenta.dev"`. Unused by v0.1's prod
+     * build-time path.
+     */
+    apiBase?: string;
+    /**
+     * Injectable `fetch` implementation (testing / proxies / custom agents).
+     * Defaults to the global `fetch`.
+     */
+    fetchImpl?: typeof fetch;
+}
+/**
+ * The resolved Sonenta i18n handle returned by `createSonentaI18n` and
+ * exposed through the `sonenta:i18n` virtual module.
+ */
+interface SonentaI18n {
+    /** Build a translation function bound to `locale`. */
+    getT(locale: Locale): TFn;
+    /** The locales that were fetched (the configured `locales`). */
+    readonly locales: Locale[];
+    /** The resolved source/default locale. */
+    readonly defaultLocale: Locale;
+    /**
+     * Raw fetched dictionary for `locale` / `namespace` (default namespace when
+     * omitted), or `null` when that bundle was absent (404 / plan-limit).
+     */
+    getCatalog(locale: Locale, namespace?: Namespace): Record<string, unknown> | null;
+}
+
+/**
+ * Build-time CDN loader for Sonenta translation bundles.
+ *
+ * Mirrors the canonical Sonenta CDN layout used by `@sonenta/react-i18next`:
+ *   `{cdnBase}/p/{project}/{version}/latest/{locale}/{namespace}.json`
+ *
+ * Pure data fetch — no DOM, no React, no runtime. Called during `astro build`
+ * so the strings inline into the static HTML (zero client JS).
+ */
+
+/** A fetched bundle (a flat or nested dictionary of message strings). */
+type Bundle = Record<string, unknown>;
+/**
+ * Resolve the effective CDN host (no `/p`): explicit option wins, then the
+ * `SONENTA_CDN_BASE` env var, then the production default.
+ */
+declare function resolveCdnBase(opts: Pick<SonentaI18nOptions, "cdnBase">): string;
+/**
+ * Build the bundle URL for one `(locale, namespace)` pair.
+ * `{cdnBase}/p/{project}/{version}/latest/{locale}/{namespace}.json`
+ */
+declare function buildBundleUrl(opts: Pick<SonentaI18nOptions, "project" | "version" | "cdnBase">, locale: Locale, namespace: Namespace): string;
+/**
+ * Fetch a single bundle. Resolves to `null` on 404 (locale absent from the
+ * project — e.g. a plan-limit-blocked language) so callers fall back to the
+ * source language. Any other non-OK status or transport error throws so a
+ * misconfigured build fails loudly rather than silently shipping empty pages.
+ */
+declare function fetchBundle(opts: Pick<SonentaI18nOptions, "project" | "version" | "cdnBase" | "fetchImpl">, locale: Locale, namespace: Namespace): Promise<Bundle | null>;
+/**
+ * Fetch one namespace across every locale, in parallel. Absent locales map to
+ * `null`. Returns `Record<Locale, Bundle | null>`.
+ */
+declare function fetchNamespace(opts: Pick<SonentaI18nOptions, "project" | "version" | "cdnBase" | "fetchImpl">, locales: Locale[], namespace: Namespace): Promise<Record<Locale, Bundle | null>>;
+/**
+ * Fetch every `(locale, namespace)` pair. Returns a nested map keyed by
+ * locale then namespace: `data[locale][namespace] = Bundle | null`.
+ */
+declare function fetchAll(opts: Pick<SonentaI18nOptions, "project" | "version" | "cdnBase" | "fetchImpl">, locales: Locale[], namespaces: Namespace[]): Promise<Record<Locale, Record<Namespace, Bundle | null>>>;
+
+/**
+ * Build-time translation resolver.
+ *
+ * v0.1 SCOPE (frozen — see CONTRACT.md): string resolution + `{var}`
+ * interpolation + source-language fallback ONLY. Deliberately NO CLDR
+ * plurals, NO surfaces, NO a11y accessors, NO BCP-47 variant→base
+ * inheritance — those carry real i18n SEMANTICS owned by `@sonenta/i18n-core`
+ * and arrive additively in 0.2.0. Keeping them out of v0.1 means there is no
+ * naive semantics to break when the core swaps in underneath this same API.
+ */
+
+/**
+ * Build a `t()` bound to `locale`, given the fetched data and resolution
+ * order. Lookup: active locale's namespace dict → each fallback locale's same
+ * namespace dict → the raw key (i18next-parity missing-key behaviour).
+ */
+declare function createT(data: Record<Locale, Record<Namespace, Bundle | null>>, locale: Locale, fallbackChain: Locale[], defaultNamespace: Namespace): TFn;
+/**
+ * Fetch every configured bundle at build time and return a resolved
+ * {@link SonentaI18n} handle. Call once (top-level `await`) and reuse its
+ * `getT(locale)` across pages.
+ */
+declare function createSonentaI18n(options: SonentaI18nOptions): Promise<SonentaI18n>;
+
+export { type Bundle, type Locale, type Namespace, type SonentaI18n, type SonentaI18nOptions, type TFn, type Vars, buildBundleUrl, createSonentaI18n, createT, fetchAll, fetchBundle, fetchNamespace, resolveCdnBase };