@assistant-ui/tap 0.5.13 → 0.6.0

package/dist/hooks/useState.d.ts

@@ -0,0 +1,9 @@
+//#region src/hooks/useState.d.ts
+declare namespace useState {
+  type StateUpdater<S> = S | ((prev: S) => S);
+}
+declare function useState<S = undefined>(): [S | undefined, (updater: useState.StateUpdater<S>) => void];
+declare function useState<S>(initial: S | (() => S)): [S, (updater: useState.StateUpdater<S>) => void];
+//#endregion
+export { useState };
+//# sourceMappingURL=useState.d.ts.map

package/dist/hooks/useState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useState.d.ts","names":[],"sources":["../../src/hooks/useState.ts"],"mappings":";kBAEiB,QAAA;EAAA,KACH,YAAA,MAAkB,CAAA,KAAM,IAAA,EAAM,CAAA,KAAM,CAAA;AAAA;AAAA,iBAclC,QAAA,oBACd,CAAA,eACC,OAAA,EAAS,QAAA,CAAS,YAAA,CAAa,CAAA;AAAA,iBAElB,QAAA,IACd,OAAA,EAAS,CAAA,UAAW,CAAA,KAClB,CAAA,GAAI,OAAA,EAAS,QAAA,CAAS,YAAA,CAAa,CAAA"}

package/dist/hooks/useState.js

@@ -0,0 +1,11 @@
+import { useReducer } from "./useReducer.js";
+//#region src/hooks/useState.ts
+const stateReducer = (state, action) => typeof action === "function" ? action(state) : action;
+const stateInit = (initial) => typeof initial === "function" ? initial() : initial;
+function useState(initial) {
+	return useReducer(stateReducer, initial, stateInit);
+}
+//#endregion
+export { useState };
+
+//# sourceMappingURL=useState.js.map

package/dist/hooks/useState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useState.js","names":[],"sources":["../../src/hooks/useState.ts"],"sourcesContent":["import { useReducer } from \"./useReducer\";\n\nexport namespace useState {\n  export type StateUpdater<S> = S | ((prev: S) => S);\n}\n\nconst stateReducer = <S>(\n  state: S | undefined,\n  action: useState.StateUpdater<S>,\n): S =>\n  typeof action === \"function\"\n    ? (action as (prev: S | undefined) => S)(state)\n    : action;\n\nconst stateInit = <S>(initial: S | (() => S)): S =>\n  typeof initial === \"function\" ? (initial as () => S)() : initial;\n\nexport function useState<S = undefined>(): [\n  S | undefined,\n  (updater: useState.StateUpdater<S>) => void,\n];\nexport function useState<S>(\n  initial: S | (() => S),\n): [S, (updater: useState.StateUpdater<S>) => void];\nexport function useState<S>(\n  initial?: S | (() => S),\n): [S | undefined, (updater: useState.StateUpdater<S>) => void] {\n  return useReducer(stateReducer, initial, stateInit);\n}\n"],"mappings":";;AAMA,MAAM,gBACJ,OACA,WAEA,OAAO,WAAW,aACb,OAAsC,KAAK,IAC5C;AAEN,MAAM,aAAgB,YACpB,OAAO,YAAY,aAAc,QAAoB,IAAI;AAS3D,SAAgB,SACd,SAC8D;CAC9D,OAAO,WAAW,cAAc,SAAS,SAAS;AACpD"}

package/dist/hooks/utils/useCell.d.ts

@@ -0,0 +1,10 @@
+import { Cell } from "../../core/types.js";
+
+//#region src/hooks/utils/useCell.d.ts
+declare const useCell: <T extends Cell["type"]>(type: T, init: () => Cell) => Cell & {
+  type: T;
+};
+declare const registerRenderMountTask: (task: () => void) => void;
+//#endregion
+export { registerRenderMountTask, useCell };
+//# sourceMappingURL=useCell.d.ts.map

package/dist/hooks/utils/useCell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCell.d.ts","names":[],"sources":["../../../src/hooks/utils/useCell.ts"],"mappings":";;;cAGa,OAAA,aAAqB,IAAA,UAChC,IAAA,EAAM,CAAA,EACN,IAAA,QAAY,IAAA,KACX,IAAA;EAAS,IAAA,EAAM,CAAA;AAAA;AAAA,cAyBL,uBAAA,GAA2B,IAAgB"}

package/dist/hooks/utils/{tapHook.js → useCell.js}

@@ -1,6 +1,6 @@
 import { getCurrentResourceFiber } from "../../core/helpers/execution-context.js";
-//#region src/hooks/utils/tapHook.ts
-const tapHook = (type, init) => {
+//#region src/hooks/utils/useCell.ts
+const useCell = (type, init) => {
 	const fiber = getCurrentResourceFiber();
 	const index = fiber.currentIndex++;
 	if (!fiber.isFirstRender && index >= fiber.cells.length) throw new Error("Rendered more hooks than during the previous render. Hooks must be called in the exact same order in every render.");
@@ -16,6 +16,6 @@ const registerRenderMountTask = (task) => {
 	getCurrentResourceFiber().renderContext.effectTasks.push(task);
 };
 //#endregion
-export { registerRenderMountTask, tapHook };
+export { registerRenderMountTask, useCell };
 
-//# sourceMappingURL=tapHook.js.map
+//# sourceMappingURL=useCell.js.map

package/dist/hooks/utils/{tapHook.js.map → useCell.js.map}

@@ -1 +1 @@
-{"version":3,"file":"tapHook.js","names":[],"sources":["../../../src/hooks/utils/tapHook.ts"],"sourcesContent":["import { getCurrentResourceFiber } from \"../../core/helpers/execution-context\";\nimport type { Cell } from \"../../core/types\";\n\nexport const tapHook = <T extends Cell[\"type\"]>(\n  type: T,\n  init: () => Cell,\n): Cell & { type: T } => {\n  const fiber = getCurrentResourceFiber();\n  const index = fiber.currentIndex++;\n\n  if (!fiber.isFirstRender && index >= fiber.cells.length) {\n    // Check if we're trying to use more hooks than in previous renders\n    throw new Error(\n      \"Rendered more hooks than during the previous render. \" +\n        \"Hooks must be called in the exact same order in every render.\",\n    );\n  }\n\n  let cell = fiber.cells[index];\n  if (!cell) {\n    cell = init();\n    fiber.cells[index] = cell;\n  }\n\n  if (cell.type !== type) {\n    throw new Error(\"Hook order changed between renders\");\n  }\n\n  return cell as Cell & { type: T };\n};\n\nexport const registerRenderMountTask = (task: () => void) => {\n  const fiber = getCurrentResourceFiber();\n  fiber.renderContext!.effectTasks.push(task);\n};\n"],"mappings":";;AAGA,MAAa,WACX,MACA,SACuB;CACvB,MAAM,QAAQ,wBAAwB;CACtC,MAAM,QAAQ,MAAM;CAEpB,IAAI,CAAC,MAAM,iBAAiB,SAAS,MAAM,MAAM,QAE/C,MAAM,IAAI,MACR,oHAEF;CAGF,IAAI,OAAO,MAAM,MAAM;CACvB,IAAI,CAAC,MAAM;EACT,OAAO,KAAK;EACZ,MAAM,MAAM,SAAS;CACvB;CAEA,IAAI,KAAK,SAAS,MAChB,MAAM,IAAI,MAAM,oCAAoC;CAGtD,OAAO;AACT;AAEA,MAAa,2BAA2B,SAAqB;CAE3D,wBAAI,EAAE,cAAe,YAAY,KAAK,IAAI;AAC5C"}
+{"version":3,"file":"useCell.js","names":[],"sources":["../../../src/hooks/utils/useCell.ts"],"sourcesContent":["import { getCurrentResourceFiber } from \"../../core/helpers/execution-context\";\nimport type { Cell } from \"../../core/types\";\n\nexport const useCell = <T extends Cell[\"type\"]>(\n  type: T,\n  init: () => Cell,\n): Cell & { type: T } => {\n  const fiber = getCurrentResourceFiber();\n  const index = fiber.currentIndex++;\n\n  if (!fiber.isFirstRender && index >= fiber.cells.length) {\n    // Check if we're trying to use more hooks than in previous renders\n    throw new Error(\n      \"Rendered more hooks than during the previous render. \" +\n        \"Hooks must be called in the exact same order in every render.\",\n    );\n  }\n\n  let cell = fiber.cells[index];\n  if (!cell) {\n    cell = init();\n    fiber.cells[index] = cell;\n  }\n\n  if (cell.type !== type) {\n    throw new Error(\"Hook order changed between renders\");\n  }\n\n  return cell as Cell & { type: T };\n};\n\nexport const registerRenderMountTask = (task: () => void) => {\n  const fiber = getCurrentResourceFiber();\n  fiber.renderContext!.effectTasks.push(task);\n};\n"],"mappings":";;AAGA,MAAa,WACX,MACA,SACuB;CACvB,MAAM,QAAQ,wBAAwB;CACtC,MAAM,QAAQ,MAAM;CAEpB,IAAI,CAAC,MAAM,iBAAiB,SAAS,MAAM,MAAM,QAE/C,MAAM,IAAI,MACR,oHAEF;CAGF,IAAI,OAAO,MAAM,MAAM;CACvB,IAAI,CAAC,MAAM;EACT,OAAO,KAAK;EACZ,MAAM,MAAM,SAAS;CACvB;CAEA,IAAI,KAAK,SAAS,MAChB,MAAM,IAAI,MAAM,oCAAoC;CAGtD,OAAO;AACT;AAEA,MAAa,2BAA2B,SAAqB;CAE3D,wBAAI,CAAC,CAAC,cAAe,YAAY,KAAK,IAAI;AAC5C"}

package/dist/index.d.ts

@@ -1,18 +1,8 @@
-import { tapEffect } from "./hooks/tap-effect.js";
 import { ContravariantResource, Resource, ResourceElement } from "./core/types.js";
-import { createResourceContext, tap, withContextProvider } from "./core/context.js";
+import { createResourceContext, withContextProvider } from "./core/context.js";
 import { createResourceRoot } from "./core/createResourceRoot.js";
 import { resource } from "./core/resource.js";
 import { flushResourcesSync } from "./core/scheduler.js";
 import { withKey } from "./core/withKey.js";
-import { tapCallback } from "./hooks/tap-callback.js";
-import { tapConst } from "./hooks/tap-const.js";
-import { tapEffectEvent } from "./hooks/tap-effect-event.js";
-import { tapMemo } from "./hooks/tap-memo.js";
-import { tapReducer, tapReducerWithDerivedState } from "./hooks/tap-reducer.js";
-import { tapRef } from "./hooks/tap-ref.js";
-import { tapResource } from "./hooks/tap-resource.js";
-import { tapResources } from "./hooks/tap-resources.js";
-import { tapState } from "./hooks/tap-state.js";
-import { tapResourceRoot } from "./tapResourceRoot.js";
-export { type ContravariantResource, type Resource, type ResourceElement, createResourceContext, createResourceRoot, flushResourcesSync, resource, tap, tapCallback, tapConst, tapEffect, tapEffectEvent, tapMemo, tapReducer, tapReducerWithDerivedState, tapRef, tapResource, tapResourceRoot, tapResources, tapState, withContextProvider, withKey };
+import { useResource, useResourceRoot, useResources } from "./react/hooks.js";
+export { type ContravariantResource, type Resource, type ResourceElement, createResourceContext, createResourceRoot, flushResourcesSync, resource, useResource, useResourceRoot, useResources, withContextProvider, withKey };

package/dist/index.js

@@ -1,17 +1,7 @@
 import { resource } from "./core/resource.js";
 import { withKey } from "./core/withKey.js";
-import { tapReducer, tapReducerWithDerivedState } from "./hooks/tap-reducer.js";
-import { tapState } from "./hooks/tap-state.js";
-import { tapEffect } from "./hooks/tap-effect.js";
-import { tapRef } from "./hooks/tap-ref.js";
-import { tapConst } from "./hooks/tap-const.js";
-import { tapMemo } from "./hooks/tap-memo.js";
-import { tapCallback } from "./hooks/tap-callback.js";
-import { tapEffectEvent } from "./hooks/tap-effect-event.js";
-import { tapResource } from "./hooks/tap-resource.js";
-import { tapResources } from "./hooks/tap-resources.js";
+import { createResourceContext, withContextProvider } from "./core/context.js";
 import { flushResourcesSync } from "./core/scheduler.js";
-import { tapResourceRoot } from "./tapResourceRoot.js";
 import { createResourceRoot } from "./core/createResourceRoot.js";
-import { createResourceContext, tap, withContextProvider } from "./core/context.js";
-export { createResourceContext, createResourceRoot, flushResourcesSync, resource, tap, tapCallback, tapConst, tapEffect, tapEffectEvent, tapMemo, tapReducer, tapReducerWithDerivedState, tapRef, tapResource, tapResourceRoot, tapResources, tapState, withContextProvider, withKey };
+import { useResource, useResourceRoot, useResources } from "./react/hooks.js";
+export { createResourceContext, createResourceRoot, flushResourcesSync, resource, useResource, useResourceRoot, useResources, withContextProvider, withKey };

package/dist/react/hooks.d.ts

@@ -0,0 +1,25 @@
+import { useResourceRoot as useResourceRoot$1 } from "../hooks/useResourceRoot.js";
+import { useResource as useResource$1 } from "../hooks/useResource.js";
+import { useResources as useResources$1 } from "../hooks/useResources.js";
+
+//#region src/react/hooks.d.ts
+/**
+ * Hosts a resource element. Inside a resource render it hosts the element as a
+ * child resource; inside a React component it hosts it via the React bridge.
+ * `propsDeps` is a resource-render optimization and is ignored on the React side.
+ */
+declare const useResource: typeof useResource$1;
+/**
+ * Hosts a keyed list of resource elements. Inside a resource render it composes
+ * them directly; inside a React component it hosts them via the React bridge.
+ */
+declare const useResources: typeof useResources$1;
+/**
+ * Hosts a resource element as a subscribable root. Inside a resource render it
+ * uses the root hook directly; inside a React component it hosts that root via
+ * the React bridge (host it in one place; observe it via getValue/subscribe).
+ */
+declare const useResourceRoot: typeof useResourceRoot$1;
+//#endregion
+export { useResource, useResourceRoot, useResources };
+//# sourceMappingURL=hooks.d.ts.map

package/dist/react/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","names":[],"sources":["../../src/react/hooks.ts"],"mappings":";;;;;;;;;AA4FA;cAAa,WAAA,SAAoB,aAEhC;;;AAAA;AAMD;cAAa,YAAA,SAAqB,cAEjC;;;AAAA;AAOD;;cAAa,eAAA,SAAwB,iBAEpC"}

package/dist/react/hooks.js

@@ -0,0 +1,69 @@
+import { resource } from "../core/resource.js";
+import { isDevelopment } from "../core/helpers/env.js";
+import { peekResourceFiber } from "../core/helpers/execution-context.js";
+import { commitRoot, createResourceFiberRoot, setRootVersion } from "../core/helpers/root.js";
+import { commitResourceFiber, createResourceFiber, renderResourceFiber, unmountResourceFiber } from "../core/ResourceFiber.js";
+import { useResourceRoot as useResourceRoot$1 } from "../hooks/useResourceRoot.js";
+import { useResource as useResource$1 } from "../hooks/useResource.js";
+import { useResources as useResources$1 } from "../hooks/useResources.js";
+import { useLayoutEffect, useMemo, useReducer, useRef, useState } from "react";
+//#region src/react/hooks.ts
+const useDevStrictMode = () => {
+	if (!isDevelopment) return null;
+	const count = useRef(0);
+	const isFirstRender = count.current === 0;
+	useState(() => count.current++);
+	if (count.current !== 2) return null;
+	return isFirstRender ? "child" : "root";
+};
+const HostResource = resource(function HostResource(callback) {
+	return callback();
+});
+const useResourceHost = (callback) => {
+	const root = useMemo(() => {
+		return createResourceFiberRoot((cb) => dispatch(cb));
+	}, []);
+	const [version, dispatch] = useReducer((v, cb) => {
+		setRootVersion(root, v);
+		return v + (cb() ? 1 : 0);
+	}, 0);
+	setRootVersion(root, version);
+	const devStrictMode = useDevStrictMode();
+	const fiber = useMemo(() => {
+		return createResourceFiber(HostResource, root, void 0, devStrictMode);
+	}, [root, devStrictMode]);
+	const result = renderResourceFiber(fiber, callback);
+	useLayoutEffect(() => {
+		return () => unmountResourceFiber(fiber);
+	}, [fiber]);
+	useLayoutEffect(() => {
+		commitRoot(root);
+		commitResourceFiber(fiber, result);
+	});
+	return result.output;
+};
+const makeHook = (hook) => ((...args) => {
+	if (peekResourceFiber()) return hook(...args);
+	return useResourceHost(() => hook(...args));
+});
+/**
+* Hosts a resource element. Inside a resource render it hosts the element as a
+* child resource; inside a React component it hosts it via the React bridge.
+* `propsDeps` is a resource-render optimization and is ignored on the React side.
+*/
+const useResource = makeHook(useResource$1);
+/**
+* Hosts a keyed list of resource elements. Inside a resource render it composes
+* them directly; inside a React component it hosts them via the React bridge.
+*/
+const useResources = makeHook(useResources$1);
+/**
+* Hosts a resource element as a subscribable root. Inside a resource render it
+* uses the root hook directly; inside a React component it hosts that root via
+* the React bridge (host it in one place; observe it via getValue/subscribe).
+*/
+const useResourceRoot = makeHook(useResourceRoot$1);
+//#endregion
+export { useResource, useResourceRoot, useResources };
+
+//# sourceMappingURL=hooks.js.map

package/dist/react/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","names":["hooks.useResource","hooks.useResources","hooks.useResourceRoot"],"sources":["../../src/react/hooks.ts"],"sourcesContent":["import { useLayoutEffect, useMemo, useReducer, useRef, useState } from \"react\";\nimport type { ResourceFiberRoot, Resource } from \"../core/types\";\nimport {\n  createResourceFiber,\n  unmountResourceFiber,\n  renderResourceFiber,\n  commitResourceFiber,\n} from \"../core/ResourceFiber\";\nimport { isDevelopment } from \"../core/helpers/env\";\nimport {\n  commitRoot,\n  createResourceFiberRoot,\n  setRootVersion,\n} from \"../core/helpers/root\";\nimport { peekResourceFiber } from \"../core/helpers/execution-context\";\nimport * as hooks from \"../hooks\";\nimport { resource } from \"../core/resource\";\n\nconst useDevStrictMode = () => {\n  if (!isDevelopment) return null;\n\n  // oxlint-disable-next-line react/rules-of-hooks -- isDevelopment is a build-time constant, so this branch is stable per build\n  const count = useRef(0);\n  const isFirstRender = count.current === 0;\n  // oxlint-disable-next-line react/rules-of-hooks -- isDevelopment is a build-time constant, so this branch is stable per build\n  useState(() => count.current++);\n  if (count.current !== 2) return null;\n  return isFirstRender ? (\"child\" as const) : (\"root\" as const);\n};\n\nconst HostResource = resource(function HostResource<T>(callback: () => T) {\n  return callback();\n});\n\n// Runs `callback` inside a resource render hosted by a React component, so the\n// resource composition hooks (useResource/useResources/useResourceRoot) work from\n// React. `callback` executes inside the resource fiber below, so it may only call\n// resource hooks, not React's own hooks (which would have no fiber to attach to).\n// This is the single React->resource bridge; the React branch of every public\n// hook goes through it.\nconst useResourceHost = <T>(callback: () => T): T => {\n  const root = useMemo<ResourceFiberRoot>(() => {\n    return createResourceFiberRoot((cb) => dispatch(cb));\n  }, []);\n\n  const [version, dispatch] = useReducer((v: number, cb: () => boolean) => {\n    setRootVersion(root, v);\n    return v + (cb() ? 1 : 0);\n  }, 0);\n  setRootVersion(root, version);\n\n  const devStrictMode = useDevStrictMode();\n  const fiber = useMemo(() => {\n    return createResourceFiber(\n      HostResource as unknown as Resource<T, () => T>,\n      root,\n      undefined,\n      devStrictMode,\n    );\n  }, [root, devStrictMode]);\n\n  const result = renderResourceFiber(fiber, callback);\n  useLayoutEffect(() => {\n    return () => unmountResourceFiber(fiber);\n  }, [fiber]);\n  useLayoutEffect(() => {\n    commitRoot(root);\n    commitResourceFiber(fiber, result);\n  });\n\n  return result.output;\n};\n\n// Turns a resource hook into an isomorphic hook with the SAME type (overloads\n// included): inside a resource render it calls the hook directly; inside a React\n// component it hosts it via the `useResourceHost` bridge. peekResourceFiber() is\n// stable per call site (a given call always renders in the same environment), so\n// the branch order across renders is fixed even though rules-of-hooks can't prove\n// it.\nconst makeHook = <F extends (...args: any[]) => any>(hook: F): F =>\n  ((...args: any[]) => {\n    /* oxlint-disable react/rules-of-hooks */\n    if (peekResourceFiber()) return hook(...args);\n    return useResourceHost(() => hook(...args));\n    /* oxlint-enable react/rules-of-hooks */\n  }) as F;\n\n/**\n * Hosts a resource element. Inside a resource render it hosts the element as a\n * child resource; inside a React component it hosts it via the React bridge.\n * `propsDeps` is a resource-render optimization and is ignored on the React side.\n */\nexport const useResource: typeof hooks.useResource = makeHook(\n  hooks.useResource,\n);\n\n/**\n * Hosts a keyed list of resource elements. Inside a resource render it composes\n * them directly; inside a React component it hosts them via the React bridge.\n */\nexport const useResources: typeof hooks.useResources = makeHook(\n  hooks.useResources,\n);\n\n/**\n * Hosts a resource element as a subscribable root. Inside a resource render it\n * uses the root hook directly; inside a React component it hosts that root via\n * the React bridge (host it in one place; observe it via getValue/subscribe).\n */\nexport const useResourceRoot: typeof hooks.useResourceRoot = makeHook(\n  hooks.useResourceRoot,\n);\n"],"mappings":";;;;;;;;;;AAkBA,MAAM,yBAAyB;CAC7B,IAAI,CAAC,eAAe,OAAO;CAG3B,MAAM,QAAQ,OAAO,CAAC;CACtB,MAAM,gBAAgB,MAAM,YAAY;CAExC,eAAe,MAAM,SAAS;CAC9B,IAAI,MAAM,YAAY,GAAG,OAAO;CAChC,OAAO,gBAAiB,UAAqB;AAC/C;AAEA,MAAM,eAAe,SAAS,SAAS,aAAgB,UAAmB;CACxE,OAAO,SAAS;AAClB,CAAC;AAQD,MAAM,mBAAsB,aAAyB;CACnD,MAAM,OAAO,cAAiC;EAC5C,OAAO,yBAAyB,OAAO,SAAS,EAAE,CAAC;CACrD,GAAG,CAAC,CAAC;CAEL,MAAM,CAAC,SAAS,YAAY,YAAY,GAAW,OAAsB;EACvE,eAAe,MAAM,CAAC;EACtB,OAAO,KAAK,GAAG,IAAI,IAAI;CACzB,GAAG,CAAC;CACJ,eAAe,MAAM,OAAO;CAE5B,MAAM,gBAAgB,iBAAiB;CACvC,MAAM,QAAQ,cAAc;EAC1B,OAAO,oBACL,cACA,MACA,KAAA,GACA,aACF;CACF,GAAG,CAAC,MAAM,aAAa,CAAC;CAExB,MAAM,SAAS,oBAAoB,OAAO,QAAQ;CAClD,sBAAsB;EACpB,aAAa,qBAAqB,KAAK;CACzC,GAAG,CAAC,KAAK,CAAC;CACV,sBAAsB;EACpB,WAAW,IAAI;EACf,oBAAoB,OAAO,MAAM;CACnC,CAAC;CAED,OAAO,OAAO;AAChB;AAQA,MAAM,YAA+C,WACjD,GAAG,SAAgB;CAEnB,IAAI,kBAAkB,GAAG,OAAO,KAAK,GAAG,IAAI;CAC5C,OAAO,sBAAsB,KAAK,GAAG,IAAI,CAAC;AAE5C;;;;;;AAOF,MAAa,cAAwC,SACnDA,aACF;;;;;AAMA,MAAa,eAA0C,SACrDC,cACF;;;;;;AAOA,MAAa,kBAAgD,SAC3DC,iBACF"}

package/dist/react-shim/index.d.ts

@@ -0,0 +1,19 @@
+import { useRef as useRef$2 } from "../hooks/useRef.js";
+import * as React from "react";
+import react_default from "react";
+export * from "react";
+
+//#region src/react-shim/index.d.ts
+declare const useState: (initialState?: any) => [any, (updater: any) => void];
+declare const useReducer: (reducer: any, initialArg: any, init?: any) => [unknown, (action: unknown) => void] | [unknown, React.ActionDispatch<React.AnyActionArg>];
+declare const useRef: (initialValue?: any) => useRef$2.RefObject<any>;
+declare const useMemo: (factory: any, deps: any) => unknown;
+declare const useCallback: (callback: any, deps: any) => any;
+declare const useEffect: (effect: any, deps?: any) => void;
+declare const useLayoutEffect: (effect: any, deps?: any) => void;
+declare const useEffectEvent: (callback: any) => any;
+declare const use: (usable: any) => unknown;
+declare const useContext: (context: any) => unknown;
+//#endregion
+export { react_default as default, use, useCallback, useContext, useEffect, useEffectEvent, useLayoutEffect, useMemo, useReducer, useRef, useState };
+//# sourceMappingURL=index.d.ts.map

package/dist/react-shim/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/react-shim/index.ts"],"mappings":";;;;;;cAuBa,QAAA,GAAY,YAAA,kBAAkB,OAAA;AAAA,cAG9B,UAAA,GAAc,OAAA,OAAc,UAAA,OAAiB,IAAA,sBAAU,MAAA,gCAAA,KAAA,CAAA,cAAA,CAAA,KAAA,CAAA,YAAA;AAAA,cAKvD,MAAA,GAAU,YAAA,WAC4C,QAAA,CAD1B,SAAA;AAAA,cAG5B,OAAA,GAAW,OAAA,OAAc,IAAS;AAAA,cAGlC,WAAA,GAAe,QAAA,OAAe,IAAS;AAAA,cAKvC,SAAA,GAAa,MAAA,OAAa,IAAU;AAAA,cAIpC,eAAA,GAAmB,MAAA,OAAa,IAAU;AAAA,cAG1C,cAAA,GAAkB,QAAa;AAAA,cAM/B,GAAA,GAAO,MAAW;AAAA,cAKlB,UAAA,GAAc,OAAY"}

package/dist/react-shim/index.js

@@ -0,0 +1,28 @@
+import { peekResourceFiber } from "../core/helpers/execution-context.js";
+import { useReducer as useReducer$2 } from "../hooks/useReducer.js";
+import { useState as useState$2 } from "../hooks/useState.js";
+import { useRef as useRef$2 } from "../hooks/useRef.js";
+import { useMemo as useMemo$2 } from "../hooks/useMemo.js";
+import { useCallback as useCallback$1 } from "../hooks/useCallback.js";
+import { useEffect as useEffect$1 } from "../hooks/useEffect.js";
+import { useEffectEvent as useEffectEvent$1 } from "../hooks/useEffectEvent.js";
+import { isResourceContext, useResourceContext } from "../core/context.js";
+import * as React from "react";
+import react_default from "react";
+export * from "react";
+//#region src/react-shim/index.ts
+const inTap = () => peekResourceFiber() !== null;
+const useState = (initialState) => inTap() ? useState$2(initialState) : React.useState(initialState);
+const useReducer = (reducer, initialArg, init) => inTap() ? useReducer$2(reducer, initialArg, init) : React.useReducer(reducer, initialArg, init);
+const useRef = (initialValue) => inTap() ? useRef$2(initialValue) : React.useRef(initialValue);
+const useMemo = (factory, deps) => inTap() ? useMemo$2(factory, deps) : React.useMemo(factory, deps);
+const useCallback = (callback, deps) => inTap() ? useCallback$1(callback, deps) : React.useCallback(callback, deps);
+const useEffect = (effect, deps) => inTap() ? useEffect$1(effect, deps) : React.useEffect(effect, deps);
+const useLayoutEffect = (effect, deps) => inTap() ? useEffect$1(effect, deps) : React.useLayoutEffect(effect, deps);
+const useEffectEvent = (callback) => inTap() ? useEffectEvent$1(callback) : React.useEffectEvent(callback);
+const use = (usable) => isResourceContext(usable) ? useResourceContext(usable) : React.use(usable);
+const useContext = (context) => isResourceContext(context) ? useResourceContext(context) : React.useContext(context);
+//#endregion
+export { react_default as default, use, useCallback, useContext, useEffect, useEffectEvent, useLayoutEffect, useMemo, useReducer, useRef, useState };
+
+//# sourceMappingURL=index.js.map

package/dist/react-shim/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["hooks.useState","hooks.useReducer","hooks.useRef","hooks.useMemo","hooks.useCallback","hooks.useEffect","hooks.useEffectEvent"],"sources":["../../src/react-shim/index.ts"],"sourcesContent":["/* oxlint-disable react/rules-of-hooks -- this module deliberately routes hook calls between tap and React at runtime */\n/* oxlint-disable react/exhaustive-deps -- dependency arrays are forwarded verbatim from the caller */\n// Runtime drop-in for \"react\": forward everything from react, then override the\n// hooks that have a tap equivalent so they route to tap inside a resource render\n// and to React otherwise. Alias `react` to this module (build `output.paths` /\n// vitest resolver) in code that can run inside a tap resource.\n//\n// This subpath ships no type declarations: the build reverts the aliased\n// specifier back to `\"react\"` in emitted `.d.ts`, so consumer types resolve to\n// React's own. The source-level TS2498 from the `export *` below is suppressed.\nimport * as React from \"react\";\nimport { peekResourceFiber } from \"../core/helpers/execution-context\";\nimport * as hooks from \"../hooks\";\nimport { useResourceContext, isResourceContext } from \"../core/context\";\n\n// @ts-expect-error -- @types/react uses `export =`; this is valid at runtime.\nexport * from \"react\";\nexport { default } from \"react\";\n\nconst inTap = () => peekResourceFiber() !== null;\n\n// --- hooks with a tap equivalent: override the star-exported react hooks ---\n\nexport const useState = (initialState?: any) =>\n  inTap() ? hooks.useState(initialState) : React.useState(initialState);\n\nexport const useReducer = (reducer: any, initialArg: any, init?: any) =>\n  inTap()\n    ? hooks.useReducer(reducer, initialArg, init)\n    : React.useReducer(reducer, initialArg, init);\n\nexport const useRef = (initialValue?: any) =>\n  inTap() ? hooks.useRef(initialValue) : React.useRef(initialValue);\n\nexport const useMemo = (factory: any, deps: any) =>\n  inTap() ? hooks.useMemo(factory, deps) : React.useMemo(factory, deps);\n\nexport const useCallback = (callback: any, deps: any) =>\n  inTap()\n    ? hooks.useCallback(callback, deps)\n    : React.useCallback(callback, deps);\n\nexport const useEffect = (effect: any, deps?: any) =>\n  inTap() ? hooks.useEffect(effect, deps) : React.useEffect(effect, deps);\n\n// tap has a single effect primitive; layout effects collapse onto it\nexport const useLayoutEffect = (effect: any, deps?: any) =>\n  inTap() ? hooks.useEffect(effect, deps) : React.useLayoutEffect(effect, deps);\n\nexport const useEffectEvent = (callback: any) =>\n  inTap() ? hooks.useEffectEvent(callback) : React.useEffectEvent(callback);\n\n// `use(usable)` reads tap resource context when handed a tap context (routed by\n// its brand, not by ambient render state), and falls back to React's `use`\n// (promises / React context) for everything else.\nexport const use = (usable: any) =>\n  isResourceContext(usable) ? useResourceContext(usable) : React.use(usable);\n\n// `useContext(context)` reads tap resource context when handed a tap context\n// (routed by its brand), and falls back to React's `useContext` otherwise.\nexport const useContext = (context: any) =>\n  isResourceContext(context)\n    ? useResourceContext(context)\n    : React.useContext(context);\n"],"mappings":";;;;;;;;;;;;;AAmBA,MAAM,cAAc,kBAAkB,MAAM;AAI5C,MAAa,YAAY,iBACvB,MAAM,IAAIA,WAAe,YAAY,IAAI,MAAM,SAAS,YAAY;AAEtE,MAAa,cAAc,SAAc,YAAiB,SACxD,MAAM,IACFC,aAAiB,SAAS,YAAY,IAAI,IAC1C,MAAM,WAAW,SAAS,YAAY,IAAI;AAEhD,MAAa,UAAU,iBACrB,MAAM,IAAIC,SAAa,YAAY,IAAI,MAAM,OAAO,YAAY;AAElE,MAAa,WAAW,SAAc,SACpC,MAAM,IAAIC,UAAc,SAAS,IAAI,IAAI,MAAM,QAAQ,SAAS,IAAI;AAEtE,MAAa,eAAe,UAAe,SACzC,MAAM,IACFC,cAAkB,UAAU,IAAI,IAChC,MAAM,YAAY,UAAU,IAAI;AAEtC,MAAa,aAAa,QAAa,SACrC,MAAM,IAAIC,YAAgB,QAAQ,IAAI,IAAI,MAAM,UAAU,QAAQ,IAAI;AAGxE,MAAa,mBAAmB,QAAa,SAC3C,MAAM,IAAIA,YAAgB,QAAQ,IAAI,IAAI,MAAM,gBAAgB,QAAQ,IAAI;AAE9E,MAAa,kBAAkB,aAC7B,MAAM,IAAIC,iBAAqB,QAAQ,IAAI,MAAM,eAAe,QAAQ;AAK1E,MAAa,OAAO,WAClB,kBAAkB,MAAM,IAAI,mBAAmB,MAAM,IAAI,MAAM,IAAI,MAAM;AAI3E,MAAa,cAAc,YACzB,kBAAkB,OAAO,IACrB,mBAAmB,OAAO,IAC1B,MAAM,WAAW,OAAO"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@assistant-ui/tap",
-  "version": "0.5.13",
-  "description": "Zero-dependency reactive state management inspired by React hooks",
+  "version": "0.6.0",
+  "description": "Reactive state management inspired by React hooks",
   "keywords": [
     "state-management",
     "reactive",
@@ -17,9 +17,9 @@
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     },
-    "./react": {
-      "types": "./dist/react/index.d.ts",
-      "default": "./dist/react/index.js"
+    "./react-shim": {
+      "types": null,
+      "default": "./dist/react-shim/index.js"
     }
   },
   "main": "./dist/index.js",
@@ -27,7 +27,7 @@
   "files": [
     "dist",
     "src",
-    "react",
+    "react-shim",
     "README.md"
   ],
   "sideEffects": false,
@@ -38,23 +38,20 @@
   "peerDependenciesMeta": {
     "@types/react": {
       "optional": true
-    },
-    "react": {
-      "optional": true
     }
   },
   "devDependencies": {
     "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.2",
-    "@types/node": "^25.9.1",
-    "@types/react": "^19.2.15",
+    "@types/node": "^25.9.2",
+    "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
-    "@vitest/ui": "^4.1.7",
+    "@vitest/ui": "^4.1.8",
     "jsdom": "^29.1.1",
-    "react": "^19.2.6",
-    "react-dom": "^19.2.6",
-    "vitest": "^4.1.7",
-    "@assistant-ui/x-buildutils": "0.0.9"
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
+    "vitest": "^4.1.8",
+    "@assistant-ui/x-buildutils": "0.0.12"
   },
   "publishConfig": {
     "access": "public",

package/react-shim/package.json

@@ -0,0 +1,4 @@
+{
+  "type": "module",
+  "main": "../dist/react-shim/index.js"
+}

package/src/__tests__/basic/resourceHandle.test.ts

@@ -4,7 +4,7 @@ import { resource } from "../../core/resource";
 
 describe("ResourceHandle - Basic Usage", () => {
   it("should create a resource handle with const API", () => {
-    const TestResource = resource((props: number) => {
+    const TestResource = resource(function TestResource(props: number) {
       return {
         value: props * 2,
         propsUsed: props,
@@ -24,7 +24,9 @@ describe("ResourceHandle - Basic Usage", () => {
   });
 
   it("should allow updating props", () => {
-    const TestResource = resource((props: { multiplier: number }) => {
+    const TestResource = resource(function TestResource(props: {
+      multiplier: number;
+    }) {
       return { result: 10 * props.multiplier };
     });
     const root = createResourceRoot();
@@ -38,7 +40,9 @@ describe("ResourceHandle - Basic Usage", () => {
   });
 
   it("should support subscribing and unsubscribing", () => {
-    const TestResource = resource(() => ({ timestamp: Date.now() }));
+    const TestResource = resource(function TestResource() {
+      return { timestamp: Date.now() };
+    });
     const root = createResourceRoot();
     const sub = root.render(TestResource());
 

package/src/__tests__/basic/tapEffect.basic.test.ts

@@ -1,6 +1,6 @@
 import { describe, it, expect, vi, afterEach } from "vitest";
-import { tapEffect } from "../../hooks/tap-effect";
-import { tapState } from "../../hooks/tap-state";
+import { useEffect } from "../../hooks/useEffect";
+import { useState } from "../../hooks/useState";
 import {
   createTestResource,
   renderTest,
@@ -8,7 +8,7 @@ import {
   TestResourceManager,
 } from "../test-utils";
 
-describe("tapEffect - Basic Functionality", () => {
+describe("useEffect - Basic Functionality", () => {
   afterEach(() => {
     cleanupAllResources();
   });
@@ -20,7 +20,7 @@ describe("tapEffect - Basic Functionality", () => {
       const testFiber = createTestResource(() => {
         executionOrder.push("render");
 
-        tapEffect(() => {
+        useEffect(() => {
           executionOrder.push("effect");
         });
 
@@ -44,7 +44,7 @@ describe("tapEffect - Basic Functionality", () => {
       const effect = vi.fn(() => cleanup);
 
       const testFiber = createTestResource(() => {
-        tapEffect(effect);
+        useEffect(effect);
         return null;
       });
 
@@ -64,15 +64,15 @@ describe("tapEffect - Basic Functionality", () => {
       const cleanupOrder: string[] = [];
 
       const testFiber = createTestResource(() => {
-        tapEffect(() => {
+        useEffect(() => {
           return () => cleanupOrder.push("first");
         });
 
-        tapEffect(() => {
+        useEffect(() => {
           return () => cleanupOrder.push("second");
         });
 
-        tapEffect(() => {
+        useEffect(() => {
           return () => cleanupOrder.push("third");
         });
 
@@ -91,7 +91,7 @@ describe("tapEffect - Basic Functionality", () => {
   describe("Multiple Effects", () => {
     it("should execute multiple effects in registration order", () => {
       const executionOrder: string[] = [];
-      const effects: tapEffect.EffectCallback[] = [
+      const effects: useEffect.EffectCallback[] = [
         () => {
           executionOrder.push("effect1");
           return undefined;
@@ -107,8 +107,7 @@ describe("tapEffect - Basic Functionality", () => {
       ];
 
       const testFiber = createTestResource(() => {
-        // biome-ignore lint/suspicious/useIterableCallbackReturn: forEach callback intentionally has no return
-        effects.forEach((fn) => tapEffect(fn));
+        effects.forEach((fn) => useEffect(fn));
         return null;
       });
 
@@ -125,18 +124,17 @@ describe("tapEffect - Basic Functionality", () => {
 
       const testFiber = createTestResource((props: { value: number }) => {
         // Effect without deps - runs on every render
-        tapEffect(() => {
+        useEffect(() => {
           effectCalls.always++;
         });
 
         // Effect with empty deps - runs only once
-        tapEffect(() => {
+        useEffect(() => {
           effectCalls.once++;
         }, []);
 
         // Effect with deps - runs when deps change
-        // biome-ignore lint/correctness/useExhaustiveDependencies: test
-        tapEffect(() => {
+        useEffect(() => {
           effectCalls.conditional++;
         }, [props.value]);
 
@@ -163,13 +161,13 @@ describe("tapEffect - Basic Functionality", () => {
       let triggerRerender: (() => void) | null = null;
 
       const testFiber = createTestResource(() => {
-        const [, setState] = tapState(0);
+        const [, setState] = useState(0);
 
-        tapEffect(() => {
+        useEffect(() => {
           triggerRerender = () => setState((prev) => prev + 1);
         });
 
-        tapEffect(effect, []);
+        useEffect(effect, []);
 
         return null;
       });
@@ -189,7 +187,7 @@ describe("tapEffect - Basic Functionality", () => {
       const effect = vi.fn();
 
       const testFiber = createTestResource((props: { dep: string }) => {
-        tapEffect(() => {
+        useEffect(() => {
           effect(props.dep);
         }, [props.dep]);
 
@@ -217,11 +215,11 @@ describe("tapEffect - Basic Functionality", () => {
       const events: string[] = [];
 
       const testFiber = createTestResource(() => {
-        const [count, setCount] = tapState(0);
+        const [count, setCount] = useState(0);
 
         events.push(`render: ${count}`);
 
-        tapEffect(() => {
+        useEffect(() => {
           events.push(`effect: ${count}`);
 
           // Only update on first effect to avoid infinite loop

package/src/__tests__/basic/tapReducer.basic.test.ts

@@ -1,6 +1,6 @@
 import { describe, it, expect, afterEach } from "vitest";
-import { tapReducer } from "../../hooks/tap-reducer";
-import { tapEffect } from "../../hooks/tap-effect";
+import { useReducer } from "../../hooks/useReducer";
+import { useEffect } from "../../hooks/useEffect";
 import {
   createTestResource,
   renderTest,
@@ -9,7 +9,7 @@ import {
   getCommittedOutput,
 } from "../test-utils";
 
-describe("tapReducer - Basic Functionality", () => {
+describe("useReducer - Basic Functionality", () => {
   afterEach(() => {
     cleanupAllResources();
   });
@@ -19,7 +19,7 @@ describe("tapReducer - Basic Functionality", () => {
       const reducer = (state: number, action: number) => state + action;
 
       const testFiber = createTestResource(() => {
-        const [count] = tapReducer(reducer, 0);
+        const [count] = useReducer(reducer, 0);
         return count;
       });
 
@@ -32,7 +32,7 @@ describe("tapReducer - Basic Functionality", () => {
       const reducer = (state: number, action: number) => state + action;
 
       const testFiber = createTestResource(() => {
-        const [count] = tapReducer(reducer, 10, (arg) => {
+        const [count] = useReducer(reducer, 10, (arg) => {
           initCalled++;
           return arg * 2;
         });
@@ -64,9 +64,9 @@ describe("tapReducer - Basic Functionality", () => {
       let dispatchFn: ((action: Action) => void) | null = null;
 
       const testFiber = createTestResource(() => {
-        const [count, dispatch] = tapReducer(reducer, 0);
+        const [count, dispatch] = useReducer(reducer, 0);
 
-        tapEffect(() => {
+        useEffect(() => {
           dispatchFn = dispatch;
         });
 
@@ -100,9 +100,9 @@ describe("tapReducer - Basic Functionality", () => {
 
       const testFiber = createTestResource(() => {
         renderCount++;
-        const [count, dispatch] = tapReducer(reducer, 42);
+        const [count, dispatch] = useReducer(reducer, 42);
 
-        tapEffect(() => {
+        useEffect(() => {
           dispatchFn = dispatch;
         });
 
@@ -127,9 +127,9 @@ describe("tapReducer - Basic Functionality", () => {
       const testFiber = createTestResource(() => {
         const reducer = (state: number, action: number) =>
           state + action * multiplier;
-        const [count, dispatch] = tapReducer(reducer, 0);
+        const [count, dispatch] = useReducer(reducer, 0);
 
-        tapEffect(() => {
+        useEffect(() => {
           dispatchFn = dispatch;
         });
 
@@ -159,9 +159,9 @@ describe("tapReducer - Basic Functionality", () => {
       let dispatchFn: ((action: number) => void) | null = null;
 
       const testFiber = createTestResource(() => {
-        const [count, dispatch] = tapReducer(reducer, 0);
+        const [count, dispatch] = useReducer(reducer, 0);
 
-        tapEffect(() => {
+        useEffect(() => {
           dispatchFn = dispatch;
         });
 
@@ -186,7 +186,7 @@ describe("tapReducer - Basic Functionality", () => {
       const dispatches: ((action: number) => void)[] = [];
 
       const testFiber = createTestResource(() => {
-        const [count, dispatch] = tapReducer(reducer, 0);
+        const [count, dispatch] = useReducer(reducer, 0);
         dispatches.push(dispatch);
         return count;
       });