@plastic-js/plastic 1.0.1 → 1.0.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plastic-js/plastic",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "main": "src/index.js",
   "access": "public",
   "sideEffects": false,
@@ -57,7 +57,7 @@
     "@babel/core": "^7.29.0",
     "@babel/preset-react": "^7.28.5",
     "@testing-library/jest-dom": "^6.9.1",
-    "babel-preset-plastic": "^0.1.0",
+    "babel-preset-plastic": "^0.1.1",
     "@vitejs/plugin-react": "^6.0.2",
     "@vitejs/plugin-vue": "^6.0.7",
     "eslint": "^9.39.2",

package/src/async.js

@@ -0,0 +1,88 @@
+import { createSignal } from './reactivity.js'
+
+const normalizeService = (service)=> {
+	if (typeof service === 'function'){
+		return service
+	}
+
+	if (service instanceof Promise){
+		return ()=> service
+	}
+
+	throw new TypeError('createAsync expects a Promise or a function returning a Promise')
+}
+
+const createAsync = (service)=> {
+	const runner = normalizeService(service)
+	const isLoading = createSignal(false)
+	const data = createSignal(undefined)
+	const error = createSignal(null)
+	let latestRunId = 0
+
+	const run = (...args)=> {
+		const runId = ++latestRunId
+		isLoading(true)
+		error(null)
+
+		let promise
+		try {
+			promise = runner(...args)
+		} catch(err){
+			error(err)
+			isLoading(false)
+			return Promise.reject(err)
+		}
+
+		if (!(promise instanceof Promise)){
+			const typeError = new TypeError('createAsync runner must return a Promise')
+			error(typeError)
+			isLoading(false)
+			return Promise.reject(typeError)
+		}
+
+		return promise
+			.then((value)=> {
+				if (runId !== latestRunId){
+					return value
+				}
+
+				data(value)
+				error(null)
+				return value
+			})
+			.catch((err)=> {
+				if (runId === latestRunId){
+					error(err)
+				}
+				throw err
+			})
+			.finally(()=> {
+				if (runId === latestRunId){
+					isLoading(false)
+				}
+			})
+	}
+
+	const cancel = ()=> {
+		if (!isLoading()){
+			return
+		}
+		latestRunId++
+		isLoading(false)
+	}
+
+	// Default behavior: trigger once on creation for immediate data fetch.
+	run().catch(()=> {})
+
+	return {
+		isLoading,
+		data,
+		error,
+		run,
+		cancel,
+	}
+}
+
+export {
+	createAsync,
+}

package/src/computation-context.js

@@ -1,3 +1,9 @@
+// Shared module-level state for the currently running computation.
+// Extracted into its own module so the two consumers can share the same
+// reference without forming a circular import between them:
+//   - the computation runner writes it before/after executing a tracked fn
+//   - the signal/state layer reads it when a signal is invoked (e.g.
+//     `signal()`) to register the running computation as a dependency
 let currentComputation = null
 
 const getCurrentComputation = ()=> currentComputation

package/src/index.js

@@ -39,6 +39,7 @@ import {
 	useSearchParams,
 } from './router.js'
 import { batch } from './reactivity.js'
+import { createAsync } from './async.js'
 import { mergeProps } from './merge-props.js'
 import { createSplitProps, splitProps } from './split-props.js'
 
@@ -80,6 +81,7 @@ export {
 	createContext,
 	useContext,
 	batch,
+	createAsync,
 	mergeProps,
 	splitProps,
 	createSplitProps,