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

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/layout-language/ai-layout-language.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 { AiTool } from '../providers/contract'\nimport { AI_ICON_WORDS } from '../runtime/ai-icon-library'\n\n/**\n * The compact layout language (AGL-3660): what a model designs a page, and a\n * site's header and footer, in — and the one place its shape is declared.\n *\n * ── Why a language, not a tree ───────────────────────────────────────────\n *\n * A page used to be asked for as a raw element tree, packed as escaped JSON\n * text inside a tool call and held to the doctrine's building rules: Grid\n * items sized as strings, every child attached, one h1, a destination on\n * every button, headings under their ceiling. A real model kept about half\n * of a page's sections on the first try, and a Free section was cut off at\n * its token ceiling. The founder chose a language over a library of section\n * templates (10/7): every page is designed for its own request, so no two\n * sites come out alike, and the rules hold because CODE writes the tree.\n *\n * So the model says WHAT each section is and how it is arranged, in a few\n * words of structure, and writes every word a visitor reads; the compiler\n * (`ai-layout-compiler.ts`) turns that into the element tree with the\n * palette's elements and the theme's tokens, by construction.\n *\n * ── The shape ────────────────────────────────────────────────────────────\n *\n * A page is its plan's sections, in order. A SECTION is\n *  - `band`  — its background: `plain` (the page), `soft` (a paper band),\n *              `brand` (the brand color) or `dark` (always dark);\n *  - `cols`  — a row of columns by relative width, as `[7, 5]` or `[1, 1, 1]`,\n *              up to four; absent, one column;\n *  - `align` — `start` or `center`;\n *  - `blocks` — what it shows, top to bottom.\n *\n * A BLOCK is one thing a visitor reads or uses. Its `kind` is one of\n * `AI_LAYOUT_BLOCK_KINDS`; `col` places it in a column of the row (0 first),\n * and a block with no `col` spans the section — above the row when it comes\n * before the first placed block, below it when it comes after. `text` is its\n * words, `to` where it goes, `style` its emphasis and `icon` a word from the\n * icon library. A group — `list`, `cards`, `steps`, `stats`, `quotes`,\n * `faq` — carries its `items`, each a `title`, a `text`, and optionally its\n * own `to` and `icon`.\n *\n * Where a block goes (`to`): `page:<id>` for a page of this site (its label\n * works too), `#<n>` for section n of this page, `form` for the site's form,\n * a form's or a component's id for a `form` or `component` block, or an\n * `https:` address the brief gave.\n *\n * A site's header and footer are two sections in the same language\n * (`AI_LAYOUT_FRAME_TOOL`): the header's brand and navigation are the\n * site's own and written by the compiler, so the model gives the header its\n * band, its alignment and an optional call-to-action button; the footer is\n * a section like any other.\n *\n * ── Cheap by shape ───────────────────────────────────────────────────────\n *\n * The schema is a structured object in the tool input (never JSON text in a\n * string), small enough for a strict tool (`tool-schema-limits.spec.ts`), and\n * the language's instructions ride in the cached prefix. A section is a few\n * dozen words of structure beside its copy, so a whole page is one answer.\n */\n\n/** Every kind of block, in the order the schema lists them. */\nexport const AI_LAYOUT_BLOCK_KINDS = [\n  'eyebrow',\n  'heading',\n  'lede',\n  'text',\n  'note',\n  'list',\n  'button',\n  'image',\n  'cards',\n  'steps',\n  'stats',\n  'quotes',\n  'faq',\n  'form',\n  'component',\n] as const\n\nexport type AiLayoutBlockKind = (typeof AI_LAYOUT_BLOCK_KINDS)[number]\n\n/** The kinds that carry `items`. */\nexport const AI_LAYOUT_GROUP_KINDS: ReadonlySet<AiLayoutBlockKind> = new Set([\n  'list',\n  'cards',\n  'steps',\n  'stats',\n  'quotes',\n  'faq',\n])\n\nexport const AI_LAYOUT_BANDS = ['plain', 'soft', 'brand', 'dark'] as const\nexport type AiLayoutBand = (typeof AI_LAYOUT_BANDS)[number]\n\nexport const AI_LAYOUT_ALIGNS = ['start', 'center'] as const\nexport type AiLayoutAlign = (typeof AI_LAYOUT_ALIGNS)[number]\n\nexport const AI_LAYOUT_STYLES = [\n  'primary',\n  'secondary',\n  'quiet',\n  'large',\n] as const\nexport type AiLayoutStyle = (typeof AI_LAYOUT_STYLES)[number]\n\n/** The most columns a row holds; a fifth is folded into the fourth. */\nexport const AI_LAYOUT_MAX_COLS = 4\n\n/**\n * The most items a group shows: one under the eight copies rule 8 reads as a\n * list typed out by hand, which belongs in a dataset.\n */\nexport const AI_LAYOUT_MAX_ITEMS = 7\n\n/** The most quotes a group shows: each is a gap the owner fills with a real one. */\nexport const AI_LAYOUT_MAX_QUOTES = 3\n\nexport interface AiLayoutItem {\n  title: string\n  text: string\n  to?: string\n  icon?: string\n}\n\nexport interface AiLayoutBlock {\n  kind: AiLayoutBlockKind\n  col?: number\n  text?: string\n  to?: string\n  style?: AiLayoutStyle\n  icon?: string\n  items?: AiLayoutItem[]\n}\n\nexport interface AiLayoutSection {\n  band?: AiLayoutBand\n  cols?: number[]\n  align?: AiLayoutAlign\n  blocks: AiLayoutBlock[]\n}\n\n/** A page: its plan's sections, in order. */\nexport interface AiLayoutPageDoc {\n  sections: AiLayoutSection[]\n}\n\n/** A site's frame: the header and the footer every page renders between. */\nexport interface AiLayoutFrameDoc {\n  header: AiLayoutSection\n  footer: AiLayoutSection\n}\n\nconst ITEM_SCHEMA = {\n  type: 'object',\n  additionalProperties: false,\n  required: ['title', 'text', 'to', 'icon'],\n  properties: {\n    title: { type: 'string' },\n    text: { type: 'string' },\n    to: { type: 'string' },\n    icon: { type: 'string' },\n  },\n} as const\n\nconst BLOCK_SCHEMA = {\n  type: 'object',\n  additionalProperties: false,\n  required: ['kind', 'col', 'text', 'to', 'style', 'icon', 'items'],\n  properties: {\n    kind: { type: 'string', enum: [...AI_LAYOUT_BLOCK_KINDS] },\n    col: { type: 'integer' },\n    text: { type: 'string' },\n    to: { type: 'string' },\n    style: { type: 'string', enum: [...AI_LAYOUT_STYLES, 'none'] },\n    icon: { type: 'string' },\n    items: { type: 'array', items: ITEM_SCHEMA },\n  },\n} as const\n\nconst SECTION_SCHEMA = {\n  type: 'object',\n  additionalProperties: false,\n  required: ['band', 'cols', 'align', 'blocks'],\n  properties: {\n    band: { type: 'string', enum: [...AI_LAYOUT_BANDS] },\n    cols: { type: 'array', items: { type: 'integer' } },\n    align: { type: 'string', enum: [...AI_LAYOUT_ALIGNS] },\n    blocks: { type: 'array', items: BLOCK_SCHEMA },\n  },\n} as const\n\n/** The page tool: every section of one page, in plan order, in one answer. */\nexport const AI_LAYOUT_PAGE_TOOL: AiTool = {\n  name: 'submit_page',\n  description:\n    'Submit the page: one entry in sections for each planned section, in order, in the layout language.',\n  strict: true,\n  inputSchema: {\n    type: 'object',\n    additionalProperties: false,\n    required: ['sections'],\n    properties: { sections: { type: 'array', items: SECTION_SCHEMA } },\n  },\n}\n\n/** The frame tool: the site's header and footer, in the same language. */\nexport const AI_LAYOUT_FRAME_TOOL: AiTool = {\n  name: 'submit_frame',\n  description:\n    \"Submit the site's header and footer, each as a section in the layout language.\",\n  strict: true,\n  inputSchema: {\n    type: 'object',\n    additionalProperties: false,\n    required: ['header', 'footer'],\n    properties: { header: SECTION_SCHEMA, footer: SECTION_SCHEMA },\n  },\n}\n\n/**\n * The language as a model is taught it: the cached instructions both doors\n * share. Every word of copy is the model's; this says only how a design is\n * written down and what each word becomes.\n */\nexport const AI_LAYOUT_LANGUAGE_TEXT = [\n  \"You design web pages in a compact layout language. You decide the structure and write every word; the platform turns your design into the page, with the site's theme, spacing and type, so never describe styling beyond the words below.\",\n  '',\n  'A page is a list of sections, one for each section the plan names, in that order. A section has:',\n  '- band: plain (the page background), soft (a light band), brand (the brand color) or dark (always dark). Vary the bands down a page so neighboring sections read apart; keep brand and dark to one or two sections a page.',\n  '- cols: relative column widths for a row, such as [1, 1] for halves, [7, 5] for a wide and a narrow column, or [1, 1, 1]; at most 4. [] for one column.',\n  '- align: start or center.',\n  '- blocks: what the section shows, top to bottom. A block with col 0 or more goes in that column of the row (0 is the first); a block with col -1 spans the whole section, above the row when it comes first and below it when it comes last.',\n  'Every field is always written: a block that does not use one writes \"\" (text, to, icon), \"none\" (style), -1 (col) or [] (items); an item that does not use one writes \"\".',\n  '',\n  'Block kinds:',\n  \"- eyebrow: a short label above a heading. heading: a heading; the first heading of the page's first section is the page's title, and the first heading of every other section is that section's heading. lede: the larger sentence under a heading. text: a paragraph. note: small print.\",\n  '- button: text is the label and to says where it goes; style primary, secondary or quiet. Two buttons in a row read as a pair.',\n  '- image: text describes the picture to place, which becomes its alt text; the owner adds the picture. icon names a drawing to show until then.',\n  '- list: items are the lines (title only; text may be empty).',\n  \"- cards, steps, stats, faq: items, each with a title and a text. cards are features or services; steps are numbered; stats are a figure (title) with its label (text), only for figures the brief gives; faq items are a question (title) and its answer (text). Use no quotes block: the site has no customer's words to show.\",\n  \"- form: places a saved form by its id in to. component: places a reusable component by its id in to; its items fill the component's props, title the prop name and text the value.\",\n  '- style large on a heading makes the page title display-sized. icon (on a block or an item) is one of: ' +\n    AI_ICON_WORDS.join(', ') +\n    '.',\n  '',\n  \"Where a link goes (to): page:<page id> for a page of this site; #<n> for section n of this page (counted from 1); form for the site's form; or an https: address the brief gives. A button the page has nowhere to send is left out. A to value is never written into words: in text, name a page by its title.\",\n  '',\n  \"Writing: plain, specific copy in the site's voice, from the brief, the business and its audience, never filler. Keep a page title under 70 characters and a section heading under 80. The site is published exactly as you write it, so where the brief leaves out a fact such as a price, a figure, a name, a phone number, an email, an address or opening hours, leave it out: write the sentence without it, and make no list line, card or contact row for it. Never write a placeholder or a gap in square brackets, and never invent the fact. Never invent a customer, a review, an award or a statistic.\",\n  '',\n  'Design each page for this business and this request: choose the bands, the rows and the blocks that tell its story best, so no two sites read alike.',\n].join('\\n')\n\n// ── Reading an answer ────────────────────────────────────────────────────\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n\nfunction text(value: unknown): string | undefined {\n  return typeof value === 'string' && value.trim() ? value : undefined\n}\n\nfunction oneOf<T extends string>(\n  value: unknown,\n  values: readonly T[],\n): T | undefined {\n  return typeof value === 'string' &&\n    (values as readonly string[]).includes(value)\n    ? (value as T)\n    : undefined\n}\n\n/** What the reader settled on its own, for the job's record and the specs. */\nexport interface AiLayoutSettlement {\n  /** Where: `sections[2].blocks[1]`, `header`. */\n  at: string\n  what: string\n}\n\nfunction readItem(raw: unknown): AiLayoutItem | null {\n  if (!isRecord(raw)) return null\n  const item: AiLayoutItem = {\n    title: typeof raw['title'] === 'string' ? raw['title'] : '',\n    text: typeof raw['text'] === 'string' ? raw['text'] : '',\n  }\n  if (!item.title.trim() && !item.text.trim()) return null\n  const to = text(raw['to'])\n  const icon = text(raw['icon'])\n  return { ...item, ...(to ? { to } : {}), ...(icon ? { icon } : {}) }\n}\n\nfunction readBlock(\n  raw: unknown,\n  at: string,\n  settled: AiLayoutSettlement[],\n): AiLayoutBlock | null {\n  if (!isRecord(raw)) {\n    settled.push({ at, what: 'not a block; left out' })\n    return null\n  }\n  const kind = oneOf(raw['kind'], AI_LAYOUT_BLOCK_KINDS)\n  if (!kind) {\n    settled.push({\n      at,\n      what: `unknown kind ${JSON.stringify(raw['kind'] ?? null)}; left out`,\n    })\n    return null\n  }\n  const block: AiLayoutBlock = { kind }\n  if (\n    typeof raw['col'] === 'number' &&\n    Number.isInteger(raw['col']) &&\n    raw['col'] >= 0\n  )\n    block.col = raw['col']\n  const words = text(raw['text'])\n  if (words) block.text = words\n  const to = text(raw['to'])\n  if (to) block.to = to.trim()\n  const style = oneOf(raw['style'], AI_LAYOUT_STYLES)\n  if (style) block.style = style\n  const icon = text(raw['icon'])\n  if (icon) block.icon = icon.trim().toLowerCase()\n  if (AI_LAYOUT_GROUP_KINDS.has(kind) || kind === 'component') {\n    const items = (Array.isArray(raw['items']) ? raw['items'] : [])\n      .map(readItem)\n      .filter((item): item is AiLayoutItem => !!item)\n    const most =\n      kind === 'quotes'\n        ? AI_LAYOUT_MAX_QUOTES\n        : kind === 'component'\n          ? Infinity\n          : AI_LAYOUT_MAX_ITEMS\n    if (items.length > most)\n      settled.push({\n        at,\n        what: `${items.length} items; the first ${most} kept`,\n      })\n    if (items.length) block.items = items.slice(0, most)\n  }\n  // A block with nothing to show is no block: a group with no items, words\n  // with no words. A form or a component may name its record alone.\n  const empty = AI_LAYOUT_GROUP_KINDS.has(kind)\n    ? !block.items?.length\n    : kind === 'form' || kind === 'component'\n      ? false\n      : !block.text\n  if (empty) {\n    settled.push({ at, what: `an empty ${kind}; left out` })\n    return null\n  }\n  return block\n}\n\n/** A section read from an answer, or `null` with why it could not be. */\nexport function aiReadLayoutSection(\n  raw: unknown,\n  at: string,\n  settled: AiLayoutSettlement[],\n): AiLayoutSection | null {\n  if (!isRecord(raw)) return null\n  const section: AiLayoutSection = { blocks: [] }\n  const band = oneOf(raw['band'], AI_LAYOUT_BANDS)\n  if (band) section.band = band\n  const align = oneOf(raw['align'], AI_LAYOUT_ALIGNS)\n  if (align) section.align = align\n  if (Array.isArray(raw['cols'])) {\n    const cols = raw['cols'].filter(\n      (value): value is number =>\n        typeof value === 'number' && Number.isFinite(value) && value > 0,\n    )\n    if (cols.length > AI_LAYOUT_MAX_COLS) {\n      settled.push({\n        at: `${at}.cols`,\n        what: `${cols.length} columns; the first ${AI_LAYOUT_MAX_COLS} kept`,\n      })\n    }\n    if (cols.length >= 2)\n      section.cols = cols\n        .slice(0, AI_LAYOUT_MAX_COLS)\n        .map((value) => Math.min(12, Math.max(1, Math.round(value))))\n  }\n  const blocks = Array.isArray(raw['blocks']) ? raw['blocks'] : []\n  blocks.forEach((entry, index) => {\n    const block = readBlock(entry, `${at}.blocks[${index}]`, settled)\n    if (!block) return\n    if (\n      block.col !== undefined &&\n      section.cols &&\n      block.col >= section.cols.length\n    ) {\n      settled.push({\n        at: `${at}.blocks[${index}]`,\n        what: `column ${block.col} of ${section.cols.length}; placed in the last`,\n      })\n      block.col = section.cols.length - 1\n    }\n    if (block.col !== undefined && !section.cols) delete block.col\n    section.blocks.push(block)\n  })\n  return section.blocks.length ? section : null\n}\n\n/** A page answer read: the sections it gave, by plan position, and the positions it could not. */\nexport interface AiLayoutPageReading {\n  /** One entry per planned section; `null` where the answer gave nothing usable. */\n  sections: Array<AiLayoutSection | null>\n  settled: AiLayoutSettlement[]\n}\n\n/** What a planned section is, as the reader matches an answer's sections to it. */\nexport interface AiLayoutPlannedSection {\n  name: string\n  items: number\n  /** What the plan places in it: a form it binds there is one of these. */\n  uses?: readonly string[]\n}\n\n/** A planned section's name that asks for a form: a contact, an inquiry, a booking. */\nconst FORM_SECTION =\n  /\\b(form|contact|get in touch|reach|write|message|inquir(?:y|ies|e)|enquir(?:y|ies|e)|book(?:ing|ings)?|reserv(?:e|ation|ations)|quote|appointments?|rsvp|sign ?up|subscribe|newsletter|apply|application|register)\\b/i\n\n/** Whether a planned section is one a form may fill: it names one, or the plan binds a form there. */\nfunction takesForm(planned: AiLayoutPlannedSection): boolean {\n  return FORM_SECTION.test(planned.name) || (planned.uses ?? []).some((ref) => /\\bform\\b/i.test(ref))\n}\n\n/** What a form's section scores against a planned section that asks for no form: never chosen while another fits. */\nconst AI_LAYOUT_FORM_MISFIT = -100\n\nconst WORD = /[a-z0-9]+/g\nconst STOP = new Set(['a', 'an', 'and', 'the', 'of', 'for', 'to', 'our', 'your', 'with', 'in', 'on', 'we', 'us', 'you'])\nconst wordsOf = (text: string) => new Set((text.toLowerCase().match(WORD) ?? []).filter((word) => !STOP.has(word)))\n\n/** The kinds that show a section's repeated items. */\nconst ITEM_KINDS = new Set(['list', 'cards', 'steps', 'stats', 'quotes', 'faq', 'component'])\n\n/**\n * How well an answer's section fits a planned one: the words its headings\n * share with the plan's name, and whether it shows items where the plan\n * asked for them and none where it asked for none.\n *\n * A shared heading word outweighs the items (AGL-3660): a live portfolio's\n * plan gave \"Works Gallery\" no items, and its \"Selected works\" cards lost the\n * place to an inquiry form that shared no word with it. A section holding a\n * form fills only a planned section that asks for one — by its name, or a\n * form the plan binds there — so the form is never a page's stand-in.\n */\nfunction fit(raw: unknown, planned: AiLayoutPlannedSection): number {\n  const blocks = isRecord(raw) && Array.isArray(raw['blocks']) ? raw['blocks'].filter(isRecord) : []\n  const said = wordsOf(\n    blocks\n      .filter((block) => block['kind'] === 'heading' || block['kind'] === 'eyebrow')\n      .map((block) => String(block['text'] ?? ''))\n      .join(' '),\n  )\n  const named = wordsOf(planned.name)\n  let shared = 0\n  for (const word of named) if (said.has(word) || [...said].some((other) => other.startsWith(word) || word.startsWith(other))) shared += 1\n  const showsItems = blocks.some((block) => ITEM_KINDS.has(String(block['kind'])) && (block['kind'] === 'component' || (Array.isArray(block['items']) && block['items'].length > 0)))\n  const wantsItems = planned.items > 0\n  const holdsForm = blocks.some((block) => block['kind'] === 'form')\n  if (holdsForm && !takesForm(planned)) return AI_LAYOUT_FORM_MISFIT\n  return shared * 2 + (wantsItems === showsItems ? 0.5 : -0.5)\n}\n\n/**\n * The answer's sections that best match the plan, in order, where it gave\n * more than the plan names (AGL-3660): a model that opened a page with a\n * hero of its own, or closed it with a call to action, shifted every planned\n * section by one, and the cut fell on the plan's last sections — the ones\n * that carried its items. Each planned section takes the answer's section\n * that fits it best, keeping the answer's order.\n */\nfunction alignSections(given: readonly unknown[], planned: readonly AiLayoutPlannedSection[]): number[] {\n  const n = given.length\n  const m = planned.length\n  // best[i][j]: the best score placing plan sections j.. on answer sections i..\n  const best: number[][] = Array.from({ length: n + 1 }, () => Array(m + 1).fill(-Infinity))\n  for (let i = 0; i <= n; i += 1) best[i][m] = 0\n  for (let i = n - 1; i >= 0; i -= 1) {\n    for (let j = m - 1; j >= 0; j -= 1) {\n      if (n - i < m - j) continue\n      best[i][j] = Math.max(best[i + 1][j], fit(given[i], planned[j]) + best[i + 1][j + 1])\n    }\n  }\n  const picked: number[] = []\n  let i = 0\n  for (let j = 0; j < m; j += 1) {\n    while (i < n && best[i][j] !== fit(given[i], planned[j]) + best[i + 1][j + 1]) i += 1\n    picked.push(i)\n    i += 1\n  }\n  return picked\n}\n\n/**\n * The page an answer describes, against the sections its plan names: each\n * planned section takes the answer's section at its position — or, where the\n * answer gave more sections than the plan names and the plan's sections are\n * given, the one that fits it best (`alignSections`) — an answer's extra\n * sections are left out, and a planned section the answer left empty or out\n * is `null` — the one thing a re-ask asks for again.\n */\nexport function aiReadLayoutPage(\n  raw: unknown,\n  planned: number,\n  plan?: readonly AiLayoutPlannedSection[],\n): AiLayoutPageReading {\n  const settled: AiLayoutSettlement[] = []\n  const given =\n    isRecord(raw) && Array.isArray(raw['sections']) ? raw['sections'] : []\n  const aligned =\n    given.length > planned && plan && plan.length === planned\n      ? alignSections(given, plan)\n      : Array.from({ length: planned }, (_, index) => index)\n  if (given.length > planned) {\n    settled.push({\n      at: 'sections',\n      what: `${given.length} sections for a plan of ${planned}; ${\n        aligned.every((at, index) => at === index) ? 'the extra left out' : `sections ${aligned.map((at) => at + 1).join(', ')} kept as the plan's`\n      }`,\n    })\n  }\n  const sections = aligned.map((at, index) =>\n    aiReadLayoutSection(given[at], `sections[${index}]`, settled),\n  )\n  return { sections, settled }\n}\n\n/** A frame answer read: a header and a footer, either `null` where it was not usable. */\nexport function aiReadLayoutFrame(raw: unknown): {\n  header: AiLayoutSection | null\n  footer: AiLayoutSection | null\n  settled: AiLayoutSettlement[]\n} {\n  const settled: AiLayoutSettlement[] = []\n  const record = isRecord(raw) ? raw : {}\n  // A header needs no block of its own: its brand and navigation are the\n  // site's, so an empty one is a plain bar.\n  const header = isRecord(record['header'])\n    ? (aiReadLayoutSection(record['header'], 'header', settled) ??\n      readBare(record['header']))\n    : null\n  const footer = aiReadLayoutSection(record['footer'], 'footer', settled)\n  return { header, footer, settled }\n}\n\n/** A section with no usable block, keeping only its band and alignment. */\nfunction readBare(raw: Record<string, unknown>): AiLayoutSection {\n  const band = oneOf(raw['band'], AI_LAYOUT_BANDS)\n  const align = oneOf(raw['align'], AI_LAYOUT_ALIGNS)\n  return { ...(band ? { band } : {}), ...(align ? { align } : {}), blocks: [] }\n}\n"],"names":["AI_ICON_WORDS","AI_LAYOUT_BLOCK_KINDS","AI_LAYOUT_GROUP_KINDS","Set","AI_LAYOUT_BANDS","AI_LAYOUT_ALIGNS","AI_LAYOUT_STYLES","AI_LAYOUT_MAX_COLS","AI_LAYOUT_MAX_ITEMS","AI_LAYOUT_MAX_QUOTES","ITEM_SCHEMA","type","additionalProperties","required","properties","title","text","to","icon","BLOCK_SCHEMA","kind","enum","col","style","items","SECTION_SCHEMA","band","cols","align","blocks","AI_LAYOUT_PAGE_TOOL","name","description","strict","inputSchema","sections","AI_LAYOUT_FRAME_TOOL","header","footer","AI_LAYOUT_LANGUAGE_TEXT","join","isRecord","value","Array","isArray","trim","undefined","oneOf","values","includes","readItem","raw","item","readBlock","at","settled","block","push","what","JSON","stringify","Number","isInteger","words","toLowerCase","has","map","filter","most","Infinity","length","slice","empty","aiReadLayoutSection","section","isFinite","Math","min","max","round","forEach","entry","index","FORM_SECTION","takesForm","planned","test","uses","some","ref","AI_LAYOUT_FORM_MISFIT","WORD","STOP","wordsOf","match","word","ITEM_KINDS","fit","said","String","named","shared","other","startsWith","showsItems","wantsItems","holdsForm","alignSections","given","n","m","best","from","fill","i","j","picked","aiReadLayoutPage","plan","aligned","_","every","aiReadLayoutFrame","record","readBare"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC;AAGD,SAASA,aAAa,QAAQ,gCAA4B;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwDC,GAED,6DAA6D,GAC7D,OAAO,MAAMC,wBAAwB;IACnC;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;CACD,CAAS;AAIV,kCAAkC,GAClC,OAAO,MAAMC,wBAAwD,IAAIC,IAAI;IAC3E;IACA;IACA;IACA;IACA;IACA;CACD,EAAC;AAEF,OAAO,MAAMC,kBAAkB;IAAC;IAAS;IAAQ;IAAS;CAAO,CAAS;AAG1E,OAAO,MAAMC,mBAAmB;IAAC;IAAS;CAAS,CAAS;AAG5D,OAAO,MAAMC,mBAAmB;IAC9B;IACA;IACA;IACA;CACD,CAAS;AAGV,qEAAqE,GACrE,OAAO,MAAMC,qBAAqB,EAAC;AAEnC;;;CAGC,GACD,OAAO,MAAMC,sBAAsB,EAAC;AAEpC,kFAAkF,GAClF,OAAO,MAAMC,uBAAuB,EAAC;AAqCrC,MAAMC,cAAc;IAClBC,MAAM;IACNC,sBAAsB;IACtBC,UAAU;QAAC;QAAS;QAAQ;QAAM;KAAO;IACzCC,YAAY;QACVC,OAAO;YAAEJ,MAAM;QAAS;QACxBK,MAAM;YAAEL,MAAM;QAAS;QACvBM,IAAI;YAAEN,MAAM;QAAS;QACrBO,MAAM;YAAEP,MAAM;QAAS;IACzB;AACF;AAEA,MAAMQ,eAAe;IACnBR,MAAM;IACNC,sBAAsB;IACtBC,UAAU;QAAC;QAAQ;QAAO;QAAQ;QAAM;QAAS;QAAQ;KAAQ;IACjEC,YAAY;QACVM,MAAM;YAAET,MAAM;YAAUU,MAAM;mBAAIpB;aAAsB;QAAC;QACzDqB,KAAK;YAAEX,MAAM;QAAU;QACvBK,MAAM;YAAEL,MAAM;QAAS;QACvBM,IAAI;YAAEN,MAAM;QAAS;QACrBY,OAAO;YAAEZ,MAAM;YAAUU,MAAM;mBAAIf;gBAAkB;aAAO;QAAC;QAC7DY,MAAM;YAAEP,MAAM;QAAS;QACvBa,OAAO;YAAEb,MAAM;YAASa,OAAOd;QAAY;IAC7C;AACF;AAEA,MAAMe,iBAAiB;IACrBd,MAAM;IACNC,sBAAsB;IACtBC,UAAU;QAAC;QAAQ;QAAQ;QAAS;KAAS;IAC7CC,YAAY;QACVY,MAAM;YAAEf,MAAM;YAAUU,MAAM;mBAAIjB;aAAgB;QAAC;QACnDuB,MAAM;YAAEhB,MAAM;YAASa,OAAO;gBAAEb,MAAM;YAAU;QAAE;QAClDiB,OAAO;YAAEjB,MAAM;YAAUU,MAAM;mBAAIhB;aAAiB;QAAC;QACrDwB,QAAQ;YAAElB,MAAM;YAASa,OAAOL;QAAa;IAC/C;AACF;AAEA,4EAA4E,GAC5E,OAAO,MAAMW,sBAA8B;IACzCC,MAAM;IACNC,aACE;IACFC,QAAQ;IACRC,aAAa;QACXvB,MAAM;QACNC,sBAAsB;QACtBC,UAAU;YAAC;SAAW;QACtBC,YAAY;YAAEqB,UAAU;gBAAExB,MAAM;gBAASa,OAAOC;YAAe;QAAE;IACnE;AACF,EAAC;AAED,wEAAwE,GACxE,OAAO,MAAMW,uBAA+B;IAC1CL,MAAM;IACNC,aACE;IACFC,QAAQ;IACRC,aAAa;QACXvB,MAAM;QACNC,sBAAsB;QACtBC,UAAU;YAAC;YAAU;SAAS;QAC9BC,YAAY;YAAEuB,QAAQZ;YAAgBa,QAAQb;QAAe;IAC/D;AACF,EAAC;AAED;;;;CAIC,GACD,OAAO,MAAMc,0BAA0B;IACrC;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA,4GACEvC,cAAcwC,IAAI,CAAC,QACnB;IACF;IACA;IACA;IACA;IACA;IACA;CACD,CAACA,IAAI,CAAC,MAAK;AAEZ,4EAA4E;AAE5E,SAASC,SAASC,KAAc;IAC9B,OAAO,OAAOA,UAAU,YAAYA,UAAU,QAAQ,CAACC,MAAMC,OAAO,CAACF;AACvE;AAEA,SAAS1B,KAAK0B,KAAc;IAC1B,OAAO,OAAOA,UAAU,YAAYA,MAAMG,IAAI,KAAKH,QAAQI;AAC7D;AAEA,SAASC,MACPL,KAAc,EACdM,MAAoB;IAEpB,OAAO,OAAON,UAAU,YACtB,AAACM,OAA6BC,QAAQ,CAACP,SACpCA,QACDI;AACN;AASA,SAASI,SAASC,GAAY;IAC5B,IAAI,CAACV,SAASU,MAAM,OAAO;IAC3B,MAAMC,OAAqB;QACzBrC,OAAO,OAAOoC,GAAG,CAAC,QAAQ,KAAK,WAAWA,GAAG,CAAC,QAAQ,GAAG;QACzDnC,MAAM,OAAOmC,GAAG,CAAC,OAAO,KAAK,WAAWA,GAAG,CAAC,OAAO,GAAG;IACxD;IACA,IAAI,CAACC,KAAKrC,KAAK,CAAC8B,IAAI,MAAM,CAACO,KAAKpC,IAAI,CAAC6B,IAAI,IAAI,OAAO;IACpD,MAAM5B,KAAKD,KAAKmC,GAAG,CAAC,KAAK;IACzB,MAAMjC,OAAOF,KAAKmC,GAAG,CAAC,OAAO;IAC7B,OAAO,aAAKC,MAAUnC,KAAK;QAAEA;IAAG,IAAI,CAAC,GAAQC,OAAO;QAAEA;IAAK,IAAI,CAAC;AAClE;AAEA,SAASmC,UACPF,GAAY,EACZG,EAAU,EACVC,OAA6B;QAiDxBC;IA/CL,IAAI,CAACf,SAASU,MAAM;QAClBI,QAAQE,IAAI,CAAC;YAAEH;YAAII,MAAM;QAAwB;QACjD,OAAO;IACT;IACA,MAAMtC,OAAO2B,MAAMI,GAAG,CAAC,OAAO,EAAElD;IAChC,IAAI,CAACmB,MAAM;YAG8B+B;QAFvCI,QAAQE,IAAI,CAAC;YACXH;YACAI,MAAM,CAAC,aAAa,EAAEC,KAAKC,SAAS,EAACT,YAAAA,GAAG,CAAC,OAAO,YAAXA,YAAe,MAAM,UAAU,CAAC;QACvE;QACA,OAAO;IACT;IACA,MAAMK,QAAuB;QAAEpC;IAAK;IACpC,IACE,OAAO+B,GAAG,CAAC,MAAM,KAAK,YACtBU,OAAOC,SAAS,CAACX,GAAG,CAAC,MAAM,KAC3BA,GAAG,CAAC,MAAM,IAAI,GAEdK,MAAMlC,GAAG,GAAG6B,GAAG,CAAC,MAAM;IACxB,MAAMY,QAAQ/C,KAAKmC,GAAG,CAAC,OAAO;IAC9B,IAAIY,OAAOP,MAAMxC,IAAI,GAAG+C;IACxB,MAAM9C,KAAKD,KAAKmC,GAAG,CAAC,KAAK;IACzB,IAAIlC,IAAIuC,MAAMvC,EAAE,GAAGA,GAAG4B,IAAI;IAC1B,MAAMtB,QAAQwB,MAAMI,GAAG,CAAC,QAAQ,EAAE7C;IAClC,IAAIiB,OAAOiC,MAAMjC,KAAK,GAAGA;IACzB,MAAML,OAAOF,KAAKmC,GAAG,CAAC,OAAO;IAC7B,IAAIjC,MAAMsC,MAAMtC,IAAI,GAAGA,KAAK2B,IAAI,GAAGmB,WAAW;IAC9C,IAAI9D,sBAAsB+D,GAAG,CAAC7C,SAASA,SAAS,aAAa;QAC3D,MAAMI,QAAQ,AAACmB,CAAAA,MAAMC,OAAO,CAACO,GAAG,CAAC,QAAQ,IAAIA,GAAG,CAAC,QAAQ,GAAG,EAAE,AAAD,EAC1De,GAAG,CAAChB,UACJiB,MAAM,CAAC,CAACf,OAA+B,CAAC,CAACA;QAC5C,MAAMgB,OACJhD,SAAS,WACLX,uBACAW,SAAS,cACPiD,WACA7D;QACR,IAAIgB,MAAM8C,MAAM,GAAGF,MACjBb,QAAQE,IAAI,CAAC;YACXH;YACAI,MAAM,GAAGlC,MAAM8C,MAAM,CAAC,kBAAkB,EAAEF,KAAK,KAAK,CAAC;QACvD;QACF,IAAI5C,MAAM8C,MAAM,EAAEd,MAAMhC,KAAK,GAAGA,MAAM+C,KAAK,CAAC,GAAGH;IACjD;IACA,yEAAyE;IACzE,kEAAkE;IAClE,MAAMI,QAAQtE,sBAAsB+D,GAAG,CAAC7C,QACpC,GAACoC,eAAAA,MAAMhC,KAAK,qBAAXgC,aAAac,MAAM,IACpBlD,SAAS,UAAUA,SAAS,cAC1B,QACA,CAACoC,MAAMxC,IAAI;IACjB,IAAIwD,OAAO;QACTjB,QAAQE,IAAI,CAAC;YAAEH;YAAII,MAAM,CAAC,SAAS,EAAEtC,KAAK,UAAU,CAAC;QAAC;QACtD,OAAO;IACT;IACA,OAAOoC;AACT;AAEA,uEAAuE,GACvE,OAAO,SAASiB,oBACdtB,GAAY,EACZG,EAAU,EACVC,OAA6B;IAE7B,IAAI,CAACd,SAASU,MAAM,OAAO;IAC3B,MAAMuB,UAA2B;QAAE7C,QAAQ,EAAE;IAAC;IAC9C,MAAMH,OAAOqB,MAAMI,GAAG,CAAC,OAAO,EAAE/C;IAChC,IAAIsB,MAAMgD,QAAQhD,IAAI,GAAGA;IACzB,MAAME,QAAQmB,MAAMI,GAAG,CAAC,QAAQ,EAAE9C;IAClC,IAAIuB,OAAO8C,QAAQ9C,KAAK,GAAGA;IAC3B,IAAIe,MAAMC,OAAO,CAACO,GAAG,CAAC,OAAO,GAAG;QAC9B,MAAMxB,OAAOwB,GAAG,CAAC,OAAO,CAACgB,MAAM,CAC7B,CAACzB,QACC,OAAOA,UAAU,YAAYmB,OAAOc,QAAQ,CAACjC,UAAUA,QAAQ;QAEnE,IAAIf,KAAK2C,MAAM,GAAG/D,oBAAoB;YACpCgD,QAAQE,IAAI,CAAC;gBACXH,IAAI,GAAGA,GAAG,KAAK,CAAC;gBAChBI,MAAM,GAAG/B,KAAK2C,MAAM,CAAC,oBAAoB,EAAE/D,mBAAmB,KAAK,CAAC;YACtE;QACF;QACA,IAAIoB,KAAK2C,MAAM,IAAI,GACjBI,QAAQ/C,IAAI,GAAGA,KACZ4C,KAAK,CAAC,GAAGhE,oBACT2D,GAAG,CAAC,CAACxB,QAAUkC,KAAKC,GAAG,CAAC,IAAID,KAAKE,GAAG,CAAC,GAAGF,KAAKG,KAAK,CAACrC;IAC1D;IACA,MAAMb,SAASc,MAAMC,OAAO,CAACO,GAAG,CAAC,SAAS,IAAIA,GAAG,CAAC,SAAS,GAAG,EAAE;IAChEtB,OAAOmD,OAAO,CAAC,CAACC,OAAOC;QACrB,MAAM1B,QAAQH,UAAU4B,OAAO,GAAG3B,GAAG,QAAQ,EAAE4B,MAAM,CAAC,CAAC,EAAE3B;QACzD,IAAI,CAACC,OAAO;QACZ,IACEA,MAAMlC,GAAG,KAAKwB,aACd4B,QAAQ/C,IAAI,IACZ6B,MAAMlC,GAAG,IAAIoD,QAAQ/C,IAAI,CAAC2C,MAAM,EAChC;YACAf,QAAQE,IAAI,CAAC;gBACXH,IAAI,GAAGA,GAAG,QAAQ,EAAE4B,MAAM,CAAC,CAAC;gBAC5BxB,MAAM,CAAC,OAAO,EAAEF,MAAMlC,GAAG,CAAC,IAAI,EAAEoD,QAAQ/C,IAAI,CAAC2C,MAAM,CAAC,oBAAoB,CAAC;YAC3E;YACAd,MAAMlC,GAAG,GAAGoD,QAAQ/C,IAAI,CAAC2C,MAAM,GAAG;QACpC;QACA,IAAId,MAAMlC,GAAG,KAAKwB,aAAa,CAAC4B,QAAQ/C,IAAI,EAAE,OAAO6B,MAAMlC,GAAG;QAC9DoD,QAAQ7C,MAAM,CAAC4B,IAAI,CAACD;IACtB;IACA,OAAOkB,QAAQ7C,MAAM,CAACyC,MAAM,GAAGI,UAAU;AAC3C;AAiBA,qFAAqF,GACrF,MAAMS,eACJ;AAEF,oGAAoG,GACpG,SAASC,UAAUC,OAA+B;QACLA;IAA3C,OAAOF,aAAaG,IAAI,CAACD,QAAQtD,IAAI,KAAK,EAACsD,gBAAAA,QAAQE,IAAI,YAAZF,gBAAgB,EAAE,EAAEG,IAAI,CAAC,CAACC,MAAQ,YAAYH,IAAI,CAACG;AAChG;AAEA,mHAAmH,GACnH,MAAMC,wBAAwB,CAAC;AAE/B,MAAMC,OAAO;AACb,MAAMC,OAAO,IAAIzF,IAAI;IAAC;IAAK;IAAM;IAAO;IAAO;IAAM;IAAO;IAAM;IAAO;IAAQ;IAAQ;IAAM;IAAM;IAAM;IAAM;CAAM;AACvH,MAAM0F,UAAU,CAAC7E;QAA0BA;WAAT,IAAIb,IAAI,EAACa,0BAAAA,KAAKgD,WAAW,GAAG8B,KAAK,CAACH,iBAAzB3E,0BAAkC,EAAE,EAAEmD,MAAM,CAAC,CAAC4B,OAAS,CAACH,KAAK3B,GAAG,CAAC8B;;AAE5G,oDAAoD,GACpD,MAAMC,aAAa,IAAI7F,IAAI;IAAC;IAAQ;IAAS;IAAS;IAAS;IAAU;IAAO;CAAY;AAE5F;;;;;;;;;;CAUC,GACD,SAAS8F,IAAI9C,GAAY,EAAEkC,OAA+B;IACxD,MAAMxD,SAASY,SAASU,QAAQR,MAAMC,OAAO,CAACO,GAAG,CAAC,SAAS,IAAIA,GAAG,CAAC,SAAS,CAACgB,MAAM,CAAC1B,YAAY,EAAE;IAClG,MAAMyD,OAAOL,QACXhE,OACGsC,MAAM,CAAC,CAACX,QAAUA,KAAK,CAAC,OAAO,KAAK,aAAaA,KAAK,CAAC,OAAO,KAAK,WACnEU,GAAG,CAAC,CAACV;YAAiBA;eAAP2C,QAAO3C,cAAAA,KAAK,CAAC,OAAO,YAAbA,cAAiB;OACvChB,IAAI,CAAC;IAEV,MAAM4D,QAAQP,QAAQR,QAAQtD,IAAI;IAClC,IAAIsE,SAAS;IACb,KAAK,MAAMN,QAAQK,MAAO,IAAIF,KAAKjC,GAAG,CAAC8B,SAAS;WAAIG;KAAK,CAACV,IAAI,CAAC,CAACc,QAAUA,MAAMC,UAAU,CAACR,SAASA,KAAKQ,UAAU,CAACD,SAASD,UAAU;IACvI,MAAMG,aAAa3E,OAAO2D,IAAI,CAAC,CAAChC,QAAUwC,WAAW/B,GAAG,CAACkC,OAAO3C,KAAK,CAAC,OAAO,MAAOA,CAAAA,KAAK,CAAC,OAAO,KAAK,eAAgBb,MAAMC,OAAO,CAACY,KAAK,CAAC,QAAQ,KAAKA,KAAK,CAAC,QAAQ,CAACc,MAAM,GAAG,CAAC;IAChL,MAAMmC,aAAapB,QAAQ7D,KAAK,GAAG;IACnC,MAAMkF,YAAY7E,OAAO2D,IAAI,CAAC,CAAChC,QAAUA,KAAK,CAAC,OAAO,KAAK;IAC3D,IAAIkD,aAAa,CAACtB,UAAUC,UAAU,OAAOK;IAC7C,OAAOW,SAAS,IAAKI,CAAAA,eAAeD,aAAa,MAAM,CAAC,GAAE;AAC5D;AAEA;;;;;;;CAOC,GACD,SAASG,cAAcC,KAAyB,EAAEvB,OAA0C;IAC1F,MAAMwB,IAAID,MAAMtC,MAAM;IACtB,MAAMwC,IAAIzB,QAAQf,MAAM;IACxB,8EAA8E;IAC9E,MAAMyC,OAAmBpE,MAAMqE,IAAI,CAAC;QAAE1C,QAAQuC,IAAI;IAAE,GAAG,IAAMlE,MAAMmE,IAAI,GAAGG,IAAI,CAAC,CAAC5C;IAChF,IAAK,IAAI6C,IAAI,GAAGA,KAAKL,GAAGK,KAAK,EAAGH,IAAI,CAACG,EAAE,CAACJ,EAAE,GAAG;IAC7C,IAAK,IAAII,IAAIL,IAAI,GAAGK,KAAK,GAAGA,KAAK,EAAG;QAClC,IAAK,IAAIC,IAAIL,IAAI,GAAGK,KAAK,GAAGA,KAAK,EAAG;YAClC,IAAIN,IAAIK,IAAIJ,IAAIK,GAAG;YACnBJ,IAAI,CAACG,EAAE,CAACC,EAAE,GAAGvC,KAAKE,GAAG,CAACiC,IAAI,CAACG,IAAI,EAAE,CAACC,EAAE,EAAElB,IAAIW,KAAK,CAACM,EAAE,EAAE7B,OAAO,CAAC8B,EAAE,IAAIJ,IAAI,CAACG,IAAI,EAAE,CAACC,IAAI,EAAE;QACtF;IACF;IACA,MAAMC,SAAmB,EAAE;IAC3B,IAAIF,IAAI;IACR,IAAK,IAAIC,IAAI,GAAGA,IAAIL,GAAGK,KAAK,EAAG;QAC7B,MAAOD,IAAIL,KAAKE,IAAI,CAACG,EAAE,CAACC,EAAE,KAAKlB,IAAIW,KAAK,CAACM,EAAE,EAAE7B,OAAO,CAAC8B,EAAE,IAAIJ,IAAI,CAACG,IAAI,EAAE,CAACC,IAAI,EAAE,CAAED,KAAK;QACpFE,OAAO3D,IAAI,CAACyD;QACZA,KAAK;IACP;IACA,OAAOE;AACT;AAEA;;;;;;;CAOC,GACD,OAAO,SAASC,iBACdlE,GAAY,EACZkC,OAAe,EACfiC,IAAwC;IAExC,MAAM/D,UAAgC,EAAE;IACxC,MAAMqD,QACJnE,SAASU,QAAQR,MAAMC,OAAO,CAACO,GAAG,CAAC,WAAW,IAAIA,GAAG,CAAC,WAAW,GAAG,EAAE;IACxE,MAAMoE,UACJX,MAAMtC,MAAM,GAAGe,WAAWiC,QAAQA,KAAKhD,MAAM,KAAKe,UAC9CsB,cAAcC,OAAOU,QACrB3E,MAAMqE,IAAI,CAAC;QAAE1C,QAAQe;IAAQ,GAAG,CAACmC,GAAGtC,QAAUA;IACpD,IAAI0B,MAAMtC,MAAM,GAAGe,SAAS;QAC1B9B,QAAQE,IAAI,CAAC;YACXH,IAAI;YACJI,MAAM,GAAGkD,MAAMtC,MAAM,CAAC,wBAAwB,EAAEe,QAAQ,EAAE,EACxDkC,QAAQE,KAAK,CAAC,CAACnE,IAAI4B,QAAU5B,OAAO4B,SAAS,uBAAuB,CAAC,SAAS,EAAEqC,QAAQrD,GAAG,CAAC,CAACZ,KAAOA,KAAK,GAAGd,IAAI,CAAC,MAAM,mBAAmB,CAAC,EAC3I;QACJ;IACF;IACA,MAAML,WAAWoF,QAAQrD,GAAG,CAAC,CAACZ,IAAI4B,QAChCT,oBAAoBmC,KAAK,CAACtD,GAAG,EAAE,CAAC,SAAS,EAAE4B,MAAM,CAAC,CAAC,EAAE3B;IAEvD,OAAO;QAAEpB;QAAUoB;IAAQ;AAC7B;AAEA,uFAAuF,GACvF,OAAO,SAASmE,kBAAkBvE,GAAY;QAUvCsB;IALL,MAAMlB,UAAgC,EAAE;IACxC,MAAMoE,SAASlF,SAASU,OAAOA,MAAM,CAAC;IACtC,uEAAuE;IACvE,0CAA0C;IAC1C,MAAMd,SAASI,SAASkF,MAAM,CAAC,SAAS,KACnClD,uBAAAA,oBAAoBkD,MAAM,CAAC,SAAS,EAAE,UAAUpE,oBAAhDkB,uBACDmD,SAASD,MAAM,CAAC,SAAS,IACzB;IACJ,MAAMrF,SAASmC,oBAAoBkD,MAAM,CAAC,SAAS,EAAE,UAAUpE;IAC/D,OAAO;QAAElB;QAAQC;QAAQiB;IAAQ;AACnC;AAEA,yEAAyE,GACzE,SAASqE,SAASzE,GAA4B;IAC5C,MAAMzB,OAAOqB,MAAMI,GAAG,CAAC,OAAO,EAAE/C;IAChC,MAAMwB,QAAQmB,MAAMI,GAAG,CAAC,QAAQ,EAAE9C;IAClC,OAAO,aAAMqB,OAAO;QAAEA;IAAK,IAAI,CAAC,GAAQE,QAAQ;QAAEA;IAAM,IAAI,CAAC;QAAIC,QAAQ,EAAE;;AAC7E"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/layout-language/ai-layout-language.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 { AiTool } from '../providers/contract'\nimport { AI_ICON_WORDS } from '../runtime/ai-icon-library'\n\n/**\n * The compact layout language (AGL-3660): what a model designs a page, and a\n * site's header and footer, in — and the one place its shape is declared.\n *\n * ── Why a language, not a tree ───────────────────────────────────────────\n *\n * A page used to be asked for as a raw element tree, packed as escaped JSON\n * text inside a tool call and held to the doctrine's building rules: Grid\n * items sized as strings, every child attached, one h1, a destination on\n * every button, headings under their ceiling. A real model kept about half\n * of a page's sections on the first try, and a Free section was cut off at\n * its token ceiling. The founder chose a language over a library of section\n * templates (10/7): every page is designed for its own request, so no two\n * sites come out alike, and the rules hold because CODE writes the tree.\n *\n * So the model says WHAT each section is and how it is arranged, in a few\n * words of structure, and writes every word a visitor reads; the compiler\n * (`ai-layout-compiler.ts`) turns that into the element tree with the\n * palette's elements and the theme's tokens, by construction.\n *\n * ── The shape ────────────────────────────────────────────────────────────\n *\n * A page is its plan's sections, in order. A SECTION is\n *  - `band`  — its background: `plain` (the page), `soft` (a paper band),\n *              `brand` (the brand color) or `dark` (always dark);\n *  - `cols`  — a row of columns by relative width, as `[7, 5]` or `[1, 1, 1]`,\n *              up to four; absent, one column;\n *  - `align` — `start` or `center`;\n *  - `blocks` — what it shows, top to bottom.\n *\n * A BLOCK is one thing a visitor reads or uses. Its `kind` is one of\n * `AI_LAYOUT_BLOCK_KINDS`; `col` places it in a column of the row (0 first),\n * and a block with no `col` spans the section — above the row when it comes\n * before the first placed block, below it when it comes after. `text` is its\n * words, `to` where it goes, `style` its emphasis and `icon` a word from the\n * icon library. A group — `list`, `cards`, `steps`, `stats`, `quotes`,\n * `faq` — carries its `items`, each a `title`, a `text`, and optionally its\n * own `to` and `icon`.\n *\n * Where a block goes (`to`): `page:<id>` for a page of this site (its label\n * works too), `#<n>` for section n of this page, `form` for the site's form,\n * a form's or a component's id for a `form` or `component` block, or an\n * `https:` address the brief gave.\n *\n * A site's header and footer are two sections in the same language\n * (`AI_LAYOUT_FRAME_TOOL`): the header's brand and navigation are the\n * site's own and written by the compiler, so the model gives the header its\n * band, its alignment and an optional call-to-action button; the footer is\n * a section like any other.\n *\n * ── Cheap by shape ───────────────────────────────────────────────────────\n *\n * The schema is a structured object in the tool input (never JSON text in a\n * string), small enough for a strict tool (`tool-schema-limits.spec.ts`), and\n * the language's instructions ride in the cached prefix. A section is a few\n * dozen words of structure beside its copy, so a whole page is one answer.\n */\n\n/** Every kind of block, in the order the schema lists them. */\nexport const AI_LAYOUT_BLOCK_KINDS = [\n  'eyebrow',\n  'heading',\n  'lede',\n  'text',\n  'note',\n  'list',\n  'button',\n  'image',\n  'cards',\n  'steps',\n  'stats',\n  'quotes',\n  'faq',\n  'form',\n  'component',\n] as const\n\nexport type AiLayoutBlockKind = (typeof AI_LAYOUT_BLOCK_KINDS)[number]\n\n/** The kinds that carry `items`. */\nexport const AI_LAYOUT_GROUP_KINDS: ReadonlySet<AiLayoutBlockKind> = new Set([\n  'list',\n  'cards',\n  'steps',\n  'stats',\n  'quotes',\n  'faq',\n])\n\nexport const AI_LAYOUT_BANDS = ['plain', 'soft', 'brand', 'dark'] as const\nexport type AiLayoutBand = (typeof AI_LAYOUT_BANDS)[number]\n\nexport const AI_LAYOUT_ALIGNS = ['start', 'center'] as const\nexport type AiLayoutAlign = (typeof AI_LAYOUT_ALIGNS)[number]\n\nexport const AI_LAYOUT_STYLES = [\n  'primary',\n  'secondary',\n  'quiet',\n  'large',\n] as const\nexport type AiLayoutStyle = (typeof AI_LAYOUT_STYLES)[number]\n\n/** The most columns a row holds; a fifth is folded into the fourth. */\nexport const AI_LAYOUT_MAX_COLS = 4\n\n/**\n * The most items a group shows: one under the eight copies rule 8 reads as a\n * list typed out by hand, which belongs in a dataset.\n */\nexport const AI_LAYOUT_MAX_ITEMS = 7\n\n/** The most quotes a group shows: each is a gap the owner fills with a real one. */\nexport const AI_LAYOUT_MAX_QUOTES = 3\n\nexport interface AiLayoutItem {\n  title: string\n  text: string\n  to?: string\n  icon?: string\n}\n\nexport interface AiLayoutBlock {\n  kind: AiLayoutBlockKind\n  col?: number\n  text?: string\n  to?: string\n  style?: AiLayoutStyle\n  icon?: string\n  items?: AiLayoutItem[]\n}\n\nexport interface AiLayoutSection {\n  band?: AiLayoutBand\n  cols?: number[]\n  align?: AiLayoutAlign\n  blocks: AiLayoutBlock[]\n}\n\n/** A page: its plan's sections, in order. */\nexport interface AiLayoutPageDoc {\n  sections: AiLayoutSection[]\n}\n\n/** A site's frame: the header and the footer every page renders between. */\nexport interface AiLayoutFrameDoc {\n  header: AiLayoutSection\n  footer: AiLayoutSection\n}\n\nconst ITEM_SCHEMA = {\n  type: 'object',\n  additionalProperties: false,\n  required: ['title', 'text', 'to', 'icon'],\n  properties: {\n    title: { type: 'string' },\n    text: { type: 'string' },\n    to: { type: 'string' },\n    icon: { type: 'string' },\n  },\n} as const\n\nconst BLOCK_SCHEMA = {\n  type: 'object',\n  additionalProperties: false,\n  required: ['kind', 'col', 'text', 'to', 'style', 'icon', 'items'],\n  properties: {\n    kind: { type: 'string', enum: [...AI_LAYOUT_BLOCK_KINDS] },\n    col: { type: 'integer' },\n    text: { type: 'string' },\n    to: { type: 'string' },\n    style: { type: 'string', enum: [...AI_LAYOUT_STYLES, 'none'] },\n    icon: { type: 'string' },\n    items: { type: 'array', items: ITEM_SCHEMA },\n  },\n} as const\n\nconst SECTION_SCHEMA = {\n  type: 'object',\n  additionalProperties: false,\n  required: ['band', 'cols', 'align', 'blocks'],\n  properties: {\n    band: { type: 'string', enum: [...AI_LAYOUT_BANDS] },\n    cols: { type: 'array', items: { type: 'integer' } },\n    align: { type: 'string', enum: [...AI_LAYOUT_ALIGNS] },\n    blocks: { type: 'array', items: BLOCK_SCHEMA },\n  },\n} as const\n\n/** The page tool: every section of one page, in plan order, in one answer. */\nexport const AI_LAYOUT_PAGE_TOOL: AiTool = {\n  name: 'submit_page',\n  description:\n    'Submit the page: one entry in sections for each planned section, in order, in the layout language.',\n  strict: true,\n  inputSchema: {\n    type: 'object',\n    additionalProperties: false,\n    required: ['sections'],\n    properties: { sections: { type: 'array', items: SECTION_SCHEMA } },\n  },\n}\n\n/** The frame tool: the site's header and footer, in the same language. */\nexport const AI_LAYOUT_FRAME_TOOL: AiTool = {\n  name: 'submit_frame',\n  description:\n    \"Submit the site's header and footer, each as a section in the layout language.\",\n  strict: true,\n  inputSchema: {\n    type: 'object',\n    additionalProperties: false,\n    required: ['header', 'footer'],\n    properties: { header: SECTION_SCHEMA, footer: SECTION_SCHEMA },\n  },\n}\n\n/**\n * The language as a model is taught it: the cached instructions both doors\n * share. Every word of copy is the model's; this says only how a design is\n * written down and what each word becomes.\n */\nexport const AI_LAYOUT_LANGUAGE_TEXT = [\n  \"You design web pages in a compact layout language. You decide the structure and write every word; the platform turns your design into the page, with the site's theme, spacing and type, so never describe styling beyond the words below.\",\n  '',\n  'A page is a list of sections, one for each section the plan names, in that order. A section has:',\n  '- band: plain (the page background), soft (a light band), brand (the brand color) or dark (always dark). Vary the bands down a page so neighboring sections read apart; keep brand and dark to one or two sections a page.',\n  '- cols: relative column widths for a row, such as [1, 1] for halves, [7, 5] for a wide and a narrow column, or [1, 1, 1]; at most 4. [] for one column.',\n  '- align: start or center.',\n  '- blocks: what the section shows, top to bottom. A block with col 0 or more goes in that column of the row (0 is the first); a block with col -1 spans the whole section, above the row when it comes first and below it when it comes last.',\n  'Every field is always written: a block that does not use one writes \"\" (text, to, icon), \"none\" (style), -1 (col) or [] (items); an item that does not use one writes \"\".',\n  '',\n  'Block kinds:',\n  \"- eyebrow: a short label above a heading. heading: a heading; the first heading of the page's first section is the page's title, and the first heading of every other section is that section's heading. lede: the larger sentence under a heading. text: a paragraph. note: small print.\",\n  '- button: text is the label and to says where it goes; style primary, secondary or quiet. Two buttons in a row read as a pair.',\n  '- image: text describes the picture to place, which becomes its alt text; the owner adds the picture. icon names a drawing to show until then. to lightbox opens it large when pressed.',\n  '- list: items are the lines (title only; text may be empty).',\n  \"- cards, steps, stats, faq: items, each with a title and a text. cards are features or services; steps are numbered; stats are a figure (title) with its label (text), only for figures the brief gives; faq items are a question (title) and its answer (text). Use no quotes block: the site has no customer's words to show.\",\n  \"- form: places a saved form by its id in to. component: places a reusable component by its id in to; its items fill the component's props, title the prop name and text the value.\",\n  '- style large on a heading makes the page title display-sized. icon (on a block or an item) is one of: ' +\n    AI_ICON_WORDS.join(', ') +\n    '.',\n  '',\n  \"Where a link goes (to): page:<page id> for a page of this site; #<n> for section n of this page (counted from 1); form for the site's form; or an https: address the brief gives. A button the page has nowhere to send is left out. A to value is never written into words: in text, name a page by its title.\",\n  '',\n  \"Writing: plain, specific copy in the site's voice, from the brief, the business and its audience, never filler. Keep a page title under 70 characters and a section heading under 80. The site is published exactly as you write it, so where the brief leaves out a fact such as a price, a figure, a name, a phone number, an email, an address or opening hours, leave it out: write the sentence without it, and make no list line, card or contact row for it. Never write a placeholder or a gap in square brackets, and never invent the fact. Never invent a customer, a review, an award or a statistic.\",\n  '',\n  'Design each page for this business and this request: choose the bands, the rows and the blocks that tell its story best, so no two sites read alike.',\n].join('\\n')\n\n// ── Reading an answer ────────────────────────────────────────────────────\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n\nfunction text(value: unknown): string | undefined {\n  return typeof value === 'string' && value.trim() ? value : undefined\n}\n\nfunction oneOf<T extends string>(\n  value: unknown,\n  values: readonly T[],\n): T | undefined {\n  return typeof value === 'string' &&\n    (values as readonly string[]).includes(value)\n    ? (value as T)\n    : undefined\n}\n\n/** What the reader settled on its own, for the job's record and the specs. */\nexport interface AiLayoutSettlement {\n  /** Where: `sections[2].blocks[1]`, `header`. */\n  at: string\n  what: string\n}\n\nfunction readItem(raw: unknown): AiLayoutItem | null {\n  if (!isRecord(raw)) return null\n  const item: AiLayoutItem = {\n    title: typeof raw['title'] === 'string' ? raw['title'] : '',\n    text: typeof raw['text'] === 'string' ? raw['text'] : '',\n  }\n  if (!item.title.trim() && !item.text.trim()) return null\n  const to = text(raw['to'])\n  const icon = text(raw['icon'])\n  return { ...item, ...(to ? { to } : {}), ...(icon ? { icon } : {}) }\n}\n\nfunction readBlock(\n  raw: unknown,\n  at: string,\n  settled: AiLayoutSettlement[],\n): AiLayoutBlock | null {\n  if (!isRecord(raw)) {\n    settled.push({ at, what: 'not a block; left out' })\n    return null\n  }\n  const kind = oneOf(raw['kind'], AI_LAYOUT_BLOCK_KINDS)\n  if (!kind) {\n    settled.push({\n      at,\n      what: `unknown kind ${JSON.stringify(raw['kind'] ?? null)}; left out`,\n    })\n    return null\n  }\n  const block: AiLayoutBlock = { kind }\n  if (\n    typeof raw['col'] === 'number' &&\n    Number.isInteger(raw['col']) &&\n    raw['col'] >= 0\n  )\n    block.col = raw['col']\n  const words = text(raw['text'])\n  if (words) block.text = words\n  const to = text(raw['to'])\n  if (to) block.to = to.trim()\n  const style = oneOf(raw['style'], AI_LAYOUT_STYLES)\n  if (style) block.style = style\n  const icon = text(raw['icon'])\n  if (icon) block.icon = icon.trim().toLowerCase()\n  if (AI_LAYOUT_GROUP_KINDS.has(kind) || kind === 'component') {\n    const items = (Array.isArray(raw['items']) ? raw['items'] : [])\n      .map(readItem)\n      .filter((item): item is AiLayoutItem => !!item)\n    const most =\n      kind === 'quotes'\n        ? AI_LAYOUT_MAX_QUOTES\n        : kind === 'component'\n          ? Infinity\n          : AI_LAYOUT_MAX_ITEMS\n    if (items.length > most)\n      settled.push({\n        at,\n        what: `${items.length} items; the first ${most} kept`,\n      })\n    if (items.length) block.items = items.slice(0, most)\n  }\n  // A block with nothing to show is no block: a group with no items, words\n  // with no words. A form or a component may name its record alone.\n  const empty = AI_LAYOUT_GROUP_KINDS.has(kind)\n    ? !block.items?.length\n    : kind === 'form' || kind === 'component'\n      ? false\n      : !block.text\n  if (empty) {\n    settled.push({ at, what: `an empty ${kind}; left out` })\n    return null\n  }\n  return block\n}\n\n/** A section read from an answer, or `null` with why it could not be. */\nexport function aiReadLayoutSection(\n  raw: unknown,\n  at: string,\n  settled: AiLayoutSettlement[],\n): AiLayoutSection | null {\n  if (!isRecord(raw)) return null\n  const section: AiLayoutSection = { blocks: [] }\n  const band = oneOf(raw['band'], AI_LAYOUT_BANDS)\n  if (band) section.band = band\n  const align = oneOf(raw['align'], AI_LAYOUT_ALIGNS)\n  if (align) section.align = align\n  if (Array.isArray(raw['cols'])) {\n    const cols = raw['cols'].filter(\n      (value): value is number =>\n        typeof value === 'number' && Number.isFinite(value) && value > 0,\n    )\n    if (cols.length > AI_LAYOUT_MAX_COLS) {\n      settled.push({\n        at: `${at}.cols`,\n        what: `${cols.length} columns; the first ${AI_LAYOUT_MAX_COLS} kept`,\n      })\n    }\n    if (cols.length >= 2)\n      section.cols = cols\n        .slice(0, AI_LAYOUT_MAX_COLS)\n        .map((value) => Math.min(12, Math.max(1, Math.round(value))))\n  }\n  const blocks = Array.isArray(raw['blocks']) ? raw['blocks'] : []\n  blocks.forEach((entry, index) => {\n    const block = readBlock(entry, `${at}.blocks[${index}]`, settled)\n    if (!block) return\n    if (\n      block.col !== undefined &&\n      section.cols &&\n      block.col >= section.cols.length\n    ) {\n      settled.push({\n        at: `${at}.blocks[${index}]`,\n        what: `column ${block.col} of ${section.cols.length}; placed in the last`,\n      })\n      block.col = section.cols.length - 1\n    }\n    if (block.col !== undefined && !section.cols) delete block.col\n    section.blocks.push(block)\n  })\n  return section.blocks.length ? section : null\n}\n\n/** A page answer read: the sections it gave, by plan position, and the positions it could not. */\nexport interface AiLayoutPageReading {\n  /** One entry per planned section; `null` where the answer gave nothing usable. */\n  sections: Array<AiLayoutSection | null>\n  settled: AiLayoutSettlement[]\n}\n\n/** What a planned section is, as the reader matches an answer's sections to it. */\nexport interface AiLayoutPlannedSection {\n  name: string\n  items: number\n  /** What the plan places in it: a form it binds there is one of these. */\n  uses?: readonly string[]\n}\n\n/** A planned section's name that asks for a form: a contact, an inquiry, a booking. */\nconst FORM_SECTION =\n  /\\b(form|contact|get in touch|reach|write|message|inquir(?:y|ies|e)|enquir(?:y|ies|e)|book(?:ing|ings)?|reserv(?:e|ation|ations)|quote|appointments?|rsvp|sign ?up|subscribe|newsletter|apply|application|register)\\b/i\n\n/** Whether a planned section is one a form may fill: it names one, or the plan binds a form there. */\nfunction takesForm(planned: AiLayoutPlannedSection): boolean {\n  return FORM_SECTION.test(planned.name) || (planned.uses ?? []).some((ref) => /\\bform\\b/i.test(ref))\n}\n\n/** What a form's section scores against a planned section that asks for no form: never chosen while another fits. */\nconst AI_LAYOUT_FORM_MISFIT = -100\n\nconst WORD = /[a-z0-9]+/g\nconst STOP = new Set(['a', 'an', 'and', 'the', 'of', 'for', 'to', 'our', 'your', 'with', 'in', 'on', 'we', 'us', 'you'])\nconst wordsOf = (text: string) => new Set((text.toLowerCase().match(WORD) ?? []).filter((word) => !STOP.has(word)))\n\n/** The kinds that show a section's repeated items. */\nconst ITEM_KINDS = new Set(['list', 'cards', 'steps', 'stats', 'quotes', 'faq', 'component'])\n\n/**\n * How well an answer's section fits a planned one: the words its headings\n * share with the plan's name, and whether it shows items where the plan\n * asked for them and none where it asked for none.\n *\n * A shared heading word outweighs the items (AGL-3660): a live portfolio's\n * plan gave \"Works Gallery\" no items, and its \"Selected works\" cards lost the\n * place to an inquiry form that shared no word with it. A section holding a\n * form fills only a planned section that asks for one — by its name, or a\n * form the plan binds there — so the form is never a page's stand-in.\n */\nfunction fit(raw: unknown, planned: AiLayoutPlannedSection): number {\n  const blocks = isRecord(raw) && Array.isArray(raw['blocks']) ? raw['blocks'].filter(isRecord) : []\n  const said = wordsOf(\n    blocks\n      .filter((block) => block['kind'] === 'heading' || block['kind'] === 'eyebrow')\n      .map((block) => String(block['text'] ?? ''))\n      .join(' '),\n  )\n  const named = wordsOf(planned.name)\n  let shared = 0\n  for (const word of named) if (said.has(word) || [...said].some((other) => other.startsWith(word) || word.startsWith(other))) shared += 1\n  const showsItems = blocks.some((block) => ITEM_KINDS.has(String(block['kind'])) && (block['kind'] === 'component' || (Array.isArray(block['items']) && block['items'].length > 0)))\n  const wantsItems = planned.items > 0\n  const holdsForm = blocks.some((block) => block['kind'] === 'form')\n  if (holdsForm && !takesForm(planned)) return AI_LAYOUT_FORM_MISFIT\n  return shared * 2 + (wantsItems === showsItems ? 0.5 : -0.5)\n}\n\n/**\n * The answer's sections that best match the plan, in order, where it gave\n * more than the plan names (AGL-3660): a model that opened a page with a\n * hero of its own, or closed it with a call to action, shifted every planned\n * section by one, and the cut fell on the plan's last sections — the ones\n * that carried its items. Each planned section takes the answer's section\n * that fits it best, keeping the answer's order.\n */\nfunction alignSections(given: readonly unknown[], planned: readonly AiLayoutPlannedSection[]): number[] {\n  const n = given.length\n  const m = planned.length\n  // best[i][j]: the best score placing plan sections j.. on answer sections i..\n  const best: number[][] = Array.from({ length: n + 1 }, () => Array(m + 1).fill(-Infinity))\n  for (let i = 0; i <= n; i += 1) best[i][m] = 0\n  for (let i = n - 1; i >= 0; i -= 1) {\n    for (let j = m - 1; j >= 0; j -= 1) {\n      if (n - i < m - j) continue\n      best[i][j] = Math.max(best[i + 1][j], fit(given[i], planned[j]) + best[i + 1][j + 1])\n    }\n  }\n  const picked: number[] = []\n  let i = 0\n  for (let j = 0; j < m; j += 1) {\n    while (i < n && best[i][j] !== fit(given[i], planned[j]) + best[i + 1][j + 1]) i += 1\n    picked.push(i)\n    i += 1\n  }\n  return picked\n}\n\n/**\n * The page an answer describes, against the sections its plan names: each\n * planned section takes the answer's section at its position — or, where the\n * answer gave more sections than the plan names and the plan's sections are\n * given, the one that fits it best (`alignSections`) — an answer's extra\n * sections are left out, and a planned section the answer left empty or out\n * is `null` — the one thing a re-ask asks for again.\n */\nexport function aiReadLayoutPage(\n  raw: unknown,\n  planned: number,\n  plan?: readonly AiLayoutPlannedSection[],\n): AiLayoutPageReading {\n  const settled: AiLayoutSettlement[] = []\n  const given =\n    isRecord(raw) && Array.isArray(raw['sections']) ? raw['sections'] : []\n  const aligned =\n    given.length > planned && plan && plan.length === planned\n      ? alignSections(given, plan)\n      : Array.from({ length: planned }, (_, index) => index)\n  if (given.length > planned) {\n    settled.push({\n      at: 'sections',\n      what: `${given.length} sections for a plan of ${planned}; ${\n        aligned.every((at, index) => at === index) ? 'the extra left out' : `sections ${aligned.map((at) => at + 1).join(', ')} kept as the plan's`\n      }`,\n    })\n  }\n  const sections = aligned.map((at, index) =>\n    aiReadLayoutSection(given[at], `sections[${index}]`, settled),\n  )\n  return { sections, settled }\n}\n\n/** A frame answer read: a header and a footer, either `null` where it was not usable. */\nexport function aiReadLayoutFrame(raw: unknown): {\n  header: AiLayoutSection | null\n  footer: AiLayoutSection | null\n  settled: AiLayoutSettlement[]\n} {\n  const settled: AiLayoutSettlement[] = []\n  const record = isRecord(raw) ? raw : {}\n  // A header needs no block of its own: its brand and navigation are the\n  // site's, so an empty one is a plain bar.\n  const header = isRecord(record['header'])\n    ? (aiReadLayoutSection(record['header'], 'header', settled) ??\n      readBare(record['header']))\n    : null\n  const footer = aiReadLayoutSection(record['footer'], 'footer', settled)\n  return { header, footer, settled }\n}\n\n/** A section with no usable block, keeping only its band and alignment. */\nfunction readBare(raw: Record<string, unknown>): AiLayoutSection {\n  const band = oneOf(raw['band'], AI_LAYOUT_BANDS)\n  const align = oneOf(raw['align'], AI_LAYOUT_ALIGNS)\n  return { ...(band ? { band } : {}), ...(align ? { align } : {}), blocks: [] }\n}\n"],"names":["AI_ICON_WORDS","AI_LAYOUT_BLOCK_KINDS","AI_LAYOUT_GROUP_KINDS","Set","AI_LAYOUT_BANDS","AI_LAYOUT_ALIGNS","AI_LAYOUT_STYLES","AI_LAYOUT_MAX_COLS","AI_LAYOUT_MAX_ITEMS","AI_LAYOUT_MAX_QUOTES","ITEM_SCHEMA","type","additionalProperties","required","properties","title","text","to","icon","BLOCK_SCHEMA","kind","enum","col","style","items","SECTION_SCHEMA","band","cols","align","blocks","AI_LAYOUT_PAGE_TOOL","name","description","strict","inputSchema","sections","AI_LAYOUT_FRAME_TOOL","header","footer","AI_LAYOUT_LANGUAGE_TEXT","join","isRecord","value","Array","isArray","trim","undefined","oneOf","values","includes","readItem","raw","item","readBlock","at","settled","block","push","what","JSON","stringify","Number","isInteger","words","toLowerCase","has","map","filter","most","Infinity","length","slice","empty","aiReadLayoutSection","section","isFinite","Math","min","max","round","forEach","entry","index","FORM_SECTION","takesForm","planned","test","uses","some","ref","AI_LAYOUT_FORM_MISFIT","WORD","STOP","wordsOf","match","word","ITEM_KINDS","fit","said","String","named","shared","other","startsWith","showsItems","wantsItems","holdsForm","alignSections","given","n","m","best","from","fill","i","j","picked","aiReadLayoutPage","plan","aligned","_","every","aiReadLayoutFrame","record","readBare"],"mappings":"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"}

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

@@ -40,6 +40,20 @@
  *  - `posts` — the content plugin's Collection Entries (`collectionEntries`)
  *    over the blog's collection, its card a cover, the date and byline, the
  *    title and the excerpt, linking each post.
+ *  - `tracks` — the music plugin's Music player (`musicPlayer`, AGL-3716) on a
+ *    music site, placed EMPTY: its "add your tracks" state, for the owner to
+ *    fill from their own media library. No job ever sources a recording, so
+ *    a tracks listing has no records and the player no source.
+ *  - `reviews` — a selling store's own customer reviews, through the commerce
+ *    plugin's Product reviews in its store-wide scope (`product-reviews`,
+ *    AGL-3676): approved reviews across the catalog with their star ratings.
+ *    A store that opens has none, and the element then shows nothing at all
+ *    on the published page, so no review is ever written for a shopper who
+ *    did not leave one (the FTC's fake-review rule; rule 14's "never invent
+ *    a customer").
+ *  - `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.
  *
  * The elements are named by their persisted ids, as the form binding names
  * `form`: a plugin never imports another's internals, and
@@ -48,7 +62,7 @@
  *
  * Model only: shapes and the inputs reader; the compiler draws them.
  */
-export type AiLayoutListingKind = 'products' | 'posts';
+export type AiLayoutListingKind = 'products' | 'posts' | 'tracks' | 'reviews' | 'signup';
 /** 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. */
@@ -72,6 +86,20 @@ export interface AiLayoutListing {
     href?: string;
     /** The content collection a posts listing repeats, by its slug. */
     collectionSlug?: string;
+    /**
+     * 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
+     * action, so a shop that opens empty still answers a visitor.
+     */
+    emptyAction?: {
+        label: string;
+        href: string;
+    };
+    /**
+     * `false` for a store that lists its catalog but cannot sell yet (its first
+     * products were skipped or failed, AGL-3676): the header carries no cart.
+     */
+    cart?: boolean;
     placements: AiLayoutListingPlacement[];
 }
 /** The unit input a site's listings travel in, to its layout and its pages. */
@@ -86,6 +114,9 @@ export declare const AI_LAYOUT_CART_ELEMENT = "cart";
 export declare const AI_LAYOUT_FEATURED_RECORDS: {
     readonly products: 4;
     readonly posts: 3;
+    readonly tracks: 0;
+    readonly reviews: 3;
+    readonly signup: 0;
 };
 /** 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[];
@@ -102,8 +133,25 @@ export interface AiLayoutListingScreen {
     sections: ReadonlyArray<{
         name: string;
         items: number;
+        uses?: readonly string[];
     }>;
 }
+/**
+ * The section of a shop's own page the whole catalog fills (AGL-3676): the
+ * first after its opening whose name says products ("Product grid", "The
+ * range"), else the section planned with the most items, else its second.
+ * The live Hearth & Wick start (2026-10-09) planned "Product range image
+ * cards" — six cards naming kinds of candle, with no product, price or cart.
+ */
+export declare function aiLayoutShopGridSection(sections: ReadonlyArray<{
+    name: string;
+    items: number;
+}>): number;
+/** Whether a planned page is the store's own Shop page: its address or its name says it sells. */
+export declare function aiLayoutIsShopPage(screen: {
+    slug: string;
+    title: string;
+}): boolean;
 /**
  * The sections of a site's pages that show a listing, chosen by code from the
  * plan (AGL-3676), never asked of the model:

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

@@ -1,3 +1,4 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
 /**
  * @license
  * Copyright 2026 Aglyn LLC
@@ -13,52 +14,25 @@
  * 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.
- */ /**
- * A SITE'S OWN RECORDS, PLACED BY THE PLATFORM (AGL-3676).
- *
- * A guided start writes a store's first products and a blog's first posts,
- * then built the pages around them in the layout language — and the pages
- * showed neither. "Featured candles" and "The candle range" on the live
- * Ember & Wick start (2026-10-08) were cards the model wrote, a name and a
- * line each: no photo, no price, no link, nothing a shopper could open; the
- * Clay Notes blog's "Featured writing" was three cards that linked to no
- * post. The real records were on the site, one click away from nowhere.
- *
- * A LISTING is one kind of record a site keeps — its catalog, its blog —
- * placed by code in the sections whose plan says they show it, through the
- * element the plugin that keeps the records renders them with, bound to the
- * records themselves rather than to words about them. It is the form binding
- * one step on (a section whose plan `uses` a form places that form by its
- * id, whatever the answer remembered): the model writes the section's
- * heading and words, the platform places the records.
- *
- *  - `products` — the commerce plugin's Product grid (`product-grid`), over
- *    the site's whole active catalog: a photo, the name, the price (or
- *    "Price coming soon" where the owner cleared it), each card linking its
- *    product's page.
- *  - `posts` — the content plugin's Collection Entries (`collectionEntries`)
- *    over the blog's collection, its card a cover, the date and byline, the
- *    title and the excerpt, linking each post.
- *
- * The elements are named by their persisted ids, as the form binding names
- * `form`: a plugin never imports another's internals, and
- * `ai-layout-listings.spec.ts` holds the ids and props named here to the
- * source of the plugins that declare them.
- *
- * Model only: shapes and the inputs reader; the compiler draws them.
- */ import { _ as _extends } from "@swc/helpers/_/_extends";
+ */ 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 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'
+    posts: 'collectionEntries',
+    tracks: 'musicPlayer',
+    reviews: 'product-reviews',
+    signup: 'newsletter-signup'
 };
 /** 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 = {
     products: 4,
-    posts: 3
+    posts: 3,
+    tracks: 0,
+    reviews: 3,
+    signup: 0
 };
 const PLACEMENT_ROLES = [
     'featured',
@@ -66,19 +40,34 @@ const PLACEMENT_ROLES = [
 ];
 const KINDS = [
     'products',
-    'posts'
+    'posts',
+    'tracks',
+    'reviews',
+    'signup'
 ];
 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 = {
+    products: 'the shop',
+    posts: 'the blog',
+    tracks: 'the music',
+    reviews: 'the store',
+    signup: 'the newsletter'
+};
+/** A path on the site, as a listing's links are kept. */ const SITE_PATH = /^\/[a-z0-9-]+(?:\/[a-z0-9-]+)*$/;
 /** 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 [];
     const listings = [];
     for (const entry of raw){
+        var _record_emptyAction;
         if (!entry || typeof entry !== 'object') continue;
         const record = entry;
         const kind = record['kind'];
         if (!KINDS.includes(kind) || listings.some((listing)=>listing.kind === kind)) continue;
         const href = text(record['href']);
+        const action = (_record_emptyAction = record['emptyAction']) != null ? _record_emptyAction : {};
+        const actionLabel = text(action['label']).slice(0, 40);
+        const actionHref = text(action['href']);
         const collectionSlug = text(record['collectionSlug']);
         // A posts listing with no collection to repeat shows nothing.
         if (kind === 'posts' && !/^[a-z0-9-]{1,100}$/.test(collectionSlug)) continue;
@@ -98,12 +87,21 @@ const text = (value)=>typeof value === 'string' ? value.trim() : '';
         listings.push(_extends({
             id: aiLayoutListingId(kind),
             kind,
-            name: text(record['name']) || (kind === 'products' ? 'the shop' : 'the blog'),
-            records: (Array.isArray(record['records']) ? record['records'] : []).map(text).filter(Boolean).slice(0, 12)
-        }, /^\/[a-z0-9-]+(?:\/[a-z0-9-]+)*$/.test(href) ? {
+            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)
+        }, SITE_PATH.test(href) ? {
             href
         } : {}, kind === 'posts' ? {
             collectionSlug
+        } : {}, kind === 'products' && record['cart'] === false ? {
+            cart: false
+        } : {}, kind === 'products' && actionLabel && SITE_PATH.test(actionHref) ? {
+            emptyAction: {
+                label: actionLabel,
+                href: actionHref
+            }
         } : {}, {
             placements
         }));
@@ -124,6 +122,47 @@ const text = (value)=>typeof value === 'string' ? value.trim() : '';
 const PRODUCT_PAGE = /\b(shop|store|products?|catalog(?:ue)?|collections?|range|browse)\b/i;
 const PRODUCT_SECTION = /\b(shop|store|products?|catalog(?:ue)?|collections?|range|bestsellers?|best[- ]sellers?|new arrivals|arrivals|featured|favou?rites|signature)\b/i;
 const POST_SECTION = /\b(blog|posts?|articles?|writing|journal|stories|essays?|latest|recent|news|featured)\b/i;
+/** A music site's page or section about its recordings (AGL-3716). */ const MUSIC_PAGE = /\b(music|listen|tracks?|songs?|releases?|discography|albums?|eps?|singles?|sounds?)\b/i;
+/**
+ * The section of a shop's own page the whole catalog fills (AGL-3676): the
+ * first after its opening whose name says products ("Product grid", "The
+ * range"), else the section planned with the most items, else its second.
+ * The live Hearth & Wick start (2026-10-09) planned "Product range image
+ * cards" — six cards naming kinds of candle, with no product, price or cart.
+ */ export function aiLayoutShopGridSection(sections) {
+    const named = sections.findIndex((section, index)=>index > 0 && PRODUCT_SECTION.test(section.name) && !SHOP_FRAMING.test(section.name));
+    if (named !== -1) return named;
+    const most = Math.max(0, ...sections.map((section)=>section.items));
+    const byItems = most > 0 ? sections.findIndex((section)=>section.items === most) : -1;
+    return byItems !== -1 ? byItems : sections.length > 1 ? 1 : 0;
+}
+/**
+ * The section of a store's home its bestsellers fill (AGL-3676): the first
+ * after the hero whose name says them ("Bestsellers", "Featured candles", "New
+ * arrivals"), never one about the store's collections, its reviews or its
+ * sign-up; else the first after the hero naming products at all; else the
+ * first after the hero planned with items that is none of those. The
+ * beta.237 Willow Wick home would otherwise have listed products in its
+ * "Shop by collection" tiles.
+ */ function aiLayoutFeaturedSection(screen) {
+    // A section about the collections that does not also name the bestsellers.
+    const other = (name)=>aiStorefrontSays('collections', name) && !aiStorefrontSays('featured', name) || aiStorefrontSays('reviews', name) || aiStorefrontSays('signup', name);
+    const first = (test)=>screen.sections.findIndex((section, index)=>index > 0 && test(section.name, section.items));
+    for (const test of [
+        (name)=>aiStorefrontSays('featured', name) && !other(name),
+        (name)=>PRODUCT_SECTION.test(name) && !other(name),
+        (name, items)=>items > 0 && !other(name),
+        (name)=>PRODUCT_SECTION.test(name)
+    ]){
+        const found = first(test);
+        if (found !== -1) return found;
+    }
+    return -1;
+}
+/** A section of a shop page that only opens or closes it: "Shop intro heading", "Gift help call to action". */ const SHOP_FRAMING = /\b(hero|intro(?:duction)?|heading|banner|cta|call to action|contact)\b/i;
+/** Whether a planned page is the store's own Shop page: its address or its name says it sells. */ export function aiLayoutIsShopPage(screen) {
+    return !isHome(screen.slug) && PRODUCT_PAGE.test(`${firstSegment(screen.slug)} ${screen.title}`);
+}
 const firstSegment = (slug)=>slug.trim().replace(/^\/+/, '').split('/')[0].toLowerCase();
 const isHome = (slug)=>firstSegment(slug) === '';
 /**
@@ -153,18 +192,49 @@ const isHome = (slug)=>firstSegment(slug) === '';
         });
     };
     const afterHero = (screen, test)=>screen.sections.findIndex((section, index)=>index > 0 && test(section.name, section.items));
+    if (kind === 'tracks') {
+        // A music site's player (AGL-3716): on its Music page, in the section that
+        // says it is about the recordings, else the one after the opening; on the
+        // home, only in a section named for them. A site with neither gets it on
+        // its home, after the opening.
+        for (const screen of screens){
+            if (isHome(screen.slug)) {
+                place(screen, afterHero(screen, (name)=>MUSIC_PAGE.test(name)), 'featured');
+                continue;
+            }
+            if (!MUSIC_PAGE.test(`${firstSegment(screen.slug)} ${screen.title}`)) continue;
+            const named = afterHero(screen, (name)=>MUSIC_PAGE.test(name));
+            place(screen, named !== -1 ? named : screen.sections.length > 1 ? 1 : 0, 'index');
+        }
+        if (!placements.length) {
+            const home = screens.find((screen)=>isHome(screen.slug));
+            if (home) place(home, home.sections.length > 1 ? 1 : 0, 'featured');
+        }
+        return placements;
+    }
+    if (kind === 'reviews' || kind === 'signup') {
+        // A store's own reviews, on its home, in the section named for them; its
+        // newsletter sign-up in any page's section named for it that places no
+        // form of the plan's (AGL-3676). Neither is ever a page's opening.
+        for (const screen of screens){
+            if (kind === 'reviews' && !isHome(screen.slug)) continue;
+            place(screen, afterHero(screen, (name)=>aiStorefrontSays(kind, name)), kind === 'reviews' ? 'featured' : 'index');
+        }
+        return kind === 'signup' ? placements.filter((placement)=>{
+            var _ref;
+            var _screen_sections_placement_section;
+            const screen = screens.find((entry)=>entry.id === placement.screenId);
+            return !((_ref = screen == null ? void 0 : (_screen_sections_placement_section = screen.sections[placement.section]) == null ? void 0 : _screen_sections_placement_section.uses) != null ? _ref : []).some((use)=>/form/i.test(use));
+        }) : placements;
+    }
     if (kind === 'products') {
         for (const screen of screens){
             if (isHome(screen.slug)) {
-                const named = afterHero(screen, (name)=>PRODUCT_SECTION.test(name));
-                place(screen, named !== -1 ? named : afterHero(screen, (_name, items)=>items > 0), 'featured');
+                place(screen, aiLayoutFeaturedSection(screen), 'featured');
                 continue;
             }
-            if (!PRODUCT_PAGE.test(`${firstSegment(screen.slug)} ${screen.title}`)) continue;
-            const most = Math.max(0, ...screen.sections.map((section)=>section.items));
-            const byItems = most > 0 ? screen.sections.findIndex((section)=>section.items === most) : -1;
-            const index = byItems !== -1 ? byItems : screen.sections.length > 1 ? 1 : 0;
-            place(screen, index, 'index');
+            if (!aiLayoutIsShopPage(screen)) continue;
+            place(screen, aiLayoutShopGridSection(screen.sections), 'index');
         }
         return placements;
     }

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\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 *\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'\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  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}\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 } as const\n\nconst PLACEMENT_ROLES: readonly AiLayoutListingRole[] = ['featured', 'index']\nconst KINDS: readonly AiLayoutListingKind[] = ['products', 'posts']\n\nconst text = (value: unknown): string => (typeof value === 'string' ? value.trim() : '')\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 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']) || (kind === 'products' ? 'the shop' : 'the blog'),\n      records: (Array.isArray(record['records']) ? record['records'] : []).map(text).filter(Boolean).slice(0, 12),\n      ...(/^\\/[a-z0-9-]+(?:\\/[a-z0-9-]+)*$/.test(href) ? { href } : {}),\n      ...(kind === 'posts' ? { collectionSlug } : {}),\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 }>\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\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 === 'products') {\n    for (const screen of screens) {\n      if (isHome(screen.slug)) {\n        const named = afterHero(screen, (name) => PRODUCT_SECTION.test(name))\n        place(screen, named !== -1 ? named : afterHero(screen, (_name, items) => items > 0), 'featured')\n        continue\n      }\n      if (!PRODUCT_PAGE.test(`${firstSegment(screen.slug)} ${screen.title}`)) continue\n      const most = Math.max(0, ...screen.sections.map((section) => section.items))\n      const byItems = most > 0 ? screen.sections.findIndex((section) => section.items === most) : -1\n      const index = byItems !== -1 ? byItems : screen.sections.length > 1 ? 1 : 0\n      place(screen, index, '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":["AI_LAYOUT_LISTINGS_INPUT","aiLayoutListingId","kind","AI_LAYOUT_LISTING_ELEMENTS","products","posts","AI_LAYOUT_CART_ELEMENT","AI_LAYOUT_FEATURED_RECORDS","PLACEMENT_ROLES","KINDS","text","value","trim","aiLayoutListingsOf","inputs","raw","Array","isArray","listings","entry","record","includes","some","listing","href","collectionSlug","test","placements","flatMap","placement","screenId","section","role","Number","isInteger","push","id","name","records","map","filter","Boolean","slice","aiLayoutListingAt","find","PRODUCT_PAGE","PRODUCT_SECTION","POST_SECTION","firstSegment","slug","replace","split","toLowerCase","isHome","aiLayoutListingPlacements","screens","place","screen","afterHero","sections","findIndex","index","items","named","_name","title","most","Math","max","byItems","length"],"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 *\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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"}