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

package/src/lib/components/ai-site-start-tracking.js

@@ -0,0 +1,277 @@
+/**
+ * @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 { trackEvent } from "@aglyn/aglyn/app-utils/analytics-events";
+import { useEffect, useRef } from "react";
+import { AI_SITE_START_STEPS, aiSiteStartStepIndex } from "../model/ai-site-start-steps.js";
+/**
+ * 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 const AI_SITE_START_IDLE_MS = 30000;
+/** This many clicks on one spot… */ export const AI_SITE_START_RAGE_CLICKS = 3;
+/** …within this long… */ export const AI_SITE_START_RAGE_WINDOW_MS = 700;
+/** …and within this distance of the first, is rage. */ export const AI_SITE_START_RAGE_RADIUS_PX = 30;
+/** One field changed this many times is a struggle. */ export const AI_SITE_START_STRUGGLE_EDITS = 3;
+/** At most this many dead clicks are reported on one visit to a step. */ export const AI_SITE_START_DEAD_CLICKS_PER_STEP = 3;
+export function createAiSiteStartTracker(options = {}) {
+    var _options_send, _options_now, _options_hidden;
+    const send = (_options_send = options.send) != null ? _options_send : (name, params)=>trackEvent(name, params);
+    const now = (_options_now = options.now) != null ? _options_now : ()=>Date.now();
+    const hidden = (_options_hidden = options.hidden) != null ? _options_hidden : ()=>typeof document !== 'undefined' && document.visibilityState === 'hidden';
+    const opened = now();
+    let step = null;
+    let enteredAt = opened;
+    let done = false;
+    let idleTimer = null;
+    let idleReported = false;
+    let deadClicks = 0;
+    let burst = null;
+    const edits = new Map();
+    const dirty = new Set();
+    const struggled = new Set();
+    const index = ()=>step ? aiSiteStartStepIndex(step) : 0;
+    const spent = ()=>Math.max(0, Math.round(now() - enteredAt));
+    const stopIdle = ()=>{
+        if (idleTimer) clearTimeout(idleTimer);
+        idleTimer = null;
+    };
+    const armIdle = ()=>{
+        stopIdle();
+        if (done || !step || idleReported) return;
+        idleTimer = setTimeout(()=>{
+            idleTimer = null;
+            if (done || !step || idleReported || hidden()) return;
+            idleReported = true;
+            send('site_start_struggle', {
+                step,
+                signal: 'idle',
+                duration_ms: AI_SITE_START_IDLE_MS
+            });
+        }, AI_SITE_START_IDLE_MS);
+    };
+    const edited = (field)=>{
+        var _edits_get;
+        if (!step) return;
+        const count = ((_edits_get = edits.get(field)) != null ? _edits_get : 0) + 1;
+        edits.set(field, count);
+        if (count >= AI_SITE_START_STRUGGLE_EDITS && !struggled.has(field)) {
+            struggled.add(field);
+            send('site_start_struggle', {
+                step,
+                signal: 'edits',
+                field,
+                count
+            });
+        }
+    };
+    return {
+        view (next) {
+            if (done) return;
+            step = next;
+            enteredAt = now();
+            idleReported = false;
+            deadClicks = 0;
+            burst = null;
+            send('site_start_step_viewed', {
+                step: next,
+                step_index: aiSiteStartStepIndex(next),
+                step_count: AI_SITE_START_STEPS.length
+            });
+            armIdle();
+        },
+        complete () {
+            if (done || !step) return;
+            send('site_start_step_completed', {
+                step,
+                step_index: index(),
+                duration_ms: spent()
+            });
+        },
+        back () {
+            if (done || !step) return;
+            send('site_start_step_back', {
+                step,
+                step_index: index(),
+                duration_ms: spent()
+            });
+        },
+        fieldError (field, code) {
+            if (done || !step) return;
+            send('site_start_field_error', {
+                step,
+                field,
+                error: code
+            });
+        },
+        fieldChanged (field) {
+            dirty.add(field);
+        },
+        fieldLeft (field) {
+            if (!dirty.delete(field)) return;
+            edited(field);
+        },
+        fieldPicked (field) {
+            edited(field);
+        },
+        activity () {
+            armIdle();
+        },
+        click (click) {
+            if (done || !step) return;
+            const at = now();
+            const near = burst && at - burst.at <= AI_SITE_START_RAGE_WINDOW_MS && Math.hypot(click.x - burst.x, click.y - burst.y) <= AI_SITE_START_RAGE_RADIUS_PX;
+            if (near && burst) {
+                burst.count += 1;
+                if (burst.count >= AI_SITE_START_RAGE_CLICKS && !burst.reported) {
+                    burst.reported = true;
+                    send('site_start_rage_click', {
+                        step,
+                        area: click.area,
+                        clicks: burst.count
+                    });
+                }
+            } else {
+                burst = {
+                    x: click.x,
+                    y: click.y,
+                    at,
+                    count: 1,
+                    reported: false
+                };
+            }
+            if (!click.interactive && deadClicks < AI_SITE_START_DEAD_CLICKS_PER_STEP) {
+                deadClicks += 1;
+                send('site_start_dead_click', {
+                    step,
+                    area: click.area
+                });
+            }
+            armIdle();
+        },
+        abandon (reason) {
+            if (done) return;
+            done = true;
+            stopIdle();
+            const at = step != null ? step : AI_SITE_START_STEPS[0];
+            send('site_start_abandoned', {
+                step: at,
+                step_index: aiSiteStartStepIndex(at),
+                reason,
+                duration_ms: spent(),
+                total_ms: Math.max(0, Math.round(now() - opened))
+            });
+        },
+        finish () {
+            done = true;
+            stopIdle();
+        },
+        dispose () {
+            stopIdle();
+        }
+    };
+}
+/** What clicking acts on: a click on anything else in the form is a dead click. */ const INTERACTIVE = [
+    'button',
+    'a[href]',
+    'input',
+    'select',
+    'textarea',
+    'label',
+    'summary',
+    '[role="button"]',
+    '[role="radio"]',
+    '[role="checkbox"]',
+    '[role="switch"]',
+    '[role="option"]',
+    '[role="tab"]',
+    '[role="link"]',
+    '[role="combobox"]',
+    '[role="menuitem"]',
+    '[role="slider"]',
+    '[contenteditable="true"]',
+    '.MuiInputBase-root',
+    '[tabindex]:not([tabindex="-1"])'
+].join(', ');
+/** The attribute naming the part of the form an element is in (a closed id, never content). */ export const AI_SITE_START_AREA_ATTRIBUTE = 'data-start-area';
+/** A DOM click, as the detector reads it. */ export function aiSiteStartClickOf(event) {
+    var _ref;
+    var _target_closest;
+    const target = event.target instanceof Element ? event.target : null;
+    const area = (_ref = target == null ? void 0 : (_target_closest = target.closest(`[${AI_SITE_START_AREA_ATTRIBUTE}]`)) == null ? void 0 : _target_closest.getAttribute(AI_SITE_START_AREA_ATTRIBUTE)) != null ? _ref : 'form';
+    return {
+        x: event.clientX,
+        y: event.clientY,
+        interactive: Boolean(target == null ? void 0 : target.closest(INTERACTIVE)),
+        area
+    };
+}
+/**
+ * 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 function useAiSiteStartTracking(step, active) {
+    const ref = useRef(null);
+    if (!ref.current) ref.current = createAiSiteStartTracker();
+    const tracker = ref.current;
+    const leaving = useRef(null);
+    useEffect(()=>{
+        if (active && step) tracker.view(step);
+    }, [
+        active,
+        step,
+        tracker
+    ]);
+    useEffect(()=>{
+        if (!active) return;
+        if (leaving.current) clearTimeout(leaving.current);
+        leaving.current = null;
+        const onPageHide = ()=>tracker.abandon('unload');
+        window.addEventListener('pagehide', onPageHide);
+        return ()=>{
+            window.removeEventListener('pagehide', onPageHide);
+            leaving.current = setTimeout(()=>{
+                tracker.abandon('route');
+                tracker.dispose();
+            }, 0);
+        };
+    }, [
+        active,
+        tracker
+    ]);
+    return tracker;
+}
+
+//# sourceMappingURL=ai-site-start-tracking.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/ai-site-start-tracking.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n'use client'\n\nimport { trackEvent, type AnalyticsEventName, type AnalyticsEventParams } from '@aglyn/aglyn/app-utils/analytics-events'\nimport { useEffect, useRef } from 'react'\nimport {\n  AI_SITE_START_STEPS,\n  aiSiteStartStepIndex,\n  type AiSiteStartErrorCode,\n  type AiSiteStartField,\n  type AiSiteStartStep,\n} from '../model/ai-site-start-steps'\n\n/**\n * Where people get lost in the guided start (AGL-3898), as the console's own\n * product analytics: each step drawn, left forward or back and how long it\n * took, the step the start was abandoned on, the field a step refused on,\n * and the signs of a struggle — one field changed again and again, a step\n * left idle, fast repeated clicks on one spot (rage) and clicks on parts of\n * the form that do nothing (dead).\n *\n * Every event goes through `trackEvent`, the one door the console's GA4\n * taxonomy has, so it is consent-gated exactly as every other console event\n * is (`firebase-app.layout.tsx` registers the transport, or the refusal that\n * drops it) and its params are sanitized there too. What is sent is only ever\n * a step id, a field id, a closed error code, a closed area id, a count or a\n * duration: never anything typed, picked or named.\n *\n * The detector is a plain object over a clock and a timer so its rules are\n * tested with fake timers; {@link useAiSiteStartTracking} binds it to the\n * dialog.\n */\n\n/** No input on a step for this long is a struggle. */\nexport const AI_SITE_START_IDLE_MS = 30_000\n/** This many clicks on one spot… */\nexport const AI_SITE_START_RAGE_CLICKS = 3\n/** …within this long… */\nexport const AI_SITE_START_RAGE_WINDOW_MS = 700\n/** …and within this distance of the first, is rage. */\nexport const AI_SITE_START_RAGE_RADIUS_PX = 30\n/** One field changed this many times is a struggle. */\nexport const AI_SITE_START_STRUGGLE_EDITS = 3\n/** At most this many dead clicks are reported on one visit to a step. */\nexport const AI_SITE_START_DEAD_CLICKS_PER_STEP = 3\n\n/** Why the start was left without a site started. */\nexport type AiSiteStartAbandonReason = 'skip' | 'close' | 'unload' | 'route'\n\ntype Send = <K extends AnalyticsEventName>(name: K, params: AnalyticsEventParams[K]) => void\n\nexport interface AiSiteStartTrackerOptions {\n  send?: Send\n  now?: () => number\n  /** Whether the page is out of sight, when an idle step is not a struggle. */\n  hidden?: () => boolean\n}\n\n/** A click as the detector reads it: where, and what it landed on. */\nexport interface AiSiteStartClick {\n  x: number\n  y: number\n  /** Whether it landed on something that acts on a click. */\n  interactive: boolean\n  /** The closed id of the part of the form it landed in. */\n  area: string\n}\n\nexport interface AiSiteStartTracker {\n  /** A step was drawn. */\n  view(step: AiSiteStartStep): void\n  /** The person went forward from the step on screen. */\n  complete(): void\n  /** The person went back from the step on screen. */\n  back(): void\n  /** A step refused to go forward on a field. */\n  fieldError(field: AiSiteStartField, code: AiSiteStartErrorCode): void\n  /** A text answer changed; counted as one edit when the field is left. */\n  fieldChanged(field: AiSiteStartField): void\n  /** A text answer was left. */\n  fieldLeft(field: AiSiteStartField): void\n  /** A choice was picked, which is one edit. */\n  fieldPicked(field: AiSiteStartField): void\n  /** Any input on the step, which puts off the idle signal. */\n  activity(): void\n  /** A click anywhere in the dialog. */\n  click(click: AiSiteStartClick): void\n  /** The start was left without a site started; reported once. */\n  abandon(reason: AiSiteStartAbandonReason): void\n  /** A site was started (or the starter chosen): nothing after it is an abandonment. */\n  finish(): void\n  /** Stops the idle timer. */\n  dispose(): void\n}\n\nexport function createAiSiteStartTracker(options: AiSiteStartTrackerOptions = {}): AiSiteStartTracker {\n  const send: Send = options.send ?? ((name, params) => trackEvent(name, params))\n  const now = options.now ?? (() => Date.now())\n  const hidden = options.hidden ?? (() => typeof document !== 'undefined' && document.visibilityState === 'hidden')\n  const opened = now()\n  let step: AiSiteStartStep | null = null\n  let enteredAt = opened\n  let done = false\n  let idleTimer: ReturnType<typeof setTimeout> | null = null\n  let idleReported = false\n  let deadClicks = 0\n  let burst: { x: number; y: number; at: number; count: number; reported: boolean } | null = null\n  const edits = new Map<AiSiteStartField, number>()\n  const dirty = new Set<AiSiteStartField>()\n  const struggled = new Set<AiSiteStartField>()\n\n  const index = () => (step ? aiSiteStartStepIndex(step) : 0)\n  const spent = () => Math.max(0, Math.round(now() - enteredAt))\n  const stopIdle = () => {\n    if (idleTimer) clearTimeout(idleTimer)\n    idleTimer = null\n  }\n  const armIdle = () => {\n    stopIdle()\n    if (done || !step || idleReported) return\n    idleTimer = setTimeout(() => {\n      idleTimer = null\n      if (done || !step || idleReported || hidden()) return\n      idleReported = true\n      send('site_start_struggle', { step, signal: 'idle', duration_ms: AI_SITE_START_IDLE_MS })\n    }, AI_SITE_START_IDLE_MS)\n  }\n  const edited = (field: AiSiteStartField) => {\n    if (!step) return\n    const count = (edits.get(field) ?? 0) + 1\n    edits.set(field, count)\n    if (count >= AI_SITE_START_STRUGGLE_EDITS && !struggled.has(field)) {\n      struggled.add(field)\n      send('site_start_struggle', { step, signal: 'edits', field, count })\n    }\n  }\n\n  return {\n    view(next) {\n      if (done) return\n      step = next\n      enteredAt = now()\n      idleReported = false\n      deadClicks = 0\n      burst = null\n      send('site_start_step_viewed', { step: next, step_index: aiSiteStartStepIndex(next), step_count: AI_SITE_START_STEPS.length })\n      armIdle()\n    },\n    complete() {\n      if (done || !step) return\n      send('site_start_step_completed', { step, step_index: index(), duration_ms: spent() })\n    },\n    back() {\n      if (done || !step) return\n      send('site_start_step_back', { step, step_index: index(), duration_ms: spent() })\n    },\n    fieldError(field, code) {\n      if (done || !step) return\n      send('site_start_field_error', { step, field, error: code })\n    },\n    fieldChanged(field) {\n      dirty.add(field)\n    },\n    fieldLeft(field) {\n      if (!dirty.delete(field)) return\n      edited(field)\n    },\n    fieldPicked(field) {\n      edited(field)\n    },\n    activity() {\n      armIdle()\n    },\n    click(click) {\n      if (done || !step) return\n      const at = now()\n      const near =\n        burst &&\n        at - burst.at <= AI_SITE_START_RAGE_WINDOW_MS &&\n        Math.hypot(click.x - burst.x, click.y - burst.y) <= AI_SITE_START_RAGE_RADIUS_PX\n      if (near && burst) {\n        burst.count += 1\n        if (burst.count >= AI_SITE_START_RAGE_CLICKS && !burst.reported) {\n          burst.reported = true\n          send('site_start_rage_click', { step, area: click.area, clicks: burst.count })\n        }\n      } else {\n        burst = { x: click.x, y: click.y, at, count: 1, reported: false }\n      }\n      if (!click.interactive && deadClicks < AI_SITE_START_DEAD_CLICKS_PER_STEP) {\n        deadClicks += 1\n        send('site_start_dead_click', { step, area: click.area })\n      }\n      armIdle()\n    },\n    abandon(reason) {\n      if (done) return\n      done = true\n      stopIdle()\n      const at = step ?? AI_SITE_START_STEPS[0]\n      send('site_start_abandoned', {\n        step: at,\n        step_index: aiSiteStartStepIndex(at),\n        reason,\n        duration_ms: spent(),\n        total_ms: Math.max(0, Math.round(now() - opened)),\n      })\n    },\n    finish() {\n      done = true\n      stopIdle()\n    },\n    dispose() {\n      stopIdle()\n    },\n  }\n}\n\n/** What clicking acts on: a click on anything else in the form is a dead click. */\nconst INTERACTIVE = [\n  'button',\n  'a[href]',\n  'input',\n  'select',\n  'textarea',\n  'label',\n  'summary',\n  '[role=\"button\"]',\n  '[role=\"radio\"]',\n  '[role=\"checkbox\"]',\n  '[role=\"switch\"]',\n  '[role=\"option\"]',\n  '[role=\"tab\"]',\n  '[role=\"link\"]',\n  '[role=\"combobox\"]',\n  '[role=\"menuitem\"]',\n  '[role=\"slider\"]',\n  '[contenteditable=\"true\"]',\n  '.MuiInputBase-root',\n  '[tabindex]:not([tabindex=\"-1\"])',\n].join(', ')\n\n/** The attribute naming the part of the form an element is in (a closed id, never content). */\nexport const AI_SITE_START_AREA_ATTRIBUTE = 'data-start-area'\n\n/** A DOM click, as the detector reads it. */\nexport function aiSiteStartClickOf(event: { clientX: number; clientY: number; target: EventTarget | null }): AiSiteStartClick {\n  const target = event.target instanceof Element ? event.target : null\n  const area = target?.closest(`[${AI_SITE_START_AREA_ATTRIBUTE}]`)?.getAttribute(AI_SITE_START_AREA_ATTRIBUTE) ?? 'form'\n  return { x: event.clientX, y: event.clientY, interactive: Boolean(target?.closest(INTERACTIVE)), area }\n}\n\n/**\n * The tracker for one open guided start: views each step as it is drawn, and\n * reports the start abandoned when the tab goes away or the page changes\n * under it. A start that is finished ({@link AiSiteStartTracker.finish}) or\n * already abandoned reports nothing more.\n *\n * The unmount report waits a tick, so a development double mount (React's\n * StrictMode runs an effect's cleanup and then the effect again) is not read\n * as the person leaving.\n */\nexport function useAiSiteStartTracking(step: AiSiteStartStep | null, active: boolean): AiSiteStartTracker {\n  const ref = useRef<AiSiteStartTracker | null>(null)\n  if (!ref.current) ref.current = createAiSiteStartTracker()\n  const tracker = ref.current\n  const leaving = useRef<ReturnType<typeof setTimeout> | null>(null)\n\n  useEffect(() => {\n    if (active && step) tracker.view(step)\n  }, [active, step, tracker])\n\n  useEffect(() => {\n    if (!active) return\n    if (leaving.current) clearTimeout(leaving.current)\n    leaving.current = null\n    const onPageHide = () => tracker.abandon('unload')\n    window.addEventListener('pagehide', onPageHide)\n    return () => {\n      window.removeEventListener('pagehide', onPageHide)\n      leaving.current = setTimeout(() => {\n        tracker.abandon('route')\n        tracker.dispose()\n      }, 0)\n    }\n  }, [active, tracker])\n\n  return tracker\n}\n"],"names":["trackEvent","useEffect","useRef","AI_SITE_START_STEPS","aiSiteStartStepIndex","AI_SITE_START_IDLE_MS","AI_SITE_START_RAGE_CLICKS","AI_SITE_START_RAGE_WINDOW_MS","AI_SITE_START_RAGE_RADIUS_PX","AI_SITE_START_STRUGGLE_EDITS","AI_SITE_START_DEAD_CLICKS_PER_STEP","createAiSiteStartTracker","options","send","name","params","now","Date","hidden","document","visibilityState","opened","step","enteredAt","done","idleTimer","idleReported","deadClicks","burst","edits","Map","dirty","Set","struggled","index","spent","Math","max","round","stopIdle","clearTimeout","armIdle","setTimeout","signal","duration_ms","edited","field","count","get","set","has","add","view","next","step_index","step_count","length","complete","back","fieldError","code","error","fieldChanged","fieldLeft","delete","fieldPicked","activity","click","at","near","hypot","x","y","reported","area","clicks","interactive","abandon","reason","total_ms","finish","dispose","INTERACTIVE","join","AI_SITE_START_AREA_ATTRIBUTE","aiSiteStartClickOf","event","target","Element","closest","getAttribute","clientX","clientY","Boolean","useAiSiteStartTracking","active","ref","current","tracker","leaving","onPageHide","window","addEventListener","removeEventListener"],"mappings":"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"}

package/src/lib/components/ai-site-style-previews.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 { OptionCardImage } from '@aglyn/shared-ui-jsx/components/option-card-grid.component';
+/** What each picture shows, as its alt text: the example page and what leads it. */
+export declare const AI_SITE_STYLE_PREVIEW_ALTS: Readonly<Record<string, string>>;
+/** The width and height every preview is drawn at. */
+export declare const AI_SITE_STYLE_PREVIEW_SIZE: {
+    readonly width: 800;
+    readonly height: 800;
+};
+/** The style card picture for a kind of site, by its `AI_SITE_KINDS` id; `null` for a kind with none. */
+export declare function aiSiteStylePreview(kindId: string): OptionCardImage | null;

package/src/lib/components/ai-site-style-previews.js

@@ -0,0 +1,115 @@
+/**
+ * @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 { _ as _extends } from "@swc/helpers/_/_extends";
+import { AI_SITE_KINDS } from "../model/ai-site-kinds.js";
+import businessPreview from "../assets/site-styles/business.webp";
+import tradesPreview from "../assets/site-styles/trades.webp";
+import professionalPreview from "../assets/site-styles/professional.webp";
+import wellnessPreview from "../assets/site-styles/wellness.webp";
+import restaurantPreview from "../assets/site-styles/restaurant.webp";
+import storePreview from "../assets/site-styles/store.webp";
+import portfolioPreview from "../assets/site-styles/portfolio.webp";
+import studioPreview from "../assets/site-styles/studio.webp";
+import photographyPreview from "../assets/site-styles/photography.webp";
+import blogPreview from "../assets/site-styles/blog.webp";
+import eventsPreview from "../assets/site-styles/events.webp";
+import fitnessPreview from "../assets/site-styles/fitness.webp";
+import yogaPreview from "../assets/site-styles/yoga.webp";
+import beautyPreview from "../assets/site-styles/beauty.webp";
+import realestatePreview from "../assets/site-styles/realestate.webp";
+import educationPreview from "../assets/site-styles/education.webp";
+import nonprofitPreview from "../assets/site-styles/nonprofit.webp";
+import musicPreview from "../assets/site-styles/music.webp";
+import personalPreview from "../assets/site-styles/personal.webp";
+import landingPreview from "../assets/site-styles/landing.webp";
+import comingSoonPreview from "../assets/site-styles/coming-soon.webp";
+/**
+ * The picture on each style card of the guided start (AGL-3898): an example
+ * home page of that kind of site, in its own shape — a café's menu, a
+ * store's products, a photographer's gallery, a band's tour dates — drawn in
+ * the kind's look by `libs/plugins/ai/scripts/render-site-style-previews.mts`
+ * from the stand-in pages in `site-style-previews.json`, with the real
+ * compiler and node renderer and the starter photos. Each is 800 × 800;
+ * regenerate them all with that script when a kind's look changes.
+ */ const PREVIEWS = {
+    business: businessPreview,
+    trades: tradesPreview,
+    professional: professionalPreview,
+    wellness: wellnessPreview,
+    restaurant: restaurantPreview,
+    store: storePreview,
+    portfolio: portfolioPreview,
+    studio: studioPreview,
+    photography: photographyPreview,
+    blog: blogPreview,
+    events: eventsPreview,
+    fitness: fitnessPreview,
+    yoga: yogaPreview,
+    beauty: beautyPreview,
+    realestate: realestatePreview,
+    education: educationPreview,
+    nonprofit: nonprofitPreview,
+    music: musicPreview,
+    personal: personalPreview,
+    landing: landingPreview,
+    'coming-soon': comingSoonPreview
+};
+/** What each picture shows, as its alt text: the example page and what leads it. */ export const AI_SITE_STYLE_PREVIEW_ALTS = {
+    business: "A cleaning company's home page: its heading beside a photo of a tidy desk, then its services",
+    trades: "A roofer's home page: a bold heading on a dark band, then roofing services as cards",
+    professional: "A consulting firm's home page: its heading beside a photo of a team at a planning board",
+    wellness: "A therapy practice's home page: its heading over a plant-filled room, then a list of sessions",
+    restaurant: "A café's home page: its heading over a photo of the owner at the counter, then menu highlights",
+    store: "A handmade goods shop's home page: its heading beside a photo of a workbench, then featured products",
+    portfolio: "A prop stylist's home page: a large heading over a grid of three styled sets",
+    studio: "A design studio's home page: a large heading on a dark band, then its selected work",
+    photography: "A photographer's home page: its heading on black over a gallery of three photos",
+    blog: "A food journal's home page: its heading on a dark band, then a list of the latest posts",
+    events: "A festival's home page: its heading beside the three days' program on a colored band",
+    fitness: "A gym's home page: a bold heading on a dark band, then this week's class times",
+    yoga: "A yoga studio's home page: its heading beside this week's class schedule",
+    beauty: "A hair salon's home page: its heading beside a photo of roses and jars at a styling station",
+    realestate: "A real estate agent's home page: its heading over three listings with photos",
+    education: "A tutoring center's home page: its heading over a photo of a tutor at the board, then its courses",
+    nonprofit: "A food bank's home page: its heading on a dark band, then the ways to help",
+    music: "A band's home page: its name on a dark band, then its tour dates",
+    personal: "A product manager's personal page: her introduction beside a photo of her with a teammate",
+    landing: "A budgeting app's landing page: its pitch and sign-up button on a dark band, then its benefits",
+    'coming-soon': "A café's coming soon page: its heading and notify button over a photo of the café shelves"
+};
+/** The width and height every preview is drawn at. */ export const AI_SITE_STYLE_PREVIEW_SIZE = {
+    width: 800,
+    height: 800
+};
+/** A bundler hands an imported picture over as its URL, or as an object carrying it. */ function urlOf(imported) {
+    if (typeof imported === 'string') return imported;
+    if (imported && typeof imported === 'object' && typeof imported.src === 'string') {
+        return imported.src;
+    }
+    return null;
+}
+/** The style card picture for a kind of site, by its `AI_SITE_KINDS` id; `null` for a kind with none. */ export function aiSiteStylePreview(kindId) {
+    var _AI_SITE_STYLE_PREVIEW_ALTS_kindId;
+    const src = urlOf(PREVIEWS[kindId]);
+    const kind = AI_SITE_KINDS.find((entry)=>entry.id === kindId);
+    if (!src || !kind) return null;
+    return _extends({
+        src,
+        alt: (_AI_SITE_STYLE_PREVIEW_ALTS_kindId = AI_SITE_STYLE_PREVIEW_ALTS[kindId]) != null ? _AI_SITE_STYLE_PREVIEW_ALTS_kindId : `An example home page in the ${kind.label} style`
+    }, AI_SITE_STYLE_PREVIEW_SIZE);
+}
+
+//# sourceMappingURL=ai-site-style-previews.js.map

package/src/lib/components/ai-site-style-previews.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/ai-site-style-previews.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 { OptionCardImage } from '@aglyn/shared-ui-jsx/components/option-card-grid.component'\nimport { AI_SITE_KINDS } from '../model/ai-site-kinds'\nimport businessPreview from '../assets/site-styles/business.webp'\nimport tradesPreview from '../assets/site-styles/trades.webp'\nimport professionalPreview from '../assets/site-styles/professional.webp'\nimport wellnessPreview from '../assets/site-styles/wellness.webp'\nimport restaurantPreview from '../assets/site-styles/restaurant.webp'\nimport storePreview from '../assets/site-styles/store.webp'\nimport portfolioPreview from '../assets/site-styles/portfolio.webp'\nimport studioPreview from '../assets/site-styles/studio.webp'\nimport photographyPreview from '../assets/site-styles/photography.webp'\nimport blogPreview from '../assets/site-styles/blog.webp'\nimport eventsPreview from '../assets/site-styles/events.webp'\nimport fitnessPreview from '../assets/site-styles/fitness.webp'\nimport yogaPreview from '../assets/site-styles/yoga.webp'\nimport beautyPreview from '../assets/site-styles/beauty.webp'\nimport realestatePreview from '../assets/site-styles/realestate.webp'\nimport educationPreview from '../assets/site-styles/education.webp'\nimport nonprofitPreview from '../assets/site-styles/nonprofit.webp'\nimport musicPreview from '../assets/site-styles/music.webp'\nimport personalPreview from '../assets/site-styles/personal.webp'\nimport landingPreview from '../assets/site-styles/landing.webp'\nimport comingSoonPreview from '../assets/site-styles/coming-soon.webp'\n\n/**\n * The picture on each style card of the guided start (AGL-3898): an example\n * home page of that kind of site, in its own shape — a café's menu, a\n * store's products, a photographer's gallery, a band's tour dates — drawn in\n * the kind's look by `libs/plugins/ai/scripts/render-site-style-previews.mts`\n * from the stand-in pages in `site-style-previews.json`, with the real\n * compiler and node renderer and the starter photos. Each is 800 × 800;\n * regenerate them all with that script when a kind's look changes.\n */\nconst PREVIEWS: Readonly<Record<string, unknown>> = {\n  business: businessPreview,\n  trades: tradesPreview,\n  professional: professionalPreview,\n  wellness: wellnessPreview,\n  restaurant: restaurantPreview,\n  store: storePreview,\n  portfolio: portfolioPreview,\n  studio: studioPreview,\n  photography: photographyPreview,\n  blog: blogPreview,\n  events: eventsPreview,\n  fitness: fitnessPreview,\n  yoga: yogaPreview,\n  beauty: beautyPreview,\n  realestate: realestatePreview,\n  education: educationPreview,\n  nonprofit: nonprofitPreview,\n  music: musicPreview,\n  personal: personalPreview,\n  landing: landingPreview,\n  'coming-soon': comingSoonPreview,\n}\n\n/** What each picture shows, as its alt text: the example page and what leads it. */\nexport const AI_SITE_STYLE_PREVIEW_ALTS: Readonly<Record<string, string>> = {\n  business: \"A cleaning company's home page: its heading beside a photo of a tidy desk, then its services\",\n  trades: \"A roofer's home page: a bold heading on a dark band, then roofing services as cards\",\n  professional: \"A consulting firm's home page: its heading beside a photo of a team at a planning board\",\n  wellness: \"A therapy practice's home page: its heading over a plant-filled room, then a list of sessions\",\n  restaurant: \"A café's home page: its heading over a photo of the owner at the counter, then menu highlights\",\n  store: \"A handmade goods shop's home page: its heading beside a photo of a workbench, then featured products\",\n  portfolio: \"A prop stylist's home page: a large heading over a grid of three styled sets\",\n  studio: \"A design studio's home page: a large heading on a dark band, then its selected work\",\n  photography: \"A photographer's home page: its heading on black over a gallery of three photos\",\n  blog: \"A food journal's home page: its heading on a dark band, then a list of the latest posts\",\n  events: \"A festival's home page: its heading beside the three days' program on a colored band\",\n  fitness: \"A gym's home page: a bold heading on a dark band, then this week's class times\",\n  yoga: \"A yoga studio's home page: its heading beside this week's class schedule\",\n  beauty: \"A hair salon's home page: its heading beside a photo of roses and jars at a styling station\",\n  realestate: \"A real estate agent's home page: its heading over three listings with photos\",\n  education: \"A tutoring center's home page: its heading over a photo of a tutor at the board, then its courses\",\n  nonprofit: \"A food bank's home page: its heading on a dark band, then the ways to help\",\n  music: \"A band's home page: its name on a dark band, then its tour dates\",\n  personal: \"A product manager's personal page: her introduction beside a photo of her with a teammate\",\n  landing: \"A budgeting app's landing page: its pitch and sign-up button on a dark band, then its benefits\",\n  'coming-soon': \"A café's coming soon page: its heading and notify button over a photo of the café shelves\",\n}\n\n/** The width and height every preview is drawn at. */\nexport const AI_SITE_STYLE_PREVIEW_SIZE = { width: 800, height: 800 } as const\n\n/** A bundler hands an imported picture over as its URL, or as an object carrying it. */\nfunction urlOf(imported: unknown): string | null {\n  if (typeof imported === 'string') return imported\n  if (imported && typeof imported === 'object' && typeof (imported as { src?: unknown }).src === 'string') {\n    return (imported as { src: string }).src\n  }\n  return null\n}\n\n/** The style card picture for a kind of site, by its `AI_SITE_KINDS` id; `null` for a kind with none. */\nexport function aiSiteStylePreview(kindId: string): OptionCardImage | null {\n  const src = urlOf(PREVIEWS[kindId])\n  const kind = AI_SITE_KINDS.find((entry) => entry.id === kindId)\n  if (!src || !kind) return null\n  return {\n    src,\n    alt: AI_SITE_STYLE_PREVIEW_ALTS[kindId] ?? `An example home page in the ${kind.label} style`,\n    ...AI_SITE_STYLE_PREVIEW_SIZE,\n  }\n}\n"],"names":["AI_SITE_KINDS","businessPreview","tradesPreview","professionalPreview","wellnessPreview","restaurantPreview","storePreview","portfolioPreview","studioPreview","photographyPreview","blogPreview","eventsPreview","fitnessPreview","yogaPreview","beautyPreview","realestatePreview","educationPreview","nonprofitPreview","musicPreview","personalPreview","landingPreview","comingSoonPreview","PREVIEWS","business","trades","professional","wellness","restaurant","store","portfolio","studio","photography","blog","events","fitness","yoga","beauty","realestate","education","nonprofit","music","personal","landing","AI_SITE_STYLE_PREVIEW_ALTS","AI_SITE_STYLE_PREVIEW_SIZE","width","height","urlOf","imported","src","aiSiteStylePreview","kindId","kind","find","entry","id","alt","label"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC;AAGD,SAASA,aAAa,QAAQ,4BAAwB;AACtD,OAAOC,qBAAqB,sCAAqC;AACjE,OAAOC,mBAAmB,oCAAmC;AAC7D,OAAOC,yBAAyB,0CAAyC;AACzE,OAAOC,qBAAqB,sCAAqC;AACjE,OAAOC,uBAAuB,wCAAuC;AACrE,OAAOC,kBAAkB,mCAAkC;AAC3D,OAAOC,sBAAsB,uCAAsC;AACnE,OAAOC,mBAAmB,oCAAmC;AAC7D,OAAOC,wBAAwB,yCAAwC;AACvE,OAAOC,iBAAiB,kCAAiC;AACzD,OAAOC,mBAAmB,oCAAmC;AAC7D,OAAOC,oBAAoB,qCAAoC;AAC/D,OAAOC,iBAAiB,kCAAiC;AACzD,OAAOC,mBAAmB,oCAAmC;AAC7D,OAAOC,uBAAuB,wCAAuC;AACrE,OAAOC,sBAAsB,uCAAsC;AACnE,OAAOC,sBAAsB,uCAAsC;AACnE,OAAOC,kBAAkB,mCAAkC;AAC3D,OAAOC,qBAAqB,sCAAqC;AACjE,OAAOC,oBAAoB,qCAAoC;AAC/D,OAAOC,uBAAuB,yCAAwC;AAEtE;;;;;;;;CAQC,GACD,MAAMC,WAA8C;IAClDC,UAAUtB;IACVuB,QAAQtB;IACRuB,cAActB;IACduB,UAAUtB;IACVuB,YAAYtB;IACZuB,OAAOtB;IACPuB,WAAWtB;IACXuB,QAAQtB;IACRuB,aAAatB;IACbuB,MAAMtB;IACNuB,QAAQtB;IACRuB,SAAStB;IACTuB,MAAMtB;IACNuB,QAAQtB;IACRuB,YAAYtB;IACZuB,WAAWtB;IACXuB,WAAWtB;IACXuB,OAAOtB;IACPuB,UAAUtB;IACVuB,SAAStB;IACT,eAAeC;AACjB;AAEA,kFAAkF,GAClF,OAAO,MAAMsB,6BAA+D;IAC1EpB,UAAU;IACVC,QAAQ;IACRC,cAAc;IACdC,UAAU;IACVC,YAAY;IACZC,OAAO;IACPC,WAAW;IACXC,QAAQ;IACRC,aAAa;IACbC,MAAM;IACNC,QAAQ;IACRC,SAAS;IACTC,MAAM;IACNC,QAAQ;IACRC,YAAY;IACZC,WAAW;IACXC,WAAW;IACXC,OAAO;IACPC,UAAU;IACVC,SAAS;IACT,eAAe;AACjB,EAAC;AAED,oDAAoD,GACpD,OAAO,MAAME,6BAA6B;IAAEC,OAAO;IAAKC,QAAQ;AAAI,EAAU;AAE9E,sFAAsF,GACtF,SAASC,MAAMC,QAAiB;IAC9B,IAAI,OAAOA,aAAa,UAAU,OAAOA;IACzC,IAAIA,YAAY,OAAOA,aAAa,YAAY,OAAO,AAACA,SAA+BC,GAAG,KAAK,UAAU;QACvG,OAAO,AAACD,SAA6BC,GAAG;IAC1C;IACA,OAAO;AACT;AAEA,uGAAuG,GACvG,OAAO,SAASC,mBAAmBC,MAAc;QAMxCR;IALP,MAAMM,MAAMF,MAAMzB,QAAQ,CAAC6B,OAAO;IAClC,MAAMC,OAAOpD,cAAcqD,IAAI,CAAC,CAACC,QAAUA,MAAMC,EAAE,KAAKJ;IACxD,IAAI,CAACF,OAAO,CAACG,MAAM,OAAO;IAC1B,OAAO;QACLH;QACAO,GAAG,GAAEb,qCAAAA,0BAA0B,CAACQ,OAAO,YAAlCR,qCAAsC,CAAC,4BAA4B,EAAES,KAAKK,KAAK,CAAC,MAAM,CAAC;OACzFb;AAEP"}

package/src/lib/insights/ai-insight-digest.d.ts

@@ -126,6 +126,8 @@ export interface AiInsightDigestDeps {
         /** The site the digest is about, and the org whose brand it wears (AGL-3367). */
         siteName: string;
         org: Record<string, unknown>;
+        /** The designed email's merge values, from {@link aiInsightDigestEmailParts}. */
+        merge?: Record<string, string>;
     }) => Promise<AiInsightDigestSendResult>;
     /** The console's absolute origin for an email link, or `''` when none is configured. */
     consoleOrigin: string;
@@ -167,6 +169,13 @@ export declare function aiInsightDigestEmailText(input: {
     /** The week the figures cover, "Oct 5 – Oct 11"; absent says "this week". */
     periodLabel?: string;
 }): string;
+/**
+ * The same digest as {@link aiInsightDigestEmailText}, cut into the parts the
+ * `ai-insights-digest` system email draws: the workspace and week above the
+ * heading, the insights as a numbered list, a button to the site's
+ * Analytics page, and why it came.
+ */
+export declare function aiInsightDigestEmailParts(input: Parameters<typeof aiInsightDigestEmailText>[0]): Record<'digest.eyebrow' | 'digest.intro' | 'digest.insights' | 'digest.analyticsUrl' | 'digest.why', string>;
 /**
  * One call of the sweep: delivery for this week and the last on the first
  * call, then — on a Monday — one chunk of workspaces' creation, resumed by

package/src/lib/insights/ai-insight-digest.js

@@ -66,6 +66,28 @@ const str = (value)=>typeof value === 'string' ? value.trim() : '';
         input.settingsUrl ? `You asked for weekly insights for ${forWhom}. Turn them off in Notifications: ${input.settingsUrl}` : `You asked for weekly insights for ${forWhom}. Turn them off in your Notifications settings.`
     ].join('\n');
 }
+/**
+ * The same digest as {@link aiInsightDigestEmailText}, cut into the parts the
+ * `ai-insights-digest` system email draws: the workspace and week above the
+ * heading, the insights as a numbered list, a button to the site's
+ * Analytics page, and why it came.
+ */ export function aiInsightDigestEmailParts(input) {
+    var _input_analyticsUrl;
+    var _input_workspaceName, _input_periodLabel;
+    const workspace = ((_input_workspaceName = input.workspaceName) == null ? void 0 : _input_workspaceName.trim()) || '';
+    const credits = Math.max(0, Math.round(Number(input.creditsSpent) || 0));
+    const forWhom = workspace || 'this workspace';
+    return {
+        'digest.eyebrow': [
+            workspace,
+            (_input_periodLabel = input.periodLabel) == null ? void 0 : _input_periodLabel.trim()
+        ].filter(Boolean).join(' · '),
+        'digest.intro': `What ${input.siteName}'s figures showed ${input.periodLabel ? 'last week' : 'this week'}. ` + 'Each one is traced to the figures it cites, so you can check it on the Analytics page.',
+        'digest.insights': input.insights.map((insight, index)=>`${index + 1}. ${insight.text}`).join('\n\n'),
+        'digest.analyticsUrl': (_input_analyticsUrl = input.analyticsUrl) != null ? _input_analyticsUrl : '',
+        'digest.why': `You asked for weekly insights for ${forWhom}.` + (credits ? ` Writing these used ${credits.toLocaleString('en-US')} of ${workspace ? `${workspace}’s` : 'the workspace’s'} AI credits.` : '') + (input.settingsUrl ? ` Turn them off in Notifications: ${input.settingsUrl}` : ' Turn them off in your Notifications settings.')
+    };
+}
 async function readUsers(firestore, uids) {
     if (!uids.length) return new Map();
     const docs = await firestore.getAll(...uids.map((uid)=>firestore.collection('users').doc(uid)));
@@ -232,22 +254,24 @@ async function readUsers(firestore, uids) {
             }
             const address = str((_member_email = member.email) != null ? _member_email : user == null ? void 0 : user.get('email')).toLowerCase();
             if (address.includes('@')) {
+                const emailInput = {
+                    siteName: site.name,
+                    productName: branding.productName,
+                    insights: record.insights,
+                    analyticsUrl,
+                    settingsUrl: origin ? `${origin}/manage/notifications` : null,
+                    workspaceName: str(org['name']),
+                    creditsSpent: job.creditsSpent,
+                    periodLabel: aiInsightDigestPeriod(job.inputs, new Date(Number(marker.createdAtMs) || now.getTime())).label
+                };
                 const sent = await deps.send({
                     to: address,
                     subject: `Your weekly insights for ${site.name}`,
-                    text: aiInsightDigestEmailText({
-                        siteName: site.name,
-                        productName: branding.productName,
-                        insights: record.insights,
-                        analyticsUrl,
-                        settingsUrl: origin ? `${origin}/manage/notifications` : null,
-                        workspaceName: str(org['name']),
-                        creditsSpent: job.creditsSpent,
-                        periodLabel: aiInsightDigestPeriod(job.inputs, new Date(Number(marker.createdAtMs) || now.getTime())).label
-                    }),
+                    text: aiInsightDigestEmailText(emailInput),
                     fromName: branding.fromName,
                     siteName: site.name,
-                    org
+                    org,
+                    merge: aiInsightDigestEmailParts(emailInput)
                 });
                 if (sent.rateLimited) {
                     // Nothing is marked, so the next run delivers this site whole.