@molecule/app-routing-react-router 1.0.1 → 1.1.0

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/dist/index.d.ts CHANGED
@@ -4,6 +4,12 @@
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
+ * **Paginated or filtered page? Use `useListRoute` for its URL state.** It reads
8
+ * page, filters and selected views from the current URL; builds links that retain
9
+ * the current path/filters; and resets page when a filter or view changes. Declare
10
+ * path variants explicitly instead of translating API filters into browser URLs.
11
+ * It works under ordinary `BrowserRouter` without a data router or an extra provider.
12
+ *
7
13
  * @example
8
14
  * ```tsx
9
15
  * import { BrowserRouter, Routes, Route } from 'react-router'
@@ -26,7 +32,98 @@
26
32
  * }
27
33
  * ```
28
34
  *
35
+ * @example
36
+ * A list with query-selected views. The public URL remains public after login;
37
+ * a protected view waits for session restoration. Include the signed-in principal
38
+ * in the data key so one user's cached response cannot appear for another user.
39
+ *
40
+ * ```tsx
41
+ * import { Link } from 'react-router'
42
+ * import { useAuth, useHttpClient, useTranslation } from '@molecule/app-react'
43
+ * import { unwrapList } from '@molecule/app-http'
44
+ * import { useQuery } from '@molecule/app-query-react'
45
+ * import { useListRoute } from '@molecule/app-routing-react-router'
46
+ *
47
+ * interface Entry { id: string; title: string }
48
+ *
49
+ * function ActivityList() {
50
+ * const { status, user } = useAuth<{ id: string }>()
51
+ * const http = useHttpClient()
52
+ * const { t } = useTranslation()
53
+ * const list = useListRoute({
54
+ * pageSize: 10,
55
+ * filters: { category: { query: 'category' }, sort: { defaultValue: 'recent' } },
56
+ * selections: {
57
+ * public: { path: '/activity', query: { view: undefined } },
58
+ * personal: { path: '/activity', query: { view: 'personal' }, requiresAuth: true },
59
+ * },
60
+ * auth: { status, redirectTo: '/sign-in' },
61
+ * })
62
+ * const entries = useQuery(list.canLoad ? {
63
+ * key: ['activity', user?.id ?? 'anonymous', list.selection, list.filters, list.page],
64
+ * fetch: async (signal) => unwrapList<Entry>(await http.get('/api/activity', {
65
+ * signal,
66
+ * params: { ...list.filters, view: list.selection, limit: list.pageSize, offset: list.offset },
67
+ * })),
68
+ * } : null)
69
+ * return <>
70
+ * <Link to={list.href({ selection: 'public' })}>
71
+ * {t('activity.public', undefined, { defaultValue: 'Public activity' })}
72
+ * </Link>
73
+ * {user && <Link to={list.href({ selection: 'personal' })}>
74
+ * {t('activity.personal', undefined, { defaultValue: 'Your activity' })}
75
+ * </Link>}
76
+ * <select value={list.filters.sort} onChange={(event) => list.setFilters({ sort: event.target.value })}>
77
+ * <option value="recent">{t('activity.recent', undefined, { defaultValue: 'Recent' })}</option>
78
+ * <option value="oldest">{t('activity.oldest', undefined, { defaultValue: 'Oldest' })}</option>
79
+ * </select>
80
+ * {entries.data?.map((entry) => <p key={entry.id}>{entry.title}</p>)}
81
+ * <Link to={list.href({ page: list.page + 1 })}>
82
+ * {t('activity.next', undefined, { defaultValue: 'Next page' })}
83
+ * </Link>
84
+ * </>
85
+ * }
86
+ * ```
87
+ *
88
+ * @example
89
+ * Path-selected views and path-backed filters use the same hook. The browser route
90
+ * contract determines the URL; API filters can be derived separately from `params`.
91
+ *
92
+ * ```tsx
93
+ * // Mount the same page on /members/:member and /members/:member/saved.
94
+ * const list = useListRoute({
95
+ * selections: {
96
+ * authored: { path: '/members/:member' },
97
+ * saved: { path: '/members/:member/saved' },
98
+ * },
99
+ * })
100
+ * // <Link to={list.href({ selection: 'saved' })}>…</Link> retains :member.
101
+ * // list.href({ page: 2 }) stays on /members/:member/saved?page=2.
102
+ * // Use list.params.member in the API request; it is not another query key.
103
+ *
104
+ * // On /topics/:topic, changing page keeps the encoded topic in the path.
105
+ * const topics = useListRoute({
106
+ * path: '/topics/:topic',
107
+ * filters: { topic: { param: 'topic' }, sort: { defaultValue: 'recent' } },
108
+ * })
109
+ * // topics.setFilters({ topic: 'type systems' }) changes the path and resets page.
110
+ * // PaginationBar can use page={topics.page}, pageSize={topics.pageSize},
111
+ * // onPageChange={topics.setPage}; custom links use topics.href({ page: next }).
112
+ * ```
113
+ *
29
114
  * @remarks
115
+ * - `useListRoute` derives state from the URL on every render, including Back/Forward.
116
+ * Do not mirror selection/page in local state or rewrite an explicit public view
117
+ * when auth changes. Auth redirects replace the protected history entry only after
118
+ * a confirmed `unauthenticated` status; `loading` and `unavailable` remain in place.
119
+ * - Pass `null` to `useQuery` when `list.canLoad` is false. Public views stay ready;
120
+ * protected views do not fall back to a public request while auth is unresolved.
121
+ * - A selection's `query` owns only its configured keys. `undefined` means absent;
122
+ * unrelated query values and the hash survive pagination and selection changes.
123
+ * Filter/selection changes reset page one atomically, unless `page` is explicit.
124
+ * - `useListRoute` does not call React Router's `useNavigation`: that hook needs a
125
+ * data router and throws under `BrowserRouter`. Use the data query's `isFetching`
126
+ * for list loading. No UI library, CSS class map, or data cache is required by the hook.
30
127
  * - **`MoleculeRouterProvider` bonds the router for you.** On mount it calls
31
128
  * `@molecule/app-routing`'s `setRouter` with the live adapter, so other molecule
32
129
  * packages' `navigate()`/`getRouter()` drive React Router (real SPA navigation) —
@@ -43,7 +140,9 @@
43
140
  * @module @molecule/app-routing-react-router
44
141
  */
45
142
  export * from './hooks.js';
143
+ export * from './list-types.js';
46
144
  export * from './provider.js';
47
145
  export * from './types.js';
146
+ export * from './useListRoute.js';
48
147
  export * from './utilities.js';
49
148
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4IG;AAEH,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA;AACjC,cAAc,gBAAgB,CAAA"}
package/dist/index.js CHANGED
@@ -4,6 +4,12 @@
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
+ * **Paginated or filtered page? Use `useListRoute` for its URL state.** It reads
8
+ * page, filters and selected views from the current URL; builds links that retain
9
+ * the current path/filters; and resets page when a filter or view changes. Declare
10
+ * path variants explicitly instead of translating API filters into browser URLs.
11
+ * It works under ordinary `BrowserRouter` without a data router or an extra provider.
12
+ *
7
13
  * @example
8
14
  * ```tsx
9
15
  * import { BrowserRouter, Routes, Route } from 'react-router'
@@ -26,7 +32,98 @@
26
32
  * }
27
33
  * ```
28
34
  *
35
+ * @example
36
+ * A list with query-selected views. The public URL remains public after login;
37
+ * a protected view waits for session restoration. Include the signed-in principal
38
+ * in the data key so one user's cached response cannot appear for another user.
39
+ *
40
+ * ```tsx
41
+ * import { Link } from 'react-router'
42
+ * import { useAuth, useHttpClient, useTranslation } from '@molecule/app-react'
43
+ * import { unwrapList } from '@molecule/app-http'
44
+ * import { useQuery } from '@molecule/app-query-react'
45
+ * import { useListRoute } from '@molecule/app-routing-react-router'
46
+ *
47
+ * interface Entry { id: string; title: string }
48
+ *
49
+ * function ActivityList() {
50
+ * const { status, user } = useAuth<{ id: string }>()
51
+ * const http = useHttpClient()
52
+ * const { t } = useTranslation()
53
+ * const list = useListRoute({
54
+ * pageSize: 10,
55
+ * filters: { category: { query: 'category' }, sort: { defaultValue: 'recent' } },
56
+ * selections: {
57
+ * public: { path: '/activity', query: { view: undefined } },
58
+ * personal: { path: '/activity', query: { view: 'personal' }, requiresAuth: true },
59
+ * },
60
+ * auth: { status, redirectTo: '/sign-in' },
61
+ * })
62
+ * const entries = useQuery(list.canLoad ? {
63
+ * key: ['activity', user?.id ?? 'anonymous', list.selection, list.filters, list.page],
64
+ * fetch: async (signal) => unwrapList<Entry>(await http.get('/api/activity', {
65
+ * signal,
66
+ * params: { ...list.filters, view: list.selection, limit: list.pageSize, offset: list.offset },
67
+ * })),
68
+ * } : null)
69
+ * return <>
70
+ * <Link to={list.href({ selection: 'public' })}>
71
+ * {t('activity.public', undefined, { defaultValue: 'Public activity' })}
72
+ * </Link>
73
+ * {user && <Link to={list.href({ selection: 'personal' })}>
74
+ * {t('activity.personal', undefined, { defaultValue: 'Your activity' })}
75
+ * </Link>}
76
+ * <select value={list.filters.sort} onChange={(event) => list.setFilters({ sort: event.target.value })}>
77
+ * <option value="recent">{t('activity.recent', undefined, { defaultValue: 'Recent' })}</option>
78
+ * <option value="oldest">{t('activity.oldest', undefined, { defaultValue: 'Oldest' })}</option>
79
+ * </select>
80
+ * {entries.data?.map((entry) => <p key={entry.id}>{entry.title}</p>)}
81
+ * <Link to={list.href({ page: list.page + 1 })}>
82
+ * {t('activity.next', undefined, { defaultValue: 'Next page' })}
83
+ * </Link>
84
+ * </>
85
+ * }
86
+ * ```
87
+ *
88
+ * @example
89
+ * Path-selected views and path-backed filters use the same hook. The browser route
90
+ * contract determines the URL; API filters can be derived separately from `params`.
91
+ *
92
+ * ```tsx
93
+ * // Mount the same page on /members/:member and /members/:member/saved.
94
+ * const list = useListRoute({
95
+ * selections: {
96
+ * authored: { path: '/members/:member' },
97
+ * saved: { path: '/members/:member/saved' },
98
+ * },
99
+ * })
100
+ * // <Link to={list.href({ selection: 'saved' })}>…</Link> retains :member.
101
+ * // list.href({ page: 2 }) stays on /members/:member/saved?page=2.
102
+ * // Use list.params.member in the API request; it is not another query key.
103
+ *
104
+ * // On /topics/:topic, changing page keeps the encoded topic in the path.
105
+ * const topics = useListRoute({
106
+ * path: '/topics/:topic',
107
+ * filters: { topic: { param: 'topic' }, sort: { defaultValue: 'recent' } },
108
+ * })
109
+ * // topics.setFilters({ topic: 'type systems' }) changes the path and resets page.
110
+ * // PaginationBar can use page={topics.page}, pageSize={topics.pageSize},
111
+ * // onPageChange={topics.setPage}; custom links use topics.href({ page: next }).
112
+ * ```
113
+ *
29
114
  * @remarks
115
+ * - `useListRoute` derives state from the URL on every render, including Back/Forward.
116
+ * Do not mirror selection/page in local state or rewrite an explicit public view
117
+ * when auth changes. Auth redirects replace the protected history entry only after
118
+ * a confirmed `unauthenticated` status; `loading` and `unavailable` remain in place.
119
+ * - Pass `null` to `useQuery` when `list.canLoad` is false. Public views stay ready;
120
+ * protected views do not fall back to a public request while auth is unresolved.
121
+ * - A selection's `query` owns only its configured keys. `undefined` means absent;
122
+ * unrelated query values and the hash survive pagination and selection changes.
123
+ * Filter/selection changes reset page one atomically, unless `page` is explicit.
124
+ * - `useListRoute` does not call React Router's `useNavigation`: that hook needs a
125
+ * data router and throws under `BrowserRouter`. Use the data query's `isFetching`
126
+ * for list loading. No UI library, CSS class map, or data cache is required by the hook.
30
127
  * - **`MoleculeRouterProvider` bonds the router for you.** On mount it calls
31
128
  * `@molecule/app-routing`'s `setRouter` with the live adapter, so other molecule
32
129
  * packages' `navigate()`/`getRouter()` drive React Router (real SPA navigation) —
@@ -43,7 +140,9 @@
43
140
  * @module @molecule/app-routing-react-router
44
141
  */
45
142
  export * from './hooks.js';
143
+ export * from './list-types.js';
46
144
  export * from './provider.js';
47
145
  export * from './types.js';
146
+ export * from './useListRoute.js';
48
147
  export * from './utilities.js';
49
148
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4IG;AAEH,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA;AACjC,cAAc,gBAAgB,CAAA"}
@@ -0,0 +1,86 @@
1
+ import type { NavigateOptions, QueryParams, RouteParams } from './types.js';
2
+ /** Where a list filter lives in the URL. Path values take precedence over query values. */
3
+ export interface ListRouteFilter {
4
+ /** Query key; defaults to the filter's name when `param` is absent. */
5
+ query?: string;
6
+ /** Path parameter supplied by the current route, such as `category` in `/topics/:category`. */
7
+ param?: string;
8
+ /** Value returned when neither URL source supplies a value; omitted from generated queries. */
9
+ defaultValue?: string;
10
+ }
11
+ /** A selectable list view, expressed in the app's own route contract. */
12
+ export interface ListRouteSelection {
13
+ /** Absolute route pattern, for example `/members/:member/saved`. */
14
+ path: string;
15
+ /** Query values identifying this view. An undefined value requires the key to be absent. */
16
+ query?: QueryParams;
17
+ /** A protected selection never loads before authentication is confirmed. */
18
+ requiresAuth?: boolean;
19
+ }
20
+ /** Authentication readiness for protected list selections. */
21
+ export interface ListRouteAuth {
22
+ /** The auth client's status. Unavailable is distinct from a signed-out session. */
23
+ status: 'loading' | 'authenticated' | 'unauthenticated' | 'unavailable';
24
+ /** App-owned sign-in URL. A signed-out protected visit replaces history with this URL. */
25
+ redirectTo: string;
26
+ }
27
+ /** URL-backed list state configuration; it neither invents nor rewrites the app's route contract. */
28
+ export interface ListRouteOptions<Filter extends string = string, Selection extends string = string> {
29
+ /** Fixed number of items per page; defaults to 20. */
30
+ pageSize?: number;
31
+ /** Query key for a 1-indexed page; defaults to `page`. Page one omits the key. */
32
+ pageParam?: string;
33
+ /** Route pattern for changing path-backed filters when no selections are configured. */
34
+ path?: string;
35
+ /** Filters and their URL sources. API-only filters do not belong here. */
36
+ filters?: Record<Filter, ListRouteFilter>;
37
+ /** Named views sharing a list. Both path variants and query variants are supported. */
38
+ selections?: Record<Selection, ListRouteSelection>;
39
+ /** Tie-breaker when multiple selections match, or fallback when none matches. */
40
+ defaultSelection?: NoInfer<Selection>;
41
+ /** Required when a selection is protected. Public views remain public as auth changes. */
42
+ auth?: ListRouteAuth;
43
+ }
44
+ /** A single atomic list navigation. Filter/selection changes reset page unless explicitly supplied. */
45
+ export interface ListRouteChange<Filter extends string = string, Selection extends string = string> {
46
+ /** Target page, starting at one. */
47
+ page?: number;
48
+ /** Patch of URL filter values. Undefined removes a query filter. */
49
+ filters?: Partial<Record<Filter, string | undefined>>;
50
+ /** Target view, resolved through its configured path and query values. */
51
+ selection?: Selection;
52
+ /** Optional path parameter changes, for example when opening a different member's saved view. */
53
+ params?: RouteParams;
54
+ }
55
+ /** Reactive list state and navigation, derived directly from React Router's current location. */
56
+ export interface ListRouteResult<Filter extends string = string, Selection extends string = string> {
57
+ /** Current 1-indexed page; malformed and non-positive URL values read as page one. */
58
+ page: number;
59
+ /** Configured items per page. */
60
+ pageSize: number;
61
+ /** Zero-indexed item offset for an API request. */
62
+ offset: number;
63
+ /** Current URL filter values, including values supplied by path parameters. */
64
+ filters: Record<Filter, string | undefined>;
65
+ /** Matching view, or the configured fallback. */
66
+ selection: Selection | undefined;
67
+ /** Decoded current path parameters, also usable as API-only filters. */
68
+ params: RouteParams;
69
+ /** False while a protected selection is awaiting auth, signed out, or unavailable. */
70
+ canLoad: boolean;
71
+ /** Readiness for the current view. A public view always stays ready. */
72
+ status: 'ready' | 'loading' | 'unauthenticated' | 'unavailable';
73
+ /** Sign-in destination while a signed-out protected view is being redirected. */
74
+ redirectTo: string | undefined;
75
+ /** Build a real link target, preserving the current pathname, unrelated query values and hash. */
76
+ href: (change?: ListRouteChange<Filter, Selection>) => string;
77
+ /** Navigate atomically. Location state is preserved unless options explicitly replace it. */
78
+ navigate: (change: ListRouteChange<Filter, Selection>, options?: NavigateOptions) => void;
79
+ /** Change only the page, retaining the current filters and view. */
80
+ setPage: (page: number, options?: NavigateOptions) => void;
81
+ /** Patch URL filters and return to page one. */
82
+ setFilters: (filters: Partial<Record<Filter, string | undefined>>, options?: NavigateOptions) => void;
83
+ /** Select a configured view at page one, preserving current route parameters. */
84
+ select: (selection: Selection, options?: NavigateOptions) => void;
85
+ }
86
+ //# sourceMappingURL=list-types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"list-types.d.ts","sourceRoot":"","sources":["../src/list-types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=list-types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"list-types.js","sourceRoot":"","sources":["../src/list-types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,14 @@
1
+ import type { ListRouteOptions, ListRouteResult } from './list-types.js';
2
+ /**
3
+ * Own URL-backed pagination, filters and selected views without mirrored state or navigation effects.
4
+ * Works inside `BrowserRouter`, `MemoryRouter` and data routers; no data-router-only
5
+ * `useNavigation` call or MoleculeRouterProvider is needed. Ordinary links, direct visits,
6
+ * and Back/Forward all read the same URL. Page links retain path parameters and unrelated
7
+ * queries; changing filters or views resets the page atomically. Protected views wait for
8
+ * auth and redirect only a confirmed signed-out session, with `state.returnTo` set.
9
+ *
10
+ * @param options - App-owned filter sources, view paths, pagination and optional auth readiness.
11
+ * @returns Reactive list state plus link builders and navigation actions. Gate data queries with `canLoad`.
12
+ */
13
+ export declare function useListRoute<Filter extends string = string, Selection extends string = string>(options?: ListRouteOptions<Filter, Selection>): ListRouteResult<Filter, Selection>;
14
+ //# sourceMappingURL=useListRoute.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"useListRoute.d.ts","sourceRoot":"","sources":["../src/useListRoute.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAmB,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAuCzF;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM,EAAE,SAAS,SAAS,MAAM,GAAG,MAAM,EAC5F,OAAO,GAAE,gBAAgB,CAAC,MAAM,EAAE,SAAS,CAAM,GAChD,eAAe,CAAC,MAAM,EAAE,SAAS,CAAC,CAgJpC"}
@@ -0,0 +1,182 @@
1
+ import { useEffect } from 'react';
2
+ import { matchPath as matchReactPath, useLocation, useNavigate, useParams } from 'react-router';
3
+ import { generatePath } from './utilities.js';
4
+ /** Parse a positive safe integer without treating `2oops`, `1.5` or an overflow as a page. */
5
+ function readPage(value, pageSize) {
6
+ if (!value || !/^[1-9]\d*$/.test(value))
7
+ return 1;
8
+ const page = Number(value);
9
+ return Number.isSafeInteger(page) && Number.isSafeInteger((page - 1) * pageSize) ? page : 1;
10
+ }
11
+ /** Apply only the explicitly owned query keys, leaving unrelated and repeated values intact. */
12
+ function patchQuery(search, patch) {
13
+ for (const [key, value] of Object.entries(patch)) {
14
+ search.delete(key);
15
+ if (Array.isArray(value))
16
+ value.forEach((entry) => search.append(key, entry));
17
+ else if (value !== undefined)
18
+ search.set(key, value);
19
+ }
20
+ }
21
+ /** Match a selection's query constraints, including explicit absence and repeated values. */
22
+ function matchesQuery(search, query = {}) {
23
+ return Object.entries(query).every(([key, value]) => {
24
+ const expected = value === undefined ? [] : Array.isArray(value) ? value : [value];
25
+ const actual = search.getAll(key);
26
+ return actual.length === expected.length && actual.every((entry, i) => entry === expected[i]);
27
+ });
28
+ }
29
+ /** Match-pattern params are still URL encoded; tolerate malformed escapes just as React Router does. */
30
+ function decodeParam(value) {
31
+ try {
32
+ return decodeURIComponent(value);
33
+ }
34
+ catch (_error) {
35
+ // A malformed incoming URL is still a usable literal filter; do not crash the page.
36
+ return value;
37
+ }
38
+ }
39
+ /**
40
+ * Own URL-backed pagination, filters and selected views without mirrored state or navigation effects.
41
+ * Works inside `BrowserRouter`, `MemoryRouter` and data routers; no data-router-only
42
+ * `useNavigation` call or MoleculeRouterProvider is needed. Ordinary links, direct visits,
43
+ * and Back/Forward all read the same URL. Page links retain path parameters and unrelated
44
+ * queries; changing filters or views resets the page atomically. Protected views wait for
45
+ * auth and redirect only a confirmed signed-out session, with `state.returnTo` set.
46
+ *
47
+ * @param options - App-owned filter sources, view paths, pagination and optional auth readiness.
48
+ * @returns Reactive list state plus link builders and navigation actions. Gate data queries with `canLoad`.
49
+ */
50
+ export function useListRoute(options = {}) {
51
+ const location = useLocation();
52
+ const navigate = useNavigate();
53
+ const routeParams = useParams();
54
+ const { pageSize = 20, pageParam = 'page', auth } = options;
55
+ if (!Number.isSafeInteger(pageSize) || pageSize < 1) {
56
+ throw new Error('useListRoute: pageSize must be a positive safe integer');
57
+ }
58
+ const search = new URLSearchParams(location.search);
59
+ const selections = Object.entries(options.selections ?? {});
60
+ const candidates = selections
61
+ .map(([name, config]) => ({
62
+ name,
63
+ config,
64
+ match: matchReactPath({ path: config.path, end: true }, location.pathname),
65
+ }))
66
+ .filter(({ config, match }) => match && matchesQuery(search, config.query))
67
+ .sort((a, b) => Object.keys(b.config.query ?? {}).length - Object.keys(a.config.query ?? {}).length ||
68
+ Number(b.name === options.defaultSelection) - Number(a.name === options.defaultSelection));
69
+ const selected = candidates[0];
70
+ const selection = selected?.name ?? options.defaultSelection;
71
+ const currentSelection = options.selections?.[selection];
72
+ const pattern = selected?.config.path ?? options.path;
73
+ const matchedParams = selected?.match?.params ??
74
+ (pattern ? matchReactPath({ path: pattern, end: true }, location.pathname)?.params : undefined);
75
+ const params = {};
76
+ for (const [key, value] of Object.entries(matchedParams ?? {})) {
77
+ if (value !== undefined)
78
+ params[key] = decodeParam(value);
79
+ }
80
+ // React Router's route context already decodes params; it wins over pattern matches.
81
+ for (const [key, value] of Object.entries(routeParams)) {
82
+ if (value !== undefined)
83
+ params[key] = value;
84
+ }
85
+ const filterEntries = Object.entries(options.filters ?? {});
86
+ const filters = Object.fromEntries(filterEntries.map(([name, source]) => {
87
+ const pathValue = source.param ? params[source.param] : undefined;
88
+ const queryValue = source.query || !source.param ? search.get(source.query ?? name) : null;
89
+ return [name, pathValue ?? queryValue ?? source.defaultValue];
90
+ }));
91
+ const page = readPage(search.get(pageParam), pageSize);
92
+ const requiresAuth = currentSelection?.requiresAuth === true;
93
+ if (requiresAuth && !auth) {
94
+ throw new Error('useListRoute: protected selections require auth.status and auth.redirectTo');
95
+ }
96
+ const status = requiresAuth && auth?.status !== 'authenticated' ? auth.status : 'ready';
97
+ const redirectTo = status === 'unauthenticated' ? auth?.redirectTo : undefined;
98
+ const returnTo = location.pathname + location.search + location.hash;
99
+ useEffect(() => {
100
+ if (redirectTo && redirectTo !== returnTo) {
101
+ void navigate(redirectTo, { replace: true, state: { returnTo } });
102
+ }
103
+ }, [navigate, redirectTo, returnTo]);
104
+ const href = (change = {}) => {
105
+ const nextQuery = new URLSearchParams(location.search);
106
+ const nextParams = { ...params, ...change.params };
107
+ let pathname = location.pathname;
108
+ let nextPattern = pattern;
109
+ if (change.selection !== undefined) {
110
+ const target = options.selections?.[change.selection];
111
+ if (!target)
112
+ throw new Error(`useListRoute: unknown selection "${change.selection}"`);
113
+ // A selection owns only the union of the configured selection query keys.
114
+ for (const [, config] of selections) {
115
+ for (const key of Object.keys(config.query ?? {}))
116
+ nextQuery.delete(key);
117
+ }
118
+ patchQuery(nextQuery, target.query ?? {});
119
+ nextPattern = target.path;
120
+ }
121
+ let pathChanged = change.selection !== undefined || change.params !== undefined;
122
+ let filterChanged = false;
123
+ for (const [name, value] of Object.entries(change.filters ?? {})) {
124
+ const source = options.filters?.[name];
125
+ if (!source)
126
+ throw new Error(`useListRoute: unknown filter "${name}"`);
127
+ if (source.param && !source.query && params[source.param] === undefined) {
128
+ throw new Error(`useListRoute: path filter "${name}" requires param "${source.param}"`);
129
+ }
130
+ filterChanged ||= value !== filters[name];
131
+ if (source.param && params[source.param] !== undefined) {
132
+ if (value === undefined) {
133
+ throw new Error(`useListRoute: path filter "${name}" cannot be removed`);
134
+ }
135
+ nextParams[source.param] = value;
136
+ pathChanged = true;
137
+ if (source.query)
138
+ nextQuery.delete(source.query);
139
+ }
140
+ else {
141
+ patchQuery(nextQuery, {
142
+ [source.query ?? name]: value === source.defaultValue ? undefined : value,
143
+ });
144
+ }
145
+ }
146
+ if (pathChanged) {
147
+ if (!nextPattern)
148
+ throw new Error('useListRoute: changing path parameters requires a path pattern');
149
+ pathname = generatePath(nextPattern, nextParams);
150
+ }
151
+ const nextPage = change.page ??
152
+ (filterChanged || change.selection !== undefined || change.params !== undefined ? 1 : page);
153
+ if (!Number.isSafeInteger(nextPage) ||
154
+ nextPage < 1 ||
155
+ !Number.isSafeInteger((nextPage - 1) * pageSize)) {
156
+ throw new Error('useListRoute: page must be a positive safe integer');
157
+ }
158
+ patchQuery(nextQuery, { [pageParam]: nextPage === 1 ? undefined : String(nextPage) });
159
+ const query = nextQuery.toString();
160
+ return pathname + (query ? `?${query}` : '') + location.hash;
161
+ };
162
+ const go = (change, navOptions) => {
163
+ void navigate(href(change), { state: location.state, ...navOptions });
164
+ };
165
+ return {
166
+ page,
167
+ pageSize,
168
+ offset: (page - 1) * pageSize,
169
+ filters,
170
+ selection,
171
+ params,
172
+ canLoad: status === 'ready',
173
+ status,
174
+ redirectTo,
175
+ href,
176
+ navigate: go,
177
+ setPage: (next, navOptions) => go({ page: next }, navOptions),
178
+ setFilters: (next, navOptions) => go({ filters: next }, navOptions),
179
+ select: (next, navOptions) => go({ selection: next }, navOptions),
180
+ };
181
+ }
182
+ //# sourceMappingURL=useListRoute.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"useListRoute.js","sourceRoot":"","sources":["../src/useListRoute.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@molecule/app-routing-react-router",
3
- "version": "1.0.1",
3
+ "version": "1.1.0",
4
4
  "description": "React Router v7 provider for @molecule/app-routing",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -27,20 +27,20 @@
27
27
  "react-router": "^7.0.0 || ^8.0.0"
28
28
  },
29
29
  "devDependencies": {
30
- "@molecule/app-i18n": "1.0.1",
30
+ "@molecule/app-i18n": "1.0.3",
31
31
  "@types/node": "26.1.2",
32
32
  "@types/react": "19.2.17",
33
33
  "react": "19.2.8",
34
34
  "react-router": "8.3.0",
35
35
  "typescript": "6.0.3",
36
- "vitest": "4.1.10"
36
+ "vitest": "4.1.12"
37
37
  },
38
38
  "repository": {
39
39
  "type": "git",
40
40
  "url": "https://github.com/molecule-dev/molecule.git",
41
41
  "directory": "packages/app/bonds/routing/react-router"
42
42
  },
43
- "homepage": "https://github.com/molecule-dev/molecule/tree/main/packages/app/bonds/routing/react-router",
43
+ "homepage": "https://www.molecule.dev/packages/app-routing-react-router",
44
44
  "bugs": "https://github.com/molecule-dev/molecule/issues",
45
45
  "publishConfig": {
46
46
  "access": "public"