@constela/core 0.16.1 → 0.17.0

package/dist/index.js

@@ -1,3 +1,49 @@
+// src/types/theme.ts
+var COLOR_SCHEMES = ["light", "dark", "system"];
+function isObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isColorScheme(value) {
+  return typeof value === "string" && COLOR_SCHEMES.includes(value);
+}
+function isThemeColors(value) {
+  if (!isObject(value)) return false;
+  for (const val of Object.values(value)) {
+    if (val !== void 0 && typeof val !== "string") {
+      return false;
+    }
+  }
+  return true;
+}
+function isThemeFonts(value) {
+  if (!isObject(value)) return false;
+  for (const val of Object.values(value)) {
+    if (val !== void 0 && typeof val !== "string") {
+      return false;
+    }
+  }
+  return true;
+}
+function isThemeConfig(value) {
+  if (!isObject(value)) return false;
+  if ("mode" in value && value["mode"] !== void 0) {
+    if (!isColorScheme(value["mode"])) return false;
+  }
+  if ("colors" in value && value["colors"] !== void 0) {
+    if (!isThemeColors(value["colors"])) return false;
+  }
+  if ("darkColors" in value && value["darkColors"] !== void 0) {
+    if (!isThemeColors(value["darkColors"])) return false;
+  }
+  if ("fonts" in value && value["fonts"] !== void 0) {
+    if (!isThemeFonts(value["fonts"])) return false;
+  }
+  if ("cssPrefix" in value && value["cssPrefix"] !== void 0) {
+    if (typeof value["cssPrefix"] !== "string") return false;
+  }
+  return true;
+}
+
 // src/types/ast.ts
 var BINARY_OPERATORS = [
   "+",
@@ -43,46 +89,49 @@ var VALIDITY_PROPERTIES = [
   "message"
 ];
 var NAVIGATE_TARGETS = ["_self", "_blank"];
+var ISLAND_STRATEGIES = ["load", "idle", "visible", "interaction", "media", "never"];
 var PARAM_TYPES = ["string", "number", "boolean", "json"];
 var DATA_TRANSFORMS = ["mdx", "yaml", "csv"];
-var DATA_SOURCE_TYPES = ["glob", "file", "api"];
+var DATA_SOURCE_TYPES = ["glob", "file", "api", "ai"];
+var AI_PROVIDER_TYPES = ["anthropic", "openai"];
+var AI_OUTPUT_TYPES = ["component", "view"];
 
 // src/types/guards.ts
-function isObject(value) {
+function isObject2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function isLitExpr(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (value["expr"] !== "lit") return false;
   return "value" in value;
 }
 function isStateExpr(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (value["expr"] !== "state") return false;
   return typeof value["name"] === "string";
 }
 function isVarExpr(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (value["expr"] !== "var") return false;
   return typeof value["name"] === "string";
 }
 function isBinExpr(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (value["expr"] !== "bin") return false;
   if (!BINARY_OPERATORS.includes(value["op"])) {
     return false;
   }
-  if (!isObject(value["left"]) || !isObject(value["right"])) return false;
+  if (!isObject2(value["left"]) || !isObject2(value["right"])) return false;
   return true;
 }
 function isNotExpr(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (value["expr"] !== "not") return false;
-  if (!isObject(value["operand"])) return false;
+  if (!isObject2(value["operand"])) return false;
   return true;
 }
 function isParamExpr(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (value["expr"] !== "param") return false;
   if (typeof value["name"] !== "string") return false;
   if ("path" in value && value["path"] !== void 0) {
@@ -91,20 +140,20 @@ function isParamExpr(value) {
   return true;
 }
 function isCondExpr(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (value["expr"] !== "cond") return false;
-  if (!isObject(value["if"]) || !isObject(value["then"]) || !isObject(value["else"])) return false;
+  if (!isObject2(value["if"]) || !isObject2(value["then"]) || !isObject2(value["else"])) return false;
   return true;
 }
 function isGetExpr(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (value["expr"] !== "get") return false;
-  if (!isObject(value["base"])) return false;
+  if (!isObject2(value["base"])) return false;
   if (typeof value["path"] !== "string") return false;
   return true;
 }
 function isRouteExpr(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (value["expr"] !== "route") return false;
   if (typeof value["name"] !== "string") return false;
   if ("source" in value && value["source"] !== void 0) {
@@ -114,7 +163,7 @@ function isRouteExpr(value) {
   return true;
 }
 function isImportExpr(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (value["expr"] !== "import") return false;
   if (typeof value["name"] !== "string") return false;
   if ("path" in value && value["path"] !== void 0) {
@@ -123,7 +172,7 @@ function isImportExpr(value) {
   return true;
 }
 function isDataExpr(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (value["expr"] !== "data") return false;
   if (typeof value["name"] !== "string") return false;
   if ("path" in value && value["path"] !== void 0) {
@@ -132,23 +181,23 @@ function isDataExpr(value) {
   return true;
 }
 function isRefExpr(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (value["expr"] !== "ref") return false;
   return typeof value["name"] === "string";
 }
 function isIndexExpr(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (value["expr"] !== "index") return false;
   if (!("base" in value)) return false;
   if (!("key" in value)) return false;
   return true;
 }
 function isStyleExpr(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (value["expr"] !== "style") return false;
   if (typeof value["name"] !== "string") return false;
   if ("variants" in value && value["variants"] !== void 0) {
-    if (!isObject(value["variants"])) return false;
+    if (!isObject2(value["variants"])) return false;
   }
   return true;
 }
@@ -159,7 +208,7 @@ 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 (!isObject2(value)) return false;
   if (value["expr"] !== "validity") return false;
   if (typeof value["ref"] !== "string") return false;
   if ("property" in value && value["property"] !== void 0) {
@@ -170,7 +219,7 @@ function isValidityExpr(value) {
   return true;
 }
 function isDataSource(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   const type = value["type"];
   if (!DATA_SOURCE_TYPES.includes(type)) {
     return false;
@@ -190,17 +239,36 @@ function isDataSource(value) {
     case "api":
       if (typeof value["url"] !== "string") return false;
       break;
+    case "ai":
+      return isAiDataSource(value);
   }
   return true;
 }
+function isAiDataSource(value) {
+  if (!isObject2(value)) return false;
+  if (value["type"] !== "ai") return false;
+  if (!AI_PROVIDER_TYPES.includes(value["provider"])) return false;
+  if (typeof value["prompt"] !== "string") return false;
+  if (!AI_OUTPUT_TYPES.includes(value["output"])) return false;
+  return true;
+}
+function isGenerateStep(value) {
+  if (!isObject2(value)) return false;
+  if (value["do"] !== "generate") return false;
+  if (!AI_PROVIDER_TYPES.includes(value["provider"])) return false;
+  if (!("prompt" in value)) return false;
+  if (!AI_OUTPUT_TYPES.includes(value["output"])) return false;
+  if (typeof value["result"] !== "string") return false;
+  return true;
+}
 function isStaticPathsDefinition(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (typeof value["source"] !== "string") return false;
-  if (!("params" in value) || !isObject(value["params"])) return false;
+  if (!("params" in value) || !isObject2(value["params"])) return false;
   return true;
 }
 function isRouteDefinition(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (typeof value["path"] !== "string") return false;
   return true;
 }
@@ -208,36 +276,36 @@ 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) || isArrayExpr(value);
 }
 function isElementNode(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (value["kind"] !== "element") return false;
   return typeof value["tag"] === "string";
 }
 function isTextNode(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (value["kind"] !== "text") return false;
-  return isObject(value["value"]);
+  return isObject2(value["value"]);
 }
 function isIfNode(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (value["kind"] !== "if") return false;
-  if (!isObject(value["condition"])) return false;
-  if (!isObject(value["then"])) return false;
+  if (!isObject2(value["condition"])) return false;
+  if (!isObject2(value["then"])) return false;
   return true;
 }
 function isEachNode(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (value["kind"] !== "each") return false;
-  if (!isObject(value["items"])) return false;
+  if (!isObject2(value["items"])) return false;
   if (typeof value["as"] !== "string") return false;
-  if (!isObject(value["body"])) return false;
+  if (!isObject2(value["body"])) return false;
   return true;
 }
 function isComponentNode(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (value["kind"] !== "component") return false;
   if (typeof value["name"] !== "string") return false;
   if ("props" in value && value["props"] !== void 0) {
-    if (!isObject(value["props"])) return false;
+    if (!isObject2(value["props"])) return false;
   }
   if ("children" in value && value["children"] !== void 0) {
     if (!Array.isArray(value["children"])) return false;
@@ -245,40 +313,107 @@ function isComponentNode(value) {
   return true;
 }
 function isSlotNode(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   return value["kind"] === "slot";
 }
 function isMarkdownNode(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (value["kind"] !== "markdown") return false;
-  return "content" in value && isObject(value["content"]);
+  return "content" in value && isObject2(value["content"]);
 }
 function isCodeNode(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (value["kind"] !== "code") return false;
-  if (!("language" in value) || !isObject(value["language"])) return false;
-  if (!("content" in value) || !isObject(value["content"])) return false;
+  if (!("language" in value) || !isObject2(value["language"])) return false;
+  if (!("content" in value) || !isObject2(value["content"])) return false;
   return true;
 }
 function isPortalNode(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (value["kind"] !== "portal") return false;
   if (typeof value["target"] !== "string") return false;
   if (!Array.isArray(value["children"])) return false;
   return true;
 }
+function isIslandStrategy(value) {
+  return typeof value === "string" && ISLAND_STRATEGIES.includes(value);
+}
+function isIslandStrategyOptions(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    return false;
+  }
+  const obj = value;
+  if (obj["threshold"] !== void 0) {
+    if (typeof obj["threshold"] !== "number" || obj["threshold"] < 0 || obj["threshold"] > 1) {
+      return false;
+    }
+  }
+  if (obj["rootMargin"] !== void 0 && typeof obj["rootMargin"] !== "string") {
+    return false;
+  }
+  if (obj["media"] !== void 0 && typeof obj["media"] !== "string") {
+    return false;
+  }
+  if (obj["timeout"] !== void 0) {
+    if (typeof obj["timeout"] !== "number" || obj["timeout"] < 0) {
+      return false;
+    }
+  }
+  return true;
+}
+function isIslandNode(value) {
+  if (!isObject2(value)) return false;
+  if (value["kind"] !== "island") return false;
+  if (typeof value["id"] !== "string") return false;
+  if (!isIslandStrategy(value["strategy"])) return false;
+  if ("strategyOptions" in value && value["strategyOptions"] !== void 0) {
+    if (!isIslandStrategyOptions(value["strategyOptions"])) return false;
+  }
+  if (!("content" in value) || !isObject2(value["content"])) return false;
+  const content = value["content"];
+  const validKinds = ["element", "text", "if", "each", "component", "slot", "markdown", "code", "portal", "island"];
+  if (!validKinds.includes(content["kind"])) {
+    return false;
+  }
+  return true;
+}
+function isSuspenseNode(value) {
+  if (!isObject2(value)) return false;
+  if (value["kind"] !== "suspense") return false;
+  if (typeof value["id"] !== "string") return false;
+  if (!("fallback" in value) || !isObject2(value["fallback"])) return false;
+  if (!("content" in value) || !isObject2(value["content"])) return false;
+  const validKinds = ["element", "text", "if", "each", "component", "slot", "markdown", "code", "portal", "island", "suspense", "errorBoundary"];
+  const fallback = value["fallback"];
+  const content = value["content"];
+  if (!validKinds.includes(fallback["kind"])) return false;
+  if (!validKinds.includes(content["kind"])) return false;
+  return true;
+}
+function isErrorBoundaryNode(value) {
+  if (!isObject2(value)) return false;
+  if (value["kind"] !== "errorBoundary") return false;
+  if (!("fallback" in value) || !isObject2(value["fallback"])) return false;
+  if (!("content" in value) || !isObject2(value["content"])) return false;
+  const validKinds = ["element", "text", "if", "each", "component", "slot", "markdown", "code", "portal", "island", "suspense", "errorBoundary"];
+  const fallback = value["fallback"];
+  const content = value["content"];
+  if (!validKinds.includes(fallback["kind"])) return false;
+  if (!validKinds.includes(content["kind"])) return false;
+  return true;
+}
 function isViewNode(value) {
-  return isElementNode(value) || isTextNode(value) || isIfNode(value) || isEachNode(value) || isComponentNode(value) || isSlotNode(value) || isMarkdownNode(value) || isCodeNode(value) || isPortalNode(value);
+  return isElementNode(value) || isTextNode(value) || isIfNode(value) || isEachNode(value) || isComponentNode(value) || isSlotNode(value) || isMarkdownNode(value) || isCodeNode(value) || isPortalNode(value) || isIslandNode(value) || isSuspenseNode(value) || isErrorBoundaryNode(value);
 }
 function isSetStep(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (value["do"] !== "set") return false;
   if (typeof value["target"] !== "string") return false;
-  if (!isObject(value["value"])) return false;
+  if (!isObject2(value["value"])) return false;
   return true;
 }
 function isUpdateStep(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (value["do"] !== "update") return false;
   if (typeof value["target"] !== "string") return false;
   if (!UPDATE_OPERATIONS.includes(value["operation"])) {
@@ -287,17 +422,17 @@ function isUpdateStep(value) {
   return true;
 }
 function isSetPathStep(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(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;
+  if (!isObject2(value["path"])) return false;
+  if (!isObject2(value["value"])) return false;
   return true;
 }
 function isFetchStep(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (value["do"] !== "fetch") return false;
-  if (!isObject(value["url"])) return false;
+  if (!isObject2(value["url"])) return false;
   if ("method" in value && value["method"] !== void 0) {
     if (!HTTP_METHODS.includes(value["method"])) {
       return false;
@@ -306,7 +441,7 @@ function isFetchStep(value) {
   return true;
 }
 function isStorageStep(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (value["do"] !== "storage") return false;
   if (!STORAGE_OPERATIONS.includes(value["operation"])) {
     return false;
@@ -318,7 +453,7 @@ function isStorageStep(value) {
   return true;
 }
 function isClipboardStep(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (value["do"] !== "clipboard") return false;
   if (!CLIPBOARD_OPERATIONS.includes(value["operation"])) {
     return false;
@@ -326,7 +461,7 @@ function isClipboardStep(value) {
   return true;
 }
 function isNavigateStep(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (value["do"] !== "navigate") return false;
   if (!("url" in value)) return false;
   if ("target" in value && value["target"] !== void 0) {
@@ -337,69 +472,69 @@ function isNavigateStep(value) {
   return true;
 }
 function isImportStep(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (value["do"] !== "import") return false;
   if (typeof value["module"] !== "string") return false;
   if (typeof value["result"] !== "string") return false;
   return true;
 }
 function isCallStep(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (value["do"] !== "call") return false;
-  if (!isObject(value["target"])) return false;
+  if (!isObject2(value["target"])) return false;
   return true;
 }
 function isSubscribeStep(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (value["do"] !== "subscribe") return false;
-  if (!isObject(value["target"])) return false;
+  if (!isObject2(value["target"])) return false;
   if (typeof value["event"] !== "string") return false;
   if (typeof value["action"] !== "string") return false;
   return true;
 }
 function isDisposeStep(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (value["do"] !== "dispose") return false;
-  if (!isObject(value["target"])) return false;
+  if (!isObject2(value["target"])) return false;
   return true;
 }
 function isDelayStep(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (value["do"] !== "delay") return false;
-  if (!isObject(value["ms"])) return false;
+  if (!isObject2(value["ms"])) return false;
   if (!Array.isArray(value["then"])) return false;
   return true;
 }
 function isIntervalStep(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (value["do"] !== "interval") return false;
-  if (!isObject(value["ms"])) return false;
+  if (!isObject2(value["ms"])) return false;
   if (typeof value["action"] !== "string") return false;
   return true;
 }
 function isClearTimerStep(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (value["do"] !== "clearTimer") return false;
-  if (!isObject(value["target"])) return false;
+  if (!isObject2(value["target"])) return false;
   return true;
 }
 function isFocusStep(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (value["do"] !== "focus") return false;
-  if (!isObject(value["target"])) return false;
+  if (!isObject2(value["target"])) return false;
   if (!FOCUS_OPERATIONS.includes(value["operation"])) {
     return false;
   }
   return true;
 }
 function isActionStep(value) {
-  return isSetStep(value) || isUpdateStep(value) || isSetPathStep(value) || isFetchStep(value) || isStorageStep(value) || isClipboardStep(value) || isNavigateStep(value) || isImportStep(value) || isCallStep(value) || isSubscribeStep(value) || isDisposeStep(value) || isDelayStep(value) || isIntervalStep(value) || isClearTimerStep(value) || isFocusStep(value);
+  return isSetStep(value) || isUpdateStep(value) || isSetPathStep(value) || isFetchStep(value) || isStorageStep(value) || isClipboardStep(value) || isNavigateStep(value) || isImportStep(value) || isCallStep(value) || isSubscribeStep(value) || isDisposeStep(value) || isDelayStep(value) || isIntervalStep(value) || isClearTimerStep(value) || isFocusStep(value) || isGenerateStep(value);
 }
 function isLocalActionStep(value) {
   return isSetStep(value) || isUpdateStep(value) || isSetPathStep(value);
 }
 function isLocalActionDefinition(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (typeof value["name"] !== "string") return false;
   if (!Array.isArray(value["steps"])) return false;
   for (const step of value["steps"]) {
@@ -408,7 +543,7 @@ function isLocalActionDefinition(value) {
   return true;
 }
 function isNumberField(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (value["type"] !== "number") return false;
   return typeof value["initial"] === "number";
 }
@@ -416,22 +551,22 @@ function isCookieInitialExpr(value) {
   return typeof value === "object" && value !== null && "expr" in value && value.expr === "cookie" && "key" in value && typeof value.key === "string" && "default" in value && typeof value.default === "string";
 }
 function isStringField(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (value["type"] !== "string") return false;
   return typeof value["initial"] === "string" || isCookieInitialExpr(value["initial"]);
 }
 function isListField(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (value["type"] !== "list") return false;
   return Array.isArray(value["initial"]);
 }
 function isBooleanField(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (value["type"] !== "boolean") return false;
   return typeof value["initial"] === "boolean";
 }
 function isObjectField(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (value["type"] !== "object") return false;
   return typeof value["initial"] === "object" && value["initial"] !== null;
 }
@@ -439,20 +574,20 @@ function isStateField(value) {
   return isNumberField(value) || isStringField(value) || isListField(value) || isBooleanField(value) || isObjectField(value);
 }
 function isEventHandler(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (!("event" in value) || typeof value["event"] !== "string") return false;
   if (!("action" in value) || typeof value["action"] !== "string") return false;
   return true;
 }
 function isLayoutProgram(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (value["version"] !== "1.0") return false;
   if (value["type"] !== "layout") return false;
   if (!("view" in value)) return false;
   return true;
 }
 function isNamedSlotNode(value) {
-  if (!isObject(value)) return false;
+  if (!isObject2(value)) return false;
   if (value["kind"] !== "slot") return false;
   if (typeof value["name"] !== "string") return false;
   return true;
@@ -798,6 +933,16 @@ function createLocalActionInvalidStepError(stepType, path) {
     path
   );
 }
+function createDuplicateIslandIdError(id, path, suggestions) {
+  return new ConstelaError(
+    "DUPLICATE_ISLAND_ID",
+    `Duplicate island ID: "${id}"`,
+    path,
+    {
+      suggestion: suggestions?.[0] ?? "Use a unique ID for each island"
+    }
+  );
+}
 function levenshteinDistance(a, b) {
   const aLen = a.length;
   const bLen = b.length;
@@ -839,10 +984,10 @@ function findSimilarNames(target, candidates, maxDistance = 2) {
 }
 
 // src/schema/validator.ts
-function isObject2(value) {
+function isObject3(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_VIEW_KINDS = ["element", "text", "if", "each", "component", "slot", "markdown", "code", "portal", "island"];
 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", "setPath", "fetch", "delay", "interval", "clearTimer", "focus", "if"];
@@ -851,7 +996,7 @@ var VALID_BIN_OPS = BINARY_OPERATORS;
 var VALID_UPDATE_OPS = UPDATE_OPERATIONS;
 var VALID_HTTP_METHODS = HTTP_METHODS;
 function validateViewNode(node, path) {
-  if (!isObject2(node)) {
+  if (!isObject3(node)) {
     return { path, message: "must be an object" };
   }
   const kind = node["kind"];
@@ -866,9 +1011,9 @@ function validateViewNode(node, path) {
       if (typeof node["tag"] !== "string") {
         return { path: path + "/tag", message: "tag is required" };
       }
-      if (node["props"] !== void 0 && isObject2(node["props"])) {
+      if (node["props"] !== void 0 && isObject3(node["props"])) {
         for (const [propName, propValue] of Object.entries(node["props"])) {
-          if (isObject2(propValue) && "event" in propValue) {
+          if (isObject3(propValue) && "event" in propValue) {
           } else {
             const error = validateExpression(propValue, path + "/props/" + propName);
             if (error) return error;
@@ -926,7 +1071,7 @@ function validateViewNode(node, path) {
       if (typeof node["name"] !== "string") {
         return { path: path + "/name", message: "name is required" };
       }
-      if (node["props"] !== void 0 && isObject2(node["props"])) {
+      if (node["props"] !== void 0 && isObject3(node["props"])) {
         for (const [propName, propValue] of Object.entries(node["props"])) {
           const error = validateExpression(propValue, path + "/props/" + propName);
           if (error) return error;
@@ -969,11 +1114,90 @@ function validateViewNode(node, path) {
         }
       }
       break;
+    case "island":
+      if (typeof node["id"] !== "string" || node["id"] === "") {
+        return { path: path + "/id", message: "id is required and must be a non-empty string" };
+      }
+      if (typeof node["strategy"] !== "string") {
+        return { path: path + "/strategy", message: "strategy is required" };
+      }
+      if (!ISLAND_STRATEGIES.includes(node["strategy"])) {
+        return { path: path + "/strategy", message: `must be one of: ${ISLAND_STRATEGIES.join(", ")}` };
+      }
+      if (!("content" in node)) {
+        return { path: path + "/content", message: "content is required" };
+      }
+      {
+        const contentError = validateViewNode(node["content"], path + "/content");
+        if (contentError) return contentError;
+      }
+      if ("strategyOptions" in node && node["strategyOptions"] !== void 0) {
+        if (!isObject3(node["strategyOptions"])) {
+          return { path: path + "/strategyOptions", message: "strategyOptions must be an object" };
+        }
+        const opts = node["strategyOptions"];
+        if ("threshold" in opts && opts["threshold"] !== void 0) {
+          if (typeof opts["threshold"] !== "number" || opts["threshold"] < 0 || opts["threshold"] > 1) {
+            return { path: path + "/strategyOptions/threshold", message: "threshold must be a number between 0 and 1" };
+          }
+        }
+        if ("rootMargin" in opts && opts["rootMargin"] !== void 0) {
+          if (typeof opts["rootMargin"] !== "string") {
+            return { path: path + "/strategyOptions/rootMargin", message: "rootMargin must be a string" };
+          }
+        }
+        if ("event" in opts && opts["event"] !== void 0) {
+          if (typeof opts["event"] !== "string") {
+            return { path: path + "/strategyOptions/event", message: "event must be a string" };
+          }
+        }
+        if ("media" in opts && opts["media"] !== void 0) {
+          if (typeof opts["media"] !== "string") {
+            return { path: path + "/strategyOptions/media", message: "media must be a string" };
+          }
+        }
+        if ("timeout" in opts && opts["timeout"] !== void 0) {
+          if (typeof opts["timeout"] !== "number" || opts["timeout"] < 0) {
+            return { path: path + "/strategyOptions/timeout", message: "timeout must be a non-negative number" };
+          }
+        }
+      }
+      if ("state" in node && node["state"] !== void 0) {
+        if (!isObject3(node["state"])) {
+          return { path: path + "/state", message: "state must be an object" };
+        }
+        for (const [name, field] of Object.entries(node["state"])) {
+          const error = validateStateField(field, path + "/state/" + name);
+          if (error) return error;
+        }
+      }
+      if ("actions" in node && node["actions"] !== void 0) {
+        if (!Array.isArray(node["actions"])) {
+          return { path: path + "/actions", message: "actions must be an array" };
+        }
+        for (let i = 0; i < node["actions"].length; i++) {
+          const action = node["actions"][i];
+          if (!isObject3(action)) {
+            return { path: path + "/actions/" + i, message: "action must be an object" };
+          }
+          if (typeof action["name"] !== "string") {
+            return { path: path + "/actions/" + i + "/name", message: "name is required" };
+          }
+          if (!Array.isArray(action["steps"])) {
+            return { path: path + "/actions/" + i + "/steps", message: "steps is required" };
+          }
+          for (let j = 0; j < action["steps"].length; j++) {
+            const error = validateActionStep(action["steps"][j], path + "/actions/" + i + "/steps/" + j);
+            if (error) return error;
+          }
+        }
+      }
+      break;
   }
   return null;
 }
 function validateExpression(expr, path) {
-  if (!isObject2(expr)) {
+  if (!isObject3(expr)) {
     return { path, message: "must be an object" };
   }
   const exprType = expr["expr"];
@@ -1060,7 +1284,7 @@ function validateExpression(expr, path) {
         return { path: path + "/name", message: "name is required" };
       }
       if ("variants" in expr && expr["variants"] !== void 0) {
-        if (!isObject2(expr["variants"])) {
+        if (!isObject3(expr["variants"])) {
           return { path: path + "/variants", message: "variants must be an object" };
         }
         for (const [variantKey, variantValue] of Object.entries(expr["variants"])) {
@@ -1140,7 +1364,7 @@ function validateExpression(expr, path) {
   return null;
 }
 function validateActionStep(step, path) {
-  if (!isObject2(step)) {
+  if (!isObject3(step)) {
     return { path, message: "must be an object" };
   }
   const doType = step["do"];
@@ -1282,7 +1506,7 @@ function validateActionStep(step, path) {
   return null;
 }
 function validateStateField(field, path) {
-  if (!isObject2(field)) {
+  if (!isObject3(field)) {
     return { path, message: "must be an object" };
   }
   const fieldType = field["type"];
@@ -1317,7 +1541,7 @@ function validateStateField(field, path) {
       }
       break;
     case "object":
-      if (!isObject2(field["initial"])) {
+      if (!isObject3(field["initial"])) {
         return { path: path + "/initial", message: "must be an object" };
       }
       break;
@@ -1325,7 +1549,7 @@ function validateStateField(field, path) {
   return null;
 }
 function validateParamDef(param, path) {
-  if (!isObject2(param)) {
+  if (!isObject3(param)) {
     return { path, message: "must be an object" };
   }
   const paramType = param["type"];
@@ -1341,13 +1565,13 @@ function validateParamDef(param, path) {
   return null;
 }
 function validateComponentDef(def, path) {
-  if (!isObject2(def)) {
+  if (!isObject3(def)) {
     return { path, message: "must be an object" };
   }
   if (!("view" in def)) {
     return { path: path + "/view", message: "view is required" };
   }
-  if ("params" in def && isObject2(def["params"])) {
+  if ("params" in def && isObject3(def["params"])) {
     for (const [paramName, paramDef] of Object.entries(def["params"])) {
       const error = validateParamDef(paramDef, path + "/params/" + paramName);
       if (error) return error;
@@ -1358,7 +1582,7 @@ function validateComponentDef(def, path) {
   return null;
 }
 function validateStylePreset(preset, path) {
-  if (!isObject2(preset)) {
+  if (!isObject3(preset)) {
     return { path, message: "must be an object" };
   }
   if (!("base" in preset)) {
@@ -1368,11 +1592,11 @@ function validateStylePreset(preset, path) {
     return { path: path + "/base", message: "base must be a string" };
   }
   if ("variants" in preset && preset["variants"] !== void 0) {
-    if (!isObject2(preset["variants"])) {
+    if (!isObject3(preset["variants"])) {
       return { path: path + "/variants", message: "variants must be an object" };
     }
     for (const [variantKey, variantOptions] of Object.entries(preset["variants"])) {
-      if (!isObject2(variantOptions)) {
+      if (!isObject3(variantOptions)) {
         return { path: path + "/variants/" + variantKey, message: "variant options must be an object" };
       }
       for (const [optionKey, optionValue] of Object.entries(variantOptions)) {
@@ -1383,10 +1607,10 @@ function validateStylePreset(preset, path) {
     }
   }
   if ("defaultVariants" in preset && preset["defaultVariants"] !== void 0) {
-    if (!isObject2(preset["defaultVariants"])) {
+    if (!isObject3(preset["defaultVariants"])) {
       return { path: path + "/defaultVariants", message: "defaultVariants must be an object" };
     }
-    const variantKeys = isObject2(preset["variants"]) ? Object.keys(preset["variants"]) : [];
+    const variantKeys = isObject3(preset["variants"]) ? Object.keys(preset["variants"]) : [];
     for (const [key, value] of Object.entries(preset["defaultVariants"])) {
       if (typeof value !== "string") {
         return { path: path + "/defaultVariants/" + key, message: "default variant value must be a string" };
@@ -1402,7 +1626,7 @@ function validateStylePreset(preset, path) {
     }
     for (let i = 0; i < preset["compoundVariants"].length; i++) {
       const compound = preset["compoundVariants"][i];
-      if (!isObject2(compound)) {
+      if (!isObject3(compound)) {
         return { path: path + "/compoundVariants/" + i, message: "compound variant must be an object" };
       }
       if (typeof compound["class"] !== "string") {
@@ -1413,13 +1637,13 @@ function validateStylePreset(preset, path) {
   return null;
 }
 function customValidateAst(input) {
-  if (isObject2(input["state"])) {
+  if (isObject3(input["state"])) {
     for (const [name, field] of Object.entries(input["state"])) {
       const error = validateStateField(field, "/state/" + name);
       if (error) return error;
     }
   }
-  if ("styles" in input && isObject2(input["styles"])) {
+  if ("styles" in input && isObject3(input["styles"])) {
     for (const [name, preset] of Object.entries(input["styles"])) {
       const error = validateStylePreset(preset, "/styles/" + name);
       if (error) return error;
@@ -1428,7 +1652,7 @@ function customValidateAst(input) {
   if (Array.isArray(input["actions"])) {
     for (let i = 0; i < input["actions"].length; i++) {
       const action = input["actions"][i];
-      if (isObject2(action) && Array.isArray(action["steps"])) {
+      if (isObject3(action) && Array.isArray(action["steps"])) {
         for (let j = 0; j < action["steps"].length; j++) {
           const error = validateActionStep(action["steps"][j], "/actions/" + i + "/steps/" + j);
           if (error) return error;
@@ -1440,7 +1664,7 @@ function customValidateAst(input) {
     const error = validateViewNode(input["view"], "/view");
     if (error) return error;
   }
-  if ("components" in input && isObject2(input["components"])) {
+  if ("components" in input && isObject3(input["components"])) {
     for (const [name, def] of Object.entries(input["components"])) {
       const error = validateComponentDef(def, "/components/" + name);
       if (error) return error;
@@ -1460,14 +1684,14 @@ function createErrorOptionsWithSuggestion(name, availableNames) {
 function collectSemanticContext(ast) {
   const stateNames = /* @__PURE__ */ new Set();
   const actionNames = /* @__PURE__ */ new Set();
-  if (isObject2(ast["state"])) {
+  if (isObject3(ast["state"])) {
     for (const name of Object.keys(ast["state"])) {
       stateNames.add(name);
     }
   }
   if (Array.isArray(ast["actions"])) {
     for (const action of ast["actions"]) {
-      if (isObject2(action) && typeof action["name"] === "string") {
+      if (isObject3(action) && typeof action["name"] === "string") {
         actionNames.add(action["name"]);
       }
     }
@@ -1475,7 +1699,26 @@ function collectSemanticContext(ast) {
   return { stateNames, actionNames };
 }
 function validateStateReferences(node, path, stateNames) {
-  if (!isObject2(node)) return null;
+  if (!isObject3(node)) return null;
+  if (node["kind"] === "island") {
+    const islandStateNames = new Set(stateNames);
+    if (isObject3(node["state"])) {
+      for (const name of Object.keys(node["state"])) {
+        islandStateNames.add(name);
+      }
+    }
+    if (isObject3(node["content"])) {
+      const error = validateStateReferences(node["content"], path + "/content", islandStateNames);
+      if (error) return error;
+    }
+    if (Array.isArray(node["actions"])) {
+      for (let i = 0; i < node["actions"].length; i++) {
+        const error = validateStateReferences(node["actions"][i], path + "/actions/" + i, islandStateNames);
+        if (error) return error;
+      }
+    }
+    return null;
+  }
   if (node["expr"] === "state" && typeof node["name"] === "string") {
     if (!stateNames.has(node["name"])) {
       const errorOptions = createErrorOptionsWithSuggestion(node["name"], stateNames);
@@ -1483,7 +1726,7 @@ function validateStateReferences(node, path, stateNames) {
     }
   }
   for (const [key, value] of Object.entries(node)) {
-    if (isObject2(value)) {
+    if (isObject3(value)) {
       const error = validateStateReferences(value, path + "/" + key, stateNames);
       if (error) return error;
     } else if (Array.isArray(value)) {
@@ -1499,10 +1742,10 @@ function validateActionTargets(ast, stateNames) {
   if (!Array.isArray(ast["actions"])) return null;
   for (let i = 0; i < ast["actions"].length; i++) {
     const action = ast["actions"][i];
-    if (!isObject2(action) || !Array.isArray(action["steps"])) continue;
+    if (!isObject3(action) || !Array.isArray(action["steps"])) continue;
     for (let j = 0; j < action["steps"].length; j++) {
       const step = action["steps"][j];
-      if (!isObject2(step)) continue;
+      if (!isObject3(step)) continue;
       if ((step["do"] === "set" || step["do"] === "update") && typeof step["target"] === "string") {
         if (!stateNames.has(step["target"])) {
           const errorOptions = createErrorOptionsWithSuggestion(step["target"], stateNames);
@@ -1514,10 +1757,25 @@ function validateActionTargets(ast, stateNames) {
   return null;
 }
 function validateActionReferences(node, path, actionNames) {
-  if (!isObject2(node)) return null;
-  if (isObject2(node["props"])) {
+  if (!isObject3(node)) return null;
+  if (node["kind"] === "island") {
+    const islandActionNames = new Set(actionNames);
+    if (Array.isArray(node["actions"])) {
+      for (const action of node["actions"]) {
+        if (isObject3(action) && typeof action["name"] === "string") {
+          islandActionNames.add(action["name"]);
+        }
+      }
+    }
+    if (isObject3(node["content"])) {
+      const error = validateActionReferences(node["content"], path + "/content", islandActionNames);
+      if (error) return error;
+    }
+    return null;
+  }
+  if (isObject3(node["props"])) {
     for (const [propName, propValue] of Object.entries(node["props"])) {
-      if (isObject2(propValue) && "event" in propValue && "action" in propValue) {
+      if (isObject3(propValue) && "event" in propValue && "action" in propValue) {
         const actionName = propValue["action"];
         if (typeof actionName === "string" && !actionNames.has(actionName)) {
           const errorOptions = createErrorOptionsWithSuggestion(actionName, actionNames);
@@ -1536,15 +1794,15 @@ function validateActionReferences(node, path, actionNames) {
       if (error) return error;
     }
   }
-  if (isObject2(node["then"])) {
+  if (isObject3(node["then"])) {
     const error = validateActionReferences(node["then"], path + "/then", actionNames);
     if (error) return error;
   }
-  if (isObject2(node["else"])) {
+  if (isObject3(node["else"])) {
     const error = validateActionReferences(node["else"], path + "/else", actionNames);
     if (error) return error;
   }
-  if (isObject2(node["body"])) {
+  if (isObject3(node["body"])) {
     const error = validateActionReferences(node["body"], path + "/body", actionNames);
     if (error) return error;
   }
@@ -1555,7 +1813,7 @@ function validateDuplicateActions(ast) {
   const seenNames = /* @__PURE__ */ new Set();
   for (let i = 0; i < ast["actions"].length; i++) {
     const action = ast["actions"][i];
-    if (!isObject2(action) || typeof action["name"] !== "string") continue;
+    if (!isObject3(action) || typeof action["name"] !== "string") continue;
     const name = action["name"];
     if (seenNames.has(name)) {
       return createDuplicateActionError(name, "/actions/" + i);
@@ -1568,20 +1826,20 @@ function performSemanticValidation(ast) {
   const { stateNames, actionNames } = collectSemanticContext(ast);
   const duplicateError = validateDuplicateActions(ast);
   if (duplicateError) return duplicateError;
-  if (isObject2(ast["view"])) {
+  if (isObject3(ast["view"])) {
     const stateRefError = validateStateReferences(ast["view"], "/view", stateNames);
     if (stateRefError) return stateRefError;
   }
   const actionTargetError = validateActionTargets(ast, stateNames);
   if (actionTargetError) return actionTargetError;
-  if (isObject2(ast["view"])) {
+  if (isObject3(ast["view"])) {
     const actionRefError = validateActionReferences(ast["view"], "/view", actionNames);
     if (actionRefError) return actionRefError;
   }
   return null;
 }
 function validateAst(input) {
-  if (!isObject2(input)) {
+  if (!isObject3(input)) {
     return {
       ok: false,
       error: createSchemaError("Input must be an object", "/")
@@ -2246,14 +2504,80 @@ var astSchema = {
     }
   }
 };
+
+// src/types/streaming.ts
+var FLUSH_STRATEGIES = ["immediate", "batched", "manual"];
+var STREAM_CHUNK_TYPES = [
+  "html",
+  "shell",
+  "fallback",
+  "resolved",
+  "end",
+  "error"
+];
+function isStreamingRenderOptions(value) {
+  if (typeof value !== "object" || value === null) {
+    return false;
+  }
+  const obj = value;
+  if (typeof obj["streaming"] !== "boolean") {
+    return false;
+  }
+  if (typeof obj["flushStrategy"] !== "string" || !FLUSH_STRATEGIES.includes(obj["flushStrategy"])) {
+    return false;
+  }
+  if (obj["batchTimeout"] !== void 0 && typeof obj["batchTimeout"] !== "number") {
+    return false;
+  }
+  return true;
+}
+function isSuspenseBoundary(value) {
+  if (typeof value !== "object" || value === null) {
+    return false;
+  }
+  const obj = value;
+  if (typeof obj["id"] !== "string") {
+    return false;
+  }
+  if (typeof obj["fallback"] !== "object" || obj["fallback"] === null) {
+    return false;
+  }
+  if (!(obj["promise"] instanceof Promise)) {
+    return false;
+  }
+  return true;
+}
+function isStreamChunk(value) {
+  if (typeof value !== "object" || value === null) {
+    return false;
+  }
+  const obj = value;
+  if (typeof obj["type"] !== "string" || !STREAM_CHUNK_TYPES.includes(obj["type"])) {
+    return false;
+  }
+  if (typeof obj["content"] !== "string") {
+    return false;
+  }
+  if (obj["boundaryId"] !== void 0 && typeof obj["boundaryId"] !== "string") {
+    return false;
+  }
+  if (obj["error"] !== void 0 && !(obj["error"] instanceof Error)) {
+    return false;
+  }
+  return true;
+}
 export {
+  AI_OUTPUT_TYPES,
+  AI_PROVIDER_TYPES,
   BINARY_OPERATORS,
   CLIPBOARD_OPERATIONS,
+  COLOR_SCHEMES,
   ConstelaError,
   DATA_SOURCE_TYPES,
   DATA_TRANSFORMS,
   FOCUS_OPERATIONS,
   HTTP_METHODS,
+  ISLAND_STRATEGIES,
   NAVIGATE_TARGETS,
   PARAM_TYPES,
   STORAGE_OPERATIONS,
@@ -2270,6 +2594,7 @@ export {
   createDataNotDefinedError,
   createDuplicateActionError,
   createDuplicateDefaultSlotError,
+  createDuplicateIslandIdError,
   createDuplicateSlotNameError,
   createImportsNotDefinedError,
   createInvalidClipboardOperationError,
@@ -2303,12 +2628,14 @@ export {
   createUnsupportedVersionError,
   findSimilarNames,
   isActionStep,
+  isAiDataSource,
   isArrayExpr,
   isBinExpr,
   isBooleanField,
   isCallStep,
   isClipboardStep,
   isCodeNode,
+  isColorScheme,
   isComponentNode,
   isConcatExpr,
   isCondExpr,
@@ -2319,14 +2646,19 @@ export {
   isDisposeStep,
   isEachNode,
   isElementNode,
+  isErrorBoundaryNode,
   isEventHandler,
   isExpression,
   isFetchStep,
   isFocusStep,
+  isGenerateStep,
   isGetExpr,
   isIfNode,
   isImportExpr,
   isImportStep,
+  isIslandNode,
+  isIslandStrategy,
+  isIslandStrategyOptions,
   isLayoutProgram,
   isLifecycleHooks,
   isListField,
@@ -2351,10 +2683,17 @@ export {
   isStateField,
   isStaticPathsDefinition,
   isStorageStep,
+  isStreamChunk,
+  isStreamingRenderOptions,
   isStringField,
   isStyleExpr,
   isSubscribeStep,
+  isSuspenseBoundary,
+  isSuspenseNode,
   isTextNode,
+  isThemeColors,
+  isThemeConfig,
+  isThemeFonts,
   isUpdateStep,
   isValidityExpr,
   isVarExpr,