@samva/markup 0.5.0 → 0.7.0

package/AGENTS.md

@@ -1,45 +1,80 @@
-# Samva Markup consumer guide
-
-This package is plain TypeScript. It depends on no application runtime, so a template project
-installs the compiler and nothing that comes with one. The structured SML surface — `parseSml`,
-`compileSml`, `compileSource` — returns a better-result `Result` you branch on with `Result.isOk`
-/ `Result.isErr`, carrying a `TaggedError` such as `SmlParseError` or `SmlCompileError` that you
-discriminate by `_tag`. Email compilation reports through `EmailDiagnostic` values instead. A
-declaration the compiler cannot accept at all throws a `TypeError`: a template id or fixture key
-that is not one plain path segment, a nonportable input schema, a project holding a reserved
-compiler path.
-
-Markup's own data models are types and interfaces, not schema declarations, so there is no schema
-library to adopt to consume them. Their unions discriminate on `type`: an `EmailNode` is `Text`,
-`Element`, `Fragment` or `Raw`, and an `SmlOp` names its edit the same way.
-Only the better-result error classes carry `_tag`. A template's JSON input contract is the one
-exception to the no-schema rule, because it has to be checked against real input: `inputSchema`
-accepts any Standard Schema through the `@standard-schema/spec` types and returns a portable JSON
-Schema with its validator, so which schema library an author reaches for stays theirs.
-
-Email entries default-export `defineEmail` definitions. SMS and WhatsApp use the structured
-channel runtime at `@samva/markup` and components at `@samva/markup/components`.
-Use documented package subpaths only. Template entry discovery is `.tsx` only.
-
-Object email templates use `jsxImportSource: "@samva/markup/email"` and
-`defineEmail` from `@samva/markup/template`. Their render function receives actual validated
-JSON input and returns subject, optional preheader, body, and optional text. A template id and a
-fixture key are both written into file paths, so each must match `TEMPLATE_NAME_PATTERN` — one
-plain path segment — and `defineEmail` refuses anything else where the name is declared. A consumer
-that resolves a path from those names imports that pattern; it never restates it. The derived
-semantic tree lowers directly to HTML/text via `@samva/markup/email/render`; do not route object
-templates through recording proxies or textual SML. Authoring-source provenance belongs to semantic
-nodes.
-
-Ordinary HTML is typed. `@samva/markup/email/elements` is the one table behind both the JSX
-intrinsic prop types and the serializer's allowlist, so an unsupported element or attribute fails at
-typecheck and again at compile with a source location. Email primitives — `Email`, `Section`,
-`Columns`/`Column`, `Button`, `Spacer`, `Divider`, `Image`, `Link` — come from
-`@samva/markup/email/components`; they generate table markup and classic-Outlook fallbacks, and
-every wrapper they generate carries the authoring call site as its origin. Findings are
-`EmailDiagnostic` values from `@samva/markup/email/diagnostics`: errors throw `EmailCompileError`,
-warnings ride back on the render result. Nothing an author passes as a string becomes markup.
-
-`@samva/markup/compiler` is the bundler-agnostic compiler boundary. `@samva/vite` and
-`apps/agents/src/editor` are adapters over it — they own resolution, watching and transport, never
-compilation semantics — and the module imports no Vite, esbuild or Node builtins.
+# @samva/markup agent guide
+
+`@samva/markup` is the authoring language and compiler for Samva templates. Email templates are
+TSX modules that default-export a `defineEmail` definition and render through a JSX runtime that
+lowers to email-safe HTML and plain text. SMS and WhatsApp templates use the structured SML runtime.
+The package is plain TypeScript with no application runtime; the local editor, project builds, and
+exports live in `@samva/vite`.
+
+## Entry points
+
+- `@samva/markup/template` — `defineEmail`, `TemplateDefinition`, `TemplateInput`, and
+  `TEMPLATE_NAME_PATTERN`.
+- `@samva/markup/email` — the JSX runtime. Set `jsxImportSource: "@samva/markup/email"` for email
+  entries.
+- `@samva/markup/email/components` — email primitives (`Email`, `Section`, `Columns`, `Button`,
+  and the rest of its exports). They generate table layout and classic-Outlook fallbacks.
+- `@samva/markup/email/render` — `renderEmail(template, data)`, which validates input and returns
+  subject, preheader, HTML, text, and the derived tree.
+- `@samva/markup/email/diagnostics` — `EmailDiagnostic` and `EmailCompileError`.
+- `@samva/markup/input-schema` — `inputSchema`, which turns any Standard JSON Schema into the
+  portable JSON Schema and validator a template's input is checked against.
+- `@samva/markup/compiler` — `compileEmailProject`, the bundler-agnostic compile step. It imports no
+  Vite, esbuild, or Node builtins, so it runs in any JavaScript host.
+- `jsxImportSource: "@samva/markup"` and `@samva/markup/components` — the structured SMS and
+  WhatsApp runtime and components. `parseSml` (`@samva/markup/parser`) and `compileSml` /
+  `compileSource` (`@samva/markup/compile`) work on SML source.
+
+The package's `generated/` directory ships the SML and email language references and agent
+contracts; read those before authoring. Import only subpaths declared in `package.json` `exports`.
+
+## How you hurt yourself here
+
+- **Passing a string where you want markup.** Nothing an author passes as a string becomes markup;
+  strings render as escaped text. There is no raw-HTML escape hatch: compatibility markup comes only
+  from the email primitives.
+- **Using an element or attribute the serializer does not allow.** `@samva/markup/email/elements` is
+  the one table behind both the JSX intrinsic prop types and the serializer's allowlist, so an
+  unsupported element or attribute fails at typecheck and again at compile with a source location.
+- **Naming a template or fixture like a path.** A template id and a fixture key are both written
+  into file paths, so each must match `TEMPLATE_NAME_PATTERN`, one plain path segment.
+  `defineEmail` throws a `TypeError` where the name is declared. Code that builds a path from these
+  names imports the pattern instead of restating it.
+- **Reading the clock or randomness in a template.** Samva's hosted render has no ambient clock and
+  no entropy source: reading the current instant or a random value there throws unless the
+  definition declares the fixed value in its `runtime` (`TemplateRuntime`). A local render does not
+  enforce this, so a template that reads `Date.now()` can pass locally and fail once published. Take
+  times from validated input, or declare them.
+- **Treating `renderEmail` as a sandbox.** It executes the template's TypeScript in the calling
+  process. Run untrusted template source in an isolated host.
+- **Expecting the schema library to do the validation.** A template's input schema is converted to
+  a portable JSON Schema and validated by that document, not by the library that produced it. A
+  refinement that the converter cannot export is refused, and defaults are never inserted or values
+  coerced. The README lists the supported keywords.
+
+## Rules
+
+- **Email entries default-export a `defineEmail` definition** from a `.tsx` file. The definition
+  owns a stable, project-unique `id`, an input schema, named fixtures, and a synchronous `render`
+  that receives the validated JSON input unchanged. Helper modules are ordinary imports, not
+  catalog entries.
+- **Email templates have no textual SML form.** The derived semantic tree lowers directly to HTML
+  and text through `@samva/markup/email/render`; SML is the SMS and WhatsApp language.
+- **Structured SML is a closed grammar.** `parseSml` and `compileSml` reject anything outside it
+  rather than passing it through.
+- **Failures are typed.** The SML surface returns a better-result `Result`; branch with
+  `Result.isOk` / `Result.isErr` and discriminate the `TaggedError` (`SmlParseError`,
+  `SmlCompileError`) by `_tag`. Email compilation reports `EmailDiagnostic` values: errors throw
+  `EmailCompileError`, warnings ride back on the render result. A declaration the compiler cannot
+  accept at all, such as an invalid name or a nonportable input schema, throws a `TypeError`.
+- **Data models are plain types.** Markup's data models are TypeScript types, not schema
+  declarations, so there is no schema library to adopt to consume them. Unions discriminate on
+  `type` (an `EmailNode`, an `SmlOp`); only error classes carry `_tag`. The input schema is the one
+  place a Standard Schema is accepted, and which library produces it is yours to choose.
+
+## Proving your setup
+
+- `tsc --noEmit` over the template project catches unsupported elements, attributes, and props.
+- `samva templates check` (from `@samva/cli`) compiles every entry and renders every fixture,
+  reporting findings with source locations.
+- `renderEmail(template, fixture)` in a unit test proves one template's output without a build.

package/README.md

@@ -101,7 +101,7 @@ a value at import. `new Date(value)` with an explicit argument always works, so
 takes its time from validated input or states it once as configuration. Locale (`en-US`) and time
 zone (UTC) are publication-wide and back every `Intl` constructor and `toLocale*` call.
 
-Portable validation uses `@cfworker/json-schema` 4.1.1 without runtime code generation. The
+Portable validation uses `@cfworker/json-schema` without runtime code generation. The
 2020-12 meta-schema is checked at every supported schema position, and the explicit profile rejects
 keywords outside its contract before interpretation. The AJV dependency supplies static meta-schema
 JSON; its code generator is not invoked in a loaded template.

package/dist/{ast-BLybiDxp.d.ts → ast-BrDtApwS.d.ts}

@@ -1,4 +1,4 @@
-import { a as Span } from "./diagnostics-CqepLcpI.js";
+import { a as Span } from "./diagnostics-OcQKQYSY.js";
 //#region src/ast.d.ts
 declare const BLOCK_TAGS: readonly ["Email", "Subject", "Preview", "Container", "Section", "Row", "Column", "Heading", "Text", "Button", "Image", "Divider", "Spacer", "List", "ListItem", "If", "Else"];
 declare const INLINE_TAGS: readonly ["strong", "em", "a"];
@@ -104,4 +104,4 @@ declare const isHiddenNode: (node: ElementNode) => boolean;
 declare const collectVariableReferences: (document: SmlDocument) => ReadonlySet<string>;
 //#endregion
 export { nodeLabel as A, TextNode as C, documentChannel as D, componentNameForSmlTag as E, smlTagForComponentName as M, stringAttribute as N, isHiddenNode as O, SmlTag as S, collectVariableReferences as T, RootTag as _, BLOCK_TAGS as a, SmlDocument as b, CHANNEL_TAGS as c, DEFAULT_EMAIL_WIDTH as d, ElementNode as f, ROOT_TAGS as g, InterpolationNode as h, AuxiliaryTag as i, numberAttribute as j, isRootTag as k, Channel as l, InlineTag as m, Attribute as n, BlockTag as o, INLINE_TAGS as p, AttributeValue as r, CHANNEL_BY_ROOT_TAG as s, AUXILIARY_TAGS as t, ChannelTag as u, SML_TAGS as v, attributeValue as w, SmlNode as x, SML_TAG_BY_COMPONENT_NAME as y };
-//# sourceMappingURL=ast-BLybiDxp.d.ts.map
+//# sourceMappingURL=ast-BrDtApwS.d.ts.map

package/dist/ast.d.ts

@@ -1,2 +1,2 @@
-import { A as nodeLabel, C as TextNode, D as documentChannel, E as componentNameForSmlTag, M as smlTagForComponentName, N as stringAttribute, O as isHiddenNode, S as SmlTag, T as collectVariableReferences, _ as RootTag, a as BLOCK_TAGS, b as SmlDocument, c as CHANNEL_TAGS, d as DEFAULT_EMAIL_WIDTH, f as ElementNode, g as ROOT_TAGS, h as InterpolationNode, i as AuxiliaryTag, j as numberAttribute, k as isRootTag, l as Channel, m as InlineTag, n as Attribute, o as BlockTag, p as INLINE_TAGS, r as AttributeValue, s as CHANNEL_BY_ROOT_TAG, t as AUXILIARY_TAGS, u as ChannelTag, v as SML_TAGS, w as attributeValue, x as SmlNode, y as SML_TAG_BY_COMPONENT_NAME } from "./ast-BLybiDxp.js";
+import { A as nodeLabel, C as TextNode, D as documentChannel, E as componentNameForSmlTag, M as smlTagForComponentName, N as stringAttribute, O as isHiddenNode, S as SmlTag, T as collectVariableReferences, _ as RootTag, a as BLOCK_TAGS, b as SmlDocument, c as CHANNEL_TAGS, d as DEFAULT_EMAIL_WIDTH, f as ElementNode, g as ROOT_TAGS, h as InterpolationNode, i as AuxiliaryTag, j as numberAttribute, k as isRootTag, l as Channel, m as InlineTag, n as Attribute, o as BlockTag, p as INLINE_TAGS, r as AttributeValue, s as CHANNEL_BY_ROOT_TAG, t as AUXILIARY_TAGS, u as ChannelTag, v as SML_TAGS, w as attributeValue, x as SmlNode, y as SML_TAG_BY_COMPONENT_NAME } from "./ast-BrDtApwS.js";
 export { AUXILIARY_TAGS, Attribute, AttributeValue, AuxiliaryTag, BLOCK_TAGS, BlockTag, CHANNEL_BY_ROOT_TAG, CHANNEL_TAGS, Channel, ChannelTag, DEFAULT_EMAIL_WIDTH, ElementNode, INLINE_TAGS, InlineTag, InterpolationNode, ROOT_TAGS, RootTag, SML_TAGS, SML_TAG_BY_COMPONENT_NAME, SmlDocument, SmlNode, SmlTag, TextNode, attributeValue, collectVariableReferences, componentNameForSmlTag, documentChannel, isHiddenNode, isRootTag, nodeLabel, numberAttribute, smlTagForComponentName, stringAttribute };

package/dist/ast.js

@@ -1,4 +1,4 @@
-import { i as parsePredicate, n as collectPredicateVariables } from "./predicate-DwXzmqIY.js";
+import { i as parsePredicate, n as collectPredicateVariables } from "./predicate-BI6uRRM-.js";
 import { Result } from "better-result";
 //#region src/ast.ts
 const BLOCK_TAGS = [

package/dist/{catalog-Db0UcCTg.d.ts → catalog-60eaYC7b.d.ts}

@@ -1,4 +1,4 @@
-import { l as Channel } from "./ast-BLybiDxp.js";
+import { l as Channel } from "./ast-BrDtApwS.js";
 import { o as TokenOverrides } from "./theme-6ApjjiBo.js";
 //#region presets/catalog.d.ts
 type PresetCategory = "transactional" | "digest" | "marketing" | "lifecycle";
@@ -353,4 +353,4 @@ type EmailPresetVariable = EmailPreset extends (infer Preset) ? Preset extends {
 } ? Variable : never : never;
 //#endregion
 export { PresetMeta as a, presetCatalog as c, PresetId as i, EmailPresetVariable as n, PresetVariable as o, PresetCategory as r, RECOMMENDED_THEME as s, EmailPresetId as t };
-//# sourceMappingURL=catalog-Db0UcCTg.d.ts.map
+//# sourceMappingURL=catalog-60eaYC7b.d.ts.map

package/dist/{checks-CmmITP6j.js → checks-DBweSIPN.js}

@@ -1,5 +1,5 @@
-import { formatDiagnostic } from "./diagnostics.js";
-import { i as parsePredicate } from "./predicate-DwXzmqIY.js";
+import { createDiagnosticFormatter } from "./diagnostics.js";
+import { i as parsePredicate } from "./predicate-BI6uRRM-.js";
 import { stringAttribute } from "./ast.js";
 import { parseCandidate, splitRoot } from "./candidate.js";
 import { registryRoots, utilityRegistry } from "./registry.js";
@@ -58830,7 +58830,7 @@ const predicateSource = (source, attribute) => {
 		})
 	};
 };
-const predicateDiagnosticMessages = (source, document, declaredVariables) => {
+const predicateDiagnosticMessages = (source, document, declaredVariables, formatDiagnostic) => {
 	const messages = [];
 	const declared = declaredVariables === void 0 ? void 0 : new Set(declaredVariables);
 	const visit = (node) => {
@@ -58840,9 +58840,9 @@ const predicateDiagnosticMessages = (source, document, declaredVariables) => {
 			if (testAttribute?.value.kind === "string") {
 				const predicate = predicateSource(source, testAttribute);
 				const parsed = parsePredicate(predicate.text);
-				if (Result.isError(parsed)) for (const diagnostic of parsed.error) messages.push(`error: ${formatDiagnostic(source, predicate.mapDiagnostic(diagnostic))}`);
+				if (Result.isError(parsed)) for (const diagnostic of parsed.error) messages.push(`error: ${formatDiagnostic(predicate.mapDiagnostic(diagnostic))}`);
 				else if (declared !== void 0) {
-					for (const reference of collectPredicateVariableReferences(parsed.value)) if (!declared.has(reference.name)) messages.push(`error: ${formatDiagnostic(source, {
+					for (const reference of collectPredicateVariableReferences(parsed.value)) if (!declared.has(reference.name)) messages.push(`error: ${formatDiagnostic({
 						code: "predicate-unknown-variable",
 						message: `unknown predicate variable "${reference.name}" in <If test>`,
 						span: predicate.mapSpan(reference.span)
@@ -58855,11 +58855,7 @@ const predicateDiagnosticMessages = (source, document, declaredVariables) => {
 	visit(document.root);
 	return messages;
 };
-const parseFailurePredicateMessages = (source) => {
-	const parsed = parseSml(source);
-	if (Result.isOk(parsed)) return [];
-	return parsed.error.diagnostics.filter((diagnostic) => diagnostic.code.startsWith("predicate-")).map((diagnostic) => `error: ${formatDiagnostic(source, diagnostic)}`);
-};
+const parseFailurePredicateMessages = (diagnostics, formatDiagnostic) => diagnostics.filter((diagnostic) => diagnostic.code.startsWith("predicate-")).map((diagnostic) => `error: ${formatDiagnostic(diagnostic)}`);
 const clientsByDarkBehavior = (profile, behavior) => profile.targets.filter((target) => target.darkBehavior === behavior).map(targetLabel).filter((label, index, labels) => labels.indexOf(label) === index);
 const gmailForcedInvertClients = (profile) => profile.targets.filter((target) => target.family === "gmail" && target.darkBehavior === "force-inverts").map(targetLabel);
 const formatClientList = (clients) => clients.join(", ");
@@ -58941,11 +58937,13 @@ function worstCaseArtifactBytes(html) {
 function checkSmlCompatibility(input) {
 	const profile = input.profile ?? DEFAULT_EMAIL_TARGET_CLIENT_PROFILE;
 	const parsed = parseSml(input.source);
-	if (Result.isError(parsed)) return parseFailurePredicateMessages(input.source);
+	let formatter;
+	const formatDiagnostic = (diagnostic) => (formatter ??= createDiagnosticFormatter(input.source))(diagnostic);
+	if (Result.isError(parsed)) return parseFailurePredicateMessages(parsed.error.diagnostics, formatDiagnostic);
 	const analysis = analyzeDocument(parsed.value);
 	return [
-		...predicateDiagnosticMessages(input.source, parsed.value, input.declaredVariables),
-		...checkDeliveryAssetDiagnostics(input.source).map((diagnostic) => `error: ${formatDiagnostic(input.source, diagnostic)}`),
+		...predicateDiagnosticMessages(input.source, parsed.value, input.declaredVariables, formatDiagnostic),
+		...checkDeliveryAssetDiagnostics(input.source).map((diagnostic) => `error: ${formatDiagnostic(diagnostic)}`),
 		...caniemailMessages(analysis.featureSlugs, profile),
 		...darkModeMessages(analysis, profile)
 	];
@@ -58953,4 +58951,4 @@ function checkSmlCompatibility(input) {
 //#endregion
 export { isBreakingCompatibilityCheck as a, collectSmlFeatureSlugs as i, checkDeliveryAssetDiagnostics as n, worstCaseArtifactBytes as o, checkSmlCompatibility as r, DEFAULT_EMAIL_TARGET_CLIENT_PROFILE as t };
 
-//# sourceMappingURL=checks-CmmITP6j.js.map
+//# sourceMappingURL=checks-DBweSIPN.js.map

package/dist/checks.d.ts

@@ -1,4 +1,4 @@
-import { t as Diagnostic } from "./diagnostics-CqepLcpI.js";
+import { t as Diagnostic } from "./diagnostics-OcQKQYSY.js";
 //#region src/checks.d.ts
 type EmailClientDarkBehavior = "honors" | "force-inverts" | "no dark mode";
 interface EmailClientTarget {

package/dist/checks.js

@@ -1,2 +1,2 @@
-import { a as isBreakingCompatibilityCheck, i as collectSmlFeatureSlugs, n as checkDeliveryAssetDiagnostics, o as worstCaseArtifactBytes, r as checkSmlCompatibility, t as DEFAULT_EMAIL_TARGET_CLIENT_PROFILE } from "./checks-CmmITP6j.js";
+import { a as isBreakingCompatibilityCheck, i as collectSmlFeatureSlugs, n as checkDeliveryAssetDiagnostics, o as worstCaseArtifactBytes, r as checkSmlCompatibility, t as DEFAULT_EMAIL_TARGET_CLIENT_PROFILE } from "./checks-DBweSIPN.js";
 export { DEFAULT_EMAIL_TARGET_CLIENT_PROFILE, checkDeliveryAssetDiagnostics, checkSmlCompatibility, collectSmlFeatureSlugs, isBreakingCompatibilityCheck, worstCaseArtifactBytes };

package/dist/classes.d.ts

@@ -1,4 +1,4 @@
-import { a as Span, t as Diagnostic } from "./diagnostics-CqepLcpI.js";
+import { a as Span, t as Diagnostic } from "./diagnostics-OcQKQYSY.js";
 import { s as TokenTable } from "./theme-6ApjjiBo.js";
 import { Declaration } from "./registry.js";
 //#region src/classes.d.ts

package/dist/compile-sms.d.ts

@@ -1,6 +1,6 @@
-import { t as Diagnostic } from "./diagnostics-CqepLcpI.js";
-import { f as ElementNode } from "./ast-BLybiDxp.js";
-import { a as SMS_TAG_SPECS } from "./parser-b_Kp5MT6.js";
+import { t as Diagnostic } from "./diagnostics-OcQKQYSY.js";
+import { f as ElementNode } from "./ast-BrDtApwS.js";
+import { a as SMS_TAG_SPECS } from "./parser-t29cHLVL.js";
 import { t as SmsEncoding } from "./sms-segments-y4FpPilJ.js";
 //#region src/compile-sms.d.ts
 /** Documented worst-case rendered width of one `{{variable}}`. */

package/dist/compile-whatsapp.d.ts

@@ -1,6 +1,6 @@
-import { r as SmlCompileError, t as Diagnostic } from "./diagnostics-CqepLcpI.js";
-import { f as ElementNode } from "./ast-BLybiDxp.js";
-import { l as WHATSAPP_TAG_SPECS } from "./parser-b_Kp5MT6.js";
+import { r as SmlCompileError, t as Diagnostic } from "./diagnostics-OcQKQYSY.js";
+import { f as ElementNode } from "./ast-BrDtApwS.js";
+import { l as WHATSAPP_TAG_SPECS } from "./parser-t29cHLVL.js";
 import { Result } from "better-result";
 //#region src/compile-whatsapp.d.ts
 type WhatsAppSpecs = typeof WHATSAPP_TAG_SPECS;

package/dist/compile.d.ts

@@ -1,5 +1,5 @@
-import { i as SmlParseError, r as SmlCompileError } from "./diagnostics-CqepLcpI.js";
-import { b as SmlDocument } from "./ast-BLybiDxp.js";
+import { i as SmlParseError, r as SmlCompileError } from "./diagnostics-OcQKQYSY.js";
+import { b as SmlDocument } from "./ast-BrDtApwS.js";
 import { CompiledSms } from "./compile-sms.js";
 import { CompiledWhatsApp } from "./compile-whatsapp.js";
 import { Result } from "better-result";

package/dist/compiler.d.ts

@@ -1,9 +1,9 @@
-import { a as formatEmailDiagnostic, i as EmailDiagnosticSeverity, n as EmailCompileError, o as hasBlockingDiagnostic, r as EmailDiagnostic } from "./diagnostics-eFM9A_TU.js";
-import { a as EmailGlobalProps, c as EmailStyle, d as isUrlAttribute, i as EmailElementSpec, l as EmailTag, m as EmailNode, n as EMAIL_GLOBAL_ATTRIBUTES, o as EmailIntrinsicElements, r as EmailAttributeSpec, s as EmailLayout, t as EMAIL_ELEMENTS, u as emailElement } from "./elements-ChJULZlh.js";
+import { a as formatEmailDiagnostic, i as EmailDiagnosticSeverity, n as EmailCompileError, o as hasBlockingDiagnostic, r as EmailDiagnostic } from "./diagnostics-BMYtBCQk.js";
+import { a as EmailGlobalProps, c as EmailStyle, d as isUrlAttribute, i as EmailElementSpec, l as EmailTag, m as EmailNode, n as EMAIL_GLOBAL_ATTRIBUTES, o as EmailIntrinsicElements, r as EmailAttributeSpec, s as EmailLayout, t as EMAIL_ELEMENTS, u as emailElement } from "./elements-BzjjnoCS.js";
 import { EmailElementSelection, EmittedPosition, INSTANCE_PATH_ATTRIBUTE, emailAuthoringTarget, emailDefinitionInstances, emailSelectionAncestry, emailSelectionIndex, emailSelectionSiblings, emailSelections } from "./email/selection.js";
 import { EmailHtmlOutput, SerializeEmailOptions, escapeAttribute, escapeText, serializeEmailHtml } from "./email/html.js";
 import { deriveEmailText } from "./email/text.js";
-import { a as compileSelector, c as CompiledSelector, d as matchesSelector, i as Stylesheet, l as Compound, n as CssRule, o as parseStylesheet, r as Specificity, s as Ancestry, t as CssDeclaration, u as classListOf } from "./css-DoNc7CiC.js";
+import { a as compileSelector, c as CompiledSelector, d as matchesSelector, i as Stylesheet, l as Compound, n as CssRule, o as parseStylesheet, r as Specificity, s as Ancestry, t as CssDeclaration, u as classListOf } from "./css-COcFOT1y.js";
 import { EMAIL_DOCTYPE, EmailCompileOutput, RenderedEmail, compileEmail, renderEmail } from "./email/render.js";
 import { collectStylesheets, hasStylesheets, registerStylesheet, resetStylesheets } from "./email/stylesheets.js";
 import { instrumentTsxSourceForPreview } from "./tsx-source-instrumentation.js";
@@ -104,7 +104,10 @@ declare const isExternalAsset: (reference: string) => boolean;
 declare const checkAssetBase: (base: string) => readonly EmailDiagnostic[];
 //#endregion
 //#region src/email/css-values.d.ts
-/** Expand `var(--x, fallback)` against the collected custom properties. */
+/**
+ * Expand `var(--x, fallback)` against the collected custom properties.
+ * Values whose expansion exceeds the render-time budget are left as authored.
+ */
 declare const resolveVariables: (value: string, variables: Readonly<Record<string, string>>, depth?: number) => string;
 /**
  * Fold a constant `calc()` to a plain value. Tailwind writes every spacing

package/dist/compiler.js

@@ -1,5 +1,5 @@
 import { n as isObject } from "./guards-eV1qLbf2.js";
-import { a as applyStylesheet, c as downlevelMediaQuery, d as renderHeadCss, f as resolveVariables, i as renderEmail, l as finalizeValue, o as classListOf, r as compileEmail, s as matchesSelector, t as EMAIL_DOCTYPE, u as foldCalc } from "./render-T6IFPnP4.js";
+import { a as applyStylesheet, c as downlevelMediaQuery, d as renderHeadCss, f as resolveVariables, i as renderEmail, l as finalizeValue, o as classListOf, r as compileEmail, s as matchesSelector, t as EMAIL_DOCTYPE, u as foldCalc } from "./render-aaJBnsXK.js";
 import { EMAIL_ELEMENTS, EMAIL_GLOBAL_ATTRIBUTES, emailElement, isUrlAttribute } from "./email/elements.js";
 import { INSTANCE_PATH_ATTRIBUTE, emailAuthoringTarget, emailDefinitionInstances, emailSelectionAncestry, emailSelectionIndex, emailSelectionSiblings, emailSelections } from "./email/selection.js";
 import { escapeAttribute, escapeText, serializeEmailHtml } from "./email/html.js";
@@ -7,7 +7,7 @@ import { EmailCompileError, formatEmailDiagnostic, hasBlockingDiagnostic } from
 import { collectStylesheets, hasStylesheets, registerStylesheet, resetStylesheets } from "./email/stylesheets.js";
 import { deriveEmailText } from "./email/text.js";
 import { buildLineMap, lineColumn } from "./diagnostics.js";
-import { instrumentTsxSourceForPreview } from "./tsx-source-instrumentation.js";
+import { TsxSourceInstrumentationError, instrumentTsxSourceForPreview } from "./tsx-source-instrumentation.js";
 import { parse } from "@babel/parser";
 import { caniemail, parseHtml, rawData } from "caniemail";
 import { generate, ident, parse as parse$1, walk } from "css-tree";
@@ -264,11 +264,10 @@ const EMAIL_CLIENT_MATRIX = [
 	}
 ];
 const LABELS = new Map(EMAIL_CLIENT_MATRIX.map((target) => [target.id, target.label]));
-const data = rawData;
 const COMPATIBILITY_PROVENANCE = {
 	rules: "caniemail@2.0.2",
-	apiVersion: data.api_version,
-	lastUpdate: data.last_update_date
+	apiVersion: rawData.api_version,
+	lastUpdate: rawData.last_update_date
 };
 /**
 * The constructs whose loss actually breaks a message: the recipient reads
@@ -298,7 +297,7 @@ const ESSENTIAL_CONSTRUCTS = /* @__PURE__ */ new Set([
 	"mailto: links",
 	"Local anchors"
 ]);
-const KNOWN_TITLES = new Set(data.data.map((feature) => feature.title));
+const KNOWN_TITLES = new Set(rawData.data.map((feature) => feature.title));
 /** The innermost recorded node containing an offset, so a finding names its element. */
 const originsAt = (positions, offset) => {
 	let best;
@@ -895,45 +894,6 @@ const compileSelector = (selector) => {
 };
 /** Substitute a nested rule's `&` against its parent selector. */
 const nestSelector = (parent, child) => child.includes("&") ? child.replaceAll("&", parent) : `${parent} ${child}`;
-const selectorFacts = /* @__PURE__ */ new Map();
-/** Everything a rule needs from its selector, computed once per distinct string. */
-const factsFor = (selector) => {
-	const cached = selectorFacts.get(selector);
-	if (cached !== void 0) return cached;
-	let facts;
-	try {
-		const node = parse$1(selector, {
-			context: "selector",
-			positions: false
-		});
-		const classes = /* @__PURE__ */ new Set();
-		walk(node, {
-			visit: "ClassSelector",
-			enter: (part) => {
-				classes.add(ident.decode(part.name));
-			}
-		});
-		facts = {
-			classes: [...classes],
-			specificity: specificityOf(node),
-			pseudo: hasPseudo(node),
-			matcher: compileSelector(selector)
-		};
-	} catch {
-		facts = {
-			classes: [],
-			specificity: [
-				0,
-				0,
-				0
-			],
-			pseudo: true,
-			matcher: void 0
-		};
-	}
-	selectorFacts.set(selector, facts);
-	return facts;
-};
 /** Parse one stylesheet into rules, keeping layer, order and conditions. */
 const parseStylesheet = (source, options = {}) => {
 	const rules = [];
@@ -942,7 +902,46 @@ const parseStylesheet = (source, options = {}) => {
 	const conditionalVariables = /* @__PURE__ */ new Set();
 	const diagnostics = [];
 	const layers = /* @__PURE__ */ new Map();
+	const selectorFacts = /* @__PURE__ */ new Map();
 	let order = options.startOrder ?? 0;
+	/** Everything a rule needs from its selector, computed once per distinct string. */
+	const factsFor = (selector) => {
+		const cached = selectorFacts.get(selector);
+		if (cached !== void 0) return cached;
+		let facts;
+		try {
+			const node = parse$1(selector, {
+				context: "selector",
+				positions: false
+			});
+			const classes = /* @__PURE__ */ new Set();
+			walk(node, {
+				visit: "ClassSelector",
+				enter: (part) => {
+					classes.add(ident.decode(part.name));
+				}
+			});
+			facts = {
+				classes: [...classes],
+				specificity: specificityOf(node),
+				pseudo: hasPseudo(node),
+				matcher: compileSelector(selector)
+			};
+		} catch {
+			facts = {
+				classes: [],
+				specificity: [
+					0,
+					0,
+					0
+				],
+				pseudo: true,
+				matcher: void 0
+			};
+		}
+		selectorFacts.set(selector, facts);
+		return facts;
+	};
 	let ast;
 	try {
 		ast = parse$1(source, {
@@ -1246,6 +1245,28 @@ const stylesheetModule = (id, source, options) => {
 	};
 };
 /**
+* Authored TSX the parser refused is a finding about the source, located where
+* the parser stopped, so every host reports it the way it reports any other
+* compile error.
+*/
+const instrumentAuthoredTsx = (text, id) => {
+	try {
+		return instrumentTsxSourceForPreview(text, id, void 0, null);
+	} catch (error) {
+		if (!(error instanceof TsxSourceInstrumentationError)) throw error;
+		throw new EmailCompileError({ diagnostics: [{
+			code: "tsx-invalid-authored-source",
+			severity: "error",
+			message: error.message,
+			origins: error.location === void 0 ? [] : [{
+				fileName: id,
+				lineNumber: error.location.line,
+				columnNumber: error.location.column
+			}]
+		}] });
+	}
+};
+/**
 * Transform one project file into a JavaScript module.
 *
 * `.tsx`/`.ts` keep their authored semantics and gain source origins. A
@@ -1270,7 +1291,7 @@ const transformModule = async (id, source, options) => {
 	};
 	const discovered = options.tailwind === false ? void 0 : discoverClassCandidates(text, id);
 	return {
-		code: JSX.test(id) ? instrumentTsxSourceForPreview(text, id, void 0, null) : text,
+		code: JSX.test(id) ? instrumentAuthoredTsx(text, id) : text,
 		classes: discovered?.candidates,
 		diagnostics: discovered?.diagnostics ?? []
 	};

package/dist/components.d.ts

@@ -1,7 +1,7 @@
-import { f as ElementNode } from "./ast-BLybiDxp.js";
-import { i as EMAIL_TAG_SPECS, l as WHATSAPP_TAG_SPECS, o as TagSpec, t as AttributeSpec } from "./parser-b_Kp5MT6.js";
-import { r as PredicateRef, s as VariableRef } from "./variables-BnKs1iqb.js";
-import { s as SmlChildren } from "./jsx-runtime-BI4gI19E.js";
+import { f as ElementNode } from "./ast-BrDtApwS.js";
+import { i as EMAIL_TAG_SPECS, l as WHATSAPP_TAG_SPECS, o as TagSpec, t as AttributeSpec } from "./parser-t29cHLVL.js";
+import { r as PredicateRef, s as VariableRef } from "./variables-J_L3qxRa.js";
+import { s as SmlChildren } from "./jsx-runtime-I-1nCtl2.js";
 //#region src/components.d.ts
 /**
  * The scalar type an attribute spec accepts. `level` narrows to the Heading
@@ -244,7 +244,7 @@ declare const WhatsApp: (props: PropsOf<{
     readonly category: {
       readonly type: "string";
       readonly required: true;
-      readonly values: readonly ["marketing", "utility", "authentication", "service"];
+      readonly values: readonly ["marketing", "utility", "authentication"];
     };
   };
   readonly content: "whatsapp";

package/dist/conditionals.js

@@ -1,31 +1,63 @@
-import { i as parsePredicate, r as evaluatePredicate } from "./predicate-DwXzmqIY.js";
+import { i as parsePredicate, r as evaluatePredicate } from "./predicate-BI6uRRM-.js";
 import { Result } from "better-result";
 //#region src/conditionals.ts
 const IF_MARKER = "<!--sml:if:";
 const MARKER_CLOSE = "-->";
 const resolve = (content, variables) => {
-	const start = content.indexOf(IF_MARKER);
-	if (start === -1) return content;
-	const headEnd = content.indexOf(MARKER_CLOSE, start);
-	if (headEnd === -1) return content;
-	const header = content.slice(start + 11, headEnd);
-	const spaceIndex = header.indexOf(" ");
-	const id = spaceIndex === -1 ? header : header.slice(0, spaceIndex);
-	const predicateSource = spaceIndex === -1 ? "" : header.slice(spaceIndex + 1);
-	const elseMarker = `<!--sml:else:${id}-->`;
-	const endMarker = `<!--sml:endif:${id}-->`;
-	const bodyStart = headEnd + 3;
-	const endIndex = content.indexOf(endMarker, bodyStart);
-	if (endIndex === -1) return content;
-	const elseCandidate = content.indexOf(elseMarker, bodyStart);
-	const elseIndex = elseCandidate !== -1 && elseCandidate < endIndex ? elseCandidate : -1;
-	const parsed = parsePredicate(predicateSource);
-	const condition = Result.isOk(parsed) && evaluatePredicate(parsed.value, variables);
-	const branchA = content.slice(bodyStart, elseIndex === -1 ? endIndex : elseIndex);
-	const branchB = elseIndex === -1 ? "" : content.slice(elseIndex + elseMarker.length, endIndex);
-	const selected = resolve(condition ? branchA : branchB, variables).trim();
-	const rest = resolve(content.slice(endIndex + endMarker.length), variables);
-	return content.slice(0, start) + selected + rest;
+	const stack = [{
+		cursor: 0,
+		end: content.length,
+		trim: false,
+		chunks: []
+	}];
+	let resolved = content;
+	while (stack.length > 0) {
+		const frame = stack.at(-1);
+		const start = content.indexOf(IF_MARKER, frame.cursor);
+		if (start === -1 || start >= frame.end) {
+			frame.chunks.push(content.slice(frame.cursor, frame.end));
+			const value = frame.trim ? frame.chunks.join("").trim() : frame.chunks.join("");
+			stack.pop();
+			const parent = stack.at(-1);
+			if (parent === void 0) resolved = value;
+			else parent.chunks.push(value);
+			continue;
+		}
+		const headEnd = content.indexOf(MARKER_CLOSE, start);
+		if (headEnd === -1 || headEnd >= frame.end) {
+			frame.chunks.push(content.slice(frame.cursor, frame.end));
+			frame.cursor = frame.end;
+			continue;
+		}
+		const header = content.slice(start + 11, headEnd);
+		const spaceIndex = header.indexOf(" ");
+		const id = spaceIndex === -1 ? header : header.slice(0, spaceIndex);
+		const predicateSource = spaceIndex === -1 ? "" : header.slice(spaceIndex + 1);
+		const elseMarker = `<!--sml:else:${id}-->`;
+		const endMarker = `<!--sml:endif:${id}-->`;
+		const bodyStart = headEnd + 3;
+		const endIndex = content.indexOf(endMarker, bodyStart);
+		if (endIndex === -1 || endIndex + endMarker.length > frame.end) {
+			frame.chunks.push(content.slice(frame.cursor, frame.end));
+			frame.cursor = frame.end;
+			continue;
+		}
+		const elseCandidate = content.indexOf(elseMarker, bodyStart);
+		const elseIndex = elseCandidate !== -1 && elseCandidate < endIndex ? elseCandidate : -1;
+		const parsed = parsePredicate(predicateSource);
+		const condition = Result.isOk(parsed) && evaluatePredicate(parsed.value, variables);
+		const branchStart = condition ? bodyStart : elseIndex === -1 ? endIndex : elseIndex + elseMarker.length;
+		const branchEnd = condition && elseIndex !== -1 ? elseIndex : endIndex;
+		frame.chunks.push(content.slice(frame.cursor, start));
+		frame.cursor = endIndex + endMarker.length;
+		stack.push({
+			cursor: branchStart,
+			end: branchEnd,
+			trim: true,
+			chunks: []
+		});
+	}
+	return resolved;
 };
 /**
 * Selects <If> branches in a compiled artifact (html or plain-text alt) for

package/dist/{corpus-CM7rKX41.d.ts → corpus-BjYMqOoY.d.ts}

@@ -1,4 +1,4 @@
-import { n as OwnedShowcaseId, t as BrandRecreationShowcaseId } from "./showcase-dvJMn-Lo.js";
+import { n as OwnedShowcaseId, t as BrandRecreationShowcaseId } from "./showcase-DGZAWn4Z.js";
 import { Result } from "better-result";
 //#region presets/corpus.d.ts
 type TemplateCorpusKind = "owned-editable-sml" | "brand-recreation-sml" | "inspiration-reference";
@@ -103,4 +103,4 @@ type TemplateFacetQuery = Partial<TemplateFacetSet>;
 declare const matchesTemplateFacets: (facets: TemplateFacetSet, query: TemplateFacetQuery) => boolean;
 //#endregion
 export { PublicCorpusRegistrationIssue as a, TemplateFacetQuery as c, matchesTemplateFacets as d, ownedPresetSourcePath as f, templateFacetOptions as h, PublicCorpusRegistration as i, TemplateFacetSet as l, registerPublicCorpusEntry as m, InspirationReference as n, TemplateCorpusKind as o, ownedShowcasePresetSources as p, OwnedEditablePreset as r, TemplateCorpusRecord as s, BrandRecreationPreset as t, brandRecreationProvenance as u };
-//# sourceMappingURL=corpus-CM7rKX41.d.ts.map
+//# sourceMappingURL=corpus-BjYMqOoY.d.ts.map