@mmstack/primitives 21.0.15 → 21.0.17

package/package.json

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

package/types/mmstack-primitives.d.ts

@@ -1331,32 +1331,61 @@ type Sensors<TKey extends keyof SensorTypedOptions> = {
 };
 declare function sensors<const TType extends keyof SensorTypedOptions>(track: TType[], opt?: SensorsOptions<TType>): Sensors<TType>;
 
-type BaseType = string | number | boolean | symbol | undefined | null | Function | Date | RegExp | any[];
+type BaseType = string | number | boolean | symbol | undefined | null | Function | Date | RegExp;
 type Key = string | number;
 type AnyRecord = Record<Key, any>;
-
-type SignalStore<T> = Signal<T> & (NonNullable<T> extends BaseType ? unknown : Readonly<{
+/**
+ * @internal
+ * Validates whether a value is a Signal Store.
+ */
+declare function isStore<T>(value: unknown): value is SignalStore<T>;
+type SignalArrayStore<T extends any[]> = Signal<T> & {
+    readonly [index: number]: SignalStore<T[number]>;
+    readonly length: Signal<number>;
+    [Symbol.iterator](): Iterator<SignalStore<T[number]>>;
+};
+type WritableArrayStore<T extends any[]> = WritableSignal<T> & {
+    readonly asReadonlyStore: () => SignalArrayStore<T>;
+    readonly [index: number]: WritableSignalStore<T[number]>;
+    readonly length: Signal<number>;
+    [Symbol.iterator](): Iterator<WritableSignalStore<T[number]>>;
+};
+type MutableArrayStore<T extends any[]> = MutableSignal<T> & {
+    readonly asReadonlyStore: () => SignalArrayStore<T>;
+    readonly [index: number]: MutableSignalStore<T[number]>;
+    readonly length: Signal<number>;
+    [Symbol.iterator](): Iterator<MutableSignalStore<T[number]>>;
+};
+type SignalStore<T> = Signal<T> & (NonNullable<T> extends BaseType ? unknown : NonNullable<T> extends Array<any> ? SignalArrayStore<NonNullable<T>> : Readonly<{
     [K in keyof Required<T>]: SignalStore<NonNullable<T>[K]>;
 }>);
 type WritableSignalStore<T> = WritableSignal<T> & {
     readonly asReadonlyStore: () => SignalStore<T>;
-} & (NonNullable<T> extends BaseType ? unknown : Readonly<{
+} & (NonNullable<T> extends BaseType ? unknown : NonNullable<T> extends Array<any> ? WritableArrayStore<NonNullable<T>> : Readonly<{
     [K in keyof Required<T>]: WritableSignalStore<NonNullable<T>[K]>;
 }>);
 type MutableSignalStore<T> = MutableSignal<T> & {
     readonly asReadonlyStore: () => SignalStore<T>;
-} & (NonNullable<T> extends BaseType ? unknown : Readonly<{
+} & (NonNullable<T> extends BaseType ? unknown : NonNullable<T> extends Array<any> ? MutableArrayStore<NonNullable<T>> : Readonly<{
     [K in keyof Required<T>]: MutableSignalStore<NonNullable<T>[K]>;
 }>);
-/**
- * Validates whether a value is a Signal Store.
- */
-declare function isStore<T>(value: unknown): value is SignalStore<T>;
 declare function toStore<T extends AnyRecord>(source: MutableSignal<T>, injector?: Injector): MutableSignalStore<T>;
 declare function toStore<T extends AnyRecord>(source: WritableSignal<T>, injector?: Injector): WritableSignalStore<T>;
 declare function toStore<T extends AnyRecord>(source: Signal<T>, injector?: Injector): SignalStore<T>;
-declare function store<T extends AnyRecord>(value: T, opt?: CreateSignalOptions<T>): WritableSignalStore<T>;
-declare function mutableStore<T extends AnyRecord>(value: T, opt?: CreateSignalOptions<T>): MutableSignalStore<T>;
+/**
+ * Creates a WritableSignalStore from a value.
+ * @see {@link toStore}
+ */
+declare function store<T extends AnyRecord>(value: T, opt?: CreateSignalOptions<T> & {
+    injector?: Injector;
+}): WritableSignalStore<T>;
+/**
+ * Creates a MutableSignalStore from a value.
+ * @see {@link toStore}
+ */
+declare function mutableStore<T extends AnyRecord>(value: T, opt?: CreateSignalOptions<T> & {
+    injector?: Injector;
+}): MutableSignalStore<T>;
 
 /**
  * Interface for storage mechanisms compatible with the `stored` signal.