@hkdigital/lib-core 0.4.30 → 0.4.31

package/dist/auth/jwt/constants.d.ts

@@ -1,5 +1,5 @@
 export const JWT_DEFAULT_EXPIRES_IN: "30h";
-export const JWT_NEVER_EXPIRES: any;
+export const JWT_NEVER_EXPIRES: null;
 export const DEFAULT_ALGORITHM: "HS512";
 export namespace VERIFY_OPTIONS {
     let algorithms: string[];

package/dist/auth/jwt/errors.d.ts

@@ -9,8 +9,8 @@ export class TokenExpiredError extends Error {
     constructor(message: string, details?: Date | {
         expiredAt?: Date;
     }, cause?: Error);
-    expiredAt: Date;
-    cause: Error;
+    expiredAt: Date | null;
+    cause: Error | null;
 }
 export class JsonWebTokenError extends Error {
     /**
@@ -21,8 +21,8 @@ export class JsonWebTokenError extends Error {
     constructor(message: string, details?: Error | {
         inner?: Error;
     }, cause?: Error);
-    inner: Error;
-    cause: Error;
+    inner: Error | null;
+    cause: Error | null;
 }
 export class InvalidSignatureError extends JsonWebTokenError {
 }
@@ -35,5 +35,5 @@ export class NotBeforeError extends JsonWebTokenError {
     constructor(message: string, details?: Date | {
         date?: Date;
     }, cause?: Error);
-    date: Date;
+    date: Date | null;
 }

package/dist/auth/jwt/typedef.d.ts

@@ -5,31 +5,31 @@ export type JwtStandardClaims = {
     /**
      * - Issuer
      */
-    iss?: string;
+    iss?: string | undefined;
     /**
      * - Subject
      */
-    sub?: string;
+    sub?: string | undefined;
     /**
      * - Audience
      */
-    aud?: string | string[];
+    aud?: string | string[] | undefined;
     /**
      * - Expiration time (seconds since epoch)
      */
-    exp?: number;
+    exp?: number | undefined;
     /**
      * - Not before (seconds since epoch)
      */
-    nbf?: number;
+    nbf?: number | undefined;
     /**
      * - Issued at (seconds since epoch)
      */
-    iat?: number;
+    iat?: number | undefined;
     /**
      * - JWT ID
      */
-    jti?: string;
+    jti?: string | undefined;
 };
 /**
  * JWT payload - standard claims plus any custom data
@@ -42,47 +42,47 @@ export type SignOptions = {
     /**
      * - Signing algorithm (HS256, RS256, etc.)
      */
-    algorithm?: string;
+    algorithm?: string | undefined;
     /**
      * - Expiration time ('1h', 3600, etc.)
      */
-    expiresIn?: string | number;
+    expiresIn?: string | number | undefined;
     /**
      * - Not valid before time
      */
-    notBefore?: string | number;
+    notBefore?: string | number | undefined;
     /**
      * - Audience claim
      */
-    audience?: string | string[];
+    audience?: string | string[] | undefined;
     /**
      * - Issuer claim
      */
-    issuer?: string;
+    issuer?: string | undefined;
     /**
      * - JWT ID claim
      */
-    jwtid?: string;
+    jwtid?: string | undefined;
     /**
      * - Subject claim
      */
-    subject?: string;
+    subject?: string | undefined;
     /**
      * - Skip iat claim
      */
-    noTimestamp?: boolean;
+    noTimestamp?: boolean | undefined;
     /**
      * - Additional header claims
      */
-    header?: any;
+    header?: Object | undefined;
     /**
      * - Key ID header claim
      */
-    keyid?: string;
+    keyid?: string | undefined;
     /**
      * - Modify payload object directly
      */
-    mutatePayload?: boolean;
+    mutatePayload?: boolean | undefined;
 };
 /**
  * JWT verification options
@@ -91,47 +91,47 @@ export type VerifyOptions = {
     /**
      * - Allowed algorithms
      */
-    algorithms?: string[];
+    algorithms?: string[] | undefined;
     /**
      * - Expected audience
      */
-    audience?: string | string[];
+    audience?: string | string[] | undefined;
     /**
      * - Return object with payload and header
      */
-    complete?: boolean;
+    complete?: boolean | undefined;
     /**
      * - Expected issuer
      */
-    issuer?: string;
+    issuer?: string | undefined;
     /**
      * - Skip expiration validation
      */
-    ignoreExpiration?: boolean;
+    ignoreExpiration?: boolean | undefined;
     /**
      * - Skip notBefore validation
      */
-    ignoreNotBefore?: boolean;
+    ignoreNotBefore?: boolean | undefined;
     /**
      * - Expected subject
      */
-    subject?: string;
+    subject?: string | undefined;
     /**
      * - Clock tolerance in seconds
      */
-    clockTolerance?: number;
+    clockTolerance?: number | undefined;
     /**
      * - Maximum token age in seconds
      */
-    maxAge?: number;
+    maxAge?: number | undefined;
     /**
      * - Current time override (seconds)
      */
-    clockTimestamp?: number;
+    clockTimestamp?: number | undefined;
     /**
      * - Expected nonce claim
      */
-    nonce?: string;
+    nonce?: string | undefined;
 };
 /**
  * JWT secret types
@@ -151,7 +151,7 @@ export type JwtDecoded = {
     /**
      * - The decoded header
      */
-    header: any;
+    header: Object;
     /**
      * - The signature
      */

package/dist/config/generators/imagetools.d.ts

@@ -11,8 +11,8 @@
  * ) => (Record<string, string | string[]>[])}
  */
 export function generateResponseConfigs(options?: {
-    widths?: number[];
-    thumbnailWidth?: number[];
+    widths?: number[] | undefined;
+    thumbnailWidth?: number[] | undefined;
 }): (entries: [string, string[]][]) => (Record<string, string | string[]>[]);
 /**
  * Configures and returns a function that can be used as
@@ -24,5 +24,5 @@ export function generateResponseConfigs(options?: {
  * @param {number[]} [options.presets=DEFAULT_PRESETS]
  */
 export function generateDefaultDirectives(options?: {
-    presets?: number[];
+    presets?: number[] | undefined;
 }): (url: URL) => URLSearchParams;

package/dist/config/generators/vite.d.ts

@@ -6,20 +6,20 @@
  * @param {boolean} [options.enableVitest=true] Include Vitest configuration
  * @param {boolean} [options.enableSvelteKit=true] Enable SvelteKit plugin
  * @param {object} [options.customDefines={}] Additional define values
- * @param {Array} [options.customPlugins=[]] Additional Vite plugins
+ * @param {Array<any>} [options.customPlugins=[]] Additional Vite plugins
  * @param {object} [options.imagetoolsOptions={}] Options for imagetools config
  * @param {string} [options.packageJsonPath='./package.json'] Path to package.json
  *
  * @returns {Promise<object>} Vite configuration object
  */
 export function generateViteConfig(options?: {
-    enableImagetools?: boolean;
-    enableVitest?: boolean;
-    enableSvelteKit?: boolean;
-    customDefines?: object;
-    customPlugins?: any[];
-    imagetoolsOptions?: object;
-    packageJsonPath?: string;
+    enableImagetools?: boolean | undefined;
+    enableVitest?: boolean | undefined;
+    enableSvelteKit?: boolean | undefined;
+    customDefines?: object | undefined;
+    customPlugins?: any[] | undefined;
+    imagetoolsOptions?: object | undefined;
+    packageJsonPath?: string | undefined;
 }): Promise<object>;
 /**
  * Generates build-time defines for Vite
@@ -31,8 +31,8 @@ export function generateViteConfig(options?: {
  * @returns {object} Define configuration object
  */
 export function generateViteDefines(options?: {
-    packageJsonPath?: string;
-    customDefines?: object;
+    packageJsonPath?: string | undefined;
+    customDefines?: object | undefined;
 }): object;
 /**
  * Generates Vitest configuration
@@ -43,5 +43,5 @@ export function generateViteDefines(options?: {
  * @returns {object} Vitest configuration object
  */
 export function generateVitestConfig(options?: {
-    additionalPatterns?: string[];
+    additionalPatterns?: string[] | undefined;
 }): object;

package/dist/config/generators/vite.js

@@ -9,7 +9,7 @@ import { resolve } from 'path';
  * @param {boolean} [options.enableVitest=true] Include Vitest configuration
  * @param {boolean} [options.enableSvelteKit=true] Enable SvelteKit plugin
  * @param {object} [options.customDefines={}] Additional define values
- * @param {Array} [options.customPlugins=[]] Additional Vite plugins
+ * @param {Array<any>} [options.customPlugins=[]] Additional Vite plugins
  * @param {object} [options.imagetoolsOptions={}] Options for imagetools config
  * @param {string} [options.packageJsonPath='./package.json'] Path to package.json
  *

package/dist/design/generators/index.d.ts

@@ -40,15 +40,15 @@
  * ```
  */
 export function generateTailwindThemeExtensions({ TEXT_POINT_SIZES, VIEWPORT_POINT_SIZES, TEXT_BASE_SIZES, TEXT_HEADING_SIZES, TEXT_UI_SIZES, RADIUS_SIZES, BORDER_WIDTH_SIZES, STROKE_WIDTH_SIZES }: {
-    TEXT_POINT_SIZES: any;
-    VIEWPORT_POINT_SIZES: any;
-    TEXT_BASE_SIZES: any;
-    TEXT_HEADING_SIZES: any;
-    TEXT_UI_SIZES: any;
-    RADIUS_SIZES: any;
-    BORDER_WIDTH_SIZES: any;
-    STROKE_WIDTH_SIZES: any;
-}): any;
+    TEXT_POINT_SIZES: Object;
+    VIEWPORT_POINT_SIZES: Object;
+    TEXT_BASE_SIZES: Object;
+    TEXT_HEADING_SIZES: Object;
+    TEXT_UI_SIZES: Object;
+    RADIUS_SIZES: Object;
+    BORDER_WIDTH_SIZES: Object;
+    STROKE_WIDTH_SIZES: Object;
+}): Object;
 /**
  * Generates text-based spacing units with with different scaling
  * units (ut, bt, ht)

package/dist/design/utils/clamp.d.ts

@@ -5,7 +5,7 @@
  * @returns {Object} Object with min and max values
  * @throws {Error} If the CSS variable doesn't exist or doesn't contain a valid clamp function
  */
-export function getClampParams(varName: string): any;
+export function getClampParams(varName: string): Object;
 /**
  * CSS clamp function implementation
  *

package/dist/design/utils/root-vars.d.ts

@@ -76,7 +76,7 @@ export function getRootCssDesignHeight(): number;
  *
  * @returns {Object} An object containing all scaling factors
  */
-export function getAllRootScalingVars(): any;
+export function getAllRootScalingVars(): Object;
 /**
  * Extract a CSS variable value from document root
  *

package/dist/design/utils/scaling.d.ts

@@ -49,8 +49,8 @@ export function enableContainerScaling({ container, design, clamping, getDimensi
             max: number;
         };
     };
-    getDimensions?: Function;
-    useResizeObserver?: boolean;
+    getDimensions?: Function | undefined;
+    useResizeObserver?: boolean | undefined;
 }): () => void;
 /**
  * Manages responsive design scaling by calculating and applying scale factors

package/dist/generic/data/classes/IterableTree.d.ts

@@ -10,8 +10,8 @@ export default class IterableTree {
      * @param {string[]} [_parentArrPath]
      */
     constructor(obj: object, options?: import("./typedef.js").IterableTreeOptions, _parentArrPath?: string[]);
-    obj: any;
-    _parentArrPath: string[];
+    obj: object;
+    _parentArrPath: string[] | null;
     /**
      * Get an iterator to iterate over all object [ path, value ] entries
      *

package/dist/generic/data/classes/IterableTree.js

@@ -67,6 +67,7 @@ export default class IterableTree {
 		// @note keys are own properties only
 		const keys = Object.keys(obj);
 
+		/** @type {string[]|undefined} */
 		let pathKeys;
 
 		if (expandPathKeys) {

package/dist/generic/data/classes/Selector.d.ts

@@ -5,9 +5,9 @@ export default class Selector {
     /**
      * Constructor
      *
-     * @param {object|null} selector
+     * @param {Record<string, any>|null} selector
      */
-    constructor(selector: object | null);
+    constructor(selector: Record<string, any> | null);
     /**
      * Returns the first item from the list of items that matches the selector
      *
@@ -16,15 +16,15 @@ export default class Selector {
      *
      * @returns {T|null} item or null if not found
      */
-    findFirst<T extends unknown>(items: T[] | null): T | null;
+    findFirst<T extends object>(items: T[] | null): T | null;
     /**
      * Returns all items from the list of items that match the selector
      *
      * @template {object} T
      * @param {T[]|null} items
      *
-     * @returns {T[]|null} item or null if not found
+     * @returns {T[]} array of matching items
      */
-    findAll<T extends unknown>(items: T[] | null): T[] | null;
+    findAll<T extends object>(items: T[] | null): T[];
     #private;
 }

package/dist/generic/data/classes/Selector.js

@@ -36,19 +36,56 @@ import * as expect from '../../../util/expect.js';
  * Construct a Selector class
  */
 export default class Selector {
-	/** @type {function|null} test function */
-	#testFn = null;
+	/** @type {function} test function */
+	#testFn;
 
 	/**
 	 * Constructor
 	 *
-	 * @param {object|null} selector
+	 * @param {Record<string, any>|null} selector
 	 */
 	constructor(selector) {
-		this.#updateTestFn(selector);
-	}
+		// > Case A: selector=null
+
+		if (null === selector) {
+			this.#testFn = this.#returnTrue;
+			return;
+		}
+
+		// > Validate selector
+
+		expect.objectOrNull(selector);
+
+		const keys = Object.keys(selector);
+		const n = keys.length;
+
+		// > Case B: selector has not properties
+
+		if (!n) {
+			this.#testFn = this.#returnTrue;
+			return;
+		}
+
+		// > Case C: selector with single key-value pair
+
+		if (1 === n) {
+			const key = keys[0];
+			const value = selector[key];
+
+			this.#testFn = this.#testKeyValue.bind(this, key, value);
+			return;
+		}
+
+		// > Case D: selector with multiple key-value pairs
 
-	// -------------------------------------------------------------------- Method
+		const selectorValues = [];
+
+		for (const key of keys) {
+			selectorValues.push(selector[key]);
+		}
+
+		this.#testFn = this.#testMultipleKeyValues.bind(this, keys, selectorValues);
+	}
 
 	/**
 	 * Returns the first item from the list of items that matches the selector
@@ -72,17 +109,16 @@ export default class Selector {
 		return null;
 	}
 
-	// -------------------------------------------------------------------- Method
-
 	/**
 	 * Returns all items from the list of items that match the selector
 	 *
 	 * @template {object} T
 	 * @param {T[]|null} items
 	 *
-	 * @returns {T[]|null} item or null if not found
+	 * @returns {T[]} array of matching items
 	 */
 	findAll(items) {
+		/** @type {T[]} */
 		const result = [];
 
 		if (!items) {
@@ -100,53 +136,6 @@ export default class Selector {
 
 	/* ------------------------------------------------------- Internal methods */
 
-	/**
-	 * Update the internal selector function
-	 */
-	#updateTestFn(selector) {
-		// > Case A: selector=null
-
-		if (null === selector) {
-			this.#testFn = this.#returnTrue;
-			return;
-		}
-
-		// > Validate selector
-
-		expect.objectOrNull(selector);
-
-		const keys = Object.keys(selector);
-		const n = keys.length;
-
-		// > Case B: selector has not properties
-
-		if (!n) {
-			this.#testFn = this.#returnTrue;
-			return;
-		}
-
-		// > Case C: selector with single key-value pair
-
-		if (1 === n) {
-			const key = keys[0];
-			const value = selector[key];
-
-			this.#testFn = this.#testKeyValue.bind(this, key, value);
-		}
-
-		// > Case D: selector with multiple key-value pairs
-
-		const selectorValues = [];
-
-		for (const key of keys) {
-			selectorValues.push(selector[key]);
-		}
-
-		this.#testFn = this.#testMultipleKeyValues.bind(this, keys, selectorValues);
-	}
-
-	// -------------------------------------------------------------------- Method
-
 	/**
 	 * Always return true
 	 * - This function is used if the test function should always return true
@@ -157,23 +146,27 @@ export default class Selector {
 		return true;
 	}
 
-	// -------------------------------------------------------------------- Method
-
 	/**
 	 * Return true if the item matches the key-value pair
 	 * - This function is used if the test function should test a
 	 *   single key-value pair
+	 * @param {string} key - Property key
+	 * @param {any} value - Expected value
+	 * @param {Record<string, any>} item - Item to test
+	 * @returns {boolean} True if item matches
 	 */
 	#testKeyValue(key, value, item) {
 		return value === item[key];
 	}
 
-	// -------------------------------------------------------------------- Method
-
 	/**
 	 * Return true if the item matches all key-value pairs
 	 * - This function is used if the test function should test multiple
 	 *   key-value pairs
+	 * @param {string[]} keys - Array of property keys
+	 * @param {any[]} values - Array of expected values
+	 * @param {Record<string, any>} item - Item to test
+	 * @returns {boolean} True if item matches all key-value pairs
 	 */
 	#testMultipleKeyValues(keys, values, item) {
 		let isMatch = true;

package/dist/generic/data/classes/typedef.d.ts

@@ -4,21 +4,21 @@ export type IterableTreeOptions = {
     /**
      * - Whether to walk into array elements
      */
-    walkArrays?: boolean;
+    walkArrays?: boolean | undefined;
     /**
      * - Whether to ignore empty object leaves
      */
-    ignoreEmptyObjectLeaves?: boolean;
+    ignoreEmptyObjectLeaves?: boolean | undefined;
     /**
      * - Whether to expand path keys
      */
-    expandPathKeys?: boolean;
+    expandPathKeys?: boolean | undefined;
     /**
      * - Whether to output intermediate nodes
      */
-    outputIntermediateNodes?: boolean;
+    outputIntermediateNodes?: boolean | undefined;
     /**
      * - Whether to use depth-first traversal
      */
-    depthFirst?: boolean;
+    depthFirst?: boolean | undefined;
 };

package/dist/generic/errors/generic.d.ts

@@ -11,6 +11,8 @@ export class DetailedError extends Error {
      * @param {Error|null} [cause] - Original error
      */
     constructor(message?: string, details?: import("./typedef.js").ErrorDetails, cause?: Error | null);
-    details: import("./typedef.js").ErrorDetails;
+    details: string | {
+        [key: string]: any;
+    } | null;
     cause: unknown;
 }

package/dist/generic/errors/promise.d.ts

@@ -15,8 +15,8 @@ export class PromiseError extends Error {
      * @param {*} [options.details] - Additional details object
      */
     constructor(message: string, options?: {
-        timeout?: boolean;
-        cancelled?: boolean;
+        timeout?: boolean | undefined;
+        cancelled?: boolean | undefined;
         cause?: Error | any;
         details?: any;
     });

package/dist/generic/events/classes/EventEmitter.js

@@ -120,6 +120,7 @@ export default class EventEmitter {
       throw new TypeError('Event handler must be a function');
     }
 
+    /** @param {...any} args */
     const wrapper = (...args) => {
       this.off(eventName, wrapper);
       handler(...args);

package/dist/generic/promises/classes/HkPromise.js

@@ -48,7 +48,7 @@ import { PromiseError } from '../../errors.js';
  * HkPromise extends the default javascript Promise class
  * - Exposes methods to interact with the state of the
  *   promise, such as 'resolve' and 'reject'
- * 
+ *
  * @template T
  * @extends {Promise<T>}
  * @implements {PromiseLike<T>}
@@ -266,22 +266,16 @@ export default class HkPromise extends Promise {
 
 		if (errorOrDetails instanceof Error) {
 			// If it's an Error, create error chain
-			promiseError = new PromiseError(
-				errorOrDetails.message,
-				{
-					cancelled: true,
-					cause: errorOrDetails
-				}
-			);
+			promiseError = new PromiseError(errorOrDetails.message, {
+				cancelled: true,
+				cause: errorOrDetails
+			});
 		} else {
 			// If it's details or undefined, use as details
-			promiseError = new PromiseError(
-				'Cancelled',
-				{
-					cancelled: true,
-					details: errorOrDetails
-				}
-			);
+			promiseError = new PromiseError('Cancelled', {
+				cancelled: true,
+				details: errorOrDetails
+			});
 		}
 
 		this.#cancelled = true;