@astroscope/i18n 0.5.0 → 0.6.0

package/dist/chunk-PACQPCSW.js

@@ -1,479 +0,0 @@
-import {
-  getGlobalState,
-  getManifest
-} from "./chunk-FYKC3DAZ.js";
-import {
-  chunkIdToName
-} from "./chunk-4A5BKHFN.js";
-
-// src/extraction/vite-plugin.ts
-import fs2 from "fs";
-import path2 from "path";
-import MagicString from "magic-string";
-
-// src/extraction/extract.ts
-var TS_EXTENSIONS = [".ts", ".tsx"];
-var JSX_EXTENSIONS = [".jsx", ".tsx"];
-var JS_EXTENSIONS = [".js", ".jsx"];
-var BABEL_EXTENSIONS = [...TS_EXTENSIONS, ...JS_EXTENSIONS];
-var ALL_EXTENSIONS = [...BABEL_EXTENSIONS, ".astro"];
-async function extractKeysFromFile(options) {
-  const { filename, code, logger, stripFallbacks = false, onKeyExtracted } = options;
-  const keys = [];
-  const [{ transformAsync }, { i18nExtractPlugin }] = await Promise.all([
-    import("@babel/core"),
-    import("./babel-plugin-GOB6FMZ2.js")
-  ]);
-  const isTypeScript = TS_EXTENSIONS.some((ext) => filename.endsWith(ext)) || filename.endsWith(".astro");
-  const isJSX = JSX_EXTENSIONS.some((ext) => filename.endsWith(ext));
-  const result = await transformAsync(code, {
-    filename,
-    sourceMaps: stripFallbacks,
-    // only need source maps when transforming
-    babelrc: false,
-    configFile: false,
-    parserOpts: {
-      plugins: [...isTypeScript ? ["typescript"] : [], ...isJSX ? ["jsx"] : []]
-    },
-    plugins: [
-      [
-        i18nExtractPlugin,
-        {
-          stripFallbacks,
-          onKeyExtracted: (key) => {
-            keys.push(key);
-            onKeyExtracted?.(key);
-          },
-          logger
-        }
-      ]
-    ]
-  });
-  return {
-    keys,
-    code: result?.code ?? null,
-    map: result?.map
-  };
-}
-
-// src/extraction/key-store.ts
-var KeyStore = class {
-  constructor(logger, consistency = "warn") {
-    this.logger = logger;
-    this.consistency = consistency;
-  }
-  logger;
-  consistency;
-  /** All key occurrences (may have duplicates) */
-  occurrences = [];
-  /** Tracks reported inconsistencies to avoid duplicate warnings */
-  reportedInconsistencies = /* @__PURE__ */ new Set();
-  /** Whether an error-level inconsistency was found (for build failure) */
-  hasInconsistencyError = false;
-  fileToKeys = /* @__PURE__ */ new Map();
-  filesWithI18n = /* @__PURE__ */ new Set();
-  /**
-   * Add key occurrences for a file, replacing any existing occurrences for that file.
-   */
-  addFileKeys(filename, keys) {
-    const newKeyStrings = keys.map((k) => k.key);
-    const oldKeys = this.fileToKeys.get(filename);
-    if (oldKeys) {
-      const uniqueNew = [...new Set(newKeyStrings)];
-      const uniqueOld = [...new Set(oldKeys)];
-      const added = uniqueNew.filter((k) => !uniqueOld.includes(k));
-      const removed = uniqueOld.filter((k) => !uniqueNew.includes(k));
-      const file = filename.split("/").pop();
-      if (added.length > 0 || removed.length > 0) {
-        const parts = [];
-        if (added.length > 0) parts.push(`+${added.length}`);
-        if (removed.length > 0) parts.push(`-${removed.length}`);
-        this.logger.info(`hmr: ${parts.join(" ")} key(s) in ${file}`);
-      }
-    }
-    if (oldKeys) {
-      for (let i = this.occurrences.length - 1; i >= 0; i--) {
-        if (this.occurrences[i]?.file === filename) {
-          this.occurrences.splice(i, 1);
-        }
-      }
-    }
-    this.filesWithI18n.add(filename);
-    if (this.consistency !== "off") {
-      this.checkConsistency(keys);
-    }
-    if (keys.length > 0) {
-      this.occurrences.push(...keys);
-    }
-    this.fileToKeys.set(filename, newKeyStrings);
-  }
-  /**
-   * Check new keys for inconsistencies with existing occurrences.
-   */
-  checkConsistency(newKeys) {
-    const existingByKey = /* @__PURE__ */ new Map();
-    for (const occ of this.occurrences) {
-      if (!existingByKey.has(occ.key)) {
-        existingByKey.set(occ.key, occ);
-      }
-    }
-    for (const newKey of newKeys) {
-      const existing = existingByKey.get(newKey.key);
-      if (!existing) continue;
-      const inconsistencies = this.findInconsistencies(newKey, existing);
-      for (const inc of inconsistencies) {
-        this.reportInconsistency(inc);
-      }
-    }
-  }
-  /**
-   * Compare two occurrences and find any metadata inconsistencies.
-   */
-  findInconsistencies(a, b) {
-    const result = [];
-    const locA = `${a.file}:${a.line}`;
-    const locB = `${b.file}:${b.line}`;
-    if (a.meta.fallback !== b.meta.fallback) {
-      result.push({
-        key: a.key,
-        field: "fallback",
-        locations: [locA, locB],
-        values: [a.meta.fallback, b.meta.fallback]
-      });
-    }
-    if (a.meta.description !== b.meta.description) {
-      result.push({
-        key: a.key,
-        field: "description",
-        locations: [locA, locB],
-        values: [a.meta.description ?? "(none)", b.meta.description ?? "(none)"]
-      });
-    }
-    const varsA = this.serializeVariables(a.meta);
-    const varsB = this.serializeVariables(b.meta);
-    if (varsA !== varsB) {
-      result.push({
-        key: a.key,
-        field: "variables",
-        locations: [locA, locB],
-        values: [varsA || "(none)", varsB || "(none)"]
-      });
-    }
-    return result;
-  }
-  /**
-   * Serialize variables for comparison.
-   */
-  serializeVariables(meta) {
-    if (!meta.variables) return "";
-    const sorted = {};
-    for (const key of Object.keys(meta.variables).sort()) {
-      sorted[key] = meta.variables[key];
-    }
-    return JSON.stringify(sorted);
-  }
-  /**
-   * Report an inconsistency via logger.
-   */
-  reportInconsistency(inc) {
-    const incKey = `${inc.key}:${inc.field}`;
-    if (this.reportedInconsistencies.has(incKey)) return;
-    this.reportedInconsistencies.add(incKey);
-    const message = `inconsistent ${inc.field} for key "${inc.key}"
-  ${inc.locations[0]}: ${JSON.stringify(inc.values[0])}
-  ${inc.locations[1]}: ${JSON.stringify(inc.values[1])}`;
-    if (this.consistency === "error") {
-      this.logger.error(message);
-      this.hasInconsistencyError = true;
-    } else {
-      this.logger.warn(message);
-    }
-  }
-  /**
-   * Check if any error-level inconsistencies were found.
-   * Call this at the end of build to determine if it should fail.
-   */
-  get hasErrors() {
-    return this.hasInconsistencyError;
-  }
-  /**
-   * Get deduplicated keys with all file locations merged.
-   * Last occurrence's meta wins for each key.
-   */
-  get extractedKeys() {
-    const keyMap = /* @__PURE__ */ new Map();
-    for (const occurrence of this.occurrences) {
-      const existing = keyMap.get(occurrence.key);
-      const fileLocation = `${occurrence.file}:${occurrence.line}`;
-      if (existing) {
-        if (!existing.files.includes(fileLocation)) {
-          existing.files.push(fileLocation);
-        }
-        existing.meta = occurrence.meta;
-      } else {
-        keyMap.set(occurrence.key, {
-          key: occurrence.key,
-          meta: occurrence.meta,
-          files: [fileLocation]
-        });
-      }
-    }
-    return Array.from(keyMap.values());
-  }
-  /**
-   * Get count of unique keys.
-   */
-  get uniqueKeyCount() {
-    return new Set(this.occurrences.map((k) => k.key)).size;
-  }
-  /**
-   * Merge another store's data into this one.
-   */
-  merge(other) {
-    for (const [file, keys] of other.fileToKeys) {
-      this.fileToKeys.set(file, keys);
-    }
-    for (const file of other.filesWithI18n) {
-      this.filesWithI18n.add(file);
-    }
-    if (this.consistency !== "off") {
-      this.checkConsistency(other.occurrences);
-    }
-    this.occurrences.push(...other.occurrences);
-  }
-  /**
-   * Internal access to occurrences (for merge)
-   */
-  get occurrencesList() {
-    return this.occurrences;
-  }
-};
-
-// src/extraction/scan.ts
-import fs from "fs";
-import path from "path";
-var GLOB_PATTERN = `src/**/*.{${ALL_EXTENSIONS.map((e) => e.slice(1)).join(",")}}`;
-async function compileAstro(code, filename) {
-  try {
-    const { transform } = await import("@astrojs/compiler");
-    const result = await transform(code, { filename });
-    return result.code;
-  } catch {
-    return null;
-  }
-}
-async function scan(options) {
-  const { projectRoot, logger, consistency } = options;
-  const store = new KeyStore(logger, consistency);
-  const files = [];
-  for await (const entry of fs.promises.glob(GLOB_PATTERN, {
-    cwd: projectRoot,
-    exclude: (name) => name === "node_modules"
-  })) {
-    files.push(path.resolve(projectRoot, entry));
-  }
-  const results = await Promise.all(
-    files.map(async (file) => {
-      let code = await fs.promises.readFile(file, "utf-8");
-      if (!code.includes("@astroscope/i18n/translate")) {
-        return { file, keys: null };
-      }
-      if (file.endsWith(".astro")) {
-        const compiled = await compileAstro(code, file);
-        if (!compiled) {
-          return { file, keys: null };
-        }
-        code = compiled;
-      }
-      const result = await extractKeysFromFile({
-        filename: file,
-        code,
-        logger,
-        stripFallbacks: false
-      });
-      return { file, keys: result.keys.length > 0 ? result.keys : null };
-    })
-  );
-  for (const { file, keys } of results) {
-    if (keys) {
-      store.addFileKeys(file, keys);
-    }
-  }
-  return store;
-}
-
-// src/extraction/vite-plugin.ts
-var VIRTUAL_MODULE_ID = "virtual:@astroscope/i18n/manifest";
-var isVirtualModuleId = (id) => id === VIRTUAL_MODULE_ID || id.startsWith(`${VIRTUAL_MODULE_ID}?`);
-var RESOLVED_VIRTUAL_MODULE_ID = `\0${VIRTUAL_MODULE_ID}`;
-var isResolvedVirtualModuleId = (id) => id === RESOLVED_VIRTUAL_MODULE_ID || id.startsWith(`\0${VIRTUAL_MODULE_ID}?`);
-var MANIFEST_FILE_NAME = "i18n-manifest.json";
-function i18nVitePlugin(options) {
-  const { logger, consistency } = options;
-  const store = new KeyStore(logger, consistency);
-  const syncGlobalState = () => {
-    const state = getGlobalState();
-    state.extractedKeys = store.extractedKeys;
-    state.version++;
-  };
-  let isBuild = false;
-  let projectRoot = "";
-  return {
-    name: "@astroscope/i18n/extract",
-    enforce: "pre",
-    configResolved(config) {
-      const state = getGlobalState();
-      state.projectRoot = config.root;
-      isBuild = config.command === "build";
-      projectRoot = config.root;
-    },
-    async configureServer(server) {
-      if (server.config.isProduction || isBuild) {
-        return;
-      }
-      const result = await scan({ projectRoot, logger, consistency });
-      store.merge(result);
-      syncGlobalState();
-      logger.info(`dev mode: scanned ${result.fileToKeys.size} files, found ${result.uniqueKeyCount} keys`);
-    },
-    resolveId(id) {
-      if (isVirtualModuleId(id)) {
-        return `\0${id}`;
-      }
-    },
-    load(id) {
-      if (isResolvedVirtualModuleId(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 manifestJson = JSON.parse(readFileSync(join(__dirname, '${MANIFEST_FILE_NAME}'), 'utf-8'));
-
-export const manifest = manifestJson;
-export function getManifest() { return manifestJson; }
-`;
-        }
-        return `
-import { getManifest as _getManifest } from '@astroscope/i18n/extraction';
-export const manifest = { keys: [], chunks: {} };
-export function getManifest() { return _getManifest(); }
-`;
-      }
-    },
-    async transform(code, filename) {
-      if (!ALL_EXTENSIONS.some((ext) => filename.endsWith(ext))) {
-        return null;
-      }
-      if (filename.includes("node_modules")) {
-        return null;
-      }
-      if (!code.includes("@astroscope/i18n/translate")) {
-        return null;
-      }
-      const result = await extractKeysFromFile({
-        filename,
-        code,
-        logger,
-        stripFallbacks: isBuild
-      });
-      store.addFileKeys(filename, result.keys);
-      syncGlobalState();
-      if (isBuild && result.code) {
-        return { code: result.code, map: result.map };
-      }
-      return null;
-    },
-    generateBundle(_, bundle) {
-      const state = getGlobalState();
-      state.chunkManifest = {};
-      state.importsManifest = {};
-      const chunksWithI18n = /* @__PURE__ */ new Set();
-      const chunkNameToFileName = /* @__PURE__ */ new Map();
-      const directImports = /* @__PURE__ */ new Map();
-      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 = store.fileToKeys.get(moduleId);
-            moduleKeys?.forEach((k) => keys.add(k));
-            if (store.filesWithI18n.has(moduleId)) {
-              hasI18nModule = true;
-            }
-          }
-          const chunkName = chunkIdToName(fileName.replace(/\.js$/, ""));
-          if (keys.size) {
-            state.chunkManifest[chunkName] = Array.from(keys);
-          }
-          if (hasI18nModule) {
-            chunksWithI18n.add(chunkName);
-          }
-          chunkNameToFileName.set(chunkName, fileName);
-          const imports = [];
-          for (const importedFile of chunk.imports) {
-            const baseName = importedFile.replace(/^.*\//, "").replace(/\.js$/, "");
-            const importedChunkName = chunkIdToName(baseName);
-            imports.push(importedChunkName);
-          }
-          directImports.set(chunkName, imports);
-        }
-      }
-      const flattenImports = (chunkName, visited) => {
-        if (visited.has(chunkName)) return [];
-        visited.add(chunkName);
-        const result = /* @__PURE__ */ new Set();
-        const imports = directImports.get(chunkName) ?? [];
-        for (const imported of imports) {
-          if (state.chunkManifest[imported]) {
-            result.add(imported);
-          }
-          for (const descendant of flattenImports(imported, visited)) {
-            result.add(descendant);
-          }
-        }
-        visited.delete(chunkName);
-        return Array.from(result);
-      };
-      for (const chunkName of directImports.keys()) {
-        const flattened = flattenImports(chunkName, /* @__PURE__ */ new Set());
-        if (flattened.length > 0) {
-          state.importsManifest[chunkName] = flattened;
-        }
-      }
-      for (const [fileName, chunk] of Object.entries(bundle)) {
-        if (chunk.type !== "chunk") continue;
-        const chunkName = chunkIdToName(fileName.replace(/\.js$/, ""));
-        if (!chunksWithI18n.has(chunkName)) continue;
-        const loaderCode = `if(typeof window!=='undefined'&&window.__i18n__){const _=window.__i18n__,h=_.hashes[${JSON.stringify(chunkName)}];if(h)await import(\`/_i18n/\${_.locale}/${chunkName}.\${h}.js\`);}`;
-        const s = new MagicString(chunk.code);
-        s.prepend(loaderCode);
-        chunk.code = s.toString();
-        if (chunk.map) {
-          chunk.map = s.generateMap({ hires: true });
-        }
-      }
-      logger.info(`manifest: ${Object.keys(state.chunkManifest).length} chunks, ${store.uniqueKeyCount} keys`);
-      if (consistency === "error" && store.hasErrors) {
-        throw new Error("i18n: build failed due to translation key inconsistencies");
-      }
-    },
-    writeBundle(outputOptions) {
-      if (this.environment.name === "client" && outputOptions.dir) {
-        const chunksDir = path2.resolve(outputOptions.dir, "..", "server", "chunks");
-        const manifestPath = path2.join(chunksDir, MANIFEST_FILE_NAME);
-        if (fs2.existsSync(chunksDir)) {
-          fs2.writeFileSync(manifestPath, JSON.stringify(getManifest()));
-        } else {
-          logger.error(`server chunks directory not found, cannot write manifest to ${manifestPath}`);
-        }
-      }
-    }
-  };
-}
-
-export {
-  i18nVitePlugin
-};

package/dist/chunk-VGPVG5JP.js

@@ -1,73 +0,0 @@
-// src/shared/meta.ts
-function normalizeMeta(meta) {
-  return typeof meta === "string" ? { fallback: meta } : meta;
-}
-
-// src/shared/rich.ts
-var REACT_ELEMENT_TYPE = /* @__PURE__ */ Symbol.for("react.element");
-var REACT_TRANSITIONAL_ELEMENT_TYPE = /* @__PURE__ */ Symbol.for("react.transitional.element");
-function isReactElement(value) {
-  if (typeof value !== "object" || value === null || !("$$typeof" in value)) {
-    return false;
-  }
-  const type = value.$$typeof;
-  return type === REACT_ELEMENT_TYPE || type === REACT_TRANSITIONAL_ELEMENT_TYPE;
-}
-function addKeyIfNeeded(element, key) {
-  if (isReactElement(element) && element.key === null) {
-    return { ...element, key };
-  }
-  return element;
-}
-function isMarkupPart(part) {
-  return part.type === "markup";
-}
-function partsToNodes(parts, components) {
-  const result = [];
-  const stack = [];
-  let keyIndex = 0;
-  for (const part of parts) {
-    const target = stack.length > 0 ? stack[stack.length - 1].children : result;
-    if (isMarkupPart(part)) {
-      if (part.kind === "open") {
-        stack.push({ name: part.name, children: [] });
-      } else if (part.kind === "close") {
-        const frame = stack.pop();
-        if (!frame) {
-          continue;
-        }
-        const component = components[frame.name];
-        const parent = stack.length > 0 ? stack[stack.length - 1].children : result;
-        if (component) {
-          parent.push(addKeyIfNeeded(component(frame.children), `rich-${keyIndex++}`));
-        } else {
-          parent.push(...frame.children);
-        }
-      } else if (part.kind === "standalone") {
-        const component = components[part.name];
-        if (component) {
-          target.push(addKeyIfNeeded(component([]), `rich-${keyIndex++}`));
-        }
-      }
-    } else if (part.type === "text") {
-      target.push(part.value);
-    } else if (part.type === "bidiIsolation") {
-    } else {
-      if ("value" in part && part.value !== void 0 && part.value !== null) {
-        const stringValue = String(part.value);
-        target.push(stringValue);
-      }
-    }
-  }
-  while (stack.length > 0) {
-    const frame = stack.pop();
-    const parent = stack.length > 0 ? stack[stack.length - 1].children : result;
-    parent.push(...frame.children);
-  }
-  return result;
-}
-
-export {
-  normalizeMeta,
-  partsToNodes
-};

package/dist/i18n-B--L7OQk.d.ts

@@ -1,76 +0,0 @@
-import { E as ExtractionManifest } from './types-ChMT6Vbd.js';
-import { T as TranslationMeta, C as CompiledTranslations, R as RawTranslations } from './types-DNRFj1XA.js';
-
-/**
- * Fallback behavior when translation is missing
- */
-type FallbackBehavior = 'key' | 'fallback' | 'throw' | ((key: string, meta?: TranslationMeta | undefined) => string);
-/**
- * Request-scoped i18n context
- */
-type I18nContext = {
-    locale: string;
-    translations: CompiledTranslations;
-    rawTranslations: RawTranslations;
-    fallback: FallbackBehavior;
-};
-
-type I18nConfig = {
-    locales: string[];
-    defaultLocale?: string | undefined;
-    fallback?: FallbackBehavior | undefined;
-};
-type NormalizedConfig = {
-    locales: string[];
-    defaultLocale: string;
-    fallback: FallbackBehavior;
-};
-declare class I18nSingleton {
-    private config;
-    private rawCache;
-    private mergedCache;
-    private compiledCache;
-    private hashCache;
-    private scriptCache;
-    private chunkCache;
-    private manifestGetter;
-    private manifestVersion;
-    configure(config: I18nConfig): Promise<void>;
-    isConfigured(): boolean;
-    getConfig(): NormalizedConfig;
-    setTranslations(locale: string, raw: RawTranslations): void;
-    getTranslations(locale: string): RawTranslations;
-    getCompiledTranslations(locale: string): CompiledTranslations;
-    /**
-     * Get the extraction manifest (keys + chunks).
-     * - keys: translation keys extracted from codebase with metadata
-     * - chunks: mapping of chunk names to their translation keys
-     */
-    getManifest(): ExtractionManifest;
-    getHashes(locale: string): Record<string, string>;
-    /**
-     * Get the encoded chunk response body for a locale/chunk combination.
-     * Cached to avoid repeated JSON.stringify and encoding on each request.
-     * Returns undefined if chunk not found in manifest.
-     */
-    getChunkBody(locale: string, chunkName: string): Uint8Array | undefined;
-    /**
-     * Get the inline script for I18nScript component.
-     * Cached per locale, invalidated when translations change.
-     */
-    getClientScript(locale: string): string;
-    private createClientScript;
-    /**
-     * Clear translations for specified locale(s).
-     * @param locales - Locale(s) to clear, or all if not specified
-     */
-    clear(locales?: string | string[] | undefined): void;
-    /**
-     * invalidate derived caches when the extraction manifest has changed (dev mode HMR)
-     */
-    private invalidateIfManifestChanged;
-    private resolveLocales;
-}
-declare const i18n: I18nSingleton;
-
-export { type FallbackBehavior as F, type I18nConfig as I, type I18nContext as a, i18n as i };

package/dist/types-B_8vAmvv.d.ts

@@ -1,18 +0,0 @@
-/**
- * Consistency check level for translation keys.
- * Controls behavior when the same key has different fallbacks/variables across files.
- *
- * - 'warn' (default): Log a warning but continue
- * - 'error': Fail the build
- * - 'off': Disable consistency checking
- */
-type ConsistencyCheckLevel = 'off' | 'warn' | 'error';
-interface I18nOptions {
-    /**
-     * How to handle inconsistent translation keys (same key with different fallbacks/variables).
-     * @default 'warn'
-     */
-    consistency?: ConsistencyCheckLevel | undefined;
-}
-
-export type { ConsistencyCheckLevel as C, I18nOptions as I };

package/dist/types-BeDFfFIL.d.ts

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