weifuwu 0.76.0 → 0.78.0

package/docs/mobile.md

@@ -63,9 +63,9 @@ const popup = ctx.ui.usePopup({
 // popup.portal(content, portalKey) — 定位 + clamp + portal（挂载 #__wf_portal）
 ```
 
-**内置行为**：hover 桌面 / tap 触屏 / Escape（document 级，portal 内也可关）/ 外部点击 / 视口 clamp / 宽度 clamp。
+**内置行为**：hover 桌面 / tap 触屏 / Escape（document 级，portal 内也可关）/ 外部点击 / 视口 clamp / 宽度 clamp / focus 触发（DatePicker） / mask 遮罩（Command/Img/Tour）/ 会话级模态（Modal/Drawer/Confirm——presence 退场 + trapFocus + lockScroll + positioning 'none'）。
 
-**边界**：Modal/Drawer 全屏对话框不进 usePopup（focus-trap/scroll-lock 各自实现）。
+**全部弹窗统一 usePopup 单一入口**（锚定浮层 + 居中模态 + 通知 + 引导 + 日历）；`usePopupPosition` 仅 Affix/Chart 坐标工具独立使用。
 
 ## 四、手势原语
 

package/docs/realtime.md

@@ -7,11 +7,15 @@
 > 依赖 `queue`（触发后入队执行）。三类任务：即时（queue.add 已有）、延时（`ctx.schedule`）、定时（`ctx.cron`）。
 
 ```ts
-import { queue, scheduler } from 'weifuwu'
+import { redis, queue, scheduler } from 'weifuwu'
 
-const q = queue()
+// 模式 A 显式注入：redis 是 scheduler 的第一方消费者（ZSET 延时队列 + HASH cron 注册表
+// 直接命令 redis）——必传，与 queue({ redis }) 对齐；scheduler.close() 不关闭注入的 redis
+const r = redis()                      // ctx.redis（RedisPool）
+const q = queue({ redis: r.redis })    // 入队执行（stream）
+app.use(r)
 app.use(q)
-app.use(scheduler({ queue: q }))       // 依赖 ctx.queue（触发后入队）
+app.use(scheduler({ redis: r.redis, queue: q }))   // 守护循环走 createConnection() 独立连接
 
 // 延时任务（单次）：delayMs 或指定时间
 await ctx.schedule('email.send', { to, body }, { delayMs: 30_000 })
@@ -30,6 +34,7 @@ const worker = ctx.queue.worker('email.send', async (job) => { ... })
 
 - **延时**：ZSET（score=触发时间戳）+ 守护循环（独立连接）→ 到期 `ZREM` 原子抢占（多实例不重复）→ `queue.add`
 - **多应用隔离**：`scheduler({ prefix })`——ZSET/HASH 应用级共享，多应用共用 redis 时必须各自 prefix（同应用多实例共享 prefix = 协作消费）
+- **连接所有权**：scheduler 内部用 `redis.createConnection()` 独立守护连接（不占池——对齐 queue worker）；`scheduler.close()` 只关守护连接——**不关闭注入的 redis**（调用方负责 `r.close()`）
 - **cron**：HASH 注册表（**field = name，同 name 重新注册 = 覆盖更新**，改表达式不残留旧定义）+ 滚动生成触发点（`ZADD NX` 幂等）→ 复用延时链路；`nextRunAt` 原子推进
 - **取消**：`ctx.cancelCron(name)` 删定义 + 清理 pending 触发点（停用 cron 必须 cancel——定义无 TTL 会累积）
 - **崩溃恢复**：未消费触发点留在 ZSET，重启后补扫立即触发（at-least-once，幂等由业务保证）

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "weifuwu",
   "type": "module",
-  "version": "0.76.0",
+  "version": "0.78.0",
   "description": "AI SaaS framework — (req, ctx) => Response",
   "exports": {
     ".": {

package/dist/ui-dom/focus-trap.d.ts

@@ -1,4 +0,0 @@
-/**
- * weifuwu/ui-dom — FocusTrap
- */
-export declare function trapFocus(container: HTMLElement): () => void;

package/dist/ui-dom/scroll-lock.d.ts

@@ -1,5 +0,0 @@
-/**
- * weifuwu/ui-dom — ScrollLock
- */
-export declare function lockScroll(): void;
-export declare function unlockScroll(): void;

package/dist/ui-dom/vdom/scheduler.d.ts

@@ -1,13 +0,0 @@
-import type { WfuiContext } from '../types.ts';
-import type { Registry } from './registry.ts';
-export interface Scheduler {
-    render(ids?: string[]): Promise<void>;
-}
-export interface SchedulerOptions {
-    registry: Registry;
-    ctx: WfuiContext;
-    rootEl?: HTMLElement;
-    getCtxVersion?: (id: string) => number;
-    onError?: (e: unknown) => void;
-}
-export declare function createScheduler(opts: SchedulerOptions): Scheduler;