@mmstack/primitives 19.4.0 → 19.4.2

package/lib/store/store.d.ts

@@ -68,7 +68,7 @@ export type Opaque<T> = T & {
     readonly [OPAQUE]: true;
 };
 /** @internal Strips the opaque brand from the value a leaf signal carries. */
-export type UnwrapOpqaue<T> = T extends {
+export type UnwrapOpaque<T> = T extends {
     readonly [OPAQUE]: true;
 } ? Omit<T, typeof OPAQUE> : T;
 type BaseType = string | number | boolean | symbol | bigint | undefined | null | Function | Date | RegExp | {
@@ -155,15 +155,15 @@ type MutableSignalStoreObject<T> = Simplify<Readonly<{
         <L extends AnyRecord>(props: L): MutableSignalStore<Simplify<Omit<NonNullable<T>, keyof L> & L>>;
     };
 }>;
-export type SignalStore<T> = Signal<UnwrapOpqaue<T>> & (IsAny<T> extends true ? SignalStoreObject<T> : NonNullable<T> extends BaseType ? {
+export type SignalStore<T> = Signal<UnwrapOpaque<T>> & (IsAny<T> extends true ? SignalStoreObject<T> : NonNullable<T> extends BaseType ? {
     readonly [LEAF]: () => boolean;
 } : NonNullable<T> extends any[] ? SignalArrayStore<NonNullable<T>> : SignalStoreObject<T>);
-export type WritableSignalStore<T> = WritableSignal<UnwrapOpqaue<T>> & {
+export type WritableSignalStore<T> = WritableSignal<UnwrapOpaque<T>> & {
     readonly asReadonlyStore: () => SignalStore<T>;
 } & (IsAny<T> extends true ? WritableSignalStoreObject<T> : NonNullable<T> extends BaseType ? {
     readonly [LEAF]: () => boolean;
 } : NonNullable<T> extends any[] ? WritableArrayStore<NonNullable<T>> : WritableSignalStoreObject<T>);
-export type MutableSignalStore<T> = MutableSignal<UnwrapOpqaue<T>> & {
+export type MutableSignalStore<T> = MutableSignal<UnwrapOpaque<T>> & {
     readonly asReadonlyStore: () => SignalStore<T>;
 } & (IsAny<T> extends true ? MutableSignalStoreObject<T> : NonNullable<T> extends BaseType ? {
     readonly [LEAF]: () => boolean;

package/lib/stored.d.ts

@@ -95,8 +95,8 @@ export type StoredSignal<T> = WritableSignal<T> & {
  *
  * @template T The type of value held by the signal and stored (after serialization).
  * @param fallback The default value of type `T` to use when no value is found in storage
- * or when deserialization fails. The signal's value will never be `null` or `undefined`
- * publicly, it will always revert to this fallback.
+ * or when deserialization fails. A stored value (including a legitimate `null` for a
+ * nullable `T`) always round-trips; the fallback only surfaces when the entry is absent.
  * @param options Configuration options (`CreateStoredOptions<T>`). Requires at least the `key`.
  * @returns A `StoredSignal<T>` instance. This signal behaves like a standard `WritableSignal<T>`,
  * but its value is persisted. It includes a `.clear()` method to remove the item from storage
@@ -109,7 +109,8 @@ export type StoredSignal<T> = WritableSignal<T> & {
  * - **Error Handling:** Catches and logs errors during serialization/deserialization in dev mode.
  * - **Tab Sync:** If `syncTabs` is true, listens to `storage` events to keep the signal value
  * consistent across browser tabs using the same key. Cleanup is handled automatically
- * using `DestroyRef`.
+ * using `DestroyRef`. Web Storage only: the `storage` event never fires for custom `store`
+ * adapters, so `syncTabs` has no effect with one.
  * - **Removal:** Use the `.clear()` method on the returned signal to remove the item from storage.
  * Setting the signal to the fallback value will store the fallback value, not remove the item.
  *

package/lib/{tabSync.d.ts → tab-sync.d.ts}

@@ -1,16 +1,21 @@
-import { type WritableSignal } from '@angular/core';
+import { type OnDestroy, type WritableSignal } from '@angular/core';
 import * as i0 from "@angular/core";
-export declare class MessageBus {
+export declare class MessageBus implements OnDestroy {
     private readonly channel;
     private readonly listeners;
     subscribe<T>(id: string, listener: (data: T) => void): {
         unsub: () => void;
         post: (value: T) => void;
     };
-    private unsubscribe;
+    ngOnDestroy(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<MessageBus, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<MessageBus>;
 }
+/**
+ * @deprecated The generated id hashes the call-site stack line, which collides when a shared
+ * helper calls {@link tabSync} for multiple signals and diverges across minified builds during
+ * a rolling deploy. Pass an explicit `{ id }` instead.
+ */
 export declare function generateDeterministicID(): string;
 type LegacySyncSignalOptions = {
     id?: string;
@@ -19,7 +24,7 @@ export type SyncSignalOptions = {
     id: string;
 };
 /**
- * @example tabSync(signal('dark), {id: 'theme})
+ * @example tabSync(signal('dark'), { id: 'theme' })
  */
 export declare function tabSync<T extends WritableSignal<any>>(sig: T, opt: SyncSignalOptions | string): T;
 /**

package/lib/throttled.d.ts

@@ -28,6 +28,8 @@ export type CreateThrottledOptions<T> = CreateSignalOptions<T> & {
     /**
      * If `true`, the throttled signal emits the latest pending value at the end
      * of each cooldown window (only when at least one write occurred during it).
+     * Note: with both `leading` and `trailing` set to `false` the throttled view
+     * never updates (writes still reach `.original`).
      * @default true
      */
     trailing?: boolean;

package/lib/to-writable.d.ts

@@ -31,6 +31,10 @@ export declare function toWritable<T>(source: Signal<T>, set: (value: T) => void
     /**
      * If `true` (the default), the returned signal will be a computed signal that depends on the source signal.
      * If `false`, the returned signal will be a direct wrapper around the source signal without creating a new computed signal.
+     *
+     * CAUTION: with `pure: false` the `set`/`update`/`asReadonly` methods are patched directly
+     * onto the signal object you passed in — every other holder of that signal sees it become
+     * writable. Only use it with a signal you created and own exclusively.
      * @default true
      */
     pure?: boolean;

package/package.json

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