@nextlyhq/plugin-form-builder 0.0.2-alpha.35 → 0.0.2-alpha.37

package/dist/admin/index.d.ts

@@ -1,6 +1,6 @@
 import { ComponentPath } from '@nextlyhq/plugin-sdk/admin';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { i as FormField, b as FormSettings, s as FormNotification, p as FormFieldType } from '../types-C-DcuYGF.js';
+import { q as FormField, s as FormFieldTypeId, A as AnyFormField, b as FormSettings, v as FormNotification } from '../types-r8uBeB0u.js';
 import { FormFieldCatalogType, FieldTypeCatalogEntry } from 'nextly/field-catalog';
 import { ReactNode } from 'react';
 import 'nextly';
@@ -73,31 +73,39 @@ interface FieldCardsProps {
      * 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: FormFieldCatalogType) => void;
+    onAddField: (type: FormFieldTypeId) => void;
 }
-declare function FieldCards({ enabledTypes, onAddField }: FieldCardsProps): react_jsx_runtime.JSX.Element;
+declare function FieldCards({ enabledTypes, disabledFieldTypes, onAddField, }: FieldCardsProps): react_jsx_runtime.JSX.Element;
 
 interface AddFieldDialogProps {
     open: boolean;
     onOpenChange: (open: boolean) => void;
     /**
-     * The form surface's catalog, already filtered by the host's excludes;
-     * `null` while the host configuration is still loading.
+     * 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<FormFieldCatalogType>[] | null;
+    entries: readonly FieldTypeCatalogEntry<FormFieldTypeId>[] | null;
     /** Called with the chosen type; the parent creates and selects the field. */
-    onAdd: (type: FormFieldCatalogType) => void;
+    onAdd: (type: FormFieldTypeId) => void;
 }
 declare function AddFieldDialog({ open, onOpenChange, entries, onAdd, }: AddFieldDialogProps): react_jsx_runtime.JSX.Element;
 
 interface FieldEditorProps {
-    /** The field being edited */
-    field: FormField;
+    /** The field being edited (built-in or plugin-contributed). */
+    field: AnyFormField;
     /** All fields in the form (for conditional logic references) */
-    allFields: FormField[];
+    allFields: AnyFormField[];
     /** Callback when field is updated */
-    onUpdate: (updates: Partial<FormField>) => void;
+    onUpdate: (updates: Partial<AnyFormField>) => void;
 }
 /**
  * FieldEditor - Field properties configuration panel
@@ -121,8 +129,8 @@ interface FieldEditorProps {
 declare function FieldEditor({ field, allFields, onUpdate }: FieldEditorProps): react_jsx_runtime.JSX.Element;
 
 interface FormPreviewProps {
-    /** Array of form fields to preview */
-    fields: FormField[];
+    /** Array of form fields to preview (built-in or plugin-contributed). */
+    fields: AnyFormField[];
     /** Form metadata */
     formData?: {
         name?: string;
@@ -134,7 +142,7 @@ declare function FormPreview({ fields, formData }: FormPreviewProps): react_jsx_
 
 interface FormBuilderState {
     /** Form fields array */
-    fields: FormField[];
+    fields: AnyFormField[];
     /** Currently selected field ID (name) */
     selectedFieldId: string | null;
     /** Active tab: builder, preview, settings, or notifications */
@@ -156,11 +164,11 @@ interface FormBuilderState {
 }
 interface FormBuilderActions {
     /** Set all fields */
-    setFields: (fields: FormField[]) => void;
+    setFields: (fields: AnyFormField[]) => void;
     /** Add a new field */
-    addField: (field: FormField, index?: number) => void;
+    addField: (field: AnyFormField, index?: number) => void;
     /** Update a field by name */
-    updateField: (fieldName: string, updates: Partial<FormField>) => void;
+    updateField: (fieldName: string, updates: Partial<AnyFormField>) => void;
     /** Delete a field by name */
     deleteField: (fieldName: string) => void;
     /** Move a field from one index to another */
@@ -198,7 +206,7 @@ interface FormBuilderProviderProps {
         slug?: string;
         description?: string;
         status?: "draft" | "published" | "closed";
-        fields?: FormField[];
+        fields?: AnyFormField[];
         settings?: Partial<FormSettings>;
         notifications?: FormNotification[];
     };
@@ -215,16 +223,17 @@ declare function createNotification(): FormNotification;
  * Names key submission data, so they should read like keys a developer
  * would have chosen, not timestamps.
  */
-declare function generateFieldName(type: FormFieldType, existingNames?: readonly string[]): string;
+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.
+ * 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: FormFieldType): string;
+declare function generateFieldLabel(type: FormFieldTypeId): string;
 /**
  * Create a new field from a field type with default values.
  */
-declare function createFieldFromType(type: FormFieldType, existingNames?: readonly string[]): FormField;
+declare function createFieldFromType(type: FormFieldTypeId, existingNames?: readonly string[]): AnyFormField;
 /**
  * FormBuilderProvider - Provides form builder state to child components
  *