@constela/compiler 0.8.0 → 0.9.1

package/README.md

@@ -45,6 +45,12 @@ The compiler transforms JSON programs through three passes:
 2. **Analyze** - Semantic analysis (state, actions, components, routes)
 3. **Transform** - AST to optimized runtime program
 
+## Supported Features
+
+- **setPath** - Compiles to efficient path-based state updates
+- **Key-based each** - Compiles key expressions for list diffing
+- **WebSocket connections** - Compiles connection definitions and send/close actions
+
 ## CompiledProgram Structure
 
 ```json
@@ -63,6 +69,13 @@ The compiler transforms JSON programs through three passes:
   "state": {
     "count": { "type": "number", "initial": 0 }
   },
+  "connections": {
+    "chat": {
+      "type": "websocket",
+      "url": { ... },
+      "onMessage": { "action": "handleMessage" }
+    }
+  },
   "actions": {
     "increment": {
       "name": "increment",

package/dist/index.d.ts

@@ -89,7 +89,7 @@ interface CompiledAction {
     name: string;
     steps: CompiledActionStep[];
 }
-type CompiledActionStep = CompiledSetStep | CompiledUpdateStep | CompiledFetchStep | CompiledStorageStep | CompiledClipboardStep | CompiledNavigateStep | CompiledImportStep | CompiledCallStep | CompiledSubscribeStep | CompiledDisposeStep | CompiledDomStep | CompiledIfStep;
+type CompiledActionStep = CompiledSetStep | CompiledUpdateStep | CompiledSetPathStep | CompiledFetchStep | CompiledStorageStep | CompiledClipboardStep | CompiledNavigateStep | CompiledImportStep | CompiledCallStep | CompiledSubscribeStep | CompiledDisposeStep | CompiledDomStep | CompiledIfStep | CompiledSendStep | CompiledCloseStep;
 interface CompiledSetStep {
     do: 'set';
     target: string;
@@ -103,6 +103,12 @@ interface CompiledUpdateStep {
     index?: CompiledExpression;
     deleteCount?: CompiledExpression;
 }
+interface CompiledSetPathStep {
+    do: 'setPath';
+    target: string;
+    path: CompiledExpression;
+    value: CompiledExpression;
+}
 interface CompiledFetchStep {
     do: 'fetch';
     url: CompiledExpression;
@@ -196,6 +202,21 @@ interface CompiledIfStep {
     then: CompiledActionStep[];
     else?: CompiledActionStep[];
 }
+/**
+ * Compiled send step - sends data through a named WebSocket connection
+ */
+interface CompiledSendStep {
+    do: 'send';
+    connection: string;
+    data: CompiledExpression;
+}
+/**
+ * Compiled close step - closes a named WebSocket connection
+ */
+interface CompiledCloseStep {
+    do: 'close';
+    connection: string;
+}
 type CompiledNode = CompiledElementNode | CompiledTextNode | CompiledIfNode | CompiledEachNode | CompiledMarkdownNode | CompiledCodeNode | CompiledSlotNode;
 interface CompiledElementNode {
     kind: 'element';
@@ -235,7 +256,7 @@ interface CompiledSlotNode {
     kind: 'slot';
     name?: string;
 }
-type CompiledExpression = CompiledLitExpr | CompiledStateExpr | CompiledVarExpr | CompiledBinExpr | CompiledNotExpr | CompiledCondExpr | CompiledGetExpr | CompiledRouteExpr | CompiledImportExpr | CompiledDataExpr | CompiledRefExpr | CompiledIndexExpr | CompiledParamExpr | CompiledStyleExpr;
+type CompiledExpression = CompiledLitExpr | CompiledStateExpr | CompiledVarExpr | CompiledBinExpr | CompiledNotExpr | CompiledCondExpr | CompiledGetExpr | CompiledRouteExpr | CompiledImportExpr | CompiledDataExpr | CompiledRefExpr | CompiledIndexExpr | CompiledParamExpr | CompiledStyleExpr | CompiledConcatExpr;
 interface CompiledLitExpr {
     expr: 'lit';
     value: string | number | boolean | null | unknown[];
@@ -301,10 +322,14 @@ interface CompiledStyleExpr {
     name: string;
     variants?: Record<string, CompiledExpression>;
 }
+interface CompiledConcatExpr {
+    expr: 'concat';
+    items: CompiledExpression[];
+}
 interface CompiledEventHandler {
     event: string;
     action: string;
-    payload?: CompiledExpression;
+    payload?: CompiledExpression | Record<string, CompiledExpression>;
 }
 /**
  * Transforms the validated and analyzed AST into a CompiledProgram
@@ -434,4 +459,4 @@ declare function transformLayoutPass(layout: LayoutProgram, _context: LayoutAnal
  */
 declare function composeLayoutWithPage(layout: CompiledProgram, page: CompiledProgram, layoutParams?: Record<string, Expression>, slots?: Record<string, ViewNode>): CompiledProgram;
 
-export { type AnalysisContext, type AnalyzePassFailure, type AnalyzePassResult, type AnalyzePassSuccess, type CompileFailure, type CompileResult, type CompileSuccess, type CompiledAction, type CompiledActionStep, type CompiledBinExpr, type CompiledCallStep, type CompiledClipboardStep, type CompiledCodeNode, type CompiledCondExpr, type CompiledDataExpr, type CompiledDisposeStep, type CompiledDomStep, type CompiledEachNode, type CompiledElementNode, type CompiledEventHandler, type CompiledExpression, type CompiledFetchStep, type CompiledGetExpr, type CompiledIfNode, type CompiledIfStep, type CompiledImportExpr, type CompiledImportStep, type CompiledIndexExpr, type CompiledLayoutProgram, type CompiledLifecycleHooks, type CompiledLitExpr, type CompiledMarkdownNode, type CompiledNavigateStep, type CompiledNode, type CompiledNotExpr, type CompiledProgram, type CompiledRefExpr, type CompiledRouteDefinition, type CompiledRouteExpr, type CompiledSetStep, type CompiledSlotNode, type CompiledStateExpr, type CompiledStorageStep, type CompiledSubscribeStep, type CompiledTextNode, type CompiledUpdateStep, type CompiledVarExpr, type LayoutAnalysisContext, type LayoutAnalysisFailure, type LayoutAnalysisResult, type LayoutAnalysisSuccess, type ValidatePassFailure, type ValidatePassResult, type ValidatePassSuccess, analyzeLayoutPass, analyzePass, compile, composeLayoutWithPage, transformLayoutPass, transformPass, validatePass };
+export { type AnalysisContext, type AnalyzePassFailure, type AnalyzePassResult, type AnalyzePassSuccess, type CompileFailure, type CompileResult, type CompileSuccess, type CompiledAction, type CompiledActionStep, type CompiledBinExpr, type CompiledCallStep, type CompiledClipboardStep, type CompiledCloseStep, type CompiledCodeNode, type CompiledConcatExpr, type CompiledCondExpr, type CompiledDataExpr, type CompiledDisposeStep, type CompiledDomStep, type CompiledEachNode, type CompiledElementNode, type CompiledEventHandler, type CompiledExpression, type CompiledFetchStep, type CompiledGetExpr, type CompiledIfNode, type CompiledIfStep, type CompiledImportExpr, type CompiledImportStep, type CompiledIndexExpr, type CompiledLayoutProgram, type CompiledLifecycleHooks, type CompiledLitExpr, type CompiledMarkdownNode, type CompiledNavigateStep, type CompiledNode, type CompiledNotExpr, type CompiledParamExpr, type CompiledProgram, type CompiledRefExpr, type CompiledRouteDefinition, type CompiledRouteExpr, type CompiledSendStep, type CompiledSetPathStep, type CompiledSetStep, type CompiledSlotNode, type CompiledStateExpr, type CompiledStorageStep, type CompiledStyleExpr, type CompiledSubscribeStep, type CompiledTextNode, type CompiledUpdateStep, type CompiledVarExpr, type LayoutAnalysisContext, type LayoutAnalysisFailure, type LayoutAnalysisResult, type LayoutAnalysisSuccess, type ValidatePassFailure, type ValidatePassResult, type ValidatePassSuccess, analyzeLayoutPass, analyzePass, compile, composeLayoutWithPage, transformLayoutPass, transformPass, validatePass };

package/dist/index.js

@@ -1178,6 +1178,11 @@ function transformExpression(expr, ctx) {
       }
       return styleExpr;
     }
+    case "concat":
+      return {
+        expr: "concat",
+        items: expr.items.map((item) => transformExpression(item, ctx))
+      };
   }
 }
 function transformEventHandler(handler, ctx) {
@@ -1216,6 +1221,15 @@ function transformActionStep(step) {
       }
       return updateStep;
     }
+    case "setPath": {
+      const setPathStep = step;
+      return {
+        do: "setPath",
+        target: setPathStep.target,
+        path: transformExpression(setPathStep.path, emptyContext),
+        value: transformExpression(setPathStep.value, emptyContext)
+      };
+    }
     case "fetch": {
       const fetchStep = {
         do: "fetch",
@@ -1355,6 +1369,21 @@ function transformActionStep(step) {
         ...domStep.attribute && { attribute: domStep.attribute }
       };
     }
+    case "send": {
+      const sendStep = step;
+      return {
+        do: "send",
+        connection: sendStep.connection,
+        data: transformExpression(sendStep.data, emptyContext)
+      };
+    }
+    case "close": {
+      const closeStep = step;
+      return {
+        do: "close",
+        connection: closeStep.connection
+      };
+    }
   }
 }
 function flattenSlotChildren(children, ctx) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constela/compiler",
-  "version": "0.8.0",
+  "version": "0.9.1",
   "description": "Compiler for Constela UI framework - AST to Program transformation",
   "type": "module",
   "main": "./dist/index.js",
@@ -15,7 +15,7 @@
     "dist"
   ],
   "dependencies": {
-    "@constela/core": "0.8.0"
+    "@constela/core": "0.9.1"
   },
   "devDependencies": {
     "@types/node": "^20.10.0",