@sigx/lynx-navigation 0.1.3 → 0.4.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.
Files changed (196) hide show
  1. package/README.md +189 -7
  2. package/dist/components/EntryScope.d.ts +1 -1
  3. package/dist/components/EntryScope.d.ts.map +1 -1
  4. package/dist/components/Layer.d.ts +34 -0
  5. package/dist/components/Layer.d.ts.map +1 -0
  6. package/dist/components/Link.d.ts +2 -2
  7. package/dist/components/Link.d.ts.map +1 -1
  8. package/dist/components/NavigationRoot.d.ts +2 -2
  9. package/dist/components/NavigationRoot.d.ts.map +1 -1
  10. package/dist/components/Screen.d.ts +6 -6
  11. package/dist/components/Screen.d.ts.map +1 -1
  12. package/dist/components/Stack.d.ts +83 -13
  13. package/dist/components/Stack.d.ts.map +1 -1
  14. package/dist/components/TabBar.d.ts +19 -20
  15. package/dist/components/TabBar.d.ts.map +1 -1
  16. package/dist/components/Tabs.d.ts +30 -21
  17. package/dist/components/Tabs.d.ts.map +1 -1
  18. package/dist/define-routes.d.ts +1 -1
  19. package/dist/define-routes.d.ts.map +1 -1
  20. package/dist/hooks/use-focus.d.ts.map +1 -1
  21. package/dist/hooks/use-hardware-back.d.ts +9 -2
  22. package/dist/hooks/use-hardware-back.d.ts.map +1 -1
  23. package/dist/hooks/use-linking-nav.d.ts +3 -3
  24. package/dist/hooks/use-linking-nav.d.ts.map +1 -1
  25. package/dist/hooks/use-nav-internal.d.ts +21 -3
  26. package/dist/hooks/use-nav-internal.d.ts.map +1 -1
  27. package/dist/hooks/use-nav-serializer.d.ts +1 -1
  28. package/dist/hooks/use-nav-serializer.d.ts.map +1 -1
  29. package/dist/hooks/use-nav.d.ts +38 -3
  30. package/dist/hooks/use-nav.d.ts.map +1 -1
  31. package/dist/hooks/use-params.d.ts +1 -1
  32. package/dist/hooks/use-params.d.ts.map +1 -1
  33. package/dist/hooks/use-screen-chrome.d.ts +19 -0
  34. package/dist/hooks/use-screen-chrome.d.ts.map +1 -0
  35. package/dist/hooks/use-screen-options.d.ts +1 -1
  36. package/dist/hooks/use-screen-options.d.ts.map +1 -1
  37. package/dist/hooks/use-search.d.ts +1 -1
  38. package/dist/hooks/use-search.d.ts.map +1 -1
  39. package/dist/href.d.ts +2 -2
  40. package/dist/href.d.ts.map +1 -1
  41. package/dist/index.d.ts +33 -31
  42. package/dist/index.d.ts.map +1 -1
  43. package/dist/index.js +1160 -29
  44. package/dist/index.js.map +1 -1
  45. package/dist/internal/layer-plan.d.ts +69 -0
  46. package/dist/internal/layer-plan.d.ts.map +1 -0
  47. package/dist/internal/screen-registry.d.ts +1 -1
  48. package/dist/internal/screen-registry.d.ts.map +1 -1
  49. package/dist/internal/screen-width.d.ts +9 -7
  50. package/dist/internal/screen-width.d.ts.map +1 -1
  51. package/dist/navigator/core.d.ts +31 -4
  52. package/dist/navigator/core.d.ts.map +1 -1
  53. package/dist/register.d.ts +1 -1
  54. package/dist/register.d.ts.map +1 -1
  55. package/dist/url/index.d.ts +6 -6
  56. package/dist/url/index.d.ts.map +1 -1
  57. package/dist/url/parse.d.ts +1 -1
  58. package/dist/url/parse.d.ts.map +1 -1
  59. package/dist/url/registry.d.ts +2 -2
  60. package/dist/url/registry.d.ts.map +1 -1
  61. package/dist/url/validate.d.ts +1 -1
  62. package/dist/url/validate.d.ts.map +1 -1
  63. package/package.json +11 -10
  64. package/src/components/Drawer.d.ts +55 -0
  65. package/src/components/EdgeBackHandle.d.ts +1 -0
  66. package/src/components/EdgeBackHandle.tsx +2 -2
  67. package/{dist/components/EntryScope.js → src/components/EntryScope.d.ts} +7 -15
  68. package/src/components/EntryScope.tsx +15 -4
  69. package/src/components/Header.d.ts +6 -0
  70. package/src/components/Header.tsx +3 -3
  71. package/src/components/Layer.d.ts +33 -0
  72. package/src/components/Layer.tsx +96 -0
  73. package/src/components/Link.d.ts +60 -0
  74. package/src/components/Link.tsx +4 -4
  75. package/src/components/NavigationRoot.d.ts +36 -0
  76. package/src/components/NavigationRoot.tsx +6 -6
  77. package/src/components/Screen.d.ts +97 -0
  78. package/src/components/Screen.tsx +13 -11
  79. package/src/components/Stack.d.ts +90 -0
  80. package/src/components/Stack.tsx +333 -92
  81. package/src/components/TabBar.d.ts +38 -0
  82. package/src/components/TabBar.tsx +22 -22
  83. package/src/components/Tabs.d.ts +109 -0
  84. package/src/components/Tabs.tsx +54 -22
  85. package/{dist/define-routes.js → src/define-routes.d.ts} +2 -4
  86. package/src/define-routes.ts +1 -1
  87. package/{dist/hooks/use-focus.js → src/hooks/use-focus.d.ts} +3 -39
  88. package/src/hooks/use-focus.ts +9 -3
  89. package/src/hooks/use-hardware-back.d.ts +37 -0
  90. package/src/hooks/use-hardware-back.ts +43 -9
  91. package/src/hooks/use-linking-nav.d.ts +91 -0
  92. package/src/hooks/use-linking-nav.ts +4 -4
  93. package/src/hooks/use-nav-internal.d.ts +91 -0
  94. package/src/hooks/use-nav-internal.ts +24 -3
  95. package/src/hooks/use-nav-serializer.d.ts +82 -0
  96. package/src/hooks/use-nav-serializer.ts +3 -3
  97. package/src/hooks/use-nav.d.ts +111 -0
  98. package/src/hooks/use-nav.ts +40 -3
  99. package/{dist/hooks/use-params.js → src/hooks/use-params.d.ts} +2 -6
  100. package/src/hooks/use-params.ts +2 -2
  101. package/src/hooks/use-screen-chrome.d.ts +18 -0
  102. package/src/hooks/use-screen-chrome.ts +122 -0
  103. package/src/hooks/use-screen-options.d.ts +2 -0
  104. package/src/hooks/use-screen-options.ts +3 -3
  105. package/{dist/hooks/use-search.js → src/hooks/use-search.d.ts} +2 -6
  106. package/src/hooks/use-search.ts +2 -2
  107. package/src/href.d.ts +54 -0
  108. package/src/href.ts +6 -6
  109. package/src/index.d.ts +39 -0
  110. package/src/index.ts +33 -31
  111. package/src/internal/layer-plan.d.ts +68 -0
  112. package/src/internal/layer-plan.ts +187 -0
  113. package/{dist/internal/screen-registry.js → src/internal/screen-registry.d.ts} +21 -32
  114. package/src/internal/screen-registry.ts +1 -1
  115. package/src/internal/screen-width.d.ts +17 -0
  116. package/src/internal/screen-width.ts +22 -14
  117. package/src/navigator/core.d.ts +96 -0
  118. package/src/navigator/core.ts +90 -10
  119. package/src/register.d.ts +37 -0
  120. package/src/register.ts +1 -1
  121. package/src/types.d.ts +217 -0
  122. package/src/url/build.d.ts +15 -0
  123. package/src/url/build.ts +2 -2
  124. package/src/url/compile.d.ts +34 -0
  125. package/src/url/format.d.ts +28 -0
  126. package/src/url/index.ts +6 -6
  127. package/src/url/parse.d.ts +20 -0
  128. package/src/url/parse.ts +6 -6
  129. package/{dist/url/registry.js → src/url/registry.d.ts} +12 -28
  130. package/src/url/registry.ts +3 -3
  131. package/src/url/validate.d.ts +23 -0
  132. package/src/url/validate.ts +1 -1
  133. package/dist/components/Drawer.js +0 -74
  134. package/dist/components/Drawer.js.map +0 -1
  135. package/dist/components/EdgeBackHandle.js +0 -144
  136. package/dist/components/EdgeBackHandle.js.map +0 -1
  137. package/dist/components/EntryScope.js.map +0 -1
  138. package/dist/components/Header.js +0 -103
  139. package/dist/components/Header.js.map +0 -1
  140. package/dist/components/Link.js +0 -51
  141. package/dist/components/Link.js.map +0 -1
  142. package/dist/components/NavigationRoot.js +0 -67
  143. package/dist/components/NavigationRoot.js.map +0 -1
  144. package/dist/components/Screen.js +0 -94
  145. package/dist/components/Screen.js.map +0 -1
  146. package/dist/components/ScreenContainer.d.ts +0 -18
  147. package/dist/components/ScreenContainer.d.ts.map +0 -1
  148. package/dist/components/ScreenContainer.js +0 -77
  149. package/dist/components/ScreenContainer.js.map +0 -1
  150. package/dist/components/Stack.js +0 -75
  151. package/dist/components/Stack.js.map +0 -1
  152. package/dist/components/TabBar.js +0 -63
  153. package/dist/components/TabBar.js.map +0 -1
  154. package/dist/components/Tabs.js +0 -140
  155. package/dist/components/Tabs.js.map +0 -1
  156. package/dist/define-routes.js.map +0 -1
  157. package/dist/hooks/use-focus.js.map +0 -1
  158. package/dist/hooks/use-hardware-back.js +0 -50
  159. package/dist/hooks/use-hardware-back.js.map +0 -1
  160. package/dist/hooks/use-linking-nav.js +0 -109
  161. package/dist/hooks/use-linking-nav.js.map +0 -1
  162. package/dist/hooks/use-nav-internal.js +0 -44
  163. package/dist/hooks/use-nav-internal.js.map +0 -1
  164. package/dist/hooks/use-nav-serializer.js +0 -181
  165. package/dist/hooks/use-nav-serializer.js.map +0 -1
  166. package/dist/hooks/use-nav.js +0 -11
  167. package/dist/hooks/use-nav.js.map +0 -1
  168. package/dist/hooks/use-params.js.map +0 -1
  169. package/dist/hooks/use-screen-options.js +0 -43
  170. package/dist/hooks/use-screen-options.js.map +0 -1
  171. package/dist/hooks/use-search.js.map +0 -1
  172. package/dist/href.js +0 -57
  173. package/dist/href.js.map +0 -1
  174. package/dist/internal/screen-registry.js.map +0 -1
  175. package/dist/internal/screen-width.js +0 -30
  176. package/dist/internal/screen-width.js.map +0 -1
  177. package/dist/navigator/core.js +0 -344
  178. package/dist/navigator/core.js.map +0 -1
  179. package/dist/register.js +0 -2
  180. package/dist/register.js.map +0 -1
  181. package/dist/types.js +0 -9
  182. package/dist/types.js.map +0 -1
  183. package/dist/url/build.js +0 -30
  184. package/dist/url/build.js.map +0 -1
  185. package/dist/url/compile.js +0 -83
  186. package/dist/url/compile.js.map +0 -1
  187. package/dist/url/format.js +0 -102
  188. package/dist/url/format.js.map +0 -1
  189. package/dist/url/index.js +0 -13
  190. package/dist/url/index.js.map +0 -1
  191. package/dist/url/parse.js +0 -94
  192. package/dist/url/parse.js.map +0 -1
  193. package/dist/url/registry.js.map +0 -1
  194. package/dist/url/validate.js +0 -37
  195. package/dist/url/validate.js.map +0 -1
  196. package/src/components/ScreenContainer.tsx +0 -114
@@ -1,181 +0,0 @@
1
- import { effect, onMounted, onUnmounted } from '@sigx/lynx';
2
- import { useNav } from './use-nav.js';
3
- import { useNavRoutes } from './use-nav-internal.js';
4
- export const NAV_SNAPSHOT_VERSION = 1;
5
- /**
6
- * Wire a navigator's stack to a storage adapter.
7
- *
8
- * On mount:
9
- * 1. Call `storage.load()`.
10
- * 2. Validate the snapshot (version match, every entry's route still
11
- * registered).
12
- * 3. On success, `nav.reset({ stack })` to apply.
13
- * 4. On any failure, leave the stack alone (initial route remains).
14
- *
15
- * Then subscribe to `nav.stack` and call `storage.save(snapshot)` debounced.
16
- *
17
- * Why we don't validate `params` / `search` against schemas here: schemas
18
- * are part of the route definition, and re-running them across all entries
19
- * on every launch costs more than it's worth. The contract is "entries were
20
- * validated when they were pushed; if the schema has since changed in a
21
- * breaking way, bump `version` to reject old snapshots wholesale." Callers
22
- * who want a stricter check can run their own validation in
23
- * `storage.load()` and return `null` on mismatch.
24
- */
25
- export function useNavSerializer(options) {
26
- const nav = useNav();
27
- const routes = useNavRoutes();
28
- const debounceMs = options.debounceMs ?? 250;
29
- const onRestored = options.onRestored;
30
- const onErr = options.onRestoreError;
31
- // Mutable mount/state flags. Plain closure vars (no signals) — we don't
32
- // want any of this driving a render and we don't want it tracked by the
33
- // save-effect below.
34
- let mounted = true;
35
- let restoreDone = false;
36
- let pendingTimer = null;
37
- let stopEffect = null;
38
- onMounted(() => {
39
- // Kick off the load synchronously — adapters that return a value
40
- // immediately (sync stores, test doubles) hit the resolve branch on
41
- // the same tick. Promise adapters resolve on the microtask queue;
42
- // the `mounted` guard catches teardown races.
43
- Promise.resolve()
44
- .then(() => options.storage.load())
45
- .then((snap) => {
46
- if (!mounted)
47
- return;
48
- if (snap == null) {
49
- restoreDone = true;
50
- startSaveEffect();
51
- return;
52
- }
53
- if (!isValidShape(snap)) {
54
- onErr?.('shape');
55
- restoreDone = true;
56
- startSaveEffect();
57
- return;
58
- }
59
- if (snap.version !== NAV_SNAPSHOT_VERSION) {
60
- onErr?.('version');
61
- restoreDone = true;
62
- startSaveEffect();
63
- return;
64
- }
65
- // Drop the snapshot if any entry references a route the app
66
- // no longer knows about — partial restoration is worse than
67
- // no restoration (could leave the user stranded on a screen
68
- // whose params won't validate when read by `useParams`).
69
- for (const entry of snap.stack) {
70
- if (!routes[entry.route]) {
71
- onErr?.('unknown-route');
72
- restoreDone = true;
73
- startSaveEffect();
74
- return;
75
- }
76
- }
77
- if (snap.stack.length === 0) {
78
- onErr?.('shape');
79
- restoreDone = true;
80
- startSaveEffect();
81
- return;
82
- }
83
- nav.reset({ stack: snap.stack });
84
- onRestored?.(snap);
85
- restoreDone = true;
86
- startSaveEffect();
87
- })
88
- .catch((err) => {
89
- if (!mounted)
90
- return;
91
- onErr?.('load-threw', err);
92
- restoreDone = true;
93
- startSaveEffect();
94
- });
95
- });
96
- function startSaveEffect() {
97
- if (!mounted || stopEffect)
98
- return;
99
- // The first effect run is just the initial subscription read — it
100
- // happens immediately when `effect()` is called, before any user
101
- // navigation, and represents the stack-as-restored (or the initial
102
- // route when there was nothing to restore). Either way, we don't
103
- // want to persist it: in the restore case it would race with the
104
- // adapter that just supplied this state, and in the fresh case
105
- // it's redundant.
106
- let firstRun = true;
107
- const runner = effect(() => {
108
- const stack = nav.stack;
109
- const snapshot = {
110
- version: NAV_SNAPSHOT_VERSION,
111
- stack: stack.map((e) => ({
112
- key: e.key,
113
- route: e.route,
114
- params: e.params,
115
- search: e.search,
116
- state: e.state,
117
- presentation: e.presentation,
118
- })),
119
- };
120
- if (firstRun) {
121
- firstRun = false;
122
- return;
123
- }
124
- schedule(snapshot);
125
- });
126
- stopEffect = () => runner.stop();
127
- }
128
- function schedule(snapshot) {
129
- if (pendingTimer != null)
130
- clearTimeout(pendingTimer);
131
- pendingTimer = setTimeout(() => {
132
- pendingTimer = null;
133
- try {
134
- const r = options.storage.save(snapshot);
135
- if (r && typeof r.catch === 'function') {
136
- r.catch(() => {
137
- // Save errors are intentionally swallowed — see the
138
- // hook doc-comment. Hosts that need visibility can
139
- // wrap their adapter.
140
- });
141
- }
142
- }
143
- catch {
144
- // Same rationale.
145
- }
146
- }, debounceMs);
147
- }
148
- onUnmounted(() => {
149
- mounted = false;
150
- if (pendingTimer != null) {
151
- clearTimeout(pendingTimer);
152
- pendingTimer = null;
153
- }
154
- if (stopEffect) {
155
- stopEffect();
156
- stopEffect = null;
157
- }
158
- });
159
- }
160
- function isValidShape(s) {
161
- if (!s || typeof s !== 'object')
162
- return false;
163
- const obj = s;
164
- if (typeof obj.version !== 'number')
165
- return false;
166
- if (!Array.isArray(obj.stack))
167
- return false;
168
- for (const entry of obj.stack) {
169
- if (!entry || typeof entry !== 'object')
170
- return false;
171
- const e = entry;
172
- if (typeof e.key !== 'string')
173
- return false;
174
- if (typeof e.route !== 'string')
175
- return false;
176
- if (typeof e.presentation !== 'string')
177
- return false;
178
- }
179
- return true;
180
- }
181
- //# sourceMappingURL=use-nav-serializer.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"use-nav-serializer.js","sourceRoot":"","sources":["../../src/hooks/use-nav-serializer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AA0BrD,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAyCtC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAgC;IAC7D,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IACrB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,GAAG,CAAC;IAC7C,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACtC,MAAM,KAAK,GAAG,OAAO,CAAC,cAAc,CAAC;IAErC,wEAAwE;IACxE,wEAAwE;IACxE,qBAAqB;IACrB,IAAI,OAAO,GAAG,IAAI,CAAC;IACnB,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,IAAI,YAAY,GAAyC,IAAI,CAAC;IAC9D,IAAI,UAAU,GAAwB,IAAI,CAAC;IAE3C,SAAS,CAAC,GAAG,EAAE;QACX,iEAAiE;QACjE,oEAAoE;QACpE,kEAAkE;QAClE,8CAA8C;QAC9C,OAAO,CAAC,OAAO,EAAE;aACZ,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;aAClC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;YACX,IAAI,CAAC,OAAO;gBAAE,OAAO;YACrB,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;gBACf,WAAW,GAAG,IAAI,CAAC;gBACnB,eAAe,EAAE,CAAC;gBAClB,OAAO;YACX,CAAC;YACD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtB,KAAK,EAAE,CAAC,OAAO,CAAC,CAAC;gBACjB,WAAW,GAAG,IAAI,CAAC;gBACnB,eAAe,EAAE,CAAC;gBAClB,OAAO;YACX,CAAC;YACD,IAAI,IAAI,CAAC,OAAO,KAAK,oBAAoB,EAAE,CAAC;gBACxC,KAAK,EAAE,CAAC,SAAS,CAAC,CAAC;gBACnB,WAAW,GAAG,IAAI,CAAC;gBACnB,eAAe,EAAE,CAAC;gBAClB,OAAO;YACX,CAAC;YACD,4DAA4D;YAC5D,4DAA4D;YAC5D,4DAA4D;YAC5D,yDAAyD;YACzD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC7B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;oBACvB,KAAK,EAAE,CAAC,eAAe,CAAC,CAAC;oBACzB,WAAW,GAAG,IAAI,CAAC;oBACnB,eAAe,EAAE,CAAC;oBAClB,OAAO;gBACX,CAAC;YACL,CAAC;YACD,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1B,KAAK,EAAE,CAAC,OAAO,CAAC,CAAC;gBACjB,WAAW,GAAG,IAAI,CAAC;gBACnB,eAAe,EAAE,CAAC;gBAClB,OAAO;YACX,CAAC;YACD,GAAG,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YACjC,UAAU,EAAE,CAAC,IAAI,CAAC,CAAC;YACnB,WAAW,GAAG,IAAI,CAAC;YACnB,eAAe,EAAE,CAAC;QACtB,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACX,IAAI,CAAC,OAAO;gBAAE,OAAO;YACrB,KAAK,EAAE,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;YAC3B,WAAW,GAAG,IAAI,CAAC;YACnB,eAAe,EAAE,CAAC;QACtB,CAAC,CAAC,CAAC;IACX,CAAC,CAAC,CAAC;IAEH,SAAS,eAAe;QACpB,IAAI,CAAC,OAAO,IAAI,UAAU;YAAE,OAAO;QACnC,kEAAkE;QAClE,iEAAiE;QACjE,mEAAmE;QACnE,iEAAiE;QACjE,iEAAiE;QACjE,+DAA+D;QAC/D,kBAAkB;QAClB,IAAI,QAAQ,GAAG,IAAI,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,EAAE;YACvB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;YACxB,MAAM,QAAQ,GAAgB;gBAC1B,OAAO,EAAE,oBAAoB;gBAC7B,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACrB,GAAG,EAAE,CAAC,CAAC,GAAG;oBACV,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,MAAM,EAAE,CAAC,CAAC,MAAM;oBAChB,MAAM,EAAE,CAAC,CAAC,MAAM;oBAChB,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,YAAY,EAAE,CAAC,CAAC,YAAY;iBAC/B,CAAC,CAAC;aACN,CAAC;YACF,IAAI,QAAQ,EAAE,CAAC;gBACX,QAAQ,GAAG,KAAK,CAAC;gBACjB,OAAO;YACX,CAAC;YACD,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;QACH,UAAU,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACrC,CAAC;IAED,SAAS,QAAQ,CAAC,QAAqB;QACnC,IAAI,YAAY,IAAI,IAAI;YAAE,YAAY,CAAC,YAAY,CAAC,CAAC;QACrD,YAAY,GAAG,UAAU,CAAC,GAAG,EAAE;YAC3B,YAAY,GAAG,IAAI,CAAC;YACpB,IAAI,CAAC;gBACD,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACzC,IAAI,CAAC,IAAI,OAAQ,CAAmB,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;oBACvD,CAAmB,CAAC,KAAK,CAAC,GAAG,EAAE;wBAC5B,oDAAoD;wBACpD,mDAAmD;wBACnD,sBAAsB;oBAC1B,CAAC,CAAC,CAAC;gBACP,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACL,kBAAkB;YACtB,CAAC;QACL,CAAC,EAAE,UAAU,CAAC,CAAC;IACnB,CAAC;IAED,WAAW,CAAC,GAAG,EAAE;QACb,OAAO,GAAG,KAAK,CAAC;QAChB,IAAI,YAAY,IAAI,IAAI,EAAE,CAAC;YACvB,YAAY,CAAC,YAAY,CAAC,CAAC;YAC3B,YAAY,GAAG,IAAI,CAAC;QACxB,CAAC;QACD,IAAI,UAAU,EAAE,CAAC;YACb,UAAU,EAAE,CAAC;YACb,UAAU,GAAG,IAAI,CAAC;QACtB,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC;AAED,SAAS,YAAY,CAAC,CAAU;IAC5B,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9C,MAAM,GAAG,GAAG,CAA2C,CAAC;IACxD,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAClD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5C,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QACtD,MAAM,CAAC,GAAG,KAAgC,CAAC;QAC3C,IAAI,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC5C,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC9C,IAAI,OAAO,CAAC,CAAC,YAAY,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;IACzD,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC"}
@@ -1,11 +0,0 @@
1
- import { defineInjectable } from '@sigx/lynx';
2
- /**
3
- * Access the innermost navigator. Provided by `<NavigationRoot>` via
4
- * `defineProvide`. Throws when called outside a NavigationRoot subtree.
5
- *
6
- * Mirrors `@sigx/router`'s `useRouter` pattern (`packages/router/src/router.ts:30`).
7
- */
8
- export const useNav = defineInjectable(() => {
9
- throw new Error('[lynx-navigation] useNav() called but no <NavigationRoot> is mounted in the component tree.');
10
- });
11
- //# sourceMappingURL=use-nav.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"use-nav.js","sourceRoot":"","sources":["../../src/hooks/use-nav.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AA2G9C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,gBAAgB,CAAM,GAAG,EAAE;IAC7C,MAAM,IAAI,KAAK,CACX,6FAA6F,CAChG,CAAC;AACN,CAAC,CAAC,CAAC"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"use-params.js","sourceRoot":"","sources":["../../src/hooks/use-params.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,SAAS,CAAoB,KAAQ;IACjD,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IACrB,OAAO,GAAG,CAAC,OAAO,CAAC,MAAwB,CAAC;AAChD,CAAC"}
@@ -1,43 +0,0 @@
1
- /**
2
- * `useScreenOptions` — imperative merge into the current entry's options.
3
- *
4
- * Use this when options need to be set from an effect rather than declared
5
- * statically via `<Screen title=…>`. The canonical case is "title becomes
6
- * known after a fetch":
7
- *
8
- * ```ts
9
- * const user = useFetchUser(id);
10
- * useScreenOptions(() => ({
11
- * title: user.value?.displayName ?? 'Loading…',
12
- * }));
13
- * ```
14
- *
15
- * The callback runs in a tracked `effect` — any signals it reads cause it
16
- * to re-run and re-merge. This is strictly additive: returning a partial
17
- * options object only touches the keys it sets, and returning `undefined`
18
- * for a key clears it.
19
- *
20
- * Static usage where the options never change can pass a plain object and
21
- * skip the effect — internally we detect that and merge once. Hosts that
22
- * pass a getter pay for the subscription; hosts that pass an object don't.
23
- */
24
- import { effect, onUnmounted } from '@sigx/lynx';
25
- import { useScreenRegistry } from './use-nav-internal.js';
26
- import { mergeOptions } from '../internal/screen-registry.js';
27
- export function useScreenOptions(optionsOrFn) {
28
- const registry = useScreenRegistry();
29
- if (typeof optionsOrFn !== 'function') {
30
- mergeOptions(registry, optionsOrFn);
31
- return;
32
- }
33
- // Reactive path: every signal touched inside the getter is tracked, so
34
- // the merge re-runs when any of them change. `mergeOptions` does per-key
35
- // writes on a deeply-reactive proxy, so consumers (HeaderBar) only
36
- // re-render the parts they actually read.
37
- const runner = effect(() => {
38
- const next = optionsOrFn();
39
- mergeOptions(registry, next);
40
- });
41
- onUnmounted(() => runner.stop());
42
- }
43
- //# sourceMappingURL=use-screen-options.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"use-screen-options.js","sourceRoot":"","sources":["../../src/hooks/use-screen-options.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAG9D,MAAM,UAAU,gBAAgB,CAC5B,WAAkD;IAElD,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAC;IAErC,IAAI,OAAO,WAAW,KAAK,UAAU,EAAE,CAAC;QACpC,YAAY,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QACpC,OAAO;IACX,CAAC;IAED,uEAAuE;IACvE,yEAAyE;IACzE,mEAAmE;IACnE,0CAA0C;IAC1C,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,EAAE;QACvB,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC;QAC3B,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IACH,WAAW,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;AACrC,CAAC"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"use-search.js","sourceRoot":"","sources":["../../src/hooks/use-search.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAoB,KAAQ;IACjD,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IACrB,OAAO,GAAG,CAAC,OAAO,CAAC,MAAwB,CAAC;AAChD,CAAC"}
package/dist/href.js DELETED
@@ -1,57 +0,0 @@
1
- import { buildUrl } from './url/build.js';
2
- import { parseHrefImpl } from './url/parse.js';
3
- import { getRouteRegistry } from './url/registry.js';
4
- import { validateSync } from './url/validate.js';
5
- export function hrefFor(name, ...args) {
6
- const registry = getRouteRegistry();
7
- const def = registry.routes[name];
8
- if (!def) {
9
- throw new Error(`[lynx-navigation] hrefFor('${name}'): route is not in the active registry.`);
10
- }
11
- // Disambiguate the overloads: routes with a params schema get
12
- // (name, params, search?); routes without get (name, search?). The
13
- // typed overloads enforce this at compile time, but at runtime we need
14
- // to peek at the schema presence to know how to interpret `args`.
15
- const hasParamsSchema = !!def.params;
16
- let rawParams;
17
- let rawSearch;
18
- if (hasParamsSchema) {
19
- rawParams = args[0];
20
- rawSearch = args[1];
21
- }
22
- else {
23
- rawParams = undefined;
24
- rawSearch = args[0];
25
- }
26
- const paramsOutcome = validateSync(def.params, rawParams ?? {});
27
- if (!paramsOutcome.ok) {
28
- throw new Error(`[lynx-navigation] hrefFor('${name}'): params validation failed — ${paramsOutcome.issues.join('; ')}`);
29
- }
30
- const searchOutcome = validateSync(def.search, rawSearch ?? {});
31
- if (!searchOutcome.ok) {
32
- throw new Error(`[lynx-navigation] hrefFor('${name}'): search validation failed — ${searchOutcome.issues.join('; ')}`);
33
- }
34
- const params = paramsOutcome.value;
35
- const search = searchOutcome.value;
36
- const url = buildUrl(name, params, search);
37
- return {
38
- route: name,
39
- params: params,
40
- search: search,
41
- url,
42
- };
43
- }
44
- /**
45
- * Parse a URL string into a typed Href against the registered routes.
46
- * Returns `null` if no route's `path` template matches the URL or if the
47
- * extracted params/search fail the route's schema validation.
48
- *
49
- * Accepts both absolute (`myapp://host/path?q`) and pathname-only
50
- * (`/path?q`) forms — the pathname is matched against each route's
51
- * compiled template. Iteration order is the registration order; first match
52
- * wins.
53
- */
54
- export function parseHref(url) {
55
- return parseHrefImpl(url);
56
- }
57
- //# sourceMappingURL=href.js.map
package/dist/href.js.map DELETED
@@ -1 +0,0 @@
1
- {"version":3,"file":"href.js","sourceRoot":"","sources":["../src/href.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAgDjD,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,GAAG,IAAe;IACpD,MAAM,QAAQ,GAAG,gBAAgB,EAAE,CAAC;IACpC,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,CAAC,GAAG,EAAE,CAAC;QACP,MAAM,IAAI,KAAK,CACX,8BAA8B,IAAI,0CAA0C,CAC/E,CAAC;IACN,CAAC;IAED,8DAA8D;IAC9D,mEAAmE;IACnE,uEAAuE;IACvE,kEAAkE;IAClE,MAAM,eAAe,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC;IACrC,IAAI,SAA8C,CAAC;IACnD,IAAI,SAA8C,CAAC;IACnD,IAAI,eAAe,EAAE,CAAC;QAClB,SAAS,GAAG,IAAI,CAAC,CAAC,CAAwC,CAAC;QAC3D,SAAS,GAAG,IAAI,CAAC,CAAC,CAAwC,CAAC;IAC/D,CAAC;SAAM,CAAC;QACJ,SAAS,GAAG,SAAS,CAAC;QACtB,SAAS,GAAG,IAAI,CAAC,CAAC,CAAwC,CAAC;IAC/D,CAAC;IAED,MAAM,aAAa,GAAG,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC;IAChE,IAAI,CAAC,aAAa,CAAC,EAAE,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACX,8BAA8B,IAAI,kCAAkC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACxG,CAAC;IACN,CAAC;IACD,MAAM,aAAa,GAAG,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC;IAChE,IAAI,CAAC,aAAa,CAAC,EAAE,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACX,8BAA8B,IAAI,kCAAkC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACxG,CAAC;IACN,CAAC;IAED,MAAM,MAAM,GAAG,aAAa,CAAC,KAAgC,CAAC;IAC9D,MAAM,MAAM,GAAG,aAAa,CAAC,KAAgC,CAAC;IAC9D,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAE3C,OAAO;QACH,KAAK,EAAE,IAAe;QACtB,MAAM,EAAE,MAAe;QACvB,MAAM,EAAE,MAAe;QACvB,GAAG;KACN,CAAC;AACN,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW;IACjC,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC;AAC9B,CAAC"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"screen-registry.js","sourceRoot":"","sources":["../../src/internal/screen-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,MAAM,EAAe,MAAM,YAAY,CAAC;AAwBjD,2EAA2E;AAC3E,MAAM,UAAU,oBAAoB,CAAC,KAAiB;IAClD,OAAO;QACH,KAAK;QACL,OAAO,EAAE,MAAM,CAAgB,EAAE,CAAC;QAClC,KAAK,EAAE,MAAM,CAAkB,EAAE,CAAC;KACrC,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,OAAO,CACnB,QAAwB,EACxB,IAAO,EACP,IAAoC;IAEpC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACrB,kEAAkE;QAClE,4DAA4D;QAC5D,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5B,OAAO;IACX,CAAC;IACA,QAAQ,CAAC,KAAyB,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AACrD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CACxB,QAAwB,EACxB,KAAoB;IAEpB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAA4B,EAAE,CAAC;QAC9D,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACrB,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;YAClB,OAAO,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,CAAC;aAAM,CAAC;YACJ,iEAAiE;YACjE,+DAA+D;YAC/D,+DAA+D;YAC9D,QAAQ,CAAC,OAA8C,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACtE,CAAC;IACL,CAAC;AACL,CAAC"}
@@ -1,30 +0,0 @@
1
- /**
2
- * Logical screen width (in dp) read from `lynx.SystemInfo` at module load.
3
- * Falls back to 400 (typical phone) if SystemInfo isn't available — module
4
- * load happens BG-side after the bundle initializes, by which time
5
- * `lynx.SystemInfo` is populated, so the fallback only fires in tests / SSR /
6
- * non-Lynx hosts.
7
- *
8
- * Used by:
9
- * - `<ScreenContainer>` for the slide-from-right transform output range.
10
- * - `<EdgeBackHandle>` for the gesture commit threshold (`dx / width`).
11
- *
12
- * Both must agree, otherwise the commit threshold and the animation
13
- * geometry won't line up. Single shared constant avoids drift.
14
- */
15
- function readScreenWidth() {
16
- try {
17
- const info = typeof lynx !== 'undefined' ? lynx?.SystemInfo : undefined;
18
- const pw = info?.pixelWidth;
19
- const pr = info?.pixelRatio || 1;
20
- if (typeof pw === 'number' && pw > 0) {
21
- return Math.round(pw / pr);
22
- }
23
- }
24
- catch {
25
- // Lynx globals not present (test env / SSR) — use fallback.
26
- }
27
- return 400;
28
- }
29
- export const SCREEN_WIDTH = readScreenWidth();
30
- //# sourceMappingURL=screen-width.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"screen-width.js","sourceRoot":"","sources":["../../src/internal/screen-width.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,SAAS,eAAe;IACpB,IAAI,CAAC;QACD,MAAM,IAAI,GAAG,OAAO,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;QACxE,MAAM,EAAE,GAAG,IAAI,EAAE,UAAU,CAAC;QAC5B,MAAM,EAAE,GAAG,IAAI,EAAE,UAAU,IAAI,CAAC,CAAC;QACjC,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;YACnC,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;QAC/B,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACL,4DAA4D;IAChE,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC"}