@astroscope/i18n 0.1.0 → 0.2.0

package/dist/chunk-LRLZEX4D.js

@@ -1,147 +0,0 @@
-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();
-  // extraction manifest (loaded from virtual module at init time)
-  manifest = { keys: [], chunks: {} };
-  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"
-    };
-  }
-  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.getChunkManifest();
-    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) ?? {};
-  }
-  getChunkManifest() {
-    return this.manifest.chunks;
-  }
-  /**
-   * Get extracted translation keys with metadata.
-   * Use this to populate your translation provider with keys extracted from the codebase.
-   */
-  getExtractedKeys() {
-    return this.manifest.keys;
-  }
-  /**
-   * Get the full extraction manifest (keys + chunks).
-   */
-  getExtractionManifest() {
-    return this.manifest;
-  }
-  /**
-   * Set the extraction manifest (called by init module).
-   * @internal
-   */
-  setManifest(manifest) {
-    this.manifest = manifest;
-  }
-  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();
-
-export {
-  i18n
-};

package/dist/chunk-MFKPLUAN.js

@@ -1,241 +0,0 @@
-import {
-  chunkIdToName
-} from "./chunk-4A5BKHFN.js";
-
-// src/extraction/vite-plugin.ts
-import path from "path";
-var VIRTUAL_MODULE_ID = "virtual:@astroscope/i18n/manifest";
-var RESOLVED_VIRTUAL_MODULE_ID = `\0${VIRTUAL_MODULE_ID}`;
-var MANIFEST_FILE_NAME = "i18n-manifest.json";
-var globalExtractedKeys = [];
-var globalChunkManifest = {};
-var globalProjectRoot = "";
-function getManifest() {
-  const keysWithRelativePaths = globalExtractedKeys.map((key) => ({
-    ...key,
-    file: globalProjectRoot ? path.relative(globalProjectRoot, key.file) : key.file
-  }));
-  return {
-    keys: keysWithRelativePaths,
-    chunks: globalChunkManifest
-  };
-}
-function extractBalancedBraces(code, startIndex) {
-  if (code[startIndex] !== "{") return null;
-  let depth = 0;
-  let i = startIndex;
-  while (i < code.length) {
-    if (code[i] === "{") depth++;
-    else if (code[i] === "}") {
-      depth--;
-      if (depth === 0) return code.slice(startIndex, i + 1);
-    }
-    i++;
-  }
-  return null;
-}
-function extractTranslationCalls(code, filename) {
-  const keys = [];
-  const regex = /\bt\s*\(\s*['"`]([^'"`]+)['"`]\s*,\s*/g;
-  let match;
-  while ((match = regex.exec(code)) !== null) {
-    const key = match[1];
-    const afterKey = code.slice(match.index + match[0].length);
-    const upToMatch = code.slice(0, match.index);
-    const lineNumber = (upToMatch.match(/\n/g) || []).length + 1;
-    try {
-      const stringMatch = afterKey.match(/^['"`]([^'"`]*)['"`]/);
-      if (stringMatch) {
-        keys.push({
-          key,
-          meta: { fallback: stringMatch[1] },
-          file: filename,
-          line: lineNumber
-        });
-      } else if (afterKey.startsWith("{")) {
-        const metaStr = extractBalancedBraces(afterKey, 0);
-        if (metaStr) {
-          const fallbackMatch = metaStr.match(/fallback\s*:\s*['"`]([^'"`]+)['"`]/);
-          const descMatch = metaStr.match(/description\s*:\s*['"`]([^'"`]+)['"`]/);
-          const fallback = fallbackMatch ? fallbackMatch[1] : "";
-          const description = descMatch ? descMatch[1] : void 0;
-          const varsBlockMatch = metaStr.match(/variables\s*:\s*\{/);
-          let variables;
-          if (varsBlockMatch) {
-            const varsStart = metaStr.indexOf("{", varsBlockMatch.index + varsBlockMatch[0].length - 1);
-            const varsStr = extractBalancedBraces(metaStr, varsStart);
-            if (varsStr) {
-              variables = parseVariables(varsStr);
-            }
-          }
-          keys.push({
-            key,
-            meta: { fallback, description, variables },
-            file: filename,
-            line: lineNumber
-          });
-        }
-      }
-    } catch {
-    }
-  }
-  return keys;
-}
-function parseVariables(str) {
-  const result = {};
-  const varNameRegex = /(\w+)\s*:\s*\{/g;
-  let nameMatch;
-  while ((nameMatch = varNameRegex.exec(str)) !== null) {
-    const varName = nameMatch[1];
-    const varStart = str.indexOf("{", nameMatch.index + nameMatch[0].length - 1);
-    const varObj = extractBalancedBraces(str, varStart);
-    if (varObj) {
-      const fallbackMatch = varObj.match(/fallback\s*:\s*['"`]([^'"`]*)['"`]/);
-      const descMatch = varObj.match(/description\s*:\s*['"`]([^'"`]*)['"`]/);
-      result[varName] = {
-        fallback: fallbackMatch ? fallbackMatch[1] : void 0,
-        description: descMatch ? descMatch[1] : void 0
-      };
-    }
-  }
-  return Object.keys(result).length > 0 ? result : void 0;
-}
-function hasI18nImport(code) {
-  return /@astroscope\/i18n\/t/.test(code);
-}
-function i18nVitePlugin(options) {
-  const { include = [".ts", ".tsx", ".js", ".jsx", ".astro"], logger } = options;
-  const extractedKeys = [];
-  const fileToKeys = /* @__PURE__ */ new Map();
-  const filesWithI18n = /* @__PURE__ */ new Set();
-  let chunkManifest = {};
-  let projectRoot = "";
-  let isBuild = false;
-  return {
-    name: "@astroscope/i18n/extract",
-    enforce: "pre",
-    configResolved(config) {
-      projectRoot = config.root;
-      globalProjectRoot = config.root;
-      isBuild = config.command === "build";
-    },
-    resolveId(id) {
-      if (id === VIRTUAL_MODULE_ID) {
-        return RESOLVED_VIRTUAL_MODULE_ID;
-      }
-      if (id.startsWith(`${VIRTUAL_MODULE_ID}?`)) {
-        return `\0${id}`;
-      }
-    },
-    load(id) {
-      if (id === RESOLVED_VIRTUAL_MODULE_ID || id.startsWith(`\0${VIRTUAL_MODULE_ID}?`)) {
-        if (isBuild) {
-          return `
-import { readFileSync } from 'node:fs';
-import { fileURLToPath } from 'node:url';
-import { dirname, join } from 'node:path';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const manifestPath = join(__dirname, '${MANIFEST_FILE_NAME}');
-const manifestJson = JSON.parse(readFileSync(manifestPath, 'utf-8'));
-
-export const manifest = manifestJson;
-export function getManifest() { return manifestJson; }
-`;
-        }
-        const keysWithRelativePaths = extractedKeys.map((key) => ({
-          ...key,
-          file: projectRoot ? path.relative(projectRoot, key.file) : key.file
-        }));
-        const manifest = {
-          keys: keysWithRelativePaths,
-          chunks: chunkManifest
-        };
-        return `
-export const manifest = ${JSON.stringify(manifest)};
-export function getManifest() { return ${JSON.stringify(manifest)}; }
-`;
-      }
-    },
-    transform(code, id) {
-      if (!include.some((ext) => id.endsWith(ext))) {
-        return null;
-      }
-      if (id.includes("node_modules")) {
-        return null;
-      }
-      if (hasI18nImport(code)) {
-        filesWithI18n.add(id);
-      }
-      const keys = extractTranslationCalls(code, id);
-      if (keys.length > 0) {
-        extractedKeys.push(...keys);
-        globalExtractedKeys = extractedKeys;
-        fileToKeys.set(
-          id,
-          keys.map((k) => k.key)
-        );
-      }
-      return null;
-    },
-    generateBundle(_, bundle) {
-      chunkManifest = {};
-      for (const [fileName, chunk] of Object.entries(bundle)) {
-        if (chunk.type === "chunk" && chunk.moduleIds) {
-          const keys = /* @__PURE__ */ new Set();
-          let hasI18nModule = false;
-          for (const moduleId of chunk.moduleIds) {
-            const moduleKeys = fileToKeys.get(moduleId);
-            if (moduleKeys) {
-              moduleKeys.forEach((k) => keys.add(k));
-            }
-            if (filesWithI18n.has(moduleId)) {
-              hasI18nModule = true;
-            }
-          }
-          if (keys.size > 0) {
-            const chunkName = chunkIdToName(fileName.replace(/\.js$/, ""));
-            chunkManifest[chunkName] = Array.from(keys);
-          }
-          if (hasI18nModule && chunk.type === "chunk") {
-            const chunkName = chunkIdToName(fileName.replace(/\.js$/, ""));
-            const loaderCode = `
-/* @astroscope/i18n loader */
-if (typeof window !== 'undefined' && window.__i18n__) {
-  const __i18n__ = window.__i18n__;
-  const __i18n_hash__ = __i18n__.hashes[${JSON.stringify(chunkName)}];
-  if (__i18n_hash__) {
-    await import(\`/_i18n/\${__i18n__.locale}/${chunkName}.\${__i18n_hash__}.js\`);
-  }
-}
-/* end @astroscope/i18n loader */
-`;
-            chunk.code = loaderCode + chunk.code;
-          }
-        }
-      }
-      globalChunkManifest = chunkManifest;
-      const keysWithRelativePaths = extractedKeys.map((key) => ({
-        ...key,
-        file: projectRoot ? path.relative(projectRoot, key.file) : key.file
-      }));
-      const manifest = {
-        keys: keysWithRelativePaths,
-        chunks: chunkManifest
-      };
-      this.emitFile({
-        type: "asset",
-        fileName: MANIFEST_FILE_NAME,
-        source: JSON.stringify(manifest)
-      });
-      const chunkCount = Object.keys(chunkManifest).length;
-      const keyCount = extractedKeys.length;
-      logger?.info(`manifest: ${chunkCount} chunks, ${keyCount} keys`);
-    }
-  };
-}
-
-export {
-  getManifest,
-  i18nVitePlugin
-};

package/dist/chunk-MIWXQOO3.js

@@ -1,316 +0,0 @@
-import {
-  clearContext,
-  compileTranslations,
-  setContext
-} from "./chunk-AYY2YIBQ.js";
-
-// src/extraction/hash.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;
-}
-
-// src/server/service.ts
-var instance = null;
-function createI18nService(config) {
-  if (instance) {
-    throw new Error("i18n service already created. Call createI18nService() only once.");
-  }
-  instance = new I18nServiceImpl(config);
-  return instance;
-}
-function getI18nService() {
-  if (!instance) {
-    throw new Error(
-      "i18n service not initialized. Call createI18nService() before first request (e.g., in your boot file)."
-    );
-  }
-  return instance;
-}
-function hasI18nService() {
-  return instance !== null;
-}
-var I18nServiceImpl = class {
-  config;
-  // raw translation cache per locale
-  rawCache = /* @__PURE__ */ new Map();
-  // compiled translation cache per locale
-  compiledCache = /* @__PURE__ */ new Map();
-  // hash cache per locale (for per-chunk loading)
-  hashCache = /* @__PURE__ */ new Map();
-  // chunk manifest from build
-  chunkManifest;
-  // track in-progress fetches to avoid duplicate requests
-  fetchInProgress = /* @__PURE__ */ new Map();
-  constructor(config) {
-    this.config = Object.freeze({ ...config });
-  }
-  invalidate(locales) {
-    const targets = this.resolveLocales(locales);
-    for (const locale of targets) {
-      this.rawCache.delete(locale);
-      this.compiledCache.delete(locale);
-      this.hashCache.delete(locale);
-      this.fetchInProgress.delete(locale);
-    }
-  }
-  async refresh(locales) {
-    const targets = this.resolveLocales(locales);
-    const fetches = targets.map(async (locale) => {
-      const raw = await this.fetchTranslations(locale);
-      return { locale, raw };
-    });
-    const results = await Promise.all(fetches);
-    for (const { locale, raw } of results) {
-      this.rawCache.set(locale, raw);
-      this.compiledCache.set(locale, compileTranslations(locale, raw));
-      if (this.chunkManifest) {
-        this.hashCache.set(locale, computeAllChunkHashes(raw, this.chunkManifest));
-      }
-    }
-  }
-  async prefetch(locales) {
-    const targets = this.resolveLocales(locales);
-    await Promise.all(
-      targets.map(async (locale) => {
-        if (this.rawCache.has(locale)) return;
-        const raw = await this.fetchTranslations(locale);
-        this.rawCache.set(locale, raw);
-        this.compiledCache.set(locale, compileTranslations(locale, raw));
-        if (this.chunkManifest) {
-          this.hashCache.set(locale, computeAllChunkHashes(raw, this.chunkManifest));
-        }
-      })
-    );
-  }
-  async getTranslations(locale) {
-    const cached = this.compiledCache.get(locale);
-    if (cached) return cached;
-    const raw = await this.ensureRawTranslations(locale);
-    const compiled = compileTranslations(locale, raw);
-    this.compiledCache.set(locale, compiled);
-    return compiled;
-  }
-  async getRawTranslations(locale) {
-    return this.ensureRawTranslations(locale);
-  }
-  getHashes(locale) {
-    return this.hashCache.get(locale);
-  }
-  setChunkManifest(manifest) {
-    this.chunkManifest = manifest;
-    if (manifest) {
-      for (const [locale, raw] of this.rawCache) {
-        this.hashCache.set(locale, computeAllChunkHashes(raw, manifest));
-      }
-    }
-  }
-  getChunkManifest() {
-    return this.chunkManifest;
-  }
-  /**
-   * Ensure raw translations are cached, fetching if needed
-   */
-  async ensureRawTranslations(locale) {
-    const cached = this.rawCache.get(locale);
-    if (cached) return cached;
-    const raw = await this.fetchTranslations(locale);
-    this.rawCache.set(locale, raw);
-    if (this.chunkManifest) {
-      this.hashCache.set(locale, computeAllChunkHashes(raw, this.chunkManifest));
-    }
-    return raw;
-  }
-  /**
-   * Fetch translations, deduplicating concurrent requests
-   */
-  async fetchTranslations(locale) {
-    const inProgress = this.fetchInProgress.get(locale);
-    if (inProgress) return inProgress;
-    const fetchPromise = this.config.fetch(locale, []).finally(() => {
-      this.fetchInProgress.delete(locale);
-    });
-    this.fetchInProgress.set(locale, fetchPromise);
-    return fetchPromise;
-  }
-  /**
-   * Resolve locale argument to array of locales
-   */
-  resolveLocales(locales) {
-    if (!locales) return this.config.locales;
-    if (typeof locales === "string") return [locales];
-    return locales;
-  }
-};
-
-// src/server/middleware.ts
-var I18N_ENDPOINT_PREFIX = "/_i18n/";
-function defaultDetectLocale(request, locales, defaultLocale) {
-  const url = new URL(request.url);
-  const localeParam = url.searchParams.get("locale");
-  if (localeParam && locales.includes(localeParam)) {
-    return localeParam;
-  }
-  const acceptLanguage = request.headers.get("accept-language");
-  if (acceptLanguage) {
-    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;
-}
-function generateI18nHashScript(locale, hashes) {
-  const state = { locale, hashes, translations: {} };
-  return `<script>window.__i18n__=${JSON.stringify(state)};</script>`;
-}
-function generateI18nFullScript(locale, raw) {
-  const state = { locale, hashes: {}, translations: raw };
-  return `<script>window.__i18n__=${JSON.stringify(state)};</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 parseI18nEndpointPath(pathname) {
-  if (!pathname.startsWith(I18N_ENDPOINT_PREFIX)) {
-    return null;
-  }
-  const path = pathname.slice(I18N_ENDPOINT_PREFIX.length);
-  const match = path.match(/^([^/]+)\/(.+)\.([a-z0-9]+)\.js$/);
-  if (!match) {
-    return null;
-  }
-  return { locale: match[1], chunkName: match[2], hash: match[3] };
-}
-function handleI18nEndpoint(chunkName, requestedHash, translations, chunkManifest) {
-  const keys = chunkManifest[chunkName];
-  if (!keys) {
-    return new Response(`/* chunk not found: ${chunkName} */`, {
-      status: 404,
-      headers: { "Content-Type": "application/javascript" }
-    });
-  }
-  const actualHash = computeChunkHash(translations, keys);
-  if (requestedHash !== actualHash) {
-    console.warn(`[i18n] hash mismatch for ${chunkName}: expected ${actualHash}, got ${requestedHash}`);
-  }
-  const chunkTranslations = {};
-  for (const key of keys) {
-    if (translations[key]) {
-      chunkTranslations[key] = translations[key];
-    }
-  }
-  const js = `/* @astroscope/i18n chunk: ${chunkName} */
-(function() {
-  var i = window.__i18n__;
-  if (i) Object.assign(i.translations, ${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"
-    }
-  });
-}
-function createI18nMiddleware(options) {
-  const { locales, defaultLocale, fallback, detectLocale, chunkManifest } = options;
-  const service = getI18nService();
-  if (chunkManifest) {
-    service.setChunkManifest(chunkManifest);
-  }
-  return async (ctx, next) => {
-    const pathname = new URL(ctx.request.url).pathname;
-    const serviceChunkManifest = service.getChunkManifest();
-    if (serviceChunkManifest) {
-      const endpointParams = parseI18nEndpointPath(pathname);
-      if (endpointParams) {
-        const { locale: urlLocale, chunkName, hash } = endpointParams;
-        const endpointRaw = await service.getRawTranslations(urlLocale);
-        return handleI18nEndpoint(chunkName, hash, endpointRaw, serviceChunkManifest);
-      }
-    }
-    const locale = detectLocale ? detectLocale(ctx.request) : ctx.currentLocale ?? defaultDetectLocale(ctx.request, locales, defaultLocale);
-    const translations = await service.getTranslations(locale);
-    const raw = await service.getRawTranslations(locale);
-    const context = {
-      locale,
-      translations,
-      fallback,
-      meta: {}
-    };
-    setContext(context);
-    try {
-      const response = await next();
-      let script;
-      const hasChunkManifest = serviceChunkManifest && Object.keys(serviceChunkManifest).length > 0;
-      if (hasChunkManifest) {
-        const hashes = service.getHashes(locale) ?? {};
-        script = generateI18nHashScript(locale, hashes);
-      } else {
-        script = generateI18nFullScript(locale, raw);
-      }
-      const injectedResponse = await injectI18nScript(response, script);
-      return injectedResponse;
-    } finally {
-      clearContext();
-    }
-  };
-}
-
-export {
-  computeChunkHash,
-  computeAllChunkHashes,
-  createI18nService,
-  getI18nService,
-  hasI18nService,
-  createI18nMiddleware
-};