@factorialco/f0-react 1.279.0 → 1.280.0

package/dist/f0.d.ts

@@ -224,6 +224,10 @@ declare const alertAvatarVariants: (props?: ({
 
 declare type AlertTagProps = ComponentProps<typeof F0TagAlert>;
 
+declare const _allowedVariants: readonly ["heading", "heading-large"];
+
+declare const _allowedVariants_2: readonly ["body", "description", "small", "inverse", "code", "label"];
+
 export declare type AllSelectionStatus = {
     checked: boolean;
     indeterminate: boolean;
@@ -231,6 +235,8 @@ export declare type AllSelectionStatus = {
     unselectedCount: number;
 };
 
+declare const allTags: readonly ["h1", "h2", "h3", "h4", "h5", "h6", "p", "span", "div", "label", "code"];
+
 declare type AnimationVariantsOptions = {
     delay?: number;
     duration?: number;
@@ -244,6 +250,8 @@ canBeBlurred?: boolean;
 blurArea?: "l" | "r" | "lr";
 } & RefAttributes<HTMLDivElement>, "ref"> & RefAttributes<HTMLElement | SVGElement>>;
 
+declare type AsAllowedList = (typeof allTags)[number];
+
 declare const Avatar: React_2.ForwardRefExoticComponent<Omit<AvatarPrimitive.AvatarProps & React_2.RefAttributes<HTMLSpanElement>, "ref"> & {
     size?: (typeof internalAvatarSizes)[number];
     type?: (typeof internalAvatarTypes)[number];
@@ -1921,7 +1929,7 @@ export declare type F0AvatarFileProps = Omit<React.ComponentPropsWithoutRef<type
 } & Pick<BaseAvatarProps, "aria-label" | "aria-labelledby">;
 
 declare type F0AvatarFlagProps = {
-    flag: CountryCode;
+    flag: CountryCode | (string & {});
     size?: BaseAvatarProps["size"];
     badge?: AvatarBadge;
 } & Pick<BaseAvatarProps, "aria-label" | "aria-labelledby">;
@@ -2229,6 +2237,13 @@ export declare interface F0GridStackRef {
     removeAll: () => void;
 }
 
+export declare const F0Heading: ForwardRefExoticComponent<Omit<F0HeadingProps, "ref"> & RefAttributes<HTMLElement>>;
+
+export declare type F0HeadingProps = Omit<TextProps, "className" | "variant" | "as"> & {
+    variant?: (typeof _allowedVariants)[number];
+    as?: HeadingTags;
+};
+
 export declare const F0Icon: ForwardRefExoticComponent<Omit<Omit<F0IconProps_2, "ref"> & RefAttributes<SVGSVGElement>, "ref"> & RefAttributes<HTMLElement | SVGElement>>;
 
 export declare interface F0IconProps extends SVGProps<SVGSVGElement>, VariantProps<typeof iconVariants> {
@@ -2285,6 +2300,14 @@ export declare const F0TagStatus: ForwardRefExoticComponent<TagStatusProps & Ref
 
 export declare const F0TagTeam: ForwardRefExoticComponent<TagTeamProps & RefAttributes<HTMLDivElement>>;
 
+export declare const F0Text: ForwardRefExoticComponent<Omit<F0TextProps, "ref"> & RefAttributes<HTMLElement>>;
+
+export declare type F0TextProps = Omit<TextProps, "className" | "variant" | "as"> & {
+    variant?: (typeof _allowedVariants_2)[number];
+    as?: TextTags;
+    markdown?: boolean;
+};
+
 export declare type FileAvatarVariant = Extract<AvatarVariant, {
     type: "file";
 }>;
@@ -2552,6 +2575,10 @@ export declare type GroupRecord<RecordType> = {
     records: RecordType[];
 };
 
+declare type HeadingTags = (typeof headingTags)[number];
+
+declare const headingTags: readonly ["h1", "h2", "h3", "h4", "h5", "h6"];
+
 export declare const HomeLayout: ForwardRefExoticComponent<Omit<{
 widgets?: ReactNode[];
 children?: ReactNode;
@@ -2619,6 +2646,15 @@ declare type InFilterOptionItem<T = unknown> = {
  */
 declare type InFilterOptions_2<T, _R extends RecordType = RecordType> = {
     cache?: boolean;
+    /**
+     * Optional function to resolve labels for specific values without fetching all options.
+     * This is useful when you have a dynamic source and want to avoid fetching all options
+     * just to display labels for selected values.
+     * @param value - The value to get the label for
+     * @returns The label for the value, or a promise that resolves to the label
+     * @note The parameter type is `unknown` to allow compatibility when T is different types
+     */
+    getLabel?: (value: unknown) => string | Promise<string>;
 } & ({
     options: Array<InFilterOptionItem<T>> | (() => Array<InFilterOptionItem<T>> | Promise<Array<InFilterOptionItem<T>>>);
 } | {
@@ -3767,6 +3803,70 @@ export declare type TeamAvatarVariant = Extract<AvatarVariant, {
 
 declare type TeamTagProps = ComponentProps<typeof F0TagTeam>;
 
+declare interface TextProps extends Omit<default_2.HTMLAttributes<HTMLElement>, "className">, default_2.RefAttributes<HTMLElement> {
+    /**
+     * Content to be rendered
+     */
+    content: string;
+    /**
+     * The text variant to render. Determines styling and default semantic element.
+     */
+    variant?: TextVariant;
+    /**
+     * Text alignment
+     * @default left
+     */
+    align?: NonNullable<TextVariants["align"]>;
+    /**
+     * Additional classes to apply
+     * @private
+     */
+    className?: string;
+    /**
+     * HTML tag name to use for rendered element.
+     * If not provided, uses semantic default based on variant.
+     * @default varies by variant
+     */
+    as?: AsAllowedList;
+    /**
+     * Enable text ellipsis with optional line configuration
+     * - `true`: Single line ellipsis (lines = 1)
+     * - `number`: Multi-line ellipsis with specified line count
+     * - `undefined`: No ellipsis
+     */
+    ellipsis?: boolean | number;
+    /**
+     * Disable tooltip when text is truncated
+     * Only applies when ellipsis is enabled
+     * @default false
+     */
+    noEllipsisTooltip?: boolean;
+    /**
+     * Enable markdown parsing for content
+     * @default false
+     */
+    markdown?: boolean;
+}
+
+declare type TextTags = (typeof textTags)[number];
+
+declare const textTags: readonly ["p", "span", "div", "label", "code"];
+
+declare type TextVariant = NonNullable<TextVariants["variant"]>;
+
+declare type TextVariants = VariantProps<typeof textVariants>;
+
+declare const textVariants: (props?: ({
+    variant?: "info" | "small" | "body" | "code" | "label" | "description" | "selected" | "heading" | "positive" | "inverse" | "critical" | "warning" | "heading-large" | "label-input" | "warning-strong" | "critical-strong" | "positive-strong" | "info-strong" | undefined;
+    align?: "center" | "left" | "right" | undefined;
+} & ({
+    class?: ClassValue;
+    className?: never;
+} | {
+    class?: never;
+    className?: ClassValue;
+})) | undefined) => string;
+
 declare type TranslationKey = Join<PathsToStringProps<typeof defaultTranslations>, ".">;
 
 declare type TranslationShape<T> = {
@@ -4195,31 +4295,6 @@ declare global {
 }
 
 
-declare module "gridstack" {
-    interface GridStackWidget {
-        id?: string;
-        allowedSizes?: Array<{
-            w: number;
-            h: number;
-        }>;
-        renderFn?: () => React.ReactElement | null;
-        meta?: Record<string, unknown>;
-    }
-    interface GridStackNode {
-        id?: string;
-        w?: number;
-        h?: number;
-        x?: number;
-        y?: number;
-        allowedSizes?: Array<{
-            w: number;
-            h: number;
-        }>;
-        renderFn?: () => React.ReactElement | null;
-    }
-}
-
-
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
         aiBlock: {
@@ -4247,8 +4322,28 @@ declare module "@tiptap/core" {
 }
 
 
-declare namespace Calendar {
-    var displayName: string;
+declare module "gridstack" {
+    interface GridStackWidget {
+        id?: string;
+        allowedSizes?: Array<{
+            w: number;
+            h: number;
+        }>;
+        renderFn?: () => React.ReactElement | null;
+        meta?: Record<string, unknown>;
+    }
+    interface GridStackNode {
+        id?: string;
+        w?: number;
+        h?: number;
+        x?: number;
+        y?: number;
+        allowedSizes?: Array<{
+            w: number;
+            h: number;
+        }>;
+        renderFn?: () => React.ReactElement | null;
+    }
 }
 
 
@@ -4259,3 +4354,8 @@ declare module "@tiptap/core" {
         };
     }
 }
+
+
+declare namespace Calendar {
+    var displayName: string;
+}