dsh-quick-toc 0.7.1 → 0.7.3

package/lib/client.js

@@ -159,6 +159,8 @@ window.__ModuleLoader__.load({
         "settings.levels": "显示的标题层级",
         "settings.zoom": "面板缩放",
         "settings.zoom.tip": "文字、图标与按钮按比例缩放，面板本身的尺寸不变",
+        "settings.sheetZoom": "幕布缩放",
+        "settings.sheetZoom.tip": "幕布里的文字、图标与按钮按比例缩放，幕布本身的尺寸不变",
         "settings.handle": "把手位置",
         "settings.handle.tip": "收起面板后，边缘把手在对话区里的上下位置（0% 最下、100% 最上）",
         "settings.on": "开启",
@@ -255,6 +257,8 @@ window.__ModuleLoader__.load({
         "settings.levels": "Heading levels shown",
         "settings.zoom": "Panel scale",
         "settings.zoom.tip": "Scales the text, icons and buttons; the panel's own size is unchanged",
+        "settings.sheetZoom": "Curtain scale",
+        "settings.sheetZoom.tip": "Scales the curtain's text, icons and buttons; the curtain's own size is unchanged",
         "settings.handle": "Handle position",
         "settings.handle.tip": "Where the collapsed-panel handle sits vertically (0% bottom, 100% top of the conversation area)",
         "settings.on": "On",
@@ -335,13 +339,13 @@ window.__ModuleLoader__.load({
     // purpose — they describe THIS screen, not the account.
     var NAMESPACE = "dsh-quick-toc";
     // Fields backed by the Host settings document; everything else is localStorage.
-    var HOST_FIELDS = { dock: 1, lang: 1, levels: 1, zoom: 1, handle: 1, fuzzy: 1, hover: 1, debug: 1, remember: 1, autoLoad: 1 };
+    var HOST_FIELDS = { dock: 1, lang: 1, levels: 1, zoom: 1, sheetZoom: 1, handle: 1, fuzzy: 1, hover: 1, debug: 1, remember: 1, autoLoad: 1 };
     // The schema defaults (mirrored here for the card's per-field reset and for the
     // one-time import of a 0.5.x install's stored values).
     var DEFAULTS = {
       dock: "left", y: 0, w: 0, h: 0,
       levels: [1, 2, 3, 4, 5, 6],
-      zoom: 1, handle: 0.5,
+      zoom: 1, sheetZoom: 1, handle: 0.5,
       fuzzy: false, hover: true, lang: "auto", debug: false,
       remember: true, autoLoad: true
     };
@@ -352,6 +356,7 @@ window.__ModuleLoader__.load({
       h: "dsh-quick-toc.panelH.v1",
       levels: "dsh-quick-toc.levels.v1",
       zoom: "dsh-quick-toc.zoom.v1",
+      sheetZoom: "dsh-quick-toc.sheetZoom.v1",
       handle: "dsh-quick-toc.handle.v1",
       fuzzy: "dsh-quick-toc.fuzzy.v1",
       hover: "dsh-quick-toc.hover.v1",
@@ -471,6 +476,7 @@ window.__ModuleLoader__.load({
         var hRaw = read(PREF_KEYS.h);
         var langRaw = read(PREF_KEYS.lang);
         var zoomRaw = read(PREF_KEYS.zoom); // NB: absent (null) means 1 — Number(null) is 0!
+        var sheetZoomRaw = read(PREF_KEYS.sheetZoom); // same trap
         var handleRaw = read(PREF_KEYS.handle); // absent (null) means 0.5 — same trap
         var clampRatio = function (raw, fallback) {
           return raw !== null && isFinite(Number(raw)) ? Math.min(1, Math.max(0, Math.round(Number(raw) * 100) / 100)) : fallback;
@@ -483,6 +489,7 @@ window.__ModuleLoader__.load({
           h: hRaw !== null && isFinite(Number(hRaw)) && Number(hRaw) >= 60 ? Number(hRaw) : 0,
           levels: parseLevels(rawLevels) || LEVELS_ALL.slice(),
           zoom: clampRatio(zoomRaw, 1),
+          sheetZoom: clampRatio(sheetZoomRaw, 1),
           handle: clampRatio(handleRaw, 0.5),
           fuzzy: read(PREF_KEYS.fuzzy) === "1",
           // absent means "on": the hover card predates this switch
@@ -503,6 +510,7 @@ window.__ModuleLoader__.load({
           h: function (v) { return String(v); },
           levels: function (v) { return JSON.stringify(v); },
           zoom: function (v) { return String(v); },
+          sheetZoom: function (v) { return String(v); },
           handle: function (v) { return String(v); },
           fuzzy: function (v) { return v ? "1" : "0"; },
           hover: function (v) { return v ? "1" : "0"; },
@@ -529,12 +537,14 @@ window.__ModuleLoader__.load({
         var v = snap.value;
         var levels = parseLevelList(v.levels);
         var zoomNum = Number(v.zoom);
+        var sheetZoomNum = Number(v.sheetZoom);
         var handleNum = Number(v.handle);
         return {
           dock: v.dock === "right" ? "right" : "left",
           lang: v.lang === "zh" || v.lang === "en" ? v.lang : "auto",
           levels: levels || LEVELS_ALL.slice(),
           zoom: isFinite(zoomNum) ? Math.min(2, Math.max(0.5, Math.round(zoomNum * 100) / 100)) : 1,
+          sheetZoom: isFinite(sheetZoomNum) ? Math.min(2, Math.max(0.5, Math.round(sheetZoomNum * 100) / 100)) : 1,
           handle: isFinite(handleNum) ? Math.min(1, Math.max(0, Math.round(handleNum * 100) / 100)) : 0.5,
           fuzzy: v.fuzzy === true,
           hover: v.hover !== false,
@@ -549,7 +559,7 @@ window.__ModuleLoader__.load({
         if (!over) return local;
         return {
           dock: over.dock, y: local.y, w: local.w, h: local.h,
-          levels: over.levels, zoom: over.zoom, handle: over.handle, fuzzy: over.fuzzy, hover: over.hover,
+          levels: over.levels, zoom: over.zoom, sheetZoom: over.sheetZoom, handle: over.handle, fuzzy: over.fuzzy, hover: over.hover,
           lang: over.lang, remember: over.remember, debug: over.debug, autoLoad: over.autoLoad
         };
       };
@@ -1441,6 +1451,17 @@ window.__ModuleLoader__.load({
           return null;
         }
       };
+      // { uiWorkspace() } bridge: the workspace-navigation service that switches sessions on
+      // the alpha (`uiWorkspace.openSession(target)`); rc.2 has no such service and switches
+      // through `sessions.open`. Same lookup discipline as the session bridge.
+      var hostUiWorkspace = function () {
+        if (!tocHost || typeof tocHost.uiWorkspace !== "function") return null;
+        try {
+          return tocHost.uiWorkspace();
+        } catch (e) {
+          return null;
+        }
+      };
       // Which stage of the bridge is actually ready — reported once at mount so a
       // missing jump loader can be diagnosed from the console instead of guessed.
       // Past "the loader exists" the PAGE STATE is what decides whether a jump can do
@@ -1827,7 +1848,7 @@ window.__ModuleLoader__.load({
         if (node) {
           // put that row back where it SAT (not necessarily at the top): a row the reader left
           // clipped by 120px goes home clipped by 120px, so the view lands exactly where it was
-          var d = (node.getBoundingClientRect().top - el.getBoundingClientRect().top) - tgt.off;
+          var d = ((node.getBoundingClientRect().top - el.getBoundingClientRect().top) - tgt.off) / liveZoom();
           if (Math.abs(d) > 0.5) el.scrollTop = el.scrollTop + d;
         }
         syncAtBottom(el);
@@ -2510,14 +2531,17 @@ window.__ModuleLoader__.load({
         if (!node) { sampleAnchor(el); return false; }
         var top = node.getBoundingClientRect().top;
         var moved = el.scrollTop - a.scrollTop;   // what the reader (or a jump) scrolled
+        var zf = liveZoom();
         // Growth above the anchor moves it DOWN by exactly as much as the content grew; the
         // reader scrolling up moves it down by exactly as much as they scrolled. Both happen
         // at once when a page lands mid-gesture, so subtract the reader's part rather than
         // refusing to compensate — the old "scrollTop changed, so the reader moved, skip"
         // guard is exactly why a load landing during a scroll was still seen pushing the
         // list. (The list carries `overflow-anchor: none`, so the browser is not adjusting
-        // `scrollTop` behind our back and this sum stays honest.)
-        var grew = (top - a.top) + moved;
+        // `scrollTop` behind our back and this sum stays honest.) The measured growth is in
+        // visual pixels while `moved` is already in the scroller's own units, so the growth
+        // term is divided by the live factor.
+        var grew = (top - a.top) / zf + moved;
         if (Math.abs(grew) < 0.5 || Math.abs(grew) > (el.clientHeight || 0) * 3) {
           // nothing grew — or something absurd happened (a repaged list, a session swap):
           // re-baseline instead of chasing it
@@ -2532,7 +2556,7 @@ window.__ModuleLoader__.load({
           return false;
         }
         a.scrollTop = el.scrollTop;
-        a.top = top - grew;    // the offset the anchor keeps from now on
+        a.top = top - grew * zf;    // the visual offset the anchor keeps from now on
         return true;
       };
       var holdPlace = function (el) { sampleAnchor(el); };
@@ -2880,6 +2904,28 @@ window.__ModuleLoader__.load({
         if (zoom === 1) return typeof v === "number" ? v + "px" : v;
         return typeof v === "number" ? (v / zoom) + "px" : "calc(" + v + " / " + zoom + ")";
       };
+      // The curtain carries its OWN scale: the docked panel's factor does not apply to it,
+      // and a reader who wants a dense outline in the dock and a larger one across the
+      // curtain (or the other way round) gets two independent sliders.
+      //
+      // The slider's 100% is 0.9 of the size the curtain had before this setting existed: the
+      // reader asked for that base once they could compare it with a scaled one, and 100% is
+      // still what the card reads at the default — the mapping is re-based here instead of
+      // shipping a slider whose default reads 90%, so a stored factor keeps meaning the same
+      // fraction of this base.
+      var SHEET_ZOOM_BASE = 0.9;
+      var sheetZoom = (prefs.sheetZoom > 0 ? prefs.sheetZoom : 1) * SHEET_ZOOM_BASE;
+      // Whichever surface is on screen owns the coordinate space the list lives in: the
+      // scroller's scrollTop is in the zoomed space while getBoundingClientRect reports
+      // visual pixels, so a measured delta has to be divided by THAT factor before it is
+      // written back as a scroll offset (and a CSS length written inside the surface is
+      // divided so it keeps its visual size).
+      var liveZoom = function () { return sheetOpen ? sheetZoom : zoom; };
+      var liveLen = function (v) {
+        var f = liveZoom();
+        if (f === 1) return typeof v === "number" ? v + "px" : v;
+        return typeof v === "number" ? (v / f) + "px" : "calc(" + v + " / " + f + ")";
+      };
 
       // ---- resize drags (right edge = width, bottom edge = height) ----
       // No upper bound and only a keep-it-usable floor: the reader decides how small
@@ -3397,7 +3443,8 @@ window.__ModuleLoader__.load({
             // why the follow stopped "a little short of the bottom": for the newest turn the
             // centre is above the end of the list, so the scroll landed half a viewport early.
             // Aligning to the top needs no clamp at all — the list's own end does the work.
-            var delta = node.getBoundingClientRect().top - el.getBoundingClientRect().top;
+            // (Rects are visual; the factor turns the delta back into the scroller's units.)
+            var delta = (node.getBoundingClientRect().top - el.getBoundingClientRect().top) / liveZoom();
             if (Math.abs(delta) > 1) el.scrollTop = el.scrollTop + delta;
           };
           followFrame = requestAnimationFrame(function () { followFrame = requestAnimationFrame(place); });
@@ -3557,9 +3604,33 @@ window.__ModuleLoader__.load({
       // clicking a cross-session hit: switch the session, then leave the keyword for
       // the panel that comes up (see pendingLocate) — the host hit has no seq, so the
       // jump happens on the other side, after the same search runs there.
-      var openCrossHit = function (hitSessionId) {
+      //
+      // Two dialects again: rc.2 switches sessions with `sessions.open(id)`, while the
+      // alpha moved that decision to the workspace navigation service
+      // (`uiWorkspace.openSession(target)`) and dropped `open` from the session service
+      // altogether. Both are optional lookups, so whatever the host offers is used and a
+      // host offering neither says so instead of doing nothing.
+      var openSessionById = function (id) {
+        var uiWorkspace = hostUiWorkspace();
+        if (uiWorkspace && typeof uiWorkspace.openSession === "function") {
+          uiWorkspace.openSession(id);
+          return true;
+        }
         var sessions = hostSessions();
-        if (!sessions || typeof sessions.open !== "function") {
+        if (sessions && typeof sessions.open === "function") {
+          sessions.open(id);
+          return true;
+        }
+        return false;
+      };
+      var canOpenSession = function () {
+        var uiWorkspace = hostUiWorkspace();
+        if (uiWorkspace && typeof uiWorkspace.openSession === "function") return true;
+        var sessions = hostSessions();
+        return !!(sessions && typeof sessions.open === "function");
+      };
+      var openCrossHit = function (hitSessionId) {
+        if (!canOpenSession()) {
           showBanner(T("search.cross.unavailable"));
           return;
         }
@@ -3570,7 +3641,7 @@ window.__ModuleLoader__.load({
         }
         pendingLocate = { sessionId: hitSessionId, query: query.trim(), at: Date.now() };
         try {
-          sessions.open(hitSessionId);
+          openSessionById(hitSessionId);
         } catch (e) {
           pendingLocate = null;
           showBanner(T("search.cross.error") + String(e && e.message ? e.message : e));
@@ -4368,7 +4439,8 @@ window.__ModuleLoader__.load({
         if (!el) return false;
         var node = el.querySelector('[data-group-idx="' + gi + '"]');
         if (!node) return false;
-        var delta = node.getBoundingClientRect().top - el.getBoundingClientRect().top;
+        // the rects are visual: divide by the live factor before writing a scroll offset
+        var delta = (node.getBoundingClientRect().top - el.getBoundingClientRect().top) / liveZoom();
         if (Math.abs(delta) > 0.5) el.scrollTop = el.scrollTop + delta;
         return true;
       };
@@ -5429,9 +5501,9 @@ window.__ModuleLoader__.load({
           if (root && typeof root.focus === "function") root.focus();
         },
         style: sheetOpen ? {
-          // inside the sheet the panel IS the content: the wrapper owns position,
-          // size and the drop-in animation, and the content renders at 100% (the
-          // panel-scale preference is a docked-panel setting, not a sheet one)
+          // inside the sheet the panel IS the content: the wrapper owns position, size and
+          // the drop-in animation, while the curtain's own scale (a separate preference)
+          // zooms what is inside it — the box the wrapper gives it stays as it is
           position: "relative",
           width: "100%",
           flex: "1 1 auto",
@@ -5445,6 +5517,8 @@ window.__ModuleLoader__.load({
           overflow: "hidden",
           color: C.text,
           opacity: 1,
+          // the curtain's own scale (the docked panel's does not apply here)
+          zoom: sheetZoom === 1 ? undefined : sheetZoom,
           pointerEvents: chatViewActive ? "auto" : "none"
         } : {
           position: "fixed",
@@ -5611,8 +5685,9 @@ window.__ModuleLoader__.load({
             style: {
               position: "absolute",
               right: (sheetOpen && sheetColW > 0 ? SHEET_SEARCH_W : 0) + 18,
-              // below whatever chrome this surface has (measured, see listTop)
-              top: listTop + 12,
+              // below whatever chrome this surface has: `listTop` is measured in visual
+              // pixels, so it is divided by the live factor to land where it was measured
+              top: liveLen(listTop + 12),
               width: sheetOpen ? 34 : 26,
               height: sheetOpen ? 34 : 26,
               display: "flex",
@@ -6859,15 +6934,18 @@ window.__ModuleLoader__.load({
       var sliderAwaiting = react.useRef({});
       var commitSlider = function (field, pct) {
         sliderAwaiting.current[field] = pct;
-        commit(field === "zoom" ? { zoom: pct / 100 } : { handle: pct / 100 });
+        commit(field === "zoom" ? { zoom: pct / 100 }
+          : field === "sheetZoom" ? { sheetZoom: pct / 100 }
+            : { handle: pct / 100 });
       };
       react.useEffect(function () {
         var a = sliderAwaiting.current;
         var settled = false;
         if (a.zoom !== undefined && Math.round(prefs.zoom * 100) === a.zoom) { delete a.zoom; settled = true; }
+        if (a.sheetZoom !== undefined && Math.round(prefs.sheetZoom * 100) === a.sheetZoom) { delete a.sheetZoom; settled = true; }
         if (a.handle !== undefined && Math.round(prefs.handle * 100) === a.handle) { delete a.handle; settled = true; }
         if (settled) setSliderDrag(null);
-      }, [prefs.zoom, prefs.handle]);
+      }, [prefs.zoom, prefs.sheetZoom, prefs.handle]);
       react.useEffect(function () {
         if (sliderDrag === null) return undefined;
         var release = function () {
@@ -6917,6 +6995,7 @@ window.__ModuleLoader__.load({
         });
       };
       var zoomControl = sliderCtl("zoom", "settings.zoom", 50, 200, 5, Math.round(prefs.zoom * 100));
+      var sheetZoomControl = sliderCtl("sheetZoom", "settings.sheetZoom", 50, 200, 5, Math.round(prefs.sheetZoom * 100));
       var handleControl = sliderCtl("handle", "settings.handle", 0, 100, 1, Math.round(prefs.handle * 100));
       var field = function (key, label, hint, control, inline, last) {
         var overridden = Object.prototype.hasOwnProperty.call(user, key);
@@ -6978,6 +7057,7 @@ window.__ModuleLoader__.load({
             function (v) { commit({ dock: v }); }), true),
         field("levels", T("settings.levels"), "", levelsControl(true), true),
         field("zoom", T("settings.zoom"), T("settings.zoom.tip"), zoomControl, false),
+        field("sheetZoom", T("settings.sheetZoom"), T("settings.sheetZoom.tip"), sheetZoomControl, false),
         field("handle", T("settings.handle"), T("settings.handle.tip"), handleControl, false),
         field("fuzzy", T("settings.fuzzy"), "", onoff(prefs.fuzzy, function (v) { commit({ fuzzy: v }); }), true),
         field("hover", T("settings.hover"), "", onoff(prefs.hover, function (v) { commit({ hover: v }); }), true),
@@ -7029,7 +7109,10 @@ window.__ModuleLoader__.load({
       });
     }
 
-    var inject = ["slots", "locale", "settingsScope"];
+    // Declared client services only. `slots` and `locale` exist on every supported line;
+    // the settings service is looked up with `ctx.get` instead (see `pickSettingsScope`),
+    // because declaring a name a host does not provide parks the whole package.
+    var inject = ["slots", "locale"];
 
     function apply(ctx) {
       ctx.effect(function () {
@@ -7094,6 +7177,16 @@ window.__ModuleLoader__.load({
           } catch (e) {
             return null;
           }
+        },
+        // The alpha's session navigation (uiWorkspace.openSession); the older line has no
+        // such service and switches sessions through `sessions.open` instead. Optional by
+        // the same rule: whichever exists is used, and neither existing is reported.
+        uiWorkspace: function () {
+          try {
+            return typeof ctx.get === "function" ? (ctx.get("uiWorkspace") || null) : null;
+          } catch (e) {
+            return null;
+          }
         }
       };
 
@@ -7114,15 +7207,86 @@ window.__ModuleLoader__.load({
         });
       });
 
-      // The client settings scope: the browser face of the namespace the host half
-      // registers. The store adopts its snapshot as the authoritative layer for the
-      // host-backed fields and routes writes to it; on a host without the service (or
+      // The client settings scope: the browser face of the settings namespace the host
+      // half serves. The store adopts its snapshot as the authoritative layer for the
+      // host-backed fields and routes writes to it; on a host without either dialect (or
       // on a non-loopback page, where DSH keeps settings read-only) the localStorage
       // mirror keeps every preference working, exactly as 0.5.x did.
-      var boundScope = null;
-      if (ctx.settingsScope && typeof ctx.settingsScope.bind === "function") {
+      //
+      // TWO DIALECTS, ONE SHAPE. Up to DSH 0.1.5-rc.2 the host serves a
+      // `settingsScope` service whose `bind({namespace})` returns a namespace scope; from
+      // 0.1.7-alpha.1 on, that service is gone and the same object is handed out by the
+      // `configForms` service per PROFILE ENTRY ID (`get(id)`). Both expose
+      // `getSnapshot()` / `mutate(ops)` / `unset(field)` over the same snapshot fields, so
+      // one adapter covers them.
+      //
+      // Neither is declared in `inject`: a name the running host does not provide parks
+      // the whole package until it appears, and on 0.1.7-alpha.1 that turned into a web
+      // boot that never finished (`1 entry did not activate: dsh-quick-toc: pending
+      // (waiting for service: settingsScope)`), taking the entire GUI with it. Both
+      // declaration-free routes are tried — `ctx.get(name)` first, then the service
+      // property the older line has always offered — and a missing service simply leaves
+      // the localStorage layer in charge.
+      var getService = function (name) {
+        try {
+          if (typeof ctx.get === "function") {
+            var found = ctx.get(name);
+            if (found) return found;
+          }
+        } catch (e) { /* fall through to the property read */ }
+        try {
+          return ctx[name] || null;
+        } catch (e) {
+          return null;
+        }
+      };
+      // Which namespace the `configForms` dialect should be asked for. Its key is the
+      // profile entry id, which the installing profile's patch decides (this package's own
+      // cordis.patch.yml inserts the row as `quick-toc`), so the served schema is what
+      // identifies us: a namespace carrying this plugin's own fields is ours whatever it
+      // is called.
+      var formsNamespace = function (forms) {
+        var candidates = ["quick-toc", "dsh-quick-toc"];
+        var served = [];
+        try {
+          var view = forms.describe ? forms.describe().getSnapshot().view : null;
+          served = (view && view.namespaces) || [];
+        } catch (e) {
+          served = [];
+        }
+        for (var i = 0; i < served.length; i++) {
+          var ns = served[i] || {};
+          var json = "";
+          try { json = JSON.stringify(ns.schema || {}); } catch (e) { json = ""; }
+          if (json.indexOf("sheetZoom") >= 0 && json.indexOf("autoLoad") >= 0) return ns.ns;
+        }
+        for (var j = 0; j < candidates.length; j++) {
+          try {
+            var form = forms.get(candidates[j]);
+            if (form && form.getSnapshot && form.getSnapshot().status === "ready") return candidates[j];
+          } catch (e) { /* try the next candidate */ }
+        }
+        return candidates[0];
+      };
+      var pickSettingsScope = function () {
+        var scope = getService("settingsScope");
+        if (scope && typeof scope.bind === "function") {
+          try {
+            var bound = scope.bind({ namespace: NAMESPACE });
+            if (bound) return bound;
+          } catch (e) { /* fall through to the newer dialect */ }
+        }
+        var forms = getService("configForms");
+        if (forms && typeof forms.get === "function") {
+          try {
+            return forms.get(formsNamespace(forms));
+          } catch (e) { /* leave the localStorage layer in charge */ }
+        }
+        return null;
+      };
+      var boundScope = pickSettingsScope();
+      if (boundScope) {
         try {
-          boundScope = ctx.settingsScope.bind({ namespace: NAMESPACE });
           prefsStore.attachHost(boundScope);
         } catch (e) {
           boundScope = null;
@@ -7130,11 +7294,26 @@ window.__ModuleLoader__.load({
         }
       }
 
-      // The plugin-configuration card: Settings → Plugins → Plugin configuration, a
-      // keyed slot dispatched only for namespaces the Host actually serves. Registering
-      // it only when the scope bound keeps a half-configured host from rendering a card
-      // that could not read or write anything.
+      // The plugin-configuration card, in whichever seat the running host offers:
+      //  * up to rc.2 it is a keyed `settings.plugin.item` cell under
+      //    Settings → Plugins → Plugin configuration, keyed by the settings namespace;
+      //  * on the alpha the plugin's own page in the sidebar's Plugins list carries it,
+      //    as the bundle's configuration keyed by the npm package name
+      //    (`plugins.bundle.config`). A row-level cell (`plugins.row.config`, keyed
+      //    `<package>#<row id>`) exists too, but a registration there did not reach that
+      //    page in 0.1.7-alpha.1 while the bundle cell did — and these preferences are the
+      //    plugin's, not one row's, so the bundle page is the right seat anyway.
+      // Registering into a slot a given host never declares is inert (the registration
+      // waits), so both are offered unconditionally, and only once a scope bound keeps a
+      // half-configured host from rendering a card that could not read or write anything.
       if (boundScope) {
+        ctx.slots.inject("plugins.bundle.config", function () {
+          return ctx.slots.register({
+            name: "plugins.bundle.config",
+            key: "dsh-quick-toc",
+            locale: "dsh-quick-toc"
+          }, TocSettingsCard);
+        });
         ctx.slots.inject("settings.plugin.item", function () {
           return ctx.slots.register({
             name: "settings.plugin.item",

package/lib/index.js

@@ -16,70 +16,109 @@ import z from "@deepseek-ai/schemastery";
 /** Namespace the browser half binds and the card is keyed on. */
 export const NAMESPACE = "dsh-quick-toc";
 
+/**
+ * Mark one preference field as a live value where the running schemastery knows
+ * the modifier, and hand the field back untouched where it does not; see
+ * `apply` for why the difference exists.
+ * @param {object} schema - the field's schema.
+ * @returns {object} the same schema, volatile on hosts that support it.
+ */
+const volatileSchema = (schema) =>
+  typeof schema.volatile === "function" ? schema.volatile() : schema;
+
 /**
  * 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
+  lang: volatileSchema(z
     .string()
     .pattern(/^(auto|zh|en)$/)
     .default("auto")
-    .description("Panel language: auto follows DSH, zh or en forces one"),
-  dock: z
+    .description("Panel language: auto follows DSH, zh or en forces one")),
+  dock: volatileSchema(z
     .string()
     .pattern(/^(left|right)$/)
     .default("left")
-    .description("Which edge the panel docks to by default"),
-  levels: z
+    .description("Which edge the panel docks to by default")),
+  levels: volatileSchema(z
     .array(z.number().min(1).max(6))
     .default([1, 2, 3, 4, 5, 6])
-    .description("Heading levels the outline shows"),
-  zoom: z
+    .description("Heading levels the outline shows")),
+  zoom: volatileSchema(z
+    .number()
+    .min(0.5)
+    .max(2)
+    .default(1)
+    .description("Scale factor for the panel's content (text, icons, buttons) from 50% to 200%; the panel's own size is unchanged")),
+  sheetZoom: volatileSchema(z
     .number()
     .min(0.5)
     .max(2)
     .default(1)
-    .description("Scale factor for the panel's content (text, icons, buttons) from 50% to 200%; the panel's own size is unchanged"),
-  handle: z
+    .description("Scale factor for the curtain's content (text, icons, buttons) from 50% to 200%; the curtain's own size is unchanged")),
+  handle: volatileSchema(z
     .number()
     .min(0)
     .max(1)
     .default(0.5)
-    .description("Vertical position of the collapsed-panel handle: 0 = bottom, 1 = top of the conversation area"),
-  fuzzy: z
+    .description("Vertical position of the collapsed-panel handle: 0 = bottom, 1 = top of the conversation area")),
+  fuzzy: volatileSchema(z
     .boolean()
     .default(false)
-    .description("Start with fuzzy search on"),
-  hover: z
+    .description("Start with fuzzy search on")),
+  hover: volatileSchema(z
     .boolean()
     .default(true)
-    .description("Show the hover preview card"),
-  remember: z
+    .description("Show the hover preview card")),
+  remember: volatileSchema(z
     .boolean()
     .default(true)
-    .description("Remember where you were reading in each session and return there when it is reopened"),
-  autoLoad: z
+    .description("Remember where you were reading in each session and return there when it is reopened")),
+  autoLoad: volatileSchema(z
     .boolean()
     .default(true)
-    .description("Load history automatically when the outline is scrolled into turns that are not loaded yet; off means nothing loads until a row is clicked"),
-  debug: z
+    .description("Load history automatically when the outline is scrolled into turns that are not loaded yet; off means nothing loads until a row is clicked")),
+  debug: volatileSchema(z
     .boolean()
     .default(false)
-    .description("Print the mount diagnostic to the browser console"),
+    .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.
+ * Register the settings namespace, in whichever dialect the running host speaks.
+ *
+ * Up to DSH 0.1.5-rc.2 the settings service registers a named section with a
+ * schema and reads and writes it by that name (`installSection`). From
+ * 0.1.7-alpha.1 on, the service addresses settings by PROFILE ENTRY ID, derives
+ * the entry's form from the schema this module exports, and only projects the
+ * fields marked `.volatile()` — an instance announces its page policy with
+ * `settings.configure` instead. Both are pure registrations that the browser
+ * half then reads through its own service, so the plugin does not care which
+ * one ran.
+ *
+ * `volatileSchema` marks a field only where the running schemastery knows the
+ * modifier: it arrived in schemastery 3.18.3 (the alpha), and calling it on
+ * 3.18.2 (the rc line) would throw while the module is being imported.
+ *
  * @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: () => {},
-    });
+    const settings = settingsCtx.settings;
+    if (settings && typeof settings.installSection === "function") {
+      settings.installSection(ctx, NAMESPACE, Config, config ?? {}, {
+        setSource: () => {},
+        onChange: () => {},
+      });
+      return;
+    }
+    if (settings && typeof settings.configure === "function") {
+      // `auto: true` keeps the host's generated page as the fallback wherever no
+      // custom page of ours is reachable (the browser half renders one where the
+      // host offers a configuration cell for this entry).
+      settingsCtx.effect(() => settings.configure({ auto: true }, ctx.fiber));
+    }
   });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-quick-toc",
-  "version": "0.7.1",
+  "version": "0.7.3",
   "description": "Conversation TOC for DeepSeek Harness (DSH): a whole-session, turn-grouped Markdown outline with hover previews, a level filter, a full-width curtain, jump-to-end buttons, title/full-text/cross-session search and a Chinese/English interface.",
   "type": "module",
   "main": "lib/index.js",
@@ -14,7 +14,7 @@
     "LICENSE"
   ],
   "engines": {
-    "dsh": ">=0.1.5-rc.1"
+    "dsh": ">=0.1.5-rc.1 <0.1.7-0 || >=0.1.7-alpha.1 <0.2.0-0"
   },
   "exports": {
     ".": "./lib/index.js",
@@ -36,15 +36,18 @@
     "compatibility": {
       "dshReleases": {
         "0.1.5-rc.1": "compatible",
-        "0.1.5-rc.2": "compatible"
+        "0.1.5-rc.2": "compatible",
+        "0.1.5-rc.3": "compatible",
+        "0.1.7-alpha.1": "compatible",
+        "0.1.7-alpha.2": "compatible"
       }
     }
   },
   "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"
+    "@deepseek-ai/dsh-client-ui-chat": ">=0.1.5-rc.1 <0.1.7-0 || >=0.1.7-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-client-ui-conversation": ">=0.1.5-rc.1 <0.1.7-0 || >=0.1.7-alpha.1 <0.2.0-0"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/schemastery": {