dsh-m 0.9.52 → 0.9.53

package/CHANGELOG.md

@@ -8,6 +8,13 @@ The full release history of dsh-m, maintained bilingually: **Chinese first, Engl
 
 ## 中文
 
+### 0.9.53 变更：ZoneChips 方案A「隐身全量测量」——冷挂载分类行错误折叠根除 + 行容量即时重测
+
+- **动机（0.9.52 端到端验证发现）**：新浏览器 profile（无 localStorage 快照）首开面板时，市场数据未到 → `fit` 在空列表上测量 → 数据到达后重测面对的是按陈旧预算折叠的 DOM（只渲染 1 颗 + 「+N」）→ 棘轮式冻结在「3 颗 + +20」单行折叠。暖会话（快照命中）首挂载即全量数据、一次测准，故 0.7.0 以来从未暴露。姊妹问题：测量 effect 不监听宽度变化，窗口缩放后 `+N` 与实际容量脱节。完整根因链与无头实证见 `docs/plans/2026-10-08-zonechips-visual-clip-requirements.md`。
+- **方案（方案A「隐身全量测量」，经独立评审三轮 11 条意见收敛，评审记录见计划文档修订记录）**：废除 slice 预算，分类 chips **全量渲染**，折叠改为 `.dshm-chips` 上的 `max-height`（实测行高 × 行数）+ `overflow:hidden` 视觉裁剪；越界 chip 逐颗 `visibility:hidden`（与现状「未渲染不进 tab 序」对齐）；`+N`/`⌃` 改右侧 overlay 组（水平并排、钉末可见行右端，gutter `--dshm-clip-gutter:132px` 几何保证与 chip 零相交）；筛选触发器折叠态钉 overlay、展开态维持 in-flow；重测钩子 = deps（`chips.length/expanded/zone/stuck/rowHeight`）+ `ResizeObserver`（rAF 节流）+ `document.fonts.ready`，均 feature-detect 降级（先例 `:947`）。测量纯函数（`chipRows/countBeyondRows/clipTopOf/autoExpandDecision`）下沉 `market-state.js`，20 例 Node 单测直测。
+- **语义保持**：吸顶收一行/回滚两行（0.9.52 哨兵链路不动，裁剪宿主为 `.dshm-chips`、严禁 wrap 裁剪——wrap 裁剪会剪掉哨兵致 stuck 永久误判，评审 Q1 阻断项）；`+N` 展开/`⌃` 收起；激活分类越界自动展开 + autoRef「手动收起后不弹回」（实现拆分为重置/决策两 effect，评审 Q3）；0 计数降透明。行为改进一处：折叠态筛选由「行尾第 3 行 in-flow」改为「末可见行右端 overlay 常驻」。
+- **测试**：新增 `client-zonechips-clip.test.mjs` 20 例 + smoke 全量渲染断言 1 例，全量 1221 例零失败、typecheck 零错误；无头探针 V1–V6 矩阵实证（冷数据到达两行折叠正确 / 三档宽度即时重算 / 精选区不预留 gutter / 吸顶一行重算且回滚恢复 / 筛选与 +N 零遮挡均可点 / 自动展开与 autoRef 不弹回），探针不入库（0.9.52 惯例）。
+
 ### 0.9.52 变更：头部行距统一——吸顶哨兵移出 flex 流，消除搜索框与分类行间 25px 空带
 
 - **动机（主人截图发现）**：市场头部「搜索框行 → 分类 chips 行」间距实测 25px（12 gap + 1px 哨兵 + 12 gap），是「分区 chips → 搜索框行」12px 节奏的两倍余，社区/精选两区一致，视觉上是一条全宽无内容死带；搜索态下 ZoneChips 连带哨兵整体卸载、空带自动消失——证明是布局副作用而非设计节奏。
@@ -393,6 +400,13 @@ The full release history of dsh-m, maintained bilingually: **Chinese first, Engl
 
 ## English
 
+### Changed in 0.9.53 — ZoneChips Plan A "invisible full-list measurement": cold-mount mis-collapse eradicated + live row-capacity re-measurement
+
+- **Motivation (found during 0.9.52 end-to-end verification)**: with a fresh browser profile (no localStorage snapshot), the market data had not arrived when the panel first mounted, so the old `fit` measurement ran on an EMPTY list; when data arrived the re-measure faced a DOM already collapsed by the stale budget (1 chip + "+N") and ratcheted to a frozen "3 chips + +20" single row. Warm sessions hit the snapshot on first mount and measured correctly — which is why this 0.7.0-era defect never surfaced. Sister issue: the measure effect ignores width changes, so `+N` drifts from real capacity after window resizes. Full causal chain with headless evidence: `docs/plans/2026-10-08-zonechips-visual-clip-requirements.md`.
+- **Change (Plan A "invisible full-list measurement", converged through an independent 3-round review with 11 findings)**: the slice-budget is gone — category chips **always render in full**; collapsing is a `max-height` (measured row-height × rows) + `overflow:hidden` visual clip on `.dshm-chips`; chips beyond the clip get per-chip `visibility:hidden` (parity with today's "unrendered = not in tab order"); `+N`/`⌃` become a right-side overlay group (horizontal pair pinned to the last visible row, gutter `--dshm-clip-gutter:132px` geometrically guarantees zero chip intersection); the filter trigger is pinned as an overlay while collapsed and stays in-flow when expanded; re-measure hooks = deps (`chips.length/expanded/zone/stuck/rowHeight`) + `ResizeObserver` (rAF-throttled) + `document.fonts.ready`, all feature-detected with graceful degradation (precedent `:947`). Measurement pure functions (`chipRows/countBeyondRows/clipTopOf/autoExpandDecision`) moved to `market-state.js` with 20 direct Node unit tests.
+- **Semantics preserved**: sticky collapse to one row / restore on scroll-up (the 0.9.52 sentinel chain untouched; the clip host is `.dshm-chips` and clipping the wrap is forbidden — it would clip the sentinel and permanently mis-set stuck, review blocker Q1); `+N` expand / `⌃` collapse; auto-expand when the active category falls beyond the clip + autoRef "manual collapse is respected" (implemented as split reset/decision effects, review Q3); zero-count dimming. One intentional behavior improvement: while collapsed, the filter trigger moved from "third in-flow row end" to a persistent overlay at the last visible row's right end.
+- **Tests**: new `client-zonechips-clip.test.mjs` (20 cases) + 1 full-render smoke assertion; full suite 1221 cases zero failures, typecheck clean; headless probe matrix V1–V6 verified (cold data arrival collapses correctly at two rows / three-width live recompute / curated zone reserves no gutter / sticky one-row recompute and restore / filter & +N zero-overlap and clickable / auto-expand & autoRef no-bounce); probes not committed (0.9.52 convention).
+
 ### Changed in 0.9.52 — uniform header rhythm: sticky sentinel leaves the flex flow, killing the 25px dead band between search row and category chips
 
 - **Motivation (spotted in the owner's screenshots)**: the market header gap between the search row and the category chips row measures 25px (12 gap + 1px sentinel + 12 gap) — more than double the 12px rhythm between zone chips and the search row, identical in both community and curated zones, visually a full-width empty dead band; in search mode ZoneChips (and its sentinel) unmount entirely and the band disappears — proof it is a layout side effect, not designed rhythm.

package/lib/client.js

@@ -28,6 +28,10 @@ var market_state_exports = {};
 __export(market_state_exports, {
   DEFAULT_PAGE_SIZE: () => DEFAULT_PAGE_SIZE,
   MARKET_PAGE_SIZES: () => MARKET_PAGE_SIZES,
+  autoExpandDecision: () => autoExpandDecision,
+  chipRows: () => chipRows,
+  clipTopOf: () => clipTopOf,
+  countBeyondRows: () => countBeyondRows,
   createZoneState: () => createZoneState,
   marketNotice: () => marketNotice,
   mergeLatestFields: () => mergeLatestFields,
@@ -230,6 +234,55 @@ function mergeLatestFields(nextItems, prevItems) {
   });
   return touched ? out : nextItems;
 }
+function chipRows(offsets) {
+  if (!Array.isArray(offsets)) return 0;
+  let rows = 0;
+  let last = null;
+  for (const t of offsets) {
+    if (typeof t !== "number" || !Number.isFinite(t)) continue;
+    if (last === null || t !== last) {
+      rows += 1;
+      last = t;
+    }
+  }
+  return rows;
+}
+function countBeyondRows(offsets, maxRows) {
+  if (!Array.isArray(offsets)) return 0;
+  if (!Number.isInteger(maxRows) || maxRows < 1) return 0;
+  let beyond = 0;
+  let rowCount = 0;
+  let last = null;
+  for (const t of offsets) {
+    if (typeof t !== "number" || !Number.isFinite(t)) continue;
+    if (last === null || t !== last) {
+      rowCount += 1;
+      last = t;
+    }
+    if (rowCount > maxRows) beyond += 1;
+  }
+  return beyond;
+}
+function clipTopOf(offsets, maxRows) {
+  if (!Array.isArray(offsets)) return Infinity;
+  if (!Number.isInteger(maxRows) || maxRows < 1) return Infinity;
+  let rowCount = 0;
+  let last = null;
+  for (const t of offsets) {
+    if (typeof t !== "number" || !Number.isFinite(t)) continue;
+    if (last === null || t !== last) {
+      rowCount += 1;
+      last = t;
+      if (rowCount === maxRows + 1) return t;
+    }
+  }
+  return Infinity;
+}
+function autoExpandDecision(activeTop, clipTop, autoRefMatched, expanded) {
+  const beyond = typeof activeTop === "number" && Number.isFinite(activeTop) && typeof clipTop === "number" && Number.isFinite(clipTop) && activeTop >= clipTop;
+  if (!beyond || autoRefMatched) return { record: false, expand: false };
+  return { record: true, expand: !expanded };
+}
 var MARKET_PAGE_SIZES, DEFAULT_PAGE_SIZE, CURATED_ORDER, CURATED_LABELS, CURATED_IDS, SLUG_RE, SORT_FIELDS, sameSort, FALLBACK_REGISTRY_STATE, FALLBACK_COMMUNITY, LATEST_MERGE_FIELDS;
 var init_market_state = __esm({
   "src/client/market-state.js"() {
@@ -1505,7 +1558,7 @@ var h = React.createElement;
 var { useState, useEffect, useLayoutEffect, useCallback, useMemo, useRef } = React;
 var PLUGIN_ID = "dsh-m";
 var API = "/dshm";
-var { DEFAULT_PAGE_SIZE: DEFAULT_PAGE_SIZE2, MARKET_PAGE_SIZES: MARKET_PAGE_SIZES2, pageItems: pageItems2, createZoneState: createZoneState2, normalizeMarketQuery: normalizeMarketQuery2, resetPageOnFilterChange: resetPageOnFilterChange2, normalizeMarketResponse: normalizeMarketResponse2, registryNotice: registryNotice2, zoneChips: zoneChips2, marketNotice: marketNotice2, searchSourceOf: searchSourceOf2, mergeLatestFields: mergeLatestFields2 } = (init_market_state(), __toCommonJS(market_state_exports));
+var { DEFAULT_PAGE_SIZE: DEFAULT_PAGE_SIZE2, MARKET_PAGE_SIZES: MARKET_PAGE_SIZES2, pageItems: pageItems2, createZoneState: createZoneState2, normalizeMarketQuery: normalizeMarketQuery2, resetPageOnFilterChange: resetPageOnFilterChange2, normalizeMarketResponse: normalizeMarketResponse2, registryNotice: registryNotice2, zoneChips: zoneChips2, marketNotice: marketNotice2, searchSourceOf: searchSourceOf2, mergeLatestFields: mergeLatestFields2, chipRows: chipRows2, countBeyondRows: countBeyondRows2, clipTopOf: clipTopOf2, autoExpandDecision: autoExpandDecision2 } = (init_market_state(), __toCommonJS(market_state_exports));
 var { readMarketSnapshot: readMarketSnapshot2, writeMarketSnapshot: writeMarketSnapshot2, isDefaultFirstPageQuery: isDefaultFirstPageQuery2 } = (init_market_snapshot(), __toCommonJS(market_snapshot_exports));
 var { backdropCloseHandlers: backdropCloseHandlers2 } = (init_backdrop(), __toCommonJS(backdrop_exports));
 var { createMarkdown: createMarkdown2 } = (init_markdown(), __toCommonJS(markdown_exports));
@@ -2133,7 +2186,10 @@ var CSS = `
 .dshm-btn.sm{padding:3px 9px;font-size:11px}
 .dshm-input{flex:1;min-width:120px;border:1px solid var(--dsw-alias-border-l2,#c7d2fe);background:var(--dsw-alias-bg-layer-2,transparent);color:var(--dsw-alias-label-primary,inherit);border-radius:999px;padding:7px 14px;font:inherit;font-size:12px;outline:none}
 .dshm-input:focus{border-color:var(--dsw-alias-interactive-bg-selected,#4f46e5)}
-.dshm-chips{display:flex;flex-wrap:wrap;gap:6px}
+.dshm-chips{display:flex;flex-wrap:wrap;gap:6px;position:relative}
+.dshm-chips-clip{overflow:hidden}
+.dshm-chips-gutter{padding-right:var(--dshm-clip-gutter,132px)}
+.dsvm-chipmore{position:absolute;right:8px;bottom:8px;display:flex;align-items:center;gap:8px;min-height:28px;background:var(--dsw-alias-bg-base,#fff);border:1px solid var(--dsw-alias-border-l1,rgba(127,127,127,.18));border-radius:999px;padding:2px 8px;box-sizing:border-box}
 .dsvm-searchrow{display:flex;align-items:center;gap:8px}
 .dsvm-searchrow .dshm-search{flex:1;display:flex}
 .dshm-search{position:relative}
@@ -2656,42 +2712,69 @@ function ZoneChips({ zone, counts, labels, active, onPick, trailing, wrapTitle }
   const chips = useMemo(() => zoneChips2(counts, labels, zone), [counts, labels, zone]);
   const [expanded, setExpanded] = useState(false);
   const [stuck, setStuck] = useState(false);
-  const [fit, setFit] = useState({ rows2: 99, rows1: 99 });
+  const [geom, setGeom] = useState(null);
+  const [rowHeight, setRowHeight] = useState(0);
   const wrapRef = useRef(null);
   const sentinelRef = useRef(null);
   const autoRef = useRef(null);
-  const collapsedBudget = Math.min(stuck ? fit.rows1 : fit.rows2, chips.length);
+  const maxRows = stuck ? 1 : 2;
   const activeIdx = active ? chips.findIndex((c) => c.id === active) : -1;
+  const maxH = maxRows * (rowHeight || 22) + (maxRows - 1) * 6;
+  const measure = useCallback(() => {
+    const el = wrapRef.current;
+    if (!el || expanded) return;
+    const tops = [];
+    let rh = 0;
+    for (const k of el.children) {
+      if (!(k instanceof HTMLElement) || k.getAttribute("data-chip") !== "1") continue;
+      tops.push(k.offsetTop);
+      if (!rh && k.offsetHeight) rh = k.offsetHeight;
+    }
+    if (!tops.length) return;
+    const next = { tops, clipTop: clipTopOf2(tops, maxRows), hiddenCount: countBeyondRows2(tops.slice(1), maxRows) };
+    setGeom((prev) => prev && prev.tops.length === next.tops.length && prev.clipTop === next.clipTop && prev.hiddenCount === next.hiddenCount ? prev : next);
+    setRowHeight((prev) => Math.abs(prev - rh) <= 0.5 ? prev : rh);
+  }, [expanded, maxRows]);
   useEffect(() => {
     if (!active) {
       autoRef.current = null;
       setExpanded(false);
-      return;
-    }
-    if (activeIdx >= collapsedBudget && autoRef.current !== active) {
-      autoRef.current = active;
-      setExpanded(true);
     }
-  }, [active, activeIdx, collapsedBudget]);
+  }, [active]);
+  useEffect(() => {
+    if (!active || !geom) return;
+    const activeTop = geom.tops[activeIdx + 1];
+    const d = autoExpandDecision2(activeTop, geom.clipTop, autoRef.current === active, expanded);
+    if (d.record) autoRef.current = active;
+    if (d.expand) setExpanded(true);
+  }, [active, activeIdx, expanded, geom]);
   useLayoutEffect(() => {
+    if (!expanded) measure();
+  }, [chips.length, expanded, zone, stuck, rowHeight, measure]);
+  useEffect(() => {
     const el = wrapRef.current;
-    if (!el || expanded) return;
-    let rows2 = 0;
-    let rows1 = 0;
-    let rowCount = 0;
-    let lastTop = null;
-    for (const k of el.children) {
-      if (!(k instanceof HTMLElement) || k.getAttribute("data-chip") !== "1") continue;
-      const t = k.offsetTop;
-      if (lastTop === null || t !== lastTop) {
-        rowCount += 1;
-        lastTop = t;
-      }
-      if (rowCount <= 2) rows2 += 1;
-      if (rowCount <= 1) rows1 += 1;
-    }
-    setFit({ rows2, rows1 });
-  }, [chips.length, expanded, zone]);
+    if (!el || expanded || typeof ResizeObserver === "undefined") return;
+    let raf = 0;
+    const ro = new ResizeObserver(() => {
+      cancelAnimationFrame(raf);
+      raf = requestAnimationFrame(measure);
+    });
+    ro.observe(el);
+    return () => {
+      ro.disconnect();
+      cancelAnimationFrame(raf);
+    };
+  }, [expanded, measure]);
+  useEffect(() => {
+    if (expanded || typeof document === "undefined" || !document.fonts?.ready) return;
+    let cancelled = false;
+    document.fonts.ready.then(() => {
+      if (!cancelled) measure();
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [expanded, measure]);
   useEffect(() => {
     const s = sentinelRef.current;
     if (!s || typeof IntersectionObserver === "undefined") return;
@@ -2699,41 +2782,62 @@ function ZoneChips({ zone, counts, labels, active, onPick, trailing, wrapTitle }
     io.observe(s);
     return () => io.disconnect();
   }, []);
-  const budget = expanded ? chips.length : collapsedBudget;
-  const shown = chips.slice(0, budget);
-  const hidden = chips.length - shown.length;
-  const btn = (c) => h(
-    "button",
-    { key: c.id, "data-chip": "1", className: `dshm-chip${active === c.id ? " on" : ""}${c.count === 0 ? " zero" : ""}`, onClick: () => onPick(active === c.id ? null : c.id) },
-    // 0.9.45 U3/U7：0 计数桶显式渲染「0」+ 降透明（社区区 chip 计数恒 >0，行为不变）
-    `${c.labelKey ? lookup(c.labelKey) : c.label} ${c.count || 0}`
-  );
+  const clip = !expanded;
+  const overlay = clip && (trailing != null || geom && geom.hiddenCount > 0);
+  const clipTop = geom ? geom.clipTop : Infinity;
+  const hiddenCount = geom ? geom.hiddenCount : 0;
+  const btn = (c, i) => {
+    const top = geom ? geom.tops[i + 1] : null;
+    const clipped = clip && geom && typeof top === "number" && top >= clipTop;
+    return h(
+      "button",
+      {
+        key: c.id,
+        "data-chip": "1",
+        style: clipped ? { visibility: "hidden" } : void 0,
+        className: `dshm-chip${active === c.id ? " on" : ""}${c.count === 0 ? " zero" : ""}`,
+        onClick: () => onPick(active === c.id ? null : c.id)
+      },
+      // 0.9.45 U3/U7：0 计数桶显式渲染「0」+ 降透明（社区区 chip 计数恒 >0，行为不变）
+      `${c.labelKey ? lookup(c.labelKey) : c.label} ${c.count || 0}`
+    );
+  };
   return h(
     React.Fragment,
     null,
     h(
       "div",
       { className: "dsvm-chipswrap" },
-      // 吸顶检测哨兵（0.9.52）：移入 sticky 容器内绝对定位——sticky 本身即定位上下文，
-      // 哨兵退出 .dshm-body 的 flex 流，不再多吃一份 12px gap（此前哨兵作为兄弟子项在
-      // 搜索框与分类行之间压出 12+1+12=25px 空带，行距节奏破坏）。top:-5px 复刻旧几何
-      // （旧兄弟哨兵顶边恰在 wrap 上沿上方 5px），IO 出视口触发点逐像素等价。
+      // 吸顶检测哨兵（0.9.52）：wrap 内 top:-5px 绝对定位，出视口 ⇒ stuck。⚠️ 裁剪宿主是
+      // .dshm-chips（D3）：wrap 决不可 overflow:hidden，否则哨兵被剪 → IO 恒 false → 永久吸顶态。
       h("div", {
         ref: sentinelRef,
         style: { position: "absolute", top: "-5px", left: 0, width: "1px", height: "1px", pointerEvents: "none" }
       }),
       h(
         "div",
-        { ref: wrapRef, className: "dshm-chips", title: wrapTitle || void 0 },
+        {
+          ref: wrapRef,
+          className: `dshm-chips${clip ? " dshm-chips-clip" : ""}${clip && overlay ? " dshm-chips-gutter" : ""}`,
+          title: wrapTitle || void 0,
+          style: { maxHeight: clip ? `${maxH}px` : "none" }
+        },
         h("button", { "data-chip": "1", className: `dshm-chip${active == null ? " on" : ""}`, onClick: () => onPick(null) }, lookup("cat.all")),
-        ...shown.map(btn),
-        hidden > 0 ? h(
-          "button",
-          { "data-chip": "1", className: "dshm-chip", onClick: () => setExpanded(!expanded) },
-          expanded ? "\u2303" : `+${hidden}`
-        ) : null,
-        trailing || null
-      )
+        ...chips.map((c, i) => btn(c, i)),
+        expanded ? [
+          h("button", { key: "collapse", "data-chip": "1", className: "dshm-chip", onClick: () => setExpanded(false) }, "\u2303"),
+          trailing || null
+        ] : null
+      ),
+      // 折叠态右侧 overlay 组（D5/D6）：[筛选][+N] 水平并排、钉末可见行右端；gutter 保证与 chip 零相交。
+      // 吸顶单行态末可见行=第 1 行，两按钮仍同行并排（第④类碰撞结构性消除，R2-N1）。
+      // ⚠️ 展开态不用 overlay（⌃/筛选 in-flow，与现状一致）；弹层锚点 .dsvm-filterwrap 随组定位。
+      clip && overlay ? h(
+        "div",
+        { className: "dsvm-chipmore" },
+        trailing || null,
+        hiddenCount > 0 ? h("button", { className: "dshm-chip", onClick: () => setExpanded(true) }, `+${hiddenCount}`) : null
+      ) : null
     )
   );
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-m",
-  "version": "0.9.52",
+  "version": "0.9.53",
   "description": "可自定义收录清单的 DSH 插件市场：收录、安装、卸载、升级一站完成，附 agent 工具与 dshm CLI。",
   "license": "MIT",
   "type": "module",

package/registry.json

@@ -87,7 +87,7 @@
     {
       "id": "dsh-skip-browser-auth",
       "name": "DSH Skip Browser Auth",
-      "description": "替换官方 Connection 跳过 BrowserAuth，免 Token；已适配 0.1.2-rc.1、0.1.5-rc.1/rc.2、0.1.7-rc.1/rc.2 与 0.2.0-rc.1/rc.2。",
+      "description": "替换官方 Connection 跳过 BrowserAuth，免 Token；已适配七个已审计精确版本对，详见仓库。仅支持 web profile；desktop profile（存在 dsh-desktop-host 的环境）自动休眠，属设计行为。",
       "category": "self-dev",
       "tags": ["BrowserAuth", "连接", "安全", "工具"],
       "verified": ["0.1.2-rc.1", "0.1.5-rc.1", "0.1.5-rc.2", "0.1.7-rc.1", "0.1.7-rc.2", "0.2.0-rc.1", "0.2.0-rc.2"],