@factorialco/f0-react 1.302.1 → 1.303.2

package/dist/f0.d.ts

@@ -10,6 +10,8 @@ import { AvatarListCellValue as AvatarListCellValue_2 } from './types/avatarList
 import * as AvatarPrimitive from '@radix-ui/react-avatar';
 import { AvatarProps as AvatarProps_2 } from '@radix-ui/react-avatar';
 import { baseColors } from '@factorialco/f0-core';
+import { BlockContentExtraProps } from './blocks/BlockContent';
+import { BlockProps } from './blocks/Block';
 import { CategoryBarProps } from './CategoryBarChart';
 import { ChartConfig } from '../../ui/chart';
 import { ChartConfig as ChartConfig_2 } from './utils/types';
@@ -18,7 +20,9 @@ import { ClassValue } from 'cva';
 import { CompanyCellValue } from '../../value-display/types/company';
 import { CompanyCellValue as CompanyCellValue_2 } from './types/company';
 import { ComponentProps } from 'react';
+import { ComponentType } from 'react';
 import { CountryCellValue } from './types/country';
+import { DashboardProps as DashboardProps_2 } from './Dashboard';
 import { DateCellValue } from '../../value-display/types/date';
 import { DateCellValue as DateCellValue_2 } from './types/date';
 import { DateFilterOptions } from './DateFilter/DateFilter';
@@ -37,6 +41,10 @@ import { ForwardedRef } from 'react';
 import { ForwardRefExoticComponent } from 'react';
 import { GridStackOptions } from 'gridstack';
 import { GridStackWidget } from 'gridstack';
+import { GroupGridProps as GroupGridProps_2 } from './groups/GroupGrid';
+import { GroupGridWidget as GroupGridWidget_2 } from './groups/GroupGrid';
+import { GroupLinearProps } from './groups/GroupLinear';
+import { GroupMasonryProps } from './groups/GroupMasonry';
 import { HTMLAttributeAnchorTarget } from 'react';
 import { HTMLAttributes } from 'react';
 import { IconCellValue } from './types/icon';
@@ -53,6 +61,8 @@ import { NumberCellValue } from '../../value-display/types/number';
 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 { PageProps } from './pages/Page';
 import { PercentageCellValue } from './types/percentage';
 import { PersonCellValue } from '../../value-display/types/person';
 import { PersonCellValue as PersonCellValue_2 } from './types/person';
@@ -1121,6 +1131,19 @@ export declare type CurrentFilters<F extends FilterOptions<string>> = F extends
     [Key in K]?: FilterValue<F["fields"][Key]>;
 } : Record<string, never>;
 
+export declare const Dashboard: {
+    ({ widgets, editMode, onChange, }: DashboardProps_2): JSX_2.Element;
+    displayName: string;
+};
+
+export declare type DashboardProps = GroupGridProps<DashboardWidget>;
+
+export declare type DashboardWidget = GroupGridWidget<{
+    title: string;
+    actions?: DropdownItem[];
+    aiButton?: () => void;
+}>;
+
 export declare type Data<R extends RecordType> = {
     records: WithGroupId<R>[];
     type: "grouped" | "flat";
@@ -1988,7 +2011,7 @@ declare type EventParams = Record<string, EventScalar | Array<EventScalar>>;
 
 declare type EventScalar = string | number | boolean | undefined | null;
 
-export declare const experimental: <T extends (...args: any[]) => any>(name: string, component: T) => T;
+export declare const experimental: <T extends React.ComponentType<any>>(name: string, component: T) => T;
 
 declare type ExtractVisualizationSettings<T> = T extends {
     settings: {
@@ -2716,6 +2739,37 @@ export declare interface GridStackReactWidget extends Omit<GridStackWidget, "con
  */
 export declare const GROUP_ID_SYMBOL: unique symbol;
 
+declare interface GroupGridProps<Widget extends GroupGridWidget> {
+    widgets: Optional<Widget, "x" | "y">[];
+    editMode?: boolean;
+    /**
+     * Callback function that is called whenever the layout changes.
+     * Receives an array of widgets with updated positions and properties.
+     * This can be used to keep widgets in sync by using the returned data.
+     */
+    onChange?: (widgets: Widget[]) => void;
+    WidgetWrapper?: (children: React.ReactNode, meta: Widget["meta"] | undefined, editMode: boolean) => React.ReactElement;
+    /**
+     * If the group is the main content of the page, it will try to take the full height of the page
+     */
+    main?: boolean;
+}
+
+declare type GroupGridWidget<Meta extends Record<string, unknown> = Record<string, unknown>> = {
+    id: string;
+    availableSizes?: GroupGridWidgetSize[];
+    content: React.ReactNode;
+    x: number;
+    y: number;
+    locked?: boolean;
+    meta?: Meta;
+} & GroupGridWidgetSize;
+
+declare type GroupGridWidgetSize = {
+    w: number;
+    h: number;
+};
+
 /**
  * Defines the structure and configuration of a grouping options for a data source.
  * @template RecordType - The type of records in the collection
@@ -3037,6 +3091,21 @@ declare type Lane<Filters extends FiltersDefinition> = {
     filters: FiltersState<Filters>;
 };
 
+export declare const Layout: {
+    Page: ForwardRefExoticComponent<PageProps & RefAttributes<HTMLDivElement>>;
+    Block: ForwardRefExoticComponent<BlockProps & RefAttributes<HTMLDivElement>>;
+    BlockContent: ComponentType<BlockProps & BlockContentExtraProps> & PageLayoutBlockComponent_2;
+    Group: ForwardRefExoticComponent<GroupLinearProps & RefAttributes<HTMLDivElement>>;
+    GroupGrid: {
+        <Widget extends GroupGridWidget_2>({ widgets, editMode, onChange, WidgetWrapper, main, }: GroupGridProps_2<Widget>): JSX_2.Element;
+        displayName: string;
+    };
+    GroupMasonry: {
+        ({ blocks, sortable: _sortable, onSort: _onSort, main, }: GroupMasonryProps): JSX_2.Element;
+        displayName: string;
+    };
+};
+
 declare interface LayoutProps {
     fullScreen?: boolean;
     addBodyClasses?: boolean;
@@ -3308,6 +3377,8 @@ export declare type OnSelectItemsCallback<R extends RecordType, Filters extends
     byLane?: Record<string, SelectedItemsDetailedStatus<R, Filters>>;
 }, clearSelectedItems: () => void) => void;
 
+declare type Optional<T, K extends keyof T> = Pick<Partial<T>, K> & Omit<T, K>;
+
 /**
  * Represents a paginated response with page-based navigation.
  *
@@ -3331,6 +3402,16 @@ export declare type PageBasedPaginatedResponse<TRecord> = BasePaginatedResponse<
     pagesCount: number;
 };
 
+export declare interface PageLayoutBlockComponent {
+    __isPageLayoutBlock: true;
+    displayName?: string;
+}
+
+export declare interface PageLayoutGroupComponent {
+    __isPageLayoutGroup: true;
+    displayName?: string;
+}
+
 /**
  * Paginated data adapter configuration
  * @template R - The type of records in the collection
@@ -4339,6 +4420,8 @@ export declare interface UseDataOptions<R extends RecordType, Filters extends Fi
  */
 export declare interface UseDataReturn<R extends RecordType> {
     data: Data<R>;
+    search: string | undefined;
+    setSearch: (search: string | undefined) => void;
     isInitialLoading: boolean;
     isLoading: boolean;
     isLoadingMore: boolean;
@@ -4590,23 +4673,6 @@ declare global {
     }
 }
 
-declare module "gridstack" {
-    interface GridStackWidget {
-        id?: string;
-        allowedSizes?: Array<{
-            w: number;
-            h: number;
-        }>;
-        meta?: Record<string, unknown>;
-    }
-    interface GridStackNode {
-        allowedSizes?: Array<{
-            w: number;
-            h: number;
-        }>;
-    }
-}
-
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
@@ -4634,6 +4700,23 @@ declare module "@tiptap/core" {
     }
 }
 
+declare module "gridstack" {
+    interface GridStackWidget {
+        id?: string;
+        allowedSizes?: Array<{
+            w: number;
+            h: number;
+        }>;
+        meta?: Record<string, unknown>;
+    }
+    interface GridStackNode {
+        allowedSizes?: Array<{
+            w: number;
+            h: number;
+        }>;
+    }
+}
+
 
 declare namespace Calendar {
     var displayName: string;