@absolutejs/absolute 0.19.0-beta.962 → 0.19.0-beta.964

package/dist/src/angular/browser.d.ts

@@ -3,7 +3,7 @@ export { ABSOLUTE_HTTP_TRANSFER_CACHE_SKIP_HEADER, buildAbsoluteHttpTransferCach
 export { createDeterministicRandom, DETERMINISTIC_NOW, DETERMINISTIC_RANDOM, DETERMINISTIC_SEED, provideDeterministicEnv } from './deterministicEnv';
 export { defineAngularPage } from './page';
 export { useResource, useSubscription, useTimers } from './composables';
-export type { Observer, Resource, ResourceFetcher, ResourceOptions } from './composables';
+export type { Observer, Resource, ResourceFetcher, ResourceMutator, ResourceOptions, ResourceStart } from './composables';
 export { preserveAcrossHmr } from './preserveAcrossHmr';
 export { Island } from './Island.browser';
 export { withPendingTask } from './pendingTask';

package/dist/src/angular/composables/index.d.ts

@@ -1,5 +1,5 @@
 export { useResource } from './useResource';
-export type { Resource, ResourceFetcher, ResourceOptions } from './useResource';
+export type { Resource, ResourceFetcher, ResourceMutator, ResourceOptions, ResourceStart } from './useResource';
 export { useSubscription } from './useSubscription';
 export type { Observer } from './useSubscription';
 export { useTimers } from './useTimers';

package/dist/src/angular/composables/useResource.d.ts

@@ -1,21 +1,42 @@
 import { type Signal } from '@angular/core';
 export type ResourceFetcher<T> = (signal: AbortSignal) => Promise<T>;
+/** Controls the resource's startup behavior.
+ *
+ *  - `'immediate'` (default) — fire the fetcher synchronously at creation;
+ *    `loading()` starts `true`.
+ *  - `'pending'` — don't fire the fetcher yet, but render as if a fetch is
+ *    coming: `loading()` starts `true`. Pair with a manual `refresh()` call
+ *    from `ngOnInit` (or wherever the dependencies become available). Use
+ *    this when the fetcher depends on state set after construction (e.g. a
+ *    route param assigned by the page factory) — it avoids the blank-frame
+ *    flash you'd get from `'idle'`.
+ *  - `'idle'` — don't fire the fetcher and don't pretend you will:
+ *    `loading()` starts `false`. The resource is dormant until `refresh()`
+ *    or `mutate()` is called.
+ */
+export type ResourceStart = 'immediate' | 'pending' | 'idle';
 export type ResourceOptions = {
-    /** Run the fetcher immediately on creation. Default: true. Pass
-     *  `false` to defer the first load until `refresh()` is called. */
-    immediate?: boolean;
+    /** When and how the fetcher fires on creation. Default: `'immediate'`. */
+    start?: ResourceStart;
 };
+export type ResourceMutator<T> = T | null | ((prev: T | null) => T | null);
 export type Resource<T> = {
     /** Latest resolved value, or `null` before the first successful load. */
     data: Signal<T | null>;
     /** Latest rejection reason, or `null` when the resource is healthy. */
     error: Signal<unknown>;
-    /** True while a fetch is in flight. */
+    /** True while a fetch is in flight, or when `start: 'pending'` was set
+     *  and `refresh()` hasn't been called yet. */
     loading: Signal<boolean>;
     /** Re-runs the fetcher. Any in-flight request is aborted first. */
     refresh: () => Promise<void>;
     /** Aborts the in-flight request, if any. No-op otherwise. */
     cancel: () => void;
+    /** Imperatively write the data signal without re-fetching. Accepts a
+     *  new value or an updater function. Use after an edit action returns
+     *  the new entity, so you avoid a wasteful re-fetch. Pending fetches
+     *  are aborted so a slower response can't clobber the mutation. */
+    mutate: (next: ResourceMutator<T>) => void;
 };
 /** Signal-backed async data composable. Replaces the React
  *  `useEffect(() => { fetch(); }, [])` + `useState` pair with a single

package/dist/src/angular/index.d.ts

@@ -5,7 +5,7 @@ export { createDeterministicRandom, DETERMINISTIC_NOW, DETERMINISTIC_RANDOM, DET
 export { handleAngularPageRequest } from './pageHandler';
 export { defineAngularPage } from './page';
 export { useResource, useSubscription, useTimers } from './composables';
-export type { Observer, Resource, ResourceFetcher, ResourceOptions } from './composables';
+export type { Observer, Resource, ResourceFetcher, ResourceMutator, ResourceOptions, ResourceStart } from './composables';
 export { preserveAcrossHmr } from './preserveAcrossHmr';
 export { withPendingTask } from './pendingTask';
 export { createTypedIsland } from './createIsland';

package/package.json

@@ -402,5 +402,5 @@
 			]
 		}
 	},
-	"version": "0.19.0-beta.962"
+	"version": "0.19.0-beta.964"
 }