weifuwu 0.90.0 → 0.90.1

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';