@getforma/core 0.9.1 → 1.0.1

package/dist/resource-Cd0cGOxS.d.ts

@@ -0,0 +1,62 @@
+import { S as SignalGetter } from './signal-YlS1kgfh.js';
+
+/**
+ * Forma Reactive - Resource
+ *
+ * Async data fetching primitive with reactive loading/error state.
+ * Tracks a source signal and refetches when it changes.
+ *
+ * SolidJS equivalent: createResource
+ * React equivalent: use() + Suspense (React 19), or useSWR/react-query
+ */
+
+interface Resource<T> {
+    /** The resolved data (or undefined while loading). */
+    (): T | undefined;
+    /** True while the fetcher is running. */
+    loading: SignalGetter<boolean>;
+    /** The error if the fetcher rejected (or undefined). */
+    error: SignalGetter<unknown>;
+    /** Manually refetch with the current source value. */
+    refetch: () => void;
+    /** Manually set the data (overrides fetcher result). */
+    mutate: (value: T | undefined) => void;
+}
+interface ResourceOptions<T> {
+    /** Initial value before first fetch resolves. */
+    initialValue?: T;
+}
+/**
+ * Create an async resource that fetches data reactively.
+ *
+ * When `source` changes, the fetcher re-runs automatically.
+ * Provides reactive `loading` and `error` signals.
+ *
+ * ```ts
+ * const [userId, setUserId] = createSignal(1);
+ *
+ * const user = createResource(
+ *   userId,                                    // source signal
+ *   (id) => fetch(`/api/users/${id}`).then(r => r.json()), // fetcher
+ * );
+ *
+ * internalEffect(() => {
+ *   if (user.loading()) console.log('Loading...');
+ *   else if (user.error()) console.log('Error:', user.error());
+ *   else console.log('User:', user());
+ * });
+ *
+ * setUserId(2); // automatically refetches
+ * ```
+ *
+ * Without a source signal (static fetch):
+ * ```ts
+ * const posts = createResource(
+ *   () => true,  // constant source — fetches once
+ *   () => fetch('/api/posts').then(r => r.json()),
+ * );
+ * ```
+ */
+declare function createResource<T, S = true>(source: SignalGetter<S>, fetcher: (source: S) => Promise<T>, options?: ResourceOptions<T>): Resource<T>;
+
+export { type Resource as R, type ResourceOptions as a, createResource as c };

package/dist/resource-DK98lW5e.d.cts

@@ -0,0 +1,62 @@
+import { S as SignalGetter } from './signal-YlS1kgfh.cjs';
+
+/**
+ * Forma Reactive - Resource
+ *
+ * Async data fetching primitive with reactive loading/error state.
+ * Tracks a source signal and refetches when it changes.
+ *
+ * SolidJS equivalent: createResource
+ * React equivalent: use() + Suspense (React 19), or useSWR/react-query
+ */
+
+interface Resource<T> {
+    /** The resolved data (or undefined while loading). */
+    (): T | undefined;
+    /** True while the fetcher is running. */
+    loading: SignalGetter<boolean>;
+    /** The error if the fetcher rejected (or undefined). */
+    error: SignalGetter<unknown>;
+    /** Manually refetch with the current source value. */
+    refetch: () => void;
+    /** Manually set the data (overrides fetcher result). */
+    mutate: (value: T | undefined) => void;
+}
+interface ResourceOptions<T> {
+    /** Initial value before first fetch resolves. */
+    initialValue?: T;
+}
+/**
+ * Create an async resource that fetches data reactively.
+ *
+ * When `source` changes, the fetcher re-runs automatically.
+ * Provides reactive `loading` and `error` signals.
+ *
+ * ```ts
+ * const [userId, setUserId] = createSignal(1);
+ *
+ * const user = createResource(
+ *   userId,                                    // source signal
+ *   (id) => fetch(`/api/users/${id}`).then(r => r.json()), // fetcher
+ * );
+ *
+ * internalEffect(() => {
+ *   if (user.loading()) console.log('Loading...');
+ *   else if (user.error()) console.log('Error:', user.error());
+ *   else console.log('User:', user());
+ * });
+ *
+ * setUserId(2); // automatically refetches
+ * ```
+ *
+ * Without a source signal (static fetch):
+ * ```ts
+ * const posts = createResource(
+ *   () => true,  // constant source — fetches once
+ *   () => fetch('/api/posts').then(r => r.json()),
+ * );
+ * ```
+ */
+declare function createResource<T, S = true>(source: SignalGetter<S>, fetcher: (source: S) => Promise<T>, options?: ResourceOptions<T>): Resource<T>;
+
+export { type Resource as R, type ResourceOptions as a, createResource as c };