@real-router/lifecycle-plugin 0.3.0 → 0.4.0

package/README.md

@@ -5,17 +5,17 @@
 [![bundle size](https://deno.bundlejs.com/?q=@real-router/lifecycle-plugin&treeshake=[*]&badge=detailed)](https://bundlejs.com/?q=@real-router/lifecycle-plugin&treeshake=[*])
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](../../LICENSE)
 
-> Route-level lifecycle hooks for [Real-Router](https://github.com/greydragon888/real-router). Add `onEnter`, `onStay`, `onLeave` callbacks directly to route definitions.
+> Route-level lifecycle hooks for [Real-Router](https://github.com/greydragon888/real-router). Add `onNavigate`, `onEnter`, `onStay`, `onLeave` callbacks directly to route definitions.
 
 ```typescript
 // Without plugin — scattered subscribe() calls with route checks:
 router.subscribe(({ route, previousRoute }) => {
-  if (route.name === "dashboard") trackPageView("dashboard");
+  if (route.name === "catalog") loadServices(route.params);
   if (previousRoute?.name === "editor") saveEditorState();
 });
 
 // With plugin — declarative, per-route:
-{ name: "dashboard", path: "/dashboard", onEnter: () => () => trackPageView("dashboard") }
+{ name: "catalog", path: "/catalog?q&sort", onNavigate: () => (s) => loadServices(s.params) }
 { name: "editor", path: "/editor", onLeave: () => () => saveEditorState() }
 ```
 
@@ -35,20 +35,26 @@ import { lifecyclePluginFactory } from "@real-router/lifecycle-plugin";
 
 const routes = [
   {
-    name: "home",
-    path: "/",
-    onLeave: () => (toState, fromState) => {
-      console.log("Leaving home for", toState.name);
+    name: "services.catalog",
+    path: "/catalog?q&sort&dir",
+    // Fires on entry AND on param-change — recommended default
+    onNavigate: () => (toState) => {
+      loadServices(toState.params);
     },
   },
   {
-    name: "users.view",
-    path: "/users/:id",
+    name: "chat",
+    path: "/chat/:roomId",
+    // Orthogonal: onEnter covers entry-only setup, onNavigate covers
+    // every navigation (including entry). Both fire on entry.
     onEnter: () => (toState) => {
-      analytics.track("user_profile_viewed", { userId: toState.params.id });
+      chatSocket.connect(toState.params.roomId);
     },
-    onStay: () => (toState, fromState) => {
-      console.log("User changed:", fromState.params.id, "→", toState.params.id);
+    onNavigate: () => (toState) => {
+      loadMessages(toState.params.roomId);
+    },
+    onLeave: () => () => {
+      chatSocket.disconnect();
     },
   },
 ];
@@ -59,13 +65,18 @@ router.usePlugin(lifecyclePluginFactory());
 await router.start("/");
 ```
 
+> **Start with `onNavigate`.** It covers the most common case — running the same logic whenever the route is the navigation target (data loading, analytics, UI reset). Add `onEnter` or `onStay` for extra case-specific logic.
+
 ## Hook Reference
 
-| Hook      | Fires when                 | Typical use case           |
-| --------- | -------------------------- | -------------------------- |
-| `onEnter` | Route is entered           | Analytics, data prefetch   |
-| `onStay`  | Same route, params changed | Refresh data, update UI    |
-| `onLeave` | Route is left              | Cleanup timers, save state |
+| Hook         | Fires when                              | Typical use case                            |
+| ------------ | --------------------------------------- | ------------------------------------------- |
+| `onNavigate` | Any successful navigation to the route  | Data loading, analytics, UI reset (default) |
+| `onEnter`    | Route is entered                        | Entry-only setup (open socket, scroll top)  |
+| `onStay`     | Same route, params changed              | Stay-only logic (incremental updates)       |
+| `onLeave`    | Route is left                           | Cleanup timers, save state                  |
+
+**Orthogonal dispatch:** `onEnter` / `onStay` / `onNavigate` fire independently based on their own conditions. On entry, `onEnter` **and** `onNavigate` fire. On param-change, `onStay` **and** `onNavigate` fire. Each hook is composable — declaring one never silences another.
 
 Each hook field is a **factory function** `(router, getDependency) => (toState, fromState?) => void`. The factory runs once per route; the returned callback is cached and invoked on each matching transition. When you don't need DI, omit the factory params:
 
@@ -86,6 +97,19 @@ onEnter: (router, getDependency) => (toState) => {
 
 ## Use Cases
 
+### Data loading (onNavigate — recommended default)
+
+```typescript
+{
+  name: "services.catalog",
+  path: "/catalog?q&sort&dir",
+  onNavigate: () => (toState) => {
+    // Fires on entry from another route AND on filter/sort param changes
+    loadServices(toState.params);
+  },
+}
+```
+
 ### Analytics tracking
 
 ```typescript

package/dist/cjs/index.d.ts

@@ -30,6 +30,12 @@ declare module "@real-router/core" {
     onStay?: LifecycleHookFactory<Dependencies>;
     /** Factory that returns a hook called when this route segment is deactivated (left). */
     onLeave?: LifecycleHookFactory<Dependencies>;
+    /**
+     * Factory that returns a hook called on every successful navigation to this route
+     * (both entry and param-change). Acts as a fallback when `onEnter` or `onStay`
+     * is not defined for the corresponding case.
+     */
+    onNavigate?: LifecycleHookFactory<Dependencies>;
   }
 }
 //#endregion

package/dist/cjs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/types.ts","../../src/factory.ts","../../src/index.ts"],"mappings":";;;;;;AAOA;;KAAY,aAAA,IACV,OAAA,EAAS,KAAA,EACT,SAAA,EAAW,KAAA;;;;;;KAQD,oBAAA,sBACW,qBAAA,GAAsB,qBAAA,KAE3C,MAAA,EAAQ,MAAA,CAAO,YAAA,GACf,aAAA,mBAAgC,YAAA,EAAc,GAAA,EAAK,CAAA,KAAM,YAAA,CAAa,CAAA,MACnE,aAAA;;;iBC2CW,sBAAA,CAAA,GAA0B,aAAA;;;;AD1D1C;;;;YEGY,KAAA,sBAA2B,mBAAA;IFFrC;IEIE,OAAA,GAAU,oBAAA,CAAqB,YAAA;IFHjC;IEKE,MAAA,GAAS,oBAAA,CAAqB,YAAA;IFLJ;IEO1B,OAAA,GAAU,oBAAA,CAAqB,YAAA;EAAA;AAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/types.ts","../../src/factory.ts","../../src/index.ts"],"mappings":";;;;;;AAOA;;KAAY,aAAA,IACV,OAAA,EAAS,KAAA,EACT,SAAA,EAAW,KAAA;;;;;;KAQD,oBAAA,sBACW,qBAAA,GAAsB,qBAAA,KAE3C,MAAA,EAAQ,MAAA,CAAO,YAAA,GACf,aAAA,mBAAgC,YAAA,EAAc,GAAA,EAAK,CAAA,KAAM,YAAA,CAAa,CAAA,MACnE,aAAA;;;iBC6CW,sBAAA,CAAA,GAA0B,aAAA;;;;AD5D1C;;;;YEGY,KAAA,sBAA2B,mBAAA;IFFrC;IEIE,OAAA,GAAU,oBAAA,CAAqB,YAAA;IFHjC;IEKE,MAAA,GAAS,oBAAA,CAAqB,YAAA;IFLJ;IEO1B,OAAA,GAAU,oBAAA,CAAqB,YAAA;IFCH;;;;;IEK5B,UAAA,GAAa,oBAAA,CAAqB,YAAA;EAAA;AAAA"}

package/dist/cjs/index.js

@@ -1,2 +1,2 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require(`@real-router/core/api`);function t(...t){let[n,r]=t,i=(0,e.getPluginApi)(n),a=new Map;function o(e,t){let o=`${e}:${t}`,s=i.getRouteConfig(t),c=typeof s?.[e]==`function`?s[e]:void 0;if(!c){a.delete(o);return}let l=a.get(o);if(l?.factory===c)return l.hook;let u=c(n,r);return a.set(o,{hook:u,factory:c}),u}return{onTransitionLeaveApprove:(e,t)=>{t&&e.name!==t.name&&o(`onLeave`,t.name)?.(e,t)},onTransitionSuccess:(e,t)=>{e.name===t?.name?o(`onStay`,e.name)?.(e,t):o(`onEnter`,e.name)?.(e,t)}}}function n(){return t}exports.lifecyclePluginFactory=n;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require(`@real-router/core/api`);function t(...t){let[n,r]=t,i=(0,e.getPluginApi)(n),a=new Map;function o(e,t){let o=`${e}:${t}`,s=i.getRouteConfig(t),c=typeof s?.[e]==`function`?s[e]:void 0;if(!c){a.delete(o);return}let l=a.get(o);if(l?.factory===c)return l.hook;let u=c(n,r);return a.set(o,{hook:u,factory:c}),u}return{onTransitionLeaveApprove:(e,t)=>{t&&e.name!==t.name&&o(`onLeave`,t.name)?.(e,t)},onTransitionSuccess:(e,t)=>{e.name===t?.name?o(`onStay`,e.name)?.(e,t):o(`onEnter`,e.name)?.(e,t),o(`onNavigate`,e.name)?.(e,t)}}}function n(){return t}exports.lifecyclePluginFactory=n;
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/factory.ts"],"sourcesContent":["import { getPluginApi } from \"@real-router/core/api\";\n\nimport type { LifecycleHook, LifecycleHookFactory } from \"./types\";\nimport type { PluginFactory, State } from \"@real-router/core\";\n\nfunction createPlugin(\n  ...args: Parameters<PluginFactory>\n): ReturnType<PluginFactory> {\n  const [router, getDependency] = args;\n  const api = getPluginApi(router);\n  const compiledHooks = new Map<\n    string,\n    { hook: LifecycleHook; factory: LifecycleHookFactory }\n  >();\n\n  function compileHook(\n    hookName: \"onEnter\" | \"onStay\" | \"onLeave\",\n    routeName: string,\n  ): LifecycleHook | undefined {\n    const key = `${hookName}:${routeName}`;\n    const config = api.getRouteConfig(routeName);\n    const factory =\n      typeof config?.[hookName] === \"function\"\n        ? (config[hookName] as LifecycleHookFactory)\n        : undefined;\n\n    if (!factory) {\n      compiledHooks.delete(key);\n\n      return undefined;\n    }\n\n    const cached = compiledHooks.get(key);\n\n    if (cached?.factory === factory) {\n      return cached.hook;\n    }\n\n    const hook = factory(router, getDependency);\n\n    compiledHooks.set(key, { hook, factory });\n\n    return hook;\n  }\n\n  return {\n    onTransitionLeaveApprove: (\n      toState: State,\n      fromState: State | undefined,\n    ) => {\n      if (fromState && toState.name !== fromState.name) {\n        compileHook(\"onLeave\", fromState.name)?.(toState, fromState);\n      }\n    },\n\n    onTransitionSuccess: (toState: State, fromState: State | undefined) => {\n      if (toState.name === fromState?.name) {\n        compileHook(\"onStay\", toState.name)?.(toState, fromState);\n      } else {\n        compileHook(\"onEnter\", toState.name)?.(toState, fromState);\n      }\n    },\n  };\n}\n\nexport function lifecyclePluginFactory(): PluginFactory {\n  return createPlugin;\n}\n"],"mappings":"0GAKA,SAAS,EACP,GAAG,EACwB,CAC3B,GAAM,CAAC,EAAQ,GAAiB,EAC1B,GAAA,EAAA,EAAA,cAAmB,EAAO,CAC1B,EAAgB,IAAI,IAK1B,SAAS,EACP,EACA,EAC2B,CAC3B,IAAM,EAAM,GAAG,EAAS,GAAG,IACrB,EAAS,EAAI,eAAe,EAAU,CACtC,EACJ,OAAO,IAAS,IAAc,WACzB,EAAO,GACR,IAAA,GAEN,GAAI,CAAC,EAAS,CACZ,EAAc,OAAO,EAAI,CAEzB,OAGF,IAAM,EAAS,EAAc,IAAI,EAAI,CAErC,GAAI,GAAQ,UAAY,EACtB,OAAO,EAAO,KAGhB,IAAM,EAAO,EAAQ,EAAQ,EAAc,CAI3C,OAFA,EAAc,IAAI,EAAK,CAAE,OAAM,UAAS,CAAC,CAElC,EAGT,MAAO,CACL,0BACE,EACA,IACG,CACC,GAAa,EAAQ,OAAS,EAAU,MAC1C,EAAY,UAAW,EAAU,KAAK,GAAG,EAAS,EAAU,EAIhE,qBAAsB,EAAgB,IAAiC,CACjE,EAAQ,OAAS,GAAW,KAC9B,EAAY,SAAU,EAAQ,KAAK,GAAG,EAAS,EAAU,CAEzD,EAAY,UAAW,EAAQ,KAAK,GAAG,EAAS,EAAU,EAG/D,CAGH,SAAgB,GAAwC,CACtD,OAAO"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/factory.ts"],"sourcesContent":["import { getPluginApi } from \"@real-router/core/api\";\n\nimport type { LifecycleHook, LifecycleHookFactory } from \"./types\";\nimport type { PluginFactory, State } from \"@real-router/core\";\n\nfunction createPlugin(\n  ...args: Parameters<PluginFactory>\n): ReturnType<PluginFactory> {\n  const [router, getDependency] = args;\n  const api = getPluginApi(router);\n  const compiledHooks = new Map<\n    string,\n    { hook: LifecycleHook; factory: LifecycleHookFactory }\n  >();\n\n  function compileHook(\n    hookName: \"onEnter\" | \"onStay\" | \"onLeave\" | \"onNavigate\",\n    routeName: string,\n  ): LifecycleHook | undefined {\n    const key = `${hookName}:${routeName}`;\n    const config = api.getRouteConfig(routeName);\n    const factory =\n      typeof config?.[hookName] === \"function\"\n        ? (config[hookName] as LifecycleHookFactory)\n        : undefined;\n\n    if (!factory) {\n      compiledHooks.delete(key);\n\n      return undefined;\n    }\n\n    const cached = compiledHooks.get(key);\n\n    if (cached?.factory === factory) {\n      return cached.hook;\n    }\n\n    const hook = factory(router, getDependency);\n\n    compiledHooks.set(key, { hook, factory });\n\n    return hook;\n  }\n\n  return {\n    onTransitionLeaveApprove: (\n      toState: State,\n      fromState: State | undefined,\n    ) => {\n      if (fromState && toState.name !== fromState.name) {\n        compileHook(\"onLeave\", fromState.name)?.(toState, fromState);\n      }\n    },\n\n    onTransitionSuccess: (toState: State, fromState: State | undefined) => {\n      if (toState.name === fromState?.name) {\n        compileHook(\"onStay\", toState.name)?.(toState, fromState);\n      } else {\n        compileHook(\"onEnter\", toState.name)?.(toState, fromState);\n      }\n\n      compileHook(\"onNavigate\", toState.name)?.(toState, fromState);\n    },\n  };\n}\n\nexport function lifecyclePluginFactory(): PluginFactory {\n  return createPlugin;\n}\n"],"mappings":"0GAKA,SAAS,EACP,GAAG,EACwB,CAC3B,GAAM,CAAC,EAAQ,GAAiB,EAC1B,GAAA,EAAA,EAAA,cAAmB,EAAO,CAC1B,EAAgB,IAAI,IAK1B,SAAS,EACP,EACA,EAC2B,CAC3B,IAAM,EAAM,GAAG,EAAS,GAAG,IACrB,EAAS,EAAI,eAAe,EAAU,CACtC,EACJ,OAAO,IAAS,IAAc,WACzB,EAAO,GACR,IAAA,GAEN,GAAI,CAAC,EAAS,CACZ,EAAc,OAAO,EAAI,CAEzB,OAGF,IAAM,EAAS,EAAc,IAAI,EAAI,CAErC,GAAI,GAAQ,UAAY,EACtB,OAAO,EAAO,KAGhB,IAAM,EAAO,EAAQ,EAAQ,EAAc,CAI3C,OAFA,EAAc,IAAI,EAAK,CAAE,OAAM,UAAS,CAAC,CAElC,EAGT,MAAO,CACL,0BACE,EACA,IACG,CACC,GAAa,EAAQ,OAAS,EAAU,MAC1C,EAAY,UAAW,EAAU,KAAK,GAAG,EAAS,EAAU,EAIhE,qBAAsB,EAAgB,IAAiC,CACjE,EAAQ,OAAS,GAAW,KAC9B,EAAY,SAAU,EAAQ,KAAK,GAAG,EAAS,EAAU,CAEzD,EAAY,UAAW,EAAQ,KAAK,GAAG,EAAS,EAAU,CAG5D,EAAY,aAAc,EAAQ,KAAK,GAAG,EAAS,EAAU,EAEhE,CAGH,SAAgB,GAAwC,CACtD,OAAO"}

package/dist/esm/index.d.mts

@@ -30,6 +30,12 @@ declare module "@real-router/core" {
     onStay?: LifecycleHookFactory<Dependencies>;
     /** Factory that returns a hook called when this route segment is deactivated (left). */
     onLeave?: LifecycleHookFactory<Dependencies>;
+    /**
+     * Factory that returns a hook called on every successful navigation to this route
+     * (both entry and param-change). Acts as a fallback when `onEnter` or `onStay`
+     * is not defined for the corresponding case.
+     */
+    onNavigate?: LifecycleHookFactory<Dependencies>;
   }
 }
 //#endregion

package/dist/esm/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/types.ts","../../src/factory.ts","../../src/index.ts"],"mappings":";;;;;;AAOA;;KAAY,aAAA,IACV,OAAA,EAAS,KAAA,EACT,SAAA,EAAW,KAAA;;;;;;KAQD,oBAAA,sBACW,qBAAA,GAAsB,qBAAA,KAE3C,MAAA,EAAQ,MAAA,CAAO,YAAA,GACf,aAAA,mBAAgC,YAAA,EAAc,GAAA,EAAK,CAAA,KAAM,YAAA,CAAa,CAAA,MACnE,aAAA;;;iBC2CW,sBAAA,CAAA,GAA0B,aAAA;;;;AD1D1C;;;;YEGY,KAAA,sBAA2B,mBAAA;IFFrC;IEIE,OAAA,GAAU,oBAAA,CAAqB,YAAA;IFHjC;IEKE,MAAA,GAAS,oBAAA,CAAqB,YAAA;IFLJ;IEO1B,OAAA,GAAU,oBAAA,CAAqB,YAAA;EAAA;AAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/types.ts","../../src/factory.ts","../../src/index.ts"],"mappings":";;;;;;AAOA;;KAAY,aAAA,IACV,OAAA,EAAS,KAAA,EACT,SAAA,EAAW,KAAA;;;;;;KAQD,oBAAA,sBACW,qBAAA,GAAsB,qBAAA,KAE3C,MAAA,EAAQ,MAAA,CAAO,YAAA,GACf,aAAA,mBAAgC,YAAA,EAAc,GAAA,EAAK,CAAA,KAAM,YAAA,CAAa,CAAA,MACnE,aAAA;;;iBC6CW,sBAAA,CAAA,GAA0B,aAAA;;;;AD5D1C;;;;YEGY,KAAA,sBAA2B,mBAAA;IFFrC;IEIE,OAAA,GAAU,oBAAA,CAAqB,YAAA;IFHjC;IEKE,MAAA,GAAS,oBAAA,CAAqB,YAAA;IFLJ;IEO1B,OAAA,GAAU,oBAAA,CAAqB,YAAA;IFCH;;;;;IEK5B,UAAA,GAAa,oBAAA,CAAqB,YAAA;EAAA;AAAA"}

package/dist/esm/index.mjs

@@ -1,2 +1,2 @@
-import{getPluginApi as e}from"@real-router/core/api";function t(...t){let[n,r]=t,i=e(n),a=new Map;function o(e,t){let o=`${e}:${t}`,s=i.getRouteConfig(t),c=typeof s?.[e]==`function`?s[e]:void 0;if(!c){a.delete(o);return}let l=a.get(o);if(l?.factory===c)return l.hook;let u=c(n,r);return a.set(o,{hook:u,factory:c}),u}return{onTransitionLeaveApprove:(e,t)=>{t&&e.name!==t.name&&o(`onLeave`,t.name)?.(e,t)},onTransitionSuccess:(e,t)=>{e.name===t?.name?o(`onStay`,e.name)?.(e,t):o(`onEnter`,e.name)?.(e,t)}}}function n(){return t}export{n as lifecyclePluginFactory};
+import{getPluginApi as e}from"@real-router/core/api";function t(...t){let[n,r]=t,i=e(n),a=new Map;function o(e,t){let o=`${e}:${t}`,s=i.getRouteConfig(t),c=typeof s?.[e]==`function`?s[e]:void 0;if(!c){a.delete(o);return}let l=a.get(o);if(l?.factory===c)return l.hook;let u=c(n,r);return a.set(o,{hook:u,factory:c}),u}return{onTransitionLeaveApprove:(e,t)=>{t&&e.name!==t.name&&o(`onLeave`,t.name)?.(e,t)},onTransitionSuccess:(e,t)=>{e.name===t?.name?o(`onStay`,e.name)?.(e,t):o(`onEnter`,e.name)?.(e,t),o(`onNavigate`,e.name)?.(e,t)}}}function n(){return t}export{n as lifecyclePluginFactory};
 //# sourceMappingURL=index.mjs.map

package/dist/esm/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/factory.ts"],"sourcesContent":["import { getPluginApi } from \"@real-router/core/api\";\n\nimport type { LifecycleHook, LifecycleHookFactory } from \"./types\";\nimport type { PluginFactory, State } from \"@real-router/core\";\n\nfunction createPlugin(\n  ...args: Parameters<PluginFactory>\n): ReturnType<PluginFactory> {\n  const [router, getDependency] = args;\n  const api = getPluginApi(router);\n  const compiledHooks = new Map<\n    string,\n    { hook: LifecycleHook; factory: LifecycleHookFactory }\n  >();\n\n  function compileHook(\n    hookName: \"onEnter\" | \"onStay\" | \"onLeave\",\n    routeName: string,\n  ): LifecycleHook | undefined {\n    const key = `${hookName}:${routeName}`;\n    const config = api.getRouteConfig(routeName);\n    const factory =\n      typeof config?.[hookName] === \"function\"\n        ? (config[hookName] as LifecycleHookFactory)\n        : undefined;\n\n    if (!factory) {\n      compiledHooks.delete(key);\n\n      return undefined;\n    }\n\n    const cached = compiledHooks.get(key);\n\n    if (cached?.factory === factory) {\n      return cached.hook;\n    }\n\n    const hook = factory(router, getDependency);\n\n    compiledHooks.set(key, { hook, factory });\n\n    return hook;\n  }\n\n  return {\n    onTransitionLeaveApprove: (\n      toState: State,\n      fromState: State | undefined,\n    ) => {\n      if (fromState && toState.name !== fromState.name) {\n        compileHook(\"onLeave\", fromState.name)?.(toState, fromState);\n      }\n    },\n\n    onTransitionSuccess: (toState: State, fromState: State | undefined) => {\n      if (toState.name === fromState?.name) {\n        compileHook(\"onStay\", toState.name)?.(toState, fromState);\n      } else {\n        compileHook(\"onEnter\", toState.name)?.(toState, fromState);\n      }\n    },\n  };\n}\n\nexport function lifecyclePluginFactory(): PluginFactory {\n  return createPlugin;\n}\n"],"mappings":"qDAKA,SAAS,EACP,GAAG,EACwB,CAC3B,GAAM,CAAC,EAAQ,GAAiB,EAC1B,EAAM,EAAa,EAAO,CAC1B,EAAgB,IAAI,IAK1B,SAAS,EACP,EACA,EAC2B,CAC3B,IAAM,EAAM,GAAG,EAAS,GAAG,IACrB,EAAS,EAAI,eAAe,EAAU,CACtC,EACJ,OAAO,IAAS,IAAc,WACzB,EAAO,GACR,IAAA,GAEN,GAAI,CAAC,EAAS,CACZ,EAAc,OAAO,EAAI,CAEzB,OAGF,IAAM,EAAS,EAAc,IAAI,EAAI,CAErC,GAAI,GAAQ,UAAY,EACtB,OAAO,EAAO,KAGhB,IAAM,EAAO,EAAQ,EAAQ,EAAc,CAI3C,OAFA,EAAc,IAAI,EAAK,CAAE,OAAM,UAAS,CAAC,CAElC,EAGT,MAAO,CACL,0BACE,EACA,IACG,CACC,GAAa,EAAQ,OAAS,EAAU,MAC1C,EAAY,UAAW,EAAU,KAAK,GAAG,EAAS,EAAU,EAIhE,qBAAsB,EAAgB,IAAiC,CACjE,EAAQ,OAAS,GAAW,KAC9B,EAAY,SAAU,EAAQ,KAAK,GAAG,EAAS,EAAU,CAEzD,EAAY,UAAW,EAAQ,KAAK,GAAG,EAAS,EAAU,EAG/D,CAGH,SAAgB,GAAwC,CACtD,OAAO"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/factory.ts"],"sourcesContent":["import { getPluginApi } from \"@real-router/core/api\";\n\nimport type { LifecycleHook, LifecycleHookFactory } from \"./types\";\nimport type { PluginFactory, State } from \"@real-router/core\";\n\nfunction createPlugin(\n  ...args: Parameters<PluginFactory>\n): ReturnType<PluginFactory> {\n  const [router, getDependency] = args;\n  const api = getPluginApi(router);\n  const compiledHooks = new Map<\n    string,\n    { hook: LifecycleHook; factory: LifecycleHookFactory }\n  >();\n\n  function compileHook(\n    hookName: \"onEnter\" | \"onStay\" | \"onLeave\" | \"onNavigate\",\n    routeName: string,\n  ): LifecycleHook | undefined {\n    const key = `${hookName}:${routeName}`;\n    const config = api.getRouteConfig(routeName);\n    const factory =\n      typeof config?.[hookName] === \"function\"\n        ? (config[hookName] as LifecycleHookFactory)\n        : undefined;\n\n    if (!factory) {\n      compiledHooks.delete(key);\n\n      return undefined;\n    }\n\n    const cached = compiledHooks.get(key);\n\n    if (cached?.factory === factory) {\n      return cached.hook;\n    }\n\n    const hook = factory(router, getDependency);\n\n    compiledHooks.set(key, { hook, factory });\n\n    return hook;\n  }\n\n  return {\n    onTransitionLeaveApprove: (\n      toState: State,\n      fromState: State | undefined,\n    ) => {\n      if (fromState && toState.name !== fromState.name) {\n        compileHook(\"onLeave\", fromState.name)?.(toState, fromState);\n      }\n    },\n\n    onTransitionSuccess: (toState: State, fromState: State | undefined) => {\n      if (toState.name === fromState?.name) {\n        compileHook(\"onStay\", toState.name)?.(toState, fromState);\n      } else {\n        compileHook(\"onEnter\", toState.name)?.(toState, fromState);\n      }\n\n      compileHook(\"onNavigate\", toState.name)?.(toState, fromState);\n    },\n  };\n}\n\nexport function lifecyclePluginFactory(): PluginFactory {\n  return createPlugin;\n}\n"],"mappings":"qDAKA,SAAS,EACP,GAAG,EACwB,CAC3B,GAAM,CAAC,EAAQ,GAAiB,EAC1B,EAAM,EAAa,EAAO,CAC1B,EAAgB,IAAI,IAK1B,SAAS,EACP,EACA,EAC2B,CAC3B,IAAM,EAAM,GAAG,EAAS,GAAG,IACrB,EAAS,EAAI,eAAe,EAAU,CACtC,EACJ,OAAO,IAAS,IAAc,WACzB,EAAO,GACR,IAAA,GAEN,GAAI,CAAC,EAAS,CACZ,EAAc,OAAO,EAAI,CAEzB,OAGF,IAAM,EAAS,EAAc,IAAI,EAAI,CAErC,GAAI,GAAQ,UAAY,EACtB,OAAO,EAAO,KAGhB,IAAM,EAAO,EAAQ,EAAQ,EAAc,CAI3C,OAFA,EAAc,IAAI,EAAK,CAAE,OAAM,UAAS,CAAC,CAElC,EAGT,MAAO,CACL,0BACE,EACA,IACG,CACC,GAAa,EAAQ,OAAS,EAAU,MAC1C,EAAY,UAAW,EAAU,KAAK,GAAG,EAAS,EAAU,EAIhE,qBAAsB,EAAgB,IAAiC,CACjE,EAAQ,OAAS,GAAW,KAC9B,EAAY,SAAU,EAAQ,KAAK,GAAG,EAAS,EAAU,CAEzD,EAAY,UAAW,EAAQ,KAAK,GAAG,EAAS,EAAU,CAG5D,EAAY,aAAc,EAAQ,KAAK,GAAG,EAAS,EAAU,EAEhE,CAGH,SAAgB,GAAwC,CACtD,OAAO"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@real-router/lifecycle-plugin",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "type": "commonjs",
   "description": "Route-level lifecycle hooks: onEnter, onStay, onLeave",
   "main": "./dist/cjs/index.js",

package/src/factory.ts

@@ -14,7 +14,7 @@ function createPlugin(
   >();
 
   function compileHook(
-    hookName: "onEnter" | "onStay" | "onLeave",
+    hookName: "onEnter" | "onStay" | "onLeave" | "onNavigate",
     routeName: string,
   ): LifecycleHook | undefined {
     const key = `${hookName}:${routeName}`;
@@ -59,6 +59,8 @@ function createPlugin(
       } else {
         compileHook("onEnter", toState.name)?.(toState, fromState);
       }
+
+      compileHook("onNavigate", toState.name)?.(toState, fromState);
     },
   };
 }

package/src/index.ts

@@ -15,6 +15,12 @@ declare module "@real-router/core" {
     onStay?: LifecycleHookFactory<Dependencies>;
     /** Factory that returns a hook called when this route segment is deactivated (left). */
     onLeave?: LifecycleHookFactory<Dependencies>;
+    /**
+     * Factory that returns a hook called on every successful navigation to this route
+     * (both entry and param-change). Acts as a fallback when `onEnter` or `onStay`
+     * is not defined for the corresponding case.
+     */
+    onNavigate?: LifecycleHookFactory<Dependencies>;
   }
 }