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

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

@@ -53,6 +53,14 @@ export interface AiLayoutPictureSlot {
     /** The plan index of the section it sits in, or -1. */
     sectionIndex: number;
     role: AiLayoutPictureRole;
+    /**
+     * A product's photo (AGL-3676): what it is of, most specific first — its
+     * name, then what its photo should show — searched for with the shop's
+     * category and held to it, so a wick trimmer is never a laptop on a desk.
+     */
+    product?: {
+        subjects: readonly string[];
+    };
 }
 /** A photo a slot is filled with. */
 export interface AiLayoutPicturePhoto {
@@ -117,7 +125,8 @@ export declare function aiLayoutSeedNumber(seed: string): number;
  * 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.
+ * one in a slot beside it. The owner's portrait goes only to a picture of
+ * people; a gallery picture never takes it, even to avoid a repeat.
  */
 export declare function aiLayoutStarterPhotos(slots: readonly AiLayoutPictureSlot[], seed: string): AiLayoutPicturePhoto[];
 /**

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

@@ -158,7 +158,8 @@ function rotate(list, by) {
  * 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.
+ * one in a slot beside it. The owner's portrait goes only to a picture of
+ * people; a gallery picture never takes it, even to avoid a repeat.
  */ export function aiLayoutStarterPhotos(slots, seed) {
     const turn = aiLayoutSeedNumber(seed);
     const order = [
@@ -179,10 +180,12 @@ function rotate(list, by) {
             ...STARTER_POOLS.about
         ] : rotate(STARTER_POOLS[slot.role], turn);
         const rest = rotate(ALL_STARTERS.filter((name)=>!pool.includes(name)), turn);
+        // The owner's portrait is a picture of a person, and only a picture of
+        // people takes it: never a vase in a gallery (AGL-3660).
         const candidates = [
             ...pool,
             ...rest
-        ];
+        ].filter((name)=>slot.role === 'about' || name !== 'about');
         const unused = candidates.find((candidate)=>!placedAt.has(candidate));
         const beside = new Set([
             names[index - 1],

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/layout-language/ai-layout-pictures.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 { DEFAULT_SITE_IMAGES } from '@aglyn/aglyn/app-utils/default-site'\nimport type { NodesMap } from '@aglyn/aglyn/types/nodes'\n\n/**\n * THE PICTURES OF A LANGUAGE PAGE (AGL-3660).\n *\n * The compiler writes a picture slot as a frame holding an icon and an\n * `image` with alt text and no source (`ai-layout-compiler.ts`), and stays\n * pure: it never looks a photo up. This module is what runs after it, on the\n * stored page — it finds each empty slot, decides what kind of picture the\n * slot is, and fills it with a photo the site can serve from its own origin.\n *\n * Two sources fill a slot, in order:\n *\n * 1. A stock photo searched for by the slot's own description and copied into\n *    the site's media library (`jobs/ai-layout-stock-photos.ts`), when the\n *    deployment has a stock-photo key.\n * 2. Otherwise, or when the search finds nothing fitting, one of the STARTER\n *    PHOTOS every new site is born with (`DEFAULT_SITE_IMAGES`, served at\n *    `/_static/starter/` by the tenant and the console alike, credited in the\n *    CREDITS file beside them). They are the platform's own files, so a\n *    visitor's browser asks no other host for them.\n *\n * The slot keeps the alt text the model wrote whichever source fills it.\n */\n\n/** What a picture slot is for, read from where it sits and what it says. */\nexport type AiLayoutPictureRole = 'hero' | 'about' | 'gallery'\n\n/** One empty picture slot of a stored page, in document order. */\nexport interface AiLayoutPictureSlot {\n  /** The `image` node. */\n  imageId: string\n  /** The frame around it, which sets the slot's shape. */\n  frameId: string | null\n  /** The placeholder icon sharing the frame, taken out once a photo fills it. */\n  iconId: string | null\n  alt: string\n  /** The frame's shape as width over height; 1 when it names none. */\n  aspect: number\n  /** The plan index of the section it sits in, or -1. */\n  sectionIndex: number\n  role: AiLayoutPictureRole\n}\n\n/** A photo a slot is filled with. */\nexport interface AiLayoutPicturePhoto {\n  /** The site-served address: a starter path or the media library's own. */\n  src: string\n  width: number\n  height: number\n}\n\n/** Words that say a picture shows people, or a section is about them. */\nconst PEOPLE =\n  /\\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\n\n/**\n * An `aspectRatio` (`'16 / 9'`) as a number, or `null` where none is named.\n * A responsive one (`{ xs: '4 / 3', md: '4 / 5' }`, as a designed page's\n * pictures carry, AGL-3660) reads at the desktop breakpoint first: one photo\n * serves every width, and the wide screen is where its shape shows most.\n */\nfunction aspectOf(value: unknown): number | null {\n  if (value && typeof value === 'object') {\n    const byBreakpoint = value as Record<string, unknown>\n    for (const breakpoint of ['md', 'lg', 'xl', 'sm', 'xs']) {\n      const ratio = aspectOf(byBreakpoint[breakpoint])\n      if (ratio !== null) return ratio\n    }\n    return null\n  }\n  const match = /^\\s*(\\d+(?:\\.\\d+)?)\\s*\\/\\s*(\\d+(?:\\.\\d+)?)\\s*$/.exec(String(value ?? ''))\n  if (!match) return null\n  const ratio = Number(match[1]) / Number(match[2])\n  return Number.isFinite(ratio) && ratio > 0 ? ratio : null\n}\n\n/** The shape a full-bleed cover's photo is searched for: it fills a wide band. */\nconst COVER_ASPECT = 16 / 9\n\n/**\n * A slot's shape (AGL-3660): the image's own `aspectRatio` (a designed\n * picture card sets it on the image), else its frame's, else — for a frame\n * laid absolutely over its whole section, a designed photo cover — a wide\n * band's. 1 where nothing says.\n */\nfunction slotAspect(image: { sx?: Record<string, unknown> } | undefined, frame: { sx?: Record<string, unknown> } | undefined): number {\n  const own = aspectOf(image?.sx?.['aspectRatio']) ?? aspectOf(frame?.sx?.['aspectRatio'])\n  if (own !== null) return own\n  const sx = frame?.sx\n  if (sx?.['position'] === 'absolute' && sx['width'] === '100%' && sx['height'] === '100%') return COVER_ASPECT\n  return 1\n}\n\n/** A slot's role: the first section's picture is the hero; people make an about picture. */\nexport function aiLayoutPictureRole(input: {\n  sectionIndex: number\n  sectionName: string\n  alt: string\n}): AiLayoutPictureRole {\n  if (input.sectionIndex === 0) return 'hero'\n  if (PEOPLE.test(input.sectionName) || PEOPLE.test(input.alt)) return 'about'\n  return 'gallery'\n}\n\n/**\n * Every empty picture slot of a stored page, walked from its root in\n * document order. A slot that already has a source — one the owner placed, or\n * an earlier pass filled — is not a slot.\n */\nexport function aiLayoutPictureSlots(\n  nodes: NodesMap,\n  rootId: string,\n  sections: { ids: readonly string[]; names: readonly string[] },\n): AiLayoutPictureSlot[] {\n  const map = nodes as unknown as Record<\n    string,\n    { componentId?: string; props?: Record<string, unknown>; sx?: Record<string, unknown>; nodes?: string[] }\n  >\n  const slots: AiLayoutPictureSlot[] = []\n  const seen = new Set<string>()\n  const visit = (id: string, parentId: string | null, sectionIndex: number) => {\n    if (seen.has(id)) return\n    seen.add(id)\n    const node = map[id]\n    if (!node) return\n    const index = sections.ids.indexOf(id)\n    const here = index >= 0 ? index : sectionIndex\n    if (node.componentId === 'image') {\n      const src = node.props?.['src']\n      const alt = typeof node.props?.['alt'] === 'string' ? (node.props['alt'] as string).trim() : ''\n      if ((typeof src !== 'string' || !src.trim()) && alt) {\n        const frame = parentId ? map[parentId] : undefined\n        const iconId =\n          frame?.nodes?.find((child) => child !== id && map[child]?.componentId === 'icon') ?? null\n        slots.push({\n          imageId: id,\n          frameId: frame ? parentId : null,\n          iconId,\n          alt,\n          aspect: slotAspect(node, frame),\n          sectionIndex: here,\n          role: aiLayoutPictureRole({\n            sectionIndex: here,\n            sectionName: here >= 0 ? (sections.names[here] ?? '') : '',\n            alt,\n          }),\n        })\n      }\n    }\n    for (const child of node.nodes ?? []) visit(child, id, here)\n  }\n  visit(rootId, null, -1)\n  return slots\n}\n\n/** The starter photos, by name. */\nexport const AI_LAYOUT_STARTER_PHOTOS = DEFAULT_SITE_IMAGES\n\ntype StarterName = keyof typeof AI_LAYOUT_STARTER_PHOTOS\n\n/**\n * The starter photos each role draws from, best first. A hero draws from the\n * wide photos that read as a page's opening, an about picture leads with the\n * owner, and the rest are the gallery's.\n */\nconst STARTER_POOLS: Readonly<Record<AiLayoutPictureRole, readonly StarterName[]>> = {\n  hero: ['hero', 'desk', 'craft'],\n  about: ['about', 'hero'],\n  gallery: ['desk', 'plants', 'craft'],\n}\n\nconst ALL_STARTERS = Object.keys(AI_LAYOUT_STARTER_PHOTOS) as StarterName[]\n\n/** A small stable number from a seed, so the same job always picks the same photos. */\nexport function aiLayoutSeedNumber(seed: string): number {\n  let hash = 2166136261\n  for (let index = 0; index < seed.length; index += 1) {\n    hash ^= seed.charCodeAt(index)\n    hash = Math.imul(hash, 16777619)\n  }\n  return hash >>> 0\n}\n\nfunction rotate<T>(list: readonly T[], by: number): T[] {\n  if (!list.length) return []\n  const start = by % list.length\n  return [...list.slice(start), ...list.slice(0, start)]\n}\n\n/**\n * A starter photo for each slot (AGL-3660). No photo repeats on a page while\n * an unused one remains, and every pool turns by the seed, so sites do not\n * all open with the same photo while one job always picks the same.\n *\n * The slots are served by what they are for, not where they sit: the hero\n * first, then the pictures of people (an about picture leads with the owner),\n * then the rest. The live Juniper Clay start (2026-10-08) had six slots and\n * five starters, and the owner's photo went to a stoneware card before the\n * About section that described the artist asked for it. Only a page with more\n * slots than starters repeats one: the photo placed longest ago, never the\n * one in a slot beside it.\n */\nexport function aiLayoutStarterPhotos(\n  slots: readonly AiLayoutPictureSlot[],\n  seed: string,\n): AiLayoutPicturePhoto[] {\n  const turn = aiLayoutSeedNumber(seed)\n  const order: AiLayoutPictureRole[] = ['hero', 'about', 'gallery']\n  const served = slots\n    .map((slot, index) => ({ slot, index }))\n    .sort((a, b) => order.indexOf(a.slot.role) - order.indexOf(b.slot.role) || a.index - b.index)\n  const names: Array<StarterName | undefined> = slots.map(() => undefined)\n  /** When each starter was last placed, by its turn in the serving order. */\n  const placedAt = new Map<StarterName, number>()\n  served.forEach(({ slot, index }, step) => {\n    // An about picture leads with the owner on every site; the others turn.\n    const pool = slot.role === 'about' ? [...STARTER_POOLS.about] : rotate(STARTER_POOLS[slot.role], turn)\n    const rest = rotate(\n      ALL_STARTERS.filter((name) => !pool.includes(name)),\n      turn,\n    )\n    const candidates = [...pool, ...rest]\n    const unused = candidates.find((candidate) => !placedAt.has(candidate))\n    const beside = new Set([names[index - 1], names[index + 1]].filter(Boolean))\n    const name =\n      unused ??\n      [...candidates]\n        .sort((a, b) => (placedAt.get(a) ?? -1) - (placedAt.get(b) ?? -1))\n        .find((candidate) => !beside.has(candidate)) ??\n      candidates[0]\n    names[index] = name\n    placedAt.set(name, step)\n  })\n  return names.map((name) => {\n    const photo = AI_LAYOUT_STARTER_PHOTOS[name as StarterName]\n    return { src: photo.src, width: photo.width, height: photo.height }\n  })\n}\n\n/**\n * The page with each slot filled by its photo: the `image` given its source,\n * its intrinsic size and how it loads (the hero eagerly, as the starter home\n * page loads its own), and the placeholder icon taken out of the frame. The\n * alt text is kept as the model wrote it. A slot given no photo is left as\n * the compiler wrote it.\n */\nexport function aiLayoutPlacePictures(\n  nodes: NodesMap,\n  slots: readonly AiLayoutPictureSlot[],\n  photos: ReadonlyArray<AiLayoutPicturePhoto | null>,\n): NodesMap {\n  const next = { ...(nodes as unknown as Record<string, Record<string, unknown>>) }\n  slots.forEach((slot, index) => {\n    const photo = photos[index]\n    const node = next[slot.imageId]\n    if (!photo || !node) return\n    next[slot.imageId] = {\n      ...node,\n      props: {\n        ...((node['props'] as Record<string, unknown> | undefined) ?? {}),\n        src: photo.src,\n        intrinsicWidth: photo.width,\n        intrinsicHeight: photo.height,\n        loading: slot.role === 'hero' ? 'eager' : 'lazy',\n      },\n    }\n    if (slot.iconId && slot.frameId && next[slot.frameId]) {\n      const frame = next[slot.frameId]\n      next[slot.frameId] = {\n        ...frame,\n        nodes: ((frame['nodes'] as string[] | undefined) ?? []).filter((child) => child !== slot.iconId),\n      }\n      delete next[slot.iconId]\n    }\n  })\n  return next as unknown as NodesMap\n}\n\n/**\n * A source of photos found for the slots themselves — a stock search copied\n * into the site's library — answering one photo or `null` per slot, in order.\n * It may throw; a slot it leaves unfilled takes a starter photo.\n */\nexport type AiLayoutPictureSource = (\n  slots: readonly AiLayoutPictureSlot[],\n) => Promise<ReadonlyArray<AiLayoutPicturePhoto | null>>\n\n/**\n * Fills a stored page's empty picture slots (AGL-3660): from `source` where\n * one is given and it answers, else from the starter photos. Never throws,\n * and never leaves a page worse than it came: a picture is decoration, and a\n * job never fails over one.\n */\nexport async function aiResolveLayoutPictures(\n  nodes: NodesMap,\n  input: {\n    rootId: string\n    sectionIds: readonly string[]\n    sectionNames: readonly string[]\n    /** A per-job word, so two sites do not open with the same photo. */\n    seed: string\n    source?: AiLayoutPictureSource | null\n  },\n): Promise<NodesMap> {\n  try {\n    const slots = aiLayoutPictureSlots(nodes, input.rootId, {\n      ids: input.sectionIds,\n      names: input.sectionNames,\n    })\n    if (!slots.length) return nodes\n    let found: ReadonlyArray<AiLayoutPicturePhoto | null> = []\n    if (input.source) {\n      try {\n        found = await input.source(slots)\n      } catch (error) {\n        console.warn('ai layout pictures: the stock source failed; starter photos fill the page', { error })\n        found = []\n      }\n    }\n    const starters = aiLayoutStarterPhotos(slots, input.seed)\n    return aiLayoutPlacePictures(\n      nodes,\n      slots,\n      slots.map((_slot, index) => found[index] ?? starters[index]),\n    )\n  } catch (error) {\n    console.error('ai layout pictures: the page keeps its empty picture slots', { error })\n    return nodes\n  }\n}\n"],"names":["DEFAULT_SITE_IMAGES","PEOPLE","aspectOf","value","byBreakpoint","breakpoint","ratio","match","exec","String","Number","isFinite","COVER_ASPECT","slotAspect","image","frame","own","sx","aiLayoutPictureRole","input","sectionIndex","test","sectionName","alt","aiLayoutPictureSlots","nodes","rootId","sections","map","slots","seen","Set","visit","id","parentId","node","has","add","index","ids","indexOf","here","componentId","src","props","trim","undefined","iconId","find","child","push","imageId","frameId","aspect","role","names","AI_LAYOUT_STARTER_PHOTOS","STARTER_POOLS","hero","about","gallery","ALL_STARTERS","Object","keys","aiLayoutSeedNumber","seed","hash","length","charCodeAt","Math","imul","rotate","list","by","start","slice","aiLayoutStarterPhotos","turn","order","served","slot","sort","a","b","placedAt","Map","forEach","step","unused","pool","rest","filter","name","includes","candidates","candidate","beside","Boolean","get","set","photo","width","height","aiLayoutPlacePictures","photos","next","intrinsicWidth","intrinsicHeight","loading","aiResolveLayoutPictures","sectionIds","sectionNames","found","source","error","console","warn","starters","_slot"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/layout-language/ai-layout-pictures.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 { DEFAULT_SITE_IMAGES } from '@aglyn/aglyn/app-utils/default-site'\nimport type { NodesMap } from '@aglyn/aglyn/types/nodes'\n\n/**\n * THE PICTURES OF A LANGUAGE PAGE (AGL-3660).\n *\n * The compiler writes a picture slot as a frame holding an icon and an\n * `image` with alt text and no source (`ai-layout-compiler.ts`), and stays\n * pure: it never looks a photo up. This module is what runs after it, on the\n * stored page — it finds each empty slot, decides what kind of picture the\n * slot is, and fills it with a photo the site can serve from its own origin.\n *\n * Two sources fill a slot, in order:\n *\n * 1. A stock photo searched for by the slot's own description and copied into\n *    the site's media library (`jobs/ai-layout-stock-photos.ts`), when the\n *    deployment has a stock-photo key.\n * 2. Otherwise, or when the search finds nothing fitting, one of the STARTER\n *    PHOTOS every new site is born with (`DEFAULT_SITE_IMAGES`, served at\n *    `/_static/starter/` by the tenant and the console alike, credited in the\n *    CREDITS file beside them). They are the platform's own files, so a\n *    visitor's browser asks no other host for them.\n *\n * The slot keeps the alt text the model wrote whichever source fills it.\n */\n\n/** What a picture slot is for, read from where it sits and what it says. */\nexport type AiLayoutPictureRole = 'hero' | 'about' | 'gallery'\n\n/** One empty picture slot of a stored page, in document order. */\nexport interface AiLayoutPictureSlot {\n  /** The `image` node. */\n  imageId: string\n  /** The frame around it, which sets the slot's shape. */\n  frameId: string | null\n  /** The placeholder icon sharing the frame, taken out once a photo fills it. */\n  iconId: string | null\n  alt: string\n  /** The frame's shape as width over height; 1 when it names none. */\n  aspect: number\n  /** The plan index of the section it sits in, or -1. */\n  sectionIndex: number\n  role: AiLayoutPictureRole\n  /**\n   * A product's photo (AGL-3676): what it is of, most specific first — its\n   * name, then what its photo should show — searched for with the shop's\n   * category and held to it, so a wick trimmer is never a laptop on a desk.\n   */\n  product?: { subjects: readonly string[] }\n}\n\n/** A photo a slot is filled with. */\nexport interface AiLayoutPicturePhoto {\n  /** The site-served address: a starter path or the media library's own. */\n  src: string\n  width: number\n  height: number\n}\n\n/** Words that say a picture shows people, or a section is about them. */\nconst PEOPLE =\n  /\\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\n\n/**\n * An `aspectRatio` (`'16 / 9'`) as a number, or `null` where none is named.\n * A responsive one (`{ xs: '4 / 3', md: '4 / 5' }`, as a designed page's\n * pictures carry, AGL-3660) reads at the desktop breakpoint first: one photo\n * serves every width, and the wide screen is where its shape shows most.\n */\nfunction aspectOf(value: unknown): number | null {\n  if (value && typeof value === 'object') {\n    const byBreakpoint = value as Record<string, unknown>\n    for (const breakpoint of ['md', 'lg', 'xl', 'sm', 'xs']) {\n      const ratio = aspectOf(byBreakpoint[breakpoint])\n      if (ratio !== null) return ratio\n    }\n    return null\n  }\n  const match = /^\\s*(\\d+(?:\\.\\d+)?)\\s*\\/\\s*(\\d+(?:\\.\\d+)?)\\s*$/.exec(String(value ?? ''))\n  if (!match) return null\n  const ratio = Number(match[1]) / Number(match[2])\n  return Number.isFinite(ratio) && ratio > 0 ? ratio : null\n}\n\n/** The shape a full-bleed cover's photo is searched for: it fills a wide band. */\nconst COVER_ASPECT = 16 / 9\n\n/**\n * A slot's shape (AGL-3660): the image's own `aspectRatio` (a designed\n * picture card sets it on the image), else its frame's, else — for a frame\n * laid absolutely over its whole section, a designed photo cover — a wide\n * band's. 1 where nothing says.\n */\nfunction slotAspect(image: { sx?: Record<string, unknown> } | undefined, frame: { sx?: Record<string, unknown> } | undefined): number {\n  const own = aspectOf(image?.sx?.['aspectRatio']) ?? aspectOf(frame?.sx?.['aspectRatio'])\n  if (own !== null) return own\n  const sx = frame?.sx\n  if (sx?.['position'] === 'absolute' && sx['width'] === '100%' && sx['height'] === '100%') return COVER_ASPECT\n  return 1\n}\n\n/** A slot's role: the first section's picture is the hero; people make an about picture. */\nexport function aiLayoutPictureRole(input: {\n  sectionIndex: number\n  sectionName: string\n  alt: string\n}): AiLayoutPictureRole {\n  if (input.sectionIndex === 0) return 'hero'\n  if (PEOPLE.test(input.sectionName) || PEOPLE.test(input.alt)) return 'about'\n  return 'gallery'\n}\n\n/**\n * Every empty picture slot of a stored page, walked from its root in\n * document order. A slot that already has a source — one the owner placed, or\n * an earlier pass filled — is not a slot.\n */\nexport function aiLayoutPictureSlots(\n  nodes: NodesMap,\n  rootId: string,\n  sections: { ids: readonly string[]; names: readonly string[] },\n): AiLayoutPictureSlot[] {\n  const map = nodes as unknown as Record<\n    string,\n    { componentId?: string; props?: Record<string, unknown>; sx?: Record<string, unknown>; nodes?: string[] }\n  >\n  const slots: AiLayoutPictureSlot[] = []\n  const seen = new Set<string>()\n  const visit = (id: string, parentId: string | null, sectionIndex: number) => {\n    if (seen.has(id)) return\n    seen.add(id)\n    const node = map[id]\n    if (!node) return\n    const index = sections.ids.indexOf(id)\n    const here = index >= 0 ? index : sectionIndex\n    if (node.componentId === 'image') {\n      const src = node.props?.['src']\n      const alt = typeof node.props?.['alt'] === 'string' ? (node.props['alt'] as string).trim() : ''\n      if ((typeof src !== 'string' || !src.trim()) && alt) {\n        const frame = parentId ? map[parentId] : undefined\n        const iconId =\n          frame?.nodes?.find((child) => child !== id && map[child]?.componentId === 'icon') ?? null\n        slots.push({\n          imageId: id,\n          frameId: frame ? parentId : null,\n          iconId,\n          alt,\n          aspect: slotAspect(node, frame),\n          sectionIndex: here,\n          role: aiLayoutPictureRole({\n            sectionIndex: here,\n            sectionName: here >= 0 ? (sections.names[here] ?? '') : '',\n            alt,\n          }),\n        })\n      }\n    }\n    for (const child of node.nodes ?? []) visit(child, id, here)\n  }\n  visit(rootId, null, -1)\n  return slots\n}\n\n/** The starter photos, by name. */\nexport const AI_LAYOUT_STARTER_PHOTOS = DEFAULT_SITE_IMAGES\n\ntype StarterName = keyof typeof AI_LAYOUT_STARTER_PHOTOS\n\n/**\n * The starter photos each role draws from, best first. A hero draws from the\n * wide photos that read as a page's opening, an about picture leads with the\n * owner, and the rest are the gallery's.\n */\nconst STARTER_POOLS: Readonly<Record<AiLayoutPictureRole, readonly StarterName[]>> = {\n  hero: ['hero', 'desk', 'craft'],\n  about: ['about', 'hero'],\n  gallery: ['desk', 'plants', 'craft'],\n}\n\nconst ALL_STARTERS = Object.keys(AI_LAYOUT_STARTER_PHOTOS) as StarterName[]\n\n/** A small stable number from a seed, so the same job always picks the same photos. */\nexport function aiLayoutSeedNumber(seed: string): number {\n  let hash = 2166136261\n  for (let index = 0; index < seed.length; index += 1) {\n    hash ^= seed.charCodeAt(index)\n    hash = Math.imul(hash, 16777619)\n  }\n  return hash >>> 0\n}\n\nfunction rotate<T>(list: readonly T[], by: number): T[] {\n  if (!list.length) return []\n  const start = by % list.length\n  return [...list.slice(start), ...list.slice(0, start)]\n}\n\n/**\n * A starter photo for each slot (AGL-3660). No photo repeats on a page while\n * an unused one remains, and every pool turns by the seed, so sites do not\n * all open with the same photo while one job always picks the same.\n *\n * The slots are served by what they are for, not where they sit: the hero\n * first, then the pictures of people (an about picture leads with the owner),\n * then the rest. The live Juniper Clay start (2026-10-08) had six slots and\n * five starters, and the owner's photo went to a stoneware card before the\n * About section that described the artist asked for it. Only a page with more\n * slots than starters repeats one: the photo placed longest ago, never the\n * one in a slot beside it. The owner's portrait goes only to a picture of\n * people; a gallery picture never takes it, even to avoid a repeat.\n */\nexport function aiLayoutStarterPhotos(\n  slots: readonly AiLayoutPictureSlot[],\n  seed: string,\n): AiLayoutPicturePhoto[] {\n  const turn = aiLayoutSeedNumber(seed)\n  const order: AiLayoutPictureRole[] = ['hero', 'about', 'gallery']\n  const served = slots\n    .map((slot, index) => ({ slot, index }))\n    .sort((a, b) => order.indexOf(a.slot.role) - order.indexOf(b.slot.role) || a.index - b.index)\n  const names: Array<StarterName | undefined> = slots.map(() => undefined)\n  /** When each starter was last placed, by its turn in the serving order. */\n  const placedAt = new Map<StarterName, number>()\n  served.forEach(({ slot, index }, step) => {\n    // An about picture leads with the owner on every site; the others turn.\n    const pool = slot.role === 'about' ? [...STARTER_POOLS.about] : rotate(STARTER_POOLS[slot.role], turn)\n    const rest = rotate(\n      ALL_STARTERS.filter((name) => !pool.includes(name)),\n      turn,\n    )\n    // The owner's portrait is a picture of a person, and only a picture of\n    // people takes it: never a vase in a gallery (AGL-3660).\n    const candidates = [...pool, ...rest].filter((name) => slot.role === 'about' || name !== 'about')\n    const unused = candidates.find((candidate) => !placedAt.has(candidate))\n    const beside = new Set([names[index - 1], names[index + 1]].filter(Boolean))\n    const name =\n      unused ??\n      [...candidates]\n        .sort((a, b) => (placedAt.get(a) ?? -1) - (placedAt.get(b) ?? -1))\n        .find((candidate) => !beside.has(candidate)) ??\n      candidates[0]\n    names[index] = name\n    placedAt.set(name, step)\n  })\n  return names.map((name) => {\n    const photo = AI_LAYOUT_STARTER_PHOTOS[name as StarterName]\n    return { src: photo.src, width: photo.width, height: photo.height }\n  })\n}\n\n/**\n * The page with each slot filled by its photo: the `image` given its source,\n * its intrinsic size and how it loads (the hero eagerly, as the starter home\n * page loads its own), and the placeholder icon taken out of the frame. The\n * alt text is kept as the model wrote it. A slot given no photo is left as\n * the compiler wrote it.\n */\nexport function aiLayoutPlacePictures(\n  nodes: NodesMap,\n  slots: readonly AiLayoutPictureSlot[],\n  photos: ReadonlyArray<AiLayoutPicturePhoto | null>,\n): NodesMap {\n  const next = { ...(nodes as unknown as Record<string, Record<string, unknown>>) }\n  slots.forEach((slot, index) => {\n    const photo = photos[index]\n    const node = next[slot.imageId]\n    if (!photo || !node) return\n    next[slot.imageId] = {\n      ...node,\n      props: {\n        ...((node['props'] as Record<string, unknown> | undefined) ?? {}),\n        src: photo.src,\n        intrinsicWidth: photo.width,\n        intrinsicHeight: photo.height,\n        loading: slot.role === 'hero' ? 'eager' : 'lazy',\n      },\n    }\n    if (slot.iconId && slot.frameId && next[slot.frameId]) {\n      const frame = next[slot.frameId]\n      next[slot.frameId] = {\n        ...frame,\n        nodes: ((frame['nodes'] as string[] | undefined) ?? []).filter((child) => child !== slot.iconId),\n      }\n      delete next[slot.iconId]\n    }\n  })\n  return next as unknown as NodesMap\n}\n\n/**\n * A source of photos found for the slots themselves — a stock search copied\n * into the site's library — answering one photo or `null` per slot, in order.\n * It may throw; a slot it leaves unfilled takes a starter photo.\n */\nexport type AiLayoutPictureSource = (\n  slots: readonly AiLayoutPictureSlot[],\n) => Promise<ReadonlyArray<AiLayoutPicturePhoto | null>>\n\n/**\n * Fills a stored page's empty picture slots (AGL-3660): from `source` where\n * one is given and it answers, else from the starter photos. Never throws,\n * and never leaves a page worse than it came: a picture is decoration, and a\n * job never fails over one.\n */\nexport async function aiResolveLayoutPictures(\n  nodes: NodesMap,\n  input: {\n    rootId: string\n    sectionIds: readonly string[]\n    sectionNames: readonly string[]\n    /** A per-job word, so two sites do not open with the same photo. */\n    seed: string\n    source?: AiLayoutPictureSource | null\n  },\n): Promise<NodesMap> {\n  try {\n    const slots = aiLayoutPictureSlots(nodes, input.rootId, {\n      ids: input.sectionIds,\n      names: input.sectionNames,\n    })\n    if (!slots.length) return nodes\n    let found: ReadonlyArray<AiLayoutPicturePhoto | null> = []\n    if (input.source) {\n      try {\n        found = await input.source(slots)\n      } catch (error) {\n        console.warn('ai layout pictures: the stock source failed; starter photos fill the page', { error })\n        found = []\n      }\n    }\n    const starters = aiLayoutStarterPhotos(slots, input.seed)\n    return aiLayoutPlacePictures(\n      nodes,\n      slots,\n      slots.map((_slot, index) => found[index] ?? starters[index]),\n    )\n  } catch (error) {\n    console.error('ai layout pictures: the page keeps its empty picture slots', { error })\n    return nodes\n  }\n}\n"],"names":["DEFAULT_SITE_IMAGES","PEOPLE","aspectOf","value","byBreakpoint","breakpoint","ratio","match","exec","String","Number","isFinite","COVER_ASPECT","slotAspect","image","frame","own","sx","aiLayoutPictureRole","input","sectionIndex","test","sectionName","alt","aiLayoutPictureSlots","nodes","rootId","sections","map","slots","seen","Set","visit","id","parentId","node","has","add","index","ids","indexOf","here","componentId","src","props","trim","undefined","iconId","find","child","push","imageId","frameId","aspect","role","names","AI_LAYOUT_STARTER_PHOTOS","STARTER_POOLS","hero","about","gallery","ALL_STARTERS","Object","keys","aiLayoutSeedNumber","seed","hash","length","charCodeAt","Math","imul","rotate","list","by","start","slice","aiLayoutStarterPhotos","turn","order","served","slot","sort","a","b","placedAt","Map","forEach","step","unused","pool","rest","filter","name","includes","candidates","candidate","beside","Boolean","get","set","photo","width","height","aiLayoutPlacePictures","photos","next","intrinsicWidth","intrinsicHeight","loading","aiResolveLayoutPictures","sectionIds","sectionNames","found","source","error","console","warn","starters","_slot"],"mappings":"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"}

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

@@ -0,0 +1,82 @@
+/**
+ * @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 STORE'S STOREFRONT (AGL-3676, second round).
+ *
+ * Zach, 2026-10-09, on the beta.237 Willow Wick Candles start (job
+ * MtlXWjvt9P): "again this … site does not look like a store front". Its home
+ * was a lifestyle hero, ONE row of featured products and four text-only bands
+ * ("Why soy, why small batch", "How our candles are made", "Made to be
+ * loved", "Gifting and shipping"); its Shop page opened with a tall hero and
+ * the grid below the fold.
+ *
+ * A designer storefront (Shopify's Dawn, Craft, Sense; Squarespace's commerce
+ * templates) is composed of a handful of PARTS, in a familiar order: a hero
+ * that sells, the store's bestsellers, its collections as picture tiles, the
+ * brand's story beside a photo, why to buy here with icons, what customers
+ * say, and a newsletter sign-up. This module names those parts by the words a
+ * plan gives its sections, so the plan step can make sure a store's home has
+ * them and the compiler and the listings can draw each one its way.
+ *
+ * It is NOT a section library (Zach 10/7): the model still names, orders and
+ * writes every section, and designs each in the layout language; what code
+ * adds is a part the plan left out — named in plain words for the model to
+ * design — and the platform elements that show the store's own records.
+ *
+ * Pure: names and plans only.
+ */
+import type { AiBuildPlanScreen } from '../model/ai-build-plan';
+/** A part a storefront home is composed of. */
+export type AiStorefrontPart = 'featured' | 'collections' | 'story' | 'values' | 'reviews' | 'signup';
+/** The section names that say each part, as a plan or a page heading words it. */
+export declare const AI_STOREFRONT_PART_WORDS: Readonly<Record<AiStorefrontPart, RegExp>>;
+/** Whether a planned section's name says a part. */
+export declare function aiStorefrontSays(part: AiStorefrontPart, name: string): boolean;
+/**
+ * A store plan's screens with the storefront a shopper expects (AGL-3676):
+ *
+ *  - THE HOME (paid starts only — the Free wall prices each section, and a
+ *    Free store sells nothing yet): its hero first, then any part the plan
+ *    left out, added under plain names while the page has room (eight
+ *    sections), in order of need: the bestsellers the platform lists,
+ *    right after the hero; the collections as picture tiles after them; the
+ *    newsletter sign-up as the page's last band; and customer reviews (the
+ *    store's real ones, which show only once shoppers leave them) before
+ *    the close.
+ *  - THE SHOP PAGE: grid first. Its product grid section moves to second,
+ *    straight under the page's short title, so the products open above the
+ *    fold; anything the plan put between them (an intro, a story) follows
+ *    the grid.
+ *
+ * Every section the plan named stays, in its order otherwise; nothing is
+ * removed, and a page at eight sections is given nothing more.
+ */
+export declare function aiStorefrontPlanScreens<S extends Pick<AiBuildPlanScreen, 'slug' | 'title' | 'sections'>>(screens: readonly S[], options: {
+    paid: boolean;
+    isShopPage: (screen: S) => boolean;
+    gridSection: (sections: S['sections']) => number;
+}): S[];
+/**
+ * The icon each of a store's reasons to buy shows (AGL-3676): its own where
+ * the design named one, else one its words suggest, else the next of a few
+ * neutral ones — never the same twice in one row.
+ */
+export declare function aiStorefrontItemIcons(items: ReadonlyArray<{
+    title: string;
+    text: string;
+    icon?: string;
+}>, known: (word: string | undefined) => boolean): string[];

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

@@ -0,0 +1,223 @@
+/**
+ * @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 STORE'S STOREFRONT (AGL-3676, second round).
+ *
+ * Zach, 2026-10-09, on the beta.237 Willow Wick Candles start (job
+ * MtlXWjvt9P): "again this … site does not look like a store front". Its home
+ * was a lifestyle hero, ONE row of featured products and four text-only bands
+ * ("Why soy, why small batch", "How our candles are made", "Made to be
+ * loved", "Gifting and shipping"); its Shop page opened with a tall hero and
+ * the grid below the fold.
+ *
+ * A designer storefront (Shopify's Dawn, Craft, Sense; Squarespace's commerce
+ * templates) is composed of a handful of PARTS, in a familiar order: a hero
+ * that sells, the store's bestsellers, its collections as picture tiles, the
+ * brand's story beside a photo, why to buy here with icons, what customers
+ * say, and a newsletter sign-up. This module names those parts by the words a
+ * plan gives its sections, so the plan step can make sure a store's home has
+ * them and the compiler and the listings can draw each one its way.
+ *
+ * It is NOT a section library (Zach 10/7): the model still names, orders and
+ * writes every section, and designs each in the layout language; what code
+ * adds is a part the plan left out — named in plain words for the model to
+ * design — and the platform elements that show the store's own records.
+ *
+ * Pure: names and plans only.
+ */ import { _ as _extends } from "@swc/helpers/_/_extends";
+/** The section names that say each part, as a plan or a page heading words it. */ export const AI_STOREFRONT_PART_WORDS = {
+    featured: /\b(bestsellers?|best[- ]sellers?|best[- ]selling|featured|new arrivals?|arrivals|just in|favou?rites?|signature|most loved|top picks?|our (?:candles|products|picks)|shop (?:all|now|the))\b/i,
+    collections: /\b(collections?|categor(?:y|ies)|shop by|browse by|by scent|scents?|ranges?|families|occasions?|edits?)\b/i,
+    story: /\b(story|about|our craft|craft|making|made|maker|process|how (?:we|it)|behind|studio|workshop)\b/i,
+    values: /\b(why|promise|promises|values?|difference|shipping|returns?|guarantee|perks?|benefits?|care|small[- ]batch|ingredients?|sustainab\w*)\b/i,
+    reviews: /\b(reviews?|testimonials?|customers? (?:say|love)|what (?:people|customers|our customers) say|kind words|praise|loved by|social proof)\b/i,
+    signup: /\b(newsletter|subscribe|sign[- ]?up|mailing list|join (?:us|the list|our list)|stay in touch|in the loop|first to know|inbox|letters? from)\b/i
+};
+/** Whether a planned section's name says a part. */ export function aiStorefrontSays(part, name) {
+    return AI_STOREFRONT_PART_WORDS[part].test(name);
+}
+/** The plan entry a part the plan left out is added as: plain words the page step designs. */ const ADDED = {
+    featured: {
+        name: 'Bestsellers',
+        uses: [],
+        items: 4
+    },
+    collections: {
+        name: 'Shop by collection',
+        uses: [],
+        items: 3
+    },
+    reviews: {
+        name: 'Customer reviews',
+        uses: [],
+        items: 0
+    },
+    signup: {
+        name: 'Newsletter sign-up',
+        uses: [],
+        items: 0
+    }
+};
+/** The most sections one page of a site start holds (`AI_SITE_MAX_SECTIONS`). */ const MOST_SECTIONS = 8;
+const firstSegment = (slug)=>slug.trim().replace(/^\/+/, '').split('/')[0].toLowerCase();
+/** A section that closes a page: its call to action, a contact or a sign-up band. */ const CLOSING = /\b(cta|call to action|closing|close|contact|get in touch|visit)\b/i;
+/**
+ * A store plan's screens with the storefront a shopper expects (AGL-3676):
+ *
+ *  - THE HOME (paid starts only — the Free wall prices each section, and a
+ *    Free store sells nothing yet): its hero first, then any part the plan
+ *    left out, added under plain names while the page has room (eight
+ *    sections), in order of need: the bestsellers the platform lists,
+ *    right after the hero; the collections as picture tiles after them; the
+ *    newsletter sign-up as the page's last band; and customer reviews (the
+ *    store's real ones, which show only once shoppers leave them) before
+ *    the close.
+ *  - THE SHOP PAGE: grid first. Its product grid section moves to second,
+ *    straight under the page's short title, so the products open above the
+ *    fold; anything the plan put between them (an intro, a story) follows
+ *    the grid.
+ *
+ * Every section the plan named stays, in its order otherwise; nothing is
+ * removed, and a page at eight sections is given nothing more.
+ */ export function aiStorefrontPlanScreens(screens, options) {
+    return screens.map((screen)=>{
+        if (firstSegment(screen.slug) === '') return options.paid ? storefrontHome(screen) : screen;
+        if (!options.isShopPage(screen) || screen.sections.length < 3) return screen;
+        const grid = options.gridSection(screen.sections);
+        if (grid <= 1) return screen;
+        const sections = [
+            ...screen.sections
+        ];
+        const [moved] = sections.splice(grid, 1);
+        sections.splice(1, 0, moved);
+        return _extends({}, screen, {
+            sections
+        });
+    });
+}
+function storefrontHome(screen) {
+    const sections = [
+        ...screen.sections
+    ];
+    if (!sections.length) return screen;
+    // A section about the collections that also names the bestsellers is the bestsellers'.
+    const says = (part, name)=>aiStorefrontSays(part, name) && (part !== 'collections' || !aiStorefrontSays('featured', name));
+    const has = (part)=>sections.some((section, index)=>index > 0 && says(part, section.name));
+    const room = ()=>sections.length < MOST_SECTIONS;
+    // What a shopper meets first matters most, so the parts are added in that
+    // order while the page has room: the bestsellers, the collections, the
+    // sign-up, then the reviews — which show nothing until a shopper writes one.
+    if (!has('featured') && room()) sections.splice(1, 0, _extends({}, ADDED.featured));
+    if (!has('collections') && room()) {
+        // The collections follow the bestsellers.
+        const featured = sections.findIndex((section, index)=>index > 0 && says('featured', section.name));
+        sections.splice(featured > 0 ? featured + 1 : 1, 0, _extends({}, ADDED.collections));
+    }
+    // The newsletter is the page's last band, under any closing call to action.
+    if (!has('signup') && room()) sections.push(_extends({}, ADDED.signup));
+    if (!has('reviews') && room()) {
+        // The reviews come just before the page closes: above a closing sign-up
+        // and above a closing call to action.
+        let at = sections.length;
+        if (at - 1 > 0 && says('signup', sections[at - 1].name)) at -= 1;
+        if (at - 1 > 0 && CLOSING.test(sections[at - 1].name)) at -= 1;
+        sections.splice(at, 0, _extends({}, ADDED.reviews));
+    }
+    return sections.length === screen.sections.length ? screen : _extends({}, screen, {
+        sections
+    });
+}
+// ── Icons for a store's reasons to buy ────────────────────────────────────
+/** Words that suggest an icon from the platform's icon library, first match wins. */ const ICON_WORDS = [
+    [
+        /\b(ship|shipping|shipped|deliver\w*|dispatch\w*|post(?:age|ed)?|courier)\b/i,
+        'truck'
+    ],
+    [
+        /\b(returns?|refunds?|exchanges?)\b/i,
+        'recycle'
+    ],
+    [
+        /\b(gifts?|gifting|wrapped|wrapping|boxed)\b/i,
+        'gift'
+    ],
+    [
+        /\b(natural|soy|organic|plant|vegan|botanical|clean|non-toxic|eco|sustainab\w*|cotton|wood)\b/i,
+        'leaf'
+    ],
+    [
+        /\b(hand|handmade|hand-poured|poured|small[- ]batch|batch|crafted|made|maker|artisan)\b/i,
+        'care'
+    ],
+    [
+        /\b(guarantee\w*|secure|safe|safety|warranty|protected)\b/i,
+        'shield'
+    ],
+    [
+        /\b(fast|quick|same[- ]day|next[- ]day)\b/i,
+        'fast'
+    ],
+    [
+        /\b(quality|award\w*|premium|finest)\b/i,
+        'award'
+    ],
+    [
+        /\b(scents?|fragrances?|aroma\w*|candles?|glow|light|burn\w*)\b/i,
+        'sparkle'
+    ],
+    [
+        /\b(local|town|city|community)\b/i,
+        'location'
+    ],
+    [
+        /\b(support|help|questions?|chat)\b/i,
+        'chat'
+    ]
+];
+/** The fallbacks an item takes in turn, so a row of icons never repeats one. */ const ICON_FALLBACKS = [
+    'star',
+    'heart',
+    'sparkle',
+    'check',
+    'smile',
+    'award'
+];
+/**
+ * The icon each of a store's reasons to buy shows (AGL-3676): its own where
+ * the design named one, else one its words suggest, else the next of a few
+ * neutral ones — never the same twice in one row.
+ */ export function aiStorefrontItemIcons(items, known) {
+    const used = new Set();
+    const designed = items.map((item)=>{
+        if (item.icon && known(item.icon) && !used.has(item.icon)) {
+            used.add(item.icon);
+            return item.icon;
+        }
+        return '';
+    });
+    return designed.map((icon, index)=>{
+        var _ref;
+        var _ICON_WORDS_find;
+        if (icon) return icon;
+        const words = `${items[index].title} ${items[index].text}`;
+        const suggested = (_ICON_WORDS_find = ICON_WORDS.find(([pattern, word])=>pattern.test(words) && !used.has(word) && known(word))) == null ? void 0 : _ICON_WORDS_find[1];
+        const picked = (_ref = suggested != null ? suggested : ICON_FALLBACKS.find((word)=>!used.has(word) && known(word))) != null ? _ref : 'star';
+        used.add(picked);
+        return picked;
+    });
+}
+
+//# sourceMappingURL=ai-layout-storefront.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/layout-language/ai-layout-storefront.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 STORE'S STOREFRONT (AGL-3676, second round).\n *\n * Zach, 2026-10-09, on the beta.237 Willow Wick Candles start (job\n * MtlXWjvt9P): \"again this … site does not look like a store front\". Its home\n * was a lifestyle hero, ONE row of featured products and four text-only bands\n * (\"Why soy, why small batch\", \"How our candles are made\", \"Made to be\n * loved\", \"Gifting and shipping\"); its Shop page opened with a tall hero and\n * the grid below the fold.\n *\n * A designer storefront (Shopify's Dawn, Craft, Sense; Squarespace's commerce\n * templates) is composed of a handful of PARTS, in a familiar order: a hero\n * that sells, the store's bestsellers, its collections as picture tiles, the\n * brand's story beside a photo, why to buy here with icons, what customers\n * say, and a newsletter sign-up. This module names those parts by the words a\n * plan gives its sections, so the plan step can make sure a store's home has\n * them and the compiler and the listings can draw each one its way.\n *\n * It is NOT a section library (Zach 10/7): the model still names, orders and\n * writes every section, and designs each in the layout language; what code\n * adds is a part the plan left out — named in plain words for the model to\n * design — and the platform elements that show the store's own records.\n *\n * Pure: names and plans only.\n */\n\nimport type { AiBuildPlanScreen, AiBuildPlanSection } from '../model/ai-build-plan'\n\n/** A part a storefront home is composed of. */\nexport type AiStorefrontPart = 'featured' | 'collections' | 'story' | 'values' | 'reviews' | 'signup'\n\n/** The section names that say each part, as a plan or a page heading words it. */\nexport const AI_STOREFRONT_PART_WORDS: Readonly<Record<AiStorefrontPart, RegExp>> = {\n  featured:\n    /\\b(bestsellers?|best[- ]sellers?|best[- ]selling|featured|new arrivals?|arrivals|just in|favou?rites?|signature|most loved|top picks?|our (?:candles|products|picks)|shop (?:all|now|the))\\b/i,\n  collections: /\\b(collections?|categor(?:y|ies)|shop by|browse by|by scent|scents?|ranges?|families|occasions?|edits?)\\b/i,\n  story: /\\b(story|about|our craft|craft|making|made|maker|process|how (?:we|it)|behind|studio|workshop)\\b/i,\n  values: /\\b(why|promise|promises|values?|difference|shipping|returns?|guarantee|perks?|benefits?|care|small[- ]batch|ingredients?|sustainab\\w*)\\b/i,\n  reviews: /\\b(reviews?|testimonials?|customers? (?:say|love)|what (?:people|customers|our customers) say|kind words|praise|loved by|social proof)\\b/i,\n  signup: /\\b(newsletter|subscribe|sign[- ]?up|mailing list|join (?:us|the list|our list)|stay in touch|in the loop|first to know|inbox|letters? from)\\b/i,\n}\n\n/** Whether a planned section's name says a part. */\nexport function aiStorefrontSays(part: AiStorefrontPart, name: string): boolean {\n  return AI_STOREFRONT_PART_WORDS[part].test(name)\n}\n\n/** The plan entry a part the plan left out is added as: plain words the page step designs. */\nconst ADDED: Readonly<Record<'featured' | 'collections' | 'reviews' | 'signup', AiBuildPlanSection>> = {\n  featured: { name: 'Bestsellers', uses: [], items: 4 },\n  collections: { name: 'Shop by collection', uses: [], items: 3 },\n  reviews: { name: 'Customer reviews', uses: [], items: 0 },\n  signup: { name: 'Newsletter sign-up', uses: [], items: 0 },\n}\n\n/** The most sections one page of a site start holds (`AI_SITE_MAX_SECTIONS`). */\nconst MOST_SECTIONS = 8\n\nconst firstSegment = (slug: string) => slug.trim().replace(/^\\/+/, '').split('/')[0].toLowerCase()\n\n/** A section that closes a page: its call to action, a contact or a sign-up band. */\nconst CLOSING = /\\b(cta|call to action|closing|close|contact|get in touch|visit)\\b/i\n\n/**\n * A store plan's screens with the storefront a shopper expects (AGL-3676):\n *\n *  - THE HOME (paid starts only — the Free wall prices each section, and a\n *    Free store sells nothing yet): its hero first, then any part the plan\n *    left out, added under plain names while the page has room (eight\n *    sections), in order of need: the bestsellers the platform lists,\n *    right after the hero; the collections as picture tiles after them; the\n *    newsletter sign-up as the page's last band; and customer reviews (the\n *    store's real ones, which show only once shoppers leave them) before\n *    the close.\n *  - THE SHOP PAGE: grid first. Its product grid section moves to second,\n *    straight under the page's short title, so the products open above the\n *    fold; anything the plan put between them (an intro, a story) follows\n *    the grid.\n *\n * Every section the plan named stays, in its order otherwise; nothing is\n * removed, and a page at eight sections is given nothing more.\n */\nexport function aiStorefrontPlanScreens<S extends Pick<AiBuildPlanScreen, 'slug' | 'title' | 'sections'>>(\n  screens: readonly S[],\n  options: { paid: boolean; isShopPage: (screen: S) => boolean; gridSection: (sections: S['sections']) => number },\n): S[] {\n  return screens.map((screen) => {\n    if (firstSegment(screen.slug) === '') return options.paid ? storefrontHome(screen) : screen\n    if (!options.isShopPage(screen) || screen.sections.length < 3) return screen\n    const grid = options.gridSection(screen.sections)\n    if (grid <= 1) return screen\n    const sections = [...screen.sections]\n    const [moved] = sections.splice(grid, 1)\n    sections.splice(1, 0, moved)\n    return { ...screen, sections }\n  })\n}\n\nfunction storefrontHome<S extends Pick<AiBuildPlanScreen, 'sections'>>(screen: S): S {\n  const sections = [...screen.sections]\n  if (!sections.length) return screen\n  // A section about the collections that also names the bestsellers is the bestsellers'.\n  const says = (part: AiStorefrontPart, name: string) =>\n    aiStorefrontSays(part, name) && (part !== 'collections' || !aiStorefrontSays('featured', name))\n  const has = (part: AiStorefrontPart) => sections.some((section, index) => index > 0 && says(part, section.name))\n  const room = () => sections.length < MOST_SECTIONS\n  // What a shopper meets first matters most, so the parts are added in that\n  // order while the page has room: the bestsellers, the collections, the\n  // sign-up, then the reviews — which show nothing until a shopper writes one.\n  if (!has('featured') && room()) sections.splice(1, 0, { ...ADDED.featured })\n  if (!has('collections') && room()) {\n    // The collections follow the bestsellers.\n    const featured = sections.findIndex((section, index) => index > 0 && says('featured', section.name))\n    sections.splice(featured > 0 ? featured + 1 : 1, 0, { ...ADDED.collections })\n  }\n  // The newsletter is the page's last band, under any closing call to action.\n  if (!has('signup') && room()) sections.push({ ...ADDED.signup })\n  if (!has('reviews') && room()) {\n    // The reviews come just before the page closes: above a closing sign-up\n    // and above a closing call to action.\n    let at = sections.length\n    if (at - 1 > 0 && says('signup', sections[at - 1].name)) at -= 1\n    if (at - 1 > 0 && CLOSING.test(sections[at - 1].name)) at -= 1\n    sections.splice(at, 0, { ...ADDED.reviews })\n  }\n  return sections.length === screen.sections.length ? screen : { ...screen, sections }\n}\n\n// ── Icons for a store's reasons to buy ────────────────────────────────────\n\n/** Words that suggest an icon from the platform's icon library, first match wins. */\nconst ICON_WORDS: ReadonlyArray<readonly [RegExp, string]> = [\n  [/\\b(ship|shipping|shipped|deliver\\w*|dispatch\\w*|post(?:age|ed)?|courier)\\b/i, 'truck'],\n  [/\\b(returns?|refunds?|exchanges?)\\b/i, 'recycle'],\n  [/\\b(gifts?|gifting|wrapped|wrapping|boxed)\\b/i, 'gift'],\n  [/\\b(natural|soy|organic|plant|vegan|botanical|clean|non-toxic|eco|sustainab\\w*|cotton|wood)\\b/i, 'leaf'],\n  [/\\b(hand|handmade|hand-poured|poured|small[- ]batch|batch|crafted|made|maker|artisan)\\b/i, 'care'],\n  [/\\b(guarantee\\w*|secure|safe|safety|warranty|protected)\\b/i, 'shield'],\n  [/\\b(fast|quick|same[- ]day|next[- ]day)\\b/i, 'fast'],\n  [/\\b(quality|award\\w*|premium|finest)\\b/i, 'award'],\n  [/\\b(scents?|fragrances?|aroma\\w*|candles?|glow|light|burn\\w*)\\b/i, 'sparkle'],\n  [/\\b(local|town|city|community)\\b/i, 'location'],\n  [/\\b(support|help|questions?|chat)\\b/i, 'chat'],\n]\n\n/** The fallbacks an item takes in turn, so a row of icons never repeats one. */\nconst ICON_FALLBACKS = ['star', 'heart', 'sparkle', 'check', 'smile', 'award'] as const\n\n/**\n * The icon each of a store's reasons to buy shows (AGL-3676): its own where\n * the design named one, else one its words suggest, else the next of a few\n * neutral ones — never the same twice in one row.\n */\nexport function aiStorefrontItemIcons(\n  items: ReadonlyArray<{ title: string; text: string; icon?: string }>,\n  known: (word: string | undefined) => boolean,\n): string[] {\n  const used = new Set<string>()\n  const designed = items.map((item) => {\n    if (item.icon && known(item.icon) && !used.has(item.icon)) {\n      used.add(item.icon)\n      return item.icon\n    }\n    return ''\n  })\n  return designed.map((icon, index) => {\n    if (icon) return icon\n    const words = `${items[index].title} ${items[index].text}`\n    const suggested = ICON_WORDS.find(([pattern, word]) => pattern.test(words) && !used.has(word) && known(word))?.[1]\n    const picked = suggested ?? ICON_FALLBACKS.find((word) => !used.has(word) && known(word)) ?? 'star'\n    used.add(picked)\n    return picked\n  })\n}\n"],"names":["AI_STOREFRONT_PART_WORDS","featured","collections","story","values","reviews","signup","aiStorefrontSays","part","name","test","ADDED","uses","items","MOST_SECTIONS","firstSegment","slug","trim","replace","split","toLowerCase","CLOSING","aiStorefrontPlanScreens","screens","options","map","screen","paid","storefrontHome","isShopPage","sections","length","grid","gridSection","moved","splice","says","has","some","section","index","room","findIndex","push","at","ICON_WORDS","ICON_FALLBACKS","aiStorefrontItemIcons","known","used","Set","designed","item","icon","add","suggested","words","title","text","find","pattern","word","picked"],"mappings":"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"}

package/src/lib/model/ai-build-job.d.ts

@@ -17,6 +17,7 @@
 import { type PluginAiCapability } from '@aglyn/aglyn/plugin-manager/plugin-ai-capabilities';
 import { type AiBuildItem, type AiBuildPlan, type AiBuildPlanCreate, type AiBuildPlanCreateKind, type AiBuildPlanScreen } from './ai-build-plan';
 import type { AiJobItemLedger } from './ai-jobs.types';
+import { type AiCreditRange, type AiCreditsSmaller } from './ai-credit-estimate';
 /**
  * What a `build` job is (AGL-3616): one request — "a few pages, a contact
  * form and a way to book me" — planned as creations, pages and items, built
@@ -43,6 +44,14 @@ export declare const AI_BUILD_LIMITS: {
     /** A Free workspace's pages. */
     readonly freePages: 2;
 };
+/**
+ * What a Free build's plan card says when it holds as many pages as a Free
+ * build makes (AGL-3722): the plan is told the cap and plans the first pages
+ * a request asks for, so a request for three — "About us, Custom cakes and
+ * Catering", 2026-10-10 — came back as two with nothing saying why. `null`
+ * when the plan holds fewer, or on a paid workspace.
+ */
+export declare function aiBuildFreePageCapNote(plan: Pick<AiBuildPlan, 'screens'>, freeTaste: boolean): string | null;
 /** What a build creates through its `create` list; everything else beyond pages is an item. */
 export declare const AI_BUILD_CREATE_KINDS: readonly AiBuildPlanCreateKind[];
 /**
@@ -124,6 +133,36 @@ export declare function aiBuildCreditEstimate(plan: AiBuildPlan, options?: {
  * units, every other planned kind as `aiJobPlanCreditEstimate` counts it.
  */
 export declare function aiJobCreditEstimate(kind: string, plan: AiBuildPlan): number;
+/**
+ * What one unit is likely to cost, its p90 and its ceiling (AGL-3722): a page
+ * as a page written on its own measured (a fixed cost and one per section), a creation at what its kind
+ * measured, an item at the measured pass times the passes its capability
+ * estimates (none for a draft another plugin writes, which asks no model).
+ * The ceiling is `aiBuildUnitCreditEstimate`, unchanged.
+ */
+export declare function aiBuildUnitCreditRange(unit: AiBuildUnit, ops?: AiBuildOps): AiCreditRange;
+/**
+ * What a build is likely to cost, its p90 and its ceiling (AGL-3722): every
+ * unit's range, or only the units named in `slots` — what Try again runs.
+ * The plan card, Try again and the Free admission all read this; the meter
+ * charges what actually runs.
+ */
+export declare function aiBuildCreditRange(plan: AiBuildPlan, options?: {
+    ops?: AiBuildOps;
+    slots?: ReadonlySet<string>;
+}): AiCreditRange;
+/** `aiJobCreditEstimate` as a range (AGL-3722). */
+export declare function aiJobCreditRange(kind: string, plan: AiBuildPlan): AiCreditRange;
+/**
+ * A smaller first build (AGL-3722): the plan's home page — its first page
+ * where it has no home — and only what that page needs, transitively: the
+ * layout it is drawn in, the form and anything else its sections place.
+ * Every other page, and what only they needed, waits for a later request.
+ * `null` when the plan has no page, or when the smaller plan is the whole one.
+ */
+export declare function aiBuildFirstPagePlan<T extends AiBuildPlan>(plan: T): T | null;
+/** The smaller first build a build that does not fit is offered (AGL-3722), with its range; `null` when there is none. */
+export declare function aiBuildSmaller(plan: AiBuildPlan, ops?: AiBuildOps): AiCreditsSmaller | null;
 /** A fresh ledger: one pending row per unit, first attempt. */
 export declare function aiBuildInitialLedger(units: readonly AiBuildUnit[]): AiJobItemLedger[];
 /** Whether an item is still to be built. */