@huaqiu/dsh-tool-schematic-gen 0.3.7 → 0.3.9

package/lib/client.js

@@ -27,7 +27,8 @@ window.__ModuleLoader__.load({
 				id,
 				type: typeof o.type === "string" ? o.type : null,
 				filename: typeof o.filename === "string" ? o.filename : null,
-				size: typeof o.size === "number" ? o.size : null
+				size: typeof o.size === "number" ? o.size : null,
+				uri: typeof o.uri === "string" && o.uri.length > 0 ? o.uri : null
 			};
 		}
 		function parseSchResult(text) {
@@ -44,15 +45,23 @@ window.__ModuleLoader__.load({
 			const status = typeof o.status === "string" ? o.status : null;
 			const kind = typeof o.kind === "string" ? o.kind : null;
 			let artifact = null;
-			if (kind === "system") artifact = artOf(o.zipArtifact);
-			else {
+			const artifacts = [];
+			if (kind === "system") {
+				artifact = artOf(o.zipArtifact);
+				if (artifact) artifacts.push(artifact);
+			} else {
 				const list = Array.isArray(o.schArtifacts) ? o.schArtifacts : [];
-				artifact = list.length > 0 ? artOf(list[0]) : null;
+				for (const entry of list) {
+					const ref = artOf(entry);
+					if (ref) artifacts.push(ref);
+				}
+				artifact = artifacts.length > 0 ? artifacts[0] : null;
 			}
 			return {
 				status,
 				kind,
 				artifact,
+				artifacts,
 				designName: typeof o.design_name === "string" && o.design_name ? o.design_name : null,
 				fileCount: Array.isArray(o.schFiles) ? o.schFiles.length : Array.isArray(o.schArtifacts) ? o.schArtifacts.length : null,
 				moduleCount: typeof o.module_count === "number" ? o.module_count : null,
@@ -476,6 +485,11 @@ window.__ModuleLoader__.load({
 			"card.meta.connections": "{count} 条连接",
 			"card.action.download": "下载",
 			"card.action.downloading": "下载中…",
+			"card.action.place": "放置到编辑器",
+			"card.action.placing": "放置中…",
+			"card.place.done": "已放置 {count} 个文件到编辑器",
+			"card.place.partial": "已放置 {placed} 个，{failed} 个失败：",
+			"card.place.failed": "放置失败：",
 			"card.action.regenerate": "重新生成",
 			"card.action.regenerating": "重新生成中…",
 			"card.action.inspect": "详情",
@@ -522,6 +536,11 @@ window.__ModuleLoader__.load({
 				"card.meta.connections": "{count} connection(s)",
 				"card.action.download": "Download",
 				"card.action.downloading": "Downloading…",
+				"card.action.place": "Place in editor",
+				"card.action.placing": "Placing…",
+				"card.place.done": "Placed {count} file(s) into the editor",
+				"card.place.partial": "Placed {placed}, {failed} failed: ",
+				"card.place.failed": "Placement failed: ",
 				"card.action.regenerate": "Regenerate",
 				"card.action.regenerating": "Regenerating…",
 				"card.action.inspect": "Inspect",
@@ -104849,6 +104868,84 @@ while (n3 === a3[++i3] && n3 === a3[++i3] && n3 === a3[++i3] && n3 === a3[++i3]
 			}
 		}
 		//#endregion
+		//#region ../dsh-artifacts/lib/placement.mjs
+		/**
+		* Editors each artifact type may be placed into.
+		*
+		* | Artifact  | sch | pcb | symbol | footprint | generic |
+		* |-----------|-----|-----|--------|-----------|---------|
+		* | schematic | yes | no  | no     | no        | yes     |
+		* | symbol    | yes | no  | yes    | no        | yes     |
+		* | footprint | no  | yes | no     | yes       | yes     |
+		* | pcb       | no  | yes | no     | no        | yes     |
+		*
+		* `pcb` rides the same design-block RPC as schematics (`DesignContent.pcb`):
+		* the editor-side PCB placement flow is the placement team's work and builds
+		* on this channel, so it must not be assumed away. `generic` means the host
+		* did not declare a specific editor context, and per the host contract such a
+		* deployment supports ALL placement targets by design — the EDA host is the
+		* final authority (HQ Edge re-enforces the same matrix server-side). Unknown
+		* editor values still fail closed.
+		*/
+		const COMPATIBLE_EDITORS = {
+			schematic: /* @__PURE__ */ new Set(["sch", "generic"]),
+			symbol: /* @__PURE__ */ new Set([
+				"sch",
+				"symbol",
+				"generic"
+			]),
+			footprint: /* @__PURE__ */ new Set([
+				"pcb",
+				"footprint",
+				"generic"
+			]),
+			pcb: /* @__PURE__ */ new Set(["pcb", "generic"])
+		};
+		/**
+		* Can `artifactType` be placed into the editor identified by `editorType`?
+		*
+		* Fails closed: an unrecognized artifact or editor type yields `false`.
+		*/
+		function canPlaceArtifact(artifactType, editorType) {
+			const allowed = COMPATIBLE_EDITORS[artifactType];
+			return allowed ? allowed.has(editorType) : false;
+		}
+		/**
+		* Build the Place support for `artifactType` from a lazily-resolved `hqEdge`.
+		*
+		* Returns null when `getHqEdge` is unavailable (standalone DSH has no
+		* edge-bridge, hence no `hqEdge` service). Otherwise returns a GETTER so
+		* callers resolve the service lazily — plugin load order and HQ Edge restarts
+		* both resolve correctly at click time. The getter yields null when
+		* placement is unavailable or the current editor cannot accept the artifact
+		* type (the card hides the button in that case).
+		*
+		* Editor gating is UX-only; HQ Edge re-enforces the matrix server-side (409).
+		*/
+		function placeSupportOf(getHqEdge, artifactType) {
+			if (typeof getHqEdge !== "function") return null;
+			return () => {
+				let hqEdge;
+				try {
+					hqEdge = getHqEdge();
+				} catch {
+					return null;
+				}
+				if (!hqEdge || typeof hqEdge.placeArtifact !== "function") return null;
+				let editorType = "";
+				try {
+					editorType = hqEdge.context?.getEditorType?.() ?? hqEdge.context?.getCurrent?.()?.editorType ?? "";
+				} catch {
+					return null;
+				}
+				if (!editorType || !canPlaceArtifact(artifactType, editorType)) return null;
+				return {
+					editorType,
+					place: (request) => hqEdge.placeArtifact(request)
+				};
+			};
+		}
+		//#endregion
 		//#region src/trace.ts
 		/**
 		* Marker appended to the leaf of a synthesized instance path. It is invisible
@@ -105798,6 +105895,7 @@ while (n3 === a3[++i3] && n3 === a3[++i3] && n3 === a3[++i3] && n3 === a3[++i3]
 				};
 			}, [artifactKey, state.phase]);
 			const [busy, setBusy] = (0, react.useState)(null);
+			const [placeStatus, setPlaceStatus] = (0, react.useState)(null);
 			function onDownload() {
 				if (busy || payload.phase !== "ready") return;
 				const kind = result?.kind ?? "schematic";
@@ -105819,6 +105917,52 @@ while (n3 === a3[++i3] && n3 === a3[++i3] && n3 === a3[++i3] && n3 === a3[++i3]
 					setBusy(null);
 				});
 			}
+			/**
+			* Place the generated design into the host EDA editor via HQ Edge.
+			*
+			* A system design sends ONE request (the project zip; HQ Edge derives the
+			* root from the `*.kicad_pro` name — the same convention as the preview).
+			* A multi-sheet schematic sends one request per sheet so every sheet lands
+			* in the editor. Failures are collected and reported as a one-line status;
+			* a partial success is explicitly surfaced, not swallowed.
+			*/
+			function placeRequestsOf() {
+				if (!result) return [];
+				return result.artifacts.filter((a) => a.uri).map((a) => ({
+					artifactUri: a.uri,
+					filename: a.filename
+				}));
+			}
+			async function onPlace() {
+				if (busy) return;
+				const support = placeSupportOf(props.getHqEdge, "schematic")?.();
+				if (!support) return;
+				const requests = placeRequestsOf();
+				if (requests.length === 0) return;
+				setBusy("place");
+				setPlaceStatus(null);
+				let placed = 0;
+				const failures = [];
+				for (const req of requests) try {
+					await support.place({
+						type: "schematic",
+						artifactUri: req.artifactUri,
+						...req.filename ? { filename: req.filename } : {}
+					});
+					placed++;
+				} catch (err) {
+					const detail = String(err?.message || err);
+					console.warn("[hq-schematic-gen] place failed", detail);
+					failures.push(detail);
+				}
+				setBusy(null);
+				if (failures.length === 0) setPlaceStatus(t("card.place.done", { count: placed }));
+				else if (placed > 0) setPlaceStatus(t("card.place.partial", {
+					placed,
+					failed: failures.length
+				}) + " " + failures[0]);
+				else setPlaceStatus(t("card.place.failed") + " " + failures[0]);
+			}
 			if (state.phase === "needs_auth") return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(LoginCard, {
 				toolName: props.toolName,
 				authState: props.authState,
@@ -105891,6 +106035,9 @@ while (n3 === a3[++i3] && n3 === a3[++i3] && n3 === a3[++i3] && n3 === a3[++i3]
 				})
 			});
 			const canDownload = payload.phase === "ready" && (payload.source != null || payload.bytes != null);
+			const placeSupport = placeSupportOf(props.getHqEdge, "schematic");
+			const placeableCount = result.artifacts.filter((a) => a.uri).length;
+			const canPlace = !!placeSupport?.() && placeableCount > 0;
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				className: "hq-sch",
 				children: [
@@ -105911,6 +106058,13 @@ while (n3 === a3[++i3] && n3 === a3[++i3] && n3 === a3[++i3] && n3 === a3[++i3]
 								disabled: !canDownload || busy === "download",
 								children: ["⭳ ", busy === "download" ? t("card.action.downloading") : t("card.action.download")]
 							}),
+							canPlace ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
+								type: "button",
+								className: "hq-sch__act",
+								onClick: onPlace,
+								disabled: busy === "place",
+								children: ["⇥ ", busy === "place" ? t("card.action.placing") : t("card.action.place")]
+							}) : null,
 							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
 								type: "button",
 								className: "hq-sch__act",
@@ -105925,7 +106079,11 @@ while (n3 === a3[++i3] && n3 === a3[++i3] && n3 === a3[++i3] && n3 === a3[++i3]
 								children: t("card.action.inspect")
 							}) : null
 						]
-					})
+					}),
+					placeStatus ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: "hq-sch__note",
+						children: placeStatus
+					}) : null
 				]
 			});
 		});
@@ -106007,6 +106165,7 @@ while (n3 === a3[++i3] && n3 === a3[++i3] && n3 === a3[++i3] && n3 === a3[++i3]
 		function apply(ctx) {
 			const disposers = [];
 			const useAuthState = createUseAuthState(ctx.get("huaqiuAuth")?.auth);
+			const getHqEdge = () => ctx.get("hqEdge");
 			const sendPrompt = (sessionId, message) => {
 				const sessions = ctx.get("sessions");
 				if (!sessions || typeof sessions.binding !== "function" || !sessionId) return Promise.reject(/* @__PURE__ */ new Error("no session conversation channel"));
@@ -106026,7 +106185,8 @@ while (n3 === a3[++i3] && n3 === a3[++i3] && n3 === a3[++i3] && n3 === a3[++i3]
 					sessionId: props.sessionId,
 					callId: props.callId,
 					sendPrompt,
-					authState: useAuthState()
+					authState: useAuthState(),
+					getHqEdge
 				});
 				for (const toolName of TOOLVIEW_KEYS) disposers.push(slots.inject("tool.call.toolview", () => slots.register({
 					name: "tool.call.toolview",