@boxcustodia/library 2.0.0-alpha.8 → 2.0.0-alpha.9

package/dist/index.d.ts

@@ -214,7 +214,9 @@ export declare type BaseEntity = {
     createdAt: Date;
 };
 
-declare type BaseProps = {
+declare type BaseProps = FormPrimitive.Props;
+
+declare type BaseProps_2 = {
     icon?: React.ReactNode;
     rounded?: TagVariant["rounded"];
 } & StyleProps & React.HTMLAttributes<HTMLDivElement>;
@@ -348,19 +350,14 @@ export { CheckboxPrimitive }
 declare interface CheckboxProps extends Omit<CheckboxPrimitive.Root.Props, "children"> {
     children?: ReactNode;
     label?: ReactNode;
-    description?: ReactNode;
-    error?: FieldErrorProp;
     tooltip?: ReactNode;
     indicatorProps?: CheckboxPrimitive.Indicator.Props;
     controlFirst?: boolean;
-    invalid?: boolean;
-    touched?: boolean;
-    dirty?: boolean;
 }
 
 export declare function CheckboxRoot({ className, ...props }: CheckboxPrimitive.Root.Props): React_2.ReactElement;
 
-declare function CheckboxSingle({ children, label, description, error, tooltip, className, indicatorProps, controlFirst, required, name, invalid, touched, dirty, ...props }: CheckboxProps): React_2.ReactElement;
+declare function CheckboxSingle({ className, indicatorProps, label, children, tooltip, controlFirst, required, id, ...props }: CheckboxProps): React_2.ReactElement;
 
 export declare type ClassName = string | undefined;
 
@@ -368,7 +365,7 @@ export declare const click: (element: HTMLElement) => void;
 
 export declare type ClickEvent = React.MouseEvent<HTMLButtonElement, MouseEvent>;
 
-declare type ClosableProps = BaseProps & {
+declare type ClosableProps = BaseProps_2 & {
     closable: true;
     onClose: () => void;
 };
@@ -667,7 +664,9 @@ declare interface ExtendedProps_2 {
  */
 export declare const extractInitials: (string: string) => string;
 
-export declare function Field({ label, required, tooltip, description, error, controlFirst, children, className, invalid: invalidProp, ...props }: FieldProps): JSX.Element;
+export declare function Field({ label, description, error, required, tooltip, inline, children, className, labelProps, descriptionProps, errorProps, ...rootProps }: FieldProps): JSX.Element;
+
+export declare const FieldControl: typeof FieldPrimitive.Control;
 
 export declare function FieldDescription({ className, ...props }: FieldPrimitive.Description.Props): JSX.Element;
 
@@ -675,27 +674,51 @@ export declare function FieldError({ className, ...props }: FieldPrimitive.Error
 
 export declare type FieldErrorItem = {
     message: ReactNode;
-    match: NonNullable<FieldErrorMatch>;
+    match?: NonNullable<FieldErrorMatch>;
 };
 
 export declare type FieldErrorMatch = FieldPrimitive.Error.Props["match"];
 
 export declare type FieldErrorProp = string | FieldErrorItem | FieldErrorItem[];
 
+export declare function FieldItem({ className, ...props }: FieldPrimitive.Item.Props): JSX.Element;
+
 export declare function FieldLabel({ className, ...props }: FieldPrimitive.Label.Props): JSX.Element;
 
 export { FieldPrimitive }
 
-export declare interface FieldProps extends FieldPrimitive.Root.Props {
+export declare interface FieldProps extends Omit<FieldPrimitive.Root.Props, "children"> {
+    /** Text rendered inside `FieldLabel`. */
     label?: ReactNode;
-    required?: boolean;
-    tooltip?: ReactNode;
+    /** Helper text rendered below the control. */
     description?: ReactNode;
+    /**
+     * Error message(s) rendered below the control:
+     * - `string` → always renders once the field is invalid.
+     * - `{ message, match }` → renders only when the `ValidityState` key matches.
+     * - `FieldErrorItem[]` → multiple errors with individual matches.
+     */
     error?: FieldErrorProp;
-    controlFirst?: boolean;
+    /** Shows a red asterisk after the label text. */
+    required?: boolean;
+    /** Renders an info icon with a tooltip next to the label. */
+    tooltip?: ReactNode;
+    /**
+     * Renders the control before the label on the same row.
+     * Use for single checkboxes and switches.
+     */
+    inline?: boolean;
+    children?: ReactNode;
+    labelProps?: FieldPrimitive.Label.Props;
+    descriptionProps?: FieldPrimitive.Description.Props;
+    errorProps?: Omit<FieldPrimitive.Error.Props, "match" | "children">;
 }
 
-export declare function FieldRoot({ className, ...props }: FieldPrimitive.Root.Props): JSX.Element;
+export declare function FieldRoot({ className, required, ...props }: FieldPrimitive.Root.Props & {
+    required?: boolean;
+}): JSX.Element;
+
+export declare const FieldValidity: typeof FieldPrimitive.Validity;
 
 declare type FileError = {
     file: File;
@@ -735,10 +758,15 @@ export declare const FileTypeGroups: Record<string, FileTypeValue[]>;
 
 export declare type FileTypeValue = (typeof FileType)[keyof typeof FileType];
 
-export declare function Form({ className, ...props }: FormPrimitive.Props): default_2.ReactElement;
+export declare function Form({ onSubmit, onFormSubmit, className, ...props }: FormProps): default_2.ReactElement;
 
 export { FormPrimitive }
 
+export declare interface FormProps extends Omit<BaseProps, "onSubmit" | "onFormSubmit"> {
+    onSubmit?: BaseProps["onFormSubmit"];
+    onFormSubmit?: BaseProps["onFormSubmit"];
+}
+
 export declare interface GenericMenuProps {
     trigger: default_2.ReactNode;
     items: MenuItemType[];
@@ -773,25 +801,14 @@ declare type HotkeyOptions = {
 
 export declare type ID = string | number;
 
-export declare function Input({ className, label, tooltip, description, error, required, name, invalid, touched, dirty, ...inputProps }: InputProps): JSX.Element;
+export declare function Input({ className, nativeInput, onChange, ...props }: InputProps): JSX.Element;
 
 export { InputPrimitive }
 
-export declare interface InputProps extends InputRootProps {
-    label?: ReactNode;
-    tooltip?: ReactNode;
-    description?: ReactNode;
-    error?: FieldErrorProp;
-    invalid?: boolean;
-    touched?: boolean;
-    dirty?: boolean;
-}
-
-export declare function InputRoot({ className, onChange, ...props }: InputRootProps): JSX.Element;
-
-export declare interface InputRootProps extends Omit<InputPrimitive.Props, "onChange" | "size"> {
+export declare type InputProps = Omit<InputPrimitive.Props, "size" | "onChange"> & {
     onChange?: (value: string, event: ChangeEvent<HTMLInputElement>) => void;
-}
+    nativeInput?: boolean;
+};
 
 declare interface ItemTimeline {
     content?: ReactNode;
@@ -1022,7 +1039,7 @@ declare type Mutation<TArgs extends any[], TReturn> = (...args: TArgs) => Promis
 
 declare type NavigationProps = Pick<CalendarNavigationProps, "goNextProps" | "goBackProps" | "changeViewProps">;
 
-declare type NonClosableProps = BaseProps & {
+declare type NonClosableProps = BaseProps_2 & {
     closable?: false;
     onClose?: never;
 };
@@ -1056,27 +1073,15 @@ declare interface PaginationOptionProps extends ButtonHTMLAttributes<HTMLButtonE
     isActive?: boolean;
 }
 
-export declare function Password({ label, tooltip, description, error, required, name, invalid, touched, dirty, ...passwordProps }: PasswordProps): JSX.Element;
+export declare function PasswordRoot({ className, showIcon, hideIcon, onShow, onHide, toggleable, onChange, ...rest }: PasswordRootProps): JSX.Element;
 
-export declare interface PasswordProps extends PasswordRootProps {
-    label?: ReactNode;
-    tooltip?: ReactNode;
-    description?: ReactNode;
-    error?: FieldErrorProp;
-    invalid?: boolean;
-    touched?: boolean;
-    dirty?: boolean;
-}
-
-export declare function PasswordRoot({ className, showIcon, hideIcon, onShow, onHide, toggleable, ...rest }: PasswordRootProps): JSX.Element;
-
-export declare interface PasswordRootProps extends InputRootProps {
+export declare type PasswordRootProps = Omit<InputProps, "unstyled" | "nativeInput"> & {
     showIcon?: ReactNode;
     hideIcon?: ReactNode;
     onShow?: () => void;
     onHide?: () => void;
     toggleable?: boolean;
-}
+};
 
 export declare const Popover: (props: Props_14) => JSX.Element;