@zeus-js/runtime-ssr 0.1.0-canary.20260805.97.1.fa5d9cef

package/dist/runtime-ssr.cjs

@@ -0,0 +1,393 @@
+/**
+* runtime-ssr v0.1.0-canary.20260805.97.1.fa5d9cef
+* (c) 2026 baicie
+* Released under the MIT License.
+**/
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+let _zeus_js_signal = require("@zeus-js/signal");
+//#region packages/core/runtime-ssr/src/serialize.ts
+const SSR_FRAGMENT = Symbol.for("zeus.ssr.fragment");
+const RAW_TEXT_END_TAG = {
+	script: /<\/script(?=[\t\n\f\r />]|$)/gi,
+	style: /<\/style(?=[\t\n\f\r />]|$)/gi
+};
+const RAW_TEXT_ESCAPE = {
+	script: "\\u003C",
+	style: "\\3C "
+};
+function createSSRFragment(html) {
+	return Object.freeze({
+		[SSR_FRAGMENT]: true,
+		html
+	});
+}
+function isSSRFragment(value) {
+	return typeof value === "object" && value !== null && value[SSR_FRAGMENT] === true;
+}
+function escapeHTMLText(value) {
+	return value.replace(/[&<>]/g, (character) => TEXT_ESCAPE[character]);
+}
+function escapeHTMLAttribute(value) {
+	return value.replace(/[&"<>]/g, (character) => ATTRIBUTE_ESCAPE[character]);
+}
+function assertSyncSSRValue(value) {
+	if (!isPromiseLike(value)) return;
+	Promise.resolve(value).catch(() => {});
+	throw new TypeError("renderToString() does not support async render values.");
+}
+const TEXT_ESCAPE = {
+	"&": "&amp;",
+	"<": "&lt;",
+	">": "&gt;"
+};
+const ATTRIBUTE_ESCAPE = {
+	"&": "&amp;",
+	"\"": "&quot;",
+	"<": "&lt;",
+	">": "&gt;"
+};
+function serializeSSRNode(value) {
+	assertSyncSSRValue(value);
+	if (isSSRFragment(value)) return value.html;
+	if (Array.isArray(value)) {
+		let html = "";
+		for (const child of value) html += serializeSSRNode(child);
+		return html;
+	}
+	if (value == null || typeof value === "boolean") return "";
+	if (typeof value === "string") return escapeHTMLText(value);
+	if (typeof value === "number") return String(value);
+	throw new TypeError("renderToString() received an unsupported SSR value.");
+}
+function serializeSSRRawText(value, tag) {
+	return escapeSSRRawText(serializeSSRRawTextValue(value, tag), tag);
+}
+function serializeSSRRawTextValue(value, tag) {
+	assertSyncSSRValue(value);
+	if (isSSRFragment(value)) throw new TypeError(`renderToString() does not support serialized fragments inside <${tag}> raw text.`);
+	if (Array.isArray(value)) {
+		let text = "";
+		for (const child of value) text += serializeSSRRawTextValue(child, tag);
+		return text;
+	}
+	if (value == null || typeof value === "boolean") return "";
+	if (typeof value === "string") return value;
+	if (typeof value === "number") return String(value);
+	throw new TypeError("renderToString() received an unsupported SSR value.");
+}
+function escapeSSRRawText(value, tag) {
+	if (tag === "script") return escapeSSRScriptText(value);
+	return value.replace(RAW_TEXT_END_TAG[tag], (match) => `${RAW_TEXT_ESCAPE[tag]}${match.slice(1)}`);
+}
+function escapeSSRScriptText(value) {
+	let escaped = false;
+	let result = "";
+	for (let index = 0; index < value.length;) {
+		if (matchesRawTextTag(value, index, "script", true)) {
+			result += `${RAW_TEXT_ESCAPE.script}${value.slice(index + 1, index + 8)}`;
+			index += 8;
+			continue;
+		}
+		if (!escaped && value.startsWith("<!--", index)) {
+			result += "<!--";
+			escaped = true;
+			index += 4;
+			continue;
+		}
+		if (escaped && value.startsWith("-->", index)) {
+			result += "-->";
+			escaped = false;
+			index += 3;
+			continue;
+		}
+		if (escaped && matchesRawTextTag(value, index, "script", false)) {
+			result += `${RAW_TEXT_ESCAPE.script}${value.slice(index + 1, index + 7)}`;
+			index += 7;
+			continue;
+		}
+		result += value[index];
+		index++;
+	}
+	return result;
+}
+function matchesRawTextTag(value, index, tag, closing) {
+	const prefix = `${closing ? "</" : "<"}${tag}`;
+	if (value.slice(index, index + prefix.length).toLowerCase() !== prefix) return false;
+	const delimiter = value[index + prefix.length];
+	return delimiter === void 0 || /[\t\n\f\r />]/.test(delimiter);
+}
+function isPromiseLike(value) {
+	return (typeof value === "object" || typeof value === "function") && value !== null && typeof value.then === "function";
+}
+//#endregion
+//#region packages/core/runtime-ssr/src/render.ts
+function renderToString(input) {
+	if (typeof input !== "function") throw new TypeError("renderToString() expects a synchronous render function.");
+	return (0, _zeus_js_signal.createRoot)((dispose) => {
+		try {
+			return serializeSSRNode(input());
+		} finally {
+			dispose();
+		}
+	});
+}
+//#endregion
+//#region packages/core/runtime-ssr/src/text.ts
+function ssrStatic(html) {
+	return createSSRFragment(html);
+}
+function ssrText(value) {
+	return createSSRFragment(serializeSSRNode(value));
+}
+//#endregion
+//#region packages/core/runtime-ssr/src/property.ts
+const SSR_PROPERTY = Symbol.for("zeus.ssr.property");
+const BOOLEAN_PROPERTY_ELEMENTS = {
+	checked: /* @__PURE__ */ new Set(["input"]),
+	disabled: /* @__PURE__ */ new Set([
+		"button",
+		"fieldset",
+		"input",
+		"optgroup",
+		"option",
+		"select",
+		"textarea"
+	]),
+	multiple: /* @__PURE__ */ new Set(["input", "select"]),
+	readOnly: /* @__PURE__ */ new Set(["input", "textarea"]),
+	selected: /* @__PURE__ */ new Set(["option"])
+};
+const VALUE_PROPERTY_ELEMENTS = /* @__PURE__ */ new Set([
+	"button",
+	"input",
+	"option"
+]);
+const SUPPORTED_PROPERTY_NAMES = /* @__PURE__ */ new Set([
+	...Object.keys(BOOLEAN_PROPERTY_ELEMENTS),
+	"htmlFor",
+	"tabIndex",
+	"value"
+]);
+function createSSRProperty(name, value) {
+	assertSyncSSRValue(value);
+	if (!SUPPORTED_PROPERTY_NAMES.has(name)) throw new TypeError(`SSR cannot serialize property "${name}".`);
+	if (typeof value !== "string" && typeof value !== "number" && typeof value !== "boolean") return null;
+	return {
+		[SSR_PROPERTY]: true,
+		name,
+		propertyValue: value,
+		value: value === true ? true : String(value)
+	};
+}
+function resolveSSRElementProperties(tag, entries, children) {
+	const attributes = [];
+	const properties = [];
+	for (const entry of entries) {
+		assertSyncSSRValue(entry);
+		if (!entry) continue;
+		assertSyncSSRValue(entry.value);
+		if (isSSRProperty(entry)) properties.push(entry);
+		else attributes.push(entry);
+	}
+	let resolvedChildren = children;
+	for (const property of properties) {
+		const serialization = getSSRPropertySerialization(tag, property.name);
+		if (!serialization) throw new TypeError(`SSR cannot serialize property "${property.name}" on <${tag}>.`);
+		if (serialization.kind === "text-content") {
+			removeAttribute(attributes, "value");
+			resolvedChildren = normalizeTextareaValue(property.propertyValue);
+			continue;
+		}
+		removeAttribute(attributes, serialization.name);
+		if (serialization.kind === "boolean-attribute") {
+			if (Boolean(property.propertyValue)) attributes.push({
+				name: serialization.name,
+				value: true
+			});
+			continue;
+		}
+		attributes.push({
+			name: serialization.name,
+			value: property.name === "tabIndex" ? normalizeTabIndex(property.propertyValue) : String(property.propertyValue)
+		});
+	}
+	return {
+		attributes,
+		children: resolvedChildren
+	};
+}
+function getSSRPropertySerialization(tag, name) {
+	const normalizedTag = tag.toLowerCase();
+	if (name === "tabIndex") return {
+		kind: "string-attribute",
+		name: "tabindex"
+	};
+	if (name === "htmlFor") return normalizedTag === "label" ? {
+		kind: "string-attribute",
+		name: "for"
+	} : void 0;
+	if (name === "value") {
+		if (normalizedTag === "textarea") return { kind: "text-content" };
+		return VALUE_PROPERTY_ELEMENTS.has(normalizedTag) ? {
+			kind: "string-attribute",
+			name: "value"
+		} : void 0;
+	}
+	if (!BOOLEAN_PROPERTY_ELEMENTS[name]?.has(normalizedTag)) return void 0;
+	return {
+		kind: "boolean-attribute",
+		name: name === "readOnly" ? "readonly" : name
+	};
+}
+function isSSRProperty(attribute) {
+	return attribute[SSR_PROPERTY] === true;
+}
+function removeAttribute(attributes, name) {
+	const normalizedName = name.toLowerCase();
+	for (let index = attributes.length - 1; index >= 0; index--) if (attributes[index].name.toLowerCase() === normalizedName) attributes.splice(index, 1);
+}
+function normalizeTabIndex(value) {
+	const number = Number(value);
+	return String(Number.isFinite(number) ? Math.trunc(number) : 0);
+}
+function normalizeTextareaValue(value) {
+	const normalized = String(value).replace(/\r\n?/g, "\n");
+	return normalized.startsWith("\n") ? `\n${normalized}` : normalized;
+}
+//#endregion
+//#region packages/core/runtime-ssr/src/element.ts
+const VOID_ELEMENTS = /* @__PURE__ */ new Set([
+	"area",
+	"base",
+	"br",
+	"col",
+	"embed",
+	"hr",
+	"img",
+	"input",
+	"link",
+	"meta",
+	"param",
+	"source",
+	"track",
+	"wbr"
+]);
+function ssrElement(tag, attributes = [], children = null, isVoid = VOID_ELEMENTS.has(tag.toLowerCase())) {
+	const resolved = resolveSSRElementProperties(tag, attributes, children);
+	const opening = `<${tag}${serializeAttributes(resolved.attributes)}>`;
+	if (isVoid) return createSSRFragment(opening);
+	const normalizedTag = tag.toLowerCase();
+	return createSSRFragment(`${opening}${normalizedTag === "script" || normalizedTag === "style" ? serializeSSRRawText(resolved.children, normalizedTag) : serializeSSRNode(resolved.children)}</${tag}>`);
+}
+function ssrAttr(name, value) {
+	assertSyncSSRValue(value);
+	const normalizedName = normalizeAttributeName(name);
+	if (normalizedName === "class") {
+		const normalized = normalizeClass(value);
+		return normalized ? createSSRAttribute("class", normalized) : null;
+	}
+	if (normalizedName === "style") return createStyleAttribute(value);
+	if (value == null || value === false) return null;
+	return createSSRAttribute(normalizedName, value === true ? true : String(value));
+}
+function createStyleAttribute(value) {
+	assertSyncSSRValue(value);
+	if (value == null) return null;
+	if (typeof value === "string") return createSSRAttribute("style", value);
+	const declarations = [];
+	for (const [key, declarationValue] of Object.entries(value)) {
+		assertSyncSSRValue(declarationValue);
+		if (declarationValue == null) continue;
+		declarations.push(`${normalizeStyleName(key)}:${normalizeStyleValue(key, declarationValue)}`);
+	}
+	return declarations.length ? createSSRAttribute("style", declarations.join(";")) : null;
+}
+function ssrProp(name, value) {
+	return createSSRProperty(name, value);
+}
+function createSSRAttribute(name, value) {
+	return {
+		name,
+		value
+	};
+}
+function serializeAttributes(attributes) {
+	let html = "";
+	for (const attribute of attributes) {
+		assertSyncSSRValue(attribute);
+		if (!attribute) continue;
+		assertSyncSSRValue(attribute.value);
+		html += ` ${attribute.name}`;
+		if (attribute.value !== true) html += `="${escapeHTMLAttribute(attribute.value)}"`;
+	}
+	return html;
+}
+function normalizeAttributeName(name) {
+	return name === "className" ? "class" : name;
+}
+function normalizeClass(value) {
+	assertSyncSSRValue(value);
+	if (!value) return "";
+	if (typeof value === "string") return value;
+	if (Array.isArray(value)) return value.map(normalizeClass).filter(Boolean).join(" ");
+	const tokens = value;
+	return Object.keys(tokens).filter((key) => {
+		assertSyncSSRValue(tokens[key]);
+		return tokens[key];
+	}).join(" ");
+}
+function normalizeStyleName(name) {
+	if (name.startsWith("--")) return name;
+	return name.replace(/[A-Z]/g, (character) => `-${character.toLowerCase()}`);
+}
+function normalizeStyleValue(name, value) {
+	if (typeof value === "number" && value !== 0 && !name.startsWith("--") && !UNITLESS_STYLES.has(name)) return `${value}px`;
+	return String(value);
+}
+const UNITLESS_STYLES = /* @__PURE__ */ new Set([
+	"opacity",
+	"zIndex",
+	"fontWeight",
+	"lineHeight",
+	"flex",
+	"flexGrow",
+	"flexShrink",
+	"order"
+]);
+//#endregion
+//#region packages/core/runtime-ssr/src/component.ts
+function ssrComponent(component, props) {
+	return component(props);
+}
+//#endregion
+//#region packages/core/runtime-ssr/src/controlFlow.ts
+function ssrShow(when, children, fallback) {
+	return resolve(when) ? resolve(children) : resolve(fallback) ?? null;
+}
+function Show(props) {
+	return resolve(props.when ? props.children : props.fallback) ?? null;
+}
+function ssrFor(each, render) {
+	return resolve(each)?.map((item, index) => render(item, index)) ?? null;
+}
+function For(props) {
+	return ssrFor(props.each, props.children);
+}
+function resolve(value) {
+	return typeof value === "function" ? value() : value;
+}
+//#endregion
+exports.For = For;
+exports.Show = Show;
+exports.renderToString = renderToString;
+exports.ssrAttr = ssrAttr;
+exports.ssrComponent = ssrComponent;
+exports.ssrElement = ssrElement;
+exports.ssrFor = ssrFor;
+exports.ssrProp = ssrProp;
+exports.ssrShow = ssrShow;
+exports.ssrStatic = ssrStatic;
+exports.ssrText = ssrText;

package/dist/runtime-ssr.d.ts

@@ -0,0 +1,46 @@
+export type SSRPrimitive = string | number | boolean | null | undefined;
+declare const SSR_FRAGMENT: unique symbol;
+export interface SSRFragment {
+    readonly [SSR_FRAGMENT]: true;
+    readonly html: string;
+}
+export type SSRNode = SSRPrimitive | SSRFragment | readonly SSRNode[];
+export type SSRComponent<P extends Record<string, unknown> = Record<string, unknown>> = (props: P) => SSRNode;
+export interface SSRAttribute {
+    readonly name: string;
+    readonly value: string | true;
+}
+export type SSRAttributeValue = string | number | boolean | null | undefined;
+export type SSRAttributeEntry = SSRAttribute | null | undefined | false;
+export type SSRClassValue = string | null | undefined | false | Readonly<Record<string, boolean | null | undefined>> | readonly SSRClassValue[];
+export type SSRStyleValue = string | null | undefined | Readonly<Record<string, string | number | null | undefined>>;
+export type SSRRenderInput = () => SSRNode;
+
+export declare function renderToString(input: SSRRenderInput): string;
+
+export declare function ssrStatic(html: string): SSRFragment;
+export declare function ssrText(value: SSRNode): SSRFragment;
+
+export declare function ssrElement(tag: string, attributes?: readonly SSRAttributeEntry[], children?: SSRNode, isVoid?: boolean): SSRFragment;
+export declare function ssrAttr(name: string, value: SSRAttributeValue | SSRClassValue | SSRStyleValue): SSRAttributeEntry;
+export declare function ssrProp(name: string, value: unknown): SSRAttributeEntry;
+
+export declare function ssrComponent<P extends Record<string, unknown>, R extends SSRNode>(component: (props: P) => R, props: P): R;
+
+export type SSRResolvable<T> = T | (() => T);
+export interface ShowProps {
+    when: unknown;
+    fallback?: SSRResolvable<SSRNode>;
+    children?: SSRResolvable<SSRNode>;
+}
+export declare function ssrShow(when: SSRResolvable<unknown>, children: SSRResolvable<SSRNode>, fallback?: SSRResolvable<SSRNode>): SSRNode;
+export declare function Show(props: ShowProps): SSRNode;
+export interface ForProps<T, K = unknown> {
+    each: readonly T[] | null | undefined;
+    by?: (item: T, index: number) => K;
+    children: (item: T, index: number) => SSRNode;
+}
+export declare function ssrFor<T>(each: SSRResolvable<readonly T[] | null | undefined>, render: (item: T, index: number) => SSRNode): SSRNode;
+export declare function For<T, K = unknown>(props: ForProps<T, K>): SSRNode;
+
+

package/dist/runtime-ssr.esm-bundler.js

@@ -0,0 +1,379 @@
+/**
+* runtime-ssr v0.1.0-canary.20260805.97.1.fa5d9cef
+* (c) 2026 baicie
+* Released under the MIT License.
+**/
+import { createRoot } from "@zeus-js/signal";
+//#region packages/core/runtime-ssr/src/serialize.ts
+const SSR_FRAGMENT = Symbol.for("zeus.ssr.fragment");
+const RAW_TEXT_END_TAG = {
+	script: /<\/script(?=[\t\n\f\r />]|$)/gi,
+	style: /<\/style(?=[\t\n\f\r />]|$)/gi
+};
+const RAW_TEXT_ESCAPE = {
+	script: "\\u003C",
+	style: "\\3C "
+};
+function createSSRFragment(html) {
+	return Object.freeze({
+		[SSR_FRAGMENT]: true,
+		html
+	});
+}
+function isSSRFragment(value) {
+	return typeof value === "object" && value !== null && value[SSR_FRAGMENT] === true;
+}
+function escapeHTMLText(value) {
+	return value.replace(/[&<>]/g, (character) => TEXT_ESCAPE[character]);
+}
+function escapeHTMLAttribute(value) {
+	return value.replace(/[&"<>]/g, (character) => ATTRIBUTE_ESCAPE[character]);
+}
+function assertSyncSSRValue(value) {
+	if (!isPromiseLike(value)) return;
+	Promise.resolve(value).catch(() => {});
+	throw new TypeError("renderToString() does not support async render values.");
+}
+const TEXT_ESCAPE = {
+	"&": "&amp;",
+	"<": "&lt;",
+	">": "&gt;"
+};
+const ATTRIBUTE_ESCAPE = {
+	"&": "&amp;",
+	"\"": "&quot;",
+	"<": "&lt;",
+	">": "&gt;"
+};
+function serializeSSRNode(value) {
+	assertSyncSSRValue(value);
+	if (isSSRFragment(value)) return value.html;
+	if (Array.isArray(value)) {
+		let html = "";
+		for (const child of value) html += serializeSSRNode(child);
+		return html;
+	}
+	if (value == null || typeof value === "boolean") return "";
+	if (typeof value === "string") return escapeHTMLText(value);
+	if (typeof value === "number") return String(value);
+	throw new TypeError("renderToString() received an unsupported SSR value.");
+}
+function serializeSSRRawText(value, tag) {
+	return escapeSSRRawText(serializeSSRRawTextValue(value, tag), tag);
+}
+function serializeSSRRawTextValue(value, tag) {
+	assertSyncSSRValue(value);
+	if (isSSRFragment(value)) throw new TypeError(`renderToString() does not support serialized fragments inside <${tag}> raw text.`);
+	if (Array.isArray(value)) {
+		let text = "";
+		for (const child of value) text += serializeSSRRawTextValue(child, tag);
+		return text;
+	}
+	if (value == null || typeof value === "boolean") return "";
+	if (typeof value === "string") return value;
+	if (typeof value === "number") return String(value);
+	throw new TypeError("renderToString() received an unsupported SSR value.");
+}
+function escapeSSRRawText(value, tag) {
+	if (tag === "script") return escapeSSRScriptText(value);
+	return value.replace(RAW_TEXT_END_TAG[tag], (match) => `${RAW_TEXT_ESCAPE[tag]}${match.slice(1)}`);
+}
+function escapeSSRScriptText(value) {
+	let escaped = false;
+	let result = "";
+	for (let index = 0; index < value.length;) {
+		if (matchesRawTextTag(value, index, "script", true)) {
+			result += `${RAW_TEXT_ESCAPE.script}${value.slice(index + 1, index + 8)}`;
+			index += 8;
+			continue;
+		}
+		if (!escaped && value.startsWith("<!--", index)) {
+			result += "<!--";
+			escaped = true;
+			index += 4;
+			continue;
+		}
+		if (escaped && value.startsWith("-->", index)) {
+			result += "-->";
+			escaped = false;
+			index += 3;
+			continue;
+		}
+		if (escaped && matchesRawTextTag(value, index, "script", false)) {
+			result += `${RAW_TEXT_ESCAPE.script}${value.slice(index + 1, index + 7)}`;
+			index += 7;
+			continue;
+		}
+		result += value[index];
+		index++;
+	}
+	return result;
+}
+function matchesRawTextTag(value, index, tag, closing) {
+	const prefix = `${closing ? "</" : "<"}${tag}`;
+	if (value.slice(index, index + prefix.length).toLowerCase() !== prefix) return false;
+	const delimiter = value[index + prefix.length];
+	return delimiter === void 0 || /[\t\n\f\r />]/.test(delimiter);
+}
+function isPromiseLike(value) {
+	return (typeof value === "object" || typeof value === "function") && value !== null && typeof value.then === "function";
+}
+//#endregion
+//#region packages/core/runtime-ssr/src/render.ts
+function renderToString(input) {
+	if (typeof input !== "function") throw new TypeError("renderToString() expects a synchronous render function.");
+	return createRoot((dispose) => {
+		try {
+			return serializeSSRNode(input());
+		} finally {
+			dispose();
+		}
+	});
+}
+//#endregion
+//#region packages/core/runtime-ssr/src/text.ts
+function ssrStatic(html) {
+	return createSSRFragment(html);
+}
+function ssrText(value) {
+	return createSSRFragment(serializeSSRNode(value));
+}
+//#endregion
+//#region packages/core/runtime-ssr/src/property.ts
+const SSR_PROPERTY = Symbol.for("zeus.ssr.property");
+const BOOLEAN_PROPERTY_ELEMENTS = {
+	checked: /* @__PURE__ */ new Set(["input"]),
+	disabled: /* @__PURE__ */ new Set([
+		"button",
+		"fieldset",
+		"input",
+		"optgroup",
+		"option",
+		"select",
+		"textarea"
+	]),
+	multiple: /* @__PURE__ */ new Set(["input", "select"]),
+	readOnly: /* @__PURE__ */ new Set(["input", "textarea"]),
+	selected: /* @__PURE__ */ new Set(["option"])
+};
+const VALUE_PROPERTY_ELEMENTS = /* @__PURE__ */ new Set([
+	"button",
+	"input",
+	"option"
+]);
+const SUPPORTED_PROPERTY_NAMES = /* @__PURE__ */ new Set([
+	...Object.keys(BOOLEAN_PROPERTY_ELEMENTS),
+	"htmlFor",
+	"tabIndex",
+	"value"
+]);
+function createSSRProperty(name, value) {
+	assertSyncSSRValue(value);
+	if (!SUPPORTED_PROPERTY_NAMES.has(name)) throw new TypeError(`SSR cannot serialize property "${name}".`);
+	if (typeof value !== "string" && typeof value !== "number" && typeof value !== "boolean") return null;
+	return {
+		[SSR_PROPERTY]: true,
+		name,
+		propertyValue: value,
+		value: value === true ? true : String(value)
+	};
+}
+function resolveSSRElementProperties(tag, entries, children) {
+	const attributes = [];
+	const properties = [];
+	for (const entry of entries) {
+		assertSyncSSRValue(entry);
+		if (!entry) continue;
+		assertSyncSSRValue(entry.value);
+		if (isSSRProperty(entry)) properties.push(entry);
+		else attributes.push(entry);
+	}
+	let resolvedChildren = children;
+	for (const property of properties) {
+		const serialization = getSSRPropertySerialization(tag, property.name);
+		if (!serialization) throw new TypeError(`SSR cannot serialize property "${property.name}" on <${tag}>.`);
+		if (serialization.kind === "text-content") {
+			removeAttribute(attributes, "value");
+			resolvedChildren = normalizeTextareaValue(property.propertyValue);
+			continue;
+		}
+		removeAttribute(attributes, serialization.name);
+		if (serialization.kind === "boolean-attribute") {
+			if (Boolean(property.propertyValue)) attributes.push({
+				name: serialization.name,
+				value: true
+			});
+			continue;
+		}
+		attributes.push({
+			name: serialization.name,
+			value: property.name === "tabIndex" ? normalizeTabIndex(property.propertyValue) : String(property.propertyValue)
+		});
+	}
+	return {
+		attributes,
+		children: resolvedChildren
+	};
+}
+function getSSRPropertySerialization(tag, name) {
+	const normalizedTag = tag.toLowerCase();
+	if (name === "tabIndex") return {
+		kind: "string-attribute",
+		name: "tabindex"
+	};
+	if (name === "htmlFor") return normalizedTag === "label" ? {
+		kind: "string-attribute",
+		name: "for"
+	} : void 0;
+	if (name === "value") {
+		if (normalizedTag === "textarea") return { kind: "text-content" };
+		return VALUE_PROPERTY_ELEMENTS.has(normalizedTag) ? {
+			kind: "string-attribute",
+			name: "value"
+		} : void 0;
+	}
+	if (!BOOLEAN_PROPERTY_ELEMENTS[name]?.has(normalizedTag)) return void 0;
+	return {
+		kind: "boolean-attribute",
+		name: name === "readOnly" ? "readonly" : name
+	};
+}
+function isSSRProperty(attribute) {
+	return attribute[SSR_PROPERTY] === true;
+}
+function removeAttribute(attributes, name) {
+	const normalizedName = name.toLowerCase();
+	for (let index = attributes.length - 1; index >= 0; index--) if (attributes[index].name.toLowerCase() === normalizedName) attributes.splice(index, 1);
+}
+function normalizeTabIndex(value) {
+	const number = Number(value);
+	return String(Number.isFinite(number) ? Math.trunc(number) : 0);
+}
+function normalizeTextareaValue(value) {
+	const normalized = String(value).replace(/\r\n?/g, "\n");
+	return normalized.startsWith("\n") ? `\n${normalized}` : normalized;
+}
+//#endregion
+//#region packages/core/runtime-ssr/src/element.ts
+const VOID_ELEMENTS = /* @__PURE__ */ new Set([
+	"area",
+	"base",
+	"br",
+	"col",
+	"embed",
+	"hr",
+	"img",
+	"input",
+	"link",
+	"meta",
+	"param",
+	"source",
+	"track",
+	"wbr"
+]);
+function ssrElement(tag, attributes = [], children = null, isVoid = VOID_ELEMENTS.has(tag.toLowerCase())) {
+	const resolved = resolveSSRElementProperties(tag, attributes, children);
+	const opening = `<${tag}${serializeAttributes(resolved.attributes)}>`;
+	if (isVoid) return createSSRFragment(opening);
+	const normalizedTag = tag.toLowerCase();
+	return createSSRFragment(`${opening}${normalizedTag === "script" || normalizedTag === "style" ? serializeSSRRawText(resolved.children, normalizedTag) : serializeSSRNode(resolved.children)}</${tag}>`);
+}
+function ssrAttr(name, value) {
+	assertSyncSSRValue(value);
+	const normalizedName = normalizeAttributeName(name);
+	if (normalizedName === "class") {
+		const normalized = normalizeClass(value);
+		return normalized ? createSSRAttribute("class", normalized) : null;
+	}
+	if (normalizedName === "style") return createStyleAttribute(value);
+	if (value == null || value === false) return null;
+	return createSSRAttribute(normalizedName, value === true ? true : String(value));
+}
+function createStyleAttribute(value) {
+	assertSyncSSRValue(value);
+	if (value == null) return null;
+	if (typeof value === "string") return createSSRAttribute("style", value);
+	const declarations = [];
+	for (const [key, declarationValue] of Object.entries(value)) {
+		assertSyncSSRValue(declarationValue);
+		if (declarationValue == null) continue;
+		declarations.push(`${normalizeStyleName(key)}:${normalizeStyleValue(key, declarationValue)}`);
+	}
+	return declarations.length ? createSSRAttribute("style", declarations.join(";")) : null;
+}
+function ssrProp(name, value) {
+	return createSSRProperty(name, value);
+}
+function createSSRAttribute(name, value) {
+	return {
+		name,
+		value
+	};
+}
+function serializeAttributes(attributes) {
+	let html = "";
+	for (const attribute of attributes) {
+		assertSyncSSRValue(attribute);
+		if (!attribute) continue;
+		assertSyncSSRValue(attribute.value);
+		html += ` ${attribute.name}`;
+		if (attribute.value !== true) html += `="${escapeHTMLAttribute(attribute.value)}"`;
+	}
+	return html;
+}
+function normalizeAttributeName(name) {
+	return name === "className" ? "class" : name;
+}
+function normalizeClass(value) {
+	assertSyncSSRValue(value);
+	if (!value) return "";
+	if (typeof value === "string") return value;
+	if (Array.isArray(value)) return value.map(normalizeClass).filter(Boolean).join(" ");
+	const tokens = value;
+	return Object.keys(tokens).filter((key) => {
+		assertSyncSSRValue(tokens[key]);
+		return tokens[key];
+	}).join(" ");
+}
+function normalizeStyleName(name) {
+	if (name.startsWith("--")) return name;
+	return name.replace(/[A-Z]/g, (character) => `-${character.toLowerCase()}`);
+}
+function normalizeStyleValue(name, value) {
+	if (typeof value === "number" && value !== 0 && !name.startsWith("--") && !UNITLESS_STYLES.has(name)) return `${value}px`;
+	return String(value);
+}
+const UNITLESS_STYLES = /* @__PURE__ */ new Set([
+	"opacity",
+	"zIndex",
+	"fontWeight",
+	"lineHeight",
+	"flex",
+	"flexGrow",
+	"flexShrink",
+	"order"
+]);
+//#endregion
+//#region packages/core/runtime-ssr/src/component.ts
+function ssrComponent(component, props) {
+	return component(props);
+}
+//#endregion
+//#region packages/core/runtime-ssr/src/controlFlow.ts
+function ssrShow(when, children, fallback) {
+	return resolve(when) ? resolve(children) : resolve(fallback) ?? null;
+}
+function Show(props) {
+	return resolve(props.when ? props.children : props.fallback) ?? null;
+}
+function ssrFor(each, render) {
+	return resolve(each)?.map((item, index) => render(item, index)) ?? null;
+}
+function For(props) {
+	return ssrFor(props.each, props.children);
+}
+function resolve(value) {
+	return typeof value === "function" ? value() : value;
+}
+//#endregion
+export { For, Show, renderToString, ssrAttr, ssrComponent, ssrElement, ssrFor, ssrProp, ssrShow, ssrStatic, ssrText };

package/dist/runtime-ssr.prod.cjs

@@ -0,0 +1,393 @@
+/**
+* runtime-ssr v0.1.0-canary.20260805.97.1.fa5d9cef
+* (c) 2026 baicie
+* Released under the MIT License.
+**/
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+let _zeus_js_signal = require("@zeus-js/signal");
+//#region packages/core/runtime-ssr/src/serialize.ts
+const SSR_FRAGMENT = Symbol.for("zeus.ssr.fragment");
+const RAW_TEXT_END_TAG = {
+	script: /<\/script(?=[\t\n\f\r />]|$)/gi,
+	style: /<\/style(?=[\t\n\f\r />]|$)/gi
+};
+const RAW_TEXT_ESCAPE = {
+	script: "\\u003C",
+	style: "\\3C "
+};
+function createSSRFragment(html) {
+	return Object.freeze({
+		[SSR_FRAGMENT]: true,
+		html
+	});
+}
+function isSSRFragment(value) {
+	return typeof value === "object" && value !== null && value[SSR_FRAGMENT] === true;
+}
+function escapeHTMLText(value) {
+	return value.replace(/[&<>]/g, (character) => TEXT_ESCAPE[character]);
+}
+function escapeHTMLAttribute(value) {
+	return value.replace(/[&"<>]/g, (character) => ATTRIBUTE_ESCAPE[character]);
+}
+function assertSyncSSRValue(value) {
+	if (!isPromiseLike(value)) return;
+	Promise.resolve(value).catch(() => {});
+	throw new TypeError("renderToString() does not support async render values.");
+}
+const TEXT_ESCAPE = {
+	"&": "&amp;",
+	"<": "&lt;",
+	">": "&gt;"
+};
+const ATTRIBUTE_ESCAPE = {
+	"&": "&amp;",
+	"\"": "&quot;",
+	"<": "&lt;",
+	">": "&gt;"
+};
+function serializeSSRNode(value) {
+	assertSyncSSRValue(value);
+	if (isSSRFragment(value)) return value.html;
+	if (Array.isArray(value)) {
+		let html = "";
+		for (const child of value) html += serializeSSRNode(child);
+		return html;
+	}
+	if (value == null || typeof value === "boolean") return "";
+	if (typeof value === "string") return escapeHTMLText(value);
+	if (typeof value === "number") return String(value);
+	throw new TypeError("renderToString() received an unsupported SSR value.");
+}
+function serializeSSRRawText(value, tag) {
+	return escapeSSRRawText(serializeSSRRawTextValue(value, tag), tag);
+}
+function serializeSSRRawTextValue(value, tag) {
+	assertSyncSSRValue(value);
+	if (isSSRFragment(value)) throw new TypeError(`renderToString() does not support serialized fragments inside <${tag}> raw text.`);
+	if (Array.isArray(value)) {
+		let text = "";
+		for (const child of value) text += serializeSSRRawTextValue(child, tag);
+		return text;
+	}
+	if (value == null || typeof value === "boolean") return "";
+	if (typeof value === "string") return value;
+	if (typeof value === "number") return String(value);
+	throw new TypeError("renderToString() received an unsupported SSR value.");
+}
+function escapeSSRRawText(value, tag) {
+	if (tag === "script") return escapeSSRScriptText(value);
+	return value.replace(RAW_TEXT_END_TAG[tag], (match) => `${RAW_TEXT_ESCAPE[tag]}${match.slice(1)}`);
+}
+function escapeSSRScriptText(value) {
+	let escaped = false;
+	let result = "";
+	for (let index = 0; index < value.length;) {
+		if (matchesRawTextTag(value, index, "script", true)) {
+			result += `${RAW_TEXT_ESCAPE.script}${value.slice(index + 1, index + 8)}`;
+			index += 8;
+			continue;
+		}
+		if (!escaped && value.startsWith("<!--", index)) {
+			result += "<!--";
+			escaped = true;
+			index += 4;
+			continue;
+		}
+		if (escaped && value.startsWith("-->", index)) {
+			result += "-->";
+			escaped = false;
+			index += 3;
+			continue;
+		}
+		if (escaped && matchesRawTextTag(value, index, "script", false)) {
+			result += `${RAW_TEXT_ESCAPE.script}${value.slice(index + 1, index + 7)}`;
+			index += 7;
+			continue;
+		}
+		result += value[index];
+		index++;
+	}
+	return result;
+}
+function matchesRawTextTag(value, index, tag, closing) {
+	const prefix = `${closing ? "</" : "<"}${tag}`;
+	if (value.slice(index, index + prefix.length).toLowerCase() !== prefix) return false;
+	const delimiter = value[index + prefix.length];
+	return delimiter === void 0 || /[\t\n\f\r />]/.test(delimiter);
+}
+function isPromiseLike(value) {
+	return (typeof value === "object" || typeof value === "function") && value !== null && typeof value.then === "function";
+}
+//#endregion
+//#region packages/core/runtime-ssr/src/render.ts
+function renderToString(input) {
+	if (typeof input !== "function") throw new TypeError("renderToString() expects a synchronous render function.");
+	return (0, _zeus_js_signal.createRoot)((dispose) => {
+		try {
+			return serializeSSRNode(input());
+		} finally {
+			dispose();
+		}
+	});
+}
+//#endregion
+//#region packages/core/runtime-ssr/src/text.ts
+function ssrStatic(html) {
+	return createSSRFragment(html);
+}
+function ssrText(value) {
+	return createSSRFragment(serializeSSRNode(value));
+}
+//#endregion
+//#region packages/core/runtime-ssr/src/property.ts
+const SSR_PROPERTY = Symbol.for("zeus.ssr.property");
+const BOOLEAN_PROPERTY_ELEMENTS = {
+	checked: /* @__PURE__ */ new Set(["input"]),
+	disabled: /* @__PURE__ */ new Set([
+		"button",
+		"fieldset",
+		"input",
+		"optgroup",
+		"option",
+		"select",
+		"textarea"
+	]),
+	multiple: /* @__PURE__ */ new Set(["input", "select"]),
+	readOnly: /* @__PURE__ */ new Set(["input", "textarea"]),
+	selected: /* @__PURE__ */ new Set(["option"])
+};
+const VALUE_PROPERTY_ELEMENTS = /* @__PURE__ */ new Set([
+	"button",
+	"input",
+	"option"
+]);
+const SUPPORTED_PROPERTY_NAMES = /* @__PURE__ */ new Set([
+	...Object.keys(BOOLEAN_PROPERTY_ELEMENTS),
+	"htmlFor",
+	"tabIndex",
+	"value"
+]);
+function createSSRProperty(name, value) {
+	assertSyncSSRValue(value);
+	if (!SUPPORTED_PROPERTY_NAMES.has(name)) throw new TypeError(`SSR cannot serialize property "${name}".`);
+	if (typeof value !== "string" && typeof value !== "number" && typeof value !== "boolean") return null;
+	return {
+		[SSR_PROPERTY]: true,
+		name,
+		propertyValue: value,
+		value: value === true ? true : String(value)
+	};
+}
+function resolveSSRElementProperties(tag, entries, children) {
+	const attributes = [];
+	const properties = [];
+	for (const entry of entries) {
+		assertSyncSSRValue(entry);
+		if (!entry) continue;
+		assertSyncSSRValue(entry.value);
+		if (isSSRProperty(entry)) properties.push(entry);
+		else attributes.push(entry);
+	}
+	let resolvedChildren = children;
+	for (const property of properties) {
+		const serialization = getSSRPropertySerialization(tag, property.name);
+		if (!serialization) throw new TypeError(`SSR cannot serialize property "${property.name}" on <${tag}>.`);
+		if (serialization.kind === "text-content") {
+			removeAttribute(attributes, "value");
+			resolvedChildren = normalizeTextareaValue(property.propertyValue);
+			continue;
+		}
+		removeAttribute(attributes, serialization.name);
+		if (serialization.kind === "boolean-attribute") {
+			if (Boolean(property.propertyValue)) attributes.push({
+				name: serialization.name,
+				value: true
+			});
+			continue;
+		}
+		attributes.push({
+			name: serialization.name,
+			value: property.name === "tabIndex" ? normalizeTabIndex(property.propertyValue) : String(property.propertyValue)
+		});
+	}
+	return {
+		attributes,
+		children: resolvedChildren
+	};
+}
+function getSSRPropertySerialization(tag, name) {
+	const normalizedTag = tag.toLowerCase();
+	if (name === "tabIndex") return {
+		kind: "string-attribute",
+		name: "tabindex"
+	};
+	if (name === "htmlFor") return normalizedTag === "label" ? {
+		kind: "string-attribute",
+		name: "for"
+	} : void 0;
+	if (name === "value") {
+		if (normalizedTag === "textarea") return { kind: "text-content" };
+		return VALUE_PROPERTY_ELEMENTS.has(normalizedTag) ? {
+			kind: "string-attribute",
+			name: "value"
+		} : void 0;
+	}
+	if (!BOOLEAN_PROPERTY_ELEMENTS[name]?.has(normalizedTag)) return void 0;
+	return {
+		kind: "boolean-attribute",
+		name: name === "readOnly" ? "readonly" : name
+	};
+}
+function isSSRProperty(attribute) {
+	return attribute[SSR_PROPERTY] === true;
+}
+function removeAttribute(attributes, name) {
+	const normalizedName = name.toLowerCase();
+	for (let index = attributes.length - 1; index >= 0; index--) if (attributes[index].name.toLowerCase() === normalizedName) attributes.splice(index, 1);
+}
+function normalizeTabIndex(value) {
+	const number = Number(value);
+	return String(Number.isFinite(number) ? Math.trunc(number) : 0);
+}
+function normalizeTextareaValue(value) {
+	const normalized = String(value).replace(/\r\n?/g, "\n");
+	return normalized.startsWith("\n") ? `\n${normalized}` : normalized;
+}
+//#endregion
+//#region packages/core/runtime-ssr/src/element.ts
+const VOID_ELEMENTS = /* @__PURE__ */ new Set([
+	"area",
+	"base",
+	"br",
+	"col",
+	"embed",
+	"hr",
+	"img",
+	"input",
+	"link",
+	"meta",
+	"param",
+	"source",
+	"track",
+	"wbr"
+]);
+function ssrElement(tag, attributes = [], children = null, isVoid = VOID_ELEMENTS.has(tag.toLowerCase())) {
+	const resolved = resolveSSRElementProperties(tag, attributes, children);
+	const opening = `<${tag}${serializeAttributes(resolved.attributes)}>`;
+	if (isVoid) return createSSRFragment(opening);
+	const normalizedTag = tag.toLowerCase();
+	return createSSRFragment(`${opening}${normalizedTag === "script" || normalizedTag === "style" ? serializeSSRRawText(resolved.children, normalizedTag) : serializeSSRNode(resolved.children)}</${tag}>`);
+}
+function ssrAttr(name, value) {
+	assertSyncSSRValue(value);
+	const normalizedName = normalizeAttributeName(name);
+	if (normalizedName === "class") {
+		const normalized = normalizeClass(value);
+		return normalized ? createSSRAttribute("class", normalized) : null;
+	}
+	if (normalizedName === "style") return createStyleAttribute(value);
+	if (value == null || value === false) return null;
+	return createSSRAttribute(normalizedName, value === true ? true : String(value));
+}
+function createStyleAttribute(value) {
+	assertSyncSSRValue(value);
+	if (value == null) return null;
+	if (typeof value === "string") return createSSRAttribute("style", value);
+	const declarations = [];
+	for (const [key, declarationValue] of Object.entries(value)) {
+		assertSyncSSRValue(declarationValue);
+		if (declarationValue == null) continue;
+		declarations.push(`${normalizeStyleName(key)}:${normalizeStyleValue(key, declarationValue)}`);
+	}
+	return declarations.length ? createSSRAttribute("style", declarations.join(";")) : null;
+}
+function ssrProp(name, value) {
+	return createSSRProperty(name, value);
+}
+function createSSRAttribute(name, value) {
+	return {
+		name,
+		value
+	};
+}
+function serializeAttributes(attributes) {
+	let html = "";
+	for (const attribute of attributes) {
+		assertSyncSSRValue(attribute);
+		if (!attribute) continue;
+		assertSyncSSRValue(attribute.value);
+		html += ` ${attribute.name}`;
+		if (attribute.value !== true) html += `="${escapeHTMLAttribute(attribute.value)}"`;
+	}
+	return html;
+}
+function normalizeAttributeName(name) {
+	return name === "className" ? "class" : name;
+}
+function normalizeClass(value) {
+	assertSyncSSRValue(value);
+	if (!value) return "";
+	if (typeof value === "string") return value;
+	if (Array.isArray(value)) return value.map(normalizeClass).filter(Boolean).join(" ");
+	const tokens = value;
+	return Object.keys(tokens).filter((key) => {
+		assertSyncSSRValue(tokens[key]);
+		return tokens[key];
+	}).join(" ");
+}
+function normalizeStyleName(name) {
+	if (name.startsWith("--")) return name;
+	return name.replace(/[A-Z]/g, (character) => `-${character.toLowerCase()}`);
+}
+function normalizeStyleValue(name, value) {
+	if (typeof value === "number" && value !== 0 && !name.startsWith("--") && !UNITLESS_STYLES.has(name)) return `${value}px`;
+	return String(value);
+}
+const UNITLESS_STYLES = /* @__PURE__ */ new Set([
+	"opacity",
+	"zIndex",
+	"fontWeight",
+	"lineHeight",
+	"flex",
+	"flexGrow",
+	"flexShrink",
+	"order"
+]);
+//#endregion
+//#region packages/core/runtime-ssr/src/component.ts
+function ssrComponent(component, props) {
+	return component(props);
+}
+//#endregion
+//#region packages/core/runtime-ssr/src/controlFlow.ts
+function ssrShow(when, children, fallback) {
+	return resolve(when) ? resolve(children) : resolve(fallback) ?? null;
+}
+function Show(props) {
+	return resolve(props.when ? props.children : props.fallback) ?? null;
+}
+function ssrFor(each, render) {
+	return resolve(each)?.map((item, index) => render(item, index)) ?? null;
+}
+function For(props) {
+	return ssrFor(props.each, props.children);
+}
+function resolve(value) {
+	return typeof value === "function" ? value() : value;
+}
+//#endregion
+exports.For = For;
+exports.Show = Show;
+exports.renderToString = renderToString;
+exports.ssrAttr = ssrAttr;
+exports.ssrComponent = ssrComponent;
+exports.ssrElement = ssrElement;
+exports.ssrFor = ssrFor;
+exports.ssrProp = ssrProp;
+exports.ssrShow = ssrShow;
+exports.ssrStatic = ssrStatic;
+exports.ssrText = ssrText;

package/index.cjs

@@ -0,0 +1,7 @@
+'use strict'
+
+if (process.env.NODE_ENV === 'production') {
+  module.exports = require('./dist/runtime-ssr.prod.cjs')
+} else {
+  module.exports = require('./dist/runtime-ssr.cjs')
+}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@zeus-js/runtime-ssr",
+  "type": "module",
+  "version": "0.1.0-canary.20260805.97.1.fa5d9cef",
+  "description": "Server-side string rendering runtime for Zeus",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/baicie/zeus.git",
+    "directory": "packages/core/runtime-ssr"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/runtime-ssr.d.ts",
+      "module": "./dist/runtime-ssr.esm-bundler.js",
+      "import": "./dist/runtime-ssr.esm-bundler.js",
+      "require": {
+        "production": "./dist/runtime-ssr.prod.cjs",
+        "development": "./dist/runtime-ssr.cjs",
+        "default": "./index.cjs"
+      }
+    }
+  },
+  "files": [
+    "index.cjs",
+    "dist"
+  ],
+  "dependencies": {
+    "@zeus-js/signal": "0.1.0-canary.20260805.97.1.fa5d9cef"
+  },
+  "buildOptions": {
+    "name": "ZeusRuntimeSSR",
+    "formats": [
+      "esm-bundler",
+      "cjs"
+    ],
+    "target": "es2022"
+  },
+  "engines": {
+    "node": "^22.18.0 || >=24.11.0"
+  },
+  "main": "index.cjs",
+  "module": "dist/runtime-ssr.esm-bundler.js",
+  "types": "dist/runtime-ssr.d.ts"
+}