easy-email-pro-theme 1.59.9 → 1.60.0

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

@@ -0,0 +1,2 @@
+import { type AiToolApplyResult } from "easy-email-pro-core";
+export declare function formatAiApplyResult(result: AiToolApplyResult, summary?: string | null): string;

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

@@ -0,0 +1,28 @@
+import { type AiBatchUpdateToolCall, type AiToolTarget, type Element } from "easy-email-pro-core";
+import { Editor, Path } from "slate";
+export declare const MAX_AI_BATCH_TARGETS = 200;
+export type ResolvedBatchTarget = {
+    element: Element;
+    path: Path;
+};
+export type ResolvedBatchUpdate = {
+    call: AiBatchUpdateToolCall;
+    targets: ResolvedBatchTarget[];
+};
+export type BatchApplyResult = {
+    applied: number;
+    skipped: number;
+    errors: string[];
+};
+export type BatchFieldApplyResult = {
+    changed: boolean;
+    error?: string;
+};
+export declare function validateBatchUpdateCall(call: AiBatchUpdateToolCall): void;
+export declare function resolveBatchUpdateTargets(editor: Editor, call: AiBatchUpdateToolCall, resolveRoot?: (target: AiToolTarget) => Path | null): ResolvedBatchUpdate;
+export declare function assertBatchTargetLimit(batches: ResolvedBatchUpdate[], limit?: number): void;
+export declare function getBatchRecordUpdate(current: Record<string, unknown>, key: string, nextValue: unknown): {
+    changed: boolean;
+    value: {} | undefined;
+};
+export declare function applyResolvedBatchUpdate(resolved: ResolvedBatchUpdate, applyField: (target: ResolvedBatchTarget, field: "text" | "attributes" | "mobileAttributes" | "data" | "visibility", value: unknown) => boolean | BatchFieldApplyResult): BatchApplyResult;

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

@@ -0,0 +1,8 @@
+import { Editor } from "slate";
+import { HistoryEditor } from "slate-history";
+import { type AiExternalHistoryChange } from "./aiExternalHistory";
+type AiEditorTransactionOptions = {
+    getExternalChange?: () => AiExternalHistoryChange | null;
+};
+export declare function runAiEditorTransaction<T>(editor: Editor & HistoryEditor, apply: () => T, options?: AiEditorTransactionOptions): T;
+export {};

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

@@ -0,0 +1,10 @@
+import type { Editor } from "slate";
+import type { HistoryEditor } from "slate-history";
+type HistoryBatch = HistoryEditor["history"]["undos"][number];
+export type AiExternalHistoryChange = {
+    before: string;
+    after: string;
+};
+export declare function installAiExternalHistory(editor: Editor & HistoryEditor, setValue: (value: string) => void): void;
+export declare function attachAiExternalHistory(batch: HistoryBatch, change: AiExternalHistoryChange): void;
+export {};

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

@@ -0,0 +1,4 @@
+export declare function validateAiSubject(value: unknown): string;
+export declare function isAiSubjectChanged(current: string, next: string): boolean;
+export declare function subjectAfterApplyingTemplate(current: string, template: unknown): string;
+export declare function emailAfterApplyingAiTemplate<TCurrent extends Record<string, unknown>>(current: TCurrent, template: unknown): TCurrent;

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

@@ -0,0 +1,3 @@
+import type { CustomSlateEditor } from "easy-email-pro-editor";
+import { Path } from "slate";
+export declare function setEditorFieldValue(editor: CustomSlateEditor, path: Path, name: string, value: unknown): void;

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

@@ -9,6 +9,9 @@ export type AiEditorToolTarget = {
     index?: number;
 };
 export type AiEditorToolCall = {
+    name: "update_subject";
+    subject: string;
+} | {
     name: "update_text";
     target: AiEditorToolTarget;
     text: string;
@@ -68,6 +71,29 @@ export type AiEditorToolCall = {
 } | {
     name: "apply_template";
     template: unknown;
+} | {
+    name: "batch_update";
+    selector: {
+        scope: "template" | "descendants";
+        root?: AiEditorToolTarget;
+        types: string[];
+        where?: Array<{
+            field: "text" | "attribute" | "mobileAttribute" | "data";
+            key?: string;
+            operator: "equals" | "contains" | "exists";
+            value?: unknown;
+        }>;
+    };
+    changes: {
+        text?: string;
+        attributes?: Record<string, unknown>;
+        mobileAttributes?: Record<string, unknown>;
+        data?: Record<string, unknown>;
+        visibility?: {
+            desktop: boolean;
+            mobile: boolean;
+        };
+    };
 };
 export type AiEditorToolApplyResult = {
     applied: number;

package/lib/typings/themes/Retro/components/ElementInteract/ElementTools/index.d.ts

@@ -5,4 +5,5 @@ export declare const ElementTools: React.FC<{
     element: Element;
     nodeElement: HTMLElement;
     path: Path;
+    hideInnerTools?: boolean;
 }>;

package/lib/typings/typings/custom-types.d.ts

@@ -26,6 +26,8 @@ export interface EditorContextProps {
     initialValuesRef: React.MutableRefObject<EmailTemplate>;
     getFieldValue: (path: Path | null, name: string) => any;
     setFieldValue: (path: Path | null, name: string, value: any) => void;
+    setFieldValueTransactional: (path: Path | null, name: string, value: any) => void;
+    syncValues: (values: EmailTemplate) => void;
     getFieldDirty: (path: Path | null, name: string) => boolean;
     reset: (values: EmailTemplate) => void;
     valid: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "easy-email-pro-theme",
-  "version": "1.59.9",
+  "version": "1.60.0",
   "description": "",
   "files": [
     "lib"
@@ -47,6 +47,7 @@
   },
   "scripts": {
     "build": "vite build && npm run typings",
+    "test:ai-agent": "cd ../.. && packages/easy-email-pro-core/node_modules/.bin/tsx packages/easy-email-pro-theme/test/aiBatchUpdate.test.ts && packages/easy-email-pro-core/node_modules/.bin/tsx packages/easy-email-pro-theme/test/aiEditorTransaction.test.ts && packages/easy-email-pro-core/node_modules/.bin/tsx packages/easy-email-pro-theme/test/aiAgentBatchSummary.test.ts && packages/easy-email-pro-core/node_modules/.bin/tsx packages/easy-email-pro-theme/test/aiTransactionalMutation.test.ts && packages/easy-email-pro-core/node_modules/.bin/tsx packages/easy-email-pro-theme/test/aiSubjectUpdate.test.ts",
     "typings": "tsc --declaration --emitDeclarationOnly --project tsconfig.alias.json && tsc-alias -p tsconfig.alias.json",
     "lint": "eslint --fix --ext .tsx,.ts src/"
   }