@assistant-ui/store 0.1.6 → 0.2.0

package/src/index.ts

@@ -1,37 +1,30 @@
-// hooks
-export { useAui } from "./useAui";
-export { useAuiState } from "./useAuiState";
-export { useAuiEvent } from "./useAuiEvent";
-
-// components
-export { AuiIf } from "./AuiIf";
-export { AuiProvider } from "./utils/react-assistant-context";
+// Backwards-compatible ScopeRegistry augmentation target + forwarding to core
+export type { ScopeRegistry } from "./scope-registry";
+import "./scope-registry-forward";
 
-// resources
-export { Derived } from "./Derived";
-export { attachDefaultPeers } from "./attachDefaultPeers";
-
-// tap hooks
+// Re-export framework-agnostic infrastructure from core
 export {
+  Derived,
+  attachTransformScopes,
+  type ScopesConfig,
   tapAssistantClientRef,
   tapAssistantEmit,
-} from "./utils/tap-assistant-context";
-export { tapClientResource } from "./tapClientResource";
-export { tapClientLookup } from "./tapClientLookup";
-export { tapClientList } from "./tapClientList";
+  tapClientResource,
+  tapClientLookup,
+  tapClientList,
+  type ClientOutput,
+  type AssistantClient,
+  type AssistantState,
+  type AssistantEventName,
+  type AssistantEventCallback,
+  type AssistantEventPayload,
+  type AssistantEventSelector,
+  type AssistantEventScope,
+} from "@assistant-ui/core/store";
 
-// types
-export type {
-  ClientRegistry,
-  ClientOutput,
-  AssistantClient,
-  AssistantState,
-} from "./types/client";
-export type {
-  AssistantEventName,
-  AssistantEventCallback,
-  AssistantEventPayload,
-  AssistantEventSelector,
-  AssistantEventScope,
-} from "./types/events";
-export type { DefaultPeers } from "./attachDefaultPeers";
+// React-specific (stay in store)
+export { useAui } from "./useAui";
+export { useAuiState } from "./useAuiState";
+export { useAuiEvent } from "./useAuiEvent";
+export { AuiIf } from "./AuiIf";
+export { AuiProvider } from "./utils/react-assistant-context";

package/src/scope-registry-forward.ts

@@ -0,0 +1,6 @@
+import type { ScopeRegistry as StoreScopeRegistry } from "./scope-registry";
+
+// Forward user augmentations on @assistant-ui/store to @assistant-ui/core/store
+declare module "@assistant-ui/core/store" {
+  interface ScopeRegistry extends StoreScopeRegistry {}
+}

package/src/scope-registry.ts

@@ -0,0 +1,15 @@
+/**
+ * Module augmentation interface for assistant-ui store type extensions.
+ *
+ * Users augment this interface to register custom scopes:
+ * ```typescript
+ * declare module "@assistant-ui/store" {
+ *   interface ScopeRegistry {
+ *     myScope: { methods: { getState: () => MyState } };
+ *   }
+ * }
+ * ```
+ *
+ * Augmentations are automatically forwarded to `@assistant-ui/core/store`.
+ */
+export interface ScopeRegistry {}

package/src/{useAui.tsx → useAui.ts}

@@ -6,12 +6,11 @@ import {
   tapMemo,
   tapResources,
   tapEffectEvent,
-  tapInlineResource,
   tapEffect,
   tapRef,
   tapResource,
   withKey,
-  tapSubscribableResource,
+  tapResourceRoot,
 } from "@assistant-ui/tap";
 import type {
   AssistantClient,
@@ -19,34 +18,34 @@ import type {
   ClientNames,
   ClientElement,
   ClientMeta,
-} from "./types/client";
-import { Derived, DerivedElement } from "./Derived";
-import {
-  useAssistantContextValue,
-  DefaultAssistantClient,
-  createRootAssistantClient,
-} from "./utils/react-assistant-context";
-import {
-  DerivedClients,
-  RootClients,
-  tapSplitClients,
-} from "./utils/splitClients";
+} from "@assistant-ui/core/store";
 import {
+  Derived,
+  type DerivedElement,
+  type ScopesConfig,
   normalizeEventSelector,
   type AssistantEventName,
   type AssistantEventCallback,
   type AssistantEventSelector,
-} from "./types/events";
-import { NotificationManager } from "./utils/NotificationManager";
-import { withAssistantTapContextProvider } from "./utils/tap-assistant-context";
-import { tapClientResource } from "./tapClientResource";
-import { getClientIndex } from "./utils/tap-client-stack-context";
+  tapClientResource,
+} from "@assistant-ui/core/store";
 import {
+  NotificationManager,
+  withAssistantTapContextProvider,
+  getClientIndex,
   PROXIED_ASSISTANT_STATE_SYMBOL,
   createProxiedAssistantState,
-} from "./utils/proxied-assistant-state";
+  type RootClients,
+  type DerivedClients,
+  tapSplitClients,
+} from "@assistant-ui/core/store/internal";
+import {
+  useAssistantContextValue,
+  DefaultAssistantClient,
+  createRootAssistantClient,
+} from "./utils/react-assistant-context";
 
-const tapShallowMemoArray = <T,>(array: readonly T[]) => {
+const tapShallowMemoArray = <T>(array: readonly T[]) => {
   // biome-ignore lint/correctness/useExhaustiveDependencies: shallow memo
   return tapMemo(() => array, array);
 };
@@ -81,7 +80,7 @@ const RootClientAccessorResource = resource(
     clientRef: { parent: AssistantClient; current: AssistantClient | null };
     name: K;
   }): AssistantClientAccessor<K> => {
-    const store = tapSubscribableResource(
+    const store = tapResourceRoot(
       RootClientResource({ element, emit: notifications.emit, clientRef }),
     );
 
@@ -129,7 +128,7 @@ const RootClientsAccessorsResource = resource(
     clients: RootClients;
     clientRef: { parent: AssistantClient; current: AssistantClient | null };
   }) => {
-    const notifications = tapInlineResource(NotificationManager());
+    const notifications = tapResource(NotificationManager());
 
     tapEffect(
       () => clientRef.parent.subscribe(notifications.notifySubscribers),
@@ -318,7 +317,7 @@ export const AssistantClientResource = resource(
         : NoOpRootClientsAccessorsResource(),
     );
 
-    const derivedFields = tapInlineResource(
+    const derivedFields = tapResource(
       DerivedClientsAccessorsResource({ clients: derivedClients, clientRef }),
     );
 
@@ -355,9 +354,7 @@ export const AssistantClientResource = resource(
 );
 
 export namespace useAui {
-  export type Props = {
-    [K in ClientNames]?: ClientElement<K> | DerivedElement<K>;
-  };
+  export type Props = ScopesConfig;
 }
 
 export function useAui(): AssistantClient;

package/src/useAuiEvent.ts

@@ -5,8 +5,8 @@ import type {
   AssistantEventName,
   AssistantEventCallback,
   AssistantEventSelector,
-} from "./types/events";
-import { normalizeEventSelector } from "./types/events";
+} from "@assistant-ui/core/store";
+import { normalizeEventSelector } from "@assistant-ui/core/store";
 
 export const useAuiEvent = <TEvent extends AssistantEventName>(
   selector: AssistantEventSelector<TEvent>,

package/src/{useAuiState.tsx → useAuiState.ts}

@@ -1,7 +1,7 @@
 import { useSyncExternalStore, useDebugValue } from "react";
-import type { AssistantState } from "./types/client";
+import type { AssistantState } from "@assistant-ui/core/store";
+import { getProxiedAssistantState } from "@assistant-ui/core/store/internal";
 import { useAui } from "./useAui";
-import { getProxiedAssistantState } from "./utils/proxied-assistant-state";
 
 /**
  * Hook to access a slice of the assistant state with automatic subscription
@@ -18,7 +18,7 @@ import { getProxiedAssistantState } from "./utils/proxied-assistant-state";
  * const bar = useAuiState((state) => state.foo.bar);
  * ```
  */
-export const useAuiState = <T,>(selector: (state: AssistantState) => T): T => {
+export const useAuiState = <T>(selector: (state: AssistantState) => T): T => {
   const aui = useAui();
   const proxiedState = getProxiedAssistantState(aui);
 

package/src/utils/react-assistant-context.tsx

@@ -1,10 +1,14 @@
 import React, { createContext, useContext } from "react";
-import type { AssistantClient, AssistantClientAccessor } from "../types/client";
+import type {
+  AssistantClient,
+  AssistantClientAccessor,
+} from "@assistant-ui/core/store";
 import {
   createProxiedAssistantState,
   PROXIED_ASSISTANT_STATE_SYMBOL,
-} from "./proxied-assistant-state";
-import { BaseProxyHandler, handleIntrospectionProp } from "./BaseProxyHandler";
+  BaseProxyHandler,
+  handleIntrospectionProp,
+} from "@assistant-ui/core/store/internal";
 
 const NO_OP_SUBSCRIBE = () => () => {};
 

package/dist/Derived.d.ts

@@ -1,34 +0,0 @@
-import { ResourceElement } from "@assistant-ui/tap";
-import type { AssistantClient, ClientNames, AssistantClientAccessor, ClientMeta } from "./types/client.js";
-/**
- * Creates a derived client field that references a client from a parent scope.
- * The get callback always calls the most recent version (useEffectEvent pattern).
- *
- * IMPORTANT: The `get` callback must return a client that was created via
- * `tapClientResource` (or `tapClientLookup`/`tapClientList` which use it internally).
- * This is required for event scoping to work correctly.
- *
- * @example
- * ```typescript
- * const aui = useAui({
- *   message: Derived({
- *     source: "thread",
- *     query: { index: 0 },
- *     get: (aui) => aui.thread().message({ index: 0 }),
- *   }),
- * });
- * ```
- */
-export declare const Derived: <K extends ClientNames>(props: Derived.Props<K>) => ResourceElement<null, Derived.Props<K>>;
-export type DerivedElement<K extends ClientNames> = ResourceElement<null, Derived.Props<K>>;
-export declare namespace Derived {
-    /**
-     * Props passed to a derived client resource element.
-     */
-    type Props<K extends ClientNames> = {
-        get: (client: AssistantClient) => ReturnType<AssistantClientAccessor<K>>;
-    } & (ClientMeta<K> | {
-        getMeta: (client: AssistantClient) => ClientMeta<K>;
-    });
-}
-//# sourceMappingURL=Derived.d.ts.map

package/dist/Derived.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Derived.d.ts","sourceRoot":"","sources":["../src/Derived.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACX,uBAAuB,EACvB,UAAU,EACX,0BAAuB;AAExB;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,OAAO,GACjB,CAAC,SAAS,WAAW,qEAGvB,CAAC;AAEF,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,WAAW,IAAI,eAAe,CACjE,IAAI,EACJ,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CACjB,CAAC;AAEF,yBAAiB,OAAO,CAAC;IACvB;;OAEG;IACH,KAAY,KAAK,CAAC,CAAC,SAAS,WAAW,IAAI;QACzC,GAAG,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,UAAU,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,CAAC;KAC1E,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,UAAU,CAAC,CAAC,CAAC,CAAA;KAAE,CAAC,CAAC;CAC/E"}

package/dist/Derived.js

@@ -1,24 +0,0 @@
-import { resource } from "@assistant-ui/tap";
-/**
- * Creates a derived client field that references a client from a parent scope.
- * The get callback always calls the most recent version (useEffectEvent pattern).
- *
- * IMPORTANT: The `get` callback must return a client that was created via
- * `tapClientResource` (or `tapClientLookup`/`tapClientList` which use it internally).
- * This is required for event scoping to work correctly.
- *
- * @example
- * ```typescript
- * const aui = useAui({
- *   message: Derived({
- *     source: "thread",
- *     query: { index: 0 },
- *     get: (aui) => aui.thread().message({ index: 0 }),
- *   }),
- * });
- * ```
- */
-export const Derived = resource((_config) => {
-    return null;
-});
-//# sourceMappingURL=Derived.js.map

package/dist/Derived.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Derived.js","sourceRoot":"","sources":["../src/Derived.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAmB,MAAM,mBAAmB,CAAC;AAQ9D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAC7B,CAAwB,OAAyB,EAAQ,EAAE;IACzD,OAAO,IAAI,CAAC;AACd,CAAC,CACF,CAAC"}

package/dist/attachDefaultPeers.d.ts

@@ -1,56 +0,0 @@
-import type { ResourceElement } from "@assistant-ui/tap";
-import type { ClientElement, ClientNames } from "./types/client.js";
-import type { DerivedElement } from "./Derived.js";
-/**
- * Symbol used to store default peer clients on a resource.
- */
-declare const DEFAULT_PEERS: unique symbol;
-/**
- * Type for resources that have default peers attached.
- */
-export type ResourceWithDefaultPeers = {
-    [DEFAULT_PEERS]?: DefaultPeers;
-};
-/**
- * Default peers configuration - can be either root clients or derived clients.
- */
-export type DefaultPeers = {
-    [K in ClientNames]?: ClientElement<K> | DerivedElement<K>;
-};
-/**
- * Attaches default peer clients to a resource.
- *
- * Default peers are only applied if the scope doesn't exist:
- * - Not defined in parent context
- * - Not provided by user
- * - Not already defined by a previous resource's default peers
- *
- * First definition wins - no overriding is permitted.
- *
- * @param resource - The resource to attach default peers to
- * @param peers - The default peer clients to attach
- * @throws Error if a peer key already exists in the resource's default peers
- *
- * @example
- * ```typescript
- * const ThreadListClient = resource(({ ... }) => { ... });
- *
- * attachDefaultPeers(ThreadListClient, {
- *   // Derived default peers
- *   thread: Derived({ source: "threads", query: { type: "main" }, get: ... }),
- *   threadListItem: Derived({ ... }),
- *   composer: Derived({ getMeta: ..., get: ... }),
- *
- *   // Root default peers
- *   tools: Tools({}),
- *   modelContext: ModelContext({}),
- * });
- * ```
- */
-export declare function attachDefaultPeers<T extends (...args: any[]) => ResourceElement<any>>(resource: T, peers: DefaultPeers): void;
-/**
- * Gets the default peers attached to a resource, if any.
- */
-export declare function getDefaultPeers<T extends (...args: any[]) => ResourceElement<any>>(resource: T): DefaultPeers | undefined;
-export {};
-//# sourceMappingURL=attachDefaultPeers.d.ts.map

package/dist/attachDefaultPeers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"attachDefaultPeers.d.ts","sourceRoot":"","sources":["../src/attachDefaultPeers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,0BAAuB;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAkB;AAEhD;;GAEG;AACH,QAAA,MAAM,aAAa,eAAuC,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,CAAC,aAAa,CAAC,CAAC,EAAE,YAAY,CAAC;CAChC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;KACxB,CAAC,IAAI,WAAW,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC;CAC1D,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,kBAAkB,CAChC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,eAAe,CAAC,GAAG,CAAC,EAClD,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAaxC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,eAAe,CAAC,GAAG,CAAC,EAClD,QAAQ,EAAE,CAAC,GAAG,YAAY,GAAG,SAAS,CAEvC"}

package/dist/attachDefaultPeers.js

@@ -1,51 +0,0 @@
-/**
- * Symbol used to store default peer clients on a resource.
- */
-const DEFAULT_PEERS = Symbol("assistant-ui.default-peers");
-/**
- * Attaches default peer clients to a resource.
- *
- * Default peers are only applied if the scope doesn't exist:
- * - Not defined in parent context
- * - Not provided by user
- * - Not already defined by a previous resource's default peers
- *
- * First definition wins - no overriding is permitted.
- *
- * @param resource - The resource to attach default peers to
- * @param peers - The default peer clients to attach
- * @throws Error if a peer key already exists in the resource's default peers
- *
- * @example
- * ```typescript
- * const ThreadListClient = resource(({ ... }) => { ... });
- *
- * attachDefaultPeers(ThreadListClient, {
- *   // Derived default peers
- *   thread: Derived({ source: "threads", query: { type: "main" }, get: ... }),
- *   threadListItem: Derived({ ... }),
- *   composer: Derived({ getMeta: ..., get: ... }),
- *
- *   // Root default peers
- *   tools: Tools({}),
- *   modelContext: ModelContext({}),
- * });
- * ```
- */
-export function attachDefaultPeers(resource, peers) {
-    const resourceWithPeers = resource;
-    const existing = resourceWithPeers[DEFAULT_PEERS] ?? {};
-    for (const key of Object.keys(peers)) {
-        if (key in existing) {
-            throw new Error(`Default peer "${key}" is already attached to this resource`);
-        }
-    }
-    resourceWithPeers[DEFAULT_PEERS] = { ...existing, ...peers };
-}
-/**
- * Gets the default peers attached to a resource, if any.
- */
-export function getDefaultPeers(resource) {
-    return resource[DEFAULT_PEERS];
-}
-//# sourceMappingURL=attachDefaultPeers.js.map

package/dist/attachDefaultPeers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"attachDefaultPeers.js","sourceRoot":"","sources":["../src/attachDefaultPeers.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,aAAa,GAAG,MAAM,CAAC,4BAA4B,CAAC,CAAC;AAgB3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,kBAAkB,CAEhC,QAAW,EAAE,KAAmB;IAChC,MAAM,iBAAiB,GAAG,QAAwC,CAAC;IACnE,MAAM,QAAQ,GAAG,iBAAiB,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;IAExD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CACb,iBAAiB,GAAG,wCAAwC,CAC7D,CAAC;QACJ,CAAC;IACH,CAAC;IAED,iBAAiB,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,KAAK,EAAE,CAAC;AAC/D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAE7B,QAAW;IACX,OAAQ,QAAyC,CAAC,aAAa,CAAC,CAAC;AACnE,CAAC"}

package/dist/tapClientList.d.ts

@@ -1,24 +0,0 @@
-import type { ContravariantResource } from "@assistant-ui/tap";
-import type { ClientMethods, ClientOutputOf } from "./types/client.js";
-export declare const tapClientList: <TData, TState, TMethods extends ClientMethods>(props: tapClientList.Props<TData, TState, TMethods>) => {
-    state: TState[];
-    get: (lookup: {
-        index: number;
-    } | {
-        key: string;
-    }) => TMethods;
-    add: (initialData: TData) => void;
-};
-export declare namespace tapClientList {
-    type ResourceProps<TData> = {
-        key: string;
-        getInitialData: () => TData;
-        remove: () => void;
-    };
-    type Props<TData, TState, TMethods extends ClientMethods> = {
-        initialValues: TData[];
-        getKey: (data: TData) => string;
-        resource: ContravariantResource<ClientOutputOf<TState, TMethods>, ResourceProps<TData>>;
-    };
-}
-//# sourceMappingURL=tapClientList.d.ts.map

package/dist/tapClientList.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tapClientList.d.ts","sourceRoot":"","sources":["../src/tapClientList.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE/D,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,0BAAuB;AAuBpE,eAAO,MAAM,aAAa,GAAI,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAS,aAAa,EACzE,OAAO,aAAa,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,KAClD;IACD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,EAAE,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,KAAK,QAAQ,CAAC;IAC/D,GAAG,EAAE,CAAC,WAAW,EAAE,KAAK,KAAK,IAAI,CAAC;CAqEnC,CAAC;AAEF,yBAAiB,aAAa,CAAC;IAC7B,KAAY,aAAa,CAAC,KAAK,IAAI;QACjC,GAAG,EAAE,MAAM,CAAC;QACZ,cAAc,EAAE,MAAM,KAAK,CAAC;QAC5B,MAAM,EAAE,MAAM,IAAI,CAAC;KACpB,CAAC;IAEF,KAAY,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAS,aAAa,IAAI;QACjE,aAAa,EAAE,KAAK,EAAE,CAAC;QACvB,MAAM,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,MAAM,CAAC;QAChC,QAAQ,EAAE,qBAAqB,CAC7B,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,EAChC,aAAa,CAAC,KAAK,CAAC,CACrB,CAAC;KACH,CAAC;CACH"}

package/dist/tapClientList.js

@@ -1,68 +0,0 @@
-import { tapConst, tapState, withKey } from "@assistant-ui/tap";
-import { tapClientLookup } from "./tapClientLookup.js";
-const createProps = (key, data, remove) => {
-    return {
-        key,
-        getInitialData: () => {
-            if (!data.hasData) {
-                throw new Error("getInitialData may only be called during initial render");
-            }
-            return data.data;
-        },
-        remove,
-    };
-};
-export const tapClientList = (props) => {
-    const { initialValues, getKey, resource: Resource } = props;
-    const initialDataHandles = tapConst(() => [], []);
-    const [items, setItems] = tapState(() => {
-        const entries = [];
-        for (const data of initialValues) {
-            const key = getKey(data);
-            const handle = { data, hasData: true };
-            entries.push([
-                key,
-                createProps(key, handle, () => {
-                    setItems((items) => {
-                        const newItems = { ...items };
-                        delete newItems[key];
-                        return newItems;
-                    });
-                }),
-            ]);
-            initialDataHandles.push(handle);
-        }
-        return Object.fromEntries(entries);
-    });
-    const lookup = tapClientLookup(() => Object.values(items).map((props) => withKey(props.key, Resource(props))), [items, Resource]);
-    initialDataHandles.forEach((handle) => {
-        handle.data = undefined;
-        handle.hasData = false;
-    });
-    const add = (data) => {
-        const key = getKey(data);
-        setItems((items) => {
-            if (key in items) {
-                throw new Error(`Tried to add item with a key ${key} that already exists`);
-            }
-            const handle = { data, hasData: true };
-            initialDataHandles.push(handle);
-            return {
-                ...items,
-                [key]: createProps(key, handle, () => {
-                    setItems((items) => {
-                        const newItems = { ...items };
-                        delete newItems[key];
-                        return newItems;
-                    });
-                }),
-            };
-        });
-    };
-    return {
-        state: lookup.state,
-        get: lookup.get,
-        add,
-    };
-};
-//# sourceMappingURL=tapClientList.js.map

package/dist/tapClientList.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"tapClientList.js","sourceRoot":"","sources":["../src/tapClientList.ts"],"names":[],"mappings":"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"}

package/dist/tapClientLookup.d.ts

@@ -1,11 +0,0 @@
-import { type ResourceElement } from "@assistant-ui/tap";
-import type { ClientMethods, ClientOutputOf } from "./types/client.js";
-export declare function tapClientLookup<TState, TMethods extends ClientMethods>(getElements: () => readonly ResourceElement<ClientOutputOf<TState, TMethods>>[], getElementsDeps: readonly unknown[]): {
-    state: TState[];
-    get: (lookup: {
-        index: number;
-    } | {
-        key: string;
-    }) => TMethods;
-};
-//# sourceMappingURL=tapClientLookup.d.ts.map

package/dist/tapClientLookup.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tapClientLookup.d.ts","sourceRoot":"","sources":["../src/tapClientLookup.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,0BAAuB;AAkBpE,wBAAgB,eAAe,CAAC,MAAM,EAAE,QAAQ,SAAS,aAAa,EACpE,WAAW,EAAE,MAAM,SAAS,eAAe,CACzC,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,CACjC,EAAE,EACH,eAAe,EAAE,SAAS,OAAO,EAAE,GAClC;IACD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,EAAE,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,KAAK,QAAQ,CAAC;CAChE,CA2CA"}

package/dist/tapClientLookup.js

@@ -1,42 +0,0 @@
-import { tapInlineResource, tapMemo, tapResources, } from "@assistant-ui/tap";
-import { ClientResource } from "./tapClientResource.js";
-import { wrapperResource } from "./wrapperResource.js";
-const ClientResourceWithKey = wrapperResource((el) => {
-    if (el.key === undefined) {
-        throw new Error("tapClientResource: Element has no key");
-    }
-    return tapInlineResource(ClientResource(el));
-});
-export function tapClientLookup(getElements, getElementsDeps) {
-    const resources = tapResources(() => getElements().map((el) => ClientResourceWithKey(el)), 
-    // biome-ignore lint/correctness/useExhaustiveDependencies: getElementsDeps is passed through from caller
-    getElementsDeps);
-    const keys = tapMemo(() => Object.keys(resources), [resources]);
-    // For arrays, track element key -> index mapping
-    const keyToIndex = tapMemo(() => {
-        return resources.reduce((acc, resource, index) => {
-            acc[resource.key] = index;
-            return acc;
-        }, {});
-    }, [resources]);
-    const state = tapMemo(() => {
-        return resources.map((r) => r.state);
-    }, [resources]);
-    return {
-        state,
-        get: (lookup) => {
-            if ("index" in lookup) {
-                if (lookup.index < 0 || lookup.index >= keys.length) {
-                    throw new Error(`tapClientLookup: Index ${lookup.index} out of bounds (length: ${keys.length})`);
-                }
-                return resources[lookup.index].methods;
-            }
-            const index = keyToIndex[lookup.key];
-            if (index === undefined) {
-                throw new Error(`tapClientLookup: Key "${lookup.key}" not found`);
-            }
-            return resources[index].methods;
-        },
-    };
-}
-//# sourceMappingURL=tapClientLookup.js.map

package/dist/tapClientLookup.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"tapClientLookup.js","sourceRoot":"","sources":["../src/tapClientLookup.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,OAAO,EACP,YAAY,GAEb,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,cAAc,EAAE,+BAA4B;AACrD,OAAO,EAAE,eAAe,EAAE,6BAA0B;AAEpD,MAAM,qBAAqB,GAAG,eAAe,CAC3C,CACE,EAAqD,EACrD,EAAE;IACF,IAAI,EAAE,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,iBAAiB,CAAC,cAAc,CAAC,EAAE,CAAC,CAGf,CAAC;AAC/B,CAAC,CACF,CAAC;AAEF,MAAM,UAAU,eAAe,CAC7B,WAEG,EACH,eAAmC;IAKnC,MAAM,SAAS,GAAG,YAAY,CAC5B,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC;IAC1D,yGAAyG;IACzG,eAAe,CAChB,CAAC;IAEF,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAEhE,iDAAiD;IACjD,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE;QAC9B,OAAO,SAAS,CAAC,MAAM,CACrB,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE;YACvB,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YAC1B,OAAO,GAAG,CAAC;QACb,CAAC,EACD,EAA4B,CAC7B,CAAC;IACJ,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAEhB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE;QACzB,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAEhB,OAAO;QACL,KAAK;QACL,GAAG,EAAE,CAAC,MAA2C,EAAE,EAAE;YACnD,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;gBACtB,IAAI,MAAM,CAAC,KAAK,GAAG,CAAC,IAAI,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;oBACpD,MAAM,IAAI,KAAK,CACb,0BAA0B,MAAM,CAAC,KAAK,2BAA2B,IAAI,CAAC,MAAM,GAAG,CAChF,CAAC;gBACJ,CAAC;gBACD,OAAO,SAAS,CAAC,MAAM,CAAC,KAAK,CAAE,CAAC,OAAO,CAAC;YAC1C,CAAC;YAED,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACrC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CAAC,yBAAyB,MAAM,CAAC,GAAG,aAAa,CAAC,CAAC;YACpE,CAAC;YACD,OAAO,SAAS,CAAC,KAAK,CAAE,CAAC,OAAO,CAAC;QACnC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tapClientResource.d.ts

@@ -1,28 +0,0 @@
-import { type ResourceElement } from "@assistant-ui/tap";
-import type { ClientMethods, ClientOutputOf } from "./types/client.js";
-export declare const getClientState: (client: ClientMethods) => unknown;
-/**
- * Resource that wraps a plain resource element to create a stable client proxy.
- *
- * Takes a ResourceElement that returns { state, methods } and
- * wraps it to produce a stable client proxy. This adds the client to the
- * client stack, enabling event scoping.
- *
- * Use this for 1:1 client mappings where you want event scoping to work correctly.
- *
- * @example
- * ```typescript
- * const MessageResource = resource(({ messageId }: { messageId: string }) => {
- *   return tapInlineResource(
- *     tapClientResource(InnerMessageResource({ messageId }))
- *   );
- * });
- * ```
- */
-export declare const ClientResource: <TState, TMethods extends ClientMethods>(props: ResourceElement<ClientOutputOf<TState, TMethods>>) => ResourceElement<ClientOutputOf<TState, TMethods> & {
-    key: string | number | undefined;
-}, ResourceElement<ClientOutputOf<TState, TMethods>>>;
-export declare const tapClientResource: <TState, TMethods extends ClientMethods>(element: ResourceElement<ClientOutputOf<TState, TMethods>>) => ClientOutputOf<TState, TMethods> & {
-    key: string | number | undefined;
-};
-//# sourceMappingURL=tapClientResource.d.ts.map

package/dist/tapClientResource.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tapClientResource.d.ts","sourceRoot":"","sources":["../src/tapClientResource.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,eAAe,EAGrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,0BAAuB;AAsBpE,eAAO,MAAM,cAAc,GAAI,QAAQ,aAAa,YASnD,CAAC;AAuFF;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,cAAc,GACxB,MAAM,EAAE,QAAQ,SAAS,aAAa;SAGhC,MAAM,GAAG,MAAM,GAAG,SAAS;qDA2BnC,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,MAAM,EAAE,QAAQ,SAAS,aAAa,EACtE,SAAS,eAAe,CAAC,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;SA9BnD,MAAM,GAAG,MAAM,GAAG,SAAS;CAiCnC,CAAC"}