@nori-ui/core 0.0.5 → 1.0.2

package/dist/components/Calendar/index.d.cts

@@ -0,0 +1,169 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode, Ref } from 'react';
+import { CalendarDate } from '@internationalized/date';
+import { View } from 'react-native';
+
+/**
+ * Day of week index where 0 = Sunday, 1 = Monday, ..., 6 = Saturday.
+ * Matches `Date.prototype.getDay()` semantics.
+ */
+type DayOfWeek = 0 | 1 | 2 | 3 | 4 | 5 | 6;
+
+type CalendarMode = 'single' | 'range' | 'multiple';
+type CalendarView = 'day' | 'month' | 'year';
+type CalendarBehavior = 'paged' | 'scroll';
+type CalendarCaption$1 = 'title' | 'dropdown' | 'custom';
+type DateRange = {
+    start: CalendarDate;
+    end: CalendarDate | null;
+};
+type CalendarValue<M extends CalendarMode> = M extends 'single' ? CalendarDate | null : M extends 'range' ? DateRange | null : M extends 'multiple' ? CalendarDate[] : never;
+type ChangeMeta = {
+    view: CalendarView;
+    source: 'click' | 'keyboard' | 'scroll';
+};
+type DayContext = {
+    date: CalendarDate;
+    isOutsideMonth: boolean;
+    isToday: boolean;
+    isSelected: boolean;
+    isRangeStart: boolean;
+    isRangeEnd: boolean;
+    isInRange: boolean;
+    isInPreviewRange: boolean;
+    isUnavailable: boolean;
+    isFocused: boolean;
+    isWeekend: boolean;
+};
+type CalendarBaseProps<M extends CalendarMode = 'single'> = {
+    mode?: M;
+    value?: CalendarValue<M>;
+    defaultValue?: CalendarValue<M>;
+    onChange?: (value: CalendarValue<M>, meta: ChangeMeta) => void;
+    view?: CalendarView;
+    defaultView?: CalendarView;
+    onViewChange?: (view: CalendarView) => void;
+    /** Default 'paged' on web, 'scroll' on native (Phase 2). */
+    behavior?: CalendarBehavior;
+    /** Number of calendar months side-by-side. `'auto'` = 2 on ≥768px, else 1. */
+    visibleMonths?: number | 'auto';
+    /** Inclusive minimum selectable date. */
+    minValue?: CalendarDate;
+    /** Inclusive maximum selectable date. */
+    maxValue?: CalendarDate;
+    /** Predicate marking a date unavailable (cannot be focused or selected). */
+    isDateUnavailable?: (date: CalendarDate) => boolean;
+    /**
+     * Header layout. `'title'` (default) shows a centered "May 2026 ▾"
+     * drilldown button. `'dropdown'` replaces it with `[ May ▾ ] [ 2026 ▾ ]`
+     * pickers powered by `Select`. `'custom'` hides the built-in caption
+     * and renders the Calendar's children — typically wrapped in
+     * `<Calendar.Caption>` — driving them via `useCalendarCaption()`.
+     */
+    caption?: CalendarCaption$1;
+    /**
+     * Year-dropdown bounds, inclusive. Only honored when
+     * `caption !== 'title'`. Defaults derive from `minValue` / `maxValue`
+     * if set, else `[focused.year - 100, focused.year + 10]` — covers the
+     * common birthday-picker and short-term-booking ranges.
+     */
+    yearRange?: [min: number, max: number];
+    /** Override locale firstDayOfWeek (0=Sun..6=Sat). */
+    firstDayOfWeek?: DayOfWeek;
+    /** Override locale weekend marking. */
+    weekendDays?: DayOfWeek[];
+    /** Render the ISO week number column. */
+    showWeekNumbers?: boolean;
+    /** Highlight today's cell. @defaultValue true */
+    highlightToday?: boolean;
+    /** Override `NoriProvider.locale`. */
+    locale?: string;
+    /** Range mode only — minimum nights between start and end. */
+    minNights?: number;
+    /** Range mode only — maximum nights between start and end. */
+    maxNights?: number;
+    /** Custom renderer for a single day cell. */
+    renderDay?: (ctx: DayContext) => ReactNode;
+    /** Test id for the root element. */
+    testID?: string;
+    className?: string;
+    ref?: Ref<View>;
+    children?: ReactNode;
+};
+type CalendarProps<M extends CalendarMode = 'single'> = CalendarBaseProps<M>;
+
+/**
+ * Outer wrapper that measures the available container width and renders
+ * the actual Calendar root once the measurement is in. Renders nothing on
+ * the first paint to avoid the 1-month → 2-month flash; this is one
+ * synchronous re-render after layout, imperceptible in practice.
+ */
+declare const CalendarRoot: <M extends CalendarMode = "single">(props: CalendarBaseProps<M>) => react_jsx_runtime.JSX.Element;
+/**
+ * Slot wrapper for Calendar's `caption="custom"` mode. Use it to mark the
+ * subtree that renders your own month/year pickers (or any other header
+ * UI). Inside, call {@link useCalendarCaption} to read the current
+ * month/year and trigger changes.
+ *
+ * `<Calendar.Caption>` is a transparent passthrough — Calendar renders
+ * any direct children when `caption="custom"`. The wrapper exists to
+ * make the intent explicit at call sites and to give static analysis
+ * something to introspect.
+ *
+ * @example
+ * ```tsx
+ * <Calendar caption="custom">
+ *     <Calendar.Caption>
+ *         <MyMonthSelect />
+ *         <MyYearSelect />
+ *     </Calendar.Caption>
+ * </Calendar>
+ * ```
+ */
+declare const CalendarCaption: {
+    ({ children }: CalendarCaptionProps): ReactNode;
+    displayName: string;
+};
+type CalendarCaptionProps = {
+    /** Custom caption content — typically your own month / year selects. */
+    children?: ReactNode;
+};
+type CalendarComponent = typeof CalendarRoot & {
+    Caption: typeof CalendarCaption;
+};
+declare const Calendar: CalendarComponent;
+
+type CaptionOption = {
+    value: number;
+    label: string;
+    disabled: boolean;
+};
+type CaptionContextValue = {
+    /** Currently displayed month, 1..12. */
+    month: number;
+    /** Currently displayed year. */
+    year: number;
+    visibleMonth: CalendarDate;
+    /** All months a, optional disabled flag derived from min/max + isDateUnavailable. */
+    monthOptions: ReadonlyArray<CaptionOption>;
+    /** Years inside `yearRange`, optional disabled flag. */
+    yearOptions: ReadonlyArray<CaptionOption>;
+    /** Set the displayed month, 1..12. */
+    setMonth: (month: number) => void;
+    /** Set the displayed year. */
+    setYear: (year: number) => void;
+    /** Move to the previous month/year/decade depending on the current view. */
+    goPrev: () => void;
+    /** Move to the next month/year/decade depending on the current view. */
+    goNext: () => void;
+};
+/**
+ * Returns the current caption state and setters for a Calendar. Use inside
+ * a `<Calendar.Caption>` slot (or any direct child of a Calendar with
+ * `caption="custom"`) to render your own dropdowns / navigation.
+ *
+ * @throws if called outside a Calendar with `caption="custom"`.
+ */
+declare const useCalendarCaption: () => CaptionContextValue;
+
+export { Calendar, type CalendarBehavior, type CalendarCaption$1 as CalendarCaption, type CalendarCaptionProps, type ChangeMeta as CalendarChangeMeta, type CalendarMode, type CalendarProps, type CalendarValue, type CalendarView, type CaptionContextValue, type CaptionOption, type DateRange, type DayContext, useCalendarCaption };

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

@@ -0,0 +1,169 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode, Ref } from 'react';
+import { CalendarDate } from '@internationalized/date';
+import { View } from 'react-native';
+
+/**
+ * Day of week index where 0 = Sunday, 1 = Monday, ..., 6 = Saturday.
+ * Matches `Date.prototype.getDay()` semantics.
+ */
+type DayOfWeek = 0 | 1 | 2 | 3 | 4 | 5 | 6;
+
+type CalendarMode = 'single' | 'range' | 'multiple';
+type CalendarView = 'day' | 'month' | 'year';
+type CalendarBehavior = 'paged' | 'scroll';
+type CalendarCaption$1 = 'title' | 'dropdown' | 'custom';
+type DateRange = {
+    start: CalendarDate;
+    end: CalendarDate | null;
+};
+type CalendarValue<M extends CalendarMode> = M extends 'single' ? CalendarDate | null : M extends 'range' ? DateRange | null : M extends 'multiple' ? CalendarDate[] : never;
+type ChangeMeta = {
+    view: CalendarView;
+    source: 'click' | 'keyboard' | 'scroll';
+};
+type DayContext = {
+    date: CalendarDate;
+    isOutsideMonth: boolean;
+    isToday: boolean;
+    isSelected: boolean;
+    isRangeStart: boolean;
+    isRangeEnd: boolean;
+    isInRange: boolean;
+    isInPreviewRange: boolean;
+    isUnavailable: boolean;
+    isFocused: boolean;
+    isWeekend: boolean;
+};
+type CalendarBaseProps<M extends CalendarMode = 'single'> = {
+    mode?: M;
+    value?: CalendarValue<M>;
+    defaultValue?: CalendarValue<M>;
+    onChange?: (value: CalendarValue<M>, meta: ChangeMeta) => void;
+    view?: CalendarView;
+    defaultView?: CalendarView;
+    onViewChange?: (view: CalendarView) => void;
+    /** Default 'paged' on web, 'scroll' on native (Phase 2). */
+    behavior?: CalendarBehavior;
+    /** Number of calendar months side-by-side. `'auto'` = 2 on ≥768px, else 1. */
+    visibleMonths?: number | 'auto';
+    /** Inclusive minimum selectable date. */
+    minValue?: CalendarDate;
+    /** Inclusive maximum selectable date. */
+    maxValue?: CalendarDate;
+    /** Predicate marking a date unavailable (cannot be focused or selected). */
+    isDateUnavailable?: (date: CalendarDate) => boolean;
+    /**
+     * Header layout. `'title'` (default) shows a centered "May 2026 ▾"
+     * drilldown button. `'dropdown'` replaces it with `[ May ▾ ] [ 2026 ▾ ]`
+     * pickers powered by `Select`. `'custom'` hides the built-in caption
+     * and renders the Calendar's children — typically wrapped in
+     * `<Calendar.Caption>` — driving them via `useCalendarCaption()`.
+     */
+    caption?: CalendarCaption$1;
+    /**
+     * Year-dropdown bounds, inclusive. Only honored when
+     * `caption !== 'title'`. Defaults derive from `minValue` / `maxValue`
+     * if set, else `[focused.year - 100, focused.year + 10]` — covers the
+     * common birthday-picker and short-term-booking ranges.
+     */
+    yearRange?: [min: number, max: number];
+    /** Override locale firstDayOfWeek (0=Sun..6=Sat). */
+    firstDayOfWeek?: DayOfWeek;
+    /** Override locale weekend marking. */
+    weekendDays?: DayOfWeek[];
+    /** Render the ISO week number column. */
+    showWeekNumbers?: boolean;
+    /** Highlight today's cell. @defaultValue true */
+    highlightToday?: boolean;
+    /** Override `NoriProvider.locale`. */
+    locale?: string;
+    /** Range mode only — minimum nights between start and end. */
+    minNights?: number;
+    /** Range mode only — maximum nights between start and end. */
+    maxNights?: number;
+    /** Custom renderer for a single day cell. */
+    renderDay?: (ctx: DayContext) => ReactNode;
+    /** Test id for the root element. */
+    testID?: string;
+    className?: string;
+    ref?: Ref<View>;
+    children?: ReactNode;
+};
+type CalendarProps<M extends CalendarMode = 'single'> = CalendarBaseProps<M>;
+
+/**
+ * Outer wrapper that measures the available container width and renders
+ * the actual Calendar root once the measurement is in. Renders nothing on
+ * the first paint to avoid the 1-month → 2-month flash; this is one
+ * synchronous re-render after layout, imperceptible in practice.
+ */
+declare const CalendarRoot: <M extends CalendarMode = "single">(props: CalendarBaseProps<M>) => react_jsx_runtime.JSX.Element;
+/**
+ * Slot wrapper for Calendar's `caption="custom"` mode. Use it to mark the
+ * subtree that renders your own month/year pickers (or any other header
+ * UI). Inside, call {@link useCalendarCaption} to read the current
+ * month/year and trigger changes.
+ *
+ * `<Calendar.Caption>` is a transparent passthrough — Calendar renders
+ * any direct children when `caption="custom"`. The wrapper exists to
+ * make the intent explicit at call sites and to give static analysis
+ * something to introspect.
+ *
+ * @example
+ * ```tsx
+ * <Calendar caption="custom">
+ *     <Calendar.Caption>
+ *         <MyMonthSelect />
+ *         <MyYearSelect />
+ *     </Calendar.Caption>
+ * </Calendar>
+ * ```
+ */
+declare const CalendarCaption: {
+    ({ children }: CalendarCaptionProps): ReactNode;
+    displayName: string;
+};
+type CalendarCaptionProps = {
+    /** Custom caption content — typically your own month / year selects. */
+    children?: ReactNode;
+};
+type CalendarComponent = typeof CalendarRoot & {
+    Caption: typeof CalendarCaption;
+};
+declare const Calendar: CalendarComponent;
+
+type CaptionOption = {
+    value: number;
+    label: string;
+    disabled: boolean;
+};
+type CaptionContextValue = {
+    /** Currently displayed month, 1..12. */
+    month: number;
+    /** Currently displayed year. */
+    year: number;
+    visibleMonth: CalendarDate;
+    /** All months a, optional disabled flag derived from min/max + isDateUnavailable. */
+    monthOptions: ReadonlyArray<CaptionOption>;
+    /** Years inside `yearRange`, optional disabled flag. */
+    yearOptions: ReadonlyArray<CaptionOption>;
+    /** Set the displayed month, 1..12. */
+    setMonth: (month: number) => void;
+    /** Set the displayed year. */
+    setYear: (year: number) => void;
+    /** Move to the previous month/year/decade depending on the current view. */
+    goPrev: () => void;
+    /** Move to the next month/year/decade depending on the current view. */
+    goNext: () => void;
+};
+/**
+ * Returns the current caption state and setters for a Calendar. Use inside
+ * a `<Calendar.Caption>` slot (or any direct child of a Calendar with
+ * `caption="custom"`) to render your own dropdowns / navigation.
+ *
+ * @throws if called outside a Calendar with `caption="custom"`.
+ */
+declare const useCalendarCaption: () => CaptionContextValue;
+
+export { Calendar, type CalendarBehavior, type CalendarCaption$1 as CalendarCaption, type CalendarCaptionProps, type ChangeMeta as CalendarChangeMeta, type CalendarMode, type CalendarProps, type CalendarValue, type CalendarView, type CaptionContextValue, type CaptionOption, type DateRange, type DayContext, useCalendarCaption };

package/dist/components/Calendar/index.js

@@ -0,0 +1,11 @@
+export { Calendar, useCalendarCaption } from '../../chunk-X7APG7G2.js';
+import '../../chunk-ZQMNGPLE.js';
+import '../../chunk-RFW5SRZA.js';
+import '../../chunk-FT2XBBQJ.js';
+import '../../chunk-7Z4NMNX6.js';
+import '../../chunk-5A2QOOVN.js';
+import '../../chunk-CHXHRJNZ.js';
+import '../../chunk-R5JMDDCB.js';
+import '../../chunk-WCQVDF3K.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/components/Calendar/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}