impact-nova 2.2.9 → 2.4.0

package/dist/components/forms/combobox/combobox.js

@@ -1,161 +1,170 @@
-import { jsx as a, jsxs as we } from "react/jsx-runtime";
-import { useId as J, useMemo as _, useState as C, useCallback as c, useRef as E, useEffect as ye } from "react";
-import * as O from "@radix-ui/react-popover";
-import { createComponent as Ce } from "../../../lib/primitives/create-component.js";
-import { cn as P } from "../../../lib/utils.js";
-import { useFieldChrome as Ie } from "../../../lib/primitives/use-field-chrome.js";
-import { useOverlayNestedLayerDismiss as De, useOverlayPortalContainer as Le } from "../../../lib/overlay/overlay-portal-context.js";
-import { OVERLAY_NESTED_FLOATING_INSTANT_HIDE_CLASS as ke } from "../../../lib/overlay/overlay-host.constants.js";
-import { comboboxSizeVariants as Ae } from "./combobox.variants.js";
-function Se(l) {
+import { jsx as i, jsxs as $ } from "react/jsx-runtime";
+import { useId as Z, useMemo as z, useState as k, useCallback as c, useRef as T, useEffect as ke } from "react";
+import * as E from "@radix-ui/react-popover";
+import { Cross as Le } from "impact-nova-icons";
+import { Tooltip as Ae, TooltipTrigger as Ne, TooltipContent as Se } from "../../feedback/tooltip/tooltip.js";
+import { useImpactNovaI18n as Pe } from "../../../i18n/use-impact-nova-i18n.js";
+import { createComponent as Te } from "../../../lib/primitives/create-component.js";
+import { cn as O } from "../../../lib/utils.js";
+import { useFieldChrome as Ee } from "../../../lib/primitives/use-field-chrome.js";
+import { useOverlayNestedLayerDismiss as Oe, useOverlayPortalContainer as He } from "../../../lib/overlay/overlay-portal-context.js";
+import { OVERLAY_NESTED_FLOATING_INSTANT_HIDE_CLASS as Re } from "../../../lib/overlay/overlay-host.constants.js";
+import { comboboxSizeVariants as Ve } from "./combobox.variants.js";
+function Me(l) {
   if (l.options) return l.options;
-  const { min: u, max: d, step: f } = l;
-  if (u == null || d == null || f == null || f <= 0 || u > d) return [];
-  const I = [];
-  for (let b = u; b <= d; b += f) {
-    const D = Math.round(b * 1e10) / 1e10;
-    I.push(String(D));
+  const { min: u, max: f, step: p } = l;
+  if (u == null || f == null || p == null || p <= 0 || u > f) return [];
+  const L = [];
+  for (let x = u; x <= f; x += p) {
+    const v = Math.round(x * 1e10) / 1e10;
+    L.push(String(v));
   }
-  return I;
+  return L;
 }
-function Ne(l, u) {
+function je(l, u) {
   if (!u) return l;
-  const d = u.toLowerCase();
-  return l.filter((f) => f.toLowerCase().includes(d));
+  const f = u.toLowerCase();
+  return l.filter((p) => p.toLowerCase().includes(f));
 }
-const je = Ce(
+const Je = Te(
   "Combobox",
   ({
     options: l,
     min: u,
-    max: d,
-    step: f,
-    defaultValue: I = "",
-    value: b,
-    onChange: D,
-    onBlur: F,
-    placeholder: $,
-    label: L,
-    helperText: Q,
-    helperTextPosition: X = "absolute",
-    error: Z,
-    isError: ee,
-    disabled: m,
+    max: f,
+    step: p,
+    defaultValue: L = "",
+    value: x,
+    onChange: v,
+    onBlur: B,
+    placeholder: K,
+    label: A,
+    helperText: ee,
+    helperTextPosition: te = "absolute",
+    error: oe,
+    isError: ne,
+    disabled: d,
     isNumeric: H,
-    size: te = "default",
-    className: oe,
-    emptyMessage: ne = "No options found",
-    allowFreeText: k = !1,
-    required: z,
-    labelOrientation: re
-  }, v) => {
-    const se = J(), A = J(), R = typeof L == "string" ? L : $ ?? "Options", T = Ie({
-      label: L,
-      helperText: Q,
-      helperTextPosition: X,
-      labelOrientation: re,
-      error: Z ?? ee,
-      required: z,
-      disabled: m,
-      id: se,
-      className: oe
-    }), B = _(
-      () => Se({ options: l, min: u, max: d, step: f }),
-      [l, u, d, f]
-    ), V = b !== void 0, [ie, ae] = C(I), S = V ? b : ie, [ce, K] = C(""), [o, x] = C(!1), le = c((e) => {
-      x(e);
+    size: re = "default",
+    className: se,
+    emptyMessage: ie = "No options found",
+    allowFreeText: N = !1,
+    clearable: ae = !1,
+    required: U,
+    labelOrientation: ce
+  }, w) => {
+    const le = Z(), S = Z(), { t: W } = Pe(), R = typeof A == "string" ? A : K ?? "Options", V = Ee({
+      label: A,
+      helperText: ee,
+      helperTextPosition: te,
+      labelOrientation: ce,
+      error: oe ?? ne,
+      required: U,
+      disabled: d,
+      id: le,
+      className: se
+    }), q = z(
+      () => Me({ options: l, min: u, max: f, step: p }),
+      [l, u, f, p]
+    ), y = x !== void 0, [ue, G] = k(L), C = y ? x : ue, [de, M] = k(""), [o, h] = k(!1), fe = c((e) => {
+      h(e);
     }, []);
-    De(o && !m, le);
-    const ue = Le(), n = o ? ce : S, [M, p] = C(-1), U = E(-1), [de, w] = C("keyboard"), W = E(null), N = E(null), fe = c(
+    Oe(o && !d, fe);
+    const pe = He(), n = o ? de : C, [j, m] = k(-1), Y = T(-1), [me, I] = k("keyboard"), _ = T(null), P = T(null), he = c(
       (e) => {
-        W.current = e, typeof v == "function" ? v(e) : v && (v.current = e);
+        _.current = e, typeof w == "function" ? w(e) : w && (w.current = e);
       },
-      [v]
-    ), r = _(
-      () => Ne(B, n),
-      [B, n]
-    ), q = E(r), me = _(() => {
+      [w]
+    ), r = z(
+      () => je(q, n),
+      [q, n]
+    ), J = T(r), ge = z(() => {
       if (!o || !n) return -1;
       const e = r.findIndex(
         (t) => t.toLowerCase() === n.toLowerCase()
       );
       return e >= 0 ? e : -1;
-    }, [o, n, r]), h = M >= 0 ? M : me, G = M >= 0 ? de : "mouse", pe = o && h >= 0 ? `${A}-option-${h}` : void 0;
-    ye(() => {
-      U.current = h, q.current = r, o && h >= 0 && N.current && N.current.querySelectorAll("[data-combobox-item]")[h]?.scrollIntoView({ block: "nearest" });
-    }, [h, o, r]);
-    const i = c(
+    }, [o, n, r]), g = j >= 0 ? j : ge, Q = j >= 0 ? me : "mouse", be = o && g >= 0 ? `${S}-option-${g}` : void 0;
+    ke(() => {
+      Y.current = g, J.current = r, o && g >= 0 && P.current && P.current.querySelectorAll("[data-combobox-item]")[g]?.scrollIntoView({ block: "nearest" });
+    }, [g, o, r]);
+    const a = c(
       (e) => {
-        V || ae(e), D?.(e), x(!1), p(-1);
+        y || G(e), v?.(e), h(!1), m(-1);
       },
-      [V, D]
-    ), y = c(() => {
-      x(!1), p(-1);
-    }, []), he = c(
+      [y, v]
+    ), D = c(() => {
+      h(!1), m(-1);
+    }, []), xe = c(
+      (e) => {
+        e.preventDefault(), e.stopPropagation(), y || G(""), v?.(""), M(""), h(!1), m(-1), setTimeout(() => _.current?.focus(), 0);
+      },
+      [y, v]
+    ), ve = ae && !d && C.length > 0, we = c(
       (e) => {
         const t = e.target.value;
-        K(t), p(-1), w("mouse"), o || x(!0);
+        M(t), m(-1), I("mouse"), o || h(!0);
       },
       [o]
-    ), ge = c(() => {
-      m || (K(S), x(!0));
-    }, [m, S]), be = c(
+    ), ye = c(() => {
+      d || (M(C), h(!0));
+    }, [d, C]), Ce = c(
       (e) => {
         const t = e.relatedTarget;
-        if (!N.current?.contains(t)) {
+        if (!P.current?.contains(t)) {
           if (o) {
             const s = r.find(
-              (g) => g.toLowerCase() === n.toLowerCase()
+              (b) => b.toLowerCase() === n.toLowerCase()
             );
-            s ? i(s) : r.length === 1 ? i(r[0]) : k && n ? i(n) : y();
+            s ? a(s) : r.length === 1 ? a(r[0]) : N && n ? a(n) : D();
           }
-          F?.(e);
+          B?.(e);
         }
       },
-      [o, r, n, i, y, k, F]
-    ), xe = c(
+      [o, r, n, a, D, N, B]
+    ), Ie = c(
       (e) => {
         if (!o) {
-          (e.key === "ArrowDown" || e.key === "ArrowUp") && (e.preventDefault(), x(!0));
+          (e.key === "ArrowDown" || e.key === "ArrowUp") && (e.preventDefault(), h(!0));
           return;
         }
         if (e.key === "Escape") {
-          e.preventDefault(), e.stopPropagation(), y();
+          e.preventDefault(), e.stopPropagation(), D();
           return;
         }
         if (e.key === "ArrowDown") {
-          e.preventDefault(), w("keyboard"), p(
+          e.preventDefault(), I("keyboard"), m(
             (t) => t < r.length - 1 ? t + 1 : 0
           );
           return;
         }
         if (e.key === "ArrowUp") {
-          e.preventDefault(), w("keyboard"), p(
+          e.preventDefault(), I("keyboard"), m(
             (t) => t > 0 ? t - 1 : r.length - 1
           );
           return;
         }
         if (e.key === "Enter" || e.key === "Tab") {
           e.preventDefault();
-          const t = U.current, s = q.current;
+          const t = Y.current, s = J.current;
           if (t >= 0 && t < s.length)
-            i(s[t]);
+            a(s[t]);
           else {
-            const g = s.find(
-              (j) => j.toLowerCase() === n.toLowerCase()
+            const b = s.find(
+              (F) => F.toLowerCase() === n.toLowerCase()
             );
-            g ? i(g) : s.length === 1 ? i(s[0]) : k && n ? i(n) : y();
+            b ? a(b) : s.length === 1 ? a(s[0]) : N && n ? a(n) : D();
           }
           return;
         }
       },
-      [o, r, n, i, y, k]
-    ), Y = c(
+      [o, r, n, a, D, N]
+    ), X = c(
       (e) => {
-        i(e), setTimeout(() => W.current?.focus(), 0);
+        a(e), setTimeout(() => _.current?.focus(), 0);
       },
-      [i]
-    ), ve = c(
+      [a]
+    ), De = c(
       (e) => {
         const t = e.target.closest(
           "[data-combobox-item]"
@@ -164,66 +173,82 @@ const je = Ce(
           if (e.button !== 0) return;
           e.preventDefault();
           const s = t.getAttribute("data-combobox-value");
-          s != null && Y(s);
+          s != null && X(s);
           return;
         }
         e.preventDefault();
       },
-      [Y]
+      [X]
     );
-    return /* @__PURE__ */ a("div", { "data-component": "combobox", "data-numeric": H || void 0, children: T.wrapControl(
-      /* @__PURE__ */ we(O.Root, { open: o && !m, modal: !1, children: [
-        /* @__PURE__ */ a(O.Anchor, { asChild: !0, children: /* @__PURE__ */ a(
+    return /* @__PURE__ */ i("div", { "data-component": "combobox", "data-numeric": H || void 0, children: V.wrapControl(
+      /* @__PURE__ */ $(E.Root, { open: o && !d, modal: !1, children: [
+        /* @__PURE__ */ i(E.Anchor, { asChild: !0, children: /* @__PURE__ */ $(
           "div",
           {
             "data-component": "combobox-input-border",
             tabIndex: -1,
-            className: P(
+            className: O(
               "flex w-full items-center gap-1 rounded-md border bg-transparent px-3 text-sm transition-colors outline-none ring-0 focus:outline-none focus:ring-0",
               "focus-within:outline-none focus-within:ring-0 focus-within:border-brand hover:border-brand",
-              T.hasError ? "border-destructive hover:border-destructive" : "border-field",
-              m && "pointer-events-none opacity-100 bg-disabled-surface border-stroke text-disabled-foreground hover:border-stroke",
-              Ae({ size: te }),
+              V.hasError ? "border-destructive hover:border-destructive" : "border-field",
+              d && "pointer-events-none opacity-100 bg-disabled-surface border-stroke text-disabled-foreground hover:border-stroke",
+              Ve({ size: re }),
               "bg-canvas"
             ),
-            children: /* @__PURE__ */ a(
-              "input",
-              {
-                ref: fe,
-                type: "text",
-                value: n,
-                onChange: he,
-                onFocus: ge,
-                onBlur: be,
-                onKeyDown: xe,
-                placeholder: $,
-                disabled: !!m,
-                className: P(
-                  "flex h-full w-full bg-transparent p-0 text-sm font-medium",
-                  "outline-none ring-0 shadow-none border-none",
-                  "focus:outline-none focus:ring-0 focus:shadow-none focus:border-none",
-                  "focus-visible:outline-none focus-visible:ring-0 focus-visible:shadow-none focus-visible:border-none",
-                  "placeholder:font-medium placeholder:text-content-empty",
-                  m && "opacity-100 text-disabled-foreground placeholder:text-disabled-foreground cursor-not-allowed",
-                  H && "text-right"
-                ),
-                style: { boxShadow: "none", outline: "none" },
-                autoComplete: "off",
-                role: "combobox",
-                "aria-expanded": o,
-                "aria-autocomplete": "list",
-                "aria-haspopup": "listbox",
-                "aria-controls": o ? A : void 0,
-                "aria-activedescendant": pe,
-                "aria-required": z || void 0,
-                "aria-label": L ? void 0 : R,
-                ...T.controlAria
-              }
-            )
+            children: [
+              /* @__PURE__ */ i(
+                "input",
+                {
+                  ref: he,
+                  type: "text",
+                  value: n,
+                  onChange: we,
+                  onFocus: ye,
+                  onBlur: Ce,
+                  onKeyDown: Ie,
+                  placeholder: K,
+                  disabled: !!d,
+                  className: O(
+                    "flex h-full w-full bg-transparent p-0 text-sm font-medium",
+                    "outline-none ring-0 shadow-none border-none",
+                    "focus:outline-none focus:ring-0 focus:shadow-none focus:border-none",
+                    "focus-visible:outline-none focus-visible:ring-0 focus-visible:shadow-none focus-visible:border-none",
+                    "placeholder:font-medium placeholder:text-content-empty",
+                    d && "opacity-100 text-disabled-foreground placeholder:text-disabled-foreground cursor-not-allowed",
+                    H && "text-right"
+                  ),
+                  style: { boxShadow: "none", outline: "none" },
+                  autoComplete: "off",
+                  role: "combobox",
+                  "aria-expanded": o,
+                  "aria-autocomplete": "list",
+                  "aria-haspopup": "listbox",
+                  "aria-controls": o ? S : void 0,
+                  "aria-activedescendant": be,
+                  "aria-required": U || void 0,
+                  "aria-label": A ? void 0 : R,
+                  ...V.controlAria
+                }
+              ),
+              ve ? /* @__PURE__ */ $(Ae, { children: [
+                /* @__PURE__ */ i(Ne, { asChild: !0, children: /* @__PURE__ */ i(
+                  "button",
+                  {
+                    type: "button",
+                    "data-clear-button": !0,
+                    "aria-label": W("select.clear"),
+                    className: "inline-flex shrink-0 cursor-pointer border-none bg-transparent p-0.5 text-content-icon hover:text-content-secondary",
+                    onPointerDown: xe,
+                    children: /* @__PURE__ */ i(Le, { size: "11px", className: "text-content-icon" })
+                  }
+                ) }),
+                /* @__PURE__ */ i(Se, { variant: "tertiary", side: "top", children: W("select.clear") })
+              ] }) : null
+            ]
           }
         ) }),
-        /* @__PURE__ */ a(O.Portal, { container: ue, children: /* @__PURE__ */ a(
-          O.Content,
+        /* @__PURE__ */ i(E.Portal, { container: pe, children: /* @__PURE__ */ i(
+          E.Content,
           {
             align: "start",
             side: "bottom",
@@ -237,46 +262,46 @@ const je = Ce(
             onInteractOutside: () => {
             },
             onWheel: (e) => e.stopPropagation(),
-            className: P(
+            className: O(
               "z-[9999] overflow-hidden rounded-[12px] bg-canvas text-base shadow-elevation-select focus:outline-none sm:text-sm flex flex-col border-none w-[var(--radix-popover-trigger-width)]",
-              ke
+              Re
             ),
             style: {
               maxHeight: "var(--radix-popover-content-available-height)"
             },
-            children: /* @__PURE__ */ a(
+            children: /* @__PURE__ */ i(
               "div",
               {
-                ref: N,
-                id: A,
+                ref: P,
+                id: S,
                 className: "flex-1 overflow-auto py-1 px-[6px]",
                 style: { maxHeight: 240, overscrollBehavior: "contain" },
                 role: "listbox",
                 "aria-label": R,
-                onPointerDown: ve,
+                onPointerDown: De,
                 onWheel: (e) => e.stopPropagation(),
                 onMouseLeave: () => {
-                  w("mouse"), p(-1);
+                  I("mouse"), m(-1);
                 },
-                children: r.length === 0 ? /* @__PURE__ */ a("div", { className: "flex items-center justify-center py-6 text-sm text-secondary-foreground", children: ne }) : r.map((e, t) => {
-                  const s = t === h, g = e.toLowerCase() === S.toLowerCase(), j = `${A}-option-${t}`;
-                  return /* @__PURE__ */ a("div", { className: "w-full pb-[2px]", children: /* @__PURE__ */ a(
+                children: r.length === 0 ? /* @__PURE__ */ i("div", { className: "flex items-center justify-center py-6 text-sm text-secondary-foreground", children: ie }) : r.map((e, t) => {
+                  const s = t === g, b = e.toLowerCase() === C.toLowerCase(), F = `${S}-option-${t}`;
+                  return /* @__PURE__ */ i("div", { className: "w-full pb-[2px]", children: /* @__PURE__ */ i(
                     "div",
                     {
                       "data-combobox-item": !0,
                       "data-combobox-value": e,
-                      id: j,
+                      id: F,
                       role: "option",
-                      "aria-selected": g,
-                      className: P(
+                      "aria-selected": b,
+                      className: O(
                         "cursor-default select-none py-[6px] px-3 flex items-center transition-colors rounded-md",
                         H ? "justify-end text-right" : "justify-between",
-                        s && G === "keyboard" ? "ring-2 ring-inset ring-primary bg-accent text-content" : s && G === "mouse" ? "bg-canvas-muted text-content" : g ? "bg-accent text-content" : "text-content hover:bg-canvas-muted cursor-pointer"
+                        s && Q === "keyboard" ? "ring-2 ring-inset ring-primary bg-accent text-content" : s && Q === "mouse" ? "bg-canvas-muted text-content" : b ? "bg-accent text-content" : "text-content hover:bg-canvas-muted cursor-pointer"
                       ),
                       onMouseEnter: () => {
-                        w("mouse"), p(t);
+                        I("mouse"), m(t);
                       },
-                      children: /* @__PURE__ */ a("span", { className: "text-sm", children: e })
+                      children: /* @__PURE__ */ i("span", { className: "text-sm", children: e })
                     }
                   ) }, e);
                 })
@@ -289,5 +314,5 @@ const je = Ce(
   }
 );
 export {
-  je as Combobox
+  Je as Combobox
 };

package/dist/components/forms/combobox/combobox.types.d.ts

@@ -36,4 +36,6 @@ export interface ComboboxProps extends FieldControlProps {
     emptyMessage?: string;
     /** If true, typed text is committed even when it doesn't match any option */
     allowFreeText?: boolean;
+    /** When true, shows a clear button to reset the committed value */
+    clearable?: boolean;
 }

package/dist/filter-shell/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Optional headless validation helpers for filter-panel UIs.
+ * Does not include filter orchestration, saved filters, or network I/O.
+ *
+ * @packageDocumentation
+ */
+export { buildFilterFieldValidationRules, isFilterFieldValueValid, } from './utils/buildFilterFieldValidationRules';
+export type { FilterFieldValidationShape } from './utils/buildFilterFieldValidationRules';
+export { validateVisibleRequiredFilterFields, } from './utils/validateVisibleRequiredFilterFields';
+export type { FilterFormValues, ValidateVisibleRequiredFilterFieldsResult, } from './utils/validateVisibleRequiredFilterFields';
+export { navigateToFirstFilterValidationError } from './utils/validationNavigation.utils';
+export type { FilterValidationNavigationConfig, FilterValidationNavigationOptions, } from './utils/validationNavigation.utils';

package/dist/filter-shell/index.js

@@ -0,0 +1,9 @@
+import { navigateToFirstFilterValidationError as l } from "./utils/validationNavigation.utils.js";
+import { buildFieldValidationRules as d, isFieldValueValid as r } from "../form-react/utils/buildFieldValidationRules.js";
+import { validateVisibleRequiredFormFields as o } from "../form-react/utils/validateVisibleRequiredFormFields.js";
+export {
+  d as buildFilterFieldValidationRules,
+  r as isFilterFieldValueValid,
+  l as navigateToFirstFilterValidationError,
+  o as validateVisibleRequiredFilterFields
+};

package/dist/filter-shell/utils/buildFilterFieldValidationRules.d.ts

@@ -0,0 +1 @@
+export { buildFieldValidationRules as buildFilterFieldValidationRules, isFieldValueValid as isFilterFieldValueValid, type FieldValidationShape as FilterFieldValidationShape, } from '../../form-react/utils/buildFieldValidationRules';

package/dist/filter-shell/utils/validateVisibleRequiredFilterFields.d.ts

@@ -0,0 +1 @@
+export { validateVisibleRequiredFormFields as validateVisibleRequiredFilterFields, type ValidateVisibleRequiredFormFieldsResult as ValidateVisibleRequiredFilterFieldsResult, type FormValidationValues as FilterFormValues, } from '../../form-react/utils/validateVisibleRequiredFormFields';

package/dist/filter-shell/utils/validationNavigation.utils.d.ts

@@ -0,0 +1,26 @@
+export interface FilterValidationNavigationConfig {
+    dimensions: Array<{
+        id: string;
+        label?: string;
+        sections: Array<{
+            id: string;
+            label?: string;
+            fields: Array<{
+                id: string;
+                label?: string;
+            }>;
+        }>;
+    }>;
+}
+export interface FilterValidationNavigationOptions {
+    filterConfig: FilterValidationNavigationConfig;
+    errorFieldIds: string[];
+    getFieldTestId: (fieldId: string) => string;
+    onNavigateToDimension?: (dimensionId: string) => void;
+    buildValidationToastMessage?: (params: {
+        errorFieldLabels: string[];
+        dimensionLabel?: string;
+    }) => string;
+    showToast?: (message: string) => void;
+}
+export declare function navigateToFirstFilterValidationError({ filterConfig, errorFieldIds, getFieldTestId, onNavigateToDimension, buildValidationToastMessage, showToast, }: FilterValidationNavigationOptions): void;

package/dist/filter-shell/utils/validationNavigation.utils.js

@@ -0,0 +1,38 @@
+function b({
+  filterConfig: f,
+  errorFieldIds: i,
+  getFieldTestId: s,
+  onNavigateToDimension: d,
+  buildValidationToastMessage: t,
+  showToast: o
+}) {
+  if (i.length === 0)
+    return;
+  const r = i[0];
+  for (const n of f.dimensions)
+    for (const l of n.sections)
+      if (l.fields.find(
+        (e) => e.id === r
+      )) {
+        if (d?.(n.id), t && o) {
+          const e = i.map((c) => l.fields.find(
+            (a) => a.id === c
+          )?.label || c).filter(Boolean);
+          o(
+            t({
+              errorFieldLabels: e,
+              dimensionLabel: n.label
+            })
+          );
+        }
+        requestAnimationFrame(() => {
+          document.querySelector(
+            `[data-testid="${s(r)}"]`
+          )?.scrollIntoView({ behavior: "smooth", block: "center" });
+        });
+        return;
+      }
+}
+export {
+  b as navigateToFirstFilterValidationError
+};

package/dist/form-engine/field-dependency-graph.d.ts

@@ -0,0 +1,17 @@
+import { FieldDependency, FieldVisibilityBase, FormValuesSnapshot } from './types';
+export declare function collectFieldDependencyIds(field: FieldVisibilityBase): string[];
+export declare function computeIsFieldVisible(field: FieldVisibilityBase, formValues: FormValuesSnapshot): boolean;
+export declare function computeIsFieldDisabled(field: FieldVisibilityBase, formValues: FormValuesSnapshot, options?: {
+    isCascadingDisabled?: (field: FieldVisibilityBase) => boolean;
+}): boolean;
+export declare function computeIsCascadingDisabled(field: FieldVisibilityBase, formValues: FormValuesSnapshot, isCascadingEnabled: boolean): boolean;
+export declare function getDependentFieldIds(allFields: FieldVisibilityBase[], changedFieldName: string): string[];
+export declare function buildCascadeParentFormState(cascadingDependency: FieldDependency[] | undefined, formValues: FormValuesSnapshot): Record<string, unknown> | null;
+export declare function collectFormWatchFieldIds(fields: FieldVisibilityBase[]): string[];
+/**
+ * @deprecated Use {@link collectFormWatchFieldIds}. Kept for backwards compatibility.
+ */
+export declare function collectFilterSidebarWatchFieldIds(fields: FieldVisibilityBase[]): string[];
+export declare function collectSectionWatchFieldIds(fields: FieldVisibilityBase[]): string[];
+export declare function hasVisibleFieldErrors(fields: FieldVisibilityBase[], formErrors: Record<string, unknown>, formValues: FormValuesSnapshot): boolean;
+export declare function collectVisibleFieldIds(fields: FieldVisibilityBase[], formValues: FormValuesSnapshot): string[];