@x18n/ui 0.0.2 → 0.0.3

package/dist/index.mjs

@@ -0,0 +1,628 @@
+import { fileURLToPath } from "node:url";
+import { defineDevframe, defineRpcFunction } from "devframe";
+import { toJsonSchema } from "@valibot/to-json-schema";
+import { extractItems, findCandidates, toPlanFile } from "@x18n/builtins/extractors";
+import { X18nError, createLineIndex, parseMessageBatch, placeholderProblems, renderPrompt, toWireDiagnostic } from "@x18n/core";
+import * as v from "valibot";
+//#region package.json
+var name = "@x18n/ui";
+var version = "0.0.3";
+var description = "x18n UI as a devframe: dev server, static report, in-browser workspace and VS Code panel";
+var homepage = "https://github.com/antfu/x18n#readme";
+//#endregion
+//#region src/node/schemas.ts
+function text(description) {
+	return v.pipe(v.string(), v.description(description));
+}
+const project = v.optional(text("Project name from `x18n_status`. Required only in a monorepo with several projects."));
+const leaf = v.union([
+	v.string(),
+	v.number(),
+	v.boolean(),
+	v.null()
+]);
+const textRange = v.object({
+	start: v.number(),
+	end: v.number()
+});
+const ProjectQuerySchema = v.object({ project });
+const KeyQuerySchema = v.object({
+	project,
+	key: text("Full key, for example `nav.home` or `common:save`.")
+});
+const UsageQuerySchema = v.object({
+	project,
+	key: v.optional(text("Only usages of this key.")),
+	path: v.optional(text("Only usages in this file (path relative to the project root)."))
+});
+const PromptQuerySchema = v.object({
+	project,
+	locale: text("Target locale code, as listed by `x18n_status`."),
+	keys: v.optional(v.union([text("Key glob: `*` inside a segment, `**` across segments."), v.array(v.string())])),
+	namespace: v.optional(v.string()),
+	limit: v.optional(v.pipe(v.number(), v.description("Messages per prompt. Default 50."))),
+	cursor: v.optional(text("`nextCursor` of the previous prompt."))
+});
+const EditOpSchema = v.variant("type", [
+	v.object({
+		type: v.literal("set"),
+		key: v.string(),
+		locale: v.string(),
+		value: leaf
+	}),
+	v.object({
+		type: v.literal("rename"),
+		from: v.string(),
+		to: v.string(),
+		usages: v.exactOptional(v.boolean())
+	}),
+	v.object({
+		type: v.literal("rename-prefix"),
+		from: v.string(),
+		to: v.string(),
+		usages: v.exactOptional(v.boolean())
+	}),
+	v.object({
+		type: v.literal("delete"),
+		key: v.string(),
+		locales: v.exactOptional(v.union([v.literal("all"), v.array(v.string())]))
+	})
+]);
+const PlanQuerySchema = v.object({
+	project,
+	ops: v.array(EditOpSchema)
+});
+const ApplyQuerySchema = v.object({
+	project,
+	ops: v.array(EditOpSchema),
+	answers: v.optional(v.record(v.string(), v.string())),
+	force: v.optional(v.boolean())
+});
+const ExtractQuerySchema = v.object({
+	project,
+	files: v.optional(v.pipe(v.array(v.string()), v.description("Only these files (globs relative to the project root). Default: every scanned file.")))
+});
+const ExtractItemSchema = v.object({
+	path: v.string(),
+	range: textRange,
+	original: v.string(),
+	key: v.string(),
+	value: v.string(),
+	replacement: v.string(),
+	imports: v.array(v.string())
+});
+const ExtractApplySchema = v.object({
+	project,
+	items: v.pipe(v.array(ExtractItemSchema), v.description("Items from `x18n_extract_plan`, keys and replacements edited as needed; drop items to skip them."))
+});
+const OpenQuerySchema = v.object({
+	project,
+	path: v.string(),
+	line: v.number(),
+	column: v.number()
+});
+/** Agent tools only. */
+const AgentKeysSchema = v.object({
+	project,
+	glob: v.optional(text("Key glob: `*` inside a segment, `**` across segments.")),
+	missing: v.optional(text("Only keys missing or empty in this locale.")),
+	unused: v.optional(v.pipe(v.boolean(), v.description("Only keys without usages in code."))),
+	namespace: v.optional(v.string()),
+	values: v.optional(v.pipe(v.boolean(), v.description("Include the value per locale."))),
+	limit: v.optional(v.pipe(v.number(), v.description("Page size. Default 100."))),
+	cursor: v.optional(text("`nextCursor` of the previous page."))
+});
+const AgentUsagesSchema = v.object({
+	project,
+	key: v.optional(text("Only usages of this key.")),
+	path: v.optional(text("Only usages in this file (path relative to the project root).")),
+	limit: v.optional(v.pipe(v.number(), v.description("Page size. Default 100."))),
+	cursor: v.optional(text("`nextCursor` of the previous page."))
+});
+const AgentCheckSchema = v.object({
+	project,
+	only: v.optional(v.pipe(v.array(v.string()), v.description("Only these check ids, for example `placeholder-mismatch`, `invalid-syntax`, `missing-translation`."))),
+	locale: v.optional(v.pipe(v.array(v.string()), v.description("Only diagnostics for these locales."))),
+	limit: v.optional(v.pipe(v.number(), v.description("Page size. Default 100."))),
+	cursor: v.optional(text("`nextCursor` of the previous page."))
+});
+const AgentSetSchema = v.object({
+	project,
+	messages: v.pipe(v.record(v.string(), v.record(v.string(), leaf)), v.description("`{ \"<locale>\": { \"<key>\": \"<value>\" } }`, the same shape as `x18n apply`.")),
+	force: v.optional(v.pipe(v.boolean(), v.description("Write values even when their placeholders differ from the source value.")))
+});
+const confirm = v.optional(v.pipe(v.boolean(), v.description("Apply the plan. Without it, the tool only returns the plan.")));
+const answers = v.optional(v.pipe(v.record(v.string(), v.string()), v.description("Decision id to option id, for decisions in the plan. Default: each decision's `default`.")));
+const AgentRenameSchema = v.object({
+	project,
+	from: text("Key (or parent of keys) to rename."),
+	to: text("New key."),
+	usages: v.optional(v.pipe(v.boolean(), v.description("Also rewrite usages in code. Default true."))),
+	confirm,
+	answers
+});
+const AgentDeleteSchema = v.object({
+	project,
+	key: text("Key (or parent of keys) to delete."),
+	locales: v.optional(v.pipe(v.array(v.string()), v.description("Only in these locales. Default: all."))),
+	confirm,
+	answers
+});
+//#endregion
+//#region src/node/views.ts
+/** The named project, or the only one. */
+function pickProject(projects, name) {
+	const found = name === void 0 ? projects.length === 1 ? projects[0] : void 0 : projects.find((p) => p.name === name);
+	if (!found) throw new X18nError("X18N0003", name === void 0 ? `pass a project (${projects.map((p) => p.name).join(", ")})` : `"${name}" (${projects.map((p) => p.name).join(", ")})`);
+	return found;
+}
+function percent(coverage) {
+	return coverage.total === 0 ? 100 : Math.floor(coverage.translated / coverage.total * 1e3) / 10;
+}
+function summarize({ name, project }) {
+	const analysis = project.analyze();
+	const byCode = /* @__PURE__ */ new Map();
+	for (const d of analysis.diagnostics) {
+		const entry = byCode.get(d.code);
+		byCode.set(d.code, {
+			code: d.code,
+			severity: d.severity,
+			count: (entry?.count ?? 0) + 1
+		});
+	}
+	const count = (severities) => analysis.diagnostics.filter((d) => severities.includes(d.severity)).length;
+	return {
+		name,
+		sourceLocale: project.sourceLocale,
+		namespaced: project.namespaced,
+		locales: analysis.coverage.map((c) => {
+			const info = project.localeInfo(c.locale);
+			return {
+				code: c.locale,
+				displayName: info.displayName,
+				flag: info.flag,
+				total: c.total,
+				translated: c.translated,
+				missing: c.missing.length,
+				empty: c.empty.length,
+				percent: percent(c)
+			};
+		}),
+		resources: project.resources.length,
+		keys: project.keys().length,
+		usages: project.usages().length,
+		diagnostics: {
+			errors: count(["error"]),
+			warnings: count(["warning"]),
+			infos: count(["info", "hint"]),
+			byCode: [...byCode.values()].sort((a, b) => b.count - a.count || a.code.localeCompare(b.code))
+		},
+		presets: project.explain().presets.filter((p) => p.reason === "listed" || p.reason === "detected").map((p) => p.name)
+	};
+}
+function keyTable({ name, project }) {
+	const analysis = project.analyze();
+	const unused = new Set(analysis.unused);
+	const diagnostics = /* @__PURE__ */ new Map();
+	for (const d of analysis.diagnostics) if (d.key !== void 0) diagnostics.set(d.key, (diagnostics.get(d.key) ?? 0) + 1);
+	const missing = /* @__PURE__ */ new Map();
+	for (const c of analysis.coverage) for (const key of [...c.missing, ...c.empty]) {
+		const list = missing.get(key) ?? [];
+		missing.set(key, list);
+		list.push(c.locale);
+	}
+	return {
+		project: name,
+		sourceLocale: project.sourceLocale,
+		locales: project.locales,
+		rows: project.keys().map((key) => {
+			const info = project.get(key);
+			return {
+				key,
+				namespace: info?.namespace,
+				values: Object.fromEntries((info?.messages ?? []).map((m) => [m.locale, m.value])),
+				missing: missing.get(key) ?? [],
+				unused: unused.has(key),
+				diagnostics: diagnostics.get(key) ?? 0
+			};
+		})
+	};
+}
+const indexes = /* @__PURE__ */ new WeakMap();
+/** Line index of a file, rebuilt only when its text changed. */
+function lineIndex(p, path) {
+	const text = p.project.text(path) ?? "";
+	const cache = indexes.get(p) ?? /* @__PURE__ */ new Map();
+	indexes.set(p, cache);
+	const cached = cache.get(path);
+	if (cached?.text === text) return cached.index;
+	const index = createLineIndex(text);
+	cache.set(path, {
+		text,
+		index
+	});
+	return index;
+}
+function snippet(index, line, around = 2) {
+	const first = Math.max(0, line - around);
+	const last = Math.min(index.lineCount - 1, line + around);
+	return {
+		line: first + 1,
+		lines: Array.from({ length: last - first + 1 }, (_, i) => index.line(first + i))
+	};
+}
+function usageView(p, usage, possible = false) {
+	const index = lineIndex(p, usage.path);
+	const position = index.position(usage.range.start);
+	return {
+		key: usage.key,
+		raw: usage.raw,
+		path: usage.path,
+		line: position.line + 1,
+		column: position.character + 1,
+		kind: usage.kind,
+		dynamic: usage.dynamic,
+		possible,
+		snippet: snippet(index, position.line)
+	};
+}
+function usageViews(p, matches) {
+	return matches.map((m) => usageView(p, m.usage, m.possible));
+}
+function wire(p, diagnostics) {
+	return diagnostics.map((d) => toWireDiagnostic(p.name, d, (path) => p.project.text(path)));
+}
+function keyDetail(p, key) {
+	const { project } = p;
+	const info = project.get(project.parseKey(key));
+	if (!info) return null;
+	const syntaxes = project.placeholderSyntaxes;
+	return {
+		project: p.name,
+		key: info.key,
+		namespace: info.namespace,
+		messages: info.messages.map((m) => {
+			const path = project.resources.find((r) => r.id === m.resource)?.path ?? m.resource;
+			return {
+				locale: m.locale,
+				value: m.value,
+				path,
+				line: lineIndex(p, path).position(m.range?.key.start ?? 0).line + 1,
+				placeholders: typeof m.value === "string" ? syntaxes.flatMap((s) => s.find(String(m.value))).map((ph) => ({
+					text: ph.text,
+					start: ph.range.start,
+					end: ph.range.end
+				})).sort((a, b) => a.start - b.start) : []
+			};
+		}),
+		missing: info.missing,
+		usages: usageViews(p, info.usages),
+		diagnostics: wire(p, info.diagnostics)
+	};
+}
+function analysisView(p) {
+	const analysis = p.project.analyze();
+	return {
+		project: p.name,
+		diagnostics: wire(p, analysis.diagnostics),
+		unused: analysis.unused,
+		undefinedUsages: analysis.undefinedUsages.map((u) => usageView(p, u))
+	};
+}
+function explainView(p) {
+	const { root: _root, ...rest } = p.project.explain();
+	return rest;
+}
+function planView(plan, problems) {
+	return {
+		keys: plan.keys,
+		warnings: plan.warnings,
+		decisions: plan.decisions,
+		changes: plan.changes.map((c) => ({
+			type: c.type,
+			path: c.path
+		})),
+		problems
+	};
+}
+function previewOps(p, ops) {
+	return planView(p.project.plan(ops), placeholderProblems(p.project, ops));
+}
+/** Plans and applies ops; placeholder problems block the write unless `force`. */
+async function applyOps(p, ops, options = {}) {
+	const plan = p.project.plan(ops);
+	const problems = placeholderProblems(p.project, ops);
+	if (problems.length > 0 && !options.force) return {
+		...planView(plan, problems),
+		applied: false,
+		revision: p.project.revision
+	};
+	const answers = Object.fromEntries(plan.decisions.map((d) => [d.id, options.answers?.[d.id] ?? d.default]));
+	const result = await p.project.apply(plan, { answers });
+	return {
+		...planView(plan, problems),
+		applied: true,
+		revision: result.revision
+	};
+}
+//#endregion
+//#region src/node/agent.ts
+function page(items, query) {
+	const start = Number(query.cursor ?? 0) || 0;
+	const end = start + (query.limit ?? 100);
+	return {
+		total: items.length,
+		nextCursor: end < items.length ? String(end) : void 0,
+		items: items.slice(start, end)
+	};
+}
+/**
+* Registers the MCP tools (`x18n_*` on the wire). Descriptions are written for agents.
+* Tools take one flat object, validated here, so agents see named fields instead of positional args.
+*/
+function registerAgentTools(ctx, projects) {
+	function tool(id, safety, description, schema, run) {
+		ctx.agent.registerTool({
+			id: `x18n:${id}`,
+			safety,
+			description,
+			inputSchema: toJsonSchema(schema),
+			handler: (input) => run(v.parse(schema, input ?? {}))
+		});
+	}
+	const pick = (name) => pickProject(projects, name);
+	/** Plans the ops, and applies them only with `confirm`. */
+	const confirmable = (p, ops, query) => query.confirm ? applyOps(p, ops, { answers: query.answers }) : {
+		...previewOps(p, ops),
+		applied: false,
+		revision: p.project.revision
+	};
+	tool("status", "read", "Overview of the i18n project: locales with translation coverage, counts of keys, resources and usages, diagnostics by check, and detected presets. Call it first to learn project names, the source locale and locale codes.", ProjectQuerySchema, (query) => ({ projects: (query.project === void 0 ? projects : [pick(query.project)]).map(summarize) }));
+	tool("keys", "read", "List message keys, paged. Filter by `missing` locale (keys to translate), `unused` (keys no code uses), `namespace` or a key `glob`. Pass `values: true` to get the value per locale. Continue with `cursor: nextCursor`.", AgentKeysSchema, (query) => {
+		const { project } = pick(query.project);
+		const { items, ...rest } = page(project.keys({
+			glob: query.glob,
+			missing: query.missing,
+			unused: query.unused,
+			namespace: query.namespace
+		}), query);
+		return {
+			...rest,
+			keys: items.map((key) => query.values ? {
+				key,
+				values: Object.fromEntries((project.get(key)?.messages ?? []).map((m) => [m.locale, m.value]))
+			} : { key })
+		};
+	});
+	tool("get", "read", "One key: its value in every locale with file and line, locales where it is missing, usages in code with a few lines of context, and diagnostics. Check a key with it before creating or renaming one.", KeyQuerySchema, (query) => {
+		const detail = keyDetail(pick(query.project), query.key);
+		if (!detail) throw new X18nError("X18N4006", `"${query.key}"; find keys with x18n_keys`);
+		return detail;
+	});
+	tool("usages", "read", "Usages in code, paged: of one `key` (usages with a computed key under a prefix of it are marked `possible`), of one file (`path`), or all. Each usage has file, line, column and a code snippet.", AgentUsagesSchema, (query) => {
+		const p = pick(query.project);
+		const { items, ...rest } = page(p.project.usages({
+			key: query.key,
+			path: query.path
+		}), query);
+		return {
+			...rest,
+			usages: usageViews(p, items)
+		};
+	});
+	tool("check", "read", "Run the checks (missing translations, placeholder mismatches, invalid syntax, unused and undefined keys, ...) and return diagnostics, paged. After writing messages, call it with `only: [\"placeholder-mismatch\", \"invalid-syntax\"]` and fix what it reports.", AgentCheckSchema, (query) => {
+		const p = pick(query.project);
+		const diagnostics = p.project.analyze().diagnostics.filter((d) => (!query.only || query.only.includes(d.code)) && (!query.locale || d.locale !== void 0 && query.locale.includes(d.locale)));
+		const { items, ...rest } = page(diagnostics, query);
+		return {
+			...rest,
+			summary: {
+				errors: diagnostics.filter((d) => d.severity === "error").length,
+				warnings: diagnostics.filter((d) => d.severity === "warning").length
+			},
+			diagnostics: items.map((d) => toWireDiagnostic(p.name, d, (path) => p.project.text(path)))
+		};
+	});
+	tool("translate_prompt", "read", "Instructions for translating missing messages into a locale: rules, glossary, style examples and the items with usage context, as markdown. Follow it, then write the results with x18n_set_messages. It says how many items remain and the cursor for the next batch.", PromptQuerySchema, (query) => {
+		const { project, locale, ...options } = query;
+		return renderPrompt(pick(project).project.prompt("translate", locale, options));
+	});
+	tool("set_messages", "action", "Set many messages at once: `messages` is `{ \"<locale>\": { \"<key>\": \"<value>\" } }`, the same shape as `x18n apply`. Files keep their format, key style and order. When a value drops or adds placeholders compared to the source value, nothing is written and `problems` lists them (`applied: false`); fix the values, or pass `force: true`.", AgentSetSchema, (query) => {
+		const p = pick(query.project);
+		return applyOps(p, parseMessageBatch(p.project, query.messages), { force: query.force });
+	});
+	tool("rename_key", "destructive", "Rename a key (or every key under a parent) in all locales, and its usages in code unless `usages: false`. Without `confirm` it returns the plan (files to change, decisions, warnings); call again with `confirm: true` to apply it.", AgentRenameSchema, (query) => {
+		const p = pick(query.project);
+		return confirmable(p, [{
+			type: "rename",
+			from: p.project.parseKey(query.from),
+			to: p.project.parseKey(query.to),
+			usages: query.usages !== false
+		}], query);
+	});
+	tool("delete_key", "destructive", "Delete a key (or every key under a parent) in all locales, or only in `locales`. Code is not changed. Without `confirm` it returns the plan; call again with `confirm: true` to apply it.", AgentDeleteSchema, (query) => {
+		const p = pick(query.project);
+		return confirmable(p, [{
+			type: "delete",
+			key: p.project.parseKey(query.key),
+			locales: query.locales ?? "all"
+		}], query);
+	});
+	tool("extract_plan", "read", "Find hard-coded strings in source files and propose a key, a message and a code replacement for each. Review the items (edit keys, drop items you do not want), then pass them to x18n_extract_apply.", ExtractQuerySchema, (query) => {
+		const { project } = pick(query.project);
+		return toPlanFile(project, findCandidates(project, { files: query.files }));
+	});
+	tool("extract_apply", "action", "Apply extraction items from x18n_extract_plan: adds the messages to the source locale and rewrites the code. Fails when a file changed since the plan was made; plan again then.", ExtractApplySchema, (query) => {
+		const p = pick(query.project);
+		return applyOps(p, [{
+			type: "extract",
+			items: extractItems(p.project, query.items)
+		}]);
+	});
+}
+//#endregion
+//#region src/node/rpc.ts
+/** Registers the `x18n:*` functions the SPA calls. Queries dump one record per project (and per key) for the static build. */
+function registerRpc(ctx, projects, options) {
+	const rpc = ctx.scope("x18n").rpc;
+	const perProject = () => projects.map((p) => [{ project: p.name }]);
+	rpc.register(defineRpcFunction({
+		name: "project",
+		type: "static",
+		jsonSerializable: true,
+		handler: () => ({
+			projects: projects.map(summarize),
+			openInEditor: options.openInEditor !== void 0
+		})
+	}));
+	rpc.register(defineRpcFunction({
+		name: "keys",
+		type: "query",
+		jsonSerializable: true,
+		handler: (query) => keyTable(pickProject(projects, v.parse(ProjectQuerySchema, query).project)),
+		dump: () => ({ inputs: perProject() })
+	}));
+	rpc.register(defineRpcFunction({
+		name: "key",
+		type: "query",
+		jsonSerializable: true,
+		handler: (query) => {
+			const { project, key } = v.parse(KeyQuerySchema, query);
+			return keyDetail(pickProject(projects, project), key);
+		},
+		dump: () => ({
+			inputs: projects.flatMap((p) => p.project.keys().map((key) => [{
+				project: p.name,
+				key
+			}])),
+			fallback: null
+		})
+	}));
+	rpc.register(defineRpcFunction({
+		name: "usages",
+		type: "query",
+		jsonSerializable: true,
+		handler: (query) => {
+			const { project, key, path } = v.parse(UsageQuerySchema, query);
+			const p = pickProject(projects, project);
+			return usageViews(p, p.project.usages({
+				key,
+				path
+			}));
+		},
+		dump: () => ({ inputs: perProject() })
+	}));
+	rpc.register(defineRpcFunction({
+		name: "analysis",
+		type: "query",
+		jsonSerializable: true,
+		handler: (query) => analysisView(pickProject(projects, v.parse(ProjectQuerySchema, query).project)),
+		dump: () => ({ inputs: perProject() })
+	}));
+	rpc.register(defineRpcFunction({
+		name: "explain",
+		type: "static",
+		jsonSerializable: true,
+		handler: () => ({ projects: projects.map(explainView) })
+	}));
+	rpc.register(defineRpcFunction({
+		name: "translate-prompt",
+		type: "query",
+		jsonSerializable: true,
+		handler: (query) => {
+			const { project, locale, ...options } = v.parse(PromptQuerySchema, query);
+			return renderPrompt(pickProject(projects, project).project.prompt("translate", locale, options));
+		}
+	}));
+	rpc.register(defineRpcFunction({
+		name: "extract-candidates",
+		type: "query",
+		jsonSerializable: true,
+		handler: (query) => {
+			const { project, files } = v.parse(ExtractQuerySchema, query);
+			return findCandidates(pickProject(projects, project).project, { files });
+		},
+		dump: () => ({ inputs: perProject() })
+	}));
+	if (ctx.mode !== "dev") return;
+	rpc.register(defineRpcFunction({
+		name: "plan",
+		type: "action",
+		jsonSerializable: true,
+		handler: (query) => {
+			const { project, ops } = v.parse(PlanQuerySchema, query);
+			return previewOps(pickProject(projects, project), ops);
+		}
+	}));
+	rpc.register(defineRpcFunction({
+		name: "apply",
+		type: "action",
+		jsonSerializable: true,
+		handler: (query) => {
+			const { project, ops, answers, force } = v.parse(ApplyQuerySchema, query);
+			return applyOps(pickProject(projects, project), ops, {
+				answers,
+				force
+			});
+		}
+	}));
+	rpc.register(defineRpcFunction({
+		name: "extract-apply",
+		type: "action",
+		jsonSerializable: true,
+		handler: (query) => {
+			const { project, items } = v.parse(ExtractApplySchema, query);
+			const p = pickProject(projects, project);
+			return applyOps(p, [{
+				type: "extract",
+				items: extractItems(p.project, items)
+			}]);
+		}
+	}));
+	const open = options.openInEditor;
+	if (open) rpc.register(defineRpcFunction({
+		name: "open-in-editor",
+		type: "action",
+		jsonSerializable: true,
+		handler: (query) => {
+			const { project, ...location } = v.parse(OpenQuerySchema, query);
+			return open({
+				project: pickProject(projects, project),
+				...location
+			});
+		}
+	}));
+}
+//#endregion
+//#region src/node/index.ts
+/** The x18n UI, RPC functions and MCP tools over loaded projects, as a devframe definition. */
+function createX18nDevframe(projects, options = {}) {
+	return defineDevframe({
+		id: "x18n",
+		name: "x18n",
+		version,
+		packageName: name,
+		homepage,
+		description,
+		icon: "ph:translate-duotone",
+		importMetaUrl: import.meta.url,
+		clientAssets: fileURLToPath(new URL("./public", import.meta.url)),
+		async setup(ctx) {
+			registerRpc(ctx, projects, options);
+			if (ctx.mode !== "dev") return;
+			registerAgentTools(ctx, projects);
+			const state = await ctx.scope("x18n").rpc.sharedState("state", { initialValue: {
+				revision: 0,
+				changedKeys: []
+			} });
+			for (const p of projects) p.project.onChange((change) => {
+				state.mutate((draft) => {
+					draft.revision += 1;
+					draft.changedKeys = [...change.keys];
+				});
+			});
+		}
+	});
+}
+//#endregion
+export { createX18nDevframe };

package/dist/nitro.json

@@ -0,0 +1,15 @@
+{
+  "date": "2026-10-20T04:20:18.413Z",
+  "preset": "static",
+  "framework": {
+    "name": "nuxt",
+    "version": "4.6.1"
+  },
+  "versions": {
+    "nitro": "2.13.4"
+  },
+  "commands": {
+    "preview": "npx serve public"
+  },
+  "config": {}
+}

package/dist/public/200.html

@@ -0,0 +1 @@
+<!DOCTYPE html><html><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>x18n</title><script type="importmap">{"imports":{"#entry":"/_nuxt/DCQwHjae.js"}}</script><script>{const p=new URLSearchParams(location.hash.slice(1)),c=p.get('devframe_otp');if(c){sessionStorage.setItem('x18n:otp',c);history.replaceState(null,'',location.pathname+location.search+'#'+(p.get('route')||'/'))}}</script><link rel="stylesheet" href="/_nuxt/entry.puki6KUo.css" crossorigin><link rel="modulepreload" as="script" crossorigin href="/_nuxt/DCQwHjae.js"><link rel="modulepreload" as="script" crossorigin href="/_nuxt/2T7o9vZw.js"><link rel="modulepreload" as="script" crossorigin href="/_nuxt/6U3VBVNw.js"><link rel="modulepreload" as="script" crossorigin href="/_nuxt/qB8tKtt1.js"><link rel="modulepreload" as="script" crossorigin href="/_nuxt/B3c8VNtz.js"><script type="module" src="/_nuxt/DCQwHjae.js" crossorigin></script><link rel="prefetch" as="script" crossorigin href="/_nuxt/B2lY2QM5.js"><link rel="prefetch" as="style" crossorigin href="/_nuxt/error-404.BJfOvlY_.css"><link rel="prefetch" as="script" crossorigin href="/_nuxt/D6gh7el6.js"><link rel="prefetch" as="script" crossorigin href="/_nuxt/xg14vwJh.js"><link rel="prefetch" as="style" crossorigin href="/_nuxt/error-500.DRhgjSut.css"><link rel="prefetch" as="script" crossorigin href="/_nuxt/CKRUbA4H.js"></head><body><div id="__nuxt"></div><div id="teleports"></div><script>window.__NUXT__={};window.__NUXT__.config={public:{},app:{baseURL:"/",buildId:"45c30525-030d-44d4-bb10-65a4ca3668c9",buildAssetsDir:"/_nuxt/",cdnURL:""}}</script><script type="application/json" data-nuxt-data="nuxt-app" data-ssr="false" id="__NUXT_DATA__">[{"prerenderedAt":1,"serverRendered":2},1792470018315,false]</script></body></html>

package/dist/public/404.html

@@ -0,0 +1 @@
+<!DOCTYPE html><html><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>x18n</title><script type="importmap">{"imports":{"#entry":"/_nuxt/DCQwHjae.js"}}</script><script>{const p=new URLSearchParams(location.hash.slice(1)),c=p.get('devframe_otp');if(c){sessionStorage.setItem('x18n:otp',c);history.replaceState(null,'',location.pathname+location.search+'#'+(p.get('route')||'/'))}}</script><link rel="stylesheet" href="/_nuxt/entry.puki6KUo.css" crossorigin><link rel="modulepreload" as="script" crossorigin href="/_nuxt/DCQwHjae.js"><link rel="modulepreload" as="script" crossorigin href="/_nuxt/2T7o9vZw.js"><link rel="modulepreload" as="script" crossorigin href="/_nuxt/6U3VBVNw.js"><link rel="modulepreload" as="script" crossorigin href="/_nuxt/qB8tKtt1.js"><link rel="modulepreload" as="script" crossorigin href="/_nuxt/B3c8VNtz.js"><script type="module" src="/_nuxt/DCQwHjae.js" crossorigin></script><link rel="prefetch" as="script" crossorigin href="/_nuxt/B2lY2QM5.js"><link rel="prefetch" as="style" crossorigin href="/_nuxt/error-404.BJfOvlY_.css"><link rel="prefetch" as="script" crossorigin href="/_nuxt/D6gh7el6.js"><link rel="prefetch" as="script" crossorigin href="/_nuxt/xg14vwJh.js"><link rel="prefetch" as="style" crossorigin href="/_nuxt/error-500.DRhgjSut.css"><link rel="prefetch" as="script" crossorigin href="/_nuxt/CKRUbA4H.js"></head><body><div id="__nuxt"></div><div id="teleports"></div><script>window.__NUXT__={};window.__NUXT__.config={public:{},app:{baseURL:"/",buildId:"45c30525-030d-44d4-bb10-65a4ca3668c9",buildAssetsDir:"/_nuxt/",cdnURL:""}}</script><script type="application/json" data-nuxt-data="nuxt-app" data-ssr="false" id="__NUXT_DATA__">[{"prerenderedAt":1,"serverRendered":2},1792470018316,false]</script></body></html>

package/dist/public/_nuxt/2T7o9vZw.js

@@ -0,0 +1 @@
+import{H as e,J as t,K as n,V as r,v as i,x as a}from"./6U3VBVNw.js";function o(e,...t){return typeof e==`function`?e(...t):e}var s=Error.captureStackTrace,c=class e extends Error{name;code;docs;fix;sources;data;get why(){return this.message}constructor(t,n=e){super(t.why,{cause:t.cause}),this.code=this.name=t.code,this.fix=t.fix,this.docs=t.docs,this.sources=t.sources,this.data=t.data,s?.(this,n)}toJSON(){return{name:this.name,why:this.why,fix:this.fix,docs:this.docs,sources:this.sources,cause:this.cause,data:this.data,stack:this.stack}}};function l(e,t){return typeof e==`string`?`${e}/${t.toLowerCase()}`:e?.(t)}function u(e){let t=e.reporters??[],n={},{docsBase:r}=e;for(let i of Object.keys(e.codes)){let a=e.codes[i],s=a.docs===!1?void 0:a.docs||l(r,i),u=(e={},n={})=>{let r=new c({code:i,why:o(a.why,e),fix:o(a.fix,e),docs:s,cause:e.cause,sources:e.sources,data:o(a.data,e)},u);for(let e of t)e(r,n);return r};n[i]=u}return n}function d(e={}){let{docsBase:t,reporters:n=[]}=e;return new Proxy({},{get(e,r){if(typeof r!=`string`)return;let i=(e={},a={})=>{let o=l(t,r),s=new c({code:r,why:o??``,docs:o,cause:e.cause,sources:e.sources},i);for(let e of n)e(s,a);return s};return i}})}function f(e){return`https://nuxt.com/docs/4.x/errors/${e.replace(`NUXT_`,``).toLowerCase()}`}var p=[e=>{console.error(`[${e.name}]`)}],m=d({docsBase:f,reporters:p}),h=globalThis.__nuxt_app_ctx__||={};function g(e){return h[e]||=(()=>{let e;return{use:()=>{if(e===void 0)throw Error(`Context is not available`);return e},tryUse:()=>e??null,set:t=>{e=t},unset:()=>{e=void 0},call:(t,n)=>(e=t,n()),callAsync:(t,n)=>(e=t,Promise.resolve(n()))}})()}function _(e,t){return g(e)}function v(e,t={},n){for(let r in e){let i=e[r],a=n?`${n}:${r}`:r;typeof i==`object`&&i?v(i,t,a):typeof i==`function`&&(t[a]=i)}return t}var y=(()=>{if(console.createTask)return console.createTask;let e={run:e=>e()};return()=>e})();function b(e,t,n,r){for(let i=n;i<e.length;i+=1)try{let n=r?r.run(()=>e[i](...t)):e[i](...t);if(n&&typeof n.then==`function`)return Promise.resolve(n).then(()=>b(e,t,i+1,r))}catch(e){return Promise.reject(e)}}function x(e,t,n){if(e.length>0)return b(e,t,0,y(n))}function S(e,t,n){if(e.length>0){let r=y(n);return Promise.all(e.map(e=>r.run(()=>e(...t))))}}function C(e,t){for(let n of[...e])n(t)}var w=class{_hooks;_before;_after;_deprecatedHooks;_deprecatedMessages;constructor(){this._hooks={},this._before=void 0,this._after=void 0,this._deprecatedMessages=void 0,this._deprecatedHooks={},this.hook=this.hook.bind(this),this.callHook=this.callHook.bind(this),this.callHookWith=this.callHookWith.bind(this)}hook(e,t,n={}){if(!e||typeof t!=`function`)return()=>{};let r=e,i;for(;this._deprecatedHooks[e];)i=this._deprecatedHooks[e],e=i.to;if(i&&!n.allowDeprecated){let e=i.message;e||=`${r} hook has been deprecated`+(i.to?`, please use ${i.to}`:``),this._deprecatedMessages||=new Set,this._deprecatedMessages.has(e)||(console.warn(e),this._deprecatedMessages.add(e))}if(!t.name)try{Object.defineProperty(t,"name",{get:()=>`_`+e.replace(/\W+/g,`_`)+`_hook_cb`,configurable:!0})}catch{}return this._hooks[e]=this._hooks[e]||[],this._hooks[e].push(t),()=>{t&&=(this.removeHook(e,t),void 0)}}hookOnce(e,t){let n,r=(...e)=>(typeof n==`function`&&n(),n=void 0,r=void 0,t(...e));return n=this.hook(e,r),n}removeHook(e,t){let n=this._hooks[e];if(n){let r=n.indexOf(t);r!==-1&&n.splice(r,1),n.length===0&&(this._hooks[e]=void 0)}}clearHook(e){this._hooks[e]=void 0}deprecateHook(e,t){this._deprecatedHooks[e]=typeof t==`string`?{to:t}:t;let n=this._hooks[e]||[];this._hooks[e]=void 0;for(let t of n)this.hook(e,t)}deprecateHooks(e){for(let t in e)this.deprecateHook(t,e[t])}addHooks(e){let t=v(e),n=Object.keys(t).map(e=>this.hook(e,t[e]));return()=>{for(let e of n)e();n.length=0}}removeHooks(e){let t=v(e);for(let e in t)this.removeHook(e,t[e])}removeAllHooks(){this._hooks={}}callHook(e,...t){return this.callHookWith(x,e,t)}callHookParallel(e,...t){return this.callHookWith(S,e,t)}callHookWith(e,t,n){let r=this._before||this._after?{name:t,args:n,context:{}}:void 0;this._before&&C(this._before,r);let i=e(this._hooks[t]?[...this._hooks[t]]:[],n,t);return i instanceof Promise?i.finally(()=>{this._after&&r&&C(this._after,r)}):(this._after&&r&&C(this._after,r),i)}beforeEach(e){return this._before=this._before||[],this._before.push(e),()=>{if(this._before!==void 0){let t=this._before.indexOf(e);t!==-1&&this._before.splice(t,1)}}}afterEach(e){return this._after=this._after||[],this._after.push(e),()=>{if(this._after!==void 0){let t=this._after.indexOf(e);t!==-1&&this._after.splice(t,1)}}}};function T(){return new w}var E=class{_hooks;constructor(){this._hooks={}}hook(e,t){return!e||typeof t!=`function`?()=>{}:(this._hooks[e]=this._hooks[e]||[],this._hooks[e].push(t),()=>{t&&=(this.removeHook(e,t),void 0)})}removeHook(e,t){let n=this._hooks[e];if(n){let r=n.indexOf(t);r!==-1&&n.splice(r,1),n.length===0&&(this._hooks[e]=void 0)}}callHook(e,...t){let n=this._hooks[e];if(n&&n.length!==0)return b(n.slice(),t,0)}},D={meta:[{name:`viewport`,content:`width=device-width,initial-scale=1`},{charset:`utf-8`}],link:[],style:[],script:[{innerHTML:`{const p=new URLSearchParams(location.hash.slice(1)),c=p.get('devframe_otp');if(c){sessionStorage.setItem('x18n:otp',c);history.replaceState(null,'',location.pathname+location.search+'#'+(p.get('route')||'/'))}}`}],noscript:[],title:`x18n`,viewport:`width=device-width,initial-scale=1`},O={id:`__nuxt-loader`},k={componentName:`NuxtLink`,prefetch:!0,prefetchOn:{visibility:!0}},A=`#__nuxt`,j=`nuxt-app`,M=36e5,N=`vite:preloadError`;function P(e=`nuxt-app`){return _(e,{asyncContext:!1})}var F=`__nuxt_plugin`;function I(i){let a=0,o={_id:i.id||`nuxt-app`,_scope:r(),provide:void 0,versions:{get nuxt(){return`4.6.1`},get vue(){return o.vueApp.version}},payload:t({...i.ssrContext?.payload||{},data:t({}),state:n({}),once:new Set,_errors:t({})}),static:{data:{}},runWithContext(t){return o._scope.active&&!e()?o._scope.run(()=>B(o,t)):B(o,t)},isHydrating:!0,deferHydration(){if(!o.isHydrating)return()=>{};a++;let e=!1;return()=>{if(!e&&(e=!0,a--,a===0))return o.isHydrating=!1,o.callHook(`app:suspense:resolve`)}},_asyncDataPromises:{},_asyncData:t({}),_state:t({}),_payloadRevivers:{},...i};{let e=window.__NUXT__;if(e)for(let t in e)switch(t){case`data`:case`state`:case`_errors`:Object.assign(o.payload[t],e[t]);break;default:o.payload[t]=e[t]}}o.hooks=T(),o.hook=o.hooks.hook;{let e=o.hooks.callHook;o.hooks.callHook=(t,...n)=>Promise.resolve().then(()=>e(t,...n))}o.callHook=o.hooks.callHook,o.provide=(e,t)=>{let n=`$`+e;W(o,n,t),W(o.vueApp.config.globalProperties,n,t)},W(o.vueApp,`$nuxt`,o),W(o.vueApp.config.globalProperties,`$nuxt`,o);{window.addEventListener(N,e=>{o.callHook(`app:chunkError`,{error:e.payload}),e.payload?.message?.includes(`Unable to preload CSS`)&&e.preventDefault()}),window.useNuxtApp||=H;let e=o.hook(`app:error`,(...e)=>{m.NUXT_E1005({cause:e.length>1?e:e[0]})});o.hook(`app:mounted`,e)}let s=o.payload.config;return o.provide(`config`,s),o}async function L(e,t){if(typeof t==`function`){let{provide:n}=await e.runWithContext(()=>t(e))||{};if(n&&typeof n==`object`)for(let t in n)e.provide(t,n[t])}}async function R(e,t){let n;for(let r of t)try{await L(e,r)}catch(t){if(!e.payload.error)throw t;n||=t}if(n)throw e.payload.error||n}function z(e){if(typeof e==`function`)return e;let t=e._name||e.name;return delete e.name,Object.assign(e.setup||(()=>{}),e,{[F]:!0,_name:t})}function B(e,t,n){return P(e._id).set(e),e.vueApp.runWithContext(()=>n?t(...n):t())}function V(e){let t;return a()&&(t=i()?.appContext.app.$nuxt),t||=P(e).tryUse(),t||null}function H(e){let t=V(e);if(!t)throw m.NUXT_E1001();return t}function U(e){return H().$config}function W(e,t,n){Object.defineProperty(e,t,{get:()=>n})}export{u as _,H as a,j as c,M as d,A as f,p as g,f as h,V as i,O as l,m,I as n,U as o,E as p,z as r,D as s,R as t,k as u,d as v};