@molecule/app-routing-react-router 1.2.1 → 1.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -3,7 +3,7 @@ AUTO-GENERATED — DO NOT EDIT THIS FILE.
3
3
  Generated by `mlcl sync-docs` from the package's src/index.ts JSDoc + mlcl/registry.json.
4
4
  Edits here are overwritten on the next commit (molecule's pre-commit hook regenerates).
5
5
  To change this document, edit the module-level JSDoc in src/index.ts.
6
- Generated: 2026-11-01T08:49:45.245Z
6
+ Generated: 2026-11-05T21:31:18.760Z
7
7
  -->
8
8
 
9
9
  # @molecule/app-routing-react-router
@@ -13,6 +13,14 @@ React Router (v7/v8) provider for `@molecule/app-routing`.
13
13
  This package provides a React Router implementation of the molecule Router interface,
14
14
  allowing you to use molecule's routing abstractions with React Router.
15
15
 
16
+ `useMoleculeRouter`, `useMoleculeQuery`, `useMoleculeNavigate`, and `useIsActive`
17
+ work inside any React Router router (BrowserRouter, HashRouter, MemoryRouter,
18
+ Router, or RouterProvider), from this package or React Router itself. No
19
+ MoleculeRouterProvider is required for these hooks. Mount MoleculeRouterProvider
20
+ only to bond the adapter for non-React `@molecule/app-routing` navigate()/getRouter(),
21
+ supply named routes, or receive onRouterReady. Hook-created adapters remain local
22
+ so multiple consumers cannot overwrite the global router bond.
23
+
16
24
  **Paginated or filtered page? Use `useListRoute` for its URL state.** It reads
17
25
  page, filters and selected views from the current URL; builds links that retain
18
26
  the current path/filters; and resets page when a filter or view changes. Declare
@@ -30,6 +38,7 @@ import { Routes, Route } from 'react-router'
30
38
  import { BrowserRouter, MoleculeRouterProvider } from '@molecule/app-routing-react-router'
31
39
 
32
40
  function App() {
41
+ // Optional: include this provider for non-React navigation or named routes.
33
42
  // MoleculeRouterProvider bonds the adapter automatically (calls setRouter in an
34
43
  // effect on mount), so @molecule/app-routing's navigate()/getRouter() drive THIS
35
44
  // real React Router — no manual setRouter wiring needed.
@@ -653,7 +662,8 @@ bonds it as the active singleton via `@molecule/app-routing`'s `setRouter`.
653
662
  Bonding happens in an effect on mount (and again whenever the location/params
654
663
  change), so `@molecule/app-routing`'s `navigate()`/`getRouter()` drive THIS real
655
664
  React Router adapter — no manual `setRouter` wiring required. Mount it once inside
656
- `<BrowserRouter>`.
665
+ any React Router router when non-React code needs the bond, named routes are
666
+ configured, or `onRouterReady` is needed. The routing hooks work without this provider.
657
667
 
658
668
  ```typescript
659
669
  function MoleculeRouterProvider(props: MoleculeRouterProviderProps): React.JSX.Element
@@ -665,7 +675,14 @@ function MoleculeRouterProvider(props: MoleculeRouterProviderProps): React.JSX.E
665
675
 
666
676
  #### `useMoleculeRouter()`
667
677
 
668
- Hook to get the molecule Router.
678
+ Hook to get the molecule Router inside any React Router router, including
679
+ BrowserRouter, HashRouter, MemoryRouter, Router, or RouterProvider from this
680
+ package or React Router itself. No MoleculeRouterProvider is required.
681
+
682
+ When MoleculeRouterProvider is mounted, returns its exact router with its named
683
+ routes. Otherwise creates a local adapter from React Router's hooks without
684
+ bonding it globally. Mount MoleculeRouterProvider for the non-React
685
+ `@molecule/app-routing` navigate()/getRouter() bond or onRouterReady.
669
686
 
670
687
  ```typescript
671
688
  function useMoleculeRouter(): Router
@@ -675,7 +692,9 @@ function useMoleculeRouter(): Router
675
692
 
676
693
  #### `useIsActive(path, exact)`
677
694
 
678
- Hook to check if a path is currently active.
695
+ Hook to check if a path is currently active inside any React Router router.
696
+ MoleculeRouterProvider is optional; mount it only for named routes, the
697
+ non-React navigate()/getRouter() bond, or onRouterReady.
679
698
 
680
699
  ```typescript
681
700
  function useIsActive(path: string, exact?: boolean): boolean
@@ -688,7 +707,9 @@ function useIsActive(path: string, exact?: boolean): boolean
688
707
 
689
708
  #### `useMoleculeNavigate()`
690
709
 
691
- Hook to get a navigate function with molecule Router options.
710
+ Hook to get a navigate function with molecule Router options inside any React
711
+ Router router. MoleculeRouterProvider is optional; mount it only for named
712
+ routes, the non-React navigate()/getRouter() bond, or onRouterReady.
692
713
 
693
714
  ```typescript
694
715
  function useMoleculeNavigate(): Router['navigate']
@@ -698,7 +719,9 @@ function useMoleculeNavigate(): Router['navigate']
698
719
 
699
720
  #### `useMoleculeQuery()`
700
721
 
701
- Hook to get current query params as an object.
722
+ Hook to get current query params as an object inside any React Router router.
723
+ MoleculeRouterProvider is optional; mount it only for named routes, the
724
+ non-React navigate()/getRouter() bond, or onRouterReady.
702
725
 
703
726
  ```typescript
704
727
  function useMoleculeQuery(): QueryParams
@@ -986,7 +1009,7 @@ Peer dependencies:
986
1009
  - **Do NOT wire the exported `provider` const** in a React Router app — it is a
987
1010
  no-hooks fallback (empty params, `window.location.href` navigation). Use
988
1011
  `MoleculeRouterProvider` (or `createReactRouter` with hook values) instead.
989
- - The provider must live INSIDE `<BrowserRouter>` (it calls React Router hooks).
1012
+ - The provider must live INSIDE a React Router router (it calls React Router hooks).
990
1013
  - **Import router components from this bond, never directly from React Router.**
991
1014
  Its wrappers turn transitions off, so a navigation renders the new route in the
992
1015
  same commit as the URL change. Import non-router APIs (`Routes`, `Route`, `Link`,
package/dist/hooks.d.ts CHANGED
@@ -29,7 +29,8 @@ export interface MoleculeRouterProviderProps {
29
29
  * Bonding happens in an effect on mount (and again whenever the location/params
30
30
  * change), so `@molecule/app-routing`'s `navigate()`/`getRouter()` drive THIS real
31
31
  * React Router adapter — no manual `setRouter` wiring required. Mount it once inside
32
- * `<BrowserRouter>`.
32
+ * any React Router router when non-React code needs the bond, named routes are
33
+ * configured, or `onRouterReady` is needed. The routing hooks work without this provider.
33
34
  *
34
35
  * @param props - The provider props (see {@link MoleculeRouterProviderProps}):
35
36
  * `children` (rendered inside the router context), `routes` (optional named-route
@@ -59,10 +60,17 @@ export interface MoleculeRouterProviderProps {
59
60
  */
60
61
  export declare function MoleculeRouterProvider(props: MoleculeRouterProviderProps): React.JSX.Element;
61
62
  /**
62
- * Hook to get the molecule Router.
63
+ * Hook to get the molecule Router inside any React Router router, including
64
+ * BrowserRouter, HashRouter, MemoryRouter, Router, or RouterProvider from this
65
+ * package or React Router itself. No MoleculeRouterProvider is required.
66
+ *
67
+ * When MoleculeRouterProvider is mounted, returns its exact router with its named
68
+ * routes. Otherwise creates a local adapter from React Router's hooks without
69
+ * bonding it globally. Mount MoleculeRouterProvider for the non-React
70
+ * `@molecule/app-routing` navigate()/getRouter() bond or onRouterReady.
63
71
  *
64
72
  * @returns The molecule Router instance
65
- * @throws {Error} If used outside MoleculeRouterProvider.
73
+ * @throws {Error} If used outside a React Router router; mount a router component.
66
74
  *
67
75
  * @example
68
76
  * ```tsx
@@ -79,7 +87,9 @@ export declare function MoleculeRouterProvider(props: MoleculeRouterProviderProp
79
87
  */
80
88
  export declare function useMoleculeRouter(): Router;
81
89
  /**
82
- * Hook to check if a path is currently active.
90
+ * Hook to check if a path is currently active inside any React Router router.
91
+ * MoleculeRouterProvider is optional; mount it only for named routes, the
92
+ * non-React navigate()/getRouter() bond, or onRouterReady.
83
93
  *
84
94
  * @param path - Path to check
85
95
  * @param exact - Whether to require exact match
@@ -99,7 +109,9 @@ export declare function useMoleculeRouter(): Router;
99
109
  */
100
110
  export declare function useIsActive(path: string, exact?: boolean): boolean;
101
111
  /**
102
- * Hook to get a navigate function with molecule Router options.
112
+ * Hook to get a navigate function with molecule Router options inside any React
113
+ * Router router. MoleculeRouterProvider is optional; mount it only for named
114
+ * routes, the non-React navigate()/getRouter() bond, or onRouterReady.
103
115
  *
104
116
  * @returns Navigate function
105
117
  *
@@ -117,7 +129,9 @@ export declare function useIsActive(path: string, exact?: boolean): boolean;
117
129
  */
118
130
  export declare function useMoleculeNavigate(): Router['navigate'];
119
131
  /**
120
- * Hook to get current query params as an object.
132
+ * Hook to get current query params as an object inside any React Router router.
133
+ * MoleculeRouterProvider is optional; mount it only for named routes, the
134
+ * non-React navigate()/getRouter() bond, or onRouterReady.
121
135
  *
122
136
  * @returns Query params object
123
137
  *
@@ -1 +1 @@
1
- {"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,EAEZ,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,cAAc,EAOpB,MAAM,OAAO,CAAA;AAOd,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAOtE;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAA;IAEnB;;OAEG;IACH,MAAM,CAAC,EAAE,eAAe,EAAE,CAAA;IAE1B;;OAEG;IACH,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;CACzC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,2BAA2B,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAgC5F;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAU1C;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAKlE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAAC,UAAU,CAAC,CAGxD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,IAAI,WAAW,CAK9C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,GACX,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,CA8ErD"}
1
+ {"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,EAEZ,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,cAAc,EAOpB,MAAM,OAAO,CAAA;AAad,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAOtE;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAA;IAEnB;;OAEG;IACH,MAAM,CAAC,EAAE,eAAe,EAAE,CAAA;IAE1B;;OAEG;IACH,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;CACzC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,2BAA2B,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAgC5F;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAqB1C;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAKlE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAAC,UAAU,CAAC,CAGxD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,IAAI,WAAW,CAK9C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,GACX,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,CA8ErD"}
package/dist/hooks.js CHANGED
@@ -5,7 +5,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
5
5
  * @module
6
6
  */
7
7
  import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState, } from 'react';
8
- import { useLocation, useNavigate, useParams, useSearchParams } from 'react-router';
8
+ import { useInRouterContext, useLocation, useNavigate, useParams, useSearchParams, } from 'react-router';
9
9
  import { t } from '@molecule/app-i18n';
10
10
  import { setRouter } from '@molecule/app-routing';
11
11
  import { createReactRouter } from './provider.js';
@@ -20,7 +20,8 @@ const MoleculeRouterContext = createContext(null);
20
20
  * Bonding happens in an effect on mount (and again whenever the location/params
21
21
  * change), so `@molecule/app-routing`'s `navigate()`/`getRouter()` drive THIS real
22
22
  * React Router adapter — no manual `setRouter` wiring required. Mount it once inside
23
- * `<BrowserRouter>`.
23
+ * any React Router router when non-React code needs the bond, named routes are
24
+ * configured, or `onRouterReady` is needed. The routing hooks work without this provider.
24
25
  *
25
26
  * @param props - The provider props (see {@link MoleculeRouterProviderProps}):
26
27
  * `children` (rendered inside the router context), `routes` (optional named-route
@@ -75,10 +76,17 @@ export function MoleculeRouterProvider(props) {
75
76
  return _jsx(MoleculeRouterContext.Provider, { value: router, children: children });
76
77
  }
77
78
  /**
78
- * Hook to get the molecule Router.
79
+ * Hook to get the molecule Router inside any React Router router, including
80
+ * BrowserRouter, HashRouter, MemoryRouter, Router, or RouterProvider from this
81
+ * package or React Router itself. No MoleculeRouterProvider is required.
82
+ *
83
+ * When MoleculeRouterProvider is mounted, returns its exact router with its named
84
+ * routes. Otherwise creates a local adapter from React Router's hooks without
85
+ * bonding it globally. Mount MoleculeRouterProvider for the non-React
86
+ * `@molecule/app-routing` navigate()/getRouter() bond or onRouterReady.
79
87
  *
80
88
  * @returns The molecule Router instance
81
- * @throws {Error} If used outside MoleculeRouterProvider.
89
+ * @throws {Error} If used outside a React Router router; mount a router component.
82
90
  *
83
91
  * @example
84
92
  * ```tsx
@@ -95,15 +103,23 @@ export function MoleculeRouterProvider(props) {
95
103
  */
96
104
  export function useMoleculeRouter() {
97
105
  const router = useContext(MoleculeRouterContext);
98
- if (!router) {
99
- throw new Error(t('routing.error.useMoleculeRouterOutsideProvider', undefined, {
100
- defaultValue: 'useMoleculeRouter must be used within a MoleculeRouterProvider',
106
+ const inRouter = useInRouterContext();
107
+ if (!inRouter) {
108
+ throw new Error(t('routing.error.useMoleculeRouterOutsideRouter', undefined, {
109
+ defaultValue: 'useMoleculeRouter must be used within a React Router router. Mount BrowserRouter, HashRouter, MemoryRouter, Router, or RouterProvider.',
101
110
  }));
102
111
  }
103
- return router;
112
+ // Always call the React Router hooks, including when the provider supplies the
113
+ // adapter. The guard above throws only for an invalid render outside any router.
114
+ const navigate = useNavigate();
115
+ const location = useLocation();
116
+ const params = useParams();
117
+ return useMemo(() => router ?? createReactRouter({ navigate, location, params }), [router, navigate, location, params]);
104
118
  }
105
119
  /**
106
- * Hook to check if a path is currently active.
120
+ * Hook to check if a path is currently active inside any React Router router.
121
+ * MoleculeRouterProvider is optional; mount it only for named routes, the
122
+ * non-React navigate()/getRouter() bond, or onRouterReady.
107
123
  *
108
124
  * @param path - Path to check
109
125
  * @param exact - Whether to require exact match
@@ -128,7 +144,9 @@ export function useIsActive(path, exact) {
128
144
  return useMemo(() => router.isActive(path, exact), [router, path, exact, location.pathname]);
129
145
  }
130
146
  /**
131
- * Hook to get a navigate function with molecule Router options.
147
+ * Hook to get a navigate function with molecule Router options inside any React
148
+ * Router router. MoleculeRouterProvider is optional; mount it only for named
149
+ * routes, the non-React navigate()/getRouter() bond, or onRouterReady.
132
150
  *
133
151
  * @returns Navigate function
134
152
  *
@@ -149,7 +167,9 @@ export function useMoleculeNavigate() {
149
167
  return router.navigate.bind(router);
150
168
  }
151
169
  /**
152
- * Hook to get current query params as an object.
170
+ * Hook to get current query params as an object inside any React Router router.
171
+ * MoleculeRouterProvider is optional; mount it only for named routes, the
172
+ * non-React navigate()/getRouter() bond, or onRouterReady.
153
173
  *
154
174
  * @returns Query params object
155
175
  *
package/dist/hooks.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.tsx"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.tsx"],"names":[],"mappings":"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"}
package/dist/index.d.ts CHANGED
@@ -4,6 +4,14 @@
4
4
  * This package provides a React Router implementation of the molecule Router interface,
5
5
  * allowing you to use molecule's routing abstractions with React Router.
6
6
  *
7
+ * `useMoleculeRouter`, `useMoleculeQuery`, `useMoleculeNavigate`, and `useIsActive`
8
+ * work inside any React Router router (BrowserRouter, HashRouter, MemoryRouter,
9
+ * Router, or RouterProvider), from this package or React Router itself. No
10
+ * MoleculeRouterProvider is required for these hooks. Mount MoleculeRouterProvider
11
+ * only to bond the adapter for non-React `@molecule/app-routing` navigate()/getRouter(),
12
+ * supply named routes, or receive onRouterReady. Hook-created adapters remain local
13
+ * so multiple consumers cannot overwrite the global router bond.
14
+ *
7
15
  * **Paginated or filtered page? Use `useListRoute` for its URL state.** It reads
8
16
  * page, filters and selected views from the current URL; builds links that retain
9
17
  * the current path/filters; and resets page when a filter or view changes. Declare
@@ -16,6 +24,7 @@
16
24
  * import { BrowserRouter, MoleculeRouterProvider } from '@molecule/app-routing-react-router'
17
25
  *
18
26
  * function App() {
27
+ * // Optional: include this provider for non-React navigation or named routes.
19
28
  * // MoleculeRouterProvider bonds the adapter automatically (calls setRouter in an
20
29
  * // effect on mount), so @molecule/app-routing's navigate()/getRouter() drive THIS
21
30
  * // real React Router — no manual setRouter wiring needed.
@@ -135,7 +144,7 @@
135
144
  * - **Do NOT wire the exported `provider` const** in a React Router app — it is a
136
145
  * no-hooks fallback (empty params, `window.location.href` navigation). Use
137
146
  * `MoleculeRouterProvider` (or `createReactRouter` with hook values) instead.
138
- * - The provider must live INSIDE `<BrowserRouter>` (it calls React Router hooks).
147
+ * - The provider must live INSIDE a React Router router (it calls React Router hooks).
139
148
  * - **Import router components from this bond, never directly from React Router.**
140
149
  * Its wrappers turn transitions off, so a navigation renders the new route in the
141
150
  * same commit as the URL change. Import non-router APIs (`Routes`, `Route`, `Link`,
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsJG;AAEH,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,YAAY,EACV,WAAW,EACX,eAAe,EACf,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,UAAU,EACV,WAAW,EACX,YAAY,GACb,MAAM,YAAY,CAAA;AACnB,cAAc,mBAAmB,CAAA;AACjC,cAAc,gBAAgB,CAAA"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+JG;AAEH,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,YAAY,EACV,WAAW,EACX,eAAe,EACf,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,UAAU,EACV,WAAW,EACX,YAAY,GACb,MAAM,YAAY,CAAA;AACnB,cAAc,mBAAmB,CAAA;AACjC,cAAc,gBAAgB,CAAA"}
package/dist/index.js CHANGED
@@ -4,6 +4,14 @@
4
4
  * This package provides a React Router implementation of the molecule Router interface,
5
5
  * allowing you to use molecule's routing abstractions with React Router.
6
6
  *
7
+ * `useMoleculeRouter`, `useMoleculeQuery`, `useMoleculeNavigate`, and `useIsActive`
8
+ * work inside any React Router router (BrowserRouter, HashRouter, MemoryRouter,
9
+ * Router, or RouterProvider), from this package or React Router itself. No
10
+ * MoleculeRouterProvider is required for these hooks. Mount MoleculeRouterProvider
11
+ * only to bond the adapter for non-React `@molecule/app-routing` navigate()/getRouter(),
12
+ * supply named routes, or receive onRouterReady. Hook-created adapters remain local
13
+ * so multiple consumers cannot overwrite the global router bond.
14
+ *
7
15
  * **Paginated or filtered page? Use `useListRoute` for its URL state.** It reads
8
16
  * page, filters and selected views from the current URL; builds links that retain
9
17
  * the current path/filters; and resets page when a filter or view changes. Declare
@@ -16,6 +24,7 @@
16
24
  * import { BrowserRouter, MoleculeRouterProvider } from '@molecule/app-routing-react-router'
17
25
  *
18
26
  * function App() {
27
+ * // Optional: include this provider for non-React navigation or named routes.
19
28
  * // MoleculeRouterProvider bonds the adapter automatically (calls setRouter in an
20
29
  * // effect on mount), so @molecule/app-routing's navigate()/getRouter() drive THIS
21
30
  * // real React Router — no manual setRouter wiring needed.
@@ -135,7 +144,7 @@
135
144
  * - **Do NOT wire the exported `provider` const** in a React Router app — it is a
136
145
  * no-hooks fallback (empty params, `window.location.href` navigation). Use
137
146
  * `MoleculeRouterProvider` (or `createReactRouter` with hook values) instead.
138
- * - The provider must live INSIDE `<BrowserRouter>` (it calls React Router hooks).
147
+ * - The provider must live INSIDE a React Router router (it calls React Router hooks).
139
148
  * - **Import router components from this bond, never directly from React Router.**
140
149
  * Its wrappers turn transitions off, so a navigation renders the new route in the
141
150
  * same commit as the URL change. Import non-router APIs (`Routes`, `Route`, `Link`,
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsJG;AAEH,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAe5B,cAAc,mBAAmB,CAAA;AACjC,cAAc,gBAAgB,CAAA"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+JG;AAEH,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAe5B,cAAc,mBAAmB,CAAA;AACjC,cAAc,gBAAgB,CAAA"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@molecule/app-routing-react-router",
3
- "version": "1.2.1",
3
+ "version": "1.2.2",
4
4
  "description": "React Router v7 provider for @molecule/app-routing",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",