@fonlan/dsh-quick-commands 0.1.8 → 0.1.10

package/lib/client.js

@@ -825,7 +825,7 @@ window.__ModuleLoader__.load({
 			});
 		}
 		//#endregion
-		//#region \0dsh-css:/Users/fonlan/Repos/dsh-quick-commands/src/client/settings-section.css.mjs
+		//#region \0dsh-css:/home/runner/work/dsh-quick-commands/dsh-quick-commands/src/client/settings-section.css.mjs
 		const css$1 = "/**\n * Styles for the quick-commands settings page.\n *\n * The page occupies the settings panel content column: a static header\n * (title plus a one-line summary) over the always-visible command editor.\n * Inner controls follow the built-in settings language.\n */\n\n/* page layout */\n\n.qc-page {\n  display: flex;\n  flex-direction: column;\n  gap: 16px;\n  max-width: 720px;\n}\n.qc-page-head {\n  display: flex;\n  flex-direction: column;\n  gap: 6px;\n}\n.qc-page-title {\n  margin: 0;\n  color: var(--dsw-alias-label-primary, #f2f2f2);\n  font-size: 15px;\n  font-weight: 600;\n  line-height: 1.4;\n}\n.qc-page-sub {\n  margin: 0;\n  color: var(--dsw-alias-label-secondary, #cfd3d6);\n  font-size: 13px;\n  line-height: 1.5;\n}\n\n/* body: workspace / command-set editor */\n\n.qc-settings-body {\n  display: flex;\n  flex-direction: column;\n  gap: 10px;\n}\n.qc-settings-intro {\n  font-size: 12px;\n  color: var(--dsw-alias-label-secondary, #cfd3d6);\n  margin: 0;\n  line-height: 1.5;\n}\n.qc-settings-anchor {\n  display: flex;\n  align-items: center;\n  gap: 12px;\n  font-size: 12px;\n}\n.qc-settings-anchor-label {\n  color: var(--dsw-alias-label-primary, #f2f2f2);\n  font-weight: 500;\n}\n.qc-settings-radio {\n  display: inline-flex;\n  align-items: center;\n  gap: 4px;\n  color: var(--dsw-alias-label-secondary, #cfd3d6);\n  cursor: pointer;\n}\n.qc-settings-error {\n  font-size: 12px;\n  color: var(--dsw-alias-state-error-primary, #e5484d);\n}\n.qc-settings-empty {\n  font-size: 12px;\n  color: var(--dsw-alias-label-secondary, #cfd3d6);\n  margin: 0;\n}\n.qc-settings-workspace {\n  border: 1px solid var(--dsw-alias-border-l2, rgba(128, 128, 128, 0.35));\n  border-radius: 10px;\n  padding: 10px;\n  display: flex;\n  flex-direction: column;\n  gap: 8px;\n}\n.qc-settings-workspace-head {\n  display: flex;\n  align-items: baseline;\n  gap: 8px;\n}\n.qc-settings-workspace-title {\n  font-size: 13px;\n  font-weight: 600;\n  color: var(--dsw-alias-label-primary, #f2f2f2);\n}\n.qc-settings-workspace-path {\n  font-size: 11px;\n  font-family: var(--dsw-font-family-mono, monospace);\n  color: var(--dsw-alias-label-tertiary, #adb2b8);\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n}\n.qc-settings-no-commands {\n  font-size: 12px;\n  color: var(--dsw-alias-label-tertiary, #adb2b8);\n  margin: 0;\n}\n.qc-settings-command {\n  display: flex;\n  gap: 6px;\n  align-items: center;\n}\n.qc-settings-field {\n  border: 1px solid var(--dsw-alias-border-l2, rgba(128, 128, 128, 0.35));\n  border-radius: 8px;\n  background: var(--dsw-alias-bg-layer-1, #2a2a2d);\n  color: var(--dsw-alias-label-primary, #f2f2f2);\n  font-size: 12px;\n  padding: 6px 8px;\n  outline: none;\n}\n.qc-settings-field::placeholder {\n  color: var(--dsw-alias-label-tertiary, #adb2b8);\n}\n.qc-settings-field:focus {\n  border-color: var(--dsw-alias-brand-primary, #4a9eff);\n}\n.qc-settings-field-name {\n  width: 160px;\n  flex: none;\n}\n.qc-settings-field-command {\n  flex: 1;\n  font-family: var(--dsw-font-family-mono, monospace);\n}\n.qc-settings-icon-btn {\n  border: 0;\n  background: transparent;\n  color: var(--dsw-alias-label-tertiary, #adb2b8);\n  cursor: pointer;\n  padding: 4px;\n  display: inline-flex;\n  align-items: center;\n  border-radius: 6px;\n}\n.qc-settings-icon-btn:hover {\n  background: color-mix(in srgb, var(--dsw-alias-label-primary, #f2f2f2) 10%, transparent);\n  color: var(--dsw-alias-state-error-primary, #e5484d);\n}\n.qc-settings-add-btn {\n  align-self: flex-start;\n  display: inline-flex;\n  align-items: center;\n  gap: 4px;\n  border: 1px solid var(--dsw-alias-border-l2, rgba(128, 128, 128, 0.35));\n  border-radius: 8px;\n  background: transparent;\n  color: var(--dsw-alias-label-primary, #f2f2f2);\n  font-size: 12px;\n  padding: 4px 10px;\n  cursor: pointer;\n}\n.qc-settings-add-btn:hover {\n  background: color-mix(in srgb, var(--dsw-alias-label-primary, #f2f2f2) 10%, transparent);\n}\n";
 		const tagId$1 = "@fonlan/dsh-quick-commands/settings-section.css#d7004149";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$1) + "]") === null) {
@@ -1152,7 +1152,7 @@ window.__ModuleLoader__.load({
 			cardAnchorButton: "Anchored at button"
 		};
 		//#endregion
-		//#region \0dsh-css:/Users/fonlan/Repos/dsh-quick-commands/src/client/quick-commands.css.mjs
+		//#region \0dsh-css:/home/runner/work/dsh-quick-commands/dsh-quick-commands/src/client/quick-commands.css.mjs
 		const css = "/* @fonlan/dsh-quick-commands client styles.\n   Uses theme CSS variables (--dsw-alias-*); falls back to neutral literals.\n   Constraint: this deployment's theme defines only these text tokens —\n   label-primary, label-secondary, label-tertiary, label-dimmed. READABLE\n   description copy uses label-secondary / label-tertiary (never label-dimmed,\n   which is intentionally near-invisible and reserved for disabled states). */\n\n/* ── header button (icon-only, left of Session log pill) ─────────────────── */\n.qc-head-wrap {\n  position: relative;\n  display: inline-flex;\n  align-items: center;\n}\n/* Sized to DSH built-in header buttons (e.g. the open-in-app split button on\n   the left): 26px tall pill, 13px radius, hairline border-l4, hover uses the\n   shared --dsw-alias-interactive-bg-hover token. */\n.qc-head-btn {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  width: 26px;\n  height: 26px;\n  border: 0.5px solid var(--dsw-alias-border-l4, rgba(128, 128, 128, 0.35));\n  border-radius: 13px;\n  background: transparent;\n  color: var(--dsw-alias-label-primary, #f2f2f2);\n  cursor: pointer;\n  padding: 0;\n}\n.qc-head-btn:hover:not(:disabled) {\n  background: var(--dsw-alias-interactive-bg-hover, color-mix(in srgb, var(--dsw-alias-label-primary, #f2f2f2) 10%, transparent));\n}\n.qc-head-btn:disabled {\n  color: var(--dsw-alias-label-dimmed, #666);\n  cursor: not-allowed;\n}\n.qc-head-btn svg {\n  flex: none;\n}\n\n/* ── command menu popover (anchored under the button) ────────────────────── */\n.qc-menu {\n  position: absolute;\n  top: calc(100% + 6px);\n  right: 12px;\n  min-width: 280px;\n  max-height: 420px;\n  overflow: auto;\n  background: var(--dsw-alias-bg-overlay, #1b1b1c);\n  border: 1px solid var(--dsw-alias-border-l2, rgba(128, 128, 128, 0.35));\n  border-radius: 10px;\n  box-shadow: 0 8px 24px rgba(0, 0, 0, 0.35);\n  z-index: 50;\n  padding: 6px;\n  display: flex;\n  flex-direction: column;\n}\n.qc-menu-head {\n  display: flex;\n  align-items: center;\n  gap: 8px;\n  padding: 4px 8px 6px;\n  border-bottom: 1px solid var(--dsw-alias-border-l2, rgba(128, 128, 128, 0.25));\n}\n.qc-menu-title {\n  font-size: 12px;\n  font-weight: 600;\n  color: var(--dsw-alias-label-primary, #f2f2f2);\n}\n.qc-menu-ws {\n  flex: 1;\n  font-size: 11px;\n  color: var(--dsw-alias-label-tertiary, #adb2b8);\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n  text-align: right;\n  margin-right: 2px;\n}\n.qc-menu-remote {\n  flex: 0 0 auto;\n  font-size: 10px;\n  font-weight: 600;\n  line-height: 1;\n  padding: 2px 5px;\n  border-radius: 5px;\n  color: var(--dsw-alias-fg-on-accent, #fff);\n  background: var(--dsw-alias-accent, #4a8dff);\n  letter-spacing: 0.04em;\n}\n.qc-menu-close {\n  border: 0;\n  background: transparent;\n  color: var(--dsw-alias-label-tertiary, #adb2b8);\n  cursor: pointer;\n  padding: 2px;\n  display: inline-flex;\n  align-items: center;\n}\n.qc-menu-empty {\n  font-size: 12px;\n  color: var(--dsw-alias-label-tertiary, #adb2b8);\n  padding: 10px 8px;\n  margin: 0;\n}\n.qc-menu-item {\n  display: flex;\n  flex-direction: column;\n  align-items: flex-start;\n  gap: 2px;\n  text-align: left;\n  border: 0;\n  background: transparent;\n  border-radius: 8px;\n  padding: 6px 8px;\n  cursor: pointer;\n  width: 100%;\n}\n.qc-menu-item:hover:not(:disabled) {\n  background: color-mix(in srgb, var(--dsw-alias-label-primary, #f2f2f2) 10%, transparent);\n}\n.qc-menu-item:disabled {\n  opacity: 0.6;\n  cursor: wait;\n}\n.qc-menu-item-name {\n  font-size: 13px;\n  font-weight: 500;\n  color: var(--dsw-alias-label-primary, #f2f2f2);\n}\n.qc-menu-item-cmd {\n  font-family: var(--dsw-font-family-mono, monospace);\n  font-size: 11px;\n  color: var(--dsw-alias-label-secondary, #cfd3d6);\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n  max-width: 100%;\n}\n\n/* ── live output popup ───────────────────────────────────────────────────── */\n.qc-popup {\n  position: relative; /* anchors the absolutely-positioned resize grip */\n  display: flex;\n  flex-direction: column;\n  background: var(--dsw-alias-bg-overlay, #1b1b1c);\n  border: 1px solid var(--dsw-alias-border-l2, rgba(128, 128, 128, 0.35));\n  border-radius: 12px;\n  box-shadow: 0 12px 36px rgba(0, 0, 0, 0.45);\n  z-index: 60;\n  overflow: hidden;\n}\n.qc-popup-corner {\n  position: fixed;\n  right: 20px;\n  bottom: 20px;\n  width: 520px;\n  max-width: calc(100vw - 40px);\n  height: 340px;\n  max-height: calc(100vh - 120px);\n}\n.qc-popup-button {\n  position: absolute;\n  top: calc(100% + 6px);\n  right: 12px;\n  width: 440px;\n  max-width: calc(100vw - 40px);\n  height: 300px;\n  max-height: calc(100vh - 120px);\n}\n.qc-popup-head {\n  display: flex;\n  align-items: center;\n  gap: 8px;\n  padding: 8px 10px;\n  border-bottom: 1px solid var(--dsw-alias-border-l2, rgba(128, 128, 128, 0.25));\n}\n.qc-popup-title {\n  flex: 1;\n  font-size: 12px;\n  font-weight: 600;\n  color: var(--dsw-alias-label-primary, #f2f2f2);\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n}\n.qc-popup-cmd {\n  font-family: var(--dsw-font-family-mono, monospace);\n  font-size: 11px;\n  color: var(--dsw-alias-label-secondary, #cfd3d6);\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n  max-width: 40%;\n}\n.qc-popup-remote {\n  flex: 0 0 auto;\n  font-size: 10px;\n  font-weight: 600;\n  line-height: 1;\n  padding: 3px 6px;\n  border-radius: 6px;\n  color: var(--dsw-alias-fg-on-accent, #fff);\n  background: var(--dsw-alias-accent, #4a8dff);\n  letter-spacing: 0.04em;\n}\n.qc-popup-icon {\n  border: 0;\n  background: transparent;\n  color: var(--dsw-alias-label-tertiary, #adb2b8);\n  cursor: pointer;\n  padding: 4px;\n  display: inline-flex;\n  align-items: center;\n  border-radius: 6px;\n}\n.qc-popup-icon:hover:not(:disabled) {\n  background: color-mix(in srgb, var(--dsw-alias-label-primary, #f2f2f2) 10%, transparent);\n}\n.qc-popup-icon:disabled {\n  opacity: 0.4;\n  cursor: not-allowed;\n}\n.qc-popup-kill {\n  color: var(--dsw-alias-state-error-primary, #e5484d);\n}\n.qc-popup-confirm {\n  display: flex;\n  align-items: center;\n  gap: 8px;\n  font-size: 12px;\n  padding: 8px 10px;\n  background: color-mix(in srgb, var(--dsw-alias-state-warn-primary, #f5a623) 12%, transparent);\n  color: var(--dsw-alias-label-primary, #f2f2f2);\n  border-bottom: 1px solid var(--dsw-alias-border-l2, rgba(128, 128, 128, 0.25));\n}\n.qc-popup-btn {\n  border: 1px solid var(--dsw-alias-border-l2, rgba(128, 128, 128, 0.35));\n  border-radius: 8px;\n  background: transparent;\n  color: var(--dsw-alias-label-primary, #f2f2f2);\n  font-size: 12px;\n  padding: 4px 10px;\n  cursor: pointer;\n}\n.qc-popup-btn:hover {\n  background: color-mix(in srgb, var(--dsw-alias-label-primary, #f2f2f2) 10%, transparent);\n}\n.qc-popup-btn-plain {\n  color: var(--dsw-alias-label-secondary, #cfd3d6);\n}\n.qc-popup-tabs {\n  display: flex;\n  gap: 2px;\n  padding: 6px 10px 0;\n  border-bottom: 1px solid var(--dsw-alias-border-l2, rgba(128, 128, 128, 0.25));\n}\n.qc-popup-tab {\n  border: 0;\n  background: transparent;\n  color: var(--dsw-alias-label-secondary, #cfd3d6);\n  font-size: 12px;\n  padding: 5px 10px;\n  cursor: pointer;\n  border-bottom: 2px solid transparent;\n}\n.qc-popup-tab-active {\n  color: var(--dsw-alias-label-primary, #f2f2f2);\n  border-bottom-color: var(--dsw-alias-brand-primary, #4a9eff);\n}\n.qc-popup-output {\n  flex: 1;\n  overflow: auto;\n  padding: 8px 10px;\n  font-family: var(--dsw-font-family-mono, monospace);\n  font-size: 12px;\n  line-height: 1.5;\n}\n.qc-popup-pre {\n  margin: 0;\n  white-space: pre-wrap;\n  word-break: break-word;\n  color: var(--dsw-alias-label-primary, #f2f2f2);\n}\n.qc-popup-empty {\n  margin: 0;\n  color: var(--dsw-alias-label-tertiary, #adb2b8);\n  font-size: 12px;\n}\n.qc-popup-error {\n  margin: 0 0 6px;\n  color: var(--dsw-alias-state-error-primary, #e5484d);\n  font-size: 12px;\n}\n.qc-popup-foot {\n  display: flex;\n  align-items: center;\n  padding: 6px 10px;\n  border-top: 1px solid var(--dsw-alias-border-l2, rgba(128, 128, 128, 0.25));\n  font-size: 11px;\n}\n.qc-popup-state {\n  color: var(--dsw-alias-label-secondary, #cfd3d6);\n}\n\n/* Resize handles. The popup pins its RIGHT edge (both anchors); width is\n   always dragged from the LEFT border. Height is dragged from the TOP border\n   (corner anchor, bottom pinned) or the BOTTOM border (button anchor, top\n   pinned below the button). The free corner (top-left / bottom-left) carries\n   the diagonal grip. Pointer capture lives in header.tsx; touch-action:none\n   lets touch drags resize instead of scrolling. */\n.qc-popup-resize {\n  position: absolute;\n  z-index: 3;\n  touch-action: none;\n  user-select: none;\n}\n.qc-popup-resize-left {\n  left: 0;\n  top: 10px;\n  bottom: 10px;\n  width: 7px;\n  cursor: ew-resize;\n}\n.qc-popup-resize-top {\n  top: 0;\n  left: 10px;\n  right: 10px;\n  height: 7px;\n  cursor: ns-resize;\n}\n.qc-popup-resize-bottom {\n  bottom: 0;\n  left: 10px;\n  right: 10px;\n  height: 7px;\n  cursor: ns-resize;\n}\n.qc-popup-resize-left:hover,\n.qc-popup-resize-top:hover,\n.qc-popup-resize-bottom:hover {\n  background: color-mix(in srgb, var(--dsw-alias-label-primary, #f2f2f2) 14%, transparent);\n}\n.qc-popup-resize-corner {\n  width: 22px;\n  height: 22px;\n  z-index: 4;\n  display: flex;\n  padding: 3px;\n  color: var(--dsw-alias-label-tertiary, #adb2b8);\n  opacity: 0.6;\n  transition: opacity .15s ease;\n}\n.qc-popup-resize-corner-tl {\n  top: 0;\n  left: 0;\n  cursor: nwse-resize;\n  align-items: flex-start;\n  justify-content: flex-start;\n}\n.qc-popup-resize-corner-bl {\n  bottom: 0;\n  left: 0;\n  cursor: nesw-resize;\n  align-items: flex-end;\n  justify-content: flex-start;\n}\n.qc-popup-resize-corner:hover,\n.qc-popup-resize-corner:active {\n  opacity: 1;\n}\n\n/* ── mobile fallback (dsh-mobile-nav) ──────────────────────────────────────\n   The dsh-mobile-nav plugin (≤1023px) hides the ENTIRE header utilities seat\n   with `[data-mobile-nav=\"frame\"] [data-phase] header > :first-child >\n   :last-child { display: none !important; }`, because the seat used to hold\n   only the session-log-export capsule (which it relocates to the drawer\n   footer). Our quick-run ▶ button rides that same seat, so it vanished on\n   phones.\n\n   Re-show ONLY our button: restore the seat's flex layout (out-ranking the\n   host rule via `:has(.qc-head-wrap)` specificity (0,5,1) > (0,4,1)) and keep\n   every other seat occupant hidden (the session-log capsule stays relocated\n   to the drawer footer). Desktop (no [data-mobile-nav]) is untouched. */\n[data-mobile-nav=\"frame\"] [data-phase] header > :first-child > :last-child:has(.qc-head-wrap) {\n  display: flex !important;\n  margin-left: 4px !important;\n  gap: 0 !important;\n}\n[data-mobile-nav=\"frame\"] [data-phase] header > :first-child > :last-child:has(.qc-head-wrap)\n  [data-slot=\"conversation.session.header.utilities\"] > :not(.qc-head-wrap) {\n  display: none !important;\n}\n\n/* ── viewport-level command menu ─────────────────────────────────────────\n   The phone shell's nav rail creates a sibling stacking context and its\n   center column can clip header descendants. The React menu therefore mounts\n   in document.body; these styles deliberately detach it from that header\n   context. Pixel coordinates (including the 56px rail exclusion) are set by\n   positionMenu() in header.tsx. */\n.qc-menu-portal {\n  position: fixed;\n  right: auto;\n  z-index: 1100;\n  box-sizing: border-box;\n  max-height: min(420px, calc(100dvh - 72px));\n}\n\n@media (max-width: 767px) {\n  /* A 44px target lets a fingertip reliably activate both the stop and close\n     buttons without changing the desktop header density. */\n  body[data-dsh-mobile] .qc-popup-icon,\n  [data-mobile-nav=\"frame\"] .qc-popup-icon {\n    min-width: 44px;\n    min-height: 44px;\n    justify-content: center;\n  }\n}";
 		const tagId = "@fonlan/dsh-quick-commands/quick-commands.css#b65a4ce4";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {

package/lib/index.js

@@ -688,6 +688,28 @@ const WorkspaceCommandsSchema = z.object({
 	workspaceId: z.string().min(1),
 	commands: z.array(CommandSchema).max(200)
 });
+/**
+* Entry config schema, and the schema dsh derives the plugin's settings page
+* from. The `z<...>` annotation names the RESOLVED (live-handle) shape on
+* purpose:
+*
+*  - schemastery >= 3.18.3 carries a third `Mode` type parameter, so a
+*    `.volatile()` field's OUTPUT type is `Volatile<T>` (a live `{ get() }`
+*    cell), never `T` — the old `z<QuickCommandsSettings>` annotation stopped
+*    compiling;
+*  - dropping the annotation and letting the type be inferred does not build
+*    either: declaration emit then cannot portably name the inferred type
+*    (TS2742), because `z.array(...)` leaks `@deepseek-ai/cosmokit`'s `Dict`
+*    into the schema type while the program holds two schemastery copies
+*    (this plugin's 3.18.3, and the one `@deepseek-ai/dsh-host-webserver`
+*    resolves — see pnpm-workspace.yaml's minimumReleaseAgeExclude, which pins
+*    the former), and cosmokit itself is not nameable from this package.
+*
+* The annotation is type-only. At runtime all three fields are still declared
+* `volatile()` — that is what makes them writable by the settings plane (its
+* `write()` refuses an entry whose form has no volatile field) and what keeps
+* the auto-generated page working.
+*/
 const QuickCommandsSettingsSchema = z.object({
 	workspaces: z.array(WorkspaceCommandsSchema).max(500).volatile(),
 	popupAnchor: z.union([z.const("corner"), z.const("button")]).default("corner").volatile(),
@@ -697,25 +719,30 @@ const QuickCommandsSettingsSchema = z.object({
 	}).volatile()
 });
 /**
-* Read one config field. A volatile field arrives as a handle (dsh >= 0.1.7)
-* and is read through `.get()` on EVERY access, so edits made through the
-* settings plane are visible immediately; hosts that hand the plain value keep
-* working unchanged.
+* Read a config node that may be a plain value or a live (`.volatile()`) node.
+*
+* A plugin whose Config declares volatile fields receives a reactive config
+* whose fields expose `get()`, while hand-written config objects and tests pass
+* plain values. Both shapes are supported here so the same code path serves the
+* settings page, `cordis.patch.yml`, and the unit tests.
 */
-function readField(field, fallback) {
-	if (field === void 0 || field === null) return fallback;
-	const handle = field;
-	const value = typeof handle.get === "function" ? handle.get() : field;
-	return value === void 0 || value === null ? fallback : value;
+function liveValue(node, fallback) {
+	if (node === void 0 || node === null) return fallback;
+	const getter = node.get;
+	if (typeof getter === "function") {
+		const value = getter.call(node);
+		return value === void 0 ? fallback : value;
+	}
+	return node;
 }
 function registerSettings(ctx, config) {
 	const readWorkspaces = () => {
-		const value = readField(config?.workspaces, []);
+		const value = liveValue(config?.workspaces, []);
 		return Array.isArray(value) ? value : [];
 	};
-	const readAnchor = () => readField(config?.popupAnchor, "corner") === "button" ? "button" : "corner";
+	const readAnchor = () => liveValue(config?.popupAnchor, "corner") === "button" ? "button" : "corner";
 	const readPopupSize = () => {
-		const value = readField(config?.popupSize, void 0);
+		const value = liveValue(config?.popupSize, void 0);
 		if (typeof value !== "object" || value === null) return void 0;
 		const { width, height } = value;
 		if (typeof width !== "number" || typeof height !== "number") return void 0;

package/lib/types/index.d.ts

@@ -13,9 +13,9 @@
  * absence of dsh-ssh degrades cleanly to local-only behaviour.
  */
 import type { Context } from '@deepseek-ai/cordis';
-import type { QuickCommandsSettings } from './shared/contract.js';
+import { type QuickCommandsConfig } from './server/settings.js';
 export declare const name = "@fonlan/dsh-quick-commands";
 export declare const inject: string[];
-export declare const Config: import("@deepseek-ai/schemastery").default<QuickCommandsSettings>;
+export declare const Config: import("@deepseek-ai/schemastery").default<import("./shared/contract.js").QuickCommandsSettings, import("./server/settings.js").QuickCommandsLiveSettings>;
 /** Configuration rides the entry config; edits persist through the settings service. */
-export declare function apply(ctx: Context, config: QuickCommandsSettings): void;
+export declare function apply(ctx: Context, config: QuickCommandsConfig): void;

package/lib/types/server/settings.d.ts

@@ -10,7 +10,7 @@
  * field therefore yields the handle object, which silently destroys the whole
  * document: `Array.isArray(handle)` is false, JSON renders `{}`, and a
  * `.default('corner')` union arrives as the handle rather than a literal.
- * Every read goes through {@link readField} instead, which unwraps handles and
+ * Every read goes through {@link liveValue} instead, which unwraps handles and
  * still accepts plain values (hosts that resolve the config without the
  * volatile wrapper).
  */
@@ -18,7 +18,49 @@ import type { Context } from '@deepseek-ai/cordis';
 import z from '@deepseek-ai/schemastery';
 import type { QuickCommandsSettings, QuickCommandEntry, QuickPopupSize } from '../shared/contract.js';
 export declare const QUICK_COMMANDS_NS = "quick-commands";
-export declare const QuickCommandsSettingsSchema: z<QuickCommandsSettings>;
+/** Live handle schemastery wraps around one `volatile()` config field. */
+interface VolatileField {
+    get(): unknown;
+}
+/**
+ * The entry config in its RESOLVED form: schemastery hands every `.volatile()`
+ * field to the loader (and so to `apply()`) as a live handle instead of the
+ * plain value. This is the schema's real output type.
+ */
+export interface QuickCommandsLiveSettings {
+    workspaces: VolatileField;
+    popupAnchor: VolatileField;
+    popupSize: VolatileField;
+}
+/**
+ * The entry config as `apply()` receives it: the resolved (live) document, or
+ * the plain document in hand-built contexts and hosts that resolve the config
+ * without the volatile wrapper. Both load through the same `apply`.
+ */
+export type QuickCommandsConfig = QuickCommandsSettings | QuickCommandsLiveSettings;
+/**
+ * Entry config schema, and the schema dsh derives the plugin's settings page
+ * from. The `z<...>` annotation names the RESOLVED (live-handle) shape on
+ * purpose:
+ *
+ *  - schemastery >= 3.18.3 carries a third `Mode` type parameter, so a
+ *    `.volatile()` field's OUTPUT type is `Volatile<T>` (a live `{ get() }`
+ *    cell), never `T` — the old `z<QuickCommandsSettings>` annotation stopped
+ *    compiling;
+ *  - dropping the annotation and letting the type be inferred does not build
+ *    either: declaration emit then cannot portably name the inferred type
+ *    (TS2742), because `z.array(...)` leaks `@deepseek-ai/cosmokit`'s `Dict`
+ *    into the schema type while the program holds two schemastery copies
+ *    (this plugin's 3.18.3, and the one `@deepseek-ai/dsh-host-webserver`
+ *    resolves — see pnpm-workspace.yaml's minimumReleaseAgeExclude, which pins
+ *    the former), and cosmokit itself is not nameable from this package.
+ *
+ * The annotation is type-only. At runtime all three fields are still declared
+ * `volatile()` — that is what makes them writable by the settings plane (its
+ * `write()` refuses an entry whose form has no volatile field) and what keeps
+ * the auto-generated page working.
+ */
+export declare const QuickCommandsSettingsSchema: z<QuickCommandsSettings, QuickCommandsLiveSettings>;
 /** Settings service face for the quick-commands engine. */
 export interface QuickCommandsSettingsFace {
     get(): QuickCommandsSettings;
@@ -31,4 +73,5 @@ export interface QuickCommandsSettingsFace {
     /** Persist the output popup size (drag-resize). */
     setPopupSize(size: QuickPopupSize): Promise<void>;
 }
-export declare function registerSettings(ctx: Context, config: QuickCommandsSettings): QuickCommandsSettingsFace;
+export declare function registerSettings(ctx: Context, config: QuickCommandsConfig): QuickCommandsSettingsFace;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fonlan/dsh-quick-commands",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "DSH web plugin: per-workspace quick commands. Configure named shell commands per DSH workspace, run one from the session header with live stdout/stderr in a floating popup.",
   "license": "MIT",
   "repository": {
@@ -44,18 +44,6 @@
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {
-    "build": "rm -rf lib && tsc -p tsconfig.build.json && tsdown",
-    "build:client": "tsdown",
-    "prepare": "npm run build",
-    "typecheck": "tsc --noEmit -p tsconfig.json && tsc --noEmit -p tsconfig.client.json",
-    "test": "node --experimental-transform-types --test test/remote.test.ts test/settings-config.test.ts test/host-apply.test.ts test/shell-path.test.ts && node test/header-icons.test.mjs",
-    "bundle": "tsdown",
-    "watch": "tsdown --watch",
-    "release:patch": "npm version patch && git push && git push --tags",
-    "release:minor": "npm version minor && git push && git push --tags",
-    "release:major": "npm version major && git push && git push --tags"
-  },
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"
@@ -75,33 +63,43 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-client-locale": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-settings": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-subprocess": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-workspace": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-client-locale": "^0.1.2-alpha.2 || ^0.2.0-rc.1 || ^0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.2-alpha.2 || ^0.2.0-rc.1 || ^0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-alpha.2 || ^0.2.0-rc.1 || ^0.2.1-alpha.1",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.2-alpha.2 || ^0.2.0-rc.1 || ^0.2.1-alpha.1",
+    "@deepseek-ai/dsh-settings": "^0.1.2-alpha.2 || ^0.2.0-rc.1 || ^0.2.1-alpha.1",
+    "@deepseek-ai/dsh-subprocess": "^0.1.2-alpha.2 || ^0.2.0-rc.1 || ^0.2.1-alpha.1",
+    "@deepseek-ai/dsh-workspace": "^0.1.2-alpha.2 || ^0.2.0-rc.1 || ^0.2.1-alpha.1",
     "@deepseek-ai/schemastery": "^3.18.2",
     "react": "^18.2.0",
     "react-dom": "^18.2.0"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-client-locale": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-settings-plugins": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-settings": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-subprocess": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-workspace": "^0.1.2-alpha.2",
-    "@deepseek-ai/schemastery": "^3.18.3",
+    "@deepseek-ai/dsh-client-locale": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-ui-settings-plugins": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-ui-slots": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-host-webserver": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-settings": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-subprocess": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-workspace": "0.2.1-alpha.1",
+    "@deepseek-ai/schemastery": "3.18.5-alpha.1",
     "@types/node": "^22.0.0",
     "@types/react": "~18.3.1",
     "@types/react-dom": "~18.3.0",
     "tsdown": "^0.22.14",
     "typescript": "^5.9.0"
   },
-  "packageManager": "pnpm@11.21.0"
-}
+  "scripts": {
+    "build": "rm -rf lib && tsc -p tsconfig.build.json && tsdown",
+    "build:client": "tsdown",
+    "typecheck": "tsc --noEmit -p tsconfig.json && tsc --noEmit -p tsconfig.client.json",
+    "test": "node --experimental-transform-types --test test/remote.test.ts test/settings-config.test.ts test/host-apply.test.ts test/shell-path.test.ts && node test/header-icons.test.mjs",
+    "bundle": "tsdown",
+    "watch": "tsdown --watch",
+    "release:patch": "npm version patch && git push && git push --tags",
+    "release:minor": "npm version minor && git push && git push --tags",
+    "release:major": "npm version major && git push && git push --tags"
+  }
+}

package/src/index.ts

@@ -15,9 +15,8 @@
 import type { Context } from '@deepseek-ai/cordis'
 import { QuickCommandRunner, type RemoteBackend } from './server/runner.js'
 import { readHostConfig } from './server/remote.js'
-import { QuickCommandsSettingsSchema, registerSettings } from './server/settings.js'
+import { QuickCommandsSettingsSchema, registerSettings, type QuickCommandsConfig } from './server/settings.js'
 import { registerApiRoutes } from './server/rpc.js'
-import type { QuickCommandsSettings } from './shared/contract.js'
 
 export const name = '@fonlan/dsh-quick-commands'
 
@@ -30,7 +29,7 @@ export const inject = ['settings']
 export const Config = QuickCommandsSettingsSchema
 
 /** Configuration rides the entry config; edits persist through the settings service. */
-export function apply(ctx: Context, config: QuickCommandsSettings): void {
+export function apply(ctx: Context, config: QuickCommandsConfig): void {
   const settings = registerSettings(ctx, config)
   // dsh >= 0.1.7 activates entries asynchronously: a fiber is only readable as a
   // service once its own init settled, and the webserver's init waits for its

package/src/server/settings.ts

@@ -10,7 +10,7 @@
  * field therefore yields the handle object, which silently destroys the whole
  * document: `Array.isArray(handle)` is false, JSON renders `{}`, and a
  * `.default('corner')` union arrives as the handle rather than a literal.
- * Every read goes through {@link readField} instead, which unwraps handles and
+ * Every read goes through {@link liveValue} instead, which unwraps handles and
  * still accepts plain values (hosts that resolve the config without the
  * volatile wrapper).
  */
@@ -36,7 +36,52 @@ const WorkspaceCommandsSchema = z.object({
   commands: z.array(CommandSchema).max(200),
 })
 
-export const QuickCommandsSettingsSchema: z<QuickCommandsSettings> = z.object({
+/** Live handle schemastery wraps around one `volatile()` config field. */
+interface VolatileField {
+  get(): unknown
+}
+
+/**
+ * The entry config in its RESOLVED form: schemastery hands every `.volatile()`
+ * field to the loader (and so to `apply()`) as a live handle instead of the
+ * plain value. This is the schema's real output type.
+ */
+export interface QuickCommandsLiveSettings {
+  workspaces: VolatileField
+  popupAnchor: VolatileField
+  popupSize: VolatileField
+}
+
+/**
+ * The entry config as `apply()` receives it: the resolved (live) document, or
+ * the plain document in hand-built contexts and hosts that resolve the config
+ * without the volatile wrapper. Both load through the same `apply`.
+ */
+export type QuickCommandsConfig = QuickCommandsSettings | QuickCommandsLiveSettings
+
+/**
+ * Entry config schema, and the schema dsh derives the plugin's settings page
+ * from. The `z<...>` annotation names the RESOLVED (live-handle) shape on
+ * purpose:
+ *
+ *  - schemastery >= 3.18.3 carries a third `Mode` type parameter, so a
+ *    `.volatile()` field's OUTPUT type is `Volatile<T>` (a live `{ get() }`
+ *    cell), never `T` — the old `z<QuickCommandsSettings>` annotation stopped
+ *    compiling;
+ *  - dropping the annotation and letting the type be inferred does not build
+ *    either: declaration emit then cannot portably name the inferred type
+ *    (TS2742), because `z.array(...)` leaks `@deepseek-ai/cosmokit`'s `Dict`
+ *    into the schema type while the program holds two schemastery copies
+ *    (this plugin's 3.18.3, and the one `@deepseek-ai/dsh-host-webserver`
+ *    resolves — see pnpm-workspace.yaml's minimumReleaseAgeExclude, which pins
+ *    the former), and cosmokit itself is not nameable from this package.
+ *
+ * The annotation is type-only. At runtime all three fields are still declared
+ * `volatile()` — that is what makes them writable by the settings plane (its
+ * `write()` refuses an entry whose form has no volatile field) and what keeps
+ * the auto-generated page working.
+ */
+export const QuickCommandsSettingsSchema: z<QuickCommandsSettings, QuickCommandsLiveSettings> = z.object({
   // Values are addressed by index (array edits), so the whole array is the
   // volatile handle the settings plane swaps in place.
   workspaces: z.array(WorkspaceCommandsSchema).max(500).volatile(),
@@ -51,22 +96,22 @@ export const QuickCommandsSettingsSchema: z<QuickCommandsSettings> = z.object({
   }).volatile(),
 })
 
-/** Live handle schemastery wraps around one `volatile()` config field. */
-interface VolatileField<T> {
-  get(): T
-}
-
 /**
- * Read one config field. A volatile field arrives as a handle (dsh >= 0.1.7)
- * and is read through `.get()` on EVERY access, so edits made through the
- * settings plane are visible immediately; hosts that hand the plain value keep
- * working unchanged.
+ * Read a config node that may be a plain value or a live (`.volatile()`) node.
+ *
+ * A plugin whose Config declares volatile fields receives a reactive config
+ * whose fields expose `get()`, while hand-written config objects and tests pass
+ * plain values. Both shapes are supported here so the same code path serves the
+ * settings page, `cordis.patch.yml`, and the unit tests.
  */
-function readField<T>(field: unknown, fallback: T): T {
-  if (field === undefined || field === null) return fallback
-  const handle = field as Partial<VolatileField<T>>
-  const value = typeof handle.get === 'function' ? handle.get() : (field as T)
-  return value === undefined || value === null ? fallback : value
+function liveValue<T>(node: unknown, fallback: T): T {
+  if (node === undefined || node === null) return fallback
+  const getter = (node as { get?: unknown }).get
+  if (typeof getter === 'function') {
+    const value = (getter as () => unknown).call(node)
+    return value === undefined ? fallback : (value as T)
+  }
+  return node as T
 }
 
 /** Structural settings-service subset used for persistence. */
@@ -87,15 +132,15 @@ export interface QuickCommandsSettingsFace {
   setPopupSize(size: QuickPopupSize): Promise<void>
 }
 
-export function registerSettings(ctx: Context, config: QuickCommandsSettings): QuickCommandsSettingsFace {
+export function registerSettings(ctx: Context, config: QuickCommandsConfig): QuickCommandsSettingsFace {
   const readWorkspaces = (): WorkspaceCommands[] => {
-    const value = readField<unknown>(config?.workspaces, [])
+    const value = liveValue<unknown>(config?.workspaces, [])
     return Array.isArray(value) ? value as WorkspaceCommands[] : []
   }
   const readAnchor = (): QuickCommandsSettings['popupAnchor'] =>
-    (readField<unknown>(config?.popupAnchor, 'corner') === 'button' ? 'button' : 'corner')
+    (liveValue<unknown>(config?.popupAnchor, 'corner') === 'button' ? 'button' : 'corner')
   const readPopupSize = (): QuickPopupSize | undefined => {
-    const value = readField<unknown>(config?.popupSize, undefined)
+    const value = liveValue<unknown>(config?.popupSize, undefined)
     if (typeof value !== 'object' || value === null) return undefined
     const { width, height } = value as { width?: unknown; height?: unknown }
     // `{}` (never resized) and any partially written size read as absent.