@delmaredigital/payload-experiments 0.1.0-rc.6 → 0.2.0-rc.1

package/README.md

@@ -1,5 +1,7 @@
 # @delmaredigital/payload-experiments
 
+> ⚠️ Upgrading to 0.2? After upgrading, run `payload generate:importmap`: the Tests surface is registered through admin.dependencies, and without it the Tests routes show a 'not installed' message instead of the Tests screen. The old experiments edit-form components are gone from `/admin/client`, and the `xp-experiments` admin list and edit views now redirect to the Tests surface.
+
 A/B testing for Payload CMS and Next.js, with results inside the admin and data
 in your own Postgres database. Editors can test blocks, whole pages and
 registered flag points, choose a winner, and make it the permanent content.
@@ -387,6 +389,32 @@ are recorded with `trackConversion`. Beacon conversions for a non-writable name
 are dropped silently. Only listed names become `events:<name>` sources. They
 support visitor and user units and do not represent counts or revenue in v1.
 
+### `admin` options
+
+Host links and kind descriptions are optional. For a host using payload-puck's
+editor route and a `puck-templates` collection, pass:
+
+```ts
+admin: {
+  editorUrl: ({ collection, id, draft }) =>
+    `/admin/puck-editor/${encodeURIComponent(collection)}/${encodeURIComponent(String(id))}`,
+  previewUrl: ({ id }) => `/preview/template/${encodeURIComponent(String(id))}`,
+  descriptions: {
+    block: 'Try different content on a landing page.',
+    document: 'Try different versions of a donation ask.',
+    setting: 'Try a different signup or donation prompt.',
+  },
+}
+```
+
+Use your host's preview route for `previewUrl`. Preflight resolves both URL
+callbacks on the server for block placements; it passes only URL strings to the
+client. Missing or failed callbacks leave the URL unset, and the client uses the
+admin collection route when no editor URL is supplied. Kind descriptions are
+available to the server views through `config.custom.xp`.
+
+A flag point can also declare `description?: string` to explain the setting below its label.
+
 ## Security
 
 The unit cookie, assignments header, request-context header and preview tokens

package/dist/admin/LayerUsage.d.ts

@@ -1,2 +1,2 @@
 import type { UIFieldClientProps } from 'payload';
-export declare function LayerUsage(_props: UIFieldClientProps): import("react").JSX.Element | null;
+export declare function LayerUsage({ field, path }: UIFieldClientProps): import("react").JSX.Element;

package/dist/admin/LayerUsage.js

@@ -1,24 +1,36 @@
 'use client';
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useDocumentInfo } from '@payloadcms/ui';
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { FieldDescription, FieldLabel, useDocumentInfo } from '@payloadcms/ui';
 import { useLayerExperiments } from './useLayerUsage.js';
 import { statusLabel } from './labels.js';
 import { HISTORY_COPY, layerRow, layerSummary } from './copy/history.js';
-export function LayerUsage(_props) {
+export function LayerUsage({ field, path }) {
     const { id } = useDocumentInfo();
     const usage = useLayerExperiments(id ?? null);
-    if (id == null || !usage) return null;
     return /*#__PURE__*/ _jsxs("section", {
         "aria-label": HISTORY_COPY.layers,
         children: [
-            /*#__PURE__*/ _jsx("p", {
-                children: layerSummary(usage.used, usage.free)
+            /*#__PURE__*/ _jsx(FieldLabel, {
+                as: "h3",
+                label: field.label,
+                path: path
             }),
-            /*#__PURE__*/ _jsx("ul", {
-                children: usage.rows.map((row, index)=>/*#__PURE__*/ _jsx("li", {
-                        children: layerRow(row.name, statusLabel(row.status), row.slices)
-                    }, index))
-            })
+            /*#__PURE__*/ _jsx(FieldDescription, {
+                description: field.admin?.description,
+                path: path
+            }),
+            usage ? /*#__PURE__*/ _jsxs(_Fragment, {
+                children: [
+                    /*#__PURE__*/ _jsx("p", {
+                        children: layerSummary(usage.used, usage.free)
+                    }),
+                    /*#__PURE__*/ _jsx("ul", {
+                        children: usage.rows.map((row, index)=>/*#__PURE__*/ _jsx("li", {
+                                children: layerRow(row.name, statusLabel(row.status), row.slices)
+                            }, index))
+                    })
+                ]
+            }) : null
         ]
     });
 }

package/dist/admin/MetricSourceSelect.js

@@ -15,7 +15,8 @@ export function MetricSourceSelect({ path, field, readOnly }) {
             /*#__PURE__*/ _jsx(SelectInput, {
                 path: path,
                 name: path,
-                label: METRICS_COPY.source,
+                label: field.label ?? METRICS_COPY.source,
+                description: field.admin?.description,
                 required: field.required,
                 options: metricSourceOptions(sources),
                 value: value ?? '',

package/dist/admin/TestsNavLink.d.ts

@@ -0,0 +1 @@
+export declare function TestsNavLink(): import("react").JSX.Element;

package/dist/admin/TestsNavLink.js

@@ -0,0 +1,30 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Link, useConfig } from '@payloadcms/ui';
+import { formatAdminURL } from 'payload/shared';
+import { usePathname } from 'next/navigation.js';
+import { SURFACE_COPY } from './copy/surface.js';
+export function TestsNavLink() {
+    const { config } = useConfig();
+    const path = usePathname();
+    const href = formatAdminURL({
+        adminRoute: config.routes.admin,
+        path: '/experiments'
+    });
+    const base = href.replace(/\/$/, '');
+    const active = path === base || path?.startsWith(`${base}/`);
+    return /*#__PURE__*/ _jsxs(Link, {
+        href: href,
+        className: "nav__link",
+        "aria-current": active ? 'page' : undefined,
+        children: [
+            active ? /*#__PURE__*/ _jsx("div", {
+                className: "nav__link-indicator"
+            }) : null,
+            /*#__PURE__*/ _jsx("span", {
+                className: "nav__link-label",
+                children: SURFACE_COPY.title
+            })
+        ]
+    });
+}

package/dist/admin/allocation.model.js

@@ -1,6 +1,6 @@
 import { armLabel } from './labels.js';
 import { LOCKED_MESSAGES } from './copy/common.js';
-import { eachVersion, groupShare, holdoutClause, layerSentence, participation, peopleLabel, uncounted } from './copy/who.js';
+import { eachVersion, groupShare, holdoutClause, layerSentence, participation, peopleLabel, uncounted } from './copy/audience.js';
 const percent = (value)=>String(Math.round(value * 10) / 10);
 export function allocationSentence({ allocation, unitType, arms, layer, status }) {
     const groups = arms.filter((group)=>group.kind !== 'holdout');

package/dist/admin/copy/actions.d.ts

@@ -8,8 +8,6 @@ export declare const ACTIONS_COPY: {
     readonly finish: "Finish archiving";
     readonly archive: "Archive";
     readonly discard: "Discard winner";
-    readonly deleteNoteArchived: "Deleting removes this experiment's records and results. A winner that was already made permanent stays in place.";
-    readonly deleteNoteDraft: "Deleting removes this experiment and its settings.";
     readonly startBody: "Start this experiment?";
     readonly restartBody: "Starting again begins a new round; results restart.";
     readonly stopBody: "Everyone will see the Original. Starting again begins a new round; results restart.";

package/dist/admin/copy/actions.js

@@ -8,8 +8,6 @@ export const ACTIONS_COPY = {
     finish: 'Finish archiving',
     archive: 'Archive',
     discard: 'Discard winner',
-    deleteNoteArchived: "Deleting removes this experiment's records and results. A winner that was already made permanent stays in place.",
-    deleteNoteDraft: 'Deleting removes this experiment and its settings.',
     startBody: 'Start this experiment?',
     restartBody: 'Starting again begins a new round; results restart.',
     stopBody: 'Everyone will see the Original. Starting again begins a new round; results restart.',

package/dist/admin/copy/advanced.d.ts

@@ -0,0 +1,55 @@
+export declare const ADVANCED_COPY: {
+    readonly exposurePolicy: {
+        readonly label: "Exposure policy";
+        readonly help: "Choose when a person is counted as seeing a version.";
+    };
+    readonly policies: {
+        readonly render: "When rendered";
+        readonly viewport: "When visible";
+        readonly pageview: "On a page visit";
+        readonly manual: "When the host records it";
+    };
+    readonly method: {
+        readonly label: "Analysis method";
+        readonly help: "Sequential testing supports ongoing checks; Bayesian testing compares probabilities.";
+    };
+    readonly cuped: {
+        readonly label: "CUPED";
+        readonly help: "Use earlier activity when available to reduce noise in the results.";
+    };
+    readonly minExposuresPerArm: {
+        readonly label: "Minimum people per version";
+        readonly help: "Wait for at least this many people in each version before a decision.";
+    };
+    readonly attributionWindowHours: {
+        readonly label: "Attribution window (hours)";
+        readonly help: "Count outcomes within this many hours after someone first sees a version.";
+    };
+    readonly sequentialTuningParameter: {
+        readonly label: "Sequential tuning parameter";
+        readonly help: "Set the expected sample size used to tune sequential testing.";
+    };
+    readonly layer: {
+        readonly label: "Layer";
+        readonly help: "A layer keeps tests from sharing the same people and is chosen at creation.";
+    };
+    readonly slug: {
+        readonly label: "Slug";
+        readonly help: "This permanent identifier connects the test to its content.";
+    };
+    readonly kind: {
+        readonly label: "Kind";
+        readonly help: "The kind determines where versions live and is chosen at creation.";
+    };
+    readonly unitType: {
+        readonly label: "Unit type";
+        readonly help: "Count visitors or signed-in users, as chosen at creation.";
+    };
+    readonly inheritedWindow: "Use each goal's window";
+    readonly automaticTuning: "Automatic (5,000)";
+    readonly sequential: "Sequential";
+    readonly bayesian: "Bayesian";
+    readonly auto: "Automatic";
+    readonly off: "Off";
+    readonly none: "None";
+};

package/dist/admin/copy/advanced.js

@@ -0,0 +1,55 @@
+export const ADVANCED_COPY = {
+    exposurePolicy: {
+        label: 'Exposure policy',
+        help: 'Choose when a person is counted as seeing a version.'
+    },
+    policies: {
+        render: 'When rendered',
+        viewport: 'When visible',
+        pageview: 'On a page visit',
+        manual: 'When the host records it'
+    },
+    method: {
+        label: 'Analysis method',
+        help: 'Sequential testing supports ongoing checks; Bayesian testing compares probabilities.'
+    },
+    cuped: {
+        label: 'CUPED',
+        help: 'Use earlier activity when available to reduce noise in the results.'
+    },
+    minExposuresPerArm: {
+        label: 'Minimum people per version',
+        help: 'Wait for at least this many people in each version before a decision.'
+    },
+    attributionWindowHours: {
+        label: 'Attribution window (hours)',
+        help: 'Count outcomes within this many hours after someone first sees a version.'
+    },
+    sequentialTuningParameter: {
+        label: 'Sequential tuning parameter',
+        help: 'Set the expected sample size used to tune sequential testing.'
+    },
+    layer: {
+        label: 'Layer',
+        help: 'A layer keeps tests from sharing the same people and is chosen at creation.'
+    },
+    slug: {
+        label: 'Slug',
+        help: 'This permanent identifier connects the test to its content.'
+    },
+    kind: {
+        label: 'Kind',
+        help: 'The kind determines where versions live and is chosen at creation.'
+    },
+    unitType: {
+        label: 'Unit type',
+        help: 'Count visitors or signed-in users, as chosen at creation.'
+    },
+    inheritedWindow: "Use each goal's window",
+    automaticTuning: 'Automatic (5,000)',
+    sequential: 'Sequential',
+    bayesian: 'Bayesian',
+    auto: 'Automatic',
+    off: 'Off',
+    none: 'None'
+};

package/dist/admin/copy/armSelect.js

@@ -6,6 +6,6 @@ export const ARM_SELECT_COPY = {
     unavailable: "Experiments couldn't be loaded. Reload and try again.",
     loading: 'Loading experiments…',
     running: 'Changing this content mid-test mixes two versions in one result',
-    noFlagPoint: 'No flag point is configured for this field.'
+    noFlagPoint: 'No setting is configured for this field.'
 };
 export const staleExperiment = (name)=>`This was set for an earlier experiment${name ? ` (${name})` : ''} and won't be used now.`;

package/dist/admin/copy/arms.d.ts

@@ -8,22 +8,9 @@ export declare const GROUP_LABELS: {
     readonly holdout: "Holdout";
 };
 export declare const ARMS_COPY: {
-    readonly groups: "Groups";
-    readonly label: "Group label";
-    readonly weight: "Weight (%)";
-    readonly slot: "Content slot";
-    readonly addVariant: "Add a variant";
-    readonly addHoldout: "Add a holdout";
-    readonly removeHoldout: "Remove holdout";
-    readonly removeVariant: "Remove variant";
-    readonly splitEvenly: "Split evenly";
     readonly holdout: "The holdout sees the Original and is measured but not compared during the test. After you decide, it keeps seeing the Original so the winner can be compared with it.";
-    readonly pagePath: "Page path";
-    readonly holdoutPage: "Sees the Original's page";
     readonly pageRequired: "Enter a page path for this group.";
     readonly pageInvalid: "Use a page path starting with /, without a host, query or fragment.";
-    readonly flagPoint: "Flag point";
-    readonly controlParams: "The Original uses this flag point's current defaults. These values are checked again at Start.";
     readonly paramRequired: "Enter a value for {label}.";
     readonly paramNumber: "Enter a number for {label}.";
     readonly paramMin: "{label} must be at least {min}.";

package/dist/admin/copy/arms.js

@@ -18,22 +18,9 @@ export const GROUP_LABELS = {
     holdout: 'Holdout'
 };
 export const ARMS_COPY = {
-    groups: 'Groups',
-    label: 'Group label',
-    weight: 'Weight (%)',
-    slot: 'Content slot',
-    addVariant: 'Add a variant',
-    addHoldout: 'Add a holdout',
-    removeHoldout: 'Remove holdout',
-    removeVariant: 'Remove variant',
-    splitEvenly: 'Split evenly',
     holdout: 'The holdout sees the Original and is measured but not compared during the test. After you decide, it keeps seeing the Original so the winner can be compared with it.',
-    pagePath: 'Page path',
-    holdoutPage: "Sees the Original's page",
     pageRequired: 'Enter a page path for this group.',
     pageInvalid: 'Use a page path starting with /, without a host, query or fragment.',
-    flagPoint: 'Flag point',
-    controlParams: "The Original uses this flag point's current defaults. These values are checked again at Start.",
     paramRequired: 'Enter a value for {label}.',
     paramNumber: 'Enter a number for {label}.',
     paramMin: '{label} must be at least {min}.',

package/dist/admin/copy/{who.d.ts → audience.d.ts}

@@ -1,12 +1,4 @@
-export declare const WHO_COPY: {
-    readonly allocation: "Who takes part (%)";
-    readonly attribute: "Attribute";
-    readonly operator: "Comparison";
-    readonly value: "Value";
-    readonly true: "Yes";
-    readonly false: "No";
-    readonly caseNote: "Letter case doesn't matter.";
-    readonly listNote: "Separate values with commas.";
+export declare const AUDIENCE_COPY: {
     readonly emptyListNote: "Add at least one value — an empty list can't be saved.";
 };
 export declare const STRING_OP_LABELS: {

package/dist/admin/copy/{who.js → audience.js}

@@ -1,12 +1,4 @@
-export const WHO_COPY = {
-    allocation: 'Who takes part (%)',
-    attribute: 'Attribute',
-    operator: 'Comparison',
-    value: 'Value',
-    true: 'Yes',
-    false: 'No',
-    caseNote: "Letter case doesn't matter.",
-    listNote: 'Separate values with commas.',
+export const AUDIENCE_COPY = {
     emptyListNote: "Add at least one value — an empty list can't be saved."
 };
 export const STRING_OP_LABELS = {

package/dist/admin/copy/history.d.ts

@@ -1,9 +1,5 @@
 export declare const HISTORY_COPY: {
     layers: string;
-    rounds: string;
-    now: string;
-    decided: string;
 };
 export declare const layerSummary: (used: number, free: number) => string;
 export declare const layerRow: (name: string, status: string, slices: number) => string;
-export declare const roundRow: (phase: number, kind: string, from: string, to: string, weights: string) => string;

package/dist/admin/copy/history.js

@@ -1,9 +1,5 @@
 export const HISTORY_COPY = {
-    layers: 'Layer usage',
-    rounds: 'Rounds',
-    now: 'now',
-    decided: 'Decided by an editor'
+    layers: 'Tests in this group'
 };
-export const layerSummary = (used, free)=>`${used} of 100 slices in use; ${free} free.`;
-export const layerRow = (name, status, slices)=>`${name} · ${status} · ${slices} slice${slices === 1 ? '' : 's'}`;
-export const roundRow = (phase, kind, from, to, weights)=>`Round ${phase} · ${kind} · ${from} – ${to} · ${weights}`;
+export const layerSummary = (used, free)=>`${used}% of people in this group are in a test; ${free}% are free.`;
+export const layerRow = (name, status, slices)=>`${name} · ${status} · ${slices}%`;

package/dist/admin/copy/metrics.d.ts

@@ -1,6 +1,6 @@
 export declare const METRICS_COPY: {
-    readonly source: "Outcome source";
-    readonly revenueHint: "Unusually large values are capped at the 99th percentile of the 90 days before Start for the decision; totals are always shown in full.";
+    readonly source: "Measured by";
+    readonly revenueHint: "Very large amounts are counted only up to the level that the top 1% of amounts reached in the 90 days before the test starts; totals are always shown in full.";
 };
 export declare const METRIC_KIND_LABELS: {
     readonly binomial: "yes/no";

package/dist/admin/copy/metrics.js

@@ -1,6 +1,6 @@
 export const METRICS_COPY = {
-    source: 'Outcome source',
-    revenueHint: 'Unusually large values are capped at the 99th percentile of the 90 days before Start for the decision; totals are always shown in full.'
+    source: 'Measured by',
+    revenueHint: 'Very large amounts are counted only up to the level that the top 1% of amounts reached in the 90 days before the test starts; totals are always shown in full.'
 };
 export const METRIC_KIND_LABELS = {
     binomial: 'yes/no',

package/dist/admin/copy/newTest.d.ts

@@ -0,0 +1,32 @@
+export declare const NEW_TEST_COPY: {
+    readonly question: "What do you want to test?";
+    readonly block: "A block on a page";
+    readonly setting: "A setting";
+    readonly blockMeaning: "Compare different versions of content on a page.";
+    readonly settingMeaning: "Compare different choices for a setting on your site.";
+    readonly unavailable: "A developer needs to set up pages or settings before you can create a test.";
+    readonly handoff: "Open the page, add an Experiment block where you want the test, and choose Test this block.";
+    readonly noPages: "There are no pages yet.";
+    readonly recentPages: "Showing the 50 most recently edited.";
+    readonly open: "Open";
+    readonly chooseSetting: "Which setting do you want to test?";
+    readonly people: "Count people as:";
+    readonly visitors: "Visitors";
+    readonly users: "Signed-in users";
+    readonly peopleHelp: "Count each browser as a visitor, or each signed-in account as one person.";
+    readonly advanced: "Advanced";
+    readonly group: "Put this test in a group (optional)";
+    readonly noGroup: "No group";
+    readonly groupHelp: "The group keeps tests from sharing the same people and can't be changed later.";
+    readonly groupsError: "Couldn't load groups. Try again.";
+    readonly groupsLoading: "Loading groups…";
+    readonly retry: "Try again";
+    readonly nameQuestion: "What will you call this test?";
+    readonly name: "Name";
+    readonly hypothesis: "Why are you testing this? (optional)";
+    readonly back: "Back";
+    readonly next: "Next";
+    readonly createTest: "Create";
+    readonly creating: "Creating…";
+    readonly createError: "Couldn't create the test. Try again.";
+};

package/dist/admin/copy/newTest.js

@@ -0,0 +1,32 @@
+export const NEW_TEST_COPY = {
+    question: 'What do you want to test?',
+    block: 'A block on a page',
+    setting: 'A setting',
+    blockMeaning: 'Compare different versions of content on a page.',
+    settingMeaning: 'Compare different choices for a setting on your site.',
+    unavailable: 'A developer needs to set up pages or settings before you can create a test.',
+    handoff: 'Open the page, add an Experiment block where you want the test, and choose Test this block.',
+    noPages: 'There are no pages yet.',
+    recentPages: 'Showing the 50 most recently edited.',
+    open: 'Open',
+    chooseSetting: 'Which setting do you want to test?',
+    people: 'Count people as:',
+    visitors: 'Visitors',
+    users: 'Signed-in users',
+    peopleHelp: 'Count each browser as a visitor, or each signed-in account as one person.',
+    advanced: 'Advanced',
+    group: 'Put this test in a group (optional)',
+    noGroup: 'No group',
+    groupHelp: "The group keeps tests from sharing the same people and can't be changed later.",
+    groupsError: "Couldn't load groups. Try again.",
+    groupsLoading: 'Loading groups…',
+    retry: 'Try again',
+    nameQuestion: 'What will you call this test?',
+    name: 'Name',
+    hypothesis: 'Why are you testing this? (optional)',
+    back: 'Back',
+    next: 'Next',
+    createTest: 'Create',
+    creating: 'Creating…',
+    createError: "Couldn't create the test. Try again."
+};

package/dist/admin/copy/readiness.d.ts

@@ -0,0 +1,45 @@
+export declare const READINESS_COPY: {
+    readonly ready: "Ready to start.";
+    readonly saveFirst: "Save your changes first.";
+    readonly saving: "Saving…";
+    readonly saved: "Saved";
+    readonly saveError: "Couldn't save — see the highlighted field";
+    readonly checkError: "Couldn't check readiness. Try again.";
+    readonly checking: "Checking readiness…";
+    readonly retry: "Try again";
+    readonly archived: "Archived.";
+    readonly running: "Running";
+    readonly stopped: "Stopped";
+    readonly decided: "Decided";
+    readonly addMetric: "Add a guardrail or something to watch";
+    readonly allocate: "Let more people in";
+    readonly everyone: "Everyone already takes part.";
+    readonly participation: "How many people take part (%)";
+    readonly noPlacements: "Not on a page yet. Open a page, add an Experiment block and choose this test.";
+    readonly noPoint: "Choose the setting to test.";
+    readonly busy: "Another test is already running on this setting. Stop it first.";
+    readonly noGoal: "Choose a goal.";
+    readonly unknownGoal: "This goal's data source isn't available. Choose another goal.";
+    readonly noDuration: "Choose how long to run it.";
+    readonly noReach: "Enter how many people reach this per day.";
+    readonly full: "This test's group is full. Lower how many people take part, or create the test again without the group.";
+    readonly differentPeople: "This test's group counts different people. Create the test again without the group.";
+    readonly noTargets: "Add a page address for each version.";
+    readonly pageVisitors: "Whole-page tests count visitors. Create the test again counting visitors.";
+    readonly ruleFallback: "check the value";
+    readonly versionFallback: "check the group settings";
+    readonly groupFallback: "each version";
+    readonly parameterFallback: "each setting";
+    readonly attributeFallback: "this attribute";
+};
+export declare const nextCopy: (sentence: string) => string;
+export declare const versionsNext: (detail: string) => string;
+export declare const contentNext: (group: string) => string;
+export declare const parameterNext: (parameter: string, group: string) => string;
+export declare const placementNext: (group: string, detail: string) => string;
+export declare const goalPeopleNext: (people: string) => string;
+export declare const ruleNext: (detail: string) => string;
+export declare const attributeNext: (attribute: string) => string;
+export declare const stoppedCopy: (date: string | null) => string;
+export declare const decidedCopy: (date: string | null, winner: string) => string;
+export declare const runningCopy: (date: string | null, people: number | null, days: number | null) => string;

package/dist/admin/copy/readiness.js

@@ -0,0 +1,50 @@
+export const READINESS_COPY = {
+    ready: 'Ready to start.',
+    saveFirst: 'Save your changes first.',
+    saving: 'Saving…',
+    saved: 'Saved',
+    saveError: "Couldn't save — see the highlighted field",
+    checkError: "Couldn't check readiness. Try again.",
+    checking: 'Checking readiness…',
+    retry: 'Try again',
+    archived: 'Archived.',
+    running: 'Running',
+    stopped: 'Stopped',
+    decided: 'Decided',
+    addMetric: 'Add a guardrail or something to watch',
+    allocate: 'Let more people in',
+    everyone: 'Everyone already takes part.',
+    participation: 'How many people take part (%)',
+    noPlacements: 'Not on a page yet. Open a page, add an Experiment block and choose this test.',
+    noPoint: 'Choose the setting to test.',
+    busy: 'Another test is already running on this setting. Stop it first.',
+    noGoal: 'Choose a goal.',
+    unknownGoal: "This goal's data source isn't available. Choose another goal.",
+    noDuration: 'Choose how long to run it.',
+    noReach: 'Enter how many people reach this per day.',
+    full: "This test's group is full. Lower how many people take part, or create the test again without the group.",
+    differentPeople: "This test's group counts different people. Create the test again without the group.",
+    noTargets: 'Add a page address for each version.',
+    pageVisitors: 'Whole-page tests count visitors. Create the test again counting visitors.',
+    ruleFallback: 'check the value',
+    versionFallback: 'check the group settings',
+    groupFallback: 'each version',
+    parameterFallback: 'each setting',
+    attributeFallback: 'this attribute'
+};
+const withoutPeriod = (value)=>value.trim().replace(/[.!?]+$/, '');
+export const nextCopy = (sentence)=>`Next: ${sentence}`;
+export const versionsNext = (detail)=>`Fix the versions: ${withoutPeriod(detail)}.`;
+export const contentNext = (group)=>`Add content for ${group} on the page.`;
+export const parameterNext = (parameter, group)=>`Set a value for ${parameter} on ${group}.`;
+export const placementNext = (group, detail)=>`Add content for ${group} wherever this setting is used${detail.trim() ? `: ${withoutPeriod(detail)}` : ''}.`;
+export const goalPeopleNext = (people)=>`This goal can't be measured for ${people}. Choose another goal.`;
+export const ruleNext = (detail)=>`Fix the rule: ${withoutPeriod(detail)}.`;
+export const attributeNext = (attribute)=>`Remove the rule on ${attribute}: it isn't available.`;
+export const stoppedCopy = (date)=>`Stopped${date ? ` ${date}` : ''}. Edit the versions, goal, audience or length below, then start again (results restart).`;
+export const decidedCopy = (date, winner)=>`Decided${date ? ` ${date}` : ''}: ${winner}.`;
+export const runningCopy = (date, people, days)=>[
+        date ? `Running since ${date}` : READINESS_COPY.running,
+        people === null ? null : `${people.toLocaleString('en-US')} people so far`,
+        days === null ? null : `about ${days} days to go`
+    ].filter(Boolean).join(' · ');

package/dist/admin/copy/recommendation.d.ts

@@ -0,0 +1,26 @@
+export declare const RECOMMENDATION_COPY: {
+    readonly unavailable: "Results aren't available right now. Recompute, and ask a developer if it keeps happening.";
+    readonly dataProblem: "Stop: the data looks unbalanced, check the setup.";
+    readonly collecting: "Too early to tell. Keep it running.";
+    readonly stoppedCollecting: "Stopped before enough people took part to tell.";
+    readonly originalBetter: "The Original is best. Keep the Original.";
+    readonly noDifference: "No difference found. Keep the Original, or test a bigger change.";
+    readonly keepRunning: "No difference so far. Keep running.";
+    readonly longDuration: "No clear difference, and a clear answer would take more than 3 months at this traffic. Consider a bigger change.";
+    readonly group: "Variant";
+    readonly guardrail: "an important outcome";
+    readonly winner: "the winner";
+};
+export declare const guardrailRecommendation: (group: string, guardrail: string) => string;
+export declare const collectingRecommendation: (people: string) => string;
+export declare const worseRecommendation: (group: string) => string;
+export declare const winnerRecommendation: (group: string) => string;
+export declare const mixedRecommendation: (better: string, worse: string) => string;
+export declare const runningRecommendation: (date: string) => string;
+export declare const rolloutCollectingRecommendation: (winner: string) => string;
+export declare const rolloutReadoutRecommendation: (winner: string, lift: string) => string;
+export declare const RESULTS_SURFACE_COPY: {
+    readonly missing: "This test couldn't be found.";
+};
+/** Matches the stored server finding; it is not a new statistical decision. */
+export declare const storedGuardrailFinding: (group: string, guardrail: string) => string;

package/dist/admin/copy/recommendation.js

@@ -0,0 +1,25 @@
+export const RECOMMENDATION_COPY = {
+    unavailable: "Results aren't available right now. Recompute, and ask a developer if it keeps happening.",
+    dataProblem: 'Stop: the data looks unbalanced, check the setup.',
+    collecting: 'Too early to tell. Keep it running.',
+    stoppedCollecting: 'Stopped before enough people took part to tell.',
+    originalBetter: 'The Original is best. Keep the Original.',
+    noDifference: 'No difference found. Keep the Original, or test a bigger change.',
+    keepRunning: 'No difference so far. Keep running.',
+    longDuration: 'No clear difference, and a clear answer would take more than 3 months at this traffic. Consider a bigger change.',
+    group: 'Variant',
+    guardrail: 'an important outcome',
+    winner: 'the winner'
+};
+export const guardrailRecommendation = (group, guardrail)=>`Stop: ${group} is making ${guardrail} worse.`;
+export const collectingRecommendation = (people)=>`Too early to tell. About ${people} more people needed to be sure.`;
+export const worseRecommendation = (group)=>`No version beats the Original, and ${group} does worse. Keep the Original.`;
+export const winnerRecommendation = (group)=>`${group} is most likely to be best.`;
+export const mixedRecommendation = (better, worse)=>`Mixed: ${better} does better, ${worse} does worse. Review before deciding.`;
+export const runningRecommendation = (date)=>`No difference so far. Keep running until ${date}.`;
+export const rolloutCollectingRecommendation = (winner)=>`Since shipping ${winner}: still collecting data.`;
+export const rolloutReadoutRecommendation = (winner, lift)=>`Since shipping ${winner}: ${lift} compared with the holdout.`;
+export const RESULTS_SURFACE_COPY = {
+    missing: "This test couldn't be found."
+};
+/** Matches the stored server finding; it is not a new statistical decision. */ export const storedGuardrailFinding = (group, guardrail)=>`Stop: ${group} harms ${guardrail}.`;

package/dist/admin/copy/results.d.ts

@@ -75,4 +75,3 @@ export declare const conflictCopy: (share: string) => string;
 export declare const metricUnavailable: (name: string, reason: string) => string;
 export declare const chartSummary: (metric: string, groups: string, from: string, to: string, changes?: string[]) => string;
 export declare const contentChangeTitle: (date: string) => string;
-export declare const summaryLine: (exposures: string, days: string, verdict: string) => string;