📝 Add docstrings to main (#2)

* ci: add CI workflow with type check, build, verify and dry-run publish

Runs on every push and PR across all branches. Checks:
- TypeScript (server + admin)
- Build
- Strapi plugin verify
- Version not already published on npm
- Dry run publish

publish.yml now requires CI to pass before publishing to npm.

* fix: replace yarn run -T with npx tsc and fix implicit any type errors

- Fix test:ts:front and test:ts:back scripts to use npx tsc (was yarn-only syntax)
- Add explicit types for implicit any parameters caught by the type check:
  MouseEvent on DropZone drag handle click
  boolean on Modal.Root onOpenChange in EmbedModal and FormPreview
  string | number on SingleSelect onChange in FieldSettingsPanel and SubmissionsPage

* ci: add Dependabot for npm and GitHub Actions weekly updates

* fix: remove stale compiled JS files from src and ignore them in .gitignore

Rollup was resolving register.js (and other compiled .js files) instead
of the .ts sources, causing 'default is not exported' build failures in CI.
Deleted all .js artifacts from server/src and admin/src and added them
to .gitignore so they are never committed again.

* fix: add --noEmit to tsc type-check scripts to prevent JS file generation

Without --noEmit, tsc outputs .js files next to the .ts sources.
Rollup then resolves the CJS .js files instead of the .ts sources and
fails with 'default is not exported' on the CommonJS interop boundary.

* ci: prevent double CI run on PR branches

Push trigger now only fires on main, development and production.
Feature branches are covered by the pull_request trigger alone,
so CI no longer runs twice when pushing to an open PR.

* 📝 Add docstrings to `main`

Docstrings generation was requested by @devCluna.

* #1 (comment)

The following files were modified:

* `admin/src/components/DropZone.tsx`
* `admin/src/components/EmbedModal.tsx`
* `admin/src/components/FieldSettingsPanel.tsx`
* `admin/src/components/FormPreview.tsx`
* `admin/src/pages/SubmissionsPage.tsx`

---------

Co-authored-by: dev.cluna <dev.cluna@gmail.com>
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>

Author: coderabbitai[bot]

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();