hanbiro-react16-sdk 1.0.11 → 1.0.13

package/README.md

@@ -166,8 +166,67 @@ angular.module('myApp').directive('chatAiDraft', function() {
 
 ---
 
+## ChatAIDraft — Imperative API (Ref)
+
+`ChatAIDraft` exposes `setAIContext` via ref, allowing you to programmatically set the HTML content of the **AI Context** editor inside the Settings panel.
+
+```ts
+interface ChatAIDraftRef {
+  setAIContext: (html: string) => void;
+}
+```
+
+### React 18 / React 16.8+ (useRef)
+
+```tsx
+import React, { useRef } from 'react';
+import { ChatAIDraft } from 'hanbiro-react16-sdk/components';
+
+function MailComposer() {
+  const chatRef = useRef<ChatAIDraft>(null);
+
+  const handleOpenAI = () => {
+    chatRef.current?.setAIContext('<p>Original email content...</p>');
+  };
+
+  return (
+    <>
+      <button onClick={handleOpenAI}>Open AI</button>
+      <ChatAIDraft
+        ref={chatRef}
+        onApply={(params) => console.log(params.html)}
+      />
+    </>
+  );
+}
+```
+
+### AngularJS / UMD (callback ref)
+
+```js
+let chatAIInstance = null;
+
+ReactDOM.render(
+  React.createElement(HanbiroReact16SDK.ChatAIDraft, {
+    ref: function(instance) { chatAIInstance = instance; },
+    onApply: function(result) { /* ... */ },
+  }),
+  document.getElementById('chat-ai-container')
+);
+
+// Call anytime — e.g. when opening the AI panel
+function setEmailContext(html) {
+  if (chatAIInstance) {
+    chatAIInstance.setAIContext(html);
+  }
+}
+```
+
+---
+
 ## Development Commands
 
+
 - Run playground locally: `npm run dev`
 - Build library for production: `npm run build`
 - Build playground for production: `npm run build:playground`

package/dist/components/ChatAIDraft/index.d.ts

@@ -6,6 +6,10 @@ export interface AIPaneProps {
         html: string;
     }) => void;
 }
+/** Public imperative API exposed via ref */
+export interface ChatAIDraftRef {
+    setAIContext: (html: string) => void;
+}
 export interface AIMessage {
     id: string;
     question: string;
@@ -22,10 +26,10 @@ interface AIPaneState {
     conversationId: string;
     originalEmail: string;
 }
-declare class ChatAIDraft extends React.Component<AIPaneProps, AIPaneState> {
+declare class ChatAIDraft extends React.Component<AIPaneProps, AIPaneState> implements ChatAIDraftRef {
     private rootRef;
     constructor(props: AIPaneProps);
-    setAiContext: (nVal: string) => void;
+    setAIContext: (html: string) => void;
     handleMessageChange: (e: React.ChangeEvent<HTMLTextAreaElement>) => void;
     handleSubmit: () => Promise<void>;
     handleKeyDown: (event: React.KeyboardEvent<HTMLTextAreaElement>) => void;

package/dist/components/index.d.ts

@@ -1,4 +1,4 @@
-export { default as ChatAIDraft } from './ChatAIDraft';
+export { default as ChatAIDraft, type ChatAIDraftRef } from './ChatAIDraft';
 export { default as LoadingCircular } from './LoadingCircular';
 export { default as LoadingContainer } from './LoadingContainer';
 export { default as Tooltip } from './Tooltip';