feat: added support for immer

Author: RISHIK92

dist/index.d.mts

@@ -1,5 +1,10 @@
+import { Draft } from 'immer';
+
 declare function ripplePrimitive<T>(initial: T): RippleInterface<T>;
 
+interface RippleWithImmerUpdate<T> extends RippleInterface<T> {
+    update(recipe: (draft: Draft<T>) => void | Promise<void>): Promise<void>;
+}
 interface RippleInterface<T> {
     value: T;
     subscribe: (cb: () => void, selector?: (v: T) => unknown) => () => void;
@@ -10,6 +15,7 @@ interface RippleFunctionInterface {
     <T>(initial: T): RippleInterface<T>;
     proxy: <T extends object>(initial: T) => RippleInterface<T>;
     primitive: typeof ripplePrimitive;
+    immer: <T extends object>(initial: T) => RippleWithImmerUpdate<T>;
 }
 
 type HandlerType = (payload?: any, tools?: {

dist/index.d.ts

@@ -1,5 +1,10 @@
+import { Draft } from 'immer';
+
 declare function ripplePrimitive<T>(initial: T): RippleInterface<T>;
 
+interface RippleWithImmerUpdate<T> extends RippleInterface<T> {
+    update(recipe: (draft: Draft<T>) => void | Promise<void>): Promise<void>;
+}
 interface RippleInterface<T> {
     value: T;
     subscribe: (cb: () => void, selector?: (v: T) => unknown) => () => void;
@@ -10,6 +15,7 @@ interface RippleFunctionInterface {
     <T>(initial: T): RippleInterface<T>;
     proxy: <T extends object>(initial: T) => RippleInterface<T>;
     primitive: typeof ripplePrimitive;
+    immer: <T extends object>(initial: T) => RippleWithImmerUpdate<T>;
 }
 
 type HandlerType = (payload?: any, tools?: {

dist/index.js

@@ -12,11 +12,12 @@
   "devDependencies": {
     "@preact/signals": "^2.2.0",
     "@types/react": "^19.1.8",
+    "prettier": "3.6.2",
     "react": "^19.1.0",
     "react-dom": "^19.1.0",
     "tsup": "^8.5.0",
     "typescript": "^5.8.3",
-    "prettier": "3.6.2"
+    "immer": "^10.1.1"
   },
   "exports": {
     ".": {

dist/index.mjs

@@ -1,22 +1,23 @@
-export { computed, effect } from "@preact/signals";
 import {
   RippleFunctionInterface,
   RippleInterface,
 } from "../interfaces/ripple.interface";
 import { ripplePrimitive } from "../utils/ripplePrimitive";
 import { rippleObject } from "../utils/rippleObject";
 import { rippleProxy } from "../utils/rippleProxy";
+import { createImmerStore } from "../utils/immer";
 
 export const ripple = function <T>(initial: T): RippleInterface<T> {
   return isObject(initial) ? rippleObject(initial) : ripplePrimitive(initial);
 } as RippleFunctionInterface;
 
-function isObject(value: unknown): value is object | Array<any> {
-  return (typeof value === "object" && value !== null) || Array.isArray(value);
+function isObject(value: unknown): value is object | any[] {
+  return typeof value === "object" && value !== null;
 }
 
 Object.assign(ripple, {
   proxy: rippleProxy,
   primitive: ripplePrimitive,
   object: rippleObject,
+  immer: createImmerStore,
 });

package-lock.json

@@ -1,4 +1,9 @@
 import { ripplePrimitive } from "../utils/ripplePrimitive";
+import type { Draft } from "immer";
+
+interface RippleWithImmerUpdate<T> extends RippleInterface<T> {
+  update(recipe: (draft: Draft<T>) => void | Promise<void>): Promise<void>;
+}
 
 export interface RippleInterface<T> {
   value: T;
@@ -11,4 +16,5 @@ export interface RippleFunctionInterface {
   <T>(initial: T): RippleInterface<T>;
   proxy: <T extends object>(initial: T) => RippleInterface<T>;
   primitive: typeof ripplePrimitive;
+  immer: <T extends object>(initial: T) => RippleWithImmerUpdate<T>;
 }

package.json

@@ -0,0 +1,13 @@
+import { ripplePrimitive } from "./ripplePrimitive";
+import { produce, Draft } from "immer"; 
+
+export function createImmerStore<T extends object>(initial: T) {
+  const root = ripplePrimitive<T>(initial);
+
+  function update(recipe: (draft: Draft<T>) => void) {
+    const next = produce(root.value, recipe);
+    if (next !== root.value) root.value = next;
+  }
+
+  return Object.assign(root, { update });
+}