@constela/core 0.12.1 → 0.12.3

package/dist/index.d.ts

@@ -395,7 +395,16 @@ interface FocusStep {
     onSuccess?: ActionStep[];
     onError?: ActionStep[];
 }
-type ActionStep = SetStep | UpdateStep | SetPathStep | FetchStep | StorageStep | ClipboardStep | NavigateStep | ImportStep | CallStep | SubscribeStep | DisposeStep | DomStep | SendStep | CloseStep | DelayStep | IntervalStep | ClearTimerStep | FocusStep;
+/**
+ * If step - conditional action execution
+ */
+interface IfStep {
+    do: 'if';
+    condition: Expression;
+    then: ActionStep[];
+    else?: ActionStep[];
+}
+type ActionStep = SetStep | UpdateStep | SetPathStep | FetchStep | StorageStep | ClipboardStep | NavigateStep | ImportStep | CallStep | SubscribeStep | DisposeStep | DomStep | SendStep | CloseStep | DelayStep | IntervalStep | ClearTimerStep | FocusStep | IfStep;
 type LocalActionStep = SetStep | UpdateStep | SetPathStep;
 /**
  * Event handler options for special events like intersect
@@ -411,7 +420,7 @@ interface EventHandlerOptions {
 interface EventHandler {
     event: string;
     action: string;
-    payload?: Expression;
+    payload?: Expression | Record<string, Expression>;
     debounce?: number;
     throttle?: number;
     options?: EventHandlerOptions;
@@ -1567,6 +1576,8 @@ declare const astSchema: {
                 readonly $ref: "#/$defs/ClearTimerStep";
             }, {
                 readonly $ref: "#/$defs/FocusStep";
+            }, {
+                readonly $ref: "#/$defs/IfStep";
             }];
         };
         readonly SetStep: {
@@ -1736,6 +1747,32 @@ declare const astSchema: {
                 };
             };
         };
+        readonly IfStep: {
+            readonly type: "object";
+            readonly required: readonly ["do", "condition", "then"];
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly do: {
+                    readonly type: "string";
+                    readonly const: "if";
+                };
+                readonly condition: {
+                    readonly $ref: "#/$defs/Expression";
+                };
+                readonly then: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly $ref: "#/$defs/ActionStep";
+                    };
+                };
+                readonly else: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly $ref: "#/$defs/ActionStep";
+                    };
+                };
+            };
+        };
         readonly EventHandler: {
             readonly type: "object";
             readonly required: readonly ["event", "action"];
@@ -2024,4 +2061,4 @@ declare const astSchema: {
     };
 };
 
-export { type ActionDefinition, type ActionStep, BINARY_OPERATORS, type BinExpr, type BinaryOperator, type BooleanField, CLIPBOARD_OPERATIONS, type CallStep, type ClearTimerStep, type ClipboardOperation, type ClipboardStep, type CloseStep, type CodeNode, type ComponentDef, type ComponentNode, type ComponentsRef, type CompoundVariant, type ConcatExpr, type CondExpr, type ConstelaAst, ConstelaError, type ConstelaProgram, type CookieInitialExpr, DATA_SOURCE_TYPES, DATA_TRANSFORMS, type DataExpr, type DataSource, type DataSourceType, type DataTransform, type DelayStep, type DisposeStep, type DomStep, type EachNode, type ElementNode, type ErrorCode, type ErrorOptions, type EventHandler, type EventHandlerOptions, type Expression, FOCUS_OPERATIONS, type FetchStep, type FocusOperation, type FocusStep, type GetExpr, HTTP_METHODS, type HttpMethod, type IfNode, type ImportExpr, type ImportStep, type IntervalStep, type LayoutProgram, type LifecycleHooks, type ListField, type LitExpr, type LocalActionDefinition, type LocalActionStep, type MarkdownNode, NAVIGATE_TARGETS, type NavigateStep, type NavigateTarget, type NotExpr, type NumberField, type ObjectField, PARAM_TYPES, type ParamDef, type ParamExpr, type ParamType, type PortalNode, type Program, type RefExpr, type RouteDefinition, type RouteExpr, STORAGE_OPERATIONS, STORAGE_TYPES, type SendStep, type SetPathStep, type SetStep, type SlotNode, type StateExpr, type StateField, type StaticPathsDefinition, type StorageOperation, type StorageStep, type StorageType, type StringField, type StyleExpr, type StylePreset, type SubscribeStep, type TextNode, UPDATE_OPERATIONS, type UpdateOperation, type UpdateStep, VALIDITY_PROPERTIES, type ValidationFailure, type ValidationResult, type ValidationSuccess, type ValidityExpr, type ValidityProperty, type VarExpr, type ViewNode, astSchema, createClipboardWriteMissingValueError, createComponentCycleError, createComponentNotFoundError, createComponentPropMissingError, createComponentPropTypeError, createCondElseRequiredError, createDataNotDefinedError, createDuplicateActionError, createDuplicateDefaultSlotError, createDuplicateSlotNameError, createImportsNotDefinedError, createInvalidClipboardOperationError, createInvalidDataSourceError, createInvalidNavigateTargetError, createInvalidSlotNameError, createInvalidStorageOperationError, createInvalidStorageTypeError, createLayoutMissingSlotError, createLayoutNotFoundError, createLocalActionInvalidStepError, createOperationInvalidForTypeError, createOperationMissingFieldError, createOperationUnknownError, createRouteNotDefinedError, createSchemaError, createSlotInLoopError, createStorageSetMissingValueError, createUndefinedActionError, createUndefinedDataError, createUndefinedDataSourceError, createUndefinedImportError, createUndefinedLocalStateError, createUndefinedParamError, createUndefinedRefError, createUndefinedRouteParamError, createUndefinedStateError, createUndefinedStyleError, createUndefinedVarError, createUndefinedVariantError, createUnsupportedVersionError, findSimilarNames, isActionStep, isBinExpr, isBooleanField, isCallStep, isClipboardStep, isCodeNode, isComponentNode, isConcatExpr, isCondExpr, isConstelaError, isCookieInitialExpr, isDataExpr, isDataSource, isDisposeStep, isEachNode, isElementNode, isEventHandler, isExpression, isFetchStep, isFocusStep, isGetExpr, isIfNode, isImportExpr, isImportStep, isLayoutProgram, isLifecycleHooks, isListField, isLitExpr, isLocalActionDefinition, isLocalActionStep, isMarkdownNode, isNamedSlotNode, isNavigateStep, isNotExpr, isNumberField, isObjectField, isParamExpr, isPortalNode, isRefExpr, isRouteDefinition, isRouteExpr, isSetPathStep, isSetStep, isSlotNode, isStateExpr, isStateField, isStaticPathsDefinition, isStorageStep, isStringField, isStyleExpr, isSubscribeStep, isTextNode, isUpdateStep, isValidityExpr, isVarExpr, isViewNode, validateAst };
+export { type ActionDefinition, type ActionStep, BINARY_OPERATORS, type BinExpr, type BinaryOperator, type BooleanField, CLIPBOARD_OPERATIONS, type CallStep, type ClearTimerStep, type ClipboardOperation, type ClipboardStep, type CloseStep, type CodeNode, type ComponentDef, type ComponentNode, type ComponentsRef, type CompoundVariant, type ConcatExpr, type CondExpr, type ConstelaAst, ConstelaError, type ConstelaProgram, type CookieInitialExpr, DATA_SOURCE_TYPES, DATA_TRANSFORMS, type DataExpr, type DataSource, type DataSourceType, type DataTransform, type DelayStep, type DisposeStep, type DomStep, type EachNode, type ElementNode, type ErrorCode, type ErrorOptions, type EventHandler, type EventHandlerOptions, type Expression, FOCUS_OPERATIONS, type FetchStep, type FocusOperation, type FocusStep, type GetExpr, HTTP_METHODS, type HttpMethod, type IfNode, type IfStep, type ImportExpr, type ImportStep, type IntervalStep, type LayoutProgram, type LifecycleHooks, type ListField, type LitExpr, type LocalActionDefinition, type LocalActionStep, type MarkdownNode, NAVIGATE_TARGETS, type NavigateStep, type NavigateTarget, type NotExpr, type NumberField, type ObjectField, PARAM_TYPES, type ParamDef, type ParamExpr, type ParamType, type PortalNode, type Program, type RefExpr, type RouteDefinition, type RouteExpr, STORAGE_OPERATIONS, STORAGE_TYPES, type SendStep, type SetPathStep, type SetStep, type SlotNode, type StateExpr, type StateField, type StaticPathsDefinition, type StorageOperation, type StorageStep, type StorageType, type StringField, type StyleExpr, type StylePreset, type SubscribeStep, type TextNode, UPDATE_OPERATIONS, type UpdateOperation, type UpdateStep, VALIDITY_PROPERTIES, type ValidationFailure, type ValidationResult, type ValidationSuccess, type ValidityExpr, type ValidityProperty, type VarExpr, type ViewNode, astSchema, createClipboardWriteMissingValueError, createComponentCycleError, createComponentNotFoundError, createComponentPropMissingError, createComponentPropTypeError, createCondElseRequiredError, createDataNotDefinedError, createDuplicateActionError, createDuplicateDefaultSlotError, createDuplicateSlotNameError, createImportsNotDefinedError, createInvalidClipboardOperationError, createInvalidDataSourceError, createInvalidNavigateTargetError, createInvalidSlotNameError, createInvalidStorageOperationError, createInvalidStorageTypeError, createLayoutMissingSlotError, createLayoutNotFoundError, createLocalActionInvalidStepError, createOperationInvalidForTypeError, createOperationMissingFieldError, createOperationUnknownError, createRouteNotDefinedError, createSchemaError, createSlotInLoopError, createStorageSetMissingValueError, createUndefinedActionError, createUndefinedDataError, createUndefinedDataSourceError, createUndefinedImportError, createUndefinedLocalStateError, createUndefinedParamError, createUndefinedRefError, createUndefinedRouteParamError, createUndefinedStateError, createUndefinedStyleError, createUndefinedVarError, createUndefinedVariantError, createUnsupportedVersionError, findSimilarNames, isActionStep, isBinExpr, isBooleanField, isCallStep, isClipboardStep, isCodeNode, isComponentNode, isConcatExpr, isCondExpr, isConstelaError, isCookieInitialExpr, isDataExpr, isDataSource, isDisposeStep, isEachNode, isElementNode, isEventHandler, isExpression, isFetchStep, isFocusStep, isGetExpr, isIfNode, isImportExpr, isImportStep, isLayoutProgram, isLifecycleHooks, isListField, isLitExpr, isLocalActionDefinition, isLocalActionStep, isMarkdownNode, isNamedSlotNode, isNavigateStep, isNotExpr, isNumberField, isObjectField, isParamExpr, isPortalNode, isRefExpr, isRouteDefinition, isRouteExpr, isSetPathStep, isSetStep, isSlotNode, isStateExpr, isStateField, isStaticPathsDefinition, isStorageStep, isStringField, isStyleExpr, isSubscribeStep, isTextNode, isUpdateStep, isValidityExpr, isVarExpr, isViewNode, validateAst };

package/dist/index.js

@@ -842,7 +842,7 @@ function isObject2(value) {
 var VALID_VIEW_KINDS = ["element", "text", "if", "each", "component", "slot", "markdown", "code", "portal"];
 var VALID_EXPR_TYPES = ["lit", "state", "var", "bin", "not", "param", "cond", "get", "style", "validity", "index"];
 var VALID_PARAM_TYPES = ["string", "number", "boolean", "json"];
-var VALID_ACTION_TYPES = ["set", "update", "fetch", "delay", "interval", "clearTimer", "focus"];
+var VALID_ACTION_TYPES = ["set", "update", "fetch", "delay", "interval", "clearTimer", "focus", "if"];
 var VALID_STATE_TYPES = ["number", "string", "list", "boolean", "object"];
 var VALID_BIN_OPS = BINARY_OPERATORS;
 var VALID_UPDATE_OPS = UPDATE_OPERATIONS;
@@ -1097,7 +1097,7 @@ function validateActionStep(step, path) {
     return { path: path + "/do", message: "do is required" };
   }
   if (!VALID_ACTION_TYPES.includes(doType)) {
-    return { path: path + "/do", message: "must be one of: set, update, fetch, delay, interval, clearTimer, focus" };
+    return { path: path + "/do", message: "must be one of: set, update, fetch, delay, interval, clearTimer, focus, if" };
   }
   switch (doType) {
     case "set":
@@ -1184,6 +1184,34 @@ function validateActionStep(step, path) {
         return { path: path + "/operation", message: "operation is required" };
       }
       return validateExpression(step["target"], path + "/target");
+    case "if":
+      if (!("condition" in step)) {
+        return { path: path + "/condition", message: "condition is required" };
+      }
+      if (!("then" in step)) {
+        return { path: path + "/then", message: "then is required" };
+      }
+      {
+        const condError = validateExpression(step["condition"], path + "/condition");
+        if (condError) return condError;
+        if (!Array.isArray(step["then"])) {
+          return { path: path + "/then", message: "then must be an array" };
+        }
+        for (let i = 0; i < step["then"].length; i++) {
+          const thenError = validateActionStep(step["then"][i], path + "/then/" + i);
+          if (thenError) return thenError;
+        }
+        if ("else" in step) {
+          if (!Array.isArray(step["else"])) {
+            return { path: path + "/else", message: "else must be an array" };
+          }
+          for (let i = 0; i < step["else"].length; i++) {
+            const elseError = validateActionStep(step["else"][i], path + "/else/" + i);
+            if (elseError) return elseError;
+          }
+        }
+      }
+      break;
   }
   return null;
 }
@@ -1838,7 +1866,8 @@ var astSchema = {
         { $ref: "#/$defs/DelayStep" },
         { $ref: "#/$defs/IntervalStep" },
         { $ref: "#/$defs/ClearTimerStep" },
-        { $ref: "#/$defs/FocusStep" }
+        { $ref: "#/$defs/FocusStep" },
+        { $ref: "#/$defs/IfStep" }
       ]
     },
     SetStep: {
@@ -1945,6 +1974,23 @@ var astSchema = {
         }
       }
     },
+    IfStep: {
+      type: "object",
+      required: ["do", "condition", "then"],
+      additionalProperties: false,
+      properties: {
+        do: { type: "string", const: "if" },
+        condition: { $ref: "#/$defs/Expression" },
+        then: {
+          type: "array",
+          items: { $ref: "#/$defs/ActionStep" }
+        },
+        else: {
+          type: "array",
+          items: { $ref: "#/$defs/ActionStep" }
+        }
+      }
+    },
     // ==================== Event Handler ====================
     EventHandler: {
       type: "object",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constela/core",
-  "version": "0.12.1",
+  "version": "0.12.3",
   "description": "Core types, schema, and validator for Constela UI framework",
   "type": "module",
   "main": "./dist/index.js",