eddev 2.0.0-beta.2 → 2.0.0-beta.200

package/dist/app/lib/routing/hooks/useSearchParams.d.ts

@@ -1,10 +1,82 @@
+/**
+ * Search param API object.
+ */
 export type SearchParamAPI<T> = {
-    set<K extends keyof T>(key: K, value: T[K]): void;
-    setAll: (value: T) => void;
-    setter<K extends keyof T>(key: K): (value: T[K]) => void;
+    /**
+     * Set an individual parameter value by key.
+     *
+     * If the value is an array, then one or more `key[]` parameters will be set. Otherwise, a single `key` parameter will be set.
+     *
+     * If the value is `null` or `undefined`, the parameter will be removed from the query string.
+     *
+     * @param key The search parameter name
+     * @param value The value to set
+     */
+    set<K extends keyof T>(key: K, value: T[K] | null | undefined): void;
+    /**
+     * Set all parameters at once, replacing the entire query string. Any parameters not present will be replaced with their default value. Passing an empty object is equivalent to calling `reset()`.
+     *
+     * @param value
+     * @returns
+     */
+    setAll: (value: Partial<T>) => void;
+    /**
+     * Returns a memoized setter function for a specific key.
+     *
+     * This is useful when you want to pass a setter function to a child component, without needing to pass the entire API object.
+     *
+     * For example:
+     * ```tsx
+     * <SearchInput value={params.q} onSearch={api.setter("q")} />
+     * ```
+     *
+     * @param key The search parameter name
+     * @returns (value: T) => void
+     */
+    setter<K extends keyof T>(key: K): (value: T[K] | null | undefined) => void;
+    /**
+     * Reset all parameters to their default values.
+     */
     reset(): void;
+    /**
+     * Gets the current value of a parameter. In most cases, you should use the `params` object returned from `useSearchParams` instead of this method.
+     */
     get<K extends keyof T>(key: K): T[K];
 };
-export declare function useSearchParams<T extends {
-    [K: string]: any;
-}>(defaultValue: T): [T, SearchParamAPI<T>];
+/**
+ * Provides type-safe read/write access to query string parameters, integrating with the routing system.
+ *
+ * - Call `useSearchParams` with a default value object, which defines the expected shape of the query string parameters.
+ * - Only keys that are present in the default value object will be handled, and all others will be ignored.
+ * - Arrays of values are supported, and you should use a default value of `[]` for that key. You may want to cast the default parameter as an array of the expected type (eg. `myValue: [] as string[]`) to ensure that the parameter type is correct.
+ * - This hook returns a tuple with the current query string parameters object, and an API object with methods to interact with the query string. See {@link SearchParamAPI} for more details.
+ *
+ * For example:
+ * ```tsx
+ * const [params, api] = useSearchParams({
+ *  mode: "list" as "list" | "grid",
+ *  page: 1,
+ *  tags: [] as string[],
+ * })
+ *
+ * api.set("mode", "grid")
+ * api.set("tags", ["tag1", "tag2"])
+ * ```
+ *
+ * Note that if a parameter is set back to it's default value, it'll actually be _removed_ from the updated query string, keeping the URL clean when only the default values are set.
+ *
+ * ```tsx
+ * api.set("mode", "grid")
+ *   // url becomes: "/?mode=grid"
+ *   // params.mode === 'grid'
+ *
+ * api.set("mode", "list")
+ *   // url becomes: "/"
+ *   // params.mode === 'list'
+ * ```
+ *
+ * @param defaultValue - The default value object, defining the expected shape of the query string parameters.
+ * @returns A tuple of the resolve parameter object, and a {@link SearchParamAPI} object with methods to interact with the query string.
+ */
+export declare function useSearchParams<T extends object>(defaultValue: T): [T, SearchParamAPI<T>];
+//# sourceMappingURL=useSearchParams.d.ts.map

package/dist/app/lib/routing/hooks/useSearchParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSearchParams.d.ts","sourceRoot":"","sources":["../../../../../src/app/lib/routing/hooks/useSearchParams.tsx"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI;IAC9B;;;;;;;;;OASG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAAA;IACpE;;;;;OAKG;IACH,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,CAAA;IACnC;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,KAAK,IAAI,CAAA;IAC3E;;OAEG;IACH,KAAK,IAAI,IAAI,CAAA;IACb;;OAEG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;CACrC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,CA2DzF"}

package/dist/app/lib/routing/hooks/useSearchParams.js

@@ -1,30 +1,90 @@
-import { useMemo } from "react";
-import { useRoute } from "./useRoute";
-import { useRouter } from "./useRouter";
+import { useMemo, useRef, useState } from "react";
+import { useRoute } from "./useRoute.js";
+import { useRouter } from "./useRouter.js";
+import { parseQuery } from "../utils.js";
+import { hash } from "object-code";
+/**
+ * Provides type-safe read/write access to query string parameters, integrating with the routing system.
+ *
+ * - Call `useSearchParams` with a default value object, which defines the expected shape of the query string parameters.
+ * - Only keys that are present in the default value object will be handled, and all others will be ignored.
+ * - Arrays of values are supported, and you should use a default value of `[]` for that key. You may want to cast the default parameter as an array of the expected type (eg. `myValue: [] as string[]`) to ensure that the parameter type is correct.
+ * - This hook returns a tuple with the current query string parameters object, and an API object with methods to interact with the query string. See {@link SearchParamAPI} for more details.
+ *
+ * For example:
+ * ```tsx
+ * const [params, api] = useSearchParams({
+ *  mode: "list" as "list" | "grid",
+ *  page: 1,
+ *  tags: [] as string[],
+ * })
+ *
+ * api.set("mode", "grid")
+ * api.set("tags", ["tag1", "tag2"])
+ * ```
+ *
+ * Note that if a parameter is set back to it's default value, it'll actually be _removed_ from the updated query string, keeping the URL clean when only the default values are set.
+ *
+ * ```tsx
+ * api.set("mode", "grid")
+ *   // url becomes: "/?mode=grid"
+ *   // params.mode === 'grid'
+ *
+ * api.set("mode", "list")
+ *   // url becomes: "/"
+ *   // params.mode === 'list'
+ * ```
+ *
+ * @param defaultValue - The default value object, defining the expected shape of the query string parameters.
+ * @returns A tuple of the resolve parameter object, and a {@link SearchParamAPI} object with methods to interact with the query string.
+ */
 export function useSearchParams(defaultValue) {
-    const route = useRoute();
-    const replaceQuery = useRouter((r) => r.replaceQuery);
-    const result = useMemo(() => ({
+    const [currentQuery, replaceQuery] = env.admin
+        ? useState({})
+        : [useRoute().query, useRouter((r) => r.replaceQuery)];
+    const merged = useMemo(() => ({
         ...defaultValue,
-        ...route.query,
-    }), [route.query]);
+        ...currentQuery,
+    }), [currentQuery]);
+    const values = useRef(merged);
+    values.current = merged;
+    // Memoized setters
+    const setters = useMemo(() => ({}), []);
+    // Gets the current value, directly from the source.
+    function get() {
+        if (env.client) {
+            return { ...defaultValue, ...parseQuery(document.location.search) };
+        }
+        else {
+            return merged;
+        }
+    }
+    // Main update function
     const update = (patch) => {
-        const value = { ...result, ...patch };
+        const value = { ...get(), ...patch };
         for (let key in defaultValue) {
-            if (defaultValue[key] === value[key] || [null, undefined].includes(value[key])) {
+            if (hash(defaultValue[key]) === hash(value[key]) || [null, undefined].includes(value[key])) {
                 delete value[key];
             }
         }
+        values.current = value;
         replaceQuery(value);
     };
     return [
-        result,
-        {
-            set: (key, value) => update({ ...result, [key]: value }),
-            setAll: (value) => update(value),
-            setter: (key) => (value) => update({ ...result, [key]: value }),
+        values.current,
+        useMemo(() => ({
+            set: (key, value) => update({ [key]: value }),
+            setAll: (value) => update({
+                ...defaultValue,
+                ...value,
+            }),
+            setter: (key) => {
+                if (!setters[key])
+                    setters[key] = (value) => update({ [key]: value });
+                return setters[key];
+            },
             reset: () => update({}),
-            get: (key) => result[key],
-        },
+            get: (key) => values.current[key],
+        }), []),
     ];
 }

package/dist/app/lib/routing/index.d.ts

@@ -1,13 +1,16 @@
-export * from "./types";
-export * from "./components/Link";
-export * from "./components/ScrollRestoration";
-export * from "./components/RouteRenderer";
-export * from "./components/ClientOnly";
-export * from "./hooks/useRoute";
-export * from "./hooks/useRouteTransition";
-export * from "./hooks/useRouter";
-export * from "./hooks/useRouterEvents";
-export * from "./hooks/useRouterState";
-export * from "./hooks/useRestorableState";
-export * from "./hooks/useIsSSR";
-export * from "./hooks/useSearchParams";
+export * from "./types.js";
+export * from "./components/Link.js";
+export * from "./components/ScrollRestoration.js";
+export * from "./components/RouteRenderer.js";
+export * from "./components/ClientOnly.js";
+export * from "./components/BackButton.js";
+export * from "./components/NativeLinkHandler.js";
+export * from "./hooks/useRoute.js";
+export * from "./hooks/useRouteTransition.js";
+export * from "./hooks/useRouter.js";
+export * from "./hooks/useRouterEvents.js";
+export * from "./hooks/useRouterState.js";
+export * from "./hooks/useRestorableState.js";
+export * from "./hooks/useIsSSR.js";
+export * from "./hooks/useSearchParams.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/app/lib/routing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/app/lib/routing/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAE1B,cAAc,sBAAsB,CAAA;AACpC,cAAc,mCAAmC,CAAA;AACjD,cAAc,+BAA+B,CAAA;AAC7C,cAAc,4BAA4B,CAAA;AAC1C,cAAc,4BAA4B,CAAA;AAC1C,cAAc,mCAAmC,CAAA;AAEjD,cAAc,qBAAqB,CAAA;AACnC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,sBAAsB,CAAA;AACpC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,2BAA2B,CAAA;AACzC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,qBAAqB,CAAA;AACnC,cAAc,4BAA4B,CAAA"}

package/dist/app/lib/routing/index.js

@@ -1,13 +1,15 @@
-export * from "./types";
-export * from "./components/Link";
-export * from "./components/ScrollRestoration";
-export * from "./components/RouteRenderer";
-export * from "./components/ClientOnly";
-export * from "./hooks/useRoute";
-export * from "./hooks/useRouteTransition";
-export * from "./hooks/useRouter";
-export * from "./hooks/useRouterEvents";
-export * from "./hooks/useRouterState";
-export * from "./hooks/useRestorableState";
-export * from "./hooks/useIsSSR";
-export * from "./hooks/useSearchParams";
+export * from "./types.js";
+export * from "./components/Link.js";
+export * from "./components/ScrollRestoration.js";
+export * from "./components/RouteRenderer.js";
+export * from "./components/ClientOnly.js";
+export * from "./components/BackButton.js";
+export * from "./components/NativeLinkHandler.js";
+export * from "./hooks/useRoute.js";
+export * from "./hooks/useRouteTransition.js";
+export * from "./hooks/useRouter.js";
+export * from "./hooks/useRouterEvents.js";
+export * from "./hooks/useRouterState.js";
+export * from "./hooks/useRestorableState.js";
+export * from "./hooks/useIsSSR.js";
+export * from "./hooks/useSearchParams.js";

package/dist/app/lib/routing/loader.d.ts

@@ -1,6 +1,6 @@
 import { FunctionComponent, PropsWithChildren } from "react";
-import { DynamicComponent } from "../dynamic/dynamic";
-import { RouteData } from "./types";
+import { DynamicComponent } from "../dynamic/dynamic.js";
+import { RouteData } from "./types.js";
 export type RouteCacheEntry = {
     data: RouteData;
     component: FunctionComponent;
@@ -28,3 +28,4 @@ export declare class RouteLoader {
     getRouteComponent<K extends keyof ViewProps>(view: K): DynamicComponent<FunctionComponent<ViewProps[K]>>;
     get appComponent(): DynamicComponent<FunctionComponent<PropsWithChildren<AppData>>>;
 }
+//# sourceMappingURL=loader.d.ts.map

package/dist/app/lib/routing/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../../src/app/lib/routing/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAA;AAE5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAGtC,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,SAAS,CAAA;IACf,SAAS,EAAE,iBAAiB,CAAA;CAC7B,CAAA;AAED,qBAAa,UAAW,SAAQ,KAAK;IAE1B,OAAO,EAAE,MAAM;IACf,UAAU,EAAE,MAAM;gBADlB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM;CAI5B;AAED,qBAAa,WAAW;IACtB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAY;IACpD,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAY;IAC1D,OAAO,EAAE,OAAO,CAAQ;IACxB,OAAO,CAAC,SAAS,CAAgD;IACjE,OAAO,CAAC,YAAY,CAA2C;IAE/D,EAAE,SAAgB;IAElB,YAAY,CAAC,IAAI,EAAE,OAAO,KAAK;IAI/B,oBAAoB,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM;IAI5D,OAAO,CAAC,MAAM;IAKd,OAAO,CAAC,WAAW;IAyBnB,YAAY,CAAC,QAAQ,EAAE,MAAM;IAKvB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,UAAQ,GAAG,OAAO,CAAC,SAAS,CAAC;IAiD9E,UAAU,CAAC,OAAO,EAAE,OAAO;IAI3B,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS;IAKnD,iBAAiB,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,IAAI,EAAE,CAAC,GACT,gBAAgB,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAG5F,IAAI,YAAY,IAC6B,gBAAgB,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,CAC3G;CACF"}

package/dist/app/lib/routing/loader.js

@@ -1,5 +1,5 @@
 import { parseURL, stringifyParsedURL, stringifyQuery, withTrailingSlash } from "ufo";
-import { viewManifestReader } from "../internal";
+import { viewManifestReader } from "../internal/read-view-manifest.js";
 export class RouteError extends Error {
     message;
     statusCode;
@@ -31,10 +31,12 @@ export class RouteLoader {
         const origin = parseURL(sampleUrl);
         let propsPath = withTrailingSlash(pathname);
         let query = {};
-        if (opts.serverless) {
-            query["_debug"] = opts.debug ? "1" : "0";
-            query["_props"] = opts.appData ? "all" : "1";
-            query["_ssr"] = "1";
+        if (env.serverless && env.client) {
+            propsPath = "/_data/route" + propsPath;
+            query = {};
+            // query["_debug"] = opts.debug ? "1" : "0"
+            // query["_props"] = opts.appData ? "all" : "1"
+            // query["_ssr"] = "1"
         }
         else {
             query["_debug"] = opts.debug ? "1" : "0";
@@ -54,6 +56,7 @@ export class RouteLoader {
         return this.entries.has(cacheKey);
     }
     async loadRouteData(pathname, withAppData = false) {
+        pathname = withTrailingSlash(pathname);
         const cacheKey = this.getKey(pathname);
         // Cached value?
         if (this.entries.has(cacheKey))
@@ -63,27 +66,35 @@ export class RouteLoader {
             serverless: env.serverless,
             debug: env.dev,
         });
-        const promise = this.fetchImpl(requestUrl, {})
-            .then((response) => response.text())
-            .then((text) => {
+        const promise = this.fetchImpl(requestUrl)
+            .then(async (response) => {
+            if (response.redirected) {
+                return { redirect: response.url };
+            }
+            let text = await response.text();
             if (this.processProps) {
                 text = this.processProps(text);
             }
             try {
-                return JSON.parse(text);
+                const payload = JSON.parse(text);
+                if (!payload.view && !payload.redirect) {
+                    throw new RouteError(`Invalid route data for '${pathname}'`, 500);
+                }
+                return payload;
             }
             catch (err) {
                 throw new RouteError(`JSON parse error for route '${pathname}':\n${err?.message}`, 500);
             }
         })
-            .then((data) => {
+            .then(async (data) => {
             if (data.redirect) {
-                const redirect = data.redirect;
-                data = this.loadRouteData(redirect).then((data) => {
-                    data.canonical = redirect;
-                    return data;
-                });
+                const redirect = parseURL(data.redirect).pathname;
+                data = await this.loadRouteData(redirect);
+                data.canonical = redirect;
             }
+            return data;
+        })
+            .then((data) => {
             this.entries.set(cacheKey, new Promise((resolve) => resolve(data)));
             return data;
         });

package/dist/app/lib/routing/types.d.ts

@@ -1,9 +1,16 @@
 import { FunctionComponent } from "react";
-import type { RouteLoader } from "./loader";
-import { LinkHandlerMode, PointerOrMouseEvent } from "./utils";
-export type ParsedRouteTags = Record<"title" | "meta" | "script" | "style" | "link", {
-    [key: string]: string;
-}[]>;
+import type { RouteLoader } from "./loader.js";
+import { LinkHandlerMode, PointerOrMouseEvent } from "./utils.js";
+export type RouteMetaTag = {
+    tagName: string;
+    attributes: Record<string, string>;
+    inner?: string;
+};
+export type TrackerTags = {
+    head?: string;
+    body?: string;
+    footer?: string;
+};
 export interface RouteData {
     view: string;
     editLink?: string;
@@ -13,10 +20,13 @@ export interface RouteData {
     redirect?: string;
     canonical?: string;
     meta?: {
-        head: ParsedRouteTags;
-        footer: ParsedRouteTags;
+        head: RouteMetaTag[];
+        footer: RouteMetaTag[];
     };
 }
+export interface RouteDataWithTrackers extends RouteData {
+    trackers?: TrackerTags;
+}
 export type RouteReturnState<T = {}> = {
     scrollTop: number;
     scrollLeft: number;
@@ -26,13 +36,12 @@ export type RouteLink = {
     query: Record<string, string | string[]>;
     hash: string;
 };
-export type RouterEvent = {
+export type RouterEvent = ({
     type: "clicked";
     link: RouteLink;
     currentRoute: RouteState;
-    href: string;
-    mode: LinkHandlerMode;
-} | {
+    cancel: () => void;
+} & LinkHandlerMode) | {
     type: "capture-restorable-state";
     state: RouteReturnState<Record<string, any>>;
 } | {
@@ -73,7 +82,12 @@ export type RouterEvent = {
     data: RouteData;
 } | {
     type: "error";
-    critical: false;
+    critical: boolean;
+    url?: string;
+    shouldReload?: boolean;
+    error: Error;
+} | {
+    type: "error:component-load-failed";
     error: Error;
 };
 export type RouterSubscriber = (event: RouterEvent) => void;
@@ -89,6 +103,7 @@ export type RouterAPIState = {
     blockers: Promise<void>[];
 };
 export type RouterAPI = {
+    hostname?: string;
     /** Preload a page and it's components */
     preload: (url: string) => Promise<void>;
     /** Prefetch the data for a page, but not it's components. */
@@ -99,14 +114,26 @@ export type RouterAPI = {
     replaceQuery: (search: Record<string, string | string[]>) => void;
     /** Replace the hash */
     replaceHash: (hash: string) => void;
-    /** Handle link clicking events */
-    handleClickEvent(e: PointerOrMouseEvent, href?: string): void;
+    /**
+     * Handle a click event, potentially triggering a route change.
+     *
+     * @param e A pointer or mouse event.
+     * @param href An optional URL. This must be provided if no `href` property exists on the clicked element
+     * @param preferBack If set, clicking this link will send the user 'back', when clicking a link to the previous history item.
+     */
+    handleClickEvent(e: PointerOrMouseEvent, href?: string, preferBack?: boolean | "exact"): void;
     /** A reference to the route loader (mostly for internal use) */
     loader: RouteLoader;
     /** Subscribe to events */
     subscribe: (subscribe: RouterSubscriber) => () => void;
     /** This function is used by the routing system automatically */
     emitEvent: (event: RouterEvent) => void;
+    /** Returns the current RouterAPIState */
+    getState: () => RouterAPIState | null;
+    /** Go back to a previous route in the history stack, or push it onto the stack if it isn't currently on the stack. */
+    restoreRoute: (route: RouteState) => void;
+    /** Indicates that this page render is for consumption by an LLM */
+    isAI?: boolean;
 };
 export type TypedRouteState<T, TProps> = {
     /** A unique ID, representing this history item. */
@@ -131,8 +158,29 @@ export type TypedRouteState<T, TProps> = {
     component: FunctionComponent<TProps>;
     /** The props for this route, to be passed to the component. */
     props: TProps;
+    /** Loaded metadata for this route */
+    meta: RouteMeta;
+};
+export type RouteMeta = {
+    title?: string;
+    tags?: RouteMetaTag[];
+    editLink?: string;
 };
 export type RouteState = {
     [K in keyof ViewProps]: TypedRouteState<K, ViewProps[K]>;
 }[keyof ViewProps];
 export type AnyRouteState = TypedRouteState<string, any>;
+export type ErrorRouteProps = {
+    /** The HTTP status code for this error */
+    statusCode: number;
+    /** The title of the message (eg. Not Found) */
+    title?: string;
+    /** A message which can be shown to the user, specific to this error */
+    userMessage?: string;
+    /** Detailed error information, which can be displayed to developers or passed to monitoring services */
+    report?: {
+        message: string;
+        details: any;
+    };
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/app/lib/routing/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/app/lib/routing/types.ts"],"names":[],"mappings":"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"}

package/dist/app/lib/routing/utils.d.ts

@@ -1,15 +1,20 @@
 import { MouseEvent as ReactMouseEvent, PointerEvent as ReactPointerEvent } from "react";
-import { RouteLink, RouteState } from "./types";
+import { RouteData, RouteLink, RouteMeta, RouteState } from "./types.js";
 export declare function isSameOrigin(url: string): boolean;
+export declare function isSamePathname(a: string, b: string): boolean;
 export type PointerOrMouseEvent = MouseEvent | PointerEvent | ReactMouseEvent | ReactPointerEvent;
 export type LinkHandlerMode = {
     mode: "ignore" | "navigate" | "native";
     href?: string;
+    isSameUrl?: boolean;
 };
-export declare function getLinkHandlerMode(e?: PointerOrMouseEvent, href?: string): LinkHandlerMode;
+export declare function getLinkHandlerMode(e?: PointerOrMouseEvent, href?: string, currentRoute?: RouteState): LinkHandlerMode;
 type Partialize<T, TKeys extends keyof T> = Partial<Pick<T, TKeys>> & Omit<T, TKeys>;
 export declare function normalizeRoute(route: Partialize<RouteState, "uri" | "returnState" | "key">): RouteState;
 export declare function stringifyRouteLink(route: RouteLink): string;
 export declare function parseQuery(query: string): Record<string, string | string[]>;
 export declare function stringifyQuery(query: any): string;
+export declare function getRouteMeta(data: RouteData): RouteMeta;
+export declare function addTrailingSlash(path?: string | null): string;
 export {};
+//# sourceMappingURL=utils.d.ts.map

package/dist/app/lib/routing/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/app/lib/routing/utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,IAAI,eAAe,EAAE,YAAY,IAAI,iBAAiB,EAAE,MAAM,OAAO,CAAA;AAExF,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAExE,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,WAQvC;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,WAIlD;AAED,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,YAAY,GAAG,eAAe,GAAG,iBAAiB,CAAA;AAEjG,MAAM,MAAM,eAAe,GAAG;IAAE,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,CAAA;AAE5G,wBAAgB,kBAAkB,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,UAAU,GAAG,eAAe,CAmErH;AAED,KAAK,UAAU,CAAC,CAAC,EAAE,KAAK,SAAS,MAAM,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA;AAEpF,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,CAAC,UAAU,EAAE,KAAK,GAAG,aAAa,GAAG,KAAK,CAAC,GAAG,UAAU,CAavG;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,UAMlD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAI3E;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,GAAG,UAOxC;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAMvD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,UAKpD"}

package/dist/app/lib/routing/utils.js

@@ -1,5 +1,5 @@
-import { parseURL, resolveURL, stringifyParsedURL, withoutTrailingSlash } from "ufo";
-import { stringify as qsStringify, parse as qsParse } from "qs";
+import { parse as qsParse, stringify as qsStringify } from "qs";
+import { parseURL, resolveURL, stringifyParsedURL, withoutTrailingSlash, withTrailingSlash } from "ufo";
 export function isSameOrigin(url) {
     if (typeof document === "undefined") {
         return url.startsWith("/");
@@ -10,7 +10,12 @@ export function isSameOrigin(url) {
         return parsed.protocol === document.location.protocol && parsed.host === document.location.host;
     }
 }
-export function getLinkHandlerMode(e, href) {
+export function isSamePathname(a, b) {
+    const left = parseURL(a).pathname.replace(/\/$/, "").toLocaleLowerCase();
+    const right = parseURL(b).pathname.replace(/\/$/, "").toLocaleLowerCase();
+    return left === right;
+}
+export function getLinkHandlerMode(e, href, currentRoute) {
     try {
         // Attempt to get the link element, if there is one
         let eventTarget = null;
@@ -30,8 +35,15 @@ export function getLinkHandlerMode(e, href) {
             href = eventTarget.href;
         if (!href)
             return { mode: "native", href };
+        if (href.match(/^(mailto|tel|callto|sms|maps):/)) {
+            return { mode: "native", href };
+        }
         // Resolve the URL and check if it's the same origin
-        const resolved = href.startsWith("http") ? href : resolveURL(document.location.href, href);
+        const resolved = href.startsWith("http")
+            ? href
+            : href.startsWith("/")
+                ? resolveURL(document.location.origin, href)
+                : resolveURL(document.location.href, href);
         const parsed = parseURL(resolved);
         const isSameOrigin = parsed.host?.replace(/:.+/, "") === document.location.host.replace(/:.+/, "");
         // External links should be handled natively
@@ -52,6 +64,17 @@ export function getLinkHandlerMode(e, href) {
         // Starts with /wp-, use native (wp-content, wp-admin etc)
         if (parsed.pathname.startsWith("/wp-"))
             return { mode: "native", href };
+        // If pathname+query are identical, but the hash is different, then allow the browser to handle it
+        if (currentRoute &&
+            isSamePathname(currentRoute.pathname, parsed.pathname) &&
+            currentRoute.search === parsed.search) {
+            if (currentRoute.hash !== parsed.hash) {
+                return { mode: "native", href };
+            }
+            else {
+                return { mode: "ignore", href, isSameUrl: true };
+            }
+        }
         return { mode: "navigate", href };
     }
     catch (err) {
@@ -76,6 +99,7 @@ export function normalizeRoute(route) {
 export function stringifyRouteLink(route) {
     return stringifyParsedURL({
         ...route,
+        pathname: withTrailingSlash(route.pathname),
         search: stringifyQuery(route.query),
     });
 }
@@ -92,3 +116,16 @@ export function stringifyQuery(query) {
         arrayFormat: "brackets",
     });
 }
+export function getRouteMeta(data) {
+    return {
+        title: data.meta?.head.find((tag) => tag.tagName === "title")?.inner,
+        tags: data.meta?.head ?? [],
+        editLink: data.editLink,
+    };
+}
+export function addTrailingSlash(path) {
+    if (path?.match(/\./)) {
+        return path;
+    }
+    return withTrailingSlash(path ?? undefined, true);
+}

package/dist/app/lib/{hooks → runtime}/apiConfig.d.ts

@@ -1,3 +1,6 @@
+/**
+ * Configuration options for manipulating how the client interacts with the GraphQL API
+ */
 export type APIConfigStore = {
     /**
      * Any value, which will be used as part of the cache key for each query.
@@ -11,8 +14,14 @@ export type APIConfigStore = {
      */
     customQueryFetchOptions?: (type: "query" | "mutation", queryName: string, queryArgs: any, url: string, opts: RequestInit) => RequestInit | Promise<RequestInit>;
     /**
-     * Update aspects of the API client
+     * Allows you to hook into the response of a query or mutation.
      */
+    onResponse?: (response: Response, type: "query" | "mutation", queryName: string, queryArgs: any, url: string, opts: RequestInit) => void;
     set: (config: Partial<APIConfigStore>) => void;
+    /**
+     * WordPress API key, for use on the server only
+     **/
+    apiKey?: string;
 };
-export declare const useAPIConfig: import("zustand").UseBoundStore<import("zustand").StoreApi<APIConfigStore>>;
+export declare const apiConfig: APIConfigStore;
+//# sourceMappingURL=apiConfig.d.ts.map

package/dist/app/lib/runtime/apiConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiConfig.d.ts","sourceRoot":"","sources":["../../../../src/app/lib/runtime/apiConfig.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B;;;;QAII;IACJ,cAAc,CAAC,EAAE,GAAG,CAAA;IACpB;;;OAGG;IACH,uBAAuB,CAAC,EAAE,CACxB,IAAI,EAAE,OAAO,GAAG,UAAU,EAC1B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,GAAG,EACd,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,KACd,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;IACvC;;OAEG;IACH,UAAU,CAAC,EAAE,CACX,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,OAAO,GAAG,UAAU,EAC1B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,GAAG,EACd,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,KACd,IAAI,CAAA;IACT,GAAG,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,KAAK,IAAI,CAAA;IAE9C;;QAEI;IACJ,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,eAAO,MAAM,SAAS,gBAIpB,CAAA"}