@embeddables/cli 0.6.9 → 0.6.11

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/dist/commands/branch.js

@@ -38,10 +38,10 @@ export async function runBranch(opts) {
     console.log('');
     // Pull the selected branch
     if (selectedBranch === null) {
-        // User selected "main" - pull without branch
+        // User selected "main" - pull main and clear saved branch
         console.log(pc.cyan('Switching to main (latest published version)...'));
         console.log('');
-        await runPull({ id: embeddableId });
+        await runPull({ id: embeddableId, useMain: true });
     }
     else {
         console.log(pc.cyan(`Switching to branch: ${selectedBranch.name}...`));

package/dist/commands/pull.d.ts

@@ -3,6 +3,8 @@ export type RunPullOptions = {
     out?: string;
     branch?: string;
     branchName?: string;
+    /** When true, pull main and clear saved branch (e.g. when user explicitly selects "main" in branch switcher). */
+    useMain?: boolean;
     fix?: boolean;
     preserve?: boolean;
 };

package/dist/commands/pull.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pull.d.ts","sourceRoot":"","sources":["../../src/commands/pull.ts"],"names":[],"mappings":"AAgHA,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,cAAc,iBAiQjD"}
+{"version":3,"file":"pull.d.ts","sourceRoot":"","sources":["../../src/commands/pull.ts"],"names":[],"mappings":"AAgHA,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iHAAiH;IACjH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,cAAc,iBAkQjD"}

package/dist/commands/pull.js

@@ -153,10 +153,10 @@ export async function runPull(opts) {
         embeddableId = selected;
         console.log('');
     }
-    // Stay on current branch when no --branch: use config's _branch_id if set
-    const currentFromConfig = opts.branch == null ? getCurrentBranchFromConfig(embeddableId) : null;
-    const effectiveBranch = opts.branch ?? currentFromConfig?.branchId;
-    const effectiveBranchName = opts.branchName ?? currentFromConfig?.branchName;
+    // When useMain, pull main and ignore/clear saved branch. Otherwise stay on current branch when no --branch.
+    const currentFromConfig = opts.useMain || opts.branch != null ? null : getCurrentBranchFromConfig(embeddableId);
+    const effectiveBranch = opts.useMain ? undefined : (opts.branch ?? currentFromConfig?.branchId);
+    const effectiveBranchName = opts.useMain ? undefined : (opts.branchName ?? currentFromConfig?.branchName);
     let url = `https://engine.embeddables.com/${embeddableId}?version=latest`;
     if (effectiveBranch) {
         url += `&embeddable_branch=${effectiveBranch}`;

package/package.json

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