@fluojs/react 0.1.0

package/dist/client/errors.d.ts

@@ -0,0 +1,12 @@
+/** Error codes emitted when browser navigation cannot honor the client router contract. */
+export type ReactClientNavigationErrorCode = 'browser-unavailable' | 'unsupported-destination';
+/** Typed client navigation failure with a stable machine-readable code. */
+export declare class ReactClientNavigationError extends Error {
+    readonly code: ReactClientNavigationErrorCode;
+    constructor(code: ReactClientNavigationErrorCode, message: string);
+}
+/** Error thrown when route hooks are rendered without a client router provider. */
+export declare class ReactClientRouterContextError extends Error {
+    constructor();
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/client/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/client/errors.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,MAAM,MAAM,8BAA8B,GAAG,qBAAqB,GAAG,yBAAyB,CAAC;AAE/F,2EAA2E;AAC3E,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,QAAQ,CAAC,IAAI,EAAE,8BAA8B,CAAC;gBAElC,IAAI,EAAE,8BAA8B,EAAE,OAAO,EAAE,MAAM;CAKlE;AAED,mFAAmF;AACnF,qBAAa,6BAA8B,SAAQ,KAAK;;CAKvD"}

package/dist/client/errors.js

@@ -0,0 +1,19 @@
+/** Error codes emitted when browser navigation cannot honor the client router contract. */
+
+/** Typed client navigation failure with a stable machine-readable code. */
+export class ReactClientNavigationError extends Error {
+  code;
+  constructor(code, message) {
+    super(message);
+    this.code = code;
+    this.name = 'ReactClientNavigationError';
+  }
+}
+
+/** Error thrown when route hooks are rendered without a client router provider. */
+export class ReactClientRouterContextError extends Error {
+  constructor() {
+    super('React client route hooks require ReactClientRouterProvider.');
+    this.name = 'ReactClientRouterContextError';
+  }
+}

package/dist/client/hooks.d.ts

@@ -0,0 +1,38 @@
+import type { ReactNavigationSnapshot, ReactReadonlySearchParams, ReactRouter, ReactRouteSnapshot } from './types.js';
+/**
+ * Read the router operations bound to the hydrated browser document.
+ *
+ * @returns Router operations for full-document navigation and history traversal.
+ */
+export declare function useRouter(): ReactRouter;
+/**
+ * Read the current HTTP route pathname and subscribe to history updates.
+ *
+ * @returns The pathname from the current immutable route snapshot.
+ */
+export declare function usePathname(): string;
+/**
+ * Read the path params supplied by the latest server-owned HTTP route match.
+ *
+ * @returns The server-matched path parameter snapshot.
+ */
+export declare function useParams(): Readonly<Record<string, string>>;
+/**
+ * Read an immutable search parameter snapshot and subscribe to history updates.
+ *
+ * @returns Read-only search parameters from the current route snapshot.
+ */
+export declare function useSearchParams(): ReactReadonlySearchParams;
+/**
+ * Read the current navigation lifecycle state.
+ *
+ * @returns The current navigation status, type, and optional destination.
+ */
+export declare function useNavigation(): ReactNavigationSnapshot;
+/**
+ * Read the complete route-state snapshot for the active HTTP document.
+ *
+ * @returns The immutable route snapshot shared by the provider.
+ */
+export declare function useRouterState(): ReactRouteSnapshot;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/client/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/client/hooks.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,uBAAuB,EACvB,yBAAyB,EACzB,WAAW,EACX,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,WAAW,CAEvC;AAED;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,yBAAyB,CAE3D;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,uBAAuB,CAEvD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,kBAAkB,CAGnD"}

package/dist/client/hooks.js

@@ -0,0 +1,56 @@
+import { useSyncExternalStore } from 'react';
+import { useClientNavigationStore } from './provider.js';
+/**
+ * Read the router operations bound to the hydrated browser document.
+ *
+ * @returns Router operations for full-document navigation and history traversal.
+ */
+export function useRouter() {
+  return useClientNavigationStore().router;
+}
+
+/**
+ * Read the current HTTP route pathname and subscribe to history updates.
+ *
+ * @returns The pathname from the current immutable route snapshot.
+ */
+export function usePathname() {
+  return useRouterState().pathname;
+}
+
+/**
+ * Read the path params supplied by the latest server-owned HTTP route match.
+ *
+ * @returns The server-matched path parameter snapshot.
+ */
+export function useParams() {
+  return useRouterState().params;
+}
+
+/**
+ * Read an immutable search parameter snapshot and subscribe to history updates.
+ *
+ * @returns Read-only search parameters from the current route snapshot.
+ */
+export function useSearchParams() {
+  return useRouterState().searchParams;
+}
+
+/**
+ * Read the current navigation lifecycle state.
+ *
+ * @returns The current navigation status, type, and optional destination.
+ */
+export function useNavigation() {
+  return useRouterState().navigation;
+}
+
+/**
+ * Read the complete route-state snapshot for the active HTTP document.
+ *
+ * @returns The immutable route snapshot shared by the provider.
+ */
+export function useRouterState() {
+  const store = useClientNavigationStore();
+  return useSyncExternalStore(store.subscribe, store.getSnapshot, store.getSnapshot);
+}

package/dist/client/link.d.ts

@@ -0,0 +1,13 @@
+import { type AnchorHTMLAttributes, type ReactElement } from 'react';
+/** Props accepted by the progressive-enhancement-friendly client navigation anchor. */
+export type LinkProps = Omit<AnchorHTMLAttributes<HTMLAnchorElement>, 'href'> & {
+    readonly href: string | URL;
+};
+/**
+ * Render a real anchor that upgrades same-origin primary clicks after hydration.
+ *
+ * @param props Anchor props plus a required navigation destination.
+ * @returns A semantic anchor that falls back to ordinary document navigation without JavaScript.
+ */
+export declare function Link({ children, href, onClick, target, ...anchorProps }: LinkProps): ReactElement;
+//# sourceMappingURL=link.d.ts.map

package/dist/client/link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../../src/client/link.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,oBAAoB,EAAmB,KAAK,YAAY,EAAE,MAAM,OAAO,CAAC;AAIrG,uFAAuF;AACvF,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC,GAAG;IAC9E,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC;CAC7B,CAAC;AAMF;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,EAAE,SAAS,GAAG,YAAY,CAsBjG"}

package/dist/client/link.js

@@ -0,0 +1,39 @@
+import { createElement } from 'react';
+import { useClientNavigationStore } from './provider.js';
+
+/** Props accepted by the progressive-enhancement-friendly client navigation anchor. */
+
+function hasNavigationModifier(event) {
+  return event.altKey || event.ctrlKey || event.metaKey || event.shiftKey;
+}
+
+/**
+ * Render a real anchor that upgrades same-origin primary clicks after hydration.
+ *
+ * @param props Anchor props plus a required navigation destination.
+ * @returns A semantic anchor that falls back to ordinary document navigation without JavaScript.
+ */
+export function Link({
+  children,
+  href,
+  onClick,
+  target,
+  ...anchorProps
+}) {
+  const store = useClientNavigationStore();
+  const hrefValue = String(href);
+  const handleClick = event => {
+    onClick?.(event);
+    if (event.defaultPrevented || event.button !== 0 || hasNavigationModifier(event) || anchorProps.download !== undefined || target !== undefined && target !== '_self' || !store.canHandleLink(href)) {
+      return;
+    }
+    event.preventDefault();
+    store.router.push(href);
+  };
+  return createElement('a', {
+    ...anchorProps,
+    href: hrefValue,
+    onClick: handleClick,
+    target
+  }, children);
+}

package/dist/client/provider.d.ts

@@ -0,0 +1,12 @@
+import { type ClientNavigationStore } from './store.js';
+import type { ReactClientRouterProviderProps } from './types.js';
+/**
+ * Provide one HTTP request route snapshot to client navigation hooks during SSR and hydration.
+ *
+ * @param props Initial route snapshot and descendants that consume client route state.
+ * @returns A context provider that binds browser navigation only after hydration.
+ */
+export declare function ReactClientRouterProvider({ children, initialSnapshot }: ReactClientRouterProviderProps): import("react").FunctionComponentElement<import("react").ProviderProps<ClientNavigationStore | null>>;
+/** Read the provider-owned navigation store for public hooks and `Link`. */
+export declare function useClientNavigationStore(): ClientNavigationStore;
+//# sourceMappingURL=provider.d.ts.map

package/dist/client/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/client/provider.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,qBAAqB,EAE3B,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,YAAY,CAAC;AAwBjE;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,EAAE,QAAQ,EAAE,eAAe,EAAE,EAAE,8BAA8B,yGAWtG;AAED,4EAA4E;AAC5E,wBAAgB,wBAAwB,IAAI,qBAAqB,CAMhE"}

package/dist/client/provider.js

@@ -0,0 +1,54 @@
+import { createContext, createElement, useContext, useEffect, useState } from 'react';
+import { ReactClientRouterContextError } from './errors.js';
+import { createClientNavigationStore } from './store.js';
+const ClientRouterContext = createContext(null);
+function createBrowserEnvironment(browser) {
+  return {
+    assign: href => browser.location.assign(href),
+    back: () => browser.history.back(),
+    currentHref: () => browser.location.href,
+    reload: () => browser.location.reload(),
+    replace: href => browser.location.replace(href),
+    subscribe(listener) {
+      const handleHashChange = () => listener('hashchange');
+      const handlePopState = () => listener('popstate');
+      browser.addEventListener('hashchange', handleHashChange);
+      browser.addEventListener('popstate', handlePopState);
+      return () => {
+        browser.removeEventListener('hashchange', handleHashChange);
+        browser.removeEventListener('popstate', handlePopState);
+      };
+    }
+  };
+}
+
+/**
+ * Provide one HTTP request route snapshot to client navigation hooks during SSR and hydration.
+ *
+ * @param props Initial route snapshot and descendants that consume client route state.
+ * @returns A context provider that binds browser navigation only after hydration.
+ */
+export function ReactClientRouterProvider({
+  children,
+  initialSnapshot
+}) {
+  const [store] = useState(() => createClientNavigationStore(initialSnapshot));
+  useEffect(() => {
+    if (typeof window === 'undefined') {
+      return undefined;
+    }
+    return store.connect(createBrowserEnvironment(window));
+  }, [store]);
+  return createElement(ClientRouterContext.Provider, {
+    value: store
+  }, children);
+}
+
+/** Read the provider-owned navigation store for public hooks and `Link`. */
+export function useClientNavigationStore() {
+  const store = useContext(ClientRouterContext);
+  if (store === null) {
+    throw new ReactClientRouterContextError();
+  }
+  return store;
+}

package/dist/client/search-params.d.ts

@@ -0,0 +1,17 @@
+import type { ReactReadonlySearchParams } from './types.js';
+/** Immutable wrapper around a native `URLSearchParams` snapshot. */
+export declare class ReadonlySearchParams implements ReactReadonlySearchParams {
+    #private;
+    constructor(search: string);
+    get size(): number;
+    [Symbol.iterator](): URLSearchParamsIterator<[string, string]>;
+    entries(): URLSearchParamsIterator<[string, string]>;
+    forEach(callback: (value: string, key: string, searchParams: ReactReadonlySearchParams) => void): void;
+    get(name: string): string | null;
+    getAll(name: string): string[];
+    has(name: string, value?: string): boolean;
+    keys(): URLSearchParamsIterator<string>;
+    toString(): string;
+    values(): URLSearchParamsIterator<string>;
+}
+//# sourceMappingURL=search-params.d.ts.map

package/dist/client/search-params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-params.d.ts","sourceRoot":"","sources":["../../src/client/search-params.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAE5D,oEAAoE;AACpE,qBAAa,oBAAqB,YAAW,yBAAyB;;gBAGxD,MAAM,EAAE,MAAM;IAI1B,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,uBAAuB,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAI9D,OAAO,IAAI,uBAAuB,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAIpD,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,yBAAyB,KAAK,IAAI,GAAG,IAAI;IAMtG,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIhC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAI9B,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO;IAI1C,IAAI,IAAI,uBAAuB,CAAC,MAAM,CAAC;IAIvC,QAAQ,IAAI,MAAM;IAIlB,MAAM,IAAI,uBAAuB,CAAC,MAAM,CAAC;CAG1C"}

package/dist/client/search-params.js

@@ -0,0 +1,39 @@
+/** Immutable wrapper around a native `URLSearchParams` snapshot. */
+export class ReadonlySearchParams {
+  #searchParams;
+  constructor(search) {
+    this.#searchParams = new URLSearchParams(search);
+  }
+  get size() {
+    return this.#searchParams.size;
+  }
+  [Symbol.iterator]() {
+    return this.#searchParams[Symbol.iterator]();
+  }
+  entries() {
+    return this.#searchParams.entries();
+  }
+  forEach(callback) {
+    this.#searchParams.forEach((value, key) => {
+      callback(value, key, this);
+    });
+  }
+  get(name) {
+    return this.#searchParams.get(name);
+  }
+  getAll(name) {
+    return this.#searchParams.getAll(name);
+  }
+  has(name, value) {
+    return value === undefined ? this.#searchParams.has(name) : this.#searchParams.has(name, value);
+  }
+  keys() {
+    return this.#searchParams.keys();
+  }
+  toString() {
+    return this.#searchParams.toString();
+  }
+  values() {
+    return this.#searchParams.values();
+  }
+}

package/dist/client/snapshot.d.ts

@@ -0,0 +1,15 @@
+import type { ReactNavigationSnapshot, ReactRouteSnapshot, ReactRouteSnapshotInput } from './types.js';
+/**
+ * Create a defensive route-state snapshot from an HTTP request URL and matched path params.
+ *
+ * @param input Request-owned URL and matched path params shared with hydration.
+ * @returns An immutable URL snapshot suitable for `ReactClientRouterProvider`.
+ */
+export declare function createReactRouteSnapshot(input: ReactRouteSnapshotInput): ReactRouteSnapshot;
+/** Rebuild a route snapshot after browser history activates a URL. */
+export declare function createSnapshotFromHref(href: string, params: Readonly<Record<string, string>>, navigation: ReactNavigationSnapshot): ReactRouteSnapshot;
+/** Preserve route URL state while producing a new navigation lifecycle snapshot. */
+export declare function createSnapshotWithNavigation(snapshot: ReactRouteSnapshot, navigation: ReactNavigationSnapshot): ReactRouteSnapshot;
+/** Normalize an absolute browser URL to the request-relative route snapshot form. */
+export declare function toSnapshotUrl(href: string): string;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/client/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/client/snapshot.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,EACxB,MAAM,YAAY,CAAC;AASpB;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,uBAAuB,GAAG,kBAAkB,CAW3F;AAED,sEAAsE;AACtE,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACxC,UAAU,EAAE,uBAAuB,GAClC,kBAAkB,CAWpB;AAED,oFAAoF;AACpF,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,kBAAkB,EAC5B,UAAU,EAAE,uBAAuB,GAClC,kBAAkB,CAEpB;AAED,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD"}

package/dist/client/snapshot.js

@@ -0,0 +1,57 @@
+import { ReadonlySearchParams } from './search-params.js';
+const ROUTE_SNAPSHOT_BASE_URL = 'https://fluo.invalid/';
+const IDLE_NAVIGATION = Object.freeze({
+  status: 'idle',
+  type: null
+});
+function toRouteUrl(url) {
+  return `${url.pathname}${url.search}${url.hash}`;
+}
+
+/**
+ * Create a defensive route-state snapshot from an HTTP request URL and matched path params.
+ *
+ * @param input Request-owned URL and matched path params shared with hydration.
+ * @returns An immutable URL snapshot suitable for `ReactClientRouterProvider`.
+ */
+export function createReactRouteSnapshot(input) {
+  const url = new URL(input.url, ROUTE_SNAPSHOT_BASE_URL);
+  return Object.freeze({
+    hash: url.hash,
+    navigation: IDLE_NAVIGATION,
+    params: Object.freeze({
+      ...input.params
+    }),
+    pathname: url.pathname,
+    searchParams: new ReadonlySearchParams(url.search),
+    url: toRouteUrl(url)
+  });
+}
+
+/** Rebuild a route snapshot after browser history activates a URL. */
+export function createSnapshotFromHref(href, params, navigation) {
+  const url = new URL(href, ROUTE_SNAPSHOT_BASE_URL);
+  return Object.freeze({
+    hash: url.hash,
+    navigation: Object.freeze(navigation),
+    params: Object.freeze({
+      ...params
+    }),
+    pathname: url.pathname,
+    searchParams: new ReadonlySearchParams(url.search),
+    url: toRouteUrl(url)
+  });
+}
+
+/** Preserve route URL state while producing a new navigation lifecycle snapshot. */
+export function createSnapshotWithNavigation(snapshot, navigation) {
+  return Object.freeze({
+    ...snapshot,
+    navigation: Object.freeze(navigation)
+  });
+}
+
+/** Normalize an absolute browser URL to the request-relative route snapshot form. */
+export function toSnapshotUrl(href) {
+  return toRouteUrl(new URL(href));
+}

package/dist/client/store.d.ts

@@ -0,0 +1,26 @@
+import type { ReactRouter, ReactRouteSnapshot } from './types.js';
+/** Browser operations required by the HTTP-first navigation store. */
+export type ClientNavigationEnvironment = {
+    readonly assign: (href: string) => void;
+    readonly back: () => void;
+    readonly currentHref: () => string;
+    readonly reload: () => void;
+    readonly replace: (href: string) => void;
+    readonly subscribe: (listener: (eventType: 'hashchange' | 'popstate') => void) => () => void;
+};
+/** Internal observable store shared by the provider, hooks, and progressive `Link`. */
+export type ClientNavigationStore = {
+    readonly canHandleLink: (href: string | URL) => boolean;
+    readonly connect: (environment: ClientNavigationEnvironment) => () => void;
+    readonly getSnapshot: () => ReactRouteSnapshot;
+    readonly router: ReactRouter;
+    readonly subscribe: (listener: () => void) => () => void;
+};
+/**
+ * Create the client navigation store used by `ReactClientRouterProvider`.
+ *
+ * @param initialSnapshot Request-owned route state used for SSR and hydration.
+ * @returns A store whose router delegates rendering and validation to browser HTTP navigation.
+ */
+export declare function createClientNavigationStore(initialSnapshot: ReactRouteSnapshot): ClientNavigationStore;
+//# sourceMappingURL=store.d.ts.map

package/dist/client/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/client/store.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAGV,WAAW,EACX,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB,sEAAsE;AACtE,MAAM,MAAM,2BAA2B,GAAG;IACxC,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,MAAM,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,YAAY,GAAG,UAAU,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;CAC9F,CAAC;AAEF,uFAAuF;AACvF,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,KAAK,OAAO,CAAC;IACxD,QAAQ,CAAC,OAAO,EAAE,CAAC,WAAW,EAAE,2BAA2B,KAAK,MAAM,IAAI,CAAC;IAC3E,QAAQ,CAAC,WAAW,EAAE,MAAM,kBAAkB,CAAC;IAC/C,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;CAC1D,CAAC;AAgBF;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,eAAe,EAAE,kBAAkB,GAAG,qBAAqB,CAmJtG"}

package/dist/client/store.js

@@ -0,0 +1,138 @@
+import { ReactClientNavigationError } from './errors.js';
+import { createSnapshotFromHref, createSnapshotWithNavigation, toSnapshotUrl } from './snapshot.js';
+
+/** Browser operations required by the HTTP-first navigation store. */
+
+/** Internal observable store shared by the provider, hooks, and progressive `Link`. */
+
+function createNavigationSnapshot(status, type, destination) {
+  return destination === undefined ? {
+    status,
+    type
+  } : {
+    destination,
+    status,
+    type
+  };
+}
+function isHttpProtocol(protocol) {
+  return protocol === 'http:' || protocol === 'https:';
+}
+
+/**
+ * Create the client navigation store used by `ReactClientRouterProvider`.
+ *
+ * @param initialSnapshot Request-owned route state used for SSR and hydration.
+ * @returns A store whose router delegates rendering and validation to browser HTTP navigation.
+ */
+export function createClientNavigationStore(initialSnapshot) {
+  let environment = null;
+  let snapshot = initialSnapshot;
+  const listeners = new Set();
+  const publish = nextSnapshot => {
+    snapshot = nextSnapshot;
+    for (const listener of listeners) {
+      listener();
+    }
+  };
+  const createSnapshotForHref = (href, navigation) => {
+    const pathname = new URL(href).pathname;
+    const params = pathname === snapshot.pathname ? snapshot.params : {};
+    return createSnapshotFromHref(href, params, navigation);
+  };
+  const requireEnvironment = () => {
+    if (environment === null) {
+      throw new ReactClientNavigationError('browser-unavailable', 'React client navigation is unavailable before hydration or outside a browser.');
+    }
+    return environment;
+  };
+  const resolveDestination = href => {
+    const browser = requireEnvironment();
+    const current = new URL(browser.currentHref());
+    const destination = new URL(href, current);
+    if (!isHttpProtocol(destination.protocol) || destination.origin !== current.origin) {
+      throw new ReactClientNavigationError('unsupported-destination', 'useRouter() supports only same-origin HTTP or HTTPS destinations.');
+    }
+    return destination;
+  };
+  const navigateDocument = (href, type) => {
+    let destination;
+    try {
+      destination = resolveDestination(href);
+    } catch (error) {
+      publish(createSnapshotWithNavigation(snapshot, createNavigationSnapshot('error', type, String(href))));
+      throw error;
+    }
+    const destinationUrl = toSnapshotUrl(destination.href);
+    if (destinationUrl === snapshot.url) {
+      publish(createSnapshotWithNavigation(snapshot, createNavigationSnapshot('skipped', type, destinationUrl)));
+      return;
+    }
+    publish(createSnapshotWithNavigation(snapshot, createNavigationSnapshot('navigating', type, destinationUrl)));
+    const browser = requireEnvironment();
+    try {
+      if (type === 'push') {
+        browser.assign(destination.href);
+      } else {
+        browser.replace(destination.href);
+      }
+    } catch (error) {
+      publish(createSnapshotWithNavigation(snapshot, createNavigationSnapshot('error', type, destinationUrl)));
+      throw error;
+    }
+  };
+  const router = Object.freeze({
+    back() {
+      const browser = requireEnvironment();
+      publish(createSnapshotWithNavigation(snapshot, createNavigationSnapshot('navigating', 'back')));
+      browser.back();
+    },
+    push(href) {
+      navigateDocument(href, 'push');
+    },
+    refresh() {
+      const browser = requireEnvironment();
+      publish(createSnapshotWithNavigation(snapshot, createNavigationSnapshot('refreshing', 'refresh')));
+      browser.reload();
+    },
+    replace(href) {
+      navigateDocument(href, 'replace');
+    }
+  });
+  return {
+    canHandleLink(href) {
+      if (environment === null) {
+        return false;
+      }
+      const current = new URL(environment.currentHref());
+      const destination = new URL(href, current);
+      return isHttpProtocol(destination.protocol) && destination.origin === current.origin;
+    },
+    connect(nextEnvironment) {
+      environment = nextEnvironment;
+      const unsubscribe = nextEnvironment.subscribe(eventType => {
+        const currentHref = nextEnvironment.currentHref();
+        const currentUrl = toSnapshotUrl(currentHref);
+        const navigation = snapshot.navigation;
+        const routerNavigationType = eventType === 'hashchange' && navigation.status === 'navigating' && navigation.destination === currentUrl && (navigation.type === 'push' || navigation.type === 'replace') ? navigation.type : null;
+        publish(createSnapshotForHref(currentHref, routerNavigationType === null ? createNavigationSnapshot('complete', 'back') : createNavigationSnapshot('complete', routerNavigationType, currentUrl)));
+      });
+      const currentHref = nextEnvironment.currentHref();
+      if (toSnapshotUrl(currentHref) !== snapshot.url) {
+        publish(createSnapshotForHref(currentHref, snapshot.navigation));
+      }
+      return () => {
+        unsubscribe();
+        if (environment === nextEnvironment) {
+          environment = null;
+        }
+      };
+    },
+    getSnapshot: () => snapshot,
+    router,
+    subscribe(listener) {
+      listeners.add(listener);
+      return () => listeners.delete(listener);
+    }
+  };
+}

package/dist/client/types.d.ts

@@ -0,0 +1,63 @@
+import type { ReactNode } from 'react';
+/** Navigation methods that can change or revalidate the active browser document. */
+export type ReactNavigationType = 'push' | 'replace' | 'back' | 'refresh';
+/** Observable lifecycle states for HTTP-first client navigation. */
+export type ReactNavigationStatus = 'idle' | 'navigating' | 'refreshing' | 'complete' | 'error' | 'skipped';
+/** Immutable navigation lifecycle information exposed to hydrated components. */
+export type ReactNavigationSnapshot = {
+    readonly destination?: string;
+    readonly status: ReactNavigationStatus;
+    readonly type: ReactNavigationType | null;
+};
+/** Read-only URL search parameter surface returned by `useSearchParams()`. */
+export interface ReactReadonlySearchParams extends Iterable<[string, string]> {
+    /** Number of search parameter entries, including duplicate keys. */
+    readonly size: number;
+    /** Iterate over search parameter entries in source order. */
+    entries(): URLSearchParamsIterator<[string, string]>;
+    /** Iterate over each search parameter pair in source order. */
+    forEach(callback: (value: string, key: string, searchParams: ReactReadonlySearchParams) => void): void;
+    /** Read the first value for a search parameter key. */
+    get(name: string): string | null;
+    /** Read every value for a search parameter key. */
+    getAll(name: string): string[];
+    /** Check whether a search parameter key, optionally with one value, exists. */
+    has(name: string, value?: string): boolean;
+    /** Iterate over search parameter keys in source order. */
+    keys(): URLSearchParamsIterator<string>;
+    /** Serialize the search parameter snapshot without the leading question mark. */
+    toString(): string;
+    /** Iterate over search parameter values in source order. */
+    values(): URLSearchParamsIterator<string>;
+}
+/** HTTP-owned route state shared between server rendering and client hydration. */
+export type ReactRouteSnapshot = {
+    readonly hash: string;
+    readonly navigation: ReactNavigationSnapshot;
+    readonly params: Readonly<Record<string, string>>;
+    readonly pathname: string;
+    readonly searchParams: ReactReadonlySearchParams;
+    readonly url: string;
+};
+/** Input used to create an immutable route snapshot at the HTTP application boundary. */
+export type ReactRouteSnapshotInput = {
+    readonly params?: Readonly<Record<string, string>>;
+    readonly url: string | URL;
+};
+/** Browser navigation operations exposed by `useRouter()`. */
+export interface ReactRouter {
+    /** Delegate traversal to browser history semantics. */
+    back(): void;
+    /** Start same-origin full-document navigation and add a history entry. */
+    push(href: string | URL): void;
+    /** Revalidate the current page with a full-document reload. */
+    refresh(): void;
+    /** Start same-origin full-document navigation and replace the current history entry. */
+    replace(href: string | URL): void;
+}
+/** Props for the request-scoped client router state provider. */
+export type ReactClientRouterProviderProps = {
+    readonly children?: ReactNode;
+    readonly initialSnapshot: ReactRouteSnapshot;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/client/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,oFAAoF;AACpF,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;AAE1E,oEAAoE;AACpE,MAAM,MAAM,qBAAqB,GAC7B,MAAM,GACN,YAAY,GACZ,YAAY,GACZ,UAAU,GACV,OAAO,GACP,SAAS,CAAC;AAEd,iFAAiF;AACjF,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAAC;CAC3C,CAAC;AAEF,8EAA8E;AAC9E,MAAM,WAAW,yBAA0B,SAAQ,QAAQ,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3E,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,OAAO,IAAI,uBAAuB,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD,+DAA+D;IAC/D,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,yBAAyB,KAAK,IAAI,GAAG,IAAI,CAAC;IACvG,uDAAuD;IACvD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACjC,mDAAmD;IACnD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC/B,+EAA+E;IAC/E,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3C,0DAA0D;IAC1D,IAAI,IAAI,uBAAuB,CAAC,MAAM,CAAC,CAAC;IACxC,iFAAiF;IACjF,QAAQ,IAAI,MAAM,CAAC;IACnB,4DAA4D;IAC5D,MAAM,IAAI,uBAAuB,CAAC,MAAM,CAAC,CAAC;CAC3C;AAED,mFAAmF;AACnF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,uBAAuB,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAClD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,yBAAyB,CAAC;IACjD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,yFAAyF;AACzF,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CAC5B,CAAC;AAEF,8DAA8D;AAC9D,MAAM,WAAW,WAAW;IAC1B,uDAAuD;IACvD,IAAI,IAAI,IAAI,CAAC;IACb,0EAA0E;IAC1E,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC;IAC/B,+DAA+D;IAC/D,OAAO,IAAI,IAAI,CAAC;IAChB,wFAAwF;IACxF,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC;CACnC;AAED,iEAAiE;AACjE,MAAM,MAAM,8BAA8B,GAAG;IAC3C,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,kBAAkB,CAAC;CAC9C,CAAC"}

package/dist/client/types.js

@@ -0,0 +1 @@
+export {};