Feature: Preview API

src/DonationForms/Controllers/DonationFormViewController.php

@@ -42,10 +42,11 @@ public function preview(DonationFormPreviewRouteData $data): string
         $viewModel = new DonationFormViewModel(
             $donationForm->id,
             $data->formBlocks ?: $donationForm->blocks,
-            $data->formSettings ?: $donationForm->settings
+            $data->formSettings ?: $donationForm->settings,
+            true
         );
 
         ob_clean();
-        return $viewModel->render(true);
+        return $viewModel->render();
     }
 }

src/DonationForms/ViewModels/DonationFormViewModel.php

@@ -41,19 +41,25 @@ class DonationFormViewModel
      * @var DonationFormRepository
      */
     private $donationFormRepository;
+    /**
+     * @var bool
+     */
+    private $previewMode;
 
     /**
      * @since 3.0.0
      */
     public function __construct(
         int $donationFormId,
         BlockCollection $formBlocks,
-        FormSettings $formSettings
+        FormSettings $formSettings,
+        bool $previewMode = false
     ) {
         $this->donationFormId = $donationFormId;
         $this->formBlocks = $formBlocks;
         $this->formSettings = $formSettings;
         $this->donationFormRepository = give(DonationFormRepository::class);
+        $this->previewMode = $previewMode;
     }
 
     /**
@@ -223,6 +229,7 @@ public function exports(): array
                     'isMultiStep' => $formDesign->isMultiStep(),
                 ] : null,
             ]),
+            'previewMode' => $this->previewMode,
         ];
     }
 
@@ -240,7 +247,7 @@ public function exports(): array
      *
      * @since 3.0.0
      */
-    public function render(bool $preview = false): string
+    public function render(): string
     {
         $this->enqueueGlobalStyles();
 
@@ -255,16 +262,16 @@ public function render(bool $preview = false): string
         ?>
 
         <?php
-        if ($this->formSettings->customCss): ?>
-            <style><?php
+        if ($this->previewMode || $this->formSettings->customCss): ?>
+            <style id="root-givewp-donation-form-style"><?php
                 echo $this->formSettings->customCss; ?></style>
         <?php
         endif; ?>
 
         <?php
         $classNames = ['givewp-donation-form'];
 
-        if ($preview) {
+        if ($this->previewMode) {
             $classNames[] = 'givewp-donation-form--preview';
         }
         ?>

src/DonationForms/resources/app/DonationFormApp.tsx

@@ -12,14 +12,18 @@ import DonationFormErrorBoundary from '@givewp/forms/app/errors/boundaries/Donat
 import MultiStepForm from '@givewp/forms/app/form/MultiStepForm';
 import getDonationFormNodeSettings from '@givewp/forms/app/utilities/getDonationFormNodeSettings';
 import {DonationFormSettingsProvider} from '@givewp/forms/app/store/form-settings';
+import useDonationFormPubSub from '@givewp/forms/app/utilities/useDonationFormPubSub';
+import {useEffect, useState} from 'react';
+import type {Form as DonationForm} from '@givewp/forms/types';
 
 const formTemplates = window.givewp.form.templates;
 const GoalAchievedTemplate = withTemplateWrapper(formTemplates.layouts.goalAchieved);
 
 /**
  * Get data from the server
  */
-const {form} = getWindowData();
+const {form, previewMode} = getWindowData();
+const donationFormNodeSettings = getDonationFormNodeSettings(form);
 
 prepareFormData(form);
 
@@ -38,44 +42,106 @@ const initialState = {
     validationSchema: schema,
 };
 
-const formSettings = {...form.settings, ...getDonationFormNodeSettings(form)};
-
 /**
  * @since 3.0.0
  */
-function App() {
+function App({form}: { form: DonationForm }) {
+
     if (form.goal.isAchieved) {
         return (
             <DonationFormErrorBoundary>
-                <GoalAchievedTemplate goalAchievedMessage={form.settings.goalAchievedMessage}/>
+                <GoalAchievedTemplate goalAchievedMessage={form.settings.goalAchievedMessage} />
             </DonationFormErrorBoundary>
         );
     }
 
     if (form.design?.isMultiStep) {
         return (
-            <DonationFormSettingsProvider value={formSettings}>
+            <DonationFormSettingsProvider value={{...form.settings, ...donationFormNodeSettings}}>
                 <DonationFormStateProvider initialState={initialState}>
-                    <MultiStepForm sections={form.nodes} showHeader={form.settings?.showHeader} />
+                    <MultiStepForm form={form} />
                 </DonationFormStateProvider>
             </DonationFormSettingsProvider>
         );
     }
 
     return (
-        <DonationFormSettingsProvider value={formSettings}>
+        <DonationFormSettingsProvider value={{...form.settings, ...donationFormNodeSettings}}>
             <DonationFormStateProvider initialState={initialState}>
-                {form.settings?.showHeader && <Header />}
+                {form.settings?.showHeader && <Header form={form} />}
                 <Form defaultValues={defaultValues} sections={form.nodes} validationSchema={schema} />
             </DonationFormStateProvider>
         </DonationFormSettingsProvider>
     );
 }
 
+/**
+ * @unreleased
+ */
+function AppPreview() {
+
+    const {
+        subscribeToGoal,
+        subscribeToColors,
+        subscribeToSettings,
+        subscribeToCss,
+        unsubscribeAll
+    } = useDonationFormPubSub();
+
+    const [formState, setFormState] = useState<DonationForm>(form);
+
+    useEffect(() => {
+        subscribeToSettings((settings) => {
+            setFormState(prevState => {
+                return {
+                    ...prevState,
+                    settings: {
+                        ...prevState.settings,
+                        ...settings
+                    }
+                }
+            })
+        })
+
+        subscribeToGoal((goal) => {
+            setFormState(prevState => {
+                return {
+                    ...prevState,
+                    goal: {
+                        ...prevState.goal,
+                        ...goal
+                    }
+                }
+            })
+        })
+
+        subscribeToColors((data) => {
+            if (data['primaryColor']) {
+                root.style.setProperty('--givewp-primary-color', data['primaryColor']);
+            }
+
+            if (data['secondaryColor']) {
+                root.style.setProperty('--givewp-secondary-color', data['secondaryColor']);
+            }
+        })
+
+        subscribeToCss(({customCss}) => {
+            style.innerHTML = customCss;
+        })
+
+
+        return () => unsubscribeAll();
+
+    }, []);
+
+    return <App form={formState} />
+}
+
 const root = document.getElementById('root-givewp-donation-form');
+const style = document.getElementById('root-givewp-donation-form-style');
 
 if (createRoot) {
-    createRoot(root).render(<App />);
+    createRoot(root).render(previewMode ? <AppPreview /> : <App form={form} />);
 } else {
-    render(<App />, root);
+    render(previewMode ? <AppPreview /> : <App form={form} />, root);
 }

src/DonationForms/resources/app/form/Header.tsx

@@ -1,30 +1,29 @@
+import {useCallback} from 'react';
 import {withTemplateWrapper} from '../templates';
-import getWindowData from '../utilities/getWindowData';
 import type {GoalType} from '@givewp/forms/propTypes';
 import amountFormatter from '@givewp/forms/app/utilities/amountFormatter';
 import DonationFormErrorBoundary from '@givewp/forms/app/errors/boundaries/DonationFormErrorBoundary';
 
-const {form} = getWindowData();
 const formTemplates = window.givewp.form.templates;
 
 const HeaderTemplate = withTemplateWrapper(formTemplates.layouts.header);
 const HeaderTitleTemplate = withTemplateWrapper(formTemplates.layouts.headerTitle);
 const HeaderDescriptionTemplate = withTemplateWrapper(formTemplates.layouts.headerDescription);
 const GoalTemplate = withTemplateWrapper(formTemplates.layouts.goal);
 
-/**
- * @since 3.0.0
- */
-const formatGoalAmount = (amount: number) => {
-    return amountFormatter(form.currency, {
-        maximumFractionDigits: 0,
-    }).format(amount);
-};
+
 
 /**
  * @since 3.0.0
  */
-export default function Header() {
+export default function Header({form}) {
+
+    const formatGoalAmount = useCallback((amount: number) => {
+        return amountFormatter(form.currency, {
+            maximumFractionDigits: 0,
+        }).format(amount);
+    }, []);
+
     return (
         <DonationFormErrorBoundary>
             <HeaderTemplate

src/DonationForms/resources/app/form/MultiStepForm/components/HeaderStep.tsx

@@ -7,13 +7,13 @@ import {useDonationFormSettings} from '@givewp/forms/app/store/form-settings';
 /**
  * @since 3.0.0
  */
-export default function HeaderStep() {
+export default function HeaderStep({form}) {
     const dispatchMultiStep = useDonationFormMultiStepStateDispatch();
     const {multiStepFirstButtonText} = useDonationFormSettings();
 
     return (
         <div>
-            <Header />
+            <Header form={form} />
             <button
                 type="button"
                 className="givewp-donation-form__steps-button-next"

src/DonationForms/resources/app/form/MultiStepForm/index.tsx

@@ -9,6 +9,7 @@ import SectionNode from '@givewp/forms/app/fields/SectionNode';
 import Steps from '@givewp/forms/app/form/MultiStepForm/components/Steps';
 import HeaderStep from '@givewp/forms/app/form/MultiStepForm/components/HeaderStep';
 import {DonationSummaryProvider} from '@givewp/forms/app/store/donation-summary';
+import type {Form} from '@givewp/forms/types';
 
 const FormSectionTemplate = withTemplateWrapper(window.givewp.form.templates.layouts.section, 'section');
 
@@ -55,23 +56,23 @@ const convertSectionsToSteps = (sections: Section[], hasFirstStep: boolean) => {
 /**
  * @since 3.0.0
  */
-export default function MultiStepForm({sections, showHeader}: {sections: Section[]; showHeader?: boolean}) {
-    const steps = convertSectionsToSteps(sections, showHeader);
+export default function MultiStepForm({form}: {form: Form}) {
+    const steps = convertSectionsToSteps(form.nodes, form.settings?.showHeader);
 
-    if (showHeader) {
+    if (form.settings?.showHeader) {
         steps.unshift({
             id: 0,
             title: null,
             description: null,
-            element: <HeaderStep />,
+            element: <HeaderStep form={form} />,
             fields: [],
             visibilityConditions: [],
             isVisible: true,
         });
     }
 
     return (
-        <DonationFormMultiStepStateProvider initialState={{steps, currentStep: 0, showHeader}}>
+        <DonationFormMultiStepStateProvider initialState={{steps, currentStep: 0, showHeader: form.settings?.showHeader}}>
             <DonationSummaryProvider>
                 <Steps steps={steps} />
             </DonationSummaryProvider>