ilha 0.12.0 → 0.13.0

package/dist/internal.d.ts

@@ -1,5 +1,13 @@
-import { S as NativeEventModifier, T as RawHtml, x as NativeEventHandler } from "./index-DZI0fEmR.js";
+import { S as NativeEventModifier, T as RawHtml, k as TemplateNode, x as NativeEventHandler } from "./index-CVOjC94p.js";
 //#region src/internal.d.ts
+type ServerAction<A extends unknown[] = unknown[], R = unknown> = ((...args: A) => R) & {
+  with: (...args: unknown[]) => (...runtimeArgs: unknown[]) => unknown;
+};
+type ServerActionBinder = <A extends unknown[], R>(fn: (...args: A) => R, manifestId?: string) => ServerAction<A, R>;
+/** @internal Register core's action branding implementation. */
+declare function setServerActionBinder(binder: ServerActionBinder): void;
+/** @internal Brand an external server action for hydration-manifest replay. */
+declare function bindServerAction<A extends unknown[], R>(fn: (...args: A) => R, manifestId?: string): ServerAction<A, R>;
 /** Registry of live island mount handles keyed by host element. */
 declare const ISLAND_MOUNT_HANDLES: WeakMap<Element, {
   unmount: () => void | Promise<void>;
@@ -37,6 +45,14 @@ declare function __ilhaJsxSlot(options: {
   props: Record<string, unknown> | undefined;
   key: string | undefined;
 }): RawHtml;
+type TemplateRenderer = (node: TemplateNode) => RawHtml;
+/** Register the core's template→HTML renderer. Internal — called once by ilha. */
+declare function setTemplateRenderer(renderer: TemplateRenderer): void;
+/**
+ * @internal Render a template IR node to RawHtml. Used by the JSX runtime so
+ * elements skip the html`` string/parse round-trip.
+ */
+declare function __ilhaRenderTemplate(node: TemplateNode): RawHtml;
 /** A hydration-manifest entry: sentinel key → action id or captured payload. */
 type ManifestEntry = string | {
   k: string;
@@ -58,4 +74,4 @@ declare function setServerManifestSerializer(serializer: ServerManifestSerialize
 /** @internal Used by island rendering to serialize nested child manifests. */
 declare function serializeServerManifest(manifest: Map<string, ManifestEntry>): string;
 //#endregion
-export { ISLAND_MOUNT_HANDLES, ISLAND_MOUNT_INTERNAL, JsxEventRegistration, JsxRuntimeBridge, ManifestEntry, ServerManifestSerializer, __ilhaJsxEvent, __ilhaJsxSlot, serializeServerManifest, setJsxRuntimeBridge, setServerManifestSerializer };
+export { ISLAND_MOUNT_HANDLES, ISLAND_MOUNT_INTERNAL, JsxEventRegistration, JsxRuntimeBridge, ManifestEntry, ServerAction, ServerManifestSerializer, __ilhaJsxEvent, __ilhaJsxSlot, __ilhaRenderTemplate, bindServerAction, serializeServerManifest, setJsxRuntimeBridge, setServerActionBinder, setServerManifestSerializer, setTemplateRenderer };

package/dist/internal.js

@@ -1,4 +1,14 @@
 //#region src/internal.ts
+let serverActionBinder;
+/** @internal Register core's action branding implementation. */
+function setServerActionBinder(binder) {
+	serverActionBinder = binder;
+}
+/** @internal Brand an external server action for hydration-manifest replay. */
+function bindServerAction(fn, manifestId) {
+	if (!serverActionBinder) throw new Error("ilha: server action binder is unavailable");
+	return serverActionBinder(fn, manifestId);
+}
 /** Registry of live island mount handles keyed by host element. */
 const ISLAND_MOUNT_HANDLES = /* @__PURE__ */ new WeakMap();
 /** Hook a parent's mountSlots uses to mount a child island and keep a handle
@@ -20,6 +30,19 @@ function __ilhaJsxSlot(options) {
 		value: ""
 	};
 }
+let templateRenderer = null;
+/** Register the core's template→HTML renderer. Internal — called once by ilha. */
+function setTemplateRenderer(renderer) {
+	templateRenderer = renderer;
+}
+/**
+* @internal Render a template IR node to RawHtml. Used by the JSX runtime so
+* elements skip the html`` string/parse round-trip.
+*/
+function __ilhaRenderTemplate(node) {
+	if (!templateRenderer) throw new Error("ilha: template renderer is unavailable");
+	return templateRenderer(node);
+}
 let serverManifestSerializer = null;
 /**
 * Register the server-manifest serializer. Owned by @ilha/router — core only
@@ -36,4 +59,4 @@ function serializeServerManifest(manifest) {
 }
 
 //#endregion
-export { ISLAND_MOUNT_HANDLES, ISLAND_MOUNT_INTERNAL, __ilhaJsxEvent, __ilhaJsxSlot, serializeServerManifest, setJsxRuntimeBridge, setServerManifestSerializer };
+export { ISLAND_MOUNT_HANDLES, ISLAND_MOUNT_INTERNAL, __ilhaJsxEvent, __ilhaJsxSlot, __ilhaRenderTemplate, bindServerAction, serializeServerManifest, setJsxRuntimeBridge, setServerActionBinder, setServerManifestSerializer, setTemplateRenderer };

package/dist/jsx-dev-runtime.d.ts

@@ -1,2 +1,2 @@
-import { a as JSX, r as jsxDEV, t as Fragment } from "./jsx-runtime-BCGuHwTg.js";
+import { a as JSX, r as jsxDEV, t as Fragment } from "./jsx-runtime-CzU-60tX.js";
 export { Fragment, type JSX, jsxDEV };

package/dist/jsx-dev-runtime.js

@@ -1,3 +1,3 @@
-import { Fragment, jsxDEV } from "./jsx-runtime.js";
+import { r as jsxDEV, t as Fragment } from "./jsx-runtime-DreKruAt.js";
 
 export { Fragment, jsxDEV };

package/dist/{jsx-runtime-BCGuHwTg.d.ts → jsx-runtime-CzU-60tX.d.ts}

@@ -1,4 +1,4 @@
-import { E as SignalAccessor, O as SignalWriter, S as NativeEventModifier, T as RawHtml, x as NativeEventHandler } from "./index-DZI0fEmR.js";
+import { D as SignalWriter, E as SignalAccessor, S as NativeEventModifier, T as RawHtml, x as NativeEventHandler } from "./index-CVOjC94p.js";
 //#region src/jsx-types.d.ts
 declare namespace JSX {
   export type Child = unknown;

package/dist/jsx-runtime-DreKruAt.js

@@ -0,0 +1,124 @@
+import { __ilhaJsxSlot, __ilhaRenderTemplate } from "./internal.js";
+import { raw } from "./index.js";
+
+//#region src/template.ts
+function elementTemplate(tag, props, children) {
+	const attrs = { ...props };
+	delete attrs.children;
+	return {
+		kind: "element",
+		tag,
+		props: attrs,
+		children: children.flat(Infinity).map((value) => ({
+			kind: "dynamic",
+			value
+		}))
+	};
+}
+function fragmentTemplate(children) {
+	return {
+		kind: "fragment",
+		children: children.flat(Infinity).map((value) => ({
+			kind: "dynamic",
+			value
+		}))
+	};
+}
+
+//#endregion
+//#region src/jsx-runtime.ts
+const RAW = Symbol.for("ilha.raw");
+const ISLAND = Symbol.for("ilha.island");
+const ISLAND_CALL = Symbol.for("ilha.islandCall");
+const RENDER_PART = Symbol.for("ilha.renderPart");
+function isRawHtml(v) {
+	return !!(v && typeof v === "object" && RAW in v);
+}
+function isIsland(v) {
+	return typeof v === "function" && ISLAND in v;
+}
+function isIslandCall(v) {
+	if (v == null || typeof v !== "object" && typeof v !== "function") return false;
+	if (ISLAND_CALL in v) return true;
+	return typeof v === "object" && "island" in v && isIsland(v.island);
+}
+function normalizeJsxChildren(props, children) {
+	const propChildren = props && "children" in props ? props.children : void 0;
+	return (children.length > 0 ? children : propChildren === void 0 ? [] : [propChildren]).flat(1);
+}
+function normalizeJsxSlotKey(rawKey) {
+	const key = String(rawKey);
+	if (key.trim().length === 0) throw new Error("jsx key requires a non-empty string.");
+	if (key.includes(":")) throw new Error(`jsx key cannot contain the slot separator ":" (got "${key}").`);
+	return key;
+}
+function extractJsxSlotKey(props, keyArg) {
+	const fromProps = props?.key;
+	const rawKey = keyArg ?? (typeof fromProps === "string" || typeof fromProps === "number" ? fromProps : void 0);
+	if (rawKey == null) return void 0;
+	return normalizeJsxSlotKey(rawKey);
+}
+function escapeAttrValue(value) {
+	return value.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;");
+}
+function injectDataKey(out, key) {
+	const m = /^\s*<([a-zA-Z][a-zA-Z0-9:._-]*)/.exec(out.value);
+	if (!m) return out;
+	const openEnd = out.value.indexOf(">", m.index);
+	const openTag = out.value.slice(m.index, openEnd === -1 ? void 0 : openEnd);
+	if (/\sdata-key\s*=/.test(openTag)) return out;
+	const insertAt = m.index + m[0].length;
+	return raw(`${out.value.slice(0, insertAt)} data-key="${escapeAttrValue(key)}"${out.value.slice(insertAt)}`);
+}
+function renderJsxValue(value) {
+	return __ilhaRenderTemplate(fragmentTemplate([value]));
+}
+function renderJsxElement({ type, props, children, slotKey }) {
+	const attrs = { ...props ?? {} };
+	delete attrs.children;
+	if (slotKey !== void 0) attrs.key = slotKey;
+	return __ilhaRenderTemplate(elementTemplate(type, attrs, children));
+}
+function jsx(type, props, maybeKey, ...restChildren) {
+	const hasKeyArg = typeof maybeKey === "string" || typeof maybeKey === "number";
+	const keyFromArg = hasKeyArg ? maybeKey : void 0;
+	const normalizedChildren = normalizeJsxChildren(props, hasKeyArg || maybeKey === void 0 ? restChildren : [maybeKey, ...restChildren]);
+	const slotKey = extractJsxSlotKey(props, typeof keyFromArg === "string" || typeof keyFromArg === "number" ? keyFromArg : void 0);
+	if (typeof type === "function") {
+		const componentProps = {
+			...props,
+			...normalizedChildren.length > 0 ? { children: normalizedChildren } : {}
+		};
+		delete componentProps.key;
+		const out = type(Object.keys(componentProps).length ? componentProps : {});
+		if (isIslandCall(out)) {
+			if (slotKey !== void 0) out.key = slotKey;
+			return renderJsxValue(out);
+		}
+		if (isRawHtml(out)) return slotKey !== void 0 ? injectDataKey(out, slotKey) : out;
+		if (typeof out === "string" && isIsland(type)) return __ilhaJsxSlot({
+			island: type,
+			props: componentProps,
+			key: slotKey
+		});
+		if (typeof out === "string") return renderJsxValue(out);
+		if (typeof out === "object" && out !== null && Object.getPrototypeOf(out) === Object.prototype && out[RENDER_PART] === true && typeof out.toString === "function") return raw(String(out));
+		return renderJsxValue(out);
+	}
+	return renderJsxElement({
+		type,
+		props,
+		children: normalizedChildren,
+		slotKey
+	});
+}
+const jsxs = jsx;
+function Fragment(props, ...children) {
+	return __ilhaRenderTemplate(fragmentTemplate(normalizeJsxChildren(props, children)));
+}
+function jsxDEV(type, props, maybeKey, _source, _self) {
+	return jsx(type, props, maybeKey);
+}
+
+//#endregion
+export { jsxs as i, jsx as n, jsxDEV as r, Fragment as t };

package/dist/jsx-runtime.d.ts

@@ -1,2 +1,2 @@
-import { a as JSX, i as jsxs, n as jsx, r as jsxDEV, t as Fragment } from "./jsx-runtime-BCGuHwTg.js";
+import { a as JSX, i as jsxs, n as jsx, r as jsxDEV, t as Fragment } from "./jsx-runtime-CzU-60tX.js";
 export { Fragment, type JSX, jsx, jsxDEV, jsxs };

package/dist/jsx-runtime.js

@@ -1,237 +1,3 @@
-import { __ilhaJsxEvent, __ilhaJsxSlot } from "./internal.js";
-import { html, isSafeUrlAttrValue, isUrlAttributeName, raw, serializeStyle } from "./index.js";
+import { i as jsxs, n as jsx, r as jsxDEV, t as Fragment } from "./jsx-runtime-DreKruAt.js";
 
-//#region src/jsx-runtime.ts
-function toTemplateStrings(chunks) {
-	return Object.assign(chunks, { raw: chunks });
-}
-const RAW = Symbol.for("ilha.raw");
-const SIGNAL_ACCESSOR = Symbol.for("ilha.signalAccessor");
-const ISLAND = Symbol.for("ilha.island");
-const ISLAND_CALL = Symbol.for("ilha.islandCall");
-const RENDER_PART = Symbol.for("ilha.renderPart");
-const SAFE_NAME_RE = /^[A-Za-z_:][A-Za-z0-9:._-]*$/;
-const SAFE_BIND_LOCAL_RE = /^[A-Za-z][A-Za-z0-9]*$/;
-const SAFE_EVENT_PROP_RE = /^on([a-z][a-z0-9-]*)(?::(abortable|once|capture|passive))?$/;
-const JSX_ATTRIBUTE_ALIASES = {
-	className: "class",
-	htmlFor: "for",
-	acceptCharset: "accept-charset",
-	httpEquiv: "http-equiv",
-	accentHeight: "accent-height",
-	alignmentBaseline: "alignment-baseline",
-	baselineShift: "baseline-shift",
-	clipPath: "clip-path",
-	clipRule: "clip-rule",
-	dominantBaseline: "dominant-baseline",
-	fillOpacity: "fill-opacity",
-	fillRule: "fill-rule",
-	floodColor: "flood-color",
-	floodOpacity: "flood-opacity",
-	fontFamily: "font-family",
-	fontSize: "font-size",
-	fontStyle: "font-style",
-	fontWeight: "font-weight",
-	markerEnd: "marker-end",
-	markerMid: "marker-mid",
-	markerStart: "marker-start",
-	stopColor: "stop-color",
-	stopOpacity: "stop-opacity",
-	strokeDasharray: "stroke-dasharray",
-	strokeDashoffset: "stroke-dashoffset",
-	strokeLinecap: "stroke-linecap",
-	strokeLinejoin: "stroke-linejoin",
-	strokeMiterlimit: "stroke-miterlimit",
-	strokeOpacity: "stroke-opacity",
-	strokeWidth: "stroke-width",
-	textAnchor: "text-anchor",
-	vectorEffect: "vector-effect",
-	xlinkHref: "xlink:href"
-};
-const STRING_BOOLEAN_ATTRIBUTES = /* @__PURE__ */ new Set([
-	"contenteditable",
-	"draggable",
-	"spellcheck"
-]);
-const VOID_ELEMENTS = /* @__PURE__ */ new Set([
-	"area",
-	"base",
-	"br",
-	"col",
-	"embed",
-	"hr",
-	"img",
-	"input",
-	"link",
-	"meta",
-	"param",
-	"source",
-	"track",
-	"wbr"
-]);
-function isRawHtml(v) {
-	return !!(v && typeof v === "object" && RAW in v);
-}
-function isSignalAccessor(v) {
-	return typeof v === "function" && SIGNAL_ACCESSOR in v;
-}
-function isIsland(v) {
-	return typeof v === "function" && ISLAND in v;
-}
-function isIslandCall(v) {
-	if (v == null || typeof v !== "object" && typeof v !== "function") return false;
-	if (ISLAND_CALL in v) return true;
-	return typeof v === "object" && "island" in v && isIsland(v.island);
-}
-function normalizeClass(value) {
-	if (Array.isArray(value)) return value.filter(Boolean).join(" ");
-	if (value && typeof value === "object") return Object.entries(value).filter(([, enabled]) => Boolean(enabled)).map(([name]) => name).join(" ");
-	return String(value);
-}
-function normalizeJsxChildren(props, children) {
-	const propChildren = props && "children" in props ? props.children : void 0;
-	return (children.length > 0 ? children : propChildren === void 0 ? [] : [propChildren]).flat(1);
-}
-function normalizeJsxSlotKey(rawKey) {
-	const key = String(rawKey);
-	if (key.trim().length === 0) throw new Error("jsx key requires a non-empty string.");
-	if (key.includes(":")) throw new Error(`jsx key cannot contain the slot separator ":" (got "${key}").`);
-	return key;
-}
-function extractJsxSlotKey(props, keyArg) {
-	const fromProps = props?.key;
-	const rawKey = keyArg ?? (typeof fromProps === "string" || typeof fromProps === "number" ? fromProps : void 0);
-	if (rawKey == null) return void 0;
-	return normalizeJsxSlotKey(rawKey);
-}
-function pushJsxAttr({ chunks, values, eventSpecs, tagName, name, value }) {
-	if (value == null || name === "children" || name === "key") return;
-	if (name === "__proto__" || name === "constructor" || name === "prototype") return;
-	if (name.startsWith("bind:")) {
-		const [prefix, localName, ...rest] = name.split(":");
-		if (prefix !== "bind" || rest.length > 0 || !localName || !SAFE_BIND_LOCAL_RE.test(localName)) return;
-		if (!isSignalAccessor(value)) return;
-		chunks[chunks.length - 1] += ` ${prefix}:${localName}=`;
-		values.push(value);
-		chunks.push("");
-		return;
-	}
-	if (!SAFE_NAME_RE.test(name)) return;
-	const safeName = JSX_ATTRIBUTE_ALIASES[name] ?? name;
-	if (safeName.startsWith("on")) {
-		const eventMatch = SAFE_EVENT_PROP_RE.exec(safeName);
-		if (typeof value !== "function" || !eventMatch) return;
-		const eventName = eventMatch[1];
-		const modifier = eventMatch[2];
-		const index = __ilhaJsxEvent({
-			type: eventName,
-			handler: value,
-			modifier
-		});
-		if (index !== void 0) eventSpecs.push(`${eventName}:${index}`);
-		return;
-	}
-	const securityName = safeName.toLowerCase();
-	if (securityName === "srcdoc") return;
-	const stringBoolean = securityName.startsWith("aria-") || STRING_BOOLEAN_ATTRIBUTES.has(securityName);
-	if (typeof value === "boolean" && stringBoolean) value = String(value);
-	else if (value === false) return;
-	if (safeName === "class" && !isRawHtml(value)) value = normalizeClass(value);
-	if (safeName === "style" && value && typeof value === "object" && !isRawHtml(value)) value = serializeStyle(value);
-	if (isUrlAttributeName(securityName) && !isSafeUrlAttrValue(tagName, securityName, typeof value === "string" ? value : String(value))) return;
-	if (value === true) {
-		chunks[chunks.length - 1] += ` ${safeName}`;
-		return;
-	}
-	chunks[chunks.length - 1] += ` ${safeName}="`;
-	values.push(value);
-	chunks.push("\"");
-}
-function escapeAttrValue(value) {
-	return value.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;");
-}
-function injectDataKey(out, key) {
-	const m = /^\s*<([a-zA-Z][a-zA-Z0-9:._-]*)/.exec(out.value);
-	if (!m) return out;
-	const openEnd = out.value.indexOf(">", m.index);
-	const openTag = out.value.slice(m.index, openEnd === -1 ? void 0 : openEnd);
-	if (/\sdata-key\s*=/.test(openTag)) return out;
-	const insertAt = m.index + m[0].length;
-	return raw(`${out.value.slice(0, insertAt)} data-key="${escapeAttrValue(key)}"${out.value.slice(insertAt)}`);
-}
-function renderJsxElement({ type, props, children, slotKey }) {
-	const chunks = [`<${type}`];
-	const values = [];
-	const eventSpecs = [];
-	if (props) for (const [name, value] of Object.entries(props)) pushJsxAttr({
-		chunks,
-		values,
-		eventSpecs,
-		tagName: type,
-		name,
-		value
-	});
-	if (slotKey !== void 0 && props?.["data-key"] == null) pushJsxAttr({
-		chunks,
-		values,
-		eventSpecs,
-		tagName: type,
-		name: "data-key",
-		value: slotKey
-	});
-	if (eventSpecs.length > 0) chunks[chunks.length - 1] += ` data-ilha-on="${eventSpecs.join(",")}"`;
-	chunks[chunks.length - 1] += ">";
-	if (!VOID_ELEMENTS.has(type)) {
-		for (const child of children) {
-			values.push(child);
-			chunks.push("");
-		}
-		chunks[chunks.length - 1] += `</${type}>`;
-	}
-	return html(toTemplateStrings(chunks), ...values);
-}
-function jsx(type, props, maybeKey, ...restChildren) {
-	const hasKeyArg = typeof maybeKey === "string" || typeof maybeKey === "number";
-	const keyFromArg = hasKeyArg ? maybeKey : void 0;
-	const normalizedChildren = normalizeJsxChildren(props, hasKeyArg || maybeKey === void 0 ? restChildren : [maybeKey, ...restChildren]);
-	const slotKey = extractJsxSlotKey(props, typeof keyFromArg === "string" || typeof keyFromArg === "number" ? keyFromArg : void 0);
-	if (typeof type === "function") {
-		const componentProps = {
-			...props,
-			...normalizedChildren.length > 0 ? { children: normalizedChildren } : {}
-		};
-		delete componentProps.key;
-		const out = type(Object.keys(componentProps).length ? componentProps : {});
-		if (isIslandCall(out)) {
-			if (slotKey !== void 0) out.key = slotKey;
-			return html`${out}`;
-		}
-		if (isRawHtml(out)) return slotKey !== void 0 ? injectDataKey(out, slotKey) : out;
-		if (typeof out === "string" && isIsland(type)) return __ilhaJsxSlot({
-			island: type,
-			props: componentProps,
-			key: slotKey
-		});
-		if (typeof out === "string") return html`${out}`;
-		if (typeof out === "object" && out !== null && Object.getPrototypeOf(out) === Object.prototype && out[RENDER_PART] === true && typeof out.toString === "function") return raw(String(out));
-		return html`${out}`;
-	}
-	return renderJsxElement({
-		type,
-		props,
-		children: normalizedChildren,
-		slotKey
-	});
-}
-const jsxs = jsx;
-function Fragment(props, ...children) {
-	const normalizedChildren = normalizeJsxChildren(props, children);
-	const chunks = ["", ...normalizedChildren.map(() => "")];
-	return html(toTemplateStrings(chunks), ...normalizedChildren);
-}
-function jsxDEV(type, props, maybeKey, _source, _self) {
-	return jsx(type, props, maybeKey);
-}
-
-//#endregion
 export { Fragment, jsx, jsxDEV, jsxs };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ilha",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "A tiny, framework-free island architecture library",
   "keywords": [
     "framework-free",