From b58db79c170b81b9b61aa746c8c7bb0076912095 Mon Sep 17 00:00:00 2001
From: Pavel Klibani <pavel@techloop.io>
Date: Wed, 4 Dec 2024 13:34:45 +0100
Subject: [PATCH] Feat(web-react): Add minimalistic footer demo #DS-1574

---
 .../src/components/Footer/Footer.tsx          |  18 +++-
 .../web-react/src/components/Footer/README.md |  20 ++++-
 .../Footer/__tests__/Footer.test.tsx          |  17 ++++
 .../src/components/Footer/constants.ts        |   2 +
 .../components/Footer/demo/FooterDefault.tsx  |   2 +-
 .../Footer/demo/FooterMinimalistic.tsx        |  80 ++++++++++++++++++
 .../components/Footer/demo/FooterNested.tsx   |   4 +-
 .../src/components/Footer/demo/index.tsx      |   4 +
 .../src/components/Footer/index.html          |   2 +-
 .../Footer/stories/Footer.stories.tsx         |  28 +++++-
 .../components/Footer/useFooterStyleProps.ts  |  24 ++++++
 packages/web-react/src/types/footer.ts        |  10 ++-
 .../footer-chromium-linux.png                 | Bin 56757 -> 70123 bytes
 13 files changed, 197 insertions(+), 14 deletions(-)
 create mode 100644 packages/web-react/src/components/Footer/constants.ts
 create mode 100644 packages/web-react/src/components/Footer/demo/FooterMinimalistic.tsx
 create mode 100644 packages/web-react/src/components/Footer/useFooterStyleProps.ts

diff --git a/packages/web-react/src/components/Footer/Footer.tsx b/packages/web-react/src/components/Footer/Footer.tsx
index 8a2555b560..3cc45a0ff0 100644
--- a/packages/web-react/src/components/Footer/Footer.tsx
+++ b/packages/web-react/src/components/Footer/Footer.tsx
@@ -2,16 +2,26 @@
 
 import classNames from 'classnames';
 import React from 'react';
+import { BackgroundColors } from '../../constants';
 import { useStyleProps } from '../../hooks';
 import { SpiritFooterProps } from '../../types';
+import { PADDING_BOTTOM, PADDING_TOP } from './constants';
+import { useFooterStyleProps } from './useFooterStyleProps';
 
-const Footer = (props: SpiritFooterProps): JSX.Element => {
-  const { children, ...restProps } = props;
+const defaultStyleProps: Partial<SpiritFooterProps> = {
+  backgroundColor: BackgroundColors.SECONDARY,
+  paddingBottom: PADDING_BOTTOM,
+  paddingTop: PADDING_TOP,
+};
+
+const Footer = (props: SpiritFooterProps) => {
+  const propsWithDefaults = { ...defaultStyleProps, ...props };
+  const { children, backgroundColor, paddingBottom, paddingTop, ...restProps } = propsWithDefaults;
+  const { classProps } = useFooterStyleProps({ backgroundColor, paddingBottom, paddingTop });
   const { styleProps, props: otherProps } = useStyleProps(restProps);
-  const footerClasses = 'bg-secondary pt-1400 pb-1200';
 
   return (
-    <footer {...styleProps} {...otherProps} className={classNames(footerClasses, styleProps.className)}>
+    <footer {...styleProps} {...otherProps} className={classNames(classProps, styleProps.className)}>
       {children}
     </footer>
   );
diff --git a/packages/web-react/src/components/Footer/README.md b/packages/web-react/src/components/Footer/README.md
index 8f9d34cdfe..f6ce1cc8c3 100644
--- a/packages/web-react/src/components/Footer/README.md
+++ b/packages/web-react/src/components/Footer/README.md
@@ -16,7 +16,7 @@ The Footer supports several ready-to-use building blocks:
 This is how all supported building blocks of the Footer build up the complete composition:
 
 ```jsx
-<Footer UNSAFE_className="bg-secondary pt-1400 pb-1200">
+<Footer>
   <Container>
     {/* Grid with navigation links */}
     {/* Grid with product logo, social media links and language switch */}
@@ -137,7 +137,7 @@ This section is optional and consists of a [Flex][flex] layout with secondary li
 ## Full Example
 
 ```jsx
-<Footer UNSAFE_className="bg-secondary pt-1400 pb-1200">
+<Footer>
   <Container>
     {/* Grid with navigation links */}
     <Grid cols={{ mobile: 1, tablet: 2, desktop: 4 }} spacing="space-1000">
@@ -252,11 +252,27 @@ This section is optional and consists of a [Flex][flex] layout with secondary li
 </Footer>
 ```
 
+### API
+
+| Name              | Type                                                       | Default      | Required | Description                                     |
+| ----------------- | ---------------------------------------------------------- | ------------ | -------- | ----------------------------------------------- |
+| `backgroundColor` | [Background Color dictionary][dictionary-background-color] | `secondary`  | ✕        | Sets the background color of the footer         |
+| `paddingBottom`   | `SpaceToken`                                               | `space-1400` | ✕        | Defines the padding at the bottom of the footer |
+| `paddingTop`      | `SpaceToken`                                               | `space-1200` | ✕        | Defines the padding at the top of the footer    |
+
+On top of the API options, the components accept [additional attributes][readme-additional-attributes].
+If you need more control over the styling of a component, you can use [style props][readme-style-props]
+and [escape hatches][readme-escape-hatches].
+
 [buttonlink]: https://github.com/lmc-eu/spirit-design-system/blob/main/packages/web-react/src/components/ButtonLink/README.md
+[dictionary-background-color]: https://github.com/lmc-eu/spirit-design-system/blob/main/docs/DICTIONARIES.md#color
 [divider]: https://github.com/lmc-eu/spirit-design-system/blob/main/packages/web-react/src/components/Divider/README.md
 [flex]: https://github.com/lmc-eu/spirit-design-system/blob/main/packages/web-react/src/components/Flex/README.md
 [grid]: https://github.com/lmc-eu/spirit-design-system/blob/main/packages/web-react/src/components/Grid/README.md
 [product-logo]: https://github.com/lmc-eu/spirit-design-system/blob/main/packages/web-react/src/components/ProductLogo/README.md
+[readme-additional-attributes]: https://github.com/lmc-eu/spirit-design-system/blob/main/packages/web-react/README.md#additional-attributes
+[readme-escape-hatches]: https://github.com/lmc-eu/spirit-design-system/blob/main/packages/web-react/README.md#escape-hatches
+[readme-style-props]: https://github.com/lmc-eu/spirit-design-system/blob/main/packages/web-react/README.md#style-props
 [readme-style-props]: https://github.com/lmc-eu/spirit-design-system/blob/main/packages/web-react/README.md#style-props
 [select]: https://github.com/lmc-eu/spirit-design-system/blob/main/packages/web-react/src/components/Select/README.md
 [stack]: https://github.com/lmc-eu/spirit-design-system/blob/main/packages/web-react/src/components/Stack/README.md
diff --git a/packages/web-react/src/components/Footer/__tests__/Footer.test.tsx b/packages/web-react/src/components/Footer/__tests__/Footer.test.tsx
index 2647384176..bd391fc54d 100644
--- a/packages/web-react/src/components/Footer/__tests__/Footer.test.tsx
+++ b/packages/web-react/src/components/Footer/__tests__/Footer.test.tsx
@@ -3,6 +3,7 @@ import React from 'react';
 import '@testing-library/jest-dom';
 import { restPropsTest } from '../../../../tests/providerTests/restPropsTest';
 import { stylePropsTest } from '../../../../tests/providerTests/stylePropsTest';
+import { BackgroundColors } from '../../../constants';
 import Footer from '../Footer';
 
 describe('Footer', () => {
@@ -15,4 +16,20 @@ describe('Footer', () => {
 
     expect(screen.getByRole('contentinfo')).toHaveTextContent('Hello World');
   });
+
+  it.each([Object.values(BackgroundColors)])('should have background %s color', (color) => {
+    render(<Footer backgroundColor={color}>Hello World</Footer>);
+
+    expect(screen.getByRole('contentinfo')).toHaveClass(`bg-${color}`);
+  });
+
+  it('should have correct correct utility class paddings', () => {
+    render(
+      <Footer paddingTop="space-1000" paddingBottom="space-1100">
+        Hello World
+      </Footer>,
+    );
+
+    expect(screen.getByRole('contentinfo')).toHaveClass('pt-1000 pb-1100');
+  });
 });
diff --git a/packages/web-react/src/components/Footer/constants.ts b/packages/web-react/src/components/Footer/constants.ts
new file mode 100644
index 0000000000..28ccb8ab21
--- /dev/null
+++ b/packages/web-react/src/components/Footer/constants.ts
@@ -0,0 +1,2 @@
+export const PADDING_BOTTOM = 'space-1200';
+export const PADDING_TOP = 'space-1400';
diff --git a/packages/web-react/src/components/Footer/demo/FooterDefault.tsx b/packages/web-react/src/components/Footer/demo/FooterDefault.tsx
index 12c2f5022f..eeb156de9d 100644
--- a/packages/web-react/src/components/Footer/demo/FooterDefault.tsx
+++ b/packages/web-react/src/components/Footer/demo/FooterDefault.tsx
@@ -187,7 +187,7 @@ const FooterDefault = () => {
             elementType="ul"
             direction={{ mobile: 'column', tablet: 'row' }}
             alignmentX={{ mobile: 'stretch', tablet: 'center' }}
-            spacing={{ mobile: 'space-600', tablet: 'space-900' }}
+            spacingX={{ mobile: 'space-600', tablet: 'space-900' }}
             isWrapping
           >
             <li>
diff --git a/packages/web-react/src/components/Footer/demo/FooterMinimalistic.tsx b/packages/web-react/src/components/Footer/demo/FooterMinimalistic.tsx
new file mode 100644
index 0000000000..f53b0ca743
--- /dev/null
+++ b/packages/web-react/src/components/Footer/demo/FooterMinimalistic.tsx
@@ -0,0 +1,80 @@
+import React from 'react';
+import { Container } from '../../Container';
+import { Flex } from '../../Flex';
+import { Grid, GridItem } from '../../Grid';
+import { Link } from '../../Link';
+import { ProductLogo } from '../../ProductLogo';
+import { defaultSvgLogo } from '../../ProductLogo/demo/ProductLogoDefault';
+import { Select } from '../../Select';
+import Footer from '../Footer';
+
+const FooterMinimalistic = () => {
+  return (
+    <Footer paddingBottom="space-900" paddingTop="space-900">
+      <Container>
+        {/* Grid with product logo, social media links and language switch */}
+        <Grid
+          cols={{ mobile: 1, desktop: 12 }}
+          alignmentX={{ mobile: 'center', desktop: 'stretch' }}
+          alignmentY="center"
+          spacingY="space-1100"
+        >
+          {/* Product logo */}
+          <GridItem columnStart={{ desktop: 1 }} columnEnd={{ desktop: 4 }}>
+            <div className="text-desktop-left">
+              <Link href="https://www.example.com">
+                <ProductLogo>{defaultSvgLogo}</ProductLogo>
+              </Link>
+            </div>
+          </GridItem>
+
+          {/* Flex with secondary links */}
+          <GridItem columnStart={{ desktop: 4 }} columnEnd={{ desktop: 10 }}>
+            <nav className="text-center" aria-label="Secondary links">
+              <Flex
+                elementType="ul"
+                direction={{ mobile: 'column', tablet: 'row' }}
+                alignmentX={{ mobile: 'stretch', tablet: 'center' }}
+                spacingX={{ mobile: 'space-600', tablet: 'space-900' }}
+                isWrapping
+              >
+                <li>
+                  <Link href="https://www.example.com" color="secondary">
+                    Legal notice
+                  </Link>
+                </li>
+                <li>
+                  <Link href="https://www.example.com" color="secondary">
+                    Terms of service
+                  </Link>
+                </li>
+                <li>
+                  <Link href="https://www.example.com" color="secondary">
+                    Privacy policy
+                  </Link>
+                </li>
+                <li>
+                  <Link href="https://www.example.com" color="secondary">
+                    Manage cookies
+                  </Link>
+                </li>
+              </Flex>
+            </nav>
+          </GridItem>
+
+          {/* Language switch */}
+          <GridItem columnStart={{ desktop: 11 }} columnEnd={{ desktop: 13 }}>
+            <div className="text-desktop-right">
+              <Select id="select-language" name="selectLanguage" label="Language" isLabelHidden isFluid>
+                <option value="en">English</option>
+                <option value="cs">Čeština</option>
+              </Select>
+            </div>
+          </GridItem>
+        </Grid>
+      </Container>
+    </Footer>
+  );
+};
+
+export default FooterMinimalistic;
diff --git a/packages/web-react/src/components/Footer/demo/FooterNested.tsx b/packages/web-react/src/components/Footer/demo/FooterNested.tsx
index 68e09ba3a5..ca85069c4a 100644
--- a/packages/web-react/src/components/Footer/demo/FooterNested.tsx
+++ b/packages/web-react/src/components/Footer/demo/FooterNested.tsx
@@ -13,7 +13,7 @@ import FooterLinkFactory from './FooterLinkFactory';
 
 const FooterNested = () => {
   return (
-    <Footer UNSAFE_className="bg-secondary pt-1400 pb-1200">
+    <Footer>
       <Container>
         {/* Grid with navigation links */}
         <Grid cols={{ mobile: 1, tablet: 2, desktop: 6 }} spacing="space-1000">
@@ -121,7 +121,7 @@ const FooterNested = () => {
             elementType="ul"
             direction={{ mobile: 'column', tablet: 'row' }}
             alignmentX={{ mobile: 'stretch', tablet: 'center' }}
-            spacing={{ mobile: 'space-600', tablet: 'space-900' }}
+            spacingX={{ mobile: 'space-600', tablet: 'space-900' }}
             isWrapping
           >
             <li>
diff --git a/packages/web-react/src/components/Footer/demo/index.tsx b/packages/web-react/src/components/Footer/demo/index.tsx
index 7bb2f9e432..2119ffc614 100644
--- a/packages/web-react/src/components/Footer/demo/index.tsx
+++ b/packages/web-react/src/components/Footer/demo/index.tsx
@@ -8,6 +8,7 @@ import ReactDOM from 'react-dom/client';
 import DocsSection from '../../../../docs/DocsSections';
 import { IconsProvider } from '../../../context';
 import FooterDefault from './FooterDefault';
+import FooterMinimalistic from './FooterMinimalistic';
 import FooterNested from './FooterNested';
 
 ReactDOM.createRoot(document.getElementById('root') as HTMLElement).render(
@@ -19,6 +20,9 @@ ReactDOM.createRoot(document.getElementById('root') as HTMLElement).render(
       <DocsSection title="Nested Link Blocks, Logo Only" stackAlignment="stretch" container="heading-only">
         <FooterNested />
       </DocsSection>
+      <DocsSection title="Minimalistic" stackAlignment="stretch" container="heading-only">
+        <FooterMinimalistic />
+      </DocsSection>
     </IconsProvider>
   </React.StrictMode>,
 );
diff --git a/packages/web-react/src/components/Footer/index.html b/packages/web-react/src/components/Footer/index.html
index 23972ef557..8a0a07f9f5 100644
--- a/packages/web-react/src/components/Footer/index.html
+++ b/packages/web-react/src/components/Footer/index.html
@@ -1 +1 @@
-{{> web-react/demo}}
+{{> web-react/demo title="Footer" parentPageName="Components"}}
diff --git a/packages/web-react/src/components/Footer/stories/Footer.stories.tsx b/packages/web-react/src/components/Footer/stories/Footer.stories.tsx
index f0178f06f9..8b6212756a 100644
--- a/packages/web-react/src/components/Footer/stories/Footer.stories.tsx
+++ b/packages/web-react/src/components/Footer/stories/Footer.stories.tsx
@@ -1,9 +1,11 @@
 import { Markdown } from '@storybook/blocks';
 import type { Meta, StoryObj } from '@storybook/react';
 import React from 'react';
+import { BackgroundColors } from '../../../constants';
 import { Container } from '../../Container';
+import { PADDING_BOTTOM, PADDING_TOP } from '../constants';
+import Footer from '../Footer';
 import ReadMe from '../README.md';
-import { Footer } from '..';
 
 const meta: Meta<typeof Footer> = {
   title: 'Components/Footer',
@@ -17,9 +19,31 @@ const meta: Meta<typeof Footer> = {
     children: {
       control: 'object',
     },
+    backgroundColor: {
+      control: 'select',
+      options: [...Object.values(BackgroundColors)],
+      table: {
+        defaultValue: { summary: BackgroundColors.SECONDARY },
+      },
+    },
+    paddingBottom: {
+      control: 'text',
+      table: {
+        defaultValue: { summary: 'space-1200' },
+      },
+    },
+    paddingTop: {
+      control: 'text',
+      table: {
+        defaultValue: { summary: 'space-1400' },
+      },
+    },
   },
   args: {
     children: <Container>Footer content</Container>,
+    backgroundColor: BackgroundColors.SECONDARY,
+    paddingBottom: PADDING_BOTTOM,
+    paddingTop: PADDING_TOP,
   },
 };
 
@@ -28,5 +52,5 @@ type Story = StoryObj<typeof Footer>;
 
 export const Playground: Story = {
   name: 'Footer',
-  render: (args) => <Footer UNSAFE_className="bg-secondary pt-1400 pb-1200" {...args} />,
+  render: (args) => <Footer {...args} />,
 };
diff --git a/packages/web-react/src/components/Footer/useFooterStyleProps.ts b/packages/web-react/src/components/Footer/useFooterStyleProps.ts
new file mode 100644
index 0000000000..2f6b0f6919
--- /dev/null
+++ b/packages/web-react/src/components/Footer/useFooterStyleProps.ts
@@ -0,0 +1,24 @@
+import classNames from 'classnames';
+import { SpiritFooterProps } from '../../types';
+
+export interface UseFooterStyleProps {
+  classProps: string;
+}
+
+export function useFooterStyleProps(props: Partial<SpiritFooterProps>): UseFooterStyleProps {
+  const { backgroundColor, paddingBottom, paddingTop } = props;
+
+  const footerBackgroundColor = backgroundColor ? `bg-${backgroundColor}` : '';
+  const footerPaddingBottom = paddingBottom ? paddingBottom.replace('space-', 'pb-') : '';
+  const footerPaddingTop = paddingTop ? paddingTop.replace('space-', 'pt-') : '';
+
+  const classProps = classNames({
+    [footerBackgroundColor]: backgroundColor,
+    [footerPaddingBottom]: paddingBottom,
+    [footerPaddingTop]: paddingTop,
+  });
+
+  return {
+    classProps,
+  };
+}
diff --git a/packages/web-react/src/types/footer.ts b/packages/web-react/src/types/footer.ts
index 6f98f0179d..591618dced 100644
--- a/packages/web-react/src/types/footer.ts
+++ b/packages/web-react/src/types/footer.ts
@@ -1,3 +1,9 @@
-import { ChildrenProps, StyleProps, TransferProps } from './shared';
+import { BackgroundColorsDictionaryType, ChildrenProps, SpaceToken, StyleProps, TransferProps } from './shared';
 
-export interface SpiritFooterProps extends ChildrenProps, StyleProps, TransferProps {}
+export interface FooterStyleProps {
+  paddingTop?: SpaceToken;
+  paddingBottom?: SpaceToken;
+  backgroundColor?: BackgroundColorsDictionaryType;
+}
+
+export interface SpiritFooterProps extends FooterStyleProps, ChildrenProps, StyleProps, TransferProps {}
diff --git a/tests/e2e/demo-components-compare.spec.ts-snapshots/footer-chromium-linux.png b/tests/e2e/demo-components-compare.spec.ts-snapshots/footer-chromium-linux.png
index 17bea9228d8860f6078674d4b7c3e2349d8ee6f4..8f466c1ebfebdb68b9d45b5ef4145bb60cd7fbe1 100644
GIT binary patch
delta 17246
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
N)D!u~`Hu`<{}(Hx9ku`f

delta 5973
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