weifuwu 0.33.10 → 0.34.0

package/dist/client/app.d.ts

@@ -1,34 +1,18 @@
 /**
- * weifuwu/client 应用 — 创建 ctx + 中间件链 + 挂载组件
+ * weifuwu/client 应用 — createApp + ctx.ui.render
  *
- * ```tsx
- * import { createApp, ws, router } from 'weifuwu/client'
+ * createApp() → app.use(mw) → app.mount('#root', RootComponent)
  *
- * const app = createApp()
- * app.use(ws())
- * app.use(router({ routes }))
- * app.mount('#root', AppShell)
- * ```
+ * ctx.ui 在 mount 时注入：
+ *   ctx.ui.render()    触发组件重渲染
+ *   ctx.ui.$          持久化组件状态（由渲染器管理）
+ *   ctx.ui.ready       首次执行标记（由渲染器管理）
  */
 import type { WfuiContext, AppMiddleware } from './types.ts';
-import type { Component } from './jsx-runtime.ts';
-/**
- * 创建 weifuwu/client 应用
- */
+import type { Component } from './vnode.ts';
 export declare function createApp(): {
-    ctx: WfuiContext;
-    use: (mw: AppMiddleware) => any;
-    mount: (rootSelector: string, RootComponent: Component) => Promise<void>;
-    /**
-     * Hydrate 一个已由 SSR 渲染的区域。
-     * 不清除目标容器内的内容，只附加组件输出。
-     *
-     * ```ts
-     * const app = createApp()
-     * app.use(api())
-     * app.use(auth())
-     * app.hydrate('#comments', CommentSection, { postId: '123' })
-     * ```
-     */
-    hydrate: (selector: string, Component: Component, props?: Record<string, unknown>) => void;
+    readonly ctx: WfuiContext;
+    use(mw: AppMiddleware): /*elided*/ any;
+    mount(rootSelector: string, RootComponent: Component): Promise<void>;
+    destroy(): void;
 };

package/dist/client/index.d.ts

@@ -1,139 +1,29 @@
 /**
- * weifuwu/client — 响应式前端框架，TSX + Signal
- *
- * 零虚拟 DOM，零外部依赖。组件模型：(props, ctx) => Node。
- *
- * ```tsx
- * import { signal, createApp, api, auth, ws, router, RouteView, Show, For } from 'weifuwu/client'
- * import type { WfuiContext } from 'weifuwu/client'
- *
- * const app = createApp()
- * app.use(api())
- * app.use(auth())
- * app.use(ws())
- * app.use(router({ routes }))
- * app.mount('#root', AppShell)
- * ```
- *
- * ## 核心概念
- *
- * | 导出 | 类型 | 用途 |
- * |------|------|------|
- * | `signal()` | function | 响应式数据容器 |
- * | `computed()` | function | 衍生信号 |
- * | `effect()` | function | 自动追踪依赖的副作用 |
- * | `batch()` | function | 批量更新（合并多次写入为一次通知）|
- * | `untrack()` | function | 不追踪依赖地读取信号 |
- * | `onMount()` | function | 组件挂载回调 |
- * | `onCleanup()` | function | 组件卸载回调 |
- * | `createApp()` | function | 应用实例（中间件链 + 挂载） |
- * | `createResource()` | function | 异步数据资源（loading/error/data）|
- * | `useForm()` | function | 表单状态管理（字段绑定/验证/提交）|
- * | `createStyles()` | function | 组件级作用域 CSS |
- */
-/** 创建响应式数据容器。变化时自动通知依赖方。 */
-export { signal } from './signal.ts';
-/** 基于其他 signal 的衍生值，自动缓存。 */
-export { computed } from './signal.ts';
-/** 自动追踪 signal 依赖，变化时重跑回调。返回 dispose 函数。 */
-export { effect } from './signal.ts';
-/**
- * 批量更新 — 将多个信号写入合并为一次通知。
- *
- * ```ts
- * batch(() => {
- *   a.value = 1
- *   b.value = 2
- * })
- * // 只触发一次 effect，而非两次
- * ```
- */
-export { batch } from './signal.ts';
-/** Signal 类型。 */
-export type { Signal } from './signal.ts';
-/** JSX 工厂函数 — 由 esbuild / tsc 自动调用。 */
-export { jsx, jsxs, jsxDEV } from './jsx-runtime.ts';
-/** 不产生包装元素的片段组件。 */
-export { Fragment } from './jsx-runtime.ts';
-/**
- * 条件渲染 — when 为 Signal 时响应式切换。
- *
- * ```tsx
- * <Show when={isLoggedIn} fallback={<LoginPage />}>
- *   <Dashboard />
- * </Show>
- * ```
- */
-export { Show } from './jsx-runtime.ts';
-/**
- * 列表渲染 — each 为 Signal 时响应式更新。支持 keyBy 属性复用 DOM 节点。
- *
- * ```tsx
- * <For each={items} keyBy="id">
- *   {(item) => <div>{item.name}</div>}
- * </For>
- * ```
- */
-export { For } from './jsx-runtime.ts';
-/**
- * onMount — 组件根元素挂载到 DOM 后执行的回调。
- * 返回函数在组件卸载时自动清理。
- *
- * ```tsx
- * function Chart() {
- *   onMount(() => {
- *     const chart = echarts.init(el)
- *     return () => chart.dispose()
- *   })
- *   return <div ref={el => chartEl = el} />
- * }
- * ```
- */
-export { onMount } from './jsx-runtime.ts';
-/**
- * onCleanup — 组件卸载时执行的回调（清理定时器、订阅等）。
- *
- * ```tsx
- * function Timer() {
- *   const id = setInterval(tick, 1000)
- *   onCleanup(() => clearInterval(id))
- *   return <div>...</div>
- * }
- * ```
- */
-export { onCleanup } from './jsx-runtime.ts';
-/** 组件类型签名：(props, ctx) => Node */
-export type { Component } from './jsx-runtime.ts';
-/** 应用上下文 — 组件通过第二个参数 ctx 访问。 */
-export type { WfuiContext } from './types.ts';
-/** 中间件签名：(ctx) => ctx */
-export type { AppMiddleware } from './types.ts';
-/** 路由定义：path / component / auth / title / loader */
-export type { RouteDef } from './types.ts';
-/**
- * 创建 weifuwu/client 应用实例。
- *
- * ```tsx
- * const app = createApp()
- * app.use(api())
- * app.use(auth())
- * app.use(router({ routes }))
- * await app.mount('#root', AppShell)
- * ```
- */
+ * weifuwu/client — VDOM 前端框架
+ *
+ * 概念：
+ *   组件 = (props, ctx) => VNode
+ *   状态 = JS 变量
+ *   更新 = ctx.ui.render()
+ *   挂载/卸载 = ref 回调
+ *
+ * 导出：
+ *   h / jsx / jsxs / jsxDEV / Fragment  → JSX 工厂
+ *   createApp                            → 应用引导
+ *   router / RouteView                   → 路由
+ *   api / auth / ws                      → 中间件
+ *   extendCtx                            → ctx 扩展
+ *   WfuiContext / AppMiddleware / RouteDef → 类型
+ */
+export { h, jsx, jsxs, jsxDEV, Fragment } from './vnode.ts';
+export type { VNode, VNodeType, Component } from './vnode.ts';
 export { createApp } from './app.ts';
-/**
- * 路由中间件 — 注入 ctx.route / ctx.app.navigate。
- * 支持 hash / history 模式，loader 数据预取，auth 守卫。
- */
-export { router } from './router.ts';
-/**
- * RouteView 组件 — 渲染当前路由匹配的组件。
- * 用 `<RouteView />` 放在布局中作为路由出口。
- */
-export { RouteView } from './router.ts';
-/**
- * WebSocket 中间件 — 注入 ctx.ws（send / onMessage / join / leave）。
- * 自动重连，支持房间。
- */
+export { router, RouteView } from './router.ts';
 export { ws } from './middleware/ws.ts';
+export { api } from './middleware/api.ts';
+export { auth } from './middleware/auth.ts';
+export type { ApiClient, ApiOptions, ApiRequestOptions } from './middleware/api.ts';
+export { ApiError } from './middleware/api.ts';
+export type { AuthClient, AuthOptions } from './middleware/auth.ts';
+export { extendCtx } from './types.ts';
+export type { WfuiContext, AppMiddleware, RouteDef } from './types.ts';