@samva/markup 0.8.0 → 0.10.0

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

@@ -1,5 +1,5 @@
-import { r as JsxSource } from "../source-locations-DrCM82Ym.js";
-import { g as JSX, h as Fragment, m as EmailNode, p as EmailComponent } from "../elements-BzjjnoCS.js";
+import { n as JsxSource } from "../source-locations-C8wCsiAy.js";
+import { a as JSX, i as Fragment, n as EmailComponent, r as EmailNode } from "../jsx-runtime-ylIOnaSf.js";
 //#region src/email/jsx-dev-runtime.d.ts
 /** Development JSX retains compiler-provided origins directly on the semantic tree. */
 declare const jsxDEV: (type: string | EmailComponent<Record<string, unknown>> | typeof Fragment, props: Record<string, unknown> | null, _key?: unknown, _staticChildren?: boolean, source?: JsxSource) => EmailNode;

package/dist/email/jsx-dev-runtime.js

@@ -1,5 +1,4 @@
-import { JSX_SOURCE_LOCATION_PROP } from "../source-locations.js";
-import { Fragment, jsx } from "./jsx-runtime.js";
+import { a as jsx, n as Fragment, u as JSX_SOURCE_LOCATION_PROP } from "../jsx-runtime-CBlexoeR.js";
 //#region src/email/jsx-dev-runtime.ts
 /** Development JSX retains compiler-provided origins directly on the semantic tree. */
 const jsxDEV = (type, props, _key, _staticChildren, source) => jsx(type, {

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

@@ -1,2 +1,2 @@
-import { C as reportEmailDiagnostic, S as rawMarkup, _ as currentEmailOrigins, b as jsxs, f as EmailChild, g as JSX, h as Fragment, m as EmailNode, p as EmailComponent, v as drainEmailDiagnostics, x as normalizeChildren, y as jsx } from "../elements-BzjjnoCS.js";
+import { a as JSX, c as jsx, d as rawMarkup, f as reportEmailDiagnostic, i as Fragment, l as jsxs, n as EmailComponent, o as currentEmailOrigins, r as EmailNode, s as drainEmailDiagnostics, t as EmailChild, u as normalizeChildren } from "../jsx-runtime-ylIOnaSf.js";
 export { EmailChild, EmailComponent, EmailNode, Fragment, JSX, currentEmailOrigins, drainEmailDiagnostics, jsx, jsxs, normalizeChildren, rawMarkup, reportEmailDiagnostic };

package/dist/email/jsx-runtime.js

@@ -1,86 +1,2 @@
-import { t as hasProperty } from "../guards-eV1qLbf2.js";
-import { JSX_SOURCE_LOCATION_PROP, completeJsxSourceLocation } from "../source-locations.js";
-//#region src/email/jsx-runtime.ts
-/** Constructors for the authoring tree. The tree is data; nothing here validates it. */
-const EmailNode = {
-	Text: (fields) => ({
-		type: "Text",
-		...fields
-	}),
-	Element: (fields) => ({
-		type: "Element",
-		...fields
-	}),
-	Fragment: (fields) => ({
-		type: "Fragment",
-		...fields
-	}),
-	Raw: (fields) => ({
-		type: "Raw",
-		...fields
-	})
-};
-const EMAIL_NODE_TYPES = /* @__PURE__ */ new Set([
-	"Text",
-	"Element",
-	"Fragment",
-	"Raw"
-]);
-/** True for a node this runtime built; anything else is not a child it can place. */
-const isEmailNode = (input) => hasProperty(input, "type") && typeof input.type === "string" && EMAIL_NODE_TYPES.has(input.type);
-const Fragment = Symbol.for("@samva/markup/email/Fragment");
-const callSites = [];
-/** Call sites enclosing the element being built, innermost first. */
-const currentEmailOrigins = () => [...callSites].reverse();
-const reported = [];
-/** Record a finding from inside a compiler primitive, located at the authoring call site. */
-const reportEmailDiagnostic = (diagnostic) => {
-	reported.push({
-		...diagnostic,
-		origins: currentEmailOrigins()
-	});
-};
-/** Take and clear the findings primitives reported during a render. */
-const drainEmailDiagnostics = () => reported.splice(0);
-/** Normalize actual values without interpolation or recording proxies. */
-const normalizeChildren = (input) => {
-	if (input === null || input === void 0 || typeof input === "boolean") return [];
-	if (typeof input === "string") return [EmailNode.Text({ value: input })];
-	if (typeof input === "number" && Number.isFinite(input)) return [EmailNode.Text({ value: String(input) })];
-	if (Array.isArray(input)) return input.flatMap(normalizeChildren);
-	if (isEmailNode(input)) return [input];
-	throw new TypeError("Email children must be synchronous text, finite numbers, elements, or arrays");
-};
-/** Compatibility markup emitted by a compiler primitive, with the text it stands for. */
-const rawMarkup = (html, text = "") => EmailNode.Raw({
-	html,
-	text,
-	origins: currentEmailOrigins()
-});
-/** Automatic JSX factory for ordinary HTML and synchronous imported components. */
-const jsx = (type, props) => {
-	const { children, [JSX_SOURCE_LOCATION_PROP]: source, ...attributes } = props ?? {};
-	const origin = completeJsxSourceLocation(source);
-	if (type === Fragment) return EmailNode.Fragment({ children: normalizeChildren(children) });
-	if (typeof type === "string") return EmailNode.Element({
-		tag: type,
-		props: attributes,
-		children: normalizeChildren(children),
-		origins: origin === void 0 ? currentEmailOrigins() : [origin, ...currentEmailOrigins()],
-		authored: origin !== void 0
-	});
-	if (origin !== void 0) callSites.push(origin);
-	try {
-		return EmailNode.Fragment({ children: normalizeChildren(type({
-			...attributes,
-			children
-		})) });
-	} finally {
-		if (origin !== void 0) callSites.pop();
-	}
-};
-const jsxs = jsx;
-//#endregion
+import { a as jsx, c as rawMarkup, i as drainEmailDiagnostics, l as reportEmailDiagnostic, n as Fragment, o as jsxs, r as currentEmailOrigins, s as normalizeChildren, t as EmailNode } from "../jsx-runtime-CBlexoeR.js";
 export { EmailNode, Fragment, currentEmailOrigins, drainEmailDiagnostics, jsx, jsxs, normalizeChildren, rawMarkup, reportEmailDiagnostic };
-
-//# sourceMappingURL=jsx-runtime.js.map

package/dist/{email/components.d.ts → email.d.ts}

@@ -1,4 +1,4 @@
-import { c as EmailStyle, f as EmailChild, m as EmailNode } from "../elements-BzjjnoCS.js";
+import { b as EmailStyle, r as EmailNode, t as EmailChild } from "./jsx-runtime-ylIOnaSf.js";
 //#region src/email/components.d.ts
 /** Marks the hidden preview block so the renderer can read it back and the text lane can keep it. */
 declare const PREHEADER_ATTRIBUTE = "data-samva-preheader";
@@ -9,8 +9,6 @@ interface EmailProps {
   readonly dir?: "ltr" | "rtl" | undefined;
   /** Document title; several clients use it as the fallback preview line. */
   readonly title?: string | undefined;
-  /** Hidden preview text shown in the inbox list next to the subject. */
-  readonly preheader?: string | undefined;
   readonly backgroundColor?: string | undefined;
   /** Applied to the content cell, where Yahoo and AOL keep body styling. */
   readonly style?: EmailStyle | undefined;
@@ -19,7 +17,7 @@ interface EmailProps {
 /** The hidden inbox preview block. Padding characters stop the client borrowing body copy. */
 declare const preheaderNode: (text: string) => EmailNode;
 /** Document shell: the head every target client needs, plus the body content cell. */
-declare const Email: ({ className, lang, dir, title, preheader, backgroundColor, style, children }: EmailProps) => EmailNode;
+declare const Email: ({ className, lang, dir, title, backgroundColor, style, children }: EmailProps) => EmailNode;
 interface SectionProps {
   /** CSS classes applied to the primitive's content element. */
   readonly className?: string | undefined;
@@ -33,17 +31,30 @@ interface SectionProps {
 }
 /** A full-width band of content, as the single-cell table every client agrees on. */
 declare const Section: ({ className, align, width, bgcolor, style, tableStyle, children }: SectionProps) => EmailNode;
-interface ColumnsProps {
+interface ColumnsProps<Item = never> {
   /** CSS classes applied to the primitive's content element. */
   readonly className?: string | undefined;
   readonly align?: "left" | "center" | "right" | undefined;
   readonly width?: number | string | undefined;
   readonly style?: EmailStyle | undefined;
-  /** `Column` elements; anything else is a content-model error. */
-  readonly children?: EmailChild;
+  /**
+   * Repeat the cells for each item: `children` is then a function from an item (and its index in
+   * the row) to a `Column`. Without `per` all items share one row.
+   */
+  readonly each?: readonly Item[] | undefined;
+  /** With `each`, the cells in a row; each chunk of items is its own `Columns` table. */
+  readonly per?: number | undefined;
+  /** `Column` elements, or with `each` a function that returns one. */
+  readonly children?: EmailChild | ((item: Item, index: number) => EmailChild);
 }
-/** A row of side-by-side `Column`s. No flex or grid conversion happens here. */
-declare const Columns: ({ className, align, width, style, children }: ColumnsProps) => EmailNode;
+/** The equal share of a row that each of `count` cells takes, whole percent rounded down. */
+declare const equalColumnWidth: (count: number) => string;
+/**
+ * A row of side-by-side `Column`s. No flex or grid conversion happens here. With `each` it repeats
+ * its cells over a list, `per` to a row, and splits the row equally between cells that state no
+ * width.
+ */
+declare const Columns: <Item = never>({ className, align, width, style, each, per, children }: ColumnsProps<Item>) => EmailNode;
 interface ColumnProps {
   /** CSS classes applied to the primitive's content element. */
   readonly className?: string | undefined;
@@ -121,5 +132,5 @@ interface LinkProps {
 /** A text link that opens outside the client and cannot reach back at the opener. */
 declare const Link: ({ className, href, target, rel, style, children }: LinkProps) => EmailNode;
 //#endregion
-export { Button, ButtonProps, Column, ColumnProps, Columns, ColumnsProps, Divider, DividerProps, Email, EmailProps, Image, ImageProps, Link, LinkProps, PREHEADER_ATTRIBUTE, Section, SectionProps, Spacer, SpacerProps, preheaderNode };
-//# sourceMappingURL=components.d.ts.map
+export { Button, ButtonProps, Column, ColumnProps, Columns, ColumnsProps, Divider, DividerProps, Email, EmailProps, Image, ImageProps, Link, LinkProps, PREHEADER_ATTRIBUTE, Section, SectionProps, Spacer, SpacerProps, equalColumnWidth, preheaderNode };
+//# sourceMappingURL=email.d.ts.map

package/dist/email.js

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

package/dist/fmt.d.ts

@@ -0,0 +1,32 @@
+//#region src/fmt.d.ts
+declare const DEFAULT_LOCALE = "en-US";
+declare const DEFAULT_TIME_ZONE = "UTC";
+interface FormatContext {
+  readonly locale?: string | undefined;
+  readonly timeZone?: string | undefined;
+}
+type DateStyle = "short" | "medium" | "long" | "full";
+interface PluralForms {
+  readonly zero?: string;
+  readonly one?: string;
+  readonly two?: string;
+  readonly few?: string;
+  readonly many?: string;
+  readonly other: string;
+}
+interface Fmt {
+  money(amount: number, currency: string, locale?: string): string;
+  number(value: number, options?: Intl.NumberFormatOptions, locale?: string): string;
+  date(iso: string, style?: DateStyle, locale?: string): string;
+  time(iso: string, style?: DateStyle, locale?: string): string;
+  plural(count: number, forms: PluralForms, locale?: string): string;
+  list(values: readonly string[], locale?: string): string;
+}
+declare const FORMATTER_NAMES: readonly ["money", "number", "date", "time", "plural", "list"];
+declare const createFmt: (context?: FormatContext) => Fmt;
+declare const withFormatContext: <T>(context: FormatContext, run: () => T) => T;
+declare const fmt: Fmt;
+declare const callFormatter: (formatter: Fmt, name: string, args: readonly unknown[]) => string;
+//#endregion
+export { DEFAULT_LOCALE, DEFAULT_TIME_ZONE, DateStyle, FORMATTER_NAMES, Fmt, FormatContext, PluralForms, callFormatter, createFmt, fmt, withFormatContext };
+//# sourceMappingURL=fmt.d.ts.map

package/dist/fmt.js

@@ -0,0 +1,174 @@
+//#region src/fmt.ts
+const DEFAULT_LOCALE = "en-US";
+const DEFAULT_TIME_ZONE = "UTC";
+const FORMATTER_NAMES = [
+	"money",
+	"number",
+	"date",
+	"time",
+	"plural",
+	"list"
+];
+const CACHE_LIMIT = 200;
+const cache = /* @__PURE__ */ new Map();
+const cached = (kind, locale, options, make) => {
+	const key = `${kind}\u0000${locale}\u0000${options === void 0 ? "" : JSON.stringify(options)}`;
+	const hit = cache.get(key);
+	if (hit !== void 0) return hit;
+	const value = make();
+	if (cache.size >= CACHE_LIMIT) cache.clear();
+	cache.set(key, value);
+	return value;
+};
+const assertFinite = (value, what) => {
+	if (typeof value !== "number" || !Number.isFinite(value)) throw new TypeError(`${what} must be a finite number.`);
+};
+const DATE_ONLY = /^\d{4}-\d{2}-\d{2}$/;
+const parseIso = (iso) => {
+	if (typeof iso !== "string") throw new TypeError("ISO date must be a string.");
+	const date = new Date(DATE_ONLY.test(iso) ? `${iso}T00:00:00Z` : iso);
+	if (Number.isNaN(date.getTime())) throw new RangeError(`Cannot parse "${iso}" as an ISO 8601 date.`);
+	return date;
+};
+const createFmt = (context = {}) => {
+	const defaultLocale = context.locale ?? "en-US";
+	const timeZone = context.timeZone ?? "UTC";
+	const pick = (locale) => locale ?? defaultLocale;
+	return {
+		money: (amount, currency, locale) => {
+			assertFinite(amount, "money amount");
+			const l = pick(locale);
+			return cached("money", l, currency, () => new Intl.NumberFormat(l, {
+				style: "currency",
+				currency
+			})).format(amount);
+		},
+		number: (value, options, locale) => {
+			assertFinite(value, "number value");
+			const l = pick(locale);
+			return cached("number", l, options, () => new Intl.NumberFormat(l, options)).format(value);
+		},
+		date: (iso, style = "medium", locale) => {
+			const d = parseIso(iso);
+			const l = pick(locale);
+			return cached("date", l, {
+				style,
+				timeZone
+			}, () => new Intl.DateTimeFormat(l, {
+				dateStyle: style,
+				timeZone
+			})).format(d);
+		},
+		time: (iso, style = "short", locale) => {
+			const d = parseIso(iso);
+			const l = pick(locale);
+			return cached("time", l, {
+				style,
+				timeZone
+			}, () => new Intl.DateTimeFormat(l, {
+				timeStyle: style,
+				timeZone
+			})).format(d);
+		},
+		plural: (count, forms, locale) => {
+			assertFinite(count, "plural count");
+			const l = pick(locale);
+			return forms[cached("plural", l, void 0, () => new Intl.PluralRules(l)).select(count)] ?? forms.other;
+		},
+		list: (values, locale) => {
+			const l = pick(locale);
+			return cached("list", l, void 0, () => new Intl.ListFormat(l, {
+				type: "conjunction",
+				style: "long"
+			})).format(values);
+		}
+	};
+};
+let ambient = {};
+const withFormatContext = (context, run) => {
+	const previous = ambient;
+	ambient = context;
+	try {
+		return run();
+	} finally {
+		ambient = previous;
+	}
+};
+const fmt = {
+	money: (a, c, l) => createFmt(ambient).money(a, c, l),
+	number: (v, o, l) => createFmt(ambient).number(v, o, l),
+	date: (i, s, l) => createFmt(ambient).date(i, s, l),
+	time: (i, s, l) => createFmt(ambient).time(i, s, l),
+	plural: (c, f, l) => createFmt(ambient).plural(c, f, l),
+	list: (v, l) => createFmt(ambient).list(v, l)
+};
+const STYLES = [
+	"short",
+	"medium",
+	"long",
+	"full"
+];
+const PLURAL_KEYS = [
+	"zero",
+	"one",
+	"two",
+	"few",
+	"many",
+	"other"
+];
+const arity = (name, args, min, max) => {
+	if (args.length < min || args.length > max) {
+		const expected = min === max ? `${min}` : `${min} to ${max}`;
+		throw new TypeError(`${name} takes ${expected} arguments but received ${args.length}.`);
+	}
+};
+const str = (name, index, value, optional = false) => {
+	if (value === void 0 && optional) return void 0;
+	if (typeof value !== "string") throw new TypeError(`${name} argument ${index + 1} must be a string.`);
+	return value;
+};
+const num = (name, index, value) => {
+	if (typeof value !== "number" || !Number.isFinite(value)) throw new TypeError(`${name} argument ${index + 1} must be a finite number.`);
+	return value;
+};
+const style = (name, index, value) => {
+	if (value === void 0) return void 0;
+	if (typeof value !== "string" || !STYLES.includes(value)) throw new TypeError(`${name} argument ${index + 1} must be one of ${STYLES.join(", ")}.`);
+	return value;
+};
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const callFormatter = (formatter, name, args) => {
+	switch (name) {
+		case "money":
+			arity(name, args, 2, 3);
+			return formatter.money(num(name, 0, args[0]), str(name, 1, args[1]), str(name, 2, args[2], true));
+		case "number": {
+			arity(name, args, 1, 3);
+			const options = args[1];
+			if (options !== void 0 && !isRecord(options)) throw new TypeError("number argument 2 must be an options object.");
+			return formatter.number(num(name, 0, args[0]), options, str(name, 2, args[2], true));
+		}
+		case "date":
+		case "time":
+			arity(name, args, 1, 3);
+			return formatter[name](str(name, 0, args[0]), style(name, 1, args[1]), str(name, 2, args[2], true));
+		case "plural": {
+			arity(name, args, 2, 3);
+			const forms = args[1];
+			if (!isRecord(forms) || typeof forms.other !== "string") throw new TypeError("plural argument 2 must be an object with a string `other` form.");
+			for (const key of PLURAL_KEYS) if (forms[key] !== void 0 && typeof forms[key] !== "string") throw new TypeError(`plural argument 2 form \`${key}\` must be a string.`);
+			return formatter.plural(num(name, 0, args[0]), forms, str(name, 2, args[2], true));
+		}
+		case "list": {
+			arity(name, args, 1, 2);
+			const values = args[0];
+			if (!Array.isArray(values) || values.some((v) => typeof v !== "string")) throw new TypeError("list argument 1 must be an array of strings.");
+			return formatter.list(values, str(name, 1, args[1], true));
+		}
+		default: throw new TypeError(`Unknown formatter "${name}".`);
+	}
+};
+//#endregion
+export { DEFAULT_LOCALE, DEFAULT_TIME_ZONE, FORMATTER_NAMES, callFormatter, createFmt, fmt, withFormatContext };
+
+//# sourceMappingURL=fmt.js.map

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+import { i as TEMPLATE_ID_PATTERN, o as TemplateInput, r as SmlTemplate, s as defineTemplate, t as EmailChannel } from "./template-DMPwxMSq.js";
+export { type EmailChannel, type SmlTemplate, TEMPLATE_ID_PATTERN, type TemplateInput, defineTemplate };

package/dist/index.js

@@ -0,0 +1,2 @@
+import { r as defineTemplate, t as TEMPLATE_ID_PATTERN } from "./template-zLUjcwfF.js";
+export { TEMPLATE_ID_PATTERN, defineTemplate };