@openspecui/core 3.7.2 → 3.9.0

package/dist/translator-C3LT7PqW.mjs

@@ -0,0 +1,147 @@
+import { z } from "zod";
+
+//#region src/translator.ts
+const TRANSLATOR_CONTRACT_VERSION = 2;
+const TRANSLATION_ENGINE_IDS = [
+	"browser",
+	"local",
+	"openai"
+];
+const TranslationEngineIdSchema = z.enum(TRANSLATION_ENGINE_IDS);
+const DEFAULT_TRANSLATION_ENGINE_ID = "browser";
+const SERVICE_TRANSLATION_ENGINE_IDS = ["local", "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()
+});
+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(),
+	selectable: z.boolean(),
+	selected: z.boolean(),
+	files: z.array(TranslationDownloadFilePlanSchema)
+});
+const LocalModelAssetLogSchema = z.object({
+	engineId: z.literal("local"),
+	modelId: z.string().min(1),
+	selectedGroupId: 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),
+	status: LocalModelDownloadStatusSchema.default("not-downloaded"),
+	selected: z.boolean().default(false),
+	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(),
+	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 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",
+		moduleName: "@openspecui/browser-translator",
+		factoryExport: "createBrowserTranslatorFactory"
+	},
+	{
+		id: "local",
+		label: "Local-Transformers",
+		description: "Runs a bundled local Transformers.js translation runtime with managed model files.",
+		technicalSummary: "Server-side Transformers.js local adapter. Package payload is about 5 KB; selected model groups are downloaded separately and can range from tens to hundreds of MB.",
+		runtime: "server",
+		moduleName: "@openspecui/local-translator",
+		factoryExport: "createLocalTranslatorFactory"
+	},
+	{
+		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",
+		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;
+}
+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 TranslationEngineGlobalSettingsSchema = z.object({
+	openai: TranslationOpenAISettingsSchema.default(TranslationOpenAISettingsSchema.parse({})),
+	local: TranslationLocalSettingsSchema.default(TranslationLocalSettingsSchema.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 { TranslationLocalSettingsSchema as _, LocalModelAssetPlanSnapshotSchema as a, SERVICE_TRANSLATION_ENGINE_IDS as c, TRANSLATION_ENGINE_MANIFESTS as d, TRANSLATOR_CONTRACT_VERSION as f, TranslationEngineIdSchema as g, TranslationEngineGlobalSettingsSchema as h, LocalModelAssetLogSchema as i, ServiceTranslationEngineIdSchema as l, TranslationDownloadGroupPlanSchema as m, BatchTranslateInputSchema as n, LocalModelAssetStateSchema as o, TranslationDownloadFilePlanSchema as p, DEFAULT_TRANSLATION_ENGINE_ID as r, LocalModelDownloadStatusSchema as s, BatchTranslateEventSchema as t, TRANSLATION_ENGINE_IDS as u, TranslationOpenAISettingsSchema as v, getTranslationEngineManifest as y };

package/dist/translator.d.mts

@@ -0,0 +1,2 @@
+import { $ as getTranslationEngineManifest, A as TranslationEngineGlobalSettingsSchema, B as TranslationModelSearchEvent, C as TRANSLATION_ENGINE_MANIFESTS, D as TranslationDownloadGroupPlan, E as TranslationDownloadFilePlanSchema, F as TranslationEngineRuntime, G as TranslationOpenAISettingsSchema, H as TranslationModelSearchPhase, I as TranslationLocalSettings, J as TranslatorFactory, K as Translator, L as TranslationLocalSettingsSchema, M as TranslationEngineId, N as TranslationEngineIdSchema, O as TranslationDownloadGroupPlanSchema, P as TranslationEngineManifest, Q as TranslatorPrepareMonitor, R as TranslationModelCandidate, S as TRANSLATION_ENGINE_IDS, T as TranslationDownloadFilePlan, U as TranslationModelSearchResult, V as TranslationModelSearchInput, W as TranslationOpenAISettings, X as TranslatorFactoryPrepareOptions, Y as TranslatorFactoryCreateOptions, Z as TranslatorOptions, _ as LocalModelDownloadStatus, a as BatchTranslationResult, b as ServiceTranslationEngineId, c as LocalModelAssetLogSchema, d as LocalModelAssetState, f as LocalModelAssetStateSchema, g as LocalModelCatalogSearchEvent, h as LocalModelCatalogResult, i as BatchTranslateInputSchema, j as TranslationEngineGlobalSettingsUpdate, k as TranslationEngineGlobalSettings, l as LocalModelAssetPlanSnapshot, m as LocalModelCatalogLocalResult, n as BatchTranslateEventSchema, o as DEFAULT_TRANSLATION_ENGINE_ID, p as LocalModelCatalogItem, q as TranslatorCreateMonitor, r as BatchTranslateInput, s as LocalModelAssetLog, t as BatchTranslateEvent, u as LocalModelAssetPlanSnapshotSchema, v as LocalModelDownloadStatusSchema, w as TRANSLATOR_CONTRACT_VERSION, x as ServiceTranslationEngineIdSchema, y as SERVICE_TRANSLATION_ENGINE_IDS, z as TranslationModelDownloadPlan } from "./translator-BEhPdQGs.mjs";
+export { BatchTranslateEvent, BatchTranslateEventSchema, BatchTranslateInput, BatchTranslateInputSchema, BatchTranslationResult, DEFAULT_TRANSLATION_ENGINE_ID, LocalModelAssetLog, LocalModelAssetLogSchema, LocalModelAssetPlanSnapshot, LocalModelAssetPlanSnapshotSchema, LocalModelAssetState, LocalModelAssetStateSchema, LocalModelCatalogItem, LocalModelCatalogLocalResult, LocalModelCatalogResult, LocalModelCatalogSearchEvent, LocalModelDownloadStatus, LocalModelDownloadStatusSchema, SERVICE_TRANSLATION_ENGINE_IDS, ServiceTranslationEngineId, ServiceTranslationEngineIdSchema, TRANSLATION_ENGINE_IDS, TRANSLATION_ENGINE_MANIFESTS, TRANSLATOR_CONTRACT_VERSION, TranslationDownloadFilePlan, TranslationDownloadFilePlanSchema, TranslationDownloadGroupPlan, TranslationDownloadGroupPlanSchema, TranslationEngineGlobalSettings, TranslationEngineGlobalSettingsSchema, TranslationEngineGlobalSettingsUpdate, TranslationEngineId, TranslationEngineIdSchema, TranslationEngineManifest, TranslationEngineRuntime, TranslationLocalSettings, TranslationLocalSettingsSchema, TranslationModelCandidate, TranslationModelDownloadPlan, TranslationModelSearchEvent, TranslationModelSearchInput, TranslationModelSearchPhase, TranslationModelSearchResult, TranslationOpenAISettings, TranslationOpenAISettingsSchema, Translator, TranslatorCreateMonitor, TranslatorFactory, TranslatorFactoryCreateOptions, TranslatorFactoryPrepareOptions, TranslatorOptions, TranslatorPrepareMonitor, getTranslationEngineManifest };

package/dist/translator.mjs

@@ -0,0 +1,3 @@
+import { _ as TranslationLocalSettingsSchema, a as LocalModelAssetPlanSnapshotSchema, c as SERVICE_TRANSLATION_ENGINE_IDS, d as TRANSLATION_ENGINE_MANIFESTS, f as TRANSLATOR_CONTRACT_VERSION, g as TranslationEngineIdSchema, h as TranslationEngineGlobalSettingsSchema, i as LocalModelAssetLogSchema, l as ServiceTranslationEngineIdSchema, m as TranslationDownloadGroupPlanSchema, n as BatchTranslateInputSchema, o as LocalModelAssetStateSchema, p as TranslationDownloadFilePlanSchema, r as DEFAULT_TRANSLATION_ENGINE_ID, s as LocalModelDownloadStatusSchema, t as BatchTranslateEventSchema, u as TRANSLATION_ENGINE_IDS, v as TranslationOpenAISettingsSchema, y as getTranslationEngineManifest } from "./translator-C3LT7PqW.mjs";
+
+export { BatchTranslateEventSchema, BatchTranslateInputSchema, DEFAULT_TRANSLATION_ENGINE_ID, LocalModelAssetLogSchema, LocalModelAssetPlanSnapshotSchema, LocalModelAssetStateSchema, LocalModelDownloadStatusSchema, SERVICE_TRANSLATION_ENGINE_IDS, ServiceTranslationEngineIdSchema, TRANSLATION_ENGINE_IDS, TRANSLATION_ENGINE_MANIFESTS, TRANSLATOR_CONTRACT_VERSION, TranslationDownloadFilePlanSchema, TranslationDownloadGroupPlanSchema, TranslationEngineGlobalSettingsSchema, TranslationEngineIdSchema, TranslationLocalSettingsSchema, TranslationOpenAISettingsSchema, getTranslationEngineManifest };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openspecui/core",
-  "version": "3.7.2",
+  "version": "3.9.0",
   "description": "Core OpenSpec adapter and parser",
   "type": "module",
   "main": "./dist/index.mjs",
@@ -48,6 +48,18 @@
       "default": "./dist/document-translation.mjs",
       "types": "./dist/document-translation.d.mts"
     },
+    "./translator": {
+      "development": "./src/translator.ts",
+      "import": "./dist/translator.mjs",
+      "default": "./dist/translator.mjs",
+      "types": "./dist/translator.d.mts"
+    },
+    "./local-download-profiles": {
+      "development": "./src/local-download-profiles.ts",
+      "import": "./dist/local-download-profiles.mjs",
+      "default": "./dist/local-download-profiles.mjs",
+      "types": "./dist/local-download-profiles.d.mts"
+    },
     "./openspec-annotations": {
       "development": "./src/openspec-annotations.ts",
       "import": "./dist/openspec-annotations.mjs",
@@ -119,8 +131,8 @@
     "dist"
   ],
   "scripts": {
-    "build": "tsdown src/index.ts src/dashboard-display.ts src/opsx-display-path.ts src/opsx-entity.ts src/opsx-schema-detail.ts src/hosted-app.ts src/openspec-compat.ts src/markdown-facts.ts src/markdown-reading.ts src/document-translation.ts src/openspec-annotations.ts src/openspec-projection.ts src/notifications.ts src/sounds.ts src/terminal-theme.ts src/terminal-invocation.ts src/terminal-audio.ts src/terminal-control.ts --format esm --dts",
-    "dev": "tsdown src/index.ts src/dashboard-display.ts src/opsx-display-path.ts src/opsx-entity.ts src/opsx-schema-detail.ts src/hosted-app.ts src/openspec-compat.ts src/markdown-facts.ts src/markdown-reading.ts src/document-translation.ts src/openspec-annotations.ts src/openspec-projection.ts src/notifications.ts src/sounds.ts src/terminal-theme.ts src/terminal-invocation.ts src/terminal-audio.ts src/terminal-control.ts --format esm --dts --watch",
+    "build": "tsdown src/index.ts src/dashboard-display.ts src/opsx-display-path.ts src/opsx-entity.ts src/opsx-schema-detail.ts src/hosted-app.ts src/openspec-compat.ts src/markdown-facts.ts src/markdown-reading.ts src/document-translation.ts src/translator.ts src/local-download-profiles.ts src/openspec-annotations.ts src/openspec-projection.ts src/notifications.ts src/sounds.ts src/terminal-theme.ts src/terminal-invocation.ts src/terminal-audio.ts src/terminal-control.ts --format esm --dts",
+    "dev": "tsdown src/index.ts src/dashboard-display.ts src/opsx-display-path.ts src/opsx-entity.ts src/opsx-schema-detail.ts src/hosted-app.ts src/openspec-compat.ts src/markdown-facts.ts src/markdown-reading.ts src/document-translation.ts src/translator.ts src/local-download-profiles.ts src/openspec-annotations.ts src/openspec-projection.ts src/notifications.ts src/sounds.ts src/terminal-theme.ts src/terminal-invocation.ts src/terminal-audio.ts src/terminal-control.ts --format esm --dts --watch",
     "test": "vitest run",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit"

package/dist/document-translation-D_ryOn9u.d.mts

@@ -1,140 +0,0 @@
-import { z } from "zod";
-
-//#region src/document-translation.d.ts
-declare const DOCUMENT_TRANSLATION_DISPLAY_MODES: readonly ["direct", "bilingual"];
-declare const DocumentTranslationDisplayModeSchema: z.ZodEnum<["direct", "bilingual"]>;
-type DocumentTranslationDisplayMode = z.infer<typeof DocumentTranslationDisplayModeSchema>;
-declare const DocumentTranslationConfigSchema: z.ZodObject<{
-  enabled: z.ZodDefault<z.ZodBoolean>;
-  targetLanguage: z.ZodDefault<z.ZodString>;
-  displayMode: z.ZodDefault<z.ZodEnum<["direct", "bilingual"]>>;
-  cacheEnabled: z.ZodDefault<z.ZodBoolean>;
-}, "strip", z.ZodTypeAny, {
-  enabled: boolean;
-  targetLanguage: string;
-  displayMode: "direct" | "bilingual";
-  cacheEnabled: boolean;
-}, {
-  enabled?: boolean | undefined;
-  targetLanguage?: string | undefined;
-  displayMode?: "direct" | "bilingual" | undefined;
-  cacheEnabled?: boolean | undefined;
-}>;
-type DocumentTranslationConfig = z.infer<typeof DocumentTranslationConfigSchema>;
-declare const DEFAULT_TRANSLATION_CACHE_ENTRY_LIMIT = 10000;
-declare const MIN_TRANSLATION_CACHE_ENTRY_LIMIT = 100;
-declare const MAX_TRANSLATION_CACHE_ENTRY_LIMIT = 200000;
-declare const TRANSLATION_CACHE_POLICY_VERSION = 2;
-declare const TranslationCacheSettingsSchema: z.ZodObject<{
-  entryLimit: z.ZodDefault<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-  entryLimit: number;
-}, {
-  entryLimit?: number | undefined;
-}>;
-type TranslationCacheSettings = z.infer<typeof TranslationCacheSettingsSchema>;
-declare const TranslationCacheEntrySchema: z.ZodObject<{
-  key: z.ZodString;
-  keyHash: z.ZodString;
-  sourceText: z.ZodString;
-  translatedText: z.ZodString;
-  targetNodesJson: z.ZodOptional<z.ZodString>;
-  sourceLanguage: z.ZodString;
-  targetLanguage: z.ZodString;
-  placeholderTopologyHash: z.ZodString;
-  attributeTopologyHash: z.ZodString;
-  displayPolicyVersion: z.ZodNumber;
-  createdAt: z.ZodNumber;
-  lastAccessedAt: z.ZodNumber;
-}, "strip", z.ZodTypeAny, {
-  createdAt: number;
-  targetLanguage: string;
-  key: string;
-  keyHash: string;
-  sourceText: string;
-  translatedText: string;
-  sourceLanguage: string;
-  placeholderTopologyHash: string;
-  attributeTopologyHash: string;
-  displayPolicyVersion: number;
-  lastAccessedAt: number;
-  targetNodesJson?: string | undefined;
-}, {
-  createdAt: number;
-  targetLanguage: string;
-  key: string;
-  keyHash: string;
-  sourceText: string;
-  translatedText: string;
-  sourceLanguage: string;
-  placeholderTopologyHash: string;
-  attributeTopologyHash: string;
-  displayPolicyVersion: number;
-  lastAccessedAt: number;
-  targetNodesJson?: string | undefined;
-}>;
-type TranslationCacheEntry = z.infer<typeof TranslationCacheEntrySchema>;
-declare const TranslationCacheWriteInputSchema: z.ZodObject<Omit<{
-  key: z.ZodString;
-  keyHash: z.ZodString;
-  sourceText: z.ZodString;
-  translatedText: z.ZodString;
-  targetNodesJson: z.ZodOptional<z.ZodString>;
-  sourceLanguage: z.ZodString;
-  targetLanguage: z.ZodString;
-  placeholderTopologyHash: z.ZodString;
-  attributeTopologyHash: z.ZodString;
-  displayPolicyVersion: z.ZodNumber;
-  createdAt: z.ZodNumber;
-  lastAccessedAt: z.ZodNumber;
-}, "createdAt" | "lastAccessedAt">, "strip", z.ZodTypeAny, {
-  targetLanguage: string;
-  key: string;
-  keyHash: string;
-  sourceText: string;
-  translatedText: string;
-  sourceLanguage: string;
-  placeholderTopologyHash: string;
-  attributeTopologyHash: string;
-  displayPolicyVersion: number;
-  targetNodesJson?: string | undefined;
-}, {
-  targetLanguage: string;
-  key: string;
-  keyHash: string;
-  sourceText: string;
-  translatedText: string;
-  sourceLanguage: string;
-  placeholderTopologyHash: string;
-  attributeTopologyHash: string;
-  displayPolicyVersion: number;
-  targetNodesJson?: string | undefined;
-}>;
-type TranslationCacheWriteInput = z.infer<typeof TranslationCacheWriteInputSchema>;
-declare const TranslationCacheReadInputSchema: z.ZodObject<{
-  keyHash: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-  keyHash: string;
-}, {
-  keyHash: string;
-}>;
-type TranslationCacheReadInput = z.infer<typeof TranslationCacheReadInputSchema>;
-declare const TranslationCacheStatsSchema: z.ZodObject<{
-  enabled: z.ZodBoolean;
-  entryLimit: z.ZodNumber;
-  entries: z.ZodNumber;
-  databasePath: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-  entries: number;
-  enabled: boolean;
-  entryLimit: number;
-  databasePath?: string | undefined;
-}, {
-  entries: number;
-  enabled: boolean;
-  entryLimit: number;
-  databasePath?: string | undefined;
-}>;
-type TranslationCacheStats = z.infer<typeof TranslationCacheStatsSchema>;
-//#endregion
-export { TranslationCacheStatsSchema as _, DocumentTranslationDisplayMode as a, MIN_TRANSLATION_CACHE_ENTRY_LIMIT as c, TranslationCacheEntrySchema as d, TranslationCacheReadInput as f, TranslationCacheStats as g, TranslationCacheSettingsSchema as h, DocumentTranslationConfigSchema as i, TRANSLATION_CACHE_POLICY_VERSION as l, TranslationCacheSettings as m, DOCUMENT_TRANSLATION_DISPLAY_MODES as n, DocumentTranslationDisplayModeSchema as o, TranslationCacheReadInputSchema as p, DocumentTranslationConfig as r, MAX_TRANSLATION_CACHE_ENTRY_LIMIT as s, DEFAULT_TRANSLATION_CACHE_ENTRY_LIMIT as t, TranslationCacheEntry as u, TranslationCacheWriteInput as v, TranslationCacheWriteInputSchema as y };