@es-plus/vue3 1.4.0

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

@@ -0,0 +1,174 @@
+import { VNode, RenderFunction } from 'vue';
+import { FormProps, ButtonProps } from 'element-plus';
+
+export interface FormItemOption {
+    prop: string;
+    label: string;
+    labelKey?: string;
+    formtype?: 'Input' | 'Select' | 'datePicker' | 'timePicker' | 'Slider' | 'ColorPicker' | 'Transfer' | 'Cascader' | 'Radio' | 'Checkbox' | 'Switch' | 'Rate' | 'Upload';
+    span?: number;
+    attrs?: Record<string, unknown>;
+    on?: Record<string, unknown>;
+    dataOptions?: Array<{
+        label: string;
+        value: unknown;
+    }>;
+    isHidden?: (model: Record<string, unknown>, item: FormItemOption, formProps: FormProps) => boolean;
+    render?: (h: RenderFunction, model: Record<string, unknown>, ctx: {
+        row: FormItemOption;
+        index: number;
+    }) => VNode | string;
+    apiParams?: ApiParams;
+    /** 是否在组件初始化时自动加载接口数据，默认 true；设为 false 时需手动调用 formItmeRequestInstance 加载 */
+    isInitRun?: boolean;
+    callOptionListFormat?: (data: unknown[]) => unknown[];
+    /** 自定义 HTTP 请求方法，用于覆盖全局请求配置 */
+    httpRequest?: (params: Record<string, unknown>) => Promise<unknown>;
+    /** 响应数据回调映射，crtn 用于将 API 响应转换为 dataOptions 格式 */
+    listenToCallBack?: Record<string, (params: unknown) => unknown>;
+    components?: Record<string, unknown>;
+    width?: number | string;
+    [key: string]: unknown;
+}
+export interface ApiParams {
+    url: string;
+    method?: string;
+    headers?: Record<string, string>;
+    model?: Record<string, unknown>;
+    options?: Record<string, unknown>;
+}
+export interface BtnConfig {
+    name: string;
+    key?: string;
+    type?: ButtonProps['type'];
+    size?: ButtonProps['size'];
+    icon?: string;
+    direction?: 'left' | 'right';
+    loading?: boolean;
+    disabled?: boolean | (() => boolean);
+    permissionValue?: string;
+    click?: (model: Record<string, unknown>, formRef: unknown, httpRequestInstance?: unknown) => void;
+    [key: string]: unknown;
+}
+export interface LayoutFormProps {
+    rowLayProps?: Record<string, unknown>;
+    fromLayProps?: {
+        isBtnHidden?: boolean;
+        minFoldRows?: number;
+        btnColSpan?: number;
+        labelBtnWidth?: string | number;
+    };
+    setOptions?: boolean;
+}
+export interface TableColumn {
+    prop?: string;
+    key?: string;
+    label?: string;
+    labelKey?: string;
+    width?: number | string;
+    minWidth?: number | string;
+    align?: string;
+    fixed?: boolean | string;
+    formatter?: (row: Record<string, unknown>) => string;
+    render?: (h: RenderFunction, ctx: {
+        row: Record<string, unknown>;
+        value: unknown;
+        index: number;
+    }) => VNode | string;
+    scopedSlots?: {
+        customRender?: string;
+    };
+    groups?: TableColumn[];
+    ellipsis?: boolean;
+    hidCol?: boolean;
+    btns?: Array<{
+        name: string;
+        type?: string;
+        clickEvent?: (row: Record<string, unknown>) => void;
+    }>;
+    [key: string]: unknown;
+}
+export interface TableOptions {
+    multiSelect?: boolean;
+    expand?: boolean;
+    snIndex?: boolean;
+    loading?: boolean;
+    border?: boolean;
+    stripe?: boolean;
+    size?: 'large' | 'default' | 'small';
+    headerCellStyle?: Record<string, unknown>;
+    highlightCurrentRow?: boolean;
+    cachePageSelection?: boolean;
+    heightType?: 'auto' | 'height' | 'maxHeight';
+    tabHeight?: number | string;
+    isInitRun?: boolean;
+    actionUrl?: string;
+    apiParams?: ApiParams;
+    httpRequest?: (params: Record<string, unknown>) => Promise<unknown>;
+    listenToCallBack?: Record<string, (params: unknown) => unknown>;
+    configTableOut?: Record<string, string>;
+    entryQuery?: Record<string, unknown>;
+    configBtn?: BtnConfig[];
+    leftText?: string;
+    rowkey?: string;
+    height?: number | string;
+    /** 启用虚拟滚动（等同 engine: 'virtual'） */
+    virtual?: boolean;
+    /** 表格渲染引擎：default=el-table, virtual=el-table-v2 */
+    engine?: 'default' | 'virtual';
+    /** 虚拟滚动行高（默认 50） */
+    rowHeight?: number;
+    /** 动态行高预估值 */
+    estimatedRowHeight?: number;
+    /** 可视区域外预渲染行数（默认 2） */
+    overscanCount?: number;
+    /** 行类名（虚拟模式支持函数） */
+    rowClassName?: string | ((params: {
+        row: Record<string, unknown>;
+        rowIndex: number;
+    }) => string);
+    [key: string]: unknown;
+}
+export interface PaginationConfig {
+    pageSize?: number;
+    current?: number;
+    total?: number;
+    pageSizes?: number[];
+    size?: 'large' | 'default' | 'small';
+    isSmall?: boolean;
+}
+export interface DialogOptions {
+    title?: string;
+    width?: string | number;
+    render?: (h: RenderFunction, instance: unknown, components: Record<string, unknown>) => VNode;
+    renderHeader?: (h: RenderFunction, instance: unknown) => VNode;
+    renderFooter?: (h: RenderFunction, instance: unknown) => VNode;
+    configBtn?: BtnConfig[];
+    onSubmit?: (close: () => void) => void;
+    onClosed?: () => void;
+    isDraggable?: boolean;
+    hiddenFullBtn?: boolean;
+    isHiddenFooter?: boolean;
+    maxHeight?: string | number;
+    appendTo?: string | HTMLElement;
+    fullscreen?: boolean;
+    [key: string]: unknown;
+}
+export interface EsFormInstance {
+    validate: () => Promise<boolean>;
+    resetFields: () => void;
+    clearValidate: () => void;
+}
+export interface EsTableInstance {
+    httpRequestInstance: (model?: Record<string, unknown>) => Promise<unknown>;
+    clearSelection: () => void;
+    toggleRowSelection: (row: Record<string, unknown>, selected?: boolean) => void;
+    clearAllSelection: () => void;
+    refresh: () => void;
+}
+export interface EsPlusOptions {
+    permission?: (value: string) => boolean;
+    t?: (key: string) => string;
+    globalProperties?: boolean;
+    [key: string]: unknown;
+}

package/dist/src/utils/shared.d.ts

@@ -0,0 +1,17 @@
+export declare const isObject: (value: unknown) => value is Record<string, unknown>;
+export declare const isArray: (value: unknown) => value is unknown[];
+export declare const isFunction: (value: unknown) => value is Function;
+export declare const isString: (value: unknown) => value is string;
+export declare const isNumber: (value: unknown) => value is number;
+export declare const isEmpty: (value: unknown) => boolean;
+export declare const firstWordUpperCase: (str: string) => string;
+export declare const kebabToCamel: (str: string) => string;
+export declare const toPascalCase: (str: string) => string;
+export declare const findValueByKey: (obj: Record<string, unknown>, key: string, depth?: number) => unknown;
+export declare const wrapPromise: <T>(promise: Promise<T>) => Promise<{
+    status: "fulfilled";
+    value: T;
+} | {
+    status: "rejected";
+    reason: unknown;
+}>;

package/dist/style.css

@@ -0,0 +1 @@
+@charset "UTF-8";.btns[data-v-8f7dddb8]{padding:0 0 5px;display:flex;justify-content:space-between;align-items:center}.left-text[data-v-8f7dddb8]{color:#7d7d7d;font-size:14px}.btn-container_block[data-v-8f7dddb8]{display:flex;justify-content:space-between;align-items:center;flex:1}.btn-container_block .btn-left[data-v-8f7dddb8]{display:flex;justify-content:flex-start;align-items:center;flex-wrap:wrap}.btn-container_block .btn-right[data-v-8f7dddb8]{display:flex;justify-content:flex-end;align-items:center;flex-wrap:wrap}@media (max-width: 768px){.btns[data-v-8f7dddb8]{flex-direction:column;align-items:flex-start}.btn-container_block[data-v-8f7dddb8]{flex-direction:column;align-items:flex-start;gap:10px}.btn-container_block .btn-left[data-v-8f7dddb8],.btn-container_block .btn-right[data-v-8f7dddb8]{width:100%;justify-content:flex-start}}.es-virtual-table-wrapper{position:relative;width:100%}.es-virtual-table--border .el-table-v2{border:1px solid var(--el-border-color-lighter)}.es-virtual-table--border .el-table-v2 .el-table-v2__header-cell,.es-virtual-table--border .el-table-v2 .el-table-v2__row-cell{border-right:1px solid var(--el-border-color-lighter);border-bottom:1px solid var(--el-border-color-lighter)}.es-virtual-table--stripe .el-table-v2__row:nth-child(2n){background-color:var(--el-fill-color-lighter)}.es-virtual-table--highlight .el-table-v2__row.current-row{background-color:var(--el-color-primary-light-9)!important}.es-virtual-table--highlight .el-table-v2__row:hover{background-color:var(--el-fill-color-light)}.es-virtual-table__empty{position:absolute;top:50px;left:0;right:0;bottom:0;display:flex;align-items:center;justify-content:center;background:#fff;z-index:1}.es-virtual-table__empty .ant-empty-image{height:40px;margin-bottom:8px}.es-virtual-table__empty .ant-empty-img-simple-ellipse{fill:#f5f5f5}.es-virtual-table__empty .ant-empty-img-simple-g{stroke:#d9d9d9}.es-virtual-table__empty .ant-empty-img-simple-path{fill:#fafafa}.es-virtual-table__empty .ant-empty-description{color:#00000040;font-size:14px}.es-virtual-expand-icon{color:var(--el-text-color-secondary)}.es-virtual-expand-icon:hover{color:var(--el-color-primary)}.el-dp_tables[data-v-8904b77a],.el-dp_tables[data-v-8904b77a] .el-table__body-wrapper{height:auto}.table_component[data-v-8904b77a]{width:100%;display:flex;flex-direction:column;justify-content:space-between;align-items:flex-start;overflow:hidden}.table_containers[data-v-8904b77a]{flex:1;width:100%;height:100%;display:flex;justify-content:space-between;flex-direction:column;align-items:flex-start;position:relative}.pagination_page[data-v-8904b77a]{width:100%;display:flex;justify-content:center;align-items:center}.btn-slot[data-v-8904b77a]{width:100%}.btn-slot .headerBar[data-v-8904b77a]{box-sizing:border-box;background-color:#fff;border-radius:6px}.btn-slot .headerBar[data-v-8904b77a] .el-form-item--small .el-form-item__label{box-sizing:border-box}.tableContainer[data-v-8904b77a]{border-radius:0;transition:all 1.5s;flex:1;width:100%;display:flex;justify-content:space-between;flex-direction:column;align-items:flex-start}.tableContainer .table_inner_containers[data-v-8904b77a]{width:100%}.tableContainer[data-v-8904b77a] .el-table__empty-block{width:100%!important;margin:32px 0;font-size:14px;line-height:1.5715}.tableContainer[data-v-8904b77a] .el-table__empty-block .el-table__empty-text{width:auto!important}.tableContainer[data-v-8904b77a] .el-table__empty-block .ant-empty-image{height:40px;margin-bottom:8px}.tableContainer[data-v-8904b77a] .el-table__empty-block .ant-empty-image .ant-empty-img-simple-ellipse{fill:#f5f5f5}.tableContainer[data-v-8904b77a] .el-table__empty-block .ant-empty-image .ant-empty-img-simple-g{stroke:#d9d9d9}.tableContainer[data-v-8904b77a] .el-table__empty-block .ant-empty-image .ant-empty-img-simple-path{fill:#fafafa}.tableContainer[data-v-8904b77a] .el-table__empty-block .ant-empty-description{line-height:1.5715;color:#00000040}.tableContainer[data-v-8904b77a] .el-tag{height:20px;padding:0 7px;line-height:20px;background:#fafafa;border:none;border-radius:4px}.tableContainer[data-v-8904b77a] .el-tag.el-tag--info{color:#000000d9}.tableContainer[data-v-8904b77a] .el-tag.el-tag--success{color:#52c41a;background:#f6ffed;border-color:#b7eb8f}.es-form[data-v-490779d8] .el-form-item{margin-bottom:18px}.es-form[data-v-490779d8] .el-form-item__label{font-weight:500}.es-form .buttonOperate[data-v-490779d8]{display:flex;align-items:center;flex-wrap:wrap;gap:8px}.es-form .leftRightBtn[data-v-490779d8]{display:flex;justify-content:space-between;align-items:center;width:100%}.es-form .leftRightBtn .btn-left[data-v-490779d8],.es-form .leftRightBtn .btn-right[data-v-490779d8]{display:flex;align-items:center}.es-form .btn-formItem[data-v-490779d8]{margin-bottom:0}.es-form .formItemCols[data-v-490779d8]{width:100%}.dp-dialog_wrapper[data-v-8464358d] .dialogAuto{margin:0!important}.dp-dialog_wrapper[data-v-8464358d] .el-overlay-dialog{display:flex;justify-content:center;align-items:center}.dp-dialog_wrapper[data-v-8464358d] .el-dialog{padding:10px}.dp-dialog_wrapper[data-v-8464358d] .el-dialog .el-dialog__footer{padding-top:0}.dp-dialog_wrapper[data-v-8464358d] .el-dialog .el-dialog__body{padding:10px 0}.dp-dialog_wrapper[data-v-8464358d] .el-dialog .el-dialog__header{border-bottom:1px solid #eee;display:flex;padding:0 0 10px;align-items:center;justify-content:space-between;margin:0}.dialog-title[data-v-8464358d]{line-height:24px;font-size:14px;color:#303133;font-weight:700}.btns[data-v-8464358d]{display:flex;align-items:center}.btns i[data-v-8464358d]{margin-right:8px;font-size:14px;cursor:pointer}.btns i[data-v-8464358d]:last-child{margin-right:0}.dialog_body_layouts[data-v-8464358d]{overflow-y:auto;overflow-x:hidden;scrollbar-width:thin;scrollbar-color:rgba(135,162,189,.1490196078) rgba(200,213,225,.2784313725)}[data-v-8464358d]::-webkit-scrollbar{width:14px;height:14px}[data-v-8464358d]::-webkit-scrollbar-button{width:0;height:0;display:none}[data-v-8464358d]::-webkit-scrollbar-corner{background-color:transparent}[data-v-8464358d]::-webkit-scrollbar-thumb{min-height:12px;border:4px solid transparent;background-clip:content-box;border-radius:7px;background-color:#c8d5e1}[data-v-8464358d]::-webkit-scrollbar-thumb:hover{background-color:#a8bbcf}[data-v-8464358d]::-webkit-scrollbar-thumb:active{background-color:#87a2bd}[data-v-8464358d]::-webkit-scrollbar-track{background-color:transparent}[data-v-8464358d]::-webkit-scrollbar-track-piece{background-color:transparent}.es-crud-page[data-v-7dea095a]{width:100%}.svg-icon[data-v-50f5fe3f]{width:1em;height:1em;vertical-align:-.15em;fill:currentColor;overflow:hidden}.svg-external-icon[data-v-50f5fe3f]{background-color:currentColor;-webkit-mask-size:cover!important;mask-size:cover!important;display:inline-block}

package/package.json

@@ -0,0 +1,90 @@
+{
+  "name": "@es-plus/vue3",
+  "version": "1.4.0",
+  "description": "es-plus for Vue 3 + Element Plus: configuration-driven enterprise components, sharing the same JSON config schema as @es-plus/vue2 (Vue 2 + Element UI). Renamed from es-plus-ui starting v1.4.0.",
+  "type": "module",
+  "main": "./dist/es-plus.umd.cjs",
+  "module": "./dist/es-plus.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/es-plus.js",
+      "require": "./dist/es-plus.umd.cjs",
+      "types": "./dist/index.d.ts"
+    },
+    "./resolver": {
+      "import": "./dist/resolver.mjs",
+      "require": "./dist/resolver.cjs",
+      "types": "./dist/resolver.d.ts"
+    },
+    "./dist/style.css": "./dist/style.css",
+    "./schemas/*": "./schemas/*"
+  },
+  "files": [
+    "dist",
+    "schemas",
+    "README.md"
+  ],
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "scripts": {
+    "typecheck": "vue-tsc --noEmit -p tsconfig.build.json",
+    "typecheck:all": "vue-tsc --noEmit",
+    "build": "vite build",
+    "prepublishOnly": "npm run typecheck && npm run build",
+    "test": "vitest",
+    "test:ui": "vitest --ui",
+    "test:coverage": "vitest --coverage"
+  },
+  "keywords": [
+    "vue3",
+    "vue",
+    "element-plus",
+    "component-library",
+    "form",
+    "table",
+    "dialog",
+    "es-plus",
+    "typescript",
+    "enterprise",
+    "config-driven",
+    "crud",
+    "json-schema",
+    "ai-friendly"
+  ],
+  "author": "liujiaao <303363554@qq.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/liujiaao/es-plus.git",
+    "directory": "packages/es-plus"
+  },
+  "homepage": "https://liujiaao.github.io/es-plus/",
+  "bugs": {
+    "url": "https://github.com/liujiaao/es-plus/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "peerDependencies": {
+    "@element-plus/icons-vue": "^2.1.0",
+    "element-plus": "^2.2.0",
+    "vue": "^3.2.0"
+  },
+  "devDependencies": {
+    "@vitejs/plugin-vue": "^5.0.0",
+    "@vitejs/plugin-vue-jsx": "^4.0.0",
+    "@vue/test-utils": "^2.4.0",
+    "element-plus": "^2.5.0",
+    "happy-dom": "^14.0.0",
+    "sass": "^1.70.0",
+    "typescript": "^5.3.0",
+    "vite": "^5.0.0",
+    "vite-plugin-dts": "^3.7.0",
+    "vitest": "^1.2.0",
+    "vue": "^3.4.0",
+    "vue-tsc": "^3.3.1"
+  }
+}

package/schemas/README.md

@@ -0,0 +1,83 @@
+# @es-plus/vue3 JSON Schema
+
+JSON Schema definitions for `@es-plus/vue3` configuration objects. Enables IDE autocompletion, validation, and hover documentation when writing `@es-plus/vue3` configs. The same schemas describe `@es-plus/vue2` configs (renderers share identical config shape).
+
+## Usage in VS Code
+
+### Method 1: Per-file `$schema` (for JSON config files)
+
+```json
+{
+  "$schema": "node_modules/@es-plus/vue3/schemas/form-item.schema.json",
+  "prop": "name",
+  "label": "Name",
+  "formtype": "Input"
+}
+```
+
+### Method 2: VS Code settings (for `.json` files matching a pattern)
+
+Add to `.vscode/settings.json`:
+
+```json
+{
+  "json.schemas": [
+    {
+      "fileMatch": ["**/form-items.json", "**/formItems.json"],
+      "url": "./node_modules/@es-plus/vue3/schemas/form-item.schema.json"
+    },
+    {
+      "fileMatch": ["**/table-columns.json", "**/columns.json"],
+      "url": "./node_modules/@es-plus/vue3/schemas/table-column.schema.json"
+    },
+    {
+      "fileMatch": ["**/table-options.json"],
+      "url": "./node_modules/@es-plus/vue3/schemas/table-options.schema.json"
+    }
+  ]
+}
+```
+
+### Method 3: Use with AI coding assistants
+
+When using Cursor, Claude Code, or GitHub Copilot, include the schema in your prompt context:
+
+```
+Use the @es-plus/vue3 JSON Schema at node_modules/@es-plus/vue3/schemas/index.schema.json
+to generate valid configuration for my CRUD page.
+```
+
+## Available Schemas
+
+| Schema | Description |
+|--------|-------------|
+| `form-item.schema.json` | Single form field config (FormItemOption) |
+| `table-column.schema.json` | Single table column config (TableColumn) |
+| `table-options.schema.json` | Table options config (TableOptions) |
+| `btn-config.schema.json` | Button config (BtnConfig) |
+| `dialog-options.schema.json` | Dialog options for useDialog() |
+| `api-params.schema.json` | API request parameters |
+| `index.schema.json` | Root schema with all definitions |
+
+## Schema Structure
+
+```
+index.schema.json
+├── form-item.schema.json
+│   └── api-params.schema.json
+├── table-column.schema.json
+├── table-options.schema.json
+│   ├── api-params.schema.json
+│   └── btn-config.schema.json
+├── btn-config.schema.json
+└── dialog-options.schema.json
+    └── btn-config.schema.json
+```
+
+## Vue 2 users
+
+`@es-plus/vue2` ships the same schema files at `node_modules/@es-plus/vue2/schemas/...`. Substitute the package name in the paths above. Configs validated against either set are runtime-compatible with both renderers.
+
+## Legacy users (`es-plus-ui`)
+
+If you still depend on the deprecated `es-plus-ui` stub package, the old paths `node_modules/es-plus-ui/schemas/...` no longer exist (the stub does not re-export schemas). Migrate the import path to `@es-plus/vue3` per the [v1.4 migration guide](https://github.com/liujiaao/es-plus/blob/master/docs/migrate-v1.4.md).

package/schemas/api-params.schema.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://es-plus-ui.github.io/schemas/api-params.schema.json",
+  "title": "API Parameters Configuration",
+  "description": "Configuration for API requests in @es-plus/vue3 components",
+  "type": "object",
+  "required": ["url"],
+  "properties": {
+    "url": {
+      "type": "string",
+      "description": "API endpoint URL"
+    },
+    "method": {
+      "type": "string",
+      "enum": ["GET", "POST", "PUT", "DELETE", "PATCH"],
+      "default": "GET",
+      "description": "HTTP request method"
+    },
+    "headers": {
+      "type": "object",
+      "description": "Request headers",
+      "additionalProperties": { "type": "string" }
+    },
+    "model": {
+      "type": "object",
+      "description": "Additional parameters merged into the request",
+      "additionalProperties": true
+    },
+    "options": {
+      "type": "object",
+      "description": "Extra request options",
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": true
+}

package/schemas/btn-config.schema.json

@@ -0,0 +1,77 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://es-plus-ui.github.io/schemas/btn-config.schema.json",
+  "title": "Button Configuration",
+  "description": "Configuration for action buttons in @es-plus/vue3 EsForm and EsTable",
+  "type": "object",
+  "required": ["name"],
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Button display text"
+    },
+    "key": {
+      "type": "string",
+      "description": "Button identifier. Special values: 'query' triggers table data fetch, 'reset' resets the form",
+      "examples": ["query", "reset", "add", "export"]
+    },
+    "type": {
+      "type": "string",
+      "enum": ["primary", "success", "warning", "danger", "info", ""],
+      "description": "Button visual type (Element Plus button types)"
+    },
+    "size": {
+      "type": "string",
+      "enum": ["large", "default", "small"],
+      "description": "Button size"
+    },
+    "icon": {
+      "type": "string",
+      "description": "Element Plus icon name (e.g., 'Search', 'Plus', 'Delete')"
+    },
+    "direction": {
+      "type": "string",
+      "enum": ["left", "right"],
+      "default": "right",
+      "description": "Button alignment in the form button area"
+    },
+    "loading": {
+      "type": "boolean",
+      "default": false,
+      "description": "Show loading spinner on the button"
+    },
+    "disabled": {
+      "oneOf": [
+        { "type": "boolean" }
+      ],
+      "description": "Disable the button. Can be a boolean or a function () => boolean"
+    },
+    "triggerEvent": {
+      "type": "boolean",
+      "default": false,
+      "description": "When true, automatically triggers form-table linkage. With key='query', calls parent EsTable's httpRequestInstance. With key='reset', resets form fields"
+    },
+    "click": {
+      "description": "Click handler. In form context: (model, formRef, httpRequestInstance?) => void. In dialog context: (instance, { close, getRefs, dialogVm }) => void"
+    },
+    "code": {
+      "type": "integer",
+      "enum": [1, 2],
+      "description": "Button group position in table toolbar. 1 = left group, 2 = right group"
+    },
+    "isHide": {
+      "oneOf": [
+        { "type": "boolean" }
+      ],
+      "description": "Hide the button. Can be a boolean or a function () => boolean"
+    },
+    "permissionValue": {
+      "type": "string",
+      "description": "Permission code for button visibility control"
+    },
+    "render": {
+      "description": "Custom render function for the button slot"
+    }
+  },
+  "additionalProperties": true
+}

package/schemas/dialog-options.schema.json

@@ -0,0 +1,149 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://es-plus-ui.github.io/schemas/dialog-options.schema.json",
+  "title": "useDialog Options Configuration",
+  "description": "Configuration object passed to the useDialog() hook in @es-plus/vue3",
+  "type": "object",
+  "properties": {
+    "title": {
+      "type": "string",
+      "description": "Dialog title"
+    },
+    "width": {
+      "oneOf": [
+        { "type": "string" },
+        { "type": "number" }
+      ],
+      "default": "50%",
+      "description": "Dialog width (CSS value or number in px)"
+    },
+    "height": {
+      "oneOf": [
+        { "type": "string" },
+        { "type": "number" }
+      ],
+      "description": "Dialog height"
+    },
+    "maxHeight": {
+      "oneOf": [
+        { "type": "string" },
+        { "type": "number" }
+      ],
+      "description": "Maximum height for dialog body content area"
+    },
+    "key": {
+      "type": "string",
+      "description": "Unique identifier. Same key reuses dialog instance"
+    },
+    "render": {
+      "description": "Content render function. Signature: (h, { registerRef, getRefs }, components) => VNode"
+    },
+    "renderHeader": {
+      "description": "Header render function. Signature: (h, instance) => VNode"
+    },
+    "renderFooter": {
+      "description": "Footer render function. Signature: (h, instance) => VNode"
+    },
+    "configBtn": {
+      "type": "array",
+      "description": "Footer action buttons. Click signature: (currentRef, { close, getRefs, dialogInstance }) => void",
+      "items": { "$ref": "btn-config.schema.json" }
+    },
+    "isDraggable": {
+      "type": "boolean",
+      "default": false,
+      "description": "Enable drag to move the dialog"
+    },
+    "fullscreen": {
+      "type": "boolean",
+      "default": false,
+      "description": "Start dialog in fullscreen mode"
+    },
+    "hiddenFullBtn": {
+      "type": "boolean",
+      "default": false,
+      "description": "Hide the fullscreen toggle button in header"
+    },
+    "isHiddenFooter": {
+      "type": "boolean",
+      "default": false,
+      "description": "Hide the entire footer section"
+    },
+    "center": {
+      "type": "boolean",
+      "description": "Vertically center the dialog"
+    },
+    "closeOnClickModal": {
+      "type": "boolean",
+      "default": false,
+      "description": "Close dialog when clicking the overlay mask"
+    },
+    "closeOnPressEscape": {
+      "type": "boolean",
+      "default": false,
+      "description": "Close dialog when pressing ESC key"
+    },
+    "showClose": {
+      "type": "boolean",
+      "default": true,
+      "description": "Show the close button in header"
+    },
+    "destroyOnClose": {
+      "type": "boolean",
+      "default": true,
+      "description": "Destroy dialog content when closed"
+    },
+    "loading": {
+      "type": "boolean",
+      "default": false,
+      "description": "Show loading state on the dialog"
+    },
+    "customClass": {
+      "type": "string",
+      "description": "Custom CSS class for the dialog"
+    },
+    "appendToBody": {
+      "type": "boolean",
+      "description": "Mount dialog to document body"
+    },
+    "appendTo": {
+      "type": "string",
+      "description": "CSS selector or HTMLElement for dialog mount target"
+    },
+    "modal": {
+      "type": "boolean",
+      "description": "Show overlay mask behind dialog"
+    },
+    "lockScroll": {
+      "type": "boolean",
+      "description": "Lock page scroll when dialog is open"
+    },
+    "onlyInstance": {
+      "type": "boolean",
+      "default": false,
+      "description": "Singleton mode: reuses one dialog instance, updates content on subsequent calls"
+    },
+    "showDefaultButtons": {
+      "type": "boolean",
+      "description": "Show default Confirm/Cancel buttons"
+    },
+    "confirmText": {
+      "type": "string",
+      "description": "Custom text for the confirm button"
+    },
+    "cancelText": {
+      "type": "string",
+      "description": "Custom text for the cancel button"
+    },
+    "onSubmit": {
+      "description": "Submit callback. Signature: (close) => void"
+    },
+    "onClosed": {
+      "description": "Callback fired after dialog is fully closed"
+    },
+    "onOpen": {
+      "description": "Callback fired when dialog opens"
+    }
+  },
+  "additionalProperties": true
+}