@vectoriox/iox-ui 5.26.0 → 5.28.0

package/generation-core/index.d.ts

@@ -0,0 +1,1397 @@
+import { DesignChoices } from '@vectoriox/iox-ui/design-core';
+
+declare const SPEC_SITE_PLAN_SHAPE: {
+    readonly version: "1";
+    readonly source: "{ kind: 'template', templateId, templateVersion } | { kind: 'ai', runId }";
+    readonly business: "{ name (required), tagline?, facts: { email?, phone?, city? } }";
+    readonly design: "{ flavorId, seed, pairId, shape, density, motion, pillButtons, mode }  — the DesignChoices of the design system";
+    readonly contentTypes: "ContentTypePlan[] — { name, label, fields[], seed }";
+    readonly dataSources: "DataSourcePlan[] — merged by alias into the org library";
+    readonly pages: "PagePlan[] — { key, name, route, isHome?, template?, routeSource?, sections: { pattern, slots?, binding?, without? }[] }";
+    readonly globals: "{ header: patternId, footer: patternId }";
+};
+declare const SPEC_SITE_FACTS: {
+    readonly email: "Email address";
+    readonly phone: "Phone number";
+    readonly city: "City or area";
+};
+declare const SPEC_SITE_PATTERNS: {
+    readonly "nav.inline-cta": {
+        readonly family: "nav";
+        readonly label: "Navigation bar";
+        readonly global: "before";
+        readonly node: {
+            readonly t: "Container";
+            readonly es: "nav";
+            readonly tag: "nav";
+            readonly lay: {
+                readonly display: "flex";
+                readonly justifyContent: "space-between";
+                readonly alignItems: "center";
+                readonly gap: "var(--iox-space-gap)";
+            };
+            readonly c: readonly [{
+                readonly t: "LinkedContainer";
+                readonly es: "box";
+                readonly href: "/";
+                readonly c: readonly [{
+                    readonly t: "Heading";
+                    readonly es: "h3";
+                    readonly level: "h3";
+                    readonly slot: "brand";
+                    readonly fromBusiness: "name";
+                }];
+            }, {
+                readonly t: "Container";
+                readonly es: "box";
+                readonly lay: {
+                    readonly display: "flex";
+                    readonly flexWrap: "wrap";
+                    readonly gap: "28px";
+                    readonly alignItems: "center";
+                };
+                readonly c: readonly [{
+                    readonly t: "Repeater";
+                    readonly src: "$navPages";
+                    readonly c: readonly [{
+                        readonly t: "Link";
+                        readonly es: "link";
+                        readonly bind: "page.name";
+                        readonly href: "$page.route";
+                    }];
+                }, {
+                    readonly t: "ButtonBlock";
+                    readonly es: "button-primary";
+                    readonly href: "/contact";
+                    readonly slot: "cta";
+                    readonly text: "Get in touch";
+                }];
+            }];
+        };
+    };
+    readonly "footer.columns": {
+        readonly family: "footer";
+        readonly label: "Footer, three columns";
+        readonly global: "after";
+        readonly node: {
+            readonly t: "Section";
+            readonly es: "section";
+            readonly scheme: "inverse";
+            readonly c: readonly [{
+                readonly t: "Container";
+                readonly es: "box";
+                readonly lay: {
+                    readonly display: "grid";
+                    readonly gridTemplateColumns: "2fr 1fr 1fr";
+                    readonly gap: "var(--iox-space-gap)";
+                };
+                readonly resp: {
+                    readonly mobile: {
+                        readonly gridTemplateColumns: "minmax(0, 1fr)";
+                    };
+                };
+                readonly c: readonly [{
+                    readonly t: "Container";
+                    readonly es: "box";
+                    readonly lay: {
+                        readonly display: "flex";
+                        readonly flexDirection: "column";
+                        readonly gap: "8px";
+                    };
+                    readonly c: readonly [{
+                        readonly t: "Heading";
+                        readonly es: "h3";
+                        readonly level: "h3";
+                        readonly slot: "brand";
+                        readonly fromBusiness: "name";
+                    }, {
+                        readonly t: "Text";
+                        readonly es: "small";
+                        readonly slot: "tagline";
+                        readonly fromBusiness: "tagline";
+                        readonly ph: "copy";
+                    }];
+                }, {
+                    readonly t: "Container";
+                    readonly es: "box";
+                    readonly lay: {
+                        readonly display: "flex";
+                        readonly flexDirection: "column";
+                        readonly gap: "8px";
+                    };
+                    readonly c: readonly [{
+                        readonly t: "Heading";
+                        readonly es: "eyebrow";
+                        readonly level: "h4";
+                        readonly text: "Pages";
+                    }, {
+                        readonly t: "Repeater";
+                        readonly src: "$navPages";
+                        readonly c: readonly [{
+                            readonly t: "Link";
+                            readonly es: "link";
+                            readonly bind: "page.name";
+                            readonly href: "$page.route";
+                        }];
+                    }];
+                }, {
+                    readonly t: "Container";
+                    readonly es: "box";
+                    readonly lay: {
+                        readonly display: "flex";
+                        readonly flexDirection: "column";
+                        readonly gap: "8px";
+                    };
+                    readonly c: readonly [{
+                        readonly t: "Heading";
+                        readonly es: "eyebrow";
+                        readonly level: "h4";
+                        readonly text: "Contact";
+                    }, {
+                        readonly t: "Text";
+                        readonly es: "small";
+                        readonly ph: "email";
+                    }, {
+                        readonly t: "Text";
+                        readonly es: "small";
+                        readonly ph: "phone";
+                    }, {
+                        readonly t: "Text";
+                        readonly es: "small";
+                        readonly ph: "city";
+                    }];
+                }];
+            }, {
+                readonly t: "Divider";
+                readonly es: "rule";
+            }, {
+                readonly t: "Text";
+                readonly es: "small";
+                readonly slot: "copyright";
+                readonly fromBusiness: "copyright";
+            }];
+            readonly lay: {
+                readonly display: "flex";
+                readonly flexDirection: "column";
+                readonly gap: "32px";
+            };
+        };
+    };
+    readonly "hero.split": {
+        readonly family: "hero";
+        readonly label: "Hero — text beside an image";
+        readonly node: {
+            readonly t: "Section";
+            readonly es: "section";
+            readonly c: readonly [{
+                readonly t: "Container";
+                readonly es: "box";
+                readonly lay: {
+                    readonly display: "grid";
+                    readonly gridTemplateColumns: "1.1fr 0.9fr";
+                    readonly gap: "48px";
+                    readonly alignItems: "center";
+                };
+                readonly resp: {
+                    readonly mobile: {
+                        readonly gridTemplateColumns: "minmax(0, 1fr)";
+                    };
+                };
+                readonly c: readonly [{
+                    readonly t: "Container";
+                    readonly es: "box";
+                    readonly lay: {
+                        readonly display: "flex";
+                        readonly flexDirection: "column";
+                        readonly gap: "22px";
+                    };
+                    readonly c: readonly [{
+                        readonly t: "Heading";
+                        readonly es: "eyebrow";
+                        readonly level: "h4";
+                        readonly slot: "eyebrow";
+                        readonly ph: "copy";
+                        readonly text: "What you do · where";
+                    }, {
+                        readonly t: "Heading";
+                        readonly es: "display";
+                        readonly level: "h1";
+                        readonly slot: "headline";
+                        readonly fromBusiness: "name";
+                    }, {
+                        readonly t: "Text";
+                        readonly es: "lead";
+                        readonly slot: "lead";
+                        readonly fromBusiness: "tagline";
+                        readonly ph: "copy";
+                    }, {
+                        readonly t: "Container";
+                        readonly es: "box";
+                        readonly lay: {
+                            readonly display: "flex";
+                            readonly flexWrap: "wrap";
+                            readonly gap: "12px";
+                            readonly alignItems: "center";
+                        };
+                        readonly c: readonly [{
+                            readonly t: "ButtonBlock";
+                            readonly es: "button-primary";
+                            readonly href: "/work";
+                            readonly text: "See our work";
+                        }, {
+                            readonly t: "ButtonBlock";
+                            readonly es: "button-secondary";
+                            readonly href: "/contact";
+                            readonly text: "Get in touch";
+                        }];
+                    }];
+                }, {
+                    readonly t: "Image";
+                    readonly es: "media";
+                    readonly ph: "image";
+                    readonly aspect: "4 / 5";
+                }];
+            }];
+        };
+    };
+    readonly "projects.grid": {
+        readonly family: "collection";
+        readonly label: "Project cards, three across";
+        readonly node: {
+            readonly t: "Section";
+            readonly es: "section";
+            readonly c: readonly [{
+                readonly t: "Container";
+                readonly es: "box";
+                readonly optional: "header";
+                readonly lay: {
+                    readonly display: "flex";
+                    readonly justifyContent: "space-between";
+                    readonly alignItems: "baseline";
+                    readonly gap: "16px";
+                    readonly flexWrap: "wrap";
+                };
+                readonly c: readonly [{
+                    readonly t: "Heading";
+                    readonly es: "h2";
+                    readonly level: "h2";
+                    readonly slot: "title";
+                    readonly text: "Selected work";
+                }, {
+                    readonly t: "Link";
+                    readonly es: "link";
+                    readonly href: "/work";
+                    readonly text: "All projects";
+                }];
+            }, {
+                readonly t: "Repeater";
+                readonly src: "$binding";
+                readonly lay: {
+                    readonly display: "grid";
+                    readonly gridTemplateColumns: "repeat(3, minmax(0, 1fr))";
+                    readonly gap: "var(--iox-space-gap)";
+                };
+                readonly resp: {
+                    readonly mobile: {
+                        readonly gridTemplateColumns: "minmax(0, 1fr)";
+                    };
+                };
+                readonly c: readonly [{
+                    readonly t: "LinkedContainer";
+                    readonly es: "card";
+                    readonly href: "/work/:slug";
+                    readonly param: "item.slug";
+                    readonly lay: {
+                        readonly display: "flex";
+                        readonly flexDirection: "column";
+                        readonly gap: "12px";
+                    };
+                    readonly c: readonly [{
+                        readonly t: "Image";
+                        readonly es: "media";
+                        readonly bind: "item.cover";
+                        readonly aspect: "4 / 3";
+                    }, {
+                        readonly t: "Heading";
+                        readonly es: "h3";
+                        readonly level: "h3";
+                        readonly bind: "item.title";
+                    }, {
+                        readonly t: "Text";
+                        readonly es: "small";
+                        readonly bind: "item.summary";
+                    }];
+                }];
+            }];
+            readonly lay: {
+                readonly display: "flex";
+                readonly flexDirection: "column";
+                readonly gap: "32px";
+            };
+        };
+    };
+    readonly "services.three": {
+        readonly family: "features";
+        readonly label: "Three services";
+        readonly node: {
+            readonly t: "Section";
+            readonly es: "section";
+            readonly scheme: "subtle";
+            readonly c: readonly [{
+                readonly t: "Heading";
+                readonly es: "h2";
+                readonly level: "h2";
+                readonly slot: "title";
+                readonly text: "What we do";
+            }, {
+                readonly t: "Container";
+                readonly es: "box";
+                readonly lay: {
+                    readonly display: "grid";
+                    readonly gridTemplateColumns: "repeat(3, minmax(0, 1fr))";
+                    readonly gap: "var(--iox-space-gap)";
+                };
+                readonly resp: {
+                    readonly mobile: {
+                        readonly gridTemplateColumns: "minmax(0, 1fr)";
+                    };
+                };
+                readonly c: readonly [{
+                    readonly t: "Container";
+                    readonly es: "card";
+                    readonly lay: {
+                        readonly display: "flex";
+                        readonly flexDirection: "column";
+                        readonly gap: "10px";
+                    };
+                    readonly c: readonly [{
+                        readonly t: "Heading";
+                        readonly es: "h3";
+                        readonly level: "h3";
+                        readonly ph: "copy";
+                        readonly text: "Name a service";
+                    }, {
+                        readonly t: "Text";
+                        readonly es: "body";
+                        readonly ph: "copy";
+                        readonly text: "Describe it in two sentences.";
+                    }];
+                }, {
+                    readonly t: "Container";
+                    readonly es: "card";
+                    readonly lay: {
+                        readonly display: "flex";
+                        readonly flexDirection: "column";
+                        readonly gap: "10px";
+                    };
+                    readonly c: readonly [{
+                        readonly t: "Heading";
+                        readonly es: "h3";
+                        readonly level: "h3";
+                        readonly ph: "copy";
+                        readonly text: "Name a service";
+                    }, {
+                        readonly t: "Text";
+                        readonly es: "body";
+                        readonly ph: "copy";
+                        readonly text: "Describe it in two sentences.";
+                    }];
+                }, {
+                    readonly t: "Container";
+                    readonly es: "card";
+                    readonly lay: {
+                        readonly display: "flex";
+                        readonly flexDirection: "column";
+                        readonly gap: "10px";
+                    };
+                    readonly c: readonly [{
+                        readonly t: "Heading";
+                        readonly es: "h3";
+                        readonly level: "h3";
+                        readonly ph: "copy";
+                        readonly text: "Name a service";
+                    }, {
+                        readonly t: "Text";
+                        readonly es: "body";
+                        readonly ph: "copy";
+                        readonly text: "Describe it in two sentences.";
+                    }];
+                }];
+            }];
+            readonly lay: {
+                readonly display: "flex";
+                readonly flexDirection: "column";
+                readonly gap: "32px";
+            };
+        };
+    };
+    readonly "cta.band": {
+        readonly family: "cta";
+        readonly label: "Call to action band";
+        readonly node: {
+            readonly t: "Section";
+            readonly es: "section";
+            readonly scheme: "inverse";
+            readonly c: readonly [{
+                readonly t: "Container";
+                readonly es: "box";
+                readonly lay: {
+                    readonly display: "grid";
+                    readonly gridTemplateColumns: "1fr auto";
+                    readonly gap: "32px";
+                    readonly alignItems: "center";
+                };
+                readonly resp: {
+                    readonly mobile: {
+                        readonly gridTemplateColumns: "minmax(0, 1fr)";
+                    };
+                };
+                readonly c: readonly [{
+                    readonly t: "Container";
+                    readonly es: "box";
+                    readonly lay: {
+                        readonly display: "flex";
+                        readonly flexDirection: "column";
+                        readonly gap: "12px";
+                    };
+                    readonly c: readonly [{
+                        readonly t: "Heading";
+                        readonly es: "eyebrow";
+                        readonly level: "h4";
+                        readonly text: "Start a project";
+                    }, {
+                        readonly t: "Heading";
+                        readonly es: "h2";
+                        readonly level: "h2";
+                        readonly slot: "title";
+                        readonly text: "Tell us about your project.";
+                    }];
+                }, {
+                    readonly t: "ButtonBlock";
+                    readonly es: "button-primary";
+                    readonly href: "/contact";
+                    readonly text: "Get in touch";
+                }];
+            }];
+        };
+    };
+    readonly "page-header.simple": {
+        readonly family: "header";
+        readonly label: "Page header";
+        readonly node: {
+            readonly t: "Section";
+            readonly es: "section";
+            readonly c: readonly [{
+                readonly t: "Container";
+                readonly es: "box";
+                readonly lay: {
+                    readonly display: "flex";
+                    readonly flexDirection: "column";
+                    readonly gap: "14px";
+                    readonly maxWidth: "760px";
+                };
+                readonly c: readonly [{
+                    readonly t: "Heading";
+                    readonly es: "eyebrow";
+                    readonly level: "h4";
+                    readonly slot: "eyebrow";
+                }, {
+                    readonly t: "Heading";
+                    readonly es: "h1";
+                    readonly level: "h1";
+                    readonly slot: "title";
+                }, {
+                    readonly t: "Text";
+                    readonly es: "lead";
+                    readonly slot: "lead";
+                    readonly ph: "copy";
+                    readonly text: "One or two sentences that introduce this page.";
+                }];
+            }];
+        };
+    };
+    readonly "project.hero": {
+        readonly family: "detail";
+        readonly label: "Project hero (bound to the route item)";
+        readonly node: {
+            readonly t: "Section";
+            readonly es: "section";
+            readonly c: readonly [{
+                readonly t: "Container";
+                readonly es: "box";
+                readonly lay: {
+                    readonly display: "flex";
+                    readonly flexDirection: "column";
+                    readonly gap: "16px";
+                    readonly maxWidth: "860px";
+                };
+                readonly c: readonly [{
+                    readonly t: "Heading";
+                    readonly es: "eyebrow";
+                    readonly level: "h4";
+                    readonly bind: "route.location";
+                }, {
+                    readonly t: "Heading";
+                    readonly es: "h1";
+                    readonly level: "h1";
+                    readonly bind: "route.title";
+                }, {
+                    readonly t: "Text";
+                    readonly es: "lead";
+                    readonly bind: "route.summary";
+                }, {
+                    readonly t: "Text";
+                    readonly es: "small";
+                    readonly bind: "route.year";
+                }];
+            }, {
+                readonly t: "Image";
+                readonly es: "media";
+                readonly bind: "route.cover";
+                readonly aspect: "16 / 9";
+            }];
+            readonly lay: {
+                readonly display: "flex";
+                readonly flexDirection: "column";
+                readonly gap: "32px";
+            };
+        };
+    };
+    readonly "project.gallery": {
+        readonly family: "media";
+        readonly label: "Project gallery (the item's images)";
+        readonly node: {
+            readonly t: "Section";
+            readonly es: "section";
+            readonly c: readonly [{
+                readonly t: "Repeater";
+                readonly src: "route.gallery";
+                readonly lay: {
+                    readonly display: "grid";
+                    readonly gridTemplateColumns: "repeat(2, minmax(0, 1fr))";
+                    readonly gap: "var(--iox-space-gap)";
+                };
+                readonly resp: {
+                    readonly mobile: {
+                        readonly gridTemplateColumns: "minmax(0, 1fr)";
+                    };
+                };
+                readonly c: readonly [{
+                    readonly t: "Image";
+                    readonly es: "media";
+                    readonly bind: "item";
+                    readonly aspect: "4 / 3";
+                }];
+            }];
+        };
+    };
+    readonly "project.next": {
+        readonly family: "detail";
+        readonly label: "Next project";
+        readonly node: {
+            readonly t: "Section";
+            readonly es: "section";
+            readonly c: readonly [{
+                readonly t: "Divider";
+                readonly es: "rule";
+            }, {
+                readonly t: "LinkedContainer";
+                readonly es: "box";
+                readonly href: "/work/:slug";
+                readonly param: "next.slug";
+                readonly lay: {
+                    readonly display: "flex";
+                    readonly flexDirection: "column";
+                    readonly gap: "6px";
+                    readonly padding: "24px 0px 0px 0px";
+                };
+                readonly c: readonly [{
+                    readonly t: "Text";
+                    readonly es: "small";
+                    readonly text: "Next project";
+                }, {
+                    readonly t: "Heading";
+                    readonly es: "h2";
+                    readonly level: "h2";
+                    readonly bind: "next.title";
+                }];
+            }];
+            readonly lay: {
+                readonly display: "flex";
+                readonly flexDirection: "column";
+                readonly gap: "32px";
+            };
+        };
+    };
+    readonly "about.story": {
+        readonly family: "content";
+        readonly label: "Story beside an image";
+        readonly node: {
+            readonly t: "Section";
+            readonly es: "section";
+            readonly c: readonly [{
+                readonly t: "Container";
+                readonly es: "box";
+                readonly lay: {
+                    readonly display: "grid";
+                    readonly gridTemplateColumns: "1fr 1fr";
+                    readonly gap: "48px";
+                    readonly alignItems: "start";
+                };
+                readonly resp: {
+                    readonly mobile: {
+                        readonly gridTemplateColumns: "minmax(0, 1fr)";
+                    };
+                };
+                readonly c: readonly [{
+                    readonly t: "Container";
+                    readonly es: "box";
+                    readonly lay: {
+                        readonly display: "flex";
+                        readonly flexDirection: "column";
+                        readonly gap: "16px";
+                    };
+                    readonly c: readonly [{
+                        readonly t: "Heading";
+                        readonly es: "h2";
+                        readonly level: "h2";
+                        readonly ph: "copy";
+                        readonly text: "How the studio started";
+                    }, {
+                        readonly t: "Text";
+                        readonly es: "body";
+                        readonly ph: "copy";
+                        readonly text: "Tell your story in your own words: who you are, how you work, what you care about.";
+                    }];
+                }, {
+                    readonly t: "Image";
+                    readonly es: "media";
+                    readonly ph: "image";
+                    readonly aspect: "4 / 3";
+                }];
+            }];
+        };
+    };
+    readonly "contact.split": {
+        readonly family: "contact";
+        readonly label: "Contact details beside a form";
+        readonly node: {
+            readonly t: "Section";
+            readonly es: "section";
+            readonly c: readonly [{
+                readonly t: "Container";
+                readonly es: "box";
+                readonly lay: {
+                    readonly display: "grid";
+                    readonly gridTemplateColumns: "0.9fr 1.1fr";
+                    readonly gap: "48px";
+                    readonly alignItems: "start";
+                };
+                readonly resp: {
+                    readonly mobile: {
+                        readonly gridTemplateColumns: "minmax(0, 1fr)";
+                    };
+                };
+                readonly c: readonly [{
+                    readonly t: "Container";
+                    readonly es: "box";
+                    readonly lay: {
+                        readonly display: "flex";
+                        readonly flexDirection: "column";
+                        readonly gap: "16px";
+                    };
+                    readonly c: readonly [{
+                        readonly t: "Heading";
+                        readonly es: "h1";
+                        readonly level: "h1";
+                        readonly text: "Get in touch";
+                    }, {
+                        readonly t: "Text";
+                        readonly es: "lead";
+                        readonly ph: "copy";
+                        readonly text: "Say how and when people can expect to hear back.";
+                    }, {
+                        readonly t: "Text";
+                        readonly es: "body";
+                        readonly ph: "email";
+                    }, {
+                        readonly t: "Text";
+                        readonly es: "body";
+                        readonly ph: "phone";
+                    }, {
+                        readonly t: "Text";
+                        readonly es: "body";
+                        readonly ph: "city";
+                    }];
+                }, {
+                    readonly t: "Container";
+                    readonly es: "card";
+                    readonly c: readonly [{
+                        readonly t: "Form";
+                        readonly preset: "contact";
+                        readonly c: readonly [{
+                            readonly t: "Field";
+                            readonly control: "text";
+                            readonly label: "Name";
+                            readonly required: true;
+                        }, {
+                            readonly t: "Field";
+                            readonly control: "email";
+                            readonly label: "Email";
+                            readonly required: true;
+                        }, {
+                            readonly t: "Field";
+                            readonly control: "textarea";
+                            readonly label: "Message";
+                            readonly required: true;
+                        }, {
+                            readonly t: "SubmitButton";
+                            readonly es: "button-primary";
+                            readonly text: "Send";
+                        }];
+                    }];
+                }];
+            }];
+        };
+    };
+};
+declare const SPEC_SITE_TEMPLATES: {
+    readonly studio: {
+        readonly id: "studio";
+        readonly version: 1;
+        readonly label: "Studio";
+        readonly blurb: "A portfolio for a studio or service business: your work, what you do, and a way to reach you.";
+        readonly bestFor: readonly ["Architecture & interiors", "Design studios", "Photographers", "Agencies", "Consultants"];
+        readonly contentTypes: readonly [{
+            readonly name: "projects";
+            readonly label: "Projects";
+            readonly previewTextField: "title";
+            readonly previewImageField: "cover";
+            readonly fields: readonly [{
+                readonly name: "title";
+                readonly type: "string";
+                readonly controller: "text";
+                readonly required: true;
+            }, {
+                readonly name: "slug";
+                readonly type: "string";
+                readonly controller: "text";
+                readonly required: true;
+                readonly note: "derived from title at seed; no slug controller exists yet (gap)";
+            }, {
+                readonly name: "summary";
+                readonly type: "string";
+                readonly controller: "textarea";
+            }, {
+                readonly name: "cover";
+                readonly type: "string";
+                readonly controller: "image";
+            }, {
+                readonly name: "gallery";
+                readonly type: "array";
+                readonly controller: "mediaList";
+            }, {
+                readonly name: "year";
+                readonly type: "string";
+                readonly controller: "text";
+            }, {
+                readonly name: "location";
+                readonly type: "string";
+                readonly controller: "text";
+            }];
+            readonly seed: {
+                readonly count: 6;
+                readonly sample: true;
+                readonly isPublished: true;
+                readonly title: "Sample project {n}";
+                readonly slug: "sample-project-{n}";
+                readonly summary: "Replace this with a sentence about the project.";
+                readonly cover: "{sampleImage:n}";
+                readonly gallery: readonly ["{sampleImage:n+1}", "{sampleImage:n+2}"];
+                readonly year: "";
+                readonly location: "";
+            };
+        }];
+        readonly dataSources: readonly [{
+            readonly alias: "projects";
+            readonly type: "cms";
+            readonly mode: "query";
+            readonly contentType: "projects";
+        }, {
+            readonly alias: "projectsLatest";
+            readonly type: "cms";
+            readonly mode: "query";
+            readonly contentType: "projects";
+            readonly limit: 3;
+        }, {
+            readonly alias: "project";
+            readonly type: "cms";
+            readonly mode: "single";
+            readonly contentType: "projects";
+            readonly filterByRouteParam: {
+                readonly field: "slug";
+                readonly routeParam: "slug";
+            };
+        }, {
+            readonly alias: "projectNext";
+            readonly type: "relative";
+            readonly of: "project";
+            readonly op: "$siblings.next";
+            readonly within: "projects";
+        }];
+        readonly pages: readonly [{
+            readonly key: "home";
+            readonly name: "Home";
+            readonly route: "/";
+            readonly isHome: true;
+            readonly required: true;
+            readonly inNav: false;
+            readonly sections: readonly [{
+                readonly pattern: "hero.split";
+            }, {
+                readonly pattern: "projects.grid";
+                readonly binding: "projectsLatest";
+            }, {
+                readonly pattern: "services.three";
+            }, {
+                readonly pattern: "cta.band";
+            }];
+        }, {
+            readonly key: "work";
+            readonly name: "Work";
+            readonly route: "/work";
+            readonly required: true;
+            readonly inNav: true;
+            readonly sections: readonly [{
+                readonly pattern: "page-header.simple";
+                readonly slots: {
+                    readonly eyebrow: "Portfolio";
+                    readonly title: "Work";
+                };
+            }, {
+                readonly pattern: "projects.grid";
+                readonly binding: "projects";
+                readonly without: readonly ["header"];
+            }];
+        }, {
+            readonly key: "project";
+            readonly name: "Project";
+            readonly route: "/work/:slug";
+            readonly required: true;
+            readonly inNav: false;
+            readonly template: "projects";
+            readonly routeSource: "project";
+            readonly sections: readonly [{
+                readonly pattern: "project.hero";
+            }, {
+                readonly pattern: "project.gallery";
+            }, {
+                readonly pattern: "project.next";
+            }, {
+                readonly pattern: "cta.band";
+            }];
+        }, {
+            readonly key: "about";
+            readonly name: "About";
+            readonly route: "/about";
+            readonly required: false;
+            readonly inNav: true;
+            readonly sections: readonly [{
+                readonly pattern: "page-header.simple";
+                readonly slots: {
+                    readonly eyebrow: "About";
+                    readonly title: "About the studio";
+                };
+            }, {
+                readonly pattern: "about.story";
+            }, {
+                readonly pattern: "cta.band";
+            }];
+        }, {
+            readonly key: "contact";
+            readonly name: "Contact";
+            readonly route: "/contact";
+            readonly required: false;
+            readonly inNav: true;
+            readonly sections: readonly [{
+                readonly pattern: "contact.split";
+            }];
+        }];
+        readonly globals: {
+            readonly header: "nav.inline-cta";
+            readonly footer: "footer.columns";
+        };
+    };
+};
+
+/** What an untouched node of one registered type saves as (`NODE_BASELINES`, generated from the live
+ *  iox-builder configs) — the builder serializer's flat `props` / `styleProps`, the trait names it has a
+ *  slot for, and whether it holds children. */
+interface NodeBaseline {
+    readonly props: Readonly<Record<string, unknown>>;
+    readonly styleProps: Readonly<Record<string, unknown>>;
+    readonly traits: ReadonlyArray<string>;
+    readonly styleTraits: ReadonlyArray<string>;
+    readonly container: boolean;
+}
+
+declare const NODE_BASELINES: Readonly<Record<string, NodeBaseline>>;
+
+/**
+ * The Site Plan (contract `site.planShape`) — 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.
+ */
+declare const SITE_PLAN_VERSION = "1";
+declare enum SitePlanSourceKind {
+    Template = "template",
+    Ai = "ai"
+}
+type SitePlanSource = {
+    kind: `${SitePlanSourceKind.Template}`;
+    templateId: string;
+    templateVersion: number;
+} | {
+    kind: `${SitePlanSourceKind.Ai}`;
+    runId: string;
+};
+/** A fact a customer could be held to. Only ever the customer's own words; blank → a placeholder. */
+type FactKey = keyof typeof SPEC_SITE_FACTS;
+declare const FACT_KEYS: ReadonlyArray<FactKey>;
+/** The label a missing fact shows, verbatim from the contract. */
+declare const SITE_FACT_LABELS: Readonly<Record<FactKey, string>>;
+interface SiteBusiness {
+    readonly name: string;
+    readonly tagline?: string;
+    readonly facts?: Readonly<Partial<Record<FactKey, string>>>;
+}
+interface ContentFieldPlan {
+    readonly name: string;
+    readonly type: string;
+    readonly controller: string;
+    readonly required?: boolean;
+    readonly note?: string;
+}
+/** How the content type's sample items are seeded. String values are templates: `{n}` is the item's
+ *  1-based number, `{sampleImage:n}` / `{sampleImage:n+k}` a bundled sample image (resolved by the build). */
+interface ContentSeedPlan {
+    readonly count: number;
+    readonly sample: boolean;
+    readonly isPublished: boolean;
+    readonly [field: string]: unknown;
+}
+interface ContentTypePlan {
+    readonly name: string;
+    readonly label: string;
+    readonly previewTextField?: string;
+    readonly previewImageField?: string;
+    readonly fields: ReadonlyArray<ContentFieldPlan>;
+    readonly seed?: ContentSeedPlan;
+}
+declare enum PlanDataSourceType {
+    Cms = "cms",
+    Relative = "relative"
+}
+declare enum PlanDataSourceMode {
+    Query = "query",
+    Single = "single"
+}
+/** The relative operations a plan may name, and the shipped `RelativeSourceSpec` each one is. */
+declare enum RelativeOp {
+    SiblingsNext = "$siblings.next",
+    SiblingsPrev = "$siblings.prev"
+}
+interface CmsDataSourcePlan {
+    readonly alias: string;
+    readonly type: `${PlanDataSourceType.Cms}`;
+    readonly mode: `${PlanDataSourceMode}`;
+    readonly contentType: string;
+    readonly limit?: number;
+    readonly filterByRouteParam?: {
+        readonly field: string;
+        readonly routeParam: string;
+    };
+}
+interface RelativeDataSourcePlan {
+    readonly alias: string;
+    readonly type: `${PlanDataSourceType.Relative}`;
+    /** The subject: the alias of the current item. */
+    readonly of: string;
+    readonly op: `${RelativeOp}`;
+    /** The collection the subject is located within. */
+    readonly within: string;
+}
+type DataSourcePlan = CmsDataSourcePlan | RelativeDataSourcePlan;
+interface PageSectionPlan {
+    readonly pattern: string;
+    readonly slots?: Readonly<Record<string, string>>;
+    /** The list source alias a pattern's `$binding` repeater iterates. */
+    readonly binding?: string;
+    /** Optional pattern parts (`optional: <id>`) to leave out. */
+    readonly without?: ReadonlyArray<string>;
+}
+interface PagePlan {
+    readonly key: string;
+    readonly name: string;
+    readonly route: string;
+    readonly isHome?: boolean;
+    /** Carried by templates (the wizard's Pages step); not part of the documented plan shape. */
+    readonly required?: boolean;
+    /** In the navigation (`$navPages`). Carried by templates; not part of the documented plan shape. */
+    readonly inNav?: boolean;
+    /** A template page: the content type it renders one item of. */
+    readonly template?: string;
+    /** The single source bound to the route item (`route.*`). */
+    readonly routeSource?: string;
+    readonly sections: ReadonlyArray<PageSectionPlan>;
+}
+declare enum GlobalSlot {
+    Header = "header",
+    Footer = "footer"
+}
+interface SitePlan {
+    readonly version: typeof SITE_PLAN_VERSION;
+    readonly source: SitePlanSource;
+    readonly business: SiteBusiness;
+    readonly design: Readonly<DesignChoices>;
+    readonly contentTypes: ReadonlyArray<ContentTypePlan>;
+    readonly dataSources: ReadonlyArray<DataSourcePlan>;
+    readonly pages: ReadonlyArray<PagePlan>;
+    readonly globals: Readonly<Record<`${GlobalSlot}`, string>>;
+}
+
+/**
+ * The pattern library (contract `site.patterns`): structure and element styles only — never a colour,
+ * size or font. Each node is written in the contract's short vocabulary:
+ *
+ * `t` component type · `es` element style · `scheme` section colour scheme · `tag` a Container's html
+ * tag · `level` a Heading's level · `lay` layout-only styleProps · `resp` per-breakpoint styleProps ·
+ * `aspect` an Image's aspect ratio · `slot` author-editable text, filled from the plan's section slots ·
+ * `fromBusiness` text from the plan's business · `text` the pattern's own words · `ph` a publish-blocking
+ * placeholder (a FACT key, `copy` or `image`) · `bind` a binding path on the repeater item (`item.*`,
+ * `page.*`), the route item (`route.*`) or its next sibling (`next.*`) · `src` what a Repeater iterates
+ * (`$binding`, `$navPages`, `route.<array>`) · `href` a page route (`$page.route` = the nav item's) ·
+ * `param` the value of the route's `:param` · `optional` a part a page may leave out (`without`) ·
+ * `preset` a Form preset · `control` / `label` / `required` a Field's · `c` children.
+ */
+interface PatternNode {
+    readonly t: string;
+    readonly es?: string;
+    readonly scheme?: string;
+    readonly tag?: string;
+    readonly level?: string;
+    readonly lay?: Readonly<Record<string, string>>;
+    readonly resp?: Readonly<Record<string, Readonly<Record<string, string>>>>;
+    readonly aspect?: string;
+    readonly slot?: string;
+    readonly fromBusiness?: string;
+    readonly text?: string;
+    readonly ph?: string;
+    readonly bind?: string;
+    readonly src?: string;
+    readonly href?: string;
+    readonly param?: string;
+    readonly optional?: string;
+    readonly preset?: string;
+    readonly control?: string;
+    readonly label?: string;
+    readonly required?: boolean;
+    readonly c?: ReadonlyArray<PatternNode>;
+}
+declare enum PatternGlobalPosition {
+    Before = "before",
+    After = "after"
+}
+interface SitePattern {
+    readonly family: string;
+    readonly label: string;
+    /** Set on a header/footer pattern: it renders on every page, before or after the page. */
+    readonly global?: `${PatternGlobalPosition}`;
+    readonly node: PatternNode;
+}
+declare const SITE_PATTERNS: Readonly<Record<string, SitePattern>>;
+/** The pattern placeholder kinds that are not FACT keys. */
+declare enum PatternPlaceholder {
+    Copy = "copy",
+    Image = "image"
+}
+/** The composer directives a pattern writes where a plan supplies the value. */
+declare enum PatternDirective {
+    /** A Repeater's source: the section's `binding`. */
+    Binding = "$binding",
+    /** A Repeater's source: the plan's pages that are in the navigation. */
+    NavPages = "$navPages",
+    /** A Link's route: the nav item's route. */
+    PageRoute = "$page.route"
+}
+/** The scopes a `bind` / `param` / `src` path starts with. */
+declare enum BindScope {
+    /** The nearest Repeater's row. */
+    Item = "item",
+    /** The nearest Repeater's row, when that Repeater iterates the navigation's pages. */
+    Page = "page",
+    /** The page's route item (`routeSource`). */
+    Route = "route",
+    /** The route item's next sibling (the plan's `$siblings.next` source of the route item). */
+    Next = "next"
+}
+declare function patternById(id: string | null | undefined): SitePattern | undefined;
+/** Every node of a pattern, depth first. */
+declare function patternNodes(pattern: SitePattern): PatternNode[];
+/** The slot names a plan section may fill. */
+declare function patternSlots(pattern: SitePattern): string[];
+/** The optional parts a plan section may leave out. */
+declare function patternOptionalParts(pattern: SitePattern): string[];
+/** True when the pattern has a Repeater iterating the section's `binding`. */
+declare function patternNeedsBinding(pattern: SitePattern): boolean;
+/** The bind scopes a pattern reads (`route`, `next`, …) — what its page must provide. */
+declare function patternScopes(pattern: SitePattern): Set<string>;
+
+/** A site structure the wizard offers (contract `site.templates`). A template is a Site Plan without the
+ *  customer's part — the business and the look — which `planFromTemplate` adds. */
+interface SiteTemplate {
+    readonly id: string;
+    readonly version: number;
+    readonly label: string;
+    readonly blurb: string;
+    readonly bestFor: ReadonlyArray<string>;
+    readonly contentTypes: ReadonlyArray<ContentTypePlan>;
+    readonly dataSources: ReadonlyArray<DataSourcePlan>;
+    readonly pages: ReadonlyArray<PagePlan>;
+    readonly globals: Readonly<Record<`${GlobalSlot}`, string>>;
+}
+declare const SITE_TEMPLATES: Readonly<Record<string, SiteTemplate>>;
+declare enum SiteTemplateId {
+    Studio = "studio"
+}
+declare const STUDIO_TEMPLATE: SiteTemplate;
+interface TemplatePlanInput {
+    business: SiteBusiness;
+    design: DesignChoices;
+    /** Keys of the template's OPTIONAL pages to leave out (the wizard's Pages step). */
+    omitPages?: ReadonlyArray<string>;
+}
+declare class SiteTemplateError extends Error {
+}
+/**
+ * The template as a Site Plan (`source.kind: template`), with the customer's business and look. A
+ * required page cannot be left out, and an unknown key is refused — nothing is guessed.
+ */
+declare function planFromTemplate(template: SiteTemplate, input: TemplatePlanInput): SitePlan;
+
+/**
+ * A node exactly as a saved page layout stores it (the builder serializer's shape): flat `props` and
+ * a FULL `styleProps` (self-describing — render-parity.md, task 10), the element style's pseudo-states,
+ * sparse per-breakpoint overrides and the bindings. What the composer emits; what the builder reloads
+ * and the engine renders, unchanged.
+ */
+interface SerializedBinding {
+    prop: string;
+    source: string;
+    path: string;
+}
+type SerializedResponsive = Partial<Record<string, {
+    styleProps?: Record<string, unknown>;
+}>>;
+interface SerializedNode {
+    id: string;
+    type: string;
+    label?: string;
+    props: Record<string, unknown>;
+    styleProps: Record<string, unknown>;
+    stateStyles?: Partial<Record<string, Record<string, unknown>>>;
+    responsive?: SerializedResponsive;
+    elementStyle?: string;
+    bindings: SerializedBinding[];
+    interactions: unknown[];
+    isGlobal?: boolean;
+    globalPosition?: `${PatternGlobalPosition}`;
+    children?: SerializedNode[];
+}
+/** A pattern the composer cannot stamp as the builder would (an unregistered type, a trait the type has
+ *  no slot for, a style that does not apply). The plan is validated first, so this means the CONTRACT is
+ *  wrong — never something to work around. */
+declare class ComposeError extends Error {
+}
+/**
+ * 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.
+ */
+declare function createSerializedNode(id: string, type: string, props?: Record<string, unknown>, elementStyle?: string | null): SerializedNode;
+/** Refuse a style trait the type has no slot for — the builder would silently drop it. */
+declare function assertStyleSlots(type: string, names: ReadonlyArray<string>): void;
+/** Write style traits onto a node (each one a slot the type has). */
+declare function setStyleProps(node: SerializedNode, values: Readonly<Record<string, unknown>>): void;
+/** Every node of a tree, depth first. */
+declare function walkSerialized(nodes: ReadonlyArray<SerializedNode>, visit: (node: SerializedNode, ancestors: SerializedNode[]) => void, ancestors?: SerializedNode[]): void;
+
+/**
+ * The Site Plan validator — the gate in front of the composer. The wizard's plan and (later) the AI's
+ * plan go through the SAME checks: an unknown pattern, a slot the pattern does not declare, a source
+ * that does not exist, a page whose route item cannot be resolved — all refused, with a path, before a
+ * single page is written. It never repairs: a model gets the issues back and rewrites.
+ */
+declare enum SitePlanIssueCode {
+    /** A value of the wrong type, or a required value missing. */
+    Shape = "shape",
+    /** A key the plan shape does not have. */
+    UnknownKey = "unknown-key",
+    Version = "version",
+    UnknownFlavor = "unknown-flavor",
+    InvalidDesign = "invalid-design",
+    MissingBusinessName = "missing-business-name",
+    UnknownFact = "unknown-fact",
+    Duplicate = "duplicate",
+    ReservedAlias = "reserved-alias",
+    UnknownContentType = "unknown-content-type",
+    UnknownField = "unknown-field",
+    UnknownDataSource = "unknown-data-source",
+    InvalidDataSource = "invalid-data-source",
+    InvalidRoute = "invalid-route",
+    Home = "home",
+    RouteSource = "route-source",
+    UnknownPattern = "unknown-pattern",
+    GlobalPattern = "global-pattern",
+    UnknownSlot = "unknown-slot",
+    UnknownOptionalPart = "unknown-optional-part",
+    Binding = "binding",
+    MissingScope = "missing-scope"
+}
+interface SitePlanIssue {
+    code: SitePlanIssueCode;
+    /** Where, as a dotted path into the plan (`pages[2].sections[0].binding`). */
+    path: string;
+    message: string;
+}
+interface SitePlanValidation {
+    valid: boolean;
+    issues: SitePlanIssue[];
+}
+declare class SitePlanError extends Error {
+    readonly issues: ReadonlyArray<SitePlanIssue>;
+    constructor(issues: ReadonlyArray<SitePlanIssue>);
+}
+/** The alias of the static source the composer writes for the navigation (`$navPages`). A plan source
+ *  may not take it. */
+declare const NAV_PAGES_ALIAS = "navPages";
+/** The `:param` names of a route, in order. */
+declare function routeParams(route: string): string[];
+/** The plan's `$siblings.next` source of `routeSource` — what a pattern's `next.*` reads. */
+declare function nextSourceOf(sources: Map<string, {
+    type: string;
+    of?: string;
+    op?: string;
+}>, routeSource: string): string | null;
+/** Check a Site Plan against the plan shape and the pattern library. Never throws, never repairs. */
+declare function validateSitePlan(plan: unknown): SitePlanValidation;
+/** Throw a `SitePlanError` carrying every issue unless the plan is valid. */
+declare function assertValidSitePlan(plan: unknown): void;
+
+/**
+ * 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.
+ *
+ * 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
+ * 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).
+ */
+declare enum PlaceholderKind {
+    /** A FACT the customer did not give (email, phone, city): publish-blocking. */
+    Fact = "fact",
+    /** The pattern's own words, for the author to rewrite. */
+    Copy = "copy",
+    /** An image slot with no image: the empty-image placeholder (DS3). */
+    Image = "image"
+}
+interface ComposedPlaceholder {
+    nodeId: string;
+    /** The page key, or the global slot (`header` / `footer`), the node lives in. */
+    owner: string;
+    kind: PlaceholderKind;
+    fact?: FactKey;
+    slot?: string;
+    /** What the node shows meanwhile: the fact's label, the pattern's copy, or '' for an image. */
+    text: string;
+}
+declare enum 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. */
+    UnfilledSlot = "unfilled-slot",
+    /** A pattern links to a route the plan has no page for (an optional page was left out). */
+    DanglingLink = "dangling-link"
+}
+interface ComposeIssue {
+    code: ComposeIssueCode;
+    nodeId: string;
+    owner: string;
+    detail: string;
+}
+interface ComposedPage {
+    key: string;
+    name: string;
+    route: {
+        path: string;
+    };
+    isHome: boolean;
+    status: 'draft';
+    /** DS3: every page the wizard creates follows the look (page-bg / text / font-body). */
+    pageSettings: {
+        designSystem: true;
+    };
+    layout: SerializedNode[];
+}
+interface ComposedDataSource {
+    id: string;
+    alias: string;
+    type: string;
+    mode: string;
+    request: Record<string, unknown>;
+}
+type ComposedItem = Record<string, unknown> & {
+    isPublished: boolean;
+    isSample: boolean;
+};
+interface ComposedRoute {
+    key: string;
+    path: string;
+    isHome: boolean;
+}
+interface ComposedSite {
+    source: SitePlanSource;
+    business: SiteBusiness;
+    /** The look, completed against its pack (`resolveDesignChoices`) — what the build applies. */
+    design: DesignChoices;
+    /** The content types to create, as the plan states them. */
+    schemas: ContentTypePlan[];
+    /** Sample items per content type. `{sampleImage:k}` values name a bundled sample image the build resolves. */
+    items: Record<string, ComposedItem[]>;
+    /** Merged by alias into the org data-source library. */
+    dataSources: ComposedDataSource[];
+    pages: ComposedPage[];
+    /** Header + footer: root nodes carry `isGlobal` and `globalPosition`. */
+    globals: SerializedNode[];
+    routes: ComposedRoute[];
+    placeholders: ComposedPlaceholder[];
+    issues: ComposeIssue[];
+}
+/** `{sampleImage:k}` — a bundled abstract sample image, never a stock photo (plan §6b). */
+declare const SAMPLE_IMAGE_REF: RegExp;
+declare function sampleImageRef(index: number): string;
+/** The 1-based index a `{sampleImage:k}` value names, or null. */
+declare function parseSampleImageRef(value: unknown): number | null;
+/** 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>`. */
+declare function baseRelativeHref(route: string): string;
+/**
+ * Compose a Site Plan. Throws `SitePlanError` (every issue) when the plan does not validate — the
+ * composer never repairs a plan.
+ */
+declare function composeSite(plan: SitePlan): ComposedSite;
+
+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 type { CmsDataSourcePlan, ComposeIssue, ComposedDataSource, ComposedItem, ComposedPage, ComposedPlaceholder, ComposedRoute, ComposedSite, ContentFieldPlan, ContentSeedPlan, ContentTypePlan, DataSourcePlan, FactKey, NodeBaseline, PagePlan, PageSectionPlan, PatternNode, RelativeDataSourcePlan, SerializedBinding, SerializedNode, SerializedResponsive, SiteBusiness, SitePattern, SitePlan, SitePlanIssue, SitePlanSource, SitePlanValidation, SiteTemplate, TemplatePlanInput };