@solid-email/render 0.1.1 → 0.1.2

package/dist/browser/index.cjs

@@ -26,6 +26,7 @@ let prettier_plugins_html = require("prettier/plugins/html");
 prettier_plugins_html = __toESM(prettier_plugins_html, 1);
 let prettier_standalone = require("prettier/standalone");
 let html_to_text = require("html-to-text");
+let solid_js_web = require("solid-js/web");
 //#region src/shared/utils/pretty.ts
 function getHtmlNode(path) {
 	const topNode = path.node;
@@ -154,8 +155,247 @@ function renderSync(node, options) {
 	return renderSyncOutput(removeSolidResourceScripts((0, solid_js_web_dist_server_js.renderToString)(normalizeRenderable(node))), options);
 }
 //#endregion
+//#region src/shared/slots.ts
+const MARKER_PREFIX = "__SM_";
+const CONTENT_START = `${MARKER_PREFIX}CNT_`;
+const CONTENT_END = `${MARKER_PREFIX}CNE_`;
+const ATTR_PREFIX = `${MARKER_PREFIX}ATR_`;
+function encodeName(name) {
+	return encodeURIComponent(name).replace(/[!'()*_]/g, (char) => `%${char.charCodeAt(0).toString(16).toUpperCase()}`);
+}
+function decodeName(encoded) {
+	return decodeURIComponent(encoded);
+}
+function makeContentMarker(name, defaultValue) {
+	const encoded = encodeName(name);
+	const start = `${CONTENT_START}${encoded}__`;
+	if (defaultValue !== void 0) return `${start}${defaultValue}${CONTENT_END}${encoded}__`;
+	return `${start}${CONTENT_END}${encoded}__`;
+}
+function makeAttrMarker(name) {
+	return `${ATTR_PREFIX}${encodeName(name)}__`;
+}
+function escapeRegex$1(str) {
+	return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function buildSlotLookup(html) {
+	const contentSlots = /* @__PURE__ */ new Map();
+	const attrSlots = /* @__PURE__ */ new Map();
+	const nameChars = "(?:[A-Za-z0-9.~-]|%[0-9A-Fa-f]{2})+";
+	const tokenRegex = new RegExp(`${escapeRegex$1(CONTENT_START)}(${nameChars})__|${escapeRegex$1(CONTENT_END)}(${nameChars})__`, "g");
+	const stack = [];
+	let match;
+	while (true) {
+		match = tokenRegex.exec(html);
+		if (match === null) break;
+		const startName = match[1];
+		if (startName !== void 0) {
+			stack.push({
+				encodedName: startName,
+				name: decodeName(startName),
+				startIndex: match.index,
+				contentStartIndex: tokenRegex.lastIndex
+			});
+			continue;
+		}
+		const endName = match[2];
+		if (endName === void 0) continue;
+		let openIndex = -1;
+		for (let index = stack.length - 1; index >= 0; index -= 1) if (stack[index]?.encodedName === endName) {
+			openIndex = index;
+			break;
+		}
+		if (openIndex === -1) continue;
+		const [open] = stack.splice(openIndex, 1);
+		if (open === void 0) continue;
+		const innerContent = html.slice(open.contentStartIndex, match.index);
+		const occurrence = {
+			full: html.slice(open.startIndex, tokenRegex.lastIndex),
+			hasDefault: innerContent.length > 0,
+			defaultValue: innerContent
+		};
+		const existing = contentSlots.get(open.name);
+		if (existing) existing.push(occurrence);
+		else contentSlots.set(open.name, [occurrence]);
+	}
+	const attrRegex = new RegExp(`${escapeRegex$1(ATTR_PREFIX)}(${nameChars})__`, "g");
+	while (true) {
+		match = attrRegex.exec(html);
+		if (match === null) break;
+		const name = decodeName(match[1] ?? "");
+		const existing = attrSlots.get(name);
+		if (existing) existing.push(match[0]);
+		else attrSlots.set(name, [match[0]]);
+	}
+	return {
+		content: contentSlots,
+		attr: attrSlots
+	};
+}
+function Slot(props) {
+	const encoded = encodeName(props.name);
+	const start = (0, solid_js_web.ssr)(`${CONTENT_START}${encoded}__`);
+	const end = (0, solid_js_web.ssr)(`${CONTENT_END}${encoded}__`);
+	if (props.children !== void 0 && props.children !== null) return [
+		start,
+		props.children,
+		end
+	];
+	return [start, end];
+}
+function slot(name) {
+	return makeAttrMarker(name);
+}
+function defineSlots() {
+	return {
+		content: (name, defaultValue) => makeContentMarker(name, defaultValue),
+		attr: (name) => makeAttrMarker(name)
+	};
+}
+//#endregion
+//#region src/shared/compile.ts
+var CompiledTemplate = class {
+	html;
+	options;
+	contentSlots;
+	attrSlots;
+	markerRegex;
+	constructor(html, options) {
+		this.html = html;
+		this.options = options;
+		const lookup = buildSlotLookup(html);
+		this.contentSlots = lookup.content;
+		this.attrSlots = lookup.attr;
+		this.markerRegex = this.buildMarkerRegex();
+	}
+	async render(data, options) {
+		let result = this.html;
+		result = await this.replaceSlots(result, data);
+		return renderOutput(result, options ?? this.options);
+	}
+	renderSync(data, options) {
+		if ((options ?? this.options)?.pretty) throw new Error("renderSync does not support pretty output; use render.");
+		let result = this.html;
+		result = this.replaceSlotsSync(result, data);
+		return renderSyncOutput(result, options ?? this.options);
+	}
+	buildMarkerRegex() {
+		const markers = /* @__PURE__ */ new Set();
+		for (const occurrences of this.contentSlots.values()) for (const occ of occurrences) markers.add(occ.full);
+		for (const attrMarkers of this.attrSlots.values()) for (const marker of attrMarkers) markers.add(marker);
+		if (markers.size === 0) return /$^/g;
+		return new RegExp(Array.from(markers).sort((a, b) => b.length - a.length).map(escapeRegex).join("|"), "g");
+	}
+	validateSlots(data) {
+		const allSlotNames = /* @__PURE__ */ new Set([...this.contentSlots.keys(), ...this.attrSlots.keys()]);
+		for (const name of allSlotNames) if (data[name] === void 0) {
+			if (!(this.contentSlots.get(name)?.some((occ) => occ.hasDefault) ?? false)) console.warn(`[solid-email] Slot "${name}" has no default and was not provided in render data. It will render as empty.`);
+		}
+	}
+	async replaceSlots(result, data) {
+		return this.replaceSlotsInFragment(result, data, true);
+	}
+	async replaceSlotsInFragment(result, data, validate) {
+		if (validate) this.validateSlots(data);
+		const replacements = /* @__PURE__ */ new Map();
+		for (const [name, occurrences] of this.contentSlots) {
+			const value = data[name];
+			const rendered = value !== void 0 ? await renderSlotValueAsync(value) : void 0;
+			for (const occ of occurrences) {
+				if (!result.includes(occ.full)) continue;
+				const replacement = rendered ?? await this.replaceSlotsInFragment(occ.defaultValue, data, false);
+				replacements.set(occ.full, replacement);
+			}
+		}
+		for (const [name, markers] of this.attrSlots) {
+			const value = data[name];
+			const replacement = renderAttrValue(name, value);
+			for (const marker of markers) replacements.set(marker, replacement);
+		}
+		if (replacements.size === 0) return result;
+		return result.replace(this.markerRegex, (marker) => replacements.get(marker) ?? marker);
+	}
+	replaceSlotsSync(result, data) {
+		return this.replaceSlotsInFragmentSync(result, data, true);
+	}
+	replaceSlotsInFragmentSync(result, data, validate) {
+		if (validate) this.validateSlots(data);
+		const replacements = /* @__PURE__ */ new Map();
+		for (const [name, occurrences] of this.contentSlots) {
+			const value = data[name];
+			const rendered = value !== void 0 ? renderSlotValueSync(value) : void 0;
+			for (const occ of occurrences) {
+				if (!result.includes(occ.full)) continue;
+				const replacement = rendered ?? this.replaceSlotsInFragmentSync(occ.defaultValue, data, false);
+				replacements.set(occ.full, replacement);
+			}
+		}
+		for (const [name, markers] of this.attrSlots) {
+			const value = data[name];
+			const replacement = renderAttrValue(name, value);
+			for (const marker of markers) replacements.set(marker, replacement);
+		}
+		if (replacements.size === 0) return result;
+		return result.replace(this.markerRegex, (marker) => replacements.get(marker) ?? marker);
+	}
+};
+async function renderSlotValueAsync(value) {
+	if (value == null) return "";
+	if (Array.isArray(value)) return Promise.all(value.map(renderSlotValueAsync)).then((results) => results.join(""));
+	if (typeof value === "boolean") return value ? "true" : "";
+	if (typeof value === "string") return escapeHtml(value);
+	if (typeof value === "number") return String(value);
+	return removeSolidResourceScripts(await (0, solid_js_web_dist_server_js.renderToStringAsync)(() => value));
+}
+function renderSlotValueSync(value) {
+	if (value == null) return "";
+	if (Array.isArray(value)) return value.map(renderSlotValueSync).join("");
+	if (typeof value === "boolean") return value ? "true" : "";
+	if (typeof value === "string") return escapeHtml(value);
+	if (typeof value === "number") return String(value);
+	return removeSolidResourceScripts((0, solid_js_web_dist_server_js.renderToString)(() => value));
+}
+function renderAttrValue(name, value) {
+	if (value == null) return "";
+	if (typeof value === "boolean") return value ? "true" : "";
+	if (typeof value === "string") return escapeAttr(value);
+	if (typeof value === "number") return String(value);
+	throw new TypeError(`Attribute slot "${name}" only accepts string, number, boolean, null, or undefined. Use <Slot name="${name}" /> for JSX/content values.`);
+}
+function escapeHtml(str) {
+	return str.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+}
+function escapeAttr(str) {
+	return str.replaceAll("&", "&amp;").replaceAll("\"", "&quot;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+}
+function escapeRegex(str) {
+	return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+async function compile(node, options) {
+	return new CompiledTemplate(removeSolidResourceScripts(await (0, solid_js_web_dist_server_js.renderToStringAsync)(normalizeRenderable(node))), options);
+}
+function compileSync(node, options) {
+	if (options?.pretty) throw new Error("compileSync does not support pretty output; use compile.");
+	return new CompiledTemplate(removeSolidResourceScripts((0, solid_js_web_dist_server_js.renderToString)(normalizeRenderable(node))), options);
+}
+//#endregion
+exports.CompiledTemplate = CompiledTemplate;
+exports.Slot = Slot;
+exports.buildSlotLookup = buildSlotLookup;
+exports.compile = compile;
+exports.compileSync = compileSync;
+exports.decodeName = decodeName;
+exports.defineSlots = defineSlots;
+exports.makeAttrMarker = makeAttrMarker;
+exports.makeContentMarker = makeContentMarker;
+exports.normalizeRenderable = normalizeRenderable;
 exports.plainTextSelectors = plainTextSelectors;
 exports.pretty = pretty;
+exports.removeSolidResourceScripts = removeSolidResourceScripts;
 exports.render = render;
+exports.renderDocument = renderDocument;
+exports.renderOutput = renderOutput;
 exports.renderSync = renderSync;
+exports.renderSyncOutput = renderSyncOutput;
+exports.slot = slot;
 exports.toPlainText = toPlainText;

package/dist/browser/index.d.cts

@@ -20,9 +20,61 @@ type RenderSyncOptions = {
 //#endregion
 //#region src/shared/render.d.ts
 type Renderable = JSX.Element | (() => JSX.Element);
+declare function normalizeRenderable(node: Renderable): () => JSX.Element;
+declare function removeSolidResourceScripts(html: string): string;
+declare function renderDocument(html: string): string;
+declare function renderSyncOutput(html: string, options?: RenderSyncOptions): string;
+declare function renderOutput(html: string, options?: Options): Promise<string>;
 declare function render(node: Renderable, options?: Options): Promise<string>;
 declare function renderSync(node: Renderable, options?: RenderSyncOptions): string;
 //#endregion
+//#region src/shared/slots.d.ts
+type SlotPrimitive = string | number | boolean | null | undefined;
+type SlotValue = SlotPrimitive | JSX.Element | SlotValue[];
+type SlotRecord = Record<string, SlotValue>;
+declare function decodeName(encoded: string): string;
+declare function makeContentMarker(name: string, defaultValue?: string): string;
+declare function makeAttrMarker(name: string): string;
+interface SlotOccurrence {
+  full: string;
+  hasDefault: boolean;
+  defaultValue: string;
+}
+declare function buildSlotLookup(html: string): {
+  content: Map<string, SlotOccurrence[]>;
+  attr: Map<string, string[]>;
+};
+declare function Slot(props: {
+  name: string;
+  children?: JSX.Element;
+}): JSX.Element;
+declare function slot(name: string): string;
+interface SlotDefinition<T extends SlotRecord> {
+  content: <K extends keyof T & string>(name: K, defaultValue?: string) => string;
+  attr: <K extends keyof T & string>(name: K) => string;
+}
+declare function defineSlots<T extends SlotRecord>(): SlotDefinition<T>;
+//#endregion
+//#region src/shared/compile.d.ts
+declare class CompiledTemplate<TSlots extends Record<string, SlotValue> = Record<string, SlotValue>> {
+  private readonly html;
+  private readonly options?;
+  private readonly contentSlots;
+  private readonly attrSlots;
+  private readonly markerRegex;
+  constructor(html: string, options?: Options);
+  render(data: TSlots, options?: Options): Promise<string>;
+  renderSync(data: TSlots, options?: RenderSyncOptions): string;
+  private buildMarkerRegex;
+  private validateSlots;
+  private replaceSlots;
+  private replaceSlotsInFragment;
+  private replaceSlotsSync;
+  private replaceSlotsInFragmentSync;
+}
+declare function compile<TSlots extends Record<string, SlotValue> = Record<string, SlotValue>>(node: Renderable, options?: Options): Promise<CompiledTemplate<TSlots>>;
+declare function compileSync<TSlots extends Record<string, SlotValue> = Record<string, SlotValue>>(node: Renderable, options?: RenderSyncOptions): CompiledTemplate<TSlots>;
+//#endregion
 //#region src/shared/utils/pretty.d.ts
 declare const pretty: (str: string, options?: Options$1) => Promise<string>;
 //#endregion
@@ -30,5 +82,5 @@ declare const pretty: (str: string, options?: Options$1) => Promise<string>;
 declare const plainTextSelectors: SelectorDefinition[];
 declare function toPlainText(html: string, options?: HtmlToTextOptions): string;
 //#endregion
-export { Options, RenderSyncOptions, Renderable, plainTextSelectors, pretty, render, renderSync, toPlainText };
+export { CompiledTemplate, Options, RenderSyncOptions, Renderable, Slot, SlotDefinition, SlotOccurrence, SlotPrimitive, SlotRecord, SlotValue, buildSlotLookup, compile, compileSync, decodeName, defineSlots, makeAttrMarker, makeContentMarker, normalizeRenderable, plainTextSelectors, pretty, removeSolidResourceScripts, render, renderDocument, renderOutput, renderSync, renderSyncOutput, slot, toPlainText };
 //# sourceMappingURL=index.d.cts.map

package/dist/browser/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/shared/options.ts","../../src/shared/render.ts","../../src/shared/utils/pretty.ts","../../src/shared/utils/to-plain-text.ts"],"mappings":";;;;;KAEK,iBAAA;EACH,SAAS;AAAA;AAAA,KAGN,gBAAA;EACH,SAAA;EACA,iBAAA,GAAoB,iBAAiB;AAAA;AAAA,KAGlC,gBAAA,GAAmB,iBAAA,GAAoB,gBAAgB;AAAA,KAEhD,OAAA;EACV,MAAA;AAAA,IACE,gBAAgB;AAAA,KAER,iBAAA;EACV,MAAA;AAAA,IACE,gBAAgB;;;KCVR,UAAA,GAAa,GAAA,CAAI,OAAA,UAAiB,GAAA,CAAI,OAAO;AAAA,iBA+DnC,MAAA,CACpB,IAAA,EAAM,UAAA,EACN,OAAA,GAAU,OAAA,GACT,OAAA;AAAA,iBAQa,UAAA,CACd,IAAA,EAAM,UAAA,EACN,OAAA,GAAU,iBAAiB;;;cCuChB,MAAA,GAAU,GAAA,UAAa,OAAA,GAAS,SAAA,KAAY,OAAA;;;cCpH5C,kBAAA,EAAoB,kBAAkB;AAAA,iBASnC,WAAA,CAAY,IAAA,UAAc,OAAA,GAAU,iBAAiB"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/shared/options.ts","../../src/shared/render.ts","../../src/shared/slots.ts","../../src/shared/compile.ts","../../src/shared/utils/pretty.ts","../../src/shared/utils/to-plain-text.ts"],"mappings":"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"}

package/dist/browser/index.d.mts

@@ -20,9 +20,61 @@ type RenderSyncOptions = {
 //#endregion
 //#region src/shared/render.d.ts
 type Renderable = JSX.Element | (() => JSX.Element);
+declare function normalizeRenderable(node: Renderable): () => JSX.Element;
+declare function removeSolidResourceScripts(html: string): string;
+declare function renderDocument(html: string): string;
+declare function renderSyncOutput(html: string, options?: RenderSyncOptions): string;
+declare function renderOutput(html: string, options?: Options): Promise<string>;
 declare function render(node: Renderable, options?: Options): Promise<string>;
 declare function renderSync(node: Renderable, options?: RenderSyncOptions): string;
 //#endregion
+//#region src/shared/slots.d.ts
+type SlotPrimitive = string | number | boolean | null | undefined;
+type SlotValue = SlotPrimitive | JSX.Element | SlotValue[];
+type SlotRecord = Record<string, SlotValue>;
+declare function decodeName(encoded: string): string;
+declare function makeContentMarker(name: string, defaultValue?: string): string;
+declare function makeAttrMarker(name: string): string;
+interface SlotOccurrence {
+  full: string;
+  hasDefault: boolean;
+  defaultValue: string;
+}
+declare function buildSlotLookup(html: string): {
+  content: Map<string, SlotOccurrence[]>;
+  attr: Map<string, string[]>;
+};
+declare function Slot(props: {
+  name: string;
+  children?: JSX.Element;
+}): JSX.Element;
+declare function slot(name: string): string;
+interface SlotDefinition<T extends SlotRecord> {
+  content: <K extends keyof T & string>(name: K, defaultValue?: string) => string;
+  attr: <K extends keyof T & string>(name: K) => string;
+}
+declare function defineSlots<T extends SlotRecord>(): SlotDefinition<T>;
+//#endregion
+//#region src/shared/compile.d.ts
+declare class CompiledTemplate<TSlots extends Record<string, SlotValue> = Record<string, SlotValue>> {
+  private readonly html;
+  private readonly options?;
+  private readonly contentSlots;
+  private readonly attrSlots;
+  private readonly markerRegex;
+  constructor(html: string, options?: Options);
+  render(data: TSlots, options?: Options): Promise<string>;
+  renderSync(data: TSlots, options?: RenderSyncOptions): string;
+  private buildMarkerRegex;
+  private validateSlots;
+  private replaceSlots;
+  private replaceSlotsInFragment;
+  private replaceSlotsSync;
+  private replaceSlotsInFragmentSync;
+}
+declare function compile<TSlots extends Record<string, SlotValue> = Record<string, SlotValue>>(node: Renderable, options?: Options): Promise<CompiledTemplate<TSlots>>;
+declare function compileSync<TSlots extends Record<string, SlotValue> = Record<string, SlotValue>>(node: Renderable, options?: RenderSyncOptions): CompiledTemplate<TSlots>;
+//#endregion
 //#region src/shared/utils/pretty.d.ts
 declare const pretty: (str: string, options?: Options$1) => Promise<string>;
 //#endregion
@@ -30,5 +82,5 @@ declare const pretty: (str: string, options?: Options$1) => Promise<string>;
 declare const plainTextSelectors: SelectorDefinition[];
 declare function toPlainText(html: string, options?: HtmlToTextOptions): string;
 //#endregion
-export { Options, RenderSyncOptions, Renderable, plainTextSelectors, pretty, render, renderSync, toPlainText };
+export { CompiledTemplate, Options, RenderSyncOptions, Renderable, Slot, SlotDefinition, SlotOccurrence, SlotPrimitive, SlotRecord, SlotValue, buildSlotLookup, compile, compileSync, decodeName, defineSlots, makeAttrMarker, makeContentMarker, normalizeRenderable, plainTextSelectors, pretty, removeSolidResourceScripts, render, renderDocument, renderOutput, renderSync, renderSyncOutput, slot, toPlainText };
 //# sourceMappingURL=index.d.mts.map

package/dist/browser/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/shared/options.ts","../../src/shared/render.ts","../../src/shared/utils/pretty.ts","../../src/shared/utils/to-plain-text.ts"],"mappings":";;;;;KAEK,iBAAA;EACH,SAAS;AAAA;AAAA,KAGN,gBAAA;EACH,SAAA;EACA,iBAAA,GAAoB,iBAAiB;AAAA;AAAA,KAGlC,gBAAA,GAAmB,iBAAA,GAAoB,gBAAgB;AAAA,KAEhD,OAAA;EACV,MAAA;AAAA,IACE,gBAAgB;AAAA,KAER,iBAAA;EACV,MAAA;AAAA,IACE,gBAAgB;;;KCVR,UAAA,GAAa,GAAA,CAAI,OAAA,UAAiB,GAAA,CAAI,OAAO;AAAA,iBA+DnC,MAAA,CACpB,IAAA,EAAM,UAAA,EACN,OAAA,GAAU,OAAA,GACT,OAAA;AAAA,iBAQa,UAAA,CACd,IAAA,EAAM,UAAA,EACN,OAAA,GAAU,iBAAiB;;;cCuChB,MAAA,GAAU,GAAA,UAAa,OAAA,GAAS,SAAA,KAAY,OAAA;;;cCpH5C,kBAAA,EAAoB,kBAAkB;AAAA,iBASnC,WAAA,CAAY,IAAA,UAAc,OAAA,GAAU,iBAAiB"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/shared/options.ts","../../src/shared/render.ts","../../src/shared/slots.ts","../../src/shared/compile.ts","../../src/shared/utils/pretty.ts","../../src/shared/utils/to-plain-text.ts"],"mappings":"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"}

package/dist/browser/index.mjs

@@ -2,6 +2,7 @@ import { renderToString, renderToStringAsync } from "solid-js/web/dist/server.js
 import * as html from "prettier/plugins/html";
 import { format } from "prettier/standalone";
 import { convert } from "html-to-text";
+import { ssr } from "solid-js/web";
 //#region src/shared/utils/pretty.ts
 function getHtmlNode(path) {
 	const topNode = path.node;
@@ -130,6 +131,230 @@ function renderSync(node, options) {
 	return renderSyncOutput(removeSolidResourceScripts(renderToString(normalizeRenderable(node))), options);
 }
 //#endregion
-export { plainTextSelectors, pretty, render, renderSync, toPlainText };
+//#region src/shared/slots.ts
+const MARKER_PREFIX = "__SM_";
+const CONTENT_START = `${MARKER_PREFIX}CNT_`;
+const CONTENT_END = `${MARKER_PREFIX}CNE_`;
+const ATTR_PREFIX = `${MARKER_PREFIX}ATR_`;
+function encodeName(name) {
+	return encodeURIComponent(name).replace(/[!'()*_]/g, (char) => `%${char.charCodeAt(0).toString(16).toUpperCase()}`);
+}
+function decodeName(encoded) {
+	return decodeURIComponent(encoded);
+}
+function makeContentMarker(name, defaultValue) {
+	const encoded = encodeName(name);
+	const start = `${CONTENT_START}${encoded}__`;
+	if (defaultValue !== void 0) return `${start}${defaultValue}${CONTENT_END}${encoded}__`;
+	return `${start}${CONTENT_END}${encoded}__`;
+}
+function makeAttrMarker(name) {
+	return `${ATTR_PREFIX}${encodeName(name)}__`;
+}
+function escapeRegex$1(str) {
+	return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function buildSlotLookup(html) {
+	const contentSlots = /* @__PURE__ */ new Map();
+	const attrSlots = /* @__PURE__ */ new Map();
+	const nameChars = "(?:[A-Za-z0-9.~-]|%[0-9A-Fa-f]{2})+";
+	const tokenRegex = new RegExp(`${escapeRegex$1(CONTENT_START)}(${nameChars})__|${escapeRegex$1(CONTENT_END)}(${nameChars})__`, "g");
+	const stack = [];
+	let match;
+	while (true) {
+		match = tokenRegex.exec(html);
+		if (match === null) break;
+		const startName = match[1];
+		if (startName !== void 0) {
+			stack.push({
+				encodedName: startName,
+				name: decodeName(startName),
+				startIndex: match.index,
+				contentStartIndex: tokenRegex.lastIndex
+			});
+			continue;
+		}
+		const endName = match[2];
+		if (endName === void 0) continue;
+		let openIndex = -1;
+		for (let index = stack.length - 1; index >= 0; index -= 1) if (stack[index]?.encodedName === endName) {
+			openIndex = index;
+			break;
+		}
+		if (openIndex === -1) continue;
+		const [open] = stack.splice(openIndex, 1);
+		if (open === void 0) continue;
+		const innerContent = html.slice(open.contentStartIndex, match.index);
+		const occurrence = {
+			full: html.slice(open.startIndex, tokenRegex.lastIndex),
+			hasDefault: innerContent.length > 0,
+			defaultValue: innerContent
+		};
+		const existing = contentSlots.get(open.name);
+		if (existing) existing.push(occurrence);
+		else contentSlots.set(open.name, [occurrence]);
+	}
+	const attrRegex = new RegExp(`${escapeRegex$1(ATTR_PREFIX)}(${nameChars})__`, "g");
+	while (true) {
+		match = attrRegex.exec(html);
+		if (match === null) break;
+		const name = decodeName(match[1] ?? "");
+		const existing = attrSlots.get(name);
+		if (existing) existing.push(match[0]);
+		else attrSlots.set(name, [match[0]]);
+	}
+	return {
+		content: contentSlots,
+		attr: attrSlots
+	};
+}
+function Slot(props) {
+	const encoded = encodeName(props.name);
+	const start = ssr(`${CONTENT_START}${encoded}__`);
+	const end = ssr(`${CONTENT_END}${encoded}__`);
+	if (props.children !== void 0 && props.children !== null) return [
+		start,
+		props.children,
+		end
+	];
+	return [start, end];
+}
+function slot(name) {
+	return makeAttrMarker(name);
+}
+function defineSlots() {
+	return {
+		content: (name, defaultValue) => makeContentMarker(name, defaultValue),
+		attr: (name) => makeAttrMarker(name)
+	};
+}
+//#endregion
+//#region src/shared/compile.ts
+var CompiledTemplate = class {
+	html;
+	options;
+	contentSlots;
+	attrSlots;
+	markerRegex;
+	constructor(html, options) {
+		this.html = html;
+		this.options = options;
+		const lookup = buildSlotLookup(html);
+		this.contentSlots = lookup.content;
+		this.attrSlots = lookup.attr;
+		this.markerRegex = this.buildMarkerRegex();
+	}
+	async render(data, options) {
+		let result = this.html;
+		result = await this.replaceSlots(result, data);
+		return renderOutput(result, options ?? this.options);
+	}
+	renderSync(data, options) {
+		if ((options ?? this.options)?.pretty) throw new Error("renderSync does not support pretty output; use render.");
+		let result = this.html;
+		result = this.replaceSlotsSync(result, data);
+		return renderSyncOutput(result, options ?? this.options);
+	}
+	buildMarkerRegex() {
+		const markers = /* @__PURE__ */ new Set();
+		for (const occurrences of this.contentSlots.values()) for (const occ of occurrences) markers.add(occ.full);
+		for (const attrMarkers of this.attrSlots.values()) for (const marker of attrMarkers) markers.add(marker);
+		if (markers.size === 0) return /$^/g;
+		return new RegExp(Array.from(markers).sort((a, b) => b.length - a.length).map(escapeRegex).join("|"), "g");
+	}
+	validateSlots(data) {
+		const allSlotNames = /* @__PURE__ */ new Set([...this.contentSlots.keys(), ...this.attrSlots.keys()]);
+		for (const name of allSlotNames) if (data[name] === void 0) {
+			if (!(this.contentSlots.get(name)?.some((occ) => occ.hasDefault) ?? false)) console.warn(`[solid-email] Slot "${name}" has no default and was not provided in render data. It will render as empty.`);
+		}
+	}
+	async replaceSlots(result, data) {
+		return this.replaceSlotsInFragment(result, data, true);
+	}
+	async replaceSlotsInFragment(result, data, validate) {
+		if (validate) this.validateSlots(data);
+		const replacements = /* @__PURE__ */ new Map();
+		for (const [name, occurrences] of this.contentSlots) {
+			const value = data[name];
+			const rendered = value !== void 0 ? await renderSlotValueAsync(value) : void 0;
+			for (const occ of occurrences) {
+				if (!result.includes(occ.full)) continue;
+				const replacement = rendered ?? await this.replaceSlotsInFragment(occ.defaultValue, data, false);
+				replacements.set(occ.full, replacement);
+			}
+		}
+		for (const [name, markers] of this.attrSlots) {
+			const value = data[name];
+			const replacement = renderAttrValue(name, value);
+			for (const marker of markers) replacements.set(marker, replacement);
+		}
+		if (replacements.size === 0) return result;
+		return result.replace(this.markerRegex, (marker) => replacements.get(marker) ?? marker);
+	}
+	replaceSlotsSync(result, data) {
+		return this.replaceSlotsInFragmentSync(result, data, true);
+	}
+	replaceSlotsInFragmentSync(result, data, validate) {
+		if (validate) this.validateSlots(data);
+		const replacements = /* @__PURE__ */ new Map();
+		for (const [name, occurrences] of this.contentSlots) {
+			const value = data[name];
+			const rendered = value !== void 0 ? renderSlotValueSync(value) : void 0;
+			for (const occ of occurrences) {
+				if (!result.includes(occ.full)) continue;
+				const replacement = rendered ?? this.replaceSlotsInFragmentSync(occ.defaultValue, data, false);
+				replacements.set(occ.full, replacement);
+			}
+		}
+		for (const [name, markers] of this.attrSlots) {
+			const value = data[name];
+			const replacement = renderAttrValue(name, value);
+			for (const marker of markers) replacements.set(marker, replacement);
+		}
+		if (replacements.size === 0) return result;
+		return result.replace(this.markerRegex, (marker) => replacements.get(marker) ?? marker);
+	}
+};
+async function renderSlotValueAsync(value) {
+	if (value == null) return "";
+	if (Array.isArray(value)) return Promise.all(value.map(renderSlotValueAsync)).then((results) => results.join(""));
+	if (typeof value === "boolean") return value ? "true" : "";
+	if (typeof value === "string") return escapeHtml(value);
+	if (typeof value === "number") return String(value);
+	return removeSolidResourceScripts(await renderToStringAsync(() => value));
+}
+function renderSlotValueSync(value) {
+	if (value == null) return "";
+	if (Array.isArray(value)) return value.map(renderSlotValueSync).join("");
+	if (typeof value === "boolean") return value ? "true" : "";
+	if (typeof value === "string") return escapeHtml(value);
+	if (typeof value === "number") return String(value);
+	return removeSolidResourceScripts(renderToString(() => value));
+}
+function renderAttrValue(name, value) {
+	if (value == null) return "";
+	if (typeof value === "boolean") return value ? "true" : "";
+	if (typeof value === "string") return escapeAttr(value);
+	if (typeof value === "number") return String(value);
+	throw new TypeError(`Attribute slot "${name}" only accepts string, number, boolean, null, or undefined. Use <Slot name="${name}" /> for JSX/content values.`);
+}
+function escapeHtml(str) {
+	return str.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+}
+function escapeAttr(str) {
+	return str.replaceAll("&", "&amp;").replaceAll("\"", "&quot;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+}
+function escapeRegex(str) {
+	return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+async function compile(node, options) {
+	return new CompiledTemplate(removeSolidResourceScripts(await renderToStringAsync(normalizeRenderable(node))), options);
+}
+function compileSync(node, options) {
+	if (options?.pretty) throw new Error("compileSync does not support pretty output; use compile.");
+	return new CompiledTemplate(removeSolidResourceScripts(renderToString(normalizeRenderable(node))), options);
+}
+//#endregion
+export { CompiledTemplate, Slot, buildSlotLookup, compile, compileSync, decodeName, defineSlots, makeAttrMarker, makeContentMarker, normalizeRenderable, plainTextSelectors, pretty, removeSolidResourceScripts, render, renderDocument, renderOutput, renderSync, renderSyncOutput, slot, toPlainText };
 
 //# sourceMappingURL=index.mjs.map