@samva/markup 0.8.0 → 0.10.0

package/dist/emit.js

@@ -1,151 +0,0 @@
-import { sameTemplateSourceLocations } from "./source-locations.js";
-import { isRootTag } from "./ast.js";
-import { createVariablesProxy } from "./variables.js";
-import { renderTemplate } from "./render-template.js";
-import { Result } from "better-result";
-//#region src/emit.ts
-/**
-* emitModule — the module-level emit boundary for the TSX authoring layer.
-* The vite plugin does the importing: TSX runs at the
-* USER's build time and this receives the already-evaluated module object (a
-* record of its exports). emitModule stays bundler-agnostic — it never touches
-* the filesystem, esbuild, or vite. It reads only `moduleExports.default`,
-* runs that function through renderTemplate (print → parse validation), and
-* additionally renders it TWICE to guard emission determinism (a build-time
-* clock or RNG produces a different second emission and is reported as
-* unstable).
-*
-* Named exports are ordinary helpers and are never inspected or invoked. A
-* missing or invalid default is a module-level diagnostic (the common "forgot
-* to default-export the function" / "imported the wrong file" mistake).
-*
-* Default-export classification
-*
-* This recorder recognizes function exports returning a channel root element.
-* SMS and WhatsApp use the recorded AST; legacy Email roots remain recognizable
-* so the compiler can report the executable defineEmail requirement. Executable
-* email definitions are discovered by their definition marker before this path.
-* Structured function exports have no marker and are classified by probing.
-*
-* The proxy makes the probe cheap and side-effect-free for well-formed
-* templates: property accesses record variables and return refs; no network,
-* no I/O. A default export that throws when called with a proxy, or that
-* returns a non-root node, is `invalid-default-export` rather than a crash.
-*
-* A genuine template whose body throws (a real authoring bug — coercing a
-* variable, a malformed child) is therefore classified as an invalid default.
-* That is acceptable because the same bug breaks the template's real emit
-* regardless. Confirmed templates are rendered by renderTemplate, so a
-* template function must be a pure builder of its AST — which the
-* recording-proxy model already requires.
-*/
-/** Probe the default export: is it a function that yields a channel root document? */
-const isTemplateFunction = (value) => {
-	if (typeof value !== "function") return false;
-	const { proxy } = createVariablesProxy();
-	let result;
-	try {
-		result = value(proxy);
-	} catch {
-		return false;
-	}
-	return result !== null && typeof result === "object" && result.kind === "element" && isRootTag(result.tag);
-};
-const MISSING_DEFAULT = {
-	code: "missing-default-export",
-	message: "no default export — a structured template must default-export a function returning <Sms> or <WhatsApp>. Email templates must default-export defineEmail with an input schema and fixtures. Named exports are ignored.",
-	span: {
-		start: 0,
-		end: 0
-	}
-};
-const INVALID_DEFAULT = {
-	code: "invalid-default-export",
-	message: "the default export is not a structured Samva template returning <Sms> or <WhatsApp>. Email templates must default-export defineEmail with an input schema and fixtures.",
-	span: {
-		start: 0,
-		end: 0
-	}
-};
-const unstableDiagnostic = (name) => ({
-	code: "unstable-emission",
-	message: `template "${name}" emits different source on each render — its output depends on non-deterministic build-time data (a clock or random source); templates must be pure functions of their variables`,
-	span: {
-		start: 0,
-		end: 0
-	}
-});
-/**
-* Emits the one supported template from an already-evaluated module object:
-* `moduleExports.default`. Named exports are never probed. `moduleExports` is
-* a plain record of the module's exports (the vite plugin imports the TSX;
-* this stays bundler-agnostic and pure).
-*
-* A missing default yields `missing-default-export`. A present default that
-* is not a template function yields `invalid-default-export`. Both fail the
-* aggregate with an empty `templates` array.
-*/
-const emitModule = (moduleExports) => {
-	if (!Object.hasOwn(moduleExports, "default")) return {
-		ok: false,
-		templates: [],
-		diagnostics: [MISSING_DEFAULT]
-	};
-	const value = moduleExports.default;
-	if (!isTemplateFunction(value)) return {
-		ok: false,
-		templates: [],
-		diagnostics: [INVALID_DEFAULT]
-	};
-	const template = emitOne("default", value);
-	return {
-		ok: template.ok,
-		templates: [template],
-		diagnostics: []
-	};
-};
-/**
-* Renders one confirmed template with the determinism guard. The first render is
-* the authoritative emission; the second exists only to detect instability
-* (a build-time clock or random source). Both renders run at BUILD time only
-* (the plugin) —
-* runtime send-path rendering never double-renders. For a deterministic template
-* the second render is pure redundant work at build time; that is the accepted
-* cost of the guard, paid once per template per build.
-*/
-const emitOne = (name, template) => {
-	const first = renderTemplate(template);
-	if (Result.isError(first)) return {
-		name,
-		ok: false,
-		source: void 0,
-		variables: [],
-		sourceLocations: {
-			kind: "unavailable",
-			reason: "render-failed"
-		},
-		diagnostics: first.error.diagnostics
-	};
-	const rendered = first.value;
-	const second = renderTemplate(template);
-	if (Result.isOk(second) && second.value.source === rendered.source && sameTemplateSourceLocations(second.value.sourceLocations, rendered.sourceLocations)) return {
-		name,
-		ok: true,
-		source: rendered.source,
-		variables: rendered.variables,
-		sourceLocations: rendered.sourceLocations,
-		diagnostics: []
-	};
-	return {
-		name,
-		ok: false,
-		source: rendered.source,
-		variables: rendered.variables,
-		sourceLocations: rendered.sourceLocations,
-		diagnostics: [unstableDiagnostic(name)]
-	};
-};
-//#endregion
-export { emitModule };
-
-//# sourceMappingURL=emit.js.map

package/dist/html-Bl9BAdqc.d.ts

@@ -1,42 +0,0 @@
-import { r as EmailDiagnostic } from "./diagnostics-BMYtBCQk.js";
-import { m as EmailNode } from "./elements-BzjjnoCS.js";
-import { n as EmittedPosition } from "./selection-CCArx9lU.js";
-//#region src/email/html.d.ts
-/** Escape a value for element content. */
-declare const escapeText: (value: string) => string;
-/** Escape a value for a double-quoted attribute. */
-declare const escapeAttribute: (value: string) => string;
-/** camelCase to kebab-case; already-kebab names pass through unchanged. */
-declare const kebab: (property: string) => string;
-/** A bare number is pixels for every property that takes a length. */
-declare const declarationValue: (property: string, value: string | number) => string;
-interface EmailHtmlOutput {
-  readonly html: string;
-  readonly diagnostics: readonly EmailDiagnostic[];
-  /**
-   * Each emitted element's offset range and origins. A compatibility finding
-   * carries a position in the emitted document, and this is what turns that
-   * back into the authoring element the author can edit.
-   */
-  readonly positions: readonly EmittedPosition[];
-}
-/** How this document will be consumed. Delivery is the default; export is opt-in. */
-interface SerializeEmailOptions {
-  /**
-   * Accept relative references. A local export serves assets from a relative
-   * base beside the file; a delivered message has no directory to resolve one
-   * against, so this stays off for anything that will be sent.
-   */
-  readonly relativeUrls?: boolean | undefined;
-  /**
-   * Stamp every element with its instance path, so an editor preview can
-   * resolve a click in the rendered document to exactly one rendered element.
-   * A delivered message never carries it.
-   */
-  readonly instancePaths?: boolean | undefined;
-}
-/** Lower the derived tree to email HTML, reporting every unsupported construct with its origin. */
-declare const serializeEmailHtml: (node: EmailNode, options?: SerializeEmailOptions) => EmailHtmlOutput;
-//#endregion
-export { escapeText as a, escapeAttribute as i, SerializeEmailOptions as n, kebab as o, declarationValue as r, serializeEmailHtml as s, EmailHtmlOutput as t };
-//# sourceMappingURL=html-Bl9BAdqc.d.ts.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