@constela/core 0.9.1 → 0.10.0

package/README.md

@@ -42,7 +42,7 @@ All fields except `version`, `state`, `actions`, and `view` are optional.
 
 ## Expression Types
 
-13 expression types for constrained computation:
+14 expression types for constrained computation:
 
 | Type | JSON Example | Description |
 |------|-------------|-------------|
@@ -59,9 +59,29 @@ All fields except `version`, `state`, `actions`, and `view` are optional.
 | `data` | `{ "expr": "data", "name": "posts" }` | Build-time data |
 | `ref` | `{ "expr": "ref", "name": "inputEl" }` | DOM element ref |
 | `style` | `{ "expr": "style", "name": "button", "variants": {...} }` | Style reference |
+| `concat` | `{ "expr": "concat", "items": [...] }` | String concatenation |
 
 **Binary Operators:** `+`, `-`, `*`, `/`, `==`, `!=`, `<`, `<=`, `>`, `>=`, `&&`, `||`
 
+**Concat Expression:**
+
+Concatenate multiple expressions into a single string:
+
+```json
+{
+  "expr": "concat",
+  "items": [
+    { "expr": "lit", "value": "Hello, " },
+    { "expr": "var", "name": "username" },
+    { "expr": "lit", "value": "!" }
+  ]
+}
+```
+
+- Evaluates each item and joins them as strings
+- `null`/`undefined` values become empty strings
+- Numbers and booleans are converted to strings
+
 ## View Node Types
 
 8 node types for building UI:
@@ -305,11 +325,11 @@ if (result.ok) {
 
 ### Type Guards
 
-47 type guard functions for runtime type checking:
+48 type guard functions for runtime type checking:
 
 ```typescript
 import {
-  isLitExpr, isStateExpr, isVarExpr, isBinExpr,
+  isLitExpr, isStateExpr, isVarExpr, isBinExpr, isConcatExpr,
   isElementNode, isTextNode, isIfNode, isEachNode,
   isSetStep, isUpdateStep, isFetchStep,
   isNumberField, isStringField, isListField,

package/dist/index.d.ts

@@ -341,6 +341,7 @@ interface CloseStep {
     connection: string;
 }
 type ActionStep = SetStep | UpdateStep | SetPathStep | FetchStep | StorageStep | ClipboardStep | NavigateStep | ImportStep | CallStep | SubscribeStep | DisposeStep | DomStep | SendStep | CloseStep;
+type LocalActionStep = SetStep | UpdateStep | SetPathStep;
 /**
  * Event handler - binds an event to an action
  */
@@ -356,6 +357,14 @@ interface ActionDefinition {
     name: string;
     steps: ActionStep[];
 }
+/**
+ * Local action definition - a named sequence of local steps
+ * Only set, update, and setPath steps are allowed
+ */
+interface LocalActionDefinition {
+    name: string;
+    steps: LocalActionStep[];
+}
 /**
  * Element node - represents an HTML element
  */
@@ -428,6 +437,8 @@ interface CodeNode {
 type ViewNode = ElementNode | TextNode | IfNode | EachNode | ComponentNode | SlotNode | MarkdownNode | CodeNode;
 interface ComponentDef {
     params?: Record<string, ParamDef>;
+    localState?: Record<string, StateField>;
+    localActions?: LocalActionDefinition[];
     view: ViewNode;
 }
 /**
@@ -682,6 +693,10 @@ declare function isSetStep(value: unknown): value is SetStep;
  * Checks if value is an update step
  */
 declare function isUpdateStep(value: unknown): value is UpdateStep;
+/**
+ * Checks if value is a setPath step
+ */
+declare function isSetPathStep(value: unknown): value is SetPathStep;
 /**
  * Checks if value is a fetch step
  */
@@ -718,6 +733,15 @@ declare function isDisposeStep(value: unknown): value is DisposeStep;
  * Checks if value is any valid action step
  */
 declare function isActionStep(value: unknown): value is ActionStep;
+/**
+ * Checks if value is a valid local action step
+ * Local actions only allow set, update, and setPath steps
+ */
+declare function isLocalActionStep(value: unknown): value is LocalActionStep;
+/**
+ * Checks if value is a local action definition
+ */
+declare function isLocalActionDefinition(value: unknown): value is LocalActionDefinition;
 /**
  * Checks if value is a number field
  */
@@ -770,7 +794,7 @@ declare function isLifecycleHooks(value: unknown): value is LifecycleHooks;
  * This module defines error types, the ConstelaError class,
  * and factory functions for creating specific errors.
  */
-type ErrorCode = 'SCHEMA_INVALID' | 'UNDEFINED_STATE' | 'UNDEFINED_ACTION' | 'VAR_UNDEFINED' | 'DUPLICATE_ACTION' | 'UNSUPPORTED_VERSION' | 'COMPONENT_NOT_FOUND' | 'COMPONENT_PROP_MISSING' | 'COMPONENT_CYCLE' | 'COMPONENT_PROP_TYPE' | 'PARAM_UNDEFINED' | 'OPERATION_INVALID_FOR_TYPE' | 'OPERATION_MISSING_FIELD' | 'OPERATION_UNKNOWN' | 'EXPR_INVALID_BASE' | 'EXPR_INVALID_CONDITION' | 'EXPR_COND_ELSE_REQUIRED' | 'UNDEFINED_ROUTE_PARAM' | 'ROUTE_NOT_DEFINED' | 'UNDEFINED_IMPORT' | 'IMPORTS_NOT_DEFINED' | 'LAYOUT_MISSING_SLOT' | 'LAYOUT_NOT_FOUND' | 'INVALID_SLOT_NAME' | 'DUPLICATE_SLOT_NAME' | 'DUPLICATE_DEFAULT_SLOT' | 'SLOT_IN_LOOP' | 'INVALID_DATA_SOURCE' | 'UNDEFINED_DATA_SOURCE' | 'DATA_NOT_DEFINED' | 'UNDEFINED_DATA' | 'UNDEFINED_REF' | 'INVALID_STORAGE_OPERATION' | 'INVALID_STORAGE_TYPE' | 'STORAGE_SET_MISSING_VALUE' | 'INVALID_CLIPBOARD_OPERATION' | 'CLIPBOARD_WRITE_MISSING_VALUE' | 'INVALID_NAVIGATE_TARGET' | 'UNDEFINED_STYLE' | 'UNDEFINED_VARIANT';
+type ErrorCode = 'SCHEMA_INVALID' | 'UNDEFINED_STATE' | 'UNDEFINED_ACTION' | 'VAR_UNDEFINED' | 'DUPLICATE_ACTION' | 'UNSUPPORTED_VERSION' | 'COMPONENT_NOT_FOUND' | 'COMPONENT_PROP_MISSING' | 'COMPONENT_CYCLE' | 'COMPONENT_PROP_TYPE' | 'PARAM_UNDEFINED' | 'OPERATION_INVALID_FOR_TYPE' | 'OPERATION_MISSING_FIELD' | 'OPERATION_UNKNOWN' | 'EXPR_INVALID_BASE' | 'EXPR_INVALID_CONDITION' | 'EXPR_COND_ELSE_REQUIRED' | 'UNDEFINED_ROUTE_PARAM' | 'ROUTE_NOT_DEFINED' | 'UNDEFINED_IMPORT' | 'IMPORTS_NOT_DEFINED' | 'LAYOUT_MISSING_SLOT' | 'LAYOUT_NOT_FOUND' | 'INVALID_SLOT_NAME' | 'DUPLICATE_SLOT_NAME' | 'DUPLICATE_DEFAULT_SLOT' | 'SLOT_IN_LOOP' | 'INVALID_DATA_SOURCE' | 'UNDEFINED_DATA_SOURCE' | 'DATA_NOT_DEFINED' | 'UNDEFINED_DATA' | 'UNDEFINED_REF' | 'INVALID_STORAGE_OPERATION' | 'INVALID_STORAGE_TYPE' | 'STORAGE_SET_MISSING_VALUE' | 'INVALID_CLIPBOARD_OPERATION' | 'CLIPBOARD_WRITE_MISSING_VALUE' | 'INVALID_NAVIGATE_TARGET' | 'UNDEFINED_STYLE' | 'UNDEFINED_VARIANT' | 'UNDEFINED_LOCAL_STATE' | 'LOCAL_ACTION_INVALID_STEP';
 /**
  * Options for creating enhanced ConstelaError instances
  */
@@ -969,6 +993,14 @@ declare function createUndefinedStyleError(styleName: string, path?: string, opt
  * Creates an undefined variant key error
  */
 declare function createUndefinedVariantError(variantKey: string, styleName: string, path?: string, options?: ErrorOptions): ConstelaError;
+/**
+ * Creates an undefined local state reference error
+ */
+declare function createUndefinedLocalStateError(stateName: string, path?: string, options?: ErrorOptions): ConstelaError;
+/**
+ * Creates a local action invalid step error
+ */
+declare function createLocalActionInvalidStepError(stepType: string, path?: string): ConstelaError;
 /**
  * Finds similar names from a set of candidates using Levenshtein distance
  * and prefix matching.
@@ -1720,4 +1752,4 @@ declare const astSchema: {
     };
 };
 
-export { type ActionDefinition, type ActionStep, BINARY_OPERATORS, type BinExpr, type BinaryOperator, type BooleanField, CLIPBOARD_OPERATIONS, type CallStep, 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, DATA_SOURCE_TYPES, DATA_TRANSFORMS, type DataExpr, type DataSource, type DataSourceType, type DataTransform, type DisposeStep, type DomStep, type EachNode, type ElementNode, type ErrorCode, type ErrorOptions, type EventHandler, type Expression, type FetchStep, type GetExpr, HTTP_METHODS, type HttpMethod, type IfNode, type ImportExpr, type ImportStep, type LayoutProgram, type LifecycleHooks, type ListField, type LitExpr, type MarkdownNode, NAVIGATE_TARGETS, type NavigateStep, type NavigateTarget, type NotExpr, type NumberField, type ObjectField, PARAM_TYPES, type ParamDef, type ParamExpr, type ParamType, 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, type ValidationFailure, type ValidationResult, type ValidationSuccess, type VarExpr, type ViewNode, astSchema, createClipboardWriteMissingValueError, createComponentCycleError, createComponentNotFoundError, createComponentPropMissingError, createComponentPropTypeError, createCondElseRequiredError, createDataNotDefinedError, createDuplicateActionError, createDuplicateDefaultSlotError, createDuplicateSlotNameError, createImportsNotDefinedError, createInvalidClipboardOperationError, createInvalidDataSourceError, createInvalidNavigateTargetError, createInvalidSlotNameError, createInvalidStorageOperationError, createInvalidStorageTypeError, createLayoutMissingSlotError, createLayoutNotFoundError, createOperationInvalidForTypeError, createOperationMissingFieldError, createOperationUnknownError, createRouteNotDefinedError, createSchemaError, createSlotInLoopError, createStorageSetMissingValueError, createUndefinedActionError, createUndefinedDataError, createUndefinedDataSourceError, createUndefinedImportError, createUndefinedParamError, createUndefinedRefError, createUndefinedRouteParamError, createUndefinedStateError, createUndefinedStyleError, createUndefinedVarError, createUndefinedVariantError, createUnsupportedVersionError, findSimilarNames, isActionStep, isBinExpr, isBooleanField, isCallStep, isClipboardStep, isCodeNode, isComponentNode, isConcatExpr, isCondExpr, isConstelaError, isDataExpr, isDataSource, isDisposeStep, isEachNode, isElementNode, isEventHandler, isExpression, isFetchStep, isGetExpr, isIfNode, isImportExpr, isImportStep, isLayoutProgram, isLifecycleHooks, isListField, isLitExpr, isMarkdownNode, isNamedSlotNode, isNavigateStep, isNotExpr, isNumberField, isObjectField, isParamExpr, isRefExpr, isRouteDefinition, isRouteExpr, isSetStep, isSlotNode, isStateExpr, isStateField, isStaticPathsDefinition, isStorageStep, isStringField, isStyleExpr, isSubscribeStep, isTextNode, isUpdateStep, isVarExpr, isViewNode, validateAst };
+export { type ActionDefinition, type ActionStep, BINARY_OPERATORS, type BinExpr, type BinaryOperator, type BooleanField, CLIPBOARD_OPERATIONS, type CallStep, 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, DATA_SOURCE_TYPES, DATA_TRANSFORMS, type DataExpr, type DataSource, type DataSourceType, type DataTransform, type DisposeStep, type DomStep, type EachNode, type ElementNode, type ErrorCode, type ErrorOptions, type EventHandler, type Expression, type FetchStep, type GetExpr, HTTP_METHODS, type HttpMethod, type IfNode, type ImportExpr, type ImportStep, 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 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, type ValidationFailure, type ValidationResult, type ValidationSuccess, 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, isDataExpr, isDataSource, isDisposeStep, isEachNode, isElementNode, isEventHandler, isExpression, isFetchStep, isGetExpr, isIfNode, isImportExpr, isImportStep, isLayoutProgram, isLifecycleHooks, isListField, isLitExpr, isLocalActionDefinition, isLocalActionStep, isMarkdownNode, isNamedSlotNode, isNavigateStep, isNotExpr, isNumberField, isObjectField, isParamExpr, isRefExpr, isRouteDefinition, isRouteExpr, isSetPathStep, isSetStep, isSlotNode, isStateExpr, isStateField, isStaticPathsDefinition, isStorageStep, isStringField, isStyleExpr, isSubscribeStep, isTextNode, isUpdateStep, isVarExpr, isViewNode, validateAst };

package/dist/index.js

@@ -252,6 +252,14 @@ function isUpdateStep(value) {
   }
   return true;
 }
+function isSetPathStep(value) {
+  if (!isObject(value)) return false;
+  if (value["do"] !== "setPath") return false;
+  if (typeof value["target"] !== "string") return false;
+  if (!isObject(value["path"])) return false;
+  if (!isObject(value["value"])) return false;
+  return true;
+}
 function isFetchStep(value) {
   if (!isObject(value)) return false;
   if (value["do"] !== "fetch") return false;
@@ -322,7 +330,19 @@ function isDisposeStep(value) {
   return true;
 }
 function isActionStep(value) {
-  return isSetStep(value) || isUpdateStep(value) || isFetchStep(value) || isStorageStep(value) || isClipboardStep(value) || isNavigateStep(value) || isImportStep(value) || isCallStep(value) || isSubscribeStep(value) || isDisposeStep(value);
+  return isSetStep(value) || isUpdateStep(value) || isSetPathStep(value) || isFetchStep(value) || isStorageStep(value) || isClipboardStep(value) || isNavigateStep(value) || isImportStep(value) || isCallStep(value) || isSubscribeStep(value) || isDisposeStep(value);
+}
+function isLocalActionStep(value) {
+  return isSetStep(value) || isUpdateStep(value) || isSetPathStep(value);
+}
+function isLocalActionDefinition(value) {
+  if (!isObject(value)) return false;
+  if (typeof value["name"] !== "string") return false;
+  if (!Array.isArray(value["steps"])) return false;
+  for (const step of value["steps"]) {
+    if (!isLocalActionStep(step)) return false;
+  }
+  return true;
 }
 function isNumberField(value) {
   if (!isObject(value)) return false;
@@ -697,6 +717,21 @@ function createUndefinedVariantError(variantKey, styleName, path, options) {
     options
   );
 }
+function createUndefinedLocalStateError(stateName, path, options) {
+  return new ConstelaError(
+    "UNDEFINED_LOCAL_STATE",
+    `Undefined local state reference: '${stateName}' is not defined in localState`,
+    path,
+    options
+  );
+}
+function createLocalActionInvalidStepError(stepType, path) {
+  return new ConstelaError(
+    "LOCAL_ACTION_INVALID_STEP",
+    `Invalid step type '${stepType}' in local action. Only 'set', 'update', and 'setPath' are allowed`,
+    path
+  );
+}
 function levenshteinDistance(a, b) {
   const aLen = a.length;
   const bLen = b.length;
@@ -1880,6 +1915,7 @@ export {
   createInvalidStorageTypeError,
   createLayoutMissingSlotError,
   createLayoutNotFoundError,
+  createLocalActionInvalidStepError,
   createOperationInvalidForTypeError,
   createOperationMissingFieldError,
   createOperationUnknownError,
@@ -1891,6 +1927,7 @@ export {
   createUndefinedDataError,
   createUndefinedDataSourceError,
   createUndefinedImportError,
+  createUndefinedLocalStateError,
   createUndefinedParamError,
   createUndefinedRefError,
   createUndefinedRouteParamError,
@@ -1926,6 +1963,8 @@ export {
   isLifecycleHooks,
   isListField,
   isLitExpr,
+  isLocalActionDefinition,
+  isLocalActionStep,
   isMarkdownNode,
   isNamedSlotNode,
   isNavigateStep,
@@ -1936,6 +1975,7 @@ export {
   isRefExpr,
   isRouteDefinition,
   isRouteExpr,
+  isSetPathStep,
   isSetStep,
   isSlotNode,
   isStateExpr,

package/package.json

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