@assistant-ui/store 0.0.1 → 0.0.3

package/dist/utils/NotificationManager.js

@@ -0,0 +1,81 @@
+// src/utils/NotificationManager.ts
+import { resource, tapMemo } from "@assistant-ui/tap";
+var NotificationManager = resource(() => {
+  return tapMemo(() => {
+    const listeners = /* @__PURE__ */ new Map();
+    const wildcardListeners = /* @__PURE__ */ new Set();
+    const subscribers = /* @__PURE__ */ new Set();
+    return {
+      on(event, callback) {
+        const cb = callback;
+        if (event === "*") {
+          wildcardListeners.add(cb);
+          return () => wildcardListeners.delete(cb);
+        }
+        let set = listeners.get(event);
+        if (!set) {
+          set = /* @__PURE__ */ new Set();
+          listeners.set(event, set);
+        }
+        set.add(cb);
+        return () => {
+          set.delete(cb);
+          if (set.size === 0) listeners.delete(event);
+        };
+      },
+      emit(event, payload, clientStack) {
+        const eventListeners = listeners.get(event);
+        if (!eventListeners && wildcardListeners.size === 0) return;
+        queueMicrotask(() => {
+          const errors = [];
+          if (eventListeners) {
+            for (const cb of eventListeners) {
+              try {
+                cb(payload, clientStack);
+              } catch (e) {
+                errors.push(e);
+              }
+            }
+          }
+          if (wildcardListeners.size > 0) {
+            const wrapped = { event, payload };
+            for (const cb of wildcardListeners) {
+              try {
+                cb(wrapped, clientStack);
+              } catch (e) {
+                errors.push(e);
+              }
+            }
+          }
+          if (errors.length > 0) {
+            if (errors.length === 1) {
+              throw errors[0];
+            } else {
+              throw new AggregateError(
+                errors,
+                "Errors occurred during event emission"
+              );
+            }
+          }
+        });
+      },
+      subscribe(callback) {
+        subscribers.add(callback);
+        return () => subscribers.delete(callback);
+      },
+      notifySubscribers() {
+        for (const cb of subscribers) {
+          try {
+            cb();
+          } catch (e) {
+            console.error("NotificationManager: subscriber callback error", e);
+          }
+        }
+      }
+    };
+  }, []);
+});
+export {
+  NotificationManager
+};
+//# sourceMappingURL=NotificationManager.js.map

package/dist/utils/NotificationManager.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/NotificationManager.ts"],"sourcesContent":["import { resource, tapMemo } from \"@assistant-ui/tap\";\nimport type { ClientStack } from \"./tap-client-stack-context\";\nimport type {\n  AssistantEventName,\n  AssistantEventPayload,\n} from \"../types/events\";\nimport { Unsubscribe } from \"../types/client\";\n\ntype InternalCallback = (payload: unknown, clientStack: ClientStack) => void;\n\nexport type NotificationManager = {\n  on<TEvent extends AssistantEventName>(\n    event: TEvent,\n    callback: (\n      payload: AssistantEventPayload[TEvent],\n      clientStack: ClientStack,\n    ) => void,\n  ): Unsubscribe;\n  emit<TEvent extends Exclude<AssistantEventName, \"*\">>(\n    event: TEvent,\n    payload: AssistantEventPayload[TEvent],\n    clientStack: ClientStack,\n  ): void;\n  subscribe(callback: () => void): Unsubscribe;\n  notifySubscribers(): void;\n};\n\nexport const NotificationManager = resource((): NotificationManager => {\n  return tapMemo(() => {\n    const listeners = new Map<string, Set<InternalCallback>>();\n    const wildcardListeners = new Set<InternalCallback>();\n    const subscribers = new Set<() => void>();\n\n    return {\n      on(event, callback) {\n        const cb = callback as InternalCallback;\n        if (event === \"*\") {\n          wildcardListeners.add(cb);\n          return () => wildcardListeners.delete(cb);\n        }\n\n        let set = listeners.get(event);\n        if (!set) {\n          set = new Set();\n          listeners.set(event, set);\n        }\n        set.add(cb);\n\n        return () => {\n          set!.delete(cb);\n          if (set!.size === 0) listeners.delete(event);\n        };\n      },\n\n      emit(event, payload, clientStack) {\n        const eventListeners = listeners.get(event);\n        if (!eventListeners && wildcardListeners.size === 0) return;\n\n        queueMicrotask(() => {\n          const errors = [];\n          if (eventListeners) {\n            for (const cb of eventListeners) {\n              try {\n                cb(payload, clientStack);\n              } catch (e) {\n                errors.push(e);\n              }\n            }\n          }\n          if (wildcardListeners.size > 0) {\n            const wrapped = { event, payload };\n            for (const cb of wildcardListeners) {\n              try {\n                cb(wrapped, clientStack);\n              } catch (e) {\n                errors.push(e);\n              }\n            }\n          }\n\n          if (errors.length > 0) {\n            if (errors.length === 1) {\n              throw errors[0];\n            } else {\n              throw new AggregateError(\n                errors,\n                \"Errors occurred during event emission\",\n              );\n            }\n          }\n        });\n      },\n\n      subscribe(callback) {\n        subscribers.add(callback);\n        return () => subscribers.delete(callback);\n      },\n\n      notifySubscribers() {\n        for (const cb of subscribers) {\n          try {\n            cb();\n          } catch (e) {\n            console.error(\"NotificationManager: subscriber callback error\", e);\n          }\n        }\n      },\n    };\n  }, []);\n});\n"],"mappings":";AAAA,SAAS,UAAU,eAAe;AA2B3B,IAAM,sBAAsB,SAAS,MAA2B;AACrE,SAAO,QAAQ,MAAM;AACnB,UAAM,YAAY,oBAAI,IAAmC;AACzD,UAAM,oBAAoB,oBAAI,IAAsB;AACpD,UAAM,cAAc,oBAAI,IAAgB;AAExC,WAAO;AAAA,MACL,GAAG,OAAO,UAAU;AAClB,cAAM,KAAK;AACX,YAAI,UAAU,KAAK;AACjB,4BAAkB,IAAI,EAAE;AACxB,iBAAO,MAAM,kBAAkB,OAAO,EAAE;AAAA,QAC1C;AAEA,YAAI,MAAM,UAAU,IAAI,KAAK;AAC7B,YAAI,CAAC,KAAK;AACR,gBAAM,oBAAI,IAAI;AACd,oBAAU,IAAI,OAAO,GAAG;AAAA,QAC1B;AACA,YAAI,IAAI,EAAE;AAEV,eAAO,MAAM;AACX,cAAK,OAAO,EAAE;AACd,cAAI,IAAK,SAAS,EAAG,WAAU,OAAO,KAAK;AAAA,QAC7C;AAAA,MACF;AAAA,MAEA,KAAK,OAAO,SAAS,aAAa;AAChC,cAAM,iBAAiB,UAAU,IAAI,KAAK;AAC1C,YAAI,CAAC,kBAAkB,kBAAkB,SAAS,EAAG;AAErD,uBAAe,MAAM;AACnB,gBAAM,SAAS,CAAC;AAChB,cAAI,gBAAgB;AAClB,uBAAW,MAAM,gBAAgB;AAC/B,kBAAI;AACF,mBAAG,SAAS,WAAW;AAAA,cACzB,SAAS,GAAG;AACV,uBAAO,KAAK,CAAC;AAAA,cACf;AAAA,YACF;AAAA,UACF;AACA,cAAI,kBAAkB,OAAO,GAAG;AAC9B,kBAAM,UAAU,EAAE,OAAO,QAAQ;AACjC,uBAAW,MAAM,mBAAmB;AAClC,kBAAI;AACF,mBAAG,SAAS,WAAW;AAAA,cACzB,SAAS,GAAG;AACV,uBAAO,KAAK,CAAC;AAAA,cACf;AAAA,YACF;AAAA,UACF;AAEA,cAAI,OAAO,SAAS,GAAG;AACrB,gBAAI,OAAO,WAAW,GAAG;AACvB,oBAAM,OAAO,CAAC;AAAA,YAChB,OAAO;AACL,oBAAM,IAAI;AAAA,gBACR;AAAA,gBACA;AAAA,cACF;AAAA,YACF;AAAA,UACF;AAAA,QACF,CAAC;AAAA,MACH;AAAA,MAEA,UAAU,UAAU;AAClB,oBAAY,IAAI,QAAQ;AACxB,eAAO,MAAM,YAAY,OAAO,QAAQ;AAAA,MAC1C;AAAA,MAEA,oBAAoB;AAClB,mBAAW,MAAM,aAAa;AAC5B,cAAI;AACF,eAAG;AAAA,UACL,SAAS,GAAG;AACV,oBAAQ,MAAM,kDAAkD,CAAC;AAAA,UACnE;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF,GAAG,CAAC,CAAC;AACP,CAAC;","names":[]}

package/dist/utils/StoreResource.d.ts

@@ -0,0 +1,14 @@
+import { ResourceElement } from "@assistant-ui/tap";
+import { Unsubscribe } from "../types/client";
+export interface Store<TState> {
+    /**
+     * Get the current state of the store.
+     */
+    getState(): TState;
+    /**
+     * Subscribe to the store.
+     */
+    subscribe(listener: () => void): Unsubscribe;
+}
+export declare const StoreResource: <TState>(props: ResourceElement<TState>) => ResourceElement<Store<TState>, ResourceElement<TState>>;
+//# sourceMappingURL=StoreResource.d.ts.map

package/dist/utils/StoreResource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StoreResource.d.ts","sourceRoot":"","sources":["../../src/utils/StoreResource.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,eAAe,EAIhB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,MAAM,WAAW,KAAK,CAAC,MAAM;IAC3B;;OAEG;IACH,QAAQ,IAAI,MAAM,CAAC;IAEnB;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,WAAW,CAAC;CAC9C;AAED,eAAO,MAAM,aAAa,GACvB,MAAM,4FAaR,CAAC"}

package/dist/utils/StoreResource.js

@@ -0,0 +1,23 @@
+// src/utils/StoreResource.ts
+import {
+  tapEffect,
+  resource,
+  createResource,
+  tapState
+} from "@assistant-ui/tap";
+var StoreResource = resource(
+  (element) => {
+    const [handle] = tapState(() => createResource(element, { mount: false }));
+    tapEffect(() => {
+      return handle.unmount;
+    }, [handle]);
+    tapEffect(() => {
+      handle.render(element);
+    }, [handle, element]);
+    return handle;
+  }
+);
+export {
+  StoreResource
+};
+//# sourceMappingURL=StoreResource.js.map

package/dist/utils/StoreResource.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/StoreResource.ts"],"sourcesContent":["import {\n  tapEffect,\n  ResourceElement,\n  resource,\n  createResource,\n  tapState,\n} from \"@assistant-ui/tap\";\nimport { Unsubscribe } from \"../types/client\";\n\nexport interface Store<TState> {\n  /**\n   * Get the current state of the store.\n   */\n  getState(): TState;\n\n  /**\n   * Subscribe to the store.\n   */\n  subscribe(listener: () => void): Unsubscribe;\n}\n\nexport const StoreResource = resource(\n  <TState>(element: ResourceElement<TState>): Store<TState> => {\n    const [handle] = tapState(() => createResource(element, { mount: false }));\n\n    tapEffect(() => {\n      return handle.unmount;\n    }, [handle]);\n\n    tapEffect(() => {\n      handle.render(element);\n    }, [handle, element]);\n\n    return handle;\n  },\n);\n"],"mappings":";AAAA;AAAA,EACE;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAeA,IAAM,gBAAgB;AAAA,EAC3B,CAAS,YAAoD;AAC3D,UAAM,CAAC,MAAM,IAAI,SAAS,MAAM,eAAe,SAAS,EAAE,OAAO,MAAM,CAAC,CAAC;AAEzE,cAAU,MAAM;AACd,aAAO,OAAO;AAAA,IAChB,GAAG,CAAC,MAAM,CAAC;AAEX,cAAU,MAAM;AACd,aAAO,OAAO,OAAO;AAAA,IACvB,GAAG,CAAC,QAAQ,OAAO,CAAC;AAEpB,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/utils/proxied-assistant-state.d.ts

@@ -0,0 +1,8 @@
+import type { AssistantClient, AssistantState } from "../types/client";
+export declare const PROXIED_ASSISTANT_STATE_SYMBOL: unique symbol;
+/**
+ * Proxied state that lazily accesses scope states
+ */
+export declare const createProxiedAssistantState: (client: AssistantClient) => AssistantState;
+export declare const getProxiedAssistantState: (client: AssistantClient) => AssistantState;
+//# sourceMappingURL=proxied-assistant-state.d.ts.map

package/dist/utils/proxied-assistant-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxied-assistant-state.d.ts","sourceRoot":"","sources":["../../src/utils/proxied-assistant-state.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGvE,eAAO,MAAM,8BAA8B,eAE1C,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,2BAA2B,GACtC,QAAQ,eAAe,KACtB,cA0BF,CAAC;AAEF,eAAO,MAAM,wBAAwB,GACnC,QAAQ,eAAe,KACtB,cAIF,CAAC"}

package/dist/utils/proxied-assistant-state.js

@@ -0,0 +1,41 @@
+"use client";
+
+// src/utils/proxied-assistant-state.tsx
+import { getClientState } from "../tapClientResource.js";
+import { BaseProxyHandler, handleIntrospectionProp } from "./BaseProxyHandler.js";
+var PROXIED_ASSISTANT_STATE_SYMBOL = /* @__PURE__ */ Symbol(
+  "assistant-ui.store.proxiedAssistantState"
+);
+var isIgnoredKey = (key) => {
+  return key === "on" || key === "subscribe" || typeof key === "symbol";
+};
+var createProxiedAssistantState = (client) => {
+  class ProxiedAssistantStateProxyHandler extends BaseProxyHandler {
+    get(_, prop) {
+      const introspection = handleIntrospectionProp(prop, "AssistantState");
+      if (introspection !== false) return introspection;
+      const scope = prop;
+      if (isIgnoredKey(scope)) return void 0;
+      return getClientState(client[scope]());
+    }
+    ownKeys() {
+      return Object.keys(client).filter((key) => !isIgnoredKey(key));
+    }
+    has(_, prop) {
+      return !isIgnoredKey(prop) && prop in client;
+    }
+  }
+  return new Proxy(
+    {},
+    new ProxiedAssistantStateProxyHandler()
+  );
+};
+var getProxiedAssistantState = (client) => {
+  return client[PROXIED_ASSISTANT_STATE_SYMBOL];
+};
+export {
+  PROXIED_ASSISTANT_STATE_SYMBOL,
+  createProxiedAssistantState,
+  getProxiedAssistantState
+};
+//# sourceMappingURL=proxied-assistant-state.js.map

package/dist/utils/proxied-assistant-state.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/proxied-assistant-state.tsx"],"sourcesContent":["\"use client\";\nimport { getClientState } from \"../tapClientResource\";\nimport type { AssistantClient, AssistantState } from \"../types/client\";\nimport { BaseProxyHandler, handleIntrospectionProp } from \"./BaseProxyHandler\";\n\nexport const PROXIED_ASSISTANT_STATE_SYMBOL = Symbol(\n  \"assistant-ui.store.proxiedAssistantState\",\n);\n\nconst isIgnoredKey = (key: string | symbol): key is \"on\" | \"subscribe\" => {\n  return key === \"on\" || key === \"subscribe\" || typeof key === \"symbol\";\n};\n\n/**\n * Proxied state that lazily accesses scope states\n */\nexport const createProxiedAssistantState = (\n  client: AssistantClient,\n): AssistantState => {\n  class ProxiedAssistantStateProxyHandler\n    extends BaseProxyHandler\n    implements ProxyHandler<AssistantState>\n  {\n    get(_: unknown, prop: string | symbol) {\n      const introspection = handleIntrospectionProp(prop, \"AssistantState\");\n      if (introspection !== false) return introspection;\n      const scope = prop as keyof AssistantClient;\n      if (isIgnoredKey(scope)) return undefined;\n      return getClientState(client[scope]());\n    }\n\n    ownKeys(): ArrayLike<string | symbol> {\n      return Object.keys(client).filter((key) => !isIgnoredKey(key));\n    }\n\n    has(_: unknown, prop: string | symbol): boolean {\n      return !isIgnoredKey(prop) && prop in client;\n    }\n  }\n\n  return new Proxy<AssistantState>(\n    {} as AssistantState,\n    new ProxiedAssistantStateProxyHandler(),\n  );\n};\n\nexport const getProxiedAssistantState = (\n  client: AssistantClient,\n): AssistantState => {\n  return (\n    client as unknown as { [PROXIED_ASSISTANT_STATE_SYMBOL]: AssistantState }\n  )[PROXIED_ASSISTANT_STATE_SYMBOL];\n};\n"],"mappings":";;;AACA,SAAS,sBAAsB;AAE/B,SAAS,kBAAkB,+BAA+B;AAEnD,IAAM,iCAAiC;AAAA,EAC5C;AACF;AAEA,IAAM,eAAe,CAAC,QAAoD;AACxE,SAAO,QAAQ,QAAQ,QAAQ,eAAe,OAAO,QAAQ;AAC/D;AAKO,IAAM,8BAA8B,CACzC,WACmB;AAAA,EACnB,MAAM,0CACI,iBAEV;AAAA,IACE,IAAI,GAAY,MAAuB;AACrC,YAAM,gBAAgB,wBAAwB,MAAM,gBAAgB;AACpE,UAAI,kBAAkB,MAAO,QAAO;AACpC,YAAM,QAAQ;AACd,UAAI,aAAa,KAAK,EAAG,QAAO;AAChC,aAAO,eAAe,OAAO,KAAK,EAAE,CAAC;AAAA,IACvC;AAAA,IAEA,UAAsC;AACpC,aAAO,OAAO,KAAK,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,aAAa,GAAG,CAAC;AAAA,IAC/D;AAAA,IAEA,IAAI,GAAY,MAAgC;AAC9C,aAAO,CAAC,aAAa,IAAI,KAAK,QAAQ;AAAA,IACxC;AAAA,EACF;AAEA,SAAO,IAAI;AAAA,IACT,CAAC;AAAA,IACD,IAAI,kCAAkC;AAAA,EACxC;AACF;AAEO,IAAM,2BAA2B,CACtC,WACmB;AACnB,SACE,OACA,8BAA8B;AAClC;","names":[]}

package/dist/{AssistantContext.d.ts → utils/react-assistant-context.d.ts}

@@ -1,9 +1,9 @@
 import React from "react";
-import type { AssistantClient } from "./types";
-/**
- * React Context for the AssistantClient
- */
-export declare const AssistantContext: React.Context<AssistantClient>;
+import type { AssistantClient } from "../types/client";
+/** Default context value - throws "wrap in AssistantProvider" error */
+export declare const DefaultAssistantClient: AssistantClient;
+/** Root prototype for created clients - throws "scope not defined" error */
+export declare const createRootAssistantClient: () => AssistantClient;
 export declare const useAssistantContextValue: () => AssistantClient;
 /**
  * Provider component for AssistantClient
@@ -19,4 +19,4 @@ export declare const AssistantProvider: ({ client, children, }: {
     client: AssistantClient;
     children: React.ReactNode;
 }) => React.ReactElement;
-//# sourceMappingURL=AssistantContext.d.ts.map
+//# sourceMappingURL=react-assistant-context.d.ts.map

package/dist/utils/react-assistant-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-assistant-context.d.ts","sourceRoot":"","sources":["../../src/utils/react-assistant-context.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoC,MAAM,OAAO,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAA2B,MAAM,iBAAiB,CAAC;AAmDhF,uEAAuE;AACvE,eAAO,MAAM,sBAAsB,EAAE,eAIlC,CAAC;AAMJ,4EAA4E;AAC5E,eAAO,MAAM,yBAAyB,QAAO,eASzC,CAAC;AAOL,eAAO,MAAM,wBAAwB,QAAO,eAE3C,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,GAAI,uBAG/B;IACD,MAAM,EAAE,eAAe,CAAC;IACxB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,KAAG,KAAK,CAAC,YAMT,CAAC"}

package/dist/utils/react-assistant-context.js

@@ -0,0 +1,73 @@
+// src/utils/react-assistant-context.tsx
+import { createContext, useContext } from "react";
+import {
+  createProxiedAssistantState,
+  PROXIED_ASSISTANT_STATE_SYMBOL
+} from "./proxied-assistant-state.js";
+import { BaseProxyHandler, handleIntrospectionProp } from "./BaseProxyHandler.js";
+import { jsx } from "react/jsx-runtime";
+var NO_OP_SUBSCRIBE = () => () => {
+};
+var createErrorClientField = (message) => {
+  const fn = (() => {
+    throw new Error(message);
+  });
+  fn.source = null;
+  fn.query = null;
+  return fn;
+};
+var DefaultAssistantClientProxyHandler = class extends BaseProxyHandler {
+  get(_, prop) {
+    if (prop === "subscribe") return NO_OP_SUBSCRIBE;
+    if (prop === "on") return NO_OP_SUBSCRIBE;
+    if (prop === PROXIED_ASSISTANT_STATE_SYMBOL)
+      return DefaultAssistantClientProxiedAssistantState;
+    const introspection = handleIntrospectionProp(
+      prop,
+      "DefaultAssistantClient"
+    );
+    if (introspection !== false) return introspection;
+    return createErrorClientField(
+      `The current scope does not have a "${String(prop)}" property.`
+    );
+  }
+  ownKeys() {
+    return ["subscribe", "on", PROXIED_ASSISTANT_STATE_SYMBOL];
+  }
+  has(_, prop) {
+    return prop === "subscribe" || prop === "on" || prop === PROXIED_ASSISTANT_STATE_SYMBOL;
+  }
+};
+var DefaultAssistantClient = new Proxy(
+  {},
+  new DefaultAssistantClientProxyHandler()
+);
+var DefaultAssistantClientProxiedAssistantState = createProxiedAssistantState(
+  DefaultAssistantClient
+);
+var createRootAssistantClient = () => new Proxy({}, {
+  get(_, prop) {
+    const introspection = handleIntrospectionProp(prop, "AssistantClient");
+    if (introspection !== false) return introspection;
+    return createErrorClientField(
+      `The current scope does not have a "${String(prop)}" property.`
+    );
+  }
+});
+var AssistantContext = createContext(DefaultAssistantClient);
+var useAssistantContextValue = () => {
+  return useContext(AssistantContext);
+};
+var AssistantProvider = ({
+  client,
+  children
+}) => {
+  return /* @__PURE__ */ jsx(AssistantContext.Provider, { value: client, children });
+};
+export {
+  AssistantProvider,
+  DefaultAssistantClient,
+  createRootAssistantClient,
+  useAssistantContextValue
+};
+//# sourceMappingURL=react-assistant-context.js.map

package/dist/utils/react-assistant-context.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/react-assistant-context.tsx"],"sourcesContent":["import React, { createContext, useContext } from \"react\";\nimport type { AssistantClient, AssistantClientAccessor } from \"../types/client\";\nimport {\n  createProxiedAssistantState,\n  PROXIED_ASSISTANT_STATE_SYMBOL,\n} from \"./proxied-assistant-state\";\nimport { BaseProxyHandler, handleIntrospectionProp } from \"./BaseProxyHandler\";\n\nconst NO_OP_SUBSCRIBE = () => () => {};\n\nconst createErrorClientField = (\n  message: string,\n): AssistantClientAccessor<never> => {\n  const fn = (() => {\n    throw new Error(message);\n  }) as AssistantClientAccessor<never>;\n  fn.source = null;\n  fn.query = null;\n  return fn;\n};\n\nclass DefaultAssistantClientProxyHandler\n  extends BaseProxyHandler\n  implements ProxyHandler<AssistantClient>\n{\n  get(_: unknown, prop: string | symbol) {\n    if (prop === \"subscribe\") return NO_OP_SUBSCRIBE;\n    if (prop === \"on\") return NO_OP_SUBSCRIBE;\n    if (prop === PROXIED_ASSISTANT_STATE_SYMBOL)\n      return DefaultAssistantClientProxiedAssistantState;\n    const introspection = handleIntrospectionProp(\n      prop,\n      \"DefaultAssistantClient\",\n    );\n    if (introspection !== false) return introspection;\n    return createErrorClientField(\n      `The current scope does not have a \"${String(prop)}\" property.`,\n    );\n  }\n\n  ownKeys(): ArrayLike<string | symbol> {\n    return [\"subscribe\", \"on\", PROXIED_ASSISTANT_STATE_SYMBOL];\n  }\n\n  has(_: unknown, prop: string | symbol): boolean {\n    return (\n      prop === \"subscribe\" ||\n      prop === \"on\" ||\n      prop === PROXIED_ASSISTANT_STATE_SYMBOL\n    );\n  }\n}\n/** Default context value - throws \"wrap in AssistantProvider\" error */\nexport const DefaultAssistantClient: AssistantClient =\n  new Proxy<AssistantClient>(\n    {} as AssistantClient,\n    new DefaultAssistantClientProxyHandler(),\n  );\n\nconst DefaultAssistantClientProxiedAssistantState = createProxiedAssistantState(\n  DefaultAssistantClient,\n);\n\n/** Root prototype for created clients - throws \"scope not defined\" error */\nexport const createRootAssistantClient = (): AssistantClient =>\n  new Proxy<AssistantClient>({} as AssistantClient, {\n    get(_: AssistantClient, prop: string | symbol) {\n      const introspection = handleIntrospectionProp(prop, \"AssistantClient\");\n      if (introspection !== false) return introspection;\n      return createErrorClientField(\n        `The current scope does not have a \"${String(prop)}\" property.`,\n      );\n    },\n  });\n\n/**\n * React Context for the AssistantClient\n */\nconst AssistantContext = createContext<AssistantClient>(DefaultAssistantClient);\n\nexport const useAssistantContextValue = (): AssistantClient => {\n  return useContext(AssistantContext);\n};\n\n/**\n * Provider component for AssistantClient\n *\n * @example\n * ```typescript\n * <AssistantProvider client={client}>\n *   <YourApp />\n * </AssistantProvider>\n * ```\n */\nexport const AssistantProvider = ({\n  client,\n  children,\n}: {\n  client: AssistantClient;\n  children: React.ReactNode;\n}): React.ReactElement => {\n  return (\n    <AssistantContext.Provider value={client}>\n      {children}\n    </AssistantContext.Provider>\n  );\n};\n"],"mappings":";AAAA,SAAgB,eAAe,kBAAkB;AAEjD;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP,SAAS,kBAAkB,+BAA+B;AAgGtD;AA9FJ,IAAM,kBAAkB,MAAM,MAAM;AAAC;AAErC,IAAM,yBAAyB,CAC7B,YACmC;AACnC,QAAM,MAAM,MAAM;AAChB,UAAM,IAAI,MAAM,OAAO;AAAA,EACzB;AACA,KAAG,SAAS;AACZ,KAAG,QAAQ;AACX,SAAO;AACT;AAEA,IAAM,qCAAN,cACU,iBAEV;AAAA,EACE,IAAI,GAAY,MAAuB;AACrC,QAAI,SAAS,YAAa,QAAO;AACjC,QAAI,SAAS,KAAM,QAAO;AAC1B,QAAI,SAAS;AACX,aAAO;AACT,UAAM,gBAAgB;AAAA,MACpB;AAAA,MACA;AAAA,IACF;AACA,QAAI,kBAAkB,MAAO,QAAO;AACpC,WAAO;AAAA,MACL,sCAAsC,OAAO,IAAI,CAAC;AAAA,IACpD;AAAA,EACF;AAAA,EAEA,UAAsC;AACpC,WAAO,CAAC,aAAa,MAAM,8BAA8B;AAAA,EAC3D;AAAA,EAEA,IAAI,GAAY,MAAgC;AAC9C,WACE,SAAS,eACT,SAAS,QACT,SAAS;AAAA,EAEb;AACF;AAEO,IAAM,yBACX,IAAI;AAAA,EACF,CAAC;AAAA,EACD,IAAI,mCAAmC;AACzC;AAEF,IAAM,8CAA8C;AAAA,EAClD;AACF;AAGO,IAAM,4BAA4B,MACvC,IAAI,MAAuB,CAAC,GAAsB;AAAA,EAChD,IAAI,GAAoB,MAAuB;AAC7C,UAAM,gBAAgB,wBAAwB,MAAM,iBAAiB;AACrE,QAAI,kBAAkB,MAAO,QAAO;AACpC,WAAO;AAAA,MACL,sCAAsC,OAAO,IAAI,CAAC;AAAA,IACpD;AAAA,EACF;AACF,CAAC;AAKH,IAAM,mBAAmB,cAA+B,sBAAsB;AAEvE,IAAM,2BAA2B,MAAuB;AAC7D,SAAO,WAAW,gBAAgB;AACpC;AAYO,IAAM,oBAAoB,CAAC;AAAA,EAChC;AAAA,EACA;AACF,MAG0B;AACxB,SACE,oBAAC,iBAAiB,UAAjB,EAA0B,OAAO,QAC/B,UACH;AAEJ;","names":[]}

package/dist/utils/splitClients.d.ts

@@ -0,0 +1,28 @@
+import { DerivedElement } from "../Derived";
+import type { AssistantClient, ClientElement, ClientNames } from "../types/client";
+import type { useAssistantClient } from "../useAssistantClient";
+export type RootClients = Partial<Record<ClientNames, ClientElement<ClientNames>>>;
+export type DerivedClients = Partial<Record<ClientNames, DerivedElement<ClientNames>>>;
+/**
+ * Splits a clients object into root clients and derived clients.
+ *
+ * @param clients - The clients input object to split
+ * @returns An object with { rootClients, derivedClients }
+ *
+ * @example
+ * ```typescript
+ * const clients = {
+ *   foo: RootClient({ ... }),
+ *   bar: Derived({ ... }),
+ * };
+ *
+ * const { rootClients, derivedClients } = splitClients(clients);
+ * // rootClients = { foo: ... }
+ * // derivedClients = { bar: ... }
+ * ```
+ */
+export declare function splitClients(clients: useAssistantClient.Props, baseClient: AssistantClient): {
+    rootClients: Partial<Record<"ERROR: No clients were defined", ClientElement<"ERROR: No clients were defined">>>;
+    derivedClients: Partial<Record<"ERROR: No clients were defined", DerivedElement<"ERROR: No clients were defined">>>;
+};
+//# sourceMappingURL=splitClients.d.ts.map

package/dist/utils/splitClients.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"splitClients.d.ts","sourceRoot":"","sources":["../../src/utils/splitClients.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,cAAc,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,WAAW,EACZ,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,MAAM,MAAM,WAAW,GAAG,OAAO,CAC/B,MAAM,CAAC,WAAW,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC,CAChD,CAAC;AACF,MAAM,MAAM,cAAc,GAAG,OAAO,CAClC,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,WAAW,CAAC,CAAC,CACjD,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,kBAAkB,CAAC,KAAK,EACjC,UAAU,EAAE,eAAe;;;EAgD5B"}

package/dist/utils/splitClients.js

@@ -0,0 +1,37 @@
+// src/utils/splitClients.ts
+import { Derived } from "../Derived.js";
+import { getDefaultPeers } from "../attachDefaultPeers.js";
+function splitClients(clients, baseClient) {
+  const rootClients = {};
+  const derivedClients = {};
+  for (const [key, clientElement] of Object.entries(clients)) {
+    if (clientElement.type === Derived) {
+      derivedClients[key] = clientElement;
+    } else {
+      rootClients[key] = clientElement;
+    }
+  }
+  for (const [clientKey, clientElement] of Object.entries(rootClients)) {
+    const defaultPeers = getDefaultPeers(clientElement.type);
+    if (!defaultPeers) continue;
+    for (const [key, peerElement] of Object.entries(defaultPeers)) {
+      if (key in rootClients || key in derivedClients || baseClient[key].source !== null)
+        continue;
+      if (peerElement.type === Derived) {
+        derivedClients[key] = peerElement;
+      } else {
+        rootClients[key] = peerElement;
+        const subDefaultPeers = getDefaultPeers(peerElement.type);
+        if (subDefaultPeers)
+          throw new Error(
+            `Nested default peers are not supported. Client "${clientKey}" has default peers, but its peer "${key}" also has default peers.`
+          );
+      }
+    }
+  }
+  return { rootClients, derivedClients };
+}
+export {
+  splitClients
+};
+//# sourceMappingURL=splitClients.js.map

package/dist/utils/splitClients.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/splitClients.ts"],"sourcesContent":["import { Derived, DerivedElement } from \"../Derived\";\nimport type {\n  AssistantClient,\n  ClientElement,\n  ClientNames,\n} from \"../types/client\";\nimport { getDefaultPeers } from \"../attachDefaultPeers\";\nimport type { useAssistantClient } from \"../useAssistantClient\";\n\nexport type RootClients = Partial<\n  Record<ClientNames, ClientElement<ClientNames>>\n>;\nexport type DerivedClients = Partial<\n  Record<ClientNames, DerivedElement<ClientNames>>\n>;\n\n/**\n * Splits a clients object into root clients and derived clients.\n *\n * @param clients - The clients input object to split\n * @returns An object with { rootClients, derivedClients }\n *\n * @example\n * ```typescript\n * const clients = {\n *   foo: RootClient({ ... }),\n *   bar: Derived({ ... }),\n * };\n *\n * const { rootClients, derivedClients } = splitClients(clients);\n * // rootClients = { foo: ... }\n * // derivedClients = { bar: ... }\n * ```\n */\nexport function splitClients(\n  clients: useAssistantClient.Props,\n  baseClient: AssistantClient,\n) {\n  const rootClients: RootClients = {};\n  const derivedClients: DerivedClients = {};\n\n  for (const [key, clientElement] of Object.entries(clients) as [\n    keyof useAssistantClient.Props,\n    NonNullable<useAssistantClient.Props[keyof useAssistantClient.Props]>,\n  ][]) {\n    if (clientElement.type === Derived) {\n      derivedClients[key] = clientElement as DerivedElement<ClientNames>;\n    } else {\n      rootClients[key] = clientElement as ClientElement<ClientNames>;\n    }\n  }\n\n  for (const [clientKey, clientElement] of Object.entries(rootClients) as [\n    ClientNames,\n    ClientElement<ClientNames>,\n  ][]) {\n    const defaultPeers = getDefaultPeers(clientElement.type);\n    if (!defaultPeers) continue;\n\n    for (const [key, peerElement] of Object.entries(defaultPeers) as [\n      ClientNames,\n      ClientElement<ClientNames> | DerivedElement<ClientNames>,\n    ][]) {\n      if (\n        key in rootClients ||\n        key in derivedClients ||\n        baseClient[key].source !== null\n      )\n        continue;\n\n      if (peerElement.type === Derived<ClientNames>) {\n        derivedClients[key] = peerElement as DerivedElement<ClientNames>;\n      } else {\n        rootClients[key] = peerElement as ClientElement<ClientNames>;\n        const subDefaultPeers = getDefaultPeers(peerElement.type);\n        if (subDefaultPeers)\n          throw new Error(\n            `Nested default peers are not supported. Client \"${clientKey}\" has default peers, but its peer \"${key}\" also has default peers.`,\n          );\n      }\n    }\n  }\n\n  return { rootClients, derivedClients };\n}\n"],"mappings":";AAAA,SAAS,eAA+B;AAMxC,SAAS,uBAAuB;AA4BzB,SAAS,aACd,SACA,YACA;AACA,QAAM,cAA2B,CAAC;AAClC,QAAM,iBAAiC,CAAC;AAExC,aAAW,CAAC,KAAK,aAAa,KAAK,OAAO,QAAQ,OAAO,GAGpD;AACH,QAAI,cAAc,SAAS,SAAS;AAClC,qBAAe,GAAG,IAAI;AAAA,IACxB,OAAO;AACL,kBAAY,GAAG,IAAI;AAAA,IACrB;AAAA,EACF;AAEA,aAAW,CAAC,WAAW,aAAa,KAAK,OAAO,QAAQ,WAAW,GAG9D;AACH,UAAM,eAAe,gBAAgB,cAAc,IAAI;AACvD,QAAI,CAAC,aAAc;AAEnB,eAAW,CAAC,KAAK,WAAW,KAAK,OAAO,QAAQ,YAAY,GAGvD;AACH,UACE,OAAO,eACP,OAAO,kBACP,WAAW,GAAG,EAAE,WAAW;AAE3B;AAEF,UAAI,YAAY,SAAS,SAAsB;AAC7C,uBAAe,GAAG,IAAI;AAAA,MACxB,OAAO;AACL,oBAAY,GAAG,IAAI;AACnB,cAAM,kBAAkB,gBAAgB,YAAY,IAAI;AACxD,YAAI;AACF,gBAAM,IAAI;AAAA,YACR,mDAAmD,SAAS,sCAAsC,GAAG;AAAA,UACvG;AAAA,MACJ;AAAA,IACF;AAAA,EACF;AAEA,SAAO,EAAE,aAAa,eAAe;AACvC;","names":[]}

package/dist/utils/tap-assistant-context.d.ts

@@ -0,0 +1,19 @@
+import type { AssistantEventName, AssistantEventPayload } from "../types/events";
+import type { AssistantClient } from "../types/client";
+import { type ClientStack } from "./tap-client-stack-context";
+type EmitFn = <TEvent extends Exclude<AssistantEventName, "*">>(event: TEvent, payload: AssistantEventPayload[TEvent], clientStack: ClientStack) => void;
+export type AssistantTapContextValue = {
+    clientRef: {
+        parent: AssistantClient;
+        current: AssistantClient | null;
+    };
+    emit: EmitFn;
+};
+export declare const withAssistantTapContextProvider: <TResult>(value: AssistantTapContextValue, fn: () => TResult) => TResult;
+export declare const tapAssistantClientRef: () => {
+    parent: AssistantClient;
+    current: AssistantClient | null;
+};
+export declare const tapAssistantEmit: () => <TEvent extends Exclude<AssistantEventName, "*">>(event: TEvent, payload: AssistantEventPayload[TEvent]) => void;
+export {};
+//# sourceMappingURL=tap-assistant-context.d.ts.map

package/dist/utils/tap-assistant-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tap-assistant-context.d.ts","sourceRoot":"","sources":["../../src/utils/tap-assistant-context.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9E,KAAK,MAAM,GAAG,CAAC,MAAM,SAAS,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,EAC5D,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,qBAAqB,CAAC,MAAM,CAAC,EACtC,WAAW,EAAE,WAAW,KACrB,IAAI,CAAC;AAEV,MAAM,MAAM,wBAAwB,GAAG;IACrC,SAAS,EAAE;QAAE,MAAM,EAAE,eAAe,CAAC;QAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAAA;KAAE,CAAC;IACxE,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAMF,eAAO,MAAM,+BAA+B,GAAI,OAAO,EACrD,OAAO,wBAAwB,EAC/B,IAAI,MAAM,OAAO,YAGlB,CAAC;AASF,eAAO,MAAM,qBAAqB;YAtBX,eAAe;aAAW,eAAe,GAAG,IAAI;CAwBtE,CAAC;AAEF,eAAO,MAAM,gBAAgB,SAKxB,MAAM,SAAS,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,SACvC,MAAM,WACJ,qBAAqB,CAAC,MAAM,CAAC,SAK3C,CAAC"}

package/dist/utils/tap-assistant-context.js

@@ -0,0 +1,37 @@
+// src/utils/tap-assistant-context.ts
+import {
+  createContext,
+  tapContext,
+  withContextProvider,
+  tapEffectEvent
+} from "@assistant-ui/tap";
+import { tapClientStack } from "./tap-client-stack-context.js";
+var AssistantTapContext = createContext(
+  null
+);
+var withAssistantTapContextProvider = (value, fn) => {
+  return withContextProvider(AssistantTapContext, value, fn);
+};
+var tapAssistantTapContext = () => {
+  const ctx = tapContext(AssistantTapContext);
+  if (!ctx) throw new Error("AssistantTapContext is not available");
+  return ctx;
+};
+var tapAssistantClientRef = () => {
+  return tapAssistantTapContext().clientRef;
+};
+var tapAssistantEmit = () => {
+  const { emit } = tapAssistantTapContext();
+  const clientStack = tapClientStack();
+  return tapEffectEvent(
+    (event, payload) => {
+      emit(event, payload, clientStack);
+    }
+  );
+};
+export {
+  tapAssistantClientRef,
+  tapAssistantEmit,
+  withAssistantTapContextProvider
+};
+//# sourceMappingURL=tap-assistant-context.js.map

package/dist/utils/tap-assistant-context.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/tap-assistant-context.ts"],"sourcesContent":["import {\n  createContext,\n  tapContext,\n  withContextProvider,\n  tapEffectEvent,\n} from \"@assistant-ui/tap\";\nimport type {\n  AssistantEventName,\n  AssistantEventPayload,\n} from \"../types/events\";\nimport type { AssistantClient } from \"../types/client\";\nimport { tapClientStack, type ClientStack } from \"./tap-client-stack-context\";\n\ntype EmitFn = <TEvent extends Exclude<AssistantEventName, \"*\">>(\n  event: TEvent,\n  payload: AssistantEventPayload[TEvent],\n  clientStack: ClientStack,\n) => void;\n\nexport type AssistantTapContextValue = {\n  clientRef: { parent: AssistantClient; current: AssistantClient | null };\n  emit: EmitFn;\n};\n\nconst AssistantTapContext = createContext<AssistantTapContextValue | null>(\n  null,\n);\n\nexport const withAssistantTapContextProvider = <TResult>(\n  value: AssistantTapContextValue,\n  fn: () => TResult,\n) => {\n  return withContextProvider(AssistantTapContext, value, fn);\n};\n\nconst tapAssistantTapContext = () => {\n  const ctx = tapContext(AssistantTapContext);\n  if (!ctx) throw new Error(\"AssistantTapContext is not available\");\n\n  return ctx;\n};\n\nexport const tapAssistantClientRef = () => {\n  return tapAssistantTapContext().clientRef;\n};\n\nexport const tapAssistantEmit = () => {\n  const { emit } = tapAssistantTapContext();\n  const clientStack = tapClientStack();\n\n  return tapEffectEvent(\n    <TEvent extends Exclude<AssistantEventName, \"*\">>(\n      event: TEvent,\n      payload: AssistantEventPayload[TEvent],\n    ) => {\n      emit(event, payload, clientStack);\n    },\n  );\n};\n"],"mappings":";AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAMP,SAAS,sBAAwC;AAajD,IAAM,sBAAsB;AAAA,EAC1B;AACF;AAEO,IAAM,kCAAkC,CAC7C,OACA,OACG;AACH,SAAO,oBAAoB,qBAAqB,OAAO,EAAE;AAC3D;AAEA,IAAM,yBAAyB,MAAM;AACnC,QAAM,MAAM,WAAW,mBAAmB;AAC1C,MAAI,CAAC,IAAK,OAAM,IAAI,MAAM,sCAAsC;AAEhE,SAAO;AACT;AAEO,IAAM,wBAAwB,MAAM;AACzC,SAAO,uBAAuB,EAAE;AAClC;AAEO,IAAM,mBAAmB,MAAM;AACpC,QAAM,EAAE,KAAK,IAAI,uBAAuB;AACxC,QAAM,cAAc,eAAe;AAEnC,SAAO;AAAA,IACL,CACE,OACA,YACG;AACH,WAAK,OAAO,SAAS,WAAW;AAAA,IAClC;AAAA,EACF;AACF;","names":[]}

package/dist/utils/tap-client-stack-context.d.ts

@@ -0,0 +1,23 @@
+import type { ClientMethods } from "../types/client";
+/**
+ * Symbol used to get the client index from a ClientProxy.
+ */
+export declare const SYMBOL_CLIENT_INDEX: unique symbol;
+/**
+ * Get the index of a client (its position in the client stack when created).
+ */
+export declare const getClientIndex: (client: ClientMethods) => number;
+/**
+ * The client stack - an array of clients representing the current hierarchy.
+ */
+export type ClientStack = readonly ClientMethods[];
+/**
+ * Get the current client stack inside a tap resource.
+ */
+export declare const tapClientStack: () => ClientStack;
+/**
+ * Execute a callback with a client pushed onto the stack.
+ * The stack is duplicated, not mutated.
+ */
+export declare const tapWithClientStack: <T>(client: ClientMethods, callback: () => T) => T;
+//# sourceMappingURL=tap-client-stack-context.d.ts.map

package/dist/utils/tap-client-stack-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tap-client-stack-context.d.ts","sourceRoot":"","sources":["../../src/utils/tap-client-stack-context.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,mBAAmB,eAA2C,CAAC;AAE5E;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,aAAa,KAAG,MAItD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,aAAa,EAAE,CAAC;AAInD;;GAEG;AACH,eAAO,MAAM,cAAc,QAAO,WAEjC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAAI,CAAC,EAClC,QAAQ,aAAa,EACrB,UAAU,MAAM,CAAC,KAChB,CAOF,CAAC"}

package/dist/utils/tap-client-stack-context.js

@@ -0,0 +1,30 @@
+// src/utils/tap-client-stack-context.ts
+import {
+  createContext,
+  tapContext,
+  withContextProvider,
+  tapMemo
+} from "@assistant-ui/tap";
+var SYMBOL_CLIENT_INDEX = /* @__PURE__ */ Symbol("assistant-ui.store.clientIndex");
+var getClientIndex = (client) => {
+  return client[SYMBOL_CLIENT_INDEX];
+};
+var ClientStackContext = createContext([]);
+var tapClientStack = () => {
+  return tapContext(ClientStackContext);
+};
+var tapWithClientStack = (client, callback) => {
+  const currentStack = tapClientStack();
+  const newStack = tapMemo(
+    () => [...currentStack, client],
+    [currentStack, client]
+  );
+  return withContextProvider(ClientStackContext, newStack, callback);
+};
+export {
+  SYMBOL_CLIENT_INDEX,
+  getClientIndex,
+  tapClientStack,
+  tapWithClientStack
+};
+//# sourceMappingURL=tap-client-stack-context.js.map

package/dist/utils/tap-client-stack-context.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/tap-client-stack-context.ts"],"sourcesContent":["import {\n  createContext,\n  tapContext,\n  withContextProvider,\n  tapMemo,\n} from \"@assistant-ui/tap\";\nimport type { ClientMethods } from \"../types/client\";\n\n/**\n * Symbol used to get the client index from a ClientProxy.\n */\nexport const SYMBOL_CLIENT_INDEX = Symbol(\"assistant-ui.store.clientIndex\");\n\n/**\n * Get the index of a client (its position in the client stack when created).\n */\nexport const getClientIndex = (client: ClientMethods): number => {\n  return (client as unknown as { [SYMBOL_CLIENT_INDEX]: number })[\n    SYMBOL_CLIENT_INDEX\n  ];\n};\n\n/**\n * The client stack - an array of clients representing the current hierarchy.\n */\nexport type ClientStack = readonly ClientMethods[];\n\nconst ClientStackContext = createContext<ClientStack>([]);\n\n/**\n * Get the current client stack inside a tap resource.\n */\nexport const tapClientStack = (): ClientStack => {\n  return tapContext(ClientStackContext);\n};\n\n/**\n * Execute a callback with a client pushed onto the stack.\n * The stack is duplicated, not mutated.\n */\nexport const tapWithClientStack = <T>(\n  client: ClientMethods,\n  callback: () => T,\n): T => {\n  const currentStack = tapClientStack();\n  const newStack = tapMemo(\n    () => [...currentStack, client],\n    [currentStack, client],\n  );\n  return withContextProvider(ClientStackContext, newStack, callback);\n};\n"],"mappings":";AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAMA,IAAM,sBAAsB,uBAAO,gCAAgC;AAKnE,IAAM,iBAAiB,CAAC,WAAkC;AAC/D,SAAQ,OACN,mBACF;AACF;AAOA,IAAM,qBAAqB,cAA2B,CAAC,CAAC;AAKjD,IAAM,iBAAiB,MAAmB;AAC/C,SAAO,WAAW,kBAAkB;AACtC;AAMO,IAAM,qBAAqB,CAChC,QACA,aACM;AACN,QAAM,eAAe,eAAe;AACpC,QAAM,WAAW;AAAA,IACf,MAAM,CAAC,GAAG,cAAc,MAAM;AAAA,IAC9B,CAAC,cAAc,MAAM;AAAA,EACvB;AACA,SAAO,oBAAoB,oBAAoB,UAAU,QAAQ;AACnE;","names":[]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@assistant-ui/store",
   "description": "Tap-based state management for @assistant-ui",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "license": "MIT",
   "type": "module",
   "exports": {
@@ -20,15 +20,15 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@assistant-ui/tap": "0.3.1"
+    "@assistant-ui/tap": "0.3.3"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0"
   },
   "devDependencies": {
-    "@types/node": "^24.10.1",
+    "@types/node": "^25.0.0",
     "@types/react": "19.2.7",
-    "tsx": "^4.20.6",
+    "tsx": "^4.21.0",
     "@assistant-ui/x-buildutils": "0.0.1"
   },
   "publishConfig": {
@@ -44,7 +44,6 @@
     "url": "https://github.com/assistant-ui/assistant-ui/issues"
   },
   "scripts": {
-    "build": "tsx scripts/build.mts",
-    "lint": "eslint ."
+    "build": "tsx scripts/build.mts"
   }
 }

package/src/AssistantIf.tsx

@@ -0,0 +1,17 @@
+"use client";
+
+import type { FC, PropsWithChildren } from "react";
+import { useAssistantState } from "./useAssistantState";
+import type { AssistantState } from "./types/client";
+
+export namespace AssistantIf {
+  export type Props = PropsWithChildren<{ condition: AssistantIf.Condition }>;
+  export type Condition = (state: AssistantState) => boolean;
+}
+
+export const AssistantIf: FC<AssistantIf.Props> = ({ children, condition }) => {
+  const result = useAssistantState(condition);
+  return result ? children : null;
+};
+
+AssistantIf.displayName = "AssistantIf";

package/src/Derived.ts

@@ -0,0 +1,46 @@
+import { resource, ResourceElement } from "@assistant-ui/tap";
+import type {
+  AssistantClient,
+  ClientNames,
+  AssistantClientAccessor,
+  ClientMeta,
+} from "./types/client";
+
+/**
+ * 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 = useAssistantClient({
+ *   message: Derived({
+ *     source: "thread",
+ *     query: { index: 0 },
+ *     get: (aui) => aui.thread().message({ index: 0 }),
+ *   }),
+ * });
+ * ```
+ */
+export const Derived = resource(
+  <K extends ClientNames>(_config: Derived.Props<K>): null => {
+    return null;
+  },
+);
+
+export type DerivedElement<K extends ClientNames> = ResourceElement<
+  null,
+  Derived.Props<K>
+>;
+
+export namespace Derived {
+  /**
+   * Props passed to a derived client resource element.
+   */
+  export type Props<K extends ClientNames> = {
+    get: (client: AssistantClient) => ReturnType<AssistantClientAccessor<K>>;
+  } & (ClientMeta<K> | { getMeta: (client: AssistantClient) => ClientMeta<K> });
+}