@mgdis/mg-components 6.20.0 → 6.22.0

package/dist/components/index2.js

@@ -1,408 +1 @@
-/**
- * Class to manage component classlist
- */
-class ClassList {
-    /**
-     * Available classes
-     */
-    classes;
-    constructor(classlist = []) {
-        this.classes = classlist;
-    }
-    /**
-     * Add class
-     * @param className - class name to add
-     */
-    add = (className) => {
-        if (!this.has(className)) {
-            this.classes.push(className);
-        }
-    };
-    /**
-     * Delete class
-     * @param className - class name to delete
-     */
-    delete = (className) => {
-        const index = this.classes.indexOf(className);
-        if (index > -1) {
-            this.classes.splice(index, 1);
-        }
-    };
-    /**
-     * Check if class exist in list
-     * @param className - class name to check
-     * @returns class name is in the list
-     */
-    has = (className) => {
-        return this.classes.includes(className);
-    };
-    /**
-     * Join classes seperated by spaces
-     * @returns joined values
-     */
-    join = () => {
-        return this.classes.join(' ');
-    };
-}
-
-/**
- * Check if a value is of object type.
- * @param object - The value to validate.
- * @returns `true` if the value is a valid object (non-null and not an array), otherwise `false`.
- */
-const isObject = (object) => typeof object === 'object' && !Array.isArray(object) && object !== null;
-/**
- * Get object value from key
- * @param object - object to query
- * @param path - path of the property to get. Nested keys are allowed with `.` separators (eg: 'key0.key1.key2' = object[key0][key1][key2])
- * @param defaultValue - The value returned for `undefined` resolved values
- * @returns object value
- */
-const getObjectValueFromKey = (object, path, defaultValue) => {
-    const separator = '.';
-    if (!isObject(object) || typeof path !== 'string') {
-        return defaultValue;
-    }
-    const [current, ...next] = path.split(separator);
-    if (next.length) {
-        return getObjectValueFromKey(object[current], next.join(separator), defaultValue);
-    }
-    else {
-        return object[current] ?? defaultValue;
-    }
-};
-
-/**
- * Typeguard function to check if all array items are strings.
- * @param items - items to check
- * @returns `true` if all items are strings
- */
-const allItemsAreString = (items) => Array.isArray(items) && items.every(item => typeof item === 'string');
-/**
- * Validate string
- * @param value - value to check
- * @returns `true` if string is valid
- */
-const isValidString = (value) => typeof value === 'string' && value.trim() !== '';
-/**
- * Stringify value
- * @param value - value to stringify
- * @returns stringified value
- */
-const toString = (value) => (typeof value === 'object' ? JSON.stringify(value) : String(value));
-/**
- * Cleans string characters by removing special characters and converting to lowercase.
- * @param text - text to clean
- * @returns cleaned string
- * @example
- * ```ts
- * cleanString('âäàçéèêñù') // 'aaaceeenu'
- * cleanString('BATMAN') // 'batman'
- * ```
- */
-const cleanString = (text) => typeof text === 'string'
-    ? text
-        .toLocaleLowerCase()
-        .normalize('NFD')
-        .replaceAll(/[\u0300-\u036f]/g, '')
-    : text;
-
-/**
- * Convert a string to kebab-case.
- *
- * This function ensures:
- * - All characters are converted to lowercase.  Based on : https://stackoverflow.com/questions/63116039/camelcase-to-kebab-case
- * - Non-alphabetic characters (except numbers and hyphens) are replaced with hyphens.
- * - Consecutive hyphens are replaced with a single hyphen.
- * - Leading and trailing hyphens are removed.
- *
- * @param str - The input string to convert.
- * @returns The kebab-case formatted string.
- *
- * @example
- * ```typescript
- * toKebabCase('XMLHttpRequest'); // 'xml-http-request'
- * ```
- */
-const toKebabCase = (str) => str
-    .replace(/[A-Z]+(?![a-z])|[A-Z]/g, (match, offset) => (offset > 0 ? '-' : '') + match.toLowerCase())
-    .replace(/[^a-z0-9-]+/g, '-') // Replace non a-z, 0-9, or hyphen characters with a hyphen
-    .replace(/--+/g, '-') // Replace multiple consecutive hyphens with a single hyphen
-    .replace(/(?:^-)|(?:-$)/g, ''); // Remove leading hyphens or number or trailing hyphens
-
-/**
- * Create random ID
- * @param prefix - add prefix to created ID
- * @param length - ID length
- * @returns ID
- */
-const createID = (prefix = '', length = 10) => {
-    const randomBytes = new Uint8Array(length);
-    crypto.getRandomValues(randomBytes);
-    const hexString = Array.from(randomBytes)
-        .map(byte => byte.toString(16).padStart(2, '0'))
-        .join('')
-        .slice(0, length);
-    return prefix !== '' ? `${prefix}-${hexString}` : hexString;
-};
-/**
- * Validate html `id` format
- * @param newValue - id value to validate
- * @returns true if `id` is valid
- */
-const isValideID = (newValue) => isValidString(newValue) && /^([a-z][a-z0-9]*)(-[a-z0-9]+)*$/.exec(newValue) !== null;
-/**
- * Format id from value
- * @param value - id to transforme
- * @returns valid id
- */
-const formatID = (value) => {
-    let id;
-    if (typeof value === 'string') {
-        id = value;
-    }
-    else if (Boolean(value) && typeof value === 'object' && (isObject(value) || Array.isArray(value))) {
-        id = JSON.stringify(value);
-    }
-    else if (value !== null && value !== undefined && typeof value !== 'boolean' && typeof value !== 'object') {
-        id = String(value);
-    }
-    return id ? toKebabCase(id) : id;
-};
-
-/**
- * Use to process code next tick in the event loop
- * @param callback - code to excute on next tick
- * @returns differed code excution
- */
-const nextTick = async (callback) => {
-    if (callback)
-        return callback();
-};
-/**
- * Cursor possible values
- */
-const Cursor = {
-    FIRST: 'first',
-    NEXT: 'next',
-    PREVIOUS: 'previous',
-    LAST: 'last',
-};
-const DEFAULT_TOP = 10;
-/**
- * Define a valid Page object and navigate throw page items with cursor.
- * Page object entries follow the REST API page practices.
- */
-class Page {
-    /**
-     * Define items
-     */
-    items = [];
-    /**
-     * Define total
-     */
-    total;
-    /**
-     * Define top
-     */
-    top = DEFAULT_TOP;
-    /**
-     * Define next
-     */
-    next;
-    /**
-     * Define base index
-     */
-    baseIndex = 1;
-    constructor(init) {
-        if (!isObject(init)) {
-            throw new Error('Page - init must match IPage type.');
-        }
-        else {
-            if (Array.isArray(init.items))
-                this.items = init.items;
-            if (typeof init.top === 'number')
-                this.top = init.top;
-            this.total = typeof init.total === 'number' ? init.total : this.items.length;
-            this.next = init.next;
-        }
-    }
-    /**
-     * Get index of items from cursor
-     * @param cursor - cursor to find
-     * @param oldItem - previous item
-     * @returns item index
-     */
-    getIndexFromCursor = (cursor = 'first', oldItem) => {
-        const startIndex = 0;
-        if (!Array.isArray(this.items) || !this.items.length)
-            return null;
-        const lastIndex = this.items.length - this.baseIndex;
-        let newIndex;
-        let oldIndex = startIndex;
-        if (['previous', 'next'].includes(cursor) && oldItem) {
-            const findedIndex = this.items.findIndex(item => JSON.stringify(item) === JSON.stringify(oldItem));
-            if (findedIndex === -1)
-                return startIndex;
-            oldIndex = findedIndex;
-        }
-        // Update index from cursor
-        if (cursor === 'first') {
-            newIndex = startIndex;
-        }
-        else if (cursor === 'last') {
-            newIndex = lastIndex;
-        }
-        else if (cursor === 'previous') {
-            newIndex = JSON.stringify(this.items[oldIndex]) === JSON.stringify(this.items[startIndex]) ? lastIndex : oldIndex - this.baseIndex;
-        }
-        else if (cursor === 'next') {
-            newIndex = JSON.stringify(this.items[oldIndex]) === JSON.stringify(this.items[lastIndex]) ? startIndex : oldIndex + this.baseIndex;
-        }
-        else {
-            newIndex = startIndex;
-        }
-        return newIndex;
-    };
-}
-/**
- * Paginate an items array to navigate into with pages.
- * It follow REST standard and allow to navigate in items array with a similar format.
- */
-class Paginate {
-    /**
-     * Define paginated items
-     */
-    items = [];
-    /* Privates */
-    #top = DEFAULT_TOP;
-    #next;
-    #total;
-    constructor(items, options) {
-        if (Array.isArray(items))
-            this.items = items;
-        if (options && (['string', 'function'].includes(typeof options.next) || (isObject(options.next) && URL.canParse(options.next))))
-            this.#next = options.next;
-        if (typeof options?.top === 'number')
-            this.#top = options.top;
-        if (typeof options?.total === 'number')
-            this.#total = options.total;
-    }
-    /**
-     * Get page
-     * @param offset - pagiantion offset
-     * @param filter - filter methode
-     * @returns formated page
-     */
-    getPage = (offset = 0, filter) => {
-        const items = typeof filter === 'function' ? this.items.filter(filter) : this.items;
-        let next;
-        if (this.#next)
-            next = this.#next;
-        else if (items.length > offset + this.#top)
-            next = () => this.getPage(offset + this.#top, filter);
-        return new Page({
-            items: items.slice(offset, offset + this.#top),
-            total: this.#total,
-            top: this.#top,
-            next,
-        });
-    };
-}
-
-/**
- * Date RegExp, usefull to test if string is a follow the date pattern
- * @example
- * ```ts
- * dateRegExp.test('mystring') // false
- * dateRegExp.test('2020-12-31') // true
- * ```
- */
-const dateRegExp = /^\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])$/;
-/**
- * Formats a date object to a string with the pattern 'YYYY-MM-DD'.
- * @param date - date to parse
- * @returns string date with pattern 'YYYY-MM-DD'
- * @example
- * ```ts
- * dateToString(new Date('2023-12-24')) // '2023-12-24'
- * ```
- */
-const dateToString = (date) => date.toISOString().split('T')[0];
-
-/**
- * Check if element belongs to the given tagNames list
- * @param element - element to check
- * @param tagNames - allowed tag names list
- * @returns `true` if element tagName is in the tagNames list
- */
-const isTagName = (element, tagNames) => tagNames.includes(element?.tagName.toLowerCase());
-/**
- * CSS selector to select focusable elements.
- * @example
- * ```ts
- * const allFocusableElements: HTMLElement[] = Array.from(this.element.querySelectorAll(focusableElements));
- * ```
- */
-const focusableElements = 'a[href], button, input, textarea, select, details, [tabindex]:not([tabindex="-1"]), [identifier], mg-button';
-
-/**
- * Validate number
- * @param value - value to check
- * @returns `true` if number is valid
- */
-const isValidNumber = (value) => typeof value === 'number' && !Number.isNaN(value);
-
-/**
- * Get windows
- * @param localWindow - the window we are lookink for other windows
- * @returns The list of windows found
- */
-const getWindows = (localWindow) => {
-    const parentWindows = getParentWindows(localWindow);
-    const childWindows = getChildWindows(localWindow);
-    return [localWindow, ...parentWindows, ...childWindows];
-};
-/**
- * Get parent windows
- * @param localWindow - the window we are lookink for parents
- * @param windows - The list of allready found windows
- * @returns The list of windows found
- */
-const getParentWindows = (localWindow, windows = []) => {
-    // Check if is in iframe
-    if (localWindow.self !== localWindow.top) {
-        // Check if we have permission to access parent
-        try {
-            const parentWindow = localWindow.parent;
-            if (parentWindow) {
-                windows.push(parentWindow);
-                return getParentWindows(parentWindow, windows);
-            }
-            else
-                return windows;
-        }
-        catch (err) {
-            console.error('Different hosts between iframes:', err);
-            return windows;
-        }
-    }
-    return windows;
-};
-/**
- * Get child windows
- * @param localWindow - the window we are lookink for children
- * @param windows - The list of allready found windows
- * @returns The list of windows found
- */
-const getChildWindows = (localWindow, windows = []) => {
-    if (localWindow.frames.length > 0) {
-        for (const childWindow of Array.from(localWindow.frames)) {
-            windows.push(childWindow);
-            getChildWindows(childWindow, windows);
-        }
-    }
-    return windows;
-};
-
-export { ClassList as C, Paginate as P, isValideID as a, isTagName as b, createID as c, allItemsAreString as d, Cursor as e, formatID as f, getWindows as g, Page as h, isValidString as i, getObjectValueFromKey as j, isObject as k, focusableElements as l, cleanString as m, nextTick as n, dateRegExp as o, dateToString as p, isValidNumber as q, toString as t };
+class t{classes;constructor(t=[]){this.classes=t}add=t=>{this.has(t)||this.classes.push(t)};delete=t=>{const s=this.classes.indexOf(t);s>-1&&this.classes.splice(s,1)};has=t=>this.classes.includes(t);join=()=>this.classes.join(" ")}const s=t=>"object"==typeof t&&!Array.isArray(t)&&null!==t,e=(t,r,i)=>{if(!s(t)||"string"!=typeof r)return i;const[n,...o]=r.split(".");return o.length?e(t[n],o.join("."),i):t[n]??i},r=t=>Array.isArray(t)&&t.every((t=>"string"==typeof t)),i=t=>"string"==typeof t&&""!==t.trim(),n=t=>"object"==typeof t?JSON.stringify(t):String(t),o=t=>"string"==typeof t?t.toLocaleLowerCase().normalize("NFD").replaceAll(/[\u0300-\u036f]/g,""):t,a=(t="",s=10)=>{const e=new Uint8Array(s);crypto.getRandomValues(e);const r=Array.from(e).map((t=>t.toString(16).padStart(2,"0"))).join("").slice(0,s);return""!==t?`${t}-${r}`:r},h=t=>i(t)&&null!==/^([a-z][a-z0-9]*)(-[a-z0-9]+)*$/.exec(t),f=t=>{let e;return"string"==typeof t?e=t:Boolean(t)&&"object"==typeof t&&(s(t)||Array.isArray(t))?e=JSON.stringify(t):null!=t&&"boolean"!=typeof t&&"object"!=typeof t&&(e=String(t)),e?e.replace(/[A-Z]+(?![a-z])|[A-Z]/g,((t,s)=>(s>0?"-":"")+t.toLowerCase())).replace(/[^a-z0-9-]+/g,"-").replace(/--+/g,"-").replace(/(?:^-)|(?:-$)/g,""):e},u=async t=>{if(t)return t()},c={FIRST:"first",NEXT:"next",PREVIOUS:"previous",LAST:"last"};class y{items=[];total;top=10;next;baseIndex=1;constructor(t){if(!s(t))throw new Error("Page - init must match IPage type.");Array.isArray(t.items)&&(this.items=t.items),"number"==typeof t.top&&(this.top=t.top),this.total="number"==typeof t.total?t.total:this.items.length,this.next=t.next}getIndexFromCursor=(t="first",s)=>{if(!Array.isArray(this.items)||!this.items.length)return null;const e=this.items.length-this.baseIndex;let r,i=0;if(["previous","next"].includes(t)&&s){const t=this.items.findIndex((t=>JSON.stringify(t)===JSON.stringify(s)));if(-1===t)return 0;i=t}return r="first"===t?0:"last"===t?e:"previous"===t?JSON.stringify(this.items[i])===JSON.stringify(this.items[0])?e:i-this.baseIndex:"next"===t?JSON.stringify(this.items[i])===JSON.stringify(this.items[e])?0:i+this.baseIndex:0,r}}class p{items=[];#t=10;#s;#e;constructor(t,e){Array.isArray(t)&&(this.items=t),e&&(["string","function"].includes(typeof e.next)||s(e.next)&&URL.canParse(e.next))&&(this.#s=e.next),"number"==typeof e?.top&&(this.#t=e.top),"number"==typeof e?.total&&(this.#e=e.total)}getPage=(t=0,s)=>{const e="function"==typeof s?this.items.filter(s):this.items;let r;return this.#s?r=this.#s:e.length>t+this.#t&&(r=()=>this.getPage(t+this.#t,s)),new y({items:e.slice(t,t+this.#t),total:this.#e,top:this.#t,next:r})}}const l=/^\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])$/,g=t=>t.toISOString().split("T")[0],b=(t,s)=>s.includes(t?.tagName.toLowerCase()),m='a[href], button, input, textarea, select, details, [tabindex]:not([tabindex="-1"]), [identifier], mg-button',S=t=>"number"==typeof t&&!Number.isNaN(t),d=t=>[t,...x(t),...A(t)],x=(t,s=[])=>{if(t.self!==t.top)try{const e=t.parent;return e?(s.push(e),x(e,s)):s}catch(t){return console.error("Different hosts between iframes:",t),s}return s},A=(t,s=[])=>{if(t.frames.length>0)for(const e of Array.from(t.frames))s.push(e),A(e,s);return s};export{t as C,p as P,h as a,b,a as c,r as d,c as e,f,d as g,y as h,i,e as j,s as k,m as l,o as m,u as n,l as o,g as p,S as q,n as t}