@lupinum/nuxt-email 1.0.0-beta.3 → 1.0.0-beta.4

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## v1.0.0-beta.4
+
+[compare changes](https://github.com/lupinum-dev/nuxt-email/compare/v1.0.0-beta.3...v1.0.0-beta.4)
+
+### 🚀 Enhancements
+
+- **docs:** Ship versioned package guidance ([#55](https://github.com/lupinum-dev/nuxt-email/pull/55))
+
+### 🩹 Fixes
+
+- **deps:** Clear workspace advisories and update Vitest ([#54](https://github.com/lupinum-dev/nuxt-email/pull/54))
+
+### ❤️ Contributors
+
+- Matthias Amon
+
 ## v1.0.0-beta.3
 
 [compare changes](https://github.com/lupinum-dev/nuxt-email/compare/v1.0.0-beta.2...v1.0.0-beta.3)

package/README.md

@@ -25,7 +25,7 @@
 </p>
 
 > [!WARNING]
-> [`1.0.0-beta.2`](https://www.npmjs.com/package/@lupinum/nuxt-email/v/1.0.0-beta.2) is published on npm's `next` tag. The [three-client beta smoke test](https://github.com/lupinum-dev/nuxt-email/blob/main/docs/release/client-qa-checklist.md#100-beta1-smoke-test) passed against beta.1; the full eight-client checklist and an external transactional beta still block stable `1.0.0`. The unscoped `nuxt-email` package on npm is unrelated to this project.
+> [`1.0.0-beta.3`](https://www.npmjs.com/package/@lupinum/nuxt-email/v/1.0.0-beta.3) is published on npm's `next` tag. The [three-client beta smoke test](https://github.com/lupinum-dev/nuxt-email/blob/main/docs/release/client-qa-checklist.md#100-beta1-smoke-test) passed against beta.1; the full eight-client checklist and an external transactional beta still block stable `1.0.0`. The unscoped `nuxt-email` package on npm is unrelated to this project.
 
 ## Why use Nuxt Email?
 
@@ -61,6 +61,34 @@ export default defineNuxtConfig({
 })
 ```
 
+<!-- BEGIN:consumer-onboarding -->
+
+### Use a coding agent
+
+A coding agent is a development tool that can inspect and change your project.
+After installation, copy this prompt into your coding agent:
+
+```text
+Add Nuxt Email to this Nuxt application and render one transactional email from
+a Vue template. Read the project's existing instructions first. Resolve
+@lupinum/nuxt-email/agent-docs from this application's directory and read its
+starting pages. Use the installed version's examples and public types. Preserve
+existing routes, security boundaries, conventions, and AGENTS.md instructions.
+Add or update one short Nuxt Email pointer in AGENTS.md if the project allows
+it; do not duplicate the documentation. If the file is absent, create only that
+pointer. Report missing guidance. Verify the server render, HTML and plain-text
+output, and one invalid request. Keep delivery in application-owned code.
+```
+
+If the installed package has no `agent-docs` export, read its packaged README,
+types, and `CONFORMANCE.md`. Use documentation from the matching source tag when
+more detail is needed. Installing or updating the package does not edit project
+instructions. The pointer resolves the installed package, so upgrades and
+rollbacks select the matching documentation without copying it into your
+application.
+
+<!-- END:consumer-onboarding -->
+
 ## Quick start
 
 Create `app/emails/welcome.vue`:

package/dist/agent/AGENTS.md

@@ -0,0 +1,47 @@
+# @lupinum/nuxt-email
+
+Documentation for installed version 1.0.0-beta.4.
+
+Read the relevant local pages before changing this package’s integration.
+Project instructions govern architecture, style and permissions.
+
+## Start here
+
+- [Installation](./pages/docs/getting-started/installation.md) — /docs/getting-started/installation
+- [Module behavior](./pages/docs/reference/module.md) — /docs/reference/module
+
+## Find a page
+
+The index below maps public documentation routes to this installed snapshot.
+For links to this documentation site, use the matching local page in manifest.json
+instead of fetching a possibly different website version. Preserve URL fragments.
+External dependencies have their own versioned contracts. Report missing guidance.
+
+- [Overview](./pages/docs/components.md) — /docs/components
+- [Code](./pages/docs/components/code.md) — /docs/components/code
+- [Content](./pages/docs/components/content.md) — /docs/components/content
+- [Layout](./pages/docs/components/layout.md) — /docs/components/layout
+- [Markdown](./pages/docs/components/markdown.md) — /docs/components/markdown
+- [Structure](./pages/docs/components/structure.md) — /docs/components/structure
+- [Tailwind](./pages/docs/components/tailwind.md) — /docs/components/tailwind
+- [Introduction](./pages/docs/getting-started.md) — /docs/getting-started
+- [Choose the right tool](./pages/docs/getting-started/choose-a-tool.md) — /docs/getting-started/choose-a-tool
+- [Your first email](./pages/docs/getting-started/first-email.md) — /docs/getting-started/first-email
+- [Installation](./pages/docs/getting-started/installation.md) — /docs/getting-started/installation
+- [Render from Nitro](./pages/docs/getting-started/render-from-nitro.md) — /docs/getting-started/render-from-nitro
+- [Guides](./pages/docs/guides.md) — /docs/guides
+- [Client compatibility and proofs](./pages/docs/guides/client-compatibility.md) — /docs/guides/client-compatibility
+- [Plain text](./pages/docs/guides/plain-text.md) — /docs/guides/plain-text
+- [Preview workflow](./pages/docs/guides/preview-workflow.md) — /docs/guides/preview-workflow
+- [Sending email](./pages/docs/guides/sending-email.md) — /docs/guides/sending-email
+- [Render outside Nitro](./pages/docs/guides/standalone-rendering.md) — /docs/guides/standalone-rendering
+- [Subject lines](./pages/docs/guides/subject-lines.md) — /docs/guides/subject-lines
+- [Using Tailwind](./pages/docs/guides/tailwind.md) — /docs/guides/tailwind
+- [Testing your emails](./pages/docs/guides/testing-your-emails.md) — /docs/guides/testing-your-emails
+- [Reference](./pages/docs/reference.md) — /docs/reference
+- [Conformance and divergences](./pages/docs/reference/conformance.md) — /docs/reference/conformance
+- [defineEmail](./pages/docs/reference/define-email.md) — /docs/reference/define-email
+- [Error types](./pages/docs/reference/errors.md) — /docs/reference/errors
+- [Migration from React Email](./pages/docs/reference/migration.md) — /docs/reference/migration
+- [Module behavior](./pages/docs/reference/module.md) — /docs/reference/module
+- [renderEmail](./pages/docs/reference/render-email.md) — /docs/reference/render-email

package/dist/agent/manifest.json

@@ -0,0 +1,208 @@
+{
+  "schemaVersion": 1,
+  "name": "@lupinum/nuxt-email",
+  "version": "1.0.0-beta.4",
+  "entrySha256": "a5d837ccbd208ce1924ee015f852d3b46397076faff9fc0c9db3e407bad466e8",
+  "startRoutes": [
+    "/docs/getting-started/installation",
+    "/docs/reference/module"
+  ],
+  "pages": [
+    {
+      "title": "Overview",
+      "route": "/docs/components",
+      "url": "https://nuxt-email.lupinum.com/docs/components",
+      "file": "pages/docs/components.md",
+      "sha256": "0e77e7d3e2b416385f4acf4a82a501b01752e8144bf3f2280c957f44dfa29eed"
+    },
+    {
+      "title": "Code",
+      "route": "/docs/components/code",
+      "url": "https://nuxt-email.lupinum.com/docs/components/code",
+      "file": "pages/docs/components/code.md",
+      "sha256": "df92b0166b7587f481b7dffd77b2cf1082d8f22f6f83cbc8d98fcb78f2a01f78"
+    },
+    {
+      "title": "Content",
+      "route": "/docs/components/content",
+      "url": "https://nuxt-email.lupinum.com/docs/components/content",
+      "file": "pages/docs/components/content.md",
+      "sha256": "1248dbdeeac67e2cb1d06708ce85a14e683dde556d95c8e8d6340cd530d0b476"
+    },
+    {
+      "title": "Layout",
+      "route": "/docs/components/layout",
+      "url": "https://nuxt-email.lupinum.com/docs/components/layout",
+      "file": "pages/docs/components/layout.md",
+      "sha256": "9d5b477e1d8851a1e1b4eab317c9e1216f588690681d2114f5008f926adb6f6c"
+    },
+    {
+      "title": "Markdown",
+      "route": "/docs/components/markdown",
+      "url": "https://nuxt-email.lupinum.com/docs/components/markdown",
+      "file": "pages/docs/components/markdown.md",
+      "sha256": "51d86aa26c831464e1a974bc807acf1bfd1e3a536a775c44cd0c18f823cccff4"
+    },
+    {
+      "title": "Structure",
+      "route": "/docs/components/structure",
+      "url": "https://nuxt-email.lupinum.com/docs/components/structure",
+      "file": "pages/docs/components/structure.md",
+      "sha256": "805b8b130f06435f567c281990fb7c1e513ef4b7d4a4f5854097f37e7ad0122d"
+    },
+    {
+      "title": "Tailwind",
+      "route": "/docs/components/tailwind",
+      "url": "https://nuxt-email.lupinum.com/docs/components/tailwind",
+      "file": "pages/docs/components/tailwind.md",
+      "sha256": "fb9efa4a2f0c3760d175de5e36e119c25fe06421061bb6b537de0d91f34e44dc"
+    },
+    {
+      "title": "Introduction",
+      "route": "/docs/getting-started",
+      "url": "https://nuxt-email.lupinum.com/docs/getting-started",
+      "file": "pages/docs/getting-started.md",
+      "sha256": "26cdbef4fbd789b82e371d83ba0202b83a85c63910855f199429d5e616c4f220"
+    },
+    {
+      "title": "Choose the right tool",
+      "route": "/docs/getting-started/choose-a-tool",
+      "url": "https://nuxt-email.lupinum.com/docs/getting-started/choose-a-tool",
+      "file": "pages/docs/getting-started/choose-a-tool.md",
+      "sha256": "642860367a82e6e451da048a42c2ac3da07ff17baaf6e16115959e6008b70e62"
+    },
+    {
+      "title": "Your first email",
+      "route": "/docs/getting-started/first-email",
+      "url": "https://nuxt-email.lupinum.com/docs/getting-started/first-email",
+      "file": "pages/docs/getting-started/first-email.md",
+      "sha256": "ea6715f9a39dc41af50a368b2febdd11aa911caae5c6c7d37ca9b27cc279cec9"
+    },
+    {
+      "title": "Installation",
+      "route": "/docs/getting-started/installation",
+      "url": "https://nuxt-email.lupinum.com/docs/getting-started/installation",
+      "file": "pages/docs/getting-started/installation.md",
+      "sha256": "659d61afd40046b2d3df97943eb043edb2b81e6d5bb57b67080ab846fbbbc30c"
+    },
+    {
+      "title": "Render from Nitro",
+      "route": "/docs/getting-started/render-from-nitro",
+      "url": "https://nuxt-email.lupinum.com/docs/getting-started/render-from-nitro",
+      "file": "pages/docs/getting-started/render-from-nitro.md",
+      "sha256": "50346191584cdd30e2bbbf763d8ea472b128d4755264aed9774a16ac58b3195c"
+    },
+    {
+      "title": "Guides",
+      "route": "/docs/guides",
+      "url": "https://nuxt-email.lupinum.com/docs/guides",
+      "file": "pages/docs/guides.md",
+      "sha256": "d153a226878be000ede7a577580fab0d7edeeed038e4c05462bf1e2a6b7fdc84"
+    },
+    {
+      "title": "Client compatibility and proofs",
+      "route": "/docs/guides/client-compatibility",
+      "url": "https://nuxt-email.lupinum.com/docs/guides/client-compatibility",
+      "file": "pages/docs/guides/client-compatibility.md",
+      "sha256": "660232cceb2c2c7e0caa8ca214961815ef8145e3100af799a2d7fac2bf79d8f3"
+    },
+    {
+      "title": "Plain text",
+      "route": "/docs/guides/plain-text",
+      "url": "https://nuxt-email.lupinum.com/docs/guides/plain-text",
+      "file": "pages/docs/guides/plain-text.md",
+      "sha256": "23a4b6fa7279afa761b2594733ab232da1f61740dd34b9a29bd3ce45b4d08d21"
+    },
+    {
+      "title": "Preview workflow",
+      "route": "/docs/guides/preview-workflow",
+      "url": "https://nuxt-email.lupinum.com/docs/guides/preview-workflow",
+      "file": "pages/docs/guides/preview-workflow.md",
+      "sha256": "5be43853fb705a873f2f4aeb63621c71699a4e5f5104c191282a3bea6c0d3c6f"
+    },
+    {
+      "title": "Sending email",
+      "route": "/docs/guides/sending-email",
+      "url": "https://nuxt-email.lupinum.com/docs/guides/sending-email",
+      "file": "pages/docs/guides/sending-email.md",
+      "sha256": "3fb9ecc61b952c67cbc1d819bdc71ac462d0df486d6924d5c40a7bcdae5da5f8"
+    },
+    {
+      "title": "Render outside Nitro",
+      "route": "/docs/guides/standalone-rendering",
+      "url": "https://nuxt-email.lupinum.com/docs/guides/standalone-rendering",
+      "file": "pages/docs/guides/standalone-rendering.md",
+      "sha256": "d57a1c25f718855835eeb0fe1f777b4357bc43152becb620023994fdb1a97dbf"
+    },
+    {
+      "title": "Subject lines",
+      "route": "/docs/guides/subject-lines",
+      "url": "https://nuxt-email.lupinum.com/docs/guides/subject-lines",
+      "file": "pages/docs/guides/subject-lines.md",
+      "sha256": "a6ba3d802ef5ca15da53e9984e7f780471725656f31c00cc16483d89b6a19fad"
+    },
+    {
+      "title": "Using Tailwind",
+      "route": "/docs/guides/tailwind",
+      "url": "https://nuxt-email.lupinum.com/docs/guides/tailwind",
+      "file": "pages/docs/guides/tailwind.md",
+      "sha256": "9e3917ee826e27131816c847e4ff5b8b1bbd573c2c3ea0b01b803bb96cdab77e"
+    },
+    {
+      "title": "Testing your emails",
+      "route": "/docs/guides/testing-your-emails",
+      "url": "https://nuxt-email.lupinum.com/docs/guides/testing-your-emails",
+      "file": "pages/docs/guides/testing-your-emails.md",
+      "sha256": "afab583c1e55b7f0c87a7c130e022d3709a67ff7ee956000d1f7b8c5ae3fca30"
+    },
+    {
+      "title": "Reference",
+      "route": "/docs/reference",
+      "url": "https://nuxt-email.lupinum.com/docs/reference",
+      "file": "pages/docs/reference.md",
+      "sha256": "9171124fcd3b19d7998bc2e6ccd682a94f8235572991f91658de4f86f90fc94a"
+    },
+    {
+      "title": "Conformance and divergences",
+      "route": "/docs/reference/conformance",
+      "url": "https://nuxt-email.lupinum.com/docs/reference/conformance",
+      "file": "pages/docs/reference/conformance.md",
+      "sha256": "154107d980ef6485aed64356f9478975987cc652b47edd2ec5727951f909f046"
+    },
+    {
+      "title": "defineEmail",
+      "route": "/docs/reference/define-email",
+      "url": "https://nuxt-email.lupinum.com/docs/reference/define-email",
+      "file": "pages/docs/reference/define-email.md",
+      "sha256": "d0c3b62959477064dbb8e3d38982aa7c3536de5ab8a7f3b9ced2d6e89e621d93"
+    },
+    {
+      "title": "Error types",
+      "route": "/docs/reference/errors",
+      "url": "https://nuxt-email.lupinum.com/docs/reference/errors",
+      "file": "pages/docs/reference/errors.md",
+      "sha256": "73d1445030087a96f799d26822c16feb1495e5e18dc155e36b41f4fa0ea2ab17"
+    },
+    {
+      "title": "Migration from React Email",
+      "route": "/docs/reference/migration",
+      "url": "https://nuxt-email.lupinum.com/docs/reference/migration",
+      "file": "pages/docs/reference/migration.md",
+      "sha256": "3c9b28e055a98e67861f26db023feb24e46fb64f187385b9e22f162e72b69f63"
+    },
+    {
+      "title": "Module behavior",
+      "route": "/docs/reference/module",
+      "url": "https://nuxt-email.lupinum.com/docs/reference/module",
+      "file": "pages/docs/reference/module.md",
+      "sha256": "dc3f2279f7704a06495d9cbbddcb9a25b33af5f25d142313d8563b1fd0743ab5"
+    },
+    {
+      "title": "renderEmail",
+      "route": "/docs/reference/render-email",
+      "url": "https://nuxt-email.lupinum.com/docs/reference/render-email",
+      "file": "pages/docs/reference/render-email.md",
+      "sha256": "fab12cbe778918019a49ad1508935ba5b53992420c85ed2a567b259adf6c6219"
+    }
+  ]
+}

package/dist/agent/pages/docs/components/code.md

@@ -0,0 +1,68 @@
+---
+title: "Code"
+description: "Compatibility-safe inline code and opt-in syntax-highlighted blocks."
+url: "https://nuxt-email.lupinum.com/docs/components/code"
+route: "/docs/components/code"
+locale: "en"
+section: "Documentation"
+collection: "docs"
+source: "ginko-content"
+---
+
+# Code
+
+> Compatibility-safe inline code and opt-in syntax-highlighted blocks.
+
+## ECodeInline
+
+`ECodeInline` renders inline code inside a text flow. Place it inside `EText` (or another text element). It accepts safe HTML attributes and forwards them, plus `style`, to both emitted elements.
+
+| Prop | Type | Default | Required |
+| --- | --- | --- | --- |
+| — | No component-specific props; accepts [shared safe native attributes](/raw/docs/components.md#rules-every-component-shares). | — | — |
+
+It renders three siblings: a `<style>` with the `Orange.fr` webmail compatibility rule, a visible `<code>` element, and a hidden copy `<span>` (`display:none`). The hidden compatibility copy is excluded from plain-text conversion, so recipients receive the code once.
+
+```vue
+<EText>
+  Run <ECodeInline class="inline-code">pnpm install</ECodeInline> to begin.
+</EText>
+```
+
+## ECodeBlock
+
+`ECodeBlock` is available only when `codeBlock` is configured on the Nuxt module. It uses the Shiki syntax highlighter and renders escaped tokens with inline theme colors. The language list is a closed build-time allowlist. Only configured languages and the grammars they import are bundled. A different runtime `language` value throws and lists the enabled languages.
+
+| Prop | Type | Default | Required |
+| --- | --- | --- | --- |
+| `code` | `string` | — | Yes |
+| `language` | Configured language union | — | Yes |
+| `lineNumbers` | `boolean` | `false` | No |
+| `fontFamily` | `string` | `ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace` | No |
+
+Code is escaped before rendering. The language is typed from the configured allowlist and checked again at runtime. Line numbers are decorative and excluded from plain text.
+
+```ts [nuxt.config.ts]
+export default defineNuxtConfig({
+  modules: ['@lupinum/nuxt-email'],
+  nuxtEmail: {
+    codeBlock: {
+      languages: ['typescript', 'bash'],
+      theme: 'github-dark',
+    },
+  },
+})
+```
+
+```vue
+<ECodeBlock
+  :code="source"
+  language="typescript"
+  line-numbers
+  style="border-radius:8px;padding:16px"
+/>
+```
+
+The configured theme produces concrete inline colors; there is no stylesheet or browser runtime. Author styles are also inline for email-client compatibility. Theme selection is build-time because email clients do not reliably support the CSS-variable approach used for responsive light/dark Shiki themes.
+
+Without `codeBlock`, the component is unregistered and Shiki performs no module-setup or production-bundle work. Use the generated `#nuxt-email/testing` binding when testing templates that contain `ECodeBlock`.

package/dist/agent/pages/docs/components/content.md

@@ -0,0 +1,111 @@
+---
+title: "Content"
+description: "EText, EHeading, ELink, EImg, EHr, and EButton for visible email content."
+url: "https://nuxt-email.lupinum.com/docs/components/content"
+route: "/docs/components/content"
+locale: "en"
+section: "Documentation"
+collection: "docs"
+source: "ginko-content"
+---
+
+# Content
+
+> EText, EHeading, ELink, EImg, EHr, and EButton for visible email content.
+
+These components carry the visible content of an email. Layout-sensitive components provide email-safe defaults. `ELink` is visually neutral.
+
+## EText
+
+`EText` renders a `<p>` with `font-size: 14px`, `line-height: 24px`, and `16px` top and bottom margins. Author styles override these defaults.
+
+| Prop | Type | Default | Required |
+| --- | --- | --- | --- |
+| — | No component-specific props; accepts [shared safe native attributes](/raw/docs/components.md#rules-every-component-shares). | — | — |
+
+```vue
+<EText :style="{ color: '#334155' }">Your workspace is ready.</EText>
+```
+
+## EHeading
+
+`EHeading` renders a heading element. An unsupported tag fails during rendering.
+
+| Prop | Type | Default | Required |
+| --- | --- | --- | --- |
+| `as` | `'h1' \| 'h2' \| 'h3' \| 'h4' \| 'h5' \| 'h6'` | `h1` | No |
+
+It also accepts [shared safe native attributes](/raw/docs/components.md#rules-every-component-shares).
+
+```vue
+<EHeading as="h2">Account ready</EHeading>
+```
+
+## ELink
+
+`ELink` renders a visually neutral anchor. It adds no color or text decoration.
+
+| Prop | Type | Default | Required |
+| --- | --- | --- | --- |
+| `href` | `string` | — | Yes |
+| `target` | Safe native anchor target | `_blank` | No |
+
+`href` must be non-empty. The value is escaped, but its URL scheme is not validated. Set visual styles explicitly and validate application-controlled URLs.
+
+```vue
+<ELink href="https://example.com/account" style="color:#2563eb">Open account</ELink>
+```
+
+## EImg
+
+`EImg` renders an image with block display and no border, outline, or text decoration.
+
+| Prop | Type | Default | Required |
+| --- | --- | --- | --- |
+| `src` | `string` | — | Yes |
+| `alt` | `string` | — | Yes |
+
+`src` must be non-empty. Use `alt=""` for a decorative image. The URL is serialized but never fetched. Safe image attributes such as `width` and `height` are accepted.
+
+```vue
+<EImg src="https://example.com/logo.png" alt="Example" width="120" height="32" />
+```
+
+## EHr
+
+`EHr` renders a full-width horizontal rule with a transparent border and a `1px solid #eaeaea` top border. Author styles override individual defaults.
+
+| Prop | Type | Default | Required |
+| --- | --- | --- | --- |
+| — | No component-specific props; accepts [shared safe native attributes](/raw/docs/components.md#rules-every-component-shares). | — | — |
+
+```vue
+<EHr :style="{ borderTopColor: '#cbd5e1' }" />
+```
+
+## EButton
+
+`EButton` renders an anchor with conditional Outlook spacer markup. The spacer keeps its padding usable in Outlook for Windows.
+
+| Prop | Type | Default | Required |
+| --- | --- | --- | --- |
+| `href` | `string` | — | Yes |
+| `target` | Safe native anchor target | `_blank` | No |
+| `style` | Vue style value | Email-safe anchor defaults | No |
+
+The default style uses `line-height: 100%`, no text decoration, inline-block display, and `max-width: 100%`. It also sets the Outlook-specific `mso-padding-alt` property to `0px`. Author styles override these values.
+
+Padding accepts finite non-negative numbers or `px`, `em`, `rem`, and `%` values. Shorthand accepts one to four values. Invalid units, negative or non-finite values, and output large enough to inflate the message fail during rendering.
+
+```vue
+<EButton
+  href="https://example.com/activate"
+  :style="{ backgroundColor: '#0f5132', color: '#fff', padding: '12px 20px' }"
+>
+  Activate account
+</EButton>
+```
+
+<card title="Client notes" icon="lucide:mail">
+Remote images are often blocked, so always provide useful alternative text. Outlook for Windows ignores CSS padding on inline anchors; `EButton` supplies conditional spacer markup for that client. Verify both behaviors during [manual QA](/raw/docs/guides/client-compatibility.md).
+</card>

package/dist/agent/pages/docs/components/layout.md

@@ -0,0 +1,89 @@
+---
+title: "Layout"
+description: "EContainer, ESection, ERow, and EColumn — presentation-table primitives for stable email layouts."
+url: "https://nuxt-email.lupinum.com/docs/components/layout"
+route: "/docs/components/layout"
+locale: "en"
+section: "Documentation"
+collection: "docs"
+source: "ginko-content"
+---
+
+# Layout
+
+> EContainer, ESection, ERow, and EColumn — presentation-table primitives for stable email layouts.
+
+These components use presentation tables for email-client compatibility.
+
+## EContainer
+
+`EContainer` renders a centered presentation table for bounded content. It defaults to `align="center"`, `width="100%"`, and a maximum width of `37.5em`. Its fixed attributes are `border="0"`, `cellpadding="0"`, `cellspacing="0"`, and `role="presentation"`.
+
+| Prop | Type | Default | Required |
+| --- | --- | --- | --- |
+| — | No component-specific props; accepts safe table attributes except the fixed attributes above. | — | — |
+
+```vue
+<EContainer :style="{ maxWidth: '600px' }">Content</EContainer>
+```
+
+## ESection
+
+`ESection` renders a full-width presentation table with one inner cell.
+
+| Prop | Type | Default | Required |
+| --- | --- | --- | --- |
+| — | No component-specific props; accepts safe table attributes except `border`, `cellpadding`, `cellspacing`, and `role`. | — | — |
+
+```vue
+<ESection :style="{ padding: '16px' }">Content</ESection>
+```
+
+## ERow
+
+`ERow` renders a full-width presentation table whose row receives its default slot. Put `EColumn` components directly in the slot.
+
+| Prop | Type | Default | Required |
+| --- | --- | --- | --- |
+| — | No component-specific props; accepts safe table attributes except `border`, `cellpadding`, `cellspacing`, and `role`. | — | — |
+
+```vue
+<ERow><EColumn>Content</EColumn></ERow>
+```
+
+## EColumn
+
+`EColumn` renders a `<td>` cell. It has no default width and adds no synthetic React marker.
+
+| Prop | Type | Default | Required |
+| --- | --- | --- | --- |
+| — | No component-specific props; accepts safe cell attributes such as `width`, `colspan`, alignment, and `style`. | — | — |
+
+```vue
+<EColumn width="50%">Left</EColumn>
+```
+
+## Padding placement
+
+`EContainer`, `ESection`, and `ERow` move physical padding known at render time to a `<td>`. This includes author styles and non-variant Tailwind utilities. Responsive and pseudo-class utilities remain CSS rules because they have no single inline value. Put responsive padding on an inner `EColumn` and verify the target clients.
+
+`ERow` adds its padding wrapper only when physical padding exists. Logical padding properties remain on the table.
+
+## Fixed presentation attributes
+
+`EContainer`, `ESection`, and `ERow` reject overrides for `border`, `cellpadding`, `cellspacing`, and `role`, including alternate casing. Use `style` when you need a visual border. This deliberate [divergence](/raw/docs/reference/conformance.md) prevents silently broken layout semantics.
+
+```vue
+<EContainer :style="{ maxWidth: '600px', padding: '24px' }">
+  <ESection :style="{ padding: '16px 20px' }">
+    <ERow>
+      <EColumn width="50%">Left</EColumn>
+      <EColumn width="50%">Right</EColumn>
+    </ERow>
+  </ESection>
+</EContainer>
+```
+
+<card title="Client note: Outlook columns" icon="lucide:columns-3">
+Columns remain table cells in Outlook for Windows. Give them explicit widths and verify narrow layouts in your [client QA](/raw/docs/guides/client-compatibility.md).
+</card>

package/dist/agent/pages/docs/components/markdown.md

@@ -0,0 +1,49 @@
+---
+title: "Markdown"
+description: "EMarkdown renders Markdown to email-safe HTML with inline styles and per-element overrides."
+url: "https://nuxt-email.lupinum.com/docs/components/markdown"
+route: "/docs/components/markdown"
+locale: "en"
+section: "Documentation"
+collection: "docs"
+source: "ginko-content"
+---
+
+# Markdown
+
+> EMarkdown renders Markdown to email-safe HTML with inline styles and per-element overrides.
+
+## EMarkdown
+
+`EMarkdown` renders Markdown to email-safe HTML with inline styles. It is useful when content comes from a content management system (CMS) rather than Vue markup.
+
+| Prop | Type | Default | Required |
+| --- | --- | --- | --- |
+| `source` | `string` | Text-only default slot | No |
+| `markdownCustomStyles` | Per-element style map | Built-in email-safe styles | No |
+
+When `source` is a string, it takes precedence over the default slot. Custom styles merge over the defaults.
+
+Raw HTML is rejected, including HTML comments. Links and images accept relative URLs plus `http`, `https`, `mailto`, `tel`, and `cid`; other schemes are rejected after HTML-entity and control-character normalization. HTML-looking text inside code spans and fences is escaped. This keeps Markdown from becoming an implicit raw-HTML escape hatch.
+
+The rendered container accepts Vue's normal `class`, `style`, and safe HTML attributes. Use ordinary string, object, or array `style` values; include CSS units explicitly for dimensional values such as padding.
+
+The default slot must contain **text only**; an element child throws a `TypeError` rather than being silently stringified. Links render with `target="_blank"`, and tables render with `role="presentation"`.
+
+```vue
+<EMarkdown source="# Title\n\nA paragraph with a [link](https://example.com)." />
+```
+
+With overrides:
+
+```vue
+<EMarkdown
+  :source="body"
+  :markdown-custom-styles="{ h1: { color: '#0f172a' }, a: { color: '#2563eb' } }"
+  :style="{ padding: '0 24px' }"
+/>
+```
+
+<card title="Divergence: no data-id marker" icon="lucide:git-compare">
+Unlike React Email, the container omits the `data-id="react-email-markdown"` marker (the same no-data-id divergence as `EColumn`). No Vue behavior consumes the marker. See the [conformance report](/raw/docs/reference/conformance.md).
+</card>