impact-nova 2.3.0 → 2.4.0

package/dist/form-react/utils/batchFormFieldUpdates.js

@@ -0,0 +1,13 @@
+function d(a, e, t) {
+  if (e.length === 0)
+    return;
+  const o = t?.shouldDirty ?? !0, u = t?.shouldValidate ?? !1;
+  for (const l of e)
+    a.setValue(l.fieldName, l.value, {
+      shouldDirty: o,
+      shouldValidate: u
+    });
+}
+export {
+  d as batchSetFormFieldValues
+};

package/dist/form-react/utils/buildFieldValidationRules.d.ts

@@ -0,0 +1,6 @@
+import { EvaluateFieldValidationOptions, FieldValidationShape } from './evaluateFieldValidation';
+export type { FieldValidationShape } from './evaluateFieldValidation';
+export type { EvaluateFieldValidationOptions } from './evaluateFieldValidation';
+export { buildRangeIncompleteMessage, isRangeIncompleteValidationMessage, } from './fieldRangeValidation.utils';
+export declare function isFieldValueValid(field: FieldValidationShape, value: unknown, options?: EvaluateFieldValidationOptions): boolean;
+export declare function buildFieldValidationRules(field: FieldValidationShape, options?: EvaluateFieldValidationOptions): Record<string, unknown>;

package/dist/form-react/utils/buildFieldValidationRules.js

@@ -0,0 +1,13 @@
+import { fieldNeedsValidationRules as a, evaluateFieldValidation as t } from "./evaluateFieldValidation.js";
+function n(i, e, l) {
+  return t(i, e, l) === null;
+}
+function d(i, e) {
+  return a(i) ? {
+    validate: (l) => t(i, l, e) ?? !0
+  } : {};
+}
+export {
+  d as buildFieldValidationRules,
+  n as isFieldValueValid
+};

package/dist/form-react/utils/buildSelectRemountKey.d.ts

@@ -0,0 +1,14 @@
+interface BuildSelectRemountKeyOptions {
+    fieldId: string;
+    isMultiSelect: boolean;
+    hasSelectValue: boolean;
+    parentCascadeKey: string;
+    isDisabled: boolean;
+}
+/**
+ * impact-nova Select keeps internal open/focus UI when form values are cleared
+ * externally (cascade). Remounting on value, parent, or disabled changes resets it.
+ */
+export declare function buildSelectRemountKey(options: BuildSelectRemountKeyOptions): string;
+export declare function buildParentCascadeKey(parentFieldIds: string[], watchedParentValues: unknown): string;
+export {};

package/dist/form-react/utils/buildSelectRemountKey.js

@@ -0,0 +1,14 @@
+function t(e) {
+  const a = e.isDisabled ? "disabled" : "enabled";
+  if (e.isMultiSelect)
+    return `${e.fieldId}-${e.parentCascadeKey}-${a}`;
+  const l = e.hasSelectValue ? "has-value" : "empty";
+  return `${e.fieldId}-${l}-${e.parentCascadeKey}-${a}`;
+}
+function d(e, a) {
+  return e.length === 0 ? "root" : JSON.stringify(a ?? null);
+}
+export {
+  d as buildParentCascadeKey,
+  t as buildSelectRemountKey
+};

package/dist/form-react/utils/calendar-boundary.d.ts

@@ -0,0 +1,3 @@
+export declare function formatYmd(d: Date): string;
+export declare function parseYmdString(s: string): Date | undefined;
+export declare function toLocalDate(val: unknown): Date | undefined;

package/dist/form-react/utils/calendar-boundary.js

@@ -0,0 +1,33 @@
+import { startOfDayDate as c } from "./date.utils.js";
+function p(t) {
+  return `${t.getFullYear()}-${String(t.getMonth() + 1).padStart(2, "0")}-${String(t.getDate()).padStart(2, "0")}`;
+}
+function d(t) {
+  const r = t.trim().split("-");
+  if (r.length !== 3) return;
+  const e = Number(r[0]), i = Number(r[1]), n = Number(r[2]);
+  if (!Number.isFinite(e) || !Number.isFinite(i) || !Number.isFinite(n))
+    return;
+  const s = new Date(e, i - 1, n);
+  if (!Number.isNaN(s.getTime()))
+    return c(s);
+}
+function N(t) {
+  if (!t) return;
+  if (t instanceof Date) return t;
+  if (typeof t != "string") return;
+  const r = t.trim();
+  if (r === "") return;
+  if (r.includes("/")) {
+    const [m, a] = r.split("/"), o = parseInt(m, 10), u = parseInt(a, 10);
+    return !Number.isFinite(o) || !Number.isFinite(u) ? void 0 : new Date(u, o - 1, 1);
+  }
+  const e = r.split("-"), i = parseInt(e[0], 10), n = parseInt(e[1], 10), s = e[2] ? parseInt(e[2], 10) : 1;
+  if (!(!Number.isFinite(i) || !Number.isFinite(n) || !Number.isFinite(s)))
+    return new Date(i, n - 1, s);
+}
+export {
+  p as formatYmd,
+  d as parseYmdString,
+  N as toLocalDate
+};

package/dist/form-react/utils/date.utils.d.ts

@@ -0,0 +1,31 @@
+import { DateRangeField, WeekRangeField } from '../types/fields.types';
+export declare const DEFAULT_PICKER_DATE_FORMAT = "yyyy-MM-dd";
+/**
+ * Makes a remote-config date format safe for the date-fns based pickers.
+ *
+ * 1. Normalizes moment-style tokens to date-fns tokens (DD → dd, YYYY → yyyy).
+ *    `M` is left untouched — lowercase `m` means minutes in date-fns. Already
+ *    valid date-fns strings pass through unchanged.
+ * 2. date-fns throws a RangeError on invalid/unsupported tokens instead of
+ *    failing gracefully, so probe the format once and fall back to
+ *    DEFAULT_PICKER_DATE_FORMAT when it throws — a bad config value can then
+ *    never crash the picker at render time.
+ */
+export declare function handleDateFnsFormat(configFormat?: string): string;
+/**
+ * Formats a Date for user-facing copy (e.g. `{minDate}` in validation messages)
+ * using the field's configured `dateFormat`, falling back to `YYYY-MM-DD`.
+ */
+export declare function formatDateByConfigFormat(d: Date, df?: string): string;
+export declare function startOfDayDate(d: Date): Date;
+export declare function addDaysDate(d: Date, n: number): Date;
+export declare const handleMinMaxProp: (dateRangeField: DateRangeField) => {
+    minDate: Date | undefined;
+    maxDate: Date | undefined;
+};
+export declare const resolveWeekRangeMinMax: (weekRangeField: Pick<WeekRangeField, "minDate" | "maxDate" | "minStartOffsetDays" | "disablePastWeeks" | "minWeeksOffset" | "maxWeeksOffset" | "startMonth" | "endMonth">) => {
+    minDate: Date | undefined;
+    maxDate: Date | undefined;
+    startMonth: Date | undefined;
+    endMonth: Date | undefined;
+};

package/dist/form-react/utils/date.utils.js

@@ -0,0 +1,86 @@
+import { format as M } from "date-fns";
+import { toLocalDate as o } from "./calendar-boundary.js";
+const e = "yyyy-MM-dd", c = /* @__PURE__ */ new Map();
+function y(t) {
+  const s = t?.trim();
+  if (!s) return e;
+  const n = s.replace(/D/g, "d").replace(/Y/g, "y");
+  let a = c.get(n);
+  if (a === void 0) {
+    try {
+      M(/* @__PURE__ */ new Date(), n), a = !0;
+    } catch {
+      a = !1;
+    }
+    c.set(n, a);
+  }
+  return a ? n : e;
+}
+function r(t) {
+  const s = new Date(t);
+  return s.setHours(0, 0, 0, 0), s;
+}
+function D(t, s) {
+  const n = new Date(t);
+  return n.setDate(n.getDate() + s), n;
+}
+const O = (t) => {
+  let s, n;
+  if (t.minStartOffsetDays != null && t.minStartOffsetDays >= 0)
+    s = r(
+      D(/* @__PURE__ */ new Date(), t.minStartOffsetDays)
+    );
+  else if (t.minDate) {
+    const a = o(t.minDate);
+    a && (s = r(a));
+  }
+  if (t.maxDate) {
+    const a = o(t.maxDate);
+    a && (n = r(a));
+  }
+  return { minDate: s, maxDate: n };
+}, p = (t) => {
+  let s, n;
+  const a = /* @__PURE__ */ new Date();
+  if (t.minWeeksOffset != null)
+    s = r(
+      D(a, -t.minWeeksOffset * 7)
+    );
+  else if (t.minStartOffsetDays != null && t.minStartOffsetDays >= 0)
+    s = r(
+      D(a, t.minStartOffsetDays)
+    );
+  else if (t.disablePastWeeks)
+    s = r(a);
+  else if (t.minDate) {
+    const f = o(t.minDate);
+    f && (s = r(f));
+  }
+  if (t.maxWeeksOffset != null)
+    n = r(
+      D(a, t.maxWeeksOffset * 7)
+    );
+  else if (t.maxDate) {
+    const f = o(t.maxDate);
+    f && (n = r(f));
+  }
+  let m;
+  if (t.startMonth) {
+    const f = o(t.startMonth);
+    f && (m = r(f));
+  }
+  let i;
+  if (t.endMonth) {
+    const f = o(t.endMonth);
+    f && (i = r(f));
+  }
+  return { minDate: s, maxDate: n, startMonth: m, endMonth: i };
+};
+export {
+  e as DEFAULT_PICKER_DATE_FORMAT,
+  D as addDaysDate,
+  y as handleDateFnsFormat,
+  O as handleMinMaxProp,
+  p as resolveWeekRangeMinMax,
+  r as startOfDayDate
+};

package/dist/form-react/utils/evaluateFieldValidation.d.ts

@@ -0,0 +1,19 @@
+import { ValidationRule } from '../types/fields.types';
+import { FormContextFieldChangeParams, FormContextValidator } from '../types/reactHookForm.types';
+import { UseReactHookFormReturn } from '../hooks/useReactHookForm';
+export interface FieldValidationShape {
+    id: string;
+    label?: string;
+    fieldType: string;
+    isRequired?: boolean;
+    validation?: ValidationRule[];
+}
+export interface EvaluateFieldValidationOptions {
+    fieldId?: string;
+    formHelpers?: FormContextFieldChangeParams['formHelpers'];
+    contextValidators?: Record<string, FormContextValidator>;
+    getPreviousFieldValue?: (fieldId: string) => unknown;
+}
+export declare function buildEvaluateFieldValidationOptions(formHelpers: Pick<UseReactHookFormReturn, 'getPreviousFieldValue' | 'formContext'>, fieldId: string): EvaluateFieldValidationOptions;
+export declare function evaluateFieldValidation(field: FieldValidationShape, value: unknown, options?: EvaluateFieldValidationOptions): string | null;
+export declare function fieldNeedsValidationRules(field: FieldValidationShape): boolean;

package/dist/form-react/utils/evaluateFieldValidation.js

@@ -0,0 +1,53 @@
+import { isEmptyValue as n } from "../../form-engine/is-empty-value.js";
+import { runFieldValidation as d } from "./validationUtils.js";
+import { isRangeValueComplete as c, buildRangeIncompleteMessage as m } from "./fieldRangeValidation.utils.js";
+function p(e, i) {
+  return {
+    fieldId: i,
+    formHelpers: e,
+    getPreviousFieldValue: (r) => e.getPreviousFieldValue(r),
+    contextValidators: e.formContext?.validators
+  };
+}
+const o = /* @__PURE__ */ new Set([
+  "date_range",
+  "week_range",
+  "month_range"
+]), f = /* @__PURE__ */ new Set([
+  "select",
+  "chips",
+  "multi_month_picker",
+  "multi_week_picker"
+]);
+function l(e) {
+  return `${e.label || "This field"} is required`;
+}
+function h(e, i) {
+  return !e.isRequired && n(i);
+}
+function t(e, i, r) {
+  if (!e.validation?.length || o.has(e.fieldType) || h(e, i))
+    return null;
+  const u = r?.fieldId ?? e.id, s = {
+    fieldId: u,
+    newValue: i,
+    oldValue: r?.getPreviousFieldValue?.(u),
+    formHelpers: r?.formHelpers
+  }, a = d(
+    e.validation,
+    s,
+    r?.contextValidators ?? r?.formHelpers?.formContext?.validators
+  );
+  return a === !0 ? null : a;
+}
+function T(e, i, r) {
+  return e.fieldType === "switch" ? e.isRequired && i !== !0 ? `${e.label || "This field"} must be enabled` : null : e.fieldType === "checkbox" ? e.isRequired && i !== !0 ? `${e.label || "This field"} must be checked` : null : e.isRequired && o.has(e.fieldType) ? c(i) ? t(e, i, r) : m(e.fieldType) : e.isRequired && f.has(e.fieldType) ? n(i) ? l(e) : t(e, i, r) : e.isRequired && n(i) ? l(e) : t(e, i, r);
+}
+function _(e) {
+  return !!e.isRequired || !!e.validation?.length;
+}
+export {
+  p as buildEvaluateFieldValidationOptions,
+  T as evaluateFieldValidation,
+  _ as fieldNeedsValidationRules
+};

package/dist/form-react/utils/fieldDefaults.utils.d.ts

@@ -0,0 +1,6 @@
+import { IField } from '../types/fields.types';
+/**
+ * Pure mapping: IField config → default value for react-hook-form.
+ * No React hooks — call freely from any context.
+ */
+export declare function getFieldDefaultValue(field: IField): unknown;

package/dist/form-react/utils/fieldDefaults.utils.js

@@ -0,0 +1,25 @@
+function u(e) {
+  if (e.fieldType === "object") {
+    const a = {};
+    return e.fields.forEach((t) => {
+      a[t.id] = u(t);
+    }), a;
+  }
+  if (e.fieldType === "array") {
+    const a = e.defaultItemValue ?? {}, t = e.minItems ?? 0;
+    return t > 0 ? Array.from({ length: t }, () => ({ ...a })) : [];
+  }
+  return e.fieldType === "button_group" && e.defaultSelectedValue || e.fieldType === "radio" && e.defaultSelectedValue ? e.defaultSelectedValue || null : e.fieldType === "date_range" && e.defaultRange ? {
+    start: e.defaultRange.start || null,
+    end: e.defaultRange.end || null
+  } : e.fieldType === "month_range" && e.defaultRange ? {
+    start: e.defaultRange.start || null,
+    end: e.defaultRange.end || null
+  } : e.fieldType === "switch" || e.fieldType === "checkbox" ? e.defaultSelectedValue ?? !1 : e.fieldType === "text" || e.fieldType === "text_area" || e.fieldType === "numeric_combobox" ? e.defaultValue ?? "" : e.fieldType === "date" ? "" : e.fieldType === "select" ? [] : e.fieldType === "week_range" && e.defaultRange ? {
+    start: e.defaultRange.start || null,
+    end: e.defaultRange.end || null
+  } : null;
+}
+export {
+  u as getFieldDefaultValue
+};

package/dist/form-react/utils/fieldPath.utils.d.ts

@@ -0,0 +1,23 @@
+import { IField } from '../types/fields.types';
+/**
+ * Builds a dot-separated RHF field path by joining a field's own `id`
+ * with the accumulated parent prefix.
+ *
+ * Examples:
+ *  - `buildFieldPath("city")` → `"city"`
+ *  - `buildFieldPath("city", "address")` → `"address.city"`
+ *  - `buildFieldPath("city", "contacts.0.address")` → `"contacts.0.address.city"`
+ */
+export declare function buildFieldPath(fieldId: string, prefix?: string): string;
+/**
+ * Recursively flattens nested `IField[]` into a list of full dot-paths.
+ *
+ * - ObjectField children are expanded with their parent path as prefix.
+ * - ArrayField is treated as an atomic value (submitted as a whole array).
+ * - Leaf fields produce a single path entry.
+ */
+export declare function flattenFieldIds(fields: IField[], prefix?: string): string[];
+/**
+ * Finds a field config by its full RHF path (supports nested object fields).
+ */
+export declare function findFieldByPath(fields: IField[], fieldPath: string, prefix?: string): IField | undefined;

package/dist/form-react/utils/fieldPath.utils.js

@@ -0,0 +1,26 @@
+function o(n, e) {
+  return e ? `${e}.${n}` : n;
+}
+function u(n, e) {
+  return n.flatMap((r) => {
+    const t = o(r.id, e);
+    return r.fieldType === "object" ? u(r.fields, t) : r.fieldType === "array" ? [t] : [t];
+  });
+}
+function d(n, e, r) {
+  for (const t of n) {
+    const i = o(t.id, r);
+    if (i === e)
+      return t;
+    if (t.fieldType === "object") {
+      const f = d(t.fields, e, i);
+      if (f)
+        return f;
+    }
+  }
+}
+export {
+  o as buildFieldPath,
+  d as findFieldByPath,
+  u as flattenFieldIds
+};

package/dist/form-react/utils/fieldRangeValidation.utils.d.ts

@@ -0,0 +1,3 @@
+export declare function isRangeValueComplete(value: unknown): boolean;
+export declare function buildRangeIncompleteMessage(fieldType: string): string;
+export declare function isRangeIncompleteValidationMessage(message: string): boolean;

package/dist/form-react/utils/fieldRangeValidation.utils.js

@@ -0,0 +1,24 @@
+function a(e) {
+  if (!e || typeof e != "object" || Array.isArray(e))
+    return !1;
+  const t = e, n = t.start != null && String(t.start).trim() !== "", r = t.end != null && String(t.end).trim() !== "";
+  return n && r;
+}
+function d(e) {
+  switch (e) {
+    case "month_range":
+      return "Start and end months required";
+    case "week_range":
+      return "Start and end weeks required";
+    default:
+      return "Start and end dates required";
+  }
+}
+function i(e) {
+  return e.includes("requires both from and to") || e === "Start and end months required" || e === "Start and end weeks required" || e === "Start and end dates required";
+}
+export {
+  d as buildRangeIncompleteMessage,
+  i as isRangeIncompleteValidationMessage,
+  a as isRangeValueComplete
+};

package/dist/form-react/utils/fieldRendererUtils.d.ts

@@ -0,0 +1,10 @@
+/** Lookup tables for `IFormConfig` numeric layout → full Tailwind utilities (JIT-safe). */
+export declare const GAP_MAP: Record<number, string>;
+/** Horizontal gap — honours the configured value exactly. */
+export declare const GAP_X_MAP: Record<number, string>;
+/** Vertical gap — floors at 4 (16px) so error / helper text never overlaps the next row. */
+export declare const GAP_Y_MAP: Record<number, string>;
+export declare const COL_SPAN_MAP: Record<number, string>;
+export declare const GRID_COLS_MAP: Record<number, string>;
+/** Full grid class string for `ReactHooksForm` (Tailwind JIT requires fixed map keys). */
+export declare function buildFormGridClassName(columns?: number, gapBetweenFields?: number): string;

package/dist/form-react/utils/fieldRendererUtils.js

@@ -0,0 +1,47 @@
+const g = {
+  0: "gap-x-0",
+  1: "gap-x-1",
+  2: "gap-x-2",
+  3: "gap-x-3",
+  4: "gap-x-4",
+  5: "gap-x-5",
+  6: "gap-x-6",
+  7: "gap-x-7",
+  8: "gap-x-8",
+  9: "gap-x-9",
+  10: "gap-x-10",
+  11: "gap-x-11",
+  12: "gap-x-12"
+}, p = {
+  0: "gap-y-4",
+  1: "gap-y-4",
+  2: "gap-y-4",
+  3: "gap-y-4",
+  4: "gap-y-4",
+  5: "gap-y-5",
+  6: "gap-y-6",
+  7: "gap-y-7",
+  8: "gap-y-8",
+  9: "gap-y-9",
+  10: "gap-y-10",
+  11: "gap-y-11",
+  12: "gap-y-12"
+}, a = {
+  1: "grid-cols-1",
+  2: "grid-cols-2",
+  3: "grid-cols-3",
+  4: "grid-cols-4",
+  5: "grid-cols-5",
+  6: "grid-cols-6",
+  7: "grid-cols-7",
+  8: "grid-cols-8",
+  9: "grid-cols-9",
+  10: "grid-cols-10",
+  11: "grid-cols-11",
+  12: "grid-cols-12"
+};
+export {
+  g as GAP_X_MAP,
+  p as GAP_Y_MAP,
+  a as GRID_COLS_MAP
+};

package/dist/form-react/utils/fieldTestIds.d.ts

@@ -0,0 +1,3 @@
+/** Stable test id helper for form fields (framework-internal). */
+export declare function getFieldTestId(fieldId: string): string;
+export declare function getTestId(component: string, identifier?: string): string;

package/dist/form-react/utils/fieldTestIds.js

@@ -0,0 +1,13 @@
+function t(e) {
+  return `field-${e.replace(/_/g, "-")}`;
+}
+function n(e, r) {
+  if (!r)
+    return e;
+  const d = r.replace(/_/g, "-");
+  return `${e}-${d}`;
+}
+export {
+  t as getFieldTestId,
+  n as getTestId
+};

package/dist/form-react/utils/formDate.utils.d.ts

@@ -0,0 +1,13 @@
+import { DateInputField } from '../types/fields.types';
+export { formatYmd, parseYmdString, toLocalDate, } from './calendar-boundary';
+export declare const DATE_FIELD_VALIDATION_FALLBACK = "Validation failed";
+/**
+ * Remote UI definitions often ship `beforeMinimum` copy without `minOffsetDaysFromToday`.
+ * When that template is present and the field is not paired after another date and has no
+ * static `minDate`, default offset `0` so the calendar and validation match ("not before today").
+ */
+export declare function getEffectiveMinOffsetDaysFromToday(field: DateInputField): number | undefined;
+export declare function applyDateRangeMessageTemplate(template: string | undefined, vars: {
+    minDate: string;
+    offset: number;
+}): string;

package/dist/form-react/utils/formDate.utils.js

@@ -0,0 +1,9 @@
+function e(t) {
+  if (t.minOffsetDaysFromToday != null) return t.minOffsetDaysFromToday;
+  if (t.pastDateNotAllowed) return 0;
+  if (!(t.dateAfterFieldId || t.minDate || !t.dateValidationMessages?.beforeMinimum?.trim()))
+    return 0;
+}
+export {
+  e as getEffectiveMinOffsetDaysFromToday
+};

package/dist/form-react/utils/formValidationFeedback.utils.d.ts

@@ -0,0 +1,32 @@
+import { IField } from '../types/fields.types';
+export interface FormValidationToastMessage {
+    title: string;
+    description: string;
+}
+export interface BuildFormValidationToastMessageOptions {
+    /** Phrase appended to single-field guidance, e.g. "apply filters" or "continue". */
+    actionSuffix?: string;
+    /** Noun used in aggregate titles, e.g. "filter" or "field". */
+    entityNoun?: string;
+}
+type FormFieldShape = Pick<IField, 'id' | 'label' | 'fieldType'>;
+export declare function buildFormValidationToastMessage(fieldErrors: Record<string, {
+    message?: string;
+} | undefined>, allFields: FormFieldShape[], options?: BuildFormValidationToastMessageOptions): FormValidationToastMessage;
+export declare function focusFirstFormValidationError(options: {
+    fieldErrors: Record<string, {
+        message?: string;
+    } | undefined>;
+    fieldsInOrder: FormFieldShape[];
+    getFieldTestId?: (fieldId: string) => string;
+}): string | null;
+export declare function showFormValidationFailureFeedback(options: {
+    fieldErrors: Record<string, {
+        message?: string;
+    } | undefined>;
+    fieldsInOrder: FormFieldShape[];
+    showToast: (message: FormValidationToastMessage) => void;
+    toastMessageOptions?: BuildFormValidationToastMessageOptions;
+    getFieldTestId?: (fieldId: string) => string;
+}): void;
+export {};