Compiled the library to .js + separate .d.ts declaration files

bin/build.js

@@ -0,0 +1,26 @@
+// Import ESBuild
+import esbuild from 'esbuild';
+import dotenv from 'dotenv';
+
+dotenv.config({ path: '.env' });
+
+const production = process.env.NODE_ENV === 'production';
+
+/**
+ * Default Settings
+ * @type {esbuild.BuildOptions}
+ */
+const defaultSettings = {
+  bundle: true,
+  minify: production,
+  sourcemap: false,
+  outdir: production ? 'dist' : process.env.CUSTOM_BUILD_DIRECTORY || '',
+  target: production ? 'es6' : 'esnext',
+};
+
+// Files building
+esbuild.buildSync({
+  ...defaultSettings,
+  entryPoints: ['src/index.ts'],
+  format: 'esm',
+});

dist/types/animations/fade.d.ts

@@ -0,0 +1,2 @@
+export declare const fadeIn: (element: HTMLElement, display?: string) => Promise<void>;
+export declare const fadeOut: (element: HTMLElement) => Promise<void>;

dist/types/components/CopyJSONButton.d.ts

@@ -0,0 +1,27 @@
+export declare class CopyJSONButton {
+    private readonly element;
+    private readonly hiddenTrigger;
+    private readonly successCSSClass?;
+    private readonly textNode;
+    private copyData;
+    private successText;
+    private errorText;
+    private notificationDuration;
+    private notificationActive;
+    private originalText;
+    constructor({ element, copyData, successText, errorText, notificationDuration, successCSSClass, }: {
+        element: HTMLElement;
+        copyData: Record<string, unknown>;
+        successText?: string;
+        errorText?: string;
+        notificationDuration?: number;
+        successCSSClass?: string;
+    });
+    private init;
+    private createHiddenTrigger;
+    private handleClick;
+    private handleCopy;
+    private triggerNotification;
+    updateCopyData(newCopyData: Record<string, unknown>): void;
+    updateTextContent(newText: string): void;
+}

dist/types/components/Debug.d.ts

@@ -0,0 +1,6 @@
+export declare class Debug {
+    private static alertsActivated;
+    static activateAlerts(): void;
+    static alert(text: string, type: 'info'): void;
+    static alert<T>(text: string, type: 'error'): T;
+}

dist/types/components/DisplayController.d.ts

@@ -0,0 +1,20 @@
+import type { InteractionParams } from './Interaction';
+export interface DisplayControllerParams {
+    element: HTMLElement | string;
+    interaction?: InteractionParams;
+    displayProperty?: typeof DisplayController['displayProperties'][number];
+    noTransition?: boolean;
+    startsHidden?: boolean;
+}
+export declare class DisplayController {
+    private readonly interaction;
+    private readonly noTransition;
+    private readonly displayProperty;
+    private visible;
+    readonly element: HTMLElement;
+    static readonly displayProperties: readonly ["block", "flex", "grid", "inline-block", "inline"];
+    constructor({ element, interaction, displayProperty, noTransition, startsHidden }: DisplayControllerParams);
+    isVisible: () => boolean;
+    show(): Promise<void>;
+    hide(): Promise<void>;
+}

dist/types/components/Interaction.d.ts

@@ -0,0 +1,19 @@
+export interface InteractionParams {
+    element: HTMLElement | string;
+    duration?: number | Partial<Interaction['duration']>;
+}
+export declare class Interaction {
+    private readonly element;
+    private active;
+    private running;
+    private runningPromise?;
+    readonly duration: {
+        first: number;
+        second: number;
+    };
+    constructor({ element, duration }: InteractionParams);
+    trigger(click?: 'first' | 'second'): Promise<boolean>;
+    isActive: () => boolean;
+    isRunning: () => boolean;
+    untilFinished: () => Promise<unknown> | undefined;
+}

dist/types/components/WritableStore.d.ts

@@ -0,0 +1,9 @@
+export declare class WritableStore<T> {
+    private value;
+    private subscribeCallbacks;
+    constructor(value: T);
+    get(): T;
+    set(newValue: T): void;
+    update(callback: (value: T) => T): void;
+    subscribe(callback: (value: T) => void): () => void;
+}

dist/types/helpers/clearFormField.d.ts

@@ -0,0 +1,3 @@
+import { simulateEvent } from './simulateEvent';
+import type { FormField } from '../types';
+export declare const clearFormField: (field: FormField, omitEvents?: Parameters<typeof simulateEvent>['1']) => void;

dist/types/helpers/cloneNode.d.ts

@@ -0,0 +1 @@
+export declare const cloneNode: <T extends Node>(node: T, deep?: boolean) => T;

dist/types/helpers/extractCommaSeparatedValues.d.ts

@@ -0,0 +1,2 @@
+export declare function extractCommaSeparatedValues(string: string | null | undefined, compareSource?: undefined, defaultValue?: undefined, filterEmpty?: boolean): string[];
+export declare function extractCommaSeparatedValues<SourceKey extends string, DefaultKey extends SourceKey>(string: string | null | undefined, compareSource: readonly SourceKey[], defaultValue?: DefaultKey | undefined, filterEmpty?: boolean): SourceKey[];

dist/types/helpers/extractNumberSuffix.d.ts

@@ -0,0 +1 @@
+export declare const extractNumberSuffix: (string: string) => number | undefined;

dist/types/helpers/findTextNode.d.ts

@@ -0,0 +1 @@
+export declare const findTextNode: (element: HTMLElement) => ChildNode | undefined;

dist/types/helpers/getAllParents.d.ts

@@ -0,0 +1 @@
+export declare const getAllParents: (element: Element) => HTMLElement[];

dist/types/helpers/getDistanceFromTop.d.ts

@@ -0,0 +1 @@
+export declare const getDistanceFromTop: (element: Element) => number;

dist/types/helpers/getFormFieldValue.d.ts

@@ -0,0 +1,2 @@
+import type { FormField } from '../types/FormField';
+export declare const getFormFieldValue: (input: FormField) => string;

dist/types/helpers/getHiddenParent.d.ts

@@ -0,0 +1 @@
+export declare const getHiddenParent: (element: HTMLElement) => HTMLElement | undefined;

dist/types/helpers/getObjectEntries.d.ts

@@ -0,0 +1,2 @@
+import type { Entry } from '../types/Entry';
+export declare const getObjectEntries: <T extends Readonly<Record<string, unknown>>>(object: T) => Entry<T>[];

dist/types/helpers/getObjectKeys.d.ts

@@ -0,0 +1 @@
+export declare const getObjectKeys: <T extends Record<string, unknown>>(object: T) => (keyof T)[];

dist/types/helpers/isScrollable.d.ts

@@ -0,0 +1 @@
+export declare const isScrollable: (element: Element) => boolean;

dist/types/helpers/isVisible.d.ts

@@ -0,0 +1 @@
+export declare const isVisible: (element: HTMLElement) => boolean;

dist/types/helpers/queryElement.d.ts

@@ -0,0 +1,2 @@
+import type { Instance } from '../types/Instance';
+export declare const queryElement: <T extends Element>(selector: string, instance: Instance<T>, scope?: ParentNode) => T | undefined;

dist/types/helpers/removeChildElements.d.ts

@@ -0,0 +1 @@
+export declare const removeChildElements: (element: Element, selector?: string | undefined) => void;

dist/types/helpers/removeSpaces.d.ts

@@ -0,0 +1 @@
+export declare const removeSpaces: (string: string) => string;

dist/types/helpers/removeTrailingSlash.d.ts

@@ -0,0 +1 @@
+export declare const removeTrailingSlash: (value: string) => string;

dist/types/helpers/sameValues.d.ts

@@ -0,0 +1 @@
+export declare const sameValues: (array1: unknown[], array2: unknown[]) => boolean;

dist/types/helpers/selectInputElement.d.ts

@@ -0,0 +1 @@
+export declare const selectInputElement: (element: HTMLInputElement, select?: boolean) => string | boolean;

dist/types/helpers/setFormFieldValue.d.ts

@@ -0,0 +1,2 @@
+import type { FormField } from '..';
+export declare const setFormFieldValue: (element: FormField, value: string | boolean) => void;

dist/types/helpers/simulateEvent.d.ts

@@ -0,0 +1 @@
+export declare const simulateEvent: (target: EventTarget, events: keyof DocumentEventMap | Array<keyof DocumentEventMap>) => boolean;

dist/types/helpers/throwError.d.ts

@@ -0,0 +1 @@
+export declare const throwError: <T>(message: string) => T;

dist/types/helpers/wait.d.ts

@@ -0,0 +1 @@
+export declare const wait: (time: number) => Promise<unknown>;

dist/types/type-guards/isFormField.d.ts

@@ -0,0 +1,2 @@
+import type { FormField } from '../types/FormField';
+export declare const isFormField: (element: Element | EventTarget | null) => element is FormField;

dist/types/type-guards/isKeyOf.d.ts

@@ -0,0 +1 @@
+export declare const isKeyOf: <T extends string>(key: string | null | undefined, source: readonly T[]) => key is T;

dist/types/type-guards/isNotEmpty.d.ts

@@ -0,0 +1 @@
+export declare const isNotEmpty: <T>(value: T | null | undefined) => value is T;

dist/types/types/Entry.d.ts

@@ -0,0 +1,3 @@
+export declare type Entry<T> = {
+    [K in keyof T]: [K, T[K]];
+}[keyof T];

dist/types/types/FormField.d.ts

@@ -0,0 +1 @@
+export declare type FormField = HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement;

dist/types/types/Instance.d.ts

@@ -0,0 +1,4 @@
+export declare type Instance<T> = {
+    new (): T;
+    prototype: T;
+};

dist/types/types/MapEntries.d.ts

@@ -0,0 +1 @@
+export declare type MapEntries<MapToConvert> = MapToConvert extends Map<infer Key, infer Value> ? [Key, Value][] : never;

dist/types/types/PartialExcept.d.ts

@@ -0,0 +1 @@
+export declare type PartialExcept<Original, Keys extends keyof Original> = Partial<Omit<Original, Keys>> & Required<Pick<Original, Keys>>;

dist/types/types/PickPartial.d.ts

@@ -0,0 +1 @@
+export declare type PickPartial<Original, Keys extends keyof Original> = Omit<Original, Keys> & Partial<Pick<Original, Keys>>;

dist/types/types/PickRequired.d.ts

@@ -0,0 +1 @@
+export declare type PickRequired<Original, Keys extends keyof Original> = Omit<Original, Keys> & Required<Pick<Original, Keys>>;

dist/types/types/RequiredExcept.d.ts

@@ -0,0 +1 @@
+export declare type RequiredExcept<Original, Keys extends keyof Original> = Required<Omit<Original, Keys>> & Partial<Pick<Original, Keys>>;

dist/types/types/UnionToIntersection.d.ts

@@ -0,0 +1 @@
+export declare type UnionToIntersection<Union> = (Union extends unknown ? (k: Union) => void : never) extends (k: infer Intersection) => void ? Intersection : never;