@tugkanpilka/calendar 1.0.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Docbook
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,310 @@
+# @docbook/calendar
+
+A highly modular, infinite scrolling calendar component built with React and TypeScript. Follows SOLID principles and is designed to be published as an NPM package.
+
+## Features
+
+- **Infinite Scrolling**: Built-in support for infinite scrolling with IntersectionObserver
+- **Render Props**: Maximum customization through render props pattern
+- **Theme Support**: CSS variables for easy theming
+- **TypeScript**: Fully typed with comprehensive type definitions
+- **Performance**: Optimized with React.memo and efficient rendering
+- **Modular**: Clean architecture with separated concerns
+- **Zero Dependencies**: No internal component dependencies, pure React
+
+## Installation
+
+```bash
+npm install @docbook/calendar
+# or
+yarn add @docbook/calendar
+```
+
+## Peer Dependencies
+
+```json
+{
+  "react": "^18.0.0 || ^19.0.0",
+  "react-dom": "^18.0.0 || ^19.0.0",
+  "date-range-utils": "^1.0.16",
+  "date-fns": "^4.1.0"
+}
+```
+
+## Basic Usage
+
+```tsx
+import { Calendar } from '@docbook/calendar';
+import type { DateInfo, MonthInfo } from 'date-range-utils';
+import { DateRange, StandardDateGenerationStrategy, MonthGroupingStrategy } from 'date-range-utils';
+
+function MyCalendar() {
+  const months: MonthInfo<DateInfo>[] = useMemo(() => {
+    const dateFactory = (date: Date): DateInfo => ({
+      date,
+      weekNumber: getWeek(date),
+    });
+
+    return new DateRange<DateInfo, MonthInfo<DateInfo>>(
+      new Date(2025, 0, 1),
+      new Date(2025, 11, 31),
+    )
+      .create(new StandardDateGenerationStrategy(dateFactory))
+      .group(new MonthGroupingStrategy());
+  }, []);
+
+  const renderDay = (dateInfo: DateInfo) => {
+    return (
+      <div>
+        {dateInfo.date.getDate()}
+      </div>
+    );
+  };
+
+  return (
+    <Calendar
+      months={months}
+      renderDay={renderDay}
+    />
+  );
+}
+```
+
+## Infinite Scrolling
+
+The Calendar component supports infinite scrolling out of the box:
+
+```tsx
+<Calendar
+  months={months}
+  renderDay={renderDay}
+  onLoadMore={async () => {
+    // Load more months
+    await loadMoreMonths();
+  }}
+  hasMore={hasMoreMonths}
+  isLoading={isLoading}
+/>
+```
+
+## Custom Rendering
+
+All components support render props for maximum customization:
+
+```tsx
+<Calendar
+  months={months}
+  renderDay={(dateInfo) => (
+    <Day
+      dateInfo={dateInfo}
+      onDateClick={handleDateClick}
+      renderDate={(dayNumber) => (
+        <span className="custom-day">{dayNumber}</span>
+      )}
+      renderIndicator={({ isDotted, dotType }) => (
+        isDotted ? <CustomIndicator type={dotType} /> : null
+      )}
+    />
+  )}
+/>
+```
+
+## Components
+
+### Calendar
+
+Main orchestrator component.
+
+**Props:**
+- `months`: Array of month information (required)
+- `renderDay`: Function to render day cells (required)
+- `renderWeekNumber`: Function to render week numbers (optional)
+- `renderMonthHeader`: Function to render month headers (optional)
+- `showWeekNumbers`: Whether to show week numbers (default: true)
+- `onLoadMore`: Infinite scroll callback (optional)
+- `hasMore`: Whether there are more items to load (optional)
+- `isLoading`: Whether currently loading (optional)
+- `className`: Additional CSS class name (optional)
+- `headerClassName`: Additional CSS class for header (optional)
+- `bodyClassName`: Additional CSS class for body (optional)
+
+### Day
+
+Day cell component with render props support.
+
+**Props:**
+- `dateInfo`: Date information
+- `onDateClick`: Callback when date is clicked
+- `onClick`: Additional click handler
+- `isSelected`: Whether the day is selected
+- `isRounded`: Whether the day has rounded corners
+- `isMarked`: Whether the day is marked (e.g., today)
+- `isDotted`: Whether the day has a dot indicator
+- `dotType`: Type of dot indicator ('primary' | 'secondary')
+- `renderDate`: Custom render function for date display
+- `renderIndicator`: Custom render function for indicator
+- `className`: Additional CSS class name
+
+### Week
+
+Week number component with render props support.
+
+**Props:**
+- `text`: Week number text (e.g., "W1")
+- `isMultiMonth`: Whether the week spans multiple months
+- `onClick`: Click handler
+- `isDotted`: Whether the week has a dot indicator
+- `isFocused`: Whether the week is focused
+- `dotType`: Type of dot indicator
+- `renderText`: Custom render function for text display
+- `renderIndicator`: Custom render function for indicator
+- `className`: Additional CSS class name
+
+### MonthHeader
+
+Month header component with render props support.
+
+**Props:**
+- `text`: Month name text
+- `onClick`: Click handler
+- `isFocused`: Whether the month is focused
+- `isDotted`: Whether the month has a dot indicator
+- `dotType`: Type of dot indicator
+- `renderText`: Custom render function for text display
+- `renderIndicator`: Custom render function for indicator
+- `className`: Additional CSS class name
+
+## Utilities
+
+### Date Formatting
+
+```tsx
+import { formatCalendarDate } from '@docbook/calendar';
+
+const dayString = formatCalendarDate.day(new Date()); // "2025-01-15"
+const weekString = formatCalendarDate.week(new Date(), 3); // "2025-W3"
+const monthString = formatCalendarDate.month(2025, "January"); // "2025-M1"
+```
+
+### Grid Utilities
+
+```tsx
+import { isWeekNumberCell, calculateGridIndex } from '@docbook/calendar';
+
+const isWeekNumber = isWeekNumberCell(7); // true (index 7 is week number column)
+const index = calculateGridIndex(2, 3, 8); // 19 (row 2, col 3, 8 columns)
+```
+
+### Scroll Utilities
+
+```tsx
+import { scrollToDate, findDateElement } from '@docbook/calendar';
+
+await scrollToDate('2025-01-15', containerRef.current);
+const element = findDateElement('2025-01-15', containerRef.current);
+```
+
+## Hooks
+
+### useCalendarItems
+
+Generic hook to generate props for calendar components.
+
+```tsx
+import { useCalendarItems } from '@docbook/calendar';
+
+const { getDayProps, getWeekNumberProps, getMonthHeaderProps } = useCalendarItems({
+  currentDate: '2025-01-15',
+  setCurrentDate: (date) => console.log(date),
+  getIndicatorProps: (formattedDate) => ({
+    isDotted: true,
+    dotType: 'primary',
+  }),
+});
+```
+
+### useInfiniteScroll
+
+Hook for infinite scrolling support.
+
+```tsx
+import { useInfiniteScroll } from '@docbook/calendar';
+
+const { sentinelRef } = useInfiniteScroll({
+  hasMore: true,
+  isLoading: false,
+  onLoadMore: async () => {
+    await loadMore();
+  },
+  scrollRef: containerRef,
+});
+```
+
+### useScrollToDate
+
+Hook for scrolling to a specific date.
+
+```tsx
+import { useScrollToDate } from '@docbook/calendar';
+
+const { scrollTo, findElement } = useScrollToDate({
+  scrollRef: containerRef,
+});
+
+await scrollTo('2025-01-15');
+```
+
+## Theming
+
+The component uses CSS variables for theming. Override them in your CSS:
+
+```css
+:root {
+  --calendar-bg-color: #F5F6F8;
+  --day-cell-height: 80px;
+  --day-cell-marked-bg: #ef4444;
+  --indicator-primary-color: #ef4444;
+  /* ... more variables */
+}
+```
+
+## TypeScript
+
+All components and utilities are fully typed. Import types as needed:
+
+```tsx
+import type {
+  CalendarProps,
+  DayProps,
+  WeekProps,
+  MonthHeaderProps,
+} from '@docbook/calendar';
+```
+
+## Styling
+
+The component uses CSS modules. Import the compiled CSS:
+
+```tsx
+import '@docbook/calendar/dist/styles.css';
+```
+
+Or use CSS modules in your build configuration.
+
+## Migration from Monorepo
+
+If you're migrating from the monorepo version:
+
+1. Replace `@shared/ui/organisms/Calendar` imports with `@docbook/calendar`
+2. Remove `@shared/styles` SCSS imports (variables are now included)
+3. Update any internal component dependencies (now using render props)
+4. Ensure peer dependencies are installed
+
+## License
+
+MIT
+
+## Contributing
+
+Contributions are welcome! Please read our contributing guidelines first.
+

package/dist/components/Calendar/Calendar.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Calendar component - Main orchestrator for infinite scrolling calendar
+ */
+import type { CalendarProps } from './Calendar.types';
+/**
+ * Calendar component - Main orchestrator
+ * Supports infinite scrolling and customizable rendering
+ */
+declare function Calendar(props: CalendarProps): import("react/jsx-runtime").JSX.Element;
+declare const _default: import("react").MemoExoticComponent<typeof Calendar>;
+export default _default;
+//# sourceMappingURL=Calendar.d.ts.map

package/dist/components/Calendar/Calendar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Calendar.d.ts","sourceRoot":"","sources":["../../../src/components/Calendar/Calendar.tsx"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAKtD;;;GAGG;AACH,iBAAS,QAAQ,CAAC,KAAK,EAAE,aAAa,2CA6CrC;;AAED,wBAA8B"}

package/dist/components/Calendar/Calendar.types.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Calendar component types
+ */
+import type { DateInfo, MonthInfo } from 'date-range-utils';
+import type { ReactNode } from 'react';
+/**
+ * Calendar component props
+ */
+export interface CalendarProps {
+    /** Array of month information */
+    months: MonthInfo<DateInfo>[];
+    /** Render function for day cells */
+    renderDay: (dateInfo: DateInfo, index?: number, sectionIndex?: number) => ReactNode;
+    /** Render function for week number cells (optional) */
+    renderWeekNumber?: (dateInfo: DateInfo, index?: number, sectionIndex?: number) => ReactNode;
+    /** Render function for month header (optional) */
+    renderMonthHeader?: (monthName: string) => ReactNode;
+    /** Whether to show week numbers (default: true) */
+    showWeekNumbers?: boolean;
+    /** Infinite scroll callback - called when more items should be loaded */
+    onLoadMore?: () => void | Promise<void>;
+    /** Whether there are more items to load */
+    hasMore?: boolean;
+    /** Whether currently loading more items */
+    isLoading?: boolean;
+    /** Additional CSS class name for root */
+    className?: string;
+    /** Additional CSS class name for header */
+    headerClassName?: string;
+    /** Additional CSS class name for scrollable body */
+    bodyClassName?: string;
+}
+//# sourceMappingURL=Calendar.types.d.ts.map

package/dist/components/Calendar/Calendar.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Calendar.types.d.ts","sourceRoot":"","sources":["../../../src/components/Calendar/Calendar.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC9B,oCAAoC;IACpC,SAAS,EAAE,CACT,QAAQ,EAAE,QAAQ,EAClB,KAAK,CAAC,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM,KAClB,SAAS,CAAC;IACf,uDAAuD;IACvD,gBAAgB,CAAC,EAAE,CACjB,QAAQ,EAAE,QAAQ,EAClB,KAAK,CAAC,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM,KAClB,SAAS,CAAC;IACf,kDAAkD;IAClD,iBAAiB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,SAAS,CAAC;IACrD,mDAAmD;IACnD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,2CAA2C;IAC3C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/dist/components/Day/Day.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Day component - Pure presentation component for calendar day cells
+ */
+import type { DayProps } from './Day.types';
+declare const _default: import("react").NamedExoticComponent<DayProps & import("react").RefAttributes<HTMLDivElement>>;
+export default _default;
+//# sourceMappingURL=Day.d.ts.map

package/dist/components/Day/Day.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Day.d.ts","sourceRoot":"","sources":["../../../src/components/Day/Day.tsx"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;;AAwF5C,wBASE"}

package/dist/components/Day/Day.types.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Day component types
+ */
+import type { DateInfo } from 'date-range-utils';
+import type { ReactNode } from 'react';
+/**
+ * Indicator props for render prop
+ */
+export interface DayIndicatorProps {
+    isDotted: boolean;
+    dotType: 'primary' | 'secondary';
+}
+/**
+ * Day component props
+ */
+export interface DayProps {
+    /** Date information */
+    dateInfo: DateInfo;
+    /** Callback when date is clicked */
+    onDateClick: (dateInfo: DateInfo) => void;
+    /** Additional click handler */
+    onClick?: () => void;
+    /** Whether the day is selected */
+    isSelected?: boolean;
+    /** Whether the day has rounded corners */
+    isRounded?: boolean;
+    /** Whether the day is marked (e.g., today) */
+    isMarked?: boolean;
+    /** Whether the day has a dot indicator */
+    isDotted?: boolean;
+    /** Type of dot indicator */
+    dotType?: 'primary' | 'secondary';
+    /** Custom render function for date display */
+    renderDate?: (dayNumber: number) => ReactNode;
+    /** Custom render function for indicator */
+    renderIndicator?: (props: DayIndicatorProps) => ReactNode;
+    /** Additional CSS class name */
+    className?: string;
+}
+//# sourceMappingURL=Day.types.d.ts.map

package/dist/components/Day/Day.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Day.types.d.ts","sourceRoot":"","sources":["../../../src/components/Day/Day.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,SAAS,GAAG,WAAW,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,uBAAuB;IACvB,QAAQ,EAAE,QAAQ,CAAC;IACnB,oCAAoC;IACpC,WAAW,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;IAC1C,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,kCAAkC;IAClC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,SAAS,GAAG,WAAW,CAAC;IAClC,8CAA8C;IAC9C,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,SAAS,CAAC;IAC9C,2CAA2C;IAC3C,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,SAAS,CAAC;IAC1D,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/components/MonthHeader/MonthHeader.d.ts

@@ -0,0 +1,12 @@
+/**
+ * MonthHeader component - Pure presentation component for calendar month headers
+ */
+import type { MonthHeaderProps } from './MonthHeader.types';
+/**
+ * MonthHeader component for calendar month headers
+ * Supports render props for customizing text display and indicator
+ */
+declare function MonthHeader(props: MonthHeaderProps): import("react/jsx-runtime").JSX.Element;
+declare const _default: import("react").MemoExoticComponent<typeof MonthHeader>;
+export default _default;
+//# sourceMappingURL=MonthHeader.d.ts.map

package/dist/components/MonthHeader/MonthHeader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MonthHeader.d.ts","sourceRoot":"","sources":["../../../src/components/MonthHeader/MonthHeader.tsx"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG5D;;;GAGG;AACH,iBAAS,WAAW,CAAC,KAAK,EAAE,gBAAgB,2CA0C3C;;AAED,wBAAiC"}

package/dist/components/MonthHeader/MonthHeader.types.d.ts

@@ -0,0 +1,33 @@
+/**
+ * MonthHeader component types
+ */
+import type { ReactNode } from 'react';
+/**
+ * Indicator props for render prop
+ */
+export interface MonthHeaderIndicatorProps {
+    isDotted: boolean;
+    dotType: 'primary' | 'secondary';
+}
+/**
+ * MonthHeader component props
+ */
+export interface MonthHeaderProps {
+    /** Month name text */
+    text: string;
+    /** Click handler */
+    onClick?: () => void;
+    /** Whether the month is focused */
+    isFocused?: boolean;
+    /** Whether the month has a dot indicator */
+    isDotted?: boolean;
+    /** Type of dot indicator */
+    dotType?: 'primary' | 'secondary';
+    /** Custom render function for text display */
+    renderText?: (text: string) => ReactNode;
+    /** Custom render function for indicator */
+    renderIndicator?: (props: MonthHeaderIndicatorProps) => ReactNode;
+    /** Additional CSS class name */
+    className?: string;
+}
+//# sourceMappingURL=MonthHeader.types.d.ts.map

package/dist/components/MonthHeader/MonthHeader.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MonthHeader.types.d.ts","sourceRoot":"","sources":["../../../src/components/MonthHeader/MonthHeader.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,SAAS,GAAG,WAAW,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,mCAAmC;IACnC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,SAAS,GAAG,WAAW,CAAC;IAClC,8CAA8C;IAC9C,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,SAAS,CAAC;IACzC,2CAA2C;IAC3C,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,yBAAyB,KAAK,SAAS,CAAC;IAClE,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/components/MonthList/MonthList.d.ts

@@ -0,0 +1,12 @@
+/**
+ * MonthList component - Infinite scrolling grid layout for calendar months
+ */
+import type { MonthListProps } from './MonthList.types';
+/**
+ * MonthList component for infinite scrolling calendar
+ * Handles grid layout and infinite scroll support
+ */
+declare function MonthList(props: MonthListProps): import("react/jsx-runtime").JSX.Element;
+declare const _default: import("react").MemoExoticComponent<typeof MonthList>;
+export default _default;
+//# sourceMappingURL=MonthList.d.ts.map

package/dist/components/MonthList/MonthList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MonthList.d.ts","sourceRoot":"","sources":["../../../src/components/MonthList/MonthList.tsx"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAWxD;;;GAGG;AACH,iBAAS,SAAS,CAAC,KAAK,EAAE,cAAc,2CA2FvC;;AAED,wBAA+B"}

package/dist/components/MonthList/MonthList.types.d.ts

@@ -0,0 +1,31 @@
+/**
+ * MonthList component types
+ */
+import type { DateInfo, MonthInfo } from 'date-range-utils';
+import type { ReactNode, RefObject } from 'react';
+/**
+ * MonthList component props
+ */
+export interface MonthListProps {
+    /** Array of month information */
+    months: MonthInfo<DateInfo>[];
+    /** Render function for day cells */
+    renderDay: (dateInfo: DateInfo, index?: number, sectionIndex?: number) => ReactNode;
+    /** Render function for week number cells (optional) */
+    renderWeekNumber?: (dateInfo: DateInfo, index?: number, sectionIndex?: number) => ReactNode;
+    /** Render function for month header (optional) */
+    renderMonthHeader?: (monthName: string) => ReactNode;
+    /** Whether to show week numbers (default: true) */
+    showWeekNumbers?: boolean;
+    /** Infinite scroll callback - called when more items should be loaded */
+    onLoadMore?: () => void | Promise<void>;
+    /** Whether there are more items to load */
+    hasMore?: boolean;
+    /** Whether currently loading more items */
+    isLoading?: boolean;
+    /** Ref to the scrollable container */
+    scrollRef?: RefObject<HTMLElement | null>;
+    /** Additional CSS class name */
+    className?: string;
+}
+//# sourceMappingURL=MonthList.types.d.ts.map

package/dist/components/MonthList/MonthList.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MonthList.types.d.ts","sourceRoot":"","sources":["../../../src/components/MonthList/MonthList.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC9B,oCAAoC;IACpC,SAAS,EAAE,CACT,QAAQ,EAAE,QAAQ,EAClB,KAAK,CAAC,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM,KAClB,SAAS,CAAC;IACf,uDAAuD;IACvD,gBAAgB,CAAC,EAAE,CACjB,QAAQ,EAAE,QAAQ,EAClB,KAAK,CAAC,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM,KAClB,SAAS,CAAC;IACf,kDAAkD;IAClD,iBAAiB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,SAAS,CAAC;IACrD,mDAAmD;IACnD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,2CAA2C;IAC3C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,sCAAsC;IACtC,SAAS,CAAC,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC1C,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/components/Week/Week.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Week component - Pure presentation component for calendar week numbers
+ */
+import type { WeekProps } from './Week.types';
+/**
+ * Week component for calendar week numbers
+ * Supports render props for customizing text display and indicator
+ */
+declare function Week(props: WeekProps): import("react/jsx-runtime").JSX.Element;
+declare const _default: import("react").MemoExoticComponent<typeof Week>;
+export default _default;
+//# sourceMappingURL=Week.d.ts.map

package/dist/components/Week/Week.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Week.d.ts","sourceRoot":"","sources":["../../../src/components/Week/Week.tsx"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAG9C;;;GAGG;AACH,iBAAS,IAAI,CAAC,KAAK,EAAE,SAAS,2CA4C7B;;AAED,wBAA0B"}

package/dist/components/Week/Week.types.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Week component types
+ */
+import type { ReactNode } from 'react';
+/**
+ * Indicator props for render prop
+ */
+export interface WeekIndicatorProps {
+    isDotted: boolean;
+    dotType: 'primary' | 'secondary';
+}
+/**
+ * Week component props
+ */
+export interface WeekProps {
+    /** Week number text (e.g., "W1") */
+    text: string;
+    /** Whether the week spans multiple months */
+    isMultiMonth?: boolean;
+    /** Click handler */
+    onClick?: () => void;
+    /** Whether the week has a dot indicator */
+    isDotted?: boolean;
+    /** Whether the week is focused */
+    isFocused?: boolean;
+    /** Type of dot indicator */
+    dotType?: 'primary' | 'secondary';
+    /** Custom render function for text display */
+    renderText?: (text: string) => ReactNode;
+    /** Custom render function for indicator */
+    renderIndicator?: (props: WeekIndicatorProps) => ReactNode;
+    /** Additional CSS class name */
+    className?: string;
+}
+//# sourceMappingURL=Week.types.d.ts.map

package/dist/components/Week/Week.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Week.types.d.ts","sourceRoot":"","sources":["../../../src/components/Week/Week.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,SAAS,GAAG,WAAW,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,oBAAoB;IACpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kCAAkC;IAClC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,SAAS,GAAG,WAAW,CAAC;IAClC,8CAA8C;IAC9C,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,SAAS,CAAC;IACzC,2CAA2C;IAC3C,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,SAAS,CAAC;IAC3D,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/components/WeekdayHeader/WeekdayHeader.d.ts

@@ -0,0 +1,16 @@
+/**
+ * WeekdayHeader component - Pure presentation component for calendar weekday names
+ */
+import type { WeekdayHeaderProps } from './WeekdayHeader.types';
+/**
+ * Default weekday names
+ */
+export declare const WEEKDAY_NAMES: readonly ["M", "T", "W", "T", "F", "S", "S", "#"];
+/**
+ * WeekdayHeader component for calendar weekday names
+ * Supports render props for customizing weekday name display
+ */
+declare function WeekdayHeader(props: WeekdayHeaderProps): import("react/jsx-runtime").JSX.Element;
+declare const _default: import("react").MemoExoticComponent<typeof WeekdayHeader>;
+export default _default;
+//# sourceMappingURL=WeekdayHeader.d.ts.map

package/dist/components/WeekdayHeader/WeekdayHeader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WeekdayHeader.d.ts","sourceRoot":"","sources":["../../../src/components/WeekdayHeader/WeekdayHeader.tsx"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAGhE;;GAEG;AACH,eAAO,MAAM,aAAa,mDAAoD,CAAC;AAE/E;;;GAGG;AACH,iBAAS,aAAa,CAAC,KAAK,EAAE,kBAAkB,2CAqB/C;;AAED,wBAAmC"}

package/dist/components/WeekdayHeader/WeekdayHeader.types.d.ts

@@ -0,0 +1,16 @@
+/**
+ * WeekdayHeader component types
+ */
+import type { ReactNode } from 'react';
+/**
+ * WeekdayHeader component props
+ */
+export interface WeekdayHeaderProps {
+    /** Array of weekday names (default: ['M', 'T', 'W', 'T', 'F', 'S', 'S', '#']) */
+    weekdayNames?: readonly string[];
+    /** Custom render function for weekday name display */
+    renderWeekdayName?: (name: string, index: number) => ReactNode;
+    /** Additional CSS class name */
+    className?: string;
+}
+//# sourceMappingURL=WeekdayHeader.types.d.ts.map

package/dist/components/WeekdayHeader/WeekdayHeader.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WeekdayHeader.types.d.ts","sourceRoot":"","sources":["../../../src/components/WeekdayHeader/WeekdayHeader.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,iFAAiF;IACjF,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,sDAAsD;IACtD,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC;IAC/D,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}