@kazee-ds/react 0.6.0 → 0.8.0

package/dist/types/date-range-model.d.ts

@@ -27,7 +27,9 @@ export interface DateRangeOptions extends DateRangeConstraints {
     dir?: 'ltr' | 'rtl';
     visibleMonths?: 1 | 2;
     weekStartsOn?: 0 | 1;
-    display?: 'popover' | 'inline';
+    display?: 'popover' | 'inline' | 'dialog' | 'auto';
+    commitMode?: 'apply' | 'immediate';
+    showActions?: boolean;
     showInputs?: boolean;
     showMonthYearPicker?: boolean;
     triggerDisplay?: 'text' | 'icon';

package/dist/types/index.d.ts

@@ -36,7 +36,12 @@ export type { NumberFieldProps } from './NumberField.js';
 export { Card } from './Card.js';
 export type { CardProps } from './Card.js';
 export { Badge } from './Badge.js';
-export type { BadgeProps, BadgeTone } from './Badge.js';
+export type { BadgeProps, BadgeTone, BadgeVariant } from './Badge.js';
+export { Avatar, AvatarRoot, AvatarImage, AvatarFallback, AvatarBadge } from './Avatar.js';
+export type { AvatarProps, AvatarImageProps, AvatarFallbackProps, AvatarBadgeProps, } from './Avatar.js';
+export { AvatarGroup, AvatarGroupRoot, AvatarGroupCount } from './AvatarGroup.js';
+export type { AvatarGroupProps } from './AvatarGroup.js';
+export type { Tone, ComponentSize, IndicatorPlacement, AvatarVariant, ImageLoadingStatus, } from './visual.js';
 export { Skeleton } from './Skeleton.js';
 export type { SkeletonProps } from './Skeleton.js';
 export { Separator } from './Separator.js';
@@ -112,3 +117,16 @@ export type { SidebarRootProps, DataTableRootProps } from './layout-parts.js';
 export { ToastRoot, ToastIndicator, ToastBody, ToastTitle, ToastDescription, ToastActions, ToastActionButton, ToastCloseButton, ToastProgress, } from './Toast.js';
 export { DropdownItemIndicator, DropdownSubmenuTrigger, DropdownSubmenuIndicator, } from './structural-parts.js';
 export { DataTableColumn as DataTableColumnPart, DataTableEmpty } from './layout-parts.js';
+export { Calendar, RangeCalendar, MonthPicker, YearPicker, MonthYearNavigation, } from './Calendar.js';
+export type { CalendarProps, RangeCalendarProps, MonthPickerProps, YearPickerProps, MonthYearNavigationProps, } from './Calendar.js';
+export { DateField, TimeField, DateTimeField, DateRangeField, TimeRangeField, DateTimeRangeField, } from './TemporalField.js';
+export type { TemporalFieldProps, TemporalRangeFieldProps } from './TemporalField.js';
+export { TimeList, TimeClock } from './TimeControls.js';
+export type { TimeControlProps } from './TimeControls.js';
+export { DatePicker, TimePicker, TimeRangePicker, DateTimePicker, DateTimeRangePicker, } from './TemporalPicker.js';
+export type { TemporalPickerProps, TemporalPickerOptions, TemporalPreset, TemporalValue, } from './TemporalPicker.js';
+export type { TemporalConstraints, TemporalRange, TemporalKind, TemporalError, } from './temporal-model.js';
+export { SwitchGroup } from './switch-visual.js';
+export type { SwitchVisualProps } from './switch-visual.js';
+export { InputClearButton } from './input-clear.js';
+export type { CardInteractionProps } from './Card.js';

package/dist/types/input-clear.d.ts

@@ -0,0 +1,24 @@
+import { type RefObject, type ButtonHTMLAttributes } from 'react';
+export declare const InputClearContext: import("react").Context<{
+    value: string;
+    disabled?: boolean;
+    readOnly?: boolean;
+    clear: () => void;
+} | null>;
+export declare function useClearableInput({ value, defaultValue, onChange, isDisabled, isReadOnly, }: {
+    value?: string;
+    defaultValue?: string;
+    onChange?: (value: string) => void;
+    isDisabled?: boolean;
+    isReadOnly?: boolean;
+}, element: RefObject<HTMLElement | null>): {
+    value: string;
+    update: (next: string) => void;
+    context: {
+        value: string;
+        disabled: boolean | undefined;
+        readOnly: boolean | undefined;
+        clear: () => void;
+    };
+};
+export declare function InputClearButton({ className, children, onClick, ...props }: ButtonHTMLAttributes<HTMLButtonElement>): import("react").JSX.Element | null;

package/dist/types/switch-visual.d.ts

@@ -0,0 +1,21 @@
+import { type HTMLAttributes } from 'react';
+import type { Tone, ComponentSize } from './visual.js';
+export interface SwitchVisualProps {
+    size?: ComponentSize;
+    tone?: Tone;
+    variant?: 'default' | 'outline';
+}
+export declare const SwitchVisualContext: import("react").Context<SwitchVisualProps & {
+    isDisabled?: boolean;
+}>;
+export declare function SwitchGroup({ size, tone, variant, isDisabled, orientation, className, ...props }: HTMLAttributes<HTMLDivElement> & SwitchVisualProps & {
+    label?: string;
+    orientation?: 'horizontal' | 'vertical';
+    isDisabled?: boolean;
+}): import("react").JSX.Element;
+export declare function useSwitchVisual(props: SwitchVisualProps): {
+    size: ComponentSize;
+    tone: Tone;
+    variant: "default" | "outline";
+    disabled: boolean | undefined;
+};

package/dist/types/temporal-model.d.ts

@@ -0,0 +1,44 @@
+export type TemporalKind = 'date' | 'time' | 'datetime';
+export interface TemporalRange {
+    start: string;
+    end: string;
+}
+export type TemporalError = 'invalid' | 'required' | 'incomplete' | 'order' | 'bounds' | 'unavailable' | 'step';
+export interface TemporalConstraints {
+    kind: TemporalKind;
+    minDate?: string;
+    maxDate?: string;
+    minTime?: string;
+    maxTime?: string;
+    minDateTime?: string;
+    maxDateTime?: string;
+    isDateUnavailable?: (date: string) => boolean;
+    isTimeUnavailable?: (time: string) => boolean;
+    isRequired?: boolean;
+    hourStep?: number;
+    minuteStep?: number;
+    secondStep?: number;
+    granularity?: 'hour' | 'minute' | 'second';
+    timeZone?: string;
+    disambiguation?: 'compatible' | 'earlier' | 'later' | 'reject';
+}
+/** Wall time is resolved explicitly; DST gaps/overlaps reject by default. */
+export declare function toZonedValue(value: string, timeZone?: string, disambiguation?: TemporalConstraints['disambiguation']): string;
+export declare function toLocalValue(value: string, timeZone?: string, seconds?: boolean): string;
+export declare function temporalError(value: string | null, options: TemporalConstraints): TemporalError | null;
+export declare function temporalRangeError(value: TemporalRange | null, options: TemporalConstraints): TemporalError | null;
+/** Project instant boundaries into the selected display zone for disabled calendar/time options. */
+export declare function temporalDisplayBounds(options: TemporalConstraints, selectedDate?: string): {
+    minDate: string | undefined;
+    maxDate: string | undefined;
+    minTime: string | undefined;
+    maxTime: string | undefined;
+};
+/** Minute-granularity list; seconds are edited with TimeField/TimeClock to avoid 86k DOM options. */
+export declare function timeChoices(options: TemporalConstraints): string[];
+/** User edits zero units hidden by the configured field granularity. */
+export declare function normalizeTime(value: string, granularity?: TemporalConstraints['granularity']): string;
+export declare function normalizeWallDateTime(value: string, granularity?: TemporalConstraints['granularity']): string;
+/** Keep the selected unit and choose the nearest complete valid time for the other units. */
+export declare function resolveTimeUnit(value: string, part: 'hour' | 'minute' | 'second', selected: number, options: TemporalConstraints): string | null;
+export declare function temporalMessages(locale?: string): Record<TemporalError, string>;

package/dist/types/toggle-group-model.d.ts

@@ -4,6 +4,6 @@ export interface ToggleGroupItem {
     isDisabled?: boolean;
 }
 export type ToggleGroupMode = 'single' | 'multiple';
-export type ToggleGroupVariant = 'outline' | 'ghost';
+export type ToggleGroupVariant = 'outline' | 'ghost' | 'chip';
 /** Normalize IDs without discarding existing disabled selections. */
 export declare function toggleIds(value: unknown, items: ToggleGroupItem[], multiple: boolean): string[];

package/dist/types/visual-slot.d.ts

@@ -0,0 +1,3 @@
+import { type ReactElement, type ReactNode } from 'react';
+/** Decorate one child while preserving its handlers and ref. */
+export declare function visualSlot(children: ReactNode, props: Record<string, unknown>): ReactElement<Record<string, unknown>, string | import("react").JSXElementConstructor<any>>;

package/dist/types/visual.d.ts

@@ -0,0 +1,5 @@
+export type Tone = 'neutral' | 'primary' | 'info' | 'success' | 'warning' | 'danger';
+export type ComponentSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+export type IndicatorPlacement = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+export type AvatarVariant = 'default' | 'soft';
+export type ImageLoadingStatus = 'idle' | 'loading' | 'loaded' | 'error';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kazee-ds/react",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "type": "module",
   "exports": {
     ".": {