newspack-components 2.1.0 → 2.2.1

package/dist/esm/with-wizard/index.js

@@ -1,5 +1,4 @@
 import _defineProperty from "@babel/runtime/helpers/defineProperty";
-
 /**
  * WordPress dependencies.
  */
@@ -8,10 +7,10 @@ import { __ as alias__ } from '@wordpress/i18n';
 const __ = alias__;
 import apiFetch from '@wordpress/api-fetch';
 import { home } from '@wordpress/icons';
+
 /**
  * Internal dependencies.
  */
-
 import { Button, Card, Modal, NewspackIcon, Notice, PluginInstaller } from '../';
 import Router from '../proxied-imports/router';
 import Footer from '../footer';
@@ -22,24 +21,27 @@ const {
   Redirect,
   Route
 } = Router;
+
 /**
  * Higher-Order Component to provide plugin management and error handling to Newspack Wizards.
  */
-
 export default function withWizard(WrappedComponent, requiredPlugins) {
   return class WrappedWithWizard extends Component {
     constructor(props) {
       super(props);
-
       _defineProperty(this, "componentDidMount", () => {
         // If there are no requiredPlugins, fire onWizardReady as soon as component mounts.
         if (!requiredPlugins) {
-          const instance = this.wrappedComponentRef.current; // eslint-disable-next-line no-unused-expressions
-
+          const instance = this.wrappedComponentRef.current;
+          // eslint-disable-next-line no-unused-expressions
           instance && instance.onWizardReady && instance.onWizardReady();
         }
       });
-
+      /**
+       * Set the error. Called by Wizards when an error occurs.
+       *
+       * @return {Promise} Resolved after state update
+       */
       _defineProperty(this, "setError", error => {
         return new Promise(resolve => {
           this.setState({
@@ -47,28 +49,33 @@ export default function withWizard(WrappedComponent, requiredPlugins) {
           }, () => resolve());
         });
       });
-
+      /**
+       * Render any errors that need rendering.
+       *
+       * @return {Component} Error UI
+       */
       _defineProperty(this, "getError", () => {
         const {
           error
         } = this.state;
-
         if (!error) {
           return null;
         }
-
         const parsedError = this.parseError(error);
         const {
           level
         } = parsedError;
-
         if ('fatal' === level) {
           return this.getFatalError(parsedError);
         }
-
         return this.getErrorNotice(parsedError);
       });
-
+      /**
+       * Get a notice-level error.
+       *
+       * @param {Error} error object already parsed by parseError
+       * @return {Component} Error notice
+       */
       _defineProperty(this, "getErrorNotice", error => {
         const {
           message
@@ -80,14 +87,17 @@ export default function withWizard(WrappedComponent, requiredPlugins) {
           rawHTML: true
         });
       });
-
+      /**
+       * Get a fatal-level error.
+       *
+       * @param {Error} error object already parsed by parseError
+       * @return {Component} React object
+       */
       _defineProperty(this, "getFatalError", error => {
         const fallbackURL = this.getFallbackURL();
-
         if (!fallbackURL) {
           return null;
         }
-
         const {
           message
         } = error;
@@ -110,7 +120,12 @@ export default function withWizard(WrappedComponent, requiredPlugins) {
           })]
         });
       });
-
+      /**
+       * Get all the relevant info out of a raw API error response.
+       *
+       * @param {Object} error error object
+       * @return {Object} Error object with relevant fields and defaults
+       */
       _defineProperty(this, "parseError", error => {
         const {
           data,
@@ -118,28 +133,26 @@ export default function withWizard(WrappedComponent, requiredPlugins) {
           code
         } = error;
         let level = 'fatal';
-
         if (!!data && 'level' in data) {
           level = data.level;
         } else if ('rest_invalid_param' === code) {
           level = 'notice';
         }
-
         return {
           message,
           level
         };
       });
-
+      /**
+       * Called when plugin installation is complete. Updates state and calls onWizardReady on the wrapped component.
+       */
       _defineProperty(this, "pluginInstallationStatus", _ref => {
         let {
           complete
         } = _ref;
-
         if (this.state.loading) {
           this.doneLoading();
         }
-
         const instance = this.wrappedComponentRef.current;
         this.setState({
           complete
@@ -148,7 +161,9 @@ export default function withWizard(WrappedComponent, requiredPlugins) {
           complete && instance && instance.onWizardReady && instance.onWizardReady();
         });
       });
-
+      /**
+       * Begin loading.
+       */
       _defineProperty(this, "startLoading", quiet => {
         if (quiet) {
           this.setState(state => ({
@@ -160,7 +175,9 @@ export default function withWizard(WrappedComponent, requiredPlugins) {
           }));
         }
       });
-
+      /**
+       * End loading.
+       */
       _defineProperty(this, "doneLoading", quiet => {
         if (quiet) {
           this.setState(state => ({
@@ -172,7 +189,9 @@ export default function withWizard(WrappedComponent, requiredPlugins) {
           }));
         }
       });
-
+      /**
+       * Replacement for core apiFetch that automatically manages wizard loading UI.
+       */
       _defineProperty(this, "wizardApiFetch", args => {
         const {
           quiet
@@ -188,20 +207,22 @@ export default function withWizard(WrappedComponent, requiredPlugins) {
           });
         });
       });
-
+      /**
+       * Render a Route that checks for plugin installation requirements, and redirects to '/' when all are done.
+       *
+       * @return {void}
+       */
       _defineProperty(this, "pluginRequirements", () => {
         const {
           complete
         } = this.state;
         /* After all plugins are loaded, redirect to / (this could be configurable) */
-
         if (complete) {
           return _jsx(Redirect, {
             from: "/plugin-requirements",
             to: "/"
           });
         }
-
         return _jsx(Route, {
           path: "/",
           render: () => _jsxs(Fragment, {
@@ -238,13 +259,11 @@ export default function withWizard(WrappedComponent, requiredPlugins) {
           })
         });
       });
-
       _defineProperty(this, "getFallbackURL", () => {
         if (typeof newspack_urls !== 'undefined') {
           return newspack_urls.dashboard;
         }
       });
-
       this.state = {
         complete: null,
         error: null,
@@ -253,7 +272,6 @@ export default function withWizard(WrappedComponent, requiredPlugins) {
       };
       this.wrappedComponentRef = createRef();
     }
-
     /**
      * Render.
      */
@@ -267,11 +285,9 @@ export default function withWizard(WrappedComponent, requiredPlugins) {
         error
       } = this.state;
       const loadingClasses = [loading ? 'newspack-wizard__is-loading' : 'newspack-wizard__is-loaded'];
-
       if (quietLoading) {
         loadingClasses.push('newspack-wizard__is-loading-quiet');
       }
-
       return _jsxs(Fragment, {
         children: [this.getError(), _jsx("div", {
           className: loadingClasses.join(' '),
@@ -293,6 +309,5 @@ export default function withWizard(WrappedComponent, requiredPlugins) {
         })]
       });
     }
-
   };
 }

package/dist/esm/with-wizard/style.scss

@@ -2,8 +2,8 @@
  * With Wizard
  */
 
-@import '~@wordpress/base-styles/colors';
-@import '../../../shared/scss/colors';
+@use '~@wordpress/base-styles/colors' as wp-colors;
+@use '../../../shared/scss/colors';
 
 // Reset Padding of the Admin Page
 
@@ -32,11 +32,11 @@ body[class*='admin_page_newspack-'] {
 
 svg {
 	&.newspack--error {
-		fill: $alert-red;
+		fill: wp-colors.$alert-red;
 		transform: rotate( 180deg );
 	}
 	&.newspack--success {
-		fill: $alert-green;
+		fill: wp-colors.$alert-green;
 	}
 }
 
@@ -44,12 +44,12 @@ svg {
 
 .newspack-wizard__blue {
 	#wpwrap {
-		background: $primary-500;
+		background: colors.$primary-500;
 	}
 
 	.newspack-footer {
-		background: $primary-500;
-		border-color: $primary-500;
+		background: colors.$primary-500;
+		border-color: colors.$primary-500;
 		justify-content: center;
 
 		&__logo {
@@ -76,12 +76,9 @@ svg {
 
 .newspack-wizard__is-loading {
 	background: white;
-	bottom: 0;
 	cursor: wait;
-	left: 0;
+	inset: 0;
 	position: absolute;
-	right: 0;
-	top: 0;
 
 	> * {
 		display: none !important;
@@ -95,38 +92,39 @@ svg {
 	}
 
 	&::before {
-		background: $primary-500;
-		box-shadow: 24px 0 0 white, 69px 0 0 -15px $gray-900, 99px 0 0 -15px $gray-900,
-			129px 0 0 -15px $gray-900, 159px 0 0 -15px $gray-900, 189px 0 0 -15px $gray-900;
+		background: colors.$primary-500;
+		box-shadow: 24px 0 0 white, 69px 0 0 -15px wp-colors.$gray-900,
+			99px 0 0 -15px wp-colors.$gray-900, 129px 0 0 -15px wp-colors.$gray-900,
+			159px 0 0 -15px wp-colors.$gray-900, 189px 0 0 -15px wp-colors.$gray-900;
 		height: 60px;
 		width: 60px;
 	}
 
 	&::after {
-		background: $gray-900;
-		box-shadow: inset -40vw 0 0 0 white, 0 64px 0 0 $gray-700, 40vw 96px 0 0 white,
-			0 96px 0 0 $gray-700;
+		background: wp-colors.$gray-900;
+		box-shadow: inset -40vw 0 0 0 white, 0 64px 0 0 wp-colors.$gray-700, 40vw 96px 0 0 white,
+			0 96px 0 0 wp-colors.$gray-700;
 		height: 24px;
 		margin: 68px auto 0;
 		max-width: 1040px;
 		width: calc( 100% - ( 32px * 2 ) );
 
 		@media screen and ( min-width: 744px ) {
-			box-shadow: inset -400px 0 0 0 white, 0 64px 0 0 $gray-700, 200px 96px 0 0 white,
-				0 96px 0 0 $gray-700;
+			box-shadow: inset -400px 0 0 0 white, 0 64px 0 0 wp-colors.$gray-700, 200px 96px 0 0 white,
+				0 96px 0 0 wp-colors.$gray-700;
 			width: calc( 100% - ( 64px * 2 ) );
 		}
 
 		@media screen and ( min-width: 1224px ) {
-			box-shadow: inset -600px 0 0 0 white, 0 64px 0 0 $gray-700, 512px 96px 0 0 white,
-				0 96px 0 0 $gray-700;
+			box-shadow: inset -600px 0 0 0 white, 0 64px 0 0 wp-colors.$gray-700, 512px 96px 0 0 white,
+				0 96px 0 0 wp-colors.$gray-700;
 			width: calc( 100% - ( 64px * 2 ) );
 		}
 	}
 
 	// Blue Screen
 	.newspack-wizard__blue & {
-		background: $primary-500;
+		background: colors.$primary-500;
 
 		&::before {
 			animation: loading-quiet 1.25s ease-in-out infinite;
@@ -182,7 +180,7 @@ svg {
 
 		&::before {
 			animation: loading-quiet 1.25s ease-in-out infinite;
-			background: $primary-500;
+			background: colors.$primary-500;
 			height: 8px;
 			right: 100%;
 			z-index: 9999;
@@ -210,42 +208,42 @@ svg {
 		animation: loading 2s ease-in-out infinite;
 		content: '';
 		display: block;
-		background: $gray-900;
-		box-shadow: inset -40vw 0 0 0 white, 0 64px 0 0 $gray-700, 40vw 96px 0 0 white,
-			0 96px 0 0 $gray-700;
+		background: wp-colors.$gray-900;
+		box-shadow: inset -40vw 0 0 0 white, 0 64px 0 0 wp-colors.$gray-700, 40vw 96px 0 0 white,
+			0 96px 0 0 wp-colors.$gray-700;
 		height: 24px;
 		margin: 0 auto;
 		max-width: 1040px;
 		width: 100%;
 
 		@media screen and ( min-width: 744px ) {
-			box-shadow: inset -400px 0 0 0 white, 0 64px 0 0 $gray-700, 200px 96px 0 0 white,
-				0 96px 0 0 $gray-700;
+			box-shadow: inset -400px 0 0 0 white, 0 64px 0 0 wp-colors.$gray-700, 200px 96px 0 0 white,
+				0 96px 0 0 wp-colors.$gray-700;
 		}
 
 		@media screen and ( min-width: 1224px ) {
-			box-shadow: inset -600px 0 0 0 white, 0 64px 0 0 $gray-700, 520px 96px 0 0 white,
-				0 96px 0 0 $gray-700;
+			box-shadow: inset -600px 0 0 0 white, 0 64px 0 0 wp-colors.$gray-700, 520px 96px 0 0 white,
+				0 96px 0 0 wp-colors.$gray-700;
 		}
 	}
 }
 
 @keyframes loading {
-	from {
-		opacity: 100%;
+	0% {
+		opacity: 1;
 	}
 
 	50% {
-		opacity: 10%;
+		opacity: 0.1;
 	}
 
-	to {
-		opacity: 100%;
+	100% {
+		opacity: 1;
 	}
 }
 
 @keyframes loading-quiet {
-	from {
+	0% {
 		left: 0;
 		right: 100%;
 	}
@@ -255,7 +253,7 @@ svg {
 		right: 0;
 	}
 
-	to {
+	100% {
 		left: 100%;
 		right: 0;
 	}

package/dist/esm/with-wizard-screen/index.js

@@ -4,22 +4,22 @@
 import { __ as alias__ } from '@wordpress/i18n';
 const __ = alias__;
 import { category } from '@wordpress/icons';
+
 /**
  * Internal dependencies
  */
-
-import { Button, Handoff, NewspackIcon, Notice, TabbedNavigation } from '../';
+import { Button, Handoff, NewspackIcon, Notice, HandoffMessage, TabbedNavigation } from '../';
 import { buttonProps } from '../../../shared/js/';
 import './style.scss';
+
 /**
  * External dependencies
  */
-
 import classnames from 'classnames';
+
 /**
  * Higher-Order Component to provide plugin management and error handling to Newspack Wizards.
  */
-
 import { jsx as _jsx } from "@emotion/react/jsx-runtime";
 import { jsxs as _jsxs } from "@emotion/react/jsx-runtime";
 import { Fragment as _Fragment } from "@emotion/react/jsx-runtime";
@@ -27,7 +27,6 @@ export default function withWizardScreen(WrappedComponent) {
   let {
     hidePrimaryButton
   } = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
-
   const WrappedWithWizardScreen = props => {
     const {
       className,
@@ -47,7 +46,6 @@ export default function withWizardScreen(WrappedComponent) {
     const SecondaryCTAComponent = retrievedSecondaryButtonProps.plugin ? Handoff : Button;
     const shouldRenderPrimaryButton = buttonText && buttonAction;
     const shouldRenderSecondaryButton = secondaryButtonText && secondaryButtonAction;
-
     const renderPrimaryButton = function () {
       let overridingProps = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
       return retrievedButtonProps.plugin ? _jsx(Handoff, {
@@ -58,7 +56,8 @@ export default function withWizardScreen(WrappedComponent) {
       }) : _jsx(Button, {
         isPrimary: !buttonDisabled,
         isSecondary: !!buttonDisabled,
-        disabled: buttonDisabled // Allow overridingProps to set children.
+        disabled: buttonDisabled
+        // Allow overridingProps to set children.
         // eslint-disable-next-line react/no-children-prop
         ,
         children: buttonText,
@@ -66,7 +65,6 @@ export default function withWizardScreen(WrappedComponent) {
         ...overridingProps
       });
     };
-
     return _jsxs(_Fragment, {
       children: [newspack_aux_data.is_debug_mode && _jsx(Notice, {
         debugMode: true
@@ -98,9 +96,10 @@ export default function withWizardScreen(WrappedComponent) {
       }), tabbedNavigation && _jsx(TabbedNavigation, {
         disableUpcoming: disableUpcomingInTabbedNavigation,
         items: tabbedNavigation.filter(item => !item.isHiddenInNav)
-      }), _jsxs("div", {
+      }), _jsx(HandoffMessage, {}), _jsxs("div", {
         className: classnames('newspack-wizard newspack-wizard__content', className),
-        children: [typeof renderAboveContent === 'function' ? renderAboveContent() : null, _jsx(WrappedComponent, { ...props,
+        children: [typeof renderAboveContent === 'function' ? renderAboveContent() : null, _jsx(WrappedComponent, {
+          ...props,
           renderPrimaryButton: renderPrimaryButton
         }), (shouldRenderPrimaryButton || shouldRenderSecondaryButton) && _jsxs("div", {
           className: "newspack-buttons-card",
@@ -113,6 +112,5 @@ export default function withWizardScreen(WrappedComponent) {
       })]
     });
   };
-
   return WrappedWithWizardScreen;
 }

package/dist/esm/with-wizard-screen/style.scss

@@ -2,19 +2,19 @@
  * With Wizard Screen
  */
 
-@import '~@wordpress/base-styles/colors';
-@import '../../../shared/scss/colors';
+@use '~@wordpress/base-styles/colors' as wp-colors;
+@use '../../../shared/scss/colors';
 
 .newspack-wizard {
 	// Color
-	--wp-admin-theme-color: #{$primary-500};
-	--wp-admin-theme-color--rgb: #{$primary-500--rgb};
-	--wp-admin-theme-color-darker-10: #{$primary-600};
-	--wp-admin-theme-color-darker-10--rgb: #{$primary-600--rgb};
-	--wp-admin-theme-color-darker-20: #{$primary-700};
-	--wp-admin-theme-color-darker-20--rgb: #{$primary-700--rgb};
+	--wp-admin-theme-color: #{colors.$primary-500};
+	--wp-admin-theme-color--rgb: #{colors.$primary-500--rgb};
+	--wp-admin-theme-color-darker-10: #{colors.$primary-600};
+	--wp-admin-theme-color-darker-10--rgb: #{colors.$primary-600--rgb};
+	--wp-admin-theme-color-darker-20: #{colors.$primary-700};
+	--wp-admin-theme-color-darker-20--rgb: #{colors.$primary-700--rgb};
 
-	color: $gray-900;
+	color: wp-colors.$gray-900;
 
 	// Headings
 	h1,
@@ -49,7 +49,7 @@
 
 	&__title {
 		align-items: center;
-		border-bottom: 1px solid $gray-300;
+		border-bottom: 1px solid wp-colors.$gray-300;
 		display: flex;
 
 		h2 {
@@ -63,7 +63,7 @@
 			padding: 0 24px;
 
 			span {
-				color: $gray-700;
+				color: wp-colors.$gray-700;
 				display: none;
 				margin-left: 8px;
 
@@ -83,7 +83,7 @@
 			}
 
 			&:not( .newspack-icon ) {
-				background: $primary-500;
+				background: colors.$primary-500;
 				left: 50%;
 				margin: -28px 0 0 -28px !important;
 				opacity: 0;
@@ -110,13 +110,10 @@
 				&::before {
 					border: 2px solid white;
 					border-radius: 2px;
-					bottom: 5px;
 					content: '';
 					display: block;
-					left: 6px;
+					inset: 6px 6px 5px;
 					position: absolute;
-					right: 6px;
-					top: 6px;
 				}
 			}
 		}
@@ -145,7 +142,7 @@
 		// Thematic Break
 
 		hr {
-			background: $gray-300;
+			background: wp-colors.$gray-300;
 			border: 0;
 			height: 1px;
 			margin: 48px 0;

package/dist/esm/wizard/components/WizardError.js

@@ -4,15 +4,14 @@
 import { __ as alias__ } from '@wordpress/i18n';
 const __ = alias__;
 import { useSelect } from '@wordpress/data';
+
 /**
  * Internal dependencies.
  */
-
 import { Button, Card, Modal, Notice } from '../..';
 import { WIZARD_STORE_NAMESPACE } from '../store';
 import { jsx as _jsx } from "@emotion/react/jsx-runtime";
 import { jsxs as _jsxs } from "@emotion/react/jsx-runtime";
-
 const parseError = _ref => {
   let {
     data,
@@ -20,31 +19,25 @@ const parseError = _ref => {
     code
   } = _ref;
   let level = 'fatal';
-
   if (!!data && 'level' in data) {
     level = data.level;
   } else if ('rest_invalid_param' === code) {
     level = 'notice';
   }
-
   return {
     message,
     level
   };
 };
-
 const WizardError = () => {
   const error = useSelect(select => select(WIZARD_STORE_NAMESPACE).getError());
-
   if (!error) {
     return null;
   }
-
   const {
     level,
     message
   } = parseError(error);
-
   if ('fatal' === level) {
     const fallbackURL = typeof newspack_urls !== 'undefined' && newspack_urls.dashboard;
     return _jsxs(Modal, {
@@ -66,7 +59,6 @@ const WizardError = () => {
       })]
     });
   }
-
   return _jsx(Notice, {
     isError: true,
     className: "newspack-wizard__above-header",
@@ -74,5 +66,4 @@ const WizardError = () => {
     rawHTML: true
   });
 };
-
 export default WizardError;