vite-plugin-ai-auto-i18n 0.2.0 → 0.2.1

package/dist/cli/prune.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/index.d.ts

@@ -0,0 +1,123 @@
+import { Plugin } from 'vite';
+
+type MessageKind = "text" | "attribute" | "mixed";
+interface ExtractedMessage {
+    source: string;
+    prefix?: string;
+    suffix?: string;
+    kind: MessageKind;
+    /** For "mixed" messages: placeholder names in the order of the element's expression children. */
+    placeholders?: string[];
+    file: string;
+    start: number;
+    end: number;
+    tag: string;
+    component: string;
+    attribute?: string;
+    context: string;
+    fingerprint: string;
+}
+/** A message with the stable ID that the registry assigned to it. */
+type ResolvedMessage = ExtractedMessage & {
+    id: string;
+};
+type RegistryEntry = Pick<ExtractedMessage, "source" | "kind" | "tag" | "component" | "attribute" | "context" | "fingerprint"> & {
+    id: string;
+    location: string;
+    status: "active" | "orphaned";
+    firstSeen: string;
+    lastSeen: string;
+};
+interface Registry {
+    version: 1;
+    entries: Record<string, RegistryEntry>;
+}
+type Catalog = Record<string, string>;
+interface TranslationRequest {
+    id: string;
+    source: string;
+    context: string;
+    kind: MessageKind;
+    placeholders?: string[];
+}
+interface TranslationProvider {
+    translate(input: {
+        sourceLocale: string;
+        targetLocale: string;
+        messages: TranslationRequest[];
+    }): Promise<Catalog>;
+}
+
+/**
+ * Some batches of a translation request failed while others succeeded. `partial` holds the translations
+ * that did come back, so the caller can keep them and report the rest.
+ */
+declare class PartialTranslationError extends Error {
+    readonly partial: Catalog;
+    readonly failed: number;
+    constructor(message: string, partial: Catalog, failed: number);
+}
+
+interface OpenAICompatibleOptions {
+    apiKey: string;
+    model: string;
+    baseURL?: string;
+    /** Messages sent per request. Smaller batches keep responses within output limits. Default 40. */
+    batchSize?: number;
+    /** Abort a single request after this many milliseconds. Default 60000. */
+    timeoutMs?: number;
+    /** Extra attempts for network errors, timeouts, 408/409/429/5xx and malformed responses. Default 2. */
+    maxRetries?: number;
+    /** Base delay before a retry; doubles on each attempt. Default 500. */
+    retryDelayMs?: number;
+    /** Batches sent in parallel. Default 4. */
+    concurrency?: number;
+}
+declare class OpenAICompatibleProvider implements TranslationProvider {
+    private options;
+    constructor(options: OpenAICompatibleOptions);
+    /**
+     * Translates in parallel batches. If every batch fails, the first error is thrown. If only some fail,
+     * a PartialTranslationError carries the translations that succeeded.
+     */
+    translate(input: {
+        sourceLocale: string;
+        targetLocale: string;
+        messages: TranslationRequest[];
+    }): Promise<Catalog>;
+    private translateBatch;
+    private request;
+}
+
+interface AutoI18nOptions {
+    locales: string[];
+    sourceLocale?: string;
+    /**
+     * "build" (default) compiles one locale per build. "runtime" ships every catalogue and
+     * switches locale in the browser via `setLocale()` from the `virtual:autoi18n` module.
+     */
+    delivery?: "build" | "runtime";
+    /** Compile this build for one locale. Defaults to sourceLocale; set AUTOI18N_LOCALE for CI matrix builds. */
+    locale?: string;
+    include?: string[];
+    exclude?: string[];
+    directory?: string;
+    provider?: TranslationProvider;
+    failOnMissingProvider?: boolean;
+    onAmbiguous?: "warn" | "error";
+    /**
+     * Minutes an orphaned message (one no longer in the source) is kept in the registry before it is deleted.
+     * Default 43200 (30 days). `0` deletes orphans on the next build; `Infinity` keeps them forever.
+     */
+    orphanRetentionMinutes?: number;
+    /**
+     * Locales translated at the same time. Default 2. Batches within a locale are limited separately by
+     * `OpenAICompatibleOptions.concurrency`. Lower this if your provider rate-limits per account.
+     */
+    localeConcurrency?: number;
+    /** Log each message sent to the translation provider and each translation received, with timestamps. Default false. */
+    debug?: boolean;
+}
+declare function autoI18n(options: AutoI18nOptions): Plugin;
+
+export { type AutoI18nOptions, type Catalog, type ExtractedMessage, type MessageKind, type OpenAICompatibleOptions, OpenAICompatibleProvider, PartialTranslationError, type Registry, type RegistryEntry, type ResolvedMessage, type TranslationProvider, type TranslationRequest, autoI18n as default };

package/dist/runtime/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Picks the best supported locale for a list of preferred locales (for example `navigator.languages`).
+ * This function is also embedded into the generated `virtual:autoi18n` module via `toString()`,
+ * so it must stay self-contained and must not reference anything outside its body.
+ */
+declare function resolveLocale(preferred: string[], supported: string[], fallback?: string): string;
+
+type LocaleLoader = () => Promise<{
+    default: Record<string, string>;
+} | Record<string, string>>;
+/**
+ * Returns a cached catalogue loader. Unknown locales load the fallback, and a failed load is not cached.
+ * `prime` stores a catalogue that was already fetched, such as one pushed by the dev server.
+ * Serialised into the runtime module via toString(), so it must not reference anything outside its body.
+ */
+declare function createLocaleLoader(loaders: Record<string, LocaleLoader>, fallback?: string): {
+    (locale: string): Promise<Record<string, string>>;
+    prime(locale: string, catalog: Record<string, string>): void;
+};
+
+export { type LocaleLoader, createLocaleLoader, resolveLocale };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "vite-plugin-ai-auto-i18n",
-    "version": "0.2.0",
+    "version": "0.2.1",
     "type": "module",
     "description": "Implicit, build-time AI localization for JSX applications",
     "engines": {