impact-nova 2.5.7 → 2.5.8

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

@@ -0,0 +1,145 @@
+/**
+ * Headless fiscal calendar types. No React. Civil dates are YYYY-MM-DD.
+ */
+export type CivilDate = string;
+export type CalendarKind = "gregorian" | "fiscal";
+export type FiscalMode = "basic" | "advanced" | "custom";
+export type RetailPatternId = "4-4-5" | "4-5-4" | "5-4-4";
+export type LeapWeekPolicy = "append-last-period" | "period-13";
+export type FyLabelStyle = "fy-short" | "fy-long" | "ending-year" | "starting-year";
+export type Weekday = 0 | 1 | 2 | 3 | 4 | 5 | 6;
+/** Per-period week counts, e.g. [4,4,5,4,4,5,4,4,5,4,4,5] */
+export type FiscalMonthPattern = number[];
+export type FyAnchorRule = "on-or-before" | "closest-weekday";
+export type FiscalCalendarConfig = {
+    kind: "shifted-year";
+    fyStartMonth: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12;
+    fyStartDay?: number;
+    fyLabel?: FyLabelStyle;
+    weekStartsOn?: Weekday;
+} | {
+    kind: "retail";
+    pattern: RetailPatternId | FiscalMonthPattern;
+    weekStartsOn: Weekday;
+    fyAnchor: {
+        month: number;
+        day: number;
+        rule: FyAnchorRule;
+    };
+    leapWeekPolicy?: LeapWeekPolicy;
+    fyLabel?: FyLabelStyle;
+} | {
+    kind: "custom-table";
+    periods: ReadonlyArray<{
+        fy: number;
+        period: number;
+        start: CivilDate;
+        end: CivilDate;
+    }>;
+    fyLabel?: FyLabelStyle;
+    weekStartsOn?: Weekday;
+};
+export interface FiscalWeek {
+    fy: number;
+    week: number;
+    start: CivilDate;
+    end: CivilDate;
+    period: number;
+    quarter: 1 | 2 | 3 | 4;
+}
+export interface FiscalPeriod {
+    fy: number;
+    period: number;
+    label: string;
+    displayLabel: string;
+    start: CivilDate;
+    end: CivilDate;
+    weekCount: number;
+    quarter: 1 | 2 | 3 | 4;
+    gregorianMonthSpan: ReadonlyArray<{
+        year: number;
+        month: number;
+    }>;
+}
+export interface FiscalQuarter {
+    fy: number;
+    quarter: 1 | 2 | 3 | 4;
+    start: CivilDate;
+    end: CivilDate;
+    periods: readonly number[];
+}
+export interface FiscalYearModel {
+    fy: number;
+    start: CivilDate;
+    end: CivilDate;
+    weekCount: 52 | 53;
+    periodCount: 12 | 13;
+    weeks: readonly FiscalWeek[];
+    periods: readonly FiscalPeriod[];
+    quarters: readonly FiscalQuarter[];
+}
+export interface DateCellMeta {
+    iso: CivilDate;
+    gregorian: {
+        year: number;
+        month: number;
+        day: number;
+    };
+    fy?: number;
+    fiscalWeek?: number;
+    fiscalPeriod?: number;
+    fiscalQuarter?: 1 | 2 | 3 | 4;
+    isPeriodStart?: boolean;
+    isPeriodEnd?: boolean;
+    isFyStart?: boolean;
+    isFyEnd?: boolean;
+    crossesGregorianMonth?: boolean;
+}
+export type Granularity = "day" | "week" | "period" | "quarter" | "year";
+export type CalendarSelectionMode = "single" | "multiple" | "range" | "multi-range";
+export interface CalendarInterval {
+    start: CivilDate;
+    end: CivilDate;
+    granularity: Granularity;
+    fy?: number;
+    period?: number;
+    week?: number;
+    quarter?: 1 | 2 | 3 | 4;
+}
+export type CalendarSelection = {
+    mode: "single";
+    value: CalendarInterval | null;
+} | {
+    mode: "multiple";
+    value: CalendarInterval[];
+} | {
+    mode: "range";
+    value: {
+        from: CalendarInterval;
+        to?: CalendarInterval;
+    } | null;
+} | {
+    mode: "multi-range";
+    value: Array<{
+        from: CalendarInterval;
+        to: CalendarInterval;
+    }>;
+};
+/** Picker-facing week value. Dates are local civil midnights. */
+export interface WeekSelection {
+    year: number;
+    month: number;
+    weekOfMonth: number;
+    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/types.js

@@ -0,0 +1,10 @@
+const E = {
+  "4-4-5": [4, 4, 5, 4, 4, 5, 4, 4, 5, 4, 4, 5],
+  "4-5-4": [4, 5, 4, 4, 5, 4, 4, 5, 4, 4, 5, 4],
+  "5-4-4": [5, 4, 4, 5, 4, 4, 5, 4, 4, 5, 4, 4]
+}, L = "append-last-period", o = "fy-short";
+export {
+  o as DEFAULT_FY_LABEL,
+  L as DEFAULT_LEAP_WEEK_POLICY,
+  E as FISCAL_PATTERNS
+};

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

@@ -0,0 +1,22 @@
+import { CalendarKind, FiscalMode, FiscalMonth, FiscalMonthPattern, Granularity, WeekSelection, FiscalCalendarConfig, Weekday } from './types';
+export type { FiscalMode, FiscalMonth, 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;
+    fiscalMode?: FiscalMode;
+    granularity?: Granularity;
+    fiscalMonthPattern?: FiscalMonthPattern;
+    fiscalYearStartMonth?: number;
+    weekStartsOn?: Weekday;
+}
+export declare function resolveWeekSelection(date: Date, options?: ResolveWeekSelectionOptions): WeekSelection;
+export declare function toFiscalCalendarConfig(options: {
+    calendarKind?: CalendarKind;
+    fiscalMode?: FiscalMode;
+    fiscalMonthPattern?: FiscalMonthPattern;
+    fiscalYearStartMonth?: number;
+    weekStartsOn?: Weekday;
+}): FiscalCalendarConfig | undefined;

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

@@ -0,0 +1,107 @@
+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;
+}
+function D(t, a) {
+  const e = new Date(t);
+  return e.setDate(e.getDate() + a), 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);
+  return {
+    year: t.getFullYear(),
+    month: t.getMonth(),
+    weekOfMonth: Math.max(1, i),
+    startDate: e,
+    endDate: n
+  };
+}
+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 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);
+  return {
+    year: o.getFullYear(),
+    month: o.getMonth(),
+    weekOfMonth: Math.max(1, h),
+    startDate: o,
+    endDate: r
+  };
+}
+function F(t, a = {}) {
+  const {
+    calendarKind: e = "gregorian",
+    fiscalMode: n = "basic",
+    granularity: s,
+    fiscalMonthPattern: c,
+    fiscalYearStartMonth: o = 1,
+    weekStartsOn: r = 1
+  } = a;
+  if (e !== "fiscal")
+    return d(t, r);
+  if (n === "basic" || s !== "period")
+    return u(t, r);
+  const i = c ?? y["4-4-5"];
+  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);
+}
+function S(t) {
+  if (t.calendarKind !== "fiscal") return;
+  const a = t.weekStartsOn ?? 1, e = t.fiscalYearStartMonth ?? 1;
+  return {
+    kind: "retail",
+    pattern: t.fiscalMonthPattern ?? y["4-4-5"],
+    weekStartsOn: a,
+    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,
+  S as toFiscalCalendarConfig
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "impact-nova",
-  "version": "2.5.7",
+  "version": "2.5.8",
   "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": [
@@ -509,6 +509,10 @@
     "./guidance/adapters/dialog": {
       "types": "./dist/components/flows/guidance/adapters/dialog.d.ts",
       "import": "./dist/components/flows/guidance/adapters/dialog.js"
+    },
+    "./fiscal-calendar": {
+      "types": "./dist/lib/fiscal-calendar/index.d.ts",
+      "import": "./dist/lib/fiscal-calendar/index.js"
     }
   },
   "scripts": {

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

@@ -1,62 +0,0 @@
-import { WeekSelection } from '../components/data-display/calendar';
-export type CalendarType = "calendar" | "fiscal";
-export type FiscalMode = "basic" | "advanced" | "custom";
-export type SelectionMode = "week" | "fiscalMonth";
-/** Per-month week counts for the fiscal year, e.g. [4,4,5,4,4,5,4,4,5,4,4,5] */
-export type FiscalMonthPattern = number[];
-/** Describes one fiscal month (a contiguous block of weeks). */
-export interface FiscalMonth {
-    /** 0-based index within the fiscal year (0 = first fiscal month) */
-    index: number;
-    startDate: Date;
-    endDate: Date;
-    weekCount: number;
-}
-/**
- * Pre-defined fiscal month patterns, each repeated 4× to yield 12 fiscal months.
- * The pattern describes the number of weeks in each of the 3-month period.
- * Sum = 13 weeks per quarter × 4 = 52 weeks per year.
- */
-export declare const FISCAL_PATTERNS: Record<string, FiscalMonthPattern>;
-/**
- * Returns the WeekSelection for a basic 7-day fiscal week.
- * Unlike the "calendar" mode, the week is NOT clipped to month boundaries.
- */
-export declare function getFiscalWeekSelection(date: Date, weekStartsOn: 0 | 1 | 2 | 3 | 4 | 5 | 6): WeekSelection;
-/**
- * Build the fiscal month calendar for one civil year.
- *
- * @param civilYear            The civil year (e.g. 2026)
- * @param pattern              Array of week-counts per fiscal month (length 12)
- * @param weekStartsOn         Day the fiscal week begins
- * @param fiscalYearStartMonth 1-based month where the fiscal year starts (default 1 = January)
- *
- * The first fiscal month starts at `weekStart(fiscalYearStartMonth 1st, civilYear)`.
- * Each subsequent fiscal month begins exactly (weekCount × 7) days after the previous one.
- */
-export declare function buildFiscalMonthCalendar(civilYear: number, pattern: FiscalMonthPattern, weekStartsOn: 0 | 1 | 2 | 3 | 4 | 5 | 6, fiscalYearStartMonth?: number): FiscalMonth[];
-/**
- * Given a date and a pre-built fiscal calendar, find which fiscal month the date
- * falls in and return a WeekSelection spanning that entire fiscal month.
- *
- * Returns `undefined` if the date is outside the fiscal calendar range.
- */
-export declare function getFiscalMonthSelection(date: Date, fiscalCalendar: FiscalMonth[]): WeekSelection | undefined;
-/**
- * Standard calendar week selection – the week is clipped to the month boundary
- * (same as the existing "normal" behaviour).
- */
-export declare function getCalendarWeekSelection(date: Date, weekStartsOn: 0 | 1 | 2 | 3 | 4 | 5 | 6): WeekSelection;
-export interface ResolveWeekSelectionOptions {
-    calendarType?: CalendarType;
-    fiscalMode?: FiscalMode;
-    selectionMode?: SelectionMode;
-    fiscalMonthPattern?: FiscalMonthPattern;
-    fiscalYearStartMonth?: number;
-    weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
-}
-/**
- * Unified entry point for computing a WeekSelection from a clicked date,
- * respecting the full new API.
- */
-export declare function resolveWeekSelection(date: Date, options?: ResolveWeekSelectionOptions): WeekSelection;

package/dist/lib/fiscal-calendar.js

@@ -1,99 +0,0 @@
-const M = {
-  "4-4-5": [4, 4, 5, 4, 4, 5, 4, 4, 5, 4, 4, 5]
-};
-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;
-}
-function f(t, a) {
-  const e = new Date(t);
-  return e.setDate(e.getDate() + a), e;
-}
-function u(t, a) {
-  const e = g(t, a), n = f(e, 6), c = new Date(t.getFullYear(), t.getMonth(), 1).getDay(), r = e.getDate(), o = e.getMonth() === t.getMonth() ? r : 1, l = Math.ceil((o + c) / 7);
-  return {
-    year: t.getFullYear(),
-    month: t.getMonth(),
-    weekOfMonth: Math.max(1, l),
-    startDate: e,
-    endDate: n
-  };
-}
-function w(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 r = [];
-  for (let o = 0; o < 12; o++) {
-    const l = a[o], D = new Date(c), i = f(D, l * 7 - 1);
-    r.push({ index: o, startDate: D, endDate: i, weekCount: l }), c = f(i, 1);
-  }
-  return r;
-}
-function y(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 d(t, a) {
-  const e = g(t, a), n = f(e, 6), s = new Date(t.getFullYear(), t.getMonth(), 1), c = new Date(t.getFullYear(), t.getMonth() + 1, 0), r = e < s ? new Date(s) : new Date(e), o = n > c ? new Date(c) : new Date(n), D = new Date(r.getFullYear(), r.getMonth(), 1).getDay(), i = r.getDate(), h = Math.ceil((i + D) / 7);
-  return {
-    year: r.getFullYear(),
-    month: r.getMonth(),
-    weekOfMonth: Math.max(1, h),
-    startDate: r,
-    endDate: o
-  };
-}
-function k(t, a = {}) {
-  const {
-    calendarType: e = "calendar",
-    fiscalMode: n = "basic",
-    selectionMode: s = "week",
-    fiscalMonthPattern: c,
-    fiscalYearStartMonth: r = 1,
-    weekStartsOn: o = 1
-  } = a;
-  if (e === "calendar")
-    return d(t, o);
-  if (n === "basic" || s === "week")
-    return u(t, o);
-  const l = c ?? M["4-4-5"];
-  if (l.length !== 12)
-    return u(t, o);
-  const D = w(
-    t.getFullYear(),
-    l,
-    o,
-    r
-  ), i = y(t, D);
-  if (i) return i;
-  const h = w(
-    t.getFullYear() - 1,
-    l,
-    o,
-    r
-  );
-  return y(t, h) ?? u(t, o);
-}
-export {
-  M as FISCAL_PATTERNS,
-  w as buildFiscalMonthCalendar,
-  d as getCalendarWeekSelection,
-  y as getFiscalMonthSelection,
-  u as getFiscalWeekSelection,
-  k as resolveWeekSelection
-};