@inglorious/web 6.4.1 → 6.5.0

package/README.md

@@ -1290,10 +1290,12 @@ const renderApp = (api) => {
       <p>Loading: ${geolocation.isLoading ? "yes" : "no"}</p>
       <p>
         Position:
-        ${position
-          ? html`${position.coords.latitude.toFixed(4)},
-            ${position.coords.longitude.toFixed(4)}`
-          : "unknown"}
+        ${
+          position
+            ? html`${position.coords.latitude.toFixed(4)},
+              ${position.coords.longitude.toFixed(4)}`
+            : "unknown"
+        }
       </p>
       <p>Error: ${geolocation.error ? geolocation.error.message : "none"}</p>
       <button
@@ -1383,9 +1385,11 @@ const renderApp = (api) => {
       <p>Active: ${compass.isCompassActive ? "yes" : "no"}</p>
       <p>
         Heading:
-        ${compass.heading !== null
-          ? `${compass.heading.toFixed(1)}°`
-          : "unknown"}
+        ${
+          compass.heading !== null
+            ? `${compass.heading.toFixed(1)}°`
+            : "unknown"
+        }
       </p>
       <p>Error: ${compass.error ? compass.error.message : "none"}</p>
       <button @click=${() => api.notify("compassPermissionsRequest")}>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inglorious/web",
-  "version": "6.4.1",
+  "version": "6.5.0",
   "description": "A new web framework that leverages the power of the Inglorious Store combined with the performance and simplicity of lit-html.",
   "author": "Matteo Antony Mistretta <antony.mistretta@gmail.com> (https://ingloriouscoderz.it)",
   "contributors": [
@@ -104,17 +104,17 @@
   },
   "sideEffects": false,
   "dependencies": {
-    "@inglorious/utils": "3.8.0",
+    "@inglorious/utils": "4.0.0",
     "@lit-labs/ssr-client": "^1.1.8",
-    "lit-html": "^3.3.1"
+    "lit-html": "^3.3.3"
   },
   "peerDependencies": {
-    "@inglorious/store": "11.0.1"
+    "@inglorious/store": "11.0.2"
   },
   "devDependencies": {
     "@inglorious/eslint-config": "1.1.2",
-    "prettier": "^3.6.2",
-    "vitest": "^4.0.15"
+    "prettier": "^3.9.6",
+    "vitest": "^5.0.0"
   },
   "engines": {
     "node": ">= 22"

package/src/decorators/with-debounce/index.js

@@ -1,4 +1,4 @@
-import { debounce } from "@inglorious/utils/functions/functions.js"
+import { debounce } from "@inglorious/utils/functions"
 
 /**
  * Wraps selected event handlers of a type with debouncing, scoped per-entity.

package/src/decorators/with-throttle/index.js

@@ -1,4 +1,4 @@
-import { throttle } from "@inglorious/utils/functions/functions.js"
+import { throttle } from "@inglorious/utils/functions"
 
 /**
  * Wraps selected event handlers of a type with throttling, scoped per-entity.

package/src/form/handlers.js

@@ -1,4 +1,4 @@
-import { clone, get, set } from "@inglorious/utils/data-structures/object.js"
+import { clone, get, set } from "@inglorious/utils/object.js"
 
 /**
  * @typedef {import('../../types/form.js').FormEntity} FormEntity

package/src/form/helpers.js

@@ -1,4 +1,4 @@
-import { get } from "@inglorious/utils/data-structures/object.js"
+import { get } from "@inglorious/utils/object.js"
 
 /**
  * Retrieves the validation error for a specific form field.

package/src/router/handlers.js

@@ -8,6 +8,8 @@ import { toCamelCase } from "@inglorious/utils/data-structures/string.js"
 
 const SKIP_FULL_MATCH_GROUP = 1 // .match() result at index 0 is the full string
 const REMOVE_COLON_PREFIX = 1
+const FIRST_HISTORY_INDEX = 0 // The entry an app starts on, and the fallback for an entry that carries no index.
+const PUSH_HISTORY_STEP = 1 // How far a push advances the index. A replacement leaves it where it is.
 
 export function createHandlers(routeConfig) {
   /**
@@ -25,6 +27,18 @@ export function createHandlers(routeConfig) {
      * @param {Api} api - The application API.
      */
     init(entity, payload, api) {
+      /* Stamp the entry the app starts on, so that reloading keeps the app in
+         its place in the session history instead of restarting the count.
+         `withTransitions` reads this index back to tell a push from a traversal
+         and in which direction, so it has to be set before anything navigates. */
+      if (window.history.state?.idx == null) {
+        window.history.replaceState(
+          { ...window.history.state, idx: FIRST_HISTORY_INDEX },
+          "",
+        )
+      }
+      entity.idx = window.history.state?.idx ?? FIRST_HISTORY_INDEX
+
       // Handle initial route
       const { pathname, search } = window.location
       const initialPath = pathname + search
@@ -107,6 +121,9 @@ export function createHandlers(routeConfig) {
         }
 
         updateRouter(entity, route)
+        // Adopt the index of the entry just traversed, so the next push counts
+        // from where the history actually is rather than from where it was.
+        entity.idx = window.history.state?.idx ?? FIRST_HISTORY_INDEX
 
         api.notify("routeChange", {
           route: entity.route,
@@ -184,6 +201,10 @@ export function createHandlers(routeConfig) {
       // Prepare history state
       const historyState = {
         ...state,
+        /* Written before the notification that triggers the render, so that
+           anything reading the history entry during that render sees the new
+           index. `withTransitions` depends on this ordering. */
+        idx: replace ? entity.idx : entity.idx + PUSH_HISTORY_STEP,
         route: entity.route,
         params: entity.params,
         query: entity.query,
@@ -193,6 +214,9 @@ export function createHandlers(routeConfig) {
       // Navigate
       const method = replace ? "replaceState" : "pushState"
       history[method](historyState, "", path)
+      // Advance the counter as well as stamping the entry, or the next push
+      // writes the same index and reads as a replacement.
+      entity.idx = historyState.idx
 
       api.notify("routeChange", historyState)
     },

package/types/decorators/with-debounce.d.ts

@@ -3,8 +3,7 @@ import { Api } from "../mount"
 export interface DebounceBehavior {
   destroy?: (entity: any, payload?: any, api?: Api) => void
   [handlerName: string]:
-    | ((entity: any, payload?: any, api?: Api) => void)
-    | undefined
+    ((entity: any, payload?: any, api?: Api) => void) | undefined
 }
 
 export declare function withDebounce(

package/types/decorators/with-throttle.d.ts

@@ -7,8 +7,7 @@ export interface ThrottleOptions {
 export interface ThrottleBehavior {
   destroy?: (entity: any, payload?: any, api?: Api) => void
   [handlerName: string]:
-    | ((entity: any, payload?: any, api?: Api) => void)
-    | undefined
+    ((entity: any, payload?: any, api?: Api) => void) | undefined
 }
 
 export declare function withThrottle(