atom.io 0.33.19 → 0.33.21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "atom.io",
-  "version": "0.33.19",
+  "version": "0.33.21",
   "description": "Composable and testable reactive data library.",
   "homepage": "https://atom.io.fyi",
   "sideEffects": false,
@@ -70,7 +70,7 @@
     "@types/estree": "1.0.8",
     "@types/http-proxy": "1.17.16",
     "@types/npmlog": "7.0.0",
-    "@types/react": "19.1.8",
+    "@types/react": "19.1.9",
     "@types/tmp": "0.2.6",
     "@typescript-eslint/parser": "8.38.0",
     "@typescript-eslint/rule-tester": "8.38.0",
@@ -79,11 +79,11 @@
     "@vitest/ui": "3.2.4",
     "concurrently": "9.2.0",
     "drizzle-kit": "0.31.4",
-    "drizzle-orm": "0.44.3",
+    "drizzle-orm": "0.44.4",
     "eslint": "9.32.0",
     "happy-dom": "18.0.1",
     "http-proxy": "1.18.1",
-    "motion": "12.23.11",
+    "motion": "12.23.12",
     "npmlog": "7.0.1",
     "nyc": "17.1.0",
     "postgres": "3.4.7",

package/src/internal/atom/create-regular-atom.ts

@@ -5,7 +5,7 @@ import type {
 	UpdateHandler,
 } from "atom.io"
 
-import { type RegularAtom, setIntoStore } from ".."
+import { type RegularAtom, resetInStore, setIntoStore } from ".."
 import { cacheValue } from "../caching"
 import { newest } from "../lineage"
 import type { Store } from "../store"
@@ -62,6 +62,9 @@ export function createRegularAtom<T>(
 		const cleanupFunctions: (() => void)[] = []
 		for (const effect of options.effects) {
 			const cleanup = effect({
+				resetSelf: () => {
+					resetInStore(store, token)
+				},
 				setSelf: (next) => {
 					setIntoStore(store, token, next)
 				},

package/src/internal/caching.ts

@@ -33,6 +33,7 @@ export function cacheValue<T>(
 	if (currentValue instanceof Future) {
 		const future = currentValue
 		if (value instanceof Promise) {
+			future.use(value)
 			return future
 		}
 		target.valueMap.set(key, value)

package/src/internal/mutable/create-mutable-atom.ts

@@ -8,7 +8,7 @@ import type { Json } from "atom.io/json"
 import { selectJson } from "atom.io/json"
 
 import type { MutableAtom } from ".."
-import { cacheValue, setIntoStore } from ".."
+import { cacheValue, resetInStore, setIntoStore } from ".."
 import { newest } from "../lineage"
 import { deposit, type Store } from "../store"
 import { Subject } from "../subject"
@@ -65,6 +65,9 @@ export function createMutableAtom<
 		const cleanupFunctions: (() => void)[] = []
 		for (const effect of options.effects) {
 			const cleanup = effect({
+				resetSelf: () => {
+					resetInStore(store, token)
+				},
 				setSelf: (next) => {
 					setIntoStore(store, token, next)
 				},

package/src/internal/set-state/reset-atom-or-selector.ts

@@ -1,4 +1,5 @@
-import { type Atom, traceAllSelectorAtoms, type WritableState } from ".."
+import type { Atom, WritableState } from ".."
+import { traceAllSelectorAtoms } from ".."
 import type { Store } from "../store"
 import { setAtom } from "./set-atom"
 

package/src/main/atom.ts

@@ -40,6 +40,10 @@ export function atom(
 
 /** @public */
 export type Effectors<T> = {
+	/**
+	 * Reset the value of the atom to its default
+	 */
+	resetSelf: () => void
 	/**
 	 * Set the value of the atom
 	 * @param next - The new value of the atom, or a setter function

package/src/react/use-loadable.ts

@@ -31,7 +31,7 @@ export function useLoadable(
 		| readonly [ReadableToken<any>, unknown]
 		| readonly [ReadableToken<any>]
 ): `LOADING` | { loading: boolean; value: unknown } {
-	let loadable: ReadableToken<any>
+	let state: unknown
 	let fallback: unknown
 
 	const [token] = params
@@ -43,7 +43,7 @@ export function useLoadable(
 		case `readonly_pure_selector`:
 		case `writable_held_selector`:
 		case `writable_pure_selector`:
-			loadable = useO(token)
+			state = useO(token)
 			fallback = params[1]
 			break
 		case `atom_family`:
@@ -53,27 +53,32 @@ export function useLoadable(
 		case `writable_held_selector_family`:
 		case `writable_pure_selector_family`:
 			key = params[1] as Canonical
-			loadable = useO(token, key)
+			state = useO(token, key)
 			fallback = params[2]
 	}
 
+	const wrapperRef = React.useRef({ loading: false, value: null as unknown })
 	const lastLoadedRef = React.useRef(
-		fallback ?? (loadable instanceof Promise ? `LOADING` : loadable),
+		fallback ?? (state instanceof Promise ? `LOADING` : state),
 	)
+
 	const { current: lastLoaded } = lastLoadedRef
-	if (loadable instanceof Promise) {
+	let { current: wrapper } = wrapperRef
+
+	if (state instanceof Promise) {
 		if (lastLoaded === `LOADING`) {
 			return `LOADING`
 		}
-		return {
-			loading: true,
-			value: lastLoaded,
+		wrapper = wrapperRef.current = { loading: true, value: lastLoaded }
+	} else {
+		lastLoadedRef.current = state
+		if (wrapper.loading === true) {
+			wrapper = wrapperRef.current = { loading: false, value: state }
+		} else {
+			wrapper.loading = false
+			wrapper.value = state
 		}
 	}
 
-	lastLoadedRef.current = loadable
-	return {
-		loading: false,
-		value: loadable,
-	}
+	return wrapper
 }