@templatical/import-easy-email-pro 0.36.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026-present Templatical
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,51 @@
+# @templatical/import-easy-email-pro
+
+Convert Easy Email Pro email templates to Templatical format.
+
+Reads an Easy Email Pro persist document — the `{ subject, content }` envelope
+the editor saves, or a bare `type: "page"` element — into a Templatical
+`TemplateContent` tree. The input is that persist JSON, not `EditorCore.toMJML()`
+and not the compiled HTML. Open-source Easy Email (`type: "section"` / `"text"`
+without the `standard-` prefix) is a different format; this package throws
+rather than mis-import it.
+
+## Install
+
+```sh
+npm install @templatical/import-easy-email-pro
+```
+
+## Usage
+
+```ts
+import { convertEasyEmailProTemplate } from "@templatical/import-easy-email-pro";
+
+const { content, report } = convertEasyEmailProTemplate(emailTemplate);
+
+console.log(report.summary);
+console.log(report.warnings);
+```
+
+`emailTemplate` is `{ subject, content }` with `content.type === "page"`, or
+the page element itself. `convertEasyEmailProTemplate` also accepts either
+shape serialized as a JSON string. Extra `html` / `mjml` keys on the envelope
+are ignored.
+
+Each entry in `report.entries` carries a `status`:
+
+- `converted` — mapped to a Templatical block with no loss of fidelity.
+- `approximated` — mapped to a Templatical block, but something had to be
+  resolved or clamped (e.g. a 4+ column row folded to three, an outlined
+  button, a hero overlay stacked as a leading image, a countdown GIF, a
+  widget whose children converted without its chrome, logic whose children
+  converted without their expression).
+- `html-fallback` — no Templatical block exists for this `type`; the raw node
+  is preserved as JSON inside an `HtmlBlock`.
+- `skipped` — empty `logic`; there were no children to convert.
+
+See [Migrating from Easy Email Pro](https://docs.templatical.com/guide/migration-from-easy-email-pro)
+for the full node-mapping table and what does not survive the conversion.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,77 @@
+//#region src/types.d.ts
+type ConversionStatus = "converted" | "approximated" | "html-fallback" | "skipped";
+interface ImportReportEntry {
+  /** The source Easy Email Pro `type` string (e.g. "standard-button"). */
+  sourceTag: string;
+  templaticalBlockType: string | null;
+  status: ConversionStatus;
+  note?: string;
+}
+interface ImportReport {
+  entries: ImportReportEntry[];
+  warnings: string[];
+  summary: {
+    total: number;
+    converted: number;
+    approximated: number;
+    htmlFallback: number;
+    skipped: number;
+  };
+}
+interface ImportResult {
+  content: import("@templatical/types").TemplateContent;
+  report: ImportReport;
+}
+interface EasyEmailProNode {
+  type?: string;
+  data?: Record<string, unknown>;
+  attributes?: Record<string, unknown>;
+  mobileAttributes?: Record<string, unknown>;
+  visible?: "desktop" | "mobile" | string;
+  logic?: {
+    condition?: unknown;
+    iteration?: unknown;
+  };
+  children?: Array<EasyEmailProNode | EasyEmailProTextNode>;
+  title?: string;
+  name?: string;
+  uid?: string;
+  [key: string]: unknown;
+}
+interface EasyEmailProTextNode {
+  text: string;
+  bold?: boolean;
+  italic?: boolean;
+  underline?: boolean;
+  strikethrough?: boolean;
+  color?: string;
+  bgColor?: string;
+  link?: {
+    href?: string;
+    blank?: boolean;
+  } | null;
+  [key: string]: unknown;
+}
+type EasyEmailProPage = EasyEmailProNode & {
+  type: "page";
+};
+interface EasyEmailProDocument {
+  subject?: string;
+  content?: EasyEmailProPage | EasyEmailProNode;
+  html?: unknown;
+  mjml?: unknown;
+  thumbnail?: unknown;
+  id?: unknown;
+  [key: string]: unknown;
+}
+//#endregion
+//#region src/converter.d.ts
+/**
+ * Convert an Easy Email Pro page (or EmailTemplate envelope) into a
+ * Templatical template. Accepts a bare `page` element, an
+ * `EmailTemplate { subject, content }` envelope, or a JSON string of either.
+ */
+export declare function convertEasyEmailProTemplate(doc: EasyEmailProDocument | EasyEmailProPage | string): ImportResult;
+//#endregion
+export type { ConversionStatus, ImportReport, ImportReportEntry, ImportResult };
+//# sourceMappingURL=index.d.ts.map