@zestl/zvolv-widgets 0.0.1 → 0.0.2

package/dist/index.js

@@ -1,9 +1,10 @@
-import React13, { createContext, useMemo, useContext, useState, useRef, useCallback, useEffect } from 'react';
+import React14, { createContext, useMemo, useContext, useState, useRef, useCallback, useEffect } from 'react';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
-import dayjs8 from 'dayjs';
+import dayjs4 from 'dayjs';
 import utc from 'dayjs/plugin/utc.js';
 import weekOfYear from 'dayjs/plugin/weekOfYear.js';
 import _ from 'lodash';
+import timezone2 from 'dayjs/plugin/timezone.js';
 
 // src/core/ZvolvProvider.tsx
 var RuntimeContext = createContext(null);
@@ -117,8 +118,8 @@ var TASK_DATE_FIELDS = [
   "completeDate"
 ];
 new Set(TASK_DATE_FIELDS.map((f) => f.toLowerCase()));
-dayjs8.extend(utc);
-dayjs8.extend(weekOfYear);
+dayjs4.extend(utc);
+dayjs4.extend(weekOfYear);
 function humanizeDurationToMinutes(value) {
   if (!value) return 0;
   let total = 0;
@@ -163,7 +164,7 @@ function getDataType(elementType) {
 function getDateRange(ops) {
   const values = [];
   const fmt2 = "YYYY-MM-DD";
-  const today = dayjs8();
+  const today = dayjs4();
   switch (ops) {
     case "TODAY":
       values[0] = today.format(fmt2);
@@ -315,7 +316,7 @@ var resolveQueryUser = () => {
 };
 
 // src/runtime/queryGenerator.ts
-dayjs8.extend(utc);
+dayjs4.extend(utc);
 var mappingsCache = /* @__PURE__ */ new Map();
 function getCachedAnalyticsMappings(indexKey) {
   let pending2 = mappingsCache.get(indexKey);
@@ -467,7 +468,7 @@ function resolveDateMath(value) {
   if (typeof value !== "string") return null;
   const match = dateMathPattern.exec(value.trim());
   if (!match) return null;
-  let d = dayjs8();
+  let d = dayjs4();
   const [, amountStr, amountUnit, , roundUnit] = match;
   if (amountStr && amountUnit) {
     d = d.add(parseInt(amountStr, 10), dateMathUnit[amountUnit]);
@@ -482,7 +483,7 @@ function isDateMath(value) {
 }
 function getDate(dateFormula) {
   const fmt2 = "YYYY-MM-DDTHH:mm:ssZ";
-  const d = dayjs8();
+  const d = dayjs4();
   switch (dateFormula) {
     case "{@[TODAY]}":
       return d.startOf("day").format(fmt2);
@@ -679,7 +680,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(oprd, pattern).format("YYYY-MM-DD");
+      return dayjs4(oprd, pattern).format("YYYY-MM-DD");
     });
   }
   if (field2["taskfield"] && !field2["masterFieldDataType"]) {
@@ -964,6 +965,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(getDate(end)).valueOf();
+  if (LITERAL_DATE.test(end.trim())) {
+    const d = dayjs4(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) => {
@@ -985,17 +1122,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);
@@ -1013,7 +1154,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;
@@ -1046,6 +1187,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]) {
@@ -1053,17 +1195,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,
@@ -1081,10 +1224,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 };
@@ -1094,6 +1237,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") {
@@ -1186,6 +1330,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;
       }
@@ -1763,16 +1908,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,
@@ -1780,6 +1938,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 };
@@ -1792,7 +1980,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 } : {}
   };
 }
@@ -1801,7 +1989,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 } : {}
   };
 }
@@ -1809,13 +1997,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
@@ -1913,7 +2101,7 @@ function coerceForField(field2, values) {
   });
 }
 var FMT = "YYYY-MM-DD";
-function resolveDateToken(token, now = dayjs8()) {
+function resolveDateToken(token, now = dayjs4()) {
   switch (String(token).toUpperCase()) {
     case "TODAY":
       return [now.format(FMT), now.format(FMT)];
@@ -1957,7 +2145,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(`${y}-${mm}-${dd}`);
+  const parsed = dayjs4(`${y}-${mm}-${dd}`);
   if (!parsed.isValid() || parsed.format(FMT) !== `${y}-${mm}-${dd}`) return [null, null, null];
   return [y, mm, dd];
 }
@@ -2056,7 +2244,7 @@ function toComparable(v) {
   if (typeof v === "number") return v;
   const n = Number(v);
   if (!isNaN(n)) return n;
-  const d = dayjs8(v);
+  const d = dayjs4(v);
   return d.isValid() ? d.valueOf() : null;
 }
 function applyLocalSearch(rows, search, toLabel) {
@@ -2124,7 +2312,7 @@ function matchesWidgetFilter(row, f) {
     case "DATE_IS": {
       const range = resolveDateToken(String(values[0] ?? ""));
       if (!range || raw2 == null || raw2 === "") return false;
-      const d = dayjs8(raw2).format(FMT);
+      const d = dayjs4(raw2).format(FMT);
       return d >= range[0] && d <= range[1];
     }
     default:
@@ -2543,7 +2731,7 @@ var KPI_DEFAULT_TEMPLATES = {
   hero_chart: HeroChart,
   icon: Icon
 };
-var WidgetStateSlot = React13.createContext(null);
+var WidgetStateSlot = React14.createContext(null);
 var WidgetShell = ({
   widgetType,
   title,
@@ -2561,7 +2749,7 @@ var WidgetShell = ({
 }) => {
   const t = useTokens();
   const chrome = resolveChrome(t, widgetType);
-  const renderState = React13.useContext(WidgetStateSlot);
+  const renderState = React14.useContext(WidgetStateSlot);
   const frame = {
     display: "flex",
     flexDirection: "column",
@@ -2666,24 +2854,91 @@ function alignSummaryToSeries(dataSource, series) {
   });
   return { ...dataSource, pivot: { ...dataSource.pivot, summary: fixedSummary } };
 }
+dayjs4.extend(utc);
+dayjs4.extend(timezone2);
 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.utc(d.tz(timeZone).format("YYYY-MM-DD"))).format("YYYY-MM-DD");
+  return dayjs4.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.tz(v, timeZone);
+    } catch {
+      return dayjs4(NaN);
+    }
+  }
+  return dayjs4(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(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 {
@@ -2695,10 +2950,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(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);
@@ -2716,6 +2994,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();
@@ -2736,6 +3057,27 @@ 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] = useState(value);
   useEffect(() => {
@@ -2815,13 +3157,34 @@ function useWidgetData(args) {
   const localKey = JSON.stringify(localFilters ?? {});
   const dsKey = JSON.stringify(dataSource ?? {});
   const remoteKey = JSON.stringify(remote);
-  const normalize = useCallback((incoming) => {
-    const withPostOps = applyPostOperations(incoming, dataSource?.pivot?.postOperations);
+  const dateGapKey = JSON.stringify(dateGap ?? null);
+  const gapTimeZone = 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 = 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(dateGap.start).startOf(dateGap.unit), end: dayjs8(dateGap.end).startOf(dateGap.unit) } : null;
-    return fillDateGaps({ rows: numeric, xKey, series, unit: dateGap.unit, range });
-  }, [dataSource, series, xKey, dateGap]);
+    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]);
   useEffect(() => {
     if (automationRows) {
       if (automationLoading) {
@@ -2843,53 +3206,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 }));
@@ -2897,7 +3274,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);
@@ -2913,7 +3290,7 @@ function useWidgetData(args) {
     return () => {
       cancelled = true;
     };
-  }, [configKey, dashKey, cdateKey, localKey, dsKey, remoteKey, configured, nonce, automationRows, automationLoading]);
+  }, [configKey, dashKey, cdateKey, localKey, dsKey, remoteKey, dateGapKey, configured, nonce, automationRows, automationLoading]);
   const userKind = useMemo(() => {
     if (!rt.getUserFieldKind) return null;
     const field2 = (dataSource?.fields || []).find(
@@ -3265,7 +3642,7 @@ function useInteractiveWidgetData(props, options = {}) {
         tokens: t
       };
       parts.push(
-        /* @__PURE__ */ jsx(React13.Fragment, { children: props.renderSortIndicator ? props.renderSortIndicator(args) : /* @__PURE__ */ jsx(DefaultSortIndicator, { ...args }) }, "sort")
+        /* @__PURE__ */ jsx(React14.Fragment, { children: props.renderSortIndicator ? props.renderSortIndicator(args) : /* @__PURE__ */ jsx(DefaultSortIndicator, { ...args }) }, "sort")
       );
     }
     if (flags.showColumnFilter) {
@@ -3279,7 +3656,7 @@ function useInteractiveWidgetData(props, options = {}) {
         tokens: t
       };
       parts.push(
-        /* @__PURE__ */ jsx(React13.Fragment, { children: props.renderColumnFilter ? props.renderColumnFilter(args) : /* @__PURE__ */ jsx(DefaultColumnFilter, { ...args }) }, "filter")
+        /* @__PURE__ */ jsx(React14.Fragment, { children: props.renderColumnFilter ? props.renderColumnFilter(args) : /* @__PURE__ */ jsx(DefaultColumnFilter, { ...args }) }, "filter")
       );
     }
     return parts.length ? /* @__PURE__ */ jsx(Fragment, { children: parts }) : null;
@@ -3767,31 +4144,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] = useState({});
+  const onSeries = 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 = 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__ */ 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__ */ jsx("div", { style: { display: "flex", flexDirection: "column", gap: 14, height: "100%" }, children: vms.map((vm, i) => /* @__PURE__ */ jsx(KpiItem, { vm, index: i, onClick: onItemClick }, i)) })
-    }
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    contents.map(
+      (content, i) => content?.seriesSource?.mode === "timeseries" && content.seriesSource.dataSource && !externalSeriesByIndex?.[i] ? /* @__PURE__ */ jsx(
+        KpiSeriesFetcher,
+        {
+          index: i,
+          source: content.seriesSource,
+          onSeries,
+          dashFilters: dataArgs.dashFilters,
+          cdateFilters: dataArgs.cdateFilters,
+          localFilters: dataArgs.localFilters,
+          workflowTypeId: dataArgs.workflowTypeId
+        },
+        i
+      ) : null
+    ),
+    /* @__PURE__ */ 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__ */ jsx("div", { style: { display: "flex", flexDirection: "column", gap: 14, height: "100%" }, children: vms.map((vm, i) => /* @__PURE__ */ 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 = useMemo(
+    () => ({ series: [{ argumentField: xField, valueField }] }),
+    [xField, valueField]
   );
+  const data = useWidgetData({
+    widgetType: "KPI_SERIES",
+    dataSource,
+    configurations,
+    dateGap: dateGap ?? null,
+    dashFilters,
+    cdateFilters,
+    localFilters,
+    workflowTypeId
+  });
+  const values = 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) : "";
+  useEffect(() => {
+    onSeries(index, ready ? values : void 0);
+  }, [index, key, ready, onSeries]);
+  useEffect(() => () => onSeries(index, void 0), [index, onSeries]);
+  return null;
 };
 var KpiItem = ({
   vm,
@@ -3848,7 +4294,7 @@ var ChartWidget = (props) => {
   const renderer = render ?? children;
   let body;
   if (renderer) body = renderer(args);
-  else if (override) body = React13.createElement(override, args);
+  else if (override) body = React14.createElement(override, args);
   else body = /* @__PURE__ */ jsx(FallbackBars, { ...args });
   return /* @__PURE__ */ jsx(
     WidgetShell,
@@ -3958,7 +4404,7 @@ var RankingBarWidget = (props) => {
       style,
       actions: ix.toolbar,
       ...ix.shell,
-      children: render ? render(args) : override ? React13.createElement(override, args) : /* @__PURE__ */ jsx(DefaultRanking, { ...args })
+      children: render ? render(args) : override ? React14.createElement(override, args) : /* @__PURE__ */ jsx(DefaultRanking, { ...args })
     }
   );
 };
@@ -4246,7 +4692,7 @@ var CollectionWidget = (props) => {
       style,
       actions: ix.toolbar,
       ...ix.shell,
-      children: render ? render(args) : override ? React13.createElement(override, args) : /* @__PURE__ */ jsx(DefaultList, { ...args })
+      children: render ? render(args) : override ? React14.createElement(override, args) : /* @__PURE__ */ jsx(DefaultList, { ...args })
     }
   );
 };
@@ -4496,7 +4942,7 @@ var PivotGridWidget = (props) => {
 };
 function toDate(v) {
   if (v === null || v === void 0 || v === "") return null;
-  const d = dayjs8(v);
+  const d = dayjs4(v);
   return d.isValid() ? d.toDate() : null;
 }
 function useTemporalEvents(rows, mapping) {
@@ -4521,7 +4967,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(start).startOf("day").isSame(start),
+        allDay: !!(start && !end) || !!start && dayjs4(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,
@@ -4588,7 +5034,7 @@ var TemporalWidget = (props) => {
       style,
       actions: ix.toolbar,
       ...ix.shell,
-      children: render ? render(args) : override ? React13.createElement(override, args) : /* @__PURE__ */ jsx(DefaultTimeline, { ...args })
+      children: render ? render(args) : override ? React14.createElement(override, args) : /* @__PURE__ */ jsx(DefaultTimeline, { ...args })
     }
   );
 };
@@ -4615,8 +5061,8 @@ var DefaultTimeline = ({ events, tokens: t, onEventClick }) => /* @__PURE__ */ j
       /* @__PURE__ */ jsxs("div", { style: { minWidth: 0, flex: 1 }, children: [
         /* @__PURE__ */ jsx("div", { style: { fontSize: t.typography.body.fontSize, color: t.colors.textPrimary, fontWeight: 600 }, children: String(e.title ?? "") }),
         /* @__PURE__ */ jsxs("div", { style: { fontSize: t.typography.caption.fontSize, color: t.colors.textTertiary }, children: [
-          e.start ? dayjs8(e.start).format("DD MMM YYYY") : "",
-          e.end ? ` \u2192 ${dayjs8(e.end).format("DD MMM YYYY")}` : "",
+          e.start ? dayjs4(e.start).format("DD MMM YYYY") : "",
+          e.end ? ` \u2192 ${dayjs4(e.end).format("DD MMM YYYY")}` : "",
           e.group ? ` \xB7 ${String(e.group)}` : ""
         ] })
       ] }),
@@ -4711,7 +5157,7 @@ var StepperWidget = (props) => {
       style,
       actions: ix.toolbar,
       ...ix.shell,
-      children: render ? render(args) : override ? React13.createElement(override, args) : /* @__PURE__ */ jsx(DefaultStepper, { ...args })
+      children: render ? render(args) : override ? React14.createElement(override, args) : /* @__PURE__ */ jsx(DefaultStepper, { ...args })
     }
   );
 };
@@ -4783,7 +5229,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(value);
+      const d = dayjs4(value);
       if (d.isValid()) value = d.format(DATE_FORMAT_MAP[v.dateFormat] || "DD/MM/YYYY");
     }
     let text2;
@@ -5863,7 +6309,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();
+    let d = dayjs4();
     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]) => {
@@ -5903,7 +6349,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(v) : typeof v === "string" && v ? dayjs8(v) : null;
+  const toD = (v) => isDayjs(v) ? v : v instanceof Date ? dayjs4(v) : typeof v === "string" && v ? dayjs4(v) : null;
   if (t === "DATE_PICKER") {
     const d = toD(value);
     return d?.isValid() ? d.format("YYYY-MM-DD") : value;
@@ -6018,9 +6464,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(v).format("D MMM YYYY")).join(" \u2013 ");
-  if (t === "DATE_PICKER") return dayjs8(value).isValid() ? dayjs8(value).format("D MMM YYYY") : String(value);
-  if (t === "DATE_TIME_PICKER") return dayjs8(value).isValid() ? dayjs8(value).format("D MMM YYYY, HH:mm") : String(value);
+  if (t === "INPUT_DATE_RANGE" && Array.isArray(value)) return value.filter(Boolean).map((v) => dayjs4(v).format("D MMM YYYY")).join(" \u2013 ");
+  if (t === "DATE_PICKER") return dayjs4(value).isValid() ? dayjs4(value).format("D MMM YYYY") : String(value);
+  if (t === "DATE_TIME_PICKER") return dayjs4(value).isValid() ? dayjs4(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);
@@ -6838,9 +7284,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.createContext(null);
+var FormApiContext = React14.createContext(null);
 function useFormApi() {
-  const f = React13.useContext(FormApiContext);
+  const f = React14.useContext(FormApiContext);
   if (!f) throw new Error("@zestl/zvolv-widgets: useFormApi must be used inside <ZvolvForm> or FormApiContext");
   return f;
 }
@@ -7656,10 +8102,10 @@ function useTrialField(form, field2) {
     chain
   };
 }
-var FormKitSlot = React13.createContext(null);
+var FormKitSlot = React14.createContext(null);
 function useKit(local) {
-  const ctx = React13.useContext(FormKitSlot);
-  return React13.useMemo(() => ({ ...ctx ?? {}, ...local ?? {} }), [ctx, local]);
+  const ctx = React14.useContext(FormKitSlot);
+  return React14.useMemo(() => ({ ...ctx ?? {}, ...local ?? {} }), [ctx, local]);
 }
 var FormFields = ({ form, fields, kit: local }) => {
   const kit = useKit(local);
@@ -8371,7 +8817,7 @@ function buildDashFilters(values = [], dateRange, operator = "AND") {
 }
 function dateRangeFor(token) {
   const f = (d) => d.format("YYYY-MM-DD");
-  const now = dayjs8();
+  const now = dayjs4();
   switch (token) {
     case "TODAY":
       return { start: f(now), end: f(now) };
@@ -8780,6 +9226,6 @@ function formWidget(o) {
   };
 }
 
-export { ActionCardWidget, ActivityFeedWidget, AreaChartWidget, BLOCKED_FILE_EXTENSIONS, BannerWidget, BarChartWidget, COLUMN_FILTER_BLANK, CONTAINER_KINDS, CalendarWidget, CardListWidget, CarouselWidget, ChartWidget, ChildTableWidget, CollectionWidget, DashboardTableWidget, DatabaseTableWidget, DefaultField, DoughnutChartWidget, EMPTY_INTERACTIONS, EntityGalleryWidget, FilterPanelWidget, FormApiContext, FormFields, FormKitSlot, FormWidget, GRID, GanttChartWidget, GaugeMeterWidget, GoogleMapWidget, GridCardWidget, HeatMapWidget, HtmlWidget, IframeWidget, KPI_DEFAULT_TEMPLATES, Delta as KpiDelta, Label as KpiLabel, Sparkline as KpiSparkline, Value as KpiValue, KpiWidget, LineChartWidget, MeetingSchedulerWidget, NON_INPUT_TYPES, NON_RENDERING_TYPES, PREFIX_UNITS, PieChartWidget, PivotGridWidget, RankingBarWidget, RawHtmlWidget, SAMPLE_ROWS, SUBMISSION_SKIP_TYPES, SUFFIX_UNITS, ScatterChartWidget, StepperWidget, TabWidget, TableWidget, TaskTrackerTableWidget, TemplateProvider, TemporalWidget, TimelineWidget, TreeWidget, WIDGET_REGISTRY, WidgetShell, WidgetStateSlot, ZaiChatWidget, ZvolvForm, ZvolvProvider, ZvolvThemeProvider, ZvolvWidget, aggregate, alignSummaryToSeries, applyLocalColumnFilters, applyLocalSearch, applyLocalSort, applyLocalWidgetFilters, applyPostOperations, applyRules, automationSource, buildColumnFilterClauses, buildDashFilters, buildDashboardTree, buildInitialValues, buildRemoteSort, buildSearchClause, buildSubmissionElements, buildTree, buildTriggerBody, buildWidgetFilterClauses, cascade, cdateFiltersFor, childIdsOf, cleanTitle, clearLookupCache, coerceSeriesNumbers, computeRowFormulas, createMockRuntime, createSubmission, createZvolvRuntime, dashboardDefaultDateToken, dashboardFilterDefs, dateRangeFor, defaultTokens, defineConfig, defineForm, derive, describeWidgetFilter, distinctColumnValues, eid, el, evaluateFormula, extractAgentFormData, fetchForm, fetchLookupOptions, fetchSubmission, field, fieldKind, fieldKindOf, fillDateGaps, filterableFields, formSource, formWidget, formatAmountValue, formatCompact, formatFieldValue, formulaLabels, getDataType2 as getDataType, getEmptyValue, getPostOpOperandSet, getPostOpResult, gridHeight, gridWidgets, groupBy, hasActiveInteractions, inspectForm, interpolate, invokeAgent, invokeTrigger, invokeZeno, isDataSourceConfigured, isLegacyId, isLikelyTimestamp, isServerSafeFormula, lookupConfigOf, mergeTokens, normaliseElement, normaliseForm, normalizeWidget, openFormRequest, operatorsForKind, optionFilterRules, parseConfig, parseDeep, pivot, renderHtmlVariables, resetQueryUser, resolveChrome, resolveChromeConfig, resolveCollectionMapping, resolveDashboardLayout, resolveDateToken, resolveDrillDown, resolveFieldType, resolveFilterMode, resolveFormWidget, resolveSeries, resolveTableMode, resolveWidget, resolveWidgetDefaults, resolveXKey, rowSubmissionIds, ruleMatches, rulesOf, searchPeople, serializeElementValue, statusTone, submissionIdOf, submissionToValues, submitElementsOf, taskField, taskSource, toBraceFormula, toNum, toRelational, toneColor, toneSurface, updateSubmission, uploadFile, useCollectionItems, useFieldOptions, useFileField, useFormApi, useFormInspector, useInteractiveWidgetData, useKpiContents, useSheetField, useTableColumns, useTemplateOverride, useTemporalEvents, useTokens, useTrialField, useWidgetData, useWidgetInteractions, useZvolvClient, useZvolvForm, useZvolvRuntime, usesFormFramework, validateField, validateForm, when, where };
+export { ActionCardWidget, ActivityFeedWidget, AreaChartWidget, BLOCKED_FILE_EXTENSIONS, BannerWidget, BarChartWidget, COLUMN_FILTER_BLANK, CONTAINER_KINDS, CalendarWidget, CardListWidget, CarouselWidget, ChartWidget, ChildTableWidget, CollectionWidget, DashboardTableWidget, DatabaseTableWidget, DefaultField, DoughnutChartWidget, EMPTY_INTERACTIONS, EntityGalleryWidget, FilterPanelWidget, FormApiContext, FormFields, FormKitSlot, FormWidget, GRID, GanttChartWidget, GaugeMeterWidget, GoogleMapWidget, GridCardWidget, HeatMapWidget, HtmlWidget, IframeWidget, KPI_DEFAULT_TEMPLATES, Delta as KpiDelta, Label as KpiLabel, Sparkline as KpiSparkline, Value as KpiValue, KpiWidget, LineChartWidget, MeetingSchedulerWidget, NON_INPUT_TYPES, NON_RENDERING_TYPES, PREFIX_UNITS, PieChartWidget, PivotGridWidget, RankingBarWidget, RawHtmlWidget, SAMPLE_ROWS, SUBMISSION_SKIP_TYPES, SUFFIX_UNITS, ScatterChartWidget, StepperWidget, TabWidget, TableWidget, TaskTrackerTableWidget, TemplateProvider, TemporalWidget, TimelineWidget, TreeWidget, WIDGET_REGISTRY, WidgetShell, WidgetStateSlot, ZaiChatWidget, ZvolvForm, ZvolvProvider, ZvolvThemeProvider, ZvolvWidget, addPeriod, aggregate, alignSummaryToSeries, applyCumulative, applyLocalColumnFilters, applyLocalSearch, applyLocalSort, applyLocalWidgetFilters, applyPostOperations, applyRules, automationSource, buildColumnFilterClauses, buildDashFilters, buildDashboardTree, buildInitialValues, buildRemoteSort, buildSearchClause, buildSubmissionElements, buildTree, buildTriggerBody, buildWidgetFilterClauses, cascade, cdateFiltersFor, childIdsOf, cleanTitle, clearLookupCache, coerceSeriesNumbers, computeRowFormulas, createMockRuntime, createSubmission, createZvolvRuntime, dashboardDefaultDateToken, dashboardFilterDefs, dateDiff, dateRangeFor, defaultTokens, defineConfig, defineForm, derive, describeWidgetFilter, distinctColumnValues, eid, el, evaluateFormula, extractAgentFormData, fetchForm, fetchLookupOptions, fetchSubmission, field, fieldKind, fieldKindOf, fillDateGaps, filterableFields, flattenPercentiles, formSource, formWidget, formatAmountValue, formatCompact, formatFieldValue, formulaLabels, getDataType2 as getDataType, getEmptyValue, getPostOpOperandSet, getPostOpResult, gridHeight, gridWidgets, groupBy, hasActiveInteractions, inspectForm, interpolate, invokeAgent, invokeTrigger, invokeZeno, isDataSourceConfigured, isLegacyId, isLikelyTimestamp, isServerSafeFormula, lookupConfigOf, mergeTokens, normaliseElement, normaliseForm, normalizeWidget, openFormRequest, operatorsForKind, optionFilterRules, parseConfig, parseDateValue, parseDeep, percentileKey, pivot, renderHtmlVariables, resetQueryUser, resolveChrome, resolveChromeConfig, resolveCollectionMapping, resolveDashboardLayout, resolveDateToken, resolveDrillDown, resolveFieldType, resolveFilterMode, resolveFormWidget, resolveSeries, resolveTableMode, resolveWidget, resolveWidgetDefaults, resolveXKey, rowSubmissionIds, ruleMatches, rulesOf, searchPeople, serializeElementValue, startOfPeriod, statusTone, submissionIdOf, submissionToValues, submitElementsOf, taskField, taskSource, toBraceFormula, toNum, toRelational, toneColor, toneSurface, updateSubmission, uploadFile, useCollectionItems, useFieldOptions, useFileField, useFormApi, useFormInspector, useInteractiveWidgetData, useKpiContents, useSheetField, useTableColumns, useTemplateOverride, useTemporalEvents, useTokens, useTrialField, useWidgetData, useWidgetInteractions, useZvolvClient, useZvolvForm, useZvolvRuntime, usesFormFramework, validateField, validateForm, when, where };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map