@samva/markup 0.3.0 → 0.5.0

package/AGENTS.md

@@ -1,5 +1,22 @@
 # 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.

package/dist/{ast-63I-VLQx.d.ts → ast-BLybiDxp.d.ts}

@@ -1,5 +1,4 @@
-import { c as SpanSchema } from "./diagnostics-oveE-laV.js";
-import { Schema } from "effect";
+import { a as Span } from "./diagnostics-CqepLcpI.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"];
@@ -41,74 +40,49 @@ declare const ROOT_TAGS: ReadonlyArray<RootTag>;
 declare const isRootTag: (tag: string) => tag is RootTag;
 /** The channel a parsed document targets, read off its root tag. */
 declare const documentChannel: (document: SmlDocument) => Channel;
-declare const AttributeValueSchema: Schema.Union<readonly [Schema.Struct<{
-  readonly kind: Schema.Literal<"string">;
-  readonly value: Schema.String;
-}>, Schema.Struct<{
-  readonly kind: Schema.Literal<"number">;
-  readonly value: Schema.Finite;
-}>]>;
-type AttributeValue = typeof AttributeValueSchema.Type;
-declare const AttributeSchema: Schema.Struct<{
-  readonly name: Schema.String;
-  readonly value: Schema.Union<readonly [Schema.Struct<{
-    readonly kind: Schema.Literal<"string">;
-    readonly value: Schema.String;
-  }>, Schema.Struct<{
-    readonly kind: Schema.Literal<"number">;
-    readonly value: Schema.Finite;
-  }>]>;
+type AttributeValue = {
+  readonly kind: "string";
+  readonly value: string;
+} | {
+  readonly kind: "number";
+  readonly value: number;
+};
+interface Attribute {
+  readonly name: string;
+  readonly value: AttributeValue;
   /** Span of the whole `name="value"` pair. */
-  readonly span: Schema.Struct<{
-    readonly start: Schema.Finite;
-    readonly end: Schema.Finite;
-  }>;
+  readonly span: Span;
   /** Span of the value contents (inside quotes/braces) — class diagnostics point here. */
-  readonly valueSpan: Schema.Struct<{
-    readonly start: Schema.Finite;
-    readonly end: Schema.Finite;
-  }>;
-}>;
-interface Attribute extends Schema.Schema.Type<typeof AttributeSchema> {}
-declare const TextNodeSchema: Schema.Struct<{
-  readonly kind: Schema.Literal<"text">;
-  readonly id: Schema.String;
-  readonly value: Schema.String;
-  readonly span: Schema.Struct<{
-    readonly start: Schema.Finite;
-    readonly end: Schema.Finite;
-  }>;
-}>;
-interface TextNode extends Schema.Schema.Type<typeof TextNodeSchema> {}
-declare const InterpolationNodeSchema: Schema.Struct<{
-  readonly kind: Schema.Literal<"interpolation">;
-  readonly id: Schema.String;
-  readonly name: Schema.String;
+  readonly valueSpan: Span;
+}
+interface TextNode {
+  readonly kind: "text";
+  readonly id: string;
+  readonly value: string;
+  readonly span: Span;
+}
+interface InterpolationNode {
+  readonly kind: "interpolation";
+  readonly id: string;
+  readonly name: string;
   /** {{name}} vs ${name} — both today's syntaxes, preserved through print. */
-  readonly syntax: Schema.Literals<readonly ["curly", "dollar"]>;
-  readonly span: Schema.Struct<{
-    readonly start: Schema.Finite;
-    readonly end: Schema.Finite;
-  }>;
-}>;
-interface InterpolationNode extends Schema.Schema.Type<typeof InterpolationNodeSchema> {}
+  readonly syntax: "curly" | "dollar";
+  readonly span: Span;
+}
 interface ElementNode {
   readonly kind: "element";
   readonly id: string;
   readonly tag: SmlTag;
   readonly attributes: ReadonlyArray<Attribute>;
   readonly children: ReadonlyArray<SmlNode>;
-  readonly span: typeof SpanSchema.Type;
+  readonly span: Span;
 }
 type SmlNode = ElementNode | TextNode | InterpolationNode;
-declare const ElementNodeSchema: Schema.Codec<ElementNode>;
-declare const SmlNodeSchema: Schema.Codec<SmlNode>;
-declare const SmlDocumentSchema: Schema.Struct<{
-  readonly kind: Schema.Literal<"document">;
+interface SmlDocument {
+  readonly kind: "document";
   /** Always a root element: `<Email>`, `<Sms>`, or `<WhatsApp>`. */
-  readonly root: Schema.Codec<ElementNode, ElementNode, never, never>;
-}>;
-interface SmlDocument extends Schema.Schema.Type<typeof SmlDocumentSchema> {}
+  readonly root: ElementNode;
+}
 declare const attributeValue: (node: ElementNode, name: string) => AttributeValue | undefined;
 declare const stringAttribute: (node: ElementNode, name: string) => string | undefined;
 declare const numberAttribute: (node: ElementNode, name: string) => number | undefined;
@@ -129,5 +103,5 @@ declare const isHiddenNode: (node: ElementNode) => boolean;
  */
 declare const collectVariableReferences: (document: SmlDocument) => ReadonlySet<string>;
 //#endregion
-export { TextNodeSchema as A, stringAttribute as B, SML_TAG_BY_COMPONENT_NAME as C, SmlNodeSchema as D, SmlNode as E, isHiddenNode as F, isRootTag as I, nodeLabel as L, collectVariableReferences as M, componentNameForSmlTag as N, SmlTag as O, documentChannel as P, numberAttribute as R, SML_TAGS as S, SmlDocumentSchema as T, InlineTag as _, AttributeValueSchema as a, ROOT_TAGS as b, BlockTag as c, Channel as d, ChannelTag as f, INLINE_TAGS as g, ElementNodeSchema as h, AttributeValue as i, attributeValue as j, TextNode as k, CHANNEL_BY_ROOT_TAG as l, ElementNode as m, Attribute as n, AuxiliaryTag as o, DEFAULT_EMAIL_WIDTH as p, AttributeSchema as r, BLOCK_TAGS as s, AUXILIARY_TAGS as t, CHANNEL_TAGS as u, InterpolationNode as v, SmlDocument as w, RootTag as x, InterpolationNodeSchema as y, smlTagForComponentName as z };
-//# sourceMappingURL=ast-63I-VLQx.d.ts.map
+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

package/dist/ast.d.ts

@@ -1,2 +1,2 @@
-import { A as TextNodeSchema, B as stringAttribute, C as SML_TAG_BY_COMPONENT_NAME, D as SmlNodeSchema, E as SmlNode, F as isHiddenNode, I as isRootTag, L as nodeLabel, M as collectVariableReferences, N as componentNameForSmlTag, O as SmlTag, P as documentChannel, R as numberAttribute, S as SML_TAGS, T as SmlDocumentSchema, _ as InlineTag, a as AttributeValueSchema, b as ROOT_TAGS, c as BlockTag, d as Channel, f as ChannelTag, g as INLINE_TAGS, h as ElementNodeSchema, i as AttributeValue, j as attributeValue, k as TextNode, l as CHANNEL_BY_ROOT_TAG, m as ElementNode, n as Attribute, o as AuxiliaryTag, p as DEFAULT_EMAIL_WIDTH, r as AttributeSchema, s as BLOCK_TAGS, t as AUXILIARY_TAGS, u as CHANNEL_TAGS, v as InterpolationNode, w as SmlDocument, x as RootTag, y as InterpolationNodeSchema, z as smlTagForComponentName } from "./ast-63I-VLQx.js";
-export { AUXILIARY_TAGS, Attribute, AttributeSchema, AttributeValue, AttributeValueSchema, AuxiliaryTag, BLOCK_TAGS, BlockTag, CHANNEL_BY_ROOT_TAG, CHANNEL_TAGS, Channel, ChannelTag, DEFAULT_EMAIL_WIDTH, ElementNode, ElementNodeSchema, INLINE_TAGS, InlineTag, InterpolationNode, InterpolationNodeSchema, ROOT_TAGS, RootTag, SML_TAGS, SML_TAG_BY_COMPONENT_NAME, SmlDocument, SmlDocumentSchema, SmlNode, SmlNodeSchema, SmlTag, TextNode, TextNodeSchema, attributeValue, collectVariableReferences, componentNameForSmlTag, documentChannel, isHiddenNode, isRootTag, nodeLabel, numberAttribute, smlTagForComponentName, stringAttribute };
+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";
+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,6 +1,5 @@
-import { SpanSchema } from "./diagnostics.js";
-import { i as parsePredicate, n as collectPredicateVariables } from "./predicate-CvkzT-a2.js";
-import { Result, Schema } from "effect";
+import { i as parsePredicate, n as collectPredicateVariables } from "./predicate-DwXzmqIY.js";
+import { Result } from "better-result";
 //#region src/ast.ts
 const BLOCK_TAGS = [
 	"Email",
@@ -68,53 +67,6 @@ const ROOT_TAGS = Object.keys(CHANNEL_BY_ROOT_TAG);
 const isRootTag = (tag) => tag in CHANNEL_BY_ROOT_TAG;
 /** The channel a parsed document targets, read off its root tag. */
 const documentChannel = (document) => CHANNEL_BY_ROOT_TAG[document.root.tag];
-const AttributeValueSchema = Schema.Union([Schema.Struct({
-	kind: Schema.Literal("string"),
-	value: Schema.String
-}), Schema.Struct({
-	kind: Schema.Literal("number"),
-	value: Schema.Finite
-})]);
-const AttributeSchema = Schema.Struct({
-	name: Schema.String,
-	value: AttributeValueSchema,
-	/** Span of the whole `name="value"` pair. */
-	span: SpanSchema,
-	/** Span of the value contents (inside quotes/braces) — class diagnostics point here. */
-	valueSpan: SpanSchema
-});
-const TextNodeSchema = Schema.Struct({
-	kind: Schema.Literal("text"),
-	id: Schema.String,
-	value: Schema.String,
-	span: SpanSchema
-});
-const InterpolationNodeSchema = Schema.Struct({
-	kind: Schema.Literal("interpolation"),
-	id: Schema.String,
-	name: Schema.String,
-	/** {{name}} vs ${name} — both today's syntaxes, preserved through print. */
-	syntax: Schema.Literals(["curly", "dollar"]),
-	span: SpanSchema
-});
-const ElementNodeSchema = Schema.Struct({
-	kind: Schema.Literal("element"),
-	id: Schema.String,
-	tag: Schema.Literals(SML_TAGS),
-	attributes: Schema.Array(AttributeSchema),
-	children: Schema.Array(Schema.suspend(() => SmlNodeSchema)),
-	span: SpanSchema
-});
-const SmlNodeSchema = Schema.Union([
-	ElementNodeSchema,
-	TextNodeSchema,
-	InterpolationNodeSchema
-]);
-const SmlDocumentSchema = Schema.Struct({
-	kind: Schema.Literal("document"),
-	/** Always a root element: `<Email>`, `<Sms>`, or `<WhatsApp>`. */
-	root: ElementNodeSchema
-});
 const attributeValue = (node, name) => node.attributes.find((attribute) => attribute.name === name)?.value;
 const stringAttribute = (node, name) => {
 	const value = attributeValue(node, name);
@@ -153,7 +105,7 @@ const collectVariableReferences = (document) => {
 			if (attribute.value.kind !== "string") continue;
 			if (node.tag === "If" && attribute.name === "test") {
 				const parsed = parsePredicate(attribute.value.value);
-				if (Result.isSuccess(parsed)) for (const name of collectPredicateVariables(parsed.success)) names.add(name);
+				if (Result.isOk(parsed)) for (const name of collectPredicateVariables(parsed.value)) names.add(name);
 				continue;
 			}
 			for (const match of attribute.value.value.matchAll(attributePattern)) {
@@ -167,6 +119,6 @@ const collectVariableReferences = (document) => {
 	return names;
 };
 //#endregion
-export { AUXILIARY_TAGS, AttributeSchema, AttributeValueSchema, BLOCK_TAGS, CHANNEL_BY_ROOT_TAG, CHANNEL_TAGS, DEFAULT_EMAIL_WIDTH, ElementNodeSchema, INLINE_TAGS, InterpolationNodeSchema, ROOT_TAGS, SML_TAGS, SML_TAG_BY_COMPONENT_NAME, SmlDocumentSchema, SmlNodeSchema, TextNodeSchema, attributeValue, collectVariableReferences, componentNameForSmlTag, documentChannel, isHiddenNode, isRootTag, nodeLabel, numberAttribute, smlTagForComponentName, stringAttribute };
+export { AUXILIARY_TAGS, BLOCK_TAGS, CHANNEL_BY_ROOT_TAG, CHANNEL_TAGS, DEFAULT_EMAIL_WIDTH, INLINE_TAGS, ROOT_TAGS, SML_TAGS, SML_TAG_BY_COMPONENT_NAME, attributeValue, collectVariableReferences, componentNameForSmlTag, documentChannel, isHiddenNode, isRootTag, nodeLabel, numberAttribute, smlTagForComponentName, stringAttribute };
 
 //# sourceMappingURL=ast.js.map

package/dist/catalog-Db0UcCTg.d.ts

@@ -0,0 +1,356 @@
+import { l as Channel } from "./ast-BLybiDxp.js";
+import { o as TokenOverrides } from "./theme-6ApjjiBo.js";
+//#region presets/catalog.d.ts
+type PresetCategory = "transactional" | "digest" | "marketing" | "lifecycle";
+interface PresetMeta {
+  /** Stable id and source filename stem (`${id}.tsx`). */
+  readonly id: string;
+  /** The source's root-tag channel; the gallery filters by it. */
+  readonly channel: Channel;
+  readonly category: PresetCategory;
+  /** Human title for the gallery card. */
+  readonly name: string;
+  /** One-line description of when to reach for this preset. */
+  readonly description: string;
+  /**
+   * Every input property declared by the template schema, sorted.
+   * A sender supplies these values when rendering the template.
+   */
+  readonly variables: ReadonlyArray<string>;
+}
+declare const RECOMMENDED_THEME: TokenOverrides;
+declare const presetCatalog: readonly [{
+  readonly id: "linear-login-code";
+  readonly channel: "email";
+  readonly category: "transactional";
+  readonly name: "Linear login code";
+  readonly description: "Recreate Linear's login code email with an editable magic link, code, and bundled logo.";
+  readonly variables: readonly ["expiryNotice", "homeUrl", "loginUrl", "productName", "validationCode"];
+}, {
+  readonly id: "product-newsletter";
+  readonly channel: "email";
+  readonly category: "digest";
+  readonly name: "Product newsletter";
+  readonly description: "A monthly product newsletter with a lead story, mapped secondary stories, a changelog and one action.";
+  readonly variables: readonly ["changelog", "issueMonth", "issueNumber", "issueUrl", "leadImage", "leadSummary", "leadTitle", "leadUrl", "preferencesUrl", "stories", "unsubscribeUrl"];
+}, {
+  readonly id: "vercel-invitation";
+  readonly channel: "email";
+  readonly category: "transactional";
+  readonly name: "Vercel team invitation";
+  readonly description: "Recreate Vercel's team invitation with editable source and bundled assets.";
+  readonly variables: readonly ["inviteFromIp", "inviteFromLocation", "inviteLink", "invitedByEmail", "invitedByUsername", "teamImage", "teamName", "userImage", "username"];
+}, {
+  readonly id: "order-receipt";
+  readonly channel: "email";
+  readonly category: "transactional";
+  readonly name: "Order receipt";
+  readonly description: "Itemized order receipt with product thumbnails, totals, payment summary and shipping address.";
+  readonly variables: readonly ["customerName", "discount", "items", "orderDate", "orderNumber", "orderUrl", "paymentBrand", "paymentLast4", "shipping", "shippingAddress", "subtotal", "supportEmail", "tax", "total"];
+}, {
+  readonly id: "welcome";
+  readonly channel: "email";
+  readonly category: "transactional";
+  readonly name: "Welcome";
+  readonly description: "First email after signup, with a lead illustration and a numbered list of first steps from the input.";
+  readonly variables: readonly ["ctaUrl", "docsUrl", "firstName", "planNote", "steps", "supportEmail", "workspace"];
+}, {
+  readonly id: "email-verification";
+  readonly channel: "email";
+  readonly category: "transactional";
+  readonly name: "Email verification";
+  readonly description: "Confirm a new email address with a one-click button, a fallback code and the request details behind it.";
+  readonly variables: readonly ["email", "expiryNotice", "firstName", "previousEmail", "requestDetails", "supportEmail", "verificationCode", "verifyUrl", "workspace"];
+}, {
+  readonly id: "otp";
+  readonly channel: "email";
+  readonly category: "transactional";
+  readonly name: "One-time passcode";
+  readonly description: "Deliver a short-lived sign-in code as the only thing on the page, with the request details under it.";
+  readonly variables: readonly ["code", "expiryNotice", "helpUrl", "newDevice", "requestDetails", "workspace"];
+}, {
+  readonly id: "password-reset";
+  readonly channel: "email";
+  readonly category: "transactional";
+  readonly name: "Password reset";
+  readonly description: "Send an expiring reset link with the request details, a paste-able fallback URL and an optional passkey offer.";
+  readonly variables: readonly ["expiryNotice", "firstName", "passkeyPrompt", "requestDetails", "resetUrl", "securityUrl", "supportEmail", "workspace"];
+}, {
+  readonly id: "payment-failed";
+  readonly channel: "email";
+  readonly category: "transactional";
+  readonly name: "Payment failed";
+  readonly description: "Declined-charge notice with the amount due, the card on file, the held order and every charge attempt.";
+  readonly variables: readonly ["amountDue", "attempts", "automaticRetry", "customerName", "declineReason", "holdUntil", "items", "orderNumber", "paymentBrand", "paymentLast4", "supportEmail", "updatePaymentUrl"];
+}, {
+  readonly id: "shipping-update";
+  readonly channel: "email";
+  readonly category: "transactional";
+  readonly name: "Shipping update";
+  readonly description: "Shipment notice with the carrier, tracking, delivery estimate, the packed items and anything still to come.";
+  readonly variables: readonly ["carrier", "customerName", "estimatedDelivery", "items", "orderNumber", "pendingItems", "shippedDate", "shippingAddress", "supportEmail", "trackingNumber", "trackingUrl"];
+}, {
+  readonly id: "notification";
+  readonly channel: "email";
+  readonly category: "transactional";
+  readonly name: "Activity notification";
+  readonly description: "Workspace activity notification with the actor, the message quoted in full, recent activity and a deep link back.";
+  readonly variables: readonly ["actionSummary", "actorAvatar", "actorName", "attachment", "itemTitle", "itemUrl", "message", "otherActivity", "settingsUrl", "timestamp", "workspaceName"];
+}, {
+  readonly id: "team-invite";
+  readonly channel: "email";
+  readonly category: "transactional";
+  readonly name: "Team invite";
+  readonly description: "Invite someone into a workspace with one accept action, the inviter's note and the people already there.";
+  readonly variables: readonly ["acceptUrl", "expiryNotice", "inviteeEmail", "inviterAvatarUrl", "inviterEmail", "inviterName", "personalNote", "productName", "teammates", "workspace"];
+}, {
+  readonly id: "data-sharing-review";
+  readonly channel: "email";
+  readonly category: "transactional";
+  readonly name: "Data-sharing review";
+  readonly description: "Ask a customer to keep or remove a third-party connection, listing every permission it holds.";
+  readonly variables: readonly ["connectedServiceIconUrl", "connectedServiceName", "connectedSince", "keepConnectionUrl", "lastAccess", "recipientEmail", "referenceCode", "removeConnectionUrl", "scopes", "securityUrl", "settingsUrl", "workspace"];
+}, {
+  readonly id: "product-digest";
+  readonly channel: "email";
+  readonly category: "digest";
+  readonly name: "Weekly digest";
+  readonly description: "A weekly reader digest: mapped stories with their desk and reading time, a most-read list, and an optional audio edition.";
+  readonly variables: readonly ["archiveUrl", "editionLabel", "mostRead", "podcast", "preferencesUrl", "readerName", "stories", "unsubscribeUrl"];
+}, {
+  readonly id: "editorial-newsletter";
+  readonly channel: "email";
+  readonly category: "digest";
+  readonly name: "Long-form newsletter";
+  readonly description: "A long-form editorial issue: a byline, an essay that renders from a list of paragraphs, a pull quote, an optional labelled sponsor and a reading list.";
+  readonly variables: readonly ["authorAvatar", "authorName", "authorRole", "heroImage", "issueLabel", "paragraphs", "preferencesUrl", "pullQuote", "readingList", "sponsor", "standfirst", "storyUrl", "subscribeUrl", "title", "unsubscribeUrl"];
+}, {
+  readonly id: "events-roundup";
+  readonly channel: "email";
+  readonly category: "digest";
+  readonly name: "Events roundup";
+  readonly description: "A dated events digest: an optional spotlight billing and a grid of upcoming shows with images, dates, rooms, prices and per-event tickets.";
+  readonly variables: readonly ["calendarUrl", "cityName", "events", "helpUrl", "seasonLabel", "spotlight", "unsubscribeUrl"];
+}, {
+  readonly id: "industry-news-digest";
+  readonly channel: "email";
+  readonly category: "digest";
+  readonly name: "Industry news digest";
+  readonly description: "A dense industry brief: an agenda, a lead story with details and analysis, mapped desk stories, an optional labelled sponsor, and tool and job lists.";
+  readonly variables: readonly ["agenda", "audienceSize", "editionDate", "editionUrl", "intro", "jobs", "lead", "sponsor", "sponsorContactUrl", "stories", "tools", "unsubscribeUrl"];
+}, {
+  readonly id: "announcement";
+  readonly channel: "email";
+  readonly category: "marketing";
+  readonly name: "Feature announcement";
+  readonly description: "Announce one change with a hero image, highlights from a list, an availability date and a single action.";
+  readonly variables: readonly ["availableFrom", "ctaUrl", "featureDescription", "featureName", "featureTagline", "firstName", "highlights", "preferencesUrl", "releaseNoteUrl", "unsubscribeUrl"];
+}, {
+  readonly id: "event-invite";
+  readonly channel: "email";
+  readonly category: "marketing";
+  readonly name: "Event invite";
+  readonly description: "Invite members to an event with the date, the place, an agenda from a list, and one RSVP action.";
+  readonly variables: readonly ["agenda", "capacityNote", "declineUrl", "eventAddress", "eventDate", "eventDescription", "eventLocation", "eventName", "eventTagline", "eventTime", "firstName", "preferencesUrl", "rsvpUrl", "travelNote", "unsubscribeUrl"];
+}, {
+  readonly id: "membership-promo";
+  readonly channel: "email";
+  readonly category: "marketing";
+  readonly name: "Membership promotion";
+  readonly description: "Promote a paid membership with tier cards from a list, a discount code, a deadline, and one join action.";
+  readonly variables: readonly ["compareUrl", "discountPercent", "firstName", "headline", "joinUrl", "offerEnds", "preferencesUrl", "promoCode", "savingsNote", "subhead", "tiers", "unsubscribeUrl"];
+}, {
+  readonly id: "member-referral-offer";
+  readonly channel: "email";
+  readonly category: "marketing";
+  readonly name: "Member referral offer";
+  readonly description: "Ask a member to bring people onto their account for a limited-time reward, with the steps and the terms as lists.";
+  readonly variables: readonly ["firstName", "headline", "maxMembers", "maxReward", "offerEnds", "offerStarts", "preferencesUrl", "referralCode", "referralUrl", "reminderNote", "rewardPerMember", "spendMinimum", "steps", "subhead", "terms", "termsUrl", "unsubscribeUrl"];
+}, {
+  readonly id: "catalog-sale-newsletter";
+  readonly channel: "email";
+  readonly category: "marketing";
+  readonly name: "Catalog sale newsletter";
+  readonly description: "Open a catalogue-wide sale with a bundle offer, a product grid from a list, a discount code, and the shop dates.";
+  readonly variables: readonly ["bundleListPrice", "bundleName", "bundleSalePrice", "bundleUrl", "dates", "discountCode", "editionLabel", "editionYear", "firstName", "headline", "intro", "items", "offerEnds", "preferencesUrl", "shopUrl", "stockNote", "unsubscribeUrl"];
+}, {
+  readonly id: "limited-time-savings";
+  readonly channel: "email";
+  readonly category: "marketing";
+  readonly name: "Limited-time savings";
+  readonly description: "A time-boxed savings offer with the hours remaining, reasons from a list, member quotes, and one claim action.";
+  readonly variables: readonly ["claimUrl", "firstName", "headline", "hoursRemaining", "listPrice", "offerEnds", "postscript", "preferencesUrl", "promoCode", "reasons", "salePrice", "savingsAmount", "subhead", "testimonials", "timezoneUrl", "unsubscribeUrl"];
+}, {
+  readonly id: "rewards-milestone";
+  readonly channel: "email";
+  readonly category: "marketing";
+  readonly name: "Rewards milestone";
+  readonly description: "Show a member how far through a rewards ladder they are, what the next step unlocks, and what each tier is worth.";
+  readonly variables: readonly ["bonusNote", "expiresOn", "firstName", "headline", "milestoneLabel", "nextReward", "pointsBalance", "preferencesUrl", "rewardsUrl", "steps", "stepsCompleted", "stepsTotal", "subhead", "termsUrl", "tiers", "unsubscribeUrl"];
+}, {
+  readonly id: "travel-rewards-promo";
+  readonly channel: "email";
+  readonly category: "marketing";
+  readonly name: "Travel rewards promotion";
+  readonly description: "A travel rewards promotion with a member balance, earning tiers from a list, and partner offers.";
+  readonly variables: readonly ["accountUrl", "bookUrl", "firstName", "headline", "memberNumber", "milesBalance", "offerEnds", "partners", "preferencesUrl", "subhead", "termsUrl", "tierName", "tiers", "unsubscribeUrl"];
+}, {
+  readonly id: "product-updates-roundup";
+  readonly channel: "email";
+  readonly category: "marketing";
+  readonly name: "Product updates roundup";
+  readonly description: "A monthly product roundup with a metrics strip, shipped updates from a list, and an optional event.";
+  readonly variables: readonly ["changelogUrl", "event", "firstName", "headline", "intro", "issueMonth", "issueNumber", "metrics", "preferencesUrl", "unsubscribeUrl", "updates"];
+}, {
+  readonly id: "flash-getaway-offer";
+  readonly channel: "email";
+  readonly category: "marketing";
+  readonly name: "Flash getaway offer";
+  readonly description: "A flash getaway offer with an input countdown, destinations from a list, and one booking action.";
+  readonly variables: readonly ["countdown", "destinations", "exploreUrl", "firstName", "headline", "offerEnds", "offerWindow", "preferencesUrl", "subhead", "termsUrl", "unsubscribeUrl"];
+}, {
+  readonly id: "membership-benefits-promo";
+  readonly channel: "email";
+  readonly category: "marketing";
+  readonly name: "Membership benefits promotion";
+  readonly description: "A paid-membership promotion with a price panel, benefits from a list, and one join action.";
+  readonly variables: readonly ["benefits", "billingNote", "comparePlansUrl", "firstName", "headline", "joinUrl", "preferencesUrl", "priceLabel", "renewsOn", "subhead", "supportEmail", "trialLabel", "unsubscribeUrl"];
+}, {
+  readonly id: "weekly-deals-circular";
+  readonly channel: "email";
+  readonly category: "marketing";
+  readonly name: "Weekly deals circular";
+  readonly description: "A weekly retail circular with deals from a list, clippable coupons, and one shop action.";
+  readonly variables: readonly ["coupons", "deals", "headline", "intro", "memberPerk", "membershipUrl", "preferencesUrl", "shopUrl", "unsubscribeUrl", "validThrough", "weekLabel"];
+}, {
+  readonly id: "seasonal-sale-flyer";
+  readonly channel: "email";
+  readonly category: "marketing";
+  readonly name: "Seasonal sale flyer";
+  readonly description: "A seasonal sale flyer with tiered promo codes, a category grid, and an optional gift-card offer.";
+  readonly variables: readonly ["categories", "giftCard", "headline", "intro", "offerWindow", "preferencesUrl", "promoTiers", "seasonLabel", "shopUrl", "subhead", "termsUrl", "unsubscribeUrl"];
+}, {
+  readonly id: "feature-release-roundup";
+  readonly channel: "email";
+  readonly category: "marketing";
+  readonly name: "Feature release roundup";
+  readonly description: "A feature release roundup with image-left rows from a list, release badges, and docs links.";
+  readonly variables: readonly ["changelogUrl", "firstName", "headline", "intro", "migrationUrl", "preferencesUrl", "releases", "sunsetOn", "unsubscribeUrl"];
+}, {
+  readonly id: "season-clearance-promo";
+  readonly channel: "email";
+  readonly category: "marketing";
+  readonly name: "Season clearance promotion";
+  readonly description: "A last-chance clearance promotion with marked-down highlights three a row and one shop action.";
+  readonly variables: readonly ["deadlinePhrase", "firstName", "headline", "highlights", "intro", "newArrivalsUrl", "preferencesUrl", "remainingNote", "shopUrl", "unsubscribeUrl"];
+}, {
+  readonly id: "product-launch-promo";
+  readonly channel: "email";
+  readonly category: "marketing";
+  readonly name: "Product launch promotion";
+  readonly description: "Launch a collection with a hero, a four-product grid, a discount code, and one shop action.";
+  readonly variables: readonly ["bestSellersUrl", "discountCode", "firstName", "headline", "newArrivalsUrl", "offerEnds", "preferencesUrl", "products", "saleUrl", "shopUrl", "subhead", "unsubscribeUrl"];
+}, {
+  readonly id: "onboarding-step";
+  readonly channel: "email";
+  readonly category: "lifecycle";
+  readonly name: "Onboarding step";
+  readonly description: "One step of an onboarding sequence, with the whole setup list, its progress, and a single next action.";
+  readonly variables: readonly ["actionUrl", "docsUrl", "firstName", "stepBody", "stepNumber", "stepTitle", "steps", "supportEmail", "tip", "workspace"];
+}, {
+  readonly id: "trial-ending";
+  readonly channel: "email";
+  readonly category: "lifecycle";
+  readonly name: "Trial ending";
+  readonly description: "Warn a trial user their access is ending, with what the trial produced, the plan that keeps it, and an optional offer.";
+  readonly variables: readonly ["contactUrl", "daysLeft", "firstName", "highlights", "keeps", "offer", "plan", "trialEndDate", "upgradeUrl", "workspace"];
+}, {
+  readonly id: "win-back";
+  readonly channel: "email";
+  readonly category: "lifecycle";
+  readonly name: "Win-back";
+  readonly description: "Re-engage a lapsed user with an illustrated list of what shipped while they were away, and an optional return offer.";
+  readonly variables: readonly ["firstName", "lastActive", "offer", "preferencesUrl", "returnUrl", "unsubscribeUrl", "updates", "workspace"];
+}, {
+  readonly id: "feedback-request";
+  readonly channel: "email";
+  readonly category: "lifecycle";
+  readonly name: "Feedback request";
+  readonly description: "Ask an active user one question with clickable answers, a short survey, and a named sender who reads the replies.";
+  readonly variables: readonly ["firstName", "incentive", "options", "question", "sender", "surveyUrl", "tenure", "workspace"];
+}, {
+  readonly id: "product-onboarding-tour";
+  readonly channel: "email";
+  readonly category: "lifecycle";
+  readonly name: "Product onboarding tour";
+  readonly description: "Walk a new user through the features worth turning on first, each with a still, its own points and a link, followed by a reading list.";
+  readonly variables: readonly ["features", "firstName", "helpCenterUrl", "intro", "mobile", "preferencesUrl", "reads", "unsubscribeUrl"];
+}, {
+  readonly id: "setup-checklist";
+  readonly channel: "email";
+  readonly category: "lifecycle";
+  readonly name: "Setup checklist";
+  readonly description: "Welcome a new customer with the setup steps that remain, each marked done or outstanding, and one link back into the flow.";
+  readonly variables: readonly ["continueUrl", "firstName", "helpUrl", "note", "steps", "unsubscribeUrl", "welcome", "workspace"];
+}, {
+  readonly id: "sms-otp";
+  readonly channel: "sms";
+  readonly category: "transactional";
+  readonly name: "One-time passcode (SMS)";
+  readonly description: "Deliver a short-lived sign-in or 2FA code in a single GSM-7 segment.";
+  readonly variables: readonly ["code", "expiryMinutes", "workspace"];
+}, {
+  readonly id: "sms-shipping-update";
+  readonly channel: "sms";
+  readonly category: "transactional";
+  readonly name: "Shipping update (SMS)";
+  readonly description: "Tell a customer their order shipped, with a tracking link.";
+  readonly variables: readonly ["orderNumber", "trackingUrl", "workspace"];
+}, {
+  readonly id: "sms-appointment-reminder";
+  readonly channel: "sms";
+  readonly category: "lifecycle";
+  readonly name: "Appointment reminder (SMS)";
+  readonly description: "Remind a customer of an upcoming appointment with a reschedule path.";
+  readonly variables: readonly ["appointmentDate", "appointmentTime", "workspace"];
+}, {
+  readonly id: "sms-flash-sale";
+  readonly channel: "sms";
+  readonly category: "marketing";
+  readonly name: "Flash sale (SMS)";
+  readonly description: "Drive a limited-time offer with a promo code and a conditional urgency line.";
+  readonly variables: readonly ["endsToday", "offerHeadline", "promoCode", "shopUrl", "workspace"];
+}, {
+  readonly id: "whatsapp-order-update";
+  readonly channel: "whatsapp";
+  readonly category: "transactional";
+  readonly name: "Order update (WhatsApp)";
+  readonly description: "Utility template: shipping confirmation with a tracking URL button.";
+  readonly variables: readonly ["estimatedDelivery", "firstName", "orderNumber", "trackingUrl"];
+}, {
+  readonly id: "whatsapp-appointment-reminder";
+  readonly channel: "whatsapp";
+  readonly category: "lifecycle";
+  readonly name: "Appointment reminder (WhatsApp)";
+  readonly description: "Utility template: appointment reminder with confirm/reschedule quick replies.";
+  readonly variables: readonly ["appointmentDate", "appointmentTime", "firstName", "workspace"];
+}, {
+  readonly id: "whatsapp-flash-sale";
+  readonly channel: "whatsapp";
+  readonly category: "marketing";
+  readonly name: "Flash sale (WhatsApp)";
+  readonly description: "Marketing template: limited-time offer with a copyable promo code and a shop button.";
+  readonly variables: readonly ["endsToday", "firstName", "offerDetails", "offerHeadline", "promoCode", "shopUrl"];
+}];
+type PresetId = (typeof presetCatalog)[number]["id"];
+type PresetVariable = (typeof presetCatalog)[number]["variables"][number];
+type EmailPreset = Extract<(typeof presetCatalog)[number], {
+  channel: "email";
+}>;
+type EmailPresetId = EmailPreset["id"];
+type EmailPresetVariable = EmailPreset extends (infer Preset) ? Preset extends {
+  readonly variables: ReadonlyArray<infer Variable>;
+} ? 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