@smallwei/avue 3.9.1 → 3.9.2

package/lib/src/core/option.js

@@ -0,0 +1,212 @@
+/*! Avue.js v3.9.2 | (c) 2017-2026 Smallwei | Released under the MIT License. */
+'use strict';
+
+var src_global_variable = require('../global/variable.js');
+
+const warned = new Set();
+const KNOWN_TYPES = new Set([
+    '',
+    'input',
+    'textarea',
+    'password',
+    'phone',
+    'currency',
+    'bankCard',
+    'idCard',
+    'email',
+    'code',
+    'plate',
+    'ip',
+    'mac',
+    'uscc',
+    'number',
+    'switch',
+    'upload',
+    'img',
+    'array',
+    'url',
+    'dynamic',
+    'slider',
+    'rate',
+    'input-tag',
+    'tag',
+    'mention',
+    'input-table',
+    'input-tree',
+    'input-icon',
+    'input-map',
+    'input-color',
+    'input-number',
+    'input-cron',
+    'cron',
+    'title',
+    ...src_global_variable.DATE_LIST,
+    ...src_global_variable.SELECT_LIST,
+]);
+const isObject = (value) => {
+    return value && Object.prototype.toString.call(value) === '[object Object]';
+};
+const normalizeColumn = (column, path, warnings) => {
+    if (Array.isArray(column)) {
+        return column.map((item, index) => ({
+            item,
+            path: `${path}[${index}]`,
+        }));
+    }
+    if (isObject(column)) {
+        return Object.keys(column).map((prop) => ({
+            item: {
+                ...column[prop],
+                prop: column[prop].prop || prop,
+            },
+            path: `${path}.${prop}`,
+        }));
+    }
+    warnings.push({
+        path,
+        message: 'column 应为数组或对象格式',
+    });
+    return [];
+};
+const validSpan = (value) => {
+    return value === undefined || (Number(value) >= 1 && Number(value) <= 24);
+};
+const visitColumns = (column, path, warnings, propMap) => {
+    normalizeColumn(column, path, warnings).forEach(({ item, path: itemPath }) => {
+        if (!isObject(item)) {
+            warnings.push({
+                path: itemPath,
+                message: '字段配置应为对象',
+            });
+            return;
+        }
+        if (!item.prop) {
+            warnings.push({
+                path: itemPath,
+                message: '缺少 prop，字段无法稳定绑定表单值或表格列',
+            });
+        }
+        else if (propMap[item.prop]) {
+            warnings.push({
+                path: itemPath,
+                message: `prop "${item.prop}" 重复，已在 ${propMap[item.prop]} 出现`,
+            });
+        }
+        else {
+            propMap[item.prop] = itemPath;
+        }
+        if (!item.label && item.type !== 'title') {
+            warnings.push({
+                path: itemPath,
+                message: '建议补充 label，避免表头或表单标签为空',
+            });
+        }
+        if (!validSpan(item.span)) {
+            warnings.push({
+                path: `${itemPath}.span`,
+                message: 'span 应在 1 到 24 之间',
+            });
+        }
+        if (!validSpan(item.searchSpan)) {
+            warnings.push({
+                path: `${itemPath}.searchSpan`,
+                message: 'searchSpan 应在 1 到 24 之间',
+            });
+        }
+        if (item.type && !KNOWN_TYPES.has(item.type)) {
+            warnings.push({
+                path: `${itemPath}.type`,
+                message: `未知字段类型 "${item.type}"，请确认是否已注册自定义组件`,
+            });
+        }
+        if (item.dicData !== undefined && !Array.isArray(item.dicData)) {
+            warnings.push({
+                path: `${itemPath}.dicData`,
+                message: 'dicData 应为数组',
+            });
+        }
+        if (item.rules !== undefined && !Array.isArray(item.rules)) {
+            warnings.push({
+                path: `${itemPath}.rules`,
+                message: 'rules 应为数组',
+            });
+        }
+        if (item.props !== undefined && !isObject(item.props)) {
+            warnings.push({
+                path: `${itemPath}.props`,
+                message: 'props 应为对象',
+            });
+        }
+        if (item.cascader !== undefined && !Array.isArray(item.cascader)) {
+            warnings.push({
+                path: `${itemPath}.cascader`,
+                message: 'cascader 应为 prop 数组',
+            });
+        }
+        if (item.children && item.children.column) {
+            visitColumns(item.children.column, `${itemPath}.children.column`, warnings, propMap);
+        }
+    });
+};
+const validateOption = (option = {}, component = 'component') => {
+    const warnings = [];
+    if (!isObject(option)) {
+        return [
+            {
+                path: component,
+                message: 'option 应为对象',
+            },
+        ];
+    }
+    if (!validSpan(option.span)) {
+        warnings.push({
+            path: `${component}.span`,
+            message: 'span 应在 1 到 24 之间',
+        });
+    }
+    if (!validSpan(option.searchSpan)) {
+        warnings.push({
+            path: `${component}.searchSpan`,
+            message: 'searchSpan 应在 1 到 24 之间',
+        });
+    }
+    const propMap = {};
+    if (option.column) {
+        visitColumns(option.column, `${component}.column`, warnings, propMap);
+    }
+    else if (['crud', 'form', 'search'].includes(component)) {
+        warnings.push({
+            path: `${component}.column`,
+            message: '缺少 column 配置',
+        });
+    }
+    if (Array.isArray(option.group)) {
+        option.group.forEach((group, index) => {
+            if (!isObject(group)) {
+                warnings.push({
+                    path: `${component}.group[${index}]`,
+                    message: '分组配置应为对象',
+                });
+                return;
+            }
+            if (group.column) {
+                visitColumns(group.column, `${component}.group[${index}].column`, warnings, propMap);
+            }
+        });
+    }
+    return warnings;
+};
+const warnOption = (warnings = [], component = 'component') => {
+    warnings.forEach((warning) => {
+        const key = `${component}:${warning.path}:${warning.message}`;
+        if (warned.has(key))
+            return;
+        warned.add(key);
+        if (typeof console !== 'undefined' && console.warn) {
+            console.warn(`[Avue option warn][${component}] ${warning.path}: ${warning.message}`);
+        }
+    });
+};
+
+exports.validateOption = validateOption;
+exports.warnOption = warnOption;

package/lib/src/core/packages.js

@@ -1,69 +1,69 @@
-/*! Avue.js v3.9.1 | (c) 2017-2026 Smallwei | Released under the MIT License. */
-'use strict';
-
-Object.defineProperty(exports, '__esModule', { value: true });
-
-var src_plugin_logs_index = require('../plugin/logs/index.js');
-
-const list = {
-    AliOSS: {
-        url: 'https://cdn.staticfile.org/ali-oss/6.17.1/aliyun-oss-sdk.min.js',
-        title: '阿里云图片上传，需要引入 OSS 的 SDK',
-        github: 'https://github.com/ali-sdk/ali-oss/',
-    },
-    Map: {
-        url: 'https://webapi.amap.com/maps?v=1.4.11&key=xxxxx&plugin=AMap.PlaceSearch,https://webapi.amap.com/ui/1.0/main.js?v=1.0.11',
-        title: '地图组件，需要引入高德 SDK',
-    },
-    MapUi: {
-        url: 'https://webapi.amap.com/ui/1.0/main.js?v=1.0.11',
-        title: '地图组件，需要引入高德 UI SDK',
-    },
-    Sortable: {
-        url: 'https://cdn.staticfile.org/Sortable/1.10.0-rc2/Sortable.min.js',
-        title: '拖拽功能，需要引入 SortableJS',
-        github: 'https://github.com/SortableJS/Sortable',
-    },
-    Screenshot: {
-        url: 'https://cdn.staticfile.org/html2canvas/0.5.0-beta4/html2canvas.min.js',
-        title: '需要引入 html2canvas 依赖包',
-        github: 'https://github.com/niklasvh/html2canvas/',
-    },
-    COS: {
-        url: 'https://avuejs.com/cdn/cos-js-sdk-v5.min.js',
-        title: '腾讯云图片上传，需要引入 COS',
-    },
-    CryptoJS: {
-        url: 'https://avuejs.com/cdn/CryptoJS.js',
-        title: '七牛云图片上传，需要引入 CryptoJS',
-    },
-    'file-saver': {
-        url: 'https://cdn.staticfile.org/FileSaver.js/2014-11-29/FileSaver.min.js',
-        title: '需要引入文件操作包',
-        github: 'https://github.com/eligrey/FileSaver.js',
-    },
-    xlsx: {
-        url: 'https://cdn.staticfile.org/xlsx/0.18.2/xlsx.full.min.js',
-        title: '需要引入 Excel 操作包',
-        github: 'https://github.com/protobi/js-xlsx',
-    },
-    mock: {
-        url: 'https://cdn.staticfile.org/Mock.js/1.0.1-beta3/mock-min.js',
-        title: '需要引入 Mock 模拟数据包',
-        github: 'https://github.com/Colingo/mock',
-    },
-};
-var packages = (() => {
-    return {
-        logs(name) {
-            const obj = list[name];
-            if (!obj)
-                return;
-            src_plugin_logs_index.default.capsule(name, obj.title, 'warning');
-            src_plugin_logs_index.default.warning('CDN:' + (obj.url || '-'));
-            src_plugin_logs_index.default.warning('GITHUB:' + (obj.github || '-'));
-        },
-    };
-})();
-
-exports.default = packages;
+/*! Avue.js v3.9.2 | (c) 2017-2026 Smallwei | Released under the MIT License. */
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var src_plugin_logs_index = require('../plugin/logs/index.js');
+
+const list = {
+    AliOSS: {
+        url: 'https://cdn.staticfile.org/ali-oss/6.17.1/aliyun-oss-sdk.min.js',
+        title: '阿里云图片上传，需要引入 OSS 的 SDK',
+        github: 'https://github.com/ali-sdk/ali-oss/',
+    },
+    Map: {
+        url: 'https://webapi.amap.com/maps?v=1.4.11&key=xxxxx&plugin=AMap.PlaceSearch,https://webapi.amap.com/ui/1.0/main.js?v=1.0.11',
+        title: '地图组件，需要引入高德 SDK',
+    },
+    MapUi: {
+        url: 'https://webapi.amap.com/ui/1.0/main.js?v=1.0.11',
+        title: '地图组件，需要引入高德 UI SDK',
+    },
+    Sortable: {
+        url: 'https://cdn.staticfile.org/Sortable/1.10.0-rc2/Sortable.min.js',
+        title: '拖拽功能，需要引入 SortableJS',
+        github: 'https://github.com/SortableJS/Sortable',
+    },
+    Screenshot: {
+        url: 'https://cdn.staticfile.org/html2canvas/0.5.0-beta4/html2canvas.min.js',
+        title: '需要引入 html2canvas 依赖包',
+        github: 'https://github.com/niklasvh/html2canvas/',
+    },
+    COS: {
+        url: 'https://avuejs.com/cdn/cos-js-sdk-v5.min.js',
+        title: '腾讯云图片上传，需要引入 COS',
+    },
+    CryptoJS: {
+        url: 'https://avuejs.com/cdn/CryptoJS.js',
+        title: '七牛云图片上传，需要引入 CryptoJS',
+    },
+    'file-saver': {
+        url: 'https://cdn.staticfile.org/FileSaver.js/2014-11-29/FileSaver.min.js',
+        title: '需要引入文件操作包',
+        github: 'https://github.com/eligrey/FileSaver.js',
+    },
+    xlsx: {
+        url: 'https://cdn.staticfile.org/xlsx/0.18.2/xlsx.full.min.js',
+        title: '需要引入 Excel 操作包',
+        github: 'https://github.com/protobi/js-xlsx',
+    },
+    mock: {
+        url: 'https://cdn.staticfile.org/Mock.js/1.0.1-beta3/mock-min.js',
+        title: '需要引入 Mock 模拟数据包',
+        github: 'https://github.com/Colingo/mock',
+    },
+};
+var packages = (() => {
+    return {
+        logs(name) {
+            const obj = list[name];
+            if (!obj)
+                return;
+            src_plugin_logs_index.default.capsule(name, obj.title, 'warning');
+            src_plugin_logs_index.default.warning('CDN:' + (obj.url || '-'));
+            src_plugin_logs_index.default.warning('GITHUB:' + (obj.github || '-'));
+        },
+    };
+})();
+
+exports.default = packages;

package/lib/src/core/slot.js

@@ -1,39 +1,39 @@
-/*! Avue.js v3.9.1 | (c) 2017-2026 Smallwei | Released under the MIT License. */
-'use strict';
-
-Object.defineProperty(exports, '__esModule', { value: true });
-
-var slot = {
-    methods: {
-        getSlotName(item = {}, type = 'D', slot) {
-            const result = {
-                F: '-form',
-                H: '-header',
-                E: '-error',
-                L: '-label',
-                S: '-search',
-                T: '-type',
-                D: '',
-            };
-            const name = item.prop + result[type];
-            if (slot)
-                return slot[name];
-            return name;
-        },
-        getSlotList(list = [], slot, propList) {
-            const propNames = propList.map((ele) => ele.prop);
-            return Object.keys(slot).filter((ele) => {
-                let result = false;
-                if (!propNames.includes(ele)) {
-                    list.forEach((name) => {
-                        if (ele.includes(name))
-                            result = true;
-                    });
-                }
-                return result;
-            });
-        },
-    },
-};
-
-exports.default = slot;
+/*! Avue.js v3.9.2 | (c) 2017-2026 Smallwei | Released under the MIT License. */
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var slot = {
+    methods: {
+        getSlotName(item = {}, type = 'D', slot) {
+            const result = {
+                F: '-form',
+                H: '-header',
+                E: '-error',
+                L: '-label',
+                S: '-search',
+                T: '-type',
+                D: '',
+            };
+            const name = item.prop + result[type];
+            if (slot)
+                return slot[name];
+            return name;
+        },
+        getSlotList(list = [], slot, propList) {
+            const propNames = propList.map((ele) => ele.prop);
+            return Object.keys(slot).filter((ele) => {
+                let result = false;
+                if (!propNames.includes(ele)) {
+                    list.forEach((name) => {
+                        if (ele.includes(name))
+                            result = true;
+                    });
+                }
+                return result;
+            });
+        },
+    },
+};
+
+exports.default = slot;

package/lib/src/global/variable.js

@@ -1,99 +1,99 @@
-/*! Avue.js v3.9.1 | (c) 2017-2026 Smallwei | Released under the MIT License. */
-'use strict';
-
-const KEY_COMPONENT_NAME = 'avue-';
-const KEY_ECHART_NAME = 'echart-';
-const DIC_PROPS = {
-    rowKey: 'id',
-    rowParentKey: 'parentId',
-    nodeKey: 'id',
-    label: 'label',
-    value: 'value',
-    type: 'type',
-    desc: 'desc',
-    groups: 'groups',
-    title: 'title',
-    leaf: 'leaf',
-    children: 'children',
-    hasChildren: 'hasChildren',
-    labelText: '名称',
-    disabled: 'disabled',
-};
-const DIC_HTTP_PROPS = {
-    name: 'name',
-    url: 'url',
-    fileType: 'type',
-    fileName: 'file',
-    res: '',
-};
-const DATE_LIST = [
-    'dates',
-    'date',
-    'datetime',
-    'datetimerange',
-    'daterange',
-    'time',
-    'timerange',
-    'week',
-    'month',
-    'months',
-    'monthrange',
-    'year',
-    'years',
-    'yearrange',
-];
-const CHILDREN_LIST = ['table', 'dynamic'];
-const INPUT_LIST = ['tree', 'number', 'icon', 'color', 'table', 'map', 'tag'];
-const ARRAY_LIST = ['img', 'array', 'url'];
-const MULTIPLE_LIST = ['cascader', 'tree', 'select', 'table'];
-const RANGE_LIST = ['slider'];
-const ARRAY_VALUE_LIST = ARRAY_LIST.concat([
-    'tag',
-    'upload',
-    'dynamic',
-    'map',
-    'checkbox',
-    'cascader',
-    'timerange',
-    'monthrange',
-    'daterange',
-    'yearrange',
-    'datetimerange',
-    'dates',
-    'months',
-    'years',
-]);
-const SELECT_LIST = DATE_LIST.concat([
-    'select',
-    'checkbox',
-    'radio',
-    'cascader',
-    'tree',
-    'color',
-    'icon',
-    'table',
-    'map',
-]);
-const DIC_SHOW_SPLIT = ' | ';
-const DIC_SPLIT = ',';
-const typeList = {
-    img: /(\.|^)(gif|jpg|jpeg|png|webp|svg|GIF|JPG|JPEG|PNG|WEBP|SVG)/,
-    video: /(\.|^)(swf|avi|flv|mpg|rm|mov|wav|asf|3gp|mkv|rmvb|ogg|mp4)/,
-    audio: /(\.|^)(mp3|wav|MP3|WAV)/,
-};
-
-exports.ARRAY_LIST = ARRAY_LIST;
-exports.ARRAY_VALUE_LIST = ARRAY_VALUE_LIST;
-exports.CHILDREN_LIST = CHILDREN_LIST;
-exports.DATE_LIST = DATE_LIST;
-exports.DIC_HTTP_PROPS = DIC_HTTP_PROPS;
-exports.DIC_PROPS = DIC_PROPS;
-exports.DIC_SHOW_SPLIT = DIC_SHOW_SPLIT;
-exports.DIC_SPLIT = DIC_SPLIT;
-exports.INPUT_LIST = INPUT_LIST;
-exports.KEY_COMPONENT_NAME = KEY_COMPONENT_NAME;
-exports.KEY_ECHART_NAME = KEY_ECHART_NAME;
-exports.MULTIPLE_LIST = MULTIPLE_LIST;
-exports.RANGE_LIST = RANGE_LIST;
-exports.SELECT_LIST = SELECT_LIST;
-exports.typeList = typeList;
+/*! Avue.js v3.9.2 | (c) 2017-2026 Smallwei | Released under the MIT License. */
+'use strict';
+
+const KEY_COMPONENT_NAME = 'avue-';
+const KEY_ECHART_NAME = 'echart-';
+const DIC_PROPS = {
+    rowKey: 'id',
+    rowParentKey: 'parentId',
+    nodeKey: 'id',
+    label: 'label',
+    value: 'value',
+    type: 'type',
+    desc: 'desc',
+    groups: 'groups',
+    title: 'title',
+    leaf: 'leaf',
+    children: 'children',
+    hasChildren: 'hasChildren',
+    labelText: '名称',
+    disabled: 'disabled',
+};
+const DIC_HTTP_PROPS = {
+    name: 'name',
+    url: 'url',
+    fileType: 'type',
+    fileName: 'file',
+    res: '',
+};
+const DATE_LIST = [
+    'dates',
+    'date',
+    'datetime',
+    'datetimerange',
+    'daterange',
+    'time',
+    'timerange',
+    'week',
+    'month',
+    'months',
+    'monthrange',
+    'year',
+    'years',
+    'yearrange',
+];
+const CHILDREN_LIST = ['table', 'dynamic'];
+const INPUT_LIST = ['tree', 'number', 'icon', 'color', 'table', 'map', 'tag'];
+const ARRAY_LIST = ['img', 'array', 'url'];
+const MULTIPLE_LIST = ['cascader', 'tree', 'select', 'table'];
+const RANGE_LIST = ['slider'];
+const ARRAY_VALUE_LIST = ARRAY_LIST.concat([
+    'tag',
+    'upload',
+    'dynamic',
+    'map',
+    'checkbox',
+    'cascader',
+    'timerange',
+    'monthrange',
+    'daterange',
+    'yearrange',
+    'datetimerange',
+    'dates',
+    'months',
+    'years',
+]);
+const SELECT_LIST = DATE_LIST.concat([
+    'select',
+    'checkbox',
+    'radio',
+    'cascader',
+    'tree',
+    'color',
+    'icon',
+    'table',
+    'map',
+]);
+const DIC_SHOW_SPLIT = ' | ';
+const DIC_SPLIT = ',';
+const typeList = {
+    img: /(\.|^)(gif|jpg|jpeg|png|webp|svg|GIF|JPG|JPEG|PNG|WEBP|SVG)/,
+    video: /(\.|^)(swf|avi|flv|mpg|rm|mov|wav|asf|3gp|mkv|rmvb|ogg|mp4)/,
+    audio: /(\.|^)(mp3|wav|MP3|WAV)/,
+};
+
+exports.ARRAY_LIST = ARRAY_LIST;
+exports.ARRAY_VALUE_LIST = ARRAY_VALUE_LIST;
+exports.CHILDREN_LIST = CHILDREN_LIST;
+exports.DATE_LIST = DATE_LIST;
+exports.DIC_HTTP_PROPS = DIC_HTTP_PROPS;
+exports.DIC_PROPS = DIC_PROPS;
+exports.DIC_SHOW_SPLIT = DIC_SHOW_SPLIT;
+exports.DIC_SPLIT = DIC_SPLIT;
+exports.INPUT_LIST = INPUT_LIST;
+exports.KEY_COMPONENT_NAME = KEY_COMPONENT_NAME;
+exports.KEY_ECHART_NAME = KEY_ECHART_NAME;
+exports.MULTIPLE_LIST = MULTIPLE_LIST;
+exports.RANGE_LIST = RANGE_LIST;
+exports.SELECT_LIST = SELECT_LIST;
+exports.typeList = typeList;