@huaqiu/dsh-tool-uncollapse 0.3.6

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 深圳华秋智联股份有限公司
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/lib/index.d.mts

@@ -0,0 +1,32 @@
+//#region src/index.d.ts
+/**
+ * `@huaqiu/dsh-tool-uncollapse` — keep a plugin's tool-call preview card
+ * visible in DSH's compact transcript, without patching DSH.
+ *
+ * DSH collapses `tool-call` nodes behind a "N tool calls" disclosure by setting
+ * `hidden="until-found"` on the chat-node wrapper once the turn closes (see
+ * `ui-chat`'s `ChatNodeSeat` + `useSearchableHidden`). That hides the entire
+ * card (preview included). A plugin cannot prevent it from inside the card and
+ * must not patch DSH, so we undo it from the plugin's client half: for every
+ * collapsed seat that wraps the plugin's card, remove the `hidden` attribute.
+ * A rAF-coalesced MutationObserver reasserts this whenever DSH's virtualized
+ * renderer re-adds it.
+ *
+ * Scoped to the plugin's cards only — other tools keep collapsing. Returns a
+ * disposer (or a no-op when there is no DOM, e.g. SSR/tests).
+ *
+ * @param cardRootSelector - CSS selector matching the plugin card's root
+ *   element, e.g. `.hq-genhit` (symbol/footprint) or `.hq-sch` (schematic).
+ * @param options.skipWhenContains - when a collapsed seat ALSO contains this
+ *   selector, leave it collapsed and follow DSH's default behaviour. Use this
+ *   for transient sub-states that should not be pinned open — e.g. the inline
+ *   login card (`.hq-genhit__login` / `.hq-sch__login`), so the login HIT
+ *   collapses automatically while the finished preview stays visible.
+ * @returns cleanup function; safe to call repeatedly.
+ */
+interface KeepToolCardVisibleOptions {
+  skipWhenContains?: string;
+}
+declare function keepToolCardVisible(cardRootSelector: string, options?: KeepToolCardVisibleOptions): () => void;
+//#endregion
+export { KeepToolCardVisibleOptions, keepToolCardVisible };

package/lib/index.mjs

@@ -0,0 +1,34 @@
+//#region src/index.ts
+function keepToolCardVisible(cardRootSelector, options) {
+	if (typeof document === "undefined" || typeof MutationObserver === "undefined") return () => {};
+	const skipSelector = options?.skipWhenContains;
+	const root = document.documentElement;
+	const revealSeat = (seat) => {
+		if (!seat.querySelector(cardRootSelector)) return;
+		if (skipSelector && seat.querySelector(skipSelector)) return;
+		seat.removeAttribute("hidden");
+	};
+	let scheduled = false;
+	const sweep = () => {
+		scheduled = false;
+		for (const seat of root.querySelectorAll("[data-turn-process-hidden]")) revealSeat(seat);
+	};
+	const observer = new MutationObserver(() => {
+		if (scheduled) return;
+		scheduled = true;
+		requestAnimationFrame(sweep);
+	});
+	observer.observe(root, {
+		subtree: true,
+		childList: true,
+		attributes: true,
+		attributeFilter: ["hidden", "data-turn-process-hidden"]
+	});
+	sweep();
+	return () => {
+		observer.disconnect();
+		scheduled = false;
+	};
+}
+//#endregion
+export { keepToolCardVisible };

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@huaqiu/dsh-tool-uncollapse",
+  "version": "0.3.6",
+  "type": "module",
+  "main": "./lib/index.mjs",
+  "types": "./lib/index.d.mts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.mts",
+      "default": "./lib/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "src"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "tsdown": "^0.22.14",
+    "typescript": "^5.9.0"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "build": "tsdown",
+    "test": "vitest run"
+  }
+}

package/src/index.ts

@@ -0,0 +1,68 @@
+/**
+ * `@huaqiu/dsh-tool-uncollapse` — keep a plugin's tool-call preview card
+ * visible in DSH's compact transcript, without patching DSH.
+ *
+ * DSH collapses `tool-call` nodes behind a "N tool calls" disclosure by setting
+ * `hidden="until-found"` on the chat-node wrapper once the turn closes (see
+ * `ui-chat`'s `ChatNodeSeat` + `useSearchableHidden`). That hides the entire
+ * card (preview included). A plugin cannot prevent it from inside the card and
+ * must not patch DSH, so we undo it from the plugin's client half: for every
+ * collapsed seat that wraps the plugin's card, remove the `hidden` attribute.
+ * A rAF-coalesced MutationObserver reasserts this whenever DSH's virtualized
+ * renderer re-adds it.
+ *
+ * Scoped to the plugin's cards only — other tools keep collapsing. Returns a
+ * disposer (or a no-op when there is no DOM, e.g. SSR/tests).
+ *
+ * @param cardRootSelector - CSS selector matching the plugin card's root
+ *   element, e.g. `.hq-genhit` (symbol/footprint) or `.hq-sch` (schematic).
+ * @param options.skipWhenContains - when a collapsed seat ALSO contains this
+ *   selector, leave it collapsed and follow DSH's default behaviour. Use this
+ *   for transient sub-states that should not be pinned open — e.g. the inline
+ *   login card (`.hq-genhit__login` / `.hq-sch__login`), so the login HIT
+ *   collapses automatically while the finished preview stays visible.
+ * @returns cleanup function; safe to call repeatedly.
+ */
+export interface KeepToolCardVisibleOptions {
+  skipWhenContains?: string
+}
+
+export function keepToolCardVisible(
+  cardRootSelector: string,
+  options?: KeepToolCardVisibleOptions,
+): () => void {
+  if (typeof document === 'undefined' || typeof MutationObserver === 'undefined') {
+    return () => {}
+  }
+  const skipSelector = options?.skipWhenContains
+  const root = document.documentElement
+  const revealSeat = (seat: HTMLElement): void => {
+    if (!seat.querySelector(cardRootSelector)) return
+    // Leave transient sub-states (e.g. the login HIT) collapsed by default.
+    if (skipSelector && seat.querySelector(skipSelector)) return
+    seat.removeAttribute('hidden')
+  }
+  let scheduled = false
+  const sweep = (): void => {
+    scheduled = false
+    for (const seat of root.querySelectorAll<HTMLElement>('[data-turn-process-hidden]')) {
+      revealSeat(seat)
+    }
+  }
+  const observer = new MutationObserver(() => {
+    if (scheduled) return
+    scheduled = true
+    requestAnimationFrame(sweep)
+  })
+  observer.observe(root, {
+    subtree: true,
+    childList: true,
+    attributes: true,
+    attributeFilter: ['hidden', 'data-turn-process-hidden'],
+  })
+  sweep()
+  return () => {
+    observer.disconnect()
+    scheduled = false
+  }
+}