@delmaredigital/payload-experiments 0.2.0-rc.7 → 0.3.0-rc.4

package/dist/admin/armSelect/ArmSelectField.js

@@ -1,9 +1,11 @@
 'use client';
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { fetchAllDocs } from '../../lib/fetchAllDocs.js';
 import { Banner, Button, SelectInput, useConfig, useField } from '@payloadcms/ui';
 import { useEffect, useState } from 'react';
 import { bindArmSelect, experimentId } from './armSelect.model.js';
 import { ARM_SELECT_COPY } from '../copy/armSelect.js';
+/** Only authored copy reaches the field; transport or parse errors read as unavailable. */ const knownCopy = (reason)=>reason instanceof Error && Object.values(ARM_SELECT_COPY).includes(reason.message) ? reason.message : ARM_SELECT_COPY.unavailable;
 export function ArmSelectField({ path, field, readOnly }) {
     const { config } = useConfig();
     const api = config.routes.api;
@@ -26,27 +28,17 @@ export function ArmSelectField({ path, field, readOnly }) {
         if (!point) return;
         const controller = new AbortController();
         async function list(statuses) {
-            const docs = [];
-            let page = 1;
-            while(!controller.signal.aborted){
-                const query = new URLSearchParams({
-                    depth: '0',
-                    limit: '100',
-                    page: String(page),
-                    'where[flagPoint][equals]': point,
-                    'where[status][in]': statuses
-                });
-                const response = await fetch(`${api}/xp-experiments?${query}`, {
-                    credentials: 'include',
-                    signal: controller.signal
-                });
-                if (!response.ok) throw new Error(response.status === 403 ? ARM_SELECT_COPY.forbidden : ARM_SELECT_COPY.unavailable);
-                const data = await response.json();
-                docs.push(...data.docs);
-                if (!data.hasNextPage) break;
-                page++;
-            }
-            return docs;
+            const query = new URLSearchParams({
+                depth: '0',
+                'where[flagPoint][equals]': point,
+                'where[status][in]': statuses
+            });
+            const response = await fetchAllDocs(`${api}/xp-experiments?${query}`, {
+                credentials: 'include',
+                signal: controller.signal
+            });
+            if (!response.ok) throw new Error(response.status === 403 ? ARM_SELECT_COPY.forbidden : ARM_SELECT_COPY.unavailable);
+            return response.docs;
         }
         void Promise.all([
             list('running,decided'),
@@ -63,7 +55,7 @@ export function ArmSelectField({ path, field, readOnly }) {
         }).catch((reason)=>{
             if (!controller.signal.aborted) setError({
                 key,
-                message: reason instanceof Error ? reason.message : ARM_SELECT_COPY.unavailable
+                message: knownCopy(reason)
             });
         });
         return ()=>controller.abort();

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

@@ -1,21 +1 @@
-import type { ArmIssue } from '../../collections/experiments/armInvariants.js';
-import type { Arm, ArmKey, ExperimentKind } from '../../types/contracts.js';
-export declare function defaultArms(kind?: ExperimentKind): Arm[];
-/** Keep content slots in step with the experiment kind, including an unset kind. */
-export declare function withSlotsFor(arms: Arm[], kind?: ExperimentKind): Arm[];
-export declare function totalWeight(arms: Arm[]): number;
-export declare function addVariant(arms: Arm[], kind?: ExperimentKind): Arm[];
-export declare function removeArm(arms: Arm[], key: ArmKey): Arm[];
-export declare function addHoldoutArm(arms: Arm[]): Arm[];
-export declare function removeHoldout(arms: Arm[]): Arm[];
-export declare function splitEvenly(arms: Arm[]): Arm[];
-export declare function setWeight(arms: Arm[], key: ArmKey, weight: number): Arm[];
-export declare function issuesByRow(arms: Arm[], kind?: ExperimentKind): {
-    rows: ArmIssue[][];
-    form: ArmIssue[];
-};
-export declare const ARM_FIELDS: readonly ["key", "label", "weight", "kind", "slot", "params", "pageTarget"];
-/** Payload arrays store each row's values at separate field paths. */
-export declare function readArms(fields: Record<string, {
-    value?: unknown;
-}>, path?: string): Arm[];
+export * from '../../arms/model.js';

package/dist/admin/arms/arms.model.js

@@ -1,153 +1 @@
-import { addHoldout, checkArms } from '../../collections/experiments/armInvariants.js';
-import { GROUP_LABELS } from '../copy/arms.js';
-const VARIANTS = [
-    'variantA',
-    'variantB',
-    'variantC'
-];
-export function defaultArms(kind) {
-    return withSlotsFor([
-        {
-            key: 'control',
-            kind: 'control',
-            label: GROUP_LABELS.control,
-            weight: 50
-        },
-        {
-            key: 'variantA',
-            kind: 'variant',
-            label: GROUP_LABELS.variantA,
-            weight: 50
-        }
-    ], kind);
-}
-/** Keep content slots in step with the experiment kind, including an unset kind. */ export function withSlotsFor(arms, kind) {
-    const next = arms.map((arm)=>{
-        if (kind === 'block' && arm.kind !== 'holdout') return arm.slot === arm.key ? arm : {
-            ...arm,
-            slot: arm.key
-        };
-        // Postgres returns null for unset columns; null counts as "no slot" so a loaded doc is not rewritten.
-        if (arm.slot == null) return arm;
-        const { slot: _slot, ...rest } = arm;
-        return rest;
-    });
-    return next.every((arm, index)=>arm === arms[index]) ? arms : next;
-}
-const finiteWeight = (weight)=>Number.isFinite(weight) ? weight : 0;
-export function totalWeight(arms) {
-    return arms.reduce((sum, arm)=>sum + finiteWeight(arm.weight), 0);
-}
-export function addVariant(arms, kind) {
-    if (!arms.some((arm)=>arm.kind === 'control')) return arms;
-    const key = VARIANTS.find((candidate)=>!arms.some((arm)=>arm.key === candidate));
-    if (!key || arms.filter((arm)=>arm.kind === 'variant').length >= 3) return arms;
-    const block = kind === 'block' || kind === undefined && arms.some((arm)=>arm.slot !== undefined);
-    const variant = {
-        key,
-        kind: 'variant',
-        label: GROUP_LABELS[key],
-        weight: 0,
-        ...block ? {
-            slot: key
-        } : {}
-    };
-    const index = arms.findIndex((arm)=>arm.kind === 'holdout');
-    const result = [
-        ...arms
-    ];
-    result.splice(index < 0 ? arms.length : index, 0, variant);
-    return result;
-}
-export function removeArm(arms, key) {
-    if (arms.some((arm)=>arm.key === key && arm.kind === 'control')) return arms;
-    if (key === 'holdout') return removeHoldout(arms);
-    return arms.filter((arm)=>arm.key !== key);
-}
-export function addHoldoutArm(arms) {
-    if (!arms.some((arm)=>arm.kind === 'control') || arms.some((arm)=>arm.kind === 'holdout' || arm.key === 'holdout')) return arms;
-    return addHoldout(arms.map((arm)=>Number.isFinite(arm.weight) ? arm : {
-            ...arm,
-            weight: 0
-        }));
-}
-// Largest remainder, with equal fractional remainders awarded to Original first.
-function distribute(arms, total, proportional) {
-    if (!arms.length) return arms;
-    const weightTotal = totalWeight(arms);
-    const useWeights = proportional && weightTotal > 0;
-    const denominator = useWeights ? weightTotal : arms.length;
-    const numerators = arms.map((arm)=>(useWeights ? finiteWeight(arm.weight) : 1) * total);
-    const weights = numerators.map((numerator)=>Math.floor(numerator / denominator));
-    const order = arms.map((_, i)=>i).sort((a, b)=>numerators[b] % denominator - numerators[a] % denominator || Number(arms[b].kind === 'control') - Number(arms[a].kind === 'control') || a - b);
-    const remainder = total - weights.reduce((sum, weight)=>sum + weight, 0);
-    for(let i = 0; i < remainder; i++)weights[order[i % order.length]]++;
-    return arms.map((arm, i)=>({
-            ...arm,
-            weight: weights[i]
-        }));
-}
-export function removeHoldout(arms) {
-    if (!arms.some((arm)=>arm.kind === 'holdout')) return arms;
-    return distribute(arms.filter((arm)=>arm.kind !== 'holdout'), totalWeight(arms), true);
-}
-export function splitEvenly(arms) {
-    const holdout = arms.find((arm)=>arm.kind === 'holdout');
-    const weight = finiteWeight(holdout?.weight ?? 0);
-    return [
-        ...distribute(arms.filter((arm)=>arm.kind !== 'holdout'), 100 - weight, false),
-        ...holdout ? [
-            {
-                ...holdout,
-                weight
-            }
-        ] : []
-    ];
-}
-export function setWeight(arms, key, weight) {
-    return arms.map((arm)=>arm.key === key ? {
-            ...arm,
-            weight
-        } : arm);
-}
-export function issuesByRow(arms, kind) {
-    const rows = arms.map(()=>[]);
-    const form = [];
-    for (const issue of checkArms(arms, kind)){
-        const index = issue.armIndex ?? arms.findIndex((arm)=>arm.key === issue.armKey);
-        if (index >= 0 && index < arms.length) rows[index].push(issue);
-        else form.push(issue);
-    }
-    return {
-        rows,
-        form
-    };
-}
-export const ARM_FIELDS = [
-    'key',
-    'label',
-    'weight',
-    'kind',
-    'slot',
-    'params',
-    'pageTarget'
-];
-/** Payload arrays store each row's values at separate field paths. */ export function readArms(fields, path = 'arms') {
-    const indices = new Set();
-    for (const name of Object.keys(fields)){
-        if (!name.startsWith(`${path}.`)) continue;
-        const [index, field] = name.slice(path.length + 1).split('.');
-        if (/^\d+$/.test(index) && field === 'key') indices.add(Number(index));
-    }
-    return [
-        ...indices
-    ].sort((a, b)=>a - b).map((index)=>Object.fromEntries(ARM_FIELDS.flatMap((field)=>{
-            const value = fields[`${path}.${index}.${field}`]?.value;
-            return value === undefined ? [] : [
-                [
-                    field,
-                    value
-                ]
-            ];
-        })));
-}
+export * from '../../arms/model.js';

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

@@ -8,13 +8,13 @@ export declare const ACTIONS_COPY: {
     readonly finish: "Finish archiving";
     readonly archive: "Archive";
     readonly discard: "Discard winner";
-    readonly startBody: "Start this experiment?";
+    readonly startBody: "Start this test?";
     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.";
     readonly original: "Everyone will see the Original.";
     readonly discardBody: "Everyone goes back to the Original. The decision note is kept.";
-    readonly archiveBody: "Archive this experiment?";
-    readonly finishBody: "The content has been updated. Finish archiving this experiment.";
+    readonly archiveBody: "Archive this test?";
+    readonly finishBody: "The content has been updated. Finish archiving this test.";
     readonly noResults: "There are no results yet.";
     readonly noRecommendation: "The results don't recommend a group yet.";
     readonly different: "You chose a different group than the results recommend.";
@@ -25,12 +25,48 @@ export declare const ACTIONS_COPY: {
     readonly cancel: "Cancel";
     readonly retry: "Retry";
     readonly done: "Done";
+    readonly dismiss: "Dismiss";
+    readonly dismissed: "Dismissed";
+    readonly undo: "Undo";
+    readonly contentArchived: "The winner is now the content and the test is archived.";
+    readonly dismissLabel: (page: string) => string;
+    readonly undoLabel: (page: string) => string;
+    readonly dismissHelp: "Dismiss a page you'll update by hand, then finish archiving.";
+    readonly contentEntryNotDecided: "This test isn't decided, so its pages can't be changed.";
+    readonly contentEntryMissing: "This page is no longer in the list. Reload to see the current list.";
+    readonly contentEntryDismissed: "This page was already dismissed.";
+    readonly contentEntryNotDismissed: "This page isn't dismissed. Reload to see its current state.";
+    readonly contentEntryUpdated: "This page is already updated.";
+    readonly contentEntryNotFound: "This test no longer exists.";
+    readonly contentEntryFallback: "This page can't be changed right now. Reload to see its current state.";
     readonly loading: "Loading results…";
     readonly updated: "Updated";
     readonly failed: "Failed";
+    readonly contentReasons: {
+        localized: string;
+        locked: string;
+        forbidden: string;
+        'not-found': string;
+        validation: string;
+        'update-failed': string;
+    };
+    readonly missingContent: "This page no longer exists; nothing to change.";
     readonly partial: "Some pages couldn't be updated. Fix them and retry.";
 };
 export declare const decideCopy: (winner: string, holdout: boolean, original: boolean) => string;
 export declare const releaseCopy: (winner: string) => string;
 export declare const makeContentCopy: (winner: string, kind: "block" | "page" | "flag") => string;
 export declare const hardCodedLabel: (winner: string) => string;
+/** Old reports can contain host error text: never interpolate an unknown string. */
+export declare const contentReportCopy: (reason: string | undefined, ok?: boolean) => string;
+export declare const CONTENT_ENTRY_REFUSALS: {
+    readonly notFound: "This test no longer exists.";
+    readonly codes: {
+        readonly 'not-decided': "This test isn't decided, so its pages can't be changed.";
+        readonly 'entry-not-found': "This page is no longer in the list. Reload to see the current list.";
+        readonly 'entry-ok': "This page is already updated.";
+        readonly 'entry-dismissed': "This page was already dismissed.";
+        readonly 'entry-not-dismissed': "This page isn't dismissed. Reload to see its current state.";
+    };
+    readonly fallback: "This page can't be changed right now. Reload to see its current state.";
+};

package/dist/admin/copy/actions.js

@@ -8,13 +8,13 @@ export const ACTIONS_COPY = {
     finish: 'Finish archiving',
     archive: 'Archive',
     discard: 'Discard winner',
-    startBody: 'Start this experiment?',
+    startBody: 'Start this test?',
     restartBody: 'Starting again begins a new round; results restart.',
     stopBody: 'Everyone will see the Original. Starting again begins a new round; results restart.',
     original: 'Everyone will see the Original.',
     discardBody: 'Everyone goes back to the Original. The decision note is kept.',
-    archiveBody: 'Archive this experiment?',
-    finishBody: 'The content has been updated. Finish archiving this experiment.',
+    archiveBody: 'Archive this test?',
+    finishBody: 'The content has been updated. Finish archiving this test.',
     noResults: 'There are no results yet.',
     noRecommendation: "The results don't recommend a group yet.",
     different: 'You chose a different group than the results recommend.',
@@ -25,12 +25,48 @@ export const ACTIONS_COPY = {
     cancel: 'Cancel',
     retry: 'Retry',
     done: 'Done',
+    dismiss: 'Dismiss',
+    dismissed: 'Dismissed',
+    undo: 'Undo',
+    contentArchived: 'The winner is now the content and the test is archived.',
+    dismissLabel: (page)=>`Dismiss ${page}`,
+    undoLabel: (page)=>`Undo dismiss ${page}`,
+    dismissHelp: "Dismiss a page you'll update by hand, then finish archiving.",
+    contentEntryNotDecided: "This test isn't decided, so its pages can't be changed.",
+    contentEntryMissing: 'This page is no longer in the list. Reload to see the current list.',
+    contentEntryDismissed: 'This page was already dismissed.',
+    contentEntryNotDismissed: "This page isn't dismissed. Reload to see its current state.",
+    contentEntryUpdated: 'This page is already updated.',
+    contentEntryNotFound: 'This test no longer exists.',
+    contentEntryFallback: "This page can't be changed right now. Reload to see its current state.",
     loading: 'Loading results…',
     updated: 'Updated',
     failed: 'Failed',
+    contentReasons: {
+        localized: "This page has more than one language; Make it the content can't publish it safely yet. Copy the winning version by hand.",
+        locked: 'Someone is editing this page. Wait for them to finish, then retry.',
+        forbidden: "You can't read or update this page. Ask someone with access to update it by hand. If it was deleted or moved to trash, discard the winner to archive this test.",
+        'not-found': 'This page could not be found. Check whether it was deleted.',
+        validation: "This page couldn't be saved automatically. Update it by hand, then retry.",
+        'update-failed': "This page couldn't be updated this time. Retry; if it keeps happening, ask a developer."
+    },
+    missingContent: 'This page no longer exists; nothing to change.',
     partial: "Some pages couldn't be updated. Fix them and retry."
 };
 export const decideCopy = (winner, holdout, original)=>original ? ACTIONS_COPY.original : holdout ? `Everyone except the holdout will see ${winner}. The holdout keeps seeing the Original so we can measure the shipped change.` : `Everyone will see ${winner}.`;
 export const releaseCopy = (winner)=>`The holdout will see ${winner} too. Measuring since shipping ends.`;
-export const makeContentCopy = (winner, kind)=>kind === 'flag' ? `Saves ${winner}'s settings as the new defaults so the experiment can be archived.` : `Copies ${winner} into the page content so the experiment can be archived.`;
+export const makeContentCopy = (winner, kind)=>kind === 'flag' ? `Saves ${winner}'s settings as the new defaults so the test can be archived.` : `Copies ${winner} into the page content so the test can be archived.`;
 export const hardCodedLabel = (winner)=>`The developer has hard-coded ${winner}`;
+/** Old reports can contain host error text: never interpolate an unknown string. */ export const contentReportCopy = (reason, ok = false)=>reason === 'not-found' && ok ? ACTIONS_COPY.missingContent : ACTIONS_COPY.contentReasons[reason !== undefined && Object.hasOwn(ACTIONS_COPY.contentReasons, reason) ? reason : 'update-failed'];
+// Each dismiss/restore refusal code has its own sentence; server text is never shown.
+export const CONTENT_ENTRY_REFUSALS = {
+    notFound: ACTIONS_COPY.contentEntryNotFound,
+    codes: {
+        'not-decided': ACTIONS_COPY.contentEntryNotDecided,
+        'entry-not-found': ACTIONS_COPY.contentEntryMissing,
+        'entry-ok': ACTIONS_COPY.contentEntryUpdated,
+        'entry-dismissed': ACTIONS_COPY.contentEntryDismissed,
+        'entry-not-dismissed': ACTIONS_COPY.contentEntryNotDismissed
+    },
+    fallback: ACTIONS_COPY.contentEntryFallback
+};

package/dist/admin/copy/armSelect.js

@@ -1,11 +1,11 @@
 export const ARM_SELECT_COPY = {
-    experiment: 'Experiment',
+    experiment: 'Test',
     group: 'Group',
     clear: 'Clear',
-    forbidden: "You can't see experiments. Ask an admin.",
-    unavailable: "Experiments couldn't be loaded. Reload and try again.",
-    loading: 'Loading experiments…',
+    forbidden: "You can't see tests. Ask an admin.",
+    unavailable: "Tests couldn't be loaded. Reload and try again.",
+    loading: 'Loading tests…',
     running: 'Changing this content mid-test mixes two versions in one result',
     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.`;
+export const staleExperiment = (name)=>`This was set for an earlier test${name ? ` (${name})` : ''} and won't be used now.`;

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

@@ -1,6 +1,5 @@
-import type { ArmIssueCode } from '../../types/endpoints.js';
 export { ARM_LABELS as GROUP_LABELS } from '../../labels/arms.js';
-export declare const ISSUE_COPY: Record<ArmIssueCode, string>;
+export { ISSUE_COPY, issueMessage } from '../../arms/copy.js';
 export declare const ARMS_COPY: {
     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 pageRequired: "Enter a page path for this group.";
@@ -12,7 +11,3 @@ export declare const ARMS_COPY: {
     readonly paramOption: "Choose an available option for {label}.";
     readonly paramCheckbox: "Choose yes or no for {label}.";
 };
-export declare function issueMessage(issue: {
-    code: string;
-    message: string;
-}, total: number): string;

package/dist/admin/copy/arms.js

@@ -1,16 +1,5 @@
 export { ARM_LABELS as GROUP_LABELS } from '../../labels/arms.js';
-export const ISSUE_COPY = {
-    'weights-total': 'Weights must add up to 100%. They add up to {total}% now.',
-    'control-count': 'Include exactly one Original.',
-    'control-first': 'Put the Original first.',
-    'holdout-last': 'Put the holdout last.',
-    'holdout-count': 'Include only one holdout.',
-    'variant-count': 'Include up to three variants.',
-    'duplicate-key': 'Each group must have a different standard name.',
-    'duplicate-slot': 'Each group must have a different content slot.',
-    'slot-required': 'Choose the matching content slot for this group.',
-    'invalid-key': 'Use the standard group names: Original, Variant A–C, Holdout.'
-};
+export { ISSUE_COPY, issueMessage } from '../../arms/copy.js';
 export const ARMS_COPY = {
     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.',
     pageRequired: 'Enter a page path for this group.',
@@ -22,7 +11,3 @@ export const ARMS_COPY = {
     paramOption: 'Choose an available option for {label}.',
     paramCheckbox: 'Choose yes or no for {label}.'
 };
-export function issueMessage(issue, total) {
-    const copy = Object.hasOwn(ISSUE_COPY, issue.code) ? ISSUE_COPY[issue.code] : issue.message;
-    return copy.replace('{total}', String(total));
-}

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

@@ -1,6 +1,6 @@
 export declare const AUDIENCE_COPY: {
     readonly listPlaceholder: "Type a value and press Enter";
-    readonly listDescription: "Add one value per chip, for example each page path.";
+    readonly listDescription: "Add one value per chip.";
     readonly removeValue: (value: string) => string;
     readonly removeSymbol: "×";
     readonly emptyListNote: "Add at least one value — an empty list can't be saved.";
@@ -25,6 +25,7 @@ export declare const eachVersion: (share: string) => string;
 export declare const groupShare: (share: string, label: string) => string;
 export declare const uncounted = "; the rest see the Original and are not counted";
 export declare const holdoutClause: (weight: string) => string;
+export declare const holdoutRemainder = "; everyone else sees the Original and is not counted";
 export declare const layerSentence: (name: string, used: number, free: number) => string;
 export declare const peopleLabel: {
     readonly visitor: "visitors";

package/dist/admin/copy/audience.js

@@ -1,6 +1,6 @@
 export const AUDIENCE_COPY = {
     listPlaceholder: 'Type a value and press Enter',
-    listDescription: 'Add one value per chip, for example each page path.',
+    listDescription: 'Add one value per chip.',
     removeValue: (value)=>`Remove ${value}`,
     removeSymbol: '×',
     emptyListNote: "Add at least one value — an empty list can't be saved."
@@ -24,7 +24,8 @@ export const participation = (allocation, people, groups)=>`${allocation}% of ${
 export const eachVersion = (share)=>`${share}% see each version`;
 export const groupShare = (share, label)=>`${share}% see ${label === 'Original' ? 'the Original' : label}`;
 export const uncounted = '; the rest see the Original and are not counted';
-export const holdoutClause = (weight)=>`; the holdout (${weight}% of them) sees the Original and is measured; everyone else sees the Original and is not counted.`;
+export const holdoutClause = (weight)=>`; the holdout (${weight}% of them) sees the Original and is measured`;
+export const holdoutRemainder = '; everyone else sees the Original and is not counted';
 export const layerSentence = (name, used, free)=>` Uses ${used} of the 100 slices in layer ${name}; ${free} are free.`;
 export const peopleLabel = {
     visitor: 'visitors',

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

@@ -1,5 +1,8 @@
 export declare const API_MESSAGES: {
-    readonly notFound: "This experiment no longer exists.";
+    readonly notFound: "This test no longer exists.";
+    readonly goalNotFound: "That goal no longer exists. Choose another goal.";
+    readonly roundChanged: "This round has changed. Reload the page.";
+    readonly roundNotFound: "That round no longer exists. Choose another round.";
     readonly commitUnverified: "The change may not have been saved. Reload and try again.";
     readonly notImplemented: "This isn't available yet.";
     readonly unauthenticated: "Your session has expired. Sign in again.";
@@ -9,12 +12,16 @@ export declare const API_MESSAGES: {
     readonly unreadable: "Couldn't read the server's response. Reload and try again.";
 };
 export declare const LOCKED_MESSAGES: {
-    readonly creation: "Set when the experiment was created.";
+    readonly creation: "Set when the test was created.";
     readonly running: "Locked while the test is running so everyone in this round sees the same thing. Stop the test to change it.";
-    readonly runningAllocation: "Raise it from the actions panel; lowering takes effect in the next round.";
-    readonly runningMetrics: "Add supporting metrics or guardrails from the actions panel; the main metric is fixed for this round.";
+    readonly runningAllocation: "To include more people, use \"Let more people in\" at the bottom of the page. To include fewer, stop the test; the change applies when you start it again.";
+    readonly runningMetrics: "Add a guardrail or something to watch with \"Add a goal\" at the bottom of the page; the main goal is fixed for this round.";
     readonly decided: "Locked after the decision.";
-    readonly archived: "Archived experiments can't be changed.";
+    readonly archived: "Archived tests can't be changed.";
     readonly other: "Can't be changed in this state.";
 };
-export declare function refusalMessage(code: string | undefined, status: number, message?: string): string;
+export declare function refusalMessage(code: string | undefined, status: number, message?: string, options?: {
+    notFound?: string;
+    codes?: Readonly<Record<string, string>>;
+    fallback?: string;
+}): string;

package/dist/admin/copy/common.js

@@ -1,5 +1,8 @@
 export const API_MESSAGES = {
-    notFound: 'This experiment no longer exists.',
+    notFound: 'This test no longer exists.',
+    goalNotFound: 'That goal no longer exists. Choose another goal.',
+    roundChanged: 'This round has changed. Reload the page.',
+    roundNotFound: 'That round no longer exists. Choose another round.',
     commitUnverified: 'The change may not have been saved. Reload and try again.',
     notImplemented: "This isn't available yet.",
     unauthenticated: 'Your session has expired. Sign in again.',
@@ -9,19 +12,22 @@ export const API_MESSAGES = {
     unreadable: "Couldn't read the server's response. Reload and try again."
 };
 export const LOCKED_MESSAGES = {
-    creation: 'Set when the experiment was created.',
+    creation: 'Set when the test was created.',
     running: 'Locked while the test is running so everyone in this round sees the same thing. Stop the test to change it.',
-    runningAllocation: 'Raise it from the actions panel; lowering takes effect in the next round.',
-    runningMetrics: 'Add supporting metrics or guardrails from the actions panel; the main metric is fixed for this round.',
+    runningAllocation: 'To include more people, use "Let more people in" at the bottom of the page. To include fewer, stop the test; the change applies when you start it again.',
+    runningMetrics: 'Add a guardrail or something to watch with "Add a goal" at the bottom of the page; the main goal is fixed for this round.',
     decided: 'Locked after the decision.',
-    archived: "Archived experiments can't be changed.",
+    archived: "Archived tests can't be changed.",
     other: "Can't be changed in this state."
 };
-export function refusalMessage(code, status, message) {
+export function refusalMessage(code, status, message, options) {
+    // A per-call code wins over the status branches: entry-not-found is a 404 that is not "this test no longer exists".
+    const mapped = code && options?.codes && Object.hasOwn(options.codes, code) ? options.codes[code] : undefined;
+    if (mapped !== undefined) return mapped;
     if (code === 'unauthenticated' || status === 401) return API_MESSAGES.unauthenticated;
-    if (code === 'not-found' || status === 404) return API_MESSAGES.notFound;
+    if (code === 'not-found' || status === 404) return options?.notFound ?? API_MESSAGES.notFound;
     if (code === 'commit-unverified') return API_MESSAGES.commitUnverified;
     if (code === 'not-implemented' || status === 501) return API_MESSAGES.notImplemented;
     if (code === 'forbidden' || status === 403) return API_MESSAGES.forbidden;
-    return message || API_MESSAGES.failed;
+    return options?.fallback ?? (message || API_MESSAGES.failed);
 }

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

@@ -1,23 +1,25 @@
 export declare const GOALS_COPY: {
     readonly title: "Goals";
+    readonly goal: "Goal";
     readonly newGoal: "New goal";
     readonly name: "Name";
     readonly source: "Measured by";
     readonly directionColumn: "Better when";
     readonly direction: "Better when it goes";
-    readonly increase: "Goes up";
-    readonly decrease: "Goes down";
+    readonly increase: "More is better";
+    readonly decrease: "Less is better";
     readonly usedBy: "Used by";
     readonly status: "Status";
     readonly inUse: "In use";
-    readonly unused: "Not used";
-    readonly empty: "A goal is an outcome you want a test to improve, such as a registration or a gift.";
+    readonly unused: "Not used yet";
+    readonly empty: "No goals yet. A goal is what a test tries to improve.";
     readonly loading: "Loading goals…";
     readonly loadError: "Couldn't load goals. Try again.";
     readonly retry: "Try again";
     readonly slug: "Short name";
     readonly slugHelp: "A unique short name for this goal.";
     readonly slugLocked: "The short name stays the same once a test uses this goal.";
+    readonly sourceLocked: "What this goal measures stays the same once a test uses it.";
     readonly chooseSource: "Choose an outcome";
     readonly window: "Count results for (hours)";
     readonly minimum: "Minimum completions before deciding";
@@ -33,12 +35,25 @@ export declare const GOALS_COPY: {
     readonly save: "Save";
     readonly saving: "Saving…";
     readonly cancel: "Cancel";
-    readonly remove: "Delete";
+    readonly remove: "Delete goal";
     readonly thresholdError: "Enter a percentage of zero or more, or leave blank for 5%.";
     readonly deleting: "Deleting…";
     readonly saveError: "Couldn't save the goal. Try again.";
     readonly deleteError: "Couldn't delete the goal. Try again.";
     readonly breadcrumb: "Breadcrumb";
-    readonly missing: "This goal could not be found.";
+    readonly missing: "This goal no longer exists.";
+    readonly notFound: "This goal no longer exists.";
+    readonly backToTest: "Back to the test";
+    readonly useGoal: "Use this goal";
+    readonly open: "Open";
+    readonly search: "Search goals";
+    readonly clearSearch: "Clear search";
+    readonly fields: "Goal details";
+    readonly deleteTitle: "Delete this goal?";
+    readonly deleteBody: "This cannot be undone.";
+    readonly confirmDelete: "Delete";
 };
 export declare function goalUsedBy(count: number): string;
+export declare function goalInUse(count: number): string;
+export declare function goalDeleteLocked(count: number): string;
+export declare function goalsNoMatches(search: string): string;