@aglyn/plugins-ai 1.0.0-beta.229 → 1.0.0-beta.231

package/src/lib/layout-language/ai-layout-frame.js

@@ -0,0 +1,457 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { AI_ICON_LIBRARY } from "../runtime/ai-icon-library.js";
+import { AI_LAYOUT_MAX_IMAGES, bandSx, compileFlow, compileRow, destinationProps } from "./ai-layout-compiler.js";
+import { aiLayoutFitText } from "./ai-layout-copy.js";
+import { AI_LAYOUT_MAX_ITEMS } from "./ai-layout-language.js";
+import { aiLayoutResolveLink } from "./ai-layout-links.js";
+import { AiLayoutTreeBuilder } from "./ai-layout-tree.js";
+/** The header's colors by band, as palette roles. */ function headerLook(band) {
+    if (band === 'brand') return {
+        props: {
+            color: 'primary'
+        },
+        sx: {
+            boxShadow: 'none'
+        }
+    };
+    if (band === 'dark') {
+        return {
+            props: {
+                color: 'primary'
+            },
+            sx: {
+                boxShadow: 'none',
+                bgcolor: 'primary.dark',
+                color: 'primary.contrastText'
+            }
+        };
+    }
+    return {
+        props: {
+            color: 'inherit'
+        },
+        sx: {
+            bgcolor: 'background.paper',
+            boxShadow: 'none',
+            borderBottom: 1,
+            borderColor: 'divider'
+        }
+    };
+}
+/** A line that reads as a copyright notice: "© 2026 …", "Copyright …", "All rights reserved." */ export function aiLayoutIsCopyright(text) {
+    return typeof text === 'string' && /^\s*(?:©|\(c\)|copyright\b)|all rights reserved/i.test(text);
+}
+/** What a footer leaves out: a picture slot, and the page sections a footer is no place for. */ const FOOTER_LEAVES_OUT = new Set([
+    'image',
+    'faq',
+    'quotes',
+    'cards',
+    'steps',
+    'stats',
+    'form',
+    'component'
+]);
+/** A frame scope: no headings of its own (a layout carries no outline), no pictures. */ function frameScope(page, at, band, centered) {
+    return {
+        page,
+        index: at === 'header' ? 0 : 1,
+        at,
+        band,
+        centered,
+        level: 2,
+        headed: true,
+        itemsLeft: AI_LAYOUT_MAX_ITEMS,
+        frame: true,
+        link: {
+            sections: [],
+            from: -1,
+            formSection: null
+        }
+    };
+}
+/** Compiles a site's header and footer, designed in the layout language, into its layout. */ export function aiCompileLayoutFrame(frame, plan, targets) {
+    var _frame_header, _header_band;
+    const tree = new AiLayoutTreeBuilder('lf');
+    const page = {
+        tree,
+        plan: {
+            title: plan.siteName,
+            sections: []
+        },
+        targets: _extends({}, targets, {
+            pageId: null
+        }),
+        // A footer is drawn compact: its lines are lines, never blocks rule 1 would ask to share.
+        options: {
+            reusableComponents: true
+        },
+        settled: [],
+        scrollTo: {},
+        // A frame shows no picture slot: a header and a footer are the same on every page.
+        images: AI_LAYOUT_MAX_IMAGES,
+        strong: {
+            brand: 0,
+            dark: 0
+        },
+        formSection: null,
+        pageIcon: AI_ICON_LIBRARY.sparkle,
+        formsPlaced: new Set()
+    };
+    const name = aiLayoutFitText(plan.siteName, 'heading') || 'Home';
+    const header = (_frame_header = frame.header) != null ? _frame_header : {
+        blocks: []
+    };
+    const band = (_header_band = header.band) != null ? _header_band : 'plain';
+    const look = headerLook(band);
+    const scope = frameScope(page, 'header', band === 'brand' || band === 'dark' ? 'brand' : 'plain', false);
+    const navLink = (entry, role, interactions)=>{
+        const id = tree.add('muiScreenLink', {
+            children: aiLayoutFitText(entry.label, 'label') || entry.label.slice(0, 28),
+            screenId: entry.id,
+            renderAs: 'link',
+            color: 'inherit'
+        }, {
+            textDecoration: 'none'
+        }, null, role);
+        if (interactions) tree.nodes[id].interactions = interactions;
+        return id;
+    };
+    const pages = plan.navPages.filter((entry)=>entry.label.trim());
+    const centeredNav = header.align === 'center' && pages.length > 0;
+    // The brand takes the room the navigation does not, and gives way before
+    // it does: a long name ends in an ellipsis rather than pushing into the links.
+    const brandSx = _extends({
+        typography: 'h6',
+        fontWeight: 800,
+        textDecoration: 'none',
+        whiteSpace: 'nowrap',
+        overflow: 'hidden',
+        textOverflow: 'ellipsis',
+        minWidth: 0
+    }, centeredNav ? {} : {
+        flexGrow: 1
+    });
+    const brand = plan.homeId ? tree.add('muiScreenLink', {
+        children: name.slice(0, 40),
+        screenId: plan.homeId,
+        renderAs: 'link',
+        color: 'inherit'
+    }, brandSx, null, 'brand') : tree.add('muiTypography', {
+        children: name,
+        variant: 'h6',
+        component: 'p'
+    }, brandSx, null, 'brand');
+    const nav = pages.length ? tree.add('muiStack', {
+        component: 'nav',
+        ariaLabel: 'Main',
+        direction: 'row',
+        spacing: '3',
+        alignItems: 'center'
+    }, {
+        display: {
+            xs: 'none',
+            md: 'flex'
+        }
+    }, pages.map((entry)=>navLink(entry, 'navLink')), 'nav') : null;
+    // The design's call to action: its first button, where it goes somewhere.
+    const ctaBlock = header.blocks.find((block)=>block.kind === 'button');
+    for (const block of header.blocks){
+        if (block !== ctaBlock) page.settled.push({
+            at: 'header',
+            what: `a ${block.kind} in the header; left out`
+        });
+    }
+    const ctaLabel = ctaBlock ? aiLayoutFitText(ctaBlock.text, 'label') : '';
+    const ctaTo = ctaBlock && ctaLabel ? aiLayoutResolveLink(ctaBlock.to, ctaLabel, scope.link, page.targets) : null;
+    if (ctaBlock && !ctaTo) page.settled.push({
+        at: 'header',
+        what: `the button "${ctaLabel}" has nowhere to go; left out`
+    });
+    const ctaProps = ctaTo ? _extends({
+        children: ctaLabel,
+        variant: 'contained',
+        color: scope.band === 'brand' ? 'secondary' : 'primary'
+    }, destinationProps(ctaTo)) : null;
+    // On the smallest phones the call to action moves into the menu.
+    const cta = ctaProps ? tree.add('muiButton', ctaProps, {
+        display: {
+            xs: 'none',
+            sm: 'inline-flex'
+        },
+        whiteSpace: 'nowrap',
+        flexShrink: 0
+    }, null, 'cta') : null;
+    // A phone's menu: the platform's Drawer, opened by its Menu Button; a link
+    // followed from it closes it.
+    const close = [
+        AI_LAYOUT_CLOSE_DRAWER
+    ];
+    const drawer = pages.length ? tree.add('muiDrawer', {
+        anchor: 'right'
+    }, null, [
+        tree.add('muiStack', {
+            component: 'nav',
+            ariaLabel: 'Menu'
+        }, {
+            display: 'flex',
+            flexDirection: 'column',
+            gap: 2,
+            p: 3,
+            typography: 'h6'
+        }, [
+            ...pages.map((entry)=>navLink(entry, 'menuLink', close)),
+            ctaProps ? tree.add('muiButton', _extends({}, ctaProps, {
+                fullWidth: true
+            }), {
+                mt: 2
+            }, null, 'menuCta') : null
+        ], 'menu')
+    ], 'drawer') : null;
+    const toggle = drawer ? tree.add('muiDrawerToggle', {
+        ariaLabel: 'Open the menu'
+    }, {
+        display: {
+            xs: 'inline-flex',
+            md: 'none'
+        },
+        flexShrink: 0
+    }, null, 'menuButton') : null;
+    const middle = nav && centeredNav ? tree.add('muiBox', null, {
+        flexGrow: 1,
+        display: 'flex',
+        justifyContent: 'center'
+    }, [
+        nav
+    ], 'navRoom') : nav;
+    // The row lives in a Container inside the Toolbar Content, which may only sit in an App Bar.
+    const row = tree.add('muiContainer', {
+        maxWidth: 'lg'
+    }, {
+        display: 'flex',
+        alignItems: 'center',
+        columnGap: 3
+    }, [
+        brand,
+        middle,
+        cta,
+        toggle,
+        drawer
+    ], 'headerRow');
+    const toolbar = tree.add('muiToolbar', {
+        disableGutters: true
+    }, {
+        minHeight: {
+            xs: 64,
+            md: 76
+        }
+    }, [
+        row
+    ], 'toolbar');
+    const bar = tree.add('muiAppBar', _extends({}, look.props, {
+        position: 'sticky',
+        component: 'header',
+        ariaLabel: 'Site header'
+    }), look.sx, [
+        toolbar
+    ], 'header');
+    // The page grows into the room the window leaves, so a short page keeps
+    // its footer at the bottom.
+    const slot = tree.add('layoutSlot', {
+        component: 'main'
+    }, {
+        flexGrow: 1
+    }, null, 'slot');
+    const footer = compileFooter(page, frame.footer, plan, name);
+    const column = tree.add('muiStack', null, {
+        minHeight: '100vh'
+    }, [
+        bar,
+        slot,
+        footer
+    ], 'frame');
+    tree.prune(column, new Set([
+        slot
+    ]));
+    const rootId = tree.add('div', null, null, [
+        column
+    ], 'layout');
+    return {
+        tree: {
+            rootId,
+            nodes: tree.nodes
+        },
+        settled: page.settled
+    };
+}
+/** A link followed from the phone menu closes it. */ const AI_LAYOUT_CLOSE_DRAWER = {
+    id: 'ai-close-menu',
+    name: 'Close the menu',
+    enabled: true,
+    trigger: {
+        event: 'elementClick',
+        everyTime: true
+    },
+    steps: [
+        {
+            type: 'closeDrawer'
+        }
+    ]
+};
+/**
+ * The footer the design describes, with what every footer owes a visitor
+ * written by code: the site's pages, where the design links none of them,
+ * and the site's name under a rule.
+ */ function compileFooter(page, footer, plan, name) {
+    var _ref, _ref1;
+    const tree = page.tree;
+    const band = (_ref = footer == null ? void 0 : footer.band) != null ? _ref : 'soft';
+    const scope = frameScope(page, 'footer', band, (footer == null ? void 0 : footer.align) === 'center');
+    // The footer's page links are the site's pages, every one, as the header's
+    // are (AGL-3660): a list the model wrote of page links is drawn with them
+    // in its place, and a footer with none gets one. The model places the list;
+    // it never chooses which pages it holds.
+    const navItems = plan.navPages.map((entry)=>({
+            title: entry.label,
+            text: '',
+            to: `page:${entry.id}`
+        }));
+    let linksPages = false;
+    const blocks = ((_ref1 = footer == null ? void 0 : footer.blocks) != null ? _ref1 : []).flatMap((given)=>{
+        var _block_items;
+        var _given_items;
+        // The bottom bar carries the frame's one copyright line; a line of the
+        // answer's own that reads as one would print it twice.
+        if (aiLayoutIsCopyright(given.text)) {
+            page.settled.push({
+                at: 'footer',
+                what: 'a copyright line; the footer writes its own'
+            });
+            return [];
+        }
+        const notice = (item)=>aiLayoutIsCopyright(item.title) || aiLayoutIsCopyright(item.text);
+        const block = ((_given_items = given.items) == null ? void 0 : _given_items.some(notice)) ? _extends({}, given, {
+            items: given.items.filter((item)=>!notice(item))
+        }) : given;
+        if (block !== given) page.settled.push({
+            at: 'footer',
+            what: 'a copyright line in a list; the footer writes its own'
+        });
+        if (FOOTER_LEAVES_OUT.has(block.kind)) {
+            page.settled.push({
+                at: 'footer',
+                what: `a ${block.kind} in the footer; left out`
+            });
+            return [];
+        }
+        const pageLinks = block.kind === 'list' && ((_block_items = block.items) != null ? _block_items : []).some((item)=>{
+            var _item_to;
+            return /^page:/.test((_item_to = item.to) != null ? _item_to : '');
+        });
+        if (!pageLinks) return [
+            block
+        ];
+        if (linksPages || !navItems.length) {
+            page.settled.push({
+                at: 'footer',
+                what: 'a second list of page links; left out'
+            });
+            return [];
+        }
+        linksPages = true;
+        return [
+            _extends({}, block, {
+                items: navItems
+            })
+        ];
+    });
+    const cols = (footer == null ? void 0 : footer.cols) && footer.cols.length >= 2 ? footer.cols : null;
+    const columns = cols ? cols.map(()=>[]) : [
+        []
+    ];
+    for (const block of blocks)columns[cols && block.col !== undefined ? Math.min(block.col, cols.length - 1) : 0].push(block);
+    const weights = cols ? [
+        ...cols
+    ] : [
+        2
+    ];
+    if (!linksPages && plan.navPages.length) {
+        columns.push([
+            {
+                kind: 'list',
+                items: plan.navPages.map((entry)=>({
+                        title: entry.label,
+                        text: '',
+                        to: `page:${entry.id}`
+                    }))
+            }
+        ]);
+        weights.push(1);
+    }
+    const filled = columns.map((column, position)=>{
+        var _weights_position;
+        return {
+            column,
+            weight: (_weights_position = weights[position]) != null ? _weights_position : 1
+        };
+    }).filter((entry)=>entry.column.length);
+    const top = filled.length > 1 ? compileRow(scope, filled) : filled.length === 1 ? compileFlow(scope, filled[0].column, 'full') : null;
+    const copyright = tree.add('muiTypography', {
+        children: `© ${name}`,
+        variant: 'body2',
+        component: 'p'
+    }, scope.band === 'brand' ? null : {
+        color: 'text.secondary'
+    }, null, 'copyright');
+    const bottom = tree.add('muiBox', null, {
+        pt: 3,
+        borderTop: 1,
+        borderColor: 'divider'
+    }, [
+        copyright
+    ], 'footerBottom');
+    const stack = tree.add('muiStack', {
+        spacing: '6'
+    }, null, [
+        top,
+        bottom
+    ], 'footerStack');
+    const container = tree.add('muiContainer', {
+        maxWidth: 'lg'
+    }, {
+        py: {
+            xs: 6,
+            md: 8
+        }
+    }, [
+        stack
+    ], 'footerInner');
+    return tree.add('section', _extends({
+        element: 'footer',
+        ariaLabel: 'Site footer'
+    }, scope.band === 'dark' ? {
+        colorScheme: 'dark'
+    } : {}), scope.band === 'soft' ? {
+        bgcolor: 'background.paper',
+        borderTop: 1,
+        borderColor: 'divider'
+    } : bandSx(scope.band), [
+        container
+    ], 'footer');
+}
+
+//# sourceMappingURL=ai-layout-frame.js.map

package/src/lib/layout-language/ai-layout-frame.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/layout-language/ai-layout-frame.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { AI_ICON_LIBRARY } from '../runtime/ai-icon-library'\nimport {\n  AI_LAYOUT_MAX_IMAGES,\n  bandSx,\n  compileFlow,\n  compileRow,\n  destinationProps,\n  type PageScope,\n  type SectionScope,\n} from './ai-layout-compiler'\nimport { aiLayoutFitText } from './ai-layout-copy'\nimport {\n  AI_LAYOUT_MAX_ITEMS,\n  type AiLayoutBand,\n  type AiLayoutBlock,\n  type AiLayoutSection,\n  type AiLayoutSettlement,\n} from './ai-layout-language'\nimport {\n  aiLayoutResolveLink,\n  type AiLayoutPage,\n  type AiLayoutTargets,\n} from './ai-layout-links'\nimport { AiLayoutTreeBuilder, type AiLayoutRawTree } from './ai-layout-tree'\n\n/**\n * A site's frame — the header and the footer every page renders between —\n * compiled from the layout language (AGL-3660), the same language a page is\n * designed in.\n *\n * The design is the model's: the header's band and alignment and its one\n * call to action, and the footer's columns and every word in them. What a\n * frame owes the site is the platform's, written here, so it is never wrong\n * and never invented: the site's name as the brand, linking home; its pages\n * as the navigation, a row on a wide screen and the platform's Drawer behind\n * its Menu Button on a phone; the Layout Slot, the page's one main landmark,\n * held tall enough that the footer sits at the bottom of a short page; and\n * the site's pages and name in the footer, where the design gave neither.\n */\n\nexport interface AiLayoutFramePlan {\n  /** The site's name, which the header and the footer carry as its brand. */\n  siteName: string\n  /** The site's home page, which the brand links; none where the site has none yet. */\n  homeId: string | null\n  /** The pages the navigation links, in order. */\n  navPages: readonly AiLayoutPage[]\n}\n\nexport interface AiLayoutCompiledFrame {\n  tree: AiLayoutRawTree\n  settled: AiLayoutSettlement[]\n}\n\n/** The header's colors by band, as palette roles. */\nfunction headerLook(band: AiLayoutBand): {\n  props: Record<string, unknown>\n  sx: Record<string, unknown>\n} {\n  if (band === 'brand')\n    return { props: { color: 'primary' }, sx: { boxShadow: 'none' } }\n  if (band === 'dark') {\n    return {\n      props: { color: 'primary' },\n      sx: {\n        boxShadow: 'none',\n        bgcolor: 'primary.dark',\n        color: 'primary.contrastText',\n      },\n    }\n  }\n  return {\n    props: { color: 'inherit' },\n    sx: {\n      bgcolor: 'background.paper',\n      boxShadow: 'none',\n      borderBottom: 1,\n      borderColor: 'divider',\n    },\n  }\n}\n\n/** A line that reads as a copyright notice: \"© 2026 …\", \"Copyright …\", \"All rights reserved.\" */\nexport function aiLayoutIsCopyright(text: unknown): boolean {\n  return typeof text === 'string' && /^\\s*(?:©|\\(c\\)|copyright\\b)|all rights reserved/i.test(text)\n}\n\n/** What a footer leaves out: a picture slot, and the page sections a footer is no place for. */\nconst FOOTER_LEAVES_OUT: ReadonlySet<AiLayoutBlock['kind']> = new Set([\n  'image',\n  'faq',\n  'quotes',\n  'cards',\n  'steps',\n  'stats',\n  'form',\n  'component',\n])\n\n/** A frame scope: no headings of its own (a layout carries no outline), no pictures. */\nfunction frameScope(\n  page: PageScope,\n  at: string,\n  band: AiLayoutBand,\n  centered: boolean,\n): SectionScope {\n  return {\n    page,\n    index: at === 'header' ? 0 : 1,\n    at,\n    band,\n    centered,\n    level: 2,\n    headed: true,\n    itemsLeft: AI_LAYOUT_MAX_ITEMS,\n    frame: true,\n    link: { sections: [], from: -1, formSection: null },\n  }\n}\n\n/** Compiles a site's header and footer, designed in the layout language, into its layout. */\nexport function aiCompileLayoutFrame(\n  frame: { header: AiLayoutSection | null; footer: AiLayoutSection | null },\n  plan: AiLayoutFramePlan,\n  targets: AiLayoutTargets,\n): AiLayoutCompiledFrame {\n  const tree = new AiLayoutTreeBuilder('lf')\n  const page: PageScope = {\n    tree,\n    plan: { title: plan.siteName, sections: [] },\n    targets: { ...targets, pageId: null },\n    // A footer is drawn compact: its lines are lines, never blocks rule 1 would ask to share.\n    options: { reusableComponents: true },\n    settled: [],\n    scrollTo: {},\n    // A frame shows no picture slot: a header and a footer are the same on every page.\n    images: AI_LAYOUT_MAX_IMAGES,\n    strong: { brand: 0, dark: 0 },\n    formSection: null,\n    pageIcon: AI_ICON_LIBRARY.sparkle,\n    formsPlaced: new Set(),\n  }\n  const name = aiLayoutFitText(plan.siteName, 'heading') || 'Home'\n  const header = frame.header ?? { blocks: [] }\n  const band = header.band ?? 'plain'\n  const look = headerLook(band)\n  const scope = frameScope(\n    page,\n    'header',\n    band === 'brand' || band === 'dark' ? 'brand' : 'plain',\n    false,\n  )\n  const navLink = (\n    entry: AiLayoutPage,\n    role: string,\n    interactions?: unknown[],\n  ) => {\n    const id = tree.add(\n      'muiScreenLink',\n      {\n        children:\n          aiLayoutFitText(entry.label, 'label') || entry.label.slice(0, 28),\n        screenId: entry.id,\n        renderAs: 'link',\n        color: 'inherit',\n      },\n      { textDecoration: 'none' },\n      null,\n      role,\n    )\n    if (interactions) tree.nodes[id].interactions = interactions\n    return id\n  }\n  const pages = plan.navPages.filter((entry) => entry.label.trim())\n  const centeredNav = header.align === 'center' && pages.length > 0\n  // The brand takes the room the navigation does not, and gives way before\n  // it does: a long name ends in an ellipsis rather than pushing into the links.\n  const brandSx = {\n    typography: 'h6',\n    fontWeight: 800,\n    textDecoration: 'none',\n    whiteSpace: 'nowrap',\n    overflow: 'hidden',\n    textOverflow: 'ellipsis',\n    minWidth: 0,\n    ...(centeredNav ? {} : { flexGrow: 1 }),\n  }\n  const brand = plan.homeId\n    ? tree.add(\n        'muiScreenLink',\n        {\n          children: name.slice(0, 40),\n          screenId: plan.homeId,\n          renderAs: 'link',\n          color: 'inherit',\n        },\n        brandSx,\n        null,\n        'brand',\n      )\n    : tree.add(\n        'muiTypography',\n        { children: name, variant: 'h6', component: 'p' },\n        brandSx,\n        null,\n        'brand',\n      )\n  const nav = pages.length\n    ? tree.add(\n        'muiStack',\n        {\n          component: 'nav',\n          ariaLabel: 'Main',\n          direction: 'row',\n          spacing: '3',\n          alignItems: 'center',\n        },\n        { display: { xs: 'none', md: 'flex' } },\n        pages.map((entry) => navLink(entry, 'navLink')),\n        'nav',\n      )\n    : null\n  // The design's call to action: its first button, where it goes somewhere.\n  const ctaBlock = header.blocks.find((block) => block.kind === 'button')\n  for (const block of header.blocks) {\n    if (block !== ctaBlock)\n      page.settled.push({\n        at: 'header',\n        what: `a ${block.kind} in the header; left out`,\n      })\n  }\n  const ctaLabel = ctaBlock ? aiLayoutFitText(ctaBlock.text, 'label') : ''\n  const ctaTo =\n    ctaBlock && ctaLabel\n      ? aiLayoutResolveLink(ctaBlock.to, ctaLabel, scope.link, page.targets)\n      : null\n  if (ctaBlock && !ctaTo)\n    page.settled.push({\n      at: 'header',\n      what: `the button \"${ctaLabel}\" has nowhere to go; left out`,\n    })\n  const ctaProps = ctaTo\n    ? {\n        children: ctaLabel,\n        variant: 'contained',\n        color: scope.band === 'brand' ? 'secondary' : 'primary',\n        ...destinationProps(ctaTo),\n      }\n    : null\n  // On the smallest phones the call to action moves into the menu.\n  const cta = ctaProps\n    ? tree.add(\n        'muiButton',\n        ctaProps,\n        {\n          display: { xs: 'none', sm: 'inline-flex' },\n          whiteSpace: 'nowrap',\n          flexShrink: 0,\n        },\n        null,\n        'cta',\n      )\n    : null\n  // A phone's menu: the platform's Drawer, opened by its Menu Button; a link\n  // followed from it closes it.\n  const close = [AI_LAYOUT_CLOSE_DRAWER]\n  const drawer = pages.length\n    ? tree.add(\n        'muiDrawer',\n        { anchor: 'right' },\n        null,\n        [\n          tree.add(\n            'muiStack',\n            { component: 'nav', ariaLabel: 'Menu' },\n            {\n              display: 'flex',\n              flexDirection: 'column',\n              gap: 2,\n              p: 3,\n              typography: 'h6',\n            },\n            [\n              ...pages.map((entry) => navLink(entry, 'menuLink', close)),\n              ctaProps\n                ? tree.add(\n                    'muiButton',\n                    { ...ctaProps, fullWidth: true },\n                    { mt: 2 },\n                    null,\n                    'menuCta',\n                  )\n                : null,\n            ],\n            'menu',\n          ),\n        ],\n        'drawer',\n      )\n    : null\n  const toggle = drawer\n    ? tree.add(\n        'muiDrawerToggle',\n        { ariaLabel: 'Open the menu' },\n        { display: { xs: 'inline-flex', md: 'none' }, flexShrink: 0 },\n        null,\n        'menuButton',\n      )\n    : null\n  const middle =\n    nav && centeredNav\n      ? tree.add(\n          'muiBox',\n          null,\n          { flexGrow: 1, display: 'flex', justifyContent: 'center' },\n          [nav],\n          'navRoom',\n        )\n      : nav\n  // The row lives in a Container inside the Toolbar Content, which may only sit in an App Bar.\n  const row = tree.add(\n    'muiContainer',\n    { maxWidth: 'lg' },\n    { display: 'flex', alignItems: 'center', columnGap: 3 },\n    [brand, middle, cta, toggle, drawer],\n    'headerRow',\n  )\n  const toolbar = tree.add(\n    'muiToolbar',\n    { disableGutters: true },\n    { minHeight: { xs: 64, md: 76 } },\n    [row],\n    'toolbar',\n  )\n  const bar = tree.add(\n    'muiAppBar',\n    {\n      ...look.props,\n      position: 'sticky',\n      component: 'header',\n      ariaLabel: 'Site header',\n    },\n    look.sx,\n    [toolbar],\n    'header',\n  )\n  // The page grows into the room the window leaves, so a short page keeps\n  // its footer at the bottom.\n  const slot = tree.add(\n    'layoutSlot',\n    { component: 'main' },\n    { flexGrow: 1 },\n    null,\n    'slot',\n  )\n  const footer = compileFooter(page, frame.footer, plan, name)\n  const column = tree.add(\n    'muiStack',\n    null,\n    { minHeight: '100vh' },\n    [bar, slot, footer],\n    'frame',\n  )\n  tree.prune(column, new Set([slot]))\n  const rootId = tree.add('div', null, null, [column], 'layout')\n  return { tree: { rootId, nodes: tree.nodes }, settled: page.settled }\n}\n\n/** A link followed from the phone menu closes it. */\nconst AI_LAYOUT_CLOSE_DRAWER = {\n  id: 'ai-close-menu',\n  name: 'Close the menu',\n  enabled: true,\n  trigger: { event: 'elementClick', everyTime: true },\n  steps: [{ type: 'closeDrawer' }],\n}\n\n/**\n * The footer the design describes, with what every footer owes a visitor\n * written by code: the site's pages, where the design links none of them,\n * and the site's name under a rule.\n */\nfunction compileFooter(\n  page: PageScope,\n  footer: AiLayoutSection | null,\n  plan: AiLayoutFramePlan,\n  name: string,\n): string {\n  const tree = page.tree\n  const band = footer?.band ?? 'soft'\n  const scope = frameScope(page, 'footer', band, footer?.align === 'center')\n  // The footer's page links are the site's pages, every one, as the header's\n  // are (AGL-3660): a list the model wrote of page links is drawn with them\n  // in its place, and a footer with none gets one. The model places the list;\n  // it never chooses which pages it holds.\n  const navItems = plan.navPages.map((entry) => ({\n    title: entry.label,\n    text: '',\n    to: `page:${entry.id}`,\n  }))\n  let linksPages = false\n  const blocks = (footer?.blocks ?? []).flatMap((given): AiLayoutBlock[] => {\n    // The bottom bar carries the frame's one copyright line; a line of the\n    // answer's own that reads as one would print it twice.\n    if (aiLayoutIsCopyright(given.text)) {\n      page.settled.push({ at: 'footer', what: 'a copyright line; the footer writes its own' })\n      return []\n    }\n    const notice = (item: { title: string; text: string }) => aiLayoutIsCopyright(item.title) || aiLayoutIsCopyright(item.text)\n    const block = given.items?.some(notice) ? { ...given, items: given.items.filter((item) => !notice(item)) } : given\n    if (block !== given) page.settled.push({ at: 'footer', what: 'a copyright line in a list; the footer writes its own' })\n    if (FOOTER_LEAVES_OUT.has(block.kind)) {\n      page.settled.push({\n        at: 'footer',\n        what: `a ${block.kind} in the footer; left out`,\n      })\n      return []\n    }\n    const pageLinks =\n      block.kind === 'list' &&\n      (block.items ?? []).some((item) => /^page:/.test(item.to ?? ''))\n    if (!pageLinks) return [block]\n    if (linksPages || !navItems.length) {\n      page.settled.push({ at: 'footer', what: 'a second list of page links; left out' })\n      return []\n    }\n    linksPages = true\n    return [{ ...block, items: navItems }]\n  })\n  const cols = footer?.cols && footer.cols.length >= 2 ? footer.cols : null\n  const columns: AiLayoutBlock[][] = cols ? cols.map(() => []) : [[]]\n  for (const block of blocks)\n    columns[\n      cols && block.col !== undefined ? Math.min(block.col, cols.length - 1) : 0\n    ].push(block)\n  const weights = cols ? [...cols] : [2]\n  if (!linksPages && plan.navPages.length) {\n    columns.push([\n      {\n        kind: 'list',\n        items: plan.navPages.map((entry) => ({\n          title: entry.label,\n          text: '',\n          to: `page:${entry.id}`,\n        })),\n      },\n    ])\n    weights.push(1)\n  }\n  const filled = columns\n    .map((column, position) => ({ column, weight: weights[position] ?? 1 }))\n    .filter((entry) => entry.column.length)\n  const top =\n    filled.length > 1\n      ? compileRow(scope, filled)\n      : filled.length === 1\n        ? compileFlow(scope, filled[0].column, 'full')\n        : null\n  const copyright = tree.add(\n    'muiTypography',\n    { children: `© ${name}`, variant: 'body2', component: 'p' },\n    scope.band === 'brand' ? null : { color: 'text.secondary' },\n    null,\n    'copyright',\n  )\n  const bottom = tree.add(\n    'muiBox',\n    null,\n    { pt: 3, borderTop: 1, borderColor: 'divider' },\n    [copyright],\n    'footerBottom',\n  )\n  const stack = tree.add(\n    'muiStack',\n    { spacing: '6' },\n    null,\n    [top, bottom],\n    'footerStack',\n  )\n  const container = tree.add(\n    'muiContainer',\n    { maxWidth: 'lg' },\n    { py: { xs: 6, md: 8 } },\n    [stack],\n    'footerInner',\n  )\n  return tree.add(\n    'section',\n    {\n      element: 'footer',\n      ariaLabel: 'Site footer',\n      ...(scope.band === 'dark' ? { colorScheme: 'dark' } : {}),\n    },\n    scope.band === 'soft'\n      ? { bgcolor: 'background.paper', borderTop: 1, borderColor: 'divider' }\n      : bandSx(scope.band),\n    [container],\n    'footer',\n  )\n}\n"],"names":["AI_ICON_LIBRARY","AI_LAYOUT_MAX_IMAGES","bandSx","compileFlow","compileRow","destinationProps","aiLayoutFitText","AI_LAYOUT_MAX_ITEMS","aiLayoutResolveLink","AiLayoutTreeBuilder","headerLook","band","props","color","sx","boxShadow","bgcolor","borderBottom","borderColor","aiLayoutIsCopyright","text","test","FOOTER_LEAVES_OUT","Set","frameScope","page","at","centered","index","level","headed","itemsLeft","frame","link","sections","from","formSection","aiCompileLayoutFrame","plan","targets","header","tree","title","siteName","pageId","options","reusableComponents","settled","scrollTo","images","strong","brand","dark","pageIcon","sparkle","formsPlaced","name","blocks","look","scope","navLink","entry","role","interactions","id","add","children","label","slice","screenId","renderAs","textDecoration","nodes","pages","navPages","filter","trim","centeredNav","align","length","brandSx","typography","fontWeight","whiteSpace","overflow","textOverflow","minWidth","flexGrow","homeId","variant","component","nav","ariaLabel","direction","spacing","alignItems","display","xs","md","map","ctaBlock","find","block","kind","push","what","ctaLabel","ctaTo","to","ctaProps","cta","sm","flexShrink","close","AI_LAYOUT_CLOSE_DRAWER","drawer","anchor","flexDirection","gap","p","fullWidth","mt","toggle","middle","justifyContent","row","maxWidth","columnGap","toolbar","disableGutters","minHeight","bar","position","slot","footer","compileFooter","column","prune","rootId","enabled","trigger","event","everyTime","steps","type","navItems","linksPages","flatMap","given","notice","item","items","some","has","pageLinks","cols","columns","col","undefined","Math","min","weights","filled","weight","top","copyright","bottom","pt","borderTop","stack","container","py","element","colorScheme"],"mappings":"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"}

package/src/lib/layout-language/ai-layout-gaps.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { NodesMap } from '@aglyn/aglyn/types/nodes';
+import { type AiDoctrineViolation } from '../runtime/ai-doctrine-validators';
+/** The violation code a gap is named by. */
+export declare const AI_LAYOUT_GAP_CODE = "layout-gap";
+/** The gaps a language-built page or frame carries, as the violation that asks again. */
+export declare function aiLayoutGapViolations(nodes: NodesMap): AiDoctrineViolation[];
+/** The page or frame with every gap taken out, and what was taken. */
+export declare function aiLayoutWithoutGaps(input: NodesMap, rootId: string): {
+    nodes: NodesMap;
+    dropped: string[];
+};
+/**
+ * What a link may name, which never belongs in words a visitor reads: the
+ * site's pages, with the title a reference to one is written as, and every
+ * other id the page or frame was built against (its forms, components and
+ * sections).
+ */
+export interface AiLayoutRefNames {
+    pages: ReadonlyArray<{
+        id: string;
+        label: string;
+    }>;
+    ids: readonly string[];
+}
+/** The violation code an internal reference in copy is named by. */
+export declare const AI_LAYOUT_REF_CODE = "layout-internal-ref";
+/** Internal references in a language-built page's or frame's words, as the violation that asks again. */
+export declare function aiLayoutRefViolations(nodes: NodesMap, names: AiLayoutRefNames): AiDoctrineViolation[];
+/**
+ * The page or frame with no internal reference in its words: a page's
+ * reference is written as that page's title, and a line that still names a
+ * reference is taken out, as a gap is. Returns what was rewritten and taken.
+ */
+export declare function aiLayoutWithoutRefs(input: NodesMap, rootId: string, names: AiLayoutRefNames): {
+    nodes: NodesMap;
+    dropped: string[];
+};
+/**
+ * A language-built page's or frame's words held to both (AGL-3660): before
+ * the last answer, each gap and each internal reference is a violation that
+ * asks again; in the last, they are taken out and the rest is kept.
+ */
+export declare function aiLayoutCopyCheck(input: NodesMap, rootId: string, names: AiLayoutRefNames, last: boolean): {
+    nodes: NodesMap;
+    dropped: string[];
+    violations: AiDoctrineViolation[];
+};