@aglyn/aglyn 1.0.0-beta.277 → 1.0.0-beta.283

package/src/lib/app-utils/site-font-pairings.js

@@ -0,0 +1,514 @@
+/**
+ * @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.
+ */ /**
+ * The font pairings a site's look is chosen from (AGL-4049): a heading family
+ * over a body family, each with the weights it loads.
+ *
+ * The platform's, not one plugin's: the AI site start picks among them for a
+ * business's own look, and a site starter names the one it was designed in
+ * (`site-starter.ts`), so a starter and a generated site speak one list.
+ * Moved here from the AI plugin's `ai-site-kinds.ts`, which re-exports it
+ * under its old names.
+ *
+ * Pure data, safe for any surface to import.
+ */ /** A font pairing a look may choose: a heading family over a body family. */ /**
+ * The pairings, every family from the Google Fonts catalog the fonts plugin
+ * serves (`google-fonts.catalog.json`) and every weight one that family
+ * has — the AI plugin's `ai-site-look.spec.ts` holds both. The tenant loads
+ * them the way it loads the starter theme's family, so nothing here adds a
+ * font host.
+ */ export const SITE_FONT_PAIRINGS = [
+    {
+        id: 'jakarta',
+        feel: 'modern, friendly sans',
+        heading: {
+            family: 'Plus Jakarta Sans',
+            category: 'sans-serif',
+            weight: 800,
+            sub: 700
+        },
+        body: {
+            family: 'Plus Jakarta Sans',
+            category: 'sans-serif',
+            weights: [
+                400,
+                500,
+                600,
+                700
+            ]
+        },
+        tracking: -0.02
+    },
+    {
+        id: 'inter',
+        feel: 'neutral, precise sans',
+        heading: {
+            family: 'Inter',
+            category: 'sans-serif',
+            weight: 700,
+            sub: 600
+        },
+        body: {
+            family: 'Inter',
+            category: 'sans-serif',
+            weights: [
+                400,
+                500,
+                600,
+                700
+            ]
+        },
+        tracking: -0.025
+    },
+    {
+        id: 'grotesk',
+        feel: 'designer grotesk',
+        heading: {
+            family: 'Space Grotesk',
+            category: 'sans-serif',
+            weight: 600,
+            sub: 600
+        },
+        body: {
+            family: 'Inter',
+            category: 'sans-serif',
+            weights: [
+                400,
+                500,
+                600,
+                700
+            ]
+        },
+        tracking: -0.03
+    },
+    {
+        id: 'syne',
+        feel: 'expressive, art-school display',
+        heading: {
+            family: 'Syne',
+            category: 'sans-serif',
+            weight: 700,
+            sub: 600
+        },
+        body: {
+            family: 'Inter',
+            category: 'sans-serif',
+            weights: [
+                400,
+                500,
+                600,
+                700
+            ]
+        },
+        tracking: -0.02
+    },
+    {
+        id: 'bricolage',
+        feel: 'contemporary, characterful sans',
+        heading: {
+            family: 'Bricolage Grotesque',
+            category: 'sans-serif',
+            weight: 700,
+            sub: 600
+        },
+        body: {
+            family: 'DM Sans',
+            category: 'sans-serif',
+            weights: [
+                400,
+                500,
+                600,
+                700
+            ]
+        },
+        tracking: -0.025
+    },
+    {
+        id: 'editorial',
+        feel: 'editorial serif over clean sans',
+        heading: {
+            family: 'Playfair Display',
+            category: 'serif',
+            weight: 700,
+            sub: 600
+        },
+        body: {
+            family: 'Source Sans 3',
+            category: 'sans-serif',
+            weights: [
+                400,
+                500,
+                600,
+                700
+            ]
+        },
+        tracking: -0.01
+    },
+    {
+        id: 'fraunces',
+        feel: 'warm, soft serif',
+        heading: {
+            family: 'Fraunces',
+            category: 'serif',
+            weight: 600,
+            sub: 600
+        },
+        body: {
+            family: 'Inter',
+            category: 'sans-serif',
+            weights: [
+                400,
+                500,
+                600,
+                700
+            ]
+        },
+        tracking: -0.015
+    },
+    {
+        id: 'instrument',
+        feel: 'elegant, light serif headlines',
+        heading: {
+            family: 'Instrument Serif',
+            category: 'serif',
+            weight: 400,
+            sub: 400
+        },
+        body: {
+            family: 'Inter',
+            category: 'sans-serif',
+            weights: [
+                400,
+                500,
+                600,
+                700
+            ]
+        },
+        tracking: -0.01
+    },
+    {
+        id: 'reading',
+        feel: 'reading-first serif, serif body',
+        heading: {
+            family: 'Newsreader',
+            category: 'serif',
+            weight: 600,
+            sub: 600
+        },
+        body: {
+            family: 'Source Serif 4',
+            category: 'serif',
+            weights: [
+                400,
+                600,
+                700
+            ]
+        },
+        tracking: -0.01
+    },
+    {
+        id: 'garamond',
+        feel: 'refined, classic serif',
+        heading: {
+            family: 'Cormorant Garamond',
+            category: 'serif',
+            weight: 600,
+            sub: 600
+        },
+        body: {
+            family: 'Montserrat',
+            category: 'sans-serif',
+            weights: [
+                400,
+                500,
+                600,
+                700
+            ]
+        }
+    },
+    {
+        id: 'baskerville',
+        feel: 'established, trustworthy serif',
+        heading: {
+            family: 'Libre Baskerville',
+            category: 'serif',
+            weight: 700,
+            sub: 700
+        },
+        body: {
+            family: 'Source Sans 3',
+            category: 'sans-serif',
+            weights: [
+                400,
+                500,
+                600,
+                700
+            ]
+        }
+    },
+    {
+        id: 'merriweather',
+        feel: 'sturdy, readable serif',
+        heading: {
+            family: 'Merriweather',
+            category: 'serif',
+            weight: 700,
+            sub: 700
+        },
+        body: {
+            family: 'Lato',
+            category: 'sans-serif',
+            weights: [
+                400,
+                700
+            ]
+        }
+    },
+    {
+        id: 'lora',
+        feel: 'gentle, calm serif',
+        heading: {
+            family: 'Lora',
+            category: 'serif',
+            weight: 600,
+            sub: 600
+        },
+        body: {
+            family: 'Open Sans',
+            category: 'sans-serif',
+            weights: [
+                400,
+                500,
+                600,
+                700
+            ]
+        }
+    },
+    {
+        id: 'dmserif',
+        feel: 'polished display serif',
+        heading: {
+            family: 'DM Serif Display',
+            category: 'serif',
+            weight: 400,
+            sub: 400
+        },
+        body: {
+            family: 'DM Sans',
+            category: 'sans-serif',
+            weights: [
+                400,
+                500,
+                600,
+                700
+            ]
+        }
+    },
+    {
+        id: 'oswald',
+        feel: 'bold, condensed, workmanlike',
+        heading: {
+            family: 'Oswald',
+            category: 'sans-serif',
+            weight: 600,
+            sub: 500
+        },
+        body: {
+            family: 'Roboto',
+            category: 'sans-serif',
+            weights: [
+                400,
+                500,
+                700
+            ]
+        },
+        caps: true,
+        tracking: 0.01
+    },
+    {
+        id: 'archivo',
+        feel: 'heavy, high-impact sans',
+        heading: {
+            family: 'Archivo Black',
+            category: 'sans-serif',
+            weight: 400,
+            sub: 400
+        },
+        body: {
+            family: 'Archivo',
+            category: 'sans-serif',
+            weights: [
+                400,
+                500,
+                600,
+                700
+            ]
+        },
+        tracking: -0.01
+    },
+    {
+        id: 'barlow',
+        feel: 'athletic, condensed sans',
+        heading: {
+            family: 'Barlow Condensed',
+            category: 'sans-serif',
+            weight: 700,
+            sub: 600
+        },
+        body: {
+            family: 'Barlow',
+            category: 'sans-serif',
+            weights: [
+                400,
+                500,
+                600,
+                700
+            ]
+        },
+        caps: true,
+        tracking: 0.01
+    },
+    {
+        id: 'anton',
+        feel: 'loud poster display',
+        heading: {
+            family: 'Anton',
+            category: 'sans-serif',
+            weight: 400,
+            sub: 400
+        },
+        body: {
+            family: 'Inter',
+            category: 'sans-serif',
+            weights: [
+                400,
+                500,
+                600,
+                700
+            ]
+        },
+        caps: true,
+        tracking: 0.01
+    },
+    {
+        id: 'nunito',
+        feel: 'rounded, approachable sans',
+        heading: {
+            family: 'Nunito',
+            category: 'sans-serif',
+            weight: 800,
+            sub: 700
+        },
+        body: {
+            family: 'Nunito Sans',
+            category: 'sans-serif',
+            weights: [
+                400,
+                600,
+                700
+            ]
+        }
+    },
+    {
+        id: 'quicksand',
+        feel: 'soft, airy rounded sans',
+        heading: {
+            family: 'Quicksand',
+            category: 'sans-serif',
+            weight: 700,
+            sub: 600
+        },
+        body: {
+            family: 'Nunito Sans',
+            category: 'sans-serif',
+            weights: [
+                400,
+                600,
+                700
+            ]
+        }
+    },
+    {
+        id: 'manrope',
+        feel: 'crisp, confident sans',
+        heading: {
+            family: 'Manrope',
+            category: 'sans-serif',
+            weight: 800,
+            sub: 700
+        },
+        body: {
+            family: 'Manrope',
+            category: 'sans-serif',
+            weights: [
+                400,
+                500,
+                600,
+                700
+            ]
+        },
+        tracking: -0.02
+    },
+    {
+        id: 'outfit',
+        feel: 'geometric, upbeat sans',
+        heading: {
+            family: 'Outfit',
+            category: 'sans-serif',
+            weight: 700,
+            sub: 600
+        },
+        body: {
+            family: 'Outfit',
+            category: 'sans-serif',
+            weights: [
+                400,
+                500,
+                600,
+                700
+            ]
+        },
+        tracking: -0.02
+    },
+    {
+        id: 'plex',
+        feel: 'technical, engineered sans',
+        heading: {
+            family: 'IBM Plex Sans',
+            category: 'sans-serif',
+            weight: 600,
+            sub: 600
+        },
+        body: {
+            family: 'IBM Plex Sans',
+            category: 'sans-serif',
+            weights: [
+                400,
+                500,
+                600,
+                700
+            ]
+        },
+        tracking: -0.01
+    }
+];
+/** A pairing by id, or `null`. */ export function siteFontPairing(id) {
+    var _SITE_FONT_PAIRINGS_find;
+    if (typeof id !== 'string' || !id) return null;
+    return (_SITE_FONT_PAIRINGS_find = SITE_FONT_PAIRINGS.find((pairing)=>pairing.id === id)) != null ? _SITE_FONT_PAIRINGS_find : null;
+}
+
+//# sourceMappingURL=site-font-pairings.js.map

package/src/lib/app-utils/site-font-pairings.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/site-font-pairings.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * The font pairings a site's look is chosen from (AGL-4049): a heading family\n * over a body family, each with the weights it loads.\n *\n * The platform's, not one plugin's: the AI site start picks among them for a\n * business's own look, and a site starter names the one it was designed in\n * (`site-starter.ts`), so a starter and a generated site speak one list.\n * Moved here from the AI plugin's `ai-site-kinds.ts`, which re-exports it\n * under its old names.\n *\n * Pure data, safe for any surface to import.\n */\n\n/** A font pairing a look may choose: a heading family over a body family. */\nexport interface SiteFontPairing {\n  id: string\n  /** What the pairing reads like, as the model is told. */\n  feel: string\n  heading: { family: string; category: 'sans-serif' | 'serif'; weight: number; sub: number }\n  body: { family: string; category: 'sans-serif' | 'serif'; weights: number[] }\n  /** Letter spacing the headings carry, in em. */\n  tracking?: number\n  /** Headings set in capitals: a condensed display face. */\n  caps?: boolean\n}\n\n/**\n * The pairings, every family from the Google Fonts catalog the fonts plugin\n * serves (`google-fonts.catalog.json`) and every weight one that family\n * has — the AI plugin's `ai-site-look.spec.ts` holds both. The tenant loads\n * them the way it loads the starter theme's family, so nothing here adds a\n * font host.\n */\nexport const SITE_FONT_PAIRINGS: readonly SiteFontPairing[] = [\n  { id: 'jakarta', feel: 'modern, friendly sans', heading: { family: 'Plus Jakarta Sans', category: 'sans-serif', weight: 800, sub: 700 }, body: { family: 'Plus Jakarta Sans', category: 'sans-serif', weights: [400, 500, 600, 700] }, tracking: -0.02 },\n  { id: 'inter', feel: 'neutral, precise sans', heading: { family: 'Inter', category: 'sans-serif', weight: 700, sub: 600 }, body: { family: 'Inter', category: 'sans-serif', weights: [400, 500, 600, 700] }, tracking: -0.025 },\n  { id: 'grotesk', feel: 'designer grotesk', heading: { family: 'Space Grotesk', category: 'sans-serif', weight: 600, sub: 600 }, body: { family: 'Inter', category: 'sans-serif', weights: [400, 500, 600, 700] }, tracking: -0.03 },\n  { id: 'syne', feel: 'expressive, art-school display', heading: { family: 'Syne', category: 'sans-serif', weight: 700, sub: 600 }, body: { family: 'Inter', category: 'sans-serif', weights: [400, 500, 600, 700] }, tracking: -0.02 },\n  { id: 'bricolage', feel: 'contemporary, characterful sans', heading: { family: 'Bricolage Grotesque', category: 'sans-serif', weight: 700, sub: 600 }, body: { family: 'DM Sans', category: 'sans-serif', weights: [400, 500, 600, 700] }, tracking: -0.025 },\n  { id: 'editorial', feel: 'editorial serif over clean sans', heading: { family: 'Playfair Display', category: 'serif', weight: 700, sub: 600 }, body: { family: 'Source Sans 3', category: 'sans-serif', weights: [400, 500, 600, 700] }, tracking: -0.01 },\n  { id: 'fraunces', feel: 'warm, soft serif', heading: { family: 'Fraunces', category: 'serif', weight: 600, sub: 600 }, body: { family: 'Inter', category: 'sans-serif', weights: [400, 500, 600, 700] }, tracking: -0.015 },\n  { id: 'instrument', feel: 'elegant, light serif headlines', heading: { family: 'Instrument Serif', category: 'serif', weight: 400, sub: 400 }, body: { family: 'Inter', category: 'sans-serif', weights: [400, 500, 600, 700] }, tracking: -0.01 },\n  { id: 'reading', feel: 'reading-first serif, serif body', heading: { family: 'Newsreader', category: 'serif', weight: 600, sub: 600 }, body: { family: 'Source Serif 4', category: 'serif', weights: [400, 600, 700] }, tracking: -0.01 },\n  { id: 'garamond', feel: 'refined, classic serif', heading: { family: 'Cormorant Garamond', category: 'serif', weight: 600, sub: 600 }, body: { family: 'Montserrat', category: 'sans-serif', weights: [400, 500, 600, 700] } },\n  { id: 'baskerville', feel: 'established, trustworthy serif', heading: { family: 'Libre Baskerville', category: 'serif', weight: 700, sub: 700 }, body: { family: 'Source Sans 3', category: 'sans-serif', weights: [400, 500, 600, 700] } },\n  { id: 'merriweather', feel: 'sturdy, readable serif', heading: { family: 'Merriweather', category: 'serif', weight: 700, sub: 700 }, body: { family: 'Lato', category: 'sans-serif', weights: [400, 700] } },\n  { id: 'lora', feel: 'gentle, calm serif', heading: { family: 'Lora', category: 'serif', weight: 600, sub: 600 }, body: { family: 'Open Sans', category: 'sans-serif', weights: [400, 500, 600, 700] } },\n  { id: 'dmserif', feel: 'polished display serif', heading: { family: 'DM Serif Display', category: 'serif', weight: 400, sub: 400 }, body: { family: 'DM Sans', category: 'sans-serif', weights: [400, 500, 600, 700] } },\n  { id: 'oswald', feel: 'bold, condensed, workmanlike', heading: { family: 'Oswald', category: 'sans-serif', weight: 600, sub: 500 }, body: { family: 'Roboto', category: 'sans-serif', weights: [400, 500, 700] }, caps: true, tracking: 0.01 },\n  { id: 'archivo', feel: 'heavy, high-impact sans', heading: { family: 'Archivo Black', category: 'sans-serif', weight: 400, sub: 400 }, body: { family: 'Archivo', category: 'sans-serif', weights: [400, 500, 600, 700] }, tracking: -0.01 },\n  { id: 'barlow', feel: 'athletic, condensed sans', heading: { family: 'Barlow Condensed', category: 'sans-serif', weight: 700, sub: 600 }, body: { family: 'Barlow', category: 'sans-serif', weights: [400, 500, 600, 700] }, caps: true, tracking: 0.01 },\n  { id: 'anton', feel: 'loud poster display', heading: { family: 'Anton', category: 'sans-serif', weight: 400, sub: 400 }, body: { family: 'Inter', category: 'sans-serif', weights: [400, 500, 600, 700] }, caps: true, tracking: 0.01 },\n  { id: 'nunito', feel: 'rounded, approachable sans', heading: { family: 'Nunito', category: 'sans-serif', weight: 800, sub: 700 }, body: { family: 'Nunito Sans', category: 'sans-serif', weights: [400, 600, 700] } },\n  { id: 'quicksand', feel: 'soft, airy rounded sans', heading: { family: 'Quicksand', category: 'sans-serif', weight: 700, sub: 600 }, body: { family: 'Nunito Sans', category: 'sans-serif', weights: [400, 600, 700] } },\n  { id: 'manrope', feel: 'crisp, confident sans', heading: { family: 'Manrope', category: 'sans-serif', weight: 800, sub: 700 }, body: { family: 'Manrope', category: 'sans-serif', weights: [400, 500, 600, 700] }, tracking: -0.02 },\n  { id: 'outfit', feel: 'geometric, upbeat sans', heading: { family: 'Outfit', category: 'sans-serif', weight: 700, sub: 600 }, body: { family: 'Outfit', category: 'sans-serif', weights: [400, 500, 600, 700] }, tracking: -0.02 },\n  { id: 'plex', feel: 'technical, engineered sans', heading: { family: 'IBM Plex Sans', category: 'sans-serif', weight: 600, sub: 600 }, body: { family: 'IBM Plex Sans', category: 'sans-serif', weights: [400, 500, 600, 700] }, tracking: -0.01 },\n\n]\n\n/** A pairing by id, or `null`. */\nexport function siteFontPairing(id: unknown): SiteFontPairing | null {\n  if (typeof id !== 'string' || !id) return null\n  return SITE_FONT_PAIRINGS.find((pairing) => pairing.id === id) ?? null\n}\n"],"names":["SITE_FONT_PAIRINGS","id","feel","heading","family","category","weight","sub","body","weights","tracking","caps","siteFontPairing","find","pairing"],"mappings":"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"}

package/src/lib/app-utils/site-starter.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 { HostTheme } from '@aglyn/shared-data-types';
+/**
+ * Site starters (AGL-4049): a whole site a person picks before it exists,
+ * every one of them a listing anyone may publish and price, the platform's own
+ * included.
+ *
+ * This module is the vocabulary every reader of a starter shares: the artifact
+ * type it is listed under, the facets a search filters on (stamped on the
+ * listing as plain fields, so a query can match them), the payload a resolved
+ * starter hands the site it creates, and the one check that payload must pass.
+ * Who stores starters and how they are bought is the starter source's business
+ * (`plugin-manager/plugin-site-starters.ts`); nothing here reads or writes.
+ *
+ * Pure data and readers, safe for any surface to import.
+ */
+/** The artifact type a site starter is listed and installed under (AGL-4049). */
+export declare const SITE_STARTER_ARTIFACT_TYPE: "siteStarter";
+/**
+ * How a starter fills the site it creates: `base` copies its pages as they
+ * are; `ai` hands them to the AI site start with the answers it asks for, so
+ * the pages are rewritten for the business.
+ */
+export type SiteStarterMode = 'base' | 'ai';
+/**
+ * The platform's built-in themes a site's look is layered on (AGL-3497,
+ * AGL-4049), by the short name of the themes plugin's preset id
+ * (`theme-presets.<name>`), and `starter`: the theme a new site is born with.
+ * A starter on a built-in theme names one of these; the AI site start picks
+ * among the same list.
+ */
+export declare const SITE_THEME_BASES: readonly ["starter", "material-ui", "bootstrap", "minimal", "material3", "ant-design", "fluent", "carbon", "cupertino"];
+export type SiteThemeBase = (typeof SITE_THEME_BASES)[number];
+/** Whether a value names one of the {@link SITE_THEME_BASES}. */
+export declare function isSiteThemeBase(value: unknown): value is SiteThemeBase;
+/**
+ * A starter's theme (AGL-4049), one of two shapes: a built-in theme with the
+ * starter's brand colors and font pairing over it, which is how a person's own
+ * pick and edits are stored, or a full theme of its author's own.
+ */
+export type SiteStarterTheme = {
+    kind: 'builtin';
+    /** One of the {@link SITE_THEME_BASES}. */
+    base: string;
+    /** Palette overrides by scheme, as the theme editor stores them. */
+    brand: {
+        light: Record<string, string>;
+        dark?: Record<string, string>;
+    };
+    /** A font pairing id (`site-font-pairings.ts`), or `null` for the base theme's own fonts. */
+    fonts: string | null;
+} | {
+    kind: 'full';
+    theme: HostTheme;
+};
+/**
+ * What a starter search filters on (AGL-4049). `kind` is the kind of site it
+ * is, an id the core does not interpret (the AI plugin keeps the kinds),
+ * `base` a {@link SITE_THEME_BASES} name and `fonts` a font pairing id
+ * (`site-font-pairings.ts`), each `null` where the starter names none;
+ * `pages` is how many pages it creates.
+ */
+export interface SiteStarterFacets {
+    kind: string | null;
+    base: string | null;
+    fonts: string | null;
+    pages: number;
+    mode: SiteStarterMode;
+}
+/** A person's pick: the listing, and the version when one is pinned. */
+export interface SiteStarterChoice {
+    listingId: string;
+    version?: string;
+}
+/** What a resolved starter hands the site it creates (AGL-4049). */
+export interface SiteStarterPayload {
+    mode: SiteStarterMode;
+    facets: SiteStarterFacets;
+    theme: SiteStarterTheme;
+    /**
+     * The starter's pages, each carrying its routing `slug` as a starter
+     * template's screens do: `'/'` is the home page, and a page without one is
+     * unpublished.
+     */
+    screens: unknown[];
+    /** The shared layout every page sits in: the header and footer. */
+    layout: unknown | null;
+    /** The questions an `ai` starter asks before the site job runs; required for `ai`. */
+    answers?: Record<string, unknown>;
+}
+/** The most pages one starter may create. */
+export declare const SITE_STARTER_MAX_SCREENS = 25;
+/**
+ * A listing's starter facets, read defensively from the fields
+ * {@link siteStarterFacetFields} stamps: a missing or malformed field reads as
+ * none, a page count as a whole number from zero, and a mode as `base` unless
+ * it says `ai`.
+ */
+export declare function siteStarterFacetsOf(doc: Record<string, unknown>): SiteStarterFacets;
+/** The listing fields a starter's publish stamps, the inverse of {@link siteStarterFacetsOf}. */
+export declare function siteStarterFacetFields(facets: SiteStarterFacets): Record<string, unknown>;
+/** Whether a starter's facets meet a filter: every facet the filter names, equal; an absent one, any. */
+export declare function matchSiteStarterFacets(facets: SiteStarterFacets, filter: Partial<SiteStarterFacets>): boolean;
+/**
+ * The ids a caller knows, by facet. `siteStarterRefusal` checks a kind, base
+ * or font pairing id only against the set its caller passes: the core keeps
+ * no list of kinds, and which bases and pairings are offered is the caller's
+ * to say (`new Set(SITE_THEME_BASES)`, the ids of `SITE_FONT_PAIRINGS`).
+ */
+export interface SiteStarterKnownIds {
+    kinds?: ReadonlySet<string>;
+    bases?: ReadonlySet<string>;
+    fonts?: ReadonlySet<string>;
+}
+/**
+ * Why a starter's payload cannot start a site, in the words its author is
+ * told, or `null` when it can (AGL-4049). Checked when a starter is published
+ * and again when one is resolved, since a site is created from it with no
+ * step between to catch what is missing.
+ */
+export declare function siteStarterRefusal(payload: SiteStarterPayload, known?: SiteStarterKnownIds): string | null;