weifuwu 0.65.1 → 0.67.0

package/dist/components/LogViewer/LogViewer.d.ts

@@ -0,0 +1,29 @@
+/**
+ * weifuwu/components — LogViewer
+ *
+ * 日志流查看器（Agent 执行日志 / CI 输出）：ANSI 着色 + 虚拟滚动 + 自动跟随。
+ * 复用 VirtualList 滚动基座（useScrollPosition + rAF 节流）。
+ * 裁剪：正则高亮、多日志源合并、搜索定位。
+ */
+import type { Component } from '../../client/vnode.ts';
+export interface LogViewerProps {
+    lines: string[];
+    /** 视口高度（px），默认 400 */
+    height?: number;
+    /** 行高（px），默认 24 */
+    lineHeight?: number;
+    /** 可见区外额外渲染行数 */
+    overscan?: number;
+    /** 自动跟随：新行到达时若已在底部则滚到底（默认 true） */
+    follow?: boolean;
+    /** 只显示尾部 N 行（内存保护，默认不限） */
+    maxLines?: number;
+    /** 显示复制按钮（默认 true） */
+    showCopy?: boolean;
+    /** 显示行号（默认 true） */
+    showLineNumbers?: boolean;
+    className?: string;
+}
+/** ANSI 转义解析（16 色 + 粗体 + 背景 8 色）：累积样式到 reset 为止，零依赖 */
+export declare function parseAnsi(text: string): any[];
+export declare const LogViewer: Component<LogViewerProps>;

package/dist/components/Menu/Menu.d.ts

@@ -1,9 +1,9 @@
 /**
  * weifuwu/components — Menu
  *
- * 导航菜单（侧栏导航）：分组项 + 图标 + 选中态 + 方向键导航 + Enter 激活。
+ * 导航菜单（侧栏导航）：分组项 + 图标 + 选中态 + 方向键导航 + Enter 激活 + 子菜单 + 折叠。
  * 用于 SaaS 应用侧边导航（替代手写 nav-item 循环）。
- * 裁剪：不做子菜单展开/水平菜单栏（见 roadmap）。
+ * 裁剪：水平菜单栏（Menubar）、折叠时子菜单浮层（popup，见 roadmap）、子菜单自动互斥。
  */
 import type { Component } from '../../client/vnode.ts';
 export interface MenuItem {
@@ -15,11 +15,20 @@ export interface MenuItem {
     active?: boolean;
     danger?: boolean;
     onClick?: () => void;
+    /** 子菜单项（有 children 即渲染为可展开子菜单） */
+    children?: MenuItem[];
 }
 export interface MenuProps {
     items: MenuItem[];
     onSelect?: (key: string) => void;
     activeKey?: string;
     className?: string;
+    /** 受控展开 key 列表（子菜单） */
+    openKeys?: string[];
+    onOpenChange?: (keys: string[]) => void;
+    /** 可折叠侧栏（宽度收窄 + label 隐藏） */
+    collapsible?: boolean;
+    collapsed?: boolean;
+    onCollapseChange?: (collapsed: boolean) => void;
 }
 export declare const Menu: Component<MenuProps>;

package/dist/components/Pipeline/Pipeline.d.ts

@@ -0,0 +1,27 @@
+import type { Component } from '../../client/vnode.ts';
+export type NodeStatus = 'default' | 'success' | 'running' | 'error' | 'pending';
+export interface PipelineNode {
+    id: string;
+    label: string;
+    /** 状态着色（默认 default） */
+    status?: NodeStatus;
+}
+export interface PipelineEdge {
+    from: string;
+    to: string;
+}
+export interface PipelineProps {
+    nodes: PipelineNode[];
+    edges: PipelineEdge[];
+    /** 布局方向（默认 vertical：输入在左→输出在右） */
+    orientation?: 'vertical' | 'horizontal';
+    width?: number;
+    height?: number;
+    className?: string;
+}
+/**
+ * Pipeline/DAG — Agent 多步工作流可视化。
+ * 分层布局（Kahn 拓扑最长路径）+ SVG 贝塞尔连线 + 状态语义色。
+ * 纯函数布局（dag-utils）可 SSR/单测；环检测 → 渲染警告不崩溃。
+ */
+export declare const Pipeline: Component<PipelineProps>;

package/dist/components/Pipeline/dag-utils.d.ts

@@ -0,0 +1,36 @@
+export interface DagNodeInput {
+    id: string;
+}
+export interface DagEdgeInput {
+    from: string;
+    to: string;
+}
+export interface LayoutNode {
+    id: string;
+    x: number;
+    y: number;
+}
+export interface LayoutEdge {
+    from: string;
+    to: string;
+    d: string;
+}
+/**
+ * 分层：每个节点层 = 最长入链深度（BFS/DP）。
+ * 无入边节点 → 0；菱形依赖取最长路径。
+ */
+export declare function computeLayers(nodes: DagNodeInput[], edges: DagEdgeInput[]): Map<string, number>;
+/** 环检测：Kahn 拓扑——有环时访问节点数 < 总节点数 */
+export declare function detectCycle(nodes: DagNodeInput[], edges: DagEdgeInput[]): boolean;
+export interface GraphLayoutOptions {
+    orientation: 'vertical' | 'horizontal';
+    width: number;
+    height: number;
+    nodeW?: number;
+    nodeH?: number;
+}
+/** 布局：分层 → 层列分布 + 层内均匀；边 = 贝塞尔 path */
+export declare function layoutGraph(nodes: DagNodeInput[], edges: DagEdgeInput[], opts: GraphLayoutOptions): {
+    nodes: LayoutNode[];
+    edges: LayoutEdge[];
+};

package/dist/components/Sparkline/Sparkline.d.ts

@@ -0,0 +1,21 @@
+import type { Component } from '../../client/vnode.ts';
+export interface SparklineProps {
+    /** 数据序列 */
+    data: number[];
+    /** SVG 宽（默认 120） */
+    width?: number;
+    /** SVG 高（默认 32） */
+    height?: number;
+    /** 描边色（默认语义 primary，随 currentColor 可继承） */
+    stroke?: string;
+    /** 面积填充（默认关） */
+    fill?: boolean;
+    /** 平滑曲线（Catmull-Rom）——默认折线 */
+    smooth?: boolean;
+    className?: string;
+}
+/**
+ * Sparkline — 迷你趋势线（SVG 自绘，零依赖）。
+ * 归一化到 viewBox，等值/单点/空数据安全。
+ */
+export declare const Sparkline: Component<SparklineProps>;

package/dist/components/Sparkline/sparkline-utils.d.ts

@@ -0,0 +1,16 @@
+export interface SparklinePoint {
+    x: number;
+    y: number;
+}
+/**
+ * 将数据点归一化到 [padding, width-padding] × [padding, height-padding]。
+ * - min → 底部（y=height-padding），max → 顶部（y=padding）
+ * - 单点：居中（x 中点，y 垂直居中）
+ * - 等值：全部垂直居中（除零防护）
+ * - 空：空数组
+ */
+export declare function computeSparklinePoints(data: number[], width: number, height: number, padding?: number): SparklinePoint[];
+/** 折线 points 字符串 */
+export declare function polylinePoints(pts: SparklinePoint[]): string;
+/** 平滑 path（Catmull-Rom → cubic Bézier）——描边 + 可选面积 */
+export declare function smoothPath(pts: SparklinePoint[]): string;

package/dist/components/Tour/Tour.d.ts

@@ -0,0 +1,34 @@
+import type { Component } from '../../client/vnode.ts';
+export type TourPlacement = 'top' | 'bottom' | 'left' | 'right';
+export interface TourStep {
+    /** 目标元素选择器（ctx.browser.query） */
+    target: string;
+    title: string;
+    content: string;
+    /** 气泡相对目标的位置（默认 bottom） */
+    placement?: TourPlacement;
+}
+export interface TourProps {
+    steps: TourStep[];
+    /** 受控：是否打开 */
+    open?: boolean;
+    /** 受控回调（关闭时 onChange(false)） */
+    onChange?: (open: boolean) => void;
+    /** 受控：当前步骤索引 */
+    current?: number;
+    /** 步骤变化回调 */
+    onStepChange?: (step: number) => void;
+    /** 完成/跳过回调 */
+    onFinish?: () => void;
+    /** 遮罩（默认 true） */
+    mask?: boolean;
+}
+/**
+ * Tour — 新手引导（步骤式）。
+ * 目标 rect 定位（usePopupPosition 跟随 scroll/resize）+ Portal 遮罩 + 步骤气泡。
+ *
+ * 状态纪律：
+ * - 步骤索引闭包 let + render()（手动模式——避免 $ 内置类型问题）
+ * - open 受控（props.open + onChange）
+ */
+export declare const Tour: Component<TourProps>;

package/dist/components/Tree/Tree.d.ts

@@ -16,6 +16,8 @@ export interface TreeProps {
     onExpand?: (keys: string[]) => void;
     /** 勾选模式（父子联动，antd 非 strict 语义） */
     checkable?: boolean;
+    /** 点击有子节点的行 = 展开/折叠（不触发选中）——TreeSelect 场景（点行展开比点箭头直观） */
+    expandOnClick?: boolean;
     checkedKeys?: string[];
     onCheck?: (keys: string[]) => void;
     className?: string;

package/dist/components/TreeSelect/TreeSelect.d.ts

@@ -0,0 +1,24 @@
+import type { Component } from '../../client/vnode.ts';
+import type { TreeNode } from '../Tree/Tree.ts';
+export interface TreeSelectProps {
+    /** 树选项（复用 TreeNode 结构） */
+    options: TreeNode[];
+    /** 受控：单选 string / 多选 string[] */
+    value?: string | string[];
+    /** 受控回调：单选 key / 多选 keys[] */
+    onChange?: (value: any) => void;
+    /** 多选（checkable 父子联动语义） */
+    multiple?: boolean;
+    placeholder?: string;
+    className?: string;
+}
+/** 在树中按 key 找 label（选中显示用） */
+export declare function findLabel(nodes: TreeNode[], key: string): string | undefined;
+/**
+ * TreeSelect — 树形选择（Tree + 下拉组合）。
+ * 下拉经 createPortal + position:fixed（usePopupPosition 定位/跟随/夹紧）——
+ * 与 DatePicker 同模式：父容器 overflow/transform 不影响弹出层。
+ * 单选 selectedKeys / 多选 checkable checkedKeys（父子联动）。
+ * 受控纪律：value 受控无 onChange → warn。
+ */
+export declare const TreeSelect: Component<TreeSelectProps>;

package/dist/components/VirtualTable/VirtualTable.d.ts

@@ -0,0 +1,32 @@
+/**
+ * weifuwu/components — VirtualTable
+ *
+ * 虚拟表格（数据密集场景）：固定表头 + 虚拟滚动表体，10k+ 行只渲染可见窗口。
+ * 复用 VirtualList 滚动基座（useScrollPosition 像素级 scrollTop + rAF 节流）。
+ * 排序：受控 sortKey/sortOrder + onSort（与 Table 同款模式）。
+ * 裁剪：行选择（rowSelection）、列虚拟化（横向）、行编辑、单元格合并、树形表格。
+ */
+import type { Component } from '../../client/vnode.ts';
+import type { TableColumn } from '../Table/Table.ts';
+export interface VirtualTableProps {
+    columns: TableColumn[];
+    data?: any[];
+    /** 视口高度（px），默认 400 */
+    height?: number;
+    /** 行高（px），默认 40 */
+    rowHeight?: number;
+    /** 可见区外额外渲染行数 */
+    overscan?: number;
+    /** 当前排序列 key */
+    sortKey?: string;
+    /** 当前排序方向 */
+    sortOrder?: 'asc' | 'desc';
+    /** 排序变化回调 */
+    onSort?: (key: string, order: 'asc' | 'desc') => void;
+    /** 数据为空时显示的文本 */
+    emptyText?: string;
+    /** 行点击 */
+    onRowClick?: (row: any, index: number) => void;
+    className?: string;
+}
+export declare const VirtualTable: Component<VirtualTableProps>;

package/dist/components/index.d.ts

@@ -183,7 +183,23 @@ export { InfiniteScroll } from './InfiniteScroll/InfiniteScroll.ts';
 export type { InfiniteScrollProps } from './InfiniteScroll/InfiniteScroll.ts';
 export { VirtualList } from './VirtualList/VirtualList.ts';
 export type { VirtualListProps } from './VirtualList/VirtualList.ts';
+export { VirtualTable } from './VirtualTable/VirtualTable.ts';
+export type { VirtualTableProps } from './VirtualTable/VirtualTable.ts';
+export { Anchor } from './Anchor/Anchor.ts';
+export type { AnchorProps, AnchorItem } from './Anchor/Anchor.ts';
+export { LogViewer, parseAnsi } from './LogViewer/LogViewer.ts';
+export type { LogViewerProps } from './LogViewer/LogViewer.ts';
+export { JSONViewer } from './JSONViewer/JSONViewer.ts';
+export type { JSONViewerProps } from './JSONViewer/JSONViewer.ts';
 export { QRCode } from './QRCode/QRCode.ts';
 export type { QRCodeProps } from './QRCode/QRCode.ts';
 export { generateQr } from './QRCode/qr.ts';
 export type { QrMatrix, QrEcLevel } from './QRCode/qr.ts';
+export { DiffView } from './DiffView/DiffView.ts';
+export { Sparkline } from './Sparkline/Sparkline.ts';
+export { Tour } from './Tour/Tour.ts';
+export { Kanban } from './Kanban/Kanban.ts';
+export { Pipeline } from './Pipeline/Pipeline.ts';
+export { layoutGraph, computeLayers, detectCycle } from './Pipeline/dag-utils.ts';
+export { TreeSelect } from './TreeSelect/TreeSelect.ts';
+export { findLabel } from './TreeSelect/TreeSelect.ts';