@samva/markup 0.11.3 → 0.12.0

package/CHANGELOG.md

@@ -1,3 +1,11 @@
+## @samva/markup@0.11.4
+
+### Diagnostics carry their upgrade recipe
+
+A template diagnostic whose code marks an incompatible template format now includes `upgrade`, the
+agent instructions for migrating the template, in structured results and after `Fix:` in formatted
+output.
+
 ## @samva/markup@0.11.2
 
 ### Published files no longer point at missing source maps

package/dist/{assets-B0yseju_.d.ts → assets-DCULM6QD.d.ts}

@@ -1,6 +1,6 @@
 import { t as BrandPlugin } from "./brand-plugin-CHhcei-j.js";
-import { r as EmailDiagnostic } from "./diagnostics-B-Gym34R.js";
-import { r as EmailNode } from "./jsx-runtime-ylIOnaSf.js";
+import { r as EmailDiagnostic } from "./diagnostics-CUYlQ_6x.js";
+import { r as EmailNode } from "./jsx-runtime-DC7xG0aA.js";
 //#region src/email/brand.d.ts
 interface EmailBrandAddress {
   readonly street1: string;

package/dist/brand.d.ts

@@ -1,5 +1,5 @@
 import { t as BrandPlugin } from "./brand-plugin-CHhcei-j.js";
-import { _ as EmailBrandSocialLink, a as assetUrl, b as renderedFooterMarkers, c as isExternalAsset, d as BrandFooterProps, f as BrandLogoProps, g as EmailBrandFooter, h as EmailBrandAssets, i as assetEntry, l as BRAND_COMPONENT_CLASSES, m as EmailBrandAddress, n as AssetEntry, o as checkAssetBase, p as EmailBrand, r as AssetManifest, s as isAssetPath, t as ASSET_CONTENT_TYPES, u as BrandComponents, v as RenderedFooterMarkers, x as withoutUnsubscribeRow, y as brandComponents } from "./assets-B0yseju_.js";
+import { _ as EmailBrandSocialLink, a as assetUrl, b as renderedFooterMarkers, c as isExternalAsset, d as BrandFooterProps, f as BrandLogoProps, g as EmailBrandFooter, h as EmailBrandAssets, i as assetEntry, l as BRAND_COMPONENT_CLASSES, m as EmailBrandAddress, n as AssetEntry, o as checkAssetBase, p as EmailBrand, r as AssetManifest, s as isAssetPath, t as ASSET_CONTENT_TYPES, u as BrandComponents, v as RenderedFooterMarkers, x as withoutUnsubscribeRow, y as brandComponents } from "./assets-DCULM6QD.js";
 import { t as Diagnostic } from "./diagnostic-model-DxthUZBT.js";
 import { Result } from "better-result";
 //#region src/email/samva-brand-plugin.d.ts

package/dist/compiler.d.ts

@@ -1,9 +1,9 @@
 import { n as parseBrandSpecifier, t as BrandPlugin } from "./brand-plugin-CHhcei-j.js";
-import { a as TemplateDiagnostic, r as EmailDiagnostic } from "./diagnostics-B-Gym34R.js";
-import { r as EmailNode } from "./jsx-runtime-ylIOnaSf.js";
-import { n as AssetEntry, p as EmailBrand, u as BrandComponents } from "./assets-B0yseju_.js";
-import { C as Compound, D as EmittedPosition, S as CompiledSelector, T as matchesSelector, _ as Specificity, b as parseStylesheet, ct as TemplateIr, g as CssRule, h as CssDeclaration, r as RenderedEmail, v as Stylesheet, w as classListOf, x as Ancestry, y as compileSelector } from "./render-DQKz4Aco.js";
-import { a as TEMPLATE_NAME_PATTERN, n as EmailContent } from "./template-DMPwxMSq.js";
+import { a as TemplateDiagnostic, r as EmailDiagnostic } from "./diagnostics-CUYlQ_6x.js";
+import { r as EmailNode } from "./jsx-runtime-DC7xG0aA.js";
+import { n as AssetEntry, p as EmailBrand, u as BrandComponents } from "./assets-DCULM6QD.js";
+import { C as Compound, D as EmittedPosition, S as CompiledSelector, T as matchesSelector, _ as Specificity, b as parseStylesheet, ct as TemplateIr, g as CssRule, h as CssDeclaration, r as RenderedEmail, v as Stylesheet, w as classListOf, x as Ancestry, y as compileSelector } from "./render-C28ucTh8.js";
+import { a as TEMPLATE_NAME_PATTERN, n as EmailContent } from "./template-B-UDXK8a.js";
 import { caniemail } from "caniemail";
 //#region src/email/compatibility.d.ts
 type CaniemailClient = Parameters<typeof caniemail>[0]["clients"][number];

package/dist/compiler.js

@@ -3,11 +3,11 @@ import { n as TEMPLATE_NAME_PATTERN } from "./template-zLUjcwfF.js";
 import { D as samvaBrandPlugin, T as parseBrandSpecifier, _ as renderIr, w as brandSpecifierPattern } from "./html-DjPxwjLi.js";
 import { c as parseBrandCss, d as formatColor, f as parseColor, i as brandTailwindCss, u as downlevelColors } from "./theme-css-CEUrDpqq.js";
 import { a as downlevelMediaQuery, c as renderHeadCss, i as matchesSelector, l as resolveVariables, n as applyStylesheet, o as finalizeValue, r as classListOf, s as foldCalc, u as unquote } from "./ir-De6pTH51.js";
-import { i as lineColumn, t as buildLineMap } from "./diagnostic-model-DJtqbETd.js";
-import { a as lowerProject, d as resolveFromDirectory, f as resolveThemeImports, i as completed, l as Findings, n as introducedProfileErrors, r as loadProject, t as checkStaticProfile, u as projectDirectory } from "./profile-PUfi3GPH.js";
+import { i as buildLineMap, s as lineColumn } from "./diagnostic-codes-BduqCv_h.js";
+import { a as lowerProject, d as resolveFromDirectory, f as resolveThemeImports, i as completed, l as Findings, n as introducedProfileErrors, r as loadProject, t as checkStaticProfile, u as projectDirectory } from "./profile-CWZ2kkt-.js";
 import { c as checkAssetBase, i as withoutUnsubscribeRow, l as isAssetPath, n as brandComponents, o as assetEntry, s as assetUrl, t as BRAND_COMPONENT_CLASSES } from "./brand-DTctcDmf.js";
-import { t as EmailCompileError } from "./diagnostics-CnKFefKz.js";
-import { n as compileEmail, r as renderEmailContent } from "./render-D2ht57ZZ.js";
+import { t as EmailCompileError } from "./diagnostics-C0Tr8-eQ.js";
+import { n as compileEmail, r as renderEmailContent } from "./render-BVW-ESn-.js";
 import { caniemail, parseHtml, rawData } from "caniemail";
 import { generate, ident, parse, walk } from "css-tree";
 import { parse as parse$1 } from "@babel/parser";

package/dist/diagnostic-codes-BduqCv_h.js

@@ -0,0 +1,437 @@
+//#region src/diagnostic-model.ts
+/** Newline-offset line map. Build once per source, query with `lineColumn`. */
+const buildLineMap = (source) => {
+	const lineStarts = [0];
+	for (let index = 0; index < source.length; index++) {
+		const code = source.charCodeAt(index);
+		if (code === 10 || code === 13 && source.charCodeAt(index + 1) !== 10 || code === 8232 || code === 8233) lineStarts.push(index + 1);
+	}
+	return lineStarts;
+};
+/** 1-based line/column for an absolute offset, via binary search. */
+const lineColumn = (lineMap, offset) => {
+	let low = 0;
+	let high = lineMap.length - 1;
+	while (low < high) {
+		const middle = low + high + 1 >> 1;
+		if (lineMap[middle] <= offset) low = middle;
+		else high = middle - 1;
+	}
+	return {
+		line: low + 1,
+		column: offset - lineMap[low] + 1
+	};
+};
+/** Build one formatter for a batch of diagnostics against the same source. */
+const createDiagnosticFormatter = (source) => {
+	const lineMap = buildLineMap(source);
+	return (diagnostic) => {
+		const { line, column } = lineColumn(lineMap, diagnostic.span.start);
+		return `line ${line}:${column} ${diagnostic.message}`;
+	};
+};
+/** "line 12:8 unknown class ..." — the shape agents iterate on. */
+const formatDiagnostic = (source, diagnostic) => createDiagnosticFormatter(source)(diagnostic);
+//#endregion
+//#region src/diagnostic-codes.ts
+const codes = (table) => table;
+const DIAGNOSTIC_CODES = codes({
+	"no-template": {
+		summary: "The entry does not default-export a template.",
+		fix: "Default-export defineTemplate({ ... }) imported from @samva/markup."
+	},
+	"legacy-definition": {
+		summary: "The entry default-exports something other than defineTemplate.",
+		fix: "Import { defineTemplate } from \"@samva/markup\" and default-export defineTemplate({ ... }).",
+		upgrade: [
+			"Read the entry and its imports without executing them. For a default-exported defineEmail definition, import defineTemplate from \"@samva/markup\" and replace the definition call.",
+			"Preserve the entry path, template id, schema, named fixtures, content, design, bindings, conditions, project partials, assets, theme and brand imports. Replace render(input) returning { subject, preheader?, body } with email: { subject: (input) => ..., preheader: (input) => ..., body: (input) => ... }, retaining its parameter bindings and each returned expression; omit preheader when absent.",
+			"Inline module constants only when they are literal strings, numbers or booleans and their bindings are unambiguous; never substitute a fixture value for an input binding. Keep each channel function a single static-profile expression, and keep subject and preheader off <Email>.",
+			"Helper calls, `Math.*`, general arithmetic, render statements, spreads, computed properties and runtime clock or seed have no direct conversion. Rewrite with static-profile bindings, conditions, .map, .filter, project partials or `fmt.*` where equivalent; arithmetic is allowed only in formatter arguments and conditions. Otherwise compute the value in the sender, declare a payload field in the schema and every fixture, and explain the required sender change. Never guess time, randomness or computed data.",
+			"Explicit text has no email-channel field: plain text is derived from the body. If deriving it changes intended content, or another construct cannot be preserved, explain the tradeoff and ask rather than silently discard it. Do not drop fixtures, weaken validation or hide diagnostics.",
+			"Convert every affected entry in the project at its existing path, including emails/ entries. Compile each entry, render every declared fixture and inspect the affected output. Resolve errors before requesting one saved version for the whole project, approved by the user; do not publish."
+		].join("\n\n")
+	},
+	"dynamic-definition": {
+		summary: "A definition field is spread or computed instead of written out.",
+		fix: "Write each field as name: value."
+	},
+	"invalid-template-id": {
+		summary: "The template id is not a lowercase kebab-case string literal.",
+		fix: "Write id: \"order-shipped\"."
+	},
+	"missing-schema": {
+		summary: "The template declares no input schema.",
+		fix: "Add schema: jsonSchema<Input>({ ... })."
+	},
+	"schema-not-static": {
+		summary: "The schema cannot be read without running code.",
+		fix: "Write the schema as a literal jsonSchema<Input>({ type: 'object', ... })."
+	},
+	"invalid-schema": {
+		summary: "The schema uses JSON Schema keywords the compiler cannot validate against.",
+		fix: "Use only the JSON Schema keywords the package README lists."
+	},
+	"missing-fixtures": {
+		summary: "The template declares no fixtures.",
+		fix: "Add fixtures: { default: { ... } } with at least one valid payload."
+	},
+	"fixtures-not-static": {
+		summary: "A fixture is computed instead of written as data.",
+		fix: "Write each fixture as a literal object; an imported asset is allowed."
+	},
+	"invalid-fixture-name": {
+		summary: "A fixture key is not a single path segment.",
+		fix: "Use letters, digits, '.', '_' and '-', starting with a letter or digit."
+	},
+	"fixture-invalid": {
+		summary: "A fixture does not match the schema.",
+		fix: "Change the fixture, or the schema, so every fixture is a payload a send could carry."
+	},
+	"invalid-locale": {
+		summary: "The template's default locale is not a string literal.",
+		fix: "Write locale: \"en-US\"."
+	},
+	"no-channel": {
+		summary: "The template declares no channel body.",
+		fix: "Add an email body."
+	},
+	"invalid-channel": {
+		summary: "A channel field is not shaped as the channel requires.",
+		fix: "Write email: { subject, preheader?, body } with each a function of the input."
+	},
+	"not-a-function": {
+		summary: "A channel field is not a function of the input.",
+		fix: "Write (input) => ... in place or declare the function in the project."
+	},
+	"missing-subject": {
+		summary: "The email channel has no subject.",
+		fix: "Add subject: (input) => ...."
+	},
+	"missing-body": {
+		summary: "The email channel has no body.",
+		fix: "Add body: (input) => (<Email>...</Email>)."
+	},
+	"multiple-roots": {
+		summary: "The body renders nothing or more than one root.",
+		fix: "Wrap the body in a single element such as <Email>."
+	},
+	"preheader-without-shell": {
+		summary: "A preheader is set but the body has no <Email> shell to hold it.",
+		fix: "Wrap the body in <Email>."
+	},
+	"wrong-channel": {
+		summary: "A channel body does not return its own channel component.",
+		fix: "Return one element imported from the channel package.",
+		channelOnly: true
+	},
+	"syntax-error": {
+		summary: "A project file does not parse as TSX.",
+		fix: "Fix the syntax at the reported location."
+	},
+	"non-project-import": {
+		summary: "The file imports something other than @samva/markup or a project file.",
+		fix: "Remove the import, or copy the code you need into a project file."
+	},
+	"moved-import": {
+		summary: "The file imports an @samva/markup entry that moved.",
+		fix: "Import email components from \"@samva/markup/email\".",
+		upgrade: ["Replace every import from \"@samva/markup/email/components\" with \"@samva/markup/email\" in every project file, templates and partials alike. The imported names are unchanged; change only the specifier.", "Compile each entry and render every declared fixture to confirm the output is unchanged. Resolve errors before requesting one saved version for the whole project, approved by the user; do not publish."].join("\n\n")
+	},
+	"unresolved-import": {
+		summary: "An import names no file in the project.",
+		fix: "Check the path and the file extension."
+	},
+	"recursive-partial": {
+		summary: "A partial renders itself; partials are inlined at compile time.",
+		fix: "Flatten the recursion, or repeat the structure with .map."
+	},
+	"nesting-limit": {
+		summary: "The template nests deeper than the compiler reads.",
+		fix: "Flatten the structure."
+	},
+	"dynamic-expression": {
+		summary: "An expression outside the static profile: a call other than fmt.* and .map, a computed value, or a spread.",
+		fix: "Compute the value where the message is sent and bind it from the payload."
+	},
+	"statement-in-body": {
+		summary: "A body contains a statement (const, if, a loop); a body is one expression.",
+		fix: "Use cond && <X />, cond ? <A /> : <B /> and .map, or send the computed value in the payload."
+	},
+	"unsupported-pattern": {
+		summary: "A parameter pattern or default value the profile cannot bind.",
+		fix: "Use plain names or destructuring without defaults; declare the field required or guard it."
+	},
+	"hook-call": {
+		summary: "A hook was called; templates have no state, effects or context.",
+		fix: "Read the input through the function's parameter and send anything else in the payload."
+	},
+	"unknown-formatter": {
+		summary: "fmt.<name> is not a formatter.",
+		fix: "Use fmt.money, number, date, time, plural or list."
+	},
+	"formatter-arguments": {
+		summary: "A formatter got the wrong number of arguments.",
+		fix: "Match the formatter's signature in the contract."
+	},
+	"reserved-character": {
+		summary: "Text contains a private-use character the compiler reserves.",
+		fix: "Remove the characters U+E000 to U+E003."
+	},
+	"reserved-url": {
+		summary: "A URL is the unsubscribe placeholder only BrandFooter can write.",
+		fix: "Render <BrandFooter /> instead."
+	},
+	"reserved-attribute": {
+		summary: "An attribute is written only by a brand component.",
+		fix: "Render BrandFooter from the brand import instead of marking an element as the footer."
+	},
+	"dynamic-class": {
+		summary: "A class name is built at run time, and Tailwind cannot see it.",
+		fix: "Write classes literally, or choose between literal lists: input.vip ? \"bg-amber-100\" : \"bg-white\"."
+	},
+	"too-many-class-variants": {
+		summary: "A class list chooses between more literal lists than the compiler resolves.",
+		fix: "Split the choice into fewer conditions, or move part of it to a partial."
+	},
+	"invalid-style": {
+		summary: "A style prop is not a static property object.",
+		fix: "Write style={{ backgroundColor: \"#fff\" }} with literal values, or use classes."
+	},
+	"unknown-field": {
+		summary: "A binding names a field the schema does not declare.",
+		fix: "Add the field to the schema, or bind a field it declares (the message suggests the nearest)."
+	},
+	"unguarded-optional": {
+		summary: "An optional field is read outside a guard, so a send without it would render a blank.",
+		fix: "Guard it with {input.field && ...}, or make the field required."
+	},
+	"invalid-binding-type": {
+		summary: "A binding has the wrong type for where it is used.",
+		fix: "Bind a field of the type the position needs, or send it in that type."
+	},
+	"unknown-component": {
+		summary: "A component the profile cannot read.",
+		fix: "Import components from @samva/markup/email, the brand import, or the project."
+	},
+	"dynamic-numeric-prop": {
+		summary: "A prop that sizes layout at compile time is not a number literal.",
+		fix: "Write the number literally, for example height={44}."
+	},
+	"button-dynamic-label": {
+		summary: "A Button label is read at render time, so classic Outlook cannot size it.",
+		fix: "Give the button a width: <Button width={200}>."
+	},
+	"invalid-columns-each": {
+		summary: "<Columns each> is not a list from the input.",
+		fix: "Write each={input.items} with a callback returning <Column>."
+	},
+	"invalid-columns-per": {
+		summary: "<Columns per> is not a positive integer literal.",
+		fix: "Write per={2}."
+	},
+	"invalid-button-number": {
+		summary: "A Button size prop is not a finite number.",
+		fix: "Pass a finite number."
+	},
+	"unsupported-element": {
+		summary: "An element outside the supported email vocabulary.",
+		fix: "Use an element from the contract's element table."
+	},
+	"unsupported-attribute": {
+		summary: "An attribute the element does not support.",
+		fix: "Use a supported attribute, or data-* and aria-*."
+	},
+	"missing-attribute": {
+		summary: "An element is missing a required attribute.",
+		fix: "Add the attribute, for example alt on img."
+	},
+	"invalid-attribute-value": {
+		summary: "An attribute value is not a string or number, or contains control characters.",
+		fix: "Pass plain text."
+	},
+	"duplicate-attribute": {
+		summary: "An attribute is written twice.",
+		fix: "Keep one."
+	},
+	"invalid-content": {
+		summary: "An element holds content its content model does not allow.",
+		fix: "Move the child to a parent that accepts it."
+	},
+	"void-element-children": {
+		summary: "A void element has children.",
+		fix: "Remove the children."
+	},
+	"event-handler": {
+		summary: "An event handler; email clients strip scripting.",
+		fix: "Remove the handler; use a link for interaction."
+	},
+	"dangerous-html": {
+		summary: "dangerouslySetInnerHTML; there is no raw-HTML escape hatch.",
+		fix: "Write the markup as JSX."
+	},
+	"unsafe-url": {
+		summary: "A URL uses a scheme email cannot send safely.",
+		fix: "Use an https URL, a mailto: or tel: link, or a bound URL."
+	},
+	"unsafe-raw-text": {
+		summary: "Raw text content contains markup that could end its element.",
+		fix: "Remove the offending sequence."
+	},
+	"unsupported-style-property": {
+		summary: "A style property name is not a CSS property.",
+		fix: "Write camelCase (backgroundColor) or a custom property (--brand)."
+	},
+	"invalid-style-value": {
+		summary: "A style value is not a string or number.",
+		fix: "Pass a string or number."
+	},
+	"unsafe-style-value": {
+		summary: "A style value contains CSS that could break out of its declaration.",
+		fix: "Remove the offending characters."
+	},
+	"missing-head": {
+		summary: "Styles that cannot be inlined need a <head> to live in.",
+		fix: "Wrap the message in <Email>, or write those declarations inline."
+	},
+	"invalid-subject": {
+		summary: "The subject is not one line of text.",
+		fix: "Return a single-line string."
+	},
+	"invalid-preheader": {
+		summary: "The preheader is not a string.",
+		fix: "Return a string."
+	},
+	"invalid-text": {
+		summary: "The plain-text body is not a string.",
+		fix: "Return a string."
+	},
+	"button-outlook-fallback": {
+		summary: "Classic Outlook needs a height and a plain string label to draw the button.",
+		fix: "Give <Button> a height and a string label."
+	},
+	"unmatched-class": {
+		summary: "A class produced no styles.",
+		fix: "Use a class the theme or Tailwind defines, or write the style inline."
+	},
+	"tailwind-dynamic-class": {
+		summary: "A class list is assembled at run time.",
+		fix: "Write the classes literally."
+	},
+	"css-parse-error": {
+		summary: "A stylesheet does not parse.",
+		fix: "Fix the CSS at the reported location."
+	},
+	"css-import-unresolved": {
+		summary: "A stylesheet @import cannot be resolved.",
+		fix: "Import the stylesheet from the template module, or use the theme.css layers."
+	},
+	"css-unsupported-at-rule": {
+		summary: "An at-rule is not applied to email output.",
+		fix: "Remove it or move the declarations into a class rule."
+	},
+	"css-conditional-variable": {
+		summary: "A custom property is redefined inside a conditional at-rule.",
+		fix: "Keep the override on a class rule."
+	},
+	"email-font-fallback": {
+		summary: "A font stack names a project font without a generic fallback.",
+		fix: "End the stack with sans-serif, serif or monospace."
+	},
+	"email-font-family": {
+		summary: "@font-face declares no font-family.",
+		fix: "Add font-family."
+	},
+	"email-font-src": {
+		summary: "@font-face declares no usable url() src.",
+		fix: "Add a url() pointing at a .woff2 file."
+	},
+	"email-font-format": {
+		summary: "@font-face uses a format other than WOFF2.",
+		fix: "Convert the file to .woff2."
+	},
+	"email-font-missing": {
+		summary: "@font-face names a file the project does not hold.",
+		fix: "Add the file; paths resolve from the stylesheet's directory."
+	},
+	"invalid-asset-base": {
+		summary: "The asset base is not an https URL or a path.",
+		fix: "Use an https URL, an absolute path, or a relative path."
+	},
+	"brand-unavailable": {
+		summary: "The build has no brand to resolve a brand import.",
+		fix: "Create or select the brand the import names."
+	},
+	"brand-import-conflict": {
+		summary: "The project imports two different brands.",
+		fix: "Import one brand specifier everywhere."
+	},
+	"caniemail/unknown-coverage": {
+		summary: "A feature has no client-support data.",
+		fix: "Verify it in the target clients."
+	},
+	"invalid-attribute": {
+		summary: "A channel component attribute has a value the channel does not accept.",
+		fix: "Use one of the listed values.",
+		channelOnly: true
+	},
+	"unknown-attribute": {
+		summary: "A channel component attribute the component does not have.",
+		fix: "Use one of the listed attributes.",
+		channelOnly: true
+	},
+	"sms-markup": {
+		summary: "An SMS body contains an element; SMS is plain text.",
+		fix: "Write text and bindings, with a newline for a line break.",
+		channelOnly: true
+	},
+	"whatsapp-structure": {
+		summary: "WhatsApp content sits outside Header, Body, Footer or Buttons.",
+		fix: "Move it into <WhatsApp.Body>.",
+		channelOnly: true
+	},
+	"whatsapp-body-required": {
+		summary: "A WhatsApp template has no body.",
+		fix: "Add <WhatsApp.Body>...</WhatsApp.Body>.",
+		channelOnly: true
+	},
+	"whatsapp-conditional": {
+		summary: "A WhatsApp part branches or contains elements; Meta registers its text once.",
+		fix: "Choose the wording in the payload, or write separate templates.",
+		channelOnly: true
+	},
+	"whatsapp-header-media": {
+		summary: "A WhatsApp media header is not exactly one URL.",
+		fix: "Write the URL as the only child: a literal or one binding.",
+		channelOnly: true
+	},
+	"whatsapp-header-variables": {
+		summary: "A WhatsApp header text takes more than one variable.",
+		fix: "Keep one binding in the header and move the rest to the body.",
+		channelOnly: true
+	},
+	"whatsapp-length": {
+		summary: "A WhatsApp part exceeds Meta's length limit.",
+		fix: "Shorten the text.",
+		channelOnly: true
+	},
+	"whatsapp-button-text": {
+		summary: "A WhatsApp button has no label or value between its tags.",
+		fix: "Write the label or value as text between the tags.",
+		channelOnly: true
+	},
+	"whatsapp-button-limit": {
+		summary: "The conditions can produce more buttons of a kind than Meta allows.",
+		fix: "Remove buttons, or split the template.",
+		channelOnly: true
+	}
+});
+/** Whether a diagnostic identifier selects an agent-driven format upgrade. */
+const hasUpgradeRecipe = (code) => Object.entries(DIAGNOSTIC_CODES).some(([identifier, spec]) => identifier === code && "upgrade" in spec);
+/** Families whose code carries a suffix chosen at run time. */
+const DIAGNOSTIC_CODE_FAMILIES = { "caniemail/": {
+	summary: "A CSS property, HTML element or attribute that a target email client ignores or partly supports (from the caniemail.com data), reported as caniemail/<feature>.",
+	fix: "Use the alternative the message names, such as an email component instead of display: flex."
+} };
+//#endregion
+export { createDiagnosticFormatter as a, buildLineMap as i, DIAGNOSTIC_CODE_FAMILIES as n, formatDiagnostic as o, hasUpgradeRecipe as r, lineColumn as s, DIAGNOSTIC_CODES as t };

package/dist/{diagnostics-CnKFefKz.js → diagnostics-C0Tr8-eQ.js}

@@ -12,7 +12,8 @@ var EmailCompileError = class extends TaggedError("EmailCompileError") {
 const formatEmailDiagnostic = (diagnostic) => {
 	const origin = diagnostic.origins[0];
 	const head = `${origin === void 0 ? "<unknown source>" : `${origin.fileName}:${origin.lineNumber}:${origin.columnNumber}`} ${diagnostic.code}: ${diagnostic.message}`;
-	return diagnostic.fix === void 0 ? head : `${head}\n  Fix: ${diagnostic.fix}`;
+	const fixed = diagnostic.fix === void 0 ? head : `${head}\n  Fix: ${diagnostic.fix}`;
+	return diagnostic.upgrade === void 0 ? fixed : `${fixed}\n  Upgrade: ${diagnostic.upgrade}`;
 };
 /** True when a set of findings must stop the compile or refuse a publication. */
 const hasBlockingDiagnostic = (diagnostics) => diagnostics.some((diagnostic) => diagnostic.severity === "error");

package/dist/{diagnostics-B-Gym34R.d.ts → diagnostics-CUYlQ_6x.d.ts}

@@ -31,6 +31,8 @@ interface EmailDiagnostic {
 /** A finding of the static compiler: an `EmailDiagnostic` plus the change that resolves it. */
 interface TemplateDiagnostic extends EmailDiagnostic {
   readonly fix?: string | undefined;
+  /** Agent instructions for migrating a template made incompatible by a compiler change. */
+  readonly upgrade?: string | undefined;
 }
 declare const EmailCompileError_base: import("better-result").TaggedErrorClass<"EmailCompileError">;
 declare class EmailCompileError extends EmailCompileError_base<{

package/dist/diagnostics.d.ts

@@ -1,4 +1,4 @@
-import { a as TemplateDiagnostic, i as EmailDiagnosticSeverity, n as EmailCompileError, o as formatEmailDiagnostic, r as EmailDiagnostic, s as hasBlockingDiagnostic, t as EmailCompatibilityAssessment } from "./diagnostics-B-Gym34R.js";
+import { a as TemplateDiagnostic, i as EmailDiagnosticSeverity, n as EmailCompileError, o as formatEmailDiagnostic, r as EmailDiagnostic, s as hasBlockingDiagnostic, t as EmailCompatibilityAssessment } from "./diagnostics-CUYlQ_6x.js";
 import { a as createDiagnosticFormatter, i as buildLineMap, n as DiagnosticRepair, o as formatDiagnostic, r as Span, s as lineColumn, t as Diagnostic } from "./diagnostic-model-DxthUZBT.js";
 //#region src/diagnostic-codes.d.ts
 interface DiagnosticCodeSpec {

package/dist/diagnostics.js

@@ -1,404 +1,3 @@
-import { i as lineColumn, n as createDiagnosticFormatter, r as formatDiagnostic, t as buildLineMap } from "./diagnostic-model-DJtqbETd.js";
-import { n as formatEmailDiagnostic, r as hasBlockingDiagnostic, t as EmailCompileError } from "./diagnostics-CnKFefKz.js";
-//#region src/diagnostic-codes.ts
-const codes = (table) => table;
-const DIAGNOSTIC_CODES = codes({
-	"no-template": {
-		summary: "The entry does not default-export a template.",
-		fix: "Default-export defineTemplate({ ... }) imported from @samva/markup."
-	},
-	"legacy-definition": {
-		summary: "The entry default-exports something other than defineTemplate.",
-		fix: "Import { defineTemplate } from \"@samva/markup\" and default-export defineTemplate({ ... }).",
-		upgrade: [
-			"Read the entry and its imports without executing them. For a default-exported defineEmail definition, import defineTemplate from \"@samva/markup\" and replace the definition call.",
-			"Preserve the entry path, template id, schema, named fixtures, content, design, bindings, conditions, project partials, assets, theme and brand imports. Replace render(input) returning { subject, preheader?, body } with email: { subject: (input) => ..., preheader: (input) => ..., body: (input) => ... }, retaining its parameter bindings and each returned expression; omit preheader when absent.",
-			"Inline module constants only when they are literal strings, numbers or booleans and their bindings are unambiguous; never substitute a fixture value for an input binding. Keep each channel function a single static-profile expression, and keep subject and preheader off <Email>.",
-			"Helper calls, `Math.*`, general arithmetic, render statements, spreads, computed properties and runtime clock or seed have no direct conversion. Rewrite with static-profile bindings, conditions, .map, .filter, project partials or `fmt.*` where equivalent; arithmetic is allowed only in formatter arguments and conditions. Otherwise compute the value in the sender, declare a payload field in the schema and every fixture, and explain the required sender change. Never guess time, randomness or computed data.",
-			"Explicit text has no email-channel field: plain text is derived from the body. If deriving it changes intended content, or another construct cannot be preserved, explain the tradeoff and ask rather than silently discard it. Do not drop fixtures, weaken validation or hide diagnostics.",
-			"Convert every affected entry in the project at its existing path, including emails/ entries. Compile each entry, render every declared fixture and inspect the affected output. Resolve errors before requesting one saved version for the whole project, approved by the user; do not publish."
-		].join("\n\n")
-	},
-	"dynamic-definition": {
-		summary: "A definition field is spread or computed instead of written out.",
-		fix: "Write each field as name: value."
-	},
-	"invalid-template-id": {
-		summary: "The template id is not a lowercase kebab-case string literal.",
-		fix: "Write id: \"order-shipped\"."
-	},
-	"missing-schema": {
-		summary: "The template declares no input schema.",
-		fix: "Add schema: jsonSchema<Input>({ ... })."
-	},
-	"schema-not-static": {
-		summary: "The schema cannot be read without running code.",
-		fix: "Write the schema as a literal jsonSchema<Input>({ type: 'object', ... })."
-	},
-	"invalid-schema": {
-		summary: "The schema uses JSON Schema keywords the compiler cannot validate against.",
-		fix: "Use only the JSON Schema keywords the package README lists."
-	},
-	"missing-fixtures": {
-		summary: "The template declares no fixtures.",
-		fix: "Add fixtures: { default: { ... } } with at least one valid payload."
-	},
-	"fixtures-not-static": {
-		summary: "A fixture is computed instead of written as data.",
-		fix: "Write each fixture as a literal object; an imported asset is allowed."
-	},
-	"invalid-fixture-name": {
-		summary: "A fixture key is not a single path segment.",
-		fix: "Use letters, digits, '.', '_' and '-', starting with a letter or digit."
-	},
-	"fixture-invalid": {
-		summary: "A fixture does not match the schema.",
-		fix: "Change the fixture, or the schema, so every fixture is a payload a send could carry."
-	},
-	"invalid-locale": {
-		summary: "The template's default locale is not a string literal.",
-		fix: "Write locale: \"en-US\"."
-	},
-	"no-channel": {
-		summary: "The template declares no channel body.",
-		fix: "Add an email body."
-	},
-	"invalid-channel": {
-		summary: "A channel field is not shaped as the channel requires.",
-		fix: "Write email: { subject, preheader?, body } with each a function of the input."
-	},
-	"not-a-function": {
-		summary: "A channel field is not a function of the input.",
-		fix: "Write (input) => ... in place or declare the function in the project."
-	},
-	"missing-subject": {
-		summary: "The email channel has no subject.",
-		fix: "Add subject: (input) => ...."
-	},
-	"missing-body": {
-		summary: "The email channel has no body.",
-		fix: "Add body: (input) => (<Email>...</Email>)."
-	},
-	"multiple-roots": {
-		summary: "The body renders nothing or more than one root.",
-		fix: "Wrap the body in a single element such as <Email>."
-	},
-	"preheader-without-shell": {
-		summary: "A preheader is set but the body has no <Email> shell to hold it.",
-		fix: "Wrap the body in <Email>."
-	},
-	"wrong-channel": {
-		summary: "A channel body does not return its own channel component.",
-		fix: "Return one element imported from the channel package.",
-		channelOnly: true
-	},
-	"syntax-error": {
-		summary: "A project file does not parse as TSX.",
-		fix: "Fix the syntax at the reported location."
-	},
-	"non-project-import": {
-		summary: "The file imports something other than @samva/markup or a project file.",
-		fix: "Remove the import, or copy the code you need into a project file."
-	},
-	"moved-import": {
-		summary: "The file imports an @samva/markup entry that moved.",
-		fix: "Import email components from \"@samva/markup/email\".",
-		upgrade: ["Replace every import from \"@samva/markup/email/components\" with \"@samva/markup/email\" in every project file, templates and partials alike. The imported names are unchanged; change only the specifier.", "Compile each entry and render every declared fixture to confirm the output is unchanged. Resolve errors before requesting one saved version for the whole project, approved by the user; do not publish."].join("\n\n")
-	},
-	"unresolved-import": {
-		summary: "An import names no file in the project.",
-		fix: "Check the path and the file extension."
-	},
-	"recursive-partial": {
-		summary: "A partial renders itself; partials are inlined at compile time.",
-		fix: "Flatten the recursion, or repeat the structure with .map."
-	},
-	"nesting-limit": {
-		summary: "The template nests deeper than the compiler reads.",
-		fix: "Flatten the structure."
-	},
-	"dynamic-expression": {
-		summary: "An expression outside the static profile: a call other than fmt.* and .map, a computed value, or a spread.",
-		fix: "Compute the value where the message is sent and bind it from the payload."
-	},
-	"statement-in-body": {
-		summary: "A body contains a statement (const, if, a loop); a body is one expression.",
-		fix: "Use cond && <X />, cond ? <A /> : <B /> and .map, or send the computed value in the payload."
-	},
-	"unsupported-pattern": {
-		summary: "A parameter pattern or default value the profile cannot bind.",
-		fix: "Use plain names or destructuring without defaults; declare the field required or guard it."
-	},
-	"hook-call": {
-		summary: "A hook was called; templates have no state, effects or context.",
-		fix: "Read the input through the function's parameter and send anything else in the payload."
-	},
-	"unknown-formatter": {
-		summary: "fmt.<name> is not a formatter.",
-		fix: "Use fmt.money, number, date, time, plural or list."
-	},
-	"formatter-arguments": {
-		summary: "A formatter got the wrong number of arguments.",
-		fix: "Match the formatter's signature in the contract."
-	},
-	"reserved-character": {
-		summary: "Text contains a private-use character the compiler reserves.",
-		fix: "Remove the characters U+E000 to U+E003."
-	},
-	"reserved-url": {
-		summary: "A URL is the unsubscribe placeholder only BrandFooter can write.",
-		fix: "Render <BrandFooter /> instead."
-	},
-	"reserved-attribute": {
-		summary: "An attribute is written only by a brand component.",
-		fix: "Render BrandFooter from the brand import instead of marking an element as the footer."
-	},
-	"dynamic-class": {
-		summary: "A class name is built at run time, and Tailwind cannot see it.",
-		fix: "Write classes literally, or choose between literal lists: input.vip ? \"bg-amber-100\" : \"bg-white\"."
-	},
-	"too-many-class-variants": {
-		summary: "A class list chooses between more literal lists than the compiler resolves.",
-		fix: "Split the choice into fewer conditions, or move part of it to a partial."
-	},
-	"invalid-style": {
-		summary: "A style prop is not a static property object.",
-		fix: "Write style={{ backgroundColor: \"#fff\" }} with literal values, or use classes."
-	},
-	"unknown-field": {
-		summary: "A binding names a field the schema does not declare.",
-		fix: "Add the field to the schema, or bind a field it declares (the message suggests the nearest)."
-	},
-	"unguarded-optional": {
-		summary: "An optional field is read outside a guard, so a send without it would render a blank.",
-		fix: "Guard it with {input.field && ...}, or make the field required."
-	},
-	"invalid-binding-type": {
-		summary: "A binding has the wrong type for where it is used.",
-		fix: "Bind a field of the type the position needs, or send it in that type."
-	},
-	"unknown-component": {
-		summary: "A component the profile cannot read.",
-		fix: "Import components from @samva/markup/email, the brand import, or the project."
-	},
-	"dynamic-numeric-prop": {
-		summary: "A prop that sizes layout at compile time is not a number literal.",
-		fix: "Write the number literally, for example height={44}."
-	},
-	"button-dynamic-label": {
-		summary: "A Button label is read at render time, so classic Outlook cannot size it.",
-		fix: "Give the button a width: <Button width={200}>."
-	},
-	"invalid-columns-each": {
-		summary: "<Columns each> is not a list from the input.",
-		fix: "Write each={input.items} with a callback returning <Column>."
-	},
-	"invalid-columns-per": {
-		summary: "<Columns per> is not a positive integer literal.",
-		fix: "Write per={2}."
-	},
-	"invalid-button-number": {
-		summary: "A Button size prop is not a finite number.",
-		fix: "Pass a finite number."
-	},
-	"unsupported-element": {
-		summary: "An element outside the supported email vocabulary.",
-		fix: "Use an element from the contract's element table."
-	},
-	"unsupported-attribute": {
-		summary: "An attribute the element does not support.",
-		fix: "Use a supported attribute, or data-* and aria-*."
-	},
-	"missing-attribute": {
-		summary: "An element is missing a required attribute.",
-		fix: "Add the attribute, for example alt on img."
-	},
-	"invalid-attribute-value": {
-		summary: "An attribute value is not a string or number, or contains control characters.",
-		fix: "Pass plain text."
-	},
-	"duplicate-attribute": {
-		summary: "An attribute is written twice.",
-		fix: "Keep one."
-	},
-	"invalid-content": {
-		summary: "An element holds content its content model does not allow.",
-		fix: "Move the child to a parent that accepts it."
-	},
-	"void-element-children": {
-		summary: "A void element has children.",
-		fix: "Remove the children."
-	},
-	"event-handler": {
-		summary: "An event handler; email clients strip scripting.",
-		fix: "Remove the handler; use a link for interaction."
-	},
-	"dangerous-html": {
-		summary: "dangerouslySetInnerHTML; there is no raw-HTML escape hatch.",
-		fix: "Write the markup as JSX."
-	},
-	"unsafe-url": {
-		summary: "A URL uses a scheme email cannot send safely.",
-		fix: "Use an https URL, a mailto: or tel: link, or a bound URL."
-	},
-	"unsafe-raw-text": {
-		summary: "Raw text content contains markup that could end its element.",
-		fix: "Remove the offending sequence."
-	},
-	"unsupported-style-property": {
-		summary: "A style property name is not a CSS property.",
-		fix: "Write camelCase (backgroundColor) or a custom property (--brand)."
-	},
-	"invalid-style-value": {
-		summary: "A style value is not a string or number.",
-		fix: "Pass a string or number."
-	},
-	"unsafe-style-value": {
-		summary: "A style value contains CSS that could break out of its declaration.",
-		fix: "Remove the offending characters."
-	},
-	"missing-head": {
-		summary: "Styles that cannot be inlined need a <head> to live in.",
-		fix: "Wrap the message in <Email>, or write those declarations inline."
-	},
-	"invalid-subject": {
-		summary: "The subject is not one line of text.",
-		fix: "Return a single-line string."
-	},
-	"invalid-preheader": {
-		summary: "The preheader is not a string.",
-		fix: "Return a string."
-	},
-	"invalid-text": {
-		summary: "The plain-text body is not a string.",
-		fix: "Return a string."
-	},
-	"button-outlook-fallback": {
-		summary: "Classic Outlook needs a height and a plain string label to draw the button.",
-		fix: "Give <Button> a height and a string label."
-	},
-	"unmatched-class": {
-		summary: "A class produced no styles.",
-		fix: "Use a class the theme or Tailwind defines, or write the style inline."
-	},
-	"tailwind-dynamic-class": {
-		summary: "A class list is assembled at run time.",
-		fix: "Write the classes literally."
-	},
-	"css-parse-error": {
-		summary: "A stylesheet does not parse.",
-		fix: "Fix the CSS at the reported location."
-	},
-	"css-import-unresolved": {
-		summary: "A stylesheet @import cannot be resolved.",
-		fix: "Import the stylesheet from the template module, or use the theme.css layers."
-	},
-	"css-unsupported-at-rule": {
-		summary: "An at-rule is not applied to email output.",
-		fix: "Remove it or move the declarations into a class rule."
-	},
-	"css-conditional-variable": {
-		summary: "A custom property is redefined inside a conditional at-rule.",
-		fix: "Keep the override on a class rule."
-	},
-	"email-font-fallback": {
-		summary: "A font stack names a project font without a generic fallback.",
-		fix: "End the stack with sans-serif, serif or monospace."
-	},
-	"email-font-family": {
-		summary: "@font-face declares no font-family.",
-		fix: "Add font-family."
-	},
-	"email-font-src": {
-		summary: "@font-face declares no usable url() src.",
-		fix: "Add a url() pointing at a .woff2 file."
-	},
-	"email-font-format": {
-		summary: "@font-face uses a format other than WOFF2.",
-		fix: "Convert the file to .woff2."
-	},
-	"email-font-missing": {
-		summary: "@font-face names a file the project does not hold.",
-		fix: "Add the file; paths resolve from the stylesheet's directory."
-	},
-	"invalid-asset-base": {
-		summary: "The asset base is not an https URL or a path.",
-		fix: "Use an https URL, an absolute path, or a relative path."
-	},
-	"brand-unavailable": {
-		summary: "The build has no brand to resolve a brand import.",
-		fix: "Create or select the brand the import names."
-	},
-	"brand-import-conflict": {
-		summary: "The project imports two different brands.",
-		fix: "Import one brand specifier everywhere."
-	},
-	"caniemail/unknown-coverage": {
-		summary: "A feature has no client-support data.",
-		fix: "Verify it in the target clients."
-	},
-	"invalid-attribute": {
-		summary: "A channel component attribute has a value the channel does not accept.",
-		fix: "Use one of the listed values.",
-		channelOnly: true
-	},
-	"unknown-attribute": {
-		summary: "A channel component attribute the component does not have.",
-		fix: "Use one of the listed attributes.",
-		channelOnly: true
-	},
-	"sms-markup": {
-		summary: "An SMS body contains an element; SMS is plain text.",
-		fix: "Write text and bindings, with a newline for a line break.",
-		channelOnly: true
-	},
-	"whatsapp-structure": {
-		summary: "WhatsApp content sits outside Header, Body, Footer or Buttons.",
-		fix: "Move it into <WhatsApp.Body>.",
-		channelOnly: true
-	},
-	"whatsapp-body-required": {
-		summary: "A WhatsApp template has no body.",
-		fix: "Add <WhatsApp.Body>...</WhatsApp.Body>.",
-		channelOnly: true
-	},
-	"whatsapp-conditional": {
-		summary: "A WhatsApp part branches or contains elements; Meta registers its text once.",
-		fix: "Choose the wording in the payload, or write separate templates.",
-		channelOnly: true
-	},
-	"whatsapp-header-media": {
-		summary: "A WhatsApp media header is not exactly one URL.",
-		fix: "Write the URL as the only child: a literal or one binding.",
-		channelOnly: true
-	},
-	"whatsapp-header-variables": {
-		summary: "A WhatsApp header text takes more than one variable.",
-		fix: "Keep one binding in the header and move the rest to the body.",
-		channelOnly: true
-	},
-	"whatsapp-length": {
-		summary: "A WhatsApp part exceeds Meta's length limit.",
-		fix: "Shorten the text.",
-		channelOnly: true
-	},
-	"whatsapp-button-text": {
-		summary: "A WhatsApp button has no label or value between its tags.",
-		fix: "Write the label or value as text between the tags.",
-		channelOnly: true
-	},
-	"whatsapp-button-limit": {
-		summary: "The conditions can produce more buttons of a kind than Meta allows.",
-		fix: "Remove buttons, or split the template.",
-		channelOnly: true
-	}
-});
-/** Whether a diagnostic identifier selects an agent-driven format upgrade. */
-const hasUpgradeRecipe = (code) => Object.entries(DIAGNOSTIC_CODES).some(([identifier, spec]) => identifier === code && "upgrade" in spec);
-/** Families whose code carries a suffix chosen at run time. */
-const DIAGNOSTIC_CODE_FAMILIES = { "caniemail/": {
-	summary: "A CSS property, HTML element or attribute that a target email client ignores or partly supports (from the caniemail.com data), reported as caniemail/<feature>.",
-	fix: "Use the alternative the message names, such as an email component instead of display: flex."
-} };
-//#endregion
+import { a as createDiagnosticFormatter, i as buildLineMap, n as DIAGNOSTIC_CODE_FAMILIES, o as formatDiagnostic, r as hasUpgradeRecipe, s as lineColumn, t as DIAGNOSTIC_CODES } from "./diagnostic-codes-BduqCv_h.js";
+import { n as formatEmailDiagnostic, r as hasBlockingDiagnostic, t as EmailCompileError } from "./diagnostics-C0Tr8-eQ.js";
 export { DIAGNOSTIC_CODES, DIAGNOSTIC_CODE_FAMILIES, EmailCompileError, buildLineMap, createDiagnosticFormatter, formatDiagnostic, formatEmailDiagnostic, hasBlockingDiagnostic, hasUpgradeRecipe, lineColumn };

package/dist/edit.js

@@ -1,7 +1,7 @@
 import { n as isObject } from "./guards-eV1qLbf2.js";
 import { d as completeJsxSourceLocation, u as JSX_SOURCE_LOCATION_PROP } from "./jsx-runtime-CBlexoeR.js";
-import { t as buildLineMap } from "./diagnostic-model-DJtqbETd.js";
-import { c as WHATSAPP_HEADER_TYPES, n as introducedProfileErrors, o as SMS_CATEGORIES, s as WHATSAPP_CATEGORIES, t as checkStaticProfile } from "./profile-PUfi3GPH.js";
+import { i as buildLineMap } from "./diagnostic-codes-BduqCv_h.js";
+import { c as WHATSAPP_HEADER_TYPES, n as introducedProfileErrors, o as SMS_CATEGORIES, s as WHATSAPP_CATEGORIES, t as checkStaticProfile } from "./profile-CWZ2kkt-.js";
 import { parse } from "@babel/parser";
 //#region src/source-edit.ts
 const node = (value) => isObject(value) && "type" in value && typeof value.type === "string" && "start" in value && typeof value.start === "number" && "end" in value && typeof value.end === "number";

package/dist/email/jsx-dev-runtime.d.ts

@@ -1,5 +1,5 @@
 import { n as JsxSource } from "../source-locations-C8wCsiAy.js";
-import { a as JSX, i as Fragment, n as EmailComponent, r as EmailNode } from "../jsx-runtime-ylIOnaSf.js";
+import { a as JSX, i as Fragment, n as EmailComponent, r as EmailNode } from "../jsx-runtime-DC7xG0aA.js";
 //#region src/email/jsx-dev-runtime.d.ts
 /** Development JSX retains compiler-provided origins directly on the semantic tree. */
 declare const jsxDEV: (type: string | EmailComponent<Record<string, unknown>> | typeof Fragment, props: Record<string, unknown> | null, _key?: unknown, _staticChildren?: boolean, source?: JsxSource) => EmailNode;

package/dist/email/jsx-runtime.d.ts

@@ -1,2 +1,2 @@
-import { a as JSX, c as jsx, d as rawMarkup, f as reportEmailDiagnostic, i as Fragment, l as jsxs, n as EmailComponent, o as currentEmailOrigins, r as EmailNode, s as drainEmailDiagnostics, t as EmailChild, u as normalizeChildren } from "../jsx-runtime-ylIOnaSf.js";
+import { a as JSX, c as jsx, d as rawMarkup, f as reportEmailDiagnostic, i as Fragment, l as jsxs, n as EmailComponent, o as currentEmailOrigins, r as EmailNode, s as drainEmailDiagnostics, t as EmailChild, u as normalizeChildren } from "../jsx-runtime-DC7xG0aA.js";
 export { EmailChild, EmailComponent, EmailNode, Fragment, JSX, currentEmailOrigins, drainEmailDiagnostics, jsx, jsxs, normalizeChildren, rawMarkup, reportEmailDiagnostic };

package/dist/email.d.ts

@@ -1,4 +1,4 @@
-import { b as EmailStyle, r as EmailNode, t as EmailChild } from "./jsx-runtime-ylIOnaSf.js";
+import { b as EmailStyle, r as EmailNode, t as EmailChild } from "./jsx-runtime-DC7xG0aA.js";
 //#region src/email/components.d.ts
 /** Marks the hidden preview block so the renderer can read it back and the text lane can keep it. */
 declare const PREHEADER_ATTRIBUTE = "data-samva-preheader";

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-import { i as TEMPLATE_ID_PATTERN, o as TemplateInput, r as SmlTemplate, s as defineTemplate, t as EmailChannel } from "./template-DMPwxMSq.js";
+import { i as TEMPLATE_ID_PATTERN, o as TemplateInput, r as SmlTemplate, s as defineTemplate, t as EmailChannel } from "./template-B-UDXK8a.js";
 export { type EmailChannel, type SmlTemplate, TEMPLATE_ID_PATTERN, type TemplateInput, defineTemplate };

package/dist/{jsx-runtime-ylIOnaSf.d.ts → jsx-runtime-DC7xG0aA.d.ts}

@@ -1,5 +1,5 @@
 import { r as JsxSourceLocation } from "./source-locations-C8wCsiAy.js";
-import { r as EmailDiagnostic } from "./diagnostics-B-Gym34R.js";
+import { r as EmailDiagnostic } from "./diagnostics-CUYlQ_6x.js";
 //#region src/email/elements.d.ts
 /** How one attribute is spelled and what values it accepts. */
 interface EmailAttributeSpec {

package/dist/{profile-PUfi3GPH.js → profile-CWZ2kkt-.js}

@@ -6,7 +6,7 @@ import { FORMATTER_NAMES } from "./fmt.js";
 import { i as drainEmailDiagnostics, t as EmailNode } from "./jsx-runtime-CBlexoeR.js";
 import { a as Email, d as equalColumnWidth, i as Divider, l as Section, n as Column, o as Image, r as Columns, s as Link, t as Button, u as Spacer } from "./components-Bl6DT21n.js";
 import { n as applyStylesheet } from "./ir-De6pTH51.js";
-import { i as lineColumn, t as buildLineMap } from "./diagnostic-model-DJtqbETd.js";
+import { i as buildLineMap, s as lineColumn, t as DIAGNOSTIC_CODES } from "./diagnostic-codes-BduqCv_h.js";
 import { l as isAssetPath, n as brandComponents } from "./brand-DTctcDmf.js";
 import { parse } from "css-tree";
 import { parse as parse$1 } from "@babel/parser";
@@ -122,7 +122,7 @@ var Findings = class {
 		};
 	}
 	add(source, node, code, message, fix, severity = "error") {
-		this.items.push({
+		this.report({
 			code,
 			severity,
 			message,
@@ -130,6 +130,14 @@ var Findings = class {
 			origins: [this.locate(source, node)]
 		});
 	}
+	/** Attach the registry recipe wherever a known template finding enters the collection. */
+	report(diagnostic) {
+		const spec = DIAGNOSTIC_CODES[diagnostic.code];
+		this.items.push({
+			...diagnostic,
+			...spec.upgrade === void 0 ? {} : { upgrade: spec.upgrade }
+		});
+	}
 	get blocking() {
 		return this.items.some((item) => item.severity === "error");
 	}
@@ -3457,7 +3465,7 @@ const lowerProject = (options, project, findings, inputs) => {
 					...head,
 					children: [...head.children ?? [], ...additions]
 				}));
-				if (!edited.done) findings.items.push({
+				if (!edited.done) findings.report({
 					code: "missing-head",
 					severity: "error",
 					message: "Styles that cannot be inlined — media queries, dark-scheme rules and pseudo-selectors — need a <head> to live in.",
@@ -3496,7 +3504,7 @@ const lowerProject = (options, project, findings, inputs) => {
 	for (const finding of checks) {
 		const source = finding.src;
 		const file = sources[source?.[2] ?? 0] ?? options.entry;
-		findings.items.push({
+		findings.report({
 			code: finding.code,
 			severity: "error",
 			message: finding.message,

package/dist/{render-D2ht57ZZ.js → render-BVW-ESn-.js}

@@ -2,7 +2,7 @@ import { S as emailElement, o as serializeEmailHtml } from "./html-DjPxwjLi.js";
 import { i as drainEmailDiagnostics, t as EmailNode } from "./jsx-runtime-CBlexoeR.js";
 import { f as preheaderNode } from "./components-Bl6DT21n.js";
 import { n as applyStylesheet } from "./ir-De6pTH51.js";
-import { r as hasBlockingDiagnostic, t as EmailCompileError } from "./diagnostics-CnKFefKz.js";
+import { r as hasBlockingDiagnostic, t as EmailCompileError } from "./diagnostics-C0Tr8-eQ.js";
 //#region src/email/text.ts
 const PARAGRAPH = "\n\n";
 const LINE = "\n";

package/dist/{render-DQKz4Aco.d.ts → render-C28ucTh8.d.ts}

@@ -1,8 +1,8 @@
 import { t as BrandPlugin } from "./brand-plugin-CHhcei-j.js";
 import { r as JsxSourceLocation } from "./source-locations-C8wCsiAy.js";
-import { r as EmailDiagnostic } from "./diagnostics-B-Gym34R.js";
-import { r as EmailNode } from "./jsx-runtime-ylIOnaSf.js";
-import { n as EmailContent } from "./template-DMPwxMSq.js";
+import { r as EmailDiagnostic } from "./diagnostics-CUYlQ_6x.js";
+import { r as EmailNode } from "./jsx-runtime-DC7xG0aA.js";
+import { n as EmailContent } from "./template-B-UDXK8a.js";
 import "css-tree";
 //#region src/ir.d.ts
 /** The IR version this package writes. A publication pins the version it was built with. */

package/dist/render.d.ts

@@ -1,5 +1,5 @@
-import { C as isUrlAttribute, S as emailElement, _ as EmailGlobalProps, b as EmailStyle, g as EmailElementSpec, h as EmailAttributeSpec, m as EMAIL_GLOBAL_ATTRIBUTES, p as EMAIL_ELEMENTS, r as EmailNode, v as EmailIntrinsicElements, x as EmailTag, y as EmailLayout } from "./jsx-runtime-ylIOnaSf.js";
-import { $ as IrWhatsApp, A as emailAuthoringTarget, B as IrElement, D as EmittedPosition, E as EmailElementSelection, F as emailSelections, G as IrPredicate, H as IrFormatter, I as renderIrPreview, J as IrRawPart, K as IrPreheader, L as IrArithmetic, M as emailSelectionAncestry, N as emailSelectionIndex, O as INSTANCE_PATH_ATTRIBUTE, P as emailSelectionSiblings, Q as IrValue, R as IrComparison, U as IrIf, V as IrEmail, W as IrNode, X as IrSource, Y as IrSms, Z as IrStyle, a as renderEmailContent, at as RenderedPosition, c as checkAttribute, ct as TemplateIr, d as escapeText, et as IrWhatsAppButton, f as kebab, i as compileEmail, it as RenderedIrWhatsApp, j as emailDefinitionInstances, k as IrPreview, l as declarationValue, m as serializeStyle, n as EmailCompileOutput, nt as RenderOptions, o as EmailHtmlOutput, ot as RenderedWhatsAppButton, p as serializeEmailHtml, q as IrRaw, r as RenderedEmail, rt as RenderedIrEmail, s as SerializeEmailOptions, st as SML_IR_VERSION, t as EMAIL_DOCTYPE, tt as IrWhatsAppButtonNode, u as escapeAttribute, z as IrEach } from "./render-DQKz4Aco.js";
+import { C as isUrlAttribute, S as emailElement, _ as EmailGlobalProps, b as EmailStyle, g as EmailElementSpec, h as EmailAttributeSpec, m as EMAIL_GLOBAL_ATTRIBUTES, p as EMAIL_ELEMENTS, r as EmailNode, v as EmailIntrinsicElements, x as EmailTag, y as EmailLayout } from "./jsx-runtime-DC7xG0aA.js";
+import { $ as IrWhatsApp, A as emailAuthoringTarget, B as IrElement, D as EmittedPosition, E as EmailElementSelection, F as emailSelections, G as IrPredicate, H as IrFormatter, I as renderIrPreview, J as IrRawPart, K as IrPreheader, L as IrArithmetic, M as emailSelectionAncestry, N as emailSelectionIndex, O as INSTANCE_PATH_ATTRIBUTE, P as emailSelectionSiblings, Q as IrValue, R as IrComparison, U as IrIf, V as IrEmail, W as IrNode, X as IrSource, Y as IrSms, Z as IrStyle, a as renderEmailContent, at as RenderedPosition, c as checkAttribute, ct as TemplateIr, d as escapeText, et as IrWhatsAppButton, f as kebab, i as compileEmail, it as RenderedIrWhatsApp, j as emailDefinitionInstances, k as IrPreview, l as declarationValue, m as serializeStyle, n as EmailCompileOutput, nt as RenderOptions, o as EmailHtmlOutput, ot as RenderedWhatsAppButton, p as serializeEmailHtml, q as IrRaw, r as RenderedEmail, rt as RenderedIrEmail, s as SerializeEmailOptions, st as SML_IR_VERSION, t as EMAIL_DOCTYPE, tt as IrWhatsAppButtonNode, u as escapeAttribute, z as IrEach } from "./render-C28ucTh8.js";
 //#region src/render-ir.d.ts
 interface IrRenderDiagnostic {
   readonly code: string;

package/dist/render.js

@@ -1,6 +1,6 @@
 import { C as isUrlAttribute, S as emailElement, _ as renderIr, a as kebab, b as EMAIL_ELEMENTS, c as INSTANCE_PATH_ATTRIBUTE, d as emailSelectionAncestry, f as emailSelectionIndex, g as IrRenderError, h as renderIrPreview, i as escapeText, l as emailAuthoringTarget, m as emailSelections, n as declarationValue, o as serializeEmailHtml, p as emailSelectionSiblings, r as escapeAttribute, s as serializeStyle, t as checkAttribute, u as emailDefinitionInstances, v as renderIrSms, x as EMAIL_GLOBAL_ATTRIBUTES, y as renderIrWhatsApp } from "./html-DjPxwjLi.js";
 import { t as SML_IR_VERSION } from "./ir-De6pTH51.js";
-import { i as deriveEmailText, n as compileEmail, r as renderEmailContent, t as EMAIL_DOCTYPE } from "./render-D2ht57ZZ.js";
+import { i as deriveEmailText, n as compileEmail, r as renderEmailContent, t as EMAIL_DOCTYPE } from "./render-BVW-ESn-.js";
 //#region src/sms-segments.ts
 const GSM7_EXTENDED = /* @__PURE__ */ new Set([
 	"[",

package/dist/sms.d.ts

@@ -1,4 +1,4 @@
-import { r as EmailNode, t as EmailChild } from "./jsx-runtime-ylIOnaSf.js";
+import { r as EmailNode, t as EmailChild } from "./jsx-runtime-DC7xG0aA.js";
 import { t as SmsCategory } from "./channel-specs-C2feJwuP.js";
 //#region src/sms.d.ts
 interface SmsProps {

package/dist/{template-DMPwxMSq.d.ts → template-B-UDXK8a.d.ts}

@@ -1,4 +1,4 @@
-import { r as EmailNode } from "./jsx-runtime-ylIOnaSf.js";
+import { r as EmailNode } from "./jsx-runtime-DC7xG0aA.js";
 import { r as InputSchema } from "./input-schema-7dPFVvNE.js";
 import { StandardJSONSchemaV1 } from "@standard-schema/spec";
 //#region src/template.d.ts

package/dist/whatsapp.d.ts

@@ -1,4 +1,4 @@
-import { r as EmailNode, t as EmailChild } from "./jsx-runtime-ylIOnaSf.js";
+import { r as EmailNode, t as EmailChild } from "./jsx-runtime-DC7xG0aA.js";
 import { n as WhatsAppCategory, r as WhatsAppHeaderType } from "./channel-specs-C2feJwuP.js";
 //#region src/whatsapp.d.ts
 interface WhatsAppProps {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@samva/markup",
-  "version": "0.11.3",
+  "version": "0.12.0",
   "description": "Type-safe authoring and compilation primitives for Samva templates",
   "keywords": [
     "email",

package/dist/diagnostic-model-DJtqbETd.js

@@ -1,36 +0,0 @@
-//#region src/diagnostic-model.ts
-/** Newline-offset line map. Build once per source, query with `lineColumn`. */
-const buildLineMap = (source) => {
-	const lineStarts = [0];
-	for (let index = 0; index < source.length; index++) {
-		const code = source.charCodeAt(index);
-		if (code === 10 || code === 13 && source.charCodeAt(index + 1) !== 10 || code === 8232 || code === 8233) lineStarts.push(index + 1);
-	}
-	return lineStarts;
-};
-/** 1-based line/column for an absolute offset, via binary search. */
-const lineColumn = (lineMap, offset) => {
-	let low = 0;
-	let high = lineMap.length - 1;
-	while (low < high) {
-		const middle = low + high + 1 >> 1;
-		if (lineMap[middle] <= offset) low = middle;
-		else high = middle - 1;
-	}
-	return {
-		line: low + 1,
-		column: offset - lineMap[low] + 1
-	};
-};
-/** Build one formatter for a batch of diagnostics against the same source. */
-const createDiagnosticFormatter = (source) => {
-	const lineMap = buildLineMap(source);
-	return (diagnostic) => {
-		const { line, column } = lineColumn(lineMap, diagnostic.span.start);
-		return `line ${line}:${column} ${diagnostic.message}`;
-	};
-};
-/** "line 12:8 unknown class ..." — the shape agents iterate on. */
-const formatDiagnostic = (source, diagnostic) => createDiagnosticFormatter(source)(diagnostic);
-//#endregion
-export { lineColumn as i, createDiagnosticFormatter as n, formatDiagnostic as r, buildLineMap as t };