@optiaxiom/proteus 3.1.0 → 3.2.0

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-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/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) });
@@ -129,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-script/useProteusScripts.js

@@ -35,6 +35,7 @@ const INVOKE_TIMEOUT_MS = 5e3;
 function useProteusScripts({ data, onEmit, scripts }) {
 	const dataRef = useRef(data);
 	dataRef.current = data;
+	const initialDataRef = useRef(data);
 	const emit = useEffectEvent(onEmit);
 	const hasScripts = !!scripts && Object.keys(scripts).length > 0;
 	const pending = useRef(/* @__PURE__ */ new Map()).current;
@@ -47,6 +48,32 @@ function useProteusScripts({ data, onEmit, scripts }) {
 	const seedWatchers = useEffectEvent((data) => {
 		lastEval.current = watchedPaths.current.map((path) => JSON.stringify(getByPointer(data, path) ?? null));
 	});
+	/**
+	* Compare each watched path in `data` against its `lastEval` baseline and post
+	* `runWatcher` for any that changed, advancing the baseline. Shared by the
+	* data-change effect and the `watchers` message handler (so a watcher that
+	* registers after the user already changed data still catches that edge).
+	*/
+	const runEdgeDetect = useEffectEvent((data) => {
+		const worker = workerRef.current;
+		if (!worker) return;
+		watchedPaths.current.forEach((path, watchId) => {
+			const current = getByPointer(data, path) ?? null;
+			const serialized = JSON.stringify(current);
+			const prevSerialized = lastEval.current[watchId];
+			if (serialized !== prevSerialized) {
+				lastEval.current[watchId] = serialized;
+				const previous = prevSerialized === void 0 ? void 0 : JSON.parse(prevSerialized);
+				worker.postMessage({
+					current,
+					data,
+					previous,
+					type: "runWatcher",
+					watchId
+				});
+			}
+		});
+	});
 	/** Resolve a pending run (if still pending) and clear its timeout. */
 	const settle = useEffectEvent((invokeId, result) => {
 		const entry = pending.get(invokeId);
@@ -81,7 +108,8 @@ function useProteusScripts({ data, onEmit, scripts }) {
 			} else if (msg.type === "invokeResult") settle(msg.invokeId, msg.result);
 			else if (msg.type === "watchers") {
 				watchedPaths.current = msg.paths;
-				seedWatchers(dataRef.current);
+				seedWatchers(initialDataRef.current);
+				runEdgeDetect(dataRef.current);
 			}
 		});
 		return instance;
@@ -105,28 +133,12 @@ function useProteusScripts({ data, onEmit, scripts }) {
 		return teardown;
 	}, [scripts, hasScripts]);
 	useEffect(() => {
-		const worker = workerRef.current;
-		if (!worker || watchedPaths.current.length === 0) return;
+		if (!workerRef.current || watchedPaths.current.length === 0) return;
 		if (emitDepth.current > 0) {
 			seedWatchers(data);
 			return;
 		}
-		watchedPaths.current.forEach((path, watchId) => {
-			const current = getByPointer(data, path) ?? null;
-			const serialized = JSON.stringify(current);
-			const prevSerialized = lastEval.current[watchId];
-			if (serialized !== prevSerialized) {
-				lastEval.current[watchId] = serialized;
-				const previous = prevSerialized === void 0 ? void 0 : JSON.parse(prevSerialized);
-				worker.postMessage({
-					current,
-					data,
-					previous,
-					type: "runWatcher",
-					watchId
-				});
-			}
-		});
+		runEdgeDetect(data);
 	}, [data]);
 	return useEffectEvent((handler, params) => {
 		if (!hasScripts) return Promise.resolve(void 0);

package/dist/esm/proteus-show/ProteusShow.js

@@ -1,14 +1,15 @@
 "use client";
 import { useProteusDocumentContext } from "../proteus-document/ProteusDocumentContext.js";
 import { useProteusDocumentPathContext } from "../proteus-document/ProteusDocumentPathContext.js";
+import { useProteusDataTableRowContext } from "../proteus-document/ProteusDataTableRowContext.js";
 import { evaluateCondition } from "../proteus-document/resolveProteusValue.js";
 import { Fragment, jsx } from "react/jsx-runtime";
 //#region src/proteus-show/ProteusShow.tsx
-function ProteusShow({ children, when }) {
+function ProteusShow({ children, else: fallback, when }) {
 	const { data } = useProteusDocumentContext("@optiaxiom/proteus/ProteusShow");
 	const { mapIndices, path: parentPath } = useProteusDocumentPathContext("@optiaxiom/proteus/ProteusShow");
-	if (!(Array.isArray(when) ? when : [when]).every((condition) => evaluateCondition(condition, data, parentPath, mapIndices))) return null;
-	return /* @__PURE__ */ jsx(Fragment, { children });
+	const { row: dataTableRow } = useProteusDataTableRowContext("@optiaxiom/proteus/ProteusShow");
+	return /* @__PURE__ */ jsx(Fragment, { children: (Array.isArray(when) ? when : [when]).every((condition) => evaluateCondition(condition, data, parentPath, mapIndices, dataTableRow)) ? children : fallback });
 }
 ProteusShow.displayName = "@optiaxiom/proteus/ProteusShow";
 //#endregion

package/dist/esm/schema/public-schema.js

@@ -921,6 +921,7 @@ var public_schema_default = {
 							{ "type": "number" },
 							{ "type": "boolean" },
 							{ "type": "null" },
+							{ "$ref": "#/definitions/ProteusDataTableRow" },
 							{ "$ref": "#/definitions/ProteusLength" },
 							{ "$ref": "#/definitions/ProteusMapIndex" },
 							{ "$ref": "#/definitions/ProteusValue" }
@@ -941,6 +942,7 @@ var public_schema_default = {
 							{ "type": "number" },
 							{ "type": "boolean" },
 							{ "type": "null" },
+							{ "$ref": "#/definitions/ProteusDataTableRow" },
 							{ "$ref": "#/definitions/ProteusLength" },
 							{ "$ref": "#/definitions/ProteusMapIndex" },
 							{ "$ref": "#/definitions/ProteusValue" }
@@ -961,6 +963,7 @@ var public_schema_default = {
 							{ "type": "number" },
 							{ "type": "boolean" },
 							{ "type": "null" },
+							{ "$ref": "#/definitions/ProteusDataTableRow" },
 							{ "$ref": "#/definitions/ProteusLength" },
 							{ "$ref": "#/definitions/ProteusMapIndex" },
 							{ "$ref": "#/definitions/ProteusValue" }
@@ -981,6 +984,7 @@ var public_schema_default = {
 							{ "type": "number" },
 							{ "type": "boolean" },
 							{ "type": "null" },
+							{ "$ref": "#/definitions/ProteusDataTableRow" },
 							{ "$ref": "#/definitions/ProteusLength" },
 							{ "$ref": "#/definitions/ProteusMapIndex" },
 							{ "$ref": "#/definitions/ProteusValue" }
@@ -1001,6 +1005,7 @@ var public_schema_default = {
 							{ "type": "number" },
 							{ "type": "boolean" },
 							{ "type": "null" },
+							{ "$ref": "#/definitions/ProteusDataTableRow" },
 							{ "$ref": "#/definitions/ProteusLength" },
 							{ "$ref": "#/definitions/ProteusMapIndex" },
 							{ "$ref": "#/definitions/ProteusValue" }
@@ -1021,6 +1026,7 @@ var public_schema_default = {
 							{ "type": "number" },
 							{ "type": "boolean" },
 							{ "type": "null" },
+							{ "$ref": "#/definitions/ProteusDataTableRow" },
 							{ "$ref": "#/definitions/ProteusLength" },
 							{ "$ref": "#/definitions/ProteusMapIndex" },
 							{ "$ref": "#/definitions/ProteusValue" }
@@ -1040,6 +1046,7 @@ var public_schema_default = {
 							{ "type": "number" },
 							{ "type": "boolean" },
 							{ "type": "null" },
+							{ "$ref": "#/definitions/ProteusDataTableRow" },
 							{ "$ref": "#/definitions/ProteusLength" },
 							{ "$ref": "#/definitions/ProteusMapIndex" },
 							{ "$ref": "#/definitions/ProteusValue" }
@@ -1057,6 +1064,7 @@ var public_schema_default = {
 							{ "type": "number" },
 							{ "type": "boolean" },
 							{ "type": "null" },
+							{ "$ref": "#/definitions/ProteusDataTableRow" },
 							{ "$ref": "#/definitions/ProteusLength" },
 							{ "$ref": "#/definitions/ProteusMapIndex" },
 							{ "$ref": "#/definitions/ProteusValue" }
@@ -1314,6 +1322,7 @@ var public_schema_default = {
 				{ "$ref": "#/definitions/ProteusChart" },
 				{ "$ref": "#/definitions/ProteusConcat" },
 				{ "$ref": "#/definitions/ProteusDataTable" },
+				{ "$ref": "#/definitions/ProteusDataTableRow" },
 				{ "$ref": "#/definitions/ProteusDateInput" },
 				{ "$ref": "#/definitions/ProteusDisclosure" },
 				{ "$ref": "#/definitions/ProteusDisclosureContent" },
@@ -1513,6 +1522,7 @@ var public_schema_default = {
 		},
 		"ProteusExpression": {
 			"anyOf": [
+				{ "$ref": "#/definitions/ProteusDataTableRow" },
 				{ "$ref": "#/definitions/ProteusLength" },
 				{ "$ref": "#/definitions/ProteusMap" },
 				{ "$ref": "#/definitions/ProteusMapIndex" },
@@ -2552,6 +2562,10 @@ var public_schema_default = {
 								"description": "Key in data objects",
 								"type": "string"
 							},
+							"cell": {
+								"$ref": "#/definitions/ProteusNode",
+								"description": "A Proteus node template rendered for each cell in this column. Read the current row with DataTableRow (e.g. { $type: 'DataTableRow', path: 'status' } reads the row's 'status', or omit 'path' for the whole row). Can be a single element or an array — use Show elements to conditionally render (e.g. a Badge whose intent depends on the row value). When set, takes precedence over 'format'."
+							},
 							"format": {
 								"anyOf": [{
 									"description": "Formatter name",
@@ -2594,6 +2608,22 @@ var public_schema_default = {
 			"required": ["$type"],
 			"type": "object"
 		},
+		"ProteusDataTableRow": {
+			"additionalProperties": false,
+			"examples": [{
+				"$type": "DataTableRow",
+				"path": "status"
+			}],
+			"properties": {
+				"$type": { "const": "DataTableRow" },
+				"path": {
+					"description": "JSON pointer path to a field within the current row (e.g. 'status' or '/status'). When omitted, resolves to the whole row object. Only meaningful inside a DataTable column's `cell`.",
+					"type": "string"
+				}
+			},
+			"required": ["$type"],
+			"type": "object"
+		},
 		"ProteusDateInput": {
 			"additionalProperties": false,
 			"examples": [{
@@ -4358,6 +4388,10 @@ var public_schema_default = {
 					"$ref": "#/definitions/ProteusNode",
 					"description": "Content to show when condition is true"
 				},
+				"else": {
+					"$ref": "#/definitions/ProteusNode",
+					"description": "Content to render when the condition is false. Omitting it renders nothing. Chain nested Show/else to express multi-way choices (e.g. mapping a value to one of several outputs)."
+				},
 				"when": {
 					"anyOf": [{ "$ref": "#/definitions/ProteusCondition" }, {
 						"items": { "$ref": "#/definitions/ProteusCondition" },

package/dist/esm/schema/runtime-schema.js

@@ -918,6 +918,7 @@ var definitions = {
 						{ "type": "number" },
 						{ "type": "boolean" },
 						{ "type": "null" },
+						{ "$ref": "#/definitions/ProteusDataTableRow" },
 						{ "$ref": "#/definitions/ProteusLength" },
 						{ "$ref": "#/definitions/ProteusMapIndex" },
 						{ "$ref": "#/definitions/ProteusValue" }
@@ -937,6 +938,7 @@ var definitions = {
 						{ "type": "number" },
 						{ "type": "boolean" },
 						{ "type": "null" },
+						{ "$ref": "#/definitions/ProteusDataTableRow" },
 						{ "$ref": "#/definitions/ProteusLength" },
 						{ "$ref": "#/definitions/ProteusMapIndex" },
 						{ "$ref": "#/definitions/ProteusValue" }
@@ -956,6 +958,7 @@ var definitions = {
 						{ "type": "number" },
 						{ "type": "boolean" },
 						{ "type": "null" },
+						{ "$ref": "#/definitions/ProteusDataTableRow" },
 						{ "$ref": "#/definitions/ProteusLength" },
 						{ "$ref": "#/definitions/ProteusMapIndex" },
 						{ "$ref": "#/definitions/ProteusValue" }
@@ -975,6 +978,7 @@ var definitions = {
 						{ "type": "number" },
 						{ "type": "boolean" },
 						{ "type": "null" },
+						{ "$ref": "#/definitions/ProteusDataTableRow" },
 						{ "$ref": "#/definitions/ProteusLength" },
 						{ "$ref": "#/definitions/ProteusMapIndex" },
 						{ "$ref": "#/definitions/ProteusValue" }
@@ -994,6 +998,7 @@ var definitions = {
 						{ "type": "number" },
 						{ "type": "boolean" },
 						{ "type": "null" },
+						{ "$ref": "#/definitions/ProteusDataTableRow" },
 						{ "$ref": "#/definitions/ProteusLength" },
 						{ "$ref": "#/definitions/ProteusMapIndex" },
 						{ "$ref": "#/definitions/ProteusValue" }
@@ -1013,6 +1018,7 @@ var definitions = {
 						{ "type": "number" },
 						{ "type": "boolean" },
 						{ "type": "null" },
+						{ "$ref": "#/definitions/ProteusDataTableRow" },
 						{ "$ref": "#/definitions/ProteusLength" },
 						{ "$ref": "#/definitions/ProteusMapIndex" },
 						{ "$ref": "#/definitions/ProteusValue" }
@@ -1031,6 +1037,7 @@ var definitions = {
 						{ "type": "number" },
 						{ "type": "boolean" },
 						{ "type": "null" },
+						{ "$ref": "#/definitions/ProteusDataTableRow" },
 						{ "$ref": "#/definitions/ProteusLength" },
 						{ "$ref": "#/definitions/ProteusMapIndex" },
 						{ "$ref": "#/definitions/ProteusValue" }
@@ -1047,6 +1054,7 @@ var definitions = {
 						{ "type": "number" },
 						{ "type": "boolean" },
 						{ "type": "null" },
+						{ "$ref": "#/definitions/ProteusDataTableRow" },
 						{ "$ref": "#/definitions/ProteusLength" },
 						{ "$ref": "#/definitions/ProteusMapIndex" },
 						{ "$ref": "#/definitions/ProteusValue" }
@@ -1301,6 +1309,7 @@ var definitions = {
 			{ "$ref": "#/definitions/ProteusChart" },
 			{ "$ref": "#/definitions/ProteusConcat" },
 			{ "$ref": "#/definitions/ProteusDataTable" },
+			{ "$ref": "#/definitions/ProteusDataTableRow" },
 			{ "$ref": "#/definitions/ProteusDateInput" },
 			{ "$ref": "#/definitions/ProteusDisclosure" },
 			{ "$ref": "#/definitions/ProteusDisclosureContent" },
@@ -1491,6 +1500,7 @@ var definitions = {
 	},
 	"ProteusExpression": {
 		"anyOf": [
+			{ "$ref": "#/definitions/ProteusDataTableRow" },
 			{ "$ref": "#/definitions/ProteusLength" },
 			{ "$ref": "#/definitions/ProteusMap" },
 			{ "$ref": "#/definitions/ProteusMapIndex" },
@@ -2511,6 +2521,10 @@ var definitions = {
 							"description": "Key in data objects",
 							"type": "string"
 						},
+						"cell": {
+							"$ref": "#/definitions/ProteusNode",
+							"description": "A Proteus node template rendered for each cell in this column. Read the current row with DataTableRow (e.g. { $type: 'DataTableRow', path: 'status' } reads the row's 'status', or omit 'path' for the whole row). Can be a single element or an array — use Show elements to conditionally render (e.g. a Badge whose intent depends on the row value). When set, takes precedence over 'format'."
+						},
 						"format": {
 							"anyOf": [{
 								"description": "Formatter name",
@@ -2553,6 +2567,21 @@ var definitions = {
 		"required": ["$type"],
 		"type": "object"
 	},
+	"ProteusDataTableRow": {
+		"examples": [{
+			"$type": "DataTableRow",
+			"path": "status"
+		}],
+		"properties": {
+			"$type": { "const": "DataTableRow" },
+			"path": {
+				"description": "JSON pointer path to a field within the current row (e.g. 'status' or '/status'). When omitted, resolves to the whole row object. Only meaningful inside a DataTable column's `cell`.",
+				"type": "string"
+			}
+		},
+		"required": ["$type"],
+		"type": "object"
+	},
 	"ProteusDateInput": {
 		"examples": [{
 			"$type": "DateInput",
@@ -4285,6 +4314,10 @@ var definitions = {
 				"$ref": "#/definitions/ProteusNode",
 				"description": "Content to show when condition is true"
 			},
+			"else": {
+				"$ref": "#/definitions/ProteusNode",
+				"description": "Content to render when the condition is false. Omitting it renders nothing. Chain nested Show/else to express multi-way choices (e.g. mapping a value to one of several outputs)."
+			},
 			"when": {
 				"anyOf": [{ "$ref": "#/definitions/ProteusCondition" }, {
 					"items": { "$ref": "#/definitions/ProteusCondition" },

package/dist/index.d.ts

@@ -64,6 +64,21 @@ declare namespace ProteusChart {
   var displayName: string;
 }
 //#endregion
+//#region src/proteus-data-table-row/ProteusDataTableRow.d.ts
+type ProteusDataTableRowProps = {
+  /**
+   * JSON pointer path to a field within the current row (e.g. `type` or
+   * `/type`). When omitted, resolves to the whole row object.
+   */
+  path?: string;
+};
+declare function ProteusDataTableRow({
+  path
+}: ProteusDataTableRowProps): string | null;
+declare namespace ProteusDataTableRow {
+  var displayName: string;
+}
+//#endregion
 //#region src/proteus-data-table/ProteusDataTable.d.ts
 type ProteusDataTableProps = {
   /**
@@ -77,6 +92,12 @@ type ProteusDataTableProps = {
 };
 type ColumnDef = {
   accessorKey: string;
+  /**
+   * Renders a cell for this column from the row's data. When set, takes
+   * precedence over `format`. Wired up from a Proteus `cell` template by
+   * `ProteusElement`.
+   */
+  cell?: (row: Record<string, unknown>) => ReactNode;
   format?: string | {
     options?: Record<string, unknown>;
     type: string;
@@ -348,6 +369,9 @@ type ProteusCondition = {
   or: ProteusCondition[];
 };
 type ComparisonValue = boolean | null | number | string | {
+  $type: "DataTableRow";
+  path?: string;
+} | {
   $type: "Length";
   path: string;
 } | {
@@ -360,6 +384,10 @@ type ComparisonValue = boolean | null | number | string | {
 //#region src/proteus-show/ProteusShow.d.ts
 type ProteusShowProps = {
   children?: ReactNode;
+  /**
+   * Content to render when the condition is false. Omitting it renders nothing.
+   */
+  else?: ReactNode;
   /**
    * Single condition or array of conditions (AND logic). Each condition is an
    * object with one operator key.
@@ -368,8 +396,9 @@ type ProteusShowProps = {
 };
 declare function ProteusShow({
   children,
+  else: fallback,
   when
-}: ProteusShowProps): import("react/jsx-runtime").JSX.Element | null;
+}: ProteusShowProps): import("react/jsx-runtime").JSX.Element;
 declare namespace ProteusShow {
   var displayName: string;
 }
@@ -664,4 +693,4 @@ declare namespace ProteusTextarea {
 //#region src/use-proteus-value/useProteusValue.d.ts
 declare function useProteusValue(element: ProteusValueProps): any;
 //#endregion
-export { type FileUploadMetadata, ProteusAction, ProteusBridge, ProteusChart, ProteusDataTable, ProteusDateInput, ProteusDocumentRenderer, ProteusDocumentRendererProps, ProteusDocumentShell, ProteusDocumentShellProps, ProteusFederated, ProteusFileUpload, ProteusFileUploadProps, ProteusImage, ProteusImageCarousel, ProteusInput, ProteusLength, ProteusMap, ProteusMapIndex, ProteusMarkdown, ProteusPillMenu, ProteusPillMenuProps, type ProteusPreviewFile, ProteusRichTextEditor, ProteusSelect, ProteusShow, ProteusTextarea, type StructuredMessage, type UploadFile, safeParseDocument, useProteusValue };
+export { type FileUploadMetadata, ProteusAction, ProteusBridge, ProteusChart, ProteusDataTable, ProteusDataTableRow, ProteusDateInput, ProteusDocumentRenderer, ProteusDocumentRendererProps, ProteusDocumentShell, ProteusDocumentShellProps, ProteusFederated, ProteusFileUpload, ProteusFileUploadProps, ProteusImage, ProteusImageCarousel, ProteusInput, ProteusLength, ProteusMap, ProteusMapIndex, ProteusMarkdown, ProteusPillMenu, ProteusPillMenuProps, type ProteusPreviewFile, ProteusRichTextEditor, ProteusSelect, ProteusShow, ProteusTextarea, type StructuredMessage, type UploadFile, safeParseDocument, useProteusValue };

package/package.json

@@ -7,7 +7,7 @@
     "url": "git+https://github.com/optimizely-axiom/optiaxiom.git"
   },
   "type": "module",
-  "version": "3.1.0",
+  "version": "3.2.0",
   "files": [
     "dist/**",
     "LICENSE"
@@ -41,8 +41,8 @@
     "react-markdown": "^10.1.0",
     "recharts": "^3.8.1",
     "remark-gfm": "^4.0.1",
-    "@optiaxiom/icons": "^1.3.0",
-    "@optiaxiom/react": "^3.1.4"
+    "@optiaxiom/react": "^3.1.4",
+    "@optiaxiom/icons": "^1.3.0"
   },
   "devDependencies": {
     "@emotion/hash": "^0.9.2",