weifuwu 0.89.1 → 0.90.0

package/dist/client/office/xlsx.d.ts

@@ -2,7 +2,7 @@
  * weifuwu/office/xlsx — xlsx ↔ ODES WorkbookState 双向转换（前端/服务端通用——零依赖）
  *
  * 参考算法：office2json（sheet1.xml → sheetData → row → c{t,v} + sharedStrings），
- * 增强提取到 ODES IR（design/office-events-plan.md）：
+ * 增强提取到 ODES IR（）：
  * - 多 sheet：workbook.xml（sheet 名 + rId）→ rels → 各 sheetN.xml
  * - 单元格引用：c@r（A1——office2json 丢弃——ODES 必须）
  * - 类型：c@t（s=shared/n=number/b=bool/f=formula）→ SheetCell.kind

package/dist/client/vdom/core/async-guard.d.ts

@@ -1,7 +1,7 @@
 /**
  * vdom core — async guard（异步超时防御——R2 挂起/饿死防御——零依赖）
  *
- * 背景（design/vdom-core-robustness-round4.md R2）：DataPipe 缓存 pending
+ * 背景（ R2）：DataPipe 缓存 pending
  * promise 无超时——fetcher 永不 resolve（网络挂起/用户 promise 泄漏）→
  * `await renderFn` 永不完成 → 渲染队列饿死——应用冻结。
  *

package/dist/client/vdom/core/patch/state-machine.d.ts

@@ -5,7 +5,7 @@
  * 与 createDevVerifier（生产 dev 检查）共用——消灭双实现漂移（isConnected
  * 类误报的根治——规格只有一份——两边行为恒等）。
  *
- * 规格（design/vdom-state-machine-plan.md §2.1/§3）：
+ * 规格（ §2.1/§3）：
  *   ABSENT → CREATED → INSERTED → ACTIVE（close）→ REMOVED
  *   - create 族：ABSENT → CREATED（同形复用不变）
  *   - insert：CREATED → INSERTED（INSERTED/ACTIVE = 幂等 skip）

package/dist/client/vdom/core/router.d.ts

@@ -1,7 +1,7 @@
 /**
  * vdom core — route 阶段（UIRouter——应用唯一入口——公共面）
  *
- * 设计（design/vdom-plan.md §2）：Handler 签名字面同构后端——
+ * 设计（ §2）：Handler 签名字面同构后端——
  * `(req: Request, ctx) => Response`——原生 Request/Response——
  * 路由核心 = shared Trie（src/shared/router/trie.ts——前后端共用）——
  * 静态段优先 → :param → * 通配——params 注入 req。

package/dist/client/vdom/core/ssr/html.d.ts

@@ -1,7 +1,7 @@
 /**
  * vdom core — commandToHtml（命令事件流 → HTML——流式 SSR 核心）
  *
- * 设计（design/vdom-plan.md §3）：服务端消费同一 handler 的 Response——
+ * 设计（ §3）：服务端消费同一 handler 的 Response——
  * `res.body.pipeThrough(commandToHtml())` → HTTP 流式响应（边构建边吐
  * HTML——React Fizz 同模式）：
  * - create（attrs 序列化面）→ 开标签（属性转义——style 对象 → CSS 文本）

package/dist/client/vdom/core/v2/cycle.d.ts

@@ -32,8 +32,10 @@ export interface RenderCycleDeps {
     diff(oldTree: VNode, nextTree: VNode): Observable<Command>;
     /** 命令应用（applier.apply——副作用终态） */
     apply(cmd: Command): void;
-    /** unmount 命令 → 段销毁（返回是否实际销毁——幂等防御） */
-    dispose(compId: string): boolean;
+    /** unmount 命令 → 段销毁（返回是否实际销毁——幂等防御）。
+     *  **beforeEpoch（2027-10——nav 链残留实修补正）**：只处理「该周期之前」
+     *  创建的段——unmount 目标永远是旧树段——同槽位 id 复用的新段不是目标 */
+    dispose(compId: string, beforeEpoch: number): boolean;
     /** serve 活性（unmount 后周期零副作用） */
     active(): boolean;
 }

package/dist/client/vdom/core/v2/diff.d.ts

@@ -23,7 +23,16 @@ export interface Segment {
      *  平行数组 */
     destroy$: import('../../observable/index.ts').Subject<void>;
     disposed: boolean;
+    /** **创建纪元（2027-10——nav 链残留实修补正）**：createSegment 打上创建
+     *  时全局纪元（渲染周期开始时递推）——cleanup 阶段（unmount 防御性
+     *  dispose）只处理「当前周期之前」创建的段——unmount 命令目标永远是
+     *  旧树段——同槽位 id 复用的新段不是目标（accordion→index→actionsheet
+     *  实证：nav1 生成期的 unmount root.0.1.0 在 cleanup 阶段误杀同周期
+     *  新挂载的 index 段 → 旧输出无物可清 → 组件列表残留） */
+    epoch: number;
 }
+/** 渲染周期开始（纪元递推——返回新纪元） */
+export declare function nextSegmentEpoch(): number;
 export type SegmentMap = Map<string, Segment>;
 /** 创建段（mount——工厂执行——hooks 环境已注入 ctx.ui） */
 export declare function createSegment(factory: Component, props: Record<string, unknown>, ctx: UIContext, compId: string, requestSegmentRender?: () => void): Segment;

package/dist/client/vdom/core/v2/integrate.d.ts

@@ -1,7 +1,7 @@
 /**
  * vdom v2 — 集成（v2 引擎 → 消费端链路）
  *
- * VDOM-V2-BLUEPRINT 阶段 2A：
+ * v2 引擎蓝图 阶段 2A：
  * - **命令流同构 → 消费端复用**：renderV2/diffV2 产出 Observable<Command>
  *   ——commandToHtml / CommandApplier 直接消费（命令语义 v1 相同——零改动）
  * - v2ToHtml：v2 渲染 → HTML（SSR 路径——契约层无 DOM 验证）

package/dist/client/vdom/core/v2/schedule.d.ts

@@ -1,7 +1,7 @@
 /**
  * vdom v2 — 调度流（render$——buffer + flush——batching）
  *
- * VDOM-V2-BLUEPRINT 阶段 1d：
+ * v2 引擎蓝图 阶段 1d：
  * - render() 请求 = 流 next——**同微任务拍 N 次 → 1 次渲染循环**（React 18
  *   同级优化——渲染频率防线）
  * - 渲染中请求 → 排队（下拍 flush——FIFO 不丢——v1 语义保持）

package/dist/client/vdom/core/vnode.d.ts

@@ -29,7 +29,7 @@ export type VNodeChild = VNode | string | number | boolean | null | undefined |
 /** renderFn——每次渲染（读最新 props——**纯同步**——2027-08 断代：
  *  异步边界 = useAsyncData/订阅 hooks——renderFn 无 async） */
 export type RenderFn<P = Record<string, unknown>> = (props: P) => VNode | null | (VNode | null)[];
-/** 组件（两阶段——**同步**）——2027-08 断代（OBSERVABLE-ARCH 波次 5）：
+/** 组件（两阶段——**同步**）——2027-08 断代（Observable 架构 波次 5）：
  *  - 工厂 = **同步** mount（一次——初始化状态/订阅——**无 mounting 窗口**——
  *    同步执行不存在「半挂载」可观察状态——mouting 竞态类 bug 结构性消灭）
  *  - renderFn = 每次渲染（ctx.render()/props 变化触发——**纯同步**）

package/dist/client/vdom/hooks/drag-media.d.ts

@@ -22,8 +22,9 @@ export interface DragDrop {
         onDragStart: (e: DragEvent) => void;
         onDragEnd: (e: DragEvent) => void;
     };
-    /** 放置目标属性 */
+    /** 放置目标属性（onDragEnter + dragover preventDefault + drop 解析） */
     dropProps: {
+        onDragEnter: (e: DragEvent) => void;
         onDragOver: (e: DragEvent) => void;
         onDragLeave: (e: DragEvent) => void;
         onDrop: (e: DragEvent) => void;
@@ -32,6 +33,8 @@ export interface DragDrop {
 export interface DragDropOptions {
     onDragStart?: (e: DragEvent, data?: unknown) => void;
     onDragEnd?: (e: DragEvent) => void;
+    /** 拖入（DropZone 深度计数用——dragenter 气泡自子元素——与 dragleave 配对计数防闪烁） */
+    onDragEnter?: (e: DragEvent) => void;
     onDragOver?: (e: DragEvent) => void;
     onDragLeave?: (e: DragEvent) => void;
     onDrop?: (e: DragEvent, data?: unknown) => void;

package/dist/client/vdom/hooks/popup-manager.d.ts

@@ -1,7 +1,7 @@
 /**
  * vdom 命令式弹窗内核（2027-03——一个形态：ctx.popup.open——toast 心智）
  *
- * 设计（design/imperative-popup-plan.md）：
+ * 设计（docs/client.md）：
  * - **唯一形态**：openPopup(opts) → PopupHandle——调用点构建内容——内核
  *   自管理挂载/更新/卸载/销毁（挂载/卸载/销毁在实例内——无框架机制依赖）
  * - **每次 openPopup = 独立实例**（普通闭包状态——非 hook 状态——无共享

package/dist/client/vdom/hooks/stable.d.ts

@@ -1,7 +1,7 @@
 /**
  * vdom hooks — stable（useTween/useDrag/useVisualViewport/useReducedMotion）
  *
- * P1 契约补齐（design/vdom-replace-plan.md §1.1）——组件库消费缺口：
+ * P1 契约补齐（ §1.1）——组件库消费缺口：
  * - useTween（StatCard 数值动画——rAF + ease + reduced-motion 直落）
  * - useDrag（Resizable/ImageCropper——pointerdown 捕获拖拽）
  * - useVisualViewport（键盘弹起/缩放跟踪）