@mixin tbd($color: red) {
  position: relative;
  padding: 0 .3em;
  border: 1px dashed lighten($main-font-color, 70);

  &:after {
    position: absolute;
    left: 100%;
    content: "TBD";
    color: lighten($main-font-color, 70);
    font-size: .6em;
    line-height: 1;
    padding: .05em .4em;
  }
}

@mixin wide-container() {
  @media screen and (min-width: $bigscreen-breakpoint) {
    padding: 0;
    width: $bigscreen-breakpoint - $gutter * 2;
  }
  @media screen and (min-width: $widescreen-breakpoint) {
    width: $widescreen-breakpoint - $gutter * 2;
  }
}

@mixin padded-code-snippet() {
  padding: 0 1em;
  margin: 0 .2em;
  background: rgba($main-font-color, 0.03);
  border: 1px dashed lighten($main-font-color, 70);
  border-radius: .5em;
  font-size: 80%;
}

@mixin padded-code-snippet--reset() {
  padding: 0;
  margin: 0;
  background: transparent;
  border: 0;
  border-radius: 0;
  font-size: 100%;
}

@mixin code-snippet-container() {
  overflow-x: scroll;
  overflow-y: hidden;
  line-height: 1.2;

  @include padded-code-snippet();
  padding-top: .5em;
  padding-bottom: .75em;

  margin-top: 1em;
  margin-bottom: 1em;

  > code {
    // Avoid bad formatting in case of <code> element nested
    // inside a <pre>
    @include padded-code-snippet--reset();
  }
}

@mixin code-snippet() {
  color: lighten($main-font-color, 24);

  @include padded-code-snippet();
  margin-top: -1px;
  margin-bottom: -1px;

  code {
    // Avoid bad formatting in case of <code> elements nested
    // into each other (possible with adoc output)
    @include padded-code-snippet--reset();
  }
}

@mixin cta-button($bgcolor, $color) {
  font-weight: 800;
  font-size: 18px;
  padding: 12px 32px;
  display: inline-block;
  margin-right: 10px;
  transition: box-shadow .2s ease-out;

  .icon {
    margin-right: 10px;
    font-weight: 400;
    position: relative;
    top: 2px;
    font-size: 120%;
  }

  &, &:link, &:visited {
    color: $color;
    background-color: $bgcolor;
  }

  &:hover {
    box-shadow: 0 0 0 4px rgba(black, 0.2);
  }
}

@mixin cta-button-mini($bgcolor, $color) {
  @include cta-button($bgcolor, $color);
  font-size: 14px;
  padding: 6px 16px;
}

@mixin hoverable-card($base-y, $base-blur, $color) {
  $hovered-y: $base-y * 2;
  $hovered-blur: $base-blur * 2;

  box-shadow: 0px $base-y $base-blur $color;

  transition: box-shadow .17s ease, transform .17s ease;

  &:hover {
    transform: translateY(-1px);
    box-shadow: 0px $hovered-y $hovered-blur $color;
  }
}

@mixin reset-list() {
  list-style: none;
  margin: 0;
  padding: 0;
}

@mixin static-link-color($color) {
  &:link, &:hover, &:visited {
    color: $color;
  }
}

@mixin asciidoc-markup($highlight-color) {
  // Used for e.g. code listing headings and tip block labels
  .title {
    text-transform: uppercase;
    font-size: 12px;
    border-radius: .25em;
    background-color: $highlight-color;
    color: white;
    font-weight: bold;
    padding: .3em .6em;
  }

  // Used for tip block labels
  .admonitionblock {
    overflow-x: scroll;

    table:first-child {
      margin-top: 0;
    }
    table:last-child {
      margin-bottom: 0;
    }

    td.icon {
      vertical-align: top;
      padding-left: 0;
    }
    .content {
      font-size: 80%;

      > div:first-child {
        > :first-child {
          margin-top: 0;
        }
      }
      > div:last-child {
        > :last-child {
          margin-bottom: 0;
        }
        &.ulist {
          li:first-child > :first-child {
            margin-top: 0;
          }
          li:last-child > :last-child {
            margin-bottom: 0;
          }
        }
      }
    }
  }
}

@mixin docs-page($primary-dark-color) {
  > header.documentation-header,
  > section.documentation {
    align-self: stretch;
    width: auto;
  }

  > header.documentation-header {
    display: flex;
    flex-flow: row nowrap;
    align-items: center;
    padding: 0 0 0 2em;
    position: fixed;
    left: 0;
    right: 0;
    z-index: 4;

    transition: background .1s linear, border-bottom .1s linear, transform .1s linear;

    .section-title {
      flex: 1;
      flex-grow: 0;

      flex-grow: 1;
      transition: transform .2s ease-out;
      opacity: 1;
      overflow: hidden;

      text-overflow: ellipsis;
      font-weight: bold;
    }

    .nav-header {
      padding: 10px 2em 10px 2em;
      display: flex;
      flex-flow: row nowrap;
      align-items: center;
      transition: background .6s $easeOutCirc;

      .title {
        white-space: nowrap;
        line-height: 1;
        font-weight: normal;
        font-size: 15px;
        text-transform: uppercase;
        letter-spacing: 0.08em;

        a {
          @include static-link-color(#444);
        }

        .nav-toggle-icon {
          cursor: pointer;
        }
      }

      .logo-container {
        $logoSize: 32px;

        margin-right: 10px;
        height: $logoSize;
        width: $logoSize;

        .logo > :only-child {
          width: $logoSize;
          height: $logoSize;
        }
      }

      .nav-toggle-icon {
        margin-left: 1em;

        > .close { display: none; }
        > .open { display: block; }
      }
    }

    &.nav-expanded {
      .nav-header {
        background-color: #f7f7f7;
      }
      .nav-header .nav-toggle-icon {
        > .open { display: none; }
        > .close { display: block; }
      }
    }

    .item-type {
      display: none;
      margin-right: 10px;
    }

    &.headroom--not-top {
      background: rgba(white, 0.9);
      box-shadow: rbga(white, 0.9) 0 20px 30px;
    }

    &.headroom--top {
      .section-title {
        transform: translateY(-5em);
        transition: none; // To avoid flashing on initial page open
      }
    }

    &.unpinned {
      .item-type, .subsection {
        display: inline-block;
      }
    }
  }

  > section.documentation {
    $external-links-side-margin: 16px;  // for external links

    flex: 1;
    display: flex;
    flex-flow: column nowrap;

    overflow-x: auto; // on narrow screens, code snippets & tables may overflow width

    .docs-nav {
      $navFlexShare: 20%;

      background: transparent;
      flex-basis: 20%;

      transition: flex-basis .6s $easeOutCirc;

      > section {
        margin-bottom: 15px;
      }

      // New style: Nav with nested items
      > ul.nav-items {
        $sidePadding: 2em;

        @include reset-list;

        position: fixed;
        overflow-y: auto;
        bottom: 0;
        right: 0;

        padding: 0 $sidePadding;

        z-index: 5;
        background: #f7f7f7;
        box-shadow: rgba(black, 0.7) -30px 0px 60px -60px;

        transition:
          // Collapsing of header when scrolling (w/headroom):
          top .1s linear,
          // Toggling sidebar open/closed
          transform .6s $easeOutCirc,
          opacity .6s $easeOutCirc,
          box-shadow .6s $easeOutCirc;

        @media screen and (min-width: $bigscreen-breakpoint) {
          max-width: calc(#{$navFlexShare} - #{$sidePadding});
        }

        li.item {
          font-size: 15px;
          font-weight: normal;

          &.selected {
            span {
              font-weight: bold;
              color: $primary-dark-color;
            }
          }
          a { @include static-link-color(#444); }
        }

        > li.item {
          > .item-title {
            font-size: 20px;
            font-weight: bold;
            margin: 0;
            line-height: 1.8;
          }
          > ul {
            @include reset-list;
            line-height: 2;
          }
        }
      }
    }

    > article {
      @extend .main-article;

      margin: 0 auto;
      flex: 1;

      background: white;
      z-index: 1;

      > header, > footer {
        nav {
          line-height: 1;

          button, a {
            border: 0;
            padding: 0;
            margin-right: 1em;

            font-family: inherit;
            font-size: 80%;
            font-weight: bold;

            background: white;
            color: $primary-dark-color;
            cursor: pointer;

            text-decoration: none;

            &:last-child {
              margin-right: 0;
            }

            .ico-ext {
              margin-left: .5em;
            }
          }
        }
      }

      > header {
        > nav {
          margin-top: -2em;
          margin-bottom: 4em;
        }
        > .title {
          @media screen and (min-width: $bigscreen-breakpoint) {
            display: flex;
            flex-flow: row nowrap;
          }

          border-bottom: 2px solid $primary-dark-color;
          padding-top: 70px;
          padding-bottom: 20px;

          > .logo-container {
            margin-right: 22px;

            > :only-child {
              width: 58px;
              height: 58px;
            }
          }

          .text {
            flex: 1;
            font-size: 36px;

            margin: 0;
            font-weight: 500;
          }
        }
        .lead {
          font-weight: normal;
          font-size: 20px;
        }
      }

      > .body {
        @include asciidoc-markup($primary-dark-color);
      }

      > footer > nav {
        margin-top: 2em;
        @media screen and (min-width: $bigscreen-breakpoint) {
          margin-left: 2em;
        }
      }
    }

    .docs-nav,
    &.docs-landing > article > header {
      .external-links {
        margin-left: -$external-links-side-margin;

        ul.nav-items {
          @include reset-list();
        }

        > .nav-items > .item {
          margin-bottom: 10px;
          margin-right: 16px;

          > a {
            @include static-link-color(#444);
            background-color: #F7F7F7;

            display: block;
            font-weight: bold;
            padding: 4px 0 4px 0;
            border-radius: 10px;

            display: flex;
            flex-flow: row wrap;

            .lbl {
              white-space: nowrap;
              text-overflow: ellipsis;
              overflow: hidden;
            }
            .lbl:first-child {
              // First child means no icon present
              margin-left: 16px;
            }
            .ico {
              flex-shrink: 0;
              text-align: right;
              width: 32px;
              padding-right: 10px;
            }
            .ico-ext {
              flex-shrink: 0;
              text-align: right;
              width: 32px;
              padding-left: 10px;
              padding-right: 10px;
            }
          }
        }
      }
    }

    .docs-nav {
      .external-links {
        margin-top: 1em;
        margin-bottom: .5em;

        > .nav-items > .item {
          margin-bottom: 0;
          margin-right: -$external-links-side-margin;
        }
      }
    }

    &.docs-landing > article {
      > header {
        .external-links > .nav-items > .item  > a {
          @include static-link-color(#fff);
          background-color: $primary-dark-color;
        }

        > .title {
          border-bottom-width: 0;
          padding-bottom: 0;
        }
      }

      ul.nav-items {
        @include reset-list;
        font-size: 15px;
      }

      > ul.nav-items > li {
        > .item-title {
          font-size: 20px;
          font-weight: bold;
          margin: 0;
          line-height: 1.8;
        }
        ul {
          line-height: 2;
        }
      }
    }

    @media screen and (min-width: $bigscreen-breakpoint) {
      flex-flow: row nowrap;
      flex-direction: row-reverse;

      > article {
        flex: 2;
      }

      > .docs-nav {
        padding: 70px 0 0 0;
      }

      &.docs-landing {
        flex-direction: column-reverse;

        > article {
          border-left-width: 0;

          .external-links {
            > .nav-items {
              display: flex;
              flex-flow: row wrap;
            }
          }

          > header,
          > .body {
            margin-left: 0;
          }

          @media screen and (min-width: $bigscreen-breakpoint) {
            > .body {
              padding-top: 70px;
            }
          }
        }
      }

      &.with-collapsed-toc {
        > article {
          > header, > .body {
            margin-right: 0;
          }
        }
      }
    }

    &.with-collapsed-toc {
      position: relative;

      > .docs-nav {
        flex-basis: 0;

        .nav-items {
          transform: translateX(100%);
          opacity: 0;
        }
      }
    }
  }
}