extrojs 0.2.0 → 0.3.0

package/dist/router/context.d.ts

@@ -0,0 +1,13 @@
+export interface Router {
+    push: (to: string) => void;
+    replace: (to: string) => void;
+    back: () => void;
+    forward: () => void;
+}
+export interface RouterContextValue {
+    pathname: string;
+    search: string;
+    params: Record<string, string>;
+    router: Router;
+}
+export declare const RouterContext: import("react").Context<RouterContextValue | null>;

package/dist/router/context.js

@@ -0,0 +1,2 @@
+import { createContext } from "react";
+export const RouterContext = createContext(null);

package/dist/router/create-router.d.ts

@@ -0,0 +1,10 @@
+import type { CreateRouterOptions, Route, RouterSurfaceOptions } from "./types.js";
+/**
+ * @describe Mounts a surface (popup | options | sidepanel) and wires hash-based
+ * client-side routing into the given routes array. Called once per surface by
+ * the virtual runtime module emitted by @extrojs/vite-plugin.
+ */
+export interface ExtroRouterHandle {
+    update: (newRoutes: Route[], opts?: RouterSurfaceOptions) => void;
+}
+export declare const createExtroRouter: (routes: Route[], options?: CreateRouterOptions) => ExtroRouterHandle;

package/dist/router/create-router.js

@@ -0,0 +1,126 @@
+import { createRoot } from "react-dom/client";
+import { matchRoutes } from "./match.js";
+import { DefaultNotFound } from "./defaults.js";
+import { buildTree } from "./build-tree.js";
+const toError = (err) => err instanceof Error ? err : new Error(String(err));
+export const createExtroRouter = (routes, options = {}) => {
+    const { rootId = "root" } = options;
+    const el = document.getElementById(rootId);
+    if (!el) {
+        throw new Error(`Extro: #${rootId} element not found`);
+    }
+    const root = createRoot(el);
+    const router = createRouter();
+    let currentRoutes = routes;
+    let notFound = options.notFound ?? null;
+    let rootLayout = options.rootLayout ?? null;
+    let navToken = 0;
+    // Built-in fallback when the surface has no not-found.tsx (ADR 0003 §5).
+    const loadNotFound = () => notFound ? notFound() : Promise.resolve({ default: DefaultNotFound });
+    // Pure orchestration: resolve the navigation outcome (with the navToken
+    // guard + load failure handling) and hand it to `buildTree`. No structure
+    // lives here — every renderable shape is in build-tree.ts (ADR 0006).
+    const render = async () => {
+        const token = ++navToken;
+        const { pathname, search } = parseLocation();
+        const ctx = { pathname, search, router };
+        const matches = matchRoutes(pathname, currentRoutes);
+        if (!matches) {
+            // No Route matched: not-found inside the surface-root layout only
+            // (ADR 0003 §4). Nothing matched, so no deeper layout is in scope.
+            let nf;
+            let rl;
+            try {
+                ;
+                [nf, rl] = await Promise.all([
+                    loadNotFound(),
+                    rootLayout ? rootLayout() : Promise.resolve(null),
+                ]);
+            }
+            catch (err) {
+                if (token !== navToken)
+                    return;
+                root.render(buildTree({ type: "load-error", error: toError(err), reset: () => void render() }, ctx));
+                return;
+            }
+            if (token !== navToken)
+                return;
+            root.render(buildTree({
+                type: "not-found",
+                notFound: nf.default,
+                rootLayout: rl ? rl.default : null,
+            }, ctx));
+            return;
+        }
+        const leaf = matches[matches.length - 1];
+        // Page + ancestor boundaries load in parallel, in route order
+        // (outermost first). A missing/broken module rejects here — outside
+        // React render, so no boundary can catch it; surface the built-in
+        // error instead of blanking the surface (ADR 0003 §5).
+        let mod;
+        let boundaryMods;
+        try {
+            ;
+            [mod, ...boundaryMods] = await Promise.all([
+                leaf.route.load(),
+                ...leaf.route.boundaries.map((b) => b.load()),
+            ]);
+        }
+        catch (err) {
+            if (token !== navToken)
+                return;
+            root.render(buildTree({ type: "load-error", error: toError(err), reset: () => void render() }, ctx));
+            return;
+        }
+        if (token !== navToken)
+            return;
+        // Zip each boundary's kind with its loaded component; structure (the
+        // §3 nesting) is buildTree's job, not this orchestrator's.
+        const boundaries = leaf.route.boundaries.map((b, i) => ({
+            kind: b.kind,
+            component: boundaryMods[i].default,
+        }));
+        root.render(buildTree({
+            type: "match",
+            page: mod.default,
+            params: leaf.params,
+            boundaries,
+        }, ctx));
+    };
+    window.addEventListener("hashchange", render);
+    render();
+    return {
+        update: (newRoutes, opts) => {
+            currentRoutes = newRoutes;
+            if (opts) {
+                notFound = opts.notFound ?? null;
+                rootLayout = opts.rootLayout ?? null;
+            }
+            render();
+        },
+    };
+};
+/**
+ * @describe Normalizes `window.location.hash` into a pathname + search string.
+ */
+const parseLocation = () => {
+    const [rawPath = "", search = ""] = window.location.hash.replace(/^#/, "").split("?");
+    return { pathname: rawPath || "/", search };
+};
+const stripHash = (to) => (to.startsWith("#") ? to.slice(1) : to);
+/**
+ * @describe Builds the stable router object passed through context. `replace`
+ * uses history.replaceState + a manual hashchange dispatch because
+ * replaceState alone doesn't fire the event.
+ */
+const createRouter = () => ({
+    push: (to) => {
+        window.location.hash = stripHash(to);
+    },
+    replace: (to) => {
+        window.history.replaceState(null, "", `#${stripHash(to)}`);
+        window.dispatchEvent(new HashChangeEvent("hashchange"));
+    },
+    back: () => window.history.back(),
+    forward: () => window.history.forward(),
+});

package/dist/router/defaults.d.ts

@@ -0,0 +1,24 @@
+import type { ErrorProps } from "./types.js";
+/**
+ * @describe Built-in error fallback (ADR 0003 §5). Always the outermost
+ * boundary so a thrown render never blanks the surface. Deliberately
+ * unstyled and minimal; shows `error.message` always (the extension error
+ * surface is seen by the developer far more than end users in v0.x).
+ */
+export declare const DefaultError: ({ error, reset }: ErrorProps) => import("react").DetailedReactHTMLElement<{
+    style: {
+        padding: number;
+        fontFamily: "system-ui, sans-serif";
+    };
+}, HTMLElement>;
+/**
+ * @describe Built-in not-found fallback (ADR 0003 §4/§5). Rendered when a
+ * hash matches no Route. Takes no props per the user contract; reads the
+ * unmatched path from the router context it is mounted within.
+ */
+export declare const DefaultNotFound: () => import("react").DetailedReactHTMLElement<{
+    style: {
+        padding: number;
+        fontFamily: "system-ui, sans-serif";
+    };
+}, HTMLElement>;

package/dist/router/defaults.js

@@ -0,0 +1,25 @@
+import { createElement } from "react";
+import { useLocation } from "./hooks.js";
+/**
+ * @describe Built-in error fallback (ADR 0003 §5). Always the outermost
+ * boundary so a thrown render never blanks the surface. Deliberately
+ * unstyled and minimal; shows `error.message` always (the extension error
+ * surface is seen by the developer far more than end users in v0.x).
+ */
+export const DefaultError = ({ error, reset }) => createElement("div", { style: { padding: 16, fontFamily: "system-ui, sans-serif" } }, createElement("p", { style: { margin: "0 0 8px", fontWeight: 600 } }, "Something went wrong"), createElement("pre", {
+    style: {
+        margin: "0 0 12px",
+        whiteSpace: "pre-wrap",
+        fontSize: 12,
+        color: "#b00",
+    },
+}, error.message), createElement("button", { onClick: reset }, "Try again"));
+/**
+ * @describe Built-in not-found fallback (ADR 0003 §4/§5). Rendered when a
+ * hash matches no Route. Takes no props per the user contract; reads the
+ * unmatched path from the router context it is mounted within.
+ */
+export const DefaultNotFound = () => {
+    const { pathname } = useLocation();
+    return createElement("div", { style: { padding: 16, fontFamily: "system-ui, sans-serif" } }, createElement("p", { style: { margin: "0 0 4px", fontWeight: 600 } }, "404"), createElement("p", { style: { margin: 0, fontSize: 13, color: "#666" } }, `No route for ${pathname}`));
+};

package/dist/router/error-boundary.d.ts

@@ -0,0 +1,23 @@
+import type { ComponentType, ReactNode } from "react";
+import type { ErrorProps } from "./types.js";
+import { Component } from "react";
+interface ErrorBoundaryProps {
+    fallback: ComponentType<ErrorProps>;
+    children: ReactNode;
+}
+interface ErrorBoundaryState {
+    error: Error | null;
+}
+/**
+ * @describe Catches render errors in its subtree and shows `fallback` with
+ * `{ error, reset }`. Composed inside its sibling layout (ADR 0003 §3), so a
+ * caught error never tears the layout down, and `reset()` only re-renders the
+ * boundary's own contents.
+ */
+export declare class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
+    state: ErrorBoundaryState;
+    static getDerivedStateFromError(error: Error): ErrorBoundaryState;
+    reset: () => void;
+    render(): ReactNode;
+}
+export {};

package/dist/router/error-boundary.js

@@ -0,0 +1,21 @@
+import { Component, createElement } from "react";
+/**
+ * @describe Catches render errors in its subtree and shows `fallback` with
+ * `{ error, reset }`. Composed inside its sibling layout (ADR 0003 §3), so a
+ * caught error never tears the layout down, and `reset()` only re-renders the
+ * boundary's own contents.
+ */
+export class ErrorBoundary extends Component {
+    state = { error: null };
+    static getDerivedStateFromError(error) {
+        return { error };
+    }
+    reset = () => this.setState({ error: null });
+    render() {
+        const { error } = this.state;
+        if (error) {
+            return createElement(this.props.fallback, { error, reset: this.reset });
+        }
+        return this.props.children;
+    }
+}

package/dist/router/hooks.d.ts

@@ -0,0 +1,18 @@
+import type { Router } from "./context.js";
+export declare const useLocation: () => {
+    pathname: string;
+    search: string;
+};
+export declare const useParams: <T extends Record<string, string> = Record<string, string>>() => T;
+export declare const useRouter: () => Router;
+type SearchInit = URLSearchParams | string | Record<string, string>;
+interface UseSearchParamsResult {
+    params: URLSearchParams;
+    setParams: (next: SearchInit) => void;
+}
+/**
+ * @describe Reads + writes the URL search string. Updates use `router.replace`
+ * so query edits don't pile up history entries.
+ */
+export declare const useSearchParams: () => UseSearchParamsResult;
+export {};

package/dist/router/hooks.js

@@ -0,0 +1,34 @@
+import { useContext, useMemo } from "react";
+import { RouterContext } from "./context.js";
+const useRouterContext = () => {
+    const ctx = useContext(RouterContext);
+    if (!ctx) {
+        throw new Error("Extro: router hooks must be used inside a page rendered by createExtroRouter.");
+    }
+    return ctx;
+};
+export const useLocation = () => {
+    const { pathname, search } = useRouterContext();
+    return { pathname, search };
+};
+export const useParams = () => {
+    return useRouterContext().params;
+};
+export const useRouter = () => useRouterContext().router;
+/**
+ * @describe Reads + writes the URL search string. Updates use `router.replace`
+ * so query edits don't pile up history entries.
+ */
+export const useSearchParams = () => {
+    const { search, pathname, router } = useRouterContext();
+    const params = useMemo(() => new URLSearchParams(search), [search]);
+    const setParams = (next) => {
+        const nextSearch = next instanceof URLSearchParams
+            ? next.toString()
+            : typeof next === "string"
+                ? next
+                : new URLSearchParams(next).toString();
+        router.replace(nextSearch ? `${pathname}?${nextSearch}` : pathname);
+    };
+    return { params, setParams };
+};

package/dist/router/index.d.ts

@@ -0,0 +1,8 @@
+import "../react/env.js";
+export { createExtroRouter } from "./create-router.js";
+export type { ExtroRouterHandle } from "./create-router.js";
+export { matchRoutes } from "./match.js";
+export { Link } from "./link.js";
+export { useLocation, useParams, useRouter, useSearchParams, } from "./hooks.js";
+export type { Router, RouterContextValue } from "./context.js";
+export type { CreateRouterOptions, DynamicRoute, ErrorProps, LayoutProps, PageProps, Route, RouteMatch, StaticRoute, } from "./types.js";

package/dist/router/index.js

@@ -0,0 +1,7 @@
+// Pulls in the ambient env typing so importing a routing subpath is enough to
+// type `import.meta.env` with no extra setup.
+import "../react/env.js";
+export { createExtroRouter } from "./create-router.js";
+export { matchRoutes } from "./match.js";
+export { Link } from "./link.js";
+export { useLocation, useParams, useRouter, useSearchParams, } from "./hooks.js";

package/dist/router/link.d.ts

@@ -0,0 +1,305 @@
+import type { AnchorHTMLAttributes, MouseEvent } from "react";
+interface LinkProps extends Omit<AnchorHTMLAttributes<HTMLAnchorElement>, "href"> {
+    /** Route to navigate to, e.g. "/settings". The leading "#" is added for you. */
+    href: string;
+    /** Replace the current history entry instead of pushing a new one. */
+    replace?: boolean;
+}
+/**
+ * @describe Hash-router-aware anchor. Renders a real `<a>` pointing at the hash
+ * route, so middle-click and open-in-new-tab keep working, and prepends the "#"
+ * for you. With `replace`, it intercepts a plain left-click and swaps the
+ * current entry via `router.replace` instead of pushing a new one.
+ * @example <Link href="/settings">Settings</Link>
+ */
+export declare const Link: ({ href, replace, onClick, ...rest }: LinkProps) => import("react").DetailedReactHTMLElement<{
+    content?: string | undefined | undefined;
+    title?: string | undefined | undefined;
+    type?: string | undefined | undefined;
+    slot?: string | undefined | undefined;
+    style?: import("react").CSSProperties | undefined;
+    color?: string | undefined | undefined;
+    children?: import("react").ReactNode;
+    download?: any;
+    hrefLang?: string | undefined | undefined;
+    media?: string | undefined | undefined;
+    ping?: string | undefined | undefined;
+    target?: import("react").HTMLAttributeAnchorTarget | undefined;
+    referrerPolicy?: import("react").HTMLAttributeReferrerPolicy | undefined;
+    defaultChecked?: boolean | undefined | undefined;
+    defaultValue?: string | number | readonly string[] | undefined;
+    suppressContentEditableWarning?: boolean | undefined | undefined;
+    suppressHydrationWarning?: boolean | undefined | undefined;
+    accessKey?: string | undefined | undefined;
+    autoCapitalize?: "off" | "none" | "on" | "sentences" | "words" | "characters" | undefined | (string & {}) | undefined;
+    autoFocus?: boolean | undefined | undefined;
+    className?: string | undefined | undefined;
+    contentEditable?: "inherit" | (boolean | "true" | "false") | "plaintext-only" | undefined;
+    contextMenu?: string | undefined | undefined;
+    dir?: string | undefined | undefined;
+    draggable?: (boolean | "true" | "false") | undefined;
+    enterKeyHint?: "enter" | "done" | "go" | "next" | "previous" | "search" | "send" | undefined | undefined;
+    hidden?: boolean | undefined | undefined;
+    id?: string | undefined | undefined;
+    lang?: string | undefined | undefined;
+    nonce?: string | undefined | undefined;
+    spellCheck?: (boolean | "true" | "false") | undefined;
+    tabIndex?: number | undefined | undefined;
+    translate?: "yes" | "no" | undefined | undefined;
+    radioGroup?: string | undefined | undefined;
+    role?: import("react").AriaRole | undefined;
+    about?: string | undefined | undefined;
+    datatype?: string | undefined | undefined;
+    inlist?: any;
+    prefix?: string | undefined | undefined;
+    property?: string | undefined | undefined;
+    rel?: string | undefined | undefined;
+    resource?: string | undefined | undefined;
+    rev?: string | undefined | undefined;
+    typeof?: string | undefined | undefined;
+    vocab?: string | undefined | undefined;
+    autoCorrect?: string | undefined | undefined;
+    autoSave?: string | undefined | undefined;
+    itemProp?: string | undefined | undefined;
+    itemScope?: boolean | undefined | undefined;
+    itemType?: string | undefined | undefined;
+    itemID?: string | undefined | undefined;
+    itemRef?: string | undefined | undefined;
+    results?: number | undefined | undefined;
+    security?: string | undefined | undefined;
+    unselectable?: "on" | "off" | undefined | undefined;
+    popover?: "" | "auto" | "manual" | "hint" | undefined | undefined;
+    popoverTargetAction?: "toggle" | "show" | "hide" | undefined | undefined;
+    popoverTarget?: string | undefined | undefined;
+    inert?: boolean | undefined | undefined;
+    inputMode?: "none" | "text" | "tel" | "url" | "email" | "numeric" | "decimal" | "search" | undefined | undefined;
+    is?: string | undefined | undefined;
+    exportparts?: string | undefined | undefined;
+    part?: string | undefined | undefined;
+    "aria-activedescendant"?: string | undefined | undefined;
+    "aria-atomic"?: (boolean | "true" | "false") | undefined;
+    "aria-autocomplete"?: "none" | "inline" | "list" | "both" | undefined | undefined;
+    "aria-braillelabel"?: string | undefined | undefined;
+    "aria-brailleroledescription"?: string | undefined | undefined;
+    "aria-busy"?: (boolean | "true" | "false") | undefined;
+    "aria-checked"?: boolean | "false" | "mixed" | "true" | undefined | undefined;
+    "aria-colcount"?: number | undefined | undefined;
+    "aria-colindex"?: number | undefined | undefined;
+    "aria-colindextext"?: string | undefined | undefined;
+    "aria-colspan"?: number | undefined | undefined;
+    "aria-controls"?: string | undefined | undefined;
+    "aria-current"?: boolean | "false" | "true" | "page" | "step" | "location" | "date" | "time" | undefined | undefined;
+    "aria-describedby"?: string | undefined | undefined;
+    "aria-description"?: string | undefined | undefined;
+    "aria-details"?: string | undefined | undefined;
+    "aria-disabled"?: (boolean | "true" | "false") | undefined;
+    "aria-dropeffect"?: "none" | "copy" | "execute" | "link" | "move" | "popup" | undefined | undefined;
+    "aria-errormessage"?: string | undefined | undefined;
+    "aria-expanded"?: (boolean | "true" | "false") | undefined;
+    "aria-flowto"?: string | undefined | undefined;
+    "aria-grabbed"?: (boolean | "true" | "false") | undefined;
+    "aria-haspopup"?: boolean | "false" | "true" | "menu" | "listbox" | "tree" | "grid" | "dialog" | undefined | undefined;
+    "aria-hidden"?: (boolean | "true" | "false") | undefined;
+    "aria-invalid"?: boolean | "false" | "true" | "grammar" | "spelling" | undefined | undefined;
+    "aria-keyshortcuts"?: string | undefined | undefined;
+    "aria-label"?: string | undefined | undefined;
+    "aria-labelledby"?: string | undefined | undefined;
+    "aria-level"?: number | undefined | undefined;
+    "aria-live"?: "off" | "assertive" | "polite" | undefined | undefined;
+    "aria-modal"?: (boolean | "true" | "false") | undefined;
+    "aria-multiline"?: (boolean | "true" | "false") | undefined;
+    "aria-multiselectable"?: (boolean | "true" | "false") | undefined;
+    "aria-orientation"?: "horizontal" | "vertical" | undefined | undefined;
+    "aria-owns"?: string | undefined | undefined;
+    "aria-placeholder"?: string | undefined | undefined;
+    "aria-posinset"?: number | undefined | undefined;
+    "aria-pressed"?: boolean | "false" | "mixed" | "true" | undefined | undefined;
+    "aria-readonly"?: (boolean | "true" | "false") | undefined;
+    "aria-relevant"?: "additions" | "additions removals" | "additions text" | "all" | "removals" | "removals additions" | "removals text" | "text" | "text additions" | "text removals" | undefined | undefined;
+    "aria-required"?: (boolean | "true" | "false") | undefined;
+    "aria-roledescription"?: string | undefined | undefined;
+    "aria-rowcount"?: number | undefined | undefined;
+    "aria-rowindex"?: number | undefined | undefined;
+    "aria-rowindextext"?: string | undefined | undefined;
+    "aria-rowspan"?: number | undefined | undefined;
+    "aria-selected"?: (boolean | "true" | "false") | undefined;
+    "aria-setsize"?: number | undefined | undefined;
+    "aria-sort"?: "none" | "ascending" | "descending" | "other" | undefined | undefined;
+    "aria-valuemax"?: number | undefined | undefined;
+    "aria-valuemin"?: number | undefined | undefined;
+    "aria-valuenow"?: number | undefined | undefined;
+    "aria-valuetext"?: string | undefined | undefined;
+    dangerouslySetInnerHTML?: {
+        __html: string | TrustedHTML;
+    } | undefined | undefined;
+    onCopy?: import("react").ClipboardEventHandler<HTMLAnchorElement> | undefined;
+    onCopyCapture?: import("react").ClipboardEventHandler<HTMLAnchorElement> | undefined;
+    onCut?: import("react").ClipboardEventHandler<HTMLAnchorElement> | undefined;
+    onCutCapture?: import("react").ClipboardEventHandler<HTMLAnchorElement> | undefined;
+    onPaste?: import("react").ClipboardEventHandler<HTMLAnchorElement> | undefined;
+    onPasteCapture?: import("react").ClipboardEventHandler<HTMLAnchorElement> | undefined;
+    onCompositionEnd?: import("react").CompositionEventHandler<HTMLAnchorElement> | undefined;
+    onCompositionEndCapture?: import("react").CompositionEventHandler<HTMLAnchorElement> | undefined;
+    onCompositionStart?: import("react").CompositionEventHandler<HTMLAnchorElement> | undefined;
+    onCompositionStartCapture?: import("react").CompositionEventHandler<HTMLAnchorElement> | undefined;
+    onCompositionUpdate?: import("react").CompositionEventHandler<HTMLAnchorElement> | undefined;
+    onCompositionUpdateCapture?: import("react").CompositionEventHandler<HTMLAnchorElement> | undefined;
+    onFocus?: import("react").FocusEventHandler<HTMLAnchorElement> | undefined;
+    onFocusCapture?: import("react").FocusEventHandler<HTMLAnchorElement> | undefined;
+    onBlur?: import("react").FocusEventHandler<HTMLAnchorElement> | undefined;
+    onBlurCapture?: import("react").FocusEventHandler<HTMLAnchorElement> | undefined;
+    onChange?: import("react").ChangeEventHandler<HTMLAnchorElement, Element> | undefined;
+    onChangeCapture?: import("react").ChangeEventHandler<HTMLAnchorElement, Element> | undefined;
+    onBeforeInput?: import("react").InputEventHandler<HTMLAnchorElement> | undefined;
+    onBeforeInputCapture?: import("react").InputEventHandler<HTMLAnchorElement> | undefined;
+    onInput?: import("react").InputEventHandler<HTMLAnchorElement> | undefined;
+    onInputCapture?: import("react").InputEventHandler<HTMLAnchorElement> | undefined;
+    onReset?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onResetCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onSubmit?: import("react").SubmitEventHandler<HTMLAnchorElement> | undefined;
+    onSubmitCapture?: import("react").SubmitEventHandler<HTMLAnchorElement> | undefined;
+    onInvalid?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onInvalidCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onLoad?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onLoadCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onError?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onErrorCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onKeyDown?: import("react").KeyboardEventHandler<HTMLAnchorElement> | undefined;
+    onKeyDownCapture?: import("react").KeyboardEventHandler<HTMLAnchorElement> | undefined;
+    onKeyPress?: import("react").KeyboardEventHandler<HTMLAnchorElement> | undefined;
+    onKeyPressCapture?: import("react").KeyboardEventHandler<HTMLAnchorElement> | undefined;
+    onKeyUp?: import("react").KeyboardEventHandler<HTMLAnchorElement> | undefined;
+    onKeyUpCapture?: import("react").KeyboardEventHandler<HTMLAnchorElement> | undefined;
+    onAbort?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onAbortCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onCanPlay?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onCanPlayCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onCanPlayThrough?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onCanPlayThroughCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onDurationChange?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onDurationChangeCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onEmptied?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onEmptiedCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onEncrypted?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onEncryptedCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onEnded?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onEndedCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onLoadedData?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onLoadedDataCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onLoadedMetadata?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onLoadedMetadataCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onLoadStart?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onLoadStartCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onPause?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onPauseCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onPlay?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onPlayCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onPlaying?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onPlayingCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onProgress?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onProgressCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onRateChange?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onRateChangeCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onSeeked?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onSeekedCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onSeeking?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onSeekingCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onStalled?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onStalledCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onSuspend?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onSuspendCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onTimeUpdate?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onTimeUpdateCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onVolumeChange?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onVolumeChangeCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onWaiting?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onWaitingCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onAuxClick?: import("react").MouseEventHandler<HTMLAnchorElement> | undefined;
+    onAuxClickCapture?: import("react").MouseEventHandler<HTMLAnchorElement> | undefined;
+    onClickCapture?: import("react").MouseEventHandler<HTMLAnchorElement> | undefined;
+    onContextMenu?: import("react").MouseEventHandler<HTMLAnchorElement> | undefined;
+    onContextMenuCapture?: import("react").MouseEventHandler<HTMLAnchorElement> | undefined;
+    onDoubleClick?: import("react").MouseEventHandler<HTMLAnchorElement> | undefined;
+    onDoubleClickCapture?: import("react").MouseEventHandler<HTMLAnchorElement> | undefined;
+    onDrag?: import("react").DragEventHandler<HTMLAnchorElement> | undefined;
+    onDragCapture?: import("react").DragEventHandler<HTMLAnchorElement> | undefined;
+    onDragEnd?: import("react").DragEventHandler<HTMLAnchorElement> | undefined;
+    onDragEndCapture?: import("react").DragEventHandler<HTMLAnchorElement> | undefined;
+    onDragEnter?: import("react").DragEventHandler<HTMLAnchorElement> | undefined;
+    onDragEnterCapture?: import("react").DragEventHandler<HTMLAnchorElement> | undefined;
+    onDragExit?: import("react").DragEventHandler<HTMLAnchorElement> | undefined;
+    onDragExitCapture?: import("react").DragEventHandler<HTMLAnchorElement> | undefined;
+    onDragLeave?: import("react").DragEventHandler<HTMLAnchorElement> | undefined;
+    onDragLeaveCapture?: import("react").DragEventHandler<HTMLAnchorElement> | undefined;
+    onDragOver?: import("react").DragEventHandler<HTMLAnchorElement> | undefined;
+    onDragOverCapture?: import("react").DragEventHandler<HTMLAnchorElement> | undefined;
+    onDragStart?: import("react").DragEventHandler<HTMLAnchorElement> | undefined;
+    onDragStartCapture?: import("react").DragEventHandler<HTMLAnchorElement> | undefined;
+    onDrop?: import("react").DragEventHandler<HTMLAnchorElement> | undefined;
+    onDropCapture?: import("react").DragEventHandler<HTMLAnchorElement> | undefined;
+    onMouseDown?: import("react").MouseEventHandler<HTMLAnchorElement> | undefined;
+    onMouseDownCapture?: import("react").MouseEventHandler<HTMLAnchorElement> | undefined;
+    onMouseEnter?: import("react").MouseEventHandler<HTMLAnchorElement> | undefined;
+    onMouseLeave?: import("react").MouseEventHandler<HTMLAnchorElement> | undefined;
+    onMouseMove?: import("react").MouseEventHandler<HTMLAnchorElement> | undefined;
+    onMouseMoveCapture?: import("react").MouseEventHandler<HTMLAnchorElement> | undefined;
+    onMouseOut?: import("react").MouseEventHandler<HTMLAnchorElement> | undefined;
+    onMouseOutCapture?: import("react").MouseEventHandler<HTMLAnchorElement> | undefined;
+    onMouseOver?: import("react").MouseEventHandler<HTMLAnchorElement> | undefined;
+    onMouseOverCapture?: import("react").MouseEventHandler<HTMLAnchorElement> | undefined;
+    onMouseUp?: import("react").MouseEventHandler<HTMLAnchorElement> | undefined;
+    onMouseUpCapture?: import("react").MouseEventHandler<HTMLAnchorElement> | undefined;
+    onSelect?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onSelectCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onTouchCancel?: import("react").TouchEventHandler<HTMLAnchorElement> | undefined;
+    onTouchCancelCapture?: import("react").TouchEventHandler<HTMLAnchorElement> | undefined;
+    onTouchEnd?: import("react").TouchEventHandler<HTMLAnchorElement> | undefined;
+    onTouchEndCapture?: import("react").TouchEventHandler<HTMLAnchorElement> | undefined;
+    onTouchMove?: import("react").TouchEventHandler<HTMLAnchorElement> | undefined;
+    onTouchMoveCapture?: import("react").TouchEventHandler<HTMLAnchorElement> | undefined;
+    onTouchStart?: import("react").TouchEventHandler<HTMLAnchorElement> | undefined;
+    onTouchStartCapture?: import("react").TouchEventHandler<HTMLAnchorElement> | undefined;
+    onPointerDown?: import("react").PointerEventHandler<HTMLAnchorElement> | undefined;
+    onPointerDownCapture?: import("react").PointerEventHandler<HTMLAnchorElement> | undefined;
+    onPointerMove?: import("react").PointerEventHandler<HTMLAnchorElement> | undefined;
+    onPointerMoveCapture?: import("react").PointerEventHandler<HTMLAnchorElement> | undefined;
+    onPointerUp?: import("react").PointerEventHandler<HTMLAnchorElement> | undefined;
+    onPointerUpCapture?: import("react").PointerEventHandler<HTMLAnchorElement> | undefined;
+    onPointerCancel?: import("react").PointerEventHandler<HTMLAnchorElement> | undefined;
+    onPointerCancelCapture?: import("react").PointerEventHandler<HTMLAnchorElement> | undefined;
+    onPointerEnter?: import("react").PointerEventHandler<HTMLAnchorElement> | undefined;
+    onPointerLeave?: import("react").PointerEventHandler<HTMLAnchorElement> | undefined;
+    onPointerOver?: import("react").PointerEventHandler<HTMLAnchorElement> | undefined;
+    onPointerOverCapture?: import("react").PointerEventHandler<HTMLAnchorElement> | undefined;
+    onPointerOut?: import("react").PointerEventHandler<HTMLAnchorElement> | undefined;
+    onPointerOutCapture?: import("react").PointerEventHandler<HTMLAnchorElement> | undefined;
+    onGotPointerCapture?: import("react").PointerEventHandler<HTMLAnchorElement> | undefined;
+    onGotPointerCaptureCapture?: import("react").PointerEventHandler<HTMLAnchorElement> | undefined;
+    onLostPointerCapture?: import("react").PointerEventHandler<HTMLAnchorElement> | undefined;
+    onLostPointerCaptureCapture?: import("react").PointerEventHandler<HTMLAnchorElement> | undefined;
+    onScroll?: import("react").UIEventHandler<HTMLAnchorElement> | undefined;
+    onScrollCapture?: import("react").UIEventHandler<HTMLAnchorElement> | undefined;
+    onScrollEnd?: import("react").UIEventHandler<HTMLAnchorElement> | undefined;
+    onScrollEndCapture?: import("react").UIEventHandler<HTMLAnchorElement> | undefined;
+    onWheel?: import("react").WheelEventHandler<HTMLAnchorElement> | undefined;
+    onWheelCapture?: import("react").WheelEventHandler<HTMLAnchorElement> | undefined;
+    onAnimationStart?: import("react").AnimationEventHandler<HTMLAnchorElement> | undefined;
+    onAnimationStartCapture?: import("react").AnimationEventHandler<HTMLAnchorElement> | undefined;
+    onAnimationEnd?: import("react").AnimationEventHandler<HTMLAnchorElement> | undefined;
+    onAnimationEndCapture?: import("react").AnimationEventHandler<HTMLAnchorElement> | undefined;
+    onAnimationIteration?: import("react").AnimationEventHandler<HTMLAnchorElement> | undefined;
+    onAnimationIterationCapture?: import("react").AnimationEventHandler<HTMLAnchorElement> | undefined;
+    onToggle?: import("react").ToggleEventHandler<HTMLAnchorElement> | undefined;
+    onBeforeToggle?: import("react").ToggleEventHandler<HTMLAnchorElement> | undefined;
+    onTransitionCancel?: import("react").TransitionEventHandler<HTMLAnchorElement> | undefined;
+    onTransitionCancelCapture?: import("react").TransitionEventHandler<HTMLAnchorElement> | undefined;
+    onTransitionEnd?: import("react").TransitionEventHandler<HTMLAnchorElement> | undefined;
+    onTransitionEndCapture?: import("react").TransitionEventHandler<HTMLAnchorElement> | undefined;
+    onTransitionRun?: import("react").TransitionEventHandler<HTMLAnchorElement> | undefined;
+    onTransitionRunCapture?: import("react").TransitionEventHandler<HTMLAnchorElement> | undefined;
+    onTransitionStart?: import("react").TransitionEventHandler<HTMLAnchorElement> | undefined;
+    onTransitionStartCapture?: import("react").TransitionEventHandler<HTMLAnchorElement> | undefined;
+    href: string;
+    onClick: (event: MouseEvent<HTMLAnchorElement>) => void;
+}, HTMLElement>;
+export {};