defuss 2.1.11 → 3.2.0

package/dist/index.d.cts

@@ -1,5 +1,6 @@
-import { a7 as PersistenceProviderType, a8 as PersistenceProviderOptions, a9 as PersistenceProviderImpl, h as VNode, g as VNodeAttributes, R as RenderInput, G as Globals, N as NodeType, f as Ref, s as Props, n as VNodeChild, a2 as TransitionConfig } from './index-Up8-tXTY.cjs';
-export { am as $, A as AllHTMLElements, t as CLASS_ATTRIBUTE_NAME, C as CSSProperties, aa as Call, af as CallChainImpl, ag as CallChainImplThenable, p as Children, w as DANGEROUSLY_SET_INNER_HTML_ATTRIBUTE, a5 as DEFAULT_TRANSITION_CONFIG, aD as DOMPropValue, ak as Dequery, aE as DequeryOptions, aG as DequerySyncMethodReturnType, aB as Dimensions, D as DomAbstractionImpl, aF as ElementCreationOptions, F as FontFaceProperties, az as FormFieldValue, aA as FormKeyValues, T as Fragment, y as JsxRuntimeHookFn, J as JsxSourceInfo, K as KeyFrameProperties, aK as Listener, aI as MemoryStorage, aH as MiddlewareFn, P as ParentElementInput, b as ParentElementInputAsync, aC as Position, v as REF_ATTRIBUTE_NAME, d as RefUpdateFn, e as RefUpdateRenderFn, c as RefUpdateRenderFnInput, q as RenderNodeInput, a as RenderResult, r as RenderResultNode, aL as Store, S as SyncRenderInput, I as SyncRenderResult, a0 as TransitionStyles, $ as TransitionType, a1 as TransitionsEasing, V as VAttributes, o as VNodeChildren, j as VNodeKey, m as VNodeRef, l as VNodeRefCallback, k as VNodeRefObject, i as VNodeType, aJ as WebStorage, X as XLINK_ATTRIBUTE_NAME, u as XMLNS_ATTRIBUTE_NAME, ab as addNonChainedReturnCallNames, a4 as applyStyles, ar as createCall, as as createGetterSetterCall, x as createInPlaceErrorMessageVNode, _ as createRef, aM as createStore, at as createSubChain, aj as delayedAutoStart, al as dequery, ae as emptyImpl, ai as getAllFormValues, ap as getDefaultDequeryOptions, ac as getNonChainedReturnCallNames, H as getRenderer, a3 as getTransitionStyles, O as globalScopeDomApis, E as handleLifecycleEventsForOnMount, an as isDequery, ao as isDequeryOptionsObject, Q as isJSX, ad as isNonChainedReturnCall, Z as isRef, z as jsx, W as jsxDEV, U as jsxs, aq as mapArrayIndexAccess, B as observeUnmount, a6 as performTransition, M as renderIsomorphicAsync, L as renderIsomorphicSync, aw as renderNode, ax as resolveNodes, av as runWithTimeGuard, ah as scrollHelper, au as subChainForNextAwait, ay as traverse, Y as updateDom } from './index-Up8-tXTY.cjs';
+import { a7 as PersistenceProviderType, a8 as PersistenceProviderOptions, a9 as PersistenceProviderImpl, h as VNode, g as VNodeAttributes, R as RenderInput, G as Globals, N as NodeType, f as Ref, s as Props, n as VNodeChild, a2 as TransitionConfig } from './index-Bi8j-_h_.cjs';
+export { am as $, A as AllHTMLElements, t as CLASS_ATTRIBUTE_NAME, C as CSSProperties, aa as Call, af as CallChainImpl, ag as CallChainImplThenable, p as Children, w as DANGEROUSLY_SET_INNER_HTML_ATTRIBUTE, a5 as DEFAULT_TRANSITION_CONFIG, aD as DOMPropValue, ak as Dequery, aE as DequeryOptions, aG as DequerySyncMethodReturnType, aB as Dimensions, D as DomAbstractionImpl, aF as ElementCreationOptions, F as FontFaceProperties, az as FormFieldValue, aA as FormKeyValues, T as Fragment, y as JsxRuntimeHookFn, J as JsxSourceInfo, K as KeyFrameProperties, aK as Listener, aI as MemoryStorage, aH as MiddlewareFn, P as ParentElementInput, b as ParentElementInputAsync, aC as Position, v as REF_ATTRIBUTE_NAME, d as RefUpdateFn, e as RefUpdateRenderFn, c as RefUpdateRenderFnInput, q as RenderNodeInput, a as RenderResult, r as RenderResultNode, aL as Store, S as SyncRenderInput, I as SyncRenderResult, a0 as TransitionStyles, $ as TransitionType, a1 as TransitionsEasing, V as VAttributes, o as VNodeChildren, j as VNodeKey, m as VNodeRef, l as VNodeRefCallback, k as VNodeRefObject, i as VNodeType, aJ as WebStorage, X as XLINK_ATTRIBUTE_NAME, u as XMLNS_ATTRIBUTE_NAME, ab as addNonChainedReturnCallNames, a4 as applyStyles, ar as createCall, as as createGetterSetterCall, x as createInPlaceErrorMessageVNode, _ as createRef, aM as createStore, at as createSubChain, aj as delayedAutoStart, al as dequery, ae as emptyImpl, ai as getAllFormValues, ap as getDefaultDequeryOptions, ac as getNonChainedReturnCallNames, H as getRenderer, a3 as getTransitionStyles, O as globalScopeDomApis, E as handleLifecycleEventsForOnMount, an as isDequery, ao as isDequeryOptionsObject, Q as isJSX, ad as isNonChainedReturnCall, Z as isRef, z as jsx, W as jsxDEV, U as jsxs, aq as mapArrayIndexAccess, B as observeUnmount, a6 as performTransition, M as renderIsomorphicAsync, L as renderIsomorphicSync, aw as renderNode, ax as resolveNodes, av as runWithTimeGuard, ah as scrollHelper, au as subChainForNextAwait, ay as traverse, Y as updateDom } from './index-Bi8j-_h_.cjs';
+export { CAPTURE_ONLY_EVENTS, ComponentInstance, DelegatedEventOptions, DelegatedPhase, ParsedEventProp, clearDelegatedEvents, clearDelegatedEventsDeep, getComponentInstance, getRegisteredEventTypes, isComponentRoot, mount, parseEventPropName, registerComponent, registerDelegatedEvent, removeDelegatedEvent, unmount, unregisterComponent } from './render/index.cjs';
 import * as CSS from 'csstype';
 export { CSS };
 
@@ -17,11 +18,11 @@ declare const webstorage: <T>(provider?: PersistenceProviderType, options?: Pers
  */
 declare const areDomNodesEqual: (oldNode: Node, newNode: Node) => boolean;
 /********************************************************
- * 1) Define a "valid" child type & utility
+ * 1) Define a "valid" child type & utilities
  ********************************************************/
 type ValidChild = string | number | boolean | null | undefined | VNode<VNodeAttributes>;
 /********************************************************
- * 5) Main partial-update function (index-by-index approach)
+ * 6) Main state-preserving morph (key/id aware, move-not-replace)
  ********************************************************/
 declare function updateDomWithVdom(parentElement: Element, newVDOM: RenderInput, globals: Globals): void;
 /**
@@ -56,7 +57,7 @@ declare function domNodeToVNode(node: Node): VNode<VNodeAttributes> | string;
  * Converts an HTML string to VNode structure for use with updateDomWithVdom.
  * This allows markup strings to benefit from the intelligent partial update system.
  */
-declare function htmlStringToVNodes(html: string, Parser: typeof DOMParser): (VNode<VNodeAttributes> | string)[];
+declare function htmlStringToVNodes(html: string, Parser: typeof DOMParser): Array<VNode<VNodeAttributes> | string>;
 
 declare const queueCallback: (cb: Function) => () => void;
 

package/dist/index.d.ts

@@ -1,9 +1,13 @@
-import { a7 as PersistenceProviderType, a8 as PersistenceProviderOptions, a9 as PersistenceProviderImpl, h as VNode, g as VNodeAttributes, R as RenderInput, G as Globals, N as NodeType, f as Ref, s as Props, n as VNodeChild, a2 as TransitionConfig } from './index-Up8-tXTY.js';
-export { am as $, A as AllHTMLElements, t as CLASS_ATTRIBUTE_NAME, C as CSSProperties, aa as Call, af as CallChainImpl, ag as CallChainImplThenable, p as Children, w as DANGEROUSLY_SET_INNER_HTML_ATTRIBUTE, a5 as DEFAULT_TRANSITION_CONFIG, aD as DOMPropValue, ak as Dequery, aE as DequeryOptions, aG as DequerySyncMethodReturnType, aB as Dimensions, D as DomAbstractionImpl, aF as ElementCreationOptions, F as FontFaceProperties, az as FormFieldValue, aA as FormKeyValues, T as Fragment, y as JsxRuntimeHookFn, J as JsxSourceInfo, K as KeyFrameProperties, aK as Listener, aI as MemoryStorage, aH as MiddlewareFn, P as ParentElementInput, b as ParentElementInputAsync, aC as Position, v as REF_ATTRIBUTE_NAME, d as RefUpdateFn, e as RefUpdateRenderFn, c as RefUpdateRenderFnInput, q as RenderNodeInput, a as RenderResult, r as RenderResultNode, aL as Store, S as SyncRenderInput, I as SyncRenderResult, a0 as TransitionStyles, $ as TransitionType, a1 as TransitionsEasing, V as VAttributes, o as VNodeChildren, j as VNodeKey, m as VNodeRef, l as VNodeRefCallback, k as VNodeRefObject, i as VNodeType, aJ as WebStorage, X as XLINK_ATTRIBUTE_NAME, u as XMLNS_ATTRIBUTE_NAME, ab as addNonChainedReturnCallNames, a4 as applyStyles, ar as createCall, as as createGetterSetterCall, x as createInPlaceErrorMessageVNode, _ as createRef, aM as createStore, at as createSubChain, aj as delayedAutoStart, al as dequery, ae as emptyImpl, ai as getAllFormValues, ap as getDefaultDequeryOptions, ac as getNonChainedReturnCallNames, H as getRenderer, a3 as getTransitionStyles, O as globalScopeDomApis, E as handleLifecycleEventsForOnMount, an as isDequery, ao as isDequeryOptionsObject, Q as isJSX, ad as isNonChainedReturnCall, Z as isRef, z as jsx, W as jsxDEV, U as jsxs, aq as mapArrayIndexAccess, B as observeUnmount, a6 as performTransition, M as renderIsomorphicAsync, L as renderIsomorphicSync, aw as renderNode, ax as resolveNodes, av as runWithTimeGuard, ah as scrollHelper, au as subChainForNextAwait, ay as traverse, Y as updateDom } from './index-Up8-tXTY.js';
-import * as CSS from 'csstype';
-export { CSS };
+import { ao as PersistenceProviderType, ap as PersistenceProviderOptions, aq as PersistenceProviderImpl, W as VNode, X as VNodeAttributes, N as NodeType, R as RenderInput, G as Globals, t as Props, v as Ref, i as DOMElement, Y as VNodeChild, F as FC, T as TransitionConfig, c as AsyncDefussChild } from './index-DnUO13Ql.js';
+export { ar as $, A as AllHTMLElements, as as AnyEventHandler, d as AsyncFC, e as AsyncFunctionComponent, C as CLASS_ATTRIBUTE_NAME, f as CSSProperties, at as Call, au as CallChainImpl, av as CallChainImplThenable, g as Children, D as DANGEROUSLY_SET_INNER_HTML_ATTRIBUTE, h as DEFAULT_TRANSITION_CONFIG, aw as DOMPropValue, j as DefussChild, k as DefussChildren, l as DefussClassValue, m as DefussKey, ax as Dequery, ay as DequeryOptions, az as DequerySyncMethodReturnType, aA as Dimensions, n as DomAbstractionImpl, aB as ElementCreationOptions, E as ElementProps, aC as EqualsFn, aD as EventMapFor, aE as EventMapForAny, o as FontFaceProperties, aF as FormFieldValue, aG as FormKeyValues, p as Fragment, q as FunctionComponent, J as JsxRuntimeHookFn, r as JsxSourceInfo, K as KeyFrameProperties, aH as Listener, M as Maybe, aI as MemoryStorage, aJ as MiddlewareFn, s as MountHandler, O as OneOrMany, b as ParentElementInput, P as ParentElementInputAsync, aK as Position, u as REF_ATTRIBUTE_NAME, w as RefUpdateFn, x as RefUpdateRenderFn, y as RefUpdateRenderFnInput, z as RenderNodeInput, a as RenderResult, B as RenderResultNode, aL as Store, aM as StoreOptions, S as SyncRenderInput, H as SyncRenderResult, aN as TargetOf, I as TransitionStyles, L as TransitionType, Q as TransitionsEasing, aO as UnionToIntersection, U as UnmountHandler, V as VAttributes, Z as VNodeChildren, _ as VNodeKey, $ as VNodeRef, a0 as VNodeRefCallback, a1 as VNodeRefObject, a2 as VNodeType, aP as WebStorage, a3 as XLINK_ATTRIBUTE_NAME, a4 as XMLNS_ATTRIBUTE_NAME, aQ as addNonChainedReturnCallNames, a5 as applyStyles, aR as createCall, aS as createGetterSetterCall, a6 as createInPlaceErrorMessageVNode, a7 as createRef, aT as createStore, aU as createSubChain, aV as createSyncCall, aW as deepEquals, aX as delayedAutoStart, aY as dequery, aZ as emptyImpl, a_ as getAllFormValues, a$ as getDefaultDequeryOptions, b0 as getNonChainedReturnCallNames, a8 as getRenderer, a9 as getTransitionStyles, aa as globalScopeDomApis, ab as handleLifecycleEventsForOnMount, b1 as isDequery, b2 as isDequeryOptionsObject, ac as isJSX, b3 as isNonChainedReturnCall, ad as isRef, ae as jsx, af as jsxDEV, ag as jsxs, b4 as mapArrayIndexAccess, ah as nsMap, ai as observeUnmount, aj as performTransition, b5 as render, ak as renderInto, al as renderIsomorphicAsync, am as renderIsomorphicSync, b6 as renderNode, b7 as resolveNodes, b8 as runWithTimeGuard, b9 as scrollHelper, ba as shallowEquals, bb as subChainForNextAwait, bc as traverse, an as updateDom } from './index-DnUO13Ql.js';
+export { CAPTURE_ONLY_EVENTS, ComponentInstance, DelegatedEventOptions, DelegatedPhase, ParsedEventProp, clearDelegatedEvents, clearDelegatedEventsDeep, getComponentInstance, getRegisteredEventKeys, getRegisteredEventTypes, isComponentRoot, mount, parseEventPropName, registerComponent, registerDelegatedEvent, removeDelegatedEvent, removeDelegatedEventByKey, unmount, unregisterComponent } from './render/index.js';
+import 'csstype';
 
-declare const inDevMode = true;
+/**
+ * Detect development mode for dev-only warnings and logs.
+ * In production builds, bundlers can dead-code eliminate based on this.
+ */
+declare const inDevMode: boolean;
 
 /** returns the persistence provider (isomorphic) */
 declare const webstorage: <T>(provider?: PersistenceProviderType, options?: PersistenceProviderOptions) => PersistenceProviderImpl<T>;
@@ -17,11 +21,11 @@ declare const webstorage: <T>(provider?: PersistenceProviderType, options?: Pers
  */
 declare const areDomNodesEqual: (oldNode: Node, newNode: Node) => boolean;
 /********************************************************
- * 1) Define a "valid" child type & utility
+ * 1) Define a "valid" child type & utilities
  ********************************************************/
 type ValidChild = string | number | boolean | null | undefined | VNode<VNodeAttributes>;
 /********************************************************
- * 5) Main partial-update function (index-by-index approach)
+ * 6) Main state-preserving morph (key/id aware, move-not-replace)
  ********************************************************/
 declare function updateDomWithVdom(parentElement: Element, newVDOM: RenderInput, globals: Globals): void;
 /**
@@ -44,9 +48,9 @@ declare function getMimeType(input: string, Parser: typeof DOMParser): DOMParser
 declare function processAllFormElements(node: NodeType, callback: (input: HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement, key: string) => void): void;
 declare function checkElementVisibility(element: HTMLElement, window: Window, document: Document): boolean;
 declare function getEventMap(element: HTMLElement): Map<string, Set<EventListener>>;
-declare function addElementEvent(element: HTMLElement, eventType: string, handler: EventListener): void;
-declare function removeElementEvent(element: HTMLElement, eventType: string, handler?: EventListener): void;
-declare function clearElementEvents(element: HTMLElement): void;
+declare function addElementEvent(target: EventTarget, eventType: string, handler: EventListener): void;
+declare function removeElementEvent(target: EventTarget, eventType: string, handler?: EventListener): void;
+declare function clearElementEvents(target: EventTarget): void;
 /**
  * Converts a DOM node to a VNode structure for use with updateDomWithVdom.
  * This allows us to leverage the sophisticated partial update system even for Node inputs.
@@ -56,10 +60,14 @@ declare function domNodeToVNode(node: Node): VNode<VNodeAttributes> | string;
  * Converts an HTML string to VNode structure for use with updateDomWithVdom.
  * This allows markup strings to benefit from the intelligent partial update system.
  */
-declare function htmlStringToVNodes(html: string, Parser: typeof DOMParser): (VNode<VNodeAttributes> | string)[];
+declare function htmlStringToVNodes(html: string, Parser: typeof DOMParser): Array<VNode<VNodeAttributes> | string>;
 
-declare const queueCallback: (cb: Function) => () => void;
+declare const queueCallback: <T extends any[]>(cb: (...args: T) => void) => (...args: T) => void;
 
+type Resolve<T> = T extends infer U ? U : never;
+type TranslationKeys<T, Prefix extends string = ""> = Resolve<{
+    [K in keyof T]: T[K] extends Record<string, unknown> ? TranslationKeys<T[K], `${Prefix}${K & string}.`> : `${Prefix}${K & string}`;
+}[keyof T]>;
 type TranslationObject = {
     [key: string]: string | VNode | TranslationObject;
 };
@@ -68,26 +76,41 @@ type Translations = {
 };
 type OnLanguageChangeListener = (newLanguage: string) => void;
 type Replacements = Record<string, string>;
-interface I18nStore {
+interface I18nStore<K extends string = string> {
     language: string;
     changeLanguage: (language: string) => void;
-    t: (path: string, options?: Record<string, string>) => string;
+    t: (path: K, options?: Record<string, string>) => string;
     loadLanguage: (language: string, translations: TranslationObject) => void;
     subscribe: (onLanguageChange: OnLanguageChangeListener) => () => void;
     unsubscribe: (onLanguageChange: OnLanguageChangeListener) => void;
 }
-declare const createI18n: () => I18nStore;
-declare const i18n: I18nStore;
+declare const createI18n: <K extends string>() => I18nStore<K>;
+/**
+ * @deprecated Use `createI18n` instances with typed keys instead of the default singleton.
+ */
+declare const i18n: I18nStore<string>;
+/**
+ * @deprecated Use `createI18n` instances with typed keys instead of the default singleton.
+ */
 declare const t: (path: string, options?: Record<string, string>) => string;
+/**
+ * @deprecated Use `createI18n` instances with typed keys instead of the default singleton.
+ */
 declare const changeLanguage: (language: string) => void;
+/**
+ * @deprecated Use `createI18n` instances with typed keys instead of the default singleton.
+ */
 declare const loadLanguage: (language: string, translations: TranslationObject) => void;
+/**
+ * @deprecated Use `createI18n` instances with typed keys instead of the default singleton.
+ */
 declare const getLanguage: () => string;
 
-interface TransRef extends Ref<string, HTMLElement> {
+interface TransRef extends Ref<DOMElement, string> {
     updateValues: (values: Replacements) => void;
 }
-interface TransProps extends Props {
-    key: string;
+interface TransProps<K extends string> extends Props {
+    key: K;
     ref?: TransRef;
     tag?: string;
     values?: Replacements;
@@ -96,8 +119,15 @@ interface TransProps extends Props {
     style?: string;
     [propName: string]: any;
 }
-declare const Trans: ({ key, values, tag, ref, ...attrs }: TransProps) => VNodeChild;
-declare const T: ({ key, values, tag, ref, ...attrs }: TransProps) => VNodeChild;
+declare const createTrans: <K extends string>(i18n: I18nStore<K>) => ({ key, values, tag, ref, ...attrs }: TransProps<K>) => VNodeChild;
+/**
+ * @deprecated Use `createTrans` instances with typed i18n keys instead of the default singleton.
+ */
+declare const Trans: ({ key, values, tag, ref, ...attrs }: TransProps<string>) => VNodeChild;
+/**
+ * @deprecated Use `createTrans` instances with typed i18n keys instead of the default singleton.
+ * */
+declare const T: ({ key, values, tag, ref, ...attrs }: TransProps<string>) => VNodeChild;
 
 type OnHandleRouteChangeFn = (newRoute: string, oldRoute: string) => void;
 type OnRouteChangeFn = (cb: OnHandleRouteChangeFn) => void;
@@ -108,6 +138,10 @@ interface RouterConfig {
 interface RouteMatchGroups {
     [matchName: string]: number;
 }
+/**
+ * Key-value map for URL parameters.
+ * Used for route params, query params, and hash params.
+ */
 interface RouteParams {
     [name: string]: string;
 }
@@ -117,9 +151,95 @@ interface RouteRegistration {
     tokenizedPath?: TokenizedPath;
     handler?: RouteHandler;
 }
+/**
+ * Represents the current routing state and URL information.
+ *
+ * This object is **always returned** by `Router.getRequest()`, `Router.match()`,
+ * and `Router.resolve()`. Unlike returning `false` on no match, this provides
+ * a deterministic API where you can always access URL information.
+ *
+ * @example
+ * ```tsx
+ * const req = Router.getRequest();
+ *
+ * // Check if a registered route matched
+ * if (req.match) {
+ *   console.log(`Matched route: ${req.matchedRoute}`);
+ *   console.log(`Component name: ${req.params.name}`);
+ * } else {
+ *   console.log('No matching route');
+ * }
+ *
+ * // URL components are always available regardless of match
+ * console.log(`Current path: ${req.path}`);
+ * console.log(`Base URL: ${req.baseUrl}`);
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Dynamic route like "/components/:name"
+ * const req = Router.getRequest();
+ * const title = req.match ? req.params.name : 'Unknown';
+ * ```
+ */
 interface RouteRequest {
+    /**
+     * Whether a registered route pattern matched the current path.
+     * Always check this before accessing route-specific params.
+     */
+    match: boolean;
+    /**
+     * The route pattern that matched, e.g., "/components/:name".
+     * `null` if no route matched (`match === false`).
+     */
+    matchedRoute: string | null;
+    /**
+     * URL protocol without the colon, e.g., "http" or "https".
+     */
+    protocol: string;
+    /**
+     * Domain/hostname, e.g., "localhost" or "example.com".
+     */
+    domain: string;
+    /**
+     * Port number as string, e.g., "5173".
+     * Empty string if using default port (80 for http, 443 for https).
+     */
+    port: string;
+    /**
+     * Base URL combining protocol, domain, and port.
+     * E.g., "http://localhost:5173" or "https://example.com".
+     * Does not include path, query, or hash.
+     */
+    baseUrl: string;
+    /**
+     * Path portion of the URL, e.g., "/components/accordion".
+     * Does not include query string or hash.
+     */
+    path: string;
+    /**
+     * Full URL including path, query, and hash.
+     * E.g., "http://localhost:5173/components/accordion?tab=code#section"
+     */
     url: string;
+    /**
+     * Route parameters extracted from dynamic segments.
+     * E.g., for route "/components/:name" and path "/components/accordion",
+     * params would be `{ name: "accordion" }`.
+     * Empty object if no route matched or route has no params.
+     */
     params: RouteParams;
+    /**
+     * Query string parameters parsed from the URL.
+     * E.g., for "?q=test&page=1", queryParams would be `{ q: "test", page: "1" }`.
+     */
+    queryParams: RouteParams;
+    /**
+     * Hash fragment parameters parsed as key-value pairs.
+     * E.g., for "#sort=desc&view=grid", hashParams would be `{ sort: "desc", view: "grid" }`.
+     * Note: Only works if hash uses query-string format.
+     */
+    hashParams: RouteParams;
 }
 interface TokenizedPath {
     regexp: RegExp;
@@ -127,19 +247,55 @@ interface TokenizedPath {
 }
 type RouteHandler = (request: RouteRequest) => void;
 declare const tokenizePath: (path: string) => TokenizedPath;
-declare const matchRouteRegistrations: (routeRegistrations: Array<RouteRegistration>, actualPathName: string, haystackPathName?: string) => RouteRequest | false;
+interface MatchRouteRegistrationsOpts {
+    invokeHandler?: boolean;
+}
+/**
+ * Match registered routes against the current pathname.
+ * Always returns a RouteRequest object with match: true/false.
+ */
+declare const matchRouteRegistrations: (routeRegistrations: Array<RouteRegistration>, actualPathName: string, haystackPathName?: string, opts?: MatchRouteRegistrationsOpts, windowImpl?: Window) => RouteRequest;
 declare const setupRouter: (config?: RouterConfig, windowImpl?: Window) => Router;
+interface RouterState {
+    routeRegistrations: Array<RouteRegistration>;
+    currentRequest: RouteRequest | null;
+    isReady: boolean;
+    pendingResolvers: Array<() => void>;
+    currentPath: string;
+    popAttached: boolean;
+}
+declare global {
+    var __defuss_router__: Router | undefined;
+    var __defuss_router_state__: RouterState | undefined;
+}
+declare const getRouterState: () => RouterState;
 interface Router {
     listeners: Array<OnHandleRouteChangeFn>;
     strategy: RouterStrategy;
     add(registration: RouteRegistration): Router;
-    match(path?: string): RouteRequest | false;
+    match(path?: string): RouteRequest;
+    resolve(pathname?: string): RouteRequest;
+    getRequest(): RouteRequest;
     getRoutes(): Array<RouteRegistration>;
     tokenizePath(path: string): TokenizedPath;
     navigate(path: string): void;
     onRouteChange: OnRouteChangeFn;
     destroy(): void;
     attachPopStateHandler(): void;
+    /**
+     * Returns a promise that resolves when the router is ready (routes are registered).
+     * Call this before using getRequest() in components that render inside Route.
+     *
+     * @example
+     * ```tsx
+     * const MyComponent = async () => {
+     *   await Router.ready();
+     *   const req = Router.getRequest();
+     *   // params are now available
+     * }
+     * ```
+     */
+    ready(): Promise<void>;
 }
 declare const Router: Router;
 
@@ -148,17 +304,19 @@ interface RouteProps extends Props {
     router?: Router;
     exact?: boolean;
 }
-declare const Route: ({ path, exact, children, router, }: RouteProps) => VNodeChild;
+declare const Route: FC<RouteProps>;
 
 interface RedirectProps extends RouteProps {
     to: string;
 }
-declare const Redirect: ({ path, to, router, exact, }: RedirectProps) => VNodeChild;
+declare const Redirect: FC<RedirectProps>;
 
 declare const RouterSlotId = "router-slot";
 interface RouterSlotProps extends Props {
     /** to override the tag name used for the router slot */
     tag?: string;
+    /** to override the default id 'router-slot' */
+    id?: string;
     /** to identify/select the root DOM element or style it, W3C naming */
     class?: string;
     /** to identify/select the root DOM element or style it, React naming */
@@ -175,16 +333,16 @@ interface RouterSlotProps extends Props {
  * and renders its default children (RouterOutlet). Whenever the route changes, it re-renders dynamically.
  * This decouples the slot refresh logic from route registration.
  */
-declare const RouterSlot: ({ router, children, RouterOutlet, transitionConfig, ...attributes }: RouterSlotProps) => VNodeChild;
+declare const RouterSlot: FC<RouterSlotProps>;
 
 type AsyncState = "loading" | "loaded" | "error";
-interface AsyncStateRef extends Ref<AsyncState, HTMLElement> {
+interface AsyncStateRef extends Ref<DOMElement, AsyncState> {
     /** The state of the async content */
     state?: AsyncState;
     /** Error details are available here in case the state changes to "error" */
     error?: unknown;
 }
-interface AsyncProps extends Props {
+interface AsyncProps extends Omit<Props, 'children'> {
     /** to uniquely identify the root DOM element without using a ref */
     id?: string;
     /** to identify/select the root DOM element or style it, W3C naming */
@@ -192,17 +350,20 @@ interface AsyncProps extends Props {
     /** to identify/select the root DOM element or style it, React naming */
     className?: string;
     /** The fallback content to display while the async content is loading */
-    fallback?: VNode;
+    fallback?: VNode | JSX.Element;
     /** Store this with createRef() to update() the Suspense state */
     ref?: AsyncStateRef;
-    /** The async content to display when loaded */
-    render?: () => Promise<RenderInput>;
     /** to override the name of the .suspense-loading transition CSS class name */
     loadingClassName?: string;
     /** to override the name of the .suspense-loaded transition CSS class name */
     loadedClassName?: string;
     /** to override the name of the .suspense-error transition CSS class name */
     errorClassName?: string;
+    /**
+     * Children of Async can include async components (Promise-returning).
+     * These are resolved automatically before rendering.
+     */
+    children?: AsyncDefussChild | AsyncDefussChild[];
 }
 declare const Async: ({ fallback, ref, children, class: _class, className, id, loadingClassName, loadedClassName, errorClassName, onError, }: AsyncProps) => {
     type: string;
@@ -212,8 +373,9 @@ declare const Async: ({ fallback, ref, children, class: _class, className, id, l
         className: string | undefined;
         ref: AsyncStateRef;
         onMount: () => void;
+        "data-defuss-keep": boolean;
     };
-    children: VNode<VNodeAttributes>[];
+    children: (VNode<VNodeAttributes> | VNode<VNodeAttributes> | Promise<VNode<VNodeAttributes> | null>)[];
 };
 declare const Suspense: ({ fallback, ref, children, class: _class, className, id, loadingClassName, loadedClassName, errorClassName, onError, }: AsyncProps) => {
     type: string;
@@ -223,9 +385,10 @@ declare const Suspense: ({ fallback, ref, children, class: _class, className, id
         className: string | undefined;
         ref: AsyncStateRef;
         onMount: () => void;
+        "data-defuss-keep": boolean;
     };
-    children: VNode<VNodeAttributes>[];
+    children: (VNode<VNodeAttributes> | VNode<VNodeAttributes> | Promise<VNode<VNodeAttributes> | null>)[];
 };
 
-export { Async, Globals, NodeType, PersistenceProviderImpl, PersistenceProviderOptions, PersistenceProviderType, Props, Redirect, Ref, RenderInput, Route, Router, RouterSlot, RouterSlotId, Suspense, T, Trans, TransitionConfig, VNode, VNodeAttributes, VNodeChild, addElementEvent, areDomNodesEqual, changeLanguage, checkElementVisibility, clearElementEvents, createI18n, domNodeToVNode, getEventMap, getLanguage, getMimeType, htmlStringToVNodes, i18n, inDevMode, isHTML, isMarkup, isSVG, loadLanguage, matchRouteRegistrations, parseDOM, processAllFormElements, queueCallback, removeElementEvent, renderMarkup, replaceDomWithVdom, setupRouter, t, tokenizePath, updateDomWithVdom, waitForDOM, webstorage };
-export type { AsyncProps, AsyncState, AsyncStateRef, I18nStore, OnHandleRouteChangeFn, OnLanguageChangeListener, OnRouteChangeFn, RedirectProps, Replacements, RouteHandler, RouteParams, RouteProps, RouteRegistration, RouteRequest, RouterConfig, RouterSlotProps, RouterStrategy, TokenizedPath, TransProps, TransRef, TranslationObject, Translations, ValidChild };
+export { Async, AsyncDefussChild, DOMElement, FC, Globals, NodeType, PersistenceProviderImpl, PersistenceProviderOptions, PersistenceProviderType, Props, Redirect, Ref, RenderInput, Route, Router, RouterSlot, RouterSlotId, Suspense, T, Trans, TransitionConfig, VNode, VNodeAttributes, VNodeChild, addElementEvent, areDomNodesEqual, changeLanguage, checkElementVisibility, clearElementEvents, createI18n, createTrans, domNodeToVNode, getEventMap, getLanguage, getMimeType, getRouterState, htmlStringToVNodes, i18n, inDevMode, isHTML, isMarkup, isSVG, loadLanguage, matchRouteRegistrations, parseDOM, processAllFormElements, queueCallback, removeElementEvent, renderMarkup, replaceDomWithVdom, setupRouter, t, tokenizePath, updateDomWithVdom, waitForDOM, webstorage };
+export type { AsyncProps, AsyncState, AsyncStateRef, I18nStore, MatchRouteRegistrationsOpts, OnHandleRouteChangeFn, OnLanguageChangeListener, OnRouteChangeFn, RedirectProps, Replacements, Resolve, RouteHandler, RouteParams, RouteProps, RouteRegistration, RouteRequest, RouterConfig, RouterSlotProps, RouterStrategy, TokenizedPath, TransProps, TransRef, TranslationKeys, TranslationObject, Translations, ValidChild };