@nonamelego/dsh-catppuccin 0.5.6-beta.1 → 0.5.6

package/README.en.md

@@ -318,11 +318,12 @@ Then add `@nonamelego/dsh-catppuccin` to the profile's `package.json`
 - **Q: "How is my theme choice remembered?"**
   A: The choice persists in DSH's official settings document (the `catppuccin` namespace,
   stored under the DSH home, shared across every DSH instance on the machine), with
-  localStorage as an in-browser cache and cross-tab sync. So plain `dsh web`,
-  `dsh web --port <custom>`, and **DSH Desktop** (which boots on a fresh random loopback
-  port every launch) all restore the preference automatically. The glass switch and every
+  localStorage as an in-browser cache and cross-tab sync. So switching browser,
+  clearing site data, a custom port (`dsh web --port <custom>`) or a second desktop
+  instance never loses the preference; **DSH Desktop** (the official shell and
+  `anywhere-labs/dsh-desktop`) restores it across restarts too. The glass switch and every
   knob persist the same way. Since 0.5.0, a legacy `catppuccin-state.json` is migrated
-  into the settings document once on first launch (the file is kept as a rollback copy).
+  into the official settings once on first launch (the file is kept as a rollback copy).
 - **Q: "How do I know if this plugin has a new version?"**
   A: Settings → General → **Check Catppuccin plugin updates** compares against npm in one
   click and gives a copyable upgrade command; or run

package/README.md

@@ -292,12 +292,15 @@ pnpm --dir C:\Users\LeGo\.dsh\profiles\web add link:D:\Vibe-Coding\dsh-catppucci
   A: 官方外观行只列出内置的浅色/深色/跟随系统偏好。四个主题在它正下方的
   **Catppuccin** 行里。
 - Q: **_"我的主题选择是怎么记住的？"_**
-  A: 选择持久保存在 DSH 的官方 settings 文档（`catppuccin` namespace，存于
-  DSH home 下，同一台机器的 DSH 共享这份偏好），浏览器 localStorage 作为
-  即时缓存与多标签页同步。因此普通 `dsh web`、`dsh web --port` 自定义端口，
-  以及 **DSH Desktop**（每次启动用随机回环端口）都能跨重启自动恢复；玻璃质感
-  开关与各旋钮同样持久保存。0.5.0 起旧版 `catppuccin-state.json` 会在首次
-  启动时一次性迁移进 settings 文档（文件保留作回退）。
+  A: 选择持久保存在 DSH 的官方设置里（同一台机器的 DSH 共享这份偏好），浏览器
+  localStorage 作为即时缓存与多标签页同步。落点随 DSH 版本而异：**0.1.6 及更早**
+  存于 DSH home 下的官方 settings 文档（`catppuccin` 命名空间）；**0.1.7 起**上游
+  改为「插件配置表单」，落点是当前 profile 的 patch 文件里本插件的 `config:` 段
+  （本插件两套都支持，按宿主实际提供的服务自动选择）。因此换浏览器、清站点数据、
+  自定义端口（`dsh web --port`）或再开一个桌面实例，偏好都不会丢；
+  **DSH Desktop**（官方壳与 `anywhere-labs/dsh-desktop`）同样跨重启自动恢复。
+  玻璃质感开关与各旋钮同样持久保存。0.5.0 起旧版 `catppuccin-state.json`
+  会在首次启动时一次性迁移进官方设置（文件保留作回退）。
 - Q: **_"怎么知道这个插件有没有新版本？"_**
   A: 设置 → 常规 → **检查 Catppuccin 插件更新** 一键检测本插件在 npm 上的最新版本，
   发现新版会给出可复制的升级命令；也可以随时手动执行

package/lib/client.js

@@ -1954,9 +1954,39 @@ window.__ModuleLoader__.load({
 		* glass.module.css and rebuilding.
 		*/
 		const GLASS_CSS_TEXT = "[data-dsh-glass] body{--dsh-glass-card:color-mix(in srgb, var(--dsw-alias-bg-layer-1) calc(52% * var(--dsh-glass-frost,1)), transparent);--dsh-glass-card-raised:color-mix(in srgb, var(--dsw-alias-bg-layer-1) calc(64% * var(--dsh-glass-frost,1)), transparent);--dsh-glass-card-hover:color-mix(in srgb, var(--dsw-alias-bg-layer-1) calc(76% * var(--dsh-glass-frost,1)), transparent);--dsh-glass-rim:color-mix(in srgb, var(--dsw-alias-label-primary) 18%, transparent);--dsh-glass-rim-soft:color-mix(in srgb, var(--dsw-alias-label-primary) 12%, transparent);--dsh-glass-edge:inset 0 1px 0 #ffffff6b;--dsh-glass-drop:0 10px 32px color-mix(in srgb, var(--dsw-alias-bg-mask-2) 38%, transparent)}[data-dsh-glass] body[data-ds-dark-theme]{--dsh-glass-rim:color-mix(in srgb, var(--dsw-alias-label-primary) 24%, transparent);--dsh-glass-rim-soft:color-mix(in srgb, var(--dsw-alias-label-primary) 16%, transparent);--dsh-glass-edge:inset 0 1px 0 #ffffff14;--dsh-glass-drop:0 10px 32px #02060e73}[data-dsh-glass] body{background:color-mix(in srgb, color-mix(in srgb, var(--dsw-alias-bg-base), #fff calc(var(--dsh-glass-brightness-white,0) * 100%)), #000 calc(var(--dsh-glass-brightness-black,0) * 100%))}[data-dsh-glass] [data-dsh-glass-frame],[data-dsh-glass] [data-phase],[data-dsh-glass] [data-dsh-glass-details]{background:0 0}[data-dsh-glass-float] [data-phase=active] header{z-index:8;position:relative}[data-dsh-glass-float] [class*=banner]{position:static}[data-dsh-glass-float] [data-phase=active] [data-conversation-scroll]{margin-top:-95px;padding-top:107px}[data-dsh-glass] [data-phase] [class*=composerSeat][class*=composerSeat]{background:0 0}[data-dsh-glass] [data-dsh-glass-fade]{z-index:7;pointer-events:none;backdrop-filter:blur(5px);background:#ffffff2e;height:13px;position:fixed;left:0;right:0}[data-dsh-glass] body[data-ds-dark-theme] [data-dsh-glass-fade]{background:#00000024}[data-dsh-glass] [data-dsh-glass-fade=top]{top:0;-webkit-mask-image:linear-gradient(#000 0%,#0000 100%);mask-image:linear-gradient(#000 0%,#0000 100%)}[data-dsh-glass] [data-dsh-glass-fade=bottom]{bottom:0;-webkit-mask-image:linear-gradient(#0000 0%,#000 100%);mask-image:linear-gradient(#0000 0%,#000 100%)}[data-dsh-glass-float] [role=menu],[data-dsh-glass-float] [role=dialog],[data-dsh-glass-float] [role=alert],[data-dsh-glass-float] [data-dsh-glass-surface]{border-radius:14px}[data-dsh-glass-float] [role=menuitem],[data-dsh-glass-float] [role=tooltip],[data-dsh-glass-float] [class*=pill]{border-radius:8px}[data-dsh-glass-float] button[class*=button]{border-radius:10px}[data-dsh-glass-float] [class*=iconButton],[data-dsh-glass-float] [class*=searchButton]{border-radius:8px}[data-dsh-glass-float] [class*=block]{--dsl-code-block-border-radius:14px;--dsl-diff-radius:14px;--dsl-read-radius:14px;--dsl-terminal-radius:14px;--dsl-web-radius:14px;--dsl-search-radius:14px;border-radius:14px}[data-dsh-glass-float] [data-dsh-glass-add]{background:var(--dsh-glass-card-raised);border:1px solid var(--dsh-glass-rim);box-shadow:var(--dsh-glass-edge);backdrop-filter:blur(var(--dsh-glass-blur,14px))}[data-dsh-glass-float] [data-dsh-glass-add]:hover:not(:disabled){background:var(--dsh-glass-card-hover)}[data-dsh-glass-float] [data-dsh-glass-surface]{background:var(--dsh-glass-card-raised);border:1px solid var(--dsh-glass-rim);box-shadow:var(--dsh-glass-edge);backdrop-filter:blur(var(--dsh-glass-blur,14px))}[data-dsh-glass-float] [data-dsh-glass-surface]:hover:not(:disabled){background:var(--dsh-glass-card-hover)}[data-dsh-glass-float] [data-conversation-scroll] [class*=bubble]{border:1px solid var(--dsh-glass-rim-soft);background:color-mix(in srgb, var(--dsw-alias-bg-layer-1) calc(46% * var(--dsh-glass-frost,1)), transparent);border-radius:14px}[data-dsh-glass-float] [class*=card]{border-radius:14px}[data-dsh-glass] [data-dsh-glass-settings]{--dsh-glass-settings-raised:calc(38% + 38% * var(--dsh-glass-frost,1));--dsh-glass-settings-soft:calc(30% + 30% * var(--dsh-glass-frost,1));--dsw-alias-bg-module-platform:color-mix(in srgb, var(--dsw-static-neutral-bluish-800) var(--dsh-glass-settings-raised), transparent);--dsw-alias-bg-layer-3:color-mix(in srgb, var(--dsw-static-neutral-bluish-800) var(--dsh-glass-settings-soft), transparent);--dsw-alias-bg-layer-2:color-mix(in srgb, var(--dsw-static-neutral-bluish-850) var(--dsh-glass-settings-raised), transparent);--dsw-alias-bg-layer-1:color-mix(in srgb, var(--dsw-static-neutral-bluish-850) var(--dsh-glass-settings-soft), transparent);--dsw-specific-sidebar-nav-item-active:color-mix(in srgb, var(--dsw-static-neutral-bluish-750) var(--dsh-glass-settings-raised), transparent);--dsw-specific-sidebar-nav-item-hover:color-mix(in srgb, var(--dsw-static-neutral-bluish-850) var(--dsh-glass-settings-soft), transparent)}[data-dsh-glass] body:not([data-ds-dark-theme]) [data-dsh-glass-settings]{--dsw-alias-bg-module-platform:color-mix(in srgb, var(--dsw-static-neutral-bluish-60) var(--dsh-glass-settings-raised), transparent);--dsw-alias-bg-layer-3:color-mix(in srgb, var(--dsw-static-neutral-bluish-00) var(--dsh-glass-settings-soft), transparent);--dsw-alias-bg-layer-2:color-mix(in srgb, var(--dsw-static-neutral-bluish-00) var(--dsh-glass-settings-raised), transparent);--dsw-alias-bg-layer-1:color-mix(in srgb, var(--dsw-static-neutral-bluish-00) var(--dsh-glass-settings-soft), transparent);--dsw-specific-sidebar-nav-item-active:color-mix(in srgb, var(--dsw-static-neutral-bluish-100) var(--dsh-glass-settings-raised), transparent);--dsw-specific-sidebar-nav-item-hover:color-mix(in srgb, var(--dsw-static-neutral-bluish-75) var(--dsh-glass-settings-soft), transparent)}[data-dsh-glass-float] header{border:1px solid var(--dsh-glass-rim);background:var(--dsh-glass-card);box-shadow:var(--dsh-glass-edge), var(--dsh-glass-drop);backdrop-filter:blur(var(--dsh-glass-blur,14px));border-radius:20px;margin:12px 16px 0;padding:10px 16px 8px}[data-dsh-glass-float] header:after{display:none}[data-dsh-glass-float] [data-dsh-glass-frame][data-sidebar-collapsed] header{margin-left:28px}[data-dsh-glass-float] [class*=sidebarCol]{--dsw-specific-sidebar-fill:transparent;z-index:9;border:1px solid var(--dsh-glass-rim);border-right-color:color-mix(in srgb, var(--dsw-alias-brand-primary-new-colorprimary-new-color) 40%, transparent);box-shadow:var(--dsh-glass-drop);border-radius:20px;margin:12px;padding:10px 12px 14px;position:relative;overflow:hidden}[data-dsh-glass-float] [class*=sidebarCol]:before{content:\"\";border-radius:inherit;background:var(--dsh-glass-card);box-shadow:var(--dsh-glass-edge);z-index:-1;pointer-events:none;transition:border-radius .15s var(--ds-ease-in-out);position:absolute;inset:0}[data-dsh-glass-float] body[data-ds-dark-theme] [class*=sidebarCol]{border-right-color:color-mix(in srgb, var(--dsw-alias-brand-primary-new-colorprimary-new-color) 22%, transparent)}[data-dsh-glass-float] [data-dsh-glass-frame][data-sidebar-collapsed] [class*=sidebarCol]{transition:margin .15s var(--ds-ease-in-out), border-radius .15s var(--ds-ease-in-out);border-radius:16px;margin:12px -12px 12px 12px;padding:0}[data-dsh-glass-float] [data-dsh-glass-frame]:not([data-sidebar-collapsed]) [data-dsh-glass-sidebar-root]{width:100%!important}[data-dsh-glass-float] [data-dsh-glass-trajectory]{border:1px solid var(--dsh-glass-rim);background:var(--dsh-glass-card);width:calc(100% - 32px);height:calc(100% - 20px);box-shadow:var(--dsh-glass-edge), var(--dsh-glass-drop);border-radius:20px;margin:8px 16px 12px;overflow:hidden}[data-dsh-glass-float] [data-dsh-glass-trajectory] [role=toolbar],[data-dsh-glass-float] [data-dsh-glass-trajectory] section[aria-label=Trajectory\\ timeline]{background:0 0}[data-dsh-glass-float] [data-composer-card],[data-dsh-glass-float] [data-composer-card]:after{border-radius:24px}[data-dsh-glass-float] [data-composer-card]{z-index:8;background:var(--dsh-glass-card);border:1px solid var(--dsh-glass-rim);box-shadow:var(--dsh-glass-edge), var(--dsh-glass-drop);backdrop-filter:blur(var(--dsh-glass-blur,14px));position:relative}[data-dsh-glass-float] [data-dsh-glass-inputbar]:not([class*=hero]):not(:has([data-dsh-glass-stats])){padding-bottom:12px}[data-dsh-glass][data-dsh-glass-float] [data-dsh-glass-inputbar]:has([data-dsh-glass-stats]){border:1px solid var(--dsh-glass-rim);background:var(--dsh-glass-card);box-shadow:var(--dsh-glass-edge), var(--dsh-glass-drop);backdrop-filter:blur(var(--dsh-glass-blur,14px));border-radius:24px;margin:0 auto 12px;padding:0;width:var(--dsh-composer-card-max-width)!important;max-width:var(--dsh-composer-card-max-width)!important}[data-dsh-glass-float] [data-dsh-glass-inputbar]:has([data-dsh-glass-stats]) [data-composer-card]{box-shadow:none;backdrop-filter:none;background:0 0;border:none;border-radius:0}[data-dsh-glass-float] [data-dsh-glass-inputbar]:has([data-dsh-glass-stats]) [data-composer-card]:after{display:none}[data-dsh-glass][data-dsh-glass-float] [data-dsh-glass-inputbar]:has([data-dsh-glass-stats]) [data-slot]{border:none;border-top:1px solid var(--dsh-glass-rim-soft);box-shadow:none;backdrop-filter:none;background:0 0;border-radius:0;margin:0;padding:2px 16px 6px;width:100%!important;max-width:none!important}[data-dsh-glass][data-dsh-glass-float] [data-dsh-glass-inputbar] [data-slot] [data-dsh-glass-stats]{min-width:0;box-shadow:none;backdrop-filter:none;background:0 0;border:none;border-radius:0;margin:0;width:100%!important;padding:4px 0 0!important}[data-dsh-glass][data-dsh-glass-float] [data-dsh-glass-inputbar] [data-slot] [data-dsh-live-tps]{padding-right:0}[data-dsh-glass-float] [role=treeitem][aria-selected=true]{background:color-mix(in srgb, var(--dsw-specific-sidebar-nav-item-active) 40%, transparent);box-shadow:inset 2px 0 0 var(--dsw-specific-sidebar-nav-item-active-accent), 0 0 16px color-mix(in srgb, var(--dsw-alias-brand-primary-new-colorprimary-new-color) 20%, transparent)}[data-dsh-glass-float] button[class*=button]:hover:not(:disabled),[data-dsh-glass-float] [role=menuitem]:hover:not(:disabled){box-shadow:0 0 12px color-mix(in srgb, var(--dsw-alias-brand-primary-new-colorprimary-new-color) 20%, transparent), inset 0 0 0 1px color-mix(in srgb, var(--dsw-alias-border-l3) 60%, transparent)}[data-dsh-glass-float] [role=menu]{background:var(--dsh-glass-card-raised);border:1px solid var(--dsh-glass-rim-soft);backdrop-filter:blur(var(--dsh-glass-blur,14px))}[data-dsh-glass-float] [role=menu]:has([role=group]>[role=menuitemradio]){background:color-mix(in srgb, var(--dsw-alias-bg-layer-2) 70%, transparent)}[data-dsh-glass-float] [role=menu] [role=group]:has(>[role=menuitemradio])>:first-child{border:1px solid var(--dsh-glass-rim);background:var(--dsh-glass-card-raised);backdrop-filter:blur(var(--dsh-glass-blur,14px));border-radius:999px;align-items:center;width:fit-content;margin:3px 0 5px 6px;padding:3px 10px;display:inline-flex}[data-dsh-glass-float] [role=dialog][aria-modal=true]{background:var(--dsh-glass-card-raised);border:1px solid var(--dsh-glass-rim);box-shadow:var(--dsh-glass-edge);backdrop-filter:blur(var(--dsh-glass-blur,14px))}[data-dsh-glass] [data-conversation-scroll]{text-shadow:0 0 1px #ffffff80}[data-dsh-glass] body[data-ds-dark-theme] [data-conversation-scroll]{text-shadow:0 0 1px #0006}[data-dsh-glass-float] [data-dsh-glass-inputbar] [data-slot]{color:var(--dsw-alias-label-secondary)}[data-dsh-glass-float] [data-phase=hero]{animation:dsh-glass-in .32s var(--ds-ease-in-out)}[data-dsh-glass-float] [data-phase=active]{animation:dsh-glass-in .3s var(--ds-ease-in-out)}[data-dsh-glass-float] [data-testid^=view-]{animation:dsh-glass-in .26s var(--ds-ease-in-out)}[data-dsh-glass-float] [data-tool]{animation:dsh-glass-rise .3s var(--ds-ease-in-out) both}[data-dsh-glass-float] [role=dialog]{animation:dsh-glass-dialog-in .24s var(--ds-ease-in-out)}@keyframes dsh-glass-in{0%{opacity:0}}@keyframes dsh-glass-rise{0%{opacity:0;transform:translateY(6px)}}@keyframes dsh-glass-dialog-in{0%{opacity:0;transform:translateY(8px)scale(.985)}}[data-dsh-glass] :focus-visible{outline:2px solid color-mix(in srgb, var(--dsw-alias-brand-primary-new-colorprimary-new-color) 85%, transparent);outline-offset:1px}[data-dsh-glass] ::selection{background:color-mix(in srgb, var(--dsw-alias-brand-primary-new-colorprimary-new-color) 35%, transparent)}[data-dsh-glass-compat] [role=menu],[data-dsh-glass-compat] [role=tooltip],[data-dsh-glass-compat] [class*=card],[data-dsh-glass-compat] [class*=panel],[data-dsh-glass-compat] [class*=popover],[data-dsh-glass-compat] [class*=dropdown]{backdrop-filter:blur(12px)}[data-dsh-glass-compat] [role=menu],[data-dsh-glass-compat] [role=tooltip],[data-dsh-glass-compat] [class*=card],[data-dsh-glass-compat] [class*=popover],[data-dsh-glass-compat] [class*=dropdown]{background:var(--dsh-glass-card-raised)}[data-dsh-glass-compat] [role=menu]:not(:focus-visible),[data-dsh-glass-compat] [role=tooltip]:not(:focus-visible),[data-dsh-glass-compat] [class*=card]:not(:focus-visible),[data-dsh-glass-compat] [class*=popover]:not(:focus-visible),[data-dsh-glass-compat] [class*=dropdown]:not(:focus-visible){outline:1px solid var(--dsh-glass-rim);outline-offset:-1px}[data-dsh-glass-compat] [role=dialog][aria-modal=true]{background:var(--dsh-glass-card-raised);border:1px solid var(--dsh-glass-rim);backdrop-filter:blur(var(--dsh-glass-blur,12px))}@media (prefers-reduced-motion:reduce){[data-dsh-glass-float] [data-phase=hero],[data-dsh-glass-float] [data-phase=active],[data-dsh-glass-float] [data-testid^=view-],[data-dsh-glass-float] [data-tool],[data-dsh-glass-float] [role=dialog]{animation:none}}";
-		/** Settings namespace both halves address: Host registers it, Client binds
-		*  it through `ctx.settingsScope` (see `src/settings-catppuccin.ts`). */
+		/** Legacy settings namespace (DSH <= 0.1.6-alpha.2): the Host registers it
+		*  through `settings.installSection`, the Client binds it through
+		*  `ctx.settingsScope` (see `src/settings-catppuccin.ts`). */
 		const CATPPUCCIN_SETTINGS_NS = "catppuccin";
+		/**
+		* Profile entry id carrying the plugin (DSH >= 0.1.7-alpha.1): the settings
+		* service projects our volatile `Config` into a form named by the ACTIVE
+		* PROFILE ENTRY's id, so this constant is the new seam's namespace.
+		*
+		* It is a CONTRACT with `cordis.patch.yml`: the `insert` row whose `name` is
+		* `@nonamelego/dsh-catppuccin` must keep `id: dsh-catppuccin`, because the
+		* Client can only address the form by that id (asserted by
+		* `tests/settings-seam.spec.ts`). A user who renames the entry loses the new
+		* seam and degrades to localStorage-only — the legacy seam is unaffected,
+		* since that namespace is registered by the plugin itself.
+		*/
+		const CATPPUCCIN_ENTRY_ID = "dsh-catppuccin";
+		/**
+		* Whether a raw settings view carries a user layer at all.
+		*
+		* The two seams answer this differently and the difference is load-bearing
+		* (issue #15): the NEW form's `user` is the profile patch's `override`, which
+		* `configEditor.configuration()` defaults to `{}` — so "absent" arrives as an
+		* EMPTY OBJECT, and `!== undefined` would be true forever. The LEGACY
+		* document omits the field entirely when the document holds no such section,
+		* so the old `!== undefined` test stays correct there. Callers must use the
+		* predicate their channel defines (see `src/client/state-sync.ts`).
+		* @param user - a snapshot's raw user layer.
+		* @returns whether it holds at least one entry.
+		*/
+		function hasUserLayerSection(user) {
+			return typeof user === "object" && user !== null && !Array.isArray(user) && Object.keys(user).length > 0;
+		}
 		/** The four registered Catppuccin theme ids. MUST stay in sync with the
 		*  `themeId` of `CATPPUCCIN_FLAVORS` in `src/client/palettes.ts` — guarded by
 		*  `tests/state.spec.ts` — because the persisted flavour value IS the theme id. */
@@ -3283,14 +3313,17 @@ window.__ModuleLoader__.load({
 		const UPDATE_ROUTE_PATH = "/catppuccin/check-update";
 		//#endregion
 		//#region src/client/state-sync.ts
-		/**
-		* Bind the Catppuccin namespace on this context. The scope derives from the
-		* shared document mirror (no wire read of its own) and its life is bound to
-		* the calling fiber, so binding never blocks on the settings transport.
-		*/
-		function bindCatppuccinScope(ctx) {
-			return ctx.settingsScope.bind({ namespace: CATPPUCCIN_SETTINGS_NS });
-		}
+		/** The snapshot an unbound scope reports: the pre-0.5.0 "transport absent"
+		*  degradation, where localStorage is the only store. */
+		const UNBOUND_SNAPSHOT = {
+			status: "unavailable",
+			value: void 0,
+			base: void 0,
+			user: void 0,
+			revision: void 0,
+			writable: false,
+			mode: "memory"
+		};
 		/** Whether the scope is usable for durable persistence: the document is
 		*  resolved (`ready`) and the Host persistence is active (`host`). A `memory`
 		*  scope (non-loopback pages / absent transport) or a not-yet-ready one is
@@ -3304,6 +3337,94 @@ window.__ModuleLoader__.load({
 			if (!isScopeUsable(snapshot) || snapshot.value === void 0) return null;
 			return stateFromSettingsSection(snapshot.value);
 		}
+		/** The NEW seam's channel (DSH >= 0.1.7-alpha.1). */
+		function configFormsScope(form) {
+			return {
+				kind: "configForms",
+				getSnapshot: () => form.getSnapshot(),
+				subscribe: (listener) => form.subscribe(listener),
+				hasUserLayer: (snapshot) => hasUserLayerSection(snapshot.user),
+				write: async (ops, baseRevision) => {
+					try {
+						return await form.mutate(ops, baseRevision) ? "accepted" : "refused";
+					} catch {
+						return "failed";
+					}
+				}
+			};
+		}
+		/** The LEGACY seam's channel (DSH <= 0.1.6-alpha.2). */
+		function legacyScope(scope) {
+			return {
+				kind: "settingsScope",
+				getSnapshot: () => scope.getSnapshot(),
+				subscribe: (listener) => scope.subscribe(listener),
+				hasUserLayer: (snapshot) => snapshot.user !== void 0,
+				write: async (ops) => {
+					try {
+						await scope.mutate(ops);
+						return "accepted";
+					} catch {
+						return "failed";
+					}
+				}
+			};
+		}
+		/**
+		* Bind whichever settings channel this host serves, late and without blocking.
+		*
+		* Both bindings ride OPTIONAL injections: a service the deployment never
+		* provides simply never fires its callback (it does not hold the plugin
+		* back), and the two names cannot both be live in one host — 0.1.7-alpha.1
+		* removed `settingsScope` from the service set, and 0.1.6 and earlier know
+		* nothing of `configForms`. Until one binds, the scope reports the unbound
+		* snapshot and every write short-circuits, which is exactly the
+		* "settings transport unavailable" degradation the rows already handle.
+		* @param ctx - client root context.
+		* @returns the scope facade, bound for the lifetime of the caller's fiber.
+		*/
+		function createDurableScope(ctx) {
+			let current;
+			let offBound;
+			const listeners = /* @__PURE__ */ new Set();
+			const notify = () => {
+				for (const listener of [...listeners]) listener();
+			};
+			const attach = (next) => {
+				if (next === current) return;
+				offBound?.();
+				current = next;
+				offBound = next?.subscribe(notify);
+				notify();
+			};
+			ctx.inject(["configForms"], (formsCtx) => {
+				attach(configFormsScope(formsCtx.configForms.get(CATPPUCCIN_ENTRY_ID)));
+				return () => {
+					attach(void 0);
+				};
+			});
+			ctx.inject(["settingsScope"], (legacyCtx) => {
+				const binder = legacyCtx.settingsScope;
+				if (binder !== void 0) attach(legacyScope(binder.bind({ namespace: CATPPUCCIN_SETTINGS_NS })));
+				return () => {
+					attach(void 0);
+				};
+			});
+			return {
+				get kind() {
+					return current?.kind ?? "none";
+				},
+				getSnapshot: () => current?.getSnapshot() ?? UNBOUND_SNAPSHOT,
+				subscribe: (listener) => {
+					listeners.add(listener);
+					return () => {
+						listeners.delete(listener);
+					};
+				},
+				hasUserLayer: (snapshot) => current?.hasUserLayer(snapshot) ?? false,
+				write: async (ops, baseRevision) => current?.write(ops, baseRevision) ?? "failed"
+			};
+		}
 		/** One atomic mutation covering the whole local state (revision-fenced).
 		*  Writing every field keeps the section self-contained — a partial write
 		*  could otherwise leave a knob stuck on a stale override after a document
@@ -3366,11 +3487,13 @@ window.__ModuleLoader__.load({
 		/**
 		* Read-side consistency guard for the durable persist (items C/X).
 		*
-		* The WRITE side is already revision-fenced by `scope.mutate(...)` (the
-		* Host rejects an outdated revision), so no optimistic locking is re-built
-		* here. What the fence cannot see is a STALE LOCAL VIEW: tab A reads an old
-		* localStorage value, the user changes flavour, and the debounced flush
+		* The WRITE side is revision-fenced by the channel, so no optimistic locking
+		* is re-built here. What a fence cannot see is a STALE LOCAL VIEW: tab A reads
+		* an old localStorage value, the user changes flavour, and the debounced flush
 		* writes that old-based state over tab B's already-committed newer choice.
+		* This guard is also the ONLY conflict detector the legacy seam can offer —
+		* that seam resolves a refused write silently, so without it a concurrent edit
+		* would be lost without a trace.
 		*
 		* The guard compares the revision the local state was derived from
 		* (`baseRevision`, captured at schedule time) with the snapshot revision at
@@ -3386,21 +3509,19 @@ window.__ModuleLoader__.load({
 		* a redundant identical mutation).
 		*/
 		async function persistStateToScope(scope, state, options = {}) {
-			try {
-				const snapshot = scope.getSnapshot();
-				if (!isScopeUsable(snapshot)) return "error";
-				const remote = durableStateFromSnapshot(snapshot);
-				const localSection = settingsSectionFromState(state);
-				if (remote !== null && settingsSectionsEqual(settingsSectionFromState(remote), localSection)) return "noop";
-				const { baseRevision, lastWrittenSection } = options;
-				if (baseRevision !== void 0 && snapshot.revision !== void 0 && snapshot.revision !== baseRevision) {
-					if (!(lastWrittenSection !== void 0 && remote !== null && settingsSectionsEqual(settingsSectionFromState(remote), lastWrittenSection))) return "stale";
-				}
-				await scope.mutate(stateToMutateOps(state));
-				return "written";
-			} catch {
-				return "error";
+			const snapshot = scope.getSnapshot();
+			if (!isScopeUsable(snapshot)) return "error";
+			const remote = durableStateFromSnapshot(snapshot);
+			const localSection = settingsSectionFromState(state);
+			if (remote !== null && settingsSectionsEqual(settingsSectionFromState(remote), localSection)) return "noop";
+			const { baseRevision, lastWrittenSection } = options;
+			if (baseRevision !== void 0 && snapshot.revision !== void 0 && snapshot.revision !== baseRevision) {
+				if (!(lastWrittenSection !== void 0 && remote !== null && settingsSectionsEqual(settingsSectionFromState(remote), lastWrittenSection))) return "stale";
 			}
+			const outcome = await scope.write(stateToMutateOps(state), baseRevision);
+			if (outcome === "accepted") return "written";
+			if (outcome === "refused") return "stale";
+			return "error";
 		}
 		let pendingTimer;
 		let pendingWrite;
@@ -3499,11 +3620,13 @@ window.__ModuleLoader__.load({
 		/** Whether localStorage carries an EXPLICIT `off` flavour choice.
 		*
 		* `readFlavor()` maps both "no value" and "off" to `off`, and the two are not
-		* the same thing: DSH Desktop boots the GUI on a fresh random loopback port, so
-		* its localStorage starts empty on every launch and the settings document —
-		* which may legitimately hold a flavour — is what should win. Only a literal
-		* `off` in storage proves the user (or another window) actually turned the
-		* flavour off, which is the case the cross-tab restore must act on (audit F4). */
+		* the same thing: an absent value only means THIS browser/origin never chose
+		* (a first visit, cleared site data, or a second Desktop instance that landed
+		* on the next free loopback port), while the durable store — which may
+		* legitimately hold a flavour picked elsewhere — is machine-wide. Only a
+		* literal `off` in storage proves the user (or another window) actually turned
+		* the flavour off, which is the case the cross-tab restore must act on
+		* (audit F4). */
 		function readExplicitFlavorOff() {
 			try {
 				return localStorage.getItem(FLAVOR_STORAGE_KEY) === "off";
@@ -3678,13 +3801,17 @@ window.__ModuleLoader__.load({
 			if (preference !== "light" && preference !== "dark") return false;
 			return preference === livePick;
 		}
-		/** Required services: slots + locale (settings rows), theme (register +
-		*  switch), and the settings scope (durable persistence). */
+		/** Required services: slots + locale (settings rows) and theme (register +
+		*  switch). The durable settings transport is NOT a hard dependency: which
+		*  service provides it depends on the host version (issue #15 — 0.1.7-alpha.1
+		*  replaced `settingsScope` with `configForms`), so `createDurableScope`
+		*  binds whichever one appears through its own optional injections. Listing
+		*  either name here would leave the plugin permanently pending on the other
+		*  half of the installed base. */
 		const inject = [
 			"slots",
 			"locale",
-			"theme",
-			"settingsScope"
+			"theme"
 		];
 		/**
 		* Register the Catppuccin dictionaries, the flavour themes (lazy — item JJ:
@@ -3762,7 +3889,7 @@ window.__ModuleLoader__.load({
 			};
 			ctx.effect(() => disposeThemeRegistrations, "catppuccin: flavour theme disposers");
 			const glass = new GlassLayer(ctx);
-			const scope = bindCatppuccinScope(ctx);
+			const scope = createDurableScope(ctx);
 			const buildLocalState = () => ({
 				version: 1,
 				flavor: readFlavor(),
@@ -3876,7 +4003,7 @@ window.__ModuleLoader__.load({
 					const state = durableStateFromSnapshot(snapshot);
 					if (state === null) return;
 					const local = buildLocalState();
-					if (snapshot.user === void 0) {
+					if (!scope.hasUserLayer(snapshot)) {
 						if (!isDefaultState(local)) queuePersist();
 						return;
 					}