@factorialco/f0-react 1.280.0 → 1.282.0

package/dist/experimental.d.ts

@@ -283,7 +283,7 @@ declare type ActionSize = (typeof actionSizes)[number];
 
 declare const actionSizes: readonly ["sm", "md", "lg"];
 
-declare type ActionType = CopyActionType | NavigateActionType | OpenLinkActionType;
+export declare type ActionType = "duplicate" | "delete";
 
 export declare type actionType = {
     label: string;
@@ -293,6 +293,8 @@ export declare type actionType = {
     icon?: IconType;
 };
 
+declare type ActionType_2 = CopyActionType | NavigateActionType | OpenLinkActionType;
+
 declare type actionType_2 = {
     label: string;
     onClick: () => void;
@@ -310,7 +312,7 @@ export declare const ActivityItemList: (({ items, loadingMoreItems, onClickItem,
     Skeleton: () => default_2.JSX.Element;
 };
 
-export declare type ActivityItemListProps = Pick<SectionProps, "items" | "onClickItem"> & {
+export declare type ActivityItemListProps = Pick<SectionProps_2, "items" | "onClickItem"> & {
     onEndReached?: () => void;
     onEndReachedItemsThreshold?: number;
     loadingMoreItems?: boolean;
@@ -832,6 +834,25 @@ export declare type BasePaginatedResponse<R> = BaseResponse<R> & {
     perPage: number;
 };
 
+export declare type BaseQuestionOnChangeParams = {
+    id: string;
+    title?: string;
+    description?: string;
+    required?: boolean;
+};
+
+declare type BaseQuestionProps = {
+    id: string;
+    title: string;
+    description?: string;
+    type: QuestionType;
+    children: React.ReactNode;
+    required?: boolean;
+    locked?: boolean;
+};
+
+declare type BaseQuestionPropsForOtherQuestionComponents = Omit<BaseQuestionProps, "children" | "onChange">;
+
 /**
  * Base response type for collection data
  * @template R - The type of records in the collection
@@ -1316,13 +1337,7 @@ export declare const ChartWidgetEmptyState: ForwardRefExoticComponent<Props_5 &
 
 export declare type ChatWidgetEmptyStateProps = Props_5;
 
-declare type ChildrenResponse<R extends RecordType> = BaseResponse<R> | R[] | {
-    records: R[] & {
-        type?: ChildrenResponseType;
-    };
-};
-
-declare type ChildrenResponseType = "basic" | "detailed";
+declare type ChildrenResponse<R extends RecordType> = BaseResponse<R> | R[] | NestedResponseWithType<R>;
 
 export declare function ClockInControls({ trackedMinutes, remainingMinutes, data, labels, locationId, locations, canShowLocation, locationSelectorDisabled, onClockIn, onClockOut, onBreak, breakTypes, onChangeBreakTypeId, canShowBreakButton, canSeeGraph, canSeeRemainingTime, onChangeLocationId, canShowProject, projectSelectorElement, breakTypeName, }: ClockInControlsProps): JSX_2.Element;
 
@@ -1386,6 +1401,29 @@ declare interface ClockInGraphProps {
 
 declare type ClockInStatus = "clocked-in" | "break" | "clocked-out";
 
+export declare const CoCreationForm: ({ elements, isEditMode, onChange, }: CoCreationFormProps) => JSX_2.Element;
+
+export declare type CoCreationFormCallbacks = {
+    onQuestionChange?: (params: OnChangeQuestionParams) => void;
+    onSectionChange?: (params: OnChangeSectionParams) => void;
+    onAddNewElement?: (params: OnAddNewElementParams) => void;
+    onDuplicateElement?: (params: OnDuplicateElementParams) => void;
+};
+
+export declare type CoCreationFormElement = {
+    type: "section";
+    section: SectionElement;
+} | {
+    type: "question";
+    question: QuestionElement;
+};
+
+export declare type CoCreationFormProps = {
+    elements: CoCreationFormElement[];
+    onChange: (elements: CoCreationFormElement[]) => void;
+    isEditMode?: boolean;
+};
+
 declare type ColId = string;
 
 /**
@@ -1487,7 +1525,7 @@ declare const CompanyItem: ForwardRefExoticComponent<CompanyItemProps & RefAttri
 declare type CompanyItemProps = {
     name: string;
     avatarUrl?: URL_2;
-    action?: ActionType;
+    action?: ActionType_2;
 };
 
 export declare function CompanySelector({ companies, selected, onChange, isLoading, withNotification, additionalOptions, }: CompanySelectorProps): JSX_2.Element;
@@ -1908,6 +1946,10 @@ export declare interface DatePreset {
     value: DateRange | (() => DateRange);
 }
 
+declare type DateQuestionProps = BaseQuestionPropsForOtherQuestionComponents & {
+    value?: Date | null;
+};
+
 export declare type DateRange = {
     from: Date;
     to?: Date;
@@ -2320,6 +2362,56 @@ declare const defaultTranslations: {
         readonly greaterThan: "It should be greater than {{min}}";
         readonly lessThan: "It should be less than {{max}}";
     };
+    readonly coCreationForm: {
+        readonly actions: {
+            readonly actions: "Actions";
+            readonly duplicateQuestion: "Duplicate question";
+            readonly deleteQuestion: "Delete question";
+            readonly duplicateSection: "Duplicate section";
+            readonly deleteSection: "Delete section";
+        };
+        readonly questionTypes: {
+            readonly section: "Section";
+            readonly rating: "Rating";
+            readonly multipleChoice: "Multiple choice";
+            readonly singleChoice: "Single choice";
+            readonly text: "Text";
+            readonly longText: "Long text";
+            readonly numeric: "Numeric";
+            readonly link: "Link";
+            readonly date: "Date";
+        };
+        readonly selectQuestion: {
+            readonly addOption: "Add option";
+            readonly newOption: "New option {{number}}";
+            readonly markAsCorrect: "Mark as correct";
+            readonly remove: "Remove";
+            readonly correct: "Correct";
+            readonly optionPlaceholder: "Type anything you want here...";
+        };
+        readonly answer: {
+            readonly label: "Answer";
+            readonly placeholder: "Respondent's answer";
+        };
+        readonly labels: {
+            readonly endOfSection: "End of section";
+            readonly title: "Title";
+            readonly titlePlaceholder: "Question title";
+            readonly description: "Description";
+            readonly questionDescriptionPlaceholder: "Describe the question in a few words";
+            readonly sectionDescriptionPlaceholder: "Describe the section in a few words";
+            readonly required: "Required";
+            readonly questionType: "Question type";
+            readonly questionOptions: "Question options";
+            readonly actions: "Actions";
+            readonly sectionTitlePlaceholder: "Section title";
+        };
+        readonly defaults: {
+            readonly newSection: "New Section";
+            readonly newQuestion: "New Question";
+            readonly newQuestionDescription: "New question description";
+        };
+    };
 };
 
 export declare const DetailsItem: ForwardRefExoticComponent<DetailsItemType & RefAttributes<HTMLDivElement>>;
@@ -2388,7 +2480,7 @@ declare type DropdownInternalProps = {
     icon?: IconType;
     size?: F0ButtonProps["size"];
     children?: default_2.ReactNode;
-    align?: "start" | "end";
+    align?: "start" | "end" | "center";
     open?: boolean;
     onOpenChange?: (open: boolean) => void;
 } & DataAttributes_2;
@@ -2426,11 +2518,13 @@ export declare type editorStateType = {
     json: JSONContent | null;
 };
 
+export declare type ElementType = QuestionType | "section";
+
 declare type EmployeeItemProps = {
     firstName: string;
     lastName: string;
     avatarUrl?: URL_2;
-    action?: ActionType;
+    action?: ActionType_2;
 };
 
 declare type EmptyState = {
@@ -3357,7 +3451,7 @@ declare type ItemDefinition = {
 declare type ItemProps = {
     text: string;
     icon?: IconType;
-    action?: ActionType;
+    action?: ActionType_2;
 };
 
 declare type Items = typeof Item_2 | typeof PersonItem | typeof CompanyItem | typeof TeamItem;
@@ -3419,6 +3513,10 @@ declare type LinkProps = AnchorHTMLAttributes<HTMLAnchorElement> & {
     disabled?: boolean;
 };
 
+declare type LinkQuestionProps = BaseQuestionPropsForOtherQuestionComponents & {
+    value?: string | null;
+};
+
 /**
  * Group List: Renders the list for a group
  */
@@ -3792,6 +3890,13 @@ declare type NestedKeyOf<T> = {
     } ? `${K}` | `${K}-${NestedKeyOf<T[K]>}` : `${K}-${NestedKeyOf<T[K]>}` : K extends "DEFAULT" ? never : `${K}`;
 }[keyof T & string];
 
+declare type NestedResponseWithType<R extends RecordType> = {
+    records: R[];
+    type?: NestedVariant;
+};
+
+declare type NestedVariant = "basic" | "detailed";
+
 declare type NewColor = Extract<BaseColor, "viridian" | "malibu" | "yellow" | "purple" | "lilac" | "barbie" | "smoke" | "army" | "flubber" | "indigo" | "camel">;
 
 declare type NextDepth<T> = T extends 1 ? 2 : T extends 2 ? 3 : T extends 3 ? 4 : never;
@@ -3872,6 +3977,10 @@ export declare type NumberInputProps = Omit<InputProps<string>, "value" | "type"
     units?: string;
 };
 
+declare type NumericQuestionProps = BaseQuestionPropsForOtherQuestionComponents & {
+    value?: number | null;
+};
+
 export declare function OmniButton({ label, options, hasNewUpdate }: OmniButtonProps): JSX_2.Element;
 
 declare interface OmniButtonProps {
@@ -3880,11 +3989,53 @@ declare interface OmniButtonProps {
     hasNewUpdate?: boolean;
 }
 
+export declare type OnAddNewElementParams = {
+    type: ElementType;
+    afterId?: string;
+};
+
 export declare type OnBulkActionCallback<Record extends RecordType, Filters extends FiltersDefinition> = (...args: [
 action: BulkAction,
 ...Parameters<OnSelectItemsCallback<Record, Filters>>
 ]) => void;
 
+declare type OnChangeQuestionParams = BaseQuestionOnChangeParams & ({
+    type: "text" | "longText";
+    value?: string | null;
+} | {
+    type: "rating";
+    value: number;
+} | {
+    type: "select";
+    value?: string | null;
+    options: SelectQuestionOption[];
+} | {
+    type: "multi-select";
+    value?: string[] | null;
+    options: SelectQuestionOption[];
+} | {
+    type: "numeric";
+    value?: number | null;
+} | {
+    type: "link";
+    value?: string | null;
+} | {
+    type: "date";
+    value?: Date | null;
+});
+
+export declare type OnChangeSectionParams = {
+    id: string;
+    title: string;
+    description?: string;
+    questions?: QuestionElement[];
+};
+
+export declare type OnDuplicateElementParams = {
+    elementId: string;
+    type: ElementType;
+};
+
 export declare const OneAlert: ({ title, description, action, link, icon, variant, }: AlertProps) => JSX_2.Element;
 
 export declare const OneApprovalHistory: FC<OneApprovalHistoryProps>;
@@ -4607,6 +4758,28 @@ declare type Pulse = (typeof pulses)[number];
 
 declare const pulses: readonly ["superNegative", "negative", "neutral", "positive", "superPositive"];
 
+export declare type QuestionActionParams = {
+    questionId: string;
+    type: ActionType;
+    index: number;
+};
+
+export declare type QuestionElement = Omit<TextQuestionProps, QuestionPropsToOmit> | Omit<RatingQuestionProps & {
+    type: "rating";
+}, QuestionPropsToOmit> | Omit<SelectQuestionProps & {
+    type: "select" | "multi-select";
+}, QuestionPropsToOmit> | Omit<NumericQuestionProps & {
+    type: "numeric";
+}, QuestionPropsToOmit> | Omit<LinkQuestionProps & {
+    type: "link";
+}, QuestionPropsToOmit> | Omit<DateQuestionProps & {
+    type: "date";
+}, QuestionPropsToOmit>;
+
+declare type QuestionPropsToOmit = "onAction" | "onChange" | "onAddNewElement";
+
+export declare type QuestionType = "rating" | "select" | "multi-select" | "text" | "longText" | "numeric" | "link" | "date";
+
 /**
  * @experimental This is an experimental component use it at your own risk
  */
@@ -4624,6 +4797,15 @@ export declare type RadarChartProps<K extends ChartConfig> = {
 
 export declare const rangeSeparator = "\u2192";
 
+declare type RatingQuestionProps = BaseQuestionPropsForOtherQuestionComponents & {
+    value?: number;
+} & {
+    options: {
+        value: number;
+        label: string;
+    }[];
+};
+
 declare interface ReactionProps {
     emoji: string;
     initialCount: number;
@@ -4792,9 +4974,25 @@ export declare type secondaryActionType = (actionType | toggleActionType) & {
     type?: "button" | "switch";
 };
 
+export declare type SectionActionParams = {
+    sectionId: string;
+    type: ActionType;
+    index: number;
+};
+
+export declare type SectionElement = Omit<SectionProps, "onAction" | "onChange">;
+
 export declare const SectionHeader: ({ title, description, action, link, separator, }: Props_2) => JSX_2.Element;
 
 declare type SectionProps = {
+    id: string;
+    title: string;
+    description?: string;
+    locked?: boolean;
+    questions?: QuestionElement[];
+};
+
+declare type SectionProps_2 = {
     title: string;
     items: Omit<ActivityItemProps, "onClick">[];
     onClickItem: (id: string) => void;
@@ -4888,6 +5086,23 @@ export declare type SelectProps<T extends string, R = unknown> = {
     options: SelectItemProps<T, unknown>[];
 }) & Pick<InputFieldProps<T>, "required" | "loading" | "hideLabel" | "clearable" | "labelIcon" | "size" | "label" | "icon" | "placeholder" | "disabled" | "name" | "error" | "status" | "hint">;
 
+export declare type SelectQuestionOption = {
+    id?: string;
+    value: string;
+    label: string;
+    correct?: boolean;
+};
+
+declare type SelectQuestionProps = BaseQuestionPropsForOtherQuestionComponents & {
+    options: SelectQuestionOption[];
+} & ({
+    type: "select";
+    value?: string | null;
+} | {
+    type: "multi-select";
+    value?: string[] | null;
+});
+
 export declare const selectSizes: readonly ["sm", "md"];
 
 export declare function Shortcut({ keys, variant }: ShortcutProps): JSX_2.Element | null;
@@ -5319,7 +5534,7 @@ declare const TeamItem: ForwardRefExoticComponent<TeamItemProps & RefAttributes<
 
 declare type TeamItemProps = {
     name: string;
-    action?: ActionType;
+    action?: ActionType_2;
 };
 
 export declare const Textarea: React.FC<TextareaProps>;
@@ -5330,6 +5545,11 @@ declare const Textarea_2: React_2.ForwardRefExoticComponent<Omit<React_2.Textare
 
 export declare type TextareaProps = Pick<ComponentProps<typeof Textarea_2>, "disabled" | "onChange" | "value" | "placeholder" | "rows" | "cols" | "label" | "labelIcon" | "icon" | "hideLabel" | "maxLength" | "clearable" | "onBlur" | "onFocus" | "name" | "status" | "hint" | "error">;
 
+declare type TextQuestionProps = BaseQuestionPropsForOtherQuestionComponents & {
+    type: "text" | "longText";
+    value?: string | null;
+};
+
 declare const THEMES: {
     readonly light: "";
     readonly dark: ".dark";
@@ -5911,6 +6131,31 @@ 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: {
@@ -5938,31 +6183,6 @@ declare module "@tiptap/core" {
 }
 
 
-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> {
         moodTracker: {