weifuwu 0.61.2 → 0.63.0

package/dist/client/types.d.ts

@@ -14,6 +14,10 @@ export interface PopupPositionOptions {
         left: number;
         width?: number;
     };
+    /** 弹层面板元素 getter（可选）：提供后坐标自动夹紧到视口内（防超高/超宽时底部按钮不可点） */
+    panel?: () => HTMLElement | null;
+    /** 视口边缘安全边距（px，默认 8） */
+    margin?: number;
 }
 /** 异步取数工具返回值 — ctx.ui.useAsync()（data/loading/error 响应式，reload 重跑） */
 export interface UseAsyncHandle<T = any> {
@@ -30,6 +34,42 @@ export interface PopupPosition {
     /** 立即重算一次坐标（不触发渲染，调用方负责 render） */
     refresh: () => void;
 }
+/** 可见性观察配置 — 供 ctx.ui.useInView 使用（IntersectionObserver 封装，替代 scroll 监听） */
+export interface UseInViewOptions {
+    /** IO 根元素 getter（默认视口；滚动容器场景传 target） */
+    root?: () => Element | null;
+    /** IO rootMargin（支持函数——动态读最新 props，observe 时求值） */
+    rootMargin?: string | (() => string);
+    /** IO threshold（默认 0；支持函数——动态读最新 props） */
+    threshold?: number | number[] | (() => number | number[]);
+    /** IO 触发回调（entry.boundingClientRect 读取安全，非 scroll handler） */
+    onChange?: (entry: IntersectionObserverEntry, isIn: boolean) => void;
+}
+/** 可见性观察器 — useInView 的返回值 */
+export interface UseInViewHandle {
+    /** 是否在可见区（响应式：变化自动 dirty 当前组件） */
+    isIn: boolean;
+    /** 是否已就绪（首次 IO 回调完成；未就绪时 isIn 为初始 false，组件应保守处理） */
+    ready: boolean;
+    /** 观察元素（ref 挂载时调用；传 null 断开） */
+    observe(el: HTMLElement | null): void;
+    /** 重建观察（rootMargin 等配置变化后调用） */
+    refresh(): void;
+    /** 手动断开观察 */
+    disconnect(): void;
+}
+/** 滚动位置跟踪配置 — 供 ctx.ui.useScrollPosition 使用 */
+export interface UseScrollPositionOptions {
+    /** 滚动容器 getter（默认 window；内部滚动容器传 ref 元素） */
+    getScroller?: () => HTMLElement | Window;
+}
+/** 滚动位置跟踪器 — useScrollPosition 的返回值（y 响应式，变化自动 dirty 当前组件） */
+export interface UseScrollPositionHandle {
+    /** 滚动位置（px，scrollY/scrollTop） */
+    y: number;
+    /** 手动重读一次滚动位置（不触发渲染） */
+    refresh(): void;
+}
 /** 应用上下文 */
 export interface WfuiContext {
     [key: string]: unknown;
@@ -57,6 +97,29 @@ export interface WfuiContext {
         useBreakpoint: (bpsOrCallback: Record<string, string> | ((vp: string) => void), callback?: (vp: string) => void) => void;
         /** 弹层位置跟踪：滚动/resize 时自动重算 fixed 坐标 */
         usePopupPosition: (options: PopupPositionOptions) => PopupPosition;
+        /**
+         * 可见性观察（IntersectionObserver 封装）：替代组件自建 scroll 监听。
+         * IO 在合成器线程评估，滚动/尺寸变化自动触发，无 scroll-linked 定位警告。
+         *
+         * ```tsx
+         * const inView = ctx.ui.useInView({
+         *   rootMargin: () => `-${propsRef.offsetTop ?? 0}px 0px 0px 0px`,
+         * })
+         * const ref = (el) => inView.observe(el)
+         * return () => h('div', { ref }, fixed = !inView.isIn ...)
+         * ```
+         */
+        useInView: (options: UseInViewOptions) => UseInViewHandle;
+        /**
+         * 滚动位置跟踪（全局 scroll 监听 + rAF 节流，仿 usePopupPosition）：
+         * 返回响应式 scrollY/scrollTop，变化自动 dirty 当前组件。替代组件自建 scroll 监听。
+         *
+         * ```tsx
+         * const scroll = ctx.ui.useScrollPosition({ getScroller: () => wrapEl })
+         * return () => h('div', { ref }, fixed = scroll.y >= threshold)
+         * ```
+         */
+        useScrollPosition: (options: UseScrollPositionOptions) => UseScrollPositionHandle;
         /**
          * 异步取数工具（mount 阶段调用）：loading/error 自动管理 + 数据就绪自动渲染。
          *

package/dist/client/ui.d.ts

@@ -46,6 +46,12 @@ export interface UiDeps {
             width?: number;
         };
     }>;
+    scrollTrackers: Map<string, {
+        handle: {
+            y: number;
+        };
+        getScroller: () => HTMLElement | Window;
+    }>;
     schedulePopupRecompute: () => void;
     /** 惰性挂载全局 scroll/resize 监听（幂等） */
     ensurePopupListeners: () => void;

package/dist/components/Accordion/Accordion.d.ts

@@ -3,9 +3,18 @@ export interface AccordionItem {
     key: string;
     title: string;
     content?: any;
+    disabled?: boolean;
 }
 export interface AccordionProps {
     items?: AccordionItem[];
+    /** 受控展开 keys */
+    active?: string[];
+    onChange?: (keys: string[]) => void;
+    /** true = 多开；默认 false 手风琴互斥（antd 对齐） */
     multiple?: boolean;
 }
+/**
+ * 手风琴折叠面板（对应 antd/EP Collapse 卡片面板语义）：受控 active + 点击切换 +
+ * 方向键移动焦点 + aria-expanded 同步。与 Collapse 边界：Accordion = 整块卡片面板容器。
+ */
 export declare const Accordion: Component<AccordionProps>;

package/dist/components/Affix/Affix.d.ts

@@ -0,0 +1,16 @@
+import type { Component } from '../../client/vnode.ts';
+export interface AffixProps {
+    /** 距视口顶部偏移，滚动超过该值后固定（px），默认 0 */
+    offsetTop?: number;
+    /** 滚动容器（默认 window） */
+    target?: () => HTMLElement | Window;
+    children?: any;
+    className?: string;
+    [key: string]: any;
+}
+/** 固定定位（对应 antd/EP Affix）：滚动超过阈值后固定元素，保持占位与宽度
+ * 实现：ctx.ui.useScrollPosition（全局 scroll 监听 + rAF 节流，内置方案）——
+ * mount 时算一次阈值（sentinel 文档位置 - offsetTop），滚动位置响应式驱动 fixed 判定。
+ * 不用 IO：IO 只在交叉状态变化时回调，瞬间滚动后 sentinel 从视口外下方到视口外上方
+ * isIntersecting 都是 false → 不回调（Affix 需要连续位置跟踪，IO 语义不匹配）。 */
+export declare const Affix: Component<AffixProps>;

package/dist/components/AspectRatio/AspectRatio.d.ts

@@ -0,0 +1,10 @@
+import type { Component } from '../../client/vnode.ts';
+export interface AspectRatioProps {
+    /** 宽/高比，默认 16/9 */
+    ratio?: number;
+    children?: any;
+    className?: string;
+    [key: string]: any;
+}
+/** 宽高比容器（对应 shadcn AspectRatio）：内容绝对定位填满，适合图片/视频/嵌入内容 */
+export declare const AspectRatio: Component<AspectRatioProps>;

package/dist/components/AvatarGroup/AvatarGroup.d.ts

@@ -0,0 +1,21 @@
+/**
+ * weifuwu/components — AvatarGroup
+ *
+ * 堆叠头像组（负 margin 重叠）+ max 溢出显示 +N。
+ * 用于群聊成员、协作人列表。
+ * 裁剪：不做 hover 展开 tooltip（见 roadmap）。
+ */
+import type { Component } from '../../client/vnode.ts';
+import { type AvatarProps } from '../Avatar/Avatar.ts';
+export interface AvatarGroupItem {
+    name?: string;
+    src?: string;
+    color?: string;
+}
+export interface AvatarGroupProps {
+    items: AvatarGroupItem[];
+    max?: number;
+    size?: AvatarProps['size'];
+    className?: string;
+}
+export declare const AvatarGroup: Component<AvatarGroupProps>;

package/dist/components/BackTop/BackTop.d.ts

@@ -0,0 +1,16 @@
+import type { Component } from '../../client/vnode.ts';
+export interface BackTopProps {
+    /** 滚动超过此高度显示（px），默认 400 */
+    visibilityHeight?: number;
+    /** 滚动容器（默认 window） */
+    target?: () => HTMLElement | Window;
+    /** 平滑滚动，默认 true */
+    smooth?: boolean;
+    'aria-label'?: string;
+    children?: any;
+    className?: string;
+}
+/** 回到顶部（对应 EP Backtop / antd FloatButton.BackTop）：滚动超阈值显示，点击回顶
+ * 实现：ctx.ui.useInView（IO 封装）观察文档顶部哨兵——rootMargin 顶部向外扩展
+ * visibilityHeight，哨兵离开扩展区（= 滚动超阈值）→ 显示。无 scroll 监听、无警告。 */
+export declare const BackTop: Component<BackTopProps>;

package/dist/components/Calendar/Calendar.d.ts

@@ -0,0 +1,21 @@
+import type { Component } from '../../client/vnode.ts';
+export interface CalendarEvent {
+    key: string;
+    /** 日期 'YYYY-MM-DD' */
+    date: string;
+    title: string;
+    color?: string;
+}
+export interface CalendarProps {
+    events?: CalendarEvent[];
+    /** 受控年月：month 0-11，year 四位数 */
+    month?: number;
+    year?: number;
+    onMonthChange?: (month: number, year: number) => void;
+    onSelectDate?: (date: string) => void;
+    selectedDate?: string;
+    'aria-label'?: string;
+}
+/** 月历（对应 antd/EP Calendar）：月视图网格 + 事件点 + 月切换 + 日期选择。
+ * 裁剪：周/日视图、拖拽创建事件、事件详情弹层。 */
+export declare const Calendar: Component<CalendarProps>;

package/dist/components/Carousel/Carousel.d.ts

@@ -0,0 +1,17 @@
+import type { Component } from '../../client/vnode.ts';
+export interface CarouselProps {
+    children: any[];
+    /** 自动播放 */
+    autoplay?: boolean;
+    /** 自动播放间隔（ms），默认 3000 */
+    interval?: number;
+    showArrows?: boolean;
+    showDots?: boolean;
+    /** 循环播放（尾 → 头），默认 true */
+    loop?: boolean;
+    'aria-label'?: string;
+    className?: string;
+}
+/** 轮播（对应 antd/EP/shadcn Carousel）：横向滑动 + 箭头/圆点 + 自动播放 + 触摸滑动。
+ * 裁剪：垂直模式、多图联动、淡入淡出（fade 用 CSS 可配）。 */
+export declare const Carousel: Component<CarouselProps>;

package/dist/components/Cascader/Cascader.d.ts

@@ -0,0 +1,21 @@
+import type { Component } from '../../client/vnode.ts';
+export interface CascaderOption {
+    value: string;
+    label: string;
+    children?: CascaderOption[];
+    disabled?: boolean;
+}
+export interface CascaderProps {
+    options?: CascaderOption[];
+    /** 选中路径（数组，如 ['zj','hz','xh']） */
+    value?: string[];
+    onChange?: (value: string[]) => void;
+    placeholder?: string;
+    disabled?: boolean;
+    error?: string;
+    label?: string;
+    'aria-label'?: string;
+}
+/** 级联选择（对应 antd/EP Cascader）：多列面板逐级选择，点击叶子完成。
+ * 裁剪：hover 展开、搜索、任意层级配置、异步加载。 */
+export declare const Cascader: Component<CascaderProps>;

package/dist/components/CheckboxGroup/CheckboxGroup.d.ts

@@ -0,0 +1,23 @@
+import type { Component } from '../../client/vnode.ts';
+export interface CheckboxGroupOption {
+    value: string;
+    label: string;
+    desc?: string;
+    disabled?: boolean;
+}
+export interface CheckboxGroupProps {
+    options?: CheckboxGroupOption[];
+    /** 受控选中值 */
+    value?: string[];
+    onChange?: (value: string[]) => void;
+    /** 栅格列数（1-4） */
+    columns?: 1 | 2 | 3 | 4;
+    size?: 'sm' | 'md' | 'lg';
+    disabled?: boolean;
+    /** 组标题（可选） */
+    label?: string;
+    'aria-label'?: string;
+    className?: string;
+}
+/** 复选框组/多选列表（对应 antd Checkbox.Group）：成员选择、多值字段 */
+export declare const CheckboxGroup: Component<CheckboxGroupProps>;

package/dist/components/CodeBlock/CodeBlock.d.ts

@@ -0,0 +1,14 @@
+/**
+ * weifuwu/components — CodeBlock
+ *
+ * 代码展示块：语言标签 + 复制按钮 + 横向滚动。
+ * 由 Markdown 代码围栏复用；也可独立使用。
+ * 裁剪：不做语法高亮（零依赖，语言标签仅展示）。
+ */
+import type { Component } from '../../client/vnode.ts';
+export interface CodeBlockProps {
+    code: string;
+    lang?: string;
+    title?: string;
+}
+export declare const CodeBlock: Component<CodeBlockProps>;

package/dist/components/Collapse/Collapse.d.ts

@@ -0,0 +1,28 @@
+import type { Component } from '../../client/vnode.ts';
+export interface CollapseItem {
+    key: string;
+    title: string;
+    /** 标题图标 */
+    icon?: any;
+    /** 标题右侧操作区 */
+    extra?: any;
+    /** 展开内容（惰性渲染：未展开不渲染） */
+    content?: any;
+    /** 异步加载态：展开时显示 loading 指示 */
+    loading?: boolean;
+}
+export interface CollapseProps {
+    items?: CollapseItem[];
+    /** 受控展开 keys */
+    active?: string[];
+    onChange?: (keys: string[]) => void;
+    /** false = 手风琴互斥（同一时间只开一个）；默认 true 多开 */
+    multiple?: boolean;
+    className?: string;
+}
+/**
+ * 行内折叠面板（对应 antd/EP Collapse + shadcn Collapsible）：
+ * 标题行 + 行内展开区（无卡片边框，适配列表行内展开），支持异步 loading。
+ * 与 Accordion 边界：Accordion = 整块卡片面板；Collapse = 行内展开。
+ */
+export declare const Collapse: Component<CollapseProps>;

package/dist/components/ColorPicker/ColorPicker.d.ts

@@ -0,0 +1,16 @@
+import type { Component } from '../../client/vnode.ts';
+export interface ColorPickerProps {
+    /** 受控颜色值（hex，如 #4f6ef7） */
+    value?: string;
+    onChange?: (value: string) => void;
+    /** 预设色板（默认内置 10 色） */
+    colors?: string[];
+    size?: 'sm' | 'md' | 'lg';
+    disabled?: boolean;
+    /** 显示 hex 输入框（自由输入） */
+    showInput?: boolean;
+    'aria-label'?: string;
+}
+/** 颜色选择（对应 antd/EP ColorPicker 预设版）：触发按钮 + 色板弹层 + hex 输入。
+ * 裁剪：不做吸管/自由取色/透明度（预设色板 + hex 输入覆盖 90% 场景）。 */
+export declare const ColorPicker: Component<ColorPickerProps>;

package/dist/components/Command/Command.d.ts

@@ -0,0 +1,22 @@
+import type { Component } from '../../client/vnode.ts';
+export interface CommandItem {
+    key: string;
+    label: string;
+    icon?: any;
+    /** 显示快捷键（如 'G S'） */
+    shortcut?: string;
+    group?: string;
+    keywords?: string[];
+    onSelect?: () => void;
+}
+export interface CommandProps {
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    items?: CommandItem[];
+    placeholder?: string;
+    emptyText?: string;
+    /** 全局快捷键，如 'mod+k'（cmd/ctrl + k）；null 关闭全局监听 */
+    globalShortcut?: string | null;
+}
+/** 命令面板（对应 shadcn Command）：全屏 overlay + 搜索 + 键盘流（↑↓ Enter Escape）+ Cmd+K 全局快捷键 */
+export declare const Command: Component<CommandProps>;

package/dist/components/ContextMenu/ContextMenu.d.ts

@@ -0,0 +1,17 @@
+import type { Component } from '../../client/vnode.ts';
+export interface ContextMenuItem {
+    key: string;
+    label: string;
+    icon?: any;
+    variant?: 'default' | 'danger';
+    disabled?: boolean;
+    onClick?: () => void;
+}
+export interface ContextMenuProps {
+    items?: ContextMenuItem[];
+    children: any;
+    'aria-label'?: string;
+    className?: string;
+}
+/** 右键菜单（对应 shadcn ContextMenu）：右键在光标处弹出，点击外部/Escape 关闭，方向键导航 */
+export declare const ContextMenu: Component<ContextMenuProps>;

package/dist/components/CopyButton/CopyButton.d.ts

@@ -0,0 +1,18 @@
+import type { Component } from '../../client/vnode.ts';
+export interface CopyButtonProps {
+    /** 要复制的文本 */
+    value: string;
+    /** 按钮文字（默认仅图标） */
+    label?: string;
+    size?: 'sm' | 'md' | 'lg';
+    variant?: 'ghost' | 'secondary' | 'default';
+    /** 仅图标（无文字） */
+    iconOnly?: boolean;
+    /** 成功提示文字（默认「已复制」） */
+    successText?: string;
+    onCopied?: () => void;
+    className?: string;
+    [key: string]: any;
+}
+/** 复制按钮（weifuwu 独有，Chat 消息复制/CodeBlock 抽取统一） */
+export declare const CopyButton: Component<CopyButtonProps>;

package/dist/components/Descriptions/Descriptions.d.ts

@@ -0,0 +1,21 @@
+/**
+ * weifuwu/components — Descriptions
+ *
+ * 详情字段展示：label/value 栅格（<dl> 语义结构，屏幕阅读器友好）。
+ * 用于 Agent 配置展示、实体详情、订单信息等只读字段场景。
+ */
+import type { Component } from '../../client/vnode.ts';
+export interface DescriptionItem {
+    label: any;
+    value: any;
+    /** 跨列数（栅格列，默认 1） */
+    span?: number;
+}
+export interface DescriptionsProps {
+    items: DescriptionItem[];
+    column?: 1 | 2 | 3 | 4;
+    bordered?: boolean;
+    size?: 'sm' | 'md' | 'lg';
+    className?: string;
+}
+export declare const Descriptions: Component<DescriptionsProps>;

package/dist/components/Highlight/Highlight.d.ts

@@ -0,0 +1,13 @@
+/**
+ * weifuwu/components — Highlight
+ *
+ * 搜索词高亮：给定文本 + 高亮词数组 → 分词渲染 <mark>（零依赖，VNode 拼接）。
+ * 配合 SearchInput/Table 搜索结果命中展示。
+ */
+import type { Component } from '../../client/vnode.ts';
+export interface HighlightProps {
+    text: string;
+    query?: string | string[];
+    className?: string;
+}
+export declare const Highlight: Component<HighlightProps>;

package/dist/components/HoverCard/HoverCard.d.ts

@@ -0,0 +1,16 @@
+import type { Component } from '../../client/vnode.ts';
+import type { Placement } from '../../client/popup.ts';
+export type HoverCardPosition = Placement;
+export interface HoverCardProps {
+    /** 富内容（任意 VNode，区别于 Tooltip 的 string） */
+    content: any;
+    position?: HoverCardPosition;
+    children: any;
+    disabled?: boolean;
+    /** 悬停打开延迟（ms），默认 150 */
+    openDelay?: number;
+    /** 移出关闭延迟（ms），默认 0 */
+    closeDelay?: number;
+}
+/** 悬停富内容卡（对应 shadcn HoverCard）：hover 延迟显隐，支持任意 VNode 内容 */
+export declare const HoverCard: Component<HoverCardProps>;

package/dist/components/Icon/Icon.d.ts

@@ -9,7 +9,7 @@
  *   h(Icon, { name: 'check', size: 16 })
  */
 import type { Component } from '../../client/vnode.ts';
-export type IconName = 'chevron-down' | 'chevron-up' | 'chevron-left' | 'chevron-right' | 'arrow-left' | 'arrow-up' | 'arrow-down' | 'sort' | 'sort-asc' | 'sort-desc' | 'check' | 'close' | 'alert' | 'info' | 'warning' | 'pause' | 'settings' | 'search' | 'send' | 'stop' | 'retry' | 'upload' | 'trash' | 'edit' | 'plus';
+export type IconName = 'chevron-down' | 'chevron-up' | 'chevron-left' | 'chevron-right' | 'arrow-left' | 'arrow-up' | 'arrow-down' | 'arrow-right' | 'sort' | 'sort-asc' | 'sort-desc' | 'check' | 'close' | 'alert' | 'info' | 'warning' | 'pause' | 'settings' | 'search' | 'send' | 'stop' | 'retry' | 'upload' | 'trash' | 'edit' | 'plus' | 'copy' | 'eye' | 'eye-off' | 'star';
 export interface IconProps {
     name: IconName;
     /** 尺寸，默认 1em（随字号缩放） */

package/dist/components/Img/Img.d.ts

@@ -11,5 +11,9 @@ export interface ImgProps {
     height?: number | string;
     className?: string;
     style?: Record<string, string>;
+    /** 点击放大预览（对应 antd/EP Image preview） */
+    preview?: boolean;
+    /** 预览缩放倍率，默认 1 */
+    previewScale?: number;
 }
 export declare const Img: Component<ImgProps>;

package/dist/components/InView/InView.d.ts

@@ -1,8 +1,8 @@
 /**
  * weifuwu/components — InView
  *
- * 组件挂载后用 ctx.ui.onmounted 获取根元素，设置 IntersectionObserver。
  * 进入视窗后替换占位符为真实内容。
+ * 实现：ctx.ui.useInView（IO 封装）——滚动/尺寸变化由合成器线程评估，无 scroll 监听。
  */
 import type { Component } from '../../client/vnode.ts';
 export interface InViewProps {

package/dist/components/InfiniteScroll/InfiniteScroll.d.ts

@@ -0,0 +1,15 @@
+import type { Component } from '../../client/vnode.ts';
+export interface InfiniteScrollProps {
+    hasMore?: boolean;
+    loading?: boolean;
+    /** 触底加载回调（sentinel 进入视口触发） */
+    onLoadMore?: () => void;
+    /** 提前触发距离（px） */
+    threshold?: number;
+    children?: any;
+    loadMoreText?: string;
+    endText?: string;
+    className?: string;
+}
+/** 无限滚动（对应 EP InfiniteScroll）：底部哨兵进入视口 → 加载更多。 */
+export declare const InfiniteScroll: Component<InfiniteScrollProps>;

package/dist/components/InputNumber/InputNumber.d.ts

@@ -0,0 +1,25 @@
+/**
+ * weifuwu/components — InputNumber
+ *
+ * 数字输入：min/max/step + 增减按钮 + precision 格式化。
+ * 受控 value: number | null；空值 → null；输入 clamp 到 min/max。
+ * 裁剪：不做长按连增/千分位货币（见 roadmap）。
+ */
+import type { Component } from '../../client/vnode.ts';
+export interface InputNumberProps {
+    value?: number | null;
+    onChange?: (value: number | null) => void;
+    min?: number;
+    max?: number;
+    step?: number;
+    precision?: number;
+    label?: string;
+    name?: string;
+    placeholder?: string;
+    disabled?: boolean;
+    error?: string;
+    hint?: string;
+    required?: boolean;
+    className?: string;
+}
+export declare const InputNumber: Component<InputNumberProps>;

package/dist/components/Label/Label.d.ts

@@ -0,0 +1,11 @@
+import type { Component } from '../../client/vnode.ts';
+export interface LabelProps {
+    htmlFor?: string;
+    /** 必填星号 */
+    required?: boolean;
+    children?: any;
+    className?: string;
+    [key: string]: any;
+}
+/** 独立标签（对应 shadcn Label；weifuwu Input/Field 已内嵌 label，独立组件用于自定义布局） */
+export declare const Label: Component<LabelProps>;

package/dist/components/List/List.d.ts

@@ -0,0 +1,18 @@
+/**
+ * weifuwu/components — List
+ *
+ * 通用列表：items + renderItem + header/footer/empty 占位。
+ * 定位：Table 大材小用的消息/文件/成员列表场景。
+ */
+import type { Component } from '../../client/vnode.ts';
+export interface ListProps<T = any> {
+    items: T[];
+    renderItem: (item: T, index: number) => any;
+    divided?: boolean;
+    header?: any;
+    footer?: any;
+    emptyText?: string;
+    emptyIcon?: any;
+    className?: string;
+}
+export declare const List: Component<ListProps>;

package/dist/components/Markdown/Markdown.d.ts

@@ -0,0 +1,14 @@
+/**
+ * weifuwu/components — Markdown
+ *
+ * AI 回复/富文本渲染。安全子集解析 → VNode 渲染（天然转义，无 innerHTML 注入面）。
+ * 与 CodeBlock 组合渲染代码围栏。
+ */
+import type { Component } from '../../client/vnode.ts';
+import { type MdInline } from './parser.ts';
+export interface MarkdownProps {
+    content: string;
+    className?: string;
+}
+export declare const Markdown: Component<MarkdownProps>;
+export declare function renderInline(nodes: MdInline[]): any[];

package/dist/components/Markdown/parser.d.ts

@@ -0,0 +1,32 @@
+/**
+ * weifuwu/components — Markdown 安全子集 parser
+ *
+ * 零依赖自研解析器，输出结构化 token（非 HTML 字符串）——
+ * 组件层以 VNode 渲染，天然转义任何用户/AI 内容（无 innerHTML 注入面）。
+ *
+ * 支持块级：标题(#~####) / 段落 / 列表(有序·无序) / 围栏代码块 / 引用 / 分割线
+ * 支持行内：**粗体** / *斜体* / `行内代码` / [文本](链接)
+ *
+ * 诚实裁剪：GFM 表格/任务列表/删除线/脚注/raw HTML/自动链接/语法高亮（见 roadmap）
+ */
+export interface MdInline {
+    type: 'text' | 'code' | 'bold' | 'italic' | 'link';
+    text?: string;
+    href?: string;
+    children?: MdInline[];
+}
+export interface MdBlock {
+    type: 'heading' | 'paragraph' | 'list' | 'code' | 'quote' | 'hr';
+    level?: number;
+    inline?: MdInline[];
+    ordered?: boolean;
+    items?: MdInline[][];
+    lang?: string;
+    code?: string;
+}
+/** 链接安全：仅 http/https；javascript:/data:/vbscript: 一律拒绝 */
+export declare function safeUrl(href: string): string | null;
+/** 行内解析：code / bold / italic / link，其余为 text（有序优先防嵌套误判） */
+export declare function parseInline(src: string): MdInline[];
+/** 块级解析：逐行状态机 */
+export declare function parseMarkdown(content: string): MdBlock[];

package/dist/components/Mentions/Mentions.d.ts

@@ -0,0 +1,19 @@
+import type { Component } from '../../client/vnode.ts';
+export interface MentionsOption {
+    value: string;
+    label?: string;
+}
+export interface MentionsProps {
+    value?: string;
+    onChange?: (value: string) => void;
+    options?: MentionsOption[];
+    /** 触发字符，默认 '@' */
+    prefix?: string;
+    placeholder?: string;
+    rows?: number;
+    disabled?: boolean;
+    size?: 'sm' | 'md' | 'lg';
+}
+/** @提及输入（对应 antd Mentions）：输入 prefix + 关键词弹出候选，点击/Enter 插入。
+ * 裁剪：不做多 prefix/自定义高亮渲染/远程搜索（options 静态传入）。 */
+export declare const Mentions: Component<MentionsProps>;

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

@@ -0,0 +1,25 @@
+/**
+ * weifuwu/components — Menu
+ *
+ * 导航菜单（侧栏导航）：分组项 + 图标 + 选中态 + 方向键导航 + Enter 激活。
+ * 用于 SaaS 应用侧边导航（替代手写 nav-item 循环）。
+ * 裁剪：不做子菜单展开/水平菜单栏（见 roadmap）。
+ */
+import type { Component } from '../../client/vnode.ts';
+export interface MenuItem {
+    key: string;
+    label: any;
+    icon?: any;
+    /** 分组标题（相邻同组项之间插分组头） */
+    group?: string;
+    active?: boolean;
+    danger?: boolean;
+    onClick?: () => void;
+}
+export interface MenuProps {
+    items: MenuItem[];
+    onSelect?: (key: string) => void;
+    activeKey?: string;
+    className?: string;
+}
+export declare const Menu: Component<MenuProps>;