Feature/231 create dataset boilerplate

packages/design-system/src/lib/components/form/form-group/form-element/FormInput.tsx

@@ -8,17 +8,19 @@ interface FormInputProps extends React.HTMLAttributes<FormInputElement> {
   type?: 'text' | 'email' | 'password'
   readOnly?: boolean
   withinMultipleFieldsGroup?: boolean
+  name?: string
 }
 
 export function FormInput({
   type = 'text',
+  name,
   readOnly,
   withinMultipleFieldsGroup,
   ...props
 }: FormInputProps) {
   return (
     <FormElementLayout withinMultipleFieldsGroup={withinMultipleFieldsGroup}>
-      <FormBS.Control type={type} readOnly={readOnly} plaintext={readOnly} {...props} />
+      <FormBS.Control name={name} type={type} readOnly={readOnly} plaintext={readOnly} {...props} />
     </FormElementLayout>
   )
 }

public/locales/en/createDataset.json

@@ -0,0 +1,16 @@
+{
+  "pageTitle": "Create Dataset",
+  "metadataTip": {
+    "title": "Metadata Tip",
+    "content": "After adding the dataset, click the Edit Dataset button to add more metadata."
+  },
+  "datasetForm": {
+    "title": "Title"
+  },
+  "datasetFormStates": {
+    "submitting": "Form Submitting",
+    "submissionSuccess": "Form submission successful"
+  },
+  "saveButton": "Save Dataset",
+  "cancelButton": "Cancel"
+}

src/Router.tsx

@@ -3,12 +3,15 @@ import { HelloDataverse } from './sections/hello-dataverse/HelloDataverse'
 import { Layout } from './sections/layout/Layout'
 import { Route } from './sections/Route.enum'
 import { DatasetFactory } from './sections/dataset/DatasetFactory'
+import { PageNotFound } from './sections/page-not-found/PageNotFound'
+import CreateDatasetContainer from './views/create-dataset/CreateDatasetContainer'
 
 const router = createBrowserRouter(
   [
     {
       path: '/',
       element: <Layout />,
+      errorElement: <PageNotFound />,
       children: [
         {
           path: Route.HOME,
@@ -17,6 +20,10 @@ const router = createBrowserRouter(
         {
           path: `${Route.DATASETS}`,
           element: DatasetFactory.create()
+        },
+        {
+          path: `${Route.DATASETS}/${Route.CREATE}`,
+          element: <CreateDatasetContainer />
         }
       ]
     }

src/components/Forms/RequiredFieldText/RequiredFieldText.tsx

@@ -0,0 +1,20 @@
+export function RequiredFieldText() {
+  return (
+    <p>
+      <RequiredInputSymbol />
+      Asterisks indicate required fields
+    </p>
+  )
+}
+
+// TODO: Why can't I export this object from Storybook?
+// Needed to duplicate it on the frontend to be able to use.
+
+const RequiredInputSymbol = () => {
+  return (
+    <span role="img" aria-label="Required input symbol" style={{ color: '#a94442' }}>
+      {' '}
+      *
+    </span>
+  )
+}

src/components/ui/SeparationLine/SeparationLine.tsx

@@ -0,0 +1,4 @@
+import styles from '/src/sections/dataset/Dataset.module.scss'
+export function SeparationLine() {
+  return <div className={styles['separation-line']}></div>
+}

src/sections/Route.enum.ts

@@ -3,5 +3,6 @@ export enum Route {
   SIGN_UP = '/dataverseuser.xhtml?editMode=CREATE&redirectPage=%2Fdataverse.xhtml',
   LOG_IN = '/loginpage.xhtml?redirectPage=%2Fdataverse.xhtml',
   LOG_OUT = '/',
-  DATASETS = 'datasets'
+  DATASETS = 'datasets',
+  CREATE = 'create'
 }

src/sections/hello-dataverse/HelloDataverse.module.scss

@@ -1,5 +1,5 @@
 @import "node_modules/@iqss/dataverse-design-system/src/lib/assets/styles/design-tokens/colors.module";
-@import "src/sections/assets/variables";
+@import "src/assets/variables";
 
 .container {
   display: flex;

src/sections/hello-dataverse/HelloDataverse.tsx

@@ -1,4 +1,4 @@
-import logo from '../assets/logo.svg'
+import logo from '../../assets/logo.svg'
 import styles from './HelloDataverse.module.scss'
 import { Trans, useTranslation } from 'react-i18next'
 

src/sections/layout/Layout.module.scss

@@ -1,4 +1,4 @@
-@import "src/sections/assets/variables";
+@import "src/assets/variables";
 
 .body-container {
     min-height: $body-available-height;

src/sections/layout/header/Header.tsx

@@ -1,4 +1,4 @@
-import logo from '../../assets/logo.svg'
+import logo from '../../../assets/logo.svg'
 import { useTranslation } from 'react-i18next'
 import { Navbar } from '@iqss/dataverse-design-system'
 import { Route } from '../../Route.enum'

src/views/create-dataset/CreateDataset.tsx

@@ -0,0 +1,107 @@
+// components/FormPresenter.tsx
+
+import { ChangeEvent, FormEvent } from 'react'
+import { Alert, Button, Col, Form, Row } from '@iqss/dataverse-design-system'
+import { useTranslation } from 'react-i18next'
+// import { DatasetSkeleton } from '../../sections/dataset/DatasetSkeleton'
+// import { useLoading } from '../../sections/loading/LoadingContext'
+import styles from '/src/sections/dataset/Dataset.module.scss'
+// import { FormInputElement } from '@iqss/dataverse-design-system/src/lib/components/form/form-group/form-element/FormInput'
+import { SeparationLine } from '../../components/ui/SeparationLine/SeparationLine'
+import { RequiredFieldText } from '../../components/Forms/RequiredFieldText/RequiredFieldText'
+
+/*
+ * TODO:
+ * Break out different components
+ * Find submit action source
+ * cleanup state objects and submit process
+ * show submitted info in console
+ * Loading state management
+ */
+
+// See comments about https://rjsf-team.github.io/react-jsonschema-form/
+// https://github.com/IQSS/dataverse-frontend/issues/231
+
+// const [submitting, setSubmitting] = useState(false)
+// const [submitStatus, setSubmitStatus] = useState(false)
+
+interface CreateDatasetFormPresenterProps {
+  formData: { createDatasetTitle: string }
+  handleCreateDatasetFieldChange: (event: ChangeEvent<HTMLInputElement>) => void
+  handleCreateDatasetSubmit: (event: FormEvent<HTMLFormElement>) => void
+  submitting: boolean
+  submitComplete: boolean
+}
+export default function CreateDatasetFormPresenter({
+  // formData,
+  handleCreateDatasetFieldChange,
+  handleCreateDatasetSubmit,
+  submitting,
+  submitComplete
+}: CreateDatasetFormPresenterProps) {
+  const { t } = useTranslation('createDataset')
+  // TODO: Probably replace this with a FormSkeleton or remove entirely
+  // if (loading) {
+  //   return <DatasetSkeleton />
+  // }
+  return (
+    <article>
+      <header className={styles.header}>
+        <h1>{t('pageTitle')}</h1>
+      </header>
+      <SeparationLine />
+      <div className={styles.container}>
+        <RequiredFieldText />
+        <Form onSubmit={handleCreateDatasetSubmit}>
+          {submitComplete && <div>Form Submitted!</div>}
+          <Row>
+            <Col md={9}>
+              <Form.Group controlId="createDatasetTitle" required>
+                <Form.Group.Label>{t('datasetForm.title')}</Form.Group.Label>
+                <Form.Group.Input
+                  readOnly={submitting && true}
+                  data-cy="datasetFormInputTitle"
+                  type="text"
+                  // FIX: Err - Property 'name' does not exist on type 'IntrinsicAttributes & FormInputProps'.
+                  name="createDatasetTitle"
+                  placeholder="Dataset Title"
+                  onChange={handleCreateDatasetFieldChange}
+                  withinMultipleFieldsGroup={false}
+                />
+              </Form.Group>
+            </Col>
+          </Row>
+          <SeparationLine />
+          <Alert
+            key={1}
+            variant={'info'}
+            customHeading={t('metadataTip.title')}
+            dismissible={false}>
+            {t('metadataTip.content')}
+          </Alert>
+          {/* SRC: https://github.com/IQSS/dataverse/blob/develop/src/main/webapp/dataset.xhtml */}
+          {/* <p:commandButton id="saveBottom" styleClass="btn btn-default" value="#{DatasetPage.editMode == 'CREATE' ? bundle['file.addBtn'] : bundle.saveChanges}" rendered="#{DatasetPage.editMode == 'CREATE' or DatasetPage.editMode == 'METADATA'}"
+              onclick="PF('blockDatasetForm').show();"
+              update=":datasetForm,:messagePanel"
+              oncomplete="$(document).scrollTop(0);"
+              action="#{DatasetPage.save}"
+              /> */}
+          {/* Where is datasetSaveCommand()  */}
+          {/* <p:remoteCommand
+            name="datasetSaveCommand"
+            action="#{DatasetPage.save()}"
+            update=":datasetForm,:messagePanel"
+          /> */}
+          <Button type="submit" data-cy="datasetFormSubmit">
+            {t('saveButton')}
+          </Button>
+          <Button withSpacing variant="secondary" data-cy="datasetFormCancel">
+            {t('cancelButton')}
+          </Button>
+        </Form>
+      </div>
+    </article>
+  )
+}
+
+// export default CreateDatasetFormPresenter

src/views/create-dataset/CreateDatasetContainer.tsx

@@ -0,0 +1,77 @@
+// containers/FormContainer.tsx
+
+import React, { useState, ChangeEvent, FormEvent } from 'react'
+import { FormInputElement } from '@iqss/dataverse-design-system/src/lib/components/form/form-group/form-element/FormInput'
+import CreateDatasetUseCase from './CreateDatasetUseCase'
+import CreateDatasetFormPresenter from './CreateDataset'
+
+const CreateDatasetContainer: React.FC = () => {
+  const [formData, setFormData] = useState({
+    createDatasetTitle: ''
+  })
+
+  const [submitComplete, setSubmitComplete] = useState(false)
+
+  const [submitting, setSubmitting] = useState(false)
+
+  const handleCreateDatasetFieldChange = (event: ChangeEvent<FormInputElement>): void => {
+    const { name, value } = event.target
+    setFormData((prevData) => ({
+      ...prevData,
+      [name]: value
+    }))
+  }
+
+  const handleCreateDatasetSubmit = async (event: FormEvent<HTMLFormElement>): Promise<void> => {
+    event.preventDefault()
+
+    const formUseCase = new CreateDatasetUseCase()
+
+    console.log('handleCreateDatasetSubmit() formData | ', formData)
+
+    if (formUseCase.validateCreateDatasetFormData(formData)) {
+      try {
+        setSubmitting(true)
+        console.log('Status: Submitting | ', submitting)
+
+        // Simulate an asynchronous operation, e.g., API call
+        await new Promise((resolve) => setTimeout(resolve, 3000))
+        const result = await formUseCase.submitCreateDatasetFormData(formData)
+        console.log(result)
+        setSubmitComplete(true)
+        // Handle success, e.g., show a success message
+      } catch (error) {
+        console.error('Error submitting form:', error)
+        // Handle error, e.g., show an error message
+      } finally {
+        setSubmitting(false)
+      }
+    } else {
+      // Handle validation error, e.g., show validation messages
+      console.error('Form validation failed')
+    }
+    // Explicitly return a Promise<void>
+    return Promise.resolve()
+  }
+
+  return (
+    // TODO: conditional view, needs to be lower in the component heirarchy
+    // {submitting && <div>Submtting Form...</div>}
+    <>
+      {submitting && <p>Submitting...</p>}
+      {!submitting && (
+        <CreateDatasetFormPresenter
+          submitComplete={submitComplete}
+          formData={formData}
+          handleCreateDatasetFieldChange={handleCreateDatasetFieldChange}
+          // TODO: Fix using IIFE (Immediately-invoked Function Expression)
+          // eslint-disable-next-line @typescript-eslint/no-misused-promises
+          handleCreateDatasetSubmit={handleCreateDatasetSubmit}
+          submitting={submitting}
+        />
+      )}
+    </>
+  )
+}
+
+export default CreateDatasetContainer

src/views/create-dataset/CreateDatasetUseCase.tsx

@@ -0,0 +1,23 @@
+// usecases/FormUseCase.js
+
+'use strict'
+
+interface CreateDatasetFormData {
+  createDatasetTitle: string
+}
+
+class CreateDatasetUseCase {
+  validateCreateDatasetFormData(formData: CreateDatasetFormData): boolean {
+    // Add your validation logic here
+    // For simplicity, assuming all fields are required
+    return formData.createDatasetTitle !== undefined && formData.createDatasetTitle.trim() !== ''
+  }
+
+  async submitCreateDatasetFormData(_formData: CreateDatasetFormData): Promise<string> {
+    // Add your business logic for form submission here
+    // For simplicity, returning a success message
+    return Promise.resolve('Form submitted successfully!')
+  }
+}
+
+export default CreateDatasetUseCase

tests/component/views/create-dataset/CreateDataset.spec.tsx

@@ -0,0 +1,24 @@
+import CreateDatasetContainer from '../../../../src/views/create-dataset/CreateDatasetContainer'
+
+describe('Form component', () => {
+  it('should render all form fields', () => {
+    cy.customMount(<CreateDatasetContainer />)
+    cy.get('[data-cy=datasetFormInputTitle]').should('be.visible')
+    cy.get('[data-cy=datasetFormSubmit]').should('be.visible')
+    cy.get('[data-cy=datasetFormCancel]').should('be.visible')
+  })
+
+  it('should submit the form with correct values', () => {
+    cy.customMount(<CreateDatasetContainer />)
+
+    cy.get('[data-cy=datasetFormInputTitle]').type('Test Dataset Title')
+
+    cy.get('[data-cy=datasetFormSubmit]').click()
+
+    // Wait for the form submission to complete (adjust the timeout as needed)
+    cy.wait(4000)
+
+    // Assert that the form was successfully submitted
+    cy.contains('Form Submitted!')
+  })
+})