@carbon/elements 10.54.2 → 11.0.0-rc.0

package/scss/type/vendor/@carbon/grid/_mixins.scss

@@ -1,415 +0,0 @@
-//
-// Copyright IBM Corp. 2018, 2018
-//
-// This source code is licensed under the Apache-2.0 license found in the
-// LICENSE file in the root directory of this source tree.
-//
-//-------------------------------------------
-// Compatibility notes
-// ------------------------------------------
-//
-// This file is intended to be consumed and processed with node-sass/libsass.
-// Sass language features only available in dart-sass, such as `math.div`,
-// should not be used.
-//
-// The `.import` suffixed version of this file eg. `_filename.import.scss`
-// is intended to be compatible with dart-sass.
-//
-// Styles authored within this file must be duplicated to the corresponding
-// compatibility file to ensure we continue to support node-sass and dart-sass
-// in v10.
-
-// Helpers for defining columns, rows, and containers are heavily inspired by,
-// and often derived from, bootstrap:
-// https://github.com/twbs/bootstrap/blob/v4-dev/scss/mixins/_grid.scss
-
-@import '../../../../layout/breakpoint';
-@import 'prefix';
-
-// -----------------------------------------------------------------------------
-// Columns
-// -----------------------------------------------------------------------------
-
-/// Used to initialize the default properties for a column class, most notably
-/// for setting width and default gutters when a column's breakpoint has not been
-/// hit yet.
-/// @param {Number} $gutter [$carbon--grid-gutter] - The gutter for the grid system
-/// @param {Number} $collapsed-gutter [$carbon--grid-gutter--condensed] - The condensed mode gutter
-/// @access private
-/// @group @carbon/grid
-@mixin carbon--make-col-ready(
-  $gutter: $carbon--grid-gutter,
-  $condensed-gutter: $carbon--grid-gutter--condensed
-) {
-  // Prevent columns from becoming too narrow when at smaller grid tiers by
-  // always setting `width: 100%;`. This works because we use `flex` values
-  // later on to override this initial width.
-  width: 100%;
-  padding-right: ($gutter / 2);
-  padding-left: ($gutter / 2);
-
-  // For our condensed use-case, our gutters collapse to 2px solid, 1px on each
-  // side.
-  .#{$prefix}--row--condensed &,
-  .#{$prefix}--grid--condensed & {
-    padding-right: ($condensed-gutter / 2);
-    padding-left: ($condensed-gutter / 2);
-  }
-
-  // For our narrow use-case, our container hangs 16px into the gutter
-  .#{$prefix}--row--narrow &,
-  .#{$prefix}--grid--narrow & {
-    padding-right: ($gutter / 2);
-    padding-left: 0;
-  }
-}
-
-/// Define the width of the column for a given span and column count.
-/// A width of 0 will hide the column entirely.
-/// @param {Number} $span - The number of columns covered
-/// @param {Number} $columns - The total number of columns available
-/// @access private
-/// @group @carbon/grid
-@mixin carbon--make-col($span, $columns) {
-  @if $span == 0 {
-    display: none;
-  } @else {
-    // Explicitly include `display: block` to override
-    display: block;
-    // Add a `max-width` to ensure content within each column does not blow out
-    // the width of the column. Applies to IE10+ and Firefox. Chrome and Safari
-    // do not appear to require this.
-    max-width: percentage($span / $columns);
-    flex: 0 0 percentage($span / $columns);
-  }
-}
-
-/// Create a column offset for a given span and column count.
-/// @param {Number} $span - The number of columns the offset should cover
-/// @param {Number} $columns - The total number of columns available
-/// @access private
-/// @group @carbon/grid
-@mixin carbon--make-col-offset($span, $columns) {
-  $offset: $span / $columns;
-  @if $offset == 0 {
-    margin-left: 0;
-  } @else {
-    margin-left: percentage($offset);
-  }
-}
-
-/// Output the CSS required for all the columns in a given grid system.
-/// @param {Map} $breakpoints [$carbon--grid-breakpoints] - The breakpoints in the grid system
-/// @param {Number} $gutter [$carbon--grid-gutter] - The gutter for the grid system
-/// @access private
-/// @group @carbon/grid
-@mixin carbon--make-grid-columns(
-  $breakpoints: $carbon--grid-breakpoints,
-  $gutter: $carbon--grid-gutter
-) {
-  .#{$prefix}--col {
-    @include carbon--make-col-ready($gutter);
-  }
-
-  @each $breakpoint in map-keys($breakpoints) {
-    $infix: carbon--breakpoint-infix($breakpoint);
-    $columns: map-get(map-get($breakpoints, $breakpoint), columns);
-
-    // Allow columns to stretch full width below their breakpoints
-    @for $i from 0 through $columns {
-      .#{$prefix}--col#{$infix}-#{$i} {
-        @include carbon--make-col-ready($gutter);
-      }
-    }
-
-    .#{$prefix}--col#{$infix},
-    .#{$prefix}--col#{$infix}--auto {
-      @include carbon--make-col-ready($gutter);
-    }
-
-    @include carbon--breakpoint($breakpoint, $breakpoints) {
-      // Provide basic `.col-{bp}` classes for equal-width flexbox columns
-      .#{$prefix}--col,
-      .#{$prefix}--col#{$infix} {
-        max-width: 100%;
-        flex-basis: 0;
-        flex-grow: 1;
-      }
-
-      .#{$prefix}--col--auto,
-      .#{$prefix}--col#{$infix}--auto {
-        width: auto;
-        // Reset earlier grid tiers
-        max-width: 100%;
-        flex: 1 0 0%;
-      }
-
-      @for $i from 0 through $columns {
-        .#{$prefix}--col#{$infix}-#{$i} {
-          @include carbon--make-col($i, $columns);
-        }
-      }
-
-      @for $i from 0 through ($columns - 1) {
-        @if not($infix == '') {
-          .#{$prefix}--offset#{$infix}-#{$i} {
-            @include carbon--make-col-offset($i, $columns);
-          }
-        }
-      }
-    }
-  }
-}
-
-// -----------------------------------------------------------------------------
-// Rows
-// -----------------------------------------------------------------------------
-
-/// Define the properties for a selector assigned to a row in the grid system.
-/// @param {Number} $gutter [$carbon--grid-gutter] - The gutter in the grid system
-/// @access private
-/// @group @carbon/grid
-@mixin carbon--make-row($gutter: $carbon--grid-gutter) {
-  display: flex;
-  flex-wrap: wrap;
-  margin-right: -1 * $gutter / 2;
-  margin-left: -1 * $gutter / 2;
-}
-
-// -----------------------------------------------------------------------------
-// No gutter
-// -----------------------------------------------------------------------------
-
-/// Add `no-gutter` and `no-gutter--{start,end}` classes to the output CSS. These
-/// classes are useful for dropping the gutter in fluid situations.
-/// @access private
-/// @group @carbon/grid
-@mixin carbon--no-gutter {
-  .#{$prefix}--no-gutter,
-  .#{$prefix}--row.#{$prefix}--no-gutter [class*='#{$prefix}--col'] {
-    padding-right: 0;
-    padding-left: 0;
-  }
-
-  .#{$prefix}--no-gutter--start,
-  .#{$prefix}--row.#{$prefix}--no-gutter--start [class*='#{$prefix}--col'] {
-    padding-left: 0;
-  }
-
-  .#{$prefix}--no-gutter--end,
-  .#{$prefix}--row.#{$prefix}--no-gutter--end [class*='#{$prefix}--col'] {
-    padding-right: 0;
-  }
-
-  // Deprecated ☠️
-  .#{$prefix}--no-gutter--left,
-  .#{$prefix}--row.#{$prefix}--no-gutter--left [class*='#{$prefix}--col'] {
-    padding-left: 0;
-  }
-
-  .#{$prefix}--no-gutter--right,
-  .#{$prefix}--row.#{$prefix}--no-gutter--right [class*='#{$prefix}--col'] {
-    padding-right: 0;
-  }
-}
-
-// -----------------------------------------------------------------------------
-// Hang
-// -----------------------------------------------------------------------------
-
-/// Add `hang--start` and `hang--end` classes for a given gutter. These classes are
-/// used alongside `no-gutter--start` and `no-gutter--end` to "hang" type.
-/// @param {Number} $gutter [$carbon--grid-gutter] - The gutter in the grid system
-/// @access private
-/// @group @carbon/grid
-@mixin carbon--hang($gutter: $carbon--grid-gutter) {
-  .#{$prefix}--hang--start {
-    padding-left: ($gutter / 2);
-  }
-
-  .#{$prefix}--hang--end {
-    padding-right: ($gutter / 2);
-  }
-
-  // Deprecated ☠️
-  .#{$prefix}--hang--left {
-    padding-left: ($gutter / 2);
-  }
-
-  .#{$prefix}--hang--right {
-    padding-right: ($gutter / 2);
-  }
-}
-
-// -----------------------------------------------------------------------------
-// Aspect ratio
-// -----------------------------------------------------------------------------
-
-/// The aspect ratios that are used to generate corresponding aspect ratio
-/// classes in code
-/// @type List
-/// @access public
-/// @group @carbon/grid
-$carbon--aspect-ratios: (
-  (16, 9),
-  (9, 16),
-  (2, 1),
-  (1, 2),
-  (4, 3),
-  (3, 4),
-  (3, 2),
-  (2, 3),
-  (1, 1)
-);
-
-/// Generates the CSS classname utilities for the aspect ratios
-///
-/// CSS Tricks article on aspect ratios and all the different ways it can be done.
-/// https://css-tricks.com/aspect-ratio-boxes/#article-header-id-6
-///
-/// That article references an earlier article on the topic.
-/// https://keithjgrant.com/posts/2017/03/aspect-ratios/
-///
-/// @param {Number} $width width from an aspect ratio
-/// @param {Number} $height height from an aspect ratio
-/// @access private
-/// @group @carbon/grid
-@mixin carbon--aspect-ratio($aspect-ratios: $carbon--aspect-ratios) {
-  .#{$prefix}--aspect-ratio {
-    position: relative;
-  }
-
-  .#{$prefix}--aspect-ratio::before {
-    width: 1px;
-    height: 0;
-    margin-left: -1px;
-    content: '';
-    float: left;
-  }
-
-  .#{$prefix}--aspect-ratio::after {
-    display: table;
-    clear: both;
-    content: '';
-  }
-
-  @each $aspect-ratio in $aspect-ratios {
-    $width: nth($aspect-ratio, 1);
-    $height: nth($aspect-ratio, 2);
-
-    .#{$prefix}--aspect-ratio--#{$width}x#{$height}::before {
-      padding-top: percentage($height / $width);
-    }
-  }
-
-  // leaving here for legacy support
-  .#{$prefix}--aspect-ratio--object {
-    position: absolute;
-    top: 0;
-    left: 0;
-    width: 100%;
-    height: 100%;
-  }
-}
-
-// -----------------------------------------------------------------------------
-// Grid
-// -----------------------------------------------------------------------------
-
-/// Create the container for a grid. Will cause full-bleed for the grid unless
-/// max-width properties are added with `make-container-max-widths`
-/// @param {Map} $breakpoints [$carbon--grid-breakpoints] - A map of breakpoints where the key is the name
-/// @access private
-/// @group @carbon/grid
-@mixin carbon--make-container($breakpoints: $carbon--grid-breakpoints) {
-  margin-right: auto;
-  margin-left: auto;
-
-  @include carbon--set-largest-breakpoint();
-
-  @each $name, $value in $breakpoints {
-    $prev-breakpoint: map-get($breakpoints, carbon--breakpoint-prev($name));
-    $margin: map-get($value, margin);
-
-    @if $prev-breakpoint {
-      $prev-margin: map-get($prev-breakpoint, margin);
-      @if $prev-margin != $margin {
-        @include carbon--breakpoint($name) {
-          padding-right: #{($carbon--grid-gutter / 2) + $margin};
-          padding-left: #{($carbon--grid-gutter / 2) + $margin};
-        }
-      }
-    } @else {
-      @include carbon--breakpoint($name) {
-        padding-right: #{($carbon--grid-gutter / 2) + $margin};
-        padding-left: #{($carbon--grid-gutter / 2) + $margin};
-      }
-    }
-  }
-}
-
-/// Get the last breakpoint width and set max-width to its value
-/// @param {Map} $breakpoints [$carbon--grid-breakpoints] - A map of breakpoints where the key is the name
-/// @access private
-/// @group @carbon/grid
-@mixin carbon--set-largest-breakpoint($breakpoints: $carbon--grid-breakpoints) {
-  $largest-breakpoint: last-map-item($breakpoints);
-
-  max-width: map-get($largest-breakpoint, 'width');
-}
-
-/// Add in the max-widths for each breakpoint to the container
-/// @param {Map} $breakpoints [$carbon--grid-breakpoints] - A map of breakpoints where the key is the name
-/// @access private
-/// @group @carbon/grid
-@mixin carbon--make-container-max-widths(
-  $breakpoints: $carbon--grid-breakpoints
-) {
-  @each $name, $value in $breakpoints {
-    @include carbon--breakpoint($name) {
-      max-width: map-get($value, width);
-    }
-  }
-}
-
-/// Generate the CSS for a grid for the given breakpoints and gutters
-/// @param {Map} $breakpoints [$carbon--grid-breakpoints] - The default breakpoints
-/// @param {Number} $grid-gutter [$carbon--grid-gutter] - The default gutters
-/// @param {Number} $condensed-gutter [$carbon--grid-gutter--condensed] - The condensed mode gutter
-/// @access public
-/// @group @carbon/grid
-@mixin carbon--grid(
-  $breakpoints: $carbon--grid-breakpoints,
-  $grid-gutter: $carbon--grid-gutter,
-  $condensed-gutter: $carbon--grid-gutter--condensed
-) {
-  .#{$prefix}--grid {
-    @include carbon--make-container($breakpoints);
-  }
-
-  @include carbon--largest-breakpoint($breakpoints) {
-    .#{$prefix}--grid--full-width {
-      max-width: 100%;
-    }
-  }
-
-  .#{$prefix}--row {
-    @include carbon--make-row();
-  }
-
-  .#{$prefix}--row-padding [class*='#{$prefix}--col'],
-  .#{$prefix}--col-padding {
-    padding-top: $grid-gutter / 2;
-    padding-bottom: $grid-gutter / 2;
-  }
-
-  .#{$prefix}--grid--condensed [class*='#{$prefix}--col'] {
-    padding-top: $condensed-gutter / 2;
-    padding-bottom: $condensed-gutter / 2;
-  }
-
-  @include carbon--make-grid-columns($breakpoints, $grid-gutter);
-  @include carbon--no-gutter();
-  @include carbon--hang($grid-gutter);
-  @include carbon--aspect-ratio();
-}

package/scss/type/vendor/@carbon/grid/_prefix.scss

@@ -1,12 +0,0 @@
-//
-// Copyright IBM Corp. 2018, 2018
-//
-// This source code is licensed under the Apache-2.0 license found in the
-// LICENSE file in the root directory of this source tree.
-//
-
-/// Namespace prefix
-/// @type String
-/// @access public
-/// @group @carbon/grid
-$prefix: 'bx' !default;

package/scss/type/vendor/@carbon/grid/grid.scss

@@ -1,10 +0,0 @@
-//
-// Copyright IBM Corp. 2018, 2018
-//
-// This source code is licensed under the Apache-2.0 license found in the
-// LICENSE file in the root directory of this source tree.
-//
-
-@import './_inlined/mixins';
-
-@include carbon--grid();

package/scss/type/vendor/@carbon/grid/index.scss

@@ -1,10 +0,0 @@
-//
-// Copyright IBM Corp. 2018, 2018
-//
-// This source code is licensed under the Apache-2.0 license found in the
-// LICENSE file in the root directory of this source tree.
-//
-
-@import 'mixins';
-
-@include carbon--grid();

package/scss/type/vendor/@carbon/grid/modules/_breakpoint.scss

@@ -1,198 +0,0 @@
-//
-// Copyright IBM Corp. 2018, 2018
-//
-// This source code is licensed under the Apache-2.0 license found in the
-// LICENSE file in the root directory of this source tree.
-//
-
-@use 'sass:list';
-@use 'sass:map';
-@use 'sass:meta';
-@use '../../../../../layout/modules/convert';
-@use 'config' as *;
-
-/// Provide a map and index, and get back the relevant key value
-/// @access public
-/// @param {Map} $map - Map
-/// @param {Integer} $index - Key chain
-/// @return {String} Desired value
-/// @group @carbon/layout
-@function -key-by-index($map, $index) {
-  $keys: map.keys($map);
-  @return nth($keys, $index);
-}
-
-/// Get the value of the next breakpoint, or null for the last breakpoint
-/// @param {String} $name - The name of the breakpoint
-/// @param {Map} $breakpoints [$grid-breakpoints] - A map of breakpoints where the key is the name of the breakpoint and the value is the values for the breakpoint
-/// @param {List} $breakpoint-names [map-keys($breakpoints)] - A list of names from the `$breakpoints` map
-/// @return {String}
-/// @access public
-/// @group @carbon/layout
-@function breakpoint-next(
-  $name,
-  $breakpoints: $grid-breakpoints,
-  $breakpoint-names: map.keys($breakpoints)
-) {
-  $n: list.index($breakpoint-names, $name);
-  @if $n != null and $n < list.length($breakpoint-names) {
-    @return list.nth($breakpoint-names, $n + 1);
-  }
-  @return null;
-}
-
-/// Get the value of the previous breakpoint, or null for the first breakpoint
-/// @param {String} $name - The name of the breakpoint
-/// @param {Map} $breakpoints [$grid-breakpoints] - A map of breakpoints where the key is the name of the breakpoint and the value is the values for the breakpoint
-/// @param {List} $breakpoint-names [map-keys($breakpoints)] - A list of names from the `$breakpoints` map
-/// @return {String}
-/// @access public
-/// @group @carbon/layout
-@function breakpoint-prev(
-  $name,
-  $breakpoints: $grid-breakpoints,
-  $breakpoint-names: map.keys($breakpoints)
-) {
-  $n: list.index($breakpoint-names, $name);
-  @if $n != null and $n > 1 {
-    @return list.nth($breakpoint-names, $n - 1);
-  }
-  @return null;
-}
-
-/// Check to see if the given breakpoint name
-/// @param {String} $name - The name of the breakpoint
-/// @param {Map} $breakpoints [$grid-breakpoints] - A map of breakpoints where the key is the name of the breakpoint and the value is the values for the breakpoint
-/// @return {Bool}
-/// @access public
-/// @group @carbon/layout
-@function is-smallest-breakpoint($name, $breakpoints: $grid-breakpoints) {
-  @return list.index(map.keys($breakpoints), $name) == 1;
-}
-
-/// Returns the largest breakpoint name
-/// @param {Map} $breakpoints [$grid-breakpoints] - A map of breakpoints where the key is the name
-/// @return {String}
-/// @access public
-/// @group @carbon/layout
-@function largest-breakpoint-name($breakpoints: $grid-breakpoints) {
-  $total-breakpoints: list.length($breakpoints);
-  @return -key-by-index($breakpoints, $total-breakpoints);
-}
-
-/// Get the infix for a given breakpoint in a list of breakpoints. Useful for generating the size part in a selector, for example: `.prefix--col-sm-2`.
-/// @param {String} $name - The name of the breakpoint
-/// @return {String}
-/// @access public
-/// @group @carbon/layout
-@function breakpoint-infix($name) {
-  @return '-#{$name}';
-}
-
-/// Generate a media query from the width of the given breakpoint to infinity
-/// @param {String | Number} $name
-/// @param {Map} $breakpoints [$grid-breakpoints] - A map of breakpoints where the key is the name
-/// @content
-/// @access public
-/// @group @carbon/layout
-@mixin breakpoint-up($name, $breakpoints: $grid-breakpoints) {
-  @if meta.type-of($name) == 'number' {
-    @media (min-width: $name) {
-      @content;
-    }
-  } @else if map.has-key($breakpoints, $name) {
-    $breakpoint: map.get($breakpoints, $name);
-    $width: map.get($breakpoint, width);
-    @if is-smallest-breakpoint($name, $breakpoints) {
-      @content;
-    } @else {
-      @media (min-width: $width) {
-        @content;
-      }
-    }
-  } @else {
-    @error 'Unable to find a breakpoint with name `#{$name}`. Expected one of: (#{map.keys($breakpoints)})';
-  }
-}
-
-/// Generate a media query for the maximum width of the given styles
-/// @param {String | Number} $name
-/// @param {Map} $breakpoints [$grid-breakpoints] - A map of breakpoints where the key is the name
-/// @content
-/// @access public
-/// @group @carbon/layout
-@mixin breakpoint-down($name, $breakpoints: $grid-breakpoints) {
-  @if meta.type-of($name) == 'number' {
-    @media (max-width: $name) {
-      @content;
-    }
-  } @else if map.has-key($breakpoints, $name) {
-    // We borrow this logic from bootstrap for specifying the value of the
-    // max-width. The maximum width is calculated by finding the breakpoint and
-    // subtracting .02 from its value. This value is used instead of .01 to
-    // avoid rounding issues in Safari
-    // https://github.com/twbs/bootstrap/blob/c5b1919deaf5393fcca9e9b9d7ce9c338160d99d/scss/mixins/_breakpoints.scss#L34-L46
-    $breakpoint: map.get($breakpoints, $name);
-    $width: map.get($breakpoint, width) - 0.02;
-    @media (max-width: $width) {
-      @content;
-    }
-  } @else {
-    @error 'Unable to find a breakpoint with name `#{$name}`. Expected one of: (#{map.keys($breakpoints)})';
-  }
-}
-
-/// Generate a media query for the range between the lower and upper breakpoints
-/// @param {String | Number} $lower
-/// @param {String | Number} $upper
-/// @param {Map} $breakpoints [$grid-breakpoints] - A map of breakpoints where the key is the name
-/// @content
-/// @access public
-/// @group @carbon/layout
-@mixin breakpoint-between($lower, $upper, $breakpoints: $grid-breakpoints) {
-  $is-number-lower: meta.type-of($lower) == 'number';
-  $is-number-upper: meta.type-of($upper) == 'number';
-  $min: if($is-number-lower, $lower, map.get($breakpoints, $lower));
-  $max: if($is-number-upper, $upper, map.get($breakpoints, $upper));
-
-  @if $min and $max {
-    $min-width: if(not $is-number-lower and $min, map.get($min, width), $min);
-    $max-width: if(not $is-number-upper and $max, map.get($max, width), $max);
-    @media (min-width: $min-width) and (max-width: $max-width) {
-      @content;
-    }
-  } @else if $min != null and $max == null {
-    @include breakpoint-up($lower) {
-      @content;
-    }
-  } @else if $min == null and $max != null {
-    @include breakpoint-down($upper) {
-      @content;
-    }
-  } @else {
-    @error 'Unable to find a breakpoint to satisfy: (#{$lower},#{$upper}). Expected both to be one of (#{map.keys($breakpoints)}).';
-  }
-}
-
-/// Generate media query for the largest breakpoint
-/// @param {Map} $breakpoints [$grid-breakpoints] - A map of breakpoints where the key is the name
-/// @content
-/// @access public
-/// @group @carbon/layout
-@mixin largest-breakpoint($breakpoints: $grid-breakpoints) {
-  @include breakpoint(largest-breakpoint-name()) {
-    @content;
-  }
-}
-
-/// Generate a media query for a given breakpoint
-/// @param {String | Number} $name
-/// @param {Map} $breakpoints [$grid-breakpoints] - A map of breakpoints where the key is the name
-/// @content
-/// @access public
-/// @group @carbon/layout
-@mixin breakpoint($name, $breakpoints: $grid-breakpoints) {
-  @include breakpoint-up($name, $breakpoints) {
-    @content;
-  }
-}