@samva/markup 0.9.0 → 0.10.0

package/dist/css-BVQKICKC.d.ts

@@ -1,109 +0,0 @@
-import { r as EmailDiagnostic } from "./diagnostics-B-Gym34R.js";
-import { m as EmailNode } from "./elements-cqldpaJt.js";
-import "css-tree";
-//#region src/email/font-stacks.d.ts
-/** One `@font-face` rule, its `src` already resolved to served URLs. */
-interface FontFaceRule {
-  /** The family the rule declares, unquoted. */
-  readonly family: string;
-  /** The rule as it goes into the email's `<head>`. */
-  readonly css: string;
-}
-//#endregion
-//#region src/email/fonts.d.ts
-/**
- * Maps a relative `src` URL, as authored, to the URL its project file is served
- * from, or `undefined` when the project has no such file. The stylesheet's host
- * owns this: it knows which file the stylesheet came from and the asset base.
- */
-type FontFileResolver = (reference: string) => string | undefined;
-//#endregion
-//#region src/email/selectors.d.ts
-type EmailElementNode = Extract<EmailNode, {
-  type: "Element";
-}>;
-interface AttributeTest {
-  readonly name: string;
-  readonly operator?: string | undefined;
-  readonly value?: string | undefined;
-}
-interface Compound {
-  readonly tag?: string | undefined;
-  readonly id?: string | undefined;
-  readonly classes: readonly string[];
-  readonly attributes: readonly AttributeTest[];
-  /** A compound the matcher cannot evaluate — a pseudo-class, say — never matches. */
-  readonly opaque: boolean;
-}
-type Combinator = "descendant" | "child" | "adjacent" | "sibling";
-interface CompiledSelector {
-  /** Document order, left to right; each part names the combinator that follows it. */
-  readonly parts: readonly {
-    readonly compound: Compound;
-    readonly after?: Combinator;
-  }[];
-}
-/** An element together with the ancestors and preceding siblings a combinator needs. */
-interface Ancestry {
-  readonly element: EmailElementNode;
-  readonly parent: Ancestry | undefined;
-  readonly previous: readonly EmailElementNode[];
-}
-declare const classListOf: (element: EmailElementNode) => readonly string[];
-/** Match a compiled selector against one element in its tree position. */
-declare const matchesSelector: (selector: CompiledSelector | undefined, ancestry: Ancestry) => boolean;
-//#endregion
-//#region src/email/css.d.ts
-interface CssDeclaration {
-  /** Kebab-case property name, as authored. */
-  readonly property: string;
-  readonly value: string;
-  readonly important: boolean;
-}
-/** Specificity as the CSS triple (id, class/attribute/pseudo-class, type). */
-type Specificity = readonly [number, number, number];
-interface CssRule {
-  /** Exactly one selector; a selector list is split into one rule each. */
-  readonly selector: string;
-  /** Decoded class identifiers mentioned by this selector, including nested pseudo selectors. */
-  readonly classes: readonly string[];
-  readonly specificity: Specificity;
-  readonly declarations: readonly CssDeclaration[];
-  /** Position across every stylesheet, in the order they were imported. */
-  readonly order: number;
-  /** Declared `@layer` index; unlayered declarations sort above every layer. */
-  readonly layer: number;
-  /** Enclosing conditional at-rule preludes, outermost first. */
-  readonly conditions: readonly string[];
-  /** Unconditional and pseudo-free rules are the only ones that can become an inline style. */
-  readonly inlinable: boolean;
-  /** Compiled at build time so the render lane needs no CSS parser. */
-  readonly matcher: CompiledSelector | undefined;
-}
-interface Stylesheet {
-  readonly rules: readonly CssRule[];
-  /** `@page`, `@keyframes` and other at-rules kept verbatim in `<head>`. */
-  readonly headAtRules: readonly string[];
-  /** Validated `@font-face` rules, `src` resolved; the render hides them from classic Outlook. */
-  readonly fontFaces: readonly FontFaceRule[];
-  /** Unconditional custom properties, for resolving `var()` before inlining. */
-  readonly variables: Readonly<Record<string, string>>;
-  readonly diagnostics: readonly EmailDiagnostic[];
-}
-/** Compile a selector into the plain-data matcher the render lane uses. */
-declare const compileSelector: (selector: string) => CompiledSelector | undefined;
-/** Parse one stylesheet into rules, keeping layer, order and conditions. */
-declare const parseStylesheet: (source: string, options?: {
-  readonly origin?: string;
-  readonly startOrder?: number;
-  /** Resolves a relative `@font-face` src to the URL its project file is served from. */
-  readonly resolveFontFile?: FontFileResolver | undefined;
-  /**
-   * The sheet belongs to the project theme, whose `@import`s the Tailwind
-   * compile resolves; they are layering, not something to report here.
-   */
-  readonly themeImports?: boolean | undefined;
-}) => Stylesheet;
-//#endregion
-export { compileSelector as a, CompiledSelector as c, matchesSelector as d, Stylesheet as i, Compound as l, CssRule as n, parseStylesheet as o, Specificity as r, Ancestry as s, CssDeclaration as t, classListOf as u };
-//# sourceMappingURL=css-BVQKICKC.d.ts.map

package/dist/diagnostic-codes.d.ts

@@ -1,403 +0,0 @@
-//#region src/diagnostic-codes.d.ts
-interface DiagnosticCodeSpec {
-  /** What is wrong, in one sentence an agent can act on. */
-  readonly summary: string;
-  /** The repair, in one sentence. */
-  readonly fix: string;
-  /** Agent instructions for upgrading an incompatible template format. */
-  readonly upgrade?: string;
-  /** Reported only for an SMS or WhatsApp body; surfaces that gate those channels omit it. */
-  readonly channelOnly?: true;
-}
-declare const DIAGNOSTIC_CODES: {
-  readonly "no-template": {
-    readonly summary: "The entry does not default-export a template.";
-    readonly fix: "Default-export defineTemplate({ ... }) imported from @samva/markup.";
-  };
-  readonly "legacy-definition": {
-    readonly summary: "The entry default-exports something other than defineTemplate.";
-    readonly fix: "Import { defineTemplate } from \"@samva/markup\" and default-export defineTemplate({ ... }).";
-    readonly upgrade: string;
-  };
-  readonly "dynamic-definition": {
-    readonly summary: "A definition field is spread or computed instead of written out.";
-    readonly fix: "Write each field as name: value.";
-  };
-  readonly "invalid-template-id": {
-    readonly summary: "The template id is not a lowercase kebab-case string literal.";
-    readonly fix: "Write id: \"order-shipped\".";
-  };
-  readonly "missing-schema": {
-    readonly summary: "The template declares no input schema.";
-    readonly fix: "Add schema: jsonSchema<Input>({ ... }).";
-  };
-  readonly "schema-not-static": {
-    readonly summary: "The schema cannot be read without running code.";
-    readonly fix: "Write the schema as a literal jsonSchema<Input>({ type: 'object', ... }).";
-  };
-  readonly "invalid-schema": {
-    readonly summary: "The schema uses JSON Schema keywords the compiler cannot validate against.";
-    readonly fix: "Use only the JSON Schema keywords the package README lists.";
-  };
-  readonly "missing-fixtures": {
-    readonly summary: "The template declares no fixtures.";
-    readonly fix: "Add fixtures: { default: { ... } } with at least one valid payload.";
-  };
-  readonly "fixtures-not-static": {
-    readonly summary: "A fixture is computed instead of written as data.";
-    readonly fix: "Write each fixture as a literal object; an imported asset is allowed.";
-  };
-  readonly "invalid-fixture-name": {
-    readonly summary: "A fixture key is not a single path segment.";
-    readonly fix: "Use letters, digits, '.', '_' and '-', starting with a letter or digit.";
-  };
-  readonly "fixture-invalid": {
-    readonly summary: "A fixture does not match the schema.";
-    readonly fix: "Change the fixture, or the schema, so every fixture is a payload a send could carry.";
-  };
-  readonly "invalid-locale": {
-    readonly summary: "The template's default locale is not a string literal.";
-    readonly fix: "Write locale: \"en-US\".";
-  };
-  readonly "no-channel": {
-    readonly summary: "The template declares no channel body.";
-    readonly fix: "Add an email body.";
-  };
-  readonly "invalid-channel": {
-    readonly summary: "A channel field is not shaped as the channel requires.";
-    readonly fix: "Write email: { subject, preheader?, body } with each a function of the input.";
-  };
-  readonly "not-a-function": {
-    readonly summary: "A channel field is not a function of the input.";
-    readonly fix: "Write (input) => ... in place or declare the function in the project.";
-  };
-  readonly "missing-subject": {
-    readonly summary: "The email channel has no subject.";
-    readonly fix: "Add subject: (input) => ....";
-  };
-  readonly "missing-body": {
-    readonly summary: "The email channel has no body.";
-    readonly fix: "Add body: (input) => (<Email>...</Email>).";
-  };
-  readonly "multiple-roots": {
-    readonly summary: "The body renders nothing or more than one root.";
-    readonly fix: "Wrap the body in a single element such as <Email>.";
-  };
-  readonly "preheader-without-shell": {
-    readonly summary: "A preheader is set but the body has no <Email> shell to hold it.";
-    readonly fix: "Wrap the body in <Email>.";
-  };
-  readonly "wrong-channel": {
-    readonly summary: "A channel body does not return its own channel component.";
-    readonly fix: "Return one element imported from the channel package.";
-    readonly channelOnly: true;
-  };
-  readonly "syntax-error": {
-    readonly summary: "A project file does not parse as TSX.";
-    readonly fix: "Fix the syntax at the reported location.";
-  };
-  readonly "non-project-import": {
-    readonly summary: "The file imports something other than @samva/markup or a project file.";
-    readonly fix: "Remove the import, or copy the code you need into a project file.";
-  };
-  readonly "unresolved-import": {
-    readonly summary: "An import names no file in the project.";
-    readonly fix: "Check the path and the file extension.";
-  };
-  readonly "recursive-partial": {
-    readonly summary: "A partial renders itself; partials are inlined at compile time.";
-    readonly fix: "Flatten the recursion, or repeat the structure with .map.";
-  };
-  readonly "nesting-limit": {
-    readonly summary: "The template nests deeper than the compiler reads.";
-    readonly fix: "Flatten the structure.";
-  };
-  readonly "dynamic-expression": {
-    readonly summary: "An expression outside the static profile: a call other than fmt.* and .map, a computed value, or a spread.";
-    readonly fix: "Compute the value where the message is sent and bind it from the payload.";
-  };
-  readonly "statement-in-body": {
-    readonly summary: "A body contains a statement (const, if, a loop); a body is one expression.";
-    readonly fix: "Use cond && <X />, cond ? <A /> : <B /> and .map, or send the computed value in the payload.";
-  };
-  readonly "unsupported-pattern": {
-    readonly summary: "A parameter pattern or default value the profile cannot bind.";
-    readonly fix: "Use plain names or destructuring without defaults; declare the field required or guard it.";
-  };
-  readonly "hook-call": {
-    readonly summary: "A hook was called; templates have no state, effects or context.";
-    readonly fix: "Read the input through the function's parameter and send anything else in the payload.";
-  };
-  readonly "unknown-formatter": {
-    readonly summary: "fmt.<name> is not a formatter.";
-    readonly fix: "Use fmt.money, number, date, time, plural or list.";
-  };
-  readonly "formatter-arguments": {
-    readonly summary: "A formatter got the wrong number of arguments.";
-    readonly fix: "Match the formatter's signature in the contract.";
-  };
-  readonly "reserved-character": {
-    readonly summary: "Text contains a private-use character the compiler reserves.";
-    readonly fix: "Remove the characters U+E000 to U+E003.";
-  };
-  readonly "reserved-url": {
-    readonly summary: "A URL is the unsubscribe placeholder only BrandFooter can write.";
-    readonly fix: "Render <BrandFooter /> instead.";
-  };
-  readonly "reserved-attribute": {
-    readonly summary: "An attribute is written only by a brand component.";
-    readonly fix: "Render BrandFooter from samva:brand instead of marking an element as the footer.";
-  };
-  readonly "dynamic-class": {
-    readonly summary: "A class name is built at run time, and Tailwind cannot see it.";
-    readonly fix: "Write classes literally, or choose between literal lists: input.vip ? \"bg-amber-100\" : \"bg-white\".";
-  };
-  readonly "too-many-class-variants": {
-    readonly summary: "A class list chooses between more literal lists than the compiler resolves.";
-    readonly fix: "Split the choice into fewer conditions, or move part of it to a partial.";
-  };
-  readonly "invalid-style": {
-    readonly summary: "A style prop is not a static property object.";
-    readonly fix: "Write style={{ backgroundColor: \"#fff\" }} with literal values, or use classes.";
-  };
-  readonly "unknown-field": {
-    readonly summary: "A binding names a field the schema does not declare.";
-    readonly fix: "Add the field to the schema, or bind a field it declares (the message suggests the nearest).";
-  };
-  readonly "unguarded-optional": {
-    readonly summary: "An optional field is read outside a guard, so a send without it would render a blank.";
-    readonly fix: "Guard it with {input.field && ...}, or make the field required.";
-  };
-  readonly "invalid-binding-type": {
-    readonly summary: "A binding has the wrong type for where it is used.";
-    readonly fix: "Bind a field of the type the position needs, or send it in that type.";
-  };
-  readonly "unknown-component": {
-    readonly summary: "A component the profile cannot read.";
-    readonly fix: "Import components from @samva/markup/email/components, samva:brand, or the project.";
-  };
-  readonly "dynamic-numeric-prop": {
-    readonly summary: "A prop that sizes layout at compile time is not a number literal.";
-    readonly fix: "Write the number literally, for example height={44}.";
-  };
-  readonly "button-dynamic-label": {
-    readonly summary: "A Button label is read at render time, so classic Outlook cannot size it.";
-    readonly fix: "Give the button a width: <Button width={200}>.";
-  };
-  readonly "invalid-columns-each": {
-    readonly summary: "<Columns each> is not a list from the input.";
-    readonly fix: "Write each={input.items} with a callback returning <Column>.";
-  };
-  readonly "invalid-columns-per": {
-    readonly summary: "<Columns per> is not a positive integer literal.";
-    readonly fix: "Write per={2}.";
-  };
-  readonly "invalid-button-number": {
-    readonly summary: "A Button size prop is not a finite number.";
-    readonly fix: "Pass a finite number.";
-  };
-  readonly "unsupported-element": {
-    readonly summary: "An element outside the supported email vocabulary.";
-    readonly fix: "Use an element from the contract's element table.";
-  };
-  readonly "unsupported-attribute": {
-    readonly summary: "An attribute the element does not support.";
-    readonly fix: "Use a supported attribute, or data-* and aria-*.";
-  };
-  readonly "missing-attribute": {
-    readonly summary: "An element is missing a required attribute.";
-    readonly fix: "Add the attribute, for example alt on img.";
-  };
-  readonly "invalid-attribute-value": {
-    readonly summary: "An attribute value is not a string or number, or contains control characters.";
-    readonly fix: "Pass plain text.";
-  };
-  readonly "duplicate-attribute": {
-    readonly summary: "An attribute is written twice.";
-    readonly fix: "Keep one.";
-  };
-  readonly "invalid-content": {
-    readonly summary: "An element holds content its content model does not allow.";
-    readonly fix: "Move the child to a parent that accepts it.";
-  };
-  readonly "void-element-children": {
-    readonly summary: "A void element has children.";
-    readonly fix: "Remove the children.";
-  };
-  readonly "event-handler": {
-    readonly summary: "An event handler; email clients strip scripting.";
-    readonly fix: "Remove the handler; use a link for interaction.";
-  };
-  readonly "dangerous-html": {
-    readonly summary: "dangerouslySetInnerHTML; there is no raw-HTML escape hatch.";
-    readonly fix: "Write the markup as JSX.";
-  };
-  readonly "unsafe-url": {
-    readonly summary: "A URL uses a scheme email cannot send safely.";
-    readonly fix: "Use an https URL, a mailto: or tel: link, or a bound URL.";
-  };
-  readonly "unsafe-raw-text": {
-    readonly summary: "Raw text content contains markup that could end its element.";
-    readonly fix: "Remove the offending sequence.";
-  };
-  readonly "unsupported-style-property": {
-    readonly summary: "A style property name is not a CSS property.";
-    readonly fix: "Write camelCase (backgroundColor) or a custom property (--brand).";
-  };
-  readonly "invalid-style-value": {
-    readonly summary: "A style value is not a string or number.";
-    readonly fix: "Pass a string or number.";
-  };
-  readonly "unsafe-style-value": {
-    readonly summary: "A style value contains CSS that could break out of its declaration.";
-    readonly fix: "Remove the offending characters.";
-  };
-  readonly "missing-head": {
-    readonly summary: "Styles that cannot be inlined need a <head> to live in.";
-    readonly fix: "Wrap the message in <Email>, or write those declarations inline.";
-  };
-  readonly "invalid-subject": {
-    readonly summary: "The subject is not one line of text.";
-    readonly fix: "Return a single-line string.";
-  };
-  readonly "invalid-preheader": {
-    readonly summary: "The preheader is not a string.";
-    readonly fix: "Return a string.";
-  };
-  readonly "invalid-text": {
-    readonly summary: "The plain-text body is not a string.";
-    readonly fix: "Return a string.";
-  };
-  readonly "button-outlook-fallback": {
-    readonly summary: "Classic Outlook needs a height and a plain string label to draw the button.";
-    readonly fix: "Give <Button> a height and a string label.";
-  };
-  readonly "unmatched-class": {
-    readonly summary: "A class produced no styles.";
-    readonly fix: "Use a class the theme or Tailwind defines, or write the style inline.";
-  };
-  readonly "tailwind-dynamic-class": {
-    readonly summary: "A class list is assembled at run time.";
-    readonly fix: "Write the classes literally.";
-  };
-  readonly "css-parse-error": {
-    readonly summary: "A stylesheet does not parse.";
-    readonly fix: "Fix the CSS at the reported location.";
-  };
-  readonly "css-import-unresolved": {
-    readonly summary: "A stylesheet @import cannot be resolved.";
-    readonly fix: "Import the stylesheet from the template module, or use the theme.css layers.";
-  };
-  readonly "css-unsupported-at-rule": {
-    readonly summary: "An at-rule is not applied to email output.";
-    readonly fix: "Remove it or move the declarations into a class rule.";
-  };
-  readonly "css-conditional-variable": {
-    readonly summary: "A custom property is redefined inside a conditional at-rule.";
-    readonly fix: "Keep the override on a class rule.";
-  };
-  readonly "email-font-fallback": {
-    readonly summary: "A font stack names a project font without a generic fallback.";
-    readonly fix: "End the stack with sans-serif, serif or monospace.";
-  };
-  readonly "email-font-family": {
-    readonly summary: "@font-face declares no font-family.";
-    readonly fix: "Add font-family.";
-  };
-  readonly "email-font-src": {
-    readonly summary: "@font-face declares no usable url() src.";
-    readonly fix: "Add a url() pointing at a .woff2 file.";
-  };
-  readonly "email-font-format": {
-    readonly summary: "@font-face uses a format other than WOFF2.";
-    readonly fix: "Convert the file to .woff2.";
-  };
-  readonly "email-font-missing": {
-    readonly summary: "@font-face names a file the project does not hold.";
-    readonly fix: "Add the file; paths resolve from the stylesheet's directory.";
-  };
-  readonly "invalid-asset-base": {
-    readonly summary: "The asset base is not an https URL or a path.";
-    readonly fix: "Use an https URL, an absolute path, or a relative path.";
-  };
-  readonly "brand-unavailable": {
-    readonly summary: "The build has no brand to resolve a samva:brand import.";
-    readonly fix: "Create or select the brand the import names.";
-  };
-  readonly "brand-import-conflict": {
-    readonly summary: "The project imports two different brands.";
-    readonly fix: "Import one brand specifier everywhere.";
-  };
-  readonly "caniemail/unknown-coverage": {
-    readonly summary: "A feature has no client-support data.";
-    readonly fix: "Verify it in the target clients.";
-  };
-  readonly "invalid-attribute": {
-    readonly summary: "A channel component attribute has a value the channel does not accept.";
-    readonly fix: "Use one of the listed values.";
-    readonly channelOnly: true;
-  };
-  readonly "unknown-attribute": {
-    readonly summary: "A channel component attribute the component does not have.";
-    readonly fix: "Use one of the listed attributes.";
-    readonly channelOnly: true;
-  };
-  readonly "sms-markup": {
-    readonly summary: "An SMS body contains an element; SMS is plain text.";
-    readonly fix: "Write text and bindings, with a newline for a line break.";
-    readonly channelOnly: true;
-  };
-  readonly "whatsapp-structure": {
-    readonly summary: "WhatsApp content sits outside Header, Body, Footer or Buttons.";
-    readonly fix: "Move it into <WhatsApp.Body>.";
-    readonly channelOnly: true;
-  };
-  readonly "whatsapp-body-required": {
-    readonly summary: "A WhatsApp template has no body.";
-    readonly fix: "Add <WhatsApp.Body>...</WhatsApp.Body>.";
-    readonly channelOnly: true;
-  };
-  readonly "whatsapp-conditional": {
-    readonly summary: "A WhatsApp part branches or contains elements; Meta registers its text once.";
-    readonly fix: "Choose the wording in the payload, or write separate templates.";
-    readonly channelOnly: true;
-  };
-  readonly "whatsapp-header-media": {
-    readonly summary: "A WhatsApp media header is not exactly one URL.";
-    readonly fix: "Write the URL as the only child: a literal or one binding.";
-    readonly channelOnly: true;
-  };
-  readonly "whatsapp-header-variables": {
-    readonly summary: "A WhatsApp header text takes more than one variable.";
-    readonly fix: "Keep one binding in the header and move the rest to the body.";
-    readonly channelOnly: true;
-  };
-  readonly "whatsapp-length": {
-    readonly summary: "A WhatsApp part exceeds Meta's length limit.";
-    readonly fix: "Shorten the text.";
-    readonly channelOnly: true;
-  };
-  readonly "whatsapp-button-text": {
-    readonly summary: "A WhatsApp button has no label or value between its tags.";
-    readonly fix: "Write the label or value as text between the tags.";
-    readonly channelOnly: true;
-  };
-  readonly "whatsapp-button-limit": {
-    readonly summary: "The conditions can produce more buttons of a kind than Meta allows.";
-    readonly fix: "Remove buttons, or split the template.";
-    readonly channelOnly: true;
-  };
-};
-/** Whether a diagnostic identifier selects an agent-driven format upgrade. */
-declare const hasUpgradeRecipe: (code: string) => boolean;
-type DiagnosticCode = keyof typeof DIAGNOSTIC_CODES;
-/** Families whose code carries a suffix chosen at run time. */
-declare const DIAGNOSTIC_CODE_FAMILIES: {
-  readonly "caniemail/": {
-    readonly summary: "A CSS property, HTML element or attribute that a target email client ignores or partly supports (from the caniemail.com data), reported as caniemail/<feature>.";
-    readonly fix: "Use the alternative the message names, such as an email component instead of display: flex.";
-  };
-};
-//#endregion
-export { DIAGNOSTIC_CODES, DIAGNOSTIC_CODE_FAMILIES, DiagnosticCode, DiagnosticCodeSpec, hasUpgradeRecipe };
-//# sourceMappingURL=diagnostic-codes.d.ts.map