paintress 0.5.2 → 0.6.0

package/dist/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { a as attachPersistent, c as lockPath, d as safeJoin, f as sanitizeProjectName, h as encodeLine, i as TOOLS, l as pidPath, m as LineDecoder, n as runStdioServer, o as isDaemonRunning, p as socketPath, s as sendRequest, u as resolveProjectDir } from "./server-ssrAxbTR.js";
-import { T as loadDoc, qt as VERSION, t as renderDocument } from "./render-CCxYNL6A.js";
+import { C as isPresetType, D as presetPathFor, E as notePathFor, O as readTextIfExists, S as findNodeIn, T as listPresets, _ as LineDecoder, a as ensureDaemon, b as componentsPathFor, c as isDaemonRunning, d as lockPath, f as pidPath, g as socketPath, h as sanitizeProjectName, k as setPreset, l as queryDaemon, m as safeJoin, n as runStdioServer, o as reuseDaemon, p as resolveProjectDir, r as TOOLS, s as attachPersistent, u as sendRequest, v as encodeLine, w as listComponents, x as ensureProjectScaffold, y as applyProjectPresets } from "./server-DZRNNWac.js";
+import { T as loadDoc, qt as VERSION, t as renderDocument } from "./render-BSf62388.js";
 import "./index.js";
 import { chmodSync, closeSync, copyFileSync, existsSync, mkdirSync, openSync, readFileSync, readdirSync, realpathSync, renameSync, statSync, unlinkSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
@@ -92,7 +92,9 @@ var Registry = class {
 				if (st.isDirectory()) {
 					if (skip.has(name)) continue;
 					walk(abs, relPath, depth + 1);
-				} else if (DESIGN_EXT.has(extname(name).toLowerCase())) out.push(relPath);
+				} else if (DESIGN_EXT.has(extname(name).toLowerCase())) {
+					if (!name.startsWith("__")) out.push(relPath);
+				}
 			}
 		};
 		walk(entry.rootReal, "", 0);
@@ -272,6 +274,9 @@ var WatchManager = class {
 			watcher.on("change", () => {
 				for (const cb of created.listeners) cb(absPath);
 			});
+			watcher.on("add", () => {
+				for (const cb of created.listeners) cb(absPath);
+			});
 			watcher.on("unlink", () => {
 				for (const cb of created.listeners) cb(absPath);
 			});
@@ -476,7 +481,7 @@ function acquireLock() {
 		} catch {
 			holder = 0;
 		}
-		if (isAlive(holder)) throw new Error(`paintress web 已在运行（pid ${holder}）。如需重启请先 paintress web --stop`);
+		if (isAlive(holder)) throw new Error(`paintress web 已在运行（pid ${holder}）。如需重启请先 paintress stop`);
 		try {
 			unlinkSync(p);
 		} catch {}
@@ -539,6 +544,8 @@ async function startDaemon(opts = {}) {
 	const idleCheckMs = opts.idleCheckMs ?? 2e3;
 	let idleSince = null;
 	let closing = false;
+	/** 进行中的关停 Promise：close() 必须等它，不能立刻返回 */
+	let closingPromise = null;
 	/** 最近一次 HTTP 活动：用来判定「浏览器还在不在」而不单靠 SSE 关闭事件 */
 	let lastHttpAt = Date.now();
 	/**
@@ -662,6 +669,7 @@ async function startDaemon(opts = {}) {
 								ok: true,
 								pong: true,
 								pid: process.pid,
+								port,
 								uptimeMs: Date.now() - startedAt,
 								projects: registry.all().length
 							});
@@ -680,6 +688,12 @@ async function startDaemon(opts = {}) {
 							const entry = registry.watch(req.project, req.dir, req.depth, req.owner === "agent" ? { owner: "agent" } : {});
 							cancelAutoDetach(entry.name);
 							watchers.watchDesigns(entry.rootReal, entry.depth, scheduleRegistryNotify);
+							try {
+								const created = ensureProjectScaffold(entry.rootReal).created;
+								if (created.length > 0 && !opts.quiet) process.stderr.write(`paintress web: 项目 ${entry.name} 初始化 ${created.map((f) => relative(entry.rootReal, f)).join("、")}\n`);
+							} catch (cause) {
+								process.stderr.write(`paintress web: 项目脚手架创建失败（${cause instanceof Error ? cause.message : String(cause)}）\n`);
+							}
 							reply({
 								ok: true,
 								watched: true,
@@ -958,6 +972,190 @@ async function startDaemon(opts = {}) {
 					});
 					return;
 				}
+				if (segments[1] === "notes" && req.method === "GET") {
+					const name = url.searchParams.get("project") ?? "";
+					const relPath = url.searchParams.get("path") ?? "";
+					const entry = registry.get(name);
+					if (!entry) {
+						sendJson(404, {
+							ok: false,
+							error: `未注册的项目：${name}`
+						});
+						return;
+					}
+					const abs = safeJoin(entry.rootReal, relPath);
+					const noteAbs = abs === null ? null : notePathFor(abs);
+					if (abs === null || noteAbs === null) {
+						sendJson(404, {
+							ok: false,
+							error: "文件不存在"
+						});
+						return;
+					}
+					let markdown;
+					try {
+						markdown = readTextIfExists(noteAbs);
+					} catch (cause) {
+						sendJson(413, {
+							ok: false,
+							error: cause instanceof Error ? cause.message : String(cause)
+						});
+						return;
+					}
+					if (markdown === null) {
+						sendJson(200, {
+							ok: true,
+							exists: false
+						});
+						return;
+					}
+					sendJson(200, {
+						ok: true,
+						exists: true,
+						path: relative(entry.rootReal, noteAbs).split(sep).join("/"),
+						markdown
+					});
+					return;
+				}
+				if (segments[1] === "presets") {
+					const qProject = url.searchParams.get("project") ?? "";
+					if (req.method === "GET") {
+						const entry = registry.get(qProject);
+						if (!entry) {
+							sendJson(404, {
+								ok: false,
+								error: `未注册的项目：${qProject}`
+							});
+							return;
+						}
+						const { path, items } = listPresets(entry.rootReal);
+						sendJson(200, {
+							ok: true,
+							path,
+							items
+						});
+						return;
+					}
+					if (req.method === "PUT" || req.method === "POST") {
+						if (!isTrustedWrite(req)) {
+							sendJson(403, {
+								ok: false,
+								error: "缺少 x-paintress 头"
+							});
+							return;
+						}
+						const raw = await readBody();
+						let body;
+						try {
+							body = JSON.parse(raw);
+						} catch {
+							sendJson(400, {
+								ok: false,
+								error: "请求体不是合法 JSON"
+							});
+							return;
+						}
+						const name = qProject !== "" ? qProject : typeof body["project"] === "string" ? body["project"] : "";
+						const entry = registry.get(name);
+						if (!entry) {
+							sendJson(404, {
+								ok: false,
+								error: `未注册的项目：${name}`
+							});
+							return;
+						}
+						const key = typeof body["key"] === "string" ? body["key"] : "";
+						const value = body["value"];
+						if (key === "" || typeof value !== "string" && typeof value !== "number") {
+							sendJson(400, {
+								ok: false,
+								error: "缺少 key 或 value"
+							});
+							return;
+						}
+						const existing = listPresets(entry.rootReal).items.find((p) => p.key === key);
+						const typeRaw = body["type"] ?? existing?.type;
+						if (!isPresetType(typeRaw)) {
+							sendJson(400, {
+								ok: false,
+								error: "type 必须是 color 或 radius"
+							});
+							return;
+						}
+						const label = typeof body["name"] === "string" && body["name"] !== "" ? body["name"] : void 0;
+						try {
+							const items = setPreset(entry.rootReal, {
+								key,
+								type: typeRaw,
+								value: String(value),
+								...label !== void 0 ? { name: label } : {}
+							});
+							notifyRegistry();
+							sendJson(200, {
+								ok: true,
+								path: presetPathFor(entry.rootReal),
+								items
+							});
+						} catch (cause) {
+							sendJson(400, {
+								ok: false,
+								error: cause instanceof Error ? cause.message : String(cause)
+							});
+						}
+						return;
+					}
+					sendJson(405, {
+						ok: false,
+						error: `不支持的方法：${req.method ?? "?"}`
+					});
+					return;
+				}
+				if (segments[1] === "components" && req.method === "GET") {
+					const name = url.searchParams.get("project") ?? "";
+					const entry = registry.get(name);
+					if (!entry) {
+						sendJson(404, {
+							ok: false,
+							error: `未注册的项目：${name}`
+						});
+						return;
+					}
+					const compPath = componentsPathFor(entry.rootReal);
+					if (compPath === null) {
+						sendJson(200, {
+							ok: true,
+							path: null,
+							items: []
+						});
+						return;
+					}
+					const doc = applyProjectPresets(loadDoc(compPath).doc, compPath).doc;
+					sendJson(200, {
+						ok: true,
+						path: compPath,
+						items: listComponents(compPath).map((c) => {
+							const node = findNodeIn(doc.children, c.id);
+							if (node === null) return c;
+							try {
+								const single = renderDocument({
+									...doc,
+									children: [node]
+								}, {
+									title: c.id,
+									transparent: true
+								});
+								return {
+									...c,
+									width: Math.round(single.canvas.width),
+									height: Math.round(single.canvas.height)
+								};
+							} catch {
+								return c;
+							}
+						})
+					});
+					return;
+				}
 				sendJson(404, {
 					ok: false,
 					error: `未知 API：${url.pathname}`
@@ -1001,16 +1199,20 @@ async function startDaemon(opts = {}) {
 				const token = Symbol("browser");
 				entry.browsers.add(token);
 				cancelAutoDetach(entry.name);
-				const release = watchers.acquire(abs, () => {
+				const notifyChange = () => {
 					res.write(`event: change\ndata: ${JSON.stringify({
 						path: relPath,
 						at: Date.now()
 					})}\n\n`);
-				});
+				};
+				const releases = [watchers.acquire(abs, notifyChange)];
+				releases.push(watchers.acquire(abs.replace(/\.(ptr|pen)$/i, ".md"), notifyChange));
+				const presetAbs = presetPathFor(entry.rootReal);
+				if (presetAbs !== null) releases.push(watchers.acquire(presetAbs, notifyChange));
 				const keepAlive = setInterval(() => res.write(": ping\n\n"), 2e4);
 				const done = () => {
 					clearInterval(keepAlive);
-					release();
+					for (const release of releases) release();
 					entry.browsers.delete(token);
 					maybeScheduleAutoDetach(entry.name);
 				};
@@ -1032,7 +1234,7 @@ async function startDaemon(opts = {}) {
 					return;
 				}
 				const loaded = loadDoc(abs);
-				const rendered = renderDocument(loaded.doc, { title: relPath });
+				const rendered = renderDocument(applyProjectPresets(loaded.doc, abs).doc, { title: relPath });
 				const dir = relPath.includes("/") ? relPath.slice(0, relPath.lastIndexOf("/") + 1) : "";
 				const baseHref = `/files/${entry.name.split("/").map(encodeURIComponent).join("/")}/${dir.split("/").filter((s) => s !== "").map(encodeURIComponent).join("/")}${dir ? "/" : ""}`;
 				let html = rendered.html.replace("<head>", `<head>\n<base href="${baseHref}">`);
@@ -1043,6 +1245,34 @@ async function startDaemon(opts = {}) {
 				send(200, html);
 				return;
 			}
+			if (segments[0] === "render-component") {
+				const project = url.searchParams.get("project") ?? "";
+				const id = url.searchParams.get("id") ?? "";
+				const entry = registry.get(project);
+				if (!entry) {
+					send(404, "project not found", "text/plain; charset=utf-8");
+					return;
+				}
+				const compPath = componentsPathFor(entry.rootReal);
+				if (compPath === null || id === "") {
+					send(404, "component not found", "text/plain; charset=utf-8");
+					return;
+				}
+				const doc = applyProjectPresets(loadDoc(compPath).doc, compPath).doc;
+				const node = findNodeIn(doc.children, id);
+				if (node === null) {
+					send(404, "component not found", "text/plain; charset=utf-8");
+					return;
+				}
+				send(200, renderDocument({
+					...doc,
+					children: [node]
+				}, {
+					title: id,
+					transparent: true
+				}).html);
+				return;
+			}
 			if (segments[0] === "files" && segments.length >= 3) {
 				const hit = resolveProjectPrefix(registry, segments.slice(1));
 				if (hit === null) {
@@ -1171,30 +1401,39 @@ async function startDaemon(opts = {}) {
 		changes.prune();
 	}, idleCheckMs);
 	idleTimer.unref();
-	async function shutdown(reason) {
-		if (closing) return;
+	/**
+	* 关停：幂等且**可等待**。
+	* 已经在关停中时必须返回同一个 Promise —— 否则 `close()` 会立刻 resolve，
+	* 调用方以为锁已释放，紧接着 `startDaemon` 就撞上「已在运行」。
+	* （v0.6.0 的 release 测试里就是这么连环挂的：idle 关停还在飞，close() 先返回了。）
+	*/
+	function shutdown(reason) {
+		if (closingPromise !== null) return closingPromise;
 		closing = true;
-		if (!opts.quiet) process.stderr.write(`paintress web: 退出（${reason}）\n`);
-		clearInterval(idleTimer);
-		if (registryTimer !== null) clearTimeout(registryTimer);
-		for (const timer of autoDetachTimers.values()) clearTimeout(timer);
-		autoDetachTimers.clear();
-		for (const client of registryClients) try {
-			client.write(`event: shutdown\ndata: ${JSON.stringify({
-				reason,
-				at: Date.now()
-			})}\n\n`);
-			client.end();
-		} catch {}
-		registryClients.clear();
-		for (const client of controlClients) client.end();
-		controlClients.clear();
-		await watchers.closeAll();
-		await new Promise((resolve) => sockServer.close(() => resolve()));
-		const httpClosed = new Promise((resolve) => httpServer.close(() => resolve()));
-		httpServer.closeAllConnections();
-		await httpClosed;
-		releaseLock();
+		closingPromise = (async () => {
+			if (!opts.quiet) process.stderr.write(`paintress web: 退出（${reason}）\n`);
+			clearInterval(idleTimer);
+			if (registryTimer !== null) clearTimeout(registryTimer);
+			for (const timer of autoDetachTimers.values()) clearTimeout(timer);
+			autoDetachTimers.clear();
+			for (const client of registryClients) try {
+				client.write(`event: shutdown\ndata: ${JSON.stringify({
+					reason,
+					at: Date.now()
+				})}\n\n`);
+				client.end();
+			} catch {}
+			registryClients.clear();
+			for (const client of controlClients) client.end();
+			controlClients.clear();
+			await watchers.closeAll();
+			await new Promise((resolve) => sockServer.close(() => resolve()));
+			const httpClosed = new Promise((resolve) => httpServer.close(() => resolve()));
+			httpServer.closeAllConnections();
+			await httpClosed;
+			releaseLock();
+		})();
+		return closingPromise;
 	}
 	return {
 		port,
@@ -1514,6 +1753,7 @@ const FLAG_KEYS = /* @__PURE__ */ new Set([
 	"gap",
 	"force",
 	"board",
+	"parent",
 	NO_OPEN_FLAG
 ]);
 const BOOLEAN_FLAGS = /* @__PURE__ */ new Set([
@@ -1747,39 +1987,57 @@ async function main(argv) {
 			const port = flagNum(flags, "port");
 			const idle = flagNum(flags, "idle");
 			const noOpen = flags[NO_OPEN_FLAG] === true || process.env["PAINTRESS_NO_OPEN"] === "1";
+			const url = (p) => `http://localhost:${p}`;
+			const running = await reuseDaemon(port);
+			if (running !== null) {
+				console.log(JSON.stringify({
+					ok: true,
+					daemon: true,
+					reused: true,
+					pid: running.pid,
+					port: running.port,
+					http: url(running.port)
+				}, null, 2));
+				return 0;
+			}
 			if (flags["daemon"] === true) {
-				const { spawn } = await import("node:child_process");
-				const args = [process.argv[1] ?? "", "web"];
-				if (port !== void 0) args.push("--port", String(port));
-				if (idle !== void 0) args.push("--idle", String(idle));
-				if (noOpen) args.push("--no-open");
-				const child = spawn(process.execPath, args, {
-					detached: true,
-					stdio: "ignore"
+				const res = await ensureDaemon({
+					...port !== void 0 ? { port } : {},
+					...idle !== void 0 ? { idleTimeoutMs: idle } : {},
+					noOpen
 				});
-				child.unref();
-				const deadline = Date.now() + 5e3;
-				while (Date.now() < deadline) {
-					if (isDaemonRunning()) {
-						const res = await sendRequest({ kind: "ping" });
-						console.log(JSON.stringify({
-							daemon: true,
-							launcherPid: child.pid,
-							...res
-						}, null, 2));
-						return 0;
-					}
-					await new Promise((r) => setTimeout(r, 100));
-				}
-				throw new Error("后台启动超时（5s 内未出现控制面 socket）");
+				console.log(JSON.stringify({
+					ok: true,
+					daemon: true,
+					reused: !res.started,
+					pid: res.pid,
+					port: res.port,
+					http: url(res.port)
+				}, null, 2));
+				return 0;
 			}
-			const handle = await startDaemon({
-				...port !== void 0 ? { port } : {},
-				...idle !== void 0 ? { idleTimeoutMs: idle } : {},
-				emptyGraceMs: 6e4,
-				updateCheck: true
-			});
-			const http = `http://localhost:${handle.port}`;
+			let handle;
+			try {
+				handle = await startDaemon({
+					...port !== void 0 ? { port } : {},
+					...idle !== void 0 ? { idleTimeoutMs: idle } : {},
+					emptyGraceMs: 6e4,
+					updateCheck: true
+				});
+			} catch (cause) {
+				const again = await queryDaemon();
+				if (again === null) throw cause;
+				console.log(JSON.stringify({
+					ok: true,
+					daemon: true,
+					reused: true,
+					pid: again.pid,
+					port: again.port,
+					http: url(again.port)
+				}, null, 2));
+				return 0;
+			}
+			const http = url(handle.port);
 			console.log(JSON.stringify({
 				ok: true,
 				pid: handle.pid,
@@ -1787,7 +2045,7 @@ async function main(argv) {
 				http
 			}, null, 2));
 			if (!noOpen) {
-				const { openBrowser } = await import("./server-ssrAxbTR.js").then((n) => n.r);
+				const { openBrowser } = await import("./server-DZRNNWac.js").then((n) => n.i);
 				openBrowser(`${http}/`);
 			}
 			await new Promise((resolve) => {
@@ -1796,8 +2054,54 @@ async function main(argv) {
 			});
 			return 0;
 		}
-		if (!file) throw new Error("缺少 <file> 参数");
 		let out;
+		if (cmd === "preset") {
+			const action = file ?? "list";
+			if (action === "list") out = await call("paintress_preset", {
+				action: "list",
+				...a1 !== void 0 ? { path: a1 } : {}
+			});
+			else if (action === "set") {
+				if (!a1 || !a2 || !positionals[3] || !positionals[4]) throw new Error("用法：paintress preset set <dir> <key> <color|radius> <value> [--name 名称]");
+				out = await call("paintress_preset", {
+					action: "set",
+					path: a1,
+					key: a2,
+					type: positionals[3],
+					value: positionals[4],
+					...flagStr(flags, "name") !== void 0 ? { name: flagStr(flags, "name") } : {}
+				});
+			} else if (action === "remove") {
+				if (!a1 || !a2) throw new Error("用法：paintress preset remove <dir> <key>");
+				out = await call("paintress_preset", {
+					action: "remove",
+					path: a1,
+					key: a2
+				});
+			} else throw new Error(`未知 preset 动作：${action}（list / set / remove）`);
+			console.log(JSON.stringify(out, null, 2));
+			return 0;
+		}
+		if (cmd === "component") {
+			const action = file ?? "list";
+			if (action === "list") out = await call("paintress_component", {
+				action: "list",
+				...a1 !== void 0 ? { path: a1 } : {}
+			});
+			else if (action === "insert") {
+				if (!a1 || !a2) throw new Error("用法：paintress component insert <file> <id> [--parent p] [--index n]");
+				out = await call("paintress_component", {
+					action: "insert",
+					path: a1,
+					id: a2,
+					...flagStr(flags, "parent") !== void 0 ? { parent: flagStr(flags, "parent") } : {},
+					...flagNum(flags, "index") !== void 0 ? { index: flagNum(flags, "index") } : {}
+				});
+			} else throw new Error(`未知 component 动作：${action}（list / insert）`);
+			console.log(JSON.stringify(out, null, 2));
+			return 0;
+		}
+		if (!file) throw new Error("缺少 <file> 参数");
 		switch (cmd) {
 			case "new": {
 				const name = flagStr(flags, "name");

package/dist/index.js

@@ -1 +1 @@
-export { It as Affine, it as BackgroundBlurEffect, bt as BlendMode, at as BlurEffect, Lt as BoolOrVar, z as BrowserSchema, Rt as Color, zt as ColorOrVar, Bt as CornerRadius, xt as CrossAxis, j as DocumentObjectSchema, M as DocumentSchema, ot as EffectEntry, st as Effects, B as EllipseSchema, w as FileChangedError, ct as FillEntry, St as FillRule, lt as Fills, V as FrameSchema, ut as GradientFill, Ct as GradientType, dt as GraphicsBlock, H as GroupSchema, U as IconFontSchema, wt as IconLibrary, W as IconSchema, ft as ImageFill, Tt as ImageFit, G as KNOWN_NODE_TYPES, K as LayoutBlock, Et as LayoutDir, Dt as MainAxis, pt as MeshGradientFill, q as NodeBase, J as NodeSchema, Y as NoteSchema, Vt as NumOrVar, N as PEN_DOC_VERSION, P as PTR_SPEC_VERSION, Ht as Padding, X as PathSchema, Z as PolygonSchema, Ot as PositionMode, F as PtrDocumentSchema, Q as RectangleSchema, $ as RefSchema, et as ScriptSchema, mt as ShaderEffect, ht as ShaderFill, gt as ShadowEffect, kt as ShadowKind, Ut as Sizing, _t as SolidFill, Wt as StringOrVar, At as StrokeAlign, vt as StrokeBlock, jt as StrokeCap, Mt as StrokeJoin, yt as StrokeWidth, Nt as TextAlign, Pt as TextAlignVertical, Ft as TextGrowth, tt as TextSchema, nt as UnknownNodeSchema, Gt as VARIABLE_NAME, I as VariableDef, Kt as VariableRef, L as XPaintress, R as X_PAINTRESS_KEY, g as batch, n as boardBoxes, _ as buildIndex, k as collectIds, c as commonToCss, r as computeCanvas, l as cornerRadiusToCss, u as effectsToCss, i as escapeAttr, a as escapeHtml, m as expandRefs, d as fillsToCss, A as genId, v as get, s as getLucideIcon, y as insert, T as loadDoc, h as makeVarResolver, b as move, x as query, S as remove, t as renderDocument, o as renderTree, E as saveDoc, rt as schemaForType, D as serializeDoc, f as strokeToCss, p as textToCss, C as update, O as validateDoc } from "./render-CCxYNL6A.js";
+export { It as Affine, it as BackgroundBlurEffect, bt as BlendMode, at as BlurEffect, Lt as BoolOrVar, z as BrowserSchema, Rt as Color, zt as ColorOrVar, Bt as CornerRadius, xt as CrossAxis, j as DocumentObjectSchema, M as DocumentSchema, ot as EffectEntry, st as Effects, B as EllipseSchema, w as FileChangedError, ct as FillEntry, St as FillRule, lt as Fills, V as FrameSchema, ut as GradientFill, Ct as GradientType, dt as GraphicsBlock, H as GroupSchema, U as IconFontSchema, wt as IconLibrary, W as IconSchema, ft as ImageFill, Tt as ImageFit, G as KNOWN_NODE_TYPES, K as LayoutBlock, Et as LayoutDir, Dt as MainAxis, pt as MeshGradientFill, q as NodeBase, J as NodeSchema, Y as NoteSchema, Vt as NumOrVar, N as PEN_DOC_VERSION, P as PTR_SPEC_VERSION, Ht as Padding, X as PathSchema, Z as PolygonSchema, Ot as PositionMode, F as PtrDocumentSchema, Q as RectangleSchema, $ as RefSchema, et as ScriptSchema, mt as ShaderEffect, ht as ShaderFill, gt as ShadowEffect, kt as ShadowKind, Ut as Sizing, _t as SolidFill, Wt as StringOrVar, At as StrokeAlign, vt as StrokeBlock, jt as StrokeCap, Mt as StrokeJoin, yt as StrokeWidth, Nt as TextAlign, Pt as TextAlignVertical, Ft as TextGrowth, tt as TextSchema, nt as UnknownNodeSchema, Gt as VARIABLE_NAME, I as VariableDef, Kt as VariableRef, L as XPaintress, R as X_PAINTRESS_KEY, g as batch, n as boardBoxes, _ as buildIndex, k as collectIds, c as commonToCss, r as computeCanvas, l as cornerRadiusToCss, u as effectsToCss, i as escapeAttr, a as escapeHtml, m as expandRefs, d as fillsToCss, A as genId, v as get, s as getLucideIcon, y as insert, T as loadDoc, h as makeVarResolver, b as move, x as query, S as remove, t as renderDocument, o as renderTree, E as saveDoc, rt as schemaForType, D as serializeDoc, f as strokeToCss, p as textToCss, C as update, O as validateDoc } from "./render-BSf62388.js";

package/dist/mcp/server.js

@@ -1 +1 @@
-export { t as createMcpServer, n as runStdioServer } from "../server-ssrAxbTR.js";
+export { t as createMcpServer, n as runStdioServer } from "../server-DZRNNWac.js";

package/dist/{render-CCxYNL6A.js → render-BSf62388.js}

@@ -597,7 +597,7 @@ function collectIds(children, out = []) {
 }
 // src/doc/validate.ts
 /** 结构校验（schema）+ 语义校验（重复 id、悬空 ref、未知类型、未解析变量） */
-function validateDoc(input) {
+function validateDoc(input, opts = {}) {
 	const errors = [];
 	const warnings = [];
 	const parsed = DocumentSchema.safeParse(input);
@@ -648,7 +648,13 @@ function validateDoc(input) {
 		}
 	};
 	walk(doc.children, "children");
-	const varNames = new Set(doc.variables ? Object.keys(doc.variables) : []);
+	const localNames = new Set(doc.variables ? Object.keys(doc.variables) : []);
+	const varNames = /* @__PURE__ */ new Set([...localNames, ...opts.knownVars ?? []]);
+	for (const name of opts.presetVars ?? []) if (localNames.has(name)) warnings.push({
+		level: "warning",
+		path: "<variables>",
+		message: `本地变量 $${name} 覆盖了项目预设（在查看器里调预设不会影响这份文件）`
+	});
 	const varRefs = /* @__PURE__ */ new Set();
 	const scan = (obj) => {
 		if (typeof obj === "string" && VARIABLE_NAME.test(obj)) varRefs.add(obj.slice(1));
@@ -1816,7 +1822,7 @@ function renderDocument(doc, opts = {}) {
 			`<title>${escapeAttr(title)}</title>`,
 			"<style>",
 			"* { box-sizing: border-box; margin: 0; padding: 0; }",
-			"body { margin: 0; background: #ffffff; }",
+			`body { margin: 0; background: ${opts.transparent === true ? "transparent" : "#ffffff"}; }`,
 			".ptr-canvas { position: relative; }",
 			"</style>",
 			"</head>",