@plitzi/sdk-shared 0.33.2 → 0.34.0

package/dist/devTools/index.mjs

@@ -1,3 +1,5 @@
 import e from "./DevToolsContext.mjs";
-import t, { createStoreDevToolsLogger as n, pConsole as r } from "./utils/PlitziConsole.mjs";
-export { e as DevToolsContext, t as PlitziConsole, n as createStoreDevToolsLogger, r as pConsole };
+import { debugCookieName as t } from "./debugCookie.mjs";
+import n from "./interactionLog.mjs";
+import r, { createStoreDevToolsLogger as i, pConsole as a } from "./utils/PlitziConsole.mjs";
+export { e as DevToolsContext, r as PlitziConsole, i as createStoreDevToolsLogger, t as debugCookieName, n as isInteractionFlow, a as pConsole };

package/dist/devTools/interactionLog.d.ts

@@ -0,0 +1,14 @@
+import { InteractionFlowParams, LogInteraction } from '../types/DevToolsTypes';
+/**
+ * Is this entry a flow that finished, as opposed to a note about one of its steps?
+ *
+ * `nodes` is the discriminant because it is the thing the flow view is made of, and a note — written from inside
+ * the traversal, while the flow is still running — can never have one. It is read through `Partial` because a log
+ * written by an older build can carry `nodes: undefined` rather than omitting the key: the declared type says
+ * that cannot happen, and the crash this guard exists to prevent says it can.
+ *
+ * Lives here rather than beside the type because `types/` holds types and nothing else: a value exported from
+ * that barrel turns every consumer's type-only import into a runtime one.
+ */
+export declare const isInteractionFlow: (params: LogInteraction["params"]) => params is InteractionFlowParams;
+export default isInteractionFlow;

package/dist/devTools/interactionLog.mjs

@@ -0,0 +1,4 @@
+//#region src/devTools/interactionLog.ts
+var e = (e) => e.nodes !== void 0;
+//#endregion
+export { e as default, e as isInteractionFlow };

package/dist/helpers/index.d.ts

@@ -4,6 +4,8 @@ import { default as syntaxHighlight } from './syntaxHighlight';
 export * from './fetchManifest';
 export * from './formatDate';
 export * from './generateFacade';
+export * from './reducerOrigin';
+export * from './ruleEvaluator';
 export * from './syntaxHighlight';
 export * from './twigWrapper';
 export * from './utils';

package/dist/helpers/index.mjs

@@ -1,11 +1,13 @@
-import e from "./fetchManifest.mjs";
-import t from "./generateFacade.mjs";
-import n from "./syntaxHighlight.mjs";
-import { formatDate as r, formatDateUTC as i, formatFromNow as a, formatUTCToLocal as o, getDurationMs as s, isDate as c, isValidFormat as l, parseDate as u, toUnixSeconds as d } from "./formatDate.mjs";
-import { filters as f } from "./twigWrapper/filters/filters.mjs";
-import { processTwig as p } from "./twigWrapper/processTwig/processTwig.mjs";
-import { hasValidToken as m } from "./twigWrapper/tokens/hasValidToken.mjs";
-import { ParamsFromURL as h, delay as g, emptyObject as _, generateID as v, getDisplayName as y, getKeyDecoded as b, getPathsFromObeject as x, hexToRGB as S, isInViewport as C, isTestMode as w, makeId as T } from "./utils.mjs";
+import { filters as e } from "./twigWrapper/filters/filters.mjs";
+import { processTwig as t } from "./twigWrapper/processTwig/processTwig.mjs";
+import { hasValidToken as n } from "./twigWrapper/tokens/hasValidToken.mjs";
+import r from "./fetchManifest.mjs";
+import i from "./generateFacade.mjs";
+import a from "./syntaxHighlight.mjs";
+import { formatDate as o, formatDateUTC as s, formatFromNow as c, formatUTCToLocal as l, getDurationMs as u, isDate as d, isValidFormat as f, parseDate as p, toUnixSeconds as m } from "./formatDate.mjs";
+import { isUserEdit as h } from "./reducerOrigin.mjs";
+import { evaluateRuleGroup as g } from "./ruleEvaluator.mjs";
+import { ParamsFromURL as _, delay as v, emptyObject as y, getDisplayName as b, getKeyDecoded as x, getPathsFromObeject as S, hexToRGB as C, isInViewport as w, makeId as T } from "./utils.mjs";
 import { disableReactDevTools as E } from "./security.mjs";
 import { createStripTypenameLink as D, stripTypenameDeep as O } from "./stripTypename.mjs";
-export { h as ParamsFromURL, D as createStripTypenameLink, g as delay, E as disableReactDevTools, _ as emptyObject, e as fetchManifest, f as filters, r as formatDate, i as formatDateUTC, a as formatFromNow, o as formatUTCToLocal, t as generateFacade, v as generateID, y as getDisplayName, s as getDurationMs, b as getKeyDecoded, x as getPathsFromObeject, m as hasValidToken, S as hexToRGB, c as isDate, C as isInViewport, w as isTestMode, l as isValidFormat, T as makeId, u as parseDate, p as processTwig, O as stripTypenameDeep, n as syntaxHighlight, d as toUnixSeconds };
+export { _ as ParamsFromURL, D as createStripTypenameLink, v as delay, E as disableReactDevTools, y as emptyObject, g as evaluateRuleGroup, r as fetchManifest, e as filters, o as formatDate, s as formatDateUTC, c as formatFromNow, l as formatUTCToLocal, i as generateFacade, b as getDisplayName, u as getDurationMs, x as getKeyDecoded, S as getPathsFromObeject, n as hasValidToken, C as hexToRGB, d as isDate, w as isInViewport, h as isUserEdit, f as isValidFormat, T as makeId, p as parseDate, t as processTwig, O as stripTypenameDeep, a as syntaxHighlight, m as toUnixSeconds };

package/dist/helpers/reducerOrigin.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Whether a reducer action is this session's user editing — the only kind of change the undo history and the save
+ * queue are for.
+ *
+ * Two kinds of dispatch look like an edit and are not. `fromSubscriptions` is another session's edit arriving over
+ * the space stream: an agent writing through the MCP, or a collaborator. `queryFailed` is the save queue putting
+ * back the state a rejected mutation left behind. Recording either as undoable hands the user a button that reverts
+ * work this session never did — an agent's whole apply, in one click — and re-queueing either sends the server a
+ * change it just gave us, or just refused.
+ */
+export type ReducerActionOrigin = {
+    fromSubscriptions?: boolean;
+    queryFailed?: boolean;
+};
+export declare const isUserEdit: (action: ReducerActionOrigin) => boolean;

package/dist/helpers/reducerOrigin.mjs

@@ -0,0 +1,4 @@
+//#region src/helpers/reducerOrigin.ts
+var e = (e) => !e.fromSubscriptions && !e.queryFailed;
+//#endregion
+export { e as isUserEdit };

package/dist/helpers/ruleEvaluator.d.ts

@@ -0,0 +1,14 @@
+import { RuleGroup, RuleValue } from '@plitzi/plitzi-ui/QueryBuilder';
+/**
+ * Evaluates a `when` rule group against a value bag.
+ *
+ * A rule group has to be evaluated on both sides — the browser for an interaction, the server for an action — and
+ * the only implementation lives in `plitzi-ui`. This wrapper exists for two reasons beyond naming:
+ *
+ * - the `@plitzi/plitzi-ui/QueryBuilder` BARREL pulls the React components with it, which is the boot weight the
+ *   MCP already paid for once. `/QueryBuilder/helpers` carries the evaluator and nothing that renders;
+ * - it keeps `plitzi-ui` out of the server's dependency list. `sdk-shared` already depends on it, so the chain is
+ *   declared in exactly one place.
+ */
+export declare const evaluateRuleGroup: (group: RuleGroup, values: Record<string, RuleValue>) => boolean;
+export type { Rule, RuleGroup, RuleValue } from '@plitzi/plitzi-ui/QueryBuilder';

package/dist/helpers/ruleEvaluator.mjs

@@ -0,0 +1,5 @@
+import { QueryBuilderEvaluator as e } from "@plitzi/plitzi-ui/QueryBuilder/helpers";
+//#region src/helpers/ruleEvaluator.ts
+var t = (t, n) => !!e(t, n);
+//#endregion
+export { t as evaluateRuleGroup };

package/dist/helpers/twigWrapper/AST.d.ts

@@ -44,7 +44,7 @@ export type BreakNode = {
 export type ContinueNode = {
     readonly type: 'continue';
 };
-export type Expression = LiteralNode | ArrayLiteralNode | ObjectLiteralNode | RangeNode | PathNode | FunctionNode | FilterExpression | ConcatNode | UnaryNode | BinaryNode | DefaultNode | TernaryNode | ArrowFunctionNode;
+export type Expression = LiteralNode | ArrayLiteralNode | ObjectLiteralNode | RangeNode | PathNode | IndexNode | FunctionNode | FilterExpression | ConcatNode | UnaryNode | BinaryNode | DefaultNode | TernaryNode | ArrowFunctionNode;
 export type LiteralNode = {
     readonly type: 'literal';
     readonly value: string | number | boolean;
@@ -69,6 +69,17 @@ export type PathNode = {
     readonly type: 'path';
     readonly segments: readonly string[];
 };
+/**
+ * Member access whose key is not known until the template runs: `items[i]`, `rows[page - 1]`, `record[field]`.
+ *
+ * A bracket holding a literal never reaches here — the parser folds `items[0]` and `record['title']` straight into
+ * a {@link PathNode}'s segments, so the common case stays one flat walk with nothing to evaluate per access.
+ */
+export type IndexNode = {
+    readonly type: 'index';
+    readonly object: Expression;
+    readonly index: Expression;
+};
 export type FunctionNode = {
     readonly type: 'function';
     readonly name: string;

package/dist/helpers/twigWrapper/Evaluator/Evaluator.mjs

@@ -121,6 +121,7 @@ var c = [], l = (e, t, n = !1) => {
 			}
 			case "range": return this.evalRange(t.start, t.end);
 			case "path": return this.resolvePath(t.segments);
+			case "index": return this.resolveIndex(t.object, t.index);
 			case "function": return this.evalFunction(t.name, t.args);
 			case "filter": return this.applyFilters(this.evalExpression(t.subject), t.filters);
 			case "concat": {
@@ -156,6 +157,12 @@ var c = [], l = (e, t, n = !1) => {
 		}
 		return n;
 	}
+	resolveIndex(e, t) {
+		let n = this.evalExpression(e);
+		if (n == null) return;
+		let r = this.evalExpression(t);
+		if (r != null) return n[String(r)];
+	}
 	evalRange(e, t) {
 		let n = Number(this.evalExpression(e)), r = Number(this.evalExpression(t)), i = n <= r, a = (i ? r - n : n - r) + 1, o = Array(a);
 		for (let e = 0; e < a; e++) o[e] = i ? n + e : n - e;

package/dist/helpers/twigWrapper/Parser/Cursor.d.ts

@@ -7,6 +7,13 @@ export declare class Cursor {
     protected at(offset: number): number;
     protected skipWs(): void;
     protected scanName(): string;
+    /**
+     * Scans a path segment that is a plain array index (`0`, `12`), returning '' when not on one.
+     *
+     * Digits only, deliberately: `scanNumber` would read `0.title` as the number `0.` and leave the cursor past the
+     * dot that separates it from the next segment. A key is a key here — `items.0.title` is three of them.
+     */
+    protected scanIndex(): string;
     protected scanStringLiteral(): string;
     protected scanNumber(): number;
     protected matchKeyword(kw: string): boolean;

package/dist/helpers/twigWrapper/Parser/Cursor.mjs

@@ -24,6 +24,11 @@ var o = class {
 		if (!this.eof() && r(this.src.charCodeAt(this.pos))) for (this.pos++; !this.eof() && i(this.src.charCodeAt(this.pos));) this.pos++;
 		return this.src.slice(e, this.pos);
 	}
+	scanIndex() {
+		let e = this.pos;
+		for (; !this.eof() && t(this.src.charCodeAt(this.pos));) this.pos++;
+		return this.src.slice(e, this.pos);
+	}
 	scanStringLiteral() {
 		let t = this.src.charCodeAt(this.pos);
 		this.pos++;

package/dist/helpers/twigWrapper/Parser/ExpressionParser.mjs

@@ -207,22 +207,60 @@ var r = (e) => new a(e).parseTernary(), i = (e) => new a(e).parseApplyChain(), a
 		if (this.peek() === e.LParen) {
 			this.pos++;
 			let n = this.parseArgList(e.RParen);
-			return this.maybeTrailingFilters({
+			return this.maybeTrailingFilters(this.parseAccessChain({
 				type: "function",
 				name: t,
 				args: n
-			});
+			}, null));
 		}
 		let n = [t];
-		for (; this.peek() === e.Dot;) {
+		return this.maybeTrailingFilters(this.parseAccessChain({
+			type: "path",
+			segments: n
+		}, n));
+	}
+	parseAccessChain(t, n) {
+		let r = t, i = n;
+		for (;;) {
+			let t = this.peek();
+			if (t === e.Dot) {
+				let e = this.pos;
+				this.pos++;
+				let t = this.scanName() || this.scanIndex();
+				if (!t) {
+					this.pos = e;
+					break;
+				}
+				i ? i.push(t) : r = {
+					type: "index",
+					object: r,
+					index: {
+						type: "literal",
+						value: t
+					}
+				};
+				continue;
+			}
+			if (t !== e.LBracket) break;
 			this.pos++;
-			let e = this.scanName();
-			e && n.push(e);
+			let n = this.parseTernary();
+			if (this.skipWs(), this.peek() === e.RBracket && this.pos++, i && n.type === "literal" && typeof n.value != "boolean") {
+				i.push(String(n.value));
+				continue;
+			}
+			i &&= (r = {
+				type: "path",
+				segments: i
+			}, null), r = {
+				type: "index",
+				object: r,
+				index: n
+			};
 		}
-		return this.maybeTrailingFilters({
+		return i ? {
 			type: "path",
-			segments: n
-		});
+			segments: i
+		} : r;
 	}
 	maybeTrailingFilters(t) {
 		return this.skipWs(), this.peek() === e.Pipe ? {

package/dist/helpers/twigWrapper/charClass.d.ts

@@ -40,5 +40,12 @@ export declare const isPathPart: (c: number) => boolean;
 export declare const isDigit: (c: number) => boolean;
 export declare const isSpace: (c: number) => boolean;
 export declare const isSimpleIdentifier: (s: string) => boolean;
+/**
+ * Whether the whole string is a dotted path this file's fast path can resolve: `user.name`, `a.b.c`, `items.0.title`.
+ *
+ * A segment after the first may be a plain number — an array index is read as a literal key like any other, which is
+ * exactly what `resolveDottedPath` does. The FIRST segment may not: `1.5` is a number, and treating it as a path
+ * would resolve `context[1][5]` for a template that says one and a half.
+ */
 export declare const isDottedPath: (s: string) => boolean;
 export declare const isVariableName: (s: string) => boolean;

package/dist/helpers/twigWrapper/charClass.mjs

@@ -40,20 +40,24 @@ var e = {
 	for (let t = 1; t < r; t++) if (!n(e.charCodeAt(t))) return !1;
 	return !0;
 }, s = (r) => {
-	let i = r.length;
-	if (i === 0) return !1;
-	let a = !0;
-	for (let o = 0; o < i; o++) {
-		let i = r.charCodeAt(o);
-		if (i === e.Dot) {
-			if (a) return !1;
-			a = !0;
-		} else {
-			if (a && !t(i) || !a && !n(i)) return !1;
-			a = !1;
+	let a = r.length;
+	if (a === 0 || !t(r.charCodeAt(0))) return !1;
+	let o = !1, s = !1;
+	for (let c = 1; c < a; c++) {
+		let a = r.charCodeAt(c);
+		if (a === e.Dot) {
+			if (o) return !1;
+			o = !0, s = !1;
+			continue;
 		}
+		if (o) {
+			if (s = i(a), !s && !t(a)) return !1;
+			o = !1;
+			continue;
+		}
+		if (s ? !i(a) : !n(a)) return !1;
 	}
-	return !a;
+	return !o;
 }, c = (e) => o(e);
 //#endregion
 export { e as Char, i as isDigit, s as isDottedPath, n as isIdentPart, t as isIdentStart, r as isPathPart, o as isSimpleIdentifier, a as isSpace, c as isVariableName };

package/dist/helpers/twigWrapper/tokens/tokenPatterns.mjs

@@ -1,4 +1,4 @@
 //#region src/helpers/twigWrapper/tokens/tokenPatterns.ts
-var e = "[a-zA-Z_][a-zA-Z0-9_]*(?:-[a-zA-Z0-9_]+)*", t = `${`${e}(?:\\??\\.${e})*`}(?:\\s*\\?\\?\\s*[^|{}]+?)?(?:\\s*\\|\\s*[a-zA-Z_]+(?:\\([^)]*\\))?)*`, n = `\\{\\{\\s*${t}\\s*\\}\\}`, r = `(?:${`\\{\\{\\{\\s*${t}\\s*\\}\\}\\}`}|${n})`, i = new RegExp(r, "g"), a = RegExp(`^${r}$`);
+var e = "[a-zA-Z_][a-zA-Z0-9_]*(?:-[a-zA-Z0-9_]+)*", t = `(?:${e}|\\d+)`, n = `\\[\\s*(?:\\d+|'[^']*'|"[^"]*"|${e}(?:\\.${t})*)\\s*\\]`, r = `${`${e}(?:${n})*(?:\\??\\.${t}(?:${n})*)*`}(?:\\s*\\?\\?\\s*[^|{}]+?)?(?:\\s*\\|\\s*[a-zA-Z_]+(?:\\([^)]*\\))?)*`, i = `\\{\\{\\s*${r}\\s*\\}\\}`, a = `(?:${`\\{\\{\\{\\s*${r}\\s*\\}\\}\\}`}|${i})`, o = new RegExp(a, "g"), s = RegExp(`^${a}$`);
 //#endregion
-export { i as TOKEN_REGEX, a as TOKEN_STRICT_REGEX };
+export { o as TOKEN_REGEX, s as TOKEN_STRICT_REGEX };

package/dist/helpers/utils.d.ts

@@ -1,9 +1,7 @@
 import { FC } from 'react';
-export declare const isTestMode: () => boolean;
 export declare function getDisplayName<T = unknown>(WrappedComponent?: FC<T>): string;
 declare const emptyObject: {};
 export { emptyObject };
-export declare const generateID: (prevId?: string) => string;
 export declare const getPathsFromObeject: (object?: {
     [key: string]: unknown;
 }, basePath?: string, glue?: string, skipArray?: boolean) => string[];

package/dist/helpers/utils.mjs

@@ -1,29 +1,26 @@
 import { get as e } from "@plitzi/plitzi-ui/helpers";
 //#region src/helpers/utils.ts
-var t = () => typeof process < "u" && process.env.NODE_ENV === "test";
-function n(e) {
+function t(e) {
 	return e && (e.displayName || e.name) || "Component";
 }
-var r = {};
-Object.freeze(r);
-var i = () => ((/* @__PURE__ */ new Date()).getTime() / 1e3 | 0).toString(16) + "xxxxxxxxxxxxxxxx".replace(/[x]/g, function() {
-	return (Math.random() * 16 | 0).toString(16);
-}).toLowerCase(), a = (e = "") => t() ? e ? `id_${e.substring(e.length - 6)}` : "id_000000" : i(), o = (e, t = "", n = ".", r = !1) => !e || typeof e != "object" ? [] : Object.keys(e).reduce((i, a) => {
-	a = a.replaceAll(n, "").replaceAll(".", "");
-	let s = `${t}${t ? n : ""}${a}`;
-	return typeof e[a] != "object" || Array.isArray(e[a]) && r ? [...i, s] : [
-		...i,
+var n = {};
+Object.freeze(n);
+var r = (e, t = "", n = ".", i = !1) => !e || typeof e != "object" ? [] : Object.keys(e).reduce((a, o) => {
+	o = o.replaceAll(n, "").replaceAll(".", "");
+	let s = `${t}${t ? n : ""}${o}`;
+	return typeof e[o] != "object" || Array.isArray(e[o]) && i ? [...a, s] : [
+		...a,
 		s,
-		...o(e[a], s, n, r)
+		...r(e[o], s, n, i)
 	];
-}, []), s = (e, t = !0, n = !0) => {
+}, []), i = (e, t = !0, n = !0) => {
 	let r = "", i = "abcdefghijklmnopqrstuvwxyz";
 	t && (i = `ABCDEFGHIJKLMNOPQRSTUVWXYZ${i}`), n && (i = `${i}0123456789`);
 	let a = i.length;
 	for (let t = 0; t < e; t++) r += i.charAt(Math.floor(Math.random() * a));
 	return r;
 };
-function c(t, n) {
+function a(t, n) {
 	if (!t) return 0;
 	let r = {};
 	try {
@@ -34,7 +31,7 @@ function c(t, n) {
 	}
 	return n ? e(r, "data.spaceId", 0) : r;
 }
-function l(e) {
+function o(e) {
 	!e && typeof window < "u" && (e = window.location.search);
 	let t = {};
 	if (!e || e.length === 0) return t;
@@ -45,12 +42,12 @@ function l(e) {
 	}
 	return t;
 }
-var u = (e) => new Promise((t) => {
+var s = (e) => new Promise((t) => {
 	setTimeout(t, e);
-}), d = (e) => {
+}), c = (e) => {
 	let { top: t, left: n, bottom: r, right: i } = e.getBoundingClientRect(), { innerHeight: a, innerWidth: o } = window, { documentElement: { clientHeight: s, clientWidth: c } } = document;
 	return t >= 0 && n >= 0 && r <= (a || s) && i <= (o || c);
-}, f = (e, t) => {
+}, l = (e, t) => {
 	if (!e) return !1;
 	let n, r, i;
 	if (e.length === 7) [n, r, i] = (e.match(/\w\w/g) ?? []).map((e) => parseInt(e, 16));
@@ -59,4 +56,4 @@ var u = (e) => new Promise((t) => {
 	return t ? `rgba(${n},${r},${i},${t})` : `rgb(${n},${r},${i})`;
 };
 //#endregion
-export { l as ParamsFromURL, u as delay, r as emptyObject, a as generateID, n as getDisplayName, c as getKeyDecoded, o as getPathsFromObeject, f as hexToRGB, d as isInViewport, t as isTestMode, s as makeId };
+export { o as ParamsFromURL, s as delay, n as emptyObject, t as getDisplayName, a as getKeyDecoded, r as getPathsFromObeject, l as hexToRGB, c as isInViewport, i as makeId };

package/dist/hooks/index.d.ts

@@ -1,5 +1,6 @@
+import { default as useFontHead } from './useFontHead';
 import { default as useNetwork } from './useNetwork';
 import { default as usePlitziServiceContext } from './usePlitziServiceContext';
 export * from './useNetwork';
 export * from './usePlitziServiceContext';
-export { useNetwork, usePlitziServiceContext };
+export { useFontHead, useNetwork, usePlitziServiceContext };

package/dist/hooks/index.mjs

@@ -1,3 +1,4 @@
-import e from "./useNetwork.mjs";
-import t, { PlitziServiceContext as n, PlitziServiceProvider as r } from "./usePlitziServiceContext.mjs";
-export { n as PlitziServiceContext, r as PlitziServiceProvider, e as useNetwork, t as usePlitziServiceContext };
+import e from "./useFontHead.mjs";
+import t from "./useNetwork.mjs";
+import n, { PlitziServiceContext as r, PlitziServiceProvider as i } from "./usePlitziServiceContext.mjs";
+export { r as PlitziServiceContext, i as PlitziServiceProvider, e as useFontHead, t as useNetwork, n as usePlitziServiceContext };

package/dist/hooks/useFontHead.d.ts

@@ -0,0 +1,3 @@
+import { FontHead } from '../types/StyleTypes';
+declare const useFontHead: (head: FontHead) => void;
+export default useFontHead;

package/dist/hooks/useFontHead.mjs

@@ -0,0 +1,23 @@
+import { useEffect as e } from "react";
+//#region src/hooks/useFontHead.ts
+var t = "data-plitzi-fonts", n = (n) => {
+	e(() => {
+		if (typeof document > "u") return;
+		let { head: e } = document, r = [];
+		if (n.preconnect.forEach((t) => {
+			if (e.querySelector(`link[rel="preconnect"][href="${CSS.escape(t.href)}"]`)) return;
+			let n = document.createElement("link");
+			n.rel = "preconnect", n.href = t.href, t.crossorigin && (n.crossOrigin = ""), e.appendChild(n), r.push(n);
+		}), n.links.forEach((t) => {
+			if (e.querySelector(`link[rel="${t.rel}"][href="${CSS.escape(t.href)}"]`)) return;
+			let n = document.createElement("link");
+			n.rel = t.rel, n.href = t.href, t.as && (n.as = t.as), t.type && (n.type = t.type), t.crossorigin && (n.crossOrigin = ""), e.appendChild(n), r.push(n);
+		}), n.faces && !e.querySelector(`style[${t}]`)) {
+			let i = document.createElement("style");
+			i.setAttribute(t, ""), i.textContent = n.faces, e.appendChild(i), r.push(i);
+		}
+		return () => r.forEach((e) => e.remove());
+	}, [n]);
+};
+//#endregion
+export { n as default };

package/dist/hooks/usePlitziServiceContext.d.ts

@@ -1,6 +1,6 @@
 import { BuilderContextValue } from '../builder';
 import { NetworkContextValue } from '../network';
-import { ComponentContextValue, EventBridgeContextValue, InteractionsContextValue, PluginsContextValue, SegmentsContextValue, Theme } from '../types';
+import { ComponentContextValue, EventBridgeContextValue, InteractionsContextValue, PluginsContextValue, ColorScheme, SegmentsContextValue } from '../types';
 import { Context, ReactNode, RefObject } from 'react';
 export type PlitziServiceContextValue<TEventBridge = any, TInteractions = any> = {
     settings: {
@@ -8,7 +8,8 @@ export type PlitziServiceContextValue<TEventBridge = any, TInteractions = any> =
         previewMode?: boolean;
         environment?: string;
         [key: string]: unknown;
-        theme: Theme;
+        /** Already resolved: an element paints in one of two schemes and has no use for the word `system`. */
+        theme: ColorScheme;
     };
     root: {
         baseElementId: string;

package/dist/index.mjs

@@ -1,47 +1,63 @@
 import { authFailureFromResponse as e, onAuthFailure as t, reportAuthFailure as n, sameRegistrableDomain as r } from "./auth/failureChannel.mjs";
 import { createAuthFailureLink as i } from "./auth/authFailureLink.mjs";
-import a from "./builder/contexts/BuilderContext.mjs";
-import { contexts_exports as o } from "./builder/contexts/index.mjs";
-import { BODYLESS_METHODS as s, CONNECTOR_HTTP_METHODS as c, DEFAULT_READ_ENDPOINT as l, EMPTY_RESPONSE_METHODS as u, READ_ENDPOINT_NAMES as d, WRITE_ENDPOINT_NAMES as f } from "./connectors/constants.mjs";
-import { connectorTokens as p, getConnectorTokens as m } from "./connectors/manifestTokens.mjs";
-import { connectorPresets as h, emptyManifest as g } from "./connectors/presets.mjs";
-import { validateConnectorManifest as _ } from "./connectors/validateManifest.mjs";
-import v from "./dataSource/helpers/getSourceName.mjs";
-import y from "./helpers/fetchManifest.mjs";
-import b from "./helpers/generateFacade.mjs";
-import x from "./helpers/syntaxHighlight.mjs";
-import { formatDate as S, formatDateUTC as C, formatFromNow as w, formatUTCToLocal as T, getDurationMs as E, isDate as D, isValidFormat as O, parseDate as k, toUnixSeconds as A } from "./helpers/formatDate.mjs";
-import { filters as j } from "./helpers/twigWrapper/filters/filters.mjs";
-import { processTwig as M } from "./helpers/twigWrapper/processTwig/processTwig.mjs";
-import { hasValidToken as N } from "./helpers/twigWrapper/tokens/hasValidToken.mjs";
-import { ParamsFromURL as P, delay as F, emptyObject as I, generateID as L, getDisplayName as R, getKeyDecoded as z, getPathsFromObeject as B, hexToRGB as V, isInViewport as H, isTestMode as U, makeId as W } from "./helpers/utils.mjs";
-import { disableReactDevTools as G } from "./helpers/security.mjs";
-import { createStripTypenameLink as K, stripTypenameDeep as q } from "./helpers/stripTypename.mjs";
-import J from "./dataSource/hooks/useRegisterSource.mjs";
-import Y, { utilityOptions as X } from "./dataSource/utility/index.mjs";
-import Z from "./dataSource/getBindingsDetails.mjs";
-import Q from "./devTools/DevToolsContext.mjs";
-import $, { createStoreDevToolsLogger as ee, pConsole as te } from "./devTools/utils/PlitziConsole.mjs";
-import ne from "./elements/ComponentContext.mjs";
-import re from "./hooks/useNetwork.mjs";
-import ie, { PlitziServiceContext as ae, PlitziServiceProvider as oe } from "./hooks/usePlitziServiceContext.mjs";
-import { StyleVariableCategory as se } from "./types/StyleTypes.mjs";
-import ce, { EMPTY_STYLE_SCHEMA as le, StyleBindingsAllowed as ue, baseDefaultValue as de, inheritableAttributesBase as fe } from "./style/styleConstants.mjs";
-import pe from "./schema/SchemaContext.mjs";
-import { EMPTY_SCHEMA as me, VARIABLE_REGEX as he } from "./schema/schemaConstants.mjs";
-import ge from "./network/NetworkContext.mjs";
-import _e from "./network/NetworkInternalContext.mjs";
-import { SpaceEvents as ve, spaceEventSchemas as ye, validateSpaceEvent as be } from "./network/spaceEvents.mjs";
-import xe from "./network/graphql/builder/Mutations/index.mjs";
-import Se from "./network/graphql/builder/Queries/index.mjs";
-import Ce from "./network/graphql/builder/Subscriptions/index.mjs";
-import we from "./network/graphql/sdk/Mutations/index.mjs";
-import Te from "./network/graphql/sdk/Queries/index.mjs";
-import Ee from "./segments/SegmentsContext.mjs";
-import De, { RTEvent as Oe, RTEventCloseCode as ke, getInstance as Ae, isRTEvent as je, setInstance as Me } from "./websockets/RTCodec.mjs";
-import Ne, { ThemeContext as Pe } from "./theme/ThemeProvider.mjs";
-import Fe, { rscDataPath as Ie } from "./server/rsc/refreshRsc.mjs";
-import Le from "./server/rsc/useRscRefresh.mjs";
-import Re from "./server/rsc/useRscSync.mjs";
-import { runtimeStatePersist as ze } from "./state/runtimeStatePersist.mjs";
-export { s as BODYLESS_METHODS, a as BuilderContext, xe as BuilderMutations, Se as BuilderQueries, c as CONNECTOR_HTTP_METHODS, ne as ComponentContext, l as DEFAULT_READ_ENDPOINT, Q as DevToolsContext, u as EMPTY_RESPONSE_METHODS, me as EMPTY_SCHEMA, le as EMPTY_STYLE_SCHEMA, ge as NetworkContext, _e as NetworkInternalContext, P as ParamsFromURL, $ as PlitziConsole, ae as PlitziServiceContext, oe as PlitziServiceProvider, d as READ_ENDPOINT_NAMES, De as RTCodec, Oe as RTEvent, ke as RTEventCloseCode, pe as SchemaContext, we as SdkMutations, Te as SdkQueries, Ee as SegmentsContext, Ce as SpaceEventSubscription, ve as SpaceEvents, ue as StyleBindingsAllowed, se as StyleVariableCategory, Pe as ThemeContext, Ne as ThemeProvider, he as VARIABLE_REGEX, f as WRITE_ENDPOINT_NAMES, e as authFailureFromResponse, de as baseDefaultValue, h as connectorPresets, p as connectorTokens, o as contexts, i as createAuthFailureLink, ee as createStoreDevToolsLogger, K as createStripTypenameLink, F as delay, G as disableReactDevTools, g as emptyManifest, I as emptyObject, y as fetchManifest, j as filters, S as formatDate, C as formatDateUTC, w as formatFromNow, T as formatUTCToLocal, b as generateFacade, L as generateID, Z as getBindingsDetails, m as getConnectorTokens, R as getDisplayName, E as getDurationMs, Ae as getInstance, z as getKeyDecoded, B as getPathsFromObeject, v as getSourceName, N as hasValidToken, V as hexToRGB, fe as inheritableAttributesBase, D as isDate, H as isInViewport, je as isRTEvent, U as isTestMode, O as isValidFormat, W as makeId, t as onAuthFailure, te as pConsole, k as parseDate, M as processTwig, Fe as refreshRsc, n as reportAuthFailure, Ie as rscDataPath, ze as runtimeStatePersist, r as sameRegistrableDomain, Me as setInstance, ye as spaceEventSchemas, q as stripTypenameDeep, ce as styleConstants, x as syntaxHighlight, A as toUnixSeconds, re as useNetwork, ie as usePlitziServiceContext, J as useRegisterSource, Le as useRscRefresh, Re as useRscSync, Y as utility, X as utilityOptions, _ as validateConnectorManifest, be as validateSpaceEvent };
+import { filters as a } from "./helpers/twigWrapper/filters/filters.mjs";
+import { processTwig as o } from "./helpers/twigWrapper/processTwig/processTwig.mjs";
+import { hasValidToken as s } from "./helpers/twigWrapper/tokens/hasValidToken.mjs";
+import c from "./builder/contexts/BuilderContext.mjs";
+import { contexts_exports as l } from "./builder/contexts/index.mjs";
+import { BODYLESS_METHODS as u, CONNECTOR_HTTP_METHODS as d, DEFAULT_READ_ENDPOINT as f, EMPTY_RESPONSE_METHODS as p, READ_ENDPOINT_NAMES as m, WRITE_ENDPOINT_NAMES as h } from "./connectors/constants.mjs";
+import { connectorTokens as g, getConnectorTokens as _ } from "./connectors/manifestTokens.mjs";
+import { connectorPresets as v, emptyManifest as y } from "./connectors/presets.mjs";
+import { validateConnectorManifest as b } from "./connectors/validateManifest.mjs";
+import x from "./helpers/fetchManifest.mjs";
+import S from "./helpers/generateFacade.mjs";
+import C from "./helpers/syntaxHighlight.mjs";
+import { formatDate as w, formatDateUTC as T, formatFromNow as E, formatUTCToLocal as D, getDurationMs as O, isDate as k, isValidFormat as A, parseDate as j, toUnixSeconds as M } from "./helpers/formatDate.mjs";
+import { isUserEdit as N } from "./helpers/reducerOrigin.mjs";
+import { evaluateRuleGroup as P } from "./helpers/ruleEvaluator.mjs";
+import { ParamsFromURL as F, delay as I, emptyObject as L, getDisplayName as R, getKeyDecoded as z, getPathsFromObeject as B, hexToRGB as V, isInViewport as H, makeId as U } from "./helpers/utils.mjs";
+import { disableReactDevTools as W } from "./helpers/security.mjs";
+import { createStripTypenameLink as G, stripTypenameDeep as K } from "./helpers/stripTypename.mjs";
+import q, { utilityOptions as J } from "./dataSource/utility/index.mjs";
+import Y from "./dataSource/getBindingsDetails.mjs";
+import X from "./dataSource/helpers/getSourceName.mjs";
+import Z from "./dataSource/hooks/useRegisterSource.mjs";
+import Q from "./dataSource/resolveVariables.mjs";
+import $ from "./devTools/DevToolsContext.mjs";
+import { debugCookieName as ee } from "./devTools/debugCookie.mjs";
+import te from "./devTools/interactionLog.mjs";
+import ne, { createStoreDevToolsLogger as re, pConsole as ie } from "./devTools/utils/PlitziConsole.mjs";
+import ae from "./elements/ComponentContext.mjs";
+import oe from "./hooks/useFontHead.mjs";
+import se from "./hooks/useNetwork.mjs";
+import ce, { PlitziServiceContext as le, PlitziServiceProvider as ue } from "./hooks/usePlitziServiceContext.mjs";
+import { StyleVariableCategory as de } from "./types/StyleTypes.mjs";
+import fe, { EMPTY_STYLE_SCHEMA as pe, StyleBindingsAllowed as me, baseDefaultValue as he, inheritableAttributesBase as ge } from "./style/styleConstants.mjs";
+import { fontLinkAssets as _e } from "./style/fontAssets.mjs";
+import { SYSTEM_FONTS as ve, availableFonts as ye, familiesInCss as be, fontFamilyStack as xe, fontUrlResolver as Se, fontsToHead as Ce, googleCss2Url as we, googleTextSubsetUrl as Te, isSafeFontUrl as Ee, primaryFamily as De } from "./style/fonts.mjs";
+import { FontValidationError as Oe, parseSpaceFont as ke } from "./style/fontValidation.mjs";
+import { fallbackForFamily as Ae, fontsFromCss as je } from "./style/fontsFromCss.mjs";
+import Me from "./schema/SchemaContext.mjs";
+import { EMPTY_SCHEMA as Ne, VARIABLE_REGEX as Pe } from "./schema/schemaConstants.mjs";
+import { collectServerElements as Fe, hasServerElements as Ie } from "./schema/serverElements.mjs";
+import Le from "./network/NetworkContext.mjs";
+import Re from "./network/NetworkInternalContext.mjs";
+import { SpaceEvents as ze, spaceEventSchemas as Be, validateSpaceEvent as Ve } from "./network/spaceEvents.mjs";
+import He from "./network/graphql/builder/Mutations/index.mjs";
+import Ue from "./network/graphql/builder/Queries/index.mjs";
+import We from "./network/graphql/builder/Subscriptions/index.mjs";
+import Ge from "./network/graphql/sdk/Mutations/index.mjs";
+import Ke from "./network/graphql/sdk/Queries/index.mjs";
+import qe from "./segments/SegmentsContext.mjs";
+import Je, { RTEvent as Ye, RTEventCloseCode as Xe, getInstance as Ze, isRTEvent as Qe, setInstance as $e } from "./websockets/RTCodec.mjs";
+import { THEME_CLASSES as et, THEME_COOKIE_NAME as tt, applyThemeClass as nt, isTheme as rt, readThemeCookie as it, themeFromCookies as at, writeThemeCookie as ot } from "./theme/themeCookie.mjs";
+import st, { createThemeState as ct, createThemeStore as lt, resolveScheme as ut, setAreaTheme as dt, setMachineScheme as ft, setThemeMode as pt, themeFor as mt } from "./theme/themeStore.mjs";
+import { useThemeStore as ht } from "./theme/ThemeScope.mjs";
+import gt from "./theme/ThemeProvider.mjs";
+import _t, { SPACE_THEME_AREA as vt } from "./theme/useTheme.mjs";
+import yt from "./server/actions/useActionsSync.mjs";
+import bt, { currentRscLocation as xt, rscDataPath as St } from "./server/rsc/refreshRsc.mjs";
+import Ct from "./server/rsc/useRscRefresh.mjs";
+import wt from "./server/rsc/useRscSync.mjs";
+import { runtimeStatePersist as Tt } from "./state/runtimeStatePersist.mjs";
+export { u as BODYLESS_METHODS, c as BuilderContext, He as BuilderMutations, Ue as BuilderQueries, d as CONNECTOR_HTTP_METHODS, ae as ComponentContext, f as DEFAULT_READ_ENDPOINT, $ as DevToolsContext, p as EMPTY_RESPONSE_METHODS, Ne as EMPTY_SCHEMA, pe as EMPTY_STYLE_SCHEMA, Oe as FontValidationError, Le as NetworkContext, Re as NetworkInternalContext, F as ParamsFromURL, ne as PlitziConsole, le as PlitziServiceContext, ue as PlitziServiceProvider, m as READ_ENDPOINT_NAMES, Je as RTCodec, Ye as RTEvent, Xe as RTEventCloseCode, vt as SPACE_THEME_AREA, ve as SYSTEM_FONTS, Me as SchemaContext, Ge as SdkMutations, Ke as SdkQueries, qe as SegmentsContext, We as SpaceEventSubscription, ze as SpaceEvents, me as StyleBindingsAllowed, de as StyleVariableCategory, et as THEME_CLASSES, tt as THEME_COOKIE_NAME, gt as ThemeProvider, Pe as VARIABLE_REGEX, h as WRITE_ENDPOINT_NAMES, nt as applyThemeClass, e as authFailureFromResponse, ye as availableFonts, he as baseDefaultValue, Fe as collectServerElements, v as connectorPresets, g as connectorTokens, l as contexts, i as createAuthFailureLink, re as createStoreDevToolsLogger, G as createStripTypenameLink, ct as createThemeState, lt as createThemeStore, xt as currentRscLocation, ee as debugCookieName, I as delay, W as disableReactDevTools, y as emptyManifest, L as emptyObject, P as evaluateRuleGroup, Ae as fallbackForFamily, be as familiesInCss, x as fetchManifest, a as filters, xe as fontFamilyStack, _e as fontLinkAssets, Se as fontUrlResolver, je as fontsFromCss, Ce as fontsToHead, w as formatDate, T as formatDateUTC, E as formatFromNow, D as formatUTCToLocal, S as generateFacade, Y as getBindingsDetails, _ as getConnectorTokens, R as getDisplayName, O as getDurationMs, Ze as getInstance, z as getKeyDecoded, B as getPathsFromObeject, X as getSourceName, we as googleCss2Url, Te as googleTextSubsetUrl, Ie as hasServerElements, s as hasValidToken, V as hexToRGB, ge as inheritableAttributesBase, k as isDate, H as isInViewport, te as isInteractionFlow, Qe as isRTEvent, Ee as isSafeFontUrl, rt as isTheme, N as isUserEdit, A as isValidFormat, U as makeId, t as onAuthFailure, ie as pConsole, j as parseDate, ke as parseSpaceFont, De as primaryFamily, o as processTwig, it as readThemeCookie, bt as refreshRsc, n as reportAuthFailure, ut as resolveScheme, Q as resolveVariables, St as rscDataPath, Tt as runtimeStatePersist, r as sameRegistrableDomain, dt as setAreaTheme, $e as setInstance, ft as setMachineScheme, pt as setThemeMode, Be as spaceEventSchemas, K as stripTypenameDeep, fe as styleConstants, C as syntaxHighlight, mt as themeFor, at as themeFromCookies, st as themeStore, M as toUnixSeconds, yt as useActionsSync, oe as useFontHead, se as useNetwork, ce as usePlitziServiceContext, Z as useRegisterSource, Ct as useRscRefresh, wt as useRscSync, _t as useTheme, ht as useThemeStore, q as utility, J as utilityOptions, b as validateConnectorManifest, Ve as validateSpaceEvent, ot as writeThemeCookie };

package/dist/navigation/index.d.ts

@@ -1,4 +1,4 @@
 export { matchPath } from './matchPath';
-export { getPageFullPath, getPaths, matchRoutePath, isPageAuthored, getRouteParams } from './routes';
+export { getPageFullPath, getPaths, isAbsoluteUrl, isPageAuthored, matchRoutePath, getRouteParams } from './routes';
 export type { PathMatch, PathPattern } from './matchPath';
 export type { NavigationAccessLevel, NavigationAction, Path } from './routes';