@levo-so/site-runtime 0.2.3 → 0.3.1

package/es-iCqKQf1c.js

@@ -0,0 +1,455 @@
+//#region ../../node_modules/.pnpm/html-to-image@1.11.13/node_modules/html-to-image/es/util.js
+function e(e, t) {
+	if (e.match(/^[a-z]+:\/\//i)) return e;
+	if (e.match(/^\/\//)) return window.location.protocol + e;
+	if (e.match(/^[a-z]+:/i)) return e;
+	let n = document.implementation.createHTMLDocument(), r = n.createElement("base"), i = n.createElement("a");
+	return n.head.appendChild(r), n.body.appendChild(i), t && (r.href = t), i.href = e, i.href;
+}
+var t = (() => {
+	let e = 0, t = () => `0000${(Math.random() * 36 ** 4 << 0).toString(36)}`.slice(-4);
+	return () => (e += 1, `u${t()}${e}`);
+})();
+function n(e) {
+	let t = [];
+	for (let n = 0, r = e.length; n < r; n++) t.push(e[n]);
+	return t;
+}
+var r = null;
+function i(e = {}) {
+	return r || (e.includeStyleProperties ? (r = e.includeStyleProperties, r) : (r = n(window.getComputedStyle(document.documentElement)), r));
+}
+function a(e, t) {
+	let n = (e.ownerDocument.defaultView || window).getComputedStyle(e).getPropertyValue(t);
+	return n ? parseFloat(n.replace("px", "")) : 0;
+}
+function o(e) {
+	let t = a(e, "border-left-width"), n = a(e, "border-right-width");
+	return e.clientWidth + t + n;
+}
+function s(e) {
+	let t = a(e, "border-top-width"), n = a(e, "border-bottom-width");
+	return e.clientHeight + t + n;
+}
+function c(e, t = {}) {
+	return {
+		width: t.width || o(e),
+		height: t.height || s(e)
+	};
+}
+function l() {
+	let e, t;
+	try {
+		t = process;
+	} catch {}
+	let n = t && t.env ? t.env.devicePixelRatio : null;
+	return n && (e = parseInt(n, 10), Number.isNaN(e) && (e = 1)), e || window.devicePixelRatio || 1;
+}
+var u = 16384;
+function ee(e) {
+	(e.width > u || e.height > u) && (e.width > u && e.height > u ? e.width > e.height ? (e.height *= u / e.width, e.width = u) : (e.width *= u / e.height, e.height = u) : e.width > u ? (e.height *= u / e.width, e.width = u) : (e.width *= u / e.height, e.height = u));
+}
+function d(e) {
+	return new Promise((t, n) => {
+		let r = new Image();
+		r.onload = () => {
+			r.decode().then(() => {
+				requestAnimationFrame(() => t(r));
+			});
+		}, r.onerror = n, r.crossOrigin = "anonymous", r.decoding = "async", r.src = e;
+	});
+}
+async function f(e) {
+	return Promise.resolve().then(() => new XMLSerializer().serializeToString(e)).then(encodeURIComponent).then((e) => `data:image/svg+xml;charset=utf-8,${e}`);
+}
+async function te(e, t, n) {
+	let r = "http://www.w3.org/2000/svg", i = document.createElementNS(r, "svg"), a = document.createElementNS(r, "foreignObject");
+	return i.setAttribute("width", `${t}`), i.setAttribute("height", `${n}`), i.setAttribute("viewBox", `0 0 ${t} ${n}`), a.setAttribute("width", "100%"), a.setAttribute("height", "100%"), a.setAttribute("x", "0"), a.setAttribute("y", "0"), a.setAttribute("externalResourcesRequired", "true"), i.appendChild(a), a.appendChild(e), f(i);
+}
+var p = (e, t) => {
+	if (e instanceof t) return !0;
+	let n = Object.getPrototypeOf(e);
+	return n === null ? !1 : n.constructor.name === t.name || p(n, t);
+};
+//#endregion
+//#region ../../node_modules/.pnpm/html-to-image@1.11.13/node_modules/html-to-image/es/clone-pseudos.js
+function m(e) {
+	let t = e.getPropertyValue("content");
+	return `${e.cssText} content: '${t.replace(/'|"/g, "")}';`;
+}
+function ne(e, t) {
+	return i(t).map((t) => `${t}: ${e.getPropertyValue(t)}${e.getPropertyPriority(t) ? " !important" : ""};`).join(" ");
+}
+function re(e, t, n, r) {
+	let i = `.${e}:${t}`, a = n.cssText ? m(n) : ne(n, r);
+	return document.createTextNode(`${i}{${a}}`);
+}
+function h(e, n, r, i) {
+	let a = window.getComputedStyle(e, r), o = a.getPropertyValue("content");
+	if (o === "" || o === "none") return;
+	let s = t();
+	try {
+		n.className = `${n.className} ${s}`;
+	} catch {
+		return;
+	}
+	let c = document.createElement("style");
+	c.appendChild(re(s, r, a, i)), n.appendChild(c);
+}
+function ie(e, t, n) {
+	h(e, t, ":before", n), h(e, t, ":after", n);
+}
+//#endregion
+//#region ../../node_modules/.pnpm/html-to-image@1.11.13/node_modules/html-to-image/es/mimes.js
+var g = "application/font-woff", _ = "image/jpeg", v = {
+	woff: g,
+	woff2: g,
+	ttf: "application/font-truetype",
+	eot: "application/vnd.ms-fontobject",
+	png: "image/png",
+	jpg: _,
+	jpeg: _,
+	gif: "image/gif",
+	tiff: "image/tiff",
+	svg: "image/svg+xml",
+	webp: "image/webp"
+};
+function y(e) {
+	let t = /\.([^./]*?)$/g.exec(e);
+	return t ? t[1] : "";
+}
+function b(e) {
+	return v[y(e).toLowerCase()] || "";
+}
+//#endregion
+//#region ../../node_modules/.pnpm/html-to-image@1.11.13/node_modules/html-to-image/es/dataurl.js
+function x(e) {
+	return e.split(/,/)[1];
+}
+function S(e) {
+	return e.search(/^(data:)/) !== -1;
+}
+function C(e, t) {
+	return `data:${t};base64,${e}`;
+}
+async function w(e, t, n) {
+	let r = await fetch(e, t);
+	if (r.status === 404) throw Error(`Resource "${r.url}" not found`);
+	let i = await r.blob();
+	return new Promise((e, t) => {
+		let a = new FileReader();
+		a.onerror = t, a.onloadend = () => {
+			try {
+				e(n({
+					res: r,
+					result: a.result
+				}));
+			} catch (e) {
+				t(e);
+			}
+		}, a.readAsDataURL(i);
+	});
+}
+var T = {};
+function ae(e, t, n) {
+	let r = e.replace(/\?.*/, "");
+	return n && (r = e), /ttf|otf|eot|woff2?/i.test(r) && (r = r.replace(/.*\//, "")), t ? `[${t}]${r}` : r;
+}
+async function E(e, t, n) {
+	let r = ae(e, t, n.includeQueryParams);
+	if (T[r] != null) return T[r];
+	n.cacheBust && (e += (/\?/.test(e) ? "&" : "?") + (/* @__PURE__ */ new Date()).getTime());
+	let i;
+	try {
+		i = C(await w(e, n.fetchRequestInit, ({ res: e, result: n }) => (t ||= e.headers.get("Content-Type") || "", x(n))), t);
+	} catch (t) {
+		i = n.imagePlaceholder || "";
+		let r = `Failed to fetch resource: ${e}`;
+		t && (r = typeof t == "string" ? t : t.message), r && console.warn(r);
+	}
+	return T[r] = i, i;
+}
+//#endregion
+//#region ../../node_modules/.pnpm/html-to-image@1.11.13/node_modules/html-to-image/es/clone-node.js
+async function oe(e) {
+	let t = e.toDataURL();
+	return t === "data:," ? e.cloneNode(!1) : d(t);
+}
+async function se(e, t) {
+	if (e.currentSrc) {
+		let t = document.createElement("canvas"), n = t.getContext("2d");
+		return t.width = e.clientWidth, t.height = e.clientHeight, n?.drawImage(e, 0, 0, t.width, t.height), d(t.toDataURL());
+	}
+	let n = e.poster;
+	return d(await E(n, b(n), t));
+}
+async function ce(e, t) {
+	try {
+		if (e?.contentDocument?.body) return await I(e.contentDocument.body, t, !0);
+	} catch {}
+	return e.cloneNode(!1);
+}
+async function D(e, t) {
+	return p(e, HTMLCanvasElement) ? oe(e) : p(e, HTMLVideoElement) ? se(e, t) : p(e, HTMLIFrameElement) ? ce(e, t) : e.cloneNode(k(e));
+}
+var O = (e) => e.tagName != null && e.tagName.toUpperCase() === "SLOT", k = (e) => e.tagName != null && e.tagName.toUpperCase() === "SVG";
+async function A(e, t, r) {
+	if (k(t)) return t;
+	let i = [];
+	return i = O(e) && e.assignedNodes ? n(e.assignedNodes()) : p(e, HTMLIFrameElement) && e.contentDocument?.body ? n(e.contentDocument.body.childNodes) : n((e.shadowRoot ?? e).childNodes), i.length === 0 || p(e, HTMLVideoElement) || await i.reduce((e, n) => e.then(() => I(n, r)).then((e) => {
+		e && t.appendChild(e);
+	}), Promise.resolve()), t;
+}
+function j(e, t, n) {
+	let r = t.style;
+	if (!r) return;
+	let a = window.getComputedStyle(e);
+	a.cssText ? (r.cssText = a.cssText, r.transformOrigin = a.transformOrigin) : i(n).forEach((n) => {
+		let i = a.getPropertyValue(n);
+		n === "font-size" && i.endsWith("px") && (i = `${Math.floor(parseFloat(i.substring(0, i.length - 2))) - .1}px`), p(e, HTMLIFrameElement) && n === "display" && i === "inline" && (i = "block"), n === "d" && t.getAttribute("d") && (i = `path(${t.getAttribute("d")})`), r.setProperty(n, i, a.getPropertyPriority(n));
+	});
+}
+function M(e, t) {
+	p(e, HTMLTextAreaElement) && (t.innerHTML = e.value), p(e, HTMLInputElement) && t.setAttribute("value", e.value);
+}
+function N(e, t) {
+	if (p(e, HTMLSelectElement)) {
+		let n = t, r = Array.from(n.children).find((t) => e.value === t.getAttribute("value"));
+		r && r.setAttribute("selected", "");
+	}
+}
+function P(e, t, n) {
+	return p(t, Element) && (j(e, t, n), ie(e, t, n), M(e, t), N(e, t)), t;
+}
+async function F(e, t) {
+	let n = e.querySelectorAll ? e.querySelectorAll("use") : [];
+	if (n.length === 0) return e;
+	let r = {};
+	for (let i = 0; i < n.length; i++) {
+		let a = n[i].getAttribute("xlink:href");
+		if (a) {
+			let n = e.querySelector(a), i = document.querySelector(a);
+			!n && i && !r[a] && (r[a] = await I(i, t, !0));
+		}
+	}
+	let i = Object.values(r);
+	if (i.length) {
+		let t = "http://www.w3.org/1999/xhtml", n = document.createElementNS(t, "svg");
+		n.setAttribute("xmlns", t), n.style.position = "absolute", n.style.width = "0", n.style.height = "0", n.style.overflow = "hidden", n.style.display = "none";
+		let r = document.createElementNS(t, "defs");
+		n.appendChild(r);
+		for (let e = 0; e < i.length; e++) r.appendChild(i[e]);
+		e.appendChild(n);
+	}
+	return e;
+}
+async function I(e, t, n) {
+	return !n && t.filter && !t.filter(e) ? null : Promise.resolve(e).then((e) => D(e, t)).then((n) => A(e, n, t)).then((n) => P(e, n, t)).then((e) => F(e, t));
+}
+//#endregion
+//#region ../../node_modules/.pnpm/html-to-image@1.11.13/node_modules/html-to-image/es/embed-resources.js
+var L = /url\((['"]?)([^'"]+?)\1\)/g, R = /url\([^)]+\)\s*format\((["']?)([^"']+)\1\)/g, z = /src:\s*(?:url\([^)]+\)\s*format\([^)]+\)[,;]\s*)+/g;
+function B(e) {
+	let t = e.replace(/([.*+?^${}()|\[\]\/\\])/g, "\\$1");
+	return RegExp(`(url\\(['"]?)(${t})(['"]?\\))`, "g");
+}
+function V(e) {
+	let t = [];
+	return e.replace(L, (e, n, r) => (t.push(r), e)), t.filter((e) => !S(e));
+}
+async function H(t, n, r, i, a) {
+	try {
+		let o = r ? e(n, r) : n, s = b(n), c;
+		return c = a ? C(await a(o), s) : await E(o, s, i), t.replace(B(n), `$1${c}$3`);
+	} catch {}
+	return t;
+}
+function le(e, { preferredFontFormat: t }) {
+	return t ? e.replace(z, (e) => {
+		for (;;) {
+			let [n, , r] = R.exec(e) || [];
+			if (!r) return "";
+			if (r === t) return `src: ${n};`;
+		}
+	}) : e;
+}
+function U(e) {
+	return e.search(L) !== -1;
+}
+async function W(e, t, n) {
+	if (!U(e)) return e;
+	let r = le(e, n);
+	return V(r).reduce((e, r) => e.then((e) => H(e, r, t, n)), Promise.resolve(r));
+}
+//#endregion
+//#region ../../node_modules/.pnpm/html-to-image@1.11.13/node_modules/html-to-image/es/embed-images.js
+async function G(e, t, n) {
+	let r = t.style?.getPropertyValue(e);
+	if (r) {
+		let i = await W(r, null, n);
+		return t.style.setProperty(e, i, t.style.getPropertyPriority(e)), !0;
+	}
+	return !1;
+}
+async function ue(e, t) {
+	await G("background", e, t) || await G("background-image", e, t), await G("mask", e, t) || await G("-webkit-mask", e, t) || await G("mask-image", e, t) || await G("-webkit-mask-image", e, t);
+}
+async function de(e, t) {
+	let n = p(e, HTMLImageElement);
+	if (!(n && !S(e.src)) && !(p(e, SVGImageElement) && !S(e.href.baseVal))) return;
+	let r = n ? e.src : e.href.baseVal, i = await E(r, b(r), t);
+	await new Promise((r, a) => {
+		e.onload = r, e.onerror = t.onImageErrorHandler ? (...e) => {
+			try {
+				r(t.onImageErrorHandler(...e));
+			} catch (e) {
+				a(e);
+			}
+		} : a;
+		let o = e;
+		o.decode &&= r, o.loading === "lazy" && (o.loading = "eager"), n ? (e.srcset = "", e.src = i) : e.href.baseVal = i;
+	});
+}
+async function fe(e, t) {
+	let r = n(e.childNodes).map((e) => K(e, t));
+	await Promise.all(r).then(() => e);
+}
+async function K(e, t) {
+	p(e, Element) && (await ue(e, t), await de(e, t), await fe(e, t));
+}
+//#endregion
+//#region ../../node_modules/.pnpm/html-to-image@1.11.13/node_modules/html-to-image/es/apply-style.js
+function pe(e, t) {
+	let { style: n } = e;
+	t.backgroundColor && (n.backgroundColor = t.backgroundColor), t.width && (n.width = `${t.width}px`), t.height && (n.height = `${t.height}px`);
+	let r = t.style;
+	return r != null && Object.keys(r).forEach((e) => {
+		n[e] = r[e];
+	}), e;
+}
+//#endregion
+//#region ../../node_modules/.pnpm/html-to-image@1.11.13/node_modules/html-to-image/es/embed-webfonts.js
+var q = {};
+async function J(e) {
+	let t = q[e];
+	return t ?? (t = {
+		url: e,
+		cssText: await (await fetch(e)).text()
+	}, q[e] = t, t);
+}
+async function Y(e, t) {
+	let n = e.cssText, r = /url\(["']?([^"')]+)["']?\)/g, i = (n.match(/url\([^)]+\)/g) || []).map(async (i) => {
+		let a = i.replace(r, "$1");
+		return a.startsWith("https://") || (a = new URL(a, e.url).href), w(a, t.fetchRequestInit, ({ result: e }) => (n = n.replace(i, `url(${e})`), [i, e]));
+	});
+	return Promise.all(i).then(() => n);
+}
+function X(e) {
+	if (e == null) return [];
+	let t = [], n = e.replace(/(\/\*[\s\S]*?\*\/)/gi, ""), r = /* @__PURE__ */ RegExp("((@.*?keyframes [\\s\\S]*?){([\\s\\S]*?}\\s*?)})", "gi");
+	for (;;) {
+		let e = r.exec(n);
+		if (e === null) break;
+		t.push(e[0]);
+	}
+	n = n.replace(r, "");
+	let i = /@import[\s\S]*?url\([^)]*\)[\s\S]*?;/gi, a = /* @__PURE__ */ RegExp("((\\s*?(?:\\/\\*[\\s\\S]*?\\*\\/)?\\s*?@media[\\s\\S]*?){([\\s\\S]*?)}\\s*?})|(([\\s\\S]*?){([\\s\\S]*?)})", "gi");
+	for (;;) {
+		let e = i.exec(n);
+		if (e === null) {
+			if (e = a.exec(n), e === null) break;
+			i.lastIndex = a.lastIndex;
+		} else a.lastIndex = i.lastIndex;
+		t.push(e[0]);
+	}
+	return t;
+}
+async function me(e, t) {
+	let r = [], i = [];
+	return e.forEach((r) => {
+		if ("cssRules" in r) try {
+			n(r.cssRules || []).forEach((e, n) => {
+				if (e.type === CSSRule.IMPORT_RULE) {
+					let a = n + 1, o = e.href, s = J(o).then((e) => Y(e, t)).then((e) => X(e).forEach((e) => {
+						try {
+							r.insertRule(e, e.startsWith("@import") ? a += 1 : r.cssRules.length);
+						} catch (t) {
+							console.error("Error inserting rule from remote css", {
+								rule: e,
+								error: t
+							});
+						}
+					})).catch((e) => {
+						console.error("Error loading remote css", e.toString());
+					});
+					i.push(s);
+				}
+			});
+		} catch (n) {
+			let a = e.find((e) => e.href == null) || document.styleSheets[0];
+			r.href != null && i.push(J(r.href).then((e) => Y(e, t)).then((e) => X(e).forEach((e) => {
+				a.insertRule(e, a.cssRules.length);
+			})).catch((e) => {
+				console.error("Error loading remote stylesheet", e);
+			})), console.error("Error inlining remote css file", n);
+		}
+	}), Promise.all(i).then(() => (e.forEach((e) => {
+		if ("cssRules" in e) try {
+			n(e.cssRules || []).forEach((e) => {
+				r.push(e);
+			});
+		} catch (t) {
+			console.error(`Error while reading CSS rules from ${e.href}`, t);
+		}
+	}), r));
+}
+function he(e) {
+	return e.filter((e) => e.type === CSSRule.FONT_FACE_RULE).filter((e) => U(e.style.getPropertyValue("src")));
+}
+async function ge(e, t) {
+	if (e.ownerDocument == null) throw Error("Provided element is not within a Document");
+	return he(await me(n(e.ownerDocument.styleSheets), t));
+}
+function Z(e) {
+	return e.trim().replace(/["']/g, "");
+}
+function _e(e) {
+	let t = /* @__PURE__ */ new Set();
+	function n(e) {
+		(e.style.fontFamily || getComputedStyle(e).fontFamily).split(",").forEach((e) => {
+			t.add(Z(e));
+		}), Array.from(e.children).forEach((e) => {
+			e instanceof HTMLElement && n(e);
+		});
+	}
+	return n(e), t;
+}
+async function Q(e, t) {
+	let n = await ge(e, t), r = _e(e);
+	return (await Promise.all(n.filter((e) => r.has(Z(e.style.fontFamily))).map((e) => {
+		let n = e.parentStyleSheet ? e.parentStyleSheet.href : null;
+		return W(e.cssText, n, t);
+	}))).join("\n");
+}
+async function ve(e, t) {
+	let n = t.fontEmbedCSS == null ? t.skipFonts ? null : await Q(e, t) : t.fontEmbedCSS;
+	if (n) {
+		let t = document.createElement("style"), r = document.createTextNode(n);
+		t.appendChild(r), e.firstChild ? e.insertBefore(t, e.firstChild) : e.appendChild(t);
+	}
+}
+//#endregion
+//#region ../../node_modules/.pnpm/html-to-image@1.11.13/node_modules/html-to-image/es/index.js
+async function ye(e, t = {}) {
+	let { width: n, height: r } = c(e, t), i = await I(e, t, !0);
+	return await ve(i, t), await K(i, t), pe(i, t), await te(i, n, r);
+}
+async function $(e, t = {}) {
+	let { width: n, height: r } = c(e, t), i = await d(await ye(e, t)), a = document.createElement("canvas"), o = a.getContext("2d"), s = t.pixelRatio || l(), u = t.canvasWidth || n, f = t.canvasHeight || r;
+	return a.width = u * s, a.height = f * s, t.skipAutoScale || ee(a), a.style.width = `${u}`, a.style.height = `${f}`, t.backgroundColor && (o.fillStyle = t.backgroundColor, o.fillRect(0, 0, a.width, a.height)), o.drawImage(i, 0, 0, a.width, a.height), a;
+}
+async function be(e, t = {}) {
+	return (await $(e, t)).toDataURL();
+}
+//#endregion
+export { $ as toCanvas, be as toPng };

package/index.d.ts

@@ -141,6 +141,16 @@ export declare type IEditorToPreview = {
 } | {
     type: "clear-staged";
     stageId?: string;
+}
+/**
+* Rasterize the CURRENTLY selected element to a PNG data URL (reply:
+* `capture-result`). Selection-state based — no locator round-trip — so it also
+* works for unstamped elements and never suffers stale-locator misses. The editor
+* attaches the result to the chat so the model can see what the user selected.
+*/
+| {
+    type: "capture-selected";
+    requestId: string;
 };
 
 /** A nested element locator — `file:line:col` + occurrence index. Never top-level. */
@@ -287,6 +297,12 @@ export declare interface ILevoPopupsProps {
      * workspace-wide active popups are returned.
      */
     siteId?: string;
+    /**
+     * The current page's platform id, read from the head by `LevoSiteProvider` (see
+     * `../pageId`). Feeds page-bound targeting rules ("show on the pricing page", "show on
+     * all blog posts"). Absent → those rules never match; URL-path rules still do.
+     */
+    pageId?: string;
 }
 
 /** A single-record binding — one collection record / blog post / event by `slug` (a detail page). */
@@ -427,6 +443,13 @@ export declare interface IPatchedHistoryFn {
 
 /** The full `meta/<route>.json` shape: page identity (platform-owned) + the SEO object. */
 export declare interface IPlatformMetaFile {
+    /**
+     * The platform's page id. Stamped by the platform (never by the AI) and used for
+     * analytics `page_id` + popup page-bound targeting — see `./pageId`. Ships empty on
+     * sites provisioned before the platform started stamping it; empty = simply absent,
+     * every consumer degrades to URL-based behavior.
+     */
+    id?: string;
     title?: string;
     description?: string;
     meta?: IPlatformPageMeta;
@@ -495,6 +518,37 @@ export declare type IPreviewToEditor = {
 } | {
     type: "highlight-miss";
     element: IElementLocator;
+}
+/**
+* Reply to `capture-selected`. `dataUrl` is a `data:image/png;base64,…` render of the
+* selected element, or null with `error` set ("no-selection", "capture-failed") —
+* always sent, so the editor's pending request settles instead of timing out.
+*/
+| {
+    type: "capture-result";
+    requestId: string;
+    dataUrl: string | null;
+    error?: string;
+}
+/**
+* A select-mode marquee drag finished. `rect` is the dragged area (viewport coords at
+* capture time), `elements` the topmost source-stamped elements substantially inside
+* it (capped — `truncated` set when over the cap), `dataUrl` a PNG render of exactly
+* that area (null when rasterizing failed; the element list is still useful alone).
+* Unlike `capture-selected` this is push-based: one drag = one deliberate intent, so
+* the runtime captures immediately instead of waiting for an editor request.
+*/
+| {
+    type: "region-selected";
+    rect: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    elements: IRegionElement[];
+    truncated: boolean;
+    dataUrl: string | null;
 };
 
 /**
@@ -510,6 +564,20 @@ export declare interface IQueryClientLike {
     }) => Promise<unknown>;
 }
 
+/**
+ * One element inside a drag-selected region — the lean sibling of
+ * {@link ISelectedElement}: just enough for the AI to locate it (`source`/`index`)
+ * and for the editor to label it. Only source-stamped elements make the list.
+ */
+export declare interface IRegionElement {
+    source: string;
+    index: number;
+    tag: string;
+    label: string;
+    /** Direct display text, truncated. Omitted for non-text containers. */
+    text?: string;
+}
+
 /** The element-selected payload — see `selectedPayload`. */
 export declare interface ISelectedElement {
     tag: string;
@@ -686,9 +754,10 @@ export declare const LevoForm: React.FC<ILevoFormProps>;
  * everything else: it fetches active popups, evaluates page/referrer targeting against the
  * current URL, lazy-loads the renderer only when popups exist, and self-hides otherwise.
  *
- * No `pageId` is threaded: that is a studio DB page id with no equivalent in a code-routed
- * site, so page-bound rules don't apply here — site-wide and URL-path targeting (the
- * `is_all_pages` / `contains` / `begins_with` matchers) do.
+ * `pageId` comes from the matched route's `meta/<route>.json` (the provider reads it off the
+ * head — see `../pageId`), which is what makes page-bound rules work on a code-routed site.
+ * Sites whose meta files carry no id still get site-wide and URL-path targeting (the
+ * `is_all_pages` / `contains` / `begins_with` matchers).
  */
 export declare const LevoPopups: React.FC<ILevoPopupsProps>;
 
@@ -709,6 +778,9 @@ export declare const LevoSiteProvider: React.FC<{
     children: React.ReactNode;
 }>;
 
+/** `name` of the head tag carrying the page id. Written by `levoHead`, read by `readPageId`. */
+export declare const PAGE_ID_META = "levo:page-id";
+
 /**
  * Renders a page's metadata as document tags. Pages include it anywhere in their JSX —
  * React 19 hoists <title>/<meta>/<link> into <head> (SSR too); scripts render in place
@@ -763,6 +835,13 @@ export declare const prefetchLevoSources: ({ queryClient, config, sources, param
     params?: Record<string, string>;
 }) => Promise<Record<string, unknown>>;
 
+/**
+ * The id the currently matched route stamped into the head, or null when the site's
+ * platform hasn't stamped ids into its meta files yet (the field ships empty). Client-only —
+ * returns null during SSR, so callers must read it in an effect.
+ */
+export declare const readPageId: () => string | null;
+
 /** What `system` resolves to — the class actually on `<html>`. */
 export declare type ResolvedColorMode = "dark" | "light";