@hkdigital/lib-core 0.5.47 → 0.5.49

package/dist/state/machines/page-machine/PageMachine.svelte.d.ts

@@ -69,6 +69,8 @@ export default class PageMachine {
      *   Initial data properties (from server)
      * @param {Record<string, Function>} [config.onEnterHooks={}]
      *   Map of states to onEnter hook functions
+     * @param {import('../../../logging/client.js').Logger} [config.logger]
+     *   Logger instance (optional, if not provided no logging occurs)
      *
      * @example
      * ```javascript
@@ -93,12 +95,18 @@ export default class PageMachine {
      * });
      * ```
      */
-    constructor({ startPath, routeMap, initialData, onEnterHooks }: {
+    constructor({ startPath, routeMap, initialData, onEnterHooks, logger }: {
         startPath: string;
         routeMap?: Record<string, string> | undefined;
         initialData?: Record<string, any> | undefined;
         onEnterHooks?: Record<string, Function> | undefined;
+        logger?: import("../../../logging/client.js").Logger | undefined;
     });
+    /**
+     * Logger instance for state machine
+     * @type {import('../../../logging/client.js').Logger}
+     */
+    logger: import("../../../logging/client.js").Logger;
     /**
      * Synchronize machine state with URL path
      *

package/dist/state/machines/page-machine/PageMachine.svelte.js

@@ -1,3 +1,6 @@
+import { INFO } from '../../../logging/common.js';
+import { createClientLogger } from '../../../logging/client.js';
+
 /**
  * Base class for page state machines with URL route mapping
  *
@@ -57,6 +60,11 @@
  * ```
  */
 export default class PageMachine {
+	/**
+	 * Logger instance for state machine
+	 * @type {import('../../../logging/client.js').Logger}
+	 */
+	logger;
 	/**
 	 * Current state
 	 * @type {string}
@@ -145,6 +153,8 @@ export default class PageMachine {
 	 *   Initial data properties (from server)
 	 * @param {Record<string, Function>} [config.onEnterHooks={}]
 	 *   Map of states to onEnter hook functions
+	 * @param {import('../../../logging/client.js').Logger} [config.logger]
+	 *   Logger instance (optional, if not provided no logging occurs)
 	 *
 	 * @example
 	 * ```javascript
@@ -169,11 +179,18 @@ export default class PageMachine {
 	 * });
 	 * ```
 	 */
-	constructor({ startPath, routeMap = {}, initialData = {}, onEnterHooks = {} }) {
+	constructor({
+		startPath,
+		routeMap = {},
+		initialData = {},
+		onEnterHooks = {},
+		logger = null
+	}) {
 		if (!startPath) {
 			throw new Error('PageMachine requires startPath parameter');
 		}
 
+		this.logger = logger;
 		this.#startPath = startPath;
 		this.#routeMap = routeMap;
 		this.#data = initialData;
@@ -263,10 +280,14 @@ export default class PageMachine {
 		this.#currentOnEnterHandler = null;
 		this.#currentOnEnterDone = null;
 
+		const oldState = this.#current;
 		this.#isTransitioning = true;
 		this.#current = newState;
 		this.#visitedStates.add(newState);
 
+		// Log state transition
+		this.logger?.debug(`${oldState} → ${newState}`);
+
 		// Check if this state has an onEnter hook
 		const hookConfig = this.#onEnterHooks[newState];
 		if (hookConfig?.onEnter) {

package/package.json

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