danholibraryjs 1.11.0 → 2.0.1

package/dist/Extensions/Array.d.ts

@@ -1,52 +0,0 @@
-export type UpdateFinder<T> = (item: T, index: number, self: Array<T>) => boolean;
-declare global {
-    interface Array<T> {
-        /**
-         * Pushes items to array and returns self with new items
-         * @param items Items to add to array
-         */
-        add(...items: Array<T>): this;
-        /**
-         * Update an item in array
-         * @param old The old value or index to update
-         * @param updated Updated value
-         */
-        update(old: T | number | UpdateFinder<T>, updated: T): T;
-        /**
-         * Removes item from array and returns self without item
-         * @param item Item or index to remove
-         */
-        remove(item: T | number): this;
-        /**
-         * Returns a random element from array
-         */
-        random(): T;
-        /**
-         * Returns item matching index. If negative number, subtracts number from length
-         * @param i Index of item
-         */
-        index(i: number): T;
-        /**
-         * For every x in array, execute callback
-         * @param every i.e every 2nd item in array
-         * @param callback Function to execute
-         * @returns Array of results
-         */
-        nth<U>(every: number, callback: (item: T, index: number, collection: Array<T>, self: this) => U): Array<U>;
-    }
-}
-declare function add<T>(this: Array<T>, ...items: Array<T>): T[];
-declare function update<T>(this: Array<T>, old: T | number | UpdateFinder<T>, updated: T): T;
-declare function remove<T>(this: Array<T>, value: T | number): Array<T>;
-declare function random<T>(this: Array<T>): T;
-declare function index<T>(this: Array<T>, i: number): T;
-declare function nth<T, U>(this: Array<T>, every: number, callback: (item: T, index: number, collection: Array<T>, self: Array<T>) => U): Array<U>;
-export declare const ArrayExtensions: {
-    add: typeof add;
-    update: typeof update;
-    remove: typeof remove;
-    random: typeof random;
-    index: typeof index;
-    nth: typeof nth;
-};
-export {};

package/dist/Extensions/Array.js

@@ -1,51 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ArrayExtensions = void 0;
-function add(...items) {
-    this.push(...items);
-    return this;
-}
-Array.prototype.add = add;
-function update(old, updated) {
-    const item = typeof old === 'number' ? this[old]
-        : typeof old === 'function' ? this.find(old)
-            : old;
-    if (!item)
-        throw new Error('Old was not found in array!');
-    const index = this.indexOf(item);
-    return this[index] = updated;
-}
-Array.prototype.update = update;
-function remove(value) {
-    const index = typeof value === 'number' ? value : this.indexOf(value);
-    if (index > -1)
-        this.splice(index, 1);
-    return this;
-}
-Array.prototype.remove = remove;
-function random() {
-    const randomIndex = Math.round(Math.random() * this.length);
-    return this[randomIndex];
-}
-Array.prototype.random = random;
-function index(i) {
-    return this[i < 0 ? this.length + i : i];
-}
-Array.prototype.index = index;
-function nth(every, callback) {
-    const result = new Array();
-    let collection = new Array();
-    for (let i = 0; i < this.length; i++) {
-        collection.push(this[i]);
-        if (i % every === 0) {
-            result.push(callback(this[i], i, collection, this));
-            collection = new Array();
-        }
-    }
-    return result;
-}
-Array.prototype.nth = nth;
-exports.ArrayExtensions = {
-    add, update, remove,
-    random, index, nth
-};

package/dist/Extensions/Document.d.ts

@@ -1,27 +0,0 @@
-import { IElement } from "../Types";
-declare global {
-    interface Document {
-        /**
-         * Creates an element like Document#createElement, however with construction options to assign values in construction instead of after construction.
-         * @param tagName HTMLElement tag name
-         * @param options Construction options, instead of assigning values after construction
-         * @param children Child elements
-         */
-        createProperElement<Tag extends keyof HTMLElementTagNameMap>(tagName: Tag, options?: Partial<HTMLElementTagNameMap[Tag]>, ...children: Array<IElement>): HTMLElementTagNameMap[Tag];
-        createProperElement<Tag extends keyof HTMLElementTagNameMap>(tagName: Tag, ...children: Array<IElement>): HTMLElementTagNameMap[Tag];
-        createElementFromString<K extends keyof HTMLElementTagNameMap>(html: string, parentTag?: K): HTMLElementTagNameMap[K];
-    }
-    interface HTMLCollection {
-        /**
-         * Converts HTMLCollection to Element[]
-         */
-        array(): Element[];
-    }
-}
-declare function createElement<Tag extends keyof HTMLElementTagNameMap>(this: Document, tagName: Tag, options?: Partial<HTMLElementTagNameMap[Tag]> | string, ...children: Array<IElement>): HTMLElementTagNameMap[Tag];
-declare function createElementFromString<Tag extends keyof HTMLElementTagNameMap>(this: Document, html: string, tag?: Tag): HTMLElementTagNameMap[Tag];
-export declare const DocumentExtensions: {
-    createElement: typeof createElement;
-    createElementFromString: typeof createElementFromString;
-};
-export {};

package/dist/Extensions/Document.js

@@ -1,32 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DocumentExtensions = void 0;
-function createElement(tagName, options, ...children) {
-    const element = Object.assign(document.createElement(tagName), typeof options === 'string' ? {} : options);
-    children ??= typeof options === 'string' ? [options] : [];
-    typeof options === 'string' && children.unshift(options);
-    if (!children.length)
-        return element;
-    else if (typeof children === 'string')
-        element.innerHTML = children;
-    else if (children instanceof Array)
-        children.forEach(child => (typeof child === 'string' ?
-            element.innerHTML += child :
-            element.appendChild(child)));
-    else
-        element.appendChild(children);
-    return element;
-}
-Document.prototype.createProperElement = createElement;
-function createElementFromString(html, tag) {
-    if (!html.startsWith(`<${tag}`))
-        html = `<${tag}>${html}</${tag}>`;
-    return new DOMParser().parseFromString(html, 'text/html').body.firstElementChild;
-}
-Document.prototype.createElementFromString = createElementFromString;
-HTMLCollection.prototype.array = function () {
-    return Array.from(this);
-};
-exports.DocumentExtensions = {
-    createElement, createElementFromString
-};

package/dist/Extensions/String.d.ts

@@ -1,36 +0,0 @@
-import IReplacement from "../Interfaces/IReplacement";
-declare global {
-    interface String {
-        /**
-         * Uppercases first letter of string
-         */
-        toPascalCase(): string;
-        /**
-         * Replaces "replacer" (default: ' ') with "replacement" (default: '_')
-         * @param replaceOptions This is practically your stereotypical String.replace, if you really want it to be
-         */
-        toSnakeCase(replaceOptions?: IReplacement): string;
-        /**
-         * Replaces "replacer" (default: ' ') with "replacement" (default: '-')
-         * @param replaceOptions This is practically your stereotypical String.replace, if you really want it to be
-         */
-        toKebabCase(replaceOptions?: IReplacement): string;
-        /**
-         * String.substring but accepting negative numbers to cut from length
-         * @param start Start of string. 0 indexed, if negative number, subtracts number from length
-         * @param end End of string. 0 indexed, if negative number, substracts number from length
-         */
-        clip(start: number, end?: number): string;
-    }
-}
-declare function toPascalCase(this: string): string;
-declare function toSnakeCase(this: string, replaceOptions: IReplacement): string;
-declare function toKebabCase(this: string, replaceOptions: IReplacement): string;
-declare function clip(this: string, start: number, end?: number): string;
-export declare const StringExtensions: {
-    toPascalCase: typeof toPascalCase;
-    toSnakeCase: typeof toSnakeCase;
-    toKebabCase: typeof toKebabCase;
-    clip: typeof clip;
-};
-export {};

package/dist/Extensions/String.js

@@ -1,25 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.StringExtensions = void 0;
-function toPascalCase() {
-    return this.substring(0, 1).toUpperCase() + this.substring(1);
-}
-String.prototype.toPascalCase = toPascalCase;
-function spaceReplacer(self, replacer, replacement) {
-    return self.replace(new RegExp(`${typeof replacer == 'string' ? replacer : replacer.source}+`), replacement);
-}
-function toSnakeCase(replaceOptions) {
-    return spaceReplacer(this, replaceOptions.replacer || ' ', replaceOptions.replacement || '_');
-}
-String.prototype.toSnakeCase = toSnakeCase;
-function toKebabCase(replaceOptions) {
-    return spaceReplacer(this, replaceOptions.replacer || ' ', replaceOptions.replacement || '-');
-}
-String.prototype.toKebabCase = toKebabCase;
-function clip(start, end) {
-    return this.substring(start < 0 ? this.length - start : start, end && end < 0 ? this.length + end : end);
-}
-String.prototype.clip = clip;
-exports.StringExtensions = {
-    toPascalCase, toSnakeCase, toKebabCase, clip
-};

package/dist/Functions/CopyToClipboard.d.ts

@@ -1,7 +0,0 @@
-/**
- * Copies value to clipboard and alerts a response, if response is defined
- * @param value Value to clipboard
- * @param response Alerts if response is given
- */
-export declare function CopyToClipboard(value: string, response?: string): Promise<void>;
-export default CopyToClipboard;

package/dist/Functions/CopyToClipboard.js

@@ -1,15 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CopyToClipboard = void 0;
-/**
- * Copies value to clipboard and alerts a response, if response is defined
- * @param value Value to clipboard
- * @param response Alerts if response is given
- */
-async function CopyToClipboard(value, response) {
-    await navigator.clipboard.writeText(value);
-    if (response)
-        alert(response);
-}
-exports.CopyToClipboard = CopyToClipboard;
-exports.default = CopyToClipboard;

package/dist/Functions/GetCSSProperty.d.ts

@@ -1,15 +0,0 @@
-type CSSReturnTypes = {
-    string: string;
-    number: number;
-};
-/**
- * Gets the value of "property" in type "type" from query "query"
- * Basically, you can get your --color-primary from :root
- *
- * @param property Name of the property to get
- * @param type Type of the property to parse
- * @param query Query to get the element that has the property
- * @returns Property value converted to type
-*/
-export declare function GetCSSProperty<Type extends keyof CSSReturnTypes>(property: string, type: Type, query?: string): CSSReturnTypes[Type];
-export {};

package/dist/Functions/GetCSSProperty.js

@@ -1,26 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.GetCSSProperty = void 0;
-/**
- * Gets the value of "property" in type "type" from query "query"
- * Basically, you can get your --color-primary from :root
- *
- * @param property Name of the property to get
- * @param type Type of the property to parse
- * @param query Query to get the element that has the property
- * @returns Property value converted to type
-*/
-function GetCSSProperty(property, type, query = ":root") {
-    const rootEl = document.querySelector(query);
-    if (!rootEl)
-        throw new Error(`${query} does not exist!`);
-    const rootStyles = getComputedStyle(rootEl);
-    const cssProp = rootStyles.getPropertyValue(property);
-    if (type === 'string')
-        return cssProp;
-    const numberValue = parseInt(cssProp);
-    if (isNaN(numberValue))
-        throw new Error(`${property} is not a number!: ${cssProp}`);
-    return numberValue;
-}
-exports.GetCSSProperty = GetCSSProperty;

package/dist/Functions/GetNestedProperty.d.ts

@@ -1,9 +0,0 @@
-export type GetNestedProperty<Parent, Key extends string> = Key extends keyof Parent ? Parent[Key] : Key extends `${infer K}.${infer Rest}` ? K extends keyof Parent ? GetNestedProperty<Parent[K], Rest> : never : never;
-/**
- * Gets a nested property from an object
- * @param parent Parent object to search
- * @param key Key to search for. Can be nested with dot notation
- * @returns Value of key or null if not found
- */
-export declare function GetNestedProperty<Parent extends object, Key extends string>(parent: Parent, key: Key): GetNestedProperty<Parent, Key> | null;
-export default GetNestedProperty;

package/dist/Functions/GetNestedProperty.js

@@ -1,23 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.GetNestedProperty = void 0;
-/**
- * Gets a nested property from an object
- * @param parent Parent object to search
- * @param key Key to search for. Can be nested with dot notation
- * @returns Value of key or null if not found
- */
-function GetNestedProperty(parent, key) {
-    if (key in parent)
-        return parent[key];
-    for (const prop in parent) {
-        if (typeof parent[prop] === 'object') {
-            const result = GetNestedProperty(parent[prop], key);
-            if (result)
-                return result;
-        }
-    }
-    return null;
-}
-exports.GetNestedProperty = GetNestedProperty;
-exports.default = GetNestedProperty;

package/dist/Functions/HTMLEvent.d.ts

@@ -1,11 +0,0 @@
-/**
- * Create HTMLEvent object from function
- * @param name Name of the event
- * @param handler Handler for the event
- * @returns Parameters as object
- */
-export declare function HTMLEvent<Event extends keyof HTMLElementEventMap, ReturnType extends any>(name: Event, handler: (event: HTMLElementEventMap[Event]) => ReturnType): {
-    name: Event;
-    handler: (event: HTMLElementEventMap[Event]) => ReturnType;
-};
-export default HTMLEvent;

package/dist/Functions/HTMLEvent.js

@@ -1,14 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.HTMLEvent = void 0;
-/**
- * Create HTMLEvent object from function
- * @param name Name of the event
- * @param handler Handler for the event
- * @returns Parameters as object
- */
-function HTMLEvent(name, handler) {
-    return { name, handler };
-}
-exports.HTMLEvent = HTMLEvent;
-exports.default = HTMLEvent;

package/dist/Functions/SetNavigationSelected.d.ts

@@ -1,9 +0,0 @@
-/**
- * Appends classes to header's "a" elements, when navigation to "a"'s page is selected
- * @param query The query selector for Document.querySelector
- * @param currentPageClasses Class(es) to append header's "a" elements
- *
- * @borrows Document.querySelector
- */
-export declare function SetNavigationSelected(query: string, ...currentPageClasses: string[]): void;
-export default SetNavigationSelected;

package/dist/Functions/SetNavigationSelected.js

@@ -1,25 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SetNavigationSelected = void 0;
-/**
- * Appends classes to header's "a" elements, when navigation to "a"'s page is selected
- * @param query The query selector for Document.querySelector
- * @param currentPageClasses Class(es) to append header's "a" elements
- *
- * @borrows Document.querySelector
- */
-function SetNavigationSelected(query, ...currentPageClasses) {
-    const header = document.querySelector(query);
-    if (!header)
-        throw { message: `Couldn't find header from query, ${query}` };
-    const children = header.children.array().filter(c => c.tagName === 'a');
-    const currentPage = document.location.href;
-    children.forEach(gc => {
-        if (gc.href != currentPage)
-            gc.classList.remove(...currentPageClasses);
-        else
-            gc.classList.add(...currentPageClasses);
-    });
-}
-exports.SetNavigationSelected = SetNavigationSelected;
-exports.default = SetNavigationSelected;

package/dist/Functions/index.d.ts

@@ -1,5 +0,0 @@
-export * from './CopyToClipboard';
-export * from './GetCSSProperty';
-export * from './GetNestedProperty';
-export * from './SetNavigationSelected';
-export * from './HTMLEvent';

package/docs/Functions.md

@@ -1,61 +0,0 @@
-# [DanhoLibraryJS](../README.md)
-
-## Functions
-
-```ts
-/**
- * Copies value to clipboard and alerts a response, if response is defined
- * @param value Value to clipboard
- * @param response Alerts if response is given
- */
-async function CopyToClipboard(value: string, response?: string): Promise<void>;
-
-/**
- * Gets the value of "property" in type "type" from query "query"
- * Basically, you can get your --color-primary from :root
- * 
- * @param property Name of the property to get
- * @param type Type of the property to parse
- * @param query Query to get the element that has the property
- * @returns Property value converted to type
-*/
-function GetCSSProperty<Type extends keyof CSSReturnTypes>(property: string, type: Type, query = ":root"): CSSReturnTypes[Type];
-
-/**
- * Gets a nested property from an object
- * @param parent Parent object to search
- * @param key Key to search for. Can be nested with dot notation
- * @returns Value of key or null if not found
- */
-function GetNestedProperty<Parent, Key extends string>(parent: Parent, key: Key): GetNestedProperty<Parent, Key> | null;
-
-/**
- * Create HTMLEvent object from function
- * @param name Name of the event
- * @param handler Handler for the event
- * @returns Parameters as object
- */
-function HTMLEvent<
-    Event extends keyof HTMLElementEventMap, 
-    ReturnType extends any
->(name: Event, handler: (event: HTMLElementEventMap[Event]) => ReturnType): { 
-    name: Event, 
-    handler: (event: HTMLElementEventMap[Event]) => ReturnType 
-}
-
-/**
- * Appends classes to header's "a" elements, when navigation to "a"'s page is selected
- * @param query The query selector for Document.querySelector
- * @param currentPageClasses Class(es) to append header's "a" elements
- * 
- * @borrows Document.querySelector
- */
-function SetNavigationSelected(query: string, ...currentPageClasses: Array<string>): void;
-
-/**
- * Converts input into milliseconds
- * @param input Input to convert to ms. 1s | 2m | 3h | 1M | 60000
- * @returns Millisecond value of input
- */
-function ms(input: TimeDelay): number
-```

package/src/Extensions/Array.ts

@@ -1,95 +0,0 @@
-export type UpdateFinder<T> = (item: T, index: number, self: Array<T>) => boolean
-
-declare global {
-    interface Array<T> {
-        /**
-         * Pushes items to array and returns self with new items
-         * @param items Items to add to array
-         */
-        add(...items: Array<T>): this
-        /**
-         * Update an item in array
-         * @param old The old value or index to update
-         * @param updated Updated value
-         */
-        update(old: T | number | UpdateFinder<T>, updated: T): T
-        /**
-         * Removes item from array and returns self without item
-         * @param item Item or index to remove
-         */
-        remove(item: T | number): this
-        /**
-         * Returns a random element from array
-         */
-        random(): T
-        /**
-         * Returns item matching index. If negative number, subtracts number from length
-         * @param i Index of item
-         */
-        index(i: number): T,
-        /**
-         * For every x in array, execute callback
-         * @param every i.e every 2nd item in array
-         * @param callback Function to execute
-         * @returns Array of results
-         */
-        nth<U>(every: number, callback: (item: T, index: number, collection: Array<T>, self: this) => U): Array<U>
-    }
-}
-
-function add<T>(this: Array<T>, ...items: Array<T>) {
-    this.push(...items);
-    return this;
-}
-Array.prototype.add = add;
-
-function update<T>(this: Array<T>, old: T | number | UpdateFinder<T>, updated: T) {
-    const item = typeof old === 'number' ? this[old] 
-        : typeof old === 'function' ? this.find(old as UpdateFinder<T>) 
-        : old;
-    if (!item) throw new Error('Old was not found in array!');
-
-    const index = this.indexOf(item);
-    return this[index] = updated;
-}
-Array.prototype.update = update;
-
-function remove<T>(this: Array<T>, value: T | number): Array<T> {
-    const index = typeof value === 'number' ? value : this.indexOf(value);
-    if (index > -1) this.splice(index, 1);
-    return this;
-}
-Array.prototype.remove = remove;
-
-function random<T>(this: Array<T>): T {
-    const randomIndex = Math.round(Math.random() * this.length);
-    return this[randomIndex];
-}
-Array.prototype.random = random;
-
-function index<T>(this: Array<T>, i: number): T {
-    return this[i < 0 ? this.length + i : i];
-}
-Array.prototype.index = index;
-
-function nth<T, U>(this: Array<T>, every: number, callback: (item: T, index: number, collection: Array<T>, self: Array<T>) => U): Array<U> {
-    const result = new Array<U>();
-    let collection = new Array<T>();
-
-    for (let i = 0; i < this.length; i++) {
-        collection.push(this[i]);
-        
-        if (i % every === 0) {
-            result.push(callback(this[i], i, collection, this));
-            collection = new Array<T>();
-        }
-    }
-
-    return result;
-}
-Array.prototype.nth = nth;
-
-export const ArrayExtensions = {
-    add, update, remove, 
-    random, index, nth
-};

package/src/Extensions/Document.ts

@@ -1,58 +0,0 @@
-import { IElement } from "../Types";
-
-declare global {
-    interface Document {
-        /**
-         * Creates an element like Document#createElement, however with construction options to assign values in construction instead of after construction.
-         * @param tagName HTMLElement tag name
-         * @param options Construction options, instead of assigning values after construction
-         * @param children Child elements
-         */
-        createProperElement<Tag extends keyof HTMLElementTagNameMap>(tagName: Tag, options?: Partial<HTMLElementTagNameMap[Tag]>, ...children: Array<IElement>): HTMLElementTagNameMap[Tag]
-        createProperElement<Tag extends keyof HTMLElementTagNameMap>(tagName: Tag, ...children: Array<IElement>): HTMLElementTagNameMap[Tag]
-        createElementFromString<K extends keyof HTMLElementTagNameMap>(html: string, parentTag?: K): HTMLElementTagNameMap[K]
-    }
-    interface HTMLCollection {
-        /**
-         * Converts HTMLCollection to Element[]
-         */
-        array(): Element[]
-    }
-}
-
-function createElement<Tag extends keyof HTMLElementTagNameMap>(
-    this: Document, tagName: Tag, 
-    options?: Partial<HTMLElementTagNameMap[Tag]> | string, 
-    ...children: Array<IElement>
-): HTMLElementTagNameMap[Tag] {
-    
-    const element = Object.assign(document.createElement(tagName), typeof options === 'string' ? {} : options);
-    children ??= typeof options === 'string' ? [options] as Array<IElement> : [];
-    typeof options === 'string' && children.unshift(options);
-
-    if (!children.length) return element;
-    else if (typeof children === 'string') element.innerHTML = children;
-    else if (children instanceof Array) children.forEach(child => (
-        typeof child === 'string' ? 
-            element.innerHTML += child : 
-            element.appendChild(child)
-    ));
-    else element.appendChild(children);
-    return element;
-
-}
-Document.prototype.createProperElement = createElement;
-
-function createElementFromString<Tag extends keyof HTMLElementTagNameMap>(this: Document, html: string, tag?: Tag): HTMLElementTagNameMap[Tag] {
-    if (!html.startsWith(`<${tag}`)) html = `<${tag}>${html}</${tag}>`;
-    return new DOMParser().parseFromString(html, 'text/html').body.firstElementChild as HTMLElementTagNameMap[Tag];
-}
-Document.prototype.createElementFromString = createElementFromString;
-
-HTMLCollection.prototype.array = function(this: HTMLCollection) {
-    return Array.from(this);
-};
-
-export const DocumentExtensions = {
-    createElement, createElementFromString
-};