@aglyn/plugins-ai 1.0.0-beta.244 → 1.0.0-beta.247

package/src/lib/layout-language/ai-layout-frame-hollows.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @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.
+ */
+/** What is still hollow in a frame: the node ids, by kind. */
+export interface AiLayoutFrameHollows {
+    /** Footer grid columns holding nothing, or nothing but headings. */
+    footerColumns: string[];
+    /** Footer headings with nothing under them. */
+    footerHeadings: string[];
+    /** Footer rows whose columns are centered against each other rather than top-aligned. */
+    footerCenteredRows: string[];
+    /** Header Dropdown Menus holding no link. */
+    headerMenus: string[];
+}
+/** What is still hollow in a frame (AGL-3735); every list empty when nothing is. */
+export declare function aiLayoutFrameHollows(nodes: Readonly<Record<string, unknown>>): AiLayoutFrameHollows;
+/** Whether a frame has anything hollow in it. */
+export declare function aiLayoutFrameIsHollow(hollows: AiLayoutFrameHollows): boolean;
+/** The sentences a check reports for what is hollow. */
+export declare function aiLayoutFrameHollowsSaid(hollows: AiLayoutFrameHollows): string[];
+/**
+ * Takes what is hollow out of a frame, IN PLACE (AGL-3735): see the file's
+ * comment. Returns whether anything changed. A frame left holding nothing is
+ * taken out after it, up to the row, the footer's or the header's own element.
+ */
+export declare function aiLayoutRepairFrameHollows(nodes: Record<string, unknown>): boolean;
+/** A frame with what is hollow taken out (AGL-3735), as a copy; `null` when nothing was. */
+export declare function aiLayoutWithoutFrameHollows<T extends Readonly<Record<string, unknown>>>(nodes: T): T | null;

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

@@ -0,0 +1,330 @@
+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_LAYOUT_FRAMES, aiLayoutSpans } from "./ai-layout-tree.js";
+/** A Typography variant that heads what follows it, never content of its own. */ const HEADING_VARIANTS = new Set([
+    'h1',
+    'h2',
+    'h3',
+    'h4',
+    'h5',
+    'h6',
+    'subtitle1',
+    'subtitle2',
+    'overline'
+]);
+/** The Besigner's Dropdown Menu and Mega Menu. */ const DROPDOWNS = new Set([
+    'muiNavMenu',
+    'muiMegaMenu'
+]);
+const LINK = 'muiScreenLink';
+/** Frames that hold content without being it: the language's, and a plain element. */ const HOLDERS = new Set([
+    ...AI_LAYOUT_FRAMES,
+    'div',
+    'span',
+    'muiGrid'
+]);
+const renders = (node, element)=>{
+    var _node_props, _node_props1;
+    return ((_node_props = node.props) == null ? void 0 : _node_props['element']) === element || ((_node_props1 = node.props) == null ? void 0 : _node_props1['component']) === element || node.componentId === element;
+};
+const isHeading = (node)=>{
+    var _ref;
+    var _node_props;
+    return !!node && node.componentId === 'muiTypography' && HEADING_VARIANTS.has(String((_ref = (_node_props = node.props) == null ? void 0 : _node_props['variant']) != null ? _ref : ''));
+};
+function inspect(map) {
+    const subtree = (id)=>{
+        const out = [];
+        const visit = (at)=>{
+            var _map_at_nodes;
+            if (!map[at] || out.includes(at)) return;
+            out.push(at);
+            for (const child of (_map_at_nodes = map[at].nodes) != null ? _map_at_nodes : [])visit(child);
+        };
+        visit(id);
+        return out;
+    };
+    /** The leaves under a node, in document order: what a visitor reads. */ const leaves = (id)=>subtree(id).filter((at)=>{
+            var _node_nodes;
+            const node = map[at];
+            return !((_node_nodes = node.nodes) != null ? _node_nodes : []).some((child)=>map[child]) && !HOLDERS.has(String(node.componentId));
+        });
+    const footers = Object.keys(map).filter((id)=>renders(map[id], 'footer'));
+    const headers = Object.keys(map).filter((id)=>map[id].componentId === 'muiAppBar' || renders(map[id], 'header'));
+    const footerIds = new Set(footers.flatMap(subtree));
+    const rows = [
+        ...footerIds
+    ].filter((id)=>{
+        var _map_id_props;
+        return map[id].componentId === 'muiGrid' && ((_map_id_props = map[id].props) == null ? void 0 : _map_id_props['container']);
+    });
+    const columns = rows.flatMap((row)=>{
+        var _map_row_nodes;
+        return ((_map_row_nodes = map[row].nodes) != null ? _map_row_nodes : []).filter((id)=>{
+            var _map_id;
+            return ((_map_id = map[id]) == null ? void 0 : _map_id.componentId) === 'muiGrid';
+        });
+    });
+    const footerColumns = columns.filter((id)=>leaves(id).every((leaf)=>isHeading(map[leaf])));
+    // The Tidewater shape: a column of only a heading, then a column of only
+    // links with no heading. The links are what the heading heads.
+    const merges = [];
+    for (const row of rows){
+        var _map_row_nodes;
+        const inRow = ((_map_row_nodes = map[row].nodes) != null ? _map_row_nodes : []).filter((id)=>{
+            var _map_id;
+            return ((_map_id = map[id]) == null ? void 0 : _map_id.componentId) === 'muiGrid';
+        });
+        inRow.forEach((id, at)=>{
+            const next = inRow[at + 1];
+            if (!next || !footerColumns.includes(id) || !leaves(id).length) return;
+            const read = leaves(next);
+            if (read.length && read.every((leaf)=>map[leaf].componentId === LINK)) merges.push({
+                heading: id,
+                links: next
+            });
+        });
+    }
+    // A heading is hollow when nothing but headings follow it before the next
+    // heading of its own (an overline labels the heading after it, so it
+    // reaches one heading further).
+    const footerHeadings = [];
+    const flows = columns.length ? columns : footers;
+    for (const flow of flows){
+        if (footerColumns.includes(flow)) continue;
+        const read = leaves(flow);
+        read.forEach((id, at)=>{
+            var _map_id_props;
+            if (!isHeading(map[id])) return;
+            let headingsLeft = ((_map_id_props = map[id].props) == null ? void 0 : _map_id_props['variant']) === 'overline' ? 2 : 1;
+            for (const next of read.slice(at + 1)){
+                var _map_next_props;
+                if (!isHeading(map[next])) return;
+                if (((_map_next_props = map[next].props) == null ? void 0 : _map_next_props['variant']) !== 'overline') headingsLeft -= 1;
+                if (headingsLeft <= 0) break;
+            }
+            footerHeadings.push(id);
+        });
+    }
+    const footerCenteredRows = rows.filter((id)=>{
+        var _map_id_sx;
+        return ((_map_id_sx = map[id].sx) == null ? void 0 : _map_id_sx['alignItems']) === 'center';
+    });
+    const headerIds = new Set(headers.flatMap(subtree));
+    const headerMenus = [
+        ...headerIds
+    ].filter((id)=>DROPDOWNS.has(String(map[id].componentId)) && !subtree(id).some((at)=>at !== id && map[at].componentId === LINK));
+    return {
+        footerColumns,
+        footerHeadings,
+        footerCenteredRows,
+        headerMenus,
+        rows,
+        merges
+    };
+}
+/** What is still hollow in a frame (AGL-3735); every list empty when nothing is. */ export function aiLayoutFrameHollows(nodes) {
+    const { footerColumns, footerHeadings, footerCenteredRows, headerMenus } = inspect(nodes);
+    return {
+        footerColumns,
+        footerHeadings,
+        footerCenteredRows,
+        headerMenus
+    };
+}
+/** Whether a frame has anything hollow in it. */ export function aiLayoutFrameIsHollow(hollows) {
+    return [
+        hollows.footerColumns,
+        hollows.footerHeadings,
+        hollows.footerCenteredRows,
+        hollows.headerMenus
+    ].some((ids)=>ids.length > 0);
+}
+/** The sentences a check reports for what is hollow. */ export function aiLayoutFrameHollowsSaid(hollows) {
+    return [
+        ...hollows.footerColumns.length ? [
+            `${hollows.footerColumns.length} footer column(s) hold only a heading or nothing`
+        ] : [],
+        ...hollows.footerHeadings.length ? [
+            `${hollows.footerHeadings.length} footer heading(s) have nothing under them`
+        ] : [],
+        ...hollows.footerCenteredRows.length ? [
+            'the footer’s columns are centered, not top-aligned'
+        ] : [],
+        ...hollows.headerMenus.length ? [
+            `${hollows.headerMenus.length} header dropdown(s) hold no link`
+        ] : []
+    ];
+}
+/**
+ * Takes what is hollow out of a frame, IN PLACE (AGL-3735): see the file's
+ * comment. Returns whether anything changed. A frame left holding nothing is
+ * taken out after it, up to the row, the footer's or the header's own element.
+ */ export function aiLayoutRepairFrameHollows(nodes) {
+    const map = nodes;
+    let changed = false;
+    const parentOf = (id)=>{
+        var _Object_keys_find;
+        return (_Object_keys_find = Object.keys(map).find((at)=>{
+            var _map_at_nodes;
+            return (_map_at_nodes = map[at].nodes) == null ? void 0 : _map_at_nodes.includes(id);
+        })) != null ? _Object_keys_find : null;
+    };
+    const remove = (id)=>{
+        const tree = (at)=>{
+            var _ref;
+            var _map_at;
+            return [
+                at,
+                ...((_ref = (_map_at = map[at]) == null ? void 0 : _map_at.nodes) != null ? _ref : []).flatMap(tree)
+            ];
+        };
+        let parent = parentOf(id);
+        for (const at of tree(id))delete map[at];
+        // Up the tree: a frame that held only what went is gone with it.
+        let child = id;
+        while(parent && map[parent]){
+            var _node_nodes;
+            var _node_props;
+            const node = map[parent];
+            node.nodes = ((_node_nodes = node.nodes) != null ? _node_nodes : []).filter((at)=>at !== child);
+            const empty = !node.nodes.some((at)=>map[at]);
+            const stops = renders(node, 'footer') || renders(node, 'header') || node.componentId === 'muiAppBar' || node.componentId === 'muiGrid' && ((_node_props = node.props) == null ? void 0 : _node_props['container']);
+            if (!empty || stops || !HOLDERS.has(String(node.componentId))) break;
+            child = parent;
+            parent = parentOf(parent);
+            delete map[child];
+        }
+        changed = true;
+    };
+    for(let pass = 0; pass < 4; pass += 1){
+        const hollows = inspect(map);
+        if (!aiLayoutFrameIsHollow(hollows)) break;
+        for (const id of hollows.footerCenteredRows){
+            var _map_id_sx;
+            map[id].sx = _extends({}, (_map_id_sx = map[id].sx) != null ? _map_id_sx : {}, {
+                alignItems: 'flex-start'
+            });
+            changed = true;
+        }
+        for (const id of hollows.headerMenus)if (map[id]) remove(id);
+        const headed = new Set();
+        for (const merge of hollows.merges){
+            if (map[merge.heading] && map[merge.links] && headOver(map, merge)) {
+                headed.add(merge.heading);
+                changed = true;
+            }
+        }
+        for (const id of hollows.footerHeadings)if (map[id]) remove(id);
+        for (const id of hollows.footerColumns)if (map[id] && !headed.has(id)) remove(id);
+        // Every row that lost a column, however it lost it, reflows.
+        for (const row of hollows.rows)if (map[row] && reflow(map, row)) changed = true;
+    }
+    return changed;
+}
+/**
+ * A heading-only column takes in the heading-less column of links after it,
+ * as one flow (heading, then links), and the links' column goes; whether it
+ * changed. The row it leaves one column short reflows after.
+ */ function headOver(map, { heading, links }) {
+    var _map_links_nodes, _map_heading_nodes;
+    const moved = ((_map_links_nodes = map[links].nodes) != null ? _map_links_nodes : []).filter((id)=>map[id]);
+    if (!moved.length) return false;
+    const own = ((_map_heading_nodes = map[heading].nodes) != null ? _map_heading_nodes : []).filter((id)=>map[id]);
+    const flow = own.length === 1 && map[own[0]].componentId === 'muiStack' ? own[0] : null;
+    if (flow) {
+        var _map_flow_nodes;
+        map[flow].nodes = [
+            ...(_map_flow_nodes = map[flow].nodes) != null ? _map_flow_nodes : [],
+            ...moved
+        ];
+    } else {
+        let id = `${heading}-flow`;
+        for(let n = 2; map[id]; n += 1)id = `${heading}-flow${n}`;
+        // The compiler's flow of a column (`compileFlow`): a stack, 2.5 apart.
+        map[id] = {
+            componentId: 'muiStack',
+            props: {
+                spacing: '2.5'
+            },
+            nodes: [
+                ...own,
+                ...moved
+            ]
+        };
+        map[heading].nodes = [
+            id
+        ];
+    }
+    delete map[links];
+    for (const node of Object.values(map)){
+        var _node_nodes;
+        if ((_node_nodes = node.nodes) == null ? void 0 : _node_nodes.includes(links)) node.nodes = node.nodes.filter((at)=>at !== links);
+    }
+    return true;
+}
+/** The columns a row has left, spread across its twelve as their widths were; whether it changed. */ function reflow(map, row) {
+    var _map_row_nodes, _ref;
+    var _map_columns__props, _map_row_props, _map_row_props1;
+    const columns = ((_map_row_nodes = map[row].nodes) != null ? _map_row_nodes : []).filter((id)=>{
+        var _map_id;
+        return ((_map_id = map[id]) == null ? void 0 : _map_id.componentId) === 'muiGrid';
+    });
+    const md = columns.map((id)=>{
+        var _ref;
+        var _exec, _map_id_props;
+        return (_exec = /(?:^|\s)md:(\d+)/.exec(String((_ref = (_map_id_props = map[id].props) == null ? void 0 : _map_id_props['size']) != null ? _ref : ''))) == null ? void 0 : _exec[1];
+    });
+    if (!columns.length || md.some((span)=>!span)) return false;
+    // A row whose columns fill it, as many as it was drawn for, is as it was drawn.
+    const drawnFor = /sm:6/.test(String((_ref = (_map_columns__props = map[columns[0]].props) == null ? void 0 : _map_columns__props['size']) != null ? _ref : '')) ? 4 : 3;
+    if (md.reduce((sum, span)=>sum + Number(span), 0) === 12 && columns.length >= 4 === (drawnFor === 4)) return false;
+    const spans = columns.length === 1 ? [
+        12
+    ] : aiLayoutSpans(md.map(Number));
+    columns.forEach((id, at)=>{
+        var _map_id_props;
+        map[id].props = _extends({}, (_map_id_props = map[id].props) != null ? _map_id_props : {}, {
+            size: `${columns.length >= 4 ? 'xs:12 sm:6' : 'xs:12'} md:${spans[at]}`
+        });
+    });
+    // The compiler's row spacing for that many columns (`compileRow`).
+    if (((_map_row_props = map[row].props) == null ? void 0 : _map_row_props['spacing']) === '4' || ((_map_row_props1 = map[row].props) == null ? void 0 : _map_row_props1['spacing']) === '6') {
+        map[row].props = _extends({}, map[row].props, {
+            spacing: columns.length >= 3 ? '4' : '6'
+        });
+    }
+    return true;
+}
+/** A frame with what is hollow taken out (AGL-3735), as a copy; `null` when nothing was. */ export function aiLayoutWithoutFrameHollows(nodes) {
+    const copy = {};
+    for (const [id, raw] of Object.entries(nodes)){
+        const node = raw;
+        copy[id] = node && typeof node === 'object' ? _extends({}, node, node.props ? {
+            props: _extends({}, node.props)
+        } : {}, node.sx ? {
+            sx: _extends({}, node.sx)
+        } : {}, node.nodes ? {
+            nodes: [
+                ...node.nodes
+            ]
+        } : {}) : node;
+    }
+    return aiLayoutRepairFrameHollows(copy) ? copy : null;
+}
+
+//# sourceMappingURL=ai-layout-frame-hollows.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/layout-language/ai-layout-frame-hollows.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_LAYOUT_FRAMES, aiLayoutSpans } from './ai-layout-tree'\n\n/**\n * A FRAME WITH NOTHING HOLLOW IN IT (AGL-3735).\n *\n * The live Tidewater Soap Works footer (job S0vnUzhGar, 10/11) had four\n * columns: the brand, \"Shop\" over the site's pages, \"Our shop\" over NOTHING,\n * and the store's account and policy links under no heading — the list the\n * design put under \"Our shop\" was left out, its heading and column stayed,\n * and the grid centered the columns so each sat at its own height.\n *\n * A heading with nothing under it, and a column with nothing but headings,\n * is never published. So, wherever the frame's links change — the compiler,\n * a publish taking out links to pages that were never written, a menu change\n * taking a link out — and once more on what a publish writes:\n *\n *  - in the footer, a column of only a heading followed by a column of only\n *    links with no heading (the Tidewater shape) becomes one column: the\n *    heading over those links;\n *  - then a heading with no content under it is taken out, then a column\n *    holding nothing (or nothing but headings) is, and the columns left\n *    reflow across the row's twelve;\n *  - the footer's rows are top-aligned;\n *  - in the header, a Dropdown Menu left holding no link is taken out.\n *\n * `aiLayoutFrameHollows` is the check: what is still hollow.\n *\n * Pure over a node map (`{ id: { componentId, props, sx, nodes } }`) — the\n * compiler's, a stored version's, or a publish's working copy.\n */\n\ninterface HollowNode {\n  componentId?: string\n  props?: Record<string, unknown>\n  sx?: Record<string, unknown>\n  nodes?: string[]\n  [key: string]: unknown\n}\n\ntype NodeMap = Record<string, HollowNode>\n\n/** A Typography variant that heads what follows it, never content of its own. */\nconst HEADING_VARIANTS: ReadonlySet<string> = new Set(['h1', 'h2', 'h3', 'h4', 'h5', 'h6', 'subtitle1', 'subtitle2', 'overline'])\n/** The Besigner's Dropdown Menu and Mega Menu. */\nconst DROPDOWNS: ReadonlySet<string> = new Set(['muiNavMenu', 'muiMegaMenu'])\nconst LINK = 'muiScreenLink'\n/** Frames that hold content without being it: the language's, and a plain element. */\nconst HOLDERS: ReadonlySet<string> = new Set([...AI_LAYOUT_FRAMES, 'div', 'span', 'muiGrid'])\n\nconst renders = (node: HollowNode, element: string) =>\n  node.props?.['element'] === element || node.props?.['component'] === element || node.componentId === element\n\nconst isHeading = (node: HollowNode | undefined) =>\n  !!node && node.componentId === 'muiTypography' && HEADING_VARIANTS.has(String(node.props?.['variant'] ?? ''))\n\n/** What is still hollow in a frame: the node ids, by kind. */\nexport interface AiLayoutFrameHollows {\n  /** Footer grid columns holding nothing, or nothing but headings. */\n  footerColumns: string[]\n  /** Footer headings with nothing under them. */\n  footerHeadings: string[]\n  /** Footer rows whose columns are centered against each other rather than top-aligned. */\n  footerCenteredRows: string[]\n  /** Header Dropdown Menus holding no link. */\n  headerMenus: string[]\n}\n\n/** A heading-only footer column and the heading-less column of links right after it, which it heads. */\ninterface HeadingOverLinks {\n  heading: string\n  links: string\n}\n\nfunction inspect(map: NodeMap): AiLayoutFrameHollows & { rows: string[]; merges: HeadingOverLinks[] } {\n  const subtree = (id: string): string[] => {\n    const out: string[] = []\n    const visit = (at: string) => {\n      if (!map[at] || out.includes(at)) return\n      out.push(at)\n      for (const child of map[at].nodes ?? []) visit(child)\n    }\n    visit(id)\n    return out\n  }\n  /** The leaves under a node, in document order: what a visitor reads. */\n  const leaves = (id: string) =>\n    subtree(id).filter((at) => {\n      const node = map[at]\n      return !(node.nodes ?? []).some((child) => map[child]) && !HOLDERS.has(String(node.componentId))\n    })\n  const footers = Object.keys(map).filter((id) => renders(map[id], 'footer'))\n  const headers = Object.keys(map).filter((id) => map[id].componentId === 'muiAppBar' || renders(map[id], 'header'))\n\n  const footerIds = new Set(footers.flatMap(subtree))\n  const rows = [...footerIds].filter((id) => map[id].componentId === 'muiGrid' && map[id].props?.['container'])\n  const columns = rows.flatMap((row) => (map[row].nodes ?? []).filter((id) => map[id]?.componentId === 'muiGrid'))\n  const footerColumns = columns.filter((id) => leaves(id).every((leaf) => isHeading(map[leaf])))\n  // The Tidewater shape: a column of only a heading, then a column of only\n  // links with no heading. The links are what the heading heads.\n  const merges: HeadingOverLinks[] = []\n  for (const row of rows) {\n    const inRow = (map[row].nodes ?? []).filter((id) => map[id]?.componentId === 'muiGrid')\n    inRow.forEach((id, at) => {\n      const next = inRow[at + 1]\n      if (!next || !footerColumns.includes(id) || !leaves(id).length) return\n      const read = leaves(next)\n      if (read.length && read.every((leaf) => map[leaf].componentId === LINK)) merges.push({ heading: id, links: next })\n    })\n  }\n  // A heading is hollow when nothing but headings follow it before the next\n  // heading of its own (an overline labels the heading after it, so it\n  // reaches one heading further).\n  const footerHeadings: string[] = []\n  const flows = columns.length ? columns : footers\n  for (const flow of flows) {\n    if (footerColumns.includes(flow)) continue\n    const read = leaves(flow)\n    read.forEach((id, at) => {\n      if (!isHeading(map[id])) return\n      let headingsLeft = map[id].props?.['variant'] === 'overline' ? 2 : 1\n      for (const next of read.slice(at + 1)) {\n        if (!isHeading(map[next])) return\n        if (map[next].props?.['variant'] !== 'overline') headingsLeft -= 1\n        if (headingsLeft <= 0) break\n      }\n      footerHeadings.push(id)\n    })\n  }\n  const footerCenteredRows = rows.filter((id) => map[id].sx?.['alignItems'] === 'center')\n  const headerIds = new Set(headers.flatMap(subtree))\n  const headerMenus = [...headerIds].filter(\n    (id) => DROPDOWNS.has(String(map[id].componentId)) && !subtree(id).some((at) => at !== id && map[at].componentId === LINK),\n  )\n  return { footerColumns, footerHeadings, footerCenteredRows, headerMenus, rows, merges }\n}\n\n/** What is still hollow in a frame (AGL-3735); every list empty when nothing is. */\nexport function aiLayoutFrameHollows(nodes: Readonly<Record<string, unknown>>): AiLayoutFrameHollows {\n  const { footerColumns, footerHeadings, footerCenteredRows, headerMenus } = inspect(nodes as NodeMap)\n  return { footerColumns, footerHeadings, footerCenteredRows, headerMenus }\n}\n\n/** Whether a frame has anything hollow in it. */\nexport function aiLayoutFrameIsHollow(hollows: AiLayoutFrameHollows): boolean {\n  return [hollows.footerColumns, hollows.footerHeadings, hollows.footerCenteredRows, hollows.headerMenus].some((ids) => ids.length > 0)\n}\n\n/** The sentences a check reports for what is hollow. */\nexport function aiLayoutFrameHollowsSaid(hollows: AiLayoutFrameHollows): string[] {\n  return [\n    ...(hollows.footerColumns.length ? [`${hollows.footerColumns.length} footer column(s) hold only a heading or nothing`] : []),\n    ...(hollows.footerHeadings.length ? [`${hollows.footerHeadings.length} footer heading(s) have nothing under them`] : []),\n    ...(hollows.footerCenteredRows.length ? ['the footer’s columns are centered, not top-aligned'] : []),\n    ...(hollows.headerMenus.length ? [`${hollows.headerMenus.length} header dropdown(s) hold no link`] : []),\n  ]\n}\n\n/**\n * Takes what is hollow out of a frame, IN PLACE (AGL-3735): see the file's\n * comment. Returns whether anything changed. A frame left holding nothing is\n * taken out after it, up to the row, the footer's or the header's own element.\n */\nexport function aiLayoutRepairFrameHollows(nodes: Record<string, unknown>): boolean {\n  const map = nodes as NodeMap\n  let changed = false\n  const parentOf = (id: string) => Object.keys(map).find((at) => map[at].nodes?.includes(id)) ?? null\n  const remove = (id: string) => {\n    const tree = (at: string): string[] => [at, ...(map[at]?.nodes ?? []).flatMap(tree)]\n    let parent = parentOf(id)\n    for (const at of tree(id)) delete map[at]\n    // Up the tree: a frame that held only what went is gone with it.\n    let child = id\n    while (parent && map[parent]) {\n      const node = map[parent]\n      node.nodes = (node.nodes ?? []).filter((at) => at !== child)\n      const empty = !node.nodes.some((at) => map[at])\n      const stops = renders(node, 'footer') || renders(node, 'header') || node.componentId === 'muiAppBar' || (node.componentId === 'muiGrid' && node.props?.['container'])\n      if (!empty || stops || !HOLDERS.has(String(node.componentId))) break\n      child = parent\n      parent = parentOf(parent)\n      delete map[child]\n    }\n    changed = true\n  }\n  for (let pass = 0; pass < 4; pass += 1) {\n    const hollows = inspect(map)\n    if (!aiLayoutFrameIsHollow(hollows)) break\n    for (const id of hollows.footerCenteredRows) {\n      map[id].sx = { ...(map[id].sx ?? {}), alignItems: 'flex-start' }\n      changed = true\n    }\n    for (const id of hollows.headerMenus) if (map[id]) remove(id)\n    const headed = new Set<string>()\n    for (const merge of hollows.merges) {\n      if (map[merge.heading] && map[merge.links] && headOver(map, merge)) {\n        headed.add(merge.heading)\n        changed = true\n      }\n    }\n    for (const id of hollows.footerHeadings) if (map[id]) remove(id)\n    for (const id of hollows.footerColumns) if (map[id] && !headed.has(id)) remove(id)\n    // Every row that lost a column, however it lost it, reflows.\n    for (const row of hollows.rows) if (map[row] && reflow(map, row)) changed = true\n  }\n  return changed\n}\n\n/**\n * A heading-only column takes in the heading-less column of links after it,\n * as one flow (heading, then links), and the links' column goes; whether it\n * changed. The row it leaves one column short reflows after.\n */\nfunction headOver(map: NodeMap, { heading, links }: HeadingOverLinks): boolean {\n  const moved = (map[links].nodes ?? []).filter((id) => map[id])\n  if (!moved.length) return false\n  const own = (map[heading].nodes ?? []).filter((id) => map[id])\n  const flow = own.length === 1 && map[own[0]].componentId === 'muiStack' ? own[0] : null\n  if (flow) {\n    map[flow].nodes = [...(map[flow].nodes ?? []), ...moved]\n  } else {\n    let id = `${heading}-flow`\n    for (let n = 2; map[id]; n += 1) id = `${heading}-flow${n}`\n    // The compiler's flow of a column (`compileFlow`): a stack, 2.5 apart.\n    map[id] = { componentId: 'muiStack', props: { spacing: '2.5' }, nodes: [...own, ...moved] }\n    map[heading].nodes = [id]\n  }\n  delete map[links]\n  for (const node of Object.values(map)) {\n    if (node.nodes?.includes(links)) node.nodes = node.nodes.filter((at) => at !== links)\n  }\n  return true\n}\n\n/** The columns a row has left, spread across its twelve as their widths were; whether it changed. */\nfunction reflow(map: NodeMap, row: string): boolean {\n  const columns = (map[row].nodes ?? []).filter((id) => map[id]?.componentId === 'muiGrid')\n  const md = columns.map((id) => /(?:^|\\s)md:(\\d+)/.exec(String(map[id].props?.['size'] ?? ''))?.[1])\n  if (!columns.length || md.some((span) => !span)) return false\n  // A row whose columns fill it, as many as it was drawn for, is as it was drawn.\n  const drawnFor = /sm:6/.test(String(map[columns[0]].props?.['size'] ?? '')) ? 4 : 3\n  if (md.reduce((sum, span) => sum + Number(span), 0) === 12 && (columns.length >= 4) === (drawnFor === 4)) return false\n  const spans = columns.length === 1 ? [12] : aiLayoutSpans(md.map(Number))\n  columns.forEach((id, at) => {\n    map[id].props = { ...(map[id].props ?? {}), size: `${columns.length >= 4 ? 'xs:12 sm:6' : 'xs:12'} md:${spans[at]}` }\n  })\n  // The compiler's row spacing for that many columns (`compileRow`).\n  if (map[row].props?.['spacing'] === '4' || map[row].props?.['spacing'] === '6') {\n    map[row].props = { ...map[row].props, spacing: columns.length >= 3 ? '4' : '6' }\n  }\n  return true\n}\n\n/** A frame with what is hollow taken out (AGL-3735), as a copy; `null` when nothing was. */\nexport function aiLayoutWithoutFrameHollows<T extends Readonly<Record<string, unknown>>>(nodes: T): T | null {\n  const copy: Record<string, unknown> = {}\n  for (const [id, raw] of Object.entries(nodes)) {\n    const node = raw as HollowNode\n    copy[id] =\n      node && typeof node === 'object'\n        ? { ...node, ...(node.props ? { props: { ...node.props } } : {}), ...(node.sx ? { sx: { ...node.sx } } : {}), ...(node.nodes ? { nodes: [...node.nodes] } : {}) }\n        : node\n  }\n  return aiLayoutRepairFrameHollows(copy) ? (copy as T) : null\n}\n"],"names":["AI_LAYOUT_FRAMES","aiLayoutSpans","HEADING_VARIANTS","Set","DROPDOWNS","LINK","HOLDERS","renders","node","element","props","componentId","isHeading","has","String","inspect","map","subtree","id","out","visit","at","includes","push","child","nodes","leaves","filter","some","footers","Object","keys","headers","footerIds","flatMap","rows","columns","row","footerColumns","every","leaf","merges","inRow","forEach","next","length","read","heading","links","footerHeadings","flows","flow","headingsLeft","slice","footerCenteredRows","sx","headerIds","headerMenus","aiLayoutFrameHollows","aiLayoutFrameIsHollow","hollows","ids","aiLayoutFrameHollowsSaid","aiLayoutRepairFrameHollows","changed","parentOf","find","remove","tree","parent","empty","stops","pass","alignItems","headed","merge","headOver","add","reflow","moved","own","n","spacing","values","md","exec","span","drawnFor","test","reduce","sum","Number","spans","size","aiLayoutWithoutFrameHollows","copy","raw","entries"],"mappings":"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"}

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

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 import type { AiStoreFrameLinks } from '../model/ai-site-store-pages';
-import { type AiLayoutSection, type AiLayoutSettlement } from './ai-layout-language';
+import { type AiLayoutBlock, type AiLayoutSection, type AiLayoutSettlement } from './ai-layout-language';
 import { type AiLayoutPage, type AiLayoutTargets } from './ai-layout-links';
 import { type AiLayoutRawTree } from './ai-layout-tree';
 /**
@@ -66,13 +66,15 @@ export interface AiLayoutFramePlan {
      * linked by their addresses, as the blog is.
      */
     storeLinks?: AiStoreFrameLinks | null;
+    /** The site's language (AGL-3760): the frame's own words are in it where `ai-layout-labels.ts` lists it. */
+    language?: string;
 }
-/** What the header's link to a store's account page says (AGL-3676). */
-export declare const AI_LAYOUT_ACCOUNT_LINK = "Account";
+/** What the header's link to a store's account page says (AGL-3676), in English. */
+export declare const AI_LAYOUT_ACCOUNT_LINK: "Account";
 /** What a store's announcement bar says where its design gave it no line (AGL-3676): true of every store. */
-export declare const AI_LAYOUT_STORE_ANNOUNCEMENT = "Shop the full collection";
+export declare const AI_LAYOUT_STORE_ANNOUNCEMENT: "Shop the full collection";
 /** The way into the shop beside the design's own announcement (AGL-3676). */
-export declare const AI_LAYOUT_STORE_ANNOUNCEMENT_LINK = "Shop now";
+export declare const AI_LAYOUT_STORE_ANNOUNCEMENT_LINK: "Shop now";
 export interface AiLayoutCompiledFrame {
     tree: AiLayoutRawTree;
     settled: AiLayoutSettlement[];
@@ -84,3 +86,20 @@ export declare function aiCompileLayoutFrame(frame: {
     header: AiLayoutSection | null;
     footer: AiLayoutSection | null;
 }, plan: AiLayoutFramePlan, targets: AiLayoutTargets): AiLayoutCompiledFrame;
+/** What a store's own column of account and policy links is headed where the footer design gave no store heading (AGL-3735). */
+export declare const AI_LAYOUT_STORE_FOOTER_HEADING: "Customer care";
+/**
+ * The footer heading a store's account and policy links go under
+ * (AGL-3735): a heading of the design's that names the store or its help
+ * ("Our shop", "Help", "Customer care"), the first with nothing under it
+ * before one with words or links of its own. Never the heading over the
+ * site's pages, whose list is the site's navigation. `end` is where the
+ * links go: the end of what that heading heads.
+ */
+export declare function aiLayoutFooterStoreHeading(columns: readonly AiLayoutBlock[][], navItems: readonly {
+    to: string;
+}[]): {
+    column: AiLayoutBlock[];
+    end: number;
+    heading: string;
+} | null;

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

@@ -17,13 +17,15 @@
 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 { aiLayoutRepairFrameHollows } from "./ai-layout-frame-hollows.js";
 import { AI_LAYOUT_CART_ELEMENT } from "./ai-layout-listings.js";
 import { AI_LAYOUT_MAX_ITEMS } from "./ai-layout-language.js";
+import { AI_LAYOUT_LABELS_EN, aiLayoutLabel } from "./ai-layout-labels.js";
 import { aiLayoutRenamedLabel, aiLayoutResolveLink } from "./ai-layout-links.js";
 import { AiLayoutTreeBuilder } from "./ai-layout-tree.js";
-/** What the header's link to a store's account page says (AGL-3676). */ export const AI_LAYOUT_ACCOUNT_LINK = 'Account';
-/** What a store's announcement bar says where its design gave it no line (AGL-3676): true of every store. */ export const AI_LAYOUT_STORE_ANNOUNCEMENT = 'Shop the full collection';
-/** The way into the shop beside the design's own announcement (AGL-3676). */ export const AI_LAYOUT_STORE_ANNOUNCEMENT_LINK = 'Shop now';
+/** What the header's link to a store's account page says (AGL-3676), in English. */ export const AI_LAYOUT_ACCOUNT_LINK = AI_LAYOUT_LABELS_EN.account;
+/** What a store's announcement bar says where its design gave it no line (AGL-3676): true of every store. */ export const AI_LAYOUT_STORE_ANNOUNCEMENT = AI_LAYOUT_LABELS_EN.storeAnnouncement;
+/** The way into the shop beside the design's own announcement (AGL-3676). */ export const AI_LAYOUT_STORE_ANNOUNCEMENT_LINK = AI_LAYOUT_LABELS_EN.shopNow;
 /** The header's colors by band, as palette roles. */ function headerLook(band) {
     if (band === 'brand') return {
         props: {
@@ -112,9 +114,11 @@ import { AiLayoutTreeBuilder } from "./ai-layout-tree.js";
             pageId: null
         }),
         // A footer is drawn compact: its lines are lines, never blocks rule 1 would ask to share.
-        options: {
+        options: _extends({
             reusableComponents: true
-        },
+        }, plan.language ? {
+            language: plan.language
+        } : {}),
         settled: [],
         scrollTo: {},
         // A frame's lines are its own, never a page section's items.
@@ -240,7 +244,7 @@ import { AiLayoutTreeBuilder } from "./ai-layout-tree.js";
     const accountPath = (_ref1 = (_plan_storeLinks1 = plan.storeLinks) == null ? void 0 : _plan_storeLinks1.account) != null ? _ref1 : null;
     const accountLink = (role, interactions, sx)=>{
         const id = tree.add('muiScreenLink', {
-            children: AI_LAYOUT_ACCOUNT_LINK,
+            children: aiLayoutLabel('account', plan.language),
             href: accountPath,
             renderAs: 'link',
             color: 'inherit'
@@ -352,7 +356,7 @@ import { AiLayoutTreeBuilder } from "./ai-layout-tree.js";
         });
         // The design's line, then the way into the shop; else the way in alone.
         const link = tree.add('muiScreenLink', {
-            children: said ? AI_LAYOUT_STORE_ANNOUNCEMENT_LINK : AI_LAYOUT_STORE_ANNOUNCEMENT,
+            children: aiLayoutLabel(said ? 'shopNow' : 'storeAnnouncement', plan.language),
             screenId: plan.shopId,
             renderAs: 'link',
             color: 'inherit'
@@ -390,6 +394,14 @@ import { AiLayoutTreeBuilder } from "./ai-layout-tree.js";
         flexGrow: 1
     }, null, 'slot');
     const footer = compileFooter(page, frame.footer, plan, name);
+    // No heading with nothing under it, no column of only a heading, columns
+    // top-aligned (AGL-3735): a list under a heading can compile to nothing.
+    if (aiLayoutRepairFrameHollows(tree.nodes)) {
+        page.settled.push({
+            at: 'footer',
+            what: 'a heading with nothing under it taken out, and its column with it'
+        });
+    }
     const column = tree.add('muiStack', null, {
         minHeight: '100vh'
     }, [
@@ -412,6 +424,49 @@ import { AiLayoutTreeBuilder } from "./ai-layout-tree.js";
         settled: page.settled
     };
 }
+/** What a store's own column of account and policy links is headed where the footer design gave no store heading (AGL-3735). */ export const AI_LAYOUT_STORE_FOOTER_HEADING = AI_LAYOUT_LABELS_EN.customerCare;
+/** A footer heading a store's account and policies belong under (AGL-3735). */ const STORE_HEADING = /\b(?:shop|store|shopping|help|customer|care|support|service|orders?|account|policies|policy|legal|info|information|shipping|returns)\b/i;
+/**
+ * The footer heading a store's account and policy links go under
+ * (AGL-3735): a heading of the design's that names the store or its help
+ * ("Our shop", "Help", "Customer care"), the first with nothing under it
+ * before one with words or links of its own. Never the heading over the
+ * site's pages, whose list is the site's navigation. `end` is where the
+ * links go: the end of what that heading heads.
+ */ export function aiLayoutFooterStoreHeading(columns, navItems) {
+    var _candidates_find;
+    const navTo = new Set(navItems.map((item)=>item.to));
+    const candidates = [];
+    for (const column of columns){
+        column.forEach((block, at)=>{
+            var _block_text;
+            if (block.kind !== 'heading' || !STORE_HEADING.test((_block_text = block.text) != null ? _block_text : '')) return;
+            let end = at + 1;
+            while(end < column.length && column[end].kind !== 'heading')end += 1;
+            const under = column.slice(at + 1, end);
+            const site = under.some((one)=>{
+                var _one_items;
+                return one.kind === 'list' && ((_one_items = one.items) != null ? _one_items : []).some((item)=>{
+                    var _item_to;
+                    return navTo.has((_item_to = item.to) != null ? _item_to : '');
+                });
+            });
+            if (site) return;
+            candidates.push({
+                column: column,
+                end,
+                heading: String(block.text),
+                empty: under.length === 0
+            });
+        });
+    }
+    const pick = (_candidates_find = candidates.find((one)=>one.empty)) != null ? _candidates_find : candidates[0];
+    return pick ? {
+        column: pick.column,
+        end: pick.end,
+        heading: pick.heading
+    } : null;
+}
 /** A link followed from the phone menu closes it. */ const AI_LAYOUT_CLOSE_DRAWER = {
     id: 'ai-close-menu',
     name: 'Close the menu',
@@ -522,20 +577,37 @@ import { AiLayoutTreeBuilder } from "./ai-layout-tree.js";
         ]);
         weights.push(1);
     }
-    // A store's account and policies (AGL-3676), as one more list beside the site's pages.
+    // A store's account and policies (AGL-3676): under the store heading the
+    // design already wrote ("Our shop", "Help"…), never as a column with no
+    // heading beside a heading with nothing under it (AGL-3735); where the
+    // design wrote none, a column of their own, headed.
     const storeLinks = (_ref2 = (_plan_storeLinks = plan.storeLinks) == null ? void 0 : _plan_storeLinks.footer) != null ? _ref2 : [];
     if (storeLinks.length) {
-        columns.push([
-            {
-                kind: 'list',
-                items: storeLinks.map((link)=>({
-                        title: link.label,
-                        text: '',
-                        to: `page:store:${link.href}`
-                    }))
-            }
-        ]);
-        weights.push(1);
+        const list = {
+            kind: 'list',
+            items: storeLinks.map((link)=>({
+                    title: link.label,
+                    text: '',
+                    to: `page:store:${link.href}`
+                }))
+        };
+        const home = aiLayoutFooterStoreHeading(columns, navItems);
+        if (home) {
+            home.column.splice(home.end, 0, list);
+            page.settled.push({
+                at: 'footer',
+                what: `the store's account and policy links under "${home.heading}"`
+            });
+        } else {
+            columns.push([
+                {
+                    kind: 'heading',
+                    text: aiLayoutLabel('customerCare', plan.language)
+                },
+                list
+            ]);
+            weights.push(1);
+        }
     }
     const filled = columns.map((column, position)=>{
         var _weights_position;
@@ -544,7 +616,8 @@ import { AiLayoutTreeBuilder } from "./ai-layout-tree.js";
             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;
+    // A footer's columns are top-aligned: each starts at its heading (AGL-3735).
+    const top = filled.length > 1 ? compileRow(scope, filled, 'flex-start') : filled.length === 1 ? compileFlow(scope, filled[0].column, 'full') : null;
     const copyright = tree.add('muiTypography', {
         children: `© ${name}`,
         variant: 'body2',