weifuwu 0.75.0 → 0.76.0

package/dist/ui/ssr.d.ts

@@ -1,35 +0,0 @@
-/**
- * 服务端 SSR 字符串遍历器 — async 工厂组件（形态 C）的 HTML 序列化
- *
- * 支持：
- *   - 同步组件（mount → render → VNode → HTML）
- *   - async 工厂组件（await 工厂 → 数据进 HTML；服务端不缓存定义，数据 per-request）
- *   - Fragment / Portal（内联子节点）
- *   - innerHTML prop（原样输出）、class/style 对象序列化
- *   - 事件处理器 / ref 剥离、文本自动转义（XSS）
- *   - 服务端 ctx shim（$ no-op dirty、ctx.data 预取、selfId 隔离）
- *
- * 产物为 HtmlSafe 标记的安全 HTML 片段，可直接内联进 ctx.ui.html 模板。
- */
-import type { Component, AsyncComponent } from '../ui-dom/vnode.ts';
-import { HtmlSafe } from './html-safe.ts';
-export { HtmlSafe } from './html-safe.ts';
-export interface SsrOptions {
-    /** 服务端数据存储：ctx.data 预取结果写入此处，调用方序列化进 __DATA__ */
-    data?: Map<string, unknown>;
-}
-/**
- * SSR 渲染组件 → HTML 片段（HtmlSafe 标记，可直接内联进 ctx.ui.html 模板，不二次转义）。
- *
- * ```ts
- * const data = new Map()
- * const html = await ctx.ui.ssr(BlogPage, { slug }, { data })
- * return ctx.ui.html`
- *   <div id="root">${html}</div>
- *   ${ctx.ui.ssrData(data)}
- * `
- * ```
- */
-export declare function ssrToString(Comp: Component | AsyncComponent, props: Record<string, any>, serverCtx: any, opts?: SsrOptions): Promise<HtmlSafe>;
-/** 序列化数据存储 → window.__DATA__ 脚本（防 XSS：转义 <） */
-export declare function serializeData(data: Map<string, unknown>): string;

package/dist/ui-dom/diff.d.ts

@@ -1,28 +0,0 @@
-/**
- * weifuwu/ui-dom 增量 diff — patchValue 及全部 diff 辅助
- *
- * 从 render.ts 拆出（P2 结构拆分）。依赖方向：
- *   diff.ts → render.ts（renderValue/mountComponent/patchPortal/renderPortal）
- *   diff.ts → registry.ts（callRefCleanup）
- *   render.ts 不依赖 diff.ts（单向，无环）
- */
-import type { VNodeChild } from './vnode.ts';
-import type { WfuiContext } from './types.ts';
-export declare function patchValue(parent: Node, oldNode: Node | null, oldInput: VNodeChild, newInput: VNodeChild, ctx: WfuiContext): Node | null;
-export declare function patchProps(el: Element, oldProps: Record<string, unknown> | null, newProps: Record<string, unknown>): void;
-/** 为无 key 的子节点自动分配位置 key，确保 keyed diff 正确性 */
-export declare function ensureKeys(oldChildren: VNodeChild[], newChildren: VNodeChild[]): void;
-/**
- * 将 children 映射到它们实际产生的 DOM 节点（每个 child 一个 Node[]）。
- *
- * 1 VNode ≠ 1 DOM 节点：Fragment 展开成多个直属节点（_childNodes），
- * null/boolean/Portal 产生 0 个。explicitNodes 提供限定范围（Fragment 子项
- * 用其自身 _childNodes），否则从 source（parent.childNodes 或给定快照）按计数游标分配。
- */
-export declare function mapChildDomNodes(source: Node[], children: VNodeChild[]): (Node[] | null)[];
-export declare function normalize(children: VNodeChild): VNodeChild[];
-/**
- * keyed 子节点 diff。返回每个 new child 的 DOM 节点范围（newNodes，可为空）。
- * oldNodes：old children → 实际 DOM 节点（mapChildDomNodes 结果）。
- */
-export declare function patchKeyedChildren(parent: Node, oldChildren: VNodeChild[], newChildren: VNodeChild[], ctx: WfuiContext, oldNodes?: (Node[] | null)[], rangeStart?: Node | null): (Node[] | null)[];

package/dist/ui-dom/hydration.d.ts

@@ -1,13 +0,0 @@
-/**
- * weifuwu/ui-dom Hydration（游标收养）— 收养服务端 HTML，不重建 DOM
- *
- * 从 render.ts 拆出（P2 结构拆分）。依赖：render.ts（flattenChildren/SVG 常量）、
- * diff.ts（patchProps）、registry.ts（idRegistry/nextComponentId/resolveAsyncFactory）。
- */
-import type { VNode } from './vnode.ts';
-import type { WfuiContext } from './types.ts';
-/**
- * Hydration 挂载入口：收养 container 内现有服务端 HTML。
- * 渲染完收尾：删除服务端有、客户端没有的残留 DOM。
- */
-export declare function hydrateVNode(container: Element, vnode: VNode, ctx: WfuiContext): Promise<void>;

package/dist/ui-dom/reactive.d.ts

@@ -1,6 +0,0 @@
-/**
- * 创建响应式状态容器：深度 Proxy，任意层级属性赋值自动触发 dirty。
- *
- * 纯 JS（无 DOM），客户端（ctx.ui.$()）与服务端（SSR ctx shim）共用。
- */
-export declare function createReactiveState(dirty: () => void): Record<string, any>;

package/dist/ui-dom/registry.d.ts

@@ -1,27 +0,0 @@
-/**
- * weifuwu/ui-dom 注册表 — 工厂版（serve 创建局部实例，隔离于 createApp 的模块级状态）
- *
- * 复制自 client/registry.ts（算法相同），但**无模块级单例**——uiServe 创建实例
- * 注入 ctx.__registry，render/diff/ui 经 getRegistry(ctx) 读取，与 createApp 零交叉。
- */
-import type { VNode } from './vnode.ts';
-type UnmountHook = (id: string) => void;
-/** 注册表实例状态 */
-export interface Registry {
-    idCounter: number;
-    idRegistry: Map<string, VNode>;
-    unmountHooks: UnmountHook[];
-}
-/** 创建局部注册表（uiServe 每实例一个——组件 id/dirty/卸载钩子与 createApp 隔离） */
-export declare function createRegistry(): Registry;
-/** 从 ctx 取注入的注册表（render/diff/ui 统一入口；serve 注入 __registry） */
-export declare function getRegistry(ctx: any): Registry;
-/** 指定实例生成组件 ID */
-export declare function nextComponentIdFor(reg: Registry): string;
-/** 指定实例注册卸载钩子（组件从 idRegistry 注销时触发） */
-export declare function onComponentUnmountFor(reg: Registry, hook: UnmountHook): () => void;
-/** 包裹 ref 回调调用——用户 ref 逻辑抛错时不中断渲染/卸载管线 */
-export declare function safeCallRef(ref: Function, arg: any, phase: 'mount' | 'cleanup', name?: string): void;
-/** 通知 ref 清理 + Portal 子容器清理（指定实例） */
-export declare function callRefCleanupFor(input: any, reg: Registry): void;
-export {};

package/dist/ui-dom/render.d.ts

@@ -1,46 +0,0 @@
-/**
- * weifuwu/ui-dom 渲染器 — VNode → DOM + patchValue diff
- *
- * render(vnode, ctx)      → 首次渲染，返回 DOM
- * patchValue(el, old, new, ctx) → 增量更新
- *
- * 支持：
- *   - key 属性（keyed diff）
- *   - ref / keyed diff
- *
- * 状态管理：组件使用闭包变量 + ctx.ui.render() 手动触发重渲染。
- */
-import type { VNode, VNodeChild, Component, AsyncComponent } from './vnode.ts';
-import type { WfuiContext } from './types.ts';
-export declare const SVG_NS = "http://www.w3.org/2000/svg";
-export declare const SVG_TAGS: Set<string>;
-export declare function render(input: VNodeChild, ctx: WfuiContext): Node | null;
-export declare function renderValue(v: VNodeChild, ctx: WfuiContext): Node | null;
-/**
- * 异步组件工厂缓存：同一工厂只执行一次，多实例/多渲染共享。
- * resolved 记录已解析的定义（同步快速路径用）。
- * （缓存本体在 registry.ts，本文件仅保留依赖 render 的调度函数）
- */
-/**
- * 占位完成后整树重渲染（async 工厂已解析，diff 收敛到目标位置）。
- * 优先走 serve 的调度（重新执行 handler → 新树 → diff 传递 _asyncDef）；
- * 无 serve 注入（SSR/独立渲染）时回退 ui.render(['_wf_root'])。
- */
-export declare function scheduleFullReRender(ctx: WfuiContext): void;
-/**
- * 同步 mount 组件（async 工厂占位策略）：
- *   - 同步组件 → def(props, ctx) → render fn → 输出 VNode
- *   - async 工厂已解析 → 同同步组件
- *   - async 工厂未解析 → 占位（返回 null）+ 启动工厂 + 完成后整树重渲染
- */
-export declare function mountComponent(Comp: Component | AsyncComponent, props: VNode['props'], vnode: VNode, ctx: WfuiContext): VNode | null;
-/** 首次渲染 Portal：创建远程容器、渲染子节点（不返回占位节点） */
-export declare function renderPortal(vnode: VNode, ctx: WfuiContext): void;
-/** 更新 Portal：复用远程容器，patch 子节点（不操作父 DOM） */
-export declare function patchPortal(oldV: VNode | null, newV: VNode, ctx: WfuiContext): void;
-/** 展平嵌套数组 */
-export declare function flattenChildren(children: VNodeChild): VNodeChild[];
-export declare function mountVNode(container: Element, vnode: VNode, ctx: WfuiContext): void;
-export { patchValue } from './diff.ts';
-/** 模块级兼容（无 ctx 场景——独立清理，不影响活跃 registry） */
-export declare function callRefCleanup(input: any): void;

package/dist/ui-dom/serve.d.ts

@@ -1,28 +0,0 @@
-/**
- * weifuwu/ui-dom serve — 渲染运行时（VDOM 落地机制）
- *
- * 定稿架构：serveUI = VDOM（落地，对齐后端 serve(router) = HTTP 传输）。
- *
- * uiServe(router, { root }) 调用时路由已全部注册——serve 负责：
- *   1. 创建渲染运行时：局部 registry + createUi（19 原语）+ popup-tracker + ctx.data/browser
- *   2. 监听 popstate/hashchange → router.match（params 注入）→ 中间件链 → handler → vnode
- *   3. renderValue / patchValue diff/patch DOM；组件 $ dirty → renderByIds（局部 registry）
- *
- * 与 createApp 隔离：registry/popup-tracker/dirty 集合全部局部实例（client 零改动）。
- */
-import type { UIRouter } from './router.ts';
-import type { WfuiContext } from './types.ts';
-/** uiServe 选项 */
-export interface UIServeOptions {
-    root: string | Element;
-    hydrate?: boolean;
-}
-/** serve 句柄 */
-export interface UIServeHandle<C extends object = {}> {
-    /** 释放全部资源（监听/渲染状态/注册表） */
-    close(): void;
-    /** 当前 ctx（调试/测试用）——含 UIRouter ctx 注入的类型扩展 */
-    ctx: WfuiContext & C;
-}
-/** uiServe — 绑定唯一根节点 + URL 驱动渲染（= VDOM 落地，对齐 serve(router)） */
-export declare function uiServe<RC extends object = {}>(router: UIRouter<RC>, options: UIServeOptions): UIServeHandle<RC>;

package/dist/ui-dom/ssr.d.ts

@@ -1,57 +0,0 @@
-/**
- * 服务端 SSR 字符串遍历器 — async 工厂组件（形态 C）的 HTML 序列化
- *
- * 支持：
- *   - 同步组件（mount → render → VNode → HTML）
- *   - async 工厂组件（await 工厂 → 数据进 HTML；服务端不缓存定义，数据 per-request）
- *   - Fragment / Portal（内联子节点）
- *   - innerHTML prop（原样输出）、class/style 对象序列化
- *   - 事件处理器 / ref 剥离、文本自动转义（XSS）
- *   - 服务端 ctx shim（$ no-op dirty、ctx.data 预取、selfId 隔离）
- *
- * 产物为 HtmlSafe 标记的安全 HTML 片段，可直接内联进 ctx.ui.html 模板。
- */
-import type { Component, AsyncComponent } from './vnode.ts';
-export interface SsrOptions {
-    /** 服务端数据存储：ctx.data 预取结果写入此处，调用方序列化进 __DATA__ */
-    data?: Map<string, unknown>;
-}
-/**
- * SSR 渲染组件 → HTML 片段（HtmlSafe 标记，可直接内联进 ctx.ui.html 模板，不二次转义）。
- *
- * ```ts
- * const data = new Map()
- * const html = await ctx.ui.ssr(BlogPage, { slug }, { data })
- * return ctx.ui.html`
- *   <div id="root">${html}</div>
- *   ${ctx.ui.ssrData(data)}
- * `
- * ```
- */
-export declare function ssrToString(Comp: Component | AsyncComponent, props: Record<string, any>, serverCtx: any, opts?: SsrOptions): Promise<string>;
-/** 序列化数据存储 → window.__DATA__ 脚本（防 XSS：转义 <） */
-export declare function serializeData(data: Map<string, unknown>): string;
-import type { UIRouter } from './router.ts';
-export interface SsrPageResult {
-    html: string;
-    /** __DATA__ 脚本（hydration 种子） */
-    dataScript: string;
-    /** 完整 HTML（含 dataScript） */
-    page: string;
-}
-/**
- * SSR 渲染路由页面 → 完整 HTML（Node 无 DOM）。
- * 执行 router 匹配 → 中间件链 → handler（async 组件）→ vnode → renderSsr。
- *
- * ```ts
- * const { page } = await ssrPage(router, { url: '/users/42' })
- * // 客户端 uiServe(router, { root, hydrate: true }) 收养
- * ```
- */
-export declare function ssrPage(router: UIRouter, opts: {
-    url: string;
-    title?: string;
-    lang?: string;
-    rootId?: string;
-    styles?: string[];
-}): Promise<SsrPageResult>;

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

@@ -1,78 +0,0 @@
-/**
- * weifuwu/ui-dom ctx.ui 工厂 — createApp 注入的 UI 能力
- *
- * 从 app.ts 拆出（P2 结构拆分）。createUi(deps) 返回完整 ui 对象：
- * render / dirty / $ / useChat / useMedia / useBreakpoint / usePopupPosition / selfId
- *
- * 内部状态（_selfId/_selfVNode/_dirtySet/_ctxVersion）集中建模为 UiInternal，
- * 消除 app.ts 中散落的 `as any`——跨模块状态误用由编译器拦截。
- */
-import type { WfuiContext, PopupPosition } from './types.ts';
-import type { VNode } from './vnode.ts';
-/** 内部 UI 状态（ctx.ui 扩展字段）——跨模块共享，编译器可检查 */
-export interface UiInternal {
-    _selfId?: string;
-    _selfVNode?: VNode;
-    _dirtySet: Set<string>;
-    _ctxVersion: number;
-    bumpCtxVersion(): void;
-    /** 异步批处理调度标记（dirty 微任务防重入） */
-    _dirtyScheduled?: boolean;
-    /** 渲染期调 render() 的推迟标记（防重入——见 ui.ts render 实现） */
-    _pendingRender?: boolean;
-    /** 渲染期调 dirty() 的推迟标记（防重入——见 ui.ts dirty 实现） */
-    _pendingDirty?: boolean;
-    /** ctx.ui.$() 的 WeakMap 缓存（每组件一个 $ 容器） */
-    _$cache?: Record<string, any>;
-    /** mount 阶段标记（内部——mountComponent 包裹） */
-    setMounting: (v: boolean) => void;
-    endMounting: () => void;
-    /** ErrorBoundary 注入的错误处理器（子组件 render 抛错时调用） */
-    _errorHandler?: (err: unknown) => void;
-}
-/** createUi 依赖（由 createApp 注入 app 级闭包状态） */
-export interface UiDeps {
-    ctx: WfuiContext;
-    renderByIds: (ids: string[]) => void;
-    getSelfId: (ui: WfuiContext['ui'] | undefined) => string | undefined;
-    dirtyBatch: Set<string>;
-    dirtySet: Set<string>;
-    mediaRegistry: Map<string, {
-        mql?: MediaQueryList;
-        handler?: (e: MediaQueryListEvent) => void;
-        mqls?: Array<{
-            mql: MediaQueryList;
-            handler: () => void;
-        }>;
-    }>;
-    popupTrackers: Map<string, {
-        pos: PopupPosition;
-        getEl: () => HTMLElement | null;
-        isOpen: () => boolean;
-        compute: (rect: DOMRect) => {
-            top: number;
-            left: number;
-            width?: number;
-        };
-    }>;
-    scrollTrackers: Map<string, {
-        handle: {
-            y: number;
-        };
-        getScroller: () => HTMLElement | Window;
-    }>;
-    schedulePopupRecompute: () => void;
-    /** 惰性挂载全局 scroll/resize 监听（幂等） */
-    ensurePopupListeners: () => void;
-    destroyPopupListeners: () => void;
-    /** 渲染保护期（dirty 被忽略） */
-    isRendering: () => boolean;
-    /** mount 阶段（组件工厂执行——$ 初始化赋值丢弃） */
-    isMounting: () => boolean;
-    /** mount 阶段标记置位/恢复（mountComponent 包裹） */
-    setMounting: (v: boolean) => void;
-    endMounting: () => void;
-    /** 注册表实例（serve 注入局部；缺省 ctx.__registry） */
-    registry?: import('./registry.ts').Registry;
-}
-export declare function createUi(deps: UiDeps): WfuiContext['ui'] & UiInternal;