@samva/markup 0.8.0 → 0.10.0

package/generated/sml-email-agent-contract.json

@@ -1,615 +0,0 @@
-{
-  "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": {
-        "xmlns": {
-          "type": "string"
-        },
-        "xmlns:o": {
-          "type": "string"
-        },
-        "xmlns:v": {
-          "type": "string"
-        },
-        "xmlns:w": {
-          "type": "string"
-        }
-      },
-      "childElements": ["head", "body"]
-    },
-    "head": {
-      "content": "flow",
-      "layout": "metadata",
-      "attributes": {},
-      "childElements": ["title", "meta", "style"]
-    },
-    "title": {
-      "content": "text",
-      "layout": "metadata",
-      "attributes": {}
-    },
-    "style": {
-      "content": "raw",
-      "layout": "metadata",
-      "attributes": {
-        "type": {
-          "type": "string"
-        }
-      }
-    },
-    "meta": {
-      "content": "void",
-      "layout": "metadata",
-      "attributes": {
-        "name": {
-          "type": "string"
-        },
-        "content": {
-          "type": "string"
-        },
-        "charset": {
-          "type": "string"
-        },
-        "http-equiv": {
-          "type": "string"
-        }
-      }
-    },
-    "body": {
-      "content": "flow",
-      "layout": "block",
-      "attributes": {
-        "bgcolor": {
-          "type": "string"
-        }
-      }
-    },
-    "div": {
-      "content": "flow",
-      "layout": "block",
-      "attributes": {
-        "align": {
-          "type": "string",
-          "values": ["left", "center", "right"]
-        }
-      }
-    },
-    "section": {
-      "content": "flow",
-      "layout": "block",
-      "attributes": {
-        "align": {
-          "type": "string",
-          "values": ["left", "center", "right"]
-        }
-      }
-    },
-    "article": {
-      "content": "flow",
-      "layout": "block",
-      "attributes": {
-        "align": {
-          "type": "string",
-          "values": ["left", "center", "right"]
-        }
-      }
-    },
-    "header": {
-      "content": "flow",
-      "layout": "block",
-      "attributes": {
-        "align": {
-          "type": "string",
-          "values": ["left", "center", "right"]
-        }
-      }
-    },
-    "footer": {
-      "content": "flow",
-      "layout": "block",
-      "attributes": {
-        "align": {
-          "type": "string",
-          "values": ["left", "center", "right"]
-        }
-      }
-    },
-    "main": {
-      "content": "flow",
-      "layout": "block",
-      "attributes": {
-        "align": {
-          "type": "string",
-          "values": ["left", "center", "right"]
-        }
-      }
-    },
-    "center": {
-      "content": "flow",
-      "layout": "block",
-      "attributes": {}
-    },
-    "p": {
-      "content": "flow",
-      "layout": "block",
-      "attributes": {
-        "align": {
-          "type": "string",
-          "values": ["left", "center", "right"]
-        }
-      }
-    },
-    "blockquote": {
-      "content": "flow",
-      "layout": "block",
-      "attributes": {
-        "align": {
-          "type": "string",
-          "values": ["left", "center", "right"]
-        }
-      }
-    },
-    "pre": {
-      "content": "flow",
-      "layout": "preformatted",
-      "attributes": {}
-    },
-    "h1": {
-      "content": "flow",
-      "layout": "block",
-      "attributes": {
-        "align": {
-          "type": "string",
-          "values": ["left", "center", "right"]
-        }
-      }
-    },
-    "h2": {
-      "content": "flow",
-      "layout": "block",
-      "attributes": {
-        "align": {
-          "type": "string",
-          "values": ["left", "center", "right"]
-        }
-      }
-    },
-    "h3": {
-      "content": "flow",
-      "layout": "block",
-      "attributes": {
-        "align": {
-          "type": "string",
-          "values": ["left", "center", "right"]
-        }
-      }
-    },
-    "h4": {
-      "content": "flow",
-      "layout": "block",
-      "attributes": {
-        "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
-        },
-        "target": {
-          "type": "string"
-        },
-        "rel": {
-          "type": "string"
-        },
-        "name": {
-          "type": "string"
-        }
-      }
-    },
-    "img": {
-      "content": "void",
-      "layout": "image",
-      "attributes": {
-        "src": {
-          "type": "url",
-          "required": true
-        },
-        "alt": {
-          "type": "string",
-          "required": true
-        },
-        "width": {
-          "type": "measure"
-        },
-        "height": {
-          "type": "measure"
-        },
-        "border": {
-          "type": "measure"
-        },
-        "align": {
-          "type": "string",
-          "values": ["left", "center", "right"]
-        }
-      }
-    },
-    "table": {
-      "content": "flow",
-      "layout": "table",
-      "attributes": {
-        "width": {
-          "type": "measure"
-        },
-        "height": {
-          "type": "measure"
-        },
-        "border": {
-          "type": "measure"
-        },
-        "cellpadding": {
-          "type": "measure"
-        },
-        "cellspacing": {
-          "type": "measure"
-        },
-        "align": {
-          "type": "string",
-          "values": ["left", "center", "right"]
-        },
-        "bgcolor": {
-          "type": "string"
-        }
-      },
-      "childElements": ["caption", "colgroup", "thead", "tbody", "tfoot", "tr"]
-    },
-    "caption": {
-      "content": "flow",
-      "layout": "block",
-      "attributes": {
-        "align": {
-          "type": "string",
-          "values": ["left", "center", "right"]
-        }
-      }
-    },
-    "colgroup": {
-      "content": "flow",
-      "layout": "table-section",
-      "attributes": {
-        "span": {
-          "type": "number"
-        },
-        "width": {
-          "type": "measure"
-        }
-      },
-      "childElements": ["col"]
-    },
-    "col": {
-      "content": "void",
-      "layout": "table-section",
-      "attributes": {
-        "span": {
-          "type": "number"
-        },
-        "width": {
-          "type": "measure"
-        }
-      }
-    },
-    "thead": {
-      "content": "flow",
-      "layout": "table-section",
-      "attributes": {
-        "align": {
-          "type": "string",
-          "values": ["left", "center", "right"]
-        },
-        "valign": {
-          "type": "string",
-          "values": ["top", "middle", "bottom"]
-        },
-        "bgcolor": {
-          "type": "string"
-        }
-      },
-      "childElements": ["tr"]
-    },
-    "tbody": {
-      "content": "flow",
-      "layout": "table-section",
-      "attributes": {
-        "align": {
-          "type": "string",
-          "values": ["left", "center", "right"]
-        },
-        "valign": {
-          "type": "string",
-          "values": ["top", "middle", "bottom"]
-        },
-        "bgcolor": {
-          "type": "string"
-        }
-      },
-      "childElements": ["tr"]
-    },
-    "tfoot": {
-      "content": "flow",
-      "layout": "table-section",
-      "attributes": {
-        "align": {
-          "type": "string",
-          "values": ["left", "center", "right"]
-        },
-        "valign": {
-          "type": "string",
-          "values": ["top", "middle", "bottom"]
-        },
-        "bgcolor": {
-          "type": "string"
-        }
-      },
-      "childElements": ["tr"]
-    },
-    "tr": {
-      "content": "flow",
-      "layout": "row",
-      "attributes": {
-        "align": {
-          "type": "string",
-          "values": ["left", "center", "right"]
-        },
-        "valign": {
-          "type": "string",
-          "values": ["top", "middle", "bottom"]
-        },
-        "bgcolor": {
-          "type": "string"
-        },
-        "height": {
-          "type": "measure"
-        }
-      },
-      "childElements": ["td", "th"]
-    },
-    "td": {
-      "content": "flow",
-      "layout": "cell",
-      "attributes": {
-        "align": {
-          "type": "string",
-          "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"
-        }
-      }
-    },
-    "th": {
-      "content": "flow",
-      "layout": "cell",
-      "attributes": {
-        "align": {
-          "type": "string",
-          "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"
-        }
-      }
-    },
-    "ul": {
-      "content": "flow",
-      "layout": "list",
-      "attributes": {},
-      "childElements": ["li"]
-    },
-    "ol": {
-      "content": "flow",
-      "layout": "list",
-      "attributes": {
-        "start": {
-          "type": "number"
-        },
-        "type": {
-          "type": "string"
-        }
-      },
-      "childElements": ["li"]
-    },
-    "li": {
-      "content": "flow",
-      "layout": "list-item",
-      "attributes": {}
-    },
-    "br": {
-      "content": "void",
-      "layout": "break",
-      "attributes": {}
-    },
-    "hr": {
-      "content": "void",
-      "layout": "rule",
-      "attributes": {
-        "width": {
-          "type": "measure"
-        },
-        "size": {
-          "type": "number"
-        },
-        "align": {
-          "type": "string",
-          "values": ["left", "center", "right"]
-        }
-      }
-    }
-  },
-  "globalAttributes": {
-    "id": {
-      "type": "string"
-    },
-    "title": {
-      "type": "string"
-    },
-    "lang": {
-      "type": "string"
-    },
-    "dir": {
-      "type": "string",
-      "values": ["ltr", "rtl", "auto"]
-    },
-    "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."
-  ]
-}

package/generated/sml-email-language-reference.md

@@ -1,94 +0,0 @@
-# Executable email authoring reference
-
-Email entries default-export `defineEmail({ id, schema, fixtures, render })` from
-`@samva/markup/template`. Set `jsxImportSource: "@samva/markup/email"`.
-The schema accepts a Standard JSON Schema v1 converter, such as Effect's
-`Schema.toStandardJSONSchemaV1` or Zod 4. Render receives actual validated JSON.
-Return subject, optional preheader, body and optional text; omitted text is derived.
-
-Use ordinary synchronous TypeScript helpers, conditions and mapped arrays. Template identity is
-stable and unique within the project. Helper modules are excluded from the template catalog.
-Declare fixtures for each meaningful input shape; fixtures do not prove every possible branch.
-
-## Email components
-
-Import from `@samva/markup/email/components`: `Button`, `Column`, `Columns`, `Divider`, `Email`, `Image`, `Link`, `Section`, `Spacer`.
-Use supported ordinary HTML for content. Email primitives generate layout tables and Outlook
-fallbacks while preserving authoring origins. Scripts, event handlers and unsafe URLs fail.
-Strings are escaped content, never interpreted as markup.
-
-## HTML elements
-
-- `html`: flow content; attributes: `xmlns`, `xmlns:o`, `xmlns:v`, `xmlns:w`.
-- `head`: flow content; attributes: global attributes only.
-- `title`: text content; attributes: global attributes only.
-- `style`: raw content; attributes: `type`.
-- `meta`: void content; attributes: `name`, `content`, `charset`, `http-equiv`.
-- `body`: flow content; attributes: `bgcolor`.
-- `div`: flow content; attributes: `align`.
-- `section`: flow content; attributes: `align`.
-- `article`: flow content; attributes: `align`.
-- `header`: flow content; attributes: `align`.
-- `footer`: flow content; attributes: `align`.
-- `main`: flow content; attributes: `align`.
-- `center`: flow content; attributes: global attributes only.
-- `p`: flow content; attributes: `align`.
-- `blockquote`: flow content; attributes: `align`.
-- `pre`: flow content; attributes: global attributes only.
-- `h1`: flow content; attributes: `align`.
-- `h2`: flow content; attributes: `align`.
-- `h3`: flow content; attributes: `align`.
-- `h4`: flow content; attributes: `align`.
-- `h5`: flow content; attributes: `align`.
-- `h6`: flow content; attributes: `align`.
-- `span`: flow content; attributes: global attributes only.
-- `strong`: flow content; attributes: global attributes only.
-- `b`: flow content; attributes: global attributes only.
-- `em`: flow content; attributes: global attributes only.
-- `i`: flow content; attributes: global attributes only.
-- `u`: flow content; attributes: global attributes only.
-- `s`: flow content; attributes: global attributes only.
-- `small`: flow content; attributes: global attributes only.
-- `code`: flow content; attributes: global attributes only.
-- `a`: flow content; attributes: `href`, `target`, `rel`, `name`.
-- `img`: void content; attributes: `src`, `alt`, `width`, `height`, `border`, `align`.
-- `table`: flow content; attributes: `width`, `height`, `border`, `cellpadding`, `cellspacing`, `align`, `bgcolor`.
-- `caption`: flow content; attributes: `align`.
-- `colgroup`: flow content; attributes: `span`, `width`.
-- `col`: void content; attributes: `span`, `width`.
-- `thead`: flow content; attributes: `align`, `valign`, `bgcolor`.
-- `tbody`: flow content; attributes: `align`, `valign`, `bgcolor`.
-- `tfoot`: flow content; attributes: `align`, `valign`, `bgcolor`.
-- `tr`: flow content; attributes: `align`, `valign`, `bgcolor`, `height`.
-- `td`: flow content; attributes: `align`, `valign`, `width`, `height`, `bgcolor`, `colspan`, `rowspan`.
-- `th`: flow content; attributes: `align`, `valign`, `width`, `height`, `bgcolor`, `colspan`, `rowspan`.
-- `ul`: flow content; attributes: global attributes only.
-- `ol`: flow content; attributes: `start`, `type`.
-- `li`: flow content; attributes: global attributes only.
-- `br`: void content; attributes: global attributes only.
-- `hr`: void content; attributes: `width`, `size`, `align`.
-
-Global attributes: `id`, `title`, `lang`, `dir`, `role`.
-
-## CSS and assets
-
-Imported CSS follows cascade and specificity; applicable declarations inline and supported media/head rules remain.
-Uses the Tailwind compiler and discoverable source classes; dynamic classes may produce diagnostics.
-Use email layout primitives for table and Outlook fallbacks; no general flex/grid conversion.
-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 and publication
-
-Isolated hosted rendering has no I/O. Clock and entropy require declared fixed runtime values; locale is en-US and timezone UTC.
-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.
-Local preview, build and export do not require Samva credentials. Build executes named fixtures;
-export writes template/fixture HTML and text plus assets and a catalog manifest.
-
-## Quality bar
-
-- 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.