@petrarca/sonnet-ui 0.5.0 → 0.6.0

package/dist/index.d.ts

@@ -9,6 +9,8 @@ import * as CollapsiblePrimitive from '@radix-ui/react-collapsible';
 import * as DialogPrimitive from '@radix-ui/react-dialog';
 import { DialogProps } from '@radix-ui/react-dialog';
 import * as DropdownMenuPrimitive from '@radix-ui/react-dropdown-menu';
+import { DatePrecision, TimeGranularity, PageResult } from '@petrarca/sonnet-core';
+import * as SelectPrimitive from '@radix-ui/react-select';
 import * as LabelPrimitive from '@radix-ui/react-label';
 import * as PopoverPrimitive from '@radix-ui/react-popover';
 import * as ScrollAreaPrimitive from '@radix-ui/react-scroll-area';
@@ -17,7 +19,6 @@ import * as TabsPrimitive from '@radix-ui/react-tabs';
 import * as TooltipPrimitive from '@radix-ui/react-tooltip';
 import { RowData, PaginationState, OnChangeFn } from '@tanstack/react-table';
 export { PaginationState } from '@tanstack/react-table';
-import { PageResult } from '@petrarca/sonnet-core';
 import { UISchema, JsonSchemaProperty, JsonSchema } from '@petrarca/sonnet-core/schema';
 import { EntitySelectMode } from '@petrarca/sonnet-core/hooks';
 import { EntityOptionFetcher, EntityOption } from '@petrarca/sonnet-core/entityOptions';
@@ -228,6 +229,144 @@ declare const DropdownMenuShortcut: {
 
 declare const Input: React$1.ForwardRefExoticComponent<Omit<React$1.DetailedHTMLProps<React$1.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref"> & React$1.RefAttributes<HTMLInputElement>>;
 
+/** Renders a field-level error message below an input. */
+declare function InputError({ error, }: {
+    error: string | undefined;
+}): React$1.ReactElement | null;
+
+/**
+ * DateInput -- text input with a calendar popover for a single date.
+ *
+ * The value is a partial ISO 8601 date string -- `"YYYY"`, `"YYYY-MM"`, or
+ * `"YYYY-MM-DD"` depending on `precision`. Typed entry is parsed leniently
+ * (see {@link parseDate}); `"t"`, `"today"`, or `"."` enter the current date;
+ * calendar selection drills down to the terminal precision. Empty value emits "".
+ */
+
+interface DateInputProps {
+    /** Partial ISO date string (`YYYY`, `YYYY-MM`, or `YYYY-MM-DD`), or "". */
+    value?: string;
+    /** Called with the new partial ISO date string, or "" when cleared. */
+    onChange: (value: string) => void;
+    /** Selection precision. Default `"day"`. */
+    precision?: DatePrecision;
+    /** BCP-47 locale override for display/parsing. Defaults to the app locale. */
+    locale?: string;
+    id?: string;
+    name?: string;
+    placeholder?: string;
+    required?: boolean;
+    disabled?: boolean;
+    error?: string;
+    className?: string;
+    onBlur?: () => void;
+}
+declare function DateInput({ value, onChange, precision, locale, id, name, placeholder, required, disabled, error, className, onBlur, }: DateInputProps): React$1.ReactElement;
+
+/**
+ * Calendar -- month/year/decade grid for selecting a single day.
+ *
+ * A controlled, dependency-light calendar operating on native `Date`. Renders
+ * three drill-down views (days, months, years) with header navigation. Styling
+ * uses semantic design tokens only.
+ */
+
+interface CalendarProps {
+    /** Currently selected day, or null. */
+    value: Date | null;
+    /** Called when the user picks a date at the terminal precision. */
+    onSelect: (date: Date) => void;
+    /** Month shown when no value is selected. Defaults to today. */
+    defaultViewDate?: Date;
+    /**
+     * Precision at which selection completes: `"year"` stops on the years view,
+     * `"month"` on the months view, `"day"` on the days view (default).
+     */
+    precision?: DatePrecision;
+    /** BCP-47 locale for month/weekday labels and week-start. */
+    locale?: string;
+}
+declare function Calendar({ value, onSelect, defaultViewDate, precision, locale, }: CalendarProps): React$1.ReactElement;
+
+/**
+ * TimeInput -- text input for a zone-free time of day.
+ *
+ * The value is a normalized ISO time string -- `"HH:mm"` (minute granularity,
+ * default) or `"HH:mm:ss"` (second granularity). A time of day carries no date
+ * and no timezone (Temporal.PlainTime); consumers that need an instant combine
+ * it with a date and zone at persistence time. Typed entry is parsed leniently
+ * (see {@link parseTime}); `"n"`, `"now"`, or `"."` enter the current time.
+ * Empty value emits "".
+ */
+
+interface TimeInputProps {
+    /** Normalized ISO time string (`"HH:mm"` or `"HH:mm:ss"`), or "". */
+    value?: string;
+    /** Called with the new normalized ISO time string, or "" when cleared. */
+    onChange: (value: string) => void;
+    /** Time granularity. Default `"minute"`. */
+    granularity?: TimeGranularity;
+    id?: string;
+    name?: string;
+    placeholder?: string;
+    required?: boolean;
+    disabled?: boolean;
+    error?: string;
+    className?: string;
+    onBlur?: () => void;
+}
+declare function TimeInput({ value, onChange, granularity, id, name, placeholder, required, disabled, error, className, onBlur, }: TimeInputProps): React$1.ReactElement;
+
+/**
+ * DateTimeInput -- combined date + time entry for a plain wall-clock datetime.
+ *
+ * The value is a plain wall-clock ISO string `"YYYY-MM-DDTHH:mm[:ss]"` with no
+ * timezone (Temporal.PlainDateTime). Timezone is intentionally not part of the
+ * input: a wall-clock datetime means "this local time", and resolving it to an
+ * absolute instant (UTC) is the consumer's responsibility at persistence time.
+ *
+ * The optional `timeZone` prop is a pass-through context value (e.g. a clinic's
+ * zone supplied programmatically) shown as a hint -- it is never applied to the
+ * value and is never entered by the user. Cross-zone apps that need an explicit
+ * zone picker should compose one separately.
+ *
+ * Composes {@link DateInput} (day precision) and {@link TimeInput}.
+ */
+
+interface DateTimeInputProps {
+    /** Plain wall-clock ISO datetime `"YYYY-MM-DDTHH:mm[:ss]"`, or "". */
+    value?: string;
+    /** Called with the new plain wall-clock ISO datetime, or "" when cleared. */
+    onChange: (value: string) => void;
+    /** Time granularity. Default `"minute"`. */
+    granularity?: TimeGranularity;
+    /**
+     * Optional timezone context (IANA id, e.g. `"Europe/Berlin"`). Shown as a
+     * hint only; never applied to the value and never user-entered.
+     */
+    timeZone?: string;
+    /** BCP-47 locale override for the date part. Defaults to the app locale. */
+    locale?: string;
+    idPrefix?: string;
+    required?: boolean;
+    disabled?: boolean;
+    error?: string;
+    className?: string;
+    onBlur?: () => void;
+}
+declare function DateTimeInput({ value, onChange, granularity, timeZone, locale, idPrefix, required, disabled, error, className, onBlur, }: DateTimeInputProps): React$1.ReactElement;
+
+declare const Select: React$1.FC<SelectPrimitive.SelectProps>;
+declare const SelectGroup: React$1.ForwardRefExoticComponent<SelectPrimitive.SelectGroupProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const SelectValue: React$1.ForwardRefExoticComponent<SelectPrimitive.SelectValueProps & React$1.RefAttributes<HTMLSpanElement>>;
+declare const SelectTrigger: React$1.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectTriggerProps & React$1.RefAttributes<HTMLButtonElement>, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
+declare const SelectScrollUpButton: React$1.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectScrollUpButtonProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+declare const SelectScrollDownButton: React$1.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectScrollDownButtonProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+declare const SelectContent: React$1.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectContentProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+declare const SelectLabel: React$1.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectLabelProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+declare const SelectItem: React$1.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectItemProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+declare const SelectSeparator: React$1.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectSeparatorProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+
 declare function InputGroup({ className, ...props }: React$1.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
 declare const inputGroupAddonVariants: (props?: ({
     align?: "inline-start" | "inline-end" | "block-start" | "block-end" | null | undefined;
@@ -1190,4 +1329,4 @@ type Props = {
  */
 declare function ClipboardMenu({ onAddItem }: Props): react_jsx_runtime.JSX.Element;
 
-export { Alert, AlertDescription, AlertTitle, Avatar, AvatarFallback, AvatarImage, Badge, type BadgeProps, Button, CELL_RENDERERS, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, type CellRenderer, type CellRendererProps, Checkbox, ClipboardButton, ClipboardItemComponent as ClipboardItem, ClipboardMenu, Collapsible, CollapsibleContent, CollapsibleTrigger, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EntitySelect, type EntitySelectProps, EntityTable, type EntityTableProps, EntityTree, type EntityTreeHandle, type EntityTreeProps, IconButton, type IconButtonProps, Input, InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, InputGroupText, InputGroupTextarea, Label, Popover, PopoverContent, PopoverTrigger, PropertyList, type PropertyListLayout, type PropertyListProps, PropertyValue, type PropertyValueProps, ResizeHandle, type ResizeHandleProps, type ResolvedColumn, type RowAction, ScrollArea, ScrollBar, SearchInput, type SearchMode, Separator, Sheet, SheetBody, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetTitle, SheetTrigger, SimpleGroup, SimpleStack, SimpleTooltip, Skeleton, Spinner, Stepper, StepperContent, StepperDescription, StepperIndicator, StepperItem, StepperList, StepperNext, StepperPrev, type StepperProps, StepperSeparator, StepperTitle, StepperTrigger, type TableUiSchema, Tabs, TabsContent, TabsList, TabsSeparator, TabsTrigger, Textarea, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, type TreeNode, TreeView, type TreeViewHandle, type TreeViewProps, badgeVariants, buttonVariants, createRenderer, useStore as useStepper };
+export { Alert, AlertDescription, AlertTitle, Avatar, AvatarFallback, AvatarImage, Badge, type BadgeProps, Button, CELL_RENDERERS, Calendar, type CalendarProps, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, type CellRenderer, type CellRendererProps, Checkbox, ClipboardButton, ClipboardItemComponent as ClipboardItem, ClipboardMenu, Collapsible, CollapsibleContent, CollapsibleTrigger, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, DateInput, type DateInputProps, DateTimeInput, type DateTimeInputProps, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EntitySelect, type EntitySelectProps, EntityTable, type EntityTableProps, EntityTree, type EntityTreeHandle, type EntityTreeProps, IconButton, type IconButtonProps, Input, InputError, InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, InputGroupText, InputGroupTextarea, Label, Popover, PopoverContent, PopoverTrigger, PropertyList, type PropertyListLayout, type PropertyListProps, PropertyValue, type PropertyValueProps, ResizeHandle, type ResizeHandleProps, type ResolvedColumn, type RowAction, ScrollArea, ScrollBar, SearchInput, type SearchMode, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Sheet, SheetBody, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetTitle, SheetTrigger, SimpleGroup, SimpleStack, SimpleTooltip, Skeleton, Spinner, Stepper, StepperContent, StepperDescription, StepperIndicator, StepperItem, StepperList, StepperNext, StepperPrev, type StepperProps, StepperSeparator, StepperTitle, StepperTrigger, type TableUiSchema, Tabs, TabsContent, TabsList, TabsSeparator, TabsTrigger, Textarea, TimeInput, type TimeInputProps, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, type TreeNode, TreeView, type TreeViewHandle, type TreeViewProps, badgeVariants, buttonVariants, createRenderer, useStore as useStepper };