@pareto-engineering/design-system 4.0.0-alpha.4 → 4.0.0-alpha.9

package/src/ui/b/Button/styles.scss

@@ -24,6 +24,7 @@ $default-animation-time: .31s;
 
   &.arrow-right {
     &::after {
+      align-self: center;
       content: "-->";
       margin-left: $default-margin;
       vertical-align: middle;
@@ -39,6 +40,7 @@ $default-animation-time: .31s;
 
   &.arrow-left {
     &::before {
+      align-self: center;
       content: "<--";
       margin-right: $default-margin;
       vertical-align: middle;

package/src/ui/b/Card/Card.jsx

@@ -0,0 +1,94 @@
+/* @pareto-engineering/generator-front 1.0.12 */
+import * as React from 'react'
+
+import { useInsertionEffect } from 'react'
+
+import PropTypes from 'prop-types'
+
+import styleNames from '@pareto-engineering/bem/exports'
+
+import { ProgressBar } from 'ui'
+
+import { Group, Section } from './common'
+
+// Local Definitions
+
+const baseClassName = styleNames.base
+
+const componentClassName = 'card'
+
+/**
+ * This is the component description.
+ */
+const Card = ({
+  id,
+  className: userClassName,
+  style,
+  children,
+  progress,
+  progressBarColor,
+}) => {
+  useInsertionEffect(() => {
+    import('./styles.scss')
+  }, [])
+
+  return (
+    <div
+      id={id}
+      className={[
+        baseClassName,
+        componentClassName,
+        userClassName,
+      ]
+        .filter((e) => e)
+        .join(' ')}
+      style={style}
+    >
+      {progress && (
+        <ProgressBar
+          attached
+          color={progressBarColor}
+          progress={progress}
+          height=".5em"
+        />
+      )}
+      {children}
+    </div>
+  )
+}
+
+Card.propTypes = {
+  /**
+   * The HTML id for this element
+   */
+  id:PropTypes.string,
+
+  /**
+   * The HTML class names for this element
+   */
+  className:PropTypes.string,
+
+  /**
+   * The React-written, css properties for this element.
+   */
+  style:PropTypes.objectOf(PropTypes.string),
+
+  /**
+   * The progress bar percentage
+  */
+  progress:PropTypes.number,
+
+  /**
+   * The progress bar color
+   */
+  progressBarColor:PropTypes.string,
+}
+
+Card.defaultProps = {
+  progressBarColor:'main',
+}
+
+Card.Section = Section
+Card.Group = Group
+
+export default Card

package/src/ui/b/Card/common/Group/Group.jsx

@@ -0,0 +1,91 @@
+/* @pareto-engineering/generator-front 1.0.12 */
+import * as React from 'react'
+
+import { useInsertionEffect } from 'react'
+
+import PropTypes from 'prop-types'
+
+import styleNames from '@pareto-engineering/bem/exports'
+
+import { SnapScroller } from 'ui'
+
+// Local Definitions
+
+const baseClassName = styleNames.base
+
+const componentClassName = 'group'
+
+const Group = ({
+  id,
+  className: userClassName,
+  style,
+  children,
+  type,
+  desktopType,
+  ...otherProps
+}) => {
+  useInsertionEffect(() => {
+    import('./styles.scss')
+  }, [])
+  const Wrapper = type === 'snap-scroller' ? SnapScroller : 'div'
+  const wrapperProps = type === 'snap-scroller' ? { noScrollOnDesktop: true } : {}
+
+  return (
+    <Wrapper
+      id={id}
+      className={[
+        baseClassName,
+        componentClassName,
+        userClassName,
+        type === 'grid' ? 'grid' : type,
+        `desktop-${desktopType}`,
+      ]
+        .filter((e) => e)
+        .join(' ')}
+      style={style}
+      {...otherProps}
+      {...wrapperProps}
+    >
+      {children}
+    </Wrapper>
+  )
+}
+
+Group.propTypes = {
+  /**
+   * The HTML id for this element
+   */
+  id:PropTypes.string,
+
+  /**
+   * The HTML class names for this element
+   */
+  className:PropTypes.string,
+
+  /**
+   * The React-written, css properties for this element.
+   */
+  style:PropTypes.objectOf(PropTypes.string),
+
+  /**
+   * The children JSX
+   */
+  children:PropTypes.node,
+
+  /**
+   * Type of container by default
+   */
+  type:PropTypes.oneOf(['grid', 'vertical-flexbox', 'snap-scroller']),
+
+  /**
+   * Type of container for desktop
+  */
+  desktopType:PropTypes.oneOf(['grid', 'vertical-flexbox']),
+}
+
+Group.defaultProps = {
+  type       :'snap-scroller',
+  desktopType:'vertical-flexbox',
+}
+
+export default Group

package/src/ui/b/Card/common/Group/index.js

@@ -0,0 +1 @@
+export { default as Group } from './Group'

package/src/ui/b/Card/common/Group/styles.scss

@@ -0,0 +1,42 @@
+/* @pareto-engineering/generator-front 1.0.12 */
+
+@use "@pareto-engineering/bem";
+@use "@pareto-engineering/styles/src/mixins";
+@use "@pareto-engineering/styles/src/globals" as *;
+
+$default-spacing: var(--gap);
+
+.#{bem.$base}.group {
+  gap: $default-spacing;
+
+  &.snap-scroller {
+    margin-left: calc($default-spacing * -1);
+    margin-right: calc($default-spacing * -1);
+
+    > .#{bem.$base}.card {
+      height: 100%;
+    }
+  }
+
+  &.vertical-flexbox {
+    display: flex;
+    flex-direction: column;
+  }
+
+  @include mixins.media($from: $sm-md) {
+    &.desktop-grid {
+      display: grid;
+      grid-template-columns: repeat(var(--columns), 1fr);
+    }
+
+    &.snap-scroller {
+      margin-left: unset;
+      margin-right: unset;
+    }
+
+    &.desktop-vertical-flexbox {
+      display: flex;
+      flex-direction: column;
+    }
+  }
+}

package/src/ui/b/Card/common/Section/Section.jsx

@@ -0,0 +1,70 @@
+/* @pareto-engineering/generator-front 1.0.12 */
+import * as React from 'react'
+
+import PropTypes from 'prop-types'
+
+import styleNames from '@pareto-engineering/bem/exports'
+
+// Local Definitions
+
+const baseClassName = styleNames.base
+
+const componentClassName = 'section'
+
+const Section = ({
+  id,
+  className:userClassName,
+  style,
+  children,
+  isImage,
+  ...otherProps
+}) => (
+  <div
+    id={id}
+    className={[
+      baseClassName,
+      componentClassName,
+      userClassName,
+      isImage && styleNames.modifierImage,
+    ]
+      .filter((e) => e)
+      .join(' ')}
+    style={style}
+    {...otherProps}
+  >
+    {children}
+  </div>
+)
+
+Section.propTypes = {
+  /**
+   * The HTML id for this element
+   */
+  id:PropTypes.string,
+
+  /**
+   * The HTML class names for this element
+   */
+  className:PropTypes.string,
+
+  /**
+   * The React-written, css properties for this element.
+   */
+  style:PropTypes.objectOf(PropTypes.string),
+
+  /**
+   *  The children JSX
+   */
+  children:PropTypes.node,
+
+  /**
+   * Whether to use the image modifier class
+   */
+  isImage:PropTypes.bool,
+}
+
+Section.defaultProps = {
+  // someProp:false
+}
+
+export default Section

package/src/ui/b/Card/common/Section/index.js

@@ -0,0 +1 @@
+export { default as Section } from './Section'

package/src/ui/b/Card/common/index.js

@@ -0,0 +1,2 @@
+export { Section } from './Section'
+export { Group } from './Group'

package/src/ui/b/Card/index.js

@@ -0,0 +1 @@
+export { default as Card } from './Card'

package/src/ui/b/Card/styles.scss

@@ -0,0 +1,46 @@
+/* @pareto-engineering/generator-front 1.0.12 */
+
+@use "@pareto-engineering/bem";
+
+$default-border-radius: var(--theme-default-border-radius);
+$default-border-color: var(--hard-background-cards);
+$default-background: var(--background-cards-80);
+$default-padding: 1.5em;
+
+.#{bem.$base}.card {
+  background: $default-background;
+  border: 1px solid $default-border-color;
+  border-radius: $default-border-radius;
+  display: flex;
+  flex-direction: column;
+  overflow: hidden;
+  position: relative;
+
+  > .progress-bar {
+    left: 0;
+    position: absolute;
+    top: 0;
+    width: 100%;
+  }
+
+  > .#{bem.$base}.section:nth-last-child(2) {
+    flex-grow: 1;
+  }
+
+  > .#{bem.$base}.section {
+    padding: $default-padding;
+
+    &.#{bem.$modifier-image} {
+      padding: 0;
+
+      img {
+        border-radius: $default-border-radius;
+        width: 100%;
+      }
+    }
+  }
+
+  > .#{bem.$base}.section + .#{bem.$base}.section {
+    padding-top: 0;
+  }
+}

package/src/ui/b/Logo/Logo.jsx

@@ -1,7 +1,7 @@
 /* @pareto-engineering/generator-front 1.0.12 */
 import * as React from 'react'
 
-import { useMemo, useLayoutEffect } from 'react'
+import { useMemo, useInsertionEffect } from 'react'
 
 import PropTypes from 'prop-types'
 
@@ -64,7 +64,7 @@ const Logo = ({
   square,
   // ...otherProps
 }) => {
-  useLayoutEffect(() => {
+  useInsertionEffect(() => {
     import('./styles.scss')
   }, [])
 

package/src/ui/b/Page/Page.jsx

@@ -1,6 +1,6 @@
 /* @pareto-engineering/generator-front 1.0.0 */
 import * as React from 'react'
-import { useLayoutEffect, useEffect } from 'react'
+import { useInsertionEffect, useEffect } from 'react'
 import PropTypes from 'prop-types'
 import styleNames from '@pareto-engineering/bem/exports'
 
@@ -23,13 +23,13 @@ const Page = ({
   className:userClassName,
   style,
   children,
-
   itemType,
   as:Wrapper,
   helmetProps,
+  Background,
   ...otherProps
 }) => {
-  useLayoutEffect(() => {
+  useInsertionEffect(() => {
     import('./styles.scss')
   }, [])
 
@@ -70,6 +70,7 @@ const Page = ({
         )}
         { helmetProps && <PageHelmet {...helmetProps} /> }
         {children}
+        {Background && <Background className="background" />}
       </Wrapper>
     </Context.Provider>
   )
@@ -110,6 +111,11 @@ Page.propTypes = {
   * The props to pass to `Page.Helmet`. Refer to the corresponding section of the docs.
   */
   helmetProps:PropTypes.objectOf(PropTypes.string),
+
+  /**
+   * The component to use as background
+   */
+  Background:PropTypes.node,
 }
 
 Page.defaultProps = {

package/src/ui/b/Page/common/Section/Section.jsx

@@ -14,6 +14,7 @@ const Section = ({
   className:userClassName,
   style,
   children,
+  spaced,
   ...otherProps
 }) => {
   const {
@@ -28,6 +29,8 @@ const Section = ({
         baseClassName,
         componentClassName,
         userClassName,
+        spaced && styleNames.modifierSpaced,
+        'grid',
       ]
         .filter((e) => e)
         .join(' ')}
@@ -55,6 +58,11 @@ Section.propTypes = {
    */
   style:PropTypes.objectOf(PropTypes.string),
 
+  /**
+   *  Whether the section contains the theme spacing
+   */
+  spaced:PropTypes.bool,
+
   /**
    *  The children JSX
    */

package/src/ui/b/Page/styles.scss

@@ -2,16 +2,34 @@
 /* stylelint-disable selector-max-universal -- exception */
 
 @use "@pareto-engineering/bem";
-
+@use "@pareto-engineering/styles/src/mixins";
+@use "@pareto-engineering/styles/src/globals" as *;
 
 .#{bem.$base}.page {
-  .#{bem.$base}.section {
+  position: relative;
+
+  > .background {
+    position: fixed;
+    z-index: -1;
+  }
+
+  > .#{bem.$base}.section {
+    padding-left: var(--gap);
+    padding-right: var(--gap);
     position: relative;
 
     > *:not(:last-child) {
       z-index: 1;
     }
-  }
-}
 
+    &.#{bem.$modifier-spaced} {
+      padding-bottom: var(--theme-default-section-spacing);
+      padding-top: var(--theme-default-section-spacing);
 
+      @include mixins.media($from: $sm-md) {
+        padding-bottom: var(--theme-desktop-section-spacing);
+        padding-top: var(--theme-desktop-section-spacing);
+      }
+    }
+  }
+}

package/src/ui/b/SocialMediaButton/SocialMediaButton.jsx

@@ -1,7 +1,7 @@
 /* @pareto-engineering/generator-front 1.0.12 */
 import * as React from 'react'
 
-import { useLayoutEffect } from 'react'
+import { useInsertionEffect } from 'react'
 
 import PropTypes from 'prop-types'
 
@@ -52,7 +52,7 @@ const SocialMediaButton = ({
 }) => {
   const applicationContext = useApp()
 
-  useLayoutEffect(() => {
+  useInsertionEffect(() => {
     import('./styles.scss')
   }, [])
 

package/src/ui/b/SocialMediaButton/styles.scss

@@ -32,7 +32,7 @@ $mobile-dimensions: 2.75em;
     background: var(--soft-x);
   }
 
-  &.#{bem.$modifier-transparent} {
+  &.#{bem.$modifier-clear} {
     background: transparent;
     color: var(--y, var(--heading));
 

package/src/ui/b/ThemeSelector/ThemeSelector.jsx

@@ -1,6 +1,6 @@
 /* @pareto-engineering/generator-front 1.0.12 */
 import * as React from 'react'
-import { useLayoutEffect, useCallback } from 'react'
+import { useInsertionEffect, useCallback } from 'react'
 import PropTypes from 'prop-types'
 import styleNames from '@pareto-engineering/bem/exports'
 
@@ -29,7 +29,7 @@ const ThemeSelector = ({
     setPreferredTheme,
   } = useApp()
 
-  useLayoutEffect(() => {
+  useInsertionEffect(() => {
     import('./styles.scss')
   }, [])
 

package/src/ui/b/Title/Title.jsx

@@ -1,12 +1,13 @@
 /* @pareto-engineering/generator-front 0.3.1 */
 import * as React from 'react'
+import { useInsertionEffect } from 'react'
 import PropTypes from 'prop-types'
 
 // Package-level Imports
 import styleNames from '@pareto-engineering/bem/exports'
 
 // Component-level imports
-import('./styles.scss')
+// import('./styles.scss')
 
 // Helper Definition
 const baseClassName = styleNames.base
@@ -28,31 +29,36 @@ const Title = ({
   subtitleStyle,
   subtitleProps,
   // ...otherProps
-}) => (
-  <div
-    id={id}
-    className={[
-      baseClassName,
-      componentClassName,
-      userClassName,
-    ]
-      .filter((e) => e)
-      .join(' ')}
-    style={style}
-  >
-    <HeadingWrapper
+}) => {
+  useInsertionEffect(() => {
+    import('./styles.scss')
+  }, [])
+
+  return (
+    <div
+      id={id}
       className={[
-        headingClassName,
-        styleNames.heading,
+        baseClassName,
+        componentClassName,
+        userClassName,
       ]
         .filter((e) => e)
         .join(' ')}
-      style={headingStyle}
-      {...headingProps}
+      style={style}
     >
-      { heading }
-    </HeadingWrapper>
-    { subtitle
+      <HeadingWrapper
+        className={[
+          headingClassName,
+          styleNames.heading,
+        ]
+          .filter((e) => e)
+          .join(' ')}
+        style={headingStyle}
+        {...headingProps}
+      >
+        { heading }
+      </HeadingWrapper>
+      { subtitle
     && (
     <SubtitleWrapper
       className={[
@@ -67,8 +73,9 @@ const Title = ({
       { subtitle }
     </SubtitleWrapper>
     )}
-  </div>
-)
+    </div>
+  )
+}
 
 Title.propTypes = {
   /**

package/src/ui/b/index.js

@@ -4,3 +4,4 @@ export { Page } from './Page'
 export { SocialMediaButton } from './SocialMediaButton'
 export { ThemeSelector } from './ThemeSelector'
 export { Title } from './Title'
+export { Card } from './Card'

package/src/ui/c/ContentSlides/ContentSlides.jsx

@@ -1,7 +1,7 @@
 /* @pareto-engineering/generator-front 1.0.12 */
 import * as React from 'react'
 
-import { useLayoutEffect, useReducer } from 'react'
+import { useInsertionEffect, useReducer } from 'react'
 
 import PropTypes from 'prop-types'
 
@@ -64,7 +64,7 @@ const ContentSlides = ({
   isDebug,
   // ...otherProps
 }) => {
-  useLayoutEffect(() => {
+  useInsertionEffect(() => {
     import('./styles.scss')
   }, [])
 
@@ -123,7 +123,7 @@ const ContentSlides = ({
     })
   }
 
-  useLayoutEffect(() => {
+  useInsertionEffect(() => {
     setCurrentStep(currentStepIndex)
   },
   [currentStepIndex])

package/src/ui/c/Modal/Modal.jsx

@@ -1,7 +1,7 @@
 /* @pareto-engineering/generator-front 1.0.12 */
 import * as React from 'react'
 
-import { useLayoutEffect } from 'react'
+import { useInsertionEffect } from 'react'
 
 import PropTypes from 'prop-types'
 
@@ -28,7 +28,7 @@ const Modal = ({
   close,
   // ...otherProps
 }) => {
-  useLayoutEffect(() => {
+  useInsertionEffect(() => {
     import('./styles.scss')
   }, [])