impact-nova 0.1.13 → 1.0.0

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

@@ -0,0 +1,62 @@
+import { WeekSelection } from '../components/ui/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

@@ -0,0 +1,99 @@
+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
+};

package/package.json

@@ -1,7 +1,7 @@
 
 {
   "name": "impact-nova",
-  "version": "0.1.13",
+  "version": "1.0.0",
   "description": "Enterprise-grade React design system built with React 19, Vite, Tailwind CSS, and Radix UI. Comprehensive UI component library for scalable, accessible, and performant applications.",
   "type": "module",
   "main": "./dist/index.js",
@@ -550,8 +550,8 @@
     "@vitejs/plugin-react": "^5.1.1",
     "@vitest/browser-playwright": "^4.0.18",
     "@vitest/coverage-v8": "^4.0.18",
-    "ag-grid-enterprise": "^35.0.1",
-    "ag-grid-react": "^35.0.1",
+    "ag-grid-enterprise": "35.0.1",
+    "ag-grid-react": "35.0.1",
     "autoprefixer": "^10.4.23",
     "eslint": "^9.39.1",
     "eslint-plugin-react-hooks": "^7.0.1",
@@ -574,8 +574,8 @@
     "vitest": "^4.0.18"
   },
   "peerDependencies": {
-    "ag-grid-enterprise": "^35.0.1",
-    "ag-grid-react": "^35.0.1",
+    "ag-grid-enterprise": "35.0.1",
+    "ag-grid-react": "35.0.1",
     "highcharts": "^12.5.0",
     "highcharts-border-radius": "^0.0.4",
     "highcharts-react-official": "^3.2.3",

package/dist/components/ui/select/hooks/useClickOutside.d.ts

@@ -1,15 +0,0 @@
-import { RefObject } from 'react';
-import { OnChangeValue, SingleValue, MultiValue, Option } from '../../types/select.types';
-interface UseClickOutsideProps<OptionType extends Option, IsMulti extends boolean> {
-    isOpen: boolean;
-    setIsOpen: (isOpen: boolean) => void;
-    triggerRef: RefObject<HTMLElement | null>;
-    menuRef: RefObject<HTMLElement | null>;
-    onMenuClose?: (finalValue?: OnChangeValue<OptionType, IsMulti>, finalSelectionOrder?: string[]) => void;
-    internalValue: SingleValue<OptionType> | MultiValue<OptionType>;
-    isMulti: boolean;
-    setSearchValue: (val: string) => void;
-    setActiveSubmenu: (val: string | null) => void;
-}
-export declare const useClickOutside: <OptionType extends Option, IsMulti extends boolean>({ isOpen, setIsOpen, triggerRef, menuRef, onMenuClose, internalValue, isMulti, setSearchValue, setActiveSubmenu, }: UseClickOutsideProps<OptionType, IsMulti>) => void;
-export {};

package/dist/components/ui/select/hooks/useClickOutside.js

@@ -1,43 +0,0 @@
-import { useEffect as k } from "react";
-import { isOptionArray as w } from "../utils/select.js";
-const O = ({
-  isOpen: o,
-  setIsOpen: s,
-  triggerRef: e,
-  menuRef: c,
-  onMenuClose: i,
-  internalValue: n,
-  isMulti: r,
-  setSearchValue: d,
-  setActiveSubmenu: m
-}) => {
-  k(() => {
-    const u = (f) => {
-      const t = f.target, a = e.current?.contains(t), l = c.current?.contains(t), v = t instanceof Element ? t.closest(".select-submenu-container") : null;
-      if (!a && !l && !v) {
-        if (o) {
-          s(!1);
-          const E = n, p = r && w(n) ? n.map((g) => g.value) : void 0;
-          i?.(E, p);
-        }
-        d(""), m(null);
-      }
-    };
-    return document.addEventListener("mousedown", u), () => {
-      document.removeEventListener("mousedown", u);
-    };
-  }, [
-    o,
-    s,
-    e,
-    c,
-    i,
-    n,
-    r,
-    d,
-    m
-  ]);
-};
-export {
-  O as useClickOutside
-};

package/dist/components/ui/select/hooks/useMenuPosition.d.ts

@@ -1,2 +0,0 @@
-import { RefObject } from 'react';
-export declare const useMenuPosition: (isOpen: boolean, triggerRef: RefObject<HTMLDivElement | null>, menuRef: RefObject<HTMLDivElement | null>, flatOptionsLength: number, isProcessing: boolean, dropdownZIndex?: number) => import('react').CSSProperties;

package/dist/components/ui/select/hooks/useMenuPosition.js

@@ -1,89 +0,0 @@
-import { useState as k, useRef as A, useLayoutEffect as D } from "react";
-const K = (z, c, v, X, q, b) => {
-  const [B, S] = k({
-    opacity: 0
-    // Start hidden to prevent flash
-  }), l = A(null), E = A(null), y = A(!0);
-  return D(() => {
-    if (!z || !c.current) {
-      y.current || (S({ opacity: 0 }), y.current = !0);
-      return;
-    }
-    y.current = !1;
-    const W = () => {
-      if (!c.current) return null;
-      const t = c.current.getBoundingClientRect(), e = window.innerWidth, M = window.innerHeight, i = window.scrollX, m = window.scrollY;
-      let w = 320;
-      v.current && (w = v.current.getBoundingClientRect().height || 320);
-      const s = t.width, r = 4, j = M - t.bottom, x = t.top, O = e - t.right, U = t.left;
-      let n = "bottom", a = 0, o = 0, g = "";
-      j >= w + r ? (n = "bottom", a = t.bottom + m + r, o = t.left + i) : x >= w + r ? (n = "top", a = t.top + m - w - r, o = t.left + i) : O >= s + r ? (n = "right", a = t.top + m, o = t.right + i + r, g = "translateY(0)") : U >= s + r ? (n = "left", a = t.top + m, o = t.left + i - s - r, g = "translateY(0)") : (n = "bottom", a = t.bottom + m + r, o = t.left + i);
-      let d = o - i;
-      return d + s > e && (d = Math.max(0, e - s)), d < 0 && (d = 0), o = d + i, {
-        top: a,
-        left: o,
-        width: n === "bottom" || n === "top" ? s : "auto",
-        minWidth: n === "right" || n === "left" ? s : void 0,
-        position: n,
-        transform: g
-      };
-    }, Y = (t) => {
-      const e = E.current;
-      (!e || e.top !== t.top || e.left !== t.left || e.width !== t.width || e.position !== t.position) && (E.current = {
-        top: t.top,
-        left: t.left,
-        width: t.width,
-        position: t.position
-      }, S({
-        position: "absolute",
-        top: t.top,
-        left: t.left,
-        width: t.width,
-        minWidth: t.minWidth,
-        zIndex: typeof b == "number" ? b : 20,
-        transform: t.transform,
-        opacity: 1
-        // Make visible
-      }));
-    }, F = () => {
-      l.current !== null && cancelAnimationFrame(l.current), l.current = requestAnimationFrame(() => {
-        const t = W();
-        t && (Y(t), l.current = null);
-      });
-    }, R = W();
-    R && Y(R);
-    const C = new ResizeObserver(() => {
-      F();
-    });
-    C.observe(c.current);
-    let f = null;
-    const H = () => {
-      f === null && (f = requestAnimationFrame(() => {
-        F(), f = null;
-      }));
-    };
-    let p = null;
-    const h = () => {
-      p === null && (p = requestAnimationFrame(() => {
-        F(), p = null;
-      }));
-    }, L = [];
-    let u = c.current?.parentElement;
-    for (; u; ) {
-      const t = window.getComputedStyle(u).overflowY, e = window.getComputedStyle(u).overflowX;
-      (t === "auto" || t === "scroll" || e === "auto" || e === "scroll") && L.push(u), u = u.parentElement;
-    }
-    return L.forEach((t) => {
-      t.addEventListener("scroll", h, {
-        passive: !0
-      });
-    }), window.addEventListener("resize", H, { passive: !0 }), window.addEventListener("scroll", h, { passive: !0, capture: !0 }), () => {
-      l.current !== null && (cancelAnimationFrame(l.current), l.current = null), f !== null && cancelAnimationFrame(f), p !== null && cancelAnimationFrame(p), C.disconnect(), L.forEach((t) => {
-        t.removeEventListener("scroll", h);
-      }), window.removeEventListener("resize", H), window.removeEventListener("scroll", h, !0), E.current = null;
-    };
-  }, [z, X, c, v, q, b]), B;
-};
-export {
-  K as useMenuPosition
-};