@aglyn/plugins-ai 1.0.0-beta.292 → 1.0.0-beta.293

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

@@ -31,6 +31,10 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
     'muiMegaMenu'
 ]);
 const LINK = 'muiScreenLink';
+/** What a menu's entry may be: a Page Link, or a Link Container holding a name and the line under it (AGL-4108). */ const MENU_LINKS = new Set([
+    LINK,
+    'muiLinkBox'
+]);
 /** Frames that hold content without being it: the language's, and a plain element. */ const HOLDERS = new Set([
     ...AI_LAYOUT_FRAMES,
     'div',
@@ -127,7 +131,7 @@ function inspect(map) {
     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));
+    ].filter((id)=>DROPDOWNS.has(String(map[id].componentId)) && !subtree(id).some((at)=>at !== id && MENU_LINKS.has(String(map[at].componentId))));
     return {
         footerColumns,
         footerHeadings,

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

@@ -1 +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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"}
+{"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/** What a menu's entry may be: a Page Link, or a Link Container holding a name and the line under it (AGL-4108). */\nconst MENU_LINKS: ReadonlySet<string> = new Set([LINK, 'muiLinkBox'])\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 && MENU_LINKS.has(String(map[at].componentId))),\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","MENU_LINKS","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-source.d.ts

@@ -0,0 +1,196 @@
+/**
+ * @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 { AiLayoutTreeBuilder } from './ai-layout-tree';
+/** How a source's button is drawn: filled, outlined, or as text. */
+export type AiLayoutFrameSourceStyle = 'primary' | 'secondary' | 'quiet';
+/**
+ * Where a link of a source's header or footer goes: `page:<id>` for a page of
+ * the site, a path on the site (`/pricing`) for a page still to come in, or
+ * the source's own address (`https:`, `mailto:`, `tel:`) for anywhere else.
+ */
+export type AiLayoutFrameSourceTo = string;
+export interface AiLayoutFrameSourceLink {
+    label: string;
+    to: AiLayoutFrameSourceTo;
+}
+/** One entry of a menu. */
+export interface AiLayoutFrameSourceEntry extends AiLayoutFrameSourceLink {
+    /** The line under it in a mega menu. */
+    text?: string;
+    /** Its icon, drawn on a 24-unit square. */
+    iconPath?: string;
+    /** The heading of the menu's column it sits in. */
+    column?: string;
+}
+/** A top-level item: a link, or a menu of entries under a name. */
+export interface AiLayoutFrameSourceGroup {
+    label: string;
+    /** Where the name itself goes; `null` when it only opens its menu. */
+    to: AiLayoutFrameSourceTo | null;
+    /** Empty for a plain link. */
+    items: AiLayoutFrameSourceEntry[];
+}
+export interface AiLayoutFrameSourceCta extends AiLayoutFrameSourceLink {
+    style: AiLayoutFrameSourceStyle;
+}
+export interface AiLayoutFrameSourceFooter {
+    columns: Array<{
+        heading: string;
+        links: AiLayoutFrameSourceLink[];
+    }>;
+    /** Links outside any column and not a profile (Privacy, Terms). */
+    links: AiLayoutFrameSourceLink[];
+    /** Its lines of words outside links, as written. */
+    text: string[];
+    /** Its profiles on other sites, by network. */
+    social: Array<AiLayoutFrameSourceLink & {
+        network: string;
+    }>;
+    address: string | null;
+    phone: string | null;
+    email: string | null;
+    /** Its © line, word for word. */
+    copyright: string | null;
+}
+/**
+ * What the source's header bar sits on: the page's own ground, paper, the
+ * brand color, or a dark band.
+ */
+export type AiLayoutFrameSourceGround = 'page' | 'paper' | 'brand' | 'dark';
+/** A header and footer as the source builds them (AGL-4108). */
+export interface AiLayoutFrameSource {
+    nav: AiLayoutFrameSourceGroup[];
+    ctas: AiLayoutFrameSourceCta[];
+    header: AiLayoutFrameSourceGround;
+    footer: AiLayoutFrameSourceFooter | null;
+}
+/** The most kept of each part: the reader's own limits, held again on the way in. */
+export declare const AI_LAYOUT_FRAME_SOURCE_LIMITS: {
+    readonly groups: 12;
+    readonly entries: 40;
+    readonly ctas: 4;
+    readonly columns: 12;
+    readonly links: 60;
+    readonly text: 12;
+    readonly social: 20;
+    readonly label: 120;
+    readonly line: 300;
+};
+/** Whether a destination is one a link of the frame may carry. */
+export declare function aiLayoutFrameSourceToAllowed(to: unknown): to is AiLayoutFrameSourceTo;
+/**
+ * A source frame as a job carries it, read defensively: every label cut to
+ * its limit, every destination one a link may carry, every icon one path.
+ * `null` where it holds no menu item and no button to draw.
+ */
+export declare function aiLayoutFrameSourceOf(raw: unknown): AiLayoutFrameSource | null;
+/** The pages a source frame links by id, each once. */
+export declare function aiLayoutFrameSourcePageIds(source: AiLayoutFrameSource): string[];
+/** A link's props for where it goes: a page by its id, anywhere else by its address. */
+export declare function aiLayoutFrameSourceLinkProps(to: AiLayoutFrameSourceTo): Record<string, unknown>;
+/**
+ * The widths the header row is held to, in CSS pixels: a character of a
+ * label at the body size, the chevron a menu's trigger carries, the gap
+ * between the row's items and between its buttons, a button's padding, and
+ * the row's room at each breakpoint (the Container's `lg` width less its
+ * gutters).
+ */
+export declare const AI_LAYOUT_HEADER_MEASURE: {
+    readonly char: 9;
+    readonly chevron: 28;
+    readonly gap: 24;
+    readonly buttonGap: 8;
+    readonly padding: {
+        readonly primary: 32;
+        readonly secondary: 32;
+        readonly quiet: 16;
+    };
+    readonly room: {
+        readonly md: number;
+        readonly lg: number;
+    };
+    /** What share of the room the row may fill: the estimate is a character's average, so it keeps a margin. */
+    readonly fill: 0.9;
+    /** A logo's width where its picture's shape is unknown. */
+    readonly logo: 160;
+};
+/** The header row's width in CSS pixels, its brand, its menu and its buttons side by side. */
+export declare function aiLayoutHeaderRowWidth(input: {
+    brandWidth: number;
+    nav: ReadonlyArray<{
+        label: string;
+        menu: boolean;
+    }>;
+    ctas: ReadonlyArray<{
+        label: string;
+        style: AiLayoutFrameSourceStyle;
+    }>;
+}): number;
+/**
+ * The screen width the menu row shows from (AGL-4108): `md` where it fits a
+ * 900-pixel screen with room to spare, else `lg`; and `lg` whatever it
+ * measures for a row of more than five items or more than 60 characters.
+ * Below it the row is the phone menu's button.
+ */
+export declare function aiLayoutNavBreakpoint(input: Parameters<typeof aiLayoutHeaderRowWidth>[0]): 'md' | 'lg';
+/** A source's header row as `aiLayoutHeaderRowWidth` measures it. */
+export declare function aiLayoutFrameSourceRow(source: Pick<AiLayoutFrameSource, 'nav' | 'ctas'>, brandWidth: number): Parameters<typeof aiLayoutHeaderRowWidth>[0];
+/** A column of a menu: its heading, where its entries have one, and its entries. */
+interface MenuColumn {
+    heading: string | null;
+    entries: AiLayoutFrameSourceEntry[];
+}
+/** A menu's entries in the columns the source sets them in, in order; a long unheaded run in two. */
+export declare function aiLayoutMenuColumns(entries: readonly AiLayoutFrameSourceEntry[]): MenuColumn[];
+/** Whether a menu is drawn as a Mega Menu: its entries carry a line under them, or sit in more than one headed column. */
+export declare function aiLayoutMenuIsMega(group: Pick<AiLayoutFrameSourceGroup, 'items'>): boolean;
+export interface AiLayoutSourceHeader {
+    /** The menu row, shown from `breakpoint` up; `null` with no item to show. */
+    nav: string | null;
+    /** The buttons beside it; `null` with none. */
+    ctas: string | null;
+    /** The phone menu's contents, in order. */
+    drawer: string[];
+    breakpoint: 'md' | 'lg';
+}
+/**
+ * The source's header drawn (AGL-4108): its menu row, its buttons and its
+ * phone menu. `close` is the interaction a link of the phone menu closes it
+ * with.
+ */
+export declare function aiLayoutSourceHeader(tree: AiLayoutTreeBuilder, source: AiLayoutFrameSource, input: {
+    onBrand: boolean;
+    close: unknown[];
+    brandWidth: number;
+}): AiLayoutSourceHeader;
+/**
+ * The page a menu's own name opens, where none of its entries does: a page
+ * of the site, never an address elsewhere (a Squarespace folder's address
+ * is no page). `null` otherwise.
+ */
+export declare function aiLayoutMenuOwnPage(group: Pick<AiLayoutFrameSourceGroup, 'to' | 'items'>): AiLayoutFrameSourceTo | null;
+/** A phone number as a link that calls it: its digits, a `+` only first; `null` where it is no number. */
+export declare function aiLayoutTelHref(phone: string): string | null;
+/** The source's footer drawn (AGL-4108): its words and profiles beside its columns, its © line and other links under a rule. */
+export declare function aiLayoutSourceFooter(tree: AiLayoutTreeBuilder, footer: AiLayoutFrameSourceFooter, input: {
+    name: string;
+}): {
+    top: string | null;
+    bottom: string;
+    sx: Record<string, unknown>;
+};
+export {};