dsh-quick-toc 0.5.0 → 0.6.0

package/lib/index.js

@@ -1,8 +1,65 @@
 /**
- * dsh-outline node half. Pure UI plugin: the empty apply exists so the
- * plugin appears in the host loader (load and lifecycle follow the host);
- * the browser half ships via exports["./client"], discovered through the
- * package.json dsh.client declaration.
+ * dsh-quick-toc host half.
+ *
+ * One job: register the `dsh-quick-toc` settings namespace so the panel's
+ * preferences live in the Host settings document and the plugin gets a card in
+ * Settings → Plugins → Plugin configuration. The browser half owns both the
+ * card and the panel; nothing here consumes the values.
+ *
+ * The composition entry is the base layer, so a value the user clears falls
+ * back to the schema defaults rather than to nothing.
+ *
+ * @module dsh-quick-toc
  */
-function apply() {}
-export { apply };
+import z from "@deepseek-ai/schemastery";
+
+/** Namespace the browser half binds and the card is keyed on. */
+export const NAMESPACE = "dsh-quick-toc";
+
+/**
+ * The durable settings section. Values are written by the browser half's card
+ * (and by the panel itself), so the schema is the validation layer, not a form.
+ */
+export const Config = z.object({
+  lang: z
+    .string()
+    .pattern(/^(auto|zh|en)$/)
+    .default("auto")
+    .description("Panel language: auto follows DSH, zh or en forces one"),
+  dock: z
+    .string()
+    .pattern(/^(left|right)$/)
+    .default("left")
+    .description("Which edge the panel docks to by default"),
+  levels: z
+    .array(z.number().min(1).max(6))
+    .default([1, 2, 3, 4, 5, 6])
+    .description("Heading levels the outline shows"),
+  fuzzy: z
+    .boolean()
+    .default(false)
+    .description("Start with fuzzy search on"),
+  hover: z
+    .boolean()
+    .default(true)
+    .description("Show the hover preview card"),
+  debug: z
+    .boolean()
+    .default(false)
+    .description("Print the mount diagnostic to the browser console"),
+});
+
+/**
+ * Register the settings section. The values themselves are read and written by
+ * the browser half through the client settings scope.
+ * @param {object} ctx - host cordis context.
+ * @param {object} [config] - the plugin entry's composition config (base layer).
+ */
+export function apply(ctx, config) {
+  ctx.inject(["settings"], (settingsCtx) => {
+    settingsCtx.settings.installSection(ctx, NAMESPACE, Config, config ?? {}, {
+      setSource: () => {},
+      onChange: () => {},
+    });
+  });
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-quick-toc",
-  "version": "0.5.0",
-  "description": "Conversation TOC for DeepSeek Harness (DSH): turn-grouped Markdown outline covering the whole session (unloaded turns included), title/full-text search with an optional fuzzy switch, hover previews, in-chat match highlighting, heading-level filter and reading-position auto-follow",
+  "version": "0.6.0",
+  "description": "Conversation TOC for DeepSeek Harness (DSH): turn-grouped Markdown outline covering the whole session (unloaded turns included), title/full-text search with an optional fuzzy switch, hover previews, in-chat match highlighting, heading-level filter, reading-position auto-follow, a Chinese/English interface and a plugin-configuration card",
   "type": "module",
   "main": "lib/index.js",
   "files": [
@@ -42,9 +42,15 @@
   },
   "peerDependencies": {
     "react": "^18.2.0",
+    "@deepseek-ai/schemastery": "^3.18.0",
     "@deepseek-ai/dsh-client-ui-chat": ">=0.1.5-rc.1",
     "@deepseek-ai/dsh-client-ui-conversation": ">=0.1.5-rc.1"
   },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/schemastery": {
+      "optional": true
+    }
+  },
   "license": "MIT",
   "keywords": [
     "dsh",