calendar-simple 2.0.0-beta.1 → 2.0.0

package/dist/src/hooks/useEvents.d.ts

@@ -11,6 +11,7 @@ import { CalendarEvent } from '../types/events';
  *   events are pre-sorted by `startDate` ascending). **Caveat:** unsorted input will render in the
  *   provided order — the library never re-sorts the array.
  * @param enableEnrichedEvents - When `true`, skips validation (caller supplies pre-enriched events via `enrichedEventsByDate`).
+ * @param enrichedEventsByDate - Required companion map when `enableEnrichedEvents=true`.
  * @returns A memoized array containing only logically valid events.
  */
-export default function useEvents(events: CalendarEvent[], eventsAreSorted?: boolean, enableEnrichedEvents?: boolean): CalendarEvent[];
+export default function useEvents(events: CalendarEvent[], eventsAreSorted?: boolean, enableEnrichedEvents?: boolean, enrichedEventsByDate?: Record<string, CalendarEvent[]>): CalendarEvent[];

package/dist/src/index.d.ts

@@ -1,6 +1,6 @@
 import { default as Calendar } from './Calendar';
 export { EDayType, ECalendarViewType } from './types';
-export type { CalendarProps, CalendarEvent, CalendarContentProps, ColorScheme, CalendarTheme, ThemeScheme, } from './types';
+export type { CalendarProps, CalendarEvent, CalendarContentProps, ColorScheme, CalendarTheme, ThemeScheme, CalendarClassNames, } from './types';
 export type { HeaderProps } from './components/layout/Header';
 export type { ViewProps } from './components/views/View';
 export type { MonthViewProps } from './components/views/month_view/MonthView';

package/dist/src/types/calendar.d.ts

@@ -151,16 +151,23 @@ export interface CalendarProps {
     renderHourCell?: (date: Date) => ReactNode;
     /** Replaces the default date number in Month view cells. */
     renderDateCell?: (props: RenderDateCellProps) => ReactNode;
-    /** Pre-built O(1) lookup map of events keyed by date string. Avoids re-filtering on each render. */
+    /**
+     * Pre-built O(1) lookup map of events keyed by date string. Avoids re-filtering on each render.
+     * Must be provided when `enableEnrichedEvents=true` — omitting it emits a `console.warn`.
+     */
     enrichedEventsByDate?: Record<string, CalendarEvent[]>;
-    /** Enable O(1) event lookup via `enrichedEventsByDate`. */
+    /**
+     * Enable O(1) event lookup via `enrichedEventsByDate`.
+     * Emits a `console.warn` if `enrichedEventsByDate` is not provided alongside this flag (K-05).
+     */
     enableEnrichedEvents?: boolean;
     /**
      * Skip internal validation when events are already sorted by `startDate` ascending.
      *
-     * **Known caveat:** the library does not re-sort the array. If unsorted events are
-     * passed with this flag set to `true`, they will render in the order provided.
-     * Only set this flag when the input is guaranteed to be sorted.
+     * **Caveat:** the library does not re-sort the array. If unsorted events are passed with this
+     * flag set to `true`, they will render in the order provided. Only set this flag when the
+     * input is guaranteed to be sorted. A `console.warn` is emitted if the array is detected
+     * to be unsorted (K-03).
      */
     eventsAreSorted?: boolean;
     /** Maintain stable visual ordering of overlapping events across re-renders. */

package/dist/src/utils/common.d.ts

@@ -8,6 +8,14 @@ import { DateType } from './date';
  * @returns The maximum number of events to display
  */
 export declare function calculateMaxEvents(height: number, rowsInView: number): number;
+/**
+ * Normalizes a calendar dimension into a valid CSS length.
+ * Numbers are treated as pixels; strings are any CSS value, used verbatim.
+ *
+ * @param value - A pixel count (number) or any CSS length string (e.g. "100%", "60vh").
+ * @returns A CSS length string safe to assign to a custom property.
+ */
+export declare function toCssLength(value: number | string): string;
 /**
  * Helper to determine if an event is an all-day event.
  * An event is considered "all-day" if its start and end date strings

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "calendar-simple",
-  "version": "2.0.0-beta.1",
+  "version": "2.0.0",
   "type": "module",
   "description": "A user-friendly calendar app for viewing, selecting, and managing dates with data management capabilities.",
   "main": "./dist/index.cjs.js",
@@ -28,8 +28,8 @@
     "build": "vite build",
     "storybook": "storybook dev -p 6006",
     "build-storybook": "storybook build",
-    "lint": "eslint src",
-    "lint:fix": "eslint src --fix",
+    "lint": "tsc --noEmit && eslint src",
+    "lint:fix": "tsc --noEmit && eslint src --fix",
     "format": "prettier --write .",
     "format:check": "prettier --check .",
     "test": "vitest run",