@nextlyhq/plugin-form-builder 0.0.2-alpha.60 → 0.0.2-alpha.64

package/README.md

@@ -1,6 +1,6 @@
 # @nextlyhq/plugin-form-builder
 
-Drag-and-drop form builder plugin for Nextly. Build forms visually, collect submissions, and filter them by form. _Coming soon in beta._
+Drag-and-drop form builder plugin for Nextly. Build forms visually, collect submissions, and filter them by form.
 
 <p align="center">
   <a href="https://www.npmjs.com/package/@nextlyhq/plugin-form-builder"><img alt="npm" src="https://img.shields.io/npm/v/@nextlyhq/plugin-form-builder?style=flat-square&label=npm&color=cb3837" /></a>
@@ -8,11 +8,10 @@ Drag-and-drop form builder plugin for Nextly. Build forms visually, collect subm
   <a href="https://nextlyhq.com/docs"><img alt="Status" src="https://img.shields.io/badge/status-alpha-orange?style=flat-square" /></a>
 </p>
 
-> [!WARNING]
-> **Coming soon in beta. Plugins are not ready for use yet.** Public plugin support, including stable APIs, the official plugin gallery, and documentation guarantees, lands at the Nextly **beta** release. This package is published for early exploration only. Surfaces, names, and behaviour will change without notice. Do not rely on plugins for production or serious development work. Wait for the beta release announcement before integrating plugins into your project.
-
 > [!IMPORTANT]
-> Nextly is in alpha. APIs may change before 1.0. Pin exact versions in production.
+> Nextly is in alpha. APIs may change before 1.0 — pin exact versions in production.
+> See the [plugin stability ladder](https://nextlyhq.com/docs/plugins/stability) for
+> which plugin surfaces are stable and which are experimental.
 
 ## What it is
 

package/dist/admin/index.d.ts

@@ -1,6 +1,6 @@
-import { ComponentPath } from '@nextlyhq/plugin-sdk/admin';
+import { DocumentLockGates, ComponentPath } from '@nextlyhq/plugin-sdk/admin';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { q as FormField, s as FormFieldTypeId, A as AnyFormField, b as FormSettings, v as FormNotification } from '../types-DuEFdLNU.js';
+import { q as FormField, s as FormFieldTypeId, A as AnyFormField, b as FormSettings, v as FormNotification } from '../types-hLfLe81K.js';
 import { FormFieldCatalogType, FieldTypeCatalogEntry } from 'nextly/field-catalog';
 import { ReactNode } from 'react';
 import 'nextly';
@@ -17,6 +17,7 @@ interface FormBuilderViewProps {
         slug?: string;
         description?: string;
         status?: "draft" | "published" | "closed";
+        closedMessage?: string;
         fields?: unknown[];
         settings?: Record<string, unknown>;
         notifications?: unknown[];
@@ -24,8 +25,18 @@ interface FormBuilderViewProps {
     onSave?: (data: unknown) => void;
     onSuccess?: (entry?: Record<string, unknown>) => void;
     onCancel?: () => void;
+    /**
+     * What a colleague's claim on this form withholds, handed over by the admin
+     * page that renders this view.
+     *
+     * The strip above this builder says in words that unsaved changes cannot be
+     * saved while someone else holds the document. Committing anyway would make
+     * that sentence false and would overwrite the holder's row, so the save reads
+     * it too.
+     */
+    documentLock?: DocumentLockGates;
 }
-declare function FormBuilderView({ id, entryId, collection, collectionSlug, isCreating, initialData, onSave, onSuccess, onCancel, }: FormBuilderViewProps): react_jsx_runtime.JSX.Element;
+declare function FormBuilderView({ id, entryId, collection, collectionSlug, isCreating, initialData, onSave, onSuccess, onCancel, documentLock, }: FormBuilderViewProps): react_jsx_runtime.JSX.Element;
 
 interface SubmissionRow {
     id: string;
@@ -156,6 +167,8 @@ interface FormBuilderState {
         slug: string;
         description?: string;
         status: "draft" | "published" | "closed";
+        /** What a closed form tells a visitor who reaches it. */
+        closedMessage?: string;
     };
     /** Form settings */
     settings: FormSettings;
@@ -206,12 +219,24 @@ interface FormBuilderProviderProps {
         slug?: string;
         description?: string;
         status?: "draft" | "published" | "closed";
+        closedMessage?: string;
         fields?: AnyFormField[];
         settings?: Partial<FormSettings>;
         notifications?: FormNotification[];
     };
     /** Child components */
     children: ReactNode;
+    /**
+     * The document belongs to someone else right now, so nothing here may change
+     * it.
+     *
+     * Held here rather than at each control because the builder has dozens of
+     * them across four tabs, and a rule spelled at every one is a rule one new
+     * control forgets. Reading is untouched: the editor still browses fields,
+     * switches tabs and opens settings, which is exactly what the strip above
+     * offers them.
+     */
+    readOnly?: boolean;
 }
 /** Default form settings (the canonical defaults from the settings reader) */
 declare const DEFAULT_SETTINGS: FormSettings;
@@ -247,7 +272,7 @@ declare function createFieldFromType(type: FormFieldTypeId, existingNames?: read
  * </FormBuilderProvider>
  * ```
  */
-declare function FormBuilderProvider({ initialData, children, }: FormBuilderProviderProps): react_jsx_runtime.JSX.Element;
+declare function FormBuilderProvider({ initialData, children, readOnly, }: FormBuilderProviderProps): react_jsx_runtime.JSX.Element;
 /**
  * useFormBuilder - Access form builder context
  *
@@ -293,8 +318,20 @@ interface SpamDefaults {
 interface FormSettingsTabProps {
     /** Plugin-level spam defaults (from builder-config); null while loading. */
     spamDefaults: SpamDefaults | null;
+    /**
+     * Collections a form may redirect to (from builder-config); null while
+     * loading. Empty means the site configured none, and the option is not
+     * offered — choosing it could only ever produce a form with no destination.
+     */
+    redirectCollections: string[] | null;
+    /**
+     * The configuration request failed, as distinct from returning nothing. An
+     * empty list is a valid answer; a failure is not an answer at all, and
+     * saying "no collection is configured" on a 403 states something false.
+     */
+    redirectConfigFailed: boolean;
 }
-declare function FormSettingsTab({ spamDefaults }: FormSettingsTabProps): react_jsx_runtime.JSX.Element;
+declare function FormSettingsTab({ spamDefaults, redirectCollections, redirectConfigFailed, }: FormSettingsTabProps): react_jsx_runtime.JSX.Element;
 
 /** Host-level notification defaults surfaced by the builder-config route. */
 interface NotificationDefaults {