intentx-react-router 0.2.0 → 1.0.0-z

package/README.md

@@ -39,7 +39,7 @@ navigateIntent("edit-user", 42)
 # Installation
 
 ```bash
-npm install intentx-react-router eventbus-z react-router@^7 react-router-dom@^7
+npm install intentx-react-router react-router@^7 react-router-dom@^7
 ```
 
 ## Recommended Versions
@@ -48,7 +48,6 @@ npm install intentx-react-router eventbus-z react-router@^7 react-router-dom@^7
 - react-dom: >=18
 - react-router: >=7
 - react-router-dom: >=7
-- eventbus-z: ^2.4.0
 
 ---
 
@@ -81,51 +80,15 @@ export function RouterBinder() {
   return null
 }
 ```
-
----
-
-## 3. IntentLink
-
-```ts
-import React from "react"
-import { Link } from "react-router-dom"
-import { generatePathFromIntent } from "intentx-react-router"
-
-export function IntentLink({ intent, params, query, children }) {
-  let path = generatePathFromIntent(intent, params)
-  if (query) {
-    const qs = new URLSearchParams(query).toString()
-    if (qs) path += "?" + qs
-  }
-  return <Link to={path}>{children}</Link>
-}
-```
-
---- 
-
-## 4. IntentRoute
-
----
-
-```ts
-import React from "react"
-import { Route } from "react-router-dom"
-import { generatePathFromIntent } from "intentx-react-router"
-
-export function IntentRoute({ intent, component: Component }) {
-  const path = generatePathFromIntent(intent)
-  return <Route path={path} render={(props) => <Component {...props} />} />
-}
-```
-
 ---
 
-## 5. Use in App
+## 3. Use in App
 
 ```ts
 import React from "react"
-import { BrowserRouter, Switch } from "react-router-dom"
-import { RouterBinder, IntentLink, IntentRoute } from "./router"
+import { BrowserRouter, Routes } from "react-router-dom"
+import { IntentLink, IntentRoute } from "intentx-react-router"
+import { RouterBinder } from "./router"
 
 import { UserPage } from "./pages/UserPage"
 import { EditUserPage } from "./pages/EditUserPage"
@@ -142,39 +105,30 @@ export default function App() {
         | <IntentLink intent="checkout">Checkout</IntentLink>
       </nav>
 
-      <Switch>
+      <Routes>
         <IntentRoute intent="view-user" component={UserPage} />
         <IntentRoute intent="edit-user" component={EditUserPage} />
         <IntentRoute intent="checkout" component={CheckoutPage} />
-      </Switch>
+      </Routes>
     </BrowserRouter>
   )
 }
 ```
 
----
-
-## 6. useIntent Hook
+## 4. IntentRouter 
 
 ```ts
-import { useLocation } from "react-router-dom"
-import { resolveIntentFromUrl } from "intentx-react-router"
-
-export function useIntent() {
-  const location = useLocation()
-  const resolved = resolveIntentFromUrl(location.pathname)
-
-  const searchParams = new URLSearchParams(location.search)
-  const query = {}
-  searchParams.forEach((value, key) => {
-    query[key] = value
-  })
-
-  return {
-    intent: resolved?.intent ?? null,
-    params: resolved?.params ?? {},
-    query
-  }
+import { IntentRouter } from "intentx-react-router"
+import { Routes } from "react-router-dom"
+
+export default function App() {
+  return (
+    <IntentRouter>
+      <Routes>
+        <IntentRoute intent="checkout" component={CheckoutPage} />
+      </Routes>
+    </IntentRouter>
+  )
 }
 ```
 
@@ -227,6 +181,82 @@ Result:
 
 ---
 
+## Query params
+
+Intent navigation also supports query parameters.
+
+```ts
+navigateIntent("view-user", {
+  userId: 1,
+  page: 2
+}, {
+  tab: "activity",
+  filter: "recent"
+})
+```
+
+```ts
+/users/1/name/2?tab=activity&filter=recent
+```
+
+---
+
+Query arrays are also supported:
+
+```ts
+navigateIntent("view-user", [1,2], {
+  tags: ["admin", "vip"]
+})
+```
+
+Result:
+
+```ts
+/users/1/name/2?tags=admin&tags=vip
+```
+
+---
+
+## Advanced Navigation
+
+options, fallback, microFE
+
+```ts
+import React from "react"
+import { useNavigateIntent, setFallbackPath, setSharedBus } from "intentx-react-router"
+import { createEventBus } from "eventbus-z"
+
+// Micro-frontend shared bus
+const externalBus = createEventBus()
+setSharedBus(externalBus)
+
+setFallbackPath("/not-found")
+
+function Dashboard() {
+  const navigateIntent = useNavigateIntent()
+
+  const handleCheckout = () => {
+    navigateIntent("checkout", undefined, { ref: "dashboard" }, { replace: true, scrollTop: true })
+  }
+
+  return (
+    <div>
+      <h1>Dashboard</h1>
+      <button onClick={handleCheckout}>Go to Checkout</button>
+      <button
+        onClick={() => {
+          navigateIntent("unknown-intent")
+        }}
+      >
+        Unknown Intent
+      </button>
+    </div>
+  )
+}
+```
+
+---
+
 # React Helpers
 
 ## useNavigateIntent
@@ -252,7 +282,7 @@ function Button() {
 ``` tsx
 import { IntentLink } from "intentx-react-router"
 
-<IntentLink intent="view-user" params={[1,2]}>
+<IntentLink intent="view-user" params={[1,2]} query={{ tab: "profile" }}>
   Open User
 </IntentLink>
 ```
@@ -260,20 +290,20 @@ import { IntentLink } from "intentx-react-router"
 Equivalent to:
 
 ```ts
-<Link to="/users/1/name/2" />
+<Link to="/users/1/name/2?tab=profile" />
 ```
 
 ---
 
-## useIntent
+## useIntentRouter
 
 Reads intent + params from URL.
 
 ``` ts
-import { useIntent } from "intentx-react-router"
+import { useIntentRouter } from "intentx-react-router"
 
 function Page() {
-  const { intent, params } = useIntent()
+  const { intent, params } = useIntentRouter()
 
   console.log(intent)
   console.log(params)
@@ -285,13 +315,13 @@ function Page() {
 Example result:
 
 ```ts
-  {
-    intent: "view-user",
-    params: {
-      userId: "1",
-      page: "2"
-    }
+{
+  intent: "view-user",
+  params: {
+    userId: "1",
+    page: "2"
   }
+}
 ```
 
 ---
@@ -362,34 +392,86 @@ preloadIntent("checkout")
 Generate path manually.
 
 ``` ts
-generatePathFromIntent("view-user", [1,2])
+generatePathFromIntent("view-user", [1,2], {
+  tab: "activity"
+})
 ```
 
 Result:
 ```ts
-/users/1/name/2
+/users/1/name/2?tab=activity
 ```
 ---
 
 # Resolve Intent From URL
 
 ``` ts
-resolveIntentFromUrl("/users/1/name/2")
+resolveIntentFromUrl("/users/1/name/2?tab=activity")
 ```
 
 Result:
 ```ts
-    {
-      intent: "view-user",
-      params: {
-        userId: "1",
-        page: "2"
-      }
-    }
+{
+  intent: "view-user",
+  params: {
+    userId: "1",
+    page: "2"
+  },
+  query: {
+    tab: "activity"
+  }
+}
 ```
 
 ---
 
+# Event-Driven Navigation
+
+Example
+
+```ts
+import { createEventBus } from "eventbus-z"
+import { navigateIntent } from "intentx-react-router"
+
+const bus = createEventBus()
+
+// Somewhere in your app
+bus.$on("CHECKOUT_REQUESTED", (userId) => {
+  navigateIntent("checkout", { userId })
+})
+```
+
+Trigger navigation from anywhere:
+```ts
+bus.$emit("CHECKOUT_REQUESTED", 42)
+```
+
+Result:
+```ts
+/checkout?userId=42
+```
+
+Why this is powerful
+- Navigation becomes decoupled from UI components.
+
+Instead of:
+
+```ts
+<button onClick={() => navigate("/checkout")} />
+```
+
+You can emit a domain event:
+```ts
+bus.$emit("CHECKOUT_REQUESTED")
+```
+
+This allows:
+- UI-agnostic navigation
+- better architecture in large apps
+- seamless micro-frontend communication
+
+---
+
 # Comparison
 
 | Criteria                | intent-router | React Router |
@@ -400,6 +482,7 @@ Result:
 | Micro-frontend friendly | ✅            | ⚠️            |
 | Reverse routing         | ✅            | ❌            |
 | Type-safe intent params | ✅            | ⚠️            |
+| Query support           | ✅            | ⚠️            |
 
 ---
 

package/build/core/intentCore.d.ts

@@ -1,17 +1,27 @@
+import type { GlobalBus } from "eventbus-z";
 type IntentMap = Record<string, string>;
 type GuardFn = (intent: string, params: any) => boolean | string | void;
-type NavigateFn = (path: string) => void;
+type NavigateFn = (path: string, options?: {
+    replace?: boolean;
+    scrollTop?: boolean;
+}) => void;
 type PreloadFn = () => Promise<any> | void;
 export declare function createIntentRouter(map: IntentMap): void;
 export declare function bindNavigate(fn: NavigateFn): void;
-export declare function navigateIntent(intent: string, params?: Record<string, any> | any[] | string | number): void;
+export declare function setFallbackPath(path: string): void;
+export declare function navigateIntent<P = any>(intent: string, params?: P | any[] | string | number, query?: Record<string, any>, options?: {
+    replace?: boolean;
+    scrollTop?: boolean;
+}): void;
 export declare function addIntentGuard(fn: GuardFn): void;
 export declare function addIntentGuardFor(intent: string, fn: GuardFn): void;
 export declare function addIntentPreload(intent: string, fn: PreloadFn): void;
 export declare function preloadIntent(intent: string): void;
-export declare function generatePathFromIntent(intent: string, params?: Record<string, any> | any[] | string | number): string;
+export declare function generatePathFromIntent(intent: string, params?: Record<string, any> | any[] | string | number, query?: Record<string, any>): string;
 export declare function resolveIntentFromUrl(url: string): {
     intent: string;
     params: Record<string, any>;
+    query: Record<string, any>;
 } | null;
+export declare function setSharedBus(externalBus: GlobalBus): void;
 export {};

package/build/index.esm.js

@@ -1 +1 @@
-import{createEventBus as n}from"eventbus-z";import{jsx as t}from"react/jsx-runtime";import{Link as r,useLocation as o,useNavigate as e}from"react-router-dom";import{useEffect as i}from"react";const c=n(),u="INTENT_NAVIGATE";let s={},f=null,a=!1;const l=[],p={},m={};function h(n){s=n}function v(n){f=n,a||(c.$onMultiple(u,E),a=!0)}function d(n,t){c.$emit(u,{intent:n,params:t})}function g(n){l.push(n)}function y(n,t){p[n]||(p[n]=[]),p[n].push(t)}function A(n,t){m[n]||(m[n]=[]),m[n].push(t)}function w(n){z(n)}function E(n){const t=s[n.intent];if(!t)return void console.warn("Unknown intent:",n.intent);const r=$(t,n.params);for(const t of l){const o=t(n.intent,r);if(!1===o)return;if("string"==typeof o)return void(null==f||f(o))}const o=p[n.intent]||[];for(const t of o){const o=t(n.intent,r);if(!1===o)return;if("string"==typeof o)return void(null==f||f(o))}z(n.intent);const e=_(t,r);null==f||f(e)}function z(n){const t=m[n];if(t)for(const n of t)try{const t=n();t instanceof Promise&&t.catch(()=>{})}catch{}}function $(n,t){const r=function(n){const t=[];return n.replace(/:([A-Za-z0-9_]+)/g,(n,r)=>(t.push(r),"")),t}(n);if(!t)return{};if(Array.isArray(t)){const n={};return r.forEach((r,o)=>{void 0===t[o]&&console.warn(`Missing param "${r}"`),n[r]=t[o]}),n}return"object"==typeof t?t:1===r.length?{[r[0]]:t}:{}}function _(n,t){return n.replace(/:([A-Za-z0-9_]+)/g,(n,r)=>{var o;return null!==(o=t[r])&&void 0!==o?o:""})}function x(n,t){const r=s[n];if(!r)return"";return _(r,$(r,t))}function N(n){for(const t in s){const r=s[t],o=[],e=new RegExp("^"+r.replace(/:([A-Za-z0-9_]+)/g,(n,t)=>(o.push(t),"([^/]+)"))+"$"),i=n.match(e);if(!i)continue;const c={};return o.forEach((n,t)=>{c[n]=i[t+1]}),{intent:t,params:c}}return null}function P({intent:n,params:o,query:e,children:i}){let c=x(n,o);if(e){const n=new URLSearchParams(e).toString();n&&(c+="?"+n)}return t(r,{to:c,children:i})}function R(){var n,t;const r=o(),e=N(r.pathname),i=new URLSearchParams(r.search),c={};return i.forEach((n,t)=>{c[t]=n}),{intent:null!==(n=null==e?void 0:e.intent)&&void 0!==n?n:null,params:null!==(t=null==e?void 0:e.params)&&void 0!==t?t:{},query:c}}function S({intent:n,component:r}){const o=R();return o.intent!==n?null:t(r,{...o})}function T({navigate:n}){const t=e();return v(n||t),null}function U(){const n=e();return i(()=>{v(n)},[n]),d}export{P as IntentLink,S as IntentRoute,T as RouterBinder,g as addIntentGuard,y as addIntentGuardFor,A as addIntentPreload,v as bindNavigate,h as createIntentRouter,x as generatePathFromIntent,d as navigateIntent,w as preloadIntent,N as resolveIntentFromUrl,R as useIntent,U as useNavigateIntent};
+import{createEventBus as n}from"eventbus-z";import{jsx as t,Fragment as r,jsxs as o}from"react/jsx-runtime";import{Link as e,useLocation as i,useNavigate as c,BrowserRouter as u}from"react-router-dom";import{useEffect as a}from"react";const s=n();let f=null;let l={},p=null,m=!1;const d=[],h={},y={};let T=null;const A="undefined"!=typeof window&&!0===window.__INTENT_ROUTER_DEBUG__;function E(...n){A&&console.log("[IntentRouter]",...n)}function N(n){if(!n)return"";const t=new URLSearchParams;for(const r in n){const o=n[r];null!=o&&(Array.isArray(o)?o.forEach(n=>t.append(r,String(n))):t.append(r,String(o)))}const r=t.toString();return r?`?${r}`:""}function g(n){l=n,E("intent map loaded",n)}function w(n){p=n,m||(s.$onMultiple("INTENT_NAVIGATE",$),m=!0)}function I(n){T=n}function _(n,t,r,o){E("emit",n,{params:t,query:r});const e={intent:n,params:t,query:r,...o?{options:o}:{}};s.$emit("INTENT_NAVIGATE",e),f&&f.$emit("INTENT_NAVIGATE",e)}function v(n){d.push(n)}function R(n,t){h[n]||(h[n]=[]),h[n].push(t)}function q(n,t){y[n]||(y[n]=[]),y[n].push(t)}function U(n){G(n)}async function $(n){const t=l[n.intent];if(E("receive",n.intent,n),!t)return T&&p?.(T),void console.warn("Unknown intent:",n.intent);const r=S(t,n.params);for(const t of d){const o=await t(n.intent,r);if(!1===o)return;if("string"==typeof o)return void p?.(o,n.options)}const o=h[n.intent]||[];for(const t of o){const o=await t(n.intent,r);if(!1===o)return;if("string"==typeof o)return void p?.(o,n.options)}G(n.intent);const e=V(t,r)+N(n.query);E("navigate",{intent:n.intent,params:r,query:n.query,url:e}),p?.(e,n.options),f&&f.$emit("INTENT_NAVIGATE",n)}function G(n){const t=y[n];if(t)for(const n of t)try{const t=n();t instanceof Promise&&t.catch(()=>{})}catch{}}function S(n,t){const r=function(n){const t=[];return n.replace(/:([A-Za-z0-9_]+)/g,(n,r)=>(t.push(r),"")),t}(n);if(!t)return{};if(Array.isArray(t)){const n={};return r.forEach((r,o)=>{void 0===t[o]&&console.warn(`Missing param "${r}"`),n[r]=t[o]}),n}return"object"==typeof t?t:1===r.length?{[r[0]]:t}:{}}function V(n,t){return n.replace(/:([A-Za-z0-9_]+)/g,(n,r)=>{const o=t[r];return void 0!==o?encodeURIComponent(o):""})}function z(n,t,r){const o=l[n];if(!o)return"";return V(o,S(o,t))+N(r)}function P(n){const[t,r]=n.split("?"),o=function(n){if(!n)return{};const t=new URLSearchParams(n),r={};return t.forEach((n,t)=>{r[t]?Array.isArray(r[t])?r[t].push(n):r[t]=[r[t],n]:r[t]=n}),r}(r);for(const n in l){const r=l[n],e=[],i=new RegExp("^"+r.replace(/:([A-Za-z0-9_]+)/g,(n,t)=>(e.push(t),"([^/]+)"))+"$"),c=t.match(i);if(!c)continue;const u={};return e.forEach((n,t)=>{u[n]=decodeURIComponent(c[t+1])}),{intent:n,params:u,query:o}}return null}function b(n){f=n,f.$onMultiple("INTENT_NAVIGATE",$)}function k({intent:n,params:r,query:o,children:i,replace:c,scrollTop:u}){const a=z(n,r,o);return t(e,{to:a,replace:c,onClick:()=>{u&&window.scrollTo(0,0)},children:i})}function x(){const n=i(),t=P(n.pathname),r=new URLSearchParams(n.search),o={};return r.forEach((n,t)=>{o[t]=n}),{intent:t?.intent??null,params:t?.params??{},query:o}}function C({intent:n,component:o,fallback:e=null,loading:i,guard:c}){const u=x();return u?u.intent!==n?null:c&&!c(u)?t(r,{children:e}):t(o,{...u}):i??null}function L({navigate:n}){const t=c();return w(n||t),null}function M({children:n}){return o(u,{children:[t(L,{}),n]})}function Z(){const n=c();return a(()=>{w(n)},[n]),_}export{k as IntentLink,C as IntentRoute,M as IntentRouter,L as RouterBinder,v as addIntentGuard,R as addIntentGuardFor,q as addIntentPreload,w as bindNavigate,g as createIntentRouter,z as generatePathFromIntent,_ as navigateIntent,U as preloadIntent,P as resolveIntentFromUrl,I as setFallbackPath,b as setSharedBus,x as useIntentRouter,Z as useNavigateIntent};

package/build/index.js

@@ -1 +1 @@
-"use strict";var n=require("eventbus-z"),t=require("react/jsx-runtime"),e=require("react-router-dom"),r=require("react");const o=n.createEventBus(),i="INTENT_NAVIGATE";let u={},s=null,c=!1;const a=[],f={},l={};function p(n){s=n,c||(o.$onMultiple(i,v),c=!0)}function d(n,t){o.$emit(i,{intent:n,params:t})}function v(n){const t=u[n.intent];if(!t)return void console.warn("Unknown intent:",n.intent);const e=m(t,n.params);for(const t of a){const r=t(n.intent,e);if(!1===r)return;if("string"==typeof r)return void(null==s||s(r))}const r=f[n.intent]||[];for(const t of r){const r=t(n.intent,e);if(!1===r)return;if("string"==typeof r)return void(null==s||s(r))}h(n.intent);const o=x(t,e);null==s||s(o)}function h(n){const t=l[n];if(t)for(const n of t)try{const t=n();t instanceof Promise&&t.catch(()=>{})}catch{}}function m(n,t){const e=function(n){const t=[];return n.replace(/:([A-Za-z0-9_]+)/g,(n,e)=>(t.push(e),"")),t}(n);if(!t)return{};if(Array.isArray(t)){const n={};return e.forEach((e,r)=>{void 0===t[r]&&console.warn(`Missing param "${e}"`),n[e]=t[r]}),n}return"object"==typeof t?t:1===e.length?{[e[0]]:t}:{}}function x(n,t){return n.replace(/:([A-Za-z0-9_]+)/g,(n,e)=>{var r;return null!==(r=t[e])&&void 0!==r?r:""})}function g(n,t){const e=u[n];if(!e)return"";return x(e,m(e,t))}function I(n){for(const t in u){const e=u[t],r=[],o=new RegExp("^"+e.replace(/:([A-Za-z0-9_]+)/g,(n,t)=>(r.push(t),"([^/]+)"))+"$"),i=n.match(o);if(!i)continue;const s={};return r.forEach((n,t)=>{s[n]=i[t+1]}),{intent:t,params:s}}return null}function y(){var n,t;const r=e.useLocation(),o=I(r.pathname),i=new URLSearchParams(r.search),u={};return i.forEach((n,t)=>{u[t]=n}),{intent:null!==(n=null==o?void 0:o.intent)&&void 0!==n?n:null,params:null!==(t=null==o?void 0:o.params)&&void 0!==t?t:{},query:u}}exports.IntentLink=function({intent:n,params:r,query:o,children:i}){let u=g(n,r);if(o){const n=new URLSearchParams(o).toString();n&&(u+="?"+n)}return t.jsx(e.Link,{to:u,children:i})},exports.IntentRoute=function({intent:n,component:e}){const r=y();return r.intent!==n?null:t.jsx(e,{...r})},exports.RouterBinder=function({navigate:n}){const t=e.useNavigate();return p(n||t),null},exports.addIntentGuard=function(n){a.push(n)},exports.addIntentGuardFor=function(n,t){f[n]||(f[n]=[]),f[n].push(t)},exports.addIntentPreload=function(n,t){l[n]||(l[n]=[]),l[n].push(t)},exports.bindNavigate=p,exports.createIntentRouter=function(n){u=n},exports.generatePathFromIntent=g,exports.navigateIntent=d,exports.preloadIntent=function(n){h(n)},exports.resolveIntentFromUrl=I,exports.useIntent=y,exports.useNavigateIntent=function(){const n=e.useNavigate();return r.useEffect(()=>{p(n)},[n]),d};
+"use strict";var n=require("eventbus-z"),t=require("react/jsx-runtime"),e=require("react-router-dom"),r=require("react");const o=n.createEventBus();let i=null;let s={},c=null,u=!1;const a=[],p={},f={};let l=null;const d="undefined"!=typeof window&&!0===window.__INTENT_ROUTER_DEBUG__;function h(...n){d&&console.log("[IntentRouter]",...n)}function m(n){if(!n)return"";const t=new URLSearchParams;for(const e in n){const r=n[e];null!=r&&(Array.isArray(r)?r.forEach(n=>t.append(e,String(n))):t.append(e,String(r)))}const e=t.toString();return e?`?${e}`:""}function I(n){c=n,u||(o.$onMultiple("INTENT_NAVIGATE",g),u=!0)}function x(n,t,e,r){h("emit",n,{params:t,query:e});const s={intent:n,params:t,query:e,...r?{options:r}:{}};o.$emit("INTENT_NAVIGATE",s),i&&i.$emit("INTENT_NAVIGATE",s)}async function g(n){const t=s[n.intent];if(h("receive",n.intent,n),!t)return l&&c?.(l),void console.warn("Unknown intent:",n.intent);const e=N(t,n.params);for(const t of a){const r=await t(n.intent,e);if(!1===r)return;if("string"==typeof r)return void c?.(r,n.options)}const r=p[n.intent]||[];for(const t of r){const r=await t(n.intent,e);if(!1===r)return;if("string"==typeof r)return void c?.(r,n.options)}E(n.intent);const o=y(t,e)+m(n.query);h("navigate",{intent:n.intent,params:e,query:n.query,url:o}),c?.(o,n.options),i&&i.$emit("INTENT_NAVIGATE",n)}function E(n){const t=f[n];if(t)for(const n of t)try{const t=n();t instanceof Promise&&t.catch(()=>{})}catch{}}function N(n,t){const e=function(n){const t=[];return n.replace(/:([A-Za-z0-9_]+)/g,(n,e)=>(t.push(e),"")),t}(n);if(!t)return{};if(Array.isArray(t)){const n={};return e.forEach((e,r)=>{void 0===t[r]&&console.warn(`Missing param "${e}"`),n[e]=t[r]}),n}return"object"==typeof t?t:1===e.length?{[e[0]]:t}:{}}function y(n,t){return n.replace(/:([A-Za-z0-9_]+)/g,(n,e)=>{const r=t[e];return void 0!==r?encodeURIComponent(r):""})}function T(n,t,e){const r=s[n];if(!r)return"";return y(r,N(r,t))+m(e)}function A(n){const[t,e]=n.split("?"),r=function(n){if(!n)return{};const t=new URLSearchParams(n),e={};return t.forEach((n,t)=>{e[t]?Array.isArray(e[t])?e[t].push(n):e[t]=[e[t],n]:e[t]=n}),e}(e);for(const n in s){const e=s[n],o=[],i=new RegExp("^"+e.replace(/:([A-Za-z0-9_]+)/g,(n,t)=>(o.push(t),"([^/]+)"))+"$"),c=t.match(i);if(!c)continue;const u={};return o.forEach((n,t)=>{u[n]=decodeURIComponent(c[t+1])}),{intent:n,params:u,query:r}}return null}function v(){const n=e.useLocation(),t=A(n.pathname),r=new URLSearchParams(n.search),o={};return r.forEach((n,t)=>{o[t]=n}),{intent:t?.intent??null,params:t?.params??{},query:o}}function w({navigate:n}){const t=e.useNavigate();return I(n||t),null}exports.IntentLink=function({intent:n,params:r,query:o,children:i,replace:s,scrollTop:c}){const u=T(n,r,o);return t.jsx(e.Link,{to:u,replace:s,onClick:()=>{c&&window.scrollTo(0,0)},children:i})},exports.IntentRoute=function({intent:n,component:e,fallback:r=null,loading:o,guard:i}){const s=v();return s?s.intent!==n?null:i&&!i(s)?t.jsx(t.Fragment,{children:r}):t.jsx(e,{...s}):o??null},exports.IntentRouter=function({children:n}){return t.jsxs(e.BrowserRouter,{children:[t.jsx(w,{}),n]})},exports.RouterBinder=w,exports.addIntentGuard=function(n){a.push(n)},exports.addIntentGuardFor=function(n,t){p[n]||(p[n]=[]),p[n].push(t)},exports.addIntentPreload=function(n,t){f[n]||(f[n]=[]),f[n].push(t)},exports.bindNavigate=I,exports.createIntentRouter=function(n){s=n,h("intent map loaded",n)},exports.generatePathFromIntent=T,exports.navigateIntent=x,exports.preloadIntent=function(n){E(n)},exports.resolveIntentFromUrl=A,exports.setFallbackPath=function(n){l=n},exports.setSharedBus=function(n){i=n,i.$onMultiple("INTENT_NAVIGATE",g)},exports.useIntentRouter=v,exports.useNavigateIntent=function(){const n=e.useNavigate();return r.useEffect(()=>{I(n)},[n]),x};

package/build/router/IntentLink.d.ts

@@ -1,9 +1,10 @@
-import React from "react";
 type Props = {
     intent: string;
     params?: any;
     query?: Record<string, any>;
     children: React.ReactNode;
+    replace?: boolean;
+    scrollTop?: boolean;
 };
-export declare function IntentLink({ intent, params, query, children }: Props): JSX.Element;
+export declare function IntentLink({ intent, params, query, children, replace, scrollTop }: Props): JSX.Element;
 export {};

package/build/router/IntentRoute.d.ts

@@ -1,7 +1,10 @@
-import React from "react";
+import type { IntentData } from "./useIntentRouter";
 type Props = {
     intent: string;
     component: React.ComponentType<any>;
+    fallback?: React.ReactNode;
+    loading?: React.ReactNode;
+    guard?: (data: IntentData) => boolean;
 };
-export declare function IntentRoute({ intent, component: Component }: Props): JSX.Element | null;
+export declare function IntentRoute({ intent, component: Component, fallback, loading, guard, }: Props): React.ReactNode;
 export {};

package/build/router/IntentRouter.d.ts

@@ -0,0 +1,5 @@
+type Props = {
+    children: React.ReactNode;
+};
+export declare function IntentRouter({ children }: Props): JSX.Element;
+export {};

package/build/router/index.d.ts

@@ -1,5 +1,6 @@
 export * from "./IntentLink";
 export * from "./IntentRoute";
+export * from "./IntentRouter";
 export * from "./RouterBinder";
-export * from "./useIntent";
+export * from "./useIntentRouter";
 export * from "./useNavigateIntent";

package/build/router/useIntentRouter.d.ts

@@ -0,0 +1,6 @@
+export type IntentData<P = any> = {
+    intent?: string | null;
+    params?: P | any[] | string | number;
+    query?: Record<string, any>;
+};
+export declare function useIntentRouter(): IntentData;

package/package.json

@@ -1,10 +1,9 @@
 {
   "name": "intentx-react-router",
-  "version": "0.2.0",
+  "version": "1.0.0-z",
   "description": "Intent-based routing for React. Navigate by intent instead of URLs.",
   "author": "Delpi.Kye",
   "license": "MIT",
-
   "type": "module",
   "main": "./build/index.js",
   "module": "./build/index.esm.js",
@@ -16,7 +15,6 @@
       "require": "./build/index.js"
     }
   },
-
   "files": [
     "build"
   ],
@@ -27,11 +25,9 @@
     "watch": "rollup -c -w",
     "typecheck": "tsc --noEmit"
   },
-
   "engines": {
     "node": ">=16"
   },
-
   "repository": {
     "type": "git",
     "url": "https://github.com/delpikye-v/intentx-react-router.git"
@@ -52,7 +48,6 @@
     "spa",
     "routing"
   ],
-
   "peerDependencies": {
     "react": ">=18",
     "react-dom": ">=18",
@@ -79,7 +74,6 @@
     "tslib": "^2.6.2",
     "typescript": "^5.0.0"
   },
-
   "publishConfig": {
     "access": "public"
   }

package/build/router/useIntent.d.ts

@@ -1,5 +0,0 @@
-export declare function useIntent(): {
-    intent: string | null;
-    params: Record<string, any>;
-    query: Record<string, string>;
-};