@hz_yujin/vue-smart-table 0.1.2

package/dist/src/components/ProColumnEditor/ProColumnEditor.vue.d.ts

@@ -0,0 +1,20 @@
+import { SmartColumnSchema } from '../ProSmartTable/column-schema';
+import { ProColumnEditorProps } from './types';
+declare const _default: import('vue').DefineComponent<ProColumnEditorProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    "update:modelValue": (value: boolean) => any;
+    save: (columns: SmartColumnSchema[]) => any;
+    restore: () => any;
+    cancel: () => any;
+}, string, import('vue').PublicProps, Readonly<ProColumnEditorProps> & Readonly<{
+    "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
+    onSave?: ((columns: SmartColumnSchema[]) => any) | undefined;
+    onRestore?: (() => any) | undefined;
+    onCancel?: (() => any) | undefined;
+}>, {
+    modelValue: boolean;
+    columns: SmartColumnSchema[];
+    defaultColumns: SmartColumnSchema[];
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    listRef: HTMLDivElement;
+}, any>;
+export default _default;

package/dist/src/components/ProColumnEditor/index.d.ts

@@ -0,0 +1,2 @@
+export { default as ProColumnEditor } from './ProColumnEditor.vue';
+export type { ProColumnEditorProps, ProColumnEditorEmits } from './types';

package/dist/src/components/ProColumnEditor/types.d.ts

@@ -0,0 +1,14 @@
+import { SmartColumnSchema } from '../ProSmartTable/column-schema';
+export interface ProColumnEditorProps {
+    modelValue?: boolean;
+    columns?: SmartColumnSchema[];
+    /** 恢复默认时使用的原始列 */
+    defaultColumns?: SmartColumnSchema[];
+}
+export interface ProColumnEditorEmits {
+    (e: 'update:modelValue', value: boolean): void;
+    (e: 'save', columns: SmartColumnSchema[]): void;
+    /** 确认恢复默认：父级应持久化空配置（如 DB columns_json = []）并应用默认列 */
+    (e: 'restore'): void;
+    (e: 'cancel'): void;
+}

package/dist/src/components/ProSmartTable/ProSmartTable.vue.d.ts

@@ -0,0 +1,114 @@
+import { TableInstance } from 'element-plus';
+import { SmartColumnSchema } from './column-schema';
+import { ProSmartTablePagination, ProSmartTableProps, ProSmartTableSkeletonConfig } from './types';
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: Partial<Record<`col-${string}`, (_: any) => any>> & Partial<Record<`form-${string}`, (_: {
+        model: Record<string, unknown>;
+        column: {
+            id: string;
+            prop: string;
+            label: string;
+            minWidth?: number | undefined;
+            width?: number | string | undefined;
+            sortable?: boolean | "custom" | undefined;
+            searchable?: boolean | undefined;
+            formable?: boolean | undefined;
+            required?: boolean | undefined;
+            formType?: import('./column-schema').SmartFormControlType | undefined;
+            formOptions?: {
+                label: string;
+                value: string | number | boolean;
+                disabled?: boolean | undefined;
+                children?: /*elided*/ any[] | undefined;
+            }[] | undefined;
+            searchPlaceholder?: string | undefined;
+            fixed?: boolean | "left" | "right" | undefined;
+            visible?: boolean | undefined;
+            source?: import('./column-schema').SmartColumnSource | undefined;
+            deletable?: boolean | undefined;
+            columnProps?: Record<string, unknown> | undefined;
+            formProps?: Record<string, unknown> | undefined;
+        };
+        value: unknown;
+        mode: "create" | "edit";
+    }) => any>> & {
+        'toolbar-left'?(_: {}): any;
+        'toolbar-right'?(_: {}): any;
+        skeleton?(_: {}): any;
+        default?(_: {}): any;
+        pagination?(_: {}): any;
+        'form-extra'?(_: {
+            model: Record<string, unknown>;
+            mode: "create" | "edit";
+            visible: boolean;
+        }): any;
+    };
+    refs: {
+        tableRef: unknown;
+        formRef: unknown;
+    };
+    rootEl: any;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<ProSmartTableProps, {
+    tableRef: TableInstance | null;
+    openColumnEditor: () => void;
+    openCreate: () => void;
+    openEdit: (row: Record<string, unknown>) => void;
+    getSearchModel: () => Record<string, unknown>;
+    getColumns: () => SmartColumnSchema[];
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    search: (...args: any[]) => void;
+    reset: (...args: any[]) => void;
+    update: (...args: any[]) => void;
+    "update:columns": (...args: any[]) => void;
+    create: (...args: any[]) => void;
+    "columns-change": (...args: any[]) => void;
+    "columns-reset": (...args: any[]) => void;
+    "page-change": (...args: any[]) => void;
+    "update:pagination": (...args: any[]) => void;
+    refresh: (...args: any[]) => void;
+    "sort-change": (...args: any[]) => void;
+}, string, import('vue').PublicProps, Readonly<ProSmartTableProps> & Readonly<{
+    onSearch?: ((...args: any[]) => any) | undefined;
+    onReset?: ((...args: any[]) => any) | undefined;
+    onUpdate?: ((...args: any[]) => any) | undefined;
+    "onUpdate:columns"?: ((...args: any[]) => any) | undefined;
+    onCreate?: ((...args: any[]) => any) | undefined;
+    "onColumns-change"?: ((...args: any[]) => any) | undefined;
+    "onColumns-reset"?: ((...args: any[]) => any) | undefined;
+    "onPage-change"?: ((...args: any[]) => any) | undefined;
+    "onUpdate:pagination"?: ((...args: any[]) => any) | undefined;
+    onRefresh?: ((...args: any[]) => any) | undefined;
+    "onSort-change"?: ((...args: any[]) => any) | undefined;
+}>, {
+    columns: SmartColumnSchema[];
+    data: Record<string, unknown>[];
+    showToolbar: boolean;
+    showColumnEditor: boolean;
+    showRefresh: boolean;
+    showCreate: boolean;
+    showSeq: boolean;
+    seqWidth: number | string;
+    showSelection: boolean;
+    showSearch: boolean;
+    searchCollapsible: boolean;
+    searchCollapseVisibleCount: number;
+    searchDefaultExpanded: boolean;
+    formTitle: string;
+    formWidth: number | string;
+    loading: boolean;
+    skeleton: boolean | ProSmartTableSkeletonConfig;
+    pagination: false | ProSmartTablePagination;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    tableRef: unknown;
+    formRef: unknown;
+}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/src/components/ProSmartTable/ProSmartTableSkeleton.vue.d.ts

@@ -0,0 +1,26 @@
+type __VLS_Props = {
+    rows?: number;
+    animated?: boolean;
+    columns?: number;
+};
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        default?(_: {}): any;
+    };
+    refs: {};
+    rootEl: HTMLDivElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    columns: number;
+    rows: number;
+    animated: boolean;
+}, {}, {}, {}, string, import('vue').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;
+    };
+};

package/dist/src/components/ProSmartTable/SmartFieldControl.vue.d.ts

@@ -0,0 +1,12 @@
+import { SmartColumnSchema } from './column-schema';
+type __VLS_Props = {
+    modelValue: unknown;
+    column: SmartColumnSchema;
+    mode?: 'search' | 'form';
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    "update:modelValue": (value: unknown) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: unknown) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/src/components/ProSmartTable/SmartSearchForm.vue.d.ts

@@ -0,0 +1,35 @@
+import { SmartColumnSchema } from './column-schema';
+type __VLS_Props = {
+    columns: SmartColumnSchema[];
+    modelValue: Record<string, unknown>;
+    collapsible?: boolean;
+    /** 收起时展示前 N 个字段，默认 3 */
+    collapseVisibleCount?: number;
+    defaultExpanded?: boolean;
+    searchText?: string;
+    resetText?: string;
+    expandText?: string;
+    collapseText?: string;
+    /** 持久化展开状态的 storage key */
+    persistKey?: string;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    "update:modelValue": (value: Record<string, unknown>) => any;
+    search: (value: Record<string, unknown>) => any;
+    reset: (value: Record<string, unknown>) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: Record<string, unknown>) => any) | undefined;
+    onSearch?: ((value: Record<string, unknown>) => any) | undefined;
+    onReset?: ((value: Record<string, unknown>) => any) | undefined;
+}>, {
+    collapsible: boolean;
+    collapseVisibleCount: number;
+    defaultExpanded: boolean;
+    searchText: string;
+    resetText: string;
+    expandText: string;
+    collapseText: string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    fieldsRef: HTMLDivElement;
+}, HTMLElement>;
+export default _default;

package/dist/src/components/ProSmartTable/column-schema.d.ts

@@ -0,0 +1,56 @@
+/** 表单 / 查询控件类型 */
+export type SmartFormControlType = 'input' | 'password' | 'textarea' | 'number' | 'select' | 'select-multiple' | 'radio' | 'checkbox' | 'checkbox-group' | 'switch' | 'date' | 'datetime' | 'daterange' | 'date-range' | 'datetimerange' | 'datetime-range' | 'time' | 'timerange' | 'time-range' | 'month' | 'year' | 'week' | 'cascader' | 'tree-select' | 'autocomplete' | 'rate' | 'slider' | 'color';
+export declare const SMART_FORM_CONTROL_OPTIONS: {
+    label: string;
+    value: SmartFormControlType;
+}[];
+/** 列来源：固定（业务预置）/ 自定义（列管理新增） */
+export type SmartColumnSource = 'fixed' | 'custom';
+export interface SmartSelectOption {
+    label: string;
+    value: string | number | boolean;
+    disabled?: boolean;
+    children?: SmartSelectOption[];
+}
+export interface SmartColumnSchema {
+    /** 稳定唯一 id（拖拽 / 删除 / 持久化） */
+    id: string;
+    /** 对应 el-table-column 的 prop / 数据字段 */
+    prop: string;
+    /** 列标题 */
+    label: string;
+    minWidth?: number;
+    width?: number | string;
+    /** 是否可排序 */
+    sortable?: boolean | 'custom';
+    /** 是否作为查询条件 */
+    searchable?: boolean;
+    /** 是否出现在新增/编辑表单 */
+    formable?: boolean;
+    /** 表单是否必填（仅 formable 时有效） */
+    required?: boolean;
+    /** 表单控件类型 */
+    formType?: SmartFormControlType;
+    /** select / radio / cascader 等选项 */
+    formOptions?: SmartSelectOption[];
+    /** 查询占位符 */
+    searchPlaceholder?: string;
+    /** 固定列 */
+    fixed?: boolean | 'left' | 'right';
+    /** 是否在表格中显示 */
+    visible?: boolean;
+    /** 列来源 */
+    source?: SmartColumnSource;
+    /** 是否允许删除（固定列默认不可删） */
+    deletable?: boolean;
+    /** 透传给 el-table-column 的额外属性 */
+    columnProps?: Record<string, unknown>;
+    /** 表单项额外属性 */
+    formProps?: Record<string, unknown>;
+}
+export declare function createColumnId(prefix?: string): string;
+export declare function normalizeColumn(col: SmartColumnSchema): SmartColumnSchema;
+export declare function cloneColumns(columns: SmartColumnSchema[]): SmartColumnSchema[];
+export declare function createEmptyColumn(partial?: Partial<SmartColumnSchema>): SmartColumnSchema;
+/** 统一别名，便于渲染分支判断 */
+export declare function resolveFormControlType(type?: SmartFormControlType): SmartFormControlType;

package/dist/src/components/ProSmartTable/index.d.ts

@@ -0,0 +1,3 @@
+export { default as ProSmartTable } from './ProSmartTable.vue';
+export type { ProSmartTableProps, ProSmartTableEmits, ProSmartTableExpose, ProSmartTablePagination, ProSmartTablePageChangePayload, ProSmartTableSkeletonConfig, SmartColumnSchema, SmartFormControlType, SmartColumnSource, SmartSelectOption, } from './types';
+export { SMART_FORM_CONTROL_OPTIONS, createColumnId, normalizeColumn, cloneColumns, createEmptyColumn, resolveFormControlType, } from './column-schema';

package/dist/src/components/ProSmartTable/types.d.ts

@@ -0,0 +1,112 @@
+import { TableInstance } from 'element-plus';
+import { SmartColumnSchema } from './column-schema';
+export type { SmartColumnSchema, SmartFormControlType, SmartColumnSource, SmartSelectOption } from './column-schema';
+export interface ProSmartTablePagination {
+    currentPage?: number;
+    pageSize?: number;
+    total?: number;
+    pageSizes?: number[];
+    /** 默认 total, sizes, prev, pager, next, jumper */
+    layout?: string;
+    background?: boolean;
+    /**
+     * 分页尺寸，默认 small（与 vue-base-table 一致）
+     * @deprecated 请使用 size
+     */
+    small?: boolean;
+    size?: 'large' | 'default' | 'small';
+    pagerCount?: number;
+    /**
+     * local：前端按 page 切片 data（未传 total 时默认）
+     * remote：data 即为当前页，需传 total
+     */
+    mode?: 'local' | 'remote';
+}
+export interface ProSmartTablePageChangePayload {
+    currentPage: number;
+    pageSize: number;
+}
+export interface ProSmartTableSkeletonConfig {
+    /** 骨架行数，默认取 pagination.pageSize（上限 10），否则 5 */
+    rows?: number;
+    /** 是否开启动画，默认 true */
+    animated?: boolean;
+    /**
+     * 仅无数据时用骨架；有数据刷新时仍用转圈
+     * @default true
+     */
+    onlyEmpty?: boolean;
+}
+export interface ProSmartTableProps {
+    /** 表格数据 */
+    data?: Record<string, unknown>[];
+    /** 列 schema（驱动表格 / 查询 / 表单） */
+    columns?: SmartColumnSchema[];
+    /** 是否展示工具栏（新增 / 编辑列） */
+    showToolbar?: boolean;
+    /** 是否展示「编辑列」入口 */
+    showColumnEditor?: boolean;
+    /** 是否展示刷新按钮，默认 true */
+    showRefresh?: boolean;
+    /** 是否展示「新增」按钮 */
+    showCreate?: boolean;
+    /** 是否展示序号列，默认 true */
+    showSeq?: boolean;
+    /** 序号列宽度，默认 60 */
+    seqWidth?: number | string;
+    /** 是否展示多选列，默认 false */
+    showSelection?: boolean;
+    /** 是否展示查询区 */
+    showSearch?: boolean;
+    /** 查询区是否可收起展开，默认 true */
+    searchCollapsible?: boolean;
+    /** 收起时展示的查询字段数，默认 3 */
+    searchCollapseVisibleCount?: number;
+    /** 查询区默认是否展开，默认 false */
+    searchDefaultExpanded?: boolean;
+    /** 本地持久化 key；有值时保存列配置到 localStorage */
+    persistKey?: string;
+    /** 新增/编辑弹框标题前缀 */
+    formTitle?: string;
+    /** 新增/编辑弹框宽度，默认 45% */
+    formWidth?: number | string;
+    /** 加载中（骨架 / 转圈） */
+    loading?: boolean;
+    /**
+     * 骨架屏：默认开启；`false` 关闭；对象可配 rows / animated / onlyEmpty
+     * @default true
+     */
+    skeleton?: boolean | ProSmartTableSkeletonConfig;
+    /**
+     * 分页：传 `false` 关闭；默认开启（共 N 条 / 条每页 / 页码 / 前往）
+     */
+    pagination?: false | ProSmartTablePagination;
+}
+export interface ProSmartTableEmits {
+    (e: 'update:columns', columns: SmartColumnSchema[]): void;
+    (e: 'search', model: Record<string, unknown>): void;
+    (e: 'reset'): void;
+    (e: 'create', model: Record<string, unknown>): void;
+    (e: 'update', model: Record<string, unknown>): void;
+    (e: 'columns-change', columns: SmartColumnSchema[]): void;
+    /** 列管理「恢复默认」：业务侧应将持久化配置清空（如 DB 存 []） */
+    (e: 'columns-reset'): void;
+    (e: 'page-change', payload: ProSmartTablePageChangePayload): void;
+    (e: 'update:pagination', pagination: ProSmartTablePagination): void;
+    (e: 'refresh'): void;
+    /** 透传 el-table；远程排序请配合 sortable:'custom' 或 remote 分页 */
+    (e: 'sort-change', payload: {
+        column: unknown;
+        prop: string;
+        order: 'ascending' | 'descending' | null;
+    }): void;
+}
+export interface ProSmartTableExpose {
+    /** 底层 el-table 实例 */
+    tableRef: TableInstance | null;
+    openColumnEditor: () => void;
+    openCreate: () => void;
+    openEdit: (row: Record<string, unknown>) => void;
+    getSearchModel: () => Record<string, unknown>;
+    getColumns: () => SmartColumnSchema[];
+}

package/dist/src/index.d.ts

@@ -0,0 +1,7 @@
+export type { ProSmartTableProps, ProSmartTableEmits, ProSmartTableExpose, ProSmartTablePagination, ProSmartTablePageChangePayload, ProSmartTableSkeletonConfig, SmartColumnSchema, SmartFormControlType, SmartColumnSource, SmartSelectOption, } from './components/ProSmartTable';
+export { ProSmartTable, SMART_FORM_CONTROL_OPTIONS, createColumnId, normalizeColumn, cloneColumns, createEmptyColumn, resolveFormControlType, } from './components/ProSmartTable';
+export type { ProColumnEditorProps, ProColumnEditorEmits, } from './components/ProColumnEditor';
+export { ProColumnEditor } from './components/ProColumnEditor';
+export type { VueSmartTableOptions } from './plugin';
+export { VueSmartTable } from './plugin';
+export { default } from './plugin';

package/dist/src/plugin.d.ts

@@ -0,0 +1,8 @@
+import { Plugin } from 'vue';
+export interface VueSmartTableOptions {
+    /** 全局组件名前缀，默认无前缀 */
+    prefix?: string;
+}
+declare const VueSmartTable: Plugin<VueSmartTableOptions>;
+export { VueSmartTable };
+export default VueSmartTable;

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@hz_yujin/vue-smart-table",
+  "version": "0.1.2",
+  "description": "Vue 3 ProSmartTable：基于 el-table 全量透传，列 schema 驱动查询 / 表单 / 列管理抽屉",
+  "type": "module",
+  "keywords": [
+    "vue",
+    "vue3",
+    "table",
+    "el-table",
+    "component",
+    "typescript",
+    "element-plus",
+    "pro-smart-table",
+    "crud"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "author": "hz_yujin",
+  "homepage": "https://www.npmjs.com/package/@hz_yujin/vue-smart-table",
+  "bugs": {
+    "url": "https://www.npmjs.com/package/@hz_yujin/vue-smart-table"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./style.css": "./dist/index.css",
+    "./package.json": "./package.json"
+  },
+  "sideEffects": [
+    "**/*.css",
+    "**/*.vue"
+  ],
+  "scripts": {
+    "build": "vue-tsc -b && vite build",
+    "prepublishOnly": "pnpm run build"
+  },
+  "peerDependencies": {
+    "@element-plus/icons-vue": "^2.3.0",
+    "element-plus": "^2.9.0",
+    "vue": "^3.5.0"
+  },
+  "devDependencies": {
+    "@element-plus/icons-vue": "^2.3.2",
+    "@types/node": "^24.13.3",
+    "@vitejs/plugin-vue": "^6.0.7",
+    "@vue/tsconfig": "^0.9.1",
+    "element-plus": "^2.14.2",
+    "typescript": "~6.0.2",
+    "vite": "^8.1.1",
+    "vite-plugin-dts": "^4.5.4",
+    "vue": "^3.5.39",
+    "vue-tsc": "^3.3.5"
+  }
+}