@almadar/ui 5.133.0 → 5.135.0

package/dist/lib/drawable/three/index.cjs

@@ -186,6 +186,7 @@ function collectDrawnItems(nodes) {
       case "draw-sprite":
       case "draw-shape":
       case "draw-text":
+      case "draw-group":
         if (isValidScenePos(n.position)) out.push({ pos: n.position, id: n.id });
         break;
       case "draw-sprite-layer":
@@ -794,6 +795,13 @@ function ModelLoader({
     }
   );
 }
+var mesh3dLog = logger.createLogger("almadar:ui:drawable-3d");
+var warnedUnsupported = /* @__PURE__ */ new Set();
+var warnUnsupported3d = (kind) => {
+  if (warnedUnsupported.has(kind)) return;
+  warnedUnsupported.add(kind);
+  mesh3dLog.warn("unsupported drawable kind on the 3D backend \u2014 skipped", { kind });
+};
 var CrossOriginTextureLoader = class extends THREE9__namespace.TextureLoader {
   constructor() {
     super();
@@ -966,6 +974,10 @@ function Shape3D({ node, projector }) {
       geometry = /* @__PURE__ */ jsxRuntime.jsx("shapeGeometry", { args: [s] });
       break;
     }
+    case "path": {
+      warnUnsupported3d("draw-shape:path");
+      return null;
+    }
     default:
       return null;
   }
@@ -1004,6 +1016,9 @@ function Drawable3D({ node, projector }) {
       return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: node.items.map((item, i) => /* @__PURE__ */ jsxRuntime.jsx(Shape3D, { node: item, projector }, i)) });
     case "draw-text-layer":
       return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: node.items.map((item, i) => /* @__PURE__ */ jsxRuntime.jsx(Text3D, { node: item, projector }, i)) });
+    case "draw-group":
+      warnUnsupported3d("draw-group");
+      return null;
   }
 }
 
@@ -2795,6 +2810,53 @@ var Box = React3__default.default.forwardRef(
   }
 );
 Box.displayName = "Box";
+
+// lib/format.ts
+function formatDate(value) {
+  if (!value) return "";
+  const d = new Date(String(value));
+  if (isNaN(d.getTime())) return String(value);
+  return d.toLocaleDateString(void 0, { year: "numeric", month: "short", day: "numeric" });
+}
+function formatTime(value) {
+  if (!value) return "";
+  const d = new Date(String(value));
+  if (isNaN(d.getTime())) return String(value);
+  return d.toLocaleTimeString(void 0, { hour: "numeric", minute: "2-digit" });
+}
+function formatDateTime(value) {
+  if (!value) return "";
+  const d = new Date(String(value));
+  if (isNaN(d.getTime())) return String(value);
+  return `${formatDate(value)} ${formatTime(value)}`;
+}
+function asYesNo(value) {
+  return value === false || value === 0 || String(value) === "false" ? "No" : "Yes";
+}
+function formatValue(value, format) {
+  if (value === void 0 || value === null) return "";
+  if (typeof value === "boolean") return asYesNo(value);
+  switch (format) {
+    case "date":
+      return formatDate(value);
+    case "time":
+      return formatTime(value);
+    case "datetime":
+      return formatDateTime(value);
+    case "currency":
+      return typeof value === "number" ? `$${value.toFixed(2)}` : String(value);
+    case "number":
+      return typeof value === "number" ? value.toLocaleString() : String(value);
+    case "percent":
+      return typeof value === "number" ? `${Math.round(value)}%` : String(value);
+    case "boolean":
+      return asYesNo(value);
+    default:
+      return String(value);
+  }
+}
+
+// components/core/atoms/Typography.tsx
 var variantStyles = {
   h1: "text-4xl font-bold tracking-tight text-foreground",
   h2: "text-3xl font-bold tracking-tight text-foreground",
@@ -2882,11 +2944,16 @@ var Typography = ({
   id,
   className,
   style,
+  format,
   content,
   children
 }) => {
   const variant = variantProp ?? (level ? `h${level}` : "body1");
   const Component2 = as || defaultElements[variant];
+  let body = children ?? content;
+  if (format !== void 0 && format !== "none" && (typeof body === "string" || typeof body === "number" || body instanceof Date)) {
+    body = formatValue(body, format);
+  }
   return React3__default.default.createElement(
     Component2,
     {
@@ -2903,7 +2970,7 @@ var Typography = ({
       ),
       style
     },
-    children ?? content
+    body
   );
 };
 Typography.displayName = "Typography";

package/dist/lib/drawable/three/index.d.cts

@@ -3,7 +3,7 @@ import React__default, { Component, ReactNode, ErrorInfo } from 'react';
 import { ScenePos, EventEmit, JsonObject, OrbitalSchema } from '@almadar/core';
 import * as THREE from 'three';
 import { QuadraticBezierCurve3 } from 'three';
-import { D as DrawableNode } from '../../../paintDispatch-BXJgISot.cjs';
+import { D as DrawableNode } from '../../../paintDispatch-Bl2sfRFb.cjs';
 import { OrbitControls } from 'three/examples/jsm/controls/OrbitControls.js';
 import { I as IsometricTile, a as IsometricUnit, b as IsometricFeature, A as ApplicationLevelData, O as OrbitalLevelData, T as TraitLevelData, c as TransitionLevelData } from '../../../avl-schema-parser-B8Onmfsu.cjs';
 export { U as UnitAnimationState } from '../../../avl-schema-parser-B8Onmfsu.cjs';

package/dist/lib/drawable/three/index.d.ts

@@ -3,7 +3,7 @@ import React__default, { Component, ReactNode, ErrorInfo } from 'react';
 import { ScenePos, EventEmit, JsonObject, OrbitalSchema } from '@almadar/core';
 import * as THREE from 'three';
 import { QuadraticBezierCurve3 } from 'three';
-import { D as DrawableNode } from '../../../paintDispatch-BXJgISot.js';
+import { D as DrawableNode } from '../../../paintDispatch-Bl2sfRFb.js';
 import { OrbitControls } from 'three/examples/jsm/controls/OrbitControls.js';
 import { I as IsometricTile, a as IsometricUnit, b as IsometricFeature, A as ApplicationLevelData, O as OrbitalLevelData, T as TraitLevelData, c as TransitionLevelData } from '../../../avl-schema-parser-B8Onmfsu.js';
 export { U as UnitAnimationState } from '../../../avl-schema-parser-B8Onmfsu.js';

package/dist/lib/drawable/three/index.js

@@ -162,6 +162,7 @@ function collectDrawnItems(nodes) {
       case "draw-sprite":
       case "draw-shape":
       case "draw-text":
+      case "draw-group":
         if (isValidScenePos(n.position)) out.push({ pos: n.position, id: n.id });
         break;
       case "draw-sprite-layer":
@@ -770,6 +771,13 @@ function ModelLoader({
     }
   );
 }
+var mesh3dLog = createLogger("almadar:ui:drawable-3d");
+var warnedUnsupported = /* @__PURE__ */ new Set();
+var warnUnsupported3d = (kind) => {
+  if (warnedUnsupported.has(kind)) return;
+  warnedUnsupported.add(kind);
+  mesh3dLog.warn("unsupported drawable kind on the 3D backend \u2014 skipped", { kind });
+};
 var CrossOriginTextureLoader = class extends THREE9.TextureLoader {
   constructor() {
     super();
@@ -942,6 +950,10 @@ function Shape3D({ node, projector }) {
       geometry = /* @__PURE__ */ jsx("shapeGeometry", { args: [s] });
       break;
     }
+    case "path": {
+      warnUnsupported3d("draw-shape:path");
+      return null;
+    }
     default:
       return null;
   }
@@ -980,6 +992,9 @@ function Drawable3D({ node, projector }) {
       return /* @__PURE__ */ jsx(Fragment, { children: node.items.map((item, i) => /* @__PURE__ */ jsx(Shape3D, { node: item, projector }, i)) });
     case "draw-text-layer":
       return /* @__PURE__ */ jsx(Fragment, { children: node.items.map((item, i) => /* @__PURE__ */ jsx(Text3D, { node: item, projector }, i)) });
+    case "draw-group":
+      warnUnsupported3d("draw-group");
+      return null;
   }
 }
 
@@ -2771,6 +2786,53 @@ var Box = React3.forwardRef(
   }
 );
 Box.displayName = "Box";
+
+// lib/format.ts
+function formatDate(value) {
+  if (!value) return "";
+  const d = new Date(String(value));
+  if (isNaN(d.getTime())) return String(value);
+  return d.toLocaleDateString(void 0, { year: "numeric", month: "short", day: "numeric" });
+}
+function formatTime(value) {
+  if (!value) return "";
+  const d = new Date(String(value));
+  if (isNaN(d.getTime())) return String(value);
+  return d.toLocaleTimeString(void 0, { hour: "numeric", minute: "2-digit" });
+}
+function formatDateTime(value) {
+  if (!value) return "";
+  const d = new Date(String(value));
+  if (isNaN(d.getTime())) return String(value);
+  return `${formatDate(value)} ${formatTime(value)}`;
+}
+function asYesNo(value) {
+  return value === false || value === 0 || String(value) === "false" ? "No" : "Yes";
+}
+function formatValue(value, format) {
+  if (value === void 0 || value === null) return "";
+  if (typeof value === "boolean") return asYesNo(value);
+  switch (format) {
+    case "date":
+      return formatDate(value);
+    case "time":
+      return formatTime(value);
+    case "datetime":
+      return formatDateTime(value);
+    case "currency":
+      return typeof value === "number" ? `$${value.toFixed(2)}` : String(value);
+    case "number":
+      return typeof value === "number" ? value.toLocaleString() : String(value);
+    case "percent":
+      return typeof value === "number" ? `${Math.round(value)}%` : String(value);
+    case "boolean":
+      return asYesNo(value);
+    default:
+      return String(value);
+  }
+}
+
+// components/core/atoms/Typography.tsx
 var variantStyles = {
   h1: "text-4xl font-bold tracking-tight text-foreground",
   h2: "text-3xl font-bold tracking-tight text-foreground",
@@ -2858,11 +2920,16 @@ var Typography = ({
   id,
   className,
   style,
+  format,
   content,
   children
 }) => {
   const variant = variantProp ?? (level ? `h${level}` : "body1");
   const Component2 = as || defaultElements[variant];
+  let body = children ?? content;
+  if (format !== void 0 && format !== "none" && (typeof body === "string" || typeof body === "number" || body instanceof Date)) {
+    body = formatValue(body, format);
+  }
   return React3.createElement(
     Component2,
     {
@@ -2879,7 +2946,7 @@ var Typography = ({
       ),
       style
     },
-    children ?? content
+    body
   );
 };
 Typography.displayName = "Typography";

package/dist/lib/index.cjs

@@ -790,6 +790,83 @@ function clearVerification() {
 }
 exposeOnWindow();
 
+// lib/format.ts
+function humanizeFieldName(name) {
+  return name.replace(/([a-z])([A-Z])/g, "$1 $2").replace(/([A-Z]+)([A-Z][a-z])/g, "$1 $2").replace(/[_-]/g, " ").replace(/\b\w/g, (c) => c.toUpperCase()).replace(/\b([A-Z])([A-Z]+)\b/g, (_, first, rest) => first + rest.toLowerCase()).trim();
+}
+function humanizeEnumValue(value) {
+  return /^[a-z0-9]+(?:[_-][a-z0-9]+)+$/.test(value) ? humanizeFieldName(value) : value;
+}
+function formatDate(value) {
+  if (!value) return "";
+  const d = new Date(String(value));
+  if (isNaN(d.getTime())) return String(value);
+  return d.toLocaleDateString(void 0, { year: "numeric", month: "short", day: "numeric" });
+}
+function formatTime(value) {
+  if (!value) return "";
+  const d = new Date(String(value));
+  if (isNaN(d.getTime())) return String(value);
+  return d.toLocaleTimeString(void 0, { hour: "numeric", minute: "2-digit" });
+}
+function formatDateTime(value) {
+  if (!value) return "";
+  const d = new Date(String(value));
+  if (isNaN(d.getTime())) return String(value);
+  return `${formatDate(value)} ${formatTime(value)}`;
+}
+function asYesNo(value) {
+  return value === false || value === 0 || String(value) === "false" ? "No" : "Yes";
+}
+function formatValue(value, format) {
+  if (value === void 0 || value === null) return "";
+  if (typeof value === "boolean") return asYesNo(value);
+  switch (format) {
+    case "date":
+      return formatDate(value);
+    case "time":
+      return formatTime(value);
+    case "datetime":
+      return formatDateTime(value);
+    case "currency":
+      return typeof value === "number" ? `$${value.toFixed(2)}` : String(value);
+    case "number":
+      return typeof value === "number" ? value.toLocaleString() : String(value);
+    case "percent":
+      return typeof value === "number" ? `${Math.round(value)}%` : String(value);
+    case "boolean":
+      return asYesNo(value);
+    default:
+      return String(value);
+  }
+}
+function compareCellValues(a, b) {
+  const aEmpty = a === null || a === void 0 || a === "";
+  const bEmpty = b === null || b === void 0 || b === "";
+  if (aEmpty || bEmpty) return aEmpty && bEmpty ? 0 : aEmpty ? 1 : -1;
+  if (typeof a === "number" && typeof b === "number") return a - b;
+  if (typeof a === "boolean" && typeof b === "boolean") return Number(a) - Number(b);
+  const aNum = Number(a);
+  const bNum = Number(b);
+  if (Number.isFinite(aNum) && Number.isFinite(bNum)) return aNum - bNum;
+  const aTime = dateLikeTime(a);
+  const bTime = dateLikeTime(b);
+  if (aTime !== null && bTime !== null) return aTime - bTime;
+  return String(a).localeCompare(String(b));
+}
+function dateLikeTime(value) {
+  if (value instanceof Date) return value.getTime();
+  const text = String(value);
+  if (!/\d/.test(text) || !/[-/:T]/.test(text)) return null;
+  const time = Date.parse(text);
+  return Number.isNaN(time) ? null : time;
+}
+function sortRows(rows, field, direction = "asc") {
+  if (!field) return rows;
+  const dir = direction === "desc" ? -1 : 1;
+  return [...rows].sort((a, b) => dir * compareCellValues(a?.[field], b?.[field]));
+}
+
 // lib/getNestedValue.ts
 function getNestedValue(obj, path) {
   if (obj === null || obj === void 0 || !path) {
@@ -1863,6 +1940,7 @@ exports.clearTicks = clearTicks;
 exports.clearTraits = clearTraits;
 exports.clearVerification = clearVerification;
 exports.cn = cn;
+exports.compareCellValues = compareCellValues;
 exports.computeJazariLayout = computeJazariLayout;
 exports.debug = debug;
 exports.debugCollision = debugCollision;
@@ -1879,8 +1957,12 @@ exports.debugWarn = debugWarn;
 exports.eightPointedStarPath = eightPointedStarPath;
 exports.extractOutputsFromTransitions = extractOutputsFromTransitions;
 exports.extractStateMachine = extractStateMachine;
+exports.formatDate = formatDate;
+exports.formatDateTime = formatDateTime;
 exports.formatGuard = formatGuard;
 exports.formatNestedFieldLabel = formatNestedFieldLabel;
+exports.formatTime = formatTime;
+exports.formatValue = formatValue;
 exports.gearTeethPath = gearTeethPath;
 exports.getAllChecks = getAllChecks;
 exports.getAllTicks = getAllTicks;
@@ -1905,6 +1987,8 @@ exports.getTrait = getTrait;
 exports.getTraitSnapshots = getTraitSnapshots;
 exports.getTransitions = getTransitions;
 exports.getTransitionsForTrait = getTransitionsForTrait;
+exports.humanizeEnumValue = humanizeEnumValue;
+exports.humanizeFieldName = humanizeFieldName;
 exports.initDebugShortcut = initDebugShortcut;
 exports.isDebugEnabled = isDebugEnabled;
 exports.lockIconPath = lockIconPath;
@@ -1931,6 +2015,7 @@ exports.renderStateMachineToSvg = renderStateMachineToSvg;
 exports.setDebugEnabled = setDebugEnabled;
 exports.setEntityProvider = setEntityProvider;
 exports.setTickActive = setTickActive;
+exports.sortRows = sortRows;
 exports.subscribeToDebugEvents = subscribeToDebugEvents;
 exports.subscribeToGuardChanges = subscribeToGuardChanges;
 exports.subscribeToTickChanges = subscribeToTickChanges;

package/dist/lib/index.d.cts

@@ -1,7 +1,7 @@
-export { C as ContentSegment, D as DEFAULT_CONFIG, a as DomEntityBox, b as DomLayoutData, c as DomOutputsBox, d as DomStateNode, e as DomTransitionLabel, f as DomTransitionPath, E as EntityDefinition, R as RenderOptions, S as StateDefinition, g as StateMachineDefinition, T as TraitSnapshotGetter, h as TransitionDefinition, V as VisualizerConfig, i as bindCanvasCapture, j as bindEventBus, k as bindLastDrawables, l as bindTraitStateGetter, m as clearVerification, n as cn, o as extractOutputsFromTransitions, p as extractStateMachine, q as formatGuard, r as getAllChecks, s as getBridgeHealth, t as getEffectSummary, u as getSnapshot, v as getSummary, w as getTraitSnapshots, x as getTransitions, y as getTransitionsForTrait, z as parseContentSegments, A as parseMarkdownWithCodeBlocks, B as recordServerResponse, F as recordTransition, G as registerCheck, H as registerTraitSnapshot, I as renderStateMachineToDomData, J as renderStateMachineToSvg, K as subscribeToVerification, L as updateAssetStatus, M as updateBridgeHealth, N as updateCheck, O as waitForTransition } from '../cn-D3H9UzCW.cjs';
+export { C as ContentSegment, D as DEFAULT_CONFIG, a as DomEntityBox, b as DomLayoutData, c as DomOutputsBox, d as DomStateNode, e as DomTransitionLabel, f as DomTransitionPath, E as EntityDefinition, R as RenderOptions, S as StateDefinition, g as StateMachineDefinition, T as TraitSnapshotGetter, h as TransitionDefinition, V as VisualizerConfig, i as bindCanvasCapture, j as bindEventBus, k as bindLastDrawables, l as bindTraitStateGetter, m as clearVerification, n as cn, o as extractOutputsFromTransitions, p as extractStateMachine, q as formatGuard, r as getAllChecks, s as getBridgeHealth, t as getEffectSummary, u as getSnapshot, v as getSummary, w as getTraitSnapshots, x as getTransitions, y as getTransitionsForTrait, z as parseContentSegments, A as parseMarkdownWithCodeBlocks, B as recordServerResponse, F as recordTransition, G as registerCheck, H as registerTraitSnapshot, I as renderStateMachineToDomData, J as renderStateMachineToSvg, K as subscribeToVerification, L as updateAssetStatus, M as updateBridgeHealth, N as updateCheck, O as waitForTransition } from '../cn-B8GXqrtp.cjs';
 import { FieldValue, EntityRow, EventPayload } from '@almadar/core';
 export { AssetLoadStatus, BridgeHealth, CheckStatus, EffectTrace, EventLogEntry, OrbitalVerificationAPI, ServerResponseTrace, TraitStateSnapshot, TransitionTrace, VerificationCheck, VerificationSnapshot, VerificationSummary } from '@almadar/core';
-import '../paintDispatch-BXJgISot.cjs';
+import '../paintDispatch-Bl2sfRFb.cjs';
 import 'clsx';
 
 /**
@@ -283,6 +283,53 @@ declare function onDebugToggle(listener: DebugToggleListener): () => void;
  */
 declare function initDebugShortcut(): () => void;
 
+/**
+ * Shared field-name + value formatting — the single owner of the humanize and
+ * format vocabulary previously duplicated across DataTable, DataGrid, CardGrid,
+ * DataList, TableView, DetailPanel, List, and UISlotRenderer.
+ */
+
+type ValueFormat = 'none' | 'date' | 'time' | 'datetime' | 'number' | 'currency' | 'percent' | 'boolean';
+/**
+ * Convert a camelCase, PascalCase, ALLCAPS, snake_case, or kebab-case field
+ * name to a human-readable header: "estimatedDelivery" → "Estimated Delivery",
+ * "PURCHASEPRICE" → "Purchase Price", "is_active" → "Is Active".
+ */
+declare function humanizeFieldName(name: string): string;
+/**
+ * Badge/label-position enum values: a lowercase token chain joined by `_` or
+ * `-` renders as spaced Title Case ("checked_in" → "Checked In"). Any other
+ * shape (ids, emails, mixed case, single words) passes through unchanged —
+ * a stated formatting contract, applied only where call sites opt in.
+ */
+declare function humanizeEnumValue(value: string): string;
+declare function formatDate(value: FieldValue | undefined): string;
+declare function formatTime(value: FieldValue | undefined): string;
+declare function formatDateTime(value: FieldValue | undefined): string;
+/**
+ * Format a field value for display. Booleans always render Yes/No regardless
+ * of the declared format (a raw `true`/`false` cell is never intended output).
+ */
+declare function formatValue(value: FieldValue | undefined, format?: string): string;
+/** Sort direction for {@link sortRows}. */
+type SortDirection = 'asc' | 'desc';
+/**
+ * Order two cell values by their own type, never by what the field is called.
+ *
+ * Numbers compare numerically, date-like strings chronologically, everything
+ * else by locale string order. `null`/`undefined` sort last in both directions
+ * so empty cells never displace real data at the top of a list.
+ */
+declare function compareCellValues(a: FieldValue | undefined, b: FieldValue | undefined): number;
+/**
+ * Return a new array ordered by `field`. Non-mutating, and a no-op without a
+ * field so callers can pass the prop through unconditionally.
+ *
+ * NOTE: this orders only the rows already fetched. A collection larger than its
+ * `limit` still needs ordering at the data layer — see `L-NO-COLLECTION-ORDERING`.
+ */
+declare function sortRows<T extends Record<string, FieldValue | undefined>>(rows: readonly T[], field?: string, direction?: SortDirection): readonly T[];
+
 /**
  * Get Nested Value Utility
  *
@@ -502,4 +549,4 @@ declare function eightPointedStarPath(cx: number, cy: number, outerR: number, in
  */
 declare function arrowheadPath(size: number): string;
 
-export { ApiError, type DebugEvent, type DebugEventType, type EntitySnapshot, type EntityState, type GuardContext, type GuardEvaluation, JAZARI_COLORS, type JazariArmLayout, type JazariEffectInfo, type JazariGearLayout, type JazariGuardInfo, type JazariLayout, type LayoutInput, type LayoutState, type LayoutTransition, type PersistentEntityInfo, type RuntimeEntity, type TickExecution, type TraitDebugInfo, type TraitGuard, type TraitTransition, apiClient, arrowheadPath, brainIconPath, clearDebugEvents, clearEntityProvider, clearGuardHistory, clearTicks, clearTraits, computeJazariLayout, debug, debugCollision, debugError, debugGameState, debugGroup, debugGroupEnd, debugInput, debugPhysics, debugTable, debugTime, debugTimeEnd, debugWarn, eightPointedStarPath, formatNestedFieldLabel, gearTeethPath, getAllTicks, getAllTraits, getDebugEvents, getEntitiesByType, getEntityById, getEntitySnapshot, getEventsBySource, getEventsByType, getGuardEvaluationsForTrait, getGuardHistory, getNestedValue, getRecentEvents, getRecentGuardEvaluations, getTick, getTrait, initDebugShortcut, isDebugEnabled, lockIconPath, logDebugEvent, logEffectExecuted, logError, logEventFired, logInfo, logStateChange, logWarning, onDebugToggle, pipeIconPath, recordGuardEvaluation, registerTick, registerTrait, setDebugEnabled, setEntityProvider, setTickActive, subscribeToDebugEvents, subscribeToGuardChanges, subscribeToTickChanges, subscribeToTraitChanges, toggleDebug, unregisterTick, unregisterTrait, updateGuardResult, updateTickExecution, updateTraitState };
+export { ApiError, type DebugEvent, type DebugEventType, type EntitySnapshot, type EntityState, type GuardContext, type GuardEvaluation, JAZARI_COLORS, type JazariArmLayout, type JazariEffectInfo, type JazariGearLayout, type JazariGuardInfo, type JazariLayout, type LayoutInput, type LayoutState, type LayoutTransition, type PersistentEntityInfo, type RuntimeEntity, type SortDirection, type TickExecution, type TraitDebugInfo, type TraitGuard, type TraitTransition, type ValueFormat, apiClient, arrowheadPath, brainIconPath, clearDebugEvents, clearEntityProvider, clearGuardHistory, clearTicks, clearTraits, compareCellValues, computeJazariLayout, debug, debugCollision, debugError, debugGameState, debugGroup, debugGroupEnd, debugInput, debugPhysics, debugTable, debugTime, debugTimeEnd, debugWarn, eightPointedStarPath, formatDate, formatDateTime, formatNestedFieldLabel, formatTime, formatValue, gearTeethPath, getAllTicks, getAllTraits, getDebugEvents, getEntitiesByType, getEntityById, getEntitySnapshot, getEventsBySource, getEventsByType, getGuardEvaluationsForTrait, getGuardHistory, getNestedValue, getRecentEvents, getRecentGuardEvaluations, getTick, getTrait, humanizeEnumValue, humanizeFieldName, initDebugShortcut, isDebugEnabled, lockIconPath, logDebugEvent, logEffectExecuted, logError, logEventFired, logInfo, logStateChange, logWarning, onDebugToggle, pipeIconPath, recordGuardEvaluation, registerTick, registerTrait, setDebugEnabled, setEntityProvider, setTickActive, sortRows, subscribeToDebugEvents, subscribeToGuardChanges, subscribeToTickChanges, subscribeToTraitChanges, toggleDebug, unregisterTick, unregisterTrait, updateGuardResult, updateTickExecution, updateTraitState };

package/dist/lib/index.d.ts

@@ -1,7 +1,7 @@
-export { C as ContentSegment, D as DEFAULT_CONFIG, a as DomEntityBox, b as DomLayoutData, c as DomOutputsBox, d as DomStateNode, e as DomTransitionLabel, f as DomTransitionPath, E as EntityDefinition, R as RenderOptions, S as StateDefinition, g as StateMachineDefinition, T as TraitSnapshotGetter, h as TransitionDefinition, V as VisualizerConfig, i as bindCanvasCapture, j as bindEventBus, k as bindLastDrawables, l as bindTraitStateGetter, m as clearVerification, n as cn, o as extractOutputsFromTransitions, p as extractStateMachine, q as formatGuard, r as getAllChecks, s as getBridgeHealth, t as getEffectSummary, u as getSnapshot, v as getSummary, w as getTraitSnapshots, x as getTransitions, y as getTransitionsForTrait, z as parseContentSegments, A as parseMarkdownWithCodeBlocks, B as recordServerResponse, F as recordTransition, G as registerCheck, H as registerTraitSnapshot, I as renderStateMachineToDomData, J as renderStateMachineToSvg, K as subscribeToVerification, L as updateAssetStatus, M as updateBridgeHealth, N as updateCheck, O as waitForTransition } from '../cn-Dm0VrLRG.js';
+export { C as ContentSegment, D as DEFAULT_CONFIG, a as DomEntityBox, b as DomLayoutData, c as DomOutputsBox, d as DomStateNode, e as DomTransitionLabel, f as DomTransitionPath, E as EntityDefinition, R as RenderOptions, S as StateDefinition, g as StateMachineDefinition, T as TraitSnapshotGetter, h as TransitionDefinition, V as VisualizerConfig, i as bindCanvasCapture, j as bindEventBus, k as bindLastDrawables, l as bindTraitStateGetter, m as clearVerification, n as cn, o as extractOutputsFromTransitions, p as extractStateMachine, q as formatGuard, r as getAllChecks, s as getBridgeHealth, t as getEffectSummary, u as getSnapshot, v as getSummary, w as getTraitSnapshots, x as getTransitions, y as getTransitionsForTrait, z as parseContentSegments, A as parseMarkdownWithCodeBlocks, B as recordServerResponse, F as recordTransition, G as registerCheck, H as registerTraitSnapshot, I as renderStateMachineToDomData, J as renderStateMachineToSvg, K as subscribeToVerification, L as updateAssetStatus, M as updateBridgeHealth, N as updateCheck, O as waitForTransition } from '../cn-CZq0uJLA.js';
 import { FieldValue, EntityRow, EventPayload } from '@almadar/core';
 export { AssetLoadStatus, BridgeHealth, CheckStatus, EffectTrace, EventLogEntry, OrbitalVerificationAPI, ServerResponseTrace, TraitStateSnapshot, TransitionTrace, VerificationCheck, VerificationSnapshot, VerificationSummary } from '@almadar/core';
-import '../paintDispatch-BXJgISot.js';
+import '../paintDispatch-Bl2sfRFb.js';
 import 'clsx';
 
 /**
@@ -283,6 +283,53 @@ declare function onDebugToggle(listener: DebugToggleListener): () => void;
  */
 declare function initDebugShortcut(): () => void;
 
+/**
+ * Shared field-name + value formatting — the single owner of the humanize and
+ * format vocabulary previously duplicated across DataTable, DataGrid, CardGrid,
+ * DataList, TableView, DetailPanel, List, and UISlotRenderer.
+ */
+
+type ValueFormat = 'none' | 'date' | 'time' | 'datetime' | 'number' | 'currency' | 'percent' | 'boolean';
+/**
+ * Convert a camelCase, PascalCase, ALLCAPS, snake_case, or kebab-case field
+ * name to a human-readable header: "estimatedDelivery" → "Estimated Delivery",
+ * "PURCHASEPRICE" → "Purchase Price", "is_active" → "Is Active".
+ */
+declare function humanizeFieldName(name: string): string;
+/**
+ * Badge/label-position enum values: a lowercase token chain joined by `_` or
+ * `-` renders as spaced Title Case ("checked_in" → "Checked In"). Any other
+ * shape (ids, emails, mixed case, single words) passes through unchanged —
+ * a stated formatting contract, applied only where call sites opt in.
+ */
+declare function humanizeEnumValue(value: string): string;
+declare function formatDate(value: FieldValue | undefined): string;
+declare function formatTime(value: FieldValue | undefined): string;
+declare function formatDateTime(value: FieldValue | undefined): string;
+/**
+ * Format a field value for display. Booleans always render Yes/No regardless
+ * of the declared format (a raw `true`/`false` cell is never intended output).
+ */
+declare function formatValue(value: FieldValue | undefined, format?: string): string;
+/** Sort direction for {@link sortRows}. */
+type SortDirection = 'asc' | 'desc';
+/**
+ * Order two cell values by their own type, never by what the field is called.
+ *
+ * Numbers compare numerically, date-like strings chronologically, everything
+ * else by locale string order. `null`/`undefined` sort last in both directions
+ * so empty cells never displace real data at the top of a list.
+ */
+declare function compareCellValues(a: FieldValue | undefined, b: FieldValue | undefined): number;
+/**
+ * Return a new array ordered by `field`. Non-mutating, and a no-op without a
+ * field so callers can pass the prop through unconditionally.
+ *
+ * NOTE: this orders only the rows already fetched. A collection larger than its
+ * `limit` still needs ordering at the data layer — see `L-NO-COLLECTION-ORDERING`.
+ */
+declare function sortRows<T extends Record<string, FieldValue | undefined>>(rows: readonly T[], field?: string, direction?: SortDirection): readonly T[];
+
 /**
  * Get Nested Value Utility
  *
@@ -502,4 +549,4 @@ declare function eightPointedStarPath(cx: number, cy: number, outerR: number, in
  */
 declare function arrowheadPath(size: number): string;
 
-export { ApiError, type DebugEvent, type DebugEventType, type EntitySnapshot, type EntityState, type GuardContext, type GuardEvaluation, JAZARI_COLORS, type JazariArmLayout, type JazariEffectInfo, type JazariGearLayout, type JazariGuardInfo, type JazariLayout, type LayoutInput, type LayoutState, type LayoutTransition, type PersistentEntityInfo, type RuntimeEntity, type TickExecution, type TraitDebugInfo, type TraitGuard, type TraitTransition, apiClient, arrowheadPath, brainIconPath, clearDebugEvents, clearEntityProvider, clearGuardHistory, clearTicks, clearTraits, computeJazariLayout, debug, debugCollision, debugError, debugGameState, debugGroup, debugGroupEnd, debugInput, debugPhysics, debugTable, debugTime, debugTimeEnd, debugWarn, eightPointedStarPath, formatNestedFieldLabel, gearTeethPath, getAllTicks, getAllTraits, getDebugEvents, getEntitiesByType, getEntityById, getEntitySnapshot, getEventsBySource, getEventsByType, getGuardEvaluationsForTrait, getGuardHistory, getNestedValue, getRecentEvents, getRecentGuardEvaluations, getTick, getTrait, initDebugShortcut, isDebugEnabled, lockIconPath, logDebugEvent, logEffectExecuted, logError, logEventFired, logInfo, logStateChange, logWarning, onDebugToggle, pipeIconPath, recordGuardEvaluation, registerTick, registerTrait, setDebugEnabled, setEntityProvider, setTickActive, subscribeToDebugEvents, subscribeToGuardChanges, subscribeToTickChanges, subscribeToTraitChanges, toggleDebug, unregisterTick, unregisterTrait, updateGuardResult, updateTickExecution, updateTraitState };
+export { ApiError, type DebugEvent, type DebugEventType, type EntitySnapshot, type EntityState, type GuardContext, type GuardEvaluation, JAZARI_COLORS, type JazariArmLayout, type JazariEffectInfo, type JazariGearLayout, type JazariGuardInfo, type JazariLayout, type LayoutInput, type LayoutState, type LayoutTransition, type PersistentEntityInfo, type RuntimeEntity, type SortDirection, type TickExecution, type TraitDebugInfo, type TraitGuard, type TraitTransition, type ValueFormat, apiClient, arrowheadPath, brainIconPath, clearDebugEvents, clearEntityProvider, clearGuardHistory, clearTicks, clearTraits, compareCellValues, computeJazariLayout, debug, debugCollision, debugError, debugGameState, debugGroup, debugGroupEnd, debugInput, debugPhysics, debugTable, debugTime, debugTimeEnd, debugWarn, eightPointedStarPath, formatDate, formatDateTime, formatNestedFieldLabel, formatTime, formatValue, gearTeethPath, getAllTicks, getAllTraits, getDebugEvents, getEntitiesByType, getEntityById, getEntitySnapshot, getEventsBySource, getEventsByType, getGuardEvaluationsForTrait, getGuardHistory, getNestedValue, getRecentEvents, getRecentGuardEvaluations, getTick, getTrait, humanizeEnumValue, humanizeFieldName, initDebugShortcut, isDebugEnabled, lockIconPath, logDebugEvent, logEffectExecuted, logError, logEventFired, logInfo, logStateChange, logWarning, onDebugToggle, pipeIconPath, recordGuardEvaluation, registerTick, registerTrait, setDebugEnabled, setEntityProvider, setTickActive, sortRows, subscribeToDebugEvents, subscribeToGuardChanges, subscribeToTickChanges, subscribeToTraitChanges, toggleDebug, unregisterTick, unregisterTrait, updateGuardResult, updateTickExecution, updateTraitState };

package/dist/lib/index.js

@@ -788,6 +788,83 @@ function clearVerification() {
 }
 exposeOnWindow();
 
+// lib/format.ts
+function humanizeFieldName(name) {
+  return name.replace(/([a-z])([A-Z])/g, "$1 $2").replace(/([A-Z]+)([A-Z][a-z])/g, "$1 $2").replace(/[_-]/g, " ").replace(/\b\w/g, (c) => c.toUpperCase()).replace(/\b([A-Z])([A-Z]+)\b/g, (_, first, rest) => first + rest.toLowerCase()).trim();
+}
+function humanizeEnumValue(value) {
+  return /^[a-z0-9]+(?:[_-][a-z0-9]+)+$/.test(value) ? humanizeFieldName(value) : value;
+}
+function formatDate(value) {
+  if (!value) return "";
+  const d = new Date(String(value));
+  if (isNaN(d.getTime())) return String(value);
+  return d.toLocaleDateString(void 0, { year: "numeric", month: "short", day: "numeric" });
+}
+function formatTime(value) {
+  if (!value) return "";
+  const d = new Date(String(value));
+  if (isNaN(d.getTime())) return String(value);
+  return d.toLocaleTimeString(void 0, { hour: "numeric", minute: "2-digit" });
+}
+function formatDateTime(value) {
+  if (!value) return "";
+  const d = new Date(String(value));
+  if (isNaN(d.getTime())) return String(value);
+  return `${formatDate(value)} ${formatTime(value)}`;
+}
+function asYesNo(value) {
+  return value === false || value === 0 || String(value) === "false" ? "No" : "Yes";
+}
+function formatValue(value, format) {
+  if (value === void 0 || value === null) return "";
+  if (typeof value === "boolean") return asYesNo(value);
+  switch (format) {
+    case "date":
+      return formatDate(value);
+    case "time":
+      return formatTime(value);
+    case "datetime":
+      return formatDateTime(value);
+    case "currency":
+      return typeof value === "number" ? `$${value.toFixed(2)}` : String(value);
+    case "number":
+      return typeof value === "number" ? value.toLocaleString() : String(value);
+    case "percent":
+      return typeof value === "number" ? `${Math.round(value)}%` : String(value);
+    case "boolean":
+      return asYesNo(value);
+    default:
+      return String(value);
+  }
+}
+function compareCellValues(a, b) {
+  const aEmpty = a === null || a === void 0 || a === "";
+  const bEmpty = b === null || b === void 0 || b === "";
+  if (aEmpty || bEmpty) return aEmpty && bEmpty ? 0 : aEmpty ? 1 : -1;
+  if (typeof a === "number" && typeof b === "number") return a - b;
+  if (typeof a === "boolean" && typeof b === "boolean") return Number(a) - Number(b);
+  const aNum = Number(a);
+  const bNum = Number(b);
+  if (Number.isFinite(aNum) && Number.isFinite(bNum)) return aNum - bNum;
+  const aTime = dateLikeTime(a);
+  const bTime = dateLikeTime(b);
+  if (aTime !== null && bTime !== null) return aTime - bTime;
+  return String(a).localeCompare(String(b));
+}
+function dateLikeTime(value) {
+  if (value instanceof Date) return value.getTime();
+  const text = String(value);
+  if (!/\d/.test(text) || !/[-/:T]/.test(text)) return null;
+  const time = Date.parse(text);
+  return Number.isNaN(time) ? null : time;
+}
+function sortRows(rows, field, direction = "asc") {
+  if (!field) return rows;
+  const dir = direction === "desc" ? -1 : 1;
+  return [...rows].sort((a, b) => dir * compareCellValues(a?.[field], b?.[field]));
+}
+
 // lib/getNestedValue.ts
 function getNestedValue(obj, path) {
   if (obj === null || obj === void 0 || !path) {
@@ -1844,4 +1921,4 @@ var JAZARI_COLORS = {
   darkBg: "#1a1a2e"
 };
 
-export { ApiError, DEFAULT_CONFIG, JAZARI_COLORS, apiClient, arrowheadPath, bindCanvasCapture, bindEventBus, bindLastDrawables, bindTraitStateGetter, brainIconPath, clearDebugEvents, clearEntityProvider, clearGuardHistory, clearTicks, clearTraits, clearVerification, cn, computeJazariLayout, debug, debugCollision, debugError, debugGameState, debugGroup, debugGroupEnd, debugInput, debugPhysics, debugTable, debugTime, debugTimeEnd, debugWarn, eightPointedStarPath, extractOutputsFromTransitions, extractStateMachine, formatGuard, formatNestedFieldLabel, gearTeethPath, getAllChecks, getAllTicks, getAllTraits, getBridgeHealth, getDebugEvents, getEffectSummary, getEntitiesByType, getEntityById, getEntitySnapshot, getEventsBySource, getEventsByType, getGuardEvaluationsForTrait, getGuardHistory, getNestedValue, getRecentEvents, getRecentGuardEvaluations, getSnapshot, getSummary, getTick, getTrait, getTraitSnapshots, getTransitions, getTransitionsForTrait, initDebugShortcut, isDebugEnabled, lockIconPath, logDebugEvent, logEffectExecuted, logError, logEventFired, logInfo, logStateChange, logWarning, onDebugToggle, parseContentSegments, parseMarkdownWithCodeBlocks, pipeIconPath, recordGuardEvaluation, recordServerResponse, recordTransition, registerCheck, registerTick, registerTrait, registerTraitSnapshot, renderStateMachineToDomData, renderStateMachineToSvg, setDebugEnabled, setEntityProvider, setTickActive, subscribeToDebugEvents, subscribeToGuardChanges, subscribeToTickChanges, subscribeToTraitChanges, subscribeToVerification, toggleDebug, unregisterTick, unregisterTrait, updateAssetStatus, updateBridgeHealth, updateCheck, updateGuardResult, updateTickExecution, updateTraitState, waitForTransition };
+export { ApiError, DEFAULT_CONFIG, JAZARI_COLORS, apiClient, arrowheadPath, bindCanvasCapture, bindEventBus, bindLastDrawables, bindTraitStateGetter, brainIconPath, clearDebugEvents, clearEntityProvider, clearGuardHistory, clearTicks, clearTraits, clearVerification, cn, compareCellValues, computeJazariLayout, debug, debugCollision, debugError, debugGameState, debugGroup, debugGroupEnd, debugInput, debugPhysics, debugTable, debugTime, debugTimeEnd, debugWarn, eightPointedStarPath, extractOutputsFromTransitions, extractStateMachine, formatDate, formatDateTime, formatGuard, formatNestedFieldLabel, formatTime, formatValue, gearTeethPath, getAllChecks, getAllTicks, getAllTraits, getBridgeHealth, getDebugEvents, getEffectSummary, getEntitiesByType, getEntityById, getEntitySnapshot, getEventsBySource, getEventsByType, getGuardEvaluationsForTrait, getGuardHistory, getNestedValue, getRecentEvents, getRecentGuardEvaluations, getSnapshot, getSummary, getTick, getTrait, getTraitSnapshots, getTransitions, getTransitionsForTrait, humanizeEnumValue, humanizeFieldName, initDebugShortcut, isDebugEnabled, lockIconPath, logDebugEvent, logEffectExecuted, logError, logEventFired, logInfo, logStateChange, logWarning, onDebugToggle, parseContentSegments, parseMarkdownWithCodeBlocks, pipeIconPath, recordGuardEvaluation, recordServerResponse, recordTransition, registerCheck, registerTick, registerTrait, registerTraitSnapshot, renderStateMachineToDomData, renderStateMachineToSvg, setDebugEnabled, setEntityProvider, setTickActive, sortRows, subscribeToDebugEvents, subscribeToGuardChanges, subscribeToTickChanges, subscribeToTraitChanges, subscribeToVerification, toggleDebug, unregisterTick, unregisterTrait, updateAssetStatus, updateBridgeHealth, updateCheck, updateGuardResult, updateTickExecution, updateTraitState, waitForTransition };