floppy-disk 3.0.0-alpha.1 → 3.0.0-alpha.2

package/esm/react/create-mutation.d.mts

@@ -1,4 +1,4 @@
-import { type InitStoreOptions, type SetState } from 'floppy-disk';
+import { type InitStoreOptions, type SetState } from 'floppy-disk/vanilla';
 /**
  * Represents the state of a mutation.
  *
@@ -90,8 +90,8 @@ export type MutationOptions<TData, TVariable> = InitStoreOptions<MutationState<T
  * const result = await useCreateUser.execute({ name: 'John' });
  */
 export declare const createMutation: <TData, TVariable = undefined>(mutationFn: (variable: TVariable, stateBeforeExecute: MutationState<TData, TVariable>) => Promise<TData>, options?: MutationOptions<TData, TVariable>) => (<TStateSlice = MutationState<TData, TVariable>>(selector?: (state: MutationState<TData, TVariable>) => TStateSlice) => TStateSlice) & {
-    subscribe: (subscriber: import("floppy-disk").Subscriber<MutationState<TData, TVariable>>) => () => void;
-    getSubscribers: () => Set<import("floppy-disk").Subscriber<MutationState<TData, TVariable>>>;
+    subscribe: (subscriber: import("../vanilla.d.mts").Subscriber<MutationState<TData, TVariable>>) => () => void;
+    getSubscribers: () => Set<import("../vanilla.d.mts").Subscriber<MutationState<TData, TVariable>>>;
     getState: () => MutationState<TData, TVariable>;
     /**
      * Manually updates the mutation state.

package/esm/react/create-query.d.mts

@@ -1,4 +1,4 @@
-import { type InitStoreOptions, type SetState } from 'floppy-disk';
+import { type InitStoreOptions, type SetState } from 'floppy-disk/vanilla';
 /**
  * Represents the state of a query.
  *
@@ -285,8 +285,8 @@ export declare const createQuery: <TData, TVariable extends Record<string, any>
      * - Should be used if an optimistic update fails.
      */
     rollbackOptimisticUpdate: () => TData;
-    subscribe: (subscriber: import("floppy-disk").Subscriber<QueryState<TData>>) => () => void;
-    getSubscribers: () => Set<import("floppy-disk").Subscriber<QueryState<TData>>>;
+    subscribe: (subscriber: import("../vanilla.d.mts").Subscriber<QueryState<TData>>) => () => void;
+    getSubscribers: () => Set<import("../vanilla.d.mts").Subscriber<QueryState<TData>>>;
     getState: () => QueryState<TData>;
     setState: (value: SetState<QueryState<TData>>) => void;
 }) & {

package/esm/react/create-store.d.mts

@@ -1,4 +1,4 @@
-import { type InitStoreOptions } from 'floppy-disk';
+import { type InitStoreOptions } from 'floppy-disk/vanilla';
 /**
  * Creates a single store with a bound React hook.
  *
@@ -22,4 +22,4 @@ import { type InitStoreOptions } from 'floppy-disk';
  *
  * useCounter.setState({ count: 1 });
  */
-export declare const createStore: <TState extends Record<string, any>>(initialState: TState, options?: InitStoreOptions<TState>) => (<TStateSlice = TState>(selector?: (state: TState) => TStateSlice) => TStateSlice) & import("floppy-disk").StoreApi<TState>;
+export declare const createStore: <TState extends Record<string, any>>(initialState: TState, options?: InitStoreOptions<TState>) => (<TStateSlice = TState>(selector?: (state: TState) => TStateSlice) => TStateSlice) & import("../vanilla.d.mts").StoreApi<TState>;

package/esm/react/create-stores.d.mts

@@ -1,4 +1,4 @@
-import { type InitStoreOptions } from 'floppy-disk';
+import { type InitStoreOptions } from 'floppy-disk/vanilla';
 /**
  * Creates a factory for multiple stores identified by a key.
  *
@@ -25,8 +25,8 @@ import { type InitStoreOptions } from 'floppy-disk';
  */
 export declare const createStores: <TState extends Record<string, any>, TKey extends Record<string, any>>(initialState: TState, options?: InitStoreOptions<TState>) => (key?: TKey) => (<TStateSlice = TState>(selector?: (state: TState) => TStateSlice) => TStateSlice) & {
     delete: () => boolean;
-    setState: (value: import("floppy-disk").SetState<TState>) => void;
+    setState: (value: import("../vanilla.d.mts").SetState<TState>) => void;
     getState: () => TState;
-    subscribe: (subscriber: import("floppy-disk").Subscriber<TState>) => () => void;
-    getSubscribers: () => Set<import("floppy-disk").Subscriber<TState>>;
+    subscribe: (subscriber: import("../vanilla.d.mts").Subscriber<TState>) => () => void;
+    getSubscribers: () => Set<import("../vanilla.d.mts").Subscriber<TState>>;
 };

package/esm/react/use-store.d.mts

@@ -1,4 +1,4 @@
-import { type StoreApi } from 'floppy-disk';
+import { type StoreApi } from 'floppy-disk/vanilla';
 export declare const useStoreUpdateNotifier: <TState extends Record<string, any>, TStateSlice = TState>(store: StoreApi<TState>, selector: (state: TState) => TStateSlice) => void;
 /**
  * React hook for subscribing to a store with optional state selection.

package/esm/react.mjs

@@ -1,5 +1,5 @@
 import { useLayoutEffect, useEffect, useState, useRef } from 'react';
-import { isClient, identity, shallow, initStore, getHash, noop } from 'floppy-disk';
+import { isClient, identity, shallow, initStore, getHash, noop } from 'floppy-disk/vanilla';
 
 const useIsomorphicLayoutEffect = isClient ? useLayoutEffect : useEffect;
 

package/esm/vanilla/store.d.mts

@@ -13,16 +13,16 @@ export type SetState<TState> = Partial<TState> | ((state: TState) => Partial<TSt
  * @param prevState - The previous state before the update
  *
  * @remarks
- * - Subscribers are always called on every `setState`, regardless of equality.
- * - It is the subscriber's responsibility to perform comparisons if needed.
+ * - Subscribers are only called when the state actually changes.
+ * - Change detection is performed per key using `Object.is`.
  */
 export type Subscriber<TState> = (state: TState, prevState: TState) => void;
 /**
  * Core store API for managing state.
  *
  * @remarks
- * - The store is intentionally simple and always notifies subscribers on updates.
- * - No internal equality checks are performed.
+ * - The store performs **shallow change detection per key** before notifying subscribers.
+ * - Subscribers are only notified when at least one field changes.
  * - Designed to be framework-agnostic (React bindings are built separately).
  */
 export type StoreApi<TState extends Record<string, any>> = {

package/package.json

@@ -2,7 +2,7 @@
   "name": "floppy-disk",
   "description": "Lightweight, simple, and powerful state management library",
   "private": false,
-  "version": "3.0.0-alpha.1",
+  "version": "3.0.0-alpha.2",
   "publishConfig": {
     "tag": "alpha"
   },

package/react/create-mutation.d.ts

@@ -1,4 +1,4 @@
-import { type InitStoreOptions, type SetState } from 'floppy-disk';
+import { type InitStoreOptions, type SetState } from 'floppy-disk/vanilla';
 /**
  * Represents the state of a mutation.
  *
@@ -90,8 +90,8 @@ export type MutationOptions<TData, TVariable> = InitStoreOptions<MutationState<T
  * const result = await useCreateUser.execute({ name: 'John' });
  */
 export declare const createMutation: <TData, TVariable = undefined>(mutationFn: (variable: TVariable, stateBeforeExecute: MutationState<TData, TVariable>) => Promise<TData>, options?: MutationOptions<TData, TVariable>) => (<TStateSlice = MutationState<TData, TVariable>>(selector?: (state: MutationState<TData, TVariable>) => TStateSlice) => TStateSlice) & {
-    subscribe: (subscriber: import("floppy-disk").Subscriber<MutationState<TData, TVariable>>) => () => void;
-    getSubscribers: () => Set<import("floppy-disk").Subscriber<MutationState<TData, TVariable>>>;
+    subscribe: (subscriber: import("../vanilla.ts").Subscriber<MutationState<TData, TVariable>>) => () => void;
+    getSubscribers: () => Set<import("../vanilla.ts").Subscriber<MutationState<TData, TVariable>>>;
     getState: () => MutationState<TData, TVariable>;
     /**
      * Manually updates the mutation state.

package/react/create-query.d.ts

@@ -1,4 +1,4 @@
-import { type InitStoreOptions, type SetState } from 'floppy-disk';
+import { type InitStoreOptions, type SetState } from 'floppy-disk/vanilla';
 /**
  * Represents the state of a query.
  *
@@ -285,8 +285,8 @@ export declare const createQuery: <TData, TVariable extends Record<string, any>
      * - Should be used if an optimistic update fails.
      */
     rollbackOptimisticUpdate: () => TData;
-    subscribe: (subscriber: import("floppy-disk").Subscriber<QueryState<TData>>) => () => void;
-    getSubscribers: () => Set<import("floppy-disk").Subscriber<QueryState<TData>>>;
+    subscribe: (subscriber: import("../vanilla.ts").Subscriber<QueryState<TData>>) => () => void;
+    getSubscribers: () => Set<import("../vanilla.ts").Subscriber<QueryState<TData>>>;
     getState: () => QueryState<TData>;
     setState: (value: SetState<QueryState<TData>>) => void;
 }) & {

package/react/create-store.d.ts

@@ -1,4 +1,4 @@
-import { type InitStoreOptions } from 'floppy-disk';
+import { type InitStoreOptions } from 'floppy-disk/vanilla';
 /**
  * Creates a single store with a bound React hook.
  *
@@ -22,4 +22,4 @@ import { type InitStoreOptions } from 'floppy-disk';
  *
  * useCounter.setState({ count: 1 });
  */
-export declare const createStore: <TState extends Record<string, any>>(initialState: TState, options?: InitStoreOptions<TState>) => (<TStateSlice = TState>(selector?: (state: TState) => TStateSlice) => TStateSlice) & import("floppy-disk").StoreApi<TState>;
+export declare const createStore: <TState extends Record<string, any>>(initialState: TState, options?: InitStoreOptions<TState>) => (<TStateSlice = TState>(selector?: (state: TState) => TStateSlice) => TStateSlice) & import("../vanilla.ts").StoreApi<TState>;

package/react/create-stores.d.ts

@@ -1,4 +1,4 @@
-import { type InitStoreOptions } from 'floppy-disk';
+import { type InitStoreOptions } from 'floppy-disk/vanilla';
 /**
  * Creates a factory for multiple stores identified by a key.
  *
@@ -25,8 +25,8 @@ import { type InitStoreOptions } from 'floppy-disk';
  */
 export declare const createStores: <TState extends Record<string, any>, TKey extends Record<string, any>>(initialState: TState, options?: InitStoreOptions<TState>) => (key?: TKey) => (<TStateSlice = TState>(selector?: (state: TState) => TStateSlice) => TStateSlice) & {
     delete: () => boolean;
-    setState: (value: import("floppy-disk").SetState<TState>) => void;
+    setState: (value: import("../vanilla.ts").SetState<TState>) => void;
     getState: () => TState;
-    subscribe: (subscriber: import("floppy-disk").Subscriber<TState>) => () => void;
-    getSubscribers: () => Set<import("floppy-disk").Subscriber<TState>>;
+    subscribe: (subscriber: import("../vanilla.ts").Subscriber<TState>) => () => void;
+    getSubscribers: () => Set<import("../vanilla.ts").Subscriber<TState>>;
 };

package/react/use-store.d.ts

@@ -1,4 +1,4 @@
-import { type StoreApi } from 'floppy-disk';
+import { type StoreApi } from 'floppy-disk/vanilla';
 export declare const useStoreUpdateNotifier: <TState extends Record<string, any>, TStateSlice = TState>(store: StoreApi<TState>, selector: (state: TState) => TStateSlice) => void;
 /**
  * React hook for subscribing to a store with optional state selection.

package/react.js

@@ -1,9 +1,9 @@
 'use strict';
 
 var react = require('react');
-var floppyDisk = require('floppy-disk');
+var vanilla = require('floppy-disk/vanilla');
 
-const useIsomorphicLayoutEffect = floppyDisk.isClient ? react.useLayoutEffect : react.useEffect;
+const useIsomorphicLayoutEffect = vanilla.isClient ? react.useLayoutEffect : react.useEffect;
 
 const useStoreUpdateNotifier = (store, selector) => {
   const [, reRender] = react.useState({});
@@ -11,21 +11,21 @@ const useStoreUpdateNotifier = (store, selector) => {
   selectorRef.current = selector;
   useIsomorphicLayoutEffect(
     () => store.subscribe((state, prevState) => {
-      if (selectorRef.current === floppyDisk.identity) return reRender({});
+      if (selectorRef.current === vanilla.identity) return reRender({});
       const prevSlice = selectorRef.current(prevState);
       const nextSlice = selectorRef.current(state);
-      if (!floppyDisk.shallow(prevSlice, nextSlice)) reRender({});
+      if (!vanilla.shallow(prevSlice, nextSlice)) reRender({});
     }),
     [store]
   );
 };
-const useStoreState = (store, selector = floppyDisk.identity) => {
+const useStoreState = (store, selector = vanilla.identity) => {
   useStoreUpdateNotifier(store, selector);
   return selector(store.getState());
 };
 
 const createStore = (initialState, options) => {
-  const store = floppyDisk.initStore(initialState, options);
+  const store = vanilla.initStore(initialState, options);
   const useStore = (selector) => useStoreState(store, selector);
   return Object.assign(useStore, store);
 };
@@ -33,12 +33,12 @@ const createStore = (initialState, options) => {
 const createStores = (initialState, options) => {
   const stores = /* @__PURE__ */ new Map();
   const getStore = (key = {}) => {
-    const keyHash = floppyDisk.getHash(key);
+    const keyHash = vanilla.getHash(key);
     let store;
     if (stores.has(keyHash)) {
       store = stores.get(keyHash);
     } else {
-      store = floppyDisk.initStore(initialState, options);
+      store = vanilla.initStore(initialState, options);
       stores.set(keyHash, store);
     }
     const useStore = (selector) => {
@@ -82,9 +82,9 @@ const createQuery = (queryFn, options = {}) => {
     // 5 minutes
     revalidateOnFocus = true,
     revalidateOnReconnect = true,
-    onSuccess = floppyDisk.noop,
+    onSuccess = vanilla.noop,
     onError,
-    onSettled = floppyDisk.noop,
+    onSettled = vanilla.noop,
     shouldRetry: shouldRetryFn = (_, s) => s.retryCount === 0 ? [true, 1500] : [false]
   } = options;
   const initialState = INITIAL_STATE$1;
@@ -96,7 +96,7 @@ const createQuery = (queryFn, options = {}) => {
       (_a = options.onFirstSubscribe) == null ? void 0 : _a.call(options, state, store);
       const { metadata, revalidate: revalidate2 } = internals.get(store);
       clearTimeout(metadata.garbageCollectionTimeoutId);
-      if (floppyDisk.isClient) {
+      if (vanilla.isClient) {
         if (revalidateOnFocus) {
           focusListeners.add(revalidate2);
           if (!focusListenersAdded) {
@@ -123,7 +123,7 @@ const createQuery = (queryFn, options = {}) => {
       metadata.garbageCollectionTimeoutId = setTimeout(() => {
         store.setState(initialState);
       }, gcTime);
-      if (floppyDisk.isClient) {
+      if (vanilla.isClient) {
         if (revalidateOnFocus) {
           focusListeners.delete(revalidate2);
           if (focusListeners.size === 0) {
@@ -316,16 +316,16 @@ const createQuery = (queryFn, options = {}) => {
     return execute(store, variable, overwriteOngoingExecution);
   };
   const getStore = (variable = {}) => {
-    const variableHash = floppyDisk.getHash(variable);
+    const variableHash = vanilla.getHash(variable);
     let store;
     if (stores.has(variableHash)) {
       store = stores.get(variableHash);
     } else {
-      store = floppyDisk.initStore(initialState, configureStoreEvents());
+      store = vanilla.initStore(initialState, configureStoreEvents());
       stores.set(variableHash, store);
       internals.set(store, configureInternals(store, variable, variableHash));
     }
-    const useStore = (options2 = {}, selector = floppyDisk.identity) => {
+    const useStore = (options2 = {}, selector = vanilla.identity) => {
       useStoreUpdateNotifier(store, selector);
       useIsomorphicLayoutEffect(() => {
         if (options2.enabled !== false) revalidate(store, variable);
@@ -407,9 +407,9 @@ const INITIAL_STATE = {
   errorUpdatedAt: void 0
 };
 const createMutation = (mutationFn, options = {}) => {
-  const { onSuccess = floppyDisk.noop, onError, onSettled = floppyDisk.noop } = options;
+  const { onSuccess = vanilla.noop, onError, onSettled = vanilla.noop } = options;
   const initialState = INITIAL_STATE;
-  const store = floppyDisk.initStore(initialState, options);
+  const store = vanilla.initStore(initialState, options);
   const useStore = (selector) => useStoreState(store, selector);
   const execute = (variable) => {
     const stateBeforeExecute = store.getState();

package/vanilla/store.d.ts

@@ -13,16 +13,16 @@ export type SetState<TState> = Partial<TState> | ((state: TState) => Partial<TSt
  * @param prevState - The previous state before the update
  *
  * @remarks
- * - Subscribers are always called on every `setState`, regardless of equality.
- * - It is the subscriber's responsibility to perform comparisons if needed.
+ * - Subscribers are only called when the state actually changes.
+ * - Change detection is performed per key using `Object.is`.
  */
 export type Subscriber<TState> = (state: TState, prevState: TState) => void;
 /**
  * Core store API for managing state.
  *
  * @remarks
- * - The store is intentionally simple and always notifies subscribers on updates.
- * - No internal equality checks are performed.
+ * - The store performs **shallow change detection per key** before notifying subscribers.
+ * - Subscribers are only notified when at least one field changes.
  * - Designed to be framework-agnostic (React bindings are built separately).
  */
 export type StoreApi<TState extends Record<string, any>> = {