@astroscope/i18n 0.1.0

package/dist/chunk-QFAAGCP5.js

@@ -0,0 +1,177 @@
+import {
+  compileTranslations
+} from "./chunk-KNDYKTHE.js";
+
+// src/extraction/hash.ts
+import { createHash } from "crypto";
+function hashString(str) {
+  return createHash("sha256").update(str).digest("hex").substring(0, 8);
+}
+function computeChunkHash(translations, keys) {
+  const relevantTranslations = {};
+  for (const key of keys.sort()) {
+    if (translations[key]) {
+      relevantTranslations[key] = translations[key];
+    }
+  }
+  return hashString(JSON.stringify(relevantTranslations));
+}
+function computeAllChunkHashes(translations, manifest) {
+  const hashes = {};
+  for (const [chunkId, keys] of Object.entries(manifest)) {
+    hashes[chunkId] = computeChunkHash(translations, keys);
+  }
+  return hashes;
+}
+
+// src/server/i18n.ts
+var I18nSingleton = class {
+  // normalized user config with defaults applied
+  config = null;
+  // locale -> raw translation strings (before ICU compilation)
+  rawCache = /* @__PURE__ */ new Map();
+  // locale -> raw translations merged with manifest fallbacks
+  mergedCache = /* @__PURE__ */ new Map();
+  // locale -> compiled ICU MessageFormat functions
+  compiledCache = /* @__PURE__ */ new Map();
+  // locale -> chunk name -> content hash (for cache busting)
+  hashCache = /* @__PURE__ */ new Map();
+  // manifest getter (set by init module, provides live data in dev mode)
+  manifestGetter = null;
+  async configure(config) {
+    if (!config.locales?.length) {
+      throw new Error("i18n.configure(): locales array is required and must not be empty");
+    }
+    for (const locale of config.locales) {
+      if (!locale) {
+        throw new Error("i18n.configure(): locale cannot be empty");
+      }
+      if (locale !== locale.trim()) {
+        throw new Error(`i18n.configure(): locale "${locale}" has leading or trailing whitespace`);
+      }
+    }
+    if (new Set(config.locales).size !== config.locales.length) {
+      throw new Error("i18n.configure(): locales array contains duplicates");
+    }
+    if (config.defaultLocale !== void 0) {
+      if (!config.defaultLocale) {
+        throw new Error("i18n.configure(): defaultLocale cannot be empty");
+      }
+      if (config.defaultLocale !== config.defaultLocale.trim()) {
+        throw new Error(`i18n.configure(): defaultLocale "${config.defaultLocale}" has leading or trailing whitespace`);
+      }
+      if (!config.locales.includes(config.defaultLocale)) {
+        throw new Error(`i18n.configure(): defaultLocale "${config.defaultLocale}" is not in locales array`);
+      }
+    }
+    this.config = {
+      locales: config.locales,
+      defaultLocale: config.defaultLocale ?? config.locales[0],
+      fallback: config.fallback ?? "fallback"
+    };
+    if (!this.manifestGetter) {
+      const m = await import("virtual:@astroscope/i18n/manifest");
+      this.manifestGetter = m.getManifest;
+    }
+  }
+  isConfigured() {
+    return this.config !== null;
+  }
+  getConfig() {
+    if (!this.config) {
+      throw new Error("i18n not configured. Call i18n.configure() first.");
+    }
+    return this.config;
+  }
+  setTranslations(locale, raw) {
+    this.rawCache.set(locale, raw);
+    this.mergedCache.delete(locale);
+    this.compiledCache.delete(locale);
+    this.hashCache.delete(locale);
+    const { chunks } = this.getManifest();
+    if (Object.keys(chunks).length > 0) {
+      this.hashCache.set(locale, computeAllChunkHashes(raw, chunks));
+    }
+  }
+  getTranslations(locale) {
+    const cached = this.mergedCache.get(locale);
+    if (cached) {
+      return cached;
+    }
+    const raw = this.rawCache.get(locale) ?? {};
+    const manifest = this.manifestGetter?.() ?? { keys: [], chunks: {} };
+    if (manifest.keys.length === 0) {
+      return raw;
+    }
+    const withFallbacks = { ...raw };
+    for (const { key, meta } of manifest.keys) {
+      if (!(key in withFallbacks) && meta.fallback) {
+        withFallbacks[key] = meta.fallback;
+      }
+    }
+    this.mergedCache.set(locale, withFallbacks);
+    return withFallbacks;
+  }
+  getCompiledTranslations(locale) {
+    const cached = this.compiledCache.get(locale);
+    if (cached) {
+      return cached;
+    }
+    const compiled = compileTranslations(locale, this.getTranslations(locale));
+    this.compiledCache.set(locale, compiled);
+    return compiled;
+  }
+  /**
+   * Get the extraction manifest (keys + chunks).
+   * - keys: translation keys extracted from codebase with metadata
+   * - chunks: mapping of chunk names to their translation keys
+   */
+  getManifest() {
+    if (!this.manifestGetter) {
+      throw new Error("i18n manifest not initialized. Call i18n.configure() first.");
+    }
+    return this.manifestGetter();
+  }
+  getHashes(locale) {
+    return this.hashCache.get(locale) ?? {};
+  }
+  /**
+   * Clear translations for specified locale(s).
+   * @param locales - Locale(s) to clear, or all if not specified
+   */
+  clear(locales) {
+    const targets = this.resolveLocales(locales);
+    for (const locale of targets) {
+      this.rawCache.delete(locale);
+      this.mergedCache.delete(locale);
+      this.compiledCache.delete(locale);
+      this.hashCache.delete(locale);
+    }
+  }
+  resolveLocales(locales) {
+    if (!locales) {
+      return this.config?.locales ?? [];
+    }
+    if (typeof locales === "string") {
+      return [locales];
+    }
+    return locales;
+  }
+};
+var i18n = new I18nSingleton();
+
+// src/server/context.ts
+import { AsyncLocalStorage } from "async_hooks";
+var als = new AsyncLocalStorage();
+function runWithContext(context, fn) {
+  return als.run(context, fn);
+}
+function getContext() {
+  return als.getStore() ?? null;
+}
+
+export {
+  i18n,
+  runWithContext,
+  getContext
+};

package/dist/chunk-QKND2KCA.js

@@ -0,0 +1,163 @@
+import {
+  compileMessage,
+  compileTranslations
+} from "./chunk-KNDYKTHE.js";
+
+// src/extraction/hash.ts
+import { createHash } from "crypto";
+function hashString(str) {
+  return createHash("sha256").update(str).digest("hex").substring(0, 8);
+}
+function computeChunkHash(translations, keys) {
+  const relevantTranslations = {};
+  for (const key of keys.sort()) {
+    if (translations[key]) {
+      relevantTranslations[key] = translations[key];
+    }
+  }
+  return hashString(JSON.stringify(relevantTranslations));
+}
+function computeAllChunkHashes(translations, manifest) {
+  const hashes = {};
+  for (const [chunkId, keys] of Object.entries(manifest)) {
+    hashes[chunkId] = computeChunkHash(translations, keys);
+  }
+  return hashes;
+}
+
+// src/server/i18n.ts
+var I18nSingleton = class {
+  // normalized user config with defaults applied
+  config = null;
+  // locale -> raw translation strings (before ICU compilation)
+  rawCache = /* @__PURE__ */ new Map();
+  // locale -> compiled ICU MessageFormat functions
+  compiledCache = /* @__PURE__ */ new Map();
+  // locale -> chunk name -> content hash (for cache busting)
+  hashCache = /* @__PURE__ */ new Map();
+  // manifest getter (set by init module, provides live data in dev mode)
+  manifestGetter = null;
+  async configure(config) {
+    if (!config.locales?.length) {
+      throw new Error("i18n.configure(): locales array is required and must not be empty");
+    }
+    for (const locale of config.locales) {
+      if (!locale) {
+        throw new Error("i18n.configure(): locale cannot be empty");
+      }
+      if (locale !== locale.trim()) {
+        throw new Error(`i18n.configure(): locale "${locale}" has leading or trailing whitespace`);
+      }
+    }
+    if (new Set(config.locales).size !== config.locales.length) {
+      throw new Error("i18n.configure(): locales array contains duplicates");
+    }
+    if (config.defaultLocale !== void 0) {
+      if (!config.defaultLocale) {
+        throw new Error("i18n.configure(): defaultLocale cannot be empty");
+      }
+      if (config.defaultLocale !== config.defaultLocale.trim()) {
+        throw new Error(`i18n.configure(): defaultLocale "${config.defaultLocale}" has leading or trailing whitespace`);
+      }
+      if (!config.locales.includes(config.defaultLocale)) {
+        throw new Error(`i18n.configure(): defaultLocale "${config.defaultLocale}" is not in locales array`);
+      }
+    }
+    this.config = {
+      locales: config.locales,
+      defaultLocale: config.defaultLocale ?? config.locales[0],
+      fallback: config.fallback ?? "fallback"
+    };
+    if (!this.manifestGetter) {
+      const m = await import("virtual:@astroscope/i18n/manifest");
+      this.manifestGetter = m.getManifest;
+    }
+  }
+  isConfigured() {
+    return this.config !== null;
+  }
+  getConfig() {
+    if (!this.config) {
+      throw new Error("i18n not configured. Call i18n.configure() first.");
+    }
+    return this.config;
+  }
+  setTranslations(locale, raw) {
+    this.rawCache.set(locale, raw);
+    this.compiledCache.set(locale, compileTranslations(locale, raw));
+    this.hashCache.delete(locale);
+    const { chunks } = this.getManifest();
+    if (Object.keys(chunks).length > 0) {
+      this.hashCache.set(locale, computeAllChunkHashes(raw, chunks));
+    }
+  }
+  getTranslations(locale) {
+    return this.rawCache.get(locale) ?? {};
+  }
+  getCompiledTranslations(locale) {
+    const compiled = this.compiledCache.get(locale) ?? {};
+    const manifest = this.manifestGetter?.() ?? { keys: [], chunks: {} };
+    if (manifest.keys.length === 0) {
+      return compiled;
+    }
+    const withFallbacks = { ...compiled };
+    for (const { key, meta } of manifest.keys) {
+      if (!(key in withFallbacks) && meta.fallback) {
+        withFallbacks[key] = compileMessage(locale, meta.fallback);
+      }
+    }
+    return withFallbacks;
+  }
+  /**
+   * Get the extraction manifest (keys + chunks).
+   * - keys: translation keys extracted from codebase with metadata
+   * - chunks: mapping of chunk names to their translation keys
+   */
+  getManifest() {
+    if (!this.manifestGetter) {
+      throw new Error("i18n manifest not initialized. Call i18n.configure() first.");
+    }
+    return this.manifestGetter();
+  }
+  getHashes(locale) {
+    return this.hashCache.get(locale) ?? {};
+  }
+  /**
+   * Clear translations for specified locale(s).
+   * @param locales - Locale(s) to clear, or all if not specified
+   */
+  clear(locales) {
+    const targets = this.resolveLocales(locales);
+    for (const locale of targets) {
+      this.rawCache.delete(locale);
+      this.compiledCache.delete(locale);
+      this.hashCache.delete(locale);
+    }
+  }
+  resolveLocales(locales) {
+    if (!locales) {
+      return this.config?.locales ?? [];
+    }
+    if (typeof locales === "string") {
+      return [locales];
+    }
+    return locales;
+  }
+};
+var i18n = new I18nSingleton();
+
+// src/server/context.ts
+import { AsyncLocalStorage } from "async_hooks";
+var als = new AsyncLocalStorage();
+function runWithContext(context, fn) {
+  return als.run(context, fn);
+}
+function getContext() {
+  return als.getStore() ?? null;
+}
+
+export {
+  i18n,
+  runWithContext,
+  getContext
+};

package/dist/chunk-QZEGY6RJ.js

@@ -0,0 +1,151 @@
+import {
+  compileTranslations
+} from "./chunk-KNDYKTHE.js";
+
+// src/extraction/hash.ts
+import { createHash } from "crypto";
+function hashString(str) {
+  return createHash("sha256").update(str).digest("hex").substring(0, 8);
+}
+function computeChunkHash(translations, keys) {
+  const relevantTranslations = {};
+  for (const key of keys.sort()) {
+    if (translations[key]) {
+      relevantTranslations[key] = translations[key];
+    }
+  }
+  return hashString(JSON.stringify(relevantTranslations));
+}
+function computeAllChunkHashes(translations, manifest) {
+  const hashes = {};
+  for (const [chunkId, keys] of Object.entries(manifest)) {
+    hashes[chunkId] = computeChunkHash(translations, keys);
+  }
+  return hashes;
+}
+
+// src/server/i18n.ts
+var I18nSingleton = class {
+  // normalized user config with defaults applied
+  config = null;
+  // locale -> raw translation strings (before ICU compilation)
+  rawCache = /* @__PURE__ */ new Map();
+  // locale -> compiled ICU MessageFormat functions
+  compiledCache = /* @__PURE__ */ new Map();
+  // locale -> chunk name -> content hash (for cache busting)
+  hashCache = /* @__PURE__ */ new Map();
+  // manifest getter (set by init module, provides live data in dev mode)
+  manifestGetter = null;
+  async configure(config) {
+    if (!config.locales?.length) {
+      throw new Error("i18n.configure(): locales array is required and must not be empty");
+    }
+    for (const locale of config.locales) {
+      if (!locale) {
+        throw new Error("i18n.configure(): locale cannot be empty");
+      }
+      if (locale !== locale.trim()) {
+        throw new Error(`i18n.configure(): locale "${locale}" has leading or trailing whitespace`);
+      }
+    }
+    if (new Set(config.locales).size !== config.locales.length) {
+      throw new Error("i18n.configure(): locales array contains duplicates");
+    }
+    if (config.defaultLocale !== void 0) {
+      if (!config.defaultLocale) {
+        throw new Error("i18n.configure(): defaultLocale cannot be empty");
+      }
+      if (config.defaultLocale !== config.defaultLocale.trim()) {
+        throw new Error(`i18n.configure(): defaultLocale "${config.defaultLocale}" has leading or trailing whitespace`);
+      }
+      if (!config.locales.includes(config.defaultLocale)) {
+        throw new Error(`i18n.configure(): defaultLocale "${config.defaultLocale}" is not in locales array`);
+      }
+    }
+    this.config = {
+      locales: config.locales,
+      defaultLocale: config.defaultLocale ?? config.locales[0],
+      fallback: config.fallback ?? "fallback"
+    };
+    if (!this.manifestGetter) {
+      const m = await import("virtual:@astroscope/i18n/manifest");
+      this.manifestGetter = m.getManifest;
+    }
+  }
+  isConfigured() {
+    return this.config !== null;
+  }
+  getConfig() {
+    if (!this.config) {
+      throw new Error("i18n not configured. Call i18n.configure() first.");
+    }
+    return this.config;
+  }
+  setTranslations(locale, raw) {
+    this.rawCache.set(locale, raw);
+    this.compiledCache.set(locale, compileTranslations(locale, raw));
+    this.hashCache.delete(locale);
+    const { chunks } = this.getManifest();
+    if (Object.keys(chunks).length > 0) {
+      this.hashCache.set(locale, computeAllChunkHashes(raw, chunks));
+    }
+  }
+  getTranslations(locale) {
+    return this.rawCache.get(locale) ?? {};
+  }
+  getCompiledTranslations(locale) {
+    return this.compiledCache.get(locale) ?? {};
+  }
+  /**
+   * Get the extraction manifest (keys + chunks).
+   * - keys: translation keys extracted from codebase with metadata
+   * - chunks: mapping of chunk names to their translation keys
+   */
+  getManifest() {
+    if (!this.manifestGetter) {
+      throw new Error("i18n manifest not initialized. Call i18n.configure() first.");
+    }
+    return this.manifestGetter();
+  }
+  getHashes(locale) {
+    return this.hashCache.get(locale) ?? {};
+  }
+  /**
+   * Clear translations for specified locale(s).
+   * @param locales - Locale(s) to clear, or all if not specified
+   */
+  clear(locales) {
+    const targets = this.resolveLocales(locales);
+    for (const locale of targets) {
+      this.rawCache.delete(locale);
+      this.compiledCache.delete(locale);
+      this.hashCache.delete(locale);
+    }
+  }
+  resolveLocales(locales) {
+    if (!locales) {
+      return this.config?.locales ?? [];
+    }
+    if (typeof locales === "string") {
+      return [locales];
+    }
+    return locales;
+  }
+};
+var i18n = new I18nSingleton();
+
+// src/server/context.ts
+import { AsyncLocalStorage } from "async_hooks";
+var als = new AsyncLocalStorage();
+function runWithContext(context, fn) {
+  return als.run(context, fn);
+}
+function getContext() {
+  return als.getStore() ?? null;
+}
+
+export {
+  i18n,
+  runWithContext,
+  getContext
+};

package/dist/chunk-RAE2L6FT.js

@@ -0,0 +1,193 @@
+import {
+  clearContext,
+  compileTranslations,
+  setContext
+} from "./chunk-KNONI6DP.js";
+
+// src/i18n-endpoint.ts
+function hashString(str) {
+  let hash = 0;
+  for (let i = 0; i < str.length; i++) {
+    const char = str.charCodeAt(i);
+    hash = (hash << 5) - hash + char;
+    hash = hash & hash;
+  }
+  return Math.abs(hash).toString(36).substring(0, 8);
+}
+function computeChunkHash(translations, keys) {
+  const relevantTranslations = {};
+  for (const key of keys.sort()) {
+    if (translations[key]) {
+      relevantTranslations[key] = translations[key];
+    }
+  }
+  return hashString(JSON.stringify(relevantTranslations));
+}
+function computeAllChunkHashes(translations, manifest) {
+  const hashes = {};
+  for (const [chunkId, keys] of Object.entries(manifest)) {
+    hashes[chunkId] = computeChunkHash(translations, keys);
+  }
+  return hashes;
+}
+function createI18nEndpoint(options) {
+  const { cms, manifest } = options;
+  const translationCache2 = /* @__PURE__ */ new Map();
+  return async ({ params }) => {
+    const { path } = params;
+    if (!path) {
+      return new Response("Not found", { status: 404 });
+    }
+    const match = path.match(/^([^/]+)\/(.+)\.([a-z0-9]+)\.js$/);
+    if (!match) {
+      return new Response("Invalid path", { status: 400 });
+    }
+    const [, locale, chunkId, requestedHash] = match;
+    const chunkFileName = `${chunkId}.js`;
+    const keys = manifest[chunkFileName] || manifest[chunkId];
+    if (!keys) {
+      return new Response(`/* chunk not found: ${chunkId} */`, {
+        status: 404,
+        headers: { "Content-Type": "application/javascript" }
+      });
+    }
+    let translations = translationCache2.get(locale);
+    if (!translations) {
+      translations = await cms.fetch(locale, []);
+      translationCache2.set(locale, translations);
+    }
+    const actualHash = computeChunkHash(translations, keys);
+    if (requestedHash !== actualHash) {
+      console.warn(`[i18n] hash mismatch for ${chunkId}: expected ${actualHash}, got ${requestedHash}`);
+    }
+    const chunkTranslations = {};
+    for (const key of keys) {
+      if (translations[key]) {
+        chunkTranslations[key] = translations[key];
+      }
+    }
+    const js = `/* @astroscope/i18n chunk: ${chunkId} */
+(function() {
+  window.__i18n__ = window.__i18n__ || {};
+  Object.assign(window.__i18n__, ${JSON.stringify(chunkTranslations)});
+})();
+`;
+    return new Response(js, {
+      status: 200,
+      headers: {
+        "Content-Type": "application/javascript",
+        // immutable cache - hash in URL ensures cache busting
+        "Cache-Control": "public, max-age=31536000, immutable"
+      }
+    });
+  };
+}
+
+// src/middleware.ts
+function defaultDetectLocale(request, locales, defaultLocale) {
+  const acceptLanguage = request.headers.get("accept-language");
+  if (!acceptLanguage) {
+    return defaultLocale;
+  }
+  const preferred = acceptLanguage.split(",").map((part) => {
+    const [lang, q = "q=1"] = part.trim().split(";");
+    return {
+      lang: lang.split("-")[0].toLowerCase(),
+      q: parseFloat(q.replace("q=", ""))
+    };
+  }).sort((a, b) => b.q - a.q);
+  for (const { lang } of preferred) {
+    if (locales.includes(lang)) {
+      return lang;
+    }
+  }
+  return defaultLocale;
+}
+var translationCache = /* @__PURE__ */ new Map();
+var hashCache = /* @__PURE__ */ new Map();
+function generateI18nHashScript(locale, hashes, fallback) {
+  const fallbackValue = typeof fallback === "function" ? "example" : fallback;
+  return `<script>window.__i18n_locale__=${JSON.stringify(locale)};window.__i18n_fallback__=${JSON.stringify(fallbackValue)};window.__i18n_hashes__=${JSON.stringify(hashes)};window.__i18n__=window.__i18n__||{};</script>`;
+}
+function generateI18nFullScript(locale, raw, fallback) {
+  const fallbackValue = typeof fallback === "function" ? "example" : fallback;
+  return `<script>window.__i18n_locale__=${JSON.stringify(locale)};window.__i18n_fallback__=${JSON.stringify(fallbackValue)};window.__i18n__=${JSON.stringify(raw)};</script>`;
+}
+async function injectI18nScript(response, script) {
+  const contentType = response.headers.get("content-type");
+  if (!contentType?.includes("text/html")) {
+    return response;
+  }
+  const html = await response.text();
+  let injectedHtml;
+  if (html.includes("</head>")) {
+    injectedHtml = html.replace("</head>", `${script}</head>`);
+  } else if (html.includes("<body")) {
+    injectedHtml = html.replace(/<body([^>]*)>/, `<body$1>${script}`);
+  } else {
+    injectedHtml = script + html;
+  }
+  return new Response(injectedHtml, {
+    status: response.status,
+    statusText: response.statusText,
+    headers: response.headers
+  });
+}
+function createI18nMiddleware(options) {
+  const { locales, defaultLocale, fallback, cms, detectLocale, chunkManifest } = options;
+  return async (ctx, next) => {
+    const locale = detectLocale ? detectLocale(ctx.request) : ctx.currentLocale ?? defaultDetectLocale(ctx.request, locales, defaultLocale);
+    let raw = translationCache.get(locale);
+    if (!raw) {
+      raw = await cms.fetch(locale, []);
+      translationCache.set(locale, raw);
+      if (chunkManifest) {
+        const hashes = computeAllChunkHashes(raw, chunkManifest);
+        hashCache.set(locale, hashes);
+      }
+    }
+    const translations = compileTranslations(locale, raw);
+    const context = {
+      locale,
+      translations,
+      fallback,
+      meta: {}
+    };
+    setContext(context);
+    try {
+      const response = await next();
+      let script;
+      if (chunkManifest) {
+        const hashes = hashCache.get(locale) || {};
+        script = generateI18nHashScript(locale, hashes, fallback);
+      } else {
+        script = generateI18nFullScript(locale, raw, fallback);
+      }
+      const injectedResponse = await injectI18nScript(response, script);
+      return injectedResponse;
+    } finally {
+      clearContext();
+    }
+  };
+}
+function getCachedTranslations(locale) {
+  return translationCache.get(locale);
+}
+function clearTranslationCache(locale) {
+  if (locale) {
+    translationCache.delete(locale);
+    hashCache.delete(locale);
+  } else {
+    translationCache.clear();
+    hashCache.clear();
+  }
+}
+
+export {
+  computeChunkHash,
+  computeAllChunkHashes,
+  createI18nEndpoint,
+  createI18nMiddleware,
+  getCachedTranslations,
+  clearTranslationCache
+};