@mmstack/primitives 19.5.1 → 19.5.2

package/lib/stored.d.ts

@@ -1,4 +1,5 @@
-import { type CreateSignalOptions, type Signal, type WritableSignal } from '@angular/core';
+import { Injector, type CreateSignalOptions, type Signal, type WritableSignal } from '@angular/core';
+import { type PauseOption } from './concurrent/pausable';
 /**
  * Interface for storage mechanisms compatible with the `stored` signal.
  * Matches the essential parts of the `Storage` interface (`localStorage`, `sessionStorage`).
@@ -65,6 +66,18 @@ export type CreateStoredOptions<T> = CreateSignalOptions<T> & {
      * Optional validator, which is called on load of value. Store will be set to fallback if value is false
      */
     validate?: (value: T) => boolean;
+    /**
+     * Opt-in pause: gate the persistence effect on an ambient Activity boundary (`true`), a custom
+     * predicate, or `false` (default — no pausing). While paused the value stays live; persistence is
+     * skipped and flushes the latest value on resume. The inbound `storage` listener stays live.
+     * See {@link PauseOption}.
+     */
+    pause?: PauseOption;
+    /**
+     * Injector used when `stored` is created outside an injection context, and to resolve the ambient
+     * pause boundary when `pause` is `true`.
+     */
+    injector?: Injector;
 };
 /**
  * A specialized `WritableSignal` returned by the `stored()` function.
@@ -136,5 +149,5 @@ export type StoredSignal<T> = WritableSignal<T> & {
  * }
  * ```
  */
-export declare function stored<T>(fallback: T, { key, store: providedStore, serialize, deserialize, syncTabs, equal, onKeyChange, cleanupOldKey, validate, ...rest }: CreateStoredOptions<T>): StoredSignal<T>;
+export declare function stored<T>(fallback: T, { key, store: providedStore, serialize, deserialize, syncTabs, equal, onKeyChange, cleanupOldKey, validate, pause, injector: providedInjector, ...rest }: CreateStoredOptions<T>): StoredSignal<T>;
 export {};

package/lib/tab-sync.d.ts

@@ -1,4 +1,4 @@
-import { type OnDestroy, type WritableSignal } from '@angular/core';
+import { Injector, type OnDestroy, type WritableSignal } from '@angular/core';
 import * as i0 from "@angular/core";
 export declare class MessageBus implements OnDestroy {
     private readonly channel;
@@ -22,6 +22,14 @@ type LegacySyncSignalOptions = {
 };
 export type SyncSignalOptions = {
     id: string;
+    /**
+     * Injector used when `tabSync` is called outside an injection context.
+     *
+     * NOTE: `tabSync` is intentionally NOT pausable. Pausing the outbound broadcast would let its
+     * mount-time echo guard swallow a value changed while hidden, so other tabs would silently miss
+     * it — a cross-tab consistency gap not worth the negligible saving. The channel stays live.
+     */
+    injector?: Injector;
 };
 /**
  * @example tabSync(signal('dark'), { id: 'theme' })

package/lib/throttled.d.ts

@@ -37,12 +37,16 @@ export type CreateThrottledOptions<T> = CreateSignalOptions<T> & {
 /**
  * A specialized `WritableSignal` whose publicly readable value updates are throttled.
  *
- * It provides access to the underlying, non-throttled signal via the `original` property.
+ * Provides access to the underlying, non-throttled signal via `original`, and a
+ * `flush()` that emits the current value immediately (clearing any open window) —
+ * useful for terminal transitions that shouldn't wait for the trailing edge.
  *
  * @template T The type of value held by the signal.
- * @see {DebouncedSignal} as the output type has the same structure.
  */
-export type ThrottledSignal<T> = DebouncedSignal<T>;
+export type ThrottledSignal<T> = DebouncedSignal<T> & {
+    /** Emit the latest value now, bypassing the remaining throttle window. */
+    flush: () => void;
+};
 /**
  * A convenience function that creates and throttles a new `WritableSignal` in one step.
  *
@@ -63,7 +67,7 @@ export type ThrottledSignal<T> = DebouncedSignal<T>;
  * // With a trailing-edge throttle, the final value 'c' would be set
  * // after the 500ms cooldown.
  */
-export declare function throttled<T>(initial: T, opt?: CreateThrottledOptions<T>): DebouncedSignal<T>;
+export declare function throttled<T>(initial: T, opt?: CreateThrottledOptions<T>): ThrottledSignal<T>;
 /**
  * Wraps an existing `WritableSignal` to create a new one whose readable value is throttled.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mmstack/primitives",
-  "version": "19.5.1",
+  "version": "19.5.2",
   "keywords": [
     "angular",
     "signals",