@vectoriox/iox-ui 5.28.0 → 5.29.0

package/fesm2022/vectoriox-iox-ui-generation-core.mjs

@@ -1,18 +1,104 @@
-import { NEW_NODE_STYLE_DEFAULTS, defaultElementStyleFor, elementStyleById, ownedTraitsOf, applyElementStyle, flavorPackById, parseHexColor, SPEC_AXES, resolveDesignChoices } from '@vectoriox/iox-ui/design-core';
+import { NEW_NODE_STYLE_DEFAULTS, defaultElementStyleFor, elementStyleById, ownedTraitsOf, applyElementStyle, flavorPackById, parseHexColor, SPEC_AXES, LinkType, resolveDesignChoices } from '@vectoriox/iox-ui/design-core';
+import { formPresetById } from '@vectoriox/iox-ui/forms-core';
 
 // GENERATED from iox-ai-guidance flavor-spec.v1.json — do not edit; re-run scripts/gen-flavor-spec.mjs
 // (npm run gen:flavor-spec). The JSON is itself generated by iox-ai-guidance
 // architecture/builder/design-system/build-spec.mjs: change a value THERE, then regenerate both.
 /* eslint-disable */
 const SPEC_SITE_PLAN_SHAPE = {
-    "version": "1",
-    "source": "{ kind: 'template', templateId, templateVersion } | { kind: 'ai', runId }",
-    "business": "{ name (required), tagline?, facts: { email?, phone?, city? } }",
-    "design": "{ flavorId, seed, pairId, shape, density, motion, pillButtons, mode }  — the DesignChoices of the design system",
-    "contentTypes": "ContentTypePlan[] — { name, label, fields[], seed }",
-    "dataSources": "DataSourcePlan[] — merged by alias into the org library",
-    "pages": "PagePlan[] — { key, name, route, isHome?, template?, routeSource?, sections: { pattern, slots?, binding?, without? }[] }",
-    "globals": "{ header: patternId, footer: patternId }"
+    "plan": {
+        "version": "'1'",
+        "source": "sourceTemplate | sourceAi",
+        "business": "business",
+        "design": "design",
+        "contentTypes": "contentType[]",
+        "dataSources": "(cmsDataSource | relativeDataSource)[] — merged by alias into the org library",
+        "pages": "page[]",
+        "globals": "globals"
+    },
+    "sourceTemplate": {
+        "kind": "'template'",
+        "templateId": "string",
+        "templateVersion": "integer"
+    },
+    "sourceAi": {
+        "kind": "'ai'",
+        "runId": "string"
+    },
+    "business": {
+        "name": "string — the brand: the header, the hero, the copyright line",
+        "tagline?": "string — the hero lead and the footer line",
+        "facts?": "{ [fact]: string } — facts (email, phone, city): only the customer's own words; a blank fact is a publish-blocking placeholder, never invented"
+    },
+    "design": {
+        "flavorId": "string — a v2 flavor pack id",
+        "seed": "string — #rrggbb brand colour",
+        "pairId": "string — one of the pack's font pairings",
+        "shape": "string — axes.shapes",
+        "density": "string — axes.densities",
+        "motion": "string — axes.motions",
+        "pillButtons": "boolean",
+        "mode": "'light' | 'dark' | 'auto'",
+        "tint?": "string — axes.tints (DS9 neutral tint)",
+        "fonts?": "object — uploaded font families per role (DS5)"
+    },
+    "contentType": {
+        "name": "string — unique",
+        "label": "string",
+        "previewTextField?": "string — a field of the type: the item's name on cards and the alt text of its bound images",
+        "previewImageField?": "string — a field of the type: the item's picture",
+        "fields": "field[]",
+        "seed?": "seed"
+    },
+    "field": {
+        "name": "string — unique in the type",
+        "type": "string",
+        "controller": "string — an IOX input controller",
+        "required?": "boolean",
+        "note?": "string"
+    },
+    "seed": {
+        "count": "integer ≥ 0",
+        "sample": "boolean — items are flagged isSample",
+        "isPublished": "boolean",
+        "[field]?": "the field's value — strings are templates: {n} = the item's 1-based number, {sampleImage:n} / {sampleImage:n+k} = a bundled sample image"
+    },
+    "cmsDataSource": {
+        "alias": "string — unique; never $… (platform scopes)",
+        "type": "'cms'",
+        "mode": "'query' | 'single'",
+        "contentType": "string — a content type of the plan",
+        "limit?": "integer ≥ 1",
+        "filterByRouteParam?": "{ field, routeParam } — single only: the route param that picks the item"
+    },
+    "relativeDataSource": {
+        "alias": "string — unique",
+        "type": "'relative'",
+        "of": "string — a single cms source (the subject)",
+        "op": "'$siblings.next' | '$siblings.prev'",
+        "within": "string — a query cms source of the same type"
+    },
+    "page": {
+        "key": "string — unique",
+        "name": "string — the nav label",
+        "route": "string — /lowercase-words, :params; unique",
+        "isHome?": "boolean — exactly one page, at /",
+        "required?": "boolean — a template page the wizard's Pages step cannot leave out",
+        "inNav?": "boolean — a Link in the header and footer navigation, in plan order",
+        "template?": "string — the content type a template page renders one item of",
+        "routeSource?": "string — the single source read by the route param (route.* binds it)",
+        "sections": "section[]"
+    },
+    "section": {
+        "pattern": "string — a non-global pattern id",
+        "slots?": "{ [slot]: string } — the pattern's declared slots",
+        "binding?": "string — the list source a pattern's $binding repeater iterates (exactly when it has one)",
+        "without?": "string[] — the pattern's optional parts to leave out"
+    },
+    "globals": {
+        "header": "string — a header pattern (global: before)",
+        "footer": "string — a footer pattern (global: after)"
+    }
 };
 const SPEC_SITE_FACTS = {
     "email": "Email address",
@@ -30,6 +116,7 @@ const SPEC_SITE_PATTERNS = {
             "tag": "nav",
             "lay": {
                 "display": "flex",
+                "flexWrap": "wrap",
                 "justifyContent": "space-between",
                 "alignItems": "center",
                 "gap": "var(--iox-space-gap)"
@@ -55,21 +142,17 @@ const SPEC_SITE_PATTERNS = {
                     "lay": {
                         "display": "flex",
                         "flexWrap": "wrap",
-                        "gap": "28px",
-                        "alignItems": "center"
+                        "gap": "var(--iox-space-gap)",
+                        "alignItems": "center",
+                        "width": "auto"
                     },
                     "c": [
                         {
-                            "t": "Repeater",
-                            "src": "$navPages",
-                            "c": [
-                                {
-                                    "t": "Link",
-                                    "es": "link",
-                                    "bind": "page.name",
-                                    "href": "$page.route"
-                                }
-                            ]
+                            "t": "Link",
+                            "es": "link",
+                            "each": "$navPages",
+                            "bind": "page.name",
+                            "href": "$page.route"
                         },
                         {
                             "t": "ButtonBlock",
@@ -147,16 +230,11 @@ const SPEC_SITE_PATTERNS = {
                                     "text": "Pages"
                                 },
                                 {
-                                    "t": "Repeater",
-                                    "src": "$navPages",
-                                    "c": [
-                                        {
-                                            "t": "Link",
-                                            "es": "link",
-                                            "bind": "page.name",
-                                            "href": "$page.route"
-                                        }
-                                    ]
+                                    "t": "Link",
+                                    "es": "link",
+                                    "each": "$navPages",
+                                    "bind": "page.name",
+                                    "href": "$page.route"
                                 }
                             ]
                         },
@@ -202,7 +280,7 @@ const SPEC_SITE_PATTERNS = {
                     "t": "Text",
                     "es": "small",
                     "slot": "copyright",
-                    "fromBusiness": "copyright"
+                    "text": "© {year} {business.name}"
                 }
             ],
             "lay": {
@@ -680,6 +758,7 @@ const SPEC_SITE_PATTERNS = {
                             "t": "Image",
                             "es": "media",
                             "bind": "item",
+                            "alt": "",
                             "aspect": "4 / 3"
                         }
                     ]
@@ -854,32 +933,7 @@ const SPEC_SITE_PATTERNS = {
                             "c": [
                                 {
                                     "t": "Form",
-                                    "preset": "contact",
-                                    "c": [
-                                        {
-                                            "t": "Field",
-                                            "control": "text",
-                                            "label": "Name",
-                                            "required": true
-                                        },
-                                        {
-                                            "t": "Field",
-                                            "control": "email",
-                                            "label": "Email",
-                                            "required": true
-                                        },
-                                        {
-                                            "t": "Field",
-                                            "control": "textarea",
-                                            "label": "Message",
-                                            "required": true
-                                        },
-                                        {
-                                            "t": "SubmitButton",
-                                            "es": "button-primary",
-                                            "text": "Send"
-                                        }
-                                    ]
+                                    "preset": "contact"
                                 }
                             ]
                         }
@@ -1301,7 +1355,9 @@ const NODE_BASELINES = {
     "ButtonBlock": {
         "props": {
             "tag": "button",
+            "linkType": "external",
             "href": "",
+            "pageRoute": "",
             "target": "_self",
             "type": "button"
         },
@@ -1391,7 +1447,9 @@ const NODE_BASELINES = {
         },
         "traits": [
             "tag",
+            "linkType",
             "href",
+            "pageRoute",
             "target",
             "type"
         ],
@@ -5944,9 +6002,168 @@ const NODE_BASELINES = {
         "container": true
     }
 };
+/** What every style trait saves as when no constructor sets it (buildFullStyleTraits' defaults). */
+const NEUTRAL_STYLE_PROPS = {
+    "position": "static",
+    "top": "auto",
+    "right": "auto",
+    "bottom": "auto",
+    "left": "auto",
+    "zIndex": "0",
+    "display": "block",
+    "flexDirection": "row",
+    "flexWrap": "nowrap",
+    "justifyContent": "flex-start",
+    "alignItems": "stretch",
+    "gap": "0px",
+    "gridTemplateColumns": "1fr",
+    "gridTemplateRows": "auto",
+    "justifyItems": "stretch",
+    "alignContent": "stretch",
+    "direction": "ltr",
+    "alignSelf": "auto",
+    "order": "0",
+    "flexGrow": "0",
+    "flexShrink": "1",
+    "flexBasis": "auto",
+    "justifySelf": "auto",
+    "gridColumn": "auto",
+    "gridRow": "auto",
+    "width": "auto",
+    "height": "auto",
+    "minWidth": "auto",
+    "minHeight": "auto",
+    "maxWidth": "auto",
+    "maxHeight": "auto",
+    "aspectRatio": "auto",
+    "objectFit": "cover",
+    "overflow": "visible",
+    "fontFamily": "Poppins, sans-serif",
+    "fontSize": "16px",
+    "fontWeight": "400",
+    "color": "#000000",
+    "lineHeight": "1.5",
+    "letterSpacing": "0px",
+    "textTransform": "none",
+    "textAlign": "left",
+    "fontStyle": "normal",
+    "textDecoration": "none",
+    "WebkitTextStrokeWidth": "0px",
+    "WebkitTextStrokeColor": "transparent",
+    "margin": "0px 0px 0px 0px",
+    "padding": "0px 0px 0px 0px",
+    "borderWidth": "0px",
+    "borderStyle": "solid",
+    "borderColor": "#CCCCCC",
+    "borderRadius": "0px",
+    "backgroundColor": "transparent",
+    "opacity": "1",
+    "mixBlendMode": "normal",
+    "cursor": "auto",
+    "boxShadow": "",
+    "textShadow": "",
+    "translateX": "0px",
+    "translateY": "0px",
+    "scaleX": "1",
+    "scaleY": "1",
+    "rotate": "0deg",
+    "skewX": "0deg",
+    "skewY": "0deg",
+    "filterBlur": "0px",
+    "filterHueRotate": "0deg",
+    "filterBrightness": "1",
+    "filterContrast": "1",
+    "filterSaturate": "1",
+    "filterGrayscale": "0",
+    "filterSepia": "0",
+    "filterInvert": "0",
+    "backdropFilter": "none",
+    "backdropBlur": "0px",
+    "backdropBrightness": "1",
+    "backdropContrast": "1",
+    "backdropSaturate": "1",
+    "clipPath": "none",
+    "transitionDuration": "0ms",
+    "transitionDelay": "0ms",
+    "transitionTimingFunction": "ease"
+};
+
+/**
+ * Why each type's constructor sets the style values it sets (W1.1, Q1). Every value a type's config
+ * gives that differs from what the trait saves when nobody sets it (`NEUTRAL_STYLE_PROPS`) is exactly
+ * one of:
+ *
+ * - **Layout** — a size or spacing that exists only so an EMPTY node dropped from the palette is visible
+ *   and grabbable (a Container's 200px, a Text's 10px padding). A composed node is never empty and its
+ *   pattern owns its box, so the composer RELEASES these to the neutral value unless the pattern
+ *   declares one: the nav bar was 200px tall and every lead line indented 10px (W1's screenshot).
+ * - **Behaviour** — what makes the type work: a button's inline-flex centring, a form's column, the 44px
+ *   touch target, a slide's width, a spacer's height, a list's marker room. Kept.
+ * - **Look** — the type's pre-design-system paint, which its element style replaces. Kept (the style
+ *   writes over it; a type with no style keeps its pre-DS2 look, D5).
+ *
+ * Saved pages are untouched: this is the composer's rule, never the builder's (a palette drop still
+ * gets its 200px). `baseline-roles.spec.ts` fails the moment a config gains a default this table does
+ * not classify — so a new default is a decision, not an accident.
+ */
+var BaselineRole;
+(function (BaselineRole) {
+    BaselineRole["Layout"] = "layout";
+    BaselineRole["Behaviour"] = "behaviour";
+    BaselineRole["Look"] = "look";
+})(BaselineRole || (BaselineRole = {}));
+const { Layout, Behaviour, Look } = BaselineRole;
+const BASELINE_ROLES = {
+    Button: {},
+    ButtonBlock: {
+        display: Behaviour, justifyContent: Behaviour, alignItems: Behaviour, gap: Behaviour, cursor: Behaviour,
+        padding: Look, borderRadius: Look,
+    },
+    Card: { width: Behaviour, maxWidth: Layout, padding: Look, borderWidth: Look, borderColor: Look, borderRadius: Look, backgroundColor: Look },
+    // `width: 100%` (DEFAULT_WIDTH_BY_TYPE) is what lets a block fill its row — a flex child collapses without it.
+    Container: { width: Behaviour, minHeight: Layout },
+    Heading: { fontSize: Look, fontWeight: Look },
+    Text: { width: Behaviour, minHeight: Layout, padding: Layout },
+    Image: { width: Behaviour, maxWidth: Layout, aspectRatio: Layout },
+    Link: {},
+    LinkedContainer: { minHeight: Layout },
+    Section: { minHeight: Layout },
+    Icon: { lineHeight: Behaviour, fontSize: Behaviour, color: Look },
+    Divider: { width: Behaviour, height: Look, margin: Layout, backgroundColor: Look },
+    Spacer: { width: Behaviour, height: Behaviour },
+    List: { width: Behaviour, padding: Behaviour },
+    ListItem: { width: Behaviour },
+    Repeater: { width: Behaviour },
+    SliderContainer: { width: Behaviour },
+    SliderSlide: { width: Behaviour, aspectRatio: Behaviour },
+    // The crossfade stacks its frames absolutely: without a box it has no height at all.
+    Gallery: { minHeight: Behaviour, backgroundColor: Look },
+    Form: { display: Behaviour, flexDirection: Behaviour, gap: Behaviour, width: Behaviour },
+    Field: { width: Behaviour },
+    FieldGroup: { display: Behaviour, gap: Behaviour, width: Behaviour },
+    SubmitButton: {
+        display: Behaviour, justifyContent: Behaviour, alignItems: Behaviour, minHeight: Behaviour, cursor: Behaviour,
+        color: Look, padding: Look, borderRadius: Look, backgroundColor: Look,
+    },
+    FormSuccess: { width: Behaviour, color: Look, padding: Look, borderRadius: Look, backgroundColor: Look },
+    FormError: { width: Behaviour, color: Look, padding: Look, borderRadius: Look, backgroundColor: Look },
+    Dialog: { width: Behaviour, padding: Look, borderRadius: Look, backgroundColor: Look, boxShadow: Look },
+};
+/** The style values a type's constructor sets for an empty palette drop, each mapped to the value the
+ *  trait saves when nobody sets it — what a composed node of that type starts from. */
+function releasedLayoutDefaults(type) {
+    const roles = BASELINE_ROLES[type] ?? {};
+    const out = {};
+    for (const [trait, role] of Object.entries(roles)) {
+        if (role === BaselineRole.Layout && trait in (NODE_BASELINES[type]?.styleProps ?? {}))
+            out[trait] = NEUTRAL_STYLE_PROPS[trait];
+    }
+    return out;
+}
 
 /**
- * The Site Plan (contract `site.planShape`) — the ONE document the website wizard writes
+ * The Site Plan (contract `site.planShape`, `SPEC_SITE_PLAN_SHAPE`: every key typed and explained, and the
+ * validator reads its key lists from it) — the ONE document the website wizard writes
  * (`source.kind: template`) and the AI agent will write (`source.kind: ai`). One validator, one
  * composer: everything the wizard proves is proven for the agent.
  */
@@ -5998,9 +6215,10 @@ var PatternDirective;
 (function (PatternDirective) {
     /** A Repeater's source: the section's `binding`. */
     PatternDirective["Binding"] = "$binding";
-    /** A Repeater's source: the plan's pages that are in the navigation. */
+    /** `each`: one plain node per page of the plan that is in the navigation (`inNav`), in plan order —
+     *  words and routes written in, editable on the canvas (W1.1). */
     PatternDirective["NavPages"] = "$navPages";
-    /** A Link's route: the nav item's route. */
+    /** A Link's route: the route of the page an `each` node is stamped for. */
     PatternDirective["PageRoute"] = "$page.route";
 })(PatternDirective || (PatternDirective = {}));
 /** The scopes a `bind` / `param` / `src` path starts with. */
@@ -6008,7 +6226,7 @@ var BindScope;
 (function (BindScope) {
     /** The nearest Repeater's row. */
     BindScope["Item"] = "item";
-    /** The nearest Repeater's row, when that Repeater iterates the navigation's pages. */
+    /** The page an `each: $navPages` node is stamped for — resolved to plain words, never a binding. */
     BindScope["Page"] = "page";
     /** The page's route item (`routeSource`). */
     BindScope["Route"] = "route";
@@ -6041,11 +6259,26 @@ function patternOptionalParts(pattern) {
 function patternNeedsBinding(pattern) {
     return patternNodes(pattern).some(n => n.src === PatternDirective.Binding);
 }
+const IMAGE_TYPE = 'Image';
+/** The scopes whose ITEM a pattern's bound Images take their alt text from (an Image that names no `alt`
+ *  of its own): `item` (the row of a `$binding` Repeater — the section's list), `route` or `next`. Each
+ *  needs a content type with a `previewTextField` (W1.1, Q7). */
+function altSourceScopes(pattern) {
+    const scopes = new Set();
+    const visit = (n) => {
+        if (n.t === IMAGE_TYPE && n.bind && n.alt === undefined)
+            scopes.add(n.bind.split('.')[0]);
+        for (const child of n.c ?? [])
+            visit(child);
+    };
+    visit(pattern.node);
+    return scopes;
+}
 /** The bind scopes a pattern reads (`route`, `next`, …) — what its page must provide. */
 function patternScopes(pattern) {
     const scopes = new Set();
     for (const n of patternNodes(pattern)) {
-        for (const path of [n.bind, n.param, n.src]) {
+        for (const path of [n.bind, n.alt, n.param, n.src]) {
             if (path && !path.startsWith('$'))
                 scopes.add(path.split('.')[0]);
         }
@@ -6097,9 +6330,10 @@ const clone$1 = (value) => JSON.parse(JSON.stringify(value));
  * A NEW node of `type`, as the builder creates one (ComponentRegistryService.createConfig, serialized):
  * the type's constructor defaults, its text colour released to `inherit` (NEW_NODE_STYLE_DEFAULTS), then
  * ONE element style — `elementStyle` when given, else the type's default for its props (a Heading
- * follows its level). `props` are applied before the style is chosen.
+ * follows its level). `props` are applied before the style is chosen. With `releaseLayoutDefaults` the
+ * constructor's layout sizes are released first, so an element style that owns one still writes it.
  */
-function createSerializedNode(id, type, props = {}, elementStyle) {
+function createSerializedNode(id, type, props = {}, elementStyle, options = {}) {
     const baseline = NODE_BASELINES[type];
     if (!baseline)
         throw new ComposeError(`"${type}" is not a registered component type`);
@@ -6111,6 +6345,8 @@ function createSerializedNode(id, type, props = {}, elementStyle) {
         bindings: [],
         interactions: [],
     };
+    if (options.releaseLayoutDefaults)
+        Object.assign(node.styleProps, releasedLayoutDefaults(type));
     for (const [name, value] of Object.entries(NEW_NODE_STYLE_DEFAULTS))
         if (name in node.styleProps)
             node.styleProps[name] = value;
@@ -6182,6 +6418,9 @@ var SitePlanIssueCode;
     SitePlanIssueCode["UnknownOptionalPart"] = "unknown-optional-part";
     SitePlanIssueCode["Binding"] = "binding";
     SitePlanIssueCode["MissingScope"] = "missing-scope";
+    /** A pattern binds an item's image, and the item's content type names no `previewTextField` to be
+     *  its alt text. */
+    SitePlanIssueCode["MissingPreviewField"] = "missing-preview-field";
 })(SitePlanIssueCode || (SitePlanIssueCode = {}));
 class SitePlanError extends Error {
     constructor(issues) {
@@ -6189,23 +6428,34 @@ class SitePlanError extends Error {
         this.issues = issues;
     }
 }
-/** The alias of the static source the composer writes for the navigation (`$navPages`). A plan source
- *  may not take it. */
-const NAV_PAGES_ALIAS = 'navPages';
 /** Route-scope aliases (`$route`, `$current`, …) are platform-owned. */
 const RESERVED_PREFIX = '$';
 const ID_FIELD = '_id';
-const PLAN_KEYS = ['version', 'source', 'business', 'design', 'contentTypes', 'dataSources', 'pages', 'globals'];
-const BUSINESS_KEYS = ['name', 'tagline', 'facts'];
-const DESIGN_REQUIRED = ['flavorId', 'seed', 'pairId', 'shape', 'density', 'motion', 'pillButtons', 'mode'];
-const DESIGN_KEYS = [...DESIGN_REQUIRED, 'tint', 'fonts'];
-const CONTENT_TYPE_KEYS = ['name', 'label', 'previewTextField', 'previewImageField', 'fields', 'seed'];
-const FIELD_KEYS = ['name', 'type', 'controller', 'required', 'note'];
-const SEED_FIXED_KEYS = ['count', 'sample', 'isPublished'];
-const CMS_SOURCE_KEYS = ['alias', 'type', 'mode', 'contentType', 'limit', 'filterByRouteParam'];
-const RELATIVE_SOURCE_KEYS = ['alias', 'type', 'of', 'op', 'within'];
-const PAGE_KEYS = ['key', 'name', 'route', 'isHome', 'required', 'inNav', 'template', 'routeSource', 'sections'];
-const SECTION_KEYS = ['pattern', 'slots', 'binding', 'without'];
+const OPTIONAL_MARK = '?';
+const DYNAMIC_KEY = /^\[[^\]]+\]\??$/;
+const isDynamic = (key) => DYNAMIC_KEY.test(key);
+/** Every fixed key an object of the shape may carry. */
+function shapeKeys(entry) {
+    return Object.keys(entry).filter(k => !isDynamic(k)).map(k => (k.endsWith(OPTIONAL_MARK) ? k.slice(0, -1) : k));
+}
+/** The keys an object of the shape must carry. */
+function requiredShapeKeys(entry) {
+    return Object.keys(entry).filter(k => !isDynamic(k) && !k.endsWith(OPTIONAL_MARK));
+}
+const SHAPE = SPEC_SITE_PLAN_SHAPE;
+const PLAN_KEYS = shapeKeys(SHAPE['plan']);
+const TEMPLATE_SOURCE_KEYS = shapeKeys(SHAPE['sourceTemplate']);
+const AI_SOURCE_KEYS = shapeKeys(SHAPE['sourceAi']);
+const BUSINESS_KEYS = shapeKeys(SHAPE['business']);
+const DESIGN_REQUIRED = requiredShapeKeys(SHAPE['design']);
+const DESIGN_KEYS = shapeKeys(SHAPE['design']);
+const CONTENT_TYPE_KEYS = shapeKeys(SHAPE['contentType']);
+const FIELD_KEYS = shapeKeys(SHAPE['field']);
+const SEED_FIXED_KEYS = shapeKeys(SHAPE['seed']);
+const CMS_SOURCE_KEYS = shapeKeys(SHAPE['cmsDataSource']);
+const RELATIVE_SOURCE_KEYS = shapeKeys(SHAPE['relativeDataSource']);
+const PAGE_KEYS = shapeKeys(SHAPE['page']);
+const SECTION_KEYS = shapeKeys(SHAPE['section']);
 const GLOBAL_POSITION = {
     [GlobalSlot.Header]: PatternGlobalPosition.Before,
     [GlobalSlot.Footer]: PatternGlobalPosition.After,
@@ -6269,13 +6519,13 @@ function validateSource(c, source) {
     if (!isObject(source))
         return c.add(SitePlanIssueCode.Shape, 'source', 'must be an object');
     if (source['kind'] === SitePlanSourceKind.Template) {
-        c.keys(source, ['kind', 'templateId', 'templateVersion'], 'source');
+        c.keys(source, TEMPLATE_SOURCE_KEYS, 'source');
         c.string(source, 'templateId', 'source');
         if (!Number.isInteger(source['templateVersion']))
             c.add(SitePlanIssueCode.Shape, 'source.templateVersion', 'must be an integer');
     }
     else if (source['kind'] === SitePlanSourceKind.Ai) {
-        c.keys(source, ['kind', 'runId'], 'source');
+        c.keys(source, AI_SOURCE_KEYS, 'source');
         c.string(source, 'runId', 'source');
     }
     else {
@@ -6357,10 +6607,12 @@ function validateContentTypes(c, list) {
         });
         c.unique(names, j => `${path}.fields[${j}].name`, 'field');
         const fieldSet = new Set(names.filter((n) => !!n));
+        const preview = {};
         for (const key of ['previewTextField', 'previewImageField']) {
             const v = c.string(raw, key, path, false);
             if (v && !fieldSet.has(v))
                 c.add(SitePlanIssueCode.UnknownField, `${path}.${key}`, `"${v}" is not a field of ${name}`);
+            preview[key] = v && fieldSet.has(v) ? v : null;
         }
         const seed = raw['seed'];
         if (seed !== undefined) {
@@ -6381,7 +6633,7 @@ function validateContentTypes(c, list) {
         if (name && types.has(name))
             c.add(SitePlanIssueCode.Duplicate, `${path}.name`, `content type "${name}" is used twice`);
         else if (name)
-            types.set(name, { fields: fieldSet });
+            types.set(name, { fields: fieldSet, previewTextField: preview['previewTextField'] ?? undefined });
     });
     return types;
 }
@@ -6392,7 +6644,7 @@ function validateDataSources(c, list, types) {
         if (!isObject(raw))
             return c.add(SitePlanIssueCode.Shape, path, 'must be an object');
         const alias = c.string(raw, 'alias', path);
-        if (alias && (alias.startsWith(RESERVED_PREFIX) || alias === NAV_PAGES_ALIAS)) {
+        if (alias && alias.startsWith(RESERVED_PREFIX)) {
             c.add(SitePlanIssueCode.ReservedAlias, `${path}.alias`, `"${alias}" is reserved for the platform`);
         }
         if (raw['type'] === PlanDataSourceType.Cms) {
@@ -6557,6 +6809,15 @@ function validatePages(c, list, types, sources) {
             if (scopes.has(BindScope.Next) && routeSourceOk && !nextSourceOf(sources, routeSourceAlias)) {
                 c.add(SitePlanIssueCode.MissingScope, `${sp}.pattern`, `"${patternId}" reads the next item — the plan needs a ${RelativeOp.SiblingsNext} source of ${routeSourceAlias}`);
             }
+            // A bound image's alt text is its item's previewTextField (W1.1): the item's type must name one.
+            for (const scope of altSourceScopes(pattern)) {
+                const alias = scope === BindScope.Item ? binding : routeSourceOk ? routeSourceAlias : null;
+                const typeName = alias ? sources.get(alias)?.contentType : undefined;
+                const type = typeName ? types.get(typeName) : undefined;
+                if (type && !type.previewTextField) {
+                    c.add(SitePlanIssueCode.MissingPreviewField, `${sp}.pattern`, `"${patternId}" shows ${typeName} images — ${typeName} needs a previewTextField for their alt text`);
+                }
+            }
         });
     });
     c.unique(list.map(p => (isObject(p) && isNonEmptyString(p['key']) ? p['key'] : null)), i => `pages[${i}].key`, 'page key');
@@ -6613,10 +6874,12 @@ function assertValidSitePlan(plan) {
 /**
  * THE composer — a Site Plan in, ordinary IOX data out (design-system plan §6b, W1). Deterministic and
  * pure: the same plan composes to byte-identical output, with no clock, no randomness and no transport.
- * The wizard and the AI agent both end here; W2's site-build service writes what it returns.
+ * The wizard and the AI agent both end here; W2's site-build service writes what it returns. The one
+ * thing that changes with time — the copyright year — comes in through `ComposeContext`.
  *
  * Every node is created the way the builder creates one (`createSerializedNode`): the type's full
- * constructor defaults, then ONE element style, then the pattern's layout. So a composed page is what
+ * constructor defaults — its empty-drop sizes released, so the pattern owns its box (`BASELINE_ROLES`) —
+ * then ONE element style, then the pattern's layout. So a composed page is what
  * an author would have built by hand from the palette — the builder reloads it and saves it unchanged,
  * and the engine renders it with nothing to resolve. Never a colour, size or font a pattern did not
  * name; never a fact the customer did not give (blank → a placeholder carrying the fact's label).
@@ -6635,9 +6898,18 @@ var ComposeIssueCode;
     /** A slot the plan and the business left empty and the pattern gives no words for — the node keeps
      *  its type's default text. */
     ComposeIssueCode["UnfilledSlot"] = "unfilled-slot";
-    /** A pattern links to a route the plan has no page for (an optional page was left out). */
-    ComposeIssueCode["DanglingLink"] = "dangling-link";
+    /** A link to a page the plan leaves out now opens an email to the business (`mailto:`). */
+    ComposeIssueCode["LinkToEmail"] = "link-to-email";
+    /** A link or button to a page the plan leaves out, with no business email to send to: removed. */
+    ComposeIssueCode["LinkRemoved"] = "link-removed";
+    /** A linked box to a page the plan leaves out, with no business email: it keeps its contents as a
+     *  plain Container and loses only the link. */
+    ComposeIssueCode["LinkUnlinked"] = "link-unlinked";
 })(ComposeIssueCode || (ComposeIssueCode = {}));
+/** The issues that are a dangling link (a route the plan has no page for) and what was done about it. */
+const DANGLING_LINK_CODES = new Set([
+    ComposeIssueCode.LinkToEmail, ComposeIssueCode.LinkRemoved, ComposeIssueCode.LinkUnlinked,
+]);
 /** `{sampleImage:k}` — a bundled abstract sample image, never a stock photo (plan §6b). */
 const SAMPLE_IMAGE_REF = /^\{sampleImage:(\d+)\}$/;
 const SAMPLE_IMAGE_TEMPLATE = /\{sampleImage:n(?:\+(\d+))?\}/g;
@@ -6664,19 +6936,38 @@ const BIND_PROP = {
     Link: 'label',
     Image: 'src',
 };
-/** Types whose `href` is a website page (`linkType: page` + `pageRoute`). */
-const PAGE_LINK_TYPES = new Set(['Link', 'LinkedContainer']);
+const LINK_SLOTS = {
+    Link: { url: 'url' },
+    LinkedContainer: { url: 'url' },
+    ButtonBlock: { url: 'href', fixed: { tag: 'a' } },
+};
+/** What a linked box becomes when its link has nowhere to go: the same box, unlinked. */
+const UNLINKED_TYPE = { LinkedContainer: 'Container' };
 const BUTTON_BLOCK = 'ButtonBlock';
 const FORM = 'Form';
-const FORM_STATE_BLOCKS = ['FormSuccess', 'FormError'];
-const LINK_TYPE_PAGE = 'page';
-const ANCHOR_TAG = 'a';
+const FIELD = 'Field';
+const IMAGE = 'Image';
+const SUBMIT_BUTTON = 'SubmitButton';
+const FORM_SUCCESS = 'FormSuccess';
+const FORM_ERROR = 'FormError';
+const FORM_STATE_BLOCKS = [FORM_SUCCESS, FORM_ERROR];
+/** The Field traits a preset field fills, 1:1 (`FormPresetField`). */
+const PRESET_FIELD_PROPS = ['label', 'control', 'required', 'help', 'placeholder', 'optionsText', 'rows'];
 const LABEL_TAG = 'span';
 const TEXT = 'Text';
-/** A button's label reads the button's type and ink (the consent preset's labels, `consent-preset.ts`). */
-const BUTTON_LABEL_INHERITS = { fontSize: 'inherit', fontWeight: 'inherit', color: 'inherit' };
+/** A button's label reads the button's own type and ink (contract element style, W1.1 Q6). */
+const BUTTON_LABEL_STYLE = 'button-label';
 const ITEM_VALUE_PATH = '$';
 const STATUS_DRAFT = 'draft';
+const MAILTO = 'mailto:';
+/** A pattern's `alt: ''` — the image is decorative and its alt is written empty. */
+const DECORATIVE_ALT = '';
+/** What the composer writes for every node: the pattern owns the box (W1.1, Q1). */
+const COMPOSED = { releaseLayoutDefaults: true };
+/** The words a pattern may leave for compose time: the year (`ComposeContext`) and the business name. */
+const TEXT_VARIABLE = /\{(year|business\.name)\}/g;
+/** What `page.*` may read on a node stamped for a navigation page. */
+const STAMPED_PAGE_FIELDS = new Set(['name', 'route']);
 const clone = (value) => JSON.parse(JSON.stringify(value));
 /** 32-bit FNV-1a, base 36 — a short stable id fragment. */
 function stableHash(text) {
@@ -6687,15 +6978,14 @@ function stableHash(text) {
     }
     return h.toString(36).padStart(7, '0').slice(-6);
 }
-/** A page route as a base-relative href — the engine's `resolvePageHref` form (`/contact` → `contact`,
- *  `/` → `./`), so a link stays inside the org's `<base href>`. */
-function baseRelativeHref(route) {
-    const path = route.replace(/\/{2,}/g, '/').replace(/^\/+/, '').replace(/\/+$/, '');
-    return path || './';
-}
+const create = (id, type, props = {}, elementStyle) => createSerializedNode(id, type, props, elementStyle, COMPOSED);
 function nonEmpty(v) {
     return typeof v === 'string' && v.trim() !== '';
 }
+/** A pattern's own words with the compose-time variables filled: `{year}`, `{business.name}`. */
+function fillVariables(text, ctx) {
+    return text.replace(TEXT_VARIABLE, (_m, name) => (name === 'year' ? String(ctx.year) : ctx.plan.business.name));
+}
 /** Where a node's words come from: the plan's slot → the business → the customer's fact → the pattern's
  *  own text. A missing fact shows its label and is a placeholder; nothing is ever made up. */
 function chooseText(pn, ctx) {
@@ -6712,17 +7002,17 @@ function chooseText(pn, ctx) {
         const given = ctx.plan.business.facts?.[fact];
         return nonEmpty(given) ? { value: given } : { value: SITE_FACT_LABELS[fact], placeholder: { kind: PlaceholderKind.Fact, fact } };
     }
+    const own = pn.text === undefined ? undefined : fillVariables(pn.text, ctx);
     if (pn.ph === PatternPlaceholder.Copy)
-        return { value: pn.text, placeholder: { kind: PlaceholderKind.Copy } };
-    return { value: pn.text };
+        return { value: own, placeholder: { kind: PlaceholderKind.Copy } };
+    return { value: own };
 }
-/** A `bind` / `param` / `src` path → the binding source + path, in this node's scope. */
+/** A `bind` / `alt` / `param` / `src` path → the binding source + path, in this node's scope. */
 function resolveScoped(path, repeater, ctx, nodeId) {
     const [scope, ...rest] = path.split('.');
     const sub = rest.join('.');
     switch (scope) {
         case BindScope.Item:
-        case BindScope.Page:
             if (!repeater)
                 throw new ComposeError(`${nodeId}: "${path}" outside a Repeater`);
             return { source: repeater.itemAlias, path: sub || ITEM_VALUE_PATH };
@@ -6738,6 +7028,25 @@ function resolveScoped(path, repeater, ctx, nodeId) {
             throw new ComposeError(`${nodeId}: unknown binding scope "${scope}"`);
     }
 }
+/** `page.<field>` on a node stamped for a navigation page: that page's own words, written in. */
+function stampedPageValue(path, ctx, nodeId) {
+    const field = path.split('.').slice(1).join('.');
+    if (!ctx.navPage)
+        throw new ComposeError(`${nodeId}: "${path}" on a node that is not stamped per page (each)`);
+    if (!STAMPED_PAGE_FIELDS.has(field))
+        throw new ComposeError(`${nodeId}: a page has no "${field}" (${[...STAMPED_PAGE_FIELDS].join(', ')})`);
+    return ctx.navPage[field];
+}
+const isPageScope = (path) => !!path && path.split('.')[0] === BindScope.Page;
+/** The content type behind a data source alias (a relative source reads its `within` list's type). */
+function contentTypeOfSource(alias, plan) {
+    const ds = plan.dataSources.find(d => d.alias === alias);
+    if (!ds)
+        return undefined;
+    if (ds.type === PlanDataSourceType.Relative)
+        return contentTypeOfSource(ds.within, plan);
+    return plan.contentTypes.find(t => t.name === ds.contentType);
+}
 function addBinding(node, binding) {
     const declared = NODE_BASELINES[node.type]?.traits ?? [];
     if (!declared.includes(binding.prop) && !binding.prop.startsWith('routeParam:')) {
@@ -6755,10 +7064,136 @@ function setProp(node, name, value) {
     assertTraits(node.type, [name]);
     node.props[name] = value;
 }
-/** One pattern node → one serialized node (and its subtree). `null` when the section leaves it out. */
+function linkSlots(node) {
+    const slots = LINK_SLOTS[node.type];
+    if (!slots)
+        throw new ComposeError(`${node.id}: ${node.type} cannot link`);
+    return slots;
+}
+/** A link to one of the site's pages, by route — the builder shows the route, the engine resolves it. */
+function writePageLink(node, route) {
+    const slots = linkSlots(node);
+    for (const [k, v] of Object.entries(slots.fixed ?? {}))
+        setProp(node, k, v);
+    setProp(node, 'linkType', LinkType.Page);
+    setProp(node, 'pageRoute', route);
+}
+function writeExternalLink(node, url) {
+    const slots = linkSlots(node);
+    for (const [k, v] of Object.entries(slots.fixed ?? {}))
+        setProp(node, k, v);
+    setProp(node, 'linkType', LinkType.External);
+    setProp(node, slots.url, url);
+}
+/** What happens to a node linking to a route the plan has no page for (W1.1, Q11) — the same rule for
+ *  every pattern and every page: an email to the business when one is given; else a link or button is
+ *  removed and a linked box keeps its contents, unlinked. */
+var DanglingFate;
+(function (DanglingFate) {
+    DanglingFate["Email"] = "email";
+    DanglingFate["Remove"] = "remove";
+    DanglingFate["Unlink"] = "unlink";
+})(DanglingFate || (DanglingFate = {}));
+function danglingFate(pn, ctx) {
+    if (!pn.href || pn.href === PatternDirective.PageRoute || ctx.routes.has(pn.href))
+        return null;
+    if (ctx.email)
+        return DanglingFate.Email;
+    return UNLINKED_TYPE[pn.t] ? DanglingFate.Unlink : DanglingFate.Remove;
+}
+const DANGLING_ISSUE = {
+    [DanglingFate.Email]: ComposeIssueCode.LinkToEmail,
+    [DanglingFate.Remove]: ComposeIssueCode.LinkRemoved,
+    [DanglingFate.Unlink]: ComposeIssueCode.LinkUnlinked,
+};
+function reportDangling(fate, pn, id, words, ctx) {
+    const what = words ? `"${words}"` : `A ${pn.t === BUTTON_BLOCK ? 'button' : 'link'}`;
+    const outcome = {
+        [DanglingFate.Email]: `it now opens an email to ${ctx.email}`,
+        [DanglingFate.Remove]: 'with no email address to send to instead, it was removed',
+        [DanglingFate.Unlink]: 'with no email address to send to instead, the box keeps its contents without the link',
+    }[fate];
+    ctx.issues.push({
+        code: DANGLING_ISSUE[fate], nodeId: id, owner: ctx.owner, route: pn.href,
+        detail: `${what} linked to ${pn.href}, which this site has no page for — ${outcome}.`,
+    });
+}
+/** The alt binding of a bound Image: the pattern's `alt`, else the bound item's preview text field. */
+function altBinding(pn, repeater, ctx, id) {
+    if (pn.alt)
+        return resolveScoped(pn.alt, repeater, ctx, id);
+    const bound = resolveScoped(pn.bind, repeater, ctx, id);
+    const field = contentTypeOfSource(bound.source, ctx.plan)?.previewTextField;
+    if (!field)
+        throw new ComposeError(`${id}: a bound image needs an alt — the pattern names none and "${bound.source}" has no previewTextField`);
+    return { source: bound.source, path: field };
+}
+/** A preset Form's children — the forms-core preset's fields, submit and the WORDS of both state blocks. */
+function presetChildren(preset, id) {
+    const fields = preset.fields.map((f, i) => {
+        const props = Object.fromEntries(PRESET_FIELD_PROPS.filter(k => f[k] !== undefined).map(k => [k, f[k]]));
+        assertTraits(FIELD, Object.keys(props));
+        return create(`${id}-${i}`, FIELD, props);
+    });
+    const n = fields.length;
+    const submit = create(`${id}-${n}`, SUBMIT_BUTTON, { label: preset.submitLabel });
+    const blocks = [[FORM_SUCCESS, preset.successText], [FORM_ERROR, preset.errorText]].map(([type, words], i) => {
+        const block = create(`${id}-${n + 1 + i}`, type);
+        block.children = [create(`${id}-${n + 1 + i}-0`, TEXT, { content: words })];
+        return block;
+    });
+    return [...fields, submit, ...blocks];
+}
+/** A Form: its stable id, its preset's name and children (or the pattern's own children), and both state
+ *  blocks — never optional (forms plan D7). */
+function composeForm(node, pn, id, ctx) {
+    if (!pn.preset) {
+        node.children = [...(node.children ?? []), ...FORM_STATE_BLOCKS.map((type, i) => create(`${id}-${(pn.c?.length ?? 0) + i}`, type))];
+        return;
+    }
+    const preset = formPresetById(pn.preset);
+    if (!preset)
+        throw new ComposeError(`${id}: no form preset "${pn.preset}" in forms-core`);
+    if (pn.c?.length)
+        throw new ComposeError(`${id}: a preset Form takes its fields from the preset, not the pattern`);
+    setProp(node, 'name', preset.formName);
+    setProp(node, 'formId', `${preset.id}-${stableHash(`${ctx.owner}/${id}`)}`);
+    node.children = presetChildren(preset, id);
+}
+/** A pattern node's children; an `each` child is stamped once per navigation page, its id carrying the
+ *  page key so it survives a page being left out or reordered. */
+function composeChildren(pn, id, repeater, ctx) {
+    const out = [];
+    (pn.c ?? []).forEach((child, i) => {
+        const childId = `${id}-${i}`;
+        if (!child.each) {
+            const node = composeNode(child, childId, repeater, ctx);
+            if (node)
+                out.push(node);
+            return;
+        }
+        if (child.each !== PatternDirective.NavPages)
+            throw new ComposeError(`${childId}: "each" stamps "${PatternDirective.NavPages}" only`);
+        for (const page of ctx.plan.pages.filter(p => p.inNav)) {
+            const node = composeNode(child, `${childId}-${page.key}`, repeater, { ...ctx, navPage: page });
+            if (node)
+                out.push(node);
+        }
+    });
+    return out;
+}
+/** One pattern node → one serialized node (and its subtree). `null` when the section leaves it out or a
+ *  dangling link is removed. */
 function composeNode(pn, id, repeater, ctx) {
     if (pn.optional && ctx.section?.without?.includes(pn.optional))
         return null;
+    const words = chooseText(pn, ctx);
+    const fate = danglingFate(pn, ctx);
+    if (fate === DanglingFate.Remove) {
+        reportDangling(fate, pn, id, words.value, ctx);
+        return null;
+    }
+    const type = fate === DanglingFate.Unlink ? UNLINKED_TYPE[pn.t] : pn.t;
     const props = {};
     if (pn.level)
         props['level'] = pn.level;
@@ -6772,32 +7207,29 @@ function composeNode(pn, id, repeater, ctx) {
         props['label'] = pn.label;
     if (pn.required !== undefined)
         props['required'] = pn.required;
-    assertTraits(pn.t, Object.keys(props));
+    assertTraits(type, Object.keys(props));
     // Props first: a Heading with no `es` wears its LEVEL's default style.
-    const node = createSerializedNode(id, pn.t, props, pn.es ?? null);
+    const node = create(id, type, props, pn.es ?? null);
     // Words.
-    const words = chooseText(pn, ctx);
     if (words.placeholder) {
-        const shown = words.value ?? String(NODE_BASELINES[pn.t]?.props[TEXT_PROP[pn.t]] ?? '');
+        const shown = words.value ?? String(NODE_BASELINES[type]?.props[TEXT_PROP[type]] ?? '');
         ctx.placeholders.push({ nodeId: id, owner: ctx.owner, kind: words.placeholder.kind, ...(words.placeholder.fact ? { fact: words.placeholder.fact } : {}), ...(pn.slot ? { slot: pn.slot } : {}), text: shown });
     }
     else if (words.value === undefined && (pn.slot || pn.fromBusiness)) {
-        ctx.issues.push({ code: ComposeIssueCode.UnfilledSlot, nodeId: id, owner: ctx.owner, detail: `no value for ${pn.slot ? `slot "${pn.slot}"` : `business "${pn.fromBusiness}"`} — keeps the ${pn.t} default` });
+        ctx.issues.push({ code: ComposeIssueCode.UnfilledSlot, nodeId: id, owner: ctx.owner, detail: `no value for ${pn.slot ? `slot "${pn.slot}"` : `business "${pn.fromBusiness}"`} — keeps the ${type} default` });
     }
     if (words.value !== undefined) {
-        if (pn.t === BUTTON_BLOCK) {
-            const label = createSerializedNode(`${id}-label`, TEXT, { content: words.value, tag: LABEL_TAG });
-            setStyleProps(label, BUTTON_LABEL_INHERITS);
-            node.children = [label];
+        if (type === BUTTON_BLOCK) {
+            node.children = [create(`${id}-label`, TEXT, { content: words.value, tag: LABEL_TAG }, BUTTON_LABEL_STYLE)];
         }
         else {
-            const prop = TEXT_PROP[pn.t];
+            const prop = TEXT_PROP[type];
             if (!prop)
-                throw new ComposeError(`${id}: ${pn.t} cannot hold text`);
+                throw new ComposeError(`${id}: ${type} cannot hold text`);
             setProp(node, prop, words.value);
         }
     }
-    // Images.
+    // Images: an empty slot, or a bound one — both fall back to the DS3 empty image, never a stock URL.
     if (pn.ph === PatternPlaceholder.Image) {
         setProp(node, 'src', '');
         ctx.placeholders.push({ nodeId: id, owner: ctx.owner, kind: PlaceholderKind.Image, text: '' });
@@ -6805,38 +7237,41 @@ function composeNode(pn, id, repeater, ctx) {
     if (pn.aspect)
         setStyleProps(node, { aspectRatio: pn.aspect });
     // Links.
-    if (pn.href) {
-        if (pn.href === PatternDirective.PageRoute) {
-            setProp(node, 'linkType', LINK_TYPE_PAGE);
-            addBinding(node, { prop: 'pageRoute', ...resolveScoped(`${BindScope.Page}.route`, repeater, ctx, id) });
-        }
-        else {
-            if (!ctx.routes.has(pn.href))
-                ctx.issues.push({ code: ComposeIssueCode.DanglingLink, nodeId: id, owner: ctx.owner, detail: `links to ${pn.href}, which the plan has no page for` });
-            if (PAGE_LINK_TYPES.has(pn.t)) {
-                setProp(node, 'linkType', LINK_TYPE_PAGE);
-                setProp(node, 'pageRoute', pn.href);
-            }
-            else if (pn.t === BUTTON_BLOCK) {
-                setProp(node, 'tag', ANCHOR_TAG);
-                setProp(node, 'href', baseRelativeHref(pn.href));
-            }
-            else {
-                throw new ComposeError(`${id}: ${pn.t} cannot link`);
-            }
-        }
+    if (pn.href === PatternDirective.PageRoute) {
+        writePageLink(node, stampedPageValue(`${BindScope.Page}.route`, ctx, id));
+    }
+    else if (pn.href && !fate) {
+        writePageLink(node, pn.href);
     }
-    if (pn.param) {
+    else if (fate) {
+        if (fate === DanglingFate.Email)
+            writeExternalLink(node, `${MAILTO}${ctx.email}`);
+        reportDangling(fate, pn, id, words.value, ctx);
+    }
+    if (pn.param && !fate) {
         const names = pn.href ? routeParams(pn.href) : [];
         if (names.length !== 1)
             throw new ComposeError(`${id}: "param" needs an href with one :param`);
         addBinding(node, { prop: `routeParam:${names[0]}`, ...resolveScoped(pn.param, repeater, ctx, id) });
     }
     if (pn.bind) {
-        const prop = BIND_PROP[pn.t];
+        const prop = BIND_PROP[type];
         if (!prop)
-            throw new ComposeError(`${id}: ${pn.t} has no bindable value`);
-        addBinding(node, { prop, ...resolveScoped(pn.bind, repeater, ctx, id) });
+            throw new ComposeError(`${id}: ${type} has no bindable value`);
+        if (isPageScope(pn.bind))
+            setProp(node, prop, stampedPageValue(pn.bind, ctx, id));
+        else
+            addBinding(node, { prop, ...resolveScoped(pn.bind, repeater, ctx, id) });
+    }
+    if (type === IMAGE && pn.bind && !isPageScope(pn.bind)) {
+        setProp(node, 'src', '');
+        if (pn.alt === DECORATIVE_ALT)
+            setProp(node, 'alt', DECORATIVE_ALT);
+        else
+            addBinding(node, { prop: 'alt', ...altBinding(pn, repeater, ctx, id) });
+    }
+    else if (pn.alt !== undefined) {
+        throw new ComposeError(`${id}: "alt" belongs on a bound Image`);
     }
     // Layout.
     if (pn.lay)
@@ -6855,9 +7290,6 @@ function composeNode(pn, id, repeater, ctx) {
                 throw new ComposeError(`${id}: "$binding" with no section binding`);
             binding = { prop: 'source', source: ctx.section.binding, path: '' };
         }
-        else if (pn.src === PatternDirective.NavPages) {
-            binding = { prop: 'source', source: NAV_PAGES_ALIAS, path: '' };
-        }
         else {
             const scoped = resolveScoped(pn.src, repeater, ctx, id);
             binding = { prop: 'source', source: scoped.source, path: scoped.path === ITEM_VALUE_PATH ? '' : scoped.path };
@@ -6867,29 +7299,21 @@ function composeNode(pn, id, repeater, ctx) {
         rowScope = { itemAlias: lastSegment || binding.source };
     }
     // Children.
-    const children = (pn.c ?? [])
-        .map((child, i) => composeNode(child, `${id}-${i}`, rowScope, ctx))
-        .filter((c) => !!c);
     if (pn.c?.length) {
         if (!node.children)
-            throw new ComposeError(`${id}: ${pn.t} holds no children`);
-        node.children = [...node.children, ...children];
-    }
-    // A Form: its stable id, and both state blocks — never optional (forms plan D7).
-    if (pn.t === FORM) {
-        if (pn.preset)
-            setProp(node, 'formId', `${pn.preset}-${stableHash(`${ctx.owner}/${id}`)}`);
-        node.children = [
-            ...(node.children ?? []),
-            ...FORM_STATE_BLOCKS.map((type, i) => createSerializedNode(`${id}-${(pn.c?.length ?? 0) + i}`, type)),
-        ];
+            throw new ComposeError(`${id}: ${type} holds no children`);
+        node.children = [...node.children, ...composeChildren(pn, id, rowScope, ctx)];
     }
+    if (type === FORM)
+        composeForm(node, pn, id, ctx);
     return node;
 }
 function composePattern(pattern, id, ctx) {
+    if (pattern.node.each)
+        throw new ComposeError(`${id}: a pattern's root cannot be stamped per page`);
     const node = composeNode(pattern.node, id, null, ctx);
     if (!node)
-        throw new ComposeError(`${id}: a pattern's root cannot be optional`);
+        throw new ComposeError(`${id}: a pattern's root cannot be optional or a link`);
     node.label = pattern.label;
     return node;
 }
@@ -6909,12 +7333,6 @@ function composeDataSource(ds) {
         request: { relative: { kind: 'siblings', from: ds.within, subjectFrom: ds.of, pick } },
     };
 }
-function navPagesSource(plan) {
-    return {
-        id: `ds-${NAV_PAGES_ALIAS}`, alias: NAV_PAGES_ALIAS, type: 'static', mode: PlanDataSourceMode.Query,
-        request: { data: plan.pages.filter(p => p.inNav).map(p => ({ name: p.name, route: p.route })) },
-    };
-}
 function expandSeedValue(value, n) {
     if (Array.isArray(value))
         return value.map(v => expandSeedValue(v, n));
@@ -6938,25 +7356,20 @@ function composeItems(type) {
     }
     return items;
 }
-/** True when a composed tree iterates the navigation's pages. */
-function bindsAlias(trees, alias) {
-    let found = false;
-    for (const tree of trees)
-        walkSerialized(tree, node => { if (node.bindings.some(b => b.source === alias))
-            found = true; });
-    return found;
-}
 /**
  * Compose a Site Plan. Throws `SitePlanError` (every issue) when the plan does not validate — the
- * composer never repairs a plan.
+ * composer never repairs a plan. `context` carries what the composer may not read for itself (the year).
  */
-function composeSite(plan) {
+function composeSite(plan, context) {
     assertValidSitePlan(plan);
+    if (!Number.isInteger(context?.year))
+        throw new ComposeError('composeSite needs the year (ComposeContext.year) — the composer reads no clock');
     const placeholders = [];
     const issues = [];
     const routes = new Set(plan.pages.map(p => p.route));
     const relatives = new Map(plan.dataSources.map(d => [d.alias, d.type === PlanDataSourceType.Relative ? { type: d.type, of: d.of, op: d.op } : { type: d.type }]));
-    const base = { plan, placeholders, issues, routes };
+    const email = nonEmpty(plan.business.facts?.email) ? plan.business.facts.email.trim() : null;
+    const base = { plan, placeholders, issues, routes, year: context.year, email, navPage: null };
     const pages = plan.pages.map(page => {
         const nextAlias = page.routeSource ? nextSourceOf(relatives, page.routeSource) : null;
         const layout = page.sections.map((section, i) => {
@@ -6980,16 +7393,13 @@ function composeSite(plan) {
         node.globalPosition = pattern.global;
         return node;
     });
-    const dataSources = plan.dataSources.map(composeDataSource);
-    if (bindsAlias([...pages.map(p => p.layout), globals], NAV_PAGES_ALIAS))
-        dataSources.push(navPagesSource(plan));
     return {
         source: clone(plan.source),
         business: clone(plan.business),
         design: resolveDesignChoices(clone(plan.design)),
         schemas: clone(plan.contentTypes),
         items: Object.fromEntries(plan.contentTypes.map(t => [t.name, composeItems(t)])),
-        dataSources,
+        dataSources: plan.dataSources.map(composeDataSource),
         pages,
         globals,
         routes: plan.pages.map(p => ({ key: p.key, path: p.route, isHome: p.isHome === true })),
@@ -7014,5 +7424,5 @@ function composeSite(plan) {
  * Generated bundle index. Do not edit.
  */
 
-export { BindScope, ComposeError, ComposeIssueCode, FACT_KEYS, GlobalSlot, NAV_PAGES_ALIAS, NODE_BASELINES, PatternDirective, PatternGlobalPosition, PatternPlaceholder, PlaceholderKind, PlanDataSourceMode, PlanDataSourceType, RelativeOp, SAMPLE_IMAGE_REF, SITE_FACT_LABELS, SITE_PATTERNS, SITE_PLAN_VERSION, SITE_TEMPLATES, SPEC_SITE_FACTS, SPEC_SITE_PATTERNS, SPEC_SITE_PLAN_SHAPE, SPEC_SITE_TEMPLATES, STUDIO_TEMPLATE, SitePlanError, SitePlanIssueCode, SitePlanSourceKind, SiteTemplateError, SiteTemplateId, assertStyleSlots, assertValidSitePlan, baseRelativeHref, composeSite, createSerializedNode, nextSourceOf, parseSampleImageRef, patternById, patternNeedsBinding, patternNodes, patternOptionalParts, patternScopes, patternSlots, planFromTemplate, routeParams, sampleImageRef, setStyleProps, validateSitePlan, walkSerialized };
+export { BASELINE_ROLES, BaselineRole, BindScope, ComposeError, ComposeIssueCode, DANGLING_LINK_CODES, FACT_KEYS, GlobalSlot, NEUTRAL_STYLE_PROPS, NODE_BASELINES, PatternDirective, PatternGlobalPosition, PatternPlaceholder, PlaceholderKind, PlanDataSourceMode, PlanDataSourceType, RelativeOp, SAMPLE_IMAGE_REF, SITE_FACT_LABELS, SITE_PATTERNS, SITE_PLAN_VERSION, SITE_TEMPLATES, SPEC_SITE_FACTS, SPEC_SITE_PATTERNS, SPEC_SITE_PLAN_SHAPE, SPEC_SITE_TEMPLATES, STUDIO_TEMPLATE, SitePlanError, SitePlanIssueCode, SitePlanSourceKind, SiteTemplateError, SiteTemplateId, altSourceScopes, assertStyleSlots, assertValidSitePlan, composeSite, createSerializedNode, nextSourceOf, parseSampleImageRef, patternById, patternNeedsBinding, patternNodes, patternOptionalParts, patternScopes, patternSlots, planFromTemplate, releasedLayoutDefaults, requiredShapeKeys, routeParams, sampleImageRef, setStyleProps, shapeKeys, validateSitePlan, walkSerialized };
 //# sourceMappingURL=vectoriox-iox-ui-generation-core.mjs.map