@aglyn/plugins-ai 1.0.0-beta.143

package/src/lib/components/ai-site-seo-start-card.component.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @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 { ConsoleHostSeoZoneProps } from '@aglyn/aglyn/plugin-manager/feature-plugins';
+import { type AiSiteSeoProposal } from '../model/ai-site-start-seo';
+/**
+ * Whether the site's settings already say what the proposal says. Both values
+ * have to match: a site whose title was applied and whose description was
+ * then rewritten still has something to take.
+ */
+export declare function aiSiteSeoAlreadySaid(proposal: AiSiteSeoProposal, seo: Record<string, unknown> | undefined): boolean;
+export declare function AiSiteSeoStartCard({ hostId, orgId, seo, proposeDraft }: ConsoleHostSeoZoneProps): import("react").JSX.Element;
+export default AiSiteSeoStartCard;

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

@@ -0,0 +1,178 @@
+/**
+ * @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 { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { CardDisplay } from "@aglyn/shared-ui-jsx";
+import { authorizedFetch } from "@aglyn/shared-util-http/authorized-token";
+import { useUser } from "@aglyn/tenant-feature-instance";
+import { Alert, Button, Stack, Typography } from "@mui/material";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { AI_SITE_SEO_FORM_FIELDS, aiSiteSeoProposalOf } from "../model/ai-site-start-seo.js";
+/**
+ * The site's own search listing, from the guided start's answers (AGL-2918),
+ * on the site's SEO section through the `hostSeo` zone.
+ *
+ * The guided start asks what kind of site this is and who it is for. Those
+ * two answers are exactly the site-wide search title and description every
+ * page with none of its own falls back to, and until now they reached
+ * neither: a scaffolded site published its pages listed under whatever its
+ * creation seeded. The scaffold now carries the pair as an output of the
+ * `site` job (`aiSiteSeoProposal`), and this card is where a person reads it
+ * and puts it in the form.
+ *
+ * ── It writes nothing, and it asks for nothing ───────────────────────────
+ *
+ * "Put in the form" is the zone's own `proposeDraft`: the two values land in
+ * the SEO form below as unsaved edits and the form's Update is the write. No
+ * job is started from here and no model is asked anything — the card only
+ * reads jobs the site already ran.
+ *
+ * ── Absent unless there is something to offer ────────────────────────────
+ *
+ * Nothing renders until the jobs route has admitted this workspace, so a
+ * workspace whose release flag is off sees the ordinary SEO section and no
+ * trace of this. Nothing renders either when no scaffold ever ran here, or
+ * when the site's stored SEO already says what the proposal would say —
+ * a card whose only button does nothing is worse than no card.
+ */ /** How many recent jobs the card reads to find this site's guided start. */ const RECENT_JOBS_READ = 20;
+/** What each value is called where the card lists it. */ const FIELD_LABELS = {
+    [AI_SITE_SEO_FORM_FIELDS.title]: 'Title',
+    [AI_SITE_SEO_FORM_FIELDS.description]: 'Description'
+};
+/** What the site's settings hold for one field now, read as the form seeded it. */ function storedValue(seo, field) {
+    const key = field.replace(/^seo\./, '');
+    const value = seo == null ? void 0 : seo[key];
+    return typeof value === 'string' ? value.trim() : '';
+}
+/**
+ * Whether the site's settings already say what the proposal says. Both values
+ * have to match: a site whose title was applied and whose description was
+ * then rewritten still has something to take.
+ */ export function aiSiteSeoAlreadySaid(proposal, seo) {
+    return Object.entries(proposal.values).every(([field, value])=>storedValue(seo, field) === value.trim());
+}
+export function AiSiteSeoStartCard({ hostId, orgId, seo, proposeDraft }) {
+    var _ref;
+    const { data: user } = useUser();
+    // Held in a ref so a request reads WHO is signed in, never the identity of
+    // the object that says so.
+    const userRef = useRef(user);
+    userRef.current = user;
+    const uid = (_ref = user == null ? void 0 : user.uid) != null ? _ref : null;
+    const [verdict, setVerdict] = useState('checking');
+    const [job, setJob] = useState(null);
+    const [staged, setStaged] = useState(false);
+    useEffect(()=>{
+        if (!orgId || !hostId || !uid) return;
+        let active = true;
+        void (async ()=>{
+            try {
+                var _ref;
+                const response = await authorizedFetch(userRef.current, `/api/ai/jobs?orgId=${encodeURIComponent(orgId)}&limit=${RECENT_JOBS_READ}`);
+                if (!active) return;
+                if (!response.ok) {
+                    setVerdict('hidden');
+                    return;
+                }
+                const payload = await response.json().catch(()=>null);
+                if (!active) return;
+                // The scaffold that ran for THIS site and reported a listing; the
+                // route answers newest first, so the first match is the last start.
+                const latest = ((_ref = payload == null ? void 0 : payload.jobs) != null ? _ref : []).find((entry)=>entry.kind === 'site' && entry.hostId === hostId && aiSiteSeoProposalOf(entry.outputs) !== null);
+                if (latest) setJob(latest);
+                setVerdict('ready');
+            } catch (unused) {
+                if (active) setVerdict('hidden');
+            }
+        })();
+        return ()=>{
+            active = false;
+        };
+    }, [
+        orgId,
+        hostId,
+        uid
+    ]);
+    const proposal = useMemo(()=>job ? aiSiteSeoProposalOf(job.outputs) : null, [
+        job
+    ]);
+    const stage = useCallback(()=>{
+        if (!job || !proposal) return;
+        proposeDraft(proposal.values, `${job.id}:site-listing`);
+        setStaged(true);
+    }, [
+        job,
+        proposal,
+        proposeDraft
+    ]);
+    if (verdict !== 'ready' || !proposal) return null;
+    if (!staged && aiSiteSeoAlreadySaid(proposal, seo)) return null;
+    return /*#__PURE__*/ _jsx(CardDisplay, {
+        contentGutterX: true,
+        contentGutterY: true,
+        HeaderProps: {
+            title: 'The listing your answers describe',
+            subheader: 'What you said this site is, and who it is for, as the title and description every ' + 'page without its own falls back to. Nothing is saved until you press Update below.'
+        },
+        children: /*#__PURE__*/ _jsxs(Stack, {
+            spacing: 2,
+            children: [
+                Object.entries(proposal.values).map(([field, value])=>{
+                    var _FIELD_LABELS_field;
+                    return /*#__PURE__*/ _jsxs(Stack, {
+                        spacing: 0.25,
+                        children: [
+                            /*#__PURE__*/ _jsx(Typography, {
+                                variant: "caption",
+                                color: "text.secondary",
+                                children: (_FIELD_LABELS_field = FIELD_LABELS[field]) != null ? _FIELD_LABELS_field : field
+                            }),
+                            /*#__PURE__*/ _jsx(Typography, {
+                                variant: "body2",
+                                sx: {
+                                    wordBreak: 'break-word'
+                                },
+                                children: value
+                            })
+                        ]
+                    }, field);
+                }),
+                proposal.notes.map((note)=>/*#__PURE__*/ _jsx(Typography, {
+                        variant: "caption",
+                        color: "text.secondary",
+                        children: note
+                    }, note)),
+                /*#__PURE__*/ _jsx(Button, {
+                    size: "small",
+                    variant: "outlined",
+                    sx: {
+                        alignSelf: 'flex-start'
+                    },
+                    disabled: staged,
+                    onClick: stage,
+                    children: 'Put in the form'
+                }),
+                staged && /*#__PURE__*/ _jsx(Alert, {
+                    severity: "success",
+                    children: 'In the SEO form below as unsaved changes. Read them, then press Update.'
+                })
+            ]
+        })
+    });
+}
+export default AiSiteSeoStartCard;
+
+//# sourceMappingURL=ai-site-seo-start-card.component.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/ai-site-seo-start-card.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 type { ConsoleHostSeoZoneProps } from '@aglyn/aglyn/plugin-manager/feature-plugins'\nimport { CardDisplay } from '@aglyn/shared-ui-jsx'\nimport { authorizedFetch } from '@aglyn/shared-util-http/authorized-token'\nimport { useUser } from '@aglyn/tenant-feature-instance'\nimport { Alert, Button, Stack, Typography } from '@mui/material'\nimport { useCallback, useEffect, useMemo, useRef, useState } from 'react'\nimport type { AiJobSummary } from '../model/ai-jobs.types'\nimport {\n  AI_SITE_SEO_FORM_FIELDS,\n  aiSiteSeoProposalOf,\n  type AiSiteSeoProposal,\n} from '../model/ai-site-start-seo'\n\n/**\n * The site's own search listing, from the guided start's answers (AGL-2918),\n * on the site's SEO section through the `hostSeo` zone.\n *\n * The guided start asks what kind of site this is and who it is for. Those\n * two answers are exactly the site-wide search title and description every\n * page with none of its own falls back to, and until now they reached\n * neither: a scaffolded site published its pages listed under whatever its\n * creation seeded. The scaffold now carries the pair as an output of the\n * `site` job (`aiSiteSeoProposal`), and this card is where a person reads it\n * and puts it in the form.\n *\n * ── It writes nothing, and it asks for nothing ───────────────────────────\n *\n * \"Put in the form\" is the zone's own `proposeDraft`: the two values land in\n * the SEO form below as unsaved edits and the form's Update is the write. No\n * job is started from here and no model is asked anything — the card only\n * reads jobs the site already ran.\n *\n * ── Absent unless there is something to offer ────────────────────────────\n *\n * Nothing renders until the jobs route has admitted this workspace, so a\n * workspace whose release flag is off sees the ordinary SEO section and no\n * trace of this. Nothing renders either when no scaffold ever ran here, or\n * when the site's stored SEO already says what the proposal would say —\n * a card whose only button does nothing is worse than no card.\n */\n\n/** How many recent jobs the card reads to find this site's guided start. */\nconst RECENT_JOBS_READ = 20\n\ntype Verdict = 'checking' | 'ready' | 'hidden'\n\n/** What each value is called where the card lists it. */\nconst FIELD_LABELS: Record<string, string> = {\n  [AI_SITE_SEO_FORM_FIELDS.title]: 'Title',\n  [AI_SITE_SEO_FORM_FIELDS.description]: 'Description',\n}\n\n/** What the site's settings hold for one field now, read as the form seeded it. */\nfunction storedValue(seo: Record<string, unknown> | undefined, field: string): string {\n  const key = field.replace(/^seo\\./, '')\n  const value = seo?.[key]\n  return typeof value === 'string' ? value.trim() : ''\n}\n\n/**\n * Whether the site's settings already say what the proposal says. Both values\n * have to match: a site whose title was applied and whose description was\n * then rewritten still has something to take.\n */\nexport function aiSiteSeoAlreadySaid(\n  proposal: AiSiteSeoProposal,\n  seo: Record<string, unknown> | undefined,\n): boolean {\n  return Object.entries(proposal.values).every(\n    ([field, value]) => storedValue(seo, field) === value.trim(),\n  )\n}\n\nexport function AiSiteSeoStartCard({ hostId, orgId, seo, proposeDraft }: ConsoleHostSeoZoneProps) {\n  const { data: user } = useUser()\n  // Held in a ref so a request reads WHO is signed in, never the identity of\n  // the object that says so.\n  const userRef = useRef(user)\n  userRef.current = user\n  const uid = user?.uid ?? null\n  const [verdict, setVerdict] = useState<Verdict>('checking')\n  const [job, setJob] = useState<AiJobSummary | null>(null)\n  const [staged, setStaged] = useState(false)\n\n  useEffect(() => {\n    if (!orgId || !hostId || !uid) return\n    let active = true\n    void (async () => {\n      try {\n        const response = await authorizedFetch(\n          userRef.current,\n          `/api/ai/jobs?orgId=${encodeURIComponent(orgId)}&limit=${RECENT_JOBS_READ}`,\n        )\n        if (!active) return\n        if (!response.ok) {\n          setVerdict('hidden')\n          return\n        }\n        const payload = await response.json().catch(() => null)\n        if (!active) return\n        // The scaffold that ran for THIS site and reported a listing; the\n        // route answers newest first, so the first match is the last start.\n        const latest = ((payload?.jobs ?? []) as AiJobSummary[]).find(\n          (entry) =>\n            entry.kind === 'site' &&\n            entry.hostId === hostId &&\n            aiSiteSeoProposalOf(entry.outputs) !== null,\n        )\n        if (latest) setJob(latest)\n        setVerdict('ready')\n      } catch {\n        if (active) setVerdict('hidden')\n      }\n    })()\n    return () => {\n      active = false\n    }\n  }, [orgId, hostId, uid])\n\n  const proposal = useMemo(() => (job ? aiSiteSeoProposalOf(job.outputs) : null), [job])\n\n  const stage = useCallback(() => {\n    if (!job || !proposal) return\n    proposeDraft(proposal.values, `${job.id}:site-listing`)\n    setStaged(true)\n  }, [job, proposal, proposeDraft])\n\n  if (verdict !== 'ready' || !proposal) return null\n  if (!staged && aiSiteSeoAlreadySaid(proposal, seo)) return null\n\n  return (\n    <CardDisplay\n      contentGutterX\n      contentGutterY\n      HeaderProps={{\n        title: 'The listing your answers describe',\n        subheader:\n          'What you said this site is, and who it is for, as the title and description every ' +\n          'page without its own falls back to. Nothing is saved until you press Update below.',\n      }}\n    >\n      <Stack spacing={2}>\n        {Object.entries(proposal.values).map(([field, value]) => (\n          <Stack key={field} spacing={0.25}>\n            <Typography variant=\"caption\" color=\"text.secondary\">\n              {FIELD_LABELS[field] ?? field}\n            </Typography>\n            <Typography variant=\"body2\" sx={{ wordBreak: 'break-word' }}>\n              {value}\n            </Typography>\n          </Stack>\n        ))}\n        {proposal.notes.map((note) => (\n          <Typography key={note} variant=\"caption\" color=\"text.secondary\">\n            {note}\n          </Typography>\n        ))}\n        <Button\n          size=\"small\"\n          variant=\"outlined\"\n          sx={{ alignSelf: 'flex-start' }}\n          disabled={staged}\n          onClick={stage}\n        >\n          {'Put in the form'}\n        </Button>\n        {staged && (\n          <Alert severity=\"success\">\n            {'In the SEO form below as unsaved changes. Read them, then press Update.'}\n          </Alert>\n        )}\n      </Stack>\n    </CardDisplay>\n  )\n}\n\nexport default AiSiteSeoStartCard\n"],"names":["CardDisplay","authorizedFetch","useUser","Alert","Button","Stack","Typography","useCallback","useEffect","useMemo","useRef","useState","AI_SITE_SEO_FORM_FIELDS","aiSiteSeoProposalOf","RECENT_JOBS_READ","FIELD_LABELS","title","description","storedValue","seo","field","key","replace","value","trim","aiSiteSeoAlreadySaid","proposal","Object","entries","values","every","AiSiteSeoStartCard","hostId","orgId","proposeDraft","data","user","userRef","current","uid","verdict","setVerdict","job","setJob","staged","setStaged","active","response","encodeURIComponent","ok","payload","json","catch","latest","jobs","find","entry","kind","outputs","stage","id","contentGutterX","contentGutterY","HeaderProps","subheader","spacing","map","variant","color","sx","wordBreak","notes","note","size","alignSelf","disabled","onClick","severity"],"mappings":"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"}

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

@@ -0,0 +1,19 @@
+/**
+ * @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 { ConsoleHostFirstRunZoneProps } from '@aglyn/aglyn/plugin-manager/feature-plugins';
+export declare function AiSiteStartCard({ hostId, orgId, startBlank, }: ConsoleHostFirstRunZoneProps): import("react").JSX.Element;
+export default AiSiteStartCard;

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

@@ -0,0 +1,348 @@
+/**
+ * @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, Fragment as _Fragment } from "react/jsx-runtime";
+import { lockdownRefusalText, parseLockdownRefusal } from "@aglyn/aglyn";
+import { ICON_VARIANT_CLOSE } from "@aglyn/shared-data-enums";
+import { MdiIcon } from "@aglyn/shared-ui-jsx";
+import { authorizedFetch } from "@aglyn/shared-util-http/authorized-token";
+import { useUser } from "@aglyn/tenant-feature-instance";
+import { Alert, AppBar, Box, Button, Chip, Container, Dialog, DialogActions, DialogContent, Divider, IconButton, MenuItem, Stack, TextField, Toolbar, Typography } from "@mui/material";
+import { useCallback, useEffect, useRef, useState } from "react";
+import { AI_SITE_PAGES, AI_SITE_SUBMISSION_CHOICES, aiSiteCreditEstimate } from "../model/ai-site-job.js";
+import { AI_SITE_START_ANSWERS, AI_SITE_START_EXAMPLES, AI_SITE_START_TYPES, aiSiteStartBrief, aiSiteStartInputs, aiSiteStartRefusal } from "../model/ai-site-start.js";
+/** Labels the dialog for a reader, from its own heading. */ const TITLE_ID = 'ai-site-start-title';
+export function AiSiteStartCard({ hostId, orgId, startBlank }) {
+    var _ref;
+    const { data: user } = useUser();
+    // Held in a ref so a request reads WHO is signed in, never the identity of
+    // the object that says so.
+    const userRef = useRef(user);
+    userRef.current = user;
+    const uid = (_ref = user == null ? void 0 : user.uid) != null ? _ref : null;
+    const [verdict, setVerdict] = useState('checking');
+    const [answers, setAnswers] = useState(AI_SITE_START_ANSWERS);
+    const [busy, setBusy] = useState(false);
+    const [notice, setNotice] = useState(null);
+    const [started, setStarted] = useState(false);
+    useEffect(()=>{
+        if (!orgId || !uid) return;
+        let active = true;
+        void (async ()=>{
+            try {
+                const response = await authorizedFetch(userRef.current, `/api/ai/jobs?orgId=${encodeURIComponent(orgId)}&limit=1`);
+                if (active) {
+                    setVerdict(response.status === 404 || response.status === 403 ? 'hidden' : 'ready');
+                }
+            } catch (unused) {
+                if (active) setVerdict('hidden');
+            }
+        })();
+        return ()=>{
+            active = false;
+        };
+    }, [
+        orgId,
+        uid
+    ]);
+    const answer = useCallback((patch)=>setAnswers((current)=>_extends({}, current, patch)), []);
+    const refusal = aiSiteStartRefusal(answers);
+    const plan = useCallback(async ()=>{
+        if (!orgId || aiSiteStartRefusal(answers)) return;
+        setBusy(true);
+        setNotice(null);
+        try {
+            const response = await authorizedFetch(userRef.current, '/api/ai/jobs', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json'
+                },
+                body: JSON.stringify({
+                    orgId,
+                    hostId,
+                    kind: 'site',
+                    brief: aiSiteStartBrief(answers),
+                    inputs: aiSiteStartInputs(answers)
+                })
+            });
+            const payload = await response.json().catch(()=>null);
+            if (!response.ok) {
+                var _ref;
+                const locked = parseLockdownRefusal(response.status, payload);
+                setNotice(locked ? lockdownRefusalText(locked) : String((_ref = payload == null ? void 0 : payload.error) != null ? _ref : 'The site could not be started. Try again.'));
+                return;
+            }
+            setStarted(true);
+        } catch (unused) {
+            setNotice('The site could not be started. Try again.');
+        } finally{
+            setBusy(false);
+        }
+    }, [
+        orgId,
+        hostId,
+        answers
+    ]);
+    if (verdict !== 'ready') return null;
+    const estimate = aiSiteCreditEstimate(answers.pages, {
+        welcomeEmail: answers.welcomeEmail
+    });
+    return /*#__PURE__*/ _jsxs(Dialog, {
+        open: true,
+        fullScreen: true,
+        onClose: startBlank,
+        "aria-labelledby": TITLE_ID,
+        children: [
+            /*#__PURE__*/ _jsx(AppBar, {
+                position: "relative",
+                color: "surface",
+                enableColorOnDark: true,
+                children: /*#__PURE__*/ _jsxs(Toolbar, {
+                    children: [
+                        /*#__PURE__*/ _jsx(IconButton, {
+                            edge: "start",
+                            color: "inherit",
+                            onClick: startBlank,
+                            "aria-label": "Close the guided start",
+                            children: /*#__PURE__*/ _jsx(MdiIcon, {
+                                path: ICON_VARIANT_CLOSE.path
+                            })
+                        }),
+                        /*#__PURE__*/ _jsx(Typography, {
+                            id: TITLE_ID,
+                            variant: "h6",
+                            component: "div",
+                            noWrap: true,
+                            sx: {
+                                textOverflow: 'ellipsis',
+                                ml: 2,
+                                flex: 1
+                            },
+                            children: 'Start this site with AI'
+                        }),
+                        /*#__PURE__*/ _jsx(Divider, {
+                            sx: {
+                                height: 28,
+                                m: 0.5
+                            },
+                            orientation: "vertical"
+                        }),
+                        /*#__PURE__*/ _jsx(Button, {
+                            color: "inherit",
+                            onClick: startBlank,
+                            children: started ? 'Close' : 'Skip and start blank'
+                        })
+                    ]
+                })
+            }),
+            /*#__PURE__*/ _jsx(DialogContent, {
+                children: /*#__PURE__*/ _jsx(Container, {
+                    maxWidth: "md",
+                    disableGutters: true,
+                    sx: {
+                        py: 2
+                    },
+                    children: /*#__PURE__*/ _jsxs(Stack, {
+                        spacing: 3,
+                        children: [
+                            /*#__PURE__*/ _jsx(Typography, {
+                                variant: "body2",
+                                color: "text.secondary",
+                                children: 'Answer a few questions and AI plans the whole site — its pages, its ' + 'navigation, its layout and a contact form. Nothing is built until you ' + 'confirm the plan, and everything it builds is an unpublished draft.'
+                            }),
+                            notice && /*#__PURE__*/ _jsx(Alert, {
+                                severity: "info",
+                                children: notice
+                            }),
+                            started ? /*#__PURE__*/ _jsx(Alert, {
+                                severity: "success",
+                                children: 'Your site is being planned. Open AI jobs in the Assist panel to read the plan ' + 'and confirm it — nothing is built, and nothing is published, until you do.'
+                            }) : /*#__PURE__*/ _jsxs(_Fragment, {
+                                children: [
+                                    /*#__PURE__*/ _jsxs(Box, {
+                                        children: [
+                                            /*#__PURE__*/ _jsx(TextField, {
+                                                fullWidth: true,
+                                                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
+                                                    })
+                                            }),
+                                            /*#__PURE__*/ _jsx(Stack, {
+                                                direction: "row",
+                                                spacing: 1,
+                                                sx: {
+                                                    flexWrap: 'wrap',
+                                                    mt: 1,
+                                                    rowGap: 1
+                                                },
+                                                children: AI_SITE_START_TYPES.map((type)=>/*#__PURE__*/ _jsx(Chip, {
+                                                        label: type,
+                                                        size: "small",
+                                                        variant: answers.siteType === type ? 'filled' : 'outlined',
+                                                        onClick: ()=>answer({
+                                                                siteType: type
+                                                            })
+                                                    }, type))
+                                            })
+                                        ]
+                                    }),
+                                    /*#__PURE__*/ _jsx(TextField, {
+                                        fullWidth: true,
+                                        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
+                                            }),
+                                        helperText: "Optional. It narrows who the pages are written for."
+                                    }),
+                                    /*#__PURE__*/ _jsxs(Box, {
+                                        children: [
+                                            /*#__PURE__*/ _jsx(Typography, {
+                                                variant: "subtitle2",
+                                                gutterBottom: true,
+                                                children: 'Which of these do you like?'
+                                            }),
+                                            /*#__PURE__*/ _jsx(Typography, {
+                                                variant: "body2",
+                                                color: "text.secondary",
+                                                gutterBottom: true,
+                                                children: 'Optional. Picking one steers the shape of the site, not its words.'
+                                            }),
+                                            /*#__PURE__*/ _jsx(Stack, {
+                                                direction: "row",
+                                                spacing: 1,
+                                                sx: {
+                                                    flexWrap: 'wrap',
+                                                    rowGap: 1
+                                                },
+                                                children: AI_SITE_START_EXAMPLES.map((example)=>/*#__PURE__*/ _jsx(Chip, {
+                                                        label: `${example.label} — ${example.blurb}`,
+                                                        variant: answers.example === example.id ? 'filled' : 'outlined',
+                                                        onClick: ()=>answer({
+                                                                example: answers.example === example.id ? null : example.id
+                                                            })
+                                                    }, example.id))
+                                            })
+                                        ]
+                                    }),
+                                    /*#__PURE__*/ _jsx(TextField, {
+                                        select: true,
+                                        fullWidth: true,
+                                        label: "Where do form submissions go?",
+                                        value: answers.submissions,
+                                        onChange: (event)=>answer({
+                                                submissions: event.target.value
+                                            }),
+                                        helperText: "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(TextField, {
+                                                select: true,
+                                                label: "Pages",
+                                                value: answers.pages,
+                                                onChange: (event)=>answer({
+                                                        pages: Number(event.target.value)
+                                                    }),
+                                                sx: {
+                                                    minWidth: 160
+                                                },
+                                                children: Array.from({
+                                                    length: AI_SITE_PAGES.max - AI_SITE_PAGES.min + 1
+                                                }, (_, index)=>AI_SITE_PAGES.min + index).map((count)=>/*#__PURE__*/ _jsx(MenuItem, {
+                                                        value: count,
+                                                        children: count
+                                                    }, count))
+                                            }),
+                                            /*#__PURE__*/ _jsxs(TextField, {
+                                                select: true,
+                                                label: "Welcome email",
+                                                value: answers.welcomeEmail ? 'yes' : 'no',
+                                                onChange: (event)=>answer({
+                                                        welcomeEmail: event.target.value === 'yes'
+                                                    }),
+                                                sx: {
+                                                    minWidth: 160
+                                                },
+                                                children: [
+                                                    /*#__PURE__*/ _jsx(MenuItem, {
+                                                        value: "yes",
+                                                        children: 'Draft one'
+                                                    }),
+                                                    /*#__PURE__*/ _jsx(MenuItem, {
+                                                        value: "no",
+                                                        children: 'No'
+                                                    })
+                                                ]
+                                            })
+                                        ]
+                                    }),
+                                    /*#__PURE__*/ _jsx(Typography, {
+                                        variant: "body2",
+                                        color: "text.secondary",
+                                        children: `About ${estimate.toLocaleString('en-US')} credits, estimated. What it really ` + 'costs is what each step spends, and you can watch that add up while it runs.'
+                                    })
+                                ]
+                            })
+                        ]
+                    })
+                })
+            }),
+            !started && /* Wraps, because the reason and the button together are wider than a
+           phone: on one line the reason would push the button off the edge. */ /*#__PURE__*/ _jsxs(DialogActions, {
+                sx: {
+                    px: 3,
+                    py: 2,
+                    flexWrap: 'wrap',
+                    rowGap: 1
+                },
+                children: [
+                    refusal && /*#__PURE__*/ _jsx(Typography, {
+                        variant: "body2",
+                        color: "text.secondary",
+                        sx: {
+                            mr: 'auto'
+                        },
+                        children: refusal
+                    }),
+                    /*#__PURE__*/ _jsx(Button, {
+                        variant: "contained",
+                        disabled: busy || Boolean(refusal),
+                        onClick: plan,
+                        children: busy ? 'Starting…' : 'Plan my site'
+                    })
+                ]
+            })
+        ]
+    });
+}
+export default AiSiteStartCard;
+
+//# sourceMappingURL=ai-site-start-card.component.js.map