@apliteni/apliteni-ui 0.77.0 → 0.79.0

package/react/dist/index.d.ts

@@ -325,6 +325,69 @@ type DeniedProps = {
 };
 declare function Denied({ title, sub, need, icon, className, children, }: DeniedProps): react.JSX.Element;
 
+/**
+ * `'month'` and `'range'` work in whole months, `'day'` and `'day-range'` in
+ * whole dates. The two range modes behave alike: a start, then an end, with the
+ * days or months between them shown as the span.
+ */
+type DatePickerMode = 'month' | 'range' | 'day' | 'day-range';
+/** Either end may be null while the reader is still picking. */
+type DatePickerRange = {
+    start: string | null;
+    end: string | null;
+};
+type DatePickerPreset = {
+    label: string;
+    range: DatePickerRange;
+};
+type DatePickerProps = {
+    mode?: DatePickerMode;
+    /** `'YYYY-MM'` in month mode, `'YYYY-MM-DD'` in day mode. Controlled. */
+    value?: string | null;
+    /** Where an uncontrolled picker starts. */
+    defaultValue?: string | null;
+    onChange?: (value: string | null) => void;
+    /** Range mode, controlled. */
+    range?: DatePickerRange;
+    defaultRange?: DatePickerRange;
+    /** Fires on each end, so a half-picked range is visible to the host too. */
+    onRangeChange?: (range: DatePickerRange) => void;
+    /** Bounds, inclusive, in the mode's own grain. */
+    min?: string;
+    max?: string;
+    /** Periods that cannot be picked, in the mode's own grain. */
+    disabledPeriods?: readonly string[];
+    /** Range mode: the shortcuts beside the grid. */
+    presets?: readonly DatePickerPreset[];
+    placeholder?: string;
+    /**
+     * Names the trigger and the panel where the screen around them does not.
+     * With a value, the trigger's own text is already its name.
+     */
+    ariaLabel?: string;
+    id?: string;
+    disabled?: boolean;
+    /** The edge the panel hugs. */
+    align?: 'start' | 'end';
+    /** Month and weekday names come from here. */
+    locale?: string;
+    /** 0 is Sunday. Day mode only. */
+    weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+    /** `'YYYY-MM-DD'`. Given one, the grid marks it; stories and tests pass it to stay fixed. */
+    today?: string;
+    /**
+     * Render the sheet rather than the popover whatever the viewport is. Left
+     * out, the picker follows the kit's narrowest step. A host that already knows
+     * it is on a phone — or renders on a server, where no viewport is readable —
+     * says so here.
+     */
+    sheet?: boolean;
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+};
+declare function DatePicker({ mode, value, defaultValue, onChange, range, defaultRange, onRangeChange, min, max, disabledPeriods, presets, placeholder, ariaLabel, id, disabled, align, locale, weekStartsOn, today, sheet, open: openProp, defaultOpen, onOpenChange, }: DatePickerProps): react.JSX.Element;
+
 type DropdownBadge = string | {
     text: string;
     tone?: string;
@@ -607,6 +670,47 @@ type FileFieldProps = FieldMessage & Omit<InputHTMLAttributes<HTMLInputElement>,
 };
 declare function FileField({ label, hint, error, required, disabled, onFileChange, className, ...props }: FileFieldProps): react.JSX.Element;
 
+type FileDropStatus = 'uploading' | 'done' | 'error';
+/** The file the consumer is uploading. */
+type FileDropFile = {
+    name: string;
+    /** Already written for a reader; the kit picks no unit. */
+    size?: string;
+    /** Left out, the file is uploading: the kit never reports a success nobody claimed. */
+    status?: FileDropStatus;
+    /** 0 to 100. Left out, the word stands without a bar. */
+    progress?: number;
+    /** What this file did wrong, when the status is an error. */
+    error?: string;
+    /** Replaces the word the status carries. */
+    state?: string;
+};
+type FileDropProps = {
+    /** The button that opens the picker. */
+    label?: string;
+    /** The accepted types and the size limit, stated once beside the button. */
+    note?: string;
+    /** Filters the system picker only; the consumer still validates the file. */
+    accept?: string;
+    /** The words on the drop target. */
+    dropLabel?: string;
+    /** Names the icon-only remove button; it carries no visible word. */
+    removeLabel?: string;
+    retryLabel?: string;
+    /** The file the consumer is holding. Left out, the row is at rest. */
+    file?: FileDropFile | null;
+    /** Drives the target from a parent that owns the drag region. */
+    dragging?: boolean;
+    disabled?: boolean;
+    onFile?: (file: File) => void;
+    onRemove?: () => void;
+    onRetry?: () => void;
+    /** What the region accepts the file for; the target covers it while dragging. */
+    children?: ReactNode;
+    className?: string;
+};
+declare function FileDrop({ label, note, accept, dropLabel, removeLabel, retryLabel, file, dragging, disabled, onFile, onRemove, onRetry, children, className, }: FileDropProps): react.JSX.Element;
+
 type SearchFieldProps = Omit<InputHTMLAttributes<HTMLInputElement>, 'type' | 'aria-label'> & {
     /** The control's name. A toolbar search box shows no label, so this is the
         only name it has. */
@@ -827,4 +931,4 @@ declare const SidebarNav: react.ForwardRefExoticComponent<Omit<Omit<react.Detail
 declare const PAGE_SIZES: readonly number[];
 declare const DEFAULT_PAGE_SIZE: number;
 
-export { AppShell, type AppShellProps, type AppShellSection, BackLink, type BackLinkOwnProps, type BackLinkProps, Badge, BusyRegion, type BusyRegionProps, Button, type ButtonLinkProps, type ButtonProps, Callout, type CalloutProps, type CalloutVariant, Card, Checkbox, type CheckboxProps, type Column, type CommandGroup, type CommandItem, CommandPalette, type CommandPaletteProps, Confirm, type ConfirmProps, DEFAULT_PAGE_SIZE, DataTable, type DataTableProps, DeltaValue, type DeltaValueProps, Denied, type DeniedProps, Drawer, type DrawerProps, DrawerSection, type DrawerSectionProps, Dropdown, type DropdownBadge, type DropdownEntry, type DropdownItem, type DropdownProps, type DropdownRowProps, type DropdownSearch, type DropdownSection, type DropdownSeparator, EmptyState, type EmptyStateProps, type EmptyStateVariant, Field, type FieldControlProps, type FieldProps, FileField, type FileFieldProps, type Filter, FilterBar, type FilterBarProps, Icon, KeyValueList, type KeyValueListProps, type KeyValueRow, Modal, type ModalProps, type NativeButtonProps, NumericValue, type NumericValueProps, PAGE_SIZES, Pagination, type PaginationProps, Pill, type PillProps, RowIdentity, type RowIdentityProps, SearchField, type SearchFieldProps, type SegmentOption, Segmented, type SegmentedProps, SelectField, type SelectFieldProps, SidebarNav, type SidebarNavBadge, type SidebarNavItem, type SidebarNavLeaf, type SidebarNavProps, type SidebarNavSection, Skeleton, type SkeletonProps, SkeletonTable, type SkeletonTableProps, Snippet, type SnippetProps, StatBand, type StatBandProps, type StatDelta, type StatFigure, type StatTone, type StatVariant, StatusDot, type StatusDotProps, Success, SuccessCheck, type SuccessCheckProps, type SuccessCountdown, SuccessPanel, type SuccessPanelProps, type SuccessProps, Switch, type SwitchProps, THEME_INIT_SCRIPT, type TabItem, type TableSort, Tabs, type TabsProps, TextArea, type TextAreaProps, TextField, type TextFieldProps, ThemeToggle, type ThemeToggleProps, Timeline, type TimelineEvent, type TimelineEventKind, type TimelineProps, Toast, type ToastNotice, type ToastProps, Tooltip, type TooltipProps, sortTableRows, useToast };
+export { AppShell, type AppShellProps, type AppShellSection, BackLink, type BackLinkOwnProps, type BackLinkProps, Badge, BusyRegion, type BusyRegionProps, Button, type ButtonLinkProps, type ButtonProps, Callout, type CalloutProps, type CalloutVariant, Card, Checkbox, type CheckboxProps, type Column, type CommandGroup, type CommandItem, CommandPalette, type CommandPaletteProps, Confirm, type ConfirmProps, DEFAULT_PAGE_SIZE, DataTable, type DataTableProps, DatePicker, type DatePickerMode, type DatePickerPreset, type DatePickerProps, type DatePickerRange, DeltaValue, type DeltaValueProps, Denied, type DeniedProps, Drawer, type DrawerProps, DrawerSection, type DrawerSectionProps, Dropdown, type DropdownBadge, type DropdownEntry, type DropdownItem, type DropdownProps, type DropdownRowProps, type DropdownSearch, type DropdownSection, type DropdownSeparator, EmptyState, type EmptyStateProps, type EmptyStateVariant, Field, type FieldControlProps, type FieldProps, FileDrop, type FileDropFile, type FileDropProps, type FileDropStatus, FileField, type FileFieldProps, type Filter, FilterBar, type FilterBarProps, Icon, KeyValueList, type KeyValueListProps, type KeyValueRow, Modal, type ModalProps, type NativeButtonProps, NumericValue, type NumericValueProps, PAGE_SIZES, Pagination, type PaginationProps, Pill, type PillProps, RowIdentity, type RowIdentityProps, SearchField, type SearchFieldProps, type SegmentOption, Segmented, type SegmentedProps, SelectField, type SelectFieldProps, SidebarNav, type SidebarNavBadge, type SidebarNavItem, type SidebarNavLeaf, type SidebarNavProps, type SidebarNavSection, Skeleton, type SkeletonProps, SkeletonTable, type SkeletonTableProps, Snippet, type SnippetProps, StatBand, type StatBandProps, type StatDelta, type StatFigure, type StatTone, type StatVariant, StatusDot, type StatusDotProps, Success, SuccessCheck, type SuccessCheckProps, type SuccessCountdown, SuccessPanel, type SuccessPanelProps, type SuccessProps, Switch, type SwitchProps, THEME_INIT_SCRIPT, type TabItem, type TableSort, Tabs, type TabsProps, TextArea, type TextAreaProps, TextField, type TextFieldProps, ThemeToggle, type ThemeToggleProps, Timeline, type TimelineEvent, type TimelineEventKind, type TimelineProps, Toast, type ToastNotice, type ToastProps, Tooltip, type TooltipProps, sortTableRows, useToast };