@aglyn/plugins-ai 1.0.0-beta.238 → 1.0.0-beta.240

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

@@ -266,12 +266,28 @@ function refsIn(text, names) {
     }
     return repeated;
 }
+/** A record's own token, which a repeat over a dataset fills per record when the page renders. */ const ITEM_TOKEN = /\{\{\s*item\.[A-Za-z][A-Za-z0-9_]*(?:\.[A-Za-z][A-Za-z0-9_]*)?\s*\}\}/g;
+/** Every node a repeat over a dataset copies once per record (AGL-3616), the repeating node included. */ function repeatedByDataset(nodes) {
+    const repeated = new Set();
+    for (const [id, node] of Object.entries(nodes)){
+        var _node_props;
+        const key = (_node_props = node.props) == null ? void 0 : _node_props['repeatDataset'];
+        if (typeof key !== 'string' || !key.trim()) continue;
+        for (const each of subtree(nodes, id))repeated.add(each);
+    }
+    return repeated;
+}
 function refsOf(nodes, names) {
     // A post's card names its post by the entry's tokens, which the page fills
     // per post: words a visitor reads as the post's own, never a reference.
+    // A dataset's card names its record by the record's, the same way (AGL-3616).
     const repeated = repeatedByEntries(nodes);
+    const records = repeatedByDataset(nodes);
     return Object.entries(nodes).flatMap(([id, node])=>{
-        const texts = shownTexts(node).map((slot)=>repeated.has(id) ? slot.get().replace(ENTRY_TOKEN, '') : slot.get());
+        const texts = shownTexts(node).map((slot)=>{
+            const text = repeated.has(id) ? slot.get().replace(ENTRY_TOKEN, '') : slot.get();
+            return records.has(id) ? text.replace(ITEM_TOKEN, '') : text;
+        });
         const refs = [
             ...new Set(texts.flatMap((text)=>refsIn(text, names)))
         ];

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/layout-language/ai-layout-gaps.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 type { NodesMap } from '@aglyn/aglyn/types/nodes'\nimport { aiBracketedFacts, type AiDoctrineViolation } from '../runtime/ai-doctrine-validators'\nimport { aiStoredScrollTargets } from '../runtime/ai-page-links'\n\n/**\n * No gap on a published page (AGL-3660). A guided start publishes what it\n * builds, so a fact the brief never gave — a phone number, an address, the\n * opening hours — is left out of a page or a frame built in the layout\n * language, never written as the bracketed gap (\"[phone number]\") a draft a\n * person edits first may carry. An answer holding one is asked again; the\n * last answer a generation takes has each one taken out instead: the line\n * that carries it, the row or card it leaves with nothing to say, and a\n * section left with only its heading.\n */\n\ninterface GapNode {\n  componentId: string\n  props?: Record<string, unknown>\n  nodes?: string[]\n}\n\ntype GapNodes = Record<string, GapNode>\n\n/** Props that hold no words a visitor reads: an icon's drawing is path data. */\nconst NOT_WORDS = new Set(['iconPath', 'iconId'])\n\n/** The props a node's own words are in. */\nconst WORD_PROPS = ['children', 'primary', 'secondary', 'label'] as const\n\n/** Elements that say something with no words of their own. */\nconst SPEAKS_ALONE = new Set([\n  'image',\n  'form',\n  'layoutSlot',\n  'reusableInstance',\n  'muiDrawerToggle',\n  'muiDrawer',\n  // The site's own records, listed by the elements that keep them (AGL-3676).\n  'product-grid',\n  'collectionEntries',\n  'cart',\n  // A music site's player, placed empty for the owner's tracks (AGL-3716).\n  'musicPlayer',\n])\n\nconst HEADING_VARIANTS = new Set(['h1', 'h2', 'h3', 'h4', 'h5', 'h6', 'overline'])\n\n/** The violation code a gap is named by. */\nexport const AI_LAYOUT_GAP_CODE = 'layout-gap'\n\n/** Every string a value holds, however deep, its icon drawings aside. */\nfunction stringsOf(value: unknown, key = ''): string[] {\n  if (NOT_WORDS.has(key)) return []\n  if (typeof value === 'string') return [value]\n  if (Array.isArray(value)) return value.flatMap((entry) => stringsOf(entry))\n  if (value && typeof value === 'object') {\n    return Object.entries(value as Record<string, unknown>).flatMap(([name, entry]) => stringsOf(entry, name))\n  }\n  return []\n}\n\n/** Each node whose words carry a gap, with the gaps it carries. */\nfunction gapsOf(nodes: GapNodes): Array<{ id: string; facts: string[]; text: string }> {\n  return Object.entries(nodes).flatMap(([id, node]) => {\n    const texts = stringsOf(node.props ?? {})\n    const facts = aiBracketedFacts(texts)\n    return facts.length ? [{ id, facts, text: texts.filter((text) => aiBracketedFacts([text]).length).join(' ') }] : []\n  })\n}\n\n/** The gaps a language-built page or frame carries, as the violation that asks again. */\nexport function aiLayoutGapViolations(nodes: NodesMap): AiDoctrineViolation[] {\n  const found = gapsOf(nodes as unknown as GapNodes)\n  if (!found.length) return []\n  const facts = aiBracketedFacts(found.flatMap((entry) => entry.facts))\n  return [\n    {\n      rule: 14,\n      code: AI_LAYOUT_GAP_CODE,\n      message: `${facts.join(', ')} ${facts.length === 1 ? 'is a gap' : 'are gaps'} for a fact the brief does not give, and this site is published exactly as written. Leave each fact out: write the sentence without it, and make no list line, card or contact row for it. Never write a gap in square brackets, and never invent the fact.`,\n      nodeIds: found.map((entry) => entry.id),\n    },\n  ]\n}\n\nfunction parentsOf(nodes: GapNodes): Map<string, string> {\n  const parents = new Map<string, string>()\n  for (const [id, node] of Object.entries(nodes)) for (const child of node.nodes ?? []) parents.set(child, id)\n  return parents\n}\n\nfunction subtree(nodes: GapNodes, id: string): string[] {\n  const ids: string[] = []\n  const stack = [id]\n  while (stack.length) {\n    const next = stack.pop() as string\n    if (!nodes[next] || ids.includes(next)) continue\n    ids.push(next)\n    stack.push(...(nodes[next].nodes ?? []))\n  }\n  return ids\n}\n\nfunction wordsOf(node: GapNode): string {\n  for (const prop of WORD_PROPS) {\n    const value = node.props?.[prop]\n    if (typeof value === 'string' && value.trim()) return value.trim()\n  }\n  return ''\n}\n\nfunction isHeading(node: GapNode): boolean {\n  if (node.componentId !== 'muiTypography') return false\n  return HEADING_VARIANTS.has(String(node.props?.['variant'] ?? '')) || /^h[1-6]$/.test(String(node.props?.['component'] ?? ''))\n}\n\n/** Whether anything under a node says something; with `beyondHeadings`, anything but a heading. */\nfunction speaks(nodes: GapNodes, id: string, beyondHeadings = false): boolean {\n  return subtree(nodes, id).some((each) => {\n    const node = nodes[each]\n    const says = SPEAKS_ALONE.has(node.componentId) || !!wordsOf(node)\n    return says && !(beyondHeadings && isHeading(node))\n  })\n}\n\n/** A node's props, its component's prop values copied too, so a rewrite never reaches the input. */\nfunction copyProps(props: Record<string, unknown>): Record<string, unknown> {\n  const values = props['propValues']\n  return values && typeof values === 'object' && !Array.isArray(values)\n    ? { ...props, propValues: { ...(values as Record<string, unknown>) } }\n    : { ...props }\n}\n\nfunction cloneNodes(input: NodesMap): GapNodes {\n  return Object.fromEntries(\n    Object.entries(input as unknown as GapNodes).map(([id, node]) => [\n      id,\n      {\n        ...node,\n        ...(node.props ? { props: copyProps(node.props) } : {}),\n        ...(node.nodes ? { nodes: [...node.nodes] } : {}),\n      },\n    ]),\n  )\n}\n\n/**\n * Takes each found node out, and each element above it left with nothing to\n * say, up to its section; a section other than the page's first left with\n * only its heading goes too, with any link that scrolled to it.\n */\nfunction pruneFound(nodes: GapNodes, rootId: string, found: ReadonlyArray<{ id: string; text: string }>): string[] {\n  const dropped: string[] = []\n  const sections = new Set(nodes[rootId]?.nodes ?? [])\n  const touched = new Set<string>()\n  const remove = (id: string) => {\n    const parent = parentsOf(nodes).get(id)\n    for (const each of subtree(nodes, id)) delete nodes[each]\n    if (parent && nodes[parent]) nodes[parent].nodes = (nodes[parent].nodes ?? []).filter((child) => child !== id)\n  }\n  /** Takes a node out, and each element above it it leaves with nothing to say, short of a section. */\n  const prune = (id: string) => {\n    const parents = parentsOf(nodes)\n    let section: string | undefined = id\n    while (section && !sections.has(section)) section = parents.get(section)\n    if (section && section !== id) touched.add(section)\n    let parent = parents.get(id)\n    remove(id)\n    while (parent && parent !== rootId && nodes[parent]) {\n      if (sections.has(parent) || speaks(nodes, parent)) break\n      const above = parentsOf(nodes).get(parent)\n      remove(parent)\n      parent = above\n    }\n  }\n  for (const entry of found) {\n    if (!nodes[entry.id]) continue\n    dropped.push(entry.text)\n    prune(entry.id)\n  }\n  const first = nodes[rootId]?.nodes?.[0]\n  for (const section of touched) {\n    if (section === first || !nodes[section] || speaks(nodes, section, true)) continue\n    const label = String(nodes[section].props?.['ariaLabel'] ?? section)\n    remove(section)\n    dropped.push(`the section \"${label}\", left with only its heading`)\n    for (const [id, node] of Object.entries(nodes)) {\n      if (nodes[id] && aiStoredScrollTargets(node).includes(section)) {\n        dropped.push(`\"${wordsOf(node)}\", a link to that section`)\n        prune(id)\n      }\n    }\n  }\n  return dropped\n}\n\n/** The page or frame with every gap taken out, and what was taken. */\nexport function aiLayoutWithoutGaps(input: NodesMap, rootId: string): { nodes: NodesMap; dropped: string[] } {\n  const found = gapsOf(input as unknown as GapNodes)\n  if (!found.length) return { nodes: input, dropped: [] }\n  const nodes = cloneNodes(input)\n  const dropped = pruneFound(nodes, rootId, found)\n  return { nodes: nodes as unknown as NodesMap, dropped }\n}\n\n// ── Internal references ─────────────────────────────────────────────────\n\n/**\n * What a link may name, which never belongs in words a visitor reads: the\n * site's pages, with the title a reference to one is written as, and every\n * other id the page or frame was built against (its forms, components and\n * sections).\n */\nexport interface AiLayoutRefNames {\n  pages: ReadonlyArray<{ id: string; label: string }>\n  ids: readonly string[]\n}\n\n/** The violation code an internal reference in copy is named by. */\nexport const AI_LAYOUT_REF_CODE = 'layout-internal-ref'\n\n/** A link's own notation, or a template token other than the site's own (`{{host.…}}`). */\nconst REF = /\\b(?:page|new|form|component|screen):[A-Za-z0-9_-]+|\\{\\{(?!\\s*host\\.)[^{}]*\\}\\}/g\nconst PAGE_REF = /\\bpage:([A-Za-z0-9_-]+)/g\n\n/** The props whose words a visitor reads, and a component's prop values. */\nconst SHOWN_PROPS = [...WORD_PROPS, 'alt', 'title']\n\nfunction shownTexts(node: GapNode): Array<{ get: () => string; set: (value: string) => void }> {\n  const props = node.props ?? {}\n  const slots: Array<{ get: () => string; set: (value: string) => void }> = []\n  for (const prop of SHOWN_PROPS) {\n    if (typeof props[prop] === 'string') slots.push({ get: () => props[prop] as string, set: (value) => (props[prop] = value) })\n  }\n  const values = props['propValues']\n  if (values && typeof values === 'object' && !Array.isArray(values)) {\n    const record = values as Record<string, unknown>\n    for (const name of Object.keys(record)) {\n      if (typeof record[name] === 'string') slots.push({ get: () => record[name] as string, set: (value) => (record[name] = value) })\n    }\n  }\n  return slots\n}\n\nfunction escapeRegExp(value: string): string {\n  return value.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')\n}\n\nfunction refsIn(text: string, names: AiLayoutRefNames): string[] {\n  const found = (text.match(REF) ?? []).map((ref) => ref.trim())\n  for (const id of names.ids) {\n    if (id.length >= 6 && new RegExp(`(^|[^A-Za-z0-9_-])${escapeRegExp(id)}($|[^A-Za-z0-9_-])`).test(text)) found.push(id)\n  }\n  return [...new Set(found)]\n}\n\n/** An entry's own token, which a collection repeater fills per entry when the page renders. */\nconst ENTRY_TOKEN = /\\{\\{\\s*entry\\.[A-Za-z]+\\s*\\}\\}/g\n\n/** Every node under a Collection Entries block: its template, repeated once per entry (AGL-3676). */\nfunction repeatedByEntries(nodes: GapNodes): Set<string> {\n  const repeated = new Set<string>()\n  for (const [id, node] of Object.entries(nodes)) {\n    if (node.componentId !== 'collectionEntries') continue\n    for (const each of subtree(nodes, id)) if (each !== id) repeated.add(each)\n  }\n  return repeated\n}\n\nfunction refsOf(nodes: GapNodes, names: AiLayoutRefNames): Array<{ id: string; refs: string[]; text: string }> {\n  // A post's card names its post by the entry's tokens, which the page fills\n  // per post: words a visitor reads as the post's own, never a reference.\n  const repeated = repeatedByEntries(nodes)\n  return Object.entries(nodes).flatMap(([id, node]) => {\n    const texts = shownTexts(node).map((slot) => (repeated.has(id) ? slot.get().replace(ENTRY_TOKEN, '') : slot.get()))\n    const refs = [...new Set(texts.flatMap((text) => refsIn(text, names)))]\n    return refs.length ? [{ id, refs, text: texts.filter((text) => refsIn(text, names).length).join(' ') }] : []\n  })\n}\n\n/** Internal references in a language-built page's or frame's words, as the violation that asks again. */\nexport function aiLayoutRefViolations(nodes: NodesMap, names: AiLayoutRefNames): AiDoctrineViolation[] {\n  const found = refsOf(nodes as unknown as GapNodes, names)\n  if (!found.length) return []\n  const refs = [...new Set(found.flatMap((entry) => entry.refs))].map((ref) => `\"${ref}\"`)\n  return [\n    {\n      rule: 14,\n      code: AI_LAYOUT_REF_CODE,\n      message: `${refs.join(', ')} ${refs.length === 1 ? 'is a link reference' : 'are link references'} written into words a visitor reads. A reference goes only in a button's or a list item's to; in text, name the page by its title, or leave the reference out.`,\n      nodeIds: found.map((entry) => entry.id),\n    },\n  ]\n}\n\n/**\n * The page or frame with no internal reference in its words: a page's\n * reference is written as that page's title, and a line that still names a\n * reference is taken out, as a gap is. Returns what was rewritten and taken.\n */\nexport function aiLayoutWithoutRefs(\n  input: NodesMap,\n  rootId: string,\n  names: AiLayoutRefNames,\n): { nodes: NodesMap; dropped: string[] } {\n  if (!refsOf(input as unknown as GapNodes, names).length) return { nodes: input, dropped: [] }\n  const nodes = cloneNodes(input)\n  const labels = new Map(names.pages.map((page) => [page.id, page.label]))\n  const dropped: string[] = []\n  for (const node of Object.values(nodes)) {\n    for (const slot of shownTexts(node)) {\n      const before = slot.get()\n      const after = before.replace(PAGE_REF, (ref, id: string) => labels.get(id) ?? ref)\n      if (after !== before) {\n        slot.set(after)\n        dropped.push(`\"${before}\" written as \"${after}\"`)\n      }\n    }\n  }\n  dropped.push(...pruneFound(nodes, rootId, refsOf(nodes, names)))\n  return { nodes: nodes as unknown as NodesMap, dropped }\n}\n\n/**\n * A language-built page's or frame's words held to both (AGL-3660): before\n * the last answer, each gap and each internal reference is a violation that\n * asks again; in the last, they are taken out and the rest is kept.\n */\nexport function aiLayoutCopyCheck(\n  input: NodesMap,\n  rootId: string,\n  names: AiLayoutRefNames,\n  last: boolean,\n): { nodes: NodesMap; dropped: string[]; violations: AiDoctrineViolation[] } {\n  if (!last) {\n    return { nodes: input, dropped: [], violations: [...aiLayoutRefViolations(input, names), ...aiLayoutGapViolations(input)] }\n  }\n  const refs = aiLayoutWithoutRefs(input, rootId, names)\n  const gaps = aiLayoutWithoutGaps(refs.nodes, rootId)\n  return { nodes: gaps.nodes, dropped: [...refs.dropped, ...gaps.dropped], violations: [] }\n}\n"],"names":["aiBracketedFacts","aiStoredScrollTargets","NOT_WORDS","Set","WORD_PROPS","SPEAKS_ALONE","HEADING_VARIANTS","AI_LAYOUT_GAP_CODE","stringsOf","value","key","has","Array","isArray","flatMap","entry","Object","entries","name","gapsOf","nodes","id","node","texts","props","facts","length","text","filter","join","aiLayoutGapViolations","found","rule","code","message","nodeIds","map","parentsOf","parents","Map","child","set","subtree","ids","stack","next","pop","includes","push","wordsOf","prop","trim","isHeading","componentId","String","test","speaks","beyondHeadings","some","each","says","copyProps","values","propValues","cloneNodes","input","fromEntries","pruneFound","rootId","dropped","sections","touched","remove","parent","get","prune","section","add","above","first","label","aiLayoutWithoutGaps","AI_LAYOUT_REF_CODE","REF","PAGE_REF","SHOWN_PROPS","shownTexts","slots","record","keys","escapeRegExp","replace","refsIn","names","match","ref","RegExp","ENTRY_TOKEN","repeatedByEntries","repeated","refsOf","slot","refs","aiLayoutRefViolations","aiLayoutWithoutRefs","labels","pages","page","before","after","aiLayoutCopyCheck","last","violations","gaps"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/layout-language/ai-layout-gaps.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 type { NodesMap } from '@aglyn/aglyn/types/nodes'\nimport { aiBracketedFacts, type AiDoctrineViolation } from '../runtime/ai-doctrine-validators'\nimport { aiStoredScrollTargets } from '../runtime/ai-page-links'\n\n/**\n * No gap on a published page (AGL-3660). A guided start publishes what it\n * builds, so a fact the brief never gave — a phone number, an address, the\n * opening hours — is left out of a page or a frame built in the layout\n * language, never written as the bracketed gap (\"[phone number]\") a draft a\n * person edits first may carry. An answer holding one is asked again; the\n * last answer a generation takes has each one taken out instead: the line\n * that carries it, the row or card it leaves with nothing to say, and a\n * section left with only its heading.\n */\n\ninterface GapNode {\n  componentId: string\n  props?: Record<string, unknown>\n  nodes?: string[]\n}\n\ntype GapNodes = Record<string, GapNode>\n\n/** Props that hold no words a visitor reads: an icon's drawing is path data. */\nconst NOT_WORDS = new Set(['iconPath', 'iconId'])\n\n/** The props a node's own words are in. */\nconst WORD_PROPS = ['children', 'primary', 'secondary', 'label'] as const\n\n/** Elements that say something with no words of their own. */\nconst SPEAKS_ALONE = new Set([\n  'image',\n  'form',\n  'layoutSlot',\n  'reusableInstance',\n  'muiDrawerToggle',\n  'muiDrawer',\n  // The site's own records, listed by the elements that keep them (AGL-3676).\n  'product-grid',\n  'collectionEntries',\n  'cart',\n  // A music site's player, placed empty for the owner's tracks (AGL-3716).\n  'musicPlayer',\n])\n\nconst HEADING_VARIANTS = new Set(['h1', 'h2', 'h3', 'h4', 'h5', 'h6', 'overline'])\n\n/** The violation code a gap is named by. */\nexport const AI_LAYOUT_GAP_CODE = 'layout-gap'\n\n/** Every string a value holds, however deep, its icon drawings aside. */\nfunction stringsOf(value: unknown, key = ''): string[] {\n  if (NOT_WORDS.has(key)) return []\n  if (typeof value === 'string') return [value]\n  if (Array.isArray(value)) return value.flatMap((entry) => stringsOf(entry))\n  if (value && typeof value === 'object') {\n    return Object.entries(value as Record<string, unknown>).flatMap(([name, entry]) => stringsOf(entry, name))\n  }\n  return []\n}\n\n/** Each node whose words carry a gap, with the gaps it carries. */\nfunction gapsOf(nodes: GapNodes): Array<{ id: string; facts: string[]; text: string }> {\n  return Object.entries(nodes).flatMap(([id, node]) => {\n    const texts = stringsOf(node.props ?? {})\n    const facts = aiBracketedFacts(texts)\n    return facts.length ? [{ id, facts, text: texts.filter((text) => aiBracketedFacts([text]).length).join(' ') }] : []\n  })\n}\n\n/** The gaps a language-built page or frame carries, as the violation that asks again. */\nexport function aiLayoutGapViolations(nodes: NodesMap): AiDoctrineViolation[] {\n  const found = gapsOf(nodes as unknown as GapNodes)\n  if (!found.length) return []\n  const facts = aiBracketedFacts(found.flatMap((entry) => entry.facts))\n  return [\n    {\n      rule: 14,\n      code: AI_LAYOUT_GAP_CODE,\n      message: `${facts.join(', ')} ${facts.length === 1 ? 'is a gap' : 'are gaps'} for a fact the brief does not give, and this site is published exactly as written. Leave each fact out: write the sentence without it, and make no list line, card or contact row for it. Never write a gap in square brackets, and never invent the fact.`,\n      nodeIds: found.map((entry) => entry.id),\n    },\n  ]\n}\n\nfunction parentsOf(nodes: GapNodes): Map<string, string> {\n  const parents = new Map<string, string>()\n  for (const [id, node] of Object.entries(nodes)) for (const child of node.nodes ?? []) parents.set(child, id)\n  return parents\n}\n\nfunction subtree(nodes: GapNodes, id: string): string[] {\n  const ids: string[] = []\n  const stack = [id]\n  while (stack.length) {\n    const next = stack.pop() as string\n    if (!nodes[next] || ids.includes(next)) continue\n    ids.push(next)\n    stack.push(...(nodes[next].nodes ?? []))\n  }\n  return ids\n}\n\nfunction wordsOf(node: GapNode): string {\n  for (const prop of WORD_PROPS) {\n    const value = node.props?.[prop]\n    if (typeof value === 'string' && value.trim()) return value.trim()\n  }\n  return ''\n}\n\nfunction isHeading(node: GapNode): boolean {\n  if (node.componentId !== 'muiTypography') return false\n  return HEADING_VARIANTS.has(String(node.props?.['variant'] ?? '')) || /^h[1-6]$/.test(String(node.props?.['component'] ?? ''))\n}\n\n/** Whether anything under a node says something; with `beyondHeadings`, anything but a heading. */\nfunction speaks(nodes: GapNodes, id: string, beyondHeadings = false): boolean {\n  return subtree(nodes, id).some((each) => {\n    const node = nodes[each]\n    const says = SPEAKS_ALONE.has(node.componentId) || !!wordsOf(node)\n    return says && !(beyondHeadings && isHeading(node))\n  })\n}\n\n/** A node's props, its component's prop values copied too, so a rewrite never reaches the input. */\nfunction copyProps(props: Record<string, unknown>): Record<string, unknown> {\n  const values = props['propValues']\n  return values && typeof values === 'object' && !Array.isArray(values)\n    ? { ...props, propValues: { ...(values as Record<string, unknown>) } }\n    : { ...props }\n}\n\nfunction cloneNodes(input: NodesMap): GapNodes {\n  return Object.fromEntries(\n    Object.entries(input as unknown as GapNodes).map(([id, node]) => [\n      id,\n      {\n        ...node,\n        ...(node.props ? { props: copyProps(node.props) } : {}),\n        ...(node.nodes ? { nodes: [...node.nodes] } : {}),\n      },\n    ]),\n  )\n}\n\n/**\n * Takes each found node out, and each element above it left with nothing to\n * say, up to its section; a section other than the page's first left with\n * only its heading goes too, with any link that scrolled to it.\n */\nfunction pruneFound(nodes: GapNodes, rootId: string, found: ReadonlyArray<{ id: string; text: string }>): string[] {\n  const dropped: string[] = []\n  const sections = new Set(nodes[rootId]?.nodes ?? [])\n  const touched = new Set<string>()\n  const remove = (id: string) => {\n    const parent = parentsOf(nodes).get(id)\n    for (const each of subtree(nodes, id)) delete nodes[each]\n    if (parent && nodes[parent]) nodes[parent].nodes = (nodes[parent].nodes ?? []).filter((child) => child !== id)\n  }\n  /** Takes a node out, and each element above it it leaves with nothing to say, short of a section. */\n  const prune = (id: string) => {\n    const parents = parentsOf(nodes)\n    let section: string | undefined = id\n    while (section && !sections.has(section)) section = parents.get(section)\n    if (section && section !== id) touched.add(section)\n    let parent = parents.get(id)\n    remove(id)\n    while (parent && parent !== rootId && nodes[parent]) {\n      if (sections.has(parent) || speaks(nodes, parent)) break\n      const above = parentsOf(nodes).get(parent)\n      remove(parent)\n      parent = above\n    }\n  }\n  for (const entry of found) {\n    if (!nodes[entry.id]) continue\n    dropped.push(entry.text)\n    prune(entry.id)\n  }\n  const first = nodes[rootId]?.nodes?.[0]\n  for (const section of touched) {\n    if (section === first || !nodes[section] || speaks(nodes, section, true)) continue\n    const label = String(nodes[section].props?.['ariaLabel'] ?? section)\n    remove(section)\n    dropped.push(`the section \"${label}\", left with only its heading`)\n    for (const [id, node] of Object.entries(nodes)) {\n      if (nodes[id] && aiStoredScrollTargets(node).includes(section)) {\n        dropped.push(`\"${wordsOf(node)}\", a link to that section`)\n        prune(id)\n      }\n    }\n  }\n  return dropped\n}\n\n/** The page or frame with every gap taken out, and what was taken. */\nexport function aiLayoutWithoutGaps(input: NodesMap, rootId: string): { nodes: NodesMap; dropped: string[] } {\n  const found = gapsOf(input as unknown as GapNodes)\n  if (!found.length) return { nodes: input, dropped: [] }\n  const nodes = cloneNodes(input)\n  const dropped = pruneFound(nodes, rootId, found)\n  return { nodes: nodes as unknown as NodesMap, dropped }\n}\n\n// ── Internal references ─────────────────────────────────────────────────\n\n/**\n * What a link may name, which never belongs in words a visitor reads: the\n * site's pages, with the title a reference to one is written as, and every\n * other id the page or frame was built against (its forms, components and\n * sections).\n */\nexport interface AiLayoutRefNames {\n  pages: ReadonlyArray<{ id: string; label: string }>\n  ids: readonly string[]\n}\n\n/** The violation code an internal reference in copy is named by. */\nexport const AI_LAYOUT_REF_CODE = 'layout-internal-ref'\n\n/** A link's own notation, or a template token other than the site's own (`{{host.…}}`). */\nconst REF = /\\b(?:page|new|form|component|screen):[A-Za-z0-9_-]+|\\{\\{(?!\\s*host\\.)[^{}]*\\}\\}/g\nconst PAGE_REF = /\\bpage:([A-Za-z0-9_-]+)/g\n\n/** The props whose words a visitor reads, and a component's prop values. */\nconst SHOWN_PROPS = [...WORD_PROPS, 'alt', 'title']\n\nfunction shownTexts(node: GapNode): Array<{ get: () => string; set: (value: string) => void }> {\n  const props = node.props ?? {}\n  const slots: Array<{ get: () => string; set: (value: string) => void }> = []\n  for (const prop of SHOWN_PROPS) {\n    if (typeof props[prop] === 'string') slots.push({ get: () => props[prop] as string, set: (value) => (props[prop] = value) })\n  }\n  const values = props['propValues']\n  if (values && typeof values === 'object' && !Array.isArray(values)) {\n    const record = values as Record<string, unknown>\n    for (const name of Object.keys(record)) {\n      if (typeof record[name] === 'string') slots.push({ get: () => record[name] as string, set: (value) => (record[name] = value) })\n    }\n  }\n  return slots\n}\n\nfunction escapeRegExp(value: string): string {\n  return value.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')\n}\n\nfunction refsIn(text: string, names: AiLayoutRefNames): string[] {\n  const found = (text.match(REF) ?? []).map((ref) => ref.trim())\n  for (const id of names.ids) {\n    if (id.length >= 6 && new RegExp(`(^|[^A-Za-z0-9_-])${escapeRegExp(id)}($|[^A-Za-z0-9_-])`).test(text)) found.push(id)\n  }\n  return [...new Set(found)]\n}\n\n/** An entry's own token, which a collection repeater fills per entry when the page renders. */\nconst ENTRY_TOKEN = /\\{\\{\\s*entry\\.[A-Za-z]+\\s*\\}\\}/g\n\n/** Every node under a Collection Entries block: its template, repeated once per entry (AGL-3676). */\nfunction repeatedByEntries(nodes: GapNodes): Set<string> {\n  const repeated = new Set<string>()\n  for (const [id, node] of Object.entries(nodes)) {\n    if (node.componentId !== 'collectionEntries') continue\n    for (const each of subtree(nodes, id)) if (each !== id) repeated.add(each)\n  }\n  return repeated\n}\n\n/** A record's own token, which a repeat over a dataset fills per record when the page renders. */\nconst ITEM_TOKEN = /\\{\\{\\s*item\\.[A-Za-z][A-Za-z0-9_]*(?:\\.[A-Za-z][A-Za-z0-9_]*)?\\s*\\}\\}/g\n\n/** Every node a repeat over a dataset copies once per record (AGL-3616), the repeating node included. */\nfunction repeatedByDataset(nodes: GapNodes): Set<string> {\n  const repeated = new Set<string>()\n  for (const [id, node] of Object.entries(nodes)) {\n    const key = node.props?.['repeatDataset']\n    if (typeof key !== 'string' || !key.trim()) continue\n    for (const each of subtree(nodes, id)) repeated.add(each)\n  }\n  return repeated\n}\n\nfunction refsOf(nodes: GapNodes, names: AiLayoutRefNames): Array<{ id: string; refs: string[]; text: string }> {\n  // A post's card names its post by the entry's tokens, which the page fills\n  // per post: words a visitor reads as the post's own, never a reference.\n  // A dataset's card names its record by the record's, the same way (AGL-3616).\n  const repeated = repeatedByEntries(nodes)\n  const records = repeatedByDataset(nodes)\n  return Object.entries(nodes).flatMap(([id, node]) => {\n    const texts = shownTexts(node).map((slot) => {\n      const text = repeated.has(id) ? slot.get().replace(ENTRY_TOKEN, '') : slot.get()\n      return records.has(id) ? text.replace(ITEM_TOKEN, '') : text\n    })\n    const refs = [...new Set(texts.flatMap((text) => refsIn(text, names)))]\n    return refs.length ? [{ id, refs, text: texts.filter((text) => refsIn(text, names).length).join(' ') }] : []\n  })\n}\n\n/** Internal references in a language-built page's or frame's words, as the violation that asks again. */\nexport function aiLayoutRefViolations(nodes: NodesMap, names: AiLayoutRefNames): AiDoctrineViolation[] {\n  const found = refsOf(nodes as unknown as GapNodes, names)\n  if (!found.length) return []\n  const refs = [...new Set(found.flatMap((entry) => entry.refs))].map((ref) => `\"${ref}\"`)\n  return [\n    {\n      rule: 14,\n      code: AI_LAYOUT_REF_CODE,\n      message: `${refs.join(', ')} ${refs.length === 1 ? 'is a link reference' : 'are link references'} written into words a visitor reads. A reference goes only in a button's or a list item's to; in text, name the page by its title, or leave the reference out.`,\n      nodeIds: found.map((entry) => entry.id),\n    },\n  ]\n}\n\n/**\n * The page or frame with no internal reference in its words: a page's\n * reference is written as that page's title, and a line that still names a\n * reference is taken out, as a gap is. Returns what was rewritten and taken.\n */\nexport function aiLayoutWithoutRefs(\n  input: NodesMap,\n  rootId: string,\n  names: AiLayoutRefNames,\n): { nodes: NodesMap; dropped: string[] } {\n  if (!refsOf(input as unknown as GapNodes, names).length) return { nodes: input, dropped: [] }\n  const nodes = cloneNodes(input)\n  const labels = new Map(names.pages.map((page) => [page.id, page.label]))\n  const dropped: string[] = []\n  for (const node of Object.values(nodes)) {\n    for (const slot of shownTexts(node)) {\n      const before = slot.get()\n      const after = before.replace(PAGE_REF, (ref, id: string) => labels.get(id) ?? ref)\n      if (after !== before) {\n        slot.set(after)\n        dropped.push(`\"${before}\" written as \"${after}\"`)\n      }\n    }\n  }\n  dropped.push(...pruneFound(nodes, rootId, refsOf(nodes, names)))\n  return { nodes: nodes as unknown as NodesMap, dropped }\n}\n\n/**\n * A language-built page's or frame's words held to both (AGL-3660): before\n * the last answer, each gap and each internal reference is a violation that\n * asks again; in the last, they are taken out and the rest is kept.\n */\nexport function aiLayoutCopyCheck(\n  input: NodesMap,\n  rootId: string,\n  names: AiLayoutRefNames,\n  last: boolean,\n): { nodes: NodesMap; dropped: string[]; violations: AiDoctrineViolation[] } {\n  if (!last) {\n    return { nodes: input, dropped: [], violations: [...aiLayoutRefViolations(input, names), ...aiLayoutGapViolations(input)] }\n  }\n  const refs = aiLayoutWithoutRefs(input, rootId, names)\n  const gaps = aiLayoutWithoutGaps(refs.nodes, rootId)\n  return { nodes: gaps.nodes, dropped: [...refs.dropped, ...gaps.dropped], violations: [] }\n}\n"],"names":["aiBracketedFacts","aiStoredScrollTargets","NOT_WORDS","Set","WORD_PROPS","SPEAKS_ALONE","HEADING_VARIANTS","AI_LAYOUT_GAP_CODE","stringsOf","value","key","has","Array","isArray","flatMap","entry","Object","entries","name","gapsOf","nodes","id","node","texts","props","facts","length","text","filter","join","aiLayoutGapViolations","found","rule","code","message","nodeIds","map","parentsOf","parents","Map","child","set","subtree","ids","stack","next","pop","includes","push","wordsOf","prop","trim","isHeading","componentId","String","test","speaks","beyondHeadings","some","each","says","copyProps","values","propValues","cloneNodes","input","fromEntries","pruneFound","rootId","dropped","sections","touched","remove","parent","get","prune","section","add","above","first","label","aiLayoutWithoutGaps","AI_LAYOUT_REF_CODE","REF","PAGE_REF","SHOWN_PROPS","shownTexts","slots","record","keys","escapeRegExp","replace","refsIn","names","match","ref","RegExp","ENTRY_TOKEN","repeatedByEntries","repeated","ITEM_TOKEN","repeatedByDataset","refsOf","records","slot","refs","aiLayoutRefViolations","aiLayoutWithoutRefs","labels","pages","page","before","after","aiLayoutCopyCheck","last","violations","gaps"],"mappings":"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"}

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

@@ -54,6 +54,12 @@
  *  - `signup` — a selling store's newsletter sign-up, through the commerce
  *    plugin's Newsletter signup (`newsletter-signup`, AGL-3676): a consented
  *    email field into the store's contacts, where a section says newsletter.
+ *  - `records` — one of the site's datasets (AGL-3616): a menu, a team, its
+ *    services, built by the site start and kept by the data plugin. Drawn as
+ *    a Box that repeats over the dataset (`repeatDataset`, the platform's own
+ *    repeat), its card binding the record's fields as `{{item.<field>}}`, in
+ *    the sections whose plan names the dataset in its `uses`. A site may list
+ *    several, one listing a dataset.
  *
  * The elements are named by their persisted ids, as the form binding names
  * `form`: a plugin never imports another's internals, and
@@ -62,7 +68,7 @@
  *
  * Model only: shapes and the inputs reader; the compiler draws them.
  */
-export type AiLayoutListingKind = 'products' | 'posts' | 'tracks' | 'reviews' | 'signup';
+export type AiLayoutListingKind = 'products' | 'posts' | 'tracks' | 'reviews' | 'signup' | 'records';
 /** How a section shows a listing: a few of its records on a page about something else, or all of them on its own page. */
 export type AiLayoutListingRole = 'featured' | 'index';
 /** One section of one page that places a listing. */
@@ -73,6 +79,14 @@ export interface AiLayoutListingPlacement {
     section: number;
     role: AiLayoutListingRole;
 }
+/** One field of a dataset a `records` listing shows, as its card binds it. */
+export interface AiLayoutListingField {
+    /** The field's id, which `{{item.<id>}}` reads. */
+    id: string;
+    name: string;
+    /** The data plugin's stored type: `text`, `float`, `int32`, `bool`, `sorted`. */
+    type: string;
+}
 /** A kind of record the site keeps, and where its pages place it. */
 export interface AiLayoutListing {
     /** `listing:products`, `listing:posts`: what a section's placement names. */
@@ -86,6 +100,10 @@ export interface AiLayoutListing {
     href?: string;
     /** The content collection a posts listing repeats, by its slug. */
     collectionSlug?: string;
+    /** The dataset a records listing repeats over, by id (AGL-3616). */
+    datasetId?: string;
+    /** The dataset's fields, in its order, which the card binds. */
+    fields?: AiLayoutListingField[];
     /**
      * Where a visitor goes from a store with nothing listed yet (AGL-3676): the
      * site's contact page, by its path. The empty state names it as its one
@@ -104,8 +122,8 @@ export interface AiLayoutListing {
 }
 /** The unit input a site's listings travel in, to its layout and its pages. */
 export declare const AI_LAYOUT_LISTINGS_INPUT = "siteListings";
-/** The id a listing of a kind is placed by. */
-export declare function aiLayoutListingId(kind: AiLayoutListingKind): string;
+/** The id a listing of a kind is placed by; a records listing is one dataset's. */
+export declare function aiLayoutListingId(kind: AiLayoutListingKind, datasetId?: string): string;
 /** The persisted element a listing is drawn with, by kind (held to its plugin's source by a spec). */
 export declare const AI_LAYOUT_LISTING_ELEMENTS: Readonly<Record<AiLayoutListingKind, string>>;
 /** The header's cart button: the commerce plugin's Cart in its `button` variant. */
@@ -117,6 +135,7 @@ export declare const AI_LAYOUT_FEATURED_RECORDS: {
     readonly tracks: 0;
     readonly reviews: 3;
     readonly signup: 0;
+    readonly records: 3;
 };
 /** A site's listings as its unit inputs carry them; nothing that does not read is kept. */
 export declare function aiLayoutListingsOf(inputs: Readonly<Record<string, unknown>> | null | undefined): AiLayoutListing[];
@@ -171,3 +190,13 @@ export declare function aiLayoutIsShopPage(screen: {
  * A section placed once is placed for one listing.
  */
 export declare function aiLayoutListingPlacements(kind: AiLayoutListingKind, screens: readonly AiLayoutListingScreen[]): AiLayoutListingPlacement[];
+/**
+ * The sections that list one of the site's datasets (AGL-3616): every section
+ * whose plan names it in its `uses` — `new:<its name>` as the plan wrote it,
+ * or its id once built. The home page features a few of its records; any
+ * other page lists them all. Chosen from the plan, never asked of the model.
+ */
+export declare function aiLayoutRecordsPlacements(dataset: {
+    id: string;
+    name: string;
+}, screens: readonly AiLayoutListingScreen[]): AiLayoutListingPlacement[];

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

@@ -16,15 +16,17 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
  * limitations under the License.
  */ import { aiStorefrontSays } from "./ai-layout-storefront.js";
 /** The unit input a site's listings travel in, to its layout and its pages. */ export const AI_LAYOUT_LISTINGS_INPUT = 'siteListings';
-/** The id a listing of a kind is placed by. */ export function aiLayoutListingId(kind) {
-    return `listing:${kind}`;
+/** The id a listing of a kind is placed by; a records listing is one dataset's. */ export function aiLayoutListingId(kind, datasetId) {
+    return kind === 'records' && datasetId ? `listing:records:${datasetId}` : `listing:${kind}`;
 }
 /** The persisted element a listing is drawn with, by kind (held to its plugin's source by a spec). */ export const AI_LAYOUT_LISTING_ELEMENTS = {
     products: 'product-grid',
     posts: 'collectionEntries',
     tracks: 'musicPlayer',
     reviews: 'product-reviews',
-    signup: 'newsletter-signup'
+    signup: 'newsletter-signup',
+    // The platform's own Box, repeating its card over the dataset.
+    records: 'muiBox'
 };
 /** The header's cart button: the commerce plugin's Cart in its `button` variant. */ export const AI_LAYOUT_CART_ELEMENT = 'cart';
 /** The most records a featured band shows; a page of its own shows them all. */ export const AI_LAYOUT_FEATURED_RECORDS = {
@@ -32,7 +34,8 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
     posts: 3,
     tracks: 0,
     reviews: 3,
-    signup: 0
+    signup: 0,
+    records: 3
 };
 const PLACEMENT_ROLES = [
     'featured',
@@ -43,7 +46,8 @@ const KINDS = [
     'posts',
     'tracks',
     'reviews',
-    'signup'
+    'signup',
+    'records'
 ];
 const text = (value)=>typeof value === 'string' ? value.trim() : '';
 /** What a visitor calls each kind's whole list, where a unit's input names none. */ const LISTING_NAMES = {
@@ -51,9 +55,26 @@ const text = (value)=>typeof value === 'string' ? value.trim() : '';
     posts: 'the blog',
     tracks: 'the music',
     reviews: 'the store',
-    signup: 'the newsletter'
+    signup: 'the newsletter',
+    records: 'the list'
 };
 /** A path on the site, as a listing's links are kept. */ const SITE_PATH = /^\/[a-z0-9-]+(?:\/[a-z0-9-]+)*$/;
+/** A dataset id and a field id, as the data plugin mints them. */ const DATASET_ID = /^[A-Za-z0-9_-]{1,128}$/;
+const FIELD_ID = /^[A-Za-z][A-Za-z0-9_]{0,63}$/;
+/** A records listing's fields as its input carries them; nothing that does not read is kept. */ function listingFieldsOf(raw) {
+    if (!Array.isArray(raw)) return [];
+    return raw.flatMap((value)=>{
+        const field = value != null ? value : {};
+        const id = text(field['id']);
+        return FIELD_ID.test(id) ? [
+            {
+                id,
+                name: text(field['name']).slice(0, 60) || id,
+                type: text(field['type']) || 'text'
+            }
+        ] : [];
+    }).slice(0, 16);
+}
 /** A site's listings as its unit inputs carry them; nothing that does not read is kept. */ export function aiLayoutListingsOf(inputs) {
     const raw = inputs == null ? void 0 : inputs[AI_LAYOUT_LISTINGS_INPUT];
     if (!Array.isArray(raw)) return [];
@@ -63,7 +84,14 @@ const text = (value)=>typeof value === 'string' ? value.trim() : '';
         if (!entry || typeof entry !== 'object') continue;
         const record = entry;
         const kind = record['kind'];
-        if (!KINDS.includes(kind) || listings.some((listing)=>listing.kind === kind)) continue;
+        // A records listing is one dataset's (AGL-3616): a site may list several.
+        const datasetId = kind === 'records' ? text(record['datasetId']) : '';
+        const fields = kind === 'records' ? listingFieldsOf(record['fields']) : [];
+        // Its fields may be left for the page to read off the site's inventory.
+        if (kind === 'records' && !DATASET_ID.test(datasetId)) continue;
+        if (!KINDS.includes(kind) || listings.some((listing)=>listing.kind === kind && (kind !== 'records' || listing.datasetId === datasetId))) {
+            continue;
+        }
         const href = text(record['href']);
         const action = (_record_emptyAction = record['emptyAction']) != null ? _record_emptyAction : {};
         const actionLabel = text(action['label']).slice(0, 40);
@@ -85,16 +113,19 @@ const text = (value)=>typeof value === 'string' ? value.trim() : '';
             ] : [];
         });
         listings.push(_extends({
-            id: aiLayoutListingId(kind),
+            id: aiLayoutListingId(kind, datasetId),
             kind,
             name: text(record['name']) || LISTING_NAMES[kind],
             // A tracks listing names no records: no job sources a recording (AGL-3716);
             // nor do a store's reviews and its sign-up, which shoppers fill (AGL-3676).
-            records: kind !== 'products' && kind !== 'posts' ? [] : (Array.isArray(record['records']) ? record['records'] : []).map(text).filter(Boolean).slice(0, 12)
+            records: kind !== 'products' && kind !== 'posts' && kind !== 'records' ? [] : (Array.isArray(record['records']) ? record['records'] : []).map(text).filter(Boolean).slice(0, 12)
         }, SITE_PATH.test(href) ? {
             href
         } : {}, kind === 'posts' ? {
             collectionSlug
+        } : {}, kind === 'records' ? {
+            datasetId,
+            fields
         } : {}, kind === 'products' && record['cart'] === false ? {
             cart: false
         } : {}, kind === 'products' && actionLabel && SITE_PATH.test(actionHref) ? {
@@ -253,5 +284,27 @@ const isHome = (slug)=>firstSegment(slug) === '';
     }
     return placements;
 }
+/**
+ * The sections that list one of the site's datasets (AGL-3616): every section
+ * whose plan names it in its `uses` — `new:<its name>` as the plan wrote it,
+ * or its id once built. The home page features a few of its records; any
+ * other page lists them all. Chosen from the plan, never asked of the model.
+ */ export function aiLayoutRecordsPlacements(dataset, screens) {
+    const named = `new:${dataset.name}`.trim().toLowerCase();
+    const placements = [];
+    for (const screen of screens){
+        if (typeof screen.id !== 'string' || !screen.id) continue;
+        screen.sections.forEach((section, index)=>{
+            var _section_uses;
+            const lists = ((_section_uses = section.uses) != null ? _section_uses : []).some((ref)=>ref === dataset.id || ref.trim().toLowerCase() === named);
+            if (lists) placements.push({
+                screenId: screen.id,
+                section: index,
+                role: isHome(screen.slug) ? 'featured' : 'index'
+            });
+        });
+    }
+    return placements;
+}
 
 //# sourceMappingURL=ai-layout-listings.js.map

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/layout-language/ai-layout-listings.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 { aiStorefrontSays } from './ai-layout-storefront'\n\n/**\n * A SITE'S OWN RECORDS, PLACED BY THE PLATFORM (AGL-3676).\n *\n * A guided start writes a store's first products and a blog's first posts,\n * then built the pages around them in the layout language — and the pages\n * showed neither. \"Featured candles\" and \"The candle range\" on the live\n * Ember & Wick start (2026-10-08) were cards the model wrote, a name and a\n * line each: no photo, no price, no link, nothing a shopper could open; the\n * Clay Notes blog's \"Featured writing\" was three cards that linked to no\n * post. The real records were on the site, one click away from nowhere.\n *\n * A LISTING is one kind of record a site keeps — its catalog, its blog —\n * placed by code in the sections whose plan says they show it, through the\n * element the plugin that keeps the records renders them with, bound to the\n * records themselves rather than to words about them. It is the form binding\n * one step on (a section whose plan `uses` a form places that form by its\n * id, whatever the answer remembered): the model writes the section's\n * heading and words, the platform places the records.\n *\n *  - `products` — the commerce plugin's Product grid (`product-grid`), over\n *    the site's whole active catalog: a photo, the name, the price (or\n *    \"Price coming soon\" where the owner cleared it), each card linking its\n *    product's page.\n *  - `posts` — the content plugin's Collection Entries (`collectionEntries`)\n *    over the blog's collection, its card a cover, the date and byline, the\n *    title and the excerpt, linking each post.\n *  - `tracks` — the music plugin's Music player (`musicPlayer`, AGL-3716) on a\n *    music site, placed EMPTY: its \"add your tracks\" state, for the owner to\n *    fill from their own media library. No job ever sources a recording, so\n *    a tracks listing has no records and the player no source.\n *  - `reviews` — a selling store's own customer reviews, through the commerce\n *    plugin's Product reviews in its store-wide scope (`product-reviews`,\n *    AGL-3676): approved reviews across the catalog with their star ratings.\n *    A store that opens has none, and the element then shows nothing at all\n *    on the published page, so no review is ever written for a shopper who\n *    did not leave one (the FTC's fake-review rule; rule 14's \"never invent\n *    a customer\").\n *  - `signup` — a selling store's newsletter sign-up, through the commerce\n *    plugin's Newsletter signup (`newsletter-signup`, AGL-3676): a consented\n *    email field into the store's contacts, where a section says newsletter.\n *\n * The elements are named by their persisted ids, as the form binding names\n * `form`: a plugin never imports another's internals, and\n * `ai-layout-listings.spec.ts` holds the ids and props named here to the\n * source of the plugins that declare them.\n *\n * Model only: shapes and the inputs reader; the compiler draws them.\n */\n\nexport type AiLayoutListingKind = 'products' | 'posts' | 'tracks' | 'reviews' | 'signup'\n\n/** How a section shows a listing: a few of its records on a page about something else, or all of them on its own page. */\nexport type AiLayoutListingRole = 'featured' | 'index'\n\n/** One section of one page that places a listing. */\nexport interface AiLayoutListingPlacement {\n  /** The page, by its plan id. */\n  screenId: string\n  /** The section, by plan index. */\n  section: number\n  role: AiLayoutListingRole\n}\n\n/** A kind of record the site keeps, and where its pages place it. */\nexport interface AiLayoutListing {\n  /** `listing:products`, `listing:posts`: what a section's placement names. */\n  id: string\n  kind: AiLayoutListingKind\n  /** What a visitor would call the whole list: \"the shop\", \"the blog\". */\n  name: string\n  /** The records it shows today, by name, so a page's words can name them. */\n  records: string[]\n  /** Where the whole list lives, as a path on the site: the blog's `/blog`. */\n  href?: string\n  /** The content collection a posts listing repeats, by its slug. */\n  collectionSlug?: string\n  /**\n   * Where a visitor goes from a store with nothing listed yet (AGL-3676): the\n   * site's contact page, by its path. The empty state names it as its one\n   * action, so a shop that opens empty still answers a visitor.\n   */\n  emptyAction?: { label: string; href: string }\n  /**\n   * `false` for a store that lists its catalog but cannot sell yet (its first\n   * products were skipped or failed, AGL-3676): the header carries no cart.\n   */\n  cart?: boolean\n  placements: AiLayoutListingPlacement[]\n}\n\n/** The unit input a site's listings travel in, to its layout and its pages. */\nexport const AI_LAYOUT_LISTINGS_INPUT = 'siteListings'\n\n/** The id a listing of a kind is placed by. */\nexport function aiLayoutListingId(kind: AiLayoutListingKind): string {\n  return `listing:${kind}`\n}\n\n/** The persisted element a listing is drawn with, by kind (held to its plugin's source by a spec). */\nexport const AI_LAYOUT_LISTING_ELEMENTS: Readonly<Record<AiLayoutListingKind, string>> = {\n  products: 'product-grid',\n  posts: 'collectionEntries',\n  tracks: 'musicPlayer',\n  reviews: 'product-reviews',\n  signup: 'newsletter-signup',\n}\n\n/** The header's cart button: the commerce plugin's Cart in its `button` variant. */\nexport const AI_LAYOUT_CART_ELEMENT = 'cart'\n\n/** The most records a featured band shows; a page of its own shows them all. */\nexport const AI_LAYOUT_FEATURED_RECORDS = { products: 4, posts: 3, tracks: 0, reviews: 3, signup: 0 } as const\n\nconst PLACEMENT_ROLES: readonly AiLayoutListingRole[] = ['featured', 'index']\nconst KINDS: readonly AiLayoutListingKind[] = ['products', 'posts', 'tracks', 'reviews', 'signup']\n\nconst text = (value: unknown): string => (typeof value === 'string' ? value.trim() : '')\n\n/** What a visitor calls each kind's whole list, where a unit's input names none. */\nconst LISTING_NAMES: Readonly<Record<AiLayoutListingKind, string>> = {\n  products: 'the shop',\n  posts: 'the blog',\n  tracks: 'the music',\n  reviews: 'the store',\n  signup: 'the newsletter',\n}\n\n/** A path on the site, as a listing's links are kept. */\nconst SITE_PATH = /^\\/[a-z0-9-]+(?:\\/[a-z0-9-]+)*$/\n\n/** A site's listings as its unit inputs carry them; nothing that does not read is kept. */\nexport function aiLayoutListingsOf(inputs: Readonly<Record<string, unknown>> | null | undefined): AiLayoutListing[] {\n  const raw = inputs?.[AI_LAYOUT_LISTINGS_INPUT]\n  if (!Array.isArray(raw)) return []\n  const listings: AiLayoutListing[] = []\n  for (const entry of raw) {\n    if (!entry || typeof entry !== 'object') continue\n    const record = entry as Record<string, unknown>\n    const kind = record['kind'] as AiLayoutListingKind\n    if (!KINDS.includes(kind) || listings.some((listing) => listing.kind === kind)) continue\n    const href = text(record['href'])\n    const action = (record['emptyAction'] ?? {}) as Record<string, unknown>\n    const actionLabel = text(action['label']).slice(0, 40)\n    const actionHref = text(action['href'])\n    const collectionSlug = text(record['collectionSlug'])\n    // A posts listing with no collection to repeat shows nothing.\n    if (kind === 'posts' && !/^[a-z0-9-]{1,100}$/.test(collectionSlug)) continue\n    const placements = (Array.isArray(record['placements']) ? record['placements'] : []).flatMap((value) => {\n      const placement = (value ?? {}) as Record<string, unknown>\n      const screenId = text(placement['screenId'])\n      const section = placement['section']\n      const role = placement['role'] as AiLayoutListingRole\n      return screenId && typeof section === 'number' && Number.isInteger(section) && section >= 0 && PLACEMENT_ROLES.includes(role)\n        ? [{ screenId, section, role }]\n        : []\n    })\n    listings.push({\n      id: aiLayoutListingId(kind),\n      kind,\n      name: text(record['name']) || LISTING_NAMES[kind],\n      // A tracks listing names no records: no job sources a recording (AGL-3716);\n      // nor do a store's reviews and its sign-up, which shoppers fill (AGL-3676).\n      records:\n        kind !== 'products' && kind !== 'posts'\n          ? []\n          : (Array.isArray(record['records']) ? record['records'] : []).map(text).filter(Boolean).slice(0, 12),\n      ...(SITE_PATH.test(href) ? { href } : {}),\n      ...(kind === 'posts' ? { collectionSlug } : {}),\n      ...(kind === 'products' && record['cart'] === false ? { cart: false } : {}),\n      ...(kind === 'products' && actionLabel && SITE_PATH.test(actionHref) ? { emptyAction: { label: actionLabel, href: actionHref } } : {}),\n      placements,\n    })\n  }\n  return listings\n}\n\n/** The listing a section of a page places, and how; `null` for a section that places none. */\nexport function aiLayoutListingAt(\n  listings: readonly AiLayoutListing[],\n  screenId: string | null | undefined,\n  section: number,\n): { listing: AiLayoutListing; role: AiLayoutListingRole } | null {\n  if (!screenId) return null\n  for (const listing of listings) {\n    const placement = listing.placements.find((entry) => entry.screenId === screenId && entry.section === section)\n    if (placement) return { listing, role: placement.role }\n  }\n  return null\n}\n\n// ── Where a site's pages place them ────────────────────────────────────\n\n/** The plan of a page, as a placement is chosen from it. */\nexport interface AiLayoutListingScreen {\n  id?: string | null\n  title: string\n  slug: string\n  sections: ReadonlyArray<{ name: string; items: number; uses?: readonly string[] }>\n}\n\nconst PRODUCT_PAGE = /\\b(shop|store|products?|catalog(?:ue)?|collections?|range|browse)\\b/i\nconst PRODUCT_SECTION =\n  /\\b(shop|store|products?|catalog(?:ue)?|collections?|range|bestsellers?|best[- ]sellers?|new arrivals|arrivals|featured|favou?rites|signature)\\b/i\nconst POST_SECTION = /\\b(blog|posts?|articles?|writing|journal|stories|essays?|latest|recent|news|featured)\\b/i\n/** A music site's page or section about its recordings (AGL-3716). */\nconst MUSIC_PAGE = /\\b(music|listen|tracks?|songs?|releases?|discography|albums?|eps?|singles?|sounds?)\\b/i\n\n/**\n * The section of a shop's own page the whole catalog fills (AGL-3676): the\n * first after its opening whose name says products (\"Product grid\", \"The\n * range\"), else the section planned with the most items, else its second.\n * The live Hearth & Wick start (2026-10-09) planned \"Product range image\n * cards\" — six cards naming kinds of candle, with no product, price or cart.\n */\nexport function aiLayoutShopGridSection(sections: ReadonlyArray<{ name: string; items: number }>): number {\n  const named = sections.findIndex((section, index) => index > 0 && PRODUCT_SECTION.test(section.name) && !SHOP_FRAMING.test(section.name))\n  if (named !== -1) return named\n  const most = Math.max(0, ...sections.map((section) => section.items))\n  const byItems = most > 0 ? sections.findIndex((section) => section.items === most) : -1\n  return byItems !== -1 ? byItems : sections.length > 1 ? 1 : 0\n}\n\n/**\n * The section of a store's home its bestsellers fill (AGL-3676): the first\n * after the hero whose name says them (\"Bestsellers\", \"Featured candles\", \"New\n * arrivals\"), never one about the store's collections, its reviews or its\n * sign-up; else the first after the hero naming products at all; else the\n * first after the hero planned with items that is none of those. The\n * beta.237 Willow Wick home would otherwise have listed products in its\n * \"Shop by collection\" tiles.\n */\nfunction aiLayoutFeaturedSection(screen: AiLayoutListingScreen): number {\n  // A section about the collections that does not also name the bestsellers.\n  const other = (name: string) =>\n    (aiStorefrontSays('collections', name) && !aiStorefrontSays('featured', name)) ||\n    aiStorefrontSays('reviews', name) ||\n    aiStorefrontSays('signup', name)\n  const first = (test: (name: string, items: number) => boolean) =>\n    screen.sections.findIndex((section, index) => index > 0 && test(section.name, section.items))\n  for (const test of [\n    (name: string) => aiStorefrontSays('featured', name) && !other(name),\n    (name: string) => PRODUCT_SECTION.test(name) && !other(name),\n    (name: string, items: number) => items > 0 && !other(name),\n    (name: string) => PRODUCT_SECTION.test(name),\n  ]) {\n    const found = first(test)\n    if (found !== -1) return found\n  }\n  return -1\n}\n\n/** A section of a shop page that only opens or closes it: \"Shop intro heading\", \"Gift help call to action\". */\nconst SHOP_FRAMING = /\\b(hero|intro(?:duction)?|heading|banner|cta|call to action|contact)\\b/i\n\n/** Whether a planned page is the store's own Shop page: its address or its name says it sells. */\nexport function aiLayoutIsShopPage(screen: { slug: string; title: string }): boolean {\n  return !isHome(screen.slug) && PRODUCT_PAGE.test(`${firstSegment(screen.slug)} ${screen.title}`)\n}\n\nconst firstSegment = (slug: string) => slug.trim().replace(/^\\/+/, '').split('/')[0].toLowerCase()\nconst isHome = (slug: string) => firstSegment(slug) === ''\n\n/**\n * The sections of a site's pages that show a listing, chosen by code from the\n * plan (AGL-3676), never asked of the model:\n *\n *  - PRODUCTS. The shop's own page — the page whose address or name says it\n *    sells (`/shop`, \"Shop\", \"Products\") — shows the whole catalog in the\n *    section the plan gave the most items, else its second; and the home\n *    page features a few in its first section after the hero whose name\n *    says products (\"Featured candles\", \"Bestsellers\"), else in the first\n *    section after the hero planned with items.\n *  - POSTS. The home features the latest in its first section of items after\n *    the hero whose name says writing (\"Featured writing\", \"Latest posts\"),\n *    else its first section of items after the hero; and any other page\n *    whose name says it is about the writing does the same. The blog's own\n *    index is the platform's.\n *\n * A section placed once is placed for one listing.\n */\nexport function aiLayoutListingPlacements(\n  kind: AiLayoutListingKind,\n  screens: readonly AiLayoutListingScreen[],\n): AiLayoutListingPlacement[] {\n  const placements: AiLayoutListingPlacement[] = []\n  const place = (screen: AiLayoutListingScreen, section: number, role: AiLayoutListingRole) => {\n    if (typeof screen.id === 'string' && screen.id && section >= 0) placements.push({ screenId: screen.id, section, role })\n  }\n  const afterHero = (screen: AiLayoutListingScreen, test: (name: string, items: number) => boolean) =>\n    screen.sections.findIndex((section, index) => index > 0 && test(section.name, section.items))\n  if (kind === 'tracks') {\n    // A music site's player (AGL-3716): on its Music page, in the section that\n    // says it is about the recordings, else the one after the opening; on the\n    // home, only in a section named for them. A site with neither gets it on\n    // its home, after the opening.\n    for (const screen of screens) {\n      if (isHome(screen.slug)) {\n        place(screen, afterHero(screen, (name) => MUSIC_PAGE.test(name)), 'featured')\n        continue\n      }\n      if (!MUSIC_PAGE.test(`${firstSegment(screen.slug)} ${screen.title}`)) continue\n      const named = afterHero(screen, (name) => MUSIC_PAGE.test(name))\n      place(screen, named !== -1 ? named : screen.sections.length > 1 ? 1 : 0, 'index')\n    }\n    if (!placements.length) {\n      const home = screens.find((screen) => isHome(screen.slug))\n      if (home) place(home, home.sections.length > 1 ? 1 : 0, 'featured')\n    }\n    return placements\n  }\n  if (kind === 'reviews' || kind === 'signup') {\n    // A store's own reviews, on its home, in the section named for them; its\n    // newsletter sign-up in any page's section named for it that places no\n    // form of the plan's (AGL-3676). Neither is ever a page's opening.\n    for (const screen of screens) {\n      if (kind === 'reviews' && !isHome(screen.slug)) continue\n      place(\n        screen,\n        afterHero(\n          screen,\n          (name) => aiStorefrontSays(kind, name),\n        ),\n        kind === 'reviews' ? 'featured' : 'index',\n      )\n    }\n    return kind === 'signup'\n      ? placements.filter((placement) => {\n          const screen = screens.find((entry) => entry.id === placement.screenId)\n          return !(screen?.sections[placement.section]?.uses ?? []).some((use) => /form/i.test(use))\n        })\n      : placements\n  }\n  if (kind === 'products') {\n    for (const screen of screens) {\n      if (isHome(screen.slug)) {\n        place(screen, aiLayoutFeaturedSection(screen), 'featured')\n        continue\n      }\n      if (!aiLayoutIsShopPage(screen)) continue\n      place(screen, aiLayoutShopGridSection(screen.sections), 'index')\n    }\n    return placements\n  }\n  for (const screen of screens) {\n    if (isHome(screen.slug)) {\n      // On a blog's home the band that names the writing (\"Featured posts\n      // cards\", \"Featured journeys\") lists it; failing one, the first band of\n      // items after the hero. A live Clay Notes plan (2026-10-09) opened its\n      // home with \"What you will find\" before \"Featured posts cards\".\n      const named = afterHero(screen, (name, items) => items > 0 && POST_SECTION.test(name))\n      place(screen, named !== -1 ? named : afterHero(screen, (_name, items) => items > 0), 'featured')\n      continue\n    }\n    if (!POST_SECTION.test(screen.title)) continue\n    place(screen, afterHero(screen, (name) => POST_SECTION.test(name)), 'featured')\n  }\n  return placements\n}\n"],"names":["aiStorefrontSays","AI_LAYOUT_LISTINGS_INPUT","aiLayoutListingId","kind","AI_LAYOUT_LISTING_ELEMENTS","products","posts","tracks","reviews","signup","AI_LAYOUT_CART_ELEMENT","AI_LAYOUT_FEATURED_RECORDS","PLACEMENT_ROLES","KINDS","text","value","trim","LISTING_NAMES","SITE_PATH","aiLayoutListingsOf","inputs","raw","Array","isArray","listings","entry","record","includes","some","listing","href","action","actionLabel","slice","actionHref","collectionSlug","test","placements","flatMap","placement","screenId","section","role","Number","isInteger","push","id","name","records","map","filter","Boolean","cart","emptyAction","label","aiLayoutListingAt","find","PRODUCT_PAGE","PRODUCT_SECTION","POST_SECTION","MUSIC_PAGE","aiLayoutShopGridSection","sections","named","findIndex","index","SHOP_FRAMING","most","Math","max","items","byItems","length","aiLayoutFeaturedSection","screen","other","first","found","aiLayoutIsShopPage","isHome","slug","firstSegment","title","replace","split","toLowerCase","aiLayoutListingPlacements","screens","place","afterHero","home","uses","use","_name"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/layout-language/ai-layout-listings.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 { aiStorefrontSays } from './ai-layout-storefront'\n\n/**\n * A SITE'S OWN RECORDS, PLACED BY THE PLATFORM (AGL-3676).\n *\n * A guided start writes a store's first products and a blog's first posts,\n * then built the pages around them in the layout language — and the pages\n * showed neither. \"Featured candles\" and \"The candle range\" on the live\n * Ember & Wick start (2026-10-08) were cards the model wrote, a name and a\n * line each: no photo, no price, no link, nothing a shopper could open; the\n * Clay Notes blog's \"Featured writing\" was three cards that linked to no\n * post. The real records were on the site, one click away from nowhere.\n *\n * A LISTING is one kind of record a site keeps — its catalog, its blog —\n * placed by code in the sections whose plan says they show it, through the\n * element the plugin that keeps the records renders them with, bound to the\n * records themselves rather than to words about them. It is the form binding\n * one step on (a section whose plan `uses` a form places that form by its\n * id, whatever the answer remembered): the model writes the section's\n * heading and words, the platform places the records.\n *\n *  - `products` — the commerce plugin's Product grid (`product-grid`), over\n *    the site's whole active catalog: a photo, the name, the price (or\n *    \"Price coming soon\" where the owner cleared it), each card linking its\n *    product's page.\n *  - `posts` — the content plugin's Collection Entries (`collectionEntries`)\n *    over the blog's collection, its card a cover, the date and byline, the\n *    title and the excerpt, linking each post.\n *  - `tracks` — the music plugin's Music player (`musicPlayer`, AGL-3716) on a\n *    music site, placed EMPTY: its \"add your tracks\" state, for the owner to\n *    fill from their own media library. No job ever sources a recording, so\n *    a tracks listing has no records and the player no source.\n *  - `reviews` — a selling store's own customer reviews, through the commerce\n *    plugin's Product reviews in its store-wide scope (`product-reviews`,\n *    AGL-3676): approved reviews across the catalog with their star ratings.\n *    A store that opens has none, and the element then shows nothing at all\n *    on the published page, so no review is ever written for a shopper who\n *    did not leave one (the FTC's fake-review rule; rule 14's \"never invent\n *    a customer\").\n *  - `signup` — a selling store's newsletter sign-up, through the commerce\n *    plugin's Newsletter signup (`newsletter-signup`, AGL-3676): a consented\n *    email field into the store's contacts, where a section says newsletter.\n *  - `records` — one of the site's datasets (AGL-3616): a menu, a team, its\n *    services, built by the site start and kept by the data plugin. Drawn as\n *    a Box that repeats over the dataset (`repeatDataset`, the platform's own\n *    repeat), its card binding the record's fields as `{{item.<field>}}`, in\n *    the sections whose plan names the dataset in its `uses`. A site may list\n *    several, one listing a dataset.\n *\n * The elements are named by their persisted ids, as the form binding names\n * `form`: a plugin never imports another's internals, and\n * `ai-layout-listings.spec.ts` holds the ids and props named here to the\n * source of the plugins that declare them.\n *\n * Model only: shapes and the inputs reader; the compiler draws them.\n */\n\nexport type AiLayoutListingKind = 'products' | 'posts' | 'tracks' | 'reviews' | 'signup' | 'records'\n\n/** How a section shows a listing: a few of its records on a page about something else, or all of them on its own page. */\nexport type AiLayoutListingRole = 'featured' | 'index'\n\n/** One section of one page that places a listing. */\nexport interface AiLayoutListingPlacement {\n  /** The page, by its plan id. */\n  screenId: string\n  /** The section, by plan index. */\n  section: number\n  role: AiLayoutListingRole\n}\n\n/** One field of a dataset a `records` listing shows, as its card binds it. */\nexport interface AiLayoutListingField {\n  /** The field's id, which `{{item.<id>}}` reads. */\n  id: string\n  name: string\n  /** The data plugin's stored type: `text`, `float`, `int32`, `bool`, `sorted`. */\n  type: string\n}\n\n/** A kind of record the site keeps, and where its pages place it. */\nexport interface AiLayoutListing {\n  /** `listing:products`, `listing:posts`: what a section's placement names. */\n  id: string\n  kind: AiLayoutListingKind\n  /** What a visitor would call the whole list: \"the shop\", \"the blog\". */\n  name: string\n  /** The records it shows today, by name, so a page's words can name them. */\n  records: string[]\n  /** Where the whole list lives, as a path on the site: the blog's `/blog`. */\n  href?: string\n  /** The content collection a posts listing repeats, by its slug. */\n  collectionSlug?: string\n  /** The dataset a records listing repeats over, by id (AGL-3616). */\n  datasetId?: string\n  /** The dataset's fields, in its order, which the card binds. */\n  fields?: AiLayoutListingField[]\n  /**\n   * Where a visitor goes from a store with nothing listed yet (AGL-3676): the\n   * site's contact page, by its path. The empty state names it as its one\n   * action, so a shop that opens empty still answers a visitor.\n   */\n  emptyAction?: { label: string; href: string }\n  /**\n   * `false` for a store that lists its catalog but cannot sell yet (its first\n   * products were skipped or failed, AGL-3676): the header carries no cart.\n   */\n  cart?: boolean\n  placements: AiLayoutListingPlacement[]\n}\n\n/** The unit input a site's listings travel in, to its layout and its pages. */\nexport const AI_LAYOUT_LISTINGS_INPUT = 'siteListings'\n\n/** The id a listing of a kind is placed by; a records listing is one dataset's. */\nexport function aiLayoutListingId(kind: AiLayoutListingKind, datasetId?: string): string {\n  return kind === 'records' && datasetId ? `listing:records:${datasetId}` : `listing:${kind}`\n}\n\n/** The persisted element a listing is drawn with, by kind (held to its plugin's source by a spec). */\nexport const AI_LAYOUT_LISTING_ELEMENTS: Readonly<Record<AiLayoutListingKind, string>> = {\n  products: 'product-grid',\n  posts: 'collectionEntries',\n  tracks: 'musicPlayer',\n  reviews: 'product-reviews',\n  signup: 'newsletter-signup',\n  // The platform's own Box, repeating its card over the dataset.\n  records: 'muiBox',\n}\n\n/** The header's cart button: the commerce plugin's Cart in its `button` variant. */\nexport const AI_LAYOUT_CART_ELEMENT = 'cart'\n\n/** The most records a featured band shows; a page of its own shows them all. */\nexport const AI_LAYOUT_FEATURED_RECORDS = { products: 4, posts: 3, tracks: 0, reviews: 3, signup: 0, records: 3 } as const\n\nconst PLACEMENT_ROLES: readonly AiLayoutListingRole[] = ['featured', 'index']\nconst KINDS: readonly AiLayoutListingKind[] = ['products', 'posts', 'tracks', 'reviews', 'signup', 'records']\n\nconst text = (value: unknown): string => (typeof value === 'string' ? value.trim() : '')\n\n/** What a visitor calls each kind's whole list, where a unit's input names none. */\nconst LISTING_NAMES: Readonly<Record<AiLayoutListingKind, string>> = {\n  products: 'the shop',\n  posts: 'the blog',\n  tracks: 'the music',\n  reviews: 'the store',\n  signup: 'the newsletter',\n  records: 'the list',\n}\n\n/** A path on the site, as a listing's links are kept. */\nconst SITE_PATH = /^\\/[a-z0-9-]+(?:\\/[a-z0-9-]+)*$/\n\n/** A dataset id and a field id, as the data plugin mints them. */\nconst DATASET_ID = /^[A-Za-z0-9_-]{1,128}$/\nconst FIELD_ID = /^[A-Za-z][A-Za-z0-9_]{0,63}$/\n\n/** A records listing's fields as its input carries them; nothing that does not read is kept. */\nfunction listingFieldsOf(raw: unknown): AiLayoutListingField[] {\n  if (!Array.isArray(raw)) return []\n  return raw\n    .flatMap((value) => {\n      const field = (value ?? {}) as Record<string, unknown>\n      const id = text(field['id'])\n      return FIELD_ID.test(id) ? [{ id, name: text(field['name']).slice(0, 60) || id, type: text(field['type']) || 'text' }] : []\n    })\n    .slice(0, 16)\n}\n\n/** A site's listings as its unit inputs carry them; nothing that does not read is kept. */\nexport function aiLayoutListingsOf(inputs: Readonly<Record<string, unknown>> | null | undefined): AiLayoutListing[] {\n  const raw = inputs?.[AI_LAYOUT_LISTINGS_INPUT]\n  if (!Array.isArray(raw)) return []\n  const listings: AiLayoutListing[] = []\n  for (const entry of raw) {\n    if (!entry || typeof entry !== 'object') continue\n    const record = entry as Record<string, unknown>\n    const kind = record['kind'] as AiLayoutListingKind\n    // A records listing is one dataset's (AGL-3616): a site may list several.\n    const datasetId = kind === 'records' ? text(record['datasetId']) : ''\n    const fields = kind === 'records' ? listingFieldsOf(record['fields']) : []\n    // Its fields may be left for the page to read off the site's inventory.\n    if (kind === 'records' && !DATASET_ID.test(datasetId)) continue\n    if (\n      !KINDS.includes(kind) ||\n      listings.some((listing) => listing.kind === kind && (kind !== 'records' || listing.datasetId === datasetId))\n    ) {\n      continue\n    }\n    const href = text(record['href'])\n    const action = (record['emptyAction'] ?? {}) as Record<string, unknown>\n    const actionLabel = text(action['label']).slice(0, 40)\n    const actionHref = text(action['href'])\n    const collectionSlug = text(record['collectionSlug'])\n    // A posts listing with no collection to repeat shows nothing.\n    if (kind === 'posts' && !/^[a-z0-9-]{1,100}$/.test(collectionSlug)) continue\n    const placements = (Array.isArray(record['placements']) ? record['placements'] : []).flatMap((value) => {\n      const placement = (value ?? {}) as Record<string, unknown>\n      const screenId = text(placement['screenId'])\n      const section = placement['section']\n      const role = placement['role'] as AiLayoutListingRole\n      return screenId && typeof section === 'number' && Number.isInteger(section) && section >= 0 && PLACEMENT_ROLES.includes(role)\n        ? [{ screenId, section, role }]\n        : []\n    })\n    listings.push({\n      id: aiLayoutListingId(kind, datasetId),\n      kind,\n      name: text(record['name']) || LISTING_NAMES[kind],\n      // A tracks listing names no records: no job sources a recording (AGL-3716);\n      // nor do a store's reviews and its sign-up, which shoppers fill (AGL-3676).\n      records:\n        kind !== 'products' && kind !== 'posts' && kind !== 'records'\n          ? []\n          : (Array.isArray(record['records']) ? record['records'] : []).map(text).filter(Boolean).slice(0, 12),\n      ...(SITE_PATH.test(href) ? { href } : {}),\n      ...(kind === 'posts' ? { collectionSlug } : {}),\n      ...(kind === 'records' ? { datasetId, fields } : {}),\n      ...(kind === 'products' && record['cart'] === false ? { cart: false } : {}),\n      ...(kind === 'products' && actionLabel && SITE_PATH.test(actionHref) ? { emptyAction: { label: actionLabel, href: actionHref } } : {}),\n      placements,\n    })\n  }\n  return listings\n}\n\n/** The listing a section of a page places, and how; `null` for a section that places none. */\nexport function aiLayoutListingAt(\n  listings: readonly AiLayoutListing[],\n  screenId: string | null | undefined,\n  section: number,\n): { listing: AiLayoutListing; role: AiLayoutListingRole } | null {\n  if (!screenId) return null\n  for (const listing of listings) {\n    const placement = listing.placements.find((entry) => entry.screenId === screenId && entry.section === section)\n    if (placement) return { listing, role: placement.role }\n  }\n  return null\n}\n\n// ── Where a site's pages place them ────────────────────────────────────\n\n/** The plan of a page, as a placement is chosen from it. */\nexport interface AiLayoutListingScreen {\n  id?: string | null\n  title: string\n  slug: string\n  sections: ReadonlyArray<{ name: string; items: number; uses?: readonly string[] }>\n}\n\nconst PRODUCT_PAGE = /\\b(shop|store|products?|catalog(?:ue)?|collections?|range|browse)\\b/i\nconst PRODUCT_SECTION =\n  /\\b(shop|store|products?|catalog(?:ue)?|collections?|range|bestsellers?|best[- ]sellers?|new arrivals|arrivals|featured|favou?rites|signature)\\b/i\nconst POST_SECTION = /\\b(blog|posts?|articles?|writing|journal|stories|essays?|latest|recent|news|featured)\\b/i\n/** A music site's page or section about its recordings (AGL-3716). */\nconst MUSIC_PAGE = /\\b(music|listen|tracks?|songs?|releases?|discography|albums?|eps?|singles?|sounds?)\\b/i\n\n/**\n * The section of a shop's own page the whole catalog fills (AGL-3676): the\n * first after its opening whose name says products (\"Product grid\", \"The\n * range\"), else the section planned with the most items, else its second.\n * The live Hearth & Wick start (2026-10-09) planned \"Product range image\n * cards\" — six cards naming kinds of candle, with no product, price or cart.\n */\nexport function aiLayoutShopGridSection(sections: ReadonlyArray<{ name: string; items: number }>): number {\n  const named = sections.findIndex((section, index) => index > 0 && PRODUCT_SECTION.test(section.name) && !SHOP_FRAMING.test(section.name))\n  if (named !== -1) return named\n  const most = Math.max(0, ...sections.map((section) => section.items))\n  const byItems = most > 0 ? sections.findIndex((section) => section.items === most) : -1\n  return byItems !== -1 ? byItems : sections.length > 1 ? 1 : 0\n}\n\n/**\n * The section of a store's home its bestsellers fill (AGL-3676): the first\n * after the hero whose name says them (\"Bestsellers\", \"Featured candles\", \"New\n * arrivals\"), never one about the store's collections, its reviews or its\n * sign-up; else the first after the hero naming products at all; else the\n * first after the hero planned with items that is none of those. The\n * beta.237 Willow Wick home would otherwise have listed products in its\n * \"Shop by collection\" tiles.\n */\nfunction aiLayoutFeaturedSection(screen: AiLayoutListingScreen): number {\n  // A section about the collections that does not also name the bestsellers.\n  const other = (name: string) =>\n    (aiStorefrontSays('collections', name) && !aiStorefrontSays('featured', name)) ||\n    aiStorefrontSays('reviews', name) ||\n    aiStorefrontSays('signup', name)\n  const first = (test: (name: string, items: number) => boolean) =>\n    screen.sections.findIndex((section, index) => index > 0 && test(section.name, section.items))\n  for (const test of [\n    (name: string) => aiStorefrontSays('featured', name) && !other(name),\n    (name: string) => PRODUCT_SECTION.test(name) && !other(name),\n    (name: string, items: number) => items > 0 && !other(name),\n    (name: string) => PRODUCT_SECTION.test(name),\n  ]) {\n    const found = first(test)\n    if (found !== -1) return found\n  }\n  return -1\n}\n\n/** A section of a shop page that only opens or closes it: \"Shop intro heading\", \"Gift help call to action\". */\nconst SHOP_FRAMING = /\\b(hero|intro(?:duction)?|heading|banner|cta|call to action|contact)\\b/i\n\n/** Whether a planned page is the store's own Shop page: its address or its name says it sells. */\nexport function aiLayoutIsShopPage(screen: { slug: string; title: string }): boolean {\n  return !isHome(screen.slug) && PRODUCT_PAGE.test(`${firstSegment(screen.slug)} ${screen.title}`)\n}\n\nconst firstSegment = (slug: string) => slug.trim().replace(/^\\/+/, '').split('/')[0].toLowerCase()\nconst isHome = (slug: string) => firstSegment(slug) === ''\n\n/**\n * The sections of a site's pages that show a listing, chosen by code from the\n * plan (AGL-3676), never asked of the model:\n *\n *  - PRODUCTS. The shop's own page — the page whose address or name says it\n *    sells (`/shop`, \"Shop\", \"Products\") — shows the whole catalog in the\n *    section the plan gave the most items, else its second; and the home\n *    page features a few in its first section after the hero whose name\n *    says products (\"Featured candles\", \"Bestsellers\"), else in the first\n *    section after the hero planned with items.\n *  - POSTS. The home features the latest in its first section of items after\n *    the hero whose name says writing (\"Featured writing\", \"Latest posts\"),\n *    else its first section of items after the hero; and any other page\n *    whose name says it is about the writing does the same. The blog's own\n *    index is the platform's.\n *\n * A section placed once is placed for one listing.\n */\nexport function aiLayoutListingPlacements(\n  kind: AiLayoutListingKind,\n  screens: readonly AiLayoutListingScreen[],\n): AiLayoutListingPlacement[] {\n  const placements: AiLayoutListingPlacement[] = []\n  const place = (screen: AiLayoutListingScreen, section: number, role: AiLayoutListingRole) => {\n    if (typeof screen.id === 'string' && screen.id && section >= 0) placements.push({ screenId: screen.id, section, role })\n  }\n  const afterHero = (screen: AiLayoutListingScreen, test: (name: string, items: number) => boolean) =>\n    screen.sections.findIndex((section, index) => index > 0 && test(section.name, section.items))\n  if (kind === 'tracks') {\n    // A music site's player (AGL-3716): on its Music page, in the section that\n    // says it is about the recordings, else the one after the opening; on the\n    // home, only in a section named for them. A site with neither gets it on\n    // its home, after the opening.\n    for (const screen of screens) {\n      if (isHome(screen.slug)) {\n        place(screen, afterHero(screen, (name) => MUSIC_PAGE.test(name)), 'featured')\n        continue\n      }\n      if (!MUSIC_PAGE.test(`${firstSegment(screen.slug)} ${screen.title}`)) continue\n      const named = afterHero(screen, (name) => MUSIC_PAGE.test(name))\n      place(screen, named !== -1 ? named : screen.sections.length > 1 ? 1 : 0, 'index')\n    }\n    if (!placements.length) {\n      const home = screens.find((screen) => isHome(screen.slug))\n      if (home) place(home, home.sections.length > 1 ? 1 : 0, 'featured')\n    }\n    return placements\n  }\n  if (kind === 'reviews' || kind === 'signup') {\n    // A store's own reviews, on its home, in the section named for them; its\n    // newsletter sign-up in any page's section named for it that places no\n    // form of the plan's (AGL-3676). Neither is ever a page's opening.\n    for (const screen of screens) {\n      if (kind === 'reviews' && !isHome(screen.slug)) continue\n      place(\n        screen,\n        afterHero(\n          screen,\n          (name) => aiStorefrontSays(kind, name),\n        ),\n        kind === 'reviews' ? 'featured' : 'index',\n      )\n    }\n    return kind === 'signup'\n      ? placements.filter((placement) => {\n          const screen = screens.find((entry) => entry.id === placement.screenId)\n          return !(screen?.sections[placement.section]?.uses ?? []).some((use) => /form/i.test(use))\n        })\n      : placements\n  }\n  if (kind === 'products') {\n    for (const screen of screens) {\n      if (isHome(screen.slug)) {\n        place(screen, aiLayoutFeaturedSection(screen), 'featured')\n        continue\n      }\n      if (!aiLayoutIsShopPage(screen)) continue\n      place(screen, aiLayoutShopGridSection(screen.sections), 'index')\n    }\n    return placements\n  }\n  for (const screen of screens) {\n    if (isHome(screen.slug)) {\n      // On a blog's home the band that names the writing (\"Featured posts\n      // cards\", \"Featured journeys\") lists it; failing one, the first band of\n      // items after the hero. A live Clay Notes plan (2026-10-09) opened its\n      // home with \"What you will find\" before \"Featured posts cards\".\n      const named = afterHero(screen, (name, items) => items > 0 && POST_SECTION.test(name))\n      place(screen, named !== -1 ? named : afterHero(screen, (_name, items) => items > 0), 'featured')\n      continue\n    }\n    if (!POST_SECTION.test(screen.title)) continue\n    place(screen, afterHero(screen, (name) => POST_SECTION.test(name)), 'featured')\n  }\n  return placements\n}\n\n/**\n * The sections that list one of the site's datasets (AGL-3616): every section\n * whose plan names it in its `uses` — `new:<its name>` as the plan wrote it,\n * or its id once built. The home page features a few of its records; any\n * other page lists them all. Chosen from the plan, never asked of the model.\n */\nexport function aiLayoutRecordsPlacements(\n  dataset: { id: string; name: string },\n  screens: readonly AiLayoutListingScreen[],\n): AiLayoutListingPlacement[] {\n  const named = `new:${dataset.name}`.trim().toLowerCase()\n  const placements: AiLayoutListingPlacement[] = []\n  for (const screen of screens) {\n    if (typeof screen.id !== 'string' || !screen.id) continue\n    screen.sections.forEach((section, index) => {\n      const lists = (section.uses ?? []).some((ref) => ref === dataset.id || ref.trim().toLowerCase() === named)\n      if (lists) placements.push({ screenId: screen.id as string, section: index, role: isHome(screen.slug) ? 'featured' : 'index' })\n    })\n  }\n  return placements\n}\n"],"names":["aiStorefrontSays","AI_LAYOUT_LISTINGS_INPUT","aiLayoutListingId","kind","datasetId","AI_LAYOUT_LISTING_ELEMENTS","products","posts","tracks","reviews","signup","records","AI_LAYOUT_CART_ELEMENT","AI_LAYOUT_FEATURED_RECORDS","PLACEMENT_ROLES","KINDS","text","value","trim","LISTING_NAMES","SITE_PATH","DATASET_ID","FIELD_ID","listingFieldsOf","raw","Array","isArray","flatMap","field","id","test","name","slice","type","aiLayoutListingsOf","inputs","listings","entry","record","fields","includes","some","listing","href","action","actionLabel","actionHref","collectionSlug","placements","placement","screenId","section","role","Number","isInteger","push","map","filter","Boolean","cart","emptyAction","label","aiLayoutListingAt","find","PRODUCT_PAGE","PRODUCT_SECTION","POST_SECTION","MUSIC_PAGE","aiLayoutShopGridSection","sections","named","findIndex","index","SHOP_FRAMING","most","Math","max","items","byItems","length","aiLayoutFeaturedSection","screen","other","first","found","aiLayoutIsShopPage","isHome","slug","firstSegment","title","replace","split","toLowerCase","aiLayoutListingPlacements","screens","place","afterHero","home","uses","use","_name","aiLayoutRecordsPlacements","dataset","forEach","lists","ref"],"mappings":"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"}

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

@@ -217,18 +217,26 @@ function rotate(list, by) {
  * the compiler wrote it.
  */ export function aiLayoutPlacePictures(nodes, slots, photos) {
     const next = _extends({}, nodes);
+    // Only the page's first picture loads eagerly (rule 16, AGL-3660): a hero
+    // of several photos loaded them all eagerly, and a live Portfolio page was
+    // refused for it (2026-10-10). The slots are in document order; every later
+    // picture leaves `loading` unset, which the renderer loads when reached.
+    const lead = slots.findIndex((_, index)=>Boolean(photos[index] && next[slots[index].imageId]));
     slots.forEach((slot, index)=>{
         var _node_props;
         const photo = photos[index];
         const node = next[slot.imageId];
         if (!photo || !node) return;
+        const props = _extends({}, (_node_props = node['props']) != null ? _node_props : {});
+        delete props['loading'];
         next[slot.imageId] = _extends({}, node, {
-            props: _extends({}, (_node_props = node['props']) != null ? _node_props : {}, {
+            props: _extends({}, props, {
                 src: photo.src,
                 intrinsicWidth: photo.width,
-                intrinsicHeight: photo.height,
-                loading: slot.role === 'hero' ? 'eager' : 'lazy'
-            })
+                intrinsicHeight: photo.height
+            }, index === lead && slot.role === 'hero' ? {
+                loading: 'eager'
+            } : {})
         });
         if (slot.iconId && slot.frameId && next[slot.frameId]) {
             var _frame_nodes;