@yoka-ui/ui 1.0.10-test → 1.1.0

package/@Docs-yoka/exports.generated.md

@@ -1,92 +1,98 @@
 # @yoka-ui/ui 具名导出表
 
 > **自动生成**：`pnpm run generate:yoka-llms`（源文件 `src/index.tsx`）  
-> **包版本**：`1.0.10-test`  
-> **生成时间**：`2026-04-09T05:37:35.374Z`  
+> **包版本**：`1.1.0`  
+> **生成时间**：`2026-04-27T11:44:30.343Z`  
 > 请勿手动编辑本文件；修改导出请改 `src/index.tsx` 后重新运行上述命令。
 
 ## 使用约定（给 LLM / 业务开发者）
 
-- **包名**：`@yoka-ui/ui`（npm 公网）；可选 Git 安装：`@yoka-ui/ui`: `git+http://gitlab.sh.com/web/yoka-ui.git#v1.0.10-test` 等，以实际 tag 为准
-- **导入**：仅使用下表中的**具名**导出，与发布产物 `dist/es/index.d.ts` 一致；勿臆造未列出符号。
+- **包名**：`@yoka-ui/ui`（npm 公网）；可选 Git 安装：`@yoka-ui/ui`: `git+http://gitlab.sh.com/web/yoka-ui.git#v1.1.0` 等，以实际 tag 为准
+- **导入**：仅使用下表中的**具名**导出（组件/值与 `export type` 类型），与发布产物 `dist/es/index.d.ts` 一致；勿臆造未列出符号。
 - **全局样式（常用）**：业务入口引入一行，例如 `import '@yoka-ui/ui/dist/index.less'`（若以 README / 实际产物路径为准）。
 - **技术栈**：React 18、Ant Design 5；复杂表单/表格优先使用库内封装（`InputTheme`、`TableTheme`、`ModCommonFilter` 等），需要原生 antd API 时查阅 [Ant Design 文档](https://ant.design) 或本仓库 `@Docs/llms.txt`（克隆源码时可用）。
 
 ## 导出清单（按 `src/index.tsx` 分区）
 
-### Export all UI components
+### Export business components
 
-| 导出符号 | 源码 `from` 路径 |
-| --- | --- |
-| `LabelSelect` | `./ui/LabelSelect` |
-| `LogicOperator` | `./ui/LogicOperator` |
-| `YkButton` | `./ui/YkButton` |
-| `YkCard` | `./ui/YkCard` |
-| `YkCheckbox` | `./ui/YkCheckbox` |
-| `YkDescriptions` | `./ui/YkDescriptions` |
-| `YkPagination` | `./ui/YkPagination` |
-| `YkRadio` | `./ui/YkRadio` |
-| `YkRadioBtnSpecial` | `./ui/YkRadioBtnSpecial` |
-| `YkSegmented` | `./ui/YkSegmented` |
-| `YkSelect` | `./ui/YkSelect` |
-| `YkSpin` | `./ui/YkSpin` |
-| `YkStatistic` | `./ui/YkStatistic` |
-| `YkSwitch` | `./ui/YkSwitch` |
-| `YkTabs` | `./ui/YkTabs` |
-| `YkTooltip` | `./ui/YkTooltip` |
+| 导出符号 | 类别 | 源码 `from` 路径 |
+| --- | --- | --- |
+| `AiChat` | 组件 | `./business/AiChat` |
+| `DrawerPageInfo` | 组件 | `./business/DrawerPageInfo` |
+| `Editor` | 组件 | `./business/Editor` |
+| `Empty` | 组件 | `./business/Empty` |
+| `ModCommonFilter` | 组件 | `./business/ModCommonFilter` |
+| `YkLoginModule` | 组件 | `./business/YkLoginModule` |
+| `YkPorjectSelect` | 组件 | `./business/YkPorjectSelect` |
+| `YkSqlEdit` | 组件 | `./business/YkSqlEdit` |
 
-### Export business components
+### Export common components
 
-| 导出符号 | 源码 `from` 路径 |
-| --- | --- |
-| `DrawerPageInfo` | `./business/DrawerPageInfo` |
-| `Editor` | `./business/Editor` |
-| `Empty` | `./business/Empty` |
-| `ModCommonFilter` | `./business/ModCommonFilter` |
-| `YkPorjectSelect` | `./business/YkPorjectSelect` |
-| `YkDateRangePicker` | `./components/YkDateRangePicker` |
-| `YkRangeDateWithVS` | `./components/YkRangeDateWithVS` |
-| `YkRangeTimeWithRecent` | `./components/YkRangeTimeWithRecent` |
+| 导出符号 | 类别 | 源码 `from` 路径 |
+| --- | --- | --- |
+| `Clock` | 组件 | `./components/Clock` |
+| `DebounceInput` | 组件 | `./components/DebounceInput` |
+| `MultipleSelect` | 组件 | `./components/MultipleSelect` |
+| `NumericInput` | 组件 | `./components/NumericInput` |
+| `RefreshButton` | 组件 | `./components/RefreshButton` |
+| `SearchWithHistory` | 组件 | `./components/SearchWithHistory` |
+| `TextWithInput` | 组件 | `./components/TextWithInput` |
+| `TextWithToolTip` | 组件 | `./components/TextWithToolTip` |
+| `TreeTransfer` | 组件 | `./components/TreeTransfer` |
+| `YkDateRangePicker` | 组件 | `./components/YkDateRangePicker` |
+| `YkRangeDateWithVS` | 组件 | `./components/YkRangeDateWithVS` |
+| `YkRangeTimeWithRecent` | 组件 | `./components/YkRangeTimeWithRecent` |
 
 ### Export creative components
 
-| 导出符号 | 源码 `from` 路径 |
-| --- | --- |
-| `ButtonRadioWithInfo` | `./creative/ButtonRadioWithInfo` |
-| `ButtonWithProgress` | `./creative/ButtonWithProgress` |
+| 导出符号 | 类别 | 源码 `from` 路径 |
+| --- | --- | --- |
+| `ArcCheckboxProps` | 类型 | `./creative/ArcCheckbox` |
+| `ArcCheckbox` | 组件 | `./creative/ArcCheckbox` |
+| `ButtonRadioWithInfo` | 组件 | `./creative/ButtonRadioWithInfo` |
+| `ButtonWithProgress` | 组件 | `./creative/ButtonWithProgress` |
+| `GlassSegmentedRadio` | 组件 | `./creative/GlassSegmentedRadio` |
 
-### Export theme components
+### Export layout
 
-| 导出符号 | 源码 `from` 路径 |
-| --- | --- |
-| `InputTheme` | `./Themes/InputTheme` |
-| `TableTheme` | `./Themes/TableTheme` |
+| 导出符号 | 类别 | 源码 `from` 路径 |
+| --- | --- | --- |
+| `FlexGrid` | 组件 | `./layout/FlexGrid` |
+| `YkContainer` | 组件 | `./layout/YkContainer` |
+| `YkDrawer` | 组件 | `./layout/YkDrawer` |
 
-### Export layout
+### Export theme components
 
-| 导出符号 | 源码 `from` 路径 |
-| --- | --- |
-| `FlexGrid` | `./layout/FlexGrid` |
-| `YkContainer` | `./layout/YkContainer` |
-| `YkDrawer` | `./layout/YkDrawer` |
+| 导出符号 | 类别 | 源码 `from` 路径 |
+| --- | --- | --- |
+| `InputTheme` | 组件 | `./Themes/InputTheme` |
+| `TableTheme` | 组件 | `./Themes/TableTheme` |
 
-### Export common components
+### Export all UI components
 
-| 导出符号 | 源码 `from` 路径 |
-| --- | --- |
-| `Clock` | `./components/Clock` |
-| `DebounceInput` | `./components/DebounceInput` |
-| `MultipleSelect` | `./components/MultipleSelect` |
-| `NumericInput` | `./components/NumericInput` |
-| `RefreshButton` | `./components/RefreshButton` |
-| `SearchWithHistory` | `./components/SearchWithHistory` |
-| `TextWithInput` | `./components/TextWithInput` |
-| `TextWithToolTip` | `./components/TextWithToolTip` |
-| `TreeTransfer` | `./components/TreeTransfer` |
+| 导出符号 | 类别 | 源码 `from` 路径 |
+| --- | --- | --- |
+| `LabelSelect` | 组件 | `./ui/LabelSelect` |
+| `LogicOperator` | 组件 | `./ui/LogicOperator` |
+| `YkButton` | 组件 | `./ui/YkButton` |
+| `YkCard` | 组件 | `./ui/YkCard` |
+| `YkCheckbox` | 组件 | `./ui/YkCheckbox` |
+| `YkDescriptions` | 组件 | `./ui/YkDescriptions` |
+| `YkPagination` | 组件 | `./ui/YkPagination` |
+| `YkRadio` | 组件 | `./ui/YkRadio` |
+| `YkRadioBtnSpecial` | 组件 | `./ui/YkRadioBtnSpecial` |
+| `YkSegmented` | 组件 | `./ui/YkSegmented` |
+| `YkSelect` | 组件 | `./ui/YkSelect` |
+| `YkSpin` | 组件 | `./ui/YkSpin` |
+| `YkStatistic` | 组件 | `./ui/YkStatistic` |
+| `YkSwitch` | 组件 | `./ui/YkSwitch` |
+| `YkTabs` | 组件 | `./ui/YkTabs` |
+| `YkTooltip` | 组件 | `./ui/YkTooltip` |
 
 ## 纯符号列表（便于检索）
 
 ```
-LabelSelect, LogicOperator, YkButton, YkCard, YkCheckbox, YkDescriptions, YkPagination, YkRadio, YkRadioBtnSpecial, YkSegmented, YkSelect, YkSpin, YkStatistic, YkSwitch, YkTabs, YkTooltip, DrawerPageInfo, Editor, Empty, ModCommonFilter, YkPorjectSelect, YkDateRangePicker, YkRangeDateWithVS, YkRangeTimeWithRecent, ButtonRadioWithInfo, ButtonWithProgress, InputTheme, TableTheme, FlexGrid, YkContainer, YkDrawer, Clock, DebounceInput, MultipleSelect, NumericInput, RefreshButton, SearchWithHistory, TextWithInput, TextWithToolTip, TreeTransfer
+AiChat, DrawerPageInfo, Editor, Empty, ModCommonFilter, YkLoginModule, YkPorjectSelect, YkSqlEdit, Clock, DebounceInput, MultipleSelect, NumericInput, RefreshButton, SearchWithHistory, TextWithInput, TextWithToolTip, TreeTransfer, YkDateRangePicker, YkRangeDateWithVS, YkRangeTimeWithRecent, ArcCheckboxProps, ArcCheckbox, ButtonRadioWithInfo, ButtonWithProgress, GlassSegmentedRadio, FlexGrid, YkContainer, YkDrawer, InputTheme, TableTheme, LabelSelect, LogicOperator, YkButton, YkCard, YkCheckbox, YkDescriptions, YkPagination, YkRadio, YkRadioBtnSpecial, YkSegmented, YkSelect, YkSpin, YkStatistic, YkSwitch, YkTabs, YkTooltip
 ```
 

package/README.md

@@ -1,42 +1,40 @@
-# @yoka-ui/ui
-
-数据部前端组件库 - 基于 React 18 + Ant Design 5 的企业级 UI 组件解决方案
-
-**npm 包名**：[`@yoka-ui/ui`](https://www.npmjs.com/package/@yoka-ui/ui)（公网 registry，与 npm 组织 **[yoka-ui](https://www.npmjs.com/org/yoka-ui)** 对应；历史曾用 `@yoka/ui` 等请改为本包名。）
-
-## 安装使用
+## 安装与使用
 
 ### 安装组件库
 
 ```bash
-# npm 公网（推荐与 CI 一致）
+# npm
+npm i @yoka-ui/ui
+
+# 或 pnpm
 pnpm add @yoka-ui/ui
+```
 
-# 安装最新版本（GitLab 源码）
-pnpm add git+http://gitlab.sh.com/web/yoka-ui.git
+### （推荐）配置 Cursor / IDE 规则
 
-# 安装特定版本
-pnpm add git+http://gitlab.sh.com/web/yoka-ui.git#v1.0.9
+在项目的 Cursor rules 中创建文件 `yoka-ui.mdc`，用于约束导入方式与文档入口（导出清单、LLM 索引等）：
 
-# 使用分支（仅推荐开发测试使用）
-pnpm add git+http://gitlab.sh.com/web/yoka-ui.git#main
-```
+```md
+---
+description: 使用 @yoka-ui/ui 时的导入与文档约定
+globs: "**/*.{ts,tsx}"
+alwaysApply: false
+---
 
-### package.json 配置
+# @yoka-ui/ui
 
-```json
-{
-  "dependencies": {
-    "@yoka-ui/ui": "git+http://gitlab.sh.com/web/yoka-ui.git#v1.0.9"
-  }
-}
+- **导入**：仅从 `@yoka-ui/ui` 做**具名** `import`，勿使用未在导出表中出现的符号。
+- **导出清单（权威）**：以安装包内 `node_modules/@yoka-ui/ui/@Docs-yoka/exports.generated.md` 为准，与发布产物类型一致；该文件由 yoka-ui 在导出变更后重新生成。
+- **LLM / 助手入口**：同目录 `node_modules/@yoka-ui/ui/@Docs-yoka/llms.txt`（索引、外链与使用规则摘要）。
+- **API**：不确定 props 时查组件库 Storybook / 源码示例或 README，勿臆造 API；原生 antd 行为对照 [Ant Design 文档](https://ant.design)。
+- **全局样式**：业务入口按需引入，常见为 `import '@yoka-ui/ui/dist/index.less'`（以 `@yoka-ui/ui` 的 README 与当前产物路径为准）。
 ```
 
 ### 基础用法
 
 ```tsx
-import { YkButton, YkCard } from '@yoka-ui/ui';
-import '@yoka-ui/ui/dist/index.less'; // 引入样式
+import { YkButton, YkCard } from "@yoka-ui/ui";
+import "@yoka-ui/ui/dist/index.less"; // 引入样式
 
 function App() {
   return (
@@ -47,13 +45,14 @@ function App() {
 }
 ```
 
-### 按需引入
+### 导入约定（重要）
 
 ```tsx
-// 完整引入
-import { YkButton } from '@yoka-ui/ui';
+// 仅从包入口做“具名导入”
+import { YkPorjectSelect } from "@yoka-ui/ui";
 
-// tree-shaking 会自动排除未使用的组件
+// 具体有哪些符号可用，以 @Docs-yoka/exports.generated.md 为准
+// node_modules/@yoka-ui/ui/@Docs-yoka/exports.generated.md
 ```
 
 ## 组件列表
@@ -116,176 +115,28 @@ import { YkButton } from '@yoka-ui/ui';
 | TextWithInput             | 可编辑文本                                                                                                                                                |
 | TextWithToolTip           | 带提示的文本                                                                                                                                              |
 | TreeTransfer              | 树形穿梭框                                                                                                                                                |
+| **YkDateRangePicker**     | **带「紧凑预设 tag」与「完整 RangePicker」双模式切换的日期范围选择器；8 个内置快捷预设；受控组件；仅允许过去 7 天**                                       |
 | **YkRangeDateWithVS**     | **主时间区间 + 可选「日期对比」（日/周/月 Tab、里程碑、节假日、`rangeDisplayLabel` 等）；内置 `ConfigProvider` 中文 locale 与 dayjs `zh-cn`（周一起算）** |
 | **YkRangeTimeWithRecent** | **时间范围 + 「最近 N 天/周/月」动态语义（Popover + `RangePicker`）；内置中文 locale 与 dayjs `zh-cn`；触发区依赖全局 `iconfont`（如 `icon-date`）**      |
 
 ### 业务组件 (`src/business/`)
 
-| 组件            | 说明                                                |
-| --------------- | --------------------------------------------------- |
-| DrawerPageInfo  | 抽屉页面信息                                        |
-| Editor          | 富文本编辑器                                        |
-| Empty           | 空状态                                              |
-| ModCommonFilter | 通用筛选器                                          |
-| YkPorjectSelect | 项目选择器（搜索、关注、在营/关服 Tab、最近访问等） |
+| 组件            | 说明                                                                 |
+| --------------- | -------------------------------------------------------------------- |
+| DrawerPageInfo  | 抽屉页面信息                                                         |
+| Editor          | 富文本编辑器                                                         |
+| Empty           | 空状态                                                               |
+| ModCommonFilter | 通用筛选器                                                           |
+| YkLoginModule   | 登录组件（当前支持：扫码 / 短信验证码；Tabs 由 `tabs` 配置）          |
+| YkPorjectSelect | 项目选择器（搜索、关注、在营/关服 Tab、最近访问等）                  |
+| YkSqlEdit       | SQL 编辑器（CodeMirror 6：动态参数 `{{...}}` 高亮、关键词/函数补全） |
 
 **导出说明**：业务项目里 `import { ... } from '@yoka-ui/ui'` 可用的符号以 `[src/index.tsx](src/index.tsx)` 为准。若某组件已在源码目录中实现但尚未在入口文件中 `export`，需先在组件库补齐导出并发布后，再在业务侧引用。
 
 ### LLM / 助手文档（`@Docs-yoka`）
 
 - 入口索引：[`@Docs-yoka/llms.txt`](@Docs-yoka/llms.txt)（导航 + 使用约定，结构对齐仓库内 Ant Design [@Docs/llms.txt](@Docs/llms.txt) 思路）。
-- **具名导出表**：[`@Docs-yoka/exports.generated.md`](@Docs-yoka/exports.generated.md) 由脚本根据 `src/index.tsx` 自动生成；修改导出后请执行 `pnpm run generate:yoka-llms`（发版时 `prepack` 会执行一次以保证包内为最新）。
+- **具名导出表**：[`@Docs-yoka/exports.generated.md`](@Docs-yoka/exports.generated.md) 由脚本根据 `src/index.tsx` 自动生成；修改导出后请执行
+  #### `pnpm run generate:yoka-llms`
+  （发版时 `prepack` 会执行一次以保证包内为最新）。
 - 安装 npm 包后路径示例：`node_modules/@yoka-ui/ui/@Docs-yoka/llms.txt`（需 `package.json` 的 `files` 包含 `@Docs-yoka`）。
-
-## 开发指南
-
-### 环境要求
-
-- Node.js >= 18
-- pnpm >= 9 (推荐) 或 npm/yarn
-
-### 安装依赖
-
-```bash
-pnpm install
-```
-
-### 开发组件
-
-```bash
-# 启动 Storybook（推荐）
-pnpm dev
-
-# 或直接
-pnpm storybook
-```
-
-访问 [http://localhost:6006](http://localhost:6006) 查看组件文档
-
-### 构建发布
-
-```bash
-# 构建生产版本
-pnpm build
-
-# 发布新版本
-pnpm release
-```
-
-发布流程：
-
-1. 运行 `pnpm release` 或手动打 tag
-2. `git tag v1.0.9`
-3. `git push origin v1.0.9`
-4. 消费项目通过 `pnpm add git+...#v1.0.9` 更新
-
-### 代码规范
-
-```bash
-# 代码格式化和检查
-pnpm format        # 格式化代码
-pnpm lint         # 检查代码
-pnpm lint:fix     # 自动修复
-
-# 测试
-pnpm test         # 运行测试
-pnpm test:watch   # 监听模式
-```
-
-### 提交代码
-
-使用 commitlint 规范提交：
-
-```bash
-pnpm commit
-```
-
-## 项目结构
-
-```
-src/
-├── ui/                    # UI 基础组件
-│   └── YkButton/
-│       ├── index.tsx          # 组件主文件
-│       ├── index.stories.tsx  # Storybook 文档
-│       └── index.module.less  # 样式文件
-├── components/            # 功能组件（含 YkRangeDateWithVS、YkRangeTimeWithRecent 等）
-├── business/              # 业务组件
-├── creative/              # 创意组件
-└── Themes/                # 主题配置
-```
-
-时间筛选相关 Storybook 入口示例：`功能组件/YkRangeDateWithVS 时间区间与对比`、`功能组件/YkRangeTimeWithRecent 时间范围与最近N天`。
-
-## 组件开发规范
-
-### 新增组件
-
-1. 在对应目录创建组件文件夹
-2. 创建 `index.tsx` 主文件
-3. 创建 `index.stories.tsx` 文档
-4. 在 `src/index.tsx` 中导出
-
-### 代码示例
-
-```tsx
-// src/ui/YourComponent/index.tsx
-import React from 'react';
-import { Button } from 'antd';
-import './index.less';
-
-export interface YourComponentProps {
-  text: string;
-  onClick?: () => void;
-}
-
-const YourComponent: React.FC<YourComponentProps> = ({ text, onClick }) => {
-  return <Button onClick={onClick}>{text}</Button>;
-};
-
-YourComponent.defaultProps = {
-  text: '默认文本',
-};
-
-export default YourComponent;
-```
-
-```tsx
-// src/ui/YourComponent/index.stories.tsx
-import React from 'react';
-import { Story, Meta } from '@storybook/react';
-import YourComponent from './index';
-
-export default {
-  title: 'UI/YourComponent',
-  component: YourComponent,
-} as Meta;
-
-const Template: Story<typeof YourComponent> = (args) => <YourComponent {...args} />;
-
-export const Primary = Template.bind({});
-Primary.args = {
-  text: '按钮文本',
-};
-```
-
-## 技术栈
-
-- **React**: 18.3.1
-- **Ant Design**: 5.29.2
-- **构建工具**: father 4.6.15 + esbuild 0.27.3
-- **组件文档**: Storybook 10.1.11
-- **样式方案**: Less + CSS Modules
-- **代码规范**: ESLint + Prettier + Husky
-
-## 注意事项
-
-1. **样式引入**: 使用组件前需引入 `@yoka-ui/ui/dist/index.less`
-2. **Less 支持**: 确保项目支持 Less，可使用 `less-loader`
-3. **CSS Modules**：`css-loader` 对 `*.module.less` 建议配置 `exportLocalsConvention: 'as-is'`（与源码类名一致）。若使用默认的 `camel-case-only`，部分含连续大写的类名与 `styles.xxx` 可能对不齐；本库相关样式已统一为 `ykRangeDateWithVs`\* 等与默认导出一致的形式。
-4. **版本兼容性**: React 18 + Ant Design 5
-5. **YkRangeDateWithVS / YkRangeTimeWithRecent**：组件内部已挂载 Ant Design `locale={zh_CN}`，并注册 `dayjs` 中文语言包（一周从周一开始），日历/周月面板默认中文；业务侧一般无需再包一层中文 `ConfigProvider`。两类组件的部分图标来自业务全局 **iconfont**（如 `icon-date`、`icon-riqi1`、`icon-guanbi1` 等），需在消费项目中引入对应字体样式。
-
-## 许可证
-
-MIT - 仅供内部项目使用

package/dist/es/business/AiChat/index.d.ts

@@ -9,8 +9,8 @@ export interface AiChatProps extends AiChatConfig, Partial<EnhancedAiChatConfig>
 }
 declare const AiChat: FC<AiChatProps>;
 export default AiChat;
+export { generateSuggestions, isTaskCreationIntent, parseTaskDescription, recognizeIntent } from './intentRecognizer';
+export { delay, NavigationManager } from './navigationManager';
+export type { AiChatConfig, ChatSession, EnhancedAiChatConfig, Intent, IntentType, Message, NavigationOptions, Task, TaskCategory, TaskCreationResult, TaskPriority, TaskStatus, UseAiChatOptions, UseAiChatReturn, } from './type';
 export { useAiChat } from './useAiChat';
 export { useTaskWorkflow } from './useTaskWorkflow';
-export { recognizeIntent, generateSuggestions, isTaskCreationIntent, parseTaskDescription } from './intentRecognizer';
-export { NavigationManager, delay } from './navigationManager';
-export type { AiChatConfig, ChatSession, Message, UseAiChatOptions, UseAiChatReturn, Intent, IntentType, Task, TaskCategory, TaskPriority, TaskStatus, TaskCreationResult, NavigationOptions, EnhancedAiChatConfig, } from './type';