@fluixi/core 1.0.0-alpha.53

package/dist/src/lib/router-next/data.js

@@ -0,0 +1,179 @@
+/**
+ * @fileoverview Data fetching and caching primitives for Fluixi Router
+ * @module @fluixi/core/router/data
+ */
+import { createResource, createSignal } from '@fluixi/reactive/signal';
+import { getHydrationData, setHydrationData, isServerEnvironment, isHydrating, } from '../server/hydration.js';
+import { useContext, createContext } from '../context/context.js';
+// ============================================================================
+// CACHE (QUERY) SYSTEM
+// ============================================================================
+const globalCache = new Map();
+const inflightRequests = new Map();
+/**
+ * Cache an async function for data fetching
+ *
+ * Supports:
+ * - Deduplication
+ * - Hydration (Server -> Client)
+ * - Revalidation
+ *
+ * @param fn Async function to cache
+ * @param name Unique name for the cache key
+ */
+export function cache(fn, name) {
+    return async (...args) => {
+        const key = name + ':' + JSON.stringify(args);
+        // 1. Check Hydration Data (Client-side hydration)
+        if (isHydrating() || typeof window !== 'undefined') {
+            const hydrated = getHydrationData(key);
+            if (hydrated !== undefined) {
+                return hydrated;
+            }
+        }
+        // 2. Check Memory Cache
+        if (globalCache.has(key)) {
+            return globalCache.get(key);
+        }
+        // 3. Request Deduplication
+        if (inflightRequests.has(key)) {
+            return inflightRequests.get(key);
+        }
+        // 4. Execute
+        const promise = Promise.resolve(fn(...args)).then((val) => {
+            globalCache.set(key, val);
+            inflightRequests.delete(key);
+            // Save for hydration if on server
+            if (isServerEnvironment()) {
+                setHydrationData(key, val);
+            }
+            return val;
+        }, (err) => {
+            inflightRequests.delete(key);
+            throw err;
+        });
+        inflightRequests.set(key, promise);
+        return promise;
+    };
+}
+/**
+ * Global revalidation signal. Tracked by createAsync so that
+ * when a key is revalidated, matching resources re-fetch.
+ */
+const [revalidationVersion, setRevalidationVersion] = createSignal(0);
+const revalidationKeys = new Set();
+/**
+ * Revalidate a cache key. Clears the memory cache and triggers
+ * reactive invalidation so resources using createAsync re-fetch.
+ *
+ * @param key Key prefix string or predicate function to match cache keys
+ */
+export function revalidate(key) {
+    const predicate = typeof key === 'string' ? (k) => k.startsWith(key) : key;
+    for (const k of globalCache.keys()) {
+        if (predicate(k)) {
+            globalCache.delete(k);
+            revalidationKeys.add(k);
+        }
+    }
+    // Bump version to trigger reactive refresh in createAsync consumers
+    setRevalidationVersion((v) => v + 1);
+}
+// ============================================================================
+// ASYNC DATA PRIMITIVES
+// ============================================================================
+/**
+ * Create an async resource from a promise or cache function
+ *
+ * @param fetcher Function that returns a promise
+ * @param source Dependency signal (optional)
+ */
+export function createAsync(fetcher, source) {
+    const [data] = createResource(source || (() => true), fetcher);
+    return data;
+    // return () => '' as any;
+}
+// ============================================================================
+// ACTIONS
+// ============================================================================
+const submissionState = new Map();
+function getSubmissionSignal(url) {
+    if (!submissionState.has(url)) {
+        submissionState.set(url, createSignal(undefined));
+    }
+    return submissionState.get(url);
+}
+/**
+ * Create a server action
+ *
+ * @param fn Function to execute (server-side)
+ * @param name Action name
+ */
+export function action(fn, name) {
+    const actionUrl = name || fn.name || 'action';
+    const submit = async (input) => {
+        const [, setSubmission] = getSubmissionSignal(actionUrl);
+        // Reset state
+        const clear = () => setSubmission(undefined);
+        const retry = () => submit(input);
+        setSubmission({
+            input: input, // Approximate type for tracking
+            pending: true,
+            clear,
+            retry,
+        });
+        try {
+            // Cast to any to handle potential argument mismatch in generic types
+            // fn expects tuple Args, input is single value or FormData
+            const result = await fn(input);
+            setSubmission({
+                input: input,
+                result,
+                pending: false,
+                clear,
+                retry,
+            });
+            return result;
+        }
+        catch (error) {
+            setSubmission({
+                input: input,
+                error,
+                pending: false,
+                clear,
+                retry,
+            });
+            throw error;
+        }
+    };
+    submit.url = actionUrl;
+    submit.with = (args) => action((...a) => fn(args, ...a), name);
+    return submit;
+}
+/**
+ * Hook to track action submission state
+ */
+export function useSubmission(actionFn) {
+    const [submission] = getSubmissionSignal(actionFn.url);
+    return submission;
+}
+/**
+ * Hook to get action executor
+ */
+export function useAction(actionFn) {
+    return actionFn;
+}
+export const RouteDataContext = createContext();
+export const RouteDataProvider = RouteDataContext.Provider;
+/**
+ * Access the data returned by the nearest ancestor route's `routeData` export.
+ *
+ * Returns a stable accessor function. Call it to get the current route data:
+ *
+ *   const data = useRouteData<WorkspaceRouteData>();
+ *   createEffect(() => console.log(data()?.workspace()));
+ */
+export function useRouteData() {
+    const ctx = useContext(RouteDataContext);
+    return typeof ctx === 'function' ? ctx : () => ctx;
+}

package/dist/src/lib/router-next/data.mjs

@@ -0,0 +1 @@
+import{createResource as M,createSignal as h}from"@fluixi/reactive/signal";var A=!1,f=new Map;function p(){return A}function y(e,t){f.set(e,t)}function x(e){return f.get(e)}function S(){f.clear()}function w(){if(typeof window>"u")return;let e=document.getElementById("__FLUIXI_HYDRATION__");e&&e.remove();let t=document.createTreeWalker(document.body,NodeFilter.SHOW_COMMENT,null),n=[],r;for(;r=t.nextNode();){let i=r,o=i.nodeValue||"";(o.startsWith("#")||o.startsWith("/"))&&n.push(i)}n.forEach(i=>i.remove()),S()}typeof window<"u"&&window.addEventListener("load",()=>{setTimeout(w,100)});function T(){return typeof window>"u"}import{asProvider as _}from"@fluixi/dom";import{createContext as k,useContext as H}from"@fluixi/reactive/signal";import{readChildren as ue}from"@fluixi/reactive/signal";import{registerCreateComponent as P,asComponent as E}from"@fluixi/dom";import{untrack as R,onCleanup as $,getOwner as z,createEffect as K,createMemo as J,createSignal as X,isSignal as O,batch as Y,runWithOwner as q}from"@fluixi/reactive/signal";function g(e){P(D)}function D(e,t){return L(e,t)}function L(e,t){let n=typeof e=="function"?R(()=>e(t)):e;if(n!=null&&(typeof n=="function"||typeof n=="object")&&!O(n)){try{n.$name=e.name}catch{}return E(n)}return n}g("index");function m(e){let t=k(e),n=r=>(r.debug,t.Provider({value:r.value,get children(){return r.children},debug:r.debug}));return typeof Symbol<"u"&&Symbol.for&&(n.$$typeof=Symbol.for("react.provider")),n.$$typeof=Symbol.for("react.provider"),{id:t.id,Provider:_(n),defaultValue:e}}function v(e){let t=H(e);return t!==void 0?t:e.defaultValue}var c=new Map,a=new Map;function ge(e,t){return async(...n)=>{let r=t+":"+JSON.stringify(n);if(p()||typeof window<"u"){let o=x(r);if(o!==void 0)return o}if(c.has(r))return c.get(r);if(a.has(r))return a.get(r);let i=Promise.resolve(e(...n)).then(o=>(c.set(r,o),a.delete(r),T()&&y(r,o),o),o=>{throw a.delete(r),o});return a.set(r,i),i}}var[me,U]=h(0),j=new Set;function ve(e){let t=typeof e=="string"?n=>n.startsWith(e):e;for(let n of c.keys())t(n)&&(c.delete(n),j.add(n));U(n=>n+1)}function he(e,t){let[n]=M(t||(()=>!0),e);return n}var l=new Map;function C(e){return l.has(e)||l.set(e,h(void 0)),l.get(e)}function I(e,t){let n=t||e.name||"action",r=async i=>{let[,o]=C(n),d=()=>o(void 0),u=()=>r(i);o({input:i,pending:!0,clear:d,retry:u});try{let s=await e(i);return o({input:i,result:s,pending:!1,clear:d,retry:u}),s}catch(s){throw o({input:i,error:s,pending:!1,clear:d,retry:u}),s}};return r.url=n,r.with=i=>I((...o)=>e(i,...o),t),r}function Ce(e){let[t]=C(e.url);return t}function be(e){return e}var b=m(),Ae=b.Provider;function Se(){let e=v(b);return typeof e=="function"?e:()=>e}export{b as RouteDataContext,Ae as RouteDataProvider,I as action,ge as cache,he as createAsync,ve as revalidate,be as useAction,Se as useRouteData,Ce as useSubmission};

package/dist/src/lib/router-next/index.cjs

@@ -0,0 +1 @@
+"use strict";var w=Object.defineProperty;var re=Object.getOwnPropertyDescriptor;var oe=Object.getOwnPropertyNames;var ae=Object.prototype.hasOwnProperty;var ie=(e,n)=>{for(var t in n)w(e,t,{get:n[t],enumerable:!0})},se=(e,n,t,o)=>{if(n&&typeof n=="object"||typeof n=="function")for(let r of oe(n))!ae.call(e,r)&&r!==t&&w(e,r,{get:()=>n[r],enumerable:!(o=re(n,r))||o.enumerable});return e};var ce=e=>se(w({},"__esModule",{value:!0}),e);var _e={};ie(_e,{A:()=>ke,Form:()=>Me,Link:()=>Z,Outlet:()=>be,Redirect:()=>Re,Router:()=>Ce,action:()=>E,cache:()=>j,createAsync:()=>I,createBrowserHistory:()=>g.createBrowserHistory,createMemoryHistory:()=>g.createMemoryHistory,lazy:()=>$,matchPath:()=>g.matchPath,matchRoutes:()=>g.matchRoutes,preloadRoutes:()=>Ne,revalidate:()=>U,runWithOwner:()=>ee.runWithOwner,select:()=>Le,useAction:()=>W,useLevelParams:()=>we,useLocation:()=>D,useMatch:()=>Oe,useNavigate:()=>Q,useParam:()=>Ae,useParamSelector:()=>Se,useParams:()=>L,useRouteData:()=>De,useRouter:()=>P,useSearchParams:()=>Ee,useSubmission:()=>K});module.exports=ce(_e);var s=require("@fluixi/reactive/signal"),u=require("@fluixi/dom"),f=require("@fluixi/reactive/signal"),q=require("@fluixi/utils/object"),B=require("@fluixi/utils/compare"),m=require("@fluixi/router"),g=require("@fluixi/router");var T=require("@fluixi/reactive/signal");var ue=!1,A=new Map;function k(){return ue}function M(e,n){A.set(e,n)}function N(e){return A.get(e)}function de(){A.clear()}function fe(){if(typeof window>"u")return;let e=document.getElementById("__FLUIXI_HYDRATION__");e&&e.remove();let n=document.createTreeWalker(document.body,NodeFilter.SHOW_COMMENT,null),t=[],o;for(;o=n.nextNode();){let r=o,a=r.nodeValue||"";(a.startsWith("#")||a.startsWith("/"))&&t.push(r)}t.forEach(r=>r.remove()),de()}typeof window<"u"&&window.addEventListener("load",()=>{setTimeout(fe,100)});function _(){return typeof window>"u"}var V=require("@fluixi/dom"),S=require("@fluixi/reactive/signal"),ye=require("@fluixi/reactive/signal");var b=require("@fluixi/dom"),l=require("@fluixi/reactive/signal");function H(e){(0,b.registerCreateComponent)(le)}function le(e,n){return pe(e,n)}function pe(e,n){let t=typeof e=="function"?(0,l.untrack)(()=>e(n)):e;if(t!=null&&(typeof t=="function"||typeof t=="object")&&!(0,l.isSignal)(t)){try{t.$name=e.name}catch{}return(0,b.asComponent)(t)}return t}H("index");function F(e){let n=(0,S.createContext)(e),t=o=>(o.debug,n.Provider({value:o.value,get children(){return o.children},debug:o.debug}));return typeof Symbol<"u"&&Symbol.for&&(t.$$typeof=Symbol.for("react.provider")),t.$$typeof=Symbol.for("react.provider"),{id:n.id,Provider:(0,V.asProvider)(t),defaultValue:e}}var v=new Map,h=new Map;function j(e,n){return async(...t)=>{let o=n+":"+JSON.stringify(t);if(k()||typeof window<"u"){let a=N(o);if(a!==void 0)return a}if(v.has(o))return v.get(o);if(h.has(o))return h.get(o);let r=Promise.resolve(e(...t)).then(a=>(v.set(o,a),h.delete(o),_()&&M(o,a),a),a=>{throw h.delete(o),a});return h.set(o,r),r}}var[nt,me]=(0,T.createSignal)(0),ge=new Set;function U(e){let n=typeof e=="string"?t=>t.startsWith(e):e;for(let t of v.keys())n(t)&&(v.delete(t),ge.add(t));me(t=>t+1)}function I(e,n){let[t]=(0,T.createResource)(n||(()=>!0),e);return t}var O=new Map;function z(e){return O.has(e)||O.set(e,(0,T.createSignal)(void 0)),O.get(e)}function E(e,n){let t=n||e.name||"action",o=async r=>{let[,a]=z(t),i=()=>a(void 0),c=()=>o(r);a({input:r,pending:!0,clear:i,retry:c});try{let d=await e(r);return a({input:r,result:d,pending:!1,clear:i,retry:c}),d}catch(d){throw a({input:r,error:d,pending:!1,clear:i,retry:c}),d}};return o.url=t,o.with=r=>E((...a)=>e(r,...a),n),o}function K(e){let[n]=z(e.url);return n}function W(e){return e}var xe=F(),rt=xe.Provider;var x=require("@fluixi/reactive/signal");function $(e,n){let t,o,r;function a(){return o||(o=e().then(c=>t=c.default)),o}n?.preload&&a();let i=(c=>{if(t){let d=t;return(0,x.untrack)(()=>d(c))}if(!r){let[d]=(0,x.createResource)(()=>a());if(r=d,d.error)throw d.error}return(0,x.createMemo)(()=>{let d=r();return d?(0,x.untrack)(()=>d(c)):void 0},void 0,{name:"lazy"})});return i.preload=()=>a().then(()=>{}),i.$lazy=!0,i.loader=e,i}var ee=require("@fluixi/reactive/signal"),R=(0,f.createContext)(),J=(0,f.createContext)(),X=(0,f.createContext)(),Y=(0,f.createContext)();function he(e,n,t){let o,r=e.route.data;if(typeof r=="function"){let C=!1;(0,s.onCleanup)(()=>{C=!0});let te=(0,s.getOwner)(),[ne]=(0,s.createResource)(()=>r({params:t.params,location:t.location},te,()=>C));o=ne}let a=()=>Y.Provider({value:o,get children(){return X.Provider({value:e.params,get children(){return J.Provider({value:{depth:n,...t},get children(){return(0,u.createComponent)(e.component,{})}})}})}});if(!o)return a();let i=o,c=()=>i.loading,[d,p]=(0,s.createSignal)((0,s.untrack)(()=>!c()));return(0,s.createEffect)(()=>p(!c())),(0,s.createMemo)(()=>d()?a():null)}function G(e){let n=e.depth+1,[t,o]=(0,s.createSignal)((0,s.untrack)(()=>e.matched()[n]?.component));return(0,s.createEffect)(()=>{let r=e.matched()[n]?.component;o(()=>r)}),(0,s.createMemo)(()=>{if(!t())return e.notFound?e.notFound():null;let a=(0,s.untrack)(()=>e.matched())[n];return he(a,n,{matched:e.matched,params:e.params,location:e.location})})}function ve(e){return e==null?Te():typeof e=="function"?(0,u.createComponent)(e,{}):e}function Te(){let e=(0,u.createNativeElement)("div");(0,u.setAttribute)(e,"class","fx-not-found"),(0,u.setAttribute)(e,"role","main"),(0,u.setAttribute)(e,"style","min-height:60vh;display:grid;place-content:center;gap:.25rem;text-align:center;font-family:system-ui,-apple-system,sans-serif");let n=(0,u.createNativeElement)("h1");(0,u.setAttribute)(n,"style","margin:0;font-size:2.5rem;font-weight:700"),(0,u.insert)(n,"404");let t=(0,u.createNativeElement)("p");return(0,u.setAttribute)(t,"style","margin:0;opacity:.7"),(0,u.insert)(t,"This page could not be found."),e.appendChild(n),e.appendChild(t),e}function Ce(e){let n=e.history??(0,m.createBrowserHistory)(),t=(0,m.createRouter)({routes:e.routes,base:e.base,history:n}),[o,r]=(0,s.createSignal)(t.state()),a=t.subscribe(r);(0,s.onCleanup)(()=>{a(),t.destroy()});let i=(0,s.createMemo)(()=>(o().match?.matched??[]).filter(C=>C.component)),c={router:t,location:(0,s.createMemo)(()=>o().location),params:(0,s.createMemo)(()=>o().match?.params??{})},d={depth:-1,matched:i,params:c.params,location:c.location,notFound:()=>ve(e.notFound)},p;return R.Provider({value:c,get children(){return p??=G(d)}})}function be(){let e=(0,f.useContext)(J);return e?G(e):null}function Re(e){let n=(0,f.useContext)(R);if(!n||typeof window>"u")return null;let t=!1;return(0,s.onCleanup)(()=>t=!0),queueMicrotask(()=>{t||n.router.navigate(e.to,{replace:e.replace!==!1})}),null}var Pe={router:{navigate:()=>{}},location:()=>({pathname:"",search:"",hash:"",query:{}}),params:()=>({})};function P(){let e=(0,f.useContext)(R);if(e)return e;if(typeof window>"u")return Pe;throw new Error("[router-next] useRouter must be used within <Router>")}function L(){let e=P().params;return(0,s.createMemo)(()=>e(),{},{equals:(n,t)=>JSON.stringify(n)===JSON.stringify(t)})}function we(){return(0,f.useContext)(X)??{}}function Ae(e){let n=L();return(0,s.createMemo)(()=>n()[e])}function Se(e,n){let t=L();return(0,s.createMemo)(()=>e(t()),void 0,n?{equals:n}:void 0)}function Oe(e){let n=D();return(0,s.createMemo)(()=>(0,m.matchPath)(typeof e=="function"?e():e,n.pathname))}function Ee(){let e=D(),n=Q();return[(0,s.createMemo)(()=>e.query),(r,a)=>{let i=new URLSearchParams(e.search);for(let[d,p]of Object.entries(r))p===null?i.delete(d):i.set(d,p);let c=i.toString();n(e.pathname+(c?`?${c}`:""),a)}]}function Le(e,n){let t=(o,r)=>(0,B.deepEqual)(o,r);return n!==void 0?(0,s.createMemo)(()=>(0,q.get)(e(),n),void 0,{equals:t}):(0,s.createMemo)(e,void 0,{equals:t})}function D(){let{location:e}=P();return new Proxy({},{get:(n,t)=>e()[t],has:(n,t)=>t in e(),ownKeys:()=>Reflect.ownKeys(e()),getOwnPropertyDescriptor:(n,t)=>Object.getOwnPropertyDescriptor(e(),t)})}function Q(){let{router:e}=P();return(n,t)=>e.navigate(n,t)}function De(){return(0,f.useContext)(Y)??(()=>{})}var y=e=>typeof e=="function"?e():e;function Z(e){let n=(0,f.useContext)(R),t=typeof document>"u",o=()=>n?.router.navigate(y(e.href)??"",{replace:y(e.replace)}),r=(0,u.createNativeElement)("a");if((0,u.setAttribute)(r,"href",y(e.href)??""),e.slot&&(0,u.setAttribute)(r,"slot",y(e.slot)),typeof r.addEventListener=="function")r.addEventListener("click",i=>{i.metaKey||i.ctrlKey||i.shiftKey||i.altKey||(i.preventDefault(),o())});else{let i=y(e.className??e.class)??"";i&&(0,u.setAttribute)(r,"class",i)}typeof r.addEventListener=="function"&&(0,s.createEffect)(()=>{let i=y(e.href)??"";r.setAttribute("href",i);let c=y(e.className??e.class)??"",d=y(e.activeClass)??"",p=y(e.active)??n?.location().pathname===i;r.className=[c,p?d:""].filter(Boolean).join(" ")});let a=e.children;return a!=null&&(0,u.insert)(r,a),r}var ke=Z;function Me(e){let n=e.action,t=e.className??e.class,o=n.url??"",r=(0,u.createNativeElement)("form");(0,u.setAttribute)(r,"method","post"),o&&(0,u.setAttribute)(r,"action",o),t&&(0,u.setAttribute)(r,"class",t);for(let[i,c]of Object.entries(e))i==="action"||i==="children"||i==="class"||i==="className"||c!=null&&typeof c!="function"&&(0,u.setAttribute)(r,i,String(c));typeof r.addEventListener=="function"&&r.addEventListener("submit",i=>{i.preventDefault();let c={};new FormData(r).forEach((d,p)=>{c[p]=d}),Promise.resolve(n(c)).catch(()=>{})});let a=e.children;return a!=null&&(0,u.insert)(r,a),r}async function Ne(e,n){let t=(0,m.matchRoutes)(e,n);if(!t)return;let o=[];for(let r of t.matched){let a=r.component;a&&typeof a.preload=="function"&&o.push(a.preload())}await Promise.all(o)}

package/dist/src/lib/router-next/index.d.ts

@@ -0,0 +1,156 @@
+/**
+ * @fileoverview Fluixi adapter for the framework-agnostic @fluixi/router core.
+ *
+ * Renders the resolved match tree TOP-DOWN. Each layer's component is rendered
+ * inside the PARENT layer's <Outlet/> scope, so a child route inherits whatever
+ * context a parent layout provides. <Outlet/> is reactive but keyed on the child's
+ * component reference, so it only re-renders when the child route at that depth
+ * actually changes — sibling navigation reuses the layout, deeper navigation
+ * leaves shallower layouts untouched.
+ *
+ * No parentGate, no deferred content memo: a child is rendered straight from the
+ * matched array, never by re-entering a still-building parent, so deeply nested
+ * <Outlet/> works at any depth.
+ */
+import { type GetAtPath } from '@fluixi/utils/object';
+import type { IsUndefined } from '@fluixi/utils/primitive';
+import { type RouteDefinition, type Router as CoreRouter, type HistoryAdapter, type RouterLocation, type NavigateOptions } from '@fluixi/router';
+interface RouterCtxValue {
+    router: CoreRouter<any>;
+    location: () => RouterLocation;
+    params: () => Record<string, string>;
+}
+export interface RouterProps<C = any> {
+    routes: RouteDefinition<C>[];
+    base?: string;
+    history?: HistoryAdapter;
+    /**
+     * Rendered when the current URL matches no route — a component, an element, or any renderable.
+     * Defaults to a minimal built-in 404 so an unmatched URL never renders a blank page. For a 404
+     * that keeps your layout/chrome, add a catch-all file route instead (`[...slug].tsx` → `*`).
+     */
+    notFound?: any;
+}
+export declare function Router<C = any>(props: RouterProps<C>): any;
+/** Renders this layout's child route, inside this layout's context. */
+export declare function Outlet(): any;
+/** Navigate to `to` on mount (replace by default). Renders nothing. */
+export declare function Redirect(props: {
+    to: string;
+    replace?: boolean;
+}): null;
+export declare function useRouter(): RouterCtxValue;
+/**
+ * Reactive merged params across all matched layers, as an accessor. Deep-equal
+ * memoized so it only notifies when a value actually changes (the underlying
+ * params object is rebuilt on every transition).
+ */
+export declare function useParams<T extends Record<string, string> = Record<string, string>>(): () => T;
+/** Params introduced at the nearest matched layer. */
+export declare function useLevelParams(): Record<string, string>;
+/**
+ * Reactive accessor for a single route param. Default `===` equality on the
+ * string value, so it only re-triggers when THIS key changes — not when other
+ * params at the same level change.
+ */
+export declare function useParam(key: string): () => string | undefined;
+/**
+ * Derive a stable value from route params. Only re-triggers when the selector's
+ * return value changes. For object returns, pass a custom `equals`.
+ *
+ * @example
+ * const ids = useParamSelector((p) => ({ wsId: p.workspaceId, chId: p.channelId }), deepEqual);
+ */
+export declare function useParamSelector<T>(selector: (params: Record<string, string>) => T, equals?: (a: T, b: T) => boolean): () => T;
+/**
+ * Match a path pattern against the current pathname, reactively. Returns the
+ * matched `{ params, path }` or null.
+ */
+export declare function useMatch(path: (() => string) | string): () => {
+    params: Record<string, string>;
+    path: string;
+} | null;
+/**
+ * Read/write the current query string. Returns `[params, setParams]`: `params`
+ * is a reactive accessor of the parsed query; `setParams` merges the given keys
+ * (null deletes) and navigates. Matches the old router.
+ */
+export declare function useSearchParams(): readonly [
+    () => Record<string, string>,
+    (next: Record<string, string | null>, options?: NavigateOptions) => void
+];
+/**
+ * Stable accessor from any reactive source with deep-equal memoization. Pass a
+ * `key` to select a nested property. Only re-triggers downstream when the value
+ * (or selected field) actually changes.
+ *
+ * @example
+ * const ws = select(store.activeWorkspace);        // whole object
+ * const id = select(store.activeWorkspace, 'id');  // single field
+ */
+export declare function select<T, K extends string = never>(source: () => T, key?: K): () => IsUndefined<K> extends true ? T : GetAtPath<T, K>;
+/**
+ * The current location as a reactive object: reading a property (pathname, etc.)
+ * subscribes to location changes. Matches the old router's useLocation().
+ */
+export declare function useLocation(): RouterLocation;
+export declare function useNavigate(): (to: string, options?: NavigateOptions) => void;
+/**
+ * The resolved data for the nearest route that declared a `data` loader. Always
+ * returns a callable accessor (matching the old router): it suspends under
+ * <Suspense> while loading and yields undefined when no ancestor declared data.
+ */
+export declare function useRouteData<T = any>(): () => T | undefined;
+type MaybeAccessor<T> = T | (() => T);
+export interface LinkProps {
+    href: MaybeAccessor<string>;
+    replace?: MaybeAccessor<boolean>;
+    /** Override active state. Defaults to current pathname === href. */
+    active?: MaybeAccessor<boolean>;
+    class?: MaybeAccessor<string>;
+    className?: MaybeAccessor<string>;
+    /** Class added while the link is active. */
+    activeClass?: MaybeAccessor<string>;
+    slot?: string;
+    children?: any;
+}
+export declare function Link(props: LinkProps): any;
+/** Alias for {@link Link}. */
+export declare const A: typeof Link;
+import type { Action } from './data.js';
+export interface FormProps {
+    /** The action to run on submit (typically wrapping a `"use server"` function). */
+    action: Action<any, any>;
+    /** Extra class on the <form>. */
+    class?: string;
+    children?: any;
+    [key: string]: any;
+}
+/**
+ * A `<form>` wired to an action: on submit it builds `FormData` from the form and calls
+ * `action(formData)` (which tracks submission state via `useSubmission`), without a full
+ * page navigation. The markup carries `method="post"` + `action={action.url}` so it's
+ * progressive-enhancement-ready.
+ *
+ *   <Form action={save}>
+ *     <input name="title" />
+ *     <button>Save</button>
+ *   </Form>
+ */
+export declare function Form(props: FormProps): any;
+/**
+ * Download the lazy component chunks for the route(s) matching `pathname` and resolve when
+ * they're all loaded. Await this BEFORE hydrating: once each matched lazy file-route is
+ * resolved it renders synchronously on the first pass (no Suspense fallback, no late
+ * re-render), so hydration adopts the server DOM in place instead of building a duplicate
+ * subtree next to it. No-op for routes with no lazy components. Safe to call when the URL
+ * matches nothing (resolves immediately).
+ */
+export declare function preloadRoutes<C = any>(routes: RouteDefinition<C>[], pathname: string): Promise<void>;
+export { createMemoryHistory, createBrowserHistory, matchRoutes, matchPath, } from '@fluixi/router';
+export type { RouteDefinition, RouteMatch, MatchedRoute, RouterLocation, NavigateOptions, HistoryAdapter, } from '@fluixi/router';
+export { cache, action, revalidate, createAsync, useSubmission, useAction, } from './data.js';
+export type { RouteDataArgs, RouteLoadFunc, Action, Submission, CacheFn, } from './data.js';
+export { lazy } from '../render/lazy.js';
+export { runWithOwner } from '@fluixi/reactive/signal';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/lib/router-next/index.d.ts.map

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