@constela/core 0.12.0 → 0.12.1

package/README.md

@@ -40,9 +40,27 @@ All fields except `version`, `state`, `actions`, and `view` are optional.
 }
 ```
 
+### Cookie Expression for Initial Value
+
+String state can use a cookie expression to read initial value from cookies (SSR/SSG-safe):
+
+```json
+{
+  "theme": {
+    "type": "string",
+    "initial": { "expr": "cookie", "key": "theme", "default": "dark" }
+  }
+}
+```
+
+- `key`: Cookie name to read
+- `default`: Fallback value when cookie is not set
+- Works in both SSR and client-side rendering
+- Useful for theme persistence, user preferences, etc.
+
 ## Expression Types
 
-14 expression types for constrained computation:
+15 expression types for constrained computation:
 
 | Type | JSON Example | Description |
 |------|-------------|-------------|
@@ -60,6 +78,7 @@ All fields except `version`, `state`, `actions`, and `view` are optional.
 | `ref` | `{ "expr": "ref", "name": "inputEl" }` | DOM element ref |
 | `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) |
 
 **Binary Operators:** `+`, `-`, `*`, `/`, `==`, `!=`, `<`, `<=`, `>`, `>=`, `&&`, `||`
 

package/dist/index.js

@@ -839,10 +839,10 @@ function findSimilarNames(target, candidates, maxDistance = 2) {
 function isObject2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-var VALID_VIEW_KINDS = ["element", "text", "if", "each", "component", "slot", "markdown", "code"];
-var VALID_EXPR_TYPES = ["lit", "state", "var", "bin", "not", "param", "cond", "get", "style"];
+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"];
+var VALID_ACTION_TYPES = ["set", "update", "fetch", "delay", "interval", "clearTimer", "focus"];
 var VALID_STATE_TYPES = ["number", "string", "list", "boolean", "object"];
 var VALID_BIN_OPS = BINARY_OPERATORS;
 var VALID_UPDATE_OPS = UPDATE_OPERATIONS;
@@ -856,7 +856,7 @@ function validateViewNode(node, path) {
     return { path: path + "/kind", message: "kind is required" };
   }
   if (!VALID_VIEW_KINDS.includes(kind)) {
-    return { path: path + "/kind", message: "must be one of: element, text, if, each, component, slot, markdown, code" };
+    return { path: path + "/kind", message: "must be one of: element, text, if, each, component, slot, markdown, code, portal" };
   }
   switch (kind) {
     case "element":
@@ -955,6 +955,17 @@ function validateViewNode(node, path) {
         if (langError) return langError;
         return validateExpression(node["content"], path + "/content");
       }
+    case "portal":
+      if (typeof node["target"] !== "string") {
+        return { path: path + "/target", message: "target is required" };
+      }
+      if (Array.isArray(node["children"])) {
+        for (let i = 0; i < node["children"].length; i++) {
+          const error = validateViewNode(node["children"][i], path + "/children/" + i);
+          if (error) return error;
+        }
+      }
+      break;
   }
   return null;
 }
@@ -967,7 +978,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" };
+    return { path: path + "/expr", message: "must be one of: lit, state, var, bin, not, param, cond, get, style, validity, index" };
   }
   switch (exprType) {
     case "lit":
@@ -1055,6 +1066,25 @@ function validateExpression(expr, path) {
         }
       }
       break;
+    case "validity":
+      if (typeof expr["ref"] !== "string") {
+        return { path: path + "/ref", message: "ref is required" };
+      }
+      break;
+    case "index":
+      if (!("base" in expr)) {
+        return { path: path + "/base", message: "base is required" };
+      }
+      if (!("key" in expr)) {
+        return { path: path + "/key", message: "key is required" };
+      }
+      {
+        const baseError = validateExpression(expr["base"], path + "/base");
+        if (baseError) return baseError;
+        const keyError = validateExpression(expr["key"], path + "/key");
+        if (keyError) return keyError;
+      }
+      break;
   }
   return null;
 }
@@ -1067,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" };
+    return { path: path + "/do", message: "must be one of: set, update, fetch, delay, interval, clearTimer, focus" };
   }
   switch (doType) {
     case "set":
@@ -1110,6 +1140,50 @@ function validateActionStep(step, path) {
         if (bodyError) return bodyError;
       }
       break;
+    case "delay":
+      if (!("ms" in step)) {
+        return { path: path + "/ms", message: "ms is required" };
+      }
+      if (!("then" in step)) {
+        return { path: path + "/then", message: "then is required" };
+      }
+      {
+        const msError = validateExpression(step["ms"], path + "/ms");
+        if (msError) return msError;
+        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;
+        }
+      }
+      break;
+    case "interval":
+      if (!("ms" in step)) {
+        return { path: path + "/ms", message: "ms is required" };
+      }
+      if (typeof step["action"] !== "string") {
+        return { path: path + "/action", message: "action is required" };
+      }
+      {
+        const msError = validateExpression(step["ms"], path + "/ms");
+        if (msError) return msError;
+      }
+      break;
+    case "clearTimer":
+      if (!("target" in step)) {
+        return { path: path + "/target", message: "target is required" };
+      }
+      return validateExpression(step["target"], path + "/target");
+    case "focus":
+      if (!("target" in step)) {
+        return { path: path + "/target", message: "target is required" };
+      }
+      if (typeof step["operation"] !== "string") {
+        return { path: path + "/operation", message: "operation is required" };
+      }
+      return validateExpression(step["target"], path + "/target");
   }
   return null;
 }

package/package.json

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