@fluixi/core 1.0.0-alpha.82 → 1.0.0-alpha.84

package/dist/src/lib/render/versions.js

@@ -1,13 +1,13 @@
 /**
  * Register this package's version with the DOM runtime, which owns the stamping.
  *
- * It used to be owned here, and stamped only by core's `render` — so an app that reached
- * the DOM any other way (`startClient` → `hydrate` → the dom runtime's `render`) got no
+ * It used to be owned here, and stamped only by core's `render`, so an app that reached
+ * the DOM any other way (`startClient` -> `hydrate` -> the dom runtime's `render`) got no
  * version attributes at all. Every SSR app is in that position, including the docs site.
  *
  * The stamping therefore moved down to `@fluixi/dom`, which both paths pass through. The
- * core version cannot be imported from there — core depends on dom, and reversing that is
- * a cycle — so it is pushed down instead, on import.
+ * core version cannot be imported from there: core depends on dom, and reversing that is
+ * a cycle, so it is pushed down instead, on import.
  *
  * Read from a generated constant rather than `package.json`: bundlers and ESM resolvers
  * treat a manifest import inconsistently, and it would pull the whole file into the bundle
@@ -16,6 +16,6 @@
 import { registerCoreVersion } from '@fluixi/dom';
 import { VERSION as CORE } from '../../version.generated.js';
 registerCoreVersion(CORE);
-// Re-exported so existing importers keep working, and so core's own `render` — which does
-// not delegate to the dom runtime's `render` — can still stamp.
+// Re-exported so existing importers keep working, and so core's own `render`, which does
+// not delegate to the dom runtime's `render`: can still stamp.
 export { stampVersions, warnOnVersionSkew, versions } from '@fluixi/dom';

package/dist/src/lib/render/versions.mjs

@@ -1 +1,14 @@
-import{registerCoreVersion as o}from"@fluixi/dom";var r="1.0.0-alpha.82";import{stampVersions as p,warnOnVersionSkew as m,versions as V}from"@fluixi/dom";o(r);export{p as stampVersions,V as versions,m as warnOnVersionSkew};
+// src/lib/render/versions.ts
+import { registerCoreVersion } from "@fluixi/dom";
+
+// src/version.generated.ts
+var VERSION = "1.0.0-alpha.84";
+
+// src/lib/render/versions.ts
+import { stampVersions, warnOnVersionSkew, versions } from "@fluixi/dom";
+registerCoreVersion(VERSION);
+export {
+  stampVersions,
+  versions,
+  warnOnVersionSkew
+};

package/dist/src/lib/router/data.cjs

@@ -1 +1,230 @@
-"use strict";var y=Object.defineProperty;var w=Object.getOwnPropertyDescriptor;var R=Object.getOwnPropertyNames;var D=Object.prototype.hasOwnProperty;var H=(e,t)=>{for(var n in t)y(e,n,{get:t[n],enumerable:!0})},_=(e,t,n,r)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of R(t))!D.call(e,o)&&o!==n&&y(e,o,{get:()=>t[o],enumerable:!(r=w(t,o))||r.enumerable});return e};var E=e=>_(y({},"__esModule",{value:!0}),e);var J={};H(J,{RouteDataContext:()=>T,RouteDataProvider:()=>L,action:()=>b,cache:()=>M,createAsync:()=>$,revalidate:()=>U,useAction:()=>z,useRouteData:()=>W,useSubmission:()=>j});module.exports=E(J);var c=require("@fluixi/reactive/signal");var k=!1,p=new Map;function x(){return k}function m(e,t){p.set(e,t)}function h(e){return p.get(e)}function O(){p.clear()}function I(){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 o=r,i=o.nodeValue||"";(i.startsWith("#")||i.startsWith("/"))&&n.push(o)}n.forEach(o=>o.remove()),O()}typeof window<"u"&&window.addEventListener("load",()=>{setTimeout(I,100)});function v(){return typeof window>"u"}var C=require("@fluixi/dom"),u=require("@fluixi/reactive/signal"),N=require("@fluixi/reactive/signal");function A(e){let t=(0,u.createContext)(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:(0,C.asProvider)(n),defaultValue:e}}function P(e){let t=(0,u.useContext)(e);return t!==void 0?t:e.defaultValue}var d=new Map,a=new Map;function M(e,t){return async(...n)=>{let r=t+":"+JSON.stringify(n);if(x()||typeof window<"u"){let i=h(r);if(i!==void 0)return i}if(d.has(r))return d.get(r);if(a.has(r))return a.get(r);let o=Promise.resolve(e(...n)).then(i=>(d.set(r,i),a.delete(r),v()&&m(r,i),i),i=>{throw a.delete(r),i});return a.set(r,o),o}}var[ee,V]=(0,c.createSignal)(0),F=new Set;function U(e){let t=typeof e=="string"?n=>n.startsWith(e):e;for(let n of d.keys())t(n)&&(d.delete(n),F.add(n));V(n=>n+1)}function $(e,t){let[n]=(0,c.createResource)(t||(()=>!0),e);return n}var g=new Map;function S(e){return g.has(e)||g.set(e,(0,c.createSignal)(void 0)),g.get(e)}function b(e,t){let n=t||e.name||"action",r=async o=>{let[,i]=S(n),l=()=>i(void 0),f=()=>r(o);i({input:o,pending:!0,clear:l,retry:f});try{let s=await e(o);return i({input:o,result:s,pending:!1,clear:l,retry:f}),s}catch(s){throw i({input:o,error:s,pending:!1,clear:l,retry:f}),s}};return r.url=n,r.with=o=>b((...i)=>e(o,...i),t),r}function j(e){let[t]=S(e.url);return t}function z(e){return e}var T=A(),L=T.Provider;function W(){let e=P(T);return typeof e=="function"?e:()=>e}
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/lib/router/data.ts
+var data_exports = {};
+__export(data_exports, {
+  RouteDataContext: () => RouteDataContext,
+  RouteDataProvider: () => RouteDataProvider,
+  action: () => action,
+  cache: () => cache,
+  createAsync: () => createAsync,
+  revalidate: () => revalidate,
+  useAction: () => useAction,
+  useRouteData: () => useRouteData,
+  useSubmission: () => useSubmission
+});
+module.exports = __toCommonJS(data_exports);
+var import_signal3 = require("@fluixi/reactive/signal");
+
+// src/lib/server/hydration.ts
+var import_dom = require("@fluixi/dom");
+var hydrating = false;
+var hydrationDataMap = /* @__PURE__ */ new Map();
+function isHydrating() {
+  return hydrating;
+}
+function setHydrationData(key, data) {
+  hydrationDataMap.set(key, data);
+}
+function getHydrationData(key) {
+  return hydrationDataMap.get(key);
+}
+function clearHydrationData() {
+  hydrationDataMap.clear();
+}
+function cleanupHydration() {
+  if (typeof window === "undefined") {
+    return;
+  }
+  const script = document.getElementById("__FLUIXI_HYDRATION__");
+  if (script) {
+    script.remove();
+  }
+  const walker = document.createTreeWalker(
+    document.body,
+    NodeFilter.SHOW_COMMENT,
+    null
+  );
+  const comments = [];
+  let node;
+  while (node = walker.nextNode()) {
+    const comment = node;
+    const text = comment.nodeValue || "";
+    if (text.startsWith("#") || text.startsWith("/")) {
+      comments.push(comment);
+    }
+  }
+  comments.forEach((comment) => comment.remove());
+  clearHydrationData();
+}
+if (typeof window !== "undefined") {
+  window.addEventListener("load", () => {
+    setTimeout(cleanupHydration, 100);
+  });
+}
+function isServerEnvironment() {
+  return (0, import_dom.isServer)();
+}
+
+// src/lib/context/context.ts
+var import_dom2 = require("@fluixi/dom");
+var import_signal = require("@fluixi/reactive/signal");
+var import_signal2 = require("@fluixi/reactive/signal");
+function createContext(defaultValue, name) {
+  const context = (0, import_signal.createContext)(defaultValue, name);
+  const Provider = (props) => {
+    if (props.debug === true) {
+    }
+    return context.Provider({
+      value: props.value,
+      get children() {
+        return props.children;
+      },
+      debug: props.debug
+    });
+  };
+  if (typeof Symbol !== "undefined" && Symbol.for) {
+    Provider.$$typeof = /* @__PURE__ */ Symbol.for("react.provider");
+  }
+  Provider.$$typeof = /* @__PURE__ */ Symbol.for("react.provider");
+  return {
+    id: context.id,
+    Provider: (0, import_dom2.asProvider)(Provider),
+    defaultValue
+  };
+}
+function useContext(context) {
+  const value = (0, import_signal.useContext)(context);
+  return value !== void 0 ? value : context.defaultValue;
+}
+
+// src/lib/router/data.ts
+var globalCache = /* @__PURE__ */ new Map();
+var inflightRequests = /* @__PURE__ */ new Map();
+function cache(fn, name) {
+  return async (...args) => {
+    const key = name + ":" + JSON.stringify(args);
+    if (isHydrating() || typeof window !== "undefined") {
+      const hydrated = getHydrationData(key);
+      if (hydrated !== void 0) {
+        return hydrated;
+      }
+    }
+    if (globalCache.has(key)) {
+      return globalCache.get(key);
+    }
+    if (inflightRequests.has(key)) {
+      return inflightRequests.get(key);
+    }
+    const promise = Promise.resolve(fn(...args)).then(
+      (val) => {
+        globalCache.set(key, val);
+        inflightRequests.delete(key);
+        if (isServerEnvironment()) {
+          setHydrationData(key, val);
+        }
+        return val;
+      },
+      (err) => {
+        inflightRequests.delete(key);
+        throw err;
+      }
+    );
+    inflightRequests.set(key, promise);
+    return promise;
+  };
+}
+var [revalidationVersion, setRevalidationVersion] = (0, import_signal3.createSignal)(0);
+var revalidationKeys = /* @__PURE__ */ new Set();
+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);
+    }
+  }
+  setRevalidationVersion((v) => v + 1);
+}
+function createAsync(fetcher, source) {
+  const [data] = (0, import_signal3.createResource)(source || (() => true), fetcher);
+  return data;
+}
+var submissionState = /* @__PURE__ */ new Map();
+function getSubmissionSignal(url) {
+  if (!submissionState.has(url)) {
+    submissionState.set(
+      url,
+      (0, import_signal3.createSignal)(void 0)
+    );
+  }
+  return submissionState.get(url);
+}
+function action(fn, name) {
+  const actionUrl = name || fn.name || "action";
+  const submit = async (input) => {
+    const [, setSubmission] = getSubmissionSignal(actionUrl);
+    const clear = () => setSubmission(void 0);
+    const retry = () => submit(input);
+    setSubmission({
+      input,
+      // Approximate type for tracking
+      pending: true,
+      clear,
+      retry
+    });
+    try {
+      const result = await fn(input);
+      setSubmission({
+        input,
+        result,
+        pending: false,
+        clear,
+        retry
+      });
+      return result;
+    } catch (error) {
+      setSubmission({
+        input,
+        error,
+        pending: false,
+        clear,
+        retry
+      });
+      throw error;
+    }
+  };
+  submit.url = actionUrl;
+  submit.with = (args) => action((...a) => fn(args, ...a), name);
+  return submit;
+}
+function useSubmission(actionFn) {
+  const [submission] = getSubmissionSignal(actionFn.url);
+  return submission;
+}
+function useAction(actionFn) {
+  return actionFn;
+}
+var RouteDataContext = createContext(void 0, "route-data");
+var RouteDataProvider = RouteDataContext.Provider;
+function useRouteData() {
+  const ctx = useContext(RouteDataContext);
+  return typeof ctx === "function" ? ctx : () => ctx;
+}

package/dist/src/lib/router/data.d.ts

@@ -1,5 +1,4 @@
 /**
- * @fileoverview Data fetching and caching primitives for Fluixi Router
  * @module @fluixi/core/router/data
  */
 import { type Accessor, Resource } from '@fluixi/reactive/signal';
@@ -24,30 +23,19 @@ export interface Submission<T, Args extends any[]> {
  * - Deduplication
  * - Hydration (Server -> Client)
  * - Revalidation
- *
- * @param fn Async function to cache
- * @param name Unique name for the cache key
  */
 export declare function cache<T, Args extends any[]>(fn: (...args: Args) => Promise<T> | T, name: string): (...args: Args) => Promise<T>;
 /**
  * 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 declare function revalidate(key: string | ((key: string) => boolean)): void;
 /**
  * Create an async resource from a promise or cache function
- *
- * @param fetcher Function that returns a promise
- * @param source Dependency signal (optional)
  */
 export declare function createAsync<T, S extends any = true>(fetcher: (source: S) => Promise<T> | T, source?: () => S): Resource<S>;
 /**
  * Create a server action
- *
- * @param fn Function to execute (server-side)
- * @param name Action name
  */
 export declare function action<T, Args extends any[]>(fn: (...args: Args) => Promise<T> | T, name?: string): Action<T, Args>;
 /**
@@ -60,7 +48,7 @@ export declare function useSubmission<T, Args extends any[]>(actionFn: Action<T,
 export declare function useAction<T, Args extends any[]>(actionFn: Action<T, Args>): (...args: Args) => Promise<T>;
 export interface RouteDataArgs {
     /**
-     * Route params — either a reactive signal accessor (when called from the
+     * Route params, either a reactive signal accessor (when called from the
      * router's createRoot during layout creation) or a plain snapshot object
      * (legacy / manual usage). Always normalise with:
      *   `const getParams = typeof args.params === 'function' ? args.params : () => args.params;`

package/dist/src/lib/router/data.d.ts.map

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

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

@@ -1,5 +1,4 @@
 /**
- * @fileoverview Data fetching and caching primitives for Fluixi Router
  * @module @fluixi/core/router/data
  */
 import { createResource, createSignal } from '@fluixi/reactive/signal';
@@ -17,9 +16,6 @@ const inflightRequests = new Map();
  * - 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) => {
@@ -65,8 +61,6 @@ 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;
@@ -84,9 +78,6 @@ export function revalidate(key) {
 // ============================================================================
 /**
  * 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);
@@ -105,9 +96,6 @@ function getSubmissionSignal(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';
@@ -163,7 +151,7 @@ export function useSubmission(actionFn) {
 export function useAction(actionFn) {
     return actionFn;
 }
-export const RouteDataContext = createContext();
+export const RouteDataContext = createContext(undefined, 'route-data');
 export const RouteDataProvider = RouteDataContext.Provider;
 /**
  * Access the data returned by the nearest ancestor route's `routeData` export.

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

@@ -1 +1,214 @@
-import{createResource as D,createSignal as h}from"@fluixi/reactive/signal";var A=!1,l=new Map;function y(){return A}function p(e,r){l.set(e,r)}function g(e){return l.get(e)}function P(){l.clear()}function S(){if(typeof window>"u")return;let e=document.getElementById("__FLUIXI_HYDRATION__");e&&e.remove();let r=document.createTreeWalker(document.body,NodeFilter.SHOW_COMMENT,null),n=[],t;for(;t=r.nextNode();){let i=t,o=i.nodeValue||"";(o.startsWith("#")||o.startsWith("/"))&&n.push(i)}n.forEach(i=>i.remove()),P()}typeof window<"u"&&window.addEventListener("load",()=>{setTimeout(S,100)});function T(){return typeof window>"u"}import{asProvider as b}from"@fluixi/dom";import{createContext as w,useContext as R}from"@fluixi/reactive/signal";import{readChildren as F}from"@fluixi/reactive/signal";function x(e){let r=w(e),n=t=>(t.debug,r.Provider({value:t.value,get children(){return t.children},debug:t.debug}));return typeof Symbol<"u"&&Symbol.for&&(n.$$typeof=Symbol.for("react.provider")),n.$$typeof=Symbol.for("react.provider"),{id:r.id,Provider:b(n),defaultValue:e}}function m(e){let r=R(e);return r!==void 0?r:e.defaultValue}var d=new Map,a=new Map;function W(e,r){return async(...n)=>{let t=r+":"+JSON.stringify(n);if(y()||typeof window<"u"){let o=g(t);if(o!==void 0)return o}if(d.has(t))return d.get(t);if(a.has(t))return a.get(t);let i=Promise.resolve(e(...n)).then(o=>(d.set(t,o),a.delete(t),T()&&p(t,o),o),o=>{throw a.delete(t),o});return a.set(t,i),i}}var[J,H]=h(0),_=new Set;function X(e){let r=typeof e=="string"?n=>n.startsWith(e):e;for(let n of d.keys())r(n)&&(d.delete(n),_.add(n));H(n=>n+1)}function B(e,r){let[n]=D(r||(()=>!0),e);return n}var f=new Map;function v(e){return f.has(e)||f.set(e,h(void 0)),f.get(e)}function E(e,r){let n=r||e.name||"action",t=async i=>{let[,o]=v(n),c=()=>o(void 0),u=()=>t(i);o({input:i,pending:!0,clear:c,retry:u});try{let s=await e(i);return o({input:i,result:s,pending:!1,clear:c,retry:u}),s}catch(s){throw o({input:i,error:s,pending:!1,clear:c,retry:u}),s}};return t.url=n,t.with=i=>E((...o)=>e(i,...o),r),t}function Y(e){let[r]=v(e.url);return r}function K(e){return e}var C=x(),q=C.Provider;function G(){let e=m(C);return typeof e=="function"?e:()=>e}export{C as RouteDataContext,q as RouteDataProvider,E as action,W as cache,B as createAsync,X as revalidate,K as useAction,G as useRouteData,Y as useSubmission};
+// src/lib/router/data.ts
+import {
+  createResource,
+  createSignal
+} from "@fluixi/reactive/signal";
+
+// src/lib/server/hydration.ts
+import { isServer as domIsServer } from "@fluixi/dom";
+var hydrating = false;
+var hydrationDataMap = /* @__PURE__ */ new Map();
+function isHydrating() {
+  return hydrating;
+}
+function setHydrationData(key, data) {
+  hydrationDataMap.set(key, data);
+}
+function getHydrationData(key) {
+  return hydrationDataMap.get(key);
+}
+function clearHydrationData() {
+  hydrationDataMap.clear();
+}
+function cleanupHydration() {
+  if (typeof window === "undefined") {
+    return;
+  }
+  const script = document.getElementById("__FLUIXI_HYDRATION__");
+  if (script) {
+    script.remove();
+  }
+  const walker = document.createTreeWalker(
+    document.body,
+    NodeFilter.SHOW_COMMENT,
+    null
+  );
+  const comments = [];
+  let node;
+  while (node = walker.nextNode()) {
+    const comment = node;
+    const text = comment.nodeValue || "";
+    if (text.startsWith("#") || text.startsWith("/")) {
+      comments.push(comment);
+    }
+  }
+  comments.forEach((comment) => comment.remove());
+  clearHydrationData();
+}
+if (typeof window !== "undefined") {
+  window.addEventListener("load", () => {
+    setTimeout(cleanupHydration, 100);
+  });
+}
+function isServerEnvironment() {
+  return domIsServer();
+}
+
+// src/lib/context/context.ts
+import { asProvider } from "@fluixi/dom";
+import { createContext as createReactiveContext, useContext as useReactiveContext } from "@fluixi/reactive/signal";
+import {
+  readChildren
+} from "@fluixi/reactive/signal";
+function createContext(defaultValue, name) {
+  const context = createReactiveContext(defaultValue, name);
+  const Provider = (props) => {
+    if (props.debug === true) {
+    }
+    return context.Provider({
+      value: props.value,
+      get children() {
+        return props.children;
+      },
+      debug: props.debug
+    });
+  };
+  if (typeof Symbol !== "undefined" && Symbol.for) {
+    Provider.$$typeof = /* @__PURE__ */ Symbol.for("react.provider");
+  }
+  Provider.$$typeof = /* @__PURE__ */ Symbol.for("react.provider");
+  return {
+    id: context.id,
+    Provider: asProvider(Provider),
+    defaultValue
+  };
+}
+function useContext(context) {
+  const value = useReactiveContext(context);
+  return value !== void 0 ? value : context.defaultValue;
+}
+
+// src/lib/router/data.ts
+var globalCache = /* @__PURE__ */ new Map();
+var inflightRequests = /* @__PURE__ */ new Map();
+function cache(fn, name) {
+  return async (...args) => {
+    const key = name + ":" + JSON.stringify(args);
+    if (isHydrating() || typeof window !== "undefined") {
+      const hydrated = getHydrationData(key);
+      if (hydrated !== void 0) {
+        return hydrated;
+      }
+    }
+    if (globalCache.has(key)) {
+      return globalCache.get(key);
+    }
+    if (inflightRequests.has(key)) {
+      return inflightRequests.get(key);
+    }
+    const promise = Promise.resolve(fn(...args)).then(
+      (val) => {
+        globalCache.set(key, val);
+        inflightRequests.delete(key);
+        if (isServerEnvironment()) {
+          setHydrationData(key, val);
+        }
+        return val;
+      },
+      (err) => {
+        inflightRequests.delete(key);
+        throw err;
+      }
+    );
+    inflightRequests.set(key, promise);
+    return promise;
+  };
+}
+var [revalidationVersion, setRevalidationVersion] = createSignal(0);
+var revalidationKeys = /* @__PURE__ */ new Set();
+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);
+    }
+  }
+  setRevalidationVersion((v) => v + 1);
+}
+function createAsync(fetcher, source) {
+  const [data] = createResource(source || (() => true), fetcher);
+  return data;
+}
+var submissionState = /* @__PURE__ */ new Map();
+function getSubmissionSignal(url) {
+  if (!submissionState.has(url)) {
+    submissionState.set(
+      url,
+      createSignal(void 0)
+    );
+  }
+  return submissionState.get(url);
+}
+function action(fn, name) {
+  const actionUrl = name || fn.name || "action";
+  const submit = async (input) => {
+    const [, setSubmission] = getSubmissionSignal(actionUrl);
+    const clear = () => setSubmission(void 0);
+    const retry = () => submit(input);
+    setSubmission({
+      input,
+      // Approximate type for tracking
+      pending: true,
+      clear,
+      retry
+    });
+    try {
+      const result = await fn(input);
+      setSubmission({
+        input,
+        result,
+        pending: false,
+        clear,
+        retry
+      });
+      return result;
+    } catch (error) {
+      setSubmission({
+        input,
+        error,
+        pending: false,
+        clear,
+        retry
+      });
+      throw error;
+    }
+  };
+  submit.url = actionUrl;
+  submit.with = (args) => action((...a) => fn(args, ...a), name);
+  return submit;
+}
+function useSubmission(actionFn) {
+  const [submission] = getSubmissionSignal(actionFn.url);
+  return submission;
+}
+function useAction(actionFn) {
+  return actionFn;
+}
+var RouteDataContext = createContext(void 0, "route-data");
+var RouteDataProvider = RouteDataContext.Provider;
+function useRouteData() {
+  const ctx = useContext(RouteDataContext);
+  return typeof ctx === "function" ? ctx : () => ctx;
+}
+export {
+  RouteDataContext,
+  RouteDataProvider,
+  action,
+  cache,
+  createAsync,
+  revalidate,
+  useAction,
+  useRouteData,
+  useSubmission
+};