@carbon/layout 10.37.0 → 11.0.0

package/scss/modules/_convert.scss

@@ -21,8 +21,7 @@ $base-font-size: 16px !default;
 /// @group @carbon/layout
 @function rem($px) {
   @if unit($px) != 'px' {
-    // TODO: update to @error in v11
-    @warn "Expected argument $px to be of type `px`, instead received: `#{unit($px)}`";
+    @error "Expected argument $px to be of type `px`, instead received: `#{unit($px)}`";
   }
 
   @if meta.function-exists('div', 'math') {
@@ -39,8 +38,7 @@ $base-font-size: 16px !default;
 /// @group @carbon/layout
 @function em($px) {
   @if unit($px) != 'px' {
-    // TODO: update to @error in v11
-    @warn "Expected argument $px to be of type `px`, instead received: `#{unit($px)}`";
+    @error "Expected argument $px to be of type `px`, instead received: `#{unit($px)}`";
   }
 
   @if meta.function-exists('div', 'math') {

package/src/index.js

@@ -131,25 +131,6 @@ export const fluidSpacing = [
   fluidSpacing04,
 ];
 
-// Layout
-// Deprecated -- Remove in v11
-export const layout01 = miniUnits(2);
-export const layout02 = miniUnits(3);
-export const layout03 = miniUnits(4);
-export const layout04 = miniUnits(6);
-export const layout05 = miniUnits(8);
-export const layout06 = miniUnits(12);
-export const layout07 = miniUnits(20);
-export const layout = [
-  layout01,
-  layout02,
-  layout03,
-  layout04,
-  layout05,
-  layout06,
-  layout07,
-];
-
 // Container
 export const container01 = miniUnits(3);
 export const container02 = miniUnits(4);

package/src/tokens.js

@@ -27,16 +27,6 @@ export const unstable_tokens = [
   'fluidSpacing03',
   'fluidSpacing04',
 
-  // Layout
-  // Deprecated -- Remove in v11
-  'layout01',
-  'layout02',
-  'layout03',
-  'layout04',
-  'layout05',
-  'layout06',
-  'layout07',
-
   // Containers
   'container01',
   'container02',

package/umd/index.js

@@ -12,9 +12,7 @@
    */
   var unstable_tokens = [// Spacing
   'spacing01', 'spacing02', 'spacing03', 'spacing04', 'spacing05', 'spacing06', 'spacing07', 'spacing08', 'spacing09', 'spacing10', 'spacing11', 'spacing12', 'spacing13', // Fluid spacing
-  'fluidSpacing01', 'fluidSpacing02', 'fluidSpacing03', 'fluidSpacing04', // Layout
-  // Deprecated -- Remove in v11
-  'layout01', 'layout02', 'layout03', 'layout04', 'layout05', 'layout06', 'layout07', // Containers
+  'fluidSpacing01', 'fluidSpacing02', 'fluidSpacing03', 'fluidSpacing04', // Containers
   'container01', 'container02', 'container03', 'container04', 'container05', 'sizeXSmall', 'sizeSmall', 'sizeMedium', 'sizeLarge', 'sizeXLarge', 'size2XLarge', // Icon sizes
   'iconSize01', 'iconSize02'];
 
@@ -117,17 +115,7 @@
   var fluidSpacing02 = '2vw';
   var fluidSpacing03 = '5vw';
   var fluidSpacing04 = '10vw';
-  var fluidSpacing = [fluidSpacing01, fluidSpacing02, fluidSpacing03, fluidSpacing04]; // Layout
-  // Deprecated -- Remove in v11
-
-  var layout01 = miniUnits(2);
-  var layout02 = miniUnits(3);
-  var layout03 = miniUnits(4);
-  var layout04 = miniUnits(6);
-  var layout05 = miniUnits(8);
-  var layout06 = miniUnits(12);
-  var layout07 = miniUnits(20);
-  var layout = [layout01, layout02, layout03, layout04, layout05, layout06, layout07]; // Container
+  var fluidSpacing = [fluidSpacing01, fluidSpacing02, fluidSpacing03, fluidSpacing04]; // Container
 
   var container01 = miniUnits(3);
   var container02 = miniUnits(4);
@@ -174,14 +162,6 @@
   exports.iconSize = iconSize;
   exports.iconSize01 = iconSize01;
   exports.iconSize02 = iconSize02;
-  exports.layout = layout;
-  exports.layout01 = layout01;
-  exports.layout02 = layout02;
-  exports.layout03 = layout03;
-  exports.layout04 = layout04;
-  exports.layout05 = layout05;
-  exports.layout06 = layout06;
-  exports.layout07 = layout07;
   exports.miniUnit = miniUnit;
   exports.miniUnits = miniUnits;
   exports.px = px;

package/scss/_breakpoint.scss

@@ -1,246 +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.
-//
-
-// https://github.com/twbs/bootstrap/blob/v4-dev/scss/mixins/_breakpoints.scss
-@import 'convert';
-@import 'utilities';
-
-/// Carbon gutter size in rem
-/// @type Number
-/// @access public
-/// @group @carbon/layout
-$carbon--grid-gutter: carbon--rem(32px);
-
-/// Carbon condensed gutter size in rem
-/// @type Number
-/// @access public
-/// @group @carbon/layout
-$carbon--grid-gutter--condensed: carbon--rem(1px);
-
-// Initial map of our breakpoints and their values
-/// @type Map
-/// @access public
-/// @group @carbon/layout
-$carbon--grid-breakpoints: (
-  sm: (
-    columns: 4,
-    margin: 0,
-    width: carbon--rem(320px),
-  ),
-  md: (
-    columns: 8,
-    margin: carbon--rem(16px),
-    width: carbon--rem(672px),
-  ),
-  lg: (
-    columns: 16,
-    margin: carbon--rem(16px),
-    width: carbon--rem(1056px),
-  ),
-  xlg: (
-    columns: 16,
-    margin: carbon--rem(16px),
-    width: carbon--rem(1312px),
-  ),
-  max: (
-    columns: 16,
-    margin: carbon--rem(24px),
-    width: carbon--rem(1584px),
-  ),
-) !default;
-
-/// Get the value of the next breakpoint, or null for the last breakpoint
-/// @param {String} $name - The name of the breakpoint
-/// @param {Map} $breakpoints [$carbon--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 carbon--breakpoint-next(
-  $name,
-  $breakpoints: $carbon--grid-breakpoints,
-  $breakpoint-names: map-keys($breakpoints)
-) {
-  $n: index($breakpoint-names, $name);
-  @if $n != null and $n < length($breakpoint-names) {
-    @return 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 [$carbon--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 carbon--breakpoint-prev(
-  $name,
-  $breakpoints: $carbon--grid-breakpoints,
-  $breakpoint-names: map-keys($breakpoints)
-) {
-  $n: index($breakpoint-names, $name);
-  @if $n != null and $n > 1 {
-    @return 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 [$carbon--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 carbon--is-smallest-breakpoint(
-  $name,
-  $breakpoints: $carbon--grid-breakpoints
-) {
-  @return index(map-keys($breakpoints), $name) == 1;
-}
-
-/// Returns the largest breakpoint name
-/// @param {Map} $breakpoints [$carbon--grid-breakpoints] - A map of breakpoints where the key is the name
-/// @return {String}
-/// @access public
-/// @group @carbon/layout
-@function carbon--largest-breakpoint-name(
-  $breakpoints: $carbon--grid-breakpoints
-) {
-  $total-breakpoints: length($breakpoints);
-  @return carbon--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 carbon--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 [$carbon--grid-breakpoints] - A map of breakpoints where the key is the name
-/// @content
-/// @access public
-/// @group @carbon/layout
-@mixin carbon--breakpoint-up($name, $breakpoints: $carbon--grid-breakpoints) {
-  @if 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 carbon--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 [$carbon--grid-breakpoints] - A map of breakpoints where the key is the name
-/// @content
-/// @access public
-/// @group @carbon/layout
-@mixin carbon--breakpoint-down($name, $breakpoints: $carbon--grid-breakpoints) {
-  @if 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 [$carbon--grid-breakpoints] - A map of breakpoints where the key is the name
-/// @content
-/// @access public
-/// @group @carbon/layout
-@mixin carbon--breakpoint-between(
-  $lower,
-  $upper,
-  $breakpoints: $carbon--grid-breakpoints
-) {
-  $is-number-lower: type-of($lower) == 'number';
-  $is-number-upper: 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) + 0.02,
-      $min
-    );
-    $max-width: if(
-      not $is-number-upper and $max,
-      map-get($max, width) - 0.02,
-      $max
-    );
-    @media (min-width: $min-width) and (max-width: $max-width) {
-      @content;
-    }
-  } @else if $min != null and $max == null {
-    @include carbon--breakpoint-up($lower) {
-      @content;
-    }
-  } @else if $min == null and $max != null {
-    @include carbon--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 [$carbon--grid-breakpoints] - A map of breakpoints where the key is the name
-/// @content
-/// @access public
-/// @group @carbon/layout
-@mixin carbon--largest-breakpoint($breakpoints: $carbon--grid-breakpoints) {
-  @include carbon--breakpoint(carbon--largest-breakpoint-name()) {
-    @content;
-  }
-}
-
-/// Generate a media query for a given breakpoint
-/// @param {String | Number} $name
-/// @param {Map} $breakpoints [$carbon--grid-breakpoints] - A map of breakpoints where the key is the name
-/// @content
-/// @access public
-/// @group @carbon/layout
-@mixin carbon--breakpoint($name, $breakpoints: $carbon--grid-breakpoints) {
-  @include carbon--breakpoint-up($name, $breakpoints) {
-    @content;
-  }
-}

package/scss/_key-height.import.scss

@@ -1,117 +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 (*.import.scss)
-// ------------------------------------------
-//
-// This file is intended to be consumed and processed with dart-sass.
-// It is incompatible with node-sass/libsass as it contains sass language features
-// or functions that are unavailable in node-sass/libsass, such as `math.div`.
-//
-// The non-`.import` suffixed version of this file eg. `_filename.scss`
-// is intended to be compatible with node-sass/libsass.
-//
-// 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.
-
-@use 'sass:meta';
-@use "sass:math";
-@import 'breakpoint';
-@import 'utilities';
-
-/// Get the column width for a given breakpoint
-/// @param {String} $breakpoint
-/// @param {Map} $breakpoints [$carbon--grid-breakpoints]
-/// @return {Number} In rem
-/// @access public
-/// @group @carbon/layout
-@function carbon--get-column-width(
-  $breakpoint,
-  $breakpoints: $carbon--grid-breakpoints
-) {
-  @if map-has-key($breakpoints, $breakpoint) {
-    $values: map-get($breakpoints, $breakpoint);
-    $width: map-get($values, width);
-    $margin: map-get($values, margin);
-    $columns: map-get($values, columns);
-
-    @if meta.function-exists('div', 'math') {
-      @return math.div($width - (2 * $margin), $columns);
-    } @else {
-      @return (($width - (2 * $margin)) / $columns);
-    }
-  } @else {
-    @warn 'Breakpoint: `#{$breakpoint}` is not a valid breakpoint.';
-  }
-}
-
-/// @type Map
-/// @access public
-/// @group @carbon/layout
-$carbon--key-height-scales: (
-  sm: (
-    carbon--get-column-width(sm),
-    carbon--get-column-width(sm) * 2,
-    carbon--get-column-width(sm) * 3,
-    carbon--get-column-width(sm) * 4,
-    carbon--get-column-width(sm) * 5,
-    carbon--get-column-width(sm) * 6,
-  ),
-  md: (
-    carbon--get-column-width(md),
-    carbon--get-column-width(md) * 2,
-    carbon--get-column-width(md) * 3,
-    carbon--get-column-width(md) * 4,
-    carbon--get-column-width(md) * 5,
-    carbon--get-column-width(md) * 6,
-  ),
-  lg: (
-    carbon--get-column-width(lg),
-    carbon--get-column-width(lg) * 2,
-    carbon--get-column-width(lg) * 3,
-    carbon--get-column-width(lg) * 4,
-    carbon--get-column-width(lg) * 5,
-    carbon--get-column-width(lg) * 6,
-    carbon--get-column-width(lg) * 7,
-    carbon--get-column-width(lg) * 8,
-  ),
-  xlg: (
-    carbon--get-column-width(xlg),
-    carbon--get-column-width(xlg) * 2,
-    carbon--get-column-width(xlg) * 3,
-    carbon--get-column-width(xlg) * 4,
-    carbon--get-column-width(xlg) * 5,
-    carbon--get-column-width(xlg) * 6,
-    carbon--get-column-width(xlg) * 7,
-    carbon--get-column-width(xlg) * 8,
-  ),
-  max: (
-    carbon--get-column-width(max),
-    carbon--get-column-width(max) * 2,
-    carbon--get-column-width(max) * 3,
-    carbon--get-column-width(max) * 4,
-    carbon--get-column-width(max) * 5,
-    carbon--get-column-width(max) * 6,
-    carbon--get-column-width(max) * 7,
-    carbon--get-column-width(max) * 8,
-  ),
-);
-
-/// Get the value of a key height step at a given breakpoint
-/// @param {String} $breakpoint
-/// @param {Number} $step
-/// @return {Number} In rem
-/// @access public
-/// @group @carbon/layout
-@function carbon--key-height($breakpoint, $step) {
-  @if map-has-key($carbon--key-height-scales, $breakpoint) {
-    @return nth(map-get($carbon--key-height-scales, $breakpoint), $step);
-  } @else {
-    @warn 'Breakpoint: `#{$breakpoint}` is not a valid breakpoint.';
-  }
-}

package/scss/_key-height.scss

@@ -1,111 +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.
-
-@import 'breakpoint';
-@import 'utilities';
-
-/// Get the column width for a given breakpoint
-/// @param {String} $breakpoint
-/// @param {Map} $breakpoints [$carbon--grid-breakpoints]
-/// @return {Number} In rem
-/// @access public
-/// @group @carbon/layout
-@function carbon--get-column-width(
-  $breakpoint,
-  $breakpoints: $carbon--grid-breakpoints
-) {
-  @if map-has-key($breakpoints, $breakpoint) {
-    $values: map-get($breakpoints, $breakpoint);
-    $width: map-get($values, width);
-    $margin: map-get($values, margin);
-    $columns: map-get($values, columns);
-
-    @return ($width - (2 * $margin)) / $columns;
-  } @else {
-    @warn 'Breakpoint: `#{$breakpoint}` is not a valid breakpoint.';
-  }
-}
-
-/// @type Map
-/// @access public
-/// @group @carbon/layout
-$carbon--key-height-scales: (
-  sm: (
-    carbon--get-column-width(sm),
-    carbon--get-column-width(sm) * 2,
-    carbon--get-column-width(sm) * 3,
-    carbon--get-column-width(sm) * 4,
-    carbon--get-column-width(sm) * 5,
-    carbon--get-column-width(sm) * 6,
-  ),
-  md: (
-    carbon--get-column-width(md),
-    carbon--get-column-width(md) * 2,
-    carbon--get-column-width(md) * 3,
-    carbon--get-column-width(md) * 4,
-    carbon--get-column-width(md) * 5,
-    carbon--get-column-width(md) * 6,
-  ),
-  lg: (
-    carbon--get-column-width(lg),
-    carbon--get-column-width(lg) * 2,
-    carbon--get-column-width(lg) * 3,
-    carbon--get-column-width(lg) * 4,
-    carbon--get-column-width(lg) * 5,
-    carbon--get-column-width(lg) * 6,
-    carbon--get-column-width(lg) * 7,
-    carbon--get-column-width(lg) * 8,
-  ),
-  xlg: (
-    carbon--get-column-width(xlg),
-    carbon--get-column-width(xlg) * 2,
-    carbon--get-column-width(xlg) * 3,
-    carbon--get-column-width(xlg) * 4,
-    carbon--get-column-width(xlg) * 5,
-    carbon--get-column-width(xlg) * 6,
-    carbon--get-column-width(xlg) * 7,
-    carbon--get-column-width(xlg) * 8,
-  ),
-  max: (
-    carbon--get-column-width(max),
-    carbon--get-column-width(max) * 2,
-    carbon--get-column-width(max) * 3,
-    carbon--get-column-width(max) * 4,
-    carbon--get-column-width(max) * 5,
-    carbon--get-column-width(max) * 6,
-    carbon--get-column-width(max) * 7,
-    carbon--get-column-width(max) * 8,
-  ),
-);
-
-/// Get the value of a key height step at a given breakpoint
-/// @param {String} $breakpoint
-/// @param {Number} $step
-/// @return {Number} In rem
-/// @access public
-/// @group @carbon/layout
-@function carbon--key-height($breakpoint, $step) {
-  @if map-has-key($carbon--key-height-scales, $breakpoint) {
-    @return nth(map-get($carbon--key-height-scales, $breakpoint), $step);
-  } @else {
-    @warn 'Breakpoint: `#{$breakpoint}` is not a valid breakpoint.';
-  }
-}

package/scss/_mini-unit.scss

@@ -1,23 +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 'convert';
-
-/// Default mini-unit value
-/// @type Number
-/// @access public
-/// @group @carbon/layout
-$carbon--mini-unit-size: 8px !default;
-
-/// Get the value of the corresponding number of units
-/// @param {Number} $count - The number of units to get the value for
-/// @return {Number} In rem units
-/// @access public
-/// @group @carbon/layout
-@function carbon--mini-units($count) {
-  @return carbon--rem($carbon--mini-unit-size * $count);
-}