@aegis-framework/artemis 0.4.1 → 0.5.0

package/dist/types/Debug.d.ts

@@ -20,6 +20,10 @@ export declare enum DebugLevel {
  */
 export declare class Debug {
     private static _level;
+    /**
+     * Get the current debug level
+     */
+    static get currentLevel(): DebugLevel;
     /**
      * Set or get the log level
      *
@@ -27,6 +31,18 @@ export declare class Debug {
      * @returns The current debug level
      */
     static level(level?: DebugLevel): DebugLevel;
+    /**
+     * Set the debug level
+     *
+     * @param level - The debug level to set
+     */
+    static setLevel(level: DebugLevel): void;
+    /**
+     * Check if a specific level is enabled
+     *
+     * @param level - The level to check
+     */
+    static isEnabled(level: DebugLevel): boolean;
     /**
      * Log the given elements.
      * Logs will only be made if the level is set to DEBUG or above
@@ -62,13 +78,20 @@ export declare class Debug {
      * @param args - Arguments to log
      */
     static warning(...args: unknown[]): void;
+    /**
+     * Alias for warning()
+     *
+     * @param args - Arguments to log
+     */
+    static warn(...args: unknown[]): void;
     /**
      * Show data as a table
      * Table will only be made if the level is set to DEBUG or above
      *
-     * @param args - Arguments to display as table
+     * @param data - Data to display as table
+     * @param columns - Optional column names to include
      */
-    static table(...args: unknown[]): void;
+    static table(data: unknown, columns?: string[]): void;
     /**
      * Start an indented group
      *
@@ -114,5 +137,53 @@ export declare class Debug {
      * @param args - Arguments to log with trace
      */
     static trace(...args: unknown[]): void;
+    /**
+     * Log a message if a condition is false
+     * Only logs if the level is set to ERROR or above
+     *
+     * @param condition - Condition to check
+     * @param args - Arguments to log if condition is false
+     */
+    static assert(condition: boolean, ...args: unknown[]): void;
+    /**
+     * Clear the console
+     * Only clears if the level is set to DEBUG or above
+     */
+    static clear(): void;
+    /**
+     * Increment a counter with the given label
+     * Only counts if the level is set to DEBUG or above
+     *
+     * @param label - Counter label
+     */
+    static count(label?: string): void;
+    /**
+     * Reset a counter with the given label
+     * Only resets if the level is set to DEBUG or above
+     *
+     * @param label - Counter label
+     */
+    static countReset(label?: string): void;
+    /**
+     * Display an interactive listing of the properties of an object
+     * Only displays if the level is set to DEBUG or above
+     *
+     * @param data - Object to display
+     */
+    static dir(data: unknown): void;
+    /**
+     * Display XML/HTML element representation
+     * Only displays if the level is set to DEBUG or above
+     *
+     * @param data - Element to display
+     */
+    static dirxml(data: unknown): void;
+    /**
+     * Create a formatted string with substitution values
+     *
+     * @param format - Format string
+     * @param args - Substitution values
+     */
+    static format(format: string, ...args: unknown[]): string;
 }
 //# sourceMappingURL=Debug.d.ts.map

package/dist/types/Debug.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Debug.d.ts","sourceRoot":"","sources":["../../src/Debug.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH;;GAEG;AACH,oBAAY,UAAU;IACrB,IAAI,IAAI;IACR,KAAK,IAAI;IACT,OAAO,IAAI;IACX,IAAI,IAAI;IACR,KAAK,IAAI;IACT,GAAG,IAAI;CACP;AAED;;;GAGG;AACH,qBAAa,KAAK;IACjB,OAAO,CAAC,MAAM,CAAC,MAAM,CAA+B;IAEpD;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,UAAU;IAO5C;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAMpC;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAMtC;;;;;OAKG;IACH,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAMrC;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAMtC;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAMxC;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAMtC;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAMtC;;;;OAIG;IACH,MAAM,CAAC,cAAc,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM/C;;OAEG;IACH,MAAM,CAAC,QAAQ,IAAI,IAAI;IAMvB;;;;;OAKG;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAMjC;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAMxD;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAMpC;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;CAKtC"}
+{"version":3,"file":"Debug.d.ts","sourceRoot":"","sources":["../../src/Debug.ts"],"names":[],"mappings":"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"}

package/dist/types/FileSystem.d.ts

@@ -4,66 +4,83 @@
  * ==============================
  */
 import { RequestOptions } from './Request';
+export type FileReadType = 'text' | 'base64' | 'buffer' | 'binary';
 /**
- * File read type options
- */
-export type FileReadType = 'text' | 'base64' | 'buffer';
-/**
- * File read result type based on read type
+ * Return type mapping for file read operations
  */
 export interface FileReadResult {
-    event: ProgressEvent<FileReader>;
-    content: string | ArrayBuffer | null;
+    text: string;
+    base64: string;
+    buffer: ArrayBuffer;
+    binary: string;
 }
 /**
- * A simple class wrapper for the File and FileReader web API, while this class
- * doesn't actually provide access to the host file system, it does provide useful
- * utilities for form file inputs and remote content loading.
+ * A utility wrapper for File/Blob operations
  */
 export declare class FileSystem {
     /**
-     * Read a file from a remote location given a URL. This function will fetch
-     * the file blob using the Request class and then use the read() function
-     * to read the blob in the format required.
+     * Read a file from a remote URL.
      *
-     * @param url - URL to fetch the file from
-     * @param type - Type of data to be read, values can be 'text', 'base64' and 'buffer'
-     * @param props - Props to send to the Request object
-     * @returns Content of the file. The format depends on the type parameter used.
+     * @param url - The URL to fetch
+     * @param type - The format to return ('text', 'base64', 'buffer', 'binary')
+     * @param options - Request options
      */
-    static readRemote(url: string, type?: FileReadType, props?: RequestOptions): Promise<FileReadResult>;
+    static readRemote<T extends FileReadType>(url: string, type?: T, options?: RequestOptions): Promise<FileReadResult[T]>;
     /**
-     * Read a given File or Blob object.
+     * Read a local File or Blob.
      *
-     * @param file - File to read
-     * @param type - Type of data to be read, values can be 'text', 'base64' and 'buffer'
-     * @returns Promise that resolves to the load event and content of the file
+     * @param file - The File or Blob to read
+     * @param type - The format to return
      */
-    static read(file: File | Blob, type?: FileReadType): Promise<FileReadResult>;
+    static read<T extends FileReadType>(file: File | Blob, type?: T): Promise<FileReadResult[T]>;
     /**
-     * Create a new File, this uses the File API and will not actually create
-     * a file in the user's file system, however using it with other features,
-     * that may be possible
+     * Create a File object.
+     * This is a synchronous operation.
      *
-     * @param name - Name of the file (Including extension)
-     * @param content - Content to save in the file
-     * @param type - Mime Type for the file
-     * @returns Promise resolving to the created File
+     * @param name - Filename
+     * @param content - Data (String, Blob, ArrayBuffer)
+     * @param mimeType - MIME type (e.g. 'application/json')
      */
-    static create(name: string, content: BlobPart, type?: string): Promise<File>;
+    static create(name: string, content: BlobPart, mimeType?: string): File;
     /**
-     * Returns the extension of a file given its file name.
+     * Trigger a browser download for a specific File or Blob.
+     * This will creates a temporary anchor tag to force the download.
      *
-     * @param name - Name or full path of the file
-     * @returns File extension without the leading dot (.)
+     * @param file - The file to download
+     * @param name - Optional rename for the downloaded file
      */
-    static extension(name: string): string;
+    static download(file: File | Blob, name?: string): void;
     /**
-     * Check if a file is an image by its extension.
+     * Get the file extension safely
      *
-     * @param name - Name or full path of the file
-     * @returns Whether the file is an image
+     * @param name - Filename or path
+     * @returns Lowercase extension without the dot, or empty string
+     */
+    static extension(name: string, allowHiddenFiles?: boolean): string;
+    /**
+     * Check if a file is an image based on extension.
+     *
+     * @param name - Filename to check
      */
     static isImage(name: string): boolean;
+    /**
+     * Check if a file is a video based on extension.
+     *
+     * @param name - Filename to check
+     */
+    static isVideo(name: string): boolean;
+    /**
+     * Check if a file is audio based on extension.
+     *
+     * @param name - Filename to check
+     */
+    static isAudio(name: string): boolean;
+    /**
+     * Convert bytes to human-readable size.
+     *
+     * @param bytes - Size in bytes
+     * @param decimals - Number of decimal places
+     */
+    static humanSize(bytes: number, decimals?: number): string;
 }
 //# sourceMappingURL=FileSystem.d.ts.map

package/dist/types/FileSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FileSystem.d.ts","sourceRoot":"","sources":["../../src/FileSystem.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAW,cAAc,EAAE,MAAM,WAAW,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IACjC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;CACrC;AAED;;;;GAIG;AACH,qBAAa,UAAU;IACtB;;;;;;;;;OASG;IACH,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,YAAuB,EAAE,KAAK,GAAE,cAAmB,GAAG,OAAO,CAAC,cAAc,CAAC;IAMlH;;;;;;OAMG;IACH,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,IAAI,GAAE,YAAqB,GAAG,OAAO,CAAC,cAAc,CAAC;IA0BpF;;;;;;;;;OASG;IACH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,GAAE,MAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1F;;;;;OAKG;IACH,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAItC;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAIrC"}
+{"version":3,"file":"FileSystem.d.ts","sourceRoot":"","sources":["../../src/FileSystem.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAW,cAAc,EAAE,MAAM,WAAW,CAAC;AAEpD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,qBAAa,UAAU;IAErB;;;;;;OAMG;WACU,UAAU,CAAC,CAAC,SAAS,YAAY,EAC5C,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,CAAiB,EACvB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAK7B;;;;;OAKG;WACU,IAAI,CAAC,CAAC,SAAS,YAAY,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,IAAI,GAAE,CAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAwC/G;;;;;;;OAOG;IACH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAE,MAAqB,GAAG,IAAI;IAIrF;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAyBvD;;;;;OAKG;IACH,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,GAAE,OAAe,GAAG,MAAM;IAWzE;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IASrC;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQrC;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQrC;;;;;OAKG;IACH,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,GAAG,MAAM;CAS9D"}

package/dist/types/Form.d.ts

@@ -3,30 +3,55 @@
  * Form
  * ==============================
  */
+export type FormValue = string | number | boolean | File | null;
+export type FormValues = Record<string, FormValue | FormValue[]>;
 /**
- * Form data object type
- */
-export type FormData = Record<string, string | File | FileList | undefined>;
-/**
- * Utility class that provides simple functions for filling and retrieving values
- * from forms. This class requires the use of the `data-form` attribute.
+ * Options for parsing form values
  */
+export interface FormParseOptions {
+    parseNumbers?: boolean;
+    parseBooleans?: boolean;
+}
 export declare class Form {
     /**
-     * Fill a form's inputs with the given values. Each key in the provided object
-     * must match the `name` attribute of the input to fill.
+     * Fill a form with data.
+     *
+     * @param formName - The data-form attribute value
+     * @param data - Key-value pairs to fill
+     */
+    static fill(formName: string, data: Record<string, unknown>): void;
+    /**
+     * Get all values from a form.
+     *
+     * @param formName - The data-form attribute value
+     * @param options - Parsing options
+     * @returns Form values as a record
+     */
+    static values(formName: string, options?: FormParseOptions): FormValues;
+    /**
+     * Parse a string value, optionally converting to number.
+     *
+     * @param value - String value to parse
+     * @param parseNumbers - Whether to parse numeric strings
+     */
+    private static parseValue;
+    /**
+     * Reset a form to its initial state.
+     *
+     * @param formName - The data-form attribute value
+     */
+    static reset(formName: string): void;
+    /**
+     * Check if a form is valid according to HTML5 validation.
      *
-     * @param name - Form name. Must match the `data-form` attribute of the Form.
-     * @param data - JSON object with key-value pairs to fill the inputs.
+     * @param formName - The data-form attribute value
      */
-    static fill(name: string, data: Record<string, string>): void;
+    static isValid(formName: string): boolean;
     /**
-     * Get all the values from a form's inputs. The keys are mapped using the
-     * `name` attribute of each input.
+     * Report validity and show browser validation messages.
      *
-     * @param name - Form name. Must match the `data-form` attribute of the Form.
-     * @returns Key-value JSON object
+     * @param formName - The data-form attribute value
      */
-    static values(name: string): FormData;
+    static reportValidity(formName: string): boolean;
 }
 //# sourceMappingURL=Form.d.ts.map

package/dist/types/Form.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Form.d.ts","sourceRoot":"","sources":["../../src/Form.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,QAAQ,GAAG,SAAS,CAAC,CAAC;AAE5E;;;GAGG;AACH,qBAAa,IAAI;IAChB;;;;;;OAMG;IACH,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAkB7D;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;CAwBrC"}
+{"version":3,"file":"Form.d.ts","sourceRoot":"","sources":["../../src/Form.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,IAAI,CAAC;AAChE,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,EAAE,CAAC,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,qBAAa,IAAI;IAEf;;;;;OAKG;IACH,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAoDlE;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,UAAU;IAiE3E;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,UAAU;IAOzB;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAWpC;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAWzC;;;;OAIG;IACH,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAUjD"}

package/dist/types/Platform.d.ts

@@ -3,91 +3,90 @@
  * Platform
  * ==============================
  */
-/**
- * Desktop platform types
- */
-export type DesktopPlatform = 'Windows' | 'macOS' | 'Linux' | 'FreeBSD' | 'webOS' | 'Any';
-/**
- * Mobile platform types
- */
-export type MobilePlatform = 'Android' | 'iOS' | 'Opera' | 'Windows' | 'BlackBerry' | 'Any';
-/**
- * Orientation types
- */
+export type DesktopPlatform = 'Windows' | 'macOS' | 'Linux' | 'FreeBSD' | 'Any' | 'ChromeOS';
+export type MobilePlatform = 'Android' | 'iOS' | 'iPadOS' | 'WindowsMobile' | 'BlackBerry' | 'Any';
 export type Orientation = 'portrait' | 'landscape';
-/**
- * Extended Navigator interface for userAgentData
- */
-interface NavigatorUAData {
-    platform?: string;
-    brands?: {
-        brand: string;
-        version: string;
-    }[];
-    mobile?: boolean;
-}
-declare global {
-    interface Navigator {
-        userAgentData?: NavigatorUAData;
-    }
-}
-/**
- * General checks for what kind of platform is being used to run the app.
- */
 export declare class Platform {
     /**
-     * Check if the screen has a retina pixel ratio
-     * @returns Whether the screen is retina
+     * Check if the screen has a high pixel density (Retina)
      */
-    static retina(): boolean;
+    static get retina(): boolean;
     /**
-     * Check if the device is on portrait orientation
-     * @returns Whether device is in portrait mode
+     * Check if the device is in portrait orientation.
+     * Uses matchMedia to align perfectly with CSS media queries.
      */
-    static portrait(): boolean;
+    static get portrait(): boolean;
     /**
-     * Check if the device is on landscape orientation
-     * @returns Whether device is in landscape mode
+     * Check if the device is in landscape orientation.
      */
-    static landscape(): boolean;
+    static get landscape(): boolean;
     /**
-     * Get device Orientation
-     * @returns 'portrait' or 'landscape'
+     * Get current device orientation as a string.
      */
-    static orientation(): Orientation;
+    static get orientation(): Orientation;
     /**
-     * Check if the app is running over Electron
-     * @returns Whether running in Electron
+     * Check if the user prefers Dark Mode
      */
-    static electron(): boolean;
+    static get darkMode(): boolean;
     /**
-     * Check if the app is running over Cordova
-     * @returns Whether running in Cordova
+     * Check if the user prefers reduced motion
      */
-    static cordova(): boolean;
+    static get reducedMotion(): boolean;
     /**
-     * Get the platform string using modern userAgentData API with fallback
-     * @returns Platform string
+     * Check if the device supports touch events.
+     * Useful for distinguishing hybrid laptops from tablets.
      */
-    private static getPlatformString;
+    static get touch(): boolean;
     /**
-     * Check if the app is running in a desktop platform
-     * @param platform - Check for a specific desktop platform
-     * @returns Whether running on specified desktop platform
+     * Check if the app is running in "Standalone" mode (Installed PWA).
      */
-    static desktop(platform?: DesktopPlatform): boolean;
+    static get standalone(): boolean;
     /**
-     * Check if the app is running in a mobile platform
-     * @param platform - Check for a specific mobile platform
-     * @returns Whether running on specified mobile platform
+     * Check if the app is running inside Electron.
+     * Checks both Renderer process and Main process contexts.
      */
-    static mobile(platform?: MobilePlatform): boolean;
+    static get electron(): boolean;
     /**
-     * Check if the platform allows the use of service workers
+     * Check if the app is running inside Cordova / PhoneGap.
+     */
+    static get cordova(): boolean;
+    /**
+     * Internal helper to normalize platform detection
+     */
+    private static get userAgent();
+    /**
+     * Check if the app is running on a Desktop platform.
+     *
+     * @param os - Specific desktop OS to check for, or 'Any' for any desktop
+     */
+    static desktop(os?: DesktopPlatform): boolean;
+    /**
+     * Check if the app is running on a Mobile platform.
      *
-     * @returns Whether service workers are supported
+     * @param os - Specific mobile OS to check for, or 'Any' for any mobile
+     */
+    static mobile(os?: MobilePlatform): boolean;
+    /**
+     * Detect iPadOS explicitly.
+     * Modern iPads send a "Macintosh" User Agent, but have Touch Points.
+     */
+    private static isIpadOS;
+    /**
+     * Check if the platform supports Service Workers.
+     * Uses `isSecureContext` to accurately allow localhost/HTTPS.
+     */
+    static get serviceWorkers(): boolean;
+    /**
+     * Check if the device has a coarse pointer (touch) as primary input.
+     */
+    static get coarsePointer(): boolean;
+    /**
+     * Check if the device has a fine pointer (mouse) as primary input.
+     */
+    static get finePointer(): boolean;
+    /**
+     * Check if the device supports hover interactions.
      */
-    static serviceWorkers(): boolean;
+    static get canHover(): boolean;
 }
-export {};
 //# sourceMappingURL=Platform.d.ts.map

package/dist/types/Platform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Platform.d.ts","sourceRoot":"","sources":["../../src/Platform.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,KAAK,CAAC;AAE1F;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,KAAK,GAAG,OAAO,GAAG,SAAS,GAAG,YAAY,GAAG,KAAK,CAAC;AAE5F;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,WAAW,CAAC;AAEnD;;GAEG;AACH,UAAU,eAAe;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC9C,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,OAAO,CAAC,MAAM,CAAC;IACd,UAAU,SAAS;QAClB,aAAa,CAAC,EAAE,eAAe,CAAC;KAChC;CACD;AAeD;;GAEG;AACH,qBAAa,QAAQ;IACpB;;;OAGG;IACH,MAAM,CAAC,MAAM,IAAI,OAAO;IAIxB;;;OAGG;IACH,MAAM,CAAC,QAAQ,IAAI,OAAO;IAI1B;;;OAGG;IACH,MAAM,CAAC,SAAS,IAAI,OAAO;IAI3B;;;OAGG;IACH,MAAM,CAAC,WAAW,IAAI,WAAW;IAIjC;;;OAGG;IACH,MAAM,CAAC,QAAQ,IAAI,OAAO;IAsB1B;;;OAGG;IACH,MAAM,CAAC,OAAO,IAAI,OAAO;IAIzB;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAehC;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,QAAQ,GAAE,eAAuB,GAAG,OAAO;IA2B1D;;;;OAIG;IACH,MAAM,CAAC,MAAM,CAAC,QAAQ,GAAE,cAAsB,GAAG,OAAO;IA+BxD;;;;OAIG;IACH,MAAM,CAAC,cAAc,IAAI,OAAO;CAQhC"}
+{"version":3,"file":"Platform.d.ts","sourceRoot":"","sources":["../../src/Platform.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,KAAK,GAAG,UAAU,CAAC;AAC7F,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,eAAe,GAAG,YAAY,GAAG,KAAK,CAAC;AACnG,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,WAAW,CAAC;AAqBnD,qBAAa,QAAQ;IACnB;;OAEG;IACH,MAAM,KAAK,MAAM,IAAI,OAAO,CAE3B;IAED;;;OAGG;IACH,MAAM,KAAK,QAAQ,IAAI,OAAO,CAE7B;IAED;;OAEG;IACH,MAAM,KAAK,SAAS,IAAI,OAAO,CAE9B;IAED;;OAEG;IACH,MAAM,KAAK,WAAW,IAAI,WAAW,CAEpC;IAED;;OAEG;IACH,MAAM,KAAK,QAAQ,IAAI,OAAO,CAE7B;IAED;;OAEG;IACH,MAAM,KAAK,aAAa,IAAI,OAAO,CAElC;IAED;;;OAGG;IACH,MAAM,KAAK,KAAK,IAAI,OAAO,CAK1B;IAED;;OAEG;IACH,MAAM,KAAK,UAAU,IAAI,OAAO,CAM/B;IAED;;;OAGG;IACH,MAAM,KAAK,QAAQ,IAAI,OAAO,CAgB7B;IAED;;OAEG;IACH,MAAM,KAAK,OAAO,IAAI,OAAO,CAE5B;IAED;;OAEG;IACH,OAAO,CAAC,MAAM,KAAK,SAAS,GAE3B;IAED;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,EAAE,GAAE,eAAuB,GAAG,OAAO;IA6BpD;;;;OAIG;IACH,MAAM,CAAC,MAAM,CAAC,EAAE,GAAE,cAAsB,GAAG,OAAO;IAwBlD;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ;IAcvB;;;OAGG;IACH,MAAM,KAAK,cAAc,IAAI,OAAO,CAEnC;IAED;;OAEG;IACH,MAAM,KAAK,aAAa,IAAI,OAAO,CAElC;IAED;;OAEG;IACH,MAAM,KAAK,WAAW,IAAI,OAAO,CAEhC;IAED;;OAEG;IACH,MAAM,KAAK,QAAQ,IAAI,OAAO,CAE7B;CACF"}

package/dist/types/Preload.d.ts

@@ -3,24 +3,83 @@
  * Preload
  * ==============================
  */
-/**
- * A simple class for asset preloading. This class assumes you have a service
- * worker set up that will be caching all requests.
- */
 export declare class Preload {
     /**
-     * Preload an image file
+     * Preload and decode an image. Decoding prevents the image from still having
+     * a delay when it is displayed.
      *
-     * @param route - Route to the image
-     * @returns Resolves to the image object or gets rejected with the rejection event
+     * @param route - URL of the image
+     * @returns Promise<HTMLImageElement>
      */
     static image(route: string): Promise<HTMLImageElement>;
     /**
-     * Preload any kind of file
+     * Preload multiple images in parallel.
+     *
+     * @param routes - Array of image URLs
+     * @returns Promise<HTMLImageElement[]>
+     */
+    static images(routes: string[]): Promise<HTMLImageElement[]>;
+    /**
+     * Preload a generic file by fetching it.
+     *
+     * @param route - URL of the file
+     * @param priority - Fetch priority hint (default: 'low')
+     * @returns Promise<Response>
+     */
+    static file(route: string, priority?: 'high' | 'low' | 'auto'): Promise<Response>;
+    /**
+     * Preload multiple files in parallel.
+     *
+     * @param routes - Array of file URLs
+     * @param priority - Fetch priority hint
+     * @returns Promise<Response[]>
+     */
+    static files(routes: string[], priority?: 'high' | 'low' | 'auto'): Promise<Response[]>;
+    /**
+     * Check if a URL is cached in a specific cache.
+     *
+     * @param cacheName - Name of the cache to check
+     * @param url - URL to look for
+     * @returns Whether the URL is cached
+     */
+    static isCached(cacheName: string, url: string): Promise<boolean>;
+    /**
+     * Add a URL to a cache.
+     *
+     * @param cacheName - Name of the cache
+     * @param url - URL to cache
+     * @returns Promise<void>
+     */
+    static addToCache(cacheName: string, url: string): Promise<void>;
+    /**
+     * Add multiple URLs to a cache.
+     *
+     * @param cacheName - Name of the cache
+     * @param urls - URLs to cache
+     * @returns Promise<void>
+     */
+    static addAllToCache(cacheName: string, urls: string[]): Promise<void>;
+    /**
+     * Preload a CSS stylesheet.
+     *
+     * @param url - URL of the stylesheet
+     * @returns Promise<void>
+     */
+    static stylesheet(url: string): Promise<void>;
+    /**
+     * Preload a JavaScript file.
+     *
+     * @param url - URL of the script
+     * @returns Promise<void>
+     */
+    static script(url: string): Promise<void>;
+    /**
+     * Preload a font file.
      *
-     * @param route - Route to the file
-     * @returns Resolves or rejects depending on request success
+     * @param url - URL of the font
+     * @param crossOrigin - Whether to use crossorigin attribute (default: true for fonts)
+     * @returns Promise<void>
      */
-    static file(route: string): Promise<Blob>;
+    static font(url: string, crossOrigin?: boolean): Promise<void>;
 }
 //# sourceMappingURL=Preload.d.ts.map

package/dist/types/Preload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Preload.d.ts","sourceRoot":"","sources":["../../src/Preload.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;GAGG;AACH,qBAAa,OAAO;IACnB;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAgBtD;;;;;OAKG;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGzC"}
+{"version":3,"file":"Preload.d.ts","sourceRoot":"","sources":["../../src/Preload.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,qBAAa,OAAO;IAClB;;;;;;OAMG;WACU,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAS5D;;;;;OAKG;WACU,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAIlE;;;;;;OAMG;WACU,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,GAAG,KAAK,GAAG,MAAc,GAAG,OAAO,CAAC,QAAQ,CAAC;IAW9F;;;;;;OAMG;WACU,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,QAAQ,GAAE,MAAM,GAAG,KAAK,GAAG,MAAc,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAIpG;;;;;;OAMG;WACU,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAevE;;;;;;OAMG;WACU,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAatE;;;;;;OAMG;WACU,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAa5E;;;;;OAKG;WACU,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAenD;;;;;OAKG;WACU,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAe/C;;;;;;OAMG;WACU,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,GAAE,OAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAkB3E"}