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

package/dist/collections/metrics.js

@@ -7,7 +7,13 @@ export function metricsCollection(options) {
         slug: 'xp-metrics',
         graphQL: false,
         disableDuplicate: true,
+        // group:false hides navigation while keeping collection routes reachable (hidden causes 404s).
+        labels: {
+            singular: 'Goal',
+            plural: 'Goals'
+        },
         admin: {
+            group: false,
             useAsTitle: 'name'
         },
         access: managedAccess(options),
@@ -30,21 +36,31 @@ export function metricsCollection(options) {
         fields: [
             {
                 name: 'name',
+                label: 'Name',
                 type: 'text',
-                required: true
+                required: true,
+                admin: {
+                    description: 'Give this goal a name people will recognize.'
+                }
             },
             {
                 name: 'slug',
+                label: 'Short name (used in code)',
                 type: 'text',
                 required: true,
-                unique: true
+                unique: true,
+                admin: {
+                    description: 'Use a unique short name for code that refers to this goal.'
+                }
             },
             {
                 name: 'source',
+                label: 'Measured by',
                 type: 'text',
                 required: true,
-                validate: (value)=>sources.some((source)=>source.id === value) || 'Choose a registered metric source.',
+                validate: (value)=>sources.some((source)=>source.id === value) || 'Choose what this goal is measured by.',
                 admin: {
+                    description: 'Choose the outcome this goal measures.',
                     components: {
                         Field: XP_METRIC_SOURCE_SELECT
                     },
@@ -55,60 +71,100 @@ export function metricsCollection(options) {
             },
             {
                 name: 'direction',
+                label: 'Better when it goes',
                 type: 'select',
                 required: true,
                 defaultValue: 'increase',
                 options: [
-                    'increase',
-                    'decrease'
-                ]
+                    {
+                        label: 'Goes up',
+                        value: 'increase'
+                    },
+                    {
+                        label: 'Goes down',
+                        value: 'decrease'
+                    }
+                ],
+                admin: {
+                    description: 'Choose whether a higher or lower result is better.'
+                }
             },
             {
                 name: 'attributionWindowHours',
+                label: 'Count results for (hours)',
                 type: 'number',
                 defaultValue: 168,
-                min: 1
+                min: 1,
+                admin: {
+                    description: 'Count outcomes during this many hours after someone sees a version.'
+                }
             },
             {
                 name: 'capping',
+                label: 'Limit very large values',
                 type: 'group',
+                admin: {
+                    description: 'Limit unusually large amounts when comparing results while keeping totals in full.'
+                },
                 fields: [
                     {
                         name: 'type',
+                        label: 'Limit by',
                         type: 'select',
                         options: [
-                            'percentile',
-                            'absolute'
+                            {
+                                label: 'Based on past amounts',
+                                value: 'percentile'
+                            },
+                            {
+                                label: 'Fixed amount',
+                                value: 'absolute'
+                            }
                         ],
+                        admin: {
+                            description: 'Choose whether the limit comes from past amounts or a fixed amount.'
+                        },
                         validate: (value, { data, siblingData })=>{
                             const hasCapping = value != null || siblingData?.value != null;
                             const source = sources.find((source)=>source.id === data?.source);
-                            if (hasCapping && source && source.kind !== 'revenue') return 'Count and conversion metrics cannot be capped.';
-                            return !hasCapping || value === 'percentile' || value === 'absolute' || 'Choose a capping type.';
+                            if (hasCapping && source && source.kind !== 'revenue') return 'Count and yes-or-no goals cannot use a limit.';
+                            return !hasCapping || value === 'percentile' || value === 'absolute' || 'Choose how to set the limit.';
                         }
                     },
                     {
                         name: 'value',
+                        label: 'Limit value',
                         type: 'number',
                         min: 0,
+                        admin: {
+                            description: 'For past amounts, enter how much of the usual range to keep, such as 0.99 to limit only the largest 1%; or enter a fixed amount.'
+                        },
                         validate: (value, { siblingData })=>{
                             if (value == null && !siblingData?.type) return true;
-                            return typeof value === 'number' && Number.isFinite(value) && value >= 0 && (siblingData?.type === 'absolute' || siblingData?.type === 'percentile' && value > 0 && value <= 1) || 'Enter a valid cap (percentiles must be greater than 0 and at most 1).';
+                            return typeof value === 'number' && Number.isFinite(value) && value >= 0 && (siblingData?.type === 'absolute' || siblingData?.type === 'percentile' && value > 0 && value <= 1) || 'Enter a valid limit (for past amounts, use a number greater than 0 and at most 1).';
                         }
                     }
                 ]
             },
             {
                 name: 'minSampleSize',
+                label: 'Minimum completions before deciding',
                 type: 'number',
                 defaultValue: 150,
-                min: 1
+                min: 1,
+                admin: {
+                    description: 'Wait until each version has at least this many people who completed the goal before showing a result.'
+                }
             },
             {
                 name: 'guardrailThreshold',
+                label: 'Warn when it gets worse by',
                 type: 'number',
                 defaultValue: 0.05,
-                min: 0
+                min: 0,
+                admin: {
+                    description: 'When this goal is a safety check, warn if it gets worse by this fraction, such as 0.05 for 5%.'
+                }
             }
         ]
     };

package/dist/collections/serialize.js

@@ -1,7 +1,10 @@
 export function serializeFlagPoints(options) {
-    return (options.flagPoints ?? []).map(({ id, label, params, defaultParams })=>({
+    return (options.flagPoints ?? []).map(({ id, label, description, params, defaultParams })=>({
             id,
             label,
+            ...description === undefined ? {} : {
+                description
+            },
             params,
             defaultParams,
             effectiveDefaults: defaultParams

package/dist/db/snapshots.d.ts

@@ -40,8 +40,9 @@ export declare function writeSnapshots(exec: Executor, snapshots: Snapshot[]): P
  * with req/overrideAccess:false. Called behind the readResults/manage gate. */
 export declare function newestSnapshotIds(exec: Executor, ids: DocId[], per: 'phase' | 'experiment'): Promise<DocId[]>;
 /** Called only behind the endpoint's readResults gate. Experiment collection
- * reads require manage, so read only the decision pointer needed by results. */
+ * reads require manage, so read only the decision metadata needed by results. */
 export declare function resultsMetadata(exec: Executor, id: DocId): Promise<{
     status: string;
     snapshotId: DocId | null;
+    winnerArm: string | null;
 } | null>;

package/dist/db/snapshots.js

@@ -80,9 +80,9 @@ export async function writeSnapshot(exec, snapshot) {
     return rows.map((row)=>row.id);
 }
 /** Called only behind the endpoint's readResults gate. Experiment collection
- * reads require manage, so read only the decision pointer needed by results. */ export async function resultsMetadata(exec, id) {
+ * reads require manage, so read only the decision metadata needed by results. */ export async function resultsMetadata(exec, id) {
     const c = COLUMNS.experiments;
-    const { rows } = await exec.query(`SELECT ${q(c.status)} AS "status", ${q(c.decisionSnapshotId)} AS "snapshotId" FROM ${qualifiedTable(exec, TABLES.experiments)} WHERE ${q(c.id)} = $1`, [
+    const { rows } = await exec.query(`SELECT ${q(c.status)} AS "status", ${q(c.decisionSnapshotId)} AS "snapshotId", ${q(c.decisionWinnerArm)} AS "winnerArm" FROM ${qualifiedTable(exec, TABLES.experiments)} WHERE ${q(c.id)} = $1`, [
         id
     ]);
     return rows[0] ?? null;

package/dist/endpoints/results.js

@@ -116,6 +116,13 @@ export async function handleResults(req, _ctx) {
             decisionSnapshot: decision
         } : {}
     };
+    const decisionPhase = decision?.phase ?? records.filter((record)=>record.phaseKind === 'test').at(-1)?.phase;
+    if (typeof metadata.winnerArm === 'string' && metadata.winnerArm.length > 0 && decisionPhase !== undefined) {
+        response.decision = {
+            phase: decisionPhase,
+            winnerArm: metadata.winnerArm
+        };
+    }
     if (params.get('series') === '1') {
         const series = phase === undefined ? [] : await readSnapshots(req, [
             id

package/dist/endpoints/summary.d.ts

@@ -4,4 +4,4 @@ export declare function handleSummary<TUser extends {
     id: string | number;
 } = {
     id: string | number;
-}>(req: PayloadRequest, _ctx: EndpointContext<TUser>): Promise<Response>;
+}>(req: PayloadRequest, { options }: EndpointContext<TUser>): Promise<Response>;

package/dist/endpoints/summary.js

@@ -1,5 +1,7 @@
+import { checkStart } from '../transitions/checkStart.js';
+import { loadStartInputsBatch } from '../transitions/preflightData.js';
 import { readSnapshots, resultsError } from './results.js';
-export async function handleSummary(req, _ctx) {
+export async function handleSummary(req, { options }) {
     let ids;
     try {
         // Split before decoding: an opaque id can itself contain a comma.
@@ -32,6 +34,40 @@ export async function handleSummary(req, _ctx) {
             verdict: null
         };
     }
+    try {
+        if (await options.access.manage({
+            req
+        }) === true) {
+            const found = await req.payload.find({
+                collection: 'xp-experiments',
+                req,
+                overrideAccess: false,
+                depth: 0,
+                pagination: false,
+                limit: ids.length,
+                where: {
+                    id: {
+                        in: [
+                            ...new Set(ids)
+                        ]
+                    }
+                }
+            });
+            const drafts = found.docs.filter((e)=>e.status === 'draft' || e.status === 'stopped');
+            const inputs = await loadStartInputsBatch(req, options, drafts, true);
+            for (const id of ids){
+                // Payload normalises numeric ids (for example 01 to 1); preserve the requested response key.
+                const experiment = drafts.find((e)=>String(e.id) === id || typeof e.id === 'number' && Number(id) === e.id);
+                if (!experiment) continue;
+                const input = inputs.get(String(experiment.id));
+                try {
+                    response[id].ready = !!input && checkStart(input).every((check)=>check.ok);
+                } catch  {
+                    response[id].ready = false;
+                }
+            }
+        }
+    } catch  {}
     return Response.json(response, {
         headers: {
             'Cache-Control': 'no-store'

package/dist/exports/adminClient.d.ts

@@ -1,16 +1,5 @@
-export { AllocationField } from '../admin/AllocationField.js';
-export { FlagPointSelect } from '../admin/FlagPointSelect.js';
 export { LayerUsage } from '../admin/LayerUsage.js';
-export { LockedFieldNotice } from '../admin/LockedFieldNotice.js';
 export { MetricSourceSelect } from '../admin/MetricSourceSelect.js';
-export { PhaseHistory } from '../admin/PhaseHistory.js';
-export { StatusCell } from '../admin/StatusCell.js';
-export { SummaryCell } from '../admin/SummaryCell.js';
-export { ExperimentActions } from '../admin/actions/ExperimentActions.js';
 export { ArmSelectField } from '../admin/armSelect/ArmSelectField.js';
-export { ArmsField } from '../admin/arms/ArmsField.js';
-export { ResultsView } from '../admin/results/ResultsView.js';
-export { ReviewPanel } from '../admin/review/ReviewPanel.js';
-export { TargetingAttributeField } from '../admin/targeting/TargetingAttributeField.js';
-export { TargetingOpField } from '../admin/targeting/TargetingOpField.js';
-export { TargetingValueField } from '../admin/targeting/TargetingValueField.js';
+export { TestsNavLink } from '../admin/TestsNavLink.js';
+export { TestsSurface } from '../admin/surface/TestsSurface.js';

package/dist/exports/adminClient.js

@@ -1,17 +1,6 @@
 'use client';
-export { AllocationField } from '../admin/AllocationField.js';
-export { FlagPointSelect } from '../admin/FlagPointSelect.js';
 export { LayerUsage } from '../admin/LayerUsage.js';
-export { LockedFieldNotice } from '../admin/LockedFieldNotice.js';
 export { MetricSourceSelect } from '../admin/MetricSourceSelect.js';
-export { PhaseHistory } from '../admin/PhaseHistory.js';
-export { StatusCell } from '../admin/StatusCell.js';
-export { SummaryCell } from '../admin/SummaryCell.js';
-export { ExperimentActions } from '../admin/actions/ExperimentActions.js';
 export { ArmSelectField } from '../admin/armSelect/ArmSelectField.js';
-export { ArmsField } from '../admin/arms/ArmsField.js';
-export { ResultsView } from '../admin/results/ResultsView.js';
-export { ReviewPanel } from '../admin/review/ReviewPanel.js';
-export { TargetingAttributeField } from '../admin/targeting/TargetingAttributeField.js';
-export { TargetingOpField } from '../admin/targeting/TargetingOpField.js';
-export { TargetingValueField } from '../admin/targeting/TargetingValueField.js';
+export { TestsNavLink } from '../admin/TestsNavLink.js';
+export { TestsSurface } from '../admin/surface/TestsSurface.js';

package/dist/exports/index.d.ts

@@ -1,4 +1,4 @@
 export { createExperimentsPlugin } from '../plugin.js';
 export { defineFlagPoint, defineMetricSource } from '../define.js';
 export { createArmSelectField } from '../fields/armSelect.js';
-export type { SerializedFlagPoint, SerializedMetricSource, SerializedAttributeKeys, EditableField, Assignment, Assignments, FlagPointResult, ClientAssignments, RenderedExposure, DocId, Attributes, ExposurePolicy, ExperimentKind, Status, UnitType, ArmKey, ArmKind, TargetingRule, Arm, ParamField, MetricSource, FlagPoint, RateLimiter, ExperimentsAccess, ExperimentsPluginOptions, ArmIssueCode, RefusalCode, ErrorEnvelope, TransitionSuccess, AllocateBody, AddMetricBody, DecideBody, ArchiveBody, MakeContentResult, PreflightResult, PreviewTokenResult, PhaseSummary, ResultsResponse, SummaryResponse, EventBody, FlagDefault, Manifest, ManifestExperiment, ArmSlot, ExperimentRef, ExperimentSlotProps, ExperimentsProxyRuntimeOptions, ExperimentsProxyRuntime, ExperimentsServerRuntimeOptions, ExperimentsServerRuntime, VerdictCode, Snapshot, } from '../types/index.js';
+export type { SerializedFlagPoint, SerializedMetricSource, SerializedAttributeKeys, EditableField, Assignment, Assignments, FlagPointResult, ClientAssignments, RenderedExposure, DocId, Attributes, ExposurePolicy, ExperimentKind, Status, UnitType, ArmKey, ArmKind, TargetingRule, Arm, ParamField, MetricSource, FlagPoint, RateLimiter, ExperimentsAccess, ExperimentsPluginOptions, ArmIssueCode, RefusalCode, ReadinessCode, ErrorEnvelope, TransitionSuccess, AllocateBody, AddMetricBody, DecideBody, ArchiveBody, MakeContentResult, PreflightResult, PreviewTokenResult, PhaseSummary, ResultsResponse, SummaryResponse, EventBody, FlagDefault, Manifest, ManifestExperiment, ArmSlot, ExperimentRef, ExperimentSlotProps, ExperimentsProxyRuntimeOptions, ExperimentsProxyRuntime, ExperimentsServerRuntimeOptions, ExperimentsServerRuntime, VerdictCode, Snapshot, } from '../types/index.js';

package/dist/exports/rsc.d.ts

@@ -11,3 +11,6 @@ export { experimentSitemapFilter } from '../server/sitemap.js';
 export { experimentMetadata } from '../server/metadata.js';
 export { toClientAssignments } from '../server/toClientAssignments.js';
 export { contentChangesBeforeHook as captureContentBaseline } from '../hooks/contentChanges.js';
+export { ExperimentsRootView } from '../admin/views/ExperimentsRootView.js';
+export { CollectionListRedirect } from '../admin/views/CollectionListRedirect.js';
+export { CollectionEditRedirect } from '../admin/views/CollectionEditRedirect.js';

package/dist/exports/rsc.js

@@ -11,3 +11,6 @@ export { experimentSitemapFilter } from '../server/sitemap.js';
 export { experimentMetadata } from '../server/metadata.js';
 export { toClientAssignments } from '../server/toClientAssignments.js';
 export { contentChangesBeforeHook as captureContentBaseline } from '../hooks/contentChanges.js';
+export { ExperimentsRootView } from '../admin/views/ExperimentsRootView.js';
+export { CollectionListRedirect } from '../admin/views/CollectionListRedirect.js';
+export { CollectionEditRedirect } from '../admin/views/CollectionEditRedirect.js';

package/dist/options.js

@@ -26,9 +26,38 @@ export function resolveOptions(input) {
     })){
         if (typeof access !== 'function') throw new Error(`Experiments access.${name} must be a function`);
     }
+    if (input.admin !== undefined) {
+        const admin = input.admin;
+        if (!admin || typeof admin !== 'object' || Array.isArray(admin)) throw new Error('Experiments admin must be an object');
+        for (const key of Object.keys(admin)){
+            if (![
+                'editorUrl',
+                'previewUrl',
+                'descriptions'
+            ].includes(key)) throw new Error(`Unknown experiments admin option: ${key}`);
+        }
+        for (const key of [
+            'editorUrl',
+            'previewUrl'
+        ]){
+            if (admin[key] !== undefined && typeof admin[key] !== 'function') throw new Error(`Experiments admin.${key} must be a function`);
+        }
+        if (admin.descriptions !== undefined) {
+            if (!admin.descriptions || typeof admin.descriptions !== 'object' || Array.isArray(admin.descriptions)) throw new Error('Experiments admin.descriptions must be an object');
+            for (const [key, value] of Object.entries(admin.descriptions)){
+                if (![
+                    'block',
+                    'document',
+                    'setting'
+                ].includes(key)) throw new Error(`Unknown experiments admin.descriptions option: ${key}`);
+                if (value !== undefined && typeof value !== 'string') throw new Error(`Experiments admin.descriptions.${key} must be a string`);
+            }
+        }
+    }
     const ids = new Set();
     for (const point of input.flagPoints ?? []){
         if (typeof point.id !== 'string' || !point.id || ids.has(point.id)) throw new Error('Experiments flag point ids must be unique nonempty strings');
+        if (point.description !== undefined && typeof point.description !== 'string') throw new Error('Experiments flag point description must be a string');
         ids.add(point.id);
     }
     // Record keys are unique by construction; validate each declared key and type.

package/dist/plugin.js

@@ -3,6 +3,7 @@ import { buildEndpoints } from './endpoints/index.js';
 import { contentChangesBeforeHook, contentChangesHook } from './hooks/contentChanges.js';
 import { createOnInit } from './onInit.js';
 import { puckCollections, resolveOptions } from './options.js';
+import * as paths from './admin/paths.js';
 export function createExperimentsPlugin(input) {
     const options = resolveOptions(input);
     return (config)=>{
@@ -16,6 +17,30 @@ export function createExperimentsPlugin(input) {
         const onInit = createOnInit(options);
         return {
             ...config,
+            admin: {
+                ...config.admin,
+                dependencies: {
+                    ...config.admin?.dependencies,
+                    xpTestsSurface: {
+                        path: paths.XP_TESTS_SURFACE,
+                        type: 'component'
+                    }
+                },
+                components: {
+                    ...config.admin?.components,
+                    views: {
+                        ...config.admin?.components?.views,
+                        xpTests: {
+                            Component: paths.XP_TESTS_VIEW,
+                            path: '/experiments/:segments*'
+                        }
+                    },
+                    afterNavLinks: [
+                        ...config.admin?.components?.afterNavLinks ?? [],
+                        paths.XP_TESTS_NAV_LINK
+                    ]
+                }
+            },
             collections: [
                 ...(config.collections ?? []).map((collection)=>{
                     const puck = options.puck?.enabled && registrations.some((entry)=>entry.slug === collection.slug);

package/dist/puck/editor/CreateExperimentDrawer.d.ts

@@ -1,5 +1,6 @@
 import type { ExperimentRef } from '../../types/puck.js';
-export declare function CreateExperimentDrawer({ onCreate, onClose }: {
+export declare function CreateExperimentDrawer({ onCreate, onClose, initialName }: {
+    initialName?: string;
     onCreate: (experiment: ExperimentRef) => void;
     onClose: () => void;
 }): import("react").JSX.Element;

package/dist/puck/editor/CreateExperimentDrawer.js

@@ -1,50 +1,31 @@
 'use client';
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useId, useState } from 'react';
-import { slugify } from './editor.model.js';
+import { useId, useRef, useState } from 'react';
+import { CreateRefused, createTest } from './createTest.js';
 import { editorCopy } from './copy.js';
-export function CreateExperimentDrawer({ onCreate, onClose }) {
+export function CreateExperimentDrawer({ onCreate, onClose, initialName = '' }) {
     const titleId = useId();
-    const [name, setName] = useState('');
-    const [slug, setSlug] = useState('');
-    const [slugEdited, setSlugEdited] = useState(false);
+    const [name, setName] = useState(initialName);
+    const inFlight = useRef(false);
     const [pending, setPending] = useState(false);
     const [error, setError] = useState('');
     async function submitNew() {
+        if (inFlight.current || !name.trim()) return;
+        inFlight.current = true;
         setPending(true);
         setError('');
         try {
-            const response = await fetch('/api/xp-experiments', {
-                method: 'POST',
-                credentials: 'include',
-                headers: {
-                    'Content-Type': 'application/json'
-                },
-                body: JSON.stringify({
-                    name,
-                    slug,
-                    kind: 'block',
-                    unitType: 'visitor'
-                })
-            });
-            const body = await response.json();
-            if (!response.ok) {
-                setError(typeof body?.errors?.[0]?.message === 'string' ? body.errors[0].message : editorCopy.createError);
-                return;
-            }
-            const doc = body?.doc;
-            if (!doc || typeof doc.id !== 'string' && typeof doc.id !== 'number' || typeof doc.slug !== 'string') {
-                setError(editorCopy.createError);
-                return;
-            }
-            onCreate({
-                id: doc.id,
-                slug: doc.slug
+            const experiment = await createTest('/api', {
+                name,
+                kind: 'block',
+                unitType: 'visitor'
             });
+            onCreate(experiment);
             onClose();
-        } catch  {
-            setError(editorCopy.createError);
+        } catch (cause) {
+            setError(cause instanceof CreateRefused ? cause.message : editorCopy.createError);
         } finally{
+            inFlight.current = false;
             setPending(false);
         }
     }
@@ -72,28 +53,7 @@ export function CreateExperimentDrawer({ onCreate, onClose }) {
                     /*#__PURE__*/ _jsx("input", {
                         value: name,
                         disabled: pending,
-                        onChange: (event)=>{
-                            setName(event.currentTarget.value);
-                            if (!slugEdited) setSlug(slugify(event.currentTarget.value));
-                        }
-                    })
-                ]
-            }),
-            /*#__PURE__*/ _jsxs("label", {
-                style: {
-                    display: 'block',
-                    marginBottom: 8
-                },
-                children: [
-                    editorCopy.slug,
-                    /*#__PURE__*/ _jsx("input", {
-                        value: slug,
-                        maxLength: 64,
-                        disabled: pending,
-                        onChange: (event)=>{
-                            setSlugEdited(true);
-                            setSlug(event.currentTarget.value);
-                        }
+                        onChange: (event)=>setName(event.currentTarget.value)
                     })
                 ]
             }),
@@ -103,7 +63,7 @@ export function CreateExperimentDrawer({ onCreate, onClose }) {
             }) : null,
             /*#__PURE__*/ _jsx("button", {
                 type: "button",
-                disabled: pending || !name.trim() || !slug.trim(),
+                disabled: pending || !name.trim(),
                 onClick: ()=>{
                     void submitNew();
                 },

package/dist/puck/editor/ExperimentSlotEditor.js

@@ -31,6 +31,7 @@ function EditorRender(props) {
     const [creating, setCreating] = useState(false);
     // A non-empty variant is only overwritten after an explicit second confirmation.
     const [confirming, setConfirming] = useState(null);
+    const pageTitle = usePuckSelector((state)=>typeof state.appState.data.root.props?.title === 'string' ? state.appState.data.root.props.title : '');
     const selected = usePuckSelector((state)=>state.selectedItem?.props.id === props.id);
     const originalEmpty = usePuckSelector((state)=>{
         const content = state.selectedItem?.props.control;
@@ -138,9 +139,14 @@ function EditorRender(props) {
                         children: editorCopy.createLabel
                     }),
                     creating ? /*#__PURE__*/ _jsx(CreateExperimentDrawer, {
+                        initialName: pageTitle,
                         onCreate: bind,
                         onClose: ()=>setCreating(false)
                     }) : null,
+                    experiment?.status === 'draft' ? /*#__PURE__*/ _jsx("a", {
+                        href: `/admin/experiments/${encodeURIComponent(String(experimentId))}`,
+                        children: editorCopy.setup
+                    }) : null,
                     /*#__PURE__*/ _jsx("div", {
                         style: {
                             display: 'flex',

package/dist/puck/editor/copy.d.ts

@@ -5,21 +5,22 @@ export declare const editorCopy: {
         readonly variantB: "Variant B";
         readonly variantC: "Variant C";
     };
-    readonly unbound: "Choose or create an experiment to show different versions.";
-    readonly draft: "This block shows the Original to everyone until the experiment starts.";
+    readonly unbound: "Choose or create a test to show different versions.";
+    readonly draft: "This block shows the Original to everyone until the test starts.";
     readonly running: "Changing this content mid-test mixes two versions in one result";
     readonly decided: (winner: string) => string;
-    readonly archived: "This experiment is archived; the winning content is shown to everyone.";
+    readonly archived: "This test is archived; the winning content is shown to everyone.";
     readonly copy: (label: string) => string;
     readonly replaceConfirm: (label: string) => string;
     readonly replace: "Replace";
-    readonly createLabel: "Create experiment";
+    readonly createLabel: "Test this block";
     readonly creating: "Creating…";
     readonly cancel: "Cancel";
     readonly name: "Name";
-    readonly slug: "Slug";
-    readonly createError: "Couldn't create the experiment. Try again.";
-    readonly loading: "Loading experiment…";
-    readonly loadError: "Couldn't load this experiment. Try selecting it again.";
-    readonly tabs: "Experiment versions";
+    readonly setup: "Set up the test";
+    readonly nameExists: "This name is too close to an existing test. Choose a different name.";
+    readonly createError: "Couldn't create the test. Try again.";
+    readonly loading: "Loading test…";
+    readonly loadError: "Couldn't load this test. Try selecting it again.";
+    readonly tabs: "Test versions";
 };

package/dist/puck/editor/copy.js

@@ -5,21 +5,22 @@ export const editorCopy = {
         variantB: 'Variant B',
         variantC: 'Variant C'
     },
-    unbound: 'Choose or create an experiment to show different versions.',
-    draft: 'This block shows the Original to everyone until the experiment starts.',
+    unbound: 'Choose or create a test to show different versions.',
+    draft: 'This block shows the Original to everyone until the test starts.',
     running: 'Changing this content mid-test mixes two versions in one result',
-    decided: (winner)=>`Decided: ${winner}. Use 'Make it the content' on the experiment to finish.`,
-    archived: 'This experiment is archived; the winning content is shown to everyone.',
+    decided: (winner)=>`Decided: ${winner}. Use 'Make it the content' on the test to finish.`,
+    archived: 'This test is archived; the winning content is shown to everyone.',
     copy: (label)=>`Copy Original → ${label}`,
     replaceConfirm: (label)=>`${label} already has content. Replace it with a copy of the Original?`,
     replace: 'Replace',
-    createLabel: 'Create experiment',
+    createLabel: 'Test this block',
     creating: 'Creating…',
     cancel: 'Cancel',
     name: 'Name',
-    slug: 'Slug',
-    createError: "Couldn't create the experiment. Try again.",
-    loading: 'Loading experiment…',
-    loadError: "Couldn't load this experiment. Try selecting it again.",
-    tabs: 'Experiment versions'
+    setup: 'Set up the test',
+    nameExists: "This name is too close to an existing test. Choose a different name.",
+    createError: "Couldn't create the test. Try again.",
+    loading: 'Loading test…',
+    loadError: "Couldn't load this test. Try selecting it again.",
+    tabs: 'Test versions'
 };

package/dist/puck/editor/createTest.d.ts

@@ -0,0 +1,7 @@
+import type { ExperimentRef } from '../../types/puck.js';
+import { newTestBody } from './editor.model.js';
+/** Only a server refusal may supply editor-facing error text. */
+export declare class CreateRefused extends Error {
+}
+/** Shared lookup, complete draft creation and one retry for a racing slug collision. */
+export declare function createTest(apiRoute: string, input: Omit<Parameters<typeof newTestBody>[0], 'slug'>): Promise<ExperimentRef>;