@constela/core 0.14.0 → 0.15.1

package/README.md

@@ -60,7 +60,7 @@ String state can use a cookie expression to read initial value from cookies (SSR
 
 ## Expression Types
 
-15 expression types for constrained computation:
+18 expression types for constrained computation:
 
 | Type | JSON Example | Description |
 |------|-------------|-------------|
@@ -79,6 +79,9 @@ String state can use a cookie expression to read initial value from cookies (SSR
 | `style` | `{ "expr": "style", "name": "button", "variants": {...} }` | Style reference |
 | `concat` | `{ "expr": "concat", "items": [...] }` | String concatenation |
 | `cookie` | `{ "expr": "cookie", "key": "theme", "default": "dark" }` | Cookie value (SSR-safe) |
+| `call` | `{ "expr": "call", "target": ..., "method": "filter", "args": [...] }` | Method call |
+| `lambda` | `{ "expr": "lambda", "param": "item", "body": ... }` | Anonymous function |
+| `array` | `{ "expr": "array", "elements": [...] }` | Array construction |
 
 **Binary Operators:** `+`, `-`, `*`, `/`, `==`, `!=`, `<`, `<=`, `>`, `>=`, `&&`, `||`
 
@@ -101,6 +104,25 @@ Concatenate multiple expressions into a single string:
 - `null`/`undefined` values become empty strings
 - Numbers and booleans are converted to strings
 
+**Array Expression:**
+
+Construct arrays dynamically from expressions:
+
+```json
+{
+  "expr": "array",
+  "elements": [
+    { "expr": "var", "name": "basicSetup" },
+    { "expr": "call", "target": { "expr": "var", "name": "json" }, "method": "apply", "args": [] },
+    { "expr": "state", "name": "config" }
+  ]
+}
+```
+
+- Each element can be any expression type
+- Elements are evaluated and collected into an array
+- Useful for dynamic configurations (e.g., CodeMirror extensions: `[basicSetup, json()]`)
+
 ## View Node Types
 
 8 node types for building UI:

package/dist/index.d.ts

@@ -172,7 +172,14 @@ interface LambdaExpr {
     index?: string;
     body: Expression;
 }
-type Expression = LitExpr | StateExpr | VarExpr | BinExpr | NotExpr | ParamExpr | CondExpr | GetExpr | RouteExpr | ImportExpr | DataExpr | RefExpr | IndexExpr | StyleExpr | ConcatExpr | ValidityExpr | CallExpr | LambdaExpr;
+/**
+ * Array expression - constructs an array from expressions
+ */
+interface ArrayExpr {
+    expr: 'array';
+    elements: Expression[];
+}
+type Expression = LitExpr | StateExpr | VarExpr | BinExpr | NotExpr | ParamExpr | CondExpr | GetExpr | RouteExpr | ImportExpr | DataExpr | RefExpr | IndexExpr | StyleExpr | ConcatExpr | ValidityExpr | CallExpr | LambdaExpr | ArrayExpr;
 /**
  * Cookie expression for state initial value
  */
@@ -747,6 +754,10 @@ declare function isStyleExpr(value: unknown): value is StyleExpr;
  * Checks if value is a concat expression
  */
 declare function isConcatExpr(value: unknown): value is ConcatExpr;
+/**
+ * Checks if value is an array expression
+ */
+declare function isArrayExpr(value: unknown): value is ArrayExpr;
 /**
  * Checks if value is a validity expression
  */
@@ -2092,4 +2103,4 @@ declare const astSchema: {
     };
 };
 
-export { type ActionDefinition, type ActionStep, BINARY_OPERATORS, type BinExpr, type BinaryOperator, type BooleanField, CLIPBOARD_OPERATIONS, type CallExpr, 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 IndexExpr, type IntervalStep, type LambdaExpr, 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, type ArrayExpr, BINARY_OPERATORS, type BinExpr, type BinaryOperator, type BooleanField, CLIPBOARD_OPERATIONS, type CallExpr, 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 IndexExpr, type IntervalStep, type LambdaExpr, 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, isArrayExpr, 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

@@ -155,6 +155,9 @@ function isStyleExpr(value) {
 function isConcatExpr(value) {
   return typeof value === "object" && value !== null && value.expr === "concat" && Array.isArray(value.items);
 }
+function isArrayExpr(value) {
+  return typeof value === "object" && value !== null && value.expr === "array" && Array.isArray(value.elements);
+}
 function isValidityExpr(value) {
   if (!isObject(value)) return false;
   if (value["expr"] !== "validity") return false;
@@ -202,7 +205,7 @@ function isRouteDefinition(value) {
   return true;
 }
 function isExpression(value) {
-  return isLitExpr(value) || isStateExpr(value) || isVarExpr(value) || isBinExpr(value) || isNotExpr(value) || isParamExpr(value) || isCondExpr(value) || isGetExpr(value) || isRouteExpr(value) || isImportExpr(value) || isDataExpr(value) || isRefExpr(value) || isIndexExpr(value) || isStyleExpr(value) || isConcatExpr(value) || isValidityExpr(value);
+  return isLitExpr(value) || isStateExpr(value) || isVarExpr(value) || isBinExpr(value) || isNotExpr(value) || isParamExpr(value) || isCondExpr(value) || isGetExpr(value) || isRouteExpr(value) || isImportExpr(value) || isDataExpr(value) || isRefExpr(value) || isIndexExpr(value) || isStyleExpr(value) || isConcatExpr(value) || isValidityExpr(value) || isArrayExpr(value);
 }
 function isElementNode(value) {
   if (!isObject(value)) return false;
@@ -840,9 +843,9 @@ function isObject2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(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", "call", "lambda"];
+var VALID_EXPR_TYPES = ["lit", "state", "var", "bin", "not", "param", "cond", "get", "style", "validity", "index", "call", "lambda", "array"];
 var VALID_PARAM_TYPES = ["string", "number", "boolean", "json"];
-var VALID_ACTION_TYPES = ["set", "update", "fetch", "delay", "interval", "clearTimer", "focus", "if"];
+var VALID_ACTION_TYPES = ["set", "update", "setPath", "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;
@@ -978,7 +981,7 @@ function validateExpression(expr, path) {
     return { path: path + "/expr", message: "expr is required" };
   }
   if (!VALID_EXPR_TYPES.includes(exprType)) {
-    return { path: path + "/expr", message: "must be one of: lit, state, var, bin, not, param, cond, get, style, validity, index, call, lambda" };
+    return { path: path + "/expr", message: `must be one of: ${VALID_EXPR_TYPES.join(", ")}` };
   }
   switch (exprType) {
     case "lit":
@@ -1121,6 +1124,18 @@ function validateExpression(expr, path) {
         if (bodyError) return bodyError;
       }
       break;
+    case "array":
+      if (!("elements" in expr)) {
+        return { path: path + "/elements", message: "elements is required" };
+      }
+      if (!Array.isArray(expr["elements"])) {
+        return { path: path + "/elements", message: "elements must be an array" };
+      }
+      for (let i = 0; i < expr["elements"].length; i++) {
+        const elemError = validateExpression(expr["elements"][i], path + "/elements/" + i);
+        if (elemError) return elemError;
+      }
+      break;
   }
   return null;
 }
@@ -1133,7 +1148,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, if" };
+    return { path: path + "/do", message: `must be one of: ${VALID_ACTION_TYPES.join(", ")}` };
   }
   switch (doType) {
     case "set":
@@ -1158,6 +1173,24 @@ function validateActionStep(step, path) {
         return validateExpression(step["value"], path + "/value");
       }
       break;
+    case "setPath":
+      if (typeof step["target"] !== "string") {
+        return { path: path + "/target", message: "target is required" };
+      }
+      if (!("path" in step)) {
+        return { path: path + "/path", message: "path is required" };
+      }
+      {
+        const pathError = validateExpression(step["path"], path + "/path");
+        if (pathError) return pathError;
+      }
+      if (!("field" in step) || typeof step["field"] !== "string") {
+        return { path: path + "/field", message: "field is required" };
+      }
+      if (!("value" in step)) {
+        return { path: path + "/value", message: "value is required" };
+      }
+      return validateExpression(step["value"], path + "/value");
     case "fetch":
       if (!("url" in step)) {
         return { path: path + "/url", message: "url is required" };
@@ -2273,6 +2306,7 @@ export {
   createUnsupportedVersionError,
   findSimilarNames,
   isActionStep,
+  isArrayExpr,
   isBinExpr,
   isBooleanField,
   isCallStep,

package/package.json

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