impact-nova 2.5.12 → 2.5.14

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

@@ -0,0 +1,57 @@
+import { jsx as o } 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 = ({
+  field: r,
+  validationRules: d,
+  isDisabled: h,
+  formHelpers: a
+}) => {
+  const e = r.fieldType === "year_range" ? r : null;
+  if (!e) return null;
+  const c = a.form.control, u = e.defaultRange ? { from: { year: e.defaultRange.start }, to: { year: e.defaultRange.end } } : void 0;
+  return /* @__PURE__ */ o(
+    p,
+    {
+      name: r.id,
+      control: c,
+      defaultValue: u,
+      rules: d,
+      render: ({ field: n, fieldState: l }) => {
+        const s = !!l.error, m = n.value;
+        return /* @__PURE__ */ o("div", { "data-testid": f(r.id), children: /* @__PURE__ */ o(
+          g,
+          {
+            label: r.label,
+            value: m ?? void 0,
+            onChange: (i) => {
+              n.onChange(i ?? null), a.setValue(r.id, i ?? null);
+            },
+            placeholder: r.placeholder,
+            minDate: t(e.minDate),
+            maxDate: t(e.maxDate),
+            startMonth: t(e.startMonth),
+            endMonth: t(e.endMonth),
+            required: r.isRequired,
+            disabled: h,
+            error: s,
+            helperText: s ? l.error?.message : r.helpText,
+            showFooter: e.showFooter,
+            showIntervalCaption: e.showIntervalCaption,
+            calendarKind: e.calendarKind,
+            fiscalMode: e.fiscalMode,
+            fiscalYearStartMonth: e.fiscalYearStartMonth,
+            fiscalMonthPattern: e.fiscalMonthPattern,
+            showPresets: e.showPresets,
+            ...e.componentProps
+          }
+        ) });
+      }
+    }
+  );
+};
+export {
+  C as YearRangePickerField
+};

package/dist/form-react/registry/defaultFieldRegistrations.d.ts

@@ -1,5 +1,5 @@
 /**
- * Register all 23 built-in field types. Safe to call multiple times — runs once.
+ * Register all 26 built-in field types. Safe to call multiple times — runs once.
  *
  * Consumers must call this at app startup (or use `registerFieldType` selectively)
  * before rendering any `FieldRenderer` / `ReactHooksForm`.

package/dist/form-react/registry/defaultFieldRegistrations.js

@@ -2,8 +2,8 @@ import { registerFieldType as e } from "./fieldRegistry.js";
 import { SelectField as r } from "../Fields/SelectField.js";
 import { ButtonsGroupField as o } from "../Fields/ButtonsGroupField.js";
 import { RadioField as t } from "../Fields/RadioField.js";
-import { TextField as l } from "../Fields/TextField.js";
-import { TextAreaField as m } from "../Fields/TextAreaField.js";
+import { TextField as m } from "../Fields/TextField.js";
+import { TextAreaField as l } from "../Fields/TextAreaField.js";
 import { DateRangeField as d } from "../Fields/DateRangeField.js";
 import { DateInputField as p } from "../Fields/DateInputField.js";
 import { WeekRangeField as a } from "../Fields/WeekRangePicker.js";
@@ -13,19 +13,22 @@ import { MultiMonthPickerField as _ } from "../Fields/MultiMonthPickerField.js";
 import { FileUploadField as n } from "../Fields/FileUploadField.js";
 import { FillFormByPasteField as c } from "../Fields/FillFormByPasteField.js";
 import { FillFormByFileUploadField as u } from "../Fields/FillFormByFileUploadField.js";
-import { ChipsField as b } from "../Fields/ChipsField.js";
-import { TextFieldWithBackendValidation as h } from "../Fields/TextFieldWithBackendValidation.js";
-import { SwitchField as s } from "../Fields/SwitchField.js";
-import { CheckboxField as g } from "../Fields/CheckboxField.js";
-import { LabelField as k } from "../Fields/LabelField.js";
+import { ChipsField as k } from "../Fields/ChipsField.js";
+import { TextFieldWithBackendValidation as b } from "../Fields/TextFieldWithBackendValidation.js";
+import { SwitchField as g } from "../Fields/SwitchField.js";
+import { CheckboxField as h } from "../Fields/CheckboxField.js";
+import { LabelField as s } from "../Fields/LabelField.js";
 import { DividerField as x } from "../Fields/DividerField.js";
-import { DividerWithLabelField as w } from "../Fields/DividerWithLabelField.js";
-import { NumericComboboxField as y } from "../Fields/NumericComboboxField.js";
-import { SliderRangeField as v } from "../Fields/SliderRangeField.js";
+import { DividerWithLabelField as y } from "../Fields/DividerWithLabelField.js";
+import { NumericComboboxField as w } from "../Fields/NumericComboboxField.js";
+import { SliderRangeField as P } from "../Fields/SliderRangeField.js";
+import { YearPickerField as R } from "../Fields/YearPickerField.js";
+import { MultiYearPickerField as v } from "../Fields/MultiYearPickerField.js";
+import { YearRangePickerField as D } from "../Fields/YearRangePickerField.js";
 let i = !1;
-function Q() {
-  i || (i = !0, e("divider", x), e("divider_with_label", w), e("label", k), e("select", r), e("button_group", o), e("radio", t), e("text", l), e("numeric_combobox", y), e("text_area", m), e("date", p), e("date_range", d), e("week_range", a), e("multi_week_picker", F), e("month_range", f), e("multi_month_picker", _), e("file_upload", n), e("fill_form_by_paste", c), e("fill_form_by_file_upload", u), e("chips", b), e("text_with_backend_validation", h), e("switch", s), e("checkbox", g), e("slider_range", v));
+function ie() {
+  i || (i = !0, e("divider", x), e("divider_with_label", y), e("label", s), e("select", r), e("button_group", o), e("radio", t), e("text", m), e("numeric_combobox", w), e("text_area", l), e("date", p), e("date_range", d), e("week_range", a), e("multi_week_picker", F), e("month_range", f), e("multi_month_picker", _), e("file_upload", n), e("fill_form_by_paste", c), e("fill_form_by_file_upload", u), e("chips", k), e("text_with_backend_validation", b), e("switch", g), e("checkbox", h), e("slider_range", P), e("year_picker", R), e("multi_year_picker", v), e("year_range", D));
 }
 export {
-  Q as registerDefaultFieldTypes
+  ie as registerDefaultFieldTypes
 };

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

@@ -284,6 +284,60 @@ export type MultiMonthPickerField = BaseField & {
     /** When true, open on the first enabled month. Navigate only. */
     autoNavigateToAvailable?: boolean;
 };
+export type YearPickerField = BaseField & {
+    fieldType: "year_picker";
+    defaultValue?: number;
+    minDate?: string;
+    maxDate?: string;
+    startMonth?: string;
+    endMonth?: string;
+    showFooter?: boolean;
+    showIntervalCaption?: boolean;
+    calendarKind?: "gregorian" | "fiscal";
+    fiscalMode?: "basic" | "advanced" | "custom";
+    fiscalYearStartMonth?: number;
+    fiscalMonthPattern?: number[];
+    showPresets?: boolean;
+    /** Additional props forwarded directly to the underlying YearPicker component */
+    componentProps?: Record<string, unknown>;
+};
+export type MultiYearPickerField = BaseField & {
+    fieldType: "multi_year_picker";
+    defaultValue?: number[];
+    minDate?: string;
+    maxDate?: string;
+    startMonth?: string;
+    endMonth?: string;
+    showFooter?: boolean;
+    showIntervalCaption?: boolean;
+    calendarKind?: "gregorian" | "fiscal";
+    fiscalMode?: "basic" | "advanced" | "custom";
+    fiscalYearStartMonth?: number;
+    fiscalMonthPattern?: number[];
+    showPresets?: boolean;
+    /** Additional props forwarded directly to the underlying MultiYearPicker component */
+    componentProps?: Record<string, unknown>;
+};
+export type YearRangePickerField = BaseField & {
+    fieldType: "year_range";
+    defaultRange?: {
+        start: number;
+        end: number;
+    };
+    minDate?: string;
+    maxDate?: string;
+    startMonth?: string;
+    endMonth?: string;
+    showFooter?: boolean;
+    showIntervalCaption?: boolean;
+    calendarKind?: "gregorian" | "fiscal";
+    fiscalMode?: "basic" | "advanced" | "custom";
+    fiscalYearStartMonth?: number;
+    fiscalMonthPattern?: number[];
+    showPresets?: boolean;
+    /** Additional props forwarded directly to the underlying YearRangePicker component */
+    componentProps?: Record<string, unknown>;
+};
 export type TextAreaField = BaseField & {
     fieldType: "text_area";
     maxRows?: number;
@@ -453,6 +507,6 @@ export type RichTextField = BaseField & {
     /** Minimum editor height in px. Default: 150 */
     minHeight?: number;
 };
-export type IField = FileUploadField | ButtonsGroupField | SelectField | DateInputField | DateRangeField | WeekRangeField | MonthRangeField | MultiMonthPickerField | TextAreaField | RadioField | TextField | NumericComboboxField | CopyPasteField | FillFormByFileUploadField | TextFieldWithBackendValidation | ChipsField | DividerField | DividerWithLabelField | LabelField | SwitchField | CheckboxField | MultiWeekRangeField | SliderRangeField | RichTextField | ObjectFieldConfig | ArrayFieldConfig;
+export type IField = FileUploadField | ButtonsGroupField | SelectField | DateInputField | DateRangeField | WeekRangeField | MonthRangeField | MultiMonthPickerField | TextAreaField | RadioField | TextField | NumericComboboxField | CopyPasteField | FillFormByFileUploadField | TextFieldWithBackendValidation | ChipsField | DividerField | DividerWithLabelField | LabelField | SwitchField | CheckboxField | YearPickerField | MultiYearPickerField | YearRangePickerField | MultiWeekRangeField | SliderRangeField | RichTextField | ObjectFieldConfig | ArrayFieldConfig;
 /** Discriminant string union for every built-in field type */
 export type FieldType = IField["fieldType"];

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

@@ -1,5 +1,5 @@
 import { Option } from '../../components/forms/select';
-import { MonthSelection, WeekSelection } from '../../components/data-display/calendar';
+import { MonthSelection, WeekSelection, YearRange, YearSelection } from '../../components/data-display/calendar';
 /** Shared range shape for date_range / week_range / month_range */
 export type RangeFieldOutput = {
     start: string | null;
@@ -26,6 +26,9 @@ export type ChipsFieldOutput = string | string[] | null | undefined;
 export type SwitchFieldOutput = boolean | null | undefined;
 export type CheckboxFieldOutput = boolean | null | undefined;
 export type SliderRangeFieldOutput = number[] | null | undefined;
+export type YearPickerFieldOutput = YearSelection | null | undefined;
+export type MultiYearPickerFieldOutput = YearSelection[] | null | undefined;
+export type YearRangePickerFieldOutput = YearRange | null | undefined;
 export type RichTextFieldOutput = string | null | undefined;
 /** Presentational fields do not store a value */
 export type PresentationalFieldOutput = null | undefined;
@@ -33,7 +36,7 @@ export type PresentationalFieldOutput = null | undefined;
  * Union of all field output values (recursive for object / array nesting).
  * Defined independently of FieldTypeToOutputMap to avoid circular map lookups.
  */
-export type FieldOutputValue = FileUploadFieldOutput | ButtonsGroupFieldOutput | SelectFieldOutput | DateInputFieldOutput | DateRangeFieldOutput | WeekRangeFieldOutput | MultiWeekPickerFieldOutput | MonthRangeFieldOutput | MultiMonthPickerFieldOutput | TextAreaFieldOutput | RadioFieldOutput | TextFieldOutput | NumericComboboxFieldOutput | CopyPasteFieldOutput | FillFormByFileUploadFieldOutput | TextFieldWithBackendValidationOutput | ChipsFieldOutput | SwitchFieldOutput | CheckboxFieldOutput | SliderRangeFieldOutput | RichTextFieldOutput | PresentationalFieldOutput | {
+export type FieldOutputValue = FileUploadFieldOutput | ButtonsGroupFieldOutput | SelectFieldOutput | DateInputFieldOutput | DateRangeFieldOutput | WeekRangeFieldOutput | MultiWeekPickerFieldOutput | MonthRangeFieldOutput | MultiMonthPickerFieldOutput | TextAreaFieldOutput | RadioFieldOutput | TextFieldOutput | NumericComboboxFieldOutput | CopyPasteFieldOutput | FillFormByFileUploadFieldOutput | TextFieldWithBackendValidationOutput | ChipsFieldOutput | SwitchFieldOutput | CheckboxFieldOutput | SliderRangeFieldOutput | YearPickerFieldOutput | MultiYearPickerFieldOutput | YearRangePickerFieldOutput | RichTextFieldOutput | PresentationalFieldOutput | {
     [key: string]: FieldOutputValue;
 } | Array<{
     [key: string]: FieldOutputValue;
@@ -62,6 +65,9 @@ export type FieldTypeToOutputMap = {
     switch: SwitchFieldOutput;
     checkbox: CheckboxFieldOutput;
     slider_range: SliderRangeFieldOutput;
+    year_picker: YearPickerFieldOutput;
+    multi_year_picker: MultiYearPickerFieldOutput;
+    year_range: YearRangePickerFieldOutput;
     rich_text: RichTextFieldOutput;
     object: {
         [key: string]: FieldOutputValue;

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

@@ -30,7 +30,7 @@ function u(e) {
     const t = e.min ?? 0;
     return e.range ? [t, e.max ?? 100] : [t];
   }
-  return e.fieldType === "date" ? "" : e.fieldType === "select" ? [] : e.fieldType === "week_range" && e.defaultRange ? {
+  return e.fieldType === "year_picker" ? e.defaultValue != null ? { year: e.defaultValue } : null : e.fieldType === "multi_year_picker" ? e.defaultValue?.map((t) => ({ year: t })) ?? null : e.fieldType === "year_range" && e.defaultRange ? { from: { year: e.defaultRange.start }, to: { year: e.defaultRange.end } } : e.fieldType === "date" ? "" : e.fieldType === "select" ? [] : e.fieldType === "week_range" && e.defaultRange ? {
     start: e.defaultRange.start || null,
     end: e.defaultRange.end || null
   } : null;

package/dist/lib/fiscal-calendar/index.d.ts

@@ -1,4 +1,4 @@
-export type { CalendarInterval, CalendarKind, CalendarSelection, CalendarSelectionMode, CivilDate, DateCellMeta, FiscalCalendarConfig, FiscalMode, FiscalMonth, FiscalMonthPattern, FiscalPeriod, FiscalQuarter, FiscalWeek, FiscalYearModel, FyLabelStyle, Granularity, LeapWeekPolicy, RetailPatternId, WeekSelection, Weekday, } from './types';
+export type { CalendarInterval, CalendarKind, CalendarSelection, CalendarSelectionMode, CivilDate, DateCellMeta, FiscalCalendarConfig, FiscalMode, FiscalMonthPattern, FiscalPeriod, FiscalQuarter, FiscalWeek, FiscalYearModel, FyLabelStyle, Granularity, LeapWeekPolicy, RetailPatternId, WeekSelection, Weekday, } from './types';
 export { DEFAULT_FY_LABEL, DEFAULT_LEAP_WEEK_POLICY, FISCAL_PATTERNS, } from './types';
 export { addDays, civilFromLocalDate, compareCivil, diffDays, formatCivilRange, lastDayOfMonth, localDateFromCivil, parseCivilDate, toCivilDate, weekStart, weekday, } from './civil-date';
 export { buildFiscalYear, clearFiscalYearCache, formatFyLabel, resolvePattern, shiftedFyForDate, } from './build-year';
@@ -6,5 +6,5 @@ export { getCellMeta, getFiscalYearForDate, clearFiscalLookupCache } from './loo
 export { getFiscalPresets } from './presets';
 export type { FiscalPreset } from './presets';
 export { isSameInterval, nextIntervalSelection } from './selection';
-export { buildFiscalMonthCalendar, getCalendarWeekSelection, getFiscalMonthSelection, getFiscalWeekSelection, resolveWeekSelection, toFiscalCalendarConfig, } from './week-selection';
+export { getCalendarWeekSelection, getFiscalWeekSelection, resolveWeekSelection, toFiscalCalendarConfig, } from './week-selection';
 export type { ResolveWeekSelectionOptions } from './week-selection';

package/dist/lib/fiscal-calendar/index.js

@@ -1,40 +1,38 @@
-import { DEFAULT_FY_LABEL as t, DEFAULT_LEAP_WEEK_POLICY as l, FISCAL_PATTERNS as o } from "./types.js";
-import { addDays as i, civilFromLocalDate as c, compareCivil as s, diffDays as F, formatCivilRange as n, lastDayOfMonth as f, localDateFromCivil as C, parseCivilDate as m, toCivilDate as D, weekStart as d, weekday as p } from "./civil-date.js";
-import { buildFiscalYear as L, clearFiscalYearCache as S, formatFyLabel as g, resolvePattern as x, shiftedFyForDate as E } from "./build-year.js";
-import { clearFiscalLookupCache as k, getCellMeta as y, getFiscalYearForDate as A } from "./lookup.js";
-import { getFiscalPresets as P } from "./presets.js";
-import { isSameInterval as I, nextIntervalSelection as M } from "./selection.js";
-import { buildFiscalMonthCalendar as W, getCalendarWeekSelection as b, getFiscalMonthSelection as u, getFiscalWeekSelection as w, resolveWeekSelection as O, toFiscalCalendarConfig as R } from "./week-selection.js";
+import { DEFAULT_FY_LABEL as t, DEFAULT_LEAP_WEEK_POLICY as r, FISCAL_PATTERNS as o } from "./types.js";
+import { addDays as i, civilFromLocalDate as c, compareCivil as s, diffDays as F, formatCivilRange as f, lastDayOfMonth as m, localDateFromCivil as n, parseCivilDate as C, toCivilDate as D, weekStart as p, weekday as v } from "./civil-date.js";
+import { buildFiscalYear as d, clearFiscalYearCache as x, formatFyLabel as S, resolvePattern as g, shiftedFyForDate as E } from "./build-year.js";
+import { clearFiscalLookupCache as y, getCellMeta as A, getFiscalYearForDate as _ } from "./lookup.js";
+import { getFiscalPresets as Y } from "./presets.js";
+import { isSameInterval as I, nextIntervalSelection as T } from "./selection.js";
+import { getCalendarWeekSelection as b, getFiscalWeekSelection as u, resolveWeekSelection as w, toFiscalCalendarConfig as M } from "./week-selection.js";
 export {
   t as DEFAULT_FY_LABEL,
-  l as DEFAULT_LEAP_WEEK_POLICY,
+  r as DEFAULT_LEAP_WEEK_POLICY,
   o as FISCAL_PATTERNS,
   i as addDays,
-  W as buildFiscalMonthCalendar,
-  L as buildFiscalYear,
+  d as buildFiscalYear,
   c as civilFromLocalDate,
-  k as clearFiscalLookupCache,
-  S as clearFiscalYearCache,
+  y as clearFiscalLookupCache,
+  x as clearFiscalYearCache,
   s as compareCivil,
   F as diffDays,
-  n as formatCivilRange,
-  g as formatFyLabel,
+  f as formatCivilRange,
+  S as formatFyLabel,
   b as getCalendarWeekSelection,
-  y as getCellMeta,
-  u as getFiscalMonthSelection,
-  P as getFiscalPresets,
-  w as getFiscalWeekSelection,
-  A as getFiscalYearForDate,
+  A as getCellMeta,
+  Y as getFiscalPresets,
+  u as getFiscalWeekSelection,
+  _ as getFiscalYearForDate,
   I as isSameInterval,
-  f as lastDayOfMonth,
-  C as localDateFromCivil,
-  M as nextIntervalSelection,
-  m as parseCivilDate,
-  x as resolvePattern,
-  O as resolveWeekSelection,
+  m as lastDayOfMonth,
+  n as localDateFromCivil,
+  T as nextIntervalSelection,
+  C as parseCivilDate,
+  g as resolvePattern,
+  w as resolveWeekSelection,
   E as shiftedFyForDate,
   D as toCivilDate,
-  R as toFiscalCalendarConfig,
-  d as weekStart,
-  p as weekday
+  M as toFiscalCalendarConfig,
+  p as weekStart,
+  v as weekday
 };

package/dist/lib/fiscal-calendar/types.d.ts

@@ -133,13 +133,6 @@ export interface WeekSelection {
     startDate: Date;
     endDate: Date;
 }
-/** Legacy fiscal-month block described as a WeekSelection (weekOfMonth = period index). */
-export interface FiscalMonth {
-    index: number;
-    startDate: Date;
-    endDate: Date;
-    weekCount: number;
-}
 export declare const FISCAL_PATTERNS: Record<RetailPatternId, FiscalMonthPattern>;
 export declare const DEFAULT_LEAP_WEEK_POLICY: LeapWeekPolicy;
 export declare const DEFAULT_FY_LABEL: FyLabelStyle;

package/dist/lib/fiscal-calendar/week-selection.d.ts

@@ -1,8 +1,6 @@
-import { CalendarKind, FiscalMode, FiscalMonth, FiscalMonthPattern, Granularity, WeekSelection, FiscalCalendarConfig, Weekday } from './types';
-export type { FiscalMode, FiscalMonth, FiscalMonthPattern };
+import { CalendarKind, FiscalMode, FiscalMonthPattern, Granularity, WeekSelection, FiscalCalendarConfig, Weekday } from './types';
+export type { FiscalMode, FiscalMonthPattern };
 export declare function getFiscalWeekSelection(date: Date, weekStartsOn: Weekday): WeekSelection;
-export declare function buildFiscalMonthCalendar(civilYear: number, pattern: FiscalMonthPattern, weekStartsOn: Weekday, fiscalYearStartMonth?: number): FiscalMonth[];
-export declare function getFiscalMonthSelection(date: Date, fiscalCalendar: FiscalMonth[]): WeekSelection | undefined;
 export declare function getCalendarWeekSelection(date: Date, weekStartsOn: Weekday): WeekSelection;
 export interface ResolveWeekSelectionOptions {
     calendarKind?: CalendarKind;
@@ -11,6 +9,7 @@ export interface ResolveWeekSelectionOptions {
     fiscalMonthPattern?: FiscalMonthPattern;
     fiscalYearStartMonth?: number;
     weekStartsOn?: Weekday;
+    fiscalConfig?: FiscalCalendarConfig;
 }
 export declare function resolveWeekSelection(date: Date, options?: ResolveWeekSelectionOptions): WeekSelection;
 export declare function toFiscalCalendarConfig(options: {

package/dist/lib/fiscal-calendar/week-selection.js

@@ -1,107 +1,80 @@
 import { FISCAL_PATTERNS as y } from "./types.js";
-function g(t, a) {
-  const e = new Date(t), s = (e.getDay() + 7 - a) % 7;
-  return e.setDate(e.getDate() - s), e.setHours(0, 0, 0, 0), e;
+import { buildFiscalYear as d } from "./build-year.js";
+import { civilFromLocalDate as m, parseCivilDate as w, localDateFromCivil as l } from "./civil-date.js";
+import { getCellMeta as k } from "./lookup.js";
+function D(t, n) {
+  const e = new Date(t), r = (e.getDay() + 7 - n) % 7;
+  return e.setDate(e.getDate() - r), e.setHours(0, 0, 0, 0), e;
 }
-function D(t, a) {
+function h(t, n) {
   const e = new Date(t);
-  return e.setDate(e.getDate() + a), e;
+  return e.setDate(e.getDate() + n), e;
 }
-function u(t, a) {
-  const e = g(t, a), n = D(e, 6), c = new Date(t.getFullYear(), t.getMonth(), 1).getDay(), o = e.getDate(), r = e.getMonth() === t.getMonth() ? o : 1, i = Math.ceil((r + c) / 7);
+function c(t, n) {
+  const e = D(t, n), a = h(e, 6), o = new Date(t.getFullYear(), t.getMonth(), 1).getDay(), i = e.getDate(), s = e.getMonth() === t.getMonth() ? i : 1, f = Math.ceil((s + o) / 7);
   return {
     year: t.getFullYear(),
     month: t.getMonth(),
-    weekOfMonth: Math.max(1, i),
+    weekOfMonth: Math.max(1, f),
     startDate: e,
-    endDate: n
+    endDate: a
   };
 }
-function M(t, a, e, n = 1) {
-  if (a.length !== 12)
-    throw new Error(`fiscalMonthPattern must have exactly 12 entries, got ${a.length}`);
-  const s = new Date(t, n - 1, 1);
-  let c = g(s, e);
-  const o = [];
-  for (let r = 0; r < 12; r++) {
-    const i = a[r], f = new Date(c), l = D(f, i * 7 - 1);
-    o.push({ index: r, startDate: f, endDate: l, weekCount: i }), c = D(l, 1);
-  }
-  return o;
-}
-function w(t, a) {
-  const e = new Date(t);
-  e.setHours(0, 0, 0, 0);
-  for (const n of a) {
-    const s = new Date(n.startDate);
-    s.setHours(0, 0, 0, 0);
-    const c = new Date(n.endDate);
-    if (c.setHours(23, 59, 59, 999), e >= s && e <= c)
-      return {
-        year: n.startDate.getFullYear(),
-        month: n.startDate.getMonth(),
-        weekOfMonth: n.index + 1,
-        startDate: n.startDate,
-        endDate: n.endDate
-      };
-  }
+function O(t, n) {
+  const e = D(t, n), a = h(e, 6), r = new Date(t.getFullYear(), t.getMonth(), 1), o = new Date(t.getFullYear(), t.getMonth() + 1, 0), i = e < r ? new Date(r) : new Date(e), s = a > o ? new Date(o) : new Date(a), u = new Date(i.getFullYear(), i.getMonth(), 1).getDay(), g = i.getDate(), M = Math.ceil((g + u) / 7);
+  return {
+    year: i.getFullYear(),
+    month: i.getMonth(),
+    weekOfMonth: Math.max(1, M),
+    startDate: i,
+    endDate: s
+  };
 }
-function d(t, a) {
-  const e = g(t, a), n = D(e, 6), s = new Date(t.getFullYear(), t.getMonth(), 1), c = new Date(t.getFullYear(), t.getMonth() + 1, 0), o = e < s ? new Date(s) : new Date(e), r = n > c ? new Date(c) : new Date(n), f = new Date(o.getFullYear(), o.getMonth(), 1).getDay(), l = o.getDate(), h = Math.ceil((l + f) / 7);
+function F(t, n, e) {
+  const a = k(t, m(n));
+  if (a?.fy == null || a.fiscalPeriod == null)
+    return c(n, e);
+  const r = d(t, a.fy).periods.find(
+    (i) => i.period === a.fiscalPeriod
+  );
+  if (!r) return c(n, e);
+  const o = w(r.start);
   return {
-    year: o.getFullYear(),
-    month: o.getMonth(),
-    weekOfMonth: Math.max(1, h),
-    startDate: o,
-    endDate: r
+    year: o.y,
+    month: o.m - 1,
+    weekOfMonth: r.period,
+    startDate: l(r.start),
+    endDate: l(r.end)
   };
 }
-function F(t, a = {}) {
+function v(t, n = {}) {
   const {
     calendarKind: e = "gregorian",
-    fiscalMode: n = "basic",
-    granularity: s,
-    fiscalMonthPattern: c,
-    fiscalYearStartMonth: o = 1,
-    weekStartsOn: r = 1
-  } = a;
+    fiscalMode: a = "basic",
+    granularity: r,
+    weekStartsOn: o = 1,
+    fiscalConfig: i
+  } = n;
   if (e !== "fiscal")
-    return d(t, r);
-  if (n === "basic" || s !== "period")
-    return u(t, r);
-  const i = c ?? y["4-5-4"];
-  if (i.length !== 12)
-    return u(t, r);
-  const f = M(
-    t.getFullYear(),
-    i,
-    r,
-    o
-  ), l = w(t, f);
-  if (l) return l;
-  const h = M(
-    t.getFullYear() - 1,
-    i,
-    r,
-    o
-  );
-  return w(t, h) ?? u(t, r);
+    return O(t, o);
+  if (a === "basic" || r !== "period")
+    return c(t, o);
+  const s = i ?? S(n);
+  return s ? F(s, t, o) : c(t, o);
 }
 function S(t) {
   if (t.calendarKind !== "fiscal") return;
-  const a = t.weekStartsOn ?? 1, e = t.fiscalYearStartMonth ?? 1;
+  const n = t.weekStartsOn ?? 1, e = t.fiscalYearStartMonth ?? 1;
   return {
     kind: "retail",
     pattern: t.fiscalMonthPattern ?? y["4-5-4"],
-    weekStartsOn: a,
+    weekStartsOn: n,
     fyAnchor: { month: e, day: 1, rule: "on-or-before" }
   };
 }
 export {
-  M as buildFiscalMonthCalendar,
-  d as getCalendarWeekSelection,
-  w as getFiscalMonthSelection,
-  u as getFiscalWeekSelection,
-  F as resolveWeekSelection,
+  O as getCalendarWeekSelection,
+  c as getFiscalWeekSelection,
+  v as resolveWeekSelection,
   S as toFiscalCalendarConfig
 };

package/dist/llms/rules/installation.js

@@ -1 +1 @@
-export default "# Install and configure Impact Nova\n\nUse these steps to add Impact Nova to an existing project. Run the commands in your project root and apply the code changes to your entry file and layout.\n\n## 0. Scaffold a new app (recommended)\n\n**`create-impact-nova@^1.4.9`** is on npm. Scaffold auto-detects dependency mode:\n\n| Where you run | `impact-nova` dependency |\n|---------------|--------------------------|\n| Published CLI / MCP (outside monorepo) | `impact-nova@^2.5.12` from npm (`latest` tag) |\n| Inside impact-nova monorepo | `file:` link to repo root |\n\n```bash\nnpx create-impact-nova my-dashboard\ncd my-dashboard\nnpm run dev\n```\n\nMCP: **`scaffold_impact_nova_app`** with `projectName` and optional `modules[]` from the user prompt.\n\n**Overrides:** CLI `--from-npm` · `--link-monorepo` · MCP `usePublishedPackages: true | false`\n\n```bash\nnpx create-impact-nova my-dashboard --from-npm\n```\n\nBase template is shell-only (Home + shared primitives). Feature pages come from recipes — see `create-impact-nova/recipes/README.md`.\n\n**Local link in an existing app** (manual):\n\n```bash\nnpm install impact-nova@file:../path-to-impact-nova-repo\n```\n\nRun `npm run build` in the impact-nova repo after design-system changes.\n\n## 1. Install the package and peer dependencies\n\n```bash\nnpm install impact-nova impact-nova-icons\nnpm install react@^19 react-dom@^19\n```\n\n**Required peers:** `react@^19`, `react-dom@^19`, `impact-nova-icons@^0.1.1`\n\n**Optional peers** (install when you use these features):\n\n| Package | Version | When needed |\n|---------|---------|-------------|\n| `ag-grid-community` | `36.0.1` | AG Grid types/API (pin with react + enterprise) |\n| `ag-grid-react` | `36.0.1` | DataTable / AG Grid |\n| `ag-grid-enterprise` | `36.0.1` | Enterprise grid features |\n| `highcharts` | `^12` | Chart component |\n| `highcharts-react-official` | `^3` | Chart component |\n| `highcharts-border-radius` | `^0.0.4` | Rounded chart corners |\n\nIf you use AG Grid or Highcharts in your app, also install:\n\n```bash\nnpm install ag-grid-community@36.0.1 ag-grid-react@36.0.1 ag-grid-enterprise@36.0.1\n# Optional, for charts:\nnpm install highcharts@^12 highcharts-react-official@^3 highcharts-border-radius@^0.0.4\n```\n\n## 2. Import styles in your root entry\n\nIn your app root (e.g. `main.tsx`, `App.tsx`, or `layout.tsx`), **import the CSS before your app component**:\n\n```tsx\nimport 'impact-nova/dist/impact-nova.css';\nimport App from './App';\n// ... rest of your bootstrap\n```\n\n## 3. Add Manrope font (recommended)\n\nIn your `index.html` or layout:\n\n```html\n<link href=\"https://fonts.googleapis.com/css2?family=Manrope:wght@200..800&display=swap\" rel=\"stylesheet\" />\n```\n\nIn your global CSS or Tailwind base:\n\n```css\n@layer base {\n  body {\n    font-family: 'Manrope', sans-serif;\n  }\n}\n```\n\n## 4. Wrap your app with providers (recommended)\n\nMount **`ImpactNovaProviders`** once at the app root. It bundles i18n (`ImpactNovaI18nProvider`) and `TooltipProvider` (required for tooltips since v2.0.8):\n\n```tsx\nimport { ImpactNovaProviders } from 'impact-nova/form';\n\nfunction Root() {\n  return (\n    <ImpactNovaProviders locale=\"en\">\n      <App />\n    </ImpactNovaProviders>\n  );\n}\n```\n\nFor another locale, pass a locale pack:\n\n```tsx\nimport { ImpactNovaProviders } from 'impact-nova/form';\nimport { de } from 'impact-nova/locale/de';\n\n<ImpactNovaProviders locale=\"de\" messages={de}>\n  <App />\n</ImpactNovaProviders>\n```\n\n**Barrel exception:** locale packs may use `import { de } from 'impact-nova'`. All UI components still use subpaths (see §5).\n\n## 5. Subpath imports (recommended)\n\nPrefer subpath imports in feature code for tree-shaking:\n\n```tsx\nimport { Button } from 'impact-nova/button';\nimport { Card, CardContent } from 'impact-nova/card';\nimport { DataTable, DataTableContent, useDataTable } from 'impact-nova/data-table';\nimport { CheckCircle } from 'impact-nova-icons';\n```\n\nThe barrel `import { Button } from 'impact-nova'` still works but pulls a larger module graph. **Use subpaths for all UI components**; reserve the barrel for locale packs at app root only. Use `ImpactNovaProviders` from `impact-nova/form` for app setup.\n\n## 6. Using Impact Nova with CSS or SCSS (no Tailwind)\n\nIf your app uses **plain CSS or SCSS** and does **not** use Tailwind, you can still use Impact Nova. Tailwind is optional. Impact Nova ships a single built CSS file (no SCSS source).\n\n- **Import the library CSS** in your app root (e.g. `main.tsx`, `App.tsx`):\n  ```tsx\n  import 'impact-nova/dist/impact-nova.css';\n  ```\n  **CSS split exports** (optional, for layered theming): `impact-nova/impact-nova-tokens.scss`, `impact-nova/impact-nova-base.scss`, `impact-nova/impact-nova-components.css`\n  Or from your main stylesheet: `@import 'impact-nova/dist/impact-nova.css';` in your main.css or main.scss.\n- **Component styling** comes from Impact Nova's CSS. Use each component's `variant` and `size` props; no Tailwind classes are required.\n- **Your layout and spacing** stay in your CSS or SCSS (margins, padding, flexbox, grid). Use your usual class names; the design system does not require Tailwind utilities.\n- **Manrope font:** Add the font link in `index.html` and in your CSS/SCSS set `body { font-family: 'Manrope', sans-serif; }` (see section 3).\n- **Summary:** No Tailwind, no Tailwind config. Load `impact-nova.css` once; use components with their props; use your existing CSS/SCSS for the rest.\n\n## 6b. Theming in consumer apps\n\n| Surface | What ships |\n|---------|------------|\n| **npm / consumer apps** | **Impact Light** only — `import 'impact-nova/dist/impact-nova.css'` (from `src/theme/tokens/light.json`) |\n| **Storybook / dev** | 10 curated **theme presets** (Impact Dark, Midnight, Ocean, …) — preview switcher only |\n\n**Do not** copy Storybook preset JSON or `theme-presets.ts` into consumer apps. Presets are not in the published package.\n\n**Custom branding:** override CSS variables on `:root` or a scoped class (e.g. `.my-brand`). Use Storybook **Theme Builder** / **Token Catalog** to explore tokens, then export CSS/JSON for your overrides.\n\n## 7. Using Impact Nova with Webpack\n\nIf your app is built with **Webpack** (including Create React App, which uses Webpack):\n\n- **CSS import:** Webpack will bundle the library CSS as long as you have a rule for `.css`. Ensure your config includes something like:\n  ```js\n  module: {\n    rules: [\n      {\n        test: /\\.css$/,\n        use: ['style-loader', 'css-loader'],\n        // or with MiniCssExtractPlugin:\n        // use: [MiniCssExtractPlugin.loader, 'css-loader'],\n      },\n      // ... other rules (e.g. for .tsx, .js)\n    ],\n  },\n  ```\n  Then in your root component or entry:\n  ```tsx\n  import 'impact-nova/dist/impact-nova.css';\n  ```\n- **Create React App (CRA):** No extra config. Add `import 'impact-nova/dist/impact-nova.css';` in `index.tsx` or `App.tsx`.\n- **Dedupe React / AG Grid:** If you see “multiple copies of React” or AG Grid issues, use Webpack’s `resolve.alias` so the app uses a single version:\n  ```js\n  resolve: {\n    alias: {\n      react: path.resolve(__dirname, 'node_modules/react'),\n      'react-dom': path.resolve(__dirname, 'node_modules/react-dom'),\n      // If using AG Grid:\n      'ag-grid-react': path.resolve(__dirname, 'node_modules/ag-grid-react'),\n      'ag-grid-community': path.resolve(__dirname, 'node_modules/ag-grid-community'),\n      'ag-grid-enterprise': path.resolve(__dirname, 'node_modules/ag-grid-enterprise'),\n    },\n  },\n  ```\n- **Tailwind + Webpack:** If you use Tailwind, add the Impact Nova preset and include the package in `content` (see section 7 below).\n\n## 8. Optional: extend Tailwind with Impact Nova preset\n\nIf your project uses Tailwind and you want the same theme (colors, radius), extend your `tailwind.config.js` with the preset from the package:\n\n```js\n// tailwind.config.js\nimport impactNovaPreset from 'impact-nova/tailwind.config.js';\n// → dist/tailwind.config.js (bundled theme; no package src/ required)\n\nexport default {\n  presets: [impactNovaPreset],\n  content: [\n    './index.html',\n    './src/**/*.{js,ts,jsx,tsx}',\n    './node_modules/impact-nova/dist/**/*.js',\n  ],\n  // ... rest of your config\n};\n```\n\n## Summary checklist\n\n- [ ] `npm install impact-nova impact-nova-icons` (and react, react-dom; optional: ag-grid, highcharts)\n- [ ] `import 'impact-nova/dist/impact-nova.css'` in root entry (or @import in main.css/main.scss if using CSS or SCSS without Tailwind; see §6)\n- [ ] Add Manrope font link and body font-family\n- [ ] Wrap app with `<ImpactNovaProviders locale=\"en\">` from `impact-nova/form`\n- [ ] Use subpath imports in feature code (see §5)\n- [ ] (Optional) Add Tailwind preset and content path for impact-nova\n- [ ] **Webpack:** Ensure a CSS rule (style-loader + css-loader) and, if needed, resolve.alias for React/AG Grid\n\nAfter this, import components via subpaths: `import { Button } from 'impact-nova/button';`\n\n## 9. Dashboard app shell (optional)\n\nTo scaffold a full dashboard (sidebar, header, breadcrumb, filters), read resource **`impact-nova://layout`** or call `get_real_world_patterns` with `topic: \"layout\"`. Use `Layout` from `impact-nova/layout` — not `DynamicLayout` (grid/flex utility only).\n";
+export default "# Install and configure Impact Nova\n\nUse these steps to add Impact Nova to an existing project. Run the commands in your project root and apply the code changes to your entry file and layout.\n\n## 0. Scaffold a new app (recommended)\n\n**`create-impact-nova@^1.4.9`** is on npm. Scaffold auto-detects dependency mode:\n\n| Where you run | `impact-nova` dependency |\n|---------------|--------------------------|\n| Published CLI / MCP (outside monorepo) | `impact-nova@^2.5.13` from npm (`latest` tag) |\n| Inside impact-nova monorepo | `file:` link to repo root |\n\n```bash\nnpx create-impact-nova my-dashboard\ncd my-dashboard\nnpm run dev\n```\n\nMCP: **`scaffold_impact_nova_app`** with `projectName` and optional `modules[]` from the user prompt.\n\n**Overrides:** CLI `--from-npm` · `--link-monorepo` · MCP `usePublishedPackages: true | false`\n\n```bash\nnpx create-impact-nova my-dashboard --from-npm\n```\n\nBase template is shell-only (Home + shared primitives). Feature pages come from recipes — see `create-impact-nova/recipes/README.md`.\n\n**Local link in an existing app** (manual):\n\n```bash\nnpm install impact-nova@file:../path-to-impact-nova-repo\n```\n\nRun `npm run build` in the impact-nova repo after design-system changes.\n\n## 1. Install the package and peer dependencies\n\n```bash\nnpm install impact-nova impact-nova-icons\nnpm install react@^19 react-dom@^19\n```\n\n**Required peers:** `react@^19`, `react-dom@^19`, `impact-nova-icons@^0.1.1`\n\n**Optional peers** (install when you use these features):\n\n| Package | Version | When needed |\n|---------|---------|-------------|\n| `ag-grid-community` | `36.0.1` | AG Grid types/API (pin with react + enterprise) |\n| `ag-grid-react` | `36.0.1` | DataTable / AG Grid |\n| `ag-grid-enterprise` | `36.0.1` | Enterprise grid features |\n| `highcharts` | `^12` | Chart component |\n| `highcharts-react-official` | `^3` | Chart component |\n| `highcharts-border-radius` | `^0.0.4` | Rounded chart corners |\n\nIf you use AG Grid or Highcharts in your app, also install:\n\n```bash\nnpm install ag-grid-community@36.0.1 ag-grid-react@36.0.1 ag-grid-enterprise@36.0.1\n# Optional, for charts:\nnpm install highcharts@^12 highcharts-react-official@^3 highcharts-border-radius@^0.0.4\n```\n\n## 2. Import styles in your root entry\n\nIn your app root (e.g. `main.tsx`, `App.tsx`, or `layout.tsx`), **import the CSS before your app component**:\n\n```tsx\nimport 'impact-nova/dist/impact-nova.css';\nimport App from './App';\n// ... rest of your bootstrap\n```\n\n## 3. Add Manrope font (recommended)\n\nIn your `index.html` or layout:\n\n```html\n<link href=\"https://fonts.googleapis.com/css2?family=Manrope:wght@200..800&display=swap\" rel=\"stylesheet\" />\n```\n\nIn your global CSS or Tailwind base:\n\n```css\n@layer base {\n  body {\n    font-family: 'Manrope', sans-serif;\n  }\n}\n```\n\n## 4. Wrap your app with providers (recommended)\n\nMount **`ImpactNovaProviders`** once at the app root. It bundles i18n (`ImpactNovaI18nProvider`) and `TooltipProvider` (required for tooltips since v2.0.8):\n\n```tsx\nimport { ImpactNovaProviders } from 'impact-nova/form';\n\nfunction Root() {\n  return (\n    <ImpactNovaProviders locale=\"en\">\n      <App />\n    </ImpactNovaProviders>\n  );\n}\n```\n\nFor another locale, pass a locale pack:\n\n```tsx\nimport { ImpactNovaProviders } from 'impact-nova/form';\nimport { de } from 'impact-nova/locale/de';\n\n<ImpactNovaProviders locale=\"de\" messages={de}>\n  <App />\n</ImpactNovaProviders>\n```\n\n**Barrel exception:** locale packs may use `import { de } from 'impact-nova'`. All UI components still use subpaths (see §5).\n\n## 5. Subpath imports (recommended)\n\nPrefer subpath imports in feature code for tree-shaking:\n\n```tsx\nimport { Button } from 'impact-nova/button';\nimport { Card, CardContent } from 'impact-nova/card';\nimport { DataTable, DataTableContent, useDataTable } from 'impact-nova/data-table';\nimport { CheckCircle } from 'impact-nova-icons';\n```\n\nThe barrel `import { Button } from 'impact-nova'` still works but pulls a larger module graph. **Use subpaths for all UI components**; reserve the barrel for locale packs at app root only. Use `ImpactNovaProviders` from `impact-nova/form` for app setup.\n\n## 6. Using Impact Nova with CSS or SCSS (no Tailwind)\n\nIf your app uses **plain CSS or SCSS** and does **not** use Tailwind, you can still use Impact Nova. Tailwind is optional. Impact Nova ships a single built CSS file (no SCSS source).\n\n- **Import the library CSS** in your app root (e.g. `main.tsx`, `App.tsx`):\n  ```tsx\n  import 'impact-nova/dist/impact-nova.css';\n  ```\n  **CSS split exports** (optional, for layered theming): `impact-nova/impact-nova-tokens.scss`, `impact-nova/impact-nova-base.scss`, `impact-nova/impact-nova-components.css`\n  Or from your main stylesheet: `@import 'impact-nova/dist/impact-nova.css';` in your main.css or main.scss.\n- **Component styling** comes from Impact Nova's CSS. Use each component's `variant` and `size` props; no Tailwind classes are required.\n- **Your layout and spacing** stay in your CSS or SCSS (margins, padding, flexbox, grid). Use your usual class names; the design system does not require Tailwind utilities.\n- **Manrope font:** Add the font link in `index.html` and in your CSS/SCSS set `body { font-family: 'Manrope', sans-serif; }` (see section 3).\n- **Summary:** No Tailwind, no Tailwind config. Load `impact-nova.css` once; use components with their props; use your existing CSS/SCSS for the rest.\n\n## 6b. Theming in consumer apps\n\n| Surface | What ships |\n|---------|------------|\n| **npm / consumer apps** | **Impact Light** only — `import 'impact-nova/dist/impact-nova.css'` (from `src/theme/tokens/light.json`) |\n| **Storybook / dev** | 10 curated **theme presets** (Impact Dark, Midnight, Ocean, …) — preview switcher only |\n\n**Do not** copy Storybook preset JSON or `theme-presets.ts` into consumer apps. Presets are not in the published package.\n\n**Custom branding:** override CSS variables on `:root` or a scoped class (e.g. `.my-brand`). Use Storybook **Theme Builder** / **Token Catalog** to explore tokens, then export CSS/JSON for your overrides.\n\n## 7. Using Impact Nova with Webpack\n\nIf your app is built with **Webpack** (including Create React App, which uses Webpack):\n\n- **CSS import:** Webpack will bundle the library CSS as long as you have a rule for `.css`. Ensure your config includes something like:\n  ```js\n  module: {\n    rules: [\n      {\n        test: /\\.css$/,\n        use: ['style-loader', 'css-loader'],\n        // or with MiniCssExtractPlugin:\n        // use: [MiniCssExtractPlugin.loader, 'css-loader'],\n      },\n      // ... other rules (e.g. for .tsx, .js)\n    ],\n  },\n  ```\n  Then in your root component or entry:\n  ```tsx\n  import 'impact-nova/dist/impact-nova.css';\n  ```\n- **Create React App (CRA):** No extra config. Add `import 'impact-nova/dist/impact-nova.css';` in `index.tsx` or `App.tsx`.\n- **Dedupe React / AG Grid:** If you see “multiple copies of React” or AG Grid issues, use Webpack’s `resolve.alias` so the app uses a single version:\n  ```js\n  resolve: {\n    alias: {\n      react: path.resolve(__dirname, 'node_modules/react'),\n      'react-dom': path.resolve(__dirname, 'node_modules/react-dom'),\n      // If using AG Grid:\n      'ag-grid-react': path.resolve(__dirname, 'node_modules/ag-grid-react'),\n      'ag-grid-community': path.resolve(__dirname, 'node_modules/ag-grid-community'),\n      'ag-grid-enterprise': path.resolve(__dirname, 'node_modules/ag-grid-enterprise'),\n    },\n  },\n  ```\n- **Tailwind + Webpack:** If you use Tailwind, add the Impact Nova preset and include the package in `content` (see section 7 below).\n\n## 8. Optional: extend Tailwind with Impact Nova preset\n\nIf your project uses Tailwind and you want the same theme (colors, radius), extend your `tailwind.config.js` with the preset from the package:\n\n```js\n// tailwind.config.js\nimport impactNovaPreset from 'impact-nova/tailwind.config.js';\n// → dist/tailwind.config.js (bundled theme; no package src/ required)\n\nexport default {\n  presets: [impactNovaPreset],\n  content: [\n    './index.html',\n    './src/**/*.{js,ts,jsx,tsx}',\n    './node_modules/impact-nova/dist/**/*.js',\n  ],\n  // ... rest of your config\n};\n```\n\n## Summary checklist\n\n- [ ] `npm install impact-nova impact-nova-icons` (and react, react-dom; optional: ag-grid, highcharts)\n- [ ] `import 'impact-nova/dist/impact-nova.css'` in root entry (or @import in main.css/main.scss if using CSS or SCSS without Tailwind; see §6)\n- [ ] Add Manrope font link and body font-family\n- [ ] Wrap app with `<ImpactNovaProviders locale=\"en\">` from `impact-nova/form`\n- [ ] Use subpath imports in feature code (see §5)\n- [ ] (Optional) Add Tailwind preset and content path for impact-nova\n- [ ] **Webpack:** Ensure a CSS rule (style-loader + css-loader) and, if needed, resolve.alias for React/AG Grid\n\nAfter this, import components via subpaths: `import { Button } from 'impact-nova/button';`\n\n## 9. Dashboard app shell (optional)\n\nTo scaffold a full dashboard (sidebar, header, breadcrumb, filters), read resource **`impact-nova://layout`** or call `get_real_world_patterns` with `topic: \"layout\"`. Use `Layout` from `impact-nova/layout` — not `DynamicLayout` (grid/flex utility only).\n";

package/dist/llms/rules/requirements.js

@@ -1 +1 @@
-export default "# Impact Nova — baseline\n\nUse **Impact Nova** design-system components and tokens. Prefer subpath imports (e.g. `impact-nova/button`) when you only need a few modules. For live component lists, specs, and codegen, use the **impact-nova-mcp** MCP server (see npm `impact-nova-mcp`). Browse **Storybook**: https://impact-nova.iaproducts.ai/\n\n## Peer dependency summary\n\n```json\n{\n  \"impactNova\": {\n    \"package\": \"impact-nova\",\n    \"recommendedVersion\": \"2.5.12\",\n    \"recommendedDistTag\": \"latest\",\n    \"description\": \"Design system package — ESM with 90+ subpath exports. Install: npm install impact-nova@latest\"\n  },\n  \"createImpactNova\": {\n    \"package\": \"create-impact-nova\",\n    \"recommendedVersion\": \"^1.4.9\",\n    \"description\": \"Vite + React scaffold with recipe-based modules\"\n  },\n  \"localDevelopment\": {\n    \"defaultScaffoldDependency\": \"auto\",\n    \"description\": \"create-impact-nova auto-detects: file: link when run inside the impact-nova monorepo; npm (impact-nova@^2.5.12) otherwise. CLI: --from-npm or --link-monorepo to override. Rebuild impact-nova (npm run build) after DS changes when using file: link.\",\n    \"cliFlagForNpm\": \"--from-npm\",\n    \"cliFlagForMonorepo\": \"--link-monorepo\",\n    \"mcpScaffoldFlag\": \"usePublishedPackages: true | false (omit for auto-detect)\"\n  },\n  \"mandatoryRules\": {\n    \"componentsOnly\": \"Use Impact Nova components only — never create new custom UI components\",\n    \"tables\": \"Any table/grid/spreadsheet → DataTable from impact-nova/data-table (not HTML table, not raw ag-grid-react)\",\n    \"validateBeforeDone\": \"Call validate_snippet on generated UI code\",\n    \"resource\": \"impact-nova://design-system-mandate\"\n  },\n  \"requiredPeers\": [\n    {\n      \"package\": \"react\",\n      \"recommendedVersion\": \"^19.0.0\",\n      \"description\": \"React 19 required\"\n    },\n    {\n      \"package\": \"react-dom\",\n      \"recommendedVersion\": \"^19.0.0\",\n      \"description\": \"React DOM 19 required\"\n    },\n    {\n      \"package\": \"impact-nova-icons\",\n      \"recommendedVersion\": \">=0.1.0\",\n      \"description\": \"Icons peer — not bundled in impact-nova; 0.1.x and 0.2.x supported\"\n    }\n  ],\n  \"optionalPeers\": [\n    {\n      \"package\": \"ag-grid-community\",\n      \"recommendedVersion\": \"36.0.1\",\n      \"description\": \"AG Grid community types/API; pin to the same version as ag-grid-react\"\n    },\n    {\n      \"package\": \"ag-grid-react\",\n      \"recommendedVersion\": \"36.0.1\",\n      \"description\": \"For DataTable and grid components; use exact version to match Impact Nova\"\n    },\n    {\n      \"package\": \"ag-grid-enterprise\",\n      \"recommendedVersion\": \"36.0.1\",\n      \"description\": \"Required if using ag-grid-react with enterprise features\"\n    },\n    {\n      \"package\": \"highcharts\",\n      \"recommendedVersion\": \"^12.0.0\",\n      \"description\": \"For Chart component\"\n    },\n    {\n      \"package\": \"highcharts-react-official\",\n      \"recommendedVersion\": \"^3.0.0\",\n      \"description\": \"For Chart component\"\n    },\n    {\n      \"package\": \"highcharts-border-radius\",\n      \"recommendedVersion\": \"^0.0.4\",\n      \"description\": \"Optional Highcharts plugin for rounded corners\"\n    }\n  ]\n}\n```\n";
+export default "# Impact Nova — baseline\n\nUse **Impact Nova** design-system components and tokens. Prefer subpath imports (e.g. `impact-nova/button`) when you only need a few modules. For live component lists, specs, and codegen, use the **impact-nova-mcp** MCP server (see npm `impact-nova-mcp`). Browse **Storybook**: https://impact-nova.iaproducts.ai/\n\n## Peer dependency summary\n\n```json\n{\n  \"impactNova\": {\n    \"package\": \"impact-nova\",\n    \"recommendedVersion\": \"2.5.13\",\n    \"recommendedDistTag\": \"latest\",\n    \"description\": \"Design system package — ESM with 90+ subpath exports. Install: npm install impact-nova@latest\"\n  },\n  \"createImpactNova\": {\n    \"package\": \"create-impact-nova\",\n    \"recommendedVersion\": \"^1.4.9\",\n    \"description\": \"Vite + React scaffold with recipe-based modules\"\n  },\n  \"localDevelopment\": {\n    \"defaultScaffoldDependency\": \"auto\",\n    \"description\": \"create-impact-nova auto-detects: file: link when run inside the impact-nova monorepo; npm (impact-nova@^2.5.13) otherwise. CLI: --from-npm or --link-monorepo to override. Rebuild impact-nova (npm run build) after DS changes when using file: link.\",\n    \"cliFlagForNpm\": \"--from-npm\",\n    \"cliFlagForMonorepo\": \"--link-monorepo\",\n    \"mcpScaffoldFlag\": \"usePublishedPackages: true | false (omit for auto-detect)\"\n  },\n  \"mandatoryRules\": {\n    \"componentsOnly\": \"Use Impact Nova components only — never create new custom UI components\",\n    \"tables\": \"Any table/grid/spreadsheet → DataTable from impact-nova/data-table (not HTML table, not raw ag-grid-react)\",\n    \"validateBeforeDone\": \"Call validate_snippet on generated UI code\",\n    \"resource\": \"impact-nova://design-system-mandate\"\n  },\n  \"requiredPeers\": [\n    {\n      \"package\": \"react\",\n      \"recommendedVersion\": \"^19.0.0\",\n      \"description\": \"React 19 required\"\n    },\n    {\n      \"package\": \"react-dom\",\n      \"recommendedVersion\": \"^19.0.0\",\n      \"description\": \"React DOM 19 required\"\n    },\n    {\n      \"package\": \"impact-nova-icons\",\n      \"recommendedVersion\": \">=0.1.0\",\n      \"description\": \"Icons peer — not bundled in impact-nova; 0.1.x and 0.2.x supported\"\n    }\n  ],\n  \"optionalPeers\": [\n    {\n      \"package\": \"ag-grid-community\",\n      \"recommendedVersion\": \"36.0.1\",\n      \"description\": \"AG Grid community types/API; pin to the same version as ag-grid-react\"\n    },\n    {\n      \"package\": \"ag-grid-react\",\n      \"recommendedVersion\": \"36.0.1\",\n      \"description\": \"For DataTable and grid components; use exact version to match Impact Nova\"\n    },\n    {\n      \"package\": \"ag-grid-enterprise\",\n      \"recommendedVersion\": \"36.0.1\",\n      \"description\": \"Required if using ag-grid-react with enterprise features\"\n    },\n    {\n      \"package\": \"highcharts\",\n      \"recommendedVersion\": \"^12.0.0\",\n      \"description\": \"For Chart component\"\n    },\n    {\n      \"package\": \"highcharts-react-official\",\n      \"recommendedVersion\": \"^3.0.0\",\n      \"description\": \"For Chart component\"\n    },\n    {\n      \"package\": \"highcharts-border-radius\",\n      \"recommendedVersion\": \"^0.0.4\",\n      \"description\": \"Optional Highcharts plugin for rounded corners\"\n    }\n  ]\n}\n```\n";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "impact-nova",
-  "version": "2.5.12",
+  "version": "2.5.14",
   "description": "Enterprise-grade React design system built with React 19, Vite, Tailwind CSS, and Radix UI. Built-in internationalization (i18n) and comprehensive UI component library for scalable, accessible, and performant applications.",
   "type": "module",
   "workspaces": [