weifuwu 0.90.0 → 0.91.0

package/README.md

@@ -92,12 +92,13 @@ router.get('*', async (req, ctx) => {
 | 导入路径 | 模块 | 用途 |
 | --- | --- | --- |
 | `weifuwu` | Router / serve / cors / serveStatic | Trie 路由 + 中间件链 + HTTP 服务器 + 静态服务 |
-| `weifuwu` | postgres / redis / Memory | 自研 PG v3 + RESP2 协议（`ctx.sql` / `ctx.redis`）；Memory 零数据库测试 |
+| `weifuwu` | postgres / redis / Memory | 自研 PG v3 + RESP2 协议（`ctx.orm` / `ctx.redis`——数据面 = 声明式 ORM AST，业务零 SQL 文本）；Memory 零数据库测试 |
+| `weifuwu` | shape / bodyOf / listQuery / errorResponse | 数据样板收口：shape 声明 → `bodyOf`（body 校验·类型精确）/ `listQuery`（URL 参数）/ `errorResponse`（catch 映射）——手写 route 三件套（docs/server.md §5.3/§5.4.1） |
 | `weifuwu` | ui | SSR 渲染 + esbuild JS/CSS 动态编译（`ctx.ui`） |
 | `weifuwu/vdom` | UIRouter / uiServe / uiSsr | 前端路由唯一入口 + 浏览器 boot + SSR（结构吸收） |
 | `weifuwu/vdom` | 命令流引擎 + hooks 全家 | 渲染周期/事件代理/三状态机 + useAsyncData/usePopup/useControlled/… |
 | `weifuwu/components` | **134 个组件** | Button/Table/Modal/AiChat/… + `toast()`/`confirm()` 命令式中间件 |
-| `weifuwu/layout` | CSS 布局 | 49 个布局原语 + 92 个工具类 + 183 个主题 Token |
+| `weifuwu/layout` | CSS 布局 | 50 个布局原语 + 97 个工具类 + 183 个主题 Token |
 | `weifuwu` | rateLimit / email / userSystem / messager / queue / scheduler / ai / graphql | SaaS 地基中间件（ctx 注入） |
 | `weifuwu/dev` | dev loader | `--import weifuwu/dev` 直接跑 `.ts/.tsx` |
 
@@ -111,6 +112,7 @@ router.get('*', async (req, ctx) => {
 | 弹窗（toast/confirm/自定义） | `toast()` / `confirm()` / `ui.openPopup(opts)`→PopupHandle |
 | AI 对话（流式/工具/审批） | `ctx.ai.chat()` + `useChat` + `AiChat` 组件（`wf:` 协议） |
 | 认证（登录/角色/租户） | `userSystem()` + `ctx.auth` + `AuthPage` 组件 |
+| 数据层（shape→表/查询/写） | `bodyOf(req, T.agents, ...)` 校验 · `listQuery(url, T.x)` 分页参数 · `orm.gql/rest` 协议生成 · `pg.checkConsistency()` 启动诊断 |
 | 限流 / 邮件 / 消息 / 队列 / 定时 | `rateLimit()` / `email()` / `messager()` / `queue()` / `scheduler()` |
 
 ## 测试命令

package/dist/client/components/WordCloud/WordCloud.d.ts

@@ -0,0 +1,79 @@
+/**
+ * weifuwu/components — WordCloud
+ *
+ * 词云——权重→字号映射 · **中心同心环发散布局**（SVG textLength 定宽——
+ * 渲染宽度精确 = 估算宽——同输入同输出——SSR≡SPA 零差异 + 词矩形零重叠）
+ * 零依赖自绘 SVG（Chart 同族）。canvas 测宽/Canvas 绘制判负（服务端无 canvas——
+ * 见 git log plan/2026-09-wordcloud-组件.md 判负记录——中心排列消费证据推翻
+ * 行式装箱——同心环以 SVG 确定性实现：碰撞=矩形相交（纯函数））。
+ *
+ * 布局契约（纯函数——确定性——测试可断言）：
+ * - 权重线性映射 [minFontSize, maxFontSize]（全等权重 → 全 maxFontSize）
+ * - 降序放置——最大词从中心（环 0）开始——**同心环扫描**：环宽 = 当前词高
+ *   （邻环相接不重叠——环形约束）——环内候选点间距 = max(词宽, 环宽)（奇数环
+ *   错相偏 π/n——无隙漏）——首个无碰撞点放置
+ * - viewBox = 全部词包围盒（自适应——零裁剪——height 为显示高）
+ * - 词矩形（含 padding 间距）两两不相交（环碰撞保证 + textLength 强制实际宽）
+ */
+import type { Component } from '../../vdom/index.ts';
+export interface WordCloudData {
+    /** 词文本 */
+    word: string;
+    /** 权重（≥0——0 不渲染） */
+    weight: number;
+    /** 覆盖色板（不传按 colors 取模） */
+    color?: string;
+}
+export interface WordCloudProps {
+    words: WordCloudData[];
+    /** 显示高度（px——SVG 等比缩放——默认=布局包围盒高） */
+    height?: number;
+    /** 最大字号（px）——默认 32 */
+    maxFontSize?: number;
+    /** 最小字号（px）——默认 12 */
+    minFontSize?: number;
+    /** 词四周间距（px）——默认 4 */
+    padding?: number;
+    /** 色板（默认 token 色阶——逐词取模） */
+    colors?: string[];
+    /** 点击词回调（提供后词可交互：hover 高亮 + 键盘 Enter/Space 可达） */
+    onWordClick?: (word: string, weight: number) => void;
+    className?: string;
+}
+/** 估算词渲染宽（textLength 将强制实际=此值） */
+export declare function estimateWordWidth(word: string, size: number): number;
+export interface PlacedWord {
+    word: string;
+    weight: number;
+    /** 中心 x（text-anchor: middle） */
+    x: number;
+    /** 基线 y */
+    y: number;
+    size: number;
+    /** textLength（= 实际渲染字宽——不含 padding） */
+    textLength: number;
+    /** 词级颜色（WordCloudData.color——透传——未传由色板兜底） */
+    color?: string;
+    /** 布局矩形（含 padding——零重叠断言单位） */
+    rect: {
+        l: number;
+        t: number;
+        r: number;
+        b: number;
+    };
+}
+/** 布局输出（viewBox = 包围盒——由内容决定——零裁剪） */
+export interface WordCloudLayout {
+    placed: PlacedWord[];
+    /** 布局坐标系宽（= 包围盒宽） */
+    width: number;
+    /** 布局坐标系高（= 包围盒高） */
+    height: number;
+}
+/** 中心同心环布局（纯函数——确定性——同输入同输出——零重叠） */
+export declare function layoutWords(words: WordCloudData[], opts: {
+    maxFontSize: number;
+    minFontSize: number;
+    padding: number;
+}): WordCloudLayout;
+export declare const WordCloud: Component<WordCloudProps>;

package/dist/client/components/index.d.ts

@@ -285,3 +285,5 @@ export { VideoPlayer } from './VideoPlayer/VideoPlayer.ts';
 export type { VideoPlayerProps } from './VideoPlayer/VideoPlayer.ts';
 export { Math } from './Math/Math.ts';
 export type { MathProps } from './Math/Math.ts';
+export { WordCloud } from './WordCloud/WordCloud.ts';
+export type { WordCloudProps, WordCloudData } from './WordCloud/WordCloud.ts';