@factorialco/f0-react 4.43.0 → 4.45.0

package/dist/f0.d.ts

@@ -4962,6 +4962,8 @@ export declare const defaultTranslations: {
         readonly closePreview: "Close";
         readonly previousImage: "Previous image";
         readonly nextImage: "Next image";
+        readonly openDocument: "Open document";
+        readonly documentPreview: "Document preview";
         readonly photo: "Photo";
         readonly photoCount: {
             readonly one: "{{count}} photo";
@@ -5207,6 +5209,10 @@ export declare const defaultTranslations: {
             readonly addBlockedHint: "Finish filling out the last item you just added in order to add another one";
             readonly addBlockedErrorHint: "Fix the errors in the existing items before adding another one";
             readonly addBlockedMaxHint: "You've reached the maximum number of items";
+            readonly removeConfirmTitle: "Remove item?";
+            readonly removeConfirmMessage: "This item will be removed. This action cannot be undone.";
+            readonly removeError: "Couldn't remove the item. Please try again.";
+            readonly removeErrorTitle: "Remove failed";
         };
         readonly moreInformation: "More information";
         readonly validation: {
@@ -5269,6 +5275,11 @@ export declare const defaultTranslations: {
         readonly print: "Print";
         readonly download: "Download";
         readonly loading: "Loading document";
+        readonly previewFailed: "Preview isn't available for this file";
+        readonly showingFirstRows: {
+            readonly one: "Showing the first row";
+            readonly other: "Showing the first {{count}} rows";
+        };
     };
 };
 
@@ -8701,6 +8712,15 @@ export declare type F0DialogSecondaryActionItem = F0DialogActionItem;
 
 declare type F0DialogSize = (typeof dialogSizes)[number];
 
+/**
+ * Document families the viewer can render. "pdf" is the default and keeps the
+ * full toolbar (paging, zoom, print, download); the other kinds render a
+ * lazy-loaded, read-only preview: "sheet" (xlsx/xls/csv) as an Excel-style
+ * grid with one tab per sheet, "docx" through docx-preview with page layout,
+ * and "text" as a rendered markdown document (`.md`) or monospaced source.
+ */
+export declare type F0DocumentKind = "pdf" | "sheet" | "docx" | "text";
+
 /**
  * @experimental This is an experimental component use it at your own risk
  */
@@ -8880,12 +8900,20 @@ declare type F0EntitiesListField = F0BaseField & {
     labels?: F0EntitiesListLabels;
     /** Ids of the items that can be edited (matched against `item.id`) */
     editableIds?: Array<string | number>;
+    /** Ids of the items that can be removed (matched against `item.id`) */
+    removableIds?: Array<string | number>;
     /** Maximum number of rows allowed */
     maxItems?: number;
     /** Per-column presentation options, keyed by item-schema property name */
     columns?: Record<string, F0EntitiesListColumnConfig>;
     /** Custom trailing actions per row (resolved per row) */
     rowActions?: (item: EntitiesListItem, index: number) => F0EntitiesListRowAction[];
+    /** Persistence hook for removing a row (runs after the user confirms) */
+    onRemove?: (item: EntitiesListItem) => Promise<{
+        success: boolean;
+    } | void>;
+    /** Per-item confirmation copy for the remove action */
+    confirmRemove?: (item: EntitiesListItem) => ConfirmDialogOptions;
     /** Conditional rendering based on another field's value */
     renderIf?: EntitiesListFieldRenderIf;
 };
@@ -9017,6 +9045,16 @@ declare interface F0EntitiesListOptions<T = EntitiesListItem> {
      * (pencil) action that opens the edit dialog.
      */
     editableIds?: Array<string | number>;
+    /**
+     * Restricts which items can be removed, matched against each item's `id`
+     * property. The remove counterpart to {@link editableIds}, and independent
+     * of it — a row can be editable but not removable, or vice versa. When
+     * omitted, every item is removable. Items without an `id` (e.g. rows just
+     * added by the user and not yet persisted) stay removable. A row hidden from
+     * this list shows no remove action (`list-view`) / no remove button
+     * (`editable-table`).
+     */
+    removableIds?: Array<string | number>;
     /** Minimum number of rows required (defaults to 1 unless the field is optional) */
     minItems?: number;
     /** Maximum number of rows allowed. When reached the add button is hidden. */
@@ -9030,6 +9068,28 @@ declare interface F0EntitiesListOptions<T = EntitiesListItem> {
      * update or remove the row.
      */
     rowActions?: (item: T, index: number) => F0EntitiesListRowAction<T>[];
+    /**
+     * Persistence hook for removing a row — the delete counterpart to
+     * `createFormDefinition` (add) and `updateFormDefinition` (edit). Called with
+     * the row's item **after** the user confirms the destructive action. Return
+     * `{ success: false }` or throw to keep the row and surface an error; return
+     * `{ success: true }` (or nothing) to drop it from the field value.
+     *
+     * When omitted, removal is value-only (the row is spliced from the array with
+     * no network call) — but the confirmation is still shown, per the CRUD
+     * "Delete & destructive" guidance.
+     */
+    onRemove?: (item: T) => Promise<{
+        success: boolean;
+    } | void>;
+    /**
+     * Per-item confirmation copy for the remove action, so callers can **name the
+     * resource** and its scope (per the CRUD "Delete & destructive" doc). Receives
+     * the row item and returns the confirmation dialog options
+     * (`title`, `msg`, `type`, `confirm`/`cancel` labels). When omitted, a generic
+     * default confirmation is shown.
+     */
+    confirmRemove?: (item: T) => ConfirmDialogOptions;
 }
 
 /**
@@ -10635,11 +10695,34 @@ export declare const F0PdfViewer: WithDataTestIdReturnType_3<ForwardRefExoticCom
 Skeleton: () => JSX_2.Element;
 }>;
 
+/**
+ * Host-provided toolbar action, appended after the built-in controls in every
+ * kind — e.g. a Close button when the viewer lives inside a fullscreen overlay.
+ */
+export declare type F0PdfViewerAction = {
+    icon: IconType;
+    label: string;
+    onClick: () => void;
+};
+
 export declare interface F0PdfViewerProps extends WithDataTestIdProps, DataAttributes_2 {
-    /** Source URL of the PDF document. */
+    /** Source URL of the document. */
     url: string;
     /** File name used when downloading the document. Defaults to "document.pdf". */
     filename?: string;
+    /**
+     * Document family to render. Defaults to "pdf" (unchanged behavior). For the
+     * other kinds the PDF-only props below (page, scale, rotation, print…) are
+     * ignored.
+     */
+    kind?: F0DocumentKind;
+    /** MIME type of the document — used by kind "text" to detect markdown. */
+    mimeType?: string;
+    /**
+     * Custom actions appended to the toolbar (after the built-in controls), in
+     * every kind — e.g. a Close button when the viewer fills an overlay.
+     */
+    actions?: F0PdfViewerAction[];
     /** Zero-based page index to scroll to initially (and on change). */
     page?: number;
     /** Restrict rendering to a subset of pages (zero-based indexes). */