@delmaredigital/payload-experiments 0.3.0-rc.1 → 0.4.0-rc.1

package/dist/admin/copy/pages.js

@@ -0,0 +1,26 @@
+export const PAGE_COPY = {
+    search: 'Search pages by title',
+    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',
+    change: 'Change',
+    close: 'Close',
+    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.',
+    noPage: 'No page chosen yet.'
+};
+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}`;

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

@@ -34,7 +34,9 @@ export declare const READINESS_COPY: {
     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 uncheckedPages: "Version pages aren't checked; make sure each one is published.";
-    readonly noTargets: "Add a page address for each version.";
+    readonly chooseDifferentPage: "Choose a different page";
+    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";
@@ -45,7 +47,12 @@ export declare const READINESS_COPY: {
     readonly attributeFallback: "this attribute";
 };
 export declare const unsupportedContentCopy: (page: 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;
@@ -59,6 +66,21 @@ 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;
-export declare const pageGuardCopy: (name: string, status: "running" | "decided" | "archived") => string;
+/** After archive the guard protects the winner and the Original; only the winner page is "the winner". */
+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

@@ -34,7 +34,9 @@ export const READINESS_COPY = {
     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.",
     uncheckedPages: "Version pages aren't checked; make sure each one is published.",
-    noTargets: 'Add a page address for each version.',
+    chooseDifferentPage: 'Choose a different page',
+    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).
@@ -46,7 +48,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 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}`;
@@ -64,6 +67,25 @@ export const runningCopy = (date, people, days)=>[
         people === null ? null : `${people.toLocaleString('en-US')} people so far`,
         days === null ? null : `about ${days} days to go`
     ].filter(Boolean).join(' · ');
-export const pageGuardCopy = (name, status)=>status === 'archived' ? `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.`;
+/** 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";
@@ -57,6 +58,8 @@ export declare const RESULTS_COPY: {
     readonly infeasible: "A clear answer would take more than 90 days at this traffic.";
     readonly noCap: "Not capped: fewer than 20 people had this outcome in the 90 days before Start, so every value counts in full.";
     readonly quality: "Data quality";
+    readonly missingWinner: "The stored winner is missing from this round’s results.";
+    readonly missingWinnerNext: "Recompute; if it persists, contact a developer before trusting these results.";
     readonly srm: "Traffic isn't splitting as set. Check for caching or a page placed twice.";
     readonly multiGroup: "People who saw more than one group were excluded.";
     readonly multiGroupNext: "Check for caching or a page placed twice before trusting the results.";

package/dist/admin/copy/results.js

@@ -9,7 +9,7 @@ export const RESULTS_COPY = {
         sequential: 'Sequential',
         bayesian: 'Bayesian'
     },
-    asOfDecision: (date)=>`as of the decision, ${date}`,
+    asOfDecision: (date)=>`numbers from ${date}, used for the decision`,
     kinds: {
         binomial: 'yes/no',
         count: 'amount',
@@ -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',
@@ -57,6 +58,8 @@ export const RESULTS_COPY = {
     infeasible: 'A clear answer would take more than 90 days at this traffic.',
     noCap: 'Not capped: fewer than 20 people had this outcome in the 90 days before Start, so every value counts in full.',
     quality: 'Data quality',
+    missingWinner: 'The stored winner is missing from this round’s results.',
+    missingWinnerNext: 'Recompute; if it persists, contact a developer before trusting these results.',
     srm: "Traffic isn't splitting as set. Check for caching or a page placed twice.",
     multiGroup: 'People who saw more than one group were excluded.',
     multiGroupNext: 'Check for caching or a page placed twice before trusting the results.',

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

@@ -1,8 +1,8 @@
 export declare const REVIEW_COPY: {
     readonly noBaseline: "No data yet for this metric.";
     readonly preview: "Preview";
+    readonly previewBlocked: "Your browser blocked the preview window. Allow pop-ups for this site, then try again.";
     readonly placedTimes: (n: number) => string;
-    readonly noPreview: "Preview isn't set up for this page type";
     readonly raise: "Raise allocation";
     readonly addMetric: "Add a metric";
     readonly allocationBody: "Raising allocation adds people; nobody already taking part changes group. Lowering needs a new round.";

package/dist/admin/copy/review.js

@@ -1,8 +1,8 @@
 export const REVIEW_COPY = {
     noBaseline: 'No data yet for this metric.',
     preview: 'Preview',
+    previewBlocked: 'Your browser blocked the preview window. Allow pop-ups for this site, then try again.',
     placedTimes: (n)=>`(placed ${n} times on this page)`,
-    noPreview: "Preview isn't set up for this page type",
     raise: 'Raise allocation',
     addMetric: 'Add a metric',
     allocationBody: 'Raising allocation adds people; nobody already taking part changes group. Lowering needs a new round.',

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

@@ -10,7 +10,6 @@ export declare const SURFACE_COPY: {
     readonly dashShowTests: "Show all tests";
     readonly dashShowGoals: "Show all goals";
     readonly backToAdmin: "Back to admin";
-    readonly limitedList: "Showing the 200 most recent tests.";
     readonly notInstalled: "The Tests screen isn't installed yet. Run `payload generate:importmap` and reload.";
     readonly noAccess: "You don't have access to tests.";
     readonly loading: "Loading tests…";

package/dist/admin/copy/surface.js

@@ -10,7 +10,6 @@ export const SURFACE_COPY = {
     dashShowTests: 'Show all tests',
     dashShowGoals: 'Show all goals',
     backToAdmin: 'Back to admin',
-    limitedList: 'Showing the 200 most recent tests.',
     notInstalled: "The Tests screen isn't installed yet. Run `payload generate:importmap` and reload.",
     noAccess: "You don't have access to tests.",
     loading: 'Loading tests…',

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',

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

@@ -0,0 +1,2 @@
+import type { TextFieldClientProps } from 'payload';
+export declare function XpGoalField({ path, field, readOnly }: TextFieldClientProps): import("react").JSX.Element;

package/dist/admin/goals/XpGoalField.js

@@ -0,0 +1,152 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Button, FieldError, FieldLabel, TextInput, useAuth, useConfig, useField } from '@payloadcms/ui';
+import { useId } from 'react';
+import { useClickGoalPicker } from '../../goals/picker/useClickGoalPicker.js';
+import { CLICK_GOAL_COPY as C } from '../../goals/picker/copy.js';
+export function XpGoalField({ path, field, readOnly }) {
+    const { value, setValue, showError } = useField({
+        path
+    });
+    const { permissions } = useAuth();
+    const { config } = useConfig();
+    const access = permissions?.collections?.['xp-experiments'];
+    const locked = Boolean(readOnly || field.admin?.readOnly);
+    const picker = useClickGoalPicker(config.routes.api, {
+        enabled: access?.update === true,
+        onSelect: setValue
+    });
+    const id = useId(), namePath = `${id}-name`, slugPath = `${id}-slug`;
+    const stopEnter = (event)=>{
+        if (event.key === 'Enter') {
+            event.preventDefault();
+            event.stopPropagation();
+        }
+    };
+    return /*#__PURE__*/ _jsxs("div", {
+        children: [
+            /*#__PURE__*/ _jsx(TextInput, {
+                path: path,
+                label: field.label ?? C.label,
+                description: field.admin?.description,
+                required: field.required,
+                readOnly: locked,
+                value: value ?? '',
+                showError: showError,
+                Error: /*#__PURE__*/ _jsx(FieldError, {
+                    path: path,
+                    showError: showError
+                }),
+                onChange: (event)=>{
+                    if (!locked) setValue(event.currentTarget.value);
+                }
+            }),
+            picker.canManage && !locked ? /*#__PURE__*/ _jsxs(_Fragment, {
+                children: [
+                    /*#__PURE__*/ _jsx("label", {
+                        htmlFor: `${id}-picker`,
+                        children: C.choose
+                    }),
+                    /*#__PURE__*/ _jsxs("select", {
+                        id: `${id}-picker`,
+                        value: picker.goals.some((goal)=>goal.slug === value) ? value : '',
+                        onChange: (event)=>{
+                            if (event.currentTarget.value) setValue(event.currentTarget.value);
+                        },
+                        children: [
+                            /*#__PURE__*/ _jsx("option", {
+                                value: "",
+                                children: C.choose
+                            }),
+                            picker.goals.map((goal)=>/*#__PURE__*/ _jsx("option", {
+                                    value: goal.slug,
+                                    children: goal.name
+                                }, goal.id))
+                        ]
+                    }),
+                    picker.undefinedKey(value ?? '') ? /*#__PURE__*/ _jsx("p", {
+                        role: "status",
+                        children: C.undefinedKey
+                    }) : null,
+                    !picker.panel.open ? /*#__PURE__*/ _jsx(Button, {
+                        type: "button",
+                        onClick: picker.open,
+                        children: C.newGoal
+                    }) : /*#__PURE__*/ _jsxs("section", {
+                        "aria-labelledby": `${id}-title`,
+                        children: [
+                            /*#__PURE__*/ _jsx("h3", {
+                                id: `${id}-title`,
+                                children: C.title
+                            }),
+                            /*#__PURE__*/ _jsxs("div", {
+                                className: "field-type text",
+                                children: [
+                                    /*#__PURE__*/ _jsx(FieldLabel, {
+                                        path: namePath,
+                                        label: C.name
+                                    }),
+                                    /*#__PURE__*/ _jsx("input", {
+                                        id: `field-${namePath}`,
+                                        value: picker.panel.name,
+                                        disabled: picker.panel.pending,
+                                        onKeyDown: stopEnter,
+                                        onChange: (event)=>picker.setName(event.currentTarget.value)
+                                    })
+                                ]
+                            }),
+                            /*#__PURE__*/ _jsxs("details", {
+                                open: picker.panel.advanced,
+                                onToggle: (event)=>picker.setAdvanced(event.currentTarget.open),
+                                children: [
+                                    /*#__PURE__*/ _jsx("summary", {
+                                        children: C.advanced
+                                    }),
+                                    /*#__PURE__*/ _jsxs("div", {
+                                        className: "field-type text",
+                                        children: [
+                                            /*#__PURE__*/ _jsx(FieldLabel, {
+                                                path: slugPath,
+                                                label: C.slug
+                                            }),
+                                            /*#__PURE__*/ _jsx("input", {
+                                                id: `field-${slugPath}`,
+                                                value: picker.panel.slug,
+                                                disabled: picker.panel.pending,
+                                                onKeyDown: stopEnter,
+                                                "aria-invalid": Boolean(picker.panel.errors.slug) || undefined,
+                                                "aria-describedby": picker.panel.errors.slug ? `${id}-slug-error` : undefined,
+                                                onChange: (event)=>picker.setSlug(event.currentTarget.value)
+                                            }),
+                                            picker.panel.errors.slug ? /*#__PURE__*/ _jsx("p", {
+                                                id: `${id}-slug-error`,
+                                                role: "alert",
+                                                children: picker.panel.errors.slug
+                                            }) : null
+                                        ]
+                                    })
+                                ]
+                            }),
+                            picker.panel.errors.general ? /*#__PURE__*/ _jsx("p", {
+                                role: "alert",
+                                children: picker.panel.errors.general
+                            }) : null,
+                            /*#__PURE__*/ _jsx(Button, {
+                                type: "button",
+                                disabled: picker.panel.pending || !picker.panel.name.trim(),
+                                onClick: ()=>void picker.create(),
+                                children: C.createGoal
+                            }),
+                            /*#__PURE__*/ _jsx(Button, {
+                                type: "button",
+                                disabled: picker.panel.pending,
+                                onClick: picker.cancel,
+                                children: C.cancel
+                            })
+                        ]
+                    })
+                ]
+            }) : null
+        ]
+    });
+}

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

@@ -5,3 +5,5 @@ export declare function metricSourceOptions(sources: readonly SerializedMetricSo
     badge: "count" | "yes/no" | "amount";
 }[];
 export declare function metricSourceHint(source?: SerializedMetricSource): string | null;
+/** Click goal definitions share the serialized click-source option. */
+export declare function sourceFor(sourceId: string | undefined, metricSources: readonly SerializedMetricSource[]): SerializedMetricSource | undefined;

package/dist/admin/metricSource.model.js

@@ -9,3 +9,7 @@ export function metricSourceOptions(sources) {
 export function metricSourceHint(source) {
     return source?.kind === 'revenue' ? METRICS_COPY.revenueHint : null;
 }
+/** Click goal definitions share the serialized click-source option. */ export function sourceFor(sourceId, metricSources) {
+    const id = sourceId?.startsWith('click:') ? 'click:' : sourceId;
+    return metricSources.find((source)=>source.id === id);
+}

package/dist/admin/pageCollections.d.ts

@@ -0,0 +1,10 @@
+import type { PayloadRequest } from 'payload';
+import type { ExperimentsPageCollection } from '../types/contracts.js';
+export declare function serializePageCollections(collections: ExperimentsPageCollection[], req: PayloadRequest): {
+    copyUrl: string;
+    copyLabel: string;
+    copyHint?: string | undefined;
+    slug: string;
+    label: string;
+    contentChecks: boolean;
+}[];

package/dist/admin/pageCollections.js

@@ -0,0 +1,20 @@
+import { formatAdminURL } from 'payload/shared';
+import { collectionLabel } from '../collections/labels.js';
+export function serializePageCollections(collections, req) {
+    return collections.map((entry)=>{
+        const label = collectionLabel(req.payload.config.collections.find((collection)=>collection.slug === entry.slug)?.labels.plural, entry.slug, req);
+        return {
+            slug: entry.slug,
+            label,
+            contentChecks: typeof entry.contentOf === 'function',
+            ...entry.copyHint ? {
+                copyHint: entry.copyHint
+            } : {},
+            copyUrl: entry.copyUrl ?? formatAdminURL({
+                adminRoute: req.payload.config.routes.admin,
+                path: `/collections/${entry.slug}`
+            }),
+            copyLabel: entry.copyLabel ?? `Open ${label}`
+        };
+    });
+}

package/dist/admin/paths.d.ts

@@ -4,6 +4,13 @@ export declare const XP_ARM_SELECT = "@delmaredigital/payload-experiments/admin/
 export declare const XP_TESTS_VIEW = "@delmaredigital/payload-experiments/admin/rsc#ExperimentsRootView";
 export declare const XP_TESTS_LIST_REDIRECT = "@delmaredigital/payload-experiments/admin/rsc#CollectionListRedirect";
 export declare const XP_TEST_EDIT_REDIRECT = "@delmaredigital/payload-experiments/admin/rsc#CollectionEditRedirect";
-export declare const XP_TESTS_NAV_LINK = "@delmaredigital/payload-experiments/admin/client#TestsNavLink";
+export declare const XP_TESTS_NAV_LINK = "@delmaredigital/payload-experiments/admin/rsc#TestsNavLinkServer";
+export declare const XP_TESTS_NAV_CLIENT = "@delmaredigital/payload-experiments/admin/client#TestsNavLink";
 export declare const XP_TESTS_SURFACE = "@delmaredigital/payload-experiments/admin/client#TestsSurface";
 export declare const XP_TESTS_DASHBOARD_CARDS = "@delmaredigital/payload-experiments/admin/client#TestsDashboardCards";
+export declare const XP_PLACEMENT_STATUS = "@delmaredigital/payload-experiments/admin/client#PlacementStatus";
+export declare const XP_TEST_BLOCK = "@delmaredigital/payload-experiments/admin/client#TestBlockField";
+export declare const XP_BLOCK_STATUS = "@delmaredigital/payload-experiments/admin/client#BlockStatusField";
+export declare const XP_BLOCK_ROW_LABEL = "@delmaredigital/payload-experiments/admin/client#BlockSlotRowLabel";
+export declare const XP_COPY_ORIGINAL = "@delmaredigital/payload-experiments/admin/client#CopyOriginalField";
+export declare const XP_GOAL_FIELD = "@delmaredigital/payload-experiments/admin/client#XpGoalField";

package/dist/admin/paths.js

@@ -4,6 +4,13 @@ export const XP_ARM_SELECT = '@delmaredigital/payload-experiments/admin/client#A
 export const XP_TESTS_VIEW = '@delmaredigital/payload-experiments/admin/rsc#ExperimentsRootView';
 export const XP_TESTS_LIST_REDIRECT = '@delmaredigital/payload-experiments/admin/rsc#CollectionListRedirect';
 export const XP_TEST_EDIT_REDIRECT = '@delmaredigital/payload-experiments/admin/rsc#CollectionEditRedirect';
-export const XP_TESTS_NAV_LINK = '@delmaredigital/payload-experiments/admin/client#TestsNavLink';
+export const XP_TESTS_NAV_LINK = '@delmaredigital/payload-experiments/admin/rsc#TestsNavLinkServer';
+export const XP_TESTS_NAV_CLIENT = '@delmaredigital/payload-experiments/admin/client#TestsNavLink';
 export const XP_TESTS_SURFACE = '@delmaredigital/payload-experiments/admin/client#TestsSurface';
 export const XP_TESTS_DASHBOARD_CARDS = '@delmaredigital/payload-experiments/admin/client#TestsDashboardCards';
+export const XP_PLACEMENT_STATUS = '@delmaredigital/payload-experiments/admin/client#PlacementStatus';
+export const XP_TEST_BLOCK = '@delmaredigital/payload-experiments/admin/client#TestBlockField';
+export const XP_BLOCK_STATUS = '@delmaredigital/payload-experiments/admin/client#BlockStatusField';
+export const XP_BLOCK_ROW_LABEL = '@delmaredigital/payload-experiments/admin/client#BlockSlotRowLabel';
+export const XP_COPY_ORIGINAL = '@delmaredigital/payload-experiments/admin/client#CopyOriginalField';
+export const XP_GOAL_FIELD = '@delmaredigital/payload-experiments/admin/client#XpGoalField';

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

@@ -0,0 +1,2 @@
+import type { PageTestStatus } from '../types/endpoints.js';
+export declare function pageStatusCopy(test: PageTestStatus): string | null;

package/dist/admin/placementStatus.model.js

@@ -0,0 +1,19 @@
+export function pageStatusCopy(test) {
+    if (test.pagesReleased) return null;
+    const winner = `${test.winnerLabel ?? 'the winner'}${test.winnerTitle ? ` (${test.winnerTitle})` : ''}`;
+    switch(test.status){
+        case 'draft':
+            return `This page is ${test.armLabel} in the draft test ${test.name}.`;
+        case 'stopped':
+            {
+                const visitors = test.role === 'original' ? 'Visitors see this page.' : !test.originalPath ? 'Visitors see the Original.' : `Visitors to ${test.originalPath === '/' ? 'the homepage (/)' : test.originalPath} see the Original.`;
+                return `This page is ${test.armLabel} in the stopped test ${test.name}. ${visitors}`;
+            }
+        case 'running':
+            return `This page is the ${test.armLabel} of a running test: ${test.name}.`;
+        case 'decided':
+            return `This page is ${test.armLabel} of a decided test; ${test.rollout ? `most visitors see ${winner}; a holdout still sees the Original` : `visitors see ${winner}`}.`;
+        case 'archived':
+            return test.winner ? `This page is also shown at the other versions' addresses because test ${test.name} made it the winner. To free it, open the test and choose "Release pages".` : test.role === 'original' ? `This page's address now shows the winner of test ${test.name}. To free it, open the test and choose "Release pages".` : `This page's address now shows ${winner}. To show this page again, open the test and choose "Release pages".`;
+    }
+}

package/dist/admin/placements/placementLabels.d.ts

@@ -0,0 +1,11 @@
+import type { DocId } from '../../types/contracts.js';
+import type { PreflightResult } from '../../types/endpoints.js';
+export { placementDetailKey, placementDetail, fallbackPlacementLabel } from './placementLabels.model.js';
+export type { PlacementLabel } from './placementLabels.model.js';
+import type { PlacementLabel } from './placementLabels.model.js';
+export declare function resolvedPlacementLabel(value: unknown, match: {
+    id?: DocId | null;
+    title?: string;
+    editorUrl?: string;
+} | undefined, adminRoute: string): PlacementLabel;
+export declare function preflightPlacementLabel(value: unknown, preflight: PreflightResult, adminRoute: string): PlacementLabel;

package/dist/admin/placements/placementLabels.js

@@ -0,0 +1,21 @@
+import { formatAdminURL } from 'payload/shared';
+import { placementDetail } from './placementLabels.model.js';
+export { placementDetailKey, placementDetail, fallbackPlacementLabel } from './placementLabels.model.js';
+export function resolvedPlacementLabel(value, match, adminRoute) {
+    const detail = placementDetail(value);
+    const id = match?.id ?? detail.id;
+    return {
+        title: match?.title?.trim() || detail.path || 'This page',
+        ...id != null && detail.collection ? {
+            href: match?.editorUrl || formatAdminURL({
+                adminRoute,
+                path: `/collections/${encodeURIComponent(detail.collection)}/${encodeURIComponent(String(id))}`
+            })
+        } : {}
+    };
+}
+export function preflightPlacementLabel(value, preflight, adminRoute) {
+    const detail = placementDetail(value);
+    const match = detail.collection ? detail.id != null ? preflight.placements.find((item)=>item.collection === detail.collection && String(item.id) === String(detail.id)) : typeof detail.path === 'string' ? preflight.pagePlacements?.find((item)=>item.collection === detail.collection && item.path === detail.path) : undefined : undefined;
+    return resolvedPlacementLabel(value, match, adminRoute);
+}

package/dist/admin/placements/placementLabels.model.d.ts

@@ -0,0 +1,13 @@
+import type { DocId } from '../../types/contracts.js';
+export type PlacementDetail = {
+    collection?: string;
+    id?: DocId;
+    path?: string;
+};
+export type PlacementLabel = {
+    title: string;
+    href?: string;
+};
+export declare const placementDetail: (detail: unknown) => PlacementDetail;
+export declare function placementDetailKey(value: unknown): string;
+export declare const fallbackPlacementLabel: (value: unknown) => PlacementLabel;

package/dist/admin/placements/placementLabels.model.js

@@ -0,0 +1,12 @@
+export const placementDetail = (detail)=>detail && typeof detail === 'object' && !Array.isArray(detail) ? detail : {};
+export function placementDetailKey(value) {
+    const detail = placementDetail(value);
+    return JSON.stringify([
+        detail.collection,
+        detail.id == null ? null : String(detail.id),
+        detail.path
+    ]);
+}
+export const fallbackPlacementLabel = (value)=>({
+        title: placementDetail(value).path || 'This page'
+    });

package/dist/admin/placements/usePlacementLabels.d.ts

@@ -0,0 +1,12 @@
+import type { PreflightResult } from '../../types/endpoints.js';
+import type { PlacementLabel } from './placementLabels.js';
+export { placementDetailKey } from './placementLabels.js';
+/** The view owns a cache, including misses, so repeated warnings never repeat reads. */
+export declare function usePlacementLabels({ details, preflight, apiRoute, adminRoute, canManage, collectionTitles }: {
+    details: unknown[];
+    preflight?: PreflightResult | null;
+    apiRoute: string;
+    adminRoute: string;
+    canManage: boolean;
+    collectionTitles?: Record<string, string>;
+}): Map<string, PlacementLabel>;