@quantlife/qlui 0.0.0-stage → 0.0.1

package/README.md

@@ -1,3 +1,124 @@
-# Temporary Holding Version
+# ql-ui
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+
+
+## Getting started
+
+To make it easy for you to get started with GitLab, here's a list of recommended next steps.
+
+Already a pro? Just edit this README.md and make it your own. Want to make it easy? [Use the template at the bottom](#editing-this-readme)!
+
+## Add your files
+
+- [ ] [Create](https://docs.gitlab.com/ee/user/project/repository/web_editor.html#create-a-file) or [upload](https://docs.gitlab.com/ee/user/project/repository/web_editor.html#upload-a-file) files
+- [ ] [Add files using the command line](https://docs.gitlab.com/ee/gitlab-basics/add-file.html#add-a-file-using-the-command-line) or push an existing Git repository with the following command:
+
+```
+cd existing_repo
+git remote add origin https://gitlab.quantlifetech.com/quantlife/libs/ql-ui.git
+git branch -M main
+git push -uf origin main
+```
+
+## Integrate with your tools
+
+- [ ] [Set up project integrations](https://gitlab.quantlifetech.com/quantlife/libs/ql-ui/-/settings/integrations)
+
+## Collaborate with your team
+
+- [ ] [Invite team members and collaborators](https://docs.gitlab.com/ee/user/project/members/)
+- [ ] [Create a new merge request](https://docs.gitlab.com/ee/user/project/merge_requests/creating_merge_requests.html)
+- [ ] [Automatically close issues from merge requests](https://docs.gitlab.com/ee/user/project/issues/managing_issues.html#closing-issues-automatically)
+- [ ] [Enable merge request approvals](https://docs.gitlab.com/ee/user/project/merge_requests/approvals/)
+- [ ] [Set auto-merge](https://docs.gitlab.com/ee/user/project/merge_requests/merge_when_pipeline_succeeds.html)
+
+## Test and Deploy
+
+Use the built-in continuous integration in GitLab.
+
+- [ ] [Get started with GitLab CI/CD](https://docs.gitlab.com/ee/ci/quick_start/index.html)
+- [ ] [Analyze your code for known vulnerabilities with Static Application Security Testing (SAST)](https://docs.gitlab.com/ee/user/application_security/sast/)
+- [ ] [Deploy to Kubernetes, Amazon EC2, or Amazon ECS using Auto Deploy](https://docs.gitlab.com/ee/topics/autodevops/requirements.html)
+- [ ] [Use pull-based deployments for improved Kubernetes management](https://docs.gitlab.com/ee/user/clusters/agent/)
+- [ ] [Set up protected environments](https://docs.gitlab.com/ee/ci/environments/protected_environments.html)
+
+***
+
+# Editing this README
+
+When you're ready to make this README your own, just edit this file and use the handy template below (or feel free to structure it however you want - this is just a starting point!). Thanks to [makeareadme.com](https://www.makeareadme.com/) for this template.
+
+## Suggestions for a good README
+
+Every project is different, so consider which of these sections apply to yours. The sections used in the template are suggestions for most open source projects. Also keep in mind that while a README can be too long and detailed, too long is better than too short. If you think your README is too long, consider utilizing another form of documentation rather than cutting out information.
+
+## Name
+Choose a self-explaining name for your project.
+
+## Description
+Let people know what your project can do specifically. Provide context and add a link to any reference visitors might be unfamiliar with. A list of Features or a Background subsection can also be added here. If there are alternatives to your project, this is a good place to list differentiating factors.
+
+## Badges
+On some READMEs, you may see small images that convey metadata, such as whether or not all the tests are passing for the project. You can use Shields to add some to your README. Many services also have instructions for adding a badge.
+
+## Visuals
+Depending on what you are making, it can be a good idea to include screenshots or even a video (you'll frequently see GIFs rather than actual videos). Tools like ttygif can help, but check out Asciinema for a more sophisticated method.
+
+## Installation
+Within a particular ecosystem, there may be a common way of installing things, such as using Yarn, NuGet, or Homebrew. However, consider the possibility that whoever is reading your README is a novice and would like more guidance. Listing specific steps helps remove ambiguity and gets people to using your project as quickly as possible. If it only runs in a specific context like a particular programming language version or operating system or has dependencies that have to be installed manually, also add a Requirements subsection.
+
+## Usage
+Use examples liberally, and show the expected output if you can. It's helpful to have inline the smallest example of usage that you can demonstrate, while providing links to more sophisticated examples if they are too long to reasonably include in the README.
+
+## Support
+Tell people where they can go to for help. It can be any combination of an issue tracker, a chat room, an email address, etc.
+
+## Roadmap
+If you have ideas for releases in the future, it is a good idea to list them in the README.
+
+## Contributing
+State if you are open to contributions and what your requirements are for accepting them.
+
+For people who want to make changes to your project, it's helpful to have some documentation on how to get started. Perhaps there is a script that they should run or some environment variables that they need to set. Make these steps explicit. These instructions could also be useful to your future self.
+
+You can also document commands to lint the code or run tests. These steps help to ensure high code quality and reduce the likelihood that the changes inadvertently break something. Having instructions for running tests is especially helpful if it requires external setup, such as starting a Selenium server for testing in a browser.
+
+## Authors and acknowledgment
+Show your appreciation to those who have contributed to the project.
+
+## License
+For open source projects, say how it is licensed.
+
+## Project status
+If you have run out of energy or time for your project, put a note at the top of the README saying that development has slowed down or stopped completely. Someone may choose to fork your project or volunteer to step in as a maintainer or owner, allowing your project to keep going. You can also make an explicit request for maintainers.
+
+## shadcn 组件使用方式（老板 11:33 指正说明）
+
+### 组件存放目录
+shadcn 组件（CLI 添加的源码）落在 **`src/components/ui/`**（components.json aliases 配置 `ui: @/components/ui`）——A1 标准 26 件+A2 组合+A3 registry+C 自建+D 迁入共 51 个组件文件全部在此目录。
+
+### 添加组件（源码进本地，非 npm 依赖）
+```bash
+pnpm dlx shadcn@latest add button          # 单个
+pnpm dlx shadcn@latest add button card tabs  # 批量
+```
+组件源码复制进 `src/components/ui/button.tsx`——可直接修改（这是我们封装 TabsBar/rightExtra 等承接面的基础）。
+
+### 升级更新工作流
+```bash
+pnpm dlx shadcn@latest diff     # 查看本地组件与上游差异
+pnpm dlx shadcn@latest update   # 更新本地组件到上游最新
+```
+注意：本地已改造的组件（如 combobox 加 onSearch/loading、tabs 加 TabsBar）update 会覆盖——diff 先看再选择性合并。
+
+### Storybook 用例目录
+stories 用例在 **`src/stories/`**（与组件源码 `src/components/ui/` 分离——老板 11:33 架构口径）；`pnpm storybook` 起 6006 查看。
+
+
+## 主题机制（token 契约+可选预设——宿主主权，老板 2026-10-23 11:52 定音）
+
+- **职责分层**：**ql-ui 只定义变量（token）的名字**（组件引用的颜色变量契约：--background/--foreground/--card/--primary/--muted/--border 等约 40 个——组件全部引用 token，零写死颜色）；**具体值是动态的**；**主题的 CSS 配置（新增特殊主题）由宿主项目添加，不加进本库**。
+- **预设（可选默认值）**：内置 light（默认）/dark 两套预设（ThemeProvider 驱动 html class/`data-theme`，localStorage 持久化）；预设只是默认值——**宿主可覆盖、可新增，不用改本库**。
+- **宿主覆盖预设主题（三步，零库改动）**：① 宿主全局 CSS 以更高特异性/后加载覆写目标 token（例：`html[data-theme="dark"] { --background: <你的色>; }`）② 按需逐 token 改（背景/组件背景/字体色想设什么设什么）③ 刷新即全组件生效。
+- **宿主新增自定义主题（四步，零库改动）**：① 宿主 CSS 写完整变量集 `html[data-theme="custom-x"] { --background: …; --card: …; /* 全部 token */ }`（每套主题=一组 CSS 颜色集，各 token 关系自由定义）② 宿主设置界面加该主题入口 ③ `setTheme("custom-x")` 驱动 html data-theme（ThemeProvider 支持任意主题串，可传入扩展主题清单）④ 验证全组件同步变色。
+- **Storybook 演示**：预设主题下全部组件形态对照见 `pnpm storybook`（主题切换 toolbar）。

package/dist/components/ui/accordion.d.ts

@@ -0,0 +1,7 @@
+import * as React from "react";
+import { Accordion as AccordionPrimitive } from "radix-ui";
+declare function Accordion({ ...props }: React.ComponentProps<typeof AccordionPrimitive.Root>): React.JSX.Element;
+declare function AccordionItem({ className, ...props }: React.ComponentProps<typeof AccordionPrimitive.Item>): React.JSX.Element;
+declare function AccordionTrigger({ className, children, ...props }: React.ComponentProps<typeof AccordionPrimitive.Trigger>): React.JSX.Element;
+declare function AccordionContent({ className, children, ...props }: React.ComponentProps<typeof AccordionPrimitive.Content>): React.JSX.Element;
+export { Accordion, AccordionItem, AccordionTrigger, AccordionContent };

package/dist/components/ui/action-buttons.d.ts

@@ -0,0 +1,23 @@
+import * as React from "react";
+import { Button } from "@/components/ui/button";
+export interface ActionButtonProps extends Omit<React.ComponentProps<typeof Button>, 'variant'> {
+    loading?: boolean;
+    icon?: React.ReactNode;
+    onClick?: () => void;
+    danger?: boolean;
+}
+/** 统一操作按钮（antd link+small 迁入→ghost+sm 样式映射） */
+export declare function ActionButton({ icon, onClick, children, danger, disabled, loading, ...rest }: ActionButtonProps): React.JSX.Element;
+export interface DeleteButtonProps {
+    onConfirm: () => void;
+    title?: string;
+    description?: string;
+    label?: string;
+}
+/** 删除按钮（AlertDialog 二次确认替代 Popconfirm） */
+export declare function DeleteButton({ onConfirm, title, description, label }: DeleteButtonProps): React.JSX.Element;
+/** 详情按钮 */
+export declare function DetailButton({ onClick, label }: {
+    onClick: () => void;
+    label?: string;
+}): React.JSX.Element;

package/dist/components/ui/alert-dialog.d.ts

@@ -0,0 +1,18 @@
+import * as React from "react";
+import { AlertDialog as AlertDialogPrimitive } from "radix-ui";
+import { Button } from "@/components/ui/button";
+declare function AlertDialog({ ...props }: React.ComponentProps<typeof AlertDialogPrimitive.Root>): React.JSX.Element;
+declare function AlertDialogTrigger({ ...props }: React.ComponentProps<typeof AlertDialogPrimitive.Trigger>): React.JSX.Element;
+declare function AlertDialogPortal({ ...props }: React.ComponentProps<typeof AlertDialogPrimitive.Portal>): React.JSX.Element;
+declare function AlertDialogOverlay({ className, ...props }: React.ComponentProps<typeof AlertDialogPrimitive.Overlay>): React.JSX.Element;
+declare function AlertDialogContent({ className, size, ...props }: React.ComponentProps<typeof AlertDialogPrimitive.Content> & {
+    size?: "default" | "sm";
+}): React.JSX.Element;
+declare function AlertDialogHeader({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
+declare function AlertDialogFooter({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
+declare function AlertDialogTitle({ className, ...props }: React.ComponentProps<typeof AlertDialogPrimitive.Title>): React.JSX.Element;
+declare function AlertDialogDescription({ className, ...props }: React.ComponentProps<typeof AlertDialogPrimitive.Description>): React.JSX.Element;
+declare function AlertDialogMedia({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
+declare function AlertDialogAction({ className, variant, size, ...props }: React.ComponentProps<typeof AlertDialogPrimitive.Action> & Pick<React.ComponentProps<typeof Button>, "variant" | "size">): React.JSX.Element;
+declare function AlertDialogCancel({ className, variant, size, ...props }: React.ComponentProps<typeof AlertDialogPrimitive.Cancel> & Pick<React.ComponentProps<typeof Button>, "variant" | "size">): React.JSX.Element;
+export { AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogMedia, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, };

package/dist/components/ui/alert.d.ts

@@ -0,0 +1,9 @@
+import * as React from "react";
+import { type VariantProps } from "class-variance-authority";
+declare const alertVariants: (props?: ({
+    variant?: "default" | "destructive" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+declare function Alert({ className, variant, ...props }: React.ComponentProps<"div"> & VariantProps<typeof alertVariants>): React.JSX.Element;
+declare function AlertTitle({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
+declare function AlertDescription({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
+export { Alert, AlertTitle, AlertDescription };

package/dist/components/ui/aspect-ratio.d.ts

@@ -0,0 +1,3 @@
+import { AspectRatio as AspectRatioPrimitive } from "radix-ui";
+declare function AspectRatio({ ...props }: React.ComponentProps<typeof AspectRatioPrimitive.Root>): import("react").JSX.Element;
+export { AspectRatio };

package/dist/components/ui/badge.d.ts

@@ -0,0 +1,9 @@
+import * as React from "react";
+import { type VariantProps } from "class-variance-authority";
+declare const badgeVariants: (props?: ({
+    variant?: "default" | "destructive" | "ghost" | "link" | "outline" | "secondary" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+declare function Badge({ className, variant, asChild, ...props }: React.ComponentProps<"span"> & VariantProps<typeof badgeVariants> & {
+    asChild?: boolean;
+}): React.JSX.Element;
+export { Badge, badgeVariants };

package/dist/components/ui/base-pair-selector.d.ts

@@ -0,0 +1,19 @@
+import * as React from "react";
+export interface PairOption {
+    value: string;
+    label: string;
+    meta?: React.ReactNode;
+}
+export interface BasePairSelectorProps {
+    mode?: "single" | "multiple";
+    value?: string | string[];
+    onChange?: (value: string | string[]) => void;
+    /** 搜索注入（数据流外置——业务侧接 react-query） */
+    onSearch?: (keyword: string) => Promise<PairOption[]> | PairOption[];
+    options?: PairOption[];
+    placeholder?: string;
+    disabled?: boolean;
+    className?: string;
+}
+/** 品种搜索选择器壳（自研迁入——剥离业务数据流，搜索回调注入） */
+export declare function BasePairSelector({ mode, value, onChange, onSearch, options: staticOptions, placeholder, disabled, className, }: BasePairSelectorProps): React.JSX.Element;

package/dist/components/ui/button.d.ts

@@ -0,0 +1,10 @@
+import * as React from "react";
+import { type VariantProps } from "class-variance-authority";
+declare const buttonVariants: (props?: ({
+    variant?: "default" | "destructive" | "ghost" | "link" | "outline" | "secondary" | null | undefined;
+    size?: "default" | "icon" | "icon-lg" | "icon-sm" | "icon-xs" | "lg" | "sm" | "xs" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+declare function Button({ className, variant, size, asChild, ...props }: React.ComponentProps<"button"> & VariantProps<typeof buttonVariants> & {
+    asChild?: boolean;
+}): React.JSX.Element;
+export { Button, buttonVariants };

package/dist/components/ui/calendar.d.ts

@@ -0,0 +1,8 @@
+import * as React from "react";
+import { DayPicker, type DayButton } from "react-day-picker";
+import { Button } from "@/components/ui/button";
+declare function Calendar({ className, classNames, showOutsideDays, captionLayout, buttonVariant, formatters, components, ...props }: React.ComponentProps<typeof DayPicker> & {
+    buttonVariant?: React.ComponentProps<typeof Button>["variant"];
+}): React.JSX.Element;
+declare function CalendarDayButton({ className, day, modifiers, ...props }: React.ComponentProps<typeof DayButton>): React.JSX.Element;
+export { Calendar, CalendarDayButton };

package/dist/components/ui/card.d.ts

@@ -0,0 +1,9 @@
+import * as React from "react";
+declare function Card({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
+declare function CardHeader({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
+declare function CardTitle({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
+declare function CardDescription({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
+declare function CardAction({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
+declare function CardContent({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
+declare function CardFooter({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
+export { Card, CardHeader, CardFooter, CardTitle, CardAction, CardDescription, CardContent, };

package/dist/components/ui/chat-input.d.ts

@@ -0,0 +1,18 @@
+import * as React from "react";
+export interface ChatInputProps {
+    /** 占位提示 */
+    placeholder?: string;
+    /** 输入禁用 */
+    disabled?: boolean;
+    /** 生成中（发送按钮切换为停止） */
+    loading?: boolean;
+    /** 提交（Enter 发送 / Shift+Enter 换行） */
+    onSubmit?: (value: string) => void;
+    /** 停止生成 */
+    onStop?: () => void;
+    className?: string;
+    /** 受控初值 */
+    defaultValue?: string;
+}
+/** AI 聊天输入框（shadcn registry 无现成——按 shadcn 风格自建） */
+export declare function ChatInput({ placeholder, disabled, loading, onSubmit, onStop, className, defaultValue, }: ChatInputProps): React.JSX.Element;

package/dist/components/ui/chat-list.d.ts

@@ -0,0 +1,14 @@
+import * as React from "react";
+export interface ChatListProps {
+    /** 消息条目 */
+    messages?: React.ReactNode[];
+    /** 自动滚动到底部 */
+    autoScroll?: boolean;
+    /** 空态描述 */
+    emptyDescription?: React.ReactNode;
+    /** 追加底部插槽（如 ThinkingLoader） */
+    footer?: React.ReactNode;
+    className?: string;
+}
+/** AI 消息列表容器（shadcn registry 无现成——按 shadcn 风格自建） */
+export declare function ChatList({ messages, autoScroll, emptyDescription, footer, className, }: ChatListProps): React.JSX.Element;

package/dist/components/ui/chat-message.d.ts

@@ -0,0 +1,15 @@
+import * as React from "react";
+export type ChatMessageRole = "user" | "assistant" | "system";
+export interface ChatMessageProps {
+    /** 消息角色：用户/助手/系统 */
+    role?: ChatMessageRole;
+    /** 头像覆盖（默认按角色取 lucide 图标） */
+    avatar?: React.ReactNode;
+    /** 消息内容（markdown 由业务层渲染后传入容器） */
+    children?: React.ReactNode;
+    /** 流式输出中（显示光标） */
+    streaming?: boolean;
+    className?: string;
+}
+/** AI 聊天消息（shadcn registry 无现成——按 shadcn 风格自建） */
+export declare function ChatMessage({ role, avatar, children, streaming, className, }: ChatMessageProps): React.JSX.Element;

package/dist/components/ui/checkbox.d.ts

@@ -0,0 +1,4 @@
+import * as React from "react";
+import { Checkbox as CheckboxPrimitive } from "radix-ui";
+declare function Checkbox({ className, ...props }: React.ComponentProps<typeof CheckboxPrimitive.Root>): React.JSX.Element;
+export { Checkbox };

package/dist/components/ui/collapsible.d.ts

@@ -0,0 +1,5 @@
+import { Collapsible as CollapsiblePrimitive } from "radix-ui";
+declare function Collapsible({ ...props }: React.ComponentProps<typeof CollapsiblePrimitive.Root>): import("react").JSX.Element;
+declare function CollapsibleTrigger({ ...props }: React.ComponentProps<typeof CollapsiblePrimitive.CollapsibleTrigger>): import("react").JSX.Element;
+declare function CollapsibleContent({ ...props }: React.ComponentProps<typeof CollapsiblePrimitive.CollapsibleContent>): import("react").JSX.Element;
+export { Collapsible, CollapsibleTrigger, CollapsibleContent };

package/dist/components/ui/combobox.d.ts

@@ -0,0 +1,31 @@
+import * as React from "react";
+export interface ComboboxOption {
+    value: string;
+    label: string;
+    disabled?: boolean;
+}
+/** 可搜索下拉选择（antd Select showSearch 场景全部映射至此——本地图过滤与远程搜索双模式）
+ *
+ * 远程搜索/异步选项用法约定：
+ * - 传入 onSearch 时为远程模式：输入触发回调，由宿主异步取数后更新 options
+ * - loading=true 时下拉显示加载态（宿主请求期间置 true）
+ * - 不传 onSearch 时为本地模式：options 内前端过滤
+ */
+export interface ComboboxProps {
+    options: ComboboxOption[];
+    value?: string;
+    onChange?: (value: string) => void;
+    placeholder?: string;
+    searchPlaceholder?: string;
+    emptyText?: string;
+    disabled?: boolean;
+    className?: string;
+    /** 远程搜索回调（传入即远程模式：输入触发，宿主异步取数更新 options） */
+    onSearch?: (keyword: string) => void;
+    /** 异步加载态（宿主请求期间置 true——下拉显示加载中） */
+    loading?: boolean;
+}
+/** 可搜索下拉选择（Select 搜索——cmdk 组合） */
+export declare function Combobox({ options, value, onChange, placeholder, searchPlaceholder, onSearch, loading, emptyText, disabled, className, }: ComboboxProps): React.JSX.Element;
+/** 别名导出：SearchableSelect（antd Select showSearch 场景全部映射至此——架构 v1.2 清单口径） */
+export declare const SearchableSelect: typeof Combobox;

package/dist/components/ui/command.d.ts

@@ -0,0 +1,18 @@
+import * as React from "react";
+import { Command as CommandPrimitive } from "cmdk";
+import { Dialog } from "@/components/ui/dialog";
+declare function Command({ className, ...props }: React.ComponentProps<typeof CommandPrimitive>): React.JSX.Element;
+declare function CommandDialog({ title, description, children, className, showCloseButton, ...props }: React.ComponentProps<typeof Dialog> & {
+    title?: string;
+    description?: string;
+    className?: string;
+    showCloseButton?: boolean;
+}): React.JSX.Element;
+declare function CommandInput({ className, ...props }: React.ComponentProps<typeof CommandPrimitive.Input>): React.JSX.Element;
+declare function CommandList({ className, ...props }: React.ComponentProps<typeof CommandPrimitive.List>): React.JSX.Element;
+declare function CommandEmpty({ ...props }: React.ComponentProps<typeof CommandPrimitive.Empty>): React.JSX.Element;
+declare function CommandGroup({ className, ...props }: React.ComponentProps<typeof CommandPrimitive.Group>): React.JSX.Element;
+declare function CommandSeparator({ className, ...props }: React.ComponentProps<typeof CommandPrimitive.Separator>): React.JSX.Element;
+declare function CommandItem({ className, ...props }: React.ComponentProps<typeof CommandPrimitive.Item>): React.JSX.Element;
+declare function CommandShortcut({ className, ...props }: React.ComponentProps<"span">): React.JSX.Element;
+export { Command, CommandDialog, CommandInput, CommandList, CommandEmpty, CommandGroup, CommandItem, CommandShortcut, CommandSeparator, };

package/dist/components/ui/date-picker-int.d.ts

@@ -0,0 +1,11 @@
+import * as React from "react";
+export interface DatePickerIntProps {
+    /** YYYYMMDD 整数（自研迁入——与业务 int 日期字段直连） */
+    value?: number;
+    onChange?: (value: number | undefined) => void;
+    placeholder?: string;
+    disabled?: boolean;
+    className?: string;
+}
+/** 整数日期选择器（value/onChange 均为 YYYYMMDD int） */
+export declare function DatePickerInt({ value, onChange, placeholder, disabled, className }: DatePickerIntProps): React.JSX.Element;

package/dist/components/ui/date-picker.d.ts

@@ -0,0 +1,20 @@
+import * as React from "react";
+import { DateRange } from "react-day-picker";
+export interface DatePickerProps {
+    value?: Date;
+    onChange?: (date: Date | undefined) => void;
+    placeholder?: string;
+    disabled?: boolean;
+    className?: string;
+}
+/** 单日选择（Calendar × Popover） */
+export declare function DatePicker({ value, onChange, placeholder, disabled, className }: DatePickerProps): React.JSX.Element;
+export interface RangePickerProps {
+    value?: DateRange;
+    onChange?: (range: DateRange | undefined) => void;
+    placeholder?: string;
+    disabled?: boolean;
+    className?: string;
+}
+/** 双月区间选择 */
+export declare function RangePicker({ value, onChange, placeholder, disabled, className }: RangePickerProps): React.JSX.Element;

package/dist/components/ui/descriptions.d.ts

@@ -0,0 +1,15 @@
+import * as React from "react";
+export interface DescriptionItem {
+    label: React.ReactNode;
+    children: React.ReactNode;
+    span?: number;
+}
+export interface DescriptionsProps {
+    title?: React.ReactNode;
+    items: DescriptionItem[];
+    column?: number;
+    bordered?: boolean;
+    className?: string;
+}
+/** 描述列表（registry 无现成——自建依据存档） */
+export declare function Descriptions({ title, items, column, bordered, className }: DescriptionsProps): React.JSX.Element;

package/dist/components/ui/dialog.d.ts

@@ -0,0 +1,17 @@
+import * as React from "react";
+import { Dialog as DialogPrimitive } from "radix-ui";
+declare function Dialog({ ...props }: React.ComponentProps<typeof DialogPrimitive.Root>): React.JSX.Element;
+declare function DialogTrigger({ ...props }: React.ComponentProps<typeof DialogPrimitive.Trigger>): React.JSX.Element;
+declare function DialogPortal({ ...props }: React.ComponentProps<typeof DialogPrimitive.Portal>): React.JSX.Element;
+declare function DialogClose({ ...props }: React.ComponentProps<typeof DialogPrimitive.Close>): React.JSX.Element;
+declare function DialogOverlay({ className, ...props }: React.ComponentProps<typeof DialogPrimitive.Overlay>): React.JSX.Element;
+declare function DialogContent({ className, children, showCloseButton, ...props }: React.ComponentProps<typeof DialogPrimitive.Content> & {
+    showCloseButton?: boolean;
+}): React.JSX.Element;
+declare function DialogHeader({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
+declare function DialogFooter({ className, showCloseButton, children, ...props }: React.ComponentProps<"div"> & {
+    showCloseButton?: boolean;
+}): React.JSX.Element;
+declare function DialogTitle({ className, ...props }: React.ComponentProps<typeof DialogPrimitive.Title>): React.JSX.Element;
+declare function DialogDescription({ className, ...props }: React.ComponentProps<typeof DialogPrimitive.Description>): React.JSX.Element;
+export { Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, };

package/dist/components/ui/digital-pair-selector.d.ts

@@ -0,0 +1,14 @@
+import { type PairOption } from "@/components/ui/base-pair-selector";
+export interface DigitalPairSelectorProps {
+    mode?: "single" | "multiple";
+    value?: string | string[];
+    onChange?: (value: string | string[]) => void;
+    /** 搜索注入（数据流外置——业务侧接 react-query 后传入） */
+    onSearch?: (keyword: string) => Promise<PairOption[]> | PairOption[];
+    options?: PairOption[];
+    placeholder?: string;
+    disabled?: boolean;
+    className?: string;
+}
+/** 数字货币品种选择（自研迁入——BasePairSelector 数字货币预设壳，label 统一大写） */
+export declare function DigitalPairSelector({ mode, value, onChange, onSearch, options, placeholder, disabled, className, }: DigitalPairSelectorProps): import("react").JSX.Element;

package/dist/components/ui/drawer.d.ts

@@ -0,0 +1,13 @@
+import * as React from "react";
+import { Drawer as DrawerPrimitive } from "vaul";
+declare function Drawer({ ...props }: React.ComponentProps<typeof DrawerPrimitive.Root>): React.JSX.Element;
+declare function DrawerTrigger({ ...props }: React.ComponentProps<typeof DrawerPrimitive.Trigger>): React.JSX.Element;
+declare function DrawerPortal({ ...props }: React.ComponentProps<typeof DrawerPrimitive.Portal>): React.JSX.Element;
+declare function DrawerClose({ ...props }: React.ComponentProps<typeof DrawerPrimitive.Close>): React.JSX.Element;
+declare function DrawerOverlay({ className, ...props }: React.ComponentProps<typeof DrawerPrimitive.Overlay>): React.JSX.Element;
+declare function DrawerContent({ className, children, ...props }: React.ComponentProps<typeof DrawerPrimitive.Content>): React.JSX.Element;
+declare function DrawerHeader({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
+declare function DrawerFooter({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
+declare function DrawerTitle({ className, ...props }: React.ComponentProps<typeof DrawerPrimitive.Title>): React.JSX.Element;
+declare function DrawerDescription({ className, ...props }: React.ComponentProps<typeof DrawerPrimitive.Description>): React.JSX.Element;
+export { Drawer, DrawerPortal, DrawerOverlay, DrawerTrigger, DrawerClose, DrawerContent, DrawerHeader, DrawerFooter, DrawerTitle, DrawerDescription, };

package/dist/components/ui/dropdown-menu.d.ts

@@ -0,0 +1,25 @@
+import * as React from "react";
+import { DropdownMenu as DropdownMenuPrimitive } from "radix-ui";
+declare function DropdownMenu({ ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Root>): React.JSX.Element;
+declare function DropdownMenuPortal({ ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Portal>): React.JSX.Element;
+declare function DropdownMenuTrigger({ ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Trigger>): React.JSX.Element;
+declare function DropdownMenuContent({ className, sideOffset, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Content>): React.JSX.Element;
+declare function DropdownMenuGroup({ ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Group>): React.JSX.Element;
+declare function DropdownMenuItem({ className, inset, variant, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Item> & {
+    inset?: boolean;
+    variant?: "default" | "destructive";
+}): React.JSX.Element;
+declare function DropdownMenuCheckboxItem({ className, children, checked, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.CheckboxItem>): React.JSX.Element;
+declare function DropdownMenuRadioGroup({ ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.RadioGroup>): React.JSX.Element;
+declare function DropdownMenuRadioItem({ className, children, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.RadioItem>): React.JSX.Element;
+declare function DropdownMenuLabel({ className, inset, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Label> & {
+    inset?: boolean;
+}): React.JSX.Element;
+declare function DropdownMenuSeparator({ className, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Separator>): React.JSX.Element;
+declare function DropdownMenuShortcut({ className, ...props }: React.ComponentProps<"span">): React.JSX.Element;
+declare function DropdownMenuSub({ ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Sub>): React.JSX.Element;
+declare function DropdownMenuSubTrigger({ className, inset, children, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.SubTrigger> & {
+    inset?: boolean;
+}): React.JSX.Element;
+declare function DropdownMenuSubContent({ className, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.SubContent>): React.JSX.Element;
+export { DropdownMenu, DropdownMenuPortal, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuGroup, DropdownMenuLabel, DropdownMenuItem, DropdownMenuCheckboxItem, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubTrigger, DropdownMenuSubContent, };

package/dist/components/ui/empty.d.ts

@@ -0,0 +1,9 @@
+import * as React from "react";
+export interface EmptyProps {
+    description?: React.ReactNode;
+    icon?: React.ReactNode;
+    action?: React.ReactNode;
+    className?: string;
+}
+/** 空状态（registry 无现成——自建依据存档） */
+export declare function Empty({ description, icon, action, className }: EmptyProps): React.JSX.Element;

package/dist/components/ui/exchange-select.d.ts

@@ -0,0 +1,13 @@
+import * as React from "react";
+export interface ExchangeSelectProps {
+    /** 交易所选项注入（数据流外置——业务侧接 react-query） */
+    options: string[];
+    value?: string;
+    onChange?: (value: string) => void;
+    loading?: boolean;
+    disabled?: boolean;
+    placeholder?: string;
+    className?: string;
+}
+/** 交易所选择（自研迁入——纯壳+options 注入，label 统一大写） */
+export declare function ExchangeSelect({ options, value, onChange, loading, disabled, placeholder, className }: ExchangeSelectProps): React.JSX.Element;

package/dist/components/ui/file-tree.d.ts

@@ -0,0 +1,14 @@
+import * as React from "react";
+export interface FileTreeNode {
+    id: string;
+    name: string;
+    children?: FileTreeNode[];
+}
+export interface FileTreeProps {
+    data: FileTreeNode[];
+    defaultExpandedIds?: string[];
+    onSelect?: (node: FileTreeNode) => void;
+    className?: string;
+}
+/** 可访问文件树（react-accessible-tree，键盘导航内建） */
+export declare function FileTree({ data, defaultExpandedIds, onSelect, className }: FileTreeProps): React.JSX.Element;

package/dist/components/ui/file-upload.d.ts

@@ -0,0 +1,10 @@
+import * as React from "react";
+export interface FileUploadProps {
+    accept?: Record<string, string[]>;
+    maxFiles?: number;
+    maxSize?: number;
+    onFilesChange?: (files: File[]) => void;
+    className?: string;
+}
+/** 拖拽上传（react-dropzone） */
+export declare function FileUpload({ accept, maxFiles, maxSize, onFilesChange, className }: FileUploadProps): React.JSX.Element;

package/dist/components/ui/form.d.ts

@@ -0,0 +1,24 @@
+import * as React from "react";
+import type { Label as LabelPrimitive } from "radix-ui";
+import { Slot } from "radix-ui";
+import { type ControllerProps, type FieldPath, type FieldValues } from "react-hook-form";
+declare const Form: <TFieldValues extends FieldValues, TContext = any, TTransformedValues = TFieldValues>({ children, watch, getValues, getErrors, getFieldState, setError, clearErrors, setValue, setValues, trigger, formState, resetField, reset, resetDefaultValues, handleSubmit, unregister, control, register, setFocus, subscribe, }: import("react-hook-form").FormProviderProps<TFieldValues, TContext, TTransformedValues>) => React.JSX.Element;
+declare const FormField: <TFieldValues extends FieldValues = FieldValues, TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>>({ ...props }: ControllerProps<TFieldValues, TName>) => React.JSX.Element;
+declare const useFormField: () => {
+    invalid: boolean;
+    isDirty: boolean;
+    isTouched: boolean;
+    isValidating: boolean;
+    error?: import("react-hook-form").FieldError | undefined;
+    id: string;
+    name: string;
+    formItemId: string;
+    formDescriptionId: string;
+    formMessageId: string;
+};
+declare function FormItem({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
+declare function FormLabel({ className, ...props }: React.ComponentProps<typeof LabelPrimitive.Root>): React.JSX.Element;
+declare function FormControl({ ...props }: React.ComponentProps<typeof Slot.Root>): React.JSX.Element;
+declare function FormDescription({ className, ...props }: React.ComponentProps<"p">): React.JSX.Element;
+declare function FormMessage({ className, ...props }: React.ComponentProps<"p">): React.JSX.Element | null;
+export { useFormField, Form, FormItem, FormLabel, FormControl, FormDescription, FormMessage, FormField, };

package/dist/components/ui/hover-card.d.ts

@@ -0,0 +1,6 @@
+import * as React from "react";
+import { HoverCard as HoverCardPrimitive } from "radix-ui";
+declare function HoverCard({ ...props }: React.ComponentProps<typeof HoverCardPrimitive.Root>): React.JSX.Element;
+declare function HoverCardTrigger({ ...props }: React.ComponentProps<typeof HoverCardPrimitive.Trigger>): React.JSX.Element;
+declare function HoverCardContent({ className, align, sideOffset, ...props }: React.ComponentProps<typeof HoverCardPrimitive.Content>): React.JSX.Element;
+export { HoverCard, HoverCardTrigger, HoverCardContent };

package/dist/components/ui/inline-completion.d.ts

@@ -0,0 +1,12 @@
+import * as React from "react";
+export interface InlineCompletionProps {
+    /** 已输入的正文 */
+    text?: React.ReactNode;
+    /** 灰色幽灵补全文本（Tab 接受） */
+    completion?: string;
+    /** 接受补全 */
+    onAccept?: (completion: string) => void;
+    className?: string;
+}
+/** 内联补全幽灵文本（shadcn registry 无现成——按 shadcn 风格自建） */
+export declare function InlineCompletion({ text, completion, onAccept, className, }: InlineCompletionProps): React.JSX.Element;

package/dist/components/ui/input-otp.d.ts

@@ -0,0 +1,11 @@
+import * as React from "react";
+import { OTPInput } from "input-otp";
+declare function InputOTP({ className, containerClassName, ...props }: React.ComponentProps<typeof OTPInput> & {
+    containerClassName?: string;
+}): React.JSX.Element;
+declare function InputOTPGroup({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
+declare function InputOTPSlot({ index, className, ...props }: React.ComponentProps<"div"> & {
+    index: number;
+}): React.JSX.Element;
+declare function InputOTPSeparator({ ...props }: React.ComponentProps<"div">): React.JSX.Element;
+export { InputOTP, InputOTPGroup, InputOTPSlot, InputOTPSeparator };