@antsoo-lib/core 2.0.0 → 2.0.3

package/dist/types/render/index.d.ts

@@ -0,0 +1,43 @@
+import { AnyObject } from '../../packages/shared/index.ts';
+import { VNode } from 'vue';
+import { renderAreaCascader } from './AreaCascader';
+import { renderAutoComplete } from './AutoComplete';
+import { renderButton } from './Button';
+import { renderCascader } from './Cascader';
+import { renderCheckbox } from './Checkbox';
+import { renderCheckboxGroup } from './CheckboxGroup';
+import { renderDatePicker } from './DatePicker';
+import { renderInput } from './Input';
+import { renderInputGroup } from './InputGroup';
+import { renderInputNumber } from './InputNumber';
+import { renderInputPassword } from './InputPassword';
+import { renderInputRange } from './InputRange';
+import { renderRadioGroup } from './RadioGroup';
+import { renderSelect } from './Select';
+import { renderSselectPage } from './SselectPage';
+import { renderSwitch } from './Switch';
+import { renderTree } from './Tree';
+import { renderTreeSelect } from './TreeSelect';
+import { renderUpload } from './Upload';
+import { ToolbarState } from './state';
+import { ToolbarItem } from './types';
+export type Renderer = (item: ToolbarItem, toolbarState: ToolbarState, formValues?: AnyObject) => VNode;
+export declare const rendererMap: Record<string, Renderer>;
+/**
+ * 注册自定义渲染器
+ * @param name 渲染器名称
+ * @param renderer 渲染函数
+ */
+export declare function registerRenderer(name: string, renderer: Renderer): void;
+/**
+ * 批量注册自定义渲染器
+ * @param renderers 渲染器映射对象
+ */
+export declare function registerRenderers(renderers: Record<string, Renderer>): void;
+/**
+ * 获取渲染器
+ * @param name 渲染器名称
+ * @returns 渲染函数
+ */
+export declare function getRenderer(name: string): Renderer | undefined;
+export { renderAreaCascader, renderAutoComplete, renderButton, renderCascader, renderCheckbox, renderCheckboxGroup, renderDatePicker, renderInput, renderInputGroup, renderInputNumber, renderInputPassword, renderInputRange, renderRadioGroup, renderSelect, renderSselectPage, renderSwitch, renderTree, renderTreeSelect, renderUpload, };

package/dist/types/render/registry.d.ts

@@ -0,0 +1,9 @@
+import { Component } from 'vue';
+export declare function registerBaseTableComponents(components: {
+    SselectPage?: Component;
+    AutoComplete?: Component;
+    Cascader?: Component;
+    AreaCascader?: Component;
+    Upload?: Component;
+}): void;
+export declare function getRegisteredComponent(name: string): Component | undefined;

package/dist/types/render/state.d.ts

@@ -0,0 +1,19 @@
+export interface ToolbarState {
+    [key: string]: any;
+}
+type ToolbarValue<T = any> = T | undefined;
+/**
+ * 工具栏状态管理组合式API
+ */
+export declare function useToolbarState(): {
+    state: {
+        readonly [x: string]: any;
+    };
+    setValue: (key: string, value: ToolbarValue) => void;
+    getValue: <T = any>(key: string) => ToolbarValue<T>;
+    clear: () => void;
+    getAllValues: () => {
+        [key: string]: any;
+    };
+};
+export {};

package/dist/types/render/types.d.ts

@@ -0,0 +1,435 @@
+import { ButtonProps, CascaderProps, CheckboxGroupProps, CheckboxProps, ColProps, DatePickerProps, InputNumberProps, InputProps, RadioGroupProps, RowProps, SelectProps, SwitchProps, TreeProps, TreeSelectProps, UploadProps } from '../../packages/components/index.ts';
+import { AnyObject, VoidFunction } from '../../packages/shared/index.ts';
+import { VNode } from 'vue';
+import { CustomToolbarItem } from './Custom';
+import { ToolbarState } from './state';
+export type ToolbarEventHandler = VoidFunction;
+export interface BaseEvents {
+    [key: string]: ToolbarEventHandler | undefined;
+}
+export interface BaseToolbarItem {
+    key?: string;
+    label?: string;
+    permission?: string;
+    beforeCreate?: boolean | ((toolbarState: ToolbarState) => boolean);
+    disabled?: boolean | ((allValues: AnyObject, toolbarState: ToolbarState) => boolean);
+    props?: Record<string, any>;
+    events?: BaseEvents;
+}
+export interface ButtonToolbarItem extends BaseToolbarItem {
+    type: 'button';
+    props?: Partial<ButtonProps> & {
+        loading?: boolean;
+        disabled?: boolean;
+    };
+    events?: BaseEvents & {
+        onClick?: (loadingControl: {
+            setLoading: (loading: boolean) => void;
+            getLoading: () => boolean;
+        }, allValues: AnyObject, toolbarState: ToolbarState, ...args: any[]) => void;
+    };
+}
+export interface SlotConfig {
+    content?: {
+        component: any;
+        key: string;
+        props?: AnyObject;
+        events?: Record<string, VoidFunction>;
+        options?: Array<{
+            label: string;
+            value: any;
+        }>;
+    } | ((toolbarState: ToolbarState) => VNode);
+}
+export interface InputToolbarItem extends BaseToolbarItem {
+    type: 'input';
+    props?: Partial<InputProps> & {
+        value?: string;
+        autoFocus?: boolean;
+    };
+    events?: BaseEvents & {
+        'onUpdate:value'?: (value: string, allValues: AnyObject, toolbarState: ToolbarState) => void;
+        onChange?: (event: Event, allValues: AnyObject, toolbarState: ToolbarState) => void;
+        onFocus?: VoidFunction;
+        onFocusCapture?: VoidFunction;
+        onBlur?: VoidFunction;
+        onBlurCapture?: VoidFunction;
+    };
+    textarea?: boolean;
+    slots?: {
+        addonBefore?: SlotConfig;
+        addonAfter?: SlotConfig;
+        prefix?: SlotConfig;
+        suffix?: SlotConfig;
+    };
+}
+export interface RadioGroupToolbarItem extends BaseToolbarItem {
+    type: 'radioGroup';
+    props?: Partial<RadioGroupProps> & {
+        value?: any;
+    };
+    events?: BaseEvents & {
+        'onUpdate:value'?: (value: string, allValues: AnyObject, toolbarState: ToolbarState) => void;
+        onChange?: (event: Event, allValues: AnyObject, toolbarState: ToolbarState) => void;
+    };
+}
+export interface CheckboxToolbarItem extends BaseToolbarItem {
+    type: 'checkbox';
+    props?: Partial<CheckboxProps> & {
+        checked?: boolean;
+        value?: boolean;
+    };
+    events?: BaseEvents & {
+        'onUpdate:checked'?: (checked: boolean, allValues: AnyObject, toolbarState: ToolbarState) => void;
+        onChange?: (event: any, allValues: AnyObject, toolbarState: ToolbarState) => void;
+        'onUpdate:value'?: (checked: boolean, allValues: AnyObject, toolbarState: ToolbarState) => void;
+    };
+    label?: string;
+}
+export interface SwitchToolbarItem extends BaseToolbarItem {
+    type: 'switch';
+    props?: Partial<SwitchProps> & {
+        checked?: boolean;
+    };
+    events?: BaseEvents & {
+        'onUpdate:checked'?: (checked: boolean, allValues: AnyObject, toolbarState: ToolbarState) => void;
+        onChange?: (checked: boolean, allValues: AnyObject, toolbarState: ToolbarState) => void;
+    };
+}
+export interface CheckboxGroupToolbarItem extends BaseToolbarItem {
+    type: 'checkboxGroup';
+    props?: Partial<CheckboxGroupProps> & {
+        value?: any[];
+    };
+    events?: BaseEvents & {
+        'onUpdate:value'?: (value: any[], allValues: AnyObject, toolbarState: ToolbarState) => void;
+        onChange?: (checkedValues: any[], allValues: AnyObject, toolbarState: ToolbarState) => void;
+    };
+}
+export interface DatePickerToolbarItem extends BaseToolbarItem {
+    type: 'datePicker';
+    props?: Partial<DatePickerProps> & {
+        value?: any;
+        autoFocus?: boolean;
+    };
+    events?: BaseEvents & {
+        'onUpdate:value'?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void;
+        onChange?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void;
+        onFocus?: VoidFunction;
+    };
+    range?: boolean;
+}
+export interface SelectToolbarItem extends BaseToolbarItem {
+    type: 'select';
+    props?: Partial<SelectProps> & {
+        value?: any;
+        options?: any[] | ((values: AnyObject) => any[]);
+    };
+    events?: BaseEvents & {
+        'onUpdate:value'?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void;
+        onChange?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void;
+    };
+}
+export interface CascaderToolbarItem extends BaseToolbarItem {
+    type: 'cascader';
+    props?: Partial<CascaderProps> & {
+        value?: any;
+    };
+    events?: BaseEvents & {
+        'onUpdate:value'?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void;
+        onChange?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void;
+    };
+}
+export interface AreaCascaderProps {
+    value?: any[];
+    placeholder?: string;
+    disabled?: boolean;
+    allowClear?: boolean;
+    [key: string]: any;
+}
+export interface AreaCascaderToolbarItem extends BaseToolbarItem {
+    type: 'areaCascader';
+    props?: AreaCascaderProps;
+    attr?: Record<string, any>;
+    events?: BaseEvents & {
+        'onUpdate:value'?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void;
+        selectedArea?: (area: any, allValues: AnyObject, toolbarState: ToolbarState) => void;
+    };
+}
+export interface TreeSelectToolbarItem extends BaseToolbarItem {
+    type: 'treeSelect';
+    props?: Partial<TreeSelectProps> & {
+        value?: any;
+        options?: any[] | ((values: AnyObject) => any[]);
+    };
+    events?: BaseEvents & {
+        'onUpdate:value'?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void;
+        onChange?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void;
+    };
+}
+export interface TreeToolbarItem extends BaseToolbarItem {
+    type: 'tree';
+    props?: Partial<TreeProps> & {
+        checkedKeys?: any[];
+        expandedKeys?: any[];
+    };
+    events?: BaseEvents & {
+        'onUpdate:checkedKeys'?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void;
+        'onUpdate:expandedKeys'?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void;
+        onCheck?: (value: any, info: any, allValues: AnyObject, toolbarState: ToolbarState) => void;
+        onExpand?: (value: any, info: any, allValues: AnyObject, toolbarState: ToolbarState) => void;
+        onChange?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void;
+    };
+}
+export interface InputRangeToolbarItem extends BaseToolbarItem {
+    type: 'inputRange';
+    props?: {
+        startProps?: Record<string, unknown>;
+        endProps?: Record<string, unknown>;
+        separator?: string;
+        startPlaceholder?: string;
+        endPlaceholder?: string;
+        style?: AnyObject;
+        className?: string;
+        allowClear?: boolean;
+    };
+    attr?: string[];
+    events?: BaseEvents & {
+        'onUpdate:value'?: (value: [string, string], allValues: AnyObject, toolbarState: ToolbarState) => void;
+        onChange?: (value: [string, string], allValues: AnyObject, toolbarState: ToolbarState) => void;
+        onStartChange?: (value: string, allValues: AnyObject, toolbarState: ToolbarState) => void;
+        onEndChange?: (value: string, allValues: AnyObject, toolbarState: ToolbarState) => void;
+    };
+}
+export interface InputNumberToolbarItem extends BaseToolbarItem {
+    type: 'inputNumber';
+    props?: Partial<InputNumberProps> & {
+        value?: any;
+        autoFocus?: boolean;
+        xmoney?: boolean;
+        xprice?: boolean;
+        xweight?: boolean;
+        xtaxrate?: boolean;
+        xnumber?: boolean;
+    };
+    events?: BaseEvents & {
+        'onUpdate:value'?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void;
+        onChange?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void;
+        onStep?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void;
+        onFocus?: VoidFunction;
+        onFocusCapture?: VoidFunction;
+        onBlur?: VoidFunction;
+        onBlurCapture?: VoidFunction;
+    };
+    slots?: {
+        addonBefore?: SlotConfig;
+        addonAfter?: SlotConfig;
+        prefix?: SlotConfig;
+        suffix?: SlotConfig;
+    };
+}
+export interface InputPasswordToolbarItem extends BaseToolbarItem {
+    type: 'inputPassword';
+    props?: Partial<InputProps> & {
+        value?: string;
+    };
+    events?: BaseEvents & {
+        'onUpdate:value'?: (value: string, allValues: AnyObject, toolbarState: ToolbarState) => void;
+        onChange?: (event: Event, allValues: AnyObject, toolbarState: ToolbarState) => void;
+    };
+    textarea?: boolean;
+    slots?: {
+        addonBefore?: SlotConfig;
+        addonAfter?: SlotConfig;
+        prefix?: SlotConfig;
+        suffix?: SlotConfig;
+    };
+}
+export interface UploadToolbarItem extends BaseToolbarItem {
+    type: 'upload';
+    props?: Partial<UploadProps> & {
+        value?: any[];
+        placeholder?: string;
+        allowClear?: boolean;
+        disabled?: boolean | ((allValues: AnyObject, toolbarState: ToolbarState) => boolean);
+        multiple?: boolean;
+        maxCount?: number;
+        listType?: 'text' | 'picture' | 'picture-card';
+        api?: {
+            url: string;
+            method?: 'GET' | 'POST';
+            headers?: Record<string, string>;
+        };
+        extraParams?: AnyObject | ((allValues: AnyObject, toolbarState: ToolbarState) => AnyObject);
+        dataMapping?: {
+            list?: string;
+            url?: string;
+            name?: string;
+            status?: string;
+        };
+        buttonText?: string;
+        placeholderSrc?: string;
+        placeholderAlt?: string;
+        placeholderClass?: string;
+        placeholderStyle?: AnyObject;
+        transformData?: (data: any) => any;
+        beforeUpload?: (file: File, fileList: File[]) => boolean | Promise<boolean>;
+        onPreview?: (file: any) => void;
+        onRemove?: (file: any) => boolean | Promise<boolean>;
+    };
+    passage?: 'image' | 'pdf' | 'word' | 'excel' | 'video' | 'audio' | string;
+    events?: BaseEvents & {
+        'onUpdate:value'?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void;
+        onChange?: (info: any, allValues: AnyObject, toolbarState: ToolbarState) => void;
+        onSuccess?: (response: any, file: any, allValues: AnyObject, toolbarState: ToolbarState) => void;
+        onError?: (error: any, file: any, allValues: AnyObject, toolbarState: ToolbarState) => void;
+    };
+}
+export interface SselectPageProps {
+    value?: any;
+    placeholder?: string;
+    allowClear?: boolean;
+    showSearch?: boolean;
+    disabled?: boolean;
+    maxTagCount?: number | 'responsive';
+    size?: 'large' | 'middle' | 'small';
+    mode?: 'multiple' | 'tags';
+    params?: AnyObject;
+    api: {
+        url: string;
+        method?: 'GET' | 'POST';
+        headers?: Record<string, string>;
+        params?: AnyObject;
+        data?: AnyObject;
+        request?: (config: {
+            method?: 'GET' | 'POST';
+            url: string;
+            headers?: Record<string, string>;
+            params?: AnyObject;
+            data?: AnyObject;
+        }) => Promise<any>;
+    };
+    dataMapping?: {
+        list?: string;
+        total?: string;
+        value?: string;
+        label?: string;
+    };
+    pagination?: boolean;
+    paginationConfig?: {
+        pageField?: string;
+        pageSizeField?: string;
+        searchField?: string;
+        searchContains?: string;
+    };
+    pageSize?: number;
+    searchDelay?: number;
+    extraParams?: AnyObject | ((allValues: AnyObject, toolbarState: ToolbarState) => AnyObject);
+    transformData?: (data: any) => any;
+    autoLoad?: boolean;
+    autoFocus?: boolean;
+    attr?: Record<string, string>;
+    [key: string]: any;
+}
+export interface SselectPageToolbarItem extends BaseToolbarItem {
+    type: 'sselectPage';
+    props?: SselectPageProps & {
+        disabled?: boolean | ((allValues: AnyObject, toolbarState: ToolbarState) => boolean);
+    };
+    events?: BaseEvents & {
+        'onUpdate:value'?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void;
+        onChange?: (value: any, option: any, allOptions: any, allValues: AnyObject, toolbarState: ToolbarState) => void;
+        onSearch?: (value: string, allValues: AnyObject, toolbarState: ToolbarState) => void;
+        onClear?: (allValues: AnyObject, toolbarState: ToolbarState) => void;
+    };
+}
+export interface AutoCompleteProps {
+    value?: any;
+    options?: any[];
+    placeholder?: string;
+    disabled?: boolean;
+    allowClear?: boolean;
+    [key: string]: any;
+}
+export interface AutoCompleteToolbarItem extends BaseToolbarItem {
+    type: 'autoComplete';
+    props?: AutoCompleteProps;
+    events?: BaseEvents & {
+        'onUpdate:value'?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void;
+        onChange?: (value: any, allValues: AnyObject, toolbarState: ToolbarState) => void;
+        onSelect?: (value: any, option: any, allValues: AnyObject, toolbarState: ToolbarState) => void;
+        onSearch?: (value: string, allValues: AnyObject, toolbarState: ToolbarState) => void;
+    };
+}
+export type InputGroupSize = 'large' | 'middle' | 'small' | 'default';
+export interface InputGroupPropsLike {
+    size?: InputGroupSize;
+    compact?: boolean;
+    prefixCls?: string;
+}
+export type PresetXtype = 'add' | 'edit' | 'dels' | 'export' | 'print' | 'files';
+export interface FilesCategoryOption {
+    label: string;
+    value: string;
+    [key: string]: any;
+}
+export interface FilesPresetConfig {
+    title?: string;
+    billtypeCode: string | ((row: AnyObject) => string);
+    categoryOptions: FilesCategoryOption[] | ((row: AnyObject) => FilesCategoryOption[]);
+    objIdKey?: string;
+    accept?: string;
+    passage?: 'image' | 'pdf' | 'word' | 'excel' | 'video' | 'audio' | string;
+    maxFileSizeMB?: number;
+    maxCount?: number;
+    refreshOnSuccess?: boolean;
+}
+export interface PresetBaseToolbarItem extends BaseToolbarItem {
+    xtype: PresetXtype;
+    permission?: string;
+    label?: string;
+    events?: any;
+    props?: any;
+}
+export interface PresetDelsToolbarItem extends PresetBaseToolbarItem {
+    xtype: 'dels';
+    api?: {
+        url?: string;
+        method?: 'get' | 'post';
+        useParams?: boolean;
+    };
+}
+export interface PresetExportToolbarItem extends PresetBaseToolbarItem {
+    xtype: 'export';
+    filename?: string;
+}
+export interface PresetFilesToolbarItem extends PresetBaseToolbarItem {
+    xtype: 'files';
+    files: FilesPresetConfig;
+}
+export type PresetToolbarItem = PresetDelsToolbarItem | PresetExportToolbarItem | PresetFilesToolbarItem;
+export type RenderableToolbarItem = ButtonToolbarItem | InputToolbarItem | RadioGroupToolbarItem | CheckboxToolbarItem | SwitchToolbarItem | CheckboxGroupToolbarItem | DatePickerToolbarItem | UploadToolbarItem | InputNumberToolbarItem | SelectToolbarItem | TreeToolbarItem | TreeSelectToolbarItem | InputPasswordToolbarItem | SselectPageToolbarItem | AutoCompleteToolbarItem | InputGroupToolbarItem | CascaderToolbarItem | AreaCascaderToolbarItem | InputRangeToolbarItem | CustomToolbarItem;
+export type ToolbarItem = RenderableToolbarItem | PresetToolbarItem;
+export type InputGroupChild = RenderableToolbarItem & {
+    span?: number;
+    flex?: string;
+    class?: string;
+    style?: AnyObject;
+};
+export interface InputGroupToolbarItem extends BaseToolbarItem {
+    [x: string]: any;
+    type: 'inputGroup';
+    props?: Partial<InputGroupPropsLike>;
+    layout?: {
+        type?: 'compact' | 'row' | 'none';
+        rowProps?: Partial<RowProps>;
+        cols?: Array<Partial<ColProps> & {
+            span?: number;
+        }>;
+    };
+    children: InputGroupChild[];
+}
+export interface ToolbarConfig {
+    items: ToolbarItem[];
+}
+export type { ButtonProps, DatePickerProps, InputNumberProps, InputProps, RadioGroupProps, SelectProps, SwitchProps, TreeSelectProps, UploadProps, };

package/dist/types/utils/attrMapping.d.ts

@@ -0,0 +1,26 @@
+import { AnyObject } from '../../packages/shared/index.ts';
+/**
+ * 安全获取嵌套属性值，支持 a.b.c 路径
+ */
+export declare function getByPath(obj: any, path?: string): any;
+/**
+ * 根据 attr 规则从 formData 聚合初始值：
+ * - 数组：返回对应字段的值数组
+ * - 对象：返回 { [sourcePath]: formData[targetKey] } 结构，便于组件按源字段进行回显
+ */
+export declare function buildValueFromAttr(formData: AnyObject, attr: string[] | AnyObject): any;
+/**
+ * 按 attr 对象映射将选项数据写入 formData：
+ * - 支持单选与多选；
+ * - 优先使用 option.__raw 原始对象，其次使用 option 自身；
+ * - sourcePath 支持嵌套路径（例如 'data.id'）。
+ */
+export declare function applyAttrMapping(formData: AnyObject, toolbarState: {
+    setValue: (k: string, v: any) => void;
+}, attr: Record<string, string>, value: any, option: any, isMultiple: boolean): void;
+declare const _default: {
+    buildValueFromAttr: typeof buildValueFromAttr;
+    applyAttrMapping: typeof applyAttrMapping;
+    getByPath: typeof getByPath;
+};
+export default _default;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@antsoo-lib/core",
   "type": "module",
-  "version": "2.0.0",
+  "version": "2.0.3",
   "private": false,
   "license": "MIT",
   "exports": {
@@ -20,23 +20,21 @@
     "registry": "https://registry.npmjs.com/"
   },
   "peerDependencies": {
+    "@ant-design/icons-svg": "^4.4.2",
+    "@types/lodash-es": "^4.17.12",
+    "@vxe-ui/plugin-export-xlsx": "^4.0.7",
+    "@vxe-ui/plugin-menu": "^4.0.2",
+    "@vxe-ui/plugin-render-wangeditor": "^4.0.2",
     "lodash-es": "^4.17.21",
     "vue": "^3.3.4",
-    "@antsoo-lib/components": "1.0.0",
+    "vxe-pc-ui": "^4.12.31",
+    "vxe-table": "^4.17.48",
+    "xe-utils": "^4.0.0",
     "@antsoo-lib/icons": "0.2.0",
+    "@antsoo-lib/components": "1.0.0",
     "@antsoo-lib/shared": "0.1.0",
     "@antsoo-lib/utils": "0.2.0"
   },
-  "dependencies": {
-    "vxe-pc-ui": "^4.12.31",
-    "vxe-table": "^4.17.48",
-    "xe-utils": "^4.0.0"
-  },
-  "devDependencies": {
-    "@ant-design/icons-svg": "^4.4.2",
-    "@types/lodash-es": "^4.17.12",
-    "lodash-es": "^4.17.21"
-  },
   "scripts": {
     "dev": "vite build --watch",
     "build": "vite build",