@samva/markup 0.18.0 → 0.19.0

package/dist/render.d.ts

@@ -1,6 +1,6 @@
-import { t as BrandPlugin } from "./brand-plugin-Dj9SMpfS.js";
-import { C as emailElement, S as EmailTag, _ as EmailElementSpec, b as EmailLayout, g as EmailAttributeSpec, h as EMAIL_GLOBAL_ATTRIBUTES, m as EMAIL_ELEMENTS, v as EmailGlobalProps, w as isUrlAttribute, x as EmailStyle, y as EmailIntrinsicElements } from "./jsx-runtime-DL8NVF1f.js";
-import { A as smsSegmentInfo, C as RenderedEmail, D as RenderedWhatsAppButton, E as RenderedWhatsApp, O as SmsEncoding, S as CompiledWhatsAppButtonNode, T as RenderedSms, _ as CompiledStyle, a as CompiledEach, b as CompiledWhatsApp, c as CompiledFormatter, d as CompiledPredicate, f as CompiledPreheader, g as CompiledSource, h as CompiledSms, i as CompiledComparison, k as SmsSegmentInfo, l as CompiledIf, m as CompiledRawPart, n as Channel, o as CompiledElement, p as CompiledRaw, r as CompiledArithmetic, s as CompiledEmail, t as COMPILED_TEMPLATE_VERSION, u as CompiledNode, v as CompiledTemplate, w as RenderedMessage, x as CompiledWhatsAppButton, y as CompiledValue } from "./compiled-template-Bc4Dq9zy.js";
+import { m as BrandPlugin } from "./brand-Bxb6Sm7y.js";
+import { C as emailElement, S as EmailTag, _ as EmailElementSpec, b as EmailLayout, g as EmailAttributeSpec, h as EMAIL_GLOBAL_ATTRIBUTES, m as EMAIL_ELEMENTS, v as EmailGlobalProps, w as isUrlAttribute, x as EmailStyle, y as EmailIntrinsicElements } from "./jsx-runtime-HHfrVZEf.js";
+import { A as RenderedWhatsAppButton, B as SemanticIntrinsic, C as PageHeadHints, D as RenderedPosition, E as RenderedPage, F as EmailPresentation, H as WebCssRule, I as EmailPresentationOverride, K as SemanticComponentName, L as SemanticBlock, M as SmsEncoding, N as SmsSegmentInfo, O as RenderedSms, P as smsSegmentInfo, R as SemanticComponent, S as CompiledWhatsAppButtonNode, T as RenderedMessage, U as WebPresentation, V as SemanticProp, _ as CompiledStyle, a as CompiledEach, b as CompiledWhatsApp, c as CompiledFormatter, d as CompiledPredicate, f as CompiledPreheader, g as CompiledSource, h as CompiledSms, i as CompiledComparison, j as Target, k as RenderedWhatsApp, l as CompiledIf, m as CompiledRawPart, n as Channel, o as CompiledElement, p as CompiledRaw, r as CompiledArithmetic, s as CompiledEmail, t as COMPILED_TEMPLATE_VERSION, u as CompiledNode, v as CompiledTemplate, w as RenderedEmail, x as CompiledWhatsAppButton, y as CompiledValue, z as SemanticInline } from "./compiled-template-CPDHvFlt.js";
 //#region src/render-template.d.ts
 interface RenderDiagnostic {
   readonly code: string;
@@ -29,12 +29,12 @@ interface RenderSettings {
   readonly brandPlugin?: BrandPlugin | undefined;
 }
 /**
- * Render one channel of a compiled template against one validated input. It throws only
- * `RenderError`: a template compiled by another version, a channel the template does not declare,
+ * Render one target of a compiled template against one validated input. It throws only
+ * `RenderError`: a template compiled by another version, a target the template does not support,
  * or input or markup the renderer refuses.
  */
-declare const render: <C extends Channel>(template: CompiledTemplate, input: unknown, options: RenderSettings & {
-  readonly channel: C;
+declare const render: <C extends Target>(template: CompiledTemplate, input: unknown, options: RenderSettings & {
+  readonly target: C;
 }) => RenderedMessage[C];
 //#endregion
 //#region src/email/html.d.ts
@@ -43,4 +43,4 @@ declare const escapeText: (value: string) => string;
 /** Escape a value for a double-quoted attribute. */
 declare const escapeAttribute: (value: string) => string;
 //#endregion
-export { COMPILED_TEMPLATE_VERSION, type Channel, type CompiledArithmetic, type CompiledComparison, type CompiledEach, type CompiledElement, type CompiledEmail, type CompiledFormatter, type CompiledIf, type CompiledNode, type CompiledPredicate, type CompiledPreheader, type CompiledRaw, type CompiledRawPart, type CompiledSms, type CompiledSource, type CompiledStyle, type CompiledTemplate, type CompiledValue, type CompiledWhatsApp, type CompiledWhatsAppButton, type CompiledWhatsAppButtonNode, EMAIL_ELEMENTS, EMAIL_GLOBAL_ATTRIBUTES, type EmailAttributeSpec, type EmailElementSpec, type EmailGlobalProps, type EmailIntrinsicElements, type EmailLayout, type EmailStyle, type EmailTag, type RenderDiagnostic, RenderError, type RenderedEmail, type RenderedMessage, type RenderedSms, type RenderedWhatsApp, type RenderedWhatsAppButton, type SmsEncoding, type SmsSegmentInfo, emailElement, escapeAttribute, escapeText, isUrlAttribute, render, smsSegmentInfo };
+export { COMPILED_TEMPLATE_VERSION, type Channel, type CompiledArithmetic, type CompiledComparison, type CompiledEach, type CompiledElement, type CompiledEmail, type CompiledFormatter, type CompiledIf, type CompiledNode, type CompiledPredicate, type CompiledPreheader, type CompiledRaw, type CompiledRawPart, type CompiledSms, type CompiledSource, type CompiledStyle, type CompiledTemplate, type CompiledValue, type CompiledWhatsApp, type CompiledWhatsAppButton, type CompiledWhatsAppButtonNode, EMAIL_ELEMENTS, EMAIL_GLOBAL_ATTRIBUTES, type EmailAttributeSpec, type EmailElementSpec, type EmailGlobalProps, type EmailIntrinsicElements, type EmailLayout, type EmailPresentation, type EmailPresentationOverride, type EmailStyle, type EmailTag, type PageHeadHints, type RenderDiagnostic, RenderError, type RenderedEmail, type RenderedMessage, type RenderedPage, type RenderedPosition, type RenderedSms, type RenderedWhatsApp, type RenderedWhatsAppButton, type SemanticBlock, type SemanticComponent, type SemanticComponentName, type SemanticInline, type SemanticIntrinsic, type SemanticProp, type SmsEncoding, type SmsSegmentInfo, type Target, type WebCssRule, type WebPresentation, emailElement, escapeAttribute, escapeText, isUrlAttribute, render, smsSegmentInfo };

package/dist/render.js

@@ -1,3 +1,2 @@
-import { i as escapeText, r as escapeAttribute } from "./html-DJUK2YJF.js";
-import { a as EMAIL_ELEMENTS, c as isUrlAttribute, i as smsSegmentInfo, n as render, o as EMAIL_GLOBAL_ATTRIBUTES, p as COMPILED_TEMPLATE_VERSION, s as emailElement, t as RenderError } from "./render-template-DwPDm3Hq.js";
+import { J as EMAIL_GLOBAL_ATTRIBUTES, O as RenderError, X as isUrlAttribute, Y as emailElement, g as escapeText, h as escapeAttribute, j as smsSegmentInfo, k as render, q as EMAIL_ELEMENTS, tt as COMPILED_TEMPLATE_VERSION } from "./components-DNBCz20_.js";
 export { COMPILED_TEMPLATE_VERSION, EMAIL_ELEMENTS, EMAIL_GLOBAL_ATTRIBUTES, RenderError, emailElement, escapeAttribute, escapeText, isUrlAttribute, render, smsSegmentInfo };

package/dist/{css-B_aVKrDo.js → selectors-CKGuc9MO.js}

@@ -1,7 +1,94 @@
-import { t as downlevelColors } from "./css-color-DLM12Osu.js";
-import { n as isDarkSchemeCondition } from "./dark-scheme-CbCwGDWH.js";
-import { o as unquote } from "./selectors-CYWCoxZr.js";
+import { a as downlevelColors, n as isDarkSchemeCondition } from "./dark-scheme-BGDCCaUq.js";
 import { generate, ident, parse, walk } from "css-tree";
+//#region src/email/font-stacks.ts
+/** Generic families every email client understands as the last resort in a stack. */
+const GENERIC_FAMILIES = /* @__PURE__ */ new Set([
+	"serif",
+	"sans-serif",
+	"monospace",
+	"cursive",
+	"fantasy"
+]);
+/** One family name as written, without its quotes and with runs of spaces collapsed. */
+const unquote = (value) => {
+	const trimmed = value.trim();
+	const quote = trimmed[0];
+	return (quote === "\"" || quote === "'") && trimmed.endsWith(quote) && trimmed.length >= 2 ? trimmed.slice(1, -1) : trimmed.replace(/\s+/g, " ");
+};
+/** The families of a `font-family` value, unquoted, in stack order. */
+const fontStackFamilies = (value) => {
+	const families = [];
+	let start = 0;
+	let quote;
+	for (let index = 0; index < value.length; index++) {
+		const character = value[index];
+		if (quote !== void 0) {
+			if (character === quote) quote = void 0;
+		} else if (character === "'" || character === "\"") quote = character;
+		else if (character === ",") {
+			families.push(unquote(value.slice(start, index)));
+			start = index + 1;
+		}
+	}
+	families.push(unquote(value.slice(start)));
+	return families.filter((family) => family !== "");
+};
+const FONT_SIZE = /^(?:xx-small|x-small|small|medium|large|x-large|xx-large|xxx-large|larger|smaller|[+-]?(?:\d+\.?\d*|\.\d+)(?:[a-z]+|%)|(?:calc|clamp|min|max|var)\(.*\))$/i;
+/** Whitespace-separated tokens at the top level, keeping parentheses and quotes whole. */
+const shorthandTokens = (value) => {
+	const tokens = [];
+	let current = "";
+	let depth = 0;
+	let quote;
+	for (const character of value.trim()) {
+		if (quote !== void 0) {
+			if (character === quote) quote = void 0;
+		} else if (character === "'" || character === "\"") quote = character;
+		else if (character === "(") depth++;
+		else if (character === ")") depth--;
+		else if (/\s/.test(character) && depth === 0) {
+			if (current !== "") tokens.push(current);
+			current = "";
+			continue;
+		}
+		current += character;
+	}
+	if (current !== "") tokens.push(current);
+	return tokens;
+};
+/**
+* The family list of a `font` shorthand: everything after the size (and its
+* optional line height), or `undefined` for a system-font keyword that names
+* no family.
+*/
+const fontShorthandFamilies = (value) => {
+	const tokens = shorthandTokens(value);
+	const size = tokens.findIndex((token) => FONT_SIZE.test(token.replace(/\/.*$/, "")));
+	if (size < 0) return void 0;
+	let next = size + 1;
+	const sizeToken = tokens[size];
+	if (sizeToken.endsWith("/")) next += 1;
+	else if (!sizeToken.includes("/") && tokens[next]?.startsWith("/")) next += tokens[next] === "/" ? 2 : 1;
+	const family = tokens.slice(next).join(" ");
+	return family === "" ? void 0 : family;
+};
+/**
+* True when a stack names a declared project family without ending in a
+* generic. `declared` holds lowercased family names. A quoted `"sans-serif"`
+* names a font called sans-serif, not the generic, so it does not count.
+*/
+const lacksGenericFallback = (value, declared) => {
+	const stack = value.replace(/\s*!important\s*$/i, "");
+	if (!fontStackFamilies(stack).some((family) => declared.has(family.toLowerCase()))) return false;
+	const last = stack.slice(stack.lastIndexOf(",") + 1).trim();
+	return !GENERIC_FAMILIES.has(last.toLowerCase());
+};
+const fontFallbackDiagnostic = (value) => ({
+	code: "email-font-fallback",
+	severity: "error",
+	message: `font-family ${JSON.stringify(value)} uses a project font without a generic fallback. Clients that drop webfonts (Gmail, classic Outlook) render this stack as written, so end it with sans-serif, serif or monospace.`
+});
+//#endregion
 //#region src/email/fonts.ts
 const FONT_FILE = /\.woff2$/i;
 const WOFF2_FORMAT = /^woff2(?:-variations)?$/i;
@@ -433,4 +520,71 @@ const parseStylesheet = (source, options = {}) => {
 	};
 };
 //#endregion
-export { parseStylesheet as t };
+//#region src/email/selectors.ts
+const classListOf = (element) => {
+	const value = element.props.class ?? element.props.className;
+	return typeof value === "string" ? value.split(/\s+/).filter((name) => name !== "") : [];
+};
+const attributeOf = (element, name) => {
+	const value = element.props[name];
+	if (value === void 0 || value === null || value === false) return void 0;
+	if (value === true) return "";
+	return typeof value === "string" || typeof value === "number" ? String(value) : void 0;
+};
+const matchesAttribute = (element, test) => {
+	const actual = test.name === "class" ? classListOf(element).join(" ") : attributeOf(element, test.name);
+	if (actual === void 0) return false;
+	if (test.operator === void 0 || test.value === void 0) return true;
+	switch (test.operator) {
+		case "=": return actual === test.value;
+		case "~=": return actual.split(/\s+/).includes(test.value);
+		case "^=": return actual.startsWith(test.value);
+		case "$=": return actual.endsWith(test.value);
+		case "*=": return actual.includes(test.value);
+		case "|=": return actual === test.value || actual.startsWith(`${test.value}-`);
+		default: return false;
+	}
+};
+const matchesCompound = (element, compound) => {
+	if (compound.opaque) return false;
+	if (compound.tag !== void 0 && compound.tag !== element.tag) return false;
+	if (compound.id !== void 0 && attributeOf(element, "id") !== compound.id) return false;
+	if (compound.classes.length > 0) {
+		const classes = classListOf(element);
+		if (!compound.classes.every((name) => classes.includes(name))) return false;
+	}
+	return compound.attributes.every((test) => matchesAttribute(element, test));
+};
+const matchesFrom = (selector, index, ancestry) => {
+	if (ancestry === void 0) return false;
+	const part = selector.parts[index];
+	if (part === void 0) return false;
+	if (!matchesCompound(ancestry.element, part.compound)) return false;
+	const left = selector.parts[index - 1];
+	if (left === void 0) return true;
+	switch (left.after ?? "descendant") {
+		case "child": return matchesFrom(selector, index - 1, ancestry.parent);
+		case "descendant":
+			for (let parent = ancestry.parent; parent !== void 0; parent = parent.parent) if (matchesFrom(selector, index - 1, parent)) return true;
+			return false;
+		case "adjacent": {
+			const sibling = ancestry.previous.at(-1);
+			return sibling === void 0 ? false : matchesFrom(selector, index - 1, {
+				element: sibling,
+				parent: ancestry.parent,
+				previous: ancestry.previous.slice(0, -1)
+			});
+		}
+		case "sibling":
+			for (let position = ancestry.previous.length - 1; position >= 0; position--) if (matchesFrom(selector, index - 1, {
+				element: ancestry.previous[position],
+				parent: ancestry.parent,
+				previous: ancestry.previous.slice(0, position)
+			})) return true;
+			return false;
+	}
+};
+/** Match a compiled selector against one element in its tree position. */
+const matchesSelector = (selector, ancestry) => selector === void 0 || selector.parts.length === 0 ? false : matchesFrom(selector, selector.parts.length - 1, ancestry);
+//#endregion
+export { fontShorthandFamilies as a, fontFallbackDiagnostic as i, matchesSelector as n, lacksGenericFallback as o, parseStylesheet as r, classListOf as t };

package/dist/sms.d.ts

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

package/dist/{template-DmNcoH4Q.d.ts → template-4Dse7_OC.d.ts}

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

package/dist/{theme-css-P9F5S7Ic.js → theme-css-BujDuuEA.js}

@@ -1,5 +1,4 @@
-import { n as parseColor } from "./css-color-DLM12Osu.js";
-import { r as isDarkSchemeQuery } from "./dark-scheme-CbCwGDWH.js";
+import { o as parseColor, r as isDarkSchemeQuery } from "./dark-scheme-BGDCCaUq.js";
 import { Result } from "better-result";
 import { generate, parse, walk } from "css-tree";
 //#region src/theme-css.ts

package/dist/whatsapp.d.ts

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

package/generated/contract.json

@@ -1,6 +1,6 @@
 {
   "contract": 1,
-  "compiledTemplateVersion": 1,
+  "compiledTemplateVersion": 2,
   "template": {
     "extension": ".tsx",
     "directories": ["templates", "emails"],
@@ -1550,6 +1550,11 @@
       "summary": "A prop that sizes layout at compile time is not a number literal.",
       "fix": "Write the number literally, for example height={44}."
     },
+    {
+      "code": "email-component-degradation",
+      "summary": "A component loses content or behavior when lowered to email.",
+      "fix": "Compare the email and web previews; provide an email-safe equivalent for content readers need."
+    },
     {
       "code": "email-contrast",
       "summary": "Text, or a filled button against its surroundings, falls below the contrast ratio in light or dark mode (below 1.5:1 a button is indistinguishable from its surface; WCAG 1.4.11 asks 3:1).",
@@ -1717,12 +1722,47 @@
       "summary": "The plain-text body is not a string.",
       "fix": "Return a string."
     },
+    {
+      "code": "issue-layout",
+      "summary": "A newsletter issue layout does not declare only an email channel.",
+      "fix": "Use an email-only defineTemplate layout with one IssueContent slot."
+    },
+    {
+      "code": "issue-slot",
+      "summary": "An issue layout does not contain exactly one unconditional content slot.",
+      "fix": "Import IssueContent from @samva/markup/email and place one <IssueContent /> outside loops and conditions."
+    },
     {
       "code": "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.\n\nPreserve 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.\n\nInline 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>.\n\nHelper 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.\n\nExplicit 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.\n\nConvert 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."
     },
+    {
+      "code": "markdown-expression",
+      "summary": "An issue contains an expression or spread, which is never evaluated.",
+      "fix": "Replace expressions with literal prose or quoted static component attributes."
+    },
+    {
+      "code": "markdown-frontmatter",
+      "summary": "Issue frontmatter is missing or does not match the typed contract.",
+      "fix": "Provide title, slug and topic strings; use only the documented preheader, seo and gate fields."
+    },
+    {
+      "code": "markdown-html",
+      "summary": "An issue contains raw HTML rather than a supported SML component.",
+      "fix": "Use Markdown syntax or a component from the closed SML component set."
+    },
+    {
+      "code": "markdown-prop",
+      "summary": "A Markdown component has an unknown, missing or invalid literal prop.",
+      "fix": "Use the component's documented props with quoted static values or bare boolean flags."
+    },
+    {
+      "code": "markdown-syntax",
+      "summary": "An issue contains syntax outside SML Markdown.",
+      "fix": "Write Markdown prose and supported SML component tags."
+    },
     {
       "code": "missing-attribute",
       "summary": "An element is missing a required attribute.",