@inglorious/web 6.4.0 → 6.4.2

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.0",
+  "version": "6.4.2",
   "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": "4.0.0",
     "@lit-labs/ssr-client": "^1.1.8",
-    "lit-html": "^3.3.1",
-    "@inglorious/utils": "3.8.0"
+    "lit-html": "^3.3.3"
   },
   "peerDependencies": {
-    "@inglorious/store": "11.0.0"
+    "@inglorious/store": "11.0.2"
   },
   "devDependencies": {
-    "prettier": "^3.6.2",
-    "vitest": "^4.0.15",
-    "@inglorious/eslint-config": "1.1.2"
+    "@inglorious/eslint-config": "1.1.2",
+    "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/objects"
 
 /**
  * @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/objects"
 
 /**
  * Retrieves the validation error for a specific form field.

package/src/mount.js

@@ -5,32 +5,6 @@
 
 import { html, render } from "lit-html"
 
-/**
- * Root-level error boundary. Unlike the per-entity `withErrorBoundary`
- * decorator (which isolates a single failing type's render), this catches
- * errors thrown by the *root* render function itself — before any entity is
- * reached (e.g. a missing router entity), or by an unguarded child.
- *
- * Without it, a throwing root render takes down the whole app: on the initial
- * pass it aborts the mount, and inside the store subscription it throws out of
- * the notify loop on every subsequent update, freezing the UI. Catching it
- * keeps the subscription alive so one bad tick can't kill the app.
- *
- * @param {(api: Api) => TemplateResult | null} renderFn
- * @param {Api} api
- * @param {(error: unknown, api: Api) => void} onError
- * @param {((error: unknown, api: Api) => TemplateResult | null) | undefined} fallback
- * @returns {{ ok: true, template: TemplateResult | null } | { ok: false, fallback: TemplateResult | null }}
- */
-function renderRoot(renderFn, api, onError, fallback) {
-  try {
-    return { ok: true, template: renderFn(api) }
-  } catch (error) {
-    onError(error, api)
-    return { ok: false, fallback: fallback ? fallback(error, api) : null }
-  }
-}
-
 /**
  * Mounts a lit-html template to the DOM and subscribes to a store for re-rendering.
  * @param {Store} store - The application state store.
@@ -44,12 +18,16 @@ function renderRoot(renderFn, api, onError, fallback) {
  * @returns {() => void} An unsubscribe function
  */
 export async function mount(store, renderFn, element, options = {}) {
-  const { onError = defaultOnError, fallback } = options
+  const {
+    onError = defaultOnError,
+    fallback,
+    hydrate: allowHydrate = true,
+  } = options
 
   const api = { ...store._api }
   api.render = createRender(api)
 
-  const shouldHydrate = element.hasChildNodes()
+  const shouldHydrate = allowHydrate && element.hasChildNodes()
 
   // If we need to hydrate, load the heavy lifting only now
   if (shouldHydrate) {
@@ -78,6 +56,32 @@ export async function mount(store, renderFn, element, options = {}) {
   return unsubscribe
 }
 
+/**
+ * Root-level error boundary. Unlike the per-entity `withErrorBoundary`
+ * decorator (which isolates a single failing type's render), this catches
+ * errors thrown by the *root* render function itself — before any entity is
+ * reached (e.g. a missing router entity), or by an unguarded child.
+ *
+ * Without it, a throwing root render takes down the whole app: on the initial
+ * pass it aborts the mount, and inside the store subscription it throws out of
+ * the notify loop on every subsequent update, freezing the UI. Catching it
+ * keeps the subscription alive so one bad tick can't kill the app.
+ *
+ * @param {(api: Api) => TemplateResult | null} renderFn
+ * @param {Api} api
+ * @param {(error: unknown, api: Api) => void} onError
+ * @param {((error: unknown, api: Api) => TemplateResult | null) | undefined} fallback
+ * @returns {{ ok: true, template: TemplateResult | null } | { ok: false, fallback: TemplateResult | null }}
+ */
+function renderRoot(renderFn, api, onError, fallback) {
+  try {
+    return { ok: true, template: renderFn(api) }
+  } catch (error) {
+    onError(error, api)
+    return { ok: false, fallback: fallback ? fallback(error, api) : null }
+  }
+}
+
 /**
  * Default root-error handler: log without taking the app down.
  * @param {unknown} error - The error thrown by the root render function.

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(