@assistant-ui/tap 0.5.14 → 0.6.0

package/README.md

@@ -5,7 +5,7 @@
 [![bundle size](https://img.shields.io/bundlephobia/minzip/@assistant-ui/tap)](https://bundlephobia.com/package/@assistant-ui/tap)
 [![GitHub stars](https://img.shields.io/github/stars/assistant-ui/assistant-ui)](https://github.com/assistant-ui/assistant-ui)
 
-Reactive primitives that bring React's hook mental model outside of components. The core has zero runtime dependencies and works in vanilla JS, on a server, or in React via the optional `/react` sub-path. Define self-contained units of state and effects (Resources) using `tapState`, `tapEffect`, `tapMemo`, and friends, and consume them via `useResource`.
+React's hooks, headless. Write a **resource** the same way you write a component, with the same hooks (`useState`, `useEffect`, `useMemo`, ...) imported from `"react"` and the same rules, except a resource returns a plain value instead of JSX. It runs inside a React component, inside another resource, or standalone with no React tree at all.
 
 `tap` powers the runtime layer of assistant-ui. Most users do not install it directly; reach for `@assistant-ui/react` instead.
 
@@ -18,12 +18,13 @@ npm install @assistant-ui/tap
 ## Usage
 
 ```typescript
-import { resource, tapState, tapEffect, createResourceRoot } from "@assistant-ui/tap";
+import { resource, createResourceRoot } from "@assistant-ui/tap";
+import { useState, useEffect } from "react";
 
-const Counter = resource(({ incrementBy = 1 }: { incrementBy?: number }) => {
-  const [count, setCount] = tapState(0);
+const Counter = resource(function Counter({ incrementBy = 1 }: { incrementBy?: number }) {
+  const [count, setCount] = useState(0);
 
-  tapEffect(() => {
+  useEffect(() => {
     console.log("count:", count);
   }, [count]);
 
@@ -43,10 +44,10 @@ const unsubscribe = counter.subscribe(() => {
 counter.getValue().increment();
 ```
 
-In React, use the `useResource` hook from the `/react` sub-path:
+In React, host a resource with `useResource`:
 
 ```tsx
-import { useResource } from "@assistant-ui/tap/react";
+import { useResource } from "@assistant-ui/tap";
 
 function CounterButton() {
   const { count, increment } = useResource(Counter({ incrementBy: 1 }));
@@ -56,7 +57,7 @@ function CounterButton() {
 
 ## Hooks
 
-`tapState`, `tapEffect`, `tapMemo`, `tapCallback`, `tapRef` mirror their React counterparts. Additional primitives include `tapResource` and `tapResources` for composition, plus `createResourceContext` / `tap` / `withContextProvider` for context.
+Inside a resource you use React's hooks (`useState`, `useEffect`, `useMemo`, `useCallback`, `useRef`, `use`, ...) imported from `"react"`. tap adds `useResource` / `useResources` / `useResourceRoot` for composition and `createResourceContext` / `withContextProvider` for context.
 
 Full API reference at [assistant-ui.com/tap/docs](https://www.assistant-ui.com/tap/docs).
 

package/dist/core/ResourceFiber.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ResourceFiber.d.ts","names":[],"sources":["../../src/core/ResourceFiber.ts"],"mappings":";;;iBAcgB,mBAAA,OACd,IAAA,EAAM,QAAA,CAAS,CAAA,EAAG,CAAA,GAClB,IAAA,EAAM,iBAAA,EACN,SAAA,6BACA,UAAA,6BACC,aAAA,CAAc,CAAA,EAAG,CAAA;AAAA,iBAeJ,oBAAA,OAA2B,KAAA,EAAO,aAAA,CAAc,CAAA,EAAG,CAAA;AAAA,iBAQnD,mBAAA,OACd,KAAA,EAAO,aAAA,CAAc,CAAA,EAAG,CAAA,GACxB,KAAA,EAAO,CAAA,GACN,YAAA;AAAA,iBAmBa,mBAAA,OACd,KAAA,EAAO,aAAA,CAAc,CAAA,EAAG,CAAA,GACxB,MAAA,EAAQ,YAAA"}
+{"version":3,"file":"ResourceFiber.d.ts","names":[],"sources":["../../src/core/ResourceFiber.ts"],"mappings":";;;iBAegB,mBAAA,OACd,IAAA,EAAM,QAAA,CAAS,CAAA,EAAG,CAAA,GAClB,IAAA,EAAM,iBAAA,EACN,SAAA,6BACA,UAAA,6BACC,aAAA,CAAc,CAAA,EAAG,CAAA;AAAA,iBAeJ,oBAAA,OAA2B,KAAA,EAAO,aAAA,CAAc,CAAA,EAAG,CAAA;AAAA,iBAQnD,mBAAA,OACd,KAAA,EAAO,aAAA,CAAc,CAAA,EAAG,CAAA,GACxB,KAAA,EAAO,CAAA,GACN,YAAA;AAAA,iBAqBa,mBAAA,OACd,KAAA,EAAO,aAAA,CAAc,CAAA,EAAG,CAAA,GACxB,MAAA,EAAQ,YAAA"}

package/dist/core/ResourceFiber.js

@@ -1,7 +1,8 @@
 import { callResourceFn } from "./helpers/callResourceFn.js";
+import { cleanupAllEffects, commitAllEffects } from "./helpers/commit.js";
 import { isDevelopment } from "./helpers/env.js";
 import { getDevStrictMode, withResourceFiber } from "./helpers/execution-context.js";
-import { cleanupAllEffects, commitAllEffects } from "./helpers/commit.js";
+import { withReactDispatcher } from "./react-dispatcher.js";
 //#region src/core/ResourceFiber.ts
 function createResourceFiber(type, root, markDirty = void 0, strictMode = getDevStrictMode(false)) {
 	return {
@@ -31,7 +32,7 @@ function renderResourceFiber(fiber, props) {
 	withResourceFiber(fiber, () => {
 		fiber.renderContext = result;
 		try {
-			result.output = callResourceFn(fiber.type, props);
+			result.output = withReactDispatcher(() => callResourceFn(fiber.type, props));
 		} finally {
 			fiber.renderContext = void 0;
 		}

package/dist/core/ResourceFiber.js.map

@@ -1 +1 @@
-{"version":3,"file":"ResourceFiber.js","names":[],"sources":["../../src/core/ResourceFiber.ts"],"sourcesContent":["import type {\n  ResourceFiber,\n  RenderResult,\n  Resource,\n  ResourceFiberRoot,\n} from \"./types\";\nimport { commitAllEffects, cleanupAllEffects } from \"./helpers/commit\";\nimport {\n  getDevStrictMode,\n  withResourceFiber,\n} from \"./helpers/execution-context\";\nimport { callResourceFn } from \"./helpers/callResourceFn\";\nimport { isDevelopment } from \"./helpers/env\";\n\nexport function createResourceFiber<R, P>(\n  type: Resource<R, P>,\n  root: ResourceFiberRoot,\n  markDirty: (() => void) | undefined = undefined,\n  strictMode: \"root\" | \"child\" | null = getDevStrictMode(false),\n): ResourceFiber<R, P> {\n  return {\n    type,\n    root,\n    markDirty,\n    devStrictMode: strictMode,\n    cells: [],\n    currentIndex: 0,\n    renderContext: undefined,\n    isFirstRender: true,\n    isMounted: false,\n    isNeverMounted: true,\n  };\n}\n\nexport function unmountResourceFiber<R, P>(fiber: ResourceFiber<R, P>): void {\n  if (!fiber.isMounted)\n    throw new Error(\"Tried to unmount a fiber that is already unmounted\");\n\n  fiber.isMounted = false;\n  cleanupAllEffects(fiber);\n}\n\nexport function renderResourceFiber<R, P>(\n  fiber: ResourceFiber<R, P>,\n  props: P,\n): RenderResult {\n  const result = {\n    effectTasks: [],\n    props,\n    output: undefined as R | undefined,\n  };\n\n  withResourceFiber(fiber, () => {\n    fiber.renderContext = result;\n    try {\n      result.output = callResourceFn(fiber.type, props);\n    } finally {\n      fiber.renderContext = undefined;\n    }\n  });\n\n  return result;\n}\n\nexport function commitResourceFiber<R, P>(\n  fiber: ResourceFiber<R, P>,\n  result: RenderResult,\n): void {\n  fiber.isMounted = true;\n\n  if (isDevelopment && fiber.isNeverMounted && fiber.devStrictMode === \"root\") {\n    fiber.isNeverMounted = false;\n\n    commitAllEffects(result);\n    cleanupAllEffects(fiber);\n  }\n\n  fiber.isNeverMounted = false;\n  commitAllEffects(result);\n}\n"],"mappings":";;;;;AAcA,SAAgB,oBACd,MACA,MACA,YAAsC,KAAA,GACtC,aAAsC,iBAAiB,KAAK,GACvC;CACrB,OAAO;EACL;EACA;EACA;EACA,eAAe;EACf,OAAO,CAAC;EACR,cAAc;EACd,eAAe,KAAA;EACf,eAAe;EACf,WAAW;EACX,gBAAgB;CAClB;AACF;AAEA,SAAgB,qBAA2B,OAAkC;CAC3E,IAAI,CAAC,MAAM,WACT,MAAM,IAAI,MAAM,oDAAoD;CAEtE,MAAM,YAAY;CAClB,kBAAkB,KAAK;AACzB;AAEA,SAAgB,oBACd,OACA,OACc;CACd,MAAM,SAAS;EACb,aAAa,CAAC;EACd;EACA,QAAQ,KAAA;CACV;CAEA,kBAAkB,aAAa;EAC7B,MAAM,gBAAgB;EACtB,IAAI;GACF,OAAO,SAAS,eAAe,MAAM,MAAM,KAAK;EAClD,UAAU;GACR,MAAM,gBAAgB,KAAA;EACxB;CACF,CAAC;CAED,OAAO;AACT;AAEA,SAAgB,oBACd,OACA,QACM;CACN,MAAM,YAAY;CAElB,IAAI,iBAAiB,MAAM,kBAAkB,MAAM,kBAAkB,QAAQ;EAC3E,MAAM,iBAAiB;EAEvB,iBAAiB,MAAM;EACvB,kBAAkB,KAAK;CACzB;CAEA,MAAM,iBAAiB;CACvB,iBAAiB,MAAM;AACzB"}
+{"version":3,"file":"ResourceFiber.js","names":[],"sources":["../../src/core/ResourceFiber.ts"],"sourcesContent":["import type {\n  ResourceFiber,\n  RenderResult,\n  Resource,\n  ResourceFiberRoot,\n} from \"./types\";\nimport { commitAllEffects, cleanupAllEffects } from \"./helpers/commit\";\nimport {\n  getDevStrictMode,\n  withResourceFiber,\n} from \"./helpers/execution-context\";\nimport { callResourceFn } from \"./helpers/callResourceFn\";\nimport { withReactDispatcher } from \"./react-dispatcher\";\nimport { isDevelopment } from \"./helpers/env\";\n\nexport function createResourceFiber<R, P>(\n  type: Resource<R, P>,\n  root: ResourceFiberRoot,\n  markDirty: (() => void) | undefined = undefined,\n  strictMode: \"root\" | \"child\" | null = getDevStrictMode(false),\n): ResourceFiber<R, P> {\n  return {\n    type,\n    root,\n    markDirty,\n    devStrictMode: strictMode,\n    cells: [],\n    currentIndex: 0,\n    renderContext: undefined,\n    isFirstRender: true,\n    isMounted: false,\n    isNeverMounted: true,\n  };\n}\n\nexport function unmountResourceFiber<R, P>(fiber: ResourceFiber<R, P>): void {\n  if (!fiber.isMounted)\n    throw new Error(\"Tried to unmount a fiber that is already unmounted\");\n\n  fiber.isMounted = false;\n  cleanupAllEffects(fiber);\n}\n\nexport function renderResourceFiber<R, P>(\n  fiber: ResourceFiber<R, P>,\n  props: P,\n): RenderResult {\n  const result = {\n    effectTasks: [],\n    props,\n    output: undefined as R | undefined,\n  };\n\n  withResourceFiber(fiber, () => {\n    fiber.renderContext = result;\n    try {\n      result.output = withReactDispatcher(() =>\n        callResourceFn(fiber.type, props),\n      );\n    } finally {\n      fiber.renderContext = undefined;\n    }\n  });\n\n  return result;\n}\n\nexport function commitResourceFiber<R, P>(\n  fiber: ResourceFiber<R, P>,\n  result: RenderResult,\n): void {\n  fiber.isMounted = true;\n\n  if (isDevelopment && fiber.isNeverMounted && fiber.devStrictMode === \"root\") {\n    fiber.isNeverMounted = false;\n\n    commitAllEffects(result);\n    cleanupAllEffects(fiber);\n  }\n\n  fiber.isNeverMounted = false;\n  commitAllEffects(result);\n}\n"],"mappings":";;;;;;AAeA,SAAgB,oBACd,MACA,MACA,YAAsC,KAAA,GACtC,aAAsC,iBAAiB,KAAK,GACvC;CACrB,OAAO;EACL;EACA;EACA;EACA,eAAe;EACf,OAAO,CAAC;EACR,cAAc;EACd,eAAe,KAAA;EACf,eAAe;EACf,WAAW;EACX,gBAAgB;CAClB;AACF;AAEA,SAAgB,qBAA2B,OAAkC;CAC3E,IAAI,CAAC,MAAM,WACT,MAAM,IAAI,MAAM,oDAAoD;CAEtE,MAAM,YAAY;CAClB,kBAAkB,KAAK;AACzB;AAEA,SAAgB,oBACd,OACA,OACc;CACd,MAAM,SAAS;EACb,aAAa,CAAC;EACd;EACA,QAAQ,KAAA;CACV;CAEA,kBAAkB,aAAa;EAC7B,MAAM,gBAAgB;EACtB,IAAI;GACF,OAAO,SAAS,0BACd,eAAe,MAAM,MAAM,KAAK,CAClC;EACF,UAAU;GACR,MAAM,gBAAgB,KAAA;EACxB;CACF,CAAC;CAED,OAAO;AACT;AAEA,SAAgB,oBACd,OACA,QACM;CACN,MAAM,YAAY;CAElB,IAAI,iBAAiB,MAAM,kBAAkB,MAAM,kBAAkB,QAAQ;EAC3E,MAAM,iBAAiB;EAEvB,iBAAiB,MAAM;EACvB,kBAAkB,KAAK;CACzB;CAEA,MAAM,iBAAiB;CACvB,iBAAiB,MAAM;AACzB"}

package/dist/core/context.d.ts

@@ -1,11 +1,18 @@
+import { Context } from "react";
+
 //#region src/core/context.d.ts
-declare const contextValue: unique symbol;
-type Context<T> = {
-  [contextValue]: T;
-};
+/**
+ * @deprecated experimental — the resource context API is not yet stable and may
+ * change or be removed in a future release.
+ */
 declare const createResourceContext: <T>(defaultValue: T) => Context<T>;
+declare const isResourceContext: (value: unknown) => boolean;
+/**
+ * @deprecated experimental — the resource context API is not yet stable and may
+ * change or be removed in a future release.
+ */
 declare const withContextProvider: <T, TResult>(context: Context<T>, value: T, fn: () => TResult) => TResult;
-declare const tap: <T>(context: Context<T>) => T;
+declare const useResourceContext: <T>(context: Context<T>) => T;
 //#endregion
-export { createResourceContext, tap, withContextProvider };
+export { createResourceContext, isResourceContext, useResourceContext, withContextProvider };
 //# sourceMappingURL=context.d.ts.map

package/dist/core/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","names":[],"sources":["../../src/core/context.ts"],"mappings":";cAAM,YAAA;AAAA,KACD,OAAA;EAAA,CACF,YAAY,GAAG,CAAA;AAAA;AAAA,cAGL,qBAAA,MAA4B,YAAA,EAAc,CAAA,KAAI,OAAA,CAAQ,CAAA;AAAA,cAMtD,mBAAA,eACX,OAAA,EAAS,OAAA,CAAQ,CAAA,GACjB,KAAA,EAAO,CAAA,EACP,EAAA,QAAU,OAAA,KAAO,OAAA;AAAA,cAWN,GAAA,MAAU,OAAA,EAAS,OAAA,CAAQ,CAAA,MAAE,CAAA"}
+{"version":3,"file":"context.d.ts","names":[],"sources":["../../src/core/context.ts"],"mappings":";;;;;AAkBA;;cAAa,qBAAA,MAA4B,YAAA,EAAc,CAAA,KAAI,OAAA,CAAa,CAAA;AAAA,cAM3D,iBAAA,GAAqB,KAAc;;;;;cAQnC,mBAAA,eACX,OAAA,EAAS,OAAA,CAAa,CAAA,GACtB,KAAA,EAAO,CAAA,EACP,EAAA,QAAU,OAAA,KAAO,OAAA;AAAA,cAYN,kBAAA,MAAyB,OAAA,EAAS,OAAA,CAAa,CAAA,MAAE,CAAA"}

package/dist/core/context.js

@@ -1,21 +1,34 @@
 //#region src/core/context.ts
 const contextValue = Symbol("tap.Context");
+const asTap = (context) => context;
+/**
+* @deprecated experimental — the resource context API is not yet stable and may
+* change or be removed in a future release.
+*/
 const createResourceContext = (defaultValue) => {
 	return { [contextValue]: defaultValue };
 };
+const isResourceContext = (value) => {
+	return typeof value === "object" && value !== null && contextValue in value;
+};
+/**
+* @deprecated experimental — the resource context API is not yet stable and may
+* change or be removed in a future release.
+*/
 const withContextProvider = (context, value, fn) => {
-	const previousValue = context[contextValue];
-	context[contextValue] = value;
+	const tapContext = asTap(context);
+	const previousValue = tapContext[contextValue];
+	tapContext[contextValue] = value;
 	try {
 		return fn();
 	} finally {
-		context[contextValue] = previousValue;
+		tapContext[contextValue] = previousValue;
 	}
 };
-const tap = (context) => {
-	return context[contextValue];
+const useResourceContext = (context) => {
+	return asTap(context)[contextValue];
 };
 //#endregion
-export { createResourceContext, tap, withContextProvider };
+export { createResourceContext, isResourceContext, useResourceContext, withContextProvider };
 
 //# sourceMappingURL=context.js.map

package/dist/core/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../src/core/context.ts"],"sourcesContent":["const contextValue: unique symbol = Symbol(\"tap.Context\");\ntype Context<T> = {\n  [contextValue]: T;\n};\n\nexport const createResourceContext = <T>(defaultValue: T): Context<T> => {\n  return {\n    [contextValue]: defaultValue,\n  };\n};\n\nexport const withContextProvider = <T, TResult>(\n  context: Context<T>,\n  value: T,\n  fn: () => TResult,\n) => {\n  const previousValue = context[contextValue];\n  context[contextValue] = value;\n  try {\n    return fn();\n  } finally {\n    context[contextValue] = previousValue;\n  }\n};\n\nexport const tap = <T>(context: Context<T>) => {\n  return context[contextValue];\n};\n"],"mappings":";AAAA,MAAM,eAA8B,OAAO,aAAa;AAKxD,MAAa,yBAA4B,iBAAgC;CACvE,OAAO,GACJ,eAAe,aAClB;AACF;AAEA,MAAa,uBACX,SACA,OACA,OACG;CACH,MAAM,gBAAgB,QAAQ;CAC9B,QAAQ,gBAAgB;CACxB,IAAI;EACF,OAAO,GAAG;CACZ,UAAU;EACR,QAAQ,gBAAgB;CAC1B;AACF;AAEA,MAAa,OAAU,YAAwB;CAC7C,OAAO,QAAQ;AACjB"}
+{"version":3,"file":"context.js","names":[],"sources":["../../src/core/context.ts"],"sourcesContent":["import type { Context as ReactContext } from \"react\";\n\nconst contextValue: unique symbol = Symbol(\"tap.Context\");\ntype TapContext<T> = {\n  [contextValue]: T;\n};\n\nconst asTap = <T>(context: ReactContext<T>): TapContext<T> =>\n  context as unknown as TapContext<T>;\n\n// A tap resource context is typed as a React `Context<T>` purely so React's\n// `use(context)` accepts it (the type is erased, so this adds no runtime react\n// dependency). At runtime it is only a branded `{ [contextValue]: T }` and is\n// not a usable React context — `use()` routes it to `useResourceContext()` via the brand.\n/**\n * @deprecated experimental — the resource context API is not yet stable and may\n * change or be removed in a future release.\n */\nexport const createResourceContext = <T>(defaultValue: T): ReactContext<T> => {\n  return {\n    [contextValue]: defaultValue,\n  } as unknown as ReactContext<T>;\n};\n\nexport const isResourceContext = (value: unknown): boolean => {\n  return typeof value === \"object\" && value !== null && contextValue in value;\n};\n\n/**\n * @deprecated experimental — the resource context API is not yet stable and may\n * change or be removed in a future release.\n */\nexport const withContextProvider = <T, TResult>(\n  context: ReactContext<T>,\n  value: T,\n  fn: () => TResult,\n) => {\n  const tapContext = asTap(context);\n  const previousValue = tapContext[contextValue];\n  tapContext[contextValue] = value;\n  try {\n    return fn();\n  } finally {\n    tapContext[contextValue] = previousValue;\n  }\n};\n\nexport const useResourceContext = <T>(context: ReactContext<T>) => {\n  return asTap(context)[contextValue];\n};\n"],"mappings":";AAEA,MAAM,eAA8B,OAAO,aAAa;AAKxD,MAAM,SAAY,YAChB;;;;;AAUF,MAAa,yBAA4B,iBAAqC;CAC5E,OAAO,GACJ,eAAe,aAClB;AACF;AAEA,MAAa,qBAAqB,UAA4B;CAC5D,OAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,gBAAgB;AACxE;;;;;AAMA,MAAa,uBACX,SACA,OACA,OACG;CACH,MAAM,aAAa,MAAM,OAAO;CAChC,MAAM,gBAAgB,WAAW;CACjC,WAAW,gBAAgB;CAC3B,IAAI;EACF,OAAO,GAAG;CACZ,UAAU;EACR,WAAW,gBAAgB;CAC7B;AACF;AAEA,MAAa,sBAAyB,YAA6B;CACjE,OAAO,MAAM,OAAO,CAAC,CAAC;AACxB"}

package/dist/core/createResourceRoot.d.ts

@@ -1,8 +1,9 @@
 import { ResourceElement } from "./types.js";
+import { useResourceRoot } from "../hooks/useResourceRoot.js";
 
 //#region src/core/createResourceRoot.d.ts
 declare const createResourceRoot: () => {
-  render: <R, P>(element: ResourceElement<R, P>) => any;
+  render: <R, P>(element: ResourceElement<R, P>) => useResourceRoot.SubscribableResource<R>;
   unmount: () => void;
 };
 //#endregion

package/dist/core/createResourceRoot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createResourceRoot.d.ts","names":[],"sources":["../../src/core/createResourceRoot.ts"],"mappings":";;;cAea,kBAAA;iBAqBI,OAAA,EAAW,eAAA,CAAgB,CAAA,EAAG,CAAA"}
+{"version":3,"file":"createResourceRoot.d.ts","names":[],"sources":["../../src/core/createResourceRoot.ts"],"mappings":";;;;cAea,kBAAA;iBAqBI,OAAA,EAAW,eAAA,CAAgB,CAAA,EAAG,CAAA,MAUjB,eAAA,CAAgB,oBAAA,CAAqB,CAAA"}

package/dist/core/createResourceRoot.js

@@ -3,9 +3,9 @@ import { isDevelopment } from "./helpers/env.js";
 import { createResourceFiberRoot } from "./helpers/root.js";
 import { commitResourceFiber, createResourceFiber, renderResourceFiber, unmountResourceFiber } from "./ResourceFiber.js";
 import { UpdateScheduler, flushResourcesSync } from "./scheduler.js";
-import { tapResourceRoot } from "../tapResourceRoot.js";
+import { useResourceRoot } from "../hooks/useResourceRoot.js";
 //#region src/core/createResourceRoot.ts
-const SubscribableResource = resource(tapResourceRoot);
+const SubscribableResource = resource(useResourceRoot);
 const createResourceRoot = () => {
 	const fiber = createResourceFiber(SubscribableResource, createResourceFiberRoot((callback) => {
 		new UpdateScheduler(() => {

package/dist/core/createResourceRoot.js.map

@@ -1 +1 @@
-{"version":3,"file":"createResourceRoot.js","names":[],"sources":["../../src/core/createResourceRoot.ts"],"sourcesContent":["import type { ResourceElement } from \"./types\";\nimport {\n  createResourceFiber,\n  unmountResourceFiber,\n  renderResourceFiber,\n  commitResourceFiber,\n} from \"./ResourceFiber\";\nimport { tapResourceRoot } from \"../tapResourceRoot\";\nimport { resource } from \"./resource\";\nimport { isDevelopment } from \"./helpers/env\";\nimport { flushResourcesSync, UpdateScheduler } from \"./scheduler\";\nimport { createResourceFiberRoot } from \"./helpers/root\";\n\nconst SubscribableResource = resource(tapResourceRoot);\n\nexport const createResourceRoot = () => {\n  const fiber = createResourceFiber<\n    tapResourceRoot.SubscribableResource<any>,\n    ResourceElement<any>\n  >(\n    SubscribableResource,\n    createResourceFiberRoot((callback) => {\n      new UpdateScheduler(() => {\n        if (callback()) {\n          throw new Error(\n            \"Unexpected rerender of createResourceRoot outer fiber\",\n          );\n        }\n        return false;\n      }).markDirty();\n    }),\n    undefined,\n    isDevelopment ? \"root\" : null,\n  );\n\n  return {\n    render: <R, P>(element: ResourceElement<R, P>) => {\n      // In strict mode, render twice to detect side effects\n      if (isDevelopment && fiber.devStrictMode === \"root\") {\n        void renderResourceFiber(fiber, element);\n      }\n\n      const render = renderResourceFiber(fiber, element);\n\n      flushResourcesSync(() => commitResourceFiber(fiber, render));\n\n      return render.output;\n    },\n    unmount: () => {\n      unmountResourceFiber(fiber);\n    },\n  };\n};\n"],"mappings":";;;;;;;AAaA,MAAM,uBAAuB,SAAS,eAAe;AAErD,MAAa,2BAA2B;CACtC,MAAM,QAAQ,oBAIZ,sBACA,yBAAyB,aAAa;EACpC,IAAI,sBAAsB;GACxB,IAAI,SAAS,GACX,MAAM,IAAI,MACR,uDACF;GAEF,OAAO;EACT,CAAC,EAAE,UAAU;CACf,CAAC,GACD,KAAA,GACA,gBAAgB,SAAS,IAC3B;CAEA,OAAO;EACL,SAAe,YAAmC;GAEhD,IAAI,iBAAiB,MAAM,kBAAkB,QAC3C,oBAAyB,OAAO,OAAO;GAGzC,MAAM,SAAS,oBAAoB,OAAO,OAAO;GAEjD,yBAAyB,oBAAoB,OAAO,MAAM,CAAC;GAE3D,OAAO,OAAO;EAChB;EACA,eAAe;GACb,qBAAqB,KAAK;EAC5B;CACF;AACF"}
+{"version":3,"file":"createResourceRoot.js","names":[],"sources":["../../src/core/createResourceRoot.ts"],"sourcesContent":["import type { ResourceElement } from \"./types\";\nimport {\n  createResourceFiber,\n  unmountResourceFiber,\n  renderResourceFiber,\n  commitResourceFiber,\n} from \"./ResourceFiber\";\nimport { useResourceRoot } from \"../hooks/useResourceRoot\";\nimport { resource } from \"./resource\";\nimport { isDevelopment } from \"./helpers/env\";\nimport { flushResourcesSync, UpdateScheduler } from \"./scheduler\";\nimport { createResourceFiberRoot } from \"./helpers/root\";\n\nconst SubscribableResource = resource(useResourceRoot);\n\nexport const createResourceRoot = () => {\n  const fiber = createResourceFiber<\n    useResourceRoot.SubscribableResource<any>,\n    ResourceElement<any>\n  >(\n    SubscribableResource,\n    createResourceFiberRoot((callback) => {\n      new UpdateScheduler(() => {\n        if (callback()) {\n          throw new Error(\n            \"Unexpected rerender of createResourceRoot outer fiber\",\n          );\n        }\n        return false;\n      }).markDirty();\n    }),\n    undefined,\n    isDevelopment ? \"root\" : null,\n  );\n\n  return {\n    render: <R, P>(element: ResourceElement<R, P>) => {\n      // In strict mode, render twice to detect side effects\n      if (isDevelopment && fiber.devStrictMode === \"root\") {\n        void renderResourceFiber(fiber, element);\n      }\n\n      const render = renderResourceFiber(fiber, element);\n\n      flushResourcesSync(() => commitResourceFiber(fiber, render));\n\n      return render.output as useResourceRoot.SubscribableResource<R>;\n    },\n    unmount: () => {\n      unmountResourceFiber(fiber);\n    },\n  };\n};\n"],"mappings":";;;;;;;AAaA,MAAM,uBAAuB,SAAS,eAAe;AAErD,MAAa,2BAA2B;CACtC,MAAM,QAAQ,oBAIZ,sBACA,yBAAyB,aAAa;EACpC,IAAI,sBAAsB;GACxB,IAAI,SAAS,GACX,MAAM,IAAI,MACR,uDACF;GAEF,OAAO;EACT,CAAC,CAAC,CAAC,UAAU;CACf,CAAC,GACD,KAAA,GACA,gBAAgB,SAAS,IAC3B;CAEA,OAAO;EACL,SAAe,YAAmC;GAEhD,IAAI,iBAAiB,MAAM,kBAAkB,QAC3C,oBAAyB,OAAO,OAAO;GAGzC,MAAM,SAAS,oBAAoB,OAAO,OAAO;GAEjD,yBAAyB,oBAAoB,OAAO,MAAM,CAAC;GAE3D,OAAO,OAAO;EAChB;EACA,eAAe;GACb,qBAAqB,KAAK;EAC5B;CACF;AACF"}

package/dist/core/helpers/execution-context.d.ts

@@ -3,7 +3,8 @@ import { ResourceFiber } from "../types.js";
 //#region src/core/helpers/execution-context.d.ts
 declare function withResourceFiber<R, P>(fiber: ResourceFiber<R, P>, fn: () => void): void;
 declare function getCurrentResourceFiber(): ResourceFiber<unknown, unknown>;
+declare function peekResourceFiber(): ResourceFiber<unknown, unknown> | null;
 declare function getDevStrictMode(enable: boolean): "root" | "child" | null;
 //#endregion
-export { getCurrentResourceFiber, getDevStrictMode, withResourceFiber };
+export { getCurrentResourceFiber, getDevStrictMode, peekResourceFiber, withResourceFiber };
 //# sourceMappingURL=execution-context.d.ts.map

package/dist/core/helpers/execution-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execution-context.d.ts","names":[],"sources":["../../../src/core/helpers/execution-context.ts"],"mappings":";;;iBAKgB,iBAAA,OACd,KAAA,EAAO,aAAA,CAAc,CAAA,EAAG,CAAA,GACxB,EAAA;AAAA,iBAsBc,uBAAA,IAA2B,aAAa;AAAA,iBAOxC,gBAAA,CAAiB,MAAe"}
+{"version":3,"file":"execution-context.d.ts","names":[],"sources":["../../../src/core/helpers/execution-context.ts"],"mappings":";;;iBAKgB,iBAAA,OACd,KAAA,EAAO,aAAA,CAAc,CAAA,EAAG,CAAA,GACxB,EAAA;AAAA,iBAsBc,uBAAA,IAA2B,aAAa;AAAA,iBAOxC,iBAAA,IAAqB,aAAa;AAAA,iBAIlC,gBAAA,CAAiB,MAAe"}

package/dist/core/helpers/execution-context.js

@@ -17,12 +17,15 @@ function getCurrentResourceFiber() {
 	if (!currentResourceFiber) throw new Error("No resource fiber available");
 	return currentResourceFiber;
 }
+function peekResourceFiber() {
+	return currentResourceFiber;
+}
 function getDevStrictMode(enable) {
 	if (!isDevelopment) return null;
 	if (currentResourceFiber?.devStrictMode) return currentResourceFiber.isFirstRender ? "child" : "root";
 	return enable ? "root" : null;
 }
 //#endregion
-export { getCurrentResourceFiber, getDevStrictMode, withResourceFiber };
+export { getCurrentResourceFiber, getDevStrictMode, peekResourceFiber, withResourceFiber };
 
 //# sourceMappingURL=execution-context.js.map

package/dist/core/helpers/execution-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"execution-context.js","names":[],"sources":["../../../src/core/helpers/execution-context.ts"],"sourcesContent":["import { isDevelopment } from \"./env\";\nimport type { ResourceFiber } from \"../types\";\n\nlet currentResourceFiber: ResourceFiber<any, any> | null = null;\n\nexport function withResourceFiber<R, P>(\n  fiber: ResourceFiber<R, P>,\n  fn: () => void,\n): void {\n  fiber.currentIndex = 0;\n\n  const previousContext = currentResourceFiber;\n  currentResourceFiber = fiber;\n  try {\n    fn();\n\n    fiber.isFirstRender = false;\n\n    // ensure hook count matches\n    if (fiber.cells.length !== fiber.currentIndex) {\n      throw new Error(\n        `Rendered ${fiber.currentIndex} hooks but expected ${fiber.cells.length}. ` +\n          \"Hooks must be called in the exact same order in every render.\",\n      );\n    }\n  } finally {\n    currentResourceFiber = previousContext;\n  }\n}\nexport function getCurrentResourceFiber(): ResourceFiber<unknown, unknown> {\n  if (!currentResourceFiber) {\n    throw new Error(\"No resource fiber available\");\n  }\n  return currentResourceFiber;\n}\n\nexport function getDevStrictMode(enable: boolean) {\n  if (!isDevelopment) return null;\n  if (currentResourceFiber?.devStrictMode)\n    return currentResourceFiber.isFirstRender ? \"child\" : \"root\";\n\n  return enable ? \"root\" : null;\n}\n"],"mappings":";;AAGA,IAAI,uBAAuD;AAE3D,SAAgB,kBACd,OACA,IACM;CACN,MAAM,eAAe;CAErB,MAAM,kBAAkB;CACxB,uBAAuB;CACvB,IAAI;EACF,GAAG;EAEH,MAAM,gBAAgB;EAGtB,IAAI,MAAM,MAAM,WAAW,MAAM,cAC/B,MAAM,IAAI,MACR,YAAY,MAAM,aAAa,sBAAsB,MAAM,MAAM,OAAO,gEAE1E;CAEJ,UAAU;EACR,uBAAuB;CACzB;AACF;AACA,SAAgB,0BAA2D;CACzE,IAAI,CAAC,sBACH,MAAM,IAAI,MAAM,6BAA6B;CAE/C,OAAO;AACT;AAEA,SAAgB,iBAAiB,QAAiB;CAChD,IAAI,CAAC,eAAe,OAAO;CAC3B,IAAI,sBAAsB,eACxB,OAAO,qBAAqB,gBAAgB,UAAU;CAExD,OAAO,SAAS,SAAS;AAC3B"}
+{"version":3,"file":"execution-context.js","names":[],"sources":["../../../src/core/helpers/execution-context.ts"],"sourcesContent":["import { isDevelopment } from \"./env\";\nimport type { ResourceFiber } from \"../types\";\n\nlet currentResourceFiber: ResourceFiber<any, any> | null = null;\n\nexport function withResourceFiber<R, P>(\n  fiber: ResourceFiber<R, P>,\n  fn: () => void,\n): void {\n  fiber.currentIndex = 0;\n\n  const previousContext = currentResourceFiber;\n  currentResourceFiber = fiber;\n  try {\n    fn();\n\n    fiber.isFirstRender = false;\n\n    // ensure hook count matches\n    if (fiber.cells.length !== fiber.currentIndex) {\n      throw new Error(\n        `Rendered ${fiber.currentIndex} hooks but expected ${fiber.cells.length}. ` +\n          \"Hooks must be called in the exact same order in every render.\",\n      );\n    }\n  } finally {\n    currentResourceFiber = previousContext;\n  }\n}\nexport function getCurrentResourceFiber(): ResourceFiber<unknown, unknown> {\n  if (!currentResourceFiber) {\n    throw new Error(\"No resource fiber available\");\n  }\n  return currentResourceFiber;\n}\n\nexport function peekResourceFiber(): ResourceFiber<unknown, unknown> | null {\n  return currentResourceFiber;\n}\n\nexport function getDevStrictMode(enable: boolean) {\n  if (!isDevelopment) return null;\n  if (currentResourceFiber?.devStrictMode)\n    return currentResourceFiber.isFirstRender ? \"child\" : \"root\";\n\n  return enable ? \"root\" : null;\n}\n"],"mappings":";;AAGA,IAAI,uBAAuD;AAE3D,SAAgB,kBACd,OACA,IACM;CACN,MAAM,eAAe;CAErB,MAAM,kBAAkB;CACxB,uBAAuB;CACvB,IAAI;EACF,GAAG;EAEH,MAAM,gBAAgB;EAGtB,IAAI,MAAM,MAAM,WAAW,MAAM,cAC/B,MAAM,IAAI,MACR,YAAY,MAAM,aAAa,sBAAsB,MAAM,MAAM,OAAO,gEAE1E;CAEJ,UAAU;EACR,uBAAuB;CACzB;AACF;AACA,SAAgB,0BAA2D;CACzE,IAAI,CAAC,sBACH,MAAM,IAAI,MAAM,6BAA6B;CAE/C,OAAO;AACT;AAEA,SAAgB,oBAA4D;CAC1E,OAAO;AACT;AAEA,SAAgB,iBAAiB,QAAiB;CAChD,IAAI,CAAC,eAAe,OAAO;CAC3B,IAAI,sBAAsB,eACxB,OAAO,qBAAqB,gBAAgB,UAAU;CAExD,OAAO,SAAS,SAAS;AAC3B"}

package/dist/core/react-dispatcher.d.ts

@@ -0,0 +1,12 @@
+//#region src/core/react-dispatcher.d.ts
+/**
+ * Runs a resource body with tap's React dispatcher installed, so real React
+ * hooks called inside it (`import { useState } from "react"`) route to tap, then
+ * restores the previous dispatcher. If React's internal dispatcher slot can't be
+ * found (an unsupported React version), the body runs unchanged and `react`
+ * hooks inside it keep throwing React's "invalid hook call".
+ */
+declare function withReactDispatcher<T>(render: () => T): T;
+//#endregion
+export { withReactDispatcher };
+//# sourceMappingURL=react-dispatcher.d.ts.map

package/dist/core/react-dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-dispatcher.d.ts","names":[],"sources":["../../src/core/react-dispatcher.ts"],"mappings":";;AAmEA;;;;;;iBAAgB,mBAAA,IAAuB,MAAA,QAAc,CAAA,GAAI,CAAC"}

package/dist/core/react-dispatcher.js

@@ -0,0 +1,62 @@
+import { useReducer as useReducer$1 } from "../hooks/useReducer.js";
+import { useState as useState$1 } from "../hooks/useState.js";
+import { useRef as useRef$1 } from "../hooks/useRef.js";
+import { useMemo as useMemo$1 } from "../hooks/useMemo.js";
+import { useCallback } from "../hooks/useCallback.js";
+import { useEffect } from "../hooks/useEffect.js";
+import { useEffectEvent } from "../hooks/useEffectEvent.js";
+import { use } from "../hooks/use.js";
+import { useMemoCache } from "../hooks/useMemoCache.js";
+import * as React from "react";
+//#region src/core/react-dispatcher.ts
+const tapDispatcher = {
+	useState: useState$1,
+	useReducer: useReducer$1,
+	useRef: useRef$1,
+	useMemo: useMemo$1,
+	useCallback,
+	useEffect,
+	useLayoutEffect: useEffect,
+	useInsertionEffect: useEffect,
+	useEffectEvent,
+	useContext: use,
+	use,
+	useMemoCache
+};
+const internals = React.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE ?? React.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED;
+const slot = internals == null ? null : "H" in internals ? {
+	get current() {
+		return internals.H;
+	},
+	set current(d) {
+		internals.H = d;
+	}
+} : "ReactCurrentDispatcher" in internals ? {
+	get current() {
+		return internals.ReactCurrentDispatcher.current;
+	},
+	set current(d) {
+		internals.ReactCurrentDispatcher.current = d;
+	}
+} : null;
+/**
+* Runs a resource body with tap's React dispatcher installed, so real React
+* hooks called inside it (`import { useState } from "react"`) route to tap, then
+* restores the previous dispatcher. If React's internal dispatcher slot can't be
+* found (an unsupported React version), the body runs unchanged and `react`
+* hooks inside it keep throwing React's "invalid hook call".
+*/
+function withReactDispatcher(render) {
+	if (!slot) return render();
+	const previous = slot.current;
+	slot.current = tapDispatcher;
+	try {
+		return render();
+	} finally {
+		slot.current = previous;
+	}
+}
+//#endregion
+export { withReactDispatcher };
+
+//# sourceMappingURL=react-dispatcher.js.map

package/dist/core/react-dispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-dispatcher.js","names":[],"sources":["../../src/core/react-dispatcher.ts"],"sourcesContent":["import * as React from \"react\";\nimport { useState } from \"../hooks/useState\";\nimport { useReducer } from \"../hooks/useReducer\";\nimport { useRef } from \"../hooks/useRef\";\nimport { useMemo } from \"../hooks/useMemo\";\nimport { useCallback } from \"../hooks/useCallback\";\nimport { useEffect } from \"../hooks/useEffect\";\nimport { useEffectEvent } from \"../hooks/useEffectEvent\";\nimport { use } from \"../hooks/use\";\nimport { useMemoCache } from \"../hooks/useMemoCache\";\n\n// The dispatcher React reads while a resource renders, so hooks imported from\n// \"react\" route to tap with no build step. Hooks tap has no equivalent for are\n// intentionally absent: calling one throws, which is the intended \"unsupported\n// in a resource\" signal.\nconst tapDispatcher = {\n  useState,\n  useReducer,\n  useRef,\n  useMemo,\n  useCallback,\n  useEffect,\n  useLayoutEffect: useEffect,\n  useInsertionEffect: useEffect,\n  useEffectEvent,\n  useContext: use,\n  use,\n  useMemoCache,\n};\n\n// React's live dispatcher slot differs by version: React 19 exposes it as `H` on\n// the client internals object; React 18 as `ReactCurrentDispatcher.current`.\nconst internals =\n  (React as any)\n    .__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE ??\n  (React as any).__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED;\n\nconst slot: { current: unknown } | null =\n  internals == null\n    ? null\n    : \"H\" in internals\n      ? {\n          get current() {\n            return internals.H;\n          },\n          set current(d) {\n            internals.H = d;\n          },\n        }\n      : \"ReactCurrentDispatcher\" in internals\n        ? {\n            get current() {\n              return internals.ReactCurrentDispatcher.current;\n            },\n            set current(d) {\n              internals.ReactCurrentDispatcher.current = d;\n            },\n          }\n        : null;\n\n/**\n * Runs a resource body with tap's React dispatcher installed, so real React\n * hooks called inside it (`import { useState } from \"react\"`) route to tap, then\n * restores the previous dispatcher. If React's internal dispatcher slot can't be\n * found (an unsupported React version), the body runs unchanged and `react`\n * hooks inside it keep throwing React's \"invalid hook call\".\n */\nexport function withReactDispatcher<T>(render: () => T): T {\n  if (!slot) return render();\n\n  const previous = slot.current;\n  slot.current = tapDispatcher;\n  try {\n    return render();\n  } finally {\n    slot.current = previous;\n  }\n}\n"],"mappings":";;;;;;;;;;;AAeA,MAAM,gBAAgB;CACpB,UAAA;CACA,YAAA;CACA,QAAA;CACA,SAAA;CACA;CACA;CACA,iBAAiB;CACjB,oBAAoB;CACpB;CACA,YAAY;CACZ;CACA;AACF;AAIA,MAAM,YACH,MACE,mEACF,MAAc;AAEjB,MAAM,OACJ,aAAa,OACT,OACA,OAAO,YACL;CACE,IAAI,UAAU;EACZ,OAAO,UAAU;CACnB;CACA,IAAI,QAAQ,GAAG;EACb,UAAU,IAAI;CAChB;AACF,IACA,4BAA4B,YAC1B;CACE,IAAI,UAAU;EACZ,OAAO,UAAU,uBAAuB;CAC1C;CACA,IAAI,QAAQ,GAAG;EACb,UAAU,uBAAuB,UAAU;CAC7C;AACF,IACA;;;;;;;;AASV,SAAgB,oBAAuB,QAAoB;CACzD,IAAI,CAAC,MAAM,OAAO,OAAO;CAEzB,MAAM,WAAW,KAAK;CACtB,KAAK,UAAU;CACf,IAAI;EACF,OAAO,OAAO;CAChB,UAAU;EACR,KAAK,UAAU;CACjB;AACF"}

package/dist/core/scheduler.js

@@ -36,7 +36,7 @@ const flushScheduled = () => {
 			flushState.schedulers.delete(scheduler);
 			if (!scheduler.isDirty) continue;
 			flushDepth++;
-			if (flushDepth > MAX_FLUSH_LIMIT) throw new Error("Maximum update depth exceeded. This can happen when a resource repeatedly calls setState inside tapEffect.");
+			if (flushDepth > MAX_FLUSH_LIMIT) throw new Error("Maximum update depth exceeded. This can happen when a resource repeatedly calls setState inside useEffect.");
 			try {
 				scheduler.runTask();
 			} catch (error) {

package/dist/core/scheduler.js.map

@@ -1 +1 @@
-{"version":3,"file":"scheduler.js","names":[],"sources":["../../src/core/scheduler.ts"],"sourcesContent":["type Task = () => void;\n\ntype GlobalFlushState = {\n  schedulers: Set<UpdateScheduler>;\n  isScheduled: boolean;\n};\n\nconst MAX_FLUSH_LIMIT = 50;\nlet flushState: GlobalFlushState = {\n  schedulers: new Set([]),\n  isScheduled: false,\n};\n\nexport class UpdateScheduler {\n  private _isDirty = false;\n\n  constructor(private readonly _task: Task) {}\n\n  get isDirty() {\n    return this._isDirty;\n  }\n\n  markDirty() {\n    this._isDirty = true;\n\n    flushState.schedulers.add(this);\n    scheduleFlush();\n  }\n\n  runTask() {\n    this._isDirty = false;\n    this._task();\n  }\n}\n\nconst scheduleFlush = () => {\n  if (flushState.isScheduled) return;\n  flushState.isScheduled = true;\n  scheduleMacrotask();\n};\n\nconst flushScheduled = () => {\n  try {\n    const errors = [];\n    let flushDepth = 0;\n\n    for (const scheduler of flushState.schedulers) {\n      flushState.schedulers.delete(scheduler);\n      if (!scheduler.isDirty) continue;\n\n      flushDepth++;\n\n      if (flushDepth > MAX_FLUSH_LIMIT) {\n        throw new Error(\n          `Maximum update depth exceeded. This can happen when a resource ` +\n            `repeatedly calls setState inside tapEffect.`,\n        );\n      }\n\n      try {\n        scheduler.runTask();\n      } catch (error) {\n        errors.push(error);\n      }\n    }\n\n    if (errors.length > 0) {\n      if (errors.length === 1) {\n        throw errors[0];\n      } else {\n        for (const error of errors) {\n          console.error(error);\n        }\n        throw new AggregateError(errors, \"Errors occurred during flushSync\");\n      }\n    }\n  } finally {\n    flushState.schedulers.clear();\n    flushState.isScheduled = false;\n  }\n};\n\n// Use MessageChannel to schedule flushes as macrotasks (like React's scheduler).\n// This allows more state updates to batch into a single re-render.\nconst scheduleMacrotask = (() => {\n  if (typeof MessageChannel !== \"undefined\") {\n    const channel = new MessageChannel();\n    channel.port1.onmessage = flushScheduled;\n    return () => channel.port2.postMessage(null);\n  }\n  // Fallback for environments without MessageChannel\n  return () => setTimeout(flushScheduled, 0);\n})();\n\nexport const flushResourcesSync = <T>(callback: () => T): T => {\n  const prev = flushState;\n  flushState = {\n    schedulers: new Set([]),\n    isScheduled: true,\n  };\n\n  try {\n    const result = callback();\n    flushScheduled();\n\n    return result;\n  } finally {\n    flushState = prev;\n  }\n};\n"],"mappings":";AAOA,MAAM,kBAAkB;AACxB,IAAI,aAA+B;CACjC,4BAAY,IAAI,IAAI,CAAC,CAAC;CACtB,aAAa;AACf;AAEA,IAAa,kBAAb,MAA6B;CAGE;CAF7B,WAAmB;CAEnB,YAAY,OAA8B;EAAb,KAAA,QAAA;CAAc;CAE3C,IAAI,UAAU;EACZ,OAAO,KAAK;CACd;CAEA,YAAY;EACV,KAAK,WAAW;EAEhB,WAAW,WAAW,IAAI,IAAI;EAC9B,cAAc;CAChB;CAEA,UAAU;EACR,KAAK,WAAW;EAChB,KAAK,MAAM;CACb;AACF;AAEA,MAAM,sBAAsB;CAC1B,IAAI,WAAW,aAAa;CAC5B,WAAW,cAAc;CACzB,kBAAkB;AACpB;AAEA,MAAM,uBAAuB;CAC3B,IAAI;EACF,MAAM,SAAS,CAAC;EAChB,IAAI,aAAa;EAEjB,KAAK,MAAM,aAAa,WAAW,YAAY;GAC7C,WAAW,WAAW,OAAO,SAAS;GACtC,IAAI,CAAC,UAAU,SAAS;GAExB;GAEA,IAAI,aAAa,iBACf,MAAM,IAAI,MACR,4GAEF;GAGF,IAAI;IACF,UAAU,QAAQ;GACpB,SAAS,OAAO;IACd,OAAO,KAAK,KAAK;GACnB;EACF;EAEA,IAAI,OAAO,SAAS,GAClB,IAAI,OAAO,WAAW,GACpB,MAAM,OAAO;OACR;GACL,KAAK,MAAM,SAAS,QAClB,QAAQ,MAAM,KAAK;GAErB,MAAM,IAAI,eAAe,QAAQ,kCAAkC;EACrE;CAEJ,UAAU;EACR,WAAW,WAAW,MAAM;EAC5B,WAAW,cAAc;CAC3B;AACF;AAIA,MAAM,2BAA2B;CAC/B,IAAI,OAAO,mBAAmB,aAAa;EACzC,MAAM,UAAU,IAAI,eAAe;EACnC,QAAQ,MAAM,YAAY;EAC1B,aAAa,QAAQ,MAAM,YAAY,IAAI;CAC7C;CAEA,aAAa,WAAW,gBAAgB,CAAC;AAC3C,GAAG;AAEH,MAAa,sBAAyB,aAAyB;CAC7D,MAAM,OAAO;CACb,aAAa;EACX,4BAAY,IAAI,IAAI,CAAC,CAAC;EACtB,aAAa;CACf;CAEA,IAAI;EACF,MAAM,SAAS,SAAS;EACxB,eAAe;EAEf,OAAO;CACT,UAAU;EACR,aAAa;CACf;AACF"}
+{"version":3,"file":"scheduler.js","names":[],"sources":["../../src/core/scheduler.ts"],"sourcesContent":["type Task = () => void;\n\ntype GlobalFlushState = {\n  schedulers: Set<UpdateScheduler>;\n  isScheduled: boolean;\n};\n\nconst MAX_FLUSH_LIMIT = 50;\nlet flushState: GlobalFlushState = {\n  schedulers: new Set([]),\n  isScheduled: false,\n};\n\nexport class UpdateScheduler {\n  private _isDirty = false;\n\n  constructor(private readonly _task: Task) {}\n\n  get isDirty() {\n    return this._isDirty;\n  }\n\n  markDirty() {\n    this._isDirty = true;\n\n    flushState.schedulers.add(this);\n    scheduleFlush();\n  }\n\n  runTask() {\n    this._isDirty = false;\n    this._task();\n  }\n}\n\nconst scheduleFlush = () => {\n  if (flushState.isScheduled) return;\n  flushState.isScheduled = true;\n  scheduleMacrotask();\n};\n\nconst flushScheduled = () => {\n  try {\n    const errors = [];\n    let flushDepth = 0;\n\n    for (const scheduler of flushState.schedulers) {\n      flushState.schedulers.delete(scheduler);\n      if (!scheduler.isDirty) continue;\n\n      flushDepth++;\n\n      if (flushDepth > MAX_FLUSH_LIMIT) {\n        throw new Error(\n          `Maximum update depth exceeded. This can happen when a resource ` +\n            `repeatedly calls setState inside useEffect.`,\n        );\n      }\n\n      try {\n        scheduler.runTask();\n      } catch (error) {\n        errors.push(error);\n      }\n    }\n\n    if (errors.length > 0) {\n      if (errors.length === 1) {\n        throw errors[0];\n      } else {\n        for (const error of errors) {\n          console.error(error);\n        }\n        throw new AggregateError(errors, \"Errors occurred during flushSync\");\n      }\n    }\n  } finally {\n    flushState.schedulers.clear();\n    flushState.isScheduled = false;\n  }\n};\n\n// Use MessageChannel to schedule flushes as macrotasks (like React's scheduler).\n// This allows more state updates to batch into a single re-render.\nconst scheduleMacrotask = (() => {\n  if (typeof MessageChannel !== \"undefined\") {\n    const channel = new MessageChannel();\n    channel.port1.onmessage = flushScheduled;\n    return () => channel.port2.postMessage(null);\n  }\n  // Fallback for environments without MessageChannel\n  return () => setTimeout(flushScheduled, 0);\n})();\n\nexport const flushResourcesSync = <T>(callback: () => T): T => {\n  const prev = flushState;\n  flushState = {\n    schedulers: new Set([]),\n    isScheduled: true,\n  };\n\n  try {\n    const result = callback();\n    flushScheduled();\n\n    return result;\n  } finally {\n    flushState = prev;\n  }\n};\n"],"mappings":";AAOA,MAAM,kBAAkB;AACxB,IAAI,aAA+B;CACjC,4BAAY,IAAI,IAAI,CAAC,CAAC;CACtB,aAAa;AACf;AAEA,IAAa,kBAAb,MAA6B;CAGE;CAF7B,WAAmB;CAEnB,YAAY,OAA8B;EAAb,KAAA,QAAA;CAAc;CAE3C,IAAI,UAAU;EACZ,OAAO,KAAK;CACd;CAEA,YAAY;EACV,KAAK,WAAW;EAEhB,WAAW,WAAW,IAAI,IAAI;EAC9B,cAAc;CAChB;CAEA,UAAU;EACR,KAAK,WAAW;EAChB,KAAK,MAAM;CACb;AACF;AAEA,MAAM,sBAAsB;CAC1B,IAAI,WAAW,aAAa;CAC5B,WAAW,cAAc;CACzB,kBAAkB;AACpB;AAEA,MAAM,uBAAuB;CAC3B,IAAI;EACF,MAAM,SAAS,CAAC;EAChB,IAAI,aAAa;EAEjB,KAAK,MAAM,aAAa,WAAW,YAAY;GAC7C,WAAW,WAAW,OAAO,SAAS;GACtC,IAAI,CAAC,UAAU,SAAS;GAExB;GAEA,IAAI,aAAa,iBACf,MAAM,IAAI,MACR,4GAEF;GAGF,IAAI;IACF,UAAU,QAAQ;GACpB,SAAS,OAAO;IACd,OAAO,KAAK,KAAK;GACnB;EACF;EAEA,IAAI,OAAO,SAAS,GAClB,IAAI,OAAO,WAAW,GACpB,MAAM,OAAO;OACR;GACL,KAAK,MAAM,SAAS,QAClB,QAAQ,MAAM,KAAK;GAErB,MAAM,IAAI,eAAe,QAAQ,kCAAkC;EACrE;CAEJ,UAAU;EACR,WAAW,WAAW,MAAM;EAC5B,WAAW,cAAc;CAC3B;AACF;AAIA,MAAM,2BAA2B;CAC/B,IAAI,OAAO,mBAAmB,aAAa;EACzC,MAAM,UAAU,IAAI,eAAe;EACnC,QAAQ,MAAM,YAAY;EAC1B,aAAa,QAAQ,MAAM,YAAY,IAAI;CAC7C;CAEA,aAAa,WAAW,gBAAgB,CAAC;AAC3C,EAAA,CAAG;AAEH,MAAa,sBAAyB,aAAyB;CAC7D,MAAM,OAAO;CACb,aAAa;EACX,4BAAY,IAAI,IAAI,CAAC,CAAC;EACtB,aAAa;CACf;CAEA,IAAI;EACF,MAAM,SAAS,SAAS;EACxB,eAAe;EAEf,OAAO;CACT,UAAU;EACR,aAAa;CACf;AACF"}

package/dist/core/types.d.ts

@@ -1,4 +1,4 @@
-import { tapEffect } from "../hooks/tap-effect.js";
+import { useEffect } from "../hooks/useEffect.js";
 
 //#region src/core/types.d.ts
 type ResourceElement<R, P = any> = {
@@ -24,11 +24,11 @@ type Cell = {
   reducer: (state: any, action: any) => any;
 } | {
   readonly type: "effect";
-  cleanup: tapEffect.Destructor | undefined;
+  cleanup: useEffect.Destructor | undefined;
   deps: readonly unknown[] | null | undefined;
 };
 interface EffectTask {
-  readonly effect: tapEffect.EffectCallback;
+  readonly effect: useEffect.EffectCallback;
   readonly deps: readonly unknown[] | undefined;
   readonly cell: Cell & {
     type: "effect";

package/dist/hooks/index.d.ts

@@ -0,0 +1,13 @@
+import { useEffect } from "./useEffect.js";
+import { useResourceRoot } from "./useResourceRoot.js";
+import { useState } from "./useState.js";
+import { useReducer, useReducerWithDerivedState } from "./useReducer.js";
+import { useRef } from "./useRef.js";
+import { useMemo } from "./useMemo.js";
+import { useCallback } from "./useCallback.js";
+import { useEffectEvent } from "./useEffectEvent.js";
+import { use } from "./use.js";
+import { useMemoCache } from "./useMemoCache.js";
+import { useResource } from "./useResource.js";
+import { useResources } from "./useResources.js";
+export { use, useCallback, useEffect, useEffectEvent, useMemo, useMemoCache, useReducer, useReducerWithDerivedState, useRef, useResource, useResourceRoot, useResources, useState };

package/dist/hooks/index.js

@@ -0,0 +1,13 @@
+import { useReducer, useReducerWithDerivedState } from "./useReducer.js";
+import { useState } from "./useState.js";
+import { useRef } from "./useRef.js";
+import { useMemo } from "./useMemo.js";
+import { useCallback } from "./useCallback.js";
+import { useEffect } from "./useEffect.js";
+import { useEffectEvent } from "./useEffectEvent.js";
+import { use } from "./use.js";
+import { useMemoCache } from "./useMemoCache.js";
+import { useResourceRoot } from "./useResourceRoot.js";
+import { useResource } from "./useResource.js";
+import { useResources } from "./useResources.js";
+export { use, useCallback, useEffect, useEffectEvent, useMemo, useMemoCache, useReducer, useReducerWithDerivedState, useRef, useResource, useResourceRoot, useResources, useState };

package/dist/hooks/use.d.ts

@@ -0,0 +1,9 @@
+//#region src/hooks/use.d.ts
+/**
+ * Reads a resource context from inside a resource render, the tap equivalent of
+ * React's `use(Context)`. Only resource contexts are supported.
+ */
+declare const use: (usable: unknown) => unknown;
+//#endregion
+export { use };
+//# sourceMappingURL=use.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use.d.ts","names":[],"sources":["../../src/hooks/use.ts"],"mappings":";;AAMA;;;cAAa,GAAA,GAAO,MAAe"}

package/dist/hooks/use.js

@@ -0,0 +1,14 @@
+import { isResourceContext, useResourceContext } from "../core/context.js";
+//#region src/hooks/use.ts
+/**
+* Reads a resource context from inside a resource render, the tap equivalent of
+* React's `use(Context)`. Only resource contexts are supported.
+*/
+const use = (usable) => {
+	if (!isResourceContext(usable)) throw new Error("A tap resource's `use()` only accepts a resource context.");
+	return useResourceContext(usable);
+};
+//#endregion
+export { use };
+
+//# sourceMappingURL=use.js.map

package/dist/hooks/use.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use.js","names":[],"sources":["../../src/hooks/use.ts"],"sourcesContent":["import { isResourceContext, useResourceContext } from \"../core/context\";\n\n/**\n * Reads a resource context from inside a resource render, the tap equivalent of\n * React's `use(Context)`. Only resource contexts are supported.\n */\nexport const use = (usable: unknown): unknown => {\n  if (!isResourceContext(usable))\n    throw new Error(\n      \"A tap resource's `use()` only accepts a resource context.\",\n    );\n  return useResourceContext(usable as never);\n};\n"],"mappings":";;;;;;AAMA,MAAa,OAAO,WAA6B;CAC/C,IAAI,CAAC,kBAAkB,MAAM,GAC3B,MAAM,IAAI,MACR,2DACF;CACF,OAAO,mBAAmB,MAAe;AAC3C"}

package/dist/hooks/useCallback.d.ts

@@ -0,0 +1,5 @@
+//#region src/hooks/useCallback.d.ts
+declare const useCallback: <T extends (...args: any[]) => any>(fn: T, deps: readonly unknown[]) => T;
+//#endregion
+export { useCallback };
+//# sourceMappingURL=useCallback.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useCallback.d.ts","names":[],"sources":["../../src/hooks/useCallback.ts"],"mappings":";cAEa,WAAA,iBAA6B,IAAA,iBACxC,EAAA,EAAI,CAAA,EACJ,IAAA,yBACC,CAGF"}

package/dist/hooks/useCallback.js

@@ -0,0 +1,9 @@
+import { useMemo } from "./useMemo.js";
+//#region src/hooks/useCallback.ts
+const useCallback = (fn, deps) => {
+	return useMemo(() => fn, deps);
+};
+//#endregion
+export { useCallback };
+
+//# sourceMappingURL=useCallback.js.map

package/dist/hooks/useCallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCallback.js","names":[],"sources":["../../src/hooks/useCallback.ts"],"sourcesContent":["import { useMemo } from \"./useMemo\";\n\nexport const useCallback = <T extends (...args: any[]) => any>(\n  fn: T,\n  deps: readonly unknown[],\n): T => {\n  // oxlint-disable-next-line react/exhaustive-deps -- user-provided dep array forwarded verbatim\n  return useMemo(() => fn, deps);\n};\n"],"mappings":";;AAEA,MAAa,eACX,IACA,SACM;CAEN,OAAO,cAAc,IAAI,IAAI;AAC/B"}

package/dist/hooks/useEffect.d.ts

@@ -0,0 +1,10 @@
+//#region src/hooks/useEffect.d.ts
+declare namespace useEffect {
+  type Destructor = () => void;
+  type EffectCallback = () => Destructor | undefined;
+}
+declare function useEffect(effect: useEffect.EffectCallback): void;
+declare function useEffect(effect: useEffect.EffectCallback, deps: readonly unknown[]): void;
+//#endregion
+export { useEffect };
+//# sourceMappingURL=useEffect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useEffect.d.ts","names":[],"sources":["../../src/hooks/useEffect.ts"],"mappings":";kBAUiB,SAAA;EAAA,KACH,UAAA;EAAA,KACA,cAAA,SAAuB,UAAU;AAAA;AAAA,iBAG/B,SAAA,CAAU,MAAA,EAAQ,SAAA,CAAU,cAAc;AAAA,iBAC1C,SAAA,CACd,MAAA,EAAQ,SAAA,CAAU,cAAc,EAChC,IAAA"}

package/dist/hooks/{tap-effect.js → useEffect.js}

@@ -1,15 +1,15 @@
-import { registerRenderMountTask, tapHook } from "./utils/tapHook.js";
+import { registerRenderMountTask, useCell } from "./utils/useCell.js";
 import { depsShallowEqual } from "./utils/depsShallowEqual.js";
-//#region src/hooks/tap-effect.ts
+//#region src/hooks/useEffect.ts
 const newEffect = () => ({
 	type: "effect",
 	cleanup: void 0,
 	deps: null
 });
-function tapEffect(effect, deps) {
-	const cell = tapHook("effect", newEffect);
+function useEffect(effect, deps) {
+	const cell = useCell("effect", newEffect);
 	if (deps && cell.deps && depsShallowEqual(cell.deps, deps)) return;
-	if (cell.deps !== null && !!deps !== !!cell.deps) throw new Error("tapEffect called with and without dependencies across re-renders");
+	if (cell.deps !== null && !!deps !== !!cell.deps) throw new Error("useEffect called with and without dependencies across re-renders");
 	registerRenderMountTask(() => {
 		const errors = [];
 		try {
@@ -35,6 +35,6 @@ function tapEffect(effect, deps) {
 	});
 }
 //#endregion
-export { tapEffect };
+export { useEffect };
 
-//# sourceMappingURL=tap-effect.js.map
+//# sourceMappingURL=useEffect.js.map

package/dist/hooks/useEffect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEffect.js","names":[],"sources":["../../src/hooks/useEffect.ts"],"sourcesContent":["import type { Cell } from \"../core/types\";\nimport { depsShallowEqual } from \"./utils/depsShallowEqual\";\nimport { useCell, registerRenderMountTask } from \"./utils/useCell\";\n\nconst newEffect = (): Cell & { type: \"effect\" } => ({\n  type: \"effect\",\n  cleanup: undefined,\n  deps: null, // null means the effect has never been run\n});\n\nexport namespace useEffect {\n  export type Destructor = () => void;\n  export type EffectCallback = () => Destructor | undefined;\n}\n\nexport function useEffect(effect: useEffect.EffectCallback): void;\nexport function useEffect(\n  effect: useEffect.EffectCallback,\n  deps: readonly unknown[],\n): void;\nexport function useEffect(\n  effect: useEffect.EffectCallback,\n  deps?: readonly unknown[],\n): void {\n  const cell = useCell(\"effect\", newEffect);\n\n  if (deps && cell.deps && depsShallowEqual(cell.deps, deps)) return;\n  if (cell.deps !== null && !!deps !== !!cell.deps)\n    throw new Error(\n      \"useEffect called with and without dependencies across re-renders\",\n    );\n\n  registerRenderMountTask(() => {\n    const errors: unknown[] = [];\n\n    try {\n      cell.cleanup?.();\n    } catch (error) {\n      errors.push(error);\n    } finally {\n      cell.cleanup = undefined;\n    }\n\n    try {\n      const cleanup = effect();\n\n      if (cleanup !== undefined && typeof cleanup !== \"function\") {\n        throw new Error(\n          \"An effect function must either return a cleanup function or nothing. \" +\n            `Received: ${typeof cleanup}`,\n        );\n      }\n\n      cell.cleanup = cleanup;\n    } catch (error) {\n      errors.push(error);\n    }\n\n    cell.deps = deps;\n\n    if (errors.length > 0) {\n      if (errors.length === 1) {\n        throw errors[0];\n      } else {\n        for (const error of errors) {\n          console.error(error);\n        }\n        throw new AggregateError(errors, \"Errors during commit\");\n      }\n    }\n  });\n}\n"],"mappings":";;;AAIA,MAAM,mBAA8C;CAClD,MAAM;CACN,SAAS,KAAA;CACT,MAAM;AACR;AAYA,SAAgB,UACd,QACA,MACM;CACN,MAAM,OAAO,QAAQ,UAAU,SAAS;CAExC,IAAI,QAAQ,KAAK,QAAQ,iBAAiB,KAAK,MAAM,IAAI,GAAG;CAC5D,IAAI,KAAK,SAAS,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,KAAK,MAC1C,MAAM,IAAI,MACR,kEACF;CAEF,8BAA8B;EAC5B,MAAM,SAAoB,CAAC;EAE3B,IAAI;GACF,KAAK,UAAU;EACjB,SAAS,OAAO;GACd,OAAO,KAAK,KAAK;EACnB,UAAU;GACR,KAAK,UAAU,KAAA;EACjB;EAEA,IAAI;GACF,MAAM,UAAU,OAAO;GAEvB,IAAI,YAAY,KAAA,KAAa,OAAO,YAAY,YAC9C,MAAM,IAAI,MACR,kFACe,OAAO,SACxB;GAGF,KAAK,UAAU;EACjB,SAAS,OAAO;GACd,OAAO,KAAK,KAAK;EACnB;EAEA,KAAK,OAAO;EAEZ,IAAI,OAAO,SAAS,GAClB,IAAI,OAAO,WAAW,GACpB,MAAM,OAAO;OACR;GACL,KAAK,MAAM,SAAS,QAClB,QAAQ,MAAM,KAAK;GAErB,MAAM,IAAI,eAAe,QAAQ,sBAAsB;EACzD;CAEJ,CAAC;AACH"}

package/dist/hooks/{tap-effect-event.d.ts → useEffectEvent.d.ts}

@@ -1,4 +1,4 @@
-//#region src/hooks/tap-effect-event.d.ts
+//#region src/hooks/useEffectEvent.d.ts
 /**
  * Creates a stable function reference that always calls the most recent version of the callback.
  * Similar to React's useEffectEvent hook.
@@ -8,13 +8,13 @@
  *
  * @example
  * ```typescript
- * const handleClick = tapEffectEvent((value: string) => {
+ * const handleClick = useEffectEvent((value: string) => {
  *   console.log(value);
  * });
  * // handleClick reference is stable, but always calls the latest version
  * ```
  */
-declare function tapEffectEvent<T extends (...args: any[]) => any>(callback: T): T;
+declare function useEffectEvent<T extends (...args: any[]) => any>(callback: T): T;
 //#endregion
-export { tapEffectEvent };
-//# sourceMappingURL=tap-effect-event.d.ts.map
+export { useEffectEvent };
+//# sourceMappingURL=useEffectEvent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useEffectEvent.d.ts","names":[],"sources":["../../src/hooks/useEffectEvent.ts"],"mappings":";;AAqBA;;;;;;;;;;AAEI;;;;iBAFY,cAAA,eAA6B,IAAA,iBAC3C,QAAA,EAAU,CAAA,GACT,CAAC"}