@qoretechnologies/reqraft 0.10.57-pr.127.ge03fd3a → 0.10.57

package/dist/tracking/ui/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * The A/B test UI: `<ExperimentCard>` (one test, driven by props), `<ExperimentsOverlay>` (every
+ * `<Experiment>` on the page outlined, with its card anchored to it), and the optional
+ * `useExperimentsAdmin` / `createExperimentsAdminClient` for the qorus-api routes. Built on Reqore;
+ * the engine (`../index`) does not import this layer. How to embed it: design/TRACKING.md, §8.
+ */
+export { ExperimentCard } from './ExperimentCard';
+export type { IExperimentCardProps } from './ExperimentCard';
+export { boxOf, ExperimentsOverlay, OVERLAY_ATTRIBUTE } from './ExperimentsOverlay';
+export type { IExperimentsOverlayProps } from './ExperimentsOverlay';
+export { useExperimentsAdmin } from './useExperimentsAdmin';
+export type { IUseExperimentsAdmin, IUseExperimentsAdminOptions } from './useExperimentsAdmin';
+export { createExperimentsAdminClient, ExperimentsAdminError } from './client';
+export type { IExperimentsAdminClient, IExperimentsAdminOptions, TExperimentsFetch, } from './client';
+export { activatesRow, CARD_MAX_WIDTH, CARD_MIN_HEIGHT, cardReducer, CLOSED, openCard, OUTSIDE_IGNORE, placeCard, } from './anchor';
+export type { IBox, ICardState, IPlaceInput, IPlacement, TCardEvent } from './anchor';
+export { actionOutcome, barValues, canAccept, canPause, canRemove, canStart, canStop, confirmCopy, count, DEFAULT_MIN_SAMPLE, helpSections, leadingVersion, NOT_SET_UP_TEXT, sortVersionRows, UNREACHABLE_TEXT, lifecycleCopy, numbersLine, percent, phaseNote, primaryMetric, STATUS_LABEL, statusTag, verdictIntent, verdictLine, versionName, versionRows, versionsMaxHeight, VISIBLE_VERSIONS, winnerNote, } from './card';
+export type { IConfirmCopy, IHelpSection, IVersionRow, TStatusIntent } from './card';
+export type { IAdminExperiment, IAdminExperimentEvent, IAdminExperimentPhase, IAdminVariant, IExperimentEntry, IExperimentResults, INewExperiment, IResultsMetric, IResultsVariant, TExperimentAction, TExperimentActionResult, TExperimentStatus, TLifecycleAction, TVersionAction, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/tracking/ui/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tracking/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACpF,YAAY,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAC/F,OAAO,EAAE,4BAA4B,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAC/E,YAAY,EACV,uBAAuB,EACvB,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,YAAY,EACZ,cAAc,EACd,eAAe,EACf,WAAW,EACX,MAAM,EACN,QAAQ,EACR,cAAc,EACd,SAAS,GACV,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtF,OAAO,EACL,aAAa,EACb,SAAS,EACT,SAAS,EACT,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,OAAO,EACP,WAAW,EACX,KAAK,EACL,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,OAAO,EACP,SAAS,EACT,aAAa,EACb,YAAY,EACZ,SAAS,EACT,aAAa,EACb,WAAW,EACX,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,UAAU,GACX,MAAM,QAAQ,CAAC;AAChB,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACrF,YAAY,EACV,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACrB,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,GACf,MAAM,SAAS,CAAC"}

package/dist/tracking/ui/index.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.winnerNote = exports.VISIBLE_VERSIONS = exports.versionsMaxHeight = exports.versionRows = exports.versionName = exports.verdictLine = exports.verdictIntent = exports.statusTag = exports.STATUS_LABEL = exports.primaryMetric = exports.phaseNote = exports.percent = exports.numbersLine = exports.lifecycleCopy = exports.UNREACHABLE_TEXT = exports.sortVersionRows = exports.NOT_SET_UP_TEXT = exports.leadingVersion = exports.helpSections = exports.DEFAULT_MIN_SAMPLE = exports.count = exports.confirmCopy = exports.canStop = exports.canStart = exports.canRemove = exports.canPause = exports.canAccept = exports.barValues = exports.actionOutcome = exports.placeCard = exports.OUTSIDE_IGNORE = exports.openCard = exports.CLOSED = exports.cardReducer = exports.CARD_MIN_HEIGHT = exports.CARD_MAX_WIDTH = exports.activatesRow = exports.ExperimentsAdminError = exports.createExperimentsAdminClient = exports.useExperimentsAdmin = exports.OVERLAY_ATTRIBUTE = exports.ExperimentsOverlay = exports.boxOf = exports.ExperimentCard = void 0;
+/**
+ * The A/B test UI: `<ExperimentCard>` (one test, driven by props), `<ExperimentsOverlay>` (every
+ * `<Experiment>` on the page outlined, with its card anchored to it), and the optional
+ * `useExperimentsAdmin` / `createExperimentsAdminClient` for the qorus-api routes. Built on Reqore;
+ * the engine (`../index`) does not import this layer. How to embed it: design/TRACKING.md, §8.
+ */
+var ExperimentCard_1 = require("./ExperimentCard");
+Object.defineProperty(exports, "ExperimentCard", { enumerable: true, get: function () { return ExperimentCard_1.ExperimentCard; } });
+var ExperimentsOverlay_1 = require("./ExperimentsOverlay");
+Object.defineProperty(exports, "boxOf", { enumerable: true, get: function () { return ExperimentsOverlay_1.boxOf; } });
+Object.defineProperty(exports, "ExperimentsOverlay", { enumerable: true, get: function () { return ExperimentsOverlay_1.ExperimentsOverlay; } });
+Object.defineProperty(exports, "OVERLAY_ATTRIBUTE", { enumerable: true, get: function () { return ExperimentsOverlay_1.OVERLAY_ATTRIBUTE; } });
+var useExperimentsAdmin_1 = require("./useExperimentsAdmin");
+Object.defineProperty(exports, "useExperimentsAdmin", { enumerable: true, get: function () { return useExperimentsAdmin_1.useExperimentsAdmin; } });
+var client_1 = require("./client");
+Object.defineProperty(exports, "createExperimentsAdminClient", { enumerable: true, get: function () { return client_1.createExperimentsAdminClient; } });
+Object.defineProperty(exports, "ExperimentsAdminError", { enumerable: true, get: function () { return client_1.ExperimentsAdminError; } });
+var anchor_1 = require("./anchor");
+Object.defineProperty(exports, "activatesRow", { enumerable: true, get: function () { return anchor_1.activatesRow; } });
+Object.defineProperty(exports, "CARD_MAX_WIDTH", { enumerable: true, get: function () { return anchor_1.CARD_MAX_WIDTH; } });
+Object.defineProperty(exports, "CARD_MIN_HEIGHT", { enumerable: true, get: function () { return anchor_1.CARD_MIN_HEIGHT; } });
+Object.defineProperty(exports, "cardReducer", { enumerable: true, get: function () { return anchor_1.cardReducer; } });
+Object.defineProperty(exports, "CLOSED", { enumerable: true, get: function () { return anchor_1.CLOSED; } });
+Object.defineProperty(exports, "openCard", { enumerable: true, get: function () { return anchor_1.openCard; } });
+Object.defineProperty(exports, "OUTSIDE_IGNORE", { enumerable: true, get: function () { return anchor_1.OUTSIDE_IGNORE; } });
+Object.defineProperty(exports, "placeCard", { enumerable: true, get: function () { return anchor_1.placeCard; } });
+var card_1 = require("./card");
+Object.defineProperty(exports, "actionOutcome", { enumerable: true, get: function () { return card_1.actionOutcome; } });
+Object.defineProperty(exports, "barValues", { enumerable: true, get: function () { return card_1.barValues; } });
+Object.defineProperty(exports, "canAccept", { enumerable: true, get: function () { return card_1.canAccept; } });
+Object.defineProperty(exports, "canPause", { enumerable: true, get: function () { return card_1.canPause; } });
+Object.defineProperty(exports, "canRemove", { enumerable: true, get: function () { return card_1.canRemove; } });
+Object.defineProperty(exports, "canStart", { enumerable: true, get: function () { return card_1.canStart; } });
+Object.defineProperty(exports, "canStop", { enumerable: true, get: function () { return card_1.canStop; } });
+Object.defineProperty(exports, "confirmCopy", { enumerable: true, get: function () { return card_1.confirmCopy; } });
+Object.defineProperty(exports, "count", { enumerable: true, get: function () { return card_1.count; } });
+Object.defineProperty(exports, "DEFAULT_MIN_SAMPLE", { enumerable: true, get: function () { return card_1.DEFAULT_MIN_SAMPLE; } });
+Object.defineProperty(exports, "helpSections", { enumerable: true, get: function () { return card_1.helpSections; } });
+Object.defineProperty(exports, "leadingVersion", { enumerable: true, get: function () { return card_1.leadingVersion; } });
+Object.defineProperty(exports, "NOT_SET_UP_TEXT", { enumerable: true, get: function () { return card_1.NOT_SET_UP_TEXT; } });
+Object.defineProperty(exports, "sortVersionRows", { enumerable: true, get: function () { return card_1.sortVersionRows; } });
+Object.defineProperty(exports, "UNREACHABLE_TEXT", { enumerable: true, get: function () { return card_1.UNREACHABLE_TEXT; } });
+Object.defineProperty(exports, "lifecycleCopy", { enumerable: true, get: function () { return card_1.lifecycleCopy; } });
+Object.defineProperty(exports, "numbersLine", { enumerable: true, get: function () { return card_1.numbersLine; } });
+Object.defineProperty(exports, "percent", { enumerable: true, get: function () { return card_1.percent; } });
+Object.defineProperty(exports, "phaseNote", { enumerable: true, get: function () { return card_1.phaseNote; } });
+Object.defineProperty(exports, "primaryMetric", { enumerable: true, get: function () { return card_1.primaryMetric; } });
+Object.defineProperty(exports, "STATUS_LABEL", { enumerable: true, get: function () { return card_1.STATUS_LABEL; } });
+Object.defineProperty(exports, "statusTag", { enumerable: true, get: function () { return card_1.statusTag; } });
+Object.defineProperty(exports, "verdictIntent", { enumerable: true, get: function () { return card_1.verdictIntent; } });
+Object.defineProperty(exports, "verdictLine", { enumerable: true, get: function () { return card_1.verdictLine; } });
+Object.defineProperty(exports, "versionName", { enumerable: true, get: function () { return card_1.versionName; } });
+Object.defineProperty(exports, "versionRows", { enumerable: true, get: function () { return card_1.versionRows; } });
+Object.defineProperty(exports, "versionsMaxHeight", { enumerable: true, get: function () { return card_1.versionsMaxHeight; } });
+Object.defineProperty(exports, "VISIBLE_VERSIONS", { enumerable: true, get: function () { return card_1.VISIBLE_VERSIONS; } });
+Object.defineProperty(exports, "winnerNote", { enumerable: true, get: function () { return card_1.winnerNote; } });
+//# sourceMappingURL=index.js.map

package/dist/tracking/ui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tracking/ui/index.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AAEvB,2DAAoF;AAA3E,2GAAA,KAAK,OAAA;AAAE,wHAAA,kBAAkB,OAAA;AAAE,uHAAA,iBAAiB,OAAA;AAErD,6DAA4D;AAAnD,0HAAA,mBAAmB,OAAA;AAE5B,mCAA+E;AAAtE,sHAAA,4BAA4B,OAAA;AAAE,+GAAA,qBAAqB,OAAA;AAM5D,mCASkB;AARhB,sGAAA,YAAY,OAAA;AACZ,wGAAA,cAAc,OAAA;AACd,yGAAA,eAAe,OAAA;AACf,qGAAA,WAAW,OAAA;AACX,gGAAA,MAAM,OAAA;AACN,kGAAA,QAAQ,OAAA;AACR,wGAAA,cAAc,OAAA;AACd,mGAAA,SAAS,OAAA;AAGX,+BA8BgB;AA7Bd,qGAAA,aAAa,OAAA;AACb,iGAAA,SAAS,OAAA;AACT,iGAAA,SAAS,OAAA;AACT,gGAAA,QAAQ,OAAA;AACR,iGAAA,SAAS,OAAA;AACT,gGAAA,QAAQ,OAAA;AACR,+FAAA,OAAO,OAAA;AACP,mGAAA,WAAW,OAAA;AACX,6FAAA,KAAK,OAAA;AACL,0GAAA,kBAAkB,OAAA;AAClB,oGAAA,YAAY,OAAA;AACZ,sGAAA,cAAc,OAAA;AACd,uGAAA,eAAe,OAAA;AACf,uGAAA,eAAe,OAAA;AACf,wGAAA,gBAAgB,OAAA;AAChB,qGAAA,aAAa,OAAA;AACb,mGAAA,WAAW,OAAA;AACX,+FAAA,OAAO,OAAA;AACP,iGAAA,SAAS,OAAA;AACT,qGAAA,aAAa,OAAA;AACb,oGAAA,YAAY,OAAA;AACZ,iGAAA,SAAS,OAAA;AACT,qGAAA,aAAa,OAAA;AACb,mGAAA,WAAW,OAAA;AACX,mGAAA,WAAW,OAAA;AACX,mGAAA,WAAW,OAAA;AACX,yGAAA,iBAAiB,OAAA;AACjB,wGAAA,gBAAgB,OAAA;AAChB,kGAAA,UAAU,OAAA"}

package/dist/tracking/ui/types.d.ts

@@ -0,0 +1,120 @@
+/**
+ * The experiment and results objects of the qorus-api admin and editor routes (§5, §7, §9.5 of
+ * `design/analytics-and-experiments-design.md`), with the fields the A/B test UI reads.
+ * Change the contract there first, then here.
+ */
+export type TExperimentStatus = 'draft' | 'running' | 'paused' | 'stopped' | 'concluded' | 'archived';
+export interface IAdminVariant {
+    key: string;
+    name?: string;
+    weight: number;
+    control?: boolean;
+}
+export interface IAdminExperimentPhase {
+    phase: number;
+    started_at: string;
+    ended_at: string | null;
+    variants: IAdminVariant[];
+}
+export interface IAdminExperimentEvent {
+    at: string;
+    action: string;
+    variant?: string | null;
+    /** Who did it (`admin`, or the product's editor, e.g. `landing-editor`). */
+    actor: string;
+    user?: string;
+}
+/** The admin experiment object. */
+export interface IAdminExperiment {
+    key: string;
+    name?: string;
+    property?: string;
+    status: TExperimentStatus;
+    variants: IAdminVariant[];
+    winner?: string | null;
+    /** The current phase: a removed version starts a new one, and the numbers count from zero. */
+    phase?: number;
+    /** Earlier phases and the current one (last, `ended_at: null` while it runs). */
+    phases?: IAdminExperimentPhase[];
+    /** Every state change, oldest first. */
+    history?: IAdminExperimentEvent[];
+    metrics?: {
+        primary?: string;
+        guardrails?: string[];
+        secondary?: string[];
+    };
+    /** Share of visitors in the test, 0..1. */
+    traffic?: number;
+    /** The too-early gate: every version needs `per_variant` visitors and `days` must pass (default 200, 7). */
+    min_sample?: {
+        per_variant: number;
+        days: number;
+    };
+    started_at?: string | null;
+    ended_at?: string | null;
+}
+export interface IResultsVariant {
+    variant: string;
+    exposed: number;
+    converters: number;
+    rate: number | null;
+    uplift?: number | null;
+    chance_to_beat: number | null;
+}
+export interface IResultsMetric {
+    key: string;
+    name?: string;
+    role: 'primary' | 'guardrail' | 'secondary';
+    verdict?: string;
+    verdict_text?: string;
+    variants: IResultsVariant[];
+    unavailable?: string;
+}
+/** The admin results object. */
+export interface IExperimentResults {
+    verdict?: string;
+    /** The verdict in plain words, written by the server. */
+    verdict_text?: string;
+    winner_variant?: string | null;
+    phase?: number;
+    metrics: IResultsMetric[];
+}
+/** One entry of the editor list: the experiment and its results (null for a draft). */
+export interface IExperimentEntry {
+    experiment: IAdminExperiment;
+    results: IExperimentResults | null;
+}
+/** The experiment an action returns; `auto_accepted` when removing left one version. */
+export type TExperimentActionResult = IAdminExperiment & {
+    auto_accepted?: boolean;
+};
+export type TLifecycleAction = 'start' | 'pause' | 'stop';
+export type TVersionAction = 'accept' | 'remove';
+export type TExperimentAction = TVersionAction | TLifecycleAction;
+/** A new experiment definition (admin shape); the server always creates it as a draft. */
+export interface INewExperiment {
+    key: string;
+    name: string;
+    hypothesis?: string;
+    property?: string;
+    variants: IAdminVariant[];
+    traffic?: number;
+    targeting?: {
+        paths?: string[] | null;
+        device?: string | null;
+        lang?: string | null;
+    };
+    trigger?: {
+        section?: string | null;
+    };
+    metrics: {
+        primary: string;
+        guardrails?: string[];
+        secondary?: string[];
+    };
+    min_sample?: {
+        per_variant: number;
+        days: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/tracking/ui/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tracking/ui/types.ts"],"names":[],"mappings":"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"}

package/dist/tracking/ui/types.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * The experiment and results objects of the qorus-api admin and editor routes (§5, §7, §9.5 of
+ * `design/analytics-and-experiments-design.md`), with the fields the A/B test UI reads.
+ * Change the contract there first, then here.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/tracking/ui/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tracking/ui/types.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/dist/tracking/ui/useExperimentsAdmin.d.ts

@@ -0,0 +1,31 @@
+import { type IExperimentsAdminClient, type IExperimentsAdminOptions } from './client';
+import type { IExperimentEntry, TExperimentActionResult } from './types';
+export interface IUseExperimentsAdminOptions extends IExperimentsAdminOptions {
+    /** Reload the list this often (someone else may accept a test meanwhile). Default 60 s; 0 turns it off. */
+    refreshMs?: number;
+    /** Load nothing while false (e.g. while the overlay is hidden). Default true. */
+    enabled?: boolean;
+}
+export interface IUseExperimentsAdmin {
+    /** The list, or null before the first answer. */
+    tests: IExperimentEntry[] | null;
+    /** The last load's error message, or null. */
+    error: string | null;
+    reload: () => Promise<void>;
+    /** Each action reloads the list when it resolves, and rejects with the server's words. */
+    accept: (key: string, variant: string) => Promise<TExperimentActionResult>;
+    remove: (key: string, variant: string) => Promise<TExperimentActionResult>;
+    start: (key: string) => Promise<unknown>;
+    pause: (key: string) => Promise<unknown>;
+    stop: (key: string) => Promise<unknown>;
+    client: IExperimentsAdminClient;
+}
+/**
+ * The A/B test list and its actions from the qorus-api routes, for `<ExperimentsOverlay>` or
+ * `<ExperimentCard>`. Optional and replaceable: both components take plain data and callbacks.
+ *
+ *   const admin = useExperimentsAdmin({ listUrl: '/qorus-cloud/editor/experiments?property=landing' });
+ *   <ExperimentsOverlay tests={admin.tests} loadError={admin.error} onAccept={admin.accept} … />
+ */
+export declare const useExperimentsAdmin: (options: IUseExperimentsAdminOptions) => IUseExperimentsAdmin;
+//# sourceMappingURL=useExperimentsAdmin.d.ts.map

package/dist/tracking/ui/useExperimentsAdmin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useExperimentsAdmin.d.ts","sourceRoot":"","sources":["../../../src/tracking/ui/useExperimentsAdmin.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC9B,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAoB,MAAM,SAAS,CAAC;AAE3F,MAAM,WAAW,2BAA4B,SAAQ,wBAAwB;IAC3E,2GAA2G;IAC3G,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,iDAAiD;IACjD,KAAK,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC;IACjC,8CAA8C;IAC9C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,0FAA0F;IAC1F,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAC3E,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAC3E,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACzC,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,EAAE,uBAAuB,CAAC;CACjC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,YAAa,2BAA2B,KAAG,oBAiE1E,CAAC"}

package/dist/tracking/ui/useExperimentsAdmin.js

@@ -0,0 +1,136 @@
+"use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useExperimentsAdmin = void 0;
+var react_1 = require("react");
+var client_1 = require("./client");
+/**
+ * The A/B test list and its actions from the qorus-api routes, for `<ExperimentsOverlay>` or
+ * `<ExperimentCard>`. Optional and replaceable: both components take plain data and callbacks.
+ *
+ *   const admin = useExperimentsAdmin({ listUrl: '/qorus-cloud/editor/experiments?property=landing' });
+ *   <ExperimentsOverlay tests={admin.tests} loadError={admin.error} onAccept={admin.accept} … />
+ */
+var useExperimentsAdmin = function (options) {
+    var _a;
+    var _b = options.refreshMs, refreshMs = _b === void 0 ? 60000 : _b, _c = options.enabled, enabled = _c === void 0 ? true : _c;
+    // The options object is usually a fresh literal: the client follows its values, not its identity.
+    var latest = (0, react_1.useRef)(options);
+    latest.current = options;
+    var headersKey = JSON.stringify((_a = options.headers) !== null && _a !== void 0 ? _a : {});
+    var client = (0, react_1.useMemo)(function () {
+        return (0, client_1.createExperimentsAdminClient)(__assign(__assign({}, latest.current), { fetch: function (input, init) { var _a; return ((_a = latest.current.fetch) !== null && _a !== void 0 ? _a : fetch)(input, init); } }));
+    }, [options.listUrl, options.createUrl, options.credentials, headersKey]);
+    var _d = (0, react_1.useState)(null), tests = _d[0], setTests = _d[1];
+    var _e = (0, react_1.useState)(null), error = _e[0], setError = _e[1];
+    var alive = (0, react_1.useRef)(true);
+    var reload = (0, react_1.useCallback)(function () { return __awaiter(void 0, void 0, void 0, function () {
+        var list, err_1;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    _a.trys.push([0, 2, , 3]);
+                    return [4 /*yield*/, client.list()];
+                case 1:
+                    list = _a.sent();
+                    if (!alive.current)
+                        return [2 /*return*/];
+                    setTests(list);
+                    setError(null);
+                    return [3 /*break*/, 3];
+                case 2:
+                    err_1 = _a.sent();
+                    if (alive.current)
+                        setError(err_1.message);
+                    return [3 /*break*/, 3];
+                case 3: return [2 /*return*/];
+            }
+        });
+    }); }, [client]);
+    (0, react_1.useEffect)(function () {
+        alive.current = true;
+        if (!enabled)
+            return function () { return undefined; };
+        void reload();
+        var id = refreshMs > 0 ? setInterval(function () { return void reload(); }, refreshMs) : null;
+        return function () {
+            alive.current = false;
+            if (id)
+                clearInterval(id);
+        };
+    }, [reload, enabled, refreshMs]);
+    var then = (0, react_1.useCallback)(function (promise) { return __awaiter(void 0, void 0, void 0, function () {
+        var result;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, promise];
+                case 1:
+                    result = _a.sent();
+                    return [4 /*yield*/, reload()];
+                case 2:
+                    _a.sent();
+                    return [2 /*return*/, result];
+            }
+        });
+    }); }, [reload]);
+    var lifecycle = (0, react_1.useCallback)(function (key, action) { return then(client.lifecycle(key, action)); }, [client, then]);
+    return {
+        tests: tests,
+        error: error,
+        reload: reload,
+        accept: (0, react_1.useCallback)(function (key, variant) { return then(client.accept(key, variant)); }, [client, then]),
+        remove: (0, react_1.useCallback)(function (key, variant) { return then(client.remove(key, variant)); }, [client, then]),
+        start: (0, react_1.useCallback)(function (key) { return lifecycle(key, 'start'); }, [lifecycle]),
+        pause: (0, react_1.useCallback)(function (key) { return lifecycle(key, 'pause'); }, [lifecycle]),
+        stop: (0, react_1.useCallback)(function (key) { return lifecycle(key, 'stop'); }, [lifecycle]),
+        client: client,
+    };
+};
+exports.useExperimentsAdmin = useExperimentsAdmin;
+//# sourceMappingURL=useExperimentsAdmin.js.map

package/dist/tracking/ui/useExperimentsAdmin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useExperimentsAdmin.js","sourceRoot":"","sources":["../../../src/tracking/ui/useExperimentsAdmin.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qoretechnologies/reqraft",
-  "version": "0.10.57-pr.127.ge03fd3a",
+  "version": "0.10.57",
   "description": "ReQraft is a collection of React components and hooks that are used across Qore Technologies' products made using the ReQore component library from Qore.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -56,8 +56,8 @@
   "devDependencies": {
     "@chromatic-com/storybook": "^5.2.1",
     "@netsells/storybook-mockdate": "^0.3.3",
-    "@qoretechnologies/qlip": "^0.1.3-beta.20260908110821",
-    "@qoretechnologies/reqore": "^0.76.2",
+    "@qoretechnologies/qlip": "^0.1.3-beta.20260929120101",
+    "@qoretechnologies/reqore": "^0.77.2",
     "@storybook/addon-docs": "^10.4.6",
     "@storybook/addon-links": "^10.4.6",
     "@storybook/addon-vitest": "^10.4.6",

package/src/index.tsx

@@ -78,5 +78,7 @@ export * from './components/ticketReferences';
 export * from './components/searchFilterBar';
 export * from './components/codeSize';
 // First-party tracking, consent and A/B testing (design/TRACKING.md). Also importable
-// on its own, without the rest of Reqraft: `@qoretechnologies/reqraft/dist/tracking`.
+// on its own, without the rest of Reqraft: `@qoretechnologies/reqraft/dist/tracking`
+// (the engine, React only) and `@qoretechnologies/reqraft/dist/tracking/ui` (the A/B test UI).
 export * from './tracking';
+export * from './tracking/ui';

package/src/stories/tracking.tsx

@@ -0,0 +1,206 @@
+/**
+ * Story helpers for the A/B test UI: fixtures in the qorus-api shape, and the dark / light /
+ * phone variants every visual story ships in.
+ */
+import { ReqoreContent, ReqoreUIProvider } from '@qoretechnologies/reqore';
+import type { ReactNode } from 'react';
+import type { IAdminVariant, IExperimentEntry, IExperimentResults } from '../tracking/ui/types';
+
+export const PHONE_VIEWPORT = { width: 390, height: 844 };
+
+/** The page a light-mode product uses: Reqore derives every surface from this `main`. */
+export const LIGHT_MAIN = '#f6f6f6';
+
+/** Wraps a story in a light Reqore theme (the preview's own theme is dark). */
+export const LightTheme = ({ children }: { children: ReactNode }) => (
+  <ReqoreUIProvider
+    theme={{ main: LIGHT_MAIN }}
+    options={{ animations: { buttons: false, dialogs: false } }}
+  >
+    <ReqoreContent style={{ padding: 20, minHeight: '100vh' }}>{children}</ReqoreContent>
+  </ReqoreUIProvider>
+);
+
+type TVariant = 'Dark' | 'Light' | 'Phone';
+
+/**
+ * A story in one of the three variants: the description gets the variant's words, Light wraps
+ * the story in a light theme, Phone captures at 390 px.
+ */
+export const variant = <S extends object>(story: S, description: string, mode: TVariant): S => {
+  const base = story as S & { parameters?: Record<string, any>; decorators?: any };
+  const light = (Story: () => JSX.Element) => (
+    <LightTheme>
+      <Story />
+    </LightTheme>
+  );
+  return {
+    ...story,
+    decorators: [...((base.decorators as any[]) ?? []), ...(mode === 'Light' ? [light] : [])],
+    parameters: {
+      ...base.parameters,
+      ...(mode === 'Phone' ? { qlip: { viewport: PHONE_VIEWPORT } } : {}),
+      docs: {
+        description: {
+          story:
+            mode === 'Dark' ? description
+            : mode === 'Light' ? `${description} On a light theme.`
+            : `${description} At phone width (390 px).`,
+        },
+      },
+    },
+  };
+};
+
+const v = (key: string, name: string, weight: number, control = false): IAdminVariant => ({
+  key,
+  name,
+  weight,
+  ...(control ? { control } : {}),
+});
+
+const results = (
+  numbers: [string, number, number, number | null][],
+  patch: Partial<IExperimentResults> = {}
+): IExperimentResults => ({
+  verdict: 'too-early',
+  metrics: [
+    {
+      key: 'signup-started',
+      name: 'Started a sign-up',
+      role: 'primary',
+      variants: numbers.map(([variant, exposed, converters, chance]) => ({
+        variant,
+        exposed,
+        converters,
+        rate: exposed ? converters / exposed : null,
+        chance_to_beat: chance,
+      })),
+    },
+  ],
+  ...patch,
+});
+
+export const EXPERIMENT_KEY = 'signup-cta';
+
+const TWO = [v('a', 'Current button', 0.5, true), v('b', 'Short copy', 0.5)];
+
+export const DRAFT: IExperimentEntry = {
+  experiment: {
+    key: EXPERIMENT_KEY,
+    name: 'Sign-up button copy',
+    status: 'draft',
+    phase: 1,
+    variants: TWO,
+  },
+  results: null,
+};
+
+export const RUNNING_TWO: IExperimentEntry = {
+  experiment: {
+    key: EXPERIMENT_KEY,
+    name: 'Sign-up button copy',
+    status: 'running',
+    phase: 1,
+    variants: TWO,
+  },
+  results: results(
+    [
+      ['a', 1240, 112, null],
+      ['b', 1228, 139, 0.91],
+    ],
+    {
+      verdict: 'likely-winner',
+      winner_variant: 'b',
+      verdict_text:
+        'Short copy is likely better: 91% chance it beats Current button on “Started a sign-up”.',
+    }
+  ),
+};
+
+export const RUNNING_FIVE: IExperimentEntry = {
+  experiment: {
+    key: EXPERIMENT_KEY,
+    name: 'Pricing page headline',
+    status: 'running',
+    phase: 1,
+    variants: [
+      v('a', 'Current headline', 0.2, true),
+      v('b', 'Price first', 0.2),
+      v('c', 'Customer quote', 0.2),
+      v('d', 'Question', 0.2),
+      v('e', 'Numbers', 0.2),
+    ],
+  },
+  results: results([
+    ['a', 604, 41, null],
+    ['b', 598, 47, 0.72],
+    ['c', 611, 38, 0.36],
+    ['d', 590, 44, 0.61],
+    ['e', 602, 30, 0.12],
+  ]),
+};
+
+export const PAUSED: IExperimentEntry = {
+  experiment: {
+    key: EXPERIMENT_KEY,
+    name: 'Sign-up button copy',
+    status: 'paused',
+    phase: 2,
+    variants: TWO,
+    phases: [
+      {
+        phase: 1,
+        started_at: '2026-09-10T08:00:00Z',
+        ended_at: '2026-09-20T10:00:00Z',
+        variants: [...TWO, v('c', 'Emoji', 0.33)],
+      },
+      { phase: 2, started_at: '2026-09-20T10:00:00Z', ended_at: null, variants: TWO },
+    ],
+    history: [
+      { at: '2026-09-20T10:00:00Z', action: 'remove-variant', variant: 'c', actor: 'admin' },
+    ],
+  },
+  results: results(
+    [
+      ['a', 380, 31, null],
+      ['b', 371, 33, 0.64],
+    ],
+    { verdict: 'no-clear-difference' }
+  ),
+};
+
+export const CONCLUDED: IExperimentEntry = {
+  experiment: {
+    key: EXPERIMENT_KEY,
+    name: 'Sign-up button copy',
+    status: 'concluded',
+    phase: 1,
+    winner: 'b',
+    variants: TWO,
+  },
+  results: RUNNING_TWO.results,
+};
+
+export const NO_DATA_YET: IExperimentEntry = {
+  experiment: {
+    key: EXPERIMENT_KEY,
+    name: 'Sign-up button copy',
+    status: 'running',
+    phase: 1,
+    variants: TWO,
+  },
+  results: results([
+    ['a', 0, 0, null],
+    ['b', 0, 0, null],
+  ]),
+};
+
+/** Runs the story as a test but takes no Qlip snapshot (a visually empty state). */
+export const noSnapshot = <S extends object>(story: S): S => {
+  const base = story as S & { parameters?: Record<string, any> };
+  return {
+    ...story,
+    parameters: { ...base.parameters, qlip: { ...base.parameters?.qlip, skip: true } },
+  };
+};