@constela/server 13.0.0 → 14.0.1

package/README.md

@@ -201,6 +201,104 @@ Pass style presets via `RenderOptions.styles` for evaluation.
 .dark .shiki span { color: var(--shiki-dark); }
 ```
 
+## Streaming SSR
+
+Render to a ReadableStream for progressive HTML delivery:
+
+```typescript
+import { renderToStream, createHtmlTransformStream } from '@constela/server';
+
+// Render program to stream
+const contentStream = renderToStream(compiledProgram, {
+  flushStrategy: 'batched',
+}, {
+  route: { params: { id: '123' }, query: {}, path: '/posts/123' },
+  imports: { config: siteConfig },
+});
+
+// Wrap with HTML document structure
+const htmlStream = contentStream.pipeThrough(
+  createHtmlTransformStream({
+    title: 'My Page',
+    lang: 'en',
+    stylesheets: ['/styles.css'],
+    scripts: ['/client.js'],
+  })
+);
+
+// Use with Response (Edge/Workers)
+return new Response(htmlStream, {
+  headers: { 'Content-Type': 'text/html; charset=utf-8' },
+});
+```
+
+**Flush Strategies:**
+
+| Strategy | Description |
+|----------|-------------|
+| `immediate` | Flush each chunk as soon as it's ready |
+| `batched` | Flush when buffer exceeds 1KB threshold |
+| `manual` | Only flush at the end (for small pages) |
+
+**StreamingRenderOptions:**
+
+```typescript
+interface StreamingRenderOptions {
+  flushStrategy: 'immediate' | 'batched' | 'manual';
+}
+```
+
+### Abort Signal Support
+
+Cancel streaming when the client disconnects:
+
+```typescript
+const controller = new AbortController();
+
+const stream = renderToStream(program, { flushStrategy: 'batched' }, {
+  signal: controller.signal,
+});
+
+// Cancel on client disconnect
+request.signal.addEventListener('abort', () => {
+  controller.abort();
+});
+```
+
+## Suspense Boundaries
+
+Server-side suspense for async content:
+
+```json
+{
+  "view": {
+    "kind": "suspense",
+    "id": "user-data",
+    "fallback": {
+      "kind": "element",
+      "tag": "div",
+      "props": { "className": { "expr": "lit", "value": "skeleton" } },
+      "children": []
+    },
+    "content": {
+      "kind": "component",
+      "name": "UserProfile",
+      "props": { "user": { "expr": "data", "name": "user" } }
+    }
+  }
+}
+```
+
+Renders with markers for client-side hydration:
+
+```html
+<div data-suspense-id="user-data">
+  <!-- Fallback content first -->
+  <div class="skeleton"></div>
+</div>
+<!-- Resolved content follows -->
+```
+
 ## Security
 
 - **HTML Escaping** - All text output is escaped

package/dist/index.js

@@ -403,6 +403,8 @@ function evaluate(expr, ctx) {
       return expr.value;
     case "state":
       return ctx.state.get(expr.name);
+    case "local":
+      return ctx.locals[expr.name];
     case "var": {
       let varName = expr.name;
       let pathParts = [];
@@ -502,6 +504,9 @@ function evaluate(expr, ctx) {
     }
     case "call": {
       const callExpr = expr;
+      if (callExpr.target === null) {
+        return void 0;
+      }
       const target = evaluate(callExpr.target, ctx);
       if (target == null) return void 0;
       const args = callExpr.args?.map((arg) => {
@@ -1152,6 +1157,8 @@ function evaluate2(expr, ctx) {
       return expr.value;
     case "state":
       return ctx.state.get(expr.name);
+    case "local":
+      return ctx.locals[expr.name];
     case "var": {
       let varName = expr.name;
       let pathParts = [];
@@ -1253,6 +1260,9 @@ function evaluate2(expr, ctx) {
     }
     case "call": {
       const callExpr = expr;
+      if (callExpr.target === null) {
+        return void 0;
+      }
       const target = evaluate2(callExpr.target, ctx);
       if (target == null) return void 0;
       const args = callExpr.args?.map((arg) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constela/server",
-  "version": "13.0.0",
+  "version": "14.0.1",
   "description": "Server-side rendering for Constela UI framework",
   "type": "module",
   "main": "./dist/index.js",
@@ -15,8 +15,8 @@
     "dist"
   ],
   "peerDependencies": {
-    "@constela/compiler": "^0.15.0",
-    "@constela/core": "^0.17.0"
+    "@constela/compiler": "^0.15.7",
+    "@constela/core": "^0.18.1"
   },
   "dependencies": {
     "isomorphic-dompurify": "^2.35.0",
@@ -29,8 +29,8 @@
     "tsup": "^8.0.0",
     "typescript": "^5.3.0",
     "vitest": "^2.0.0",
-    "@constela/compiler": "0.15.0",
-    "@constela/core": "0.17.0"
+    "@constela/core": "0.18.1",
+    "@constela/compiler": "0.15.7"
   },
   "engines": {
     "node": ">=20.0.0"