@samva/markup 0.8.0 → 0.10.0

package/dist/compiler.d.ts

@@ -1,14 +1,8 @@
-import { a as formatEmailDiagnostic, i as EmailDiagnosticSeverity, n as EmailCompileError, o as hasBlockingDiagnostic, r as EmailDiagnostic } from "./diagnostics-BMYtBCQk.js";
-import { a as EmailGlobalProps, c as EmailStyle, d as isUrlAttribute, i as EmailElementSpec, l as EmailTag, m as EmailNode, n as EMAIL_GLOBAL_ATTRIBUTES, o as EmailIntrinsicElements, r as EmailAttributeSpec, s as EmailLayout, t as EMAIL_ELEMENTS, u as emailElement } from "./elements-BzjjnoCS.js";
-import { a as emailDefinitionInstances, c as emailSelectionSiblings, i as emailAuthoringTarget, l as emailSelections, n as EmittedPosition, o as emailSelectionAncestry, r as INSTANCE_PATH_ATTRIBUTE, s as emailSelectionIndex, t as EmailElementSelection } from "./selection-CCArx9lU.js";
-import { a as escapeText, i as escapeAttribute, n as SerializeEmailOptions, s as serializeEmailHtml, t as EmailHtmlOutput } from "./html-Bl9BAdqc.js";
-import { deriveEmailText } from "./email/text.js";
-import { a as compileSelector, c as CompiledSelector, d as matchesSelector, i as Stylesheet, l as Compound, n as CssRule, o as parseStylesheet, r as Specificity, s as Ancestry, t as CssDeclaration, u as classListOf } from "./css-CS2jLID6.js";
-import { EMAIL_DOCTYPE, EmailCompileOutput, RenderedEmail, compileEmail, renderEmail } from "./email/render.js";
-import { ASSET_CONTENT_TYPES, AssetEntry, AssetManifest, assetEntry, assetUrl, checkAssetBase, isAssetPath, isExternalAsset } from "./email/assets.js";
-import { collectStylesheets, hasStylesheets, registerStylesheet, resetStylesheets } from "./email/stylesheets.js";
-import { a as EmailBrand, c as EmailBrandFooter, l as EmailBrandSocialLink, o as EmailBrandAddress, s as EmailBrandAssets } from "./brand-DcoVkh_S.js";
-import { instrumentTsxSourceForPreview } from "./tsx-source-instrumentation.js";
+import { a as TemplateDiagnostic, r as EmailDiagnostic } from "./diagnostics-B-Gym34R.js";
+import { r as EmailNode } from "./jsx-runtime-ylIOnaSf.js";
+import { n as AssetEntry, p as EmailBrand, u as BrandComponents } from "./assets-BIsyMQ92.js";
+import { C as Compound, D as EmittedPosition, S as CompiledSelector, T as matchesSelector, _ as Specificity, b as parseStylesheet, ct as TemplateIr, g as CssRule, h as CssDeclaration, r as RenderedEmail, v as Stylesheet, w as classListOf, x as Ancestry, y as compileSelector } from "./render-BPonDpCl.js";
+import { a as TEMPLATE_NAME_PATTERN, n as EmailContent } from "./template-DMPwxMSq.js";
 import { caniemail } from "caniemail";
 //#region src/email/compatibility.d.ts
 type CaniemailClient = Parameters<typeof caniemail>[0]["clients"][number];
@@ -185,12 +179,6 @@ declare const discoverClassCandidates: (source: string, fileName: string) => Cla
 /** Where this build serves assets from, and how Tailwind is configured. */
 interface TransformOptions {
   readonly assetBase: string;
-  /**
-   * Specifier the generated stylesheet modules import `registerStylesheet`
-   * from. It is the published subpath by default; a host that resolves the
-   * package differently states its own.
-   */
-  readonly stylesheetModule?: string | undefined;
   /** `false` compiles no Tailwind at all. */
   readonly tailwind?: TailwindOptions | false | undefined;
   /**
@@ -199,63 +187,14 @@ interface TransformOptions {
    */
   readonly brand?: EmailBrand | undefined;
 }
-interface ModuleTransform {
-  /** Always JavaScript, whatever the input file was. */
-  readonly code: string;
-  readonly asset?: AssetEntry | undefined;
-  /** Class names this module states literally, for the Tailwind candidate set. */
-  readonly classes?: readonly string[] | undefined;
-  readonly diagnostics: readonly EmailDiagnostic[];
-}
-/**
- * Transform one project file into a JavaScript module.
- *
- * `.tsx`/`.ts` keep their authored semantics and gain source origins. A
- * stylesheet becomes a module that registers its parsed rules; its `@font-face`
- * sources resolve against `assets`, the project's addressed files by path. An
- * imported binary becomes a module exporting the content-addressed URL of its
- * bytes.
- */
-declare const transformModule: (id: string, source: string | Uint8Array, options: TransformOptions, assets?: ReadonlyMap<string, AssetEntry>) => Promise<ModuleTransform>;
 interface ProjectTransform {
-  /** Every input file, transformed; keys are unchanged. */
-  readonly files: Readonly<Record<string, string>>;
   readonly assets: readonly AssetEntry[];
-  /**
-   * The compiled Tailwind sheet as a registering module, when the project used
-   * any utility class. A host writes it at `path` and makes the entry import it
-   * first, so the generated layers sit below the project's own stylesheets.
-   */
-  readonly tailwind: {
-    readonly path: string;
-    readonly code: string;
-  } | undefined;
-  /**
-   * The generated `samva:brand` module, when the project's TSX imports the
-   * brand components. A host writes it at `path`; imports already point there.
-   */
-  readonly brand: {
-    readonly path: string;
-    readonly code: string;
-  } | undefined;
+  /** 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 generated Tailwind module is a real file at the project root, not a
- * virtual id. A virtual module has no directory, so its own relative imports
- * resolve differently from the project's and the bundler ends up with a second
- * copy of the stylesheet registry — the sheet registers into a registry the
- * render never reads.
- */
-declare const TAILWIND_MODULE_PATH = ".samva-tailwind.css";
-/** The specifier an entry at this path uses to reach the generated module. */
-declare const tailwindSpecifierFor: (entryPoint: string) => string;
-/**
- * The generated module `samva:brand` resolves to in TSX. Like the Tailwind
- * module it is a real file at the project root, so it shares the project's
- * copy of `@samva/markup`.
- */
-declare const BRAND_MODULE_PATH = ".samva-brand.ts";
 /**
  * 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`
@@ -263,61 +202,95 @@ declare const BRAND_MODULE_PATH = ".samva-brand.ts";
  * first here and a refusal from the compile.
  */
 declare const projectBrandSpecifier: (files: Readonly<Record<string, string | Uint8Array>>, themePath?: string) => string | undefined;
-/** Run the transform over a whole project, then compile the classes it used. */
+/** 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
+//#region src/email/theme-imports.d.ts
+/** The CSS and TSX specifier a template uses to reach its organization's brand. */
+declare const BRAND_SPECIFIER = "samva:brand";
+/** The brand a `samva:brand` specifier names: `undefined` slug means the default brand. */
+declare const parseBrandSpecifier: (specifier: string) => {
+  readonly slug: string | undefined;
+} | undefined;
+//#endregion
+//#region src/email/brand-footer.d.ts
+/** A footer block for the send path to append, and its plain-text tail. */
+interface RenderedBrandFooter {
+  readonly html: string;
+  readonly text: string;
+}
 /**
- * Put a side-effect import ahead of an entry's own imports, after any leading
- * comment so a `@jsxImportSource` pragma keeps its position. Import order is
- * cascade order, so the generated sheet has to be first.
+ * Render `BrandFooter` against a brand on its own, for the send path to
+ * append to a message whose template renders no footer of its own. It
+ * compiles the same component, styled by the same brand theme, a template
+ * would get from `samva:brand`. Without `unsubscribe` the unsubscribe row is
+ * left out.
  */
-declare const withLeadingImport: (source: string, specifier: string) => string;
-/** The generated entry every host builds, so both evaluate the same module. */
-declare const EMAIL_ENTRY_WRAPPER = ".samva-email-entry.ts";
+declare const renderBrandFooter: (brand: EmailBrand, options: {
+  readonly unsubscribe: boolean;
+}) => Promise<RenderedBrandFooter>;
 /**
- * The generated module that clears the stylesheet registry. It is imported
- * first, as its own module, because import order is evaluation order: a reset
- * written as a statement in the wrapper would run after the wrapper's imports
- * had already registered.
+ * Render content against a brand as a project whose `theme.css` is
+ * `@import "samva:brand";` renders it: Tailwind compiles the brand theme for
+ * the classes the content names, `BrandLogo` and `BrandFooter` are bound to the
+ * brand, and the render inlines the result. A brand preview renders through
+ * this, so it shows what a template importing the brand compiles to.
  */
-declare const EMAIL_RESET_MODULE = ".samva-email-reset.ts";
+declare const renderBrandSample: (brand: EmailBrand, sample: {
+  /** Every class the content names; nothing is discovered from source here. */
+  readonly classes: readonly string[];
+  readonly render: (components: BrandComponents) => EmailContent;
+}) => Promise<RenderedEmail>;
+//#endregion
+//#region src/sml/lower-project.d.ts
+interface CompiledTemplate {
+  /** The IR, or `undefined` when a finding blocks it. */
+  readonly ir: TemplateIr | undefined;
+  /** The fixtures read from the entry, with imported assets resolved to their URLs. */
+  readonly fixtures: Readonly<Record<string, unknown>>;
+  readonly assets: readonly AssetEntry[];
+  /** Errors block the IR; warnings ride along. */
+  readonly diagnostics: readonly TemplateDiagnostic[];
+}
+//#endregion
+//#region src/sml/compile.d.ts
+interface CompileTemplateOptions extends TransformOptions {
+  /** The project's files by path. Binary files are addressed as assets. */
+  readonly files: Readonly<Record<string, string | Uint8Array>>;
+  /** The entry: a `.tsx` file that default-exports `defineTemplate({ ... })`. */
+  readonly entry: string;
+  /**
+   * The portable JSON Schema, for an entry whose `schema` is not a literal `jsonSchema(...)`
+   * (a Zod or Effect schema needs a library to become JSON Schema). A host that has evaluated the
+   * schema passes its conversion here; a literal schema is read from source and this is ignored.
+   */
+  readonly schema?: Readonly<Record<string, unknown>> | undefined;
+}
+/** Compile a project's entry template to IR without evaluating any of it. */
+declare const compileTemplate: (options: CompileTemplateOptions) => Promise<CompiledTemplate>;
+//#endregion
+//#region src/sml/compatibility.d.ts
 /**
- * The wrapper's source. It exports the template beside a render bound to the
- * sheets the project's own imports registered, so the render runs inside the
- * project's module graph and keeps its styles when a later project loaded into
- * the same process resets the registry. Importing the renderer from outside
- * that graph reaches a second copy of the registry and silently renders unstyled.
+ * Check what each declared fixture delivers against the pinned client matrix. The rules run on the
+ * rendered document, because what a client drops is what the compiler produced, and every finding
+ * is located at the source of the element that produced it.
  */
-declare const emailEntryWrapper: (entryPoint: string, imports?: readonly string[]) => string;
+declare const checkTemplateCompatibility: (ir: TemplateIr, fixtures: Readonly<Record<string, unknown>>, options?: {
+  readonly clients?: readonly EmailClientTarget[] | undefined;
+}) => readonly EmailDiagnostic[];
+//#endregion
+//#region src/sml/profile.d.ts
 /**
- * A host that renders more than one project in one process shares the registry
- * through its module cache, so every project graph starts by clearing it.
+ * Check an entry against the static profile. Pass the entry's source alone, or the project's files
+ * and the entry's path. Imports of files that are absent are trusted to exist, and the brand,
+ * Tailwind and theme are not resolved, so the result holds only findings the source itself owns.
  */
-declare const emailResetModule: (options: TransformOptions) => string;
-interface CompiledEmailProject {
-  /** Every module as JavaScript, keyed by its authored path. */
-  readonly files: Readonly<Record<string, string>>;
-  /** The generated module a host bundles or evaluates. */
-  readonly entryPoint: string;
-  /** The project's own entry, which the wrapper re-exports. */
-  readonly authoredEntry: string;
-  readonly assets: readonly AssetEntry[];
-  readonly diagnostics: readonly EmailDiagnostic[];
-}
+declare const checkStaticProfile: (files: string | Readonly<Record<string, string | Uint8Array>>, entry?: string) => readonly TemplateDiagnostic[];
 /**
- * The whole compile step, files in and files out: every module transformed, the
- * generated Tailwind sheet written, the generated imports added and the wrapper
- * built. Both hosts call exactly this, which is what stops their outputs from
- * drifting apart.
+ * The errors in `after` that `before` did not already have, compared by code and message so a
+ * finding that only moved does not count as new.
  */
-declare const compileEmailProject: (source: Readonly<Record<string, string | Uint8Array>>, authoredEntry: string, options: TransformOptions) => Promise<CompiledEmailProject>;
-//#endregion
-//#region src/email/theme-imports.d.ts
-/** The CSS and TSX specifier a template uses to reach its organization's brand. */
-declare const BRAND_SPECIFIER = "samva:brand";
-/** The brand a `samva:brand` specifier names: `undefined` slug means the default brand. */
-declare const parseBrandSpecifier: (specifier: string) => {
-  readonly slug: string | undefined;
-} | undefined;
+declare const introducedProfileErrors: (before: readonly TemplateDiagnostic[], after: readonly TemplateDiagnostic[]) => readonly TemplateDiagnostic[];
 //#endregion
-export { ASSET_CONTENT_TYPES, type Ancestry, type AppliedStyles, type AssetEntry, type AssetManifest, BRAND_MODULE_PATH, BRAND_SPECIFIER, COMPATIBILITY_PROVENANCE, type ClassDiscovery, type CompatibilityInput, type CompatibilityProvenance, type CompiledEmailProject, type CompiledSelector, type Compound, type CssDeclaration, type CssRule, EMAIL_CLIENT_MATRIX, EMAIL_DOCTYPE, EMAIL_ELEMENTS, EMAIL_ENTRY_WRAPPER, EMAIL_GLOBAL_ATTRIBUTES, EMAIL_RESET_MODULE, ESSENTIAL_CONSTRUCTS, type EmailAttributeSpec, type EmailBrand, type EmailBrandAddress, type EmailBrandAssets, type EmailBrandFooter, type EmailBrandSocialLink, type EmailClientTarget, EmailCompileError, type EmailCompileOutput, type EmailDiagnostic, type EmailDiagnosticSeverity, type EmailElementSelection, type EmailElementSpec, type EmailGlobalProps, type EmailHtmlOutput, type EmailIntrinsicElements, type EmailLayout, type EmailStyle, type EmailTag, type EmittedPosition, INSTANCE_PATH_ATTRIBUTE, type ModuleTransform, type ProjectTransform, type RenderedEmail, type SerializeEmailOptions, type Specificity, type Stylesheet, TAILWIND_MODULE_PATH, TAILWIND_VERSION, type TailwindLimits, type TailwindOptions, type TailwindOutput, type TransformOptions, applyStylesheet, assetEntry, assetUrl, checkAssetBase, checkEmailCompatibility, classListOf, collectStylesheets, compileEmail, compileEmailProject, compileSelector, compileTailwind, deriveEmailText, discoverClassCandidates, downlevelColors, downlevelMediaQuery, emailAuthoringTarget, emailDefinitionInstances, emailElement, emailEntryWrapper, emailResetModule, emailSelectionAncestry, emailSelectionIndex, emailSelectionSiblings, emailSelections, escapeAttribute, escapeText, finalizeValue, foldCalc, formatColor, formatEmailDiagnostic, hasBlockingCompatibility, hasBlockingDiagnostic, hasStylesheets, instrumentTsxSourceForPreview, isAssetPath, isExternalAsset, isUrlAttribute, matchesSelector, parseBrandSpecifier, parseColor, parseStylesheet, projectBrandSpecifier, registerStylesheet, renderEmail, renderHeadCss, resetStylesheets, resolveVariables, serializeEmailHtml, tailwindSpecifierFor, transformModule, transformProject, unknownCoverage, withLeadingImport };
+export { type Ancestry, type AppliedStyles, BRAND_SPECIFIER, COMPATIBILITY_PROVENANCE, type ClassDiscovery, type CompatibilityInput, type CompatibilityProvenance, type CompileTemplateOptions, type CompiledSelector, type CompiledTemplate, type Compound, type CssDeclaration, type CssRule, EMAIL_CLIENT_MATRIX, ESSENTIAL_CONSTRUCTS, type EmailClientTarget, type EmailContent, type ProjectTransform, type RenderedBrandFooter, type Specificity, type Stylesheet, TAILWIND_VERSION, TEMPLATE_NAME_PATTERN, type TailwindLimits, type TailwindOptions, type TailwindOutput, type TransformOptions, applyStylesheet, checkEmailCompatibility, checkStaticProfile, checkTemplateCompatibility, classListOf, compileSelector, compileTailwind, compileTemplate, discoverClassCandidates, downlevelColors, downlevelMediaQuery, finalizeValue, foldCalc, formatColor, hasBlockingCompatibility, introducedProfileErrors, matchesSelector, parseBrandSpecifier, parseColor, parseStylesheet, projectBrandSpecifier, renderBrandFooter, renderBrandSample, renderHeadCss, resolveVariables, transformProject, unknownCoverage };
 //# sourceMappingURL=compiler.d.ts.map