@codecademy/brand 5.8.1 → 5.9.0-alpha.10aaf123e.0

package/dist/AccordionButtonDeprecated/ButtonDeprecated/index.js

@@ -0,0 +1,65 @@
+/* eslint-disable react/destructuring-assignment */
+import cx from 'classnames';
+import hasIn from 'lodash/hasIn';
+import * as React from 'react';
+import { omitProps } from '../../utils';
+import { ButtonDeprecatedBase } from '../ButtonDeprecatedBase';
+// eslint-disable-next-line gamut/no-css-standalone
+import styles from './styles/index.module.scss';
+
+// themes can be an alias to a color
+// or a unique button type
+import { jsx as _jsx } from "react/jsx-runtime";
+export const buttonPresetThemes = {
+  secondary: 'mint',
+  platform: 'greyblue',
+  lantern: 'darkmint',
+  royalblue: 'brand-purple'
+};
+const themes = ['hyper', 'navy', 'red', 'white', 'brand-red', 'brand-yellow', 'brand-purple', 'brand-dark-blue', 'brand-blue', 'mint', 'darkmint', 'grey', 'greyblue'];
+const propKeys = ['theme', 'size', 'outline', 'underline', 'link', 'caps', 'go', 'children', 'block', 'className', 'round', 'square', 'flat', 'fitText', 'onClick'];
+const isPreset = theme => {
+  return hasIn(buttonPresetThemes, theme);
+};
+
+/**
+ * @deprecated
+ * This component is deprecated and is no longer supported.
+ *
+ * See [FillButon](https://gamut.codecademy.com/storybook/?path=/docs/atoms-button--fill-button#fill-button)
+ *
+ * @example
+ * import { FillButton } fom '@codecademy/gamut';
+ *
+ * <FillButton variant="primary" />
+ */
+
+export const ButtonDeprecated = props => {
+  let {
+    theme = 'brand-red'
+  } = props;
+  if (isPreset(theme)) {
+    theme = buttonPresetThemes[theme];
+  }
+  const typeClassName = props.link ? styles.link : styles.btn;
+  const themeClassName = props.link ? styles[`link-${theme}`] : styles[`btn-${theme}`];
+  const classes = cx(typeClassName, themeClassName, styles[props.size], {
+    [styles.block]: props.block,
+    [styles.go]: props.go,
+    [styles.outline]: props.outline,
+    [styles.underline]: props.underline,
+    [styles.caps]: props.caps,
+    [styles.round]: props.round,
+    [styles.square]: props.square,
+    [styles.flat]: props.flat,
+    [styles['fit-text']]: props.fitText
+  }, props.className);
+  const propsToTransfer = omitProps(propKeys, props);
+  return /*#__PURE__*/_jsx(ButtonDeprecatedBase, {
+    ...propsToTransfer,
+    className: classes,
+    link: props.link,
+    onClick: props.onClick,
+    children: props.children
+  });
+};

package/dist/AccordionButtonDeprecated/ButtonDeprecated/styles/index.module.scss

@@ -0,0 +1,104 @@
+@use "sass:color";
+@use "variables";
+@use "mixins";
+//
+// Base styles
+//
+
+.btn {
+  align-items: center;
+  display: inline-flex;
+  justify-content: center;
+  font-weight: variables.$btn-font-weight;
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+  border: 1px solid transparent;
+  border-radius: variables.$btn-border-radius;
+  user-select: none;
+  @include mixins.button-size(
+    variables.$btn-padding-y,
+    variables.$btn-padding-x,
+    variables.$btn-font-size-base,
+    variables.$btn-line-height,
+    variables.$btn-min-width-sm
+  );
+  transition: all 0.1s ease-in-out;
+}
+
+// Future-proof disabling of clicks on `<a>` elements
+a.btn.disabled,
+fieldset[disabled] a.btn {
+  pointer-events: none;
+}
+
+@each $name, $color in variables.$btn-swatches {
+  @if $name == "brand-yellow" {
+    @include mixins.button-variants($name, variables.$color-black, $color);
+  } @else if color.channel(color.to-space($color, hsl), "lightness") > 68 {
+    @include mixins.button-variants($name, variables.$color-black, $color);
+  } @else {
+    @include mixins.button-variants($name, variables.$color-white, $color);
+  }
+}
+
+.round {
+  border-radius: variables.$btn-round-border-radius;
+}
+
+.square {
+  border-radius: 0;
+}
+//
+// Button Sizes
+//
+
+.large {
+  // line-height: ensure even-numbered height of button next to large input
+  @include mixins.button-size(
+    variables.$btn-padding-y-lg,
+    variables.$btn-padding-x-lg,
+    variables.$btn-font-size-lg,
+    variables.$btn-line-height-lg,
+    variables.$btn-min-width-lg
+  );
+}
+
+.small {
+  // line-height: ensure proper height of button next to small input
+  @include mixins.button-size(
+    variables.$btn-padding-y-sm,
+    variables.$btn-padding-x-sm,
+    variables.$btn-font-size-sm,
+    variables.$btn-line-height-sm,
+    variables.$btn-min-width-sm
+  );
+}
+
+//
+// Block buttovariables.n
+//
+
+.block {
+  display: flex;
+  width: 100%;
+}
+
+.caps {
+  text-transform: uppercase;
+}
+
+.underline {
+  &:hover,
+  &:focus {
+    text-decoration: underline;
+  }
+}
+
+// Specificity overrides
+input[type="submit"],
+input[type="reset"],
+input[type="button"] {
+  &.block {
+    width: 100%;
+  }
+}

package/dist/AccordionButtonDeprecated/ButtonDeprecated/styles/mixins.scss

@@ -0,0 +1,109 @@
+@use "sass:color";
+@use "variables";
+
+// Button variants
+//
+// Easily pump out default styles, as well as :hover, :focus, :active,
+// and disabled options for all buttons
+
+@mixin button-variant($color, $background, $border: transparent) {
+  $active-background: color.mix(variables.$color-black, $background);
+
+  @if $border == transparent {
+    $active-border: transparent;
+    $active-border-hover: transparent;
+  }
+
+  color: $color;
+  background-color: $background;
+  border-color: $border;
+
+  &:hover {
+    box-shadow: 0 2px 4px variables.$btn-box-shadow-color;
+  }
+
+  &:focus-visible {
+    box-shadow: 0 0 0 2px variables.$color-white, 0 0 0 4px $background;
+  }
+
+  &:focus-visible,
+  &:hover {
+    text-decoration: none;
+    color: $color;
+
+    &:active {
+      box-shadow: 0 2px 4px variables.$btn-box-shadow-color;
+    }
+  }
+
+  &:active {
+    background-color: $active-background;
+  }
+
+  &:disabled {
+    background-color: variables.$btn-disabled-color;
+
+    &:hover {
+      box-shadow: none;
+    }
+  }
+}
+
+@mixin button-flat-variant($color) {
+  color: $color;
+  background-color: transparent;
+
+  &:hover,
+  &:active {
+    box-shadow: none;
+  }
+
+  &:focus-visible {
+    box-shadow: 0 0 0 2px variables.$color-white, 0 0 0 4px $color;
+  }
+
+  &:disabled {
+    color: variables.$btn-disabled-color;
+    background-color: transparent;
+  }
+}
+
+// Button sizes
+@mixin button-size(
+  $padding-y,
+  $padding-x,
+  $font-size,
+  $line-height,
+  $min-width
+) {
+  padding: $padding-y $padding-x;
+  font-size: $font-size;
+  line-height: $line-height;
+  min-width: $min-width;
+
+  &.fit-text {
+    min-width: 0;
+    min-height: 0;
+  }
+}
+
+@mixin button-variants($name, $color, $background, $border: transparent) {
+  .btn-#{$name} {
+    @include button-variant($color, $background, $border);
+    &.flat {
+      @include button-flat-variant($background);
+    }
+    @content;
+  }
+  .link-#{$name} {
+    font-weight: bold;
+    -webkit-font-smoothing: antialiased;
+    -moz-osx-font-smoothing: grayscale;
+    color: $background;
+    text-decoration: underline;
+
+    &:disabled {
+      color: variables.$btn-disabled-color;
+    }
+  }
+}

package/dist/AccordionButtonDeprecated/ButtonDeprecated/styles/variables.scss

@@ -0,0 +1,54 @@
+$btn-padding-x: 1rem !default;
+$btn-padding-y: 0.375rem !default;
+$btn-font-weight: bold !default;
+
+$btn-line-height: 1.5 !default;
+$btn-line-height-lg: calc(4 / 3) !default;
+$btn-line-height-sm: 1.5 !default;
+
+$btn-font-size-base: 1rem !default;
+$btn-font-size-lg: 1.25rem !default;
+$btn-font-size-sm: 1rem !default;
+$btn-font-size-xs: 0.75rem !default;
+
+$btn-padding-x-sm: 0.75rem !default;
+$btn-padding-y-sm: 0.25rem !default;
+$btn-min-width-sm: 8rem !default;
+
+$btn-padding-x-lg: 1.25rem !default;
+$btn-padding-y-lg: 0.75rem !default;
+$btn-min-width-lg: 10rem !default;
+
+$btn-border-radius: 2px !default;
+$btn-round-border-radius: 50px !default;
+
+$btn-state-modifier: 20% !default;
+$btn-color-modifier: 10% !default;
+$btn-outline-hover-state-modifier: 0.9 !default;
+$btn-outline-active-state-modifier: 0.6 !default;
+$btn-box-shadow-focus-modifier: 0.5 !default;
+
+$btn-disabled-color: #646466;
+$btn-box-shadow-color: rgba(0, 0, 0, 0.3);
+
+$btn-swatches: (
+  // Gamut Next
+  "hyper": #3a10e5,
+  "red": #e91c11,
+  "navy": #10162f,
+  "white": #ffffff,
+  "grey": #c4c3c7,
+  // Gamut Classic
+  "brand-blue": #3069f0,
+  "brand-red": #fd4d3f,
+  "brand-yellow": #ffd500,
+  "brand-purple": #6400e4,
+  "brand-dark-blue": #141c3a,
+  // Editor
+  "mint": #34b3a0,
+  "darkmint": #1a7b72,
+  "greyblue": #354551
+);
+
+$color-black: #000000;
+$color-white: #ffffff;

package/dist/AccordionButtonDeprecated/ButtonDeprecatedBase/index.d.ts

@@ -0,0 +1,43 @@
+import { HTMLProps, ReactNode } from 'react';
+import * as React from 'react';
+import { ChildComponentDescriptor } from '../../typings/react';
+export type ButtonDeprecatedBaseProps = Omit<HTMLProps<HTMLAnchorElement> & HTMLProps<HTMLButtonElement>, 'as' | 'size'> & {
+    /**
+     * Component type to wrap children with.
+     */
+    as?: ChildComponentDescriptor;
+    /**
+     * @remarks We would love to properly type this with generics, but cannot yet.
+     * @see https://github.com/Codecademy/gamut/pull/270#discussion_r270917147
+     * @see https://github.com/Microsoft/TypeScript/issues/21048
+     */
+    asProps?: any;
+    children?: ReactNode;
+    className?: string;
+    href?: string;
+    target?: string;
+    rel?: string;
+    /**
+     * Variant that displays the button as an inline link element, but maintains its semantic meaning as a button.
+     */
+    link?: boolean;
+    /**
+     * @remarks
+     * Technically, this is only ever a button event *or* a link event.
+     * We '&' them together for ease of usage.
+     */
+    onClick?: (event: React.MouseEvent<HTMLAnchorElement> & React.MouseEvent<HTMLButtonElement>) => void;
+};
+/**
+ * @deprecated
+ * This component is deprecated and is no longer supported.
+ *
+ * See [Anchor](https://gamut.codecademy.com/storybook/?path=/docs/typography-anchor--anchor) for similiar functionality
+ *
+ * @example
+ * import { Anchor } from '@codecademy/gamut';
+ *
+ * <Anchor variant="interface">Button</Anchor>
+ *
+ */
+export declare const ButtonDeprecatedBase: React.FC<ButtonDeprecatedBaseProps>;

package/dist/AccordionButtonDeprecated/ButtonDeprecatedBase/index.js

@@ -0,0 +1,71 @@
+import cx from 'classnames';
+import * as React from 'react';
+import { omitProps } from '../../utils';
+// eslint-disable-next-line gamut/no-css-standalone
+import styles from './styles.module.scss';
+import { jsx as _jsx } from "react/jsx-runtime";
+const propKeys = ['children', 'className', 'href', 'link', 'onClick', 'target', 'rel'];
+/**
+ * @deprecated
+ * This component is deprecated and is no longer supported.
+ *
+ * See [Anchor](https://gamut.codecademy.com/storybook/?path=/docs/typography-anchor--anchor) for similiar functionality
+ *
+ * @example
+ * import { Anchor } from '@codecademy/gamut';
+ *
+ * <Anchor variant="interface">Button</Anchor>
+ *
+ */
+
+export const ButtonDeprecatedBase = props => {
+  const {
+    href,
+    className,
+    link,
+    onClick,
+    target,
+    rel
+  } = props;
+  const {
+    as: As,
+    asProps = {},
+    ...restOfProps
+  } = props;
+  const propsToTransfer = omitProps(propKeys, restOfProps);
+  const classes = cx(styles.basicBtn, className, {
+    [styles.basicLink]: link
+  });
+  const defaultProps = {
+    ...propsToTransfer,
+    className: classes,
+    onClick,
+    'data-btn': true
+  };
+  if (As) {
+    return /*#__PURE__*/_jsx(As, {
+      ...defaultProps,
+      ...asProps
+    });
+  }
+  if (href) {
+    // Check if this is a popup and and appropriate rel props if they don't exist (see https://web.dev/external-anchors-use-rel-noopener/)
+    const anchorProps = {
+      target,
+      rel: target === '_blank' && !rel ? 'noopener noreferrer' : rel
+    };
+
+    // Anchor tag receives children content from propsToTransfer
+    // eslint-disable-next-line jsx-a11y/anchor-has-content
+    return /*#__PURE__*/_jsx("a", {
+      ...defaultProps,
+      ...anchorProps,
+      href: href
+    });
+  }
+
+  // eslint-disable-next-line react/button-has-type
+  return /*#__PURE__*/_jsx("button", {
+    ...defaultProps
+  });
+};

package/dist/AccordionButtonDeprecated/ButtonDeprecatedBase/styles.module.scss

@@ -0,0 +1,74 @@
+.basicBtn {
+  display: inline-block;
+  text-align: center;
+  text-decoration: none;
+  white-space: nowrap;
+  vertical-align: middle;
+  cursor: pointer;
+  font-family: inherit;
+  font: inherit;
+  padding: 0;
+  margin: 0;
+  border: none;
+  background: none;
+  color: inherit;
+  line-height: normal;
+
+  &,
+  &:active {
+    &:focus {
+      outline: none;
+    }
+  }
+
+  &:hover:focus {
+    text-decoration: none;
+  }
+  &:focus {
+    text-decoration: none;
+  }
+
+  &:active {
+    background-image: none;
+    outline: 0;
+  }
+
+  &:disabled {
+    cursor: not-allowed;
+    opacity: 0.65;
+  }
+}
+
+.basicLink {
+  text-decoration: none;
+  vertical-align: baseline;
+  cursor: pointer;
+
+  &,
+  &:active,
+  &:disabled {
+    background-color: transparent;
+  }
+  &,
+  &:focus,
+  &:active {
+    border-color: transparent;
+  }
+  &:hover,
+  &:focus {
+    opacity: 0.7;
+    text-decoration: none;
+    border-color: transparent;
+    background-color: transparent;
+  }
+  &:hover:focus {
+    opacity: 0.7;
+    background-color: transparent;
+  }
+  &:disabled {
+    &:hover:focus {
+      opacity: 0.7;
+      text-decoration: none;
+    }
+  }
+}

package/dist/AccordionButtonDeprecated/index.d.ts

@@ -0,0 +1,25 @@
+import * as React from 'react';
+import { ButtonDeprecatedBaseProps } from './ButtonDeprecatedBase';
+export type AccordionButtonSize = 'normal' | 'large';
+export type AccordionButtonTheme = 'blue' | 'plain' | 'yellow';
+export type AccordionButtonDeprecatedProps = ButtonDeprecatedBaseProps & {
+    /**
+     * Whether the button should display as open or closed.
+     */
+    expanded?: boolean;
+    /**
+     * Determines the size of the button.
+     */
+    size?: 'normal' | 'large';
+    /**
+     * Visual theme for the clickable header button.
+     */
+    theme?: 'blue' | 'plain' | 'yellow';
+};
+/**
+ * @deprecated
+ * This component is in the old visual identity and will be updated soon.
+ *
+ * Check the [Gamut Board](https://www.notion.so/codecademy/Gamut-Status-Timeline-dd3c135d3848464ea6eb1b48e68fbb1d) for component status
+ */
+export declare const AccordionButtonDeprecated: React.FC<AccordionButtonDeprecatedProps>;

package/dist/AccordionButtonDeprecated/index.js

@@ -0,0 +1,65 @@
+import { ArrowChevronDownIcon } from '@codecademy/gamut-icons';
+import cx from 'classnames';
+import * as React from 'react';
+import { ButtonDeprecated } from './ButtonDeprecated';
+import { ButtonDeprecatedBase } from './ButtonDeprecatedBase';
+// eslint-disable-next-line gamut/no-css-standalone
+import styles from './styles.module.scss';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+const buttonThemes = {
+  blue: {
+    component: ButtonDeprecated,
+    props: {
+      flat: true,
+      theme: 'white'
+    }
+  },
+  plain: {
+    component: ButtonDeprecated,
+    props: {
+      flat: true,
+      theme: 'brand-dark-blue'
+    }
+  },
+  yellow: {
+    component: ButtonDeprecatedBase,
+    props: {}
+  }
+};
+
+/**
+ * @deprecated
+ * This component is in the old visual identity and will be updated soon.
+ *
+ * Check the [Gamut Board](https://www.notion.so/codecademy/Gamut-Status-Timeline-dd3c135d3848464ea6eb1b48e68fbb1d) for component status
+ */
+
+export const AccordionButtonDeprecated = ({
+  children,
+  className,
+  expanded,
+  size = 'normal',
+  theme = 'plain',
+  ...baseProps
+}) => {
+  const {
+    component: ButtonComponent,
+    props
+  } = buttonThemes[theme];
+  const iconSize = size === 'large' ? 30 : undefined;
+  return /*#__PURE__*/_jsxs(ButtonComponent, {
+    "aria-expanded": expanded,
+    className: cx(styles.accordionButton, styles[theme], styles[size], className),
+    ...baseProps,
+    ...props,
+    children: [/*#__PURE__*/_jsx("span", {
+      className: styles.children,
+      children: children
+    }), /*#__PURE__*/_jsx(ArrowChevronDownIcon, {
+      "aria-hidden": true,
+      className: cx(styles.expansionIcon, expanded && styles.expansionIconExpanded),
+      height: iconSize,
+      width: iconSize
+    })]
+  });
+};

package/dist/AccordionButtonDeprecated/styles.module.scss

@@ -0,0 +1,62 @@
+// button + class beats ButtonDeprecated .btn / .basicBtn center alignment
+// when CSS module order varies across consuming apps.
+button.accordionButton {
+  align-items: center;
+  display: flex;
+  font-weight: bold;
+  justify-content: space-between;
+  padding: 0.375rem 1rem;
+  text-align: left;
+  width: 100%;
+
+  .children {
+    font-weight: bold;
+    text-align: left;
+  }
+
+  &.blue {
+    color: #a5befa;
+  }
+
+  &.yellow {
+    background-color: #fff2b3;
+    border: solid #ffe359;
+    border-width: 1px 0;
+    transition: background-color 0.15s ease-in-out;
+
+    &:focus-visible {
+      border-color: #b37620;
+    }
+
+    &:focus,
+    &:hover {
+      background-color: #ffec8c;
+    }
+  }
+
+  &.large {
+    border-radius: 2px;
+    font-size: 1.5rem;
+
+    .children {
+      padding-top: 0.2rem;
+    }
+
+    .expansionIcon {
+      margin-left: 1rem;
+    }
+
+    @media only screen and (min-width: 64rem) {
+      font-size: 1.75rem;
+    }
+  }
+}
+
+.expansionIcon {
+  margin-left: 0.75rem;
+  transition: transform 0.35s ease-out;
+}
+
+.expansionIconExpanded {
+  transform: rotate(-180deg);
+}