@atolljs/react 0.1.12 → 0.1.14

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+import type { AsyncTask, ObservableValue, PathConnector, SharedMemory, SharedSpec, SpecPath, SliceOptions } from '@atolljs/core';
+/**
+ * Subscribe to any sdk ObservableValue (task snapshot, field observable).
+ * SSR-safe: `getServerSnapshot` reuses `get`, which yields `undefined` for
+ * fields on unbound contracts.
+ */
+export declare function useObservable<T>(source: ObservableValue<T>): T;
+/**
+ * Bind one shared-memory field to React state. Returns `undefined` until the
+ * contract is bound and the field written; re-renders on every write.
+ */
+export declare function useSharedValue<S extends SharedSpec, K extends SpecPath<S>>(memory: SharedMemory<S>, key: K): (PathConnector<S, K> extends {
+    read(): infer T;
+} ? T : never) | undefined;
+export declare function useSharedValue<S extends SharedSpec, K extends SpecPath<S>, Sel>(memory: SharedMemory<S>, key: K, select: (value: PathConnector<S, K> extends {
+    read(): infer T;
+} ? T : never) => Sel, options?: SliceOptions<Sel>): Sel | undefined;
+/**
+ * Bind an AsyncTask — or a plain async function (e.g. a worker client's
+ * method), wrapped via toTask: its snapshot fields plus `run`/`runOnce`.
+ */
+export declare function useTask<R>(source: AsyncTask<void, R> | (() => Promise<R>)): {
+    data: R | null;
+    pending: boolean;
+    settled: boolean;
+    elapsedMs: number | null;
+    error: unknown;
+    run: AsyncTask<void, R>['run'];
+    runOnce: AsyncTask<void, R>['runOnce'];
+};
+export declare function useTask<A, R>(source: AsyncTask<A, R> | ((input: A) => Promise<R>)): {
+    data: R | null;
+    pending: boolean;
+    settled: boolean;
+    elapsedMs: number | null;
+    error: unknown;
+    run: AsyncTask<A, R>['run'];
+    runOnce: AsyncTask<A, R>['runOnce'];
+};

package/dist/index.js

@@ -0,0 +1,19 @@
+// src/index.ts
+import { useMemo, useSyncExternalStore } from "react";
+import { observe, toTask } from "@atolljs/core";
+function useObservable(source) {
+  return useSyncExternalStore(source.subscribe, source.get, source.get);
+}
+function useSharedValue(memory, key, select, options) {
+  const source = useMemo(() => observe(memory, key, select, options), [memory, key]);
+  return useObservable(source);
+}
+function useTask(source) {
+  const task = useMemo(() => toTask(source), [source]);
+  return { ...useObservable(task), run: task.run, runOnce: task.runOnce };
+}
+export {
+  useObservable,
+  useSharedValue,
+  useTask
+};

package/package.json

@@ -1,21 +1,28 @@
 {
   "name": "@atolljs/react",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "description": "React bindings — useObservable, useSharedValue, useTask",
   "homepage": "https://jwhenry3.github.io/atolljs/consumer/quickstart/",
   "type": "module",
   "exports": {
-    ".": "./src/index.ts"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
   },
   "files": [
-    "src"
+    "src",
+    "dist"
   ],
+  "scripts": {
+    "build": "node ../../scripts/build-lib.mjs"
+  },
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org"
   },
   "peerDependencies": {
-    "@atolljs/core": "0.1.12",
+    "@atolljs/core": "^0.1.14",
     "react": "^19.3.0"
   },
   "repository": {