@samva/markup 0.1.2 → 0.2.0

package/generated/sml-agent-contract.json

@@ -1,917 +1,709 @@
 {
-  "version": "0.0.0",
-  "qualityBar": [
-    "valid Samva compile",
-    "visually faithful light render",
-    "visually faithful dark render when source has dark mode",
-    "editor-friendly classes and semantic tokens",
-    "no raw HTML tags",
-    "reusable placeholders and template abstractions",
-    "repair compile diagnostics before claiming done"
-  ],
-  "primitives": [
-    {
-      "channel": "email",
-      "tag": "Email",
+  "version": 2,
+  "channel": "email",
+  "authoring": {
+    "extension": ".tsx",
+    "jsxImportSource": "@samva/markup/email",
+    "definition": "defineEmail",
+    "definitionImport": "@samva/markup/template",
+    "fields": ["id", "schema", "fixtures", "render", "runtime?"],
+    "identity": "Stable project-unique id; helper modules are excluded from the catalog.",
+    "namePattern": "^[A-Za-z0-9_][A-Za-z0-9._-]*$",
+    "schema": "Standard JSON Schema v1 converter; portable JSON Schema 2020-12 input, without coercion or inserted defaults.",
+    "render": "Synchronous TypeScript over actual validated JSON; returns subject, optional preheader, body and optional text.",
+    "controlFlow": "Ordinary functions, imports, conditions and array mapping."
+  },
+  "components": {
+    "import": "@samva/markup/email/components",
+    "names": [
+      "Button",
+      "Column",
+      "Columns",
+      "Divider",
+      "Email",
+      "Image",
+      "Link",
+      "Section",
+      "Spacer"
+    ]
+  },
+  "elements": {
+    "html": {
+      "content": "flow",
+      "layout": "document",
       "attributes": {
-        "lang": {
-          "type": "string",
-          "required": false
+        "xmlns": {
+          "type": "string"
         },
-        "dir": {
-          "type": "string",
-          "required": false
+        "xmlns:o": {
+          "type": "string"
         },
-        "width": {
-          "type": "number",
-          "required": false,
-          "min": 1,
-          "max": 10000
+        "xmlns:v": {
+          "type": "string"
         },
-        "class": {
-          "type": "string",
-          "required": false
+        "xmlns:w": {
+          "type": "string"
         }
       },
-      "children": "Subject?, Preview?, blocks",
-      "description": "Email document root. Exactly one root per template; wraps the whole message."
+      "childElements": ["head", "body"]
     },
-    {
-      "channel": "email",
-      "tag": "Subject",
+    "head": {
+      "content": "flow",
+      "layout": "metadata",
       "attributes": {},
-      "children": "text, {{vars}}",
-      "description": "Email subject line. Text and interpolations only; must appear before body blocks."
+      "childElements": ["title", "meta", "style"]
     },
-    {
-      "channel": "email",
-      "tag": "Preview",
-      "attributes": {},
-      "children": "text, {{vars}}",
-      "description": "Inbox preview text (hidden in the body). Text and interpolations only."
+    "title": {
+      "content": "text",
+      "layout": "metadata",
+      "attributes": {}
     },
-    {
-      "channel": "email",
-      "tag": "Container",
+    "style": {
+      "content": "raw",
+      "layout": "metadata",
       "attributes": {
-        "class": {
-          "type": "string",
-          "required": false
+        "type": {
+          "type": "string"
+        }
+      }
+    },
+    "meta": {
+      "content": "void",
+      "layout": "metadata",
+      "attributes": {
+        "name": {
+          "type": "string"
         },
-        "backgroundImage": {
-          "type": "string",
-          "required": false
+        "content": {
+          "type": "string"
         },
-        "backgroundPosition": {
-          "type": "string",
-          "required": false,
-          "values": ["center", "top", "bottom"]
+        "charset": {
+          "type": "string"
         },
-        "backgroundSize": {
+        "http-equiv": {
+          "type": "string"
+        }
+      }
+    },
+    "body": {
+      "content": "flow",
+      "layout": "block",
+      "attributes": {
+        "bgcolor": {
+          "type": "string"
+        }
+      }
+    },
+    "div": {
+      "content": "flow",
+      "layout": "block",
+      "attributes": {
+        "align": {
           "type": "string",
-          "required": false,
-          "values": ["cover", "contain", "auto"]
+          "values": ["left", "center", "right"]
         }
-      },
-      "children": "blocks",
-      "description": "Centered 600px max-width wrapper. Compiles to a table on the outlook-safe base."
+      }
     },
-    {
-      "channel": "email",
-      "tag": "Section",
+    "section": {
+      "content": "flow",
+      "layout": "block",
       "attributes": {
-        "class": {
+        "align": {
           "type": "string",
-          "required": false
-        },
-        "backgroundImage": {
+          "values": ["left", "center", "right"]
+        }
+      }
+    },
+    "article": {
+      "content": "flow",
+      "layout": "block",
+      "attributes": {
+        "align": {
           "type": "string",
-          "required": false
-        },
-        "backgroundPosition": {
+          "values": ["left", "center", "right"]
+        }
+      }
+    },
+    "header": {
+      "content": "flow",
+      "layout": "block",
+      "attributes": {
+        "align": {
           "type": "string",
-          "required": false,
-          "values": ["center", "top", "bottom"]
-        },
-        "backgroundSize": {
+          "values": ["left", "center", "right"]
+        }
+      }
+    },
+    "footer": {
+      "content": "flow",
+      "layout": "block",
+      "attributes": {
+        "align": {
           "type": "string",
-          "required": false,
-          "values": ["cover", "contain", "auto"]
+          "values": ["left", "center", "right"]
         }
-      },
-      "children": "blocks",
-      "description": "Full-width band. Padding splits onto the inner cell for Outlook/Klaviyo."
+      }
     },
-    {
-      "channel": "email",
-      "tag": "Row",
+    "main": {
+      "content": "flow",
+      "layout": "block",
       "attributes": {
-        "class": {
+        "align": {
           "type": "string",
-          "required": false
+          "values": ["left", "center", "right"]
         }
-      },
-      "children": "Column+",
-      "description": "Horizontal layout. Children must be <Column>. Use instead of flex/grid."
+      }
+    },
+    "center": {
+      "content": "flow",
+      "layout": "block",
+      "attributes": {}
     },
-    {
-      "channel": "email",
-      "tag": "Column",
+    "p": {
+      "content": "flow",
+      "layout": "block",
       "attributes": {
-        "class": {
+        "align": {
           "type": "string",
-          "required": false
-        },
-        "width": {
+          "values": ["left", "center", "right"]
+        }
+      }
+    },
+    "blockquote": {
+      "content": "flow",
+      "layout": "block",
+      "attributes": {
+        "align": {
           "type": "string",
-          "required": false
-        },
-        "valign": {
+          "values": ["left", "center", "right"]
+        }
+      }
+    },
+    "pre": {
+      "content": "flow",
+      "layout": "preformatted",
+      "attributes": {}
+    },
+    "h1": {
+      "content": "flow",
+      "layout": "block",
+      "attributes": {
+        "align": {
           "type": "string",
-          "required": false,
-          "values": ["top", "middle", "bottom"]
+          "values": ["left", "center", "right"]
         }
-      },
-      "children": "blocks",
-      "description": "A cell inside a <Row>. `width` is an HTML width (e.g. \"50%\", \"300\")."
+      }
     },
-    {
-      "channel": "email",
-      "tag": "Heading",
+    "h2": {
+      "content": "flow",
+      "layout": "block",
       "attributes": {
-        "level": {
-          "type": "number",
-          "required": false,
-          "min": 1,
-          "max": 6
-        },
-        "class": {
+        "align": {
           "type": "string",
-          "required": false
+          "values": ["left", "center", "right"]
         }
-      },
-      "children": "text, {{vars}}, strong, em, a",
-      "description": "Renders <h1>-<h6> by `level` (default 1)."
+      }
     },
-    {
-      "channel": "email",
-      "tag": "Text",
+    "h3": {
+      "content": "flow",
+      "layout": "block",
       "attributes": {
-        "class": {
+        "align": {
           "type": "string",
-          "required": false
+          "values": ["left", "center", "right"]
         }
-      },
-      "children": "text, {{vars}}, strong, em, a",
-      "description": "Paragraph. Ships sane font-size/line-height/margin defaults."
+      }
     },
-    {
-      "channel": "email",
-      "tag": "Button",
+    "h4": {
+      "content": "flow",
+      "layout": "block",
       "attributes": {
-        "href": {
+        "align": {
+          "type": "string",
+          "values": ["left", "center", "right"]
+        }
+      }
+    },
+    "h5": {
+      "content": "flow",
+      "layout": "block",
+      "attributes": {
+        "align": {
+          "type": "string",
+          "values": ["left", "center", "right"]
+        }
+      }
+    },
+    "h6": {
+      "content": "flow",
+      "layout": "block",
+      "attributes": {
+        "align": {
           "type": "string",
+          "values": ["left", "center", "right"]
+        }
+      }
+    },
+    "span": {
+      "content": "flow",
+      "layout": "inline",
+      "attributes": {}
+    },
+    "strong": {
+      "content": "flow",
+      "layout": "inline",
+      "attributes": {}
+    },
+    "b": {
+      "content": "flow",
+      "layout": "inline",
+      "attributes": {}
+    },
+    "em": {
+      "content": "flow",
+      "layout": "inline",
+      "attributes": {}
+    },
+    "i": {
+      "content": "flow",
+      "layout": "inline",
+      "attributes": {}
+    },
+    "u": {
+      "content": "flow",
+      "layout": "inline",
+      "attributes": {}
+    },
+    "s": {
+      "content": "flow",
+      "layout": "inline",
+      "attributes": {}
+    },
+    "small": {
+      "content": "flow",
+      "layout": "inline",
+      "attributes": {}
+    },
+    "code": {
+      "content": "flow",
+      "layout": "inline",
+      "attributes": {}
+    },
+    "a": {
+      "content": "flow",
+      "layout": "link",
+      "attributes": {
+        "href": {
+          "type": "url",
           "required": true
         },
-        "class": {
-          "type": "string",
-          "required": false
+        "target": {
+          "type": "string"
+        },
+        "rel": {
+          "type": "string"
+        },
+        "name": {
+          "type": "string"
         }
-      },
-      "children": "text, {{vars}}, strong, em",
-      "description": "Link styled as a button. Set padding via classes; the compiler injects the Outlook mso hack."
+      }
     },
-    {
-      "channel": "email",
-      "tag": "Image",
+    "img": {
+      "content": "void",
+      "layout": "image",
       "attributes": {
         "src": {
-          "type": "string",
+          "type": "url",
           "required": true
         },
         "alt": {
           "type": "string",
-          "required": false
+          "required": true
         },
         "width": {
-          "type": "number",
-          "required": false,
-          "min": 0,
-          "max": 10000
+          "type": "measure"
         },
         "height": {
-          "type": "number",
-          "required": false,
-          "min": 0,
-          "max": 10000
+          "type": "measure"
+        },
+        "border": {
+          "type": "measure"
         },
-        "class": {
+        "align": {
           "type": "string",
-          "required": false
+          "values": ["left", "center", "right"]
         }
-      },
-      "children": "Source?",
-      "description": "Responsive image. Always set `alt` for accessibility. Add a <Source scheme=\"dark\"> child to swap the asset in dark mode."
+      }
     },
-    {
-      "channel": "email",
-      "tag": "Source",
+    "table": {
+      "content": "flow",
+      "layout": "table",
       "attributes": {
-        "scheme": {
-          "type": "string",
-          "required": true,
-          "values": ["dark"]
+        "width": {
+          "type": "measure"
         },
-        "src": {
+        "height": {
+          "type": "measure"
+        },
+        "border": {
+          "type": "measure"
+        },
+        "cellpadding": {
+          "type": "measure"
+        },
+        "cellspacing": {
+          "type": "measure"
+        },
+        "align": {
           "type": "string",
-          "required": true
+          "values": ["left", "center", "right"]
+        },
+        "bgcolor": {
+          "type": "string"
         }
       },
-      "children": "void",
-      "description": "Image source variant. Inside <Image>, `scheme=\"dark\"` swaps the asset when dark-mode media queries are honored."
+      "childElements": ["caption", "colgroup", "thead", "tbody", "tfoot", "tr"]
     },
-    {
-      "channel": "email",
-      "tag": "Divider",
+    "caption": {
+      "content": "flow",
+      "layout": "block",
       "attributes": {
-        "class": {
+        "align": {
           "type": "string",
-          "required": false
+          "values": ["left", "center", "right"]
         }
-      },
-      "children": "void",
-      "description": "Horizontal rule (border-top)."
+      }
     },
-    {
-      "channel": "email",
-      "tag": "Spacer",
+    "colgroup": {
+      "content": "flow",
+      "layout": "table-section",
       "attributes": {
-        "height": {
-          "type": "number",
-          "required": true,
-          "min": 1,
-          "max": 2000
+        "span": {
+          "type": "number"
+        },
+        "width": {
+          "type": "measure"
         }
       },
-      "children": "void",
-      "description": "Vertical gap of `height` px."
+      "childElements": ["col"]
     },
-    {
-      "channel": "email",
-      "tag": "List",
+    "col": {
+      "content": "void",
+      "layout": "table-section",
       "attributes": {
-        "type": {
-          "type": "string",
-          "required": false,
-          "values": ["unordered", "ordered"]
+        "span": {
+          "type": "number"
         },
-        "class": {
-          "type": "string",
-          "required": false
+        "width": {
+          "type": "measure"
         }
-      },
-      "children": "ListItem+",
-      "description": "Bulleted or numbered list. `type` is \"unordered\" (default) or \"ordered\". Children must be <ListItem>."
+      }
     },
-    {
-      "channel": "email",
-      "tag": "ListItem",
+    "thead": {
+      "content": "flow",
+      "layout": "table-section",
       "attributes": {
-        "class": {
+        "align": {
           "type": "string",
-          "required": false
+          "values": ["left", "center", "right"]
+        },
+        "valign": {
+          "type": "string",
+          "values": ["top", "middle", "bottom"]
+        },
+        "bgcolor": {
+          "type": "string"
         }
       },
-      "children": "text, {{vars}}, strong, em, a",
-      "description": "A single list row. Inline content only (text, {{vars}}, strong/em/a)."
+      "childElements": ["tr"]
     },
-    {
-      "channel": "email",
-      "tag": "If",
+    "tbody": {
+      "content": "flow",
+      "layout": "table-section",
       "attributes": {
-        "test": {
+        "align": {
           "type": "string",
-          "required": true
+          "values": ["left", "center", "right"]
+        },
+        "valign": {
+          "type": "string",
+          "values": ["top", "middle", "bottom"]
+        },
+        "bgcolor": {
+          "type": "string"
         }
       },
-      "children": "blocks, Else?",
-      "description": "Send-time conditional block. `test` is a predicate over declared variables (see \"Send-time conditionals\" below). Content: blocks, then an optional trailing <Else>."
+      "childElements": ["tr"]
     },
-    {
-      "channel": "email",
-      "tag": "Else",
-      "attributes": {},
-      "children": "blocks",
-      "description": "The false branch of an <If>. Valid only as the last direct child of <If>."
-    },
-    {
-      "channel": "email",
-      "tag": "a",
+    "tfoot": {
+      "content": "flow",
+      "layout": "table-section",
       "attributes": {
-        "href": {
+        "align": {
           "type": "string",
-          "required": true
+          "values": ["left", "center", "right"]
         },
-        "class": {
+        "valign": {
           "type": "string",
-          "required": false
+          "values": ["top", "middle", "bottom"]
+        },
+        "bgcolor": {
+          "type": "string"
         }
       },
-      "children": "text, {{vars}}, strong, em",
-      "description": "Inline link. It has deterministic theme-brand color and underline defaults; use safe classes to override either."
-    },
-    {
-      "channel": "email",
-      "tag": "strong",
-      "attributes": {},
-      "children": "text, {{vars}}, strong, em",
-      "description": "Bold inline text."
+      "childElements": ["tr"]
     },
-    {
-      "channel": "email",
-      "tag": "em",
-      "attributes": {},
-      "children": "text, {{vars}}, strong, em",
-      "description": "Italic inline text."
-    },
-    {
-      "channel": "sms",
-      "tag": "Sms",
+    "tr": {
+      "content": "flow",
+      "layout": "row",
       "attributes": {
-        "category": {
+        "align": {
+          "type": "string",
+          "values": ["left", "center", "right"]
+        },
+        "valign": {
           "type": "string",
-          "required": false,
-          "values": ["transactional", "promotional", "service_implicit"]
+          "values": ["top", "middle", "bottom"]
+        },
+        "bgcolor": {
+          "type": "string"
+        },
+        "height": {
+          "type": "measure"
         }
       },
-      "children": "verbatim text, {{vars}}, If",
-      "description": "SMS document root. The body is VERBATIM text — newlines and space runs are content. No layout tags, no classes."
+      "childElements": ["td", "th"]
     },
-    {
-      "channel": "sms",
-      "tag": "If",
+    "td": {
+      "content": "flow",
+      "layout": "cell",
       "attributes": {
-        "test": {
+        "align": {
           "type": "string",
-          "required": true
+          "values": ["left", "center", "right"]
+        },
+        "valign": {
+          "type": "string",
+          "values": ["top", "middle", "bottom"]
+        },
+        "width": {
+          "type": "measure"
+        },
+        "height": {
+          "type": "measure"
+        },
+        "bgcolor": {
+          "type": "string"
+        },
+        "colspan": {
+          "type": "number"
+        },
+        "rowspan": {
+          "type": "number"
         }
-      },
-      "children": "verbatim text, {{vars}}, If, Else?",
-      "description": "Send-time conditional inline in the body. Content is verbatim text/{{vars}}, then an optional trailing <Else>."
+      }
     },
-    {
-      "channel": "sms",
-      "tag": "Else",
-      "attributes": {},
-      "children": "verbatim text, {{vars}}, If",
-      "description": "The false branch of an <If>; must be its last child. Nothing may follow it, whitespace included."
-    },
-    {
-      "channel": "whatsapp",
-      "tag": "WhatsApp",
+    "th": {
+      "content": "flow",
+      "layout": "cell",
       "attributes": {
-        "name": {
+        "align": {
           "type": "string",
-          "required": false
+          "values": ["left", "center", "right"]
         },
-        "language": {
+        "valign": {
           "type": "string",
-          "required": false
+          "values": ["top", "middle", "bottom"]
         },
-        "category": {
-          "type": "string",
-          "required": true,
-          "values": ["marketing", "utility", "authentication", "service"]
+        "width": {
+          "type": "measure"
+        },
+        "height": {
+          "type": "measure"
+        },
+        "bgcolor": {
+          "type": "string"
+        },
+        "colspan": {
+          "type": "number"
+        },
+        "rowspan": {
+          "type": "number"
         }
-      },
-      "children": "Header?, Body, Footer?, Buttons? (in order)",
-      "description": "WhatsApp template root. Children are Meta's template anatomy in order: Header?, Body, Footer?, Buttons?. `name`/`language` default from the template slug/locale at the API layer."
+      }
     },
-    {
-      "channel": "whatsapp",
-      "tag": "Header",
+    "ul": {
+      "content": "flow",
+      "layout": "list",
+      "attributes": {},
+      "childElements": ["li"]
+    },
+    "ol": {
+      "content": "flow",
+      "layout": "list",
       "attributes": {
+        "start": {
+          "type": "number"
+        },
         "type": {
-          "type": "string",
-          "required": false,
-          "values": ["text", "image", "video", "document"]
+          "type": "string"
         }
       },
-      "children": "verbatim text, {{vars}}, If",
-      "description": "Optional template header. `type` is \"text\" (default, ≤60 chars) or \"image\"/\"video\"/\"document\" (content is the media URL/handle)."
+      "childElements": ["li"]
     },
-    {
-      "channel": "whatsapp",
-      "tag": "Body",
-      "attributes": {},
-      "children": "verbatim text, {{vars}}, If",
-      "description": "Required template body (≤1024 chars). Verbatim text, {{vars}}, and <If> conditionals."
-    },
-    {
-      "channel": "whatsapp",
-      "tag": "Footer",
-      "attributes": {},
-      "children": "verbatim text, {{vars}}, If",
-      "description": "Optional template footer (≤60 chars)."
+    "li": {
+      "content": "flow",
+      "layout": "list-item",
+      "attributes": {}
     },
-    {
-      "channel": "whatsapp",
-      "tag": "Buttons",
-      "attributes": {},
-      "children": "Button+",
-      "description": "Interactive buttons container. Meta limits: ≤10 total, ≤2 url, ≤1 phone."
+    "br": {
+      "content": "void",
+      "layout": "break",
+      "attributes": {}
     },
-    {
-      "channel": "whatsapp",
-      "tag": "Button",
+    "hr": {
+      "content": "void",
+      "layout": "rule",
       "attributes": {
-        "type": {
-          "type": "string",
-          "required": true,
-          "values": ["quick-reply", "url", "phone", "copy-code"]
+        "width": {
+          "type": "measure"
         },
-        "url": {
-          "type": "string",
-          "required": false
+        "size": {
+          "type": "number"
         },
-        "phone": {
-          "type": "string",
-          "required": false
-        }
-      },
-      "children": "verbatim text, {{vars}}, If",
-      "description": "`type` is \"quick-reply\" (label only), \"url\" (requires `url`, ≤2), \"phone\" (requires `phone`, ≤1), or \"copy-code\" (content is the code to copy). Label text ≤25 chars."
-    },
-    {
-      "channel": "whatsapp",
-      "tag": "If",
-      "attributes": {
-        "test": {
+        "align": {
           "type": "string",
-          "required": true
+          "values": ["left", "center", "right"]
         }
-      },
-      "children": "verbatim text, {{vars}}, If, Else?",
-      "description": "Send-time conditional inline in a text slot. Content is verbatim text/{{vars}}, then an optional trailing <Else>."
-    },
-    {
-      "channel": "whatsapp",
-      "tag": "Else",
-      "attributes": {},
-      "children": "verbatim text, {{vars}}, If",
-      "description": "The false branch of an <If>; must be its last child. Nothing may follow it, whitespace included."
+      }
     }
-  ],
-  "utilityFamilies": [
-    {
-      "root": "p",
-      "syntax": "p-*",
-      "descriptions": ["Padding on all sides (p-4 = 16px). Compiles onto table cells for Outlook."]
-    },
-    {
-      "root": "px",
-      "syntax": "px-*",
-      "descriptions": ["Horizontal padding."]
-    },
-    {
-      "root": "py",
-      "syntax": "py-*",
-      "descriptions": ["Vertical padding."]
-    },
-    {
-      "root": "pt",
-      "syntax": "pt-*",
-      "descriptions": ["Top padding."]
-    },
-    {
-      "root": "pr",
-      "syntax": "pr-*",
-      "descriptions": ["Right padding."]
-    },
-    {
-      "root": "pb",
-      "syntax": "pb-*",
-      "descriptions": ["Bottom padding."]
-    },
-    {
-      "root": "pl",
-      "syntax": "pl-*",
-      "descriptions": ["Left padding."]
-    },
-    {
-      "root": "m",
-      "syntax": "m-*",
-      "descriptions": [
-        "Margin on all sides. Warn tier — some clients strip margins. (warn: some clients strip it)"
-      ]
-    },
-    {
-      "root": "mx",
-      "syntax": "mx-*",
-      "descriptions": [
-        "Horizontal margin; mx-auto centers block elements. (warn: some clients strip it)"
-      ]
-    },
-    {
-      "root": "my",
-      "syntax": "my-*",
-      "descriptions": ["Vertical margin. (warn: some clients strip it)"]
-    },
-    {
-      "root": "mt",
-      "syntax": "mt-*",
-      "descriptions": ["Top margin. (warn: some clients strip it)"]
-    },
-    {
-      "root": "mr",
-      "syntax": "mr-*",
-      "descriptions": ["Right margin. (warn: some clients strip it)"]
-    },
-    {
-      "root": "mb",
-      "syntax": "mb-*",
-      "descriptions": ["Bottom margin. (warn: some clients strip it)"]
-    },
-    {
-      "root": "ml",
-      "syntax": "ml-*",
-      "descriptions": ["Left margin. (warn: some clients strip it)"]
-    },
-    {
-      "root": "w",
-      "syntax": "w-*",
-      "descriptions": ["Width from the spacing scale (w-32 = 128px), w-full, or w-[600px]/w-[50%]."]
-    },
-    {
-      "root": "max-w",
-      "syntax": "max-w-*",
-      "descriptions": ["Max width from the container scale (max-w-lg = 512px) or max-w-[600px]."]
-    },
-    {
-      "root": "h",
-      "syntax": "h-*",
-      "descriptions": ["Height from the spacing scale (h-12 = 48px) or h-[80px]."]
-    },
-    {
-      "root": "text",
-      "syntax": "text-*",
-      "descriptions": [
-        "Font size with paired line-height (text-sm = 14px/20px) or bounded px value (text-[15px] = 15px/22.5px). Put an explicit leading-* after it to override line-height.",
-        "Text alignment: text-left, text-center, text-right, text-justify.",
-        "Text color from the palette (text-gray-700) or text-[#374151]."
-      ]
-    },
-    {
-      "root": "leading",
-      "syntax": "leading-*",
-      "descriptions": [
-        "Line height: named ratios (leading-relaxed) or spacing steps (leading-6 = 24px)."
-      ]
-    },
-    {
-      "root": "font",
-      "syntax": "font-*",
-      "descriptions": [
-        "Font weight: font-normal, font-medium, font-semibold, font-bold, ...",
-        "Font stack: font-sans, font-serif, font-mono."
-      ]
-    },
-    {
-      "root": "tracking",
-      "syntax": "tracking-*",
-      "descriptions": [
-        "Letter spacing: tracking-tighter … tracking-widest (em-based; inlines fine in Outlook). Pair tracking-wide/wider with uppercase for eyebrows."
-      ]
-    },
-    {
-      "root": "uppercase",
-      "syntax": "uppercase",
-      "descriptions": ["Uppercase text transform."]
-    },
-    {
-      "root": "underline",
-      "syntax": "underline",
-      "descriptions": ["Underlined text."]
-    },
-    {
-      "root": "no-underline",
-      "syntax": "no-underline",
-      "descriptions": [
-        "Removes the underline (links render underlined by default in most clients)."
-      ]
-    },
-    {
-      "root": "bg",
-      "syntax": "bg-*",
-      "descriptions": ["Background color from the palette (bg-white, bg-blue-600) or bg-[#0088cc]."]
-    },
-    {
-      "root": "bg-gradient",
-      "syntax": "bg-gradient-*",
-      "descriptions": [
-        "Linear gradient background for hero sections: bg-gradient-to-b/t/l/r with from-{color} and to-{color}. Modern base compiles a CSS linear-gradient (plus a solid from-color fallback); the outlook-safe base degrades to the solid from-color — Outlook for Windows never renders the gradient."
-      ]
-    },
-    {
-      "root": "from",
-      "syntax": "from-*",
-      "descriptions": [
-        "Gradient start color (from-indigo-600). Doubles as the solid fallback color on clients without gradient support (Outlook for Windows)."
-      ]
-    },
-    {
-      "root": "to",
-      "syntax": "to-*",
-      "descriptions": ["Gradient end color (to-purple-600)."]
-    },
-    {
-      "root": "border",
-      "syntax": "border-*",
-      "descriptions": [
-        "Solid border width: border (1px), border-2, border-0.",
-        "Border color from the palette (border-gray-200)."
-      ]
-    },
-    {
-      "root": "rounded",
-      "syntax": "rounded-*",
-      "descriptions": [
-        "Border radius (rounded-md = 6px). Ignored by Outlook for Windows — buttons degrade to square corners."
-      ]
-    },
-    {
-      "root": "rounded-t",
-      "syntax": "rounded-t-*",
-      "descriptions": [
-        "Top border radius for card/header blocks (rounded-t-lg). Degrades to square corners in Outlook for Windows."
-      ]
-    },
-    {
-      "root": "rounded-r",
-      "syntax": "rounded-r-*",
-      "descriptions": [
-        "Right-side border radius (rounded-r-lg). Degrades to square corners in Outlook for Windows."
-      ]
-    },
-    {
-      "root": "rounded-b",
-      "syntax": "rounded-b-*",
-      "descriptions": [
-        "Bottom border radius for card/footer blocks (rounded-b-lg). Degrades to square corners in Outlook for Windows."
-      ]
-    },
-    {
-      "root": "rounded-l",
-      "syntax": "rounded-l-*",
-      "descriptions": [
-        "Left-side border radius (rounded-l-lg). Degrades to square corners in Outlook for Windows."
-      ]
-    },
-    {
-      "root": "block",
-      "syntax": "block",
-      "descriptions": ["display: block."]
-    },
-    {
-      "root": "inline-block",
-      "syntax": "inline-block",
-      "descriptions": ["display: inline-block."]
-    },
-    {
-      "root": "hidden",
-      "syntax": "hidden",
-      "descriptions": ["display: none. Pair with sm:block for mobile-only content."]
-    }
-  ],
-  "forbiddenUtilities": [
-    {
-      "match": "flex",
-      "message": "display:flex is unsupported in Outlook for Windows (Word engine) — use <Row>/<Column>"
-    },
-    {
-      "match": "inline-flex",
-      "message": "display:inline-flex is unsupported in Outlook for Windows — use <Row>/<Column>"
-    },
-    {
-      "match": "grid",
-      "message": "display:grid is unsupported in Outlook for Windows and Gmail — use <Row>/<Column>"
-    },
-    {
-      "match": "inline-grid",
-      "message": "display:inline-grid is unsupported in Outlook for Windows — use <Row>/<Column>"
-    },
-    {
-      "match": "gap-",
-      "message": "gap requires flex/grid, unsupported in Outlook for Windows — use padding on <Column>"
-    },
-    {
-      "match": "space-",
-      "message": "space-* margins require selectors Gmail strips — use padding or <Spacer>"
-    },
-    {
-      "match": "items-",
-      "message": "flexbox alignment is unsupported in Outlook for Windows — use <Row>/<Column>"
-    },
-    {
-      "match": "justify-",
-      "message": "flexbox alignment is unsupported in Outlook for Windows — use <Row>/<Column> and text-center"
-    },
-    {
-      "match": "self-",
-      "message": "flexbox alignment is unsupported in Outlook for Windows — use <Row>/<Column>"
-    },
-    {
-      "match": "content-",
-      "message": "flexbox alignment is unsupported in Outlook for Windows — use <Row>/<Column>"
-    },
-    {
-      "match": "order-",
-      "message": "flex order is unsupported in Outlook for Windows — reorder the source instead"
-    },
-    {
-      "match": "absolute",
-      "message": "CSS position is ignored by Gmail and Outlook — use nested <Section>s"
-    },
-    {
-      "match": "relative",
-      "message": "CSS position is ignored by Gmail and Outlook — use nested <Section>s"
-    },
-    {
-      "match": "fixed",
-      "message": "CSS position is ignored by Gmail and Outlook — use nested <Section>s"
-    },
-    {
-      "match": "sticky",
-      "message": "CSS position is ignored by Gmail and Outlook — use nested <Section>s"
-    },
-    {
-      "match": "static",
-      "message": "CSS position is ignored by Gmail and Outlook — remove it"
-    },
-    {
-      "match": "inset-",
-      "message": "position offsets are ignored by Gmail and Outlook — use padding"
-    },
-    {
-      "match": "top-",
-      "message": "position offsets are ignored by Gmail and Outlook — use padding"
-    },
-    {
-      "match": "right-",
-      "message": "position offsets are ignored by Gmail and Outlook — use padding"
-    },
-    {
-      "match": "bottom-",
-      "message": "position offsets are ignored by Gmail and Outlook — use padding"
-    },
-    {
-      "match": "left-",
-      "message": "position offsets are ignored by Gmail and Outlook — use padding"
-    },
-    {
-      "match": "z-",
-      "message": "z-index is ignored by Gmail and Outlook — remove it"
-    },
-    {
-      "match": "float-",
-      "message": "float is unreliable across email clients — use <Row>/<Column>"
-    },
-    {
-      "match": "shadow",
-      "message": "box-shadow is unsupported in Outlook for Windows and Gmail — use a border instead"
-    },
-    {
-      "match": "shadow-",
-      "message": "box-shadow is unsupported in Outlook for Windows and Gmail — use a border instead"
-    },
-    {
-      "match": "opacity-",
-      "message": "opacity is unsupported in Outlook for Windows — bake the tint into the color"
-    },
-    {
-      "match": "transform",
-      "message": "CSS transforms are unsupported in email clients — remove them"
-    },
-    {
-      "match": "rotate-",
-      "message": "CSS transforms are unsupported in email clients — remove them"
-    },
-    {
-      "match": "scale-",
-      "message": "CSS transforms are unsupported in email clients — remove them"
-    },
-    {
-      "match": "translate-",
-      "message": "CSS transforms are unsupported in email clients — remove them"
+  },
+  "globalAttributes": {
+    "id": {
+      "type": "string"
     },
-    {
-      "match": "skew-",
-      "message": "CSS transforms are unsupported in email clients — remove them"
+    "title": {
+      "type": "string"
     },
-    {
-      "match": "transition",
-      "message": "transitions don't run in email — remove them"
+    "lang": {
+      "type": "string"
     },
-    {
-      "match": "transition-",
-      "message": "transitions don't run in email — remove them"
+    "dir": {
+      "type": "string",
+      "values": ["ltr", "rtl", "auto"]
     },
-    {
-      "match": "duration-",
-      "message": "transitions don't run in email — remove them"
-    },
-    {
-      "match": "animate-",
-      "message": "animations don't run in email — remove them"
-    },
-    {
-      "match": "blur-",
-      "message": "CSS filters are unsupported in most email clients — remove them"
-    },
-    {
-      "match": "brightness-",
-      "message": "CSS filters are unsupported in most email clients — remove them"
-    },
-    {
-      "match": "grayscale",
-      "message": "CSS filters are unsupported in most email clients — remove them"
-    },
-    {
-      "match": "grayscale-",
-      "message": "CSS filters are unsupported in most email clients — remove them"
-    },
-    {
-      "match": "truncate",
-      "message": "text truncation is unsupported in Outlook for Windows — shorten the copy"
-    },
-    {
-      "match": "line-clamp-",
-      "message": "line clamping is unsupported in email clients — shorten the copy"
-    },
-    {
-      "match": "aspect-",
-      "message": "aspect-ratio is unsupported in Outlook and Gmail — set width/height on <Image>"
-    },
-    {
-      "match": "overflow-",
-      "message": "overflow is unreliable across email clients — restructure the layout"
-    }
-  ],
-  "repairExamples": [
-    {
-      "from": "flex gap-4",
-      "to": "<Row><Column>...</Column><Column>...</Column></Row>",
-      "reason": "Email layout must use table-backed Row/Column primitives."
-    },
-    {
-      "from": "md:text-lg",
-      "to": "sm:text-lg",
-      "reason": "Only sm: responsive enhancement is supported."
-    },
-    {
-      "from": "bg-[var(--brand)]",
-      "to": "bg-brand or bg-[#4f46e5]",
-      "reason": "Compiled email has no CSS variables; use a token or literal hex."
-    },
-    {
-      "from": "font-[650]",
-      "to": "font-semibold",
-      "reason": "Use the supported named font-weight utilities instead of arbitrary weights."
+    "role": {
+      "type": "string"
     }
+  },
+  "styles": {
+    "css": "Imported CSS follows cascade and specificity; applicable declarations inline and supported media/head rules remain.",
+    "tailwind": "Uses the Tailwind compiler and discoverable source classes; dynamic classes may produce diagnostics.",
+    "layout": "Use email layout primitives for table and Outlook fallbacks; no general flex/grid conversion."
+  },
+  "assets": "Imported assets are content-addressed. Delivery needs their actual HTTPS serving base; local export may use relative URLs. External HTTPS references are not fetched.",
+  "execution": "Isolated hosted rendering has no I/O. Clock and entropy require declared fixed runtime values; locale is en-US and timezone UTC.",
+  "publication": "Hosted builds consume Bun text lockfile v2 or npm lockfile v3. Exact immutable publication is the default send pin; contract-latest is explicit and resolves at acceptance.",
+  "qualityBar": [
+    "Validate all declared fixtures and inspect structured diagnostics and source origins.",
+    "Repair fatal compile/render failures before delivery.",
+    "Check representative empty, nested, repeated and conditional inputs.",
+    "Inspect HTML and text, light/dark styling and responsive layouts.",
+    "Distinguish static compatibility findings and browser previews from actual inbox evidence.",
+    "Keep source canonical; source edits and fixture data edits are separate operations."
   ],
-  "recipes": [
-    {
-      "name": "security-notice",
-      "structure": ["Preview", "Container", "Heading", "Text paragraphs", "Button", "Footer Text"],
-      "guidance": "Dense, direct copy; strong contrast; explicit dark background/text classes."
-    },
-    {
-      "name": "product-update",
-      "structure": ["Preview", "Container", "Heading", "Section rows", "CTA Button", "Footer"],
-      "guidance": "Use cards/sections, short headings, and semantic brand tokens."
-    },
-    {
-      "name": "receipt-invoice",
-      "structure": [
-        "Preview",
-        "Container",
-        "Heading",
-        "Row/Column line items",
-        "Divider",
-        "total row"
-      ],
-      "guidance": "Prefer table-backed Row/Column blocks and right-aligned totals."
-    },
-    {
-      "name": "digest",
-      "structure": [
-        "Preview",
-        "Container",
-        "Heading",
-        "repeated Section/Text/Button rows",
-        "Footer"
-      ],
-      "guidance": "Keep repeated rows compact; use Divider between entries."
+  "structuredChannels": {
+    "sms": {
+      "Sms": {
+        "attributes": {
+          "category": {
+            "type": "string",
+            "values": ["transactional", "promotional", "service_implicit"]
+          }
+        },
+        "content": "verbatim"
+      },
+      "If": {
+        "attributes": {
+          "test": {
+            "type": "string",
+            "required": true
+          }
+        },
+        "content": "verbatim-if"
+      },
+      "Else": {
+        "attributes": {},
+        "content": "verbatim"
+      }
+    },
+    "whatsapp": {
+      "WhatsApp": {
+        "attributes": {
+          "name": {
+            "type": "string"
+          },
+          "language": {
+            "type": "string"
+          },
+          "category": {
+            "type": "string",
+            "required": true,
+            "values": ["marketing", "utility", "authentication", "service"]
+          }
+        },
+        "content": "whatsapp"
+      },
+      "Header": {
+        "attributes": {
+          "type": {
+            "type": "string",
+            "values": ["text", "image", "video", "document"]
+          }
+        },
+        "content": "verbatim"
+      },
+      "Body": {
+        "attributes": {},
+        "content": "verbatim"
+      },
+      "Footer": {
+        "attributes": {},
+        "content": "verbatim"
+      },
+      "Buttons": {
+        "attributes": {},
+        "content": "buttons"
+      },
+      "Button": {
+        "attributes": {
+          "type": {
+            "type": "string",
+            "required": true,
+            "values": ["quick-reply", "url", "phone", "copy-code"]
+          },
+          "url": {
+            "type": "string"
+          },
+          "phone": {
+            "type": "string"
+          }
+        },
+        "content": "verbatim"
+      },
+      "If": {
+        "attributes": {
+          "test": {
+            "type": "string",
+            "required": true
+          }
+        },
+        "content": "verbatim-if"
+      },
+      "Else": {
+        "attributes": {},
+        "content": "verbatim"
+      }
     }
-  ]
+  }
 }