@samva/markup 0.7.0 → 0.9.0

package/dist/footer.d.ts

@@ -1,66 +0,0 @@
-import { s as TokenTable } from "./theme-6ApjjiBo.js";
-//#region src/footer.d.ts
-/** The per-recipient unsubscribe URL is not known at accept time (the body is
- * shared across a send's deliveries), so the footer is composed with this
- * placeholder in the unsubscribe href and the plain-text tail. The email queue
- * processor substitutes each delivery's minted token URL at dispatch. The link
- * carries `ses:no-track` so click tracking never rewrites (and thereby breaks)
- * the placeholder. */
-declare const FOOTER_UNSUBSCRIBE_PLACEHOLDER = "%samva:unsubscribe-url%";
-/** One labelled social link. Structurally mirrors `DesignSocialLink`. */
-interface FooterSocialLink {
-  readonly label: string;
-  readonly url: string;
-}
-/** A structured postal address. Structurally mirrors `DesignAddress`. */
-interface FooterAddress {
-  readonly street1: string;
-  readonly street2?: string | undefined;
-  readonly city: string;
-  readonly region: string;
-  readonly postalCode: string;
-  readonly country: string;
-}
-/** The effective footer content. Structurally mirrors `DesignFooter`. */
-interface FooterContent {
-  readonly companyName?: string | undefined;
-  readonly address?: FooterAddress | undefined;
-  readonly socialLinks?: ReadonlyArray<FooterSocialLink> | undefined;
-  readonly customHtml?: string | undefined;
-}
-/** Which compliance-relevant footer fields the effective content is missing,
- *  surfaced on the design read path for the dashboard's footer nudge. */
-interface FooterCompleteness {
-  /** No physical mailing address is set anywhere in the cascade (CAN-SPAM). */
-  readonly missingAddress: boolean;
-}
-interface RenderedFooter {
-  /** Table-based footer block, ready to inject before the body's `</body>`. */
-  readonly html: string;
-  /** Plain-text footer tail, appended to the text alternative. */
-  readonly text: string;
-  readonly completeness: FooterCompleteness;
-}
-/**
- * Which compliance-relevant fields the footer content lacks — the signal the
- * dashboard's footer nudge reads. Derivable from `design.footer` alone (no token table),
- * so the design read path can report it without composing the block. A
- * `customHtml` footer is treated as complete (the org owns its own content).
- */
-declare const footerCompleteness: (footer: FooterContent | undefined) => FooterCompleteness;
-/**
- * Compose the injected footer for one send. `unsubscribeUrl` is the placeholder
- * (`FOOTER_UNSUBSCRIBE_PLACEHOLDER`) when a group resolved and dispatch will
- * mint the per-recipient link, or `null` to omit the unsubscribe row entirely
- * (no group resolved). Never throws and never blocks: whatever content exists
- * renders, and the missing pieces are reported via `completeness`.
- */
-declare const renderFooterBlock: (input: {
-  readonly footer: FooterContent;
-  readonly tokens: TokenTable;
-  readonly unsubscribeUrl: string | null;
-  readonly unsubscribeLabel?: string | undefined;
-}) => RenderedFooter;
-//#endregion
-export { FOOTER_UNSUBSCRIBE_PLACEHOLDER, FooterAddress, FooterCompleteness, FooterContent, FooterSocialLink, RenderedFooter, footerCompleteness, renderFooterBlock };
-//# sourceMappingURL=footer.d.ts.map

package/dist/footer.js

@@ -1,93 +0,0 @@
-//#region src/footer.ts
-/** The per-recipient unsubscribe URL is not known at accept time (the body is
-* shared across a send's deliveries), so the footer is composed with this
-* placeholder in the unsubscribe href and the plain-text tail. The email queue
-* processor substitutes each delivery's minted token URL at dispatch. The link
-* carries `ses:no-track` so click tracking never rewrites (and thereby breaks)
-* the placeholder. */
-const FOOTER_UNSUBSCRIBE_PLACEHOLDER = "%samva:unsubscribe-url%";
-const escapeText = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
-const escapeAttribute = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll("\"", "&quot;").replaceAll("'", "&#39;");
-const isSafeUrl = (url) => /^(https?:|mailto:)/i.test(url.trim());
-const addressLines = (address) => {
-	const region = [
-		address.city,
-		address.region,
-		address.postalCode
-	].filter(Boolean).join(", ");
-	return [
-		address.street1,
-		address.street2,
-		region,
-		address.country
-	].filter((line) => typeof line === "string" && line.trim().length > 0);
-};
-/**
-* Which compliance-relevant fields the footer content lacks — the signal the
-* dashboard's footer nudge reads. Derivable from `design.footer` alone (no token table),
-* so the design read path can report it without composing the block. A
-* `customHtml` footer is treated as complete (the org owns its own content).
-*/
-const footerCompleteness = (footer) => ({ missingAddress: footer?.customHtml === void 0 && (footer?.address === void 0 || addressLines(footer.address).length === 0) });
-/**
-* Compose the injected footer for one send. `unsubscribeUrl` is the placeholder
-* (`FOOTER_UNSUBSCRIBE_PLACEHOLDER`) when a group resolved and dispatch will
-* mint the per-recipient link, or `null` to omit the unsubscribe row entirely
-* (no group resolved). Never throws and never blocks: whatever content exists
-* renders, and the missing pieces are reported via `completeness`.
-*/
-const renderFooterBlock = (input) => {
-	const { footer, tokens, unsubscribeUrl } = input;
-	const unsubscribeLabel = input.unsubscribeLabel ?? "Unsubscribe";
-	const fontFamily = tokens.fontFamilies["body"] ?? tokens.fontFamilies["sans"] ?? "sans-serif";
-	const mutedColor = tokens.colors["gray-500"] ?? tokens.colors["neutral-500"] ?? "#6a7282";
-	const linkColor = tokens.colors["brand"] ?? mutedColor;
-	const containerPx = tokens.containerPx["xl"] ?? 600;
-	const fontSizePx = tokens.text["xs"]?.sizePx ?? 12;
-	const lineHeightPx = tokens.text["xs"]?.lineHeightPx ?? 18;
-	const fontFamilyAttribute = escapeAttribute(fontFamily);
-	const mutedColorAttribute = escapeAttribute(mutedColor);
-	const linkColorAttribute = escapeAttribute(linkColor);
-	const rows = [];
-	const textLines = [];
-	if (typeof footer.customHtml === "string" && footer.customHtml.trim().length > 0) rows.push(`<tr><td style="padding:0 0 12px 0;">${footer.customHtml}</td></tr>`);
-	else {
-		if (typeof footer.companyName === "string" && footer.companyName.trim().length > 0) {
-			rows.push(`<tr><td style="padding:0 0 4px 0;font-weight:600;">${escapeText(footer.companyName)}</td></tr>`);
-			textLines.push(footer.companyName);
-		}
-		if (footer.address !== void 0) {
-			const lines = addressLines(footer.address);
-			if (lines.length > 0) {
-				rows.push(`<tr><td style="padding:0 0 8px 0;">${lines.map(escapeText).join("<br />")}</td></tr>`);
-				textLines.push(lines.join(", "));
-			}
-		}
-		if (footer.socialLinks !== void 0 && footer.socialLinks.length > 0) {
-			const links = footer.socialLinks.map((link) => isSafeUrl(link.url) ? `<a href="${escapeAttribute(link.url.trim())}" style="color:${linkColorAttribute};text-decoration:underline;" ses:no-track>${escapeText(link.label)}</a>` : escapeText(link.label));
-			rows.push(`<tr><td style="padding:0 0 8px 0;">${links.join("<span style=\"padding:0 6px;\">·</span>")}</td></tr>`);
-			textLines.push(footer.socialLinks.map((link) => `${link.label}: ${link.url}`).join("  "));
-		}
-	}
-	if (unsubscribeUrl !== null) {
-		rows.push(`<tr><td style="padding:0;"><a href="${escapeAttribute(unsubscribeUrl)}" style="color:${mutedColorAttribute};text-decoration:underline;" ses:no-track>${escapeText(unsubscribeLabel)}</a></td></tr>`);
-		textLines.push(`${unsubscribeLabel}: ${unsubscribeUrl}`);
-	}
-	return {
-		html: rows.length === 0 ? "" : [
-			`<table role="presentation" cellpadding="0" cellspacing="0" border="0" width="100%" style="width:100%;border-collapse:collapse;">`,
-			`<tr><td align="center" style="padding:32px 16px;">`,
-			`<table role="presentation" cellpadding="0" cellspacing="0" border="0" width="${containerPx}" style="width:100%;max-width:${containerPx}px;border-collapse:collapse;font-family:${fontFamilyAttribute};font-size:${fontSizePx}px;line-height:${lineHeightPx}px;color:${mutedColorAttribute};text-align:center;">`,
-			...rows,
-			`</table>`,
-			`</td></tr>`,
-			`</table>`
-		].join(""),
-		text: textLines.length === 0 ? "" : `\n\n---\n${textLines.join("\n")}`,
-		completeness: footerCompleteness(footer)
-	};
-};
-//#endregion
-export { FOOTER_UNSUBSCRIBE_PLACEHOLDER, footerCompleteness, renderFooterBlock };
-
-//# sourceMappingURL=footer.js.map

package/dist/interpolate.d.ts

@@ -1,24 +0,0 @@
-//#region src/interpolate.d.ts
-type DocumentVariableType = "string" | "number" | "boolean" | "date" | "array" | "object";
-/** One entry of a template's declared variable schema. */
-interface DocumentVariable {
-  readonly name: string;
-  readonly type: DocumentVariableType;
-  readonly required: boolean;
-  readonly default?: unknown;
-  readonly description?: string | undefined;
-}
-declare const variableReferencePattern: RegExp;
-declare const getVariableValue: (variables: Record<string, unknown>, variableSchema: ReadonlyArray<DocumentVariable>, name: string) => unknown;
-declare const stringifyVariable: (value: unknown) => string;
-interface InterpolationResult {
-  readonly rendered: string;
-  /** Required variables that resolved to nothing (no value, no default). */
-  readonly missing: ReadonlySet<string>;
-}
-declare const interpolate: (text: string, variables: Record<string, unknown>, variableSchema: ReadonlyArray<DocumentVariable>) => InterpolationResult;
-declare const variableReferences: (text: string) => Set<string>;
-declare const addVariableReferences: (target: Set<string>, text: string) => void;
-//#endregion
-export { DocumentVariable, DocumentVariableType, InterpolationResult, addVariableReferences, getVariableValue, interpolate, stringifyVariable, variableReferencePattern, variableReferences };
-//# sourceMappingURL=interpolate.d.ts.map

package/dist/interpolate.js

@@ -1,43 +0,0 @@
-//#region src/interpolate.ts
-const variableReferencePattern = /\$\{\s*\/?([\w.]+)\s*\}|\{\{\s*([\w.]+)\s*\}\}/g;
-const getVariableValue = (variables, variableSchema, name) => {
-	const schema = variableSchema.find((item) => item.name === name);
-	const value = variables[name];
-	if (value !== void 0 && value !== null) return value;
-	return schema?.default;
-};
-const stringifyVariable = (value) => {
-	if (value === void 0 || value === null) return "";
-	if (value instanceof Date) return value.toISOString();
-	if (Array.isArray(value)) return value.join(", ");
-	if (typeof value === "object") return JSON.stringify(value);
-	return String(value);
-};
-const interpolate = (text, variables, variableSchema) => {
-	const missing = /* @__PURE__ */ new Set();
-	const substitute = (name) => {
-		const value = getVariableValue(variables, variableSchema, name);
-		const schema = variableSchema.find((item) => item.name === name);
-		if ((value === void 0 || value === null) && schema?.required) missing.add(name);
-		return stringifyVariable(value);
-	};
-	return {
-		rendered: text.replace(variableReferencePattern, (_match, dollarName, braceName) => substitute(dollarName ?? braceName ?? "")),
-		missing
-	};
-};
-const variableReferences = (text) => {
-	const names = /* @__PURE__ */ new Set();
-	for (const match of text.matchAll(variableReferencePattern)) {
-		const name = match[1] ?? match[2];
-		if (name !== void 0 && name !== "") names.add(name);
-	}
-	return names;
-};
-const addVariableReferences = (target, text) => {
-	variableReferences(text).forEach((name) => target.add(name));
-};
-//#endregion
-export { addVariableReferences, getVariableValue, interpolate, stringifyVariable, variableReferencePattern, variableReferences };
-
-//# sourceMappingURL=interpolate.js.map

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

@@ -1,11 +0,0 @@
-import { r as JsxSource } from "./source-locations-DrCM82Ym.js";
-import { a as JsxResult, i as JSX, n as Fragment, t as Component } from "./jsx-runtime-I-1nCtl2.js";
-//#region src/jsx-dev-runtime.d.ts
-interface JsxDevProps {
-  readonly children?: unknown;
-  readonly [key: string]: unknown;
-}
-declare const jsxDEV: <P>(type: Component<P> | typeof Fragment, props: P, _key?: string | number | null, _isStaticChildren?: boolean, source?: JsxSource | null, _self?: unknown) => JsxResult;
-//#endregion
-export { Fragment, type JSX, JsxDevProps, jsxDEV };
-//# sourceMappingURL=jsx-dev-runtime.d.ts.map

package/dist/jsx-dev-runtime.js

@@ -1,15 +0,0 @@
-import { attachJsxSourceLocation, completeJsxSourceLocation } from "./source-locations.js";
-import { Fragment, jsx } from "./jsx-runtime.js";
-//#region src/jsx-dev-runtime.ts
-const jsxDEV = (type, props, _key, _isStaticChildren, source, _self) => {
-	const result = jsx(type, props);
-	if (type !== Fragment && result.kind === "element") {
-		const location = completeJsxSourceLocation(source);
-		if (location !== void 0) attachJsxSourceLocation(result, location);
-	}
-	return result;
-};
-//#endregion
-export { Fragment, jsxDEV };
-
-//# sourceMappingURL=jsx-dev-runtime.js.map

package/dist/jsx-runtime-I-1nCtl2.d.ts

@@ -1,57 +0,0 @@
-import { f as ElementNode, n as Attribute, x as SmlNode } from "./ast-BrDtApwS.js";
-import { s as VariableRef } from "./variables-J_L3qxRa.js";
-//#region src/jsx-runtime.d.ts
-/** A component is a plain function of its props that returns a draft node. */
-type Component<P> = (props: P) => SmlNode;
-/**
- * What may appear in a component's `children`. Booleans/null/undefined are
- * skipped (so `{cond && <X/>}` and `{cond ? <A/> : null}` are BUILD-TIME
- * conditionals that evaluate away); strings/numbers become text; VariableRefs
- * become `{{interpolation}}` nodes; arrays flatten; nested nodes nest. Anything
- * else is a typed authoring error.
- */
-type SmlChild = SmlNode | FragmentDraft | VariableRef<unknown> | string | number | boolean | null | undefined | ReadonlyArray<SmlChild>;
-type SmlChildren = SmlChild | ReadonlyArray<SmlChild>;
-/** Fragment children pass through un-wrapped — a Fragment is not an element. */
-interface FragmentDraft {
-  readonly kind: "fragment";
-  readonly children: ReadonlyArray<SmlNode>;
-}
-type JsxResult = SmlNode | FragmentDraft;
-/**
- * Flattens and normalizes a component's raw `children` prop into AST child
- * nodes. Fragments splice their children in; booleans/null/undefined drop out.
- */
-declare const normalizeChildren: (children: unknown) => Array<SmlNode>;
-/**
- * Builds an element draft from a tag, attribute list (already in authored
- * order), and normalized children. Kept here so the runtime owns the AST shape;
- * ./components maps typed props onto attributes and calls this.
- */
-declare const elementDraft: (tag: ElementNode["tag"], attributes: ReadonlyArray<Attribute>, children: ReadonlyArray<SmlNode>) => ElementNode;
-interface JsxProps {
-  readonly children?: unknown;
-  readonly [key: string]: unknown;
-}
-/**
- * The automatic-runtime entry point. `type` is always one of our typed
- * component functions (or `Fragment`); we invoke it with its props. The JSX
- * transform routes single-child elements here and multi-child elements to
- * `jsxs` — behaviour is identical for us (components normalize their own
- * children), so `jsxs` re-exports this.
- */
-declare const jsx: (type: Component<JsxProps> | typeof Fragment, props: JsxProps) => JsxResult;
-declare const jsxs: typeof jsx;
-/** Groups children without an element wrapper. Its children splice into the parent. */
-declare const Fragment: unique symbol;
-declare namespace JSX {
-  type Element = JsxResult;
-  type ElementType = Component<never> | typeof Fragment;
-  interface ElementChildrenAttribute {
-    readonly children: object;
-  }
-  type IntrinsicElements = Record<string, never>;
-}
-//#endregion
-export { JsxResult as a, elementDraft as c, normalizeChildren as d, JSX as i, jsx as l, Fragment as n, SmlChild as o, FragmentDraft as r, SmlChildren as s, Component as t, jsxs as u };
-//# sourceMappingURL=jsx-runtime-I-1nCtl2.d.ts.map

package/dist/jsx-runtime.d.ts

@@ -1,2 +0,0 @@
-import { a as JsxResult, c as elementDraft, d as normalizeChildren, i as JSX, l as jsx, n as Fragment, o as SmlChild, r as FragmentDraft, s as SmlChildren, t as Component, u as jsxs } from "./jsx-runtime-I-1nCtl2.js";
-export { Component, Fragment, FragmentDraft, JSX, JsxResult, SmlChild, SmlChildren, elementDraft, jsx, jsxs, normalizeChildren };

package/dist/jsx-runtime.js

@@ -1,121 +0,0 @@
-import { t as hasProperty } from "./guards-eV1qLbf2.js";
-import { JSX_SOURCE_LOCATION_PROP, attachJsxSourceLocation, completeJsxSourceLocation } from "./source-locations.js";
-import { VARIABLE_REF, isVariableRef } from "./variables.js";
-//#region src/jsx-runtime.ts
-const PLACEHOLDER_SPAN = {
-	start: 0,
-	end: 0
-};
-const isFragmentDraft = (value) => hasProperty(value, "kind") && value.kind === "fragment";
-const isSmlNode = (value) => {
-	if (!hasProperty(value, "kind")) return false;
-	const kind = value.kind;
-	return kind === "element" || kind === "text" || kind === "interpolation";
-};
-const textNode = (value) => ({
-	kind: "text",
-	id: "",
-	value,
-	span: PLACEHOLDER_SPAN
-});
-const interpolationNode = (ref) => ({
-	kind: "interpolation",
-	id: "",
-	name: ref[VARIABLE_REF].path,
-	syntax: "curly",
-	span: PLACEHOLDER_SPAN
-});
-/**
-* Flattens and normalizes a component's raw `children` prop into AST child
-* nodes. Fragments splice their children in; booleans/null/undefined drop out.
-*/
-const normalizeChildren = (children) => {
-	const out = [];
-	const push = (child) => {
-		if (child === null || child === void 0 || typeof child === "boolean") return;
-		if (typeof child === "string") {
-			out.push(textNode(child));
-			return;
-		}
-		if (typeof child === "number") {
-			out.push(textNode(String(child)));
-			return;
-		}
-		if (Array.isArray(child)) {
-			for (const item of child) push(item);
-			return;
-		}
-		if (isVariableRef(child)) {
-			out.push(interpolationNode(child));
-			return;
-		}
-		if (isFragmentDraft(child)) {
-			for (const node of child.children) out.push(node);
-			return;
-		}
-		if (isSmlNode(child)) {
-			out.push(child);
-			return;
-		}
-		throw new TypeError(`invalid SML child: ${describe(child)} — children may be text, numbers, variables, elements, arrays of these, or false/null/undefined (which are skipped)`);
-	};
-	push(children);
-	return out;
-};
-const describe = (value) => {
-	if (typeof value === "function") return "a function (did you pass a component instead of an element?)";
-	if (typeof value === "object") return `an object (${JSON.stringify(value)})`;
-	return `${typeof value} (${JSON.stringify(value)})`;
-};
-/**
-* Builds an element draft from a tag, attribute list (already in authored
-* order), and normalized children. Kept here so the runtime owns the AST shape;
-* ./components maps typed props onto attributes and calls this.
-*/
-const elementDraft = (tag, attributes, children) => ({
-	kind: "element",
-	id: "",
-	tag,
-	attributes,
-	children,
-	span: PLACEHOLDER_SPAN
-});
-const stripSourceLocation = (props) => {
-	const source = props[JSX_SOURCE_LOCATION_PROP];
-	if (source === void 0) return {
-		props,
-		source: void 0
-	};
-	const { [JSX_SOURCE_LOCATION_PROP]: _source, ...rest } = props;
-	return {
-		props: rest,
-		source
-	};
-};
-/**
-* The automatic-runtime entry point. `type` is always one of our typed
-* component functions (or `Fragment`); we invoke it with its props. The JSX
-* transform routes single-child elements here and multi-child elements to
-* `jsxs` — behaviour is identical for us (components normalize their own
-* children), so `jsxs` re-exports this.
-*/
-const jsx = (type, props) => {
-	if (type === Fragment) return {
-		kind: "fragment",
-		children: normalizeChildren(props.children)
-	};
-	const { props: cleanProps, source } = stripSourceLocation(props);
-	const result = type(cleanProps);
-	if (source !== void 0 && result.kind === "element") {
-		const location = completeJsxSourceLocation(source);
-		if (location !== void 0) attachJsxSourceLocation(result, location);
-	}
-	return result;
-};
-const jsxs = jsx;
-/** Groups children without an element wrapper. Its children splice into the parent. */
-const Fragment = Symbol.for("@samva/markup/Fragment");
-//#endregion
-export { Fragment, elementDraft, jsx, jsxs, normalizeChildren };
-
-//# sourceMappingURL=jsx-runtime.js.map

package/dist/lexer.d.ts

@@ -1,60 +0,0 @@
-//#region src/lexer.d.ts
-declare const TokenKind: {
-  readonly EndOfFile: 0;
-  /** `<` opening a start tag (text mode). */
-  readonly LessThan: 1;
-  /** `</` opening a close tag (text mode). */
-  readonly LessThanSlash: 2;
-  readonly GreaterThan: 3;
-  readonly SlashGreaterThan: 4;
-  readonly Identifier: 5;
-  readonly Equals: 6;
-  /** Quoted attribute value; getStringValue decodes entities. */
-  readonly String: 7;
-  readonly OpenBrace: 8;
-  readonly CloseBrace: 9;
-  /** Unsigned integer inside a brace attribute value. */
-  readonly Number: 10;
-  /** Raw text run; getTextValue decodes entities. */
-  readonly Text: 11;
-  /** `{{name}}` or `${name}`; name/syntax carried on the token. */
-  readonly Interpolation: 12;
-  /** Lexically invalid input; error carried on the token. */
-  readonly Unknown: 13;
-};
-type TokenKind = (typeof TokenKind)[keyof typeof TokenKind];
-interface TokenError {
-  readonly code: string;
-  readonly message: string;
-}
-interface Token {
-  readonly kind: TokenKind;
-  readonly start: number;
-  readonly end: number;
-  /** Interpolation only. */
-  readonly name?: string | undefined;
-  /** Interpolation only. */
-  readonly syntax?: "curly" | "dollar" | undefined;
-  /** Unknown only. */
-  readonly error?: TokenError | undefined;
-}
-/** Decodes entities in text that already passed `scanEntity` validation. */
-declare const decodeEntities: (raw: string) => string;
-interface Lexer {
-  /** Current scan position (start of the next token). */
-  readonly position: () => number;
-  /** Scan one token in text mode (between tags). */
-  readonly scanTextToken: () => Token;
-  /** Scan one token in tag mode (inside `<...>`), skipping whitespace. */
-  readonly scanTagToken: () => Token;
-  /** Lazy raw source slice for a token. */
-  readonly getText: (token: Token) => string;
-  /** Entity-decoded value of a Text token. */
-  readonly getTextValue: (token: Token) => string;
-  /** Entity-decoded contents of a String token (without quotes). */
-  readonly getStringValue: (token: Token) => string;
-}
-declare const createLexer: (source: string) => Lexer;
-//#endregion
-export { Lexer, Token, TokenError, TokenKind, createLexer, decodeEntities };
-//# sourceMappingURL=lexer.d.ts.map