@samva/markup 0.7.0 → 0.9.0

package/dist/variables-J_L3qxRa.d.ts

@@ -1,77 +0,0 @@
-import { r as PredicateAst } from "./predicate-M-05Nd7R.js";
-//#region src/variables.d.ts
-/** Brand carried by every VariableRef, keyed off a private symbol. */
-declare const VARIABLE_REF: unique symbol;
-/** Brand carried by every PredicateRef. */
-declare const PREDICATE_REF: unique symbol;
-interface VariableRefBrand {
-  readonly path: string;
-  /** The recorder shared across every ref/proxy from one template invocation. */
-  readonly recorder: VariableRecorder;
-}
-/** Builders present on every VariableRef regardless of field type. */
-interface CommonPredicateBuilders {
-  eq(value: string | number): PredicateRef;
-  ne(value: string | number): PredicateRef;
-  exists(): PredicateRef;
-  notExists(): PredicateRef;
-}
-/** Ordering builders — only surfaced (by the `Variables<T>` mapping) on number fields. */
-interface NumericPredicateBuilders {
-  gt(value: number): PredicateRef;
-  gte(value: number): PredicateRef;
-  lt(value: number): PredicateRef;
-  lte(value: number): PredicateRef;
-}
-/** A recorded reference to a send-time variable. See module docs. */
-type VariableRef<T> = {
-  readonly [VARIABLE_REF]: VariableRefBrand;
-} & CommonPredicateBuilders & (T extends number ? NumericPredicateBuilders : Record<never, never>);
-/** A recorded predicate expression for `<If test={...}>`; chains with and/or/not. */
-interface PredicateRef {
-  readonly [PREDICATE_REF]: {
-    readonly ast: PredicateAst;
-  };
-  and(other: PredicateRef): PredicateRef;
-  or(other: PredicateRef): PredicateRef;
-  not(): PredicateRef;
-}
-declare const isVariableRef: (value: unknown) => value is VariableRef<unknown>;
-declare const isPredicateRef: (value: unknown) => value is PredicateRef;
-/** The predicate source string (`test="..."`) for a PredicateRef. */
-declare const printPredicateRef: (ref: PredicateRef) => string;
-type VariableKind = "string" | "number" | "unknown";
-interface CollectedVariable {
-  readonly name: string;
-  readonly kind: VariableKind;
-}
-/**
- * Shared across every ref produced from one template invocation. Records which
- * variables were touched and the strongest kind evidence seen for each (a
- * numeric comparison implies `number`; a string comparison implies `string`;
- * bare interpolation/exists leaves it `unknown`).
- */
-declare class VariableRecorder {
-  private readonly kinds;
-  observe(name: string, kind: VariableKind): void;
-  collected(): ReadonlyArray<CollectedVariable>;
-}
-/**
- * Maps a declared variable type to the recording-proxy shape a template
- * receives: `export default function Welcome(v: Variables<{ firstName: string }>)`.
- * Number fields additionally expose ordering builders.
- */
-type Variables<T extends Record<string, unknown>> = { readonly [K in keyof T]: VariableRef<T[K]>; };
-/**
- * Builds the recording proxy for a template invocation. Every top-level
- * property access records the variable (kind `unknown` until a typed comparison
- * refines it) and returns a VariableRef. Returns the proxy plus the shared
- * recorder so renderTemplate can read the collected schema.
- */
-declare const createVariablesProxy: <T extends Record<string, unknown>>() => {
-  readonly proxy: Variables<T>;
-  readonly recorder: VariableRecorder;
-};
-//#endregion
-export { VariableKind as a, VariableRefBrand as c, isPredicateRef as d, isVariableRef as f, VARIABLE_REF as i, Variables as l, PREDICATE_REF as n, VariableRecorder as o, printPredicateRef as p, PredicateRef as r, VariableRef as s, CollectedVariable as t, createVariablesProxy as u };
-//# sourceMappingURL=variables-J_L3qxRa.d.ts.map

package/dist/variables.d.ts

@@ -1,2 +0,0 @@
-import { a as VariableKind, c as VariableRefBrand, d as isPredicateRef, f as isVariableRef, i as VARIABLE_REF, l as Variables, n as PREDICATE_REF, o as VariableRecorder, p as printPredicateRef, r as PredicateRef, s as VariableRef, t as CollectedVariable, u as createVariablesProxy } from "./variables-J_L3qxRa.js";
-export { CollectedVariable, PREDICATE_REF, PredicateRef, VARIABLE_REF, VariableKind, VariableRecorder, VariableRef, VariableRefBrand, Variables, createVariablesProxy, isPredicateRef, isVariableRef, printPredicateRef };

package/dist/variables.js

@@ -1,141 +0,0 @@
-import { t as hasProperty } from "./guards-eV1qLbf2.js";
-import { a as printPredicate } from "./predicate-BI6uRRM-.js";
-//#region src/variables.ts
-const PLACEHOLDER_SPAN = {
-	start: 0,
-	end: 0
-};
-/** Brand carried by every VariableRef, keyed off a private symbol. */
-const VARIABLE_REF = Symbol.for("@samva/markup/VariableRef");
-/** Brand carried by every PredicateRef. */
-const PREDICATE_REF = Symbol.for("@samva/markup/PredicateRef");
-const COERCION_MESSAGE = "variables are send-time values; branch on build-time data instead";
-const isVariableRef = (value) => hasProperty(value, VARIABLE_REF);
-const isPredicateRef = (value) => hasProperty(value, PREDICATE_REF);
-const literalFor = (value) => typeof value === "number" ? {
-	kind: "number",
-	value
-} : {
-	kind: "string",
-	value
-};
-const makePredicateRef = (ast) => ({
-	[PREDICATE_REF]: { ast },
-	and: (other) => makePredicateRef({
-		kind: "and",
-		left: ast,
-		right: predicateAst(other),
-		span: PLACEHOLDER_SPAN
-	}),
-	or: (other) => makePredicateRef({
-		kind: "or",
-		left: ast,
-		right: predicateAst(other),
-		span: PLACEHOLDER_SPAN
-	}),
-	not: () => makePredicateRef({
-		kind: "not",
-		operand: ast,
-		span: PLACEHOLDER_SPAN
-	})
-});
-const predicateAst = (ref) => ref[PREDICATE_REF].ast;
-/** The predicate source string (`test="..."`) for a PredicateRef. */
-const printPredicateRef = (ref) => printPredicate(predicateAst(ref));
-/**
-* Shared across every ref produced from one template invocation. Records which
-* variables were touched and the strongest kind evidence seen for each (a
-* numeric comparison implies `number`; a string comparison implies `string`;
-* bare interpolation/exists leaves it `unknown`).
-*/
-var VariableRecorder = class {
-	kinds = /* @__PURE__ */ new Map();
-	observe(name, kind) {
-		const existing = this.kinds.get(name);
-		if (existing === void 0 || existing === "unknown") this.kinds.set(name, kind);
-	}
-	collected() {
-		return [...this.kinds].map(([name, kind]) => ({
-			name,
-			kind
-		}));
-	}
-};
-const makeComparison = (brand, op, value) => {
-	brand.recorder.observe(brand.path, typeof value === "number" ? "number" : "string");
-	return makePredicateRef({
-		kind: "comparison",
-		name: brand.path,
-		op,
-		literal: literalFor(value),
-		span: PLACEHOLDER_SPAN
-	});
-};
-const makeVariableRef = (path, recorder) => {
-	const brand = {
-		path,
-		recorder
-	};
-	const builders = {
-		eq: (value) => makeComparison(brand, "==", value),
-		ne: (value) => makeComparison(brand, "!=", value),
-		gt: (value) => makeComparison(brand, ">", value),
-		gte: (value) => makeComparison(brand, ">=", value),
-		lt: (value) => makeComparison(brand, "<", value),
-		lte: (value) => makeComparison(brand, "<=", value),
-		exists: () => {
-			recorder.observe(path, "unknown");
-			return makePredicateRef({
-				kind: "name",
-				name: path,
-				span: PLACEHOLDER_SPAN
-			});
-		},
-		notExists: () => {
-			recorder.observe(path, "unknown");
-			return makePredicateRef({
-				kind: "not",
-				operand: {
-					kind: "name",
-					name: path,
-					span: PLACEHOLDER_SPAN
-				},
-				span: PLACEHOLDER_SPAN
-			});
-		}
-	};
-	const target = {
-		[VARIABLE_REF]: brand,
-		...builders
-	};
-	return new Proxy(target, { get(base, key, receiver) {
-		if (key === Symbol.toPrimitive || key === "valueOf" || key === "toString") return () => {
-			throw new TypeError(COERCION_MESSAGE);
-		};
-		if (key === VARIABLE_REF || key in base) return Reflect.get(base, key, receiver);
-		if (key === Symbol.toStringTag) return "VariableRef";
-		if (typeof key === "string") return makeVariableRef(`${path}.${key}`, recorder);
-		return Reflect.get(base, key, receiver);
-	} });
-};
-/**
-* Builds the recording proxy for a template invocation. Every top-level
-* property access records the variable (kind `unknown` until a typed comparison
-* refines it) and returns a VariableRef. Returns the proxy plus the shared
-* recorder so renderTemplate can read the collected schema.
-*/
-const createVariablesProxy = () => {
-	const recorder = new VariableRecorder();
-	return {
-		proxy: new Proxy({}, { get(_base, key) {
-			if (typeof key !== "string") return void 0;
-			recorder.observe(key, "unknown");
-			return makeVariableRef(key, recorder);
-		} }),
-		recorder
-	};
-};
-//#endregion
-export { PREDICATE_REF, VARIABLE_REF, VariableRecorder, createVariablesProxy, isPredicateRef, isVariableRef, printPredicateRef };
-
-//# sourceMappingURL=variables.js.map

package/dist/version-BITr58kk.js

@@ -1,96 +0,0 @@
-import { stringAttribute } from "./ast.js";
-//#region src/channel-text.ts
-const interpolationText = (node, width) => {
-	if (width === "literal") return node.syntax === "curly" ? `{{${node.name}}}` : `\${${node.name}}`;
-	return "x".repeat(width.worstCaseChars);
-};
-const ifBranches = (node) => {
-	const elseNode = node.children.find((child) => child.kind === "element" && child.tag === "Else");
-	return {
-		then: node.children.filter((child) => !(child.kind === "element" && child.tag === "Else")),
-		otherwise: elseNode?.children ?? []
-	};
-};
-/** Verbatim flow → compiled text with `sml:` conditional markers embedded. */
-const flattenChannelText = (nodes) => {
-	let result = "";
-	for (const node of nodes) {
-		if (node.kind === "text") {
-			result += node.value;
-			continue;
-		}
-		if (node.kind === "interpolation") {
-			result += interpolationText(node, "literal");
-			continue;
-		}
-		const test = stringAttribute(node, "test") ?? "";
-		const { then, otherwise } = ifBranches(node);
-		result += `<!--sml:if:${node.id} ${test}-->${flattenChannelText(then)}`;
-		if (otherwise.length > 0) result += `<!--sml:else:${node.id}-->${flattenChannelText(otherwise)}`;
-		result += `<!--sml:endif:${node.id}-->`;
-	}
-	return result;
-};
-/** Safety valve: beyond this many branch combinations, stop forking. */
-const MAX_VARIANTS = 256;
-/**
-* Every possible send-time rendering of a verbatim flow (each `<If>` resolved
-* both ways), marker-free. Selected branches are trimmed exactly like
-* resolveArtifactConditionals trims them, so measured lengths match what a
-* recipient can actually receive. Capped at MAX_VARIANTS combinations —
-* beyond the cap later `<If>`s stop forking (their true branch is kept),
-* which keeps worst-case analysis approximate instead of exponential.
-*/
-const channelTextVariants = (nodes, width) => {
-	let variants = [""];
-	const append = (suffixes) => {
-		if (suffixes.length === 1) {
-			variants = variants.map((variant) => variant + suffixes[0]);
-			return;
-		}
-		const next = [];
-		for (const variant of variants) {
-			for (const suffix of suffixes) {
-				next.push(variant + suffix);
-				if (next.length >= MAX_VARIANTS) break;
-			}
-			if (next.length >= MAX_VARIANTS) break;
-		}
-		variants = next;
-	};
-	for (const node of nodes) {
-		if (node.kind === "text") {
-			append([node.value]);
-			continue;
-		}
-		if (node.kind === "interpolation") {
-			append([interpolationText(node, width)]);
-			continue;
-		}
-		const { then, otherwise } = ifBranches(node);
-		const thenVariants = channelTextVariants(then, width).map((variant) => variant.trim());
-		const elseVariants = channelTextVariants(otherwise, width).map((variant) => variant.trim());
-		const branchVariants = [.../* @__PURE__ */ new Set([...thenVariants, ...elseVariants])];
-		append(variants.length * branchVariants.length > MAX_VARIANTS ? [thenVariants[0] ?? ""] : branchVariants);
-	}
-	return [...new Set(variants)];
-};
-/**
-* The primary send-time rendering: every `<If>` takes its true branch (the
-* branch that carries the main copy by convention). Used for the single
-* `estimatedSegments` number and the opt-out check.
-*/
-const primaryChannelText = (nodes, width) => {
-	let result = "";
-	for (const node of nodes) if (node.kind === "text") result += node.value;
-	else if (node.kind === "interpolation") result += interpolationText(node, width);
-	else result += primaryChannelText(ifBranches(node).then, width).trim();
-	return result;
-};
-//#endregion
-//#region src/version.ts
-const COMPILER_VERSION = "0.1.0";
-//#endregion
-export { primaryChannelText as i, channelTextVariants as n, flattenChannelText as r, COMPILER_VERSION as t };
-
-//# sourceMappingURL=version-BITr58kk.js.map