@hkdigital/lib-core 0.3.9 → 0.3.11

package/dist/util/svelte/loading/loading-tracker.svelte.js

@@ -1,108 +1,108 @@
-/**
- * Simple utility for tracking combined loading progress across multiple components
- *
- * @typedef {Object} LoadingProgress
- * @property {number} bytesLoaded - Number of bytes loaded
- * @property {number} size - Total size in bytes
- * @property {boolean} loaded - Whether loading is complete
- */
-
-/**
- * Creates a loading tracker that combines progress from multiple sources
- *
- * @returns {Object} Loading tracker instance
- */
-export function createTracker() {
-  // Store progress for each item by ID
-  const items = new Map();
-
-  // Computed values
-  let totalBytesLoaded = 0;
-  let totalSize = 0;
-  let allLoaded = false;
-  let progressPercent = 0;
-
-  /**
-   * Update the totals based on current items
-   */
-  function updateTotals() {
-    let bytesLoaded = 0;
-    let size = 0;
-    let loaded = items.size > 0;
-
-    // Loop through all items and sum values
-    for (const progress of items.values()) {
-      bytesLoaded += progress.bytesLoaded || 0;
-      size += progress.size || 0;
-
-      if (!progress.loaded) {
-        loaded = false;
-      }
-    }
-
-    // Update state
-    totalBytesLoaded = bytesLoaded;
-    totalSize = size;
-    allLoaded = items.size > 0 ? loaded : false;
-    progressPercent = size > 0 ? Math.round((bytesLoaded / size) * 100) : 0;
-  }
-
-  /**
-   * Track progress for a component
-   *
-   * @param {LoadingProgress} progress - The progress update
-   * @param {string|Symbol} id - The component identifier
-   */
-  function track(progress, id) {
-    if (progress && id) {
-      items.set(id, progress);
-      updateTotals();
-    }
-  }
-
-  /**
-   * Remove an item from tracking
-   *
-   * @param {string|Symbol} id - Item identifier to remove
-   */
-  function remove(id) {
-    if (items.has(id)) {
-      items.delete(id);
-      updateTotals();
-    }
-  }
-
-  /**
-   * Reset the tracker, clearing all items
-   */
-  function reset() {
-    items.clear();
-    updateTotals();
-  }
-
-  // Return the public API
-  return {
-    track,
-    remove,
-    reset,
-
-    // Read-only properties
-    get state() {
-      return {
-        bytesLoaded: totalBytesLoaded,
-        size: totalSize,
-        loaded: allLoaded,
-        percent: progressPercent,
-        itemCount: items.size
-      };
-    },
-
-    get loaded() {
-      return allLoaded;
-    },
-
-    get percent() {
-      return progressPercent;
-    }
-  };
-}
+/**
+ * Simple utility for tracking combined loading progress across multiple components
+ *
+ * @typedef {Object} LoadingProgress
+ * @property {number} bytesLoaded - Number of bytes loaded
+ * @property {number} size - Total size in bytes
+ * @property {boolean} loaded - Whether loading is complete
+ */
+
+/**
+ * Creates a loading tracker that combines progress from multiple sources
+ *
+ * @returns {Object} Loading tracker instance
+ */
+export function createTracker() {
+  // Store progress for each item by ID
+  const items = new Map();
+
+  // Computed values
+  let totalBytesLoaded = 0;
+  let totalSize = 0;
+  let allLoaded = false;
+  let progressPercent = 0;
+
+  /**
+   * Update the totals based on current items
+   */
+  function updateTotals() {
+    let bytesLoaded = 0;
+    let size = 0;
+    let loaded = items.size > 0;
+
+    // Loop through all items and sum values
+    for (const progress of items.values()) {
+      bytesLoaded += progress.bytesLoaded || 0;
+      size += progress.size || 0;
+
+      if (!progress.loaded) {
+        loaded = false;
+      }
+    }
+
+    // Update state
+    totalBytesLoaded = bytesLoaded;
+    totalSize = size;
+    allLoaded = items.size > 0 ? loaded : false;
+    progressPercent = size > 0 ? Math.round((bytesLoaded / size) * 100) : 0;
+  }
+
+  /**
+   * Track progress for a component
+   *
+   * @param {LoadingProgress} progress - The progress update
+   * @param {string|Symbol} id - The component identifier
+   */
+  function track(progress, id) {
+    if (progress && id) {
+      items.set(id, progress);
+      updateTotals();
+    }
+  }
+
+  /**
+   * Remove an item from tracking
+   *
+   * @param {string|Symbol} id - Item identifier to remove
+   */
+  function remove(id) {
+    if (items.has(id)) {
+      items.delete(id);
+      updateTotals();
+    }
+  }
+
+  /**
+   * Reset the tracker, clearing all items
+   */
+  function reset() {
+    items.clear();
+    updateTotals();
+  }
+
+  // Return the public API
+  return {
+    track,
+    remove,
+    reset,
+
+    // Read-only properties
+    get state() {
+      return {
+        bytesLoaded: totalBytesLoaded,
+        size: totalSize,
+        loaded: allLoaded,
+        percent: progressPercent,
+        itemCount: items.size
+      };
+    },
+
+    get loaded() {
+      return allLoaded;
+    },
+
+    get percent() {
+      return progressPercent;
+    }
+  };
+}

package/dist/util/svelte/observe/index.js

@@ -1,49 +1,49 @@
-import { onMount, onDestroy } from 'svelte';
-
-/**
- * @param {function} target
- * @param {(entries:ResizeObserverEntry[]) => void} callback
- * @param {object} [options]
- *
- * @returns {{ stop: () => void }}
- */
-export function useResizeObserver(target, callback, options) {
-	/** @type {HTMLInputElement} */
-	let elem;
-
-	/** @type {ResizeObserver|undefined} */
-	let resizeObserver;
-
-	onMount(() => {
-		// console.log('useResizeObserver:onMount');
-
-		if (target instanceof HTMLInputElement) {
-			elem = target;
-		} else if (typeof target === 'function') {
-			let output = target();
-
-			// console.log({ output });
-
-			elem = output;
-		} else {
-			throw new Error('Invalid value for parameter [target]');
-		}
-
-		resizeObserver = new ResizeObserver(callback);
-
-		resizeObserver.observe(elem);
-	});
-
-	onDestroy(() => {
-		// console.log('useResizeObserver:onDestroy');
-
-		if (resizeObserver) {
-			resizeObserver.unobserve(elem);
-			resizeObserver = undefined;
-		}
-	});
-
-	return {
-		stop: () => {}
-	};
-}
+import { onMount, onDestroy } from 'svelte';
+
+/**
+ * @param {function} target
+ * @param {(entries:ResizeObserverEntry[]) => void} callback
+ * @param {object} [options]
+ *
+ * @returns {{ stop: () => void }}
+ */
+export function useResizeObserver(target, callback, options) {
+	/** @type {HTMLInputElement} */
+	let elem;
+
+	/** @type {ResizeObserver|undefined} */
+	let resizeObserver;
+
+	onMount(() => {
+		// console.log('useResizeObserver:onMount');
+
+		if (target instanceof HTMLInputElement) {
+			elem = target;
+		} else if (typeof target === 'function') {
+			let output = target();
+
+			// console.log({ output });
+
+			elem = output;
+		} else {
+			throw new Error('Invalid value for parameter [target]');
+		}
+
+		resizeObserver = new ResizeObserver(callback);
+
+		resizeObserver.observe(elem);
+	});
+
+	onDestroy(() => {
+		// console.log('useResizeObserver:onDestroy');
+
+		if (resizeObserver) {
+			resizeObserver.unobserve(elem);
+			resizeObserver = undefined;
+		}
+	});
+
+	return {
+		stop: () => {}
+	};
+}

package/dist/util/svelte/state-context/index.js

@@ -1,117 +1,117 @@
-import { setContext, getContext, hasContext } from 'svelte';
-
-export const DEFAULT_CONTEXT_KEY = 'default';
-
-/* ----------------------------------------------------------- Create and Get */
-
-/**
- * Define a state context:
- * - Returns a function 'createOrGetState' that can be used to create a new state
- *   or get an existing one
- * - Returns a function 'createState' that can be used to create a new state
- *
- * @template T
- *
- * @param {new() => T} State - Class that can be used to construct the state
- *
- * @returns {[
- *   createOrGetState,
- *   createState,
- *   getState
- * ]}
- */
-export function defineStateContext(State) {
-  const stateName = State.name;
-
-  const sharedKey = Symbol(stateName);
-
-  // console.debug(`Creating state context for ${stateName}`, { sharedKey });
-
-  /**
-   * Internal function to get the supplied key or the shared key
-   *
-   * @param {import('../../../typedef').ContextKey} [contextKey]
-   *
-   * @returns {Symbol} key
-   */
-  function getKey(contextKey) {
-    if (typeof contextKey === 'symbol') {
-      return contextKey;
-    }
-
-    if (
-      contextKey === undefined ||
-      contextKey === null ||
-      contextKey === DEFAULT_CONTEXT_KEY
-    ) {
-      return sharedKey;
-    }
-
-    throw new Error(
-      `Invalid contextKey (use a Symbol or DEFAULT_CONTEXT_KEY)`
-    );
-  }
-
-  /**
-   * Create component state
-   *
-   * @param {import('../../../typedef').ContextKey} [contextKey]
-   *
-   * @returns {T} state
-   */
-  function createState(contextKey) {
-    const key = getKey(contextKey);
-
-    // console.log('Create state', key);
-    // console.debug(`Creating new state for ${stateName}`, {
-    //   key,
-    //   contextKey,
-    //   isDefaultKey: key === sharedKey
-    // });
-
-    const state = new State();
-
-    // @ts-ignore
-    state._contextKey = contextKey;
-
-    return setContext(key, state);
-  }
-
-  /**
-   * Get component state or create a new state if it does not yet exist
-   *
-   * @param {import('../../../typedef').ContextKey} [contextKey]
-   *
-   * @returns {T} state
-   */
-  function createOrGetState(contextKey) {
-    let key = getKey(contextKey);
-
-    if (!hasContext(key)) {
-      return createState(key);
-    }
-
-    return getContext(key);
-  }
-
-  /**
-   * Get component state
-   *
-   * @throws Will throw an error if the state-context does not exist
-   *
-   * @param {import('../../../typedef').ContextKey} [contextKey]
-   *
-   * @returns {T} state
-   */
-  function getState(contextKey) {
-    let key = getKey(contextKey);
-
-    if (!hasContext(key)) {
-      throw new Error(`No state context found. Create one first`);
-    }
-
-    return getContext(key);
-  }
-
-  return [createOrGetState, createState, getState];
-}
+import { setContext, getContext, hasContext } from 'svelte';
+
+export const DEFAULT_CONTEXT_KEY = 'default';
+
+/* ----------------------------------------------------------- Create and Get */
+
+/**
+ * Define a state context:
+ * - Returns a function 'createOrGetState' that can be used to create a new state
+ *   or get an existing one
+ * - Returns a function 'createState' that can be used to create a new state
+ *
+ * @template T
+ *
+ * @param {new() => T} State - Class that can be used to construct the state
+ *
+ * @returns {[
+ *   createOrGetState,
+ *   createState,
+ *   getState
+ * ]}
+ */
+export function defineStateContext(State) {
+  const stateName = State.name;
+
+  const sharedKey = Symbol(stateName);
+
+  // console.debug(`Creating state context for ${stateName}`, { sharedKey });
+
+  /**
+   * Internal function to get the supplied key or the shared key
+   *
+   * @param {import('../../../typedef').ContextKey} [contextKey]
+   *
+   * @returns {Symbol} key
+   */
+  function getKey(contextKey) {
+    if (typeof contextKey === 'symbol') {
+      return contextKey;
+    }
+
+    if (
+      contextKey === undefined ||
+      contextKey === null ||
+      contextKey === DEFAULT_CONTEXT_KEY
+    ) {
+      return sharedKey;
+    }
+
+    throw new Error(
+      `Invalid contextKey (use a Symbol or DEFAULT_CONTEXT_KEY)`
+    );
+  }
+
+  /**
+   * Create component state
+   *
+   * @param {import('../../../typedef').ContextKey} [contextKey]
+   *
+   * @returns {T} state
+   */
+  function createState(contextKey) {
+    const key = getKey(contextKey);
+
+    // console.log('Create state', key);
+    // console.debug(`Creating new state for ${stateName}`, {
+    //   key,
+    //   contextKey,
+    //   isDefaultKey: key === sharedKey
+    // });
+
+    const state = new State();
+
+    // @ts-ignore
+    state._contextKey = contextKey;
+
+    return setContext(key, state);
+  }
+
+  /**
+   * Get component state or create a new state if it does not yet exist
+   *
+   * @param {import('../../../typedef').ContextKey} [contextKey]
+   *
+   * @returns {T} state
+   */
+  function createOrGetState(contextKey) {
+    let key = getKey(contextKey);
+
+    if (!hasContext(key)) {
+      return createState(key);
+    }
+
+    return getContext(key);
+  }
+
+  /**
+   * Get component state
+   *
+   * @throws Will throw an error if the state-context does not exist
+   *
+   * @param {import('../../../typedef').ContextKey} [contextKey]
+   *
+   * @returns {T} state
+   */
+  function getState(contextKey) {
+    let key = getKey(contextKey);
+
+    if (!hasContext(key)) {
+      throw new Error(`No state context found. Create one first`);
+    }
+
+    return getContext(key);
+  }
+
+  return [createOrGetState, createState, getState];
+}

package/dist/util/svelte/wait/index.js

@@ -1,38 +1,38 @@
-import { tick } from 'svelte';
-
-/**
- * Waits for a state condition to be met by running the checkFn
- * function after each Svelte tick
- *
- * @param {() => boolean} checkFn -
- *   Should return true when desired state is reached
- *
- * @param {number} [maxWaitMs=1000]
- *
- * @returns {Promise<void>} Promise that resolves when the check
- *   function returns true
- * @throws {Error} if maxAttempts is reached before
- * predicate returns true
- */
-export function waitForState(checkFn, maxWaitMs = 1000) {
-  let startedAt = Date.now();
-
-  return new Promise((resolve, reject) => {
-    async function checkLoop() {
-      if (checkFn()) {
-        resolve();
-        return;
-      }
-
-      if (Date.now() - startedAt >= maxWaitMs) {
-        reject(new Error(`State change timeout`));
-        return;
-      }
-
-      await tick();
-      checkLoop();
-    }
-
-    checkLoop();
-  });
-}
+import { tick } from 'svelte';
+
+/**
+ * Waits for a state condition to be met by running the checkFn
+ * function after each Svelte tick
+ *
+ * @param {() => boolean} checkFn -
+ *   Should return true when desired state is reached
+ *
+ * @param {number} [maxWaitMs=1000]
+ *
+ * @returns {Promise<void>} Promise that resolves when the check
+ *   function returns true
+ * @throws {Error} if maxAttempts is reached before
+ * predicate returns true
+ */
+export function waitForState(checkFn, maxWaitMs = 1000) {
+  let startedAt = Date.now();
+
+  return new Promise((resolve, reject) => {
+    async function checkLoop() {
+      if (checkFn()) {
+        resolve();
+        return;
+      }
+
+      if (Date.now() - startedAt >= maxWaitMs) {
+        reject(new Error(`State change timeout`));
+        return;
+      }
+
+      await tick();
+      checkLoop();
+    }
+
+    checkLoop();
+  });
+}

package/dist/util/sveltekit/index.js

@@ -1 +1 @@
-export * from './route-folders/index.js';
+export * from './route-folders/index.js';