@plitzi/sdk-shared 0.37.9 → 0.38.1

package/dist/realtime/client.mjs

@@ -1,12 +1,13 @@
+import { pConsole as e } from "../devTools/utils/PlitziConsole.mjs";
 import "./topics.mjs";
 //#region src/realtime/client.ts
-var e = 30, t = [
+var t = 30, n = [
 	500,
 	1e3,
 	2e3,
 	5e3,
 	1e4
-], n = 5e3, r = (e) => typeof e == "object" && !!e && "connection" in e && typeof e.connection == "string" && "refused" in e && Array.isArray(e.refused), i = (e) => typeof e == "object" && !!e && "topic" in e && typeof e.topic == "string" && "type" in e && typeof e.type == "string", a = (e) => typeof e == "object" && !!e && "id" in e && typeof e.id == "number" && "ok" in e && typeof e.ok == "boolean", o = (e) => {
+], r = 5e3, i = (e) => typeof e == "object" && !!e && "connection" in e && typeof e.connection == "string" && "refused" in e && Array.isArray(e.refused), a = (e) => typeof e == "object" && !!e && "topic" in e && typeof e.topic == "string" && "type" in e && typeof e.type == "string", o = (e) => typeof e == "object" && !!e && "id" in e && typeof e.id == "number" && "ok" in e && typeof e.ok == "boolean", s = (e) => {
 	let t = "message", n = [];
 	for (let r of e.split("\n")) r.startsWith("event: ") ? t = r.slice(7) : r.startsWith("data: ") && n.push(r.slice(6));
 	if (n.length) try {
@@ -17,7 +18,7 @@ var e = 30, t = [
 	} catch {
 		return;
 	}
-}, s = (e) => {
+}, c = (e) => {
 	try {
 		let t = JSON.parse(String(e));
 		return typeof t == "object" && t && "event" in t && typeof t.event == "string" ? {
@@ -27,166 +28,193 @@ var e = 30, t = [
 	} catch {
 		return;
 	}
-}, c = (e, t) => {
+}, l = (e, t) => {
 	let n = new URL(`${e}?${t}`, globalThis.location.href);
 	return n.protocol = n.protocol === "https:" ? "wss:" : "ws:", n.href;
-}, l = (l, { transport: u = "sse", fetchImpl: d = fetch, WebSocketImpl: f = globalThis.WebSocket } = {}) => {
-	let p = /* @__PURE__ */ new Map(), m = /* @__PURE__ */ new Map(), h = /* @__PURE__ */ new Set(), g = "idle", _, v = /* @__PURE__ */ new Map(), y, b, x = 0, S = u === "websocket" && typeof f == "function", C = (e) => {
-		g = e, h.forEach((t) => t(e));
-	}, w = () => [...p.keys()].sort().join(","), T = (e) => {
-		let t = e.split(",").flatMap((e) => m.get(e) ?? []);
-		return `topics=${encodeURIComponent(e)}${t.length ? `&grants=${encodeURIComponent(t.join(","))}` : ""}`;
+}, u = (e, { transport: u = "sse", fetchImpl: f = fetch, WebSocketImpl: p = globalThis.WebSocket } = {}) => {
+	let m = /* @__PURE__ */ new Map(), h = /* @__PURE__ */ new Map(), g = /* @__PURE__ */ new Set(), _ = "idle", v, y = /* @__PURE__ */ new Map(), b, x, S = 0, C = u === "websocket" && typeof p == "function", w = () => [...m.keys()].sort().join(","), T = (e) => {
+		_ = e;
+		let t = w().split(",").filter(Boolean), n = v?.transport ?? (C ? "websocket" : "sse");
+		d(e === "open" ? "success" : e === "closed" ? "warning" : "info", `${e} · ${t.join(", ") || "no topics"}`, {
+			event: "status",
+			status: e,
+			topics: t,
+			transport: n
+		}), g.forEach((t) => t(e));
 	}, E = (e) => {
-		e.type === "$revoked" && e.from === "server" && v.set(e.topic, "revoked"), p.get(e.topic)?.forEach((t) => t(e));
-	}, D = (e, t) => {
-		e.me = t.connection, v = new Map(t.refused.map((e) => [e.topic, e.reason])), x = 0, C("open");
+		for (let [t, n] of e) y.set(t, n), d("danger", `${t} refused: ${n}`, {
+			event: "refused",
+			topic: t,
+			reason: n
+		});
+	}, D = (e) => {
+		let t = e.split(",").flatMap((e) => h.get(e) ?? []);
+		return `topics=${encodeURIComponent(e)}${t.length ? `&grants=${encodeURIComponent(t.join(","))}` : ""}`;
 	}, O = (e) => {
-		if (_ !== e) return;
-		C("connecting");
-		let n = t[Math.min(x, t.length - 1)];
-		x += 1, b = setTimeout(j, n);
+		e.type === "$revoked" && e.from === "server" && E([[e.topic, "revoked"]]), d("info", `${e.topic} ← ${e.type}`, {
+			event: "received",
+			message: e
+		}), m.get(e.topic)?.forEach((t) => t(e));
 	}, k = (e, t) => {
-		let n = new AbortController(), a, s = {
-			topics: e,
+		e.me = t.connection, y = /* @__PURE__ */ new Map(), E(t.refused.map((e) => [e.topic, e.reason])), S = 0, T("open");
+	}, A = (e) => {
+		if (v !== e) return;
+		T("connecting");
+		let t = n[Math.min(S, n.length - 1)];
+		S += 1, x = setTimeout(N, t);
+	}, j = (t, n) => {
+		let r = new AbortController(), o, c = {
+			topics: t,
 			transport: "sse",
-			close: () => n.abort(),
-			publish: async (e, t, n) => {
-				if (!a) return !1;
-				let r = await d(l, {
+			close: () => r.abort(),
+			publish: async (t, n, r) => {
+				if (!o) return !1;
+				let i = await f(e, {
 					method: "POST",
 					headers: { "content-type": "application/json" },
 					credentials: "same-origin",
 					body: JSON.stringify({
-						token: a,
-						topic: e,
-						type: t,
-						data: n
+						token: o,
+						topic: t,
+						type: n,
+						data: r
 					})
 				}).catch(() => void 0);
-				return r?.status === 401 && _ === s && j(), r?.ok ?? !1;
+				return i?.status === 401 && v === c && N(), i?.ok ?? !1;
 			}
-		}, c = async (e) => {
+		}, l = async (e) => {
 			let t = e.body?.getReader();
 			if (!t) return;
-			let n = new TextDecoder(), c = "";
+			let n = new TextDecoder(), r = "";
 			for (;;) {
 				let { done: e, value: l } = await t.read();
 				if (e) return;
-				c += n.decode(l, { stream: !0 });
-				let u = c.indexOf("\n\n");
+				r += n.decode(l, { stream: !0 });
+				let u = r.indexOf("\n\n");
 				for (; u !== -1;) {
-					let e = o(c.slice(0, u));
-					c = c.slice(u + 2), u = c.indexOf("\n\n"), e?.event === "ready" && r(e.data) ? (a = e.data.token, D(s, e.data)) : e?.event === "message" && i(e.data) && E(e.data);
+					let e = s(r.slice(0, u));
+					r = r.slice(u + 2), u = r.indexOf("\n\n"), e?.event === "ready" && i(e.data) ? (o = e.data.token, k(c, e.data)) : e?.event === "message" && a(e.data) && O(e.data);
 				}
 			}
 		};
-		return d(`${l}?${t}`, {
+		return f(`${e}?${n}`, {
 			headers: { accept: "text/event-stream" },
 			credentials: "same-origin",
-			signal: n.signal
-		}).then(async (t) => {
-			if (!t.ok) {
-				v = new Map(e.split(",").map((e) => [e, `http_${t.status}`])), C("closed");
+			signal: r.signal
+		}).then(async (e) => {
+			if (!e.ok) {
+				y = /* @__PURE__ */ new Map(), E(t.split(",").map((t) => [t, `http_${String(e.status)}`])), T("closed");
 				return;
 			}
-			throw await c(t), Error("The realtime stream ended");
+			throw await l(e), Error("The realtime stream ended");
 		}).catch(() => {
-			n.signal.aborted || O(s);
-		}), s;
-	}, A = (e, t) => {
-		let o = new f(c(l, t)), u = /* @__PURE__ */ new Map(), d = 0, p = !1, m = !1, h = () => {
+			r.signal.aborted || A(c);
+		}), c;
+	}, M = (t, n) => {
+		let s = new p(l(e, n)), u = /* @__PURE__ */ new Map(), d = 0, f = !1, m = !1, h = () => {
 			u.forEach((e) => e(!1)), u.clear();
 		}, g = {
-			topics: e,
+			topics: t,
 			transport: "websocket",
 			close: () => {
-				m = !0, h(), o.close();
+				m = !0, h(), s.close();
 			},
-			publish: (e, t, r) => new Promise((i) => {
-				if (o.readyState !== o.OPEN) {
+			publish: (e, t, n) => new Promise((i) => {
+				if (s.readyState !== s.OPEN) {
 					i(!1);
 					return;
 				}
 				d += 1;
-				let a = d, s = setTimeout(() => {
+				let a = d, o = setTimeout(() => {
 					u.delete(a), i(!1);
-				}, n);
+				}, r);
 				u.set(a, (e) => {
-					clearTimeout(s), i(e);
-				}), o.send(JSON.stringify({
+					clearTimeout(o), i(e);
+				}), s.send(JSON.stringify({
 					id: a,
 					topic: e,
 					type: t,
-					data: r
+					data: n
 				}));
 			})
 		};
-		return o.onmessage = (e) => {
-			let t = s(e.data);
-			t?.event === "ready" && r(t.data) ? (p = !0, D(g, t.data)) : t?.event === "message" && i(t.data) ? E(t.data) : t?.event === "ack" && a(t.data) && (u.get(t.data.id)?.(t.data.ok), u.delete(t.data.id));
-		}, o.onclose = () => {
-			if (h(), !(m || _ !== g)) {
-				if (!p) {
-					S = !1, j();
+		return s.onmessage = (e) => {
+			let t = c(e.data);
+			t?.event === "ready" && i(t.data) ? (f = !0, k(g, t.data)) : t?.event === "message" && a(t.data) ? O(t.data) : t?.event === "ack" && o(t.data) && (u.get(t.data.id)?.(t.data.ok), u.delete(t.data.id));
+		}, s.onclose = () => {
+			if (h(), !(m || v !== g)) {
+				if (!f) {
+					C = !1, N();
 					return;
 				}
-				O(g);
+				A(g);
 			}
 		}, g;
 	};
-	function j() {
-		_?.close(), _ = void 0;
+	function N() {
+		v?.close(), v = void 0;
 		let e = w();
 		if (!e) {
-			C("idle");
+			T("idle");
 			return;
 		}
-		C("connecting");
-		let t = T(e);
-		_ = S ? A(e, t) : k(e, t);
+		T("connecting");
+		let t = D(e);
+		v = C ? M(e, t) : j(e, t);
 	}
-	let M = (t = !1) => {
-		clearTimeout(y), clearTimeout(b), y = setTimeout(() => {
-			(t || _?.topics !== w()) && j();
-		}, e);
-	}, N = (e) => g === "open" && _?.topics.split(",").includes(e) === !0, P = (e) => N(e) ? Promise.resolve(!0) : new Promise((t) => {
-		let r = setTimeout(() => {
+	let P = (e = !1) => {
+		clearTimeout(b), clearTimeout(x), b = setTimeout(() => {
+			(e || v?.topics !== w()) && N();
+		}, t);
+	}, F = (e) => _ === "open" && v?.topics.split(",").includes(e) === !0, I = (e) => F(e) ? Promise.resolve(!0) : new Promise((t) => {
+		let n = setTimeout(() => {
 			i(), t(!1);
-		}, n), i = F.onStatus((n) => {
-			(n === "closed" || N(e)) && (clearTimeout(r), i(), t(n !== "closed"));
+		}, r), i = L.onStatus((r) => {
+			(r === "closed" || F(e)) && (clearTimeout(n), i(), t(r !== "closed"));
 		});
-	}), F = {
+	}), L = {
 		subscribe: (e, t) => {
-			let n = p.get(e) ?? /* @__PURE__ */ new Set();
-			return n.add(t), p.set(e, n), M(), () => {
-				n.delete(t), n.size || (p.delete(e), m.delete(e), M());
+			let n = m.get(e) ?? /* @__PURE__ */ new Set();
+			return n.add(t), m.set(e, n), P(), () => {
+				n.delete(t), n.size || (m.delete(e), h.delete(e), P());
 			};
 		},
 		grant: (e, t) => {
-			if (m.get(e) === t) return;
-			t ? m.set(e, t) : m.delete(e);
-			let n = N(e) && !v.has(e);
-			t && p.has(e) && !n && M(!0);
+			if (h.get(e) === t) return;
+			t ? h.set(e, t) : h.delete(e);
+			let n = F(e) && !y.has(e);
+			t && m.has(e) && !n && P(!0);
+		},
+		publish: async (e, t, n) => {
+			let r = await I(e) && v ? await v.publish(e, t, n) : !1;
+			return d(r ? "info" : "danger", `${e} → ${t}${r ? "" : " (not delivered)"}`, {
+				event: "published",
+				topic: e,
+				type: t,
+				data: n,
+				delivered: r
+			}), r;
 		},
-		publish: async (e, t, n) => !await P(e) || !_ ? !1 : _.publish(e, t, n),
-		onStatus: (e) => (h.add(e), () => h.delete(e)),
+		onStatus: (e) => (g.add(e), () => g.delete(e)),
 		get status() {
-			return g;
+			return _;
 		},
 		get me() {
-			return _?.me;
+			return v?.me;
 		},
 		get transport() {
-			return _?.transport ?? (S ? "websocket" : "sse");
+			return v?.transport ?? (C ? "websocket" : "sse");
 		},
-		refusal: (e) => v.get(e)
+		refusal: (e) => y.get(e)
 	};
-	return F;
-}, u = /* @__PURE__ */ new Map(), d = (e, t = "sse") => {
-	let n = `${t} ${e}`, r = u.get(n);
+	return L;
+}, d = (t, n, r) => {
+	t === "success" ? e.success("realtime", n, r) : t === "warning" ? e.warning("realtime", n, r) : t === "danger" ? e.danger("realtime", n, r) : e.info("realtime", n, r);
+}, f = /* @__PURE__ */ new Map(), p = (e, t = "sse") => {
+	let n = `${t} ${e}`, r = f.get(n);
 	if (r) return r;
-	let i = l(e, { transport: t });
-	return u.set(n, i), i;
+	let i = u(e, { transport: t });
+	return f.set(n, i), i;
 };
 //#endregion
-export { l as createRealtimeClient, d as realtimeClientFor };
+export { u as createRealtimeClient, p as realtimeClientFor };

package/dist/realtime/topics.mjs

@@ -1,25 +1,26 @@
+import { isRecord as e } from "../helpers/isRecord.mjs";
 //#region src/realtime/topics.ts
-var e = /^[A-Za-z0-9:_.-]{1,128}$/, t = (t) => e.test(t), n = (e) => RegExp(`^${e.split(/(\{[A-Za-z0-9_]+\})/).map((e) => /^\{[A-Za-z0-9_]+\}$/.test(e) ? "[A-Za-z0-9_.-]{1,64}" : e.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("")}$`), r = (e, r) => {
-	if (!r || !t(e)) return;
-	let i = Object.keys(r).find((t) => n(t).test(e));
-	return i === void 0 ? void 0 : {
-		pattern: i,
-		declaration: r[i]
+var t = /^[A-Za-z0-9:_.-]{1,128}$/, n = "[A-Za-z0-9_.-]{1,64}", r = (e) => t.test(e), i = (e) => RegExp(`^${e.split(/(\{[A-Za-z0-9_]+\})/).map((e) => /^\{[A-Za-z0-9_]+\}$/.test(e) ? n : e.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("")}$`), a = (e, t) => {
+	if (!t || !r(e)) return;
+	let n = Object.keys(t).find((t) => i(t).test(e));
+	return n === void 0 ? void 0 : {
+		pattern: n,
+		declaration: t[n]
 	};
-}, i = /^(?=.)[A-Za-z0-9:_.-]*(\{[A-Za-z0-9_]+\}[A-Za-z0-9:_.-]*)*$/, a = /* @__PURE__ */ new Set([
+}, o = /^(?=.)[A-Za-z0-9:_.-]*(\{[A-Za-z0-9_]+\}[A-Za-z0-9:_.-]*)*$/, s = /* @__PURE__ */ new Set([
 	"public",
 	"session",
 	"role"
-]), o = (e) => typeof e == "object" && !!e && !Array.isArray(e), s = (e, t) => {
-	let n = [];
-	if (i.test(e) || n.push("a pattern is letters, digits and `:_.-`, with `{name}` for the part a page fills in — `board:{id}`"), !o(t)) return [...n, "a channel is an object: `{ access: { mode: \"public\" } }`"];
-	let { access: r, publish: s, presence: c, grant: l, maxMessageBytes: u, messagesPerSecond: d } = t, f = o(r) ? r.mode : void 0;
-	typeof f != "string" || !a.has(f) ? n.push("`access` is { mode: \"public\" }, { mode: \"session\" } or { mode: \"role\", permissions: […] }") : f === "role" && !(o(r) && Array.isArray(r.permissions) && r.permissions.every((e) => typeof e == "string")) && n.push("`access: { mode: \"role\" }` names the permissions it needs: `permissions: [\"boardEdit\"]`"), s !== void 0 && s !== "clients" && s !== "server" && n.push("`publish` is \"clients\" (pages send) or \"server\" (only a flow's realtime.publish)"), c !== void 0 && typeof c != "boolean" && n.push("`presence` is true or false"), l !== void 0 && typeof l != "boolean" && n.push("`grant` is true (a page needs a grant from `realtime.grant` to open a topic) or false");
-	for (let [e, t] of [["maxMessageBytes", u], ["messagesPerSecond", d]]) t !== void 0 && (typeof t != "number" || !Number.isInteger(t) || t <= 0) && n.push(`\`${e}\` is a whole number above zero`);
-	return n;
-}, c = (e) => ({
+]), c = (t, n) => {
+	let r = [];
+	if (o.test(t) || r.push("a pattern is letters, digits and `:_.-`, with `{name}` for the part a page fills in — `board:{id}`"), !e(n)) return [...r, "a channel is an object: `{ access: { mode: \"public\" } }`"];
+	let { access: i, publish: a, presence: c, grant: l, maxMessageBytes: u, messagesPerSecond: d } = n, f = e(i) ? i.mode : void 0;
+	typeof f != "string" || !s.has(f) ? r.push("`access` is { mode: \"public\" }, { mode: \"session\" } or { mode: \"role\", permissions: […] }") : f === "role" && !(e(i) && Array.isArray(i.permissions) && i.permissions.every((e) => typeof e == "string")) && r.push("`access: { mode: \"role\" }` names the permissions it needs: `permissions: [\"boardEdit\"]`"), a !== void 0 && a !== "clients" && a !== "server" && r.push("`publish` is \"clients\" (pages send) or \"server\" (only a flow's realtime.publish)"), c !== void 0 && typeof c != "boolean" && r.push("`presence` is true or false"), l !== void 0 && typeof l != "boolean" && r.push("`grant` is true (a page needs a grant from `realtime.grant` to open a topic) or false");
+	for (let [e, t] of [["maxMessageBytes", u], ["messagesPerSecond", d]]) t !== void 0 && (typeof t != "number" || !Number.isInteger(t) || t <= 0) && r.push(`\`${e}\` is a whole number above zero`);
+	return r;
+}, l = (e) => ({
 	maxMessageBytes: e.maxMessageBytes ?? 4096,
 	messagesPerSecond: e.messagesPerSecond ?? 30
-}), l = "$presence", u = "$leave", d = "$join", f = "$revoked";
+}), u = "$presence", d = "$leave", f = "$join", p = "$revoked";
 //#endregion
-export { d as JOIN_TYPE, u as LEAVE_TYPE, l as PRESENCE_TYPE, f as REVOKED_TYPE, c as channelLimits, s as channelProblems, t as isValidTopic, r as matchChannel };
+export { f as JOIN_TYPE, d as LEAVE_TYPE, u as PRESENCE_TYPE, p as REVOKED_TYPE, l as channelLimits, c as channelProblems, r as isValidTopic, a as matchChannel };

package/dist/schema/anchor.d.ts

@@ -0,0 +1,8 @@
+/**
+ * What an element's `anchor` may be: the `id` it carries in the DOM, so `/page#anchor` lands on it.
+ *
+ * Lowercase, starting with a letter, then letters, digits and hyphens — a fragment a person types in a URL, with no
+ * escaping and no case to get wrong. The one rule the authoring package, the builder and the MCP all hold it to.
+ */
+export declare const ANCHOR_PATTERN: RegExp;
+export declare const isAnchor: (value: unknown) => value is string;

package/dist/schema/anchor.mjs

@@ -0,0 +1,4 @@
+//#region src/schema/anchor.ts
+var e = /^[a-z][a-z0-9-]*$/, t = (t) => typeof t == "string" && e.test(t);
+//#endregion
+export { e as ANCHOR_PATTERN, t as isAnchor };

package/dist/schema/index.d.ts

@@ -1,6 +1,8 @@
 import { default as SchemaContext } from './SchemaContext';
+export * from './anchor';
 export * from './schemaConstants';
 export * from './SchemaContext';
 export * from './layoutChain';
 export * from './serverElements';
+export * from './snippet';
 export { SchemaContext };

package/dist/schema/index.mjs

@@ -1,5 +1,7 @@
 import e from "./SchemaContext.mjs";
-import { COMPONENT_PROPS_SOURCE as t, EMPTY_SCHEMA as n, VARIABLE_REGEX as r } from "./schemaConstants.mjs";
-import { findLayoutCycle as i, resolveLayoutChain as a } from "./layoutChain.mjs";
-import { collectServerElements as o, hasServerElements as s } from "./serverElements.mjs";
-export { t as COMPONENT_PROPS_SOURCE, n as EMPTY_SCHEMA, e as SchemaContext, r as VARIABLE_REGEX, o as collectServerElements, i as findLayoutCycle, s as hasServerElements, a as resolveLayoutChain };
+import { ANCHOR_PATTERN as t, isAnchor as n } from "./anchor.mjs";
+import { COMPONENT_PROPS_SOURCE as r, EMPTY_SCHEMA as i, VARIABLE_REGEX as a } from "./schemaConstants.mjs";
+import { findLayoutCycle as o, resolveLayoutChain as s } from "./layoutChain.mjs";
+import { collectServerElements as c, hasServerElements as l } from "./serverElements.mjs";
+import { isSnippet as u } from "./snippet.mjs";
+export { t as ANCHOR_PATTERN, r as COMPONENT_PROPS_SOURCE, i as EMPTY_SCHEMA, e as SchemaContext, a as VARIABLE_REGEX, c as collectServerElements, o as findLayoutCycle, l as hasServerElements, n as isAnchor, u as isSnippet, s as resolveLayoutChain };

package/dist/schema/serverElements.d.ts

@@ -16,6 +16,10 @@ import { Element, Schema } from '../types';
  * a provider in the dashboard's sidebar was never resolved: the payload came back empty, the element rendered with
  * nothing, and no layer reported it.
  */
-export declare const collectServerElements: (schema: Schema, pageId: string | undefined, ids?: string[]) => Element[];
+/**
+ * Given the flags as they resolved, an element gated off by one is skipped with its whole subtree — it will not be
+ * rendered, so nothing in it wants data, and resolving it would put a feature that is off into the payload anyway.
+ */
+export declare const collectServerElements: (schema: Schema, pageId: string | undefined, ids?: string[], flags?: Record<string, boolean>) => Element[];
 /** Whether anything on this page consumes server data at all — the question both RSC gates actually ask. */
-export declare const hasServerElements: (schema: Schema, pageId: string | undefined) => boolean;
+export declare const hasServerElements: (schema: Schema, pageId: string | undefined, flags?: Record<string, boolean>) => boolean;

package/dist/schema/serverElements.mjs

@@ -1,19 +1,20 @@
-import { resolveLayoutChain as e } from "./layoutChain.mjs";
+import { passesFlagGate as e } from "../flags/resolveFlags.mjs";
+import { resolveLayoutChain as t } from "./layoutChain.mjs";
 //#region src/schema/serverElements.ts
-var t = (t, n, r) => {
-	if (n === void 0) return [];
-	let i = r ? new Set(r) : void 0, a = [], o = /* @__PURE__ */ new Set(), s = t.flat[n], c = (e) => typeof e == "string" ? e : "", l = [n, ...s ? e((e) => t.flat[e], c(s.attributes.layout), c(s.attributes.layoutContainer)).map((e) => e.layout) : []];
-	for (; l.length > 0;) {
-		let e = l.pop();
-		if (e === void 0 || o.has(e)) continue;
-		o.add(e);
-		let n = t.flat[e];
-		if (!n) continue;
-		n.definition.runtime === "server" && (!i || i.has(n.id)) && a.push(n);
-		let { items: r } = n.definition;
-		r && l.push(...r);
+var n = (n, r, i, a) => {
+	if (r === void 0) return [];
+	let o = i ? new Set(i) : void 0, s = [], c = /* @__PURE__ */ new Set(), l = n.flat[r], u = (e) => typeof e == "string" ? e : "", d = [r, ...l ? t((e) => n.flat[e], u(l.attributes.layout), u(l.attributes.layoutContainer)).map((e) => e.layout) : []];
+	for (; d.length > 0;) {
+		let t = d.pop();
+		if (t === void 0 || c.has(t)) continue;
+		c.add(t);
+		let r = n.flat[t];
+		if (!r || a && !e(r.definition.flag, a)) continue;
+		r.definition.runtime === "server" && (!o || o.has(r.id)) && s.push(r);
+		let { items: i } = r.definition;
+		i && d.push(...i);
 	}
-	return a;
-}, n = (e, n) => t(e, n).length > 0;
+	return s;
+}, r = (e, t, r) => n(e, t, void 0, r).length > 0;
 //#endregion
-export { t as collectServerElements, n as hasServerElements };
+export { n as collectServerElements, r as hasServerElements };

package/dist/schema/snippet.d.ts

@@ -0,0 +1,7 @@
+import { Snippet } from '../types';
+/**
+ * Whether a document read from somewhere — an upload, a file on a CDN — is a snippet a builder can show and drop: a
+ * name, a base element that is in its elements, and a style to dress them. Its shape only; whether what it holds is
+ * sound is `validateSnippet`'s to say (`@plitzi/sdk-authoring`).
+ */
+export declare const isSnippet: (value: unknown) => value is Snippet;

package/dist/schema/snippet.mjs

@@ -0,0 +1,9 @@
+import { isRecord as e } from "../helpers/isRecord.mjs";
+//#region src/schema/snippet.ts
+var t = (t) => {
+	if (!e(t) || !e(t.definition) || !e(t.schema) || !e(t.style)) return !1;
+	let { definition: n, schema: r, style: i } = t;
+	return typeof n.name != "string" || typeof n.baseElementId != "string" ? !1 : e(r.flat) && e(r.flat[n.baseElementId]) && Array.isArray(r.variables) && e(i.platform);
+};
+//#endregion
+export { t as isSnippet };

package/dist/schema/wire.d.ts

@@ -0,0 +1,11 @@
+import { Element, Schema, SchemaRaw, WireElement } from '../types';
+/** A schema as the channel carries it: `flat` as a list. What every publisher of a whole schema sends. */
+export declare const schemaToWire: (schema: Schema) => SchemaRaw;
+/** An element as the store holds it: what the wire sent `null` for is absent, as it is in the document. */
+export declare const elementFromWire: ({ definition, ...element }: WireElement) => Element;
+/**
+ * A schema off the wire — the live channel or a GraphQL answer — keyed again by element id: what a receiver stores.
+ * The one way in for both, so an element whose missing gate arrived as `null` never reaches code that reads absent as
+ * `undefined`.
+ */
+export declare const schemaFromWire: (raw: SchemaRaw) => Schema;

package/dist/schema/wire.mjs

@@ -0,0 +1,27 @@
+//#region src/schema/wire.ts
+var e = (e) => ({
+	...e,
+	flat: Object.values(e.flat)
+}), t = ({ definition: e, ...t }) => {
+	let { parentId: n, items: r, bindings: i, interactions: a, initialState: o, runtime: s, loadStrategy: c, flag: l, anchor: u, ...d } = e;
+	return {
+		...t,
+		definition: {
+			...d,
+			...n == null ? {} : { parentId: n },
+			...r == null ? {} : { items: r },
+			...i == null ? {} : { bindings: i },
+			...a == null ? {} : { interactions: a },
+			...o == null ? {} : { initialState: o },
+			...s == null ? {} : { runtime: s },
+			...c == null ? {} : { loadStrategy: c },
+			...l == null ? {} : { flag: l },
+			...u == null ? {} : { anchor: u }
+		}
+	};
+}, n = (e) => ({
+	...e,
+	flat: Object.fromEntries(e.flat.map((e) => [e.id, t(e)]))
+});
+//#endregion
+export { t as elementFromWire, n as schemaFromWire, e as schemaToWire };

package/dist/server/actions/useImagesSync.d.ts

@@ -0,0 +1,9 @@
+import { ServerSSR } from '../../types';
+/**
+ * Seeds where this origin resizes remote pictures, once, at the SDK root — as `useRealtimeSync` does for channels.
+ *
+ * Only a server that mounts the endpoint publishes the path, so a render without one (the builder, an embed, a client
+ * project) keeps every image on its own `src` rather than pointing it at a 404.
+ */
+declare const useImagesSync: (ssr?: ServerSSR) => void;
+export default useImagesSync;

package/dist/server/actions/useImagesSync.mjs

@@ -0,0 +1,7 @@
+import { useCommonStoreSync as e } from "../../store/index.mjs";
+//#region src/server/actions/useImagesSync.ts
+var t = (t) => {
+	e(["images.endpoint"], [t?.imagePath]);
+};
+//#endregion
+export { t as default };

package/dist/server/rsc/refreshRsc.mjs

@@ -1,6 +1,6 @@
 import { authFailureFromResponse as e, reportAuthFailure as t } from "../../auth/failureChannel.mjs";
-import { hasServerElements as n } from "../../schema/serverElements.mjs";
-import { recordRenderActionRuns as r } from "../../store/actionRuns/actionRunsRecorder.mjs";
+import { recordRenderActionRuns as n } from "../../store/actionRuns/actionRunsRecorder.mjs";
+import { hasServerElements as r } from "../../schema/serverElements.mjs";
 import { getPaths as i, matchRoutePath as a } from "../../navigation/routes.mjs";
 //#region src/server/rsc/refreshRsc.ts
 var o = (e, t, n) => {
@@ -10,11 +10,11 @@ var o = (e, t, n) => {
 }, s = (e) => `rsc.data.${e}`, c = () => typeof window > "u" ? "" : `${window.location.pathname}${window.location.search}`, l = async (i, a, u, d, f = !1) => {
 	let { enabled: p, endpoint: m } = i.get("rsc") ?? {};
 	if (!p || !m || typeof window > "u") return;
-	let h = d ?? c(), g = i.get("schema"), _ = i.get("runtime.sources.auth"), v = d ? o(g, d, !!_?.details) : i.get("navigation.currentPageId");
-	if (g && n(g, v)) try {
-		let n = new URLSearchParams({ location: h });
-		a?.length && n.set("ids", a.join(",")), Object.entries(u ?? {}).forEach(([e, t]) => n.set(e, t));
-		let o = await fetch(`${m}?${n.toString()}`, { headers: { Accept: "application/json" } });
+	let h = d ?? c(), g = i.get("schema"), _ = i.get("runtime.sources.auth"), v = d ? o(g, d, !!_?.details) : i.get("navigation.currentPageId"), y = d ? void 0 : i.get("runtime.sources.flags");
+	if (g && r(g, v, y)) try {
+		let r = new URLSearchParams({ location: h });
+		a?.length && r.set("ids", a.join(",")), Object.entries(u ?? {}).forEach(([e, t]) => r.set(e, t));
+		let o = await fetch(`${m}?${r.toString()}`, { headers: { Accept: "application/json" } });
 		if (!o.ok) {
 			let n = e(o.status, await o.json().catch(() => void 0));
 			if (n && await t({
@@ -25,7 +25,7 @@ var o = (e, t, n) => {
 			return;
 		}
 		let { serverData: c, actionRuns: p } = await o.json();
-		p?.length && r(p), i.batch(() => {
+		p?.length && n(p), i.batch(() => {
 			a?.length ? Object.entries(c ?? {}).forEach(([e, t]) => i.set(s(e), t)) : i.set("rsc.data", c ?? {}), i.set("rsc.loaded", !0), i.set("rsc.stale", !1), i.set("rsc.location", h);
 		});
 	} catch {