snap-store 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 yahiro
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,210 @@
+# snap-store
+
+## Introduction
+
+This is an easy-to-use global state management library for React.
+
+## Installation
+```sh
+npm install snap-store
+```
+
+## Motivation
+
+I like [valtio](https://github.com/pmndrs/valtio). But sometimes I'm confused by its proxy based design.
+So I wanted to have a non-proxy version of this.
+
+I researched some signal based libraries and how to make them work on React.
+I found some hooks (`useSyncExternalStore`) could be used to implement it.
+After struggling for a while, finally I got my own store library working!
+
+```ts
+import {createStore} from "snap-store"
+
+const store = createStore({ count: 0});
+
+const Counter = () => {
+  const { count } = store.snapshot;
+  const { setCount } = store.mutations;
+  return <button onClick={() => setCount(prev => prev + 1)}>
+    {count}
+  </button>
+}
+```
+
+## How it works
+```ts
+const store = createStore({ count: 0});
+```
+`createStore` takes an initial state object and returns a store.
+The store holds wrapper signals for each field of the state object.
+```ts
+const { count } = store.snapshot;
+```
+In a component, `snapshot` getter is used to refer to the states and make them reactive.
+For this line, `count` is actually a getter and it registers a listener to track the value change.
+
+## Usage Examples
+```ts
+const store = createStore({ count: 0});
+
+function handleButton(){
+  const { count } = store.state;    //read store state
+  store.mutations.setCount(currentCount + 1); //mutate by value
+  store.mutations.setCount(prev => prev + 1); //mutate by function
+}
+
+const Component = () => {
+  const { count } = store.snapshot;		//refer store state as reactive
+  return <button onClick={handleButton}>push me {count}</button>
+}
+```
+In the component, `store.snapshot` is used to refer to the store state as a reactive value.
+
+Since this is a global state library, you can also read and write store states outside components.
+`store.state` is used to read the value in non-component functions.
+
+`store.mutations` has no difference in component or non-component context.
+
+```ts
+const store = createStore({ user: {name: "John", age: 20 }});
+store.mutations.setUser({ name: "Mike", age: 20});       //value
+store.mutations.setUser(prev => ({...prev, age: 21}));     //by function
+store.mutations.patchUser({ age: 22});		//partial update (merged)
+store.mutations.produceUser(draft => { draft.age = 23 })    //update with immer
+```
+It comes with various update methods for each field.
+
+`set*` methods are similar to the setter function of `useState`. It takes a value or a function.
+
+`patch*` could be used for a partial update. The new state is merged with the previous state and new attributes.
+
+`produce*` wraps the `produce` function of `immer`. (`immer` is included in the dependencies.)
+
+```ts
+const store = createStore({ 
+  penWidth: 3, 
+  penColor: 'black', 
+  penStyle: 'normal'
+});
+store.mutations.assigns({ penWidth: 1, penStyle: 'dashed' });
+//is equivalent to
+store.mutations.setPenWidth(1);
+store.mutations.setPenStyle('dashed');
+```
+In mutations, there is `assigns` method to set multiple fields at a time.
+It is useful if you want to update multiple values.
+
+There is no performance difference since reactive effects (i.e. rendering) are batched and executed in the next frame.
+
+```ts
+const store = createStore<{theme: "light" | "dark"}>({theme: "light" })
+
+const ThemeSelector = () => {
+  const { theme } = store.snapshot;
+  const { setTheme } = store.mutations;
+  return <div>
+    <IconButton
+      icon="☀️"
+      active={theme === 'light'}
+      onClick={() => setTheme("light")}
+    />
+    <IconButton
+      icon="🌙"
+      active={theme === 'dark'}
+      onClick={() => setTheme("dark")}
+    />
+  </div>
+}
+```
+Here is a typical theme selector example.
+
+```ts
+const store = createStore<{textSize: number, bgColor: string}>({
+  textSize: 5,
+  bgColor: "#ffffff"
+})
+
+const BookReaderSettings = () => {
+  const snap = store.snapshot;
+  const mut = store.mutations;
+  return <div>
+    <Slider
+      value={snap.textSize}
+      onChange={mut.setTextSize}
+      min={10}
+      max={20}
+    />
+    <ColorInput
+      value={snap.bgColor}
+      onChange={mut.setBgColor}
+    />
+  </div>
+}
+```
+Sometimes it might provide good editor completions for non-destructive use.
+However there are caveats in some cases (read below).
+
+## Caveats
+```ts
+const store = createStore({ name: "Mike", age: 20 });
+
+//wrong code
+const Component = () => {
+  const snap = store.snapshot;
+  if(snap.age < 20) return; //bad early return
+  return <div>Hello Gentleman, {snap.name}</div>
+}
+
+//working code
+const Component = () => {
+  const { age, name }  = store.snapshot;
+  if(age < 20) return;  //no problem
+  return <div>Hello Gentleman, {name}</div>
+}
+```
+Each member of the snapshot object is a getter and it calls a hooks (`useSyncExternalStore`) internally.
+
+Since a component must have the same hooks count for each render, non-destructive assign and early return are a bad combination.
+
+The snapshot should be destructured if you have an early return.
+
+## Other Signal functionalities
+```ts
+const store = createStore({ count: 0 });
+
+effect(() => {
+  const count = store.state.count;
+  console.log("Effect:", count);
+});
+
+store.mutations.setCount((prev) => prev + 1);
+
+const doubled = computed(() => {
+  const cnt = store.state.count;
+  console.log("computing for:", cnt);
+  return cnt * 2;
+});
+console.log("Doubled:", doubled.value);
+```
+There are two `effect()` and `computed()` helper functions intended to be used in non-component context.
+
+`effect()` tracks the referred state changes in the callback and is automatically re-evaluated when the tracked values change.
+
+`computed()` is used for caching the computation result, returning a derived signal. It is re-evaluated when tracked values change.
+
+## References
+- [valtio](https://github.com/pmndrs/valtio)
+- [@preact/signals-react](https://github.com/preactjs/signals)
+
+`snap-store` is highly influenced by these libraries.
+
+Compared to `valtio`, this library provides a similar design of global store but it doesn't use proxies. Also the mutations are applied by the methods not by assignment.
+
+Compared to `@preact/signals-react`, although the mechanism of the signal is similar, this library is aimed to supply an opinionated store system whereas `@preact/signals` provides the basic primitive signal functions.
+
+## License
+
+MIT License
+
+

package/dist/esm/effects.d.ts

@@ -0,0 +1,4 @@
+import { ComputedSignal } from "./types";
+export declare const effect: (fn: () => void) => (() => void);
+export declare const computed: <U>(fn: () => U) => ComputedSignal<U>;
+//# sourceMappingURL=effects.d.ts.map

package/dist/esm/effects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effects.d.ts","sourceRoot":"","sources":["../../src/effects.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAUzC,eAAO,MAAM,MAAM,GAAI,IAAI,MAAM,IAAI,KAAG,CAAC,MAAM,IAAI,CAqBlD,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,CAAC,EAAE,IAAI,MAAM,CAAC,KAAG,cAAc,CAAC,CAAC,CAsDzD,CAAC"}

package/dist/esm/effects.js

@@ -0,0 +1,79 @@
+import { reactivityHub } from "./reactivity-hub";
+import { createSignal } from "./signal";
+function createEffectReceiver(fn) {
+    return {
+        listener: fn,
+        signalHolders: new Set(),
+        cleanup: [],
+    };
+}
+export const effect = (fn) => {
+    const effectReceiver = createEffectReceiver(fn);
+    // Set current effect for dependency tracking
+    const prevEffect = reactivityHub.getCurrentEffect();
+    reactivityHub.setCurrentEffect(effectReceiver);
+    try {
+        fn(); // Execute effect to collect dependencies
+    }
+    finally {
+        reactivityHub.setCurrentEffect(prevEffect);
+    }
+    // Return cleanup function
+    return () => {
+        effectReceiver.cleanup.forEach((cleanup) => {
+            cleanup();
+        });
+        effectReceiver.cleanup.length = 0;
+        effectReceiver.signalHolders.clear();
+    };
+};
+export const computed = (fn) => {
+    // biome-ignore lint/style/noNonNullAssertion: false
+    const internalSignal = createSignal(undefined);
+    let initialized;
+    let cleanupEffect;
+    const ensureInitialized = () => {
+        if (!initialized) {
+            const effectReceiver = createEffectReceiver(() => {
+                const newValue = fn();
+                internalSignal.setValue(newValue);
+            });
+            const prevEffect = reactivityHub.getCurrentEffect();
+            reactivityHub.setCurrentEffect(effectReceiver);
+            try {
+                const initialValue = fn();
+                internalSignal.setValue(initialValue);
+            }
+            finally {
+                reactivityHub.setCurrentEffect(prevEffect);
+            }
+            cleanupEffect = () => {
+                effectReceiver.cleanup.forEach((cleanup) => {
+                    cleanup();
+                });
+                effectReceiver.cleanup.length = 0;
+                effectReceiver.signalHolders.clear();
+            };
+            initialized = true;
+        }
+    };
+    return {
+        get value() {
+            ensureInitialized();
+            return internalSignal.value;
+        },
+        get snapshotValue() {
+            ensureInitialized();
+            return internalSignal.use();
+        },
+        use() {
+            ensureInitialized();
+            return internalSignal.use();
+        },
+        subscribe: internalSignal.subscribe,
+        cleanup() {
+            cleanupEffect?.();
+        },
+    };
+};
+//# sourceMappingURL=effects.js.map

package/dist/esm/effects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effects.js","sourceRoot":"","sources":["../../src/effects.ts"],"names":[],"mappings":"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"}

package/dist/esm/helpers.d.ts

@@ -0,0 +1,2 @@
+export declare function capitalizeFirstLetter(text: string): string;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/esm/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/helpers.ts"],"names":[],"mappings":"AAAA,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,UAEjD"}

package/dist/esm/helpers.js

@@ -0,0 +1,4 @@
+export function capitalizeFirstLetter(text) {
+    return text.charAt(0).toUpperCase() + text.slice(1);
+}
+//# sourceMappingURL=helpers.js.map

package/dist/esm/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/helpers.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACtD,CAAC"}

package/dist/esm/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./effects";
+export * from "./signal";
+export * from "./store";
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,5 @@
+export * from "./effects";
+export * from "./signal";
+export * from "./store";
+export * from "./types";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}

package/dist/esm/reactivity-hub.d.ts

@@ -0,0 +1,20 @@
+import { SignalListener } from "./types";
+export type SignalHolder<T> = {
+    value: T;
+    listeners: Set<SignalListener>;
+};
+export type EffectReceiver = {
+    listener: () => void;
+    signalHolders: Set<SignalHolder<any>>;
+    cleanup: (() => void)[];
+};
+type ReactivityHub = {
+    registerSignal(key: symbol, holder: SignalHolder<any>): void;
+    getCurrentEffect(): EffectReceiver | undefined;
+    setCurrentEffect(effect: EffectReceiver | undefined): void;
+    addPendingListener(listener: SignalListener): void;
+    scheduleFlush(): void;
+};
+export declare const reactivityHub: ReactivityHub;
+export {};
+//# sourceMappingURL=reactivity-hub.d.ts.map

package/dist/esm/reactivity-hub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactivity-hub.d.ts","sourceRoot":"","sources":["../../src/reactivity-hub.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;IAC5B,KAAK,EAAE,CAAC,CAAC;IACT,SAAS,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,aAAa,EAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;IACtC,OAAO,EAAE,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;CACzB,CAAC;AAEF,KAAK,aAAa,GAAG;IACnB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IAC7D,gBAAgB,IAAI,cAAc,GAAG,SAAS,CAAC;IAC/C,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,GAAG,IAAI,CAAC;IAC3D,kBAAkB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;IACnD,aAAa,IAAI,IAAI,CAAC;CACvB,CAAC;AAsCF,eAAO,MAAM,aAAa,eAAwB,CAAC"}

package/dist/esm/reactivity-hub.js

@@ -0,0 +1,35 @@
+function createReactivityHub() {
+    const signalHolders = new Map();
+    let currentEffect;
+    const pendingListeners = new Set();
+    let flushScheduled = false;
+    return {
+        registerSignal(key, holder) {
+            signalHolders.set(key, holder);
+        },
+        getCurrentEffect() {
+            return currentEffect;
+        },
+        setCurrentEffect(effect) {
+            currentEffect = effect;
+        },
+        addPendingListener(listener) {
+            pendingListeners.add(listener);
+        },
+        scheduleFlush() {
+            if (flushScheduled)
+                return;
+            flushScheduled = true;
+            Promise.resolve().then(() => {
+                const listeners = Array.from(pendingListeners);
+                pendingListeners.clear();
+                flushScheduled = false;
+                listeners.forEach((listener) => {
+                    listener();
+                });
+            });
+        },
+    };
+}
+export const reactivityHub = createReactivityHub();
+//# sourceMappingURL=reactivity-hub.js.map

package/dist/esm/reactivity-hub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactivity-hub.js","sourceRoot":"","sources":["../../src/reactivity-hub.ts"],"names":[],"mappings":"AAqBA,SAAS,mBAAmB;IAC1B,MAAM,aAAa,GAAG,IAAI,GAAG,EAA6B,CAAC;IAC3D,IAAI,aAAyC,CAAC;IAC9C,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAkB,CAAC;IACnD,IAAI,cAAc,GAAG,KAAK,CAAC;IAE3B,OAAO;QACL,cAAc,CAAC,GAAW,EAAE,MAAyB;YACnD,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACjC,CAAC;QACD,gBAAgB;YACd,OAAO,aAAa,CAAC;QACvB,CAAC;QACD,gBAAgB,CAAC,MAAkC;YACjD,aAAa,GAAG,MAAM,CAAC;QACzB,CAAC;QACD,kBAAkB,CAAC,QAAwB;YACzC,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACjC,CAAC;QACD,aAAa;YACX,IAAI,cAAc;gBAAE,OAAO;YAC3B,cAAc,GAAG,IAAI,CAAC;YAEtB,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;gBAC1B,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;gBAC/C,gBAAgB,CAAC,KAAK,EAAE,CAAC;gBACzB,cAAc,GAAG,KAAK,CAAC;gBAEvB,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;oBAC7B,QAAQ,EAAE,CAAC;gBACb,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,mBAAmB,EAAE,CAAC"}

package/dist/esm/signal.d.ts

@@ -0,0 +1,3 @@
+import { Signal } from "./types";
+export declare function createSignal<T>(initialValue: T): Signal<T>;
+//# sourceMappingURL=signal.d.ts.map

package/dist/esm/signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal.d.ts","sourceRoot":"","sources":["../../src/signal.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,MAAM,EAAkB,MAAM,SAAS,CAAC;AAEhE,wBAAgB,YAAY,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAyC1D"}

package/dist/esm/signal.js

@@ -0,0 +1,42 @@
+import { useSyncExternalStore } from "react";
+import { reactivityHub } from "./reactivity-hub";
+export function createSignal(initialValue) {
+    const key = Symbol();
+    const holder = {
+        value: initialValue,
+        listeners: new Set(),
+    };
+    reactivityHub.registerSignal(key, holder);
+    const subscribe = (listener) => {
+        holder.listeners.add(listener);
+        return () => holder.listeners.delete(listener);
+    };
+    const signal = {
+        get value() {
+            const ce = reactivityHub.getCurrentEffect();
+            if (ce && !ce.signalHolders.has(holder)) {
+                ce.signalHolders.add(holder);
+                const unsubscribe = subscribe(ce.listener);
+                ce.cleanup.push(unsubscribe);
+            }
+            return holder.value;
+        },
+        setValue(arg) {
+            const value = typeof arg === "function" ? arg(holder.value) : arg;
+            if (value === holder.value)
+                return;
+            holder.value = value;
+            holder.listeners.forEach((listener) => {
+                reactivityHub.addPendingListener(listener);
+            });
+            reactivityHub.scheduleFlush();
+        },
+        subscribe,
+        use() {
+            const value = useSyncExternalStore(subscribe, () => holder.value);
+            return value;
+        },
+    };
+    return signal;
+}
+//# sourceMappingURL=signal.js.map

package/dist/esm/signal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal.js","sourceRoot":"","sources":["../../src/signal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAgB,MAAM,kBAAkB,CAAC;AAG/D,MAAM,UAAU,YAAY,CAAI,YAAe;IAC7C,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IACrB,MAAM,MAAM,GAAoB;QAC9B,KAAK,EAAE,YAAY;QACnB,SAAS,EAAE,IAAI,GAAG,EAAE;KACrB,CAAC;IACF,aAAa,CAAC,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAE1C,MAAM,SAAS,GAAG,CAAC,QAAwB,EAAE,EAAE;QAC7C,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC/B,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACjD,CAAC,CAAC;IAEF,MAAM,MAAM,GAAc;QACxB,IAAI,KAAK;YACP,MAAM,EAAE,GAAG,aAAa,CAAC,gBAAgB,EAAE,CAAC;YAC5C,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBACxC,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBAC7B,MAAM,WAAW,GAAG,SAAS,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;gBAC3C,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC/B,CAAC;YACD,OAAO,MAAM,CAAC,KAAK,CAAC;QACtB,CAAC;QACD,QAAQ,CAAC,GAAqB;YAC5B,MAAM,KAAK,GACT,OAAO,GAAG,KAAK,UAAU,CAAC,CAAC,CAAE,GAAsB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;YAC1E,IAAI,KAAK,KAAK,MAAM,CAAC,KAAK;gBAAE,OAAO;YAEnC,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;YACrB,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;gBACpC,aAAa,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;YAC7C,CAAC,CAAC,CAAC;YACH,aAAa,CAAC,aAAa,EAAE,CAAC;QAChC,CAAC;QACD,SAAS;QACT,GAAG;YACD,MAAM,KAAK,GAAG,oBAAoB,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAClE,OAAO,KAAK,CAAC;QACf,CAAC;KACF,CAAC;IACF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/esm/store.d.ts

@@ -0,0 +1,3 @@
+import { Store } from "./types";
+export declare function createStore<T extends object>(initialState: T): Store<T>;
+//# sourceMappingURL=store.d.ts.map

package/dist/esm/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/store.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,YAAY,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAmDvE"}

package/dist/esm/store.js

@@ -0,0 +1,48 @@
+import { produce } from "immer";
+import { capitalizeFirstLetter } from "./helpers";
+import { createSignal } from "./signal";
+export function createStore(initialState) {
+    const stateGetters = {};
+    const snapshotGetters = {};
+    const mutations = {};
+    const signals = {};
+    for (const key in initialState) {
+        const initialValue = initialState[key];
+        const signal = createSignal(initialValue);
+        Object.defineProperty(stateGetters, key, {
+            get() {
+                return signal.value;
+            },
+        });
+        Object.defineProperty(snapshotGetters, key, {
+            get() {
+                return signal.use();
+            },
+        });
+        mutations[`set${capitalizeFirstLetter(key)}`] = signal.setValue;
+        mutations[`produce${capitalizeFirstLetter(key)}`] = (fn) => {
+            signal.setValue((draft) => produce(draft, fn));
+        };
+        mutations[`patch${capitalizeFirstLetter(key)}`] = (attrs) => {
+            signal.setValue((prev) => ({ ...prev, ...attrs }));
+        };
+        signals[key] = signal;
+    }
+    Object.assign(mutations, {
+        assigns: (attrs) => {
+            for (const key in attrs) {
+                const value = attrs[key];
+                const setValue = mutations[`set${capitalizeFirstLetter(key)}`];
+                setValue?.(value);
+            }
+        },
+    });
+    return {
+        state: stateGetters,
+        snapshot: snapshotGetters,
+        useSnapshot: () => snapshotGetters,
+        mutations,
+        signals,
+    };
+}
+//# sourceMappingURL=store.js.map

package/dist/esm/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGxC,MAAM,UAAU,WAAW,CAAmB,YAAe;IAE3D,MAAM,YAAY,GAAQ,EAAE,CAAC;IAC7B,MAAM,eAAe,GAAQ,EAAE,CAAC;IAChC,MAAM,SAAS,GAAQ,EAAE,CAAC;IAC1B,MAAM,OAAO,GAAQ,EAAE,CAAC;IAExB,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,MAAM,YAAY,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QACvC,MAAM,MAAM,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;QAE1C,MAAM,CAAC,cAAc,CAAC,YAAY,EAAE,GAAG,EAAE;YACvC,GAAG;gBACD,OAAO,MAAM,CAAC,KAAK,CAAC;YACtB,CAAC;SACF,CAAC,CAAC;QACH,MAAM,CAAC,cAAc,CAAC,eAAe,EAAE,GAAG,EAAE;YAC1C,GAAG;gBACD,OAAO,MAAM,CAAC,GAAG,EAAE,CAAC;YACtB,CAAC;SACF,CAAC,CAAC;QACH,SAAS,CAAC,MAAM,qBAAqB,CAAC,GAAa,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC;QAC1E,SAAS,CAAC,UAAU,qBAAqB,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAClD,EAAyB,EACzB,EAAE;YACF,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;QACjD,CAAC,CAAC;QACF,SAAS,CAAC,QAAQ,qBAAqB,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAChD,KAAoB,EACpB,EAAE;YACF,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC;QACrD,CAAC,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;IACxB,CAAC;IACD,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE;QACvB,OAAO,EAAE,CAAC,KAAiB,EAAE,EAAE;YAC7B,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;gBACxB,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;gBACzB,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,qBAAqB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAC/D,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;KACF,CAAC,CAAC;IAEH,OAAO;QACL,KAAK,EAAE,YAAY;QACnB,QAAQ,EAAE,eAAe;QACzB,WAAW,EAAE,GAAG,EAAE,CAAC,eAAe;QAClC,SAAS;QACT,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/esm/types.d.ts

@@ -0,0 +1,34 @@
+export type SignalListener = () => void;
+export type SetterPayload<T> = T | ((prev: T) => T);
+export type Signal<T> = {
+    readonly value: T;
+    setValue(arg: SetterPayload<T>): void;
+    subscribe(listener: SignalListener): () => void;
+    use(): T;
+};
+export type ComputedSignal<T> = {
+    readonly value: T;
+    subscribe(listener: SignalListener): () => void;
+    readonly snapshotValue: T;
+    use(): T;
+    cleanup(): void;
+};
+export type Mutations<T> = {
+    [K in keyof T as `set${Capitalize<K & string>}`]: (value: T[K] | ((prev: T[K]) => T[K])) => void;
+} & {
+    [K in keyof T as `produce${Capitalize<K & string>}`]: (fn: (draft: T[K]) => void) => void;
+} & {
+    [K in keyof T as `patch${Capitalize<K & string>}`]: (attrs: Partial<T[K]>) => void;
+} & {
+    assigns: (attrs: Partial<T>) => void;
+};
+export type Store<T extends object> = {
+    state: T;
+    snapshot: T;
+    useSnapshot(): T;
+    mutations: Mutations<T>;
+    signals: {
+        [K in keyof T]: Signal<T[K]>;
+    };
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC;AAExC,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;AAGpD,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI;IACtB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAClB,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACtC,SAAS,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,IAAI,CAAC;IAChD,GAAG,IAAI,CAAC,CAAC;CACV,CAAC;AAGF,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI;IAC9B,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAClB,SAAS,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,IAAI,CAAC;IAChD,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1B,GAAG,IAAI,CAAC,CAAC;IACT,OAAO,IAAI,IAAI,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI;KACxB,CAAC,IAAI,MAAM,CAAC,IAAI,MAAM,UAAU,CAAC,CAAC,GAAG,MAAM,CAAC,EAAE,GAAG,CAChD,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KACjC,IAAI;CACV,GAAG;KACD,CAAC,IAAI,MAAM,CAAC,IAAI,UAAU,UAAU,CAAC,CAAC,GAAG,MAAM,CAAC,EAAE,GAAG,CACpD,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,KACtB,IAAI;CACV,GAAG;KACD,CAAC,IAAI,MAAM,CAAC,IAAI,QAAQ,UAAU,CAAC,CAAC,GAAG,MAAM,CAAC,EAAE,GAAG,CAClD,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KACjB,IAAI;CACV,GAAG;IACF,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,KAAK,CAAC,CAAC,SAAS,MAAM,IAAI;IACpC,KAAK,EAAE,CAAC,CAAC;IACT,QAAQ,EAAE,CAAC,CAAC;IACZ,WAAW,IAAI,CAAC,CAAC;IACjB,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IACxB,OAAO,EAAE;SAAG,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KAAE,CAAC;CAC3C,CAAC"}

package/dist/esm/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "snap-store",
+  "version": "0.1.0",
+  "description": "An easy-to-use global state management library for React.",
+  "author": "yahiro",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/esm/index.js",
+  "types": "./dist/esm/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/esm/index.d.ts",
+      "import": "./dist/esm/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yahiro07/snap-store.git"
+  },
+  "bugs": {
+    "url": "https://github.com/yahiro07/snap-store/issues"
+  },
+  "homepage": "https://github.com/yahiro07/snap-store#readme",
+  "keywords": [
+    "react",
+    "state",
+    "management",
+    "store",
+    "signal",
+    "reactive",
+    "hooks"
+  ],
+  "scripts": {
+    "build:esm": "tsc --project tsconfig.esm.json",
+    "build": "npm run build:esm",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "immer": "^10.2.0"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.2.2",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}