@samva/markup 0.12.0 → 0.13.1

package/CHANGELOG.md

@@ -1,3 +1,23 @@
+## @samva/markup@0.13.1
+
+### The authoring reference omits channel-only upgrade recipes
+
+`generated/reference.md` lists upgrade recipes only for diagnostics that apply to every template,
+matching its diagnostics table and `contract.json`. The `whatsapp-template-name` recipe stays in the
+diagnostic codes, where an agent migrating a WhatsApp template reads it.
+
+## @samva/markup@0.13.0
+
+### Meta's WhatsApp template name comes from the template's handle
+
+`<WhatsApp>` no longer takes `name`. Samva registers each WhatsApp template with Meta under its
+handle, so an authored name could only disagree with it. A template that still sets `name` fails
+with `whatsapp-template-name`, which carries an upgrade recipe: remove the attribute.
+
+`WhatsAppProps`, `IrWhatsApp`, `RenderedIrWhatsApp`, `WhatsAppChannelForm` and the editor host's
+`WhatsAppRender` drop `name`. A `WhatsAppEdit` attribute edit names only `language` or `category`,
+with a string value. The WhatsApp workspace no longer shows a Template name field.
+
 ## @samva/markup@0.11.4
 
 ### Diagnostics carry their upgrade recipe

package/dist/{brand-DTctcDmf.js → brand-C45QBKX9.js}

@@ -1,4 +1,4 @@
-import { D as samvaBrandPlugin, O as BRAND_FOOTER_MARKER, k as UNSUBSCRIBE_LINK, r as escapeAttribute } from "./html-DjPxwjLi.js";
+import { D as samvaBrandPlugin, O as BRAND_FOOTER_MARKER, k as UNSUBSCRIBE_LINK, r as escapeAttribute } from "./html-eOZfDwVf.js";
 import { a as jsx, n as Fragment } from "./jsx-runtime-CBlexoeR.js";
 //#region src/email/assets.ts
 /** Files a template may import, and what they are served as. */

package/dist/brand.js

@@ -1,4 +1,4 @@
-import { D as samvaBrandPlugin } from "./html-DjPxwjLi.js";
+import { D as samvaBrandPlugin } from "./html-eOZfDwVf.js";
 import { a as brandThemeVariables, c as parseBrandCss, i as brandTailwindCss, l as printBrandCss, n as BRAND_FOREGROUND_VARIABLE, o as contrastForeground, r as brandForegroundDefaults, s as darkVariableName, t as BRAND_COLOR_VARIABLE } from "./theme-css-CEUrDpqq.js";
-import { a as ASSET_CONTENT_TYPES, c as checkAssetBase, i as withoutUnsubscribeRow, l as isAssetPath, n as brandComponents, o as assetEntry, r as renderedFooterMarkers, s as assetUrl, t as BRAND_COMPONENT_CLASSES, u as isExternalAsset } from "./brand-DTctcDmf.js";
+import { a as ASSET_CONTENT_TYPES, c as checkAssetBase, i as withoutUnsubscribeRow, l as isAssetPath, n as brandComponents, o as assetEntry, r as renderedFooterMarkers, s as assetUrl, t as BRAND_COMPONENT_CLASSES, u as isExternalAsset } from "./brand-C45QBKX9.js";
 export { ASSET_CONTENT_TYPES, BRAND_COLOR_VARIABLE, BRAND_COMPONENT_CLASSES, BRAND_FOREGROUND_VARIABLE, assetEntry, assetUrl, brandComponents, brandForegroundDefaults, brandTailwindCss, brandThemeVariables, checkAssetBase, contrastForeground, darkVariableName, isAssetPath, isExternalAsset, parseBrandCss, printBrandCss, renderedFooterMarkers, samvaBrandPlugin, withoutUnsubscribeRow };

package/dist/compiler.d.ts

@@ -2,7 +2,7 @@ import { n as parseBrandSpecifier, t as BrandPlugin } from "./brand-plugin-CHhce
 import { a as TemplateDiagnostic, r as EmailDiagnostic } from "./diagnostics-CUYlQ_6x.js";
 import { r as EmailNode } from "./jsx-runtime-DC7xG0aA.js";
 import { n as AssetEntry, p as EmailBrand, u as BrandComponents } from "./assets-DCULM6QD.js";
-import { C as Compound, D as EmittedPosition, S as CompiledSelector, T as matchesSelector, _ as Specificity, b as parseStylesheet, ct as TemplateIr, g as CssRule, h as CssDeclaration, r as RenderedEmail, v as Stylesheet, w as classListOf, x as Ancestry, y as compileSelector } from "./render-C28ucTh8.js";
+import { C as Compound, D as EmittedPosition, S as CompiledSelector, T as matchesSelector, _ as Specificity, b as parseStylesheet, ct as TemplateIr, g as CssRule, h as CssDeclaration, r as RenderedEmail, v as Stylesheet, w as classListOf, x as Ancestry, y as compileSelector } from "./render-C6OTH8BQ.js";
 import { a as TEMPLATE_NAME_PATTERN, n as EmailContent } from "./template-B-UDXK8a.js";
 import { caniemail } from "caniemail";
 //#region src/email/compatibility.d.ts

package/dist/compiler.js

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

package/dist/{components-Bl6DT21n.js → components-DycSEKva.js}

@@ -1,4 +1,4 @@
-import { i as escapeText, r as escapeAttribute } from "./html-DjPxwjLi.js";
+import { i as escapeText, r as escapeAttribute } from "./html-eOZfDwVf.js";
 import { a as jsx, c as rawMarkup, l as reportEmailDiagnostic, n as Fragment, s as normalizeChildren, t as EmailNode } from "./jsx-runtime-CBlexoeR.js";
 //#region src/email/components.ts
 /** Marks the hidden preview block so the renderer can read it back and the text lane can keep it. */

package/dist/{diagnostic-codes-BduqCv_h.js → diagnostic-codes-DdZ4tka5.js}

@@ -385,6 +385,16 @@ const DIAGNOSTIC_CODES = codes({
 		fix: "Write text and bindings, with a newline for a line break.",
 		channelOnly: true
 	},
+	"whatsapp-template-name": {
+		summary: "A <WhatsApp> names its Meta template; the name comes from the template's handle.",
+		fix: "Remove `name` from <WhatsApp>.",
+		upgrade: [
+			"Remove the `name` attribute from every <WhatsApp> element in the project, templates and partials alike. Samva registers each WhatsApp template with Meta under its handle, with hyphens as underscores, so the attribute has no replacement. Change nothing else.",
+			"If an authored name differs from the name the handle produces and the template is already registered with Meta under it, tell the user: keeping that Meta name means renaming the template's handle, which you do not do yourself.",
+			"Compile each entry and render every declared fixture to confirm the WhatsApp output is otherwise unchanged. Resolve errors before requesting one saved version for the whole project, approved by the user; do not publish."
+		].join("\n\n"),
+		channelOnly: true
+	},
 	"whatsapp-structure": {
 		summary: "WhatsApp content sits outside Header, Body, Footer or Buttons.",
 		fix: "Move it into <WhatsApp.Body>.",

package/dist/diagnostics.d.ts

@@ -354,6 +354,12 @@ declare const DIAGNOSTIC_CODES: {
     readonly fix: "Write text and bindings, with a newline for a line break.";
     readonly channelOnly: true;
   };
+  readonly "whatsapp-template-name": {
+    readonly summary: "A <WhatsApp> names its Meta template; the name comes from the template's handle.";
+    readonly fix: "Remove `name` from <WhatsApp>.";
+    readonly upgrade: string;
+    readonly channelOnly: true;
+  };
   readonly "whatsapp-structure": {
     readonly summary: "WhatsApp content sits outside Header, Body, Footer or Buttons.";
     readonly fix: "Move it into <WhatsApp.Body>.";

package/dist/diagnostics.js

@@ -1,3 +1,3 @@
-import { a as createDiagnosticFormatter, i as buildLineMap, n as DIAGNOSTIC_CODE_FAMILIES, o as formatDiagnostic, r as hasUpgradeRecipe, s as lineColumn, t as DIAGNOSTIC_CODES } from "./diagnostic-codes-BduqCv_h.js";
+import { 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-DdZ4tka5.js";
 import { n as formatEmailDiagnostic, r as hasBlockingDiagnostic, t as EmailCompileError } from "./diagnostics-C0Tr8-eQ.js";
 export { DIAGNOSTIC_CODES, DIAGNOSTIC_CODE_FAMILIES, EmailCompileError, buildLineMap, createDiagnosticFormatter, formatDiagnostic, formatEmailDiagnostic, hasBlockingDiagnostic, hasUpgradeRecipe, lineColumn };

package/dist/edit.d.ts

@@ -161,7 +161,6 @@ type WhatsAppButtonRow = {
   readonly summary: string;
 };
 interface WhatsAppChannelForm {
-  readonly name: AttributeState;
   readonly language: AttributeState;
   readonly category: AttributeState;
   /** Null when the template has no header. */
@@ -191,8 +190,8 @@ type SmsEdit = {
 type WhatsAppPart = "header" | "body" | "footer";
 type WhatsAppEdit = {
   readonly kind: "attribute";
-  readonly name: "name" | "language" | "category";
-  readonly value: string | undefined;
+  readonly name: "language" | "category";
+  readonly value: string;
 } | {
   readonly kind: "headerType";
   readonly value: WhatsAppHeaderType;

package/dist/edit.js

@@ -1,7 +1,7 @@
 import { n as isObject } from "./guards-eV1qLbf2.js";
 import { d as completeJsxSourceLocation, u as JSX_SOURCE_LOCATION_PROP } from "./jsx-runtime-CBlexoeR.js";
-import { i as buildLineMap } from "./diagnostic-codes-BduqCv_h.js";
-import { c as WHATSAPP_HEADER_TYPES, n as introducedProfileErrors, o as SMS_CATEGORIES, s as WHATSAPP_CATEGORIES, t as checkStaticProfile } from "./profile-CWZ2kkt-.js";
+import { i as buildLineMap } from "./diagnostic-codes-DdZ4tka5.js";
+import { c as WHATSAPP_HEADER_TYPES, n as introducedProfileErrors, o as SMS_CATEGORIES, s as WHATSAPP_CATEGORIES, t as checkStaticProfile } from "./profile-CXnkfEMi.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";
@@ -806,7 +806,6 @@ const readWhatsAppChannel = (source) => {
 	if (channel === null || channel.body === null) return null;
 	const { root } = channel;
 	return {
-		name: attributeState(source, root, "name"),
 		language: attributeState(source, root, "language"),
 		category: attributeState(source, root, "category"),
 		header: channel.header === null ? null : segmentsOf(source, channel.header),
@@ -856,14 +855,12 @@ const editWhatsAppChannel = (source, edit) => {
 	};
 	const { root, local } = channel;
 	switch (edit.kind) {
-		case "attribute": {
-			if (edit.name === "category" && !WHATSAPP_CATEGORIES.includes(edit.value ?? "")) return {
+		case "attribute":
+			if (edit.name === "category" && !WHATSAPP_CATEGORIES.includes(edit.value)) return {
 				ok: false,
 				reason: "Choose a WhatsApp category."
 			};
-			const value = edit.name === "name" && edit.value === "" ? void 0 : edit.value ?? "";
-			return setAttribute(source, root, edit.name, value);
-		}
+			return setAttribute(source, root, edit.name, edit.value);
 		case "headerType":
 			if (channel.header === null) return {
 				ok: false,

package/dist/email.js

@@ -1,2 +1,2 @@
-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-Bl6DT21n.js";
+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-DycSEKva.js";
 export { Button, Column, Columns, Divider, Email, Image, Link, PREHEADER_ATTRIBUTE, Section, Spacer, equalColumnWidth, preheaderNode };

package/dist/{html-DjPxwjLi.js → html-eOZfDwVf.js}

@@ -1157,7 +1157,6 @@ const renderIrWhatsApp = (ir, input, options = {}) => {
 	resolveButtons(ctx, whatsapp.buttons ?? [], buttons, 0);
 	settle(ctx);
 	return {
-		...whatsapp.name === void 0 ? {} : { name: whatsapp.name },
 		language: whatsapp.language,
 		category: whatsapp.category,
 		...header === void 0 ? {} : { header },

package/dist/{ir-De6pTH51.js → ir-C-ubz6N3.js}

@@ -1,5 +1,5 @@
 import { n as isObject } from "./guards-eV1qLbf2.js";
-import { a as kebab, n as declarationValue, r as escapeAttribute } from "./html-DjPxwjLi.js";
+import { a as kebab, n as declarationValue, r as escapeAttribute } from "./html-eOZfDwVf.js";
 import { t as EmailNode } from "./jsx-runtime-CBlexoeR.js";
 //#region src/email/font-stacks.ts
 /** Generic families every email client understands as the last resort in a stack. */

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

@@ -1,13 +1,13 @@
 import { n as isObject } from "./guards-eV1qLbf2.js";
 import { n as inputSchema, r as jsonSchema } from "./input-schema-zjkgrXn2.js";
 import { n as TEMPLATE_NAME_PATTERN, t as TEMPLATE_ID_PATTERN } from "./template-zLUjcwfF.js";
-import { D as samvaBrandPlugin, E as reservedBrandAttributes, O as BRAND_FOOTER_MARKER, S as emailElement, T as parseBrandSpecifier, b as EMAIL_ELEMENTS, s as serializeStyle, t as checkAttribute } from "./html-DjPxwjLi.js";
+import { D as samvaBrandPlugin, E as reservedBrandAttributes, O as BRAND_FOOTER_MARKER, S as emailElement, T as parseBrandSpecifier, b as EMAIL_ELEMENTS, s as serializeStyle, t as checkAttribute } from "./html-eOZfDwVf.js";
 import { FORMATTER_NAMES } from "./fmt.js";
 import { i as drainEmailDiagnostics, t as EmailNode } from "./jsx-runtime-CBlexoeR.js";
-import { a as Email, d as equalColumnWidth, i as Divider, l as Section, n as Column, o as Image, r as Columns, s as Link, t as Button, u as Spacer } from "./components-Bl6DT21n.js";
-import { n as applyStylesheet } from "./ir-De6pTH51.js";
-import { i as buildLineMap, s as lineColumn, t as DIAGNOSTIC_CODES } from "./diagnostic-codes-BduqCv_h.js";
-import { l as isAssetPath, n as brandComponents } from "./brand-DTctcDmf.js";
+import { a as Email, d as equalColumnWidth, i as Divider, l as Section, n as Column, o as Image, r as Columns, s as Link, t as Button, u as Spacer } from "./components-DycSEKva.js";
+import { n as applyStylesheet } from "./ir-C-ubz6N3.js";
+import { i as buildLineMap, s as lineColumn, t as DIAGNOSTIC_CODES } from "./diagnostic-codes-DdZ4tka5.js";
+import { l as isAssetPath, n as brandComponents } from "./brand-C45QBKX9.js";
 import { parse } from "css-tree";
 import { parse as parse$1 } from "@babel/parser";
 //#region src/email/theme-imports.ts
@@ -284,11 +284,7 @@ const WHATSAPP_HEADER_TYPES = [
 /** The attributes `<Sms>` accepts. */
 const SMS_ATTRIBUTES = ["category"];
 /** The attributes `<WhatsApp>` accepts. */
-const WHATSAPP_ATTRIBUTES = [
-	"name",
-	"language",
-	"category"
-];
+const WHATSAPP_ATTRIBUTES = ["language", "category"];
 //#endregion
 //#region src/whatsapp-template.ts
 const isConcat = (value) => typeof value === "object" && value !== null && "concat" in value;
@@ -2545,8 +2541,13 @@ const readRoot = (input, field, imported, specifier) => {
 		local: tag
 	};
 };
-/** The string-literal attributes of a channel root; anything else is reported. */
-const readAttributes = (input, root, allowed) => {
+/** Meta's template name is not authored: Samva registers the template under its handle. */
+const WHATSAPP_REFUSED = { name: {
+	code: "whatsapp-template-name",
+	message: "Meta's name for a WhatsApp template comes from the template's handle, not from <WhatsApp>.",
+	fix: "Remove `name`; rename the template's handle to change its Meta name."
+} };
+const readAttributes = (input, root, allowed, refused = {}) => {
 	const values = /* @__PURE__ */ new Map();
 	for (const attribute of attributesOf(root.node)) {
 		if (attribute.type === "JSXSpreadAttribute") {
@@ -2556,6 +2557,11 @@ const readAttributes = (input, root, allowed) => {
 		const nameNode = child(attribute, "name");
 		const name = nameNode === void 0 ? "" : jsxName(nameNode);
 		if (name === "key") continue;
+		const refusal = Object.hasOwn(refused, name) ? refused[name] : void 0;
+		if (refusal !== void 0) {
+			input.lowerer.error(root.ctx, attribute, refusal.code, refusal.message, refusal.fix);
+			continue;
+		}
 		if (!allowed.includes(name)) {
 			input.lowerer.error(root.ctx, attribute, "unknown-attribute", `\`${name}\` is not an attribute of this component.`, `The attributes are ${allowed.join(", ")}.`);
 			continue;
@@ -2658,7 +2664,7 @@ const whatsappChannel = (input, field) => {
 	if (root === void 0) return void 0;
 	const { lowerer } = input;
 	const { ctx } = root;
-	const attributes = readAttributes(input, root, WHATSAPP_ATTRIBUTES);
+	const attributes = readAttributes(input, root, WHATSAPP_ATTRIBUTES, WHATSAPP_REFUSED);
 	for (const required of ["category", "language"]) if (!attributes.has(required)) lowerer.error(ctx, root.node, "missing-attribute", `<WhatsApp> needs \`${required}\`.`, required === "category" ? `Write category="utility" (${WHATSAPP_CATEGORIES.join(", ")}).` : "Write language=\"en_US\".");
 	const category = attributes.get("category");
 	const categoryNode = attributesOf(root.node).find((attribute) => text(child(attribute, "name") ?? attribute, "name") === "category");
@@ -2749,9 +2755,7 @@ const whatsappChannel = (input, field) => {
 	}
 	if (input.schema !== void 0) input.checks.push(...checkBindings(input.schema, roots, []));
 	if (category === void 0 || !attributes.has("language")) return void 0;
-	const name = attributes.get("name");
 	return {
-		...name === void 0 ? {} : { name },
 		category,
 		language: attributes.get("language"),
 		...header === void 0 ? {} : { header },

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

@@ -176,7 +176,6 @@ type IrWhatsAppButtonNode = IrWhatsAppButton | {
   readonly src?: IrSource;
 };
 interface IrWhatsApp {
-  readonly name?: string;
   readonly category: string;
   readonly language: string;
   /** For a media header, `content` is the media URL. */
@@ -247,7 +246,6 @@ type RenderedWhatsAppButton = {
 };
 /** A WhatsApp message with every text rendered and every conditional button resolved. */
 interface RenderedIrWhatsApp {
-  readonly name?: string;
   readonly language: string;
   readonly category: string;
   /** For a media header, `text` is the media URL. */

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

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

package/dist/render.d.ts

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

package/dist/render.js

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

package/dist/whatsapp.d.ts

@@ -2,7 +2,6 @@ import { r as EmailNode, t as EmailChild } from "./jsx-runtime-DC7xG0aA.js";
 import { n as WhatsAppCategory, r as WhatsAppHeaderType } from "./channel-specs-C2feJwuP.js";
 //#region src/whatsapp.d.ts
 interface WhatsAppProps {
-  readonly name?: string | undefined;
   /** The Meta language code, for example `en_US`. */
   readonly language: string;
   readonly category: WhatsAppCategory;

package/generated/contract.json

@@ -575,11 +575,6 @@
       "name": "WhatsApp",
       "import": "@samva/markup/whatsapp",
       "props": [
-        {
-          "name": "name",
-          "type": "string",
-          "optional": true
-        },
         {
           "name": "language",
           "type": "string",
@@ -1292,7 +1287,7 @@
     },
     "whatsapp": {
       "categories": ["marketing", "utility", "authentication"],
-      "attributes": ["name", "language", "category"],
+      "attributes": ["language", "category"],
       "headerTypes": ["text", "image", "video", "document"]
     }
   },
@@ -1765,6 +1760,13 @@
       "fix": "Move it into <WhatsApp.Body>.",
       "channelOnly": true
     },
+    {
+      "code": "whatsapp-template-name",
+      "summary": "A <WhatsApp> names its Meta template; the name comes from the template's handle.",
+      "fix": "Remove `name` from <WhatsApp>.",
+      "upgrade": "Remove the `name` attribute from every <WhatsApp> element in the project, templates and partials alike. Samva registers each WhatsApp template with Meta under its handle, with hyphens as underscores, so the attribute has no replacement. Change nothing else.\n\nIf an authored name differs from the name the handle produces and the template is already registered with Meta under it, tell the user: keeping that Meta name means renaming the template's handle, which you do not do yourself.\n\nCompile each entry and render every declared fixture to confirm the WhatsApp output is otherwise unchanged. Resolve errors before requesting one saved version for the whole project, approved by the user; do not publish.",
+      "channelOnly": true
+    },
     {
       "code": "wrong-channel",
       "summary": "A channel body does not return its own channel component.",

package/package.json

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