defuss 3.4.3 → 3.4.5

package/dist/index.cjs

@@ -1163,10 +1163,10 @@ const setupRouter = (config = {
     pendingResolvers: [],
     currentPath: "",
     popAttached: false,
-    lifecycleHooks: { beforeUnmount: [], unmount: [] }
+    lifecycleHooks: { beforeLeave: [], leave: [] }
   };
   if (!state.lifecycleHooks) {
-    state.lifecycleHooks = { beforeUnmount: [], unmount: [] };
+    state.lifecycleHooks = { beforeLeave: [], leave: [] };
   }
   const routeRegistrations = state.routeRegistrations;
   if (typeof window !== "undefined" && !windowImpl) {
@@ -1294,31 +1294,31 @@ const setupRouter = (config = {
     createRouteContext(request) {
       return {
         request,
-        onBeforeUnmount(fn) {
-          state.lifecycleHooks.beforeUnmount.push(fn);
+        onBeforeLeave(fn) {
+          state.lifecycleHooks.beforeLeave.push(fn);
         },
-        onUnmount(fn) {
-          state.lifecycleHooks.unmount.push(fn);
+        onLeave(fn) {
+          state.lifecycleHooks.leave.push(fn);
         }
       };
     },
-    async runBeforeUnmountHooks() {
-      for (const fn of state.lifecycleHooks.beforeUnmount) {
+    async runBeforeLeaveHooks() {
+      for (const fn of state.lifecycleHooks.beforeLeave) {
         const result = await fn();
         if (result === false) return false;
       }
       return true;
     },
-    runUnmountHooks() {
-      for (const fn of state.lifecycleHooks.unmount) {
+    runLeaveHooks() {
+      for (const fn of state.lifecycleHooks.leave) {
         fn();
       }
     },
     clearRouteLifecycle() {
-      const oldUnmountHooks = [...state.lifecycleHooks.unmount];
-      state.lifecycleHooks.beforeUnmount = [];
-      state.lifecycleHooks.unmount = [];
-      return { unmountHooks: oldUnmountHooks };
+      const oldLeaveHooks = [...state.lifecycleHooks.leave];
+      state.lifecycleHooks.beforeLeave = [];
+      state.lifecycleHooks.leave = [];
+      return { leaveHooks: oldLeaveHooks };
     }
   };
   const handlePopState = (event) => {
@@ -1349,7 +1349,7 @@ if (!globalThis[ROUTER_STATE_KEY]) {
     pendingResolvers: [],
     currentPath: "",
     popAttached: false,
-    lifecycleHooks: { beforeUnmount: [], unmount: [] }
+    lifecycleHooks: { beforeLeave: [], leave: [] }
   };
 }
 const getRouterState = () => globalThis[ROUTER_STATE_KEY];
@@ -1422,18 +1422,18 @@ const RouterSlot = ({
       const currentPath = router.getRequest().path;
       const isSamePath = currentPath === lastPath;
       if (!isSamePath) {
-        const allowed = await router.runBeforeUnmountHooks();
+        const allowed = await router.runBeforeLeaveHooks();
         if (!allowed) {
           window.history.pushState({}, "", lastPath);
           router.resolve(lastPath);
           return;
         }
-        const { unmountHooks } = router.clearRouteLifecycle();
+        const { leaveHooks } = router.clearRouteLifecycle();
         await dom.$(ref).update(
           typeof RouterOutlet === "function" ? RouterOutlet() : [],
           transitionConfig
         );
-        for (const fn of unmountHooks) {
+        for (const fn of leaveHooks) {
           fn();
         }
       } else {

package/dist/index.d.ts

@@ -137,8 +137,8 @@ declare const T: ({ key, values, tag, ref, ...attrs }: TransProps<string>) => VN
 type OnHandleRouteChangeFn = (newRoute: string, oldRoute: string) => void;
 type OnRouteChangeFn = (cb: OnHandleRouteChangeFn) => void;
 type RouterStrategy = "page-refresh" | "slot-refresh";
-type BeforeUnmountHookFn = () => boolean | void | Promise<boolean | void>;
-type UnmountHookFn = () => void;
+type BeforeLeaveHookFn = () => boolean | void | Promise<boolean | void>;
+type LeaveHookFn = () => void;
 /**
  * Context object passed to components rendered via Route's `component` prop.
  * Provides access to the current route request and lifecycle hooks.
@@ -146,11 +146,11 @@ type UnmountHookFn = () => void;
  * @example
  * ```tsx
  * const MyScreen = ({ route }: { route: RouteContext }) => {
- *   route.onBeforeUnmount(() => {
+ *   route.onBeforeLeave(() => {
  *     // Return false to block navigation (e.g. unsaved changes)
  *     return confirm("Leave page?");
  *   });
- *   route.onUnmount(() => {
+ *   route.onLeave(() => {
  *     console.log("Route was left");
  *   });
  *   return <div>Current path: {route.request.path}</div>;
@@ -165,26 +165,26 @@ interface RouteContext {
      * Returning `false` (or a Promise resolving to `false`) blocks navigation,
      * allowing implementation of confirmation dialogs.
      */
-    onBeforeUnmount(fn: BeforeUnmountHookFn): void;
+    onBeforeLeave(fn: BeforeLeaveHookFn): void;
     /**
      * Register a hook that fires after the route has been unmounted
      * (navigation completed, new route is rendered).
      */
-    onUnmount(fn: UnmountHookFn): void;
+    onLeave(fn: LeaveHookFn): void;
 }
 /**
- * Props mixin for screen components rendered by `<Route component={...} />`.
- * Extend your component props with this to get typed access to route context.
+ * Props interface for components rendered via Route's `component` prop.
+ * Extend your component's props with this to receive the `route` context.
  *
  * @example
  * ```tsx
- * import { Router, type Props, type RouteProps } from "defuss";
+ * import { type Props, type RouteProps } from "defuss";
  *
- * export interface ProjectDetailsProps extends Props, RouteProps {}
+ * interface MyScreenProps extends Props, RouteProps {}
  *
- * export function ProjectDetailsScreen({ route }: ProjectDetailsProps) {
- *   const { projectName } = route.request.params;
- *   return <h1>Project: {projectName}</h1>;
+ * function MyScreen({ route }: MyScreenProps) {
+ *   const { userId } = route.request.params;
+ *   return <h1>User #{userId}</h1>;
  * }
  * ```
  */
@@ -323,8 +323,8 @@ interface RouterState {
     currentPath: string;
     popAttached: boolean;
     lifecycleHooks: {
-        beforeUnmount: Array<BeforeUnmountHookFn>;
-        unmount: Array<UnmountHookFn>;
+        beforeLeave: Array<BeforeLeaveHookFn>;
+        leave: Array<LeaveHookFn>;
     };
 }
 declare global {
@@ -361,7 +361,7 @@ interface Router {
     ready(): Promise<void>;
     /**
      * Create a RouteContext object for a matched route request.
-     * The context provides lifecycle hooks (onBeforeUnmount, onUnmount)
+     * The context provides lifecycle hooks (onBeforeLeave, onLeave)
      * and is passed to components rendered via Route's `component` prop.
      */
     createRouteContext(request: RouteRequest): RouteContext;
@@ -486,4 +486,4 @@ declare const Suspense: ({ fallback, ref, children, class: _class, className, id
 };
 
 export { Async, AsyncDefussChild, DOMElement, FC, Globals, NodeType, PersistenceProviderImpl, PersistenceProviderOptions, PersistenceProviderType, Props, Redirect, Ref, RenderInput, Route, Router, RouterSlot, RouterSlotId, Suspense, T, Trans, TransitionConfig, VNode, VNodeAttributes, VNodeChild, addElementEvent, areDomNodesEqual, changeLanguage, checkElementVisibility, clearElementEvents, createI18n, createTrans, domNodeToVNode, getEventMap, getLanguage, getMimeType, getRouterState, htmlStringToVNodes, i18n, inDevMode, isHTML, isMarkup, isSVG, loadLanguage, matchRouteRegistrations, parseDOM, processAllFormElements, queueCallback, removeElementEvent, renderMarkup, replaceDomWithVdom, setupRouter, t, tokenizePath, updateDomWithVdom, waitForDOM, webstorage };
-export type { AsyncProps, AsyncState, AsyncStateRef, BeforeUnmountHookFn, I18nStore, MatchRouteRegistrationsOpts, OnHandleRouteChangeFn, OnLanguageChangeListener, OnRouteChangeFn, RedirectProps, Replacements, Resolve, RouteComponentProps, RouteContext, RouteHandler, RouteParams, RouteProps, RouteRegistration, RouteRequest, RouterConfig, RouterSlotProps, RouterStrategy, TokenizedPath, TransProps, TransRef, TranslationKeys, TranslationObject, Translations, UnmountHookFn, ValidChild };
+export type { AsyncProps, AsyncState, AsyncStateRef, BeforeLeaveHookFn, I18nStore, LeaveHookFn, MatchRouteRegistrationsOpts, OnHandleRouteChangeFn, OnLanguageChangeListener, OnRouteChangeFn, RedirectProps, Replacements, Resolve, RouteComponentProps, RouteContext, RouteHandler, RouteParams, RouteProps, RouteRegistration, RouteRequest, RouterConfig, RouterSlotProps, RouterStrategy, TokenizedPath, TransProps, TransRef, TranslationKeys, TranslationObject, Translations, ValidChild };

package/dist/index.mjs

@@ -1162,10 +1162,10 @@ const setupRouter = (config = {
     pendingResolvers: [],
     currentPath: "",
     popAttached: false,
-    lifecycleHooks: { beforeUnmount: [], unmount: [] }
+    lifecycleHooks: { beforeLeave: [], leave: [] }
   };
   if (!state.lifecycleHooks) {
-    state.lifecycleHooks = { beforeUnmount: [], unmount: [] };
+    state.lifecycleHooks = { beforeLeave: [], leave: [] };
   }
   const routeRegistrations = state.routeRegistrations;
   if (typeof window !== "undefined" && !windowImpl) {
@@ -1293,31 +1293,31 @@ const setupRouter = (config = {
     createRouteContext(request) {
       return {
         request,
-        onBeforeUnmount(fn) {
-          state.lifecycleHooks.beforeUnmount.push(fn);
+        onBeforeLeave(fn) {
+          state.lifecycleHooks.beforeLeave.push(fn);
         },
-        onUnmount(fn) {
-          state.lifecycleHooks.unmount.push(fn);
+        onLeave(fn) {
+          state.lifecycleHooks.leave.push(fn);
         }
       };
     },
-    async runBeforeUnmountHooks() {
-      for (const fn of state.lifecycleHooks.beforeUnmount) {
+    async runBeforeLeaveHooks() {
+      for (const fn of state.lifecycleHooks.beforeLeave) {
         const result = await fn();
         if (result === false) return false;
       }
       return true;
     },
-    runUnmountHooks() {
-      for (const fn of state.lifecycleHooks.unmount) {
+    runLeaveHooks() {
+      for (const fn of state.lifecycleHooks.leave) {
         fn();
       }
     },
     clearRouteLifecycle() {
-      const oldUnmountHooks = [...state.lifecycleHooks.unmount];
-      state.lifecycleHooks.beforeUnmount = [];
-      state.lifecycleHooks.unmount = [];
-      return { unmountHooks: oldUnmountHooks };
+      const oldLeaveHooks = [...state.lifecycleHooks.leave];
+      state.lifecycleHooks.beforeLeave = [];
+      state.lifecycleHooks.leave = [];
+      return { leaveHooks: oldLeaveHooks };
     }
   };
   const handlePopState = (event) => {
@@ -1348,7 +1348,7 @@ if (!globalThis[ROUTER_STATE_KEY]) {
     pendingResolvers: [],
     currentPath: "",
     popAttached: false,
-    lifecycleHooks: { beforeUnmount: [], unmount: [] }
+    lifecycleHooks: { beforeLeave: [], leave: [] }
   };
 }
 const getRouterState = () => globalThis[ROUTER_STATE_KEY];
@@ -1421,18 +1421,18 @@ const RouterSlot = ({
       const currentPath = router.getRequest().path;
       const isSamePath = currentPath === lastPath;
       if (!isSamePath) {
-        const allowed = await router.runBeforeUnmountHooks();
+        const allowed = await router.runBeforeLeaveHooks();
         if (!allowed) {
           window.history.pushState({}, "", lastPath);
           router.resolve(lastPath);
           return;
         }
-        const { unmountHooks } = router.clearRouteLifecycle();
+        const { leaveHooks } = router.clearRouteLifecycle();
         await $(ref).update(
           typeof RouterOutlet === "function" ? RouterOutlet() : [],
           transitionConfig
         );
-        for (const fn of unmountHooks) {
+        for (const fn of leaveHooks) {
           fn();
         }
       } else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "defuss",
-  "version": "3.4.3",
+  "version": "3.4.5",
   "type": "module",
   "publishConfig": {
     "access": "public"