yahee-components 0.0.83 → 0.0.85

package/readme.md

@@ -1,249 +1,249 @@
-# yahee-components Library
-
-深圳前海亚讯公司，使用 Vue 3 和 Vite 构建的前端组件库。它结合 TypeScript 提供类型支持，并集成了 prettier+husky+lint-staged 以确保代码质量。
-
-## 目录
-
-- [特性](#特性)
-- [安装](#安装)
-- [快速开始](#快速开始)
-- [组件](#组件)
-- [开发指南](#开发指南)
-- [代码规范](#代码规范)
-- [文档](#文档)
-- [常见问题](#常见问题)
-- [贡献](#贡献)
-- [许可证](#许可证)
-
-## 特性
-
-- **现代化技术栈**：基于 Vue 3 和 Vite，支持快速开发。
-- **TypeScript 支持**：提供类型安全。
-- **代码质量保障**：使用 ESLint、Prettier 和 lint-staged。
-- **易于集成**：与现有项目无缝结合。
-
-## 安装
-
-使用 npm 安装：
-
-```bash
-npm install yahee-components
-```
-
-或使用 Yarn：
-
-```bash
-yarn add yahee-components
-```
-
-## 快速开始
-
-在你的 Vue 项目中引入并使用组件：
-
-```javascript
-import { YaheeComplexSearch } from 'yahee-components';
-import 'yahee-components/es/style.css';
-<template>
-  <YaheeComplexSearch
-    :show-within-filter-checkbox="true"
-    :show-patch-search="true"
-    :placeholder-text="`${M2('PD单号')}/${M2('SKU')}/${M2('SKU别名')}`"
-    :show-select="false"
-    :search-item="searchItem"
-    @filter-change-grandson="filterChangeGrandson"
-  />
-</template>
-```
-
-## 组件
-
-### YaheeAnnexUpload
-
-文件上传组件，支持文件类型、文件数量、文件大小、文件单位等参数自定义
-
-```html
-<template>
-  <yahee-annex-upload
-    v-model="fileValue"
-    :accept=".gif,.jpg,.png,.doc,.docx,.pdf,.xls,.xlsx"
-    :limit="1"
-    :fileSize="20"
-    :fileSizeUnit="mb"
-  />
-</template>
-```
-
-### YaheeComplexSearch
-
-复杂搜索组件，支持是否展示多选下拉框、是否展示批量搜索、是否在筛选条件内搜索等参数自定义，并emit筛选条件给父组件监听以完成筛选
-
-```html
-<template>
-  <yahee-complex-search
-    :show-within-filter-checkbox="true"
-    :show-patch-search="true"
-    :show-select="false"
-    :search-item="searchItem"
-    @filter-change-grandson="filterChange"
-  />
-</template>
-```
-
-### YaheeCountryPlatformShopCondition
-
-销量等级二维筛选组件。
-
-```html
-<template>
-  <yahee-country-platform-shop-condition
-    :xy-filters="filterList"
-    filter-key="saleLevels"
-    @filter-change="filterChange"
-  />
-</template>
-```
-
-### YaheeImageUpload
-
-图片上传组件，支持图片大小、图片单位等参数自定义
-
-```html
-<template>
-  <yahee-image-upload v-model="imageValue" />
-</template>
-```
-
-### YaheeCopy
-
-复制组件
-
-```html
-<template>
-  <yahee-copy content="121212">复制</yahee-copy>
-</template>
-```
-
-### YaheeDropdownCondition
-
-下拉筛选项组件，支持传入父组件函数，用以接受选择的筛选项参数
-
-```html
-<template>
-  <yahee-drop-down-condition
-    filter-key="series"
-    enum-entity="category-series"
-    @filter-change="filterChange"
-  />
-</template>
-```
-
-### YaheeLeftCondition
-
-普通单选筛选项组件，支持传入父组件函数，用以接受选择的筛选项参数
-
-```html
-<template>
-  <YaheeLeftCondition
-    ref="bigGroupRef"
-    :select-list="categoryManagers"
-    :all-is-empty="true"
-    filter-key="categoryManager"
-    @filter-change="filterChange"
-  />
-</template>
-```
-
-### YaheeLeftConditionEnum
-
-普通单选筛选项组件，与上面组件不同的是，选项内容通过接口进行查询，同时也支持传入父组件函数，用以接受选择的筛选项参数
-
-```html
-<template>
-  <YaheeLeftConditionEnum
-    enum-entity="country"
-    filter-key="country"
-    :all-is-empty="true"
-    :init-filters="initFilters"
-    @filter-change="filterChange"
-  />
-</template>
-```
-### YaheeOperationLog
-
-操作日志组件，支持下拉加载，通过业务参数获取不同操作日志
-
-```html
-<template>
-  <YaheeLeftConditionEnum
-    enum-entity="country"
-    filter-key="country"
-    :all-is-empty="true"
-    :init-filters="initFilters"
-    @filter-change="filterChange"
-  />
-</template>
-```
-
-## 开发指南
-
-### 本地开发
-
-克隆仓库并安装依赖：
-
-```bash
-git clone 
-cd your-local-download-directory
-pnpm install
-```
-
-启动开发服务器：
-
-```bash
-yarn dev
-```
-
-### 构建
-
-构建生产版本：
-
-```bash
-cd packages/components
-npm run build
-```
-
-### 发布
-
-登录npm后
-
-```bash
-npm publish --access public
-```
-
-## 代码规范
-
-- 使用 ESLint 和 Prettier 格式化代码。
-- 提交前使用 lint-staged 进行检查。
-
-## 文档
-
-详细的 API 文档请参阅项目内docs文件夹下的文档。
-
-## 常见问题
-
-### 如何报告问题？
-
-请联系维护人menglingnan/zhangyujiao/smithshi提交问题。
-
-## 贡献
-
-欢迎贡献！请确保遵循以下步骤：
-
-1. Fork 仓库
-2. 创建你的特性分支 (`git checkout -b feature/AmazingFeature`)
-3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
-4. 推送到分支 (`git push origin feature/AmazingFeature`)
-5. 打开一个 Pull Request
-
-## 许可证
-
-该项目采用 MIT 许可证。
+# yahee-components Library
+
+深圳前海亚讯公司，使用 Vue 3 和 Vite 构建的前端组件库。它结合 TypeScript 提供类型支持，并集成了 prettier+husky+lint-staged 以确保代码质量。
+
+## 目录
+
+- [特性](#特性)
+- [安装](#安装)
+- [快速开始](#快速开始)
+- [组件](#组件)
+- [开发指南](#开发指南)
+- [代码规范](#代码规范)
+- [文档](#文档)
+- [常见问题](#常见问题)
+- [贡献](#贡献)
+- [许可证](#许可证)
+
+## 特性
+
+- **现代化技术栈**：基于 Vue 3 和 Vite，支持快速开发。
+- **TypeScript 支持**：提供类型安全。
+- **代码质量保障**：使用 ESLint、Prettier 和 lint-staged。
+- **易于集成**：与现有项目无缝结合。
+
+## 安装
+
+使用 npm 安装：
+
+```bash
+npm install yahee-components
+```
+
+或使用 Yarn：
+
+```bash
+yarn add yahee-components
+```
+
+## 快速开始
+
+在你的 Vue 项目中引入并使用组件：
+
+```javascript
+import { YaheeComplexSearch } from 'yahee-components';
+import 'yahee-components/es/style.css';
+<template>
+  <YaheeComplexSearch
+    :show-within-filter-checkbox="true"
+    :show-patch-search="true"
+    :placeholder-text="`${M2('PD单号')}/${M2('SKU')}/${M2('SKU别名')}`"
+    :show-select="false"
+    :search-item="searchItem"
+    @filter-change-grandson="filterChangeGrandson"
+  />
+</template>
+```
+
+## 组件
+
+### YaheeAnnexUpload
+
+文件上传组件，支持文件类型、文件数量、文件大小、文件单位等参数自定义
+
+```html
+<template>
+  <yahee-annex-upload
+    v-model="fileValue"
+    :accept=".gif,.jpg,.png,.doc,.docx,.pdf,.xls,.xlsx"
+    :limit="1"
+    :fileSize="20"
+    :fileSizeUnit="mb"
+  />
+</template>
+```
+
+### YaheeComplexSearch
+
+复杂搜索组件，支持是否展示多选下拉框、是否展示批量搜索、是否在筛选条件内搜索等参数自定义，并emit筛选条件给父组件监听以完成筛选
+
+```html
+<template>
+  <yahee-complex-search
+    :show-within-filter-checkbox="true"
+    :show-patch-search="true"
+    :show-select="false"
+    :search-item="searchItem"
+    @filter-change-grandson="filterChange"
+  />
+</template>
+```
+
+### YaheeCountryPlatformShopCondition
+
+销量等级二维筛选组件。
+
+```html
+<template>
+  <yahee-country-platform-shop-condition
+    :xy-filters="filterList"
+    filter-key="saleLevels"
+    @filter-change="filterChange"
+  />
+</template>
+```
+
+### YaheeImageUpload
+
+图片上传组件，支持图片大小、图片单位等参数自定义
+
+```html
+<template>
+  <yahee-image-upload v-model="imageValue" />
+</template>
+```
+
+### YaheeCopy
+
+复制组件
+
+```html
+<template>
+  <yahee-copy content="121212">复制</yahee-copy>
+</template>
+```
+
+### YaheeDropdownCondition
+
+下拉筛选项组件，支持传入父组件函数，用以接受选择的筛选项参数
+
+```html
+<template>
+  <yahee-drop-down-condition
+    filter-key="series"
+    enum-entity="category-series"
+    @filter-change="filterChange"
+  />
+</template>
+```
+
+### YaheeLeftCondition
+
+普通单选筛选项组件，支持传入父组件函数，用以接受选择的筛选项参数
+
+```html
+<template>
+  <YaheeLeftCondition
+    ref="bigGroupRef"
+    :select-list="categoryManagers"
+    :all-is-empty="true"
+    filter-key="categoryManager"
+    @filter-change="filterChange"
+  />
+</template>
+```
+
+### YaheeLeftConditionEnum
+
+普通单选筛选项组件，与上面组件不同的是，选项内容通过接口进行查询，同时也支持传入父组件函数，用以接受选择的筛选项参数
+
+```html
+<template>
+  <YaheeLeftConditionEnum
+    enum-entity="country"
+    filter-key="country"
+    :all-is-empty="true"
+    :init-filters="initFilters"
+    @filter-change="filterChange"
+  />
+</template>
+```
+### YaheeOperationLog
+
+操作日志组件，支持下拉加载，通过业务参数获取不同操作日志
+
+```html
+<template>
+  <YaheeLeftConditionEnum
+    enum-entity="country"
+    filter-key="country"
+    :all-is-empty="true"
+    :init-filters="initFilters"
+    @filter-change="filterChange"
+  />
+</template>
+```
+
+## 开发指南
+
+### 本地开发
+
+克隆仓库并安装依赖：
+
+```bash
+git clone 
+cd your-local-download-directory
+pnpm install
+```
+
+启动开发服务器：
+
+```bash
+yarn dev
+```
+
+### 构建
+
+构建生产版本：
+
+```bash
+cd packages/components
+npm run build
+```
+
+### 发布
+
+登录npm后
+
+```bash
+npm publish --access public
+```
+
+## 代码规范
+
+- 使用 ESLint 和 Prettier 格式化代码。
+- 提交前使用 lint-staged 进行检查。
+
+## 文档
+
+详细的 API 文档请参阅项目内docs文件夹下的文档。
+
+## 常见问题
+
+### 如何报告问题？
+
+请联系维护人menglingnan/zhangyujiao/smithshi提交问题。
+
+## 贡献
+
+欢迎贡献！请确保遵循以下步骤：
+
+1. Fork 仓库
+2. 创建你的特性分支 (`git checkout -b feature/AmazingFeature`)
+3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
+4. 推送到分支 (`git push origin feature/AmazingFeature`)
+5. 打开一个 Pull Request
+
+## 许可证
+
+该项目采用 MIT 许可证。

package/types/src/filter-container/filter-container.d.ts

@@ -0,0 +1,5 @@
+import { default as FilterContainer } from './filter-container.vue';
+/**
+ * 定义instance类型
+ */
+export type FilterContainerInstance = InstanceType<typeof FilterContainer>;

package/types/src/filter-container/filter-container.vue.d.ts

@@ -0,0 +1,49 @@
+import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+type Primitive = string | number | boolean | null | undefined;
+type FilterValue = Primitive | Primitive[];
+interface FilterChangeEvent {
+    filterKey: string;
+    checkedValues: FilterValue[];
+}
+interface SearchItem {
+    [key: string]: FilterValue;
+}
+interface FilterContainerProps {
+    debounceInterval?: number;
+    immediate?: boolean;
+    initialSearchItem?: SearchItem;
+    showSearchSection?: boolean;
+}
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        filters?(_: {}): any;
+        search?(_: {}): any;
+    };
+    refs: {};
+    rootEl: HTMLDivElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: DefineComponent<FilterContainerProps, {
+    resetAllFilters: () => void;
+    getCurrentSearchItem: () => SearchItem;
+    updateSearchItem: (changes: FilterChangeEvent | FilterChangeEvent[]) => void;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
+    change: (searchItem: SearchItem) => any;
+    search: (searchItem: SearchItem) => any;
+}, string, PublicProps, Readonly<FilterContainerProps> & Readonly<{
+    onChange?: (searchItem: SearchItem) => any;
+    onSearch?: (searchItem: SearchItem) => any;
+}>, {
+    debounceInterval: number;
+    immediate: boolean;
+    initialSearchItem: SearchItem;
+    showSearchSection: boolean;
+}, {}, {}, {}, string, ComponentProvideOptions, true, {}, HTMLDivElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/types/src/filter-container/props.d.ts

@@ -0,0 +1,45 @@
+export interface FilterContainerProps {
+    /**
+     * 处理输入框粘贴事件并格式化粘贴的内容
+     * @default undefined
+     */
+    pasteFormat?: () => void;
+    /**
+     * 默认查询类型
+     * default 'integrated':综合搜索
+     */
+    defaultSearch?: string;
+    /**
+     * 输入框的占位符文本
+     * default: ''
+     */
+    placeholderText?: string;
+    /**
+     * 是否展示批量查询按钮
+     * default: false
+     */
+    showPatchSearch?: boolean;
+    /**
+     * 是否展示在筛选体条件内查询checkbox
+     * default: false
+     */
+    showWithinFilterCheckbox?: boolean;
+    /**
+     * 是否展示下拉选
+     * default: false
+     */
+    showSelect?: boolean;
+    /**
+     *批量搜索下拉选项是否和输入框下拉选项相同
+     */
+    isBatchSelectOptionsSameWithInput?: boolean;
+}
+export declare function defaultFilterContainerProps(): {
+    pasteFormat: () => void;
+    defaultSearch: string;
+    placeholderText: string;
+    showPatchSearch: false;
+    showWithinFilterCheckbox: false;
+    showSelect: false;
+    isBatchSelectOptionsSameWithInput: true;
+};

package/types/src/filter-wrapper/filter-wrapper.d.ts

@@ -0,0 +1,5 @@
+import { default as FilterWrapper } from './filter-wrapper.vue';
+/**
+ * 定义instance类型
+ */
+export type FilterWrapperInstance = InstanceType<typeof FilterWrapper>;

package/types/src/filter-wrapper/filter-wrapper.vue.d.ts

@@ -0,0 +1,49 @@
+import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+type Primitive = string | number | boolean | null | undefined;
+type FilterValue = Primitive | Primitive[] | Record<string, Primitive>;
+interface SearchItem {
+    [key: string]: FilterValue;
+}
+interface ComponentMethods {
+    reset?: () => void;
+    getValue?: () => FilterValue;
+    setValue?: (value: FilterValue) => void;
+}
+interface FilterWrapperProps {
+    id: string;
+    filterKey: string;
+    type?: 'filter' | 'search';
+    reset?: () => void;
+    immediate?: boolean;
+}
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        default?(_: {
+            register: (componentMethods?: ComponentMethods) => void;
+            update: (checkedValues: FilterValue | FilterValue[]) => void;
+            getCurrentSearchItem: () => SearchItem;
+            handleSearch: (searchData: SearchItem) => void;
+        }): any;
+    };
+    refs: {};
+    rootEl: HTMLDivElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: DefineComponent<FilterWrapperProps, {
+    register: (componentMethods?: ComponentMethods) => void;
+    updateFilter: (checkedValues: FilterValue | FilterValue[]) => void;
+    getCurrentSearchItem: () => SearchItem;
+    handleSearch: (searchData: SearchItem) => void;
+    reset: () => void;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<FilterWrapperProps> & Readonly<{}>, {
+    type: "filter" | "search";
+    immediate: boolean;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};