@optiaxiom/proteus 3.0.6 → 3.2.0

package/dist/esm/assets/src/proteus-chart/{ProteusChart.css.ts.vanilla-ByPSKREp.css → ProteusChart.css.ts.vanilla-BcGBUwbD.css}

@@ -1,5 +1,5 @@
-@layer optiaxiom._1dfr2ib;
-@layer optiaxiom._1dfr2ib {
+@layer optiaxiom.st6wia;
+@layer optiaxiom.st6wia {
   .ProteusChart__jmlqij1 {
     border-radius: 16px;
   }

package/dist/esm/assets/src/proteus-chart/{ProteusChartTooltipContent.css.ts.vanilla-DnR_C5ly.css → ProteusChartTooltipContent.css.ts.vanilla-BthlShlk.css}

@@ -1,5 +1,5 @@
-@layer optiaxiom._1dfr2ib;
-@layer optiaxiom._1dfr2ib {
+@layer optiaxiom.st6wia;
+@layer optiaxiom.st6wia {
   .ProteusChartTooltipContent__1gsvq810 {
     min-width: 128px;
     position: absolute;

package/dist/esm/assets/src/proteus-document/{ProteusDocumentShell.css.ts.vanilla-CVOes7es.css → ProteusDocumentShell.css.ts.vanilla-BugeP59E.css}

@@ -1,5 +1,5 @@
-@layer optiaxiom._1dfr2ib;
-@layer optiaxiom._1dfr2ib {
+@layer optiaxiom.st6wia;
+@layer optiaxiom.st6wia {
   .ProteusDocumentShell__vpuvfj1 {
     margin: -4px;
   }

package/dist/esm/assets/src/proteus-image-carousel/{ProteusImageCarousel.css.ts.vanilla-DXF3wHYt.css → ProteusImageCarousel.css.ts.vanilla-DhXdg25-.css}

@@ -1,5 +1,5 @@
-@layer optiaxiom._1dfr2ib;
-@layer optiaxiom._1dfr2ib {
+@layer optiaxiom.st6wia;
+@layer optiaxiom.st6wia {
   .ProteusImageCarousel__1t6qej70 {
     outline: none;
     user-select: none;

package/dist/esm/assets/src/proteus-markdown/{ProteusMarkdown.css.ts.vanilla-Cjmk3X5z.css → ProteusMarkdown.css.ts.vanilla-BM9-lPyj.css}

@@ -1,5 +1,5 @@
-@layer optiaxiom._1dfr2ib;
-@layer optiaxiom._1dfr2ib {
+@layer optiaxiom.st6wia;
+@layer optiaxiom.st6wia {
   .ProteusMarkdown__1ibq5ae0 > * {
     margin-bottom: 1em;
     margin-top: 0;

package/dist/esm/assets/src/proteus-question/{ProteusQuestion.css.ts.vanilla-DVFRsIPp.css → ProteusQuestion.css.ts.vanilla-1u353vmb.css}

@@ -1,5 +1,5 @@
-@layer optiaxiom._1dfr2ib;
-@layer optiaxiom._1dfr2ib {
+@layer optiaxiom.st6wia;
+@layer optiaxiom.st6wia {
   .ProteusQuestion__8f590p0 {
     outline: none;
   }

package/dist/esm/index.js

@@ -1,3 +1,4 @@
+import { ProteusDataTableRow } from "./proteus-data-table-row/ProteusDataTableRow.js";
 import { ProteusAction } from "./proteus-action/ProteusAction.js";
 import { ProteusBridge } from "./proteus-bridge/ProteusBridge.js";
 import { ProteusChart } from "./proteus-chart/ProteusChart.js";
@@ -21,4 +22,4 @@ import { ProteusShow } from "./proteus-show/ProteusShow.js";
 import { ProteusTextarea } from "./proteus-textarea/ProteusTextarea.js";
 import { ProteusDocumentShell } from "./proteus-document/ProteusDocumentShell.js";
 import { ProteusDocumentRenderer } from "./proteus-document/ProteusDocumentRenderer.js";
-export { ProteusAction, ProteusBridge, ProteusChart, ProteusDataTable, ProteusDateInput, ProteusDocumentRenderer, ProteusDocumentShell, ProteusFederated, ProteusFileUpload, ProteusImage, ProteusImageCarousel, ProteusInput, ProteusLength, ProteusMap, ProteusMapIndex, ProteusMarkdown, ProteusPillMenu, ProteusRichTextEditor, ProteusSelect, ProteusShow, ProteusTextarea, safeParseDocument, useProteusValue };
+export { ProteusAction, ProteusBridge, ProteusChart, ProteusDataTable, ProteusDataTableRow, ProteusDateInput, ProteusDocumentRenderer, ProteusDocumentShell, ProteusFederated, ProteusFileUpload, ProteusImage, ProteusImageCarousel, ProteusInput, ProteusLength, ProteusMap, ProteusMapIndex, ProteusMarkdown, ProteusPillMenu, ProteusRichTextEditor, ProteusSelect, ProteusShow, ProteusTextarea, safeParseDocument, useProteusValue };

package/dist/esm/proteus-action/ProteusAction.js

@@ -33,7 +33,7 @@ function ProteusAction({ children, onClick, type = "button", ...props }) {
 * available — so the document-root event handler can apply it unambiguously.
 */
 function resolveEventPath(event, parentPath) {
-	if (event && typeof event === "object" && "action" in event && (event.action === "pushValue" || event.action === "removeValue")) {
+	if (event && typeof event === "object" && "action" in event && (event.action === "pushValue" || event.action === "removeValue" || event.action === "setValue")) {
 		const { path } = event;
 		const resolved = path === "" ? parentPath : path.startsWith("/") ? path : `${parentPath}/${path}`;
 		return {

package/dist/esm/proteus-chart/ProteusChart-css.js

@@ -1,4 +1,4 @@
-import "./../assets/src/proteus-chart/ProteusChart.css.ts.vanilla-ByPSKREp.css";
+import "./../assets/src/proteus-chart/ProteusChart.css.ts.vanilla-BcGBUwbD.css";
 import { recipe } from "@optiaxiom/react/css-runtime";
 //#region src/proteus-chart/ProteusChart.css.ts
 var chart = recipe({ base: [

package/dist/esm/proteus-chart/ProteusChartTooltipContent-css.js

@@ -1,5 +1,5 @@
 import { recipe } from "@optiaxiom/react/css-runtime";
-import "./../assets/src/proteus-chart/ProteusChartTooltipContent.css.ts.vanilla-DnR_C5ly.css";
+import "./../assets/src/proteus-chart/ProteusChartTooltipContent.css.ts.vanilla-BthlShlk.css";
 //#region src/proteus-chart/ProteusChartTooltipContent.css.ts
 var tooltip = recipe({ base: [{
 	bg: "bg.default",

package/dist/esm/proteus-data-table/ProteusDataTable.js

@@ -1,6 +1,7 @@
 "use client";
 import { applyFormatter } from "../proteus-document/getProteusValue.js";
 import { DataTable, DataTableBody } from "@optiaxiom/react";
+import "react";
 import { get } from "jsonpointer";
 import { jsx } from "react/jsx-runtime";
 import { createColumnHelper, getCoreRowModel, useReactTable } from "@tanstack/react-table";
@@ -18,7 +19,8 @@ const ProteusDataTable = ({ columns, data }) => {
 				}, {
 					header: col.header,
 					id: col.accessorKey,
-					size: col.size
+					size: col.size,
+					...col.cell && { cell: ({ row }) => col.cell?.(row.original) }
 				});
 			}),
 			data: tableData,

package/dist/esm/proteus-data-table-row/ProteusDataTableRow.js

@@ -0,0 +1,26 @@
+"use client";
+import { useProteusDataTableRowContext } from "../proteus-document/ProteusDataTableRowContext.js";
+import { get } from "jsonpointer";
+//#region src/proteus-data-table-row/ProteusDataTableRow.tsx
+function ProteusDataTableRow({ path }) {
+	const { row } = useProteusDataTableRowContext("@optiaxiom/proteus/ProteusDataTableRow");
+	const value = getDataTableRowValue(row, path);
+	return value == null || typeof value === "object" ? null : String(value);
+}
+ProteusDataTableRow.displayName = "@optiaxiom/proteus/ProteusDataTableRow";
+/**
+* Reads a value out of a `DataTable` row for the `DataTableRow` element and
+* expression. With no `path`, returns the whole row; otherwise reads the field
+* at `path` (leading `/` optional).
+*/
+function getDataTableRowValue(row, path) {
+	if (!row) return;
+	if (!path) return row;
+	try {
+		return get(row, path.startsWith("/") ? path : `/${path}`);
+	} catch {
+		return;
+	}
+}
+//#endregion
+export { ProteusDataTableRow, getDataTableRowValue };

package/dist/esm/proteus-document/ProteusDataTableRowContext.js

@@ -0,0 +1,12 @@
+"use client";
+"use client";
+import { createContext } from "@radix-ui/react-context";
+//#region src/proteus-document/ProteusDataTableRowContext.ts
+/**
+* Holds the current `DataTable` row while a column's `cell` template renders.
+* `DataTableRow` reads from here to give the cell pointer access to its row,
+* the same way `MapIndex` exposes the current index inside a `Map`.
+*/
+const [ProteusDataTableRowProvider, useProteusDataTableRowContext] = createContext("@optiaxiom/proteus/ProteusDataTableRow", { row: void 0 });
+//#endregion
+export { ProteusDataTableRowProvider, useProteusDataTableRowContext };

package/dist/esm/proteus-document/ProteusDocumentShell-css.js

@@ -1,5 +1,5 @@
 import { recipe } from "@optiaxiom/react/css-runtime";
-import "./../assets/src/proteus-document/ProteusDocumentShell.css.ts.vanilla-CVOes7es.css";
+import "./../assets/src/proteus-document/ProteusDocumentShell.css.ts.vanilla-BugeP59E.css";
 //#region src/proteus-document/ProteusDocumentShell.css.ts
 var body = recipe({
 	base: [{

package/dist/esm/proteus-document/ProteusDocumentShell.js

@@ -3,6 +3,8 @@ import { ProteusDocumentProvider } from "./ProteusDocumentContext.js";
 import { resolveProteusValue } from "./resolveProteusValue.js";
 import { useEffectEvent } from "../hooks/useEffectEvent.js";
 import { downloadFile } from "../proteus-image/downloadFile.js";
+import { useProteusScripts } from "../proteus-script/useProteusScripts.js";
+import { isSafeUrl } from "./isSafeUrl.js";
 import { body, scrollIndicator } from "./ProteusDocumentShell-css.js";
 import { Box, Disclosure, DisclosureContent, DisclosureTrigger, Group, Heading, Text, Tooltip } from "@optiaxiom/react";
 import { useEffect, useRef, useState } from "react";
@@ -41,6 +43,73 @@ function ProteusDocumentShell({ collapsible: collapsibleProp, data = {}, default
 	const collapsible = collapsibleProp && element.appName;
 	const Trigger = collapsible ? DisclosureTrigger : Box;
 	const inline = resolveProteusValue(element.appearance, data, "", []) === "inline";
+	const onEvent = useEffectEvent(async (event) => {
+		if ("interaction" in event) return await onInteraction?.(event.interaction, event.params);
+		else if ("message" in event) await onMessage?.(event.message);
+		else if ("script" in event) return await runScript(event.script, event.params);
+		else if (event.action === "download") {
+			const urls = [];
+			if (typeof event.url === "string") urls.push(event.url);
+			else if (Array.isArray(event.url)) for (const u of event.url) {
+				if (typeof u !== "string") throw new Error("Invalid URL in download array");
+				urls.push(u);
+			}
+			else throw new Error("Invalid URL for download action");
+			for (const u of urls) if (!isSafeUrl(u)) {
+				if (strict) throw new Error(`download: unsafe URL "${u}"`);
+				return;
+			}
+			if (onDownload) await onDownload(urls);
+			else await Promise.all(urls.map((u) => downloadFile(u)));
+		} else if (event.action === "openLink") {
+			if (isSafeUrl(event.url)) window.open(event.url, "_blank", "noopener,noreferrer");
+			else if (strict) throw new Error(`openLink: unsafe URL "${String(event.url)}"`);
+		} else if (event.action === "preview") await onPreview?.(event.file);
+		else if (event.action === "pushValue") {
+			const { path, value } = event;
+			onDataChange?.((prev) => {
+				const next = structuredClone(prev);
+				const current = get(next, path);
+				if (current !== void 0 && !Array.isArray(current)) {
+					if (strict) throw new Error(`pushValue: expected array at "${path}"`);
+					return prev;
+				}
+				set(next, path, [...current ?? [], value]);
+				return next;
+			});
+		} else if (event.action === "removeValue") {
+			const { path } = event;
+			const slash = path.lastIndexOf("/");
+			const parent = slash > 0 ? path.slice(0, slash) : "";
+			const index = Number(path.slice(slash + 1));
+			if (!parent || !Number.isInteger(index)) {
+				if (strict) throw new Error(`removeValue: "${path}" is not an array index`);
+				return;
+			}
+			onDataChange?.((prev) => {
+				const next = structuredClone(prev);
+				const arr = get(next, parent);
+				if (!Array.isArray(arr)) {
+					if (strict) throw new Error(`removeValue: "${parent}" is not an array`);
+					return prev;
+				}
+				set(next, parent, arr.filter((_, i) => i !== index));
+				return next;
+			});
+		} else if (event.action === "setValue") {
+			const { path, value } = event;
+			onDataChange?.((prev) => {
+				const next = structuredClone(prev);
+				set(next, path, value);
+				return next;
+			});
+		}
+	});
+	const runScript = useProteusScripts({
+		data,
+		onEmit: onEvent,
+		scripts: element.scripts
+	});
 	return /* @__PURE__ */ jsx(ProteusDocumentProvider, {
 		data,
 		icons,
@@ -51,55 +120,7 @@ function ProteusDocumentShell({ collapsible: collapsibleProp, data = {}, default
 				return next;
 			});
 		}),
-		onEvent: useEffectEvent(async (event) => {
-			if ("interaction" in event) return await onInteraction?.(event.interaction, event.params);
-			else if ("message" in event) await onMessage?.(event.message);
-			else if (event.action === "download") {
-				const urls = [];
-				if (typeof event.url === "string") urls.push(event.url);
-				else if (Array.isArray(event.url)) for (const u of event.url) {
-					if (typeof u !== "string") throw new Error("Invalid URL in download array");
-					urls.push(u);
-				}
-				else throw new Error("Invalid URL for download action");
-				if (onDownload) await onDownload(urls);
-				else await Promise.all(urls.map((u) => downloadFile(u)));
-			} else if (event.action === "openLink") {
-				if (typeof event.url === "string") window.open(event.url, "_blank", "noopener,noreferrer");
-			} else if (event.action === "preview") await onPreview?.(event.file);
-			else if (event.action === "pushValue") {
-				const { path, value } = event;
-				onDataChange?.((prev) => {
-					const next = structuredClone(prev);
-					const current = get(next, path);
-					if (current !== void 0 && !Array.isArray(current)) {
-						if (strict) throw new Error(`pushValue: expected array at "${path}"`);
-						return prev;
-					}
-					set(next, path, [...current ?? [], value]);
-					return next;
-				});
-			} else if (event.action === "removeValue") {
-				const { path } = event;
-				const slash = path.lastIndexOf("/");
-				const parent = slash > 0 ? path.slice(0, slash) : "";
-				const index = Number(path.slice(slash + 1));
-				if (!parent || !Number.isInteger(index)) {
-					if (strict) throw new Error(`removeValue: "${path}" is not an array index`);
-					return;
-				}
-				onDataChange?.((prev) => {
-					const next = structuredClone(prev);
-					const arr = get(next, parent);
-					if (!Array.isArray(arr)) {
-						if (strict) throw new Error(`removeValue: "${parent}" is not an array`);
-						return prev;
-					}
-					set(next, parent, arr.filter((_, i) => i !== index));
-					return next;
-				});
-			}
-		}),
+		onEvent,
 		onTrack: useEffectEvent((event, properties) => {
 			onTrack?.(event, properties);
 		}),

package/dist/esm/proteus-document/isSafeUrl.js

@@ -0,0 +1,22 @@
+//#region src/proteus-document/isSafeUrl.ts
+/**
+* Whether a URL is safe to hand to `window.open` from a document-triggered
+* action (`openLink` / `download`).
+*
+* Documents — and now scripts, via `ctx.emit` — supply these URLs, so we only
+* allow navigable web schemes and reject dangerous ones like `javascript:`
+* (script injection) and `data:` (can host arbitrary HTML/JS in a new tab).
+* Relative URLs are resolved against the current document.
+*/
+function isSafeUrl(url) {
+	if (typeof url !== "string") return false;
+	let parsed;
+	try {
+		parsed = new URL(url, window.location.href);
+	} catch {
+		return false;
+	}
+	return parsed.protocol === "http:" || parsed.protocol === "https:";
+}
+//#endregion
+export { isSafeUrl };

package/dist/esm/proteus-document/resolveProteusProp.js

@@ -1,19 +1,21 @@
 "use client";
+import { getDataTableRowValue } from "../proteus-data-table-row/ProteusDataTableRow.js";
 import { getProteusValue } from "./getProteusValue.js";
 import { evaluateCondition } from "./resolveProteusValue.js";
 import { ProteusElement } from "../proteus-element/ProteusElement.js";
 import { jsx } from "react/jsx-runtime";
 //#region src/proteus-document/resolveProteusProp.tsx
-function resolveProteusProp(value, data, parentPath, mapIndices = []) {
+function resolveProteusProp(value, data, parentPath, mapIndices = [], dataTableRow) {
 	if (typeof value !== "object" || value === null) return value;
 	if ("$type" in value && value.$type === "MapIndex") return mapIndices.at(-1);
+	if ("$type" in value && value.$type === "DataTableRow") return getDataTableRowValue(dataTableRow, "path" in value && typeof value.path === "string" ? value.path : void 0);
 	if ("$type" in value && value.$type === "Value" && "path" in value && typeof value.path === "string") return getProteusValue(data, value, parentPath);
 	if ("$type" in value && value.$type === "Zip" && "sources" in value) {
 		const sources = value.sources;
 		const resolved = {};
 		let length = 0;
 		for (const [k, v] of Object.entries(sources)) {
-			const arr = resolveProteusProp(v, data, parentPath, mapIndices);
+			const arr = resolveProteusProp(v, data, parentPath, mapIndices, dataTableRow);
 			if (Array.isArray(arr)) {
 				resolved[k] = arr;
 				length = Math.max(length, arr.length);
@@ -25,10 +27,7 @@ function resolveProteusProp(value, data, parentPath, mapIndices = []) {
 			return row;
 		});
 	}
-	if ("$type" in value && value.$type === "Show" && "when" in value && "children" in value) {
-		if (!(Array.isArray(value.when) ? value.when : [value.when]).every((condition) => evaluateCondition(condition, data, parentPath, mapIndices))) return;
-		return resolveProteusProp(value.children, data, parentPath, mapIndices);
-	}
+	if ("$type" in value && value.$type === "Show" && "when" in value && "children" in value) return resolveProteusProp((Array.isArray(value.when) ? value.when : [value.when]).every((condition) => evaluateCondition(condition, data, parentPath, mapIndices, dataTableRow)) ? value.children : "else" in value ? value.else : void 0, data, parentPath, mapIndices, dataTableRow);
 	return "$type" in value || Array.isArray(value) && value.some((v) => v && typeof v === "object" && "$type" in v) ? /* @__PURE__ */ jsx(ProteusElement, { element: value }) : value;
 }
 //#endregion

package/dist/esm/proteus-document/resolveProteusValue.js

@@ -1,45 +1,47 @@
 "use client";
+import { getDataTableRowValue } from "../proteus-data-table-row/ProteusDataTableRow.js";
 import { getProteusValue } from "./getProteusValue.js";
 //#region src/proteus-document/resolveProteusValue.tsx
-function evaluateCondition(condition, data, parentPath, mapIndices = []) {
+function evaluateCondition(condition, data, parentPath, mapIndices = [], dataTableRow) {
 	if (!condition) return true;
-	if ("and" in condition) return condition.and.every((cond) => evaluateCondition(cond, data, parentPath, mapIndices));
-	if ("or" in condition) return condition.or.some((cond) => evaluateCondition(cond, data, parentPath, mapIndices));
-	if ("!!" in condition) return !!resolveProteusValue(condition["!!"], data, parentPath, mapIndices);
-	if ("!" in condition) return !resolveProteusValue(condition["!"], data, parentPath, mapIndices);
+	if ("and" in condition) return condition.and.every((cond) => evaluateCondition(cond, data, parentPath, mapIndices, dataTableRow));
+	if ("or" in condition) return condition.or.some((cond) => evaluateCondition(cond, data, parentPath, mapIndices, dataTableRow));
+	if ("!!" in condition) return !!resolveProteusValue(condition["!!"], data, parentPath, mapIndices, dataTableRow);
+	if ("!" in condition) return !resolveProteusValue(condition["!"], data, parentPath, mapIndices, dataTableRow);
 	if ("==" in condition) {
 		const [left, right] = condition["=="];
-		return resolveProteusValue(left, data, parentPath, mapIndices) === resolveProteusValue(right, data, parentPath, mapIndices);
+		return resolveProteusValue(left, data, parentPath, mapIndices, dataTableRow) === resolveProteusValue(right, data, parentPath, mapIndices, dataTableRow);
 	} else if ("!=" in condition) {
 		const [left, right] = condition["!="];
-		return resolveProteusValue(left, data, parentPath, mapIndices) !== resolveProteusValue(right, data, parentPath, mapIndices);
+		return resolveProteusValue(left, data, parentPath, mapIndices, dataTableRow) !== resolveProteusValue(right, data, parentPath, mapIndices, dataTableRow);
 	} else if ("<" in condition) {
 		const [left, right] = condition["<"];
-		const leftVal = resolveProteusValue(left, data, parentPath, mapIndices);
-		const rightVal = resolveProteusValue(right, data, parentPath, mapIndices);
+		const leftVal = resolveProteusValue(left, data, parentPath, mapIndices, dataTableRow);
+		const rightVal = resolveProteusValue(right, data, parentPath, mapIndices, dataTableRow);
 		return typeof leftVal === "number" && typeof rightVal === "number" && leftVal < rightVal;
 	} else if ("<=" in condition) {
 		const [left, right] = condition["<="];
-		const leftVal = resolveProteusValue(left, data, parentPath, mapIndices);
-		const rightVal = resolveProteusValue(right, data, parentPath, mapIndices);
+		const leftVal = resolveProteusValue(left, data, parentPath, mapIndices, dataTableRow);
+		const rightVal = resolveProteusValue(right, data, parentPath, mapIndices, dataTableRow);
 		return typeof leftVal === "number" && typeof rightVal === "number" && leftVal <= rightVal;
 	} else if (">" in condition) {
 		const [left, right] = condition[">"];
-		const leftVal = resolveProteusValue(left, data, parentPath, mapIndices);
-		const rightVal = resolveProteusValue(right, data, parentPath, mapIndices);
+		const leftVal = resolveProteusValue(left, data, parentPath, mapIndices, dataTableRow);
+		const rightVal = resolveProteusValue(right, data, parentPath, mapIndices, dataTableRow);
 		return typeof leftVal === "number" && typeof rightVal === "number" && leftVal > rightVal;
 	} else if (">=" in condition) {
 		const [left, right] = condition[">="];
-		const leftVal = resolveProteusValue(left, data, parentPath, mapIndices);
-		const rightVal = resolveProteusValue(right, data, parentPath, mapIndices);
+		const leftVal = resolveProteusValue(left, data, parentPath, mapIndices, dataTableRow);
+		const rightVal = resolveProteusValue(right, data, parentPath, mapIndices, dataTableRow);
 		return typeof leftVal === "number" && typeof rightVal === "number" && leftVal >= rightVal;
 	}
 	return false;
 }
-function resolveProteusValue(value, data, parentPath, mapIndices = []) {
+function resolveProteusValue(value, data, parentPath, mapIndices = [], dataTableRow) {
 	if (typeof value !== "object" || value === null) return value;
 	if ("$type" in value) {
 		if (value.$type === "MapIndex") return mapIndices.at(-1);
+		if (value.$type === "DataTableRow") return getDataTableRowValue(dataTableRow, "path" in value && typeof value.path === "string" ? value.path : void 0);
 		if (value.$type === "Value" && "path" in value && typeof value.path === "string") return getProteusValue(data, value, parentPath);
 		if (value.$type === "Length" && "path" in value && typeof value.path === "string") {
 			const arr = getProteusValue(data, { path: value.path }, parentPath);
@@ -49,28 +51,29 @@ function resolveProteusValue(value, data, parentPath, mapIndices = []) {
 			const array = getProteusValue(data, { path: value.path }, parentPath);
 			if (!Array.isArray(array)) return value;
 			const resolvedPath = value.path.startsWith("/") ? value.path : `${parentPath}/${value.path}`;
-			const items = array.map((_, index) => resolveProteusValue(value.children, data, `${resolvedPath}/${index}`, [...mapIndices, index])).filter((v) => v !== void 0);
+			const items = array.map((_, index) => resolveProteusValue(value.children, data, `${resolvedPath}/${index}`, [...mapIndices, index], dataTableRow)).filter((v) => v !== void 0);
 			const result = "flat" in value && value.flat ? items.flat() : items;
 			if ("separator" in value) {
-				const sep = resolveProteusValue(value.separator, data, parentPath, mapIndices);
+				const sep = resolveProteusValue(value.separator, data, parentPath, mapIndices, dataTableRow);
 				return result.join(typeof sep === "string" ? sep : "");
 			}
 			return result;
 		}
 		if (value.$type === "Show" && "when" in value && "children" in value) {
-			if (!(Array.isArray(value.when) ? value.when : [value.when]).every((condition) => evaluateCondition(condition, data, parentPath, mapIndices))) return;
-			return resolveProteusValue(value.children, data, parentPath, mapIndices);
+			const branch = (Array.isArray(value.when) ? value.when : [value.when]).every((condition) => evaluateCondition(condition, data, parentPath, mapIndices, dataTableRow)) ? value.children : "else" in value ? value.else : void 0;
+			if (branch === void 0) return;
+			return resolveProteusValue(branch, data, parentPath, mapIndices, dataTableRow);
 		}
 		if (value.$type === "Concat" && "children" in value) {
 			if (!Array.isArray(value.children)) return value;
-			return value.children.map((child) => resolveProteusValue(child, data, parentPath, mapIndices)).filter((v) => v !== void 0).join("");
+			return value.children.map((child) => resolveProteusValue(child, data, parentPath, mapIndices, dataTableRow)).filter((v) => v !== void 0).join("");
 		}
 		return value;
 	}
-	if (Array.isArray(value)) return value.map((v) => resolveProteusValue(v, data, parentPath, mapIndices)).filter((v) => v !== void 0);
+	if (Array.isArray(value)) return value.map((v) => resolveProteusValue(v, data, parentPath, mapIndices, dataTableRow)).filter((v) => v !== void 0);
 	const resolved = {};
 	for (const [k, v] of Object.entries(value)) {
-		const r = resolveProteusValue(v, data, parentPath, mapIndices);
+		const r = resolveProteusValue(v, data, parentPath, mapIndices, dataTableRow);
 		if (r !== void 0) resolved[k] = r;
 	}
 	return resolved;

package/dist/esm/proteus-document/useResolveProteusValues.js

@@ -1,12 +1,14 @@
 import { useProteusDocumentContext } from "./ProteusDocumentContext.js";
 import { useProteusDocumentPathContext } from "./ProteusDocumentPathContext.js";
+import { useProteusDataTableRowContext } from "./ProteusDataTableRowContext.js";
 import { resolveProteusValue } from "./resolveProteusValue.js";
 //#region src/proteus-document/useResolveProteusValues.ts
 function useResolveProteusValues(props) {
 	const { data } = useProteusDocumentContext("@optiaxiom/react/useResolveProteusValues");
 	const { mapIndices, path: parentPath } = useProteusDocumentPathContext("@optiaxiom/react/useResolveProteusValues");
+	const { row: dataTableRow } = useProteusDataTableRowContext("@optiaxiom/react/useResolveProteusValues");
 	const resolved = {};
-	for (const [key, value] of Object.entries(props)) resolved[key] = resolveProteusValue(value, data, parentPath, mapIndices);
+	for (const [key, value] of Object.entries(props)) resolved[key] = resolveProteusValue(value, data, parentPath, mapIndices, dataTableRow);
 	return resolved;
 }
 //#endregion

package/dist/esm/proteus-element/ProteusElement.js

@@ -1,6 +1,8 @@
 "use client";
 import { useProteusDocumentContext } from "../proteus-document/ProteusDocumentContext.js";
 import { useProteusDocumentPathContext } from "../proteus-document/ProteusDocumentPathContext.js";
+import { ProteusDataTableRowProvider, useProteusDataTableRowContext } from "../proteus-document/ProteusDataTableRowContext.js";
+import { ProteusDataTableRow } from "../proteus-data-table-row/ProteusDataTableRow.js";
 import { ProteusAction } from "../proteus-action/ProteusAction.js";
 import { ProteusBridge } from "../proteus-bridge/ProteusBridge.js";
 import { ProteusDataTable } from "../proteus-data-table/ProteusDataTable.js";
@@ -37,6 +39,7 @@ const ProteusChart = lazy(async () => {
 const ProteusElement = ({ element: elementProp }) => {
 	const { data, icons, strict } = useProteusDocumentContext("@optiaxiom/proteus/ProteusElement");
 	const { mapIndices, path: parentPath } = useProteusDocumentPathContext("@optiaxiom/proteus/ProteusElement");
+	const { row: dataTableRow } = useProteusDataTableRowContext("@optiaxiom/proteus/ProteusElement");
 	if (!elementProp) return null;
 	else if (typeof elementProp === "string" || typeof elementProp === "number") return elementProp;
 	else if (Array.isArray(elementProp)) return /* @__PURE__ */ jsx(Fragment, { children: elementProp.map((element, index) => /* @__PURE__ */ jsx(ProteusElement, { element }, index)) });
@@ -49,7 +52,7 @@ const ProteusElement = ({ element: elementProp }) => {
 	const resolve = (obj) => {
 		const { $type: _$type, ...rest } = obj;
 		const resolved = {};
-		for (const [key, value] of Object.entries(rest)) resolved[key] = resolveProteusProp(value, data, parentPath, mapIndices);
+		for (const [key, value] of Object.entries(rest)) resolved[key] = resolveProteusProp(value, data, parentPath, mapIndices, dataTableRow);
 		return resolved;
 	};
 	switch (element.$type) {
@@ -67,7 +70,14 @@ const ProteusElement = ({ element: elementProp }) => {
 			fallback: null,
 			children: /* @__PURE__ */ jsx(ProteusChart, { ...resolve(element) })
 		});
-		case "DataTable": return /* @__PURE__ */ jsx(ProteusDataTable, { ...resolve(element) });
+		case "DataTable": {
+			const { columns, ...props } = resolve(element);
+			return /* @__PURE__ */ jsx(ProteusDataTable, {
+				...props,
+				columns: wireCellTemplates(columns)
+			});
+		}
+		case "DataTableRow": return /* @__PURE__ */ jsx(ProteusDataTableRow, { ...resolve(element) });
 		case "DateInput": return /* @__PURE__ */ jsx(ProteusDateInput, { ...resolve(element) });
 		case "Disclosure": return /* @__PURE__ */ jsx(Disclosure, { ...resolve(element) });
 		case "DisclosureContent": return /* @__PURE__ */ jsx(DisclosureContent, { ...resolve(element) });
@@ -82,7 +92,16 @@ const ProteusElement = ({ element: elementProp }) => {
 			const { filled, name, ...rest } = resolve(element);
 			const IconComp = icons?.[name];
 			if (!IconComp) {
-				if (strict) throw new Error(`Icon "${name}" not registered. Pass it via the \`icons\` prop on ProteusDocumentRenderer.`);
+				if (typeof name === "string" && /^(?:https?:\/\/|data:)/.test(name)) return /* @__PURE__ */ jsx(Box, {
+					asChild: true,
+					...rest,
+					children: /* @__PURE__ */ jsx("img", {
+						alt: "",
+						"aria-hidden": "true",
+						src: name
+					})
+				});
+				if (strict) throw new Error(`Icon "${name}" not registered and not a URL. Pass it via the \`icons\` prop on ProteusDocumentRenderer, or use an http(s):// or data: URL.`);
 				return null;
 			}
 			return /* @__PURE__ */ jsx(Box, {
@@ -120,5 +139,24 @@ const ProteusElement = ({ element: elementProp }) => {
 	}
 };
 ProteusElement.displayName = "@optiaxiom/proteus/ProteusElement";
+/**
+* Turns each column's raw `cell` template into a render function that renders it
+* (via `ProteusElement`) with the row exposed through context, so `DataTableRow`
+* can read the row. Keeps `ProteusDataTable` free of any `ProteusElement`
+* dependency (avoids bundling the whole element graph into its chunk).
+*/
+function wireCellTemplates(columns) {
+	return columns?.map((column) => {
+		const cell = column.cell;
+		if (cell == null) return column;
+		return {
+			...column,
+			cell: (row) => /* @__PURE__ */ jsx(ProteusDataTableRowProvider, {
+				row,
+				children: /* @__PURE__ */ jsx(ProteusElement, { element: cell })
+			})
+		};
+	});
+}
 //#endregion
 export { ProteusElement };

package/dist/esm/proteus-image-carousel/ProteusImageCarousel-css.js

@@ -1,5 +1,5 @@
 import { recipe } from "@optiaxiom/react/css-runtime";
-import "./../assets/src/proteus-image-carousel/ProteusImageCarousel.css.ts.vanilla-DXF3wHYt.css";
+import "./../assets/src/proteus-image-carousel/ProteusImageCarousel.css.ts.vanilla-DhXdg25-.css";
 //#region src/proteus-image-carousel/ProteusImageCarousel.css.ts
 var carousel = recipe({ base: [{
 	flexDirection: "column",

package/dist/esm/proteus-markdown/ProteusMarkdown-css.js

@@ -1,5 +1,5 @@
 import { recipe } from "@optiaxiom/react/css-runtime";
-import "./../assets/src/proteus-markdown/ProteusMarkdown.css.ts.vanilla-Cjmk3X5z.css";
+import "./../assets/src/proteus-markdown/ProteusMarkdown.css.ts.vanilla-BM9-lPyj.css";
 //#region src/proteus-markdown/ProteusMarkdown.css.ts
 var code = recipe({ base: [{
 	bg: "bg.secondary",

package/dist/esm/proteus-question/ProteusQuestion-css.js

@@ -1,5 +1,5 @@
 import { recipe } from "@optiaxiom/react/css-runtime";
-import "./../assets/src/proteus-question/ProteusQuestion.css.ts.vanilla-DVFRsIPp.css";
+import "./../assets/src/proteus-question/ProteusQuestion.css.ts.vanilla-1u353vmb.css";
 //#region src/proteus-question/ProteusQuestion.css.ts
 var addon = recipe({
 	base: [{