@workday/canvas-kit-react 8.0.0 → 8.0.1

package/dist/es6/layout/lib/Box.js

@@ -25,15 +25,39 @@ import styled from '@emotion/styled';
 import isPropValid from '@emotion/is-prop-valid';
 import { createComponent, useConstant } from '@workday/canvas-kit-react/common';
 // style props
+import { background } from './utils/background';
 import { border } from './utils/border';
 import { color } from './utils/color';
 import { depth } from './utils/depth';
 import { flexItem } from './utils/flexItem';
+import { gridItem } from './utils/gridItem';
 import { layout } from './utils/layout';
 import { other } from './utils/other';
 import { position } from './utils/position';
 import { space } from './utils/space';
-var omittedProps = ['display', 'color', 'height', 'overflow', 'width', 'border', 'background'];
+import { text } from './utils/text';
+var omittedProps = [
+    'display',
+    'color',
+    'height',
+    'overflow',
+    'width',
+    'border',
+    'background',
+    'fontSize',
+    'fontWeight',
+    'fontFamily',
+    'letterSpacing',
+    'lineHeight',
+    'textAlign',
+    'opacity',
+    'textDecoration',
+    'textOverflow',
+    'textTransform',
+    'textShadow',
+    'whiteSpace',
+    'wordBreak',
+];
 var shouldForwardProp = function (prop) {
     return isPropValid(prop) && !omittedProps.includes(prop);
 };
@@ -41,6 +65,7 @@ var shouldForwardProp = function (prop) {
  * A function that allows us to call Box styles on an element and reduce the amount of elements in the React Dom tree.
  * Instead of using the `as` in a styled function, you can just call this instead to pass those props to the styled element
  * @example
+ * ```
  * import { boxStyleFn } from '@workday/canvas-kit-react/layout';
  * const StyledHeader = styled('h1')(
  *  boxStyleFn,
@@ -49,22 +74,27 @@ var shouldForwardProp = function (prop) {
  *  }
  * )
  *
- * ....
+ * ...
  *
  * <StyledHeader color='red'>Hello World</StyledHeader>
+ * ```
  */
 export var boxStyleFn = function (props) {
     return [
         {
             boxSizing: 'border-box',
         },
+        background,
         border,
         color,
         depth,
         flexItem,
+        gridItem,
         layout,
+        other,
         position,
         space,
+        text,
     ].reduce(function (result, style) {
         // @ts-ignore
         var temp = typeof style === 'function' ? style(props) : style;
@@ -77,13 +107,9 @@ export var boxStyleFn = function (props) {
     }, {});
 };
 // Meant to be used with elements. The `shouldForwardProps` will remove all style props
-var StyledBoxElement = styled('div', { shouldForwardProp: shouldForwardProp })({
-    boxSizing: 'border-box',
-}, border, color, depth, flexItem, layout, position, space);
+var StyledBoxElement = styled('div', { shouldForwardProp: shouldForwardProp })(boxStyleFn);
 // Meant to be used with components. There is no `shouldForwardProps` - all props will be forwarded to the component
-var StyledBoxComponent = styled('div')({
-    boxSizing: 'border-box',
-}, border, color, depth, flexItem, layout, other, position, space);
+var StyledBoxComponent = styled('div')(boxStyleFn);
 /**
  * `Box` is a primitive component that provides a common, ergonomic API around Canvas design tokens.
  * It is highly flexible, and its primary purpose is to build other components.

package/dist/es6/layout/lib/Column.d.ts

@@ -1,11 +1,19 @@
 import * as React from 'react';
-export interface ColumnProps {
+/**
+ * ### Deprecated Layout Column Props
+ *
+ * As of Canvas Kit v8, Layout is being soft-deprecated.
+ * It will be hard-deprecated (completely removed) in v9. Please see the
+ * [upgrade guide](https://workday.github.io/canvas-kit/?path=/story/welcome-upgrade-guides-v8-0--page)
+ * for more information.
+ */
+export interface DeprecatedColumnProps {
     /**
-     * The children of the Column (cannot be empty).
+     * The children of the DeprecatedColumn (cannot be empty).
      */
     children?: React.ReactNode;
     /**
-     * The left and right padding of the Column (inherits from Layout prop).
+     * The left and right padding of the DeprecatedColumn (inherits from Layout prop).
      * @default 12
      */
     spacing?: number;
@@ -18,7 +26,8 @@ export interface ColumnProps {
      */
     width?: number | string;
 }
-export default class Column extends React.Component<ColumnProps> {
+export declare class DeprecatedColumn extends React.Component<DeprecatedColumnProps> {
+    componentDidMount(): void;
     render(): JSX.Element;
 }
 //# sourceMappingURL=Column.d.ts.map

package/dist/es6/layout/lib/Column.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Column.d.ts","sourceRoot":"","sources":["../../../../layout/lib/Column.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;IAC3D;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACzB;AAsCD,MAAM,CAAC,OAAO,OAAO,MAAO,SAAQ,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC;IACvD,MAAM;CASd"}
+{"version":3,"file":"Column.d.ts","sourceRoot":"","sources":["../../../../layout/lib/Column.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;IAC3D;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACzB;AAsCD,qBAAa,gBAAiB,SAAQ,KAAK,CAAC,SAAS,CAAC,qBAAqB,CAAC;IAC1E,iBAAiB;IASV,MAAM;CASd"}

package/dist/es6/layout/lib/Column.js

@@ -67,15 +67,18 @@ var ColumnContainer = styled('div', {
     }
     return { flex: 1 };
 });
-var Column = /** @class */ (function (_super) {
-    __extends(Column, _super);
-    function Column() {
+var DeprecatedColumn = /** @class */ (function (_super) {
+    __extends(DeprecatedColumn, _super);
+    function DeprecatedColumn() {
         return _super !== null && _super.apply(this, arguments) || this;
     }
-    Column.prototype.render = function () {
+    DeprecatedColumn.prototype.componentDidMount = function () {
+        console.warn("This component is being deprecated and will be removed in Canvas Kit V9.\n\n      For more information, please see the V8 upgrade guide:\n\n      https://workday.github.io/canvas-kit/?path=/story/welcome-upgrade-guides-v8-0--page\n      ");
+    };
+    DeprecatedColumn.prototype.render = function () {
         var _a = this.props, children = _a.children, spacing = _a.spacing, columns = _a.columns, width = _a.width, elemProps = __rest(_a, ["children", "spacing", "columns", "width"]);
         return (React.createElement(ColumnContainer, __assign({ spacing: spacing, columns: columns, width: width }, elemProps), children));
     };
-    return Column;
+    return DeprecatedColumn;
 }(React.Component));
-export default Column;
+export { DeprecatedColumn };

package/dist/es6/layout/lib/Flex.d.ts

@@ -1,12 +1,13 @@
 import { BoxProps } from './Box';
 import { FlexStyleProps } from './utils/flex';
-export declare type FlexProps = BoxProps & FlexStyleProps;
+export declare type FlexProps = Omit<BoxProps, 'display'> & FlexStyleProps;
 /**
  * `Flex` is a low-level layout component that provides a common, ergonomic API for applying CSS flexbox styles.
  * It is highly flexible, and can be used on its own or to build other components.
  * `Flex` is built on top of `Box` and has access to all `BoxProps`.
  *
  * @example
+ * ```tsx
  * import { Flex, FlexProps } from '@workday/canvas-kit-react/layout';
  *
  * interface CardProps extends FlexProps {
@@ -20,7 +21,9 @@ export declare type FlexProps = BoxProps & FlexStyleProps;
  *     <p>This card uses flexbox to set its layout.</p>
  *   </Flex>
  * );
- *
+ * ```
  */
-export declare const Flex: import("../../common").ElementComponent<"div", import("..").BorderShorthandStyleProps & import("..").BorderColorStyleProps & import("..").BorderRadiusStyleProps & import("..").BorderLineStyleProps & import("..").BorderWidthStyleProps & import("..").BorderLogicalStyleProps & import("..").ColorStyleProps & import("..").DepthStyleProps & import("..").FlexItemStyleProps & import("..").LayoutStyleProps & import("./utils/other").OtherStyleProps & import("..").PositionStandardProps & import("..").PositionLogicalProps & import("./utils/space").SpaceStandardProps & import("./utils/space").SpaceLogicalProps & FlexStyleProps>;
+export declare const Flex: import("../../common").ElementComponent<"div", FlexProps> & {
+    Item: import("../../common").ElementComponent<"div", import("..").CommonStyleProps>;
+};
 //# sourceMappingURL=Flex.d.ts.map

package/dist/es6/layout/lib/Flex.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Flex.d.ts","sourceRoot":"","sources":["../../../../layout/lib/Flex.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAM,QAAQ,EAAC,MAAM,OAAO,CAAC;AAEpC,OAAO,EAAO,cAAc,EAAC,MAAM,cAAc,CAAC;AAElD,oBAAY,SAAS,GAAG,QAAQ,GAAG,cAAc,CAAC;AASlD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,IAAI,gnBASf,CAAC"}
+{"version":3,"file":"Flex.d.ts","sourceRoot":"","sources":["../../../../layout/lib/Flex.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAM,QAAQ,EAAC,MAAM,OAAO,CAAC;AAEpC,OAAO,EAAO,cAAc,EAAC,MAAM,cAAc,CAAC;AAElD,oBAAY,SAAS,GAAG,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,GAAG,cAAc,CAAC;AASnE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,IAAI;;CAYf,CAAC"}

package/dist/es6/layout/lib/Flex.js

@@ -34,6 +34,7 @@ var StyledFlex = styled(Box)({
  * `Flex` is built on top of `Box` and has access to all `BoxProps`.
  *
  * @example
+ * ```tsx
  * import { Flex, FlexProps } from '@workday/canvas-kit-react/layout';
  *
  * interface CardProps extends FlexProps {
@@ -47,7 +48,7 @@ var StyledFlex = styled(Box)({
  *     <p>This card uses flexbox to set its layout.</p>
  *   </Flex>
  * );
- *
+ * ```
  */
 export var Flex = createComponent('div')({
     displayName: 'Flex',
@@ -55,4 +56,7 @@ export var Flex = createComponent('div')({
         var children = _a.children, elemProps = __rest(_a, ["children"]);
         return (React.createElement(StyledFlex, __assign({ as: Element, ref: ref }, elemProps), children));
     },
+    subComponents: {
+        Item: Box,
+    },
 });

package/dist/es6/layout/lib/Grid.d.ts

@@ -0,0 +1,51 @@
+import { BoxProps } from './Box';
+import { GridStyleProps } from './utils/grid';
+export declare type GridProps = Omit<BoxProps, 'display'> & GridStyleProps;
+export declare type GridItemProps = BoxProps;
+/**
+ * `Grid` is a two-dimensional layout system for the web. It lets you lay content out in rows and columns.
+ * It is highly flexible, and can be used on its own or to build other components.
+ * `Grid` is built on top of `Box` and has access to all `BoxProps`.
+ *
+ * @example
+ * ```tsx
+ * import { Grid } from '@workday/canvas-kit-react/layout';
+ *
+ * interface CardProps extends GridProps {
+ *   // card-specific props
+ * }
+ *
+ * // `Card`'s default values are set using `GridProps`
+ * const Card = (props: CardProps) => (
+ *   <Grid gridAutoFlow="row" alignItems="start" depth={1} space="m" {...props}>
+ *     <h1>Hello, Card!</h1>
+ *     <p>This card uses grid to set its layout.</p>
+ *   </Grid>
+ * );
+ *```
+ */
+export declare const Grid: import("../../common").ElementComponent<"div", GridProps> & {
+    /**
+     * `<Grid.Item />` is the child specific sub-component to `<Grid/>`. `<Grid.Item />` gets child specific props, whereas `<Grid./>` gets parent container props.
+     *
+     * @example
+     * ```
+     * import { Grid } from '@workday/canvas-kit-react/layout';
+     * `Grid` is built on top of `Box` so `<Grid.Item />` gets all `BoxProps` as well.
+     *
+     * interface CardProps extends GridItemStyleProps {
+     *   // card-specific props
+     * }
+     *
+     * // `Card`'s default values are set using `GridItemStyleProps`
+     * const Card = (props: CardProps) => (
+     *   <Grid.Item gridRowStart="1" gridArea="Card" {...props}>
+     *     <h1>Hello, Card!</h1>
+     *     <p>This card uses grid child specific props to set its layout.</p>
+     *   </Grid.Item>
+     * );
+     *```
+     */
+    Item: import("../../common").ElementComponent<"div", import("..").CommonStyleProps>;
+};
+//# sourceMappingURL=Grid.d.ts.map

package/dist/es6/layout/lib/Grid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Grid.d.ts","sourceRoot":"","sources":["../../../../layout/lib/Grid.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAM,QAAQ,EAAC,MAAM,OAAO,CAAC;AAEpC,OAAO,EAAO,cAAc,EAAC,MAAM,cAAc,CAAC;AAElD,oBAAY,SAAS,GAAG,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,GAAG,cAAc,CAAC;AACnE,oBAAY,aAAa,GAAG,QAAQ,CAAC;AAoBrC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,IAAI;IAUb;;;;;;;;;;;;;;;;;;;;OAoBG;;CAIL,CAAC"}

package/dist/es6/layout/lib/Grid.js

@@ -0,0 +1,90 @@
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+import * as React from 'react';
+import styled from '@emotion/styled';
+import { createComponent } from '@workday/canvas-kit-react/common';
+import { Box } from './Box';
+import { grid } from './utils/grid';
+var StyledGrid = styled(Box)({
+    display: 'grid',
+}, grid);
+var GridItem = createComponent('div')({
+    displayName: 'Grid.Item',
+    Component: function (_a, ref, Element) {
+        var children = _a.children, elemProps = __rest(_a, ["children"]);
+        return (React.createElement(Box, __assign({ as: Element, ref: ref }, elemProps), children));
+    },
+});
+/**
+ * `Grid` is a two-dimensional layout system for the web. It lets you lay content out in rows and columns.
+ * It is highly flexible, and can be used on its own or to build other components.
+ * `Grid` is built on top of `Box` and has access to all `BoxProps`.
+ *
+ * @example
+ * ```tsx
+ * import { Grid } from '@workday/canvas-kit-react/layout';
+ *
+ * interface CardProps extends GridProps {
+ *   // card-specific props
+ * }
+ *
+ * // `Card`'s default values are set using `GridProps`
+ * const Card = (props: CardProps) => (
+ *   <Grid gridAutoFlow="row" alignItems="start" depth={1} space="m" {...props}>
+ *     <h1>Hello, Card!</h1>
+ *     <p>This card uses grid to set its layout.</p>
+ *   </Grid>
+ * );
+ *```
+ */
+export var Grid = createComponent('div')({
+    displayName: 'Grid',
+    Component: function (_a, ref, Element) {
+        var children = _a.children, elemProps = __rest(_a, ["children"]);
+        return (React.createElement(StyledGrid, __assign({ as: Element, ref: ref }, elemProps), children));
+    },
+    subComponents: {
+        /**
+         * `<Grid.Item />` is the child specific sub-component to `<Grid/>`. `<Grid.Item />` gets child specific props, whereas `<Grid./>` gets parent container props.
+         *
+         * @example
+         * ```
+         * import { Grid } from '@workday/canvas-kit-react/layout';
+         * `Grid` is built on top of `Box` so `<Grid.Item />` gets all `BoxProps` as well.
+         *
+         * interface CardProps extends GridItemStyleProps {
+         *   // card-specific props
+         * }
+         *
+         * // `Card`'s default values are set using `GridItemStyleProps`
+         * const Card = (props: CardProps) => (
+         *   <Grid.Item gridRowStart="1" gridArea="Card" {...props}>
+         *     <h1>Hello, Card!</h1>
+         *     <p>This card uses grid child specific props to set its layout.</p>
+         *   </Grid.Item>
+         * );
+         *```
+         */
+        Item: GridItem,
+    },
+});

package/dist/es6/layout/lib/Layout.d.ts

@@ -1,29 +1,45 @@
 import * as React from 'react';
-import Column, { ColumnProps } from './Column';
-export interface LayoutProps {
+import { DeprecatedColumn, DeprecatedColumnProps } from './Column';
+/**
+ * ### Deprecated Layout Props
+ *
+ * As of Canvas Kit v8, Layout is being soft-deprecated.
+ * It will be hard-deprecated (completely removed) in v9. Please see the
+ * [upgrade guide](https://workday.github.io/canvas-kit/?path=/story/welcome-upgrade-guides-v8-0--page)
+ * for more information.
+ */
+export interface DeprecatedLayoutProps {
     /**
-     * The children of the Layout (cannot be empty).
+     * The children of the DeprecatedLayout (cannot be empty).
      */
-    children: React.ReactElement<ColumnProps>[] | React.ReactNode;
+    children: React.ReactElement<DeprecatedColumnProps>[] | React.ReactNode;
     /**
-     * The spacing of the Layout children.
+     * The spacing of the DeprecatedLayout children.
      */
     spacing?: number;
     /**
-     * The padding of the Layout's outside container.
+     * The padding of the DeprecatedLayout's outside container.
      * @default 12
      */
     gutter?: number | string;
     /**
-     * If true, set the max width of the Layout container to `1280px`.
+     * If true, set the max width of the DeprecatedLayout container to `1280px`.
      * @default false
      */
     capWidth?: boolean;
 }
-declare class Layout extends React.Component<LayoutProps> {
-    static Column: typeof Column;
+/**
+ * ### Deprecated Layout
+ *
+ * As of Canvas Kit v8, Layout is being soft-deprecated.
+ * It will be hard-deprecated (completely removed) in v9. Please see the
+ * [upgrade guide](https://workday.github.io/canvas-kit/?path=/story/welcome-upgrade-guides-v8-0--page)
+ * for more information.
+ */
+export declare class DeprecatedLayout extends React.Component<DeprecatedLayoutProps> {
+    componentDidMount(): void;
+    static Column: typeof DeprecatedColumn;
     private renderChild;
     render(): JSX.Element;
 }
-export default Layout;
 //# sourceMappingURL=Layout.d.ts.map

package/dist/es6/layout/lib/Layout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Layout.d.ts","sourceRoot":"","sources":["../../../../layout/lib/Layout.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,MAAM,EAAE,EAAC,WAAW,EAAC,MAAM,UAAU,CAAC;AAI7C,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC,WAAW,CAAC,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC;IAC9D;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAkCD,cAAM,MAAO,SAAQ,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC;IAC/C,OAAc,MAAM,gBAAU;IAE9B,OAAO,CAAC,WAAW,CAgBjB;IAEK,MAAM;CAed;AAID,eAAe,MAAM,CAAC"}
+{"version":3,"file":"Layout.d.ts","sourceRoot":"","sources":["../../../../layout/lib/Layout.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,EAAC,gBAAgB,EAAE,qBAAqB,EAAC,MAAM,UAAU,CAAC;AAIjE;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC,qBAAqB,CAAC,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC;IACxE;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAkCD;;;;;;;GAOG;AACH,qBAAa,gBAAiB,SAAQ,KAAK,CAAC,SAAS,CAAC,qBAAqB,CAAC;IAC1E,iBAAiB;IASjB,OAAc,MAAM,0BAAoB;IAExC,OAAO,CAAC,WAAW,CAgBjB;IAEK,MAAM;CAed"}

package/dist/es6/layout/lib/Layout.js

@@ -35,8 +35,8 @@ var __rest = (this && this.__rest) || function (s, e) {
 };
 import * as React from 'react';
 import styled from '@emotion/styled';
-import Column from './Column';
-import canvas, { spaceNumbers } from '@workday/canvas-kit-react/tokens';
+import { DeprecatedColumn } from './Column';
+import { canvas, spaceNumbers } from '@workday/canvas-kit-react/tokens';
 import isPropValid from '@emotion/is-prop-valid';
 var LayoutStyles = {
     classname: 'layout',
@@ -64,15 +64,23 @@ var LayoutContainer = styled('div', {
         margin: '0 auto',
     };
 });
-var Layout = /** @class */ (function (_super) {
-    __extends(Layout, _super);
-    function Layout() {
+/**
+ * ### Deprecated Layout
+ *
+ * As of Canvas Kit v8, Layout is being soft-deprecated.
+ * It will be hard-deprecated (completely removed) in v9. Please see the
+ * [upgrade guide](https://workday.github.io/canvas-kit/?path=/story/welcome-upgrade-guides-v8-0--page)
+ * for more information.
+ */
+var DeprecatedLayout = /** @class */ (function (_super) {
+    __extends(DeprecatedLayout, _super);
+    function DeprecatedLayout() {
         var _this = _super !== null && _super.apply(this, arguments) || this;
         _this.renderChild = function (child, spacing) {
             if (!React.isValidElement(child)) {
                 return;
             }
-            if (child.type === Column) {
+            if (child.type === DeprecatedColumn) {
                 var childProps = child.props;
                 if (childProps.spacing || childProps.spacing === 0) {
                     return child;
@@ -83,13 +91,16 @@ var Layout = /** @class */ (function (_super) {
         };
         return _this;
     }
-    Layout.prototype.render = function () {
+    DeprecatedLayout.prototype.componentDidMount = function () {
+        console.warn("This component is being deprecated and will be removed in Canvas Kit V9.\n\n      For more information, please see the V8 upgrade guide:\n\n      https://workday.github.io/canvas-kit/?path=/story/welcome-upgrade-guides-v8-0--page\n      ");
+    };
+    DeprecatedLayout.prototype.render = function () {
         var _this = this;
         var _a = this.props, _b = _a.gutter, gutter = _b === void 0 ? canvas.space.xs : _b, _c = _a.spacing, spacing = _c === void 0 ? spaceNumbers.xs : _c, children = _a.children, capWidth = _a.capWidth, elemProps = __rest(_a, ["gutter", "spacing", "children", "capWidth"]);
         return (React.createElement(LayoutContainer, __assign({ spacing: spacing, gutter: gutter, capWidth: capWidth }, elemProps), React.Children.map(children, function (child) { return _this.renderChild(child, spacing); })));
     };
-    Layout.Column = Column;
-    return Layout;
+    DeprecatedLayout.Column = DeprecatedColumn;
+    return DeprecatedLayout;
 }(React.Component));
-Layout.Column = Column;
-export default Layout;
+export { DeprecatedLayout };
+DeprecatedLayout.Column = DeprecatedColumn;

package/dist/es6/layout/lib/Stack.d.ts

@@ -1,8 +1,8 @@
 import { FlexProps } from './Flex';
 import { StackStyleProps } from './utils/stack';
 export declare type StackProps = FlexProps & StackStyleProps;
-export declare const Stack: import("../../common").ElementComponent<"div", import("..").BorderShorthandStyleProps & import("..").BorderColorStyleProps & import("..").BorderRadiusStyleProps & import("..").BorderLineStyleProps & import("..").BorderWidthStyleProps & import("..").BorderLogicalStyleProps & import("..").ColorStyleProps & import("..").DepthStyleProps & import("..").FlexItemStyleProps & import("..").LayoutStyleProps & import("./utils/other").OtherStyleProps & import("..").PositionStandardProps & import("..").PositionLogicalProps & import("./utils/space").SpaceStandardProps & import("./utils/space").SpaceLogicalProps & import("..").FlexStyleProps & StackStyleProps> & {
-    Item: import("../../common").ElementComponent<"div", import("..").BorderShorthandStyleProps & import("..").BorderColorStyleProps & import("..").BorderRadiusStyleProps & import("..").BorderLineStyleProps & import("..").BorderWidthStyleProps & import("..").BorderLogicalStyleProps & import("..").ColorStyleProps & import("..").DepthStyleProps & import("..").FlexItemStyleProps & import("..").LayoutStyleProps & import("./utils/other").OtherStyleProps & import("..").PositionStandardProps & import("..").PositionLogicalProps & import("./utils/space").SpaceStandardProps & import("./utils/space").SpaceLogicalProps>;
+export declare const Stack: import("../../common").ElementComponent<"div", StackProps> & {
+    Item: import("../../common").ElementComponent<"div", import("..").CommonStyleProps>;
 };
 export interface HStackProps extends StackProps {
     /**
@@ -12,7 +12,7 @@ export interface HStackProps extends StackProps {
     flexDirection?: 'row' | 'row-reverse';
 }
 export declare const HStack: import("../../common").ElementComponent<"div", HStackProps> & {
-    Item: import("../../common").ElementComponent<"div", import("..").BorderShorthandStyleProps & import("..").BorderColorStyleProps & import("..").BorderRadiusStyleProps & import("..").BorderLineStyleProps & import("..").BorderWidthStyleProps & import("..").BorderLogicalStyleProps & import("..").ColorStyleProps & import("..").DepthStyleProps & import("..").FlexItemStyleProps & import("..").LayoutStyleProps & import("./utils/other").OtherStyleProps & import("..").PositionStandardProps & import("..").PositionLogicalProps & import("./utils/space").SpaceStandardProps & import("./utils/space").SpaceLogicalProps>;
+    Item: import("../../common").ElementComponent<"div", import("..").CommonStyleProps>;
 };
 export interface VStackProps extends StackProps {
     /**
@@ -22,6 +22,6 @@ export interface VStackProps extends StackProps {
     flexDirection?: 'column' | 'column-reverse';
 }
 export declare const VStack: import("../../common").ElementComponent<"div", VStackProps> & {
-    Item: import("../../common").ElementComponent<"div", import("..").BorderShorthandStyleProps & import("..").BorderColorStyleProps & import("..").BorderRadiusStyleProps & import("..").BorderLineStyleProps & import("..").BorderWidthStyleProps & import("..").BorderLogicalStyleProps & import("..").ColorStyleProps & import("..").DepthStyleProps & import("..").FlexItemStyleProps & import("..").LayoutStyleProps & import("./utils/other").OtherStyleProps & import("..").PositionStandardProps & import("..").PositionLogicalProps & import("./utils/space").SpaceStandardProps & import("./utils/space").SpaceLogicalProps>;
+    Item: import("../../common").ElementComponent<"div", import("..").CommonStyleProps>;
 };
 //# sourceMappingURL=Stack.d.ts.map

package/dist/es6/layout/lib/Stack.js

@@ -55,8 +55,8 @@ export var Stack = createComponent('div')({
 export var HStack = createComponent('div')({
     displayName: 'HStack',
     Component: function (_a, ref, Element) {
-        var children = _a.children, elemProps = __rest(_a, ["children"]);
-        return (React.createElement(Stack, __assign({ as: Element, ref: ref, flexDirection: "row" }, elemProps), children));
+        var children = _a.children, _b = _a.flexDirection, flexDirection = _b === void 0 ? 'row' : _b, elemProps = __rest(_a, ["children", "flexDirection"]);
+        return (React.createElement(Stack, __assign({ as: Element, ref: ref, flexDirection: flexDirection }, elemProps), children));
     },
     subComponents: {
         Item: StackItem,
@@ -65,8 +65,8 @@ export var HStack = createComponent('div')({
 export var VStack = createComponent('div')({
     displayName: 'VStack',
     Component: function (_a, ref, Element) {
-        var children = _a.children, elemProps = __rest(_a, ["children"]);
-        return (React.createElement(Stack, __assign({ as: Element, ref: ref, flexDirection: "column" }, elemProps), children));
+        var children = _a.children, _b = _a.flexDirection, flexDirection = _b === void 0 ? 'column' : _b, elemProps = __rest(_a, ["children", "flexDirection"]);
+        return (React.createElement(Stack, __assign({ as: Element, ref: ref, flexDirection: flexDirection }, elemProps), children));
     },
     subComponents: {
         Item: StackItem,

package/dist/es6/layout/lib/utils/background.d.ts

@@ -0,0 +1,44 @@
+import { Property } from 'csstype';
+import { StyleFnConfig } from './buildStyleFns';
+import { SystemPropValues } from './systemProps';
+/** style props to set CSS background properties */
+export declare type BackgroundStyleProps = {
+    /**
+     * - sets [CSS background property](https://developer.mozilla.org/en-US/docs/Web/CSS/background)
+     * - system tokens: `color`
+     * */
+    background?: SystemPropValues['color'];
+    /** sets [CSS background-attachment property](https://developer.mozilla.org/en-US/docs/Web/CSS/) */
+    backgroundAttachment?: Property.BackgroundAttachment;
+    /**
+     * - sets [CSS background-color property](https://developer.mozilla.org/en-US/docs/Web/CSS/background-color)
+     * - system tokens: `color`
+     * */
+    backgroundColor?: SystemPropValues['color'];
+    /** sets [CSS background-image property](https://developer.mozilla.org/en-US/docs/Web/CSS/background-image) */
+    backgroundImage?: Property.BackgroundImage;
+    /** sets [CSS background-position property](https://developer.mozilla.org/en-US/docs/Web/CSS/background-position) */
+    backgroundPosition?: Property.BackgroundPosition;
+    /** sets [CSS background-repeat property](https://developer.mozilla.org/en-US/docs/Web/CSS/background-repeat) */
+    backgroundRepeat?: Property.BackgroundRepeat;
+    /** sets [CSS background-size property](https://developer.mozilla.org/en-US/docs/Web/CSS/background-size) */
+    backgroundSize?: Property.BackgroundSize;
+};
+export declare const backgroundStyleFnConfigs: StyleFnConfig[];
+export declare const backgroundFns: import("./buildStyleFns").StyleFns;
+/**
+ * A style prop function that takes component props and returns border styles.
+ * Some props, such as background and backgroundColor, are connected to our design tokens.
+ * If no `BackgroundStyleProps` are found, it returns an empty object.
+ *
+ * @example
+ * ```tsx
+ * const BackgroundExample = () => (
+ *   <Box backgroundColor="blueberry500">
+ *     Hello, background styles!
+ *   </Box>
+ * );
+ *```
+ */
+export declare const background: (props: BackgroundStyleProps) => {};
+//# sourceMappingURL=background.d.ts.map

package/dist/es6/layout/lib/utils/background.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background.d.ts","sourceRoot":"","sources":["../../../../../layout/lib/utils/background.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAC,MAAM,SAAS,CAAC;AAEjC,OAAO,EAAkC,aAAa,EAAC,MAAM,iBAAiB,CAAC;AAC/E,OAAO,EAAC,gBAAgB,EAAC,MAAM,eAAe,CAAC;AAE/C,mDAAmD;AACnD,oBAAY,oBAAoB,GAAG;IACjC;;;SAGK;IACL,UAAU,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACvC,mGAAmG;IACnG,oBAAoB,CAAC,EAAE,QAAQ,CAAC,oBAAoB,CAAC;IACrD;;;SAGK;IACL,eAAe,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC5C,8GAA8G;IAC9G,eAAe,CAAC,EAAE,QAAQ,CAAC,eAAe,CAAC;IAC3C,oHAAoH;IACpH,kBAAkB,CAAC,EAAE,QAAQ,CAAC,kBAAkB,CAAC;IACjD,gHAAgH;IAChH,gBAAgB,CAAC,EAAE,QAAQ,CAAC,gBAAgB,CAAC;IAC7C,4GAA4G;IAC5G,cAAc,CAAC,EAAE,QAAQ,CAAC,cAAc,CAAC;CAC1C,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,aAAa,EAoCnD,CAAC;AAEF,eAAO,MAAM,aAAa,oCAA0C,CAAC;AACrE;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,UAAU,qCAAwD,CAAC"}

package/dist/es6/layout/lib/utils/background.js

@@ -0,0 +1,54 @@
+import { buildStyleFns, buildStylePropFn } from './buildStyleFns';
+export var backgroundStyleFnConfigs = [
+    {
+        name: 'background',
+        properties: ['background'],
+        system: 'color',
+    },
+    {
+        name: 'backgroundAttachment',
+        properties: ['backgroundAttachment'],
+        system: 'none',
+    },
+    {
+        name: 'backgroundColor',
+        properties: ['backgroundColor'],
+        system: 'color',
+    },
+    {
+        name: 'backgroundImage',
+        properties: ['backgroundImage'],
+        system: 'none',
+    },
+    {
+        name: 'backgroundPosition',
+        properties: ['backgroundPosition'],
+        system: 'none',
+    },
+    {
+        name: 'backgroundRepeat',
+        properties: ['backgroundRepeat'],
+        system: 'none',
+    },
+    {
+        name: 'backgroundSize',
+        properties: ['backgroundSize'],
+        system: 'none',
+    },
+];
+export var backgroundFns = buildStyleFns(backgroundStyleFnConfigs);
+/**
+ * A style prop function that takes component props and returns border styles.
+ * Some props, such as background and backgroundColor, are connected to our design tokens.
+ * If no `BackgroundStyleProps` are found, it returns an empty object.
+ *
+ * @example
+ * ```tsx
+ * const BackgroundExample = () => (
+ *   <Box backgroundColor="blueberry500">
+ *     Hello, background styles!
+ *   </Box>
+ * );
+ *```
+ */
+export var background = buildStylePropFn(backgroundFns);