@digigov/form 2.0.0-rc.8 → 2.0.2

package/{Questions/index.mdx → src/Questions/doc.mdx}

@@ -14,14 +14,12 @@ import {
   TableDataCell,
 } from '@digigov/react-core';
 
-import LeadText from '@site/src/components/LeadText';
+# Questions
 
-<LeadText>
-  Question pages are used to ask users meaningful questions needed by your
-  GOV.GR service, or even gather data about their persona or their application
-  status. Use step questions to make bigger forms less scary and easier to fill
-  out.
-</LeadText>
+Question pages are used to ask users meaningful questions needed by your
+GOV.GR service, or even gather data about their persona or their application
+status. Use step questions to make bigger forms less scary and easier to fill
+out.
 
 ## Introduction to Question pages
 
@@ -41,7 +39,7 @@ Even if users struggle through to the end of a form and answer honestly, if it
 more work than they expected, they’ll be annoyed about it. That's the exact
 opposite of our goals of making concise, easy-to-use services.
 
-```jsx live
+```jsx
 import React from 'react';
 import Questions, { Step, StepForm, StepTitle } from '@digigov/form/Questions';
 import { Field } from '@digigov/form';
@@ -49,7 +47,7 @@ import { Field } from '@digigov/form';
 const steps = [
   {
     name: 'residency',
-    title: 'Where do you live?',
+    title: 'Που μένετε;',
     fields: [
       {
         key: 'countries',
@@ -59,25 +57,25 @@ const steps = [
           options: [
             {
               label: {
-                primary: 'Greece',
+                primary: 'Ελλάδα',
               },
               value: 'greece',
             },
             {
               label: {
-                primary: 'Cyprus',
+                primary: 'Κύπρος',
               },
               value: 'cyprus',
             },
             {
               label: {
-                primary: 'European Union',
+                primary: 'Ευρωπαϊκή Ένωση',
               },
               value: 'eu',
             },
             {
               label: {
-                primary: 'United States of America',
+                primary: 'Ηνωμένες Πολιτείες της Αμερικής',
               },
               value: 'usa',
             },
@@ -87,13 +85,13 @@ const steps = [
     ],
   },
   {
-    name: 'bod',
-    title: 'When is your birthday?',
+    name: 'dob',
+    title: 'Ποια είναι ημερομηνία γέννησής σας;',
     fields: [
       {
-        key: 'bod',
+        key: 'dob',
         label: {
-          primary: 'Birthday',
+          primary: 'Ημερομηνία γέννησης',
         },
         type: 'date',
         required: true,
@@ -117,10 +115,10 @@ export default function Index() {
           <Field name="countries" />
         </StepForm>
       </Step>
-      <Step name="bod">
+      <Step name="dob">
         <StepTitle />
         <StepForm submitButton={true}>
-          <Field name="bod" />
+          <Field name="dob" />
         </StepForm>
       </Step>
     </Questions>
@@ -159,7 +157,7 @@ its subsequent subcomponents that you customise as needed, like the step title,
 description or form. You can also add components that are not form-specific,
 adding paragraphs or other custom components.
 
-```jsx
+```jsx pure
 <Questions name="example" steps={steps} onSubmit={(data) => doSomething(data)}>
   {/* more steps could be rendered here ... */}
   <Step name="age">
@@ -184,10 +182,10 @@ object. The most basic properties are the following:
 - `fields` - an array that describes each input field that will be rendered in
   the `StepForm`. Each fields implements the `FieldSpec` interface as a JSON object.
 
-```json title="step-name.json"
+```json pure title="step-name.json"
 {
   "name": "name",
-  "title": "What is your name?",
+  "title": "Ποιο είναι το όνομά σας;",
   "fields": [
     {
       "key": "name",
@@ -209,11 +207,11 @@ basic branching between each step. The `nextStep` property will need to be a
 function that will take the form state as an argument and will return the key of
 the next `step`.
 
-```json title="next-step.json"
+```json pure title="next-step.json"
 const steps = [
   {
     name: 'age',
-    title: 'What is your age?',
+    title: 'Ποια είναι η ηλικία σας?',
     fields: [
       {
         key: 'age',
@@ -229,13 +227,13 @@ const steps = [
   },
   {
     name: 'citizen-underage',
-    title: 'Are you a student?',
+    title: 'Είστε μαθητής;',
     fields: [ ... ]
   },
   {
     // highlight-next-line
     name: 'citizen-adult',
-    title: 'Are you currently employed?',
+    title: 'Εργάζεστε;',
     fields: [
       {
         key: 'citizen-underage-employed',
@@ -245,11 +243,11 @@ const steps = [
           options: [
             {
               label: {primary: "Yes"},
-              value: 'yes',
+              value: 'Ναι',
             },
             {
               label: {primary: "No"},
-              value: 'no',
+              value: 'ΌΧι',
             }
           ]
         }
@@ -263,7 +261,7 @@ For example, you may use a form to determine if citizens are adults or not, and
 we want to ask users different questions according to their persona. We can use
 a branch between the `age` step and the other two steps.
 
-```jsx live
+```jsx
 import React from 'react';
 import GovGRFooter from '@digigov/ui/govgr/Footer';
 import Header from '@digigov/ui/app/Header';
@@ -283,7 +281,7 @@ import TranslatorsHeader from 'translators-landing/components/TranslatorsHeader'
 const steps = [
   {
     name: 'age',
-    title: 'What is your age?',
+    title: 'Ποια είναι η ηλικία σας;',
     fields: [
       {
         key: 'age',
@@ -297,7 +295,7 @@ const steps = [
   },
   {
     name: 'citizen-underage',
-    title: 'Are you a student?',
+    title: 'Είστε μαθητής;',
     fields: [
       {
         key: 'citizen-underage-student',
@@ -306,11 +304,11 @@ const steps = [
         extra: {
           options: [
             {
-              label: { primary: 'Yes' },
+              label: { primary: 'Ναι' },
               value: 'yes',
             },
             {
-              label: { primary: 'No' },
+              label: { primary: 'Όχι' },
               value: 'no',
             },
           ],
@@ -320,7 +318,7 @@ const steps = [
   },
   {
     name: 'citizen-adult',
-    title: 'Are you currently employed?',
+    title: 'Εργάζεστε;',
     fields: [
       {
         key: 'citizen-adult-employed',
@@ -329,11 +327,11 @@ const steps = [
         extra: {
           options: [
             {
-              label: { primary: 'Yes' },
+              label: { primary: 'Ναι' },
               value: 'yes',
             },
             {
-              label: { primary: 'No' },
+              label: { primary: 'Όχι' },
               value: 'no',
             },
           ],
@@ -392,24 +390,3 @@ export default function Index() {
   );
 }
 ```
-
-## Prop types
-
-<TableContainer>
-  <Table>
-    <TableHead>
-      <TableRow>
-        <TableHeadCell>Περίοδος</TableHeadCell>
-        <TableHeadCell>Κανονικό ποσό</TableHeadCell>
-        <TableHeadCell>Μειωμένο ποσό</TableHeadCell>
-      </TableRow>
-    </TableHead>
-    <TableBody>
-      <TableRow>
-        <TableDataCell>Πρώτες 6 εβδομάδες </TableDataCell>
-        <TableDataCell> €109.80 / εβδομάδα</TableDataCell>
-        <TableDataCell> €69.80 / εβδομάδα</TableDataCell>
-      </TableRow>
-    </TableBody>
-  </Table>
-</TableContainer>

package/src/Questions/getNextStep.tsx

@@ -1,4 +1,4 @@
-import { StepInterface } from '@digigov/form/Questions/Step/types';
+import type { StepInterface } from '@digigov/form/Questions/Step/types';
 
 export function getNextStep(
   currentStep: any,

package/src/Questions/index.spec.tsx

@@ -1,9 +1,13 @@
 import * as React from 'react';
-import { mount } from 'enzyme';
+import { render } from '@testing-library/react';
 
 import { Field } from '@digigov/form';
-import { Step, StepForm, StepQuote, StepTitle } from '@digigov/form/Questions';
-import Questions from '@digigov/form/Questions';
+import Questions, {
+  Step,
+  StepForm,
+  StepQuote,
+  StepTitle,
+} from '@digigov/form/Questions';
 
 const steps = [
   {
@@ -42,9 +46,17 @@ const steps = [
   },
 ];
 
+beforeAll(() => {
+  global.ResizeObserver = class ResizeObserver {
+    observe() {}
+    unobserve() {}
+    disconnect() {}
+  };
+});
+
 it('renders the Questions', () => {
   expect(
-    mount(
+    render(
       <Questions
         name={'example'}
         onSubmit={(data): void => {
@@ -67,6 +79,6 @@ it('renders the Questions', () => {
           </StepForm>
         </Step>
       </Questions>
-    )
+    ).baseElement
   ).toMatchSnapshot();
 });

package/src/Questions/index.test.tsx

@@ -0,0 +1,24 @@
+import React from 'react';
+import { test, expect } from '@playwright/experimental-ct-react';
+import TestVariant from '@digigov/ui/utils/TestVariant'
+import { Default } from '@digigov/form/Questions/__stories__/Default';
+
+test('renders the All Questions variants', async ({ mount, page }) => {
+  await mount(
+    
+  <div>
+    <TestVariant title="Default">
+      <Default />
+    </TestVariant>
+  </div>
+  )
+  await page.evaluate(() => document.fonts.ready);
+
+  // Move the mouse to the top-left corner to avoid random hover issues
+  await page.mouse.move(0, 0);
+
+
+  const screenshot = await page.screenshot({ fullPage: true, animations: 'disabled' });
+  expect(screenshot).toMatchSnapshot();
+});
+  

package/src/Questions/types.tsx

@@ -1,4 +1,4 @@
-import { StepInterface } from '@digigov/form/Questions/Step/types';
+import type { StepInterface } from '@digigov/form/Questions/Step/types';
 
 export interface QuestionsInterface {
   name: string;
@@ -13,6 +13,7 @@ export interface QuestionsInterface {
   initialData?: any;
   localDraft?: boolean;
   errorLabels?: Record<string, string>;
+  children?: React.ReactNode;
 }
 
 export interface QuestionsContextInterface {

package/src/create-simple-form.mdx

@@ -4,12 +4,8 @@ title: Create a simple Digigov Form
 sidebar_label: Creating simple forms
 ---
 
-import LeadText from '@site/src/components/LeadText';
-
-<LeadText>
-  This guide walks through building a simple form page, complete with validation
-  and data serialisation.
-</LeadText>
+This guide walks through building a simple form page, complete with validation
+and data serialisation.
 
 ## What we are building
 

package/src/{index.mdx → doc.mdx}

@@ -1,20 +1,16 @@
 ---
 id: Introduction
-title: Digigov Form
-sidebar_label: Introduction to Digigov Form
 ---
 
-import LeadText from '@site/src/components/LeadText';
+# Digigov form
 
-<LeadText>
-  Digigov Form is an off-the-shelf solution for managing web forms using
-  Reactjs. It supports flexible and multi-step forms and easy-to-use validation.
-  This page will guide you through everything you need to create accessible and
-  dynamic forms that can handle all sorts of user inputs.
-</LeadText>
+Digigov Form is an off-the-shelf solution for managing web forms using
+Reactjs. It supports flexible and multi-step forms and easy-to-use validation.
+This page will guide you through everything you need to create accessible and
+dynamic forms that can handle all sorts of user inputs.
 
 <img
-  src="/img/form.svg"
+  src="/tmp/form.svg"
   style={{ margin: '3rem 0', maxWidth: '450px', width: '60%' }}
 />
 
@@ -34,18 +30,33 @@ will be able to save via an JSON API.
 The `@digigov/form` NPM package contains React components and validators. The
 library uses basic, semantically correct HTML5 input fields.
 
-It adds dynamic control, interactivity and validations to the core input
-components implemented in `@digigov/react-core`. Styling is provided by
-`@digigov/css` library following the [GOV.GR design
-system](https://guide.services.gov.gr).
+### 📦 Installation
 
-Digigov Form uses two main libraries internally. The first is [React Hook
-Form](https://www.react-hook-form.com/) which helps us manage the form state and
-perform actions and mutations on it. The second is
-[Yup](https://github.com/jquense/yup) and it is used to validate form data. It
+```sh
+yarn add @digigov/form
+
+```
+
+Or using npm:
+
+```sh
+npm install i @digigov/form
+
+```
+
+`digigov/form` is a **form management solution** which adds dynamic control while simplifies handling user input, based on:
+
+✅ [React Hook Form](https://www.react-hook-form.com/) which helps us manage the form state and
+perform actions and mutations on it.
+
+🛠️ [Yup](https://github.com/jquense/yup) and it is used to validate form data. It
 interfaces with React Hook Form right out of the box, but also enables us to
 define custom validation types such as AMKA, AFM etc.
 
+🔄 [Multi-step](/components/@digigov/form/Questions) forms for complex workflows.
+
+🔗 [digigov/form](/components/@digigov/form/FormBuilder) components for a consistent UI.
+
 Some basic functionalites of `@digigov/form` will be presented in the following
 sections and also we are going to guide you through some more advanced topics
 such as internationalisation, custom data validation etc.