dsh-auto-collapse 0.1.7 → 0.2.1

package/lib/index.js

@@ -2,55 +2,13 @@ import z from "@deepseek-ai/schemastery";
 const name = "dsh-auto-collapse";
 const inject = [];
 const DEFAULT_STATUS_TEXT = "Deep sleeping...";
-const AUTO_COLLAPSE_SETTINGS_NAMESPACE = "dsh-auto-collapse";
-const AUTO_COLLAPSE_SETTINGS_SCHEMA = z.object({
-  statusText: z.string().default(DEFAULT_STATUS_TEXT)
-});
-const FIBER_DISPOSED = 4;
-const FIBER_UNLOADING = 5;
-function isUnloading(ctx) {
-  const state = ctx?.fiber?.state;
-  return state === FIBER_UNLOADING || state === FIBER_DISPOSED;
-}
-function installSettingsSection(ctx, ns, schema, entry, hooks) {
-  ;
-  ctx.inject(["settings"], (sctx) => {
-    const scope = sctx.settings.register(ns, schema, {
-      base: entry,
-      ...hooks.validate === void 0 ? {} : { validate: hooks.validate }
-    });
-    hooks.setSource(() => scope.get());
-    sctx.effect(() => () => {
-      if (isUnloading(ctx)) return;
-      hooks.setSource(() => entry);
-      hooks.onChange();
-    });
-    hooks.onChange();
-    scope.watch(() => {
-      if (isUnloading(ctx)) return;
-      hooks.onChange();
+function apply(ctx, config = {}) {
+  ctx.inject(["settings"], (service) => {
+    service.settings.register(name, z.object({ statusText: z.string().default(DEFAULT_STATUS_TEXT) }), {
+      base: { statusText: config.statusText ?? DEFAULT_STATUS_TEXT }
     });
   });
 }
-function apply(ctx, config = {}) {
-  let current = () => ({ statusText: config.statusText ?? DEFAULT_STATUS_TEXT });
-  installSettingsSection(
-    ctx,
-    AUTO_COLLAPSE_SETTINGS_NAMESPACE,
-    AUTO_COLLAPSE_SETTINGS_SCHEMA,
-    {
-      statusText: config.statusText ?? DEFAULT_STATUS_TEXT
-    },
-    {
-      setSource: (source) => {
-        current = source;
-      },
-      onChange: () => {
-        void current;
-      }
-    }
-  );
-}
 export {
   apply,
   inject,

package/lib/types/client.d.ts

@@ -1,7 +1,8 @@
 export declare const name = "dsh-auto-collapse";
 /**
  * 不声明必需服务：slots/settingsScope 只是可选增强能力，不能阻止核心折叠
- * 插件启动。运行时通过 ctx.get() 读取，服务不存在时仅跳过设置卡片与配置订阅。
+ * 插件启动。下方通过 ctx.inject() 等待两个服务，支持晚于插件出现
+ * 以及卸载后重连；服务永久缺席时仅跳过设置卡片与配置订阅。
  */
 export declare const inject: string[];
 /** 客户端根上下文的最小结构化类型（仅用 cordis 标准 effect，无运行时依赖）。 */
@@ -9,5 +10,7 @@ export interface FoldClientCtx {
     effect(fn: () => unknown, label?: string): unknown;
     /** Cordis 动态客户端上下文提供的可选服务查询。 */
     get?<T>(name: string): T | undefined;
+    /** 可选服务生命周期：服务齐备时进入，detach 时自动清理回调上的 effect。 */
+    inject?(services: readonly string[], setup: (ctx: FoldClientCtx) => void): void;
 }
 export declare function apply(ctx: FoldClientCtx): void;

package/lib/types/controller.d.ts

@@ -0,0 +1,50 @@
+/** Native L1 owns turns; this controller owns only mixed-work L2 groups. */
+export declare class FoldController {
+    private flow;
+    private observer;
+    private view;
+    private readonly model;
+    private readonly state;
+    private readonly scheduler;
+    private readonly status;
+    private items;
+    private groups;
+    private infos;
+    private itemGroups;
+    private rowItems;
+    private seatGroups;
+    private turnGroups;
+    private controls;
+    private readonly dirtySeats;
+    private readonly dirtyItems;
+    private readonly dirtyGroups;
+    private modelDirty;
+    private discover;
+    private force;
+    private started;
+    private disposed;
+    private lastError;
+    private readonly stats;
+    private readonly ready;
+    private readonly visible;
+    private readonly reveal;
+    constructor(statusText?: () => string | undefined);
+    start(): void;
+    refresh(): void;
+    refreshStatus(): void;
+    /** Small diagnostics for regressions/performance, never rendered into the chat. */
+    diagnostics(): Readonly<typeof this.stats> & {
+        groups: number;
+        items: number;
+    };
+    private itemAt;
+    private dirtySeatGroups;
+    private mutations;
+    private switchFlow;
+    private rebuild;
+    private prepare;
+    private flush;
+    private toggle;
+    private revealAt;
+    stop(): void;
+}

package/lib/types/dom-view.d.ts

@@ -0,0 +1,36 @@
+import type { WorkItem } from './work-model.js';
+import type { GroupSummary } from './summary.js';
+export interface PreparedGroup {
+    id: string;
+    expanded: boolean;
+    summary: GroupSummary;
+    anchor?: HTMLElement;
+    desired: Set<HTMLElement>;
+}
+/** Own only group overlays and reversible hidden attributes, never native content or inline styles. */
+export declare class GroupView {
+    private readonly flow;
+    private readonly toggle;
+    private readonly owner;
+    private readonly rows;
+    private readonly leases;
+    private readonly writes;
+    private readonly displays;
+    private readonly style;
+    constructor(flow: HTMLElement, toggle: (id: string) => void);
+    private writeHidden;
+    ownMutation(record: MutationRecord): boolean;
+    clearWrites(): void;
+    detachedGroups(nodes: readonly Node[]): string[];
+    beginRead(): void;
+    private fold;
+    private release;
+    private externallyHidden;
+    private create;
+    summarize(id: string, summary: GroupSummary, expanded: boolean): void;
+    prepare(id: string, items: readonly WorkItem[], expanded: boolean, summary: GroupSummary, turnCollapsed: boolean): PreparedGroup;
+    apply({ id, expanded, summary, anchor, desired }: PreparedGroup): void;
+    focus(id: string): void;
+    remove(id: string): void;
+    dispose(): void;
+}

package/lib/types/fold.d.ts

@@ -1,323 +1,2 @@
-/**
- * FoldController —— dsh-auto-collapse 的核心。
- *
- * 把会话流（[data-chat-flow]）里的“非正文 display”折叠成内联的一行，
- * 折叠行实时显示**当前正在进行的工作**（与 Codex 对齐）：
- *
- *   - 块里有运行中的工具调用 → 标题 = "Running" + 工具名（Bash/Read/
- *     Search…，读 data-tool），摘要 = 正在执行的命令/路径/查询（读工具
- *     卡片的 summary 行）；标题与摘要带平滑呼吸动画（Pulse）。
- *   - 块里正在思考（think running）→ 标题 = "Thinking"，摘要 = 思考的
- *     最新一行（读 [data-follow-end]，官方 ReasoningRow 的实时摘要锚点）。
- *   - 全部完成 → 标题 = 类型总结（编辑了文件 / 运行了命令 / 已思考 /
- *     上下文注入），摘要清空；出错 → 红色，中断 → 琥珀。
- *
- * 另外把官方 ChatView 尾部的运行状态行文字（新版 "深度求索中..." / 旧版
- * "Deep diving..."，见 TURN_STATUS_COPY_RE）替换为可配置的状态提示词
- * （默认 "Deep sleeping..."；流光特效在 CSS 上，替换文本节点不影响，
- * 宿主追加的用时后缀原样保留）。React 重渲染会恢复原文，pass() 每轮自愈改回。
- * 设置为空时不替换，等价于恢复官方原文。
- *
- * 点击一行展开，再点收起；折叠态下若有行被选中（详情联动）自动展开。
- *
- * 折叠规则（沿用 dsh-web-archive 验证过的算法）：每个回合合成一块——
- * 某条消息的 Think 推理组与其后紧跟的工具组合并成一块（只有 think 或
- * 只有工具组时各自成块），在块宿主**原位**插入 chip；带正文文本的消息
- * 断开合并。结构保持 文本a - [折叠块] - 文本b - 文本c。
- *
- * 与 React 的关系：chip 插入 React 管理的 flow 子树内，但只做前置插入与
- * style.display 切换（React 的 vdom diff 不会感知也不会清除 CSSOM 上的
- * 手动样式）；MutationObserver 每轮把结构变化合并到一次
- * requestAnimationFrame 里重放（自愈：React 重渲染、切换会话、流式新
- * 卡片都会自动跟上）。
- *
- * 零核心改动：不修改任何 slot 注册，不依赖任何 client 服务。
- */
-export declare class FoldController {
-    private observer;
-    /** 防止同一个控制器重复注册 observer、定时器和可见性监听。 */
-    private started;
-    /** body 尚未创建时等待 DOMContentLoaded，再补一次启动。 */
-    private waitingForBody;
-    private readonly onDomContentLoaded;
-    private raf;
-    private timer;
-    private disposed;
-    private lastPassError;
-    private flow;
-    /** 稳定 block key → 当前 React 渲染中的 chip/host。 */
-    private chips;
-    private currentBlocks;
-    private blockExpanded;
-    /** host → 三级合并思考行（展开二级后连续思考合并显示为一个三级行）。 */
-    private mergedThinks;
-    /** 合并思考行的展开状态（true = 显示合并内容块）。 */
-    private mergedExpanded;
-    /** 合并内容缓存（首次从原生行读取后保存，pass 重建内容块时不再重新展开原生行）。 */
-    private mergedBodyTexts;
-    /** 合并行标题缓存（原生行展开态提取不到摘要时保持首次标题，不丢成“思考”）。 */
-    private mergedTitles;
-    /** 稳定 segment key → 一级折叠行与展开状态。 */
-    private segmentStates;
-    /** segment 首次观察到 running 的时间，用于没有官方时长的实时回合。 */
-    private runningSince;
-    /** 曾完成过的 segment key：段恢复运行时据此重开本地计时，防止重新结算
-     * 的本地时长吞掉完成间隙。 */
-    private completedOnce;
-    /** 插件改写 display 前的精确原值；受控集合用于分类漂移和 stop() 恢复。 */
-    private originalDisplay;
-    private controlledDisplay;
-    /** 元素 → 插件最后确保的 display 值：恢复前与当前内联值比对，漂移即视为
-     * 外部介入（镜像 turnStatusTexts 的 original/written 双快照守卫，issue #11）。 */
-    private writtenDisplay;
-    /** 被改写为状态提示词的原生状态文本：original = 宿主原文（卸载还原用），
-     * written = 插件最后一次写入的值（仅当节点仍等于它时才还原，避免覆盖
-     * 宿主在插件写入之后的状态更新）。 */
-    private turnStatusTexts;
-    /** 当前状态提示词读取器；返回空串时插件不替换状态行。 */
-    private statusTextProvider;
-    /** 正文判定缓存（消息元素 → 有无正文）：流式期间只有被 mutation 命中的
-     * 消息失效重算，历史消息跨 pass 复用，避免每帧全量 TreeWalker。 */
-    private bodyTextCache;
-    /** 自上次 pass 以来子树发生变化的 flow 顶层消息；pass 开头统一失效。 */
-    private dirtyMessages;
-    /** 在途显示动画（元素 → 记录）：冲突仲裁、记账对齐与生命周期清理的依据。
-    /** 在途显示动画（元素 → 记录）：冲突仲裁、记账对齐与生命周期清理的依据。
-     * 用 Map 不用 WeakMap——switchFlow/stop 需要遍历全量 cancel。 */
-    private pendingAnims;
-    /** 手势点击的一次性可动画 block key；segment 级点击另保留中间正文的门控。 */
-    private animatableKeys;
-    /** segment 点击时只让点击前已存在的 block 播放 reveal；流式中新出现的
-     * 临时分裂块直接显示，避免分类收敛时留下半透明 stale chip。 */
-    private animatableSegmentBlocks;
-    /** 外部变更对账定时器句柄（自重排 setTimeout 链，见 armAuditLoop）。 */
-    private auditTimer;
-    /** 上一轮 pass 记录的关键元素内联 display，用于 audit 轻量检测漂移。
-     * audit 只读这份快照，不在页面稳定时重新执行完整 pass。 */
-    private auditDisplays;
-    /** 自上次 pass 以来 flow 子树发生过结构变化（childList）或正文判定翻转：
-     * 为 true 时 pass 重建分块快照，否则复用 currentBlocks——characterData/
-     * attributes 批次（流式文本、data-state 翻转）不改变块结构，跳过全量
-     * querySelectorAll 重扫（issue #14：长会话下每轮重扫造成主线程卡顿）。 */
-    private structureDirty;
-    /** 本轮 pass 的原生 turn 摘要快照（turn id → 开合态）：每轮重建，不跨轮复用；
-     * data-open 翻转不改变块结构也能驱动重算，见 buildNativeTurnMap。 */
-    private nativeTurns;
-    /** 被折叠掏空后藏起的中间包装层（真机 44px vs 28px 真因：think 行全隐后
-     * 其父容器变零高度空壳，仍作为 flex item 参与父级 gap，凭空多出 16px）。
-     * 内容恢复（展开/流式追加/块转世）时同函数恢复显示；switchFlow 清空。 */
-    private emptiedWrappers;
-    /** 本轮 pass 内有过 display 实写（hide/restore 瞬时路径）。空洞发现的触发
-     * 条件之一：纯 display 收放不产生 childList，不触发 structureDirty。
-     * settle 触发的后续 pass 则由 settleFired 覆盖。读后即清（见发现调用点）。 */
-    private displayTouched;
-    /** 有 fade 自然结算过（chipSettle 跑过）。结算本身不写 display，但它意味着
-     * 某行刚变隐藏——空洞可能刚形成。 */
-    private settleFired;
-    /** 滚动稳定化（issue #14）：flow 最近的滚动容器缓存（按 flow 身份失效）。 */
-    private scrollContainer;
-    private scrollContainerFlow;
-    /** 回到前台立即补一轮对账；后台 tab 由 document.hidden 门控跳过。 */
-    private readonly onVisibilityChange;
-    constructor(statusTextProvider?: () => string | undefined, options?: {
-        auditIntervalMs?: number;
-    });
-    private readonly auditIntervalMs;
-    /** 设置变更后重跑一轮，让状态提示词立即生效。 */
-    refresh(): void;
-    start(): void;
-    /** 外部显示变更对账循环（issue #11 Bug B）：外部对宿主行的 style 写入不产生
-     * observer record（style 不在 attributeFilter 内，监听会因插件自身直写 style
-     * 自激），改用低频轻量对账兜底——发现漂移后才由 pass 收敛；
-     * 后台 tab 由 document.hidden 门控跳过，回前台由 visibilitychange 立即补一轮。
-     * 用自重排 setTimeout 链而非 setInterval：与 schedule 的兜底定时器同源，
-     * 测试桩 clearTimers 后链条自然熄灭。 */
-    private armAuditLoop;
-    private rearmAudit;
-    /** 低成本显示状态对账：只有发现外部漂移时才启动完整 pass。
-     *
-     * 外部 style.display 写入不会产生当前 observer 的 attribute 记录，
-     * 因此仍保留 audit；但稳定页面不应每秒重扫整个 flow。快照只覆盖
-     * flow 顶层行、插件控制中的宿主行和插件自有展示行，避免引入布局读取。 */
-    private audit;
-    stop(): void;
-    /** body 级 observer 只负责发现 flow 替换；已有 flow 外的文本变化不再触发全量扫描。 */
-    private shouldSchedule;
-    /** 判断 mutation 是否会影响宿主 flow；插件自有节点的回写直接忽略，
-     * 避免“pass 插入 chip → observer 再开一轮 pass”的自激循环。 */
-    private isRelevantMutation;
-    /** 记录本批 mutation 命中的 flow 顶层消息，供正文判定缓存定向失效。
-     * 从 record.target 沿 parentNode 走到 flow 的直接子级即所属消息。
-     * 失效粒度（issue #14）：只有 childList 使分块快照失效；flow 直挂层的
-     * 插件节点/文本节点与 flow 外的混批记录不影响任何消息的正文判定，跳过
-     * 而非全量失效——旧逻辑把它们全部放大成 O(全会话) 的 TreeWalker 重扫，
-     * 长会话流式期间每帧如此。空批次仍保守全量失效（测试桩的调度通知）。 */
-    private markDirty;
-    private schedule;
-    /** 异步 observer 异常不能静默杀死协调器；保留非可视诊断并允许后续 mutation 重试。 */
-    private runPass;
-    private reportError;
-    /** 一轮重放：重算堆积 → 应用折叠/展开 → 摆放并更新 chip → 替换状态行。 */
-    private pass;
-    /** flow 最近的滚动容器（issue #14 滚动稳定化的测量基准）：沿父链找第一个
-     * overflow-y 为 auto/scroll 且实际可滚动的祖先。结果按 flow 身份缓存；
-     * 找不到时不缓存（内容增长后祖先可能变为可滚动），每 pass 重探的代价
-     * 只是几次 clean-layout 的 computed style / scrollHeight 读取。 */
-    private findScrollContainer;
-    /** 几何写入前捕捉贴底意图（issue #14）：视口距底 ≤ 上游 FOLLOW_THRESHOLD
-     * 时返回锚点，stabilizeScrollAfterFold 在写入后同帧钉回底部。远离底部
-     * （用户正在滚动浏览）时不干预——视口上方的高度变化由浏览器 scroll
-     * anchoring 补偿，视口下方的折叠不可见，插件再写 scrollTop 只会加入
-     * 上游吸底回写的拉锯。 */
-    private captureScrollAnchor;
-    /** 几何写入后把贴底视口钉回底部：折叠让 scrollHeight 缩小时若不在此帧
-     * 补写 scrollTop，宿主 ChatView 要到下一帧 ResizeObserver 才吸底回写，
-     * 中间的空档让触控板惯性滚动乘虚而入，反复折叠时表现为上下抽搐（用户
-     * 实测：长会话滚到底部附近无法稳定定位）。同一帧内钉回后，宿主的吸底
-     * 回写成为幂等 no-op，不再是第二个 scrollTop 写入方。 */
-    private stabilizeScrollAfterFold;
-    /** flow 元素变化即视为会话切换：完整恢复旧 flow，再从新 DOM 重建。 */
-    private switchFlow;
-    private createProcessedRow;
-    private syncProcessedRow;
-    private placeProcessedRow;
-    /** 原生收起时隐藏本块插件自有 overlay（chip/合并行+内容块）：只做
-     * display 直写，不清钉住之外的账本、不删展开态，供原生再展开后复用。
-     * 在途 WAAPI 动画不追踪取消——收尾回调只做幂等终态对齐，无残留。 */
-    private hideOverlayForNativeCollapse;
-    private reconcileBlock;
-    /**
-     * 掏空包装层对账（真机 44px vs 28px 真因修复）。
-     *
-     * 折叠把某容器的子行全部 display:none 后，该容器变零高度空壳，但仍是
-     * 父级 flex 的 item 并参与 gap（如正文体 flex-column gap:16px），凭空多出
-     * 一份间距。隐藏这类空壳可让 gap 塌缩；子内容恢复可见（展开/流式追加/
-     * 块转世）时恢复显示。
-     *
-     * 安全边界：
-     * - 只看 block.host 内部、不含 host 本人（宿主显隐归 segment 逻辑）；
-     * - 跳过结构 seat（data-chat-flow-kind / data-chat-anchor-key）与插件
-     *   自身 overlay（dshcf- 前缀类）；
-     * - 只隐藏内容空洞（无可见子内容）：零高度无文本的空壳 display:none 与
-     *   保持显示像素一致，只塌缩父级 gap；任何一方恢复内容即恢复显示。
-     */
-    /**
-     * 空洞包装层兜底发现：按宿主直扫 div（仅结构变化轮次调用）。
-     * 只做隐藏侧：空洞即藏并记入 tracked；恢复侧由 syncEmptiedWrappers 的
-     * tracked 复核与 audit 承担。与按行 walk 共用同一安全边界（结构 seat /
-     * 插件 overlay / 宿主本人不碰）。
-     */
-    private discoverHollowWrappers;
-    private syncEmptiedWrappers;
-    /** 内容空洞判定：无可见子内容（文本/元素任一可见即非空洞）。隐藏者是谁
-     * 不重要——零高度无文本节点 display:none 与保持显示像素一致（只塌缩父级
-     * gap，正是要修的幻影）；任何一方恢复内容，下轮 pass/audit 即恢复显示。
-     * isDisplayed 走 getComputedStyle（桩内退化为内联，语义一致）。 */
-    private isHollow;
-    private ensureChip;
-    private suppressBlock;
-    private retainDisplayControl;
-    private cleanupStaleChips;
-    /** 连续思考合并行：插在第一个思考行前，标题用第一行思考内容；
-     * 点击切换显示/隐藏全部原始思考行。 */
-    private syncMergedThink;
-    /** 展开合并行：直接读各思考行文本合成内容块（不依赖原生行展开：
-     * 程序化 click 不触发 React 展开，且后台 tab 的 rAF 不执行）。
-     * 返回是否成功——思考行已不可读（parts 为空）时返回 false，调用方
-     * 据此保持收起态，避免展开状态与内容块脱节。 */
-    private expandMergedBody;
-    /** 创建/更新合并内容块（缓存优先，不重新展开原生行）。
-     * 返回内容块与其是否为本次新建（新建才走展开动画）。 */
-    private ensureMergedBody;
-    /** 清理合并 think 行（v12）：状态 map 立即清除；DOM 在手势动画路径下
-     * 渐隐后移除（settle 回调），其余路径瞬删。渐隐中途被反向取消时元素
-     * 保留，由后续 pass 的 syncMergedThink 重建/复用。
-     * settle 透传给每个渐隐目标的移除回调之后（chip 间距钉住的结算探测点，
-     * AI 评审 P0：merged 行渐隐不走 block.rows，必须纳入同一钉住体系）。 */
-    private releaseMergedThink;
-    /** merged-body 展开高度动画（机制样板：插件全资 DOM）。
-     * 关键帧含 marginBottom 0→16px——其 CSS 有常量 margin-bottom:16px，
-     * 高度从 0 起步时这 16px 会先占位产生小跳变。fill:'forwards' 托住终态，
-     * onfinish 清内联后 cancel 释放，无闪烁窗口。收起由 collapseMergedBody
-     * 做镜像高度卷下（同款账本与身份守卫），开合对称。 */
-    private revealMergedBody;
-    /** 收起合并行：内容块高度卷下后移除——镜像 revealMergedBody 的唯一几何动画，
-     * 开合对称。插件全资静态文本 DOM、无 React 协调竞争，可安全做几何收起
-     * （与 seat 级拒绝盲卷的场景不同：那里是 React 混杂多卡片）。
-     * reduced-motion / 无 WAAPI / 零高度降级为同步 remove()。 */
-    private collapseMergedBody;
-    /** 当前宿主内的思考行（现取，React 重渲染后引用仍然有效）。 */
-    private currentThinkRows;
-    /** 移除合并思考行（二级收起 / 一级收起时），恢复行由 applyRows 控制。
-     * 合并内容块（btn 的兄弟节点）一并移除，避免宿主展开后残留文本。 */
-    private removeMergedThink;
-    /** 正文判定（带缓存）：同一消息子树未变时直接复用上次结果。失效由
-     * markDirty（mutation 定向）与 switchFlow（整体重置）驱动；缓存的是
-     * 纯文本/媒体存在性判定，与 display 状态无关，插件自身的显隐切换
-     * 不会产生脏数据。 */
-    private hasBodyCached;
-    /** 本块是否有在途收起渐隐（rows/containers/merged 行/body 任一）。
-     * 基于 pendingAnims 账本无状态判定：onfinish/oncancel 都会即时清账，
-     * 取消路径天然解锁（计数器/最后注册者会卡死）。merged 行渐隐时已被
-     * releaseMergedThink 摘出 mergedThinks，按 DOM 类名现查。 */
-    private hasPendingCollapse;
-    /** 钉住 chip 与首行的 16px 间距（收起 fade 期间；内联优先于 aria=false 的 0）。
-     * flow-chip（context 等 before-mounted）豁免：其间距由宿主 row-gap 16px
-     * 提供、自身 CSS 恒 0，钉住 16px 会叠加成 32px（真机实测：收起上下文
-     * 注入时二级与三级间距瞬间扩大）。
-     */
-    private pinChipMargin;
-    /** 解除钉住（aria=true 的 16px 或 aria=false 的 0 由 CSS 接管）。 */
-    private unpinChipMargin;
-    /** 外部介入检测（issue #11 Bug A）：当前内联值 ≠ 插件最后确保值，或所有权
-     * 哨兵被 style 整体改写抹除。返回 true 时调用方放弃本次写回并交还账本——
-     * 属性级改写由值比对捕获，整体改写（cssText / setAttribute('style')）由
-     * 哨兵缺失捕获，两层合起来覆盖外部介入的两种形态。 */
-    private displayForeign;
-    /** 清空单个元素的显示账本（三账本 + 所有权哨兵）。 */
-    private releaseDisplayLedger;
-    /** 返回 true 表示启动了渐隐动画（调用方可据此决定内部元素的处置）。
-     * settle 在渐隐自然结束时调用（onfinish 链；反向取消不触发）。 */
-    private hideElement;
-    private restoreElement;
-    /** 是否可动画：WAAPI 特性检测 + reduced-motion 门控（均做 typeof 防桩缺失）。 */
-    private canAnimate;
-    /** 展开方向淡入（opacity + 4px 微位移）：无高度分量、零布局读取。
-     * onfinish 按终态可见对齐账本（双删除）并 schedule() 幂等重同步；
-     * oncancel 只做身份守卫删除——取消方的终态写入自己负责。 */
-    private startReveal;
-    /** 同步取消在途动画并清账：收起动画需同时清锁高内联（height/overflow/
-     * marginBottom），否则取消方写完终态后元素仍被锁高裁剪一帧以上。 */
-    private cancelPendingSync;
-    private clearCollapseLock;
-    /** 祖先 seat 在途动画检测：沿 parentNode 走到 flow，任一祖先在 pendingAnims
-     * 即视为在途。分层规则——同一视觉变化只动画一层。 */
-    private hasAnimatingAncestor;
-    /** 收起方向渐隐动画（v11 定稿）：镜像 reveal 的 opacity + 4px 微位移，
-     * 淡完 onfinish 写 display:none 并保持双条目（镜像 hideElement 终态契约）。
-     * fill:'forwards' 占位到终态写入后释放；无几何锁、无 gap 补偿。 */
-    private startFadeCollapse;
-    /**
-     * 收起 fade 终态结算（onfinish 与僵尸收割共用）。仅被同元素新动画
-     * supersede 时早退；被 sweep 删账（元素已断连）或收割时仍执行 settle——
-     * 回调经 controller 可达，动画必然触发 onfinish，早退会把 chip 内联 16px
-     * 钉住永久残留。重挂载同节点不可能（React 只建新节点），重启动的新动画
-     * 由第一条守卫覆盖，无误伤。
-     */
-    private finishFadeCollapse;
-    /** 动画是否已播完（终态未结算）：finish 事件丢失时的兜底判定。WAAPI 桩
-     * 无 playState/effect 时一律 false，走正常事件路径，测试行为不变。 */
-    private isAnimOverdue;
-    /** 轻量视觉 reveal（opacity + 4px 微位移）：用于插件全资元素的即时显示
-     * 路径——chip（一级展开时出现）与 merged-think 行（二级展开时出现）。
-     * 这些元素的 display 完全由插件直写、无 React 协调竞争，因此不入
-     * pendingAnims 账本、无仲裁；收起同为直写 display:none，无 fill 的在途
-     * 动画残留在隐藏元素上自然失效。门控沿用 animate 布尔（手势路径才调）。 */
-    private revealVisual;
-    private restoreUnusedDisplays;
-    /** 收集 audit 需要观察的 display 集合；只读取内联样式，不触发布局计算。 */
-    private collectAuditDisplays;
-    /** 在完整 pass 完成后保存 display 基线，供下一次轻量 audit 比对。 */
-    private captureAuditDisplays;
-    private restoreAllDisplays;
-}
+/** Public controller name retained for source integrations; the legacy fold engine is removed. */
+export { FoldController } from './controller.js';

package/lib/types/host-contract.d.ts

@@ -0,0 +1,17 @@
+/** DSH 0.1.2 DOM contract. Keep host recognition separate from grouping and rendering. */
+export declare const FLOW = "[data-chat-flow]";
+export declare const SEAT = "[data-chat-flow-kind]";
+export declare const OWNED = "[data-dshcf-group]";
+export declare const FOLDED = "data-dshcf-folded";
+export declare const NATIVE_HIDDEN = "[data-turn-process-hidden], [data-turn-process-inline]";
+export declare function elementOf(node: Node): Element | null;
+export declare function pluginOwned(node: Node): boolean;
+export declare function seatOf(node: Node, flow: HTMLElement): HTMLElement | null;
+export declare function seatKey(seat: HTMLElement): string | null;
+export declare function nativeHidden(row: HTMLElement, flow: HTMLElement): boolean;
+export declare function nativeOwnsHidden(element: HTMLElement): boolean;
+export declare function findFlow(): HTMLElement | null;
+export declare function nativeControls(flow: HTMLElement): Map<string, HTMLButtonElement>;
+export declare function nativeCollapsed(button: HTMLButtonElement | undefined): boolean;
+export declare function openNative(button: HTMLButtonElement | undefined): void;
+export declare const OBSERVED_ATTRIBUTES: string[];

package/lib/types/index.d.ts

@@ -1,17 +1,18 @@
-/** Host 插件名。 */
 export declare const name = "dsh-auto-collapse";
-/** Host 侧不注入额外服务；settings 是可选的运行能力，由下方接线惰性接入。 */
 export declare const inject: string[];
-/** 插件配置。 */
 export interface Config {
-    /** 自定义状态提示词；留空恢复官方 "Deep diving..."。 */
+    /** Empty text restores the official status copy. */
     statusText?: string;
 }
-/** settings 消费者钩子，与官方 SettingsSectionHooks 同形。 */
-export interface SettingsSectionHooks<T> {
-    setSource(source: () => T): void;
-    onChange(): void;
-    validate?(value: T): void;
+export interface SettingsHostContext {
+    inject(services: readonly string[], setup: (ctx: {
+        settings: {
+            register(namespace: string, schema: unknown, options: {
+                base: {
+                    statusText: string;
+                };
+            }): unknown;
+        };
+    }) => void): unknown;
 }
-/** Host 插件体：注册设置命名空间。 */
-export declare function apply(ctx: unknown, config?: Config): void;
+export declare function apply(ctx: SettingsHostContext, config?: Config): void;

package/lib/types/scheduler.d.ts

@@ -0,0 +1,10 @@
+/** One coalesced frame, with a background-tab fallback; no polling/audit loop. */
+export declare class Scheduler {
+    private readonly run;
+    private frame;
+    private timeout;
+    private disposed;
+    constructor(run: () => void);
+    schedule(): void;
+    dispose(): void;
+}

package/lib/types/status-text.d.ts

@@ -0,0 +1,14 @@
+/** Optional status copy is independent of work grouping and never reads message text. */
+export declare class StatusTextController {
+    private readonly read;
+    private flow;
+    private observer;
+    private readonly texts;
+    private readonly scheduler;
+    constructor(read: () => string | undefined);
+    setFlow(flow: HTMLElement | null): void;
+    refresh(): void;
+    private update;
+    private restore;
+    dispose(): void;
+}

package/lib/types/summary.d.ts

@@ -0,0 +1,17 @@
+import type { WorkKind } from './work-groups.js';
+export type WorkStatus = 'running' | 'done' | 'error' | 'stopped' | 'waiting';
+export interface WorkInfo {
+    kind: WorkKind;
+    action: string;
+    detail: string;
+    status: WorkStatus;
+}
+export interface GroupSummary {
+    text: string;
+    detail: string;
+    status: WorkStatus;
+    kind: WorkKind;
+}
+export declare function toolAction(tool: string): string;
+export declare function normalizeStatus(value: string | null): WorkStatus;
+export declare function summarize(infos: readonly WorkInfo[]): GroupSummary;

package/lib/types/work-groups.d.ts

@@ -0,0 +1,30 @@
+/** DOM-independent, ordered work grouping. Prose and turn changes are boundaries. */
+export type WorkKind = 'think' | 'tool' | 'context' | 'command';
+export type FlowToken = {
+    type: 'work';
+    id: string;
+    turn: string | null;
+    kind: WorkKind;
+} | {
+    type: 'boundary';
+    id: string;
+    turn: string | null;
+    hard: boolean;
+};
+export interface WorkGroup {
+    id: string;
+    turn: string | null;
+    items: readonly string[];
+}
+/** Unscoped context can inherit an unambiguous adjacent turn, never across a user fence. */
+export declare function resolveTurns(tokens: readonly FlowToken[]): FlowToken[];
+export declare function groupWork(tokens: readonly FlowToken[]): WorkGroup[];
+/** Expansion belongs to a work interval, not its current running item or DOM node. */
+export declare class GroupState {
+    private groups;
+    private expanded;
+    reconcile(groups: readonly WorkGroup[]): void;
+    isExpanded(id: string): boolean;
+    setExpanded(id: string, value: boolean): void;
+    clear(): void;
+}

package/lib/types/work-info.d.ts

@@ -0,0 +1,4 @@
+import type { WorkItem } from './work-model.js';
+import { type WorkInfo } from './summary.js';
+export declare function readWorkInfo(item: WorkItem): WorkInfo;
+export declare function needsAttention(items: readonly WorkItem[], infos: ReadonlyMap<string, WorkInfo>): boolean;

package/lib/types/work-model.d.ts

@@ -0,0 +1,24 @@
+import type { FlowToken, WorkKind } from './work-groups.js';
+export interface WorkItem {
+    id: string;
+    turn: string | null;
+    kind: WorkKind;
+    seat: HTMLElement;
+    row: HTMLElement;
+    /** Largest ancestor proved to contain only work, never a prose ancestor. */
+    cover: HTMLElement;
+    /** DSH leaves scoped system prompts outside its native process membership. */
+    followNativeTurn: boolean;
+}
+export interface WorkSnapshot {
+    tokens: FlowToken[];
+    items: Map<string, WorkItem>;
+}
+/** Cache structure per host seat. Text inside a work row does not invalidate this index. */
+export declare class WorkModel {
+    private seats;
+    private identities;
+    private sequence;
+    read(flow: HTMLElement, dirty: ReadonlySet<HTMLElement>, force?: boolean): WorkSnapshot;
+    clear(): void;
+}