@factorialco/f0-react 1.388.4 → 1.389.0

package/dist/experimental.d.ts

@@ -1738,6 +1738,8 @@ declare type CompareToDef = {
 
 declare type CompareToDefKey = string;
 
+export declare function computeSectionEndIds(elements: CoCreationFormElement[]): Set<string>;
+
 declare type Content = (ComponentProps<typeof DataList.Item> & {
     type: "item";
 }) | (ComponentProps<typeof DataList.PersonItem> & {
@@ -2677,6 +2679,8 @@ declare const defaultTranslations: {
             readonly deleteQuestion: "Delete question";
             readonly duplicateSection: "Duplicate section";
             readonly deleteSection: "Delete section";
+            readonly confirmMoveLastQuestion: "Move question";
+            readonly cancelMoveLastQuestion: "Cancel";
         };
         readonly questionTypes: {
             readonly section: "Section";
@@ -2688,6 +2692,7 @@ declare const defaultTranslations: {
             readonly numeric: "Numeric";
             readonly link: "Link";
             readonly date: "Date";
+            readonly dropdownSingle: "Dropdown";
         };
         readonly selectQuestion: {
             readonly addOption: "Add option";
@@ -2714,6 +2719,8 @@ declare const defaultTranslations: {
             readonly questionOptions: "Question options";
             readonly actions: "Actions";
             readonly sectionTitlePlaceholder: "Section title";
+            readonly lastQuestionDialogTitle: "Remove last question from section";
+            readonly lastQuestionDialogDescription: "Moving this question will leave the section empty and it will be removed. Do you want to continue?";
         };
     };
     readonly richTextEditor: {
@@ -3813,6 +3820,20 @@ declare type FlagAvatarVariant = Extract<AvatarVariant, {
     type: "flag";
 }>;
 
+export declare type FlatFormItem = {
+    type: "section-header";
+    id: string;
+    section: SectionElement;
+} | {
+    type: "question";
+    id: string;
+    question: QuestionElement;
+} | {
+    type: "section-end";
+    id: string;
+    sectionId: string;
+};
+
 export declare type FlattenedItem = {
     parent: EntitySelectEntity | null;
     subItem: EntitySelectSubEntity & {
@@ -3821,6 +3842,8 @@ export declare type FlattenedItem = {
     };
 };
 
+export declare function flattenElements(elements: CoCreationFormElement[]): FlatFormItem[];
+
 declare type FontSize = (typeof fontSizes)[number];
 
 declare const fontSizes: readonly ["sm", "md", "lg"];
@@ -4137,6 +4160,21 @@ export declare type InfiniteScrollPaginatedResponse<TRecord> = BasePaginatedResp
     hasMore: boolean;
 };
 
+/**
+ * Re-inject section-end markers into a flat list that has none.
+ *
+ * Uses `inSectionQuestionIds` (the set of question IDs that originally
+ * belonged to *any* section) to determine where each section ends:
+ * - Questions in the set stay inside the current section.
+ * - Original standalone questions (NOT in the set) cause the section to close
+ *   before them so they remain standalone.
+ *
+ * This allows cross-section moves (a question from section B placed after
+ * section A's header joins section A) while keeping standalone questions
+ * outside sections unless the user explicitly drags them between section items.
+ */
+export declare function injectSectionEnds(items: FlatFormItem[], inSectionQuestionIds: Set<string>): FlatFormItem[];
+
 /**
  * @experimental This is an experimental component use it at your own risk
  */
@@ -5733,6 +5771,8 @@ declare interface ReactionsProps {
     };
 }
 
+export declare function reconstructElements(flatItems: FlatFormItem[]): CoCreationFormElement[];
+
 /**
  * Utility type to get all possible paths through an object using dot notation
  * @template T - The object type to traverse
@@ -6498,8 +6538,27 @@ export declare type TOCItemAction = {
     label: string;
     onClick: () => void;
     icon?: IconType;
+    critical?: boolean;
+    /** Show a check icon to indicate this item is selected */
+    selected?: boolean;
 } | {
     type: "separator";
+} | {
+    type: "label";
+    text: string;
+} | {
+    type: "toggle";
+    label: string;
+    icon?: IconType;
+    checked: boolean;
+    onCheckedChange: (checked: boolean) => void;
+} | {
+    type: "submenu";
+    label: string;
+    icon?: IconType;
+    /** Currently selected option label shown inline */
+    selectedLabel?: string;
+    children: TOCItemAction[];
 };
 
 declare interface TOCItemProps {