@hkdigital/lib-core 0.5.51 → 0.5.52

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

@@ -111,20 +111,13 @@ export default class PageMachine {
      * Synchronize machine state with URL path
      *
      * Call this in a $effect that watches $page.url.pathname
-     * Automatically tracks visited states
+     * Automatically tracks visited states and triggers onEnter hooks
      *
      * @param {string} currentPath - Current URL pathname
      *
      * @returns {boolean} True if state was changed
      */
     syncFromPath(currentPath: string): boolean;
-    /**
-     * Set the current state directly
-     * Handles onEnter hooks and auto-transitions
-     *
-     * @param {string} newState - Target state
-     */
-    setState(newState: string): Promise<void>;
     /**
      * Get route path for a given state
      *

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

@@ -241,7 +241,7 @@ export default class PageMachine {
 	 * Synchronize machine state with URL path
 	 *
 	 * Call this in a $effect that watches $page.url.pathname
-	 * Automatically tracks visited states
+	 * Automatically tracks visited states and triggers onEnter hooks
 	 *
 	 * @param {string} currentPath - Current URL pathname
 	 *
@@ -251,14 +251,12 @@ export default class PageMachine {
 		const targetState = this.#getStateFromPath(currentPath);
 
 		if (targetState && targetState !== this.#current) {
-			// const oldState = this.#current;
-			this.#current = targetState;
-			this.#visitedStates.add(targetState);
-			this.#revision++;
-
 			// Log state transition from URL sync
 			this.logger?.debug(`syncFromPath: ${currentPath} → targetState: ${targetState}`);
 
+			// Use #setState to handle onEnter hooks
+			this.#setState(targetState);
+
 			return true;
 		}
 
@@ -266,12 +264,16 @@ export default class PageMachine {
 	}
 
 	/**
-	 * Set the current state directly
+	 * Set the current state directly (internal use only)
 	 * Handles onEnter hooks and auto-transitions
 	 *
+	 * Note: This is private to enforce URL-first navigation.
+	 * To change state, navigate to the URL using switchToPage()
+	 * and let syncFromPath() update the state.
+	 *
 	 * @param {string} newState - Target state
 	 */
-	async setState(newState) {
+	async #setState(newState) {
 		if (newState === this.#current || this.#isTransitioning) {
 			return;
 		}
@@ -301,7 +303,7 @@ export default class PageMachine {
 				if (!doneCalled && nextState && nextState !== newState) {
 					doneCalled = true;
 					this.#isTransitioning = false;
-					this.setState(nextState);
+					this.#setState(nextState);
 				}
 			};
 

package/package.json

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