;
+}
+
+/**
+ * The props that are passed to a dialog component.
+ */
+export interface DialogProps {
+ /**
+ * The payload that was passed when the dialog was opened.
+ */
+ payload: P;
+ /**
+ * Whether the dialog is open.
+ */
+ open: boolean;
+ /**
+ * A function to call when the dialog should be closed. If the dialog has a return
+ * value, it should be passed as an argument to this function. You should use the promise
+ * that is returned to show a loading state while the dialog is performing async actions
+ * on close.
+ * @param result The result to return from the dialog.
+ * @returns A promise that resolves when the dialog can be fully closed.
+ */
+ onClose: (result: R) => Promise;
+}
+
+export type DialogComponent = React.ComponentType>;
+
+export interface OpenDialog {
+ /**
+ * Open a dialog without payload.
+ * @param Component The dialog component to open.
+ * @param options Additional options for the dialog.
+ */
+ (
+ Component: DialogComponent,
+ payload?: P,
+ options?: OpenDialogOptions,
+ ): Promise;
+ /**
+ * Open a dialog and pass a payload.
+ * @param Component The dialog component to open.
+ * @param payload The payload to pass to the dialog.
+ * @param options Additional options for the dialog.
+ */
+ (
+ Component: DialogComponent,
+ payload: P,
+ options?: OpenDialogOptions,
+ ): Promise;
+}
+
+export interface CloseDialog {
+ /**
+ * Close a dialog and return a result.
+ * @param dialog The dialog to close. The promise returned by `open`.
+ * @param result The result to return from the dialog.
+ * @returns A promise that resolves when the dialog is fully closed.
+ */
+ (dialog: Promise, result: R): Promise;
+}
+
+export interface ConfirmOptions extends OpenDialogOptions {
+ /**
+ * A title for the dialog. Defaults to `'Confirm'`.
+ */
+ title?: React.ReactNode;
+ /**
+ * The text to show in the "Ok" button. Defaults to `'Ok'`.
+ */
+ okText?: React.ReactNode;
+ /**
+ * Denotes the purpose of the dialog. This will affect the color of the
+ * "Ok" button. Defaults to `undefined`.
+ */
+ severity?: "error" | "info" | "success" | "warning";
+ /**
+ * The text to show in the "Cancel" button. Defaults to `'Cancel'`.
+ */
+ cancelText?: React.ReactNode;
+}
+
+export interface OpenConfirmDialog {
+ /**
+ * Open a confirmation dialog. Returns a promise that resolves to true if
+ * the user confirms, false if the user cancels.
+ *
+ * @param msg The message to show in the dialog.
+ * @param options Additional options for the dialog.
+ * @returns A promise that resolves to true if the user confirms, false if the user cancels.
+ */
+ (msg: React.ComponentType, options?: ConfirmOptions): Promise;
+}
+
+export interface DialogHook {
+ // alert: OpenAlertDialog;
+ confirm: OpenConfirmDialog;
+ // prompt: OpenPromptDialog;
+ open: OpenDialog;
+ close: CloseDialog;
+}
+
+export interface DialogStackEntry {
+ key: string;
+ open: boolean;
+ promise: Promise;
+ Component: DialogComponent;
+ payload: P;
+ onClose: (result: R) => Promise;
+ resolve: (result: R) => void;
+ msgProps: ConfirmDialogExtraOptions;
+}
+
+export interface DialogProviderProps {
+ children?: React.ReactNode;
+ unmountAfter?: number;
+}
+
+// form dialog
+export interface FormDialogProps extends MuiDialogProps {
+ title?: string;
+ children?: React.ReactNode;
+ onSubmit: (e: BaseSyntheticEvent) => void;
+}
+
+// form
+export type ComponentFormProps = {
+ data: T | null;
+ onError?: () => void;
+ onSuccess?: () => void;
+ Wrapper?: React.FC;
+ WrapperProps?: Partial;
+};
+
+export interface FormButtonsProps {
+ onCancel?: () => void;
+ onSubmit: (e: BaseSyntheticEvent) => void;
+}
+
+export type ComponentFormDialogProps = DialogProps;
diff --git a/widget/src/UiChatWidget.tsx b/widget/src/UiChatWidget.tsx
index 9dab8432..32290344 100644
--- a/widget/src/UiChatWidget.tsx
+++ b/widget/src/UiChatWidget.tsx
@@ -1,11 +1,12 @@
/*
- * Copyright © 2024 Hexastack. All rights reserved.
+ * Copyright © 2025 Hexastack. All rights reserved.
*
* Licensed under the GNU Affero General Public License v3.0 (AGPLv3) with the following additional terms:
* 1. The name "Hexabot" is a trademark of Hexastack. You may not use this name in derivative works without express written permission.
* 2. All derivative works must include clear attribution to the original creator and software, Hexastack and Hexabot, in a prominent location (e.g., in the software's "About" section, documentation, and README file).
*/
+
import { PropsWithChildren } from "react";
import Launcher from "./components/Launcher";