@templatical/ai-kit 0.0.0-stage → 0.50.0

package/schema/template-content.schema.json

@@ -0,0 +1,1884 @@
+{
+  "$id": "https://templatical.com/schema/template-content.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$ref": "#/definitions/TemplateContent",
+  "definitions": {
+    "TemplateContent": {
+      "type": "object",
+      "properties": {
+        "blocks": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Block"
+          }
+        },
+        "settings": {
+          "$ref": "#/definitions/TemplateSettings"
+        }
+      },
+      "required": [
+        "blocks",
+        "settings"
+      ],
+      "additionalProperties": false
+    },
+    "Block": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/SectionBlock"
+        },
+        {
+          "$ref": "#/definitions/TitleBlock"
+        },
+        {
+          "$ref": "#/definitions/ParagraphBlock"
+        },
+        {
+          "$ref": "#/definitions/ImageBlock"
+        },
+        {
+          "$ref": "#/definitions/ButtonBlock"
+        },
+        {
+          "$ref": "#/definitions/DividerBlock"
+        },
+        {
+          "$ref": "#/definitions/VideoBlock"
+        },
+        {
+          "$ref": "#/definitions/SocialIconsBlock"
+        },
+        {
+          "$ref": "#/definitions/SpacerBlock"
+        },
+        {
+          "$ref": "#/definitions/HtmlBlock"
+        },
+        {
+          "$ref": "#/definitions/MenuBlock"
+        },
+        {
+          "$ref": "#/definitions/TableBlock"
+        },
+        {
+          "$ref": "#/definitions/CountdownBlock"
+        },
+        {
+          "$ref": "#/definitions/CustomBlock"
+        },
+        {
+          "$ref": "#/definitions/SlotBlock"
+        },
+        {
+          "$ref": "#/definitions/WrapperBlock"
+        }
+      ]
+    },
+    "SectionBlock": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "type": {
+          "type": "string",
+          "const": "section"
+        },
+        "styles": {
+          "$ref": "#/definitions/BlockStyles"
+        },
+        "visibility": {
+          "$ref": "#/definitions/BlockVisibility"
+        },
+        "displayCondition": {
+          "type": "object",
+          "properties": {
+            "label": {
+              "type": "string"
+            },
+            "before": {
+              "type": "string"
+            },
+            "after": {
+              "type": "string"
+            },
+            "group": {
+              "type": "string"
+            },
+            "description": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "label",
+            "before",
+            "after"
+          ],
+          "additionalProperties": false
+        },
+        "columns": {
+          "$ref": "#/definitions/ColumnLayout"
+        },
+        "children": {
+          "type": "array",
+          "items": {
+            "type": "array",
+            "items": {
+              "$ref": "#/definitions/Block"
+            }
+          }
+        },
+        "stackOnMobile": {
+          "type": "boolean",
+          "description": "Whether columns stack vertically on mobile. Absent or `true` keeps MJML's default responsive behavior (columns stack below 480px). `false` renders the columns inside an `<mj-group>` so they stay side-by-side on mobile, proportionally shrunk to fit."
+        },
+        "borderRadius": {
+          "$ref": "#/definitions/BorderRadiusValue",
+          "description": "Corner radius in px — one number, or a radius per corner. Omitted/0 = square corners."
+        },
+        "border": {
+          "$ref": "#/definitions/BorderValue",
+          "description": "Border around the section box, per side. Omitted = no border; a side with width 0 is not drawn."
+        },
+        "backgroundImage": {
+          "$ref": "#/definitions/BackgroundImage",
+          "description": "Image behind the section's columns, rendered as `background-url` (plus size, position and repeat) on the `mj-section`. `styles.backgroundColor` is its fallback."
+        },
+        "hero": {
+          "$ref": "#/definitions/SectionHero",
+          "description": "Draws a one-column section with a background image as an `mj-hero`: the image fills the box and the content sits on top. Ignored (the section renders as a regular one, and the `structure` linter says why) with more than one column, without an image, or with `height: \"image\"` and no image size."
+        },
+        "wrapper": {
+          "$ref": "#/definitions/SectionWrapper",
+          "description": "Optional outer frame (rendered as an `mj-wrapper` around the section)."
+        }
+      },
+      "required": [
+        "children",
+        "columns",
+        "id",
+        "styles",
+        "type"
+      ],
+      "additionalProperties": false
+    },
+    "BlockStyles": {
+      "type": "object",
+      "properties": {
+        "padding": {
+          "$ref": "#/definitions/SpacingValue"
+        },
+        "backgroundColor": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "padding"
+      ],
+      "additionalProperties": false
+    },
+    "SpacingValue": {
+      "type": "object",
+      "properties": {
+        "top": {
+          "type": "number"
+        },
+        "right": {
+          "type": "number"
+        },
+        "bottom": {
+          "type": "number"
+        },
+        "left": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "top",
+        "right",
+        "bottom",
+        "left"
+      ],
+      "additionalProperties": false
+    },
+    "BlockVisibility": {
+      "type": "object",
+      "properties": {
+        "desktop": {
+          "type": "boolean"
+        },
+        "mobile": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "desktop",
+        "mobile"
+      ],
+      "additionalProperties": false
+    },
+    "ColumnLayout": {
+      "type": "string",
+      "enum": [
+        "1",
+        "2",
+        "3",
+        "2-1",
+        "1-2"
+      ]
+    },
+    "BorderRadiusValue": {
+      "anyOf": [
+        {
+          "type": "number"
+        },
+        {
+          "$ref": "#/definitions/CornerRadius"
+        }
+      ],
+      "description": "A corner radius in px: one number for all four corners, or a radius per corner."
+    },
+    "CornerRadius": {
+      "type": "object",
+      "properties": {
+        "topLeft": {
+          "type": "number"
+        },
+        "topRight": {
+          "type": "number"
+        },
+        "bottomRight": {
+          "type": "number"
+        },
+        "bottomLeft": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "topLeft",
+        "topRight",
+        "bottomRight",
+        "bottomLeft"
+      ],
+      "additionalProperties": false,
+      "description": "A radius per corner, in px."
+    },
+    "BorderValue": {
+      "type": "object",
+      "properties": {
+        "top": {
+          "$ref": "#/definitions/BorderSideValue"
+        },
+        "right": {
+          "$ref": "#/definitions/BorderSideValue"
+        },
+        "bottom": {
+          "$ref": "#/definitions/BorderSideValue"
+        },
+        "left": {
+          "$ref": "#/definitions/BorderSideValue"
+        }
+      },
+      "required": [
+        "top",
+        "right",
+        "bottom",
+        "left"
+      ],
+      "additionalProperties": false,
+      "description": "A border described per side, like `SpacingValue`. Only elements MJML can border natively carry one: sections, images and buttons."
+    },
+    "BorderSideValue": {
+      "type": "object",
+      "properties": {
+        "width": {
+          "type": "number",
+          "description": "Width in px. `0` means no border on this side."
+        },
+        "style": {
+          "$ref": "#/definitions/BorderStyle"
+        },
+        "color": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "width",
+        "style",
+        "color"
+      ],
+      "additionalProperties": false,
+      "description": "One side of a border. A width of `0` leaves that side undrawn."
+    },
+    "BorderStyle": {
+      "type": "string",
+      "enum": [
+        "solid",
+        "dashed",
+        "dotted"
+      ]
+    },
+    "BackgroundImage": {
+      "type": "object",
+      "properties": {
+        "url": {
+          "type": "string"
+        },
+        "size": {
+          "$ref": "#/definitions/BackgroundSize"
+        },
+        "position": {
+          "type": "object",
+          "properties": {
+            "x": {
+              "$ref": "#/definitions/BackgroundPositionX"
+            },
+            "y": {
+              "$ref": "#/definitions/BackgroundPositionY"
+            }
+          },
+          "required": [
+            "x",
+            "y"
+          ],
+          "additionalProperties": false
+        },
+        "repeat": {
+          "type": "boolean",
+          "description": "`false` paints the image once; `true` tiles it."
+        },
+        "naturalWidth": {
+          "type": "number",
+          "description": "The image file's own width in px, when known: given by the media library, measured by the editor when the author sets the URL, or read by an importer (from MJML, the hero's `background-width`, which may be the box's size rather than the file's). Only the ratio with `naturalHeight` is used: a section hero with `height: \"image\"` keeps its box at that shape. Both or neither; one without the other reads as unknown."
+        },
+        "naturalHeight": {
+          "type": "number",
+          "description": "The image file's own height in px, when known; it pairs with `naturalWidth`, and only their ratio is used. Both or neither."
+        }
+      },
+      "required": [
+        "url",
+        "size",
+        "position",
+        "repeat"
+      ],
+      "additionalProperties": false,
+      "description": "An image painted behind a section or a wrapper band. The element's own `backgroundColor` is its fallback: it shows while the image loads, with images off, and in clients without background-image support."
+    },
+    "BackgroundSize": {
+      "type": "string",
+      "enum": [
+        "cover",
+        "contain",
+        "auto"
+      ],
+      "description": "`background-size` keywords. In Outlook on Windows (VML), `cover` and `contain` draw a single frame when `repeat` is off and tile when it is on; `auto` always tiles from the top center, whatever `position` and `repeat` say."
+    },
+    "BackgroundPositionX": {
+      "type": "string",
+      "enum": [
+        "left",
+        "center",
+        "right"
+      ]
+    },
+    "BackgroundPositionY": {
+      "type": "string",
+      "enum": [
+        "top",
+        "center",
+        "bottom"
+      ]
+    },
+    "SectionHero": {
+      "type": "object",
+      "properties": {
+        "height": {
+          "anyOf": [
+            {
+              "type": "string",
+              "const": "image"
+            },
+            {
+              "type": "number"
+            }
+          ],
+          "description": "`\"image\"` makes the box as tall as the image drawn across its desktop width, and needs the image's size on `backgroundImage.naturalWidth` / `naturalHeight`; a phone keeps that height and crops the image's sides. A number is the box's fixed height in px, padding included."
+        },
+        "verticalAlign": {
+          "$ref": "#/definitions/HeroVerticalAlign"
+        }
+      },
+      "required": [
+        "height",
+        "verticalAlign"
+      ],
+      "additionalProperties": false,
+      "description": "Draws a one-column section as an MJML `mj-hero`: its background image fills the box (always `cover`, never tiled) and the content sits on top of it. A hero applies only to a one-column section with a background image; otherwise the section renders as a regular one."
+    },
+    "HeroVerticalAlign": {
+      "type": "string",
+      "enum": [
+        "top",
+        "middle",
+        "bottom"
+      ],
+      "description": "Where a hero's content sits in its box."
+    },
+    "SectionWrapper": {
+      "type": "object",
+      "properties": {
+        "backgroundColor": {
+          "type": "string"
+        },
+        "padding": {
+          "$ref": "#/definitions/SpacingValue"
+        },
+        "borderRadius": {
+          "$ref": "#/definitions/BorderRadiusValue",
+          "description": "Corner radius in px for the outer frame — one number, or a radius per corner. Omitted/0 = square corners."
+        },
+        "backgroundImage": {
+          "$ref": "#/definitions/BackgroundImage",
+          "description": "Image behind the band; `backgroundColor` is its fallback."
+        }
+      },
+      "additionalProperties": false,
+      "description": "Optional outer frame for a section. When present, the section is rendered inside an `mj-wrapper` — a band (its own background + padding) that frames the section, e.g. a white card sitting on a colored band. The band is as wide as the email body (`settings.width`), not the recipient's viewport."
+    },
+    "TitleBlock": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "type": {
+          "type": "string",
+          "const": "title"
+        },
+        "styles": {
+          "$ref": "#/definitions/BlockStyles"
+        },
+        "visibility": {
+          "$ref": "#/definitions/BlockVisibility"
+        },
+        "displayCondition": {
+          "type": "object",
+          "properties": {
+            "label": {
+              "type": "string"
+            },
+            "before": {
+              "type": "string"
+            },
+            "after": {
+              "type": "string"
+            },
+            "group": {
+              "type": "string"
+            },
+            "description": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "label",
+            "before",
+            "after"
+          ],
+          "additionalProperties": false
+        },
+        "content": {
+          "type": "string"
+        },
+        "level": {
+          "$ref": "#/definitions/HeadingLevel"
+        },
+        "color": {
+          "type": "string",
+          "description": "Text color. Unset = inherit the document-level `textColor`."
+        },
+        "textAlign": {
+          "type": "string",
+          "enum": [
+            "left",
+            "center",
+            "right"
+          ]
+        },
+        "fontFamily": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "content",
+        "id",
+        "level",
+        "styles",
+        "textAlign",
+        "type"
+      ],
+      "additionalProperties": false
+    },
+    "HeadingLevel": {
+      "type": "number",
+      "enum": [
+        1,
+        2,
+        3,
+        4
+      ]
+    },
+    "ParagraphBlock": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "type": {
+          "type": "string",
+          "const": "paragraph"
+        },
+        "styles": {
+          "$ref": "#/definitions/BlockStyles"
+        },
+        "visibility": {
+          "$ref": "#/definitions/BlockVisibility"
+        },
+        "displayCondition": {
+          "type": "object",
+          "properties": {
+            "label": {
+              "type": "string"
+            },
+            "before": {
+              "type": "string"
+            },
+            "after": {
+              "type": "string"
+            },
+            "group": {
+              "type": "string"
+            },
+            "description": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "label",
+            "before",
+            "after"
+          ],
+          "additionalProperties": false
+        },
+        "content": {
+          "type": "string"
+        },
+        "paragraphSpacing": {
+          "type": "number",
+          "description": "Gap in px between this block's paragraphs — the space below every `<p>` except the last. Absent means `RICH_TEXT_SPACING.paragraphGap`.\n\nOnly affects a block holding more than one paragraph; a single `<p>` has no internal gap, and the space around the block is `styles.padding`.\n\n`0` is a valid choice (paragraphs butted together) and is distinct from the field being absent, so readers must test for `undefined` rather than falsiness."
+        }
+      },
+      "required": [
+        "content",
+        "id",
+        "styles",
+        "type"
+      ],
+      "additionalProperties": false
+    },
+    "ImageBlock": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "type": {
+          "type": "string",
+          "const": "image"
+        },
+        "styles": {
+          "$ref": "#/definitions/BlockStyles"
+        },
+        "visibility": {
+          "$ref": "#/definitions/BlockVisibility"
+        },
+        "displayCondition": {
+          "type": "object",
+          "properties": {
+            "label": {
+              "type": "string"
+            },
+            "before": {
+              "type": "string"
+            },
+            "after": {
+              "type": "string"
+            },
+            "group": {
+              "type": "string"
+            },
+            "description": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "label",
+            "before",
+            "after"
+          ],
+          "additionalProperties": false
+        },
+        "src": {
+          "type": "string"
+        },
+        "alt": {
+          "type": "string"
+        },
+        "width": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "string",
+              "const": "full"
+            }
+          ]
+        },
+        "height": {
+          "type": "number",
+          "description": "Height in pixels. Absent means the height is derived from the width, so the image keeps its aspect ratio — setting both stretches it, since email clients don't support `object-fit`."
+        },
+        "naturalWidth": {
+          "type": "number",
+          "description": "The image file's own size in px, when known: given by the media library, read by an importer, or measured in the editor during an edit. Both or neither; one without the other reads as unknown. It drives the editor's aspect-ratio lock and is never rendered. Cleared when `src` changes without a new size alongside it."
+        },
+        "naturalHeight": {
+          "type": "number"
+        },
+        "align": {
+          "type": "string",
+          "enum": [
+            "left",
+            "center",
+            "right"
+          ]
+        },
+        "borderRadius": {
+          "$ref": "#/definitions/BorderRadiusValue",
+          "description": "Corner radius in px. Omitted/0 = square corners. A radius of at least half the rendered size rounds a square image to a circle, which is how avatar and portrait layouts are built. A radius per corner is also accepted."
+        },
+        "border": {
+          "$ref": "#/definitions/BorderValue",
+          "description": "Border around the image itself, per side. Omitted = no border; a side with width 0 is not drawn."
+        },
+        "linkUrl": {
+          "type": "string"
+        },
+        "linkOpenInNewTab": {
+          "type": "boolean"
+        },
+        "placeholderUrl": {
+          "type": "string"
+        },
+        "decorative": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "align",
+        "alt",
+        "id",
+        "src",
+        "styles",
+        "type",
+        "width"
+      ],
+      "additionalProperties": false
+    },
+    "ButtonBlock": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "type": {
+          "type": "string",
+          "const": "button"
+        },
+        "styles": {
+          "$ref": "#/definitions/BlockStyles"
+        },
+        "visibility": {
+          "$ref": "#/definitions/BlockVisibility"
+        },
+        "displayCondition": {
+          "type": "object",
+          "properties": {
+            "label": {
+              "type": "string"
+            },
+            "before": {
+              "type": "string"
+            },
+            "after": {
+              "type": "string"
+            },
+            "group": {
+              "type": "string"
+            },
+            "description": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "label",
+            "before",
+            "after"
+          ],
+          "additionalProperties": false
+        },
+        "text": {
+          "type": "string"
+        },
+        "url": {
+          "type": "string"
+        },
+        "openInNewTab": {
+          "type": "boolean"
+        },
+        "backgroundColor": {
+          "type": "string"
+        },
+        "textColor": {
+          "type": "string"
+        },
+        "borderRadius": {
+          "$ref": "#/definitions/BorderRadiusValue",
+          "description": "Corner radius in px — one number, or a radius per corner."
+        },
+        "border": {
+          "$ref": "#/definitions/BorderValue",
+          "description": "Border around the button itself, per side. Omitted = no border; a side with width 0 is not drawn. For an outline (\"ghost\") button, set `backgroundColor` to the keyword `\"transparent\"` (the background control stores it) and set `textColor` too — a new button is `#333333` with white text. An empty fill exports as `transparent`, because MJML paints `#414141` when the attribute is omitted."
+        },
+        "fontSize": {
+          "type": "number"
+        },
+        "buttonPadding": {
+          "$ref": "#/definitions/SpacingValue"
+        },
+        "fontFamily": {
+          "type": "string"
+        },
+        "width": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "string",
+              "const": "full"
+            }
+          ]
+        },
+        "align": {
+          "type": "string",
+          "enum": [
+            "left",
+            "center",
+            "right"
+          ],
+          "description": "Placement of the button within its column. No visible effect when `width` is `\"full\"`, since the button then spans the column."
+        }
+      },
+      "required": [
+        "align",
+        "backgroundColor",
+        "borderRadius",
+        "buttonPadding",
+        "fontSize",
+        "id",
+        "styles",
+        "text",
+        "textColor",
+        "type",
+        "url"
+      ],
+      "additionalProperties": false
+    },
+    "DividerBlock": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "type": {
+          "type": "string",
+          "const": "divider"
+        },
+        "styles": {
+          "$ref": "#/definitions/BlockStyles"
+        },
+        "visibility": {
+          "$ref": "#/definitions/BlockVisibility"
+        },
+        "displayCondition": {
+          "type": "object",
+          "properties": {
+            "label": {
+              "type": "string"
+            },
+            "before": {
+              "type": "string"
+            },
+            "after": {
+              "type": "string"
+            },
+            "group": {
+              "type": "string"
+            },
+            "description": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "label",
+            "before",
+            "after"
+          ],
+          "additionalProperties": false
+        },
+        "lineStyle": {
+          "type": "string",
+          "enum": [
+            "solid",
+            "dashed",
+            "dotted"
+          ]
+        },
+        "color": {
+          "type": "string"
+        },
+        "thickness": {
+          "type": "number"
+        },
+        "width": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "string",
+              "const": "full"
+            },
+            {
+              "$ref": "#/definitions/DividerPercentWidth"
+            }
+          ],
+          "description": "`\"full\"` spans the column and a number is pixels. A percentage is a share of the column: MJML renders it natively, and it shrinks with the column on a phone where a pixel width would overflow."
+        }
+      },
+      "required": [
+        "color",
+        "id",
+        "lineStyle",
+        "styles",
+        "thickness",
+        "type",
+        "width"
+      ],
+      "additionalProperties": false
+    },
+    "DividerPercentWidth": {
+      "type": "string",
+      "description": "A share of the column, from `\"0%\"` to `\"100%\"`.",
+      "pattern": "^(?:100(?:\\.0+)?|\\d{1,2}(?:\\.\\d+)?)%$"
+    },
+    "VideoBlock": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "type": {
+          "type": "string",
+          "const": "video"
+        },
+        "styles": {
+          "$ref": "#/definitions/BlockStyles"
+        },
+        "visibility": {
+          "$ref": "#/definitions/BlockVisibility"
+        },
+        "displayCondition": {
+          "type": "object",
+          "properties": {
+            "label": {
+              "type": "string"
+            },
+            "before": {
+              "type": "string"
+            },
+            "after": {
+              "type": "string"
+            },
+            "group": {
+              "type": "string"
+            },
+            "description": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "label",
+            "before",
+            "after"
+          ],
+          "additionalProperties": false
+        },
+        "url": {
+          "type": "string"
+        },
+        "openInNewTab": {
+          "type": "boolean"
+        },
+        "thumbnailUrl": {
+          "type": "string"
+        },
+        "alt": {
+          "type": "string"
+        },
+        "width": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "string",
+              "const": "full"
+            }
+          ]
+        },
+        "height": {
+          "type": "number",
+          "description": "Height in pixels for the thumbnail. Absent means the height is derived from the width, so the thumbnail keeps its aspect ratio — setting both stretches it, since email clients don't support `object-fit`."
+        },
+        "align": {
+          "type": "string",
+          "enum": [
+            "left",
+            "center",
+            "right"
+          ]
+        },
+        "placeholderUrl": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "align",
+        "alt",
+        "id",
+        "styles",
+        "thumbnailUrl",
+        "type",
+        "url",
+        "width"
+      ],
+      "additionalProperties": false
+    },
+    "SocialIconsBlock": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "type": {
+          "type": "string",
+          "const": "social"
+        },
+        "styles": {
+          "$ref": "#/definitions/BlockStyles"
+        },
+        "visibility": {
+          "$ref": "#/definitions/BlockVisibility"
+        },
+        "displayCondition": {
+          "type": "object",
+          "properties": {
+            "label": {
+              "type": "string"
+            },
+            "before": {
+              "type": "string"
+            },
+            "after": {
+              "type": "string"
+            },
+            "group": {
+              "type": "string"
+            },
+            "description": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "label",
+            "before",
+            "after"
+          ],
+          "additionalProperties": false
+        },
+        "icons": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/SocialIcon"
+          }
+        },
+        "iconStyle": {
+          "$ref": "#/definitions/SocialIconStyle"
+        },
+        "iconTone": {
+          "$ref": "#/definitions/SocialIconTone",
+          "description": "Absent means `\"brand\"`."
+        },
+        "iconSize": {
+          "$ref": "#/definitions/SocialIconSize"
+        },
+        "spacing": {
+          "type": "number"
+        },
+        "align": {
+          "type": "string",
+          "enum": [
+            "left",
+            "center",
+            "right"
+          ]
+        }
+      },
+      "required": [
+        "align",
+        "iconSize",
+        "iconStyle",
+        "icons",
+        "id",
+        "spacing",
+        "styles",
+        "type"
+      ],
+      "additionalProperties": false
+    },
+    "SocialIcon": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "platform": {
+          "$ref": "#/definitions/SocialPlatform"
+        },
+        "url": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "id",
+        "platform",
+        "url"
+      ],
+      "additionalProperties": false
+    },
+    "SocialPlatform": {
+      "type": "string",
+      "enum": [
+        "facebook",
+        "twitter",
+        "instagram",
+        "linkedin",
+        "youtube",
+        "tiktok",
+        "pinterest",
+        "email",
+        "whatsapp",
+        "telegram",
+        "discord",
+        "snapchat",
+        "reddit",
+        "github",
+        "dribbble",
+        "behance",
+        "website"
+      ]
+    },
+    "SocialIconStyle": {
+      "type": "string",
+      "enum": [
+        "solid",
+        "outlined",
+        "rounded",
+        "square",
+        "circle",
+        "plain"
+      ],
+      "description": "The icon's shape. `plain` is the glyph alone, with no badge or outline."
+    },
+    "SocialIconTone": {
+      "type": "string",
+      "enum": [
+        "brand",
+        "dark",
+        "light"
+      ],
+      "description": "The colors an icon is drawn in: each platform's own brand color, or one tone (dark or light) for every icon."
+    },
+    "SocialIconSize": {
+      "type": "string",
+      "enum": [
+        "small",
+        "medium",
+        "large"
+      ]
+    },
+    "SpacerBlock": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "type": {
+          "type": "string",
+          "const": "spacer"
+        },
+        "styles": {
+          "$ref": "#/definitions/BlockStyles"
+        },
+        "visibility": {
+          "$ref": "#/definitions/BlockVisibility"
+        },
+        "displayCondition": {
+          "type": "object",
+          "properties": {
+            "label": {
+              "type": "string"
+            },
+            "before": {
+              "type": "string"
+            },
+            "after": {
+              "type": "string"
+            },
+            "group": {
+              "type": "string"
+            },
+            "description": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "label",
+            "before",
+            "after"
+          ],
+          "additionalProperties": false
+        },
+        "height": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "height",
+        "id",
+        "styles",
+        "type"
+      ],
+      "additionalProperties": false
+    },
+    "HtmlBlock": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "type": {
+          "type": "string",
+          "const": "html"
+        },
+        "styles": {
+          "$ref": "#/definitions/BlockStyles"
+        },
+        "visibility": {
+          "$ref": "#/definitions/BlockVisibility"
+        },
+        "displayCondition": {
+          "type": "object",
+          "properties": {
+            "label": {
+              "type": "string"
+            },
+            "before": {
+              "type": "string"
+            },
+            "after": {
+              "type": "string"
+            },
+            "group": {
+              "type": "string"
+            },
+            "description": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "label",
+            "before",
+            "after"
+          ],
+          "additionalProperties": false
+        },
+        "content": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "content",
+        "id",
+        "styles",
+        "type"
+      ],
+      "additionalProperties": false
+    },
+    "MenuBlock": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "type": {
+          "type": "string",
+          "const": "menu"
+        },
+        "styles": {
+          "$ref": "#/definitions/BlockStyles"
+        },
+        "visibility": {
+          "$ref": "#/definitions/BlockVisibility"
+        },
+        "displayCondition": {
+          "type": "object",
+          "properties": {
+            "label": {
+              "type": "string"
+            },
+            "before": {
+              "type": "string"
+            },
+            "after": {
+              "type": "string"
+            },
+            "group": {
+              "type": "string"
+            },
+            "description": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "label",
+            "before",
+            "after"
+          ],
+          "additionalProperties": false
+        },
+        "items": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/MenuItemData"
+          }
+        },
+        "fontSize": {
+          "type": "number"
+        },
+        "fontFamily": {
+          "type": "string"
+        },
+        "color": {
+          "type": "string",
+          "description": "Base text/link color. Unset = inherit the document-level `textColor`."
+        },
+        "linkColor": {
+          "type": "string"
+        },
+        "textAlign": {
+          "type": "string",
+          "enum": [
+            "left",
+            "center",
+            "right"
+          ]
+        },
+        "separator": {
+          "type": "string"
+        },
+        "separatorColor": {
+          "type": "string"
+        },
+        "spacing": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "fontSize",
+        "id",
+        "items",
+        "separator",
+        "separatorColor",
+        "spacing",
+        "styles",
+        "textAlign",
+        "type"
+      ],
+      "additionalProperties": false
+    },
+    "MenuItemData": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "text": {
+          "type": "string"
+        },
+        "url": {
+          "type": "string"
+        },
+        "openInNewTab": {
+          "type": "boolean"
+        },
+        "bold": {
+          "type": "boolean"
+        },
+        "underline": {
+          "type": "boolean"
+        },
+        "color": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "id",
+        "text",
+        "url",
+        "openInNewTab",
+        "bold",
+        "underline"
+      ],
+      "additionalProperties": false
+    },
+    "TableBlock": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "type": {
+          "type": "string",
+          "const": "table"
+        },
+        "styles": {
+          "$ref": "#/definitions/BlockStyles"
+        },
+        "visibility": {
+          "$ref": "#/definitions/BlockVisibility"
+        },
+        "displayCondition": {
+          "type": "object",
+          "properties": {
+            "label": {
+              "type": "string"
+            },
+            "before": {
+              "type": "string"
+            },
+            "after": {
+              "type": "string"
+            },
+            "group": {
+              "type": "string"
+            },
+            "description": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "label",
+            "before",
+            "after"
+          ],
+          "additionalProperties": false
+        },
+        "rows": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/TableRowData"
+          }
+        },
+        "hasHeaderRow": {
+          "type": "boolean"
+        },
+        "headerBackgroundColor": {
+          "type": "string"
+        },
+        "borderColor": {
+          "type": "string"
+        },
+        "borderWidth": {
+          "type": "number"
+        },
+        "cellPadding": {
+          "type": "number"
+        },
+        "fontSize": {
+          "type": "number"
+        },
+        "fontFamily": {
+          "type": "string"
+        },
+        "color": {
+          "type": "string",
+          "description": "Text color. Unset = inherit the document-level `textColor`."
+        },
+        "textAlign": {
+          "type": "string",
+          "enum": [
+            "left",
+            "center",
+            "right"
+          ]
+        }
+      },
+      "required": [
+        "borderColor",
+        "borderWidth",
+        "cellPadding",
+        "fontSize",
+        "hasHeaderRow",
+        "id",
+        "rows",
+        "styles",
+        "textAlign",
+        "type"
+      ],
+      "additionalProperties": false
+    },
+    "TableRowData": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "cells": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/TableCellData"
+          }
+        }
+      },
+      "required": [
+        "id",
+        "cells"
+      ],
+      "additionalProperties": false
+    },
+    "TableCellData": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "content": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "id",
+        "content"
+      ],
+      "additionalProperties": false
+    },
+    "CountdownBlock": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "type": {
+          "type": "string",
+          "const": "countdown"
+        },
+        "styles": {
+          "$ref": "#/definitions/BlockStyles"
+        },
+        "visibility": {
+          "$ref": "#/definitions/BlockVisibility"
+        },
+        "displayCondition": {
+          "type": "object",
+          "properties": {
+            "label": {
+              "type": "string"
+            },
+            "before": {
+              "type": "string"
+            },
+            "after": {
+              "type": "string"
+            },
+            "group": {
+              "type": "string"
+            },
+            "description": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "label",
+            "before",
+            "after"
+          ],
+          "additionalProperties": false
+        },
+        "targetDate": {
+          "type": "string"
+        },
+        "timezone": {
+          "type": "string"
+        },
+        "showDays": {
+          "type": "boolean"
+        },
+        "showHours": {
+          "type": "boolean"
+        },
+        "showMinutes": {
+          "type": "boolean"
+        },
+        "showSeconds": {
+          "type": "boolean"
+        },
+        "separator": {
+          "type": "string",
+          "enum": [
+            ":",
+            "-",
+            " "
+          ]
+        },
+        "digitFontSize": {
+          "type": "number"
+        },
+        "digitColor": {
+          "type": "string"
+        },
+        "labelColor": {
+          "type": "string"
+        },
+        "labelFontSize": {
+          "type": "number"
+        },
+        "backgroundColor": {
+          "type": "string"
+        },
+        "fontFamily": {
+          "type": "string"
+        },
+        "labelDays": {
+          "type": "string"
+        },
+        "labelHours": {
+          "type": "string"
+        },
+        "labelMinutes": {
+          "type": "string"
+        },
+        "labelSeconds": {
+          "type": "string"
+        },
+        "expiredMessage": {
+          "type": "string"
+        },
+        "expiredImageUrl": {
+          "type": "string"
+        },
+        "hideOnExpiry": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "backgroundColor",
+        "digitColor",
+        "digitFontSize",
+        "expiredImageUrl",
+        "expiredMessage",
+        "hideOnExpiry",
+        "id",
+        "labelColor",
+        "labelDays",
+        "labelFontSize",
+        "labelHours",
+        "labelMinutes",
+        "labelSeconds",
+        "separator",
+        "showDays",
+        "showHours",
+        "showMinutes",
+        "showSeconds",
+        "styles",
+        "targetDate",
+        "timezone",
+        "type"
+      ],
+      "additionalProperties": false
+    },
+    "CustomBlock": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "type": {
+          "type": "string",
+          "const": "custom"
+        },
+        "styles": {
+          "$ref": "#/definitions/BlockStyles"
+        },
+        "visibility": {
+          "$ref": "#/definitions/BlockVisibility"
+        },
+        "displayCondition": {
+          "type": "object",
+          "properties": {
+            "label": {
+              "type": "string"
+            },
+            "before": {
+              "type": "string"
+            },
+            "after": {
+              "type": "string"
+            },
+            "group": {
+              "type": "string"
+            },
+            "description": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "label",
+            "before",
+            "after"
+          ],
+          "additionalProperties": false
+        },
+        "customType": {
+          "type": "string"
+        },
+        "fieldValues": {
+          "type": "object",
+          "additionalProperties": {}
+        },
+        "renderedHtml": {
+          "type": "string"
+        },
+        "renderedStylesheet": {
+          "type": "string",
+          "description": "The definition's `stylesheet`, copied in when `renderedHtml` is written. A render provider's backend, and Cloud rendering from storage, have no definition to ask, so `@templatical/renderer` emits this when no `getCustomBlockStylesheet` resolver is passed. A resolver, when passed, decides every type, so a stale copy never overrides a live definition."
+        },
+        "dataSourceFetched": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "customType",
+        "fieldValues",
+        "id",
+        "styles",
+        "type"
+      ],
+      "additionalProperties": false
+    },
+    "SlotBlock": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "type": {
+          "type": "string",
+          "const": "slot"
+        },
+        "styles": {
+          "$ref": "#/definitions/BlockStyles"
+        },
+        "visibility": {
+          "$ref": "#/definitions/BlockVisibility"
+        },
+        "displayCondition": {
+          "type": "object",
+          "properties": {
+            "label": {
+              "type": "string"
+            },
+            "before": {
+              "type": "string"
+            },
+            "after": {
+              "type": "string"
+            },
+            "group": {
+              "type": "string"
+            },
+            "description": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "label",
+            "before",
+            "after"
+          ],
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "id",
+        "styles",
+        "type"
+      ],
+      "additionalProperties": false,
+      "description": "Layout-only hole where authored content is spliced in. Extends BaseBlock so Block walkers stay typed (`styles` unused; spliced out before render)."
+    },
+    "WrapperBlock": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "type": {
+          "type": "string",
+          "const": "wrapper"
+        },
+        "styles": {
+          "$ref": "#/definitions/BlockStyles"
+        },
+        "visibility": {
+          "$ref": "#/definitions/BlockVisibility"
+        },
+        "displayCondition": {
+          "type": "object",
+          "properties": {
+            "label": {
+              "type": "string"
+            },
+            "before": {
+              "type": "string"
+            },
+            "after": {
+              "type": "string"
+            },
+            "group": {
+              "type": "string"
+            },
+            "description": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "label",
+            "before",
+            "after"
+          ],
+          "additionalProperties": false
+        },
+        "children": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Block"
+          }
+        },
+        "borderRadius": {
+          "type": "number"
+        },
+        "backgroundImage": {
+          "$ref": "#/definitions/BackgroundImage",
+          "description": "Image behind the band; `styles.backgroundColor` is its fallback."
+        }
+      },
+      "required": [
+        "children",
+        "id",
+        "styles",
+        "type"
+      ],
+      "additionalProperties": false,
+      "description": "Layout-only band rendered as `mj-wrapper`. The block is the band: `styles.backgroundColor` / `styles.padding` / `borderRadius` / `backgroundImage` map to the wrapper. Legal in layout only."
+    },
+    "TemplateSettings": {
+      "type": "object",
+      "properties": {
+        "width": {
+          "type": "number"
+        },
+        "backgroundColor": {
+          "type": "string"
+        },
+        "textColor": {
+          "type": "string",
+          "description": "Document-level default text color: the `<mj-text>` default in the rendered MJML, inherited by every text block (Title, Paragraph, Menu, Table) that doesn't set its own `color`. Required, defaulting to `#1a1a1a` (see `DEFAULT_TEMPLATE_DEFAULTS`); customize the default per-consumer via `templateDefaults`. A block's explicit `color` or an inline text-color mark overrides it."
+        },
+        "linkColor": {
+          "type": "string",
+          "description": "Document-level link color: emitted as the global `a { color }` rule in the rendered MJML, so it cascades to every link — rich-text and menu alike. Optional: when unset, links inherit the surrounding text color (`color: inherit`), preserving the pre-#352 default. A per-block or per-item color (a Menu item's `color`, `MenuBlock.linkColor`) still overrides it."
+        },
+        "linkUnderline": {
+          "type": "boolean",
+          "description": "Whether links are underlined document-wide: drives the global `a { text-decoration }` rule (`underline` when true, `none` when false). Required, defaulting to `true` (see `DEFAULT_TEMPLATE_DEFAULTS`) — the common, more accessible email default. Applies to body (rich-text) links; buttons and menu items carry their own inline `text-decoration` and are unaffected. Set `false` to render links without an underline."
+        },
+        "fontFamily": {
+          "type": "string"
+        },
+        "preheaderText": {
+          "type": "string"
+        },
+        "locale": {
+          "type": "string",
+          "description": "BCP-47 language code for the rendered email's `<html lang>`. Drives screen-reader pronunciation. Default `'en'` via `DEFAULT_TEMPLATE_DEFAULTS`."
+        },
+        "direction": {
+          "$ref": "#/definitions/ContentDirection",
+          "description": "Writing direction of the delivered email: the canvas `dir` and the rendered `<mjml dir>`. Independent of the editor chrome (`init({ locale })`). Optional: when unset, `resolveContentDirection` falls through to the content language (`ar` / `he` / `fa` / … → `\"rtl\"`, otherwise `\"ltr\"`). An explicit `\"ltr\"` on an Arabic template is a stated decision, not a missing value."
+        }
+      },
+      "required": [
+        "width",
+        "backgroundColor",
+        "textColor",
+        "linkUnderline",
+        "fontFamily",
+        "locale"
+      ],
+      "additionalProperties": false
+    },
+    "ContentDirection": {
+      "type": "string",
+      "enum": [
+        "ltr",
+        "rtl"
+      ],
+      "description": "Writing direction of the delivered email — the canvas `dir` and the rendered `<mjml dir>`. Independent of the editor chrome language (`init({ locale })`)."
+    }
+  }
+}