danholibraryjs 1.11.0 → 2.0.1

package/dist/Types/index.d.ts

@@ -1,65 +1,24 @@
-export * from './BetterTypes';
-export * from './Date';
-export * from './Events';
-export * from './TransformTypes';
-export * from './PropertiesWith';
-/**
- * Item is single or multiple
- */
-export type Arrayable<T> = T | Array<T>;
-/**
- * Item is function or T
- */
-export type Functionable<T> = T | (() => T);
-/**
- * Item is Promise<T> or T
- */
-export type Promisable<T> = T | Promise<T>;
-/**
- * Item is T or null
- */
-export type Nullable<T> = T | null;
-/**
- * Item cannot be null or undefined
- */
-export type NonNullable<T> = T extends null ? never : T extends undefined ? never : T;
-/**
- * C# Guid representation
- */
-export type Guid = string;
-/**
- * C# TimeSpan representation from JSON
- */
-export type TimeSpanType = string;
-/**
- * Used for HTMLElement.append in ElementOptions, Document.createProperElement.
- * IElement accepts HTML Elements or HTMl-like strings.
- *
- * @see HTMLElement.append
- * @see Document.createElement
- */
-export type IElement = HTMLElement | string;
-/**
- * Return types of T
- */
-export type ValueOf<T> = T[keyof T];
-/**
- * Type's properties are ReturnType
- */
-export type AllPropsAre<ReturnType> = {
-    [key: string]: ReturnType;
-};
-/**
- * string or RegExp.. pretty self-explanatory
- */
-export type StringRegex = string | RegExp;
-export type If<Boolean extends boolean, True, False> = Boolean extends true ? True : False;
-/**
- * GetRepeatedKeys<[
- *  { username: string, password: string },
- *  { username: number, email: string },
- * ]> // { username: string | number }
- */
-export type GetRepeatedKeys<Types extends Array<any>> = (Types extends [infer First, infer Second, ...infer Rest] ? First extends object ? Second extends object ? {
-    [Key in Extract<keyof First, keyof Second>]: First[Key] | Second[Key];
-} & GetRepeatedKeys<Rest> : {} : {} : {});
+export * from './Able';
+export * from './Array';
+export * from './BetterTypes';
+export * from './C#';
+export * from './Date';
+export * from './Events';
+export * from './Function';
+export * from './TransformTypes';
+export * from './Object';
+export * from './PropertiesWith';
+export * from './String';
+/**
+ * Used for HTMLElement.append in ElementOptions, Document.createProperElement.
+ * IElement accepts HTML Elements or HTMl-like strings.
+ *
+ * @see HTMLElement.append
+ * @see Document.createElement
+ */
+export type IElement = HTMLElement | string;
+/**
+ * string or RegExp.. pretty self-explanatory
+ */
+export type StringRegex = string | RegExp;
+export type If<Boolean extends boolean, True, False> = Boolean extends true ? True : False;

package/dist/Types/index.js

@@ -1,21 +1,27 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./BetterTypes"), exports);
-__exportStar(require("./Date"), exports);
-__exportStar(require("./Events"), exports);
-__exportStar(require("./TransformTypes"), exports);
-__exportStar(require("./PropertiesWith"), exports);
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./Able"), exports);
+__exportStar(require("./Array"), exports);
+__exportStar(require("./BetterTypes"), exports);
+__exportStar(require("./C#"), exports);
+__exportStar(require("./Date"), exports);
+__exportStar(require("./Events"), exports);
+__exportStar(require("./Function"), exports);
+__exportStar(require("./TransformTypes"), exports);
+__exportStar(require("./Object"), exports);
+__exportStar(require("./PropertiesWith"), exports);
+__exportStar(require("./String"), exports);

package/dist/Utils/{ApiUtil → ApiUtils}/ApiTypes.d.ts

@@ -1,15 +1,15 @@
-export type TParam = string | undefined;
-export type HttpMethods = 'GET' | 'POST' | 'PUT' | 'DELETE';
-export type RequestOptions<TBody = any> = Omit<RequestInit, 'method' | 'body'> & {
-    method?: HttpMethods;
-    body?: TBody;
-    noHeaders?: boolean;
-    controller?: AbortController;
-    query?: Record<string, string | undefined>;
-    baseEndpoint?: string;
-};
-export type ApiUtilOptions = {
-    baseEndpointDev: string;
-    baseEndpoint?: string;
-    log?: boolean;
-};
+export type TParam = string | undefined;
+export type HttpMethods = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+export type RequestOptions<TBody = any> = Omit<RequestInit, 'method' | 'body'> & {
+    method?: HttpMethods;
+    body?: TBody;
+    noHeaders?: boolean;
+    controller?: AbortController;
+    query?: Record<string, string | undefined>;
+    baseEndpoint?: string;
+};
+export type ApiUtilOptions = {
+    baseEndpointDev: string;
+    baseEndpoint?: string;
+    log?: boolean;
+};

package/dist/Utils/{ApiUtil → ApiUtils}/ApiTypes.js

@@ -1,15 +1,15 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-// All possible endpoints for the API. This will generate autocomplete when using the Request function
-// The commented code below is an example from my previous "CitizenTaxi" project to illustrate how this works
-// export type ApiEndpoints<Param extends TParam = undefined> =
-//   | `bookings` // [GET, POST]
-//   | `bookings?citizenId=${Param}` // [GET] Guid
-//   | `bookings/${Param}` // [GET, PUT, DELETE] Guid bookingId
-//   | `notes` // [GET, POST]
-//   | `notes?citizenId=${Param}` // [GET] Guid
-//   | `notes/${Param}` // [GET, PUT, DELETE] Guid noteId
-//   | `users` // [GET, POST]
-//   | `users?role=${Param}` // [GET] enum Role
-//   | `users/${Param}` // [GET, PUT, DELETE] Guid userId
-//   | `users/authenticate`; // [POST, DELETE]
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// All possible endpoints for the API. This will generate autocomplete when using the Request function
+// The commented code below is an example from my previous "CitizenTaxi" project to illustrate how this works
+// export type ApiEndpoints<Param extends TParam = undefined> =
+//   | `bookings` // [GET, POST]
+//   | `bookings?citizenId=${Param}` // [GET] Guid
+//   | `bookings/${Param}` // [GET, PUT, DELETE] Guid bookingId
+//   | `notes` // [GET, POST]
+//   | `notes?citizenId=${Param}` // [GET] Guid
+//   | `notes/${Param}` // [GET, PUT, DELETE] Guid noteId
+//   | `users` // [GET, POST]
+//   | `users?role=${Param}` // [GET] enum Role
+//   | `users/${Param}` // [GET, PUT, DELETE] Guid userId
+//   | `users/authenticate`; // [POST, DELETE]

package/dist/Utils/{ApiUtil → ApiUtils}/RequestUtil.d.ts

@@ -1,19 +1,19 @@
-import { RequestOptions } from "./ApiTypes";
-/**
- * Makes a request to the API
- * @param path Api endpoint to request
- * @param options Additional options for the request
- * @returns The response from the API
- */
-export declare function Request<TData, ApiEndpoints extends string>(path: ApiEndpoints, { method, body, noHeaders, controller, query, baseEndpoint }?: RequestOptions | undefined, log?: boolean): Promise<{
-    success: boolean;
-    status: number;
-    data: TData;
-    text: string;
-}>;
-/**
- * Ensures that the path starts with a /
- * @param path Path string
- * @returns Path that starts with a /
- */
-export declare function ensureSlash(path: string): string;
+import { RequestOptions } from "./ApiTypes";
+/**
+ * Makes a request to the API
+ * @param path Api endpoint to request
+ * @param options Additional options for the request
+ * @returns The response from the API
+ */
+export declare function Request<TData, ApiEndpoints extends string>(path: ApiEndpoints, { method, body, noHeaders, controller, query, baseEndpoint }?: RequestOptions | undefined, log?: boolean): Promise<{
+    success: boolean;
+    status: number;
+    data: TData;
+    text: string;
+}>;
+/**
+ * Ensures that the path starts with a /
+ * @param path Path string
+ * @returns Path that starts with a /
+ */
+export declare function ensureSlash(path: string): string;

package/dist/Utils/{ApiUtil → ApiUtils}/RequestUtil.js

@@ -1,73 +1,73 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ensureSlash = exports.Request = void 0;
-/**
- * Makes a request to the API
- * @param path Api endpoint to request
- * @param options Additional options for the request
- * @returns The response from the API
- */
-async function Request(path, 
-// Destructor the options object, if it's undefined then set it to an empty object
-{ method = 'GET', body, noHeaders = false, controller = new AbortController(), query, baseEndpoint } = {}, log = false) {
-    // console.log(`Requesting ${path} with method ${method}`);
-    // Construct the endpoint for the request
-    const endpoint = (() => {
-        const result = baseEndpoint + ensureSlash(path);
-        if (path.includes('?') || !query)
-            return result;
-        // If the query object is defined, then construct a query string from it
-        const queryString = Object.entries(query)
-            .map(([key, value]) => value ? `${key}=${value}` : '')
-            .join('&');
-        return path.includes('?') ? `${result}&${queryString}` : `${result}?${queryString}`;
-    })();
-    // Construct the request init object to pass to the fetch function
-    const init = {
-        method,
-        body: body ? !noHeaders ? JSON.stringify(body) : body : undefined,
-        headers: !noHeaders ? { 'Content-Type': 'application/json' } : undefined,
-        signal: controller.signal,
-        credentials: 'include',
-        mode: 'cors'
-    };
-    // Make the request, log any errors, and throw them again
-    const res = await fetch(endpoint, init).catch(err => {
-        console.error(`Failed to [${method}] ${path}`, err);
-        throw err;
-    });
-    if (log)
-        console.log(`[${method}] ${path} responded with ${res.status}`, res);
-    // Clone the response so that it can be converted to JSON and text
-    const clone = res.clone();
-    // All successful responses are in the 200s, so check if the status code starts with 2
-    const isSuccessful = res.status.toString().startsWith('2');
-    // This try-catch block is used to catch any errors when converting the response to JSON
-    // If the response is not jsonable, then the catch will return null for the data
-    try {
-        return {
-            success: isSuccessful,
-            status: res.status,
-            data: await res.json(),
-            text: await clone.text(),
-        };
-    }
-    catch {
-        return {
-            success: isSuccessful,
-            status: res.status,
-            data: null,
-            text: await clone.text(),
-        };
-    }
-}
-exports.Request = Request;
-/**
- * Ensures that the path starts with a /
- * @param path Path string
- * @returns Path that starts with a /
- */
-function ensureSlash(path) {
-    return path.startsWith('/') ? path : '/' + path;
-}
-exports.ensureSlash = ensureSlash;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureSlash = exports.Request = void 0;
+/**
+ * Makes a request to the API
+ * @param path Api endpoint to request
+ * @param options Additional options for the request
+ * @returns The response from the API
+ */
+async function Request(path, 
+// Destructor the options object, if it's undefined then set it to an empty object
+{ method = 'GET', body, noHeaders = false, controller = new AbortController(), query, baseEndpoint } = {}, log = false) {
+    // console.log(`Requesting ${path} with method ${method}`);
+    // Construct the endpoint for the request
+    const endpoint = (() => {
+        const result = baseEndpoint + ensureSlash(path);
+        if (path.includes('?') || !query)
+            return result;
+        // If the query object is defined, then construct a query string from it
+        const queryString = Object.entries(query)
+            .map(([key, value]) => value ? `${key}=${value}` : '')
+            .join('&');
+        return path.includes('?') ? `${result}&${queryString}` : `${result}?${queryString}`;
+    })();
+    // Construct the request init object to pass to the fetch function
+    const init = {
+        method,
+        body: body ? !noHeaders ? JSON.stringify(body) : body : undefined,
+        headers: !noHeaders ? { 'Content-Type': 'application/json' } : undefined,
+        signal: controller.signal,
+        credentials: 'include',
+        mode: 'cors'
+    };
+    // Make the request, log any errors, and throw them again
+    const res = await fetch(endpoint, init).catch(err => {
+        console.error(`Failed to [${method}] ${path}`, err);
+        throw err;
+    });
+    if (log)
+        console.log(`[${method}] ${path} responded with ${res.status}`, res);
+    // Clone the response so that it can be converted to JSON and text
+    const clone = res.clone();
+    // All successful responses are in the 200s, so check if the status code starts with 2
+    const isSuccessful = res.status.toString().startsWith('2');
+    // This try-catch block is used to catch any errors when converting the response to JSON
+    // If the response is not jsonable, then the catch will return null for the data
+    try {
+        return {
+            success: isSuccessful,
+            status: res.status,
+            data: await res.json(),
+            text: await clone.text(),
+        };
+    }
+    catch {
+        return {
+            success: isSuccessful,
+            status: res.status,
+            data: null,
+            text: await clone.text(),
+        };
+    }
+}
+exports.Request = Request;
+/**
+ * Ensures that the path starts with a /
+ * @param path Path string
+ * @returns Path that starts with a /
+ */
+function ensureSlash(path) {
+    return path.startsWith('/') ? path : '/' + path;
+}
+exports.ensureSlash = ensureSlash;

package/dist/Utils/{ApiUtil → ApiUtils}/index.d.ts

@@ -1,20 +1,20 @@
-import { ApiUtilOptions, RequestOptions } from "./ApiTypes";
-export declare class ApiUtil<ApiEndpoints extends string> {
-    protected __baseEndpointDev: string;
-    protected __baseEndpoint?: string;
-    protected __log: boolean;
-    constructor({ baseEndpointDev, baseEndpoint, log }: ApiUtilOptions);
-    /**
-     * Make a request to the API
-     * @param path The path to the endpoint
-     * @param options The options for the request
-     * @returns The response from the API
-     */
-    request<TData>(path: ApiEndpoints, options?: RequestOptions): Promise<{
-        success: boolean;
-        status: number;
-        data: TData;
-        text: string;
-    }>;
-    get baseEndpoint(): string;
-}
+import { ApiUtilOptions, RequestOptions } from "./ApiTypes";
+export declare class ApiUtils<ApiEndpoints extends string> {
+    protected __baseEndpointDev: string;
+    protected __baseEndpoint?: string;
+    protected __log: boolean;
+    constructor({ baseEndpointDev, baseEndpoint, log }: ApiUtilOptions);
+    /**
+     * Make a request to the API
+     * @param path The path to the endpoint
+     * @param options The options for the request
+     * @returns The response from the API
+     */
+    request<TData>(path: ApiEndpoints, options?: RequestOptions): Promise<{
+        success: boolean;
+        status: number;
+        data: TData;
+        text: string;
+    }>;
+    get baseEndpoint(): string;
+}

package/dist/Utils/{ApiUtil → ApiUtils}/index.js

@@ -1,33 +1,33 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ApiUtil = void 0;
-const RequestUtil_1 = require("./RequestUtil");
-class ApiUtil {
-    __baseEndpointDev;
-    __baseEndpoint;
-    __log;
-    constructor({ baseEndpointDev, baseEndpoint, log }) {
-        this.__baseEndpointDev = baseEndpointDev;
-        this.__baseEndpoint = baseEndpoint;
-        this.__log = log ?? false;
-    }
-    /**
-     * Make a request to the API
-     * @param path The path to the endpoint
-     * @param options The options for the request
-     * @returns The response from the API
-     */
-    async request(path, options) {
-        return (0, RequestUtil_1.Request)(path, {
-            ...options,
-            baseEndpoint: this.baseEndpoint
-        }, this.__log);
-    }
-    get baseEndpoint() {
-        const processExists = 'process' in globalThis;
-        // @ts-ignore -- process is not defined in the browser
-        const isDev = processExists && process.env.NODE_ENV === 'development';
-        return isDev ? this.__baseEndpointDev : this.__baseEndpoint ?? this.__baseEndpointDev;
-    }
-}
-exports.ApiUtil = ApiUtil;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApiUtils = void 0;
+const RequestUtil_1 = require("./RequestUtil");
+class ApiUtils {
+    __baseEndpointDev;
+    __baseEndpoint;
+    __log;
+    constructor({ baseEndpointDev, baseEndpoint, log }) {
+        this.__baseEndpointDev = baseEndpointDev;
+        this.__baseEndpoint = baseEndpoint;
+        this.__log = log ?? false;
+    }
+    /**
+     * Make a request to the API
+     * @param path The path to the endpoint
+     * @param options The options for the request
+     * @returns The response from the API
+     */
+    async request(path, options) {
+        return (0, RequestUtil_1.Request)(path, {
+            ...options,
+            baseEndpoint: this.baseEndpoint
+        }, this.__log);
+    }
+    get baseEndpoint() {
+        const processExists = 'process' in globalThis;
+        // @ts-ignore -- process is not defined in the browser
+        const isDev = processExists && process.env.NODE_ENV === 'development';
+        return isDev ? this.__baseEndpointDev : this.__baseEndpoint ?? this.__baseEndpointDev;
+    }
+}
+exports.ApiUtils = ApiUtils;

package/dist/Utils/ColorUtils.d.ts

@@ -0,0 +1,11 @@
+export type RGB = [number, number, number];
+export type Hex = `#${string}`;
+export type ColorType = 'hex' | 'rgb' | 'hsl';
+export declare function convert(value: RGB, to: Exclude<ColorType, 'rgb'>): string;
+export declare function convert(value: string, from: Exclude<ColorType, 'rgb'>, to: 'rgb'): RGB;
+export declare function generateRandomColor(): Hex;
+export declare const ColorUtils: {
+    convert: typeof convert;
+    generateRandomColor: typeof generateRandomColor;
+};
+export default ColorUtils;

package/dist/Utils/ColorUtils.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ColorUtils = exports.generateRandomColor = exports.convert = void 0;
+function convert(value, fromOrTo, to) {
+    const from = typeof value === 'string' ? fromOrTo : 'rgb';
+    const target = typeof value === 'string' ? to : fromOrTo;
+    if (from === target)
+        return value;
+    switch (from) {
+        case 'hsl': {
+            switch (target) {
+                case 'hex': return hslToHex(value);
+                case 'rgb': return hexToRgb(hslToHex(value));
+            }
+        }
+        case 'rgb': {
+            switch (target) {
+                case 'hex': return hslToHex(rgbToHsl(value));
+                case 'hsl': return rgbToHsl(value);
+            }
+        }
+        case 'hex': {
+            switch (target) {
+                case 'rgb': return hexToRgb(value);
+                case 'hsl': return rgbToHsl(hexToRgb(value));
+            }
+        }
+        default: return value;
+    }
+}
+exports.convert = convert;
+function generateRandomColor() {
+    return `#${Math.floor(Math.random() * 16777215).toString(16).padStart(6, '0')}`;
+}
+exports.generateRandomColor = generateRandomColor;
+exports.ColorUtils = {
+    convert,
+    generateRandomColor
+};
+exports.default = exports.ColorUtils;
+function hslToHex(value) {
+    if (!value)
+        return "#000000";
+    const match = value.match(/hsl\((\d+), (\d+)%, (\d+)%\)/);
+    if (!match)
+        return value;
+    let [_, h, s, l] = match.map(Number);
+    l /= 100;
+    const a = s * Math.min(l, 1 - l) / 100;
+    const format = (value) => {
+        const k = (value + h / 30) % 12;
+        const color = l - a * Math.max(Math.min(k - 3, 9 - k, 1), -1);
+        return Math.round(255 * color).toString(16).padStart(2, '0');
+    };
+    return `#${format(0)}${format(8)}${format(4)}`;
+}
+function hexToRgb(hex) {
+    if (!hex)
+        return [0, 0, 0];
+    const match = hex.match(/[a-f0-9]{6}|[a-f0-9]{3}/i);
+    if (!match)
+        return [0, 0, 0];
+    let colorString = match[0];
+    if (match[0].length === 3)
+        colorString = colorString.split('').map(char => char + char).join('');
+    const integer = parseInt(colorString, 16);
+    const r = (integer >> 16) & 0xFF;
+    const g = (integer >> 8) & 0xFF;
+    const b = integer & 0xFF;
+    return [r, g, b];
+}
+function rgbToHsl(rgb) {
+    let [r, g, b] = rgb.map(x => x / 255);
+    const max = Math.max(r, g, b), min = Math.min(r, g, b);
+    let h = 0, s = 0, l = (max + min) / 2;
+    if (max !== min) {
+        const d = max - min;
+        s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
+        switch (max) {
+            case r:
+                h = (g - b) / d + (g < b ? 6 : 0);
+                break;
+            case g:
+                h = (b - r) / d + 2;
+                break;
+            case b:
+                h = (r - g) / d + 4;
+                break;
+        }
+        h /= 6;
+    }
+    return `hsl(${Math.round(h * 360)}, ${Math.round(s * 100)}%, ${Math.round(l * 100)}%)`;
+}

package/dist/Utils/{FormUtil.d.ts → FormUtils.d.ts}

@@ -1,6 +1,6 @@
-/**
- * Serialize a form into an object
- * @param form The form to serialize
- * @returns An object of type T from the form
- */
-export declare function serializeForm<T extends object>(form: HTMLFormElement, log?: boolean): T;
+/**
+ * Serialize a form into an object
+ * @param form The form to serialize
+ * @returns An object of type T from the form
+ */
+export declare function serializeForm<T extends object>(form: HTMLFormElement, log?: boolean): T;