weifuwu 0.87.0 → 0.89.0

package/dist/client/vdom/core/build.d.ts

@@ -1,36 +0,0 @@
-/**
- * vdom core — build 阶段（vnode → 全量命令事件流）
- *
- * 四阶段管线（route → build → diff → patch）：build 是「新树渲染」——
- * vnode → 命令事件流（create/insert/close...——done.full 全量标记——
- * patch 据此清理旧树多余节点）。
- *
- * **共享渲染分发器**（createRenderDispatcher——build/diff 共用——单一
- * 规则源）：kindOf 分类 → 各 node/ 文件渲染（text/hole/array/fragment/
- * element/component/invalid）——diff 的新侧渲染复用本分发器——
- * **消除重复**（diff 只做对照决策——新侧渲染走这里）。
- */
-import type { VNode, VNodeChild } from './vnode.ts';
-import { type ComponentRegistry } from './node/component.ts';
-import type { UIContext } from '../context/UIContext.ts';
-import type { Command } from './command/index.ts';
-/** 渲染 sink（子节点递归出口——build/diff 共用） */
-export type RenderSink = (v: VNodeChild, parent: string, index: number, ref: string | null) => Promise<void>;
-/**
- * 创建渲染分发器（**共享——build 首帧/diff 新侧渲染同一实现**）：
- * emit(v, parent, index, ref)——kindOf 分类 → 各 node/ 文件渲染
- */
-/** 生成端 emit 状态机（**维度 6——2026-XX**）：
- *  本流内 id 类型表（id → 节点形态）——验证：
- *  ① create 类型冲突：同 id 先 el 后 text（或反）→ 违例（投影错位）
- *  ② insert parent 容器性：parent 是已生成的锚/文本 → 违例（id 空间
- *     错位——组件 fuzz an:root.0(div) 类在生成时暴露——而非消费/终态）
- *  宽容项：parent 不在类型表（组件 compId——sink 特判子空间）→ 合法
- *    （段回退由消费端处理）；create 同 id 同类型重复（幂等复用）→ 合法
- *  报告：console.error（不中断生成——生成端产物仍由对账器裁决） */
-export declare function createRenderDispatcher(emitCommand: (cmd: Command) => void, ctx: UIContext, registry: ComponentRegistry): RenderSink;
-/**
- * vnode → 全量命令事件流（首帧/导航——done.full——patch 清理旧树多余）
- * ctx：组件共享上下文（serve 创建）；registry：组件实例注册表
- */
-export declare function renderToStream(root: VNode, ctx?: UIContext, registry?: ComponentRegistry): ReadableStream<Command>;

package/dist/client/vdom/core/diff/children.d.ts

@@ -1,29 +0,0 @@
-/**
- * vdom core/diff — children（children 对照 + keyed 列表策略——细节模块）
- *
- * 职责：children 列表对照——A 级检测（长度变化 + 无 key 组件 warn）、
- * 列表分类（all-keyed/含 keyed/unkeyed）、diffSlot 单槽对照（位置身份——
- * 含 null ↔ null 空洞保持）、diffKeyedChildren（相对顺序检测——顺移
- * noMove remap / 交换重建 / 实例复用）、emitWithKey（keyed 项渲染）。
- *
- * diff/same 只做中转——本文件为列表策略细节。
- */
-import type { VNode, VNodeChild } from '../vnode.ts';
-import { type ComponentRegistry } from '../node/component.ts';
-import type { Command } from '../command/index.ts';
-import type { RenderSink } from '../build.ts';
-import type { UIContext } from '../../context/UIContext.ts';
-/** children 对照（列表分类：全 unkeyed 位置身份 / 全 keyed 身份复用 / 混合） */
-export declare function diffChildren(oldV: VNode, newV: VNode, id: string, emit: RenderSink, emitCommand: (cmd: Command) => void, ctx: UIContext, registry: ComponentRegistry): Promise<void>;
-/** children 项对照（列表分类：全 unkeyed 位置身份 / 全 keyed 身份复用 / 混合——
- *  组件数组输出（隐式 Fragment）同用——旧项移除清理） */
-export declare function diffChildrenItems(oldCs: VNodeChild[], newCs: VNodeChild[], id: string, emit: RenderSink, emitCommand: (cmd: Command) => void, ctx: UIContext, registry: ComponentRegistry, shapeChanged?: boolean): Promise<void>;
-export declare function hasKeyed(items: VNodeChild[]): boolean;
-/** keyed 列表对照（身份映射——增删/重排状态跟随 key）
- *  **move 版**（2026-12）：复用项位置变化 → **move 命令**（DOM 不重建——
- *  节点移动 + 子树 id 重映射——焦点保持）；位置不变 → 组件输出对照（精准）；
- *  真移除 → unmount + remove；新增 → 新侧渲染 */
-export declare function diffKeyedChildren(oldCs: VNodeChild[], newCs: VNodeChild[], parent: string, emit: RenderSink, emitCommand: (cmd: Command) => void, ctx: UIContext, registry: ComponentRegistry): Promise<void>;
-/** keyed 项渲染（compId = 位置路径 + .k{key}——身份稳定——增删/重排复用）
- *  组件输出对照（lastOutput → diffSame 精准——move 后节点已在新位置） */
-export declare function emitWithKey(v: VNodeChild, parent: string, index: number, ref: string | null, key: string, emit: RenderSink, emitCommand: (cmd: Command) => void, ctx: UIContext, registry: ComponentRegistry): Promise<void>;

package/dist/client/vdom/core/diff/index.d.ts

@@ -1,22 +0,0 @@
-/**
- * vdom core/diff — index（diff 阶段中转站）
- *
- * 职责：**中转站——自身不处理细节逻辑**——root 级对照决策
- * （transitionOf 查表——异态交 transform / 同态交 diffSame）——细节
- * 下沉独立模块：
- * - same.ts：同态对照决策（组件/元素分支——再中转）
- * - attrs.ts：属性值比较（精准命令）
- * - children.ts：children 对照 + keyed 列表策略
- * - output.ts：组件输出对照（null ↔ vnode/数组对照）
- * - cleanup.ts：旧输出递归清理
- * - transform/：类型转换状态机（异态执行）
- */
-import type { VNode } from '../vnode.ts';
-import type { ComponentRegistry } from '../node/component.ts';
-import type { UIContext } from '../../context/UIContext.ts';
-import type { Command } from '../command/index.ts';
-/**
- * diff：旧树 → 新树——精准增量命令事件流
- * ctx：组件共享上下文；registry：组件实例注册表（跨渲染保持）
- */
-export declare function diffStream(oldTree: VNode, newTree: VNode, ctx: UIContext, registry: ComponentRegistry): ReadableStream<Command>;

package/dist/client/vdom/core/diff/output.d.ts

@@ -1,30 +0,0 @@
-/**
- * vdom core/diff — output（组件输出对照——细节模块）
- *
- * 职责：组件 renderFn 输出的对照决策——输出级空值转换（null ↔ vnode——
- * transform 状态机）、单节点对照（diffSame）、数组输出对照（逐项 diffSlot）、
- * 数组 ↔ 单节点（transform——旧展开区间递归清理）、类型切换（卸载重建）。
- *
- * diffSame 组件分支的 sink 在此实现——diff/same 只做中转。
- */
-import type { VNode, VNodeChild } from '../vnode.ts';
-import type { Command } from '../command/index.ts';
-import type { RenderSink } from '../build.ts';
-import type { ComponentRegistry, CompOutput } from '../node/component.ts';
-import type { UIContext } from '../../context/UIContext.ts';
-/** 组件输出对照（组件分支 sink——细节集中在此）
- *  **方案 3——判别联合穷尽**：oldOut 为 CompOutput（null 结构性消除）——
- *  switch(kind) 编译器强制——hole（空洞锚）与真实输出同等处理——
- *  undefined = 未渲染（首帧——全量渲染） */
-export declare function diffComponentOutput(oldOut: CompOutput | undefined, out: VNodeChild, p: string, i: number, r: string | null, emit: RenderSink, emitCommand: (cmd: Command) => void, ctx: UIContext, registry: ComponentRegistry, diffSame: (oldV: VNode, newV: VNode, parent: string, index: number, ref: string | null, emit: RenderSink, emitCommand: (cmd: Command) => void, ctx: UIContext, registry: ComponentRegistry) => Promise<void>, 
-/** 组件实例 compId（**证明审计——输出形态 id 空间**）：组件输出单元素
- *  挂槽位（锚点法——id = compId）；空洞/数组/组件输出挂 compId 子空间
- *  （compId.0 起）——转换的 oldId 必须按**旧输出形态**计算（p/i 是
- *  新输出的 sink 参数——数组/空洞输出时 p=compId、i=0——outId 对新
- *  输出正确对旧输出错位——可变输出 div→数组/收缩/展开实证——旧 div
- *  保留 + 锚插入 + 实例残留）
- *  @param slotId 组件槽位（单元素/文本输出挂载点——= pathId(渲染父,
- *  渲染索引)——keyed 组件 compId ≠ 槽位——必须由调用点提供）
- *  @param keyedOut keyed 组件输出回调（对照分支——keyed 输出组件的
- *  rec 在 keyedId(p, key)——diffSame 按槽位查落空——递归 emitWithKey） */
-compId: string, slotId: string, keyedOut?: (out: VNodeChild, p: string, i: number, r: string | null, key: string) => Promise<void>): Promise<void>;

package/dist/client/vdom/core/diff/same.d.ts

@@ -1,22 +0,0 @@
-/**
- * vdom core/diff — same（同态对照决策——中转）
- *
- * 职责：同位置同类型的对照决策——组件分支（类型比较/复用——输出对照
- * 细节在 output.ts）、元素分支（diffAttrs + diffChildren——细节在
- * attrs.ts/children.ts）。
- *
- * 本文件是「对照决策的中转站」——具体命令生成下沉 attrs/children/output/
- * cleanup——自身不处理细节逻辑。
- */
-import type { VNode } from '../vnode.ts';
-import { type ComponentRegistry } from '../node/component.ts';
-import type { Command } from '../command/index.ts';
-import type { RenderSink } from '../build.ts';
-import type { UIContext } from '../../context/UIContext.ts';
-/**
- * 同态对照（同位置同类型——**精准命令生成**）：
- * 组件 → renderComponent 复用（工厂不重跑——lastOutput 对照递归）；
- * 元素 → 属性值比较（只发变化）+ 函数面引用比较 + children 递归（列表分类）
- */
-export declare function diffSame(oldV: VNode, newV: VNode, parent: string, index: number, ref: string | null, emit: RenderSink, emitCommand: (cmd: Command) => void, ctx: UIContext, registry: ComponentRegistry): Promise<void>;
-/** 属性精准 diff（值比较——只发变化的键；函数面引用比较——prev 传递） */

package/dist/client/vdom/core/serve.d.ts

@@ -1,75 +0,0 @@
-/**
- * vdom core — uiServe（渲染落地——公共面——双端一体）
- *
- * 设计（design/vdom-plan.md §3/§4）：
- * - UIRouter 唯一应用入口——uiServe(router, { root }) 收养渲染（真实浏览器全局
- *   document/window——2026-12 删除 browser 注入——测试与生产同环境）
- * - 渲染循环：初始 URL resolve → Response（command 事件流）→ patch
- * - **ctx.render() = 重新渲染**（事件触发/fetch 结束/定时器回调的唯一入口）：
- *   重新 resolve（handler 重跑——registry 复用——组件工厂不重跑——
- *   renderFn 重调读最新状态）→ **新的 Response command 事件流** → 消费
- *   （patch 对照现有 DOM 节点——幂等——就地更新）
- * - 函数面传输：同进程共享函数表——编码时函数 → {$fn: n} 标记——
- *   解码时查表还原（事件绑定跨 Response 保持）
- *
- * 服务端面（SSR——同一 handler 同一 Response——body 经 commandToHtml()
- * TransformStream 流式吐 HTML）后续实现。
- */
-import { UIRouter } from './router.ts';
-import type { VNode } from './vnode.ts';
-import type { UIContext } from '../context/UIContext.ts';
-import type { Command } from './command/index.ts';
-/** 函数表还原（$fn 标记 → 函数——编码/解码同进程共享） */
-export declare function reviveFn(fnTable: Map<number, unknown>): (k: string, v: unknown) => unknown;
-/** NDJSON 命令流解析（行缓冲——命令可能跨 chunk——函数表还原——
- * 导出（测试——跨 chunk 边界/畸形行合规断言）） */
-export declare function commandReader(reader: ReadableStreamDefaultReader<Uint8Array>, fnTable: Map<number, unknown>): AsyncGenerator<Command>;
-/** 命令流编码（函数面 → {$fn: n}——函数表——同进程共享） */
-export declare function encodeCommands(stream: ReadableStream<Command>, fnTable: Map<number, unknown>): ReadableStream<Uint8Array>;
-/** 函数表（serve 级共享——编码/解码同进程） */
-export declare function createFnTable(): Map<number, unknown>;
-export interface UiServeOptions {
-    /** 根容器（选择器或元素——'#root'） */
-    root: string | HTMLElement;
-    /** 中间件注入面（ctx.api/auth/ws/i18n——组件/页面可用——可选） */
-    api?: import('../middlewares/api.ts').ApiClient;
-    auth?: import('../middlewares/auth-i18n.ts').AuthClient;
-    ws?: import('../middlewares/ws.ts').WsClient;
-    i18n?: import('../middlewares/auth-i18n.ts').I18nState;
-    /** 命令式轻提示（ctx.toast——应用装配） */
-    toast?: (message: string, type?: 'success' | 'error' | 'info' | 'warning', duration?: number) => void;
-    /** 命令式确认（ctx.confirm——应用装配——返回 Promise<boolean>） */
-    confirm?: (message: string, options?: Record<string, unknown>) => Promise<boolean>;
-    /** 命令式通知（ctx.notification——应用装配） */
-    notification?: unknown;
-    /**
-     * 渲染错误回退 UI（R1 熔断——连续渲染错误达阈值后显示——应用可配置——
-     * 缺省内置：错误文案 + 重试按钮（独立于应用路由——不依赖 router.resolve））
-     */
-    errorFallback?: (error: Error, ctx: UIContext) => VNode;
-}
-export interface UiServeHandle {
-    /** 首帧渲染完成 Promise（await 精确等待） */
-    ready: Promise<void>;
-    /** 编程式导航（URL 变化 → 重新 resolve → 新命令事件流 → 消费——
-     *   root 异类型 = 整树替换；同类型 = diff 精准） */
-    navigate(path: string): Promise<void>;
-    /** 卸载（清理 DOM/监听） */
-    unmount(): void;
-}
-/** serve 生命周期状态机（**全部状态机化——2026-XX**）：
- *  active → unmounted（unmount 消费——迁移后 render/navigate 违例报错） */
-export type ServePhase = 'active' | 'unmounted';
-/** 渲染队列状态机（**替代裸 rendering boolean**）：
- *  idle → rendering（render 启动）→ idle（runRender 完成/错误/队列空）
- *  - rendering 中 render() → 入队（合法——FIFO 确定性——非违例）
- *  - unmounted 中 render()/navigate() → 违例报错（DOM 已清——静默渲染
- *    是隐藏错误——审计 2026-XX） */
-export type RenderPhase = 'idle' | 'rendering';
-/** 页面作者渲染入口（ctx 面——vnode → Response command 事件流——
- *  公共面仍只有 h/jsx/uiServe/UIRouter——本入口经 ctx 提供） */
-export interface RenderCtx extends UIContext {
-    /** vnode → Response（command 事件流——函数表编码——事件绑定跨流保持） */
-    stream(vnode: VNode, init?: ResponseInit): Response;
-}
-export declare function uiServe(router: UIRouter, opts: UiServeOptions): UiServeHandle;

package/dist/client/vdom/core/ssr/index.d.ts

@@ -1,25 +0,0 @@
-/**
- * vdom core/ssr — index（SSR 中转站——自身不处理细节逻辑）
- *
- * 职责：服务端渲染入口（uiSsr——同一 UIRouter 同一 handler）——
- * 具体功能交由独立文件：
- * - html.ts（commandToHtml 流式序列化 + htmlDocument 文档包装）
- * - absorb.ts（客户端结构吸收状态机——首帧复用 SSR DOM）
- *
- * 与客户端同构：同一命令流——客户端 apply DOM / 服务端吐 HTML——
- * 首帧吸收（结构对齐）——接管原子性（mismatch → 回退清空重建）。
- */
-export { escapeHtml, attrsToHtml, htmlDocument, commandToHtml, VOID_ELEMENTS, kebab } from './html.ts';
-export { AbsorbState } from './absorb.ts';
-import { UIRouter } from '../router.ts';
-/** 服务端渲染选项 */
-export interface SsrOptions {
-    title?: string;
-    /** __DATA__ 种子（ctx.data 预取结果——序列化进文档） */
-    data?: Record<string, unknown>;
-}
-/** 服务端渲染（SSR——同一 router 同一 handler——命令流 → HTML 文档）
- *  **无 hydration**（客户端接管结构吸收——SSR = 首屏/SEO + 吸收种子）；
- *  函数面（事件）经空函数表编码为 $fn 标记——解码 undefined——
- *  commandToHtml 的 setProp no-op——HTML 无运行时面 */
-export declare function uiSsr(router: UIRouter, url: string, opts?: SsrOptions): Promise<string>;

package/examples/apps/admin/README.md

@@ -1,23 +0,0 @@
-# admin 应用模板（复制即用）
-
-```bash
-# 1. 安装依赖（weifuwu 包——含 content/ 离线文档 + examples/ 模板源码）
-npm i weifuwu
-
-# 2. 复制本目录到你的项目（或直接在 examples/apps/admin 内开发）
-# 3. 启动
-node server.ts    # → http://localhost:admin/3300 3301 3302 3303
-```
-
-## 改造指南
-
-见 `node_modules/weifuwu/content/apps/admin.md`（目录结构 + 逐步改造步骤）。
-
-## 结构
-
-| 文件 | 职责 |
-|------|------|
-| app.tsx | 前端：路由表 + 页面组件 + 状态 |
-| api.ts | 后端：API 注册函数（独立/嵌入共享） |
-| server.ts | 独立入口（MemorySql——生产换 postgres() 一行） |
-| main.tsx | 独立前端入口 |

package/examples/apps/admin/api.ts

@@ -1,27 +0,0 @@
-/**
- * admin 后端 API——订单表（注册函数：独立 server 与 showcase 嵌入共享）
- */
-import type { Router } from 'weifuwu'
-
-export function registerAdminApi(app: Router, sql: any): void {
-  app.get('/api/admin/orders', async () => {
-    const rows = await sql`SELECT * FROM admin_orders ORDER BY id DESC LIMIT 50`
-    return Response.json({ rows })
-  })
-}
-
-/** 建表 + 种子数据（独立/嵌入共用） */
-export async function ensureAdminTables(sql: any): Promise<void> {
-  await sql.unsafe('CREATE TABLE IF NOT EXISTS admin_orders (id serial PRIMARY KEY, customer text, amount numeric, status text, date text)')
-  const rows = await sql`SELECT COUNT(*) AS n FROM admin_orders`
-  if (Number(rows[0]?.n) > 0) return
-  const seed = [
-    ['张伟', 1280, 'paid', '2026-08-10'], ['李娜', 560, 'pending', '2026-08-11'],
-    ['王强', 3200, 'shipped', '2026-08-12'], ['赵敏', 890, 'paid', '2026-08-13'],
-    ['陈杰', 2100, 'pending', '2026-08-14'], ['刘洋', 450, 'paid', '2026-08-15'],
-    ['孙丽', 1750, 'shipped', '2026-08-16'], ['周涛', 980, 'paid', '2026-08-17'],
-  ]
-  for (const [customer, amount, status, date] of seed) {
-    await sql`INSERT INTO admin_orders (customer, amount, status, date) VALUES (${customer}, ${amount}, ${status}, ${date})`
-  }
-}

package/examples/apps/admin/app.tsx

@@ -1,144 +0,0 @@
-/**
- * admin 应用模板——管理后台（AppShell + 多页 + 表格，完整全栈复制即用）
- *
- * 演示能力：
- *   - Layout 组件骨架（Sider 折叠 + Header + Content）+ 路由 layout 包裹复用
- *   - Table 排序 + StatCard KPI + 菜单导航（源于 agent-platform 架构提炼）
- *   - 后端：MemorySql 订单表（api.ts 注册函数——独立/嵌入共享）
- */
-import { UIRouter, uiServe, h, createStore, createClientBrowser } from 'weifuwu/vdom'
-import type { Component } from 'weifuwu/vdom'
-import { Layout, LayoutHeader, LayoutSider, LayoutContent, Menu, StatCard, Table, Badge, Tag, ThemeSwitch, PageHeader, EmptyState } from 'weifuwu/components'
-
-export interface Order { id: string; customer: string; amount: number; status: 'pending' | 'paid' | 'shipped'; date: string }
-
-export const adminStore = createStore<{ orders: Order[]; loading: boolean }>({ orders: [], loading: true })
-
-export async function loadOrders(): Promise<void> {
-  const res = await fetch('/api/admin/orders')
-  const data = await res.json()
-  adminStore.update((s) => { s.orders = data.rows; s.loading = false })
-}
-
-const statusTag = (s: Order['status']) =>
-  s === 'paid' ? <Tag variant="success">已支付</Tag> : s === 'shipped' ? <Tag variant="primary">已发货</Tag> : <Tag>待支付</Tag>
-
-/** 仪表盘页 */
-export const DashboardPage: Component = async (_init: any, ctx: any) => {
-  void loadOrders()
-  const state = ctx.ui.useExternal(adminStore)
-  const paid = state.orders.filter((o: Order) => o.status === 'paid' || o.status === 'shipped')
-  const total = state.orders.reduce((a: number, o: Order) => a + o.amount, 0)
-  return async (_p: any) => (
-    <div class="wf-stack wf-gap-md">
-      <PageHeader title="仪表盘" sub="KPI + 订单概览（数据来自 MemorySql）" />
-      <div class="wf-grid" style="--wf-cols:repeat(auto-fit,minmax(180px,1fr));--wf-gap:12px">
-        <StatCard label="订单总数" value={state.orders.length} />
-        <StatCard label="已支付/发货" value={paid.length} />
-        <StatCard label="销售总额" value={`¥${total.toLocaleString()}`} />
-        <StatCard label="待处理" value={state.orders.filter((o: Order) => o.status === 'pending').length} />
-      </div>
-      {state.loading ? <div class="wf-text-secondary">加载中…</div> : (
-        <Table
-          columns={[
-            { key: 'id', label: '订单号' },
-            { key: 'customer', label: '客户' },
-            { key: 'amount', label: '金额', sortable: true, render: (v: any) => `¥${Number(v).toLocaleString()}` },
-            { key: 'date', label: '日期' },
-            { key: 'status', label: '状态', render: (v: any) => statusTag(v) },
-          ]}
-          data={state.orders}
-         
-        />
-      )}
-    </div>
-  )
-}
-
-/** 订单页（全量表格 + 筛选） */
-export const OrdersPage: Component = async (_init: any, ctx: any) => {
-  void loadOrders()
-  const state = ctx.ui.useExternal(adminStore)
-  let q = ''
-  return async (_p: any) => {
-    const list = state.orders.filter((o: Order) => !q || o.customer.toLowerCase().includes(q.toLowerCase()) || o.id.includes(q))
-    return (
-      <div class="wf-stack wf-gap-md">
-        <PageHeader title="订单管理" sub={`共 ${list.length} 条`}>
-          <input class="wf-input" style="max-width:200px" placeholder="搜索客户/订单号…" value={q}
-            onInput={(e: any) => { q = (e.target as HTMLInputElement).value; ctx.render() }} />
-        </PageHeader>
-        {list.length === 0 && !state.loading ? <EmptyState text="无匹配订单" /> : (
-          <Table
-            columns={[
-              { key: 'id', label: '订单号' },
-              { key: 'customer', label: '客户', sortable: true },
-              { key: 'amount', label: '金额', sortable: true, render: (v: any) => `¥${Number(v).toLocaleString()}` },
-              { key: 'date', label: '日期' },
-              { key: 'status', label: '状态', render: (v: any) => statusTag(v) },
-            ]}
-            data={list}
-           
-          />
-        )}
-      </div>
-    )
-  }
-}
-
-// ── 路由（layout 包裹 = AppShell 复用——跨页保持侧栏/折叠状态） ──
-export const adminRoutes = [
-  { path: '/', render: () => h(DashboardPage, {}) },
-  { path: '/orders', render: () => h(OrdersPage, {}) },
-]
-
-const AppShell: Component = async (_init: any, ctx: any) => {
-  let collapsed = false
-  const current = () => location.hash.replace('#/', '') || '/'
-  return async (props: any) => (
-    <Layout style="min-height:420px;border:1px solid var(--wf-color-border);border-radius:8px;overflow:hidden">
-      <LayoutSider collapsed={collapsed} collapsible onCollapse={(c) => { collapsed = c; ctx.render() }} width={200}>
-        <div style={{ background: "var(--wf-color-bg-secondary)", height: "100%" }}>
-        <div class="wf-p-sm wf-text-bold" style="color:var(--wf-color-text)">⚙️ 管理后台</div>
-        <Menu
-          items={[
-            { key: '/', label: '仪表盘' },
-            { key: '/orders', label: '订单管理' },
-          ]}
-          activeKey={current()}
-          collapsible
-          collapsed={collapsed}
-          onCollapseChange={(c) => { collapsed = c; ctx.render() }}
-          onSelect={(k: string) => { location.hash = `#/${k === '/' ? '' : k}` }}
-        />
-        </div>
-      </LayoutSider>
-      <Layout>
-        <LayoutHeader style="display:flex;align-items:center;justify-content:flex-end;gap:8px">
-          <Badge variant="success">admin 模板</Badge>
-          <ThemeSwitch />
-        </LayoutHeader>
-        <LayoutContent style="padding:16px">{props.page}</LayoutContent>
-      </Layout>
-    </Layout>
-  )
-}
-
-export const adminAppShell = AppShell
-
-export function createAdminApp(root: HTMLElement, options?: { history?: boolean }): ReturnType<typeof uiServe> {
-  // vdom 规范面：UIRouter（Trie 匹配）+ uiServe（渲染落地）——布局共享
-  // （root 稳定——AppShell 包裹——精准路由切换）
-  const router = new UIRouter()
-  for (const r of adminRoutes) {
-    router.get(r.path, (req: Request, ctx: any) =>
-      (ctx as { stream: (v: unknown) => Response }).stream(h(AppShell, { page: r.render() })))
-  }
-  return uiServe(router, {
-    root,
-    browser: createClientBrowser()!,
-    ...(options?.history === false ? {} : {}),
-  })
-}
-
-export const pathFromHash = (): string => location.hash.replace(/^#/, '') || '/'

package/examples/apps/admin/main.tsx

@@ -1,8 +0,0 @@
-/**
- * admin 独立入口——复制本目录即可运行：
- *   cd examples/apps/admin && node server.ts → http://localhost:3302
- */
-import { createAdminApp, pathFromHash } from './app.tsx'
-
-const sub = createAdminApp(document.querySelector('#root') as HTMLElement)
-window.addEventListener('hashchange', () => sub.navigate(pathFromHash()))

package/examples/apps/admin/server.ts

@@ -1,37 +0,0 @@
-/**
- * admin 独立 server——MemorySql 订单表（生产换 postgres()）
- *   cd examples/apps/admin && node server.ts → http://localhost:3302
- */
-import { serve, Router, ui, createMemorySql } from 'weifuwu'
-import { resolve, dirname } from 'node:path'
-import { fileURLToPath } from 'node:url'
-import { registerAdminApi, ensureAdminTables } from './api.ts'
-
-const __dirname = dirname(fileURLToPath(import.meta.url))
-const sql = createMemorySql()
-await ensureAdminTables(sql)
-
-const app = new Router()
-app.use(ui())
-app.get('/app.js', (req, ctx) => ctx.ui.js(resolve(__dirname, 'main.tsx')))
-registerAdminApi(app, sql)
-
-app.get('/*', async (req, ctx) => ctx.ui.html`
-<!DOCTYPE html>
-<html lang="zh-CN">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <link rel="stylesheet" href="/components.css">
-  <title>admin 应用模板</title>
-</head>
-<body>
-  <div id="root"></div>
-  <script src="/app.js"></script>
-</body>
-</html>
-`)
-app.get('/components.css', (req, ctx) => ctx.ui.css('weifuwu/components/style.css'))
-
-serve(app, { port: 3302 })
-console.log('admin 模板 → http://localhost:3302')

package/examples/apps/auth/README.md

@@ -1,23 +0,0 @@
-# auth 应用模板（复制即用）
-
-```bash
-# 1. 安装依赖（weifuwu 包——含 content/ 离线文档 + examples/ 模板源码）
-npm i weifuwu
-
-# 2. 复制本目录到你的项目（或直接在 examples/apps/auth 内开发）
-# 3. 启动
-node server.ts    # → http://localhost:auth/3300 3301 3302 3303
-```
-
-## 改造指南
-
-见 `node_modules/weifuwu/content/apps/auth.md`（目录结构 + 逐步改造步骤）。
-
-## 结构
-
-| 文件 | 职责 |
-|------|------|
-| app.tsx | 前端：路由表 + 页面组件 + 状态 |
-| api.ts | 后端：API 注册函数（独立/嵌入共享） |
-| server.ts | 独立入口（MemorySql——生产换 postgres() 一行） |
-| main.tsx | 独立前端入口 |

package/examples/apps/auth/api.ts

@@ -1,49 +0,0 @@
-/**
- * auth 后端 API——内存用户表 + 会话（注册函数：独立 server 与 showcase 嵌入共享）
- */
-import type { Router } from 'weifuwu'
-import { createMemorySql } from 'weifuwu'
-
-export interface AuthUser { id: string; email: string; name: string }
-
-export function registerAuthApi(app: Router, sql: any): void {
-  // 内存会话表（token → userId）——演示用；生产换 ctx.auth/userSystem
-  const sessions = new Map<string, string>()
-  let seq = 0
-
-  app.post('/api/auth/register', async (req: Request) => {
-    const { email, password, name } = await req.json()
-    if (!String(email ?? '').includes('@')) return Response.json({ ok: false, error: '邮箱格式无效' })
-    if (String(password ?? '').length < 6) return Response.json({ ok: false, error: '密码至少 6 位' })
-    const rows = await sql`INSERT INTO auth_users (email, password, name) VALUES (${String(email)}, ${String(password)}, ${String(name ?? email.split('@')[0])}) RETURNING id, email, name`
-    const user = rows[0]
-    const token = `tok_${++seq}_${user.id}`
-    sessions.set(token, String(user.id))
-    return Response.json({ ok: true, user, token }, { status: 201 })
-  })
-
-  app.post('/api/auth/login', async (req: Request) => {
-    const { email, password } = await req.json()
-    const rows = await sql`SELECT * FROM auth_users WHERE email = ${String(email)} AND password = ${String(password)}`
-    if (!rows.length) return Response.json({ ok: false, error: '邮箱或密码错误' }, { status: 401 })
-    const user = rows[0]
-    const token = `tok_${++seq}_${user.id}`
-    sessions.set(token, String(user.id))
-    return Response.json({ ok: true, user, token })
-  })
-
-  app.get('/api/auth/me', async (req: Request) => {
-    const auth = req.headers.get('authorization') ?? ''
-    const token = auth.replace('Bearer ', '')
-    const userId = sessions.get(token)
-    if (!userId) return Response.json({ ok: false }, { status: 401 })
-    const rows = await sql`SELECT id, email, name FROM auth_users WHERE id = ${userId}`
-    if (!rows.length) return Response.json({ ok: false }, { status: 401 })
-    return Response.json({ ok: true, user: rows[0] })
-  })
-}
-
-/** 建表（独立/嵌入共用） */
-export async function ensureAuthTables(sql: any): Promise<void> {
-  await sql.unsafe('CREATE TABLE IF NOT EXISTS auth_users (id serial PRIMARY KEY, email text UNIQUE, password text, name text)')
-}