@picked/client 0.0.74-next.1 → 0.0.75-next.1

package/dist/docs/reference/dashboard/features.mdx

@@ -21,6 +21,19 @@ Each feature flag has a unique key. Your application uses this key to check whet
 Picked allocates a visitor to the feature flag. You set the key when you create the
 feature flag, and you cannot change it later.
 
+## Types
+
+Each feature flag has a type. You set the type when you create the feature flag, and you
+cannot change it later.
+
+| Type | What your site receives | Groups |
+| --- | --- | --- |
+| **Boolean** | `true` or `false` | Two |
+| **Text** | A string that you write, or `false` for the control group | Two or more |
+
+Choose **Boolean** for one change against no change. Choose **Text** when you must test
+several changes at the same time, and each change needs its own group.
+
 ## Set the allocation
 
 Set the allocation from the detail page of the feature flag:
@@ -28,19 +41,46 @@ Set the allocation from the detail page of the feature flag:
 | Control | What it does |
 | --- | --- |
 | **Enabled** | Whether Picked allocates a visitor to the feature flag. A disabled feature flag allocates nobody, and it records nothing. See [Disable a feature flag](#disable-a-feature-flag). |
-| **Weight** | The percentage of visitors that Picked allocates to the feature flag, from 0 to 100. |
+| **Weight** | The percentage of visitors that Picked allocates to a Boolean feature flag, from 0 to 100. |
+| **Variants** | The groups of a Text feature flag, and the traffic that each one receives. See [Variants](#variants). |
 | **Description** | An internal note about what the feature flag tests. |
 
-A feature flag has one weight. For each visitor it gives one of two outcomes:
+A Boolean feature flag has one weight. For each visitor it gives one of two outcomes:
 allocated, or not allocated. A weight of 30 allocates 30% of your visitors. The other
 70% stay unallocated. A weight of 0 allocates nobody. A weight of 100 allocates
 everybody.
 
+## Variants
+
+A Text feature flag has a table of variants. Each row is one group of visitors:
+
+| Column | What it does |
+| --- | --- |
+| **Name** | A label for the variant. It appears in your reports. You can change it at any time. |
+| **Value** | The string that your site receives for a visitor in this variant. |
+| **Weight** | The share of traffic for this variant, against the other rows. |
+
+The first row is **Control**. Picked always sends `false` to a visitor in the control
+group, and you cannot remove the row, move it, or change its value. It takes a weight like
+any other row.
+
+The weights are shares, and not percentages. Picked reduces them to their smallest whole
+numbers, so `10 : 10 : 20` and `1 : 1 : 2` are the same split. The percentage beside each
+row shows the traffic that the variant receives.
+
+Choose **Even split** to give every variant the same weight.
+
+:::info
+The order of the rows is the order that you read them in. It has no effect on the
+allocation, so you can move a row and no visitor changes group.
+:::
+
 ## How Picked allocates a visitor
 
-The allocation is deterministic. It derives from the visitor ID, the ID of the feature
-flag, and the weight. Each feature flag gets its own value, so tests that run at the
-same time are independent. See
+The allocation is deterministic. It derives from the visitor ID and from the ID of the
+feature flag. A Boolean feature flag then compares that value against the weight, and a
+Text feature flag compares it against the range of each variant. Each feature flag gets its
+own value, so tests that run at the same time are independent. See
 [About feature flag allocation](/explanation/feature-flag-allocation).
 
 ## Disable a feature flag

package/dist/docs/reference/delivery-api/workspace-schema.md

@@ -28,6 +28,7 @@ The response is a [JSON Schema draft 2020-12](https://json-schema.org/draft/2020
 | `x-picked-source` | `"published"` or `"preview"` — mirrors the surface you requested. |
 | `x-picked-version-id` | Published workspace version id, or `null` on preview. |
 | `x-picked-step-content-models` | Map of step key → content model key, which gives each layout its type. |
+| `x-picked-feature-values` | Map of feature key → the values that the feature can serve. Picked adds this field only when the workspace has a Text feature flag. |
 | `$defs.contentModels` | JSON Schema definitions for each content model. |
 | `$defs.contentBlocks` | JSON Schema definitions for reusable content blocks. |
 | `$defs.fields` | Object schema for project field values. |
@@ -41,6 +42,13 @@ On the published surface, the schema reflects your last published workspace. On
 
 When no published schema exists, the published endpoint returns `404` and tells you to publish the workspace.
 
+A Boolean feature flag serves `true` or `false`, and it contributes no entry to
+`x-picked-feature-values`. A workspace of Boolean feature flags therefore omits the field.
+A schema that Picked published before Text feature flags existed also omits it.
+
+Picked sorts the values of each Text feature flag by the key of the variant. The document
+therefore does not change when you rename a variant or move a row.
+
 ## Example
 
 ```bash
@@ -57,11 +65,14 @@ curl https://api.picked.app/api/v1/projects/proj_123/schema
   "x-picked-step-content-models": {
     "intro": "welcome-page"
   },
+  "x-picked-feature-values": {
+    "hero": [false, "hero-a", "hero-b"]
+  },
   "$defs": {
     "contentModels": {},
     "contentBlocks": {},
     "fields": { "type": "object", "additionalProperties": false, "properties": {} },
-    "featureKeys": { "type": "string", "enum": ["default"] },
+    "featureKeys": { "type": "string", "enum": ["default", "hero"] },
     "experienceKeys": { "type": "string", "enum": ["welcome-survey"] },
     "stepKeys": { "type": "string", "enum": ["intro"] }
   }

package/dist/docs/reference/pickedql/dimensions.md

@@ -22,6 +22,12 @@ point at one. You write no join.
 | `experiences` | `experience_title` |
 | `projects` | `project_name`, `project_timezone` |
 
+:::warning
+`dim_variant` describes whether the visitor is a known user. It does **not** hold the variants
+of your feature flags. To count the visitors in one variant, use
+[`feature_users`](/reference/pickedql/virtual-functions#feature-functions-on-features-and-on-events).
+:::
+
 The `steps`, `experiences`, and `projects` sources are reference tables, and they come
 from the operational database. PickedQL joins them onto `events` and `fact_events`
 when you point at one of their analyst-facing columns. Each one **also** needs its own

package/dist/docs/reference/pickedql/virtual-functions.md

@@ -213,15 +213,26 @@ Parameterized functions that accept the feature name, bucket, and an optional fe
 | `feature_sessions('name', 'bucket' [, 'key'])` | Unique sessions in a feature bucket |
 | `feature_events('name', 'bucket' [, 'key'])` | Unique events in a feature bucket |
 
+The bucket is what the SDK sent to the site of the visitor. A Boolean feature flag gives
+`'true'` or `'false'`. A Text feature flag gives the value of one variant, or `'false'` for
+the control group. The key is the version of the feature flag, such as `'v1'`.
+
 ```sql
--- Compare feature buckets
+-- Compare the two buckets of a Boolean feature flag.
+SELECT
+  feature_users('homepage_test', 'false') AS control,
+  feature_users('homepage_test', 'true') AS variant
+FROM features
+
+-- Compare the variants of a Text feature flag.
 SELECT
-  feature_users('homepage_test', 'control') AS control,
-  feature_users('homepage_test', 'variant') AS variant
+  feature_users('hero', 'false') AS control,
+  feature_users('hero', 'hero-a') AS hero_a,
+  feature_users('hero', 'hero-b') AS hero_b
 FROM features
 
--- With feature key filter
-SELECT feature_users('homepage_test', 'control', 'v1') FROM features
+-- Count one version of the feature flag alone.
+SELECT feature_users('homepage_test', 'false', 'v1') FROM features
 ```
 
 ## Other (`metrics` only)

package/dist/docs/reference/sdk/features.md

@@ -26,12 +26,22 @@ For a feature flag that you control from the dashboard, the SDK makes the defini
 | `enabled` | The dashboard **Enabled** toggle |
 | `weight` | The dashboard **Weight**, 0 to 100 |
 | `storage` | `local`, or `session` in [preview mode](/explanation/feature-flag-allocation#preview-mode) |
-| `decide` | Made by the SDK. It compares the stable value of the visitor for this feature flag against `weight`. |
+| `decide` | Made by the SDK. See the two routes below. |
 
-The `decide` function that the SDK makes derives from the visitor ID, the ID of the
-feature flag, and the weight. A feature flag that you control from the dashboard
-therefore cannot use the data of your application. Define the feature flag in SDK code
-when you need that.
+The `decide` function that the SDK makes derives from the visitor ID and from the ID of
+the feature flag. A feature flag that you control from the dashboard therefore cannot use
+the data of your application. Define the feature flag in SDK code when you need that.
+
+Which route `decide` takes depends on the type of the feature flag:
+
+| Dashboard type | The bucket | How the SDK decides |
+| --- | --- | --- |
+| Boolean | `true` or `false` | It compares the stable value of the visitor against `weight`. |
+| Text | The value of one variant, or `false` | It compares the stable value of the visitor against the range that Picked gives to each variant. |
+
+The SDK sorts the variants by their key before it allocates, so the order of the payload
+has no effect. See
+[More than two groups](/explanation/feature-flag-allocation#more-than-two-groups).
 
 ## Define a feature flag in SDK code
 
@@ -95,7 +105,8 @@ You can give more than one override value:
 https://example.com?picked-feature=my-feature:true&picked-feature=homepage-variant:variant-a
 ```
 
-The format is `?picked-feature=<feature-id>:<bucket-value>`.
+The format is `?picked-feature=<feature-id>:<bucket-value>`. For a Text feature flag,
+give the value that the variant serves.
 
 This is useful for QA, because you can test one bucket value and change no code. The
 SDK keeps the override value in session storage. The browser clears it when you close

package/dist/docs/reference/sdk/type-generation.md

@@ -124,7 +124,7 @@ The generated `picked-env.d.ts` file looks like:
 
 export interface WelcomePage { /* ... */ }
 export interface FieldValues { /* ... */ }
-export type FeatureKey = 'default' | 'winter-sale'
+export type FeatureKey = 'default' | 'hero' | 'winter-sale'
 
 declare module '@picked/client' {
   interface PickedSchemaRegistry {
@@ -132,12 +132,28 @@ declare module '@picked/client' {
     stepContentModels: { intro: 'welcome-page' }
     fieldValues: FieldValues
     featureKeys: FeatureKey
+    featureValues: { hero: false | 'hero-a' | 'hero-b' }
   }
 }
 ```
 
 Commit this file to the version control system, or regenerate it in CI after you publish a workspace change.
 
+### Feature flag values
+
+A Text feature flag declares the values that it can serve, so `useFeatureResult` narrows
+the bucket to those values:
+
+```typescript
+const result = useFeatureResult('hero')
+```
+
+The `bucket` property then has the type `false | 'hero-a' | 'hero-b'`.
+
+`featureValues` holds the Text feature flags alone. A Boolean feature flag, and a feature
+flag that your application defines, both keep the general `boolean | string` type. The
+`FeatureValueFor<'hero'>` type gives the same union on its own.
+
 ## Keys the application defines
 
 An application can define a feature, an action, a field, a step, or an experience of its

package/dist/esm/index.js

@@ -6,7 +6,7 @@ import { a as _, i as v, r as ee, s as y, t as b } from "../dom-BqcToNL0.js";
 import { l as x, n as S, r as C, u as w } from "../experience-instance-DGk11d8a.js";
 import { i as T, n as E, r as D, t as O } from "../storage-1MW3-_As.js";
 import { t as te } from "../id-Bo4RBeOs.js";
-import { t as ne } from "../version-D6O3knkR.js";
+import { t as ne } from "../version-BsVuRkHH.js";
 import { n as re, r as ie, t as ae } from "../inert-script-report-B_bMPRzp.js";
 import { attach as k, combine as A, createApi as j, createDomain as M, createEffect as N, createEvent as P, createStore as F, is as oe, sample as I } from "effector";
 import { createFactory as L, invoke as R } from "@withease/factories";
@@ -1774,7 +1774,7 @@ var Kt = class {
 	dataProviderFor(e) {
 		let t = e ?? "", n = this.dataProviders.get(t);
 		if (n) return n;
-		let r = import("../provider-BlW0FUxy.js").then((t) => t.createPickedDataProvider({
+		let r = import("../provider-Da1D5BIA.js").then((t) => t.createPickedDataProvider({
 			apiUrl: this.apiUrl,
 			projectId: this.projectId,
 			...e !== void 0 && { previewToken: e }

package/dist/esm/plugins/dynamic-experiences/index.js

@@ -1,5 +1,5 @@
-import { t as e } from "../../../plugin-Q121SckS.js";
-import { n as t, t as n } from "../../../api-DSSAUkRz.js";
+import { t as e } from "../../../plugin-BNLWb4FA.js";
+import { n as t, t as n } from "../../../api-ITpKqiED.js";
 import { n as r } from "../../../registry-CXZv0uLg.js";
 import { createClientHeaders as i, fetchSchema as a } from "@picked/delivery-api-client";
 export { i as createClientHeaders, e as dynamicExperiencesPlugin, n as fetchExperienceContent, t as fetchProject, a as fetchSchema, r as registerPickedBundle };

package/dist/esm/server/index.js

@@ -1,5 +1,5 @@
 import { a as e, c as t, i as n, o as r, s as i, t as a, u as o } from "../../experience-instance-DGk11d8a.js";
-import { n as s } from "../../plugin-Q121SckS.js";
+import { n as s } from "../../plugin-BNLWb4FA.js";
 import { attach as c, createEffect as l, createEvent as u, createStore as d, sample as f } from "effector";
 //#region src/server/serialize.ts
 var p = 1e4;

package/dist/{plugin-Q121SckS.js → plugin-BNLWb4FA.js}

@@ -1,5 +1,5 @@
 import "./logger-DMN6TxJJ.js";
-import "./api-DSSAUkRz.js";
+import "./api-ITpKqiED.js";
 import { attach as e } from "effector";
 //#region src/plugins/dynamic-experiences/hash.ts
 function t(e) {
@@ -17,12 +17,27 @@ function r(e, r) {
 function i(e, t) {
 	return t <= 0 ? !1 : t >= 100 || e < t;
 }
+var a = 4294967296;
+function o(e, r, i) {
+	return (n(t(`${e}:${r}:${i}`)) + .5) / a;
+}
+function s(e, t, n) {
+	return n.weight <= 0 ? 0 : n.weight / -Math.log(o(e, t, n.key));
+}
+function c(e, t, n) {
+	let r = null, i = 0;
+	for (let a of n) {
+		let n = s(e, t, a);
+		n <= 0 || (n > i || n === i && r !== null && a.key < r.key) && (i = n, r = a);
+	}
+	return r;
+}
 //#endregion
 //#region src/plugins/dynamic-experiences/plugin.ts
-function a(e, t) {
+function l(e, t) {
 	if (Array.isArray(t.conditions)) for (let n of t.conditions) e.registerCondition(n);
 }
-function o(e, t) {
+function u(e, t) {
 	e.registerExperience({
 		id: t.id,
 		key: t.key,
@@ -35,13 +50,13 @@ function o(e, t) {
 		componentName: t.componentName
 	});
 }
-function s(e) {
+function d(e) {
 	return typeof e != "object" || !e ? !1 : "id" in e && "key" in e && "type" in e && "name" in e;
 }
-function c(e, t) {
-	if (Array.isArray(t.fields)) for (let n of t.fields) s(n) && e.registerField(n);
+function f(e, t) {
+	if (Array.isArray(t.fields)) for (let n of t.fields) d(n) && e.registerField(n);
 }
-function l(e, t) {
+function p(e, t) {
 	if (!Array.isArray(t.steps)) return;
 	let n = new Map(t.fields.map((e) => [e.id, e.key]));
 	for (let r of t.steps) {
@@ -68,17 +83,17 @@ function l(e, t) {
 		});
 	}
 }
-function u(e, t) {
-	if (Array.isArray(t.experiences)) for (let n of t.experiences) o(e, n);
+function m(e, t) {
+	if (Array.isArray(t.experiences)) for (let n of t.experiences) u(e, n);
 }
-function d(e, t, n) {
-	m(e, t, n.isPreview, n.sessionId), a(e, t), c(e, t), l(e, t), u(e, t);
+function h(e, t, n) {
+	v(e, t, n.isPreview, n.sessionId), l(e, t), f(e, t), p(e, t), m(e, t);
 }
-function f(e) {
+function g(e) {
 	let t = e.searchParams["preview-token"];
 	if (t && t.length > 0) return t[0];
 }
-function p(e) {
+function _(e) {
 	let t = /* @__PURE__ */ new Set(), n = e.searchParams.feature;
 	if (!n) return t;
 	for (let e of n) {
@@ -87,29 +102,29 @@ function p(e) {
 	}
 	return t;
 }
-function m(e, t, n, r) {
-	let i = p(e);
-	for (let a of t.features) i.has(a.id) || h(e, a, n, r);
+function v(e, t, n, r) {
+	let i = _(e);
+	for (let a of t.features) i.has(a.id) || y(e, a, n, r);
 }
-function h(e, t, n, a) {
-	let o = r(a, t.id);
-	e.registerFeature(t.id, {
+function y(e, t, n, a) {
+	let o = t.id, s = t.variants;
+	e.registerFeature(o, {
 		key: `v${t.version}`,
 		name: t.name,
 		enabled: t.enabled,
 		weight: t.weight,
 		storage: n ? "session" : "local",
-		decide: () => i(o, t.weight)
+		decide: () => t.valueType === "text" ? !s || s.length === 0 ? (`${o}`, !1) : c(a, o, s)?.value ?? !1 : i(r(a, o), t.weight)
 	});
 }
-function g(e, t) {
+function b(e, t) {
 	for (let n of [...t.references ?? [], ...t.content]) e.registerContent({
 		id: n.id,
 		contentModelKey: n.contentModelKey,
 		data: n.data
 	});
 }
-function _(e, t) {
+function x(e, t) {
 	let n = /* @__PURE__ */ new Map();
 	return (r, i) => {
 		let a = n.get(r.id);
@@ -117,7 +132,7 @@ function _(e, t) {
 		let o = (async () => {
 			try {
 				let n = await t(r, i);
-				return n && g(e, n), n;
+				return n && b(e, n), n;
 			} finally {
 				n.delete(r.id);
 			}
@@ -125,18 +140,18 @@ function _(e, t) {
 		return n.set(r.id, o), o;
 	};
 }
-function v(e, t) {
+function S(e, t) {
 	let n = new Set(t && Array.isArray(t.experiences) ? t.experiences.map((e) => e.id) : []);
 	return (t, r) => n.has(t.id) ? e(t, r) : Promise.resolve(null);
 }
-function y() {
+function C() {
 	return {
 		name: "dynamic-experiences",
 		setup: (t) => ({ onStart: e({
 			source: t.session.store.map((e) => e.id),
 			effect: async (e) => {
-				let n = f(t), r = n !== void 0, i = n === void 0 ? void 0 : { previewToken: n }, a = await t.getProjectConfig(n === void 0 ? void 0 : { previewToken: n }).catch((e) => null);
-				if (t.contentLoader = _(t, v((e) => t.getExperienceContent(e, i), a)), !a) return;
+				let n = g(t), r = n !== void 0, i = n === void 0 ? void 0 : { previewToken: n }, a = await t.getProjectConfig(n === void 0 ? void 0 : { previewToken: n }).catch((e) => null);
+				if (t.contentLoader = x(t, S((e) => t.getExperienceContent(e, i), a)), !a) return;
 				let o = t.seededVersionId;
 				if (o !== null && o !== a.versionId) {
 					t.versionSkew = {
@@ -145,7 +160,7 @@ function y() {
 					}, `${a.versionId}${o}`;
 					return;
 				}
-				t.previewEmbedderOrigins = a.previewEmbedderOrigins ?? null, d(t, a, {
+				t.previewEmbedderOrigins = a.previewEmbedderOrigins ?? null, h(t, a, {
 					isPreview: r,
 					sessionId: e
 				});
@@ -154,4 +169,4 @@ function y() {
 	};
 }
 //#endregion
-export { d as n, y as t };
+export { h as n, C as t };

package/dist/plugin-xFCAKJuO.cjs

@@ -0,0 +1 @@
+require("./logger-CSTvAyyB.cjs"),require("./api-CUlZaK-b.cjs");let e=require("effector");function t(e){let t=2166136261;for(let n of e)t^=n.codePointAt(0)??0,t=Math.imul(t,16777619);return t>>>0}function n(e){let t=e;return t^=t>>>16,t=Math.imul(t,2246822507),t^=t>>>13,t=Math.imul(t,3266489909),t^=t>>>16,t>>>0}function r(e,r){return n(t(`${e}:${r}`))%100}function i(e,t){return t<=0?!1:t>=100||e<t}var a=4294967296;function o(e,r,i){return(n(t(`${e}:${r}:${i}`))+.5)/a}function s(e,t,n){return n.weight<=0?0:n.weight/-Math.log(o(e,t,n.key))}function c(e,t,n){let r=null,i=0;for(let a of n){let n=s(e,t,a);n<=0||(n>i||n===i&&r!==null&&a.key<r.key)&&(i=n,r=a)}return r}function l(e,t){if(Array.isArray(t.conditions))for(let n of t.conditions)e.registerCondition(n)}function u(e,t){e.registerExperience({id:t.id,key:t.key,name:t.name,targets:t.targets,nodes:t.nodes,edges:t.edges,condition:t.condition,initializeOpen:t.initializeOpen,componentName:t.componentName})}function d(e){return typeof e!=`object`||!e?!1:`id`in e&&`key`in e&&`type`in e&&`name`in e}function f(e,t){if(Array.isArray(t.fields))for(let n of t.fields)d(n)&&e.registerField(n)}function p(e,t){if(!Array.isArray(t.steps))return;let n=new Map(t.fields.map(e=>[e.id,e.key]));for(let r of t.steps){let t=[];for(let e of r.fieldIds??[]){let i=n.get(e);if(i===void 0){`${r.key}${e}`;continue}t.push(i)}let i=r.layoutContentId?e.contents.getById(r.layoutContentId):null;e.registerStep({id:r.id,key:r.key,name:r.name,fieldKeys:t,layoutName:r.layoutName,...r.layoutContentId!==void 0&&{layoutContentId:r.layoutContentId,layoutContentStore:i}})}}function m(e,t){if(Array.isArray(t.experiences))for(let n of t.experiences)u(e,n)}function h(e,t,n){v(e,t,n.isPreview,n.sessionId),l(e,t),f(e,t),p(e,t),m(e,t)}function g(e){let t=e.searchParams[`preview-token`];if(t&&t.length>0)return t[0]}function _(e){let t=new Set,n=e.searchParams.feature;if(!n)return t;for(let e of n){let n=e.indexOf(`:`);n>0&&t.add(e.substring(0,n))}return t}function v(e,t,n,r){let i=_(e);for(let a of t.features)i.has(a.id)||y(e,a,n,r)}function y(e,t,n,a){let o=t.id,s=t.variants;e.registerFeature(o,{key:`v${t.version}`,name:t.name,enabled:t.enabled,weight:t.weight,storage:n?`session`:`local`,decide:()=>t.valueType===`text`?!s||s.length===0?(`${o}`,!1):c(a,o,s)?.value??!1:i(r(a,o),t.weight)})}function b(e,t){for(let n of[...t.references??[],...t.content])e.registerContent({id:n.id,contentModelKey:n.contentModelKey,data:n.data})}function x(e,t){let n=new Map;return(r,i)=>{let a=n.get(r.id);if(a)return a;let o=(async()=>{try{let n=await t(r,i);return n&&b(e,n),n}finally{n.delete(r.id)}})();return n.set(r.id,o),o}}function S(e,t){let n=new Set(t&&Array.isArray(t.experiences)?t.experiences.map(e=>e.id):[]);return(t,r)=>n.has(t.id)?e(t,r):Promise.resolve(null)}function C(){return{name:`dynamic-experiences`,setup:t=>({onStart:(0,e.attach)({source:t.session.store.map(e=>e.id),effect:async e=>{let n=g(t),r=n!==void 0,i=n===void 0?void 0:{previewToken:n},a=await t.getProjectConfig(n===void 0?void 0:{previewToken:n}).catch(e=>null);if(t.contentLoader=x(t,S(e=>t.getExperienceContent(e,i),a)),!a)return;let o=t.seededVersionId;if(o!==null&&o!==a.versionId){t.versionSkew={seeded:o,resolved:a.versionId},`${a.versionId}${o}`;return}t.previewEmbedderOrigins=a.previewEmbedderOrigins??null,h(t,a,{isPreview:r,sessionId:e})}})})}}Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return h}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return C}});

package/dist/{provider-DYmW03w9.cjs → provider-DCjzwNWK.cjs}

@@ -1 +1 @@
-require("./logger-CSTvAyyB.cjs");const e=require("./api-4x_9XPBM.cjs"),t=require("./registry-C1t8l3t9.cjs");var n=`bundle`,r=`api`;async function i(){try{let e=await import(`virtual:picked/data`);return t.r(e)?e:null}catch{return null}}function a(e){if(e===void 0||t.r(e))return e}function o(o){let{apiUrl:s,projectId:c,previewToken:l,signal:u}=o,d=!!l,f=d?r:o.mode,p=a(d?void 0:o.bundle),m=d?void 0:o.projectConfig,h=o.getContent,g={mode:f??r,manifest:null},_,v,y=new Map;function b(){if(f===r)return Promise.resolve(null);if(p)return Promise.resolve(p);let e=t.t();return e?Promise.resolve(e):(_??=i(),_)}function x(e){g.mode=e?n:r,g.manifest=e?e.manifestMetadata:null}async function S(){if(m)return x(await b()),m;let t=await b();return x(t),t?t.projectConfig:f===n?null:e.n(s,c,{...l!==void 0&&{previewToken:l},...u!==void 0&&{signal:u}})}async function C(t,r){let i=l===void 0?void 0:{previewToken:l};if(h)return h(t,i);let a=await b();if(x(a),a)try{return await a.experienceContent(t,i)}catch{return`${t.id}`,null}if(f===n)return null;let o=r??u;return e.t(s,c,t.id,{...l!==void 0&&{previewToken:l},...o!==void 0&&{signal:o}})}return{meta:g,getProjectConfig:()=>(v??=S(),v),getContent:(e,t)=>{let n=y.get(e.id);if(n)return n;let r=C(e,t?.signal).finally(()=>{y.delete(e.id)});return y.set(e.id,r),r}}}exports.createPickedDataProvider=o;
+require("./logger-CSTvAyyB.cjs");const e=require("./api-CUlZaK-b.cjs"),t=require("./registry-C1t8l3t9.cjs");var n=`bundle`,r=`api`;async function i(){try{let e=await import(`virtual:picked/data`);return t.r(e)?e:null}catch{return null}}function a(e){if(e===void 0||t.r(e))return e}function o(o){let{apiUrl:s,projectId:c,previewToken:l,signal:u}=o,d=!!l,f=d?r:o.mode,p=a(d?void 0:o.bundle),m=d?void 0:o.projectConfig,h=o.getContent,g={mode:f??r,manifest:null},_,v,y=new Map;function b(){if(f===r)return Promise.resolve(null);if(p)return Promise.resolve(p);let e=t.t();return e?Promise.resolve(e):(_??=i(),_)}function x(e){g.mode=e?n:r,g.manifest=e?e.manifestMetadata:null}async function S(){if(m)return x(await b()),m;let t=await b();return x(t),t?t.projectConfig:f===n?null:e.n(s,c,{...l!==void 0&&{previewToken:l},...u!==void 0&&{signal:u}})}async function C(t,r){let i=l===void 0?void 0:{previewToken:l};if(h)return h(t,i);let a=await b();if(x(a),a)try{return await a.experienceContent(t,i)}catch{return`${t.id}`,null}if(f===n)return null;let o=r??u;return e.t(s,c,t.id,{...l!==void 0&&{previewToken:l},...o!==void 0&&{signal:o}})}return{meta:g,getProjectConfig:()=>(v??=S(),v),getContent:(e,t)=>{let n=y.get(e.id);if(n)return n;let r=C(e,t?.signal).finally(()=>{y.delete(e.id)});return y.set(e.id,r),r}}}exports.createPickedDataProvider=o;

package/dist/{provider-BlW0FUxy.js → provider-Da1D5BIA.js}

@@ -1,5 +1,5 @@
 import "./logger-DMN6TxJJ.js";
-import { n as e, t } from "./api-DSSAUkRz.js";
+import { n as e, t } from "./api-ITpKqiED.js";
 import { r as n, t as r } from "./registry-CXZv0uLg.js";
 //#region src/data-source/provider.ts
 var i = "bundle", a = "api";

package/dist/types/entities/feature/feature.d.ts

@@ -1,6 +1,7 @@
 /** @file Feature entity — Effector stores and registry for A/B test features with persistent bucketing. */
 import { type EventCallable, type Store } from 'effector';
 import type { Picked } from '../../picked';
+import type { FeatureValueFor } from '../../schema-registry';
 export interface Feature {
     key: string;
     name: string;
@@ -48,9 +49,15 @@ export interface ResolvedFeatureBucket extends FeatureBaseBucket {
     };
 }
 export type FeatureBucket = UnresolvedFeatureBucket | ResolvedFeatureBucket;
-export interface FeatureResult {
+/**
+ * A feature's resolved bucket. `TValue` narrows to a text feature's declared arms when
+ * the schema registry is augmented, and stays `string | boolean` otherwise.
+ *
+ * @param {string | boolean} TValue - The value the feature resolves to.
+ */
+export interface FeatureResult<TValue extends string | boolean = string | boolean> {
     id: string;
-    bucket: string | boolean;
+    bucket: TValue;
 }
 /** The bucket an evokable feature answers with, or undefined while its feature is unregistered. */
 export type FeatureBucketValue = boolean | string | undefined;
@@ -81,7 +88,7 @@ declare const createFeatureIndexFactory: ({ client }: {
     getByName: (name: string) => Store<FeatureIndexItem | undefined>;
     listStore: Store<FeatureBucket[]>;
     getEvokableFeature: (featureName: string) => Store<() => Promise<FeatureBucketValue>>;
-    getFeatureResult: (featureName: string) => Store<FeatureResult | undefined>;
+    getFeatureResult: <K extends string>(featureName: K) => Store<FeatureResult<FeatureValueFor<K>> | undefined>;
 };
 /**
  * Creates a feature index with lifecycle stores and registration logic.

package/dist/types/entities/feature/feature.d.ts.map

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

package/dist/types/index.d.ts

@@ -21,6 +21,6 @@ export type * from './utils/events';
 export type * from './utils/search-params';
 export type * from './entities/response/response';
 export { Picked } from './picked';
-export type { ActionKeys, ContentForStep, ExperienceKeys, FeatureKeys, FieldKeys, FieldKeysForStep, FieldValueFor, KnownActionKeys, KnownExperienceKeys, KnownFeatureKeys, KnownFieldKeys, KnownStepKeys, PickedSchemaRegistry, ReferencedContent, StepContentModelsMap, StepKeys, StepLayoutContent, TypedContent, } from './schema-registry';
+export type { ActionKeys, ContentForStep, ExperienceKeys, FeatureKeys, FeatureValueFor, FieldKeys, FieldKeysForStep, FieldValueFor, KnownActionKeys, KnownExperienceKeys, KnownFeatureKeys, KnownFieldKeys, KnownStepKeys, PickedSchemaRegistry, ReferencedContent, StepContentModelsMap, StepKeys, StepLayoutContent, TypedContent, } from './schema-registry';
 export { toTypedContentStore } from './typed-content';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,4GAA4G;AAC5G,cAAc,WAAW,CAAA;AACzB,mBAAmB,UAAU,CAAA;AAC7B,mBAAmB,0BAA0B,CAAA;AAC7C,mBAAmB,gCAAgC,CAAA;AACnD,mBAAmB,4BAA4B,CAAA;AAC/C,mBAAmB,8BAA8B,CAAA;AACjD,mBAAmB,gCAAgC,CAAA;AACnD,mBAAmB,oCAAoC,CAAA;AACvD,mBAAmB,oDAAoD,CAAA;AACvE,mBAAmB,kCAAkC,CAAA;AACrD,mBAAmB,sBAAsB,CAAA;AACzC,mBAAmB,4BAA4B,CAAA;AAC/C,mBAAmB,wBAAwB,CAAA;AAC3C,mBAAmB,gCAAgC,CAAA;AACnD,mBAAmB,4BAA4B,CAAA;AAC/C,mBAAmB,0BAA0B,CAAA;AAC7C,mBAAmB,gCAAgC,CAAA;AACnD,mBAAmB,4BAA4B,CAAA;AAC/C,mBAAmB,gBAAgB,CAAA;AACnC,mBAAmB,uBAAuB,CAAA;AAC1C,mBAAmB,8BAA8B,CAAA;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,YAAY,EACV,UAAU,EACV,cAAc,EACd,cAAc,EACd,WAAW,EACX,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,QAAQ,EACR,iBAAiB,EACjB,YAAY,GACb,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,4GAA4G;AAC5G,cAAc,WAAW,CAAA;AACzB,mBAAmB,UAAU,CAAA;AAC7B,mBAAmB,0BAA0B,CAAA;AAC7C,mBAAmB,gCAAgC,CAAA;AACnD,mBAAmB,4BAA4B,CAAA;AAC/C,mBAAmB,8BAA8B,CAAA;AACjD,mBAAmB,gCAAgC,CAAA;AACnD,mBAAmB,oCAAoC,CAAA;AACvD,mBAAmB,oDAAoD,CAAA;AACvE,mBAAmB,kCAAkC,CAAA;AACrD,mBAAmB,sBAAsB,CAAA;AACzC,mBAAmB,4BAA4B,CAAA;AAC/C,mBAAmB,wBAAwB,CAAA;AAC3C,mBAAmB,gCAAgC,CAAA;AACnD,mBAAmB,4BAA4B,CAAA;AAC/C,mBAAmB,0BAA0B,CAAA;AAC7C,mBAAmB,gCAAgC,CAAA;AACnD,mBAAmB,4BAA4B,CAAA;AAC/C,mBAAmB,gBAAgB,CAAA;AACnC,mBAAmB,uBAAuB,CAAA;AAC1C,mBAAmB,8BAA8B,CAAA;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,YAAY,EACV,UAAU,EACV,cAAc,EACd,cAAc,EACd,WAAW,EACX,eAAe,EACf,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,QAAQ,EACR,iBAAiB,EACjB,YAAY,GACb,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/types/picked.d.ts

@@ -173,7 +173,7 @@ export declare class Picked {
         getByName: (name: string) => Store<import(".").FeatureIndexItem | undefined>;
         listStore: Store<import(".").FeatureBucket[]>;
         getEvokableFeature: (featureName: string) => Store<() => Promise<import(".").FeatureBucketValue>>;
-        getFeatureResult: (featureName: string) => Store<import(".").FeatureResult | undefined>;
+        getFeatureResult: <K extends string>(featureName: K) => Store<import(".").FeatureResult<import("./schema-registry").FeatureValueFor<K>> | undefined>;
     };
     readonly conditions: {
         register: (condition: Condition) => void;

package/dist/types/plugins/dynamic-experiences/hash.d.ts

@@ -24,9 +24,14 @@ export declare function fnv1a32(input: string): number;
  * publishing a new version re-runs `decide` against the current weight and an
  * unchanged weight keeps the same audience.
  *
+ * This is the boolean path's input. A multi-variant feature does not roll once
+ * and look the result up; {@link allocateVariant} scores each arm on its own
+ * seed. One roll per feature is still what keeps features independent of one
+ * another, per ADR-0018.
+ *
  * @param {string} sessionId - Current session id, stable across page loads.
  * @param {string} featureId - Feature the roll is for.
- * @returns {number} A value in the range 0–99.
+ * @returns {number} A value in the range 0 to 99.
  * @example
  * ```typescript
  * const diceRoll = featureDiceRoll('sess_1', 'winter-sale')
@@ -50,4 +55,51 @@ export declare function featureDiceRoll(sessionId: string, featureId: string): n
  * ```
  */
 export declare function isAllocated(diceRoll: number, weight: number): boolean;
+/** The fields {@link allocateVariant} needs from an arm. */
+export interface AllocatableVariant {
+    key: string;
+    weight: number;
+}
+/**
+ * Picks the arm a session lands in, scoring each arm independently.
+ *
+ * Each arm is hashed on its own key and scored against its own weight, and the
+ * highest score wins. An arm's score therefore depends on nothing but the
+ * session, the feature and that arm's own weight, which is what gives the two
+ * properties an author is entitled to assume:
+ *
+ * - Editing one arm's weight moves sessions only into or out of that arm. Two
+ *   arms the author did not touch never trade sessions with each other.
+ * - Widening an arm only admits sessions and never evicts one already inside,
+ *   the same ratchet {@link isAllocated} gives the boolean path. Narrowing is
+ *   its mirror.
+ *
+ * Neither holds for cumulative ranges, where an arm's interval depends on every
+ * arm ordered before it, so a boundary shift upstream drags unrelated arms
+ * across it.
+ *
+ * Scores are compared, never summed, so the result is invariant under scaling
+ * every weight by the same factor: `1:1:2` and `10:10:20` allocate identically.
+ * Ties break on the key so that the arms' arrival order cannot matter — nothing
+ * in the delivery pipeline promises one.
+ *
+ * The chosen arm is returned whole rather than by key, so a caller reading its
+ * value needs no second lookup — and cannot resolve a duplicate key to a
+ * different arm than the one scored.
+ *
+ * @template T
+ * @param {string} sessionId - Current session id, stable across page loads.
+ * @param {string} featureKey - Feature being allocated.
+ * @param {readonly T[]} variants - The feature's arms, in any order.
+ * @returns {T | null} The chosen arm, or null when the set decides nobody.
+ * @example
+ * ```typescript
+ * // 'hero-b' takes three sessions in four; 'false' takes the fourth.
+ * allocateVariant('sess_1', 'hero', [
+ *   { key: 'hero-b', weight: 3 },
+ *   { key: 'false', weight: 1 },
+ * ])
+ * ```
+ */
+export declare function allocateVariant<T extends AllocatableVariant>(sessionId: string, featureKey: string, variants: readonly T[]): T | null;
 //# sourceMappingURL=hash.d.ts.map

package/dist/types/plugins/dynamic-experiences/hash.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../../../src/plugins/dynamic-experiences/hash.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAY7C;AA8BD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE5E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAUrE"}
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../../../src/plugins/dynamic-experiences/hash.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAY7C;AA8BD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE5E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAUrE;AAED,4DAA4D;AAC5D,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;CACf;AA4CD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,kBAAkB,EAC1D,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,SAAS,CAAC,EAAE,GACrB,CAAC,GAAG,IAAI,CAmBV"}

package/dist/types/plugins/dynamic-experiences/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../src/plugins/dynamic-experiences/plugin.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAEV,aAAa,EAGd,MAAM,6BAA6B,CAAA;AACpC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAA;AAE1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAK1C,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AA+J5E;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACjD,IAAI,CAMN;AAwMD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CA4DjD"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../src/plugins/dynamic-experiences/plugin.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAEV,aAAa,EAGd,MAAM,6BAA6B,CAAA;AACpC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAA;AAE1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAK1C,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AA+J5E;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACjD,IAAI,CAMN;AA+ND;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CA4DjD"}