@factorialco/f0-react 1.383.0 → 1.383.2

package/dist/f0.d.ts

@@ -1,33 +1,30 @@
 import { AgentState } from '@livekit/components-react';
 import { AIMessage } from '@copilotkit/shared';
 import { AlertAvatarProps as AlertAvatarProps_2 } from './F0AvatarAlert';
-import { AlertTagCellValue } from '../../../ui/value-display/types/alertTag';
+import { AlertTagCellValue } from './f0';
 import { AlertTagCellValue as AlertTagCellValue_2 } from './types/alertTag';
-import { AmountCellValue } from '../../../ui/value-display/types/amount';
+import { AmountCellValue } from './f0';
 import { AmountCellValue as AmountCellValue_2 } from './types/amount';
 import { AnchorHTMLAttributes } from 'react';
 import { AriaAttributes } from 'react';
 import { AssistantMessageProps } from '@copilotkit/react-ui';
 import { AutoFill as AutoFill_2 } from 'react';
-import { AvatarBadge as AvatarBadge_2 } from '../F0Avatar';
-import { AvatarFileSize as AvatarFileSize_2 } from './types';
-import { AvatarListCellValue } from '../../../ui/value-display/types/avatarList';
+import { AvatarListCellValue } from './f0';
 import { AvatarListCellValue as AvatarListCellValue_2 } from './types/avatarList';
 import * as AvatarPrimitive from '@radix-ui/react-avatar';
 import { AvatarProps } from './F0Avatar';
 import { AvatarProps as AvatarProps_2 } from '@radix-ui/react-avatar';
 import { BarSeriesCellValue } from './types/barSeries';
-import { BaseAvatarProps as BaseAvatarProps_2 } from '../internal/BaseAvatar';
 import { baseColors } from '@factorialco/f0-core';
 import { BigNumberProps as BigNumberProps_2 } from './types';
 import { BlockContentExtraProps } from './blocks/BlockContent';
 import { BlockProps } from './blocks/Block';
 import { CategoryBarProps } from './CategoryBarChart';
-import { ChartConfig } from '../../ui/chart';
+import { ChartConfig } from './f0';
 import { ChartConfig as ChartConfig_2 } from './utils/types';
 import { ChartPropsBase } from './utils/types';
 import { ClassValue } from 'cva';
-import { CompanyCellValue } from '../../../ui/value-display/types/company';
+import { CompanyCellValue } from './f0';
 import { CompanyCellValue as CompanyCellValue_2 } from './types/company';
 import { ComponentProps } from 'react';
 import { ComponentType } from 'react';
@@ -35,11 +32,11 @@ import { Context } from 'react';
 import { CopilotKitProps } from '@copilotkit/react-core';
 import { CountryCellValue } from './types/country';
 import { DashboardProps as DashboardProps_2 } from './Dashboard';
-import { DateCellValue } from '../../../ui/value-display/types/date';
+import { DateCellValue } from './f0';
 import { DateCellValue as DateCellValue_2 } from './types/date';
 import { DateFilterOptions } from './DateFilter/DateFilter';
 import { default as default_2 } from 'react';
-import { DotTagCellValue } from '../../../ui/value-display/types/dotTag';
+import { DotTagCellValue } from './f0';
 import { DotTagCellValue as DotTagCellValue_2 } from './types/dotTag';
 import { F0AvatarCompanyProps as F0AvatarCompanyProps_2 } from './types';
 import { F0AvatarDateProps } from './F0AvatarDate';
@@ -49,9 +46,10 @@ import { F0AvatarListProps as F0AvatarListProps_2 } from './types';
 import { F0AvatarPersonProps as F0AvatarPersonProps_2 } from './types';
 import { F0AvatarTeamProps as F0AvatarTeamProps_2 } from './F0AvatarTeam';
 import { F0DialogInternalProps } from './internal-types';
-import { F0FormDefinitionPerSection as F0FormDefinitionPerSection_2 } from '../F0WizardForm/types';
-import { F0FormDefinitionSingleSchema as F0FormDefinitionSingleSchema_2 } from '../F0WizardForm/types';
+import { F0FormDefinitionPerSection as F0FormDefinitionPerSection_2 } from './f0';
+import { F0FormDefinitionSingleSchema as F0FormDefinitionSingleSchema_2 } from './f0';
 import { F0GridStackProps as F0GridStackProps_2 } from './F0GridStack';
+import { F0SelectProps as F0SelectProps_2 } from './types';
 import { F0TagBalanceProps } from './types';
 import { F0TagCompanyProps } from './types';
 import { F0TagListProps } from './types';
@@ -61,10 +59,9 @@ import { F0TagStatusProps } from './types';
 import { F0TagTeamProps } from './types';
 import { f1Colors } from '@factorialco/f0-core';
 import { FC } from 'react';
-import { FileCellValue } from '../../../ui/value-display/types/file';
+import { FileCellValue } from './f0';
 import { FileCellValue as FileCellValue_2 } from './types/file';
-import { FileDef as FileDef_2 } from './types';
-import { FolderCellValue } from '../../../ui/value-display/types/folder';
+import { FolderCellValue } from './f0';
 import { FolderCellValue as FolderCellValue_2 } from './types/folder';
 import { ForwardedRef } from 'react';
 import { ForwardRefExoticComponent } from 'react';
@@ -80,29 +77,29 @@ import { HTMLAttributes } from 'react';
 import { IconCellValue } from './types/icon';
 import { ImgHTMLAttributes } from 'react';
 import { InFilterOptions } from './InFilter/types';
-import { internalAvatarColors as internalAvatarColors_2 } from '../../../ui/Avatar';
-import { internalAvatarSizes as internalAvatarSizes_2 } from '../../../ui/Avatar';
-import { internalAvatarTypes as internalAvatarTypes_2 } from '../../../ui/Avatar';
+import { internalAvatarColors as internalAvatarColors_2 } from './f0';
+import { internalAvatarSizes as internalAvatarSizes_2 } from './f0';
+import { internalAvatarTypes as internalAvatarTypes_2 } from './f0';
 import { JSX as JSX_2 } from 'react';
-import { LineChartConfig } from '../../ui/chart';
+import { LineChartConfig } from './f0';
 import { LineChartPropsBase } from './utils/types';
 import { LocalAudioTrack } from 'livekit-client';
 import { LongTextCellValue } from './types/longText';
 import { Message } from '@copilotkit/shared';
 import { MessagesProps } from '@copilotkit/react-ui';
-import { NumberCellValue } from '../../../ui/value-display/types/number';
+import { NumberCellValue } from './f0';
 import { NumberCellValue as NumberCellValue_2 } from './types/number';
 import { NumberFilterOptions } from './NumberFilter/NumberFilter';
 import { Observable } from 'zen-observable-ts';
 import { PageLayoutBlockComponent as PageLayoutBlockComponent_2 } from './types';
-import { PageLayoutGroupComponent as PageLayoutGroupComponent_2 } from '../Layout';
+import { PageLayoutGroupComponent as PageLayoutGroupComponent_2 } from './f0';
 import { PageProps } from './pages/Page';
 import { PercentageCellValue } from './types/percentage';
-import { PersonCellValue } from '../../../ui/value-display/types/person';
+import { PersonCellValue } from './f0';
 import { PersonCellValue as PersonCellValue_2 } from './types/person';
 import { PieChartProps } from './PieChart';
 import { PopoverContentProps } from '@radix-ui/react-popover';
-import { ProgressBarCellValue } from '../../../ui/value-display/types/progressBar';
+import { ProgressBarCellValue } from './f0';
 import { ProgressBarCellValue as ProgressBarCellValue_2 } from './types/progressBar';
 import { Props as Props_2 } from './types';
 import * as React_2 from 'react';
@@ -113,28 +110,28 @@ import { RefObject } from 'react';
 import { RemoteAudioTrack } from 'livekit-client';
 import { SearchFilterOptions } from './SearchFilter/SearchFilter';
 import { SizeToken as SizeToken_2 } from './types';
-import { StatusCellValue } from '../../../ui/value-display/types/status';
+import { StatusCellValue } from './f0';
 import { StatusCellValue as StatusCellValue_2 } from './types/status';
 import { SVGProps } from 'react';
 import * as SwitchPrimitive from '@radix-ui/react-switch';
-import { TagCellValue } from '../../../ui/value-display/types/tag';
+import { TagCellValue } from './f0';
 import { TagCellValue as TagCellValue_2 } from './types/tag';
-import { TagListCellValue } from '../../../ui/value-display/types/tagList';
+import { TagListCellValue } from './f0';
 import { TagListCellValue as TagListCellValue_2 } from './types/tagList';
 import { TagType as TagType_2 } from './types';
 import { TagVariant as TagVariant_2 } from './F0Tag';
-import { TeamCellValue } from '../../../ui/value-display/types/team';
+import { TeamCellValue } from './f0';
 import { TeamCellValue as TeamCellValue_2 } from './types/team';
-import { TextCellValue } from '../../../ui/value-display/types/text';
+import { TextCellValue } from './f0';
 import { TextCellValue as TextCellValue_2 } from './types/text';
 import { TrackReferenceOrPlaceholder } from '@livekit/components-react';
-import { ValueDisplayRendererContext } from '../../../ui/value-display';
+import { ValueDisplayRendererContext } from './f0';
 import { VariantProps } from 'cva';
-import { WithDataTestIdReturnType as WithDataTestIdReturnType_2 } from '../lib/data-testid';
-import { WithDataTestIdReturnType as WithDataTestIdReturnType_3 } from '../../lib/data-testid';
-import { WithDataTestIdReturnType as WithDataTestIdReturnType_4 } from '../../../lib/data-testid';
-import { WithDataTestIdReturnType as WithDataTestIdReturnType_5 } from '../../f0';
-import { WithDataTestIdReturnType as WithDataTestIdReturnType_6 } from '../../lib/data-testid/index.tsx';
+import { WithDataTestIdReturnType as WithDataTestIdReturnType_2 } from './f0';
+import { WithDataTestIdReturnType as WithDataTestIdReturnType_3 } from './f0';
+import { WithDataTestIdReturnType as WithDataTestIdReturnType_4 } from './f0';
+import { WithDataTestIdReturnType as WithDataTestIdReturnType_5 } from './f0';
+import { WithDataTestIdReturnType as WithDataTestIdReturnType_6 } from './f0';
 import { z } from 'zod';
 import { ZodEffects } from 'zod';
 import { ZodRawShape } from 'zod';
@@ -616,12 +613,9 @@ export declare type AvatarVariants = (typeof avatarVariants)[number];
 
 export declare const avatarVariants: readonly ["person", "team", "company", "file", "flag"];
 
-export declare const Await: AwaitGeneric;
-
-/**
- * Generic component type so <Await resolve={value}> correctly types children as (value: T) => ReactNode.
- */
-declare type AwaitGeneric = <T>(props: AwaitProps<T> & WithDataTestIdProps) => ReactNode;
+export declare const Await: <T>(props: AwaitProps<T> & {
+    dataTestId?: string;
+}) => ReactNode;
 
 export declare type AwaitProps<T> = {
     resolve: Promise<T> | T;
@@ -1904,6 +1898,29 @@ export declare type DataSourceDefinition<R extends RecordType = RecordType, Filt
     }) => number | undefined;
 };
 
+/**
+ * Wrapper component that conditionally renders a `data-testid` attribute.
+ *
+ * When `dataTestId` is provided and the platform context enables test id rendering,
+ * wraps children in a `<div data-testid={dataTestId} style={{ display: "contents" }}>`.
+ * Otherwise renders children as-is with no wrapper element.
+ *
+ * Use this directly inside components with complex generic types (e.g. F0Select,
+ * OneFilterPicker) where the `withDataTestId` HOC would erase type parameters.
+ *
+ * @example
+ * ```tsx
+ * const MyComponent = <T,>({ dataTestId, ...props }: MyProps<T> & WithDataTestIdProps) => (
+ *   <DataTestIdWrapper dataTestId={dataTestId}>
+ *     <div>...</div>
+ *   </DataTestIdWrapper>
+ * )
+ * ```
+ */
+export declare const DataTestIdWrapper: ({ dataTestId, children, }: WithDataTestIdProps & {
+    children: ReactNode;
+}) => ReactNode;
+
 /**
  * All valid renderIf conditions for date fields
  */
@@ -2974,21 +2991,21 @@ export declare type F0AvatarEmojiProps = {
     size?: (typeof avatarEmojiSizes)[number];
 } & Partial<Pick<BaseAvatarProps, "aria-label" | "aria-labelledby">>;
 
-export declare const F0AvatarFile: WithDataTestIdReturnType_4<ForwardRefExoticComponent<Omit<Omit<Omit<AvatarProps_2 & RefAttributes<HTMLSpanElement>, "ref"> & {
+export declare const F0AvatarFile: ForwardRefExoticComponent<Omit<Omit<Omit<AvatarProps_2 & RefAttributes<HTMLSpanElement>, "ref"> & {
 size?: internalAvatarSizes_2[number];
 type?: internalAvatarTypes_2[number];
 color?: internalAvatarColors_2[number];
 } & RefAttributes<HTMLSpanElement>, "ref">, "type" | "size"> & {
-file: FileDef_2;
-size?: AvatarFileSize_2;
-badge?: AvatarBadge_2;
-} & Pick<BaseAvatarProps_2, "aria-label" | "aria-labelledby"> & RefAttributes<HTMLSpanElement>>>;
+file: FileDef;
+size?: AvatarFileSize;
+badge?: AvatarBadge;
+} & Pick<BaseAvatarProps, "aria-label" | "aria-labelledby"> & WithDataTestIdProps & RefAttributes<HTMLSpanElement>>;
 
 export declare type F0AvatarFileProps = Omit<React.ComponentPropsWithoutRef<typeof Avatar>, "type" | "size"> & {
     file: FileDef;
     size?: AvatarFileSize;
     badge?: AvatarBadge;
-} & Pick<BaseAvatarProps, "aria-label" | "aria-labelledby">;
+} & Pick<BaseAvatarProps, "aria-label" | "aria-labelledby"> & WithDataTestIdProps;
 
 declare type F0AvatarFlagProps = {
     flag: CountryCode | (string & {});
@@ -3837,9 +3854,9 @@ export declare type F0FileField = F0BaseField & {
  */
 export declare type F0FileFieldConfig = F0StringFileConfig | F0ArrayFileConfig;
 
-export declare const F0FilterPickerContent: F0FilterPickerContentGeneric;
-
-declare type F0FilterPickerContentGeneric = <Filters extends FiltersDefinition>(props: F0FilterPickerContentProps<Filters> & WithDataTestIdProps) => ReactElement | null;
+export declare const F0FilterPickerContent: <Filters extends FiltersDefinition>(props: F0FilterPickerContentProps<Filters> & {
+    dataTestId?: string;
+}) => ReactElement | null;
 
 /**
  * Props for the F0FilterPickerContent component.
@@ -3859,11 +3876,13 @@ export declare interface F0FilterPickerContentProps<Filters extends FiltersDefin
 }
 
 /**
- * Public props for F0FilterPickerContent (includes dataTestId from withDataTestId).
+ * Public props for F0FilterPickerContent (includes dataTestId).
  * Use this when typing props that include the optional dataTestId attribute.
  * @template Filters - The type defining the structure of available filters
  */
-export declare type F0FilterPickerContentPublicProps<Filters extends FiltersDefinition> = F0FilterPickerContentProps<Filters> & WithDataTestIdProps;
+export declare type F0FilterPickerContentPublicProps<Filters extends FiltersDefinition> = F0FilterPickerContentProps<Filters> & {
+    dataTestId?: string;
+};
 
 /**
  * @experimental This is an experimental component, use it at your own risk
@@ -4554,7 +4573,9 @@ export declare interface F0SectionConfig {
 /**
  * @experimental This is an experimental component use it at your own risk
  */
-export declare const F0Select: F0SelectGeneric;
+export declare const F0Select: <T extends string = string, R = unknown>(props: F0SelectProps_2<T, R> & {
+    ref?: React.Ref<HTMLButtonElement>;
+}) => React.ReactElement;
 
 /**
  * Base props shared across all F0Select variants
@@ -4585,7 +4606,7 @@ declare type F0SelectBaseProps<T extends string, R = unknown> = {
      * @default false
      */
     showPreview?: boolean;
-};
+} & WithDataTestIdProps;
 
 /**
  * F0 config options specific to select fields
@@ -4650,12 +4671,6 @@ export declare type F0SelectField = F0BaseField & F0SelectConfig & {
     renderIf?: SelectFieldRenderIf;
 };
 
-/**
- * Generic component type so consumers can use <F0Select<T, R> />.
- * Preserves dataTestId and F0SelectProps<T, R>.
- */
-declare type F0SelectGeneric = <T extends string, R = unknown>(props: F0SelectProps<T, R> & WithDataTestIdProps) => ReactElement | null;
-
 export declare type F0SelectItemObject<T, R = unknown> = {
     type?: "item";
     value: T;
@@ -6336,13 +6351,9 @@ action: BulkAction,
 ...Parameters<OnSelectItemsCallback<Record, Filters>>
 ]) => void;
 
-export declare const OneFilterPicker: OneFilterPickerGeneric;
-
-/**
- * Generic component type so consumers can use <OneFilterPicker<Definition> />.
- * Preserves dataTestId and OneFilterPickerRootProps<Definition>.
- */
-declare type OneFilterPickerGeneric = <Definition extends FiltersDefinition>(props: OneFilterPickerRootProps<Definition> & WithDataTestIdProps) => ReactElement | null;
+export declare const OneFilterPicker: <Definition extends FiltersDefinition>(props: OneFilterPickerRootProps<Definition> & {
+    dataTestId?: string;
+}) => ReactElement | null;
 
 /**
  * Props for the Filters component.
@@ -7093,12 +7104,6 @@ export declare interface StandardLayoutProps extends VariantProps<typeof layoutV
     children?: default_2.ReactNode;
 }
 
-/**
- * Keys on T that are not part of Function, so we preserve static members (Skeleton, displayName, etc.)
- * without bringing in a second call signature that would confuse ComponentProps<> inference.
- */
-declare type StaticMembersOf<T> = Pick<T, Exclude<keyof T, keyof Function>>;
-
 export declare type Status = (typeof statuses_2)[number];
 
 declare const statuses: readonly ["neutral", "info", "positive", "warning", "critical"];
@@ -8242,11 +8247,15 @@ export declare type WithDataTestIdProps = {
 export declare type WithDataTestIdPropsOf<T extends default_2.ComponentType<unknown>> = default_2.ComponentProps<T> & WithDataTestIdProps;
 
 /**
- * Return type has a single call signature with props = ComponentProps<T> & WithDataTestIdProps,
- * so ComponentProps<Wrapped> and Storybook's Meta/StoryObj infer correctly.
- * Static properties (e.g. F0Card.Skeleton) are preserved via StaticMembersOf<T>.
+ * Given a component type T, produce a new component type that:
+ * 1. Accepts all of T's props plus dataTestId
+ * 2. Preserves callback argument types (e.g., onCheckedChange: (checked: boolean) => void)
+ * 3. Preserves static members (e.g., F0Card.Skeleton)
+ *
+ * We use a mapped type approach to avoid the pitfalls of React.ComponentType
+ * which collapses callback inference.
  */
-export declare type WithDataTestIdReturnType<T extends default_2.ComponentType<unknown>> = default_2.ComponentType<WithDataTestIdPropsOf<T>> & StaticMembersOf<T>;
+export declare type WithDataTestIdReturnType<T extends default_2.ComponentType<any>> = default_2.ForwardRefExoticComponent<default_2.PropsWithoutRef<default_2.ComponentProps<T> & WithDataTestIdProps> & default_2.RefAttributes<T extends default_2.ForwardRefExoticComponent<infer P> ? P extends default_2.RefAttributes<infer R> ? R : unknown : unknown>> & Pick<T, Exclude<keyof T, keyof default_2.ForwardRefExoticComponent<unknown>>>;
 
 export declare type WithGroupId<RecordType> = RecordType & {
     [GROUP_ID_SYMBOL]: unknown | undefined;
@@ -8321,6 +8330,11 @@ declare module "gridstack" {
 }
 
 
+declare namespace Calendar {
+    var displayName: string;
+}
+
+
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
         aiBlock: {
@@ -8368,8 +8382,3 @@ declare module "@tiptap/core" {
         };
     }
 }
-
-
-declare namespace Calendar {
-    var displayName: string;
-}