@mulmoclaude/core 0.2.14 → 0.2.15

package/dist/translation/client.cjs

@@ -0,0 +1,45 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/translation/client.ts
+function cacheKey(req) {
+	return [
+		req.namespace,
+		req.targetLanguage,
+		...req.sentences
+	].join("\0");
+}
+function createTranslationCache(transport) {
+	const memo = /* @__PURE__ */ new Map();
+	const inflight = /* @__PURE__ */ new Map();
+	async function run(key, req) {
+		const translations = (await transport(req))?.translations;
+		if (!Array.isArray(translations) || translations.length !== req.sentences.length) return null;
+		const frozen = Object.freeze([...translations]);
+		memo.set(key, frozen);
+		return frozen;
+	}
+	return {
+		peek(req) {
+			return memo.get(cacheKey(req)) ?? null;
+		},
+		fetch(req) {
+			const key = cacheKey(req);
+			const hit = memo.get(key);
+			if (hit) return Promise.resolve(hit);
+			const pending = inflight.get(key);
+			if (pending) return pending;
+			const started = run(key, req).finally(() => {
+				inflight.delete(key);
+			});
+			inflight.set(key, started);
+			return started;
+		},
+		clear() {
+			memo.clear();
+			inflight.clear();
+		}
+	};
+}
+//#endregion
+exports.createTranslationCache = createTranslationCache;
+
+//# sourceMappingURL=client.cjs.map

package/dist/translation/client.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.cjs","names":[],"sources":["../../src/translation/client.ts"],"sourcesContent":["// @mulmoclaude/core/translation/client — framework-neutral runtime-translation\n// cache. Both hosts (MulmoClaude, MulmoTerminal) translate UI strings (role\n// query chips, collection starters, …) into the user's locale at runtime by\n// POSTing batches to their own `/api/translation` route; the LLM step and the\n// transport/auth differ per host, so BOTH are injected. This module owns only\n// the host-agnostic parts: the request/response contract, in-flight de-dup,\n// length validation, and an in-memory memo keyed by (namespace, locale,\n// sentence-set). No framework dependency — the host wraps this in its own\n// reactivity (Vue refs, …), mirroring `@mulmoclaude/core/whisper/client`.\n//\n// `en` and empty inputs are NOT special-cased here — that's a UI fallback\n// decision the caller makes (it already holds the English source).\n\nexport interface TranslateRequest {\n  /** Cache + server-cache partition, e.g. \"role-queries\", \"collection-starters\". */\n  namespace: string;\n  /** BCP-47 target language, e.g. \"ja\", \"pt-BR\". */\n  targetLanguage: string;\n  /** English source strings to translate, in order. */\n  sentences: readonly string[];\n}\n\nexport interface TranslateResponse {\n  /** Translations in the same order and length as `sentences`. */\n  translations: string[];\n}\n\n/** Host-injected transport. Performs the POST however the host likes (auth,\n *  URL, error shape are the host's concern) and resolves to the response, or\n *  `null` on any network / HTTP failure — the cache treats `null` as a miss and\n *  the caller falls back to the English source. */\nexport type TranslateTransport = (req: TranslateRequest) => Promise<TranslateResponse | null>;\n\nexport interface TranslationCache {\n  /** Memoized translations for this exact request, or `null` if not resolved\n   *  yet (never fetched, in flight, or the last attempt failed). Synchronous —\n   *  a reactive caller reads this after being nudged by `fetch`'s resolution. */\n  peek: (req: TranslateRequest) => readonly string[] | null;\n  /** Ensure a translation is fetched (de-duped across concurrent callers and\n   *  memoized). Resolves to the translations, or `null` on transport failure or\n   *  a length mismatch. Repeat calls with the same key return the memoized\n   *  value without re-hitting the transport. */\n  fetch: (req: TranslateRequest) => Promise<readonly string[] | null>;\n  /** Drop all memoized + in-flight state. Primarily for tests that share a\n   *  worker; production callers never need it. */\n  clear: () => void;\n}\n\nfunction cacheKey(req: TranslateRequest): string {\n  // Join the parts with a NUL separator (written as an escaped NUL so the\n  // SOURCE stays plain text — a raw NUL byte here made Git classify the file as\n  // binary and blocked diff review). NUL can't occur in any part, so two\n  // different (namespace, locale, sentence-set) tuples can never collide. The\n  // sentence set is part of the key (not just namespace+locale) so callers\n  // needn't supply a stable id — identical inputs share a slot, which is correct.\n  return [req.namespace, req.targetLanguage, ...req.sentences].join(\"\\u0000\");\n}\n\nexport function createTranslationCache(transport: TranslateTransport): TranslationCache {\n  const memo = new Map<string, readonly string[]>();\n  const inflight = new Map<string, Promise<readonly string[] | null>>();\n\n  async function run(key: string, req: TranslateRequest): Promise<readonly string[] | null> {\n    const response = await transport(req);\n    const translations = response?.translations;\n    if (!Array.isArray(translations) || translations.length !== req.sentences.length) {\n      return null;\n    }\n    const frozen = Object.freeze([...translations]);\n    memo.set(key, frozen);\n    return frozen;\n  }\n\n  return {\n    peek(req) {\n      return memo.get(cacheKey(req)) ?? null;\n    },\n    fetch(req) {\n      const key = cacheKey(req);\n      const hit = memo.get(key);\n      if (hit) return Promise.resolve(hit);\n      const pending = inflight.get(key);\n      if (pending) return pending;\n      const started = run(key, req).finally(() => {\n        inflight.delete(key);\n      });\n      inflight.set(key, started);\n      return started;\n    },\n    clear() {\n      memo.clear();\n      inflight.clear();\n    },\n  };\n}\n"],"mappings":";;AAgDA,SAAS,SAAS,KAA+B;CAO/C,OAAO;EAAC,IAAI;EAAW,IAAI;EAAgB,GAAG,IAAI;CAAS,CAAC,CAAC,KAAK,IAAQ;AAC5E;AAEA,SAAgB,uBAAuB,WAAiD;CACtF,MAAM,uBAAO,IAAI,IAA+B;CAChD,MAAM,2BAAW,IAAI,IAA+C;CAEpE,eAAe,IAAI,KAAa,KAA0D;EAExF,MAAM,gBAAe,MADE,UAAU,GAAG,EAAA,EACL;EAC/B,IAAI,CAAC,MAAM,QAAQ,YAAY,KAAK,aAAa,WAAW,IAAI,UAAU,QACxE,OAAO;EAET,MAAM,SAAS,OAAO,OAAO,CAAC,GAAG,YAAY,CAAC;EAC9C,KAAK,IAAI,KAAK,MAAM;EACpB,OAAO;CACT;CAEA,OAAO;EACL,KAAK,KAAK;GACR,OAAO,KAAK,IAAI,SAAS,GAAG,CAAC,KAAK;EACpC;EACA,MAAM,KAAK;GACT,MAAM,MAAM,SAAS,GAAG;GACxB,MAAM,MAAM,KAAK,IAAI,GAAG;GACxB,IAAI,KAAK,OAAO,QAAQ,QAAQ,GAAG;GACnC,MAAM,UAAU,SAAS,IAAI,GAAG;GAChC,IAAI,SAAS,OAAO;GACpB,MAAM,UAAU,IAAI,KAAK,GAAG,CAAC,CAAC,cAAc;IAC1C,SAAS,OAAO,GAAG;GACrB,CAAC;GACD,SAAS,IAAI,KAAK,OAAO;GACzB,OAAO;EACT;EACA,QAAQ;GACN,KAAK,MAAM;GACX,SAAS,MAAM;EACjB;CACF;AACF"}

package/dist/translation/client.d.ts

@@ -0,0 +1,32 @@
+export interface TranslateRequest {
+    /** Cache + server-cache partition, e.g. "role-queries", "collection-starters". */
+    namespace: string;
+    /** BCP-47 target language, e.g. "ja", "pt-BR". */
+    targetLanguage: string;
+    /** English source strings to translate, in order. */
+    sentences: readonly string[];
+}
+export interface TranslateResponse {
+    /** Translations in the same order and length as `sentences`. */
+    translations: string[];
+}
+/** Host-injected transport. Performs the POST however the host likes (auth,
+ *  URL, error shape are the host's concern) and resolves to the response, or
+ *  `null` on any network / HTTP failure — the cache treats `null` as a miss and
+ *  the caller falls back to the English source. */
+export type TranslateTransport = (req: TranslateRequest) => Promise<TranslateResponse | null>;
+export interface TranslationCache {
+    /** Memoized translations for this exact request, or `null` if not resolved
+     *  yet (never fetched, in flight, or the last attempt failed). Synchronous —
+     *  a reactive caller reads this after being nudged by `fetch`'s resolution. */
+    peek: (req: TranslateRequest) => readonly string[] | null;
+    /** Ensure a translation is fetched (de-duped across concurrent callers and
+     *  memoized). Resolves to the translations, or `null` on transport failure or
+     *  a length mismatch. Repeat calls with the same key return the memoized
+     *  value without re-hitting the transport. */
+    fetch: (req: TranslateRequest) => Promise<readonly string[] | null>;
+    /** Drop all memoized + in-flight state. Primarily for tests that share a
+     *  worker; production callers never need it. */
+    clear: () => void;
+}
+export declare function createTranslationCache(transport: TranslateTransport): TranslationCache;

package/dist/translation/client.js

@@ -0,0 +1,44 @@
+//#region src/translation/client.ts
+function cacheKey(req) {
+	return [
+		req.namespace,
+		req.targetLanguage,
+		...req.sentences
+	].join("\0");
+}
+function createTranslationCache(transport) {
+	const memo = /* @__PURE__ */ new Map();
+	const inflight = /* @__PURE__ */ new Map();
+	async function run(key, req) {
+		const translations = (await transport(req))?.translations;
+		if (!Array.isArray(translations) || translations.length !== req.sentences.length) return null;
+		const frozen = Object.freeze([...translations]);
+		memo.set(key, frozen);
+		return frozen;
+	}
+	return {
+		peek(req) {
+			return memo.get(cacheKey(req)) ?? null;
+		},
+		fetch(req) {
+			const key = cacheKey(req);
+			const hit = memo.get(key);
+			if (hit) return Promise.resolve(hit);
+			const pending = inflight.get(key);
+			if (pending) return pending;
+			const started = run(key, req).finally(() => {
+				inflight.delete(key);
+			});
+			inflight.set(key, started);
+			return started;
+		},
+		clear() {
+			memo.clear();
+			inflight.clear();
+		}
+	};
+}
+//#endregion
+export { createTranslationCache };
+
+//# sourceMappingURL=client.js.map

package/dist/translation/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","names":[],"sources":["../../src/translation/client.ts"],"sourcesContent":["// @mulmoclaude/core/translation/client — framework-neutral runtime-translation\n// cache. Both hosts (MulmoClaude, MulmoTerminal) translate UI strings (role\n// query chips, collection starters, …) into the user's locale at runtime by\n// POSTing batches to their own `/api/translation` route; the LLM step and the\n// transport/auth differ per host, so BOTH are injected. This module owns only\n// the host-agnostic parts: the request/response contract, in-flight de-dup,\n// length validation, and an in-memory memo keyed by (namespace, locale,\n// sentence-set). No framework dependency — the host wraps this in its own\n// reactivity (Vue refs, …), mirroring `@mulmoclaude/core/whisper/client`.\n//\n// `en` and empty inputs are NOT special-cased here — that's a UI fallback\n// decision the caller makes (it already holds the English source).\n\nexport interface TranslateRequest {\n  /** Cache + server-cache partition, e.g. \"role-queries\", \"collection-starters\". */\n  namespace: string;\n  /** BCP-47 target language, e.g. \"ja\", \"pt-BR\". */\n  targetLanguage: string;\n  /** English source strings to translate, in order. */\n  sentences: readonly string[];\n}\n\nexport interface TranslateResponse {\n  /** Translations in the same order and length as `sentences`. */\n  translations: string[];\n}\n\n/** Host-injected transport. Performs the POST however the host likes (auth,\n *  URL, error shape are the host's concern) and resolves to the response, or\n *  `null` on any network / HTTP failure — the cache treats `null` as a miss and\n *  the caller falls back to the English source. */\nexport type TranslateTransport = (req: TranslateRequest) => Promise<TranslateResponse | null>;\n\nexport interface TranslationCache {\n  /** Memoized translations for this exact request, or `null` if not resolved\n   *  yet (never fetched, in flight, or the last attempt failed). Synchronous —\n   *  a reactive caller reads this after being nudged by `fetch`'s resolution. */\n  peek: (req: TranslateRequest) => readonly string[] | null;\n  /** Ensure a translation is fetched (de-duped across concurrent callers and\n   *  memoized). Resolves to the translations, or `null` on transport failure or\n   *  a length mismatch. Repeat calls with the same key return the memoized\n   *  value without re-hitting the transport. */\n  fetch: (req: TranslateRequest) => Promise<readonly string[] | null>;\n  /** Drop all memoized + in-flight state. Primarily for tests that share a\n   *  worker; production callers never need it. */\n  clear: () => void;\n}\n\nfunction cacheKey(req: TranslateRequest): string {\n  // Join the parts with a NUL separator (written as an escaped NUL so the\n  // SOURCE stays plain text — a raw NUL byte here made Git classify the file as\n  // binary and blocked diff review). NUL can't occur in any part, so two\n  // different (namespace, locale, sentence-set) tuples can never collide. The\n  // sentence set is part of the key (not just namespace+locale) so callers\n  // needn't supply a stable id — identical inputs share a slot, which is correct.\n  return [req.namespace, req.targetLanguage, ...req.sentences].join(\"\\u0000\");\n}\n\nexport function createTranslationCache(transport: TranslateTransport): TranslationCache {\n  const memo = new Map<string, readonly string[]>();\n  const inflight = new Map<string, Promise<readonly string[] | null>>();\n\n  async function run(key: string, req: TranslateRequest): Promise<readonly string[] | null> {\n    const response = await transport(req);\n    const translations = response?.translations;\n    if (!Array.isArray(translations) || translations.length !== req.sentences.length) {\n      return null;\n    }\n    const frozen = Object.freeze([...translations]);\n    memo.set(key, frozen);\n    return frozen;\n  }\n\n  return {\n    peek(req) {\n      return memo.get(cacheKey(req)) ?? null;\n    },\n    fetch(req) {\n      const key = cacheKey(req);\n      const hit = memo.get(key);\n      if (hit) return Promise.resolve(hit);\n      const pending = inflight.get(key);\n      if (pending) return pending;\n      const started = run(key, req).finally(() => {\n        inflight.delete(key);\n      });\n      inflight.set(key, started);\n      return started;\n    },\n    clear() {\n      memo.clear();\n      inflight.clear();\n    },\n  };\n}\n"],"mappings":";AAgDA,SAAS,SAAS,KAA+B;CAO/C,OAAO;EAAC,IAAI;EAAW,IAAI;EAAgB,GAAG,IAAI;CAAS,CAAC,CAAC,KAAK,IAAQ;AAC5E;AAEA,SAAgB,uBAAuB,WAAiD;CACtF,MAAM,uBAAO,IAAI,IAA+B;CAChD,MAAM,2BAAW,IAAI,IAA+C;CAEpE,eAAe,IAAI,KAAa,KAA0D;EAExF,MAAM,gBAAe,MADE,UAAU,GAAG,EAAA,EACL;EAC/B,IAAI,CAAC,MAAM,QAAQ,YAAY,KAAK,aAAa,WAAW,IAAI,UAAU,QACxE,OAAO;EAET,MAAM,SAAS,OAAO,OAAO,CAAC,GAAG,YAAY,CAAC;EAC9C,KAAK,IAAI,KAAK,MAAM;EACpB,OAAO;CACT;CAEA,OAAO;EACL,KAAK,KAAK;GACR,OAAO,KAAK,IAAI,SAAS,GAAG,CAAC,KAAK;EACpC;EACA,MAAM,KAAK;GACT,MAAM,MAAM,SAAS,GAAG;GACxB,MAAM,MAAM,KAAK,IAAI,GAAG;GACxB,IAAI,KAAK,OAAO,QAAQ,QAAQ,GAAG;GACnC,MAAM,UAAU,SAAS,IAAI,GAAG;GAChC,IAAI,SAAS,OAAO;GACpB,MAAM,UAAU,IAAI,KAAK,GAAG,CAAC,CAAC,cAAc;IAC1C,SAAS,OAAO,GAAG;GACrB,CAAC;GACD,SAAS,IAAI,KAAK,OAAO;GACzB,OAAO;EACT;EACA,QAAQ;GACN,KAAK,MAAM;GACX,SAAS,MAAM;EACjB;CACF;AACF"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mulmoclaude/core",
-  "version": "0.2.14",
-  "description": "Shared server-side core for MulmoClaude and MulmoTerminal — the always-shipped-together subsystems consolidated behind subpath exports so the two hosts can't drift. Server-only except the browser-safe ./whisper/client and ./workspace-setup/slug entries. All host specifics are injected.",
+  "version": "0.2.15",
+  "description": "Shared server-side core for MulmoClaude and MulmoTerminal — the always-shipped-together subsystems consolidated behind subpath exports so the two hosts can't drift. Server-only except the browser-safe ./whisper/client, ./workspace-setup/slug and ./translation/client entries. All host specifics are injected.",
   "type": "module",
   "exports": {
     "./collection": {
@@ -82,6 +82,12 @@
       "require": "./dist/whisper/client.cjs",
       "default": "./dist/whisper/client.js"
     },
+    "./translation/client": {
+      "types": "./dist/translation/client.d.ts",
+      "import": "./dist/translation/client.js",
+      "require": "./dist/translation/client.cjs",
+      "default": "./dist/translation/client.js"
+    },
     "./workspace-setup": {
       "types": "./dist/workspace-setup/index.d.ts",
       "import": "./dist/workspace-setup/index.js",