@flightdev/router 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.
@@ -0,0 +1,654 @@
1
+ // src/context.ts
2
+ var isBrowser = typeof window !== "undefined";
3
+ var currentContext = {
4
+ path: "/",
5
+ searchParams: new URLSearchParams(),
6
+ navigate: () => {
7
+ },
8
+ back: () => {
9
+ },
10
+ forward: () => {
11
+ }
12
+ };
13
+ var subscribers = /* @__PURE__ */ new Set();
14
+ function subscribe(callback) {
15
+ subscribers.add(callback);
16
+ return () => subscribers.delete(callback);
17
+ }
18
+ function getRouterContext() {
19
+ return currentContext;
20
+ }
21
+ function updateContext(updates) {
22
+ currentContext = { ...currentContext, ...updates };
23
+ subscribers.forEach((cb) => cb(currentContext));
24
+ }
25
+ function navigateTo(to, options = {}) {
26
+ if (!isBrowser) return;
27
+ const { replace = false, scroll = true, state } = options;
28
+ if (replace) {
29
+ window.history.replaceState(state ?? null, "", to);
30
+ } else {
31
+ window.history.pushState(state ?? null, "", to);
32
+ }
33
+ const url = new URL(to, window.location.origin);
34
+ updateContext({
35
+ path: url.pathname,
36
+ searchParams: url.searchParams
37
+ });
38
+ if (scroll) {
39
+ window.scrollTo({ top: 0, left: 0, behavior: "instant" });
40
+ }
41
+ }
42
+ function initRouter(options = {}) {
43
+ const { initialPath, basePath = "" } = options;
44
+ let path;
45
+ let searchParams;
46
+ if (isBrowser) {
47
+ path = window.location.pathname;
48
+ searchParams = new URLSearchParams(window.location.search);
49
+ } else {
50
+ path = initialPath || "/";
51
+ searchParams = new URLSearchParams();
52
+ }
53
+ if (basePath && path.startsWith(basePath)) {
54
+ path = path.slice(basePath.length) || "/";
55
+ }
56
+ currentContext = {
57
+ path,
58
+ searchParams,
59
+ navigate: navigateTo,
60
+ back: () => isBrowser && window.history.back(),
61
+ forward: () => isBrowser && window.history.forward()
62
+ };
63
+ if (isBrowser) {
64
+ window.addEventListener("popstate", () => {
65
+ updateContext({
66
+ path: window.location.pathname,
67
+ searchParams: new URLSearchParams(window.location.search)
68
+ });
69
+ });
70
+ const originalPushState = history.pushState.bind(history);
71
+ const originalReplaceState = history.replaceState.bind(history);
72
+ history.pushState = function(state, unused, url) {
73
+ originalPushState(state, unused, url);
74
+ if (url) {
75
+ const newUrl = new URL(url.toString(), window.location.origin);
76
+ updateContext({
77
+ path: newUrl.pathname,
78
+ searchParams: newUrl.searchParams
79
+ });
80
+ }
81
+ };
82
+ history.replaceState = function(state, unused, url) {
83
+ originalReplaceState(state, unused, url);
84
+ if (url) {
85
+ const newUrl = new URL(url.toString(), window.location.origin);
86
+ updateContext({
87
+ path: newUrl.pathname,
88
+ searchParams: newUrl.searchParams
89
+ });
90
+ }
91
+ };
92
+ }
93
+ }
94
+ var initialized = false;
95
+ if (isBrowser && !initialized) {
96
+ initialized = true;
97
+ initRouter();
98
+ }
99
+ var RouterContext = null;
100
+ var RouterProvider = null;
101
+ var useRouter = getRouterContext;
102
+ if (typeof globalThis !== "undefined") {
103
+ try {
104
+ const React = globalThis.React;
105
+ if (React?.createContext) {
106
+ const { createContext: createContext2, useState: useState2, useEffect: useEffect3, useContext: useContext2 } = React;
107
+ const ReactRouterContext = createContext2(currentContext);
108
+ RouterContext = ReactRouterContext;
109
+ RouterProvider = function FlightRouterProvider({
110
+ children,
111
+ initialPath,
112
+ basePath = ""
113
+ }) {
114
+ const [routerState, setRouterState] = useState2(() => {
115
+ const path = isBrowser ? window.location.pathname : initialPath || "/";
116
+ const searchParams = isBrowser ? new URLSearchParams(window.location.search) : new URLSearchParams();
117
+ return {
118
+ path: basePath && path.startsWith(basePath) ? path.slice(basePath.length) || "/" : path,
119
+ searchParams,
120
+ navigate: navigateTo,
121
+ back: () => isBrowser && window.history.back(),
122
+ forward: () => isBrowser && window.history.forward()
123
+ };
124
+ });
125
+ useEffect3(() => {
126
+ if (!isBrowser) return;
127
+ const handlePopState = () => {
128
+ let path = window.location.pathname;
129
+ if (basePath && path.startsWith(basePath)) {
130
+ path = path.slice(basePath.length) || "/";
131
+ }
132
+ setRouterState((prev) => ({
133
+ ...prev,
134
+ path,
135
+ searchParams: new URLSearchParams(window.location.search)
136
+ }));
137
+ };
138
+ window.addEventListener("popstate", handlePopState);
139
+ return () => window.removeEventListener("popstate", handlePopState);
140
+ }, [basePath]);
141
+ useEffect3(() => {
142
+ return subscribe((ctx) => {
143
+ setRouterState((prev) => ({
144
+ ...prev,
145
+ path: ctx.path,
146
+ searchParams: ctx.searchParams
147
+ }));
148
+ });
149
+ }, []);
150
+ return React.createElement(
151
+ ReactRouterContext.Provider,
152
+ { value: routerState },
153
+ children
154
+ );
155
+ };
156
+ useRouter = function useFlightRouter() {
157
+ return useContext2(ReactRouterContext);
158
+ };
159
+ }
160
+ } catch {
161
+ }
162
+ }
163
+
164
+ // src/navigate.ts
165
+ var isBrowser2 = typeof window !== "undefined";
166
+ function navigate(to, options = {}) {
167
+ const { navigate: routerNavigate } = getRouterContext();
168
+ routerNavigate(to, options);
169
+ }
170
+ function patternToRegex(pattern) {
171
+ const paramNames = [];
172
+ let regexStr = pattern.replace(/[.+?^${}()|[\]\\]/g, "\\$&").replace(/\\\[\.\.\.(\w+)\\\]/g, (_, name) => {
173
+ paramNames.push(name);
174
+ return "(.+)";
175
+ }).replace(/\\\[(\w+)\\\]/g, (_, name) => {
176
+ paramNames.push(name);
177
+ return "([^/]+)";
178
+ }).replace(/:(\w+)/g, (_, name) => {
179
+ paramNames.push(name);
180
+ return "([^/]+)";
181
+ });
182
+ regexStr = `^${regexStr}$`;
183
+ return {
184
+ regex: new RegExp(regexStr),
185
+ paramNames
186
+ };
187
+ }
188
+ function matchRoute(pathname, pattern) {
189
+ const { regex, paramNames } = patternToRegex(pattern);
190
+ const match = pathname.match(regex);
191
+ if (!match) {
192
+ return { matched: false, params: {} };
193
+ }
194
+ const params = {};
195
+ paramNames.forEach((name, index) => {
196
+ params[name] = match[index + 1] || "";
197
+ });
198
+ return { matched: true, params };
199
+ }
200
+ function parseParams(pathname, pattern) {
201
+ const { params } = matchRoute(pathname, pattern);
202
+ return params;
203
+ }
204
+ function findRoute(pathname, routes) {
205
+ for (const route of routes) {
206
+ const { matched, params } = matchRoute(pathname, route.path);
207
+ if (matched) {
208
+ return {
209
+ route,
210
+ params,
211
+ pathname
212
+ };
213
+ }
214
+ }
215
+ return null;
216
+ }
217
+ function generatePath(pattern, params = {}) {
218
+ let path = pattern;
219
+ path = path.replace(/\[(\w+)\]/g, (_, name) => {
220
+ return params[name] || "";
221
+ });
222
+ path = path.replace(/:(\w+)/g, (_, name) => {
223
+ return params[name] || "";
224
+ });
225
+ return path;
226
+ }
227
+ function isActive(pattern) {
228
+ const { path } = getRouterContext();
229
+ const { matched } = matchRoute(path, pattern);
230
+ return matched;
231
+ }
232
+ function redirect(url) {
233
+ if (isBrowser2) {
234
+ window.location.href = url;
235
+ }
236
+ throw new Error(`Redirect to: ${url}`);
237
+ }
238
+
239
+ // src/prefetch.ts
240
+ var isBrowser3 = typeof window !== "undefined";
241
+ var supportsIntersectionObserver = isBrowser3 && "IntersectionObserver" in window;
242
+ var prefetchedUrls = /* @__PURE__ */ new Set();
243
+ var prefetchingUrls = /* @__PURE__ */ new Set();
244
+ var viewportObservers = /* @__PURE__ */ new Map();
245
+ function prefetch(href, options = {}) {
246
+ if (!isBrowser3) return;
247
+ const {
248
+ priority = "auto",
249
+ includeModules = true,
250
+ includeData = false
251
+ } = options;
252
+ const url = normalizeUrl(href);
253
+ if (prefetchedUrls.has(url) || prefetchingUrls.has(url)) {
254
+ return;
255
+ }
256
+ prefetchingUrls.add(url);
257
+ createPrefetchLink(url, "document", priority);
258
+ if (includeModules) {
259
+ prefetchModules(url, priority);
260
+ }
261
+ if (includeData) {
262
+ prefetchData(url, priority);
263
+ }
264
+ prefetchedUrls.add(url);
265
+ prefetchingUrls.delete(url);
266
+ }
267
+ function prefetchAll(hrefs, options = {}) {
268
+ for (const href of hrefs) {
269
+ prefetch(href, options);
270
+ }
271
+ }
272
+ function isPrefetched(href) {
273
+ return prefetchedUrls.has(normalizeUrl(href));
274
+ }
275
+ function clearPrefetchCache() {
276
+ prefetchedUrls.clear();
277
+ prefetchingUrls.clear();
278
+ }
279
+ function createPrefetchLink(href, as, priority) {
280
+ if (!isBrowser3) return null;
281
+ const existing = document.querySelector(
282
+ `link[rel="prefetch"][href="${href}"], link[rel="modulepreload"][href="${href}"]`
283
+ );
284
+ if (existing) return existing;
285
+ const link = document.createElement("link");
286
+ if (as === "script") {
287
+ link.rel = "modulepreload";
288
+ } else {
289
+ link.rel = "prefetch";
290
+ link.as = as;
291
+ }
292
+ link.href = href;
293
+ if (priority !== "auto" && "fetchPriority" in link) {
294
+ link.fetchPriority = priority;
295
+ }
296
+ if (priority === "low" && "requestIdleCallback" in window) {
297
+ window.requestIdleCallback(() => {
298
+ document.head.appendChild(link);
299
+ });
300
+ } else {
301
+ document.head.appendChild(link);
302
+ }
303
+ return link;
304
+ }
305
+ function prefetchModules(href, priority) {
306
+ const manifest = window.__FLIGHT_MANIFEST__;
307
+ if (!manifest?.routes) return;
308
+ const routeModules = manifest.routes[href];
309
+ if (!routeModules) return;
310
+ for (const module of routeModules) {
311
+ createPrefetchLink(module, "script", priority);
312
+ }
313
+ }
314
+ function prefetchData(href, priority) {
315
+ const dataUrl = `/_flight/data${href === "/" ? "/index" : href}.json`;
316
+ createPrefetchLink(dataUrl, "fetch", priority);
317
+ }
318
+ var sharedObserver = null;
319
+ var observerCallbacks = /* @__PURE__ */ new Map();
320
+ function getViewportObserver() {
321
+ if (!supportsIntersectionObserver) return null;
322
+ if (!sharedObserver) {
323
+ sharedObserver = new IntersectionObserver(
324
+ (entries) => {
325
+ for (const entry of entries) {
326
+ if (entry.isIntersecting) {
327
+ const callback = observerCallbacks.get(entry.target);
328
+ if (callback) {
329
+ callback();
330
+ sharedObserver?.unobserve(entry.target);
331
+ observerCallbacks.delete(entry.target);
332
+ }
333
+ }
334
+ }
335
+ },
336
+ {
337
+ // Start prefetching when link is 25% visible or within 100px of viewport
338
+ rootMargin: "100px",
339
+ threshold: 0.25
340
+ }
341
+ );
342
+ }
343
+ return sharedObserver;
344
+ }
345
+ function observeForPrefetch(element, href) {
346
+ if (!supportsIntersectionObserver) {
347
+ return () => {
348
+ };
349
+ }
350
+ const observer = getViewportObserver();
351
+ if (!observer) return () => {
352
+ };
353
+ const callback = () => {
354
+ prefetch(href, { priority: "low" });
355
+ };
356
+ observerCallbacks.set(element, callback);
357
+ observer.observe(element);
358
+ const cleanup = () => {
359
+ observer.unobserve(element);
360
+ observerCallbacks.delete(element);
361
+ viewportObservers.delete(element);
362
+ };
363
+ viewportObservers.set(element, cleanup);
364
+ return cleanup;
365
+ }
366
+ function setupIntentPrefetch(element, href) {
367
+ if (!isBrowser3) return () => {
368
+ };
369
+ let prefetchTriggered = false;
370
+ const handleIntent = () => {
371
+ if (!prefetchTriggered) {
372
+ prefetchTriggered = true;
373
+ prefetch(href, { priority: "auto" });
374
+ }
375
+ };
376
+ element.addEventListener("mouseenter", handleIntent, { passive: true });
377
+ element.addEventListener("focus", handleIntent, { passive: true });
378
+ element.addEventListener("touchstart", handleIntent, { passive: true });
379
+ return () => {
380
+ element.removeEventListener("mouseenter", handleIntent);
381
+ element.removeEventListener("focus", handleIntent);
382
+ element.removeEventListener("touchstart", handleIntent);
383
+ };
384
+ }
385
+ function normalizeUrl(href) {
386
+ if (isBrowser3 && !href.startsWith("http")) {
387
+ try {
388
+ const url = new URL(href, window.location.origin);
389
+ return url.pathname + url.search;
390
+ } catch {
391
+ return href;
392
+ }
393
+ }
394
+ return href;
395
+ }
396
+
397
+ // src/prefetch-links.ts
398
+ var isBrowser4 = typeof window !== "undefined";
399
+ var PrefetchPageLinks = null;
400
+ if (typeof globalThis !== "undefined") {
401
+ try {
402
+ const React = globalThis.React;
403
+ if (React?.createElement && "useEffect" in React) {
404
+ const { useEffect: useEffect3, useState: useState2 } = React;
405
+ PrefetchPageLinks = function FlightPrefetchPageLinks({
406
+ page,
407
+ options = {}
408
+ }) {
409
+ const [shouldRender, setShouldRender] = useState2(false);
410
+ useEffect3(() => {
411
+ if (!isBrowser4) return;
412
+ if (isPrefetched(page)) {
413
+ return;
414
+ }
415
+ prefetch(page, {
416
+ priority: "low",
417
+ includeModules: true,
418
+ ...options
419
+ });
420
+ setShouldRender(false);
421
+ }, [page, options]);
422
+ return null;
423
+ };
424
+ }
425
+ } catch {
426
+ }
427
+ }
428
+ function prefetchPages(pages, options = {}) {
429
+ if (!isBrowser4) return;
430
+ for (const page of pages) {
431
+ if (!isPrefetched(page)) {
432
+ prefetch(page, {
433
+ priority: "low",
434
+ ...options
435
+ });
436
+ }
437
+ }
438
+ }
439
+ function prefetchWhenIdle(page, options = {}) {
440
+ if (!isBrowser4) return;
441
+ const doPrefetch = () => {
442
+ if (!isPrefetched(page)) {
443
+ prefetch(page, {
444
+ priority: "low",
445
+ ...options
446
+ });
447
+ }
448
+ };
449
+ if ("requestIdleCallback" in window) {
450
+ window.requestIdleCallback(doPrefetch, { timeout: 3e3 });
451
+ } else {
452
+ setTimeout(doPrefetch, 100);
453
+ }
454
+ }
455
+
456
+ // src/preact/Link.tsx
457
+ import { h } from "preact";
458
+ import { useCallback, useEffect, useRef } from "preact/hooks";
459
+ var isBrowser5 = typeof window !== "undefined";
460
+ function isExternalUrl(href) {
461
+ if (!href) return false;
462
+ return href.startsWith("http://") || href.startsWith("https://") || href.startsWith("//") || href.startsWith("mailto:") || href.startsWith("tel:") || href.startsWith("javascript:") || href.startsWith("#");
463
+ }
464
+ function normalizePrefetchStrategy(prefetchProp) {
465
+ if (prefetchProp === true) return "intent";
466
+ if (prefetchProp === false || prefetchProp === void 0) return "none";
467
+ return prefetchProp;
468
+ }
469
+ var Link = ({
470
+ href,
471
+ children,
472
+ class: className,
473
+ className: classNameProp,
474
+ target,
475
+ rel,
476
+ prefetch: prefetchProp = "none",
477
+ replace = false,
478
+ scroll = true,
479
+ onClick,
480
+ "aria-label": ariaLabel,
481
+ ...props
482
+ }) => {
483
+ const linkRef = useRef(null);
484
+ const isExternal = isExternalUrl(href);
485
+ const prefetchStrategy = normalizePrefetchStrategy(prefetchProp);
486
+ const handleClick = useCallback(
487
+ (e) => {
488
+ if (onClick) {
489
+ onClick(e);
490
+ if (e.defaultPrevented) return;
491
+ }
492
+ if (e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) {
493
+ return;
494
+ }
495
+ if (e.button !== 0) {
496
+ return;
497
+ }
498
+ if (isExternal || target === "_blank") {
499
+ return;
500
+ }
501
+ e.preventDefault();
502
+ const { navigate: navigate2 } = getRouterContext();
503
+ navigate2(href, { replace, scroll });
504
+ },
505
+ [href, isExternal, target, replace, scroll, onClick]
506
+ );
507
+ useEffect(() => {
508
+ if (isExternal || !isBrowser5 || prefetchStrategy === "none") {
509
+ return;
510
+ }
511
+ const link = linkRef.current;
512
+ if (!link) return;
513
+ switch (prefetchStrategy) {
514
+ case "render":
515
+ prefetch(href, { priority: "low" });
516
+ break;
517
+ case "viewport":
518
+ return observeForPrefetch(link, href);
519
+ case "intent":
520
+ default:
521
+ return setupIntentPrefetch(link, href);
522
+ }
523
+ }, [href, prefetchStrategy, isExternal]);
524
+ const computedRel = isExternal && target === "_blank" ? rel || "noopener noreferrer" : rel;
525
+ const finalClassName = className || classNameProp;
526
+ return h("a", {
527
+ ref: linkRef,
528
+ href,
529
+ class: finalClassName,
530
+ target,
531
+ rel: computedRel,
532
+ "aria-label": ariaLabel,
533
+ onClick: handleClick,
534
+ ...props
535
+ }, children);
536
+ };
537
+
538
+ // src/preact/RouterProvider.tsx
539
+ import { h as h2, createContext } from "preact";
540
+ import { useContext, useState, useEffect as useEffect2 } from "preact/hooks";
541
+ var isBrowser6 = typeof window !== "undefined";
542
+ function navigateTo2(to, options = {}) {
543
+ if (!isBrowser6) return;
544
+ const { replace = false, scroll = true, state } = options;
545
+ if (replace) {
546
+ window.history.replaceState(state ?? null, "", to);
547
+ } else {
548
+ window.history.pushState(state ?? null, "", to);
549
+ }
550
+ if (scroll) {
551
+ window.scrollTo({ top: 0, left: 0, behavior: "instant" });
552
+ }
553
+ }
554
+ var defaultContext = {
555
+ path: "/",
556
+ searchParams: new URLSearchParams(),
557
+ navigate: navigateTo2,
558
+ back: () => isBrowser6 && window.history.back(),
559
+ forward: () => isBrowser6 && window.history.forward()
560
+ };
561
+ var RouterContext2 = createContext(defaultContext);
562
+ function useRouter2() {
563
+ return useContext(RouterContext2);
564
+ }
565
+ function usePathname() {
566
+ const { path } = useContext(RouterContext2);
567
+ return path;
568
+ }
569
+ function useSearchParams() {
570
+ const { searchParams } = useContext(RouterContext2);
571
+ return searchParams;
572
+ }
573
+ function useParams() {
574
+ return {};
575
+ }
576
+ var RouterProvider2 = ({
577
+ children,
578
+ initialPath,
579
+ basePath = ""
580
+ }) => {
581
+ const [routerState, setRouterState] = useState(() => {
582
+ const path = isBrowser6 ? window.location.pathname : initialPath || "/";
583
+ const searchParams = isBrowser6 ? new URLSearchParams(window.location.search) : new URLSearchParams();
584
+ let normalizedPath = path;
585
+ if (basePath && path.startsWith(basePath)) {
586
+ normalizedPath = path.slice(basePath.length) || "/";
587
+ }
588
+ return {
589
+ path: normalizedPath,
590
+ searchParams,
591
+ navigate: navigateTo2,
592
+ back: () => isBrowser6 && window.history.back(),
593
+ forward: () => isBrowser6 && window.history.forward()
594
+ };
595
+ });
596
+ useEffect2(() => {
597
+ if (!isBrowser6) return;
598
+ const handlePopState = () => {
599
+ let path = window.location.pathname;
600
+ if (basePath && path.startsWith(basePath)) {
601
+ path = path.slice(basePath.length) || "/";
602
+ }
603
+ setRouterState((prev) => ({
604
+ ...prev,
605
+ path,
606
+ searchParams: new URLSearchParams(window.location.search)
607
+ }));
608
+ };
609
+ window.addEventListener("popstate", handlePopState);
610
+ const unsubscribe = subscribe((ctx) => {
611
+ let path = ctx.path;
612
+ if (basePath && path.startsWith(basePath)) {
613
+ path = path.slice(basePath.length) || "/";
614
+ }
615
+ setRouterState((prev) => ({
616
+ ...prev,
617
+ path,
618
+ searchParams: ctx.searchParams
619
+ }));
620
+ });
621
+ return () => {
622
+ window.removeEventListener("popstate", handlePopState);
623
+ unsubscribe();
624
+ };
625
+ }, [basePath]);
626
+ return h2(RouterContext2.Provider, { value: routerState }, children);
627
+ };
628
+ export {
629
+ Link,
630
+ RouterContext2 as RouterContext,
631
+ RouterProvider2 as RouterProvider,
632
+ clearPrefetchCache,
633
+ findRoute,
634
+ generatePath,
635
+ getRouterContext,
636
+ initRouter,
637
+ isActive,
638
+ isPrefetched,
639
+ matchRoute,
640
+ navigate,
641
+ observeForPrefetch,
642
+ parseParams,
643
+ prefetch,
644
+ prefetchAll,
645
+ prefetchPages,
646
+ prefetchWhenIdle,
647
+ redirect,
648
+ setupIntentPrefetch,
649
+ subscribe,
650
+ useParams,
651
+ usePathname,
652
+ useRouter2 as useRouter,
653
+ useSearchParams
654
+ };