@factorialco/f0-react 4.3.2 → 4.4.0

package/dist/experimental.js

@@ -2,8 +2,8 @@ import { h as ga, B as pa, i as ba, j as xa, k as Dt, l as Be, m as Te, n as va,
 import { c2 as Kc, c1 as qc, ce as Yc, b_ as Jc, b$ as Zc, bS as Xc, bT as Qc, ch as ed, bU as td, bV as nd, ci as ad, c0 as rd, ca as id, cb as ld, cf as sd, bW as od, c4 as cd, c3 as dd, bX as ud, bY as fd, cc as md, cj as hd, cd as gd, cg as pd, c9 as bd, c6 as xd, c8 as vd, c5 as yd, bZ as wd, c7 as Nd } from "./F0CanvasPanel-QUIIThsf.js";
 import { jsx as e, jsxs as o, Fragment as Z } from "react/jsx-runtime";
 import ue, { forwardRef as G, useRef as j, useTransition as ni, useState as D, useLayoutEffect as Tn, useId as pt, useContext as Pe, createContext as Qe, useEffect as W, useCallback as ne, useMemo as q, Fragment as ai, isValidElement as ri, cloneElement as zn, Children as Rn } from "react";
-import { C as ii, P as li, a as Bn, M as si, p as oi, b as ci, R as Mt, c as $n, u as di, d as ui, e as fi, f as mi, g as hi, h as Mn, S as gi, A as pi, B as bi, L as xi, i as vi, V as yi, j as wi, k as Ni, l as Ci, O as Ii } from "./useDataCollectionSource-CKC4IqL-.js";
-import { r as Id, s as kd, o as Sd, H as Fd, t as Ad, z as Ld, a8 as Od, G as Pd, q as Ed, aa as _d, a9 as Dd, Q as Td, ad as zd, F as Rd, Y as Bd, U as $d, J as Md, af as Wd, K as jd, Z as Vd, _ as Ud, v as Hd, ab as Gd, ac as Kd, N as qd, $ as Yd, a5 as Jd, a7 as Zd, w as Xd, y as Qd, D as eu, W as tu, ae as nu, X as au, T as ru, ag as iu, x as lu, E as su, m as ou, n as cu, a1 as du, a2 as uu, a6 as fu, I as mu, a3 as hu, a0 as gu, a4 as pu } from "./useDataCollectionSource-CKC4IqL-.js";
+import { C as ii, P as li, a as Bn, M as si, p as oi, b as ci, R as Mt, c as $n, u as di, d as ui, e as fi, f as mi, g as hi, h as Mn, S as gi, A as pi, B as bi, L as xi, i as vi, V as yi, j as wi, k as Ni, l as Ci, O as Ii } from "./useDataCollectionSource-BKj2I6LP.js";
+import { r as Id, s as kd, o as Sd, H as Fd, t as Ad, z as Ld, a8 as Od, G as Pd, q as Ed, aa as _d, a9 as Dd, Q as Td, ad as zd, F as Rd, Y as Bd, U as $d, J as Md, af as Wd, K as jd, Z as Vd, _ as Ud, v as Hd, ab as Gd, ac as Kd, N as qd, $ as Yd, a5 as Jd, a7 as Zd, w as Xd, y as Qd, D as eu, W as tu, ae as nu, X as au, T as ru, ag as iu, x as lu, E as su, m as ou, n as cu, a1 as du, a2 as uu, a6 as fu, I as mu, a3 as hu, a0 as gu, a4 as pu } from "./useDataCollectionSource-BKj2I6LP.js";
 const ki = ga("Search", [
   ["circle", { cx: "11", cy: "11", r: "8", key: "4ej97u" }],
   ["path", { d: "m21 21-4.3-4.3", key: "1qie3q" }]

package/dist/f0.d.ts

@@ -5098,26 +5098,6 @@ declare type DetailsItemContent = (ComponentProps<typeof DataList.Item> & {
     type: "file";
 });
 
-/**
- * Imperative API for centered dialogs. Requires `<F0Provider>` (which mounts
- * `DialogsAlikeLayoutProvider`) to be present in the tree.
- *
- * @example
- * const result = await dialog.open({ title, content, actions: { primary: { label: "OK", value: true } } })
- */
-export declare const dialog: {
-    /** Open a dialog. Resolves with the value of the action the user picked. */
-    open: (definition: Optional<DialogDefinition, "id">) => Promise<DialogActionValue>;
-    /** Open a notification-style dialog (info/warning/critical/positive). */
-    notification: (options: NotificationDialogOptions) => Promise<DialogActionValue>;
-    /** Notification dialog with a single confirm action (defaults to "Ok"). */
-    alert: (options: AlertDialogOptions) => Promise<DialogActionValue>;
-    /** Notification dialog with confirm + cancel actions (defaults to Ok/Cancel). */
-    confirm: (options: ConfirmDialogOptions) => Promise<DialogActionValue>;
-    /** Programmatically close a dialog by id (resolves its promise with undefined). */
-    close: (id: DialogId) => void;
-};
-
 export declare type DialogAction = Optional<Pick<F0ButtonProps, "label" | "icon" | "disabled">, "icon" | "disabled"> & {
     value: DialogActionValue;
     keepOpen?: boolean;
@@ -5218,6 +5198,28 @@ export declare type DialogPosition = (typeof dialogPositions)[number];
 
 declare const dialogPositions: readonly ["center", "left", "right", "fullscreen"];
 
+/**
+ * Imperative API for centered dialogs. Requires `<F0Provider>` (which mounts
+ * `DialogsAlikeLayoutProvider`) to be present in the tree.
+ *
+ * @example
+ * import { dialogs } from "@factorialco/f0-react"
+ *
+ * const result = await dialogs.open({ title, content, actions: { primary: { label: "OK", value: true } } })
+ */
+export declare const dialogs: {
+    /** Open a dialog. Resolves with the value of the action the user picked. */
+    open: (definition: Optional<DialogDefinition, "id">) => Promise<DialogActionValue>;
+    /** Open a notification-style dialog (info/warning/critical/positive). */
+    notification: (options: NotificationDialogOptions) => Promise<DialogActionValue>;
+    /** Notification dialog with a single confirm action (defaults to "Ok"). */
+    alert: (options: AlertDialogOptions) => Promise<DialogActionValue>;
+    /** Notification dialog with confirm + cancel actions (defaults to Ok/Cancel). */
+    confirmation: (options: ConfirmDialogOptions) => Promise<DialogActionValue>;
+    /** Programmatically close a dialog by id (resolves its promise with undefined). */
+    close: (id: DialogId) => void;
+};
+
 declare type DialogSimpleAction = {
     label?: string;
     value?: DialogActionValue;
@@ -5304,19 +5306,6 @@ export declare type DragPayload<T = unknown> = {
     data?: T;
 };
 
-/**
- * Imperative API for side drawers. Requires `<F0Provider>` to be present.
- *
- * @example
- * const result = await drawer.open({ title, content, actions: { primary: { label: "Save", value: "save" } } })
- */
-export declare const drawer: {
-    /** Open a drawer. Resolves with the value of the action the user picked. */
-    open: (definition: Optional<DrawerDefinition, "id">) => Promise<DialogActionValue>;
-    /** Programmatically close a drawer by id (resolves its promise with undefined). */
-    close: (id: DialogId) => void;
-};
-
 export declare type DrawerDefinition = {
     /** The size of the drawer. */
     size?: DrawerSize;
@@ -5348,6 +5337,21 @@ export declare type DrawerDefinition = {
 
 declare const drawerPositions: readonly ["left", "right"];
 
+/**
+ * Imperative API for side drawers. Requires `<F0Provider>` to be present.
+ *
+ * @example
+ * import { drawers } from "@factorialco/f0-react"
+ *
+ * const result = await drawers.open({ title, content, actions: { primary: { label: "Save", value: "save" } } })
+ */
+export declare const drawers: {
+    /** Open a drawer. Resolves with the value of the action the user picked. */
+    open: (definition: Optional<DrawerDefinition, "id">) => Promise<DialogActionValue>;
+    /** Programmatically close a drawer by id (resolves its promise with undefined). */
+    close: (id: DialogId) => void;
+};
+
 declare type DrawerSize = (typeof drawerSizes)[number];
 
 declare const drawerSizes: readonly ["md"];
@@ -11379,6 +11383,23 @@ export declare interface FormFieldProps {
     ref?: React.RefCallback<HTMLElement>;
 }
 
+/**
+ * Imperative API for opening forms. Pick the presentation with `mode` —
+ * `"dialog"` for a single-screen form, `"wizard"` for a multi-step form.
+ * Requires `<F0Provider>` to be mounted.
+ *
+ * @example
+ * const result = await forms.open({ formDefinition, mode: "dialog", title: "Add member" })
+ * if (result.submitted) save(result.data)
+ *
+ * @example
+ * const result = await forms.open({ formDefinition, mode: "wizard", title: "Onboarding" })
+ * if (result.completed) save(result.data)
+ */
+export declare const forms: {
+    open: typeof openForm;
+};
+
 /** Fraction tokens for proportional widths */
 export declare type FractionToken = "1/2" | "1/3" | "2/3" | "1/4" | "2/4" | "3/4" | "1/5" | "2/5" | "3/5" | "4/5" | "1/6" | "5/6";
 
@@ -13471,6 +13492,78 @@ export declare type OnSelectItemsCallback<R extends RecordType, Filters extends
     byLane?: Record<string, SelectedItemsDetailedStatus<R, Filters>>;
 }, clearSelectedItems: () => void, handleSelectAll?: (checked: boolean) => void) => void;
 
+/** Open a form in a dialog. */
+declare function openForm<TSchema extends F0FormSchema_2>(options: {
+    mode: "dialog";
+} & OpenFormDialogOptions<TSchema>): Promise<OpenFormDialogResult<TSchema>>;
+
+/** Open a form in a multi-step wizard. */
+declare function openForm<T extends F0FormSchema_2 | F0PerSectionSchema_2>(options: {
+    mode: "wizard";
+} & OpenFormWizardOptions<T>): Promise<OpenFormWizardResult<T>>;
+
+export declare type OpenFormDialogOptions<TSchema extends F0FormSchema_2> = {
+    /** The form definition created with `useF0FormDefinition`. */
+    formDefinition: F0FormDefinitionSingleSchema<TSchema>;
+    /** The dialog title. */
+    title: string;
+    /** Optional supporting description below the title. */
+    description?: string;
+    /** The dialog size. @default "md" */
+    size?: F0DialogSize;
+    /** Module shown in the dialog header. */
+    module?: DialogModule;
+    /**
+     * When true, the dialog can only be closed via its actions (no overlay click
+     * or Escape) — so in-progress input isn't lost by an accidental dismissal.
+     * @default true
+     */
+    modal?: boolean;
+    /** Overlay id. Auto-generated if not provided. */
+    id?: DialogId;
+    /** Override the footer button labels (default to i18n save/cancel). */
+    labels?: {
+        submit?: string;
+        cancel?: string;
+    };
+};
+
+export declare type OpenFormDialogResult<TSchema extends F0FormSchema_2> = {
+    submitted: true;
+    data: z.infer<TSchema>;
+} | {
+    submitted: false;
+};
+
+export declare type OpenFormWizardOptions<T extends F0FormSchema_2 | F0PerSectionSchema_2> = {
+    /** The form definition created with `useF0FormDefinition`. */
+    formDefinition: F0FormDefinition<T>;
+    /** The wizard dialog title. */
+    title?: string;
+    /** The wizard dialog size. */
+    size?: F0DialogSize;
+    /** Overlay id. Auto-generated if not provided. */
+    id?: DialogId;
+    /** Custom step definitions (otherwise derived from sections). */
+    steps?: F0WizardFormStep[];
+    /** Step to open on. */
+    defaultStepIndex?: number;
+    nextLabel?: string;
+    previousLabel?: string;
+    /** Allow clicking ahead to non-incomplete steps. @default false */
+    allowStepSkipping?: boolean;
+    /** Skip to the first incomplete step on open. @default false */
+    autoSkipCompletedSteps?: boolean;
+    onStepChanged?: (stepIndex: number) => void;
+};
+
+export declare type OpenFormWizardResult<T extends F0FormSchema_2 | F0PerSectionSchema_2> = {
+    completed: true;
+    data: WizardData<T>;
+} | {
+    completed: false;
+};
+
 declare type Optional<T, K extends keyof T> = Pick<Partial<T>, K> & Omit<T, K>;
 
 /** Overflow values */
@@ -16944,6 +17037,8 @@ declare interface WithTooltipDescription {
     description?: string;
 }
 
+declare type WizardData<T extends F0FormSchema_2 | F0PerSectionSchema_2> = T extends F0FormSchema_2 ? z.infer<T> : T extends F0PerSectionSchema_2 ? InferPerSectionValues_2<T> : never;
+
 /**
  * Synchronously persists a OneDataCollection's state to localStorage, mirroring
  * `readDataCollectionStorage`. Uses the same `datacollection-` prefixed key as