@rocapine/react-native-onboarding 1.25.1 → 1.27.0

package/dist/steps/Picker/types.d.ts

@@ -47,8 +47,12 @@ export declare const PickerStepTypeSchema: z.ZodObject<{
                     contains: "contains";
                     in: "in";
                     not_in: "not_in";
+                    is_empty: "is_empty";
+                    is_not_empty: "is_not_empty";
+                    is_null: "is_null";
+                    is_not_null: "is_not_null";
                 }>;
-                value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>;
+                value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>>;
             }, z.core.$strip>, z.ZodType<import("../common.types").ConditionGroup, unknown, z.core.$ZodTypeInternals<import("../common.types").ConditionGroup, unknown>>]>>>;
             targetStepId: z.ZodString;
         }, z.core.$strip>>>;

package/dist/steps/Picker/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/steps/Picker/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,cAAc;;;;;;;;EAQzB,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;iBAIlC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAI/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,CAAC;AACrC,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/steps/Picker/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,cAAc;;;;;;;;EAQzB,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;iBAIlC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAI/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,CAAC;AACrC,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,CAAC"}

package/dist/steps/Question/types.d.ts

@@ -46,8 +46,12 @@ export declare const QuestionStepTypeSchema: z.ZodObject<{
                     contains: "contains";
                     in: "in";
                     not_in: "not_in";
+                    is_empty: "is_empty";
+                    is_not_empty: "is_not_empty";
+                    is_null: "is_null";
+                    is_not_null: "is_not_null";
                 }>;
-                value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>;
+                value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>>;
             }, z.core.$strip>, z.ZodType<import("../common.types").ConditionGroup, unknown, z.core.$ZodTypeInternals<import("../common.types").ConditionGroup, unknown>>]>>>;
             targetStepId: z.ZodString;
         }, z.core.$strip>>>;

package/dist/steps/Question/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/steps/Question/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,YAAY;;;;;iBAKvB,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;iBAMpC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAIjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/steps/Question/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,YAAY;;;;;iBAKvB,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;iBAMpC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAIjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/steps/Ratings/types.d.ts

@@ -35,8 +35,12 @@ export declare const RatingsStepTypeSchema: z.ZodObject<{
                     contains: "contains";
                     in: "in";
                     not_in: "not_in";
+                    is_empty: "is_empty";
+                    is_not_empty: "is_not_empty";
+                    is_null: "is_null";
+                    is_not_null: "is_not_null";
                 }>;
-                value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>;
+                value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>>;
             }, z.core.$strip>, z.ZodType<import("../common.types").ConditionGroup, unknown, z.core.$ZodTypeInternals<import("../common.types").ConditionGroup, unknown>>]>>>;
             targetStepId: z.ZodString;
         }, z.core.$strip>>>;

package/dist/steps/Ratings/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/steps/Ratings/types.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAC;AAGpB,eAAO,MAAM,wBAAwB;;;;;;;;;iBAKnC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAGhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/steps/Ratings/types.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAC;AAGpB,eAAO,MAAM,wBAAwB;;;;;;;;;iBAKnC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAGhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/steps/common.types.d.ts

@@ -30,8 +30,18 @@ export declare const ConditionOperatorSchema: z.ZodEnum<{
     contains: "contains";
     in: "in";
     not_in: "not_in";
+    is_empty: "is_empty";
+    is_not_empty: "is_not_empty";
+    is_null: "is_null";
+    is_not_null: "is_not_null";
 }>;
 export type ConditionOperator = z.infer<typeof ConditionOperatorSchema>;
+/**
+ * Operators that test the variable alone and ignore `value`. A LeafCondition
+ * using one of these may omit `value`; all other operators require it.
+ */
+export declare const UNARY_CONDITION_OPERATORS: readonly ["is_empty", "is_not_empty", "is_null", "is_not_null"];
+export declare const isUnaryConditionOperator: (operator: ConditionOperator) => boolean;
 export declare const ConditionValueSchema: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>;
 export type ConditionValue = z.infer<typeof ConditionValueSchema>;
 export declare const LeafConditionSchema: z.ZodObject<{
@@ -46,8 +56,12 @@ export declare const LeafConditionSchema: z.ZodObject<{
         contains: "contains";
         in: "in";
         not_in: "not_in";
+        is_empty: "is_empty";
+        is_not_empty: "is_not_empty";
+        is_null: "is_null";
+        is_not_null: "is_not_null";
     }>;
-    value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>;
+    value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>>;
 }, z.core.$strip>;
 export type LeafCondition = z.infer<typeof LeafConditionSchema>;
 export type ConditionGroup = {
@@ -68,8 +82,12 @@ export declare const BranchSchema: z.ZodObject<{
             contains: "contains";
             in: "in";
             not_in: "not_in";
+            is_empty: "is_empty";
+            is_not_empty: "is_not_empty";
+            is_null: "is_null";
+            is_not_null: "is_not_null";
         }>;
-        value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>;
+        value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>>;
     }, z.core.$strip>, z.ZodType<ConditionGroup, unknown, z.core.$ZodTypeInternals<ConditionGroup, unknown>>]>>>;
     targetStepId: z.ZodString;
 }, z.core.$strip>;
@@ -89,8 +107,12 @@ export declare const NextStepSchema: z.ZodDefault<z.ZodNullable<z.ZodObject<{
                 contains: "contains";
                 in: "in";
                 not_in: "not_in";
+                is_empty: "is_empty";
+                is_not_empty: "is_not_empty";
+                is_null: "is_null";
+                is_not_null: "is_not_null";
             }>;
-            value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>;
+            value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>>;
         }, z.core.$strip>, z.ZodType<ConditionGroup, unknown, z.core.$ZodTypeInternals<ConditionGroup, unknown>>]>>>;
         targetStepId: z.ZodString;
     }, z.core.$strip>>>;
@@ -122,8 +144,12 @@ export declare const BaseStepTypeSchema: z.ZodObject<{
                     contains: "contains";
                     in: "in";
                     not_in: "not_in";
+                    is_empty: "is_empty";
+                    is_not_empty: "is_not_empty";
+                    is_null: "is_null";
+                    is_not_null: "is_not_null";
                 }>;
-                value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>;
+                value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>>;
             }, z.core.$strip>, z.ZodType<ConditionGroup, unknown, z.core.$ZodTypeInternals<ConditionGroup, unknown>>]>>>;
             targetStepId: z.ZodString;
         }, z.core.$strip>>>;

package/dist/steps/common.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"common.types.d.ts","sourceRoot":"","sources":["../../src/steps/common.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,mBAAmB,kEAA0C,CAAC;AAE3E,eAAO,MAAM,iBAAiB;;;;;;mBAS5B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;iBAI5B,CAAC;AAEH,eAAO,MAAM,aAAa;;;iBAGxB,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;iBAG9B,CAAC;AAIH,eAAO,MAAM,uBAAuB;;;;;;;;;;EAUlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,oBAAoB,0IAK/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;iBAI9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,KAAK,CAAC,aAAa,GAAG,cAAc,CAAC,CAAC;CACnD,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAO1D,CAAC;AAEF,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;iBAGvB,CAAC;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;mBAMX,CAAC;AACjB,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAItD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAS7B,CAAC"}
+{"version":3,"file":"common.types.d.ts","sourceRoot":"","sources":["../../src/steps/common.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,mBAAmB,kEAA0C,CAAC;AAE3E,eAAO,MAAM,iBAAiB;;;;;;mBAS5B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;iBAI5B,CAAC;AAEH,eAAO,MAAM,aAAa;;;iBAGxB,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;iBAG9B,CAAC;AAIH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;EAiBlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;;GAGG;AACH,eAAO,MAAM,yBAAyB,iEAKW,CAAC;AAIlD,eAAO,MAAM,wBAAwB,GAAI,UAAU,iBAAiB,KAAG,OACrC,CAAC;AAEnC,eAAO,MAAM,oBAAoB,0IAK/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;iBAc5B,CAAC;AACL,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,KAAK,CAAC,aAAa,GAAG,cAAc,CAAC,CAAC;CACnD,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAO1D,CAAC;AAEF,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;iBAGvB,CAAC;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;mBAMX,CAAC;AACjB,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAItD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAS7B,CAAC"}

package/dist/steps/common.types.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BaseStepTypeSchema = exports.NextStepSchema = exports.BranchSchema = exports.ConditionGroupSchema = exports.LeafConditionSchema = exports.ConditionValueSchema = exports.ConditionOperatorSchema = exports.ButtonSectionSchema = exports.InfoBoxSchema = exports.SocialProofSchema = exports.MediaSourceSchema = exports.CustomPayloadSchema = void 0;
+exports.BaseStepTypeSchema = exports.NextStepSchema = exports.BranchSchema = exports.ConditionGroupSchema = exports.LeafConditionSchema = exports.ConditionValueSchema = exports.isUnaryConditionOperator = exports.UNARY_CONDITION_OPERATORS = exports.ConditionOperatorSchema = exports.ButtonSectionSchema = exports.InfoBoxSchema = exports.SocialProofSchema = exports.MediaSourceSchema = exports.CustomPayloadSchema = void 0;
 const zod_1 = require("zod");
 exports.CustomPayloadSchema = zod_1.z.record(zod_1.z.string(), zod_1.z.any()).nullish();
 exports.MediaSourceSchema = zod_1.z.union([
@@ -37,17 +37,47 @@ exports.ConditionOperatorSchema = zod_1.z.enum([
     "contains",
     "in",
     "not_in",
+    // Unary presence operators — no `value` required. `empty` is type-aware
+    // (empty string / empty array / null|undefined); `null` is strictly
+    // null|undefined (a set-but-empty value is "not null" yet "is empty").
+    "is_empty",
+    "is_not_empty",
+    "is_null",
+    "is_not_null",
 ]);
+/**
+ * Operators that test the variable alone and ignore `value`. A LeafCondition
+ * using one of these may omit `value`; all other operators require it.
+ */
+exports.UNARY_CONDITION_OPERATORS = [
+    "is_empty",
+    "is_not_empty",
+    "is_null",
+    "is_not_null",
+];
+const UNARY_OPERATOR_SET = new Set(exports.UNARY_CONDITION_OPERATORS);
+const isUnaryConditionOperator = (operator) => UNARY_OPERATOR_SET.has(operator);
+exports.isUnaryConditionOperator = isUnaryConditionOperator;
 exports.ConditionValueSchema = zod_1.z.union([
     zod_1.z.string(),
     zod_1.z.number(),
     zod_1.z.boolean(),
     zod_1.z.array(zod_1.z.union([zod_1.z.string(), zod_1.z.number(), zod_1.z.boolean()])),
 ]);
-exports.LeafConditionSchema = zod_1.z.object({
+exports.LeafConditionSchema = zod_1.z
+    .object({
     variable: zod_1.z.string().min(1),
     operator: exports.ConditionOperatorSchema,
-    value: exports.ConditionValueSchema,
+    value: exports.ConditionValueSchema.optional(),
+})
+    .superRefine((data, ctx) => {
+    if (!(0, exports.isUnaryConditionOperator)(data.operator) && data.value === undefined) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            message: `operator "${data.operator}" requires a value`,
+            path: ["value"],
+        });
+    }
 });
 exports.ConditionGroupSchema = zod_1.z.lazy(() => zod_1.z.object({
     logic: zod_1.z.enum(["and", "or"]),

package/dist/steps/common.types.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rocapine/react-native-onboarding",
-  "version": "1.25.1",
+  "version": "1.27.0",
   "description": "Headless React Native SDK for Rocapine Onboarding Studio - Data fetching, state management, and hooks",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -51,7 +51,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/rocapine/react-native-onboarding-studio.git",
+    "url": "https://github.com/Rocapine/react-native-onboarding.git",
     "directory": "packages/onboarding"
   }
 }

package/src/__tests__/evaluateCondition.test.ts

@@ -76,6 +76,41 @@ describe("evaluateLeaf — unknown operator", () => {
   it("returns false for unknown operator", () => expect(evaluateLeaf({ variable: "x", operator: "xor" as any, value: "y" }, { x: "y" })).toBe(false));
 });
 
+describe("evaluateLeaf — unary is_empty / is_not_empty", () => {
+  it("empty string is empty", () => expect(evaluateLeaf({ variable: "x", operator: "is_empty" }, { x: "" })).toBe(true));
+  it("whitespace string is empty", () => expect(evaluateLeaf({ variable: "x", operator: "is_empty" }, { x: "   " })).toBe(true));
+  it("unset variable is empty", () => expect(evaluateLeaf({ variable: "x", operator: "is_empty" }, {})).toBe(true));
+  it("empty array is empty", () => expect(evaluateLeaf({ variable: "x", operator: "is_empty" }, { x: [] })).toBe(true));
+  it("non-empty string is not empty", () => expect(evaluateLeaf({ variable: "x", operator: "is_not_empty" }, { x: "Paul" })).toBe(true));
+  it("zero-string is not empty (0 is a value)", () => expect(evaluateLeaf({ variable: "x", operator: "is_not_empty" }, { x: "0" })).toBe(true));
+  it("populated array is not empty", () => expect(evaluateLeaf({ variable: "x", operator: "is_not_empty" }, { x: ["a"] })).toBe(true));
+  it("is_not_empty is the negation of is_empty", () => expect(evaluateLeaf({ variable: "x", operator: "is_not_empty" }, { x: "" })).toBe(false));
+});
+
+describe("evaluateLeaf — unary is_null / is_not_null", () => {
+  it("unset variable is null", () => expect(evaluateLeaf({ variable: "x", operator: "is_null" }, {})).toBe(true));
+  it("explicit null is null", () => expect(evaluateLeaf({ variable: "x", operator: "is_null" }, { x: null })).toBe(true));
+  it("set-but-empty string is NOT null", () => expect(evaluateLeaf({ variable: "x", operator: "is_not_null" }, { x: "" })).toBe(true));
+  it("set value is not null", () => expect(evaluateLeaf({ variable: "x", operator: "is_not_null" }, { x: "Paul" })).toBe(true));
+  it("unset variable is_not_null is false", () => expect(evaluateLeaf({ variable: "x", operator: "is_not_null" }, {})).toBe(false));
+});
+
+describe("evaluateLeaf — JSON-array-encoded variable values (CheckboxGroup)", () => {
+  // Multi-select stores its value as a JSON string; "[]" is an empty selection.
+  it('empty "[]" reads as empty', () => expect(evaluateLeaf({ variable: "tags", operator: "is_empty" }, { tags: "[]" })).toBe(true));
+  it('empty "[]" is_not_empty is false (gated element falls back on deselect)', () =>
+    expect(evaluateLeaf({ variable: "tags", operator: "is_not_empty" }, { tags: "[]" })).toBe(false));
+  it('non-empty "[\\"a\\"]" is not empty', () => expect(evaluateLeaf({ variable: "tags", operator: "is_not_empty" }, { tags: '["a"]' })).toBe(true));
+  it("contains uses real array membership on encoded value", () =>
+    expect(evaluateLeaf({ variable: "tags", operator: "contains", value: "sport" }, { tags: '["health","sport"]' })).toBe(true));
+  it("contains is false when element absent from encoded array", () =>
+    expect(evaluateLeaf({ variable: "tags", operator: "contains", value: "music" }, { tags: '["health","sport"]' })).toBe(false));
+  it("a plain string that is not a JSON array is left untouched", () =>
+    expect(evaluateLeaf({ variable: "x", operator: "is_not_empty" }, { x: "[oops" })).toBe(true));
+  it("a numeric-looking string is not coerced to empty", () =>
+    expect(evaluateLeaf({ variable: "x", operator: "is_not_empty" }, { x: "5" })).toBe(true));
+});
+
 // ---------------------------------------------------------------------------
 // evaluateCondition — logic groups
 // ---------------------------------------------------------------------------

package/src/evaluateCondition.ts

@@ -10,8 +10,40 @@ function coerceToNumber(v: unknown): number {
   return typeof v === "string" ? parseFloat(v) : Number(v);
 }
 
+// Multi-select elements (e.g. CheckboxGroup) store their value as a JSON-encoded
+// string[] to fit the string-based variable system, so an empty selection is the
+// literal string "[]". Decode such strings back to an array before evaluating so
+// array-aware operators (is_empty / is_not_empty / contains / in / not_in) see the
+// real collection — otherwise "[]" reads as a non-empty 2-char string. Only strings
+// that parse to an actual array are coerced; scalars and plain text are untouched.
+function decodeArrayValue(raw: unknown): unknown {
+  if (typeof raw !== "string") return raw;
+  const trimmed = raw.trim();
+  if (!(trimmed.startsWith("[") && trimmed.endsWith("]"))) return raw;
+  try {
+    const parsed = JSON.parse(trimmed);
+    return Array.isArray(parsed) ? parsed : raw;
+  } catch {
+    return raw;
+  }
+}
+
+// `null`-ness: only null / undefined. A set-but-empty value (e.g. "") is NOT null.
+function isNullish(v: unknown): boolean {
+  return v === null || v === undefined;
+}
+
+// Type-aware emptiness: null|undefined, empty/whitespace string, or empty array.
+// Numbers and booleans are never "empty" (0 / false are meaningful values).
+function isEmpty(v: unknown): boolean {
+  if (isNullish(v)) return true;
+  if (typeof v === "string") return v.trim() === "";
+  if (Array.isArray(v)) return v.length === 0;
+  return false;
+}
+
 export function evaluateLeaf(condition: LeafCondition, variables: Record<string, unknown>): boolean {
-  const raw = variables[condition.variable];
+  const raw = decodeArrayValue(variables[condition.variable]);
   const { operator, value } = condition;
 
   switch (operator) {
@@ -35,6 +67,14 @@ export function evaluateLeaf(condition: LeafCondition, variables: Record<string,
       return Array.isArray(value) ? value.includes(String(raw)) : false;
     case "not_in":
       return Array.isArray(value) ? !value.includes(String(raw)) : true;
+    case "is_empty":
+      return isEmpty(raw);
+    case "is_not_empty":
+      return !isEmpty(raw);
+    case "is_null":
+      return isNullish(raw);
+    case "is_not_null":
+      return !isNullish(raw);
     default:
       return false;
   }

package/src/index.ts

@@ -8,10 +8,16 @@ export type {
   CustomButtonAction,
   ComposableVariableEntry,
   ComposableVariableKind,
+  WheelPickerElementProps,
+  WheelPickerItem,
+  WheelPickerRange,
 } from "./steps/ComposableScreen/types";
 export {
   ButtonActionSchema,
   CustomButtonActionSchema,
+  WheelPickerElementPropsSchema,
+  generateWheelPickerRangeItems,
+  resolveWheelPickerItems,
 } from "./steps/ComposableScreen/types";
 // Hooks and providers
 export * from "./infra";
@@ -35,4 +41,6 @@ export {
   NextStepSchema,
   ConditionOperatorSchema,
   ConditionValueSchema,
+  UNARY_CONDITION_OPERATORS,
+  isUnaryConditionOperator,
 } from "./steps/common.types";

package/src/onboarding-example.ts

@@ -110,6 +110,11 @@ export const onboardingExample = {
             type: "SafeAreaView",
             props: { flex: 1, edges: ["top", "bottom"] },
             children: [
+          {
+            id: "scroll-root",
+            type: "ScrollView",
+            props: { flex: 1, showsVerticalScrollIndicator: false },
+            children: [
           {
             id: "root",
             type: "YStack",
@@ -153,6 +158,8 @@ export const onboardingExample = {
                   name: "Star",
                   size: 48,
                   color: "#007AFF",
+                  fill: "#007AFF",
+                  fillOpacity: 0.2,
                   marginVertical: 8,
                 },
               },
@@ -187,6 +194,21 @@ export const onboardingExample = {
                   },
                 ],
               },
+              {
+                // Only shown once `name` has a non-empty value — demonstrates
+                // the unary `is_not_empty` condition operator.
+                id: "name-greeting",
+                type: "Text",
+                renderWhen: { variable: "name", operator: "is_not_empty" },
+                props: {
+                  content: "Nice to meet you, {{name}}!",
+                  mode: "expression",
+                  fontSize: 14,
+                  textAlign: "center",
+                  opacity: 0.6,
+                  marginVertical: 4,
+                },
+              },
               {
                 id: "scroll-demo",
                 type: "ScrollView",
@@ -429,6 +451,29 @@ export const onboardingExample = {
                   marginVertical: 4,
                 },
               },
+              {
+                id: "hero-weight-wheel",
+                type: "WheelPicker",
+                props: {
+                  variableName: "weight",
+                  defaultValue: "70",
+                  range: { min: 40, max: 200, step: 1, unit: "kg" },
+                  height: 180,
+                  marginVertical: 8,
+                },
+              },
+              {
+                id: "weight-display",
+                type: "Text",
+                props: {
+                  content: "Weight: {{weight}}",
+                  mode: "expression",
+                  fontSize: 14,
+                  textAlign: "center",
+                  opacity: 0.6,
+                  marginVertical: 4,
+                },
+              },
               {
                 id: "hero-carousel",
                 type: "Carousel",
@@ -737,6 +782,8 @@ export const onboardingExample = {
                 },
               },
             ],
+          },
+          ],
           },
             ],
           },

package/src/steps/ComposableScreen/elements/IconElement.ts

@@ -6,6 +6,8 @@ export type IconElementProps = BaseBoxProps & {
   size?: number;
   color?: string;
   strokeWidth?: number;
+  fill?: string;
+  fillOpacity?: number;
   backgroundColor?: string;
 };
 
@@ -14,5 +16,7 @@ export const IconElementPropsSchema = BaseBoxPropsSchema.extend({
   size: z.number().nonnegative().optional(),
   color: z.string().optional(),
   strokeWidth: z.number().nonnegative().optional(),
+  fill: z.string().optional(),
+  fillOpacity: z.number().min(0).max(1).optional(),
   backgroundColor: z.string().optional(),
 });

package/src/steps/ComposableScreen/elements/WheelPickerElement.ts

@@ -0,0 +1,115 @@
+import { z } from "zod";
+import { BaseBoxProps, BaseBoxPropsSchema } from "./BaseBoxProps";
+
+export type WheelPickerItem = { label: string; value: string };
+
+export type WheelPickerRange = {
+  min: number;
+  max: number;
+  step?: number;
+  unit?: string;
+};
+
+export type WheelPickerElementProps = BaseBoxProps & {
+  variableName?: string;
+  defaultValue?: string;
+  /** Explicit option list. Mutually exclusive with `range`. */
+  items?: WheelPickerItem[];
+  /** Numeric range that auto-generates options. Mutually exclusive with `items`. */
+  range?: WheelPickerRange;
+  /** Text color of the wheel items. */
+  itemColor?: string;
+  /** Font size of the wheel items (iOS `itemStyle`). */
+  itemFontSize?: number;
+  /** Font family of the wheel items (iOS `itemStyle`). */
+  itemFontFamily?: string;
+};
+
+// Hard cap on generated range items — guards against runaway ranges
+// (e.g. min 0 / max 1e9 / step 0.01) producing millions of <Picker.Item>.
+const RANGE_MAX_ITEMS = 1000;
+
+/**
+ * Expand a numeric `range` into wheel items. Shared by the UI renderer,
+ * default-collection, and schema validation so all three agree on the exact
+ * generated value set (and its string formatting).
+ */
+export function generateWheelPickerRangeItems(range: WheelPickerRange): WheelPickerItem[] {
+  const step = range.step ?? 1;
+  const items: WheelPickerItem[] = [];
+  if (!(step > 0) || range.max < range.min) return items;
+  for (let i = 0; i < RANGE_MAX_ITEMS; i++) {
+    const raw = range.min + i * step;
+    if (raw > range.max + 1e-9) break;
+    // Trim float accumulation noise (e.g. 0.30000000000000004 → 0.3).
+    const value = Math.round(raw * 1e6) / 1e6;
+    const valueStr = String(value);
+    const label = range.unit ? `${valueStr} ${range.unit}` : valueStr;
+    items.push({ label, value: valueStr });
+  }
+  return items;
+}
+
+/**
+ * Resolve the effective item list for a WheelPicker: explicit `items` win,
+ * otherwise the numeric `range` is expanded. Returns `[]` when neither is set.
+ */
+export function resolveWheelPickerItems(props: WheelPickerElementProps): WheelPickerItem[] {
+  if (props.items && props.items.length > 0) return props.items;
+  if (props.range) return generateWheelPickerRangeItems(props.range);
+  return [];
+}
+
+const WheelPickerItemSchema = z.object({
+  label: z.string().trim().min(1, "item label must not be empty"),
+  value: z.string().trim().min(1, "item value must not be empty"),
+});
+
+const WheelPickerRangeSchema = z.object({
+  min: z.number(),
+  max: z.number(),
+  step: z.number().positive().optional(),
+  unit: z.string().optional(),
+});
+
+export const WheelPickerElementPropsSchema = BaseBoxPropsSchema.extend({
+  variableName: z.string().optional(),
+  defaultValue: z.string().optional(),
+  items: z.array(WheelPickerItemSchema).min(1, "items must not be empty").optional(),
+  range: WheelPickerRangeSchema.optional(),
+  itemColor: z.string().optional(),
+  itemFontSize: z.number().optional(),
+  itemFontFamily: z.string().optional(),
+}).superRefine((data, ctx) => {
+  const hasItems = data.items !== undefined;
+  const hasRange = data.range !== undefined;
+  // Exactly one source must be present — both or neither is ambiguous.
+  if (hasItems === hasRange) {
+    ctx.addIssue({
+      code: z.ZodIssueCode.custom,
+      message: "provide exactly one of `items` or `range`",
+      path: hasItems ? ["range"] : ["items"],
+    });
+    return;
+  }
+  if (hasRange && data.range!.max < data.range!.min) {
+    ctx.addIssue({
+      code: z.ZodIssueCode.custom,
+      message: "range.max must be >= range.min",
+      path: ["range", "max"],
+    });
+    return;
+  }
+  const values = resolveWheelPickerItems(data as WheelPickerElementProps).map((i) => i.value);
+  const unique = new Set(values);
+  if (hasItems && unique.size !== values.length) {
+    ctx.addIssue({ code: z.ZodIssueCode.custom, message: "item values must be unique", path: ["items"] });
+  }
+  if (data.defaultValue !== undefined && !unique.has(data.defaultValue)) {
+    ctx.addIssue({
+      code: z.ZodIssueCode.custom,
+      message: "defaultValue must match one of the available values",
+      path: ["defaultValue"],
+    });
+  }
+});

package/src/steps/ComposableScreen/types.ts

@@ -18,6 +18,7 @@ import { type ButtonElementProps, ButtonElementPropsSchema } from "./elements/Bu
 import { type RadioGroupElementProps, RadioGroupElementPropsSchema } from "./elements/RadioGroupElement";
 import { type CheckboxGroupElementProps, CheckboxGroupElementPropsSchema } from "./elements/CheckboxGroupElement";
 import { type DatePickerElementProps, DatePickerElementPropsSchema } from "./elements/DatePickerElement";
+import { type WheelPickerElementProps, WheelPickerElementPropsSchema } from "./elements/WheelPickerElement";
 import { type CarouselElementProps, CarouselElementPropsSchema } from "./elements/CarouselElement";
 import { type ZStackElementProps, ZStackElementPropsSchema } from "./elements/ZStackElement";
 import { type SafeAreaViewElementProps, SafeAreaViewElementPropsSchema } from "./elements/SafeAreaViewElement";
@@ -42,6 +43,8 @@ export { ButtonActionSchema, CustomButtonActionSchema } from "./elements/ButtonE
 export type { RadioGroupElementProps } from "./elements/RadioGroupElement";
 export type { CheckboxGroupElementProps } from "./elements/CheckboxGroupElement";
 export type { DatePickerElementProps } from "./elements/DatePickerElement";
+export type { WheelPickerElementProps, WheelPickerItem, WheelPickerRange } from "./elements/WheelPickerElement";
+export { WheelPickerElementPropsSchema, generateWheelPickerRangeItems, resolveWheelPickerItems } from "./elements/WheelPickerElement";
 export type { CarouselElementProps } from "./elements/CarouselElement";
 export type { ZStackElementProps } from "./elements/ZStackElement";
 export type { SafeAreaViewElementProps, SafeAreaEdge, SafeAreaEdgeMode } from "./elements/SafeAreaViewElement";
@@ -156,6 +159,13 @@ type UIElement =
       type: "DatePicker";
       props: DatePickerElementProps;
     }
+  | {
+      id: string;
+      name?: string;
+      renderWhen?: LeafCondition | ConditionGroup;
+      type: "WheelPicker";
+      props: WheelPickerElementProps;
+    }
   | {
       id: string;
       name?: string;
@@ -284,6 +294,13 @@ const UIElementSchema: z.ZodType<UIElement> = z.lazy(() =>
       type: z.literal("DatePicker"),
       props: DatePickerElementPropsSchema,
     }),
+    z.object({
+      id: z.string(),
+      name: z.string().optional(),
+      renderWhen: z.union([LeafConditionSchema, ConditionGroupSchema]).optional(),
+      type: z.literal("WheelPicker"),
+      props: WheelPickerElementPropsSchema,
+    }),
     z.object({
       id: z.string(),
       name: z.string().optional(),