@allxsmith/bestax-bulma 5.26.5 → 5.26.6

package/dist/types/form/Numberinput.d.ts

@@ -45,7 +45,14 @@ export interface NumberinputProps extends Omit<React.InputHTMLAttributes<HTMLInp
     controlsRounded?: boolean;
     /** Uses compact button spacing. */
     compact?: boolean;
-    /** Removes button borders and background. */
+    /**
+     * Renders the plusminus controls without a `.field` row of their own, so
+     * they join the row of a `Field` with `hasAddons` or `grouped` they sit
+     * in. On by default inside a `Field`, unless a `Control` is anywhere above
+     * it: a `Control` stacks its children, so there the controls keep their
+     * own row.
+     * @defaultValue auto
+     */
     bare?: boolean;
     /** Style variant for the control buttons. */
     variant?: NumberinputVariant;

package/dist/types/form/_pickerInternals/Calendar.d.ts

@@ -1,9 +1,8 @@
 import React from 'react';
-import { DateGranularity, DayOfWeek, PickerLabels } from './pickerTypes.js';
-export interface CalendarProps {
-    value: Date | null;
+import { DateGranularity, DateRangeValue, DayOfWeek, PickerLabels } from './pickerTypes.js';
+/** What every calendar takes, whichever way it picks. */
+interface CalendarBaseProps {
     focusedDate: Date;
-    onSelect: (d: Date) => void;
     onFocusedDateChange: (d: Date) => void;
     /**
      * Earliest selectable date. One before year 1, or none, counts as the start
@@ -47,6 +46,48 @@ export interface CalendarProps {
      */
     granularity?: DateGranularity;
 }
+/** A calendar that picks one day, month or year. */
+interface CalendarSingleProps {
+    /** The selected date. */
+    value: Date | null;
+    /** Called with a picked date, or the first day of a picked period. */
+    onSelect: (d: Date) => void;
+    range?: never;
+    onRangeSelect?: never;
+    allowDisabledInRange?: never;
+}
+/** A calendar that picks a range of days. */
+interface CalendarRangeProps {
+    /**
+     * The committed range, start first, which turns on range mode. The day grid
+     * then picks two days: the first pick marks a start inside the calendar and
+     * commits nothing, and the second calls `onRangeSelect` with both ends. A
+     * pick that cannot end the range starts a new one instead: one before the
+     * start, or one past a disabled day unless `allowDisabledInRange` is set.
+     * While a start is pending the grid previews the range to the hovered day,
+     * or to the focused day, and hides the committed one. A range with a start
+     * and no end opens with that start pending. Escape takes back a pending pick
+     * and stops there, so a popover around the calendar stays open; a pending
+     * start that came from `range` is not a pick, and Escape goes on.
+     */
+    range: DateRangeValue;
+    /** Called with both ends once the second day is picked. */
+    onRangeSelect: (start: Date, end: Date) => void;
+    /**
+     * Let a range include days that `shouldDisableDate` or `unselectableDates`
+     * disable. Its ends can still not be such days.
+     */
+    allowDisabledInRange?: boolean;
+    /** Only the day grid picks a range. */
+    granularity?: 'day';
+    value?: never;
+    onSelect?: never;
+}
+/**
+ * The calendar picks one date through `value` and `onSelect`, or a range
+ * through `range` and `onRangeSelect`, and its props take exactly one pair.
+ */
+export type CalendarProps = CalendarBaseProps & (CalendarSingleProps | CalendarRangeProps);
 /**
  * Selects the calendar's focused cell, the one tab stop of whichever grid or
  * year list is on show, for a popover to put focus on as it opens. It runs

package/dist/types/form/_pickerInternals/dateUtils.d.ts

@@ -60,6 +60,23 @@ export declare function isDayUnselectable(d: Date, c: DayConstraints): boolean;
  * of 3pm on a month's last day leaves that day, and so its month, selectable.
  */
 export declare function isPeriodUnselectable(d: Date, granularity: DateGranularity, c: DayConstraints): boolean;
+/**
+ * The most days {@link canCloseRange} walks between a range's ends, about
+ * eleven years. A span it would have to walk further is refused, so the check
+ * stays cheap enough to run on every pointer move over the calendar.
+ */
+export declare const RANGE_WALK_LIMIT = 4000;
+/**
+ * Whether `end` can close a range that opens on `start`: it falls on `start`'s
+ * day or later, and, unless `allowDisabled`, no day between the two is one
+ * that `shouldDisableDate` or `unselectableDates` disables. Checking that
+ * walks the days between, so with either rule set and `allowDisabled` off,
+ * an `end` more than {@link RANGE_WALK_LIMIT} days after `start` is refused.
+ * The ends' own constraints, `min` and `max` among them, are the caller's to
+ * check. Bounds can't fall between two days inside them, so they are not
+ * walked.
+ */
+export declare function canCloseRange(start: Date, end: Date, c: DayConstraints, allowDisabled?: boolean): boolean;
 export declare function addDays(d: Date, n: number): Date;
 export declare function addMonths(d: Date, n: number): Date;
 export declare function addYears(d: Date, n: number): Date;

package/dist/types/form/_pickerInternals/pickerTypes.d.ts

@@ -3,6 +3,11 @@ export type HourFormat = '12' | '24';
 export type DayOfWeek = 0 | 1 | 2 | 3 | 4 | 5 | 6;
 /** The unit a date picker selects: a day, a month or a year. */
 export type DateGranularity = 'day' | 'month' | 'year';
+/**
+ * A range of days, start first. Either end may be `null` while the range is
+ * half filled, and `[null, null]` is empty.
+ */
+export type DateRangeValue = [Date | null, Date | null];
 /**
  * Translatable strings used across all four pickers. Pass via the `labels`
  * prop to override defaults; consumers manage their own locale-driven mapping.
@@ -19,6 +24,15 @@ export interface PickerLabels {
     chooseMonth?: string;
     /** Launcher, popover and year list name when the picker selects a year. */
     chooseYear?: string;
+    /** Range picking: names the start of a range, in the calendar and the field. */
+    rangeStart?: string;
+    /** Range picking: names the end of a range, in the calendar and the field. */
+    rangeEnd?: string;
+    /**
+     * Range picking: describes the day a pending range would end on, the one
+     * the pointer or the keyboard is on, until it is picked.
+     */
+    rangePreviewEnd?: string;
     hours?: string;
     minutes?: string;
     seconds?: string;

package/dist/types/helpers/statusRegion.d.ts

@@ -13,6 +13,7 @@ export declare const announceDelay = 100;
  * again.
  */
 export declare const announcementLifetime = 1000;
+export declare const visuallyHidden: React.CSSProperties;
 /**
  * Reads an element out roughly the way a screen reader would: its text, with
  * an element's `aria-label`, or an image's `alt`, standing in for what's

package/dist/types-cjs/form/Numberinput.d.ts

@@ -45,7 +45,14 @@ export interface NumberinputProps extends Omit<React.InputHTMLAttributes<HTMLInp
     controlsRounded?: boolean;
     /** Uses compact button spacing. */
     compact?: boolean;
-    /** Removes button borders and background. */
+    /**
+     * Renders the plusminus controls without a `.field` row of their own, so
+     * they join the row of a `Field` with `hasAddons` or `grouped` they sit
+     * in. On by default inside a `Field`, unless a `Control` is anywhere above
+     * it: a `Control` stacks its children, so there the controls keep their
+     * own row.
+     * @defaultValue auto
+     */
     bare?: boolean;
     /** Style variant for the control buttons. */
     variant?: NumberinputVariant;

package/dist/types-cjs/form/_pickerInternals/Calendar.d.ts

@@ -1,9 +1,8 @@
 import React from 'react';
-import { DateGranularity, DayOfWeek, PickerLabels } from './pickerTypes.js';
-export interface CalendarProps {
-    value: Date | null;
+import { DateGranularity, DateRangeValue, DayOfWeek, PickerLabels } from './pickerTypes.js';
+/** What every calendar takes, whichever way it picks. */
+interface CalendarBaseProps {
     focusedDate: Date;
-    onSelect: (d: Date) => void;
     onFocusedDateChange: (d: Date) => void;
     /**
      * Earliest selectable date. One before year 1, or none, counts as the start
@@ -47,6 +46,48 @@ export interface CalendarProps {
      */
     granularity?: DateGranularity;
 }
+/** A calendar that picks one day, month or year. */
+interface CalendarSingleProps {
+    /** The selected date. */
+    value: Date | null;
+    /** Called with a picked date, or the first day of a picked period. */
+    onSelect: (d: Date) => void;
+    range?: never;
+    onRangeSelect?: never;
+    allowDisabledInRange?: never;
+}
+/** A calendar that picks a range of days. */
+interface CalendarRangeProps {
+    /**
+     * The committed range, start first, which turns on range mode. The day grid
+     * then picks two days: the first pick marks a start inside the calendar and
+     * commits nothing, and the second calls `onRangeSelect` with both ends. A
+     * pick that cannot end the range starts a new one instead: one before the
+     * start, or one past a disabled day unless `allowDisabledInRange` is set.
+     * While a start is pending the grid previews the range to the hovered day,
+     * or to the focused day, and hides the committed one. A range with a start
+     * and no end opens with that start pending. Escape takes back a pending pick
+     * and stops there, so a popover around the calendar stays open; a pending
+     * start that came from `range` is not a pick, and Escape goes on.
+     */
+    range: DateRangeValue;
+    /** Called with both ends once the second day is picked. */
+    onRangeSelect: (start: Date, end: Date) => void;
+    /**
+     * Let a range include days that `shouldDisableDate` or `unselectableDates`
+     * disable. Its ends can still not be such days.
+     */
+    allowDisabledInRange?: boolean;
+    /** Only the day grid picks a range. */
+    granularity?: 'day';
+    value?: never;
+    onSelect?: never;
+}
+/**
+ * The calendar picks one date through `value` and `onSelect`, or a range
+ * through `range` and `onRangeSelect`, and its props take exactly one pair.
+ */
+export type CalendarProps = CalendarBaseProps & (CalendarSingleProps | CalendarRangeProps);
 /**
  * Selects the calendar's focused cell, the one tab stop of whichever grid or
  * year list is on show, for a popover to put focus on as it opens. It runs

package/dist/types-cjs/form/_pickerInternals/dateUtils.d.ts

@@ -60,6 +60,23 @@ export declare function isDayUnselectable(d: Date, c: DayConstraints): boolean;
  * of 3pm on a month's last day leaves that day, and so its month, selectable.
  */
 export declare function isPeriodUnselectable(d: Date, granularity: DateGranularity, c: DayConstraints): boolean;
+/**
+ * The most days {@link canCloseRange} walks between a range's ends, about
+ * eleven years. A span it would have to walk further is refused, so the check
+ * stays cheap enough to run on every pointer move over the calendar.
+ */
+export declare const RANGE_WALK_LIMIT = 4000;
+/**
+ * Whether `end` can close a range that opens on `start`: it falls on `start`'s
+ * day or later, and, unless `allowDisabled`, no day between the two is one
+ * that `shouldDisableDate` or `unselectableDates` disables. Checking that
+ * walks the days between, so with either rule set and `allowDisabled` off,
+ * an `end` more than {@link RANGE_WALK_LIMIT} days after `start` is refused.
+ * The ends' own constraints, `min` and `max` among them, are the caller's to
+ * check. Bounds can't fall between two days inside them, so they are not
+ * walked.
+ */
+export declare function canCloseRange(start: Date, end: Date, c: DayConstraints, allowDisabled?: boolean): boolean;
 export declare function addDays(d: Date, n: number): Date;
 export declare function addMonths(d: Date, n: number): Date;
 export declare function addYears(d: Date, n: number): Date;

package/dist/types-cjs/form/_pickerInternals/pickerTypes.d.ts

@@ -3,6 +3,11 @@ export type HourFormat = '12' | '24';
 export type DayOfWeek = 0 | 1 | 2 | 3 | 4 | 5 | 6;
 /** The unit a date picker selects: a day, a month or a year. */
 export type DateGranularity = 'day' | 'month' | 'year';
+/**
+ * A range of days, start first. Either end may be `null` while the range is
+ * half filled, and `[null, null]` is empty.
+ */
+export type DateRangeValue = [Date | null, Date | null];
 /**
  * Translatable strings used across all four pickers. Pass via the `labels`
  * prop to override defaults; consumers manage their own locale-driven mapping.
@@ -19,6 +24,15 @@ export interface PickerLabels {
     chooseMonth?: string;
     /** Launcher, popover and year list name when the picker selects a year. */
     chooseYear?: string;
+    /** Range picking: names the start of a range, in the calendar and the field. */
+    rangeStart?: string;
+    /** Range picking: names the end of a range, in the calendar and the field. */
+    rangeEnd?: string;
+    /**
+     * Range picking: describes the day a pending range would end on, the one
+     * the pointer or the keyboard is on, until it is picked.
+     */
+    rangePreviewEnd?: string;
     hours?: string;
     minutes?: string;
     seconds?: string;

package/dist/types-cjs/helpers/statusRegion.d.ts

@@ -13,6 +13,7 @@ export declare const announceDelay = 100;
  * again.
  */
 export declare const announcementLifetime = 1000;
+export declare const visuallyHidden: React.CSSProperties;
 /**
  * Reads an element out roughly the way a screen reader would: its text, with
  * an element's `aria-label`, or an image's `alt`, standing in for what's