@flurryx/store 0.8.3 → 0.8.4

package/dist/index.d.cts

@@ -1,9 +1,15 @@
 import { Signal, InjectionToken } from '@angular/core';
 import { ResourceState, KeyedResourceKey } from '@flurryx/core';
 
+/**
+ * Constraint type ensuring every key in a store data map holds a {@link ResourceState}.
+ */
 type StoreDataShape<TData> = {
     [K in keyof TData]: ResourceState<unknown>;
 };
+/**
+ * Extracts the string-typed keys from a store data map.
+ */
 type StoreKey<TData> = keyof TData & string;
 /**
  * Phantom-typed marker for a store resource slot.
@@ -40,35 +46,124 @@ type ConfigToData<TConfig extends object> = {
 };
 /**
  * Shared store interface implemented by both BaseStore and LazyStore.
+ *
+ * All store instances expose these methods regardless of how they were created
+ * (interface-based, fluent, or enum-constrained builder).
  */
 interface IStore<TData extends StoreDataShape<TData>> {
+    /** Returns a read-only `Signal` for the given slot. */
     get<K extends StoreKey<TData>>(key: K): Signal<TData[K]>;
+    /** Merges a partial state into the given slot (immutable spread). */
     update<K extends StoreKey<TData>>(key: K, newState: Partial<TData[K]>): void;
+    /** Resets a slot to its initial idle state (`{ data: undefined, isLoading: false, … }`). */
     clear<K extends StoreKey<TData>>(key: K): void;
+    /** Resets every slot in this store. */
     clearAll(): void;
+    /** Marks a slot as loading: sets `isLoading: true` and clears `status`/`errors`. */
     startLoading<K extends StoreKey<TData>>(key: K): void;
+    /** Marks a slot as no longer loading: sets `isLoading: false`. */
     stopLoading<K extends StoreKey<TData>>(key: K): void;
+    /** Merges a single entity into a keyed slot and sets its status to `'Success'`. */
     updateKeyedOne<K extends StoreKey<TData>>(key: K, resourceKey: KeyedResourceKey, entity: unknown): void;
+    /** Removes a single entity (and its loading/status/errors) from a keyed slot. */
     clearKeyedOne<K extends StoreKey<TData>>(key: K, resourceKey: KeyedResourceKey): void;
+    /** Marks a single entity within a keyed slot as loading. */
     startKeyedLoading<K extends StoreKey<TData>>(key: K, resourceKey: KeyedResourceKey): void;
+    /**
+     * Registers a callback invoked whenever the given slot is updated.
+     * @returns A cleanup function that removes the listener.
+     */
     onUpdate<K extends StoreKey<TData>>(key: K, callback: (state: TData[K], previousState: TData[K]) => void): () => void;
 }
 
+/**
+ * Abstract base class for flurryx stores.
+ *
+ * Backed by Angular `signal()` per slot, providing read-only `Signal` access
+ * and immutable updates. All writes go through the store's own methods to
+ * enforce single-owner encapsulation.
+ *
+ * Use the {@link Store} builder to create instances — do not subclass directly.
+ *
+ * @template TEnum - Record mapping slot names to their string/number keys.
+ * @template TData - Record mapping slot names to `ResourceState<T>` types.
+ */
 declare abstract class BaseStore<TEnum extends Record<string, string | number>, TData extends {
     [K in keyof TEnum]: ResourceState<unknown>;
 }> implements IStore<TData> {
     protected readonly storeEnum: TEnum;
     private readonly signalsState;
     protected constructor(storeEnum: TEnum);
+    /**
+     * Returns a **read-only** `Signal` for the given store slot.
+     *
+     * @param key - The slot name to read.
+     * @returns A `Signal` wrapping the slot's current {@link ResourceState}.
+     */
     get<K extends keyof TData>(key: K): Signal<TData[K]>;
+    /**
+     * Registers a callback fired after every `update` or `clear` on the given slot.
+     *
+     * @param key - The slot to watch.
+     * @param callback - Receives the new state and the previous state.
+     * @returns A cleanup function that removes the listener when called.
+     */
     onUpdate<K extends keyof TData>(key: K, callback: (state: TData[K], previousState: TData[K]) => void): () => void;
+    /**
+     * Partially updates a slot by merging `newState` into the current value (immutable spread).
+     *
+     * @param key - The slot to update.
+     * @param newState - Partial state to merge (e.g. `{ data: newData, status: 'Success' }`).
+     */
     update<K extends keyof TData>(key: K, newState: Partial<TData[K]>): void;
+    /** Resets every slot in this store to its initial idle state. */
     clearAll(): void;
+    /**
+     * Resets a single slot to `{ data: undefined, isLoading: false, status: undefined, errors: undefined }`.
+     *
+     * @param key - The slot to clear.
+     */
     clear<K extends keyof TData>(key: K): void;
+    /**
+     * Marks a slot as loading: sets `isLoading: true` and clears `status` and `errors`.
+     *
+     * @param key - The slot to mark as loading.
+     */
     startLoading<K extends keyof TData>(key: K): void;
+    /**
+     * Marks a slot as no longer loading: sets `isLoading: false`.
+     * Does **not** clear `status` or `errors`.
+     *
+     * @param key - The slot to stop loading.
+     */
     stopLoading<K extends keyof TData>(key: K): void;
+    /**
+     * Merges a single entity into a {@link KeyedResourceData} slot.
+     * Sets its status to `'Success'` and clears per-key errors.
+     * The top-level `isLoading` is recalculated based on remaining loading keys.
+     *
+     * @param key - The keyed slot name.
+     * @param resourceKey - The entity identifier (e.g. `'inv-123'`).
+     * @param entity - The entity value to store.
+     */
     updateKeyedOne<K extends keyof TData>(key: K, resourceKey: KeyedResourceKey, entity: unknown): void;
+    /**
+     * Removes a single entity from a {@link KeyedResourceData} slot,
+     * including its loading flag, status, and errors.
+     * Recalculates the top-level `isLoading` from the remaining keys.
+     *
+     * @param key - The keyed slot name.
+     * @param resourceKey - The entity identifier to remove.
+     */
     clearKeyedOne<K extends keyof TData>(key: K, resourceKey: KeyedResourceKey): void;
+    /**
+     * Marks a single entity within a keyed slot as loading.
+     * Clears its status and errors. If the slot data is not yet a {@link KeyedResourceData},
+     * falls back to `startLoading(key)`.
+     *
+     * @param key - The keyed slot name.
+     * @param resourceKey - The entity identifier to mark as loading.
+     */
     startKeyedLoading<K extends keyof TData>(key: K, resourceKey: KeyedResourceKey): void;
     private notifyUpdateHooks;
     private initializeState;
@@ -105,15 +200,42 @@ interface AsStep<TAccum extends StoreConfig, TKey extends string> {
 }
 /**
  * Fluent builder for creating stores.
- * Accumulates resource definitions then produces an InjectionToken on .build().
+ * Accumulates resource definitions then produces an `InjectionToken` on `.build()`.
  */
 interface StoreBuilder<TAccum extends StoreConfig> {
+    /** Define a new resource slot. Chain `.as<T>()` to set its type. */
     resource<TKey extends string>(key: TKey): AsStep<TAccum, TKey>;
+    /**
+     * Mirror a slot from another store. When the source updates, the target is kept in sync.
+     *
+     * @param source - The source store's `InjectionToken`.
+     * @param sourceKey - The key to watch on the source store.
+     * @param targetKey - The key on this store to write to. Defaults to `sourceKey`.
+     */
     mirror<TSourceData extends StoreDataShape<TSourceData>>(source: InjectionToken<IStore<TSourceData>>, sourceKey: StoreKey<TSourceData>, targetKey?: StoreKey<TAccum>): StoreBuilder<TAccum>;
+    /**
+     * Mirror one slot to another **within the same store**.
+     * Source and target keys must be different.
+     *
+     * @param sourceKey - The slot to read from.
+     * @param targetKey - The slot to write to.
+     */
     mirrorSelf(sourceKey: StoreKey<TAccum>, targetKey: StoreKey<TAccum>): StoreBuilder<TAccum>;
+    /**
+     * Accumulate single-entity fetches from a source store into a `KeyedResourceData` slot.
+     *
+     * @param source - The source store's `InjectionToken`.
+     * @param sourceKey - The single-entity key on the source store.
+     * @param options - Must include `extractId` to derive the entity's key from its data.
+     * @param targetKey - The keyed slot on this store. Defaults to `sourceKey`.
+     */
     mirrorKeyed<TSourceData extends StoreDataShape<TSourceData>, TEntity>(source: InjectionToken<IStore<TSourceData>>, sourceKey: StoreKey<TSourceData>, options: {
         extractId: (data: TEntity | undefined) => KeyedResourceKey | undefined;
     }, targetKey?: StoreKey<TAccum>): StoreBuilder<TAccum>;
+    /**
+     * Finalize the builder and create an `InjectionToken` (`providedIn: 'root'`).
+     * All mirrors are wired up automatically when Angular creates the store.
+     */
     build(): InjectionToken<BaseStore<InferEnum<TAccum>, InferData<TAccum>>>;
 }
 /** Keys from the enum that have NOT yet been defined. */
@@ -197,9 +319,31 @@ interface StoreEntry {
  */
 declare const Store: StoreEntry;
 
+/**
+ * Clears every store instance tracked by flurryx.
+ *
+ * Calls `clearAll()` on each registered store, resetting all slots to their
+ * initial idle state. Useful for logout, tenant switching, or test cleanup.
+ *
+ * @example
+ * ```ts
+ * import { clearAllStores } from 'flurryx';
+ *
+ * logout() {
+ *   clearAllStores();
+ * }
+ * ```
+ */
 declare function clearAllStores(): void;
 
+/**
+ * Options for {@link mirrorKey}.
+ */
 interface MirrorOptions {
+    /**
+     * Angular `DestroyRef` (or any object with an `onDestroy` method) for
+     * automatic cleanup. When provided, the mirror stops when the ref is destroyed.
+     */
     destroyRef?: {
         onDestroy: (fn: () => void) => void;
     };
@@ -217,8 +361,21 @@ interface MirrorOptions {
  */
 declare function mirrorKey<TSource extends StoreDataShape<TSource>, TTarget extends StoreDataShape<TTarget>>(source: IStore<TSource>, sourceKey: StoreKey<TSource>, target: IStore<TTarget>, targetKeyOrOptions?: StoreKey<TTarget> | MirrorOptions, options?: MirrorOptions): () => void;
 
+/**
+ * Options for {@link collectKeyed}.
+ *
+ * @template TEntity - The entity type emitted by the source store.
+ */
 interface CollectKeyedOptions<TEntity> {
+    /**
+     * Extracts the entity identifier from the source data.
+     * Return `undefined` to skip accumulation for that emission.
+     */
     extractId: (data: TEntity | undefined) => KeyedResourceKey | undefined;
+    /**
+     * Angular `DestroyRef` (or any object with an `onDestroy` method) for
+     * automatic cleanup. When provided, collection stops when the ref is destroyed.
+     */
     destroyRef?: {
         onDestroy: (fn: () => void) => void;
     };

package/dist/index.d.ts

@@ -1,9 +1,15 @@
 import { Signal, InjectionToken } from '@angular/core';
 import { ResourceState, KeyedResourceKey } from '@flurryx/core';
 
+/**
+ * Constraint type ensuring every key in a store data map holds a {@link ResourceState}.
+ */
 type StoreDataShape<TData> = {
     [K in keyof TData]: ResourceState<unknown>;
 };
+/**
+ * Extracts the string-typed keys from a store data map.
+ */
 type StoreKey<TData> = keyof TData & string;
 /**
  * Phantom-typed marker for a store resource slot.
@@ -40,35 +46,124 @@ type ConfigToData<TConfig extends object> = {
 };
 /**
  * Shared store interface implemented by both BaseStore and LazyStore.
+ *
+ * All store instances expose these methods regardless of how they were created
+ * (interface-based, fluent, or enum-constrained builder).
  */
 interface IStore<TData extends StoreDataShape<TData>> {
+    /** Returns a read-only `Signal` for the given slot. */
     get<K extends StoreKey<TData>>(key: K): Signal<TData[K]>;
+    /** Merges a partial state into the given slot (immutable spread). */
     update<K extends StoreKey<TData>>(key: K, newState: Partial<TData[K]>): void;
+    /** Resets a slot to its initial idle state (`{ data: undefined, isLoading: false, … }`). */
     clear<K extends StoreKey<TData>>(key: K): void;
+    /** Resets every slot in this store. */
     clearAll(): void;
+    /** Marks a slot as loading: sets `isLoading: true` and clears `status`/`errors`. */
     startLoading<K extends StoreKey<TData>>(key: K): void;
+    /** Marks a slot as no longer loading: sets `isLoading: false`. */
     stopLoading<K extends StoreKey<TData>>(key: K): void;
+    /** Merges a single entity into a keyed slot and sets its status to `'Success'`. */
     updateKeyedOne<K extends StoreKey<TData>>(key: K, resourceKey: KeyedResourceKey, entity: unknown): void;
+    /** Removes a single entity (and its loading/status/errors) from a keyed slot. */
     clearKeyedOne<K extends StoreKey<TData>>(key: K, resourceKey: KeyedResourceKey): void;
+    /** Marks a single entity within a keyed slot as loading. */
     startKeyedLoading<K extends StoreKey<TData>>(key: K, resourceKey: KeyedResourceKey): void;
+    /**
+     * Registers a callback invoked whenever the given slot is updated.
+     * @returns A cleanup function that removes the listener.
+     */
     onUpdate<K extends StoreKey<TData>>(key: K, callback: (state: TData[K], previousState: TData[K]) => void): () => void;
 }
 
+/**
+ * Abstract base class for flurryx stores.
+ *
+ * Backed by Angular `signal()` per slot, providing read-only `Signal` access
+ * and immutable updates. All writes go through the store's own methods to
+ * enforce single-owner encapsulation.
+ *
+ * Use the {@link Store} builder to create instances — do not subclass directly.
+ *
+ * @template TEnum - Record mapping slot names to their string/number keys.
+ * @template TData - Record mapping slot names to `ResourceState<T>` types.
+ */
 declare abstract class BaseStore<TEnum extends Record<string, string | number>, TData extends {
     [K in keyof TEnum]: ResourceState<unknown>;
 }> implements IStore<TData> {
     protected readonly storeEnum: TEnum;
     private readonly signalsState;
     protected constructor(storeEnum: TEnum);
+    /**
+     * Returns a **read-only** `Signal` for the given store slot.
+     *
+     * @param key - The slot name to read.
+     * @returns A `Signal` wrapping the slot's current {@link ResourceState}.
+     */
     get<K extends keyof TData>(key: K): Signal<TData[K]>;
+    /**
+     * Registers a callback fired after every `update` or `clear` on the given slot.
+     *
+     * @param key - The slot to watch.
+     * @param callback - Receives the new state and the previous state.
+     * @returns A cleanup function that removes the listener when called.
+     */
     onUpdate<K extends keyof TData>(key: K, callback: (state: TData[K], previousState: TData[K]) => void): () => void;
+    /**
+     * Partially updates a slot by merging `newState` into the current value (immutable spread).
+     *
+     * @param key - The slot to update.
+     * @param newState - Partial state to merge (e.g. `{ data: newData, status: 'Success' }`).
+     */
     update<K extends keyof TData>(key: K, newState: Partial<TData[K]>): void;
+    /** Resets every slot in this store to its initial idle state. */
     clearAll(): void;
+    /**
+     * Resets a single slot to `{ data: undefined, isLoading: false, status: undefined, errors: undefined }`.
+     *
+     * @param key - The slot to clear.
+     */
     clear<K extends keyof TData>(key: K): void;
+    /**
+     * Marks a slot as loading: sets `isLoading: true` and clears `status` and `errors`.
+     *
+     * @param key - The slot to mark as loading.
+     */
     startLoading<K extends keyof TData>(key: K): void;
+    /**
+     * Marks a slot as no longer loading: sets `isLoading: false`.
+     * Does **not** clear `status` or `errors`.
+     *
+     * @param key - The slot to stop loading.
+     */
     stopLoading<K extends keyof TData>(key: K): void;
+    /**
+     * Merges a single entity into a {@link KeyedResourceData} slot.
+     * Sets its status to `'Success'` and clears per-key errors.
+     * The top-level `isLoading` is recalculated based on remaining loading keys.
+     *
+     * @param key - The keyed slot name.
+     * @param resourceKey - The entity identifier (e.g. `'inv-123'`).
+     * @param entity - The entity value to store.
+     */
     updateKeyedOne<K extends keyof TData>(key: K, resourceKey: KeyedResourceKey, entity: unknown): void;
+    /**
+     * Removes a single entity from a {@link KeyedResourceData} slot,
+     * including its loading flag, status, and errors.
+     * Recalculates the top-level `isLoading` from the remaining keys.
+     *
+     * @param key - The keyed slot name.
+     * @param resourceKey - The entity identifier to remove.
+     */
     clearKeyedOne<K extends keyof TData>(key: K, resourceKey: KeyedResourceKey): void;
+    /**
+     * Marks a single entity within a keyed slot as loading.
+     * Clears its status and errors. If the slot data is not yet a {@link KeyedResourceData},
+     * falls back to `startLoading(key)`.
+     *
+     * @param key - The keyed slot name.
+     * @param resourceKey - The entity identifier to mark as loading.
+     */
     startKeyedLoading<K extends keyof TData>(key: K, resourceKey: KeyedResourceKey): void;
     private notifyUpdateHooks;
     private initializeState;
@@ -105,15 +200,42 @@ interface AsStep<TAccum extends StoreConfig, TKey extends string> {
 }
 /**
  * Fluent builder for creating stores.
- * Accumulates resource definitions then produces an InjectionToken on .build().
+ * Accumulates resource definitions then produces an `InjectionToken` on `.build()`.
  */
 interface StoreBuilder<TAccum extends StoreConfig> {
+    /** Define a new resource slot. Chain `.as<T>()` to set its type. */
     resource<TKey extends string>(key: TKey): AsStep<TAccum, TKey>;
+    /**
+     * Mirror a slot from another store. When the source updates, the target is kept in sync.
+     *
+     * @param source - The source store's `InjectionToken`.
+     * @param sourceKey - The key to watch on the source store.
+     * @param targetKey - The key on this store to write to. Defaults to `sourceKey`.
+     */
     mirror<TSourceData extends StoreDataShape<TSourceData>>(source: InjectionToken<IStore<TSourceData>>, sourceKey: StoreKey<TSourceData>, targetKey?: StoreKey<TAccum>): StoreBuilder<TAccum>;
+    /**
+     * Mirror one slot to another **within the same store**.
+     * Source and target keys must be different.
+     *
+     * @param sourceKey - The slot to read from.
+     * @param targetKey - The slot to write to.
+     */
     mirrorSelf(sourceKey: StoreKey<TAccum>, targetKey: StoreKey<TAccum>): StoreBuilder<TAccum>;
+    /**
+     * Accumulate single-entity fetches from a source store into a `KeyedResourceData` slot.
+     *
+     * @param source - The source store's `InjectionToken`.
+     * @param sourceKey - The single-entity key on the source store.
+     * @param options - Must include `extractId` to derive the entity's key from its data.
+     * @param targetKey - The keyed slot on this store. Defaults to `sourceKey`.
+     */
     mirrorKeyed<TSourceData extends StoreDataShape<TSourceData>, TEntity>(source: InjectionToken<IStore<TSourceData>>, sourceKey: StoreKey<TSourceData>, options: {
         extractId: (data: TEntity | undefined) => KeyedResourceKey | undefined;
     }, targetKey?: StoreKey<TAccum>): StoreBuilder<TAccum>;
+    /**
+     * Finalize the builder and create an `InjectionToken` (`providedIn: 'root'`).
+     * All mirrors are wired up automatically when Angular creates the store.
+     */
     build(): InjectionToken<BaseStore<InferEnum<TAccum>, InferData<TAccum>>>;
 }
 /** Keys from the enum that have NOT yet been defined. */
@@ -197,9 +319,31 @@ interface StoreEntry {
  */
 declare const Store: StoreEntry;
 
+/**
+ * Clears every store instance tracked by flurryx.
+ *
+ * Calls `clearAll()` on each registered store, resetting all slots to their
+ * initial idle state. Useful for logout, tenant switching, or test cleanup.
+ *
+ * @example
+ * ```ts
+ * import { clearAllStores } from 'flurryx';
+ *
+ * logout() {
+ *   clearAllStores();
+ * }
+ * ```
+ */
 declare function clearAllStores(): void;
 
+/**
+ * Options for {@link mirrorKey}.
+ */
 interface MirrorOptions {
+    /**
+     * Angular `DestroyRef` (or any object with an `onDestroy` method) for
+     * automatic cleanup. When provided, the mirror stops when the ref is destroyed.
+     */
     destroyRef?: {
         onDestroy: (fn: () => void) => void;
     };
@@ -217,8 +361,21 @@ interface MirrorOptions {
  */
 declare function mirrorKey<TSource extends StoreDataShape<TSource>, TTarget extends StoreDataShape<TTarget>>(source: IStore<TSource>, sourceKey: StoreKey<TSource>, target: IStore<TTarget>, targetKeyOrOptions?: StoreKey<TTarget> | MirrorOptions, options?: MirrorOptions): () => void;
 
+/**
+ * Options for {@link collectKeyed}.
+ *
+ * @template TEntity - The entity type emitted by the source store.
+ */
 interface CollectKeyedOptions<TEntity> {
+    /**
+     * Extracts the entity identifier from the source data.
+     * Return `undefined` to skip accumulation for that emission.
+     */
     extractId: (data: TEntity | undefined) => KeyedResourceKey | undefined;
+    /**
+     * Angular `DestroyRef` (or any object with an `onDestroy` method) for
+     * automatic cleanup. When provided, collection stops when the ref is destroyed.
+     */
     destroyRef?: {
         onDestroy: (fn: () => void) => void;
     };

package/dist/index.js

@@ -27,9 +27,22 @@ var BaseStore = class {
     trackStore(this);
   }
   signalsState = /* @__PURE__ */ new Map();
+  /**
+   * Returns a **read-only** `Signal` for the given store slot.
+   *
+   * @param key - The slot name to read.
+   * @returns A `Signal` wrapping the slot's current {@link ResourceState}.
+   */
   get(key) {
     return this.signalsState.get(key.toString());
   }
+  /**
+   * Registers a callback fired after every `update` or `clear` on the given slot.
+   *
+   * @param key - The slot to watch.
+   * @param callback - Receives the new state and the previous state.
+   * @returns A cleanup function that removes the listener when called.
+   */
   onUpdate(key, callback) {
     const hooks = updateHooksMap.get(this);
     if (!hooks.has(key)) {
@@ -51,6 +64,12 @@ var BaseStore = class {
       }
     };
   }
+  /**
+   * Partially updates a slot by merging `newState` into the current value (immutable spread).
+   *
+   * @param key - The slot to update.
+   * @param newState - Partial state to merge (e.g. `{ data: newData, status: 'Success' }`).
+   */
   update(key, newState) {
     const currentState = this.signalsState.get(key.toString());
     if (!currentState) {
@@ -64,11 +83,17 @@ var BaseStore = class {
     const updatedState = currentState();
     this.notifyUpdateHooks(key, updatedState, previousState);
   }
+  /** Resets every slot in this store to its initial idle state. */
   clearAll() {
     Object.keys(this.storeEnum).forEach((key) => {
       this.clear(key);
     });
   }
+  /**
+   * Resets a single slot to `{ data: undefined, isLoading: false, status: undefined, errors: undefined }`.
+   *
+   * @param key - The slot to clear.
+   */
   clear(key) {
     const currentState = this.signalsState.get(key.toString());
     if (!currentState) {
@@ -85,6 +110,11 @@ var BaseStore = class {
     const nextState = currentState();
     this.notifyUpdateHooks(key, nextState, previousState);
   }
+  /**
+   * Marks a slot as loading: sets `isLoading: true` and clears `status` and `errors`.
+   *
+   * @param key - The slot to mark as loading.
+   */
   startLoading(key) {
     const currentState = this.signalsState.get(key.toString());
     if (!currentState) {
@@ -100,6 +130,12 @@ var BaseStore = class {
       })
     );
   }
+  /**
+   * Marks a slot as no longer loading: sets `isLoading: false`.
+   * Does **not** clear `status` or `errors`.
+   *
+   * @param key - The slot to stop loading.
+   */
   stopLoading(key) {
     const currentState = this.signalsState.get(key.toString());
     if (!currentState) {
@@ -113,6 +149,15 @@ var BaseStore = class {
       })
     );
   }
+  /**
+   * Merges a single entity into a {@link KeyedResourceData} slot.
+   * Sets its status to `'Success'` and clears per-key errors.
+   * The top-level `isLoading` is recalculated based on remaining loading keys.
+   *
+   * @param key - The keyed slot name.
+   * @param resourceKey - The entity identifier (e.g. `'inv-123'`).
+   * @param entity - The entity value to store.
+   */
   updateKeyedOne(key, resourceKey, entity) {
     const currentState = this.signalsState.get(key.toString());
     if (!currentState) {
@@ -145,6 +190,14 @@ var BaseStore = class {
       errors: void 0
     });
   }
+  /**
+   * Removes a single entity from a {@link KeyedResourceData} slot,
+   * including its loading flag, status, and errors.
+   * Recalculates the top-level `isLoading` from the remaining keys.
+   *
+   * @param key - The keyed slot name.
+   * @param resourceKey - The entity identifier to remove.
+   */
   clearKeyedOne(key, resourceKey) {
     const currentState = this.signalsState.get(key.toString());
     if (!currentState) {
@@ -184,6 +237,14 @@ var BaseStore = class {
     const updatedState = currentState();
     this.notifyUpdateHooks(key, updatedState, previousState);
   }
+  /**
+   * Marks a single entity within a keyed slot as loading.
+   * Clears its status and errors. If the slot data is not yet a {@link KeyedResourceData},
+   * falls back to `startLoading(key)`.
+   *
+   * @param key - The keyed slot name.
+   * @param resourceKey - The entity identifier to mark as loading.
+   */
   startKeyedLoading(key, resourceKey) {
     const currentState = this.signalsState.get(key.toString());
     if (!currentState) {
@@ -497,9 +558,15 @@ function collectKeyed(source, sourceKey, target, targetKeyOrOptions, options) {
       return;
     }
     if (resourceState.status === "Success" && currentId !== void 0) {
-      const newEntities = { ...currentKeyed.entities, [currentId]: resourceState.data };
+      const newEntities = {
+        ...currentKeyed.entities,
+        [currentId]: resourceState.data
+      };
       const newIsLoading = { ...currentKeyed.isLoading, [currentId]: false };
-      const newStatus = { ...currentKeyed.status, [currentId]: resourceState.status };
+      const newStatus = {
+        ...currentKeyed.status,
+        [currentId]: resourceState.status
+      };
       const newErrors = { ...currentKeyed.errors };
       delete newErrors[currentId];
       const updatedKeyed = {
@@ -516,8 +583,14 @@ function collectKeyed(source, sourceKey, target, targetKeyOrOptions, options) {
       previousId = currentId;
     } else if (resourceState.status === "Error" && currentId !== void 0) {
       const newIsLoading = { ...currentKeyed.isLoading, [currentId]: false };
-      const newStatus = { ...currentKeyed.status, [currentId]: resourceState.status };
-      const newErrors = { ...currentKeyed.errors, [currentId]: resourceState.errors };
+      const newStatus = {
+        ...currentKeyed.status,
+        [currentId]: resourceState.status
+      };
+      const newErrors = {
+        ...currentKeyed.errors,
+        [currentId]: resourceState.errors
+      };
       const updatedKeyed = {
         entities: { ...currentKeyed.entities },
         isLoading: newIsLoading,