weifuwu 0.55.2 → 0.56.0

package/dist/ui/index.d.ts

@@ -26,6 +26,7 @@
  * ```
  */
 import type { Middleware } from '../types.ts';
+import type { Component, AsyncComponent } from '../client/vnode.ts';
 declare module '../types.ts' {
     interface Context {
         ui: {
@@ -35,6 +36,16 @@ declare module '../types.ts' {
             js: (entryPath: string) => Promise<Response>;
             /** 读取 CSS → CSS Response（支持包名 weifuwu/layout、weifuwu/components/style.css 或文件路径） */
             css: (entryPath: string) => Promise<Response>;
+            /**
+             * SSR 渲染组件 → HTML 片段（HtmlSafe，可直接内联进 ctx.ui.html 模板）
+             * 支持 async 工厂组件：await 工厂 → 数据进 HTML。
+             * opts.data（Map）收集 ctx.data 预取结果，用 ctx.ui.ssrData(data) 序列化进 __DATA__。
+             */
+            ssr: (Comp: Component | AsyncComponent, props?: Record<string, any>, opts?: {
+                data?: Map<string, unknown>;
+            }) => Promise<string>;
+            /** 序列化 SSR 数据存储 → <script>window.__DATA__=...</script>（HtmlSafe） */
+            ssrData: (data: Map<string, unknown>) => string;
         };
     }
 }

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

@@ -0,0 +1,41 @@
+/**
+ * uiSsr — 路由级 SSR 中间件：前端路由表驱动的自动服务端渲染
+ *
+ * 开发者只声明路由（path + component），GET 匹配即自动 SSR：
+ *   匹配 → 注入 params → ctx.ui.ssr 渲染组件（async 工厂 await）→ 页面模板 + __DATA__
+ *   未匹配 → next()（交给后续 API/静态/404）
+ *
+ * 与客户端 router() 共用同一份路由定义（route-match.ts），SPA/SSR 一个声明。
+ */
+import type { Middleware } from '../types.ts';
+import type { RouteDef } from '../client/types.ts';
+export interface UiSsrOptions {
+    /** 前端路由定义（与 router() 共享同一份） */
+    routes: RouteDef[];
+    /** 客户端 bundle 路径（自动注入 <script src>，如 '/static/app.js'） */
+    bundle?: string;
+    /** CSS 路径数组（自动注入 <link rel="stylesheet">，如 ['/static/style.css']） */
+    styles?: string[];
+    /** 自定义 title（默认取路由定义 title 或 'weifuwu'） */
+    title?: (ctx: {
+        params: Record<string, string>;
+        def: RouteDef;
+    }) => string;
+    /** 自定义页面模板：返回完整 HTML（默认内置，含 head/root/__DATA__/styles/bundle） */
+    template?: (parts: {
+        html: string;
+        dataScript: string;
+        title: string;
+        bundle?: string;
+        styles?: string[];
+    }) => string;
+}
+/**
+ * 路由级 SSR 中间件：
+ *
+ * ```ts
+ * const app = new Router()
+ * app.use(uiSsr({ routes, bundle: '/static/app.js' }))
+ * ```
+ */
+export declare function uiSsr(opts: UiSsrOptions): Middleware;

package/dist/ui/ssr.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 服务端 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 '../client/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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "weifuwu",
   "type": "module",
-  "version": "0.55.2",
+  "version": "0.56.0",
   "description": "AI SaaS framework — (req, ctx) => Response",
   "exports": {
     ".": {
@@ -22,7 +22,8 @@
       "types": "./dist/components/index.d.ts",
       "default": "./dist/components/index.js"
     },
-    "./components/style.css": "./dist/components/style.css"
+    "./components/style.css": "./dist/components/style.css",
+    "./dev": "./dist/dev/index.js"
   },
   "files": [
     "dist/",
@@ -35,9 +36,12 @@
     "pretest": "docker compose up -d --wait postgres redis 2>/dev/null; sleep 1",
     "test": "node --env-file=.env --test 'src/test/**/*.test.ts' 'src/components/**/*.test.ts' 'src/db/**/*.test.ts'",
     "release": "node scripts/release.mjs",
-    "release:dry": "node scripts/release.mjs --dry-run"
+    "release:dry": "node scripts/release.mjs --dry-run",
+    "demo": "node --import weifuwu/dev --env-file=.env apps/demo/server.ts",
+    "demo:build": "node apps/demo/scripts/build.mjs"
   },
   "dependencies": {
+    "esbuild": "^0.28.1",
     "graphql": "^16",
     "ws": "^8"
   },
@@ -62,7 +66,6 @@
     "@tailwindcss/postcss": "^4.3.3",
     "@types/node": "^25",
     "@types/ws": "^8",
-    "esbuild": "^0.28.1",
     "ioredis": "^5.11.1",
     "jsdom": "^29.1.1",
     "postcss": "^8.5.19",