@aglyn/plugins-ai 1.0.0-beta.263 → 1.0.0-beta.266

package/src/lib/components/ai-site-start-steps.component.js

@@ -0,0 +1,451 @@
+/**
+ * @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.
+ */ 'use client';
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { pluginDocsHelp } from "@aglyn/aglyn/app-utils/docs-help";
+import { mdiBookOpenPageVariant, mdiBriefcaseOutline, mdiCalendarHeart, mdiCreation, mdiHandHeart, mdiScaleBalance, mdiShopping, mdiSilverwareForkKnife, mdiViewGridOutline, mdiWrench } from "@aglyn/shared-data-mdi";
+import { HelpTip } from "@aglyn/shared-ui-jsx";
+import { OptionCardGrid } from "@aglyn/shared-ui-jsx/components/option-card-grid.component";
+import { Box, Button, Divider, LinearProgress, MenuItem, Stack, Step, StepLabel, Stepper, TextField, Typography } from "@mui/material";
+import { Fragment } from "react";
+import { AI_SITE_FREE_PAGES_NOTE, AI_SITE_SUBMISSION_CHOICES } from "../model/ai-site-job.js";
+import { AI_SITE_KINDS } from "../model/ai-site-kinds.js";
+import { AI_SITE_START_TYPES, aiSiteStartKind } from "../model/ai-site-start.js";
+import { AI_SITE_START_STEP_LABELS, AI_SITE_START_STEPS, aiSiteStartStepIndex } from "../model/ai-site-start-steps.js";
+import { aiSiteStylePreview } from "./ai-site-style-previews.js";
+/**
+ * The guided start's question steps (AGL-3898), one decision each. Each step
+ * draws its own answers and writes them through `answer`, exactly the patch
+ * the single form wrote, so the answers object is the same whichever way it
+ * was filled in. The dialog around them (`ai-site-start-card.component.tsx`)
+ * owns the step, Back and Next, validation and the job.
+ */ /** Each part of the guided start links its own section of the Start with AI guide (AGL-3660). */ export const START_STEP_HELP = {
+    kind: pluginDocsHelp('aiStart', {
+        anchor: '#your-business',
+        excerpt: 'What kind of site it is picks its style and pages; who it is for is who every page and the contact form are written for.'
+    }),
+    audience: pluginDocsHelp('aiStart', {
+        anchor: '#audience',
+        excerpt: 'Who the site is for is who every page, every search listing and the contact form are written for. Optional.'
+    }),
+    review: pluginDocsHelp('aiStart', {
+        anchor: '#review',
+        excerpt: 'Every answer, each with Edit to change it. Plan my site creates the site, plans it, writes the pages and publishes it.'
+    }),
+    style: pluginDocsHelp('aiSiteLooks', {
+        anchor: '#choose-a-style',
+        excerpt: 'The style decides the look — theme, colors, fonts, buttons — and which pages the site usually has. Every site gets its own variation.'
+    }),
+    details: pluginDocsHelp('aiStart', {
+        anchor: '#details',
+        excerpt: 'Where contact form messages go, how many pages to write, and on paid plans whether to draft a welcome email. All can be changed later.'
+    })
+};
+/** The icon on each kind-of-site card: the icon of the style that answer picks. */ const START_TYPE_ICONS = {
+    'a local service business': mdiBriefcaseOutline.path,
+    'a restaurant or cafe': mdiSilverwareForkKnife.path,
+    'a professional practice': mdiScaleBalance.path,
+    'a trades business': mdiWrench.path,
+    'a shop': mdiShopping.path,
+    'a nonprofit': mdiHandHeart.path,
+    'a personal portfolio': mdiViewGridOutline.path,
+    'an event': mdiCalendarHeart.path
+};
+/** "a restaurant or cafe" as a card title: "Restaurant or cafe". The answer itself keeps its words. */ export function startTypeTitle(type) {
+    const words = type.replace(/^(a|an)\s+/i, '');
+    return words.charAt(0).toUpperCase() + words.slice(1);
+}
+/** The id the style grid gives "Pick for me", which is no kind: the answers' `kind: null`. */ export const AI_SITE_STYLE_AUTO = 'auto';
+/** The progress through the steps: labeled steps on a wide screen, a bar and "Step 3 of 6" on a phone. */ export function StartProgress({ step, compact }) {
+    const index = aiSiteStartStepIndex(step);
+    const count = AI_SITE_START_STEPS.length;
+    const name = `Step ${index + 1} of ${count}`;
+    if (compact) {
+        return /*#__PURE__*/ _jsxs(Stack, {
+            spacing: 1,
+            "data-start-area": "progress",
+            role: "group",
+            "aria-label": name,
+            children: [
+                /*#__PURE__*/ _jsx(Typography, {
+                    variant: "caption",
+                    color: "text.secondary",
+                    children: `${name}: ${AI_SITE_START_STEP_LABELS[step]}`
+                }),
+                /*#__PURE__*/ _jsx(LinearProgress, {
+                    variant: "determinate",
+                    value: (index + 1) / count * 100,
+                    "aria-hidden": true
+                })
+            ]
+        });
+    }
+    return /*#__PURE__*/ _jsx(Stepper, {
+        activeStep: index,
+        alternativeLabel: true,
+        "aria-label": name,
+        "data-start-area": "progress",
+        children: AI_SITE_START_STEPS.map((id)=>/*#__PURE__*/ _jsx(Step, {
+                children: /*#__PURE__*/ _jsx(StepLabel, {
+                    children: AI_SITE_START_STEP_LABELS[id]
+                })
+            }, id))
+    });
+}
+/** A text answer's tracking: each change, and leaving the field, which ends one edit. */ const typed = (tracker, field)=>({
+        onBlur: ()=>tracker.fieldLeft(field)
+    });
+/** Step: what kind of site it is — the one required answer — typed, or picked from cards. */ export function KindStep({ answers, answer, tracker, errors, fieldRef }) {
+    var _ref;
+    var _errors_siteType;
+    const picked = AI_SITE_START_TYPES.includes(answers.siteType) ? answers.siteType : null;
+    return /*#__PURE__*/ _jsxs(Stack, {
+        spacing: 3,
+        children: [
+            /*#__PURE__*/ _jsx(Box, {
+                "data-start-area": "field-siteType",
+                children: /*#__PURE__*/ _jsx(TextField, _extends({
+                    fullWidth: true,
+                    required: true,
+                    inputRef: fieldRef('siteType'),
+                    label: "What kind of site are you creating?",
+                    placeholder: "a neighborhood dog groomer that takes bookings",
+                    value: answers.siteType,
+                    onChange: (event)=>{
+                        answer({
+                            siteType: event.target.value
+                        });
+                        tracker.fieldChanged('siteType');
+                    }
+                }, typed(tracker, 'siteType'), {
+                    error: Boolean(errors.siteType),
+                    helperText: (_ref = (_errors_siteType = errors.siteType) == null ? void 0 : _errors_siteType.message) != null ? _ref : 'A few words is enough, or pick one below.'
+                }))
+            }),
+            /*#__PURE__*/ _jsxs(Stack, {
+                spacing: 1.5,
+                children: [
+                    /*#__PURE__*/ _jsx(Typography, {
+                        variant: "overline",
+                        color: "text.secondary",
+                        component: "h2",
+                        children: 'Or pick the closest'
+                    }),
+                    /*#__PURE__*/ _jsx(OptionCardGrid, {
+                        label: "Kind of site",
+                        "data-start-area": "kind-cards",
+                        columns: {
+                            xs: 2,
+                            sm: 2,
+                            md: 4
+                        },
+                        options: AI_SITE_START_TYPES.map((type)=>{
+                            var _START_TYPE_ICONS_type;
+                            return {
+                                id: type,
+                                title: startTypeTitle(type),
+                                icon: (_START_TYPE_ICONS_type = START_TYPE_ICONS[type]) != null ? _START_TYPE_ICONS_type : mdiBookOpenPageVariant.path
+                            };
+                        }),
+                        value: picked,
+                        onChange: (type)=>{
+                            answer({
+                                siteType: type
+                            });
+                            tracker.fieldPicked('siteType');
+                        }
+                    })
+                ]
+            })
+        ]
+    });
+}
+/** Step: who the site is for. Optional. */ export function AudienceStep({ answers, answer, tracker, errors, fieldRef }) {
+    var _ref;
+    var _errors_audience;
+    return /*#__PURE__*/ _jsx(Box, {
+        "data-start-area": "field-audience",
+        children: /*#__PURE__*/ _jsx(TextField, _extends({
+            fullWidth: true,
+            inputRef: fieldRef('audience'),
+            label: "Who is it for?",
+            placeholder: "local dog owners who want a regular groom booked online",
+            value: answers.audience,
+            onChange: (event)=>{
+                answer({
+                    audience: event.target.value
+                });
+                tracker.fieldChanged('audience');
+            }
+        }, typed(tracker, 'audience'), {
+            error: Boolean(errors.audience),
+            helperText: (_ref = (_errors_audience = errors.audience) == null ? void 0 : _errors_audience.message) != null ? _ref : 'Optional. It narrows who the pages are written for.'
+        }))
+    });
+}
+/**
+ * Step: the style, from cards that show it. "Pick for me" leaves the kind
+ * unset, which is what the single form's unpicked state was: the kind the
+ * first answer suggests is the one used, and the card says which.
+ */ export function StyleStep({ answers, answer, tracker }) {
+    var _answers_kind;
+    const suggested = aiSiteStartKind(_extends({}, answers, {
+        kind: null
+    }));
+    return /*#__PURE__*/ _jsx(OptionCardGrid, {
+        label: "Style of site",
+        "data-start-area": "style-cards",
+        columns: {
+            xs: 2,
+            sm: 2,
+            md: 3
+        },
+        options: [
+            {
+                id: AI_SITE_STYLE_AUTO,
+                title: 'Pick for me',
+                description: `From your answer: ${suggested.label}`,
+                icon: mdiCreation.path
+            },
+            ...AI_SITE_KINDS.map((kind)=>{
+                const image = aiSiteStylePreview(kind.id);
+                return _extends({
+                    id: kind.id,
+                    title: kind.label,
+                    description: kind.blurb
+                }, image ? {
+                    image
+                } : {});
+            })
+        ],
+        value: (_answers_kind = answers.kind) != null ? _answers_kind : AI_SITE_STYLE_AUTO,
+        onChange: (id)=>{
+            answer({
+                kind: id === AI_SITE_STYLE_AUTO ? null : id
+            });
+            tracker.fieldPicked('kind');
+        }
+    });
+}
+/** Step: where leads go, how many pages, and on a paid plan the welcome email. */ export function DetailsStep({ answers, answer, tracker, errors, fieldRef, freeTaste, band }) {
+    var _ref, _ref1;
+    var _errors_submissions, _errors_pages;
+    return /*#__PURE__*/ _jsxs(Stack, {
+        spacing: 3,
+        children: [
+            /*#__PURE__*/ _jsx(Box, {
+                "data-start-area": "field-submissions",
+                children: /*#__PURE__*/ _jsx(TextField, {
+                    select: true,
+                    fullWidth: true,
+                    inputRef: fieldRef('submissions'),
+                    label: "Where do form submissions go?",
+                    value: answers.submissions,
+                    onChange: (event)=>{
+                        answer({
+                            submissions: event.target.value
+                        });
+                        tracker.fieldPicked('submissions');
+                    },
+                    error: Boolean(errors.submissions),
+                    helperText: (_ref = (_errors_submissions = errors.submissions) == null ? void 0 : _errors_submissions.message) != null ? _ref : 'You can change this on the form itself afterwards.',
+                    children: AI_SITE_SUBMISSION_CHOICES.map((option)=>/*#__PURE__*/ _jsx(MenuItem, {
+                            value: option.id,
+                            children: `${option.label} — ${option.blurb}`
+                        }, option.id))
+                })
+            }),
+            /*#__PURE__*/ _jsxs(Stack, {
+                direction: {
+                    xs: 'column',
+                    sm: 'row'
+                },
+                spacing: 2,
+                children: [
+                    /*#__PURE__*/ _jsx(Box, {
+                        "data-start-area": "field-pages",
+                        sx: {
+                            flex: 1
+                        },
+                        children: /*#__PURE__*/ _jsx(TextField, {
+                            select: true,
+                            fullWidth: true,
+                            inputRef: fieldRef('pages'),
+                            label: "Pages",
+                            value: answers.pages,
+                            onChange: (event)=>{
+                                answer({
+                                    pages: Number(event.target.value)
+                                });
+                                tracker.fieldPicked('pages');
+                            },
+                            error: Boolean(errors.pages),
+                            helperText: (_ref1 = (_errors_pages = errors.pages) == null ? void 0 : _errors_pages.message) != null ? _ref1 : freeTaste ? AI_SITE_FREE_PAGES_NOTE : undefined,
+                            children: Array.from({
+                                length: band.max - band.min + 1
+                            }, (_, index)=>band.min + index).map((count)=>/*#__PURE__*/ _jsx(MenuItem, {
+                                    value: count,
+                                    children: count
+                                }, count))
+                        })
+                    }),
+                    !freeTaste && /*#__PURE__*/ _jsx(Box, {
+                        "data-start-area": "field-welcomeEmail",
+                        sx: {
+                            flex: 1
+                        },
+                        children: /*#__PURE__*/ _jsxs(TextField, {
+                            select: true,
+                            fullWidth: true,
+                            label: "Welcome email",
+                            value: answers.welcomeEmail ? 'yes' : 'no',
+                            onChange: (event)=>{
+                                answer({
+                                    welcomeEmail: event.target.value === 'yes'
+                                });
+                                tracker.fieldPicked('welcomeEmail');
+                            },
+                            children: [
+                                /*#__PURE__*/ _jsx(MenuItem, {
+                                    value: "yes",
+                                    children: 'Draft one'
+                                }),
+                                /*#__PURE__*/ _jsx(MenuItem, {
+                                    value: "no",
+                                    children: 'No'
+                                })
+                            ]
+                        })
+                    })
+                ]
+            })
+        ]
+    });
+}
+/** One answer on the review, with the way back to the step that asks it. */ function ReviewRow({ label, value, step, onEdit }) {
+    return /*#__PURE__*/ _jsxs(Stack, {
+        direction: "row",
+        spacing: 2,
+        sx: {
+            alignItems: 'flex-start',
+            py: 1.5
+        },
+        children: [
+            /*#__PURE__*/ _jsxs(Box, {
+                sx: {
+                    flex: 1,
+                    minWidth: 0
+                },
+                children: [
+                    /*#__PURE__*/ _jsx(Typography, {
+                        variant: "body2",
+                        color: "text.secondary",
+                        component: "dt",
+                        children: label
+                    }),
+                    /*#__PURE__*/ _jsx(Typography, {
+                        variant: "body1",
+                        component: "dd",
+                        sx: {
+                            m: 0,
+                            overflowWrap: 'anywhere'
+                        },
+                        children: value
+                    })
+                ]
+            }),
+            /*#__PURE__*/ _jsx(Button, {
+                size: "small",
+                onClick: ()=>onEdit(step),
+                "aria-label": `Edit ${label.toLowerCase()}`,
+                children: 'Edit'
+            })
+        ]
+    });
+}
+/** Step: every answer, each with Edit, before "Plan my site". */ export function ReviewStep({ answers, freeTaste, onEdit, children }) {
+    var _ref;
+    const kind = aiSiteStartKind(answers);
+    const submissions = AI_SITE_SUBMISSION_CHOICES.find((option)=>option.id === answers.submissions);
+    const rows = [
+        {
+            label: 'Kind of site',
+            value: answers.siteType.trim(),
+            step: 'kind'
+        },
+        {
+            label: 'Who it is for',
+            value: answers.audience.trim() || 'Anyone (not said)',
+            step: 'audience'
+        },
+        {
+            label: 'Style',
+            value: answers.kind ? kind.label : `${kind.label}, picked for you`,
+            step: 'style'
+        },
+        {
+            label: 'Form submissions',
+            value: (_ref = submissions == null ? void 0 : submissions.label) != null ? _ref : answers.submissions,
+            step: 'details'
+        },
+        {
+            label: 'Pages',
+            value: String(answers.pages),
+            step: 'details'
+        },
+        ...freeTaste ? [] : [
+            {
+                label: 'Welcome email',
+                value: answers.welcomeEmail ? 'Draft one' : 'No',
+                step: 'details'
+            }
+        ]
+    ];
+    return /*#__PURE__*/ _jsxs(Stack, {
+        spacing: 3,
+        children: [
+            /*#__PURE__*/ _jsx(Box, {
+                component: "dl",
+                "data-start-area": "review",
+                sx: {
+                    m: 0
+                },
+                children: rows.map((row, index)=>/*#__PURE__*/ _jsxs(Fragment, {
+                        children: [
+                            index > 0 && /*#__PURE__*/ _jsx(Divider, {
+                                component: "div"
+                            }),
+                            /*#__PURE__*/ _jsx(ReviewRow, _extends({}, row, {
+                                onEdit: onEdit
+                            }))
+                        ]
+                    }, row.label))
+            }),
+            children
+        ]
+    });
+}
+/** A step's help beside its heading. */ export function StepHelp({ step }) {
+    const help = step === 'choose' ? null : START_STEP_HELP[step];
+    return help ? /*#__PURE__*/ _jsx(HelpTip, _extends({
+        sx: {
+            float: 'right'
+        }
+    }, help)) : null;
+}
+
+//# sourceMappingURL=ai-site-start-steps.component.js.map

package/src/lib/components/ai-site-start-steps.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/ai-site-start-steps.component.tsx"],"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'use client'\n\nimport { pluginDocsHelp } from '@aglyn/aglyn/app-utils/docs-help'\nimport {\n  mdiBookOpenPageVariant,\n  mdiBriefcaseOutline,\n  mdiCalendarHeart,\n  mdiCreation,\n  mdiHandHeart,\n  mdiScaleBalance,\n  mdiShopping,\n  mdiSilverwareForkKnife,\n  mdiViewGridOutline,\n  mdiWrench,\n} from '@aglyn/shared-data-mdi'\nimport { HelpTip } from '@aglyn/shared-ui-jsx'\nimport { OptionCardGrid } from '@aglyn/shared-ui-jsx/components/option-card-grid.component'\nimport {\n  Box,\n  Button,\n  Divider,\n  LinearProgress,\n  MenuItem,\n  Stack,\n  Step,\n  StepLabel,\n  Stepper,\n  TextField,\n  Typography,\n} from '@mui/material'\nimport { Fragment, type ReactNode, type Ref } from 'react'\nimport { AI_SITE_FREE_PAGES_NOTE, AI_SITE_SUBMISSION_CHOICES, type AiSiteSubmissions } from '../model/ai-site-job'\nimport { AI_SITE_KINDS } from '../model/ai-site-kinds'\nimport { AI_SITE_START_TYPES, aiSiteStartKind, type AiSiteStartAnswers } from '../model/ai-site-start'\nimport {\n  AI_SITE_START_STEP_LABELS,\n  AI_SITE_START_STEPS,\n  aiSiteStartStepIndex,\n  type AiSiteStartField,\n  type AiSiteStartFieldError,\n  type AiSiteStartStep,\n} from '../model/ai-site-start-steps'\nimport type { AiSiteStartTracker } from './ai-site-start-tracking'\nimport { aiSiteStylePreview } from './ai-site-style-previews'\n\n/**\n * The guided start's question steps (AGL-3898), one decision each. Each step\n * draws its own answers and writes them through `answer`, exactly the patch\n * the single form wrote, so the answers object is the same whichever way it\n * was filled in. The dialog around them (`ai-site-start-card.component.tsx`)\n * owns the step, Back and Next, validation and the job.\n */\n\n/** Each part of the guided start links its own section of the Start with AI guide (AGL-3660). */\nexport const START_STEP_HELP = {\n  kind: pluginDocsHelp('aiStart', {\n    anchor: '#your-business',\n    excerpt:\n      'What kind of site it is picks its style and pages; who it is for is who every page and the contact form are written for.',\n  }),\n  audience: pluginDocsHelp('aiStart', {\n    anchor: '#audience',\n    excerpt: 'Who the site is for is who every page, every search listing and the contact form are written for. Optional.',\n  }),\n  review: pluginDocsHelp('aiStart', {\n    anchor: '#review',\n    excerpt: 'Every answer, each with Edit to change it. Plan my site creates the site, plans it, writes the pages and publishes it.',\n  }),\n  style: pluginDocsHelp('aiSiteLooks', {\n    anchor: '#choose-a-style',\n    excerpt:\n      'The style decides the look — theme, colors, fonts, buttons — and which pages the site usually has. Every site gets its own variation.',\n  }),\n  details: pluginDocsHelp('aiStart', {\n    anchor: '#details',\n    excerpt:\n      'Where contact form messages go, how many pages to write, and on paid plans whether to draft a welcome email. All can be changed later.',\n  }),\n}\n\n/** The icon on each kind-of-site card: the icon of the style that answer picks. */\nconst START_TYPE_ICONS: Readonly<Record<string, string>> = {\n  'a local service business': mdiBriefcaseOutline.path,\n  'a restaurant or cafe': mdiSilverwareForkKnife.path,\n  'a professional practice': mdiScaleBalance.path,\n  'a trades business': mdiWrench.path,\n  'a shop': mdiShopping.path,\n  'a nonprofit': mdiHandHeart.path,\n  'a personal portfolio': mdiViewGridOutline.path,\n  'an event': mdiCalendarHeart.path,\n}\n\n/** \"a restaurant or cafe\" as a card title: \"Restaurant or cafe\". The answer itself keeps its words. */\nexport function startTypeTitle(type: string): string {\n  const words = type.replace(/^(a|an)\\s+/i, '')\n  return words.charAt(0).toUpperCase() + words.slice(1)\n}\n\n/** The id the style grid gives \"Pick for me\", which is no kind: the answers' `kind: null`. */\nexport const AI_SITE_STYLE_AUTO = 'auto'\n\n/** The progress through the steps: labeled steps on a wide screen, a bar and \"Step 3 of 6\" on a phone. */\nexport function StartProgress({ step, compact }: { step: AiSiteStartStep; compact: boolean }) {\n  const index = aiSiteStartStepIndex(step)\n  const count = AI_SITE_START_STEPS.length\n  const name = `Step ${index + 1} of ${count}`\n  if (compact) {\n    return (\n      <Stack spacing={1} data-start-area=\"progress\" role=\"group\" aria-label={name}>\n        <Typography variant=\"caption\" color=\"text.secondary\">\n          {`${name}: ${AI_SITE_START_STEP_LABELS[step]}`}\n        </Typography>\n        <LinearProgress variant=\"determinate\" value={((index + 1) / count) * 100} aria-hidden />\n      </Stack>\n    )\n  }\n  return (\n    <Stepper activeStep={index} alternativeLabel aria-label={name} data-start-area=\"progress\">\n      {AI_SITE_START_STEPS.map((id) => (\n        <Step key={id}>\n          <StepLabel>{AI_SITE_START_STEP_LABELS[id]}</StepLabel>\n        </Step>\n      ))}\n    </Stepper>\n  )\n}\n\ninterface StepProps {\n  answers: AiSiteStartAnswers\n  answer: (patch: Partial<AiSiteStartAnswers>) => void\n  tracker: AiSiteStartTracker\n  /** Each field's reason not to go forward, once the person has tried to. */\n  errors: Partial<Record<AiSiteStartField, AiSiteStartFieldError>>\n  /** Where each field's input is, so a refused Next can put the cursor in it. */\n  fieldRef: (field: AiSiteStartField) => Ref<HTMLInputElement>\n}\n\n/** A text answer's tracking: each change, and leaving the field, which ends one edit. */\nconst typed = (tracker: AiSiteStartTracker, field: AiSiteStartField) => ({\n  onBlur: () => tracker.fieldLeft(field),\n})\n\n/** Step: what kind of site it is — the one required answer — typed, or picked from cards. */\nexport function KindStep({ answers, answer, tracker, errors, fieldRef }: StepProps) {\n  const picked = AI_SITE_START_TYPES.includes(answers.siteType) ? answers.siteType : null\n  return (\n    <Stack spacing={3}>\n      <Box data-start-area=\"field-siteType\">\n        <TextField\n          fullWidth\n          required\n          inputRef={fieldRef('siteType')}\n          label=\"What kind of site are you creating?\"\n          placeholder=\"a neighborhood dog groomer that takes bookings\"\n          value={answers.siteType}\n          onChange={(event) => {\n            answer({ siteType: event.target.value })\n            tracker.fieldChanged('siteType')\n          }}\n          {...typed(tracker, 'siteType')}\n          error={Boolean(errors.siteType)}\n          helperText={errors.siteType?.message ?? 'A few words is enough, or pick one below.'}\n        />\n      </Box>\n      <Stack spacing={1.5}>\n        <Typography variant=\"overline\" color=\"text.secondary\" component=\"h2\">\n          {'Or pick the closest'}\n        </Typography>\n        <OptionCardGrid\n          label=\"Kind of site\"\n          data-start-area=\"kind-cards\"\n          columns={{ xs: 2, sm: 2, md: 4 }}\n          options={AI_SITE_START_TYPES.map((type) => ({\n            id: type,\n            title: startTypeTitle(type),\n            icon: START_TYPE_ICONS[type] ?? mdiBookOpenPageVariant.path,\n          }))}\n          value={picked}\n          onChange={(type) => {\n            answer({ siteType: type })\n            tracker.fieldPicked('siteType')\n          }}\n        />\n      </Stack>\n    </Stack>\n  )\n}\n\n/** Step: who the site is for. Optional. */\nexport function AudienceStep({ answers, answer, tracker, errors, fieldRef }: StepProps) {\n  return (\n    <Box data-start-area=\"field-audience\">\n      <TextField\n        fullWidth\n        inputRef={fieldRef('audience')}\n        label=\"Who is it for?\"\n        placeholder=\"local dog owners who want a regular groom booked online\"\n        value={answers.audience}\n        onChange={(event) => {\n          answer({ audience: event.target.value })\n          tracker.fieldChanged('audience')\n        }}\n        {...typed(tracker, 'audience')}\n        error={Boolean(errors.audience)}\n        helperText={errors.audience?.message ?? 'Optional. It narrows who the pages are written for.'}\n      />\n    </Box>\n  )\n}\n\n/**\n * Step: the style, from cards that show it. \"Pick for me\" leaves the kind\n * unset, which is what the single form's unpicked state was: the kind the\n * first answer suggests is the one used, and the card says which.\n */\nexport function StyleStep({ answers, answer, tracker }: StepProps) {\n  const suggested = aiSiteStartKind({ ...answers, kind: null })\n  return (\n    <OptionCardGrid\n      label=\"Style of site\"\n      data-start-area=\"style-cards\"\n      columns={{ xs: 2, sm: 2, md: 3 }}\n      options={[\n        {\n          id: AI_SITE_STYLE_AUTO,\n          title: 'Pick for me',\n          description: `From your answer: ${suggested.label}`,\n          icon: mdiCreation.path,\n        },\n        ...AI_SITE_KINDS.map((kind) => {\n          const image = aiSiteStylePreview(kind.id)\n          return { id: kind.id, title: kind.label, description: kind.blurb, ...(image ? { image } : {}) }\n        }),\n      ]}\n      value={answers.kind ?? AI_SITE_STYLE_AUTO}\n      onChange={(id) => {\n        answer({ kind: id === AI_SITE_STYLE_AUTO ? null : id })\n        tracker.fieldPicked('kind')\n      }}\n    />\n  )\n}\n\n/** Step: where leads go, how many pages, and on a paid plan the welcome email. */\nexport function DetailsStep({\n  answers,\n  answer,\n  tracker,\n  errors,\n  fieldRef,\n  freeTaste,\n  band,\n}: StepProps & { freeTaste: boolean; band: { min: number; max: number } }) {\n  return (\n    <Stack spacing={3}>\n      {/*\n        The one setting a new site owner has to make, asked where they are\n        already answering: a contact form nobody routed files its messages\n        somewhere the person has not looked.\n      */}\n      <Box data-start-area=\"field-submissions\">\n        <TextField\n          select\n          fullWidth\n          inputRef={fieldRef('submissions')}\n          label=\"Where do form submissions go?\"\n          value={answers.submissions}\n          onChange={(event) => {\n            answer({ submissions: event.target.value as AiSiteSubmissions })\n            tracker.fieldPicked('submissions')\n          }}\n          error={Boolean(errors.submissions)}\n          helperText={errors.submissions?.message ?? 'You can change this on the form itself afterwards.'}\n        >\n          {AI_SITE_SUBMISSION_CHOICES.map((option) => (\n            <MenuItem key={option.id} value={option.id}>\n              {`${option.label} — ${option.blurb}`}\n            </MenuItem>\n          ))}\n        </TextField>\n      </Box>\n      <Stack direction={{ xs: 'column', sm: 'row' }} spacing={2}>\n        <Box data-start-area=\"field-pages\" sx={{ flex: 1 }}>\n          <TextField\n            select\n            fullWidth\n            inputRef={fieldRef('pages')}\n            label=\"Pages\"\n            value={answers.pages}\n            onChange={(event) => {\n              answer({ pages: Number(event.target.value) })\n              tracker.fieldPicked('pages')\n            }}\n            error={Boolean(errors.pages)}\n            helperText={errors.pages?.message ?? (freeTaste ? AI_SITE_FREE_PAGES_NOTE : undefined)}\n          >\n            {Array.from({ length: band.max - band.min + 1 }, (_, index) => band.min + index).map((count) => (\n              <MenuItem key={count} value={count}>\n                {count}\n              </MenuItem>\n            ))}\n          </TextField>\n        </Box>\n        {!freeTaste && (\n          <Box data-start-area=\"field-welcomeEmail\" sx={{ flex: 1 }}>\n            <TextField\n              select\n              fullWidth\n              label=\"Welcome email\"\n              value={answers.welcomeEmail ? 'yes' : 'no'}\n              onChange={(event) => {\n                answer({ welcomeEmail: event.target.value === 'yes' })\n                tracker.fieldPicked('welcomeEmail')\n              }}\n            >\n              <MenuItem value=\"yes\">{'Draft one'}</MenuItem>\n              <MenuItem value=\"no\">{'No'}</MenuItem>\n            </TextField>\n          </Box>\n        )}\n      </Stack>\n    </Stack>\n  )\n}\n\n/** One answer on the review, with the way back to the step that asks it. */\nfunction ReviewRow({ label, value, step, onEdit }: { label: string; value: ReactNode; step: AiSiteStartStep; onEdit: (step: AiSiteStartStep) => void }) {\n  return (\n    <Stack direction=\"row\" spacing={2} sx={{ alignItems: 'flex-start', py: 1.5 }}>\n      <Box sx={{ flex: 1, minWidth: 0 }}>\n        <Typography variant=\"body2\" color=\"text.secondary\" component=\"dt\">\n          {label}\n        </Typography>\n        <Typography variant=\"body1\" component=\"dd\" sx={{ m: 0, overflowWrap: 'anywhere' }}>\n          {value}\n        </Typography>\n      </Box>\n      <Button size=\"small\" onClick={() => onEdit(step)} aria-label={`Edit ${label.toLowerCase()}`}>\n        {'Edit'}\n      </Button>\n    </Stack>\n  )\n}\n\n/** Step: every answer, each with Edit, before \"Plan my site\". */\nexport function ReviewStep({\n  answers,\n  freeTaste,\n  onEdit,\n  children,\n}: {\n  answers: AiSiteStartAnswers\n  freeTaste: boolean\n  onEdit: (step: AiSiteStartStep) => void\n  children?: ReactNode\n}) {\n  const kind = aiSiteStartKind(answers)\n  const submissions = AI_SITE_SUBMISSION_CHOICES.find((option) => option.id === answers.submissions)\n  const rows: Array<{ label: string; value: ReactNode; step: AiSiteStartStep }> = [\n    { label: 'Kind of site', value: answers.siteType.trim(), step: 'kind' },\n    { label: 'Who it is for', value: answers.audience.trim() || 'Anyone (not said)', step: 'audience' },\n    { label: 'Style', value: answers.kind ? kind.label : `${kind.label}, picked for you`, step: 'style' },\n    { label: 'Form submissions', value: submissions?.label ?? answers.submissions, step: 'details' },\n    { label: 'Pages', value: String(answers.pages), step: 'details' },\n    ...(freeTaste ? [] : [{ label: 'Welcome email', value: answers.welcomeEmail ? 'Draft one' : 'No', step: 'details' as const }]),\n  ]\n  return (\n    <Stack spacing={3}>\n      <Box component=\"dl\" data-start-area=\"review\" sx={{ m: 0 }}>\n        {rows.map((row, index) => (\n          <Fragment key={row.label}>\n            {index > 0 && <Divider component=\"div\" />}\n            <ReviewRow {...row} onEdit={onEdit} />\n          </Fragment>\n        ))}\n      </Box>\n      {children}\n    </Stack>\n  )\n}\n\n/** A step's help beside its heading. */\nexport function StepHelp({ step }: { step: AiSiteStartStep }) {\n  const help = step === 'choose' ? null : START_STEP_HELP[step]\n  return help ? <HelpTip sx={{ float: 'right' }} {...help} /> : null\n}\n"],"names":["pluginDocsHelp","mdiBookOpenPageVariant","mdiBriefcaseOutline","mdiCalendarHeart","mdiCreation","mdiHandHeart","mdiScaleBalance","mdiShopping","mdiSilverwareForkKnife","mdiViewGridOutline","mdiWrench","HelpTip","OptionCardGrid","Box","Button","Divider","LinearProgress","MenuItem","Stack","Step","StepLabel","Stepper","TextField","Typography","Fragment","AI_SITE_FREE_PAGES_NOTE","AI_SITE_SUBMISSION_CHOICES","AI_SITE_KINDS","AI_SITE_START_TYPES","aiSiteStartKind","AI_SITE_START_STEP_LABELS","AI_SITE_START_STEPS","aiSiteStartStepIndex","aiSiteStylePreview","START_STEP_HELP","kind","anchor","excerpt","audience","review","style","details","START_TYPE_ICONS","path","startTypeTitle","type","words","replace","charAt","toUpperCase","slice","AI_SITE_STYLE_AUTO","StartProgress","step","compact","index","count","length","name","spacing","data-start-area","role","aria-label","variant","color","value","aria-hidden","activeStep","alternativeLabel","map","id","typed","tracker","field","onBlur","fieldLeft","KindStep","answers","answer","errors","fieldRef","picked","includes","siteType","fullWidth","required","inputRef","label","placeholder","onChange","event","target","fieldChanged","error","Boolean","helperText","message","component","columns","xs","sm","md","options","title","icon","fieldPicked","AudienceStep","StyleStep","suggested","description","image","blurb","DetailsStep","freeTaste","band","select","submissions","option","direction","sx","flex","pages","Number","undefined","Array","from","max","min","_","welcomeEmail","ReviewRow","onEdit","alignItems","py","minWidth","m","overflowWrap","size","onClick","toLowerCase","ReviewStep","children","find","rows","trim","String","row","StepHelp","help","float"],"mappings":"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"}

package/src/lib/components/ai-site-start-tracking.d.ts

@@ -0,0 +1,114 @@
+/**
+ * @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 AnalyticsEventName, type AnalyticsEventParams } from '@aglyn/aglyn/app-utils/analytics-events';
+import { type AiSiteStartErrorCode, type AiSiteStartField, type AiSiteStartStep } from '../model/ai-site-start-steps';
+/**
+ * Where people get lost in the guided start (AGL-3898), as the console's own
+ * product analytics: each step drawn, left forward or back and how long it
+ * took, the step the start was abandoned on, the field a step refused on,
+ * and the signs of a struggle — one field changed again and again, a step
+ * left idle, fast repeated clicks on one spot (rage) and clicks on parts of
+ * the form that do nothing (dead).
+ *
+ * Every event goes through `trackEvent`, the one door the console's GA4
+ * taxonomy has, so it is consent-gated exactly as every other console event
+ * is (`firebase-app.layout.tsx` registers the transport, or the refusal that
+ * drops it) and its params are sanitized there too. What is sent is only ever
+ * a step id, a field id, a closed error code, a closed area id, a count or a
+ * duration: never anything typed, picked or named.
+ *
+ * The detector is a plain object over a clock and a timer so its rules are
+ * tested with fake timers; {@link useAiSiteStartTracking} binds it to the
+ * dialog.
+ */
+/** No input on a step for this long is a struggle. */
+export declare const AI_SITE_START_IDLE_MS = 30000;
+/** This many clicks on one spot… */
+export declare const AI_SITE_START_RAGE_CLICKS = 3;
+/** …within this long… */
+export declare const AI_SITE_START_RAGE_WINDOW_MS = 700;
+/** …and within this distance of the first, is rage. */
+export declare const AI_SITE_START_RAGE_RADIUS_PX = 30;
+/** One field changed this many times is a struggle. */
+export declare const AI_SITE_START_STRUGGLE_EDITS = 3;
+/** At most this many dead clicks are reported on one visit to a step. */
+export declare const AI_SITE_START_DEAD_CLICKS_PER_STEP = 3;
+/** Why the start was left without a site started. */
+export type AiSiteStartAbandonReason = 'skip' | 'close' | 'unload' | 'route';
+type Send = <K extends AnalyticsEventName>(name: K, params: AnalyticsEventParams[K]) => void;
+export interface AiSiteStartTrackerOptions {
+    send?: Send;
+    now?: () => number;
+    /** Whether the page is out of sight, when an idle step is not a struggle. */
+    hidden?: () => boolean;
+}
+/** A click as the detector reads it: where, and what it landed on. */
+export interface AiSiteStartClick {
+    x: number;
+    y: number;
+    /** Whether it landed on something that acts on a click. */
+    interactive: boolean;
+    /** The closed id of the part of the form it landed in. */
+    area: string;
+}
+export interface AiSiteStartTracker {
+    /** A step was drawn. */
+    view(step: AiSiteStartStep): void;
+    /** The person went forward from the step on screen. */
+    complete(): void;
+    /** The person went back from the step on screen. */
+    back(): void;
+    /** A step refused to go forward on a field. */
+    fieldError(field: AiSiteStartField, code: AiSiteStartErrorCode): void;
+    /** A text answer changed; counted as one edit when the field is left. */
+    fieldChanged(field: AiSiteStartField): void;
+    /** A text answer was left. */
+    fieldLeft(field: AiSiteStartField): void;
+    /** A choice was picked, which is one edit. */
+    fieldPicked(field: AiSiteStartField): void;
+    /** Any input on the step, which puts off the idle signal. */
+    activity(): void;
+    /** A click anywhere in the dialog. */
+    click(click: AiSiteStartClick): void;
+    /** The start was left without a site started; reported once. */
+    abandon(reason: AiSiteStartAbandonReason): void;
+    /** A site was started (or the starter chosen): nothing after it is an abandonment. */
+    finish(): void;
+    /** Stops the idle timer. */
+    dispose(): void;
+}
+export declare function createAiSiteStartTracker(options?: AiSiteStartTrackerOptions): AiSiteStartTracker;
+/** The attribute naming the part of the form an element is in (a closed id, never content). */
+export declare const AI_SITE_START_AREA_ATTRIBUTE = "data-start-area";
+/** A DOM click, as the detector reads it. */
+export declare function aiSiteStartClickOf(event: {
+    clientX: number;
+    clientY: number;
+    target: EventTarget | null;
+}): AiSiteStartClick;
+/**
+ * The tracker for one open guided start: views each step as it is drawn, and
+ * reports the start abandoned when the tab goes away or the page changes
+ * under it. A start that is finished ({@link AiSiteStartTracker.finish}) or
+ * already abandoned reports nothing more.
+ *
+ * The unmount report waits a tick, so a development double mount (React's
+ * StrictMode runs an effect's cleanup and then the effect again) is not read
+ * as the person leaving.
+ */
+export declare function useAiSiteStartTracking(step: AiSiteStartStep | null, active: boolean): AiSiteStartTracker;
+export {};