@samva/markup 0.18.1 → 0.19.0

package/dist/{compiled-template-Bc4Dq9zy.d.ts → compiled-template-CPDHvFlt.d.ts}

@@ -1,3 +1,127 @@
+import { a as EmailBrand, m as BrandPlugin } from "./brand-Bxb6Sm7y.js";
+//#region src/ir/degradations.d.ts
+/** What a reader loses when a component is lowered from the shared document to email. */
+interface EmailDegradation {
+  readonly kind: "same" | "static" | "omitted";
+  readonly note: string;
+}
+/** Content fidelity declarations; client-specific presentation is checked against the HTML. */
+declare const COMPONENT_DEGRADATIONS: {
+  readonly Email: {
+    readonly kind: "same";
+    readonly note: "Recipients get the full message with the theme's colors and font.";
+  };
+  readonly Section: {
+    readonly kind: "same";
+    readonly note: "Recipients see the section and everything in it.";
+  };
+  readonly Columns: {
+    readonly kind: "same";
+    readonly note: "Recipients see every cell of every row.";
+  };
+  readonly Column: {
+    readonly kind: "same";
+    readonly note: "Recipients see the cell and everything in it.";
+  };
+  readonly Button: {
+    readonly kind: "same";
+    readonly note: "Recipients see the button's label and can follow its link.";
+  };
+  readonly Spacer: {
+    readonly kind: "same";
+    readonly note: "Recipients see the space between blocks.";
+  };
+  readonly Divider: {
+    readonly kind: "same";
+    readonly note: "Recipients see the horizontal rule.";
+  };
+  readonly Image: {
+    readonly kind: "same";
+    readonly note: "Recipients get the image and its alternative text.";
+  };
+  readonly Link: {
+    readonly kind: "same";
+    readonly note: "Recipients can follow the link.";
+  };
+  readonly BrandLogo: {
+    readonly kind: "same";
+    readonly note: "Recipients get the brand logo, with the dark version where their client supports it.";
+  };
+  readonly BrandFooter: {
+    readonly kind: "same";
+    readonly note: "Recipients see the brand's contact details and links, including the unsubscribe link when supplied.";
+  };
+};
+type SemanticComponentName = keyof typeof COMPONENT_DEGRADATIONS;
+/** The content fidelity declaration for one supported component. */
+declare const componentDegradation: (name: SemanticComponentName) => EmailDegradation;
+//#endregion
+//#region src/ir/nodes.d.ts
+/** An authored component prop: values retain bindings, and object props retain their fields. */
+type SemanticProp = CompiledValue | {
+  readonly object: Readonly<Record<string, SemanticProp>>;
+};
+/** A component's identity and authored content, before any target introduces layout markup. */
+interface SemanticComponent {
+  readonly type: "component";
+  readonly name: SemanticComponentName;
+  readonly props?: Readonly<Record<string, SemanticProp>>;
+  readonly children?: readonly CompiledNode[];
+  /** Resolved brand data, without its stylesheet, for brand components only. */
+  readonly brand?: Omit<EmailBrand, "css">;
+  /** Resolved at the authoring call site: partials intentionally clear inherited cell layout. */
+  readonly emailColumn?: {
+    readonly width?: CompiledValue;
+    readonly stack: boolean;
+  };
+  readonly src?: CompiledSource;
+}
+interface SemanticIntrinsicBase {
+  readonly tag: string;
+  readonly attrs?: Readonly<Record<string, CompiledValue>>;
+  readonly style?: CompiledStyle;
+  readonly children?: readonly CompiledNode[];
+  readonly src?: CompiledSource;
+}
+interface SemanticBlock extends SemanticIntrinsicBase {
+  readonly type: "block";
+}
+interface SemanticInline extends SemanticIntrinsicBase {
+  readonly type: "inline";
+}
+/** The original tag retains the meaning of headings, lists, links, images and table cells. */
+type SemanticIntrinsic = SemanticBlock | SemanticInline;
+/** Only presentation that differs from the primitives' deterministic expansion is recorded. */
+interface EmailPresentationOverride {
+  readonly attrs?: Readonly<Record<string, CompiledValue>>;
+  /** Empty means the cascade removed the primitive's authored declarations. */
+  readonly style?: CompiledStyle;
+  /** VML/conditional-comment markup after stylesheet token resolution. */
+  readonly raw?: readonly CompiledRawPart[];
+}
+interface EmailPresentation {
+  /** Preorder ordinals of email elements and raw compatibility nodes, before head additions. */
+  readonly nodes: Readonly<Record<string, EmailPresentationOverride>>;
+  readonly headCss: string;
+  readonly fontFaceCss: string;
+  readonly brandPlugin: BrandPlugin;
+}
+/** Parsed CSS structure: the renderer validates each context before writing shell-owned CSS. */
+interface WebCssRule {
+  readonly selector?: string;
+  readonly at?: string;
+  readonly style?: readonly (readonly [property: string, value: CompiledValue])[];
+  readonly children?: readonly WebCssRule[];
+}
+interface WebPresentation {
+  readonly rules: readonly WebCssRule[];
+  readonly componentLayer?: number;
+  /** A generated class must outrank normal project selectors to retain authored style priority. */
+  readonly inlineSpecificity?: number;
+  /** Authored style elements in document traversal order, independent of project stylesheets. */
+  readonly stylesheets?: readonly (readonly WebCssRule[])[];
+}
+//#endregion
 //#region src/sms-segments.d.ts
 /** The encoding a message needs: GSM-7 when every character fits, UCS-2 otherwise. */
 type SmsEncoding = "gsm7" | "ucs2";
@@ -10,7 +134,7 @@ declare const smsSegmentInfo: (text: string) => SmsSegmentInfo;
 //#endregion
 //#region src/compiled-template.d.ts
 /** The version this package writes. A publication pins the version it was built with. */
-declare const COMPILED_TEMPLATE_VERSION = 1;
+declare const COMPILED_TEMPLATE_VERSION = 2;
 /**
  * Where a node came from: `[line, column]` in the entry file, or `[line, column, file]` with an
  * index into `CompiledTemplate.sources` when the node came from an imported project file. Published
@@ -145,12 +269,16 @@ interface CompiledRaw {
 interface CompiledPreheader {
   readonly preheader: true;
 }
-/** A node in an email body. A bare value in child position is rendered as escaped text. */
-type CompiledNode = CompiledValue | CompiledElement | CompiledIf | CompiledEach | CompiledRaw | CompiledPreheader;
+/** A semantic body node or an email primitive produced by target lowering. Bare values are escaped text. */
+type CompiledNode = CompiledValue | CompiledElement | CompiledIf | CompiledEach | CompiledRaw | CompiledPreheader | SemanticComponent | SemanticIntrinsic;
 interface CompiledEmail {
   readonly subject: CompiledValue;
   readonly preheader?: CompiledValue;
   readonly body: CompiledNode;
+  /** Resolved email presentation, indexed by deterministic lowering order; contains no body. */
+  readonly presentation?: EmailPresentation;
+  /** Project CSS for the web target; email's resolved cascade is independent. */
+  readonly web?: WebPresentation;
 }
 /** A plain-text channel body: text pieces, conditionals and loops. */
 interface CompiledSms {
@@ -211,8 +339,30 @@ interface CompiledTemplate {
   /** The portable JSON Schema every send's input is validated against. */
   readonly schema: Readonly<Record<string, unknown>>;
 }
-/** The channels a template can declare and `render` can render. */
+/** The channels a template can declare. */
 type Channel = "email" | "sms" | "whatsapp";
+/** Email and web lower the same body; plain-message targets keep their authored channels. */
+type Target = Channel | "web";
+/** An element's offsets in rendered HTML and its authored source reference. */
+interface RenderedPosition {
+  readonly start: number;
+  readonly end: number;
+  readonly tag: string;
+  readonly src?: CompiledSource;
+}
+/** Values for a host-owned page shell. Styles are CSS text, never HTML. */
+interface PageHeadHints {
+  readonly title?: string;
+  readonly lang?: string;
+  readonly dir?: "ltr" | "rtl" | "auto";
+  readonly styles: string;
+}
+/** A semantic body fragment, with shell hints and offsets for source selection. */
+interface RenderedPage {
+  readonly html: string;
+  readonly headHints: PageHeadHints;
+  readonly positions: readonly RenderedPosition[];
+}
 interface RenderedEmail {
   readonly subject: string;
   readonly preheader: string | undefined;
@@ -258,11 +408,12 @@ interface RenderedWhatsApp {
   readonly footer?: string;
   readonly buttons: readonly RenderedWhatsAppButton[];
 }
-/** What `render` returns for each channel. */
+/** What `render` returns for each target. */
 interface RenderedMessage {
   readonly email: RenderedEmail;
+  readonly web: RenderedPage;
   readonly sms: RenderedSms;
   readonly whatsapp: RenderedWhatsApp;
 }
 //#endregion
-export { smsSegmentInfo as A, RenderedEmail as C, RenderedWhatsAppButton as D, RenderedWhatsApp as E, SmsEncoding as O, CompiledWhatsAppButtonNode as S, RenderedSms as T, CompiledStyle as _, CompiledEach as a, CompiledWhatsApp as b, CompiledFormatter as c, CompiledPredicate as d, CompiledPreheader as f, CompiledSource as g, CompiledSms as h, CompiledComparison as i, SmsSegmentInfo as k, CompiledIf as l, CompiledRawPart as m, Channel as n, CompiledElement as o, CompiledRaw as p, CompiledArithmetic as r, CompiledEmail as s, COMPILED_TEMPLATE_VERSION as t, CompiledNode as u, CompiledTemplate as v, RenderedMessage as w, CompiledWhatsAppButton as x, CompiledValue as y };
+export { RenderedWhatsAppButton as A, SemanticIntrinsic as B, PageHeadHints as C, RenderedPosition as D, RenderedPage as E, EmailPresentation as F, EmailDegradation as G, WebCssRule as H, EmailPresentationOverride as I, SemanticComponentName as K, SemanticBlock as L, SmsEncoding as M, SmsSegmentInfo as N, RenderedSms as O, smsSegmentInfo as P, SemanticComponent as R, CompiledWhatsAppButtonNode as S, RenderedMessage as T, WebPresentation as U, SemanticProp as V, COMPONENT_DEGRADATIONS as W, CompiledStyle as _, CompiledEach as a, CompiledWhatsApp as b, CompiledFormatter as c, CompiledPredicate as d, CompiledPreheader as f, CompiledSource as g, CompiledSms as h, CompiledComparison as i, Target as j, RenderedWhatsApp as k, CompiledIf as l, CompiledRawPart as m, Channel as n, CompiledElement as o, CompiledRaw as p, componentDegradation as q, CompiledArithmetic as r, CompiledEmail as s, COMPILED_TEMPLATE_VERSION as t, CompiledNode as u, CompiledTemplate as v, RenderedEmail as w, CompiledWhatsAppButton as x, CompiledValue as y, SemanticInline as z };

package/dist/compiler.d.ts

@@ -1,92 +1,7 @@
-import { n as parseBrandSpecifier, t as BrandPlugin } from "./brand-plugin-Dj9SMpfS.js";
-import { i as TemplateDiagnostic, n as EmailDiagnostic } from "./diagnostics-D4vSLQrO.js";
-import { n as AssetEntry, p as EmailBrand } from "./assets-CS5Xa_mr.js";
-import { v as CompiledTemplate } from "./compiled-template-Bc4Dq9zy.js";
-import { i as TEMPLATE_NAME_PATTERN } from "./template-DmNcoH4Q.js";
-import "css-tree";
-//#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;
-}
-//#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 the brand import resolves to, supplied by the host. A project
-   * that imports a brand with no brand here fails to compile.
-   */
-  readonly brand?: EmailBrand | undefined;
-  /** Names the brand import and marks the footer `BrandFooter` renders; `samvaBrandPlugin` when omitted. */
-  readonly brandPlugin?: BrandPlugin | undefined;
-}
-/**
- * The 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>>, options?: {
-  readonly themePath?: string | undefined;
-  readonly brandPlugin?: BrandPlugin | undefined;
-}) => string | undefined;
-//#endregion
-//#region src/sml/lower-project.d.ts
-interface CompileResult {
-  /** The compiled template, or `undefined` when a finding blocks it. */
-  readonly template: CompiledTemplate | 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 template; 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 without evaluating any of it. */
-declare const compileTemplate: (options: CompileTemplateOptions) => Promise<CompileResult>;
-//#endregion
+import { a as EmailBrand, h as parseBrandSpecifier, m as BrandPlugin } from "./brand-Bxb6Sm7y.js";
+import { i as TemplateDiagnostic, n as EmailDiagnostic } from "./diagnostics-C3TSx6SU.js";
+import { a as TailwindOptions, i as projectBrandSpecifier, n as compileTemplate, r as CompileResult, t as CompileTemplateOptions } from "./compile-CIeuGmP-.js";
+import { i as TEMPLATE_NAME_PATTERN } from "./template-4Dse7_OC.js";
 //#region src/sml/profile.d.ts
 /**
  * Check an entry against the static profile. Pass the entry's source alone, or the project's files