refactor: update host comm hook naming

Author: tsck

src/ui/hooks/index.ts

@@ -1,2 +1,2 @@
 export { useRenderData } from "./useRenderData.js";
-export { useUIActions } from "./useUIActions.js";
+export { useHostCommunication } from "./useHostCommunication.js";

src/ui/hooks/useUIActions.ts src/ui/hooks/useHostCommunication.tssrc/ui/hooks/useUIActions.ts renamed to src/ui/hooks/useHostCommunication.ts

@@ -4,8 +4,8 @@ interface SendMessageOptions {
     targetOrigin?: string;
 }
 
-/** Return type for the useUIActions hook */
-interface UseUIActionsResult {
+/** Return type for the useHostCommunication hook */
+interface UseHostCommunicationResult {
     /** Sends an intent message for the host to act on */
     intent: <T = unknown>(intent: string, params?: T) => void;
     /** Notifies the host of something that happened */
@@ -27,13 +27,13 @@ interface UseUIActionsResult {
  * @example
  * ```tsx
  * function MyComponent() {
- *   const { intent, tool, link } = useUIActions();
+ *   const { intent, tool, link } = useHostCommunication();
  *
  *   return <button onClick={() => intent("create-task", { title: "Buy groceries" })}>Create Task</button>;
  * }
  * ```
  */
-export function useUIActions(defaultOptions?: SendMessageOptions): UseUIActionsResult {
+export function useHostCommunication(defaultOptions?: SendMessageOptions): UseHostCommunicationResult {
     const targetOrigin = defaultOptions?.targetOrigin ?? "*";
 
     const intent = useCallback(
@@ -138,3 +138,4 @@ export function useUIActions(defaultOptions?: SendMessageOptions): UseUIActionsR
         [intent, notify, prompt, tool, link, reportSizeChange]
     );
 }
+

src/ui/hooks/useRenderData.ts

@@ -36,7 +36,7 @@ interface UseRenderDataResult<T> {
  *
  * function MyComponent() {
  *   const { data, isLoading, error, parentOrigin } = useRenderData<MyData>();
- *   const { intent } = useUIActions({ targetOrigin: parentOrigin ?? undefined });
+ *   const { intent } = useHostCommunication({ targetOrigin: parentOrigin ?? undefined });
  *   return <button onClick={() => intent("my-action")}>Click</button>;
  * }
  * ```

tests/unit/ui/useUIActions.test.ts …sts/unit/ui/useHostCommunication.test.tstests/unit/ui/useUIActions.test.ts renamed to tests/unit/ui/useHostCommunication.test.ts tests/unit/ui/useUIActions.test.ts renamed to tests/unit/ui/useHostCommunication.test.ts

@@ -1,9 +1,9 @@
 import { describe, it, expect, beforeEach, afterEach, vi, type Mock } from "vitest";
 import { createElement, type FunctionComponent } from "react";
 import { renderToString } from "react-dom/server";
-import { useUIActions } from "../../../src/ui/hooks/useUIActions.js";
+import { useHostCommunication } from "../../../src/ui/hooks/useHostCommunication.js";
 
-type UseUIActionsResult = ReturnType<typeof useUIActions>;
+type UseHostCommunicationResult = ReturnType<typeof useHostCommunication>;
 
 interface HookOptions {
     targetOrigin?: string;
@@ -13,11 +13,11 @@ interface HookOptions {
  * Simple hook testing utility that renders a component using the hook
  * and captures the result for assertions.
  */
-function testHook(options?: HookOptions): UseUIActionsResult {
-    let hookResult: UseUIActionsResult | undefined;
+function testHook(options?: HookOptions): UseHostCommunicationResult {
+    let hookResult: UseHostCommunicationResult | undefined;
 
     const TestComponent: FunctionComponent = () => {
-        hookResult = useUIActions(options);
+        hookResult = useHostCommunication(options);
         return null;
     };
 
@@ -30,7 +30,7 @@ function testHook(options?: HookOptions): UseUIActionsResult {
     return hookResult;
 }
 
-describe("useUIActions", () => {
+describe("useHostCommunication", () => {
     let postMessageMock: Mock;
     let originalWindow: typeof globalThis.window;
 
@@ -233,3 +233,4 @@ describe("useUIActions", () => {
         expect(postMessageMock).toHaveBeenCalledWith(expect.any(Object), "*");
     });
 });
+