@constela/runtime 0.19.5 → 0.19.6

package/dist/index.d.ts

@@ -480,6 +480,13 @@ interface HMRHandlerOptions {
     program: CompiledProgram;
     /** Optional route context */
     route?: RouteContext;
+    /**
+     * Skip initial app creation (for hydration scenarios where hydrateApp handles initial render).
+     * When true, the HMR handler will NOT render the app on creation. The first handleUpdate()
+     * call will clear the container (removing SSR content) before rendering.
+     * @default false
+     */
+    skipInitialRender?: boolean;
 }
 /**
  * HMR Handler interface

package/dist/index.js

@@ -1337,6 +1337,9 @@ async function executeStep(step, ctx) {
     case "focus":
       await executeFocusStep(step, ctx);
       break;
+    case "generate":
+      await executeGenerateStep(step, ctx);
+      break;
   }
 }
 async function executeSetStep(target, value, ctx) {
@@ -1834,6 +1837,48 @@ async function executeFocusStep(step, ctx) {
     }
   }
 }
+async function executeGenerateStep(step, ctx) {
+  const { createDslGenerator } = await import("@constela/ai");
+  const evalCtx = createEvalContext(ctx);
+  const promptValue = evaluate(step.prompt, evalCtx);
+  try {
+    const generator = createDslGenerator({
+      provider: step.provider
+    });
+    const result = await generator.generate({
+      prompt: promptValue,
+      output: step.output
+    });
+    ctx.locals[step.result] = result.dsl;
+    if (!result.validated && result.errors && result.errors.length > 0) {
+      ctx.locals["error"] = {
+        message: `AI generated DSL validation failed: ${result.errors.join(", ")}`,
+        name: "ValidationError"
+      };
+      if (step.onError) {
+        for (const errorStep of step.onError) {
+          await executeStep(errorStep, ctx);
+        }
+      }
+      return;
+    }
+    if (step.onSuccess) {
+      for (const successStep of step.onSuccess) {
+        await executeStep(successStep, ctx);
+      }
+    }
+  } catch (err) {
+    ctx.locals["error"] = {
+      message: err instanceof Error ? err.message : String(err),
+      name: err instanceof Error ? err.name : "Error"
+    };
+    if (step.onError) {
+      for (const errorStep of step.onError) {
+        await executeStep(errorStep, ctx);
+      }
+    }
+  }
+}
 
 // ../../node_modules/.pnpm/marked@17.0.1/node_modules/marked/lib/marked.esm.js
 function L() {
@@ -15906,21 +15951,27 @@ function createHMRApp(program, container, route, existingStateStore) {
   };
 }
 function createHMRHandler(options) {
-  const { container, program, route } = options;
+  const { container, program, route, skipInitialRender } = options;
   let currentApp = null;
   let destroyed = false;
-  currentApp = createHMRApp(program, container, route);
+  if (!skipInitialRender) {
+    currentApp = createHMRApp(program, container, route);
+  }
   return {
     handleUpdate(newProgram) {
       if (destroyed) {
         return;
       }
-      let stateSnapshot = {};
-      if (currentApp) {
-        stateSnapshot = currentApp.stateStore.serialize();
-        currentApp.destroy();
-        currentApp = null;
+      if (!currentApp) {
+        while (container.firstChild) {
+          container.removeChild(container.firstChild);
+        }
+        currentApp = createHMRApp(newProgram, container, route);
+        return;
       }
+      const stateSnapshot = currentApp.stateStore.serialize();
+      currentApp.destroy();
+      currentApp = null;
       const newStateStore = createStateStore(newProgram.state);
       const newDefinitions = Object.entries(newProgram.state).map(
         ([name, def]) => ({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constela/runtime",
-  "version": "0.19.5",
+  "version": "0.19.6",
   "description": "Runtime DOM renderer for Constela UI framework",
   "type": "module",
   "main": "./dist/index.js",
@@ -18,8 +18,8 @@
     "dompurify": "^3.3.1",
     "marked": "^17.0.1",
     "shiki": "^3.20.0",
-    "@constela/compiler": "0.14.6",
-    "@constela/core": "0.16.1"
+    "@constela/compiler": "0.14.7",
+    "@constela/core": "0.16.2"
   },
   "devDependencies": {
     "@types/dompurify": "^3.2.0",
@@ -29,7 +29,15 @@
     "tsup": "^8.0.0",
     "typescript": "^5.3.0",
     "vitest": "^2.0.0",
-    "@constela/server": "12.0.1"
+    "@constela/server": "12.0.2"
+  },
+  "peerDependencies": {
+    "@constela/ai": "1.0.2"
+  },
+  "peerDependenciesMeta": {
+    "@constela/ai": {
+      "optional": true
+    }
   },
   "engines": {
     "node": ">=20.0.0"