@assistant-ui/tap 0.5.11 → 0.5.13

package/README.md

@@ -1,6 +1,13 @@
-# @assistant-ui/tap
+# `@assistant-ui/tap`
 
-**tap** (Reactive Resources) is a zero-dependency reactive state management library that brings **React's hooks mental model to state management outside of React components**.
+[![npm version](https://img.shields.io/npm/v/@assistant-ui/tap)](https://www.npmjs.com/package/@assistant-ui/tap)
+[![npm downloads](https://img.shields.io/npm/dm/@assistant-ui/tap)](https://www.npmjs.com/package/@assistant-ui/tap)
+[![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`.
+
+`tap` powers the runtime layer of assistant-ui. Most users do not install it directly; reach for `@assistant-ui/react` instead.
 
 ## Installation
 
@@ -8,400 +15,50 @@
 npm install @assistant-ui/tap
 ```
 
-## What is tap?
-
-Instead of limiting hooks to React components, tap lets you use the same familiar hooks pattern (`useState`, `useEffect`, `useMemo`, etc.) to create self-contained, reusable units of reactive state and logic called **Resources** that can be used anywhere - in vanilla JavaScript, servers, or outside of React.
-
-## Philosophy
-
-- **Unified mental model**: Use the same hooks pattern everywhere
-- **Framework agnostic**: Zero dependencies, works with or without React
-- **Lifecycle management**: Resources handle their own cleanup automatically
-- **Type-safe**: Full TypeScript support with proper type inference
-
-## How It Works
-
-tap implements a **render-commit pattern** similar to React:
-
-### Render Phase
-
-1. Each resource instance has a "fiber" that tracks state and effects
-2. When a resource function runs, hooks record their data in the fiber
-3. The library maintains an execution context to track which fiber's hooks are being called
-4. Each hook stores its data in cells indexed by call order (enforcing React's rules)
-
-### Commit Phase
-
-1. After render, collected effect tasks are processed
-2. Effects check if dependencies changed using shallow equality
-3. Old effects are cleaned up before new ones run
-4. Updates are batched using microtasks to prevent excessive re-renders
-
-## Core Concepts
-
-### Resources
-
-Resources are self-contained units of reactive state and logic. They follow the same rules as React hooks:
-
-- **Hook Order**: Hooks must be called in the same order in every render
-- **No Conditional Hooks**: Can't call hooks inside conditionals or loops
-- **No Async Hooks**: Hooks must be called synchronously during render
-- Resources automatically handle cleanup and lifecycle
-
-### Creating Resources
+## Usage
 
 ```typescript
-import { createResourceRoot, tapState, tapEffect } from "@assistant-ui/tap";
+import { resource, tapState, tapEffect, createResourceRoot } from "@assistant-ui/tap";
 
-// Define a resource using familiar hook patterns
 const Counter = resource(({ incrementBy = 1 }: { incrementBy?: number }) => {
   const [count, setCount] = tapState(0);
 
   tapEffect(() => {
-    console.log(`Count is now: ${count}`);
+    console.log("count:", count);
   }, [count]);
 
   return {
     count,
     increment: () => setCount((c) => c + incrementBy),
-    decrement: () => setCount((c) => c - incrementBy),
   };
 });
 
-// Create an instance
 const root = createResourceRoot();
 const counter = root.render(Counter({ incrementBy: 2 }));
 
-// Subscribe to changes
 const unsubscribe = counter.subscribe(() => {
-  console.log("Counter value:", counter.getValue().count);
+  console.log("counter updated:", counter.getValue().count);
 });
 
-// Use the resource
 counter.getValue().increment();
 ```
 
-## `resource`
-
-Creates a resource element factory. Resource elements are plain objects of the type `{ type: ResourceFn<R, P>, props: P, key?: string | number }`.
-
-```typescript
-const Counter = resource(({ incrementBy = 1 }: { incrementBy?: number }) => {
-  const [count, setCount] = tapState(0);
-});
-
-// create a Counter element
-const counterEl = Counter({ incrementBy: 2 });
-
-// create a Counter instance
-const root = createResourceRoot();
-root.render(counterEl);
-root.unmount();
-```
-
-## Hook APIs
+In React, use the `useResource` hook from the `/react` sub-path:
 
-### `tapState`
-
-Manages local state within a resource, exactly like React's `useState`.
-
-```typescript
-const [value, setValue] = tapState(initialValue);
-const [value, setValue] = tapState(() => computeInitialValue());
-```
-
-### `tapEffect`
-
-Runs side effects with automatic cleanup, exactly like React's `useEffect`.
-
-```typescript
-tapEffect(() => {
-  // Effect logic
-  return () => {
-    // Cleanup logic
-  };
-}, [dependencies]);
-```
-
-### `tapMemo`
-
-Memoizes expensive computations, exactly like React's `useMemo`.
-
-```typescript
-const expensiveValue = tapMemo(() => {
-  return computeExpensiveValue(dep1, dep2);
-}, [dep1, dep2]);
-```
-
-### `tapCallback`
-
-Memoizes callbacks to prevent unnecessary re-renders, exactly like React's `useCallback`.
-
-```typescript
-const stableCallback = tapCallback(() => {
-  doSomething(value);
-}, [value]);
-```
-
-### `tapRef`
-
-Creates a mutable reference that persists across renders, exactly like React's `useRef`.
-
-```typescript
-// With initial value
-const ref = tapRef(initialValue);
-ref.current = newValue;
-
-// Without initial value
-const ref = tapRef<string>(); // ref.current is undefined
-ref.current = "hello";
-```
-
-### `tapResource`
-
-Composes resources together - resources can render other resources.
-
-```typescript
-const Timer = resource(() => {
-  const counter = tapResource({ type: Counter, props: { incrementBy: 1 } });
-
-  tapEffect(() => {
-    const interval = setInterval(() => {
-      counter.increment();
-    }, 1000);
-    return () => clearInterval(interval);
-  }, []);
-
-  return counter.count;
-});
-```
-
-### `tapResources`
-
-Renders multiple resources from an array, similar to React's list rendering. Returns an array with each resource's result.
-
-```typescript
-tapResources<E extends ResourceElement<any, any>>(
-  getElements: () => readonly E[],
-  getElementsDeps: readonly any[]
-): ExtractResourceReturnType<E>[]
-```
-
-**Parameters:**
-- `getElements`: A function that returns an array of ResourceElements
-- `getElementsDeps`: Dependency array for memoizing the getElements function
-
-**Example:**
-
-```typescript
-const TodoItem = resource((props: { text: string }) => {
-  const [completed, setCompleted] = tapState(false);
-  return { text: props.text, completed, setCompleted };
-});
-
-const TodoList = resource(() => {
-  const todos = tapMemo(
-    () => [
-      { id: "1", text: "Learn tap" },
-      { id: "2", text: "Build something awesome" },
-    ],
-    [],
-  );
-
-  // Returns Array<{ text, completed, setCompleted }>
-  const todoItems = tapResources(
-    () => todos.map((todo) => TodoItem({ text: todo.text })),
-    [todos]
-  );
-
-  return todoItems;
-});
-```
-
-**Key features:**
-- Resource instances are preserved when keys remain the same (use `withKey()` to provide stable keys)
-- Automatically cleans up resources when removed from the array
-- Handles resource type changes (recreates fiber if type changes)
-
-### `tap` and Context Support
-
-Create and use context to pass values through resource boundaries without prop drilling.
-
-```typescript
-import {
-  createResourceContext,
-  tap,
-  withContextProvider,
-} from "@assistant-ui/tap";
-
-const MyContext = createResourceContext(defaultValue);
-
-// Provide context
-withContextProvider(MyContext, value, () => {
-  // Inside this function, tap can access the value
-});
-
-// Access context in a resource
-const value = tap(MyContext);
-```
-
-## Resource Management
-
-### `createResourceRoot`
-
-Create an instance of a resource. Call `render()` with a resource element to render it and mount effects. Returns a `SubscribableResource` with `getValue()` and `subscribe()`.
-
-```typescript
-import { createResourceRoot } from "@assistant-ui/tap";
-
-const root = createResourceRoot();
-const counter = root.render(Counter({ incrementBy: 1 }));
-
-// Access current value
-console.log(counter.getValue().count);
-
-// Subscribe to changes
-const unsubscribe = counter.subscribe(() => {
-  console.log("Counter updated:", counter.getValue());
-});
-
-// Update props by calling render again
-root.render(Counter({ incrementBy: 2 }));
-
-// Cleanup
-root.unmount();
-unsubscribe();
-```
-
-## React Integration
-
-Use resources directly in React components with the `useResource` hook:
-
-```typescript
+```tsx
 import { useResource } from "@assistant-ui/tap/react";
 
-function MyComponent() {
-  const state = useResource(new Counter({ incrementBy: 1 }));
-  return (
-    <div>
-      <p>Count: {state.count}</p>
-      <button onClick={state.increment}>Increment</button>
-    </div>
-  );
+function CounterButton() {
+  const { count, increment } = useResource(Counter({ incrementBy: 1 }));
+  return <button onClick={increment}>{count}</button>;
 }
 ```
 
-## Design Patterns
-
-### Automatic Cleanup
-
-Resources automatically clean up after themselves when unmounted:
-
-```typescript
-const WebSocketResource = resource(() => {
-  const [messages, setMessages] = tapState<string[]>([]);
-
-  tapEffect(() => {
-    const ws = new WebSocket("ws://localhost:8080");
-
-    ws.onmessage = (event) => {
-      setMessages((prev) => [...prev, event.data]);
-    };
-
-    // Cleanup happens automatically when resource unmounts
-    return () => ws.close();
-  }, []);
-
-  return messages;
-});
-```
-
-### API Wrapper Pattern
-
-A common pattern in assistant-ui is to wrap resource state in a stable API object:
-
-```typescript
-export const tapApi = <TApi extends ApiObject & { getState: () => any }>(
-  api: TApi,
-) => {
-  const ref = tapRef(api);
-
-  tapEffect(() => {
-    ref.current = api;
-  });
-
-  const apiProxy = tapMemo(
-    () =>
-      new Proxy<TApi>({} as TApi, new ReadonlyApiHandler(() => ref.current)),
-    [],
-  );
-
-  return tapMemo(
-    () => ({
-      state: api.getState(),
-      api: apiProxy,
-    }),
-    [api.getState()],
-  );
-};
-```
-
-## Use Cases
-
-tap is used throughout assistant-ui for:
-
-1. **State Management**: Application-wide state without Redux/Zustand
-2. **Event Handling**: Managing event subscriptions and cleanup
-3. **Resource Lifecycle**: Auto-cleanup of WebSockets, timers, subscriptions
-4. **Composition**: Nested resource management (threads, messages, tools)
-5. **Context Injection**: Passing values through resource boundaries without prop drilling
-6. **API Wrapping**: Creating reactive API objects with `getState()` and `subscribe()`
-
-### Example: Tools Management
-
-```typescript
-export const Tools = resource(({ toolkit }: { toolkit?: Toolkit }) => {
-  const [state, setState] = tapState<ToolsState>(() => ({
-    tools: {},
-  }));
-
-  const modelContext = tapModelContext();
-
-  tapEffect(() => {
-    if (!toolkit) return;
-
-    // Register tools and setup subscriptions
-    const unsubscribes: (() => void)[] = [];
-    // ... registration logic
-
-    return () => unsubscribes.forEach((fn) => fn());
-  }, [toolkit, modelContext]);
-
-  return tapApi<ToolsApi>({
-    getState: () => state,
-    setToolUI,
-  });
-});
-```
-
-## Why tap?
-
-- **Reuse React knowledge**: Developers already familiar with hooks can immediately work with tap
-- **Framework flexibility**: Core logic can work outside React components
-- **Automatic cleanup**: No memory leaks from forgotten unsubscribes
-- **Composability**: Resources can nest and combine naturally
-- **Type safety**: Full TypeScript inference for state and APIs
-- **Zero dependencies**: Lightweight and portable
+## Hooks
 
-## Comparison with React Hooks
+`tapState`, `tapEffect`, `tapMemo`, `tapCallback`, `tapRef` mirror their React counterparts. Additional primitives include `tapResource` and `tapResources` for composition, plus `createResourceContext` / `tap` / `withContextProvider` for context.
 
-| React Hook    | Reactive Resource | Behavior  |
-| ------------- | ----------------- | --------- |
-| `useState`    | `tapState`        | Identical |
-| `useEffect`   | `tapEffect`       | Identical |
-| `useMemo`     | `tapMemo`         | Identical |
-| `useCallback` | `tapCallback`     | Identical |
-| `useRef`      | `tapRef`          | Identical |
+Full API reference at [assistant-ui.com/tap/docs](https://www.assistant-ui.com/tap/docs).
 
 ## License
 

package/dist/core/ResourceFiber.d.ts

@@ -1,6 +1,10 @@
-import type { ResourceFiber, RenderResult, Resource, ResourceFiberRoot } from "./types.js";
-export declare function createResourceFiber<R, P>(type: Resource<R, P>, root: ResourceFiberRoot, markDirty?: (() => void) | undefined, strictMode?: "root" | "child" | null): ResourceFiber<R, P>;
-export declare function unmountResourceFiber<R, P>(fiber: ResourceFiber<R, P>): void;
-export declare function renderResourceFiber<R, P>(fiber: ResourceFiber<R, P>, props: P): RenderResult;
-export declare function commitResourceFiber<R, P>(fiber: ResourceFiber<R, P>, result: RenderResult): void;
+import { RenderResult, Resource, ResourceFiber, ResourceFiberRoot } from "./types.js";
+
+//#region src/core/ResourceFiber.d.ts
+declare function createResourceFiber<R, P>(type: Resource<R, P>, root: ResourceFiberRoot, markDirty?: (() => void) | undefined, strictMode?: "root" | "child" | null): ResourceFiber<R, P>;
+declare function unmountResourceFiber<R, P>(fiber: ResourceFiber<R, P>): void;
+declare function renderResourceFiber<R, P>(fiber: ResourceFiber<R, P>, props: P): RenderResult;
+declare function commitResourceFiber<R, P>(fiber: ResourceFiber<R, P>, result: RenderResult): void;
+//#endregion
+export { commitResourceFiber, createResourceFiber, renderResourceFiber, unmountResourceFiber };
 //# sourceMappingURL=ResourceFiber.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ResourceFiber.d.ts","sourceRoot":"","sources":["../../src/core/ResourceFiber.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,iBAAiB,EAClB,mBAAgB;AASjB,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,CAAC,EACtC,IAAI,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,EACpB,IAAI,EAAE,iBAAiB,EACvB,SAAS,GAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAqB,EAC/C,UAAU,GAAE,MAAM,GAAG,OAAO,GAAG,IAA8B,GAC5D,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAarB;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAM3E;AAED,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,CAAC,EACtC,KAAK,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,EAC1B,KAAK,EAAE,CAAC,GACP,YAAY,CAiBd;AAED,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,CAAC,EACtC,KAAK,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,EAC1B,MAAM,EAAE,YAAY,GACnB,IAAI,CAYN"}
+{"version":3,"file":"ResourceFiber.d.ts","names":[],"sources":["../../src/core/ResourceFiber.ts"],"mappings":";;;iBAcgB,mBAAA,MAAA,CACd,IAAA,EAAM,QAAA,CAAS,CAAA,EAAG,CAAA,GAClB,IAAA,EAAM,iBAAA,EACN,SAAA,6BACA,UAAA,6BACC,aAAA,CAAc,CAAA,EAAG,CAAA;AAAA,iBAeJ,oBAAA,MAAA,CAA2B,KAAA,EAAO,aAAA,CAAc,CAAA,EAAG,CAAA;AAAA,iBAQnD,mBAAA,MAAA,CACd,KAAA,EAAO,aAAA,CAAc,CAAA,EAAG,CAAA,GACxB,KAAA,EAAO,CAAA,GACN,YAAA;AAAA,iBAmBa,mBAAA,MAAA,CACd,KAAA,EAAO,aAAA,CAAc,CAAA,EAAG,CAAA,GACxB,MAAA,EAAQ,YAAA"}

package/dist/core/ResourceFiber.js

@@ -1,52 +1,54 @@
-import { commitAllEffects, cleanupAllEffects } from "./helpers/commit.js";
-import { getDevStrictMode, withResourceFiber, } from "./helpers/execution-context.js";
 import { callResourceFn } from "./helpers/callResourceFn.js";
 import { isDevelopment } from "./helpers/env.js";
-export function createResourceFiber(type, root, markDirty = undefined, strictMode = getDevStrictMode(false)) {
-    return {
-        type,
-        root,
-        markDirty,
-        devStrictMode: strictMode,
-        cells: [],
-        currentIndex: 0,
-        renderContext: undefined,
-        isFirstRender: true,
-        isMounted: false,
-        isNeverMounted: true,
-    };
+import { getDevStrictMode, withResourceFiber } from "./helpers/execution-context.js";
+import { cleanupAllEffects, commitAllEffects } from "./helpers/commit.js";
+//#region src/core/ResourceFiber.ts
+function createResourceFiber(type, root, markDirty = void 0, strictMode = getDevStrictMode(false)) {
+	return {
+		type,
+		root,
+		markDirty,
+		devStrictMode: strictMode,
+		cells: [],
+		currentIndex: 0,
+		renderContext: void 0,
+		isFirstRender: true,
+		isMounted: false,
+		isNeverMounted: true
+	};
 }
-export function unmountResourceFiber(fiber) {
-    if (!fiber.isMounted)
-        throw new Error("Tried to unmount a fiber that is already unmounted");
-    fiber.isMounted = false;
-    cleanupAllEffects(fiber);
+function unmountResourceFiber(fiber) {
+	if (!fiber.isMounted) throw new Error("Tried to unmount a fiber that is already unmounted");
+	fiber.isMounted = false;
+	cleanupAllEffects(fiber);
 }
-export function renderResourceFiber(fiber, props) {
-    const result = {
-        effectTasks: [],
-        props,
-        output: undefined,
-    };
-    withResourceFiber(fiber, () => {
-        fiber.renderContext = result;
-        try {
-            result.output = callResourceFn(fiber.type, props);
-        }
-        finally {
-            fiber.renderContext = undefined;
-        }
-    });
-    return result;
+function renderResourceFiber(fiber, props) {
+	const result = {
+		effectTasks: [],
+		props,
+		output: void 0
+	};
+	withResourceFiber(fiber, () => {
+		fiber.renderContext = result;
+		try {
+			result.output = callResourceFn(fiber.type, props);
+		} finally {
+			fiber.renderContext = void 0;
+		}
+	});
+	return result;
 }
-export function commitResourceFiber(fiber, result) {
-    fiber.isMounted = true;
-    if (isDevelopment && fiber.isNeverMounted && fiber.devStrictMode === "root") {
-        fiber.isNeverMounted = false;
-        commitAllEffects(result);
-        cleanupAllEffects(fiber);
-    }
-    fiber.isNeverMounted = false;
-    commitAllEffects(result);
+function commitResourceFiber(fiber, result) {
+	fiber.isMounted = true;
+	if (isDevelopment && fiber.isNeverMounted && fiber.devStrictMode === "root") {
+		fiber.isNeverMounted = false;
+		commitAllEffects(result);
+		cleanupAllEffects(fiber);
+	}
+	fiber.isNeverMounted = false;
+	commitAllEffects(result);
 }
+//#endregion
+export { commitResourceFiber, createResourceFiber, renderResourceFiber, unmountResourceFiber };
+
 //# sourceMappingURL=ResourceFiber.js.map

package/dist/core/ResourceFiber.js.map

@@ -1 +1 @@
-{"version":3,"file":"ResourceFiber.js","sourceRoot":"","sources":["../../src/core/ResourceFiber.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,4BAAyB;AACvE,OAAO,EACL,gBAAgB,EAChB,iBAAiB,GAClB,uCAAoC;AACrC,OAAO,EAAE,cAAc,EAAE,oCAAiC;AAC1D,OAAO,EAAE,aAAa,EAAE,yBAAsB;AAE9C,MAAM,UAAU,mBAAmB,CACjC,IAAoB,EACpB,IAAuB,EACvB,YAAsC,SAAS,EAC/C,aAAsC,gBAAgB,CAAC,KAAK,CAAC;IAE7D,OAAO;QACL,IAAI;QACJ,IAAI;QACJ,SAAS;QACT,aAAa,EAAE,UAAU;QACzB,KAAK,EAAE,EAAE;QACT,YAAY,EAAE,CAAC;QACf,aAAa,EAAE,SAAS;QACxB,aAAa,EAAE,IAAI;QACnB,SAAS,EAAE,KAAK;QAChB,cAAc,EAAE,IAAI;KACrB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAO,KAA0B;IACnE,IAAI,CAAC,KAAK,CAAC,SAAS;QAClB,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IAExE,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC;IACxB,iBAAiB,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,KAA0B,EAC1B,KAAQ;IAER,MAAM,MAAM,GAAG;QACb,WAAW,EAAE,EAAE;QACf,KAAK;QACL,MAAM,EAAE,SAA0B;KACnC,CAAC;IAEF,iBAAiB,CAAC,KAAK,EAAE,GAAG,EAAE;QAC5B,KAAK,CAAC,aAAa,GAAG,MAAM,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,CAAC,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACpD,CAAC;gBAAS,CAAC;YACT,KAAK,CAAC,aAAa,GAAG,SAAS,CAAC;QAClC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,KAA0B,EAC1B,MAAoB;IAEpB,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC;IAEvB,IAAI,aAAa,IAAI,KAAK,CAAC,cAAc,IAAI,KAAK,CAAC,aAAa,KAAK,MAAM,EAAE,CAAC;QAC5E,KAAK,CAAC,cAAc,GAAG,KAAK,CAAC;QAE7B,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACzB,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,cAAc,GAAG,KAAK,CAAC;IAC7B,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAC3B,CAAC"}
+{"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"}

package/dist/core/context.d.ts

@@ -1,9 +1,11 @@
+//#region src/core/context.d.ts
 declare const contextValue: unique symbol;
 type Context<T> = {
-    [contextValue]: T;
+  [contextValue]: T;
 };
-export declare const createResourceContext: <T>(defaultValue: T) => Context<T>;
-export declare const withContextProvider: <T, TResult>(context: Context<T>, value: T, fn: () => TResult) => TResult;
-export declare const tap: <T>(context: Context<T>) => T;
-export {};
+declare const createResourceContext: <T>(defaultValue: T) => Context<T>;
+declare const withContextProvider: <T, TResult>(context: Context<T>, value: T, fn: () => TResult) => TResult;
+declare const tap: <T>(context: Context<T>) => T;
+//#endregion
+export { createResourceContext, tap, withContextProvider };
 //# sourceMappingURL=context.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/core/context.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,YAAY,EAAE,OAAO,MAA8B,CAAC;AAC1D,KAAK,OAAO,CAAC,CAAC,IAAI;IAChB,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;CACnB,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,CAAC,EAAE,cAAc,CAAC,KAAG,OAAO,CAAC,CAAC,CAInE,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,CAAC,EAAE,OAAO,EAC5C,SAAS,OAAO,CAAC,CAAC,CAAC,EACnB,OAAO,CAAC,EACR,IAAI,MAAM,OAAO,YASlB,CAAC;AAEF,eAAO,MAAM,GAAG,GAAI,CAAC,EAAE,SAAS,OAAO,CAAC,CAAC,CAAC,MAEzC,CAAC"}
+{"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"}

package/dist/core/context.js

@@ -1,20 +1,21 @@
+//#region src/core/context.ts
 const contextValue = Symbol("tap.Context");
-export const createResourceContext = (defaultValue) => {
-    return {
-        [contextValue]: defaultValue,
-    };
+const createResourceContext = (defaultValue) => {
+	return { [contextValue]: defaultValue };
 };
-export const withContextProvider = (context, value, fn) => {
-    const previousValue = context[contextValue];
-    context[contextValue] = value;
-    try {
-        return fn();
-    }
-    finally {
-        context[contextValue] = previousValue;
-    }
+const withContextProvider = (context, value, fn) => {
+	const previousValue = context[contextValue];
+	context[contextValue] = value;
+	try {
+		return fn();
+	} finally {
+		context[contextValue] = previousValue;
+	}
 };
-export const tap = (context) => {
-    return context[contextValue];
+const tap = (context) => {
+	return context[contextValue];
 };
+//#endregion
+export { createResourceContext, tap, withContextProvider };
+
 //# sourceMappingURL=context.js.map

package/dist/core/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/core/context.ts"],"names":[],"mappings":"AAAA,MAAM,YAAY,GAAkB,MAAM,CAAC,aAAa,CAAC,CAAC;AAK1D,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAI,YAAe,EAAc,EAAE;IACtE,OAAO;QACL,CAAC,YAAY,CAAC,EAAE,YAAY;KAC7B,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,OAAmB,EACnB,KAAQ,EACR,EAAiB,EACjB,EAAE;IACF,MAAM,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC5C,OAAO,CAAC,YAAY,CAAC,GAAG,KAAK,CAAC;IAC9B,IAAI,CAAC;QACH,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,YAAY,CAAC,GAAG,aAAa,CAAC;IACxC,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,GAAG,GAAG,CAAI,OAAmB,EAAE,EAAE;IAC5C,OAAO,OAAO,CAAC,YAAY,CAAC,CAAC;AAC/B,CAAC,CAAC"}
+{"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"}

package/dist/core/createResourceRoot.d.ts

@@ -1,6 +1,10 @@
-import type { ResourceElement } from "./types.js";
-export declare const createResourceRoot: () => {
-    render: <R, P>(element: ResourceElement<R, P>) => any;
-    unmount: () => void;
+import { ResourceElement } from "./types.js";
+
+//#region src/core/createResourceRoot.d.ts
+declare const createResourceRoot: () => {
+  render: <R, P>(element: ResourceElement<R, P>) => any;
+  unmount: () => void;
 };
+//#endregion
+export { createResourceRoot };
 //# sourceMappingURL=createResourceRoot.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"createResourceRoot.d.ts","sourceRoot":"","sources":["../../src/core/createResourceRoot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAgB;AAe/C,eAAO,MAAM,kBAAkB;aAqBlB,CAAC,EAAE,CAAC,WAAW,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC;;CAgBhD,CAAC"}
+{"version":3,"file":"createResourceRoot.d.ts","names":[],"sources":["../../src/core/createResourceRoot.ts"],"mappings":";;;cAea,kBAAA;iBAqBI,OAAA,EAAW,eAAA,CAAgB,CAAA,EAAG,CAAA"}