@oniratec/onira-react-ui 1.0.2 → 1.0.4

package/dist/index.d.ts

@@ -1,6 +1,8 @@
 import { ComponentType } from 'react';
 import * as DropdownMenuPrimitive from '@radix-ui/react-dropdown-menu';
 import { FC } from 'react';
+import { FieldPath } from 'react-hook-form';
+import { FieldValues } from 'react-hook-form';
 import { ForwardRefExoticComponent } from 'react';
 import { ImgHTMLAttributes } from 'react';
 import { InputHTMLAttributes } from 'react';
@@ -12,6 +14,40 @@ import { RefAttributes } from 'react';
 import * as SelectPrimitive from '@radix-ui/react-select';
 import { SlotProps } from '@radix-ui/react-slot';
 import * as TooltipPrimitive from '@radix-ui/react-tooltip';
+import { UseFormReturn } from 'react-hook-form';
+import { z } from 'zod';
+
+declare type BaseField<T extends FieldValues> = {
+    name: FieldPath<T>;
+    label: string;
+    kind: FieldKind;
+    placeholder?: string;
+    className?: string;
+    options?: Option_2[];
+    /**
+     * Zod schema for this field.
+     * If not provided, it will default to optional.
+     */
+    schema?: z.ZodTypeAny;
+    /**
+     * Default value for this field.
+     */
+    defaultValue?: unknown;
+    /**
+     * Normalize value before storing it in form state.
+     */
+    normalize?: (value: unknown) => unknown;
+    /**
+     * Cross-field dependencies.
+     */
+    deps?: FieldDependency<T>;
+    /**
+     * Conditional visibility.
+     */
+    hidden?: (values: Partial<T>) => boolean;
+    /** Grid layout helpers */
+    colSpan?: 1 | 2 | 3 | 4;
+};
 
 declare type BaseProps = {
     children: ReactNode;
@@ -22,6 +58,10 @@ export declare const Box: ({ children, }: Readonly<{
     children: ReactNode;
 }>) => JSX.Element;
 
+export declare function buildDefaultValues<TFormModel extends FieldValues, TEntity>(config: FormFactoryConfig<TFormModel, TEntity>, ctx: DefaultValuesContext<TEntity>): Partial<TFormModel>;
+
+export declare function buildZodSchema<TFormModel extends FieldValues, TEntity>(config: FormFactoryConfig<TFormModel, TEntity>): z.ZodTypeAny;
+
 export declare const Button: React_2.ForwardRefExoticComponent<ButtonProps & React_2.RefAttributes<HTMLButtonElement>>;
 
 export declare interface ButtonProps extends React_2.ButtonHTMLAttributes<HTMLButtonElement> {
@@ -48,12 +88,18 @@ declare type Column<T> = {
     className?: string;
 };
 
+declare type CrossRule<T extends FieldValues> = (values: T, ctx: z.RefinementCtx) => void;
+
 export declare const darkTheme: Theme;
 
 export declare function DataTable<T>({ columns, data }: Props<T>): JSX.Element;
 
 export declare const defaultTheme: Theme;
 
+declare interface DefaultValuesContext<TEntity> {
+    entity?: TEntity;
+}
+
 export declare const DropdownMenu: React_2.FC<DropdownMenuPrimitive.DropdownMenuProps>;
 
 export declare const DropdownMenuCheckboxItem: React_2.ForwardRefExoticComponent<Omit<DropdownMenuPrimitive.DropdownMenuCheckboxItemProps & React_2.RefAttributes<HTMLDivElement>, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
@@ -95,6 +141,16 @@ declare interface FieldContextValue {
 
 export declare const FieldControl: ForwardRefExoticComponent<Omit<SlotProps & RefAttributes<HTMLElement>, "ref"> & RefAttributes<HTMLElement>>;
 
+declare type FieldDependency<T extends FieldValues> = {
+    /**
+     * Fields to revalidate when this field changes.
+     * Required for cross-field validation (superRefine).
+     */
+    onChangeTrigger?: FieldPath<T>[];
+};
+
+declare type FieldKind = 'input' | 'password' | 'textarea' | 'select' | 'toggle' | 'checkbox';
+
 export declare const FieldLabel: React_2.ForwardRefExoticComponent<React_2.LabelHTMLAttributes<HTMLLabelElement> & React_2.RefAttributes<HTMLLabelElement>>;
 
 export declare const FieldMessage: React_2.ForwardRefExoticComponent<React_2.HTMLAttributes<HTMLParagraphElement> & React_2.RefAttributes<HTMLParagraphElement>>;
@@ -104,6 +160,14 @@ declare interface FieldProps extends React_2.HTMLAttributes<HTMLDivElement> {
     required?: boolean;
 }
 
+export declare interface FormFactoryConfig<TFormModel extends FieldValues, TEntity = unknown> {
+    defaultValues?: (ctx: DefaultValuesContext<TEntity>) => Partial<TFormModel>;
+    sections: Section<TFormModel>[];
+    crossRules?: CrossRule<TFormModel>[];
+}
+
+export declare function FormFactoryRenderer<TFormModel extends FieldValues, TEntity>({ config, form, onSubmitAction, submitLabel, maxWidthClass, }: Props_4<TFormModel, TEntity>): JSX.Element;
+
 export declare const Input: React_2.ForwardRefExoticComponent<InputProps & React_2.RefAttributes<HTMLInputElement>>;
 
 declare interface InputProps extends Omit<React_2.InputHTMLAttributes<HTMLInputElement>, 'crossOrigin' | 'dangerouslySetInnerHTML'> {
@@ -114,6 +178,15 @@ declare interface InputProps extends Omit<React_2.InputHTMLAttributes<HTMLInputE
     isInvalid?: boolean;
 }
 
+declare type Layout = {
+    kind: 'single';
+} | {
+    kind: 'grid';
+    cols?: 1 | 2 | 3 | 4;
+    mdCols?: 1 | 2 | 3 | 4;
+    gap?: string;
+};
+
 export declare const lightTheme: Theme;
 
 export declare const Logo: ({ src, alt, width, height, className, ImageComponent, ...props }: LogoProps) => JSX.Element;
@@ -138,6 +211,11 @@ declare type NotFoundStateProps = {
     fallbackIcon?: ReactNode;
 };
 
+declare type Option_2<T extends string | number = string> = {
+    value: T;
+    label: string;
+};
+
 export declare const PageSizeSelector: ({ value, onChange, options }: Props_2) => JSX.Element;
 
 export declare const Pagination: ({ page, pageSize, total, onPageChange, onPageSizeChange }: Props_3) => JSX.Element;
@@ -181,8 +259,33 @@ declare interface Props_3 {
     onPageSizeChange: (size: number) => void;
 }
 
+declare interface Props_4<TFormModel extends FieldValues, TEntity> {
+    config: FormFactoryConfig<TFormModel, TEntity>;
+    form: UseFormReturn<TFormModel>;
+    onSubmitAction: (data: TFormModel) => void | Promise<void>;
+    submitLabel: string;
+    maxWidthClass?: string;
+}
+
+declare type Section<T extends FieldValues> = {
+    title: string;
+    description?: string;
+    layout?: Layout;
+    fields: Array<BaseField<T> | BaseField<T>[]>;
+};
+
 export declare const Select: React_2.FC<SelectPrimitive.SelectProps>;
 
+export declare const SelectContent: React_2.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectContentProps & React_2.RefAttributes<HTMLDivElement>, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare const SelectItem: React_2.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectItemProps & React_2.RefAttributes<HTMLDivElement>, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare const SelectTrigger: React_2.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectTriggerProps & React_2.RefAttributes<HTMLButtonElement>, "ref"> & {
+    hasError?: boolean;
+} & React_2.RefAttributes<HTMLButtonElement>>;
+
+export declare const SelectValue: React_2.ForwardRefExoticComponent<SelectPrimitive.SelectValueProps & React_2.RefAttributes<HTMLSpanElement>>;
+
 export declare function Skeleton({ className }: SkeletonProps): JSX.Element;
 
 declare type SkeletonProps = {