@samva/markup 0.9.0 → 0.11.0

package/dist/theme-imports-lvBw3AD1.js

@@ -1,109 +0,0 @@
-import { buildLineMap, lineColumn } from "./diagnostics.js";
-import { parse } from "css-tree";
-//#region src/email/theme-imports.ts
-/** The CSS and TSX specifier a template uses to reach its organization's brand. */
-const BRAND_SPECIFIER = "samva:brand";
-const BRAND_IMPORT = /^samva:brand(?:\/([a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?))?$/;
-/** The brand a `samva:brand` specifier names: `undefined` slug means the default brand. */
-const parseBrandSpecifier = (specifier) => {
-	const match = BRAND_IMPORT.exec(specifier);
-	return match === null ? void 0 : { slug: match[1] };
-};
-/** The directory part of a project path, with no trailing slash (`""` at the root). */
-const projectDirectory = (path) => path.includes("/") ? path.slice(0, path.lastIndexOf("/")) : "";
-/** A relative or root-absolute stylesheet reference, resolved from a project directory. */
-const resolveFromDirectory = (directory, reference) => {
-	const segments = reference.startsWith("/") || directory === "" ? [] : directory.split("/");
-	for (const segment of reference.split("/")) {
-		if (segment === "" || segment === ".") continue;
-		if (segment === "..") {
-			if (segments.length === 0) return void 0;
-			segments.pop();
-		} else segments.push(segment);
-	}
-	return segments.length === 0 ? void 0 : segments.join("/");
-};
-const importTarget = (node) => {
-	if (node.type !== "Atrule" || node.prelude === null || node.prelude.type !== "AtrulePrelude") return { extra: true };
-	const parts = [...node.prelude.children].filter((part) => part.type !== "WhiteSpace");
-	const first = parts[0];
-	const target = first?.type === "String" ? first.value : first?.type === "Url" ? first.value : void 0;
-	return target === void 0 ? { extra: true } : {
-		target,
-		extra: parts.length > 1
-	};
-};
-/**
-* Walk the theme's `@import` graph. Project `.css` files resolve from the
-* importing file's directory; `samva:brand` and `samva:brand/<slug>` are
-* recorded for the brand the build supplies. Anything else is an error.
-*/
-const resolveThemeImports = (themePath, themeCss, files) => {
-	const stylesheets = /* @__PURE__ */ new Map([[themePath, themeCss]]);
-	const brandSpecifiers = /* @__PURE__ */ new Set();
-	const diagnostics = [];
-	const visit = (path, source, chain) => {
-		const lineMap = buildLineMap(source);
-		const ast = parse(source, {
-			positions: true,
-			parseValue: false,
-			parseRulePrelude: false
-		});
-		if (ast.type !== "StyleSheet") return;
-		for (const node of ast.children) {
-			if (node.type !== "Atrule" || node.name.toLowerCase() !== "import") continue;
-			const position = lineColumn(lineMap, node.loc?.start.offset ?? 0);
-			const origins = [{
-				fileName: path,
-				lineNumber: position.line,
-				columnNumber: position.column
-			}];
-			const refuse = (message) => diagnostics.push({
-				code: "css-import-unresolved",
-				severity: "error",
-				message,
-				origins
-			});
-			const { target, extra } = importTarget(node);
-			if (target === void 0) {
-				refuse(`${path}: @import needs a quoted stylesheet path or "samva:brand".`);
-				continue;
-			}
-			if (extra) {
-				refuse(`${path}: @import ${JSON.stringify(target)} takes no layer, supports or media conditions; the import order is the layering.`);
-				continue;
-			}
-			if (parseBrandSpecifier(target) !== void 0) {
-				brandSpecifiers.add(target);
-				continue;
-			}
-			if (!/^\.{0,2}\//.test(target) || !/\.css$/i.test(target.replace(/[?#].*$/, ""))) {
-				refuse(`${path}: @import ${JSON.stringify(target)} is not a project stylesheet or "samva:brand". The compiler supplies Tailwind itself; import project .css files by relative path.`);
-				continue;
-			}
-			const resolved = resolveFromDirectory(projectDirectory(path), target.replace(/[?#].*$/, ""));
-			const content = resolved === void 0 ? void 0 : files[resolved];
-			if (resolved === void 0 || typeof content !== "string") {
-				refuse(`${path}: @import ${JSON.stringify(target)} names no stylesheet in the project.`);
-				continue;
-			}
-			if (chain.includes(resolved)) {
-				refuse(`${path}: @import ${JSON.stringify(target)} imports itself through ${chain.join(" → ")}.`);
-				continue;
-			}
-			if (stylesheets.has(resolved)) continue;
-			stylesheets.set(resolved, content);
-			visit(resolved, content, [...chain, resolved]);
-		}
-	};
-	visit(themePath, themeCss, [themePath]);
-	return {
-		stylesheets,
-		brandSpecifiers: [...brandSpecifiers].sort(),
-		diagnostics
-	};
-};
-//#endregion
-export { resolveThemeImports as a, resolveFromDirectory as i, parseBrandSpecifier as n, projectDirectory as r, BRAND_SPECIFIER as t };
-
-//# sourceMappingURL=theme-imports-lvBw3AD1.js.map

package/dist/transform-Ct2OMkFN.d.ts

@@ -1,153 +0,0 @@
-import { r as EmailDiagnostic } from "./diagnostics-B-Gym34R.js";
-import { n as EmittedPosition } from "./preview-Ekdg1dXG.js";
-import { i as Stylesheet } from "./css-BVQKICKC.js";
-import { n as AssetEntry } from "./assets-C5duwTya.js";
-import { a as EmailBrand } from "./brand-B-0bN_Ir.js";
-import { caniemail } from "caniemail";
-//#region src/email/compatibility.d.ts
-type CaniemailClient = Parameters<typeof caniemail>[0]["clients"][number];
-/** One client this compiler makes claims about. */
-interface EmailClientTarget {
-  readonly id: CaniemailClient;
-  readonly label: string;
-}
-/**
- * The pinned matrix. Every finding is reported per client, and a client absent
- * from this list is a client Samva makes no claim about.
- */
-declare const EMAIL_CLIENT_MATRIX: readonly EmailClientTarget[];
-interface CompatibilityProvenance {
-  /** The exact rules package a finding came from. */
-  readonly rules: string;
-  readonly apiVersion: string;
-  /** The day caniemail last changed the data this build was checked against. */
-  readonly lastUpdate: string;
-}
-declare const COMPATIBILITY_PROVENANCE: CompatibilityProvenance;
-/**
- * The constructs whose loss actually breaks a message: the recipient reads
- * something different, in a different order, follows a link that does not work,
- * or sees a layout that has collapsed. A target client dropping one of these
- * blocks publication.
- *
- * The list is deliberately short and enumerated, because the contract is to
- * block *known* failures. Nonessential differences require an assessment of
- * emitted values: a concrete risk warns, expected differences and unverified
- * behavior remain compatibility observations.
- */
-declare const ESSENTIAL_CONSTRUCTS: ReadonlySet<string>;
-interface CompatibilityInput {
-  /** The document the recipient receives. */
-  readonly html: string;
-  /** The declared fixture checked by this invocation. */
-  readonly fixture?: string | undefined;
-  /** Retained head rules, when they are not already inside the HTML. */
-  readonly css?: string | undefined;
-  /** Emitted-offset ranges with the origins of the node that produced them. */
-  readonly positions?: readonly EmittedPosition[] | undefined;
-  readonly clients?: readonly EmailClientTarget[] | undefined;
-}
-/**
- * Check the emitted document against the pinned matrix.
- *
- * Findings are grouped by construct rather than repeated per client, so one
- * unsupported property is one diagnostic naming every client that drops it.
- */
-declare const checkEmailCompatibility: (input: CompatibilityInput) => readonly EmailDiagnostic[];
-/**
- * Constructs the pinned data says nothing about for a target client. These are
- * reported so "we did not check that" is never mistaken for "that works".
- */
-declare const unknownCoverage: (titles: Iterable<string>) => readonly EmailDiagnostic[];
-/** A publication carrying one of these is refused; the message would arrive broken. */
-declare const hasBlockingCompatibility: (findings: readonly EmailDiagnostic[]) => boolean;
-//#endregion
-//#region src/email/tailwind.d.ts
-interface TailwindOptions {
-  /**
-   * Project CSS appended to the compiled entry: `@theme` overrides, `@utility`
-   * definitions and ordinary rules. This is the project's pinned configuration.
-   */
-  readonly css?: string | undefined;
-  /**
-   * The project path `css` was read from (`theme.css` by default). Its
-   * relative `@import`s resolve from this file's directory.
-   */
-  readonly cssPath?: string | undefined;
-  /** Classes the compiler cannot discover, declared by the project on purpose. */
-  readonly safelist?: readonly string[] | undefined;
-  /** Tailwind's browser reset is off by default; email clients do not want it. */
-  readonly preflight?: boolean | undefined;
-  /**
-   * Bounds on what the compiler may generate. Class discovery reads authored
-   * source, so a project can hand it an unbounded candidate set and get an
-   * unbounded stylesheet back — inside a build that has a wall clock and a
-   * bundle a Worker then has to load. A host that publishes supplies these.
-   */
-  readonly limits?: TailwindLimits | undefined;
-}
-interface TailwindLimits {
-  /** Distinct classes handed to the compiler. */
-  readonly candidates: number;
-  /** Bytes of generated CSS. */
-  readonly cssBytes: number;
-}
-interface TailwindOutput {
-  readonly css: string;
-  readonly version: string;
-  /** Every candidate handed to the compiler, sorted, for the build manifest. */
-  readonly candidates: readonly string[];
-}
-/**
- * What the project theme's `@import`s resolve to, already checked by
- * `resolveThemeImports`: project stylesheets by path, and the brand theme
- * `samva:brand` stands for.
- */
-interface TailwindImports {
-  readonly stylesheets: ReadonlyMap<string, string>;
-  readonly brandCss?: string | undefined;
-}
-/** Compile the discovered class set into CSS with the pinned Tailwind release. */
-declare const compileTailwind: (candidates: Iterable<string>, options?: TailwindOptions, imports?: TailwindImports) => Promise<TailwindOutput>;
-interface ClassDiscovery {
-  readonly candidates: readonly string[];
-  readonly diagnostics: readonly EmailDiagnostic[];
-}
-/**
- * Collect the class names one module states literally, and report the positions
- * where a class is assembled from values the compiler cannot see.
- */
-declare const discoverClassCandidates: (source: string, fileName: string) => ClassDiscovery;
-//#endregion
-//#region src/email/transform.d.ts
-/** Where this build serves assets from, and how Tailwind is configured. */
-interface TransformOptions {
-  readonly assetBase: string;
-  /** `false` compiles no Tailwind at all. */
-  readonly tailwind?: TailwindOptions | false | undefined;
-  /**
-   * The brand `samva:brand` resolves to, supplied by the host. A project that
-   * imports `samva:brand` with no brand here fails to compile.
-   */
-  readonly brand?: EmailBrand | undefined;
-}
-interface ProjectTransform {
-  readonly assets: readonly AssetEntry[];
-  /** The compiled Tailwind sheet, when the project used any utility class. */
-  readonly tailwindSheet: Stylesheet | undefined;
-  /** Every project stylesheet, parsed, by path. */
-  readonly stylesheets: ReadonlyMap<string, Stylesheet>;
-  readonly diagnostics: readonly EmailDiagnostic[];
-}
-/**
- * The `samva:brand` specifier a project imports — from its theme's `@import`s
- * or its TSX — so a host can fetch that brand before it compiles. `undefined`
- * when the project imports no brand. A project that names two brands gets the
- * first here and a refusal from the compile.
- */
-declare const projectBrandSpecifier: (files: Readonly<Record<string, string | Uint8Array>>, themePath?: string) => string | undefined;
-/** Read a whole project, then compile the classes its scripts used. */
-declare const transformProject: (files: Readonly<Record<string, string | Uint8Array>>, options: TransformOptions) => Promise<ProjectTransform>;
-//#endregion
-export { checkEmailCompatibility as _, ClassDiscovery as a, TailwindOutput as c, COMPATIBILITY_PROVENANCE as d, CompatibilityInput as f, EmailClientTarget as g, ESSENTIAL_CONSTRUCTS as h, transformProject as i, compileTailwind as l, EMAIL_CLIENT_MATRIX as m, TransformOptions as n, TailwindLimits as o, CompatibilityProvenance as p, projectBrandSpecifier as r, TailwindOptions as s, ProjectTransform as t, discoverClassCandidates as u, hasBlockingCompatibility as v, unknownCoverage as y };
-//# sourceMappingURL=transform-Ct2OMkFN.d.ts.map

package/dist/unsubscribe-link-CoesnQDU.js

@@ -1,26 +0,0 @@
-//#region src/internal/unsubscribe-link.ts
-/**
-* Marks the one link the serializer lets carry the unsubscribe placeholder as
-* its href. Only `BrandFooter` sets it; nothing public exports it, so no
-* author-written link can claim the exemption.
-*/
-const UNSUBSCRIBE_LINK = Symbol("samva.unsubscribe-link");
-/**
-* The per-recipient unsubscribe URL is not known at render: the send path
-* substitutes each delivery's link for this placeholder, or removes the
-* unsubscribe row when the send resolved no unsubscribe group.
-*/
-const UNSUBSCRIBE_URL_PLACEHOLDER = "%samva:unsubscribe-url%";
-/**
-* Marks the elements `BrandFooter` writes the send path's footer markers on.
-* The serializer emits `data-samva-footer` and `data-samva-unsubscribe` only
-* for an element carrying it, so an author cannot claim a footer the send
-* path would then not append.
-*/
-const BRAND_FOOTER_MARKER = Symbol("samva.brand-footer-marker");
-/** The attributes only `BrandFooter` writes. */
-const RESERVED_FOOTER_ATTRIBUTES = /* @__PURE__ */ new Set(["data-samva-footer", "data-samva-unsubscribe"]);
-//#endregion
-export { UNSUBSCRIBE_URL_PLACEHOLDER as i, RESERVED_FOOTER_ATTRIBUTES as n, UNSUBSCRIBE_LINK as r, BRAND_FOOTER_MARKER as t };
-
-//# sourceMappingURL=unsubscribe-link-CoesnQDU.js.map