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

package/dist/admin/theme.css

@@ -1,44 +1,123 @@
-/* The Payload token boundary. Recompute aliases for either admin theme. */
+/* The only Payload token boundary. Reference: Payload 3.90.2; nearest neutral
+   elevation by RGB distance to the approved mockup, advancing toward the mockup
+   on collision so all five surface steps stay distinct (light / dark):
+   bg 50/0; surface 0/50; surface-2 100/100; surface-3 150/150;
+   accent-subtle 200/200;
+   border 100/100; border-strong 250/200; text 850/800;
+   text-2 650/550; text-3 450/350; accent 800/800; hover 900/900;
+   accent-fg 0/0; focus 800/800; series-muted 300/250.
+   Semantic and series hues are fixed mockup literals; only neutrals use Payload. */
 :root, [data-theme] {
-  --xp-bg: var(--theme-bg);
-  --xp-text: var(--theme-text);
-  --xp-surface: var(--theme-elevation-50);
-  --xp-surface-raised: var(--theme-elevation-100);
-  --xp-border: var(--theme-elevation-150);
-  --xp-border-strong: var(--theme-elevation-200);
+  --xp-bg: var(--theme-elevation-50);
+  --xp-surface: var(--theme-elevation-0);
+  --xp-surface-2: var(--theme-elevation-100);
+  --xp-surface-3: var(--theme-elevation-150);
+  --xp-border: var(--theme-elevation-100);
+  --xp-border-strong: var(--theme-elevation-250);
+  --xp-text: var(--theme-elevation-850);
+  --xp-text-2: var(--theme-elevation-650);
+  --xp-text-3: var(--theme-elevation-450);
+  --xp-accent: var(--theme-elevation-800);
+  --xp-accent-hover: var(--theme-elevation-900);
+  --xp-accent-active: var(--theme-elevation-950);
+  --xp-accent-subtle: var(--theme-elevation-200);
+  --xp-accent-fg: var(--theme-elevation-0);
+  --xp-accent-text: var(--xp-text);
+  --xp-accent-text-decoration: none;
+  --xp-focus: var(--theme-elevation-800);
+  --xp-series-muted: var(--theme-elevation-300);
+  --xp-success: #1a6a3a;
+  --xp-success-bg: #e8f4ec;
+  --xp-success-border: #bddfc9;
+  --xp-warning: #8a5a0b;
+  --xp-warning-bg: #fbf3e1;
+  --xp-warning-border: #ecd6a2;
+  --xp-error: #a63030;
+  --xp-error-bg: #fbeaea;
+  --xp-error-border: #efc3c3;
+  --xp-series-a: #2a78d6;
+  --xp-series-b: #eb6834;
+  --xp-series-c: #8056b3;
+  --xp-radius-control: 8px;
+  --xp-radius-card: 12px;
+  --xp-radius-chip: 6px;
+  --xp-font: var(--font-body);
+  --xp-mono: var(--font-mono);
+  --xp-text-display: 600 28px/32px var(--xp-font);
+  --xp-text-title: 600 20px/28px var(--xp-font);
+  --xp-text-body: 400 15px/22px var(--xp-font);
+  --xp-text-small: 400 13px/18px var(--xp-font);
+  --xp-motion: 120ms;
+  --xp-space-half: 2px;
+  --xp-space-one-half: 6px;
+  --xp-version-share-width: 96px;
+  --xp-version-share-width-mobile: 84px;
+  --xp-version-state-width: 192px;
+  --xp-version-remove-width: 128px;
+  --xp-targeting-attribute-width: 150px;
+  --xp-targeting-comparison-width: 140px;
+  --xp-legend-key-size: 10px;
+  --xp-legend-key-radius: 3px;
+  --xp-space-1: 4px;
+  --xp-space-2: 8px;
+  --xp-space-3: 12px;
+  --xp-space-4: 16px;
+  --xp-space-5: 20px;
+  --xp-space-6: 24px;
+  --xp-space-7: 28px;
+  --xp-space-8: 32px;
+  --xp-surface-raised: var(--xp-surface-2);
   --xp-border-control: var(--theme-elevation-250);
   --xp-input-border: var(--theme-elevation-300);
   --xp-border-accent: var(--theme-elevation-400);
-  --xp-accent: var(--theme-elevation-500);
-  --xp-text-muted: var(--theme-elevation-600);
-  --xp-text-strong: var(--theme-elevation-800);
-  --xp-text-emphasis: var(--theme-elevation-900);
+  --xp-text-muted: var(--xp-text-2);
+  --xp-text-strong: var(--xp-text);
+  --xp-text-emphasis: var(--xp-text);
   --xp-input-bg: var(--theme-input-bg);
   --xp-overlay: var(--theme-overlay);
-  --xp-success-surface: var(--theme-success-100);
-  --xp-success-bg: var(--theme-success-150);
-  --xp-success: var(--theme-success-500);
-  --xp-success-text: var(--theme-success-600);
-  --xp-success-text-strong: var(--theme-success-850);
-  --xp-warning-surface: var(--theme-warning-100);
-  --xp-warning-bg: var(--theme-warning-150);
-  --xp-warning: var(--theme-warning-500);
-  --xp-warning-text: var(--theme-warning-600);
-  --xp-warning-text-strong: var(--theme-warning-850);
-  --xp-error-surface: var(--theme-error-100);
-  --xp-error: var(--theme-error-500);
-  --xp-error-text: var(--theme-error-600);
-  --xp-radius: var(--style-radius-s);
-  --xp-radius-large: var(--style-radius-m);
-  --xp-space-1: calc(var(--base) * 0.25);
-  --xp-space-2: calc(var(--base) * 0.5);
-  --xp-space-3: calc(var(--base) * 0.75);
-  --xp-space-4: calc(var(--base) * 1);
-  --xp-space-5: calc(var(--base) * 1.5);
-  --xp-space-6: calc(var(--base) * 2);
+  --xp-success-surface: var(--xp-success-bg);
+  --xp-success-text: var(--xp-success);
+  --xp-success-text-strong: var(--xp-success);
+  --xp-warning-surface: var(--xp-warning-bg);
+  --xp-warning-text: var(--xp-warning);
+  --xp-warning-text-strong: var(--xp-warning);
+  --xp-error-surface: var(--xp-error-bg);
+  --xp-error-text: var(--xp-error);
+  --xp-radius: var(--xp-radius-control);
+  --xp-radius-large: var(--xp-radius-card);
   --xp-dash-card-gap: 12px;
-  --xp-dash-card-gap-small: calc(var(--base) * 0.4);
-  --xp-font-body: var(--font-body);
-  --xp-font-size-small: calc(var(--base) * 0.65);
-  --xp-font-size-body: calc(var(--base) * 0.75);
+  --xp-dash-card-gap-small: 8px;
+  --xp-font-body: var(--xp-font);
+  --xp-font-size-small: 13px;
+  --xp-font-size-body: 15px;
+}
+[data-theme="dark"] {
+  --xp-bg: var(--theme-elevation-0);
+  --xp-surface: var(--theme-elevation-50);
+  --xp-surface-2: var(--theme-elevation-100);
+  --xp-surface-3: var(--theme-elevation-150);
+  --xp-border: var(--theme-elevation-100);
+  --xp-border-strong: var(--theme-elevation-200);
+  --xp-text: var(--theme-elevation-800);
+  --xp-text-2: var(--theme-elevation-550);
+  --xp-text-3: var(--theme-elevation-350);
+  --xp-accent: var(--theme-elevation-800);
+  --xp-accent-hover: var(--theme-elevation-900);
+  --xp-accent-active: var(--theme-elevation-1000);
+  --xp-accent-subtle: var(--theme-elevation-200);
+  --xp-accent-fg: var(--theme-elevation-0);
+  --xp-focus: var(--theme-elevation-800);
+  --xp-series-muted: var(--theme-elevation-250);
+  --xp-success: #7fd49c;
+  --xp-success-bg: #142b1d;
+  --xp-success-border: #23492f;
+  --xp-warning: #e7bd5c;
+  --xp-warning-bg: #2b2312;
+  --xp-warning-border: #4d3d17;
+  --xp-error: #f09494;
+  --xp-error-bg: #2f1717;
+  --xp-error-border: #5a2626;
+  --xp-series-a: #3987e5;
+  --xp-series-b: #d95926;
+  --xp-series-c: #b48ade;
 }

package/dist/admin/theme.d.ts

@@ -1,9 +1,33 @@
+/** Host accent rules (reference surfaces are defined by theme.css):
+ * (i) Foreground on accent, hover and active fills reaches 4.5:1 in both themes.
+ * (ii) Accent text moves toward the surface's opposite to reach 4.5:1; if the
+ * bounded search fails, use the neutral text token and underline it.
+ * (iii) Focus reaches 3:1 against the surface: darken on light, lighten on dark.
+ */
+export { deriveAccent } from '../ui/accent.js';
 /** every Payload token reference lives in theme.css; porting to Payload 4 edits that file only */
 export declare const theme: {
     readonly color: {
         readonly bg: "var(--xp-bg)";
         readonly text: "var(--xp-text)";
         readonly surface: "var(--xp-surface)";
+        readonly surface2: "var(--xp-surface-2)";
+        readonly surface3: "var(--xp-surface-3)";
+        readonly text2: "var(--xp-text-2)";
+        readonly text3: "var(--xp-text-3)";
+        readonly accentHover: "var(--xp-accent-hover)";
+        readonly accentActive: "var(--xp-accent-active)";
+        readonly accentText: "var(--xp-accent-text)";
+        readonly accentSubtle: "var(--xp-accent-subtle)";
+        readonly accentFg: "var(--xp-accent-fg)";
+        readonly focus: "var(--xp-focus)";
+        readonly successBorder: "var(--xp-success-border)";
+        readonly warningBorder: "var(--xp-warning-border)";
+        readonly errorBg: "var(--xp-error-bg)";
+        readonly errorBorder: "var(--xp-error-border)";
+        readonly seriesA: "var(--xp-series-a)";
+        readonly seriesB: "var(--xp-series-b)";
+        readonly seriesMuted: "var(--xp-series-muted)";
         readonly surfaceRaised: "var(--xp-surface-raised)";
         readonly border: "var(--xp-border)";
         readonly borderStrong: "var(--xp-border-strong)";
@@ -30,7 +54,17 @@ export declare const theme: {
         readonly error: "var(--xp-error)";
         readonly errorText: "var(--xp-error-text)";
     };
+    readonly motion: "var(--xp-motion)";
+    readonly type: {
+        readonly display: "var(--xp-text-display)";
+        readonly title: "var(--xp-text-title)";
+        readonly body: "var(--xp-text-body)";
+        readonly small: "var(--xp-text-small)";
+    };
     readonly radius: {
+        readonly control: "var(--xp-radius-control)";
+        readonly card: "var(--xp-radius-card)";
+        readonly chip: "var(--xp-radius-chip)";
         readonly small: "var(--xp-radius)";
         readonly large: "var(--xp-radius-large)";
     };
@@ -41,8 +75,12 @@ export declare const theme: {
         readonly 4: "var(--xp-space-4)";
         readonly 5: "var(--xp-space-5)";
         readonly 6: "var(--xp-space-6)";
+        readonly 7: "var(--xp-space-7)";
+        readonly 8: "var(--xp-space-8)";
     };
     readonly font: {
+        readonly mono: "var(--xp-mono)";
+        readonly family: "var(--xp-font)";
         readonly body: "var(--xp-font-body)";
         readonly small: "var(--xp-font-size-small)";
         readonly size: "var(--xp-font-size-body)";

package/dist/admin/theme.js

@@ -1,8 +1,31 @@
+/** Host accent rules (reference surfaces are defined by theme.css):
+ * (i) Foreground on accent, hover and active fills reaches 4.5:1 in both themes.
+ * (ii) Accent text moves toward the surface's opposite to reach 4.5:1; if the
+ * bounded search fails, use the neutral text token and underline it.
+ * (iii) Focus reaches 3:1 against the surface: darken on light, lighten on dark.
+ */ export { deriveAccent } from '../ui/accent.js';
 /** every Payload token reference lives in theme.css; porting to Payload 4 edits that file only */ export const theme = {
     color: {
         bg: 'var(--xp-bg)',
         text: 'var(--xp-text)',
         surface: 'var(--xp-surface)',
+        surface2: 'var(--xp-surface-2)',
+        surface3: 'var(--xp-surface-3)',
+        text2: 'var(--xp-text-2)',
+        text3: 'var(--xp-text-3)',
+        accentHover: 'var(--xp-accent-hover)',
+        accentActive: 'var(--xp-accent-active)',
+        accentText: 'var(--xp-accent-text)',
+        accentSubtle: 'var(--xp-accent-subtle)',
+        accentFg: 'var(--xp-accent-fg)',
+        focus: 'var(--xp-focus)',
+        successBorder: 'var(--xp-success-border)',
+        warningBorder: 'var(--xp-warning-border)',
+        errorBg: 'var(--xp-error-bg)',
+        errorBorder: 'var(--xp-error-border)',
+        seriesA: 'var(--xp-series-a)',
+        seriesB: 'var(--xp-series-b)',
+        seriesMuted: 'var(--xp-series-muted)',
         surfaceRaised: 'var(--xp-surface-raised)',
         border: 'var(--xp-border)',
         borderStrong: 'var(--xp-border-strong)',
@@ -29,7 +52,17 @@
         error: 'var(--xp-error)',
         errorText: 'var(--xp-error-text)'
     },
+    motion: 'var(--xp-motion)',
+    type: {
+        display: 'var(--xp-text-display)',
+        title: 'var(--xp-text-title)',
+        body: 'var(--xp-text-body)',
+        small: 'var(--xp-text-small)'
+    },
     radius: {
+        control: 'var(--xp-radius-control)',
+        card: 'var(--xp-radius-card)',
+        chip: 'var(--xp-radius-chip)',
         small: 'var(--xp-radius)',
         large: 'var(--xp-radius-large)'
     },
@@ -39,9 +72,13 @@
         3: 'var(--xp-space-3)',
         4: 'var(--xp-space-4)',
         5: 'var(--xp-space-5)',
-        6: 'var(--xp-space-6)'
+        6: 'var(--xp-space-6)',
+        7: 'var(--xp-space-7)',
+        8: 'var(--xp-space-8)'
     },
     font: {
+        mono: 'var(--xp-mono)',
+        family: 'var(--xp-font)',
         body: 'var(--xp-font-body)',
         small: 'var(--xp-font-size-small)',
         size: 'var(--xp-font-size-body)'

package/dist/admin/useApi.d.ts

@@ -1,17 +1,32 @@
 export declare function useApi(): {
     start: (id: import("../types/contracts.js").DocId) => Promise<import("./api.js").ApiResult<import("../types/endpoints.js").TransitionSuccess>>;
-    allocate: (id: import("../types/contracts.js").DocId, body: import("../types/endpoints.js").AllocateBody) => Promise<import("./api.js").ApiResult<import("../types/endpoints.js").TransitionSuccess>>;
-    addMetric: (id: import("../types/contracts.js").DocId, body: import("../types/endpoints.js").AddMetricBody) => Promise<import("./api.js").ApiResult<import("../types/endpoints.js").TransitionSuccess>>;
+    allocate: (id: import("../types/contracts.js").DocId, body: import("../types/endpoints.js").AllocateBody, options?: {
+        notFound?: string;
+        codes?: Readonly<Record<string, string>>;
+        fallback?: string;
+    }) => Promise<import("./api.js").ApiResult<import("../types/endpoints.js").TransitionSuccess>>;
+    addMetric: (id: import("../types/contracts.js").DocId, body: import("../types/endpoints.js").AddMetricBody, options?: {
+        notFound?: string;
+        codes?: Readonly<Record<string, string>>;
+        fallback?: string;
+    }) => Promise<import("./api.js").ApiResult<import("../types/endpoints.js").TransitionSuccess>>;
     stop: (id: import("../types/contracts.js").DocId) => Promise<import("./api.js").ApiResult<import("../types/endpoints.js").TransitionSuccess>>;
     decide: (id: import("../types/contracts.js").DocId, body: import("../types/endpoints.js").DecideBody) => Promise<import("./api.js").ApiResult<import("../types/endpoints.js").TransitionSuccess>>;
     releaseHoldout: (id: import("../types/contracts.js").DocId) => Promise<import("./api.js").ApiResult<import("../types/endpoints.js").TransitionSuccess>>;
+    releasePages: (id: import("../types/contracts.js").DocId) => Promise<import("./api.js").ApiResult<import("../types/endpoints.js").TransitionSuccess>>;
     makeContent: (id: import("../types/contracts.js").DocId) => Promise<import("./api.js").ApiResult<import("../types/endpoints.js").MakeContentResult>>;
+    dismissContentEntry: (id: import("../types/contracts.js").DocId, body: import("../types/endpoints.js").DismissContentEntryBody) => Promise<import("./api.js").ApiResult<import("../types/endpoints.js").DismissContentEntryResult>>;
+    restoreContentEntry: (id: import("../types/contracts.js").DocId, body: import("../types/endpoints.js").RestoreContentEntryBody) => Promise<import("./api.js").ApiResult<import("../types/endpoints.js").RestoreContentEntryResult>>;
     archive: (id: import("../types/contracts.js").DocId, body: import("../types/endpoints.js").ArchiveBody) => Promise<import("./api.js").ApiResult<import("../types/endpoints.js").TransitionSuccess>>;
     preflight: (id: import("../types/contracts.js").DocId) => Promise<import("./api.js").ApiResult<import("../types/endpoints.js").PreflightResult>>;
     previewToken: (id: import("../types/contracts.js").DocId, arm: string) => Promise<import("./api.js").ApiResult<import("../types/endpoints.js").PreviewTokenResult>>;
     results: (id: import("../types/contracts.js").DocId, options?: {
         phase?: number;
         series?: boolean;
+    } & {
+        notFound?: string;
+        codes?: Readonly<Record<string, string>>;
+        fallback?: string;
     }) => Promise<import("./api.js").ApiResult<import("../types/endpoints.js").ResultsResponse>>;
     recompute: (id: import("../types/contracts.js").DocId) => Promise<import("./api.js").ApiResult<{
         snapshotId: string;

package/dist/admin/useLayerUsage.js

@@ -1,4 +1,5 @@
 'use client';
+import { fetchAllDocs } from '../lib/fetchAllDocs.js';
 import { useConfig } from '@payloadcms/ui';
 import { useEffect, useState } from 'react';
 import { layerUsage } from './layerUsage.model.js';
@@ -13,33 +14,23 @@ export function useLayerExperiments(layerId) {
         if (id == null) return;
         const controller = new AbortController();
         async function load() {
-            const docs = [];
-            let page = 1;
-            while(!controller.signal.aborted){
-                const query = new URLSearchParams({
-                    depth: '0',
-                    limit: '100',
-                    page: String(page),
-                    'where[layer][equals]': id,
-                    'where[status][in]': 'running,decided'
-                });
-                const response = await fetch(`${api}/xp-experiments?${query}`, {
-                    credentials: 'include',
-                    signal: controller.signal
-                });
-                if (!response.ok) {
-                    if (!controller.signal.aborted) setState(null);
-                    return;
-                }
-                const data = await response.json();
-                docs.push(...data.docs);
-                if (!data.hasNextPage) break;
-                page++;
+            const query = new URLSearchParams({
+                depth: '0',
+                'where[layer][equals]': id,
+                'where[status][in]': 'running,decided'
+            });
+            const response = await fetchAllDocs(`${api}/xp-experiments?${query}`, {
+                credentials: 'include',
+                signal: controller.signal
+            });
+            if (!response.ok) {
+                if (!controller.signal.aborted) setState(null);
+                return;
             }
             if (!controller.signal.aborted) setState({
                 api,
                 id: id,
-                usage: layerUsage(docs)
+                usage: layerUsage(response.docs)
             });
         }
         void load().catch(()=>{

package/dist/admin/views/ExperimentsRootView.js

@@ -1,4 +1,5 @@
-import { jsx as _jsx } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { accentStyles } from '../../ui/accent.js';
 import { formatAdminURL } from 'payload/shared';
 import { notFound, redirect } from 'next/navigation.js';
 import { RenderServerComponent } from '@payloadcms/ui/elements/RenderServerComponent';
@@ -166,10 +167,19 @@ export async function ExperimentsRootView({ initPageResult, params, searchParams
             children: SURFACE_COPY.notInstalled
         });
     }
-    return RenderServerComponent({
+    const css = accentStyles(options.theme?.accent);
+    const surface = RenderServerComponent({
         Component: XP_TESTS_SURFACE,
         Fallback: TestsSurfaceFallback,
         importMap: req.payload.importMap,
         clientProps
     });
+    return css ? /*#__PURE__*/ _jsxs(_Fragment, {
+        children: [
+            /*#__PURE__*/ _jsx("style", {
+                children: css
+            }),
+            surface
+        ]
+    }) : surface;
 }

package/dist/admin/views/TestsNavLinkServer.d.ts

@@ -0,0 +1,2 @@
+import type { ServerProps } from 'payload';
+export declare function TestsNavLinkServer({ payload, user, permissions }: Pick<ServerProps, 'payload' | 'user' | 'permissions'>): Promise<string | number | bigint | boolean | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<import("react").ReactNode> | null | undefined>;

package/dist/admin/views/TestsNavLinkServer.js

@@ -0,0 +1,43 @@
+import { RenderServerComponent } from '@payloadcms/ui/elements/RenderServerComponent';
+import { SURFACE_COPY } from '../copy/surface.js';
+import { XP_TESTS_NAV_CLIENT } from '../paths.js';
+export async function TestsNavLinkServer({ payload, user, permissions }) {
+    const testPermissions = permissions?.collections?.['xp-experiments'];
+    if (!user?.collection || testPermissions?.update !== true) return null;
+    const result = await payload.find({
+        collection: 'payload-preferences',
+        where: {
+            and: [
+                {
+                    key: {
+                        equals: 'nav'
+                    }
+                },
+                {
+                    'user.relationTo': {
+                        equals: user.collection
+                    }
+                },
+                {
+                    'user.value': {
+                        equals: user.id
+                    }
+                }
+            ]
+        },
+        limit: 1,
+        pagination: false,
+        depth: 0,
+        user,
+        overrideAccess: false
+    });
+    const value = result.docs[0]?.value;
+    // Resolve the CSS-bearing client boundary through Payload's public import map.
+    return RenderServerComponent({
+        Component: XP_TESTS_NAV_CLIENT,
+        importMap: payload.importMap,
+        clientProps: {
+            isOpen: value?.groups?.[SURFACE_COPY.title]?.open ?? true
+        }
+    });
+}

package/dist/arms/copy.d.ts

@@ -0,0 +1,6 @@
+import type { ArmIssueCode } from '../types/endpoints.js';
+export declare const ISSUE_COPY: Record<ArmIssueCode, string>;
+export declare function issueMessage(issue: {
+    code: string;
+    message: string;
+}, total: number): string;

package/dist/arms/copy.js

@@ -0,0 +1,16 @@
+export const ISSUE_COPY = {
+    'weights-total': 'Weights must add up to 100%. They add up to {total}% now.',
+    'control-count': 'Include exactly one Original.',
+    'control-first': 'Put the Original first.',
+    'holdout-last': 'Put the holdout last.',
+    'holdout-count': 'Include only one holdout.',
+    'variant-count': 'Include up to three variants.',
+    'duplicate-key': 'Each group must have a different standard name.',
+    'duplicate-slot': 'Each group must have a different content slot.',
+    'slot-required': 'Choose the matching content slot for this group.',
+    'invalid-key': 'Use the standard group names: Original, Variant A–C, Holdout.'
+};
+export function issueMessage(issue, total) {
+    const copy = Object.hasOwn(ISSUE_COPY, issue.code) ? ISSUE_COPY[issue.code] : issue.message;
+    return copy.replace('{total}', String(total));
+}

package/dist/arms/model.d.ts

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