@go-mailer/easy-email-extensions 5.0.3 → 5.0.5

package/lib/AttributePanel/components/adapter/index.d.ts

@@ -3,3 +3,4 @@ export { pixelAdapter } from './pixel.adapter';
 export { sliderAdapter } from './slider.adapter';
 export { colorAdapter } from './color.adapter';
 export { imageHeightAdapter } from './image-height.adapter';
+export { percentAdapter } from './percent.adapter';

package/lib/AttributePanel/components/attributes/ContainerBackgroundColor.d.ts

@@ -1,4 +1,4 @@
 import React from 'react';
-export declare function ContainerBackgroundColor({ title, }: {
+export declare function ContainerBackgroundColor({ title }: {
     title?: string;
 }): React.JSX.Element;

package/lib/AttributePanel/components/attributes/PersonalizationPanel.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+export declare function PersonalizationPanel({ onChange, }: {
+    onChange?: (html: string) => void;
+}): React.JSX.Element | null;

package/lib/GoMailerLayout/GoMailerLayout.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import { ExtensionProps } from '../components/Providers/ExtensionProvider';
+export interface GoMailerLayoutProps extends ExtensionProps {
+    showSourceCode?: boolean;
+    jsonReadOnly?: boolean;
+    mjmlReadOnly?: boolean;
+}
+export declare const GoMailerLayout: React.FC<GoMailerLayoutProps>;

package/lib/GoMailerLayout/PresetBlocks.d.ts

@@ -0,0 +1,2 @@
+import React from 'react';
+export declare const presetBlocks: React.ReactNode[];

package/lib/GoMailerLayout/VideoBlock/Panel.d.ts

@@ -0,0 +1,2 @@
+import React from 'react';
+export declare function VideoPanel(): React.JSX.Element;

package/lib/GoMailerLayout/VideoBlock/index.d.ts

@@ -0,0 +1,9 @@
+import { IBlockData } from '@go-mailer/easy-email-core';
+export declare const VideoBlockType = "go-mailer-video";
+export type IVideoBlock = IBlockData<{
+    src: string;
+    href: string;
+    width: string;
+    'container-background-color': string;
+}, Record<string, never>>;
+export declare const VideoBlock: import("@go-mailer/easy-email-core").IBlock<IVideoBlock>;

package/lib/GoMailerLayout/index.d.ts

@@ -0,0 +1,2 @@
+export { GoMailerLayout } from './GoMailerLayout';
+export type { GoMailerLayoutProps } from './GoMailerLayout';

package/lib/TwoColumnLayout/TwoColumnLayout.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import { ExtensionProps } from '../components/Providers/ExtensionProvider';
+export interface TwoColumnLayoutProps extends ExtensionProps {
+    showSourceCode?: boolean;
+    jsonReadOnly?: boolean;
+    mjmlReadOnly?: boolean;
+    showBlockLayer?: boolean;
+}
+export declare const TwoColumnLayout: React.FC<TwoColumnLayoutProps>;

package/lib/TwoColumnLayout/index.d.ts

@@ -0,0 +1,2 @@
+export { TwoColumnLayout } from './TwoColumnLayout';
+export type { TwoColumnLayoutProps } from './TwoColumnLayout';

package/lib/components/Form/NativeSlider/index.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+export interface NativeSliderProps {
+    value?: number;
+    onChange?: (val: number) => void;
+    min?: number;
+    max?: number;
+    step?: number;
+    /** If true the value badge shows a % suffix instead of px */
+    percentMode?: boolean;
+}
+export declare function NativeSlider({ value, onChange, min, max, step, percentMode, }: NativeSliderProps): React.JSX.Element;

package/lib/components/Form/RichTextToolBar/components/Personalization/index.d.ts

@@ -3,4 +3,4 @@ export interface FontFamilyProps {
     execCommand: (cmd: string, value: any) => void;
     getPopupContainer: () => HTMLElement;
 }
-export declare function Personalization(props: FontFamilyProps): React.JSX.Element;
+export declare function Personalization(props: FontFamilyProps): React.JSX.Element | null;

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

@@ -1,5 +1,5 @@
 /// <reference types="react" />
-import { SliderProps, InputNumberProps, SwitchProps, TextAreaProps, CheckboxGroupProps, TreeSelectProps } from '@arco-design/web-react';
+import { InputNumberProps, SwitchProps, TextAreaProps, CheckboxGroupProps, TreeSelectProps } from '@arco-design/web-react';
 import { ImageUploaderProps } from './ImageUploader';
 import { UploadFieldProps } from './UploadField';
 import { SelectProps } from './Select';
@@ -13,13 +13,14 @@ import { InlineTextProps } from './InlineTextField';
 import { AutoCompleteProps } from './AutoComplete';
 import { InputSearchProps } from '@arco-design/web-react/es/Input';
 import { ColorPickerField } from './ColorPickerField';
+import { NativeSliderProps } from './NativeSlider';
 export { RichTextField } from './RichTextField';
 export declare const TextField: (props: import("./enhancer").EnhancerProps & Omit<InputProps, "value" | "onChange" | "mutators">) => import("react").JSX.Element;
 export declare const InputWithUnitField: (props: import("./enhancer").EnhancerProps & Omit<InputWithUnitProps, "value" | "onChange" | "mutators">) => import("react").JSX.Element;
 export declare const SearchField: (props: import("./enhancer").EnhancerProps & Omit<InputSearchProps, "value" | "onChange" | "mutators">) => import("react").JSX.Element;
 export declare const TextAreaField: (props: import("./enhancer").EnhancerProps & Omit<TextAreaProps, "value" | "onChange" | "mutators">) => import("react").JSX.Element;
 export declare const NumberField: (props: import("./enhancer").EnhancerProps & Omit<InputNumberProps, "value" | "onChange" | "mutators">) => import("react").JSX.Element;
-export declare const SliderField: (props: import("./enhancer").EnhancerProps & Omit<SliderProps, "value" | "onChange" | "mutators">) => import("react").JSX.Element;
+export declare const SliderField: (props: import("./enhancer").EnhancerProps & Omit<NativeSliderProps, "value" | "onChange" | "mutators">) => import("react").JSX.Element;
 export declare const UploadField: (props: import("./enhancer").EnhancerProps & Omit<UploadFieldProps, "value" | "onChange" | "mutators">) => import("react").JSX.Element;
 export declare const ImageUploaderField: (props: import("./enhancer").EnhancerProps & Omit<ImageUploaderProps, "value" | "onChange" | "mutators">) => import("react").JSX.Element;
 export declare const SelectField: (props: import("./enhancer").EnhancerProps & Omit<SelectProps, "value" | "onChange" | "mutators">) => import("react").JSX.Element;

package/lib/components/Providers/ExtensionProvider.d.ts

@@ -2,7 +2,7 @@ import { BlockLayerProps } from '../../BlockLayer';
 import React from 'react';
 export interface ExtensionProps extends BlockLayerProps {
     children?: React.ReactNode | React.ReactElement;
-    categories: Array<{
+    categories?: Array<{
         label: string;
         active?: boolean;
         blocks: Array<{

package/lib/hooks/useAIContext.d.ts

@@ -0,0 +1,48 @@
+import { EditorContent } from '@go-mailer/easy-email-editor';
+export interface AIBlockSummary {
+    /** Dot-path index into the email JSON tree, e.g. `"content.children.[0].children.[1]"`. */
+    idx: string;
+    /** MJML block type string, e.g. `"advanced_text"`, `"advanced_image"`. */
+    type: string;
+    /** Human-readable title if set on the block. */
+    title?: string;
+    /** Plain text extracted from HTML content fields (text blocks). */
+    plainText: string;
+    /** Alt text for image blocks, empty for others. */
+    alt: string;
+    /** Href for button/link blocks, empty for others. */
+    href: string;
+}
+export interface AIEmailContext extends EditorContent {
+    /** Flat list of every block in the email with key content fields. */
+    blockSummaries: AIBlockSummary[];
+    /** Plain text of the entire email (all text blocks concatenated). */
+    emailPlainText: string;
+    /** Plain text of the currently focused block only. */
+    focusBlockPlainText: string;
+    /** The text the user has highlighted in the canvas right now. */
+    selectedText: string;
+}
+/**
+ * Returns a comprehensive snapshot of the current editor state, designed to
+ * be passed to an AI assistant.  The returned object includes:
+ *
+ * - `emailTemplate`       — full JSON tree (`IEmailTemplate`)
+ * - `focusIdx`            — dot-path of the selected block
+ * - `focusBlock`          — the selected block node
+ * - `focusBlockPlainText` — plain text extracted from the selected block
+ * - `selection`           — `{ text, blockIdx }` for the highlighted text
+ * - `selectedText`        — convenience alias for `selection.text`
+ * - `blockSummaries`      — flat list of all blocks with extracted content
+ * - `emailPlainText`      — full email as plain text (all blocks joined)
+ *
+ * Mount this inside `<EmailEditorProvider>`. The return value is memoized
+ * and only recalculates when relevant state changes.
+ *
+ * @example
+ * ```tsx
+ * const ctx = useAIContext();
+ * // Pass ctx to your AI panel, or send ctx.emailPlainText to your LLM API.
+ * ```
+ */
+export declare function useAIContext(): AIEmailContext;

package/lib/index.d.ts

@@ -6,6 +6,8 @@ export * from './SourceCodePanel';
 export * from './InteractivePrompt';
 export * from './SimpleLayout';
 export * from './StandardLayout';
+export * from './TwoColumnLayout';
+export * from './GoMailerLayout';
 export * from './MergeTagBadgePrompt';
 export * from './components/Providers/ExtensionProvider';
 export * from './constants';
@@ -15,3 +17,5 @@ export { getContextMergeTags } from './utils/getContextMergeTags';
 export { getIconNameByBlockType, setIconsMap } from './utils/getIconNameByBlockType';
 export { getBlockTitle } from './utils/getBlockTitle';
 export { MjmlToJson } from './utils/MjmlToJson';
+export { useAIContext } from './hooks/useAIContext';
+export type { AIEmailContext, AIBlockSummary } from './hooks/useAIContext';

package/lib/index.js

@@ -1,4 +1,4 @@
-export { e as Align, A as AttributePanel, f as AttributesPanelWrapper, ac as AutoCompleteField, l as Background, o as BackgroundColor, d as BlockAttributeConfigurationManager, B as BlockLayer, O as BlockMarketManager, Q as BlockMaskWrapper, r as Border, u as BorderColor, x as BorderStyle, z as BorderWidth, af as CheckboxField, I as ClassName, h as CollapseWrapper, C as Color, aj as ColorPickerField, i as Condition, j as ContainerBackgroundColor, D as Decoration, P as DefaultPageConfigPanel, p as Direction, ah as EditGridTabField, ag as EditTabField, _ as ExtensionContext, $ as ExtensionProvider, F as FontFamily, v as FontSize, y as FontStyle, E as FontWeight, H as Height, a9 as ImageUploaderField, ai as InlineTextField, a3 as InputWithUnitField, U as InteractivePrompt, L as LetterSpacing, m as LineHeight, q as Link, t as Margin, Z as MergeTagBadgePrompt, w as MergeTags, M as MjmlToJson, N as NavbarLinkPadding, a6 as NumberField, G as Padding, J as PresetColorsProvider, a1 as RICH_TEXT_TOOL_BAR, ad as RadioGroupField, al as RichTextField, a4 as SearchField, aa as SelectField, S as SelectionRangeProvider, am as ShadowDom, K as ShortcutToolbar, X as SimpleLayout, a7 as SliderField, R as SourceCodePanel, Y as StandardLayout, ae as SwitchField, T as TextAlign, a5 as TextAreaField, k as TextDecoration, a2 as TextField, n as TextTransform, ab as TreeSelectField, a8 as UploadField, V as VerticalAlign, W as Width, ak as enhancer, b as getBlockTitle, g as getContextMergeTags, a as getIconNameByBlockType, s as setIconsMap, a0 as useExtensionProps } from "./index2.js";
+export { e as Align, A as AttributePanel, f as AttributesPanelWrapper, af as AutoCompleteField, l as Background, o as BackgroundColor, d as BlockAttributeConfigurationManager, B as BlockLayer, Q as BlockMarketManager, R as BlockMaskWrapper, r as Border, v as BorderColor, y as BorderStyle, E as BorderWidth, ai as CheckboxField, J as ClassName, h as CollapseWrapper, C as Color, am as ColorPickerField, i as Condition, j as ContainerBackgroundColor, D as Decoration, P as DefaultPageConfigPanel, p as Direction, ak as EditGridTabField, aj as EditTabField, a1 as ExtensionContext, a2 as ExtensionProvider, F as FontFamily, w as FontSize, z as FontStyle, G as FontWeight, $ as GoMailerLayout, H as Height, ac as ImageUploaderField, al as InlineTextField, a6 as InputWithUnitField, X as InteractivePrompt, L as LetterSpacing, m as LineHeight, q as Link, t as Margin, a0 as MergeTagBadgePrompt, x as MergeTags, M as MjmlToJson, N as NavbarLinkPadding, a9 as NumberField, I as Padding, K as PresetColorsProvider, a4 as RICH_TEXT_TOOL_BAR, ag as RadioGroupField, ao as RichTextField, a7 as SearchField, ad as SelectField, S as SelectionRangeProvider, ap as ShadowDom, O as ShortcutToolbar, Y as SimpleLayout, aa as SliderField, U as SourceCodePanel, Z as StandardLayout, ah as SwitchField, T as TextAlign, a8 as TextAreaField, k as TextDecoration, a5 as TextField, n as TextTransform, ae as TreeSelectField, _ as TwoColumnLayout, ab as UploadField, V as VerticalAlign, W as Width, an as enhancer, b as getBlockTitle, g as getContextMergeTags, a as getIconNameByBlockType, s as setIconsMap, u as useAIContext, a3 as useExtensionProps } from "./index2.js";
 import "react";
 import "@go-mailer/easy-email-editor";
 import "@go-mailer/easy-email-core";