feat(components): add a generic Flip component

The flipping animation is used at several places so it makes sense to
use a single component to handle the animation. It will avoid styles
duplication.

1 files changed, 50 insertions, 0 deletions

diff --git a/src/components/atoms/flip/flip.tsx b/src/components/atoms/flip/flip.tsx
new file mode 100644
index 0000000..df77e9a
--- /dev/null
+++ b/src/components/atoms/flip/flip.tsx
@@ -0,0 +1,50 @@
+import {
+  type ForwardRefRenderFunction,
+  type HTMLAttributes,
+  type ReactNode,
+  forwardRef,
+} from 'react';
+import styles from './flip.module.scss';
+
+export type FlipProps = Omit<HTMLAttributes<HTMLDivElement>, 'children'> & {
+  /**
+   * The front and back sides.
+   */
+  children: ReactNode;
+  /**
+   * The animation direction.
+   *
+   * @default 'horizontal'
+   */
+  direction?: 'horizontal' | 'vertical';
+  /**
+   * Should we show back side?
+   *
+   * It let you control dynamically which side to show. When set to `true` the
+   * hover/focus animation will be removed.
+   *
+   * @default undefined
+   */
+  showBack?: boolean;
+};
+
+const FlipWithRef: ForwardRefRenderFunction<HTMLDivElement, FlipProps> = (
+  { children, className = '', direction = 'horizontal', showBack, ...props },
+  ref
+) => {
+  const wrapperClass = [
+    styles.wrapper,
+    styles[`wrapper--${direction}`],
+    styles[showBack === undefined ? 'wrapper--dynamic' : 'wrapper--manual'],
+    styles[showBack ? 'wrapper--is-back' : 'wrapper--is-front'],
+    className,
+  ].join(' ');
+
+  return (
+    <div {...props} className={wrapperClass} ref={ref}>
+      {children}
+    </div>
+  );
+};
+
+export const Flip = forwardRef(FlipWithRef);