weifuwu 0.89.1 → 0.90.1

package/dist/client/layout/weifuwu-layout.css

@@ -848,6 +848,15 @@ body.wf-dragging {
   align-items: var(--wf-align, center);
   gap: var(--wf-gap, var(--wf-gap-md));
 }
+
+.wf-justify-center {
+  display: flex;
+  justify-content: center;
+}
+:where(.wf-justify-center) {
+  align-items: var(--wf-align, center);
+  gap: var(--wf-gap, var(--wf-gap-md));
+}
 }
 
 @layer layout {
@@ -1350,6 +1359,7 @@ body.wf-dragging {
 .wf-padding-xl { padding: var(--wf-space-xl); }
 
 /* ── padding: 轴 ── */
+.wf-padding-x-xs { padding-left: var(--wf-space-xs); padding-right: var(--wf-space-xs); }
 .wf-padding-x-sm { padding-left: var(--wf-space-sm); padding-right: var(--wf-space-sm); }
 .wf-padding-x-md { padding-left: var(--wf-space-md); padding-right: var(--wf-space-md); }
 
@@ -1384,6 +1394,9 @@ body.wf-dragging {
 .wf-margin-left-sm { margin-left: var(--wf-space-sm); }
 .wf-margin-x-auto { margin-left: auto; margin-right: auto; }
 
+/* ── margin: y 轴 ── */
+.wf-margin-y-xs { margin-top: var(--wf-space-xs); margin-bottom: var(--wf-space-xs); }
+
 /* ── gap：直接设置 gap 属性（不设 --wf-gap 变量——变量会继承污染子孙：
    壳 root wf-gap-none 曾让 KPI grid 的 gap: var(--wf-gap) = 0 卡无间距） ── */
 .wf-gap-none { gap: 0; }
@@ -1399,22 +1412,6 @@ body.wf-dragging {
 .wf-height-full { height: 100%; }
 }
 
-@layer utilities {
-/* hidden — 隐藏元素（响应式显隐唯一模式：`wf-hidden wf-flex@lg` 窄隐宽显） */
-.wf-hidden {
-  display: none;
-}
-@media (min-width: 1024px) { .wf-hidden\@lg { display: none; } }
-
-/* dim — 视觉淡化（运行中/历史态/次要操作） */
-.wf-dim {
-  opacity: 0.7;
-}
-
-/* cursor — 交互指针（裸值词） */
-.wf-pointer { cursor: pointer; }
-}
-
 @layer utilities {
 /* block — 块级显示 */
 .wf-block {
@@ -1435,6 +1432,28 @@ body.wf-dragging {
 @media (min-width: 1024px) { .wf-flex\@lg { display: flex; } }
 }
 
+@layer utilities {
+/* hidden — 隐藏元素。两种响应式组合：
+ *   `wf-hidden wf-flex@lg`（窄隐宽显——基础类无 !important，被 media 内 wf-flex@lg 覆盖）
+ *   `wf-flex wf-hidden@lg`（宽隐窄显——media 变体 !important，胜组件自身 display）
+ * !important 原因（CHAT-UX 波次 2 L4）：@layer 顺序下 utilities 永远输给 components
+ * （@layer tokens,base,layout,utilities,components 顶层声明定死）——.wf-btn 的
+ * display:inline-flex 无条件压过 hidden 变体——面板按钮桌面隐藏失效实证；
+ * 源顺序洗牌无法修复（层叠顺序优先于源顺序）——!important 是唯一出路 */
+.wf-hidden {
+  display: none;
+}
+@media (min-width: 1024px) { .wf-hidden\@lg { display: none !important; } }
+
+/* dim — 视觉淡化（运行中/历史态/次要操作） */
+.wf-dim {
+  opacity: 0.7;
+}
+
+/* cursor — 交互指针（裸值词） */
+.wf-pointer { cursor: pointer; }
+}
+
 @layer layout {
 /* popup — 浮层基类（usePopup.portal 自动附加；Modal/Drawer 等手动浮层可选用）
  *

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

@@ -2,7 +2,7 @@
  * weifuwu/office/docx — docx ↔ ODES DocState 双向转换（前端/服务端通用——零依赖）
  *
  * 参考算法：office2json（unzip → XML 树 → 路径提取 w:body → w:p → w:r → w:t），
- * 增强提取到 ODES IR（design/office-events-plan.md）：
+ * 增强提取到 ODES IR（）：
  * - 段落属性：pStyle → h1/h2/h3、jc → 对齐（裁剪：样式名映射子集）
  * - 内联格式：rPr b/i/u → marks（区间）
  * - 表格：w:tbl → Editor 表格 embed 快照（HTML 复用现有模型）

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（键盘弹起/缩放跟踪）