@hkdigital/lib-core 0.4.25 → 0.4.26

package/dist/network/loaders/audio/AudioScene.svelte.d.ts

@@ -13,6 +13,19 @@ export default class AudioScene {
     loaded: boolean;
     muted: boolean;
     targetGain: number;
+    /**
+   * Get audio scene loading progress
+   */
+    get progress(): {
+        totalBytesLoaded: number;
+        totalSize: number;
+        sourcesLoaded: number;
+        numberOfSources: number;
+    };
+    /**
+     * Start loading all audio sources
+     */
+    load(): void;
     destroy(): void;
     /**
      * Add in-memory audio source
@@ -28,16 +41,6 @@ export default class AudioScene {
         url: string;
         config?: SourceConfig;
     }): void;
-    /**
-     * Start loading all audio sources
-     */
-    load(): void;
-    /**
-     * Set an audio context to use
-     *
-     * @param {AudioContext} [audioContext]
-     */
-    setAudioContext(audioContext?: AudioContext): void;
     /**
      * Get a source that can be used to play the audio once
      *
@@ -46,6 +49,12 @@ export default class AudioScene {
      * @returns {Promise<AudioBufferSourceNode>}
      */
     getSourceNode(label: string): Promise<AudioBufferSourceNode>;
+    /**
+     * Set an audio context to use
+     *
+     * @param {AudioContext} [audioContext]
+     */
+    setAudioContext(audioContext?: AudioContext): void;
     /**
      * Set target gain
      *

package/dist/network/loaders/audio/AudioScene.svelte.js

@@ -5,10 +5,7 @@ import { LoadingStateMachine } from '../../../state/machines.js';
 import {
 	STATE_INITIAL,
 	STATE_LOADING,
-	STATE_UNLOADING,
 	STATE_LOADED,
-	STATE_CANCELLED,
-	STATE_ERROR,
 	LOAD,
 	LOADED
 } from '../../../state/machines.js';
@@ -30,10 +27,9 @@ import AudioLoader from './AudioLoader.svelte.js';
 export default class AudioScene {
 	#state = new LoadingStateMachine();
 
-	// @note this exported state is set by $effect's
+	// @note this exported state is set by onenter
 	state = $state(STATE_INITIAL);
 
-	// @note this exported state is set by $effect's
 	loaded = $derived.by(() => {
 		return this.state === STATE_LOADED;
 	});
@@ -109,47 +105,33 @@ export default class AudioScene {
 			}
 		});
 
-		$effect(() => {
-			switch (state.current) {
-				case STATE_LOADING:
-					{
-						// console.log('AudioScene:loading');
-						this.#startLoading();
-					}
-					break;
-
-				case STATE_UNLOADING:
-					{
-						// console.log('AudioScene:unloading');
-						// this.#startUnLoading();
-					}
-					break;
-
-				case STATE_LOADED:
-					{
-						// console.log('AudioScene:loaded');
-
-						// tODO
-						// this.#abortLoading = null;
-					}
-					break;
-
-				case STATE_CANCELLED:
-					{
-						// console.log('AudioScene:cancelled');
-						// TODO
-					}
-					break;
-
-				case STATE_ERROR:
-					{
-						console.error('AudioScene:error', state.error);
-					}
-					break;
-			} // end switch
+		state.onenter = ( currentState ) => {
+      // console.log('onenter', currentState );
+
+			if(currentState === STATE_LOADING )
+			{
+				// console.log('AudioScene:loading');
+				this.#startLoading();
+			}
 
 			this.state = state.current;
-		});
+		};
+	}
+
+	/* ==== Common loader interface */
+
+	/**
+   * Get audio scene loading progress
+   */
+  get progress() {
+    return this.#progress;
+  }
+
+	/**
+	 * Start loading all audio sources
+	 */
+	load() {
+		this.#state.send(LOAD);
 	}
 
 	destroy() {
@@ -157,6 +139,8 @@ export default class AudioScene {
 		// TODO: Unload AUdioLoaders?
 	}
 
+	/* ==== Source definitions */
+
 	/**
 	 * Add in-memory audio source
 	 * - Uses an AudioLoader instance to load audio data from network
@@ -175,36 +159,7 @@ export default class AudioScene {
 		this.#memorySources.push({ label, audioLoader, config });
 	}
 
-	/**
-	 * Start loading all audio sources
-	 */
-	load() {
-		this.#state.send(LOAD);
-
-		// FIXME: in unit test when moved to startloading it hangs!
-
-		for (const { audioLoader } of this.#memorySources) {
-			audioLoader.load();
-		}
-	}
-
-	/**
- 	 * Set an audio context to use
- 	 *
-	 * @param {AudioContext} [audioContext]
-	 */
-	setAudioContext( audioContext ) {
-		this.#audioContext = audioContext;
-	}
-
-	async #startLoading() {
-		// console.log('#startLoading');
-
-		// FIXME: in unit test when moved to startloading it hangs!
-		// for (const { audioLoader } of this.#memorySources) {
-		//   audioLoader.load();
-		// }
-	}
+	/* ==== Resource access */
 
 	/**
 	 * Get a source that can be used to play the audio once
@@ -240,6 +195,25 @@ export default class AudioScene {
 		return sourceNode;
 	}
 
+	/**
+ 	 * Set an audio context to use
+ 	 *
+	 * @param {AudioContext} [audioContext]
+	 */
+	setAudioContext( audioContext ) {
+		this.#audioContext = audioContext;
+	}
+
+	async #startLoading() {
+		// console.log('#startLoading');
+
+		for (const { audioLoader } of this.#memorySources) {
+		  audioLoader.load();
+		}
+	}
+
+	/* ==== Audio specific */
+
 	/**
 	 * Set target gain
 	 *
@@ -281,6 +255,7 @@ export default class AudioScene {
 		this.setTargetGain(this.#unmutedTargetGain);
 	}
 
+	/* ==== Internals */
 
 	#getGainNode()
 	{
@@ -322,4 +297,4 @@ export default class AudioScene {
 
 		throw new Error(`Source [${label}] has not been defined`);
 	}
-}
+} // end class

package/dist/network/loaders/image/ImageScene.svelte.d.ts

@@ -10,6 +10,19 @@
 export default class ImageScene {
     state: string;
     loaded: boolean;
+    /**
+     * Get image scene loading progress
+     */
+    get progress(): {
+        totalBytesLoaded: number;
+        totalSize: number;
+        sourcesLoaded: number;
+        numberOfSources: number;
+    };
+    /**
+     * Start loading all image sources
+     */
+    load(): void;
     destroy(): void;
     /**
      * Add image source
@@ -23,19 +36,6 @@ export default class ImageScene {
         label: string;
         imageSource: import("../../../config/typedef.js").ImageSource;
     }): void;
-    /**
-     * Start loading all image sources
-     */
-    load(): void;
-    /**
-     * Get image scene loading progress
-     */
-    get progress(): {
-        totalBytesLoaded: number;
-        totalSize: number;
-        sourcesLoaded: number;
-        numberOfSources: number;
-    };
     /**
      * Get an image loader
      *

package/dist/network/loaders/image/ImageScene.svelte.js

@@ -7,10 +7,7 @@ import { LoadingStateMachine } from '../../../state/machines.js';
 import {
   STATE_INITIAL,
   STATE_LOADING,
-  STATE_UNLOADING,
   STATE_LOADED,
-  STATE_CANCELLED,
-  STATE_ERROR,
   LOAD,
   LOADED
 } from '../../../state/machines.js';
@@ -31,10 +28,9 @@ import ImageLoader from './ImageLoader.svelte.js';
 export default class ImageScene {
   #state = new LoadingStateMachine();
 
-  // @note this exported state is set by $effect's
+  // @note this exported state is set by onenter
   state = $state(STATE_INITIAL);
 
-  // @note this exported state is set by $effect's
   loaded = $derived.by(() => {
     return this.state === STATE_LOADED;
   });
@@ -92,55 +88,42 @@ export default class ImageScene {
       }
     } );
 
-    state.onenter = ( state ) => {
-      // console.log('onenter', state );
-
-      switch (state) {
-        case STATE_LOADING:
-          {
-            // console.log('ImageScene:loading');
-            this.#startLoading();
-          }
-          break;
-
-        case STATE_UNLOADING:
-          {
-            // console.log('ImageScene:unloading');
-            // this.#startUnLoading();
-          }
-          break;
-
-        case STATE_LOADED:
-          {
-            // console.log('ImageScene:loaded');
-            // TODO
-            // this.#abortLoading = null;
-          }
-          break;
-
-        case STATE_CANCELLED:
-          {
-            // console.log('ImageScene:cancelled');
-            // TODO
-          }
-          break;
-
-        case STATE_ERROR:
-          {
-            console.log('ImageScene:error', state);
-          }
-          break;
-      } // end switch
-
-      this.state = state;
+    state.onenter = ( currentState ) => {
+      // console.log('onenter', currentState );
+
+      if(currentState === STATE_LOADING )
+      {
+        // console.log('ImageScene:loading');
+        this.#startLoading();
+      }
+
+      this.state = currentState;
     };
   }
 
+  /* ==== Common loader interface */
+
+  /**
+   * Get image scene loading progress
+   */
+  get progress() {
+    return this.#progress;
+  }
+
+  /**
+   * Start loading all image sources
+   */
+  load() {
+    this.#state.send(LOAD);
+  }
+
   destroy() {
     // TODO: disconnect all image sources?
     // TODO: Unload ImageLoaders?
   }
 
+  /* ==== Source definitions */
+
   /**
    * Add image source
    * - Uses an ImageLoader instance to load image data from network
@@ -159,42 +142,7 @@ export default class ImageScene {
     this.#imageSources.push({ label, imageLoader });
   }
 
-  /**
-   * Start loading all image sources
-   */
-  load() {
-    this.#state.send(LOAD);
-  }
-
-  async #startLoading() {
-    for (const { imageLoader } of this.#imageSources) {
-      imageLoader.load();
-    }
-  }
-
-  /**
-   * Get Image source
-   *
-   * @param {string} label
-   *
-   * @returns {ImageSceneSource}
-   */
-  #getImageSceneSource(label) {
-    for (const source of this.#imageSources) {
-      if (label === source.label) {
-        return source;
-      }
-    }
-
-    throw new Error(`Source [${label}] has not been defined`);
-  }
-
-  /**
-   * Get image scene loading progress
-   */
-  get progress() {
-    return this.#progress;
-  }
+  /* ==== Resource access */
 
   /**
    * Get an image loader
@@ -236,4 +184,29 @@ export default class ImageScene {
 
     return source.imageLoader.getObjectURL();
   }
-}
+
+  async #startLoading() {
+    for (const { imageLoader } of this.#imageSources) {
+      imageLoader.load();
+    }
+  }
+
+  /* ==== Internals */
+
+  /**
+   * Get Image source
+   *
+   * @param {string} label
+   *
+   * @returns {ImageSceneSource}
+   */
+  #getImageSceneSource(label) {
+    for (const source of this.#imageSources) {
+      if (label === source.label) {
+        return source;
+      }
+    }
+
+    throw new Error(`Source [${label}] has not been defined`);
+  }
+} // end class

package/dist/network/states/NetworkLoader.svelte.js

@@ -90,10 +90,6 @@ export default class NetworkLoader {
     const state = this._state;
     // const progress = this.progress;
 
-    //
-    // ISSUE: $effect is not triggered by  this._state changes,
-    //        using onenter instead
-    //
     this._state.onenter = () => {
       switch (state.current) {
         case STATE_LOADING:

package/dist/state/machines/finite-state-machine/FiniteStateMachine.svelte.d.ts

@@ -1,4 +1,4 @@
-/** @typedef {import('./typedef.js').StateTransitionMetadata} StateTransitionMetadata */
+/** @typedef {import('./typedef.js').TransitionData} TransitionData */
 /** @typedef {import('./typedef.js').OnEnterCallback} OnEnterCallback */
 /** @typedef {import('./typedef.js').OnExitCallback} OnExitCallback */
 /**
@@ -50,7 +50,7 @@ export default class FiniteStateMachine extends EventEmitter {
     get current(): any;
     #private;
 }
-export type StateTransitionMetadata = import("./typedef.js").StateTransitionMetadata;
+export type TransitionData = import("./typedef.js").TransitionData;
 export type OnEnterCallback = import("./typedef.js").OnEnterCallback;
 export type OnExitCallback = import("./typedef.js").OnExitCallback;
 import EventEmitter from '../../../generic/events/classes/EventEmitter.js';

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

@@ -8,7 +8,7 @@ import { isTestEnv } from '../../../util/env.js';
 import EventEmitter from '../../../generic/events/classes/EventEmitter.js';
 import { ENTER, EXIT } from './constants.js';
 
-/** @typedef {import('./typedef.js').StateTransitionMetadata} StateTransitionMetadata */
+/** @typedef {import('./typedef.js').TransitionData} TransitionData */
 /** @typedef {import('./typedef.js').OnEnterCallback} OnEnterCallback */
 /** @typedef {import('./typedef.js').OnExitCallback} OnExitCallback */
 
@@ -57,17 +57,17 @@ export default class FiniteStateMachine extends EventEmitter {
     this.states = states;
 
     // synthetically trigger _enter for the initial state.
-    const initialMetadata = {
+    const initialTransitionData = {
       from: null,
       to: initial,
       event: null,
       args: []
     };
 
-    this.#executeAction('_enter', initialMetadata);
+    this.#executeAction('_enter', initialTransitionData);
 
     // Emit ENTER event for external listeners for initial state
-    this.emit(ENTER, { state: initial, metadata: initialMetadata });
+    this.emit(ENTER, { state: initial, transition: initialTransitionData });
   }
 
   /**
@@ -78,24 +78,24 @@ export default class FiniteStateMachine extends EventEmitter {
    * @param {any[]} [args]
    */
   #transition(newState, event, args) {
-    /** @type {StateTransitionMetadata} */
-    const metadata = { from: this.#current, to: newState, event, args };
+    /** @type {TransitionData} */
+    const transition = { from: this.#current, to: newState, event, args };
 
     // Call onexit callback before leaving current state
-    this.onexit?.(this.#current, metadata);
+    this.onexit?.(this.#current, transition);
 
     // Emit EXIT event for external listeners
-    this.emit(EXIT, { state: this.#current, metadata });
+    this.emit(EXIT, { state: this.#current, transition });
 
-    this.#executeAction('_exit', metadata);
+    this.#executeAction('_exit', transition);
     this.#current = newState;
-    this.#executeAction('_enter', metadata);
+    this.#executeAction('_enter', transition);
 
     // Emit ENTER event for external listeners
-    this.emit(ENTER, { state: newState, metadata });
+    this.emit(ENTER, { state: newState, transition });
 
     // Call onenter callback after state change
-    this.onenter?.(newState, metadata);
+    this.onenter?.(newState, transition);
   }
 
   /**
@@ -116,7 +116,7 @@ export default class FiniteStateMachine extends EventEmitter {
           if (isLifecycleFnMeta(args[0])) {
             return action(args[0]);
           } else {
-            throw new Error(`Invalid metadata passed to lifecycle function`);
+            throw new Error(`Invalid transition data passed to lifecycle function`);
           }
 
         // Normal state events

package/dist/state/machines/finite-state-machine/README.md

@@ -56,16 +56,16 @@ Each state can define:
 ```javascript
 const machine = new FiniteStateMachine('idle', {
   idle: {
-    _enter: (metadata) => {
+    _enter: (transition) => {
       console.log('Entered idle state');
     },
-    _exit: (metadata) => {
+    _exit: (transition) => {
       console.log('Leaving idle state');
     },
     start: 'running'
   },
   running: {
-    _enter: (metadata) => {
+    _enter: (transition) => {
       console.log('Started running');
     },
     stop: 'idle'
@@ -73,14 +73,14 @@ const machine = new FiniteStateMachine('idle', {
 });
 ```
 
-## Callback Metadata
+## Callback TransitionData
 
-Enter and exit callbacks receive metadata about the transition:
+Enter and exit callbacks receive transition data about the state change:
 
 ```javascript
-/** @typedef {import('./typedef.js').StateTransitionMetadata} StateTransitionMetadata */
+/** @typedef {import('./typedef.js').TransitionData} TransitionData */
 
-// Metadata structure:
+// TransitionData structure:
 {
   from: 'previousState',    // State being exited
   to: 'newState',          // State being entered
@@ -94,18 +94,18 @@ Enter and exit callbacks receive metadata about the transition:
 For better type safety, import the type definitions:
 
 ```javascript
-/** @typedef {import('./typedef.js').StateTransitionMetadata} StateTransitionMetadata */
+/** @typedef {import('./typedef.js').TransitionData} TransitionData */
 /** @typedef {import('./typedef.js').OnEnterCallback} OnEnterCallback */
 /** @typedef {import('./typedef.js').OnExitCallback} OnExitCallback */
 
 /** @type {OnEnterCallback} */
-const handleEnter = (state, metadata) => {
-  console.log(`Entering ${state} from ${metadata.from}`);
+const handleEnter = (currentState, transition) => {
+  console.log(`Entering ${currentState} from ${transition.from}`);
 };
 
 /** @type {OnExitCallback} */
-const handleExit = (state, metadata) => {
-  console.log(`Leaving ${state} to ${metadata.to}`);
+const handleExit = (currentState, transition) => {
+  console.log(`Leaving ${currentState} to ${transition.to}`);
 };
 
 machine.onenter = handleEnter;
@@ -209,8 +209,8 @@ const machine = new FiniteStateMachine('idle', {
   error: { retry: 'loading', reset: 'idle' }
 });
 
-machine.onexit = (state, metadata) => {
-  switch (state) {
+machine.onexit = (currentState, transition) => {
+  switch (currentState) {
     case 'loading':
       console.log('Leaving loading state...');
       // Cancel ongoing requests
@@ -224,8 +224,8 @@ machine.onexit = (state, metadata) => {
   }
 };
 
-machine.onenter = (state, metadata) => {
-  switch (state) {
+machine.onenter = (currentState, transition) => {
+  switch (currentState) {
     case 'loading':
       console.log('Started loading...');
       showSpinner();
@@ -236,7 +236,7 @@ machine.onenter = (state, metadata) => {
       break;
     case 'error':
       console.log('Loading failed');
-      showError(metadata.args[0]);
+      showError(transition.args[0]);
       break;
   }
 };
@@ -264,8 +264,8 @@ const machine = new FiniteStateMachine('idle', {
   }
 });
 
-machine.onexit = (state) => console.log(`3. onexit ${state}`);
-machine.onenter = (state) => console.log(`6. onenter ${state}`);
+machine.onexit = (currentState) => console.log(`3. onexit ${currentState}`);
+machine.onenter = (currentState) => console.log(`6. onenter ${currentState}`);
 
 // Initial state triggers _enter and onenter
 // Output:
@@ -313,8 +313,8 @@ machine.onexit = (state) => {
   }
 };
 
-machine.onenter = (state) => {
-  switch (state) {
+machine.onenter = (label) => {
+  switch (label) {
     case 'loading':
       this.#startProcess(); // Start async process immediately
       break;
@@ -381,8 +381,8 @@ export default class TaskProcessor {
 
   constructor() {
     // onexit: Handle cleanup when leaving states
-    this.#machine.onexit = (state) => {
-      switch (state) {
+    this.#machine.onexit = (currentState) => {
+      switch (currentState) {
         case 'processing':
           this.#cancelTasks(); // Cancel ongoing tasks if interrupted
           break;
@@ -390,8 +390,8 @@ export default class TaskProcessor {
     };
 
     // onenter: Handle immediate state actions
-    this.#machine.onenter = (state) => {
-      switch (state) {
+    this.#machine.onenter = (currentState) => {
+      switch (currentState) {
         case 'processing':
           this.#startAllTasks(); // Start processing immediately
           break;
@@ -399,7 +399,7 @@ export default class TaskProcessor {
           this.#notifyComplete(); // Cleanup/notify when done
           break;
       }
-      this.state = state;
+      this.state = currentState;
     };
 
     // $effect: Monitor reactive completion
@@ -435,8 +435,8 @@ export default class TaskProcessor {
   });
 
   // Handle state-specific actions
-  machine.onexit = (state) => {
-    switch (state) {
+  machine.onexit = (currentState) => {
+    switch (currentState) {
       case 'loading':
         // Cancel any ongoing requests
         cancelRequests();
@@ -444,8 +444,8 @@ export default class TaskProcessor {
     }
   };
 
-  machine.onenter = (state) => {
-    switch (state) {
+  machine.onenter = (currentState) => {
+    switch (currentState) {
       case 'loading':
         loadData();
         break;
@@ -526,7 +526,7 @@ const auth = new FiniteStateMachine('anonymous', {
     failure: 'anonymous'
   },
   authenticated: {
-    _enter: (meta) => console.log('Welcome!'),
+    _enter: (transition) => console.log('Welcome!'),
     logout: 'anonymous',
     expire: 'anonymous'
   }

package/dist/state/machines/finite-state-machine/typedef.d.ts

@@ -1,7 +1,7 @@
 /**
  * Metadata object passed to state transition callbacks
  */
-export type StateTransitionMetadata = {
+export type TransitionData = {
     /**
      * - The state being exited
      */
@@ -22,8 +22,8 @@ export type StateTransitionMetadata = {
 /**
  * Callback function called when entering a state
  */
-export type OnEnterCallback = (arg0: string, arg1: StateTransitionMetadata) => void;
+export type OnEnterCallback = (currentState: string, transition: TransitionData) => void;
 /**
  * Callback function called when exiting a state
  */
-export type OnExitCallback = (arg0: string, arg1: StateTransitionMetadata) => void;
+export type OnExitCallback = (currentState: string, transition: TransitionData) => void;

package/dist/state/machines/finite-state-machine/typedef.js

@@ -5,24 +5,30 @@
 /**
  * Metadata object passed to state transition callbacks
  *
- * @typedef {object} StateTransitionMetadata
+ * @typedef {object} TransitionData
  * @property {string} from - The state being exited
  * @property {string} to - The state being entered
  * @property {string} event - The event that triggered the transition
  * @property {any[]} args - Arguments passed to the send() method
  */
 
-/**
- * Callback function called when entering a state
- *
- * @typedef {function(string, StateTransitionMetadata): void} OnEnterCallback
- */
+  /**
+   * Callback function called when entering a state
+   *
+   * @callback OnEnterCallback
+   * @param {string} currentState - The state being entered
+   * @param {TransitionData} transition - Details about the transition
+   * @returns {void}
+   */
 
-/**
- * Callback function called when exiting a state
- *
- * @typedef {function(string, StateTransitionMetadata): void} OnExitCallback
- */
+  /**
+   * Callback function called when exiting a state
+   *
+   * @callback OnExitCallback
+   * @param {string} currentState - The state being exited
+   * @param {TransitionData} transition - Details about the transition
+   * @returns {void}
+   */
 
-// Export types for external use (this is just for JSDoc, no actual exports needed)
+// Export types for JSdoc
 export {};

package/dist/state/machines/loading-state-machine/README.md

@@ -108,8 +108,8 @@ The `onenter` callback provides a reliable way to react to state changes, design
 ```javascript
 const loader = new LoadingStateMachine();
 
-loader.onenter = (state) => {
-  switch (state) {
+loader.onenter = (currentState) => {
+  switch (currentState) {
     case STATE_LOADING:
       console.log('Started loading...');
       showSpinner();
@@ -141,8 +141,8 @@ $effect(() => {
 });
 
 // onenter catches every transition
-loader.onenter = (state) => {
-  console.log(state); // Sees every state change
+loader.onenter = (currentState) => {
+  console.log(currentState); // Sees every state change
 };
 ```
 
@@ -188,8 +188,8 @@ const timeoutId = setTimeout(() => {
   }
 }, 10000); // 10 second timeout
 
-loader.onenter = (state) => {
-  switch (state) {
+loader.onenter = (currentState) => {
+  switch (currentState) {
     case STATE_TIMEOUT:
       console.log('Loading timed out');
       showRetryButton();
@@ -220,8 +220,8 @@ LoadingStateMachine inherits the `onenter` callback and Svelte reactivity integr
 ```javascript
 const loader = new LoadingStateMachine();
 
-loader.onenter = (state) => {
-  switch (state) {
+loader.onenter = (currentState) => {
+  switch (currentState) {
     case STATE_LOADING:
       this.#startLoading(); // Start async process immediately
       break;
@@ -267,8 +267,8 @@ export default class MultiSourceLoader {
 
   constructor() {
     // Handle immediate loading state actions
-    this.#loader.onenter = (state) => {
-      switch (state) {
+    this.#loader.onenter = (currentState) => {
+      switch (currentState) {
         case STATE_LOADING:
           this.#startAllSources();
           break;
@@ -282,7 +282,7 @@ export default class MultiSourceLoader {
           this.#handleTimeout();
           break;
       }
-      this.state = state;
+      this.state = currentState;
     };
 
     // Monitor reactive completion
@@ -319,8 +319,8 @@ export default class MultiSourceLoader {
   const loader = new LoadingStateMachine();
   let data = $state(null);
   
-  loader.onenter = (state) => {
-    if (state === STATE_LOADING) {
+  loader.onenter = (currentState) => {
+    if (currentState === STATE_LOADING) {
       loadData();
     }
   };
@@ -371,8 +371,8 @@ export default class MultiSourceLoader {
   const loader = new LoadingStateMachine();
   let abortController = null;
   
-  loader.onenter = (state) => {
-    switch (state) {
+  loader.onenter = (currentState) => {
+    switch (currentState) {
       case STATE_LOADING:
         startLoad();
         break;
@@ -426,8 +426,8 @@ export default class MultiSourceLoader {
 
 ```javascript
 // ✅ Good - use onenter for reliable side effects
-loader.onenter = (state) => {
-  if (state === STATE_LOADING) {
+loader.onenter = (currentState) => {
+  if (currentState === STATE_LOADING) {
     analytics.track('loading_started');
   }
 };
@@ -443,8 +443,8 @@ $effect(() => {
 ### 2. Handle All Error States
 
 ```javascript
-loader.onenter = (state) => {
-  switch (state) {
+loader.onenter = (currentState) => {
+  switch (currentState) {
     case STATE_ERROR:
       showErrorToast(loader.error.message);
       logError(loader.error);
@@ -459,8 +459,8 @@ loader.onenter = (state) => {
 ### 3. Implement Proper Cleanup
 
 ```javascript
-loader.onenter = (state) => {
-  switch (state) {
+loader.onenter = (currentState) => {
+  switch (currentState) {
     case STATE_LOADING:
       showProgressBar();
       break;
@@ -500,8 +500,8 @@ loader.send('load');
 const resourceLoader = new LoadingStateMachine();
 let resource = null;
 
-resourceLoader.onenter = async (state) => {
-  switch (state) {
+resourceLoader.onenter = async (currentState) => {
+  switch (currentState) {
     case STATE_LOADING:
       try {
         resource = await loadResource();
@@ -529,8 +529,8 @@ const retryLoader = new LoadingStateMachine();
 let retryCount = 0;
 const maxRetries = 3;
 
-retryLoader.onenter = async (state) => {
-  switch (state) {
+retryLoader.onenter = async (currentState) => {
+  switch (currentState) {
     case STATE_LOADING:
       try {
         await performLoad();

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@hkdigital/lib-core",
-	"version": "0.4.25",
+	"version": "0.4.26",
 	"author": {
 		"name": "HKdigital",
 		"url": "https://hkdigital.nl"