@appartmint/mint 1.2.12 → 1.3.1

package/src/ts/imports/util/selectors.ts

@@ -1,185 +0,0 @@
-/**
- * CSS-selector helpers
- * @public
- */
-export abstract class MintSelectors {
-    /**
-     * The library name that will be added as a prefix
-     */
-    static lib: string = 'mint';
-
-    /**
-     * The prefix built from the library name
-     */
-    static pre: string = `${this.lib}-`;
-
-    /**
-     * CSS-selector for disabled elements
-     */
-    static disabled: string = '[disabled]';
-
-    /**
-     * CSS-selector for elements with an aria-controls attribute
-     */
-    static hasControls: string = '[aria-controls]';
-
-    /**
-     * CSS-selector for elements with an aria-expanded attribute
-     */
-    static hasExpanded: string = '[aria-expanded]';
-
-    /**
-     * CSS-selector for elements with an href attribute
-     */
-    static hasLink: string = '[href]';
-
-    /**
-     * CSS-selector for elements with a routerLink attribute
-     */
-    static hasRouterLink: string = '[routerLink]';
-
-    /**
-     * CSS-selector for elements with an id attribute
-     */
-    static hasId: string = '[id]';
-
-    /**
-     * CSS-selector for elements that aren't tabbable (i.e. tabindex is negative)
-     */
-    static notTabbable: string = '[tabindex^="-"]';
-
-    /**
-     * CSS-selector for elements that are tabbable (i.e. tabindex isn't negative)
-     */
-    static tabbable: string = `[tabindex]${this.neg(this.notTabbable)}`;
-
-    /**
-     * CSS-selector for elements that can receive focus
-     */
-    static focusable: string = `input${this.neg(this.disabled)}${this.neg(this.notTabbable)},
-                                select${this.neg(this.disabled)}${this.neg(this.notTabbable)},
-                                textarea${this.neg(this.disabled)}${this.neg(this.notTabbable)},
-                                button${this.neg(this.disabled)}${this.neg(this.notTabbable)},
-                                object${this.neg(this.disabled)}${this.neg(this.notTabbable)},
-                                a${this.hasLink}, a${this.hasRouterLink},
-                                area${this.hasLink},
-                                ${this.tabbable}`.replace(/\s/g, '');
-
-    /**
-     * CSS-selector for submenu buttons
-     */
-    static subMenuButtons: string = `button${this.hasControls}`;
-
-    /**
-     * CSS-selector for submenus
-     */
-    static subMenu: string = `${this.subMenuButtons} + ul${this.hasId}`;
-
-    /**
-     * Adds the library prefix to the beginning of the provided string
-     * @param base - the string to be prefixed
-     * @returns - the provided string prefixed with the library name
-     */
-    static prefix (base: string) : string {
-        base = base.toLowerCase();
-        return base.startsWith(this.pre) ? base : `${this.pre}${base}`;
-    }
-
-    /**
-     * Adds two dashes to the beginning of the provided string
-     * @param base - the string to be prefixed
-     * @returns - the provided string prefixed with two dashes
-     */
-    static cssPrefix (base: string) : string {
-        return `--${this.prefix(base.replace(/^-+/, ''))}`;
-    }
-
-    /**
-     * Turns the provided string into a CSS variable call
-     * @param base - the name of the CSS variable to call
-     * @returns - the CSS variable call for the provided string
-     */
-    static cssVar (base: string) : string {
-        return `var(${this.cssPrefix(base)})`;
-    }
-
-    /**
-     * Negates the provided CSS selector
-     * @param base - the CSS selector to negate
-     * @returns - the negated CSS selector
-     */
-    static neg (base: string) : string {
-        return `:not(${base})`;
-    }
-
-    /**
-     * Generates a class CSS selector
-     * @param base - the name of the class to generate
-     * @returns - the generated CSS selector
-     */
-    static class (base: string) : string {
-        return `.${this.prefix(base)}`;
-    }
-
-    /**
-     * Generates an id CSS selector
-     * @param base - the name of the id to generate
-     * @returns - the generated CSS selector
-     */
-    static id (base: string) : string {
-        return `#${this.prefix(base)}`;
-    }
-
-    /**
-     * Generates an aria-controls CSS selector
-     * @param id - the id of the controlled element
-     * @returns - the generated CSS selector
-     */
-    static controls (id?: string | null) : string {
-        return id ? `[aria-controls="${this.prefix(id)}"]` : this.hasControls;
-    }
-
-    /**
-     * Generates an aria-expanded CSS selector
-     * @param bool - whether the element is expanded or not
-     * @returns - the generated CSS selector
-     */
-    static expanded (bool?: boolean | null) : string {
-        return typeof bool === 'boolean' ? `[aria-expanded="${bool}"]` : this.hasExpanded;
-    }
-
-    /**
-     * Returns a NodeList of HTMLElements within the given element that are focusable
-     * @param el - the element whose focusable children will be returned
-     * @returns - the elements within the given element that are focusable
-     */
-    static getFocusables (el?: HTMLElement) : HTMLElement[] {
-        let focusables: HTMLElement[];
-        if (el) {
-            focusables = Array.from(el.querySelectorAll<HTMLElement>(this.focusable));
-        } else {
-            focusables = Array.from(document.querySelectorAll<HTMLElement>(this.focusable));
-        }
-        return focusables.filter((el: HTMLElement) => this.isFocusable(el));
-    }
-
-    /**
-     * Returns true if an element is focusable and false if not,
-     * based on styles (i.e. a parent has display: none;)
-     * NOTE: Still need to determine what other styles may make an element un-focusable
-     * @param el - the element
-     * @returns - true if the element is focusable; false if not
-     */
-    static isFocusable (el: HTMLElement) : boolean {
-        let current: HTMLElement | null = el;
-
-        do {
-            if (window.getComputedStyle(current).getPropertyValue('display').toLowerCase() === 'none') {
-                return false;
-            }
-            current = current.parentElement;
-        } while (current);
-        return true;
-    }
-};
-export default MintSelectors;

package/src/ts/imports/util/settings.ts

@@ -1,85 +0,0 @@
-/**
- * Settings management
- * @public
- */
-export abstract class MintSettings {
-    /**
-     * Value added to all delay variables
-     */
-    static delayBase: number = 0;
-
-    /**
-     * Value multiplied by delay variable index
-     */
-    static delayStep: number = 100;
-
-    /**
-     * Delay variables
-     */
-    static delay: {[key: string]: number} = {
-        instant: this.delayBase + this.delayStep * 0,
-        fast: this.delayBase + this.delayStep * 1,
-        medFast: this.delayBase + this.delayStep * 2,
-        default: this.delayBase + this.delayStep * 3,
-        medSlow: this.delayBase + this.delayStep * 4,
-        slow: this.delayBase + this.delayStep * 5
-    };
-
-    /**
-     * Breakpoint variables
-     */
-    static break: {[key: string]: number} = {
-        z: 0,
-        xs: 480,
-        sm: 768,
-        md: 1024,
-        lg: 1200,
-        xl: 1440
-    };
-
-    /**
-     * Update the provided settings variables
-     * @param settings - Object of settings variables to update
-     */
-    static set (settings: {[key: string]: any}) : void {
-        let newDelay: boolean = false;
-        if (typeof settings.delayBase === 'number') {
-            this.delayBase = settings.delayBase;
-            newDelay = true;
-        }
-        if (typeof settings.delayStep === 'number') {
-            this.delayStep = settings.delayStep;
-            newDelay = true;
-        }
-        if (newDelay) {
-            this.setDelay();
-        }
-
-        if (settings.delay && Object.keys(settings.delay).length) {
-            if (Object.values(settings.delay).reduce((prev: any, next: any) => prev && typeof next === 'number', true)) {
-                this.delay = {...this.delay, ...settings.delay};
-            }
-        }
-
-        if (settings.break && Object.keys(settings.break).length) {
-            if (Object.values(settings.break).reduce((prev: any, next: any) => prev && typeof next === 'number', true)) {
-                this.break = {...this.break, ...settings.break};
-            }
-        }
-    }
-
-    /**
-     * Updates the delay variables based on `this.delayBase` and `this.delayStep`
-     */
-    protected static setDelay () : void {
-        this.delay = {
-            instant: this.delayBase + this.delayStep * 0,
-            fast: this.delayBase + this.delayStep * 1,
-            medFast: this.delayBase + this.delayStep * 2,
-            default: this.delayBase + this.delayStep * 3,
-            medSlow: this.delayBase + this.delayStep * 4,
-            slow: this.delayBase + this.delayStep * 5
-        };
-    }
-};
-export default MintSettings;

package/src/ts/imports/util/text.ts

@@ -1,151 +0,0 @@
-/**
- * Functions for analyzing and manipulating text.
- */
-export abstract class MintText {
-
-	/**
-	 * Generate a slug from a string
-	 * @param text - The string to slugify
-	 * @returns The slugified string
-	 */
-	static slug (text?: string): string {
-		return text?.trim()
-			.toLowerCase()
-			.replace(/'/g, '')
-			.replace(/[^\w/-]+/g, '-')
-			.replace(/-+/g, '-')
-			.replace(/^-+|-+$/g, '')
-			.replace(/^\/+|\/+$/g, '') ?? '';
-	}
-
-	/**
-	 * Generate a title from a slug
-	 * @param slug - The slug to generate a title from
-	 * @returns The title
-	 */
-	static unslug (slug: string): string {
-		return this.titleCase(slug.replace(/[-/]+/g, ' '));
-	}
-
-	/**
-	 * Format a phone number
-	 * @param phone - The phone number to format
-	 * @returns The formatted phone number
-	 */
-	static phone (phone?: string | number): string {
-		const given = phone?.toString().trim() ?? '';
-		if (given === '(' || given === '') {
-			return given;
-		}
-
-		let numbers = given.replace(/\D/g, '') ?? '',
-			formatted = '';
-
-		if (numbers.length > 10) {
-			formatted += `+${numbers.slice(0, numbers.length - 10)} `;
-			numbers = numbers.slice(numbers.length - 10);
-		}
-
-		for (var i = 0; i < numbers.length; i++) {
-			switch (i) {
-				case 0:
-					formatted += '(';
-					break;
-				case 3:
-					formatted += ') ';
-					break;
-				case 6:
-					formatted += '-';
-					break;
-			}
-			formatted += numbers[i];
-		}
-
-		switch (given[given.length - 1]) {
-			case ')':
-				if (i === 3) {
-					formatted += ') ';
-				}
-				break;
-			case '-':
-				if (i === 6) {
-					formatted += '-';
-				}
-				break;
-		}
-
-		return formatted;
-	}
-
-	/**
-	 * Pluralize the given word
-	 */
-	static plural (word: string): string {
-		if (word.endsWith('ies') ||
-			word.endsWith('es') ||
-			(word.endsWith('s') && !word.endsWith('us') && !word.endsWith('is') && !word.endsWith('ss'))) {
-			return word;
-		}
-
-		if (word.endsWith('y') && !['a', 'e', 'i', 'o', 'u'].includes(word.charAt(word.length - 2))) {
-			return word.slice(0, -1) + 'ies';
-		}
-
-		if (word.endsWith('s') || word.endsWith('sh') || word.endsWith('ch') || word.endsWith('x') || word.endsWith('z')) {
-			return word + 'es';
-		}
-
-		return word + 's';
-	}
-
-	/**
-	 * Capitalize the first letter of the given word
-	 */
-	static titleCase (text: string): string {
-		return text
-			.toLowerCase()
-			.replace(/(?:^|\s)\S/g, a => a.toUpperCase());
-	}
-
-	/**
-     * Copies the provided text to the clipboard
-     * @param text - the text to copy
-     * @returns - true if the text was successfully copied to the clipboard; else false
-     */
-    static copyText (text: string) : boolean {
-        let textArea: HTMLTextAreaElement = document.createElement('textarea');
-
-        if (!text || !textArea) {
-            return false;
-        }
-
-        textArea.value = text;
-        textArea.style.cssText = `
-            position: fixed;
-            top: 0;
-            left: 0;
-            transform: translate(-100%, -100%);
-            opacity: 0;
-            z-index: -1;
-        `;
-
-        document.body.appendChild(textArea);
-        textArea.select();
-        textArea.setSelectionRange(0, 99999);
-        navigator.clipboard.writeText(textArea.value);
-        document.body.removeChild(textArea);
-
-        return true;
-    }
-
-    /**
-     * Tests the validity of an email address
-     * @see {@link https://stackoverflow.com/questions/201323/how-can-i-validate-an-email-address-using-a-regular-expression}
-     * @param text - the string to test
-     * @returns - true if the given string is an email address; false if not
-     */
-    static isEmail (text: string) : boolean {
-        return null !== text.match(/(?:[a-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[a-z0-9!#$%&'*+/=?^_`{|}~-]+)*|"(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21\x23-\x5b\x5d-\x7f]|\\[\x01-\x09\x0b\x0c\x0e-\x7f])*")@(?:(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)+[a-z0-9](?:[a-z0-9-]*[a-z0-9])?|\[(?:(?:(2(5[0-5]|[0-4][0-9])|1[0-9][0-9]|[1-9]?[0-9]))\.){3}(?:(2(5[0-5]|[0-4][0-9])|1[0-9][0-9]|[1-9]?[0-9])|[a-z0-9-]*[a-z0-9]:(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21-\x5a\x53-\x7f]|\\[\x01-\x09\x0b\x0c\x0e-\x7f])+)\])/);
-    }
-};
-export default MintText;

package/src/ts/imports/util/window.ts

@@ -1,14 +0,0 @@
-/**
- * Functions related to the browser window.
- */
-export abstract class MintWindow {
-	/**
-     * Returns the width of the window, including fractional pixels
-     * @returns the width of the window
-     */
-    static width () : number {
-        const decimal: number = document.body.getBoundingClientRect().width % 1;
-        return window.innerWidth + decimal;
-    }
-};
-export default MintWindow;

package/src/ts/index.ts

@@ -1,10 +0,0 @@
-/**
- * A library for building responsive web applications.
- *
- * @packageDocumentation
- */
-
-/**
- * Exports
- */
-export * from './imports';