impact-nova 2.0.9 → 2.1.0-alpha.10

package/dist/components/data/ag-grid-react/headers/header-search-input.js

@@ -0,0 +1,520 @@
+import { jsxs as y, jsx as r } from "react/jsx-runtime";
+import { useRef as Le, useCallback as X, useState as _e } from "react";
+import { Filter as Ue, Cross as j } from "impact-nova-icons";
+import { cn as Je } from "../../../../lib/utils.js";
+import { DatePicker as Te } from "../../../forms/date-picker/date-picker.js";
+import { MonthPicker as De } from "../../../forms/date-picker/month-picker.js";
+import { WeekPicker as Ne } from "../../../forms/date-picker/week-picker.js";
+import { Input as q } from "../../../forms/input/input.js";
+import { Select as Pe } from "../../../forms/select/select.js";
+import { Popover as Ke, PopoverTrigger as Qe, PopoverContent as Xe, PopoverHeader as Ze, PopoverTitle as $e, PopoverBody as et } from "../../../feedback/popover/popover.js";
+import { useImpactNovaI18n as tt } from "../../../../i18n/use-impact-nova-i18n.js";
+import { useGridHeader as rt } from "./context/grid-header-context.js";
+import { getMultiFilterIndices as H, parseInputPattern as we, mapOperatorToAgGrid as ke } from "./utils/filter-utils.js";
+import { DEFAULT_DATE_DISPLAY_FORMAT as lt, serializeWeek as nt, serializeMonth as at, serializeDate as ot, displayDateToIso as Z } from "./utils/date-utils.js";
+import { useHeaderSearchEditingState as st } from "./use-header-search-editing-state.js";
+const Tt = ({
+  column: P,
+  api: x,
+  onClose: $,
+  handleInlineSearch: ee,
+  handleClearSearchInline: te,
+  onAdvanceSearchClick: re,
+  toggleAdvanceSearch: le,
+  advanceSearchEnabled: Se = !1,
+  selectOptions: Y,
+  isMultiSelect: C,
+  onSelectScrollToBottom: Ae,
+  onSelectSearchChange: He,
+  onSelectOpen: ne,
+  isLoadingSelect: ae,
+  enableSpaceSplitting: ze = !1,
+  enableBooleanParsing: Be = !1,
+  enableDateParsing: Ie = !1
+}) => {
+  const { t: i } = tt(), l = P.getColDef(), d = P.getColId(), G = l?.filter || "agTextColumnFilter", M = G === "agDateColumnFilter", V = G === "agSetColumnFilter" || Y && Y.length > 0 || l?.cellDataType === "boolean", L = l?.headerComponentParams?.datePickerVariant || "date", z = M && L === "month", B = M && L === "week", c = l?.headerComponentParams?.fiscalConfig, b = l?.headerComponentParams?.dateDisplayFormat || lt, oe = rt(), _ = Le(null), {
+    searchText: U,
+    dateDisplayString: I,
+    selectedDate: se,
+    selectedMonth: ie,
+    selectedWeek: ce,
+    updateDraft: w,
+    handleFocus: p,
+    handleBlur: h,
+    clearEditingOverlay: Oe
+  } = st({
+    api: x,
+    colId: d,
+    colDef: l,
+    isDateFilter: M,
+    isMonthVariant: z,
+    isWeekVariant: B,
+    datePickerVariant: L,
+    dateDisplayFormat: b
+  }), D = (e, t) => {
+    const n = (a) => a.replace(/[^0-9.\-+eE]/g, ""), s = (a, R) => {
+      const S = we(
+        a,
+        ze,
+        Be,
+        Ie
+      );
+      if (S.conditions.length === 0) return null;
+      const Ce = (u) => {
+        let F = ke(u.operator);
+        if (R === "number") {
+          const Me = parseFloat(n(u.value));
+          return ["contains", "notContains", "startsWith", "endsWith"].includes(
+            F
+          ) && (F = F === "notContains" ? "notEqual" : "equals"), u.operator === "inRange" ? {
+            type: F,
+            filter: parseFloat(n(u.value)) || 0,
+            filterTo: parseFloat(n(u.valueTo || "")) || 0,
+            filterType: "number"
+          } : isNaN(Me) ? null : { type: F, filter: Me, filterType: "number" };
+        }
+        return {
+          type: F,
+          filter: u.value,
+          filterTo: u.valueTo,
+          filterType: "text"
+        };
+      };
+      let A = null;
+      if (S.conditions.length === 1)
+        A = Ce(S.conditions[0]);
+      else {
+        const u = S.conditions.map(Ce).filter((F) => F !== null);
+        u.length === 0 ? A = null : u.length === 1 ? A = u[0] : A = {
+          filterType: R,
+          operator: S.logic,
+          conditions: u
+        };
+      }
+      return A;
+    };
+    let o = null;
+    if (!(e === null || e === "" || Array.isArray(e) && e.length === 0))
+      if (t === "set")
+        o = {
+          values: Array.isArray(e) ? e : [String(e)],
+          filterType: "set"
+        };
+      else if (t === "date")
+        if (B && e && typeof e == "object" && "startDate" in e && "endDate" in e) {
+          const a = nt(e);
+          o = {
+            type: "inRange",
+            dateFrom: a.dateFrom,
+            dateTo: a.dateTo,
+            filterType: "date"
+          };
+        } else if (z && e && typeof e == "object" && "month" in e && "year" in e) {
+          const a = at(e);
+          o = {
+            type: "inRange",
+            dateFrom: a.dateFrom,
+            dateTo: a.dateTo,
+            filterType: "date"
+          };
+        } else {
+          const a = e instanceof Date ? ot(e) : null;
+          o = a ? { type: "equals", dateFrom: a, filterType: "date" } : null;
+        }
+      else {
+        const a = l.filter === "agMultiColumnFilter" ? H(l) : null, R = a ? a.text !== -1 ? "text" : "number" : G === "agNumberColumnFilter" ? "number" : "text";
+        o = s(String(e), R);
+      }
+    const f = l.filter === "agMultiColumnFilter" ? H(l) : null, T = f ? t === "text" ? f.text !== -1 ? f.text : f.number : t === "set" ? f.set : f.date : 0;
+    K(o, T);
+  }, J = (e) => {
+    if (ee) {
+      ee(Array.isArray(e) ? e.join(",") : e);
+      return;
+    }
+    D(e, M ? "date" : "text");
+  }, de = (e) => {
+    const t = e.target.value;
+    w({ searchText: t }), J(t);
+  }, ue = (e) => {
+    w({ selectedDate: e }), J(e);
+  }, fe = (e) => {
+    w({ selectedMonth: e }), D(e || null, "date");
+  }, pe = (e) => {
+    w({ selectedWeek: e }), D(e || null, "date");
+  }, We = (e) => {
+    if (!e.trim()) return null;
+    const t = we(e, !1, !1, !1);
+    if (t.conditions.length === 0) return null;
+    const n = (o) => {
+      let v = ke(o.operator);
+      if (["contains", "notContains", "startsWith", "endsWith"].includes(
+        v
+      ) && (v = v === "notContains" ? "notEqual" : "equals"), o.operator === "inRange") {
+        let T = Z(o.value, b), a = Z(o.valueTo || "", b);
+        return !T || !a ? null : (T > a && ([T, a] = [a, T]), {
+          type: "inRange",
+          dateFrom: T,
+          dateTo: a,
+          filterType: "date"
+        });
+      }
+      const f = Z(o.value, b);
+      return f ? {
+        type: v,
+        dateFrom: f,
+        filterType: "date"
+      } : null;
+    };
+    if (t.conditions.length === 1)
+      return n(t.conditions[0]);
+    const s = t.conditions.map(n).filter((o) => o !== null);
+    return s.length === 0 ? null : s.length === 1 ? s[0] : {
+      filterType: "date",
+      operator: t.logic,
+      conditions: s
+    };
+  }, K = X(
+    (e, t) => {
+      const n = x.getFilterModel(), s = { ...n };
+      if (l.filter === "agMultiColumnFilter") {
+        if (t === -1) return;
+        const o = n[d], v = o && o.filterType === "multi" ? [...o.filterModels || []] : Array(l.filterParams?.filters?.length || 1).fill(null);
+        v[t] = e, v.every((f) => f === null) ? delete s[d] : s[d] = {
+          filterType: "multi",
+          filterModels: v
+        };
+      } else
+        e ? s[d] = e : delete s[d];
+      x.setFilterModel(s), x.onFilterChanged();
+    },
+    [x, d, l]
+  ), he = X(
+    (e) => {
+      const t = l.filter === "agMultiColumnFilter" ? H(l).date : 0;
+      K(e, t);
+    },
+    [l, K]
+  ), me = (e) => {
+    const t = e.target.value.replace(/[^0-9/\-!=><+,~]/g, "");
+    if (w({ dateDisplayString: t }), !t.trim()) {
+      he(null);
+      return;
+    }
+    const n = We(t);
+    n && he(n);
+  }, Q = () => {
+    Oe(), J(""), te && te();
+  }, O = (e) => {
+    D(e, "set");
+  }, W = Y || (l?.cellDataType === "boolean" ? [
+    { label: i("gridHeader.true"), value: "true" },
+    { label: i("gridHeader.false"), value: "false" }
+  ] : []), ge = X(() => {
+    const e = x.getFilterModel()[d];
+    if (!e) return [];
+    if ("filterType" in e && e.filterType === "multi" && e.filterModels) {
+      const n = H(P.getColDef()).set;
+      if (n !== -1) {
+        const s = e.filterModels[n];
+        if (s?.filterType === "set" && s.values)
+          return s.values.filter((o) => o != null);
+      }
+    } else {
+      if (e.filterType === "set" && "values" in e)
+        return e.values;
+      if ("type" in e && e.type === "equals" && e.filter)
+        return [String(e.filter)];
+    }
+    return [];
+  }, [x, d, P]), [E, k] = _e(null), ve = () => {
+    const e = E !== null ? E : ge();
+    return C ? W.filter((t) => e.includes(t.value)) : W.find((t) => e.includes(t.value)) || null;
+  }, ye = (e) => {
+    let t = [];
+    if (Array.isArray(e) ? t = e.map((n) => n.value) : e && typeof e == "object" && "value" in e && (t = [e.value]), !C) {
+      O(t), e && $();
+      return;
+    }
+    k(t);
+  }, Ee = () => {
+    O([]), k([]);
+  }, Re = (e) => {
+    if (C) {
+      if (e !== void 0) {
+        let t = [];
+        Array.isArray(e) ? t = e.map((n) => n.value) : e && typeof e == "object" && "value" in e ? t = [e.value] : e === null && (t = []), O(t), k(null);
+        return;
+      }
+      E !== null && (O(E), k(null));
+    }
+  }, je = () => {
+    k(ge()), ne && ne();
+  }, qe = () => Se ? /* @__PURE__ */ r(
+    "svg",
+    {
+      className: "cursor-pointer text-navigation-muted hover:text-brand-variant-hover shrink-0",
+      fill: "currentColor",
+      focusable: "false",
+      "aria-hidden": "true",
+      viewBox: "0 0 24 24",
+      width: "18",
+      height: "18",
+      onClick: (e) => {
+        e.stopPropagation(), _.current && _.current.blur(), re ? re(P) : le ? le(d) : oe && oe.openAdvancedFilter(d);
+      },
+      children: /* @__PURE__ */ r("path", { d: "M3 17v2h6v-2H3zM3 5v2h10V5H3zm10 16v-2h8v-2h-8v-2h-2v6h2zM7 9v2H3v2h4v2h2V9H7zm14 4v-2H11v2h10zm-6-4h2V7h4V5h-4V3h-2v6z" })
+    }
+  ) : null, Ye = () => /* @__PURE__ */ r(
+    "button",
+    {
+      onClick: $,
+      className: "cursor-pointer shrink-0 text-brand hover:text-brand-strong",
+      children: /* @__PURE__ */ r(j, { size: "xs" })
+    }
+  ), N = l.filter === "agMultiColumnFilter", m = H(l);
+  let g = "text";
+  N ? g = m.set !== -1 ? "set" : m.date !== -1 ? "date" : "text" : V ? g = "set" : M && (g = "date");
+  const Ge = N ? m.text !== -1 || m.number !== -1 : !M && !V, xe = N ? m.set !== -1 : V, be = N ? m.date !== -1 : M, Ve = x.getFilterModel()[d], Fe = N && Ve?.filterModels?.some((e, t) => {
+    const n = t === m.text || t === m.number ? "text" : t === m.set ? "set" : "date";
+    return e !== null && n !== g;
+  });
+  return /* @__PURE__ */ y("div", { className: "ag-header-cell-label flex items-center gap-1 w-full bg-brand-tint px-1 py-2 ag-header-cell-search-active h-full", children: [
+    g === "set" && xe ? /* @__PURE__ */ r(
+      Pe,
+      {
+        options: W,
+        value: ve(),
+        onChange: ye,
+        isMulti: C !== void 0 ? C : l?.cellDataType !== "boolean",
+        placeholder: i("filter.select"),
+        className: "w-full bg-canvas-elevated",
+        parentClassName: "flex-1 min-w-0",
+        menuWidth: "200px",
+        menuPortalTarget: document.body,
+        autoFocus: !0,
+        onMenuOpen: je,
+        onMenuClose: Re,
+        onMenuScrollToBottom: Ae,
+        onInputChange: He,
+        onClearAll: Ee,
+        isLoading: ae,
+        onFocus: p,
+        onBlur: h
+      }
+    ) : g === "date" && be ? I ? /* @__PURE__ */ r(
+      q,
+      {
+        value: I,
+        onChange: me,
+        placeholder: i("filter.search"),
+        className: "w-full bg-canvas-elevated",
+        autoFocus: !0,
+        onFocus: p,
+        onBlur: h,
+        suffix: /* @__PURE__ */ r(
+          "button",
+          {
+            onClick: (e) => {
+              e.stopPropagation(), Q();
+            },
+            className: "cursor-pointer text-navigation-muted hover:text-brand-variant-hover",
+            children: /* @__PURE__ */ r(j, { size: "xs" })
+          }
+        )
+      }
+    ) : B ? /* @__PURE__ */ r(
+      Ne,
+      {
+        value: ce || void 0,
+        onChange: (e) => pe(e || null),
+        placeholder: i("datePicker.selectWeek"),
+        format: b,
+        minDate: /* @__PURE__ */ new Date("2000-01-01"),
+        maxDate: /* @__PURE__ */ new Date("2100-12-31"),
+        className: "w-full bg-canvas-elevated",
+        showFooter: !1,
+        calendarType: c?.calendarType,
+        fiscalMode: c?.fiscalMode,
+        selectionMode: c?.selectionMode,
+        fiscalMonthPattern: c?.fiscalMonthPattern,
+        fiscalYearStartMonth: c?.fiscalYearStartMonth,
+        weekStartsOn: c?.weekStartsOn
+      }
+    ) : z ? /* @__PURE__ */ r(
+      De,
+      {
+        value: ie || void 0,
+        onChange: (e) => fe(e || null),
+        placeholder: i("datePicker.selectMonth"),
+        minDate: /* @__PURE__ */ new Date("2000-01-01"),
+        maxDate: /* @__PURE__ */ new Date("2100-12-31"),
+        className: "w-full bg-canvas-elevated",
+        showFooter: !1,
+        onFocus: p,
+        onBlur: h
+      }
+    ) : /* @__PURE__ */ r(
+      Te,
+      {
+        value: se || void 0,
+        onChange: (e) => ue(e || null),
+        placeholder: i("filter.selectDate"),
+        format: b,
+        minDate: /* @__PURE__ */ new Date("2000-01-01"),
+        maxDate: /* @__PURE__ */ new Date("2100-12-31"),
+        className: "w-full bg-canvas-elevated",
+        weekStartsOn: c?.weekStartsOn,
+        onFocus: p,
+        onBlur: h
+      }
+    ) : /* @__PURE__ */ r(
+      q,
+      {
+        value: U,
+        onChange: de,
+        placeholder: i("filter.search"),
+        type: "text",
+        autoFocus: !0,
+        ref: _,
+        onFocus: p,
+        onBlur: h,
+        suffix: U && /* @__PURE__ */ r(
+          "button",
+          {
+            onClick: (e) => {
+              e.stopPropagation(), Q();
+            },
+            className: "cursor-pointer text-navigation-muted hover:text-brand-variant-hover",
+            children: /* @__PURE__ */ r(j, { size: "xs" })
+          }
+        )
+      }
+    ),
+    /* @__PURE__ */ y("div", { className: "flex items-center gap-1.5 shrink-0", children: [
+      N && /* @__PURE__ */ y(Ke, { children: [
+        /* @__PURE__ */ r(Qe, { asChild: !0, children: /* @__PURE__ */ y(
+          "button",
+          {
+            type: "button",
+            "aria-label": i("gridHeader.activeFilters"),
+            className: "relative group p-1 hover:bg-brand-tint rounded-md transition-colors cursor-pointer bg-transparent border-none",
+            children: [
+              /* @__PURE__ */ r(
+                Ue,
+                {
+                  size: "md",
+                  className: Je(
+                    "text-content-tertiary group-hover:text-brand-variant-hover",
+                    Fe && "text-brand-variant-hover"
+                  )
+                }
+              ),
+              Fe && /* @__PURE__ */ r("span", { className: "absolute top-0.5 right-0.5 w-2 h-2 rounded-full bg-brand border border-white shadow-sm" })
+            ]
+          }
+        ) }),
+        /* @__PURE__ */ y(Xe, { align: "end", className: "w-[300px]", children: [
+          /* @__PURE__ */ r(Ze, { children: /* @__PURE__ */ r($e, { children: i("gridHeader.activeFilters") }) }),
+          /* @__PURE__ */ y(et, { className: "flex flex-col gap-4", children: [
+            g !== "text" && Ge && /* @__PURE__ */ y("div", { className: "flex flex-col gap-1.5", children: [
+              /* @__PURE__ */ r("span", { className: "text-xs font-semibold text-content-tertiary", children: i("gridHeader.textSearch") }),
+              /* @__PURE__ */ r(
+                q,
+                {
+                  value: U,
+                  onChange: de,
+                  placeholder: i("filter.searchPlaceholder"),
+                  className: "bg-canvas-elevated",
+                  onFocus: p,
+                  onBlur: h
+                }
+              )
+            ] }),
+            g !== "set" && xe && /* @__PURE__ */ y("div", { className: "flex flex-col gap-1.5", children: [
+              /* @__PURE__ */ r("span", { className: "text-xs font-semibold text-content-tertiary", children: i("gridHeader.selectionFilter") }),
+              /* @__PURE__ */ r(
+                Pe,
+                {
+                  options: W,
+                  value: ve(),
+                  onChange: ye,
+                  isMulti: C !== void 0 ? C : l?.cellDataType !== "boolean",
+                  placeholder: i("filter.select"),
+                  className: "w-full bg-canvas-elevated",
+                  isLoading: ae,
+                  onFocus: p,
+                  onBlur: h
+                }
+              )
+            ] }),
+            g !== "date" && be && /* @__PURE__ */ y("div", { className: "flex flex-col gap-1.5", children: [
+              /* @__PURE__ */ r("span", { className: "text-xs font-semibold text-content-tertiary", children: i("gridHeader.dateFilter") }),
+              I ? /* @__PURE__ */ r(
+                q,
+                {
+                  value: I,
+                  onChange: me,
+                  className: "w-full bg-canvas-elevated",
+                  onFocus: p,
+                  onBlur: h,
+                  suffix: /* @__PURE__ */ r(
+                    "button",
+                    {
+                      onClick: (e) => {
+                        e.stopPropagation(), Q();
+                      },
+                      className: "cursor-pointer text-navigation-muted hover:text-brand-variant-hover",
+                      children: /* @__PURE__ */ r(j, { size: "xs" })
+                    }
+                  )
+                }
+              ) : B ? /* @__PURE__ */ r(
+                Ne,
+                {
+                  value: ce || void 0,
+                  onChange: (e) => pe(e || null),
+                  format: b,
+                  className: "w-full bg-canvas-elevated",
+                  showFooter: !1,
+                  calendarType: c?.calendarType,
+                  fiscalMode: c?.fiscalMode,
+                  selectionMode: c?.selectionMode,
+                  fiscalMonthPattern: c?.fiscalMonthPattern,
+                  fiscalYearStartMonth: c?.fiscalYearStartMonth,
+                  weekStartsOn: c?.weekStartsOn
+                }
+              ) : z ? /* @__PURE__ */ r(
+                De,
+                {
+                  value: ie || void 0,
+                  onChange: (e) => fe(e || null),
+                  className: "w-full bg-canvas-elevated",
+                  showFooter: !1,
+                  onFocus: p,
+                  onBlur: h
+                }
+              ) : /* @__PURE__ */ r(
+                Te,
+                {
+                  value: se || void 0,
+                  onChange: (e) => ue(e || null),
+                  format: b,
+                  className: "w-full bg-canvas-elevated",
+                  weekStartsOn: c?.weekStartsOn,
+                  onFocus: p,
+                  onBlur: h
+                }
+              )
+            ] })
+          ] })
+        ] })
+      ] }),
+      qe(),
+      Ye()
+    ] })
+  ] });
+};
+export {
+  Tt as HeaderSearchInput
+};

package/dist/components/data/ag-grid-react/headers/use-header-search-editing-state.d.ts

@@ -0,0 +1,34 @@
+import { ColDef, GridApi } from 'ag-grid-community';
+import { HeaderSearchCommittedState } from './derive-header-search-state';
+interface UseHeaderSearchEditingStateOptions {
+    api: GridApi;
+    colId: string;
+    colDef: ColDef | undefined;
+    isDateFilter: boolean;
+    isMonthVariant: boolean;
+    isWeekVariant: boolean;
+    datePickerVariant: "date" | "month" | "week";
+    dateDisplayFormat: string;
+}
+/**
+ * Inline header search display state.
+ *
+ * AG Grid's filter model is the source of truth. While inline search is open,
+ * AgGridWrapper skips refreshHeader on filterChanged, so this hook subscribes
+ * to filterChanged and keeps a column-scoped snapshot in React state. When the
+ * snapshot changes, committed display values are re-derived from the live filter
+ * model. While an input is focused, a draft overlays committed values so typing
+ * is not interrupted.
+ */
+export declare function useHeaderSearchEditingState(options: UseHeaderSearchEditingStateOptions): {
+    searchText: string;
+    dateDisplayString: string;
+    selectedDate: Date | null;
+    selectedMonth: import('../../../..').MonthSelection | null;
+    selectedWeek: import('../../../..').WeekSelection | null;
+    updateDraft: (patch: Partial<HeaderSearchCommittedState>) => void;
+    handleFocus: () => void;
+    handleBlur: () => void;
+    clearEditingOverlay: () => void;
+};
+export {};

package/dist/components/data/ag-grid-react/headers/utils/date-utils.d.ts

@@ -0,0 +1,88 @@
+import { MonthSelection, WeekSelection } from '../../../../data-display/calendar';
+/** Default display format used across AG Grid date filters */
+export declare const DEFAULT_DATE_DISPLAY_FORMAT = "MM/dd/yyyy";
+/**
+ * Convert a MonthSelection to an AG Grid inRange date filter range.
+ * Returns { dateFrom: 'YYYY-MM-01', dateTo: 'YYYY-MM-lastDay' }.
+ */
+export declare function serializeMonth(month: MonthSelection): {
+    dateFrom: string;
+    dateTo: string;
+};
+/**
+ * Reconstruct a MonthSelection from a YYYY-MM-DD date string.
+ */
+export declare function deserializeMonth(dateStr: string | null): MonthSelection | null;
+/**
+ * Standardize date serialization for AG Grid filter model
+ * Returns YYYY-MM-DD string
+ */
+export declare function serializeDate(date: Date | null): string | null;
+/**
+ * Parse YYYY-MM-DD string to Date object
+ * Assumes midnight local time
+ */
+export declare function deserializeDate(dateStr: string | null): Date | null;
+/**
+ * AG Grid Date Comparator
+ *
+ * Required because our data might be strings ("2024-01-20") or Date objects,
+ * but AG Grid's Date Filter operates on Date objects set to midnight.
+ *
+ * @param filterLocalDateAtMidnight Date object from the filter picker (Time is 00:00:00)
+ * @param cellValue Value from the row data (can be string or Date)
+ */
+export declare function dateComparator(filterLocalDateAtMidnight: Date, cellValue: string | Date | null | undefined): number;
+/**
+ * Get Today as YYYY-MM-DD
+ */
+export declare function getTodayStr(): string;
+/**
+ * Get Yesterday as YYYY-MM-DD
+ */
+export declare function getYesterdayStr(): string;
+/**
+ * Convert a display-format date string to ISO (YYYY-MM-DD).
+ * Uses date-fns parse() for format-aware conversion.
+ * @param displayStr - The display string typed by user (e.g. "02/06/2026" or "06-02-2026")
+ * @param dateFormat - The date-fns format pattern the string is in (e.g. "MM/dd/yyyy", "dd/MM/yyyy")
+ * @returns ISO string "YYYY-MM-DD" or null if invalid
+ */
+export declare function displayDateToIso(displayStr: string, dateFormat?: string): string | null;
+/**
+ * Convert an ISO date string (YYYY-MM-DD) to display format.
+ * Uses date-fns format() for format-aware conversion.
+ * @param isoStr - ISO date string (e.g. "2026-06-02")
+ * @param dateFormat - The target display format (e.g. "MM/dd/yyyy", "dd-MM-yyyy")
+ * @returns Formatted display string or empty string if invalid
+ */
+export declare function isoToDisplay(isoStr: string | null | undefined, dateFormat?: string): string;
+/**
+ * Get range for a whole year
+ */
+export declare function getYearRange(year: number): {
+    from: string;
+    to: string;
+};
+/**
+ * Get range for a specific month in a year
+ * month: 1-12
+ */
+export declare function getMonthRange(month: number, year: number): {
+    from: string;
+    to: string;
+};
+/**
+ * Convert a WeekSelection to an AG Grid inRange date filter range.
+ * Returns { dateFrom: 'YYYY-MM-DD', dateTo: 'YYYY-MM-DD' } using the week's start and end dates.
+ */
+export declare function serializeWeek(week: WeekSelection): {
+    dateFrom: string;
+    dateTo: string;
+};
+/**
+ * Reconstruct a WeekSelection from dateFrom and dateTo strings.
+ * Note: This creates a minimal WeekSelection with startDate and endDate.
+ * The year, month, weekOfMonth fields are derived from startDate.
+ */
+export declare function deserializeWeek(dateFrom: string | null, dateTo: string | null): WeekSelection | null;