@easyops-cn/a2ui-react 0.0.0 → 0.0.2

package/dist/0.8/hooks/useA2UIMessageHandler.d.ts

@@ -0,0 +1,41 @@
+import { A2UIMessage } from '../types';
+/**
+ * Return type for the message handler hook.
+ */
+export interface A2UIMessageHandler {
+    /** Processes a single A2UI message */
+    processMessage: (message: A2UIMessage) => void;
+    /** Processes multiple A2UI messages */
+    processMessages: (messages: A2UIMessage[]) => void;
+    /** Clears all surfaces and data models */
+    clear: () => void;
+}
+/**
+ * Hook that returns functions to process A2UI messages.
+ *
+ * @returns Object with processMessage, processMessages, and clear functions
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const { processMessage, processMessages, clear } = useA2UIMessageHandler();
+ *
+ *   useEffect(() => {
+ *     // Process initial messages
+ *     processMessages(initialMessages);
+ *
+ *     // Listen for SSE updates
+ *     const handler = (event) => {
+ *       processMessage(event.detail.message);
+ *     };
+ *     window.addEventListener('a2ui-message', handler);
+ *
+ *     return () => {
+ *       window.removeEventListener('a2ui-message', handler);
+ *       clear();
+ *     };
+ *   }, []);
+ * }
+ * ```
+ */
+export declare function useA2UIMessageHandler(): A2UIMessageHandler;

package/dist/0.8/hooks/useA2UIMessageHandler.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * useA2UIMessageHandler Tests
+ *
+ * Tests for the useA2UIMessageHandler hook.
+ */
+export {};

package/{src/0.8/hooks/useComponent.ts → dist/0.8/hooks/useComponent.d.ts}

@@ -1,11 +1,4 @@
-/**
- * useComponent - Hook to get a component from a Surface.
- */
-
-import { useMemo } from 'react'
-import type { ComponentDefinition } from '../types'
-import { useSurfaceContext } from '../contexts/SurfaceContext'
-
+import { ComponentDefinition } from '../types';
 /**
  * Gets a component from a Surface by its ID.
  *
@@ -27,13 +20,4 @@ import { useSurfaceContext } from '../contexts/SurfaceContext'
  * }
  * ```
  */
-export function useComponent(
-  surfaceId: string,
-  componentId: string
-): ComponentDefinition | undefined {
-  const { getComponent } = useSurfaceContext()
-
-  return useMemo(() => {
-    return getComponent(surfaceId, componentId)
-  }, [getComponent, surfaceId, componentId])
-}
+export declare function useComponent(surfaceId: string, componentId: string): ComponentDefinition | undefined;

package/dist/0.8/hooks/useComponent.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * useComponent Tests
+ *
+ * Tests for the useComponent hook.
+ */
+export {};

package/dist/0.8/hooks/useDataBinding.d.ts

@@ -0,0 +1,50 @@
+import { ValueSource, DataModel } from '../types';
+/**
+ * Resolves a ValueSource to its actual value.
+ *
+ * @param surfaceId - The surface ID for data model lookup
+ * @param source - The value source (literal or path reference)
+ * @param defaultValue - Default value if source is undefined or path not found
+ * @returns The resolved value
+ *
+ * @example
+ * ```tsx
+ * function TextComponent({ surfaceId, text }) {
+ *   const textValue = useDataBinding<string>(surfaceId, text, '');
+ *   return <span>{textValue}</span>;
+ * }
+ * ```
+ */
+export declare function useDataBinding<T = unknown>(surfaceId: string, source: ValueSource | undefined, defaultValue?: T): T;
+/**
+ * Gets the full data model for a surface.
+ * Useful for components that need access to multiple values.
+ *
+ * @param surfaceId - The surface ID
+ * @returns The data model for this surface
+ */
+export declare function useDataModel(surfaceId: string): DataModel;
+/**
+ * Hook for two-way data binding in form components.
+ * Returns both the current value and a setter function.
+ *
+ * @param surfaceId - The surface ID
+ * @param source - The value source (must be a path reference for setting)
+ * @param defaultValue - Default value if not found
+ * @returns Tuple of [value, setValue]
+ *
+ * @example
+ * ```tsx
+ * function TextFieldComponent({ surfaceId, text }) {
+ *   const [value, setValue] = useFormBinding<string>(surfaceId, text, '');
+ *
+ *   return (
+ *     <input
+ *       value={value}
+ *       onChange={(e) => setValue(e.target.value)}
+ *     />
+ *   );
+ * }
+ * ```
+ */
+export declare function useFormBinding<T = unknown>(surfaceId: string, source: ValueSource | undefined, defaultValue?: T): [T, (value: T) => void];

package/dist/0.8/hooks/useDataBinding.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * useDataBinding Tests
+ *
+ * Tests for the useDataBinding, useDataModel, and useFormBinding hooks.
+ */
+export {};

package/{src/0.8/hooks/useDispatchAction.ts → dist/0.8/hooks/useDispatchAction.d.ts}

@@ -1,10 +1,4 @@
-/**
- * useDispatchAction - Hook for dispatching actions from components.
- */
-
-import type { Action } from '../types'
-import { useActionContext } from '../contexts/ActionContext'
-
+import { Action } from '../types';
 /**
  * Returns a function to dispatch actions.
  *
@@ -25,11 +19,4 @@ import { useActionContext } from '../contexts/ActionContext'
  * }
  * ```
  */
-export function useDispatchAction(): (
-  surfaceId: string,
-  componentId: string,
-  action: Action
-) => void {
-  const { dispatchAction } = useActionContext()
-  return dispatchAction
-}
+export declare function useDispatchAction(): (surfaceId: string, componentId: string, action: Action) => void;

package/dist/0.8/hooks/useDispatchAction.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * useDispatchAction Tests
+ *
+ * Tests for the useDispatchAction hooks.
+ */
+export {};

package/{src/0.8/hooks/useSurface.ts → dist/0.8/hooks/useSurface.d.ts}

@@ -1,11 +1,4 @@
-/**
- * useSurface - Hook to get a Surface by ID.
- */
-
-import { useMemo } from 'react'
-import type { Surface } from '../types'
-import { useSurfaceContext } from '../contexts/SurfaceContext'
-
+import { Surface } from '../types';
 /**
  * Gets a Surface by its ID.
  *
@@ -25,10 +18,4 @@ import { useSurfaceContext } from '../contexts/SurfaceContext'
  * }
  * ```
  */
-export function useSurface(surfaceId: string): Surface | undefined {
-  const { surfaces } = useSurfaceContext()
-
-  return useMemo(() => {
-    return surfaces.get(surfaceId)
-  }, [surfaces, surfaceId])
-}
+export declare function useSurface(surfaceId: string): Surface | undefined;

package/dist/0.8/hooks/useSurface.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * useSurface Tests
+ *
+ * Tests for the useSurface hook.
+ */
+export {};

package/{src/0.8/index.ts → dist/0.8/index.d.ts}

@@ -6,33 +6,19 @@
  *
  * @example
  * ```tsx
- * import { A2UIRender, A2UIMessage, A2UIAction } from '@easyops-cn/a2ui-react/0.8'
+ * import { A2UIRenderer, A2UIMessage, A2UIAction } from '@easyops-cn/a2ui-react/0.8'
  *
  * function App() {
  *   const messages: A2UIMessage[] = [...]
  *   const handleAction = (action: A2UIAction) => {
  *     console.log('Action:', action)
  *   }
- *   return <A2UIRender messages={messages} onAction={handleAction} />
+ *   return <A2UIRenderer messages={messages} onAction={handleAction} />
  * }
  * ```
  */
-
-// ============ Types ============
-
-export type {
-  A2UIMessage,
-  ActionPayload as A2UIAction,
-  Action,
-  ValueSource,
-} from './types'
-
-// ============ Components ============
-
-export { A2UIRender } from './A2UIRender'
-export { ComponentRenderer } from './components/ComponentRenderer'
-
-// ============ Hooks ============
-
-export { useDispatchAction } from './hooks/useDispatchAction'
-export { useDataBinding, useFormBinding } from './hooks/useDataBinding'
+export type { A2UIMessage, ActionPayload as A2UIAction, Action, ValueSource, } from './types';
+export { A2UIRenderer } from './A2UIRenderer';
+export { ComponentRenderer } from './components/ComponentRenderer';
+export { useDispatchAction } from './hooks/useDispatchAction';
+export { useDataBinding, useFormBinding } from './hooks/useDataBinding';