@openspecui/core 3.11.1 → 3.11.3

package/dist/translator-Car0_7uk.mjs

@@ -0,0 +1,412 @@
+import { z } from "zod";
+
+//#region src/translator.ts
+const TRANSLATOR_CONTRACT_VERSION = 3;
+const TRANSLATION_ENGINE_IDS = [
+	"browser",
+	"local",
+	"local-ct2",
+	"local-llama",
+	"openai"
+];
+const TranslationEngineIdSchema = z.enum(TRANSLATION_ENGINE_IDS);
+const DEFAULT_TRANSLATION_ENGINE_ID = "browser";
+function isManagedLocalTranslationEngineId(engineId) {
+	return engineId === "local" || engineId === "local-ct2" || engineId === "local-llama";
+}
+function isDirectionalManagedLocalTranslationEngineId(engineId) {
+	return engineId === "local" || engineId === "local-ct2";
+}
+const SERVICE_TRANSLATION_ENGINE_IDS = [
+	"local",
+	"local-ct2",
+	"local-llama",
+	"openai"
+];
+const ServiceTranslationEngineIdSchema = z.enum(SERVICE_TRANSLATION_ENGINE_IDS);
+const LocalModelDownloadStatusSchema = z.enum([
+	"not-downloaded",
+	"queued",
+	"downloading",
+	"paused",
+	"downloaded",
+	"error",
+	"deleting"
+]);
+const TranslationDownloadFilePlanSchema = z.object({
+	path: z.string().min(1),
+	sizeBytes: z.number().int().nonnegative().optional(),
+	required: z.boolean(),
+	etag: z.string().min(1).optional(),
+	revision: z.string().min(1).optional(),
+	sourceUrl: z.string().min(1).optional(),
+	raw: z.unknown().optional()
+});
+const TranslationDownloadGroupPlanSchema = z.object({
+	id: z.string().min(1),
+	label: z.string().min(1),
+	description: z.string().optional(),
+	profile: z.string().min(1).optional(),
+	dtype: z.string().min(1).optional(),
+	estimatedTotalBytes: z.number().int().nonnegative().optional(),
+	baseGroupId: z.string().min(1).optional(),
+	commitHash: z.string().min(1).optional(),
+	shortCommitHash: z.string().min(1).optional(),
+	rootDir: z.string().min(1).optional(),
+	status: LocalModelDownloadStatusSchema.optional(),
+	progress: z.number().min(0).max(1).optional(),
+	bytesDownloaded: z.number().int().nonnegative().optional(),
+	totalBytes: z.number().int().nonnegative().optional(),
+	resumable: z.boolean().optional(),
+	error: z.string().optional(),
+	selectable: z.boolean(),
+	selected: z.boolean(),
+	files: z.array(TranslationDownloadFilePlanSchema)
+});
+const LocalModelProfileStatusSchema = z.enum([
+	"idle",
+	"loading",
+	"ready",
+	"error"
+]);
+const LocalModelProfileManifestFileSchema = z.object({
+	path: z.string().min(1),
+	sizeBytes: z.number().int().nonnegative().optional(),
+	required: z.boolean(),
+	etag: z.string().min(1).optional(),
+	revision: z.string().min(1).optional(),
+	sourceUrl: z.string().min(1).optional(),
+	raw: z.unknown().optional()
+});
+const LocalModelProfileManifestGroupSchema = z.object({
+	id: z.string().min(1),
+	baseGroupId: z.string().min(1),
+	label: z.string().min(1),
+	displayLabel: z.string().min(1),
+	description: z.string().optional(),
+	profile: z.string().min(1).optional(),
+	dtype: z.string().min(1).optional(),
+	commitHash: z.string().min(1),
+	shortCommitHash: z.string().min(1),
+	rootDir: z.string().min(1),
+	estimatedTotalBytes: z.number().int().nonnegative().optional(),
+	selectable: z.boolean(),
+	files: z.array(LocalModelProfileManifestFileSchema)
+});
+const LocalModelProfileManifestSchema = z.object({
+	modelId: z.string().min(1),
+	source: z.literal("huggingface"),
+	endpoint: z.string().default(""),
+	revision: z.string().min(1),
+	commitHash: z.string().min(1),
+	shortCommitHash: z.string().min(1),
+	fetchedAt: z.number().int().nonnegative(),
+	updatedAt: z.number().int().nonnegative(),
+	raw: z.unknown().optional(),
+	groups: z.record(z.string(), LocalModelProfileManifestGroupSchema).default({}),
+	groupOrder: z.array(z.string().min(1)).default([])
+});
+const LocalModelLifecycleFileStateSchema = z.object({
+	path: z.string().min(1),
+	sizeBytes: z.number().int().nonnegative().optional(),
+	downloadedBytes: z.number().int().nonnegative().optional(),
+	required: z.boolean().default(true),
+	status: LocalModelDownloadStatusSchema.default("not-downloaded"),
+	updatedAt: z.number().int().nonnegative().optional(),
+	error: z.string().optional()
+});
+const LocalModelLifecycleGroupStateSchema = z.object({
+	groupId: z.string().min(1),
+	baseGroupId: z.string().min(1).optional(),
+	status: LocalModelDownloadStatusSchema.default("not-downloaded"),
+	rootDir: z.string().min(1).optional(),
+	bytesDownloaded: z.number().int().nonnegative().optional(),
+	totalBytes: z.number().int().nonnegative().optional(),
+	progress: z.number().min(0).max(1).optional(),
+	resumable: z.boolean().default(false),
+	error: z.string().optional(),
+	installedAt: z.number().int().nonnegative().optional(),
+	updatedAt: z.number().int().nonnegative().optional(),
+	files: z.array(LocalModelLifecycleFileStateSchema).default([])
+});
+const LocalModelProfileLoadStateSchema = z.object({
+	status: LocalModelProfileStatusSchema.default("idle"),
+	message: z.string().optional(),
+	error: z.string().optional(),
+	updatedAt: z.number().int().nonnegative().optional()
+});
+const LocalModelAssetLogSchema = z.object({
+	engineId: z.enum([
+		"local",
+		"local-ct2",
+		"local-llama"
+	]),
+	modelId: z.string().min(1),
+	selectedGroupId: z.string().min(1).optional(),
+	groupId: z.string().min(1).optional(),
+	status: LocalModelDownloadStatusSchema,
+	message: z.string(),
+	progress: z.number().min(0).max(1).optional(),
+	bytesDownloaded: z.number().int().nonnegative().optional(),
+	totalBytes: z.number().int().nonnegative().optional(),
+	sessionId: z.string().optional(),
+	resumable: z.boolean().optional(),
+	files: z.array(z.object({
+		path: z.string().min(1),
+		sizeBytes: z.number().int().nonnegative().optional(),
+		downloadedBytes: z.number().int().nonnegative().optional()
+	})).optional(),
+	updatedAt: z.number().int().nonnegative()
+});
+const LocalModelAssetPlanSnapshotSchema = z.object({
+	modelId: z.string().min(1),
+	estimatedTotalBytes: z.number().int().nonnegative().optional(),
+	files: z.array(TranslationDownloadFilePlanSchema),
+	profile: z.string().min(1).optional(),
+	selectedGroupId: z.string().min(1).optional(),
+	groups: z.array(TranslationDownloadGroupPlanSchema).optional()
+});
+const LocalModelAssetStateSchema = z.object({
+	modelId: z.string().min(1),
+	version: z.literal(2).default(2),
+	status: LocalModelDownloadStatusSchema.default("not-downloaded"),
+	selected: z.boolean().default(false),
+	selectedGroupId: z.string().min(1).optional(),
+	installedAt: z.number().int().nonnegative().optional(),
+	updatedAt: z.number().int().nonnegative().optional(),
+	bytesDownloaded: z.number().int().nonnegative().optional(),
+	totalBytes: z.number().int().nonnegative().optional(),
+	progress: z.number().min(0).max(1).optional(),
+	resumable: z.boolean().default(false),
+	error: z.string().optional(),
+	profileLoad: LocalModelProfileLoadStateSchema.default(LocalModelProfileLoadStateSchema.parse({})),
+	profileManifest: LocalModelProfileManifestSchema.optional(),
+	groupsState: z.record(z.string(), LocalModelLifecycleGroupStateSchema).default({}),
+	plan: LocalModelAssetPlanSnapshotSchema.optional(),
+	files: z.array(z.object({
+		path: z.string().min(1),
+		sizeBytes: z.number().int().nonnegative().optional(),
+		downloadedBytes: z.number().int().nonnegative().optional()
+	})).default([])
+});
+const ManagedLocalCatalogSourceSchema = z.enum([
+	"local",
+	"network",
+	"recommended"
+]);
+const TranslationEngineDependencyStateSchema = z.enum([
+	"installed",
+	"installing",
+	"missing",
+	"error",
+	"not-applicable"
+]);
+const TranslationEngineRuntimeStateSchema = z.enum([
+	"ready",
+	"probing",
+	"failed",
+	"error",
+	"not-applicable"
+]);
+const TranslationEngineAssetStateSchema = z.enum([
+	"ready",
+	"missing",
+	"downloading",
+	"error",
+	"not-applicable"
+]);
+const TranslationEngineLifecyclePhaseMetaSchema = z.object({
+	message: z.string().optional(),
+	progress: z.number().min(0).max(1).optional(),
+	error: z.string().optional()
+});
+const TranslationEngineDependencyStatusSchema = TranslationEngineLifecyclePhaseMetaSchema.extend({ state: TranslationEngineDependencyStateSchema });
+const TranslationEngineRuntimeStatusSchema = TranslationEngineLifecyclePhaseMetaSchema.extend({ state: TranslationEngineRuntimeStateSchema });
+const TranslationEngineAssetStatusSchema = TranslationEngineLifecyclePhaseMetaSchema.extend({ state: TranslationEngineAssetStateSchema });
+const TranslationEngineLifecycleStatusSchema = z.object({
+	dependency: TranslationEngineDependencyStatusSchema,
+	runtime: TranslationEngineRuntimeStatusSchema,
+	assets: TranslationEngineAssetStatusSchema,
+	summary: z.string().optional()
+});
+function createTranslationEngineLifecycleStatus(input = {}) {
+	return {
+		dependency: {
+			state: "not-applicable",
+			...input.dependency
+		},
+		runtime: {
+			state: "not-applicable",
+			...input.runtime
+		},
+		assets: {
+			state: "not-applicable",
+			...input.assets
+		},
+		...input.summary ? { summary: input.summary } : {}
+	};
+}
+function isTranslationEngineDependencyReady(status) {
+	return status.dependency.state === "installed" || status.dependency.state === "not-applicable";
+}
+function isTranslationEngineRuntimeReady(status) {
+	return status.runtime.state === "ready" || status.runtime.state === "not-applicable";
+}
+function shouldShowTranslationEngineInstallGate(status) {
+	if (!status) return false;
+	return !isTranslationEngineDependencyReady(status) || !isTranslationEngineRuntimeReady(status);
+}
+function getTranslationEngineLifecycleMessage(status) {
+	if (!status) return void 0;
+	return status.summary ?? status.runtime.error ?? status.runtime.message ?? status.dependency.error ?? status.dependency.message ?? status.assets.error ?? status.assets.message;
+}
+const TranslationEngineInstallLogStreamSchema = z.enum(["stdout", "stderr"]);
+const TranslationEngineInstallLogEventSchema = z.object({
+	stream: TranslationEngineInstallLogStreamSchema,
+	text: z.string()
+});
+const TranslationEngineLifecycleEventSchema = z.discriminatedUnion("type", [
+	z.object({
+		type: z.literal("status"),
+		lifecycle: TranslationEngineLifecycleStatusSchema
+	}),
+	z.object({
+		type: z.literal("log"),
+		stream: TranslationEngineInstallLogStreamSchema,
+		text: z.string()
+	}),
+	z.object({
+		type: z.literal("exit"),
+		lifecycle: TranslationEngineLifecycleStatusSchema
+	})
+]);
+const TRANSLATION_ENGINE_MANIFESTS = [
+	{
+		id: "browser",
+		label: "Browser",
+		description: "Uses the browser Translator API and future browser-side providers.",
+		technicalSummary: "Browser-native Web Translator adapter. Package payload is about 5 KB; browser language packs are managed by the browser.",
+		runtime: "browser",
+		kind: "browser",
+		installDescription: "Browser translation support is built into the browser runtime.",
+		moduleName: "@openspecui/browser-translator",
+		factoryExport: "createBrowserTranslatorFactory"
+	},
+	{
+		id: "local",
+		label: "Local-Transformers",
+		description: "Runs an ONNX Runtime-backed local translation adapter through Transformers.js with managed ONNX model files.",
+		technicalSummary: "Server-side ONNX Runtime adapter via Transformers.js. Runtime package is installed on demand; selected ONNX model groups are downloaded separately and can range from tens to hundreds of MB.",
+		runtime: "server",
+		kind: "managed-local",
+		settingsKey: "local",
+		defaultModel: "Xenova/nllb-200-distilled-600M",
+		runtimePackageName: "@huggingface/transformers",
+		installDescription: "Install the Local-Transformers runtime package to enable server-side translation.",
+		modelLabel: "Local Model",
+		downloadGroupsLabel: "Local download profiles",
+		refreshTooltip: "Refresh local model profiles",
+		moduleName: "@openspecui/local-translator",
+		factoryExport: "createLocalTranslatorFactory"
+	},
+	{
+		id: "local-ct2",
+		label: "Local-CT2",
+		description: "Runs a bundled local CTranslate2 translation runtime with managed model files.",
+		technicalSummary: "Server-side native CTranslate2 adapter. Runtime package is installed on demand; selected model artifacts are downloaded separately and can range from tens to hundreds of MB.",
+		runtime: "server",
+		kind: "managed-local",
+		settingsKey: "localCt2",
+		defaultModel: "ooeoeo/opus-mt-en-zh-ct2-float16",
+		runtimePackageName: "ctranslate2",
+		installDescription: "Install the Local-CT2 runtime package to enable server-side translation.",
+		modelLabel: "CT2 Model",
+		downloadGroupsLabel: "Local CT2 download groups",
+		refreshTooltip: "Refresh local model artifacts",
+		moduleName: "@openspecui/local-ct2-translator",
+		factoryExport: "createLocalCt2TranslatorFactory"
+	},
+	{
+		id: "local-llama",
+		label: "Local-Llama",
+		description: "Runs a local GGUF translation-capable LLM through node-llama-cpp with managed GGUF model files.",
+		technicalSummary: "Server-side llama.cpp adapter via node-llama-cpp. Runtime package is installed on demand; selected GGUF model files are downloaded separately and can range from hundreds of MB to multiple GB.",
+		runtime: "server",
+		kind: "managed-local",
+		settingsKey: "localLlama",
+		defaultModel: "bartowski/Qwen2.5-0.5B-Instruct-GGUF",
+		runtimePackageName: "node-llama-cpp",
+		installDescription: "Install the Local-Llama runtime package to enable server-side GGUF translation.",
+		modelLabel: "Llama Model",
+		downloadGroupsLabel: "Local GGUF files",
+		refreshTooltip: "Refresh local GGUF artifacts",
+		moduleName: "@openspecui/local-llama-translator",
+		factoryExport: "createLocalLlamaTranslatorFactory"
+	},
+	{
+		id: "openai",
+		label: "OpenAI-Completion",
+		description: "Uses an OpenAI-compatible TanStack AI completion provider for context-aware translation.",
+		technicalSummary: "Server-side TanStack AI adapter for OpenAI-compatible APIs. Package payload is about 5 KB; model size stays with the remote provider.",
+		runtime: "server",
+		kind: "remote-provider",
+		settingsKey: "openai",
+		defaultModel: "gpt-4.1-mini",
+		installDescription: "OpenAI completion translation is bundled with the server runtime.",
+		moduleName: "@openspecui/openai-completion-translator",
+		factoryExport: "createOpenAICompletionTranslatorFactory"
+	}
+];
+function getTranslationEngineManifest(engineId) {
+	const manifest = TRANSLATION_ENGINE_MANIFESTS.find((engine) => engine.id === engineId);
+	if (!manifest) throw new Error(`Unknown translation engine: ${engineId}`);
+	return manifest;
+}
+function getManagedLocalTranslationEngineManifest(engineId) {
+	const manifest = getTranslationEngineManifest(engineId);
+	if (manifest.kind !== "managed-local") throw new Error(`Translation engine ${engineId} is not a managed-local engine.`);
+	return manifest;
+}
+const TranslationOpenAISettingsSchema = z.object({
+	baseUrl: z.string().default(""),
+	token: z.string().default(""),
+	model: z.string().default("gpt-4.1-mini")
+});
+const TranslationLocalSettingsSchema = z.object({
+	model: z.string().default("Xenova/nllb-200-distilled-600M"),
+	selectedGroupId: z.string().optional(),
+	hfEndpoint: z.string().default("")
+});
+const TranslationLocalCt2SettingsSchema = z.object({
+	model: z.string().default("ooeoeo/opus-mt-en-zh-ct2-float16"),
+	selectedGroupId: z.string().optional(),
+	hfEndpoint: z.string().default("")
+});
+const TranslationLocalLlamaSettingsSchema = z.object({
+	model: z.string().default("bartowski/Qwen2.5-0.5B-Instruct-GGUF"),
+	selectedGroupId: z.string().optional(),
+	hfEndpoint: z.string().default("")
+});
+const TranslationEngineGlobalSettingsSchema = z.object({
+	openai: TranslationOpenAISettingsSchema.default(TranslationOpenAISettingsSchema.parse({})),
+	local: TranslationLocalSettingsSchema.default(TranslationLocalSettingsSchema.parse({})),
+	localCt2: TranslationLocalCt2SettingsSchema.default(TranslationLocalCt2SettingsSchema.parse({})),
+	localLlama: TranslationLocalLlamaSettingsSchema.default(TranslationLocalLlamaSettingsSchema.parse({}))
+});
+const BatchTranslateInputSchema = z.object({
+	engineId: TranslationEngineIdSchema,
+	sourceLanguage: z.string().min(1),
+	targetLanguage: z.string().min(1),
+	model: z.string().min(1).optional(),
+	selectedGroupId: z.string().min(1).optional(),
+	inputs: z.array(z.string()).min(1),
+	instructions: z.string().optional(),
+	context: z.string().optional()
+});
+const BatchTranslateEventSchema = z.object({
+	index: z.number().int().nonnegative(),
+	output: z.string()
+});
+
+//#endregion
+export { TranslationEngineInstallLogStreamSchema as A, getManagedLocalTranslationEngineManifest as B, TranslationEngineAssetStateSchema as C, TranslationEngineGlobalSettingsSchema as D, TranslationEngineDependencyStatusSchema as E, TranslationLocalCt2SettingsSchema as F, isTranslationEngineDependencyReady as G, getTranslationEngineManifest as H, TranslationLocalLlamaSettingsSchema as I, isTranslationEngineRuntimeReady as K, TranslationLocalSettingsSchema as L, TranslationEngineLifecycleStatusSchema as M, TranslationEngineRuntimeStateSchema as N, TranslationEngineIdSchema as O, TranslationEngineRuntimeStatusSchema as P, TranslationOpenAISettingsSchema as R, TranslationDownloadGroupPlanSchema as S, TranslationEngineDependencyStateSchema as T, isDirectionalManagedLocalTranslationEngineId as U, getTranslationEngineLifecycleMessage as V, isManagedLocalTranslationEngineId as W, ServiceTranslationEngineIdSchema as _, LocalModelAssetPlanSnapshotSchema as a, TRANSLATOR_CONTRACT_VERSION as b, LocalModelLifecycleFileStateSchema as c, LocalModelProfileManifestFileSchema as d, LocalModelProfileManifestGroupSchema as f, SERVICE_TRANSLATION_ENGINE_IDS as g, ManagedLocalCatalogSourceSchema as h, LocalModelAssetLogSchema as i, TranslationEngineLifecycleEventSchema as j, TranslationEngineInstallLogEventSchema as k, LocalModelLifecycleGroupStateSchema as l, LocalModelProfileStatusSchema as m, BatchTranslateInputSchema as n, LocalModelAssetStateSchema as o, LocalModelProfileManifestSchema as p, shouldShowTranslationEngineInstallGate as q, DEFAULT_TRANSLATION_ENGINE_ID as r, LocalModelDownloadStatusSchema as s, BatchTranslateEventSchema as t, LocalModelProfileLoadStateSchema as u, TRANSLATION_ENGINE_IDS as v, TranslationEngineAssetStatusSchema as w, TranslationDownloadFilePlanSchema as x, TRANSLATION_ENGINE_MANIFESTS as y, createTranslationEngineLifecycleStatus as z };