@tyndall/react 0.0.1

package/dist/registry.d.ts

@@ -0,0 +1,4 @@
+import type { UIAdapterFactory, UIAdapterRegistry } from "@tyndall/core";
+export declare const createReactUiAdapterFactory: () => UIAdapterFactory;
+export declare const createReactAdapterRegistry: () => UIAdapterRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAWzF,eAAO,MAAM,2BAA2B,QAAO,gBAiB9C,CAAC;AAEF,eAAO,MAAM,0BAA0B,QAAO,iBAE5C,CAAC"}

package/dist/registry.js

@@ -0,0 +1,18 @@
+import { createReactAdapter } from "./adapter.js";
+const isFunction = (value) => typeof value === "function";
+export const createReactUiAdapterFactory = () => (options) => {
+    const normalized = options;
+    const routeRender = isFunction(normalized.routeRender)
+        ? normalized.routeRender
+        : undefined;
+    const routeHead = isFunction(normalized.routeHead)
+        ? normalized.routeHead
+        : undefined;
+    return createReactAdapter({
+        render: routeRender ? ({ props }) => routeRender(props) : undefined,
+        getHead: routeHead ? ({ props }) => routeHead(props) : undefined,
+    });
+};
+export const createReactAdapterRegistry = () => ({
+    react: createReactUiAdapterFactory(),
+});

package/dist/router.d.ts

@@ -0,0 +1,82 @@
+import { type HeadDescriptor, type ResolverFallbackPolicy, type RouteGraph } from "@tyndall/core";
+export type RouterQuery = Record<string, string | string[]>;
+export type RenderPolicy = "csr" | "ssr" | "auto" | "redirect";
+export type HydrationMode = "full" | "islands";
+export type NavigationMode = "url" | "client";
+export type ClientRenderMode = "payload" | "module";
+export interface DynamicManifestPolicy {
+    render?: RenderPolicy;
+    redirect?: string;
+}
+export interface DynamicManifestEnvelope {
+    policy?: DynamicManifestPolicy;
+    meta?: unknown;
+    definition?: unknown;
+}
+export type DynamicManifestResolver = (path: string) => Promise<DynamicManifestEnvelope | null>;
+export type DynamicManifestRenderer = (meta: unknown, envelope: DynamicManifestEnvelope) => void | Promise<void>;
+export interface RoutePayload {
+    kind: "hyper-route-payload";
+    routeId: string;
+    appHtml: string;
+    propsPayload: string;
+    head?: HeadDescriptor;
+    hydration?: HydrationMode;
+}
+export interface ClientRouteModuleContext {
+    href: string;
+    pathname: string;
+    routeId: string;
+    params: Record<string, string | string[]>;
+    query: RouterQuery;
+}
+export interface ClientRouteRenderResult {
+    routeId?: string;
+    appHtml: string;
+    propsPayload?: string;
+    head?: HeadDescriptor;
+    hydration?: HydrationMode;
+}
+export interface ClientRouteModule {
+    render: (ctx: ClientRouteModuleContext) => Promise<ClientRouteRenderResult> | ClientRouteRenderResult;
+}
+export interface ClientRouteModuleResolverContext {
+    href: string;
+    pathname: string;
+    routeId: string;
+    params: Record<string, string | string[]>;
+    query: RouterQuery;
+}
+export type ClientRouteModuleResolver = (ctx: ClientRouteModuleResolverContext) => Promise<ClientRouteModule | null>;
+export type ClientRouteModuleLoader = () => Promise<unknown>;
+export type ClientRouteModuleLoaderMap = Record<string, ClientRouteModuleLoader>;
+export type RoutePayloadResolver = (href: string) => Promise<RoutePayload | null>;
+export type RoutePayloadApplier = (payload: RoutePayload) => void | Promise<void>;
+export interface RouterOptions {
+    routeGraph?: RouteGraph;
+    resolveDynamicManifest?: DynamicManifestResolver;
+    renderDynamic?: DynamicManifestRenderer;
+    resolveRoutePayload?: RoutePayloadResolver;
+    applyRoutePayload?: RoutePayloadApplier;
+    navigationMode?: NavigationMode;
+    clientRenderMode?: ClientRenderMode;
+    resolveClientRouteModule?: ClientRouteModuleResolver;
+    fallbackToUrl?: boolean;
+    buildMode?: "ssg" | "ssr";
+    onWarning?: (message: string) => void;
+    fallbackPolicy?: ResolverFallbackPolicy;
+}
+export interface Router {
+    pathname: string;
+    query: RouterQuery;
+    push: (href: string) => Promise<void>;
+    replace: (href: string) => Promise<void>;
+    prefetch: (href: string) => Promise<void>;
+    subscribe: (listener: (router: Router) => void) => () => void;
+}
+export declare const createClientRouteModuleResolver: (loaders: ClientRouteModuleLoaderMap) => ClientRouteModuleResolver;
+export declare const createRouter: (initialHref?: string | RouterOptions, options?: RouterOptions) => Router;
+export declare const getRouter: () => Router;
+export declare const setRouter: (router: Router) => void;
+export declare const useRouter: () => Router;
+//# sourceMappingURL=router.d.ts.map

package/dist/router.d.ts.map

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

package/dist/router.js

@@ -0,0 +1,470 @@
+import { evaluateRenderPolicy, shouldForceDynamicFallback, } from "@tyndall/core";
+import { applyHead } from "./head-manager.js";
+import { createReactRouterRouteMatcher } from "./react-router-bridge.js";
+const NAVIGATION_HEADER = "x-hyper-navigation";
+const NAVIGATION_MODE = "csr";
+const ROUTE_PAYLOAD_EVENT = "hyper:route-payload-applied";
+const inflightPrefetchRequests = new Map();
+const hasBrowserHistory = () => typeof globalThis !== "undefined" &&
+    "history" in globalThis &&
+    Boolean(globalThis.history);
+const getBaseUrl = () => {
+    if (typeof globalThis !== "undefined" && "location" in globalThis) {
+        const location = globalThis.location;
+        if (location?.origin) {
+            return location.origin;
+        }
+    }
+    return "http://localhost";
+};
+const requestPrefetch = async (href) => {
+    if (typeof globalThis === "undefined" || typeof fetch === "undefined") {
+        return;
+    }
+    const targetUrl = new URL(href, getBaseUrl());
+    const targetPath = `${targetUrl.pathname}${targetUrl.search}`;
+    const inflightRequest = inflightPrefetchRequests.get(targetPath);
+    if (inflightRequest) {
+        // Hover/focus prefetch can dispatch repeatedly for the same href; share one request.
+        await inflightRequest;
+        return;
+    }
+    const url = new URL("/__hyper/prefetch", getBaseUrl());
+    url.searchParams.set("path", targetPath);
+    const prefetchRequest = (async () => {
+        try {
+            await fetch(url.toString(), { method: "POST" });
+        }
+        catch {
+            // Prefetch is best-effort; ignore network errors.
+        }
+    })();
+    const trackedPrefetchRequest = prefetchRequest.finally(() => {
+        if (inflightPrefetchRequests.get(targetPath) === trackedPrefetchRequest) {
+            inflightPrefetchRequests.delete(targetPath);
+        }
+    });
+    inflightPrefetchRequests.set(targetPath, trackedPrefetchRequest);
+    await trackedPrefetchRequest;
+};
+const parseHref = (href, baseUrl) => {
+    const url = new URL(href, baseUrl);
+    const query = {};
+    url.searchParams.forEach((value, key) => {
+        const current = query[key];
+        if (current === undefined) {
+            query[key] = value;
+            return;
+        }
+        if (Array.isArray(current)) {
+            current.push(value);
+            return;
+        }
+        query[key] = [current, value];
+    });
+    return { pathname: url.pathname, query };
+};
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const isClientRouteRenderResult = (value) => {
+    if (!isRecord(value) || typeof value.appHtml !== "string") {
+        return false;
+    }
+    if (value.routeId !== undefined && typeof value.routeId !== "string") {
+        return false;
+    }
+    if (value.propsPayload !== undefined && typeof value.propsPayload !== "string") {
+        return false;
+    }
+    if (value.hydration !== undefined &&
+        value.hydration !== "full" &&
+        value.hydration !== "islands") {
+        return false;
+    }
+    return true;
+};
+const isRoutePayload = (value) => {
+    if (!value || typeof value !== "object") {
+        return false;
+    }
+    const payload = value;
+    if (payload.kind !== "hyper-route-payload" ||
+        typeof payload.routeId !== "string" ||
+        typeof payload.appHtml !== "string" ||
+        typeof payload.propsPayload !== "string") {
+        return false;
+    }
+    if (payload.hydration !== undefined &&
+        payload.hydration !== "full" &&
+        payload.hydration !== "islands") {
+        return false;
+    }
+    return true;
+};
+const resolveRoutePayloadFromServer = async (href, baseUrl) => {
+    if (typeof fetch === "undefined") {
+        return null;
+    }
+    const url = new URL(href, baseUrl);
+    try {
+        const response = await fetch(url.toString(), {
+            method: "GET",
+            headers: {
+                [NAVIGATION_HEADER]: NAVIGATION_MODE,
+                accept: "application/json",
+            },
+        });
+        if (!response.ok) {
+            return null;
+        }
+        const contentType = response.headers.get("content-type") ?? "";
+        if (!contentType.includes("application/json")) {
+            return null;
+        }
+        const json = (await response.json());
+        return isRoutePayload(json) ? json : null;
+    }
+    catch {
+        return null;
+    }
+};
+const applyRoutePayloadToDom = (payload) => {
+    if (typeof document === "undefined") {
+        return;
+    }
+    const app = document.getElementById("app");
+    const hasMountedClientApp = payload.hydration !== "islands" &&
+        Boolean(globalThis.__HYPER_CLIENT_APP_MOUNTED__);
+    if (app) {
+        if (!hasMountedClientApp) {
+            app.innerHTML = payload.appHtml;
+        }
+        app.setAttribute("data-hyper-route", payload.routeId);
+        app.setAttribute("data-hyper-hydrated", "false");
+        if (payload.hydration) {
+            app.setAttribute("data-hyper-hydration", payload.hydration);
+            if (payload.hydration === "islands") {
+                app.setAttribute("data-hyper-island-root", "router");
+            }
+            else {
+                app.removeAttribute("data-hyper-island-root");
+            }
+        }
+    }
+    const propsScript = document.getElementById("__HYPER_PROPS__");
+    if (propsScript) {
+        propsScript.textContent = payload.propsPayload;
+    }
+    if (payload.head) {
+        applyHead(payload.head);
+    }
+    globalThis.__HYPER_ROUTE_ID__ = payload.routeId;
+    globalThis.__HYPER_HYDRATED__ = false;
+    try {
+        globalThis.dispatchEvent?.(new CustomEvent(ROUTE_PAYLOAD_EVENT, {
+            detail: { routeId: payload.routeId },
+        }));
+    }
+    catch {
+        // Keep client navigation flow resilient if event dispatch is unavailable.
+    }
+};
+const toRoutePayload = (rendered) => ({
+    kind: "hyper-route-payload",
+    routeId: rendered.routeId,
+    appHtml: rendered.appHtml,
+    propsPayload: rendered.propsPayload ?? "{}",
+    head: rendered.head,
+    hydration: rendered.hydration,
+});
+const isMetaDefinition = (value) => {
+    if (!value || typeof value !== "object") {
+        return false;
+    }
+    const record = value;
+    return record.kind === "meta" && "root" in record;
+};
+const normalizeLoadedClientRouteModule = (value) => {
+    if (isRecord(value) && typeof value.render === "function") {
+        return {
+            render: value.render,
+        };
+    }
+    if (typeof value === "function") {
+        return {
+            render: value,
+        };
+    }
+    if (isRecord(value) && typeof value.default === "function") {
+        return {
+            render: value.default,
+        };
+    }
+    return null;
+};
+export const createClientRouteModuleResolver = (loaders) => {
+    const map = { ...loaders };
+    return async (ctx) => {
+        const load = map[ctx.routeId];
+        if (!load) {
+            return null;
+        }
+        try {
+            const loaded = await load();
+            return normalizeLoadedClientRouteModule(loaded);
+        }
+        catch {
+            return null;
+        }
+    };
+};
+const resolveRouterOptions = (initial, options) => {
+    if (initial && typeof initial === "object") {
+        return { initialHref: undefined, options: initial };
+    }
+    return { initialHref: initial, options: options ?? {} };
+};
+export const createRouter = (initialHref, options) => {
+    const resolved = resolveRouterOptions(initialHref, options);
+    const routerOptions = resolved.options;
+    const routeMatcher = routerOptions.routeGraph
+        ? createReactRouterRouteMatcher(routerOptions.routeGraph)
+        : null;
+    const baseUrl = getBaseUrl();
+    const navigationMode = routerOptions.navigationMode ?? "client";
+    const clientRenderMode = routerOptions.clientRenderMode ?? "payload";
+    const fallbackToUrl = routerOptions.fallbackToUrl ?? true;
+    const hasCustomRoutePayloadResolver = typeof routerOptions.resolveRoutePayload === "function";
+    const resolveRoutePayload = routerOptions.resolveRoutePayload ??
+        ((href) => resolveRoutePayloadFromServer(href, baseUrl));
+    const applyRoutePayload = routerOptions.applyRoutePayload ?? applyRoutePayloadToDom;
+    const listeners = new Set();
+    const router = {
+        pathname: "/",
+        query: {},
+        push: async (href) => {
+            await resolveAndNavigate(href, false);
+        },
+        replace: async (href) => {
+            await resolveAndNavigate(href, true);
+        },
+        prefetch: async (href) => {
+            await requestPrefetch(href);
+            const next = parseHref(href, baseUrl);
+            const forceDynamic = shouldForceDynamicFallback(next.pathname, routerOptions.fallbackPolicy);
+            if (routerOptions.resolveDynamicManifest &&
+                (forceDynamic || !routeMatcher || !matchRouteGraph(next.pathname))) {
+                await routerOptions.resolveDynamicManifest(next.pathname);
+                return;
+            }
+            if (navigationMode === "client" && clientRenderMode === "module") {
+                await resolveClientRouteRender(href);
+                return;
+            }
+            if (navigationMode === "client" && hasCustomRoutePayloadResolver) {
+                // Avoid duplicate network fetches when the dev prefetch endpoint already warms payload cache.
+                await resolveRoutePayload(href);
+            }
+        },
+        subscribe: (listener) => {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+    };
+    const updateState = (href) => {
+        const next = parseHref(href, baseUrl);
+        router.pathname = next.pathname;
+        router.query = next.query;
+        for (const listener of listeners) {
+            listener(router);
+        }
+    };
+    const matchRouteGraph = (pathname) => routeMatcher?.match(pathname) ?? null;
+    const navigate = async (href, replace) => {
+        // Important: only touch browser history when it exists (SSR-safe).
+        if (hasBrowserHistory()) {
+            const history = globalThis.history;
+            const method = replace ? "replaceState" : "pushState";
+            history[method](null, "", href);
+        }
+        updateState(href);
+    };
+    const navigateWithUrl = async (href, replace) => {
+        const location = globalThis.location;
+        if (location) {
+            if (replace && typeof location.replace === "function") {
+                location.replace(href);
+                return;
+            }
+            if (!replace && typeof location.assign === "function") {
+                location.assign(href);
+                return;
+            }
+            location.href = href;
+            return;
+        }
+        await navigate(href, replace);
+    };
+    const navigateWithPayload = async (href, replace) => {
+        const payload = await resolveRoutePayload(href);
+        if (payload) {
+            await applyRoutePayload(payload);
+            await navigate(href, replace);
+            return true;
+        }
+        if (fallbackToUrl) {
+            await navigateWithUrl(href, replace);
+            return false;
+        }
+        await navigate(href, replace);
+        return false;
+    };
+    const resolveClientRouteRender = async (href) => {
+        if (!routerOptions.resolveClientRouteModule || !routeMatcher) {
+            return null;
+        }
+        const next = parseHref(href, baseUrl);
+        const match = matchRouteGraph(next.pathname);
+        if (!match) {
+            return null;
+        }
+        const module = await routerOptions.resolveClientRouteModule({
+            href,
+            pathname: next.pathname,
+            routeId: match.route.id,
+            params: match.params,
+            query: next.query,
+        });
+        if (!module) {
+            return null;
+        }
+        try {
+            const rendered = await module.render({
+                href,
+                pathname: next.pathname,
+                routeId: match.route.id,
+                params: match.params,
+                query: next.query,
+            });
+            if (!isClientRouteRenderResult(rendered)) {
+                return null;
+            }
+            return {
+                ...rendered,
+                routeId: rendered.routeId ?? match.route.id,
+            };
+        }
+        catch {
+            return null;
+        }
+    };
+    const navigateWithClientModule = async (href, replace) => {
+        const rendered = await resolveClientRouteRender(href);
+        if (!rendered) {
+            return false;
+        }
+        await applyRoutePayload(toRoutePayload(rendered));
+        await navigate(href, replace);
+        return true;
+    };
+    const navigateWithClientRender = async (href, replace) => {
+        if (clientRenderMode === "module") {
+            const moduleApplied = await navigateWithClientModule(href, replace);
+            if (moduleApplied) {
+                return;
+            }
+        }
+        await navigateWithPayload(href, replace);
+    };
+    const navigateByMode = async (href, replace) => {
+        if (navigationMode === "url") {
+            await navigateWithUrl(href, replace);
+            return;
+        }
+        await navigateWithClientRender(href, replace);
+    };
+    const resolveDynamicFallback = async (href, replace) => {
+        const next = parseHref(href, baseUrl);
+        const forceDynamic = shouldForceDynamicFallback(next.pathname, routerOptions.fallbackPolicy);
+        if (routeMatcher && !forceDynamic && matchRouteGraph(next.pathname)) {
+            await navigateByMode(href, replace);
+            return;
+        }
+        if (routerOptions.resolveDynamicManifest) {
+            const envelope = await routerOptions.resolveDynamicManifest(next.pathname);
+            if (envelope) {
+                const policy = envelope.policy?.render ?? "auto";
+                if (policy === "redirect" && envelope.policy?.redirect) {
+                    await navigateByMode(envelope.policy.redirect, replace);
+                    return;
+                }
+                let policyRender;
+                if (policy === "redirect") {
+                    // Missing redirect target: fallback to auto to avoid breaking navigation.
+                    const message = "Redirect policy missing target; falling back to auto.";
+                    if (routerOptions.onWarning) {
+                        routerOptions.onWarning(message);
+                    }
+                    else if (typeof console !== "undefined" && console.warn) {
+                        console.warn(message);
+                    }
+                    policyRender = "auto";
+                }
+                else {
+                    policyRender = policy;
+                }
+                const decision = evaluateRenderPolicy(routerOptions.buildMode ?? "ssg", policyRender);
+                for (const warning of decision.warnings) {
+                    if (routerOptions.onWarning) {
+                        routerOptions.onWarning(warning);
+                    }
+                    else if (typeof console !== "undefined" && console.warn) {
+                        console.warn(warning);
+                    }
+                }
+                if (decision.mode === "ssr") {
+                    await navigateWithUrl(href, replace);
+                    return;
+                }
+                const meta = envelope.meta ??
+                    (isMetaDefinition(envelope.definition) ? envelope.definition.root : undefined);
+                if (decision.mode === "csr" && meta !== undefined) {
+                    await routerOptions.renderDynamic?.(meta, envelope);
+                    await navigateByMode(href, replace);
+                    return;
+                }
+            }
+        }
+        await navigateByMode(href, replace);
+    };
+    const resolveAndNavigate = async (href, replace) => {
+        await resolveDynamicFallback(href, replace);
+    };
+    const seed = resolved.initialHref ??
+        (typeof globalThis !== "undefined" && "location" in globalThis
+            ? globalThis.location.href
+            : "/");
+    updateState(seed);
+    if (hasBrowserHistory() && typeof globalThis.addEventListener === "function") {
+        // Keep router state in sync with back/forward navigation.
+        globalThis.addEventListener("popstate", () => {
+            const location = globalThis.location;
+            if (location?.href) {
+                updateState(location.href);
+            }
+        });
+    }
+    return router;
+};
+let activeRouter = null;
+export const getRouter = () => {
+    if (!activeRouter) {
+        activeRouter = createRouter();
+    }
+    return activeRouter;
+};
+export const setRouter = (router) => {
+    activeRouter = router;
+};
+export const useRouter = () => getRouter();

package/dist/types.d.ts

@@ -0,0 +1,17 @@
+import type { GetServerProps as HyperGetServerProps, GetStaticPaths as HyperGetStaticPaths, GetStaticProps as HyperGetStaticProps, PageContextBase, PageComponent, StaticPropsContext, StaticPropsResult, StaticPathsResult, ServerPropsContext, ServerPropsResult } from "@tyndall/core";
+export type NextPageContext = PageContextBase;
+export type NextPage<Props = Record<string, unknown>> = PageComponent<Props>;
+export type NextStaticPropsContext = StaticPropsContext;
+export type NextStaticPropsResult<Props = Record<string, unknown>> = StaticPropsResult<Props>;
+export type NextStaticPathsResult = StaticPathsResult;
+export type NextServerPropsContext = ServerPropsContext;
+export type NextServerPropsResult<Props = Record<string, unknown>> = ServerPropsResult<Props>;
+export type GetStaticPropsContext = StaticPropsContext;
+export type GetStaticPropsResult<Props = Record<string, unknown>> = StaticPropsResult<Props>;
+export type GetStaticPathsResult = StaticPathsResult;
+export type GetStaticProps<Props = Record<string, unknown>> = HyperGetStaticProps<Props>;
+export type GetStaticPaths = HyperGetStaticPaths;
+export type GetServerSidePropsContext = ServerPropsContext;
+export type GetServerSidePropsResult<Props = Record<string, unknown>> = ServerPropsResult<Props>;
+export type GetServerSideProps<Props = Record<string, unknown>> = HyperGetServerProps<Props>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,IAAI,mBAAmB,EACrC,cAAc,IAAI,mBAAmB,EACrC,cAAc,IAAI,mBAAmB,EACrC,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,eAAe,CAAC;AAEvB,MAAM,MAAM,eAAe,GAAG,eAAe,CAAC;AAC9C,MAAM,MAAM,QAAQ,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,aAAa,CAAC,KAAK,CAAC,CAAC;AAC7E,MAAM,MAAM,sBAAsB,GAAG,kBAAkB,CAAC;AACxD,MAAM,MAAM,qBAAqB,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,iBAAiB,CAAC,KAAK,CAAC,CAAC;AAC9F,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,CAAC;AACtD,MAAM,MAAM,sBAAsB,GAAG,kBAAkB,CAAC;AACxD,MAAM,MAAM,qBAAqB,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,iBAAiB,CAAC,KAAK,CAAC,CAAC;AAE9F,MAAM,MAAM,qBAAqB,GAAG,kBAAkB,CAAC;AACvD,MAAM,MAAM,oBAAoB,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,iBAAiB,CAAC,KAAK,CAAC,CAAC;AAC7F,MAAM,MAAM,oBAAoB,GAAG,iBAAiB,CAAC;AACrD,MAAM,MAAM,cAAc,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,mBAAmB,CAAC,KAAK,CAAC,CAAC;AACzF,MAAM,MAAM,cAAc,GAAG,mBAAmB,CAAC;AAEjD,MAAM,MAAM,yBAAyB,GAAG,kBAAkB,CAAC;AAC3D,MAAM,MAAM,wBAAwB,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,iBAAiB,CAAC,KAAK,CAAC,CAAC;AACjG,MAAM,MAAM,kBAAkB,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,mBAAmB,CAAC,KAAK,CAAC,CAAC"}

package/dist/types.js

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

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@tyndall/react",
+  "version": "0.0.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "bun": "./src/index.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json"
+  },
+  "dependencies": {
+    "@tyndall/core": "workspace:*",
+    "@tyndall/shared": "workspace:*",
+    "react-router": "^7.13.0"
+  },
+  "peerDependencies": {
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0"
+  }
+}