floppy-disk 3.7.3 → 3.9.0-beta.1

package/esm/index.d.mts

@@ -1 +1 @@
-export * from "./vanilla.mjs";
+export * from "floppy-disk/vanilla";

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

@@ -1,4 +1,4 @@
-import { type InitStoreOptions, type SetStateInput } from "../vanilla.mjs";
+import { type InitStoreOptions, type SetStateInput } from "floppy-disk/vanilla";
 /**
  * Represents the state of a mutation.
  *

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

@@ -1,4 +1,4 @@
-import { type InitStoreOptions, type SetStateInput } from "../vanilla.mjs";
+import { type InitStoreOptions, type SetStateInput } from "floppy-disk/vanilla";
 import type { StoreKey } from "./create-stores.mjs";
 /**
  * Represents the state of a query.

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

@@ -1,4 +1,4 @@
-import { type InitStoreOptions } from "../vanilla.mjs";
+import { type InitStoreOptions } from "floppy-disk/vanilla";
 /**
  * Creates a single store with a bound React hook.
  *

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

@@ -1,4 +1,4 @@
-import { type InitStoreOptions, type StoreApi } from "../vanilla.mjs";
+import { type InitStoreOptions, type StoreApi } from "floppy-disk/vanilla";
 type GoodInputForHash = string | number | boolean | null | Date;
 export type StoreKey = GoodInputForHash | {
     [key: string | number]: StoreKey | StoreKey[];

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

@@ -1,4 +1,4 @@
-import { type InitStoreOptions, type SetStateInput } from "../vanilla.mjs";
+import { type InitStoreOptions, type SetStateInput } from "floppy-disk/vanilla";
 import type { StoreKey } from "./create-stores.mjs";
 type StreamDataState<TData, TError> = {
     state: "INITIAL";
@@ -230,65 +230,23 @@ export type StreamOptions<TConnection, TData, TError = Error> = InitStoreOptions
  * @returns A function to retrieve or create a stream instance by variable
  *
  * @remarks
- * This utility is designed for **long-lived, push-based async sources**, such as:
- * - WebSocket
- * - Server-Sent Events (SSE)
- * - Firebase / realtime databases
- *
- * ---
- *
- * ## Key concepts
- *
- * ### 1. Connection lifecycle (managed automatically)
- *
- * - Connection is established when needed (e.g. first subscriber)
- * - Connection may be disconnected based on triggers:
- *   - no subscribers
- *   - tab hidden
- *   - offline
- * - Reconnection is controlled via `reconnectOn`
- *
- * ---
- *
- * ### 2. Data flow (push-based)
- *
- * The `connect` function receives an `emit` API:
- *
- * - `emit.connected()` → mark connection as established
- * - `emit.data(fn)` → update data using reducer
- * - `emit.error(err)` → report error
- *
- * Data updates are **incremental** and controlled by the stream source.
- *
- * ---
- *
- * ### 3. Store-per-variable
- *
- * - Each unique `variable` creates a separate stream instance
- * - Variables are deterministically hashed for stable identity
- * - Each instance manages its own:
- *   - connection
- *   - state
- *   - subscribers
- *
- * ---
- *
- * ### 4. React integration (Proxy-based)
- *
- * - The returned hook exposes the full state as a Proxy
- * - Components automatically subscribe to accessed properties
- * - No selector or memoization is required
+ * - Designed for **long-lived, push-based async sources**, such as: WebSocket, SSE, realtime databases
+ * - A stream consists of two independent concerns:
+ *   1. **Connection state** — lifecycle of the underlying connection
+ *   2. **Data state** — lifecycle of emitted data
+ * - Connection lifecycle:
+ *   - Connection is established when needed (e.g. first subscriber)
+ *   - Connection may be disconnected based on triggers: no subscribers, tab hidden, offline
+ * - Streams are **keyed by variable** (via deterministic hashing).
+ * - Each unique variable maps to its own stream instance.
  *
  * ---
  *
  * ## Execution model
  *
- * - Streams are **lazy**:
- *   - No connection until there is a subscriber
- * - Streams are **shared**:
- *   - Multiple subscribers reuse the same connection
- * - Streams are **stateful**:
- *   - Data persists across reconnects (unless reset or GC)
+ * - Streams are **lazy**: No connection until there is a subscriber
+ * - Streams are **shared**: Multiple subscribers reuse the same connection
+ * - Streams are **stateful**: Data persists across reconnects (unless reset or GC)
  *
  * ---
  *
@@ -316,7 +274,7 @@ export type StreamOptions<TConnection, TData, TError = Error> = InitStoreOptions
  *   return <div>{state.data?.length}</div>;
  * }
  */
-export declare const experimental_createStream: <TConnection, TData, TVariable extends StoreKey, TError = Error>(connect: (variable: TVariable, emit: {
+export declare const createStream: <TConnection, TData, TVariable extends StoreKey, TError = Error>(connect: (variable: TVariable, emit: {
     connected: () => void;
     data: (reducer: (data: TData | undefined) => TData) => void;
     error: (error: TError) => void;

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

@@ -1,4 +1,4 @@
-import { type StoreApi } from "../vanilla.mjs";
+import { type StoreApi } from "floppy-disk/vanilla";
 type Path = Array<string | number | symbol>;
 export declare const getValueByPath: (obj: any, path: Path) => any;
 export declare const isPrefixPath: (candidatePrefix: Path, targetPath: Path) => boolean;

package/esm/react.mjs

@@ -52,7 +52,7 @@ const useStoreStateProxy = (storeState) => {
 const NO_INITIAL_VALUE = {};
 const useStoreStateWithInitializer = (store, initialState = NO_INITIAL_VALUE) => {
   const initiatedAt = useRef(new WeakMap([[store, 0]]));
-  useIsomorphicLayoutEffect(() => {
+  useEffect(() => {
     if (initialState === NO_INITIAL_VALUE || initiatedAt.current.get(store)) return;
     store.setState(initialState);
     initiatedAt.current.set(store, Date.now());
@@ -65,7 +65,7 @@ const useStoreState = (store, options = {}) => {
   const [state] = useStoreStateWithInitializer(store, options.initialState);
   const [trackedState, usedPathsRef] = useStoreStateProxy(state);
   const [, reRender] = useState({});
-  useIsomorphicLayoutEffect(() => {
+  useEffect(() => {
     return store.subscribe((nextState, prevState, changedKeys) => {
       const paths = compressPaths(usedPathsRef.current);
       for (const path of paths) {
@@ -445,7 +445,7 @@ const createQuery = (queryFn, options = {}) => {
         ) : storeStateToBeUsed
       );
       const [, reRender] = useState({});
-      useIsomorphicLayoutEffect(() => {
+      useEffect(() => {
         return store.subscribe((nextState, prevState2, changedKeys) => {
           if (prevState2.state === "INITIAL" && !prevState2.isPending && nextState.isPending && !nextState.isRetrying) {
             return;
@@ -460,7 +460,7 @@ const createQuery = (queryFn, options = {}) => {
           }
         });
       }, [store]);
-      useIsomorphicLayoutEffect(() => {
+      useEffect(() => {
         if (revalidateOnMount !== false) {
           if (!initialDataIsStale) {
             const dataInitiatedAt = initialDataInitiatedAt.current.get(store);
@@ -769,7 +769,7 @@ const INITIAL_STATE = {
   error: void 0,
   errorUpdatedAt: void 0
 };
-const experimental_createStream = (connect, disconnect, options = {}) => {
+const createStream = (connect, disconnect, options = {}) => {
   const {
     disconnectOn = () => 5e3,
     // 5 seconds after any `DisconnectTrigger`
@@ -1002,4 +1002,4 @@ const offlineListeners = /* @__PURE__ */ new Set();
 const onWindowOffline = () => [...offlineListeners].forEach((fn) => fn());
 let listenersAdded = false;
 
-export { createMutation, createQuery, createStore, createStores, experimental_createStream, useIsomorphicLayoutEffect, useMutation, useStoreState };
+export { createMutation, createQuery, createStore, createStores, createStream, useIsomorphicLayoutEffect, useMutation, useStoreState };

package/index.d.ts

@@ -1 +1 @@
-export * from "./vanilla.ts";
+export * from "floppy-disk/vanilla";

package/package.json

@@ -2,7 +2,10 @@
   "name": "floppy-disk",
   "description": "Lightweight unified state management for sync and async data.",
   "private": false,
-  "version": "3.7.3",
+  "version": "3.9.0-beta.1",
+  "publishConfig": {
+    "tag": "beta"
+  },
   "keywords": [
     "utilities",
     "store",

package/react/create-mutation.d.ts

@@ -1,4 +1,4 @@
-import { type InitStoreOptions, type SetStateInput } from "../vanilla.ts";
+import { type InitStoreOptions, type SetStateInput } from "floppy-disk/vanilla";
 /**
  * Represents the state of a mutation.
  *

package/react/create-query.d.ts

@@ -1,4 +1,4 @@
-import { type InitStoreOptions, type SetStateInput } from "../vanilla.ts";
+import { type InitStoreOptions, type SetStateInput } from "floppy-disk/vanilla";
 import type { StoreKey } from "./create-stores.ts";
 /**
  * Represents the state of a query.

package/react/create-store.d.ts

@@ -1,4 +1,4 @@
-import { type InitStoreOptions } from "../vanilla.ts";
+import { type InitStoreOptions } from "floppy-disk/vanilla";
 /**
  * Creates a single store with a bound React hook.
  *

package/react/create-stores.d.ts

@@ -1,4 +1,4 @@
-import { type InitStoreOptions, type StoreApi } from "../vanilla.ts";
+import { type InitStoreOptions, type StoreApi } from "floppy-disk/vanilla";
 type GoodInputForHash = string | number | boolean | null | Date;
 export type StoreKey = GoodInputForHash | {
     [key: string | number]: StoreKey | StoreKey[];

package/react/create-stream.d.ts

@@ -1,4 +1,4 @@
-import { type InitStoreOptions, type SetStateInput } from "../vanilla.ts";
+import { type InitStoreOptions, type SetStateInput } from "floppy-disk/vanilla";
 import type { StoreKey } from "./create-stores.ts";
 type StreamDataState<TData, TError> = {
     state: "INITIAL";
@@ -230,65 +230,23 @@ export type StreamOptions<TConnection, TData, TError = Error> = InitStoreOptions
  * @returns A function to retrieve or create a stream instance by variable
  *
  * @remarks
- * This utility is designed for **long-lived, push-based async sources**, such as:
- * - WebSocket
- * - Server-Sent Events (SSE)
- * - Firebase / realtime databases
- *
- * ---
- *
- * ## Key concepts
- *
- * ### 1. Connection lifecycle (managed automatically)
- *
- * - Connection is established when needed (e.g. first subscriber)
- * - Connection may be disconnected based on triggers:
- *   - no subscribers
- *   - tab hidden
- *   - offline
- * - Reconnection is controlled via `reconnectOn`
- *
- * ---
- *
- * ### 2. Data flow (push-based)
- *
- * The `connect` function receives an `emit` API:
- *
- * - `emit.connected()` → mark connection as established
- * - `emit.data(fn)` → update data using reducer
- * - `emit.error(err)` → report error
- *
- * Data updates are **incremental** and controlled by the stream source.
- *
- * ---
- *
- * ### 3. Store-per-variable
- *
- * - Each unique `variable` creates a separate stream instance
- * - Variables are deterministically hashed for stable identity
- * - Each instance manages its own:
- *   - connection
- *   - state
- *   - subscribers
- *
- * ---
- *
- * ### 4. React integration (Proxy-based)
- *
- * - The returned hook exposes the full state as a Proxy
- * - Components automatically subscribe to accessed properties
- * - No selector or memoization is required
+ * - Designed for **long-lived, push-based async sources**, such as: WebSocket, SSE, realtime databases
+ * - A stream consists of two independent concerns:
+ *   1. **Connection state** — lifecycle of the underlying connection
+ *   2. **Data state** — lifecycle of emitted data
+ * - Connection lifecycle:
+ *   - Connection is established when needed (e.g. first subscriber)
+ *   - Connection may be disconnected based on triggers: no subscribers, tab hidden, offline
+ * - Streams are **keyed by variable** (via deterministic hashing).
+ * - Each unique variable maps to its own stream instance.
  *
  * ---
  *
  * ## Execution model
  *
- * - Streams are **lazy**:
- *   - No connection until there is a subscriber
- * - Streams are **shared**:
- *   - Multiple subscribers reuse the same connection
- * - Streams are **stateful**:
- *   - Data persists across reconnects (unless reset or GC)
+ * - Streams are **lazy**: No connection until there is a subscriber
+ * - Streams are **shared**: Multiple subscribers reuse the same connection
+ * - Streams are **stateful**: Data persists across reconnects (unless reset or GC)
  *
  * ---
  *
@@ -316,7 +274,7 @@ export type StreamOptions<TConnection, TData, TError = Error> = InitStoreOptions
  *   return <div>{state.data?.length}</div>;
  * }
  */
-export declare const experimental_createStream: <TConnection, TData, TVariable extends StoreKey, TError = Error>(connect: (variable: TVariable, emit: {
+export declare const createStream: <TConnection, TData, TVariable extends StoreKey, TError = Error>(connect: (variable: TVariable, emit: {
     connected: () => void;
     data: (reducer: (data: TData | undefined) => TData) => void;
     error: (error: TError) => void;

package/react/use-store.d.ts

@@ -1,4 +1,4 @@
-import { type StoreApi } from "../vanilla.ts";
+import { type StoreApi } from "floppy-disk/vanilla";
 type Path = Array<string | number | symbol>;
 export declare const getValueByPath: (obj: any, path: Path) => any;
 export declare const isPrefixPath: (candidatePrefix: Path, targetPath: Path) => boolean;

package/react.js

@@ -54,7 +54,7 @@ const useStoreStateProxy = (storeState) => {
 const NO_INITIAL_VALUE = {};
 const useStoreStateWithInitializer = (store, initialState = NO_INITIAL_VALUE) => {
   const initiatedAt = react.useRef(new WeakMap([[store, 0]]));
-  useIsomorphicLayoutEffect(() => {
+  react.useEffect(() => {
     if (initialState === NO_INITIAL_VALUE || initiatedAt.current.get(store)) return;
     store.setState(initialState);
     initiatedAt.current.set(store, Date.now());
@@ -67,7 +67,7 @@ const useStoreState = (store, options = {}) => {
   const [state] = useStoreStateWithInitializer(store, options.initialState);
   const [trackedState, usedPathsRef] = useStoreStateProxy(state);
   const [, reRender] = react.useState({});
-  useIsomorphicLayoutEffect(() => {
+  react.useEffect(() => {
     return store.subscribe((nextState, prevState, changedKeys) => {
       const paths = compressPaths(usedPathsRef.current);
       for (const path of paths) {
@@ -447,7 +447,7 @@ const createQuery = (queryFn, options = {}) => {
         ) : storeStateToBeUsed
       );
       const [, reRender] = react.useState({});
-      useIsomorphicLayoutEffect(() => {
+      react.useEffect(() => {
         return store.subscribe((nextState, prevState2, changedKeys) => {
           if (prevState2.state === "INITIAL" && !prevState2.isPending && nextState.isPending && !nextState.isRetrying) {
             return;
@@ -462,7 +462,7 @@ const createQuery = (queryFn, options = {}) => {
           }
         });
       }, [store]);
-      useIsomorphicLayoutEffect(() => {
+      react.useEffect(() => {
         if (revalidateOnMount !== false) {
           if (!initialDataIsStale) {
             const dataInitiatedAt = initialDataInitiatedAt.current.get(store);
@@ -771,7 +771,7 @@ const INITIAL_STATE = {
   error: void 0,
   errorUpdatedAt: void 0
 };
-const experimental_createStream = (connect, disconnect, options = {}) => {
+const createStream = (connect, disconnect, options = {}) => {
   const {
     disconnectOn = () => 5e3,
     // 5 seconds after any `DisconnectTrigger`
@@ -1008,7 +1008,7 @@ exports.createMutation = createMutation;
 exports.createQuery = createQuery;
 exports.createStore = createStore;
 exports.createStores = createStores;
-exports.experimental_createStream = experimental_createStream;
+exports.createStream = createStream;
 exports.useIsomorphicLayoutEffect = useIsomorphicLayoutEffect;
 exports.useMutation = useMutation;
 exports.useStoreState = useStoreState;