@aglyn/aglyn 1.0.0-beta.219 → 1.0.0-beta.221

package/src/lib/app-utils/starter-template-nodes.d.ts

@@ -0,0 +1,137 @@
+/**
+ * @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.
+ */
+/**
+ * What a starter site is, and the kit its pages are built with (AGL-687,
+ * AGL-3080).
+ *
+ * A starter is a bundle of page templates the template gallery offers and
+ * the seed route copies into a site's library on first use. The platform's
+ * own starters live in `starter-templates.ts`; a plugin whose elements a
+ * starter is built around declares its own, built with this same kit, and
+ * the manifest generator compiles them into
+ * `plugin-starter-templates.generated.ts`.
+ *
+ * Leaf imports only, for the reason `starter-templates.ts` states: this is
+ * read from the console's client gallery, its seed route and a plugin's
+ * server alike, so it imports a canvas constant and nothing that drags in
+ * either barrel.
+ *
+ * PERSISTED IDENTIFIERS: `StarterTemplate.id`, `StarterTemplateScreen.key`
+ * and every node id a starter builds appear in stored documents (seeded
+ * template doc ids are derived from the first two). They must never be
+ * renamed.
+ */
+export interface StarterTemplateScreen {
+    /**
+     * Stable, starter-local key. Part of the seeded document id, so it is a
+     * persisted identifier — never rename one.
+     */
+    key: string;
+    displayName: string;
+    description?: string;
+    /**
+     * Routing-map slug. `SCREEN_ROOT_PATH` (`'/'`) asks for the site root — the
+     * home page — and anything else is a single path segment.
+     *
+     * It used to be `''` that meant home, which no normalizer agreed with: both
+     * the apply path and the seed below read an empty string as "no address
+     * authored" and derived one from the display name, so the shop starters'
+     * home page was published at `/home` and the site 404'd at its own URL
+     * (AGL-1575).
+     */
+    slug: string;
+    seo?: {
+        title?: string;
+        description?: string;
+    };
+    /** Flat node map including the canvas root. */
+    nodes: Record<string, any>;
+}
+export interface StarterTemplate {
+    id: string;
+    displayName: string;
+    description: string;
+    category: string;
+    screens: StarterTemplateScreen[];
+}
+/** A materialized starter template document, keyed by its deterministic id. */
+export type StarterNodeSpec = {
+    id: string;
+    componentId: string;
+    /** Bundle owning the component; defaults to 'mui' (AGL-300). */
+    pluginId?: string;
+    props?: Record<string, unknown>;
+    /**
+     * Node-level styles — a SIBLING of props, never `props.sx` (AGL-1346).
+     *
+     * Both records render (`Leaf` composes `(sx, props.sx, node.sx)`, later
+     * wins), but the Styles panel edits `node.sx`. A starter that seeded its
+     * styling into `props.sx` handed the author a document full of values
+     * the panel could show but no click could change or clear.
+     */
+    sx?: Record<string, unknown>;
+    children?: StarterNodeSpec[];
+};
+/** Builds the flat, persisted node map from a nested spec. */
+export declare function buildStarterNodes(children: StarterNodeSpec[]): Record<string, any>;
+/** One line of a starter's copy: a `muiTypography` of the given variant. */
+export declare const starterText: (id: string, variant: string, children: string, extra?: Record<string, unknown>) => StarterNodeSpec;
+/**
+ * The stock widths a starter band may be (AGL-1932, AGL-1298).
+ *
+ * Three cases, and only three, because the standard has three. There is no
+ * pixel case: `1328` is a CONTENT width, not a breakpoint, and the ban on
+ * bespoke numbers is the half of AGL-1298 these templates used to violate
+ * four times over.
+ */
+export type StarterSectionWidth = 'md' | 'lg' | 'xl';
+/**
+ * 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.
+ */
+export declare const starterSection: (id: string, maxWidth: StarterSectionWidth, verticalPadding: number, children: StarterNodeSpec[]) => StarterNodeSpec;
+/**
+ * The hero band a starter page opens with: a headline, a tagline and a call
+ * to action, centered in an `xl` band. Its node ids are `prefix` plus fixed
+ * names, so a starter's prefix keeps them its own.
+ */
+export declare const starterHeroSection: (prefix: string, headline: string, tagline: string) => StarterNodeSpec;

package/src/lib/app-utils/starter-template-nodes.js

@@ -0,0 +1,129 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @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.
+ */ import { CANVAS_ROOT_ELEMENT_ID } from "../foundation/constants/canvas.js";
+/** Builds the flat, persisted node map from a nested spec. */ export function buildStarterNodes(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;
+}
+/** One line of a starter's copy: a `muiTypography` of the given variant. */ export const starterText = (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.
+ */ export const starterSection = (id, maxWidth, verticalPadding, children)=>({
+        id,
+        componentId: 'muiContainer',
+        props: {
+            maxWidth
+        },
+        sx: {
+            paddingTop: verticalPadding,
+            paddingBottom: verticalPadding
+        },
+        children
+    });
+/**
+ * The hero band a starter page opens with: a headline, a tagline and a call
+ * to action, centered in an `xl` band. Its node ids are `prefix` plus fixed
+ * names, so a starter's prefix keeps them its own.
+ */ export const starterHeroSection = (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.
+    starterSection(`${prefix}heroSection`, 'xl', 10, [
+        {
+            id: `${prefix}hero`,
+            componentId: 'muiStack',
+            props: {
+                spacing: 2
+            },
+            sx: {
+                alignItems: 'center'
+            },
+            children: [
+                starterText(`${prefix}heroTitle`, 'h2', headline, {
+                    align: 'center'
+                }),
+                starterText(`${prefix}heroSub`, 'h6', tagline, {
+                    align: 'center'
+                }),
+                {
+                    id: `${prefix}heroCta`,
+                    componentId: 'muiButton',
+                    props: {
+                        variant: 'contained',
+                        size: 'large',
+                        children: 'Get in touch'
+                    }
+                }
+            ]
+        }
+    ]);
+
+//# sourceMappingURL=starter-template-nodes.js.map

package/src/lib/app-utils/starter-template-nodes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/starter-template-nodes.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { CANVAS_ROOT_ELEMENT_ID } from '../foundation/constants/canvas'\n\n/**\n * What a starter site is, and the kit its pages are built with (AGL-687,\n * AGL-3080).\n *\n * A starter is a bundle of page templates the template gallery offers and\n * the seed route copies into a site's library on first use. The platform's\n * own starters live in `starter-templates.ts`; a plugin whose elements a\n * starter is built around declares its own, built with this same kit, and\n * the manifest generator compiles them into\n * `plugin-starter-templates.generated.ts`.\n *\n * Leaf imports only, for the reason `starter-templates.ts` states: this is\n * read from the console's client gallery, its seed route and a plugin's\n * server alike, so it imports a canvas constant and nothing that drags in\n * either barrel.\n *\n * PERSISTED IDENTIFIERS: `StarterTemplate.id`, `StarterTemplateScreen.key`\n * and every node id a starter builds appear in stored documents (seeded\n * template doc ids are derived from the first two). They must never be\n * 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. */\n\nexport type StarterNodeSpec = {\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?: StarterNodeSpec[]\n}\n\n/** Builds the flat, persisted node map from a nested spec. */\nexport function buildStarterNodes(children: StarterNodeSpec[]): 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: StarterNodeSpec, 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\n/** One line of a starter's copy: a `muiTypography` of the given variant. */\nexport const starterText = (\n  id: string,\n  variant: string,\n  children: string,\n  extra?: Record<string, unknown>,\n): StarterNodeSpec => ({\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 */\nexport type StarterSectionWidth = '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 */\nexport const starterSection = (\n  id: string,\n  maxWidth: StarterSectionWidth,\n  verticalPadding: number,\n  children: StarterNodeSpec[],\n): StarterNodeSpec => ({\n  id,\n  componentId: 'muiContainer',\n  props: { maxWidth },\n  sx: { paddingTop: verticalPadding, paddingBottom: verticalPadding },\n  children,\n})\n\n/**\n * The hero band a starter page opens with: a headline, a tagline and a call\n * to action, centered in an `xl` band. Its node ids are `prefix` plus fixed\n * names, so a starter's prefix keeps them its own.\n */\nexport const starterHeroSection = (\n  prefix: string,\n  headline: string,\n  tagline: string,\n): StarterNodeSpec =>\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  starterSection(`${prefix}heroSection`, 'xl', 10, [\n    {\n      id: `${prefix}hero`,\n      componentId: 'muiStack',\n      props: { spacing: 2 },\n      sx: { alignItems: 'center' },\n      children: [\n        starterText(`${prefix}heroTitle`, 'h2', headline, { align: 'center' }),\n        starterText(`${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"],"names":["CANVAS_ROOT_ELEMENT_ID","buildStarterNodes","children","map","$id","componentId","nodes","child","id","walk","spec","parentId","pluginId","props","sx","starterText","variant","extra","starterSection","maxWidth","verticalPadding","paddingTop","paddingBottom","starterHeroSection","prefix","headline","tagline","spacing","alignItems","align","size"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,sBAAsB,QAAQ,oCAAgC;AA2EvE,4DAA4D,GAC5D,OAAO,SAASC,kBAAkBC,QAA2B;IAC3D,MAAMC,MAA2B;QAC/B,CAACH,uBAAuB,EAAE;YACxBI,KAAKJ;YACLK,aAAa;YACbC,OAAOJ,SAASC,GAAG,CAAC,CAACI,QAAUA,MAAMC,EAAE;QACzC;IACF;IACA,MAAMC,OAAO,CAACC,MAAuBC;YAIvBD,gBAEHA,aAECA,gBAEUA;QATpBP,GAAG,CAACO,KAAKF,EAAE,CAAC,GAAG;YACbJ,KAAKM,KAAKF,EAAE;YACZH,aAAaK,KAAKL,WAAW;YAC7BO,QAAQ,GAAEF,iBAAAA,KAAKE,QAAQ,YAAbF,iBAAiB;YAC3BC;YACAE,KAAK,GAAEH,cAAAA,KAAKG,KAAK,YAAVH,cAAc,CAAC;WAClBA,KAAKI,EAAE,GAAG;YAAEA,IAAIJ,KAAKI,EAAE;QAAC,IAAI,CAAC;YACjCR,OAAO,EAACI,iBAAAA,KAAKR,QAAQ,YAAbQ,iBAAiB,EAAE,EAAEP,GAAG,CAAC,CAACI,QAAUA,MAAMC,EAAE;;QAEtD,KAAK,MAAMD,UAASG,kBAAAA,KAAKR,QAAQ,YAAbQ,kBAAiB,EAAE,CAAED,KAAKF,OAAOG,KAAKF,EAAE;IAC9D;IACA,KAAK,MAAMD,SAASL,SAAUO,KAAKF,OAAOP;IAC1C,OAAOG;AACT;AAEA,0EAA0E,GAC1E,OAAO,MAAMY,cAAc,CACzBP,IACAQ,SACAd,UACAe,QACqB,CAAA;QACrBT;QACAH,aAAa;QACbQ,OAAO;YAAEG;YAASd;WAAae;IACjC,CAAA,EAAE;AAYF;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BC,GACD,OAAO,MAAMC,iBAAiB,CAC5BV,IACAW,UACAC,iBACAlB,WACqB,CAAA;QACrBM;QACAH,aAAa;QACbQ,OAAO;YAAEM;QAAS;QAClBL,IAAI;YAAEO,YAAYD;YAAiBE,eAAeF;QAAgB;QAClElB;IACF,CAAA,EAAE;AAEF;;;;CAIC,GACD,OAAO,MAAMqB,qBAAqB,CAChCC,QACAC,UACAC,UAEA,yEAAyE;IACzE,yEAAyE;IACzE,kCAAkC;IAClCR,eAAe,GAAGM,OAAO,WAAW,CAAC,EAAE,MAAM,IAAI;QAC/C;YACEhB,IAAI,GAAGgB,OAAO,IAAI,CAAC;YACnBnB,aAAa;YACbQ,OAAO;gBAAEc,SAAS;YAAE;YACpBb,IAAI;gBAAEc,YAAY;YAAS;YAC3B1B,UAAU;gBACRa,YAAY,GAAGS,OAAO,SAAS,CAAC,EAAE,MAAMC,UAAU;oBAAEI,OAAO;gBAAS;gBACpEd,YAAY,GAAGS,OAAO,OAAO,CAAC,EAAE,MAAME,SAAS;oBAAEG,OAAO;gBAAS;gBACjE;oBACErB,IAAI,GAAGgB,OAAO,OAAO,CAAC;oBACtBnB,aAAa;oBACbQ,OAAO;wBACLG,SAAS;wBACTc,MAAM;wBACN5B,UAAU;oBACZ;gBACF;aACD;QACH;KACD,EAAC"}

package/src/lib/app-utils/starter-templates.d.ts

@@ -14,6 +14,9 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+import { type StarterTemplate, type StarterTemplateScreen } from './starter-template-nodes';
+export type { StarterNodeSpec, StarterSectionWidth, StarterTemplate, StarterTemplateScreen, } from './starter-template-nodes';
+export { buildStarterNodes, starterHeroSection, starterSection, starterText, } from './starter-template-nodes';
 /**
  * First-party starter definitions (AGL-78/79), SEED INPUT (AGL-687).
  *
@@ -36,40 +39,6 @@
  * and every node id below appear in stored documents (seeded template doc
  * ids are derived from the first two). They must never be renamed.
  */
-export interface StarterTemplateScreen {
-    /**
-     * Stable, starter-local key. Part of the seeded document id, so it is a
-     * persisted identifier — never rename one.
-     */
-    key: string;
-    displayName: string;
-    description?: string;
-    /**
-     * Routing-map slug. `SCREEN_ROOT_PATH` (`'/'`) asks for the site root — the
-     * home page — and anything else is a single path segment.
-     *
-     * It used to be `''` that meant home, which no normalizer agreed with: both
-     * the apply path and the seed below read an empty string as "no address
-     * authored" and derived one from the display name, so the shop starters'
-     * home page was published at `/home` and the site 404'd at its own URL
-     * (AGL-1575).
-     */
-    slug: string;
-    seo?: {
-        title?: string;
-        description?: string;
-    };
-    /** Flat node map including the canvas root. */
-    nodes: Record<string, any>;
-}
-export interface StarterTemplate {
-    id: string;
-    displayName: string;
-    description: string;
-    category: string;
-    screens: StarterTemplateScreen[];
-}
-/** A materialized starter template document, keyed by its deterministic id. */
 export interface StarterTemplateDoc {
     id: string;
     /** Which starter this page belongs to — lets one starter be selected. */
@@ -116,4 +85,12 @@ export declare function buildAllStarterTemplateDocs(): StarterTemplateDoc[];
  * PERSISTED IDENTIFIERS: every node id below is stored on every new site.
  */
 export declare function buildDefaultHomeScreen(siteName: string): StarterTemplateScreen;
+/**
+ * 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 declare const STARTER_TEMPLATES: StarterTemplate[];

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