@hkdigital/lib-core 0.3.11 → 0.3.13

package/dist/classes/svelte/finite-state-machine/FiniteStateMachine.svelte.js

@@ -1,133 +1,133 @@
-/**
- * Initial code borrowed from:
- *
- * @see {@link https://runed.dev/docs/utilities/finite-state-machine}
- */
-
-/**
- * Check if the value is valid meta data
- *
- * @param {any} meta
- */
-export function isLifecycleFnMeta(meta) {
-  return (
-    !!meta &&
-    typeof meta === 'object' &&
-    'to' in meta &&
-    'from' in meta &&
-    'event' in meta &&
-    'args' in meta
-  );
-}
-
-/**
- * Defines a Finite State Machine
- */
-export default class FiniteStateMachine {
-  #current = $state();
-  states;
-  #timeout = {};
-
-  /**
-   * Constructor
-   *
-   * @param {string} initial
-   * @param {{ [key: string]: { [key: string]: (string|((...args: any[])=>void)) } }} states
-   */
-  constructor(initial, states) {
-    this.#current = initial;
-    this.states = states;
-
-    // synthetically trigger _enter for the initial state.
-    this.#dispatch('_enter', {
-      from: null,
-      to: initial,
-      event: null,
-      args: []
-    });
-  }
-
-  /**
-   * Transition to new state
-   *
-   * @param {string} newState
-   * @param {string} event
-   * @param {any[]} [args]
-   */
-  #transition(newState, event, args) {
-    const metadata = { from: this.#current, to: newState, event, args };
-    this.#dispatch('_exit', metadata);
-    this.#current = newState;
-    this.#dispatch('_enter', metadata);
-  }
-
-  /**
-   * Dispatch an event
-   *
-   * @param {string} event
-   * @param {any[]} args
-   */
-  #dispatch(event, ...args) {
-    const action =
-      this.states[this.#current]?.[event] ?? this.states['*']?.[event];
-    if (action instanceof Function) {
-      if (event === '_enter' || event === '_exit') {
-        if (isLifecycleFnMeta(args[0])) {
-          action(args[0]);
-        } else {
-          console.warn(
-            'Invalid metadata passed to lifecycle function of the FSM.'
-          );
-        }
-      } else {
-        return action(...args);
-      }
-    } else if (typeof action === 'string') {
-      return action;
-    } else if (event !== '_enter' && event !== '_exit') {
-      console.warn(
-        'No action defined for event',
-        event,
-        'in state',
-        this.#current
-      );
-    }
-  }
-  /**
-   * Triggers a new event and returns the new state.
-   *
-   * @param {string} event
-   * @param {any[]} args
-   */
-  send(event, ...args) {
-    const newState = this.#dispatch(event, ...args);
-    if (newState && newState !== this.#current) {
-      this.#transition(newState, event, args);
-    }
-
-    return this.#current;
-  }
-  /**
-   * Debounces the triggering of an event.
-   *
-   * @param {number} wait
-   * @param {string} event
-   * @param {any[]} args
-   */
-  async debounce(wait = 500, event, ...args) {
-    if (this.#timeout[event]) {
-      clearTimeout(this.#timeout[event]);
-    }
-    return new Promise((resolve) => {
-      this.#timeout[event] = setTimeout(() => {
-        delete this.#timeout[event];
-        resolve(this.send(event, ...args));
-      }, wait);
-    });
-  }
-
-  /** The current state. */
-  get current() {
-    return this.#current;
-  }
-}
+/**
+ * Initial code borrowed from:
+ *
+ * @see {@link https://runed.dev/docs/utilities/finite-state-machine}
+ */
+
+/**
+ * Check if the value is valid meta data
+ *
+ * @param {any} meta
+ */
+export function isLifecycleFnMeta(meta) {
+  return (
+    !!meta &&
+    typeof meta === 'object' &&
+    'to' in meta &&
+    'from' in meta &&
+    'event' in meta &&
+    'args' in meta
+  );
+}
+
+/**
+ * Defines a Finite State Machine
+ */
+export default class FiniteStateMachine {
+  #current = $state();
+  states;
+  #timeout = {};
+
+  /**
+   * Constructor
+   *
+   * @param {string} initial
+   * @param {{ [key: string]: { [key: string]: (string|((...args: any[])=>void)) } }} states
+   */
+  constructor(initial, states) {
+    this.#current = initial;
+    this.states = states;
+
+    // synthetically trigger _enter for the initial state.
+    this.#dispatch('_enter', {
+      from: null,
+      to: initial,
+      event: null,
+      args: []
+    });
+  }
+
+  /**
+   * Transition to new state
+   *
+   * @param {string} newState
+   * @param {string} event
+   * @param {any[]} [args]
+   */
+  #transition(newState, event, args) {
+    const metadata = { from: this.#current, to: newState, event, args };
+    this.#dispatch('_exit', metadata);
+    this.#current = newState;
+    this.#dispatch('_enter', metadata);
+  }
+
+  /**
+   * Dispatch an event
+   *
+   * @param {string} event
+   * @param {any[]} args
+   */
+  #dispatch(event, ...args) {
+    const action =
+      this.states[this.#current]?.[event] ?? this.states['*']?.[event];
+    if (action instanceof Function) {
+      if (event === '_enter' || event === '_exit') {
+        if (isLifecycleFnMeta(args[0])) {
+          action(args[0]);
+        } else {
+          console.warn(
+            'Invalid metadata passed to lifecycle function of the FSM.'
+          );
+        }
+      } else {
+        return action(...args);
+      }
+    } else if (typeof action === 'string') {
+      return action;
+    } else if (event !== '_enter' && event !== '_exit') {
+      console.warn(
+        'No action defined for event',
+        event,
+        'in state',
+        this.#current
+      );
+    }
+  }
+  /**
+   * Triggers a new event and returns the new state.
+   *
+   * @param {string} event
+   * @param {any[]} args
+   */
+  send(event, ...args) {
+    const newState = this.#dispatch(event, ...args);
+    if (newState && newState !== this.#current) {
+      this.#transition(newState, event, args);
+    }
+
+    return this.#current;
+  }
+  /**
+   * Debounces the triggering of an event.
+   *
+   * @param {number} wait
+   * @param {string} event
+   * @param {any[]} args
+   */
+  async debounce(wait = 500, event, ...args) {
+    if (this.#timeout[event]) {
+      clearTimeout(this.#timeout[event]);
+    }
+    return new Promise((resolve) => {
+      this.#timeout[event] = setTimeout(() => {
+        delete this.#timeout[event];
+        resolve(this.send(event, ...args));
+      }, wait);
+    });
+  }
+
+  /** The current state. */
+  get current() {
+    return this.#current;
+  }
+}

package/dist/classes/svelte/finite-state-machine/index.js

@@ -1 +1 @@
-export { default as FiniteStateMachine } from './FiniteStateMachine.svelte';
+export { default as FiniteStateMachine } from './FiniteStateMachine.svelte';

package/dist/classes/svelte/index.js

@@ -1,11 +1 @@
-
-export { default as AudioScene } from './audio/AudioScene.svelte.js';
-export { default as AudioLoader } from './audio/AudioLoader.svelte.js';
-
-export { default as FiniteStateMachine } from './finite-state-machine/FiniteStateMachine.svelte.js';
-
-export { default as ImageLoader } from './image/ImageLoader.svelte.js';
-export { default as ImageScene } from './image/ImageScene.svelte.js';
-export { default as ImageVariantsLoader } from './image/ImageVariantsLoader.svelte.js';
-
-export * from './image/typedef.js';
+export { default as FiniteStateMachine } from './finite-state-machine/FiniteStateMachine.svelte.js';

package/dist/classes/svelte/loading-state-machine/LoadingStateMachine.svelte.js

@@ -1,109 +1,109 @@
-//import { FiniteStateMachine } from 'runed';
-
-import { FiniteStateMachine } from '../finite-state-machine/index.js';
-
-import {
-  // > States
-  STATE_INITIAL,
-  STATE_LOADING,
-  STATE_UNLOADING,
-  STATE_LOADED,
-  STATE_CANCELLED,
-  STATE_ERROR,
-
-  // > Signals
-  INITIAL,
-  LOAD,
-  CANCEL,
-  ERROR,
-  LOADED,
-  UNLOAD
-} from './constants.js';
-
-/**
- * extends FiniteStateMachine<StatesT, EventsT>
- */
-export default class LoadingStateMachine extends FiniteStateMachine {
-  // Inherited from parent class (getter)
-  // current = $state(<string>)
-
-  /** @type {Error|null} */
-  #error = null;
-
-  /** @type {(( state: string )=>void)|null} */
-  onenter = null;
-
-  constructor() {
-    let superCalled = false;
-    super(STATE_INITIAL, {
-      [STATE_INITIAL]: {
-        _enter: () => {
-          if (superCalled) {
-            this.onenter?.(STATE_INITIAL);
-          }
-          superCalled = true;
-        },
-        [LOAD]: STATE_LOADING
-      },
-      [STATE_LOADING]: {
-        _enter: () => {
-          // console.log('LoadingStateMachine: enter LOADING');
-          this.onenter?.(STATE_LOADING);
-        },
-        [CANCEL]: STATE_CANCELLED,
-        [ERROR]: STATE_ERROR,
-        [LOADED]: STATE_LOADED
-      },
-      [STATE_LOADED]: {
-        _enter: () => {
-          // console.log('LoadingStateMachine: enter LOADED');
-          this.onenter?.(STATE_LOADED);
-        },
-        [LOAD]: STATE_LOADING,
-        [UNLOAD]: STATE_UNLOADING
-      },
-      [STATE_UNLOADING]: {
-        _enter: () => {
-          this.onenter?.(STATE_UNLOADING);
-        },
-        [ERROR]: STATE_ERROR,
-        [INITIAL]: STATE_INITIAL
-      },
-      [STATE_CANCELLED]: {
-        _enter: () => {
-          this.onenter?.(STATE_CANCELLED);
-        },
-        [LOAD]: STATE_LOADING,
-        [UNLOAD]: STATE_UNLOADING
-      },
-      [STATE_ERROR]: {
-        _enter: ({ /*from, to, event,*/ args }) => {
-          if (args[0] instanceof Error) {
-            this.#error = args[0];
-          } else {
-            const tmp = args[0]?.error;
-            if (tmp instanceof Error) {
-              this.#error = tmp;
-            } else if (typeof tmp === 'string') {
-              this.#error = new Error(tmp);
-            } else {
-              this.#error = new Error('The state machine entered STATE_ERROR');
-            }
-          }
-
-          this.onenter?.(STATE_CANCELLED);
-        },
-        _leave: () => {
-          this.#error = null;
-        },
-        [LOAD]: STATE_LOADING,
-        [UNLOAD]: STATE_UNLOADING
-      }
-    });
-  }
-
-  /** The last error */
-  get error() {
-    return this.#error;
-  }
-}
+//import { FiniteStateMachine } from 'runed';
+
+import { FiniteStateMachine } from '../finite-state-machine/index.js';
+
+import {
+  // > States
+  STATE_INITIAL,
+  STATE_LOADING,
+  STATE_UNLOADING,
+  STATE_LOADED,
+  STATE_CANCELLED,
+  STATE_ERROR,
+
+  // > Signals
+  INITIAL,
+  LOAD,
+  CANCEL,
+  ERROR,
+  LOADED,
+  UNLOAD
+} from './constants.js';
+
+/**
+ * extends FiniteStateMachine<StatesT, EventsT>
+ */
+export default class LoadingStateMachine extends FiniteStateMachine {
+  // Inherited from parent class (getter)
+  // current = $state(<string>)
+
+  /** @type {Error|null} */
+  #error = null;
+
+  /** @type {(( state: string )=>void)|null} */
+  onenter = null;
+
+  constructor() {
+    let superCalled = false;
+    super(STATE_INITIAL, {
+      [STATE_INITIAL]: {
+        _enter: () => {
+          if (superCalled) {
+            this.onenter?.(STATE_INITIAL);
+          }
+          superCalled = true;
+        },
+        [LOAD]: STATE_LOADING
+      },
+      [STATE_LOADING]: {
+        _enter: () => {
+          // console.log('LoadingStateMachine: enter LOADING');
+          this.onenter?.(STATE_LOADING);
+        },
+        [CANCEL]: STATE_CANCELLED,
+        [ERROR]: STATE_ERROR,
+        [LOADED]: STATE_LOADED
+      },
+      [STATE_LOADED]: {
+        _enter: () => {
+          // console.log('LoadingStateMachine: enter LOADED');
+          this.onenter?.(STATE_LOADED);
+        },
+        [LOAD]: STATE_LOADING,
+        [UNLOAD]: STATE_UNLOADING
+      },
+      [STATE_UNLOADING]: {
+        _enter: () => {
+          this.onenter?.(STATE_UNLOADING);
+        },
+        [ERROR]: STATE_ERROR,
+        [INITIAL]: STATE_INITIAL
+      },
+      [STATE_CANCELLED]: {
+        _enter: () => {
+          this.onenter?.(STATE_CANCELLED);
+        },
+        [LOAD]: STATE_LOADING,
+        [UNLOAD]: STATE_UNLOADING
+      },
+      [STATE_ERROR]: {
+        _enter: ({ /*from, to, event,*/ args }) => {
+          if (args[0] instanceof Error) {
+            this.#error = args[0];
+          } else {
+            const tmp = args[0]?.error;
+            if (tmp instanceof Error) {
+              this.#error = tmp;
+            } else if (typeof tmp === 'string') {
+              this.#error = new Error(tmp);
+            } else {
+              this.#error = new Error('The state machine entered STATE_ERROR');
+            }
+          }
+
+          this.onenter?.(STATE_CANCELLED);
+        },
+        _leave: () => {
+          this.#error = null;
+        },
+        [LOAD]: STATE_LOADING,
+        [UNLOAD]: STATE_UNLOADING
+      }
+    });
+  }
+
+  /** The last error */
+  get error() {
+    return this.#error;
+  }
+}

package/dist/classes/svelte/loading-state-machine/constants.js

@@ -1,16 +1,16 @@
-export const STATE_INITIAL = 'initial';
-export const STATE_LOADING = 'loading';
-export const STATE_UNLOADING = 'unloading';
-export const STATE_LOADED = 'loaded';
-
-export const STATE_CANCELLED = 'cancelled';
-export const STATE_ERROR = 'error';
-
-// > Signals
-
-export const INITIAL = 'initial';
-export const LOAD = 'load';
-export const CANCEL = 'cancel';
-export const ERROR = 'error';
-export const LOADED = 'loaded';
-export const UNLOAD = 'unload';
+export const STATE_INITIAL = 'initial';
+export const STATE_LOADING = 'loading';
+export const STATE_UNLOADING = 'unloading';
+export const STATE_LOADED = 'loaded';
+
+export const STATE_CANCELLED = 'cancelled';
+export const STATE_ERROR = 'error';
+
+// > Signals
+
+export const INITIAL = 'initial';
+export const LOAD = 'load';
+export const CANCEL = 'cancel';
+export const ERROR = 'error';
+export const LOADED = 'loaded';
+export const UNLOAD = 'unload';

package/dist/classes/svelte/loading-state-machine/index.js

@@ -1,3 +1,3 @@
-export { default as LoadingStateMachine } from './LoadingStateMachine.svelte.js';
-
-export * from './constants.js';
+export { default as LoadingStateMachine } from './LoadingStateMachine.svelte.js';
+
+export * from './constants.js';