@aspire-ui/element-component-pro 1.0.25 → 1.0.27

package/dist/ProTableForm/CellEditor.vue.d.ts

@@ -0,0 +1,33 @@
+import { ProTableFormColumn, ProTableFormColumnChild, ProTableFormActionType } from '../types';
+
+declare const _default: import('vue').DefineComponent<__VLS_TypePropsToRuntimeProps<{
+    col: ProTableFormColumn | ProTableFormColumnChild;
+    value: unknown;
+    /** 当前行数据，用于 dynamicComponentProps 动态求值 */
+    row?: Record<string, unknown>;
+    size?: "medium" | "small" | "large";
+    placeholder?: string;
+    /** ProTableForm 操作实例 */
+    action?: ProTableFormActionType;
+}>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    update: (v: unknown) => void;
+}, string, Readonly<import('vue').ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+    col: ProTableFormColumn | ProTableFormColumnChild;
+    value: unknown;
+    /** 当前行数据，用于 dynamicComponentProps 动态求值 */
+    row?: Record<string, unknown>;
+    size?: "medium" | "small" | "large";
+    placeholder?: string;
+    /** ProTableForm 操作实例 */
+    action?: ProTableFormActionType;
+}>>>, {}>;
+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;
+    };
+};

package/dist/ProTableForm/ProTableForm.vue.d.ts

@@ -1,142 +1,162 @@
-import { ProTableFormActionColumn, ProTableFormColumn, ProTableFormFixedRow } from './types';
+import { ProTableFormColumn, ProTableFormColumnChild } from '../types';
 
-/**
- * Vue 2 默认 v-model 绑定 value + input；本组件使用 modelValue（与 Vue 3 一致），需显式声明 model。
- */
 declare const _default: __VLS_WithTemplateSlots<import('vue').DefineComponent<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<{
-    modelValue?: Record<string, unknown>;
+    modelValue?: Record<string, unknown>[];
     columns: ProTableFormColumn[];
-    fixedRows: ProTableFormFixedRow[];
-    competitorsKey?: string;
-    competitorNameKey?: string;
-    firstColumnTitle?: string;
-    competitorNamePlaceholder?: string;
     metricPlaceholder?: string;
-    addCompetitorText?: string;
-    minCompetitors?: number;
+    minRows?: number;
     rules?: Record<string, unknown>;
     labelWidth?: string;
     bordered?: boolean;
-    firstColMinWidth?: number;
-    actionWidth?: number;
-    showFirstColumn?: boolean;
-    showActionColumn?: boolean;
-    actionColumn?: ProTableFormActionColumn;
+    spanMethod?: (params: {
+        row: Record<string, unknown>;
+        column: {
+            property: string;
+            label: string;
+        };
+        rowIndex: number;
+        columnIndex: number;
+    }) => [number, number] | {
+        rowspan: number;
+        colspan: number;
+    } | void;
+    formSize?: "medium" | "small" | "large";
+    labelPosition?: "left" | "right" | "top";
+    disabled?: boolean;
+    stripe?: boolean;
+    size?: "medium" | "small" | "large";
+    maxHeight?: number | string;
+    height?: number | string;
+    rowClassName?: string | ((params: {
+        row: Record<string, unknown>;
+        rowIndex: number;
+    }) => string);
+    expandRowKeys?: (string | number)[];
+    defaultExpandAll?: boolean;
+    onRowClick?: (row: Record<string, unknown>, event: Event) => void;
+    onRowDblclick?: (row: Record<string, unknown>, event: Event) => void;
+    onSortChange?: (sortInfo: {
+        prop: string;
+        order: string;
+    }) => void;
+    onExpandChange?: (row: Record<string, unknown>, expanded: boolean) => void;
+    tableProps?: Record<string, unknown>;
+    formProps?: Record<string, unknown>;
 }>, {
-    modelValue: () => {};
-    competitorsKey: string;
-    competitorNameKey: string;
-    firstColumnTitle: string;
-    competitorNamePlaceholder: string;
+    modelValue: () => never[];
     metricPlaceholder: string;
-    addCompetitorText: string;
-    minCompetitors: number;
+    minRows: number;
     labelWidth: string;
     bordered: boolean;
-    firstColMinWidth: number;
-    actionWidth: number;
-    showFirstColumn: boolean;
-    showActionColumn: boolean;
+    stripe: boolean;
+    size: string;
+    defaultExpandAll: boolean;
 }>, {
     validate: () => Promise<boolean>;
     clearValidate: (propsArg?: string | string[]) => void;
-    addCompetitor: () => void;
-    removeCompetitor: (index: number) => void;
+    addRow: () => void;
+    removeRow: (index: number) => void;
+    getRows: () => Record<string, unknown>[];
+    getRowCount: () => number;
+    getTable: () => {
+        clearSelection: () => void;
+    } | null;
+    getModelValue: () => Record<string, unknown>[];
+    setModelValue: (val: Record<string, unknown>[]) => void;
+    getFormRef: () => import('..').FormInstance | null;
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
-    "update:modelValue": (v: Record<string, unknown>) => void;
+    "update:modelValue": (v: Record<string, unknown>[]) => void;
+    "add-row": () => void;
+    "remove-row": (index: number) => void;
+    register: (action: Record<string, unknown>) => void;
 }, string, Readonly<import('vue').ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<{
-    modelValue?: Record<string, unknown>;
+    modelValue?: Record<string, unknown>[];
     columns: ProTableFormColumn[];
-    fixedRows: ProTableFormFixedRow[];
-    competitorsKey?: string;
-    competitorNameKey?: string;
-    firstColumnTitle?: string;
-    competitorNamePlaceholder?: string;
     metricPlaceholder?: string;
-    addCompetitorText?: string;
-    minCompetitors?: number;
+    minRows?: number;
     rules?: Record<string, unknown>;
     labelWidth?: string;
     bordered?: boolean;
-    firstColMinWidth?: number;
-    actionWidth?: number;
-    showFirstColumn?: boolean;
-    showActionColumn?: boolean;
-    actionColumn?: ProTableFormActionColumn;
+    spanMethod?: (params: {
+        row: Record<string, unknown>;
+        column: {
+            property: string;
+            label: string;
+        };
+        rowIndex: number;
+        columnIndex: number;
+    }) => [number, number] | {
+        rowspan: number;
+        colspan: number;
+    } | void;
+    formSize?: "medium" | "small" | "large";
+    labelPosition?: "left" | "right" | "top";
+    disabled?: boolean;
+    stripe?: boolean;
+    size?: "medium" | "small" | "large";
+    maxHeight?: number | string;
+    height?: number | string;
+    rowClassName?: string | ((params: {
+        row: Record<string, unknown>;
+        rowIndex: number;
+    }) => string);
+    expandRowKeys?: (string | number)[];
+    defaultExpandAll?: boolean;
+    onRowClick?: (row: Record<string, unknown>, event: Event) => void;
+    onRowDblclick?: (row: Record<string, unknown>, event: Event) => void;
+    onSortChange?: (sortInfo: {
+        prop: string;
+        order: string;
+    }) => void;
+    onExpandChange?: (row: Record<string, unknown>, expanded: boolean) => void;
+    tableProps?: Record<string, unknown>;
+    formProps?: Record<string, unknown>;
 }>, {
-    modelValue: () => {};
-    competitorsKey: string;
-    competitorNameKey: string;
-    firstColumnTitle: string;
-    competitorNamePlaceholder: string;
+    modelValue: () => never[];
     metricPlaceholder: string;
-    addCompetitorText: string;
-    minCompetitors: number;
+    minRows: number;
     labelWidth: string;
     bordered: boolean;
-    firstColMinWidth: number;
-    actionWidth: number;
-    showFirstColumn: boolean;
-    showActionColumn: boolean;
+    stripe: boolean;
+    size: string;
+    defaultExpandAll: boolean;
 }>>>, {
+    size: "medium" | "small" | "large";
     bordered: boolean;
-    modelValue: Record<string, unknown>;
+    modelValue: Record<string, unknown>[];
     labelWidth: string;
-    competitorsKey: string;
-    competitorNameKey: string;
-    firstColumnTitle: string;
-    competitorNamePlaceholder: string;
+    defaultExpandAll: boolean;
     metricPlaceholder: string;
-    addCompetitorText: string;
-    minCompetitors: number;
-    firstColMinWidth: number;
-    actionWidth: number;
-    showFirstColumn: boolean;
-    showActionColumn: boolean;
-}>, Partial<Record<string, (_: {
-    column: ProTableFormColumn;
-}) => any>> & Partial<Record<string, (_: {
-    column: ProTableFormColumn;
+    minRows: number;
+    stripe: boolean;
+}>, Partial<Record<`header-${string}`, (_: {
+    column: ProTableFormColumn & {
+        _key: string;
+    };
+}) => any>> & Partial<Record<`header-${string}`, (_: {
+    column: ProTableFormColumnChild;
+}) => any>> & Partial<Record<`cell-${string}`, (_: {
+    column: ProTableFormColumnChild;
     row: any;
+    index: any;
     value: unknown;
     updateValue: (v: unknown) => void;
-}) => any>> & Partial<Record<string, (_: {
-    column: ProTableFormColumn;
+}) => any>> & Partial<Record<`header-${string}`, (_: {
+    column: ProTableFormColumn & {
+        _key: string;
+    };
+}) => any>> & Partial<Record<`cell-${string}`, (_: {
+    column: ProTableFormColumn & {
+        _key: string;
+    };
     row: any;
+    index: any;
     value: unknown;
     updateValue: (v: unknown) => void;
 }) => any>> & {
-    firstColumnHeader?(_: {}): any;
-    firstColumn?(_: {
-        row: {
-            _type: "fixed";
-            rowKey: string;
-            rowLabel: string;
-        };
-        rowType: "fixed";
-        rowKey: string;
-        rowLabel: string;
-        rowIndex?: undefined;
-        value?: undefined;
-        updateValue?: undefined;
-    } | {
-        row: {
-            _type: "competitor";
-            _index: number;
-        };
-        rowType: "competitor";
-        rowIndex: number;
-        value: string;
-        updateValue: (v: string) => void;
-        rowKey?: undefined;
-        rowLabel?: undefined;
-    }): any;
-    actionHeader?(_: {}): any;
     action?(_: {
-        row: any;
-        canDelete: boolean;
-        addCompetitor: () => void;
-        removeCompetitor: (index: number) => void;
+        addRow: () => void;
+        removeRow: (index: number) => void;
     }): any;
 }>;
 export default _default;

package/dist/ProTableForm/index.d.ts

@@ -1,5 +1,7 @@
 import { default as ProTableForm } from './ProTableForm.vue';
+import { useProTableForm } from './useProTableForm';
 
-export { ProTableForm };
-export type { ProTableFormColumn, ProTableFormFixedRow, ProTableFormProps, ProTableFormActionColumn, } from './types';
+export { ProTableForm, useProTableForm };
+export type { ProTableFormColumn, ProTableFormColumnChild } from '../types';
+export type { ProTableFormBuiltInComponent, ProTableFormProps, ProTableFormActionType } from '../types';
 export default ProTableForm;

package/dist/ProTableForm/types.d.ts

@@ -1,69 +1 @@
-/** 指标列（或含友商名称等任意 key） */
-export interface ProTableFormColumn {
-    /** 对应 model 中对象字段名 */
-    key: string;
-    title: string;
-    required?: boolean;
-    /**
-     * 单元格渲染方式：
-     * - input / formatted-number：内置
-     * - slot：使用具名插槽 `cell-{slotName}` 完全自定义
-     */
-    component?: 'input' | 'formatted-number' | 'slot';
-    /**
-     * component 为 slot 时必填，对应插槽名为 `cell-{slotName}`（如 slotName: 'score' → #cell-score）
-     */
-    slotName?: string;
-    placeholder?: string;
-    width?: number;
-    minWidth?: number;
-    /**
-     * 透传给单元格组件。`component === 'formatted-number'` 时在此传入
-     * `integerDigits`、`decimalPlaces`、`rounding`、`inputLimit` 等（与 FormattedNumberInput / ProForm 一致）。
-     */
-    componentProps?: Record<string, unknown>;
-    /** 覆盖该列默认必填规则（与 Element 表单 rules 一致） */
-    rules?: unknown[];
-}
-/** 固定行（首列为文案，不可删） */
-export interface ProTableFormFixedRow {
-    rowKey: string;
-    label: string;
-}
-/** 操作列配置（showActionColumn 为 true 时生效） */
-export interface ProTableFormActionColumn {
-    width?: number;
-    minWidth?: number;
-    align?: 'left' | 'center' | 'right';
-    fixed?: boolean | 'left' | 'right';
-    /** 表头文案，使用默认「新增」按钮时显示在按钮左侧，可留空 */
-    title?: string;
-}
-export interface ProTableFormProps {
-    modelValue?: Record<string, unknown>;
-    columns: ProTableFormColumn[];
-    fixedRows: ProTableFormFixedRow[];
-    competitorsKey?: string;
-    /** 友商行「名称」字段，默认 name */
-    competitorNameKey?: string;
-    firstColumnTitle?: string;
-    competitorNamePlaceholder?: string;
-    metricPlaceholder?: string;
-    addCompetitorText?: string;
-    minCompetitors?: number;
-    rules?: Record<string, unknown>;
-    labelWidth?: string;
-    bordered?: boolean;
-    firstColMinWidth?: number;
-    /**
-     * 是否展示首列（维度/友商）。存在 fixedRows 时强制为 true。
-     * 无固定行且为 false 时隐藏首列，需在 columns 中自行配置名称等字段。
-     */
-    showFirstColumn?: boolean;
-    /** 是否展示操作列，默认 true */
-    showActionColumn?: boolean;
-    /** 操作列宽度（showActionColumn 时） */
-    actionWidth?: number;
-    /** 操作列详细配置 */
-    actionColumn?: ProTableFormActionColumn;
-}
+export type { ProTableFormColumn, ProTableFormColumnChild, ProTableFormActionColumn, ProTableFormProps, ProTableFormBuiltInComponent, TableActionButton, TableActionRender, ProTableFormActionType, ProTableFormRowType, } from '../types';

package/dist/ProTableForm/useProTableForm.d.ts

@@ -0,0 +1,55 @@
+import { Ref, ComputedRef } from 'vue';
+import { ProTableFormActionType, ProTableFormColumn, ProTableFormColumnChild, ProTableFormProps, FormInstance } from '../types';
+
+export interface ProTableFormOptions {
+    props: Readonly<ProTableFormProps>;
+    emit: (event: 'update:modelValue', value: Record<string, unknown>[]) => void;
+    /** 新增行事件 */
+    emitAddRow?: () => void;
+    /** 删除行事件 */
+    emitRemoveRow?: (index: number) => void;
+}
+/** useProTableForm 返回 */
+export interface UseProTableFormReturn {
+    register: (formAction: ProTableFormActionType) => void;
+    currentModelValue: ComputedRef<Record<string, unknown>[]>;
+    formModelRef: ComputedRef<{
+        rows: Record<string, unknown>[];
+    }>;
+    mergedRules: ComputedRef<Record<string, unknown[]>>;
+    tableRows: ComputedRef<TableRow[]>;
+    rowKeyFn: (row: TableRow) => string;
+    spanMethodAdapter: (params: {
+        row: TableRow;
+        column: {
+            property: string;
+            label: string;
+        };
+        rowIndex: number;
+        columnIndex: number;
+    }) => [number, number] | {
+        rowspan: number;
+        colspan: number;
+    } | void;
+    allLeafColumnKeys: ComputedRef<string[]>;
+    formRef: Ref<FormInstance | null>;
+    /** 获取 el-form 实例 */
+    getFormRef: () => FormInstance | null;
+    cellComponent: (col: ProTableFormColumn | ProTableFormColumnChild) => unknown;
+    cellBind: (col: ProTableFormColumn | ProTableFormColumnChild) => Record<string, unknown>;
+    slotUpdateHandler: (slotProps: {
+        row: TableRow;
+    }, col: ProTableFormColumn, childKey?: string) => (v: unknown) => void;
+    getCellProp: (tableRow: TableRow, col: ProTableFormColumn, childKey?: string) => string;
+    getCellValue: (row: TableRow, col: ProTableFormColumn, childKey?: string) => unknown;
+    setCellValue: (tableRow: TableRow, col: ProTableFormColumn, childKey: string | undefined, val: unknown) => void;
+    handleAddRow: () => void;
+    handleRemoveRow: (index: number) => void;
+    validate: () => Promise<boolean>;
+    clearValidate: (propsArg?: string | string[]) => void;
+}
+type TableRow = {
+    _index: number;
+};
+export declare function useProTableForm(options: ProTableFormOptions): UseProTableFormReturn;
+export {};