@samva/markup 0.8.0 → 0.9.0

package/dist/template-DWftqh4x.d.ts

@@ -1,60 +0,0 @@
-import { m as EmailNode } from "./elements-BzjjnoCS.js";
-import { r as InputSchema } from "./input-schema-7dPFVvNE.js";
-import { StandardJSONSchemaV1 } from "@standard-schema/spec";
-//#region src/template.d.ts
-/** One actual-input render owns all of a message's authored content. */
-interface EmailContent {
-  readonly subject: string;
-  readonly preheader?: string;
-  readonly body: EmailNode;
-  readonly text?: string;
-}
-/**
- * Fixed ambient values a template declares. Rendering has no clock and no entropy source: reading
- * the current instant or a random value throws unless the matching value is declared here, so a
- * message either takes time and randomness from its input or states them once as configuration.
- */
-interface TemplateRuntime {
-  readonly now?: number;
-  readonly randomSeed?: number;
-}
-/** Explicit template identity distinguishes entries from imported helper modules. */
-interface TemplateDefinition<Input> {
-  readonly id: string;
-  readonly schema: InputSchema<Input>;
-  readonly fixtures: Readonly<Record<string, Input>>;
-  readonly render: (input: Input) => EmailContent;
-  readonly runtime?: TemplateRuntime;
-}
-/** Classify an evaluated module export without executing helpers as templates. */
-declare const isTemplateDefinition: (value: unknown) => value is TemplateDefinition<unknown>;
-/**
- * The one naming contract for a template id and a fixture key: a letter, a digit or `_` first,
- * then those plus `.`, `_` and `-`.
- *
- * Both names are written into file paths — a local export writes one page at
- * `templates/<id>/<fixture>.html` — so each has to be a single plain path segment. The rule lives
- * at the declaration, so a project that could not be exported is refused where the name is
- * written rather than at the end of a build. Consumers that resolve a path from these names
- * import this pattern; they do not restate it.
- */
-declare const TEMPLATE_NAME_PATTERN: RegExp;
-/**
- * Define an email template with caller-input inference from a Standard JSON Schema converter. The
- * helper is named for its channel because its render result is email content; `TemplateDefinition`
- * and `TemplateInput` stay channel-neutral.
- */
-declare const defineEmail: <S extends StandardJSONSchemaV1>(definition: {
-  readonly id: string;
-  readonly schema: S;
-  readonly fixtures: Readonly<Record<string, NoInfer<StandardJSONSchemaV1.InferInput<S>>>>;
-  readonly render: (input: NoInfer<StandardJSONSchemaV1.InferInput<S>>) => EmailContent;
-  readonly runtime?: TemplateRuntime;
-}) => TemplateDefinition<StandardJSONSchemaV1.InferInput<S>>;
-/** Caller input for generated references and separate authoring consumers. */
-type TemplateInput<T extends {
-  readonly render: (input: never) => EmailContent;
-}> = Parameters<T["render"]>[0];
-//#endregion
-export { TemplateRuntime as a, TemplateInput as i, TEMPLATE_NAME_PATTERN as n, defineEmail as o, TemplateDefinition as r, isTemplateDefinition as s, EmailContent as t };
-//# sourceMappingURL=template-DWftqh4x.d.ts.map

package/dist/tsx-source-instrumentation.d.ts

@@ -1,30 +0,0 @@
-//#region src/tsx-source-instrumentation.d.ts
-declare const TsxSourceInstrumentationError_base: import("better-result").TaggedErrorClass<"TsxSourceInstrumentationError">;
-/**
- * The authored TSX could not be instrumented. `location` is the 1-based line
- * and column the refusal points at, when the parser or the offending attribute
- * names one.
- */
-declare class TsxSourceInstrumentationError extends TsxSourceInstrumentationError_base<{
-  readonly message: string;
-  readonly location: {
-    readonly line: number;
-    readonly column: number;
-  } | undefined;
-  readonly cause?: unknown;
-}> {}
-/**
- * Add ephemeral source-origin props to one known TSX entry before a hosted
- * editor preview is bundled. The returned source is a build input only: the
- * caller must never persist it or expose it as authored source.
- *
- * Every JSX element is marked, including custom components. The markup runtime
- * strips the marker and keeps an inner element's sidecar when a custom
- * component renders JSX of its own. JSX fragments have no element output and
- * are therefore intentionally skipped. Pass a null import source to preserve
- * authored JSX pragmas in executable email builds.
- */
-declare const instrumentTsxSourceForPreview: (source: string, fileName: string, token?: string, jsxImportSource?: string | null) => string;
-//#endregion
-export { TsxSourceInstrumentationError, instrumentTsxSourceForPreview };
-//# sourceMappingURL=tsx-source-instrumentation.d.ts.map

package/dist/tsx-source-instrumentation.js

@@ -1,115 +0,0 @@
-import { n as isObject } from "./guards-eV1qLbf2.js";
-import { JSX_SOURCE_LOCATION_PROP } from "./source-locations.js";
-import { buildLineMap, lineColumn } from "./diagnostics.js";
-import { TaggedError } from "better-result";
-import { parse } from "@babel/parser";
-//#region src/tsx-source-instrumentation.ts
-/**
-* The authored TSX could not be instrumented. `location` is the 1-based line
-* and column the refusal points at, when the parser or the offending attribute
-* names one.
-*/
-var TsxSourceInstrumentationError = class extends TaggedError("TsxSourceInstrumentationError") {};
-const isAstNode = (value) => isObject(value) && typeof value.type === "string" && typeof value.start === "number" && typeof value.end === "number";
-const walkAst = (value, visit) => {
-	if (Array.isArray(value)) {
-		for (const item of value) walkAst(item, visit);
-		return;
-	}
-	if (!isObject(value)) return;
-	if (isAstNode(value)) visit(value);
-	for (const [key, child] of Object.entries(value)) {
-		if (key === "loc" || key === "extra" || key === "comments" || key === "tokens") continue;
-		walkAst(child, visit);
-	}
-};
-const jsxIdentifier = (value) => {
-	if (!isAstNode(value) || value.type !== "JSXIdentifier") return void 0;
-	return typeof value.name === "string" ? value.name : void 0;
-};
-const parseErrorMessage = (error) => isObject(error) && typeof error.message === "string" ? error.message : "The authored TSX could not be parsed for preview instrumentation.";
-/** Babel reports a 1-based line and a 0-based column. */
-const parseErrorLocation = (error) => {
-	if (!isObject(error) || !isObject(error.loc)) return void 0;
-	const { line, column } = error.loc;
-	return typeof line === "number" && typeof column === "number" ? {
-		line,
-		column: column + 1
-	} : void 0;
-};
-const marker = (fileName, source, offset, token) => {
-	const position = lineColumn(buildLineMap(source), offset);
-	return ` ${JSX_SOURCE_LOCATION_PROP}={${JSON.stringify({
-		fileName,
-		lineNumber: position.line,
-		columnNumber: position.column,
-		...token === void 0 ? {} : { token }
-	})}}`;
-};
-/**
-* Add ephemeral source-origin props to one known TSX entry before a hosted
-* editor preview is bundled. The returned source is a build input only: the
-* caller must never persist it or expose it as authored source.
-*
-* Every JSX element is marked, including custom components. The markup runtime
-* strips the marker and keeps an inner element's sidecar when a custom
-* component renders JSX of its own. JSX fragments have no element output and
-* are therefore intentionally skipped. Pass a null import source to preserve
-* authored JSX pragmas in executable email builds.
-*/
-const instrumentTsxSourceForPreview = (source, fileName, token, jsxImportSource = "@samva/preview-runtime") => {
-	let parsed;
-	try {
-		parsed = parse(source, {
-			plugins: ["typescript", "jsx"],
-			sourceType: "module"
-		});
-	} catch (error) {
-		throw new TsxSourceInstrumentationError({
-			cause: error,
-			message: parseErrorMessage(error),
-			location: parseErrorLocation(error)
-		});
-	}
-	const edits = [];
-	for (const comment of jsxImportSource === null ? [] : parsed.comments ?? []) {
-		const commentStart = comment.start;
-		const commentEnd = comment.end;
-		if (commentStart === void 0 || commentEnd === void 0) continue;
-		const commentSource = source.slice(commentStart, commentEnd);
-		for (const match of commentSource.matchAll(/@jsxImportSource\s+[^\s*]+/gu)) {
-			if (match.index === void 0) continue;
-			edits.push({
-				start: commentStart + match.index,
-				end: commentStart + match.index + match[0].length,
-				value: `@jsxImportSource ${jsxImportSource}`
-			});
-		}
-	}
-	walkAst(parsed.program, (node) => {
-		if (node.type !== "JSXElement") return;
-		const openingElement = node.openingElement;
-		if (!isAstNode(openingElement)) return;
-		const attributes = openingElement.attributes;
-		if (Array.isArray(attributes)) for (const attribute of attributes) {
-			if (!isAstNode(attribute) || attribute.type !== "JSXAttribute") continue;
-			if (jsxIdentifier(attribute.name) === "__samva_source_location") throw new TsxSourceInstrumentationError({
-				message: `The reserved JSX prop ${JSX_SOURCE_LOCATION_PROP} cannot be authored directly.`,
-				location: lineColumn(buildLineMap(source), attribute.start)
-			});
-		}
-		const closingLength = source.slice(openingElement.end - 2, openingElement.end) === "/>" ? 2 : 1;
-		edits.push({
-			start: openingElement.end - closingLength,
-			end: openingElement.end - closingLength,
-			value: marker(fileName, source, openingElement.start, token)
-		});
-	});
-	let instrumented = source;
-	for (const edit of edits.toSorted((left, right) => right.start - left.start)) instrumented = instrumented.slice(0, edit.start) + edit.value + instrumented.slice(edit.end);
-	return instrumented;
-};
-//#endregion
-export { TsxSourceInstrumentationError, instrumentTsxSourceForPreview };
-
-//# sourceMappingURL=tsx-source-instrumentation.js.map

package/dist/tsx-tracer.d.ts

@@ -1,112 +0,0 @@
-import { a as Span } from "./diagnostics-OcQKQYSY.js";
-import { SmlOp } from "./ops.js";
-import { Result } from "better-result";
-//#region src/tsx-tracer.d.ts
-/** The closed set of reasons a rendered heading cannot be mapped safely. */
-type TsxHeadingDiagnosticCode = "tsx-invalid-authored-source" | "tsx-invalid-emitted-source" | "tsx-target-not-found" | "tsx-unsupported-target" | "tsx-ambiguous-target" | "tsx-dynamic-target";
-interface TsxHeadingDiagnostic {
-  readonly code: TsxHeadingDiagnosticCode;
-  readonly message: string;
-  readonly span: Span;
-}
-declare const TsxHeadingTraceError_base: import("better-result").TaggedErrorClass<"TsxHeadingTraceError">;
-declare class TsxHeadingTraceError extends TsxHeadingTraceError_base<{
-  readonly diagnostics: ReadonlyArray<TsxHeadingDiagnostic>;
-}> {}
-/**
- * Source metadata attached to a rendered JSX node by the development JSX
- * transform, or an equivalent exact source span from a host.
- *
- * `lineNumber`/`columnNumber` use the JSX transform convention: both are
- * one-based and identify the opening `<` of the element. A span locator is
- * useful to hosts that already have absolute offsets and must match the whole
- * JSX element span exactly.
- */
-type TsxSourceLocator = {
-  readonly fileName: string;
-  readonly lineNumber: number;
-  readonly columnNumber: number;
-} | {
-  readonly fileName: string;
-  readonly span: Span;
-};
-/**
- * How an authored static text child spells itself. `jsx-text` is bare text
- * between tags; `string-literal` is a `{"…"}` expression container holding a
- * string literal, or a template literal with no expressions. An edit writes a
- * child back in the form it already had.
- */
-type StaticTextForm = "jsx-text" | "string-literal";
-/** A source range containing only the text bytes that an edit is allowed to replace. */
-interface TsxHeadingSourceTarget {
-  readonly nodeId: string;
-  readonly text: string;
-  readonly span: Span;
-  /** The spelling to preserve when the range is rewritten. */
-  readonly form: StaticTextForm;
-}
-interface TraceTsxHeadingInput {
-  /** The canonical TSX entry file path. */
-  readonly authoredFile: string;
-  /** The canonical TSX entry file. */
-  readonly authoredSource: string;
-  /** The last-good SML preview derived from that entry file. */
-  readonly emittedSource: string;
-  /** The selected semantic SML node id. */
-  readonly nodeId: string;
-  /** Exact runtime/source-map provenance for the selected JSX node. */
-  readonly sourceLocator?: TsxSourceLocator | undefined;
-}
-interface ReplaceTsxHeadingTextInput extends TraceTsxHeadingInput {
-  readonly text: string;
-}
-type TsxHeadingTrace = Result<TsxHeadingSourceTarget, TsxHeadingTraceError>;
-type TsxHeadingEdit = Result<string, TsxHeadingTraceError>;
-/** Resolve one rendered Heading to one direct-literal JSX text range. */
-declare const traceTsxHeadingTarget: (input: TraceTsxHeadingInput) => TsxHeadingTrace;
-/** Replace only the mapped literal bytes; all other authored TSX stays untouched. */
-declare const replaceTsxHeadingText: (input: ReplaceTsxHeadingTextInput) => TsxHeadingEdit;
-/**
- * The closed set of failures returned by {@link applyTsxSmlOps}. The editor
- * deliberately treats these as a typed "not safe to edit" response: it can
- * keep showing the preview and offer source editing without guessing at a
- * byte range in a user's project.
- */
-type TsxSmlDiagnosticCode = TsxHeadingDiagnosticCode | "tsx-invalid-snippet" | "tsx-unsupported-operation";
-interface TsxSmlDiagnostic {
-  readonly code: TsxSmlDiagnosticCode;
-  readonly message: string;
-  readonly span: Span;
-}
-declare const TsxSmlOpsError_base: import("better-result").TaggedErrorClass<"TsxSmlOpsError">;
-declare class TsxSmlOpsError extends TsxSmlOpsError_base<{
-  readonly diagnostics: ReadonlyArray<TsxSmlDiagnostic>;
-}> {}
-interface ApplyTsxSmlOpsInput {
-  /** The canonical TSX entry file path. */
-  readonly authoredFile: string;
-  /** The canonical TSX entry file. */
-  readonly authoredSource: string;
-  /** The last-good SML preview derived from that entry file. */
-  readonly emittedSource: string;
-  /** Revision-fenced JSX origins for the SML ids in `emittedSource`. */
-  readonly sourceLocations: {
-    readonly byNodeId: Readonly<Record<string, TsxSourceLocator>>;
-  };
-  /** SML operations evaluated against the emitted-source id snapshot. */
-  readonly ops: ReadonlyArray<SmlOp>;
-}
-type TsxSmlOpsResult = Result<string, TsxSmlOpsError>;
-/**
- * Apply semantic editor operations to the authored TSX entry.
- *
- * The emitted SML document remains the validation oracle: operations are
- * preflighted through the same markup op implementation first, then each
- * mapped target is checked against the authored JSX AST and exact source
- * provenance. The mutable source tree below only moves original AST nodes or
- * inserts validated raw fragments; it never reprints the user's module.
- */
-declare const applyTsxSmlOps: (input: ApplyTsxSmlOpsInput) => TsxSmlOpsResult;
-//#endregion
-export { ApplyTsxSmlOpsInput, ReplaceTsxHeadingTextInput, StaticTextForm, TraceTsxHeadingInput, TsxHeadingDiagnostic, TsxHeadingDiagnosticCode, TsxHeadingEdit, TsxHeadingSourceTarget, TsxHeadingTrace, TsxHeadingTraceError, TsxSmlDiagnostic, TsxSmlDiagnosticCode, TsxSmlOpsError, TsxSmlOpsResult, TsxSourceLocator, applyTsxSmlOps, replaceTsxHeadingText, traceTsxHeadingTarget };
-//# sourceMappingURL=tsx-tracer.d.ts.map