easy-email-pro-theme 1.57.13 → 1.58.0

package/lib/typings/components/AIAgent/AiAgentPanel.d.ts

@@ -0,0 +1,24 @@
+import React from "react";
+import { type AiAgentAttachment, type EasyEmailProAiAgentProps } from "./App";
+import { type AiAgentHistory, type AiAgentHistoryChange, type AiAgentSnapshot } from "./useAiAgentSession";
+import type { AiChatHandler } from "./client";
+export type AiAgentPanelSnapshotOptions = {
+    onCreate?: (snapshot: AiAgentSnapshot) => void | Promise<void>;
+    onRestore?: (snapshotId: string) => AiAgentSnapshot | null | Promise<AiAgentSnapshot | null>;
+};
+export type AiAgentUploadResult = string | AiAgentAttachment;
+export type AiAgentUploadHandler = (file: File) => Promise<AiAgentUploadResult>;
+export type AiAgentPanelProps = {
+    className?: string;
+    disabled?: boolean;
+    onChat: AiChatHandler;
+    history?: AiAgentHistory;
+    onHistoryChange?: (history: AiAgentHistory, change: AiAgentHistoryChange) => void;
+    snapshots?: false | AiAgentPanelSnapshotOptions;
+    initialMessages?: EasyEmailProAiAgentProps["messages"];
+    onError?: (error: Error) => void;
+    onUpload?: AiAgentUploadHandler;
+    quickActions?: EasyEmailProAiAgentProps["quickActions"];
+    placeholder?: string;
+};
+export declare function AiAgentPanel({ className, disabled, history, onHistoryChange, snapshots, initialMessages, onError, onUpload: uploadOverride, onChat, quickActions, placeholder, }: AiAgentPanelProps): React.JSX.Element;

package/lib/typings/components/AIAgent/App.d.ts

@@ -0,0 +1,64 @@
+import React from "react";
+import type { AiDecisionChoice, AiDecisionRequestPayload, AiDecisionResponsePayload, AiTokenUsage, AiWebSource } from "./client";
+export type AiChangeVersion = {
+    id: string;
+    label: string;
+    title: string;
+    summary: string;
+    time: string;
+    changes: string[];
+};
+export type AiAgentMessage = {
+    id: string;
+    role: "user" | "assistant";
+    content: string;
+    time: string;
+    createdAt?: string;
+    status?: "ready" | "running" | "error" | "pending_apply";
+    snapshotId?: string | null;
+    usage?: AiTokenUsage;
+    sources?: AiWebSource[];
+    attachments?: AiAgentAttachment[];
+};
+export type AiAgentAttachment = {
+    id: string;
+    type: "image";
+    name: string;
+    url: string;
+    mimeType?: string;
+    dataUrl?: string;
+    size?: number;
+};
+export type AiQuickAction = string | {
+    label: string;
+    prompt: string;
+};
+export type EasyEmailProAiAgentProps = {
+    className?: string;
+    status?: "ready" | "running" | "error";
+    model?: string;
+    currentVersionId?: string;
+    versions?: AiChangeVersion[];
+    messages?: AiAgentMessage[];
+    activity?: string;
+    disabled?: boolean;
+    sendDisabled?: boolean;
+    quickActions?: AiQuickAction[];
+    pendingAction?: {
+        label: string;
+        disabled?: boolean;
+        onClick: () => void | Promise<void>;
+    };
+    pendingDecision?: AiDecisionRequestPayload | null;
+    placeholder?: string;
+    onSend?: (message: string, attachments?: AiAgentAttachment[]) => void | Promise<void>;
+    onUpload?: (file: File) => Promise<AiAgentAttachment>;
+    onChooseDecision?: (choice: AiDecisionChoice, response: AiDecisionResponsePayload) => void | Promise<void>;
+    onCancelDecision?: () => void;
+    onRestoreSnapshot?: (snapshotId: string) => void | Promise<void>;
+    onRestoreVersion?: (version: AiChangeVersion) => void;
+    onStepVersion?: (version: AiChangeVersion, direction: "previous" | "next") => void;
+    onQuickAction?: (action: string) => void | Promise<void>;
+    onClose?: () => void;
+};
+export declare function EasyEmailProAiAgent({ className, messages, activity, disabled, sendDisabled, quickActions, pendingAction, pendingDecision, placeholder, onSend, onUpload, onChooseDecision, onCancelDecision, onRestoreSnapshot, onQuickAction, }: EasyEmailProAiAgentProps): React.JSX.Element;

package/lib/typings/components/AIAgent/client.d.ts

@@ -0,0 +1,2 @@
+export { parseEasyEmailAiStream, resolveAiChatResult, } from "easy-email-pro-core";
+export type { AiAgentEvent, AiAgentImageAttachment, AiAgentStatus, AiChatHandler, AiChatRequest, AiChatResult, AiDecisionChoice, AiDecisionRequestPayload, AiDecisionResponsePayload, AiEditorContextPayload, AiTokenUsage, AiWebSource, EasyEmailAnswerPayload, EasyEmailImageResultPayload, EasyEmailResultPayload, RespondEasyEmailBody, } from "easy-email-pro-core";

package/lib/typings/components/AIAgent/index.d.ts

@@ -0,0 +1,10 @@
+import "./styles.css";
+export { EasyEmailProAiAgent } from "./App";
+export { AiAgentPanel } from "./AiAgentPanel";
+export { useAiAgentSession } from "./useAiAgentSession";
+export type { AiAgentPanelProps, AiAgentPanelSnapshotOptions, } from "./AiAgentPanel";
+export type { AiAgentAttachment, AiAgentMessage, AiChangeVersion, AiQuickAction, EasyEmailProAiAgentProps, } from "./App";
+export type { AiToolApplyResult, AiToolCall, AiToolTarget, EasyEmailToolCallsPayload, } from "./tools";
+export type { AiAgentHistory, AiAgentHistoryChange, AiAgentPendingChange, AiAgentRuntimeStatus, AiAgentSnapshot, AiAgentSnapshotMeta, UseAiAgentSessionOptions, } from "./useAiAgentSession";
+export { parseEasyEmailAiStream, resolveAiChatResult, } from "./client";
+export type { AiAgentEvent, AiAgentStatus, AiChatHandler, AiChatRequest, AiChatResult, AiTokenUsage, AiWebSource, AiEditorContextPayload, AiAgentImageAttachment, EasyEmailAnswerPayload, EasyEmailResultPayload, } from "./client";

package/lib/typings/components/AIAgent/tools.d.ts

@@ -0,0 +1 @@
+export type { AiAppliedChange, AiToolApplyResult, AiToolCall, AiToolTarget, EasyEmailToolCallsPayload, } from "easy-email-pro-core";

package/lib/typings/components/AIAgent/useAiAgentSession.d.ts

@@ -0,0 +1,77 @@
+import type { AiAgentMessage, AiAgentAttachment } from "./App";
+import { type AiChatHandler, type AiDecisionChoice, type AiDecisionRequestPayload, type AiDecisionResponsePayload, type AiAgentImageAttachment, type AiEditorContextPayload } from "./client";
+import type { AiToolApplyResult, AiToolCall, EasyEmailToolCallsPayload } from "./tools";
+export type AiAgentRuntimeStatus = "ready" | "running" | "error";
+export type AiAgentSnapshotMeta = {
+    id: string;
+    title?: string;
+    summary?: string | null;
+    createdAt: string;
+};
+export type AiAgentSnapshot = AiAgentSnapshotMeta & {
+    template: unknown;
+    reason: "before-ai-run" | "after-ai-apply";
+    messageId?: string;
+};
+export type AiAgentHistory = {
+    messages: AiAgentMessage[];
+    currentSnapshotId?: string;
+    snapshots?: AiAgentSnapshotMeta[];
+};
+export type AiAgentHistoryChange = {
+    type: "message.appended";
+    messages: AiAgentMessage[];
+} | {
+    type: "message.updated";
+    messageId: string;
+    patch: Partial<AiAgentMessage>;
+} | {
+    type: "snapshot.created";
+    snapshot: AiAgentSnapshotMeta;
+} | {
+    type: "snapshot.restored";
+    snapshotId: string;
+};
+export type UseAiAgentSessionOptions = {
+    getTemplate: () => unknown;
+    getEditorContext?: () => AiEditorContextPayload | undefined;
+    onChat: AiChatHandler;
+    onApplyTemplate?: (template: unknown) => void;
+    onApplyToolCalls?: (toolCalls: AiToolCall[], payload: EasyEmailToolCallsPayload) => void | AiToolApplyResult | Promise<void | AiToolApplyResult>;
+    onUploadGeneratedImage?: (image: AiAgentImageAttachment) => AiAgentImageAttachment | Promise<AiAgentImageAttachment>;
+    history?: AiAgentHistory;
+    onHistoryChange?: (history: AiAgentHistory, change: AiAgentHistoryChange) => void;
+    snapshotsEnabled?: boolean;
+    onSnapshotCreate?: (snapshot: AiAgentSnapshot) => void | Promise<void>;
+    onRestoreSnapshot?: (snapshotId: string) => void | Promise<void>;
+    initialMessages?: AiAgentMessage[];
+    onError?: (error: Error) => void;
+};
+export type AiAgentPendingChange = {
+    kind: "tool_calls";
+    assistantMessageId: string;
+    payload: EasyEmailToolCallsPayload;
+    toolCalls: AiToolCall[];
+} | {
+    kind: "template";
+    assistantMessageId: string;
+    template: unknown;
+    summary?: string | null;
+};
+export declare function useAiAgentSession(options: UseAiAgentSessionOptions): {
+    history: AiAgentHistory;
+    messages: AiAgentMessage[];
+    snapshots: AiAgentSnapshotMeta[];
+    currentSnapshotId: string | undefined;
+    status: AiAgentRuntimeStatus;
+    activity: string;
+    pendingChange: AiAgentPendingChange | null;
+    pendingDecision: AiDecisionRequestPayload | null;
+    applyingPendingChange: boolean;
+    applyPendingChange: () => Promise<void>;
+    chooseDecision: (choice: AiDecisionChoice, response: AiDecisionResponsePayload) => Promise<void>;
+    clearPendingDecision: () => void;
+    restoreSnapshot: (snapshotId: string) => Promise<void>;
+    send: (message: string, attachments?: AiAgentAttachment[], decisionResponse?: AiDecisionResponsePayload) => Promise<void>;
+    stop: () => Promise<void>;
+};

package/lib/typings/components/FullHeightOverlayScrollbars/index.d.ts

@@ -1,9 +1,12 @@
 import React from "react";
 import "overlayscrollbars/css/OverlayScrollbars.css";
-export declare const FullHeightOverlayScrollbars: React.FC<{
+import { OverlayScrollbarsComponent } from "overlayscrollbars-react";
+export declare const FullHeightOverlayScrollbars: React.ForwardRefExoticComponent<({
     height: string | number;
     children: React.ReactNode;
+    className?: string | undefined;
 } | {
     maxHeight: string | number;
     children: React.ReactNode;
-}>;
+    className?: string | undefined;
+}) & React.RefAttributes<OverlayScrollbarsComponent>>;

package/lib/typings/components/index.d.ts

@@ -1,11 +1,12 @@
-/// <reference types="react" />
 import { WidgetConfigPanel, WidgetTypeOptions } from "./ConfigurationPanel/components/WidgetConfigPanel";
 import { AIAssistant } from "./HoveringToolbar/componens/AIAssistant";
 import { ElementStyleGallery } from "./ElementStyleGallery";
 export { enhancer } from "./Form";
 export * from "./Providers";
+export * from "./AIAgent";
 import { SocialItem } from "./ConfigurationPanel/Elements/Social";
 import { NavbarLink } from "./ConfigurationPanel/Elements/Navbar";
+import type { ComponentType } from "react";
 export declare const SharedComponents: {
     PreviewEmailDrawer: ({ children, }: {
         children: import("react").ReactNode;
@@ -86,13 +87,15 @@ export declare const SharedComponents: {
     UnsplashImages: (props: import("./UnsplashImages").UnsplashImagesProps) => import("react").JSX.Element;
     UnsplashImagesDrawer: import("react").ForwardRefExoticComponent<import("./UnsplashImagesDrawer").UnsplashImagesDrawerProps & import("react").RefAttributes<unknown>>;
     WidgetConfigPanel: typeof WidgetConfigPanel;
-    FullHeightOverlayScrollbars: import("react").FC<{
+    FullHeightOverlayScrollbars: import("react").ForwardRefExoticComponent<({
         height: string | number;
         children: import("react").ReactNode;
+        className?: string | undefined;
     } | {
         maxHeight: string | number;
         children: import("react").ReactNode;
-    }>;
+        className?: string | undefined;
+    }) & import("react").RefAttributes<import("overlayscrollbars-react").OverlayScrollbarsComponent>>;
     BlockList: ({ tab, }: {
         tab: "Default" | "Universal" | "Prebuilt";
     }) => import("react").JSX.Element;
@@ -167,6 +170,7 @@ export declare const SharedComponents: {
     }>;
     SocialItem: typeof SocialItem;
     NavbarLink: typeof NavbarLink;
+    AiAgent: ComponentType<{}> | undefined;
 };
 export { CollapseWrapper } from "./ConfigurationPanel/components/CollapseWrapper";
 export { AttributesPanelWrapper } from "./ConfigurationPanel/components/AttributesPanelWrapper";

package/lib/typings/hooks/index.d.ts

@@ -8,3 +8,4 @@ export { useEditorThemeState } from "./useEditorThemeState";
 export { useColorContext } from "./useColorContext";
 export { useMinimalistContext } from "./useMinimalistContext";
 export { useBlocksDrawer } from "./useBlocksDrawer";
+export { useApplyAiToolCalls, type AiEditorToolApplyResult, type AiEditorToolCall, type AiEditorToolTarget, } from "./useApplyAiToolCalls";

package/lib/typings/hooks/useApplyAiToolCalls.d.ts

@@ -0,0 +1,85 @@
+export type AiEditorToolTarget = {
+    selected: true;
+} | {
+    id: string;
+} | {
+    uid: string;
+} | {
+    type: string;
+    index?: number;
+};
+export type AiEditorToolCall = {
+    name: "update_text";
+    target: AiEditorToolTarget;
+    text: string;
+} | {
+    name: "update_attribute";
+    target: AiEditorToolTarget;
+    key: string;
+    value: unknown;
+} | {
+    name: "update_mobile_attribute";
+    target: AiEditorToolTarget;
+    key: string;
+    value: unknown;
+} | {
+    name: "update_attributes";
+    target: AiEditorToolTarget;
+    attributes: Record<string, unknown>;
+    scope?: "desktop" | "mobile";
+} | {
+    name: "update_data";
+    target: AiEditorToolTarget;
+    key: string;
+    value: unknown;
+} | {
+    name: "replace_children";
+    target: AiEditorToolTarget;
+    children: unknown[];
+} | {
+    name: "set_visibility";
+    target: AiEditorToolTarget;
+    desktop: boolean;
+    mobile: boolean;
+} | {
+    name: "replace_block";
+    target: AiEditorToolTarget;
+    block: unknown;
+} | {
+    name: "update_link";
+    target: AiEditorToolTarget;
+    href: string;
+    blank?: boolean;
+    title?: string;
+} | {
+    name: "move_up" | "move_down" | "duplicate" | "delete_node";
+    target: AiEditorToolTarget;
+} | {
+    name: "add_block_after";
+    target: AiEditorToolTarget;
+    block: unknown;
+} | {
+    name: "add_block_before";
+    target: AiEditorToolTarget;
+    block: unknown;
+} | {
+    name: "select_node";
+    target: AiEditorToolTarget;
+} | {
+    name: "apply_template";
+    template: unknown;
+};
+export type AiEditorToolApplyResult = {
+    applied: number;
+    skipped: number;
+    errors: string[];
+    changes?: AiEditorAppliedChange[];
+};
+export type AiEditorAppliedChange = {
+    id: string;
+    label: string;
+    description: string;
+    target: AiEditorToolTarget;
+    path?: number[];
+};
+export declare function useApplyAiToolCalls(): (toolCalls: AiEditorToolCall[]) => AiEditorToolApplyResult;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "easy-email-pro-theme",
-  "version": "1.57.13",
+  "version": "1.58.0",
   "description": "",
   "files": [
     "lib"