@samva/markup 0.7.0 → 0.8.0

package/dist/theme-css.js

@@ -1,509 +1,2 @@
-import { Result } from "better-result";
-//#region src/theme-css.ts
-const CHAR_TAB = 9;
-const CHAR_LINE_FEED = 10;
-const CHAR_CARRIAGE_RETURN = 13;
-const CHAR_SPACE = 32;
-const CHAR_STAR = 42;
-const CHAR_HYPHEN = 45;
-const CHAR_SLASH = 47;
-const CHAR_COLON = 58;
-const CHAR_SEMICOLON = 59;
-const CHAR_AT = 64;
-const CHAR_OPEN_PAREN = 40;
-const CHAR_CLOSE_PAREN = 41;
-const CHAR_OPEN_BRACE = 123;
-const CHAR_CLOSE_BRACE = 125;
-const CHAR_0 = 48;
-const CHAR_9 = 57;
-const CHAR_UPPER_A = 65;
-const CHAR_UPPER_Z = 90;
-const CHAR_LOWER_A = 97;
-const CHAR_LOWER_Z = 122;
-const isWhitespace = (code) => code === CHAR_SPACE || code === CHAR_TAB || code === CHAR_LINE_FEED || code === CHAR_CARRIAGE_RETURN;
-const isIdentChar = (code) => code >= CHAR_LOWER_A && code <= CHAR_LOWER_Z || code >= CHAR_UPPER_A && code <= CHAR_UPPER_Z || code >= CHAR_0 && code <= CHAR_9 || code === CHAR_HYPHEN;
-const HEX_PATTERN = /^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/;
-const NUM = String.raw`(?:\d+(?:\.\d+)?|\.\d+)`;
-const PX_PATTERN = new RegExp(`^(${NUM})px$`);
-const TEXT_PATTERN = new RegExp(`^(${NUM})px(?:\\s*/\\s*(${NUM})px)?$`);
-const UNITLESS_PATTERN = new RegExp(`^${NUM}$`);
-const EM_PATTERN = new RegExp(`^(-?${NUM})em$`);
-const INTEGER_PATTERN = /^\d+$/;
-/** #rgb/#rrggbb → 6-digit lowercase, or null. */
-const normalizeHex = (value) => {
-	const match = HEX_PATTERN.exec(value);
-	if (match === null) return null;
-	const digits = match[1].toLowerCase();
-	if (digits.length === 6) return `#${digits}`;
-	return `#${digits[0]}${digits[0]}${digits[1]}${digits[1]}${digits[2]}${digits[2]}`;
-};
-const pxNumber = (value) => {
-	const match = PX_PATTERN.exec(value);
-	return match === null ? null : Number.parseFloat(match[1]);
-};
-const NAMESPACE_SUMMARY = "supported namespaces: --color-*, --radius-*, --font-*, --font-weight-*, --text-*, --leading-*, --spacing, --container-*, --tracking-*";
-const parseThemeCss = (css) => {
-	const length = css.length;
-	let position = 0;
-	const diagnostics = [];
-	const seen = /* @__PURE__ */ new Set();
-	const accumulator = {
-		colors: {},
-		colorsDark: {},
-		text: {},
-		leading: {},
-		radiusPx: {},
-		fontWeights: {},
-		fontFamilies: {},
-		containerPx: {},
-		tracking: {},
-		spacingPx: void 0
-	};
-	let themeBlockCount = 0;
-	const report = (code, message, span) => {
-		diagnostics.push({
-			code,
-			message,
-			span
-		});
-	};
-	const skipTrivia = () => {
-		while (position < length) {
-			const code = css.charCodeAt(position);
-			if (isWhitespace(code)) {
-				position++;
-				continue;
-			}
-			if (code === CHAR_SLASH && css.charCodeAt(position + 1) === CHAR_STAR) {
-				const start = position;
-				const close = css.indexOf("*/", position + 2);
-				if (close === -1) {
-					report("theme-unterminated-comment", "unterminated /* comment — add */", {
-						start,
-						end: length
-					});
-					position = length;
-					return;
-				}
-				position = close + 2;
-				continue;
-			}
-			return;
-		}
-	};
-	/** `@word` at the current position, not followed by more ident chars. */
-	const atKeyword = (word) => css.startsWith(word, position) && !isIdentChar(css.charCodeAt(position + word.length));
-	/** Skips a balanced `{ ... }` region (position on or before the `{`). */
-	const skipBalancedBlock = () => {
-		while (position < length && css.charCodeAt(position) !== CHAR_OPEN_BRACE) position++;
-		let depth = 0;
-		while (position < length) {
-			const code = css.charCodeAt(position);
-			position++;
-			if (code === CHAR_OPEN_BRACE) depth++;
-			else if (code === CHAR_CLOSE_BRACE) {
-				depth--;
-				if (depth === 0) return;
-			}
-		}
-	};
-	/** Declaration-level recovery: past the next `;`, or up to the block's `}`. */
-	const skipToDeclarationBoundary = () => {
-		while (position < length) {
-			const code = css.charCodeAt(position);
-			if (code === CHAR_SEMICOLON) {
-				position++;
-				return;
-			}
-			if (code === CHAR_CLOSE_BRACE) return;
-			position++;
-		}
-	};
-	const record = (target, scope, field, name, value, propertySpan, property) => {
-		const key = `${scope}:${field}:${name}`;
-		if (seen.has(key)) {
-			report("theme-duplicate-declaration", `duplicate declaration --${property} — declare each token once`, propertySpan);
-			return;
-		}
-		seen.add(key);
-		target[name] = value;
-	};
-	const parseDeclaration = (scope) => {
-		const propertyStart = position;
-		position += 2;
-		while (position < length && isIdentChar(css.charCodeAt(position))) position++;
-		const property = css.slice(propertyStart + 2, position);
-		const propertySpan = {
-			start: propertyStart,
-			end: position
-		};
-		skipTrivia();
-		if (css.charCodeAt(position) !== CHAR_COLON) {
-			report("theme-expected-declaration", `expected : after --${property}`, {
-				start: position,
-				end: Math.min(position + 1, length)
-			});
-			skipToDeclarationBoundary();
-			return;
-		}
-		position++;
-		skipTrivia();
-		const valueStart = position;
-		while (position < length) {
-			const code = css.charCodeAt(position);
-			if (code === CHAR_SEMICOLON || code === CHAR_CLOSE_BRACE || code === CHAR_OPEN_BRACE) break;
-			position++;
-		}
-		let valueEnd = position;
-		while (valueEnd > valueStart && isWhitespace(css.charCodeAt(valueEnd - 1))) valueEnd--;
-		const value = css.slice(valueStart, valueEnd).replace(/\s+/g, " ");
-		const valueSpan = {
-			start: valueStart,
-			end: Math.max(valueEnd, valueStart + 1)
-		};
-		if (css.charCodeAt(position) === CHAR_SEMICOLON) position++;
-		else report("theme-missing-semicolon", `missing ; after --${property} declaration`, propertySpan);
-		routeDeclaration(scope, property, propertySpan, value, valueSpan);
-	};
-	const invalidValue = (property, value, expected, span) => {
-		report("theme-invalid-value", `invalid value "${value}" for --${property} — ${expected}`, span);
-	};
-	const routeDeclaration = (scope, property, propertySpan, value, valueSpan) => {
-		const named = (prefix) => {
-			if (!property.startsWith(prefix)) return null;
-			const name = property.slice(prefix.length);
-			if (name.length === 0) {
-				report("theme-invalid-value", `--${property} is missing a token name — write --${prefix}<name>`, propertySpan);
-				return null;
-			}
-			if (name.includes("--")) {
-				report("theme-invalid-value", `malformed token name in --${property}${prefix === "text-" ? " — use the size/line-height shorthand instead: --text-xl: 20px/28px" : " — token names use single hyphens"}`, propertySpan);
-				return null;
-			}
-			return name;
-		};
-		if (value.length === 0) {
-			invalidValue(property, value, "the value is empty", valueSpan);
-			return;
-		}
-		if (property.startsWith("color-")) {
-			const name = named("color-");
-			if (name === null) return;
-			const hex = normalizeHex(value);
-			if (hex === null) {
-				invalidValue(property, value, "expected a hex color like #4f46e5 or #fff (named colors, oklch(), and rgb() are outside the closed grammar)", valueSpan);
-				return;
-			}
-			if (scope === "dark") record(accumulator.colorsDark, scope, "colors", name, hex, propertySpan, property);
-			else record(accumulator.colors, scope, "colors", name, hex, propertySpan, property);
-			return;
-		}
-		if (scope === "dark") {
-			report("theme-dark-non-color", `--${property} is not allowed in the dark theme block — only --color-* tokens have dark counterparts`, propertySpan);
-			return;
-		}
-		if (property.startsWith("radius-")) {
-			const name = named("radius-");
-			if (name === null) return;
-			const px = pxNumber(value);
-			if (px === null) {
-				invalidValue(property, value, "expected a px length like \"12px\"", valueSpan);
-				return;
-			}
-			record(accumulator.radiusPx, scope, "radiusPx", name, px, propertySpan, property);
-			return;
-		}
-		if (property.startsWith("font-weight-")) {
-			const name = named("font-weight-");
-			if (name === null) return;
-			const weight = INTEGER_PATTERN.test(value) ? Number.parseInt(value, 10) : null;
-			if (weight === null || weight < 100 || weight > 900) {
-				invalidValue(property, value, "expected a font weight between 100 and 900", valueSpan);
-				return;
-			}
-			record(accumulator.fontWeights, scope, "fontWeights", name, weight, propertySpan, property);
-			return;
-		}
-		if (property.startsWith("font-")) {
-			const name = named("font-");
-			if (name === null) return;
-			if (value.includes("var(") || value.includes("calc(") || value.includes("oklch(")) {
-				invalidValue(property, value, "expected a literal font stack — var()/calc() don't exist in compiled email", valueSpan);
-				return;
-			}
-			const stack = value.replaceAll("\"", "'");
-			record(accumulator.fontFamilies, scope, "fontFamilies", name, stack, propertySpan, property);
-			return;
-		}
-		if (property.startsWith("text-")) {
-			const name = named("text-");
-			if (name === null) return;
-			const match = TEXT_PATTERN.exec(value);
-			if (match === null) {
-				invalidValue(property, value, "expected \"16px\" or \"16px/24px\" (font-size/line-height)", valueSpan);
-				return;
-			}
-			const sizePx = Number.parseFloat(match[1]);
-			const lineHeightPx = match[2] === void 0 ? Math.round(sizePx * 1.5) : Number.parseFloat(match[2]);
-			record(accumulator.text, scope, "text", name, {
-				sizePx,
-				lineHeightPx
-			}, propertySpan, property);
-			return;
-		}
-		if (property.startsWith("leading-")) {
-			const name = named("leading-");
-			if (name === null) return;
-			if (!UNITLESS_PATTERN.test(value) || Number.parseFloat(value) <= 0) {
-				invalidValue(property, value, "expected a unitless line-height ratio like \"1.5\"", valueSpan);
-				return;
-			}
-			record(accumulator.leading, scope, "leading", name, Number.parseFloat(value), propertySpan, property);
-			return;
-		}
-		if (property.startsWith("tracking-")) {
-			const name = named("tracking-");
-			if (name === null) return;
-			const match = EM_PATTERN.exec(value);
-			if (match === null) {
-				invalidValue(property, value, "expected an em value like \"0.025em\" or \"-0.05em\"", valueSpan);
-				return;
-			}
-			record(accumulator.tracking, scope, "tracking", name, Number.parseFloat(match[1]), propertySpan, property);
-			return;
-		}
-		if (property.startsWith("container-")) {
-			const name = named("container-");
-			if (name === null) return;
-			const px = pxNumber(value);
-			if (px === null) {
-				invalidValue(property, value, "expected a px length like \"600px\"", valueSpan);
-				return;
-			}
-			record(accumulator.containerPx, scope, "containerPx", name, px, propertySpan, property);
-			return;
-		}
-		if (property === "spacing") {
-			const px = pxNumber(value);
-			if (px === null || px <= 0) {
-				invalidValue(property, value, "expected a positive px length like \"4px\"", valueSpan);
-				return;
-			}
-			const key = "light:spacingPx";
-			if (seen.has(key)) {
-				report("theme-duplicate-declaration", "duplicate declaration --spacing — declare each token once", propertySpan);
-				return;
-			}
-			seen.add(key);
-			accumulator.spacingPx = px;
-			return;
-		}
-		if (property.startsWith("spacing-")) {
-			report("theme-unknown-namespace", `--${property} is not supported — only the bare --spacing multiplier is (spacing steps derive from it)`, propertySpan);
-			return;
-		}
-		report("theme-unknown-namespace", `unknown namespace in --${property} — ${NAMESPACE_SUMMARY}`, propertySpan);
-	};
-	/** Position after the `@theme` keyword; parses `{ declarations }`. */
-	const parseThemeBlock = (scope) => {
-		skipTrivia();
-		if (css.charCodeAt(position) !== CHAR_OPEN_BRACE) {
-			report("theme-expected-block", "expected { after @theme", {
-				start: position,
-				end: Math.min(position + 1, length)
-			});
-			return;
-		}
-		const openBrace = position;
-		position++;
-		themeBlockCount++;
-		while (true) {
-			skipTrivia();
-			if (position >= length) {
-				report("theme-unbalanced-braces", "unclosed @theme block — add }", {
-					start: openBrace,
-					end: openBrace + 1
-				});
-				return;
-			}
-			const code = css.charCodeAt(position);
-			if (code === CHAR_CLOSE_BRACE) {
-				position++;
-				return;
-			}
-			if (code === CHAR_HYPHEN && css.charCodeAt(position + 1) === CHAR_HYPHEN) {
-				parseDeclaration(scope);
-				continue;
-			}
-			report("theme-expected-declaration", "expected a --<namespace>-<name> declaration", {
-				start: position,
-				end: Math.min(position + 1, length)
-			});
-			skipToDeclarationBoundary();
-		}
-	};
-	/** Position after the `@media` keyword; parses the dark wrapper block. */
-	const parseMediaBlock = () => {
-		const mediaStart = position - 6;
-		const preludeError = () => {
-			report("theme-unsupported-media", "only @media (prefers-color-scheme: dark) is supported — the dark theme wrapper", {
-				start: mediaStart,
-				end: Math.min(position + 1, length)
-			});
-			skipBalancedBlock();
-		};
-		skipTrivia();
-		if (css.charCodeAt(position) !== CHAR_OPEN_PAREN) return preludeError();
-		position++;
-		skipTrivia();
-		if (!css.startsWith("prefers-color-scheme", position)) return preludeError();
-		position += 20;
-		skipTrivia();
-		if (css.charCodeAt(position) !== CHAR_COLON) return preludeError();
-		position++;
-		skipTrivia();
-		if (!atKeyword("dark")) return preludeError();
-		position += 4;
-		skipTrivia();
-		if (css.charCodeAt(position) !== CHAR_CLOSE_PAREN) return preludeError();
-		position++;
-		skipTrivia();
-		if (css.charCodeAt(position) !== CHAR_OPEN_BRACE) {
-			report("theme-expected-block", "expected { after the dark media query", {
-				start: position,
-				end: Math.min(position + 1, length)
-			});
-			return;
-		}
-		const openBrace = position;
-		position++;
-		let sawThemeBlock = false;
-		while (true) {
-			skipTrivia();
-			if (position >= length) {
-				report("theme-unbalanced-braces", "unclosed @media block — add }", {
-					start: openBrace,
-					end: openBrace + 1
-				});
-				return;
-			}
-			const code = css.charCodeAt(position);
-			if (code === CHAR_CLOSE_BRACE) {
-				position++;
-				break;
-			}
-			if (code === CHAR_AT && atKeyword("@theme")) {
-				position += 6;
-				parseThemeBlock("dark");
-				sawThemeBlock = true;
-				continue;
-			}
-			report("theme-expected-block", "expected an @theme block inside the dark media query", {
-				start: position,
-				end: Math.min(position + 1, length)
-			});
-			skipBalancedBlock();
-		}
-		if (!sawThemeBlock) report("theme-expected-block", "the dark media query contains no @theme block", {
-			start: openBrace,
-			end: openBrace + 1
-		});
-	};
-	while (position < length) {
-		skipTrivia();
-		if (position >= length) break;
-		if (atKeyword("@theme")) {
-			position += 6;
-			parseThemeBlock("light");
-			continue;
-		}
-		if (atKeyword("@media")) {
-			position += 6;
-			parseMediaBlock();
-			continue;
-		}
-		report("theme-unexpected-content", "expected @theme or @media (prefers-color-scheme: dark) at the top level", {
-			start: position,
-			end: Math.min(position + 1, length)
-		});
-		const next = position;
-		while (position < length) {
-			const code = css.charCodeAt(position);
-			if (code === CHAR_AT && position > next) break;
-			if (code === CHAR_OPEN_BRACE) {
-				skipBalancedBlock();
-				break;
-			}
-			position++;
-		}
-	}
-	if (themeBlockCount === 0 && diagnostics.length === 0) report("theme-missing-block", "no @theme block found — write @theme { --color-brand: #4f46e5; }", {
-		start: 0,
-		end: Math.min(1, length)
-	});
-	if (diagnostics.length > 0) return Result.err(diagnostics);
-	const nonEmpty = (entries) => Object.keys(entries).length > 0 ? entries : void 0;
-	const colors = nonEmpty(accumulator.colors);
-	const colorsDark = nonEmpty(accumulator.colorsDark);
-	const text = nonEmpty(accumulator.text);
-	const leading = nonEmpty(accumulator.leading);
-	const radiusPx = nonEmpty(accumulator.radiusPx);
-	const fontWeights = nonEmpty(accumulator.fontWeights);
-	const fontFamilies = nonEmpty(accumulator.fontFamilies);
-	const containerPx = nonEmpty(accumulator.containerPx);
-	const tracking = nonEmpty(accumulator.tracking);
-	return Result.ok({
-		colors,
-		colorsDark,
-		spacingPx: accumulator.spacingPx,
-		text,
-		leading,
-		radiusPx,
-		fontWeights,
-		fontFamilies,
-		containerPx,
-		tracking
-	});
-};
-/** Trim a JS number to a stable decimal string (no exponent, no trailing zeros). */
-const numberText = (value) => {
-	const text = String(value);
-	if (!text.includes("e") && !text.includes("E")) return text;
-	const expanded = value.toLocaleString("en-US", {
-		useGrouping: false,
-		maximumFractionDigits: 20
-	});
-	if (!expanded.includes(".")) return expanded;
-	return expanded.replace(/0+$/, "").replace(/\.$/, "");
-};
-const declaration = (property, value) => `  --${property}: ${value};`;
-const colorDeclarations = (colors) => colors === void 0 ? [] : Object.entries(colors).map(([name, hex]) => declaration(`color-${name}`, hex));
-/**
-* Serialize a ParsedTheme to `@theme` CSS. Light tokens go in the top-level
-* `@theme` block; `colorsDark` (colors-only, matching the parser) goes in the
-* `@media (prefers-color-scheme: dark) { @theme { … } }` wrapper.
-*/
-const printThemeCss = (theme) => {
-	const light = [
-		...colorDeclarations(theme.colors),
-		...theme.spacingPx !== void 0 ? [declaration("spacing", `${numberText(theme.spacingPx)}px`)] : [],
-		...theme.radiusPx === void 0 ? [] : Object.entries(theme.radiusPx).map(([name, px]) => declaration(`radius-${name}`, `${numberText(px)}px`)),
-		...theme.fontFamilies === void 0 ? [] : Object.entries(theme.fontFamilies).map(([name, stack]) => declaration(`font-${name}`, stack)),
-		...theme.fontWeights === void 0 ? [] : Object.entries(theme.fontWeights).map(([name, weight]) => declaration(`font-weight-${name}`, numberText(weight))),
-		...theme.text === void 0 ? [] : Object.entries(theme.text).map(([name, token]) => declaration(`text-${name}`, `${numberText(token.sizePx)}px/${numberText(token.lineHeightPx)}px`)),
-		...theme.leading === void 0 ? [] : Object.entries(theme.leading).map(([name, ratio]) => declaration(`leading-${name}`, numberText(ratio))),
-		...(() => {
-			const trackingSource = theme.tracking ?? theme.trackingEm;
-			return trackingSource === void 0 ? [] : Object.entries(trackingSource).map(([name, em]) => declaration(`tracking-${name}`, `${numberText(em)}em`));
-		})(),
-		...theme.containerPx === void 0 ? [] : Object.entries(theme.containerPx).map(([name, px]) => declaration(`container-${name}`, `${numberText(px)}px`))
-	];
-	const dark = colorDeclarations(theme.colorsDark);
-	const blocks = [`@theme {\n${light.join("\n")}\n}`];
-	if (dark.length > 0) blocks.push(`@media (prefers-color-scheme: dark) {\n  @theme {\n  ${dark.join("\n  ")}\n  }\n}`);
-	return `${blocks.join("\n\n")}\n`;
-};
-//#endregion
-export { parseThemeCss, printThemeCss };
-
-//# sourceMappingURL=theme-css.js.map
+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-hFqcPSar.js";
+export { BRAND_COLOR_VARIABLE, BRAND_FOREGROUND_VARIABLE, brandForegroundDefaults, brandTailwindCss, brandThemeVariables, contrastForeground, darkVariableName, parseBrandCss, printBrandCss };

package/dist/tsx-tracer.js

@@ -3,7 +3,7 @@ import { buildLineMap } from "./diagnostics.js";
 import { SML_TAGS, componentNameForSmlTag, smlTagForComponentName } from "./ast.js";
 import { decodeEntities } from "./lexer.js";
 import { parseSml } from "./parser.js";
-import { r as applyOps } from "./ops-2aiiYO7m.js";
+import { r as applyOps } from "./ops-BvwqHl7V.js";
 import { Result, TaggedError } from "better-result";
 import { parse } from "@babel/parser";
 //#region src/tsx-tracer.ts

package/dist/unsubscribe-link-CoesnQDU.js

@@ -0,0 +1,26 @@
+//#region src/internal/unsubscribe-link.ts
+/**
+* Marks the one link the serializer lets carry the unsubscribe placeholder as
+* its href. Only `BrandFooter` sets it; nothing public exports it, so no
+* author-written link can claim the exemption.
+*/
+const UNSUBSCRIBE_LINK = Symbol("samva.unsubscribe-link");
+/**
+* The per-recipient unsubscribe URL is not known at render: the send path
+* substitutes each delivery's link for this placeholder, or removes the
+* unsubscribe row when the send resolved no unsubscribe group.
+*/
+const UNSUBSCRIBE_URL_PLACEHOLDER = "%samva:unsubscribe-url%";
+/**
+* Marks the elements `BrandFooter` writes the send path's footer markers on.
+* The serializer emits `data-samva-footer` and `data-samva-unsubscribe` only
+* for an element carrying it, so an author cannot claim a footer the send
+* path would then not append.
+*/
+const BRAND_FOOTER_MARKER = Symbol("samva.brand-footer-marker");
+/** The attributes only `BrandFooter` writes. */
+const RESERVED_FOOTER_ATTRIBUTES = /* @__PURE__ */ new Set(["data-samva-footer", "data-samva-unsubscribe"]);
+//#endregion
+export { UNSUBSCRIBE_URL_PLACEHOLDER as i, RESERVED_FOOTER_ATTRIBUTES as n, UNSUBSCRIBE_LINK as r, BRAND_FOOTER_MARKER as t };
+
+//# sourceMappingURL=unsubscribe-link-CoesnQDU.js.map