@aglyn/plugins-ai 1.0.0-beta.237 → 1.0.0-beta.239

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

@@ -44,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[];
 /**
@@ -127,7 +135,7 @@ export declare function aiBuildCreditEstimate(plan: AiBuildPlan, options?: {
 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
- * by its sections around the measured page, a creation at what its kind
+ * 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.
@@ -195,6 +203,8 @@ export declare function aiBuildDegradation(unit: AiBuildUnit, context: {
     ledger: readonly AiJobItemLedger[];
     ops?: AiBuildOps;
 }): AiBuildDegradation;
+/** The dataset a form unit writes to, by its `new:` name lowercased; `null` for any other unit (AGL-3616). */
+export declare function aiBuildUnitWritesTo(unit: Pick<AiBuildUnit, 'creation'>): string | null;
 /** What each creation is called in a note. */
 export declare function aiBuildCreationNoun(kind: AiBuildPlanCreateKind): string;
 /**

package/src/lib/model/ai-build-job.js

@@ -16,7 +16,7 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
  * limitations under the License.
  */ import { pluginAiCapabilityArgsProblems } from "@aglyn/aglyn/plugin-manager/plugin-ai-capabilities";
 import { AI_PLAN_NEW_REF_PREFIX, isAiPlanNewRef } from "./ai-build-plan.js";
-import { AI_SITE_HOME_FIRST_LABEL, AI_SITE_MAX_SECTIONS, AI_SITE_PASS_CREDITS, aiCreationMeasuredCredits, aiJobPlanCreditEstimate, aiJobPlanCreditRange, aiScreenCreditRange, aiSitePlanIsHome } from "./ai-site-job.js";
+import { AI_SITE_HOME_FIRST_LABEL, AI_SITE_MAX_SECTIONS, AI_SITE_PASS_CREDITS, aiCreationMeasuredCredits, aiJobPlanCreditEstimate, aiJobPlanCreditRange, aiSitePlanIsHome, aiStandaloneScreenCreditRange } from "./ai-site-job.js";
 import { AI_CREDIT_RANGE_ZERO, AI_MEASURED_PASS_CREDITS, aiCreditRangeAdd, aiCreditRangeOf, aiCreditRangeOrdered } from "./ai-credit-estimate.js";
 /**
  * What a `build` job is (AGL-3616): one request — "a few pages, a contact
@@ -40,6 +40,17 @@ import { AI_CREDIT_RANGE_ZERO, AI_MEASURED_PASS_CREDITS, aiCreditRangeAdd, aiCre
     pages: 8,
     /** A Free workspace's pages. */ 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 function aiBuildFreePageCapNote(plan, freeTaste) {
+    const cap = AI_BUILD_LIMITS.freePages;
+    if (!freeTaste || plan.screens.length < cap) return null;
+    return `A Free workspace’s build makes up to ${cap} pages at a time. If you asked for more, ask Assist for the rest once this build is done.`;
+}
 /** What a build creates through its `create` list; everything else beyond pages is an item. */ export const AI_BUILD_CREATE_KINDS = [
     'layout',
     'form',
@@ -96,15 +107,18 @@ import { AI_CREDIT_RANGE_ZERO, AI_MEASURED_PASS_CREDITS, aiCreditRangeAdd, aiCre
     };
     const units = [];
     plan.create.forEach((creation, index)=>{
+        var _creation_writesTo;
         if (!AI_BUILD_CREATE_KINDS.includes(creation.kind)) return;
         const slot = `c${index}`;
+        // A form is built after the dataset it writes to (AGL-3616).
         units.push({
             slot,
             op: creationOp(creation),
             label: creation.name,
             creation,
             deps: depsOf([
-                creation.duplicateOf
+                creation.duplicateOf,
+                creation.kind === 'form' ? (_creation_writesTo = creation.writesTo) != null ? _creation_writesTo : null : null
             ], slot)
         });
     });
@@ -266,14 +280,17 @@ import { AI_CREDIT_RANGE_ZERO, AI_MEASURED_PASS_CREDITS, aiCreditRangeAdd, aiCre
 }
 /**
  * What one unit is likely to cost, its p90 and its ceiling (AGL-3722): a page
- * by its sections around the measured page, a creation at what its kind
+ * 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 function aiBuildUnitCreditRange(unit, ops) {
     const ceiling = aiBuildUnitCreditEstimate(unit, ops);
-    if (unit.screen) return aiScreenCreditRange(unit.screen.sections.length);
-    if (unit.creation) return aiCreditRangeOf(aiCreationMeasuredCredits(unit.creation.kind), ceiling);
+    // A build writes each page on its own, never in a site start's warm run (AGL-3722).
+    if (unit.screen) return aiStandaloneScreenCreditRange(unit.screen.sections.length);
+    if (unit.creation) return aiCreditRangeOf(aiCreationMeasuredCredits(unit.creation.kind, {
+        standalone: true
+    }), ceiling);
     const passes = Math.ceil(ceiling / AI_SITE_PASS_CREDITS);
     return aiCreditRangeOf({
         median: passes * AI_MEASURED_PASS_CREDITS.median,
@@ -341,7 +358,7 @@ import { AI_CREDIT_RANGE_ZERO, AI_MEASURED_PASS_CREDITS, aiCreditRangeAdd, aiCre
     const smaller = aiBuildFirstPagePlan(plan);
     if (!smaller) return null;
     const screen = smaller.screens[0];
-    const label = aiSitePlanIsHome(screen) ? AI_SITE_HOME_FIRST_LABEL : `Build the page “${screen.title}” first`;
+    const label = aiSitePlanIsHome(screen) ? AI_SITE_HOME_FIRST_LABEL : `Build the ${screen.title} page first`;
     return _extends({
         label
     }, aiBuildCreditRange(smaller, {
@@ -421,6 +438,13 @@ const OPEN = [
         const noun = dep.creation ? aiBuildCreationNoun(dep.creation.kind) : (_ref = (_context_ops = context.ops) == null ? void 0 : (_context_ops_get = _context_ops.get(dep.op)) == null ? void 0 : _context_ops_get.noun) != null ? _ref : dep.op;
         const capability = dep.item ? (_context_ops1 = context.ops) == null ? void 0 : _context_ops1.get(dep.op) : undefined;
         const degrade = (_ref1 = (_ref2 = (_dep_item = dep.item) == null ? void 0 : _dep_item.degrade) != null ? _ref2 : capability == null ? void 0 : capability.degrade) != null ? _ref1 : ((_dep_creation = dep.creation) == null ? void 0 : _dep_creation.kind) === 'layout' ? 'fallback' : 'omit';
+        // A form whose dataset could not be made is built without it (AGL-3616):
+        // its submissions reach the Inbox, as any form's do.
+        if (aiBuildUnitWritesTo(unit) === dep.label.toLowerCase()) {
+            result.degradedBy.push(slot);
+            result.notes.push(`Its submissions arrive in the Inbox only: the dataset “${dep.label}” could not be created.`);
+            continue;
+        }
         if (!unit.screen && degrade === 'omit') {
             result.skip = `Not built: the ${noun} “${dep.label}” it needs could not be created.`;
             result.degradedBy.push(slot);
@@ -444,6 +468,11 @@ const OPEN = [
     }
     return result;
 }
+/** The dataset a form unit writes to, by its `new:` name lowercased; `null` for any other unit (AGL-3616). */ export function aiBuildUnitWritesTo(unit) {
+    var _unit_creation;
+    const ref = ((_unit_creation = unit.creation) == null ? void 0 : _unit_creation.kind) === 'form' ? unit.creation.writesTo : null;
+    return isAiPlanNewRef(ref) ? aiBuildRefName(ref) : null;
+}
 /** What each creation is called in a note. */ export function aiBuildCreationNoun(kind) {
     return kind === 'email' ? 'email design' : kind === 'theme-change' ? 'theme change' : kind;
 }