@oscarpalmer/mora 0.30.0 → 0.31.0

package/dist/constants.d.mts

@@ -11,9 +11,10 @@ declare const NAME_ARRAY = "array";
 declare const NAME_COMPUTED = "computed";
 declare const NAME_EFFECT = "effect";
 declare const NAME_MORA = "$mora";
+declare const NAME_READONLY = "readonly";
 declare const NAME_SIGNAL = "signal";
 declare const NAME_STORE = "store";
 declare const NAME_ALL: Set<string>;
 declare const PROPERTY_LENGTH = "length";
 //#endregion
-export { ACTIVE, ARRAY_OFFSET, ARRAY_PEEK, ARRAY_THRESHOLD, BATCH, METHODS_AFFECTING_LENGTH, METHODS_UPDATE, NAME_ALL, NAME_ARRAY, NAME_COMPUTED, NAME_EFFECT, NAME_MORA, NAME_SIGNAL, NAME_STORE, PROPERTY_LENGTH };
+export { ACTIVE, ARRAY_OFFSET, ARRAY_PEEK, ARRAY_THRESHOLD, BATCH, METHODS_AFFECTING_LENGTH, METHODS_UPDATE, NAME_ALL, NAME_ARRAY, NAME_COMPUTED, NAME_EFFECT, NAME_MORA, NAME_READONLY, NAME_SIGNAL, NAME_STORE, PROPERTY_LENGTH };

package/dist/constants.mjs

@@ -26,14 +26,16 @@ const NAME_ARRAY = "array";
 const NAME_COMPUTED = "computed";
 const NAME_EFFECT = "effect";
 const NAME_MORA = "$mora";
+const NAME_READONLY = "readonly";
 const NAME_SIGNAL = "signal";
 const NAME_STORE = "store";
 const NAME_ALL = /* @__PURE__ */ new Set([
 	NAME_ARRAY,
 	NAME_COMPUTED,
+	NAME_READONLY,
 	NAME_SIGNAL,
 	NAME_STORE
 ]);
 const PROPERTY_LENGTH = "length";
 //#endregion
-export { ACTIVE, ARRAY_OFFSET, ARRAY_PEEK, ARRAY_THRESHOLD, BATCH, METHODS_AFFECTING_LENGTH, METHODS_UPDATE, NAME_ALL, NAME_ARRAY, NAME_COMPUTED, NAME_EFFECT, NAME_MORA, NAME_SIGNAL, NAME_STORE, PROPERTY_LENGTH };
+export { ACTIVE, ARRAY_OFFSET, ARRAY_PEEK, ARRAY_THRESHOLD, BATCH, METHODS_AFFECTING_LENGTH, METHODS_UPDATE, NAME_ALL, NAME_ARRAY, NAME_COMPUTED, NAME_EFFECT, NAME_MORA, NAME_READONLY, NAME_SIGNAL, NAME_STORE, PROPERTY_LENGTH };

package/dist/helpers/is.d.mts

@@ -1,13 +1,6 @@
-import { Computed, Effect, Reactive, ReactiveArray, ReactiveStore, Signal } from "../models.mjs";
+import { Computed, Effect, Reactive, ReactiveArray, ReactiveStore, ReadonlySignal, Signal } from "../models.mjs";
 import { PlainObject } from "@oscarpalmer/atoms/models";
 //#region src/helpers/is.d.ts
-/**
- * Is the value a reactive array?
- *
- * @param value Value to check
- * @returns True if value is a {@link ReactiveArray}
- */
-declare function isArray<Item>(value: unknown): value is ReactiveArray<Item>;
 /**
  * Is the value a computed signal?
  *
@@ -36,12 +29,20 @@ declare function isReactive<Value>(value: unknown): value is Reactive<Value>;
  * @returns True if value is a {@link Signal}
  */
 declare function isSignal<Value>(value: unknown): value is Signal<Value>;
+/**
+ * Is the value a reactive array?
+ *
+ * @param value Value to check
+ * @returns True if value is a {@link ReactiveArray}
+ */
+declare function isReactiveArray<Item>(value: unknown): value is ReactiveArray<Item>;
 /**
  * Is the value a reactive store?
  *
  * @param value Value to check
  * @returns True if value is a {@link Store}
  */
-declare function isStore<Value extends PlainObject>(value: unknown): value is ReactiveStore<Value>;
+declare function isReactiveStore<Value extends PlainObject>(value: unknown): value is ReactiveStore<Value>;
+declare function isReadonlySignal<Value>(value: unknown): value is ReadonlySignal<Value>;
 //#endregion
-export { isArray, isComputed, isEffect, isReactive, isSignal, isStore };
+export { isComputed, isEffect, isReactive, isReactiveArray, isReactiveStore, isReadonlySignal, isSignal };

package/dist/helpers/is.mjs

@@ -1,15 +1,6 @@
-import { NAME_ALL, NAME_ARRAY, NAME_COMPUTED, NAME_EFFECT, NAME_SIGNAL, NAME_STORE } from "../constants.mjs";
+import { NAME_ALL, NAME_ARRAY, NAME_COMPUTED, NAME_EFFECT, NAME_READONLY, NAME_SIGNAL, NAME_STORE } from "../constants.mjs";
 //#region src/helpers/is.ts
 /**
-* Is the value a reactive array?
-*
-* @param value Value to check
-* @returns True if value is a {@link ReactiveArray}
-*/
-function isArray(value) {
-	return isMora(value, NAME_ARRAY);
-}
-/**
 * Is the value a computed signal?
 *
 * @param value Value to check
@@ -49,13 +40,25 @@ function isSignal(value) {
 	return isMora(value, NAME_SIGNAL);
 }
 /**
+* Is the value a reactive array?
+*
+* @param value Value to check
+* @returns True if value is a {@link ReactiveArray}
+*/
+function isReactiveArray(value) {
+	return isMora(value, NAME_ARRAY);
+}
+/**
 * Is the value a reactive store?
 *
 * @param value Value to check
 * @returns True if value is a {@link Store}
 */
-function isStore(value) {
+function isReactiveStore(value) {
 	return isMora(value, NAME_STORE);
 }
+function isReadonlySignal(value) {
+	return isMora(value, NAME_READONLY);
+}
 //#endregion
-export { isArray, isComputed, isEffect, isReactive, isSignal, isStore };
+export { isComputed, isEffect, isReactive, isReactiveArray, isReactiveStore, isReadonlySignal, isSignal };

package/dist/index.d.mts

@@ -1,9 +1,9 @@
 import { startBatch, stopBatch } from "./batch.mjs";
-import { Computed, Effect, ReactiveArray, ReactiveStore, Signal, Unsubscribe } from "./models.mjs";
+import { Computed, Effect, ReactiveArray, ReactiveStore, ReadonlySignal, Signal, Unsubscribe } from "./models.mjs";
 import { effect } from "./effect.mjs";
-import { isArray, isComputed, isEffect, isReactive, isSignal } from "./helpers/is.mjs";
+import { isComputed, isEffect, isReactive, isReactiveArray, isReactiveStore, isReadonlySignal, isSignal } from "./helpers/is.mjs";
 import { array } from "./value/array.mjs";
 import { computed } from "./value/computed.mjs";
 import { signal } from "./value/signal.mjs";
 import { store } from "./value/store.mjs";
-export { type Computed, type Effect, type ReactiveArray, type ReactiveStore, type Signal, type Unsubscribe, array, computed, effect, isArray, isComputed, isEffect, isReactive, isSignal, signal, startBatch, stopBatch, store };
+export { type Computed, type Effect, type ReactiveArray, type ReactiveStore, type ReadonlySignal, type Signal, type Unsubscribe, array, computed, effect, isComputed, isEffect, isReactive, isReactiveArray, isReactiveStore, isReadonlySignal, isSignal, signal, startBatch, stopBatch, store };

package/dist/index.mjs

@@ -1,8 +1,8 @@
 import { effect } from "./effect.mjs";
 import { startBatch, stopBatch } from "./batch.mjs";
-import { isArray, isComputed, isEffect, isReactive, isSignal } from "./helpers/is.mjs";
+import { isComputed, isEffect, isReactive, isReactiveArray, isReactiveStore, isReadonlySignal, isSignal } from "./helpers/is.mjs";
 import { computed } from "./value/computed.mjs";
 import { signal } from "./value/signal.mjs";
 import { array } from "./value/array.mjs";
 import { store } from "./value/store.mjs";
-export { array, computed, effect, isArray, isComputed, isEffect, isReactive, isSignal, signal, startBatch, stopBatch, store };
+export { array, computed, effect, isComputed, isEffect, isReactive, isReactiveArray, isReactiveStore, isReadonlySignal, isSignal, signal, startBatch, stopBatch, store };

package/dist/models.d.mts

@@ -1,5 +1,5 @@
 import { PROPERTY_LENGTH } from "./constants.mjs";
-import { GenericCallback, Key } from "@oscarpalmer/atoms/models";
+import { GenericCallback, Key, PlainObject } from "@oscarpalmer/atoms/models";
 //#region src/models.d.ts
 type Active = {
   computed?: ComputedEffect;
@@ -42,6 +42,20 @@ type ReactiveArray<Item> = {
    * Set the length of the array
    */
   set length(value: number);
+  /**
+   * Get a readonly version of the reactive array
+   *
+   * @param frozen Freeze the array? _(defaults to `false`)_
+   * @returns Readonly reactive array
+   */
+  asReadonly(frozen: true): ReadonlyFrozenSignal<Item[]>;
+  /**
+   * Get a readonly version of the reactive array
+   *
+   * @param frozen Freeze the array? _(defaults to `false`)_
+   * @returns Readonly reactive array
+   */
+  asReadonly(frozen?: boolean): typeof frozen extends true ? ReadonlyFrozenSignal<Item[]> : ReadonlySignal<Item[]>;
   /**
    * Get the value at an index
    *
@@ -96,16 +110,18 @@ type ReactiveArray<Item> = {
   /**
    * Get the array _(without reactivity)_
    *
+   * @param copy Copy the array? _(defaults to `false`)_
    * @returns Array of items
    */
-  peek(): Item[];
+  peek(copy?: boolean): Item[];
   /**
    * Get the value at an index _(without reactivity)_
    *
    * @param index Index of item to get _(if negative, starts from the end)_
+   * @param copy If the item is an array or record, should it be copied? _(defaults to `false`)_
    * @returns Item at index, or `undefined` if it doesn't exist
    */
-  peek(index: number): Item | undefined;
+  peek(index: number, copy?: boolean): Item | undefined;
   /**
    * Get the length of the array _(without reactivity)_
    *
@@ -227,20 +243,34 @@ type ReactiveState<Value, Equal> = {
   subscriptions: Map<GenericCallback, Subscription>;
   value: Value;
 };
-type ReactiveStore<Value> = {
+type ReactiveStore<Store> = {
+  /**
+   * Get a readonly version of the reactive store
+   *
+   * @param frozen Freeze the store? _(defaults to `false`)_
+   * @returns Readonly reactive store
+   */
+  asReadonly(frozen: true): ReadonlyFrozenSignal<Store>;
+  /**
+   * Get a readonly version of the reactive store
+   *
+   * @param frozen Freeze the store? _(defaults to `false`)_
+   * @returns Readonly reactive store
+   */
+  asReadonly(frozen?: boolean): typeof frozen extends true ? ReadonlyFrozenSignal<Store> : ReadonlySignal<Store>;
   /**
    * Get the value
    *
    * @returns Current value
    */
-  get(): Value;
+  get(): Store;
   /**
    * Get a value by key
    *
    * @param key Key of the value to get
    * @returns Value for the specified key, or `undefined` if it doesn't exist
    */
-  get<Key extends keyof Value>(key: Key): Value[Key];
+  get<Key extends keyof Store>(key: Key): Store[Key];
   /**
    * Get a value by key
    *
@@ -258,36 +288,39 @@ type ReactiveStore<Value> = {
   /**
    * Get the value _(without reactivity)_
    *
+   * @param copy Copy the store? _(defaults to `false`)_
    * @returns Current value
    */
-  peek(): Value;
+  peek(copy?: boolean): Store;
   /**
    * Get a value by key _(without reactivity)_
    *
    * @param key Key of the value to get
+   * @param copy If the value is an array or record, should it be copied? _(defaults to `false`)_
    * @returns Value for the specified key, or `undefined` if it doesn't exist
    */
-  peek<Key extends keyof Value>(key: Key): Value[Key];
+  peek<Key extends keyof Store>(key: Key, copy?: boolean): Store[Key];
   /**
    * Get a value by key _(without reactivity)_
    *
    * @param key Key of the value to get
+   * @param copy If the value is an array or record, should it be copied? _(defaults to `false`)_
    * @returns Value for the specified key, or `undefined` if it doesn't exist
    */
-  peek(key: Key): unknown;
+  peek(key: Key, copy?: boolean): unknown;
   /**
    * Set the value
    *
    * @param value New value _(defaults to an empty object)_
    */
-  set(value?: Value | (() => null | undefined | Value | Promise<null | undefined | Value>) | Promise<null | undefined | Value>): void;
+  set(value?: Store | (() => null | undefined | Store | Promise<null | undefined | Store>) | Promise<null | undefined | Store>): void;
   /**
    * Set a value by key
    *
    * @param key Key of the value to set
    * @param value New value
    */
-  set<Key extends keyof Value>(key: Key, value: Value[Key] | (() => Value[Key] | Promise<Value[Key]>) | Promise<Value[Key]>): void;
+  set<Key extends keyof Store>(key: Key, value: Store[Key] | (() => Store[Key] | Promise<Store[Key]>) | Promise<Store[Key]>): void;
   /**
    * Set a value by key
    *
@@ -301,7 +334,7 @@ type ReactiveStore<Value> = {
    * @param callback Callback for changes
    * @returns Unsubscribe callback
    */
-  subscribe(callback: (value: Value) => void): Unsubscribe;
+  subscribe(callback: (value: Store) => void): Unsubscribe;
   /**
    * Subscribe to changes for a specific key
    *
@@ -309,7 +342,7 @@ type ReactiveStore<Value> = {
    * @param callback Callback for changes
    * @returns Unsubscribe callback
    */
-  subscribe<Key extends keyof Value>(key: Key, callback: (value: Value[Key] | undefined) => void): Unsubscribe;
+  subscribe<Key extends keyof Store>(key: Key, callback: (value: Store[Key] | undefined) => void): Unsubscribe;
   /**
    * Subscribe to changes for a specific key
    *
@@ -324,20 +357,39 @@ type ReactiveStore<Value> = {
    * @param key Key of the value to unsubscribe from
    * @param callback Callback to unsubscribe
    */
-  unsubscribe<Key extends keyof Value>(key: Key, callback: (value: Value[Key] | undefined) => void): void;
+  unsubscribe<Key extends keyof Store>(key: Key, callback: (value: Store[Key] | undefined) => void): void;
+  /**
+   * Unsubscribe from changes for a specific key
+   *
+   * @param key Key of the value to unsubscribe from
+   * @param callback Callback to unsubscribe
+   */
+  unsubscribe(key: Key, callback: (value: unknown | undefined) => void): void;
   /**
    * Unsubscribe from changes
    *
    * @param callback Callback to unsubscribe
    */
-  unsubscribe(callback: (value: Value) => void): void;
+  unsubscribe(callback: (value: Store) => void): void;
   /**
    * Update the value _(based on the current value)_
    *
    * @param callback Callback to update the value
    */
-  update(callback: (value: Value) => Value): void;
-} & Reactive<Value>;
+  update(callback: (value: Store) => Store): void;
+} & Reactive<Store>;
+type ReadonlyInstances<Value> = {
+  frozen?: ReadonlyFrozenSignal<Value>;
+  original?: ReadonlySignal<Value>;
+};
+type ReadonlyFrozenSignal<Value> = ReadonlySignal<ReadonlySignalValue<Value>>;
+type ReadonlySignal<Value> = {
+  /**
+   * Is the signal frozen?
+   */
+  get frozen(): boolean;
+} & Reactive<Value> & SimpleReactive<Value>;
+type ReadonlySignalValue<Value> = Value extends unknown[] ? Readonly<Value> : Value extends PlainObject ? Readonly<Value> : Value;
 type SetValueInProxyParameters<Value, Equal> = {
   target: Value;
   property: PropertyKey;
@@ -347,6 +399,20 @@ type SetValueInProxyParameters<Value, Equal> = {
   length?: Signal<number>;
 };
 type Signal<Value> = {
+  /**
+   * Get a readonly version of the signal
+   *
+   * @param frozen Freeze the signal? _(defaults to `false`)_
+   * @returns Readonly signal
+   */
+  asReadonly(frozen: true): ReadonlyFrozenSignal<Value>;
+  /**
+   * Get a readonly version of the signal
+   *
+   * @param frozen Freeze the signal? _(defaults to `false`)_
+   * @returns Readonly signal
+   */
+  asReadonly(frozen?: boolean): typeof frozen extends true ? ReadonlyFrozenSignal<Value> : ReadonlySignal<Value>;
   /**
    * Set the value
    *
@@ -397,4 +463,4 @@ type Subscription = {
  */
 type Unsubscribe = () => void;
 //#endregion
-export { Active, Batch, Computed, ComputedEffect, Effect, EffectState, Reactive, ReactiveArray, ReactiveOptions, ReactiveState, ReactiveStore, SetValueInProxyParameters, Signal, Subscription, Unsubscribe };
+export { Active, Batch, Computed, ComputedEffect, Effect, EffectState, Reactive, ReactiveArray, ReactiveOptions, ReactiveState, ReactiveStore, ReadonlyFrozenSignal, ReadonlyInstances, ReadonlySignal, ReadonlySignalValue, SetValueInProxyParameters, Signal, Subscription, Unsubscribe };

package/dist/mora.full.mjs

@@ -23,11 +23,13 @@ const NAME_ARRAY = "array";
 const NAME_COMPUTED = "computed";
 const NAME_EFFECT = "effect";
 const NAME_MORA = "$mora";
+const NAME_READONLY = "readonly";
 const NAME_SIGNAL = "signal";
 const NAME_STORE = "store";
 const NAME_ALL = /* @__PURE__ */ new Set([
 	NAME_ARRAY,
 	NAME_COMPUTED,
+	NAME_READONLY,
 	NAME_SIGNAL,
 	NAME_STORE
 ]);
@@ -99,15 +101,6 @@ function stopBatch() {
 //#endregion
 //#region src/helpers/is.ts
 /**
-* Is the value a reactive array?
-*
-* @param value Value to check
-* @returns True if value is a {@link ReactiveArray}
-*/
-function isArray(value) {
-	return isMora(value, NAME_ARRAY);
-}
-/**
 * Is the value a computed signal?
 *
 * @param value Value to check
@@ -146,6 +139,27 @@ function isReactive(value) {
 function isSignal(value) {
 	return isMora(value, NAME_SIGNAL);
 }
+/**
+* Is the value a reactive array?
+*
+* @param value Value to check
+* @returns True if value is a {@link ReactiveArray}
+*/
+function isReactiveArray(value) {
+	return isMora(value, NAME_ARRAY);
+}
+/**
+* Is the value a reactive store?
+*
+* @param value Value to check
+* @returns True if value is a {@link Store}
+*/
+function isReactiveStore(value) {
+	return isMora(value, NAME_STORE);
+}
+function isReadonlySignal(value) {
+	return isMora(value, NAME_READONLY);
+}
 //#endregion
 //#region node_modules/@oscarpalmer/atoms/dist/internal/array/callbacks.mjs
 function getArrayCallback(value) {
@@ -512,6 +526,39 @@ function setValueInProxy(parameters) {
 	return true;
 }
 //#endregion
+//#region src/value/readonly.ts
+function getReadonlyInstance(state, instances, handlers, frozen) {
+	const key = frozen ? "frozen" : "original";
+	instances[key] ??= getReadonlySignal(state, handlers, frozen);
+	return instances[key];
+}
+function getReadonlySignal(state, handlers, frozen) {
+	const instance = {
+		...handlers,
+		get: () => getReadonlyValue(state, false, frozen),
+		peek: () => getReadonlyValue(state, true, frozen)
+	};
+	Object.defineProperties(instance, {
+		[NAME_MORA]: {
+			enumerable: false,
+			value: NAME_READONLY
+		},
+		frozen: {
+			enumerable: true,
+			value: frozen
+		}
+	});
+	return Object.freeze(instance);
+}
+function getReadonlyValue(state, peek, frozen) {
+	let value = peek ? state.value : getSimpleValue(state);
+	if (!frozen) return value;
+	if (Array.isArray(state.value)) value = [...state.value];
+	else if (isPlainObject(state.value)) value = { ...state.value };
+	else value = state.value;
+	return Object.freeze(value);
+}
+//#endregion
 //#region src/value/signal.ts
 function setAndEmit(state, value) {
 	if (!state.equal(state.value, value)) {
@@ -521,8 +568,17 @@ function setAndEmit(state, value) {
 }
 function signal(value, options) {
 	const [rx, state] = reactive(void 0, options);
-	const instance = {
+	const readonlies = {};
+	const handlers = {
 		...rx,
+		subscribe: (callback) => subscribe(state, callback),
+		unsubscribe: (callback) => {
+			state.subscriptions.delete(callback);
+		}
+	};
+	const instance = {
+		...handlers,
+		asReadonly: (frozen) => getReadonlyInstance(state, readonlies, handlers, frozen === true),
 		get: () => getSimpleValue(state),
 		peek: () => state.value,
 		set: (value) => {
@@ -530,10 +586,6 @@ function signal(value, options) {
 		},
 		update: (callback) => {
 			handleSimpleValue(state, callback(state.value), setAndEmit);
-		},
-		subscribe: (callback) => subscribe(state, callback),
-		unsubscribe: (callback) => {
-			state.subscriptions.delete(callback);
 		}
 	};
 	Object.defineProperty(instance, NAME_MORA, {
@@ -549,6 +601,8 @@ function array(value, options) {
 	const [rx, state] = reactive([], options);
 	const indiced = /* @__PURE__ */ new Map();
 	const length = signal(0);
+	const readonlies = {};
+	let instance = {};
 	state.value = new Proxy([], {
 		get: (target, property) => METHODS_UPDATE.has(property) ? updateArray(property, target, state, length) : Reflect.get(target, property),
 		set: (target, property, value) => setValueInProxy({
@@ -563,37 +617,43 @@ function array(value, options) {
 	function get(value) {
 		return getArrayValue(instance, indiced, state, length, value);
 	}
-	const instance = {
+	function set(first, second) {
+		setProxyValue(true, state, isArrayValue, isArrayIndex, setArray, setAtIndex, first, second);
+	}
+	const handlers = {
 		...rx,
-		length: state.value.length,
+		get: (value) => get(value),
+		peek: (first, second) => peekArrayValue(state, length, first, second),
+		subscribe: (first, second) => {
+			if (typeof first === "number" && typeof second === "function") return getReactiveValueInProxy(instance, indiced, first, true).subscribe(second);
+			return typeof first === "function" ? subscribe(state, first) : noop$1;
+		},
+		unsubscribe: (first, second) => {
+			if (typeof first === "number" && typeof second === "function") getReactiveValueInProxy(instance, indiced, first, true)?.unsubscribe(second);
+			else if (typeof first === "function") unsubscribe(state, first);
+		}
+	};
+	instance = {
+		...handlers,
+		asReadonly: (frozen) => getReadonlyInstance(state, readonlies, handlers, frozen === true),
 		at: (index) => get(index),
 		clear: () => {
 			state.value.length = 0;
 		},
 		filter: (callback) => computed(() => filter(get(), callback)),
-		get: (value) => get(value),
 		map: (callback) => computed(() => get().map(callback)),
 		notify: () => {
 			emityProxyValues(state, indiced);
 		},
-		peek: (value) => peekArrayValue(state, length, value),
 		pop: () => state.value.pop(),
 		push: (...items) => state.value.push(...items),
 		select: (filter, map) => computed(() => select(get(), filter, map)),
 		set: (first, second) => {
-			setProxyValue(true, state, isArrayValue, isArrayIndex, setArray, setAtIndex, first, second);
+			set(first, second);
 		},
 		shift: () => state.value.shift(),
 		splice: (from, to, ...items) => state.value.splice(from, to ?? state.value.length, ...items),
-		subscribe: (first, second) => {
-			if (typeof first === "number" && typeof second === "function") return getReactiveValueInProxy(instance, indiced, first, true).subscribe(second);
-			return typeof first === "function" ? subscribe(state, first) : noop$1;
-		},
 		unshift: (...items) => state.value.unshift(...items),
-		unsubscribe: (first, second) => {
-			if (typeof first === "number" && typeof second === "function") getReactiveValueInProxy(instance, indiced, first, true)?.unsubscribe(second);
-			else if (typeof first === "function") unsubscribe(state, first);
-		},
 		update: (callback) => updateArrayValue(instance, state, callback)
 	};
 	Object.defineProperties(instance, {
@@ -607,7 +667,7 @@ function array(value, options) {
 			set: (value) => setArrayLength(state, value)
 		}
 	});
-	instance.set(value);
+	set(value);
 	return Object.freeze(instance);
 }
 function getArrayValue(instance, indiced, state, length, first) {
@@ -620,9 +680,15 @@ function isArrayIndex(value) {
 function isArrayValue(value) {
 	return value == null || Array.isArray(value);
 }
-function peekArrayValue(state, length, value) {
-	if (value === "length") return length.peek();
-	return typeof value === "number" ? state.value.at(value) : state.value.slice();
+function peekArrayValue(state, length, first, second) {
+	if (first === "length") return length.peek();
+	let value;
+	if (typeof first === "number") value = state.value.at(first);
+	else value = state.value;
+	if (!(first === true || second === true)) return value;
+	if (Array.isArray(value)) return value.slice();
+	if (isPlainObject(value)) return { ...value };
+	return value;
 }
 function setArray(state, value) {
 	state.value.splice(0, state.value.length, ...value ?? []);
@@ -674,12 +740,23 @@ function setObject(state, value) {
 	}
 	stopBatch();
 }
+function peekStoreValue(state, first, second) {
+	let value;
+	if (isKey(first)) value = state.value[first];
+	else value = state.value;
+	if (!(first === true || second === true)) return value;
+	if (Array.isArray(value)) return value.slice();
+	if (isPlainObject(value)) return { ...value };
+	return value;
+}
 function setProperty(state, key, value) {
 	state.value[key] = value;
 }
 function store(value, options) {
 	const [rx, state] = reactive(void 0, options);
 	const keyed = /* @__PURE__ */ new Map();
+	const readonlies = {};
+	let instance = {};
 	state.value = new Proxy({}, { set: (target, property, value) => setValueInProxy({
 		target,
 		property,
@@ -687,16 +764,10 @@ function store(value, options) {
 		value,
 		isArray: false
 	}) });
-	const instance = {
+	const handlers = {
 		...rx,
 		get: (value) => isKey(value) ? getReactiveValueInProxy(instance, keyed, value, false).get() : getSimpleValue(state),
-		notify() {
-			emityProxyValues(state, keyed);
-		},
-		peek: (value) => isKey(value) ? state.value[value] : { ...state.value },
-		set: (first, second) => {
-			setProxyValue(false, state, isStoreObject, isKey, setObject, setProperty, first, second);
-		},
+		peek: (first, second) => peekStoreValue(state, first, second),
 		subscribe: (first, second) => {
 			if (isKey(first) && typeof second === "function") return getReactiveValueInProxy(instance, keyed, first, false).subscribe(second);
 			return typeof first === "function" ? subscribe(state, first) : noop;
@@ -704,6 +775,16 @@ function store(value, options) {
 		unsubscribe: (first, second) => {
 			if (isKey(first) && typeof second === "function") getReactiveValueInProxy(instance, keyed, first, false)?.unsubscribe(second);
 			else if (typeof first === "function") unsubscribe(state, first);
+		}
+	};
+	instance = {
+		...handlers,
+		asReadonly: (frozen) => getReadonlyInstance(state, readonlies, handlers, frozen === true),
+		notify() {
+			emityProxyValues(state, keyed);
+		},
+		set: (first, second) => {
+			setProxyValue(false, state, isStoreObject, isKey, setObject, setProperty, first, second);
 		},
 		update: (callback) => {
 			const updated = callback(state.value);
@@ -718,4 +799,4 @@ function store(value, options) {
 	return Object.freeze(instance);
 }
 //#endregion
-export { array, computed, effect, isArray, isComputed, isEffect, isReactive, isSignal, signal, startBatch, stopBatch, store };
+export { array, computed, effect, isComputed, isEffect, isReactive, isReactiveArray, isReactiveStore, isReadonlySignal, isSignal, signal, startBatch, stopBatch, store };