@delmaredigital/payload-experiments 0.3.0-rc.4 → 0.4.0-rc.2

package/dist/admin/blocks/model.js

@@ -0,0 +1,45 @@
+import { hostBlocks } from '../../blocks/model.js';
+import { BLOCK_COPY, blockDecidedStatus, blockDraftStatus, blockFinishedStatus, blockPosition } from '../copy/blocks.js';
+export function liveStatus(status) {
+    return !!status && 'status' in status;
+}
+export function slotLabel(slot, status) {
+    return (liveStatus(status) ? status.arms.find((arm)=>arm.key !== 'holdout' && (arm.slot ?? arm.key) === slot)?.label : undefined) || BLOCK_COPY.slotLabels[slot] || slot;
+}
+export function statusSentence(status) {
+    if (!liveStatus(status)) return BLOCK_COPY.deleted;
+    const winner = status.arms.find((arm)=>arm.key === status.winnerArm);
+    const winnerLabel = winner?.label || BLOCK_COPY.slotLabels[status.winnerArm ?? 'control'] || status.winnerArm || BLOCK_COPY.slotLabels.control;
+    switch(status.status){
+        case 'draft':
+            return blockDraftStatus(status.name);
+        case 'running':
+            return BLOCK_COPY.running;
+        case 'stopped':
+            return BLOCK_COPY.stopped;
+        case 'decided':
+            return blockDecidedStatus(winnerLabel, status.rollout);
+        case 'archived':
+            return status.winnerArm ? blockFinishedStatus(winnerLabel) : BLOCK_COPY.discarded;
+    }
+}
+export function isOrphan(status) {
+    return !liveStatus(status) || status.status === 'archived' && !status.winnerArm;
+}
+export function labelText(value) {
+    return typeof value === 'string' ? value : value && typeof value === 'object' ? Object.values(value).find((item)=>typeof item === 'string') : undefined;
+}
+export function blockChoices(value, field, blockSlug) {
+    return hostBlocks(value).flatMap((block, index)=>{
+        if (block.blockType === blockSlug) return [];
+        const label = labelText(field.blocks.find((config)=>config.slug === block.blockType)?.labels?.singular) || block.blockType;
+        return [
+            {
+                block,
+                index,
+                label,
+                option: blockPosition(label, index + 1)
+            }
+        ];
+    });
+}

package/dist/admin/blocks/statusCache.d.ts

@@ -0,0 +1,9 @@
+import type { BlockStatus } from './model.js';
+export declare const validBlockSlug: (slug: unknown) => slug is string;
+/** Update a mounted owner's snapshot and invalidate an older pending read. */
+export declare function setBlockStatus(api: string, slug: string, value: BlockStatus): void;
+/** Only status fields own reads. StrictMode replays the same mount token; a
+ * different owner after the last cleanup starts fresh, even in the same commit.
+ * Deferred eviction removes every entry with no live owner after that commit.
+ */
+export declare function useBlockStatus(api: string, slug: unknown, owner?: boolean): BlockStatus | null;

package/dist/admin/blocks/statusCache.js

@@ -0,0 +1,92 @@
+import { useCallback, useEffect, useRef, useSyncExternalStore } from 'react';
+import { createApi } from '../api.js';
+const cache = new Map();
+// Subscribers do not create status entries: a label alone owns no cached data.
+const listeners = new Map();
+const keyOf = (api, slug)=>JSON.stringify([
+        api,
+        slug
+    ]);
+const publish = (key)=>listeners.get(key)?.callbacks.forEach((listener)=>listener());
+export const validBlockSlug = (slug)=>typeof slug === 'string' && slug.length > 0 && slug.length <= 64;
+/** Update a mounted owner's snapshot and invalidate an older pending read. */ export function setBlockStatus(api, slug, value) {
+    const key = keyOf(api, slug), current = cache.get(key);
+    if (!current) return;
+    current.revision++;
+    current.value = value;
+    publish(key);
+}
+/** Only status fields own reads. StrictMode replays the same mount token; a
+ * different owner after the last cleanup starts fresh, even in the same commit.
+ * Deferred eviction removes every entry with no live owner after that commit.
+ */ export function useBlockStatus(api, slug, owner = false) {
+    const key = validBlockSlug(slug) ? keyOf(api, slug) : undefined;
+    const token = useRef({});
+    const subscribe = useCallback((listener)=>{
+        if (!key) return ()=>{};
+        let current = listeners.get(key);
+        if (!current) {
+            current = {
+                callbacks: new Set()
+            };
+            listeners.set(key, current);
+        }
+        current.callbacks.add(listener);
+        return ()=>{
+            current.callbacks = new Set([
+                ...current.callbacks
+            ].filter((item)=>item !== listener));
+            if (!current.callbacks.size) listeners.delete(key);
+        };
+    }, [
+        key
+    ]);
+    const status = useSyncExternalStore(subscribe, ()=>{
+        const current = key ? cache.get(key) : undefined;
+        // A new owner must not sync with the previous mount's snapshot before its
+        // effect registers ownership (or starts the fresh read).
+        return current && (!owner || current.mounts.has(token.current)) ? current.value : null;
+    }, ()=>null);
+    useEffect(()=>{
+        if (!key || !owner || !validBlockSlug(slug)) return;
+        let current = cache.get(key);
+        if (!current || !current.owners && !current.mounts.has(token.current)) {
+            current = {
+                value: null,
+                owners: 0,
+                mounts: new WeakSet(),
+                revision: 0
+            };
+            cache.set(key, current);
+        }
+        const owned = current;
+        owned.owners++;
+        owned.mounts.add(token.current);
+        publish(key);
+        const revision = owned.revision;
+        if (!owned.pending) owned.pending = createApi(api).placementStatus({
+            slugs: [
+                slug
+            ]
+        }).then((result)=>{
+            if (cache.get(key) !== owned || owned.revision !== revision) return;
+            owned.value = result.ok ? result.data?.slugs[slug] ?? null : null;
+            publish(key);
+        });
+        return ()=>{
+            owned.owners--;
+            queueMicrotask(()=>{
+                if (!owned.owners && cache.get(key) === owned) {
+                    cache.delete(key);
+                    publish(key);
+                }
+            });
+        };
+    }, [
+        api,
+        key,
+        slug,
+        owner
+    ]);
+    return status;
+}

package/dist/admin/blocks/useBlockForm.d.ts

@@ -0,0 +1,17 @@
+import { useConfig, useDocumentInfo, useForm } from '@payloadcms/ui';
+import { adaptClientBlocksField, rowLocation } from './formApi.js';
+import type { ClientCollectionConfig } from 'payload';
+import type { ExperimentBlock, HostBlock } from '../../blocks/model.js';
+/** Declared so the d.ts build can name Payload UI's form types through public exports. */
+export type BlockFormApi = {
+    form: ReturnType<typeof useForm>;
+    document: ReturnType<typeof useDocumentInfo>;
+    config: ReturnType<typeof useConfig>['config'];
+    collection: ClientCollectionConfig | undefined;
+    field: ReturnType<typeof adaptClientBlocksField> | undefined;
+    block: ExperimentBlock | undefined;
+    manager: boolean;
+    replace: (rows: HostBlock[]) => Promise<void>;
+    location: ReturnType<typeof rowLocation>;
+};
+export declare function useBlockForm(path: string): BlockFormApi;

package/dist/admin/blocks/useBlockForm.js

@@ -0,0 +1,46 @@
+import { useMemo } from 'react';
+import { useAuth, useConfig, useDocumentInfo, useForm, useFormFields, useServerFunctions } from '@payloadcms/ui';
+import { adaptClientBlocksField, findClientBlocksField, replaceBlockRow, rowLocation } from './formApi.js';
+export function useBlockForm(path) {
+    const form = useForm(), document = useDocumentInfo(), { config, getEntityConfig } = useConfig();
+    const { getFormState } = useServerFunctions(), { permissions } = useAuth();
+    // useForm's getters are stable; subscribe so changed slug/row paths are read again.
+    useFormFields(([fields])=>fields);
+    const location = rowLocation(path);
+    const collection = document.collectionSlug ? getEntityConfig({
+        collectionSlug: document.collectionSlug
+    }) : undefined;
+    const clientField = location && collection ? findClientBlocksField(collection.fields, location.field) : undefined;
+    const field = useMemo(()=>clientField ? adaptClientBlocksField(clientField, config) : undefined, [
+        clientField,
+        config
+    ]);
+    const block = location ? form.getDataByPath(`${location.field}.${location.index}`) : undefined;
+    const testPermissions = permissions?.collections?.['xp-experiments'];
+    const manager = testPermissions?.update === true;
+    async function replace(rows) {
+        if (!location || !document.collectionSlug) return;
+        await replaceBlockRow({
+            form,
+            getFormState,
+            collectionSlug: document.collectionSlug,
+            id: document.id,
+            ...location,
+            rows,
+            expectedBlock: block,
+            docPermissions: document.docPermissions,
+            docPreferences: await document.getDocPreferences?.()
+        });
+    }
+    return {
+        form,
+        document,
+        config,
+        collection,
+        field,
+        block,
+        manager,
+        replace,
+        location
+    };
+}

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

@@ -1,3 +1,4 @@
+import type { AddMetricWarning } from '../../types/endpoints.js';
 export declare const ACTIONS_COPY: {
     readonly start: "Start";
     readonly restart: "Start a new round";
@@ -70,3 +71,4 @@ export declare const CONTENT_ENTRY_REFUSALS: {
     };
     readonly fallback: "This page can't be changed right now. Reload to see its current state.";
 };
+export declare function addMetricWarningCopy(warning: AddMetricWarning): string;

package/dist/admin/copy/actions.js

@@ -1,3 +1,4 @@
+import { asymmetricGoalsCopy, placementUncheckedCopy } from './readiness.js';
 export const ACTIONS_COPY = {
     start: 'Start',
     restart: 'Start a new round',
@@ -70,3 +71,11 @@ export const CONTENT_ENTRY_REFUSALS = {
     },
     fallback: ACTIONS_COPY.contentEntryFallback
 };
+export function addMetricWarningCopy(warning) {
+    if (warning.code === 'goal-added-mid-test') return "Clicks before this goal was added aren't counted (the same for every version).";
+    if (warning.code === 'placement-unchecked') {
+        const path = warning.detail?.path;
+        return placementUncheckedCopy(typeof path === 'string' ? path : 'This page');
+    }
+    return asymmetricGoalsCopy(warning.detail);
+}

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

@@ -0,0 +1,43 @@
+export declare const BLOCK_COPY: {
+    testBlock: string;
+    pick: string;
+    empty: string;
+    blockChanged: string;
+    replace: string;
+    cancel: string;
+    retry: string;
+    saveFirst: string;
+    setup: string;
+    copy: string;
+    confirmCopy: string;
+    unwrap: string;
+    removeAndUnwrap: string;
+    deleteAndUnwrap: string;
+    alreadyDeleted: string;
+    noLongerDraft: string;
+    finishUnwrap: string;
+    deleted: string;
+    discarded: string;
+    running: string;
+    stopped: string;
+    slotLabels: Record<string, string>;
+    wrapRefusals: Record<string, string>;
+};
+export declare const blockPosition: (label: string, position: number) => string;
+export declare const blockTestName: (title: string, label: string) => string;
+export declare const blockDraftStatus: (name: string) => string;
+export declare const blockDecidedStatus: (winner: string, rollout: boolean) => string;
+export type BlockLinkedCopy = {
+    before: string;
+    link: string;
+    after: string;
+};
+export declare const blockRunningUnwrap: BlockLinkedCopy;
+export declare const blockDecidedUnwrap: BlockLinkedCopy;
+export declare const blockFinishedCopy: (winner: string) => BlockLinkedCopy;
+export declare const blockFinishedStatus: (winner: string) => string;
+export declare const blockDeleteConfirmation: (name: string) => string;
+export declare const blockUnwrapConfirmation: (name: string) => string;
+export declare const blockUnwrapNotice: (drafts: boolean, deleted: boolean) => string;
+export declare const blockSaveNotice: (drafts: boolean) => "Save a draft of this page to add the test." | "Save this page to add the test.";
+export declare const blockSyncNotice: (drafts: boolean) => "Versions were updated to match the test. Save draft to keep them." | "Versions were updated to match the test. Save to keep them.";

package/dist/admin/copy/blocks.js

@@ -0,0 +1,64 @@
+export const BLOCK_COPY = {
+    testBlock: 'Test a block on this page',
+    pick: 'Choose a block',
+    empty: 'There are no blocks on this page to test yet. Add one, save, then come back.',
+    blockChanged: 'This block changed while you were working. Nothing was replaced. Try again.',
+    replace: 'Replace',
+    cancel: 'Cancel',
+    retry: 'Try again',
+    saveFirst: 'Save your changes, then try again.',
+    setup: 'Set up the test',
+    copy: 'Copy the Original into this version',
+    confirmCopy: 'Replace this version’s content with a copy of the Original? Edits you made to this version will be lost.',
+    unwrap: 'Unwrap',
+    removeAndUnwrap: 'Remove the test and unwrap',
+    deleteAndUnwrap: 'Delete and unwrap',
+    alreadyDeleted: 'This test was already deleted. Reload the page.',
+    noLongerDraft: 'This test is no longer a draft. Reload the page.',
+    finishUnwrap: 'The test was removed; use Unwrap to finish.',
+    deleted: "This block's test was deleted; the page shows the Original.",
+    discarded: 'This test has ended; the page shows the Original.',
+    running: "Running: visitors see different versions. Edit a version's tab to change it; the change is noted on the results.",
+    stopped: 'Stopped: visitors see the Original.',
+    slotLabels: {
+        control: 'Original',
+        variantA: 'Variant A',
+        variantB: 'Variant B',
+        variantC: 'Variant C'
+    },
+    wrapRefusals: {
+        'wrap-target-missing': 'Reload the page and try again.',
+        'locked-placement': 'Another editor has this page open. Try again when it is unlocked.',
+        'invalid-status': 'This action is not available in the current status.',
+        'unknown-collection': "That page type isn't set up for tests.",
+        'invalid-body': 'Choose a block test.'
+    }
+};
+export const blockPosition = (label, position)=>`${label} (block ${position})`;
+export const blockTestName = (title, label)=>`${title}: ${label}`;
+export const blockDraftStatus = (name)=>`This block is being tested in the draft test ${name}. Visitors see the Original until it starts.`;
+export const blockDecidedStatus = (winner, rollout)=>`Decided: visitors see ${winner}${rollout ? '; a holdout still sees the Original' : ''}.`;
+export const blockRunningUnwrap = {
+    before: 'Stop ',
+    link: 'the test',
+    after: ' to unwrap.'
+};
+export const blockDecidedUnwrap = {
+    before: 'To put the winner into this page, use "Make it the content" on ',
+    link: 'the test',
+    after: '.'
+};
+export const blockFinishedCopy = (winner)=>({
+        before: `Finished: visitors see ${winner}. Use "Make it the content" on `,
+        link: 'the test',
+        after: ' to replace this block.'
+    });
+export const blockFinishedStatus = (winner)=>{
+    const copy = blockFinishedCopy(winner);
+    return copy.before + copy.link + copy.after;
+};
+export const blockDeleteConfirmation = (name)=>`Delete the draft test ${name} and put the Original back in its place? Deleting the test can't be undone.`;
+export const blockUnwrapConfirmation = (name)=>`Put the Original back in this block's place? The test ${name} and its results are kept; it can't be started again.`;
+export const blockUnwrapNotice = (drafts, deleted)=>`${deleted ? 'The draft test was deleted and the block unwrapped.' : 'The block was unwrapped.'} ${drafts ? 'Save draft' : 'Save'} to keep it.`;
+export const blockSaveNotice = (drafts)=>drafts ? 'Save a draft of this page to add the test.' : 'Save this page to add the test.';
+export const blockSyncNotice = (drafts)=>drafts ? 'Versions were updated to match the test. Save draft to keep them.' : 'Versions were updated to match the test. Save to keep them.';

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

@@ -22,6 +22,7 @@ export declare const LOCKED_MESSAGES: {
 };
 export declare function refusalMessage(code: string | undefined, status: number, message?: string, options?: {
     notFound?: string;
+    forbidden?: string;
     codes?: Readonly<Record<string, string>>;
     fallback?: string;
 }): string;

package/dist/admin/copy/common.js

@@ -28,6 +28,6 @@ export function refusalMessage(code, status, message, options) {
     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;
+    if (code === 'forbidden' || status === 403) return options?.forbidden ?? API_MESSAGES.forbidden;
     return options?.fallback ?? (message || API_MESSAGES.failed);
 }

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

@@ -1,4 +1,6 @@
 export declare const GOALS_COPY: {
+    readonly slugRule: "Use 1–64 lowercase letters, numbers, underscores or hyphens, starting with a letter or number.";
+    readonly duplicateSlug: "Another goal already uses this short name. Change it under Advanced.";
     readonly title: "Goals";
     readonly goal: "Goal";
     readonly newGoal: "New goal";

package/dist/admin/copy/goals.js

@@ -1,4 +1,7 @@
+import { CLICK_GOAL_COPY } from '../../goals/picker/copy.js';
 export const GOALS_COPY = {
+    slugRule: CLICK_GOAL_COPY.slugRule,
+    duplicateSlug: CLICK_GOAL_COPY.duplicateSlug,
     title: 'Goals',
     goal: 'Goal',
     newGoal: 'New goal',
@@ -38,7 +41,7 @@ export const GOALS_COPY = {
     remove: 'Delete goal',
     thresholdError: 'Enter a percentage of zero or more, or leave blank for 5%.',
     deleting: 'Deleting…',
-    saveError: "Couldn't save the goal. Try again.",
+    saveError: CLICK_GOAL_COPY.saveError,
     deleteError: "Couldn't delete the goal. Try again.",
     breadcrumb: 'Breadcrumb',
     missing: 'This goal no longer exists.',

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

@@ -2,6 +2,16 @@ 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 page: "A whole page";
+    readonly pageMeaning: "Show different versions of a whole page at the same address, and see which one works better.";
+    readonly collection: "Collection";
+    readonly original: "Original";
+    readonly originalHelp: "Choose the page visitors see today.";
+    readonly review: "Review";
+    readonly backToTest: "Back to the test";
+    readonly finishSetup: "Finish setup";
+    readonly start: "Start";
+    readonly blocksHandoff: "Pick the block to test with 'Test a block on this page'.";
     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.";

package/dist/admin/copy/newTest.js

@@ -2,6 +2,16 @@ export const NEW_TEST_COPY = {
     question: 'What do you want to test?',
     block: 'A block on a page',
     setting: 'A setting',
+    page: 'A whole page',
+    pageMeaning: 'Show different versions of a whole page at the same address, and see which one works better.',
+    collection: 'Collection',
+    original: 'Original',
+    originalHelp: 'Choose the page visitors see today.',
+    review: 'Review',
+    backToTest: 'Back to the test',
+    finishSetup: 'Finish setup',
+    start: 'Start',
+    blocksHandoff: "Pick the block to test with 'Test a block on this page'.",
     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.',

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

@@ -0,0 +1,24 @@
+export declare const PAGE_COPY: {
+    readonly more: "More";
+    readonly loading: "Loading pages…";
+    readonly empty: "There are no pages here yet.";
+    readonly error: "Couldn't load pages. Try again.";
+    readonly retry: "Try again";
+    readonly draft: "Draft";
+    readonly noPath: "This page has no address yet.";
+    readonly choose: "Choose a page";
+    readonly where: "Where it shows";
+    readonly open: "Open";
+    readonly preview: "Preview";
+    readonly contentChecksOff: "Content checks are off for this page type.";
+    readonly duplicateStep: "Choose Duplicate from the document's actions. Keep the Original's title on the copy, unless the title is what you're testing.";
+    readonly ownAddress: "Give the copy its own address and save it as a draft. Publish it when it's ready; the test can't start until it is.";
+    readonly thenChoose: "Then choose the page you made.";
+};
+export declare const usedPageCopy: (label: string) => string;
+export declare const usedAddressCopy: (label: string, path: string, collection: string) => string;
+export declare const openOriginalCopy: (collection: string) => string;
+export declare const openCollectionCopy: (collection: string) => string;
+export declare const pageStepCopy: (label: string) => string;
+export declare const pageNotFoundCopy: (path: string, collection: string) => string;
+export declare const pageFieldCopy: (label: string) => string;

package/dist/admin/copy/pages.js

@@ -0,0 +1,24 @@
+export const PAGE_COPY = {
+    more: 'More',
+    loading: 'Loading pages…',
+    empty: 'There are no pages here yet.',
+    error: "Couldn't load pages. Try again.",
+    retry: 'Try again',
+    draft: 'Draft',
+    noPath: 'This page has no address yet.',
+    choose: 'Choose a page',
+    where: 'Where it shows',
+    open: 'Open',
+    preview: 'Preview',
+    contentChecksOff: 'Content checks are off for this page type.',
+    duplicateStep: "Choose Duplicate from the document's actions. Keep the Original's title on the copy, unless the title is what you're testing.",
+    ownAddress: "Give the copy its own address and save it as a draft. Publish it when it's ready; the test can't start until it is.",
+    thenChoose: 'Then choose the page you made.'
+};
+export const usedPageCopy = (label)=>`This is ${label}.`;
+export const usedAddressCopy = (label, path, collection)=>`Same address as ${label} (${path}). Change this page's address in ${collection}, publish it, then choose it.`;
+export const openOriginalCopy = (collection)=>`Open the Original in ${collection}.`;
+export const openCollectionCopy = (collection)=>`Open ${collection}`;
+export const pageStepCopy = (label)=>`A page for ${label}`;
+export const pageNotFoundCopy = (path, collection)=>`${path} isn't in ${collection}. Choose a page.`;
+export const pageFieldCopy = (label)=>`Page for ${label}`;

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

@@ -25,6 +25,7 @@ export declare const READINESS_COPY: {
     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 placementRemoved: "The block for this test was removed from its page, so it can't start again. Its results are kept. To test the block again, start a new test from the page.";
     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.";
@@ -35,7 +36,8 @@ export declare const READINESS_COPY: {
     readonly differentPeople: "This test's group counts different people. Create the test again without the group.";
     readonly uncheckedPages: "Version pages aren't checked; make sure each one is published.";
     readonly chooseDifferentPage: "Choose a different page";
-    readonly noTargets: "Add a page address for each version.";
+    readonly choosePages: "Choose pages";
+    readonly noTargets: "Choose a page for each version.";
     readonly pageVisitors: "Whole-page tests count visitors. Create the test again counting visitors.";
     readonly blockPathRule: "Remove the page-path rule in Who takes part; page block tests run on their page.";
     readonly removeRule: "Remove rule";
@@ -46,8 +48,12 @@ export declare const READINESS_COPY: {
     readonly attributeFallback: "this attribute";
 };
 export declare const unsupportedContentCopy: (page: string) => string;
-export declare const pageInUseCopy: (path: string) => string;
-export declare const unpublishedPageCopy: (path: string) => string;
+export declare const pageInUseCopy: (path: string, version?: boolean) => string;
+export declare const unpublishedPageCopy: (path: string, context?: {
+    original: boolean;
+    found: boolean;
+    collection: string;
+}) => string;
 /** Old responses may include raw host errors; unknown strings use authored copy. */
 export declare const placementFailureCopy: (reason: unknown) => "Couldn't check where this test is used. Try again." | "You don't have permission to check where this test is used." | "A page used by this test no longer exists. Choose another page.";
 export declare const nextCopy: (sentence: string) => string;
@@ -65,3 +71,17 @@ export declare const runningCopy: (date: string | null, people: number | null, d
 export declare const pageGuardCopy: (name: string, status: "running" | "decided" | "archived", role?: "winner" | "original") => string;
 export declare const versionPageUnavailableCopy: (path: string, status?: string) => string;
 export declare const versionPageUncheckedCopy: (path: string, status?: string) => string;
+export declare const sameAddressCopy: (label: string, other: string, path: string, collection?: string) => string;
+export declare const identicalVersionCopy: (version: string) => string;
+/** Keep named actions aligned with the actual transition buttons. */
+export declare function placementGuardCopy(page: {
+    name: string;
+    status: string;
+}, block: {
+    name: string;
+    status: string;
+}, preExisting: boolean): string;
+export declare function interactingTestsCopy(page: string, state: string, name: string, version?: boolean): string;
+export declare const goalInSomeVersionsCopy: (name?: string) => string;
+export declare function asymmetricGoalsCopy(detail: unknown): string;
+export declare const placementUncheckedCopy: (page: string) => string;

package/dist/admin/copy/readiness.js

@@ -25,6 +25,7 @@ export const READINESS_COPY = {
     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.',
+    placementRemoved: "The block for this test was removed from its page, so it can't start again. Its results are kept. To test the block again, start a new test from the page.",
     noPoint: 'Choose the setting to test.',
     busy: 'Another test is already running on this setting. Stop it first.',
     noGoal: 'Choose a goal.',
@@ -35,7 +36,8 @@ export const READINESS_COPY = {
     differentPeople: "This test's group counts different people. Create the test again without the group.",
     uncheckedPages: "Version pages aren't checked; make sure each one is published.",
     chooseDifferentPage: 'Choose a different page',
-    noTargets: 'Add a page address for each version.',
+    choosePages: 'Choose pages',
+    noTargets: 'Choose a page for each version.',
     pageVisitors: 'Whole-page tests count visitors. Create the test again counting visitors.',
     blockPathRule: 'Remove the page-path rule in Who takes part; page block tests run on their page.',
     // Next steps repeat the button label verbatim (testPage.ts removeRule).
@@ -47,8 +49,8 @@ export const READINESS_COPY = {
     attributeFallback: 'this attribute'
 };
 export const unsupportedContentCopy = (page)=>`${page} has more than one language, so Make it the content isn't available for it; you'll copy the winning version by hand.`;
-export const pageInUseCopy = (path)=>`Another running or decided test already uses ${path}. Choose a different page, or finish that test first.`;
-export const unpublishedPageCopy = (path)=>`${path} isn't a published page. Publish it, or pick another page.`;
+export const pageInUseCopy = (path, version = false)=>version ? `${path} is already in another running or decided test. Make a new copy of the Original for this version, or finish that test first.` : `Another running or decided test already uses ${path}. Choose a different page, or finish that test first.`;
+export const unpublishedPageCopy = (path, context)=>!context ? `${path} isn't a published page yet. Publish it, or choose another page.` : context.original ? `${path} isn't published, so it can't be the Original. Publish it, or choose another page.` : context.found ? `${path} is still a draft. Publish it in ${context.collection}, then start the test.` : `${path} isn't published yet, or no page has that address. Publish it in ${context.collection}, or choose another page.`;
 /** Old responses may include raw host errors; unknown strings use authored copy. */ export const placementFailureCopy = (reason)=>PLACEMENT_FAILURE_COPY[typeof reason === 'string' && Object.hasOwn(PLACEMENT_FAILURE_COPY, reason) ? reason : 'placements-failed'];
 const withoutPeriod = (value)=>value.trim().replace(/[.!?]+$/, '');
 export const nextCopy = (sentence)=>`Next: ${sentence}`;
@@ -69,3 +71,22 @@ export const runningCopy = (date, people, days)=>[
 /** After archive the guard protects the winner and the Original; only the winner page is "the winner". */ export const pageGuardCopy = (name, status, role = 'winner')=>status === 'archived' ? role === 'original' ? `This page's address now shows the winner of the finished test "${name}". To free it, open the test and choose "Release pages".` : `This page is shown at other addresses because the finished test "${name}" made it the winner. To free it, open the test and choose "Release pages".` : status === 'decided' ? `This page is part of the decided test "${name}". Choose "Make it the content" or "Discard winner" on the test before you delete, rename or unpublish it.` : `This page is part of the running test "${name}". Stop the test before you delete, rename or unpublish it.`;
 export const versionPageUnavailableCopy = (path, status = 'running')=>`${path} isn't published, so visitors assigned to it see an error. Republish it, or ${status === 'decided' ? 'discard the winner' : 'stop the test'}.`;
 export const versionPageUncheckedCopy = (path, status = 'running')=>`Couldn't check whether ${path} is published. Check that it is still published, or ${status === 'decided' ? 'discard the winner' : 'stop the test'}.`;
+export const sameAddressCopy = (label, other, path, collection)=>`${label} has the same address (${path}) as ${other}. Choose a different page.${collection ? ` Give the copy its own address in ${collection}, publish it, then choose it.` : ''}`;
+export const identicalVersionCopy = (version)=>`${version} looks the same as the Original, so the test would compare nothing. Change it before you start.`;
+/** Keep named actions aligned with the actual transition buttons. */ export function placementGuardCopy(page, block, preExisting) {
+    const action = (test)=>test.status === 'running' ? `stop ${test.name}` : `choose "Make it the content" or "Discard winner" on ${test.name}`;
+    return preExisting ? `This page is in two tests that change it, ${page.name} and ${block.name}. Before you publish, ${action(page)} or ${action(block)}.` : `This page is part of the ${page.status} test ${page.name}, so a block from another test can't be added to it. Finish one of the tests first.`;
+}
+export function interactingTestsCopy(page, state, name, version = false) {
+    return `This test uses ${page}, which the ${state} test ${name} also changes. Finish one of them first${version ? `, or remove its block from ${page}` : ''}.`;
+}
+export const goalInSomeVersionsCopy = (name = 'This goal')=>`${name} appears in some versions but not all, so the comparison wouldn't be fair. Add it to every version, or choose another goal.`;
+export function asymmetricGoalsCopy(detail) {
+    return (Array.isArray(detail) && detail.length ? detail : [
+        detail
+    ]).map((item)=>{
+        const name = item && typeof item === 'object' && 'name' in item ? item.name : undefined;
+        return goalInSomeVersionsCopy(typeof name === 'string' && name.trim() ? name.trim() : undefined);
+    }).join('\n');
+}
+export const placementUncheckedCopy = (page)=>`${page} couldn't be checked, so the test can't confirm every version shows the same goals. Check that you can open it.`;

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

@@ -22,6 +22,7 @@ export declare const RESULTS_COPY: {
     };
     readonly qualityOK: "No data quality problems found.";
     readonly previews: "Preview links";
+    readonly clickPrimary: "A click shows interest, not the result you want. Add that result, like a sign-up or a gift, as another goal to check that more clicks lead to more of it.";
     readonly releasePages: "Release pages";
     readonly releasePagesBody: "Every address shows its own page again. The result stays recorded.";
     readonly you: "you";

package/dist/admin/copy/results.js

@@ -22,6 +22,7 @@ export const RESULTS_COPY = {
     },
     qualityOK: 'No data quality problems found.',
     previews: 'Preview links',
+    clickPrimary: 'A click shows interest, not the result you want. Add that result, like a sign-up or a gift, as another goal to check that more clicks lead to more of it.',
     releasePages: 'Release pages',
     releasePagesBody: 'Every address shows its own page again. The result stays recorded.',
     you: 'you',

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

@@ -1,4 +1,7 @@
 export declare const TEST_PAGE: {
+    readonly clickPageGroup: "On this test's page";
+    readonly clickGoalsNote: "Goals inside linked documents aren't shown. Goals added in code (data-xp-goal) work but aren't listed here.";
+    readonly clickGoalHelp: "A click shows interest, not the result you want.";
     readonly staleEdit: "Someone else changed this test. Reload to see their changes.";
     readonly reload: "Reload";
     readonly loading: "Loading test…";
@@ -54,6 +57,7 @@ export declare const TEST_PAGE: {
     readonly split: "Split evenly";
     readonly remove: "Remove version";
     readonly invalidShare: "Use a whole number from 0 to 100.";
+    readonly holdoutPrefix: "Holdout: ";
     readonly allocation: "How many people take part";
     readonly traffic: "How people are split";
     readonly goal: "Goal";

package/dist/admin/copy/testPage.js

@@ -1,4 +1,7 @@
 export const TEST_PAGE = {
+    clickPageGroup: "On this test's page",
+    clickGoalsNote: "Goals inside linked documents aren't shown. Goals added in code (data-xp-goal) work but aren't listed here.",
+    clickGoalHelp: 'A click shows interest, not the result you want.',
     staleEdit: 'Someone else changed this test. Reload to see their changes.',
     reload: 'Reload',
     loading: 'Loading test…',
@@ -54,6 +57,7 @@ export const TEST_PAGE = {
     split: 'Split evenly',
     remove: 'Remove version',
     invalidShare: 'Use a whole number from 0 to 100.',
+    holdoutPrefix: 'Holdout: ',
     allocation: 'How many people take part',
     traffic: 'How people are split',
     goal: 'Goal',