@constela/core 0.21.4 → 0.22.0

package/dist/index.d.ts

@@ -2469,4 +2469,60 @@ declare const GLOBAL_FUNCTIONS: Record<string, (...args: unknown[]) => unknown>;
  */
 declare function callGlobalFunction(method: string, args: unknown[]): unknown;
 
-export { AI_OUTPUT_TYPES, AI_PROVIDER_TYPES, type ActionDefinition, type ActionStep, type AiDataSource, type AiOutputType, type AiProviderType, type ArrayExpr, BINARY_OPERATORS, type BinExpr, type BinaryOperator, type BindStep, type BooleanField, CLIPBOARD_OPERATIONS, COLOR_SCHEMES, type CalendarDay, type CallExpr, type CallStep, type ClearTimerStep, type ClipboardOperation, type ClipboardStep, type CloseStep, type CodeNode, type ColorScheme, type ComponentDef, type ComponentNode, type ComponentsRef, type CompoundVariant, type ConcatExpr, type CondExpr, type ConfirmStep, 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 ErrorBoundaryNode, type ErrorCode, type ErrorOptions, type EventHandler, type EventHandlerOptions, type Expression, FOCUS_OPERATIONS, type FetchStep, type FlushStrategy, type FocusOperation, type FocusStep, GLOBAL_FUNCTIONS, type GenerateStep, type GetExpr, HTTP_METHODS, type HttpMethod, ISLAND_STRATEGIES, type IfNode, type IfStep, type ImportExpr, type ImportStep, type IndexExpr, type IntervalStep, type IslandNode, type IslandStrategy, type IslandStrategyOptions, type LambdaExpr, type LayoutProgram, type LifecycleHooks, type ListField, type LitExpr, type LocalActionDefinition, type LocalActionStep, type LocalExpr, type MarkdownNode, NAVIGATE_TARGETS, type NavigateStep, type NavigateTarget, type NotExpr, type NumberField, type ObjExpr, type ObjectField, type OptimisticStep, PARAM_TYPES, type ParamDef, type ParamExpr, type ParamType, type PortalNode, type Program, type ReconnectConfig, type RefExpr, type RejectStep, type RouteDefinition, type RouteExpr, type SSECloseStep, type SSEConnectStep, 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 StreamChunk, type StreamChunkType, type StreamingRenderOptions, type StringField, type StyleExpr, type StylePreset, type SubscribeStep, type SuspenseBoundary, type SuspenseNode, type TextNode, type ThemeColors, type ThemeConfig, type ThemeFonts, UPDATE_OPERATIONS, type UnbindStep, type UpdateOperation, type UpdateStep, VALIDITY_PROPERTIES, type ValidationFailure, type ValidationResult, type ValidationSuccess, type ValidityExpr, type ValidityProperty, type VarExpr, type ViewNode, astSchema, callGlobalFunction, createClipboardWriteMissingValueError, createComponentCycleError, createComponentNotFoundError, createComponentPropMissingError, createComponentPropTypeError, createCondElseRequiredError, createDataNotDefinedError, createDuplicateActionError, createDuplicateDefaultSlotError, createDuplicateIslandIdError, 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, isAiDataSource, isArrayExpr, isBinExpr, isBooleanField, isCallStep, isClipboardStep, isCodeNode, isColorScheme, isComponentNode, isConcatExpr, isCondExpr, isConstelaError, isCookieInitialExpr, isDataExpr, isDataSource, isDisposeStep, isEachNode, isElementNode, isErrorBoundaryNode, isEventHandler, isExpression, isFetchStep, isFocusStep, isGenerateStep, isGetExpr, isIfNode, isImportExpr, isImportStep, isIslandNode, isIslandStrategy, isIslandStrategyOptions, isLayoutProgram, isLifecycleHooks, isListField, isLitExpr, isLocalActionDefinition, isLocalActionStep, isMarkdownNode, isNamedSlotNode, isNavigateStep, isNotExpr, isNumberField, isObjectField, isParamExpr, isPortalNode, isRefExpr, isRouteDefinition, isRouteExpr, isSetPathStep, isSetStep, isSlotNode, isStateExpr, isStateField, isStaticPathsDefinition, isStorageStep, isStreamChunk, isStreamingRenderOptions, isStringField, isStyleExpr, isSubscribeStep, isSuspenseBoundary, isSuspenseNode, isTextNode, isThemeColors, isThemeConfig, isThemeFonts, isUpdateStep, isValidityExpr, isVarExpr, isViewNode, validateAst };
+/**
+ * Types for the unified evaluate module.
+ *
+ * StateReader: abstracts Map.get() and StateStore.get()
+ * EnvironmentAdapter: abstracts SSR/CSR differences
+ * CoreEvaluationContext: the evaluation context consumed by evaluate()
+ */
+
+interface StateReader {
+    get(name: string): unknown;
+}
+interface EnvironmentAdapter {
+    resolveRef(name: string): unknown;
+    resolveValidity(ref: string, property?: string): unknown;
+    resolveGlobal(name: string): unknown;
+    bindFunction?(value: Function, parent: unknown): unknown;
+    callFunction?(target: Function, args: unknown[]): unknown;
+}
+interface CoreEvaluationContext {
+    state: StateReader;
+    locals: Record<string, unknown>;
+    route?: {
+        params: Record<string, string>;
+        query: Record<string, string>;
+        path: string;
+    } | undefined;
+    imports?: Record<string, unknown> | undefined;
+    styles?: Record<string, StylePreset> | undefined;
+    env: EnvironmentAdapter;
+}
+
+/**
+ * Unified Expression Evaluator
+ *
+ * Single source of truth for evaluating compiled expressions.
+ * SSR/CSR differences are abstracted via EnvironmentAdapter.
+ *
+ * Based on runtime/evaluator.ts (most complete implementation)
+ * with bug fixes from the unification plan.
+ */
+
+declare function evaluate(expr: unknown, ctx: CoreEvaluationContext): unknown;
+declare function evaluateStyle(expr: unknown, ctx: CoreEvaluationContext): string;
+
+/**
+ * Constants for the unified evaluate module.
+ *
+ * Extracted from runtime/evaluator.ts, server/renderer.ts, server/streaming.ts
+ */
+declare const SAFE_ARRAY_METHODS: Set<string>;
+declare const SAFE_STRING_METHODS: Set<string>;
+declare const SAFE_MATH_METHODS: Set<string>;
+declare const SAFE_DATE_STATIC_METHODS: Set<string>;
+declare const SAFE_DATE_INSTANCE_METHODS: Set<string>;
+declare const FORBIDDEN_KEYS: Set<string>;
+
+export { AI_OUTPUT_TYPES, AI_PROVIDER_TYPES, type ActionDefinition, type ActionStep, type AiDataSource, type AiOutputType, type AiProviderType, type ArrayExpr, BINARY_OPERATORS, type BinExpr, type BinaryOperator, type BindStep, type BooleanField, CLIPBOARD_OPERATIONS, COLOR_SCHEMES, type CalendarDay, type CallExpr, type CallStep, type ClearTimerStep, type ClipboardOperation, type ClipboardStep, type CloseStep, type CodeNode, type ColorScheme, type ComponentDef, type ComponentNode, type ComponentsRef, type CompoundVariant, type ConcatExpr, type CondExpr, type ConfirmStep, type ConstelaAst, ConstelaError, type ConstelaProgram, type CookieInitialExpr, type CoreEvaluationContext, DATA_SOURCE_TYPES, DATA_TRANSFORMS, type DataExpr, type DataSource, type DataSourceType, type DataTransform, type DelayStep, type DisposeStep, type DomStep, type EachNode, type ElementNode, type EnvironmentAdapter, type ErrorBoundaryNode, type ErrorCode, type ErrorOptions, type EventHandler, type EventHandlerOptions, type Expression, FOCUS_OPERATIONS, FORBIDDEN_KEYS, type FetchStep, type FlushStrategy, type FocusOperation, type FocusStep, GLOBAL_FUNCTIONS, type GenerateStep, type GetExpr, HTTP_METHODS, type HttpMethod, ISLAND_STRATEGIES, type IfNode, type IfStep, type ImportExpr, type ImportStep, type IndexExpr, type IntervalStep, type IslandNode, type IslandStrategy, type IslandStrategyOptions, type LambdaExpr, type LayoutProgram, type LifecycleHooks, type ListField, type LitExpr, type LocalActionDefinition, type LocalActionStep, type LocalExpr, type MarkdownNode, NAVIGATE_TARGETS, type NavigateStep, type NavigateTarget, type NotExpr, type NumberField, type ObjExpr, type ObjectField, type OptimisticStep, PARAM_TYPES, type ParamDef, type ParamExpr, type ParamType, type PortalNode, type Program, type ReconnectConfig, type RefExpr, type RejectStep, type RouteDefinition, type RouteExpr, SAFE_ARRAY_METHODS, SAFE_DATE_INSTANCE_METHODS, SAFE_DATE_STATIC_METHODS, SAFE_MATH_METHODS, SAFE_STRING_METHODS, type SSECloseStep, type SSEConnectStep, STORAGE_OPERATIONS, STORAGE_TYPES, type SendStep, type SetPathStep, type SetStep, type SlotNode, type StateExpr, type StateField, type StateReader, type StaticPathsDefinition, type StorageOperation, type StorageStep, type StorageType, type StreamChunk, type StreamChunkType, type StreamingRenderOptions, type StringField, type StyleExpr, type StylePreset, type SubscribeStep, type SuspenseBoundary, type SuspenseNode, type TextNode, type ThemeColors, type ThemeConfig, type ThemeFonts, UPDATE_OPERATIONS, type UnbindStep, type UpdateOperation, type UpdateStep, VALIDITY_PROPERTIES, type ValidationFailure, type ValidationResult, type ValidationSuccess, type ValidityExpr, type ValidityProperty, type VarExpr, type ViewNode, astSchema, callGlobalFunction, createClipboardWriteMissingValueError, createComponentCycleError, createComponentNotFoundError, createComponentPropMissingError, createComponentPropTypeError, createCondElseRequiredError, createDataNotDefinedError, createDuplicateActionError, createDuplicateDefaultSlotError, createDuplicateIslandIdError, 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, evaluate, evaluateStyle, findSimilarNames, isActionStep, isAiDataSource, isArrayExpr, isBinExpr, isBooleanField, isCallStep, isClipboardStep, isCodeNode, isColorScheme, isComponentNode, isConcatExpr, isCondExpr, isConstelaError, isCookieInitialExpr, isDataExpr, isDataSource, isDisposeStep, isEachNode, isElementNode, isErrorBoundaryNode, isEventHandler, isExpression, isFetchStep, isFocusStep, isGenerateStep, isGetExpr, isIfNode, isImportExpr, isImportStep, isIslandNode, isIslandStrategy, isIslandStrategyOptions, isLayoutProgram, isLifecycleHooks, isListField, isLitExpr, isLocalActionDefinition, isLocalActionStep, isMarkdownNode, isNamedSlotNode, isNavigateStep, isNotExpr, isNumberField, isObjectField, isParamExpr, isPortalNode, isRefExpr, isRouteDefinition, isRouteExpr, isSetPathStep, isSetStep, isSlotNode, isStateExpr, isStateField, isStaticPathsDefinition, isStorageStep, isStreamChunk, isStreamingRenderOptions, isStringField, isStyleExpr, isSubscribeStep, isSuspenseBoundary, isSuspenseNode, isTextNode, isThemeColors, isThemeConfig, isThemeFonts, isUpdateStep, isValidityExpr, isVarExpr, isViewNode, validateAst };

package/dist/index.js

@@ -3680,6 +3680,574 @@ function callGlobalFunction(method, args) {
   }
   return fn(...args);
 }
+
+// src/evaluate/constants.ts
+var SAFE_ARRAY_METHODS = /* @__PURE__ */ new Set([
+  "length",
+  "at",
+  "includes",
+  "slice",
+  "indexOf",
+  "join",
+  "filter",
+  "map",
+  "find",
+  "findIndex",
+  "some",
+  "every"
+]);
+var SAFE_STRING_METHODS = /* @__PURE__ */ new Set([
+  "length",
+  "charAt",
+  "substring",
+  "slice",
+  "split",
+  "trim",
+  "toUpperCase",
+  "toLowerCase",
+  "replace",
+  "includes",
+  "startsWith",
+  "endsWith",
+  "indexOf"
+]);
+var SAFE_MATH_METHODS = /* @__PURE__ */ new Set([
+  "min",
+  "max",
+  "round",
+  "floor",
+  "ceil",
+  "abs",
+  "sqrt",
+  "pow",
+  "random",
+  "sin",
+  "cos",
+  "tan"
+]);
+var SAFE_DATE_STATIC_METHODS = /* @__PURE__ */ new Set([
+  "now",
+  "parse"
+]);
+var SAFE_DATE_INSTANCE_METHODS = /* @__PURE__ */ new Set([
+  "toISOString",
+  "toDateString",
+  "toTimeString",
+  "getTime",
+  "getFullYear",
+  "getMonth",
+  "getDate",
+  "getHours",
+  "getMinutes",
+  "getSeconds",
+  "getMilliseconds"
+]);
+var FORBIDDEN_KEYS = /* @__PURE__ */ new Set([
+  "__proto__",
+  "constructor",
+  "prototype"
+]);
+
+// src/evaluate/evaluate.ts
+function evaluate(expr, ctx) {
+  const e = expr;
+  switch (e.expr) {
+    case "lit":
+      return e.value;
+    case "state": {
+      const stateValue = ctx.state.get(e.name);
+      if (e.path && stateValue != null) {
+        return getNestedValue(stateValue, e.path);
+      }
+      return stateValue;
+    }
+    case "local":
+      return ctx.locals[e.name];
+    case "var": {
+      let varName = e.name;
+      let pathParts = [];
+      if (varName.includes(".")) {
+        const parts = varName.split(".");
+        varName = parts[0];
+        pathParts = parts.slice(1);
+      }
+      if (e.path) {
+        pathParts = pathParts.concat(e.path.split("."));
+      }
+      for (const part of pathParts) {
+        if (FORBIDDEN_KEYS.has(part)) {
+          return void 0;
+        }
+      }
+      let value = ctx.locals[varName];
+      if (value === void 0) {
+        value = ctx.env.resolveGlobal(varName);
+      }
+      for (const part of pathParts) {
+        if (value == null) break;
+        value = value[part];
+      }
+      if (typeof value === "function" && pathParts.length > 0) {
+        let parent = ctx.locals[varName];
+        if (parent === void 0) {
+          parent = ctx.env.resolveGlobal(varName);
+        }
+        for (let i = 0; i < pathParts.length - 1; i++) {
+          if (parent == null) break;
+          parent = parent[pathParts[i]];
+        }
+        if (parent != null) {
+          if (ctx.env.bindFunction) {
+            return ctx.env.bindFunction(value, parent);
+          }
+          return value;
+        }
+      }
+      return value;
+    }
+    case "bin":
+      return evaluateBinary(e.op, e.left, e.right, ctx);
+    case "not":
+      return !evaluate(e.operand, ctx);
+    case "cond":
+      return evaluate(e.if, ctx) ? evaluate(e.then, ctx) : evaluate(e.else, ctx);
+    case "get": {
+      const baseValue = evaluate(e.base, ctx);
+      if (baseValue == null) return void 0;
+      const pathParts = e.path.split(".");
+      let value = baseValue;
+      for (const part of pathParts) {
+        if (FORBIDDEN_KEYS.has(part)) return void 0;
+        if (value == null) return void 0;
+        value = value[part];
+      }
+      return value;
+    }
+    case "route": {
+      const source = e.source ?? "param";
+      const routeCtx = ctx.route;
+      if (!routeCtx) return "";
+      switch (source) {
+        case "param":
+          return routeCtx.params[e.name] ?? "";
+        case "query":
+          return routeCtx.query[e.name] ?? "";
+        case "path":
+          return routeCtx.path;
+        default:
+          return "";
+      }
+    }
+    case "import": {
+      const importData = ctx.imports?.[e.name];
+      if (importData === void 0) return void 0;
+      if (e.path) {
+        return getNestedValue(importData, e.path);
+      }
+      return importData;
+    }
+    case "data": {
+      const dataValue = ctx.imports?.[e.name];
+      if (dataValue === void 0) return void 0;
+      if (e.path) {
+        return getNestedValue(dataValue, e.path);
+      }
+      return dataValue;
+    }
+    case "ref":
+      return ctx.env.resolveRef(e.name);
+    case "index": {
+      const base = evaluate(e.base, ctx);
+      const key = evaluate(e.key, ctx);
+      if (base == null || key == null) return void 0;
+      if (typeof key === "string" && FORBIDDEN_KEYS.has(key)) return void 0;
+      return base[key];
+    }
+    case "param":
+      return void 0;
+    case "style":
+      return evaluateStyle(e, ctx);
+    case "concat": {
+      return e.items.map((item) => {
+        const val = evaluate(item, ctx);
+        return val == null ? "" : String(val);
+      }).join("");
+    }
+    case "validity":
+      return ctx.env.resolveValidity(e.ref, e.property);
+    case "call": {
+      const target = e.target != null ? evaluate(e.target, ctx) : null;
+      const args = e.args?.map((arg) => {
+        if (arg.expr === "lambda") return arg;
+        return evaluate(arg, ctx);
+      }) ?? [];
+      if (target === null) {
+        return callGlobalFunction(e.method, args);
+      }
+      if (Array.isArray(target)) {
+        return callArrayMethod(target, e.method, args, ctx, e.args);
+      }
+      if (typeof target === "string") {
+        return callStringMethod(target, e.method, args);
+      }
+      if (target === Math) {
+        return callMathMethod(e.method, args);
+      }
+      if (target === Date) {
+        return callDateStaticMethod(e.method, args);
+      }
+      if (target instanceof Date) {
+        return callDateInstanceMethod(target, e.method);
+      }
+      if (typeof target === "function" && e.method === "call") {
+        if (ctx.env.callFunction) {
+          return ctx.env.callFunction(target, args);
+        }
+        return target(...args);
+      }
+      return void 0;
+    }
+    case "lambda":
+      return void 0;
+    case "array":
+      return e.elements.map((elem) => evaluate(elem, ctx));
+    case "obj": {
+      const result = {};
+      for (const [key, value] of Object.entries(e.props)) {
+        result[key] = evaluate(value, ctx);
+      }
+      return result;
+    }
+    default:
+      return void 0;
+  }
+}
+function evaluateStyle(expr, ctx) {
+  const e = expr;
+  const preset = ctx.styles?.[e.name];
+  if (!preset) return "";
+  let classes = preset.base;
+  if (preset.variants) {
+    for (const variantKey of Object.keys(preset.variants)) {
+      let variantValueStr = null;
+      if (e.variants?.[variantKey]) {
+        let variantValue;
+        try {
+          variantValue = evaluate(e.variants[variantKey], ctx);
+        } catch {
+          continue;
+        }
+        if (variantValue != null) {
+          variantValueStr = String(variantValue);
+        }
+      } else if (preset.defaultVariants?.[variantKey] !== void 0) {
+        variantValueStr = preset.defaultVariants[variantKey];
+      }
+      if (variantValueStr !== null) {
+        const variantClasses = preset.variants[variantKey]?.[variantValueStr];
+        if (variantClasses) {
+          classes += " " + variantClasses;
+        }
+      }
+    }
+  }
+  return classes.trim();
+}
+function getNestedValue(obj, path) {
+  const parts = path.split(".");
+  let value = obj;
+  let parent = null;
+  for (const part of parts) {
+    if (FORBIDDEN_KEYS.has(part)) return void 0;
+    if (value == null) return void 0;
+    parent = value;
+    if (Array.isArray(value)) {
+      const index = Number(part);
+      if (Number.isInteger(index) && index >= 0) {
+        value = value[index];
+      } else {
+        value = value[part];
+      }
+    } else if (typeof value === "object") {
+      value = value[part];
+    } else {
+      return void 0;
+    }
+  }
+  if (typeof value === "function" && parent != null) {
+    return value.bind(parent);
+  }
+  return value;
+}
+function evaluateBinary(op, left, right, ctx) {
+  if (op === "&&") {
+    const leftVal2 = evaluate(left, ctx);
+    if (!leftVal2) return leftVal2;
+    return evaluate(right, ctx);
+  }
+  if (op === "||") {
+    const leftVal2 = evaluate(left, ctx);
+    if (leftVal2) return leftVal2;
+    return evaluate(right, ctx);
+  }
+  const leftVal = evaluate(left, ctx);
+  const rightVal = evaluate(right, ctx);
+  switch (op) {
+    case "+":
+      if (typeof leftVal === "number" && typeof rightVal === "number") {
+        return leftVal + rightVal;
+      }
+      return String(leftVal) + String(rightVal);
+    case "-":
+      return (typeof leftVal === "number" ? leftVal : 0) - (typeof rightVal === "number" ? rightVal : 0);
+    case "*":
+      return (typeof leftVal === "number" ? leftVal : 0) * (typeof rightVal === "number" ? rightVal : 0);
+    case "/": {
+      const dividend = typeof leftVal === "number" ? leftVal : 0;
+      const divisor = typeof rightVal === "number" ? rightVal : 0;
+      if (divisor === 0) {
+        return dividend === 0 ? NaN : dividend > 0 ? Infinity : -Infinity;
+      }
+      return dividend / divisor;
+    }
+    case "%": {
+      const dividend = typeof leftVal === "number" ? leftVal : 0;
+      const divisor = typeof rightVal === "number" ? rightVal : 0;
+      if (divisor === 0) return NaN;
+      return dividend % divisor;
+    }
+    case "==":
+      return leftVal === rightVal;
+    case "!=":
+      return leftVal !== rightVal;
+    case "<":
+      if (typeof leftVal === "number" && typeof rightVal === "number") return leftVal < rightVal;
+      return String(leftVal) < String(rightVal);
+    case "<=":
+      if (typeof leftVal === "number" && typeof rightVal === "number") return leftVal <= rightVal;
+      return String(leftVal) <= String(rightVal);
+    case ">":
+      if (typeof leftVal === "number" && typeof rightVal === "number") return leftVal > rightVal;
+      return String(leftVal) > String(rightVal);
+    case ">=":
+      if (typeof leftVal === "number" && typeof rightVal === "number") return leftVal >= rightVal;
+      return String(leftVal) >= String(rightVal);
+    default:
+      throw new Error("Unknown binary operator: " + op);
+  }
+}
+function createLambdaFunction(lambda, ctx) {
+  return (item, index) => {
+    const lambdaLocals = {
+      ...ctx.locals,
+      [lambda.param]: item
+    };
+    if (lambda.index !== void 0) {
+      lambdaLocals[lambda.index] = index;
+    }
+    return evaluate(lambda.body, { ...ctx, locals: lambdaLocals });
+  };
+}
+function callArrayMethod(target, method, args, ctx, rawArgs) {
+  if (!SAFE_ARRAY_METHODS.has(method)) return void 0;
+  switch (method) {
+    case "length":
+      return target.length;
+    case "at": {
+      const index = typeof args[0] === "number" ? args[0] : 0;
+      return target.at(index);
+    }
+    case "includes": {
+      const searchElement = args[0];
+      const fromIndex = typeof args[1] === "number" ? args[1] : void 0;
+      return target.includes(searchElement, fromIndex);
+    }
+    case "slice": {
+      const start = typeof args[0] === "number" ? args[0] : void 0;
+      const end = typeof args[1] === "number" ? args[1] : void 0;
+      return target.slice(start, end);
+    }
+    case "indexOf": {
+      const searchElement = args[0];
+      const fromIndex = typeof args[1] === "number" ? args[1] : void 0;
+      return target.indexOf(searchElement, fromIndex);
+    }
+    case "join": {
+      const separator = typeof args[0] === "string" ? args[0] : ",";
+      return target.join(separator);
+    }
+    case "filter": {
+      const lambdaExpr = rawArgs?.[0];
+      if (!lambdaExpr || lambdaExpr.expr !== "lambda") return void 0;
+      const fn = createLambdaFunction(lambdaExpr, ctx);
+      return target.filter((item, index) => !!fn(item, index));
+    }
+    case "map": {
+      const lambdaExpr = rawArgs?.[0];
+      if (!lambdaExpr || lambdaExpr.expr !== "lambda") return void 0;
+      const fn = createLambdaFunction(lambdaExpr, ctx);
+      return target.map((item, index) => fn(item, index));
+    }
+    case "find": {
+      const lambdaExpr = rawArgs?.[0];
+      if (!lambdaExpr || lambdaExpr.expr !== "lambda") return void 0;
+      const fn = createLambdaFunction(lambdaExpr, ctx);
+      return target.find((item, index) => !!fn(item, index));
+    }
+    case "findIndex": {
+      const lambdaExpr = rawArgs?.[0];
+      if (!lambdaExpr || lambdaExpr.expr !== "lambda") return void 0;
+      const fn = createLambdaFunction(lambdaExpr, ctx);
+      return target.findIndex((item, index) => !!fn(item, index));
+    }
+    case "some": {
+      const lambdaExpr = rawArgs?.[0];
+      if (!lambdaExpr || lambdaExpr.expr !== "lambda") return void 0;
+      const fn = createLambdaFunction(lambdaExpr, ctx);
+      return target.some((item, index) => !!fn(item, index));
+    }
+    case "every": {
+      const lambdaExpr = rawArgs?.[0];
+      if (!lambdaExpr || lambdaExpr.expr !== "lambda") return void 0;
+      const fn = createLambdaFunction(lambdaExpr, ctx);
+      return target.every((item, index) => !!fn(item, index));
+    }
+    default:
+      return void 0;
+  }
+}
+function callStringMethod(target, method, args) {
+  if (!SAFE_STRING_METHODS.has(method)) return void 0;
+  switch (method) {
+    case "length":
+      return target.length;
+    case "charAt": {
+      const index = typeof args[0] === "number" ? args[0] : 0;
+      return target.charAt(index);
+    }
+    case "substring": {
+      const start = typeof args[0] === "number" ? args[0] : 0;
+      const end = typeof args[1] === "number" ? args[1] : void 0;
+      return target.substring(start, end);
+    }
+    case "slice": {
+      const start = typeof args[0] === "number" ? args[0] : void 0;
+      const end = typeof args[1] === "number" ? args[1] : void 0;
+      return target.slice(start, end);
+    }
+    case "split": {
+      const separator = typeof args[0] === "string" ? args[0] : "";
+      return target.split(separator);
+    }
+    case "trim":
+      return target.trim();
+    case "toUpperCase":
+      return target.toUpperCase();
+    case "toLowerCase":
+      return target.toLowerCase();
+    case "replace": {
+      const search = typeof args[0] === "string" ? args[0] : "";
+      const replace = typeof args[1] === "string" ? args[1] : "";
+      return target.replace(search, replace);
+    }
+    case "includes": {
+      const search = typeof args[0] === "string" ? args[0] : "";
+      const position = typeof args[1] === "number" ? args[1] : void 0;
+      return target.includes(search, position);
+    }
+    case "startsWith": {
+      const search = typeof args[0] === "string" ? args[0] : "";
+      const position = typeof args[1] === "number" ? args[1] : void 0;
+      return target.startsWith(search, position);
+    }
+    case "endsWith": {
+      const search = typeof args[0] === "string" ? args[0] : "";
+      const length = typeof args[1] === "number" ? args[1] : void 0;
+      return target.endsWith(search, length);
+    }
+    case "indexOf": {
+      const search = typeof args[0] === "string" ? args[0] : "";
+      const position = typeof args[1] === "number" ? args[1] : void 0;
+      return target.indexOf(search, position);
+    }
+    default:
+      return void 0;
+  }
+}
+function callMathMethod(method, args) {
+  if (!SAFE_MATH_METHODS.has(method)) return void 0;
+  const numbers = args.filter((a) => typeof a === "number");
+  switch (method) {
+    case "min":
+      return numbers.length > 0 ? Math.min(...numbers) : void 0;
+    case "max":
+      return numbers.length > 0 ? Math.max(...numbers) : void 0;
+    case "round":
+      return numbers[0] !== void 0 ? Math.round(numbers[0]) : void 0;
+    case "floor":
+      return numbers[0] !== void 0 ? Math.floor(numbers[0]) : void 0;
+    case "ceil":
+      return numbers[0] !== void 0 ? Math.ceil(numbers[0]) : void 0;
+    case "abs":
+      return numbers[0] !== void 0 ? Math.abs(numbers[0]) : void 0;
+    case "sqrt":
+      return numbers[0] !== void 0 ? Math.sqrt(numbers[0]) : void 0;
+    case "pow":
+      return numbers[0] !== void 0 && numbers[1] !== void 0 ? Math.pow(numbers[0], numbers[1]) : void 0;
+    case "random":
+      return Math.random();
+    case "sin":
+      return numbers[0] !== void 0 ? Math.sin(numbers[0]) : void 0;
+    case "cos":
+      return numbers[0] !== void 0 ? Math.cos(numbers[0]) : void 0;
+    case "tan":
+      return numbers[0] !== void 0 ? Math.tan(numbers[0]) : void 0;
+    default:
+      return void 0;
+  }
+}
+function callDateStaticMethod(method, args) {
+  if (!SAFE_DATE_STATIC_METHODS.has(method)) return void 0;
+  switch (method) {
+    case "now":
+      return Date.now();
+    case "parse": {
+      const dateString = args[0];
+      return typeof dateString === "string" ? Date.parse(dateString) : void 0;
+    }
+    default:
+      return void 0;
+  }
+}
+function callDateInstanceMethod(target, method) {
+  if (!SAFE_DATE_INSTANCE_METHODS.has(method)) return void 0;
+  switch (method) {
+    case "toISOString":
+      return target.toISOString();
+    case "toDateString":
+      return target.toDateString();
+    case "toTimeString":
+      return target.toTimeString();
+    case "getTime":
+      return target.getTime();
+    case "getFullYear":
+      return target.getFullYear();
+    case "getMonth":
+      return target.getMonth();
+    case "getDate":
+      return target.getDate();
+    case "getHours":
+      return target.getHours();
+    case "getMinutes":
+      return target.getMinutes();
+    case "getSeconds":
+      return target.getSeconds();
+    case "getMilliseconds":
+      return target.getMilliseconds();
+    default:
+      return void 0;
+  }
+}
 export {
   AI_OUTPUT_TYPES,
   AI_PROVIDER_TYPES,
@@ -3690,11 +4258,17 @@ export {
   DATA_SOURCE_TYPES,
   DATA_TRANSFORMS,
   FOCUS_OPERATIONS,
+  FORBIDDEN_KEYS,
   GLOBAL_FUNCTIONS,
   HTTP_METHODS,
   ISLAND_STRATEGIES,
   NAVIGATE_TARGETS,
   PARAM_TYPES,
+  SAFE_ARRAY_METHODS,
+  SAFE_DATE_INSTANCE_METHODS,
+  SAFE_DATE_STATIC_METHODS,
+  SAFE_MATH_METHODS,
+  SAFE_STRING_METHODS,
   STORAGE_OPERATIONS,
   STORAGE_TYPES,
   UPDATE_OPERATIONS,
@@ -3742,6 +4316,8 @@ export {
   createUndefinedVarError,
   createUndefinedVariantError,
   createUnsupportedVersionError,
+  evaluate,
+  evaluateStyle,
   findSimilarNames,
   isActionStep,
   isAiDataSource,

package/package.json

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