@qoretechnologies/reqraft 0.10.62 → 0.10.63-pr.142.g0b675cd

package/src/tracking/ui/anchor.ts

@@ -1,180 +0,0 @@
-/**
- * The plain logic behind the A/B test overlay: where the handle and the card go (anchored to the
- * tested element, flipped above or below to stay in view), and which card is open (hover,
- * keyboard focus, a click; closed by ✕, Esc or a click outside). No React, no DOM
- * (unit-tested in `__tests__/tracking/anchor.test.ts`).
- */
-
-// ── anchoring ────────────────────────────────────────────────────────────────────
-
-export interface IBox {
-  top: number;
-  left: number;
-  width: number;
-  height: number;
-}
-
-export interface IPlaceInput {
-  /** The tested element's box, in viewport coordinates. */
-  box: IBox;
-  viewport: { width: number; height: number };
-  /** The page's scroll offset: the result is in document coordinates. */
-  scroll: { x: number; y: number };
-  /** The handle's measured size. */
-  handle: { width: number; height: number };
-  /** The card's measured size, when it is open (its natural height, before any cap). */
-  card?: { height: number } | null;
-  /** The part of the viewport the app's sticky header covers (the handle and the card stay below it). */
-  topInset: number;
-  /** The smallest distance to a viewport edge. */
-  edge?: number;
-  /** Between the handle and the card. */
-  gap?: number;
-  /** The card's widest. */
-  maxWidth?: number;
-  /** The side the card is on now: it stays there while it still fits, so it does not jump while scrolling. */
-  side?: 'below' | 'above';
-}
-
-export interface IPlacement {
-  /** False when no part of the element is on screen: nothing is drawn. */
-  visible: boolean;
-  /** Document coordinates. */
-  outline: IBox;
-  handle: { top: number; left: number };
-  card: {
-    top: number;
-    left: number;
-    width: number;
-    maxHeight: number;
-    side: 'below' | 'above';
-  } | null;
-}
-
-export const CARD_MAX_WIDTH = 440;
-/** The card never gets shorter than this; a smaller window scrolls inside it. */
-export const CARD_MIN_HEIGHT = 180;
-
-const clamp = (n: number, lo: number, hi: number) => Math.min(Math.max(n, lo), Math.max(lo, hi));
-
-/**
- * Where the outline, the handle and the card go. The handle sits at the element's top-left
- * corner and, while the element is partly scrolled away, slides down to stay on its visible
- * part. The card hangs under the handle, or above it when there is more room there than
- * below and it does not fit below; its height is capped to that room (it scrolls inside).
- */
-export const placeCard = ({
-  box,
-  viewport,
-  scroll,
-  handle,
-  card,
-  topInset,
-  edge = 12,
-  gap = 8,
-  maxWidth = CARD_MAX_WIDTH,
-  side: current,
-}: IPlaceInput): IPlacement => {
-  const bottom = box.top + box.height;
-  const right = box.left + box.width;
-  const outline = {
-    top: box.top + scroll.y,
-    left: box.left + scroll.x,
-    width: box.width,
-    height: box.height,
-  };
-  const visible =
-    bottom > topInset && box.top < viewport.height && right > 0 && box.left < viewport.width;
-
-  // The handle: inside the element, below the header, above the element's bottom edge.
-  const hTop = Math.min(Math.max(box.top + edge, topInset + edge), bottom - handle.height - edge);
-  const hLeft = clamp(box.left + edge, edge, viewport.width - handle.width - edge);
-  const handlePos = { top: Math.max(hTop, box.top) + scroll.y, left: hLeft + scroll.x };
-
-  if (!card) return { visible, outline, handle: handlePos, card: null };
-
-  const width = Math.min(maxWidth, viewport.width - 2 * edge);
-  const left = clamp(hLeft, edge, viewport.width - width - edge);
-  const handleTop = handlePos.top - scroll.y;
-  const handleBottom = handleTop + handle.height;
-  const below = viewport.height - edge - (handleBottom + gap);
-  const above = handleTop - gap - (topInset + edge);
-  const fits = { below: card.height <= below, above: card.height <= above };
-  const side: 'below' | 'above' =
-    current && fits[current] ? current
-    : fits.below || below >= above ? 'below'
-    : 'above';
-  const room = Math.max(side === 'below' ? below : above, CARD_MIN_HEIGHT);
-  const height = Math.min(card.height, room);
-  const top = side === 'below' ? handleBottom + gap : handleTop - gap - height;
-  return {
-    visible,
-    outline,
-    handle: handlePos,
-    card: { top: top + scroll.y, left: left + scroll.x, width, maxHeight: room, side },
-  };
-};
-
-// ── which card is open ────────────────────────────────────────────────────────────
-
-export interface ICardState {
-  /** The test whose element (or card) the pointer is over. */
-  hovered: string | null;
-  /** The test whose handle or card holds the keyboard focus. */
-  focused: string | null;
-  /** The test opened with a click or a tap: stays open until closed. */
-  pinned: string | null;
-  /** Closed while the pointer was still over it: hovering it opens it again only after leaving it. */
-  dismissed: string | null;
-}
-
-export type TCardEvent =
-  | { type: 'hover'; key: string | null }
-  | { type: 'focus'; key: string }
-  | { type: 'blur'; key: string }
-  | { type: 'toggle'; key: string }
-  /** ✕, Esc, a click outside, an action that re-renders the element. */
-  | { type: 'close' };
-
-export const CLOSED: ICardState = { hovered: null, focused: null, pinned: null, dismissed: null };
-
-/** The one open card: a click wins, then the keyboard, then the pointer. */
-export const openCard = (s: ICardState): string | null =>
-  s.pinned ?? s.focused ?? (s.hovered !== s.dismissed ? s.hovered : null);
-
-export const cardReducer = (s: ICardState, e: TCardEvent): ICardState => {
-  switch (e.type) {
-    case 'hover':
-      if (e.key === s.hovered) return s;
-      // Leaving the element a card was closed on lets hovering open it again.
-      return {
-        ...s,
-        hovered: e.key,
-        dismissed: s.dismissed && s.dismissed !== e.key ? null : s.dismissed,
-      };
-    case 'focus':
-      return s.focused === e.key && s.dismissed !== e.key ?
-          s
-        : { ...s, focused: e.key, dismissed: s.dismissed === e.key ? null : s.dismissed };
-    case 'blur':
-      return s.focused === e.key ? { ...s, focused: null } : s;
-    case 'toggle':
-      // A click on the handle of an open card pins it (hover or focus opened it); a second click closes it.
-      return s.pinned === e.key ?
-          cardReducer(s, { type: 'close' })
-        : { ...s, pinned: e.key, dismissed: null };
-    case 'close': {
-      const open = openCard(s);
-      if (!open) return s;
-      return { hovered: s.hovered, focused: null, pinned: null, dismissed: s.hovered ?? open };
-    }
-  }
-};
-
-/** Enter or Space on a version's row itself (not on its Accept / Remove buttons) shows that version. */
-export const activatesRow = (key: string, onRowItself: boolean) =>
-  onRowItself && (key === 'Enter' || key === ' ');
-
-/** Whether a click lands outside the overlay's cards (and outside Reqore's dialogs and menus they open). */
-export const OUTSIDE_IGNORE =
-  '[data-experiment-float], .reqore-modal, .reqore-popover-content, .reqore-drawer, .reqore-notification, [role="dialog"]';

package/src/tracking/ui/card.ts

@@ -1,464 +0,0 @@
-/**
- * What the A/B test card shows, as plain functions of the qorus-api objects: the version rows,
- * the verdict, the numbers line, the bars, the status tag, which actions a status allows, and
- * the words of the confirm step and of the outcome. No React, no DOM (unit-tested in
- * `__tests__/tracking/card.test.ts`).
- */
-import type {
-  IAdminVariant,
-  IExperimentEntry,
-  IExperimentResults,
-  TExperimentActionResult,
-  TExperimentStatus,
-  TLifecycleAction,
-  TVersionAction,
-} from './types';
-
-export const canAccept = (status: TExperimentStatus) =>
-  status === 'running' || status === 'paused' || status === 'stopped';
-/** Start a draft, or resume a paused test. */
-export const canStart = (status: TExperimentStatus) => status === 'draft' || status === 'paused';
-export const canPause = (status: TExperimentStatus) => status === 'running';
-export const canStop = (status: TExperimentStatus) => status === 'running' || status === 'paused';
-export const canRemove = (status: TExperimentStatus, versions: number) =>
-  (status === 'draft' || status === 'running' || status === 'paused') && versions > 1;
-
-export interface IVersionRow {
-  key: string;
-  name: string;
-  control: boolean;
-  /** Visitors exposed in the current phase (null: no numbers yet). */
-  visitors: number | null;
-  /** Conversion on the primary metric, 0..1. */
-  conversion: number | null;
-  /** Chance to beat the original on the primary metric, 0..1 (null for the original). */
-  chance: number | null;
-  /** The page's code renders it (false: the server has a version the code does not, so it cannot be shown). */
-  inCode: boolean;
-}
-
-export const primaryMetric = (results: IExperimentResults | null | undefined) =>
-  results?.metrics?.find((m) => m.role === 'primary') ?? null;
-
-export const versionName = (key: string) => `Version ${key.toUpperCase()}`;
-
-/**
- * One row per version. Keys come from the server's experiment when there is one, otherwise from
- * the page's code (`codeVariants`, the `data-variants` of `<Experiment>`): a test that exists
- * only in code can still be switched.
- */
-export const versionRows = (
-  entry: IExperimentEntry | undefined,
-  codeVariants: string[] = []
-): IVersionRow[] => {
-  const metric = primaryMetric(entry?.results);
-  const variants: IAdminVariant[] =
-    entry?.experiment.variants?.length ?
-      entry.experiment.variants
-    : codeVariants.map((key, i) => ({ key, weight: 1, control: i === 0 }));
-  return variants.map((v) => {
-    const r = metric?.variants.find((x) => x.variant === v.key);
-    return {
-      key: v.key,
-      name: v.name || versionName(v.key),
-      control: !!v.control,
-      visitors: r ? r.exposed : null,
-      conversion: r?.rate ?? null,
-      chance: v.control ? null : (r?.chance_to_beat ?? null),
-      inCode: codeVariants.length === 0 || codeVariants.includes(v.key),
-    };
-  });
-};
-
-const nameOf = (entry: IExperimentEntry, key: string | null | undefined) =>
-  entry.experiment.variants.find((v) => v.key === key)?.name ||
-  (key ? versionName(key) : 'a version');
-
-/** The verdict in plain words: the server's sentence when it sends one. */
-/** The test is in the page's code, but the analytics service does not know it (or cannot be reached). */
-export const NOT_SET_UP_TEXT =
-  "This test is in the page's code but isn't set up yet: ask the Designer to set it up. Until then you can switch versions here, but nothing is counted.";
-export const UNREACHABLE_TEXT =
-  "Can't reach the analytics service right now, so there are no numbers and no test controls. You can still switch versions here; try again in a minute.";
-
-/**
- * The verdict in plain words: the server's sentence when it sends one. Without a server entry:
- * `unreachable` (the list could not be loaded) or not set up yet (`notSetUpText`).
- */
-export const verdictLine = (
-  entry: IExperimentEntry | undefined,
-  {
-    unreachable = false,
-    notSetUpText = NOT_SET_UP_TEXT,
-  }: { unreachable?: boolean; notSetUpText?: string } = {}
-): string => {
-  if (!entry) return unreachable ? UNREACHABLE_TEXT : notSetUpText;
-  const { experiment: e, results } = entry;
-  if (results?.verdict_text) return results.verdict_text;
-  if (e.status === 'concluded')
-    return `Finished: ${nameOf(entry, e.winner)} won, and every visitor now sees it.`;
-  if (e.status === 'draft')
-    return 'Not started yet: press Start test to split visitors between the versions.';
-  if (!results) return 'No numbers yet.';
-  const control = e.variants.find((v) => v.control)?.key;
-  switch (results.verdict) {
-    case 'likely-winner':
-      return `${nameOf(entry, results.winner_variant)} is likely better than ${nameOf(entry, control)}.`;
-    case 'likely-loser':
-      return `The new versions are likely worse than ${nameOf(entry, control)}.`;
-    case 'no-clear-difference':
-      return 'No clear difference between the versions yet.';
-    default:
-      return 'Too early to tell.';
-  }
-};
-
-export const percent = (n: number | null | undefined, digits = 1) =>
-  n == null || !Number.isFinite(n) ? '–' : `${(n * 100).toFixed(digits).replace(/\.0$/, '')}%`;
-
-export const count = (n: number | null | undefined) =>
-  n == null ? '–' : n.toLocaleString('en-US');
-
-/**
- * One line of numbers under a version: visitors, conversion, chance to beat the original. In
- * words when there is nothing to count yet, never a row of dashes.
- */
-export const numbersLine = (row: IVersionRow, metricName?: string, status?: TExperimentStatus) => {
-  if (!row.visitors) {
-    if (status === 'draft') return 'Not started: no visitors yet';
-    return row.visitors === 0 ? 'No visitors yet' : 'No numbers yet';
-  }
-  const parts = [
-    `${count(row.visitors)} visitors`,
-    `${percent(row.conversion)} ${metricName ? `“${metricName}”` : 'conversion'}`,
-  ];
-  if (!row.control && row.chance != null)
-    parts.push(`${percent(row.chance, 0)} chance to beat the original`);
-  return parts.join(' · ');
-};
-
-/** Each version's bar: its conversion as a share of the best one (0..100; 0 with no numbers). */
-export const barValues = (rows: IVersionRow[]): number[] => {
-  const best = Math.max(0, ...rows.map((r) => r.conversion ?? 0));
-  return rows.map((r) => (best > 0 && r.conversion ? Math.round((r.conversion / best) * 100) : 0));
-};
-
-/** The verdict's colour: green for a likely winner, amber for likely losers, neutral otherwise. */
-export const verdictIntent = (
-  entry: IExperimentEntry | undefined
-): 'success' | 'warning' | 'info' | 'muted' => {
-  if (!entry) return 'muted';
-  if (entry.experiment.status === 'concluded') return 'success';
-  const v = entry.results?.verdict;
-  return (
-    v === 'likely-winner' ? 'success'
-    : v === 'likely-loser' ? 'warning'
-    : 'info'
-  );
-};
-
-export const STATUS_LABEL: Record<TExperimentStatus, string> = {
-  draft: 'Draft',
-  running: 'Running',
-  paused: 'Paused',
-  stopped: 'Stopped',
-  concluded: 'Ended',
-  archived: 'Archived',
-};
-
-export type TStatusIntent = 'success' | 'warning' | 'danger' | 'muted';
-
-/** The status tag: its words (with the phase after a removal), its icon and its colour. */
-export const statusTag = (
-  entry: IExperimentEntry | undefined,
-  unreachable = false
-): { label: string; icon: string; intent: TStatusIntent } => {
-  if (!entry) {
-    return unreachable ?
-        { label: 'No connection', icon: 'WifiOffLine', intent: 'warning' }
-      : { label: 'Not set up', icon: 'QuestionLine', intent: 'muted' };
-  }
-  const { status, phase } = entry.experiment;
-  const label = `${STATUS_LABEL[status] ?? status}${phase && phase > 1 ? ` · phase ${phase}` : ''}`;
-  switch (status) {
-    case 'running':
-      return { label, icon: 'PlayCircleLine', intent: 'success' };
-    case 'paused':
-      return { label, icon: 'PauseCircleLine', intent: 'warning' };
-    case 'draft':
-      return { label, icon: 'PencilRulerLine', intent: 'muted' };
-    case 'stopped':
-      return { label, icon: 'StopCircleLine', intent: 'danger' };
-    default:
-      return { label, icon: 'TrophyLine', intent: 'success' };
-  }
-};
-
-export interface IConfirmCopy {
-  title: string;
-  description: string;
-  confirmLabel: string;
-}
-
-/** What the confirm step says before Accept / Remove. */
-export const confirmCopy = (
-  action: TVersionAction,
-  entry: IExperimentEntry,
-  variant: string
-): IConfirmCopy => {
-  const name = nameOf(entry, variant);
-  if (action === 'accept') {
-    return {
-      title: `Make “${name}” the winner?`,
-      description: `This ends the test. From then on every visitor sees “${name}”. A developer removes the other versions' code later.`,
-      confirmLabel: `Accept ${name}`,
-    };
-  }
-  const rest = entry.experiment.variants.filter((v) => v.key !== variant);
-  // The server concludes the test with the last version, a draft included.
-  if (rest.length === 1) {
-    const last = nameOf(entry, rest[0].key);
-    return {
-      title: `Remove “${name}”?`,
-      description: `Only “${last}” would be left, so it becomes the winner and the test ends. Every visitor then sees “${last}”.`,
-      confirmLabel: `Remove and accept ${last}`,
-    };
-  }
-  return {
-    title: `Remove “${name}” from the test?`,
-    description:
-      entry.experiment.status === 'draft' ?
-        `The test will start without “${name}”.`
-      : `Nobody sees “${name}” any more. The test starts counting again with the remaining versions, so the numbers start from zero.`,
-    confirmLabel: `Remove ${name}`,
-  };
-};
-
-/** What the confirm step says before Start / Pause / Stop. */
-export const lifecycleCopy = (action: TLifecycleAction, entry: IExperimentEntry): IConfirmCopy => {
-  const e = entry.experiment;
-  const name = e.name || e.key;
-  const versions = e.variants.map((v) => `“${v.name || v.key}”`).join(' and ');
-  switch (action) {
-    case 'start':
-      return e.status === 'paused' ?
-          {
-            title: `Resume “${name}”?`,
-            description: `Visitors are split between ${versions} again and counted.`,
-            confirmLabel: 'Resume the test',
-          }
-        : {
-            title: `Start “${name}”?`,
-            description: `From now on, visitors who allow analytics are split between ${versions}, and each version's numbers are counted. You can pause or stop it at any time.`,
-            confirmLabel: 'Start the test',
-          };
-    case 'pause':
-      return {
-        title: `Pause “${name}”?`,
-        description: `Everybody sees the original, “${nameOf(entry, e.variants.find((v) => v.control)?.key)}”, and nothing is counted until you resume it.`,
-        confirmLabel: 'Pause the test',
-      };
-    case 'stop':
-    default:
-      return {
-        title: `Stop “${name}”?`,
-        description:
-          'The test ends without a winner and cannot be started again; everybody sees the original. To end it with a winner, use Accept instead.',
-        confirmLabel: 'Stop the test',
-      };
-  }
-};
-
-/** The notification after Accept / Remove. */
-export const actionOutcome = (
-  action: TVersionAction,
-  result: TExperimentActionResult | null | undefined,
-  variant: string
-): string => {
-  const winner =
-    result?.variants?.find((v) => v.key === result.winner)?.name || result?.winner || variant;
-  if (action === 'accept' || result?.auto_accepted)
-    return `The test has ended: every visitor now sees “${winner}”.`;
-  return 'The version is removed; the test goes on with the others.';
-};
-
-/**
- * Why the numbers restarted: the current phase began when a version was removed. Null in the
- * first phase. `actorLabels` names who removed it (`{ 'landing-editor': 'in the editor' }`).
- */
-export const phaseNote = (
-  entry: IExperimentEntry | undefined,
-  actorLabels: Record<string, string> = {}
-): string | null => {
-  const e = entry?.experiment;
-  if (!e || !e.phase || e.phase < 2) return null;
-  const current = e.phases?.find((p) => p.phase === e.phase);
-  const removed = [...(e.history ?? [])].reverse().find((h) => h.action === 'remove-variant');
-  const who = removed?.actor && actorLabels[removed.actor] ? ` ${actorLabels[removed.actor]}` : '';
-  const since =
-    current?.started_at ?
-      new Date(current.started_at).toLocaleDateString('en-GB', {
-        day: 'numeric',
-        month: 'short',
-        timeZone: 'UTC',
-      })
-    : null;
-  const name =
-    removed?.variant ?
-      e.phases?.flatMap((p) => p.variants).find((v) => v.key === removed.variant)?.name
-    : undefined;
-  return `Counting since ${since ?? 'the last change'} (phase ${e.phase}): ${name ? `“${name}”` : 'a version'} was removed${who}.`;
-};
-
-/** The note on an element whose test has ended. */
-export const winnerNote = (entry: IExperimentEntry | undefined, shown: string) =>
-  `Winner live: ${entry ? nameOf(entry, entry.experiment.winner ?? shown) : versionName(shown)} · code clean-up pending`;
-
-// ── how many versions fit ───────────────────────────────────────────────────────
-
-/** Versions visible before the list scrolls: three and a half, so the half row says "there is more". */
-export const VISIBLE_VERSIONS = 3.5;
-
-/**
- * The versions list's height cap (px): 3.5 rows, or less when the card has less room
- * (`available`, what is left after the header, verdict and footer), never under one row.
- * Null when every row fits (no cap, no scrolling).
- */
-export const versionsMaxHeight = ({
-  rows,
-  rowHeight,
-  gap,
-  available = Infinity,
-}: {
-  rows: number;
-  rowHeight: number;
-  gap: number;
-  available?: number;
-}): number | null => {
-  if (rows <= 0 || rowHeight <= 0) return null;
-  const all = rows * rowHeight + (rows - 1) * gap;
-  const threeAndHalf = VISIBLE_VERSIONS * rowHeight + Math.floor(VISIBLE_VERSIONS) * gap;
-  const cap = Math.max(rowHeight, Math.min(threeAndHalf, available));
-  return all <= cap ? null : Math.round(cap);
-};
-
-// ── order and the leader ─────────────────────────────────────────────────────────
-
-/**
- * Best first: conversion on the primary metric, then visitors; versions without numbers keep
- * their order at the end. Stable: equal versions keep the server's order.
- */
-export const sortVersionRows = (rows: IVersionRow[]): IVersionRow[] =>
-  rows
-    .map((row, index) => ({ row, index }))
-    .sort((a, b) => {
-      const ca = a.row.visitors ? (a.row.conversion ?? -1) : -1;
-      const cb = b.row.visitors ? (b.row.conversion ?? -1) : -1;
-      if (cb !== ca) return cb - ca;
-      const va = a.row.visitors ?? -1;
-      const vb = b.row.visitors ?? -1;
-      if (vb !== va) return vb - va;
-      return a.index - b.index;
-    })
-    .map(({ row }) => row);
-
-/**
- * The version to highlight: the winner when the test ended with one or the verdict is a likely
- * winner, otherwise the one converting best so far ("Leading"). Null while nothing is counted,
- * or when the best conversion is shared.
- */
-export const leadingVersion = (
-  entry: IExperimentEntry | undefined,
-  rows: IVersionRow[]
-): { key: string; kind: 'winner' | 'leading' } | null => {
-  const e = entry?.experiment;
-  if (e?.status === 'concluded' && e.winner) return { key: e.winner, kind: 'winner' };
-  if (entry?.results?.verdict === 'likely-winner' && entry.results.winner_variant) {
-    return { key: entry.results.winner_variant, kind: 'winner' };
-  }
-  const counted = rows.filter((r) => r.visitors && r.conversion != null && r.conversion > 0);
-  if (!counted.length) return null;
-  const best = Math.max(...counted.map((r) => r.conversion as number));
-  const top = counted.filter((r) => r.conversion === best);
-  return top.length === 1 ? { key: top[0].key, kind: 'leading' } : null;
-};
-
-// ── the help ─────────────────────────────────────────────────────────────────────
-
-export const DEFAULT_MIN_SAMPLE = { per_variant: 200, days: 7 };
-
-export interface IHelpSection {
-  title: string;
-  paragraphs: string[];
-}
-
-/** What the card's "?" explains, in plain words for a marketer. */
-export const helpSections = (
-  entry: IExperimentEntry | undefined,
-  analyticsLabel = 'the admin portal'
-): IHelpSection[] => {
-  const min = entry?.experiment.min_sample ?? DEFAULT_MIN_SAMPLE;
-  const traffic = entry?.experiment.traffic;
-  const share =
-    traffic != null && traffic < 1 ?
-      `${Math.round(traffic * 100)}% of the visitors who allow analytics`
-    : 'every visitor who allows analytics';
-  return [
-    {
-      title: 'What this is',
-      paragraphs: [
-        'An A/B test shows different versions of this part of the page to different visitors and counts which version gets more of them to do what you want (the goal, for example starting a sign-up).',
-        'The "Original" is what the page showed before the test. The others are the new versions being tried.',
-      ],
-    },
-    {
-      title: 'The buttons',
-      paragraphs: [
-        'Click a version (or press Enter on it) to see it on this page. Only you see it, only in this browser, and it is never counted.',
-        "Show analytics (the chart icon) opens that version's numbers in " +
-          analyticsLabel +
-          '; the link in the footer opens the whole test.',
-        "Accept ends the test with that version as the winner: from then on every visitor sees it, and a developer removes the other versions' code later.",
-        'Remove (the bin icon) drops a version from the test. The counting starts again with the remaining versions, so their numbers restart from zero. When only one version would be left, it becomes the winner.',
-        'Start test begins splitting visitors and counting. Pause shows everyone the original and stops counting until you Resume. Stop ends the test without a winner, for good.',
-        'Every one of these asks you to confirm first.',
-      ],
-    },
-    {
-      title: 'How visitors are split and counted',
-      paragraphs: [
-        `While the test runs, ${share} is put into one version at random and keeps seeing that same version on every visit. Visitors who decline analytics always see the original and are not counted.`,
-        'A visitor is counted for a version once they have actually seen this part of the page. A conversion is counted when that visitor later reaches the goal.',
-      ],
-    },
-    {
-      title: 'Reading the numbers',
-      paragraphs: [
-        'Each version shows its visitors, its conversion (the share of its visitors who reached the goal) and a bar comparing it with the best version. The versions are sorted best first; "Leading" marks the one converting best so far.',
-        '"Chance to beat the original" is how likely that version really converts better than the original, given the numbers so far. 50% means we cannot tell them apart; 95% or more is a likely winner, marked "Winner"; 5% or less means it is likely worse.',
-        'The line at the top is the verdict in plain words: too early, a likely winner, likely worse, or no clear difference.',
-      ],
-    },
-    {
-      title: 'When you can trust the result',
-      paragraphs: [
-        `Early numbers jump around. The verdict stays "too early" until every version has at least ${min.per_variant} visitors and ${min.days} days have passed since the test started; only then is a winner named.`,
-        'If visitors are not split between the versions as set up, the verdict says the numbers cannot be trusted: that points to a tracking problem, not to a better version.',
-        'Removing a version starts a new count (a new phase), so only the numbers since then are shown.',
-      ],
-    },
-    {
-      title: 'Not set up yet?',
-      paragraphs: [
-        "A test can exist in the page's code before anyone registers it in the analytics service. Until it is set up (ask the Designer), you can switch its versions here, but nothing is counted and there are no numbers or controls.",
-        'When the analytics service cannot be reached, the card says so; the page itself works as usual and every visitor sees the original.',
-      ],
-    },
-    {
-      title: 'The full analytics',
-      paragraphs: [
-        `Every test and every version has its own page in ${analyticsLabel}: the numbers over time, the other goals, and how the test changed.`,
-      ],
-    },
-  ];
-};