@factorialco/f0-react 2.32.1 → 2.33.0

package/dist/f0.d.ts

@@ -59,6 +59,7 @@ import { F0FormDefinition as F0FormDefinition_2 } from './f0';
 import { F0FormDefinitionPerSection as F0FormDefinitionPerSection_2 } from './f0';
 import { F0FormDefinitionSingleSchema as F0FormDefinitionSingleSchema_2 } from './f0';
 import { F0GridStackProps as F0GridStackProps_2 } from './F0GridStack';
+import { F0NumberInputProps as F0NumberInputProps_2 } from './F0NumberInput';
 import { F0SelectProps as F0SelectProps_2 } from './types';
 import { F0TagBalanceProps } from './types';
 import { F0TagCompanyProps } from './types';
@@ -67,6 +68,8 @@ import { F0TagPersonProps as F0TagPersonProps_2 } from './types';
 import { F0TagRawProps } from './types';
 import { F0TagStatusProps } from './types';
 import { F0TagTeamProps } from './types';
+import { F0TextAreaInputProps as F0TextAreaInputProps_2 } from './F0TextAreaInput';
+import { F0TextInputProps as F0TextInputProps_2 } from './F0TextInput';
 import { F0TimelineRowProps as F0TimelineRowProps_2 } from './types';
 import { f1Colors } from '@factorialco/f0-core';
 import { FC } from 'react';
@@ -86,9 +89,11 @@ import { GroupMasonryProps } from './groups/GroupMasonry';
 import { HourDistributionCellValue as HourDistributionCellValue_2 } from './types/hourDistribution';
 import { HTMLAttributeAnchorTarget } from 'react';
 import { HTMLAttributes } from 'react';
+import { HTMLInputTypeAttribute } from 'react';
 import { IconCellValue } from './types/icon';
 import { ImgHTMLAttributes } from 'react';
 import { InFilterOptions } from './InFilter/types';
+import { InputFieldProps as InputFieldProps_2 } from './f0';
 import { internalAvatarColors as internalAvatarColors_2 } from './f0';
 import { internalAvatarSizes as internalAvatarSizes_2 } from './f0';
 import { internalAvatarTypes as internalAvatarTypes_2 } from './f0';
@@ -147,6 +152,7 @@ import { TagVariant as TagVariant_2 } from './F0Tag';
 import { TeamCellValue } from './f0';
 import { TeamCellValue as TeamCellValue_2 } from './types/team';
 import { TeamItemProps } from './types';
+import { TextareaHTMLAttributes } from 'react';
 import { TextCellValue } from './f0';
 import { TextCellValue as TextCellValue_2 } from './types/text';
 import { TrackReferenceOrPlaceholder } from '@livekit/components-react';
@@ -5788,7 +5794,7 @@ export declare type F0AiInsightCardProps = {
     onAskOne?: () => void;
 } & AiInsightCardContent;
 
-declare type F0AiInsightCardPublicProps = Omit<CardInternalProps_2, (typeof privateProps_5)[number]>;
+declare type F0AiInsightCardPublicProps = Omit<CardInternalProps_2, (typeof privateProps_7)[number]>;
 
 export declare class F0AiMask {
     readonly element: HTMLElement;
@@ -8901,6 +8907,15 @@ export declare type F0NumberField = F0BaseField & F0NumberConfig & {
  */
 export declare type F0NumberFieldConfig<R extends Record<string, unknown> = Record<string, unknown>> = F0NumberInputConfig | F0NumberMoneyConfig | F0NumberSelectConfig<R> | F0DurationFieldConfig;
 
+/**
+ * @experimental This is an experimental component, use it at your own risk.
+ *
+ * F0NumberInput is the writable numeric field for forms — a box where the
+ * user types a number. For arbitrary text use F0TextInput; for durations
+ * (hours/minutes) use F0DurationInput.
+ */
+export declare const F0NumberInput: (props: F0NumberInputProps) => JSX_2.Element;
+
 /**
  * Config for number fields - number input
  */
@@ -8908,6 +8923,8 @@ declare type F0NumberInputConfig = F0BaseConfig & F0NumberConfig & {
     fieldType?: "number" | "percentage";
 };
 
+export declare type F0NumberInputProps = Omit<NumberInputInternalProps, (typeof privateProps_4)[number]>;
+
 /**
  * Config for money fields - number input with currency suffix
  */
@@ -9176,6 +9193,27 @@ export declare type F0RichTextFieldConfig = F0BaseConfig & F0RichTextConfig & {
     fieldType: "richtext";
 };
 
+/**
+ * @experimental This is an experimental component, use it at your own risk.
+ *
+ * F0SearchInput is the writable search field — a single-line text input
+ * pre-configured with a search icon, `role="searchbox"`, debouncing, and
+ * an optional minimum-length threshold before emitting changes.
+ */
+export declare const F0SearchInput: ForwardRefExoticComponent<    {
+value?: string;
+threshold?: number;
+debounceTime?: number;
+autoFocus?: boolean;
+} & Pick<InputFieldProps<string>, "onChange" | "name" | "size" | "onFocus" | "onBlur" | "loading" | "disabled" | "placeholder" | "clearable"> & RefAttributes<HTMLInputElement>>;
+
+export declare type F0SearchInputProps = {
+    value?: string;
+    threshold?: number;
+    debounceTime?: number;
+    autoFocus?: boolean;
+} & Pick<InputFieldProps<string>, "size" | "loading" | "clearable" | "placeholder" | "disabled" | "onBlur" | "onFocus" | "onChange" | "name">;
+
 /**
  * Action button configuration for a section.
  * Provide either onClick for a button action or href for a link.
@@ -9599,6 +9637,17 @@ export declare type F0TextareaField = F0BaseField & F0TextareaConfig & {
     renderIf?: TextareaFieldRenderIf;
 };
 
+/**
+ * @experimental This is an experimental component, use it at your own risk.
+ *
+ * F0TextAreaInput is the writable multi-line text field for forms — a box
+ * where the user types longer text spanning multiple lines. For a single
+ * line of text use F0TextInput.
+ */
+export declare const F0TextAreaInput: FC<F0TextAreaInputProps>;
+
+export declare type F0TextAreaInputProps = Pick<ComponentProps<typeof Textarea_2>, "disabled" | "onChange" | "value" | "placeholder" | "rows" | "cols" | "label" | "labelIcon" | "icon" | "hideLabel" | "maxLength" | "clearable" | "onBlur" | "onFocus" | "name" | "status" | "hint" | "error" | "size" | "loading" | "required" | "maxHeight">;
+
 /**
  * F0 config options specific to text fields
  */
@@ -9618,6 +9667,18 @@ export declare type F0TextField = F0BaseField & F0TextConfig & {
     renderIf?: TextFieldRenderIf;
 };
 
+/**
+ * @experimental This is an experimental component, use it at your own risk.
+ *
+ * F0TextInput is the writable text field for forms — a box where the user
+ * types text, numbers (as text), passwords, emails, etc. It is the canonical
+ * "text input" of F0. For numeric or duration data prefer F0NumberInput or
+ * F0DurationInput respectively.
+ */
+export declare const F0TextInput: <T extends string>(props: F0TextInputProps<T>) => JSX_2.Element;
+
+export declare type F0TextInputProps<T extends string> = Omit<InputInternalProps<T>, (typeof privateProps_5)[number]>;
+
 export declare type F0TextProps = Omit<TextProps, "className" | "variant" | "as"> & {
     variant?: (typeof _allowedVariants_2)[number];
     as?: TextTags;
@@ -9924,6 +9985,24 @@ export declare interface F0ZodType<T extends ZodTypeAny = ZodTypeAny> {
     _innerSchema: T;
 }
 
+/**
+ * @deprecated Renamed to `F0SearchInput` to match the F0 input vocabulary
+ * (any component where the user types in a box has the `Input` suffix and
+ * lives under the `Inputs/` group). The `F1` prefix was also legacy. Will
+ * be removed once consumers have migrated.
+ *
+ *   - import { F1SearchBox } from "@factorialco/f0-react"
+ *   + import { F0SearchInput } from "@factorialco/f0-react"
+ *
+ * @removeIn 2.0.0
+ */
+export declare const F1SearchBox: ForwardRefExoticComponent<    {
+value?: string;
+threshold?: number;
+debounceTime?: number;
+autoFocus?: boolean;
+} & Pick<InputFieldProps_2<string>, "onChange" | "name" | "size" | "onFocus" | "onBlur" | "loading" | "disabled" | "placeholder" | "clearable"> & RefAttributes<HTMLInputElement>>;
+
 export declare type FeedbackConfig = {
     threadId: string;
     onThumbsUp: (msg: AIMessage, ctx: {
@@ -10908,6 +10987,21 @@ export declare interface InitialFile {
  */
 export declare function injectSectionEnds(items: FlatFormItem[], inSectionQuestionIds: Set<string>): FlatFormItem[];
 
+/**
+ * @deprecated Renamed to `F0TextInput` to match the F0 input vocabulary
+ * (any component where the user types text in a box has the `Input` suffix
+ * and lives under the `Inputs/` group). Will be removed once consumers have
+ * migrated. Update your imports:
+ *
+ *   - import { Input } from "@factorialco/f0-react"
+ *   + import { F0TextInput } from "@factorialco/f0-react"
+ *
+ * @removeIn 2.0.0
+ */
+export declare const Input: <T extends string>(props: F0TextInputProps_2<T>) => JSX_2.Element;
+
+declare const Input_2: React_2.ForwardRefExoticComponent<Omit<React_2.InputHTMLAttributes<HTMLInputElement>, "onChange" | "size"> & Pick<InputFieldProps<string>, "label" | "onChange" | "size" | "icon" | "role" | "onFocus" | "onBlur" | "transparent" | "status" | "loading" | "disabled" | "maxLength" | "required" | "error" | "append" | "hideLabel" | "hint" | "labelIcon" | "onClickContent" | "readonly" | "clearable" | "autocomplete" | "onClear" | "isEmpty" | "emptyValue" | "hideMaxLength" | "appendTag" | "lengthProvider" | "buttonToggle"> & React_2.RefAttributes<HTMLInputElement>>;
+
 declare const INPUTFIELD_SIZES: readonly ["sm", "md"];
 
 declare type InputFieldInheritedProps = (typeof inputFieldInheritedProps)[number];
@@ -11001,6 +11095,17 @@ declare const inputFieldStatus: readonly ["default", "warning", "info", "error"]
 
 declare type InputFieldStatusType = (typeof inputFieldStatus)[number];
 
+declare type InputInternalProps<T extends string> = Pick<ComponentProps<typeof Input_2>, "ref" | "id" | "aria-describedby" | "aria-invalid"> & Pick<InputFieldProps<T>, "autoFocus" | "required" | "disabled" | "size" | "onChange" | "value" | "placeholder" | "clearable" | "maxLength" | "label" | "labelIcon" | "icon" | "hideLabel" | "name" | "error" | "status" | "hint" | "autocomplete" | "buttonToggle" | "hideMaxLength" | "loading" | "transparent" | "onBlur" | "readonly"> & {
+    type?: Exclude<HTMLInputTypeAttribute, "number">;
+    onPressEnter?: () => void;
+};
+
+/**
+ * @deprecated Renamed to `F0TextInputProps`. See the `Input` deprecation note.
+ * @removeIn 2.0.0
+ */
+export declare type InputProps<T extends string> = F0TextInputProps_2<T>;
+
 declare interface InsertAfterNotesTextEditorPageDocumentPatch {
     type: "insert_after";
     targetId: string;
@@ -11746,6 +11851,55 @@ declare type NumberFilterValue = {
     };
 } | undefined;
 
+/**
+ * @deprecated Renamed to `F0NumberInput` to match the F0 input vocabulary
+ * (any component where the user types in a box has the `Input` suffix and
+ * lives under the `Inputs/` group). Will be removed once consumers have
+ * migrated.
+ *
+ *   - import { NumberInput } from "@factorialco/f0-react"
+ *   + import { F0NumberInput } from "@factorialco/f0-react"
+ *
+ * @removeIn 2.0.0
+ */
+export declare const NumberInput: (props: F0NumberInputProps_2) => JSX_2.Element;
+
+declare type NumberInputInternalProps = Omit<InputInternalProps<string>, "value" | "type" | "onChange"> & {
+    locale: string;
+    value?: number | null;
+    step?: number;
+    min?: number;
+    max?: number;
+    maxDecimals?: number;
+    onChange?: (value: number | null) => void;
+    units?: string;
+    extraContent?: ReactNode;
+    inputWidth?: string;
+    popover?: NumberInputPopoverConfig;
+};
+
+export declare interface NumberInputPopoverConfig {
+    icon?: IconType;
+    side?: "top" | "bottom" | "left" | "right";
+    align?: "start" | "center" | "end";
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    triggerLabel?: string;
+    commitMode?: "immediate" | "deferred";
+    apply?: {
+        label?: string;
+        icon?: IconType;
+        closeOnApply?: boolean;
+    };
+}
+
+/**
+ * @deprecated Renamed to `F0NumberInputProps`. See the `NumberInput`
+ * deprecation note.
+ * @removeIn 2.0.0
+ */
+export declare type NumberInputProps = F0NumberInputProps_2;
+
 /**
  * Base for number-specific conditions
  */
@@ -11998,7 +12152,7 @@ export declare interface OneCalendarInternalProps {
     weekStartsOn?: WeekStartsOn;
 }
 
-export declare type OneCalendarProps = Omit<OneCalendarInternalProps, (typeof privateProps_4)[number]>;
+export declare type OneCalendarProps = Omit<OneCalendarInternalProps, (typeof privateProps_6)[number]>;
 
 export declare const OneEllipsis: default_2.ForwardRefExoticComponent<OneEllipsisProps & default_2.RefAttributes<HTMLElement>>;
 
@@ -12407,9 +12561,13 @@ declare const privateProps_2: readonly ["withBorder"];
 
 declare const privateProps_3: readonly ["forceVerticalMetadata", "disableOverlayLink"];
 
-declare const privateProps_4: readonly ["compact"];
+declare const privateProps_4: readonly ["buttonToggle"];
+
+declare const privateProps_5: readonly ["buttonToggle"];
+
+declare const privateProps_6: readonly ["compact"];
 
-declare const privateProps_5: readonly ["className"];
+declare const privateProps_7: readonly ["className"];
 
 export declare const ProductBlankslate: WithDataTestIdReturnType_4<ForwardRefExoticComponent<ProductBlankslateProps & RefAttributes<HTMLDivElement>>>;
 
@@ -13901,11 +14059,37 @@ export declare type TeamAvatarVariant = Extract<AvatarVariant, {
 
 declare type TeamTagProps = ComponentProps<typeof F0TagTeam>;
 
+/**
+ * @deprecated Renamed to `F0TextAreaInput` to match the F0 input vocabulary
+ * (any component where the user types in a box has the `Input` suffix and
+ * lives under the `Inputs/` group). Will be removed once consumers have
+ * migrated.
+ *
+ *   - import { Textarea } from "@factorialco/f0-react"
+ *   + import { F0TextAreaInput } from "@factorialco/f0-react"
+ *
+ * @removeIn 2.0.0
+ */
+export declare const Textarea: FC<F0TextAreaInputProps_2>;
+
+declare const Textarea_2: ForwardRefExoticComponent<Omit<TextareaHTMLAttributes<HTMLTextAreaElement>, "value" | "onChange" | "onFocus" | "onBlur"> & {
+value?: string;
+/** Maximum height in pixels. When set, the textarea scrolls beyond this height instead of growing. */
+maxHeight?: number;
+} & Pick<InputFieldProps<string>, "label" | "value" | "onChange" | "size" | "icon" | "onFocus" | "onBlur" | "onKeyDown" | "status" | "loading" | "maxLength" | "placeholder" | "required" | "error" | "hideLabel" | "hint" | "labelIcon" | "clearable" | "onClear"> & RefAttributes<HTMLTextAreaElement>>;
+
 /**
  * All valid renderIf conditions for textarea fields
  */
 declare type TextareaFieldRenderIf = TextRenderIfCondition | CommonRenderIfCondition | F0BaseFieldRenderIfFunction;
 
+/**
+ * @deprecated Renamed to `F0TextAreaInputProps`. See the `Textarea`
+ * deprecation note.
+ * @removeIn 2.0.0
+ */
+export declare type TextareaProps = F0TextAreaInputProps_2;
+
 /**
  * All valid renderIf conditions for text fields
  */