@aglyn/plugins-ai 1.0.0-beta.233 → 1.0.0-beta.235

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/layout-language/ai-layout-links.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 { aiPageLinkSection } from '../runtime/ai-page-links'\n\n/**\n * Where a link the layout language names goes (AGL-3660), resolved by code to\n * a destination rule 10 admits: a page of this site by its id, a section of\n * this page by the platform's Scroll to element interaction, or an `https:`\n * address the brief itself gave. A destination that resolves to nothing, or\n * to the home page under words that do not say home, is no destination, and\n * the compiler leaves the button out rather than shipping a dead control.\n */\n\n/** A page of the site a link may go to: built, or minted on a guided start's plan. */\nexport interface AiLayoutPage {\n  id: string\n  label: string\n  slug: string\n}\n\n/** Everything a page's links resolve against. */\nexport interface AiLayoutTargets {\n  /** The page being built, which no link of its own goes to. */\n  pageId?: string | null\n  /** The site's pages a link may go to. */\n  pages: readonly AiLayoutPage[]\n  /** The site's home pages, which only words that say home link (rule 10). */\n  homeIds: readonly string[]\n  /** The saved forms a page may place. */\n  forms: readonly { id: string; name: string }[]\n  /** The page that places the site's form, where that is another page. */\n  formPageId?: string | null\n  /** The reusable components a page may place, with the props each fills. */\n  components: readonly {\n    id: string\n    name: string\n    props: Record<string, string>\n  }[]\n  /** Every word the job was given: the brief, the site's answers, its profile. */\n  facts: string\n}\n\n/** Where a link resolved to. */\nexport type AiLayoutDestination =\n  | { kind: 'page'; screenId: string }\n  | { kind: 'section'; index: number }\n  | { kind: 'href'; href: string }\n\n/** The words of a label or a name, as they are compared. */\nfunction wordsOf(text: string): string[] {\n  return text\n    .toLowerCase()\n    .split(/[^\\p{L}\\p{N}]+/u)\n    .filter(Boolean)\n}\n\nfunction slugOf(slug: string): string {\n  return `/${slug.replace(/^\\/+|\\/+$/g, '')}`.toLowerCase()\n}\n\nconst HOME_WORDS = /\\bhome(?:\\s?page)?\\b/i\n\n/** Words that ask a visitor to get in touch, which the site's form answers. */\nconst CONTACT_WORDS =\n  /\\b(?:contact|book|booking|call|quote|estimate|appointment|schedule|reserve|reservation|get in touch|request|visit|enquire|inquire|enquiry|inquiry|message|talk|consult|consultation|order|sign up|join|apply|start)\\b/i\n\nexport interface AiLayoutLinkScope {\n  /** The page's section names in plan order. */\n  sections: readonly string[]\n  /** The section the link sits in, which it does not scroll to. */\n  from: number\n  /** The section of this page that places the site's form, if one does. */\n  formSection: number | null\n}\n\n/** The page a word names: an id, a label or an address. */\nfunction pageNamed(\n  word: string,\n  targets: AiLayoutTargets,\n): AiLayoutPage | null {\n  const value = word.trim()\n  if (!value) return null\n  const byId = targets.pages.find((page) => page.id === value)\n  if (byId) return byId\n  const lower = value.toLowerCase()\n  if (lower.startsWith('/'))\n    return (\n      targets.pages.find((page) => slugOf(page.slug) === slugOf(lower)) ?? null\n    )\n  const words = wordsOf(value).join(' ')\n  return (\n    targets.pages.find((page) => wordsOf(page.label).join(' ') === words) ??\n    null\n  )\n}\n\n/** A destination rule 10 admits, from the page it names, for the words a link shows. */\nfunction pageDestination(\n  page: AiLayoutPage | null,\n  label: string,\n  targets: AiLayoutTargets,\n): AiLayoutDestination | null {\n  if (!page || page.id === targets.pageId) return null\n  if (\n    targets.homeIds.includes(page.id) &&\n    !HOME_WORDS.test(label) &&\n    !isHomeSlug(page.slug)\n  )\n    return null\n  if (isHomeSlug(page.slug) && !HOME_WORDS.test(label)) return null\n  return { kind: 'page', screenId: page.id }\n}\n\nfunction isHomeSlug(slug: string): boolean {\n  return slugOf(slug) === '/'\n}\n\n/** Where the site's form is: a section of this page, else the page that places it. */\nfunction formDestination(\n  scope: AiLayoutLinkScope,\n  targets: AiLayoutTargets,\n): AiLayoutDestination | null {\n  if (scope.formSection !== null && scope.formSection !== scope.from)\n    return { kind: 'section', index: scope.formSection }\n  if (targets.formPageId && targets.formPageId !== targets.pageId) {\n    return { kind: 'page', screenId: targets.formPageId }\n  }\n  return null\n}\n\n/**\n * Where a link goes: the destination its `to` names, read the language's\n * way; failing that, for words that ask a visitor to get in touch, the site's\n * form; failing that, a page whose name the words say. `null` is a link with\n * nowhere to go, which is left out.\n */\nexport function aiLayoutResolveLink(\n  to: string | undefined,\n  label: string,\n  scope: AiLayoutLinkScope,\n  targets: AiLayoutTargets,\n): AiLayoutDestination | null {\n  const named = to ? resolveNamed(to.trim(), label, scope, targets) : null\n  if (named) return named\n  if (CONTACT_WORDS.test(label)) {\n    const form = formDestination(scope, targets)\n    if (form) return form\n    const contact = targets.pages.find(\n      (page) =>\n        page.id !== targets.pageId &&\n        !isHomeSlug(page.slug) &&\n        CONTACT_WORDS.test(page.label),\n    )\n    if (contact) return { kind: 'page', screenId: contact.id }\n  }\n  const labelWords = new Set(wordsOf(label))\n  const said = targets.pages.filter(\n    (page) =>\n      page.id !== targets.pageId &&\n      !isHomeSlug(page.slug) &&\n      wordsOf(page.label).length > 0 &&\n      wordsOf(page.label).every((word) => labelWords.has(word)),\n  )\n  return said.length === 1 ? { kind: 'page', screenId: said[0].id } : null\n}\n\nfunction resolveNamed(\n  to: string,\n  label: string,\n  scope: AiLayoutLinkScope,\n  targets: AiLayoutTargets,\n): AiLayoutDestination | null {\n  const lower = to.toLowerCase()\n  if (\n    lower === 'form' ||\n    lower.startsWith('form:') ||\n    targets.forms.some((form) => form.id === to)\n  ) {\n    return formDestination(scope, targets)\n  }\n  if (lower.startsWith('https://')) {\n    return targets.facts.includes(to) ? { kind: 'href', href: to } : null\n  }\n  const section = lower.startsWith('#')\n    ? to.slice(1)\n    : lower.startsWith('section:')\n      ? to.slice(8)\n      : null\n  if (section !== null) {\n    const number = Number(section.trim())\n    const index =\n      Number.isInteger(number) && number >= 1 && number <= scope.sections.length\n        ? number - 1\n        : aiPageLinkSection(section, scope.sections)\n    return index !== null && index !== scope.from\n      ? { kind: 'section', index }\n      : null\n  }\n  const page = pageNamed(lower.startsWith('page:') ? to.slice(5) : to, targets)\n  return pageDestination(page, label, targets)\n}\n"],"names":["aiPageLinkSection","wordsOf","text","toLowerCase","split","filter","Boolean","slugOf","slug","replace","HOME_WORDS","CONTACT_WORDS","pageNamed","word","targets","value","trim","byId","pages","find","page","id","lower","startsWith","words","join","label","pageDestination","pageId","homeIds","includes","test","isHomeSlug","kind","screenId","formDestination","scope","formSection","from","index","formPageId","aiLayoutResolveLink","to","named","resolveNamed","form","contact","labelWords","Set","said","length","every","has","forms","some","facts","href","section","slice","number","Number","isInteger","sections"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/layout-language/ai-layout-links.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 { aiPageLinkSection } from '../runtime/ai-page-links'\nimport type { AiLayoutListing } from './ai-layout-listings'\n\n/**\n * Where a link the layout language names goes (AGL-3660), resolved by code to\n * a destination rule 10 admits: a page of this site by its id, a section of\n * this page by the platform's Scroll to element interaction, or an `https:`\n * address the brief itself gave. A destination that resolves to nothing, or\n * to the home page under words that do not say home, is no destination, and\n * the compiler leaves the button out rather than shipping a dead control.\n */\n\n/** A page of the site a link may go to: built, or minted on a guided start's plan. */\nexport interface AiLayoutPage {\n  id: string\n  label: string\n  slug: string\n  /**\n   * A destination on the site that is no page of its own, linked by its path:\n   * the blog a guided start writes its posts into (AGL-3660), whose `id` is\n   * no screen. Absent for every page.\n   */\n  href?: string\n  /**\n   * The title of a planned page merged into this destination (AGL-3676): a\n   * page that stood in for the blog, kept only so links to it go to the blog.\n   * A link to it is named for the blog, not for the page it replaced.\n   */\n  standsInFor?: string\n}\n\n/** Everything a page's links resolve against. */\nexport interface AiLayoutTargets {\n  /** The page being built, which no link of its own goes to. */\n  pageId?: string | null\n  /** The site's pages a link may go to. */\n  pages: readonly AiLayoutPage[]\n  /** The site's home pages, which only words that say home link (rule 10). */\n  homeIds: readonly string[]\n  /** The saved forms a page may place. */\n  forms: readonly { id: string; name: string }[]\n  /** The page that places the site's form, where that is another page. */\n  formPageId?: string | null\n  /** The reusable components a page may place, with the props each fills. */\n  components: readonly {\n    id: string\n    name: string\n    props: Record<string, string>\n  }[]\n  /** Every word the job was given: the brief, the site's answers, its profile. */\n  facts: string\n  /**\n   * The kinds of record the site keeps that its pages show — its catalog,\n   * its blog — and the sections that place each (AGL-3676,\n   * `ai-layout-listings.ts`). Absent or empty, a page shows only its words.\n   */\n  listings?: readonly AiLayoutListing[]\n}\n\n/** Where a link resolved to. */\nexport type AiLayoutDestination =\n  | { kind: 'page'; screenId: string }\n  | { kind: 'section'; index: number }\n  | { kind: 'href'; href: string }\n  /**\n   * A path on this site that is no page of its own, such as the blog\n   * (AGL-3660); reached through a planned page merged into it, the title\n   * that page had and the name it now goes by (AGL-3676).\n   */\n  | { kind: 'path'; href: string; standsInFor?: string; label?: string }\n\n/**\n * A link's words for where it now goes (AGL-3676): a button that named a\n * page merged into the blog — \"Read the articles\" — names the blog instead,\n * \"Read the blog\". Words that name neither are kept.\n */\nexport function aiLayoutRenamedLabel(label: string, destination: AiLayoutDestination): string {\n  if (destination.kind !== 'path' || !destination.standsInFor || !destination.label) return label\n  const name = destination.label.toLowerCase()\n  const words = wordsOf(destination.standsInFor)\n  if (!words.length) return label\n  // The page's own name, or its words alone, singular or plural.\n  const stems = words.map((word) => word.replace(/s$/, ''))\n  const pattern = new RegExp(`\\\\b(?:${stems.map((stem) => stem.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')).join('\\\\s+')})s?\\\\b`, 'giu')\n  const renamed = label.replace(pattern, (found) => (found[0] === found[0].toUpperCase() ? destination.label as string : name))\n  return renamed\n}\n\n/** The words of a label or a name, as they are compared. */\nfunction wordsOf(text: string): string[] {\n  return text\n    .toLowerCase()\n    .split(/[^\\p{L}\\p{N}]+/u)\n    .filter(Boolean)\n}\n\nfunction slugOf(slug: string): string {\n  return `/${slug.replace(/^\\/+|\\/+$/g, '')}`.toLowerCase()\n}\n\nconst HOME_WORDS = /\\bhome(?:\\s?page)?\\b/i\n\n/** Words that ask a visitor to get in touch, which the site's form answers. */\nconst CONTACT_WORDS =\n  /\\b(?:contact|book|booking|call|quote|estimate|appointment|schedule|reserve|reservation|get in touch|request|visit|enquire|inquire|enquiry|inquiry|message|talk|consult|consultation|order|sign up|join|apply|start)\\b/i\n\nexport interface AiLayoutLinkScope {\n  /** The page's section names in plan order. */\n  sections: readonly string[]\n  /** The section the link sits in, which it does not scroll to. */\n  from: number\n  /** The section of this page that places the site's form, if one does. */\n  formSection: number | null\n}\n\n/** The page a word names: an id, a label or an address. */\nfunction pageNamed(\n  word: string,\n  targets: AiLayoutTargets,\n): AiLayoutPage | null {\n  const value = word.trim()\n  if (!value) return null\n  const byId = targets.pages.find((page) => page.id === value)\n  if (byId) return byId\n  const lower = value.toLowerCase()\n  if (lower.startsWith('/'))\n    return (\n      targets.pages.find((page) => slugOf(page.slug) === slugOf(lower)) ?? null\n    )\n  const words = wordsOf(value).join(' ')\n  return (\n    targets.pages.find((page) => wordsOf(page.label).join(' ') === words) ??\n    // A page merged into the blog is still named by the title it had (AGL-3676).\n    targets.pages.find((page) => page.standsInFor && wordsOf(page.standsInFor).join(' ') === words) ??\n    null\n  )\n}\n\n/** A destination rule 10 admits, from the page it names, for the words a link shows. */\nfunction pageDestination(\n  page: AiLayoutPage | null,\n  label: string,\n  targets: AiLayoutTargets,\n): AiLayoutDestination | null {\n  if (!page || page.id === targets.pageId) return null\n  if (\n    targets.homeIds.includes(page.id) &&\n    !HOME_WORDS.test(label) &&\n    !isHomeSlug(page.slug)\n  )\n    return null\n  if (isHomeSlug(page.slug) && !HOME_WORDS.test(label)) return null\n  if (page.href) return { kind: 'path', href: page.href, ...(page.standsInFor ? { standsInFor: page.standsInFor, label: page.label } : {}) }\n  return { kind: 'page', screenId: page.id }\n}\n\nfunction isHomeSlug(slug: string): boolean {\n  return slugOf(slug) === '/'\n}\n\n/** Where the site's form is: a section of this page, else the page that places it. */\nfunction formDestination(\n  scope: AiLayoutLinkScope,\n  targets: AiLayoutTargets,\n): AiLayoutDestination | null {\n  if (scope.formSection !== null && scope.formSection !== scope.from)\n    return { kind: 'section', index: scope.formSection }\n  if (targets.formPageId && targets.formPageId !== targets.pageId) {\n    return { kind: 'page', screenId: targets.formPageId }\n  }\n  return null\n}\n\n/**\n * Where a link goes: the destination its `to` names, read the language's\n * way; failing that, for words that ask a visitor to get in touch, the site's\n * form; failing that, a page whose name the words say. `null` is a link with\n * nowhere to go, which is left out.\n */\nexport function aiLayoutResolveLink(\n  to: string | undefined,\n  label: string,\n  scope: AiLayoutLinkScope,\n  targets: AiLayoutTargets,\n): AiLayoutDestination | null {\n  const named = to ? resolveNamed(to.trim(), label, scope, targets) : null\n  if (named) return named\n  if (CONTACT_WORDS.test(label)) {\n    const form = formDestination(scope, targets)\n    if (form) return form\n    const contact = targets.pages.find(\n      (page) =>\n        page.id !== targets.pageId &&\n        !isHomeSlug(page.slug) &&\n        CONTACT_WORDS.test(page.label),\n    )\n    if (contact) return { kind: 'page', screenId: contact.id }\n  }\n  const labelWords = new Set(wordsOf(label))\n  const said = targets.pages.filter(\n    (page) =>\n      page.id !== targets.pageId &&\n      !isHomeSlug(page.slug) &&\n      wordsOf(page.label).length > 0 &&\n      wordsOf(page.label).every((word) => labelWords.has(word)),\n  )\n  return said.length === 1 ? { kind: 'page', screenId: said[0].id } : null\n}\n\nfunction resolveNamed(\n  to: string,\n  label: string,\n  scope: AiLayoutLinkScope,\n  targets: AiLayoutTargets,\n): AiLayoutDestination | null {\n  const lower = to.toLowerCase()\n  if (\n    lower === 'form' ||\n    lower.startsWith('form:') ||\n    targets.forms.some((form) => form.id === to)\n  ) {\n    return formDestination(scope, targets)\n  }\n  if (lower.startsWith('https://')) {\n    return targets.facts.includes(to) ? { kind: 'href', href: to } : null\n  }\n  const section = lower.startsWith('#')\n    ? to.slice(1)\n    : lower.startsWith('section:')\n      ? to.slice(8)\n      : null\n  if (section !== null) {\n    const number = Number(section.trim())\n    const index =\n      Number.isInteger(number) && number >= 1 && number <= scope.sections.length\n        ? number - 1\n        : aiPageLinkSection(section, scope.sections)\n    return index !== null && index !== scope.from\n      ? { kind: 'section', index }\n      : null\n  }\n  const page = pageNamed(lower.startsWith('page:') ? to.slice(5) : to, targets)\n  return pageDestination(page, label, targets)\n}\n"],"names":["aiPageLinkSection","aiLayoutRenamedLabel","label","destination","kind","standsInFor","name","toLowerCase","words","wordsOf","length","stems","map","word","replace","pattern","RegExp","stem","join","renamed","found","toUpperCase","text","split","filter","Boolean","slugOf","slug","HOME_WORDS","CONTACT_WORDS","pageNamed","targets","value","trim","byId","pages","find","page","id","lower","startsWith","pageDestination","pageId","homeIds","includes","test","isHomeSlug","href","screenId","formDestination","scope","formSection","from","index","formPageId","aiLayoutResolveLink","to","named","resolveNamed","form","contact","labelWords","Set","said","every","has","forms","some","facts","section","slice","number","Number","isInteger","sections"],"mappings":"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"}

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

@@ -0,0 +1,125 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * 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.
+ */
+export type AiLayoutListingKind = 'products' | 'posts';
+/** 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. */
+export interface AiLayoutListingPlacement {
+    /** The page, by its plan id. */
+    screenId: string;
+    /** The section, by plan index. */
+    section: number;
+    role: AiLayoutListingRole;
+}
+/** A kind of record the site keeps, and where its pages place it. */
+export interface AiLayoutListing {
+    /** `listing:products`, `listing:posts`: what a section's placement names. */
+    id: string;
+    kind: AiLayoutListingKind;
+    /** What a visitor would call the whole list: "the shop", "the blog". */
+    name: string;
+    /** The records it shows today, by name, so a page's words can name them. */
+    records: string[];
+    /** Where the whole list lives, as a path on the site: the blog's `/blog`. */
+    href?: string;
+    /** The content collection a posts listing repeats, by its slug. */
+    collectionSlug?: string;
+    placements: AiLayoutListingPlacement[];
+}
+/** The unit input a site's listings travel in, to its layout and its pages. */
+export declare const AI_LAYOUT_LISTINGS_INPUT = "siteListings";
+/** The id a listing of a kind is placed by. */
+export declare function aiLayoutListingId(kind: AiLayoutListingKind): string;
+/** The persisted element a listing is drawn with, by kind (held to its plugin's source by a spec). */
+export declare const AI_LAYOUT_LISTING_ELEMENTS: Readonly<Record<AiLayoutListingKind, string>>;
+/** The header's cart button: the commerce plugin's Cart in its `button` variant. */
+export declare const AI_LAYOUT_CART_ELEMENT = "cart";
+/** The most records a featured band shows; a page of its own shows them all. */
+export declare const AI_LAYOUT_FEATURED_RECORDS: {
+    readonly products: 4;
+    readonly posts: 3;
+};
+/** A site's listings as its unit inputs carry them; nothing that does not read is kept. */
+export declare function aiLayoutListingsOf(inputs: Readonly<Record<string, unknown>> | null | undefined): AiLayoutListing[];
+/** The listing a section of a page places, and how; `null` for a section that places none. */
+export declare function aiLayoutListingAt(listings: readonly AiLayoutListing[], screenId: string | null | undefined, section: number): {
+    listing: AiLayoutListing;
+    role: AiLayoutListingRole;
+} | null;
+/** The plan of a page, as a placement is chosen from it. */
+export interface AiLayoutListingScreen {
+    id?: string | null;
+    title: string;
+    slug: string;
+    sections: ReadonlyArray<{
+        name: string;
+        items: number;
+    }>;
+}
+/**
+ * The sections of a site's pages that show a listing, chosen by code from the
+ * plan (AGL-3676), never asked of the model:
+ *
+ *  - PRODUCTS. The shop's own page — the page whose address or name says it
+ *    sells (`/shop`, "Shop", "Products") — shows the whole catalog in the
+ *    section the plan gave the most items, else its second; and the home
+ *    page features a few in its first section after the hero whose name
+ *    says products ("Featured candles", "Bestsellers"), else in the first
+ *    section after the hero planned with items.
+ *  - POSTS. The home features the latest in its first section of items after
+ *    the hero whose name says writing ("Featured writing", "Latest posts"),
+ *    else its first section of items after the hero; and any other page
+ *    whose name says it is about the writing does the same. The blog's own
+ *    index is the platform's.
+ *
+ * A section placed once is placed for one listing.
+ */
+export declare function aiLayoutListingPlacements(kind: AiLayoutListingKind, screens: readonly AiLayoutListingScreen[]): AiLayoutListingPlacement[];

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

@@ -0,0 +1,187 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ /**
+ * 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";
+/** 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'
+};
+/** 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
+};
+const PLACEMENT_ROLES = [
+    'featured',
+    'index'
+];
+const KINDS = [
+    'products',
+    'posts'
+];
+const text = (value)=>typeof value === 'string' ? value.trim() : '';
+/** 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){
+        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 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;
+        const placements = (Array.isArray(record['placements']) ? record['placements'] : []).flatMap((value)=>{
+            const placement = value != null ? value : {};
+            const screenId = text(placement['screenId']);
+            const section = placement['section'];
+            const role = placement['role'];
+            return screenId && typeof section === 'number' && Number.isInteger(section) && section >= 0 && PLACEMENT_ROLES.includes(role) ? [
+                {
+                    screenId,
+                    section,
+                    role
+                }
+            ] : [];
+        });
+        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) ? {
+            href
+        } : {}, kind === 'posts' ? {
+            collectionSlug
+        } : {}, {
+            placements
+        }));
+    }
+    return listings;
+}
+/** The listing a section of a page places, and how; `null` for a section that places none. */ export function aiLayoutListingAt(listings, screenId, section) {
+    if (!screenId) return null;
+    for (const listing of listings){
+        const placement = listing.placements.find((entry)=>entry.screenId === screenId && entry.section === section);
+        if (placement) return {
+            listing,
+            role: placement.role
+        };
+    }
+    return null;
+}
+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;
+const firstSegment = (slug)=>slug.trim().replace(/^\/+/, '').split('/')[0].toLowerCase();
+const isHome = (slug)=>firstSegment(slug) === '';
+/**
+ * The sections of a site's pages that show a listing, chosen by code from the
+ * plan (AGL-3676), never asked of the model:
+ *
+ *  - PRODUCTS. The shop's own page — the page whose address or name says it
+ *    sells (`/shop`, "Shop", "Products") — shows the whole catalog in the
+ *    section the plan gave the most items, else its second; and the home
+ *    page features a few in its first section after the hero whose name
+ *    says products ("Featured candles", "Bestsellers"), else in the first
+ *    section after the hero planned with items.
+ *  - POSTS. The home features the latest in its first section of items after
+ *    the hero whose name says writing ("Featured writing", "Latest posts"),
+ *    else its first section of items after the hero; and any other page
+ *    whose name says it is about the writing does the same. The blog's own
+ *    index is the platform's.
+ *
+ * A section placed once is placed for one listing.
+ */ export function aiLayoutListingPlacements(kind, screens) {
+    const placements = [];
+    const place = (screen, section, role)=>{
+        if (typeof screen.id === 'string' && screen.id && section >= 0) placements.push({
+            screenId: screen.id,
+            section,
+            role
+        });
+    };
+    const afterHero = (screen, test)=>screen.sections.findIndex((section, index)=>index > 0 && test(section.name, section.items));
+    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');
+                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');
+        }
+        return placements;
+    }
+    for (const screen of screens){
+        if (isHome(screen.slug)) {
+            // On a blog's home the band that names the writing ("Featured posts
+            // cards", "Featured journeys") lists it; failing one, the first band of
+            // items after the hero. A live Clay Notes plan (2026-10-09) opened its
+            // home with "What you will find" before "Featured posts cards".
+            const named = afterHero(screen, (name, items)=>items > 0 && POST_SECTION.test(name));
+            place(screen, named !== -1 ? named : afterHero(screen, (_name, items)=>items > 0), 'featured');
+            continue;
+        }
+        if (!POST_SECTION.test(screen.title)) continue;
+        place(screen, afterHero(screen, (name)=>POST_SECTION.test(name)), 'featured');
+    }
+    return placements;
+}
+
+//# sourceMappingURL=ai-layout-listings.js.map

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

@@ -0,0 +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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"}

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

@@ -107,11 +107,17 @@ export declare const AI_LAYOUT_STARTER_PHOTOS: {
 /** A small stable number from a seed, so the same job always picks the same photos. */
 export declare function aiLayoutSeedNumber(seed: string): number;
 /**
- * A starter photo for each slot. The hero's and the gallery's pools are
- * rotated by the seed, so sites do not all open with the same photo, while an
- * about picture always leads with the owner; no photo repeats on a page
- * while one is still unused; and a page with more slots than photos starts
- * the round again from its role's pool.
+ * A starter photo for each slot (AGL-3660). No photo repeats on a page while
+ * an unused one remains, and every pool turns by the seed, so sites do not
+ * all open with the same photo while one job always picks the same.
+ *
+ * The slots are served by what they are for, not where they sit: the hero
+ * first, then the pictures of people (an about picture leads with the owner),
+ * then the rest. The live Juniper Clay start (2026-10-08) had six slots and
+ * five starters, and the owner's photo went to a stoneware card before the
+ * About section that described the artist asked for it. Only a page with more
+ * slots than starters repeats one: the photo placed longest ago, never the
+ * one in a slot beside it.
  */
 export declare function aiLayoutStarterPhotos(slots: readonly AiLayoutPictureSlot[], seed: string): AiLayoutPicturePhoto[];
 /**

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

@@ -16,11 +16,45 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
  * limitations under the License.
  */ import { DEFAULT_SITE_IMAGES } from "@aglyn/aglyn/app-utils/default-site";
 /** Words that say a picture shows people, or a section is about them. */ const PEOPLE = /\b(about|team|story|owner|owners|founder|founders|staff|crew|people|person|portrait|meet|family|families|who we are|our (?:team|crew|people|story)|therapist|counsel(?:l)?or|coach|doctor|dentist|stylist|trainer|smil(?:e|es|ing)|headshot)\b/i;
-/** A frame's `aspectRatio` (`'16 / 9'`) as a number. */ function aspectOf(value) {
+/**
+ * An `aspectRatio` (`'16 / 9'`) as a number, or `null` where none is named.
+ * A responsive one (`{ xs: '4 / 3', md: '4 / 5' }`, as a designed page's
+ * pictures carry, AGL-3660) reads at the desktop breakpoint first: one photo
+ * serves every width, and the wide screen is where its shape shows most.
+ */ function aspectOf(value) {
+    if (value && typeof value === 'object') {
+        const byBreakpoint = value;
+        for (const breakpoint of [
+            'md',
+            'lg',
+            'xl',
+            'sm',
+            'xs'
+        ]){
+            const ratio = aspectOf(byBreakpoint[breakpoint]);
+            if (ratio !== null) return ratio;
+        }
+        return null;
+    }
     const match = /^\s*(\d+(?:\.\d+)?)\s*\/\s*(\d+(?:\.\d+)?)\s*$/.exec(String(value != null ? value : ''));
-    if (!match) return 1;
+    if (!match) return null;
     const ratio = Number(match[1]) / Number(match[2]);
-    return Number.isFinite(ratio) && ratio > 0 ? ratio : 1;
+    return Number.isFinite(ratio) && ratio > 0 ? ratio : null;
+}
+/** The shape a full-bleed cover's photo is searched for: it fills a wide band. */ const COVER_ASPECT = 16 / 9;
+/**
+ * A slot's shape (AGL-3660): the image's own `aspectRatio` (a designed
+ * picture card sets it on the image), else its frame's, else — for a frame
+ * laid absolutely over its whole section, a designed photo cover — a wide
+ * band's. 1 where nothing says.
+ */ function slotAspect(image, frame) {
+    var _aspectOf;
+    var _image_sx, _frame_sx;
+    const own = (_aspectOf = aspectOf(image == null ? void 0 : (_image_sx = image.sx) == null ? void 0 : _image_sx['aspectRatio'])) != null ? _aspectOf : aspectOf(frame == null ? void 0 : (_frame_sx = frame.sx) == null ? void 0 : _frame_sx['aspectRatio']);
+    if (own !== null) return own;
+    const sx = frame == null ? void 0 : frame.sx;
+    if ((sx == null ? void 0 : sx['position']) === 'absolute' && sx['width'] === '100%' && sx['height'] === '100%') return COVER_ASPECT;
+    return 1;
 }
 /** A slot's role: the first section's picture is the hero; people make an about picture. */ export function aiLayoutPictureRole(input) {
     if (input.sectionIndex === 0) return 'hero';
@@ -49,7 +83,7 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
             const alt = typeof ((_node_props1 = node.props) == null ? void 0 : _node_props1['alt']) === 'string' ? node.props['alt'].trim() : '';
             if ((typeof src !== 'string' || !src.trim()) && alt) {
                 var _ref, _sections_names_here;
-                var _frame_nodes, _frame_sx;
+                var _frame_nodes;
                 const frame = parentId ? map[parentId] : undefined;
                 const iconId = (_ref = frame == null ? void 0 : (_frame_nodes = frame.nodes) == null ? void 0 : _frame_nodes.find((child)=>{
                     var _map_child;
@@ -60,7 +94,7 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
                     frameId: frame ? parentId : null,
                     iconId,
                     alt,
-                    aspect: aspectOf(frame == null ? void 0 : (_frame_sx = frame.sx) == null ? void 0 : _frame_sx['aspectRatio']),
+                    aspect: slotAspect(node, frame),
                     sectionIndex: here,
                     role: aiLayoutPictureRole({
                         sectionIndex: here,
@@ -114,27 +148,56 @@ function rotate(list, by) {
     ];
 }
 /**
- * A starter photo for each slot. The hero's and the gallery's pools are
- * rotated by the seed, so sites do not all open with the same photo, while an
- * about picture always leads with the owner; no photo repeats on a page
- * while one is still unused; and a page with more slots than photos starts
- * the round again from its role's pool.
+ * A starter photo for each slot (AGL-3660). No photo repeats on a page while
+ * an unused one remains, and every pool turns by the seed, so sites do not
+ * all open with the same photo while one job always picks the same.
+ *
+ * The slots are served by what they are for, not where they sit: the hero
+ * first, then the pictures of people (an about picture leads with the owner),
+ * then the rest. The live Juniper Clay start (2026-10-08) had six slots and
+ * five starters, and the owner's photo went to a stoneware card before the
+ * About section that described the artist asked for it. Only a page with more
+ * slots than starters repeats one: the photo placed longest ago, never the
+ * one in a slot beside it.
  */ export function aiLayoutStarterPhotos(slots, seed) {
     const turn = aiLayoutSeedNumber(seed);
-    const used = new Set();
-    return slots.map((slot)=>{
-        var _find;
+    const order = [
+        'hero',
+        'about',
+        'gallery'
+    ];
+    const served = slots.map((slot, index)=>({
+            slot,
+            index
+        })).sort((a, b)=>order.indexOf(a.slot.role) - order.indexOf(b.slot.role) || a.index - b.index);
+    const names = slots.map(()=>undefined);
+    /** When each starter was last placed, by its turn in the serving order. */ const placedAt = new Map();
+    served.forEach(({ slot, index }, step)=>{
+        var _ref;
         // An about picture leads with the owner on every site; the others turn.
         const pool = slot.role === 'about' ? [
             ...STARTER_POOLS.about
         ] : rotate(STARTER_POOLS[slot.role], turn);
         const rest = rotate(ALL_STARTERS.filter((name)=>!pool.includes(name)), turn);
-        if (used.size >= ALL_STARTERS.length) used.clear();
-        const name = (_find = [
+        const candidates = [
             ...pool,
             ...rest
-        ].find((candidate)=>!used.has(candidate))) != null ? _find : pool[0];
-        used.add(name);
+        ];
+        const unused = candidates.find((candidate)=>!placedAt.has(candidate));
+        const beside = new Set([
+            names[index - 1],
+            names[index + 1]
+        ].filter(Boolean));
+        const name = (_ref = unused != null ? unused : [
+            ...candidates
+        ].sort((a, b)=>{
+            var _placedAt_get, _placedAt_get1;
+            return ((_placedAt_get = placedAt.get(a)) != null ? _placedAt_get : -1) - ((_placedAt_get1 = placedAt.get(b)) != null ? _placedAt_get1 : -1);
+        }).find((candidate)=>!beside.has(candidate))) != null ? _ref : candidates[0];
+        names[index] = name;
+        placedAt.set(name, step);
+    });
+    return names.map((name)=>{
         const photo = AI_LAYOUT_STARTER_PHOTOS[name];
         return {
             src: photo.src,