@nextlyhq/plugin-form-builder 0.0.2-alpha.68 → 0.0.2-alpha.69

package/README.md

@@ -104,11 +104,11 @@ See the [Field types reference](https://nextlyhq.com/docs/plugins/form-builder#f
 
 ## Compatibility
 
-| Tool              | Version               |
-| ----------------- | --------------------- |
-| Node.js           | 20.19+, 22.12+ or 24+ |
-| `nextly`          | 0.0.x                 |
-| `@nextlyhq/admin` | 0.0.x                 |
+| Tool              | Version       |
+| ----------------- | ------------- |
+| Node.js           | 22.12+ or 24+ |
+| `nextly`          | 0.0.x         |
+| `@nextlyhq/admin` | 0.0.x         |
 
 Plugins can break across minor versions during alpha. Pin exact versions of `nextly`, `@nextlyhq/admin`, and this plugin together.
 

package/dist/admin/index.d.ts

@@ -1,122 +1,114 @@
-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-Bo4lk9BD.js';
-import { FormFieldCatalogType, FieldTypeCatalogEntry } from 'nextly/field-catalog';
-import { ReactNode } from 'react';
-import 'nextly';
-
+import { S as FormNotification, T as FormSettings, _ as FormField, t as AnyFormField, y as FormFieldTypeId } from "../types-BHReIA0j.js";
+import { ComponentPath, DocumentLockGates } from "@nextlyhq/plugin-sdk/admin";
+import React, { JSX, ReactNode } from "react";
+import { FieldTypeCatalogEntry, FormFieldCatalogType } from "nextly/field-catalog";
 interface FormBuilderViewProps {
+  id?: string;
+  entryId?: string;
+  collection?: string;
+  collectionSlug?: string;
+  isCreating?: boolean;
+  initialData?: {
     id?: string;
-    entryId?: string;
-    collection?: string;
-    collectionSlug?: string;
-    isCreating?: boolean;
-    initialData?: {
-        id?: string;
-        name?: string;
-        slug?: string;
-        description?: string;
-        status?: "draft" | "published" | "closed";
-        closedMessage?: string;
-        fields?: unknown[];
-        settings?: Record<string, unknown>;
-        notifications?: unknown[];
-    };
-    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;
+    name?: string;
+    slug?: string;
+    description?: string;
+    status?: "draft" | "published" | "closed";
+    closedMessage?: string;
+    fields?: unknown[];
+    settings?: Record<string, unknown>;
+    notifications?: unknown[];
+  };
+  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, documentLock, }: FormBuilderViewProps): react_jsx_runtime.JSX.Element;
-
+export declare function FormBuilderView({ id, entryId, collection, collectionSlug, isCreating, initialData, onSave, onSuccess, onCancel, documentLock }: FormBuilderViewProps): JSX.Element;
 interface SubmissionRow {
+  id: string;
+  form: string | {
     id: string;
-    form: string | {
-        id: string;
-        name?: string;
-    };
-    data: Record<string, unknown>;
-    status: string;
-    spamReason?: string | null;
-    notes?: string | null;
-    ipAddress?: string | null;
-    userAgent?: string | null;
-    submittedAt?: string | null;
-    editedAt?: string | null;
-    editedBy?: string | null;
+    name?: string;
+  };
+  data: Record<string, unknown>;
+  status: string;
+  spamReason?: string | null;
+  notes?: string | null;
+  ipAddress?: string | null;
+  userAgent?: string | null;
+  submittedAt?: string | null;
+  editedAt?: string | null;
+  editedBy?: string | null;
 }
 interface FormOption {
-    id: string;
-    name: string;
-    fields: FormField[];
+  id: string;
+  name: string;
+  fields: FormField[];
 }
 interface SubmissionsViewProps {
-    collectionSlug?: string;
+  collectionSlug?: string;
 }
-declare function SubmissionsView({ collectionSlug }: SubmissionsViewProps): react_jsx_runtime.JSX.Element;
-
+export declare function SubmissionsView({ collectionSlug }: SubmissionsViewProps): JSX.Element;
 interface SubmissionSheetProps {
-    submission: SubmissionRow;
-    form: FormOption;
-    canUpdate: boolean;
-    onClose: () => void;
-    onPrev?: () => void;
-    onNext?: () => void;
-    onSave: (changes: Record<string, unknown>) => Promise<void>;
+  submission: SubmissionRow;
+  form: FormOption;
+  canUpdate: boolean;
+  onClose: () => void;
+  onPrev?: () => void;
+  onNext?: () => void;
+  onSave: (changes: Record<string, unknown>) => Promise<void>;
 }
-declare function SubmissionSheet({ submission, form, canUpdate, onClose, onPrev, onNext, onSave, }: SubmissionSheetProps): react_jsx_runtime.JSX.Element;
-
+export declare function SubmissionSheet({ submission, form, canUpdate, onClose, onPrev, onNext, onSave }: SubmissionSheetProps): JSX.Element;
 interface FieldCardsProps {
-    /**
-     * Form-surface types the host has NOT excluded (the plugin's field
-     * enable/disable option). `null` while the host configuration is still
-     * loading — the Add dialog waits rather than flashing the unfiltered set.
-     * Types outside this set stay renderable on existing fields but cannot be
-     * added.
-     */
-    enabledTypes: readonly FormFieldCatalogType[] | null;
-    /**
-     * Type ids the host disabled (`config.fields[type] === false`). Applied to
-     * plugin field types too, so the host exclude layer is not bypassed for
-     * contributed types.
-     */
-    disabledFieldTypes?: ReadonlySet<string>;
-    /** Creates a field of the given type and returns it (context helper). */
-    onAddField: (type: FormFieldTypeId) => void;
+  /**
+   * Form-surface types the host has NOT excluded (the plugin's field
+   * enable/disable option). `null` while the host configuration is still
+   * loading — the Add dialog waits rather than flashing the unfiltered set.
+   * Types outside this set stay renderable on existing fields but cannot be
+   * added.
+   */
+  enabledTypes: readonly FormFieldCatalogType[] | null;
+  /**
+   * Type ids the host disabled (`config.fields[type] === false`). Applied to
+   * plugin field types too, so the host exclude layer is not bypassed for
+   * contributed types.
+   */
+  disabledFieldTypes?: ReadonlySet<string>;
+  /** Creates a field of the given type and returns it (context helper). */
+  onAddField: (type: FormFieldTypeId) => void;
 }
-declare function FieldCards({ enabledTypes, disabledFieldTypes, onAddField, }: FieldCardsProps): react_jsx_runtime.JSX.Element;
-
+export declare function FieldCards({ enabledTypes, disabledFieldTypes, onAddField }: FieldCardsProps): JSX.Element;
 interface AddFieldDialogProps {
-    open: boolean;
-    onOpenChange: (open: boolean) => void;
-    /**
-     * The form surface's catalog — built-ins already filtered by the host's
-     * excludes plus any plugin field types that opted into the forms surface;
-     * `null` while the host configuration is still loading. `type` is the open
-     * `FormFieldTypeId` so a plugin entry shares this shape with the built-ins.
-     */
-    entries: readonly FieldTypeCatalogEntry<FormFieldTypeId>[] | null;
-    /** Called with the chosen type; the parent creates and selects the field. */
-    onAdd: (type: FormFieldTypeId) => void;
+  open: boolean;
+  onOpenChange: (open: boolean) => void;
+  /**
+   * The form surface's catalog — built-ins already filtered by the host's
+   * excludes plus any plugin field types that opted into the forms surface;
+   * `null` while the host configuration is still loading. `type` is the open
+   * `FormFieldTypeId` so a plugin entry shares this shape with the built-ins.
+   */
+  entries: readonly FieldTypeCatalogEntry<FormFieldTypeId>[] | null;
+  /** Called with the chosen type; the parent creates and selects the field. */
+  onAdd: (type: FormFieldTypeId) => void;
 }
-declare function AddFieldDialog({ open, onOpenChange, entries, onAdd, }: AddFieldDialogProps): react_jsx_runtime.JSX.Element;
-
+export declare function AddFieldDialog({ open, onOpenChange, entries, onAdd }: AddFieldDialogProps): JSX.Element;
 interface FieldEditorProps {
-    /** The field being edited (built-in or plugin-contributed). */
-    field: AnyFormField;
-    /** All fields in the form (for conditional logic references) */
-    allFields: AnyFormField[];
-    /** Callback when field is updated */
-    onUpdate: (updates: Partial<AnyFormField>) => void;
+  /** The field being edited (built-in or plugin-contributed). */
+  field: AnyFormField;
+  /** All fields in the form (for conditional logic references) */
+  allFields: AnyFormField[];
+  /** Callback when field is updated */
+  onUpdate: (updates: Partial<AnyFormField>) => void;
 }
 /**
  * FieldEditor - Field properties configuration panel
@@ -137,128 +129,125 @@ interface FieldEditorProps {
  * />
  * ```
  */
-declare function FieldEditor({ field, allFields, onUpdate }: FieldEditorProps): react_jsx_runtime.JSX.Element;
-
+export declare function FieldEditor({ field, allFields, onUpdate }: FieldEditorProps): JSX.Element;
 interface FormPreviewProps {
-    /** Array of form fields to preview (built-in or plugin-contributed). */
-    fields: AnyFormField[];
-    /** Form metadata */
-    formData?: {
-        name?: string;
-        slug?: string;
-        description?: string;
-    };
+  /** Array of form fields to preview (built-in or plugin-contributed). */
+  fields: AnyFormField[];
+  /** Form metadata */
+  formData?: {
+    name?: string;
+    slug?: string;
+    description?: string;
+  };
 }
-declare function FormPreview({ fields, formData }: FormPreviewProps): react_jsx_runtime.JSX.Element;
-
+export declare function FormPreview({ fields, formData }: FormPreviewProps): JSX.Element;
 interface FormBuilderState {
-    /** Form fields array */
-    fields: AnyFormField[];
-    /** Currently selected field ID (name) */
-    selectedFieldId: string | null;
-    /** Active tab: builder, preview, settings, or notifications */
-    activeTab: "builder" | "preview" | "settings" | "notifications";
-    /** Whether form has unsaved changes */
-    isDirty: boolean;
-    /** Form metadata */
-    formData: {
-        id?: string;
-        name: string;
-        slug: string;
-        description?: string;
-        status: "draft" | "published" | "closed";
-        /** What a closed form tells a visitor who reaches it. */
-        closedMessage?: string;
-    };
-    /** Form settings */
-    settings: FormSettings;
-    /** Email notifications */
-    notifications: FormNotification[];
+  /** Form fields array */
+  fields: AnyFormField[];
+  /** Currently selected field ID (name) */
+  selectedFieldId: string | null;
+  /** Active tab: builder, preview, settings, or notifications */
+  activeTab: "builder" | "preview" | "settings" | "notifications";
+  /** Whether form has unsaved changes */
+  isDirty: boolean;
+  /** Form metadata */
+  formData: {
+    id?: string;
+    name: string;
+    slug: string;
+    description?: string;
+    status: "draft" | "published" | "closed";
+    /** What a closed form tells a visitor who reaches it. */
+    closedMessage?: string;
+  };
+  /** Form settings */
+  settings: FormSettings;
+  /** Email notifications */
+  notifications: FormNotification[];
 }
 interface FormBuilderActions {
-    /** Set all fields */
-    setFields: (fields: AnyFormField[]) => void;
-    /** Add a new field */
-    addField: (field: AnyFormField, index?: number) => void;
-    /** Update a field by name */
-    updateField: (fieldName: string, updates: Partial<AnyFormField>) => void;
-    /** Delete a field by name */
-    deleteField: (fieldName: string) => void;
-    /** Move a field from one index to another */
-    moveField: (fromIndex: number, toIndex: number) => void;
-    /** Duplicate a field */
-    duplicateField: (fieldName: string) => void;
-    /** Select a field */
-    selectField: (fieldName: string | null) => void;
-    /** Set active tab */
-    setActiveTab: (tab: "builder" | "preview" | "settings" | "notifications") => void;
-    /** Update form metadata */
-    updateFormData: (updates: Partial<FormBuilderState["formData"]>) => void;
-    /** Update form settings */
-    updateSettings: (updates: Partial<FormSettings>) => void;
-    /** Add a notification */
-    addNotification: (notification: FormNotification) => void;
-    /** Duplicate a notification (the copy starts disabled) */
-    duplicateNotification: (id: string) => void;
-    /** Update a notification */
-    updateNotification: (id: string, updates: Partial<FormNotification>) => void;
-    /** Delete a notification */
-    deleteNotification: (id: string) => void;
-    /** Seed default notifications into an empty list without dirtying the form */
-    seedNotifications: (rules: FormNotification[]) => void;
-    /** Mark form as saved (clears dirty flag) */
-    markAsSaved: () => void;
-}
-interface FormBuilderContextValue extends FormBuilderState, FormBuilderActions {
+  /** Set all fields */
+  setFields: (fields: AnyFormField[]) => void;
+  /** Add a new field */
+  addField: (field: AnyFormField, index?: number) => void;
+  /** Update a field by name */
+  updateField: (fieldName: string, updates: Partial<AnyFormField>) => void;
+  /** Delete a field by name */
+  deleteField: (fieldName: string) => void;
+  /** Move a field from one index to another */
+  moveField: (fromIndex: number, toIndex: number) => void;
+  /** Duplicate a field */
+  duplicateField: (fieldName: string) => void;
+  /** Select a field */
+  selectField: (fieldName: string | null) => void;
+  /** Set active tab */
+  setActiveTab: (tab: "builder" | "preview" | "settings" | "notifications") => void;
+  /** Update form metadata */
+  updateFormData: (updates: Partial<FormBuilderState["formData"]>) => void;
+  /** Update form settings */
+  updateSettings: (updates: Partial<FormSettings>) => void;
+  /** Add a notification */
+  addNotification: (notification: FormNotification) => void;
+  /** Duplicate a notification (the copy starts disabled) */
+  duplicateNotification: (id: string) => void;
+  /** Update a notification */
+  updateNotification: (id: string, updates: Partial<FormNotification>) => void;
+  /** Delete a notification */
+  deleteNotification: (id: string) => void;
+  /** Seed default notifications into an empty list without dirtying the form */
+  seedNotifications: (rules: FormNotification[]) => void;
+  /** Mark form as saved (clears dirty flag) */
+  markAsSaved: () => void;
 }
+interface FormBuilderContextValue extends FormBuilderState, FormBuilderActions {}
 interface FormBuilderProviderProps {
-    /** Initial form data (for editing existing forms) */
-    initialData?: {
-        id?: string;
-        name?: string;
-        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;
+  /** Initial form data (for editing existing forms) */
+  initialData?: {
+    id?: string;
+    name?: string;
+    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;
+export declare const DEFAULT_SETTINGS: FormSettings;
 /** Create a new notification rule with default values */
-declare function createNotification(): FormNotification;
+export declare function createNotification(): FormNotification;
 /**
  * Generate a readable unique field name: the type itself for the first
  * field of that type, then a numeric suffix (`email`, `email_2`, ...).
  * Names key submission data, so they should read like keys a developer
  * would have chosen, not timestamps.
  */
-declare function generateFieldName(type: FormFieldTypeId, existingNames?: readonly string[]): string;
+export declare function generateFieldName(type: FormFieldTypeId, existingNames?: readonly string[]): string;
 /**
  * Generate a human-readable label from field type, using the shared catalog
  * so a new field's default label matches what the picker called the type. A
  * plugin type not in the built-in catalog falls back to a title-cased id.
  */
-declare function generateFieldLabel(type: FormFieldTypeId): string;
+export declare function generateFieldLabel(type: FormFieldTypeId): string;
 /**
  * Create a new field from a field type with default values.
  */
-declare function createFieldFromType(type: FormFieldTypeId, existingNames?: readonly string[]): AnyFormField;
+export declare function createFieldFromType(type: FormFieldTypeId, existingNames?: readonly string[]): AnyFormField;
 /**
  * FormBuilderProvider - Provides form builder state to child components
  *
@@ -272,7 +261,7 @@ declare function createFieldFromType(type: FormFieldTypeId, existingNames?: read
  * </FormBuilderProvider>
  * ```
  */
-declare function FormBuilderProvider({ initialData, children, readOnly, }: FormBuilderProviderProps): react_jsx_runtime.JSX.Element;
+export declare function FormBuilderProvider({ initialData, children, readOnly }: FormBuilderProviderProps): JSX.Element;
 /**
  * useFormBuilder - Access form builder context
  *
@@ -300,7 +289,7 @@ declare function FormBuilderProvider({ initialData, children, readOnly, }: FormB
  * }
  * ```
  */
-declare function useFormBuilder(): FormBuilderContextValue;
+export declare function useFormBuilder(): FormBuilderContextValue;
 /**
  * useOptionalFormBuilder - Access form builder context safely
  *
@@ -309,38 +298,36 @@ declare function useFormBuilder(): FormBuilderContextValue;
  *
  * @returns Form builder context value or null
  */
-declare function useOptionalFormBuilder(): FormBuilderContextValue | null;
-
+export declare function useOptionalFormBuilder(): FormBuilderContextValue | null;
 interface SpamDefaults {
-    honeypot?: boolean;
-    recaptchaEnabled?: boolean;
+  honeypot?: boolean;
+  recaptchaEnabled?: boolean;
 }
 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;
+  /** 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, redirectCollections, redirectConfigFailed, }: FormSettingsTabProps): react_jsx_runtime.JSX.Element;
-
+export declare function FormSettingsTab({ spamDefaults, redirectCollections, redirectConfigFailed }: FormSettingsTabProps): React.JSX.Element;
 /** Host-level notification defaults surfaced by the builder-config route. */
 interface NotificationDefaults {
-    defaultFrom?: string;
-    defaultToEmail?: string;
+  defaultFrom?: string;
+  defaultToEmail?: string;
 }
 interface FormNotificationsTabProps {
-    /** `null` while the builder-config request is still settling. */
-    defaults: NotificationDefaults | null;
+  /** `null` while the builder-config request is still settling. */
+  defaults: NotificationDefaults | null;
 }
 /**
  * FormNotificationsTab - the form's notification rules.
@@ -348,29 +335,10 @@ interface FormNotificationsTabProps {
  * Each rule references an existing email provider and template rather than
  * duplicating provider credentials or embedding a second template editor.
  */
-declare function FormNotificationsTab({ defaults }: FormNotificationsTabProps): react_jsx_runtime.JSX.Element;
-
-/**
- * Form Builder Admin Components
- *
- * Entry point for admin UI components used by the Nextly admin panel.
- * These components are referenced via component paths in collection configs.
- *
- * Component paths use the format: "@nextlyhq/plugin-form-builder/admin#ExportName"
- *
- * ## Auto-Registration
- *
- * This module automatically registers its components with the admin panel
- * when imported. No manual registration is required - just add the plugin
- * to your Nextly config and the admin will detect and load the components.
- *
- * @module admin
- * @since 0.1.0
- */
-
+export declare function FormNotificationsTab({ defaults }: FormNotificationsTabProps): JSX.Element;
 /** Component path for FormBuilderView */
-declare const FORM_BUILDER_VIEW_PATH: ComponentPath;
+export declare const FORM_BUILDER_VIEW_PATH: ComponentPath;
 /** Component path for SubmissionsView */
-declare const SUBMISSIONS_VIEW_PATH: ComponentPath;
-
-export { AddFieldDialog, type AddFieldDialogProps, DEFAULT_SETTINGS, FORM_BUILDER_VIEW_PATH, FieldCards, type FieldCardsProps, FieldEditor, type FieldEditorProps, type FormBuilderActions, type FormBuilderContextValue, FormBuilderProvider, type FormBuilderProviderProps, type FormBuilderState, FormBuilderView, type FormBuilderViewProps, FormNotification, FormNotificationsTab, FormPreview, type FormPreviewProps, FormSettings, FormSettingsTab, SUBMISSIONS_VIEW_PATH, SubmissionSheet, SubmissionsView, createFieldFromType, createNotification, generateFieldLabel, generateFieldName, useFormBuilder, useOptionalFormBuilder };
+export declare const SUBMISSIONS_VIEW_PATH: ComponentPath;
+export type { AddFieldDialogProps, FieldCardsProps, FieldEditorProps, FormBuilderActions, FormBuilderContextValue, FormBuilderProviderProps, FormBuilderState, FormBuilderViewProps, FormNotification, FormPreviewProps, FormSettings };
+//# sourceMappingURL=index.d.ts.map