@nimbus-ds/patterns 1.20.1 → 1.21.0

package/dist/index.d.ts

@@ -6,7 +6,7 @@ import { BoxBaseProps, BoxProperties, BoxProps, ButtonProperties, ButtonProps, C
 import { IconProps } from '@nimbus-ds/icons';
 import { PolymorphicForwardRefComponent } from '@nimbus-ds/typings';
 import React from 'react';
-import { ButtonHTMLAttributes, CSSProperties, ComponentProps, ComponentPropsWithRef, FC, HTMLAttributes, MouseEventHandler, PropsWithChildren, ReactElement, ReactNode } from 'react';
+import { ButtonHTMLAttributes, CSSProperties, ComponentProps, ComponentPropsWithRef, FC, HTMLAttributes, MouseEvent, MouseEventHandler, PropsWithChildren, ReactElement, ReactNode } from 'react';
 import { DayPicker } from 'react-day-picker';
 
 export interface AppShellHeaderProperties {
@@ -313,7 +313,7 @@ declare const FormFieldSelect: React.ForwardRefExoticComponent<Pick<FormFieldSel
 export type FormFieldSelectProps = ComponentPropsWithRef<typeof FormField.Select>;
 export type FormFieldTextareaProperties = Omit<FormFieldProperties, "children"> & Omit<TextareaProperties, "appearance">;
 export type FormFieldTextareaBaseProps = FormFieldTextareaProperties & Omit<TextareaProps, "appearance"> & HTMLAttributes<HTMLElement>;
-declare const FormFieldTextarea: React.ForwardRefExoticComponent<Pick<FormFieldTextareaBaseProps, keyof React.HTMLAttributes<HTMLElement> | "width" | "height" | "form" | "label" | "pattern" | "key" | "max" | "min" | "name" | "type" | "crossOrigin" | "alt" | "src" | "autoFocus" | "disabled" | "formAction" | "formEncType" | "formMethod" | "formNoValidate" | "formTarget" | "value" | "autoComplete" | "accept" | "capture" | "checked" | "enterKeyHint" | "list" | "maxLength" | "minLength" | "multiple" | "readOnly" | "required" | "size" | "step" | "cols" | "dirName" | "rows" | "wrap" | "appearance" | "helpText" | "helpIcon" | "showHelpText" | "lines"> & React.RefAttributes<HTMLTextAreaElement>>;
+declare const FormFieldTextarea: React.ForwardRefExoticComponent<Pick<FormFieldTextareaBaseProps, keyof React.HTMLAttributes<HTMLElement> | "width" | "height" | "form" | "label" | "pattern" | "key" | "max" | "min" | "name" | "type" | "crossOrigin" | "alt" | "src" | "autoFocus" | "disabled" | "formAction" | "formEncType" | "formMethod" | "formNoValidate" | "formTarget" | "value" | "autoComplete" | "accept" | "capture" | "checked" | "enterKeyHint" | "list" | "maxLength" | "minLength" | "multiple" | "readOnly" | "required" | "size" | "step" | "cols" | "dirName" | "rows" | "wrap" | "appearance" | "helpText" | "helpIcon" | "showHelpText" | "lines" | "autoGrow" | "maxLines" | "minLines" | "resize"> & React.RefAttributes<HTMLTextAreaElement>>;
 export type FormFieldTextareaProps = ComponentPropsWithRef<typeof FormField.Textarea>;
 export type FormFieldInputProperties = Omit<FormFieldProperties, "children"> & Omit<InputProperties, "appearance"> & {
 	appearance?: FormFieldProperties["appearance"] | InputProperties["appearance"];
@@ -1311,6 +1311,83 @@ export interface ProductDataListComponents {
 	ItemDivider: typeof ProductDataListItemDivider;
 }
 export declare const ProductDataList: React.FC<ProductDataListProps> & ProductDataListComponents;
+export interface ChatInputActionsProperties {
+	/**
+	 * Content to be rendered at both sides of the actions bar.
+	 * @TJS-type React.ReactNode
+	 */
+	children: ReactNode;
+}
+export type ChatInputActionsProps = ChatInputActionsProperties & Omit<BoxProperties, "children" | "display" | "justifyContent" | "alignItems"> & HTMLAttributes<HTMLElement>;
+export type ChatInputFieldProperties = Omit<TextareaProperties, "appearance"> & {
+	/**
+	 * Predefined appearance values for AI states. When `"ai-generative"` is passed,
+	 * the field displays the Nimbus AI generative border and focus ring.
+	 */
+	appearance?: "none" | "danger" | "warning" | "success" | "ai-generative";
+};
+export type ChatInputFieldBaseProps = ChatInputFieldProperties & Omit<TextareaProps, "appearance"> & HTMLAttributes<HTMLElement>;
+export interface ChatInputPopoverProperties {
+	/**
+	 * Content to be rendered inside the popover, usually ChatInput.PopoverButton components.
+	 * @TJS-type React.ReactNode
+	 */
+	content: ReactNode;
+	contentProperties?: Omit<BoxProperties, "children" | "display" | "flexDirection" | "gap">;
+	/**
+	 * The trigger element that opens the popover, usually an IconButton.
+	 * @TJS-type React.ReactNode
+	 */
+	children: ReactNode;
+}
+export type ChatInputPopoverProps = ChatInputPopoverProperties & Omit<PopoverProperties, "content" | "children" | "arrow" | "position" | "padding" | "color">;
+export interface ChatInputPopoverButtonProperties {
+	/**
+	 * Icon element to be displayed before the text.
+	 * @TJS-type React.ReactNode
+	 */
+	icon?: ReactNode;
+	/**
+	 * The text content of the button.
+	 */
+	text: ReactNode;
+	/**
+	 * Click handler for the button.
+	 */
+	onClick?: (event: MouseEvent<HTMLButtonElement>) => void;
+}
+export type ChatInputPopoverButtonProps = ChatInputPopoverButtonProperties & Omit<BoxProperties, "children" | "as" | "type" | "cursor" | "borderWidth" | "color" | "display" | "alignItems" | "gap" | "p" | "borderRadius" | "onClick">;
+export interface ChatInputComponents {
+	/**
+	 * ChatInput Actions is a container for the actions, like send button and recording button.
+	 */
+	Actions: React.FC<ChatInputActionsProps>;
+	/**
+	 * ChatInput Field textarea component.
+	 */
+	Field: React.ForwardRefExoticComponent<ChatInputFieldBaseProps & React.RefAttributes<HTMLTextAreaElement>>;
+	/**
+	 * ChatInput Popover provides pre-configured popover settings for upload actions.
+	 */
+	Popover: React.FC<ChatInputPopoverProps>;
+	/**
+	 * ChatInput PopoverButton is a pre-styled button for popover menu items.
+	 */
+	PopoverButton: React.FC<ChatInputPopoverButtonProps>;
+}
+export interface ChatInputProperties {
+	/**
+	 * Content to be rendered inside ChatInput, usually `ChatInput.Actions` and `ChatInput.Field`.
+	 * @TJS-type React.ReactNode
+	 */
+	children: ReactNode;
+	/**
+	 * Whether the ChatInput is focused for AI states.
+	 */
+	aiFocused?: boolean;
+}
+export type ChatInputProps = ChatInputProperties & Omit<BoxProperties, "children" | "display"> & HTMLAttributes<HTMLElement>;
+export declare const ChatInput: React.FC<ChatInputProps> & ChatInputComponents;
 export interface MenuExpandContextValue {
 	/** True when the menu is expanded; false when collapsed. */
 	expanded: boolean;