@defensestation/yjs-local-translator 0.3.0-dev.2.d2befbc

package/dist/metadata.js

@@ -0,0 +1,41 @@
+const FNV_OFFSET_BASIS = 0xcbf29ce484222325n;
+const FNV_PRIME = 0x100000001b3n;
+const FNV_MASK = 0xffffffffffffffffn;
+/**
+ * FNV-1a 64-bit hash of a string, returned as a fixed-width hex string.
+ * Used to compare a stored source snapshot against the current source
+ * without storing the full text.
+ */
+export function hashText(text) {
+    let hash = FNV_OFFSET_BASIS;
+    for (let index = 0; index < text.length; index += 1) {
+        hash ^= BigInt(text.charCodeAt(index));
+        hash = (hash * FNV_PRIME) & FNV_MASK;
+    }
+    return hash.toString(16).padStart(16, "0");
+}
+export function createTranslationMetadata(sourceText, result) {
+    return {
+        sourceHash: hashText(sourceText),
+        sourceLanguage: result.sourceLanguage,
+        targetLanguage: result.targetLanguage,
+        models: [...result.models],
+        engine: result.engine,
+        translatedAt: Date.now()
+    };
+}
+/**
+ * Returns true when the metadata is missing, malformed, or was created from
+ * a different source text than the one passed in.
+ */
+export function isTranslationStale(sourceText, metadata) {
+    if (!metadata || typeof metadata !== "object") {
+        return true;
+    }
+    const sourceHash = metadata.sourceHash;
+    if (typeof sourceHash !== "string") {
+        return true;
+    }
+    return hashText(sourceText) !== sourceHash;
+}
+//# sourceMappingURL=metadata.js.map

package/dist/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAeA,MAAM,gBAAgB,GAAG,mBAAmB,CAAC;AAC7C,MAAM,SAAS,GAAG,cAAc,CAAC;AACjC,MAAM,QAAQ,GAAG,mBAAmB,CAAC;AAErC;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,IAAI,IAAI,GAAG,gBAAgB,CAAC;IAE5B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;QACvC,IAAI,GAAG,CAAC,IAAI,GAAG,SAAS,CAAC,GAAG,QAAQ,CAAC;IACvC,CAAC;IAED,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,UAAkB,EAClB,MAAyB;IAEzB,OAAO;QACL,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC;QAChC,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;QAC1B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE;KACzB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,UAAkB,EAClB,QAAiB;IAEjB,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC9C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,UAAU,GAAI,QAAqC,CAAC,UAAU,CAAC;IAErE,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,QAAQ,CAAC,UAAU,CAAC,KAAK,UAAU,CAAC;AAC7C,CAAC"}

package/dist/model-catalog.d.ts

@@ -0,0 +1,14 @@
+export type LanguageCode = "en" | "fr" | "es" | "de" | "zh" | "ja" | "ar";
+export interface TranslationModel {
+    id: string;
+    label: string;
+}
+export type ModelCatalog = Record<string, TranslationModel>;
+export declare const DEFAULT_MODEL_CATALOG: ModelCatalog;
+/**
+ * Normalizes a language tag to its lowercase primary subtag, so "EN",
+ * "en-US", and "en_GB" all resolve to "en".
+ */
+export declare function normalizeLanguageCode(code: string): string;
+export declare function getTranslationRoute(sourceLanguage: string, targetLanguage: string, catalog?: ModelCatalog): TranslationModel[];
+//# sourceMappingURL=model-catalog.d.ts.map

package/dist/model-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-catalog.d.ts","sourceRoot":"","sources":["../src/model-catalog.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE1E,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAE5D,eAAO,MAAM,qBAAqB,EAAE,YAanC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,mBAAmB,CACjC,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE,YAAoC,GAC5C,gBAAgB,EAAE,CAyBpB"}

package/dist/model-catalog.js

@@ -0,0 +1,41 @@
+export const DEFAULT_MODEL_CATALOG = {
+    "en>fr": { id: "Xenova/opus-mt-en-fr", label: "English → French" },
+    "fr>en": { id: "Xenova/opus-mt-fr-en", label: "French → English" },
+    "en>es": { id: "Xenova/opus-mt-en-es", label: "English → Spanish" },
+    "es>en": { id: "Xenova/opus-mt-es-en", label: "Spanish → English" },
+    "en>de": { id: "Xenova/opus-mt-en-de", label: "English → German" },
+    "de>en": { id: "Xenova/opus-mt-de-en", label: "German → English" },
+    "en>zh": { id: "Xenova/opus-mt-en-zh", label: "English → Chinese" },
+    "zh>en": { id: "Xenova/opus-mt-zh-en", label: "Chinese → English" },
+    "en>ja": { id: "Xenova/opus-mt-en-jap", label: "English → Japanese" },
+    "ja>en": { id: "Xenova/opus-mt-ja-en", label: "Japanese → English" },
+    "en>ar": { id: "Xenova/opus-mt-en-ar", label: "English → Arabic" },
+    "ar>en": { id: "Xenova/opus-mt-ar-en", label: "Arabic → English" }
+};
+/**
+ * Normalizes a language tag to its lowercase primary subtag, so "EN",
+ * "en-US", and "en_GB" all resolve to "en".
+ */
+export function normalizeLanguageCode(code) {
+    return code.trim().toLowerCase().split(/[-_]/, 1)[0] ?? "";
+}
+export function getTranslationRoute(sourceLanguage, targetLanguage, catalog = DEFAULT_MODEL_CATALOG) {
+    const source = normalizeLanguageCode(sourceLanguage);
+    const target = normalizeLanguageCode(targetLanguage);
+    if (source === target) {
+        return [];
+    }
+    const direct = catalog[`${source}>${target}`];
+    if (direct) {
+        return [direct];
+    }
+    if (source !== "en" && target !== "en") {
+        const toEnglish = catalog[`${source}>en`];
+        const fromEnglish = catalog[`en>${target}`];
+        if (toEnglish && fromEnglish) {
+            return [toEnglish, fromEnglish];
+        }
+    }
+    throw new Error(`The language pair "${sourceLanguage}" → "${targetLanguage}" is not configured.`);
+}
+//# sourceMappingURL=model-catalog.js.map

package/dist/model-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-catalog.js","sourceRoot":"","sources":["../src/model-catalog.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,qBAAqB,GAAiB;IACjD,OAAO,EAAE,EAAE,EAAE,EAAE,sBAAsB,EAAE,KAAK,EAAE,kBAAkB,EAAE;IAClE,OAAO,EAAE,EAAE,EAAE,EAAE,sBAAsB,EAAE,KAAK,EAAE,kBAAkB,EAAE;IAClE,OAAO,EAAE,EAAE,EAAE,EAAE,sBAAsB,EAAE,KAAK,EAAE,mBAAmB,EAAE;IACnE,OAAO,EAAE,EAAE,EAAE,EAAE,sBAAsB,EAAE,KAAK,EAAE,mBAAmB,EAAE;IACnE,OAAO,EAAE,EAAE,EAAE,EAAE,sBAAsB,EAAE,KAAK,EAAE,kBAAkB,EAAE;IAClE,OAAO,EAAE,EAAE,EAAE,EAAE,sBAAsB,EAAE,KAAK,EAAE,kBAAkB,EAAE;IAClE,OAAO,EAAE,EAAE,EAAE,EAAE,sBAAsB,EAAE,KAAK,EAAE,mBAAmB,EAAE;IACnE,OAAO,EAAE,EAAE,EAAE,EAAE,sBAAsB,EAAE,KAAK,EAAE,mBAAmB,EAAE;IACnE,OAAO,EAAE,EAAE,EAAE,EAAE,uBAAuB,EAAE,KAAK,EAAE,oBAAoB,EAAE;IACrE,OAAO,EAAE,EAAE,EAAE,EAAE,sBAAsB,EAAE,KAAK,EAAE,oBAAoB,EAAE;IACpE,OAAO,EAAE,EAAE,EAAE,EAAE,sBAAsB,EAAE,KAAK,EAAE,kBAAkB,EAAE;IAClE,OAAO,EAAE,EAAE,EAAE,EAAE,sBAAsB,EAAE,KAAK,EAAE,kBAAkB,EAAE;CACnE,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,cAAsB,EACtB,cAAsB,EACtB,UAAwB,qBAAqB;IAE7C,MAAM,MAAM,GAAG,qBAAqB,CAAC,cAAc,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,qBAAqB,CAAC,cAAc,CAAC,CAAC;IAErD,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC,CAAC;IAC9C,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,CAAC,MAAM,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACvC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,MAAM,KAAK,CAAC,CAAC;QAC1C,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,MAAM,EAAE,CAAC,CAAC;QAE5C,IAAI,SAAS,IAAI,WAAW,EAAE,CAAC;YAC7B,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CACb,sBAAsB,cAAc,QAAQ,cAAc,sBAAsB,CACjF,CAAC;AACJ,CAAC"}

package/dist/native-translation.d.ts

@@ -0,0 +1,37 @@
+export type NativeTranslationAvailability = "unavailable" | "downloadable" | "downloading" | "available";
+export interface NativeTranslatorInstance {
+    translate(text: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<string>;
+    translateStreaming?(text: string, options?: {
+        signal?: AbortSignal;
+    }): ReadableStream<string>;
+    destroy?(): void;
+}
+export interface NativeTranslatorApi {
+    availability(options: {
+        sourceLanguage: string;
+        targetLanguage: string;
+    }): Promise<NativeTranslationAvailability>;
+    create(options: {
+        sourceLanguage: string;
+        targetLanguage: string;
+        monitor?: (monitor: EventTarget) => void;
+    }): Promise<NativeTranslatorInstance>;
+}
+/**
+ * Returns the browser's built-in Translator API (Chrome 138+, Edge) when it
+ * is exposed on globalThis, or undefined everywhere else.
+ */
+export declare function getNativeTranslatorApi(): NativeTranslatorApi | undefined;
+/**
+ * Caches one native translator instance per language pair. Creation failures
+ * and unavailable pairs resolve to undefined so the caller can fall back to
+ * the worker engine.
+ */
+export declare class NativeTranslatorPool {
+    private readonly instances;
+    acquire(sourceLanguage: string, targetLanguage: string, onDownloadProgress?: (progress: number) => void): Promise<NativeTranslatorInstance | undefined>;
+    destroyAll(): void;
+}
+//# sourceMappingURL=native-translation.d.ts.map

package/dist/native-translation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-translation.d.ts","sourceRoot":"","sources":["../src/native-translation.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,6BAA6B,GACrC,aAAa,GACb,cAAc,GACd,aAAa,GACb,WAAW,CAAC;AAEhB,MAAM,WAAW,wBAAwB;IACvC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7E,kBAAkB,CAAC,CACjB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACjC,cAAc,CAAC,MAAM,CAAC,CAAC;IAC1B,OAAO,CAAC,IAAI,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,OAAO,EAAE;QACpB,cAAc,EAAE,MAAM,CAAC;QACvB,cAAc,EAAE,MAAM,CAAC;KACxB,GAAG,OAAO,CAAC,6BAA6B,CAAC,CAAC;IAC3C,MAAM,CAAC,OAAO,EAAE;QACd,cAAc,EAAE,MAAM,CAAC;QACvB,cAAc,EAAE,MAAM,CAAC;QACvB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;KAC1C,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;CACvC;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,mBAAmB,GAAG,SAAS,CAaxE;AAED;;;;GAIG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAGtB;IAEE,OAAO,CACX,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,EACtB,kBAAkB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GAC9C,OAAO,CAAC,wBAAwB,GAAG,SAAS,CAAC;IAuDhD,UAAU,IAAI,IAAI;CASnB"}

package/dist/native-translation.js

@@ -0,0 +1,80 @@
+/**
+ * Returns the browser's built-in Translator API (Chrome 138+, Edge) when it
+ * is exposed on globalThis, or undefined everywhere else.
+ */
+export function getNativeTranslatorApi() {
+    const candidate = globalThis.Translator;
+    if ((typeof candidate === "object" || typeof candidate === "function") &&
+        candidate !== null &&
+        typeof candidate.availability === "function" &&
+        typeof candidate.create === "function") {
+        return candidate;
+    }
+    return undefined;
+}
+/**
+ * Caches one native translator instance per language pair. Creation failures
+ * and unavailable pairs resolve to undefined so the caller can fall back to
+ * the worker engine.
+ */
+export class NativeTranslatorPool {
+    instances = new Map();
+    async acquire(sourceLanguage, targetLanguage, onDownloadProgress) {
+        const api = getNativeTranslatorApi();
+        if (!api) {
+            return undefined;
+        }
+        const key = `${sourceLanguage}>${targetLanguage}`;
+        const existing = this.instances.get(key);
+        if (existing) {
+            try {
+                return await existing;
+            }
+            catch {
+                this.instances.delete(key);
+                return undefined;
+            }
+        }
+        try {
+            const availability = await api.availability({
+                sourceLanguage,
+                targetLanguage
+            });
+            if (availability === "unavailable") {
+                return undefined;
+            }
+        }
+        catch {
+            return undefined;
+        }
+        const created = api.create({
+            sourceLanguage,
+            targetLanguage,
+            monitor(monitor) {
+                monitor.addEventListener("downloadprogress", (event) => {
+                    const loaded = event.loaded;
+                    if (typeof loaded === "number" && Number.isFinite(loaded)) {
+                        onDownloadProgress?.(Math.min(Math.max(loaded, 0), 1) * 100);
+                    }
+                });
+            }
+        });
+        this.instances.set(key, created);
+        try {
+            return await created;
+        }
+        catch {
+            this.instances.delete(key);
+            return undefined;
+        }
+    }
+    destroyAll() {
+        for (const instance of this.instances.values()) {
+            void instance
+                .then((translator) => translator.destroy?.())
+                .catch(() => undefined);
+        }
+        this.instances.clear();
+    }
+}
+//# sourceMappingURL=native-translation.js.map

package/dist/native-translation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-translation.js","sourceRoot":"","sources":["../src/native-translation.ts"],"names":[],"mappings":"AA2BA;;;GAGG;AACH,MAAM,UAAU,sBAAsB;IACpC,MAAM,SAAS,GAAI,UAAuC,CAAC,UAAU,CAAC;IAEtE,IACE,CAAC,OAAO,SAAS,KAAK,QAAQ,IAAI,OAAO,SAAS,KAAK,UAAU,CAAC;QAClE,SAAS,KAAK,IAAI;QAClB,OAAQ,SAAiC,CAAC,YAAY,KAAK,UAAU;QACrE,OAAQ,SAAiC,CAAC,MAAM,KAAK,UAAU,EAC/D,CAAC;QACD,OAAO,SAAgC,CAAC;IAC1C,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,OAAO,oBAAoB;IACd,SAAS,GAAG,IAAI,GAAG,EAGjC,CAAC;IAEJ,KAAK,CAAC,OAAO,CACX,cAAsB,EACtB,cAAsB,EACtB,kBAA+C;QAE/C,MAAM,GAAG,GAAG,sBAAsB,EAAE,CAAC;QACrC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,GAAG,GAAG,GAAG,cAAc,IAAI,cAAc,EAAE,CAAC;QAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEzC,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC;gBACH,OAAO,MAAM,QAAQ,CAAC;YACxB,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC3B,OAAO,SAAS,CAAC;YACnB,CAAC;QACH,CAAC;QAED,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC;gBAC1C,cAAc;gBACd,cAAc;aACf,CAAC,CAAC;YAEH,IAAI,YAAY,KAAK,aAAa,EAAE,CAAC;gBACnC,OAAO,SAAS,CAAC;YACnB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC;YACzB,cAAc;YACd,cAAc;YACd,OAAO,CAAC,OAAO;gBACb,OAAO,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,CAAC,KAAK,EAAE,EAAE;oBACrD,MAAM,MAAM,GAAI,KAA8B,CAAC,MAAM,CAAC;oBAEtD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;wBAC1D,kBAAkB,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;oBAC/D,CAAC;gBACH,CAAC,CAAC,CAAC;YACL,CAAC;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAEjC,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC3B,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,UAAU;QACR,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;YAC/C,KAAK,QAAQ;iBACV,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC;iBAC5C,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC5B,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;CACF"}

package/dist/protocol.d.ts

@@ -0,0 +1,59 @@
+import type { ModelCatalog } from "./model-catalog.js";
+export interface WorkerConfiguration {
+    transformersUrl: string;
+    dtype: string;
+    device: string;
+    graphOptimizationLevel: "disabled" | "basic" | "extended" | "all";
+    modelCatalog: ModelCatalog;
+    maxNewTokens?: number;
+    maxChunkLength?: number;
+}
+export type MainToWorkerMessage = {
+    type: "configure";
+    configuration: WorkerConfiguration;
+} | {
+    type: "translate";
+    requestId: string;
+    text: string;
+    sourceLanguage: string;
+    targetLanguage: string;
+} | {
+    type: "cancel";
+    requestId: string;
+} | {
+    type: "unload-models";
+};
+export type WorkerToMainMessage = {
+    status: "route";
+    requestId: string;
+    models: string[];
+    message: string;
+} | {
+    status: "loading" | "model-ready" | "processing";
+    requestId: string;
+    modelId?: string;
+    message: string;
+} | {
+    status: "progress";
+    requestId: string;
+    modelId: string;
+    file?: string;
+    progress?: number;
+    loaded?: number;
+    total?: number;
+    message: string;
+} | {
+    status: "partial";
+    requestId: string;
+    delta: string;
+} | {
+    status: "success";
+    requestId: string;
+    translation: string;
+    models: string[];
+} | {
+    status: "error";
+    requestId: string;
+    error: string;
+};
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,WAAW,mBAAmB;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB,EAAE,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,KAAK,CAAC;IAClE,YAAY,EAAE,YAAY,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,mBAAmB,GAC3B;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,aAAa,EAAE,mBAAmB,CAAC;CACpC,GACD;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB,GACD;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB,GACD;IACE,IAAI,EAAE,eAAe,CAAC;CACvB,CAAC;AAEN,MAAM,MAAM,mBAAmB,GAC3B;IACE,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB,GACD;IACE,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,YAAY,CAAC;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB,GACD;IACE,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB,GACD;IACE,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf,GACD;IACE,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,GACD;IACE,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC"}

package/dist/protocol.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":""}

package/dist/translation-memory.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Chunk-level cache of finished translations. When a memory is passed to
+ * BrowserTranslator, input is split into sentence chunks and only chunks
+ * missing from the memory are sent to a model, so editing one sentence in a
+ * long document costs one model call instead of a full retranslation.
+ */
+export interface TranslationMemory {
+    get(key: string): string | undefined | Promise<string | undefined>;
+    set(key: string, value: string): void | Promise<void>;
+    clear?(): void | Promise<void>;
+}
+/**
+ * Builds the cache key for one source chunk. The key contains the engine
+ * identity (native pair or model route), the language pair, and the full
+ * chunk text, so a hit can never return a translation produced by different
+ * models or for different text.
+ */
+export declare function createTranslationMemoryKey(engineId: string, sourceLanguage: string, targetLanguage: string, chunkText: string): string;
+/**
+ * Map-backed memory with least-recently-used eviction. Suitable for a single
+ * session; pair it with IndexedDBTranslationMemory to persist across reloads.
+ */
+export declare class InMemoryTranslationMemory implements TranslationMemory {
+    private readonly entries;
+    private readonly maxEntries;
+    constructor(maxEntries?: number);
+    get size(): number;
+    get(key: string): string | undefined;
+    set(key: string, value: string): void;
+    clear(): void;
+}
+/**
+ * IndexedDB-backed memory that persists translations across page loads. In
+ * environments without IndexedDB (server-side rendering, some tests) it
+ * degrades to a no-op: get resolves to undefined and set does nothing.
+ */
+export declare class IndexedDBTranslationMemory implements TranslationMemory {
+    private readonly databaseName;
+    private readonly storeName;
+    private databasePromise;
+    constructor(options?: {
+        databaseName?: string;
+        storeName?: string;
+    });
+    private open;
+    get(key: string): Promise<string | undefined>;
+    set(key: string, value: string): Promise<void>;
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=translation-memory.d.ts.map

package/dist/translation-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translation-memory.d.ts","sourceRoot":"","sources":["../src/translation-memory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACnE,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,KAAK,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChC;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,GAChB,MAAM,CAER;AAED;;;GAGG;AACH,qBAAa,yBAA0B,YAAW,iBAAiB;IACjE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,UAAU,SAAO;IAI7B,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAWpC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAerC,KAAK,IAAI,IAAI;CAGd;AAED;;;;GAIG;AACH,qBAAa,0BAA2B,YAAW,iBAAiB;IAClE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,eAAe,CAA+C;gBAE1D,OAAO,GAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO;IAKvE,OAAO,CAAC,IAAI;IAuBN,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAoB7C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB9C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAgB7B"}

package/dist/translation-memory.js

@@ -0,0 +1,117 @@
+/**
+ * Builds the cache key for one source chunk. The key contains the engine
+ * identity (native pair or model route), the language pair, and the full
+ * chunk text, so a hit can never return a translation produced by different
+ * models or for different text.
+ */
+export function createTranslationMemoryKey(engineId, sourceLanguage, targetLanguage, chunkText) {
+    return `v1|${engineId}|${sourceLanguage}>${targetLanguage}|${chunkText}`;
+}
+/**
+ * Map-backed memory with least-recently-used eviction. Suitable for a single
+ * session; pair it with IndexedDBTranslationMemory to persist across reloads.
+ */
+export class InMemoryTranslationMemory {
+    entries = new Map();
+    maxEntries;
+    constructor(maxEntries = 5000) {
+        this.maxEntries = Math.max(1, maxEntries);
+    }
+    get size() {
+        return this.entries.size;
+    }
+    get(key) {
+        const value = this.entries.get(key);
+        if (value !== undefined) {
+            this.entries.delete(key);
+            this.entries.set(key, value);
+        }
+        return value;
+    }
+    set(key, value) {
+        this.entries.delete(key);
+        this.entries.set(key, value);
+        while (this.entries.size > this.maxEntries) {
+            const oldest = this.entries.keys().next().value;
+            if (oldest === undefined) {
+                break;
+            }
+            this.entries.delete(oldest);
+        }
+    }
+    clear() {
+        this.entries.clear();
+    }
+}
+/**
+ * IndexedDB-backed memory that persists translations across page loads. In
+ * environments without IndexedDB (server-side rendering, some tests) it
+ * degrades to a no-op: get resolves to undefined and set does nothing.
+ */
+export class IndexedDBTranslationMemory {
+    databaseName;
+    storeName;
+    databasePromise;
+    constructor(options = {}) {
+        this.databaseName = options.databaseName ?? "yjs-local-translator";
+        this.storeName = options.storeName ?? "translations";
+    }
+    open() {
+        if (!this.databasePromise) {
+            this.databasePromise = new Promise((resolve) => {
+                if (typeof indexedDB === "undefined") {
+                    resolve(undefined);
+                    return;
+                }
+                const request = indexedDB.open(this.databaseName, 1);
+                request.onupgradeneeded = () => {
+                    if (!request.result.objectStoreNames.contains(this.storeName)) {
+                        request.result.createObjectStore(this.storeName);
+                    }
+                };
+                request.onsuccess = () => resolve(request.result);
+                request.onerror = () => resolve(undefined);
+            });
+        }
+        return this.databasePromise;
+    }
+    async get(key) {
+        const database = await this.open();
+        if (!database) {
+            return undefined;
+        }
+        return new Promise((resolve, reject) => {
+            const request = database
+                .transaction(this.storeName, "readonly")
+                .objectStore(this.storeName)
+                .get(key);
+            request.onsuccess = () => resolve(typeof request.result === "string" ? request.result : undefined);
+            request.onerror = () => reject(request.error ?? new Error("Translation memory read failed."));
+        });
+    }
+    async set(key, value) {
+        const database = await this.open();
+        if (!database) {
+            return;
+        }
+        return new Promise((resolve, reject) => {
+            const transaction = database.transaction(this.storeName, "readwrite");
+            transaction.objectStore(this.storeName).put(value, key);
+            transaction.oncomplete = () => resolve();
+            transaction.onerror = () => reject(transaction.error ?? new Error("Translation memory write failed."));
+        });
+    }
+    async clear() {
+        const database = await this.open();
+        if (!database) {
+            return;
+        }
+        return new Promise((resolve, reject) => {
+            const transaction = database.transaction(this.storeName, "readwrite");
+            transaction.objectStore(this.storeName).clear();
+            transaction.oncomplete = () => resolve();
+            transaction.onerror = () => reject(transaction.error ?? new Error("Translation memory clear failed."));
+        });
+    }
+}
+//# sourceMappingURL=translation-memory.js.map

package/dist/translation-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"translation-memory.js","sourceRoot":"","sources":["../src/translation-memory.ts"],"names":[],"mappings":"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"}

package/dist/translator.worker.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=translator.worker.d.ts.map

package/dist/translator.worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translator.worker.d.ts","sourceRoot":"","sources":["../src/translator.worker.ts"],"names":[],"mappings":""}