@cajoa/core 0.12.1 → 0.13.0

package/dist/index.cjs

@@ -29,6 +29,7 @@ __export(index_exports, {
   createContext: () => createContext,
   createEffect: () => createEffect,
   createMemo: () => createMemo,
+  createResource: () => createResource,
   createRoot: () => createRoot,
   createSignal: () => createSignal,
   getRenderer: () => getRenderer,
@@ -259,6 +260,84 @@ function createMemo(fn) {
   return value;
 }
 
+// src/reactivity/resource.ts
+function isPromiseLike(value) {
+  return typeof value?.then === "function";
+}
+function createResource(a, b) {
+  const hasSource = typeof b === "function";
+  const source = hasSource ? a : () => true;
+  const fetcher = hasSource ? b : a;
+  const [data, setData] = createSignal(void 0);
+  const [failure, setFailure] = createSignal(null);
+  const [loading, setLoading] = createSignal(false);
+  const [version, setVersion] = createSignal(0);
+  let run = 0;
+  const finish = (id, outcome) => {
+    if (id !== run) return;
+    batch(() => {
+      setLoading(false);
+      if ("error" in outcome) {
+        setFailure({ error: outcome.error });
+      } else {
+        setFailure(null);
+        setData(() => outcome.value);
+      }
+    });
+  };
+  createEffect(() => {
+    const s = source();
+    version();
+    run++;
+    const id = run;
+    onCleanup(() => {
+      run++;
+    });
+    if (s === false || s === null || s === void 0) {
+      batch(() => {
+        setLoading(false);
+        setFailure(null);
+        setData(() => void 0);
+      });
+      return;
+    }
+    setLoading(true);
+    setFailure(null);
+    let result;
+    try {
+      result = untrack(() => fetcher(s));
+    } catch (error) {
+      finish(id, { error });
+      return;
+    }
+    if (isPromiseLike(result)) {
+      result.then(
+        (value) => finish(id, { value }),
+        (error) => finish(id, { error })
+      );
+    } else {
+      finish(id, { value: result });
+    }
+  });
+  const resource = (() => {
+    const failed = failure();
+    if (failed) throw failed.error;
+    return data();
+  });
+  resource.loading = loading;
+  resource.error = () => failure()?.error;
+  return [
+    resource,
+    {
+      refetch: () => setVersion((v) => v + 1),
+      mutate: (value) => batch(() => {
+        setFailure(null);
+        setData(() => value);
+      })
+    }
+  ];
+}
+
 // src/renderer/index.ts
 var current = null;
 function setRenderer(renderer) {
@@ -483,6 +562,7 @@ function Fragment(props) {
   createContext,
   createEffect,
   createMemo,
+  createResource,
   createRoot,
   createSignal,
   getRenderer,

package/dist/index.d.cts

@@ -17,6 +17,19 @@ declare function useContext<T>(ctx: Context<T>): T;
 
 declare function createMemo<T>(fn: () => T): () => T;
 
+interface Resource<T> {
+    (): T | undefined;
+    loading: () => boolean;
+    error: () => unknown;
+}
+interface ResourceActions<T> {
+    refetch: () => void;
+    mutate(value: T | undefined): void;
+}
+type ResourceTuple<T> = [Resource<T>, ResourceActions<T>];
+declare function createResource<T>(fetcher: () => T | Promise<T>): ResourceTuple<T>;
+declare function createResource<T, S>(source: () => S | false | null | undefined, fetcher: (source: S) => T | Promise<T>): ResourceTuple<T>;
+
 type HostNode = object;
 interface Renderer<N = any> {
     createElement(tag: string): N;
@@ -76,5 +89,5 @@ declare function Fragment(props: {
 declare function setRenderer(renderer: Renderer): void;
 declare function getRenderer(): Renderer;
 
-export { ErrorBoundary, For, Fragment, JSX, Show, batch, catchError, createContext, createEffect, createMemo, createRoot, createSignal, getRenderer, h, jsx, jsxDEV, jsxs, onCleanup, onMount, provide, render, setRenderer, untrack, useContext };
-export type { Child, Context, HostNode, Renderer };
+export { ErrorBoundary, For, Fragment, JSX, Show, batch, catchError, createContext, createEffect, createMemo, createResource, createRoot, createSignal, getRenderer, h, jsx, jsxDEV, jsxs, onCleanup, onMount, provide, render, setRenderer, untrack, useContext };
+export type { Child, Context, HostNode, Renderer, Resource, ResourceActions };

package/dist/index.d.ts

@@ -17,6 +17,19 @@ declare function useContext<T>(ctx: Context<T>): T;
 
 declare function createMemo<T>(fn: () => T): () => T;
 
+interface Resource<T> {
+    (): T | undefined;
+    loading: () => boolean;
+    error: () => unknown;
+}
+interface ResourceActions<T> {
+    refetch: () => void;
+    mutate(value: T | undefined): void;
+}
+type ResourceTuple<T> = [Resource<T>, ResourceActions<T>];
+declare function createResource<T>(fetcher: () => T | Promise<T>): ResourceTuple<T>;
+declare function createResource<T, S>(source: () => S | false | null | undefined, fetcher: (source: S) => T | Promise<T>): ResourceTuple<T>;
+
 type HostNode = object;
 interface Renderer<N = any> {
     createElement(tag: string): N;
@@ -76,5 +89,5 @@ declare function Fragment(props: {
 declare function setRenderer(renderer: Renderer): void;
 declare function getRenderer(): Renderer;
 
-export { ErrorBoundary, For, Fragment, JSX, Show, batch, catchError, createContext, createEffect, createMemo, createRoot, createSignal, getRenderer, h, jsx, jsxDEV, jsxs, onCleanup, onMount, provide, render, setRenderer, untrack, useContext };
-export type { Child, Context, HostNode, Renderer };
+export { ErrorBoundary, For, Fragment, JSX, Show, batch, catchError, createContext, createEffect, createMemo, createResource, createRoot, createSignal, getRenderer, h, jsx, jsxDEV, jsxs, onCleanup, onMount, provide, render, setRenderer, untrack, useContext };
+export type { Child, Context, HostNode, Renderer, Resource, ResourceActions };

package/dist/index.js

@@ -211,6 +211,84 @@ function createMemo(fn) {
   return value;
 }
 
+// src/reactivity/resource.ts
+function isPromiseLike(value) {
+  return typeof value?.then === "function";
+}
+function createResource(a, b) {
+  const hasSource = typeof b === "function";
+  const source = hasSource ? a : () => true;
+  const fetcher = hasSource ? b : a;
+  const [data, setData] = createSignal(void 0);
+  const [failure, setFailure] = createSignal(null);
+  const [loading, setLoading] = createSignal(false);
+  const [version, setVersion] = createSignal(0);
+  let run = 0;
+  const finish = (id, outcome) => {
+    if (id !== run) return;
+    batch(() => {
+      setLoading(false);
+      if ("error" in outcome) {
+        setFailure({ error: outcome.error });
+      } else {
+        setFailure(null);
+        setData(() => outcome.value);
+      }
+    });
+  };
+  createEffect(() => {
+    const s = source();
+    version();
+    run++;
+    const id = run;
+    onCleanup(() => {
+      run++;
+    });
+    if (s === false || s === null || s === void 0) {
+      batch(() => {
+        setLoading(false);
+        setFailure(null);
+        setData(() => void 0);
+      });
+      return;
+    }
+    setLoading(true);
+    setFailure(null);
+    let result;
+    try {
+      result = untrack(() => fetcher(s));
+    } catch (error) {
+      finish(id, { error });
+      return;
+    }
+    if (isPromiseLike(result)) {
+      result.then(
+        (value) => finish(id, { value }),
+        (error) => finish(id, { error })
+      );
+    } else {
+      finish(id, { value: result });
+    }
+  });
+  const resource = (() => {
+    const failed = failure();
+    if (failed) throw failed.error;
+    return data();
+  });
+  resource.loading = loading;
+  resource.error = () => failure()?.error;
+  return [
+    resource,
+    {
+      refetch: () => setVersion((v) => v + 1),
+      mutate: (value) => batch(() => {
+        setFailure(null);
+        setData(() => value);
+      })
+    }
+  ];
+}
+
 // src/renderer/index.ts
 var current = null;
 function setRenderer(renderer) {
@@ -434,6 +512,7 @@ export {
   createContext,
   createEffect,
   createMemo,
+  createResource,
   createRoot,
   createSignal,
   getRenderer,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cajoa/core",
-  "version": "0.12.1",
+  "version": "0.13.0",
   "description": "Cajoa core: signals, JSX runtime and the renderer interface.",
   "type": "module",
   "main": "./dist/index.cjs",