@samva/markup 0.8.0 → 0.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@samva/markup",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "Type-safe authoring and compilation primitives for Samva templates",
   "keywords": [
     "email",
@@ -28,6 +28,7 @@
     "!dist/**/*.map",
     "samva-brand.d.ts",
     "generated",
+    "skills",
     "package.json",
     "README.md",
     "AGENTS.md",
@@ -36,147 +37,51 @@
   "type": "module",
   "sideEffects": false,
   "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
     "./package.json": "./package.json",
-    "./ast": {
-      "types": "./dist/ast.d.ts",
-      "import": "./dist/ast.js"
+    "./static": {
+      "types": "./dist/static.d.ts",
+      "import": "./dist/static.js"
+    },
+    "./ir": {
+      "types": "./dist/ir.d.ts",
+      "import": "./dist/ir.js"
+    },
+    "./render-ir": {
+      "types": "./dist/render-ir.d.ts",
+      "import": "./dist/render-ir.js"
     },
-    "./candidate": {
-      "types": "./dist/candidate.d.ts",
-      "import": "./dist/candidate.js"
+    "./sms": {
+      "types": "./dist/sms.d.ts",
+      "import": "./dist/sms.js"
     },
-    "./classes": {
-      "types": "./dist/classes.d.ts",
-      "import": "./dist/classes.js"
+    "./whatsapp": {
+      "types": "./dist/whatsapp.d.ts",
+      "import": "./dist/whatsapp.js"
     },
-    "./components": {
-      "types": "./dist/components.d.ts",
-      "import": "./dist/components.js"
+    "./fmt": {
+      "types": "./dist/fmt.d.ts",
+      "import": "./dist/fmt.js"
     },
     "./compiler": {
       "types": "./dist/compiler.d.ts",
       "import": "./dist/compiler.js"
     },
-    "./compile": {
-      "types": "./dist/compile.d.ts",
-      "import": "./dist/compile.js"
-    },
-    "./compile-sms": {
-      "types": "./dist/compile-sms.d.ts",
-      "import": "./dist/compile-sms.js"
-    },
-    "./compile-whatsapp": {
-      "types": "./dist/compile-whatsapp.d.ts",
-      "import": "./dist/compile-whatsapp.js"
-    },
-    "./interpolate": {
-      "types": "./dist/interpolate.d.ts",
-      "import": "./dist/interpolate.js"
-    },
-    "./model": {
-      "types": "./dist/model.d.ts",
-      "import": "./dist/model.js"
-    },
-    "./ops": {
-      "types": "./dist/ops.d.ts",
-      "import": "./dist/ops.js"
-    },
     "./sms-segments": {
       "types": "./dist/sms-segments.d.ts",
       "import": "./dist/sms-segments.js"
     },
-    "./checks": {
-      "types": "./dist/checks.d.ts",
-      "import": "./dist/checks.js"
-    },
-    "./conditionals": {
-      "types": "./dist/conditionals.d.ts",
-      "import": "./dist/conditionals.js"
+    "./diagnostic-codes": {
+      "types": "./dist/diagnostic-codes.d.ts",
+      "import": "./dist/diagnostic-codes.js"
     },
     "./diagnostics": {
       "types": "./dist/diagnostics.d.ts",
       "import": "./dist/diagnostics.js"
     },
-    "./emit": {
-      "types": "./dist/emit.d.ts",
-      "import": "./dist/emit.js"
-    },
-    "./jsx-runtime": {
-      "types": "./dist/jsx-runtime.d.ts",
-      "import": "./dist/jsx-runtime.js"
-    },
-    "./jsx-dev-runtime": {
-      "types": "./dist/jsx-dev-runtime.d.ts",
-      "import": "./dist/jsx-dev-runtime.js"
-    },
-    "./lexer": {
-      "types": "./dist/lexer.d.ts",
-      "import": "./dist/lexer.js"
-    },
-    "./parser": {
-      "types": "./dist/parser.d.ts",
-      "import": "./dist/parser.js"
-    },
-    "./predicate": {
-      "types": "./dist/predicate.d.ts",
-      "import": "./dist/predicate.js"
-    },
-    "./starters": {
-      "types": "./dist/starters.d.ts",
-      "import": "./dist/starters.js"
-    },
-    "./starters/category-mapping": {
-      "types": "./dist/starters/category-mapping.d.ts",
-      "import": "./dist/starters/category-mapping.js"
-    },
-    "./starters/corpus": {
-      "types": "./dist/starters/corpus.d.ts",
-      "import": "./dist/starters/corpus.js"
-    },
-    "./starters/library": {
-      "types": "./dist/starters/library.d.ts",
-      "import": "./dist/starters/library.js"
-    },
-    "./starters/public-gallery": {
-      "types": "./dist/starters/public-gallery.d.ts",
-      "import": "./dist/starters/public-gallery.js"
-    },
-    "./starters/public-handoff": {
-      "types": "./dist/starters/public-handoff.d.ts",
-      "import": "./dist/starters/public-handoff.js"
-    },
-    "./starters/public-preview": {
-      "types": "./dist/starters/public-preview.d.ts",
-      "import": "./dist/starters/public-preview.js"
-    },
-    "./starters/public-preview-artifacts": {
-      "types": "./dist/starters/public-preview-artifacts.d.ts",
-      "import": "./dist/starters/public-preview-artifacts.js"
-    },
-    "./starters/showcase": {
-      "types": "./dist/starters/showcase.d.ts",
-      "import": "./dist/starters/showcase.js"
-    },
-    "./starters/sources": {
-      "types": "./dist/starters/sources.d.ts",
-      "import": "./dist/starters/sources.js"
-    },
-    "./starters/theme": {
-      "types": "./dist/starters/theme.d.ts",
-      "import": "./dist/starters/theme.js"
-    },
-    "./printer": {
-      "types": "./dist/printer.d.ts",
-      "import": "./dist/printer.js"
-    },
-    "./registry": {
-      "types": "./dist/registry.d.ts",
-      "import": "./dist/registry.js"
-    },
-    "./render-template": {
-      "types": "./dist/render-template.d.ts",
-      "import": "./dist/render-template.js"
-    },
     "./source-locations": {
       "types": "./dist/source-locations.d.ts",
       "import": "./dist/source-locations.js"
@@ -185,18 +90,7 @@
       "types": "./dist/theme-css.d.ts",
       "import": "./dist/theme-css.js"
     },
-    "./tsx-tracer": {
-      "types": "./dist/tsx-tracer.d.ts",
-      "import": "./dist/tsx-tracer.js"
-    },
-    "./tsx-source-instrumentation": {
-      "types": "./dist/tsx-source-instrumentation.d.ts",
-      "import": "./dist/tsx-source-instrumentation.js"
-    },
-    "./variables": {
-      "types": "./dist/variables.d.ts",
-      "import": "./dist/variables.js"
-    },
+    "./contract.json": "./generated/contract.json",
     "./generated/*": "./generated/*",
     "./input-schema": {
       "types": "./dist/input-schema.d.ts",
@@ -234,13 +128,17 @@
       "types": "./dist/email/assets.d.ts",
       "import": "./dist/email/assets.js"
     },
-    "./email/source-edit": {
-      "types": "./dist/email/source-edit.d.ts",
-      "import": "./dist/email/source-edit.js"
+    "./channel-edit": {
+      "types": "./dist/channel-edit.d.ts",
+      "import": "./dist/channel-edit.js"
     },
-    "./email/selection": {
-      "types": "./dist/email/selection.d.ts",
-      "import": "./dist/email/selection.js"
+    "./source-edit": {
+      "types": "./dist/source-edit.d.ts",
+      "import": "./dist/source-edit.js"
+    },
+    "./preview": {
+      "types": "./dist/preview.d.ts",
+      "import": "./dist/preview.js"
     },
     "./email/html": {
       "types": "./dist/email/html.d.ts",
@@ -260,10 +158,6 @@
     "./email/brand": {
       "types": "./dist/email/brand.d.ts",
       "import": "./dist/email/brand.js"
-    },
-    "./email/stylesheets": {
-      "types": "./dist/email/stylesheets.d.ts",
-      "import": "./dist/email/stylesheets.js"
     }
   },
   "publishConfig": {
@@ -272,14 +166,10 @@
   "scripts": {
     "build": "tsdown",
     "prepack": "bun run build",
-    "codegen:starters": "bun run ../vite/scripts/codegen-starters.ts && oxfmt starters/sources.gen.ts starters/library.gen.ts",
-    "import:public-handoff": "bun run ../vite/scripts/import-public-template-handoff.ts",
     "corpus:render": "bun run scripts/render-compatibility-corpus.ts",
     "codegen:tailwind": "bun run scripts/codegen-tailwind.ts && oxfmt src/email/tailwind-stylesheets.gen.ts",
-    "codegen:tokens": "bun run scripts/codegen-tokens.ts && oxfmt src/tokens.ts",
-    "codegen:sml-reference": "bun run scripts/generate-sml-reference.ts",
+    "codegen:contract": "bun run scripts/generate-contract.ts",
     "codegen:docs": "bun run scripts/codegen-docs.ts",
-    "refresh-caniemail": "bun run scripts/refresh-caniemail.ts",
     "test": "vitest run --root ../.. --project packages packages/markup/tests",
     "typecheck": "tsc --noEmit && tsc --noEmit -p tests/consumer/tsconfig.json"
   },

package/skills/sml/SKILL.md

@@ -0,0 +1,123 @@
+---
+name: sml
+description: Author, check, render and repair Samva email templates written as static-profile TSX (defineTemplate). Use when creating or editing a file under templates/ or emails/, fixing template diagnostics, or previewing a template.
+---
+
+# Authoring Samva templates
+
+A template is one `.tsx` file that default-exports `defineTemplate` from `@samva/markup`. It is
+ordinary JSX, HTML and Tailwind written in a static profile: the compiler reads it without running
+it and produces a JSON IR. Every preview and every send renders that IR against the input, so
+nothing you write executes at send time.
+
+## The loop
+
+Write, check, render, look, repair. Repeat until the check is clean.
+
+```bash
+samva templates check                       # compile every template, print diagnostics with fixes
+samva templates render --fixture no-tracking  # subject, preheader, text and HTML for one fixture
+samva templates snapshot                    # desktop and mobile PNGs, light and dark
+samva templates dev                         # local editor with every fixture rendered
+```
+
+Add `--json` for diagnostics as data: each has a `code`, a location, a severity and a `fix`. Apply
+the fix the diagnostic names rather than rewriting around it. Without the CLI, call
+`compileTemplate` from `@samva/markup/static` and `renderIr` from `@samva/markup/render-ir`.
+
+## Upgrades
+
+When a diagnostic has an `upgrade` field in `@samva/markup/contract.json`, follow that recipe
+for every affected entry while preserving project edits and entry paths. The Upgrades section of
+`generated/reference.md` renders the same recipes. Check every converted entry and render its
+fixtures before saving the project.
+
+## Shape
+
+```tsx
+import { defineTemplate } from "@samva/markup";
+import { Email } from "@samva/markup/email/components";
+import { fmt } from "@samva/markup/fmt";
+import { jsonSchema } from "@samva/markup/input-schema";
+
+export default defineTemplate({
+  id: "order-shipped",
+  schema: jsonSchema<{ name: string; total: number; currency: string; trackingUrl?: string }>({
+    type: "object",
+    properties: {
+      name: { type: "string" },
+      total: { type: "number" },
+      currency: { type: "string" },
+      trackingUrl: { type: "string" },
+    },
+    required: ["name", "total", "currency"],
+    additionalProperties: false,
+  }),
+  fixtures: {
+    default: { name: "Ada", total: 84, currency: "EUR", trackingUrl: "https://example.com/t/1" },
+    "no-tracking": { name: "Ada", total: 84, currency: "EUR" },
+  },
+  email: {
+    subject: (input) => `${input.name}, your order shipped`,
+    body: (input) => (
+      <Email>
+        <h1 className="text-2xl font-semibold">Hi {input.name}, it shipped.</h1>
+        <p>Total {fmt.money(input.total, input.currency)}</p>
+        {input.trackingUrl && <a href={input.trackingUrl}>Track package</a>}
+      </Email>
+    ),
+  },
+});
+```
+
+- `id` is lowercase kebab-case and is the template's public handle.
+- Put templates in `templates/` (`emails/` also works). Import only `@samva/markup` and files in
+  the project; there are no dependencies to install.
+- `subject` and `preheader` belong to the `email` channel, never to `<Email>`.
+- Declare at least one fixture, and one per branch: default, missing optional fields, many items.
+
+## The static profile
+
+Use these forms; they are what models already write for React.
+
+| Form                | Example                                                                     |
+| ------------------- | --------------------------------------------------------------------------- |
+| Text and attributes | `{input.name}`, `href={input.trackingUrl}`, template strings                |
+| Condition           | `{input.trackingUrl && <A />}`, `{input.vip ? <A /> : <B />}`               |
+| Comparison          | `===`, `!==`, `<`, `>`, `!`, `&&`, `\|\|`, `.length`                        |
+| Loop                | `input.items.map((item) => <Row />)`                                        |
+| Filter and count    | `input.items.filter((item) => item.done).length`                            |
+| Grid                | `<Columns each={input.deals} per={2}>{(deal) => <Column />}</Columns>`      |
+| Formatter           | `fmt.money`, `fmt.number`, `fmt.date`, `fmt.time`, `fmt.plural`, `fmt.list` |
+| Partial             | any project component, inlined at compile time                              |
+| Conditional class   | `className={input.vip ? "bg-amber-100" : "bg-white"}`                       |
+
+Anything else is a diagnostic: other calls (`reduce`, `Math.floor`, `Date.now`), statements in a
+body (`const`, `if`, loops), imports outside the project, hooks, event handlers,
+`dangerouslySetInnerHTML`, and class names built at run time. There is no escape hatch. When the
+profile cannot express something, compute it where the message is sent and add a field to the
+schema.
+
+## Data
+
+- The schema is a literal `jsonSchema<Input>({ ... })` or any Standard JSON Schema converter. It
+  validates every send and drives the binding checker: `input.ordr` fails with a suggestion.
+- Guard optional fields before binding them: `{input.trackingUrl && ...}` (`unguarded-optional`).
+- Every fixture must validate against the schema (`fixture-invalid`). Nothing is coerced and no
+  defaults are inserted.
+- Locale and time zone are send options; `fmt` reads them, and an explicit locale argument wins.
+
+## Styling and components
+
+Write HTML for content and Tailwind classes for style. Components exist only where an email client
+needs something HTML cannot say: `Email`, `Section`, `Columns`/`Column`, `Button`, `Image`,
+`Spacer`, `Divider`, and `BrandLogo`/`BrandFooter` from `samva:brand`. `theme.css` layers
+`starter.css`, then `@import "samva:brand";`, then the project's own `@theme`. Fonts are `.woff2`
+files declared with `@font-face`, and a font stack ends in a generic family.
+
+## References
+
+- `contract.json` (`@samva/markup/contract.json`): components with props, profile forms,
+  formatters, elements and every diagnostic code, generated from the compiler.
+- `generated/reference.md`: the same contract as a readable reference.
+- `AGENTS.md`: the package guide, including what goes wrong and why.

package/dist/ast-BrDtApwS.d.ts

@@ -1,107 +0,0 @@
-import { a as Span } from "./diagnostics-OcQKQYSY.js";
-//#region src/ast.d.ts
-declare const BLOCK_TAGS: readonly ["Email", "Subject", "Preview", "Container", "Section", "Row", "Column", "Heading", "Text", "Button", "Image", "Divider", "Spacer", "List", "ListItem", "If", "Else"];
-declare const INLINE_TAGS: readonly ["strong", "em", "a"];
-/** Email-only helper tags scoped by their parent primitive. */
-declare const AUXILIARY_TAGS: readonly ["Source"];
-/** Structured-channel tags: the sms/whatsapp vocabulary beyond shared If/Else. */
-declare const CHANNEL_TAGS: readonly ["Sms", "WhatsApp", "Header", "Body", "Footer", "Buttons"];
-declare const SML_TAGS: readonly ["Email", "Subject", "Preview", "Container", "Section", "Row", "Column", "Heading", "Text", "Button", "Image", "Divider", "Spacer", "List", "ListItem", "If", "Else", "strong", "em", "a", "Source", "Sms", "WhatsApp", "Header", "Body", "Footer", "Buttons"];
-/**
- * JSX component name → the SML tag that component emits. TSX authors write
- * capitalized component names, and the inline tags are lowercase in SML, so
- * `<Strong>` emits `strong` and `<A>` emits `a`. The table is derived from
- * `SML_TAGS` rather than written out, so a new tag is mapped the moment it
- * joins the vocabulary. `components.ts` is held to it by the component test
- * suite, and `tsx-tracer.ts` resolves authored JSX names through it.
- */
-declare const SML_TAG_BY_COMPONENT_NAME: Readonly<Record<string, SmlTag>>;
-/** The SML tag a JSX component name emits, or `undefined` when it is not a Samva primitive. */
-declare const smlTagForComponentName: (name: string) => SmlTag | undefined;
-/** The JSX component name that emits an SML tag, for printing SML back into TSX. */
-declare const componentNameForSmlTag: (tag: SmlTag) => string;
-type BlockTag = (typeof BLOCK_TAGS)[number];
-type InlineTag = (typeof INLINE_TAGS)[number];
-type AuxiliaryTag = (typeof AUXILIARY_TAGS)[number];
-type ChannelTag = (typeof CHANNEL_TAGS)[number];
-type SmlTag = (typeof SML_TAGS)[number];
-/** Channels supported by the public SML document model. */
-type Channel = "email" | "sms" | "whatsapp";
-/** Resolved primary width for email documents that omit `<Email width={…}>`. */
-declare const DEFAULT_EMAIL_WIDTH = 600;
-/** Root tag → channel. The root tag IS the channel declaration. */
-declare const CHANNEL_BY_ROOT_TAG: {
-  readonly Email: "email";
-  readonly Sms: "sms";
-  readonly WhatsApp: "whatsapp";
-};
-type RootTag = keyof typeof CHANNEL_BY_ROOT_TAG;
-declare const ROOT_TAGS: ReadonlyArray<RootTag>;
-declare const isRootTag: (tag: string) => tag is RootTag;
-/** The channel a parsed document targets, read off its root tag. */
-declare const documentChannel: (document: SmlDocument) => Channel;
-type AttributeValue = {
-  readonly kind: "string";
-  readonly value: string;
-} | {
-  readonly kind: "number";
-  readonly value: number;
-};
-interface Attribute {
-  readonly name: string;
-  readonly value: AttributeValue;
-  /** Span of the whole `name="value"` pair. */
-  readonly span: Span;
-  /** Span of the value contents (inside quotes/braces) — class diagnostics point here. */
-  readonly valueSpan: Span;
-}
-interface TextNode {
-  readonly kind: "text";
-  readonly id: string;
-  readonly value: string;
-  readonly span: Span;
-}
-interface InterpolationNode {
-  readonly kind: "interpolation";
-  readonly id: string;
-  readonly name: string;
-  /** {{name}} vs ${name} — both today's syntaxes, preserved through print. */
-  readonly syntax: "curly" | "dollar";
-  readonly span: Span;
-}
-interface ElementNode {
-  readonly kind: "element";
-  readonly id: string;
-  readonly tag: SmlTag;
-  readonly attributes: ReadonlyArray<Attribute>;
-  readonly children: ReadonlyArray<SmlNode>;
-  readonly span: Span;
-}
-type SmlNode = ElementNode | TextNode | InterpolationNode;
-interface SmlDocument {
-  readonly kind: "document";
-  /** Always a root element: `<Email>`, `<Sms>`, or `<WhatsApp>`. */
-  readonly root: ElementNode;
-}
-declare const attributeValue: (node: ElementNode, name: string) => AttributeValue | undefined;
-declare const stringAttribute: (node: ElementNode, name: string) => string | undefined;
-declare const numberAttribute: (node: ElementNode, name: string) => number | undefined;
-/**
- * The editor-only display label (navigator rename) — a universal attribute the
- * compiler never reads, so it never reaches HTML. Absent when unset.
- */
-declare const nodeLabel: (node: ElementNode) => string | undefined;
-/**
- * The editor-only visibility flag. A `hidden="true"` node stays in the source
- * (and the navigator, dimmed) but is dropped from every compile — preview and
- * send alike. Any other value / absence means visible.
- */
-declare const isHiddenNode: (node: ElementNode) => boolean;
-/**
- * All variable references in the document: `{{name}}` / `${name}` in children
- * and attribute values, plus names referenced by `<If test="...">` predicates.
- */
-declare const collectVariableReferences: (document: SmlDocument) => ReadonlySet<string>;
-//#endregion
-export { nodeLabel as A, TextNode as C, documentChannel as D, componentNameForSmlTag as E, smlTagForComponentName as M, stringAttribute as N, isHiddenNode as O, SmlTag as S, collectVariableReferences as T, RootTag as _, BLOCK_TAGS as a, SmlDocument as b, CHANNEL_TAGS as c, DEFAULT_EMAIL_WIDTH as d, ElementNode as f, ROOT_TAGS as g, InterpolationNode as h, AuxiliaryTag as i, numberAttribute as j, isRootTag as k, Channel as l, InlineTag as m, Attribute as n, BlockTag as o, INLINE_TAGS as p, AttributeValue as r, CHANNEL_BY_ROOT_TAG as s, AUXILIARY_TAGS as t, ChannelTag as u, SML_TAGS as v, attributeValue as w, SmlNode as x, SML_TAG_BY_COMPONENT_NAME as y };
-//# sourceMappingURL=ast-BrDtApwS.d.ts.map

package/dist/ast.d.ts

@@ -1,2 +0,0 @@
-import { A as nodeLabel, C as TextNode, D as documentChannel, E as componentNameForSmlTag, M as smlTagForComponentName, N as stringAttribute, O as isHiddenNode, S as SmlTag, T as collectVariableReferences, _ as RootTag, a as BLOCK_TAGS, b as SmlDocument, c as CHANNEL_TAGS, d as DEFAULT_EMAIL_WIDTH, f as ElementNode, g as ROOT_TAGS, h as InterpolationNode, i as AuxiliaryTag, j as numberAttribute, k as isRootTag, l as Channel, m as InlineTag, n as Attribute, o as BlockTag, p as INLINE_TAGS, r as AttributeValue, s as CHANNEL_BY_ROOT_TAG, t as AUXILIARY_TAGS, u as ChannelTag, v as SML_TAGS, w as attributeValue, x as SmlNode, y as SML_TAG_BY_COMPONENT_NAME } from "./ast-BrDtApwS.js";
-export { AUXILIARY_TAGS, Attribute, AttributeValue, AuxiliaryTag, BLOCK_TAGS, BlockTag, CHANNEL_BY_ROOT_TAG, CHANNEL_TAGS, Channel, ChannelTag, DEFAULT_EMAIL_WIDTH, ElementNode, INLINE_TAGS, InlineTag, InterpolationNode, ROOT_TAGS, RootTag, SML_TAGS, SML_TAG_BY_COMPONENT_NAME, SmlDocument, SmlNode, SmlTag, TextNode, attributeValue, collectVariableReferences, componentNameForSmlTag, documentChannel, isHiddenNode, isRootTag, nodeLabel, numberAttribute, smlTagForComponentName, stringAttribute };

package/dist/ast.js

@@ -1,124 +0,0 @@
-import { i as parsePredicate, n as collectPredicateVariables } from "./predicate-BI6uRRM-.js";
-import { Result } from "better-result";
-//#region src/ast.ts
-const BLOCK_TAGS = [
-	"Email",
-	"Subject",
-	"Preview",
-	"Container",
-	"Section",
-	"Row",
-	"Column",
-	"Heading",
-	"Text",
-	"Button",
-	"Image",
-	"Divider",
-	"Spacer",
-	"List",
-	"ListItem",
-	"If",
-	"Else"
-];
-const INLINE_TAGS = [
-	"strong",
-	"em",
-	"a"
-];
-/** Email-only helper tags scoped by their parent primitive. */
-const AUXILIARY_TAGS = ["Source"];
-/** Structured-channel tags: the sms/whatsapp vocabulary beyond shared If/Else. */
-const CHANNEL_TAGS = [
-	"Sms",
-	"WhatsApp",
-	"Header",
-	"Body",
-	"Footer",
-	"Buttons"
-];
-const SML_TAGS = [
-	...BLOCK_TAGS,
-	...INLINE_TAGS,
-	...AUXILIARY_TAGS,
-	...CHANNEL_TAGS
-];
-/**
-* JSX component name → the SML tag that component emits. TSX authors write
-* capitalized component names, and the inline tags are lowercase in SML, so
-* `<Strong>` emits `strong` and `<A>` emits `a`. The table is derived from
-* `SML_TAGS` rather than written out, so a new tag is mapped the moment it
-* joins the vocabulary. `components.ts` is held to it by the component test
-* suite, and `tsx-tracer.ts` resolves authored JSX names through it.
-*/
-const SML_TAG_BY_COMPONENT_NAME = Object.freeze(Object.fromEntries(SML_TAGS.map((tag) => [`${tag[0].toUpperCase()}${tag.slice(1)}`, tag])));
-/** The SML tag a JSX component name emits, or `undefined` when it is not a Samva primitive. */
-const smlTagForComponentName = (name) => SML_TAG_BY_COMPONENT_NAME[name];
-/** The JSX component name that emits an SML tag, for printing SML back into TSX. */
-const componentNameForSmlTag = (tag) => `${tag[0].toUpperCase()}${tag.slice(1)}`;
-/** Resolved primary width for email documents that omit `<Email width={…}>`. */
-const DEFAULT_EMAIL_WIDTH = 600;
-/** Root tag → channel. The root tag IS the channel declaration. */
-const CHANNEL_BY_ROOT_TAG = {
-	Email: "email",
-	Sms: "sms",
-	WhatsApp: "whatsapp"
-};
-const ROOT_TAGS = Object.keys(CHANNEL_BY_ROOT_TAG);
-const isRootTag = (tag) => tag in CHANNEL_BY_ROOT_TAG;
-/** The channel a parsed document targets, read off its root tag. */
-const documentChannel = (document) => CHANNEL_BY_ROOT_TAG[document.root.tag];
-const attributeValue = (node, name) => node.attributes.find((attribute) => attribute.name === name)?.value;
-const stringAttribute = (node, name) => {
-	const value = attributeValue(node, name);
-	return value?.kind === "string" ? value.value : void 0;
-};
-const numberAttribute = (node, name) => {
-	const value = attributeValue(node, name);
-	if (value === void 0) return void 0;
-	return value.kind === "number" ? value.value : Number.parseInt(value.value, 10);
-};
-/**
-* The editor-only display label (navigator rename) — a universal attribute the
-* compiler never reads, so it never reaches HTML. Absent when unset.
-*/
-const nodeLabel = (node) => stringAttribute(node, "label");
-/**
-* The editor-only visibility flag. A `hidden="true"` node stays in the source
-* (and the navigator, dimmed) but is dropped from every compile — preview and
-* send alike. Any other value / absence means visible.
-*/
-const isHiddenNode = (node) => stringAttribute(node, "hidden") === "true";
-/**
-* All variable references in the document: `{{name}}` / `${name}` in children
-* and attribute values, plus names referenced by `<If test="...">` predicates.
-*/
-const collectVariableReferences = (document) => {
-	const names = /* @__PURE__ */ new Set();
-	const attributePattern = /\$\{\s*\/?([\w.]+)\s*\}|\{\{\s*([\w.]+)\s*\}\}/g;
-	const visit = (node) => {
-		if (node.kind === "interpolation") {
-			names.add(node.name);
-			return;
-		}
-		if (node.kind === "text") return;
-		for (const attribute of node.attributes) {
-			if (attribute.value.kind !== "string") continue;
-			if (node.tag === "If" && attribute.name === "test") {
-				const parsed = parsePredicate(attribute.value.value);
-				if (Result.isOk(parsed)) for (const name of collectPredicateVariables(parsed.value)) names.add(name);
-				continue;
-			}
-			for (const match of attribute.value.value.matchAll(attributePattern)) {
-				const name = match[1] ?? match[2];
-				if (name !== void 0) names.add(name);
-			}
-		}
-		for (const child of node.children) visit(child);
-	};
-	visit(document.root);
-	return names;
-};
-//#endregion
-export { AUXILIARY_TAGS, BLOCK_TAGS, CHANNEL_BY_ROOT_TAG, CHANNEL_TAGS, DEFAULT_EMAIL_WIDTH, INLINE_TAGS, ROOT_TAGS, SML_TAGS, SML_TAG_BY_COMPONENT_NAME, attributeValue, collectVariableReferences, componentNameForSmlTag, documentChannel, isHiddenNode, isRootTag, nodeLabel, numberAttribute, smlTagForComponentName, stringAttribute };
-
-//# sourceMappingURL=ast.js.map

package/dist/candidate.d.ts

@@ -1,29 +0,0 @@
-//#region src/candidate.d.ts
-interface ParsedCandidate {
-  readonly raw: string;
-  /** Variant names in written order (validity is checked by the resolver). */
-  readonly variants: ReadonlyArray<string>;
-  /** root[-value] with variants/modifier/important stripped. */
-  readonly base: string;
-  /** Contents after the last `/` outside brackets, or null. */
-  readonly modifier: string | null;
-  /** Trailing `!`. */
-  readonly important: boolean;
-}
-declare const parseCandidate: (raw: string) => ParsedCandidate;
-/**
- * Splits `base` into (root, value) against a known root set, preferring the
- * longest matching root ("max-w-lg" → root "max-w", not "max").
- * `value` is `null` for a bare root ("border", "rounded"),
- * `{ kind: "arbitrary" }` for `root-[...]`, else `{ kind: "named" }`.
- */
-declare const splitRoot: (base: string, roots: ReadonlySet<string>) => {
-  readonly root: string;
-  readonly value: {
-    kind: "named" | "arbitrary";
-    value: string;
-  } | null;
-} | null;
-//#endregion
-export { ParsedCandidate, parseCandidate, splitRoot };
-//# sourceMappingURL=candidate.d.ts.map