@embeddables/cli 0.6.9 → 0.6.10

package/.prompts/embeddables-cli.md

@@ -510,6 +510,18 @@ Conditions control visibility of components and pages based on User Data. The `C
 
 **Storage**: Conditions are stored in the component/page JSON and preserved in config.json (not in React/CSS/JS files).
 
+### Experiments and conditions
+
+When visibility is gated by an experiment (a key in `connected_experiments`, otherwise the experiment is not connected and will not work, and which controls the variants as well), conditions that use that experiment key must cover both:
+
+1. **Control variant** – Use the control variant value (e.g. `"control"`) in condition values so the control experience is shown when that variant is assigned.
+2. **No value** – Use the special value `_no_value` in condition values so users who are not yet assigned a variant (user data has no value for that experiment key) see the intended default experience—typically the same as control.
+3. Other variant keys.
+
+#1 and #2 should be on the same conditions as each other, whereas all other variants (#3) can be on other conditions.
+
+Example: for experiment key `hero_test` with variants `control` and `variant_b`, the control experience might use a condition like `key: "hero_test", operator: "==", values: ["control", "_no_value"]` so both control users and users with no assignment see the control. The variant experience would use `values: ["variant_b"]`.
+
 ## Config.json Structure
 
 The `config.json` file contains the reduced Embeddable JSON with:
@@ -613,7 +625,7 @@ The `config.json` file contains the reduced Embeddable JSON with:
 
 5. **Global Components**: Must use the filenames to replace the `_location` property.
 
-6. **Conditions**: Stored in config.json, applied at runtime. Multiple values in one condition = OR, multiple conditions = AND.
+6. **Conditions**: Stored in config.json, applied at runtime. Multiple values in one condition = OR, multiple conditions = AND. For experiment-gated conditions, when setting the control variant's conditions always include both the control variant value and `_no_value` so both control and unassigned users see the intended default.
 
 7. **CSS Selectors**: Must follow exact structure with proper spacing (trailing space on breakpoints, leading space on sub-elements).
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@embeddables/cli",
-  "version": "0.6.9",
+  "version": "0.6.10",
   "type": "module",
   "bin": {
     "embeddables": "./bin/embeddables.mjs"