@picked/client 0.0.55 → 0.0.56-next.2

package/dist/docs/tooling/mcp.md

@@ -0,0 +1,120 @@
+---
+layout: docs
+---
+
+# MCP server
+
+Manage your Picked workspace from AI coding tools using the Model Context Protocol (MCP).
+
+## Connecting
+
+The server URL is `https://api.picked.app/mcp`.
+
+### Claude Desktop
+
+1. Open **Settings > Connectors > Add custom connector**
+2. Set **Name** to `Picked` and **URL** to `https://api.picked.app/mcp`
+3. Click **Connect** and complete the authorization prompt
+
+### Project configuration (.mcp.json)
+
+Add to your repository root. Works with Claude Code, Cursor, Windsurf, and other MCP-compatible tools.
+
+:::code-group
+
+```json [.mcp.json]
+{
+  "mcpServers": {
+    "picked": {
+      "type": "http",
+      "url": "https://api.picked.app/mcp"
+    }
+  }
+}
+```
+
+:::
+
+### Cursor
+
+Add to `.cursor/mcp.json` in your project root:
+
+```json
+{
+  "mcpServers": {
+    "picked": {
+      "type": "http",
+      "url": "https://api.picked.app/mcp"
+    }
+  }
+}
+```
+
+## Available tools
+
+### Discovery
+
+| Tool                     | Description                                                  |
+| ------------------------ | ------------------------------------------------------------ |
+| `list_projects`          | List organizations and projects                              |
+| `get_workspace_overview` | Full workspace state                                         |
+| `get_schema_info`        | Documentation for Picked concepts and data model             |
+| `get_picked_docs`        | Fetch the complete Picked documentation (LLM-optimized text) |
+
+### Experiences
+
+| Tool                     | Description                                                                               |
+| ------------------------ | ----------------------------------------------------------------------------------------- |
+| `create_experience`      | Create an experience                                                                      |
+| `get_experience`         | Get experience details including flow graph                                               |
+| `list_experiences`       | List experiences                                                                          |
+| `update_experience_flow` | Atomically create, update, or delete steps, conditions, actions, fields, nodes, and edges |
+
+### Steps, fields, conditions, and actions
+
+| Tool                                | Description     |
+| ----------------------------------- | --------------- |
+| `get_step` / `list_steps`           | Read steps      |
+| `get_field` / `list_fields`         | Read fields     |
+| `get_condition` / `list_conditions` | Read conditions |
+| `get_action` / `list_actions`       | Read actions    |
+
+### Features
+
+| Tool             | Description                                        |
+| ---------------- | -------------------------------------------------- |
+| `create_feature` | Create a feature                                   |
+| `get_feature`    | Get feature details                                |
+| `list_features`  | List features                                      |
+| `update_feature` | Update name, description, enabled state, or weight |
+
+### Analytics
+
+| Tool             | Description                                                      |
+| ---------------- | ---------------------------------------------------------------- |
+| `query_pickedql` | Execute a PickedQL analytics query and return results as a table |
+
+Use `get_schema_info` with topic `pickedql` to see available tables, virtual functions, and dimension columns before writing queries.
+
+### Publishing
+
+| Tool                | Description                                    |
+| ------------------- | ---------------------------------------------- |
+| `get_preview_url`   | Generate a preview URL for unpublished changes |
+| `publish_workspace` | Publish the workspace                          |
+
+## Example prompts
+
+- "List my Picked projects and show me what's configured"
+- "Create a feature flag called 'new-checkout' enabled at 50% traffic"
+- "Create an experience with a step that collects email addresses"
+- "Show me control vs variant users by device for the last 30 days"
+- "Generate a preview URL for my workspace on https://example.com"
+
+## Tips
+
+- Ask your agent to list your projects first, then explore your workspace to see what's configured.
+- When building complex experiences, ask your agent about flow graphs and JSON Logic — it can look up the documentation for you.
+- Experience flow updates are atomic — your agent can create steps, fields, nodes, and edges in a single operation.
+- Preview your changes on your site before publishing to verify everything looks right.
+- Ask your agent to query analytics data with PickedQL — it can look up the schema, write the SQL, and explain the results.

package/dist/docs/tooling/vite-plugin.md

@@ -0,0 +1,82 @@
+---
+layout: docs
+---
+
+# Vite Plugin
+
+`@picked/vite-plugin-picked` integrates Picked into your Vite project. It fetches your project configuration at build time and injects it via Vite's `define`, eliminating the runtime API request. During development it also serves a launcher page for previewing experiences with feature overrides.
+
+## Installation
+
+:::code-group
+
+```bash [npm]
+npm install @picked/vite-plugin-picked
+```
+
+```bash [pnpm]
+pnpm add @picked/vite-plugin-picked
+```
+
+```bash [yarn]
+yarn add @picked/vite-plugin-picked
+```
+
+:::
+
+## Setup
+
+Add the plugin to your `vite.config.ts`:
+
+```typescript
+import { defineConfig } from 'vite'
+import { picked } from '@picked/vite-plugin-picked'
+
+export default defineConfig({
+  plugins: [
+    picked({
+      projectId: 'your-project-id',
+    }),
+  ],
+})
+```
+
+## How It Works
+
+### Build-Time Config Injection
+
+When Vite starts (both `dev` and `build`), the plugin:
+
+1. Fetches your project configuration from the Picked API
+2. Embeds the config directly into your bundle
+3. The SDK reads the embedded config at runtime, skipping the network request
+
+When a preview token is present at runtime, the SDK ignores the build-time config and fetches fresh data from the API.
+
+### Dev Launcher
+
+During development, the plugin serves an HTML page at `/` that lets you:
+
+- See all features in your project with their current status
+- Toggle features on/off for local testing
+- Preview experiences with specific feature overrides
+
+After the dev server starts, the launcher URL appears alongside Vite's native output:
+
+```
+  ➜  Picked:  http://localhost:5173/
+  ➜  Local:   http://localhost:5173/
+  ➜  Network: use --host to expose
+```
+
+## Options
+
+| Option           | Type      | Default                      | Description                                              |
+| ---------------- | --------- | ---------------------------- | -------------------------------------------------------- |
+| `projectId`      | `string`  | —                            | **Required.** Your Picked project ID.                    |
+| `apiUrl`         | `string`  | `https://api.picked.app`     | Custom API URL for self-hosted or local API instances.    |
+| `disableLauncher`| `boolean` | `false`                      | Disable the launcher page in both dev and build output.  |
+
+## Build Output
+
+When building for production (`vite build`), the plugin emits an `index.html` file containing the launcher page (unless `disableLauncher` is set). This lets you deploy the launcher alongside your application for stakeholder previews.

package/dist/docs/workspaces.md

@@ -0,0 +1,35 @@
+---
+layout: docs
+---
+
+# Workspaces
+
+A workspace is a version of your project's configuration. Use workspaces to stage changes, preview them, and publish when ready.
+
+## How workspaces work
+
+Each project has a workspace that holds your experiences, features, and entity configurations. When you make changes in the dashboard — editing a flow, updating a feature, or modifying an entity — those changes exist in the workspace until you publish.
+
+## Preview
+
+Preview your workspace to see how changes look before publishing.
+
+1. Click **Preview** in the workspace toolbar.
+2. Enter the URL of your site.
+3. Optionally override individual features — set each to **Default**, **On**, or **Off**.
+4. Click **Open Preview**.
+
+Your site opens in a new tab with the unpublished workspace applied. Preview uses query parameters to pass the workspace state to the SDK, so visitors on your live site are unaffected.
+
+## Publish
+
+Publishing creates an immutable snapshot of your workspace. Once published, the SDK serves the new configuration to visitors.
+
+1. Click **Publish** in the workspace toolbar.
+2. Confirm in the publish dialog.
+
+The publish button is only enabled when there are unpublished changes. A status badge in the toolbar shows whether the workspace has unpublished changes or is up to date.
+
+## Unpublished changes
+
+The workspace tracks whether any changes have been made since the last publish. If you create or update an experience, feature, or entity after the last publish, the toolbar shows a warning badge indicating unpublished changes.

package/dist/esm/form/index.js

@@ -66,11 +66,11 @@ function m(e, n, i) {
 	let s = a([]), c = t({
 		source: {
 			allFields: e.fields.listStore,
-			fieldIds: n,
+			fieldKeys: n,
 			staged: i,
 			committed: e.responses.getAllStore
 		},
-		effect: r(async ({ allFields: t, fieldIds: n, staged: r, committed: i }) => await p(e, t.filter((e) => n.includes(e.id)), { responses: {
+		effect: r(async ({ allFields: t, fieldKeys: n, staged: r, committed: i }) => await p(e, t.filter((e) => n.includes(e.key)), { responses: {
 			...i,
 			...r
 		} }))

package/dist/esm/index.js

@@ -4,7 +4,7 @@ import { t as r } from "../logger-6z_gb4rA.js";
 import { a as i, c as a, d as o, i as s, l as c, n as l, o as u, p as d, r as f, s as p, t as m, u as h } from "../supports-0XIfd4-R.js";
 import { a as g, c as _, i as v, l as ee, n as te, o as ne, r as re, s as y } from "../experience-instance-DffMstSs.js";
 import { i as ie, n as b, r as x, t as S } from "../storage-6Xk0uAxB.js";
-import { n as ae, r as oe } from "../api-B1yTKITq.js";
+import { n as ae, r as oe } from "../api-DHSz_ruC.js";
 import { t as se } from "../id-CRqy981z.js";
 import { attach as C, combine as w, createApi as T, createDomain as E, createEffect as D, createEvent as O, createStore as k, sample as A } from "effector";
 import { createFactory as j, invoke as M } from "@withease/factories";

package/dist/esm/plugins/create-experience/index.js

@@ -102,7 +102,7 @@ var t = {
 				id: this.id,
 				key: this.key,
 				name: this.name,
-				fieldIds: this.fields.map((e) => e.id)
+				fieldKeys: this.fields.map((e) => e.key)
 			});
 		}
 	};

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

@@ -1,5 +1,5 @@
 import "../../../logger-6z_gb4rA.js";
-import { i as e, t } from "../../../api-B1yTKITq.js";
+import { i as e, t } from "../../../api-DHSz_ruC.js";
 //#region src/plugins/dynamic-experiences/hash.ts
 function n(e) {
 	let t = 2166136261;
@@ -37,7 +37,16 @@ function c(e, t) {
 	if (Array.isArray(t.fields)) for (let n of t.fields) e.registerField(n);
 }
 function l(e, t) {
-	if (Array.isArray(t.steps)) for (let n of t.steps) e.registerStep(n);
+	if (!Array.isArray(t.steps)) return;
+	let n = /* @__PURE__ */ new Map();
+	if (Array.isArray(t.fields)) for (let e of t.fields) n.set(e.id, e.key);
+	for (let r of t.steps) e.registerStep({
+		id: r.id,
+		key: r.key,
+		name: r.name,
+		fieldKeys: r.fieldIds.map((e) => n.get(e) ?? e),
+		layoutName: r.layoutName
+	});
 }
 function u(e, t) {
 	if (Array.isArray(t.experiences)) for (let n of t.experiences) s(e, n);

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

@@ -4,7 +4,7 @@ export interface ExperienceStep {
     id: string;
     key: string;
     name: string;
-    fieldIds: string[];
+    fieldKeys: string[];
     layoutName?: string | null;
 }
 declare const createStepIndexFactory: () => {

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

@@ -1 +1 @@
-{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../../../../src/entities/step/step.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,OAAO,EAA2B,KAAK,KAAK,EAAE,MAAM,UAAU,CAAA;AAG9D,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAA;AAI3D,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B;AAGD,QAAA,MAAM,sBAAsB;qBAuBF,cAAc,KAAG,IAAI;kBAkBxB,cAAc,CAAC,IAAI,CAAC,KAAG,KAAK,CAAC,cAAc,GAAG,IAAI,CAAC;oBAcjD,cAAc,CAAC,KAAK,CAAC,KAAG,KAAK,CAAC,cAAc,GAAG,IAAI,CAAC;;;;;CAa3E,CAAA;AAEF;;;;;;;GAOG;AACH,wBAAgB,eAAe,IAAI,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAE3E;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,GAAG,IAAI,CAE/F"}
+{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../../../../src/entities/step/step.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,OAAO,EAA2B,KAAK,KAAK,EAAE,MAAM,UAAU,CAAA;AAG9D,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAA;AAI3D,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B;AAGD,QAAA,MAAM,sBAAsB;qBAuBF,cAAc,KAAG,IAAI;kBAkBxB,cAAc,CAAC,IAAI,CAAC,KAAG,KAAK,CAAC,cAAc,GAAG,IAAI,CAAC;oBAcjD,cAAc,CAAC,KAAK,CAAC,KAAG,KAAK,CAAC,cAAc,GAAG,IAAI,CAAC;;;;;CAa3E,CAAA;AAEF;;;;;;;GAOG;AACH,wBAAgB,eAAe,IAAI,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAE3E;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,GAAG,IAAI,CAE/F"}

package/dist/types/form/create-field-evaluator.d.ts

@@ -2,10 +2,10 @@ import { Store, StoreWritable } from 'effector';
 import { Field, FieldValue } from '../entities/field/field';
 import { Picked } from '../picked';
 /**
- * Creates a reactive store of evaluated fields for a given set of field IDs.
+ * Creates a reactive store of evaluated fields for a given set of field keys.
  *
  * Fields are re-evaluated whenever:
- * - The available field IDs change (e.g. A step is entered)
+ * - The available field keys change (e.g. A step is entered)
  * - Any response is committed (options may depend on prior answers)
  * - The global field registry changes (fields registered after init)
  * - Staged values change (field visibility conditions may reference responses.*).
@@ -14,14 +14,14 @@ import { Picked } from '../picked';
  * so visibility conditions see live in-session values rather than only committed responses.
  *
  * @param client - The Picked client instance.
- * @param fieldIds - Store of field IDs to evaluate.
+ * @param fieldKeys - Store of field keys to evaluate.
  * @param stagedValuesStore - Store of in-progress field values not yet committed.
  * @example
  * ```typescript
- * const { fieldsStore } = createFieldEvaluator(client, fieldIdsStore, stagedStore)
+ * const { fieldsStore } = createFieldEvaluator(client, fieldKeysStore, stagedStore)
  * ```
  */
-export declare function createFieldEvaluator(client: Picked, fieldIds: Store<string[]>, stagedValuesStore: StoreWritable<Record<string, FieldValue>>): {
+export declare function createFieldEvaluator(client: Picked, fieldKeys: Store<string[]>, stagedValuesStore: StoreWritable<Record<string, FieldValue>>): {
     fieldsStore: Store<Field[]>;
 };
 //# sourceMappingURL=create-field-evaluator.d.ts.map

package/dist/types/form/create-field-evaluator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-field-evaluator.d.ts","sourceRoot":"","sources":["../../../src/form/create-field-evaluator.ts"],"names":[],"mappings":"AAAA,8GAA8G;AAC9G,OAAO,EAA6C,KAAK,KAAK,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAA;AACpG,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAChE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAGvC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,EACzB,iBAAiB,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,GAC3D;IAAE,WAAW,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAwCjC"}
+{"version":3,"file":"create-field-evaluator.d.ts","sourceRoot":"","sources":["../../../src/form/create-field-evaluator.ts"],"names":[],"mappings":"AAAA,8GAA8G;AAC9G,OAAO,EAA6C,KAAK,KAAK,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAA;AACpG,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAChE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAGvC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,EAC1B,iBAAiB,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,GAC3D;IAAE,WAAW,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAwCjC"}

package/dist/types/form/create-form.d.ts

@@ -35,7 +35,7 @@ export interface CreateFormDeps {
  * Return type for createForm().
  * Provides form handlers, reactive stores, and callback registration.
  */
-export interface FormInstance<TFieldIds extends string = string> {
+export interface FormInstance<TFieldKeys extends string = string> {
     /** Form element props (bind to a form element). */
     form: {
         /** HTML-safe attributes to spread onto a form element. */
@@ -47,9 +47,9 @@ export interface FormInstance<TFieldIds extends string = string> {
         /** Reactive store indicating if form is currently submitting. */
         submitting: Store<boolean>;
         /** Register callbacks to transform/validate data before submission. Returns unsubscribe. */
-        onBeforeSubmit: (callback: SubmitCallback<TFieldIds>) => () => void;
+        onBeforeSubmit: (callback: SubmitCallback<TFieldKeys>) => () => void;
         /** Register callbacks to run on successful form submission. Returns unsubscribe. */
-        onSuccess: (callback: SuccessCallback<TFieldIds>) => () => void;
+        onSuccess: (callback: SuccessCallback<TFieldKeys>) => () => void;
         /** Register callbacks to run on form validation errors. Returns unsubscribe. */
         onError: (callback: ErrorCallback) => () => void;
     };
@@ -70,7 +70,7 @@ export interface FormInstance<TFieldIds extends string = string> {
  */
 export declare function getEventValue(e: Event): FieldValue | undefined;
 /**
- * Creates a form instance tied to a set of field IDs.
+ * Creates a form instance tied to a set of field keys.
  * Handles field evaluation, form submission, data transformation,
  * validation, event bus tracking, and step navigation.
  *
@@ -81,7 +81,7 @@ export declare function getEventValue(e: Event): FieldValue | undefined;
  * @param {CreateFormDeps} deps - Client and experience instance injected by the framework wrapper.
  * @param {string} formId - Unique identifier for this form instance.
  * @param {Store<string>} title - Reactive store holding the form/step title.
- * @param {Store<string[]>} fieldIds - Reactive store of field IDs that belong to this form.
+ * @param {Store<string[]>} fieldKeys - Reactive store of field keys that belong to this form.
  * @returns {FormInstance} A form instance with reactive field stores, submission handlers, and callback registration.
  * @example
  * ```ts
@@ -89,9 +89,9 @@ export declare function getEventValue(e: Event): FieldValue | undefined;
  *   { client, experienceInstance },
  *   'lead-capture',
  *   $title,
- *   $fieldIds,
+ *   $fieldKeys,
  * )
  * ```
  */
-export declare function createForm(deps: CreateFormDeps, formId: string, title: Store<string>, fieldIds: Store<string[]>): FormInstance;
+export declare function createForm(deps: CreateFormDeps, formId: string, title: Store<string>, fieldKeys: Store<string[]>): FormInstance;
 //# sourceMappingURL=create-form.d.ts.map

package/dist/types/form/create-form.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-form.d.ts","sourceRoot":"","sources":["../../../src/form/create-form.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,KAAK,EAEX,MAAM,UAAU,CAAA;AACjB,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAChE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qDAAqD,CAAA;AAC7F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AACpE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAGvC,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,4BAA4B,EACjC,KAAK,eAAe,EACrB,MAAM,0BAA0B,CAAA;AAEjC,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG;IAC9B,KAAK,EAAE,UAAU,GAAG,SAAS,CAAA;IAC7B,8DAA8D;IAC9D,KAAK,EAAE,eAAe,GAAG,SAAS,CAAA;IAClC,OAAO,EAAE,OAAO,CAAA;IAChB,4DAA4D;IAC5D,KAAK,EAAE;QACL,EAAE,EAAE,MAAM,CAAA;QACV,IAAI,EAAE,MAAM,CAAA;QACZ,GAAG,EAAE,MAAM,CAAA;QACX,KAAK,EAAE,UAAU,GAAG,SAAS,CAAA;QAC7B,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAA;QACpC,QAAQ,EAAE,OAAO,CAAA;QACjB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;QAC/B,OAAO,EAAE,CAAC,CAAC,EAAE,KAAK,KAAK,IAAI,CAAA;QAC3B,QAAQ,EAAE,CAAC,CAAC,EAAE,KAAK,KAAK,IAAI,CAAA;QAC5B,MAAM,EAAE,CAAC,CAAC,EAAE,KAAK,KAAK,IAAI,CAAA;KAC3B,CAAA;CACF,CAAA;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,kBAAkB,EAAE,kBAAkB,CAAA;CACvC;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY,CAAC,SAAS,SAAS,MAAM,GAAG,MAAM;IAC7D,mDAAmD;IACnD,IAAI,EAAE;QACJ,0DAA0D;QAC1D,KAAK,EAAE;YACL,QAAQ,EAAE,aAAa,CAAC,4BAA4B,CAAC,CAAA;SACtD,CAAA;QACD,6EAA6E;QAC7E,MAAM,EAAE,KAAK,CAAC,eAAe,EAAE,CAAC,CAAA;QAChC,iEAAiE;QACjE,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;QAC1B,4FAA4F;QAC5F,cAAc,EAAE,CAAC,QAAQ,EAAE,cAAc,CAAC,SAAS,CAAC,KAAK,MAAM,IAAI,CAAA;QACnE,oFAAoF;QACpF,SAAS,EAAE,CAAC,QAAQ,EAAE,eAAe,CAAC,SAAS,CAAC,KAAK,MAAM,IAAI,CAAA;QAC/D,gFAAgF;QAChF,OAAO,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,MAAM,IAAI,CAAA;KACjD,CAAA;IACD,+FAA+F;IAC/F,MAAM,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAA;CAC3B;AAED;;;;;;;;;;;GAWG;AAEH,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,GAAG,UAAU,GAAG,SAAS,CAW9D;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EACpB,QAAQ,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,GACxB,YAAY,CAoLd"}
+{"version":3,"file":"create-form.d.ts","sourceRoot":"","sources":["../../../src/form/create-form.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,KAAK,EAEX,MAAM,UAAU,CAAA;AACjB,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAChE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qDAAqD,CAAA;AAC7F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AACpE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAGvC,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,4BAA4B,EACjC,KAAK,eAAe,EACrB,MAAM,0BAA0B,CAAA;AAEjC,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG;IAC9B,KAAK,EAAE,UAAU,GAAG,SAAS,CAAA;IAC7B,8DAA8D;IAC9D,KAAK,EAAE,eAAe,GAAG,SAAS,CAAA;IAClC,OAAO,EAAE,OAAO,CAAA;IAChB,4DAA4D;IAC5D,KAAK,EAAE;QACL,EAAE,EAAE,MAAM,CAAA;QACV,IAAI,EAAE,MAAM,CAAA;QACZ,GAAG,EAAE,MAAM,CAAA;QACX,KAAK,EAAE,UAAU,GAAG,SAAS,CAAA;QAC7B,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAA;QACpC,QAAQ,EAAE,OAAO,CAAA;QACjB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;QAC/B,OAAO,EAAE,CAAC,CAAC,EAAE,KAAK,KAAK,IAAI,CAAA;QAC3B,QAAQ,EAAE,CAAC,CAAC,EAAE,KAAK,KAAK,IAAI,CAAA;QAC5B,MAAM,EAAE,CAAC,CAAC,EAAE,KAAK,KAAK,IAAI,CAAA;KAC3B,CAAA;CACF,CAAA;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,kBAAkB,EAAE,kBAAkB,CAAA;CACvC;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY,CAAC,UAAU,SAAS,MAAM,GAAG,MAAM;IAC9D,mDAAmD;IACnD,IAAI,EAAE;QACJ,0DAA0D;QAC1D,KAAK,EAAE;YACL,QAAQ,EAAE,aAAa,CAAC,4BAA4B,CAAC,CAAA;SACtD,CAAA;QACD,6EAA6E;QAC7E,MAAM,EAAE,KAAK,CAAC,eAAe,EAAE,CAAC,CAAA;QAChC,iEAAiE;QACjE,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;QAC1B,4FAA4F;QAC5F,cAAc,EAAE,CAAC,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,KAAK,MAAM,IAAI,CAAA;QACpE,oFAAoF;QACpF,SAAS,EAAE,CAAC,QAAQ,EAAE,eAAe,CAAC,UAAU,CAAC,KAAK,MAAM,IAAI,CAAA;QAChE,gFAAgF;QAChF,OAAO,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,MAAM,IAAI,CAAA;KACjD,CAAA;IACD,+FAA+F;IAC/F,MAAM,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAA;CAC3B;AAED;;;;;;;;;;;GAWG;AAEH,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,GAAG,UAAU,GAAG,SAAS,CAW9D;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EACpB,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,GACzB,YAAY,CAoLd"}

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":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAA;AAK1D,OAAO,KAAK,EACV,+BAA+B,EAC/B,mBAAmB,EACnB,aAAa,EAGd,MAAM,SAAS,CAAA;AAmUhB;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAmC/B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,CAAC,EAAE,+BAA+B,GAAG,MAAM,CAgD1F"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../src/plugins/dynamic-experiences/plugin.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAA;AAK1D,OAAO,KAAK,EACV,+BAA+B,EAC/B,mBAAmB,EACnB,aAAa,EAGd,MAAM,SAAS,CAAA;AAgVhB;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAmC/B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,CAAC,EAAE,+BAA+B,GAAG,MAAM,CAgD1F"}

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

@@ -3,6 +3,14 @@ import { Field } from '../../entities/field/field';
 import { ExperienceEdge, ExperienceNode, ExperienceTarget } from '../../entities/experience/experience';
 import { Condition } from '../../entities/condition/condition';
 import { LogicRule, LogicValue } from '../../logic-engine';
+/**
+ * Wire-format step as returned by the Picked API. Matches {@link ExperienceStep}
+ * except that fields are still referenced by ID — the plugin resolves them to
+ * keys against `ProjectConfig.fields` at registration time.
+ */
+export type ApiExperienceStep = Omit<ExperienceStep, 'fieldKeys'> & {
+    fieldIds: string[];
+};
 export interface ProjectConfigFeature {
     id: string;
     name: string;
@@ -42,7 +50,7 @@ export interface ProjectConfig {
     /** Experience definitions with steps and conditions referenced by ID. */
     experiences: ProjectConfigExperience[];
     /** Global step definitions shared across experiences. */
-    steps: ExperienceStep[];
+    steps: ApiExperienceStep[];
     /** Global field definitions shared across steps. */
     fields: Field[];
     /** Global condition definitions referenced by experience flow nodes. */

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/plugins/dynamic-experiences/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAA;AACvD,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,gBAAgB,EACjB,MAAM,sCAAsC,CAAA;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAA;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAE/D,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAA;AAE9C;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,EAAE,MAAM,CAAA;IACrB,KAAK,EAAE,iBAAiB,EAAE,CAAA;IAC1B,KAAK,EAAE,cAAc,EAAE,CAAA;IACvB,2EAA2E;IAC3E,SAAS,EAAE,SAAS,GAAG,UAAU,CAAA;IACjC,oEAAoE;IACpE,cAAc,EAAE,SAAS,GAAG,UAAU,CAAA;IACtC,+CAA+C;IAC/C,OAAO,EAAE,gBAAgB,EAAE,CAAA;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,oBAAoB,EAAE,CAAA;IAChC,yEAAyE;IACzE,WAAW,EAAE,uBAAuB,EAAE,CAAA;IACtC,yDAAyD;IACzD,KAAK,EAAE,cAAc,EAAE,CAAA;IACvB,oDAAoD;IACpD,MAAM,EAAE,KAAK,EAAE,CAAA;IACf,wEAAwE;IACxE,UAAU,EAAE,SAAS,EAAE,CAAA;IACvB,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC1D;AAED,MAAM,WAAW,+BAA+B;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,aAAa,CAAC,EAAE,aAAa,CAAA;CAC9B;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/plugins/dynamic-experiences/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAA;AACvD,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,gBAAgB,EACjB,MAAM,sCAAsC,CAAA;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAA;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAE/D;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC,GAAG;IAClE,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB,CAAA;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAA;AAE9C;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,EAAE,MAAM,CAAA;IACrB,KAAK,EAAE,iBAAiB,EAAE,CAAA;IAC1B,KAAK,EAAE,cAAc,EAAE,CAAA;IACvB,2EAA2E;IAC3E,SAAS,EAAE,SAAS,GAAG,UAAU,CAAA;IACjC,oEAAoE;IACpE,cAAc,EAAE,SAAS,GAAG,UAAU,CAAA;IACtC,+CAA+C;IAC/C,OAAO,EAAE,gBAAgB,EAAE,CAAA;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,oBAAoB,EAAE,CAAA;IAChC,yEAAyE;IACzE,WAAW,EAAE,uBAAuB,EAAE,CAAA;IACtC,yDAAyD;IACzD,KAAK,EAAE,iBAAiB,EAAE,CAAA;IAC1B,oDAAoD;IACpD,MAAM,EAAE,KAAK,EAAE,CAAA;IACf,wEAAwE;IACxE,UAAU,EAAE,SAAS,EAAE,CAAA;IACvB,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC1D;AAED,MAAM,WAAW,+BAA+B;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,aAAa,CAAC,EAAE,aAAa,CAAA;CAC9B;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@picked/client",
-  "version": "0.0.55",
+  "version": "0.0.56-next.2",
   "dependencies": {
     "@withease/factories": "^1.0.5"
   },
@@ -140,7 +140,7 @@
   },
   "private": false,
   "scripts": {
-    "build": "vite build",
+    "build": "vite build && node scripts/copy-docs.js",
     "build:docs": "pnpm typedoc",
     "check": "pnpm type-check && pnpm lint && pnpm knip && pnpm jscpd",
     "dev": "vite build --watch",

package/dist/api-DO5hnUsd.cjs

@@ -1 +0,0 @@
-var e=`Picked-Client`,t=`Picked-Version`;function n(n,r){return{[e]:n,[t]:r}}var r=()=>`0.0.55`,i=`v1`;function a(e,t){return new URL(`/api/${i}/${t}`,e).toString()}function o(e){return{...n(`sdk`,r()),...e}}async function s(e,t,n){let r=a(e,t);return fetch(r,{headers:o(n)})}async function c(e,t,n,r){let i=a(e,t);return fetch(i,{method:`POST`,headers:{"Content-Type":`application/json`,...o(r)},body:JSON.stringify(n)})}Object.defineProperty(exports,`i`,{enumerable:!0,get:function(){return n}}),Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return c}}),Object.defineProperty(exports,`r`,{enumerable:!0,get:function(){return r}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return s}});