@bikdotai/bik-component-library 0.0.783-beta.9 → 0.0.783

package/dist/esm/components/WhatsAppTextEditor/WhatsAppTextEditor.d.ts

@@ -1,9 +1,46 @@
 import React from 'react';
-import { EditorActionTypes } from './WhatsAppTextEditorHeader';
+import type { ApiRequestExecutor } from '../bik-chatbot/types';
+import type { APIAdapter } from '../bik-chatbot/types/ai';
+import { AIActionPromptConfig, AIActionPromptRegistry, TemplateType } from './ai/actionRegistry';
+import { AITagPayload } from './ai/aiTag';
+import { AIActionToneOption, AIActionVariant, AIEditorActionType, AIEditorActionTypes, EditorActionTypes, WhatsAppEditorRightSlotProps } from './WhatsAppTextEditorHeader';
+type AIEventName = 'ai_action_triggered' | 'ai_feedback_submitted' | 'ai_suggestion_accepted' | 'ai_suggestion_discarded' | 'ai_suggestion_edited' | 'ai_instruction_used';
+declare enum AIFeedbackRating {
+    LIKE = "like",
+    DISLIKE = "dislike"
+}
+type AIEventPayload = {
+    action_type: AIEditorActionType;
+    template_id?: string | number;
+    template_category?: TemplateType;
+    rating?: AIFeedbackRating;
+    candidate_index?: number;
+    instruction_text?: string;
+};
+type AIActionRequestPayload = {
+    actionType: AIEditorActionType;
+    actionVariant?: AIActionVariant;
+    currentText: string;
+    templateType: TemplateType;
+    toneId?: string;
+    toneLabel?: string;
+    instructionText?: string;
+    prompt: string;
+};
+type AIActionPromptBuildPayload = {
+    actionType: AIEditorActionType;
+    actionVariant?: AIActionVariant;
+    currentText: string;
+    templateType: TemplateType;
+    config: AIActionPromptConfig;
+    toneId?: string;
+    toneLabel?: string;
+    instructionText?: string;
+};
 export type CustomEditorProps = React.TextareaHTMLAttributes<HTMLTextAreaElement> & {
     onChange?: (text: string, html: string) => void;
     text?: string;
-    RightComponent?: React.FC;
+    RightComponent?: React.ComponentType<WhatsAppEditorRightSlotProps>;
     error?: string;
     limit?: number;
     rows?: number;
@@ -13,6 +50,49 @@ export type CustomEditorProps = React.TextareaHTMLAttributes<HTMLTextAreaElement
      */
     onError?: (err: string) => void;
     onClickVariable?: (variable: string) => void;
+    editorInstanceKey?: string;
+    editorSessionId?: string;
+    templateType?: TemplateType;
+    templateId?: string | number;
+    requestExecutor?: ApiRequestExecutor;
+    baseUrl?: string;
+    endpointPath?: string;
+    useCase?: string;
+    storeId?: string;
+    apiAdapter?: APIAdapter;
+    conversationId?: string;
+    systemId?: string;
+    intent?: string;
+    enabledAIActions?: AIEditorActionType[];
+    disableBuiltInAIActions?: boolean;
+    promptOverrides?: AIActionPromptRegistry;
+    rephraseTones?: AIActionToneOption[];
+    aiActionMinChars?: Partial<Record<AIEditorActionType, number>>;
+    instructionSuggestions?: string[];
+    onAnalyticsEvent?: (name: AIEventName, payload: AIEventPayload) => void;
+    /**
+     * Fires on AI-tag computations:
+     * - `source: "accept"` after accepting a suggestion (addition check: >=50% => true)
+     * - `source: "post_edit_debounce"` after edit idle/blur (retention check: <50% => true)
+     * Persist `payload.isAiTagged` (or full payload) in host state and send on save.
+     */
+    onAITagComputed?: (payload: AITagPayload) => void;
+    /**
+     * When true, the editor body was loaded as fully AI-generated (prefill).
+     * The first accepted suggestion will set `initialAiPrefillPhase` on the tag payload;
+     * after that, only baseline vs accepted comparison applies.
+     */
+    prefillWasAiGenerated?: boolean;
+    /**
+     * Optional label above the editor (e.g. section title from the host).
+     * When omitted, the left side of that top row is empty; limit/error stay on the right.
+     */
+    editorHeader?: React.ReactNode;
+    onAIToneSelect?: (actionType: AIEditorActionType, toneId: string) => void;
+    onAIActionRequest?: (payload: AIActionRequestPayload) => Promise<string | {
+        body?: string;
+    }>;
+    onBuildAIPrompt?: (payload: AIActionPromptBuildPayload) => string;
 };
 export type CustomEditorRef = {
     addTextOrWrap: (textToAdd: string) => {
@@ -29,7 +109,7 @@ export type CustomEditorRef = {
 export declare const WhatsAppTextEditor: React.ForwardRefExoticComponent<React.TextareaHTMLAttributes<HTMLTextAreaElement> & {
     onChange?: ((text: string, html: string) => void) | undefined;
     text?: string | undefined;
-    RightComponent?: React.FC<{}> | undefined;
+    RightComponent?: React.ComponentType<WhatsAppEditorRightSlotProps> | undefined;
     error?: string | undefined;
     limit?: number | undefined;
     rows?: number | undefined;
@@ -39,4 +119,49 @@ export declare const WhatsAppTextEditor: React.ForwardRefExoticComponent<React.T
      */
     onError?: ((err: string) => void) | undefined;
     onClickVariable?: ((variable: string) => void) | undefined;
+    editorInstanceKey?: string | undefined;
+    editorSessionId?: string | undefined;
+    templateType?: string | undefined;
+    templateId?: string | number | undefined;
+    requestExecutor?: ApiRequestExecutor | undefined;
+    baseUrl?: string | undefined;
+    endpointPath?: string | undefined;
+    useCase?: string | undefined;
+    storeId?: string | undefined;
+    apiAdapter?: APIAdapter | undefined;
+    conversationId?: string | undefined;
+    systemId?: string | undefined;
+    intent?: string | undefined;
+    enabledAIActions?: AIEditorActionTypes[] | undefined;
+    disableBuiltInAIActions?: boolean | undefined;
+    promptOverrides?: Partial<Record<AIEditorActionTypes, AIActionPromptConfig>> | undefined;
+    rephraseTones?: AIActionToneOption[] | undefined;
+    aiActionMinChars?: Partial<Record<AIEditorActionTypes, number>> | undefined;
+    instructionSuggestions?: string[] | undefined;
+    onAnalyticsEvent?: ((name: AIEventName, payload: AIEventPayload) => void) | undefined;
+    /**
+     * Fires on AI-tag computations:
+     * - `source: "accept"` after accepting a suggestion (addition check: >=50% => true)
+     * - `source: "post_edit_debounce"` after edit idle/blur (retention check: <50% => true)
+     * Persist `payload.isAiTagged` (or full payload) in host state and send on save.
+     */
+    onAITagComputed?: ((payload: AITagPayload) => void) | undefined;
+    /**
+     * When true, the editor body was loaded as fully AI-generated (prefill).
+     * The first accepted suggestion will set `initialAiPrefillPhase` on the tag payload;
+     * after that, only baseline vs accepted comparison applies.
+     */
+    prefillWasAiGenerated?: boolean | undefined;
+    /**
+     * Optional label above the editor (e.g. section title from the host).
+     * When omitted, the left side of that top row is empty; limit/error stay on the right.
+     */
+    editorHeader?: React.ReactNode;
+    onAIToneSelect?: ((actionType: AIEditorActionType, toneId: string) => void) | undefined;
+    onAIActionRequest?: ((payload: AIActionRequestPayload) => Promise<string | {
+        body?: string;
+    }>) | undefined;
+    onBuildAIPrompt?: ((payload: AIActionPromptBuildPayload) => string) | undefined;
 } & React.RefAttributes<CustomEditorRef>>;
+export type { AITagPayload } from './ai/aiTag';
+export { AI_TAG_CHANGE_RATIO_THRESHOLD, computeAiTagOnAccept, levenshteinDistance, } from './ai/aiTag';