@aglyn/aglyn 1.0.0-beta.218 → 1.0.0-beta.220

package/src/lib/app-utils/starter-templates.js

@@ -19,11 +19,14 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
 // it, the console's seed route materializes them, and the AI plugin's server
 // shows them to a model — and neither barrel works in both: the full
 // `@aglyn/aglyn` barrel breaks the RSC/server-route graph, while the server
-// entry drags `node:fs` into the client bundle. The canvas constants are a
-// leaf with no imports of their own, and `screen-route` imports only a TYPE
-// from foundation, so both are safe on either side.
-import { CANVAS_ROOT_ELEMENT_ID } from "../foundation/constants/canvas.js";
+// entry drags `node:fs` into the client bundle. The starter kit imports only
+// the canvas constants, a leaf with no imports of their own; the compiled
+// plugin starters are data behind a type-only import; and `screen-route`
+// imports only a TYPE from foundation — so all three are safe on either side.
+import { PLUGIN_STARTER_TEMPLATES } from "./plugin-starter-templates.generated.js";
 import { normalizeScreenSlug, SCREEN_ROOT_PATH } from "./screen-route.js";
+import { buildStarterNodes as buildNodes, starterHeroSection as heroSection, starterSection as section, starterText as text } from "./starter-template-nodes.js";
+export { buildStarterNodes, starterHeroSection, starterSection, starterText } from "./starter-template-nodes.js";
 /**
  * Deterministic document id for a seeded starter screen (AGL-687).
  *
@@ -79,112 +82,6 @@ import { normalizeScreenSlug, SCREEN_ROOT_PATH } from "./screen-route.js";
 /** Every document a starter COULD materialize as, in bundle order. */ export function buildAllStarterTemplateDocs() {
     return STARTER_TEMPLATES.flatMap(buildStarterTemplateDocs);
 }
-/** Builds the flat, persisted node map from a nested spec. */ function buildNodes(children) {
-    const map = {
-        [CANVAS_ROOT_ELEMENT_ID]: {
-            $id: CANVAS_ROOT_ELEMENT_ID,
-            componentId: 'div',
-            nodes: children.map((child)=>child.id)
-        }
-    };
-    const walk = (spec, parentId)=>{
-        var _spec_pluginId, _spec_props, _spec_children, _spec_children1;
-        map[spec.id] = _extends({
-            $id: spec.id,
-            componentId: spec.componentId,
-            pluginId: (_spec_pluginId = spec.pluginId) != null ? _spec_pluginId : 'mui',
-            parentId,
-            props: (_spec_props = spec.props) != null ? _spec_props : {}
-        }, spec.sx ? {
-            sx: spec.sx
-        } : {}, {
-            nodes: ((_spec_children = spec.children) != null ? _spec_children : []).map((child)=>child.id)
-        });
-        for (const child of (_spec_children1 = spec.children) != null ? _spec_children1 : [])walk(child, spec.id);
-    };
-    for (const child of children)walk(child, CANVAS_ROOT_ELEMENT_ID);
-    return map;
-}
-const text = (id, variant, children, extra)=>({
-        id,
-        componentId: 'muiTypography',
-        props: _extends({
-            variant,
-            children
-        }, extra)
-    });
-/**
- * One page band: a `Container` at a stock width, carrying the band's own
- * vertical rhythm (AGL-1932).
- *
- * The layout standard (AGL-1298): every section is a Container. Full-bleed is
- * the Container's own full-width attribute, never the absence of a Container,
- * and anything else is one of three stock widths. A template that seeds no
- * Container hands every customer a site that starts outside the standard.
- *
- * How the three widths are chosen here, stated so the next audit does not
- * have to guess:
- *
- * - `xl` — a marketing band: hero, feature row, product grid, gallery. The
- *   default width, and what an unremarkable page should be.
- * - `lg` — the deliberate middle case: wide but text-led and interactive.
- *   Cart and account are the honest instances, not decoration.
- * - `md` — long-form prose and narrow form columns, on READING grounds: at
- *   `xl` a paragraph runs 110–120 characters a line. This is the case the
- *   `Prose Container` preset exists for.
- *
- * Horizontal padding is the Container's own gutters, so bands no longer carry
- * horizontal padding at all. Only the vertical rhythm rides here, which is
- * rhythm rather than width.
- *
- * Written as the two longhands rather than MUI's `py` (AGL-2207/2208): the
- * Styles panel's Padding control is named for the four sides, so a band
- * seeded with `py` handed the customer a document whose padding the panel
- * showed as empty and no click could clear.
- */ const section = (id, maxWidth, verticalPadding, children)=>({
-        id,
-        componentId: 'muiContainer',
-        props: {
-            maxWidth
-        },
-        sx: {
-            paddingTop: verticalPadding,
-            paddingBottom: verticalPadding
-        },
-        children
-    });
-const heroSection = (prefix, headline, tagline)=>// The Container is a NEW node (`…heroSection`); `…hero` keeps its id and
-    // stays the Stack. Node ids here are persisted identifiers, so bands are
-    // wrapped rather than re-pointed.
-    section(`${prefix}heroSection`, 'xl', 10, [
-        {
-            id: `${prefix}hero`,
-            componentId: 'muiStack',
-            props: {
-                spacing: 2
-            },
-            sx: {
-                alignItems: 'center'
-            },
-            children: [
-                text(`${prefix}heroTitle`, 'h2', headline, {
-                    align: 'center'
-                }),
-                text(`${prefix}heroSub`, 'h6', tagline, {
-                    align: 'center'
-                }),
-                {
-                    id: `${prefix}heroCta`,
-                    componentId: 'muiButton',
-                    props: {
-                        variant: 'contained',
-                        size: 'large',
-                        children: 'Get in touch'
-                    }
-                }
-            ]
-        }
-    ]);
 const featureColumn = (id, title, body)=>({
         id,
         componentId: 'muiStack',
@@ -245,111 +142,6 @@ const contactForm = (prefix)=>({
             }
         ]
     });
-const commerceBlock = (id, componentId, props)=>({
-        id,
-        componentId,
-        pluginId: 'commerce',
-        props
-    });
-/** Shared screens for the shop starters (AGL-300). */ function shopScreens(prefix, digital) {
-    return [
-        {
-            key: 'home',
-            displayName: 'Home',
-            // The site root, spelled the way the routing map spells it. `''` here
-            // read as "no address" everywhere downstream and put the shop's home
-            // page at `/home` (AGL-1575).
-            slug: SCREEN_ROOT_PATH,
-            seo: {
-                title: digital ? 'Digital shop' : 'Shop',
-                description: 'Browse our products.'
-            },
-            nodes: buildNodes([
-                heroSection(`${prefix}h_`, digital ? 'Downloads that level you up' : 'Gear you can trust', digital ? 'Instant delivery. Lifetime updates.' : 'Quality parts, shipped fast.'),
-                section(`${prefix}h_gridSection`, 'xl', 6, [
-                    commerceBlock(`${prefix}h_grid`, 'product-grid', {
-                        source: 'all',
-                        sort: 'newest',
-                        columns: 3,
-                        maxItems: 6
-                    })
-                ]),
-                // A newsletter capture is a short text-led band, not a gallery.
-                section(`${prefix}h_newsSection`, 'md', 6, [
-                    commerceBlock(`${prefix}h_news`, 'newsletter-signup', {
-                        heading: 'Get updates and offers'
-                    })
-                ])
-            ])
-        },
-        {
-            key: 'shop',
-            displayName: 'Shop',
-            slug: 'shop',
-            seo: {
-                title: 'All products'
-            },
-            nodes: buildNodes([
-                section(`${prefix}s_section`, 'xl', 6, [
-                    text(`${prefix}s_title`, 'h3', 'All products'),
-                    commerceBlock(`${prefix}s_grid`, 'product-grid', {
-                        source: 'all',
-                        columns: 4,
-                        showFilters: true
-                    })
-                ])
-            ])
-        },
-        {
-            key: 'product',
-            displayName: 'Product page',
-            slug: 'product',
-            seo: {
-                title: 'Product'
-            },
-            nodes: buildNodes([
-                section(`${prefix}p_section`, 'xl', 6, [
-                    commerceBlock(`${prefix}p_detail`, 'product-detail', {})
-                ])
-            ])
-        },
-        {
-            key: 'cart',
-            displayName: 'Cart',
-            slug: 'cart',
-            seo: {
-                title: 'Your cart'
-            },
-            // LG, the deliberate middle case: a cart is a wide table but it is read
-            // line by line, so a full XL band spreads it further than the eye
-            // tracks. Same for the account screen below.
-            nodes: buildNodes([
-                section(`${prefix}c_section`, 'lg', 6, [
-                    text(`${prefix}c_title`, 'h3', 'Your cart'),
-                    commerceBlock(`${prefix}c_cart`, 'cart', {
-                        variant: 'inline',
-                        showCoupon: true
-                    })
-                ])
-            ])
-        },
-        {
-            key: 'account',
-            displayName: 'Account',
-            slug: 'account',
-            seo: {
-                title: 'Your account'
-            },
-            nodes: buildNodes([
-                section(`${prefix}a_section`, 'lg', 6, [
-                    commerceBlock(`${prefix}a_account`, 'customer-account', {
-                        signedOutHeading: 'Your account'
-                    })
-                ])
-            ])
-        }
-    ];
-}
 /**
  * The home page every new site is born with (AGL-3408).
  *
@@ -399,7 +191,7 @@ const commerceBlock = (id, componentId, props)=>({
         ])
     };
 }
-export const STARTER_TEMPLATES = [
+/** The platform's own starters, which name no plugin's elements. */ const PLATFORM_STARTER_TEMPLATES = [
     {
         id: 'landing',
         displayName: 'Landing Page',
@@ -608,21 +400,18 @@ export const STARTER_TEMPLATES = [
                 ])
             }
         ]
-    },
-    {
-        id: 'physical-shop',
-        displayName: 'Shop (physical products)',
-        description: 'Storefront starter: home with featured products, filterable shop, ' + 'product page, cart, and customer accounts. After applying, set the ' + 'Product page as the product template in Store settings.',
-        category: 'Commerce',
-        screens: shopScreens('ps_', false)
-    },
-    {
-        id: 'digital-shop',
-        displayName: 'Shop (digital products)',
-        description: 'Digital storefront starter: downloads-focused home, shop, product ' + 'page, cart, and accounts with a newsletter capture. Set the Product ' + 'page as the product template in Store settings after applying.',
-        category: 'Commerce',
-        screens: shopScreens('ds_', true)
     }
 ];
+/**
+ * Every starter in this build, in gallery order: the platform's own, then
+ * each plugin's in config order (AGL-3080). A plugin whose elements a starter
+ * is built around — a storefront's product grid and cart — declares it under
+ * `starterTemplates` in plugins.config.json, and the manifest generator
+ * compiles what it returns, so the gallery, the seed route and a model
+ * shown examples all read one list without loading any plugin.
+ */ export const STARTER_TEMPLATES = [
+    ...PLATFORM_STARTER_TEMPLATES,
+    ...PLUGIN_STARTER_TEMPLATES
+];
 
 //# sourceMappingURL=starter-templates.js.map

package/src/lib/app-utils/starter-templates.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/starter-templates.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// Leaf imports only, deliberately (AGL-687). This module is imported from\n// BOTH graphs — the console's client gallery renders virtual starters from\n// it, the console's seed route materializes them, and the AI plugin's server\n// shows them to a model — and neither barrel works in both: the full\n// `@aglyn/aglyn` barrel breaks the RSC/server-route graph, while the server\n// entry drags `node:fs` into the client bundle. The canvas constants are a\n// leaf with no imports of their own, and `screen-route` imports only a TYPE\n// from foundation, so both are safe on either side.\nimport { CANVAS_ROOT_ELEMENT_ID } from '../foundation/constants/canvas'\nimport { normalizeScreenSlug, SCREEN_ROOT_PATH } from './screen-route'\n\n/**\n * First-party starter definitions (AGL-78/79), SEED INPUT (AGL-687).\n *\n * These used to be rendered straight into the gallery and instantiated from\n * code, which made a starter a second kind of template: no version history,\n * no placeholders, no editor, changeable only by shipping a release. Now\n * they are seeded into each host's own template library as ordinary\n * `hosts/{hostId}/templates` documents (see the console's\n * `utils/server/seed-starter-templates.ts` for why copy-on-use rather than a\n * global read-only collection), and nothing reads this file at render time.\n *\n * They are also the page examples the AI plugin's template generator shows a\n * model (AGL-2909), which is why they live in the core package rather than\n * beside the console gallery that renders them.\n *\n * Node ids stay template-local (unique within each screen's version doc);\n * `createPageFromTemplate` re-keys screen and version ids at instantiation.\n *\n * PERSISTED IDENTIFIERS: `StarterTemplate.id`, `StarterTemplateScreen.key`\n * and every node id below appear in stored documents (seeded template doc\n * ids are derived from the first two). They must never be renamed.\n */\nexport interface StarterTemplateScreen {\n  /**\n   * Stable, starter-local key. Part of the seeded document id, so it is a\n   * persisted identifier — never rename one.\n   */\n  key: string\n  displayName: string\n  description?: string\n  /**\n   * Routing-map slug. `SCREEN_ROOT_PATH` (`'/'`) asks for the site root — the\n   * home page — and anything else is a single path segment.\n   *\n   * It used to be `''` that meant home, which no normalizer agreed with: both\n   * the apply path and the seed below read an empty string as \"no address\n   * authored\" and derived one from the display name, so the shop starters'\n   * home page was published at `/home` and the site 404'd at its own URL\n   * (AGL-1575).\n   */\n  slug: string\n  seo?: { title?: string; description?: string }\n  /** Flat node map including the canvas root. */\n  nodes: Record<string, any>\n}\n\nexport interface StarterTemplate {\n  id: string\n  displayName: string\n  description: string\n  category: string\n  screens: StarterTemplateScreen[]\n}\n\n/** A materialized starter template document, keyed by its deterministic id. */\nexport interface StarterTemplateDoc {\n  id: string\n  /** Which starter this page belongs to — lets one starter be selected. */\n  starterId: string\n  data: Record<string, unknown>\n}\n\n/**\n * Deterministic document id for a seeded starter screen (AGL-687).\n *\n * Derived from the starter id and the screen key — never randomly generated\n * — so re-running the seed addresses the same documents instead of stacking\n * duplicate copies of every starter on every run.\n */\nexport function starterTemplateDocId(\n  starterId: string,\n  screenKey: string,\n): string {\n  return `starter-${starterId}-${screenKey}`\n}\n\n/**\n * Expands one starter into the template documents it seeds as.\n *\n * One page template per screen, matching what a marketplace install of a\n * multi-screen site template already produces (AGL-669) — the alternative,\n * a bespoke multi-page template shape, would be a third lifecycle on top of\n * the two this issue exists to merge. The bundle's name/description/order\n * ride `source` so the gallery can still present the starter as one card.\n */\nexport function buildStarterTemplateDocs(\n  starter: StarterTemplate,\n): StarterTemplateDoc[] {\n  return starter.screens.map((screen, index) => {\n    // Normalized on the way into the document so the persisted address is in\n    // the routing-map format the tenant matches against — in particular the\n    // root, which the previous `screen.slug ? …` guard dropped entirely when\n    // home was spelled `''` (AGL-1575). A slug that sanitizes away carries no\n    // field, and the apply path derives one from the display name.\n    const slug = normalizeScreenSlug(screen.slug)\n    return {\n      id: starterTemplateDocId(starter.id, screen.key),\n      starterId: starter.id,\n      data: {\n        kind: 'page',\n        displayName: screen.displayName,\n        // Only the screen's own description, never the starter blurb: a\n        // template's `description` is carried onto the page it creates, and a\n        // screen description is the live site's meta-description fallback.\n        // The bundle blurb lives on `source.starterDescription` instead.\n        ...(screen.description ? { description: screen.description } : {}),\n        category: starter.category,\n        ...(slug ? { slug } : {}),\n        ...(screen.seo ? { seo: screen.seo } : {}),\n        nodes: screen.nodes,\n        source: {\n          type: 'starter',\n          starterId: starter.id,\n          starterName: starter.displayName,\n          starterDescription: starter.description,\n          starterOrder: index,\n        },\n      },\n    }\n  })\n}\n\n/** Every document a starter COULD materialize as, in bundle order. */\nexport function buildAllStarterTemplateDocs(): StarterTemplateDoc[] {\n  return STARTER_TEMPLATES.flatMap(buildStarterTemplateDocs)\n}\n\ntype NodeSpec = {\n  id: string\n  componentId: string\n  /** Bundle owning the component; defaults to 'mui' (AGL-300). */\n  pluginId?: string\n  props?: Record<string, unknown>\n  /**\n   * Node-level styles — a SIBLING of props, never `props.sx` (AGL-1346).\n   *\n   * Both records render (`Leaf` composes `(sx, props.sx, node.sx)`, later\n   * wins), but the Styles panel edits `node.sx`. A starter that seeded its\n   * styling into `props.sx` handed the author a document full of values\n   * the panel could show but no click could change or clear.\n   */\n  sx?: Record<string, unknown>\n  children?: NodeSpec[]\n}\n\n/** Builds the flat, persisted node map from a nested spec. */\nfunction buildNodes(children: NodeSpec[]): Record<string, any> {\n  const map: Record<string, any> = {\n    [CANVAS_ROOT_ELEMENT_ID]: {\n      $id: CANVAS_ROOT_ELEMENT_ID,\n      componentId: 'div',\n      nodes: children.map((child) => child.id),\n    },\n  }\n  const walk = (spec: NodeSpec, parentId: string) => {\n    map[spec.id] = {\n      $id: spec.id,\n      componentId: spec.componentId,\n      pluginId: spec.pluginId ?? 'mui',\n      parentId,\n      props: spec.props ?? {},\n      ...(spec.sx ? { sx: spec.sx } : {}),\n      nodes: (spec.children ?? []).map((child) => child.id),\n    }\n    for (const child of spec.children ?? []) walk(child, spec.id)\n  }\n  for (const child of children) walk(child, CANVAS_ROOT_ELEMENT_ID)\n  return map\n}\n\nconst text = (\n  id: string,\n  variant: string,\n  children: string,\n  extra?: Record<string, unknown>,\n): NodeSpec => ({\n  id,\n  componentId: 'muiTypography',\n  props: { variant, children, ...extra },\n})\n\n/**\n * The stock widths a starter band may be (AGL-1932, AGL-1298).\n *\n * Three cases, and only three, because the standard has three. There is no\n * pixel case: `1328` is a CONTENT width, not a breakpoint, and the ban on\n * bespoke numbers is the half of AGL-1298 these templates used to violate\n * four times over.\n */\ntype SectionWidth = 'md' | 'lg' | 'xl'\n\n/**\n * One page band: a `Container` at a stock width, carrying the band's own\n * vertical rhythm (AGL-1932).\n *\n * The layout standard (AGL-1298): every section is a Container. Full-bleed is\n * the Container's own full-width attribute, never the absence of a Container,\n * and anything else is one of three stock widths. A template that seeds no\n * Container hands every customer a site that starts outside the standard.\n *\n * How the three widths are chosen here, stated so the next audit does not\n * have to guess:\n *\n * - `xl` — a marketing band: hero, feature row, product grid, gallery. The\n *   default width, and what an unremarkable page should be.\n * - `lg` — the deliberate middle case: wide but text-led and interactive.\n *   Cart and account are the honest instances, not decoration.\n * - `md` — long-form prose and narrow form columns, on READING grounds: at\n *   `xl` a paragraph runs 110–120 characters a line. This is the case the\n *   `Prose Container` preset exists for.\n *\n * Horizontal padding is the Container's own gutters, so bands no longer carry\n * horizontal padding at all. Only the vertical rhythm rides here, which is\n * rhythm rather than width.\n *\n * Written as the two longhands rather than MUI's `py` (AGL-2207/2208): the\n * Styles panel's Padding control is named for the four sides, so a band\n * seeded with `py` handed the customer a document whose padding the panel\n * showed as empty and no click could clear.\n */\nconst section = (\n  id: string,\n  maxWidth: SectionWidth,\n  verticalPadding: number,\n  children: NodeSpec[],\n): NodeSpec => ({\n  id,\n  componentId: 'muiContainer',\n  props: { maxWidth },\n  sx: { paddingTop: verticalPadding, paddingBottom: verticalPadding },\n  children,\n})\n\nconst heroSection = (prefix: string, headline: string, tagline: string) =>\n  // The Container is a NEW node (`…heroSection`); `…hero` keeps its id and\n  // stays the Stack. Node ids here are persisted identifiers, so bands are\n  // wrapped rather than re-pointed.\n  section(`${prefix}heroSection`, 'xl', 10, [\n    {\n      id: `${prefix}hero`,\n      componentId: 'muiStack',\n      props: { spacing: 2 },\n      sx: { alignItems: 'center' },\n      children: [\n        text(`${prefix}heroTitle`, 'h2', headline, { align: 'center' }),\n        text(`${prefix}heroSub`, 'h6', tagline, { align: 'center' }),\n        {\n          id: `${prefix}heroCta`,\n          componentId: 'muiButton',\n          props: {\n            variant: 'contained',\n            size: 'large',\n            children: 'Get in touch',\n          },\n        },\n      ],\n    },\n  ])\n\nconst featureColumn = (id: string, title: string, body: string): NodeSpec => ({\n  id,\n  componentId: 'muiStack',\n  props: { spacing: 1 },\n  // `flex: 1` is a column's share of its row, not a width cap — it survives\n  // the sweep deliberately. Only `maxWidth` in raw pixels was the violation.\n  sx: {\n    flex: 1,\n    paddingTop: 2,\n    paddingRight: 2,\n    paddingBottom: 2,\n    paddingLeft: 2,\n  },\n  children: [text(`${id}T`, 'h5', title), text(`${id}B`, 'body1', body)],\n})\n\nconst contactForm = (prefix: string): NodeSpec => ({\n  id: `${prefix}form`,\n  componentId: 'form',\n  props: {\n    formName: 'Contact',\n    submitLabel: 'Send message',\n    successMessage: 'Thanks — we will get back to you soon.',\n  },\n  children: [\n    {\n      id: `${prefix}fName`,\n      componentId: 'formField',\n      props: { fieldName: 'name', label: 'Name', required: true },\n    },\n    {\n      id: `${prefix}fEmail`,\n      componentId: 'formField',\n      props: {\n        fieldName: 'email',\n        label: 'Email',\n        fieldType: 'email',\n        required: true,\n      },\n    },\n    {\n      id: `${prefix}fMessage`,\n      componentId: 'formField',\n      props: {\n        fieldName: 'message',\n        label: 'Message',\n        fieldType: 'textarea',\n        required: true,\n      },\n    },\n  ],\n})\n\n\nconst commerceBlock = (\n  id: string,\n  componentId: string,\n  props?: Record<string, unknown>,\n): NodeSpec => ({ id, componentId, pluginId: 'commerce', props })\n\n/** Shared screens for the shop starters (AGL-300). */\nfunction shopScreens(prefix: string, digital: boolean): StarterTemplateScreen[] {\n  return [\n    {\n      key: 'home',\n      displayName: 'Home',\n      // The site root, spelled the way the routing map spells it. `''` here\n      // read as \"no address\" everywhere downstream and put the shop's home\n      // page at `/home` (AGL-1575).\n      slug: SCREEN_ROOT_PATH,\n      seo: {\n        title: digital ? 'Digital shop' : 'Shop',\n        description: 'Browse our products.',\n      },\n      nodes: buildNodes([\n        heroSection(\n          `${prefix}h_`,\n          digital ? 'Downloads that level you up' : 'Gear you can trust',\n          digital\n            ? 'Instant delivery. Lifetime updates.'\n            : 'Quality parts, shipped fast.',\n        ),\n        section(`${prefix}h_gridSection`, 'xl', 6, [\n          commerceBlock(`${prefix}h_grid`, 'product-grid', {\n            source: 'all',\n            sort: 'newest',\n            columns: 3,\n            maxItems: 6,\n          }),\n        ]),\n        // A newsletter capture is a short text-led band, not a gallery.\n        section(`${prefix}h_newsSection`, 'md', 6, [\n          commerceBlock(`${prefix}h_news`, 'newsletter-signup', {\n            heading: 'Get updates and offers',\n          }),\n        ]),\n      ]),\n    },\n    {\n      key: 'shop',\n      displayName: 'Shop',\n      slug: 'shop',\n      seo: { title: 'All products' },\n      nodes: buildNodes([\n        section(`${prefix}s_section`, 'xl', 6, [\n          text(`${prefix}s_title`, 'h3', 'All products'),\n          commerceBlock(`${prefix}s_grid`, 'product-grid', {\n            source: 'all',\n            columns: 4,\n            showFilters: true,\n          }),\n        ]),\n      ]),\n    },\n    {\n      key: 'product',\n      displayName: 'Product page',\n      slug: 'product',\n      seo: { title: 'Product' },\n      nodes: buildNodes([\n        section(`${prefix}p_section`, 'xl', 6, [\n          commerceBlock(`${prefix}p_detail`, 'product-detail', {}),\n        ]),\n      ]),\n    },\n    {\n      key: 'cart',\n      displayName: 'Cart',\n      slug: 'cart',\n      seo: { title: 'Your cart' },\n      // LG, the deliberate middle case: a cart is a wide table but it is read\n      // line by line, so a full XL band spreads it further than the eye\n      // tracks. Same for the account screen below.\n      nodes: buildNodes([\n        section(`${prefix}c_section`, 'lg', 6, [\n          text(`${prefix}c_title`, 'h3', 'Your cart'),\n          commerceBlock(`${prefix}c_cart`, 'cart', {\n            variant: 'inline',\n            showCoupon: true,\n          }),\n        ]),\n      ]),\n    },\n    {\n      key: 'account',\n      displayName: 'Account',\n      slug: 'account',\n      seo: { title: 'Your account' },\n      nodes: buildNodes([\n        section(`${prefix}a_section`, 'lg', 6, [\n          commerceBlock(`${prefix}a_account`, 'customer-account', {\n            signedOutHeading: 'Your account',\n          }),\n        ]),\n      ]),\n    },\n  ]\n}\n\n/**\n * The home page every new site is born with (AGL-3408).\n *\n * A site used to be created with an empty routing map, so the address the\n * create dialog calls live answered with the tenant's 404 until somebody\n * built and published a page. `claimHostForOrg` now writes this screen, its\n * first version and its `/` route in the same transaction that creates the\n * host, which makes \"a site with no home page\" a state no new site starts in.\n *\n * It is PUBLIC from the first request, so the copy speaks to a visitor, never\n * to the owner — no \"edit this in the besigner\". The site's name is written in\n * as text, not bound: there is no page-content token for it, and a heading\n * that followed a rename is not worth one.\n *\n * Deliberately not a starter: it is not offered in the gallery, and applying a\n * starter may take the root back from it (see `defaultHomeScreenId`).\n *\n * PERSISTED IDENTIFIERS: every node id below is stored on every new site.\n */\nexport function buildDefaultHomeScreen(siteName: string): StarterTemplateScreen {\n  const name = siteName.trim() || 'Welcome'\n  return {\n    key: 'home',\n    displayName: 'Home',\n    slug: SCREEN_ROOT_PATH,\n    nodes: buildNodes([\n      section('dh_heroSection', 'md', 12, [\n        {\n          id: 'dh_hero',\n          componentId: 'muiStack',\n          props: { spacing: 2 },\n          sx: { alignItems: 'center' },\n          children: [\n            text('dh_heroTitle', 'h2', name, { align: 'center' }),\n            text(\n              'dh_heroSub',\n              'h6',\n              'Welcome — our new website is on its way.',\n              { align: 'center', color: 'text.secondary' },\n            ),\n          ],\n        },\n      ]),\n    ]),\n  }\n}\n\nexport const STARTER_TEMPLATES: StarterTemplate[] = [\n  {\n    id: 'landing',\n    displayName: 'Landing Page',\n    description:\n      'One-page launch site: hero, three selling points, and a contact form.',\n    category: 'Marketing',\n    screens: [\n      {\n        key: 'landing',\n        displayName: 'Landing',\n        slug: 'landing',\n        seo: {\n          title: 'Welcome',\n          description: 'Everything you need to know, on one page.',\n        },\n        nodes: buildNodes([\n          heroSection(\n            'l_',\n            'A headline that sells your idea',\n            'One clear sentence about the value you deliver.',\n          ),\n          section('l_featuresSection', 'xl', 6, [\n            {\n              id: 'l_features',\n              componentId: 'muiStack',\n              props: { direction: 'row', spacing: 2 },\n              children: [\n                featureColumn(\n                  'l_f1',\n                  'Fast',\n                  'Explain the first reason customers pick you.',\n                ),\n                featureColumn(\n                  'l_f2',\n                  'Simple',\n                  'Explain the second reason customers pick you.',\n                ),\n                featureColumn(\n                  'l_f3',\n                  'Reliable',\n                  'Explain the third reason customers pick you.',\n                ),\n              ],\n            },\n          ]),\n          // Was `maxWidth: 560`. A band, not an inner measure: it sat at the\n          // top level carrying the section's own gutters and rhythm, so the\n          // pixel value was capping the BAND. MD is the stock width for a\n          // narrow, form-led column.\n          section('l_contactSection', 'md', 6, [\n            {\n              id: 'l_contact',\n              componentId: 'muiStack',\n              props: { spacing: 2 },\n              children: [\n                text('l_contactTitle', 'h4', 'Get in touch'),\n                contactForm('l_'),\n              ],\n            },\n          ]),\n        ]),\n      },\n    ],\n  },\n  {\n    id: 'business',\n    displayName: 'Business',\n    description:\n      'Company site: home with services, an about page, and a contact page.',\n    category: 'Business',\n    screens: [\n      {\n        key: 'home',\n        displayName: 'Business Home',\n        slug: 'home',\n        seo: { title: 'Home' },\n        nodes: buildNodes([\n          heroSection(\n            'b_',\n            'Your business, done right',\n            'Tell visitors what you do and who you do it for.',\n          ),\n          section('b_servicesSection', 'xl', 6, [\n            {\n              id: 'b_services',\n              componentId: 'muiStack',\n              props: { direction: 'row', spacing: 2 },\n              children: [\n                featureColumn('b_s1', 'Service one', 'Describe this service.'),\n                featureColumn('b_s2', 'Service two', 'Describe this service.'),\n                featureColumn(\n                  'b_s3',\n                  'Service three',\n                  'Describe this service.',\n                ),\n              ],\n            },\n          ]),\n        ]),\n      },\n      {\n        key: 'about-us',\n        displayName: 'About Us',\n        slug: 'about-us',\n        seo: { title: 'About us' },\n        nodes: buildNodes([\n          // Was `maxWidth: 720` — the one unambiguous PROSE band in the set,\n          // and the case the Prose Container preset exists for. MD (900px)\n          // lands near the 65–75 characters a line that reads comfortably.\n          section('a_wrapSection', 'md', 8, [\n            {\n              id: 'a_wrap',\n              componentId: 'muiStack',\n              props: { spacing: 2 },\n              children: [\n                text('a_title', 'h3', 'About us'),\n                text(\n                  'a_body',\n                  'body1',\n                  'Share your story: how you started, what you believe, and ' +\n                    'why customers trust you.',\n                ),\n              ],\n            },\n          ]),\n        ]),\n      },\n      {\n        key: 'contact-us',\n        displayName: 'Contact Us',\n        slug: 'contact-us',\n        seo: { title: 'Contact' },\n        nodes: buildNodes([\n          // Was `maxWidth: 560`. Same reading as the landing page's contact\n          // band: text plus a form column, so MD.\n          section('c_wrapSection', 'md', 8, [\n            {\n              id: 'c_wrap',\n              componentId: 'muiStack',\n              props: { spacing: 2 },\n              children: [\n                text('c_title', 'h3', 'Contact us'),\n                text(\n                  'c_body',\n                  'body1',\n                  'Questions or quotes — send a message and we reply within ' +\n                    'one business day.',\n                ),\n                contactForm('c_'),\n              ],\n            },\n          ]),\n        ]),\n      },\n    ],\n  },\n  {\n    id: 'portfolio',\n    displayName: 'Portfolio',\n    description: 'Personal portfolio: intro, work grid, and contact form.',\n    category: 'Personal',\n    screens: [\n      {\n        key: 'portfolio',\n        displayName: 'Portfolio',\n        slug: 'portfolio',\n        seo: { title: 'Portfolio' },\n        nodes: buildNodes([\n          heroSection(\n            'p_',\n            'Hi, I make things',\n            'Designer / developer / photographer — introduce yourself here.',\n          ),\n          section('p_gridSection', 'xl', 6, [\n            {\n              id: 'p_grid',\n              componentId: 'muiStack',\n              props: { direction: 'row', spacing: 2 },\n              children: [\n                {\n                  id: 'p_img1',\n                  componentId: 'image',\n                  // `height` is an image's own intrinsic sizing prop, not a\n                  // band cap — out of scope for the container standard.\n                  props: { alt: 'Project one', height: '220px' },\n                },\n                {\n                  id: 'p_img2',\n                  componentId: 'image',\n                  props: { alt: 'Project two', height: '220px' },\n                },\n                {\n                  id: 'p_img3',\n                  componentId: 'image',\n                  props: { alt: 'Project three', height: '220px' },\n                },\n              ],\n            },\n          ]),\n          // Was `maxWidth: 560`, the third of the three contact bands.\n          section('p_contactSection', 'md', 6, [\n            {\n              id: 'p_contact',\n              componentId: 'muiStack',\n              props: { spacing: 2 },\n              children: [\n                text('p_contactTitle', 'h4', 'Work with me'),\n                contactForm('p_'),\n              ],\n            },\n          ]),\n        ]),\n      },\n    ],\n  },\n  {\n    id: 'physical-shop',\n    displayName: 'Shop (physical products)',\n    description:\n      'Storefront starter: home with featured products, filterable shop, ' +\n      'product page, cart, and customer accounts. After applying, set the ' +\n      'Product page as the product template in Store settings.',\n    category: 'Commerce',\n    screens: shopScreens('ps_', false),\n  },\n  {\n    id: 'digital-shop',\n    displayName: 'Shop (digital products)',\n    description:\n      'Digital storefront starter: downloads-focused home, shop, product ' +\n      'page, cart, and accounts with a newsletter capture. Set the Product ' +\n      'page as the product template in Store settings after applying.',\n    category: 'Commerce',\n    screens: shopScreens('ds_', true),\n  },\n]\n"],"names":["CANVAS_ROOT_ELEMENT_ID","normalizeScreenSlug","SCREEN_ROOT_PATH","starterTemplateDocId","starterId","screenKey","buildStarterTemplateDocs","starter","screens","map","screen","index","slug","id","key","data","kind","displayName","description","category","seo","nodes","source","type","starterName","starterDescription","starterOrder","buildAllStarterTemplateDocs","STARTER_TEMPLATES","flatMap","buildNodes","children","$id","componentId","child","walk","spec","parentId","pluginId","props","sx","text","variant","extra","section","maxWidth","verticalPadding","paddingTop","paddingBottom","heroSection","prefix","headline","tagline","spacing","alignItems","align","size","featureColumn","title","body","flex","paddingRight","paddingLeft","contactForm","formName","submitLabel","successMessage","fieldName","label","required","fieldType","commerceBlock","shopScreens","digital","sort","columns","maxItems","heading","showFilters","showCoupon","signedOutHeading","buildDefaultHomeScreen","siteName","name","trim","color","direction","alt","height"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/starter-templates.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// Leaf imports only, deliberately (AGL-687). This module is imported from\n// BOTH graphs — the console's client gallery renders virtual starters from\n// it, the console's seed route materializes them, and the AI plugin's server\n// shows them to a model — and neither barrel works in both: the full\n// `@aglyn/aglyn` barrel breaks the RSC/server-route graph, while the server\n// entry drags `node:fs` into the client bundle. The starter kit imports only\n// the canvas constants, a leaf with no imports of their own; the compiled\n// plugin starters are data behind a type-only import; and `screen-route`\n// imports only a TYPE from foundation — so all three are safe on either side.\nimport { PLUGIN_STARTER_TEMPLATES } from './plugin-starter-templates.generated'\nimport { normalizeScreenSlug, SCREEN_ROOT_PATH } from './screen-route'\nimport {\n  buildStarterNodes as buildNodes,\n  starterHeroSection as heroSection,\n  starterSection as section,\n  starterText as text,\n  type StarterNodeSpec as NodeSpec,\n  type StarterTemplate,\n  type StarterTemplateScreen,\n} from './starter-template-nodes'\n\nexport type {\n  StarterNodeSpec,\n  StarterSectionWidth,\n  StarterTemplate,\n  StarterTemplateScreen,\n} from './starter-template-nodes'\nexport {\n  buildStarterNodes,\n  starterHeroSection,\n  starterSection,\n  starterText,\n} from './starter-template-nodes'\n\n/**\n * First-party starter definitions (AGL-78/79), SEED INPUT (AGL-687).\n *\n * These used to be rendered straight into the gallery and instantiated from\n * code, which made a starter a second kind of template: no version history,\n * no placeholders, no editor, changeable only by shipping a release. Now\n * they are seeded into each host's own template library as ordinary\n * `hosts/{hostId}/templates` documents (see the console's\n * `utils/server/seed-starter-templates.ts` for why copy-on-use rather than a\n * global read-only collection), and nothing reads this file at render time.\n *\n * They are also the page examples the AI plugin's template generator shows a\n * model (AGL-2909), which is why they live in the core package rather than\n * beside the console gallery that renders them.\n *\n * Node ids stay template-local (unique within each screen's version doc);\n * `createPageFromTemplate` re-keys screen and version ids at instantiation.\n *\n * PERSISTED IDENTIFIERS: `StarterTemplate.id`, `StarterTemplateScreen.key`\n * and every node id below appear in stored documents (seeded template doc\n * ids are derived from the first two). They must never be renamed.\n */\nexport interface StarterTemplateDoc {\n  id: string\n  /** Which starter this page belongs to — lets one starter be selected. */\n  starterId: string\n  data: Record<string, unknown>\n}\n\n/**\n * Deterministic document id for a seeded starter screen (AGL-687).\n *\n * Derived from the starter id and the screen key — never randomly generated\n * — so re-running the seed addresses the same documents instead of stacking\n * duplicate copies of every starter on every run.\n */\nexport function starterTemplateDocId(\n  starterId: string,\n  screenKey: string,\n): string {\n  return `starter-${starterId}-${screenKey}`\n}\n\n/**\n * Expands one starter into the template documents it seeds as.\n *\n * One page template per screen, matching what a marketplace install of a\n * multi-screen site template already produces (AGL-669) — the alternative,\n * a bespoke multi-page template shape, would be a third lifecycle on top of\n * the two this issue exists to merge. The bundle's name/description/order\n * ride `source` so the gallery can still present the starter as one card.\n */\nexport function buildStarterTemplateDocs(\n  starter: StarterTemplate,\n): StarterTemplateDoc[] {\n  return starter.screens.map((screen, index) => {\n    // Normalized on the way into the document so the persisted address is in\n    // the routing-map format the tenant matches against — in particular the\n    // root, which the previous `screen.slug ? …` guard dropped entirely when\n    // home was spelled `''` (AGL-1575). A slug that sanitizes away carries no\n    // field, and the apply path derives one from the display name.\n    const slug = normalizeScreenSlug(screen.slug)\n    return {\n      id: starterTemplateDocId(starter.id, screen.key),\n      starterId: starter.id,\n      data: {\n        kind: 'page',\n        displayName: screen.displayName,\n        // Only the screen's own description, never the starter blurb: a\n        // template's `description` is carried onto the page it creates, and a\n        // screen description is the live site's meta-description fallback.\n        // The bundle blurb lives on `source.starterDescription` instead.\n        ...(screen.description ? { description: screen.description } : {}),\n        category: starter.category,\n        ...(slug ? { slug } : {}),\n        ...(screen.seo ? { seo: screen.seo } : {}),\n        nodes: screen.nodes,\n        source: {\n          type: 'starter',\n          starterId: starter.id,\n          starterName: starter.displayName,\n          starterDescription: starter.description,\n          starterOrder: index,\n        },\n      },\n    }\n  })\n}\n\n/** Every document a starter COULD materialize as, in bundle order. */\nexport function buildAllStarterTemplateDocs(): StarterTemplateDoc[] {\n  return STARTER_TEMPLATES.flatMap(buildStarterTemplateDocs)\n}\n\nconst featureColumn = (id: string, title: string, body: string): NodeSpec => ({\n  id,\n  componentId: 'muiStack',\n  props: { spacing: 1 },\n  // `flex: 1` is a column's share of its row, not a width cap — it survives\n  // the sweep deliberately. Only `maxWidth` in raw pixels was the violation.\n  sx: {\n    flex: 1,\n    paddingTop: 2,\n    paddingRight: 2,\n    paddingBottom: 2,\n    paddingLeft: 2,\n  },\n  children: [text(`${id}T`, 'h5', title), text(`${id}B`, 'body1', body)],\n})\n\nconst contactForm = (prefix: string): NodeSpec => ({\n  id: `${prefix}form`,\n  componentId: 'form',\n  props: {\n    formName: 'Contact',\n    submitLabel: 'Send message',\n    successMessage: 'Thanks — we will get back to you soon.',\n  },\n  children: [\n    {\n      id: `${prefix}fName`,\n      componentId: 'formField',\n      props: { fieldName: 'name', label: 'Name', required: true },\n    },\n    {\n      id: `${prefix}fEmail`,\n      componentId: 'formField',\n      props: {\n        fieldName: 'email',\n        label: 'Email',\n        fieldType: 'email',\n        required: true,\n      },\n    },\n    {\n      id: `${prefix}fMessage`,\n      componentId: 'formField',\n      props: {\n        fieldName: 'message',\n        label: 'Message',\n        fieldType: 'textarea',\n        required: true,\n      },\n    },\n  ],\n})\n\n\n/**\n * The home page every new site is born with (AGL-3408).\n *\n * A site used to be created with an empty routing map, so the address the\n * create dialog calls live answered with the tenant's 404 until somebody\n * built and published a page. `claimHostForOrg` now writes this screen, its\n * first version and its `/` route in the same transaction that creates the\n * host, which makes \"a site with no home page\" a state no new site starts in.\n *\n * It is PUBLIC from the first request, so the copy speaks to a visitor, never\n * to the owner — no \"edit this in the besigner\". The site's name is written in\n * as text, not bound: there is no page-content token for it, and a heading\n * that followed a rename is not worth one.\n *\n * Deliberately not a starter: it is not offered in the gallery, and applying a\n * starter may take the root back from it (see `defaultHomeScreenId`).\n *\n * PERSISTED IDENTIFIERS: every node id below is stored on every new site.\n */\nexport function buildDefaultHomeScreen(siteName: string): StarterTemplateScreen {\n  const name = siteName.trim() || 'Welcome'\n  return {\n    key: 'home',\n    displayName: 'Home',\n    slug: SCREEN_ROOT_PATH,\n    nodes: buildNodes([\n      section('dh_heroSection', 'md', 12, [\n        {\n          id: 'dh_hero',\n          componentId: 'muiStack',\n          props: { spacing: 2 },\n          sx: { alignItems: 'center' },\n          children: [\n            text('dh_heroTitle', 'h2', name, { align: 'center' }),\n            text(\n              'dh_heroSub',\n              'h6',\n              'Welcome — our new website is on its way.',\n              { align: 'center', color: 'text.secondary' },\n            ),\n          ],\n        },\n      ]),\n    ]),\n  }\n}\n\n/** The platform's own starters, which name no plugin's elements. */\nconst PLATFORM_STARTER_TEMPLATES: StarterTemplate[] = [\n  {\n    id: 'landing',\n    displayName: 'Landing Page',\n    description:\n      'One-page launch site: hero, three selling points, and a contact form.',\n    category: 'Marketing',\n    screens: [\n      {\n        key: 'landing',\n        displayName: 'Landing',\n        slug: 'landing',\n        seo: {\n          title: 'Welcome',\n          description: 'Everything you need to know, on one page.',\n        },\n        nodes: buildNodes([\n          heroSection(\n            'l_',\n            'A headline that sells your idea',\n            'One clear sentence about the value you deliver.',\n          ),\n          section('l_featuresSection', 'xl', 6, [\n            {\n              id: 'l_features',\n              componentId: 'muiStack',\n              props: { direction: 'row', spacing: 2 },\n              children: [\n                featureColumn(\n                  'l_f1',\n                  'Fast',\n                  'Explain the first reason customers pick you.',\n                ),\n                featureColumn(\n                  'l_f2',\n                  'Simple',\n                  'Explain the second reason customers pick you.',\n                ),\n                featureColumn(\n                  'l_f3',\n                  'Reliable',\n                  'Explain the third reason customers pick you.',\n                ),\n              ],\n            },\n          ]),\n          // Was `maxWidth: 560`. A band, not an inner measure: it sat at the\n          // top level carrying the section's own gutters and rhythm, so the\n          // pixel value was capping the BAND. MD is the stock width for a\n          // narrow, form-led column.\n          section('l_contactSection', 'md', 6, [\n            {\n              id: 'l_contact',\n              componentId: 'muiStack',\n              props: { spacing: 2 },\n              children: [\n                text('l_contactTitle', 'h4', 'Get in touch'),\n                contactForm('l_'),\n              ],\n            },\n          ]),\n        ]),\n      },\n    ],\n  },\n  {\n    id: 'business',\n    displayName: 'Business',\n    description:\n      'Company site: home with services, an about page, and a contact page.',\n    category: 'Business',\n    screens: [\n      {\n        key: 'home',\n        displayName: 'Business Home',\n        slug: 'home',\n        seo: { title: 'Home' },\n        nodes: buildNodes([\n          heroSection(\n            'b_',\n            'Your business, done right',\n            'Tell visitors what you do and who you do it for.',\n          ),\n          section('b_servicesSection', 'xl', 6, [\n            {\n              id: 'b_services',\n              componentId: 'muiStack',\n              props: { direction: 'row', spacing: 2 },\n              children: [\n                featureColumn('b_s1', 'Service one', 'Describe this service.'),\n                featureColumn('b_s2', 'Service two', 'Describe this service.'),\n                featureColumn(\n                  'b_s3',\n                  'Service three',\n                  'Describe this service.',\n                ),\n              ],\n            },\n          ]),\n        ]),\n      },\n      {\n        key: 'about-us',\n        displayName: 'About Us',\n        slug: 'about-us',\n        seo: { title: 'About us' },\n        nodes: buildNodes([\n          // Was `maxWidth: 720` — the one unambiguous PROSE band in the set,\n          // and the case the Prose Container preset exists for. MD (900px)\n          // lands near the 65–75 characters a line that reads comfortably.\n          section('a_wrapSection', 'md', 8, [\n            {\n              id: 'a_wrap',\n              componentId: 'muiStack',\n              props: { spacing: 2 },\n              children: [\n                text('a_title', 'h3', 'About us'),\n                text(\n                  'a_body',\n                  'body1',\n                  'Share your story: how you started, what you believe, and ' +\n                    'why customers trust you.',\n                ),\n              ],\n            },\n          ]),\n        ]),\n      },\n      {\n        key: 'contact-us',\n        displayName: 'Contact Us',\n        slug: 'contact-us',\n        seo: { title: 'Contact' },\n        nodes: buildNodes([\n          // Was `maxWidth: 560`. Same reading as the landing page's contact\n          // band: text plus a form column, so MD.\n          section('c_wrapSection', 'md', 8, [\n            {\n              id: 'c_wrap',\n              componentId: 'muiStack',\n              props: { spacing: 2 },\n              children: [\n                text('c_title', 'h3', 'Contact us'),\n                text(\n                  'c_body',\n                  'body1',\n                  'Questions or quotes — send a message and we reply within ' +\n                    'one business day.',\n                ),\n                contactForm('c_'),\n              ],\n            },\n          ]),\n        ]),\n      },\n    ],\n  },\n  {\n    id: 'portfolio',\n    displayName: 'Portfolio',\n    description: 'Personal portfolio: intro, work grid, and contact form.',\n    category: 'Personal',\n    screens: [\n      {\n        key: 'portfolio',\n        displayName: 'Portfolio',\n        slug: 'portfolio',\n        seo: { title: 'Portfolio' },\n        nodes: buildNodes([\n          heroSection(\n            'p_',\n            'Hi, I make things',\n            'Designer / developer / photographer — introduce yourself here.',\n          ),\n          section('p_gridSection', 'xl', 6, [\n            {\n              id: 'p_grid',\n              componentId: 'muiStack',\n              props: { direction: 'row', spacing: 2 },\n              children: [\n                {\n                  id: 'p_img1',\n                  componentId: 'image',\n                  // `height` is an image's own intrinsic sizing prop, not a\n                  // band cap — out of scope for the container standard.\n                  props: { alt: 'Project one', height: '220px' },\n                },\n                {\n                  id: 'p_img2',\n                  componentId: 'image',\n                  props: { alt: 'Project two', height: '220px' },\n                },\n                {\n                  id: 'p_img3',\n                  componentId: 'image',\n                  props: { alt: 'Project three', height: '220px' },\n                },\n              ],\n            },\n          ]),\n          // Was `maxWidth: 560`, the third of the three contact bands.\n          section('p_contactSection', 'md', 6, [\n            {\n              id: 'p_contact',\n              componentId: 'muiStack',\n              props: { spacing: 2 },\n              children: [\n                text('p_contactTitle', 'h4', 'Work with me'),\n                contactForm('p_'),\n              ],\n            },\n          ]),\n        ]),\n      },\n    ],\n  },\n]\n\n/**\n * Every starter in this build, in gallery order: the platform's own, then\n * each plugin's in config order (AGL-3080). A plugin whose elements a starter\n * is built around — a storefront's product grid and cart — declares it under\n * `starterTemplates` in plugins.config.json, and the manifest generator\n * compiles what it returns, so the gallery, the seed route and a model\n * shown examples all read one list without loading any plugin.\n */\nexport const STARTER_TEMPLATES: StarterTemplate[] = [\n  ...PLATFORM_STARTER_TEMPLATES,\n  ...PLUGIN_STARTER_TEMPLATES,\n]\n"],"names":["PLUGIN_STARTER_TEMPLATES","normalizeScreenSlug","SCREEN_ROOT_PATH","buildStarterNodes","buildNodes","starterHeroSection","heroSection","starterSection","section","starterText","text","starterTemplateDocId","starterId","screenKey","buildStarterTemplateDocs","starter","screens","map","screen","index","slug","id","key","data","kind","displayName","description","category","seo","nodes","source","type","starterName","starterDescription","starterOrder","buildAllStarterTemplateDocs","STARTER_TEMPLATES","flatMap","featureColumn","title","body","componentId","props","spacing","sx","flex","paddingTop","paddingRight","paddingBottom","paddingLeft","children","contactForm","prefix","formName","submitLabel","successMessage","fieldName","label","required","fieldType","buildDefaultHomeScreen","siteName","name","trim","alignItems","align","color","PLATFORM_STARTER_TEMPLATES","direction","alt","height"],"mappings":"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"}

package/src/lib/app-utils/{email-topics.d.ts → subscription-topics.d.ts}

@@ -15,12 +15,21 @@
  * limitations under the License.
  */
 /**
- * EMAIL TOPICS — the streams a recipient can leave one at a time.
+ * SUBSCRIPTION TOPICS — the streams a recipient can leave one at a time.
+ *
+ * The mail rail's per-stream consent: every marketing-purpose message names
+ * the stream it belongs to, its unsubscribe link carries that stream, and the
+ * send path refuses a recipient who left it. That obligation is owed on every
+ * such message whichever plugin sends it — a campaign, a newsletter, a
+ * restock alert, an automation, the operator's own product updates — so the
+ * state and the policy are the platform's. What a plugin brings is the
+ * STREAMS it sends under, which it declares (`plugins.config.json` →
+ * `subscriptionTopics`, compiled into {@link DECLARED_SUBSCRIPTION_TOPICS}).
  *
  * ## The gap this closes
  *
  * `docs/specs/email-competitive-gaps.md` §1f records the only row in that
- * table where every competitor has something and we have nothing: "Preference
+ * table where every competitor has something and we had nothing: "Preference
  * center / subscription topics — unsubscribe is all-or-nothing per site".
  * A recipient who wanted the newsletter but not the sales mail had exactly one
  * lever, and pulling it took the newsletter too. The lever people reach for
@@ -29,12 +38,11 @@
  *
  * ## Scope: definitions are ORG-shared, opt-outs are PER-SITE
  *
- * The topic CATALOG lives at `orgs/{orgId}/emailTopics`, which is where
- * `lists` live (AGL-254) and for the same reason: a topic is authored
- * editorial content — a name and a sentence of description — that an agency
- * writes once and points several sites at. Following `lists` also means the
- * console surface that manages topics inherits a scoping question that has
- * already been answered, rather than inventing a second answer.
+ * The topic CATALOG an org authors — renaming, re-describing, archiving a
+ * built-in stream, adding its own — is stored by the plugin that manages it,
+ * under the organization, where lists live and for the same reason: a topic is
+ * authored editorial content that an agency writes once and points several
+ * sites at.
  *
  * A recipient's OPT-OUT is per site, at `hosts/{hostId}/topicOptOuts`. It sits
  * beside `hosts/{hostId}/suppressions`, which is per site, and it answers the
@@ -45,19 +53,18 @@
  * the unauthenticated preference page honest — the signed link names a host
  * and nothing else, so a per-site read is exactly what the link authorizes.
  *
- * ## Why the defaults are code and not seeded documents
+ * ## Why the built-ins are declared and not seeded documents
  *
- * Every tenant that exists today has an empty `emailTopics` collection. A
- * seeding migration would have to run against every org, would leave any org
+ * A seeding migration would have to run against every org, would leave any org
  * created while it was mid-flight with none, and — like every backfill — is a
- * thing that gets written and then not run. So {@link DEFAULT_EMAIL_TOPICS} is
- * the floor of the catalog rather than its initial contents: it is present for
- * every org from the moment this ships, with no write anywhere, and a stored
- * document at the same id renames, re-describes or archives one. The catalog a
- * reader sees is {@link mergeEmailTopics} of the two.
+ * thing that gets written and then not run. So the declared streams are the
+ * floor of the catalog rather than its initial contents: present for every
+ * org from the moment a plugin declares one, with no write anywhere, and a
+ * stored document at the same id renames, re-describes or archives one. The
+ * catalog a reader sees is {@link mergeSubscriptionTopics} of the two.
  */
 /** One subscribable stream. */
-export interface EmailTopic {
+export interface SubscriptionTopic {
     /**
      * The stored id. Rides in the unsubscribe link's `tid` and is covered by
      * its signature, so it is treated as persisted — rename the {@link name},
@@ -157,7 +164,7 @@ export declare const DOUBLE_OPT_IN_EXPIRY_MS: number;
  * stored on a topic is a real answer and not an absence, which is what lets a
  * merchant confirm everything except their order-related stream.
  */
-export declare function topicRequiresDoubleOptIn(topic: Pick<EmailTopic, 'doubleOptIn'> | null | undefined, siteDefault?: boolean): boolean;
+export declare function topicRequiresDoubleOptIn(topic: Pick<SubscriptionTopic, 'doubleOptIn'> | null | undefined, siteDefault?: boolean): boolean;
 /** What one person's record says about one stream on one site. */
 export type TopicSubscriptionState = 
 /** They may be mailed about this. */
@@ -210,37 +217,46 @@ export declare function readTopicSubscriptionState(entry: TopicSubscriptionEntry
  * and collapsing them is how an expiry comes to admit somebody.
  */
 export declare function doubleOptInExpired(pendingAtMs: number | null | undefined, nowMs: number): boolean;
-/** `orgs/{orgId}/emailTopics` — the catalog, org-shared like `lists`. */
-export declare const EMAIL_TOPICS_COLLECTION = "emailTopics";
 /** `hosts/{hostId}/topicOptOuts/{emailKey}` — one document per recipient. */
 export declare const TOPIC_OPT_OUTS_SUBCOLLECTION = "topicOptOuts";
-/** Sales, discounts, seasonal campaigns — and the cart a shopper left. */
-export declare const EMAIL_TOPIC_MARKETING = "marketing";
-/** Regular news and stories, including a site's posts to its members. */
-export declare const EMAIL_TOPIC_NEWSLETTER = "newsletter";
-/** New products, restocks, and changes to what a site offers. */
-export declare const EMAIL_TOPIC_PRODUCT_UPDATES = "product-updates";
-/** One person here writing to another about working together. */
-export declare const EMAIL_TOPIC_SALES = "sales";
+/** One stream a plugin declares, as compiled from `plugins.config.json`. */
+export interface DeclaredSubscriptionTopic {
+    /** The plugin that sends under it. */
+    pluginId: string;
+    /**
+     * A wire value: a Firestore path component and a colon-joined component of
+     * the unsubscribe link's signed subject. Changing one orphans every opt-out
+     * already recorded against it.
+     */
+    id: string;
+    name: string;
+    description: string;
+    /** Its place on the preference page. */
+    order: number;
+    /** The stream a message belongs to when it names none. */
+    default?: true;
+}
 /**
- * The catalog every org has before anyone opens the console.
- *
- * Four, not twelve. A preference page whose value is "leave one stream without
- * leaving all of them" stops working the moment the list is long enough that
- * reading it is a chore, and a merchant who needs a fifth can add one. The ids
- * are the generic names an unsubscribing recipient can recognize without
- * knowing anything about the sender's internal vocabulary.
+ * The catalog every org has before anyone opens the console: the streams the
+ * plugins declare, in preference-page order.
+ *
+ * A handful, not a dozen. A preference page whose value is "leave one stream
+ * without leaving all of them" stops working the moment the list is long
+ * enough that reading it is a chore, and a merchant who needs another can add
+ * one. The ids are the generic names an unsubscribing recipient can recognize
+ * without knowing anything about the sender's internal vocabulary.
  */
-export declare const DEFAULT_EMAIL_TOPICS: readonly EmailTopic[];
+export declare const DECLARED_SUBSCRIPTION_TOPICS: readonly SubscriptionTopic[];
 /**
- * The topic a campaign carries when its author picked none.
+ * The stream a message belongs to when its author picked none: the one a
+ * plugin declares `default`, or `''` when none does.
  *
- * Every campaign resolves to SOME topic, because a campaign with no topic
- * would mint an unsubscribe link the preference page cannot place — it could
- * offer the catalog but not say which entry this message was, which is the one
- * thing the recipient came to the page knowing.
+ * Every campaign resolves to SOME topic while one is declared, because a
+ * campaign with no topic would mint an unsubscribe link the preference page
+ * cannot place — it could offer the catalog but not say which entry this
+ * message was, which is the one thing the recipient came to the page knowing.
  */
-export declare const DEFAULT_CAMPAIGN_TOPIC_ID = "marketing";
+export declare const DEFAULT_SUBSCRIPTION_TOPIC_ID: string;
 /**
  * WHICH STREAM AN AUTOMATED EMAIL BELONGS TO — the one answer, named once.
  *
@@ -259,7 +275,7 @@ export declare const DEFAULT_CAMPAIGN_TOPIC_ID = "marketing";
  *          which is not "the default topic", and must not be signed into a
  *          link as one.
  */
-export declare function flowEmailTopicId(topicId: string | null | undefined, scope?: 'scheduled' | 'immediate'): string;
+export declare function flowSubscriptionTopicId(topicId: string | null | undefined, scope?: 'scheduled' | 'immediate'): string;
 /**
  * Whether `value` may be a topic id.
  *
@@ -270,9 +286,9 @@ export declare function flowEmailTopicId(topicId: string | null | undefined, sco
  * parameter tuples. See `signatureMatches` in the email plugin's
  * `unsubscribe-link.ts` for what that ambiguity would buy.
  */
-export declare function isEmailTopicId(value: unknown): value is string;
+export declare function isSubscriptionTopicId(value: unknown): value is string;
 /** Coerces one stored document into a topic, or `null` if it is not one. */
-export declare function normalizeEmailTopic(id: unknown, data: Record<string, unknown> | null | undefined): EmailTopic | null;
+export declare function normalizeSubscriptionTopic(id: unknown, data: Record<string, unknown> | null | undefined): SubscriptionTopic | null;
 /**
  * The catalog a reader sees: the built-in floor, overlaid by whatever the org
  * has stored, plus the org's own topics.
@@ -286,7 +302,7 @@ export declare function normalizeEmailTopic(id: unknown, data: Record<string, un
  * alphabetically after, so the preference page's checkbox order is stable
  * across renders and across sites.
  */
-export declare function mergeEmailTopics(stored: readonly EmailTopic[] | null | undefined): EmailTopic[];
+export declare function mergeSubscriptionTopics(stored: readonly SubscriptionTopic[] | null | undefined): SubscriptionTopic[];
 /**
  * The catalog minus retired topics — what a composer's picker and a
  * preference page's checkboxes offer.
@@ -296,7 +312,7 @@ export declare function mergeEmailTopics(stored: readonly EmailTopic[] | null |
  * belongs to that topic, and re-pointing it at something else would attribute
  * the unsubscribes to the wrong stream.
  */
-export declare function activeEmailTopics(topics: readonly EmailTopic[]): EmailTopic[];
+export declare function activeSubscriptionTopics(topics: readonly SubscriptionTopic[]): SubscriptionTopic[];
 /**
  * The topic a campaign belongs to, given what it stored and what the org
  * offers.
@@ -307,4 +323,4 @@ export declare function activeEmailTopics(topics: readonly EmailTopic[]): EmailT
  * page that names A topic, not on one that says the message came from
  * nowhere.
  */
-export declare function resolveCampaignTopic(topicId: string | null | undefined, topics: readonly EmailTopic[]): EmailTopic;
+export declare function resolveSubscriptionTopic(topicId: string | null | undefined, topics: readonly SubscriptionTopic[]): SubscriptionTopic;