@vectoriox/iox-ui 5.39.0 → 5.41.0

package/generation-core/index.d.ts

@@ -892,6 +892,512 @@ declare const SPEC_SITE_PATTERNS: {
             }];
         };
     };
+    readonly "pricing.tiers": {
+        readonly family: "pricing";
+        readonly label: "Pricing — plans with a monthly / yearly switch";
+        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: "8px";
+                    readonly alignItems: "center";
+                    readonly textAlign: "center";
+                };
+                readonly c: readonly [{
+                    readonly t: "Text";
+                    readonly es: "eyebrow";
+                    readonly slot: "eyebrow";
+                    readonly ph: "copy";
+                    readonly text: "Pricing";
+                }, {
+                    readonly t: "Heading";
+                    readonly es: "h2";
+                    readonly level: "h2";
+                    readonly slot: "title";
+                    readonly ph: "copy";
+                    readonly text: "Plans";
+                }];
+            }, {
+                readonly t: "Container";
+                readonly recipe: "segmented";
+                readonly name: "Billing period";
+                readonly lay: {
+                    readonly alignSelf: "center";
+                };
+                readonly resp: {
+                    readonly mobile: {
+                        readonly position: "sticky";
+                        readonly top: "calc(12px + env(safe-area-inset-top, 0px))";
+                        readonly zIndex: "2";
+                    };
+                };
+            }, {
+                readonly t: "Container";
+                readonly es: "box";
+                readonly layer: "Plans";
+                readonly lay: {
+                    readonly display: "grid";
+                    readonly gridTemplateColumns: "repeat(3, minmax(0, 1fr))";
+                    readonly gap: "var(--iox-space-gap)";
+                    readonly alignItems: "stretch";
+                };
+                readonly resp: {
+                    readonly mobile: {
+                        readonly gridTemplateColumns: "minmax(0, 1fr)";
+                    };
+                };
+                readonly c: readonly [{
+                    readonly t: "Container";
+                    readonly recipe: "card";
+                    readonly layout: "top";
+                    readonly ph: "copy";
+                    readonly parts: {
+                        readonly media: false;
+                        readonly eyebrow: false;
+                        readonly badge: false;
+                        readonly actions: false;
+                    };
+                    readonly words: {
+                        readonly title: "First plan";
+                        readonly text: "Who this plan is for, in one sentence.";
+                    };
+                    readonly c: readonly [{
+                        readonly t: "Container";
+                        readonly es: "box";
+                        readonly layer: "Price · Monthly";
+                        readonly shownWhen: "monthly";
+                        readonly lay: {
+                            readonly display: "flex";
+                            readonly alignItems: "baseline";
+                            readonly flexWrap: "wrap";
+                            readonly gap: "6px";
+                        };
+                        readonly c: readonly [{
+                            readonly t: "Text";
+                            readonly es: "price";
+                            readonly ph: "price";
+                            readonly text: "Monthly price";
+                        }, {
+                            readonly t: "Text";
+                            readonly es: "small";
+                            readonly text: "per month";
+                        }];
+                    }, {
+                        readonly t: "Container";
+                        readonly es: "box";
+                        readonly layer: "Price · Yearly";
+                        readonly shownWhen: "yearly";
+                        readonly lay: {
+                            readonly display: "flex";
+                            readonly alignItems: "baseline";
+                            readonly flexWrap: "wrap";
+                            readonly gap: "6px";
+                        };
+                        readonly c: readonly [{
+                            readonly t: "Text";
+                            readonly es: "price";
+                            readonly ph: "price";
+                            readonly text: "Yearly price";
+                        }, {
+                            readonly t: "Text";
+                            readonly es: "small";
+                            readonly text: "per year";
+                        }];
+                    }, {
+                        readonly t: "Container";
+                        readonly es: "box";
+                        readonly layer: "Includes";
+                        readonly lay: {
+                            readonly display: "flex";
+                            readonly flexDirection: "column";
+                            readonly gap: "8px";
+                        };
+                        readonly c: readonly [{
+                            readonly t: "Container";
+                            readonly es: "box";
+                            readonly lay: {
+                                readonly display: "flex";
+                                readonly flexWrap: "nowrap";
+                                readonly gap: "8px";
+                                readonly alignItems: "flex-start";
+                            };
+                            readonly c: readonly [{
+                                readonly t: "Icon";
+                                readonly es: "icon";
+                                readonly icon: "ph ph-check";
+                            }, {
+                                readonly t: "Text";
+                                readonly es: "body";
+                                readonly ph: "copy";
+                                readonly text: "What this plan includes";
+                            }];
+                        }, {
+                            readonly t: "Container";
+                            readonly es: "box";
+                            readonly lay: {
+                                readonly display: "flex";
+                                readonly flexWrap: "nowrap";
+                                readonly gap: "8px";
+                                readonly alignItems: "flex-start";
+                            };
+                            readonly c: readonly [{
+                                readonly t: "Icon";
+                                readonly es: "icon";
+                                readonly icon: "ph ph-check";
+                            }, {
+                                readonly t: "Text";
+                                readonly es: "body";
+                                readonly ph: "copy";
+                                readonly text: "What this plan includes";
+                            }];
+                        }, {
+                            readonly t: "Container";
+                            readonly es: "box";
+                            readonly lay: {
+                                readonly display: "flex";
+                                readonly flexWrap: "nowrap";
+                                readonly gap: "8px";
+                                readonly alignItems: "flex-start";
+                            };
+                            readonly c: readonly [{
+                                readonly t: "Icon";
+                                readonly es: "icon";
+                                readonly icon: "ph ph-check";
+                            }, {
+                                readonly t: "Text";
+                                readonly es: "body";
+                                readonly ph: "copy";
+                                readonly text: "What this plan includes";
+                            }];
+                        }];
+                    }, {
+                        readonly t: "Container";
+                        readonly es: "box";
+                        readonly role: "card.actions";
+                        readonly layer: "Buttons";
+                        readonly lay: {
+                            readonly display: "flex";
+                            readonly flexWrap: "wrap";
+                            readonly gap: "8px";
+                            readonly alignItems: "center";
+                            readonly width: "100%";
+                            readonly margin: "auto 0px 0px 0px";
+                            readonly padding: "6px 0px 0px 0px";
+                        };
+                        readonly c: readonly [{
+                            readonly t: "ButtonBlock";
+                            readonly es: "button-primary";
+                            readonly href: "/contact";
+                            readonly text: "Choose this plan";
+                        }];
+                    }];
+                }, {
+                    readonly t: "Container";
+                    readonly recipe: "card";
+                    readonly layout: "top";
+                    readonly ph: "copy";
+                    readonly scheme: "accent";
+                    readonly badge: "neutral";
+                    readonly parts: {
+                        readonly media: false;
+                        readonly eyebrow: false;
+                        readonly badge: true;
+                        readonly actions: false;
+                    };
+                    readonly words: {
+                        readonly title: "Second plan";
+                        readonly text: "Who this plan is for, in one sentence.";
+                        readonly badge: "Most popular";
+                    };
+                    readonly c: readonly [{
+                        readonly t: "Container";
+                        readonly es: "box";
+                        readonly layer: "Price · Monthly";
+                        readonly shownWhen: "monthly";
+                        readonly lay: {
+                            readonly display: "flex";
+                            readonly alignItems: "baseline";
+                            readonly flexWrap: "wrap";
+                            readonly gap: "6px";
+                        };
+                        readonly c: readonly [{
+                            readonly t: "Text";
+                            readonly es: "price";
+                            readonly ph: "price";
+                            readonly text: "Monthly price";
+                        }, {
+                            readonly t: "Text";
+                            readonly es: "small";
+                            readonly text: "per month";
+                        }];
+                    }, {
+                        readonly t: "Container";
+                        readonly es: "box";
+                        readonly layer: "Price · Yearly";
+                        readonly shownWhen: "yearly";
+                        readonly lay: {
+                            readonly display: "flex";
+                            readonly alignItems: "baseline";
+                            readonly flexWrap: "wrap";
+                            readonly gap: "6px";
+                        };
+                        readonly c: readonly [{
+                            readonly t: "Text";
+                            readonly es: "price";
+                            readonly ph: "price";
+                            readonly text: "Yearly price";
+                        }, {
+                            readonly t: "Text";
+                            readonly es: "small";
+                            readonly text: "per year";
+                        }];
+                    }, {
+                        readonly t: "Container";
+                        readonly es: "box";
+                        readonly layer: "Includes";
+                        readonly lay: {
+                            readonly display: "flex";
+                            readonly flexDirection: "column";
+                            readonly gap: "8px";
+                        };
+                        readonly c: readonly [{
+                            readonly t: "Container";
+                            readonly es: "box";
+                            readonly lay: {
+                                readonly display: "flex";
+                                readonly flexWrap: "nowrap";
+                                readonly gap: "8px";
+                                readonly alignItems: "flex-start";
+                            };
+                            readonly c: readonly [{
+                                readonly t: "Icon";
+                                readonly es: "icon";
+                                readonly icon: "ph ph-check";
+                            }, {
+                                readonly t: "Text";
+                                readonly es: "body";
+                                readonly ph: "copy";
+                                readonly text: "What this plan includes";
+                            }];
+                        }, {
+                            readonly t: "Container";
+                            readonly es: "box";
+                            readonly lay: {
+                                readonly display: "flex";
+                                readonly flexWrap: "nowrap";
+                                readonly gap: "8px";
+                                readonly alignItems: "flex-start";
+                            };
+                            readonly c: readonly [{
+                                readonly t: "Icon";
+                                readonly es: "icon";
+                                readonly icon: "ph ph-check";
+                            }, {
+                                readonly t: "Text";
+                                readonly es: "body";
+                                readonly ph: "copy";
+                                readonly text: "What this plan includes";
+                            }];
+                        }, {
+                            readonly t: "Container";
+                            readonly es: "box";
+                            readonly lay: {
+                                readonly display: "flex";
+                                readonly flexWrap: "nowrap";
+                                readonly gap: "8px";
+                                readonly alignItems: "flex-start";
+                            };
+                            readonly c: readonly [{
+                                readonly t: "Icon";
+                                readonly es: "icon";
+                                readonly icon: "ph ph-check";
+                            }, {
+                                readonly t: "Text";
+                                readonly es: "body";
+                                readonly ph: "copy";
+                                readonly text: "What this plan includes";
+                            }];
+                        }];
+                    }, {
+                        readonly t: "Container";
+                        readonly es: "box";
+                        readonly role: "card.actions";
+                        readonly layer: "Buttons";
+                        readonly lay: {
+                            readonly display: "flex";
+                            readonly flexWrap: "wrap";
+                            readonly gap: "8px";
+                            readonly alignItems: "center";
+                            readonly width: "100%";
+                            readonly margin: "auto 0px 0px 0px";
+                            readonly padding: "6px 0px 0px 0px";
+                        };
+                        readonly c: readonly [{
+                            readonly t: "ButtonBlock";
+                            readonly es: "button-primary";
+                            readonly href: "/contact";
+                            readonly text: "Choose this plan";
+                        }];
+                    }];
+                }, {
+                    readonly t: "Container";
+                    readonly recipe: "card";
+                    readonly layout: "top";
+                    readonly ph: "copy";
+                    readonly parts: {
+                        readonly media: false;
+                        readonly eyebrow: false;
+                        readonly badge: false;
+                        readonly actions: false;
+                    };
+                    readonly words: {
+                        readonly title: "Third plan";
+                        readonly text: "Who this plan is for, in one sentence.";
+                    };
+                    readonly c: readonly [{
+                        readonly t: "Container";
+                        readonly es: "box";
+                        readonly layer: "Price · Monthly";
+                        readonly shownWhen: "monthly";
+                        readonly lay: {
+                            readonly display: "flex";
+                            readonly alignItems: "baseline";
+                            readonly flexWrap: "wrap";
+                            readonly gap: "6px";
+                        };
+                        readonly c: readonly [{
+                            readonly t: "Text";
+                            readonly es: "price";
+                            readonly ph: "price";
+                            readonly text: "Monthly price";
+                        }, {
+                            readonly t: "Text";
+                            readonly es: "small";
+                            readonly text: "per month";
+                        }];
+                    }, {
+                        readonly t: "Container";
+                        readonly es: "box";
+                        readonly layer: "Price · Yearly";
+                        readonly shownWhen: "yearly";
+                        readonly lay: {
+                            readonly display: "flex";
+                            readonly alignItems: "baseline";
+                            readonly flexWrap: "wrap";
+                            readonly gap: "6px";
+                        };
+                        readonly c: readonly [{
+                            readonly t: "Text";
+                            readonly es: "price";
+                            readonly ph: "price";
+                            readonly text: "Yearly price";
+                        }, {
+                            readonly t: "Text";
+                            readonly es: "small";
+                            readonly text: "per year";
+                        }];
+                    }, {
+                        readonly t: "Container";
+                        readonly es: "box";
+                        readonly layer: "Includes";
+                        readonly lay: {
+                            readonly display: "flex";
+                            readonly flexDirection: "column";
+                            readonly gap: "8px";
+                        };
+                        readonly c: readonly [{
+                            readonly t: "Container";
+                            readonly es: "box";
+                            readonly lay: {
+                                readonly display: "flex";
+                                readonly flexWrap: "nowrap";
+                                readonly gap: "8px";
+                                readonly alignItems: "flex-start";
+                            };
+                            readonly c: readonly [{
+                                readonly t: "Icon";
+                                readonly es: "icon";
+                                readonly icon: "ph ph-check";
+                            }, {
+                                readonly t: "Text";
+                                readonly es: "body";
+                                readonly ph: "copy";
+                                readonly text: "What this plan includes";
+                            }];
+                        }, {
+                            readonly t: "Container";
+                            readonly es: "box";
+                            readonly lay: {
+                                readonly display: "flex";
+                                readonly flexWrap: "nowrap";
+                                readonly gap: "8px";
+                                readonly alignItems: "flex-start";
+                            };
+                            readonly c: readonly [{
+                                readonly t: "Icon";
+                                readonly es: "icon";
+                                readonly icon: "ph ph-check";
+                            }, {
+                                readonly t: "Text";
+                                readonly es: "body";
+                                readonly ph: "copy";
+                                readonly text: "What this plan includes";
+                            }];
+                        }, {
+                            readonly t: "Container";
+                            readonly es: "box";
+                            readonly lay: {
+                                readonly display: "flex";
+                                readonly flexWrap: "nowrap";
+                                readonly gap: "8px";
+                                readonly alignItems: "flex-start";
+                            };
+                            readonly c: readonly [{
+                                readonly t: "Icon";
+                                readonly es: "icon";
+                                readonly icon: "ph ph-check";
+                            }, {
+                                readonly t: "Text";
+                                readonly es: "body";
+                                readonly ph: "copy";
+                                readonly text: "What this plan includes";
+                            }];
+                        }];
+                    }, {
+                        readonly t: "Container";
+                        readonly es: "box";
+                        readonly role: "card.actions";
+                        readonly layer: "Buttons";
+                        readonly lay: {
+                            readonly display: "flex";
+                            readonly flexWrap: "wrap";
+                            readonly gap: "8px";
+                            readonly alignItems: "center";
+                            readonly width: "100%";
+                            readonly margin: "auto 0px 0px 0px";
+                            readonly padding: "6px 0px 0px 0px";
+                        };
+                        readonly c: readonly [{
+                            readonly t: "ButtonBlock";
+                            readonly es: "button-primary";
+                            readonly href: "/contact";
+                            readonly text: "Choose this plan";
+                        }];
+                    }];
+                }];
+            }];
+            readonly lay: {
+                readonly display: "flex";
+                readonly flexDirection: "column";
+                readonly gap: "32px";
+            };
+        };
+    };
     readonly "hero.full-bleed-media": {
         readonly family: "hero";
         readonly label: "Hero — words over a background video";
@@ -1395,6 +1901,12 @@ interface SitePlan {
  * `binds`, a binding path per part: `image`, `eyebrow`, `title`, `text`; `href` + `param` link the whole card
  * through its title). A header pattern's `phoneMenu` names its phone shape (drawer · bar · both), stamped by
  * `planNavShape` (CC1).
+ *
+ * CC4b (`pricing.tiers`): `recipe: 'segmented'` stamps a Segmented control (Monthly · Yearly, named by `name`, its own
+ * `lay` / `resp`) · `shownWhen` hides a node at base and shows it while the pattern's segmented option of that key is
+ * on (the targeted `trigger-on`) · `ph: 'price'` a price the studio types (a publish-blocking placeholder showing its
+ * label) · on a card recipe: `words` (title / text / badge), `badge` (the badge's tone), `scheme` (the Brand card), and
+ * `c` — nodes joining its Content column · `icon` an Icon's glyph · `layer` the node's name in the layer tree.
  */
 interface PatternNode {
     readonly t: string;
@@ -1433,6 +1945,16 @@ interface PatternNode {
     readonly opens?: string;
     /** CC3: a control's accessible name (`ariaLabel`). */
     readonly name?: string;
+    /** CC4b: hidden at base, shown while the pattern's Segmented option with this key is on. */
+    readonly shownWhen?: string;
+    /** CC4b: a card recipe's words (its title, text, badge). */
+    readonly words?: Readonly<Record<string, string>>;
+    /** CC4b: a card recipe's badge tone (`neutral` · `success` · `warning` · `accent`). */
+    readonly badge?: string;
+    /** CC4b: an Icon's glyph (`ph ph-check`). */
+    readonly icon?: string;
+    /** CC4b: the node's name in the layer tree (`Price · Monthly`). */
+    readonly layer?: string;
 }
 /** The composite-core recipes a pattern may stamp (`recipe`). */
 declare enum PatternRecipe {
@@ -1443,6 +1965,8 @@ declare enum PatternRecipe {
     /** CC4a: Tabs — Manual (three placeholder tabs), or From content when the section names a list `binding`: the tab
      *  list and the panels are both Repeaters over it, one row giving its tab AND its panel. */
     Tabs = "tabs",
+    /** CC4b: the Segmented control — Monthly · Yearly, named by the pattern (`name`). */
+    Segmented = "segmented",
     /** CC3: the accessible carousel — a named Slider whose controls are parts, one quote per slide (placeholders). */
     Carousel = "carousel",
     /** CC3: the Lightbox — a Dialog holding a Slider over the node's `src` (the gallery's own source). */
@@ -1476,7 +2000,9 @@ declare enum PatternPlaceholder {
     Copy = "copy",
     Image = "image",
     /** CC3: a clip the studio uploads (a Video's file): the poster blank until then, publish-blocking. */
-    Video = "video"
+    Video = "video",
+    /** CC4b (Q37): a price the studio types — free text, publish-blocking, its label shown meanwhile, never a number. */
+    Price = "price"
 }
 /** CC3: what an `opens` node opens. */
 declare enum PatternOpens {
@@ -1707,8 +2233,16 @@ declare enum PlaceholderKind {
     /** An image slot with no image: the empty-image placeholder (DS3). */
     Image = "image",
     /** CC3: a video slot with no clip — the studio uploads its own (the poster blank meanwhile). */
-    Video = "video"
+    Video = "video",
+    /** CC4b (Q37): a price — a FACT the customer could be held to. Free text the studio types ("₪ 1,200", "From $40",
+     *  "On request"); its label shows meanwhile ("Monthly price"), never a number. No currency model. */
+    Price = "price"
 }
+/** The placeholders a page cannot be published with unfilled (W4's gate): a fact, a price, the studio's own video.
+ *  Copy and an empty image are the author's to rewrite, never blocking. */
+declare const PUBLISH_BLOCKING_PLACEHOLDERS: ReadonlySet<PlaceholderKind>;
+/** True when a placeholder of `kind` blocks publishing until the studio fills it. */
+declare function blocksPublish(kind: PlaceholderKind): boolean;
 interface ComposedPlaceholder {
     nodeId: string;
     /** The page key, or the global slot (`header` / `footer`), the node lives in. */
@@ -1805,6 +2339,66 @@ declare function parseSampleImageRef(value: unknown): number | null;
  * composer never repairs a plan. `context` carries what the composer may not read for itself (the year).
  */
 declare function composeSite(plan: SitePlan, context: ComposeContext): ComposedSite;
+/** The header pattern the Studio template stamps — and the builder palette's "Navigation bar". */
+declare const SITE_HEADER_PATTERN = "nav.inline-cta";
+/** A page of the studio as the builder lists it. */
+interface SitePageRef {
+    readonly name: string;
+    readonly route: string;
+    readonly isHome?: boolean;
+}
+/** What the header is composed from when there is no Site Plan: the studio's name and its pages. */
+interface NavHeaderInput {
+    readonly business: SiteBusiness;
+    /** Every page of the studio, in the order the navigation should list them. */
+    readonly pages: ReadonlyArray<SitePageRef>;
+}
+interface NavHeaderOptions {
+    /** The header's id; its parts' ids derive from it (`<id>-0-1-…`), so a fresh id gives fresh parts. */
+    readonly id: string;
+    /** A phone-shape part's id (the builder passes its id generator). */
+    readonly newId?: (suffix: string) => string;
+}
+interface ComposedNavHeader {
+    /** The header — a global BEFORE element — carrying the pattern's phone shape (the drawer). */
+    header: SerializedNode;
+    issues: ComposeIssue[];
+}
+/** The pages a navigation links to: every page but Home (the brand links there) and template pages
+ *  (a `/work/:slug` route has no single address), in the studio's order. */
+declare function siteNavPages(pages: ReadonlyArray<SitePageRef>): SitePageRef[];
+/**
+ * The Studio template's header, composed for a studio that has no Site Plan — the builder palette's
+ * "Navigation bar". THE SAME pattern and the same composer as `composeSite`: the brand (the business name),
+ * one plain Link per navigation page, the call to action (W1.1's one dangling-link rule when the studio has
+ * no /contact page: an email to the business, else removed), and the pattern's phone shape. Pure.
+ */
+declare function composeNavHeader(input: NavHeaderInput, options: NavHeaderOptions): ComposedNavHeader;
+/** The pricing section (CC4b, board 10): plans with a Monthly / Yearly switch — the library and the palette, never a
+ *  Studio page (Q35). */
+declare const PRICING_PATTERN = "pricing.tiers";
+/** What a section is composed from when there is no Site Plan: the studio's name, its pages (the routes a link may
+ *  reach) and its facts. */
+interface SectionInput {
+    readonly business?: SiteBusiness;
+    readonly pages?: ReadonlyArray<SitePageRef>;
+}
+interface SectionOptions {
+    /** The section's id; its parts' ids derive from it (`<id>-0-1-…`), so a fresh id gives fresh parts. */
+    readonly id: string;
+}
+interface ComposedSection {
+    section: SerializedNode;
+    placeholders: ComposedPlaceholder[];
+    issues: ComposeIssue[];
+}
+/**
+ * ONE library pattern composed on its own — the builder palette's ready-made sections (CC4b: "Pricing", the
+ * `pricing.tiers` pattern). THE SAME pattern and composer as `composeSite`: its words, its placeholders (a price shows
+ * its label, never a number) and the one dangling-link rule — except a button to a page the studio lacks keeps its
+ * words, unlinked, for the author to link. Pure.
+ */
+declare function composeSection(patternId: string, input: SectionInput, options: SectionOptions): ComposedSection;
 
 /**
  * The phone shapes of a navigation bar (complex-components plan CC1, §7a + R1; boards 1–3). ONE pure tree
@@ -1864,6 +2458,8 @@ interface NavShapeOptions {
     barItems?: number;
     /** A new part's id (the builder passes its id generator). Default: `<nav id>-<suffix>`. */
     newId?: (suffix: string) => string;
+    /** The studio's pages, for a header that links to none (a hand-built one): its menu lists these. */
+    pages?: ReadonlyArray<NavPage>;
 }
 interface NavShapeResult {
     /** The globals after the edit (the Navigation bar edited in place, the drawer/bar added or removed). */
@@ -1896,6 +2492,18 @@ declare function navShapeOf(globals: ReadonlyArray<SerializedNode>): NavShape |
 declare function navShapeBreakpoint(globals: ReadonlyArray<SerializedNode>): PhoneMenuBreakpoint;
 /** The pages the header links to, in order: its Links (W1.1 — one plain Link per page in the navigation). */
 declare function navPages(root: SerializedNode): NavPage[];
+/** Where a phone menu's pages come from: the header's own page Links, else the studio's pages. */
+declare enum NavPagesSource {
+    Header = "header",
+    Site = "site",
+    None = "none"
+}
+/** The pages a phone menu lists: the header's (`navPages`), else `sitePages` — a hand-built header with no
+ *  page links still gets a working menu. */
+declare function phoneMenuPages(root: SerializedNode, sitePages?: ReadonlyArray<NavPage>): {
+    pages: NavPage[];
+    source: NavPagesSource;
+};
 /**
  * Put a site's header into `shape`. The Navigation bar is `navId` or the global carrying the root role
  * (else the first Container wearing `nav`, which this then marks with roles). Returns new globals;
@@ -1911,7 +2519,19 @@ interface AddBarItemResult {
  * The bar's Items list "Add item" (board 2): one more item, before More — the next navigation page the
  * bar does not link to yet (Home when every page is there). Refused at five (Q2). Input not mutated.
  */
-declare function addBarItem(globals: ReadonlyArray<SerializedNode>, options?: Pick<NavShapeOptions, 'newId'>): AddBarItemResult;
+declare function addBarItem(globals: ReadonlyArray<SerializedNode>, options?: Pick<NavShapeOptions, 'newId' | 'pages'>): AddBarItemResult;
+interface BarItemsEditResult {
+    globals: SerializedNode[];
+    /** False when nothing changed: no bar, an unknown item, or the bar would drop below three items (Q2). */
+    changed: boolean;
+}
+/**
+ * The bar's Items list "Remove" (board 2): the item goes, More included — refused below three items (Q2:
+ * 3–5), so the bar never shrinks into something a thumb cannot use. Input not mutated.
+ */
+declare function removeBarItem(globals: ReadonlyArray<SerializedNode>, itemId: string): BarItemsEditResult;
+/** The bar's Items list drag-to-reorder (board 2): item `from` moves to `to`. Input not mutated. */
+declare function moveBarItem(globals: ReadonlyArray<SerializedNode>, from: number, to: number): BarItemsEditResult;
 
-export { BAR_ITEMS_MAX, BAR_ITEMS_MIN, BASELINE_ROLES, BaselineRole, BindScope, CardBindTarget, ComposeError, ComposeIssueCode, DANGLING_LINK_CODES, DEFAULT_PHONE_MENU_BREAKPOINT, FACT_KEYS, GlobalSlot, NAV_PART_LABELS, NAV_SHAPE_COPY, NEUTRAL_STYLE_PROPS, NODE_BASELINES, NavRole, NavShape, NavShapeError, PatternDirective, PatternGlobalPosition, PatternOpens, PatternPlaceholder, PatternRecipe, PhoneMenuBreakpoint, 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, addBarItem, altSourceScopes, assertStyleSlots, assertValidSitePlan, barIconForRoute, composeSite, createSerializedNode, findNavRoot, navPages, navShapeBreakpoint, navShapeOf, nextSourceOf, nodeBindPaths, parseSampleImageRef, patternById, patternNeedsBinding, patternNodes, patternOptionalParts, patternScopes, patternSlots, patternTakesBinding, planFromTemplate, planNavShape, releasedLayoutDefaults, requiredShapeKeys, routeParams, sampleImageRef, setStyleProps, shapeKeys, validateSitePlan, walkSerialized };
-export type { AddBarItemResult, CmsDataSourcePlan, ComposeContext, ComposeIssue, ComposedDataSource, ComposedItem, ComposedPage, ComposedPlaceholder, ComposedRoute, ComposedSite, ContentFieldPlan, ContentSeedPlan, ContentTypePlan, CreateNodeOptions, DataSourcePlan, FactKey, NavPage, NavShapeOptions, NavShapeResult, NodeBaseline, PagePlan, PageSectionPlan, PatternNode, RelativeDataSourcePlan, SerializedBinding, SerializedNode, SerializedResponsive, SiteBusiness, SitePattern, SitePlan, SitePlanIssue, SitePlanSource, SitePlanValidation, SiteTemplate, TemplatePlanInput };
+export { BAR_ITEMS_MAX, BAR_ITEMS_MIN, BASELINE_ROLES, BaselineRole, BindScope, CardBindTarget, ComposeError, ComposeIssueCode, DANGLING_LINK_CODES, DEFAULT_PHONE_MENU_BREAKPOINT, FACT_KEYS, GlobalSlot, NAV_PART_LABELS, NAV_SHAPE_COPY, NEUTRAL_STYLE_PROPS, NODE_BASELINES, NavPagesSource, NavRole, NavShape, NavShapeError, PRICING_PATTERN, PUBLISH_BLOCKING_PLACEHOLDERS, PatternDirective, PatternGlobalPosition, PatternOpens, PatternPlaceholder, PatternRecipe, PhoneMenuBreakpoint, PlaceholderKind, PlanDataSourceMode, PlanDataSourceType, RelativeOp, SAMPLE_IMAGE_REF, SITE_FACT_LABELS, SITE_HEADER_PATTERN, 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, addBarItem, altSourceScopes, assertStyleSlots, assertValidSitePlan, barIconForRoute, blocksPublish, composeNavHeader, composeSection, composeSite, createSerializedNode, findNavRoot, moveBarItem, navPages, navShapeBreakpoint, navShapeOf, nextSourceOf, nodeBindPaths, parseSampleImageRef, patternById, patternNeedsBinding, patternNodes, patternOptionalParts, patternScopes, patternSlots, patternTakesBinding, phoneMenuPages, planFromTemplate, planNavShape, releasedLayoutDefaults, removeBarItem, requiredShapeKeys, routeParams, sampleImageRef, setStyleProps, shapeKeys, siteNavPages, validateSitePlan, walkSerialized };
+export type { AddBarItemResult, BarItemsEditResult, CmsDataSourcePlan, ComposeContext, ComposeIssue, ComposedDataSource, ComposedItem, ComposedNavHeader, ComposedPage, ComposedPlaceholder, ComposedRoute, ComposedSection, ComposedSite, ContentFieldPlan, ContentSeedPlan, ContentTypePlan, CreateNodeOptions, DataSourcePlan, FactKey, NavHeaderInput, NavHeaderOptions, NavPage, NavShapeOptions, NavShapeResult, NodeBaseline, PagePlan, PageSectionPlan, PatternNode, RelativeDataSourcePlan, SectionInput, SectionOptions, SerializedBinding, SerializedNode, SerializedResponsive, SiteBusiness, SitePageRef, SitePattern, SitePlan, SitePlanIssue, SitePlanSource, SitePlanValidation, SiteTemplate, TemplatePlanInput };