@linxin666/dsh-client-ui-skin-center 0.4.6 → 0.4.8

package/README.md

@@ -5,7 +5,7 @@ English | [中文](README.zh.md)
 <p align="center">
   <img src="https://img.shields.io/npm/v/@linxin666/dsh-client-ui-skin-center?style=flat-square" alt="Version">
   &nbsp;
-  <img src="https://img.shields.io/badge/DSH-%3E%3D0.2.0--rc.2-4c6ef5?style=flat-square&amp;labelColor=454a54" alt="DSH">
+  <img src="https://img.shields.io/badge/DSH-%3E%3D0.2.1--rc.2-4c6ef5?style=flat-square&amp;labelColor=454a54" alt="DSH">
   &nbsp;
   <img src="https://img.shields.io/badge/license-Apache--2.0-blue?style=flat-square" alt="License">
 </p>

package/README.zh.md

@@ -5,7 +5,7 @@
 <p align="center">
   <img src="https://img.shields.io/npm/v/@linxin666/dsh-client-ui-skin-center?style=flat-square" alt="Version">
   &nbsp;
-  <img src="https://img.shields.io/badge/DSH-%3E%3D0.2.0--rc.2-4c6ef5?style=flat-square&amp;labelColor=454a54" alt="DSH">
+  <img src="https://img.shields.io/badge/DSH-%3E%3D0.2.1--rc.2-4c6ef5?style=flat-square&amp;labelColor=454a54" alt="DSH">
   &nbsp;
   <img src="https://img.shields.io/badge/license-Apache--2.0-blue?style=flat-square" alt="License">
 </p>

package/contracts/official-tokens-v1.json

@@ -1,12 +1,13 @@
 {
   "$schema": "https://schemas.linxin666.org/dsh-skin/official-tokens-v1.json",
   "contractVersion": 1,
-  "source": "official surfaces: @deepseek-ai/dsh-client-ui-theme@0.1.7-rc.1 lib + @deepseek-ai/dsh-web-frontend@0.1.7-rc.1 dist/assets",
+  "source": "official surfaces: @deepseek-ai/dsh-client-ui-theme@0.2.1-rc.2 lib + @deepseek-ai/dsh-web-frontend@0.2.1-rc.2 dist/assets",
   "excludedPrefix": "--dsw-static-",
-  "count": 299,
+  "count": 329,
   "tokens": [
     "--dsw-alias-bg-base",
     "--dsw-alias-bg-document-preview",
+    "--dsw-alias-bg-document-selection",
     "--dsw-alias-bg-layer-1",
     "--dsw-alias-bg-layer-2",
     "--dsw-alias-bg-layer-3",
@@ -60,6 +61,8 @@
     "--dsw-alias-interactive-bg-hover-danger",
     "--dsw-alias-interactive-bg-hover-solid",
     "--dsw-alias-label-caption",
+    "--dsw-alias-label-deep-diving",
+    "--dsw-alias-label-deep-diving-shimmer",
     "--dsw-alias-label-dimmed",
     "--dsw-alias-label-document-preview",
     "--dsw-alias-label-error",
@@ -69,6 +72,7 @@
     "--dsw-alias-label-primary-foreground",
     "--dsw-alias-label-primary-inverted",
     "--dsw-alias-label-secondary",
+    "--dsw-alias-label-shimmer",
     "--dsw-alias-label-tertiary",
     "--dsw-alias-link",
     "--dsw-alias-markdown-citation",
@@ -79,10 +83,18 @@
     "--dsw-alias-markdown-inline-code",
     "--dsw-alias-markdown-placeholder",
     "--dsw-alias-markdown-tag",
+    "--dsw-alias-menu-group-header-fill",
+    "--dsw-alias-menu-icon",
+    "--dsw-alias-onboarding-accent",
+    "--dsw-alias-onboarding-card-fill",
+    "--dsw-alias-onboarding-checkbox-border",
+    "--dsw-alias-onboarding-secondary-fill",
     "--dsw-alias-scrollbar-bg-l1",
     "--dsw-alias-scrollbar-bg-l2",
     "--dsw-alias-scrollbar-hover-l1",
     "--dsw-alias-scrollbar-hover-l2",
+    "--dsw-alias-settings-card-fill",
+    "--dsw-alias-settings-card-stroke",
     "--dsw-alias-state-business-primary",
     "--dsw-alias-state-business-tertiary",
     "--dsw-alias-state-error-primary",
@@ -95,14 +107,21 @@
     "--dsw-alias-state-warn-primary",
     "--dsw-alias-state-warn-secondary",
     "--dsw-alias-state-warn-tertiary",
+    "--dsw-alias-switch-thumb",
     "--dsw-alias-toast-bg",
+    "--dsw-alias-toast-label",
     "--dsw-alias-tooltip-bg",
+    "--dsw-alias-tooltip-key-bg",
+    "--dsw-alias-turn-trigger-bg",
+    "--dsw-alias-turn-trigger-bg-hover",
     "--dsw-corner-shape",
     "--dsw-elevation-panel",
     "--dsw-elevation-prominent",
     "--dsw-elevation-soft",
     "--dsw-elevation-stroke",
     "--dsw-elevation-stroke-color",
+    "--dsw-focus-ring-color",
+    "--dsw-focus-ring-width",
     "--dsw-font-base-16",
     "--dsw-font-base-16-font-family",
     "--dsw-font-base-16-font-size",
@@ -116,6 +135,7 @@
     "--dsw-font-base-strong-16-font-weight",
     "--dsw-font-base-strong-16-line-height",
     "--dsw-font-family",
+    "--dsw-font-family-brand",
     "--dsw-font-l-20",
     "--dsw-font-l-20-font-family",
     "--dsw-font-l-20-font-size",
@@ -284,11 +304,21 @@
     "--dsw-font-xxxs-strong-11-font-style",
     "--dsw-font-xxxs-strong-11-font-weight",
     "--dsw-font-xxxs-strong-11-line-height",
+    "--dsw-gradient-onboarding-blue-stops",
+    "--dsw-gradient-onboarding-cyan-stops",
+    "--dsw-gradient-onboarding-violet-stops",
     "--dsw-hovercard-bg",
     "--dsw-linear-gradient-think",
     "--dsw-linear-think-select",
     "--dsw-mask-blur",
     "--dsw-menu-backdrop-filter",
+    "--dsw-menu-surface-fill",
+    "--dsw-radius-lg",
+    "--dsw-radius-md",
+    "--dsw-radius-panel",
+    "--dsw-radius-sm",
+    "--dsw-radius-xl",
+    "--dsw-radius-xs",
     "--dsw-shadow-lv1",
     "--dsw-shadow-lv1-blur",
     "--dsw-shadow-lv2",

package/contracts/semantic-attrs-v1.md

@@ -71,7 +71,7 @@
 皮肤中心不写委托插件的任何属性，委托插件不写 `data-dsh-skin`，双方都无法把
 对方卡死。委托皮肤的选择会照常持久化、开机采纳与试穿还原；让路暂停的是
 视觉，不是插件的设置页与偏好。
-## part 组（81 行，含各 owner 行）
+## part 组（78 行，含各 owner 行）
 
 shell 区域（owner: shell）：
 
@@ -154,14 +154,6 @@ family / 插件区域：
 | `foot-card-main` / `foot-card-toggle` | usage | 速览卡主体按钮（整卡点击打开设置分区）/ 右上角收起-展开切换钮；foot-card 内裸值 button |
 | `foot-card-strip` | usage | 折叠态单行摘要条（标签 + 头条值）；折叠时 foot-card-main 内裸值 span |
 | `foot-card-usage` / `foot-card-balances` | usage | 展开态的 tokens/调用行 / 余额行；foot-card 内裸值 span |
-| `panel` | model-capabilities | 提供方卡片能力扩展区根；`[data-dsh-plugin="model-capabilities"][data-dsh-part="panel"]` |
-| `toggle` | model-capabilities | 扩展区折叠头按钮；panel 内 `button[data-dsh-part="toggle"]` |
-| `model-row` / `model-toggle` | model-capabilities | 逐模型能力行与其展开按钮；panel 内 `li[data-dsh-part="model-row"]` 及其中 `button[data-dsh-part="model-toggle"]` |
-| `image-input` / `efforts-mode` | model-capabilities | 图片输入勾选组 / 推理档位三态组；展开行内字段容器 `[data-dsh-part="image-input"]`、`[data-dsh-part="efforts-mode"]` |
-| `wire-input` | model-capabilities | 档位发送值输入行；`[data-dsh-part="wire-input"]` 内含 `input[type="text"]` |
-| `save` / `reset` / `disable` / `enable` / `reload` | model-capabilities | 扩展区动作按钮（保存 / 重置 / 禁用此提供方 / 启用 / 重新读取）；panel 内裸值按钮 |
-| `disabled-state` | model-capabilities | 已禁用提供方的卡片提示区（含启用按钮）；panel 内 `[data-dsh-part="disabled-state"]` |
-| `disabled-footer` / `disabled-row` | model-capabilities | Models 页底部存档区与其行；`settings.models.footer` 槽内 `section[data-dsh-part="disabled-footer"]` 与其中 `li[data-dsh-part="disabled-row"]` |
 | `lever` | liangshen | 首页输入框内的梁神模式拨杆根（模型选择器左侧）；`[data-dsh-plugin="liangshen"][data-dsh-part="lever"]`，状态由 `data-state`（`on` / `off` / `locked` / `missing`）锚定 |
 | `lever-track` | liangshen | 拨杆底座槽（臂的转动轨道）；lever 内 `[data-dsh-part="lever-track"]` |
 | `lever-arm` | liangshen | 拨杆臂（拉杆 + 球头，随状态转动）；lever 内 `[data-dsh-part="lever-arm"]` |
@@ -199,7 +191,6 @@ shell 的 `[class*="panelGlyph"]` 内）。shell 目前不把 entry id 透传到
 | `skin-center` | skins/skin-center | 一级设置分区 settings.section id `skin-center`（列已安装皮肤，属内置源时显式标记） |
 | `session-id` | dsh-session-id | footer action slot entry id `session-id`；`[data-dsh-plugin="session-id"]`（面板 overlay 根 + 入口触发器） |
 | `usage` | dsh-usage | 一级设置分区 settings.section id `dsh-usage`（创意工坊下方）；`[data-dsh-plugin="usage"]`；侧栏底部速览卡容器 `[data-dsh-usage-foot-card]` |
-| `model-capabilities` | dsh-model-capabilities | Models 页 `settings.models.provider-card` keyed 槽 key `llm-pi-ai`（提供方卡片扩展区）+ `settings.models.footer` 槽 entry id `ui-model-capabilities`（存档区）；`[data-dsh-plugin="model-capabilities"]` |
 | `preset-center` | dsh-preset-center | 创意工坊卡片的「预设」标签页面板（`dsh-workshop.panel` keyed 槽 key `preset`）；`[data-dsh-plugin="preset-center"]` |
 | `liangshen` | dsh-liangshen | 首页输入框内的梁神模式拨杆；`[data-dsh-plugin="liangshen"][data-dsh-part="lever"]`，slot entry id `liangshen-lever` |
 

package/lib/client.js

@@ -237,6 +237,40 @@ window.__ModuleLoader__.load({
 			"data-phase"
 		];
 		/**
+		* Selector shapes whose verdict depends on the element's DESCENDANTS or on
+		* its position among its siblings, rather than on the element alone.
+		*
+		* Everything outside this list is "self-only": inserting a descendant cannot
+		* change whether the element itself matches. Splitting the table on that
+		* boundary is what keeps the ancestor walk cheap without weakening what the
+		* walk is FOR (issue #1732) — re-anchoring an ANCESTOR when a late descendant
+		* turns out to be the anchor that ancestor keys on.
+		*/
+		const DESCENDANT_SENSITIVE_PSEUDO = /:has\(|:empty|:first-child|:last-child|:only-child|:first-of-type|:last-of-type|:only-of-type|:nth-/;
+		/**
+		* Attribute names a selector references. Deliberately a plain scan of the
+		* bracket contents rather than a parsed selector: it also finds a reference
+		* nested INSIDE a functional pseudo-class, which is what lets
+		* `[role="dialog"]:has([data-slot="settings.section"])` answer to a late
+		* data-slot flip on an element inside the dialog.
+		*/
+		const SELECTOR_ATTRIBUTE = /\[([A-Za-z0-9_-]+)/g;
+		const attributeReferences = (selector) => {
+			const names = /* @__PURE__ */ new Set();
+			for (const found of selector.matchAll(SELECTOR_ATTRIBUTE)) names.add(found[1]);
+			return names;
+		};
+		/**
+		* Rule traits derived from the selector text ONCE, at module load, never per
+		* element. The classification is what every batching decision below reads;
+		* re-deriving it inside the walk would reintroduce exactly the per-node work
+		* this change removes (issue #1870).
+		*/
+		const RULE_TRAITS = SEMANTIC_RULES_V1.map((rule) => ({
+			descendantSensitive: DESCENDANT_SENSITIVE_PSEUDO.test(rule.selector),
+			attributes: attributeReferences(rule.selector)
+		}));
+		/**
 		* Safety bound of the ancestor walk, NOT a depth ceiling.
 		*
 		* The walk's normal terminator is the observed root: every node the observer
@@ -251,14 +285,31 @@ window.__ModuleLoader__.load({
 		* a deeper row unanchored — which is the very defect this walk exists to fix
 		* (issue #1732). A measured sweep anchors through 23 wrapper levels and misses
 		* from 24, i.e. only past the point where the tree is pathological.
+		*
+		* Narrowing WHICH rules a hop applies does not make the hop count safe to drop
+		* (issue #1870): a childList record only ever flips a descendant-sensitive
+		* rule, and an attributes record only the rules naming the attribute that
+		* actually changed, so a hop now costs one matches() call per APPLICABLE rule
+		* instead of one per rule in the table. The bound stays as the backstop it has
+		* always been.
 		*/
 		const ANCESTOR_HOPS = 24;
 		function createSemanticAdapter(doc) {
-			const rules = SEMANTIC_RULES_V1.map((rule) => ({
+			const rules = SEMANTIC_RULES_V1.map((rule, index) => ({
 				rule,
 				usable: true,
-				matchedInPass: 0
+				matchedInPass: 0,
+				descendantSensitive: RULE_TRAITS[index].descendantSensitive,
+				attributes: RULE_TRAITS[index].attributes
 			}));
+			/**
+			* The subset a childList delivery may walk: inserting a descendant can flip
+			* a descendant-sensitive rule on an ancestor and nothing else. A self-only
+			* ancestor was already rule-checked when it was added (or by fullPass), and
+			* its verdict cannot change because something inside it grew, so
+			* re-evaluating it is the cost, not the correctness, of the walk.
+			*/
+			const descendantSensitiveRules = rules.filter((live) => live.descendantSensitive);
 			let observer = null;
 			let stamped = 0;
 			let running = false;
@@ -297,24 +348,55 @@ window.__ModuleLoader__.load({
 				if (doc.documentElement) applyToTree(doc.documentElement);
 			};
 			/**
-			* Re-anchor one changed node and its ancestor chain.
+			* Re-anchor one changed node's ancestor chain with the rules that change
+			* could actually have flipped.
 			*
 			* applyToTree only walks DOWNWARD: a rule whose selector matches an ancestor
 			* of the changed node (the panel-list row is recognised by the glyph INSIDE
 			* it) is never re-evaluated when that descendant arrives. React mounts the
 			* row first and the registering plugin's glyph a tick later, so without this
 			* the row keeps no anchor at all until something forces a full pass
-			* (issue #1732). The walk is bounded and stops at the document root.
+			* (issue #1732). The walk is bounded, stops at the document root, and
+			* carries only the rules the reported change can flip: the caller's batch has
+			* already deduplicated the hops it shares with sibling records, so a hop
+			* costs one matches() call per applicable rule, not one per rule in the table
+			* (issue #1870).
 			*/
-			const reanchorAround = (node) => {
+			const reanchorAncestors = (node, subset) => {
+				if (subset.length === 0) return;
 				const root = doc.body ?? doc.documentElement;
 				let current = node;
 				for (let hop = 0; current !== null && hop <= ANCESTOR_HOPS; hop += 1) {
-					for (const live of rules) if (live.usable) applyRule(live, current);
+					for (const live of subset) if (live.usable) applyRule(live, current);
 					if (current === root || current === doc.documentElement) return;
 					current = current.parentElement;
 				}
 			};
+			/**
+			* Drop added roots that another root of the same delivery already contains:
+			* applyToTree on the containing root scans the nested one as part of its own
+			* subtree, and the containing root's own ancestor walk covers the nested
+			* root's ancestors, so re-scanning it is pure duplicate work. Membership is a
+			* Set probe per ancestor hop — no selector-engine call — which keeps a
+			* delivery that mounts a whole subtree at once linear in that subtree.
+			*/
+			const topmostRoots = (roots) => {
+				const kept = [];
+				for (const candidate of roots) {
+					let parent = candidate.parentElement;
+					let nested = false;
+					while (parent !== null) {
+						if (roots.has(parent)) {
+							nested = true;
+							break;
+						}
+						if (parent === doc.documentElement) break;
+						parent = parent.parentElement;
+					}
+					if (!nested) kept.push(candidate);
+				}
+				return kept;
+			};
 			return {
 				get running() {
 					return running;
@@ -325,15 +407,41 @@ window.__ModuleLoader__.load({
 					fullPass();
 					observer = new doc.defaultView.MutationObserver((records) => {
 						try {
+							const roots = /* @__PURE__ */ new Set();
+							const byAttribute = /* @__PURE__ */ new Map();
 							for (const record of records) {
+								if (record.type === "attributes") {
+									const target = record.target.nodeType === 1 ? record.target : null;
+									const name = record.attributeName;
+									if (target === null || name === null) continue;
+									const seen = byAttribute.get(name);
+									if (seen === void 0) byAttribute.set(name, /* @__PURE__ */ new Set([target]));
+									else seen.add(target);
+									continue;
+								}
+								if (record.type !== "childList") continue;
 								for (const node of Array.from(record.addedNodes)) {
 									if (node.nodeType !== 1) continue;
-									const el = node;
-									applyToTree(el);
-									reanchorAround(el.parentElement ?? el);
+									roots.add(node);
+								}
+							}
+							for (const root of topmostRoots(roots)) {
+								applyToTree(root);
+								reanchorAncestors(root.parentElement ?? root, descendantSensitiveRules);
+							}
+							for (const [name, targets] of byAttribute) {
+								const onTarget = [];
+								const onAncestors = [];
+								for (const live of rules) {
+									if (!live.attributes.has(name)) continue;
+									onTarget.push(live);
+									if (live.descendantSensitive) onAncestors.push(live);
+								}
+								if (onTarget.length === 0) continue;
+								for (const target of targets) {
+									for (const live of onTarget) applyRule(live, target);
+									reanchorAncestors(target.parentElement ?? target, onAncestors);
 								}
-								const target = record.target.nodeType === 1 ? record.target : null;
-								if (target !== null && record.type === "attributes") reanchorAround(target);
 							}
 						} catch {}
 					});
@@ -389,6 +497,40 @@ window.__ModuleLoader__.load({
 			const scopes = ACTIVE_VISUAL_SELECTOR.split(", ");
 			const scoped = (selector) => scopes.map((scope) => `${scope} ${selector}`).join(",\n");
 			return `
+    /* macOS window-drag guard. The official base stylesheet turns every DIRECT
+       body child into a "-webkit-app-region: no-drag" region (its selector
+       spares only the app's own root element), so a body-level element that
+       spans the viewport subtracts the whole window from the macOS draggable
+       region and cancels the official [data-window-drag] chrome rows with it:
+       the window can no longer be dragged by its title area, and macOS no
+       longer runs the system double-click action (zoom to fit the screen)
+       there. "pointer-events: none" does not exempt an element from that
+       computation - only a declaration of its own does.
+
+       Every element in the list is a shell this runtime mounts as a body
+       child and declares non-interactive, so the guard has to be inline here
+       rather than imported from the aggregate patch layer (#1907): a
+       standalone install of the skin center never loads that layer, and the
+       decoration layers below are mounted for the stock look too, which is
+       why this rule is NOT scoped under the active-visual heads above.
+
+        - [data-dsh-skin-layer]: the six fixed decoration layers
+          (runtime/decoration-layers.ts);
+        - [data-dsh-composer-frost]: the composer frost follower
+          (runtime/backdrop-scene.ts);
+        - [aria-hidden="true"]: the skin backdrop-filter veil, which carries no
+          data hook of its own (client/background.ts).
+
+       "initial" is the initial value ("none"), which leaves the element and
+       its whole subtree out of the app-region computation; the declaration
+       must be !important because the official selector outranks this one. */
+    html[data-platform="darwin"] body > :is(
+      [data-dsh-skin-layer],
+      [data-dsh-composer-frost],
+      [aria-hidden="true"]
+    ) {
+      -webkit-app-region: initial !important;
+    }
     /* Viewport lock: prevent outer page scrollbar and viewport
        displacement during element focus/scrollIntoView. */
     ${ACTIVE_VISUAL_SELECTOR},
@@ -5188,7 +5330,7 @@ window.__ModuleLoader__.load({
 			sectionState() {
 				const snapshot = this.scope.getSnapshot();
 				const revision = snapshot.revision === void 0 ? "none" : String(snapshot.revision);
-				return `${SKIN_CUSTOM_THEME_NS}: status ${snapshot.status}, writable ${String(snapshot.writable)}, mode ${snapshot.mode}, revision ${revision}`;
+				return `${SKIN_CUSTOM_THEME_NS}: status ${snapshot.status}, writable ${String(snapshot.writable)}, revision ${revision}`;
 			}
 			queueWrite(field, value) {
 				this.pendingWrites += 1;
@@ -5261,8 +5403,7 @@ window.__ModuleLoader__.load({
 					base: layerOf(snapshot.base, key),
 					user: layerOf(snapshot.user, key),
 					revision: snapshot.revision,
-					writable: snapshot.writable,
-					mode: snapshot.mode
+					writable: snapshot.writable
 				};
 				return projected;
 			};
@@ -5329,8 +5470,7 @@ window.__ModuleLoader__.load({
 				base: void 0,
 				user: void 0,
 				revision: void 0,
-				writable: false,
-				mode: "host"
+				writable: false
 			};
 		}
 		/**
@@ -5439,7 +5579,7 @@ window.__ModuleLoader__.load({
 		/** The building package's version, when the bundle carries it. */
 		function bakedVersion() {
 			try {
-				return "0.4.6";
+				return "0.4.8";
 			} catch {
 				return;
 			}