funda-ui 4.7.615 → 4.7.624

package/publish/lib/esm/Utils/libs/tree.ts

@@ -0,0 +1,119 @@
+/**
+ * Convert Tree
+ * @param {Array} arr                    - Flat array
+ * @param  {?string | ?number} parentId  - Parent id
+ * @param  {?string} keyId               - Key value of id.
+ * @param  {?string} keyParentId         - Key value of parent id.
+ * @returns Array
+ */
+function convertTree(arr: any[], parentId: string | number = '', keyId: string = 'id', keyParentId: string = 'parent_id'): any[] {
+    
+    if (!parentId) {
+        
+        // If there is no parent id (when recursing for the first time), all parents will be queried
+        return arr.filter(item => !item[keyParentId]).map(item => {
+            // Query all child nodes by parent node ID
+            item.children = convertTree(arr, item[keyId], keyId, keyParentId);
+            return item;
+        })
+    } else {
+        return arr.filter(item => item[keyParentId] === parentId).map(item => {
+            // Query all child nodes by parent node ID
+            item.children = convertTree(arr, item[keyId], keyId, keyParentId);
+            return item;
+        })
+    }
+}
+
+
+/**
+ * Flat tree
+ * @param {Array} arr                    - Hierarchical array
+ * @returns Array
+ */
+function flatTree(arr: any[]): any[] {
+    const flatData = ({...rest}: any) => {
+        const { children = [] } = rest;
+        return [{...rest}, ...children.flatMap(flatData)];
+    };
+    let result = arr.flatMap(flatData);
+
+    //remove children from item
+    result = result.map((item) => {
+        delete item.children;
+        return item;
+
+    });
+
+    return result;
+}
+
+/**
+ * Get all depth
+ * @param {Object} node 
+ * @returns Number
+ */
+function getAllDepth(arr: any[]): number {
+    const count = (children: any[]): number => {
+        return children.reduce((depth, child) => {
+            return Math.max(depth, 1 + count(child.children)); // increment depth of children by 1, and compare it with accumulated depth of other children within the same element
+        }, 0); //default value 0 that's returned if there are no children
+    }
+   return count(arr);
+}
+
+
+
+
+/**
+* Add depth to each item in the tree
+* @param {Array} arr       - Hierarchical array
+* @param  {?string} keyId               - Key value of id.
+* @param  {?string} keyParentId         - Key value of parent id.
+* @param  {?number} depth               - Depth of the item.
+* @returns Number
+*/
+function addTreeDepth(arr: any[], keyId: string = 'id', parentItem: string = '', depth: number = 0): any[] {
+   return arr.reduce((acc, el) => {
+       const { children, ...otherProps } = el;
+       acc.push({ ...otherProps, parentItem, depth });
+       if (children) {
+           return acc.concat(addTreeDepth(children, keyId, el[keyId], depth + 1));
+       }
+       return acc;
+   }, []);
+}
+
+
+
+/**
+ * Add indent placeholder
+ * @param {Array} arr                    - Flat array
+ * @param  {?string} placeholder         - String of placeholder
+ * @param  {?string} lastPlaceholder     - Last String of placeholder
+ * @param  {?string} keyName             - Key value of name.
+ * @returns Array
+ */
+function addTreeIndent(arr: any[], placeholder: string = '    ', lastPlaceholder: string = '', keyName: string = 'label'): void {
+
+    arr.forEach((item) => {
+        let indent = ''; 
+        if (item.depth) {
+            Array(item.depth).fill(0).forEach((k, i) => {
+                indent += placeholder;
+                if (i === item.depth-1) {
+                    item[keyName] = indent + lastPlaceholder + item[keyName];
+                }
+            });
+        }
+    });
+}
+
+export {
+    getAllDepth,
+    convertTree,
+    flatTree,
+    addTreeDepth,
+    addTreeIndent
+};
+

package/publish/lib/esm/Utils/libs/validate.ts

@@ -0,0 +1,434 @@
+/**
+ * Fix And Parse JSON (Support for handling complex escape JSON strings)
+ * @desc recursively fix top-level key/value (recursively handles when encountering top-level values that are objects/arrays)
+ * @private
+ */
+/*
+ - Still prioritize JSON.parse first;
+ - After parse fails, do unescaping (\\" → ");
+ - Then process the outermost layer (object or array) key by key, value by value;
+ - If a top-level value is an unquoted object or array (e.g., messages: [ {...} ]), recursively treat that value as a new outermost layer for fixing;
+ - For strings wrapped in quotes ('...' or "..."), only extract the outer layer and re-encode with JSON.stringify (ensuring internal single/double quotes won't be mistakenly changed);
+ - Set MAX_DEPTH to prevent infinite recursion.
+*/
+/*
+@Examples:
+
+// ✅ Valid JSON (contains svg and single quote content)
+const okJson = `{
+  "label":"<svg width='16' height='16'><path fill='currentColor' d='M19 13h-6'/></svg> 新建会话",
+  "value":"new",
+  "onClick":"method.setVal(''); method.clearData();"
+}`;
+
+const okJson2 = `{
+  label:"<svg width='16' height='16'><path fill='currentColor' d='M19 13h-6'/></svg> 新建会话",
+  value:"new",
+  onClick:"method.setVal(''); method.clearData();"
+}`;
+
+// ⚠️ Single quote JSON
+const badJson = "{'model':'{model}','messages':[{'role':'user','content':'{message}'}],'stream': true}";
+
+// ⚠️ Escaped JSON
+const badJson2 = "{\\\"label\\\":\\\"<svg width='16' height='16' viewBox='0 0 24 24'><path fill='currentColor' d='M19 13h-6v6h-2v-6H5v-2h6V5h2v6h6v2z'/></svg> 新建会话\\\",\\\"value\\\":\\\"new\\\",\\\"onClick\\\":\\\"method.setVal(''); method.clearData();\\\"}";
+
+const badJson3 = "{\"label\":\"<svg width='16' height='16' viewBox='0 0 24 24'><path fill='currentColor' d='M19 13h-6v6h-2v-6H5v-2h6V5h2v6h6v2z'/></svg> 新建会话\",\"value\":\"new\",\"onClick\":\"method.setVal(''); method.clearData();\"}";
+
+const badJson4 = "[{\"label\":\"<svg fill='currentColor' width='12' height='12' viewBox='0 0 24 24'><path d='M20.5 9a3.49 3.49 0 0 0-3.45 3h-1.1a2.49 2.49 0 0 0-4.396-1.052L8.878 9.731l3.143-4.225a2.458 2.458 0 0 0 2.98-.019L17.339 8H16v1h3V6h-1v1.243l-2.336-2.512A2.473 2.473 0 0 0 16 3.5a2.5 2.5 0 0 0-5 0 2.474 2.474 0 0 0 .343 1.243L7.947 9.308 4.955 7.947a2.404 2.404 0 0 0-.161-1.438l3.704-1.385-.44 1.371.942.333L10 4 7.172 3l-.334.943 1.01.357-3.659 1.368a2.498 2.498 0 1 0-.682 4.117l2.085 2.688-2.053 2.76a2.5 2.5 0 1 0 .87 3.864l3.484 1.587-1.055.373.334.943L10 21l-1-2.828-.943.333.435 1.354-3.608-1.645A2.471 2.471 0 0 0 5 17.5a2.5 2.5 0 0 0-.058-.527l3.053-1.405 3.476 4.48a2.498 2.498 0 1 0 4.113.075L18 17.707V19h1v-3h-3v1h1.293l-2.416 2.416a2.466 2.466 0 0 0-2.667-.047l-3.283-4.23 2.554-1.176A2.494 2.494 0 0 0 15.95 13h1.1a3.493 3.493 0 1 0 3.45-4zm-7-7A1.5 1.5 0 1 1 12 3.5 1.502 1.502 0 0 1 13.5 2zm0 18a1.5 1.5 0 1 1-1.5 1.5 1.502 1.502 0 0 1 1.5-1.5zM1 7.5a1.5 1.5 0 1 1 2.457 1.145l-.144.112A1.496 1.496 0 0 1 1 7.5zm3.32 1.703a2.507 2.507 0 0 0 .264-.326l2.752 1.251-1.124 1.512zM2.5 19A1.5 1.5 0 1 1 4 17.5 1.502 1.502 0 0 1 2.5 19zm2.037-2.941a2.518 2.518 0 0 0-.193-.234l1.885-2.532 1.136 1.464zm3.76-1.731L6.849 12.46l1.42-1.908L11.1 11.84a2.29 2.29 0 0 0-.033 1.213zM13.5 14a1.5 1.5 0 1 1 1.5-1.5 1.502 1.502 0 0 1-1.5 1.5zm7 1a2.5 2.5 0 1 1 2.5-2.5 2.502 2.502 0 0 1-2.5 2.5zm1.5-2.5a1.5 1.5 0 1 1-1.5-1.5 1.502 1.502 0 0 1 1.5 1.5z'/><path fill='none' d='M0 0h24v24H0z'/></svg> 深度思考\",\"value\":\"brief\",\"onClick\":\"if(isActive){method.executeCustomMethod('changeModel', true)}else{method.executeCustomMethod('changeModel', false)}\"},{\"label\":\"<svg fill='currentColor' width='12' height='12' viewBox='0 0 24 24'><path d='M19 2H5c-1.103 0-2 .897-2 2v12c0 1.103.897 2 2 2h3.586L12 21.414 15.414 18H19c1.103 0 2-.897 2-2V4c0-1.103-.897-2-2-2zm0 14h-4.414L12 18.586 9.414 16H5V4h14v12z'/></svg> 精简回答\",\"value\":\"brief\",\"onClick\":\"if(isActive){method.setContextData({systemPrompt:'请精简回答，字数控制在150个字左右, 思考过程请简洁简短',mergedText:method.getContextData().mergedText,analyzeMetrics:method.getContextData().analyzeMetrics});}else{method.setContextData({mergedText:method.getContextData().mergedText,analyzeMetrics:method.getContextData().analyzeMetrics});}\"},{\"label\":\"<svg fill='none' width='12' height='12' viewBox='0 0 16 16'><path d='M7 0.0618896V9H15.9381C15.446 12.9463 12.0796 16 8 16C3.58172 16 0 12.4183 0 8C0 3.92038 3.05369 0.553988 7 0.0618896Z' fill='currentColor'/><path d='M9 0.0618897V7H15.9381C15.4869 3.38128 12.6187 0.513137 9 0.0618897Z' fill='currentColor'/></svg> 指标分析\",\"value\":\"lab\",\"onClick\":\"return method.executeCustomMethod('getLibList')\",\"isSelect\":true,\"dynamicOptions\":true}]";
+
+
+// ❌ Invalid JSON with missing } or ]
+const errorJson001 = "{'model':'qwen-plus','base_url':'https://dashscope.aliyuncs.com/compatible-mode/v1/','api_key':'sk-0989fb9baab8450682af4d000f5b7cba','message':'{message}','stream':'true','chatId': '{chatId}', 'token': '{token}'";
+
+const errorJson002 = "[{'model':'qwen-plus','base_url':'https://dashscope.aliyuncs.com/compatible-mode/v1/','api_key':'sk-0989fb9baab8450682af4d000f5b7cba','message':'{message}','stream':'true','chatId': '{chatId}', 'token': '{token}'}";
+
+// ❌ Invalid JSON with missing quotes
+const errorJson003 = "{'model':'qwen-plus','base_url':'https://dashscope.aliyuncs.com/compatible-mode/v1/','api_key':'sk-0989fb9baab8450682af4d000f5b7cba','message':'{message}','stream':'true','chatId': {chatId}', 'token': '{token}'}";
+
+
+
+console.log('okJson =>', fixAndParseJSON(okJson));   // Can parse normally  success = true
+console.log('okJson =>', fixAndParseJSON(okJson2));   // Can parse normally  success = true
+console.log('badJson =>', fixAndParseJSON(badJson)); // Can parse after fixing success = true
+console.log('badJson =>', fixAndParseJSON(badJson2)); // Can parse after fixing success = true
+console.log('badJson =>', fixAndParseJSON(badJson3)); // Can parse after fixing success = true
+console.log('badJson =>', fixAndParseJSON(badJson4)); // Can parse after fixing success = true
+console.log('errorJson =>', fixAndParseJSON(errorJson001)); // {success: false, error: 'Invalid JSON format', details: 'Invalid object: mismatched braces'}
+console.log('errorJson =>', fixAndParseJSON(errorJson002)); // {success: false, error: 'Invalid JSON format', details: "Expected property name or '}' in JSON at position 2 (line 1 column 3)"}
+console.log('errorJson =>', fixAndParseJSON(errorJson003)); // {success: false, error: 'Invalid JSON format', details: 'Invalid object: mismatched braces'}
+
+*/
+
+// Type definitions
+interface ParseResult {
+    success: boolean;
+    data?: any;
+    error?: string;
+    details?: string;
+}
+
+function fixAndParseJSON(input: string): ParseResult {
+    const MAX_DEPTH = 6;
+
+    // 1. Quick attempt
+    try {
+        return { success: true, data: JSON.parse(input) };
+    } catch (e) {
+        // Continue with fixing
+    }
+
+    // 2. Simple unescaping of escaped \" (common case from pasted JS literals)
+    let s = input;
+    if (s.includes('\\"')) s = s.replace(/\\"/g, '"');
+    s = s.trim();
+
+    try {
+        if (s.startsWith('{')) {
+            s = processTopObject(s, 0, MAX_DEPTH);
+        } else if (s.startsWith('[')) {
+            s = processTopArray(s, 0, MAX_DEPTH);
+        } else {
+            throw new Error('Input is not an object or array');
+        }
+
+        return { success: true, data: JSON.parse(s) };
+    } catch (err) {
+        const error = err instanceof Error ? err : new Error('Unknown error');
+        return { success: false, error: 'Invalid JSON format', details: error.message };
+    }
+}
+
+/* ---------- Helper (Recursive) Functions ---------- */
+
+function processTopObject(str: string, depth: number, MAX_DEPTH: number): string {
+    if (depth > MAX_DEPTH) return str;
+    str = str.trim();
+    
+    // First check if braces match
+    let braceCount = 0;
+    let inString = false;
+    let escapeNext = false;
+    
+    for (let i = 0; i < str.length; i++) {
+        const ch = str[i];
+        
+        if (escapeNext) {
+            escapeNext = false;
+            continue;
+        }
+        
+        if (ch === '\\') {
+            escapeNext = true;
+            continue;
+        }
+        
+        if ((ch === '"' || ch === "'") && !escapeNext) {
+            inString = !inString;
+            continue;
+        }
+        
+        if (!inString) {
+            if (ch === '{') braceCount++;
+            else if (ch === '}') braceCount--;
+        }
+    }
+    
+    if (braceCount !== 0) {
+        throw new Error('Invalid object: mismatched braces');
+    }
+    
+    // Ensure both ends are { ... }
+    if (!(str.startsWith('{') && str.endsWith('}'))) {
+        const f = str.indexOf('{'), l = str.lastIndexOf('}');
+        if (f === -1 || l === -1 || l <= f) {
+            throw new Error('Invalid object format: missing or mismatched braces');
+        }
+        str = str.slice(f, l + 1);
+    }
+    
+    const inner = str.slice(1, -1);
+    const pairs = splitTopLevel(inner);
+
+    const repairedPairs = pairs.map(pair => {
+        if (!pair || pair.trim() === '') return '';
+        const idx = findTopLevelColon(pair);
+        if (idx === -1) {
+            return pair; // Non key:value fragment, keep as is (rare case)
+        }
+        const rawKey = pair.slice(0, idx).trim();
+        const rawVal = pair.slice(idx + 1);
+
+        const keyContent = extractKeyContent(rawKey);
+        const keyJson = JSON.stringify(keyContent);
+
+        const repairedValue = repairPossiblyQuotedValue(rawVal, depth + 1, MAX_DEPTH);
+
+        return keyJson + ':' + repairedValue;
+    });
+
+    return '{' + repairedPairs.join(',') + '}';
+}
+
+function processTopArray(str: string, depth: number, MAX_DEPTH: number): string {
+    if (depth > MAX_DEPTH) return str;
+    str = str.trim();
+    if (!(str.startsWith('[') && str.endsWith(']'))) {
+        const f = str.indexOf('['), l = str.lastIndexOf(']');
+        if (f === -1 || l === -1 || l <= f) return str;
+        str = str.slice(f, l + 1);
+    }
+    const inner = str.slice(1, -1);
+    const elements = splitTopLevel(inner);
+
+    const processed = elements.map(el => {
+        const t = el.trim();
+        if (t === '') return '';
+        if (t.startsWith('{')) return processTopObject(t, depth + 1, MAX_DEPTH);
+        if (t.startsWith('[')) return processTopArray(t, depth + 1, MAX_DEPTH);
+        return repairPossiblyQuotedValue(t, depth + 1, MAX_DEPTH);
+    });
+
+    return '[' + processed.join(',') + ']';
+}
+
+// If it's a string wrapped in quotes, extract the inner content and JSON.stringify (safe escaping)
+// If it's an object/array literal (not wrapped in quotes), recursively process (treat as new outermost layer)
+// Otherwise return the original fragment directly (numbers/true/false/null or JS expressions)
+function repairPossiblyQuotedValue(rawVal: string, depth: number, MAX_DEPTH: number): string {
+    const v = rawVal.trim();
+    if (v === '') return v;
+
+    if (v[0] === '"' || v[0] === "'") {
+        const quote = v[0];
+        // Find the last unescaped same quote
+        let lastPos = -1;
+        for (let i = v.length - 1; i >= 0; i--) {
+            if (v[i] === quote) {
+                // check escaped
+                let bs = 0, k = i - 1;
+                while (k >= 0 && v[k] === '\\') { bs++; k--; }
+                if (bs % 2 === 0) { lastPos = i; break; }
+            }
+        }
+        const inner = lastPos > 0 ? v.slice(1, lastPos) : v.slice(1);
+        return JSON.stringify(inner); // Use JSON.stringify to generate valid JSON string (automatically escape internal quotes, etc.)
+    }
+
+    // If it's an object or array literal (not wrapped in quotes) -> recursively treat as new outermost layer
+    if (v.startsWith('{')) {
+        return processTopObject(v, depth, MAX_DEPTH);
+    }
+    if (v.startsWith('[')) {
+        return processTopArray(v, depth, MAX_DEPTH);
+    }
+
+    // Others (numbers, boolean, null, or JS expressions): return as-is
+    return v;
+}
+
+/* --------- Utilities: Split by top-level commas, find top-level colon, extract key --------- */
+
+// Split by top-level commas (ignore strings, sub-objects, sub-arrays, commas inside parentheses)
+function splitTopLevel(str: string): string[] {
+    const parts: string[] = [];
+    let buf = '';
+    let depthCurly = 0, depthSquare = 0, depthParen = 0;
+    let inSingle = false, inDouble = false, esc = false;
+
+    for (let i = 0; i < str.length; i++) {
+        const ch = str[i];
+
+        if (esc) {
+            buf += ch;
+            esc = false;
+            continue;
+        }
+        if (ch === '\\') {
+            buf += ch;
+            esc = true;
+            continue;
+        }
+
+        if (ch === "'" && !inDouble) { inSingle = !inSingle; buf += ch; continue; }
+        if (ch === '"' && !inSingle) { inDouble = !inDouble; buf += ch; continue; }
+
+        if (!inSingle && !inDouble) {
+            if (ch === '{') { depthCurly++; buf += ch; continue; }
+            if (ch === '}') { depthCurly--; buf += ch; continue; }
+            if (ch === '[') { depthSquare++; buf += ch; continue; }
+            if (ch === ']') { depthSquare--; buf += ch; continue; }
+            if (ch === '(') { depthParen++; buf += ch; continue; }
+            if (ch === ')') { depthParen--; buf += ch; continue; }
+
+            if (ch === ',' && depthCurly === 0 && depthSquare === 0 && depthParen === 0) {
+                parts.push(buf);
+                buf = '';
+                continue;
+            }
+        }
+
+        buf += ch;
+    }
+    
+    // Check for unclosed brackets or quotes
+    if (depthCurly !== 0 || depthSquare !== 0 || depthParen !== 0 || inSingle || inDouble) {
+        throw new Error('Invalid JSON: unclosed brackets or quotes');
+    }
+    
+    if (buf.trim() !== '') parts.push(buf);
+    return parts;
+}
+
+// Find the first "top-level" colon index (ignore inside strings & sub-levels)
+function findTopLevelColon(str: string): number {
+    let inSingle = false, inDouble = false, esc = false;
+    let depthCurly = 0, depthSquare = 0, depthParen = 0;
+    for (let i = 0; i < str.length; i++) {
+        const ch = str[i];
+        if (esc) { esc = false; continue; }
+        if (ch === '\\') { esc = true; continue; }
+        if (ch === "'" && !inDouble) { inSingle = !inSingle; continue; }
+        if (ch === '"' && !inSingle) { inDouble = !inDouble; continue; }
+
+        if (!inSingle && !inDouble) {
+            if (ch === '{') { depthCurly++; continue; }
+            if (ch === '}') { depthCurly--; continue; }
+            if (ch === '[') { depthSquare++; continue; }
+            if (ch === ']') { depthSquare--; continue; }
+            if (ch === '(') { depthParen++; continue; }
+            if (ch === ')') { depthParen--; continue; }
+
+            if (ch === ':' && depthCurly === 0 && depthSquare === 0 && depthParen === 0) {
+                return i;
+            }
+        }
+    }
+    return -1;
+}
+
+// Extract key content (supports "key", 'key', key), returns pure key string
+function extractKeyContent(rawKey: string): string {
+    const r = rawKey.trim();
+    if ((r.startsWith('"') && r.endsWith('"')) || (r.startsWith("'") && r.endsWith("'"))) {
+        const inner = r.slice(1, -1).replace(/\\"/g, '"').replace(/\\'/g, "'");
+        return inner;
+    }
+    return r;
+}
+
+
+/**
+ * Determine whether it is in JSON format
+ * @private
+ */
+function isJSON(input: any): boolean {
+    if (typeof (input) === 'string' && input.length > 0) {
+        return fixAndParseJSON(input).success;
+    } else {
+        if (
+            typeof (input) === 'object' &&
+            Object.prototype.toString.call(input) === '[object Object]' &&
+            !(input as any).length
+        ) {
+            return true;
+        } else {
+            return false;
+        }
+    }
+}
+
+
+
+/**
+ * Check if a string is a valid number
+ * @param str - The string to check
+ * @returns boolean indicating if the string is a valid number
+ */
+function isValidNumeric(str: unknown): boolean {
+    if (typeof str !== "string") return false; // we only process strings!
+    if (
+        !isNaN(Number(str)) && // use type coercion to parse the _entirety_ of the string
+        !isNaN(parseFloat(str)) // ensure strings of whitespace fail
+    ) {
+        return true;
+    }
+    return false;
+}
+
+
+/**
+ * Check if input is empty
+ * @param input - The input to check (string or array of strings)
+ * @returns boolean indicating if the input is empty
+ */
+function isEmpty(input: string | string[]): boolean {
+    if (Array.isArray(input)) {
+        return input.some((str) => !str.replace(/\s/g, '').length === true);
+    }
+    return !input.replace(/\s/g, '').length === true;
+}
+
+/**
+ * Check if input is a valid number
+ * @param input - The input to check
+ * @returns boolean indicating if the input is a valid number
+ */
+function isNumber(input: string): boolean {
+    const reg = /^[\d|\.|,]+$/;
+    return reg.test(input);
+}
+
+/**
+ * Check if input is a valid integer
+ * @param input - The input to check
+ * @returns boolean indicating if the input is a valid integer
+ */
+function isInt(input: string): boolean {
+    if (input === "") {
+        return false;
+    }
+    const reg = /\D+/;
+    return !reg.test(input);
+}
+
+/**
+ * Check if input is a valid email address
+ * @param input - The input to check
+ * @returns boolean indicating if the input is a valid email
+ */
+function isEmail(input: string): boolean {
+    const reg = /^\s*([A-Za-z0-9_-]+(\.\w+)*@(\w+\.)+\w{2,3})\s*$/;
+    return reg.test(input);
+}
+
+/**
+ * Check if input is a valid telephone number
+ * @param input - The input to check
+ * @returns boolean indicating if the input is a valid telephone number
+ */
+function isTel(input: string): boolean {
+    const reg = /^[0-9- ]{7,20}$/;
+    return reg.test(input);
+}
+
+/**
+ * Check if input is a valid mobile number
+ * @param input - The input to check
+ * @returns boolean indicating if the input is a valid mobile number
+ */
+function isMobile(input: string): boolean {
+    const reg = /^1[0-9]{10}$/;
+    return reg.test(input);
+}
+
+export {
+    isValidNumeric,
+    isJSON,
+    isEmpty,
+    isNumber,
+    isInt,
+    isEmail,
+    isTel,
+    isMobile
+};

package/publish/lib/esm/Utils/libs/viewport.ts

@@ -0,0 +1,20 @@
+/**
+ * Check if an element is in the viewport
+ * @param {HTMLElement} elem 
+ * @returns {Boolean}
+ */
+function isInViewport(elem: HTMLElement) {
+    const bounding = elem.getBoundingClientRect();
+    return (
+        bounding.top >= 0 &&
+        bounding.left >= 0 &&
+        bounding.bottom <= (window.innerHeight || document.documentElement.clientHeight) &&
+        bounding.right <= (window.innerWidth || document.documentElement.clientWidth)
+    );
+}
+
+    
+export {
+    isInViewport
+}
+