dsh-panel-hello 1.0.0

package/README.md

@@ -0,0 +1,57 @@
+# dsh-panel-hello
+
+A tiny [DeepSeek Harness](https://github.com/deepseek-ai/DeepSeek-Harness) web
+plugin example: a floating panel in the bottom-right of the dsh web UI that
+displays **hello! word~**.
+
+## What it is
+
+- A **profile plugin bundle**: `dsh.bundle.patch` points at `cordis.patch.yml`,
+  which inserts the `panel-hello` row into the host composition.
+- A **web client plugin**: the package manifest declares
+  `dsh.client.platform: "web"` and exports `./client`, so
+  `@deepseek-ai/dsh-client-modules` serves `lib/client.js` to the browser and
+  the shell mounts it. The bundle registers a React card into the
+  `shell.overlay` slot — a list seat that floats above every column and is
+  purely additive (it never replaces a shipped surface).
+
+No build step: `lib/client.js` is already in the exact
+`window.__ModuleLoader__.load({ id, factory })` format the web shell loads,
+and the plugin has zero dependencies (`require("react")` resolves from the
+shell's module table).
+
+## Install
+
+```bash
+# local checkout / this example:
+dsh plugin --profile web add ./dsh-panel-hello
+
+# once published to npm, anyone can:
+dsh plugin --profile web add dsh-panel-hello
+```
+
+`dsh plugin` forwards to pnpm in the profile directory and reconciles
+`dsh.profile.bundles`, so the bundle patch applies on the next boot.
+
+## Activate
+
+Plugin-set changes take effect on restart (client bundles are composed into
+`window.__DSH_BOOT__` at boot). Restart the web app, then hard-refresh the
+page: a card pinned to the bottom-right shows **hello! word~**.
+
+## Layout
+
+```
+dsh-panel-hello/
+  package.json        # dsh.bundle.patch + dsh.client.platform: web + exports ./client
+  cordis.patch.yml    # inserts the host-composition row
+  lib/index.js        # host half (no host behavior — browser-only plugin)
+  lib/client.js       # browser half: the panel bundle (this is the shipped format)
+  README.md
+```
+
+## Remove
+
+```bash
+dsh plugin --profile web remove dsh-panel-hello
+```

package/cordis.patch.yml

@@ -0,0 +1,5 @@
+# dsh-panel-hello bundle patch: add the plugin row to the host composition.
+# Applied as a profile layer when the package is installed via `dsh plugin add`.
+- insert:
+    - id: panel-hello
+      name: 'dsh-panel-hello'

package/lib/client.js

@@ -0,0 +1,74 @@
+// dsh-panel-hello client bundle: a floating panel in the DeepSeek Harness web UI.
+//
+// This IS the shipped bundle format the web shell expects (see the
+// @deepseek-ai/dsh-client-modules contract): a module registered through
+// window.__ModuleLoader__.load({ id, factory }) whose factory `require`s its
+// dependencies from the shell's module table and returns the plugin's module
+// exports (apply + inject). No build step is required for this example —
+// zero dependencies, so the factory body IS the bundle.
+window.__ModuleLoader__.load({
+	id: "dsh-panel-hello",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+
+		const react = require("react");
+
+		// A small card pinned to the bottom-right of the frame. It rides the
+		// frame-wide `shell.overlay` seat (declared by ui-layout), which floats
+		// above every column at z-index 20; the card positions itself inside that
+		// layer, so no global z-index fight is needed.
+		function HelloPanel() {
+			return react.createElement(
+				"div",
+				{
+					"data-hello-panel": true,
+					style: {
+						position: "absolute",
+						right: "16px",
+						bottom: "16px",
+						padding: "14px 18px",
+						borderRadius: "12px",
+						background: "var(--dsw-alias-button-elevated-fill, #1e293b)",
+						color: "var(--dsw-alias-label-primary, #f8fafc)",
+						border: "1px solid var(--dsw-alias-border-l2, rgba(255,255,255,0.12))",
+						boxShadow: "0 6px 24px rgba(0, 0, 0, 0.35)",
+						fontFamily: "inherit",
+						fontSize: "14px",
+						lineHeight: "20px",
+						userSelect: "none"
+					}
+				},
+				react.createElement(
+					"div",
+					{ style: { fontWeight: 600, fontSize: "13px", opacity: 0.75, marginBottom: "4px", letterSpacing: "0.02em" } },
+					"Hello Panel"
+				),
+				react.createElement("div", { style: { fontWeight: 500 } }, "hello! word~")
+			);
+		}
+
+		const inject = ["slots"];
+
+		function apply(ctx) {
+			// Wait for ui-layout to declare `shell.overlay`, then register this
+			// entry. `shell.overlay` is a list slot, so the panel is additive —
+			// it never shadows or replaces any shipped surface.
+			ctx.effect(
+				() =>
+					ctx.slots.inject("shell.overlay", () =>
+						ctx.slots.register(
+							{ name: "shell.overlay", id: "dsh-panel-hello", order: 100 },
+							HelloPanel
+						)
+					),
+				"dsh-panel-hello: register hello panel"
+			);
+		}
+
+		exports.apply = apply;
+		exports.inject = inject;
+		return module.exports;
+	}
+});

package/lib/index.js

@@ -0,0 +1,4 @@
+/** Host loader entry for the browser-only hello panel plugin. */
+/** Provides no host-side behavior. */
+function apply() {}
+export { apply };

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "dsh-panel-hello",
+  "version": "1.0.0",
+  "description": "A tiny DeepSeek Harness web plugin example: a floating panel in the web UI that says hello! word~",
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "README.md"
+  ],
+  "license": "MIT",
+  "keywords": [
+    "deepseek-harness",
+    "dsh",
+    "plugin",
+    "cordis"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web"
+    }
+  }
+}