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

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

@@ -25,6 +25,7 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
     };
     const walk = (spec, parentId)=>{
         var _spec_pluginId, _spec_props, _spec_children, _spec_children1;
+        var _spec_interactions;
         map[spec.id] = _extends({
             $id: spec.id,
             componentId: spec.componentId,
@@ -33,6 +34,8 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
             props: (_spec_props = spec.props) != null ? _spec_props : {}
         }, spec.sx ? {
             sx: spec.sx
+        } : {}, ((_spec_interactions = spec.interactions) == null ? void 0 : _spec_interactions.length) ? {
+            interactions: spec.interactions
         } : {}, {
             nodes: ((_spec_children = spec.children) != null ? _spec_children : []).map((child)=>child.id)
         });

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

@@ -1 +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"}
+{"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'\nimport type { NodeInteraction } from './node-interactions'\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  /**\n   * What the element does when a visitor acts on it, stored on the node as\n   * the interactions editor stores it (AGL-2867) — a button that scrolls to\n   * a section of its own page, for one.\n   */\n  interactions?: NodeInteraction[]\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      ...(spec.interactions?.length ? { interactions: spec.interactions } : {}),\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","interactions","length","starterText","variant","extra","starterSection","maxWidth","verticalPadding","paddingTop","paddingBottom","starterHeroSection","prefix","headline","tagline","spacing","alignItems","align","size"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,sBAAsB,QAAQ,oCAAgC;AAkFvE,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,aAGCA,gBAEUA;YAHdA;QAPNP,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,GAC7BJ,EAAAA,qBAAAA,KAAKK,YAAY,qBAAjBL,mBAAmBM,MAAM,IAAG;YAAED,cAAcL,KAAKK,YAAY;QAAC,IAAI,CAAC;YACvET,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,MAAMc,cAAc,CACzBT,IACAU,SACAhB,UACAiB,QACqB,CAAA;QACrBX;QACAH,aAAa;QACbQ,OAAO;YAAEK;YAAShB;WAAaiB;IACjC,CAAA,EAAE;AAYF;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BC,GACD,OAAO,MAAMC,iBAAiB,CAC5BZ,IACAa,UACAC,iBACApB,WACqB,CAAA;QACrBM;QACAH,aAAa;QACbQ,OAAO;YAAEQ;QAAS;QAClBP,IAAI;YAAES,YAAYD;YAAiBE,eAAeF;QAAgB;QAClEpB;IACF,CAAA,EAAE;AAEF;;;;CAIC,GACD,OAAO,MAAMuB,qBAAqB,CAChCC,QACAC,UACAC,UAEA,yEAAyE;IACzE,yEAAyE;IACzE,kCAAkC;IAClCR,eAAe,GAAGM,OAAO,WAAW,CAAC,EAAE,MAAM,IAAI;QAC/C;YACElB,IAAI,GAAGkB,OAAO,IAAI,CAAC;YACnBrB,aAAa;YACbQ,OAAO;gBAAEgB,SAAS;YAAE;YACpBf,IAAI;gBAAEgB,YAAY;YAAS;YAC3B5B,UAAU;gBACRe,YAAY,GAAGS,OAAO,SAAS,CAAC,EAAE,MAAMC,UAAU;oBAAEI,OAAO;gBAAS;gBACpEd,YAAY,GAAGS,OAAO,OAAO,CAAC,EAAE,MAAME,SAAS;oBAAEG,OAAO;gBAAS;gBACjE;oBACEvB,IAAI,GAAGkB,OAAO,OAAO,CAAC;oBACtBrB,aAAa;oBACbQ,OAAO;wBACLK,SAAS;wBACTc,MAAM;wBACN9B,UAAU;oBACZ;gBACF;aACD;QACH;KACD,EAAC"}

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

@@ -14,7 +14,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { type StarterTemplate, type StarterTemplateScreen } from './starter-template-nodes';
+import { type StarterTemplate } from './starter-template-nodes';
 export type { StarterNodeSpec, StarterSectionWidth, StarterTemplate, StarterTemplateScreen, } from './starter-template-nodes';
 export { buildStarterNodes, starterHeroSection, starterSection, starterText, } from './starter-template-nodes';
 /**
@@ -66,25 +66,11 @@ export declare function buildStarterTemplateDocs(starter: StarterTemplate): Star
 /** Every document a starter COULD materialize as, in bundle order. */
 export declare function buildAllStarterTemplateDocs(): StarterTemplateDoc[];
 /**
- * The home page every new site is born with (AGL-3408).
- *
- * A site used to be created with an empty routing map, so the address the
- * create dialog calls live answered with the tenant's 404 until somebody
- * built and published a page. `claimHostForOrg` now writes this screen, its
- * first version and its `/` route in the same transaction that creates the
- * host, which makes "a site with no home page" a state no new site starts in.
- *
- * It is PUBLIC from the first request, so the copy speaks to a visitor, never
- * to the owner — no "edit this in the besigner". The site's name is written in
- * as text, not bound: there is no page-content token for it, and a heading
- * that followed a rename is not worth one.
- *
- * Deliberately not a starter: it is not offered in the gallery, and applying a
- * starter may take the root back from it (see `defaultHomeScreenId`).
- *
- * PERSISTED IDENTIFIERS: every node id below is stored on every new site.
+ * The home page every new site is born with now lives with the rest of the
+ * site it is born into — layout, theme and SEO — in `default-site.ts`
+ * (AGL-3497). Re-exported so the name keeps its home here.
  */
-export declare function buildDefaultHomeScreen(siteName: string): StarterTemplateScreen;
+export { buildDefaultHomeScreen } from './default-site';
 /**
  * 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

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

@@ -24,7 +24,7 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
 // 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 { normalizeScreenSlug } 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";
 /**
@@ -143,54 +143,10 @@ const contactForm = (prefix)=>({
         ]
     });
 /**
- * The home page every new site is born with (AGL-3408).
- *
- * A site used to be created with an empty routing map, so the address the
- * create dialog calls live answered with the tenant's 404 until somebody
- * built and published a page. `claimHostForOrg` now writes this screen, its
- * first version and its `/` route in the same transaction that creates the
- * host, which makes "a site with no home page" a state no new site starts in.
- *
- * It is PUBLIC from the first request, so the copy speaks to a visitor, never
- * to the owner — no "edit this in the besigner". The site's name is written in
- * as text, not bound: there is no page-content token for it, and a heading
- * that followed a rename is not worth one.
- *
- * Deliberately not a starter: it is not offered in the gallery, and applying a
- * starter may take the root back from it (see `defaultHomeScreenId`).
- *
- * PERSISTED IDENTIFIERS: every node id below is stored on every new site.
- */ export function buildDefaultHomeScreen(siteName) {
-    const name = siteName.trim() || 'Welcome';
-    return {
-        key: 'home',
-        displayName: 'Home',
-        slug: SCREEN_ROOT_PATH,
-        nodes: buildNodes([
-            section('dh_heroSection', 'md', 12, [
-                {
-                    id: 'dh_hero',
-                    componentId: 'muiStack',
-                    props: {
-                        spacing: 2
-                    },
-                    sx: {
-                        alignItems: 'center'
-                    },
-                    children: [
-                        text('dh_heroTitle', 'h2', name, {
-                            align: 'center'
-                        }),
-                        text('dh_heroSub', 'h6', 'Welcome — our new website is on its way.', {
-                            align: 'center',
-                            color: 'text.secondary'
-                        })
-                    ]
-                }
-            ])
-        ])
-    };
-}
+ * The home page every new site is born with now lives with the rest of the
+ * site it is born into — layout, theme and SEO — in `default-site.ts`
+ * (AGL-3497). Re-exported so the name keeps its home here.
+ */ export { buildDefaultHomeScreen } from "./default-site.js";
 /** The platform's own starters, which name no plugin's elements. */ const PLATFORM_STARTER_TEMPLATES = [
     {
         id: 'landing',

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 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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"}
+{"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 } 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} 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 now lives with the rest of the\n * site it is born into — layout, theme and SEO — in `default-site.ts`\n * (AGL-3497). Re-exported so the name keeps its home here.\n */\nexport { buildDefaultHomeScreen } from './default-site'\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","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","PLATFORM_STARTER_TEMPLATES","direction","alt","height"],"mappings":"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"}

package/src/lib/app-utils/transfer-launcher-context.d.ts

@@ -0,0 +1,136 @@
+/**
+ * @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 type { TransferUnfinishedImportSummary } from '../data-transfer/transfer-api';
+/**
+ * The console shell's import wizard and export dialog, for a plugin to open.
+ *
+ * The wizard and the dialog are the console's private UI kit, which a
+ * published plugin cannot depend on. So the shell hands down a launcher
+ * through this context, and a plugin's list or hub opens the wizard for its
+ * own resource — the key it declared in `transferResources` — with
+ * `useTransferLauncher()?.openImport({ resource, scope })`.
+ *
+ * Outside the console shell — a spec, a tenant page, a surface mounted by
+ * something else — the context holds `null`, and a plugin hides its Import
+ * and Export actions: with no shell there is no workspace to move data into.
+ *
+ * Inside it, `can('import' | 'export', target)` says which of the two this
+ * person may use (AGL-3546): a plugin shows Import only when `can('import')`
+ * and Export only when `can('export')`. The transfer routes stay the
+ * enforcement; `can` answers what they would.
+ *
+ * Only types and a context: it names no resource, imports nothing from the
+ * transfer core, and so costs the barrel nothing past React.
+ *
+ * A client-only context like the others in `contexts.ts`: it calls
+ * `createContext` at module scope, so it is reachable from the full
+ * `@aglyn/aglyn` barrel (and this subpath) and never from
+ * `@aglyn/aglyn/server` (AGL-405).
+ */
+/** Where the records live: the workspace, or one of its sites. */
+export type TransferLaunchScope = 'org' | 'host';
+/** Opens the import wizard on one resource. */
+export interface TransferImportLaunch {
+    /**
+     * The resource key the plugin declared in `transferResources` — for one
+     * declared with `instances`, the key naming the instance
+     * (`data.dataset:<datasetId>`).
+     */
+    resource: string;
+    scope: TransferLaunchScope;
+    /** The wizard's title, naming the instance ("Import into Products"); "Import <resource label>" when absent. */
+    title?: string;
+    /** The site, for a `host` resource. */
+    hostId?: string | null;
+    /** Resume this import instead of starting a new one. */
+    jobId?: string | null;
+    /**
+     * What the file is imported as, as the `importMapping` zone's widgets know
+     * it (`contacts`); omitted, the mapping step shows no zone.
+     */
+    mappingZone?: string;
+    /** Called when the person leaves the wizard from its results with Done. */
+    onFinished?(): void;
+}
+/** Opens the export dialog on one resource. */
+export interface TransferExportLaunch {
+    /** The resource key the plugin declared in `transferResources`, naming the instance for one declared with `instances`. */
+    resource: string;
+    scope: TransferLaunchScope;
+    /** The dialog's title, naming the instance ("Export Products"); "Export <resource label>" when absent. */
+    title?: string;
+    /** The site, for a `host` resource. */
+    hostId?: string | null;
+    /** The record ids the person selected in the list, when there is a selection. */
+    selection?: readonly string[];
+    /** The list's current filter: a name for it, and the value the resource's `readPage` reads. */
+    filter?: {
+        label: string;
+        value: unknown;
+    };
+}
+/** What a person may do with a resource's records. */
+export type TransferAction = 'import' | 'export';
+/** The resource a list asks {@link TransferLauncher.can} about. */
+export interface TransferAccessTarget {
+    /** The resource key, naming the instance for one declared with `instances`. */
+    resource: string;
+    scope: TransferLaunchScope;
+    /** The site, for a `host` resource or a workspace resource read through one site. */
+    hostId?: string | null;
+}
+/**
+ * An import the person started and left before it wrote anything
+ * (AGL-3549) — a tab closed mid-wizard — which `openImport({ jobId })`
+ * reopens on the step it was left at.
+ */
+export type TransferUnfinishedImport = TransferUnfinishedImportSummary;
+/** What the shell offers: open the wizard or the dialog, or close whichever is open. */
+export interface TransferLauncher {
+    openImport(launch: TransferImportLaunch): void;
+    openExport(launch: TransferExportLaunch): void;
+    close(): void;
+    /**
+     * Whether the person may `action` the target's records (AGL-3546) — the
+     * answer the transfer routes give, from the permissions the shell already
+     * holds: synchronous, with no request per button, and `false` until those
+     * permissions have answered. Importing needs "Manage data" (on the named
+     * site, for a site's records); exporting needs only access to the
+     * records — membership, and reaching the named site — unless the resource
+     * declares a `readPermission`. The routes stay the enforcement.
+     */
+    can(action: TransferAction, target: TransferAccessTarget): boolean;
+    /**
+     * The person's own unfinished imports (AGL-3549), newest first: of the
+     * target's resource — the exact key, so one dataset's are not another's —
+     * on the target's site when it names one, when a target is given; every
+     * one otherwise. Empty
+     * until the shell has read them; the first ask starts the read, and the
+     * list is read again whenever the wizard closes. Only for a person who may
+     * import into the workspace.
+     */
+    unfinished?(target?: TransferAccessTarget): readonly TransferUnfinishedImport[];
+    /**
+     * Throws an unfinished import away now — its job, its file and its saved
+     * choices — instead of leaving it to expire. Refused for an import that
+     * has written anything, which is undone instead.
+     */
+    discard?(jobId: string): Promise<void>;
+}
+export declare const TransferLauncherContext: import("react").Context<TransferLauncher>;
+/** The shell's launcher, or `null` outside the console shell. */
+export declare function useTransferLauncher(): TransferLauncher | null;

package/src/lib/app-utils/transfer-launcher-context.js

@@ -0,0 +1,23 @@
+/**
+ * @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 { createContext, useContext } from "react";
+export const TransferLauncherContext = createContext(null);
+TransferLauncherContext.displayName = 'TransferLauncherContext';
+/** The shell's launcher, or `null` outside the console shell. */ export function useTransferLauncher() {
+    return useContext(TransferLauncherContext);
+}
+
+//# sourceMappingURL=transfer-launcher-context.js.map

package/src/lib/app-utils/transfer-launcher-context.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/transfer-launcher-context.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 { createContext, useContext } from 'react'\nimport type { TransferUnfinishedImportSummary } from '../data-transfer/transfer-api'\n\n/**\n * The console shell's import wizard and export dialog, for a plugin to open.\n *\n * The wizard and the dialog are the console's private UI kit, which a\n * published plugin cannot depend on. So the shell hands down a launcher\n * through this context, and a plugin's list or hub opens the wizard for its\n * own resource — the key it declared in `transferResources` — with\n * `useTransferLauncher()?.openImport({ resource, scope })`.\n *\n * Outside the console shell — a spec, a tenant page, a surface mounted by\n * something else — the context holds `null`, and a plugin hides its Import\n * and Export actions: with no shell there is no workspace to move data into.\n *\n * Inside it, `can('import' | 'export', target)` says which of the two this\n * person may use (AGL-3546): a plugin shows Import only when `can('import')`\n * and Export only when `can('export')`. The transfer routes stay the\n * enforcement; `can` answers what they would.\n *\n * Only types and a context: it names no resource, imports nothing from the\n * transfer core, and so costs the barrel nothing past React.\n *\n * A client-only context like the others in `contexts.ts`: it calls\n * `createContext` at module scope, so it is reachable from the full\n * `@aglyn/aglyn` barrel (and this subpath) and never from\n * `@aglyn/aglyn/server` (AGL-405).\n */\n\n/** Where the records live: the workspace, or one of its sites. */\nexport type TransferLaunchScope = 'org' | 'host'\n\n/** Opens the import wizard on one resource. */\nexport interface TransferImportLaunch {\n  /**\n   * The resource key the plugin declared in `transferResources` — for one\n   * declared with `instances`, the key naming the instance\n   * (`data.dataset:<datasetId>`).\n   */\n  resource: string\n  scope: TransferLaunchScope\n  /** The wizard's title, naming the instance (\"Import into Products\"); \"Import <resource label>\" when absent. */\n  title?: string\n  /** The site, for a `host` resource. */\n  hostId?: string | null\n  /** Resume this import instead of starting a new one. */\n  jobId?: string | null\n  /**\n   * What the file is imported as, as the `importMapping` zone's widgets know\n   * it (`contacts`); omitted, the mapping step shows no zone.\n   */\n  mappingZone?: string\n  /** Called when the person leaves the wizard from its results with Done. */\n  onFinished?(): void\n}\n\n/** Opens the export dialog on one resource. */\nexport interface TransferExportLaunch {\n  /** The resource key the plugin declared in `transferResources`, naming the instance for one declared with `instances`. */\n  resource: string\n  scope: TransferLaunchScope\n  /** The dialog's title, naming the instance (\"Export Products\"); \"Export <resource label>\" when absent. */\n  title?: string\n  /** The site, for a `host` resource. */\n  hostId?: string | null\n  /** The record ids the person selected in the list, when there is a selection. */\n  selection?: readonly string[]\n  /** The list's current filter: a name for it, and the value the resource's `readPage` reads. */\n  filter?: { label: string; value: unknown }\n}\n\n/** What a person may do with a resource's records. */\nexport type TransferAction = 'import' | 'export'\n\n/** The resource a list asks {@link TransferLauncher.can} about. */\nexport interface TransferAccessTarget {\n  /** The resource key, naming the instance for one declared with `instances`. */\n  resource: string\n  scope: TransferLaunchScope\n  /** The site, for a `host` resource or a workspace resource read through one site. */\n  hostId?: string | null\n}\n\n/**\n * An import the person started and left before it wrote anything\n * (AGL-3549) — a tab closed mid-wizard — which `openImport({ jobId })`\n * reopens on the step it was left at.\n */\nexport type TransferUnfinishedImport = TransferUnfinishedImportSummary\n\n/** What the shell offers: open the wizard or the dialog, or close whichever is open. */\nexport interface TransferLauncher {\n  openImport(launch: TransferImportLaunch): void\n  openExport(launch: TransferExportLaunch): void\n  close(): void\n  /**\n   * Whether the person may `action` the target's records (AGL-3546) — the\n   * answer the transfer routes give, from the permissions the shell already\n   * holds: synchronous, with no request per button, and `false` until those\n   * permissions have answered. Importing needs \"Manage data\" (on the named\n   * site, for a site's records); exporting needs only access to the\n   * records — membership, and reaching the named site — unless the resource\n   * declares a `readPermission`. The routes stay the enforcement.\n   */\n  can(action: TransferAction, target: TransferAccessTarget): boolean\n  /**\n   * The person's own unfinished imports (AGL-3549), newest first: of the\n   * target's resource — the exact key, so one dataset's are not another's —\n   * on the target's site when it names one, when a target is given; every\n   * one otherwise. Empty\n   * until the shell has read them; the first ask starts the read, and the\n   * list is read again whenever the wizard closes. Only for a person who may\n   * import into the workspace.\n   */\n  unfinished?(target?: TransferAccessTarget): readonly TransferUnfinishedImport[]\n  /**\n   * Throws an unfinished import away now — its job, its file and its saved\n   * choices — instead of leaving it to expire. Refused for an import that\n   * has written anything, which is undone instead.\n   */\n  discard?(jobId: string): Promise<void>\n}\n\nexport const TransferLauncherContext = createContext<TransferLauncher | null>(null)\nTransferLauncherContext.displayName = 'TransferLauncherContext'\n\n/** The shell's launcher, or `null` outside the console shell. */\nexport function useTransferLauncher(): TransferLauncher | null {\n  return useContext(TransferLauncherContext)\n}\n\n"],"names":["createContext","useContext","TransferLauncherContext","displayName","useTransferLauncher"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,aAAa,EAAEC,UAAU,QAAQ,QAAO;AA4HjD,OAAO,MAAMC,0BAA0BF,cAAuC,MAAK;AACnFE,wBAAwBC,WAAW,GAAG;AAEtC,+DAA+D,GAC/D,OAAO,SAASC;IACd,OAAOH,WAAWC;AACpB"}

package/src/lib/app-utils/transfer-resume-import.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @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 { type TransferAccessTarget } from './transfer-launcher-context';
+export interface TransferResumeImportProps {
+    /** The resource the surface imports into, and the site — as its Import button opens it. */
+    target: TransferAccessTarget;
+    /** The wizard's title, as the surface's Import button sets it. */
+    title?: string;
+    /** Called when the person leaves the resumed wizard from its results. */
+    onFinished?(): void;
+}
+/**
+ * "Resume import" beside a surface's Import (AGL-3549): the imports the
+ * person started on this resource and left before anything was written —
+ * a tab closed mid-wizard — each reopened where it stopped
+ * (`openImport({ jobId })`) or discarded. Draws nothing outside the
+ * console shell, for a person who may not import here, or when there is
+ * nothing to resume. Every choice made in the wizard is kept with the job,
+ * so a resumed import opens on the step it was left at.
+ */
+export declare function TransferResumeImport(props: TransferResumeImportProps): import("react").JSX.Element;
+export declare namespace TransferResumeImport {
+    var displayName: string;
+}
+export default TransferResumeImport;