@zestl/zvolv-widgets 0.0.1 → 0.0.2

package/dist/index.cjs

@@ -1,28 +1,30 @@
 'use strict';
 
-var React13 = require('react');
+var React14 = require('react');
 var jsxRuntime = require('react/jsx-runtime');
-var dayjs8 = require('dayjs');
+var dayjs4 = require('dayjs');
 var utc = require('dayjs/plugin/utc.js');
 var weekOfYear = require('dayjs/plugin/weekOfYear.js');
 var _ = require('lodash');
+var timezone2 = require('dayjs/plugin/timezone.js');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
-var React13__default = /*#__PURE__*/_interopDefault(React13);
-var dayjs8__default = /*#__PURE__*/_interopDefault(dayjs8);
+var React14__default = /*#__PURE__*/_interopDefault(React14);
+var dayjs4__default = /*#__PURE__*/_interopDefault(dayjs4);
 var utc__default = /*#__PURE__*/_interopDefault(utc);
 var weekOfYear__default = /*#__PURE__*/_interopDefault(weekOfYear);
 var ___default = /*#__PURE__*/_interopDefault(_);
+var timezone2__default = /*#__PURE__*/_interopDefault(timezone2);
 
 // src/core/ZvolvProvider.tsx
-var RuntimeContext = React13.createContext(null);
+var RuntimeContext = React14.createContext(null);
 var ZvolvProvider = ({ runtime, children }) => {
-  const value = React13.useMemo(() => runtime, [runtime]);
+  const value = React14.useMemo(() => runtime, [runtime]);
   return /* @__PURE__ */ jsxRuntime.jsx(RuntimeContext.Provider, { value, children });
 };
 function useZvolvRuntime() {
-  const ctx = React13.useContext(RuntimeContext);
+  const ctx = React14.useContext(RuntimeContext);
   if (!ctx) {
     throw new Error(
       "@zestl/zvolv-widgets: no ZvolvProvider found. Wrap your app in <ZvolvProvider runtime={...}> before rendering widgets or calling data hooks."
@@ -127,8 +129,8 @@ var TASK_DATE_FIELDS = [
   "completeDate"
 ];
 new Set(TASK_DATE_FIELDS.map((f) => f.toLowerCase()));
-dayjs8__default.default.extend(utc__default.default);
-dayjs8__default.default.extend(weekOfYear__default.default);
+dayjs4__default.default.extend(utc__default.default);
+dayjs4__default.default.extend(weekOfYear__default.default);
 function humanizeDurationToMinutes(value) {
   if (!value) return 0;
   let total = 0;
@@ -173,7 +175,7 @@ function getDataType(elementType) {
 function getDateRange(ops) {
   const values = [];
   const fmt2 = "YYYY-MM-DD";
-  const today = dayjs8__default.default();
+  const today = dayjs4__default.default();
   switch (ops) {
     case "TODAY":
       values[0] = today.format(fmt2);
@@ -325,7 +327,7 @@ var resolveQueryUser = () => {
 };
 
 // src/runtime/queryGenerator.ts
-dayjs8__default.default.extend(utc__default.default);
+dayjs4__default.default.extend(utc__default.default);
 var mappingsCache = /* @__PURE__ */ new Map();
 function getCachedAnalyticsMappings(indexKey) {
   let pending2 = mappingsCache.get(indexKey);
@@ -477,7 +479,7 @@ function resolveDateMath(value) {
   if (typeof value !== "string") return null;
   const match = dateMathPattern.exec(value.trim());
   if (!match) return null;
-  let d = dayjs8__default.default();
+  let d = dayjs4__default.default();
   const [, amountStr, amountUnit, , roundUnit] = match;
   if (amountStr && amountUnit) {
     d = d.add(parseInt(amountStr, 10), dateMathUnit[amountUnit]);
@@ -492,7 +494,7 @@ function isDateMath(value) {
 }
 function getDate(dateFormula) {
   const fmt2 = "YYYY-MM-DDTHH:mm:ssZ";
-  const d = dayjs8__default.default();
+  const d = dayjs4__default.default();
   switch (dateFormula) {
     case "{@[TODAY]}":
       return d.startOf("day").format(fmt2);
@@ -689,7 +691,7 @@ function getFilters(field2, type, loggedInUser = null, isTask = false) {
     field2.filter.operand = field2.filter.operand.map((oprd) => {
       if (isDateMath(oprd)) return oprd;
       const pattern = dateFieldPattern[field2.fieldFormat] ?? field2.fieldFormat;
-      return dayjs8__default.default(oprd, pattern).format("YYYY-MM-DD");
+      return dayjs4__default.default(oprd, pattern).format("YYYY-MM-DD");
     });
   }
   if (field2["taskfield"] && !field2["masterFieldDataType"]) {
@@ -974,6 +976,142 @@ function getTaskElementSort(dataSource, fieldMetaByName) {
   }
   return null;
 }
+function pivotEsField(entry) {
+  return entry?.masterField || entry?.title;
+}
+var HISTOGRAM_INTERVALS = {
+  day: "1d",
+  week: "1w",
+  month: "1M",
+  quarter: "1q",
+  year: "1y"
+};
+function getDateHistogramSource(row, esField, mfType, meta, sortOrder) {
+  const isTaskDate = taskDate.includes(esField) && !!(row.isTaskField || row.taskfield || meta?.isTaskField || meta?.taskfield);
+  if (!dateTypes.includes(mfType) && !isTaskDate) {
+    console.warn(`[@zestl/zvolv-widgets] groupBy "${row.title}": interval "${row.interval}" ignored \u2014 "${esField}" is not a date field.`);
+    return null;
+  }
+  const calendarInterval = HISTOGRAM_INTERVALS[row.interval];
+  if (!calendarInterval) {
+    console.warn(`[@zestl/zvolv-widgets] groupBy "${row.title}": unknown interval "${row.interval}" \u2014 use day | week | month | quarter | year.`);
+    return null;
+  }
+  const histogram = { field: esField, calendar_interval: calendarInterval, time_zone: row.timeZone || timezone };
+  if (sortOrder) histogram.order = sortOrder;
+  return { date_histogram: histogram };
+}
+var summaryFilterLists = /* @__PURE__ */ new Map();
+var DATE_DIFF_DIVISOR = {
+  days: "86400000.0",
+  hours: "3600000.0",
+  minutes: "60000.0"
+};
+var LITERAL_DATE = /^\d{4}-\d{2}-\d{2}([T ][\d:.]+(Z|[+-]\d{2}:?\d{2})?)?$/;
+function getDateDiffFixedEnd(end) {
+  if (typeof end !== "string") return null;
+  if (dateFormulas.includes(end)) return dayjs4__default.default(getDate(end)).valueOf();
+  if (LITERAL_DATE.test(end.trim())) {
+    const d = dayjs4__default.default(end.trim());
+    if (d.isValid()) return d.valueOf();
+  }
+  if (/^\{@\[.*\]\}$/.test(end)) {
+    console.warn(`[@zestl/zvolv-widgets] dateDiff end "${end}" is not a known date token (${dateFormulas.join(", ")}); it is being queried as a field name.`);
+  }
+  return null;
+}
+function getDateDiffScript(dd, fixedEnd) {
+  const divisor = DATE_DIFF_DIVISOR[dd.unit] ?? DATE_DIFF_DIVISOR.days;
+  if (fixedEnd != null) {
+    return {
+      source: `if(doc['${dd.start}'].size()==0) { return null; } return (params.now - doc['${dd.start}'].value.millis) / ${divisor};`,
+      lang: "painless",
+      params: { now: fixedEnd }
+    };
+  }
+  return {
+    source: `if(doc['${dd.start}'].size()==0 || doc['${dd.end}'].size()==0) { return null; } return (doc['${dd.end}'].value.millis - doc['${dd.start}'].value.millis) / ${divisor};`,
+    lang: "painless"
+  };
+}
+function getSummaryFilterClause(sumary, f, loggedInUser) {
+  if (f.operator === "_ALL" || f.operator === "MULTIPLE") return null;
+  const fb = {
+    header: sumary.title,
+    masterfield: f.operand ?? f.masterField,
+    masterFieldDataType: f.masterFieldDataType,
+    masterFieldType: f.masterFieldType,
+    filter: { operator: f.operator, operand: Array.isArray(f.value) ? [...f.value] : f.value }
+  };
+  return getFilters(fb, "PIVOT", loggedInUser) ?? null;
+}
+function buildExtendedSummary(sumary, summaryAggs, loggedInUser, sortKeys = {}) {
+  const name = sumary.value;
+  const list = summaryFilterLists.get(name) ?? [];
+  const andGroup = list.length > 1 && list.some((f) => f?.combine === "AND");
+  const isPercentiles = sumary.type === "percentiles";
+  if (!sumary.dateDiff && !andGroup && !(isPercentiles && sumary.percents?.length)) return false;
+  const must = [];
+  const mustNot = [];
+  const conditions = andGroup ? list : list.slice(-1);
+  for (const f of conditions) {
+    const clause = getSummaryFilterClause(sumary, f, loggedInUser);
+    if (!clause) continue;
+    if (mustNotOp.includes(f.operator)) mustNot.push({ ...clause });
+    else must.push(clause);
+  }
+  let metric;
+  if (sumary.dateDiff) {
+    const dd = sumary.dateDiff;
+    const fixedEnd = getDateDiffFixedEnd(dd.end);
+    must.push({ exists: { field: dd.start } });
+    if (fixedEnd == null) must.push({ exists: { field: dd.end } });
+    metric = { script: getDateDiffScript(dd, fixedEnd) };
+  } else {
+    const esField = pivotEsField(sumary);
+    let aggType = sumary.type;
+    let aggField = esField;
+    const isTextField = sumary.masterFieldDataType === "STRING" && !dateTypes.includes(sumary.masterFieldType) && !isNumericTaskField(sumary);
+    if (sumary.masterFieldType === "FORM_SEARCH" && (aggType === "value_count" || aggType === "cardinality")) {
+      aggField = resolveFormSearchViewField(esField);
+    } else if (sumary.masterFieldType === "FILE_UPLOAD_V2") {
+      aggField = `${esField}.mediaKey.keyword`;
+    } else if (isTextField) {
+      if (["sum", "avg", "min", "max"].includes(aggType)) aggType = "value_count";
+      aggField = `${esField}.keyword`;
+    }
+    metric = { field: aggField };
+    finish(name, summaryAggs, must, mustNot, { [aggType]: metric });
+    if (isPercentiles && sumary.percents?.length) metric.percents = sumary.percents;
+    if (!isPercentiles && aggField === esField && sortKeys[esField]) {
+      summaryAggs[`${name}_sort`] = { bucket_sort: { sort: [{ [name]: { order: sortKeys[esField] } }] } };
+    }
+    return true;
+  }
+  if (isPercentiles && sumary.percents?.length) metric.percents = sumary.percents;
+  return finish(name, summaryAggs, must, mustNot, { [sumary.type]: metric });
+}
+function finish(name, summaryAggs, must, mustNot, metric) {
+  if (must.length === 0 && mustNot.length === 0) {
+    summaryAggs[name] = metric;
+    return true;
+  }
+  const bool = {};
+  if (must.length) bool.must = must;
+  if (mustNot.length) bool.must_not = mustNot;
+  summaryAggs[name] = { filter: { bool }, aggs: { [name]: metric } };
+  return true;
+}
+function groupPivotFilters(pivotFilters) {
+  const out = /* @__PURE__ */ new Map();
+  (pivotFilters || []).forEach((f) => {
+    if (!f) return;
+    const list = out.get(f.field) ?? [];
+    list.push(f);
+    out.set(f.field, list);
+  });
+  return out;
+}
 function getCompositeAggregations(pivotBody, filterMap, aggDataPoints, size = 5e4, scriptFields = {}, loggedInUser = null, sort = [], fieldMetaByName) {
   const composite = { size, sources: [] };
   pivotBody.rows.forEach((row) => {
@@ -995,17 +1133,21 @@ function getCompositeAggregations(pivotBody, filterMap, aggDataPoints, size = 5e
     const meta = fieldMetaByName?.get(row.title) || fieldMetaByName?.get(row.masterField) || {};
     const mfType = row.masterFieldType ?? meta.masterFieldType;
     const mfDataType = row.masterFieldDataType ?? meta.masterFieldDataType ?? (mfType ? getDataType(mfType) : void 0);
+    const esField = pivotEsField(row);
     const sourceObj = {};
-    if (mfType === "FORM_SEARCH" || mfType === "INPUT_TAG") {
-      sourceObj[row.title] = { terms: { field: resolveFormSearchViewField(row.title) } };
+    const histogram = row.interval ? getDateHistogramSource(row, esField, mfType, meta, sortOrder) : null;
+    if (histogram) {
+      sourceObj[row.title] = histogram;
+    } else if (mfType === "FORM_SEARCH" || mfType === "INPUT_TAG") {
+      sourceObj[row.title] = { terms: { field: resolveFormSearchViewField(esField) } };
     } else if (mfType === "FILE_UPLOAD_V2") {
-      sourceObj[row.title] = { terms: { field: `${row.title}.mediaKey.keyword` } };
+      sourceObj[row.title] = { terms: { field: `${esField}.mediaKey.keyword` } };
     } else if (mfDataType === "STRING" && !dateTypes.includes(mfType) && !isNumericTaskField(row, fieldMetaByName)) {
-      sourceObj[row.title] = { terms: { field: `${row.title}.keyword` } };
+      sourceObj[row.title] = { terms: { field: `${esField}.keyword` } };
     } else if (!mfDataType && Object.keys(scriptFields).length > 0) {
       sourceObj[row.title] = { terms: scriptFields[row.title] };
     } else {
-      sourceObj[row.title] = { terms: { field: row.title } };
+      sourceObj[row.title] = { terms: { field: esField } };
       if (sortOrder) sourceObj[row.title]["terms"]["order"] = sortOrder;
     }
     composite.sources.push(sourceObj);
@@ -1023,7 +1165,7 @@ function getColumnAggregations(pivotBody, filterMap, aggDataPoints, loggedInUser
       const colFilter = getFilters(fb, "PIVOT", loggedInUser);
       if (colFilter) colFilters.push(colFilter);
     }
-    colAggs[col.title] = { terms: { field: col.title } };
+    colAggs[col.title] = { terms: { field: pivotEsField(col) } };
     if (i === pivotBody.columns.length - 1) {
       const summaryResult = getSummaryAggregations(pivotBody, filterMap, aggDataPoints, loggedInUser, fMap);
       colAggs[col.title]["aggs"] = summaryResult.summaryAggs;
@@ -1056,6 +1198,7 @@ function getSummaryAggregations(pivotBody, filterMap, aggDataPoints, loggedInUse
   pivotBody.summary.forEach((sumary) => {
     const filter = filterMap.get(sumary.value);
     aggDataPoints["summary"].push(sumary.value);
+    if (buildExtendedSummary(sumary, summaryAggs, loggedInUser, sortKeys)) return;
     summaryAggs[sumary.value] = {};
     const addBucketSort = (key) => {
       if (sortKeys[key]) {
@@ -1063,17 +1206,18 @@ function getSummaryAggregations(pivotBody, filterMap, aggDataPoints, loggedInUse
       }
     };
     const isTextField = sumary.masterFieldDataType === "STRING" && !dateTypes.includes(sumary.masterFieldType) && !isNumericTaskField(sumary, fMap);
+    const esField = pivotEsField(sumary);
     let aggType = sumary.type;
-    let aggField = sumary.title;
+    let aggField = esField;
     if (sumary.masterFieldType === "FORM_SEARCH" && (sumary.type === "value_count" || sumary.type === "cardinality")) {
-      aggField = resolveFormSearchViewField(sumary.title);
+      aggField = resolveFormSearchViewField(esField);
     } else if (sumary.masterFieldType === "FILE_UPLOAD_V2") {
-      aggField = `${sumary.title}.mediaKey.keyword`;
+      aggField = `${esField}.mediaKey.keyword`;
     } else if (isTextField) {
       if (["sum", "avg", "min", "max"].includes(sumary.type)) aggType = "value_count";
-      aggField = `${sumary.title}.keyword`;
+      aggField = `${esField}.keyword`;
     }
-    const usesRawField = aggField === sumary.title;
+    const usesRawField = aggField === esField;
     if (filter) {
       const fb = {
         header: sumary.title,
@@ -1091,10 +1235,10 @@ function getSummaryAggregations(pivotBody, filterMap, aggDataPoints, loggedInUse
       }
       summaryAggs[sumary.value]["aggs"] = { [sumary.value]: {} };
       summaryAggs[sumary.value]["aggs"][sumary.value][aggType] = { field: aggField };
-      if (usesRawField) addBucketSort(sumary.title);
+      if (usesRawField) addBucketSort(esField);
     } else {
       summaryAggs[sumary.value][aggType] = { field: aggField };
-      if (usesRawField) addBucketSort(sumary.title);
+      if (usesRawField) addBucketSort(esField);
     }
   });
   return { summaryAggs, aggDataPoints };
@@ -1104,6 +1248,7 @@ function generateQuery(configuration, dataSource, formId, skip = null, limit = n
   scriptFilters = [];
   fieldMap = /* @__PURE__ */ new Map();
   currentMappings = mappings;
+  summaryFilterLists = /* @__PURE__ */ new Map();
   let staticQueryClause = null;
   const rawDataSourceQuery = dataSource?.query;
   if (rawDataSourceQuery && typeof rawDataSourceQuery === "string") {
@@ -1196,6 +1341,7 @@ function generateQuery(configuration, dataSource, formId, skip = null, limit = n
       if (dataSource?.pivot.filters?.length > 0) {
         dataSource?.pivot.filters.forEach((f) => filterMap2.set(f.field, f));
       }
+      summaryFilterLists = groupPivotFilters(dataSource?.pivot.filters);
       if (!isDrilldownView() && dataSource?.displayRowLimit && dataSource?.displayRowLimit !== "") {
         size = dataSource?.displayRowLimit;
       }
@@ -1773,16 +1919,29 @@ function taskField(header, masterFieldType = "INPUT_TEXT", options = {}) {
     ...options
   };
 }
-function groupBy(f, title = f.header) {
+function groupBy(f, title = f.header, options = {}) {
   return {
     title,
     masterField: f.masterfield ?? f.taskfield ?? f.header,
     masterFieldType: f.masterFieldType,
-    masterFieldDataType: f.masterFieldDataType
+    masterFieldDataType: f.masterFieldDataType,
+    ...options.interval ? { interval: options.interval } : {},
+    ...options.timeZone ? { timeZone: options.timeZone } : {}
   };
 }
-function aggregate(f, type = "sum", outputName = f.header) {
+function dateDiff(start, end, unit = "days") {
+  const startField = start.masterfield ?? start.taskfield ?? start.header;
+  const endField = typeof end === "string" ? end === "TODAY" ? "{@[TODAY]}" : end : end.masterfield ?? end.taskfield ?? end.header;
+  const endLabel = typeof end === "string" ? end : end.header;
   return {
+    header: `${start.header} \u2192 ${endLabel} (${unit})`,
+    masterfield: startField,
+    masterFieldDataType: "FLOAT",
+    dateDiff: { start: startField, end: endField, unit }
+  };
+}
+function aggregate(f, type = "sum", outputName = f.header, options = {}) {
+  const summary = {
     title: f.header,
     masterField: f.masterfield ?? f.taskfield ?? f.header,
     masterFieldType: f.masterFieldType,
@@ -1790,6 +1949,36 @@ function aggregate(f, type = "sum", outputName = f.header) {
     value: outputName,
     type
   };
+  const dd = f.dateDiff;
+  if (dd) summary.dateDiff = { ...dd };
+  if (options.percents?.length) summary.percents = [...options.percents];
+  if (options.where?.length) {
+    summary.filters = options.where.map(([wf, cond]) => {
+      const mf = wf.masterfield ?? wf.taskfield ?? wf.header;
+      return {
+        field: outputName,
+        operand: mf,
+        masterField: mf,
+        masterFieldType: wf.masterFieldType,
+        masterFieldDataType: wf.masterFieldDataType,
+        operator: cond.operator,
+        value: [...cond.operand],
+        combine: "AND"
+      };
+    });
+  }
+  return summary;
+}
+function hoistSummaryFilters(p) {
+  if (!p?.summary?.some((s) => s.filters?.length)) return p;
+  const hoisted = [];
+  const summary = p.summary.map((s) => {
+    if (!s.filters) return s;
+    const { filters: filters2, ...rest } = s;
+    hoisted.push(...filters2);
+    return rest;
+  });
+  return { ...p, summary, filters: [...p.filters ?? [], ...hoisted] };
 }
 function derive(title, operator, operands) {
   return { title, operator, operands };
@@ -1802,7 +1991,7 @@ function formSource(formId, fields, options = {}) {
     formId,
     newFormFramework: true,
     fields: fields.map((f) => ({ ...f, formID: f.formID ?? formId })),
-    ...options.pivot ? { pivot: options.pivot } : {},
+    ...options.pivot ? { pivot: hoistSummaryFilters(options.pivot) } : {},
     ...options.displayRowLimit ? { displayRowLimit: options.displayRowLimit } : {}
   };
 }
@@ -1811,7 +2000,7 @@ function taskSource(fields, options = {}) {
     isTask: true,
     newFormFramework: true,
     fields: fields.map((f) => ({ ...f, isTaskField: true })),
-    ...options.pivot ? { pivot: options.pivot } : {},
+    ...options.pivot ? { pivot: hoistSummaryFilters(options.pivot) } : {},
     ...options.displayRowLimit ? { displayRowLimit: options.displayRowLimit } : {}
   };
 }
@@ -1819,13 +2008,13 @@ function automationSource(automationId, fields = []) {
   return { automation: { automationId, enabled: true }, fields };
 }
 function pivot(config) {
-  return {
+  return hoistSummaryFilters({
     rows: config.rows ?? [],
     columns: config.columns ?? [],
     summary: config.summary ?? [],
     filters: config.filters ?? [],
     postOperations: config.postOperations ?? []
-  };
+  });
 }
 
 // src/core/config.ts
@@ -1923,7 +2112,7 @@ function coerceForField(field2, values) {
   });
 }
 var FMT = "YYYY-MM-DD";
-function resolveDateToken(token, now = dayjs8__default.default()) {
+function resolveDateToken(token, now = dayjs4__default.default()) {
   switch (String(token).toUpperCase()) {
     case "TODAY":
       return [now.format(FMT), now.format(FMT)];
@@ -1967,7 +2156,7 @@ function parseStrict(text2, fmt2) {
   const y = map.YYYY, m = map.MM, d = map.DD;
   if (!y || y.length !== 4 || !m || !d) return [null, null, null];
   const mm = m.padStart(2, "0"), dd = d.padStart(2, "0");
-  const parsed = dayjs8__default.default(`${y}-${mm}-${dd}`);
+  const parsed = dayjs4__default.default(`${y}-${mm}-${dd}`);
   if (!parsed.isValid() || parsed.format(FMT) !== `${y}-${mm}-${dd}`) return [null, null, null];
   return [y, mm, dd];
 }
@@ -2066,7 +2255,7 @@ function toComparable(v) {
   if (typeof v === "number") return v;
   const n = Number(v);
   if (!isNaN(n)) return n;
-  const d = dayjs8__default.default(v);
+  const d = dayjs4__default.default(v);
   return d.isValid() ? d.valueOf() : null;
 }
 function applyLocalSearch(rows, search, toLabel) {
@@ -2134,7 +2323,7 @@ function matchesWidgetFilter(row, f) {
     case "DATE_IS": {
       const range = resolveDateToken(String(values[0] ?? ""));
       if (!range || raw2 == null || raw2 === "") return false;
-      const d = dayjs8__default.default(raw2).format(FMT);
+      const d = dayjs4__default.default(raw2).format(FMT);
       return d >= range[0] && d <= range[1];
     }
     default:
@@ -2338,22 +2527,22 @@ function resolveWidgetDefaults(tokens, widgetType, config) {
   const typeDefaults = widgetType && (defaults[widgetType] ?? defaults[widgetType.toUpperCase()]) || {};
   return { ...typeDefaults, ...config || {} };
 }
-var TokensContext = React13.createContext(defaultTokens);
+var TokensContext = React14.createContext(defaultTokens);
 var ZvolvThemeProvider = ({ tokens, children }) => {
-  const value = React13.useMemo(() => mergeTokens(defaultTokens, tokens), [tokens]);
+  const value = React14.useMemo(() => mergeTokens(defaultTokens, tokens), [tokens]);
   return /* @__PURE__ */ jsxRuntime.jsx(TokensContext.Provider, { value, children });
 };
 function useTokens() {
-  return React13.useContext(TokensContext);
+  return React14.useContext(TokensContext);
 }
-var TemplateContext = React13.createContext({});
+var TemplateContext = React14.createContext({});
 var TemplateProvider = ({ templates, children }) => {
-  const parent = React13.useContext(TemplateContext);
-  const value = React13.useMemo(() => ({ ...parent, ...templates || {} }), [parent, templates]);
+  const parent = React14.useContext(TemplateContext);
+  const value = React14.useMemo(() => ({ ...parent, ...templates || {} }), [parent, templates]);
   return /* @__PURE__ */ jsxRuntime.jsx(TemplateContext.Provider, { value, children });
 };
 function useTemplateOverride(widgetType, templateId) {
-  const map = React13.useContext(TemplateContext);
+  const map = React14.useContext(TemplateContext);
   return map[`${widgetType}:${templateId}`] ?? map[`${widgetType}:*`] ?? null;
 }
 var Label = ({ children }) => {
@@ -2553,7 +2742,7 @@ var KPI_DEFAULT_TEMPLATES = {
   hero_chart: HeroChart,
   icon: Icon
 };
-var WidgetStateSlot = React13__default.default.createContext(null);
+var WidgetStateSlot = React14__default.default.createContext(null);
 var WidgetShell = ({
   widgetType,
   title,
@@ -2571,7 +2760,7 @@ var WidgetShell = ({
 }) => {
   const t = useTokens();
   const chrome = resolveChrome(t, widgetType);
-  const renderState = React13__default.default.useContext(WidgetStateSlot);
+  const renderState = React14__default.default.useContext(WidgetStateSlot);
   const frame = {
     display: "flex",
     flexDirection: "column",
@@ -2676,24 +2865,91 @@ function alignSummaryToSeries(dataSource, series) {
   });
   return { ...dataSource, pivot: { ...dataSource.pivot, summary: fixedSummary } };
 }
+dayjs4__default.default.extend(utc__default.default);
+dayjs4__default.default.extend(timezone2__default.default);
 function isLikelyTimestamp(v) {
   if (typeof v !== "number" || !Number.isFinite(v)) return false;
   return v > 946e9 && v < 41e11;
 }
-function fillDateGaps({ rows, xKey, series, unit, range }) {
+function wallStartOfPeriod(d, unit) {
+  switch (unit) {
+    case "week": {
+      const day = d.startOf("day");
+      return day.subtract((day.day() + 6) % 7, "day");
+    }
+    case "quarter": {
+      const month = d.startOf("month");
+      return month.month(Math.floor(month.month() / 3) * 3);
+    }
+    default:
+      return d.startOf(unit);
+  }
+}
+function wallAddPeriod(d, unit) {
+  return unit === "quarter" ? d.add(3, "month") : d.add(1, unit);
+}
+function inZone(wall, d, timeZone) {
+  const date = wall(dayjs4__default.default.utc(d.tz(timeZone).format("YYYY-MM-DD"))).format("YYYY-MM-DD");
+  return dayjs4__default.default.tz(date, timeZone);
+}
+function startOfPeriod(d, unit, timeZone) {
+  return timeZone ? inZone((w) => wallStartOfPeriod(w, unit), d, timeZone) : wallStartOfPeriod(d, unit);
+}
+function addPeriod(d, unit, timeZone) {
+  return timeZone ? inZone((w) => wallAddPeriod(w, unit), d, timeZone) : wallAddPeriod(d, unit);
+}
+var HAS_OFFSET = /(Z|[+-]\d{2}:?\d{2})$/i;
+function parseDateValue(v, timeZone) {
+  if (timeZone && typeof v === "string" && !HAS_OFFSET.test(v.trim())) {
+    try {
+      return dayjs4__default.default.tz(v, timeZone);
+    } catch {
+      return dayjs4__default.default(NaN);
+    }
+  }
+  return dayjs4__default.default(v);
+}
+function sumInto(target, row, series) {
+  series.forEach(({ valueField }) => {
+    if (!(valueField in row) && !(valueField in target)) return;
+    const a = Number(target[valueField]);
+    const b = Number(row[valueField]);
+    target[valueField] = (Number.isFinite(a) ? a : 0) + (Number.isFinite(b) ? b : 0);
+  });
+}
+function fillDateGaps({
+  rows,
+  xKey,
+  series,
+  unit,
+  range,
+  merge = "sum",
+  xFormat,
+  timeZone
+}) {
   if (!range) return rows;
-  const keyFormat = unit === "month" ? "YYYY-MM" : "YYYY-MM-DD";
   const byPeriod = /* @__PURE__ */ new Map();
+  const copied = /* @__PURE__ */ new Set();
   rows.forEach((row) => {
-    const d = dayjs8__default.default(row[xKey]);
-    if (d.isValid()) byPeriod.set(d.startOf(unit).format(keyFormat), row);
+    const d = parseDateValue(row[xKey], timeZone);
+    if (!d.isValid()) return;
+    const key = startOfPeriod(d, unit, timeZone).valueOf();
+    const existing = byPeriod.get(key);
+    if (!existing || merge === "last") {
+      byPeriod.set(key, row);
+      return;
+    }
+    const merged = copied.has(key) ? existing : { ...existing };
+    copied.add(key);
+    sumInto(merged, row, series);
+    byPeriod.set(key, merged);
   });
   const filled = [];
-  let cursor = range.start;
-  const useTimestamp = isLikelyTimestamp(rows[0]?.[xKey]);
-  while (cursor.isBefore(range.end) || cursor.isSame(range.end, unit)) {
-    const key = cursor.format(keyFormat);
-    const existing = byPeriod.get(key);
+  const useTimestamp = rows.length ? isLikelyTimestamp(rows[0]?.[xKey]) : xFormat === "timestamp";
+  const end = startOfPeriod(range.end, unit, timeZone);
+  let cursor = startOfPeriod(range.start, unit, timeZone);
+  while (!cursor.isAfter(end)) {
+    const existing = byPeriod.get(cursor.valueOf());
     if (existing) {
       filled.push(existing);
     } else {
@@ -2705,10 +2961,33 @@ function fillDateGaps({ rows, xKey, series, unit, range }) {
       });
       filled.push(zeroRow);
     }
-    cursor = cursor.add(1, unit);
+    cursor = addPeriod(cursor, unit, timeZone);
   }
   return filled;
 }
+function applyCumulative(rows, xKey, fields, baseline = {}) {
+  if (!fields.length) return rows;
+  const dated = rows.map((row, i) => ({ row, i, t: dayjs4__default.default(row?.[xKey]).valueOf() }));
+  dated.sort((a, b) => {
+    const at = Number.isFinite(a.t), bt = Number.isFinite(b.t);
+    if (at && bt) return a.t - b.t || a.i - b.i;
+    if (at !== bt) return at ? -1 : 1;
+    return a.i - b.i;
+  });
+  const running = {};
+  fields.forEach((f) => {
+    running[f] = Number(baseline[f]) || 0;
+  });
+  return dated.map(({ row }) => {
+    const next = { ...row };
+    fields.forEach((f) => {
+      const v = Number(row?.[f]);
+      running[f] += Number.isFinite(v) ? v : 0;
+      next[f] = running[f];
+    });
+    return next;
+  });
+}
 function toNumber(v) {
   if (typeof v === "number") return Number.isFinite(v) ? v : 0;
   const n = Number(v);
@@ -2726,6 +3005,49 @@ function coerceSeriesNumbers(rows, series) {
   });
 }
 
+// src/transforms/percentiles.ts
+function percentileKey(name, percent) {
+  return `${name}_p${String(Number(percent)).replace(".", "_")}`;
+}
+function percentileSummaries(summary) {
+  return (summary || []).filter((s) => s?.type === "percentiles" && s.value).map((s) => s.value);
+}
+function readPercentiles(raw2) {
+  if (raw2 == null || typeof raw2 !== "object") return null;
+  const values = Array.isArray(raw2) ? raw2 : raw2.values ?? raw2;
+  const out = {};
+  if (Array.isArray(values)) {
+    values.forEach((v) => {
+      if (v && v.key != null) out[String(v.key)] = v.value;
+    });
+  } else if (typeof values === "object") {
+    for (const [k, v] of Object.entries(values)) {
+      if (k.endsWith("_as_string")) continue;
+      if (Number.isFinite(Number(k))) out[k] = v;
+    }
+  }
+  return Object.keys(out).length ? out : null;
+}
+function flattenPercentiles(rows, names) {
+  if (!names.length) return rows;
+  return rows.map((row) => {
+    let next = row;
+    for (const name of names) {
+      const parsed = readPercentiles(row?.[name]);
+      if (!parsed) continue;
+      if (next === row) next = { ...row };
+      let median;
+      for (const [percent, value] of Object.entries(parsed)) {
+        const n = value == null ? null : Number(value);
+        next[percentileKey(name, percent)] = n;
+        if (Number(percent) === 50 && n != null) median = n;
+      }
+      if (median !== void 0) next[name] = median;
+    }
+    return next;
+  });
+}
+
 // src/react/useWidgetData.ts
 var ALIGN_TYPES = /* @__PURE__ */ new Set(["BAR", "BAR_CHART", "PIE", "PIE_CHART", "DOUGHNUT", "DOUGHNUT_CHART"]);
 var formCache = /* @__PURE__ */ new WeakMap();
@@ -2746,9 +3068,30 @@ function getFormOnce(client, formId) {
   }
   return p;
 }
+function baselineClause(source, start) {
+  const f = (source.dataSource?.fields || []).find(
+    (x) => x?.header === source.dateField || x?.masterfield === source.dateField
+  );
+  return {
+    header: f?.header ?? source.dateField,
+    masterfield: f?.masterfield ?? source.dateField,
+    masterFieldType: f?.masterFieldType ?? "DATE_PICKER",
+    masterFieldDataType: f?.masterFieldDataType ?? "STRING",
+    // Date-only: the query generator keeps "YYYY-MM-DD" operands as dates.
+    filter: { operator: "LESS_THAN", operand: [start.format("YYYY-MM-DD")] }
+  };
+}
+function readBaseline(rows) {
+  const out = {};
+  for (const [k, v] of Object.entries(rows?.[0] ?? {})) {
+    const n = Number(v);
+    if (Number.isFinite(n)) out[k] = n;
+  }
+  return out;
+}
 function useDebounced(value, ms, enabled) {
-  const [v, setV] = React13.useState(value);
-  React13.useEffect(() => {
+  const [v, setV] = React14.useState(value);
+  React14.useEffect(() => {
     if (!enabled) {
       setV(value);
       return;
@@ -2797,23 +3140,23 @@ function useWidgetData(args) {
     searchDebounceMs = 400
   } = args;
   const rt = useZvolvRuntime();
-  const [sourceRows, setSourceRows] = React13.useState([]);
-  const [userLabels, setUserLabels] = React13.useState({});
-  const [initialLoading, setInitialLoading] = React13.useState(true);
-  const [loading, setLoading] = React13.useState(false);
-  const [error, setError] = React13.useState(null);
-  const [nonce, setNonce] = React13.useState(0);
-  const requestedUserIds = React13.useRef(/* @__PURE__ */ new Set());
-  const reqSeq = React13.useRef(0);
-  const config = React13.useMemo(() => parseConfig(configurations), [configurations]);
-  const series = React13.useMemo(() => resolveSeries(config), [config]);
-  const xKey = React13.useMemo(() => resolveXKey(series), [series]);
-  const configured = React13.useMemo(() => isDataSourceConfigured(dataSource), [dataSource]);
+  const [sourceRows, setSourceRows] = React14.useState([]);
+  const [userLabels, setUserLabels] = React14.useState({});
+  const [initialLoading, setInitialLoading] = React14.useState(true);
+  const [loading, setLoading] = React14.useState(false);
+  const [error, setError] = React14.useState(null);
+  const [nonce, setNonce] = React14.useState(0);
+  const requestedUserIds = React14.useRef(/* @__PURE__ */ new Set());
+  const reqSeq = React14.useRef(0);
+  const config = React14.useMemo(() => parseConfig(configurations), [configurations]);
+  const series = React14.useMemo(() => resolveSeries(config), [config]);
+  const xKey = React14.useMemo(() => resolveXKey(series), [series]);
+  const configured = React14.useMemo(() => isDataSourceConfigured(dataSource), [dataSource]);
   const hasAutomation = !!automationRows;
   const tableMode = resolveTableMode(dataSource, widgetType, hasAutomation);
   const filterMode = resolveFilterMode(dataSource, hasAutomation);
   const debouncedSearch = useDebounced(search, searchDebounceMs, tableMode === "remote");
-  const remote = React13.useMemo(() => ({
+  const remote = React14.useMemo(() => ({
     search: tableMode === "remote" ? debouncedSearch : "",
     columnFilters: tableMode === "remote" ? columnFilters : void 0,
     sort: tableMode === "remote" ? sort : null,
@@ -2825,14 +3168,35 @@ function useWidgetData(args) {
   const localKey = JSON.stringify(localFilters ?? {});
   const dsKey = JSON.stringify(dataSource ?? {});
   const remoteKey = JSON.stringify(remote);
-  const normalize = React13.useCallback((incoming) => {
-    const withPostOps = applyPostOperations(incoming, dataSource?.pivot?.postOperations);
+  const dateGapKey = JSON.stringify(dateGap ?? null);
+  const gapTimeZone = React14.useMemo(() => {
+    if (dateGap?.timeZone) return dateGap.timeZone;
+    const row = (dataSource?.pivot?.rows || []).find((r) => r?.title === xKey && r?.interval);
+    return row?.timeZone || void 0;
+  }, [dateGap?.timeZone, dataSource, xKey]);
+  const normalize = React14.useCallback((incoming, fetchedBaseline) => {
+    const percentiles = percentileSummaries(dataSource?.pivot?.summary);
+    const flat = percentiles.length ? flattenPercentiles(incoming, percentiles) : incoming;
+    const withPostOps = applyPostOperations(flat, dataSource?.pivot?.postOperations);
     const numeric = coerceSeriesNumbers(withPostOps, series);
     if (!dateGap) return numeric;
-    const range = dateGap.start && dateGap.end ? { start: dayjs8__default.default(dateGap.start).startOf(dateGap.unit), end: dayjs8__default.default(dateGap.end).startOf(dateGap.unit) } : null;
-    return fillDateGaps({ rows: numeric, xKey, series, unit: dateGap.unit, range });
-  }, [dataSource, series, xKey, dateGap]);
-  React13.useEffect(() => {
+    const tz = gapTimeZone;
+    const period = (v) => startOfPeriod(parseDateValue(v, tz), dateGap.unit, tz);
+    const range = dateGap.start && dateGap.end ? { start: period(dateGap.start), end: period(dateGap.end) } : null;
+    const filled = fillDateGaps({ rows: numeric, xKey, series, unit: dateGap.unit, range, merge: dateGap.merge, timeZone: tz });
+    if (!dateGap.cumulative) return filled;
+    let inRange = filled;
+    if (dateGap.start && !range) {
+      const from = period(dateGap.start).valueOf();
+      inRange = filled.filter((row) => {
+        const d = parseDateValue(row?.[xKey], tz);
+        return !d.isValid() || startOfPeriod(d, dateGap.unit, tz).valueOf() >= from;
+      });
+    }
+    const fields = dateGap.cumulative === true ? series.map((s) => s.valueField) : dateGap.cumulative;
+    return applyCumulative(inRange, xKey, fields, { ...fetchedBaseline || {}, ...dateGap.baseline || {} });
+  }, [dataSource, series, xKey, dateGap, gapTimeZone]);
+  React14.useEffect(() => {
     if (automationRows) {
       if (automationLoading) {
         setLoading(true);
@@ -2853,53 +3217,67 @@ function useWidgetData(args) {
     let cancelled = false;
     setError(null);
     setLoading(true);
+    const queryForm = async (ds, mode, extraClauses = []) => {
+      const formId = ds.formId ?? ds.fields?.[0]?.formID;
+      const withFormId = formId ? { ...ds, formId } : ds;
+      const merged = mergeHostFilters(localFilters, dashFilters);
+      const cfgWithDates = { ...config, cdateFilters: mode === "main" ? cdateFilters : [] };
+      const dashboardFilters = rt.formatDashboardFilters ? [...rt.formatDashboardFilters(cfgWithDates, withFormId, merged) || []] : [];
+      if (remote.widgetFilters?.length) {
+        dashboardFilters.push(...buildWidgetFilterClauses(withFormId, remote.widgetFilters));
+      }
+      if (mode === "main" && remote.columnFilters && Object.keys(remote.columnFilters).length) {
+        dashboardFilters.push(...rt.formatHeaderFilters ? rt.formatHeaderFilters(withFormId, remote.columnFilters) || [] : buildColumnFilterClauses(withFormId, remote.columnFilters));
+      }
+      const searchClause = mode === "main" ? buildSearchClause(remote.search) : null;
+      if (searchClause) dashboardFilters.push(searchClause);
+      dashboardFilters.push(...extraClauses);
+      const { dashboardSort, config: queryConfig } = buildRemoteSort(config, withFormId, mode === "main" ? remote.sort : null);
+      if (formId && !ds.isTask && rt.client?.workflow?.getSingleForm) {
+        const form = await getFormOnce(rt.client, formId).catch((e) => {
+          console.warn(`[@zestl/zvolv-widgets] form lookup failed for ${formId}; querying anyway`, e);
+          return true;
+        });
+        if (!form) throw new Error("You don't have access to this widget's form.");
+      }
+      const fixedDs = mode === "main" && ALIGN_TYPES.has(String(widgetType ?? "").toUpperCase()) && hasDeclaredSeries(config) ? alignSummaryToSeries(withFormId, series) : withFormId;
+      const loggedInUser = rt.resolveQueryUser ? await rt.resolveQueryUser() : null;
+      const mappings = rt.prefetchQueryMappings ? await rt.prefetchQueryMappings(fixedDs.formId) : void 0;
+      if (!rt.generateQuery) throw new Error("runtime.generateQuery is not configured");
+      const query = rt.generateQuery(
+        queryConfig,
+        fixedDs,
+        fixedDs.formId,
+        0,
+        rowLimit,
+        [],
+        dashboardFilters,
+        [],
+        loggedInUser,
+        dashboardSort,
+        null,
+        fixedDs.isTask,
+        mappings
+      );
+      const res = await rt.client.workflow.elasticSearch(query);
+      return Array.isArray(res) ? res : res?.elements ?? res?.data ?? [];
+    };
     (async () => {
       try {
         const ds = dataSource || {};
         let fetched = [];
+        let fetchedBaseline;
         if (usesFormFramework(ds)) {
-          const formId = ds.formId ?? ds.fields?.[0]?.formID;
-          const withFormId = formId ? { ...ds, formId } : ds;
-          const merged = mergeHostFilters(localFilters, dashFilters);
-          const cfgWithDates = { ...config, cdateFilters };
-          const dashboardFilters = rt.formatDashboardFilters ? [...rt.formatDashboardFilters(cfgWithDates, withFormId, merged) || []] : [];
-          if (remote.widgetFilters?.length) {
-            dashboardFilters.push(...buildWidgetFilterClauses(withFormId, remote.widgetFilters));
-          }
-          if (remote.columnFilters && Object.keys(remote.columnFilters).length) {
-            dashboardFilters.push(...rt.formatHeaderFilters ? rt.formatHeaderFilters(withFormId, remote.columnFilters) || [] : buildColumnFilterClauses(withFormId, remote.columnFilters));
-          }
-          const searchClause = buildSearchClause(remote.search);
-          if (searchClause) dashboardFilters.push(searchClause);
-          const { dashboardSort, config: queryConfig } = buildRemoteSort(config, withFormId, remote.sort);
-          if (formId && !ds.isTask && rt.client?.workflow?.getSingleForm) {
-            const form = await getFormOnce(rt.client, formId).catch((e) => {
-              console.warn(`[@zestl/zvolv-widgets] form lookup failed for ${formId}; querying anyway`, e);
-              return true;
-            });
-            if (!form) throw new Error("You don't have access to this widget's form.");
-          }
-          const fixedDs = ALIGN_TYPES.has(String(widgetType ?? "").toUpperCase()) && hasDeclaredSeries(config) ? alignSummaryToSeries(withFormId, series) : withFormId;
-          const loggedInUser = rt.resolveQueryUser ? await rt.resolveQueryUser() : null;
-          const mappings = rt.prefetchQueryMappings ? await rt.prefetchQueryMappings(fixedDs.formId) : void 0;
-          if (!rt.generateQuery) throw new Error("runtime.generateQuery is not configured");
-          const query = rt.generateQuery(
-            queryConfig,
-            fixedDs,
-            fixedDs.formId,
-            0,
-            rowLimit,
-            [],
-            dashboardFilters,
-            [],
-            loggedInUser,
-            dashboardSort,
-            null,
-            fixedDs.isTask,
-            mappings
-          );
-          const res = await rt.client.workflow.elasticSearch(query);
-          fetched = Array.isArray(res) ? res : res?.elements ?? res?.data ?? [];
+          const baselineReq = dateGap?.baselineSource && dateGap.start ? queryForm(
+            dateGap.baselineSource.dataSource,
+            "baseline",
+            [baselineClause(dateGap.baselineSource, startOfPeriod(parseDateValue(dateGap.start, gapTimeZone), dateGap.unit, gapTimeZone))]
+          ).catch((e) => {
+            console.warn("[@zestl/zvolv-widgets] dateGap baseline fetch failed; starting from 0", e);
+            return [];
+          }) : null;
+          fetched = await queryForm(ds, "main");
+          if (baselineReq) fetchedBaseline = readBaseline(await baselineReq);
         } else {
           const wftype = config?.dataConfs?.WorkflowTypeID ?? workflowTypeId;
           const res = await rt.client.workflow.getDataSource(JSON.stringify({ widgetId, wftype }));
@@ -2907,7 +3285,7 @@ function useWidgetData(args) {
           fetched = payload?.table ?? (Array.isArray(payload) ? payload : []);
         }
         if (cancelled || seq !== reqSeq.current) return;
-        setSourceRows(normalize(fetched));
+        setSourceRows(normalize(fetched, fetchedBaseline));
       } catch (err) {
         if (cancelled || seq !== reqSeq.current) return;
         console.error(`[@zestl/zvolv-widgets] ${widgetType ?? "widget"} fetch failed:`, err);
@@ -2923,8 +3301,8 @@ function useWidgetData(args) {
     return () => {
       cancelled = true;
     };
-  }, [configKey, dashKey, cdateKey, localKey, dsKey, remoteKey, configured, nonce, automationRows, automationLoading]);
-  const userKind = React13.useMemo(() => {
+  }, [configKey, dashKey, cdateKey, localKey, dsKey, remoteKey, dateGapKey, configured, nonce, automationRows, automationLoading]);
+  const userKind = React14.useMemo(() => {
     if (!rt.getUserFieldKind) return null;
     const field2 = (dataSource?.fields || []).find(
       (f) => f?.masterfield === xKey || f?.header === xKey
@@ -2934,7 +3312,7 @@ function useWidgetData(args) {
     );
     return rt.getUserFieldKind(field2?.masterFieldType ?? pivotRow?.masterFieldType);
   }, [rt, dataSource, xKey]);
-  React13.useEffect(() => {
+  React14.useEffect(() => {
     if (!userKind || !rt.resolveUserLabels || sourceRows.length === 0) return;
     const pending2 = sourceRows.flatMap((row) => {
       const v = row?.[xKey];
@@ -2960,14 +3338,14 @@ function useWidgetData(args) {
       cancelled = true;
     };
   }, [sourceRows, userKind, xKey, rt]);
-  const toLabel = React13.useCallback((value) => {
+  const toLabel = React14.useCallback((value) => {
     if (!userKind || value === null || value === void 0 || value === "") return value;
     if (Array.isArray(value)) {
       return value.map((v) => userLabels[String(v)] ?? v).filter((v) => v !== "" && v != null).join(", ");
     }
     return userLabels[String(value)] ?? value;
   }, [userKind, userLabels]);
-  const rows = React13.useMemo(() => {
+  const rows = React14.useMemo(() => {
     let out = sourceRows;
     if (filterMode === "local" && widgetFilters?.length) out = applyLocalWidgetFilters(out, widgetFilters);
     if (tableMode === "local") {
@@ -2986,7 +3364,7 @@ function useWidgetData(args) {
     loading,
     initialLoading,
     error,
-    refresh: React13.useCallback(() => setNonce((n) => n + 1), []),
+    refresh: React14.useCallback(() => setNonce((n) => n + 1), []),
     meta: {
       xKey,
       series,
@@ -3000,10 +3378,10 @@ function useWidgetData(args) {
   };
 }
 function useControllable(controlled, initial, onChange) {
-  const [inner, setInner] = React13.useState(initial);
+  const [inner, setInner] = React14.useState(initial);
   const isControlled = controlled !== void 0;
   const value = isControlled ? controlled : inner;
-  const set = React13.useCallback((v) => {
+  const set = React14.useCallback((v) => {
     if (!isControlled) setInner(v);
     onChange?.(v);
   }, [isControlled, onChange]);
@@ -3030,56 +3408,56 @@ function useWidgetInteractions(props = {}) {
     props.defaultWidgetFilters ?? EMPTY_INTERACTIONS.widgetFilters,
     props.onWidgetFiltersChange
   );
-  const latest = React13.useRef({ search, columnFilters, sort, widgetFilters });
+  const latest = React14.useRef({ search, columnFilters, sort, widgetFilters });
   latest.current = { search, columnFilters, sort, widgetFilters };
   const onAny = props.onInteractionsChange;
-  const report = React13.useCallback((patch) => {
+  const report = React14.useCallback((patch) => {
     const next = { ...latest.current, ...patch };
     latest.current = next;
     onAny?.(next);
   }, [onAny]);
-  const setSearch = React13.useCallback((v) => {
+  const setSearch = React14.useCallback((v) => {
     setSearchRaw(v);
     report({ search: v });
   }, [setSearchRaw, report]);
-  const setColumnFilters = React13.useCallback((v) => {
+  const setColumnFilters = React14.useCallback((v) => {
     setColumnFiltersRaw(v);
     report({ columnFilters: v });
   }, [setColumnFiltersRaw, report]);
-  const setColumnFilter = React13.useCallback((key, values) => {
+  const setColumnFilter = React14.useCallback((key, values) => {
     const next = { ...latest.current.columnFilters };
     if (values && values.length) next[key] = values;
     else delete next[key];
     setColumnFilters(next);
   }, [setColumnFilters]);
-  const setSort = React13.useCallback((v) => {
+  const setSort = React14.useCallback((v) => {
     setSortRaw(v);
     report({ sort: v });
   }, [setSortRaw, report]);
-  const toggleSort = React13.useCallback((key) => {
+  const toggleSort = React14.useCallback((key) => {
     const cur = latest.current.sort;
     if (!cur || cur.key !== key) setSort({ key, direction: "asc" });
     else if (cur.direction === "asc") setSort({ key, direction: "desc" });
     else setSort(null);
   }, [setSort]);
-  const setWidgetFilters = React13.useCallback((v) => {
+  const setWidgetFilters = React14.useCallback((v) => {
     setWidgetFiltersRaw(v);
     report({ widgetFilters: v });
   }, [setWidgetFiltersRaw, report]);
-  const addWidgetFilter = React13.useCallback((f) => {
+  const addWidgetFilter = React14.useCallback((f) => {
     setWidgetFilters([...latest.current.widgetFilters, f]);
   }, [setWidgetFilters]);
-  const removeWidgetFilter = React13.useCallback((index) => {
+  const removeWidgetFilter = React14.useCallback((index) => {
     setWidgetFilters(latest.current.widgetFilters.filter((_2, i) => i !== index));
   }, [setWidgetFilters]);
-  const clearAll = React13.useCallback(() => {
+  const clearAll = React14.useCallback(() => {
     setSearchRaw("");
     setColumnFiltersRaw({});
     setSortRaw(null);
     setWidgetFiltersRaw([]);
     report({ ...EMPTY_INTERACTIONS });
   }, [setSearchRaw, setColumnFiltersRaw, setSortRaw, setWidgetFiltersRaw, report]);
-  return React13.useMemo(() => ({
+  return React14.useMemo(() => ({
     search,
     columnFilters,
     sort,
@@ -3192,7 +3570,7 @@ function describeWidgetFilter(f) {
 function useInteractiveWidgetData(props, options = {}) {
   const t = useTokens();
   const interactions = useWidgetInteractions(props);
-  const dataArgs = React13.useMemo(() => {
+  const dataArgs = React14.useMemo(() => {
     const rest = { ...props };
     for (const k of UI_KEYS) delete rest[k];
     return rest;
@@ -3204,7 +3582,7 @@ function useInteractiveWidgetData(props, options = {}) {
     sort: interactions.sort,
     widgetFilters: interactions.widgetFilters
   });
-  const config = React13.useMemo(
+  const config = React14.useMemo(
     () => resolveWidgetDefaults(t, props.widgetType, parseConfig(props.configurations)),
     [t, props.widgetType, props.configurations]
   );
@@ -3214,7 +3592,7 @@ function useInteractiveWidgetData(props, options = {}) {
     showColumnFilter: !!options.table && (props.showColumnFilter ?? !!(config?.showColumnFilter ?? config?.styling?.showColumnFilter ?? props.renderColumnFilter)),
     enableSort: !!options.table && (props.enableSort ?? config?.enableSort !== false)
   };
-  const seen = React13.useRef({ ds: "", values: /* @__PURE__ */ new Map() });
+  const seen = React14.useRef({ ds: "", values: /* @__PURE__ */ new Map() });
   const dsKey = JSON.stringify(props.dataSource ?? {});
   if (seen.current.ds !== dsKey) seen.current = { ds: dsKey, values: /* @__PURE__ */ new Map() };
   const getColumnOptions = (key) => {
@@ -3232,7 +3610,7 @@ function useInteractiveWidgetData(props, options = {}) {
     }
     return [...byValue.values()];
   };
-  const fields = React13.useMemo(() => filterableFields(props.dataSource), [dsKey]);
+  const fields = React14.useMemo(() => filterableFields(props.dataSource), [dsKey]);
   const searchNode = flags.showSearch ? (() => {
     const args = {
       value: interactions.search,
@@ -3275,7 +3653,7 @@ function useInteractiveWidgetData(props, options = {}) {
         tokens: t
       };
       parts.push(
-        /* @__PURE__ */ jsxRuntime.jsx(React13__default.default.Fragment, { children: props.renderSortIndicator ? props.renderSortIndicator(args) : /* @__PURE__ */ jsxRuntime.jsx(DefaultSortIndicator, { ...args }) }, "sort")
+        /* @__PURE__ */ jsxRuntime.jsx(React14__default.default.Fragment, { children: props.renderSortIndicator ? props.renderSortIndicator(args) : /* @__PURE__ */ jsxRuntime.jsx(DefaultSortIndicator, { ...args }) }, "sort")
       );
     }
     if (flags.showColumnFilter) {
@@ -3289,7 +3667,7 @@ function useInteractiveWidgetData(props, options = {}) {
         tokens: t
       };
       parts.push(
-        /* @__PURE__ */ jsxRuntime.jsx(React13__default.default.Fragment, { children: props.renderColumnFilter ? props.renderColumnFilter(args) : /* @__PURE__ */ jsxRuntime.jsx(DefaultColumnFilter, { ...args }) }, "filter")
+        /* @__PURE__ */ jsxRuntime.jsx(React14__default.default.Fragment, { children: props.renderColumnFilter ? props.renderColumnFilter(args) : /* @__PURE__ */ jsxRuntime.jsx(DefaultColumnFilter, { ...args }) }, "filter")
       );
     }
     return parts.length ? /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: parts }) : null;
@@ -3331,9 +3709,9 @@ var DefaultSearch = ({ value, setValue, placeholder, tokens: t }) => /* @__PURE_
   }
 );
 var Popover = ({ trigger, children, tokens: t, align = "right" }) => {
-  const [open, setOpen] = React13.useState(false);
-  const ref = React13.useRef(null);
-  React13.useEffect(() => {
+  const [open, setOpen] = React14.useState(false);
+  const ref = React14.useRef(null);
+  React14.useEffect(() => {
     if (!open) return;
     const onDown = (e) => {
       if (ref.current && !ref.current.contains(e.target)) setOpen(false);
@@ -3395,7 +3773,7 @@ var DefaultSortIndicator = ({ direction, toggle, column, tokens: t }) => /* @__P
   }
 );
 var DefaultColumnFilter = ({ column, selected, setSelected, clear, options, tokens: t }) => {
-  const [q, setQ] = React13.useState("");
+  const [q, setQ] = React14.useState("");
   const shown = options.filter((o) => !q || o.label.toLowerCase().includes(q.toLowerCase()));
   const isOn = (v) => selected.some((s) => String(s) === String(v));
   return /* @__PURE__ */ jsxRuntime.jsx(Popover, { tokens: t, align: "left", trigger: (_2, toggle) => /* @__PURE__ */ jsxRuntime.jsx(
@@ -3423,10 +3801,10 @@ var DefaultColumnFilter = ({ column, selected, setSelected, clear, options, toke
 };
 var DATE_TOKENS = ["TODAY", "YESTERDAY", "LAST_SEVEN_DAYS", "LAST_THIRTY_DAYS", "THIS_WEEK", "THIS_MONTH", "THIS_YEAR"];
 var DefaultWidgetFilter = ({ filters: filters2, addFilter, removeFilter, clear, fields, tokens: t }) => {
-  const [field2, setField] = React13.useState("");
-  const [operator, setOperator] = React13.useState("");
-  const [value, setValue] = React13.useState("");
-  const [value2, setValue2] = React13.useState("");
+  const [field2, setField] = React14.useState("");
+  const [operator, setOperator] = React14.useState("");
+  const [value, setValue] = React14.useState("");
+  const [value2, setValue2] = React14.useState("");
   const current = fields.find((f) => f.field === field2) ?? fields[0];
   const op = operator && current?.operators.includes(operator) ? operator : current?.operators[0] ?? "IN";
   const valueless = op === "EMPTY" || op === "NOT_EMPTY";
@@ -3662,7 +4040,7 @@ function useKpiContents({
   defaultIconColor = "#7b8499",
   dateFormatter
 }) {
-  return React13.useMemo(() => {
+  return React14.useMemo(() => {
     if (!contents?.length) return [];
     const row = rows?.[0];
     return contents.map((content, i) => {
@@ -3777,31 +4155,100 @@ function resolveDrillDown(config = {}) {
 }
 var WIDGET_TYPE = "KPI_CARD";
 var KpiWidget = (props) => {
-  const { title, description, emptyMessage, unconfiguredMessage, className, style, onItemClick, ...dataArgs } = props;
+  const {
+    title,
+    description,
+    emptyMessage,
+    unconfiguredMessage,
+    className,
+    style,
+    onItemClick,
+    externalSeriesByIndex,
+    ...dataArgs
+  } = props;
   const ix = useInteractiveWidgetData({ ...dataArgs, widgetType: WIDGET_TYPE });
   const { data, config, tokens: t } = ix;
   const chrome = resolveChromeConfig(config);
   const contents = config?.cardConfig?.contents ?? config?.contents ?? [];
   const cardTemplate = config?.cardConfig?.template ?? config?.template ?? "standard";
-  const vms = useKpiContents({ contents, rows: data.rows, cardTemplate });
+  const [fetchedSeries, setFetchedSeries] = React14.useState({});
+  const onSeries = React14.useCallback((index, values) => {
+    setFetchedSeries((prev) => {
+      if (JSON.stringify(prev[index]) === JSON.stringify(values)) return prev;
+      const next = { ...prev };
+      if (values) next[index] = values;
+      else delete next[index];
+      return next;
+    });
+  }, []);
+  const seriesByIndex = React14.useMemo(
+    () => externalSeriesByIndex ? { ...fetchedSeries, ...externalSeriesByIndex } : fetchedSeries,
+    [fetchedSeries, externalSeriesByIndex]
+  );
+  const vms = useKpiContents({ contents, rows: data.rows, cardTemplate, externalSeriesByIndex: seriesByIndex });
   const state = data.state === "empty" && contents.length > 0 ? "ready" : data.state;
-  return /* @__PURE__ */ jsxRuntime.jsx(
-    WidgetShell,
-    {
-      widgetType: WIDGET_TYPE,
-      title: chrome.showHeader ? title ?? chrome.title : void 0,
-      description: description ?? chrome.description,
-      state,
-      error: data.error,
-      emptyMessage: emptyMessage ?? chrome.emptyMessage,
-      unconfiguredMessage,
-      className,
-      style,
-      actions: ix.toolbar,
-      ...ix.shell,
-      children: /* @__PURE__ */ jsxRuntime.jsx("div", { style: { display: "flex", flexDirection: "column", gap: 14, height: "100%" }, children: vms.map((vm, i) => /* @__PURE__ */ jsxRuntime.jsx(KpiItem, { vm, index: i, onClick: onItemClick }, i)) })
-    }
+  return /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+    contents.map(
+      (content, i) => content?.seriesSource?.mode === "timeseries" && content.seriesSource.dataSource && !externalSeriesByIndex?.[i] ? /* @__PURE__ */ jsxRuntime.jsx(
+        KpiSeriesFetcher,
+        {
+          index: i,
+          source: content.seriesSource,
+          onSeries,
+          dashFilters: dataArgs.dashFilters,
+          cdateFilters: dataArgs.cdateFilters,
+          localFilters: dataArgs.localFilters,
+          workflowTypeId: dataArgs.workflowTypeId
+        },
+        i
+      ) : null
+    ),
+    /* @__PURE__ */ jsxRuntime.jsx(
+      WidgetShell,
+      {
+        widgetType: WIDGET_TYPE,
+        title: chrome.showHeader ? title ?? chrome.title : void 0,
+        description: description ?? chrome.description,
+        state,
+        error: data.error,
+        emptyMessage: emptyMessage ?? chrome.emptyMessage,
+        unconfiguredMessage,
+        className,
+        style,
+        actions: ix.toolbar,
+        ...ix.shell,
+        children: /* @__PURE__ */ jsxRuntime.jsx("div", { style: { display: "flex", flexDirection: "column", gap: 14, height: "100%" }, children: vms.map((vm, i) => /* @__PURE__ */ jsxRuntime.jsx(KpiItem, { vm, index: i, onClick: onItemClick }, i)) })
+      }
+    )
+  ] });
+};
+var KpiSeriesFetcher = ({ index, source, onSeries, dashFilters, cdateFilters, localFilters, workflowTypeId }) => {
+  const { dataSource, xField, valueField, dateGap } = source;
+  const configurations = React14.useMemo(
+    () => ({ series: [{ argumentField: xField, valueField }] }),
+    [xField, valueField]
   );
+  const data = useWidgetData({
+    widgetType: "KPI_SERIES",
+    dataSource,
+    configurations,
+    dateGap: dateGap ?? null,
+    dashFilters,
+    cdateFilters,
+    localFilters,
+    workflowTypeId
+  });
+  const values = React14.useMemo(
+    () => data.rows.map((r) => toNum(r?.[valueField])).filter((n) => n != null),
+    [data.rows, valueField]
+  );
+  const ready = data.state === "ready" || data.state === "empty";
+  const key = ready ? JSON.stringify(values) : "";
+  React14.useEffect(() => {
+    onSeries(index, ready ? values : void 0);
+  }, [index, key, ready, onSeries]);
+  React14.useEffect(() => () => onSeries(index, void 0), [index, onSeries]);
+  return null;
 };
 var KpiItem = ({
   vm,
@@ -3834,7 +4281,7 @@ var ChartWidget = (props) => {
   } = props;
   const ix = useInteractiveWidgetData({ ...dataArgs, widgetType });
   const { data, config, tokens: t } = ix;
-  const colorFor = React13.useMemo(() => {
+  const colorFor = React14.useMemo(() => {
     const palette = t.colors.charts.palette;
     return (index, s) => {
       if (s?.color) return s.color;
@@ -3858,7 +4305,7 @@ var ChartWidget = (props) => {
   const renderer = render ?? children;
   let body;
   if (renderer) body = renderer(args);
-  else if (override) body = React13__default.default.createElement(override, args);
+  else if (override) body = React14__default.default.createElement(override, args);
   else body = /* @__PURE__ */ jsxRuntime.jsx(FallbackBars, { ...args });
   return /* @__PURE__ */ jsxRuntime.jsx(
     WidgetShell,
@@ -3922,7 +4369,7 @@ var RankingBarWidget = (props) => {
   const valueField = ranking.valueField ?? data.meta.series[0]?.valueField ?? "value";
   const order = ranking.order === "asc" ? "asc" : "desc";
   const limit = toNum(ranking.limit) ?? 10;
-  const { rows, max } = React13.useMemo(() => {
+  const { rows, max } = React14.useMemo(() => {
     const mapped = data.rows.map((r) => ({
       label: r[labelField],
       value: toNum(r[valueField]) ?? 0,
@@ -3968,7 +4415,7 @@ var RankingBarWidget = (props) => {
       style,
       actions: ix.toolbar,
       ...ix.shell,
-      children: render ? render(args) : override ? React13__default.default.createElement(override, args) : /* @__PURE__ */ jsxRuntime.jsx(DefaultRanking, { ...args })
+      children: render ? render(args) : override ? React14__default.default.createElement(override, args) : /* @__PURE__ */ jsxRuntime.jsx(DefaultRanking, { ...args })
     }
   );
 };
@@ -4076,7 +4523,7 @@ var HeatMapWidget = (props) => {
     medium: toNum(hm.thresholds?.medium?.value) ?? 60,
     high: toNum(hm.thresholds?.high?.value) ?? 100
   };
-  const cells = React13.useMemo(() => data.rows.map((row) => {
+  const cells = React14.useMemo(() => data.rows.map((row) => {
     const count = toNum(row[countField]) ?? 0;
     const band = count <= thresholds.low ? "low" : count <= thresholds.medium ? "medium" : "high";
     const configured = hm.thresholds?.[band]?.color;
@@ -4191,7 +4638,7 @@ function resolveCollectionMapping(config, series) {
   return { ...fromSeries, ...block ?? config ?? {} };
 }
 function useCollectionItems(rows, mapping) {
-  return React13.useMemo(() => {
+  return React14.useMemo(() => {
     const m = mapping ?? {};
     const detailFields = m.fields ?? m.dataConfs ?? [];
     return rows.map((row, i) => {
@@ -4230,7 +4677,7 @@ var CollectionWidget = (props) => {
   const ix = useInteractiveWidgetData({ ...dataArgs, widgetType });
   const { data, config, tokens: t } = ix;
   const chrome = resolveChromeConfig(config);
-  const mapping = React13.useMemo(() => resolveCollectionMapping(config, data.meta.series), [config, data.meta.series]);
+  const mapping = React14.useMemo(() => resolveCollectionMapping(config, data.meta.series), [config, data.meta.series]);
   const items = useCollectionItems(data.rows, mapping);
   const template = config?.template || "standard";
   const override = useTemplateOverride(widgetType, template);
@@ -4256,7 +4703,7 @@ var CollectionWidget = (props) => {
       style,
       actions: ix.toolbar,
       ...ix.shell,
-      children: render ? render(args) : override ? React13__default.default.createElement(override, args) : /* @__PURE__ */ jsxRuntime.jsx(DefaultList, { ...args })
+      children: render ? render(args) : override ? React14__default.default.createElement(override, args) : /* @__PURE__ */ jsxRuntime.jsx(DefaultList, { ...args })
     }
   );
 };
@@ -4325,7 +4772,7 @@ var KIND_BY_TYPE = {
   RICHTEXT: "html"
 };
 function useTableColumns(explicit, config, rows) {
-  return React13.useMemo(() => {
+  return React14.useMemo(() => {
     if (explicit?.length) return explicit;
     const declared = [config?.columns, config?.additionalProperties?.columns, config?.fields, config?.table?.columns].find((d) => Array.isArray(d) && d.length);
     if (Array.isArray(declared) && declared.length) {
@@ -4506,11 +4953,11 @@ var PivotGridWidget = (props) => {
 };
 function toDate(v) {
   if (v === null || v === void 0 || v === "") return null;
-  const d = dayjs8__default.default(v);
+  const d = dayjs4__default.default(v);
   return d.isValid() ? d.toDate() : null;
 }
 function useTemporalEvents(rows, mapping) {
-  return React13.useMemo(() => {
+  return React14.useMemo(() => {
     const m = mapping ?? {};
     const titleField = m.taskTitle ?? m.titleField ?? m.title ?? m.labelField;
     const groupField = m.projectTitle ?? m.groupField ?? m.group ?? m.resourceField;
@@ -4531,7 +4978,7 @@ function useTemporalEvents(rows, mapping) {
         start,
         end,
         // With no time component on either bound, treat it as an all-day span.
-        allDay: !!(start && !end) || !!start && dayjs8__default.default(start).startOf("day").isSame(start),
+        allDay: !!(start && !end) || !!start && dayjs4__default.default(start).startOf("day").isSame(start),
         status: statusRaw !== void 0 ? { label: statusRaw, tone: statusTone(statusRaw) } : void 0,
         progress: Number.isFinite(rawProgress) ? Math.max(0, Math.min(1, rawProgress > 1 ? rawProgress / 100 : rawProgress)) : void 0,
         color: colorField ? row?.[colorField] : void 0,
@@ -4558,12 +5005,12 @@ var TemporalWidget = (props) => {
   const chrome = resolveChromeConfig(config);
   const mapping = config?.timeline ?? config?.gantt ?? config?.calendar ?? config?.scheduler ?? config?.mapping ?? config;
   const events = useTemporalEvents(data.rows, mapping);
-  const range = React13.useMemo(() => {
+  const range = React14.useMemo(() => {
     const stamps = events.flatMap((e) => [e.start, e.end].filter(Boolean).map((d) => d.getTime()));
     if (!stamps.length) return null;
     return { start: new Date(Math.min(...stamps)), end: new Date(Math.max(...stamps)) };
   }, [events]);
-  const lanes = React13.useMemo(() => {
+  const lanes = React14.useMemo(() => {
     const map = /* @__PURE__ */ new Map();
     events.forEach((e) => {
       const key = String(e.group ?? "");
@@ -4598,7 +5045,7 @@ var TemporalWidget = (props) => {
       style,
       actions: ix.toolbar,
       ...ix.shell,
-      children: render ? render(args) : override ? React13__default.default.createElement(override, args) : /* @__PURE__ */ jsxRuntime.jsx(DefaultTimeline, { ...args })
+      children: render ? render(args) : override ? React14__default.default.createElement(override, args) : /* @__PURE__ */ jsxRuntime.jsx(DefaultTimeline, { ...args })
     }
   );
 };
@@ -4625,8 +5072,8 @@ var DefaultTimeline = ({ events, tokens: t, onEventClick }) => /* @__PURE__ */ j
       /* @__PURE__ */ jsxRuntime.jsxs("div", { style: { minWidth: 0, flex: 1 }, children: [
         /* @__PURE__ */ jsxRuntime.jsx("div", { style: { fontSize: t.typography.body.fontSize, color: t.colors.textPrimary, fontWeight: 600 }, children: String(e.title ?? "") }),
         /* @__PURE__ */ jsxRuntime.jsxs("div", { style: { fontSize: t.typography.caption.fontSize, color: t.colors.textTertiary }, children: [
-          e.start ? dayjs8__default.default(e.start).format("DD MMM YYYY") : "",
-          e.end ? ` \u2192 ${dayjs8__default.default(e.end).format("DD MMM YYYY")}` : "",
+          e.start ? dayjs4__default.default(e.start).format("DD MMM YYYY") : "",
+          e.end ? ` \u2192 ${dayjs4__default.default(e.end).format("DD MMM YYYY")}` : "",
           e.group ? ` \xB7 ${String(e.group)}` : ""
         ] })
       ] }),
@@ -4657,7 +5104,7 @@ var StepperWidget = (props) => {
   const descField = stepper.descriptionField;
   const statusField = stepper.statusField ?? "status";
   const authored = Array.isArray(stepper.steps) && stepper.steps.length > 0;
-  const steps = React13.useMemo(() => {
+  const steps = React14.useMemo(() => {
     if (authored) {
       const live = stepper.statusField ? String(data.rows[0]?.[stepper.statusField] ?? "").trim().toLowerCase() : "";
       const liveIdx = live ? stepper.steps.findIndex((s) => String(s?.title ?? s?.label ?? "").trim().toLowerCase() === live) : -1;
@@ -4721,7 +5168,7 @@ var StepperWidget = (props) => {
       style,
       actions: ix.toolbar,
       ...ix.shell,
-      children: render ? render(args) : override ? React13__default.default.createElement(override, args) : /* @__PURE__ */ jsxRuntime.jsx(DefaultStepper, { ...args })
+      children: render ? render(args) : override ? React14__default.default.createElement(override, args) : /* @__PURE__ */ jsxRuntime.jsx(DefaultStepper, { ...args })
     }
   );
 };
@@ -4793,7 +5240,7 @@ function renderHtmlVariables(template, rows, variables) {
     } else if (v.dataFormat === "AMOUNT" && typeof value === "number") {
       value = formatAmountValue(value, v.amountSuffix || "Rupees", v.precision ?? 2);
     } else if (v.dataFormat === "DATE" && value) {
-      const d = dayjs8__default.default(value);
+      const d = dayjs4__default.default(value);
       if (d.isValid()) value = d.format(DATE_FORMAT_MAP[v.dateFormat] || "DD/MM/YYYY");
     }
     let text2;
@@ -4826,7 +5273,7 @@ var HtmlWidget = (props) => {
   const chrome = resolveChromeConfig(config);
   const template = config?.media?.htmlText ?? config?.html ?? config?.content ?? config?.rawHtml ?? "";
   const variables = Array.isArray(config?.variables) ? config.variables : [];
-  const html = React13.useMemo(
+  const html = React14.useMemo(
     () => variables.length ? renderHtmlVariables(template, data.rows, variables) : interpolate(template, data.rows[0]),
     [template, data.rows, variables]
   );
@@ -4863,7 +5310,7 @@ var IframeWidget = (props) => {
   const { data, config, tokens: t } = ix;
   const chrome = resolveChromeConfig(config);
   const raw2 = config?.media?.src ?? config?.url ?? config?.src ?? config?.iframe?.url ?? "";
-  const url = React13.useMemo(() => interpolate(raw2, data.rows[0]), [raw2, data.rows]);
+  const url = React14.useMemo(() => interpolate(raw2, data.rows[0]), [raw2, data.rows]);
   const state = url ? "ready" : data.state === "loading" ? "loading" : "unconfigured";
   return /* @__PURE__ */ jsxRuntime.jsx(
     WidgetShell,
@@ -4903,14 +5350,14 @@ var GoogleMapWidget = (props) => {
   const labelField = m.labelField ?? m.titleField ?? m.pinDataTitle;
   const centerLat = gm?.center?.latitude ?? m.centerLat;
   const centerLng = gm?.center?.longitude ?? m.centerLng;
-  const markers = React13.useMemo(() => data.rows.flatMap((row, i) => {
+  const markers = React14.useMemo(() => data.rows.flatMap((row, i) => {
     const lat = Number(row?.[latField]);
     const lng = Number(row?.[lngField]);
     if (!Number.isFinite(lat) || !Number.isFinite(lng)) return [];
     const label = titleParts.length ? titleParts.map((p, k) => `${k ? p.separator ?? " " : ""}${row?.[p.field] ?? ""}`).join("").trim() : labelField ? row?.[labelField] : void 0;
     return [{ id: row?.id ?? i, lat, lng, label, raw: row }];
   }), [data.rows, latField, lngField, labelField, titleParts]);
-  const center = React13.useMemo(() => {
+  const center = React14.useMemo(() => {
     if (centerLat != null && centerLng != null && Number.isFinite(Number(centerLat))) {
       return { lat: Number(centerLat), lng: Number(centerLng) };
     }
@@ -4957,7 +5404,7 @@ var ActionCardWidget = (props) => {
   const ix = useInteractiveWidgetData({ ...dataArgs, widgetType: "ACTION_CARD" });
   const { data, config, tokens: t } = ix;
   const chrome = resolveChromeConfig(config);
-  const actions = React13.useMemo(() => {
+  const actions = React14.useMemo(() => {
     const declared = config?.actions ?? config?.buttons ?? (config?.action ? [{ ...config.action, actionType: config.actionType, label: config.action.label ?? config.action.FormTitle }] : []);
     return declared.map((a, i) => ({
       id: a?.id ?? a?.FormID ?? i,
@@ -5038,7 +5485,7 @@ var TreeWidget = (props) => {
   const { data, config, tokens: t } = ix;
   const chrome = resolveChromeConfig(config);
   const tree = config?.treeConfiguration ?? config?.tree ?? config ?? {};
-  const nodes = React13.useMemo(() => buildTree(
+  const nodes = React14.useMemo(() => buildTree(
     data.rows,
     tree.idField ?? "id",
     tree.parentField ?? "parentId",
@@ -5873,7 +6320,7 @@ function dynamicDefault(el2, user) {
   const t = resolveFieldType(el2);
   if ((dd.operator === "ADD" || dd.operator === "SUB") && (t === "DATE_PICKER" || t === "DATE_TIME_PICKER")) {
     const sign = dd.operator === "SUB" ? -1 : 1;
-    let d = dayjs8__default.default();
+    let d = dayjs4__default.default();
     const u = dd.units;
     if (typeof u === "number" || typeof u === "string" && u.trim() !== "" && !isNaN(Number(u))) d = d.add(sign * Number(u), "day");
     else Object.entries(u ?? {}).forEach(([k, n]) => {
@@ -5913,7 +6360,7 @@ function buildInitialValues(elements, opts = {}) {
 }
 function formatDateish(t, value) {
   const isDayjs = (v) => v && typeof v === "object" && typeof v.isValid === "function" && typeof v.format === "function";
-  const toD = (v) => isDayjs(v) ? v : v instanceof Date ? dayjs8__default.default(v) : typeof v === "string" && v ? dayjs8__default.default(v) : null;
+  const toD = (v) => isDayjs(v) ? v : v instanceof Date ? dayjs4__default.default(v) : typeof v === "string" && v ? dayjs4__default.default(v) : null;
   if (t === "DATE_PICKER") {
     const d = toD(value);
     return d?.isValid() ? d.format("YYYY-MM-DD") : value;
@@ -6028,9 +6475,9 @@ function formatFieldValue(el2, value) {
   const t = resolveFieldType(el2);
   if (t === "CHECK_BOX") return value ? "Yes" : "No";
   if (RELATIONAL_TYPES.has(t)) return (Array.isArray(value) ? value : [value]).map((v) => v?.view ?? v?.select ?? String(v)).join(", ");
-  if (t === "INPUT_DATE_RANGE" && Array.isArray(value)) return value.filter(Boolean).map((v) => dayjs8__default.default(v).format("D MMM YYYY")).join(" \u2013 ");
-  if (t === "DATE_PICKER") return dayjs8__default.default(value).isValid() ? dayjs8__default.default(value).format("D MMM YYYY") : String(value);
-  if (t === "DATE_TIME_PICKER") return dayjs8__default.default(value).isValid() ? dayjs8__default.default(value).format("D MMM YYYY, HH:mm") : String(value);
+  if (t === "INPUT_DATE_RANGE" && Array.isArray(value)) return value.filter(Boolean).map((v) => dayjs4__default.default(v).format("D MMM YYYY")).join(" \u2013 ");
+  if (t === "DATE_PICKER") return dayjs4__default.default(value).isValid() ? dayjs4__default.default(value).format("D MMM YYYY") : String(value);
+  if (t === "DATE_TIME_PICKER") return dayjs4__default.default(value).isValid() ? dayjs4__default.default(value).format("D MMM YYYY, HH:mm") : String(value);
   if (t === "INPUT_PERCENT") return `${value}%`;
   if (Array.isArray(value)) return value.map((v) => v?.media_name ?? v?.view ?? String(v)).join(", ");
   return String(value);
@@ -6494,28 +6941,28 @@ var isFilled = (v) => v != null && v !== "" && !(Array.isArray(v) && !v.length);
 function useFieldOptions(form, field2, opts = {}) {
   const { debounceMs = 250, loadOn = "focus", autofillExtraLabels = false } = opts;
   const el2 = field2.element;
-  const cfg = React13.useMemo(() => field2.kind === "lookup" ? lookupConfigOf(el2) : null, [field2.kind, el2]);
+  const cfg = React14.useMemo(() => field2.kind === "lookup" ? lookupConfigOf(el2) : null, [field2.kind, el2]);
   const people = field2.kind === "user" && !!(el2.properties?.jsonData || el2.properties?.searchType === "GENERIC_FORM_AUTO_SEARCH");
   const elements = form.definition?.elements ?? [];
-  const rules = React13.useMemo(() => optionFilterRules(elements, field2.id), [elements, field2.id]);
-  const dep = React13.useMemo(() => cfg ? lookupDependencyFilters(cfg, rules, elements, form.values) : { filters: [], satisfied: true }, [cfg, rules, elements, form.values]);
+  const rules = React14.useMemo(() => optionFilterRules(elements, field2.id), [elements, field2.id]);
+  const dep = React14.useMemo(() => cfg ? lookupDependencyFilters(cfg, rules, elements, form.values) : { filters: [], satisfied: true }, [cfg, rules, elements, form.values]);
   const depKey = JSON.stringify(dep.filters);
   const maxCount = cfg ? cfg.maxResults : field2.kind === "user" ? maxResultsOf(el2) : field2.multiple ? Infinity : 1;
   const single = maxCount === 1;
-  const [search, setSearch] = React13.useState("");
-  const [q, setQ] = React13.useState("");
-  React13.useEffect(() => {
+  const [search, setSearch] = React14.useState("");
+  const [q, setQ] = React14.useState("");
+  React14.useEffect(() => {
     const t = setTimeout(() => setQ(search), debounceMs);
     return () => clearTimeout(t);
   }, [search, debounceMs]);
-  const [remote, setRemote] = React13.useState([]);
-  const [loading, setLoading] = React13.useState(false);
-  const [error, setError] = React13.useState(null);
-  const [opened, setOpened] = React13.useState(loadOn === "mount");
-  const [nonce, setNonce] = React13.useState(0);
-  const lastFetch = React13.useRef(0);
-  const maxAge = React13.useRef(1e4);
-  const waitingFor = React13.useMemo(() => {
+  const [remote, setRemote] = React14.useState([]);
+  const [loading, setLoading] = React14.useState(false);
+  const [error, setError] = React14.useState(null);
+  const [opened, setOpened] = React14.useState(loadOn === "mount");
+  const [nonce, setNonce] = React14.useState(0);
+  const lastFetch = React14.useRef(0);
+  const maxAge = React14.useRef(1e4);
+  const waitingFor = React14.useMemo(() => {
     if (!cfg || dep.satisfied || cfg.operator !== "$and") return null;
     const missing = rules.find((r) => !isFilled(form.values[r.elementId]));
     const lbl = missing ? form.field(missing.elementId)?.label : cfg.dynamicFilters[0]?.DependencyFieldLabel;
@@ -6523,7 +6970,7 @@ function useFieldOptions(form, field2, opts = {}) {
   }, [cfg, dep.satisfied, rules, form]);
   const depDriven = !!cfg && rules.length > 0 && dep.filters.length > 0;
   const active = opened || depDriven || q !== "";
-  React13.useEffect(() => {
+  React14.useEffect(() => {
     if (!cfg && !people) return;
     if (cfg && (waitingFor || cfg.loadOnDependency && !dep.filters.length && rules.length)) {
       setRemote([]);
@@ -6549,12 +6996,12 @@ function useFieldOptions(form, field2, opts = {}) {
       alive = false;
     };
   }, [cfg, people, depKey, q, waitingFor, form.client, active, nonce]);
-  const refresh = React13.useCallback(() => {
+  const refresh = React14.useCallback(() => {
     maxAge.current = 0;
     setOpened(true);
     setNonce((n) => n + 1);
   }, []);
-  const onFocus = React13.useCallback(() => {
+  const onFocus = React14.useCallback(() => {
     if (!cfg && !people) return;
     if (!opened) {
       setOpened(true);
@@ -6565,8 +7012,8 @@ function useFieldOptions(form, field2, opts = {}) {
       setNonce((n) => n + 1);
     } else if (people && !remote.length) setNonce((n) => n + 1);
   }, [cfg, people, opened, remote.length]);
-  const prevDepKey = React13.useRef(null);
-  React13.useEffect(() => {
+  const prevDepKey = React14.useRef(null);
+  React14.useEffect(() => {
     if (!cfg || !rules.length) return;
     if (prevDepKey.current === null) {
       prevDepKey.current = depKey;
@@ -6577,14 +7024,14 @@ function useFieldOptions(form, field2, opts = {}) {
     if (form.readOnly) return;
     if (isFilled(form.values[field2.id])) form.setValue(field2.id, single ? null : []);
   }, [depKey]);
-  const staticFiltered = React13.useMemo(() => {
+  const staticFiltered = React14.useMemo(() => {
     if (cfg || people) return remote;
     const needle = search.trim().toLowerCase();
     return needle ? field2.options.filter((o) => o.label.toLowerCase().includes(needle)) : field2.options;
   }, [cfg, people, remote, field2.options, search]);
-  const pickedCache = React13.useRef(/* @__PURE__ */ new Map());
+  const pickedCache = React14.useRef(/* @__PURE__ */ new Map());
   const current = field2.value;
-  const selected = React13.useMemo(() => {
+  const selected = React14.useMemo(() => {
     const arr = current == null || current === "" ? [] : Array.isArray(current) ? current : [current];
     const pool = [...staticFiltered, ...field2.options];
     return arr.map((v) => {
@@ -6594,7 +7041,7 @@ function useFieldOptions(form, field2, opts = {}) {
       return { label: String(v), value: v };
     });
   }, [current, staticFiltered, field2.options]);
-  const store = React13.useCallback((picked) => {
+  const store = React14.useCallback((picked) => {
     picked.forEach((o) => pickedCache.current.set(optionKey(o.value), o));
     const t = field2.type;
     if (field2.kind === "lookup") {
@@ -6614,24 +7061,24 @@ function useFieldOptions(form, field2, opts = {}) {
     if (field2.multiple) form.setValue(field2.id, picked.slice(0, maxCount).map((o) => o.value));
     else form.setValue(field2.id, picked[0]?.value ?? (t === "CHECK_BOX" ? false : ""));
   }, [field2, form, cfg, single, maxCount, autofillExtraLabels]);
-  const autoPickRef = React13.useRef(() => {
+  const autoPickRef = React14.useRef(() => {
   });
-  const lastAutoKey = React13.useRef(null);
+  const lastAutoKey = React14.useRef(null);
   autoPickRef.current = (o, key) => {
     if (form.readOnly || lastAutoKey.current === key) return;
     lastAutoKey.current = key;
     if (isFilled(form.values[field2.id])) return;
     store([o]);
   };
-  const select = React13.useCallback((o) => store(o == null ? [] : Array.isArray(o) ? o : [o]), [store]);
-  const isSelected = React13.useCallback((o) => selected.some((s) => optionKey(s.value) === optionKey(o.value)), [selected]);
+  const select = React14.useCallback((o) => store(o == null ? [] : Array.isArray(o) ? o : [o]), [store]);
+  const isSelected = React14.useCallback((o) => selected.some((s) => optionKey(s.value) === optionKey(o.value)), [selected]);
   const atLimit = field2.multiple && selected.length >= maxCount;
-  const toggle = React13.useCallback((o) => {
+  const toggle = React14.useCallback((o) => {
     const on = isSelected(o);
     if (!on && field2.multiple && selected.length >= maxCount) return;
     store(on ? selected.filter((s) => optionKey(s.value) !== optionKey(o.value)) : field2.multiple ? [...selected, o] : [o]);
   }, [isSelected, selected, store, field2.multiple, maxCount]);
-  const addFreeTag = React13.useCallback((text2) => {
+  const addFreeTag = React14.useCallback((text2) => {
     const t = text2.trim();
     if (!t || field2.type !== "INPUT_TAG") return;
     const o = { label: t, value: t, extra: [], raw: { view: t, select: t, extraLabels: [] } };
@@ -6662,9 +7109,9 @@ function useFieldOptions(form, field2, opts = {}) {
 var BLOCKED_FILE_EXTENSIONS = new Set("ade adp app application appref-ms asp aspx asx bas bat bgi cab cer chm cmd cnt com cpl crt csh der diagcab exe fxp gadget grp hlp hpj hta htc inf ins iso isp its jar jnlp js jse ksh lnk mad maf mag mam maq mar mas mat mau mav maw mcf mda mdb mde mdt mdw mdz msc msh msh1 msh2 mshxml msh1xml msh2xml msi msp mst msu ops osd pcd pif pl plg prf ps1 ps1xml ps2 ps2xml psc1 psc2 reg scr scf sln vbs vb vbe ws wsf wsc wsh z bz2 ace ppkg bak tmp ost pst pkg vhd vhdx lock lck cs csproj resx config resources pdb manifest dot wbk xlt xlm xla pot pps cdb mdn sh php mdf py ldb wps xlsb xlam xll xlw ppam".split(" "));
 function useFileField(form, field2, opts = {}) {
   const stored = Array.isArray(field2.value) ? field2.value : [];
-  const [pending2, setPending] = React13.useState([]);
-  const [reject, setReject] = React13.useState(null);
-  const storedRef = React13.useRef(stored);
+  const [pending2, setPending] = React14.useState([]);
+  const [reject, setReject] = React14.useState(null);
+  const storedRef = React14.useRef(stored);
   storedRef.current = stored;
   const items = [
     ...stored.map((r, i) => ({
@@ -6679,7 +7126,7 @@ function useFileField(form, field2, opts = {}) {
     ...pending2
   ];
   const max = field2.maxCount;
-  const add = React13.useCallback((list) => {
+  const add = React14.useCallback((list) => {
     setReject(null);
     const files = Array.from(list);
     const room = max ? Math.max(0, max - storedRef.current.length - pending2.filter((p) => p.uploading).length) : files.length;
@@ -6713,7 +7160,7 @@ function useFileField(form, field2, opts = {}) {
     });
     if (files.length > room) setReject(`Only ${room} more file${room === 1 ? "" : "s"} can be attached`);
   }, [form, field2, max, pending2, opts.zappId]);
-  const remove = React13.useCallback((key) => {
+  const remove = React14.useCallback((key) => {
     if (key.startsWith("p")) {
       setPending((p) => p.filter((x) => x.key !== key));
       return;
@@ -6733,10 +7180,10 @@ function sheetAllows(p, action) {
 }
 function useSheetField(form, field2) {
   const childId = String(field2.element.properties?.formID ?? field2.element.properties?.FormID ?? field2.element.properties?.nestedFormId ?? field2.element.properties?.dataSource?.FormID ?? "");
-  const [child, setChild] = React13.useState(null);
-  const [loading, setLoading] = React13.useState(!!childId);
-  const [error, setError] = React13.useState(childId ? null : "No child form configured");
-  React13.useEffect(() => {
+  const [child, setChild] = React14.useState(null);
+  const [loading, setLoading] = React14.useState(!!childId);
+  const [error, setError] = React14.useState(childId ? null : "No child form configured");
+  React14.useEffect(() => {
     if (!childId) return;
     let alive = true;
     setLoading(true);
@@ -6755,7 +7202,7 @@ function useSheetField(form, field2) {
       alive = false;
     };
   }, [childId, form.client]);
-  const columns = React13.useMemo(() => (child?.elements ?? []).filter((e) => !e.hidden && !["COLLAPSE_SECTION", "CONTAINER", "GROUP_VIEW", "TEXT_VIEW", "ACTION_BUTTON"].includes(resolveFieldType(e))).map((e) => ({
+  const columns = React14.useMemo(() => (child?.elements ?? []).filter((e) => !e.hidden && !["COLLAPSE_SECTION", "CONTAINER", "GROUP_VIEW", "TEXT_VIEW", "ACTION_BUTTON"].includes(resolveFieldType(e))).map((e) => ({
     id: e.elementId,
     label: e.label,
     type: resolveFieldType(e),
@@ -6766,10 +7213,10 @@ function useSheetField(form, field2) {
   const rows = (Array.isArray(field2.value) ? field2.value : []).filter((r) => r && typeof r === "object");
   const p = field2.element.properties ?? {};
   const maxRows = Number(p.maxRows) > 0 ? Number(p.maxRows) : void 0;
-  const [limitMessage, setLimitMessage] = React13.useState(null);
+  const [limitMessage, setLimitMessage] = React14.useState(null);
   const addAllowed = !field2.disabled && sheetAllows(p, "ADD");
   const canDelete = !field2.disabled && sheetAllows(p, "DELETE");
-  const addRow = React13.useCallback((vals) => {
+  const addRow = React14.useCallback((vals) => {
     if (!addAllowed) return;
     if (maxRows && rows.length >= maxRows) {
       setLimitMessage(`Maximum number of rows reached (${maxRows})`);
@@ -6779,16 +7226,16 @@ function useSheetField(form, field2) {
     const blank = child ? computeRowFormulas(child.elements, buildInitialValues(child.elements, { defaults: vals })) : { ...vals ?? {} };
     form.setValue(field2.id, [...rows, { ...blank, _rowKey: `r${Date.now()}${Math.random()}` }]);
   }, [child, rows, form, field2.id, addAllowed, maxRows]);
-  const updateRow = React13.useCallback((i, col, v) => {
+  const updateRow = React14.useCallback((i, col, v) => {
     const recalc = (r) => child ? computeRowFormulas(child.elements, r) : r;
     form.setValue(field2.id, rows.map((r, j) => j === i ? recalc({ ...r, [col]: v, _dirty: true }) : r));
   }, [rows, form, field2.id, child]);
-  const removeRow = React13.useCallback((i) => {
+  const removeRow = React14.useCallback((i) => {
     if (!canDelete) return;
     setLimitMessage(null);
     form.setValue(field2.id, rows.filter((_2, j) => j !== i));
   }, [rows, form, field2.id, canDelete]);
-  const rowErrors = React13.useMemo(() => {
+  const rowErrors = React14.useMemo(() => {
     const out = {};
     if (!form.submitAttempted) return out;
     rows.forEach((r, i) => {
@@ -6848,9 +7295,9 @@ function acceptOf(el2) {
   if (!list.length) return el2.type === "UPLOAD_FILE_IMAGE" ? "image/*" : void 0;
   return list.map((s) => s.includes("/") || s.startsWith(".") ? s : `.${s}`).join(",");
 }
-var FormApiContext = React13__default.default.createContext(null);
+var FormApiContext = React14__default.default.createContext(null);
 function useFormApi() {
-  const f = React13__default.default.useContext(FormApiContext);
+  const f = React14__default.default.useContext(FormApiContext);
   if (!f) throw new Error("@zestl/zvolv-widgets: useFormApi must be used inside <ZvolvForm> or FormApiContext");
   return f;
 }
@@ -6859,34 +7306,34 @@ function useZvolvForm(args) {
   const mode = args.mode ?? (submissionId ? "EDIT" : "NEW");
   const rt = useZvolvRuntime();
   const client = rt.client;
-  const argsRef = React13.useRef(args);
+  const argsRef = React14.useRef(args);
   argsRef.current = args;
-  const [definition, setDefinition] = React13.useState(null);
-  const [status, setStatus] = React13.useState("loading");
-  const [error, setError] = React13.useState(null);
-  const [values, setValues] = React13.useState({});
-  const [serverErrors, setServerErrors] = React13.useState({});
-  const [touched, setTouched] = React13.useState(/* @__PURE__ */ new Set());
-  const [submitAttempted, setSubmitAttempted] = React13.useState(false);
-  const [flagged, setFlagged] = React13.useState(/* @__PURE__ */ new Set());
-  const [submitting, setSubmitting] = React13.useState(false);
-  const [submitError, setSubmitError] = React13.useState(null);
-  const [submittedId, setSubmittedId] = React13.useState(null);
-  const [dirty, setDirty] = React13.useState(false);
-  const [busy, setBusy] = React13.useState(/* @__PURE__ */ new Set());
-  const initialRef = React13.useRef({});
-  const valuesRef = React13.useRef({});
+  const [definition, setDefinition] = React14.useState(null);
+  const [status, setStatus] = React14.useState("loading");
+  const [error, setError] = React14.useState(null);
+  const [values, setValues] = React14.useState({});
+  const [serverErrors, setServerErrors] = React14.useState({});
+  const [touched, setTouched] = React14.useState(/* @__PURE__ */ new Set());
+  const [submitAttempted, setSubmitAttempted] = React14.useState(false);
+  const [flagged, setFlagged] = React14.useState(/* @__PURE__ */ new Set());
+  const [submitting, setSubmitting] = React14.useState(false);
+  const [submitError, setSubmitError] = React14.useState(null);
+  const [submittedId, setSubmittedId] = React14.useState(null);
+  const [dirty, setDirty] = React14.useState(false);
+  const [busy, setBusy] = React14.useState(/* @__PURE__ */ new Set());
+  const initialRef = React14.useRef({});
+  const valuesRef = React14.useRef({});
   valuesRef.current = values;
-  const sheetDefs = React13.useRef(/* @__PURE__ */ new Map());
-  const [userTick, setUserTick] = React13.useState(0);
-  React13.useEffect(() => {
+  const sheetDefs = React14.useRef(/* @__PURE__ */ new Map());
+  const [userTick, setUserTick] = React14.useState(0);
+  React14.useEffect(() => {
     if (typeof window === "undefined") return;
     const bump = () => setUserTick((n) => n + 1);
     window.addEventListener(AUTH_CRYPT_READY, bump);
     return () => window.removeEventListener(AUTH_CRYPT_READY, bump);
   }, []);
-  const user = React13.useMemo(() => getStoredUser() ?? null, [client, userTick]);
-  React13.useEffect(() => {
+  const user = React14.useMemo(() => getStoredUser() ?? null, [client, userTick]);
+  React14.useEffect(() => {
     if (status !== "ready" || mode !== "NEW") return;
     const uid = currentUserId(user);
     if (!uid) return;
@@ -6901,7 +7348,7 @@ function useZvolvForm(args) {
       return m;
     });
   }, [user, status]);
-  const onBehalfName = React13.useCallback((v) => {
+  const onBehalfName = React14.useCallback((v) => {
     if (v == null || v === "") return "";
     if (String(v) === "3122") return "Super Admin";
     if (isEncString(v)) return "";
@@ -6911,9 +7358,9 @@ function useZvolvForm(args) {
     }
     return String(v);
   }, [user]);
-  const [reloadTick, setReloadTick] = React13.useState(0);
+  const [reloadTick, setReloadTick] = React14.useState(0);
   const loadKey = JSON.stringify([formId, submissionId, mode, !!suppliedDef, reloadTick]);
-  React13.useEffect(() => {
+  React14.useEffect(() => {
     let alive = true;
     setStatus("loading");
     setError(null);
@@ -6962,13 +7409,13 @@ function useZvolvForm(args) {
     };
   }, [loadKey, client]);
   const elements = definition?.elements ?? [];
-  const byId = React13.useMemo(() => new Map(elements.map((e) => [e.elementId, e])), [elements]);
-  const labels = React13.useMemo(() => elements.map((e) => e.label).filter(Boolean), [elements]);
-  const overrides = React13.useMemo(() => applyRules(elements, values), [elements, values]);
+  const byId = React14.useMemo(() => new Map(elements.map((e) => [e.elementId, e])), [elements]);
+  const labels = React14.useMemo(() => elements.map((e) => e.label).filter(Boolean), [elements]);
+  const overrides = React14.useMemo(() => applyRules(elements, values), [elements, values]);
   const readOnly = mode === "DISABLED" || !!definition?.configurations?.editingLocked;
-  const hiddenSet = React13.useMemo(() => new Set(hiddenFields ?? []), [hiddenFields]);
-  const skipSet = React13.useMemo(() => new Set((skipTypes ?? []).map((s) => s.toUpperCase())), [skipTypes]);
-  const hiddenByParent = React13.useMemo(() => {
+  const hiddenSet = React14.useMemo(() => new Set(hiddenFields ?? []), [hiddenFields]);
+  const skipSet = React14.useMemo(() => new Set((skipTypes ?? []).map((s) => s.toUpperCase())), [skipTypes]);
+  const hiddenByParent = React14.useMemo(() => {
     const out = /* @__PURE__ */ new Set();
     const visit = (el2) => childIdsOf(el2).forEach((id) => {
       if (out.has(id)) return;
@@ -6983,7 +7430,7 @@ function useZvolvForm(args) {
     });
     return out;
   }, [elements, overrides, byId]);
-  const stateOf = React13.useCallback((el2) => {
+  const stateOf = React14.useCallback((el2) => {
     const o = overrides.get(el2.elementId) ?? {};
     return {
       hidden: hiddenByParent.has(el2.elementId) || (o.isHidden ?? el2.hidden),
@@ -6991,7 +7438,7 @@ function useZvolvForm(args) {
       required: o.isRequired ?? el2.required
     };
   }, [overrides, readOnly, hiddenByParent]);
-  React13.useEffect(() => {
+  React14.useEffect(() => {
     if (status !== "ready") return;
     const formulas = elements.filter((e) => resolveFieldType(e) === "INPUT_FORMULA" && e.properties?.formula);
     if (!formulas.length) return;
@@ -7013,7 +7460,7 @@ function useZvolvForm(args) {
     });
     if (Object.keys(next).length) setValues((prev) => ({ ...prev, ...next }));
   }, [values, elements, labels, status]);
-  const applyValues = React13.useCallback((data) => {
+  const applyValues = React14.useCallback((data) => {
     if (!data || typeof data !== "object") return;
     const loose = (s) => String(s).toLowerCase().replace(/[^a-z0-9]+/g, "");
     const index = /* @__PURE__ */ new Map();
@@ -7037,7 +7484,7 @@ function useZvolvForm(args) {
       return merged;
     });
   }, [elements]);
-  const withBusy = React13.useCallback(async (id, fn) => {
+  const withBusy = React14.useCallback(async (id, fn) => {
     setBusy((b) => new Set(b).add(id));
     try {
       return await fn();
@@ -7049,11 +7496,11 @@ function useZvolvForm(args) {
       });
     }
   }, []);
-  const triggerBody = React13.useCallback(
+  const triggerBody = React14.useCallback(
     (vals) => buildTriggerBody(elements, vals, { formId: definition?.uuid ?? formId, submissionId: submissionId ?? submittedId }),
     [elements, definition, formId, submissionId, submittedId]
   );
-  const runFieldAutomations = React13.useCallback((el2, vals) => {
+  const runFieldAutomations = React14.useCallback((el2, vals) => {
     if (argsRef.current.skipAutomation) return;
     const acts = (el2.properties?.actions ?? []).filter((a) => String(a?.type ?? "").toUpperCase() === "TRIGGER_AUTOMATION" && (a.triggerID ?? a.triggerId));
     acts.forEach((a) => {
@@ -7069,7 +7516,7 @@ function useZvolvForm(args) {
       });
     });
   }, [client, triggerBody, applyValues, withBusy]);
-  const setValue = React13.useCallback((id, value) => {
+  const setValue = React14.useCallback((id, value) => {
     const el2 = byId.get(id);
     const next = { ...valuesRef.current, [id]: value };
     valuesRef.current = next;
@@ -7089,16 +7536,16 @@ function useZvolvForm(args) {
       if (other.elementId !== id && Array.isArray(watch) && watch.map(String).includes(id)) runFieldAutomations(other, next);
     });
   }, [byId, elements, runFieldAutomations]);
-  const touch = React13.useCallback((id) => setTouched((t) => t.has(id) ? t : new Set(t).add(id)), []);
-  const clientErrors = React13.useMemo(
+  const touch = React14.useCallback((id) => setTouched((t) => t.has(id) ? t : new Set(t).add(id)), []);
+  const clientErrors = React14.useMemo(
     () => validateForm(elements, values, (el2) => {
       const s = stateOf(el2);
       return { hidden: s.hidden || hiddenSet.has(el2.elementId) || hiddenSet.has(el2.label), required: s.required };
     }),
     [elements, values, stateOf, hiddenSet]
   );
-  const errors = React13.useMemo(() => ({ ...clientErrors, ...Object.fromEntries(Object.entries(serverErrors).filter(([, v]) => v)) }), [clientErrors, serverErrors]);
-  const validate = React13.useCallback((ids) => {
+  const errors = React14.useMemo(() => ({ ...clientErrors, ...Object.fromEntries(Object.entries(serverErrors).filter(([, v]) => v)) }), [clientErrors, serverErrors]);
+  const validate = React14.useCallback((ids) => {
     const keys = ids ?? Object.keys(errors);
     if (ids) setTouched((t) => {
       const n = new Set(t);
@@ -7114,7 +7561,7 @@ function useZvolvForm(args) {
     });
     return !bad.length;
   }, [errors]);
-  const fields = React13.useMemo(() => elements.map((el2) => {
+  const fields = React14.useMemo(() => elements.map((el2) => {
     const t = resolveFieldType(el2);
     const kind = fieldKindOf(el2);
     const s = stateOf(el2);
@@ -7164,18 +7611,18 @@ function useZvolvForm(args) {
     };
     return f;
   }), [elements, values, errors, stateOf, touched, flagged, serverErrors, hiddenSet, skipSet, setValue, touch, onBehalfName]);
-  const fieldMap2 = React13.useMemo(() => new Map(fields.map((f) => [f.id, f])), [fields]);
-  const claimed = React13.useMemo(() => {
+  const fieldMap2 = React14.useMemo(() => new Map(fields.map((f) => [f.id, f])), [fields]);
+  const claimed = React14.useMemo(() => {
     const s = /* @__PURE__ */ new Set();
     fields.forEach((f) => f.childIds.forEach((c) => s.add(c)));
     return s;
   }, [fields]);
-  const rootFields = React13.useMemo(() => fields.filter((f) => !claimed.has(f.id) && !f.hidden && f.kind !== "unknown"), [fields, claimed]);
-  const childrenOf = React13.useCallback((f, visibleOnly = true) => {
+  const rootFields = React14.useMemo(() => fields.filter((f) => !claimed.has(f.id) && !f.hidden && f.kind !== "unknown"), [fields, claimed]);
+  const childrenOf = React14.useCallback((f, visibleOnly = true) => {
     const ff = typeof f === "string" ? fieldMap2.get(f) : f;
     return (ff?.childIds ?? []).map((id) => fieldMap2.get(id)).filter((c) => !!c && (!visibleOnly || !c.hidden));
   }, [fieldMap2]);
-  const runRemoteValidation = React13.useCallback(async (vals) => {
+  const runRemoteValidation = React14.useCallback(async (vals) => {
     if (argsRef.current.skipValidations) return {};
     const out = {};
     for (const el2 of elements) {
@@ -7197,7 +7644,7 @@ function useZvolvForm(args) {
     }
     return out;
   }, [elements, stateOf, client, triggerBody, definition]);
-  const postSheetRows = React13.useCallback(async (vals, parentId) => {
+  const postSheetRows = React14.useCallback(async (vals, parentId) => {
     const out = { ...vals };
     for (const el2 of elements) {
       const t = resolveFieldType(el2);
@@ -7226,7 +7673,7 @@ function useZvolvForm(args) {
     }
     return out;
   }, [elements, client]);
-  const submit = React13.useCallback(async () => {
+  const submit = React14.useCallback(async () => {
     if (!definition || readOnly) return null;
     setSubmitAttempted(true);
     setSubmitError(null);
@@ -7265,7 +7712,7 @@ function useZvolvForm(args) {
       setSubmitting(false);
     }
   }, [definition, readOnly, clientErrors, runRemoteValidation, mode, postSheetRows, submissionId, elements, client]);
-  const reset = React13.useCallback(() => {
+  const reset = React14.useCallback(() => {
     setValues(initialRef.current);
     setTouched(/* @__PURE__ */ new Set());
     setFlagged(/* @__PURE__ */ new Set());
@@ -7275,8 +7722,8 @@ function useZvolvForm(args) {
     setDirty(false);
     if (definition) setStatus("ready");
   }, [definition]);
-  const apiRef = React13.useRef(null);
-  const runAction = React13.useCallback(async (field2, choice) => {
+  const apiRef = React14.useRef(null);
+  const runAction = React14.useCallback(async (field2, choice) => {
     const p = field2.element.properties ?? {};
     const subType = String(field2.element.attributes?.subType ?? "");
     const rawType = p.actionType ?? (subType && subType !== field2.element.type && subType !== field2.type ? subType : "") ?? p.subType;
@@ -7433,14 +7880,14 @@ function useZvolvForm(args) {
       }
     }
   }, [fieldMap2, submit, client, triggerBody, applyValues, withBusy, setValue, elements, definition, formId, submissionId, submittedId]);
-  const reload = React13.useCallback(() => setReloadTick((n) => n + 1), []);
-  const [sheetVersion, setSheetVersion] = React13.useState(0);
-  const registerSheet = React13.useCallback((id, def) => {
+  const reload = React14.useCallback(() => setReloadTick((n) => n + 1), []);
+  const [sheetVersion, setSheetVersion] = React14.useState(0);
+  const registerSheet = React14.useCallback((id, def) => {
     if (sheetDefs.current.get(id) === def) return;
     sheetDefs.current.set(id, def);
     setSheetVersion((n) => n + 1);
   }, []);
-  const sheetDefinition = React13.useCallback((id) => sheetDefs.current.get(id), []);
+  const sheetDefinition = React14.useCallback((id) => sheetDefs.current.get(id), []);
   const api = {
     status,
     error,
@@ -7516,10 +7963,10 @@ function useTrialField(form, field2) {
   const type = t === "INPUT_TIME_SAMPLING" ? "time" : t === "INPUT_TASK_ANALYSIS" ? "task" : "percent";
   const props = field2.element.properties ?? {};
   const value = field2.value && typeof field2.value === "object" ? field2.value : null;
-  const conf = React13.useMemo(() => ({ ...props, ...value?.conf ?? {} }), [props, value?.conf]);
+  const conf = React14.useMemo(() => ({ ...props, ...value?.conf ?? {} }), [props, value?.conf]);
   const disabled = field2.disabled || form.readOnly;
   const set = (v) => form.setValue(field2.id, v);
-  const [active, setActive] = React13.useState();
+  const [active, setActive] = React14.useState();
   const maxTrials = Number(conf.maximumNumberOfTrials ?? (type === "task" ? 5 : 10));
   const pcResp = type === "percent" && Array.isArray(value?.buttonResp) ? value.buttonResp : [];
   const pcTrial = type === "percent" ? Number(conf.currentTrial ?? pcResp.length) || pcResp.length : 0;
@@ -7529,11 +7976,11 @@ function useTrialField(form, field2) {
   };
   const timeLimit = Number(conf.timeLimit ?? 300);
   const interval = Number(conf.timeInterval ?? 30) || 30;
-  const [timer, setTimer] = React13.useState(Number(value?.lastStatus?.timer ?? 0));
-  const [running, setRunning] = React13.useState(false);
-  const timerRef = React13.useRef(timer);
+  const [timer, setTimer] = React14.useState(Number(value?.lastStatus?.timer ?? 0));
+  const [running, setRunning] = React14.useState(false);
+  const timerRef = React14.useRef(timer);
   timerRef.current = timer;
-  React13.useEffect(() => {
+  React14.useEffect(() => {
     if (!running) return;
     const id = setInterval(() => setTimer((p) => {
       const n = p + 1;
@@ -7553,7 +8000,7 @@ function useTrialField(form, field2) {
     buttonResp: resp,
     lastStatus: { timer: at, intervalCount: Math.floor(at / interval), formattedTimer: fmt(at), currentIntervalBound: bound(at) }
   });
-  const steps = React13.useMemo(() => Object.keys(conf.steps ?? {}), [conf.steps]);
+  const steps = React14.useMemo(() => Object.keys(conf.steps ?? {}), [conf.steps]);
   const chain = conf.type === "backward" ? "backward" : conf.type === "whole" ? "whole" : "forward";
   const taResp = type === "task" && value?.buttonResp && typeof value.buttonResp === "object" && !Array.isArray(value.buttonResp) ? value.buttonResp : {};
   const taTrial = type === "task" ? parseInt(String(value?.currentStatus?.currentTrial ?? "0").replace("Trial ", ""), 10) || 0 : 0;
@@ -7568,8 +8015,8 @@ function useTrialField(form, field2) {
   const currentTrial = type === "percent" ? pcTrial : type === "task" ? taTrial : tsResp.length;
   const complete = type === "time" ? timer >= timeLimit : currentTrial >= maxTrials;
   const rb = type === "task" ? conf.steps?.[stepName]?.ResponseButtons : conf.ResponseButtons;
-  const buttons = React13.useMemo(() => toButtons(rb), [rb]);
-  const record = React13.useCallback((response, promptLabel) => {
+  const buttons = React14.useMemo(() => toButtons(rb), [rb]);
+  const record = React14.useCallback((response, promptLabel) => {
     if (disabled) return;
     if (type === "percent") {
       if (pcTrial >= maxTrials) return;
@@ -7601,16 +8048,16 @@ function useTrialField(form, field2) {
     }
     setActive(void 0);
   }, [disabled, type, pcTrial, maxTrials, pcResp, tsResp, taResp, taTrial, taStep, steps, stepName, chain, value, conf]);
-  const respond = React13.useCallback((label) => {
+  const respond = React14.useCallback((label) => {
     const b = buttons.find((x) => x.label === label);
     if (!b || b.disabled) return;
     if (b.prompts.length) setActive(label);
     else record(label);
   }, [buttons, record]);
-  const prompt = React13.useCallback((label) => {
+  const prompt = React14.useCallback((label) => {
     if (active) record(active, label);
   }, [active, record]);
-  const prev = React13.useCallback(() => {
+  const prev = React14.useCallback(() => {
     if (disabled) return;
     if (type === "percent" && pcTrial > 0) {
       set({ conf: { ...value?.conf ?? { maximumNumberOfTrials: maxTrials, ResponseButtons: conf.ResponseButtons ?? {} }, currentTrial: pcTrial - 1 }, buttonResp: pcResp.slice(0, -1) });
@@ -7620,7 +8067,7 @@ function useTrialField(form, field2) {
       taEmit(resp, taTrial - 1, firstStep);
     }
   }, [disabled, type, pcTrial, pcResp, taTrial, taResp, firstStep, value, conf, maxTrials]);
-  const reset = React13.useCallback(() => {
+  const reset = React14.useCallback(() => {
     if (type !== "time" || disabled) return;
     setTimer(0);
     setRunning(false);
@@ -7666,10 +8113,10 @@ function useTrialField(form, field2) {
     chain
   };
 }
-var FormKitSlot = React13__default.default.createContext(null);
+var FormKitSlot = React14__default.default.createContext(null);
 function useKit(local) {
-  const ctx = React13__default.default.useContext(FormKitSlot);
-  return React13__default.default.useMemo(() => ({ ...ctx ?? {}, ...local ?? {} }), [ctx, local]);
+  const ctx = React14__default.default.useContext(FormKitSlot);
+  return React14__default.default.useMemo(() => ({ ...ctx ?? {}, ...local ?? {} }), [ctx, local]);
 }
 var FormFields = ({ form, fields, kit: local }) => {
   const kit = useKit(local);
@@ -7957,12 +8404,12 @@ var TabWidget = ({
   render
 }) => {
   const t = useTokens();
-  const config = React13.useMemo(
+  const config = React14.useMemo(
     () => resolveWidgetDefaults(t, "TAB", parseConfig(configurations)),
     [t, configurations]
   );
   const chrome = resolveChromeConfig(config);
-  const tabs = React13.useMemo(() => {
+  const tabs = React14.useMemo(() => {
     const declared = config?.tabs ?? config?.childWidget ?? [];
     return declared.map((tab, i) => ({
       key: String(tab?.key ?? tab?.id ?? i),
@@ -7970,7 +8417,7 @@ var TabWidget = ({
       widget: tab?.widget ?? tab
     }));
   }, [config]);
-  const [activeKey, setActiveKey] = React13.useState("");
+  const [activeKey, setActiveKey] = React14.useState("");
   const current = activeKey || tabs[0]?.key || "";
   const args = { tabs, activeKey: current, setActiveKey, tokens: t, config };
   return /* @__PURE__ */ jsxRuntime.jsx(
@@ -8030,7 +8477,7 @@ var FormWidget = ({
   onSubmitted
 }) => {
   const t = useTokens();
-  const config = React13.useMemo(
+  const config = React14.useMemo(
     () => resolveWidgetDefaults(t, "FORM", parseConfig(configurations)),
     [t, configurations]
   );
@@ -8071,12 +8518,12 @@ var FilterPanelWidget = ({
   render
 }) => {
   const t = useTokens();
-  const config = React13.useMemo(
+  const config = React14.useMemo(
     () => resolveWidgetDefaults(t, "FILTER_PANEL", parseConfig(configurations)),
     [t, configurations]
   );
   const chrome = resolveChromeConfig(config);
-  const controls = React13.useMemo(() => {
+  const controls = React14.useMemo(() => {
     const declared = config?.filters ?? config?.controls ?? [];
     return declared.map((f, i) => ({
       key: String(f?.key ?? f?.field ?? f?.masterfield ?? i),
@@ -8085,7 +8532,7 @@ var FilterPanelWidget = ({
       options: f?.options
     }));
   }, [config]);
-  const [draft, setDraft] = React13.useState({});
+  const [draft, setDraft] = React14.useState({});
   const values = { ...draft, ...value || {} };
   const setValue = (key, v) => {
     const next = { ...values, [key]: v };
@@ -8150,7 +8597,7 @@ var ZaiChatWidget = ({
   render
 }) => {
   const t = useTokens();
-  const config = React13.useMemo(
+  const config = React14.useMemo(
     () => resolveWidgetDefaults(t, "ZAI_CHAT", parseConfig(configurations)),
     [t, configurations]
   );
@@ -8381,7 +8828,7 @@ function buildDashFilters(values = [], dateRange, operator = "AND") {
 }
 function dateRangeFor(token) {
   const f = (d) => d.format("YYYY-MM-DD");
-  const now = dayjs8__default.default();
+  const now = dayjs4__default.default();
   switch (token) {
     case "TODAY":
       return { start: f(now), end: f(now) };
@@ -8677,7 +9124,7 @@ function inspectForm(form) {
   };
 }
 function useFormInspector(form) {
-  return React13.useMemo(() => inspectForm(form), [form.definition, form.values, form.sheetVersion, form.fields]);
+  return React14.useMemo(() => inspectForm(form), [form.definition, form.values, form.sheetVersion, form.fields]);
 }
 
 // src/forms/authoring.ts
@@ -8858,8 +9305,10 @@ exports.ZvolvForm = ZvolvForm;
 exports.ZvolvProvider = ZvolvProvider;
 exports.ZvolvThemeProvider = ZvolvThemeProvider;
 exports.ZvolvWidget = ZvolvWidget;
+exports.addPeriod = addPeriod;
 exports.aggregate = aggregate;
 exports.alignSummaryToSeries = alignSummaryToSeries;
+exports.applyCumulative = applyCumulative;
 exports.applyLocalColumnFilters = applyLocalColumnFilters;
 exports.applyLocalSearch = applyLocalSearch;
 exports.applyLocalSort = applyLocalSort;
@@ -8889,6 +9338,7 @@ exports.createSubmission = createSubmission;
 exports.createZvolvRuntime = createZvolvRuntime;
 exports.dashboardDefaultDateToken = dashboardDefaultDateToken;
 exports.dashboardFilterDefs = dashboardFilterDefs;
+exports.dateDiff = dateDiff;
 exports.dateRangeFor = dateRangeFor;
 exports.defaultTokens = defaultTokens;
 exports.defineConfig = defineConfig;
@@ -8908,6 +9358,7 @@ exports.fieldKind = fieldKind;
 exports.fieldKindOf = fieldKindOf;
 exports.fillDateGaps = fillDateGaps;
 exports.filterableFields = filterableFields;
+exports.flattenPercentiles = flattenPercentiles;
 exports.formSource = formSource;
 exports.formWidget = formWidget;
 exports.formatAmountValue = formatAmountValue;
@@ -8940,7 +9391,9 @@ exports.openFormRequest = openFormRequest;
 exports.operatorsForKind = operatorsForKind;
 exports.optionFilterRules = optionFilterRules;
 exports.parseConfig = parseConfig;
+exports.parseDateValue = parseDateValue;
 exports.parseDeep = parseDeep;
+exports.percentileKey = percentileKey;
 exports.pivot = pivot;
 exports.renderHtmlVariables = renderHtmlVariables;
 exports.resetQueryUser = resetQueryUser;
@@ -8963,6 +9416,7 @@ exports.ruleMatches = ruleMatches;
 exports.rulesOf = rulesOf;
 exports.searchPeople = searchPeople;
 exports.serializeElementValue = serializeElementValue;
+exports.startOfPeriod = startOfPeriod;
 exports.statusTone = statusTone;
 exports.submissionIdOf = submissionIdOf;
 exports.submissionToValues = submissionToValues;