/* eslint-disable @typescript-eslint/no-explicit-any */
import {ComposerOptions, DisplayOptions, EventsConfig, RemixComposerOptions, StandardChatAdapter} from '@nlux/core'
import {ChatAdapterBuilder} from '@shared/types/adapters/chat/chatAdapterBuilder'
import {ChatItem} from '@shared/types/conversation'
import {ReactNode} from 'react'
import {ChatAdapter} from '../types/chatAdapter'
import {ConversationOptions} from '../types/conversationOptions'
import {AiChatApi} from './hooks/useAiChatApi'
import {MessageOptions} from './messageOptions'
import {PersonaOptions} from './personaOptions'

/**
 * Props for the AiChat React component.
 */
export type AiChatProps<AiMsg = string> = {
    /**
     * The chat adapter to use. This is required and essential for the component to work.
     * You can either provide a standard adapter from @nlux or create a custom adapter.
     */
    adapter: ChatAdapter<AiMsg> | StandardChatAdapter<AiMsg> | ChatAdapterBuilder<AiMsg>;

    /**
     * The API to use for submitting messages. This is use for an imperative control of the chat,
     * to perform actions such as submitting messages from outside the chat.
     */
    api?: AiChatApi;

    /**
     * A map of event handlers.
     */
    events?: EventsConfig<AiMsg>;

    /**
     * The class name to add to the root element of the component.
     */
    className?: string;

    /**
     * The initial conversation history to display.
     * This is not a reactive prop! Changing it after the component is mounted will not update the conversation.
     */
    initialConversation?: ChatItem<AiMsg>[];

    /**
     * Display options, such as color scheme, width, etc.
     */
    displayOptions?: DisplayOptions;

    /**
     * Options for the conversation.
     */
    conversationOptions?: ConversationOptions;

    /**
     * Options related to a single message in the conversation.
     */
    messageOptions?: MessageOptions<AiMsg>;

    /**
     * Options for the composer.
     */
    composerOptions?: RemixComposerOptions

    /**
     * Function to add context files to the chat.
     * This is used to provide file context to the AI model.
     */
    addContextFiles?: (pluginName: any, methodName: string, payload?: { context: 'currentFile' | 'workspace'|'openedFiles' | 'none', files?: Array<string> }) => Promise<any>

    /**
     * Function to track sentiment on matomo.
     */
    trackSentiment?: (sentiment: string) => void

    /**
     * Options for the persona.
     */
    personaOptions?: PersonaOptions;

    /**
     * The children of the component, in case you want to render something inside the chat.
     * Only NLUX UI overrides are accepted at this stage.
     */
    children?: ReactNode | undefined
};