Merge branch 'production' into main

Author: devCluna

.github/workflows/publish.yml

@@ -58,3 +58,6 @@ jobs:
           tag_name: v${{ steps.pkg.outputs.version }}
           name: v${{ steps.pkg.outputs.version }}
           generate_release_notes: true
+
+  ci:
+    uses: ./.github/workflows/ci.yml

admin/src/components/DropZone.tsx

@@ -20,6 +20,17 @@ import { CSS } from '@dnd-kit/utilities';
 import { Trash, Drag } from '@strapi/icons';
 import { FormField } from '../types';
 
+/**
+ * Renders a draggable, selectable row that represents a FormField with a delete action.
+ *
+ * The row highlights when `selected`. Clicking the row calls `onSelect`; interacting with the drag handle does not toggle selection; clicking the delete button calls `onDelete`.
+ *
+ * @param field - The form field to render (label and type are displayed).
+ * @param selected - Whether this row is currently selected; controls visual highlight.
+ * @param onSelect - Callback invoked when the row (outside the drag handle and delete button) is clicked.
+ * @param onDelete - Callback invoked when the delete button is clicked.
+ * @returns The rendered sortable field row element.
+ */
 function SortableFieldRow({
   field,
   selected,

admin/src/components/EmbedModal.tsx

@@ -8,6 +8,17 @@ interface Props {
   onClose: () => void;
 }
 
+/**
+ * Renders a modal that displays an embeddable HTML snippet for a given form and provides a one-click copy action.
+ *
+ * The component returns `null` when `open` is `false`. When visible, it shows a preformatted snippet containing a container div
+ * with `id="sfb-form-<formId>"` and a script tag that loads the embed script from the current origin with `data-form-id` set.
+ *
+ * @param formId - The form identifier inserted into the snippet's container id and `data-form-id` attribute
+ * @param open - Controls whether the modal is visible
+ * @param onClose - Callback invoked when the modal is closed
+ * @returns The modal element when `open` is `true`, otherwise `null`
+ */
 export function EmbedModal({ formId, open, onClose }: Props) {
   const [copied, setCopied] = useState(false);
 

admin/src/components/FieldSettingsPanel.tsx

@@ -45,6 +45,17 @@ function LabeledInput({
   );
 }
 
+/**
+ * Render the settings panel UI for editing a single form field.
+ *
+ * Displays controls for label, name, placeholder, help text, required/width toggles,
+ * type-specific inputs (heading, paragraph), option management (add/update/remove),
+ * validation rule management (add/update/remove) with value/message editing, and CSS class.
+ *
+ * @param field - The current FormField to edit.
+ * @param onChange - Callback invoked with the updated FormField whenever a change is made.
+ * @returns A React element containing the field settings panel UI.
+ */
 export function FieldSettingsPanel({ field, onChange }: Props) {
   const update = (patch: Partial<FormField>) => onChange({ ...field, ...patch });
 

admin/src/components/FormPreview.tsx

@@ -283,6 +283,16 @@ interface Props {
   onClose: () => void;
 }
 
+/**
+ * Render a modal preview of a form using the provided title, fields, and settings.
+ *
+ * @param title - The preview title displayed in the modal header
+ * @param fields - The array of form field definitions to render inside the preview
+ * @param settings - Form-level settings (used for things like the submit button text)
+ * @param open - Whether the preview modal is visible
+ * @param onClose - Callback invoked when the preview modal is closed
+ * @returns The modal element containing the form preview, or `null` when `open` is false
+ */
 export function FormPreview({ title, fields, settings, open, onClose }: Props) {
   if (!open) return null;
 

admin/src/pages/SubmissionsPage.tsx

@@ -22,6 +22,13 @@ import { useFormsApi } from '../api';
 import { Form, FormField, FormSubmission } from '../types';
 import { PLUGIN_ID } from '../pluginId';
 
+/**
+ * Render the submissions management page for a specific form.
+ *
+ * Loads and displays form metadata, submission list, and statistics; provides controls to filter by status, view submission details, mark submissions as read, and delete submissions.
+ *
+ * @returns The React element for the Submissions page (table, filters, detail modal, and delete confirmation modal).
+ */
 export function SubmissionsPage() {
   const { formId } = useParams<{ formId: string }>();
   const navigate = useNavigate();