@jay-framework/ssr-runtime 0.13.0

package/dist/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * HTML-escape a string for safe embedding in HTML content.
+ * Escapes: & < > " '
+ */
+declare function escapeHtml(str: string): string;
+/**
+ * HTML-escape a string for safe embedding in attribute values.
+ * Same escaping as escapeHtml — covers all characters that could break
+ * out of single-quoted, double-quoted, or unquoted attribute values.
+ */
+declare function escapeAttr(str: string): string;
+
+/**
+ * Context passed to compiled renderToStream functions.
+ * Provides `write` for streaming HTML chunks and `onAsync` for registering
+ * promise-based async content that will be swapped in via inline scripts.
+ */
+interface ServerRenderContext {
+    /** Write an HTML chunk to the response stream. */
+    write: (chunk: string) => void;
+    /**
+     * Register an async promise for streaming resolution.
+     * The pending variant is rendered inline immediately.
+     * When the promise settles, the framework writes an inline script
+     * that swaps the pending content with resolved/rejected content.
+     */
+    onAsync: (promise: Promise<any>, id: string, templates: {
+        resolved?: (val: any) => string;
+        rejected?: (err: any) => string;
+    }) => void;
+}
+
+/**
+ * Generate an inline `<script>` that swaps a pending async placeholder
+ * with resolved/rejected HTML content.
+ *
+ * The generated script finds the element with `jay-async="id:pending"`,
+ * creates a temporary container, sets its innerHTML to the new HTML,
+ * and replaces the placeholder with the new content.
+ */
+declare function asyncSwapScript(id: string, html: string): string;
+
+export { type ServerRenderContext, asyncSwapScript, escapeAttr, escapeHtml };

package/dist/index.js

@@ -0,0 +1,23 @@
+const HTML_ESCAPE_MAP = {
+  "&": "&",
+  "<": "&lt;",
+  ">": "&gt;",
+  '"': "&quot;",
+  "'": "&#39;"
+};
+const HTML_ESCAPE_RE = /[&<>"']/g;
+function escapeHtml(str) {
+  return String(str).replace(HTML_ESCAPE_RE, (char) => HTML_ESCAPE_MAP[char]);
+}
+function escapeAttr(str) {
+  return String(str).replace(HTML_ESCAPE_RE, (char) => HTML_ESCAPE_MAP[char]);
+}
+function asyncSwapScript(id, html) {
+  const escapedHtml = html.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
+  return `<script>(function(){var t=document.querySelector('[jay-async="${id}:pending"]');if(t){var d=document.createElement('div');d.innerHTML='${escapedHtml}';t.replaceWith(d.firstChild);}window.__jay&&window.__jay.hydrateAsync&&window.__jay.hydrateAsync('${id}');})()<\/script>`;
+}
+export {
+  asyncSwapScript,
+  escapeAttr,
+  escapeHtml
+};

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@jay-framework/ssr-runtime",
+  "version": "0.13.0",
+  "type": "module",
+  "license": "Apache-2.0",
+  "main": "dist/index.js",
+  "files": [
+    "dist",
+    "readme.md"
+  ],
+  "scripts": {
+    "build": "npm run build:js && npm run build:types",
+    "build:watch": "npm run build:js -- --watch & npm run build:types -- --watch",
+    "build:js": "vite build",
+    "build:types": "tsup lib/index.ts --dts-only --format esm",
+    "build:check-types": "tsc",
+    "clean": "rimraf dist",
+    "confirm": "npm run clean && npm run build && npm run build:check-types && npm run test",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "devDependencies": {
+    "@jay-framework/dev-environment": "^0.14.0",
+    "@types/node": "^20.11.5",
+    "rimraf": "^5.0.5",
+    "tsup": "^8.0.1",
+    "typescript": "^5.3.3",
+    "vite": "^5.0.11",
+    "vitest": "^1.2.1"
+  }
+}