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

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

@@ -0,0 +1,116 @@
+/**
+ * @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 { SCREEN_ROOT_PATH } from "./screen-slug.js";
+/**
+ * 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 const SITE_STARTER_ARTIFACT_TYPE = 'siteStarter';
+/**
+ * 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 const SITE_THEME_BASES = [
+    'starter',
+    'material-ui',
+    'bootstrap',
+    'minimal',
+    'material3',
+    'ant-design',
+    'fluent',
+    'carbon',
+    'cupertino'
+];
+/** Whether a value names one of the {@link SITE_THEME_BASES}. */ export function isSiteThemeBase(value) {
+    return typeof value === 'string' && SITE_THEME_BASES.includes(value);
+}
+/** The most pages one starter may create. */ export const SITE_STARTER_MAX_SCREENS = 25;
+const isRecord = (value)=>!!value && typeof value === 'object' && !Array.isArray(value);
+const facetString = (value)=>typeof value === 'string' && value.trim() ? value.trim() : null;
+/**
+ * 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 function siteStarterFacetsOf(doc) {
+    const pages = doc['starterPages'];
+    return {
+        kind: facetString(doc['starterKind']),
+        base: facetString(doc['starterBase']),
+        fonts: facetString(doc['starterFonts']),
+        pages: typeof pages === 'number' && Number.isFinite(pages) && pages > 0 ? Math.floor(pages) : 0,
+        mode: doc['starterMode'] === 'ai' ? 'ai' : 'base'
+    };
+}
+/** The listing fields a starter's publish stamps, the inverse of {@link siteStarterFacetsOf}. */ export function siteStarterFacetFields(facets) {
+    return {
+        starterKind: facets.kind,
+        starterBase: facets.base,
+        starterFonts: facets.fonts,
+        starterPages: facets.pages,
+        starterMode: facets.mode
+    };
+}
+const FACET_KEYS = [
+    'kind',
+    'base',
+    'fonts',
+    'pages',
+    'mode'
+];
+/** Whether a starter's facets meet a filter: every facet the filter names, equal; an absent one, any. */ export function matchSiteStarterFacets(facets, filter) {
+    return FACET_KEYS.every((key)=>filter[key] === undefined || facets[key] === filter[key]);
+}
+/** Whether a page is the published home page: routed at the site root and not marked unpublished. */ const isPublishedHome = (screen)=>isRecord(screen) && screen['slug'] === SCREEN_ROOT_PATH && screen['published'] !== false;
+/**
+ * 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 function siteStarterRefusal(payload, known = {}) {
+    const screens = Array.isArray(payload.screens) ? payload.screens : [];
+    if (!screens.some(isPublishedHome)) return 'A starter needs a published Home page at /';
+    if (!isRecord(payload.layout)) return 'A starter needs a shared layout';
+    if (screens.length > SITE_STARTER_MAX_SCREENS) {
+        return `A starter can have at most ${SITE_STARTER_MAX_SCREENS} pages`;
+    }
+    const unknown = (id, ids)=>id !== null && ids !== undefined && !ids.has(id);
+    const { facets, theme } = payload;
+    if (unknown(facets.kind, known.kinds)) return `Unknown site kind "${facets.kind}"`;
+    if (unknown(facets.base, known.bases)) return `Unknown base theme "${facets.base}"`;
+    if (unknown(facets.fonts, known.fonts)) return `Unknown font pairing "${facets.fonts}"`;
+    if ((theme == null ? void 0 : theme.kind) === 'builtin') {
+        if (unknown(theme.base, known.bases)) return `Unknown base theme "${theme.base}"`;
+        if (unknown(theme.fonts, known.fonts)) return `Unknown font pairing "${theme.fonts}"`;
+    }
+    if (payload.mode === 'ai' && !isRecord(payload.answers)) {
+        return 'An AI starter needs the questions it asks';
+    }
+    return null;
+}
+
+//# sourceMappingURL=site-starter.js.map

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

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

package/src/lib/plugin-manager/feature-plugins.d.ts

@@ -19,9 +19,11 @@ import type { OrgPermissions } from '../app-utils/org-permissions';
 import type { ReleaseFlagKey } from '../app-utils/release-flags';
 import type { SeoAuditReport } from '../app-utils/seo-audit';
 import type { SeoListingFieldKey } from '../app-utils/seo-listing-fields';
+import type { SiteStarterFacets, SiteStarterMode } from '../app-utils/site-starter';
 import type { AglynOrgBilling, OrgFeatureFlags } from '../foundation';
 import type { ComponentSchema, MdiIconProps, PresetSchema } from '../types/nodes';
 import type { Plugin, PluginId } from './plugin-manager';
+import type { SiteStarterSummary } from './plugin-site-starters';
 import type { HostThemeSource } from '../app-utils/site-theme';
 import type { HostTheme, HostThemeScheme } from '@aglyn/shared-data-types';
 import type { ComponentType, ReactNode } from 'react';
@@ -800,6 +802,19 @@ export declare const CONSOLE_WIDGET_SLOTS: {
      * gets the shell's plain name-and-address dialog instead.
      */
     readonly hostFirstRun: "hostFirstRun";
+    /**
+     * The starter picker inside "Start your site" (AGL-4049), drawn before the
+     * site exists. Props: {@link ConsoleHostStarterPickerZoneProps} — the
+     * workspace, how the site will be filled, the person's search and filter,
+     * `onPick` and `ready`.
+     *
+     * A pick is required: there is no Skip, and the listing the platform starts
+     * a site from by default comes first. A widget here lists and picks and
+     * creates nothing; the site is created by the dialog from the starter it was
+     * handed. Not a staff zone and not host-gated: the widget's own extension
+     * gates it, as on any other zone.
+     */
+    readonly hostStarterPicker: "hostStarterPicker";
     /**
      * The host setup Theme section, between the Theme picker and the editor
      * (AGL-2938). Props: {@link ConsoleHostThemeZoneProps} — the
@@ -1512,6 +1527,23 @@ export interface ConsoleArtifactPublishZoneProps {
     /** Closes it, however it was closed — cancelled, published, or refused. */
     onClose: () => void;
 }
+/** What the `hostStarterPicker` zone hands each widget (AGL-4049). */
+export interface ConsoleHostStarterPickerZoneProps {
+    /** The org the site will belong to; `undefined` while it resolves. */
+    orgId: string | undefined;
+    /** Path slug for building `/[orgSlug]/…` links. */
+    orgSlug: string;
+    /** How the site will be filled: its pages as they are, or by the AI site start. */
+    mode: SiteStarterMode;
+    /** The person's search words, as typed. */
+    search: string;
+    /** The facets the person narrowed to; an absent one is any. */
+    filter: Partial<SiteStarterFacets>;
+    /** Hands the dialog the starter the person picked. */
+    onPick: (pick: SiteStarterSummary) => void;
+    /** Reports whether the widget drew a picker; `false` gives the dialog its own default. */
+    ready: (shown: boolean) => void;
+}
 /** What the `hostTheme` zone hands each widget (AGL-2938). */
 export interface ConsoleHostThemeZoneProps {
     hostId: string;

package/src/lib/plugin-manager/feature-plugins.js

@@ -295,6 +295,18 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
    * gets the shell's plain name-and-address dialog instead.
    */ hostFirstRun: 'hostFirstRun',
     /**
+   * The starter picker inside "Start your site" (AGL-4049), drawn before the
+   * site exists. Props: {@link ConsoleHostStarterPickerZoneProps} — the
+   * workspace, how the site will be filled, the person's search and filter,
+   * `onPick` and `ready`.
+   *
+   * A pick is required: there is no Skip, and the listing the platform starts
+   * a site from by default comes first. A widget here lists and picks and
+   * creates nothing; the site is created by the dialog from the starter it was
+   * handed. Not a staff zone and not host-gated: the widget's own extension
+   * gates it, as on any other zone.
+   */ hostStarterPicker: 'hostStarterPicker',
+    /**
    * The host setup Theme section, between the Theme picker and the editor
    * (AGL-2938). Props: {@link ConsoleHostThemeZoneProps} — the
    * site, the theme the editor shows, where that theme came from, the