@assistant-ui/store 0.2.2 → 0.2.4

package/dist/RenderChildrenWithAccessor.d.ts

@@ -0,0 +1,23 @@
+import { type ReactNode } from "react";
+import type { AssistantClient } from "./types/client.js";
+export declare const useGetItemAccessor: <T>(getItemState: (aui: AssistantClient) => T) => () => T;
+/**
+ * Component that sets up a lazy item accessor and memoizes propless children.
+ *
+ * For the common pattern where children returns a component without props
+ * (e.g. `<Foo />`), the output is memoized and not re-created on parent re-renders.
+ *
+ * @example
+ * ```tsx
+ * <RenderChildrenWithAccessor
+ *   getItemState={(aui) => aui.fooList().foo({ index }).getState()}
+ * >
+ *   {() => <Foo />}
+ * </RenderChildrenWithAccessor>
+ * ```
+ */
+export declare function RenderChildrenWithAccessor<T>({ getItemState, children, }: {
+    getItemState: (aui: AssistantClient) => T;
+    children: (getItem: () => T) => ReactNode;
+}): ReactNode;
+//# sourceMappingURL=RenderChildrenWithAccessor.d.ts.map

package/dist/RenderChildrenWithAccessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenderChildrenWithAccessor.d.ts","sourceRoot":"","sources":["../src/RenderChildrenWithAccessor.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAmB,MAAM,OAAO,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,0BAAuB;AAItD,eAAO,MAAM,kBAAkB,GAAI,CAAC,EAClC,cAAc,CAAC,GAAG,EAAE,eAAe,KAAK,CAAC,YAkB1C,CAAC;AAIF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,EAAE,EAC5C,YAAY,EACZ,QAAQ,GACT,EAAE;IACD,YAAY,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,CAAC,CAAC;IAC1C,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,SAAS,CAAC;CAC3C,GAAG,SAAS,CAGZ"}

package/dist/RenderChildrenWithAccessor.js

@@ -0,0 +1,53 @@
+"use client";
+import { useMemo, useRef } from "react";
+import { useAuiState } from "./useAuiState.js";
+import { useAui } from "./useAui.js";
+export const useGetItemAccessor = (getItemState) => {
+    const aui = useAui();
+    // if the consumer never accesses the item, do not trigger rerenders
+    const cacheRef = useRef(undefined);
+    useAuiState(() => {
+        if (cacheRef.current === undefined) {
+            cacheRef.current = getItemState(aui);
+        }
+        return cacheRef.current;
+    });
+    return () => {
+        cacheRef.current = undefined; // clear the cache (rerender on next state change)
+        return getItemState(aui);
+    };
+};
+const EMPTY_OBJECT = Object.freeze({});
+/**
+ * Component that sets up a lazy item accessor and memoizes propless children.
+ *
+ * For the common pattern where children returns a component without props
+ * (e.g. `<Foo />`), the output is memoized and not re-created on parent re-renders.
+ *
+ * @example
+ * ```tsx
+ * <RenderChildrenWithAccessor
+ *   getItemState={(aui) => aui.fooList().foo({ index }).getState()}
+ * >
+ *   {() => <Foo />}
+ * </RenderChildrenWithAccessor>
+ * ```
+ */
+export function RenderChildrenWithAccessor({ getItemState, children, }) {
+    const getItem = useGetItemAccessor(getItemState);
+    return useMemoizedProplessComponent(children(getItem));
+}
+const useMemoizedProplessComponent = (node) => {
+    const el = typeof node === "object" && node != null && "type" in node ? node : null;
+    const resultType = el?.type;
+    const resultKey = el?.key;
+    const resultProps = typeof el?.props === "object" &&
+        el.props != null &&
+        Object.entries(el.props).length === 0
+        ? EMPTY_OBJECT
+        : el?.props;
+    return (
+    // biome-ignore lint/correctness/useExhaustiveDependencies: optimization
+    useMemo(() => el, [resultType, resultKey, resultProps]) ?? node);
+};
+//# sourceMappingURL=RenderChildrenWithAccessor.js.map

package/dist/RenderChildrenWithAccessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenderChildrenWithAccessor.js","sourceRoot":"","sources":["../src/RenderChildrenWithAccessor.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAkB,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAExD,OAAO,EAAE,WAAW,EAAE,yBAAsB;AAC5C,OAAO,EAAE,MAAM,EAAE,oBAAiB;AAElC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,YAAyC,EACzC,EAAE;IACF,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IAErB,oEAAoE;IACpE,MAAM,QAAQ,GAAG,MAAM,CAAgB,SAAS,CAAC,CAAC;IAClD,WAAW,CAAC,GAAG,EAAE;QACf,IAAI,QAAQ,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACnC,QAAQ,CAAC,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,QAAQ,CAAC,OAAO,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,EAAE;QACV,QAAQ,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC,kDAAkD;QAEhF,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAEvC;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,0BAA0B,CAAI,EAC5C,YAAY,EACZ,QAAQ,GAIT;IACC,MAAM,OAAO,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC;IACjD,OAAO,4BAA4B,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,4BAA4B,GAAG,CAAC,IAAe,EAAE,EAAE;IACvD,MAAM,EAAE,GACN,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3E,MAAM,UAAU,GAAG,EAAE,EAAE,IAAI,CAAC;IAC5B,MAAM,SAAS,GAAG,EAAE,EAAE,GAAG,CAAC;IAC1B,MAAM,WAAW,GACf,OAAO,EAAE,EAAE,KAAK,KAAK,QAAQ;QAC7B,EAAE,CAAC,KAAK,IAAI,IAAI;QAChB,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC;QACnC,CAAC,CAAC,YAAY;QACd,CAAC,CAAC,EAAE,EAAE,KAAK,CAAC;IAEhB,OAAO;IACL,wEAAwE;IACxE,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,IAAI,IAAI,CAChE,CAAC;AACJ,CAAC,CAAC"}

package/dist/attachTransformScopes.d.ts

@@ -4,7 +4,7 @@ import type { DerivedElement } from "./Derived.js";
 export type ScopesConfig = {
     [K in ClientNames]?: ClientElement<K> | DerivedElement<K>;
 };
-type TransformScopesFn = (scopes: ScopesConfig, parent: AssistantClient) => ScopesConfig;
+type TransformScopesFn = (scopes: ScopesConfig, parent: AssistantClient) => void;
 export declare function attachTransformScopes<T extends (...args: any[]) => ResourceElement<any>>(resource: T, transform: TransformScopesFn): void;
 export declare function getTransformScopes<T extends (...args: any[]) => ResourceElement<any>>(resource: T): TransformScopesFn | undefined;
 export {};

package/dist/attachTransformScopes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attachTransformScopes.d.ts","sourceRoot":"","sources":["../src/attachTransformScopes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,WAAW,EACZ,0BAAuB;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAkB;AAIhD,MAAM,MAAM,YAAY,GAAG;KACxB,CAAC,IAAI,WAAW,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC;CAC1D,CAAC;AAEF,KAAK,iBAAiB,GAAG,CACvB,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,eAAe,KACpB,YAAY,CAAC;AAMlB,wBAAgB,qBAAqB,CACnC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,eAAe,CAAC,GAAG,CAAC,EAClD,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,iBAAiB,GAAG,IAAI,CAMjD;AAED,wBAAgB,kBAAkB,CAChC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,eAAe,CAAC,GAAG,CAAC,EAClD,QAAQ,EAAE,CAAC,GAAG,iBAAiB,GAAG,SAAS,CAE5C"}
+{"version":3,"file":"attachTransformScopes.d.ts","sourceRoot":"","sources":["../src/attachTransformScopes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,WAAW,EACZ,0BAAuB;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAkB;AAIhD,MAAM,MAAM,YAAY,GAAG;KACxB,CAAC,IAAI,WAAW,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC;CAC1D,CAAC;AAEF,KAAK,iBAAiB,GAAG,CACvB,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,eAAe,KACpB,IAAI,CAAC;AAMV,wBAAgB,qBAAqB,CACnC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,eAAe,CAAC,GAAG,CAAC,EAClD,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,iBAAiB,GAAG,IAAI,CAMjD;AAED,wBAAgB,kBAAkB,CAChC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,eAAe,CAAC,GAAG,CAAC,EAClD,QAAQ,EAAE,CAAC,GAAG,iBAAiB,GAAG,SAAS,CAE5C"}

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export { useAui } from "./useAui.js";
 export { useAuiState } from "./useAuiState.js";
 export { useAuiEvent } from "./useAuiEvent.js";
+export { RenderChildrenWithAccessor } from "./RenderChildrenWithAccessor.js";
 export { AuiIf } from "./AuiIf.js";
 export { AuiProvider } from "./utils/react-assistant-context.js";
 export { Derived } from "./Derived.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,oBAAiB;AAClC,OAAO,EAAE,WAAW,EAAE,yBAAsB;AAC5C,OAAO,EAAE,WAAW,EAAE,yBAAsB;AAG5C,OAAO,EAAE,KAAK,EAAE,mBAAgB;AAChC,OAAO,EAAE,WAAW,EAAE,2CAAwC;AAG9D,OAAO,EAAE,OAAO,EAAE,qBAAkB;AACpC,OAAO,EAAE,qBAAqB,EAAE,mCAAgC;AAChE,YAAY,EAAE,YAAY,EAAE,mCAAgC;AAG5D,OAAO,EACL,qBAAqB,EACrB,gBAAgB,GACjB,yCAAsC;AACvC,OAAO,EAAE,iBAAiB,EAAE,+BAA4B;AACxD,OAAO,EAAE,eAAe,EAAE,6BAA0B;AACpD,OAAO,EAAE,aAAa,EAAE,2BAAwB;AAGhD,YAAY,EACV,aAAa,EACb,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,UAAU,EACV,aAAa,EACb,WAAW,EACX,uBAAuB,EACvB,eAAe,EACf,cAAc,GACf,0BAAuB;AACxB,OAAO,EACL,sBAAsB,EACtB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,GACzB,0BAAuB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,oBAAiB;AAClC,OAAO,EAAE,WAAW,EAAE,yBAAsB;AAC5C,OAAO,EAAE,WAAW,EAAE,yBAAsB;AAC5C,OAAO,EAAE,0BAA0B,EAAE,wCAAqC;AAG1E,OAAO,EAAE,KAAK,EAAE,mBAAgB;AAChC,OAAO,EAAE,WAAW,EAAE,2CAAwC;AAG9D,OAAO,EAAE,OAAO,EAAE,qBAAkB;AACpC,OAAO,EAAE,qBAAqB,EAAE,mCAAgC;AAChE,YAAY,EAAE,YAAY,EAAE,mCAAgC;AAG5D,OAAO,EACL,qBAAqB,EACrB,gBAAgB,GACjB,yCAAsC;AACvC,OAAO,EAAE,iBAAiB,EAAE,+BAA4B;AACxD,OAAO,EAAE,eAAe,EAAE,6BAA0B;AACpD,OAAO,EAAE,aAAa,EAAE,2BAAwB;AAGhD,YAAY,EACV,aAAa,EACb,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,UAAU,EACV,aAAa,EACb,WAAW,EACX,uBAAuB,EACvB,eAAe,EACf,cAAc,GACf,0BAAuB;AACxB,OAAO,EACL,sBAAsB,EACtB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,GACzB,0BAAuB"}

package/dist/index.js

@@ -2,6 +2,7 @@
 export { useAui } from "./useAui.js";
 export { useAuiState } from "./useAuiState.js";
 export { useAuiEvent } from "./useAuiEvent.js";
+export { RenderChildrenWithAccessor } from "./RenderChildrenWithAccessor.js";
 // components
 export { AuiIf } from "./AuiIf.js";
 export { AuiProvider } from "./utils/react-assistant-context.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,QAAQ;AACR,OAAO,EAAE,MAAM,EAAE,oBAAiB;AAClC,OAAO,EAAE,WAAW,EAAE,yBAAsB;AAC5C,OAAO,EAAE,WAAW,EAAE,yBAAsB;AAE5C,aAAa;AACb,OAAO,EAAE,KAAK,EAAE,mBAAgB;AAChC,OAAO,EAAE,WAAW,EAAE,2CAAwC;AAE9D,YAAY;AACZ,OAAO,EAAE,OAAO,EAAE,qBAAkB;AACpC,OAAO,EAAE,qBAAqB,EAAE,mCAAgC;AAGhE,YAAY;AACZ,OAAO,EACL,qBAAqB,EACrB,gBAAgB,GACjB,yCAAsC;AACvC,OAAO,EAAE,iBAAiB,EAAE,+BAA4B;AACxD,OAAO,EAAE,eAAe,EAAE,6BAA0B;AACpD,OAAO,EAAE,aAAa,EAAE,2BAAwB;AAiBhD,OAAO,EACL,sBAAsB,GAMvB,0BAAuB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,QAAQ;AACR,OAAO,EAAE,MAAM,EAAE,oBAAiB;AAClC,OAAO,EAAE,WAAW,EAAE,yBAAsB;AAC5C,OAAO,EAAE,WAAW,EAAE,yBAAsB;AAC5C,OAAO,EAAE,0BAA0B,EAAE,wCAAqC;AAE1E,aAAa;AACb,OAAO,EAAE,KAAK,EAAE,mBAAgB;AAChC,OAAO,EAAE,WAAW,EAAE,2CAAwC;AAE9D,YAAY;AACZ,OAAO,EAAE,OAAO,EAAE,qBAAkB;AACpC,OAAO,EAAE,qBAAqB,EAAE,mCAAgC;AAGhE,YAAY;AACZ,OAAO,EACL,qBAAqB,EACrB,gBAAgB,GACjB,yCAAsC;AACvC,OAAO,EAAE,iBAAiB,EAAE,+BAA4B;AACxD,OAAO,EAAE,eAAe,EAAE,6BAA0B;AACpD,OAAO,EAAE,aAAa,EAAE,2BAAwB;AAiBhD,OAAO,EACL,sBAAsB,GAMvB,0BAAuB"}

package/dist/utils/splitClients.js

@@ -7,7 +7,7 @@ import { tapMemo } from "@assistant-ui/tap";
  */
 function splitClients(clients, baseClient) {
     // 1. Collect transforms from root elements and run them iteratively
-    let scopes = { ...clients };
+    const scopes = { ...clients };
     const visited = new Set();
     let changed = true;
     while (changed) {
@@ -20,7 +20,7 @@ function splitClients(clients, baseClient) {
             visited.add(clientElement.type);
             const transform = getTransformScopes(clientElement.type);
             if (transform) {
-                scopes = transform(scopes, baseClient);
+                transform(scopes, baseClient);
                 changed = true;
                 break; // restart iteration since scopes may have new root elements
             }

package/dist/utils/splitClients.js.map

@@ -1 +1 @@
-{"version":3,"file":"splitClients.js","sourceRoot":"","sources":["../../src/utils/splitClients.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAkB,sBAAmB;AAMrD,OAAO,EAAE,kBAAkB,EAAE,oCAAiC;AAE9D,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAS5C;;;GAGG;AACH,SAAS,YAAY,CAAC,OAAqB,EAAE,UAA2B;IACtE,oEAAoE;IACpE,IAAI,MAAM,GAAG,EAAE,GAAG,OAAO,EAGxB,CAAC;IACF,MAAM,OAAO,GAAG,IAAI,GAAG,EAA2B,CAAC;IAEnD,IAAI,OAAO,GAAG,IAAI,CAAC;IACnB,OAAO,OAAO,EAAE,CAAC;QACf,OAAO,GAAG,KAAK,CAAC;QAChB,KAAK,MAAM,aAAa,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YAClD,IAAI,aAAa,CAAC,IAAI,KAAM,OAAmB;gBAAE,SAAS;YAC1D,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC;gBAAE,SAAS;YAC9C,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;YAEhC,MAAM,SAAS,GAAG,kBAAkB,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;YACzD,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,UAAU,CAAkB,CAAC;gBACxD,OAAO,GAAG,IAAI,CAAC;gBACf,MAAM,CAAC,4DAA4D;YACrE,CAAC;QACH,CAAC;IACH,CAAC;IAED,oCAAoC;IACpC,MAAM,WAAW,GAAgB,EAAE,CAAC;IACpC,MAAM,cAAc,GAAmB,EAAE,CAAC;IAE1C,KAAK,MAAM,CAAC,GAAG,EAAE,aAAa,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAGrD,EAAE,CAAC;QACJ,IAAI,aAAa,CAAC,IAAI,KAAM,OAAmB,EAAE,CAAC;YAChD,cAAc,CAAC,GAAG,CAAC,GAAG,aAA4C,CAAC;QACrE,CAAC;aAAM,CAAC;YACN,WAAW,CAAC,GAAG,CAAC,GAAG,aAA2C,CAAC;QACjE,CAAC;IACH,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,CAAC;AACzC,CAAC;AAED,MAAM,oBAAoB,GAAG,CAAmB,MAAS,EAAE,EAAE;IAC3D,wEAAwE;IACxE,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AACnE,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,OAAqB,EACrB,UAA2B,EAC3B,EAAE;IACF,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAE1E,OAAO;QACL,WAAW,EAAE,oBAAoB,CAAC,WAAW,CAAC;QAC9C,cAAc,EAAE,oBAAoB,CAAC,cAAc,CAAC;KACrD,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"splitClients.js","sourceRoot":"","sources":["../../src/utils/splitClients.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAkB,sBAAmB;AAMrD,OAAO,EAAE,kBAAkB,EAAE,oCAAiC;AAE9D,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAS5C;;;GAGG;AACH,SAAS,YAAY,CAAC,OAAqB,EAAE,UAA2B;IACtE,oEAAoE;IACpE,MAAM,MAAM,GAAG,EAAE,GAAG,OAAO,EAG1B,CAAC;IACF,MAAM,OAAO,GAAG,IAAI,GAAG,EAA2B,CAAC;IAEnD,IAAI,OAAO,GAAG,IAAI,CAAC;IACnB,OAAO,OAAO,EAAE,CAAC;QACf,OAAO,GAAG,KAAK,CAAC;QAChB,KAAK,MAAM,aAAa,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YAClD,IAAI,aAAa,CAAC,IAAI,KAAM,OAAmB;gBAAE,SAAS;YAC1D,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC;gBAAE,SAAS;YAC9C,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;YAEhC,MAAM,SAAS,GAAG,kBAAkB,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;YACzD,IAAI,SAAS,EAAE,CAAC;gBACd,SAAS,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;gBAC9B,OAAO,GAAG,IAAI,CAAC;gBACf,MAAM,CAAC,4DAA4D;YACrE,CAAC;QACH,CAAC;IACH,CAAC;IAED,oCAAoC;IACpC,MAAM,WAAW,GAAgB,EAAE,CAAC;IACpC,MAAM,cAAc,GAAmB,EAAE,CAAC;IAE1C,KAAK,MAAM,CAAC,GAAG,EAAE,aAAa,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAGrD,EAAE,CAAC;QACJ,IAAI,aAAa,CAAC,IAAI,KAAM,OAAmB,EAAE,CAAC;YAChD,cAAc,CAAC,GAAG,CAAC,GAAG,aAA4C,CAAC;QACrE,CAAC;aAAM,CAAC;YACN,WAAW,CAAC,GAAG,CAAC,GAAG,aAA2C,CAAC;QACjE,CAAC;IACH,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,CAAC;AACzC,CAAC;AAED,MAAM,oBAAoB,GAAG,CAAmB,MAAS,EAAE,EAAE;IAC3D,wEAAwE;IACxE,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AACnE,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,OAAqB,EACrB,UAA2B,EAC3B,EAAE;IACF,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAE1E,OAAO;QACL,WAAW,EAAE,oBAAoB,CAAC,WAAW,CAAC;QAC9C,cAAc,EAAE,oBAAoB,CAAC,cAAc,CAAC;KACrD,CAAC;AACJ,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@assistant-ui/store",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Tap-based state management for @assistant-ui",
   "keywords": [
     "state-management",
@@ -31,7 +31,7 @@
     "use-effect-event": "^2.0.3"
   },
   "peerDependencies": {
-    "@assistant-ui/tap": "^0.5.2",
+    "@assistant-ui/tap": "^0.5.4",
     "@types/react": "*",
     "react": "^18 || ^19"
   },
@@ -44,11 +44,11 @@
     "@testing-library/react": "^16.3.2",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
-    "jsdom": "^28.1.0",
+    "jsdom": "^29.0.1",
     "react": "^19.2.4",
-    "vitest": "^4.0.18",
-    "@assistant-ui/tap": "0.5.2",
-    "@assistant-ui/x-buildutils": "0.0.1"
+    "vitest": "^4.1.0",
+    "@assistant-ui/tap": "0.5.4",
+    "@assistant-ui/x-buildutils": "0.0.3"
   },
   "publishConfig": {
     "access": "public",

package/src/RenderChildrenWithAccessor.tsx

@@ -0,0 +1,73 @@
+"use client";
+
+import { type ReactNode, useMemo, useRef } from "react";
+import type { AssistantClient } from "./types/client";
+import { useAuiState } from "./useAuiState";
+import { useAui } from "./useAui";
+
+export const useGetItemAccessor = <T,>(
+  getItemState: (aui: AssistantClient) => T,
+) => {
+  const aui = useAui();
+
+  // if the consumer never accesses the item, do not trigger rerenders
+  const cacheRef = useRef<T | undefined>(undefined);
+  useAuiState(() => {
+    if (cacheRef.current === undefined) {
+      cacheRef.current = getItemState(aui);
+    }
+    return cacheRef.current;
+  });
+
+  return () => {
+    cacheRef.current = undefined; // clear the cache (rerender on next state change)
+
+    return getItemState(aui);
+  };
+};
+
+const EMPTY_OBJECT = Object.freeze({});
+
+/**
+ * Component that sets up a lazy item accessor and memoizes propless children.
+ *
+ * For the common pattern where children returns a component without props
+ * (e.g. `<Foo />`), the output is memoized and not re-created on parent re-renders.
+ *
+ * @example
+ * ```tsx
+ * <RenderChildrenWithAccessor
+ *   getItemState={(aui) => aui.fooList().foo({ index }).getState()}
+ * >
+ *   {() => <Foo />}
+ * </RenderChildrenWithAccessor>
+ * ```
+ */
+export function RenderChildrenWithAccessor<T>({
+  getItemState,
+  children,
+}: {
+  getItemState: (aui: AssistantClient) => T;
+  children: (getItem: () => T) => ReactNode;
+}): ReactNode {
+  const getItem = useGetItemAccessor(getItemState);
+  return useMemoizedProplessComponent(children(getItem));
+}
+
+const useMemoizedProplessComponent = (node: ReactNode) => {
+  const el =
+    typeof node === "object" && node != null && "type" in node ? node : null;
+  const resultType = el?.type;
+  const resultKey = el?.key;
+  const resultProps =
+    typeof el?.props === "object" &&
+    el.props != null &&
+    Object.entries(el.props).length === 0
+      ? EMPTY_OBJECT
+      : el?.props;
+
+  return (
+    // biome-ignore lint/correctness/useExhaustiveDependencies: optimization
+    useMemo(() => el, [resultType, resultKey, resultProps]) ?? node
+  );
+};

package/src/attachTransformScopes.ts

@@ -15,7 +15,7 @@ export type ScopesConfig = {
 type TransformScopesFn = (
   scopes: ScopesConfig,
   parent: AssistantClient,
-) => ScopesConfig;
+) => void;
 
 type ResourceWithTransformScopes = {
   [TRANSFORM_SCOPES]?: TransformScopesFn;

package/src/index.ts

@@ -2,6 +2,7 @@
 export { useAui } from "./useAui";
 export { useAuiState } from "./useAuiState";
 export { useAuiEvent } from "./useAuiEvent";
+export { RenderChildrenWithAccessor } from "./RenderChildrenWithAccessor";
 
 // components
 export { AuiIf } from "./AuiIf";

package/src/utils/splitClients.ts

@@ -21,7 +21,7 @@ export type DerivedClients = Partial<
  */
 function splitClients(clients: useAui.Props, baseClient: AssistantClient) {
   // 1. Collect transforms from root elements and run them iteratively
-  let scopes = { ...clients } as Record<
+  const scopes = { ...clients } as Record<
     string,
     ClientElement<ClientNames> | DerivedElement<ClientNames>
   >;
@@ -37,7 +37,7 @@ function splitClients(clients: useAui.Props, baseClient: AssistantClient) {
 
       const transform = getTransformScopes(clientElement.type);
       if (transform) {
-        scopes = transform(scopes, baseClient) as typeof scopes;
+        transform(scopes, baseClient);
         changed = true;
         break; // restart iteration since scopes may have new root elements
       }