@hbdlzy/ui-core 0.1.7 → 0.1.9

package/src/components/BaseTable/BaseTable.vue.d.ts

@@ -0,0 +1,157 @@
+import type { BaseTableCellPayload, BaseTableColumn, BaseTableCssValue, BaseTableHeaderSearchValue, BaseTableLoadedPayload, BaseTablePagination, BaseTableProps, BaseTableRowActionPayload, BaseTableSortPayload } from './BaseTable.types';
+type BaseTableRow = Record<string, any>;
+declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<BaseTableProps<Record<string, any>>>, {
+    data: () => never[];
+    requestParams: () => {};
+    autoLoad: boolean;
+    reloadOnParamsChange: boolean;
+    reloadOnSortChange: boolean;
+    rowKey: string;
+    height: string;
+    border: boolean;
+    stripe: boolean;
+    showToolbar: boolean;
+    showPagination: boolean;
+    hasSelection: boolean;
+    hasIndex: boolean;
+    indexLabel: string;
+    indexWidth: number;
+    selectionWidth: number;
+    pagination: () => {};
+    currentPageKey: string;
+    pageSizeKey: string;
+    defaultSort: () => {
+        prop: undefined;
+        order: null;
+    };
+    sortFieldKey: string;
+    sortOrderKey: string;
+    sortOrderMap: () => {
+        ascending: string;
+        descending: string;
+    };
+    emptyText: string;
+    loadingText: string;
+}>>, {
+    load: (data?: Record<string, any>[] | undefined) => Promise<void>;
+    refresh: () => Promise<void>;
+    setData: (data: Record<string, any>[]) => void;
+    resetPage: () => Promise<void>;
+    setHeaderSearchValue: (key: string, value: BaseTableHeaderSearchValue, shouldReload?: boolean | undefined) => Promise<void>;
+    resetHeaderSearch: (key?: string | undefined) => Promise<void>;
+    getHeaderSearchValues: () => Record<string, BaseTableHeaderSearchValue>;
+    clearSelection: () => void;
+    toggleRowSelection: (row: Record<string, any>, selected?: boolean | undefined) => void;
+    getSelectionRows: () => Record<string, any>[];
+    getRows: () => Record<string, any>[];
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "selection-change": (rows: BaseTableRow[]) => void;
+    "sort-change": (payload: BaseTableSortPayload<Record<string, any>>) => void;
+    "row-action": (payload: BaseTableRowActionPayload<Record<string, any>>) => void;
+    "cell-click": (payload: BaseTableCellPayload<Record<string, any>>) => void;
+    "cell-input": (payload: BaseTableCellPayload<Record<string, any>>) => void;
+    "page-change": (currentPage: number) => void;
+    "size-change": (pageSize: number) => void;
+    "update:pagination": (pagination: BaseTablePagination) => void;
+    loaded: (payload: BaseTableLoadedPayload<Record<string, any>>) => void;
+    "request-error": (error: unknown) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<BaseTableProps<Record<string, any>>>, {
+    data: () => never[];
+    requestParams: () => {};
+    autoLoad: boolean;
+    reloadOnParamsChange: boolean;
+    reloadOnSortChange: boolean;
+    rowKey: string;
+    height: string;
+    border: boolean;
+    stripe: boolean;
+    showToolbar: boolean;
+    showPagination: boolean;
+    hasSelection: boolean;
+    hasIndex: boolean;
+    indexLabel: string;
+    indexWidth: number;
+    selectionWidth: number;
+    pagination: () => {};
+    currentPageKey: string;
+    pageSizeKey: string;
+    defaultSort: () => {
+        prop: undefined;
+        order: null;
+    };
+    sortFieldKey: string;
+    sortOrderKey: string;
+    sortOrderMap: () => {
+        ascending: string;
+        descending: string;
+    };
+    emptyText: string;
+    loadingText: string;
+}>>> & Readonly<{
+    "onSelection-change"?: ((rows: BaseTableRow[]) => any) | undefined;
+    "onSort-change"?: ((payload: BaseTableSortPayload<Record<string, any>>) => any) | undefined;
+    "onRow-action"?: ((payload: BaseTableRowActionPayload<Record<string, any>>) => any) | undefined;
+    "onCell-click"?: ((payload: BaseTableCellPayload<Record<string, any>>) => any) | undefined;
+    "onCell-input"?: ((payload: BaseTableCellPayload<Record<string, any>>) => any) | undefined;
+    "onPage-change"?: ((currentPage: number) => any) | undefined;
+    "onSize-change"?: ((pageSize: number) => any) | undefined;
+    "onUpdate:pagination"?: ((pagination: BaseTablePagination) => any) | undefined;
+    onLoaded?: ((payload: BaseTableLoadedPayload<Record<string, any>>) => any) | undefined;
+    "onRequest-error"?: ((error: unknown) => any) | undefined;
+}>, {
+    data: Record<string, any>[];
+    border: boolean;
+    requestParams: Record<string, unknown>;
+    autoLoad: boolean;
+    reloadOnParamsChange: boolean;
+    reloadOnSortChange: boolean;
+    rowKey: string;
+    height: BaseTableCssValue;
+    stripe: boolean;
+    showToolbar: boolean;
+    showPagination: boolean;
+    hasSelection: boolean;
+    hasIndex: boolean;
+    indexLabel: string;
+    indexWidth: BaseTableCssValue;
+    selectionWidth: BaseTableCssValue;
+    pagination: Partial<BaseTablePagination>;
+    currentPageKey: string;
+    pageSizeKey: string;
+    defaultSort: import("./BaseTable.types").BaseTableSortState;
+    sortFieldKey: string;
+    sortOrderKey: string;
+    sortOrderMap: import("./BaseTable.types").BaseTableSortOrderMap;
+    emptyText: string;
+    loadingText: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>, Partial<Record<string, (_: any) => any>> & Partial<Record<string, (_: {
+    row: any;
+    columnConfig: BaseTableColumn<Record<string, any>>;
+    columnIndex: any;
+    value: any;
+}) => any>> & {
+    toolbar?(_: {}): any;
+}>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_Prettify<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+type __VLS_Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/src/components/BaseTable/README.md

@@ -251,13 +251,14 @@ const columns = [
       type: 'select',
       placeholder: '请选择状态',
       width: 220,
+      filterable: true,
       searchText: '筛选'
     }
   }
 ]
 ```
 
-下拉筛选默认复用当前列的 `options`，也可以在 `headerSearch.options` 中单独传入选项。需要多选时可以配置 `multiple: true`，请求参数会以数组形式传出。
+下拉筛选默认复用当前列的 `options`，也可以在 `headerSearch.options` 中单独传入选项。需要搜索下拉选项时配置 `filterable: true`，会启用 Element Plus `el-select` 原生搜索能力。需要多选时可以配置 `multiple: true`，请求参数会以数组形式传出。
 
 ### 多选下拉筛选写法
 
@@ -316,13 +317,86 @@ const columns = [
 
 级联筛选默认使用 `children` 作为子级字段，可以通过 `optionChildrenKey` 改写；请求参数会以完整路径数组传出，例如 `{ regionPath: ['north', 'beijing', 'chaoyang'] }`。
 
+### 时间筛选写法
+
+```ts
+const columns = [
+  {
+    label: '创建日期',
+    prop: 'createdDate',
+    headerSearch: {
+      type: 'date',
+      placeholder: '请选择日期',
+      valueFormat: 'YYYY-MM-DD',
+      searchText: '筛选'
+    }
+  },
+  {
+    label: '创建时间',
+    prop: 'createdAt',
+    headerSearch: {
+      type: 'datetime',
+      placeholder: '请选择时间',
+      valueFormat: 'YYYY-MM-DD HH:mm:ss',
+      searchText: '筛选'
+    }
+  },
+  {
+    label: '执行时刻',
+    prop: 'runTime',
+    headerSearch: {
+      type: 'time',
+      placeholder: '请选择时刻',
+      valueFormat: 'HH:mm:ss',
+      searchText: '筛选'
+    }
+  }
+]
+```
+
+`date`、`datetime` 会使用 Element Plus `el-date-picker`，`time` 会使用 `el-time-picker`。`format` 控制展示格式，`valueFormat` 控制筛选值和请求参数值。
+
+### 时间范围筛选写法
+
+```ts
+const columns = [
+  {
+    label: '创建时间',
+    prop: 'createdAt',
+    headerSearch: {
+      type: 'datetimerange',
+      paramKey: 'createdAtRange',
+      startPlaceholder: '开始',
+      endPlaceholder: '结束',
+      valueFormat: 'YYYY-MM-DD HH:mm:ss',
+      searchText: '筛选'
+    }
+  },
+  {
+    label: '执行时间段',
+    prop: 'runTime',
+    headerSearch: {
+      type: 'timerange',
+      paramKey: 'runTimeRange',
+      startPlaceholder: '开始',
+      endPlaceholder: '结束',
+      valueFormat: 'HH:mm:ss',
+      searchText: '筛选'
+    }
+  }
+]
+```
+
+范围类型支持 `daterange`、`datetimerange`、`timerange`，请求参数会以数组形式传出，例如 `{ createdAtRange: ['2026-04-01 00:00:00', '2026-04-30 23:59:59'] }`。
+
 ### 行为说明
 
 - 远程模式下，列头搜索值会自动合并到 `request(params)` 的参数里
 - 触发搜索或重置时，会自动把页码重置到第一页
 - 如果配置了 `paramKey`，请求参数会优先使用它
 - 如果没有配置 `paramKey`，默认使用当前列的 `prop`
-- 本地数据模式下，输入搜索会对当前 `data` 做简单文本包含过滤，下拉筛选会按选项值精确匹配，级联筛选会按路径前缀匹配
+- 表头搜索面板打开后，点击表格外或页面其他区域会自动关闭
+- 本地数据模式下，输入搜索会对当前 `data` 做简单文本包含过滤，下拉筛选会按选项值精确匹配，级联筛选会按路径前缀匹配，时间范围会按起止时间包含过滤
 - 多个开启搜索的列会按“同时满足”处理
 
 示例请求参数：
@@ -465,3 +539,48 @@ tableRef.value?.resetHeaderSearch()
 - 默认优先使用列配置驱动，只有复杂单元格才使用插槽
 - 通用操作列尽量统一收敛到 `row-action`
 - 复杂筛选表单不要内置到表格组件里，统一通过 `toolbar` 扩展
+
+## AI 使用指引
+
+AI 在生成列表页、管理页、日志页、明细页时，应优先使用 `BaseTable`，不要在页面里重复封装 `el-table + el-pagination + loading + request + sort + selection`。
+
+推荐优先从统一入口导入：
+
+```ts
+import { BaseTable, type BaseTableColumn, type BaseTableExpose } from '@hbdlzy/ui'
+```
+
+如果当前只安装了核心包，也可以从 `@hbdlzy/ui-core` 导入。
+
+AI 生成代码时按下面顺序判断：
+
+1. 先定义业务行类型 `RowItem`
+2. 再定义 `BaseTableColumn<RowItem>[]`
+3. 本地静态数据用 `data`
+4. 远程分页数据用 `request`，不要把 `listUrl` 字符串直接塞给组件
+5. 接口返回结构不统一时，用 `resultAdapter` 映射成 `{ rows, total }`
+6. 顶部筛选表单放进 `toolbar` 插槽
+7. 行操作统一配置 `kind: 'actions'`，通过 `@row-action` 承接
+8. 复杂单元格才使用 `cell-${prop}` 插槽
+
+AI 不应该做这些事：
+
+- 不要在页面里重新写分页状态、页码变化、每页条数变化和远程加载逻辑
+- 不要在页面里重复写通用排序参数映射，优先使用 `sortFieldKey`、`sortOrderKey`、`sortMapper`
+- 不要为常见状态标签、图片、链接、操作列重复写模板，优先使用 `kind`
+- 不要把复杂业务筛选塞进列头搜索，复杂筛选应放在 `toolbar`
+- 不要绕过 `BaseTableExpose` 直接操作内部 `el-table`
+
+旧项目迁移时，AI 可以按这个映射处理：
+
+- `columnsList` 迁移为 `columns`
+- `listUrl + paramsData` 迁移为 `request + requestParams`
+- `isSearch / isFilter / isCity` 迁移为 `headerSearch`
+- `actions` 迁移为 `kind: 'actions'`
+- `@handleAction` 迁移为 `@row-action`
+
+生成代码前建议同时读取：
+
+- `packages/ui-core/components.manifest.json`
+- `packages/ui-core/src/components/BaseTable/BaseTable.types.ts`
+- 本 README 的 `Props / Column 能力 / Events / Expose` 部分

package/src/components/BaseTable/index.d.ts

@@ -0,0 +1,3 @@
+import BaseTable from './BaseTable.vue';
+export default BaseTable;
+export type { BaseTableAction, BaseTableAlign, BaseTableCellPayload, BaseTableColumn, BaseTableColumnKind, BaseTableCssValue, BaseTableExpose, BaseTableHeaderSearchConfig, BaseTableHeaderSearchPathValue, BaseTableHeaderSearchPrimitiveValue, BaseTableHeaderSearchType, BaseTableHeaderSearchValue, BaseTableLoadedPayload, BaseTableNormalizedResult, BaseTableOption, BaseTablePagination, BaseTableProps, BaseTableResultAdapter, BaseTableRequestHandler, BaseTableRequestParams, BaseTableRequestResult, BaseTableRowActionPayload, BaseTableSortOrder, BaseTableSortPayload } from './BaseTable.types';

package/src/components/OutlinedCascader/OutlinedCascader.types.d.ts

@@ -0,0 +1,28 @@
+export type OutlinedCascaderCssValue = string | number;
+export type OutlinedCascaderValue = Array<string | number>;
+export interface OutlinedCascaderProps {
+    value?: OutlinedCascaderValue;
+    options?: Record<string, unknown>[];
+    clearable?: boolean;
+    propsValue?: Record<string, unknown>;
+    placeholder?: string;
+    label?: string;
+    popperClass?: string;
+    disabled?: boolean;
+    inputHeight?: number;
+    isBorder?: boolean;
+    filterable?: boolean;
+    levels?: boolean;
+    marginBottom?: OutlinedCascaderCssValue;
+    paddingTop?: OutlinedCascaderCssValue;
+    required?: boolean;
+    error?: boolean;
+    errorMessage?: string;
+}
+export interface OutlinedCascaderExpose {
+    focus: () => void;
+    blur: () => void;
+    togglePopperVisible: () => void;
+    clear: () => void;
+    getCascaderRef: () => unknown | null;
+}

package/src/components/OutlinedCascader/OutlinedCascader.vue.d.ts

@@ -0,0 +1,94 @@
+import type { OutlinedCascaderCssValue, OutlinedCascaderProps, OutlinedCascaderValue } from './OutlinedCascader.types';
+declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<OutlinedCascaderProps>, {
+    value: () => never[];
+    options: () => never[];
+    clearable: boolean;
+    propsValue: undefined;
+    placeholder: string;
+    label: string;
+    popperClass: string;
+    disabled: boolean;
+    inputHeight: number;
+    isBorder: boolean;
+    filterable: boolean;
+    levels: boolean;
+    marginBottom: number;
+    paddingTop: number;
+    required: boolean;
+    error: boolean;
+    errorMessage: string;
+}>>, {
+    focus: () => void;
+    blur: () => void;
+    togglePopperVisible: () => void;
+    clear: () => void;
+    getCascaderRef: () => unknown;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    input: (value: OutlinedCascaderValue) => void;
+    "update:value": (value: OutlinedCascaderValue) => void;
+    change: (value: OutlinedCascaderValue) => void;
+    focus: (value: FocusEvent) => void;
+    blur: (value: FocusEvent) => void;
+    "visible-change": (value: boolean) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<OutlinedCascaderProps>, {
+    value: () => never[];
+    options: () => never[];
+    clearable: boolean;
+    propsValue: undefined;
+    placeholder: string;
+    label: string;
+    popperClass: string;
+    disabled: boolean;
+    inputHeight: number;
+    isBorder: boolean;
+    filterable: boolean;
+    levels: boolean;
+    marginBottom: number;
+    paddingTop: number;
+    required: boolean;
+    error: boolean;
+    errorMessage: string;
+}>>> & Readonly<{
+    onBlur?: ((value: FocusEvent) => any) | undefined;
+    onChange?: ((value: OutlinedCascaderValue) => any) | undefined;
+    onFocus?: ((value: FocusEvent) => any) | undefined;
+    onInput?: ((value: OutlinedCascaderValue) => any) | undefined;
+    "onUpdate:value"?: ((value: OutlinedCascaderValue) => any) | undefined;
+    "onVisible-change"?: ((value: boolean) => any) | undefined;
+}>, {
+    error: boolean;
+    label: string;
+    disabled: boolean;
+    required: boolean;
+    popperClass: string;
+    value: OutlinedCascaderValue;
+    placeholder: string;
+    filterable: boolean;
+    clearable: boolean;
+    options: Record<string, unknown>[];
+    errorMessage: string;
+    inputHeight: number;
+    isBorder: boolean;
+    marginBottom: OutlinedCascaderCssValue;
+    paddingTop: OutlinedCascaderCssValue;
+    propsValue: Record<string, unknown>;
+    levels: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_Prettify<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+type __VLS_Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};

package/src/components/OutlinedCascader/README.md

@@ -92,3 +92,37 @@ const areaOptions = [
 - 组件只负责通用级联选择壳子和交互状态，不直接耦合区域接口、组织树接口等业务数据源
 - 页面层如果需要多选级联、懒加载或复杂回填逻辑，优先先通过 `propsValue` 和插值配置解决
 - 如果业务需要固定某种树结构，可以在业务包里再封一层领域组件，而不是反向污染 `ui-core`
+
+## AI 使用指引
+
+AI 在生成区域、组织、站点、分类等级联选择项时，应优先使用 `OutlinedCascader`，不要重复封装 `el-cascader` 的浮动标签、面板显隐和清空逻辑。
+
+推荐优先从统一入口导入：
+
+```ts
+import { OutlinedCascader, type OutlinedCascaderExpose } from '@hbdlzy/ui'
+```
+
+如果当前只安装了核心包，也可以从 `@hbdlzy/ui-core` 导入。
+
+AI 生成代码时按下面顺序判断：
+
+1. 选项为标准 `label/value/children` 时直接传 `options`
+2. 后端字段不同，优先通过 `propsValue` 映射，不要先复制转换一份树
+3. 需要搜索时传 `filterable`
+4. 需要展示完整路径时保持 `levels` 为 `true`
+5. 需要下边框风格，传 `:is-border="true"`
+6. 需要手动打开、关闭、清空时，使用 `ref<OutlinedCascaderExpose>`
+
+AI 不应该做这些事：
+
+- 不要为普通级联选择重复写 `el-cascader` 外壳
+- 不要把区域接口、组织接口请求逻辑写进基础组件
+- 不要为了字段映射在页面层重复转换大树，优先使用 `propsValue`
+- 不要把业务固定层级、路径拼接规则塞回 `ui-core`
+
+生成代码前建议同时读取：
+
+- `packages/ui-core/components.manifest.json`
+- `packages/ui-core/src/components/OutlinedCascader/OutlinedCascader.types.ts`
+- 本 README 的 `Props / Emits / Expose` 部分

package/src/components/OutlinedCascader/index.d.ts

@@ -0,0 +1,3 @@
+import OutlinedCascader from './OutlinedCascader.vue';
+export default OutlinedCascader;
+export type { OutlinedCascaderCssValue, OutlinedCascaderExpose, OutlinedCascaderProps, OutlinedCascaderValue } from './OutlinedCascader.types';

package/src/components/OutlinedDatePicker/OutlinedDatePicker.types.d.ts

@@ -0,0 +1,30 @@
+export type OutlinedDatePickerCssValue = string | number;
+export type OutlinedDatePickerValue = string | number | Date | Array<string | number | Date> | null;
+export type OutlinedDatePickerDisabledDate = string | number | Date | ((date: Date) => boolean);
+export interface OutlinedDatePickerProps {
+    value?: OutlinedDatePickerValue;
+    placeholder?: string;
+    label?: string;
+    disabled?: boolean;
+    timeValue?: boolean;
+    typeDate?: string;
+    format?: string;
+    valueFormat?: string;
+    showPassword?: boolean;
+    multiple?: boolean;
+    inputHeight?: number;
+    isBorder?: boolean;
+    disabledDate?: OutlinedDatePickerDisabledDate;
+    marginBottom?: OutlinedDatePickerCssValue;
+    paddingTop?: OutlinedDatePickerCssValue;
+    required?: boolean;
+    error?: boolean;
+    errorMessage?: string;
+}
+export interface OutlinedDatePickerExpose {
+    focus: () => void;
+    blur: () => void;
+    handleOpen: () => void;
+    handleClose: () => void;
+    getPickerRef: () => unknown | null;
+}

package/src/components/OutlinedDatePicker/OutlinedDatePicker.vue.d.ts

@@ -0,0 +1,97 @@
+import type { OutlinedDatePickerCssValue, OutlinedDatePickerDisabledDate, OutlinedDatePickerProps, OutlinedDatePickerValue } from './OutlinedDatePicker.types';
+declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<OutlinedDatePickerProps>, {
+    value: string;
+    placeholder: string;
+    label: string;
+    disabled: boolean;
+    timeValue: boolean;
+    typeDate: string;
+    format: string;
+    valueFormat: string;
+    showPassword: boolean;
+    multiple: boolean;
+    inputHeight: number;
+    isBorder: boolean;
+    disabledDate: undefined;
+    marginBottom: number;
+    paddingTop: number;
+    required: boolean;
+    error: boolean;
+    errorMessage: string;
+}>>, {
+    focus: () => void;
+    blur: () => void;
+    handleOpen: () => void;
+    handleClose: () => void;
+    getPickerRef: () => unknown;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    input: (value: OutlinedDatePickerValue) => void;
+    "update:value": (value: OutlinedDatePickerValue) => void;
+    change: (value: OutlinedDatePickerValue) => void;
+    focus: (value: FocusEvent) => void;
+    blur: (value: FocusEvent) => void;
+    "visible-change": (value: boolean) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<OutlinedDatePickerProps>, {
+    value: string;
+    placeholder: string;
+    label: string;
+    disabled: boolean;
+    timeValue: boolean;
+    typeDate: string;
+    format: string;
+    valueFormat: string;
+    showPassword: boolean;
+    multiple: boolean;
+    inputHeight: number;
+    isBorder: boolean;
+    disabledDate: undefined;
+    marginBottom: number;
+    paddingTop: number;
+    required: boolean;
+    error: boolean;
+    errorMessage: string;
+}>>> & Readonly<{
+    onBlur?: ((value: FocusEvent) => any) | undefined;
+    onChange?: ((value: OutlinedDatePickerValue) => any) | undefined;
+    onFocus?: ((value: FocusEvent) => any) | undefined;
+    onInput?: ((value: OutlinedDatePickerValue) => any) | undefined;
+    "onUpdate:value"?: ((value: OutlinedDatePickerValue) => any) | undefined;
+    "onVisible-change"?: ((value: boolean) => any) | undefined;
+}>, {
+    error: boolean;
+    label: string;
+    disabled: boolean;
+    required: boolean;
+    format: string;
+    value: OutlinedDatePickerValue;
+    placeholder: string;
+    multiple: boolean;
+    valueFormat: string;
+    errorMessage: string;
+    showPassword: boolean;
+    inputHeight: number;
+    isBorder: boolean;
+    marginBottom: OutlinedDatePickerCssValue;
+    paddingTop: OutlinedDatePickerCssValue;
+    timeValue: boolean;
+    typeDate: string;
+    disabledDate: OutlinedDatePickerDisabledDate;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_Prettify<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+type __VLS_Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};

package/src/components/OutlinedDatePicker/README.md

@@ -138,3 +138,37 @@ const form = reactive({
 - 普通日期和日期时间选择器优先使用 `OutlinedDatePicker`
 - 默认通过 `typeDate + format` 收敛常见场景
 - 自定义日期禁用规则优先使用 `disabledDate`，不要在页面层重复封装相同逻辑
+
+## AI 使用指引
+
+AI 在生成日期选择项时，如果页面需要浮动标签、统一高度、日期禁用规则或兼容旧项目 `v-model:value`，应优先使用 `OutlinedDatePicker`。
+
+推荐优先从统一入口导入：
+
+```ts
+import { OutlinedDatePicker, type OutlinedDatePickerExpose } from '@hbdlzy/ui'
+```
+
+如果当前只安装了核心包，也可以从 `@hbdlzy/ui-core` 导入。
+
+AI 生成代码时按下面顺序判断：
+
+1. 普通日期使用 `type-date="date"` 和默认 `YYYY-MM-DD`
+2. 日期时间使用 `type-date="datetime"`，同步设置 `format` 和必要的 `valueFormat`
+3. 日期范围继续透传 Element Plus 原生 `type` 能力时，要确认 `value` 类型为数组
+4. 禁止选择今天之前的日期时，优先使用 `:disabled-date="'nowDate'"`
+5. 更复杂禁用规则传函数，不要在页面里包一层重复组件
+6. 需要手动打开或关闭面板时，使用 `ref<OutlinedDatePickerExpose>`
+
+AI 不应该做这些事：
+
+- 不要重新封装基础 `el-date-picker` 只为实现浮动标签
+- 不要在多个页面复制相同的禁用日期判断
+- 不要混用 `format` 和 `valueFormat` 导致展示值、提交值不一致
+- 不要把业务接口逻辑塞进日期组件
+
+生成代码前建议同时读取：
+
+- `packages/ui-core/components.manifest.json`
+- `packages/ui-core/src/components/OutlinedDatePicker/OutlinedDatePicker.types.ts`
+- 本 README 的 `Props / Events / Expose / 透传规则` 部分

package/src/components/OutlinedDatePicker/index.d.ts

@@ -0,0 +1,3 @@
+import OutlinedDatePicker from './OutlinedDatePicker.vue';
+export default OutlinedDatePicker;
+export type { OutlinedDatePickerCssValue, OutlinedDatePickerDisabledDate, OutlinedDatePickerExpose, OutlinedDatePickerProps, OutlinedDatePickerValue } from './OutlinedDatePicker.types';

package/src/components/OutlinedDateTimePicker/OutlinedDateTimePicker.types.d.ts

@@ -0,0 +1,29 @@
+export type OutlinedDateTimePickerCssValue = string | number;
+export type OutlinedDateTimePickerValue = string;
+export type OutlinedDateTimePickerDisabledDate = string | number | Date | ((date: Date) => boolean);
+export interface OutlinedDateTimePickerProps {
+    value?: OutlinedDateTimePickerValue;
+    placeholder?: string;
+    label?: string;
+    inputHeight?: number;
+    isBorder?: boolean;
+    disabledDate?: OutlinedDateTimePickerDisabledDate;
+    separatorText?: string;
+    timePlaceholder?: string;
+    clearable?: boolean;
+    marginBottom?: OutlinedDateTimePickerCssValue;
+    paddingTop?: OutlinedDateTimePickerCssValue;
+    required?: boolean;
+    error?: boolean;
+    errorMessage?: string;
+}
+export interface OutlinedDateTimePickerExpose {
+    focusDate: () => void;
+    focusTime: () => void;
+    blurDate: () => void;
+    blurTime: () => void;
+    openDatePanel: () => void;
+    openTimePanel: () => void;
+    getDatePickerRef: () => unknown | null;
+    getTimePickerRef: () => unknown | null;
+}