@samva/markup 0.18.1 → 0.19.0

package/dist/{css-color-DLM12Osu.js → dark-scheme-BGDCCaUq.js}

@@ -312,4 +312,15 @@ const downlevelColors = (value) => {
 	return result;
 };
 //#endregion
-export { parseColor as n, downlevelColors as t };
+//#region src/email/dark-scheme.ts
+/** The media query a theme's dark-mode block and every generated dark-mode rule sit in. */
+const DARK_SCHEME_MEDIA = "@media (prefers-color-scheme: dark)";
+const DARK_SCHEME_QUERY = /^(?:only\s+)?(?:screen\s+and\s+)?\(\s*prefers-color-scheme\s*:\s*dark\s*\)$/i;
+/** Whether a `@media` prelude is exactly the dark-mode query. */
+const isDarkSchemeQuery = (prelude) => DARK_SCHEME_QUERY.test(prelude.trim());
+/** Whether a rule's enclosing conditions are exactly the dark-mode query. */
+const isDarkSchemeCondition = (conditions) => conditions.length === 1 && /^@media\s/i.test(conditions[0]) && isDarkSchemeQuery(conditions[0].replace(/^@media\s+/i, ""));
+/** Whether any enclosing condition is the dark-mode query, as in a size query nested inside it. */
+const withinDarkScheme = (conditions) => conditions.some((condition) => isDarkSchemeCondition([condition]));
+//#endregion
+export { downlevelColors as a, withinDarkScheme as i, isDarkSchemeCondition as n, parseColor as o, isDarkSchemeQuery as r, DARK_SCHEME_MEDIA as t };

package/dist/{diagnostic-codes-DZKb0Xcg.js → diagnostic-codes-BCwfUgnF.js}

@@ -1,41 +1,34 @@
-//#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({
+	"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."
+	},
+	"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."
+	},
+	"markdown-syntax": {
+		summary: "An issue contains syntax outside SML Markdown.",
+		fix: "Write Markdown prose and supported SML component tags."
+	},
+	"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."
+	},
+	"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."
+	},
+	"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."
+	},
+	"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."
+	},
 	"no-template": {
 		summary: "The entry does not default-export a template.",
 		fix: "Default-export defineTemplate({ ... }) imported from @samva/markup."
@@ -392,6 +385,10 @@ const DIAGNOSTIC_CODES = codes({
 		summary: "The project imports two different brands.",
 		fix: "Import one brand specifier everywhere."
 	},
+	"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."
+	},
 	"caniemail/unknown-coverage": {
 		summary: "A feature has no client-support data.",
 		fix: "Verify it in the target clients."
@@ -470,4 +467,4 @@ const DIAGNOSTIC_CODE_FAMILIES = { "caniemail/": {
 	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 };
+export { DIAGNOSTIC_CODE_FAMILIES as n, hasUpgradeRecipe as r, DIAGNOSTIC_CODES as t };

package/dist/diagnostic-model-DJtqbETd.js

@@ -0,0 +1,36 @@
+//#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 };

package/dist/{diagnostics-D4vSLQrO.d.ts → diagnostics-C3TSx6SU.d.ts}

@@ -1,4 +1,24 @@
-import { r as JsxSourceLocation } from "./source-locations-C8wCsiAy.js";
+//#region src/source-locations.d.ts
+/**
+ * The source payload a JSX transform may attach to an element. The transform may omit any field
+ * for synthetic calls; only a complete payload can identify a source origin safely.
+ */
+interface JsxSource {
+  readonly fileName?: string | undefined;
+  readonly lineNumber?: number | undefined;
+  readonly columnNumber?: number | undefined;
+}
+/** A complete, normalized source origin for a JSX element. */
+interface JsxSourceLocation {
+  readonly fileName: string;
+  readonly lineNumber: number;
+  readonly columnNumber: number;
+}
+/** The JSX prop that carries a {@link JsxSource} to the email JSX runtime. */
+declare const JSX_SOURCE_LOCATION_PROP: "__samva_source_location";
+/** Normalize the optional payload a JSX transform attaches. */
+declare const completeJsxSourceLocation: (source: JsxSource | null | undefined) => JsxSourceLocation | undefined;
+//#endregion
 //#region src/email/diagnostics.d.ts
 type EmailDiagnosticSeverity = "error" | "warning" | "info";
 /** What the emitted document establishes beyond the client feature matrix. */
@@ -39,4 +59,4 @@ declare const formatEmailDiagnostic: (diagnostic: TemplateDiagnostic) => string;
 /** True when a set of findings must stop the compile or refuse a publication. */
 declare const hasBlockingDiagnostic: (diagnostics: readonly EmailDiagnostic[]) => boolean;
 //#endregion
-export { formatEmailDiagnostic as a, TemplateDiagnostic as i, EmailDiagnostic as n, hasBlockingDiagnostic as o, EmailDiagnosticSeverity as r, EmailCompatibilityAssessment as t };
+export { formatEmailDiagnostic as a, JsxSource as c, TemplateDiagnostic as i, JsxSourceLocation as l, EmailDiagnostic as n, hasBlockingDiagnostic as o, EmailDiagnosticSeverity as r, JSX_SOURCE_LOCATION_PROP as s, EmailCompatibilityAssessment as t, completeJsxSourceLocation as u };

package/dist/diagnostics.d.ts

@@ -1,4 +1,4 @@
-import { a as formatEmailDiagnostic, i as TemplateDiagnostic, n as EmailDiagnostic, o as hasBlockingDiagnostic, r as EmailDiagnosticSeverity, t as EmailCompatibilityAssessment } from "./diagnostics-D4vSLQrO.js";
+import { a as formatEmailDiagnostic, i as TemplateDiagnostic, n as EmailDiagnostic, o as hasBlockingDiagnostic, r as EmailDiagnosticSeverity, t as EmailCompatibilityAssessment } from "./diagnostics-C3TSx6SU.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 {
@@ -12,6 +12,34 @@ interface DiagnosticCodeSpec {
   readonly channelOnly?: true;
 }
 declare const DIAGNOSTIC_CODES: {
+  readonly "issue-layout": {
+    readonly summary: "A newsletter issue layout does not declare only an email channel.";
+    readonly fix: "Use an email-only defineTemplate layout with one IssueContent slot.";
+  };
+  readonly "issue-slot": {
+    readonly summary: "An issue layout does not contain exactly one unconditional content slot.";
+    readonly fix: "Import IssueContent from @samva/markup/email and place one <IssueContent /> outside loops and conditions.";
+  };
+  readonly "markdown-syntax": {
+    readonly summary: "An issue contains syntax outside SML Markdown.";
+    readonly fix: "Write Markdown prose and supported SML component tags.";
+  };
+  readonly "markdown-expression": {
+    readonly summary: "An issue contains an expression or spread, which is never evaluated.";
+    readonly fix: "Replace expressions with literal prose or quoted static component attributes.";
+  };
+  readonly "markdown-html": {
+    readonly summary: "An issue contains raw HTML rather than a supported SML component.";
+    readonly fix: "Use Markdown syntax or a component from the closed SML component set.";
+  };
+  readonly "markdown-frontmatter": {
+    readonly summary: "Issue frontmatter is missing or does not match the typed contract.";
+    readonly fix: "Provide title, slug and topic strings; use only the documented preheader, seo and gate fields.";
+  };
+  readonly "markdown-prop": {
+    readonly summary: "A Markdown component has an unknown, missing or invalid literal prop.";
+    readonly fix: "Use the component's documented props with quoted static values or bare boolean flags.";
+  };
   readonly "no-template": {
     readonly summary: "The entry does not default-export a template.";
     readonly fix: "Default-export defineTemplate({ ... }) imported from @samva/markup.";
@@ -356,6 +384,10 @@ declare const DIAGNOSTIC_CODES: {
     readonly summary: "The project imports two different brands.";
     readonly fix: "Import one brand specifier everywhere.";
   };
+  readonly "email-component-degradation": {
+    readonly summary: "A component loses content or behavior when lowered to email.";
+    readonly fix: "Compare the email and web previews; provide an email-safe equivalent for content readers need.";
+  };
   readonly "caniemail/unknown-coverage": {
     readonly summary: "A feature has no client-support data.";
     readonly fix: "Verify it in the target clients.";

package/dist/diagnostics.js

@@ -1,3 +1,4 @@
 import { n as formatEmailDiagnostic, r as hasBlockingDiagnostic } from "./diagnostics-C0Tr8-eQ.js";
-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-DZKb0Xcg.js";
+import { i as lineColumn, n as createDiagnosticFormatter, r as formatDiagnostic, t as buildLineMap } from "./diagnostic-model-DJtqbETd.js";
+import { n as DIAGNOSTIC_CODE_FAMILIES, r as hasUpgradeRecipe, t as DIAGNOSTIC_CODES } from "./diagnostic-codes-BCwfUgnF.js";
 export { DIAGNOSTIC_CODES, DIAGNOSTIC_CODE_FAMILIES, buildLineMap, createDiagnosticFormatter, formatDiagnostic, formatEmailDiagnostic, hasBlockingDiagnostic, hasUpgradeRecipe, lineColumn };

package/dist/edit.d.ts

@@ -1,5 +1,5 @@
-import { i as completeJsxSourceLocation, n as JsxSource, r as JsxSourceLocation, t as JSX_SOURCE_LOCATION_PROP } from "./source-locations-C8wCsiAy.js";
-import { a as emailAuthoringTarget, c as emailSelectionIndex, d as previewEmail, i as INSTANCE_PATH_ATTRIBUTE, l as emailSelectionSiblings, n as EmailPreview, o as emailDefinitionInstances, r as EmittedPosition, s as emailSelectionAncestry, t as EmailElementSelection, u as emailSelections } from "./preview-rNoJBEIY.js";
+import { c as JsxSource, l as JsxSourceLocation, s as JSX_SOURCE_LOCATION_PROP, u as completeJsxSourceLocation } from "./diagnostics-C3TSx6SU.js";
+import { a as emailAuthoringTarget, c as emailSelectionIndex, d as previewEmail, i as INSTANCE_PATH_ATTRIBUTE, l as emailSelectionSiblings, n as EmailPreview, o as emailDefinitionInstances, r as EmittedPosition, s as emailSelectionAncestry, t as EmailElementSelection, u as emailSelections } from "./preview-DRLWgmfg.js";
 import { n as WhatsAppCategory, r as WhatsAppHeaderType, t as SmsCategory } from "./channel-specs-C2feJwuP.js";
 //#region src/source-edit.d.ts
 /** One exact source replacement; before text guards against concurrent changes. */
@@ -23,7 +23,7 @@ interface SourceProperty {
   readonly literalType: "string" | "number" | "boolean";
   readonly start: number;
   readonly end: number;
-  readonly syntax: "attribute" | "child" | "value";
+  readonly syntax: "attribute" | "child" | "value" | "markdown" | "markdown-attribute" | "markdown-boolean";
 }
 interface SourceElement {
   readonly start: number;
@@ -45,6 +45,13 @@ interface SourceRange {
 }
 /** Resolve a renderer origin against the unchanged authored entry, never against HTML offsets. */
 declare const inspectSourceElement: (source: string, file: string, origin: JsxSourceLocation) => SourceElement | null;
+/**
+ * Resolve a Markdown render origin to authored prose or component attributes. A tag distinguishes
+ * nodes sharing an origin; without one, prefer an editable authored element over its wrapper.
+ */
+declare const inspectMarkdownNode: (source: string, file: string, origin: JsxSourceLocation, options?: {
+  readonly tag?: string | undefined;
+}) => SourceElement | null;
 /** Literal controls cannot overwrite a binding or computed expression. */
 declare const literalReplacement: (source: string, field: SourceProperty, value: string) => SourceReplacement | null;
 /** Explicit expression changes are proposals: callers show before/after and require Apply. */
@@ -63,6 +70,10 @@ interface ProfileGuard {
   readonly files?: Readonly<Record<string, string>> | undefined;
 }
 interface ApplyOptions {
+  /** Validate edits as an issue, including its closed grammar and frontmatter. */
+  readonly markdown?: {
+    readonly file: string;
+  } | undefined;
   readonly profile?: ProfileGuard | undefined;
 }
 /** Apply exact, nonoverlapping edits and refuse syntax damage without changing the original. */
@@ -230,4 +241,4 @@ declare const readWhatsAppChannel: (source: string) => WhatsAppChannelForm | und
 /** The source replacements that apply one form change to the WhatsApp body. */
 declare const editWhatsAppChannel: (source: string, edit: WhatsAppEdit) => ChannelEditResult;
 //#endregion
-export { ApplyOptions, AttributeState, ChannelEditResult, ChannelSegment, ClassNameOperation, type EmailElementSelection, type EmailPreview, type EmittedPosition, INSTANCE_PATH_ATTRIBUTE, JSX_SOURCE_LOCATION_PROP, JsxSource, JsxSourceLocation, LockedSegment, ProfileGuard, type SmsCategory, SmsChannelForm, SmsEdit, SourceEditResult, SourceElement, SourceFixture, SourceProperty, SourceProposal, SourceRange, SourceReplacement, TextSegment, WhatsAppButtonKind, WhatsAppButtonRow, type WhatsAppCategory, WhatsAppChannelForm, WhatsAppEdit, type WhatsAppHeaderType, WhatsAppPart, applySourceReplacements, classNameEdit, completeJsxSourceLocation, editSmsChannel, editWhatsAppChannel, emailAuthoringTarget, emailDefinitionInstances, emailSelectionAncestry, emailSelectionIndex, emailSelectionSiblings, emailSelections, expressionReplacement, inspectSourceElement, inspectSourceFixtures, literalReplacement, previewEmail, readSmsChannel, readWhatsAppChannel, structuralReplacements };
+export { ApplyOptions, AttributeState, ChannelEditResult, ChannelSegment, ClassNameOperation, type EmailElementSelection, type EmailPreview, type EmittedPosition, INSTANCE_PATH_ATTRIBUTE, JSX_SOURCE_LOCATION_PROP, JsxSource, JsxSourceLocation, LockedSegment, ProfileGuard, type SmsCategory, SmsChannelForm, SmsEdit, SourceEditResult, SourceElement, SourceFixture, SourceProperty, SourceProposal, SourceRange, SourceReplacement, TextSegment, WhatsAppButtonKind, WhatsAppButtonRow, type WhatsAppCategory, WhatsAppChannelForm, WhatsAppEdit, type WhatsAppHeaderType, WhatsAppPart, applySourceReplacements, classNameEdit, completeJsxSourceLocation, editSmsChannel, editWhatsAppChannel, emailAuthoringTarget, emailDefinitionInstances, emailSelectionAncestry, emailSelectionIndex, emailSelectionSiblings, emailSelections, expressionReplacement, inspectMarkdownNode, inspectSourceElement, inspectSourceFixtures, literalReplacement, previewEmail, readSmsChannel, readWhatsAppChannel, structuralReplacements };

package/dist/edit.js

@@ -1,8 +1,10 @@
 import { n as isObject } from "./guards-eV1qLbf2.js";
-import { c as INSTANCE_PATH_ATTRIBUTE, d as emailSelectionAncestry, f as emailSelectionIndex, h as previewEmail, l as emailAuthoringTarget, m as emailSelections, p as emailSelectionSiblings, u as emailDefinitionInstances } from "./html-DJUK2YJF.js";
+import { C as emailSelectionAncestry, D as previewEmail, E as emailSelections, S as emailDefinitionInstances, T as emailSelectionSiblings, b as INSTANCE_PATH_ATTRIBUTE, w as emailSelectionIndex, x as emailAuthoringTarget } from "./components-DNBCz20_.js";
 import { d as completeJsxSourceLocation, u as JSX_SOURCE_LOCATION_PROP } from "./jsx-runtime-qL19u3Fy.js";
-import { i as buildLineMap } from "./diagnostic-codes-DZKb0Xcg.js";
-import { c as SMS_CATEGORIES, l as WHATSAPP_CATEGORIES, n as introducedErrors, t as checkTemplate, u as WHATSAPP_HEADER_TYPES } from "./profile-JTvgCD6X.js";
+import { t as buildLineMap } from "./diagnostic-model-DJtqbETd.js";
+import { c as WHATSAPP_HEADER_TYPES, o as SMS_CATEGORIES, s as WHATSAPP_CATEGORIES } from "./project-B6D64SZS.js";
+import { n as introducedErrors, t as checkTemplate } from "./profile-DFk4gs7o.js";
+import { t as parseIssue } from "./parse-Bex7QFqj.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";
@@ -118,12 +120,63 @@ const inspectSourceElement = (source, file, origin) => {
 	});
 	return found;
 };
+/**
+* Resolve a Markdown render origin to authored prose or component attributes. A tag distinguishes
+* nodes sharing an origin; without one, prefer an editable authored element over its wrapper.
+*/
+const inspectMarkdownNode = (source, file, origin, options = {}) => {
+	if (file !== origin.fileName) return null;
+	const issue = parseIssue(source, file);
+	if (issue.diagnostics.some((item) => item.severity === "error")) return null;
+	const candidates = issue.sourceNodes.filter((item) => item.src[0] === origin.lineNumber && item.src[1] === origin.columnNumber && item.kind !== "text");
+	const found = options.tag === void 0 ? candidates.find((item) => item.properties.length > 0) ?? candidates[0] : candidates.find((item) => item.tag === options.tag);
+	if (found === void 0) return null;
+	return {
+		start: found.start,
+		end: found.end,
+		contentStart: found.contentStart,
+		contentEnd: found.contentEnd,
+		tag: found.tag,
+		attributeInsertion: found.contentStart ?? found.end,
+		hasSpread: false,
+		structural: false,
+		previous: null,
+		next: null,
+		properties: found.properties.map((field) => ({
+			...field,
+			value: String(field.value),
+			kind: "literal",
+			syntax: field.syntax === "quoted" ? "markdown-attribute" : field.syntax === "boolean" ? "markdown-boolean" : "markdown"
+		}))
+	};
+};
 const PLAIN_JSX_TEXT = /^[^\s{}<>&](?:[^{}<>&\r\n\u2028\u2029]*[^\s{}<>&])?$/;
+/** Keep prose readable while protecting inline syntax and the surrounding block's delimiters. */
+const escapeMarkdownProse = (source, field, value) => {
+	let escaped = value.replace(/[\\`*_[\]<{]/g, "\\$&").replace(/&(?=(?:[a-z][a-z\d]{1,31}|#\d{1,7}|#x[\da-f]{1,6});)/gi, "\\&").replace(/[\r\n\t]|^ +| +$/g, (whitespace) => [...whitespace].map((character) => `&#${character.charCodeAt(0)};`).join(""));
+	const block = parseIssue(source, "source.md").sourceNodes.find((authored) => authored.kind === "block" && authored.properties.some((candidate) => candidate.name === "children" && candidate.start === field.start && candidate.end === field.end));
+	const prefix = block === void 0 ? void 0 : source.slice(block.start, field.start);
+	if (prefix !== void 0 && /^ {0,3}$/.test(prefix)) escaped = escaped.replace(/^(?:#{1,6}(?=[ \t]|$)|>|[-+](?=[ \t]|$)|(?:-+|=+)(?=[ \t]*$)|~{3,})/, "\\$&").replace(/^(\d{1,9})([.)])(?=[ \t]|$)/, "$1\\$2");
+	const lineEnd = source.slice(field.end).search(/[\r\n]/);
+	const suffix = source.slice(field.end, lineEnd < 0 ? source.length : field.end + lineEnd);
+	if (prefix !== void 0 && /^ {0,3}#{1,6}[ \t]+$/.test(prefix) && /^[ \t]*$/.test(suffix)) escaped = escaped.replace(/(^|[ \t])(#+)$/, "$1\\$2");
+	return escaped;
+};
 /** Literal controls cannot overwrite a binding or computed expression. */
 const literalReplacement = (source, field, value) => {
 	if (field.kind !== "literal") return null;
 	if (field.literalType === "number" && (value.trim() === "" || !Number.isFinite(Number(value)))) return null;
 	if (field.literalType === "boolean" && value !== "true" && value !== "false") return null;
+	if (field.syntax === "markdown" || field.syntax === "markdown-attribute" || field.syntax === "markdown-boolean") {
+		const encoded = value.replaceAll("&", "&amp;").replaceAll("\"", "&quot;").replaceAll("<", "&lt;").replaceAll("{", "&#123;").replaceAll("}", "&#125;").replace(/[\r\n\t]/g, (character) => `&#${character.charCodeAt(0)};`);
+		const markdown = field.name === "children" ? escapeMarkdownProse(source, field, value) : value.replace(/[!-/:-@[-`{-~]/g, "\\$&").replace(field.name === "href" || field.name === "src" ? /\s/g : /[\r\n\t]|^ +| +$/g, (whitespace) => [...whitespace].map((character) => `&#${character.charCodeAt(0)};`).join(""));
+		return {
+			start: field.start,
+			end: field.end,
+			before: source.slice(field.start, field.end),
+			after: field.syntax === "markdown" ? markdown : field.syntax === "markdown-boolean" ? `${field.name}="${encoded}"` : `"${encoded}"`
+		};
+	}
 	const literal = field.literalType === "string" ? JSON.stringify(value) : field.literalType === "number" ? String(Number(value)) : value;
 	const before = source.slice(field.start, field.end);
 	const plainText = field.syntax === "child" && !before.startsWith("{") && PLAIN_JSX_TEXT.test(value);
@@ -166,6 +219,16 @@ const applySourceReplacements = (source, edits, options = {}) => {
 		result = result.slice(0, edit.start) + edit.after + result.slice(edit.end);
 		boundary = edit.start;
 	}
+	if (options.markdown !== void 0) {
+		const finding = parseIssue(result, options.markdown.file).diagnostics.find((item) => item.severity === "error");
+		return finding === void 0 ? {
+			ok: true,
+			source: result
+		} : {
+			ok: false,
+			reason: `This change is not valid SML Markdown: ${finding.message}`
+		};
+	}
 	if (parsed(result) === null) return {
 		ok: false,
 		reason: "This change is not valid TSX. Review it in Source."
@@ -940,4 +1003,4 @@ const editWhatsAppChannel = (source, edit) => {
 	}
 };
 //#endregion
-export { INSTANCE_PATH_ATTRIBUTE, JSX_SOURCE_LOCATION_PROP, applySourceReplacements, classNameEdit, completeJsxSourceLocation, editSmsChannel, editWhatsAppChannel, emailAuthoringTarget, emailDefinitionInstances, emailSelectionAncestry, emailSelectionIndex, emailSelectionSiblings, emailSelections, expressionReplacement, inspectSourceElement, inspectSourceFixtures, literalReplacement, previewEmail, readSmsChannel, readWhatsAppChannel, structuralReplacements };
+export { INSTANCE_PATH_ATTRIBUTE, JSX_SOURCE_LOCATION_PROP, applySourceReplacements, classNameEdit, completeJsxSourceLocation, editSmsChannel, editWhatsAppChannel, emailAuthoringTarget, emailDefinitionInstances, emailSelectionAncestry, emailSelectionIndex, emailSelectionSiblings, emailSelections, expressionReplacement, inspectMarkdownNode, inspectSourceElement, inspectSourceFixtures, literalReplacement, previewEmail, readSmsChannel, readWhatsAppChannel, structuralReplacements };

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

@@ -1,5 +1,5 @@
-import { n as JsxSource } from "../source-locations-C8wCsiAy.js";
-import { a as Fragment, i as EmailNode, n as EmailComponent, o as JSX } from "../jsx-runtime-DL8NVF1f.js";
+import { c as JsxSource } from "../diagnostics-C3TSx6SU.js";
+import { a as Fragment, i as EmailNode, n as EmailComponent, o as JSX } from "../jsx-runtime-HHfrVZEf.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 Fragment, c as currentEmailOrigins, d as normalizeChildren, f as rawMarkup, i as EmailNode, l as jsx, n as EmailComponent, o as JSX, p as withEmailDiagnostics, r as EmailFinding, s as collectEmailDiagnostics, t as EmailChild, u as jsxs } from "../jsx-runtime-DL8NVF1f.js";
+import { a as Fragment, c as currentEmailOrigins, d as normalizeChildren, f as rawMarkup, i as EmailNode, l as jsx, n as EmailComponent, o as JSX, p as withEmailDiagnostics, r as EmailFinding, s as collectEmailDiagnostics, t as EmailChild, u as jsxs } from "../jsx-runtime-HHfrVZEf.js";
 export { EmailChild, EmailComponent, EmailFinding, EmailNode, Fragment, JSX, collectEmailDiagnostics, currentEmailOrigins, jsx, jsxs, normalizeChildren, rawMarkup, withEmailDiagnostics };

package/dist/email.d.ts

@@ -1,4 +1,4 @@
-import { i as EmailNode, t as EmailChild, x as EmailStyle } from "./jsx-runtime-DL8NVF1f.js";
+import { i as EmailNode, t as EmailChild, x as EmailStyle } from "./jsx-runtime-HHfrVZEf.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";
@@ -175,4 +175,8 @@ interface LinkProps {
  */
 declare const Link: ({ className, href, target, rel, style, children }: LinkProps) => EmailNode;
 //#endregion
-export { Button, ButtonProps, Column, ColumnProps, Columns, ColumnsProps, Divider, DividerProps, Email, EmailProps, Image, ImageProps, Link, LinkProps, PREHEADER_ATTRIBUTE, Section, SectionProps, Spacer, SpacerProps, equalColumnWidth, preheaderNode };
+//#region src/issue-content.d.ts
+/** Static layout directive replaced by parsed issue content during compilation. Takes no props. */
+declare const IssueContent: () => EmailNode | null;
+//#endregion
+export { Button, ButtonProps, Column, ColumnProps, Columns, ColumnsProps, Divider, DividerProps, Email, EmailProps, Image, ImageProps, IssueContent, Link, LinkProps, PREHEADER_ATTRIBUTE, Section, SectionProps, Spacer, SpacerProps, equalColumnWidth, preheaderNode };

package/dist/email.js

@@ -1,2 +1,6 @@
-import { a as Email, c as PREHEADER_ATTRIBUTE, d as equalColumnWidth, f as preheaderNode, 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-C5850-Qg.js";
-export { Button, Column, Columns, Divider, Email, Image, Link, PREHEADER_ATTRIBUTE, Section, Spacer, equalColumnWidth, preheaderNode };
+import { a as Email, c as PREHEADER_ATTRIBUTE, d as equalColumnWidth, f as preheaderNode, 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-DNBCz20_.js";
+//#region src/issue-content.ts
+/** Static layout directive replaced by parsed issue content during compilation. Takes no props. */
+const IssueContent = () => null;
+//#endregion
+export { Button, Column, Columns, Divider, Email, Image, IssueContent, Link, PREHEADER_ATTRIBUTE, Section, Spacer, equalColumnWidth, preheaderNode };

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-import { a as TemplateInput, n as SmlTemplate, o as defineTemplate, r as TEMPLATE_ID_PATTERN, t as EmailChannel } from "./template-DmNcoH4Q.js";
+import { a as TemplateInput, n as SmlTemplate, o as defineTemplate, r as TEMPLATE_ID_PATTERN, t as EmailChannel } from "./template-4Dse7_OC.js";
 export { type EmailChannel, type SmlTemplate, TEMPLATE_ID_PATTERN, type TemplateInput, defineTemplate };

package/dist/{jsx-runtime-DL8NVF1f.d.ts → jsx-runtime-HHfrVZEf.d.ts}

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

package/dist/markdown.d.ts

@@ -0,0 +1,69 @@
+import { n as EmailDiagnostic } from "./diagnostics-C3TSx6SU.js";
+import { g as CompiledSource, u as CompiledNode } from "./compiled-template-CPDHvFlt.js";
+import { r as CompileResult, t as CompileTemplateOptions } from "./compile-CIeuGmP-.js";
+//#region src/markdown/types.d.ts
+interface IssueFrontmatter {
+  readonly title: string;
+  readonly slug: string;
+  readonly topic: string;
+  readonly preheader?: string;
+  readonly seo?: {
+    readonly title?: string;
+    readonly description?: string;
+    readonly image?: string;
+  };
+  /** Number of leading top-level blocks visible before the subscription gate. */
+  readonly gate?: {
+    readonly leadIn: number;
+  };
+}
+/** Value offsets are UTF-16, end-exclusive; quoted spans include both literal quotes. */
+interface MarkdownSourceProperty {
+  readonly name: string;
+  readonly value: string | number | boolean;
+  readonly literalType: "string" | "number" | "boolean";
+  readonly start: number;
+  readonly end: number;
+  readonly syntax: "quoted" | "boolean" | "markdown";
+}
+/** Authored ranges, before decoding entities or removing Markdown delimiters. */
+interface MarkdownSourceNode {
+  readonly kind: "component" | "block" | "inline" | "text";
+  readonly start: number;
+  readonly end: number;
+  readonly contentStart: number;
+  readonly contentEnd: number;
+  readonly tag: string;
+  readonly src: CompiledSource;
+  readonly properties: readonly MarkdownSourceProperty[];
+}
+interface ParseIssueResult {
+  /** Empty whenever any diagnostic is an error. Brand components await host resolution. */
+  readonly nodes: readonly CompiledNode[];
+  readonly frontmatter: IssueFrontmatter | undefined;
+  readonly diagnostics: readonly EmailDiagnostic[];
+  readonly sources: readonly string[];
+  readonly sourceNodes: readonly MarkdownSourceNode[];
+}
+//#endregion
+//#region src/markdown/parse.d.ts
+/** Parse a static issue without importing, evaluating or passing through authored HTML. */
+declare const parseIssue: (source: string, file: string) => ParseIssueResult;
+//#endregion
+//#region src/issue.d.ts
+/** An issue's Markdown path and the ordinary TSX template used as its layout. */
+interface CompileIssueOptions extends Omit<CompileTemplateOptions, "entry" | "issueContent"> {
+  readonly entry: string;
+  readonly layout?: string | undefined;
+}
+interface IssueCompileResult extends CompileResult {
+  readonly frontmatter: IssueFrontmatter | undefined;
+}
+/**
+ * Compile an issue inside layout.tsx (or the selected layout), without evaluating either file.
+ * The slug identifies the issue, title is its email subject, and preheader is its inbox preview.
+ * The layout supplies the input schema, fixtures, brand, theme and one IssueContent slot.
+ */
+declare const compileIssue: (options: CompileIssueOptions) => Promise<IssueCompileResult>;
+//#endregion
+export { CompileIssueOptions, IssueCompileResult, type IssueFrontmatter, type MarkdownSourceNode, type MarkdownSourceProperty, type ParseIssueResult, compileIssue, parseIssue };

package/dist/markdown.js

@@ -0,0 +1,95 @@
+import { t as compileTemplate } from "./compile-C1GWLQ5C.js";
+import { t as parseIssue } from "./parse-Bex7QFqj.js";
+//#region src/issue.ts
+/**
+* Compile an issue inside layout.tsx (or the selected layout), without evaluating either file.
+* The slug identifies the issue, title is its email subject, and preheader is its inbox preview.
+* The layout supplies the input schema, fixtures, brand, theme and one IssueContent slot.
+*/
+const compileIssue = async (options) => {
+	const source = options.files[options.entry];
+	if (typeof source !== "string") return {
+		template: void 0,
+		frontmatter: void 0,
+		fixtures: {},
+		assets: [],
+		diagnostics: [{
+			code: "markdown-syntax",
+			severity: "error",
+			message: `Issue ${options.entry} is missing or is not text.`,
+			origins: [{
+				fileName: options.entry,
+				lineNumber: 1,
+				columnNumber: 1
+			}]
+		}]
+	};
+	const issue = parseIssue(source, options.entry);
+	if (issue.frontmatter === void 0 || issue.diagnostics.some((item) => item.severity === "error")) return {
+		template: void 0,
+		frontmatter: issue.frontmatter,
+		fixtures: {},
+		assets: [],
+		diagnostics: issue.diagnostics
+	};
+	const layout = options.layout ?? "layout.tsx";
+	if (typeof options.files[layout] !== "string") return {
+		template: void 0,
+		frontmatter: issue.frontmatter,
+		fixtures: {},
+		assets: [],
+		diagnostics: [{
+			code: "issue-layout",
+			severity: "error",
+			message: `Issue layout ${layout} is missing or is not text.`,
+			origins: [{
+				fileName: layout,
+				lineNumber: 1,
+				columnNumber: 1
+			}]
+		}]
+	};
+	const compiled = await compileTemplate({
+		...options,
+		entry: layout,
+		issueContent: {
+			file: options.entry,
+			nodes: issue.nodes
+		}
+	});
+	const diagnostics = [...issue.diagnostics, ...compiled.diagnostics];
+	const template = compiled.template;
+	if (template?.email === void 0 || template.sms !== void 0 || template.whatsapp !== void 0) return {
+		...compiled,
+		template: void 0,
+		frontmatter: issue.frontmatter,
+		diagnostics: template === void 0 ? diagnostics : [...diagnostics, {
+			code: "issue-layout",
+			severity: "error",
+			message: "An issue layout must declare only an email channel.",
+			origins: [{
+				fileName: layout,
+				lineNumber: 1,
+				columnNumber: 1
+			}]
+		}]
+	};
+	const { preheader: _preheader, ...email } = template.email;
+	const result = {
+		...template,
+		template: issue.frontmatter.slug,
+		email: {
+			...email,
+			subject: issue.frontmatter.title,
+			...issue.frontmatter.preheader === void 0 ? {} : { preheader: issue.frontmatter.preheader }
+		}
+	};
+	return {
+		...compiled,
+		template: result,
+		frontmatter: issue.frontmatter,
+		diagnostics
+	};
+};
+//#endregion
+export { compileIssue, parseIssue };