@assistant-ui/store 0.2.2 → 0.2.3

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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@assistant-ui/store",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "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.3",
     "@types/react": "*",
     "react": "^18 || ^19"
   },
@@ -46,9 +46,9 @@
     "@types/react-dom": "^19.2.3",
     "jsdom": "^28.1.0",
     "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.3",
+    "@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/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";