@plitzi/sdk-shared 0.33.1 → 0.34.0

package/dist/devTools/debugCookie.mjs

@@ -0,0 +1,7 @@
+//#region src/devTools/debugCookie.ts
+var e = (e) => {
+	let t = e?.split(":")[1];
+	return t ? `plitzi_debug_${t}` : "plitzi_debug";
+};
+//#endregion
+export { e as debugCookieName, e as default };

package/dist/devTools/index.d.ts

@@ -1,5 +1,9 @@
+import { default as debugCookieName } from './debugCookie';
 import { default as DevToolsContext } from './DevToolsContext';
+import { default as isInteractionFlow } from './interactionLog';
 import { default as PlitziConsole } from './utils/PlitziConsole';
-export * from './utils/PlitziConsole';
+export * from './debugCookie';
 export * from './DevToolsContext';
-export { PlitziConsole, DevToolsContext };
+export * from './interactionLog';
+export * from './utils/PlitziConsole';
+export { PlitziConsole, DevToolsContext, debugCookieName, isInteractionFlow };

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;