impact-nova 2.6.0-alpha.0 → 2.6.0

package/dist/form-react/Fields/WeekRangePicker.js

@@ -1,17 +1,18 @@
 import { jsx as c } from "react/jsx-runtime";
-import { Controller as b } from "react-hook-form";
-import { WeekRangePicker as x } from "../../components/forms/date-picker/week-range-picker.js";
-import { toLocalDate as f } from "../utils/calendar-boundary.js";
-import { resolveWeekSelection as Y } from "../../lib/fiscal-calendar/week-selection.js";
-import { resolveWeekRangeMinMax as $ } from "../utils/date.utils.js";
-const S = (e, a) => Y(e, {
+import { Controller as T } from "react-hook-form";
+import { WeekRangePicker as b } from "../../components/forms/date-picker/week-range-picker.js";
+import { toLocalDate as M } from "../utils/calendar-boundary.js";
+import { resolveWeekSelection as x } from "../../lib/fiscal-calendar/week-selection.js";
+import { resolveWeekRangeMinMax as Y } from "../utils/date.utils.js";
+const S = (e, a) => x(e, {
   calendarKind: a.calendarKind,
   fiscalMode: a.fiscalMode ?? "basic",
   granularity: a.granularity,
   fiscalMonthPattern: a.fiscalMonthPattern,
   fiscalYearStartMonth: a.fiscalYearStartMonth ?? 1,
-  weekStartsOn: a.weekStartsOn ?? 1
-}), C = ({
+  weekStartsOn: a.weekStartsOn,
+  fiscalConfig: a.fiscalConfig
+}), B = ({
   field: e,
   validationRules: a,
   isDisabled: p,
@@ -19,26 +20,26 @@ const S = (e, a) => Y(e, {
 }) => {
   const t = e.fieldType === "week_range" ? e : null;
   if (!t) return null;
-  const { minDate: u, maxDate: m, startMonth: D, endMonth: k } = $(t), v = d.form.control;
+  const { minDate: u, maxDate: m, startMonth: D, endMonth: k } = Y(t), v = d.form.control;
   return /* @__PURE__ */ c(
-    b,
+    T,
     {
       name: e.id,
       control: v,
       rules: a,
       render: ({ field: w, fieldState: h }) => {
-        const g = !!h.error, r = w.value, s = r?.start ? f(r.start) ?? null : null, i = r?.end ? f(r.end) ?? null : null, F = !!(s && i);
+        const g = !!h.error, r = w.value, s = r?.start ? M(r.start) ?? null : null, i = r?.end ? M(r.end) ?? null : null, C = !!(s && i);
         return /* @__PURE__ */ c("div", { children: /* @__PURE__ */ c(
-          x,
+          b,
           {
             label: e.label,
-            value: F && s && i ? {
+            value: C && s && i ? {
               from: S(s, t),
               to: S(i, t)
             } : void 0,
             onChange: (o) => {
-              const M = o?.from ? { from: o.from, to: o.to ?? o.from } : void 0, n = M?.from?.startDate, l = M?.to?.endDate, P = n ? `${n.getFullYear()}-${String(n.getMonth() + 1).padStart(2, "0")}-${String(n.getDate()).padStart(2, "0")}` : null, T = l ? `${l.getFullYear()}-${String(l.getMonth() + 1).padStart(2, "0")}-${String(l.getDate()).padStart(2, "0")}` : null;
-              d.setValue(e.id, { start: P, end: T });
+              const f = o?.from ? { from: o.from, to: o.to ?? o.from } : void 0, n = f?.from?.startDate, l = f?.to?.endDate, F = n ? `${n.getFullYear()}-${String(n.getMonth() + 1).padStart(2, "0")}-${String(n.getDate()).padStart(2, "0")}` : null, P = l ? `${l.getFullYear()}-${String(l.getMonth() + 1).padStart(2, "0")}-${String(l.getDate()).padStart(2, "0")}` : null;
+              d.setValue(e.id, { start: F, end: P });
             },
             placeholder: t.placeholder,
             startMonth: u ?? D,
@@ -55,6 +56,7 @@ const S = (e, a) => Y(e, {
             granularity: t.granularity,
             fiscalMonthPattern: t.fiscalMonthPattern,
             fiscalYearStartMonth: t.fiscalYearStartMonth,
+            fiscalConfig: t.fiscalConfig,
             showFooter: t.showFooter,
             showPeriodBoundaries: t.showPeriodBoundaries,
             autoNavigateToAvailable: t.autoNavigateToAvailable,
@@ -66,5 +68,5 @@ const S = (e, a) => Y(e, {
   );
 };
 export {
-  C as WeekRangeField
+  B as WeekRangeField
 };

package/dist/form-react/Fields/YearPickerField.js

@@ -1,43 +1,43 @@
 import { jsx as o } from "react/jsx-runtime";
-import { Controller as m } from "react-hook-form";
-import { YearPicker as p } from "../../components/forms/date-picker/year-picker.js";
-import { getFieldTestId as M } from "../utils/fieldTestIds.js";
-import { toLocalDate as t } from "../utils/calendar-boundary.js";
-const x = ({
+import { Controller as f } from "react-hook-form";
+import { YearPicker as w } from "../../components/forms/date-picker/year-picker.js";
+import { getFieldTestId as v } from "../utils/fieldTestIds.js";
+import { resolveYearRangeMinMax as P } from "../utils/date.utils.js";
+const Y = ({
   field: r,
-  validationRules: d,
-  isDisabled: h,
-  formHelpers: a
+  validationRules: i,
+  isDisabled: c,
+  formHelpers: t
 }) => {
   const e = r.fieldType === "year_picker" ? r : null;
   if (!e) return null;
-  const c = a.form.control;
+  const { minDate: d, maxDate: u, startMonth: h, endMonth: m } = P(e), p = t.form.control;
   return /* @__PURE__ */ o(
-    m,
+    f,
     {
       name: r.id,
-      control: c,
+      control: p,
       defaultValue: e.defaultValue != null ? { year: e.defaultValue } : void 0,
-      rules: d,
-      render: ({ field: n, fieldState: l }) => {
-        const s = !!l.error, u = n.value;
-        return /* @__PURE__ */ o("div", { "data-testid": M(r.id), children: /* @__PURE__ */ o(
-          p,
+      rules: i,
+      render: ({ field: a, fieldState: n }) => {
+        const l = !!n.error, M = a.value;
+        return /* @__PURE__ */ o("div", { "data-testid": v(r.id), children: /* @__PURE__ */ o(
+          w,
           {
             label: r.label,
-            value: u ?? void 0,
-            onChange: (i) => {
-              n.onChange(i ?? null), a.setValue(r.id, i ?? null);
+            value: M ?? void 0,
+            onChange: (s) => {
+              a.onChange(s ?? null), t.setValue(r.id, s ?? null);
             },
             placeholder: r.placeholder,
-            minDate: t(e.minDate),
-            maxDate: t(e.maxDate),
-            startMonth: t(e.startMonth),
-            endMonth: t(e.endMonth),
+            minDate: d,
+            maxDate: u,
+            startMonth: h,
+            endMonth: m,
             required: r.isRequired,
-            disabled: h,
-            error: s,
-            helperText: s ? l.error?.message : r.helpText,
+            disabled: c,
+            error: l,
+            helperText: l ? n.error?.message : r.helpText,
             showFooter: e.showFooter,
             showIntervalCaption: e.showIntervalCaption,
             calendarKind: e.calendarKind,
@@ -54,5 +54,5 @@ const x = ({
   );
 };
 export {
-  x as YearPickerField
+  Y as YearPickerField
 };

package/dist/form-react/Fields/YearRangePickerField.js

@@ -1,43 +1,43 @@
-import { jsx as a } from "react/jsx-runtime";
-import { Controller as p } from "react-hook-form";
-import { YearRangePicker as g } from "../../components/forms/date-picker/year-range-picker.js";
-import { getFieldTestId as f } from "../utils/fieldTestIds.js";
-import { toLocalDate as t } from "../utils/calendar-boundary.js";
-const C = ({
+import { jsx as o } from "react/jsx-runtime";
+import { Controller as w } from "react-hook-form";
+import { YearRangePicker as v } from "../../components/forms/date-picker/year-range-picker.js";
+import { getFieldTestId as y } from "../utils/fieldTestIds.js";
+import { resolveYearRangeMinMax as R } from "../utils/date.utils.js";
+const k = ({
   field: r,
-  validationRules: d,
-  isDisabled: h,
-  formHelpers: o
+  validationRules: c,
+  isDisabled: d,
+  formHelpers: t
 }) => {
   const e = r.fieldType === "year_range" ? r : null;
   if (!e) return null;
-  const c = o.form.control, u = e.defaultRange ? { from: { year: e.defaultRange.start }, to: { year: e.defaultRange.end } } : void 0;
-  return /* @__PURE__ */ a(
-    p,
+  const { minDate: h, maxDate: u, startMonth: m, endMonth: p } = R(e), g = t.form.control, f = e.defaultRange ? { from: { year: e.defaultRange.start }, to: { year: e.defaultRange.end } } : void 0;
+  return /* @__PURE__ */ o(
+    w,
     {
       name: r.id,
-      control: c,
-      defaultValue: u,
-      rules: d,
-      render: ({ field: n, fieldState: l }) => {
-        const s = !!l.error, m = n.value;
-        return /* @__PURE__ */ a("div", { "data-testid": f(r.id), children: /* @__PURE__ */ a(
-          g,
+      control: g,
+      defaultValue: f,
+      rules: c,
+      render: ({ field: n, fieldState: s }) => {
+        const l = !!s.error, a = n.value, M = a && typeof a == "object" && !Array.isArray(a) && ("from" in a || "to" in a) ? a : void 0;
+        return /* @__PURE__ */ o("div", { "data-testid": y(r.id), children: /* @__PURE__ */ o(
+          v,
           {
             label: r.label,
-            value: m ?? void 0,
+            value: M,
             onChange: (i) => {
-              n.onChange(i ?? null), o.setValue(r.id, i ?? null);
+              n.onChange(i ?? null), t.setValue(r.id, i ?? null);
             },
             placeholder: r.placeholder,
-            minDate: t(e.minDate),
-            maxDate: t(e.maxDate),
-            startMonth: t(e.startMonth),
-            endMonth: t(e.endMonth),
+            minDate: h,
+            maxDate: u,
+            startMonth: m,
+            endMonth: p,
             required: r.isRequired,
-            disabled: h,
-            error: s,
-            helperText: s ? l.error?.message : r.helpText,
+            disabled: d,
+            error: l,
+            helperText: l ? s.error?.message : r.helpText,
             showFooter: e.showFooter,
             showIntervalCaption: e.showIntervalCaption,
             calendarKind: e.calendarKind,
@@ -54,5 +54,5 @@ const C = ({
   );
 };
 export {
-  C as YearRangePickerField
+  k as YearRangePickerField
 };

package/dist/form-react/fields.d.ts

@@ -23,3 +23,6 @@ export { MultiWeekPickerField } from './Fields/MultiWeekPickerField';
 export { TextFieldWithBackendValidation } from './Fields/TextFieldWithBackendValidation';
 export { SliderRangeField } from './Fields/SliderRangeField';
 export { RichTextField } from './Fields/RichTextField';
+export { YearPickerField } from './Fields/YearPickerField';
+export { MultiYearPickerField } from './Fields/MultiYearPickerField';
+export { YearRangePickerField } from './Fields/YearRangePickerField';

package/dist/form-react/fields.js

@@ -1,44 +1,50 @@
 import { TextField as r } from "./Fields/TextField.js";
-import { TextAreaField as i } from "./Fields/TextAreaField.js";
+import { TextAreaField as t } from "./Fields/TextAreaField.js";
 import { ButtonsGroupField as d } from "./Fields/ButtonsGroupField.js";
 import { RadioField as F } from "./Fields/RadioField.js";
 import { DateRangeField as m } from "./Fields/DateRangeField.js";
 import { WeekRangeField as a } from "./Fields/WeekRangePicker.js";
-import { MonthRangeField as c } from "./Fields/MonthRangeField.js";
-import { FileUploadField as k } from "./Fields/FileUploadField.js";
+import { MonthRangeField as n } from "./Fields/MonthRangeField.js";
+import { FileUploadField as h } from "./Fields/FileUploadField.js";
 import { SelectField as R } from "./Fields/SelectField.js";
-import { CheckboxField as B } from "./Fields/CheckboxField.js";
-import { SwitchField as T } from "./Fields/SwitchField.js";
-import { ChipsField as s } from "./Fields/ChipsField.js";
-import { DateInputField as P } from "./Fields/DateInputField.js";
+import { CheckboxField as g } from "./Fields/CheckboxField.js";
+import { SwitchField as B } from "./Fields/SwitchField.js";
+import { ChipsField as b } from "./Fields/ChipsField.js";
+import { DateInputField as C } from "./Fields/DateInputField.js";
 import { FillFormByPasteField as W } from "./Fields/FillFormByPasteField.js";
-import { FillFormByFileUploadField as D } from "./Fields/FillFormByFileUploadField.js";
-import { NumericComboboxField as w } from "./Fields/NumericComboboxField.js";
-import { MultiMonthPickerField as G } from "./Fields/MultiMonthPickerField.js";
-import { MultiWeekPickerField as N } from "./Fields/MultiWeekPickerField.js";
-import { TextFieldWithBackendValidation as j } from "./Fields/TextFieldWithBackendValidation.js";
-import { SliderRangeField as v } from "./Fields/SliderRangeField.js";
-import { RichTextField as E } from "./Fields/RichTextField.js";
+import { FillFormByFileUploadField as y } from "./Fields/FillFormByFileUploadField.js";
+import { NumericComboboxField as U } from "./Fields/NumericComboboxField.js";
+import { MultiMonthPickerField as A } from "./Fields/MultiMonthPickerField.js";
+import { MultiWeekPickerField as I } from "./Fields/MultiWeekPickerField.js";
+import { TextFieldWithBackendValidation as V } from "./Fields/TextFieldWithBackendValidation.js";
+import { SliderRangeField as q } from "./Fields/SliderRangeField.js";
+import { RichTextField as z } from "./Fields/RichTextField.js";
+import { YearPickerField as H } from "./Fields/YearPickerField.js";
+import { MultiYearPickerField as K } from "./Fields/MultiYearPickerField.js";
+import { YearRangePickerField as O } from "./Fields/YearRangePickerField.js";
 export {
   d as ButtonsGroupField,
-  B as CheckboxField,
-  s as ChipsField,
-  P as DateInputField,
+  g as CheckboxField,
+  b as ChipsField,
+  C as DateInputField,
   m as DateRangeField,
-  k as FileUploadField,
-  D as FillFormByFileUploadField,
+  h as FileUploadField,
+  y as FillFormByFileUploadField,
   W as FillFormByPasteField,
-  c as MonthRangeField,
-  G as MultiMonthPickerField,
-  N as MultiWeekPickerField,
-  w as NumericComboboxField,
+  n as MonthRangeField,
+  A as MultiMonthPickerField,
+  I as MultiWeekPickerField,
+  K as MultiYearPickerField,
+  U as NumericComboboxField,
   F as RadioField,
-  E as RichTextField,
+  z as RichTextField,
   R as SelectField,
-  v as SliderRangeField,
-  T as SwitchField,
-  i as TextAreaField,
+  q as SliderRangeField,
+  B as SwitchField,
+  t as TextAreaField,
   r as TextField,
-  j as TextFieldWithBackendValidation,
-  a as WeekRangeField
+  V as TextFieldWithBackendValidation,
+  a as WeekRangeField,
+  H as YearPickerField,
+  O as YearRangePickerField
 };

package/dist/form-react/types/fields.types.d.ts

@@ -1,6 +1,7 @@
 import { Option } from '../../components/forms/select';
 import { HTMLInputTypeAttribute } from 'react';
 import { FieldOutputValue } from './fieldsOutput.types';
+import { FiscalCalendarConfig } from '../../lib/fiscal-calendar';
 export type ValidationRule = {
     /** Regex pattern string to test against */
     regex?: string;
@@ -219,6 +220,8 @@ export type WeekRangeField = BaseField & {
     granularity?: "day" | "week" | "period" | "quarter" | "year";
     fiscalMonthPattern?: number[];
     fiscalYearStartMonth?: number;
+    /** Canonical retail/NRF config. Wins over fiscalYearStartMonth and fiscalMonthPattern. */
+    fiscalConfig?: FiscalCalendarConfig;
     showFooter?: boolean;
     /** Draw `(` / `)` on fiscal period start/end days. Default false. */
     showPeriodBoundaries?: boolean;
@@ -235,12 +238,25 @@ export type MultiWeekRangeField = BaseField & {
     fieldType: "multi_week_picker";
     minDate?: string;
     maxDate?: string;
+    /** Minimum selectable start date = today + N days (0 = today, blocks past dates). */
+    minStartOffsetDays?: number;
+    /** When true, blocks weeks before the current week (minDate = current week start). */
+    disablePastWeeks?: boolean;
+    /** First month shown in the picker navigation (ISO date string). */
+    startMonth?: string;
+    /** Last month shown in the picker navigation (ISO date string). */
+    endMonth?: string;
+    /** Earliest week: week start of the week N weeks before the current week (0 = current week). */
+    minWeeksOffset?: number;
+    /** Latest week: week end of the week N weeks after the current week. */
+    maxWeeksOffset?: number;
     calendarKind?: "gregorian" | "fiscal";
     fiscalMode?: "basic" | "advanced" | "custom";
     weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
     granularity?: "day" | "week" | "period" | "quarter" | "year";
     fiscalMonthPattern?: number[];
     fiscalYearStartMonth?: number;
+    fiscalConfig?: FiscalCalendarConfig;
     showPeriodBoundaries?: boolean;
     /** When true, open on the first enabled week. Navigate only. */
     autoNavigateToAvailable?: boolean;
@@ -281,6 +297,12 @@ export type MultiMonthPickerField = BaseField & {
     maxDate?: string;
     startMonth?: string;
     endMonth?: string;
+    /** Number of months before the current month to set as the minimum selectable month */
+    minMonthsOffset?: number;
+    /** Number of months after the current month to set as the maximum selectable month */
+    maxMonthsOffset?: number;
+    /** When true, blocks months before the current month. */
+    disablePastMonths?: boolean;
     /** When true, open on the first enabled month. Navigate only. */
     autoNavigateToAvailable?: boolean;
 };
@@ -289,6 +311,10 @@ export type YearPickerField = BaseField & {
     defaultValue?: number;
     minDate?: string;
     maxDate?: string;
+    /** Earliest year: year start of the year N years before today (0 = current year). Takes precedence over `minDate`. */
+    minYearsOffset?: number;
+    /** Latest year: year end of the year N years after today (0 = current year). Takes precedence over `maxDate`. */
+    maxYearsOffset?: number;
     startMonth?: string;
     endMonth?: string;
     showFooter?: boolean;
@@ -307,6 +333,10 @@ export type MultiYearPickerField = BaseField & {
     defaultValue?: number[];
     minDate?: string;
     maxDate?: string;
+    /** Earliest year: year start of the year N years before today (0 = current year). Takes precedence over `minDate`. */
+    minYearsOffset?: number;
+    /** Latest year: year end of the year N years after today (0 = current year). Takes precedence over `maxDate`. */
+    maxYearsOffset?: number;
     startMonth?: string;
     endMonth?: string;
     showFooter?: boolean;
@@ -328,6 +358,10 @@ export type YearRangePickerField = BaseField & {
     };
     minDate?: string;
     maxDate?: string;
+    /** Earliest year: year start of the year N years before today (0 = current year). Takes precedence over `minDate`. */
+    minYearsOffset?: number;
+    /** Latest year: year end of the year N years after today (0 = current year). Takes precedence over `maxDate`. */
+    maxYearsOffset?: number;
     startMonth?: string;
     endMonth?: string;
     showFooter?: boolean;
@@ -432,6 +466,11 @@ export type CheckboxField = BaseField & {
 };
 export type TextFieldWithBackendValidation = BaseField & {
     fieldType: "text_with_backend_validation";
+    /**
+     * When false (default), only letters, numbers, and spaces are kept.
+     * Set true to allow punctuation and symbols (same behavior as `text`).
+     */
+    allowSpecialCharacters?: boolean;
     /** Legacy built-in path — optional when field.handlerName is set */
     validationConfig?: {
         method?: "GET" | "POST";

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

@@ -1,4 +1,4 @@
-import { DateRangeField, WeekRangeField } from '../types/fields.types';
+import { DateRangeField, MonthRangeField, MultiMonthPickerField, WeekRangeField, YearRangePickerField } 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.
@@ -19,15 +19,65 @@ export declare function handleDateFnsFormat(configFormat?: string): string;
 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;
-type WeekRangeBoundsField = Pick<WeekRangeField, "minDate" | "maxDate" | "minStartOffsetDays" | "disablePastWeeks" | "minWeeksOffset" | "maxWeeksOffset" | "startMonth" | "endMonth" | "calendarKind" | "fiscalMode" | "granularity" | "fiscalMonthPattern" | "fiscalYearStartMonth" | "weekStartsOn">;
+export declare function addYearsDate(d: Date, n: number): Date;
+type DateRangeBoundsField = Pick<DateRangeField, "minDate" | "maxDate" | "minStartOffsetDays" | "startMonth" | "endMonth">;
+type WeekRangeBoundsField = {
+    minDate?: string;
+    maxDate?: string;
+    minStartOffsetDays?: number;
+    disablePastWeeks?: boolean;
+    minWeeksOffset?: number;
+    maxWeeksOffset?: number;
+    startMonth?: string;
+    endMonth?: string;
+    calendarKind?: WeekRangeField["calendarKind"];
+    fiscalMode?: WeekRangeField["fiscalMode"];
+    granularity?: WeekRangeField["granularity"];
+    fiscalMonthPattern?: WeekRangeField["fiscalMonthPattern"];
+    fiscalYearStartMonth?: WeekRangeField["fiscalYearStartMonth"];
+    weekStartsOn?: WeekRangeField["weekStartsOn"];
+    fiscalConfig?: WeekRangeField["fiscalConfig"];
+};
 export declare const handleMinMaxProp: (dateRangeField: DateRangeField) => {
     minDate: Date | undefined;
     maxDate: Date | undefined;
 };
+export declare const resolveDateRangeMinMax: (dateRangeField: DateRangeBoundsField) => {
+    minDate: Date | undefined;
+    maxDate: Date | undefined;
+    startMonth: Date | undefined;
+    endMonth: Date | undefined;
+};
 export declare const resolveWeekRangeMinMax: (weekRangeField: WeekRangeBoundsField) => {
     minDate: Date | undefined;
     maxDate: Date | undefined;
     startMonth: Date | undefined;
     endMonth: Date | undefined;
 };
+type MonthRangeBoundsField = Pick<MonthRangeField | MultiMonthPickerField, "minDate" | "maxDate" | "startMonth" | "endMonth" | "minMonthsOffset" | "maxMonthsOffset" | "disablePastMonths">;
+export declare const resolveMonthRangeMinMax: (monthRangeField: MonthRangeBoundsField) => {
+    minDate: Date | undefined;
+    maxDate: Date | undefined;
+    startMonth: Date | undefined;
+    endMonth: Date | undefined;
+};
+type YearRangeBoundsField = Pick<YearRangePickerField, "minDate" | "maxDate" | "minYearsOffset" | "maxYearsOffset" | "startMonth" | "endMonth" | "calendarKind" | "fiscalMode" | "fiscalMonthPattern" | "fiscalYearStartMonth" | "weekStartsOn">;
+/**
+ * Resolves selectable year bounds. `minYearsOffset` / `maxYearsOffset` win over
+ * static `minDate` / `maxDate` so existing hardcoded configs keep working when
+ * offsets are omitted.
+ */
+export declare const resolveYearRangeMinMax: (yearRangeField: YearRangeBoundsField) => {
+    minDate: Date | undefined;
+    maxDate: Date | undefined;
+    startMonth: Date | undefined;
+    endMonth: Date | undefined;
+};
+/** Quarter pickers navigate by year — reuse year-bound resolution for min/max/month caps. */
+export declare const resolveQuarterRangeMinMax: (yearRangeField: YearRangeBoundsField) => {
+    minDate: Date | undefined;
+    maxDate: Date | undefined;
+    startMonth: Date | undefined;
+    endMonth: Date | undefined;
+};
 export {};