@jnrs/lingshu-smart 2.2.6 → 2.2.8

package/dist/utils/index.js

@@ -0,0 +1,92 @@
+/**
+ * @Author : TanRui
+ * @WeChat : Tan578853789
+ * @File   : index.ts
+ * @Date   : 2025/04/29
+ * @Desc.  : 工具类
+ */
+/**
+ * 数字生成器
+ * @param {*} start 起始值
+ * @param {*} end 结束值
+ * @param {*} shouldLoop 是否无限循环
+ * @returns
+ */
+export function* numberLoopGenerator(start, end, shouldLoop = false) {
+    let current = start;
+    while (true) {
+        // 使用无限循环
+        if (current > end) {
+            if (!shouldLoop) {
+                return;
+            }
+            else {
+                current = start;
+            }
+        }
+        yield current++;
+    }
+}
+/**
+ * 在 n 秒内把变量从值 x 线性递增到 y
+ * @param {*} x 初始值
+ * @param {*} y 结束值
+ * @param {*} n 递增时长
+ * @param {*} rate 帧率（别低于100否则进度条动画来不及显示)
+ * @param {*} callback 回调函数
+ * @returns
+ */
+export const linearIncrease = (x = 0, y = 100, n = 3, rate = 300, callback) => {
+    if (!callback) {
+        return false;
+    }
+    return new Promise((resolve) => {
+        // if (x >= y) {
+        //   resolve()
+        //   return
+        // }
+        const start = x;
+        const target = y;
+        let elapsed = 0;
+        const duration = n * 1000;
+        const interval = setInterval(() => {
+            elapsed += rate;
+            // 计算进度 [0 ~ 1]
+            const progress = Math.min(elapsed / duration, 1);
+            // 线性插值
+            const currentValue = start + (target - start) * progress;
+            callback(currentValue.toFixed(2));
+            // 如果动画完成
+            if (progress === 1) {
+                clearInterval(interval);
+                resolve;
+            }
+        }, rate);
+    });
+};
+/**
+ * 根据百分比数字转换为像素，或者根据像素转换为百分比
+ * @param {number} val - 百分比数字（范围 0 ~ 1），或者像素数字
+ * @param {number} size - 尺寸，用于计算百分比
+ * @param {number} [precision=3] - 保留的小数位数，默认为 3
+ * @param {boolean} [getPercent=false] - 是否返回百分比，默认为 false
+ * @returns {number} 转换后的像素值
+ */
+export function transPercentAndPixel(val, size, precision = 3, getPercent) {
+    if (val === undefined || size === undefined) {
+        return 0;
+    }
+    if (getPercent) {
+        return size > 0 ? Number((val / size).toFixed(3)) : 0;
+    }
+    return Number((size * val).toFixed(precision));
+}
+// 百分比转换小数
+export function transFraction(val, size) {
+    if (val === undefined || size === undefined)
+        return 0;
+    if (size > 0) {
+        return Number((val / size).toFixed(3));
+    }
+    return val;
+}

package/dist/utils/type-guards.d.ts

@@ -1,4 +1,4 @@
-import { ICase, IScene, ILayer } from '../types';
+import type { ICase, IScene, ILayer } from '@/types';
 /**
  * 校验 IScene
  */

package/dist/utils/type-guards.js

@@ -0,0 +1,105 @@
+/**
+ * 校验 IScene
+ */
+function isIScene(scene) {
+    if (!scene || typeof scene !== 'object')
+        return false;
+    // 校验 width 和 height
+    if (typeof scene.width !== 'number' || typeof scene.height !== 'number') {
+        console.error('isIScene: width must be a number');
+        return false;
+    }
+    // 校验 zoomType
+    const validZoomType = scene.zoomType === 'fit' || typeof scene.zoomType === 'number';
+    if (!validZoomType) {
+        console.error('isIScene: zoomType must be "fit" or a number');
+        return false;
+    }
+    // 校验 fill
+    if (scene.fill) {
+        const f = scene.fill;
+        if (typeof f !== 'object')
+            return false;
+        const validTypes = ['solid', 'linear', 'radial', 'image'];
+        if (!validTypes.includes(f.type))
+            return false;
+        if (typeof f.color !== 'string')
+            return false;
+        if (typeof f.opacity !== 'number')
+            return false;
+        if (f.stops && !Array.isArray(f.stops))
+            return false;
+    }
+    if (scene.stroke && typeof scene.stroke !== 'object') {
+        console.error('isIScene: stroke must be an object');
+        return false;
+    }
+    return true;
+}
+/**
+ * 校验 ILayer
+ */
+function isILayer(layer) {
+    if (!layer || typeof layer !== 'object')
+        return false;
+    if (typeof layer.uuid !== 'string') {
+        console.error('isILayer: uuid must be a string');
+        return false;
+    }
+    if (typeof layer.className !== 'string') {
+        console.error('isILayer: className must be a string');
+        return false;
+    }
+    // 递归检查 children
+    if (layer.children) {
+        if (!Array.isArray(layer.children))
+            return false;
+        // 这里直接调用 isValidLayer，因为是 function 声明，顺序无所谓
+        if (!layer.children.every((child) => isILayer(child)))
+            return false;
+    }
+    if (layer.fill && typeof layer.fill !== 'object')
+        return false;
+    if (layer.selected !== undefined && typeof layer.selected !== 'boolean')
+        return false;
+    return true;
+}
+/**
+ * 校验 ICase
+ */
+function isICase(item) {
+    if (!item || typeof item !== 'object')
+        return false;
+    if (typeof item.uuid !== 'string') {
+        console.error('isICase: uuid must be a string');
+        return false;
+    }
+    if (typeof item.title !== 'string') {
+        console.error('isICase: title must be a string');
+        return false;
+    }
+    if (typeof item.isActive !== 'boolean') {
+        console.error('isICase: isActive must be a boolean');
+        return false;
+    }
+    if (!Array.isArray(item.layers))
+        return false;
+    // 调用辅助函数
+    if (!item.layers.every((layer) => isILayer(layer)))
+        return false;
+    if (!isIScene(item.scene))
+        return false;
+    return true;
+}
+/**
+ * 顶层数组守卫
+ */
+function isICaseArray(data) {
+    if (!Array.isArray(data)) {
+        console.error('isICaseArray: data must be an array');
+        return false;
+    }
+    return data.every((item) => isICase(item));
+}
+// 统一导出
+export { isICase, isICaseArray, isILayer, isIScene };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jnrs/lingshu-smart",
-  "version": "2.2.6",
+  "version": "2.2.8",
   "description": "LingShu Smart 2D Digital Twin System.",
   "keywords": [
     "jnrs",
@@ -45,7 +45,7 @@
     "pinia-plugin-persistedstate": "^4.7.1",
     "vue": "^3.5.22",
     "vue-i18n": "^9.14.5",
-    "@jnrs/shared": "1.1.18"
+    "@jnrs/shared": "1.1.23"
   },
   "devDependencies": {
     "@types/lodash-es": "^4.17.12",