@workday/canvas-kit-react 8.0.0-alpha.254-next.23 → 8.0.0-alpha.428-next.2

package/dist/es6/common/lib/styles/errorRing.js

@@ -1,14 +1,13 @@
 import { ErrorType } from '../types';
 import { colors, inputColors } from '@workday/canvas-kit-react/tokens';
 import chroma from 'chroma-js';
-var isAccessible = function (foreground, background) {
-    if (background === void 0) { background = colors.frenchVanilla100; }
+const isAccessible = (foreground, background = colors.frenchVanilla100) => {
     return chroma.contrast(foreground, background) >= 3;
 };
 export function getErrorColors(error, theme) {
     if (error === ErrorType.Error) {
         if (theme) {
-            var palette = theme.canvas.palette.error;
+            const palette = theme.canvas.palette.error;
             return {
                 outer: isAccessible(palette.main) ? palette.main : palette.darkest,
                 inner: palette.main,
@@ -23,7 +22,7 @@ export function getErrorColors(error, theme) {
     }
     else if (error === ErrorType.Alert) {
         if (theme) {
-            var palette = theme.canvas.palette.alert;
+            const palette = theme.canvas.palette.alert;
             return {
                 outer: isAccessible(palette.main) ? palette.main : palette.darkest,
                 inner: palette.main,
@@ -44,8 +43,8 @@ export function errorRing(error, theme) {
     if (error !== ErrorType.Error && error !== ErrorType.Alert) {
         return {};
     }
-    var errorColors = getErrorColors(error, theme);
-    var errorBoxShadow = "inset 0 0 0 " + (errorColors.outer === errorColors.inner ? 1 : 2) + "px " + errorColors.inner;
+    const errorColors = getErrorColors(error, theme);
+    const errorBoxShadow = `inset 0 0 0 ${errorColors.outer === errorColors.inner ? 1 : 2}px ${errorColors.inner}`;
     return {
         borderColor: errorColors.outer,
         transition: '100ms box-shadow',
@@ -55,7 +54,9 @@ export function errorRing(error, theme) {
         },
         '&:focus:not([disabled])': {
             borderColor: errorColors.outer,
-            boxShadow: errorBoxShadow + ",\n        0 0 0 2px " + colors.frenchVanilla100 + ",\n        0 0 0 4px " + (theme ? theme.canvas.palette.common.focusOutline : inputColors.focusBorder),
+            boxShadow: `${errorBoxShadow},
+        0 0 0 2px ${colors.frenchVanilla100},
+        0 0 0 4px ${theme ? theme.canvas.palette.common.focusOutline : inputColors.focusBorder}`,
         },
     };
 }

package/dist/es6/common/lib/styles/focusRing.d.ts

@@ -12,10 +12,7 @@ interface FocusRingOptions {
     inset?: 'inner' | 'outer';
     innerColor?: string;
     outerColor?: string;
-    memoize?: boolean;
 }
-declare function calculateFocusRing({ width, separation, animate, inset, innerColor, outerColor, }: Required<Omit<FocusRingOptions, 'memoize' | 'inset'>> & Pick<FocusRingOptions, 'inset'>): CSSObject;
-export declare const memoizedFocusRing: typeof calculateFocusRing & import("lodash").MemoizedFunction;
 /**
  * A utility to create a canvas style focus ring around your widget.
  * By default, this mixin will create a 2px focus ring tightly wrapped

package/dist/es6/common/lib/styles/focusRing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"focusRing.d.ts","sourceRoot":"","sources":["../../../../../common/lib/styles/focusRing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,EAAE,SAAS,EAAC,MAAM,gBAAgB,CAAC;AAK3D,UAAU,gBAAgB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,iBAAS,kBAAkB,CAAC,EAC1B,KAAK,EACL,UAAU,EACV,OAAO,EACP,KAAK,EACL,UAAU,EACV,UAAU,GACX,EAAE,QAAQ,CAAC,IAAI,CAAC,gBAAgB,EAAE,SAAS,GAAG,OAAO,CAAC,CAAC,GACtD,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC,GAAG,SAAS,CAiC5C;AAED,eAAO,MAAM,iBAAiB,+DAAiE,CAAC;AAEhG;;;;;;;;;;;;;;GAcG;AAEH;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,gBAAqB,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,CA2BlF"}
+{"version":3,"file":"focusRing.d.ts","sourceRoot":"","sources":["../../../../../common/lib/styles/focusRing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,EAAE,SAAS,EAAC,MAAM,gBAAgB,CAAC;AAI3D,UAAU,gBAAgB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA6CD;;;;;;;;;;;;;;GAcG;AAEH;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,gBAAqB,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,CAsBlF"}

package/dist/es6/common/lib/styles/focusRing.js

@@ -1,43 +1,34 @@
 import { keyframes } from '@emotion/react';
 import { canvas } from '@workday/canvas-kit-react/tokens';
 import { defaultCanvasTheme } from '../theming/index';
-import memoize from 'lodash/memoize';
-function calculateFocusRing(_a) {
-    var width = _a.width, separation = _a.separation, animate = _a.animate, inset = _a.inset, innerColor = _a.innerColor, outerColor = _a.outerColor;
-    var boxShadow, innerWidth, outerWidth;
+function calculateFocusRing({ width, separation, animate, inset, innerColor, outerColor, }) {
+    let boxShadow, innerWidth, outerWidth;
     switch (inset) {
         case 'outer':
             innerWidth = width + separation;
             outerWidth = separation;
-            boxShadow = "inset 0 0 0 " + outerWidth + "px " + outerColor + ", inset 0 0 0 " + innerWidth + "px " + innerColor;
+            boxShadow = `inset 0 0 0 ${outerWidth}px ${outerColor}, inset 0 0 0 ${innerWidth}px ${innerColor}`;
             break;
         case 'inner':
             innerWidth = separation;
             outerWidth = width;
-            boxShadow = "inset 0 0 0 " + innerWidth + "px " + innerColor + ", 0 0 0 " + outerWidth + "px " + outerColor;
+            boxShadow = `inset 0 0 0 ${innerWidth}px ${innerColor}, 0 0 0 ${outerWidth}px ${outerColor}`;
             break;
         default:
             innerWidth = separation;
             outerWidth = width + separation;
-            boxShadow = "0 0 0 " + innerWidth + "px " + innerColor + ", 0 0 0 " + outerWidth + "px " + outerColor;
+            boxShadow = `0 0 0 ${innerWidth}px ${innerColor}, 0 0 0 ${outerWidth}px ${outerColor}`;
             break;
     }
     if (animate) {
-        var fadeIn = keyframes({
-            '0%': { boxShadow: boxShadow },
-            '100%': { boxShadow: boxShadow },
+        const fadeIn = keyframes({
+            '0%': { boxShadow },
+            '100%': { boxShadow },
         });
-        return { animation: fadeIn + " 100ms", boxShadow: boxShadow };
+        return { animation: `${fadeIn} 100ms`, boxShadow };
     }
-    return { boxShadow: boxShadow };
+    return { boxShadow };
 }
-export var memoizedFocusRing = memoize(calculateFocusRing, function () {
-    var args = [];
-    for (var _i = 0; _i < arguments.length; _i++) {
-        args[_i] = arguments[_i];
-    }
-    return JSON.stringify(args);
-});
 /**
  * A utility to create a canvas style focus ring around your widget.
  * By default, this mixin will create a 2px focus ring tightly wrapped
@@ -60,21 +51,17 @@ export var memoizedFocusRing = memoize(calculateFocusRing, function () {
  *
  * @returns {CSSObject} the css object for the focus ring style
  */
-export function focusRing(options, theme) {
-    if (options === void 0) { options = {}; }
-    var _a = options.width, width = _a === void 0 ? 2 : _a, _b = options.separation, separation = _b === void 0 ? 0 : _b, _c = options.animate, animate = _c === void 0 ? true : _c, _d = options.innerColor, innerColor = _d === void 0 ? canvas.colors.frenchVanilla100 : _d, _e = options.outerColor, outerColor = _e === void 0 ? theme && theme.canvas
+export function focusRing(options = {}, theme) {
+    const { width = 2, separation = 0, animate = true, innerColor = canvas.colors.frenchVanilla100, outerColor = theme && theme.canvas
         ? theme.canvas.palette.common.focusOutline
-        : defaultCanvasTheme.palette.common.focusOutline : _e, _f = options.memoize, memoize = _f === void 0 ? true : _f, inset = options.inset;
-    var args = {
+        : defaultCanvasTheme.palette.common.focusOutline, inset, } = options;
+    const args = {
         width: width,
         separation: separation,
         innerColor: innerColor,
         outerColor: outerColor,
-        animate: animate,
-        inset: inset,
+        animate,
+        inset,
     };
-    if (memoize) {
-        return memoizedFocusRing(args);
-    }
     return calculateFocusRing(args);
 }

package/dist/es6/common/lib/styles/hideMouseFocus.js

@@ -1,15 +1,16 @@
-var _a;
 /**
  * A utility to hide the default canvas style focus ring when using mouse input.
  * Requires wrapping your components in an InputProvider component.
  */
-export var hideMouseFocus = (_a = {},
-    _a["[data-whatinput=\"mouse\"] &:focus,\n    [data-whatinput=\"touch\"] &:focus,\n    [data-whatinput=\"pointer\"] &:focus"] = {
+export const hideMouseFocus = {
+    [`[data-whatinput="mouse"] &:focus,
+    [data-whatinput="touch"] &:focus,
+    [data-whatinput="pointer"] &:focus`]: {
         outline: 'none',
         boxShadow: 'none',
         animation: 'none',
     },
-    _a);
+};
 /*
  * A utility that simplifies focus selectors since you can't use nested syntax for some reason. Example:
  * [`[data-whatinput="mouse"],
@@ -20,11 +21,14 @@ export var hideMouseFocus = (_a = {},
        }
    },
  */
-export var mouseFocusBehavior = function (selectors) {
-    var output = {};
-    Object.keys(selectors).map(function (selector, index) {
-        selector.split(',').forEach(function (selectorPart) {
-            var prefixedSelector = "\n        [data-whatinput=\"mouse\"] " + selectorPart + ",\n        [data-whatinput=\"touch\"] " + selectorPart + ",\n        [data-whatinput=\"pointer\"] " + selectorPart;
+export const mouseFocusBehavior = (selectors) => {
+    const output = {};
+    Object.keys(selectors).map((selector, index) => {
+        selector.split(',').forEach(selectorPart => {
+            const prefixedSelector = `
+        [data-whatinput="mouse"] ${selectorPart},
+        [data-whatinput="touch"] ${selectorPart},
+        [data-whatinput="pointer"] ${selectorPart}`;
             output[prefixedSelector] = selectors[selector];
         });
     });

package/dist/es6/common/lib/theming/breakpoints.js

@@ -6,7 +6,7 @@ export var BreakpointKey;
     BreakpointKey["l"] = "l";
     BreakpointKey["xl"] = "xl";
 })(BreakpointKey || (BreakpointKey = {}));
-export var breakpointKeys = ['zero', 's', 'm', 'l', 'xl'];
+export const breakpointKeys = ['zero', 's', 'm', 'l', 'xl'];
 /**
  * ### Theme Breakpoint Values
  *
@@ -30,14 +30,14 @@ export var breakpointKeys = ['zero', 's', 'm', 'l', 'xl'];
  * Note: Some applications may only require a subset of screen sizes and not use all breakpoints.
  *
  */
-export var breakpoints = {
+export const breakpoints = {
     zero: 0,
     s: 320,
     m: 768,
     l: 1024,
     xl: 1440,
 };
-var step = 0.5;
+const step = 0.5;
 /**
  * ### Up
  *
@@ -62,8 +62,8 @@ var step = 0.5;
  * ```
  */
 export function up(key) {
-    var value = typeof breakpoints[key] === 'number' ? breakpoints[key] : key;
-    return "@media (min-width: " + value + "px)";
+    const value = typeof breakpoints[key] === 'number' ? breakpoints[key] : key;
+    return `@media (min-width: ${value}px)`;
 }
 /**
  * ### Down
@@ -111,14 +111,14 @@ export function up(key) {
  * ```
  */
 export function down(endKey) {
-    var endIndex = breakpointKeys.indexOf(endKey) + 1;
-    var upperbound = breakpoints[breakpointKeys[endIndex]];
+    const endIndex = breakpointKeys.indexOf(endKey) + 1;
+    const upperbound = breakpoints[breakpointKeys[endIndex]];
     if (endIndex === breakpointKeys.length) {
         // xl down applies to all sizes
         return up(BreakpointKey.zero);
     }
-    var value = typeof upperbound === 'number' && endIndex > 0 ? upperbound : 0;
-    return "@media (max-width: " + (value - step) + "px)";
+    const value = typeof upperbound === 'number' && endIndex > 0 ? upperbound : 0;
+    return `@media (max-width: ${value - step}px)`;
 }
 /**
  * ### Between
@@ -167,12 +167,12 @@ export function down(endKey) {
  * ```
  */
 export function between(start, end) {
-    var endIndex = breakpointKeys.indexOf(end) + 1;
+    const endIndex = breakpointKeys.indexOf(end) + 1;
     if (endIndex === breakpointKeys.length) {
         return up(start);
     }
-    return ("@media (min-width: " + breakpoints[start] + "px) and " +
-        ("(max-width: " + (breakpoints[breakpointKeys[endIndex]] - step) + "px)"));
+    return (`@media (min-width: ${breakpoints[start]}px) and ` +
+        `(max-width: ${breakpoints[breakpointKeys[endIndex]] - step}px)`);
 }
 /**
  * ### Only

package/dist/es6/common/lib/theming/createCanvasTheme.d.ts

@@ -1,10 +1,11 @@
 import { CanvasTheme, PartialCanvasTheme } from './types';
-export declare enum ColorDirection {
-    Darken = 0,
-    Brighten = 1
-}
-export declare function shiftColor(hexColor: string, direction: ColorDirection): string;
+export declare const shiftColor: (hexColor: string, amount?: any) => string;
 declare function calculateCanvasTheme(partialTheme: PartialCanvasTheme): CanvasTheme;
-export declare const createCanvasTheme: typeof calculateCanvasTheme & import("lodash").MemoizedFunction;
+/**
+ * Creates a full {@link CanvasTheme} from any partial theme by deeply merging with the
+ * `defaultCanvasTheme` object. The function is memoized, but it is best to run this function
+ * only once and save the result.
+ */
+export declare const createCanvasTheme: typeof calculateCanvasTheme;
 export {};
 //# sourceMappingURL=createCanvasTheme.d.ts.map

package/dist/es6/common/lib/theming/createCanvasTheme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createCanvasTheme.d.ts","sourceRoot":"","sources":["../../../../../common/lib/theming/createCanvasTheme.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,WAAW,EACX,kBAAkB,EAInB,MAAM,SAAS,CAAC;AAIjB,oBAAY,cAAc;IACxB,MAAM,IAAA;IACN,QAAQ,IAAA;CACT;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,UA4BrE;AAuCD,iBAAS,oBAAoB,CAAC,YAAY,EAAE,kBAAkB,GAAG,WAAW,CAkB3E;AAED,eAAO,MAAM,iBAAiB,iEAAmE,CAAC"}
+{"version":3,"file":"createCanvasTheme.d.ts","sourceRoot":"","sources":["../../../../../common/lib/theming/createCanvasTheme.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,WAAW,EACX,kBAAkB,EAInB,MAAM,SAAS,CAAC;AAQjB,eAAO,MAAM,UAAU,aACV,MAAM,yBA+BlB,CAAC;AA+BF,iBAAS,oBAAoB,CAAC,YAAY,EAAE,kBAAkB,GAAG,WAAW,CAkB3E;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,6BAAmE,CAAC"}

package/dist/es6/common/lib/theming/createCanvasTheme.js

@@ -1,99 +1,75 @@
-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 chroma from 'chroma-js';
-import merge from 'lodash/merge';
-import memoize from 'lodash/memoize';
-import findKey from 'lodash/findKey';
 import colors from '@workday/canvas-colors-web';
 import { defaultCanvasTheme } from './theme';
 import { ContentDirection, } from './types';
 import { pickForegroundColor } from '../utils';
-export var ColorDirection;
-(function (ColorDirection) {
-    ColorDirection[ColorDirection["Darken"] = 0] = "Darken";
-    ColorDirection[ColorDirection["Brighten"] = 1] = "Brighten";
-})(ColorDirection || (ColorDirection = {}));
-export function shiftColor(hexColor, direction) {
-    var canvasColor = findKey(colors, function (color) { return color === hexColor; });
-    var darken = direction === ColorDirection.Darken;
+// Should these be exported?
+import { deepMerge } from '../utils/deepMerge';
+import { memoize } from '../utils/memoize';
+export const shiftColor = memoize((hexColor, amount = 100) => {
+    const canvasColor = Object.keys(colors).find(color => colors[color] === hexColor);
     if (canvasColor) {
-        var colorRegex = /([a-zAz]*)(\d{3})/g;
-        var match = colorRegex.exec(canvasColor);
+        const colorRegex = /([a-zAz]*)(\d{3})/g;
+        const match = colorRegex.exec(canvasColor);
         if (match) {
-            var baseColor = match[1];
-            var shadeNumber = parseInt(match[2], 10);
-            var newShade = darken ? shadeNumber + 100 : shadeNumber - 100;
+            const baseColor = match[1];
+            const shadeNumber = parseInt(match[2], 10);
+            const newShade = shadeNumber + amount;
             if (newShade >= 100 && newShade <= 600) {
                 return colors[(baseColor + newShade)];
             }
         }
     }
     try {
-        var newColor = darken ? chroma(hexColor).darken() : chroma(hexColor).brighten();
+        const newColor = amount > 0
+            ? chroma(hexColor).darken(amount / 100)
+            : chroma(hexColor).brighten(-amount / 100);
         return newColor.hex();
     }
     catch (e) {
-        console.warn("Invalid color '" + hexColor + "' used in theme");
+        console.warn(`Invalid color '${hexColor}' used in theme`);
         return hexColor;
     }
-}
+}, (color, value) => `${color}.${value}`);
 function fillPalette(defaultPalette, palette) {
     if (!palette) {
         return {};
     }
-    var main = palette.main || defaultPalette.main;
-    var dark = palette.dark ||
-        (palette.main && shiftColor(palette.main, ColorDirection.Darken)) ||
-        defaultPalette.dark;
-    var darkest = palette.darkest ||
-        (palette.main && shiftColor(dark, ColorDirection.Darken)) ||
-        defaultPalette.darkest;
-    var light = palette.light ||
-        (palette.main && shiftColor(palette.main, ColorDirection.Brighten)) ||
-        defaultPalette.light;
-    var lightest = palette.lightest ||
-        (palette.main && shiftColor(light, ColorDirection.Brighten)) ||
-        defaultPalette.lightest;
-    var contrast = palette.contrast || pickForegroundColor(main) || defaultPalette.contrast;
+    const main = palette.main || defaultPalette.main;
+    const dark = palette.dark || (palette.main && shiftColor(palette.main, 100)) || defaultPalette.dark;
+    const darkest = palette.darkest || (palette.main && shiftColor(palette.main, 200)) || defaultPalette.darkest;
+    const light = palette.light || (palette.main && shiftColor(palette.main, -100)) || defaultPalette.light;
+    const lightest = palette.lightest || (palette.main && shiftColor(palette.main, -200)) || defaultPalette.lightest;
+    const contrast = palette.contrast || pickForegroundColor(main) || defaultPalette.contrast;
     return {
-        lightest: lightest,
-        light: light,
-        main: main,
-        dark: dark,
-        darkest: darkest,
-        contrast: contrast,
+        lightest,
+        light,
+        main,
+        dark,
+        darkest,
+        contrast,
     };
 }
 function calculateCanvasTheme(partialTheme) {
-    var _a = partialTheme.palette, palette = _a === void 0 ? {} : _a, _b = partialTheme.breakpoints, breakpoints = _b === void 0 ? {} : _b, direction = partialTheme.direction, extraFields = __rest(partialTheme, ["palette", "breakpoints", "direction"]);
-    var _c = palette, primary = _c.primary, alert = _c.alert, error = _c.error, success = _c.success, neutral = _c.neutral, _d = _c.common, common = _d === void 0 ? {} : _d;
-    var mergeable = {
+    const { palette = {}, breakpoints = {}, direction, ...extraFields } = partialTheme;
+    const { primary, alert, error, success, neutral, common = {} } = palette;
+    const mergeable = {
         palette: {
-            common: common,
+            common,
             primary: fillPalette(defaultCanvasTheme.palette.primary, primary),
             alert: fillPalette(defaultCanvasTheme.palette.alert, alert),
             error: fillPalette(defaultCanvasTheme.palette.error, error),
             success: fillPalette(defaultCanvasTheme.palette.success, success),
             neutral: fillPalette(defaultCanvasTheme.palette.neutral, neutral),
         },
-        breakpoints: breakpoints,
+        breakpoints,
         direction: direction === ContentDirection.RTL ? direction : ContentDirection.LTR,
     };
-    return merge({}, defaultCanvasTheme, mergeable, extraFields);
+    return deepMerge(deepMerge({}, defaultCanvasTheme), { ...mergeable, ...extraFields });
 }
-export var createCanvasTheme = memoize(calculateCanvasTheme, function () {
-    var args = [];
-    for (var _i = 0; _i < arguments.length; _i++) {
-        args[_i] = arguments[_i];
-    }
-    return JSON.stringify(args);
-});
+/**
+ * Creates a full {@link CanvasTheme} from any partial theme by deeply merging with the
+ * `defaultCanvasTheme` object. The function is memoized, but it is best to run this function
+ * only once and save the result.
+ */
+export const createCanvasTheme = memoize(calculateCanvasTheme, (...args) => JSON.stringify(args));

package/dist/es6/common/lib/theming/getObjectProxy.d.ts

@@ -0,0 +1,15 @@
+/**
+ * For custom themes that do not overwrite every default.
+ */
+export declare type RecursivePartial<T> = {
+    [P in keyof T]?: RecursivePartial<T[P]>;
+};
+/**
+ * The functions gets a new object proxy. This is used for theme to ensure regardless of a partial theme object
+ * there will be a fallback theme object so that properties aren't undefined regardless of the `target` object.
+ * This function will also handle nested properties.
+ * @param target A partial object with up to the same shape as the `fallback` object
+ * @param fallback A fallback object. If a property to be accessed from the proxy is not available on the target object, the fallback object will be used
+ */
+export declare function getObjectProxy<T extends {}>(target: RecursivePartial<T> | undefined, fallback: T): T;
+//# sourceMappingURL=getObjectProxy.d.ts.map

package/dist/es6/common/lib/theming/getObjectProxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getObjectProxy.d.ts","sourceRoot":"","sources":["../../../../../common/lib/theming/getObjectProxy.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,gBAAgB,CAAC,CAAC,IAAI;KAC/B,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACxC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,EAAE,EACzC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,SAAS,EACvC,QAAQ,EAAE,CAAC,GACV,CAAC,CAmBH"}

package/dist/es6/common/lib/theming/getObjectProxy.js

@@ -0,0 +1,27 @@
+/**
+ * The functions gets a new object proxy. This is used for theme to ensure regardless of a partial theme object
+ * there will be a fallback theme object so that properties aren't undefined regardless of the `target` object.
+ * This function will also handle nested properties.
+ * @param target A partial object with up to the same shape as the `fallback` object
+ * @param fallback A fallback object. If a property to be accessed from the proxy is not available on the target object, the fallback object will be used
+ */
+export function getObjectProxy(target, fallback) {
+    if (target) {
+        return new Proxy(target, {
+            get(target, prop, receiver) {
+                if (typeof fallback[prop] === 'object') {
+                    return getObjectProxy(target[prop], fallback[prop]);
+                }
+                const targetProp = target[prop];
+                if (targetProp !== undefined) {
+                    return targetProp;
+                }
+                return Reflect.get(fallback, prop, receiver);
+            },
+            ownKeys() {
+                return Reflect.ownKeys(fallback);
+            },
+        });
+    }
+    return fallback;
+}

package/dist/es6/common/lib/theming/index.d.ts

@@ -4,5 +4,7 @@ export * from './types';
 export { default as styled, StyleRewriteFn } from './styled';
 export * from './theme';
 export * from './useTheme';
+export * from './useThemedRing';
 export * from './useIsRTL';
+export * from './getObjectProxy';
 //# sourceMappingURL=index.d.ts.map

package/dist/es6/common/lib/theming/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../common/lib/theming/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAC,iBAAiB,EAAC,MAAM,qBAAqB,CAAC;AACtD,cAAc,SAAS,CAAC;AACxB,OAAO,EAAC,OAAO,IAAI,MAAM,EAAE,cAAc,EAAC,MAAM,UAAU,CAAC;AAC3D,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../common/lib/theming/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAC,iBAAiB,EAAC,MAAM,qBAAqB,CAAC;AACtD,cAAc,SAAS,CAAC;AACxB,OAAO,EAAC,OAAO,IAAI,MAAM,EAAE,cAAc,EAAC,MAAM,UAAU,CAAC;AAC3D,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC"}

package/dist/es6/common/lib/theming/index.js

@@ -4,4 +4,6 @@ export * from './types';
 export { default as styled } from './styled';
 export * from './theme';
 export * from './useTheme';
+export * from './useThemedRing';
 export * from './useIsRTL';
+export * from './getObjectProxy';

package/dist/es6/common/lib/theming/styled.js

@@ -1,18 +1,14 @@
 import { default as emotionStyled } from '@emotion/styled';
 import { useTheme, ContentDirection } from './index';
 import rtlCSSJS from 'rtl-css-js';
-var noop = function (styles) { return styles; };
+const noop = (styles) => styles;
 function styled(node) {
-    return function () {
-        var args = [];
-        for (var _i = 0; _i < arguments.length; _i++) {
-            args[_i] = arguments[_i];
-        }
-        var newArgs = args.map(function (interpolation) { return function (props) {
+    return (...args) => {
+        const newArgs = args.map(interpolation => (props) => {
             props.theme = useTheme(props.theme);
-            var direction = props.theme.canvas.direction;
-            var maybeFlip = direction === ContentDirection.RTL ? rtlCSSJS : noop;
-            var maybeConvert = props.theme._styleRewriteFn || noop;
+            const direction = props.theme.canvas.direction;
+            const maybeFlip = direction === ContentDirection.RTL ? rtlCSSJS : noop;
+            const maybeConvert = props.theme._styleRewriteFn || noop;
             try {
                 if (typeof interpolation === 'function') {
                     return maybeFlip(maybeConvert(interpolation(props)));
@@ -22,7 +18,7 @@ function styled(node) {
             catch (e) {
                 return maybeConvert(interpolation);
             }
-        }; });
+        });
         return emotionStyled(node)(newArgs);
     };
 }

package/dist/es6/common/lib/theming/theme.js

@@ -1,7 +1,7 @@
 import colors from '@workday/canvas-colors-web';
 import { ContentDirection } from './types';
 import { breakpoints, up, down, between, only } from './breakpoints';
-export var defaultCanvasTheme = {
+export const defaultCanvasTheme = {
     palette: {
         primary: {
             lightest: colors.blueberry100,
@@ -49,10 +49,10 @@ export var defaultCanvasTheme = {
     },
     breakpoints: {
         values: breakpoints,
-        up: up,
-        down: down,
-        between: between,
-        only: only,
+        up,
+        down,
+        between,
+        only,
     },
     direction: ContentDirection.LTR,
 };

package/dist/es6/common/lib/theming/useIsRTL.js

@@ -10,7 +10,7 @@ function useDefaultTheme(theme, config, fn) {
  * @example
  * const isRTL = useIsRTL();
  */
-export var useIsRTL = function (partialTheme) {
-    var theme = useDefaultTheme(partialTheme, ThemeContext, React.useContext);
+export const useIsRTL = (partialTheme) => {
+    const theme = useDefaultTheme(partialTheme, ThemeContext, React.useContext);
     return (theme && theme.canvas && theme.canvas.direction) === ContentDirection.RTL;
 };

package/dist/es6/common/lib/theming/useTheme.d.ts

@@ -1,11 +1,47 @@
 import { EmotionCanvasTheme, PartialEmotionCanvasTheme } from './index';
 /**
- * Hook function to get the correct theme object.
- * @param {Object=} theme - The theme object returned from the emotion ThemeContext
- * (through ThemeProvider). The Canvas Kit theme is namespaced within this variable under the `canvas` key.
+ * Function to get the correct theme object for `styled` and class components
+ * or to be used outside component.
+ * @param {Object=} theme - The theme object with the Canvas Kit theme.
+ * It should be namespaced within this variable under the `canvas` key.
+ * Value of `canvas` property is any partial or full theme object to overwtite default theme.
  *
- * NOTE: If you are using a class component, you MUST pass the theme.
- * If not passed, the function will try to pull the theme from ThemeContext.
+ * @returns An object containing updated or default Canvas Kit theme under `canvas` key.
+ *
+ * The passed partial theme object will be merged with the default Canvas theme
+ * (using memoized createCanvasTheme()) to establish any missing fields that have
+ * not been defined by the consumer's theme object.
+ *
+ * If theme is not passed, the function will try to retrieve it from the window object.
+ * If window theme is not found, it will return the default Canvas theme.
+ *
+ * @example
+ * import {getTheme} from '@workday/canvas-kit-react/common';
+ *
+ * const theme = getTheme();
+ * const {up, down} = theme.canvas.breakpoints;
+ * const small = down('m'); // Returns '@media (max-width: 768px)'
+ * const medium = up('m'); // Returns '@media (min-width: 768px)'
+ *
+ * const styles = {
+ *  [small]: {
+ *    margin: space.m
+ *  },
+ *  [medium]: {
+ *    margin: space.l
+ *  }
+ * }
+ */
+export declare function getTheme(theme?: PartialEmotionCanvasTheme): EmotionCanvasTheme;
+/**
+ * Hook function to get the correct theme object for functional components.
+ * @param {Object=} theme - The theme object with the Canvas Kit theme.
+ * It should be namespaced within this variable under the `canvas` key.
+ * Value of `canvas` property is any partial or full theme object to overwtite default theme.
+ *
+ * @returns An object containing updated or default Canvas Kit theme under `canvas` key.
+ *
+ * NOTE: If theme is not passed, the function will try to pull the theme from ThemeContext.
  * If that does not work, it will try to retrieve it from the window object.
  * As a last resort, it will return the default Canvas theme.
  *
@@ -16,6 +52,14 @@ import { EmotionCanvasTheme, PartialEmotionCanvasTheme } from './index';
  * Providing the default theme here is currently a work around for when no
  * ThemeProvider or context exists.
  * Tracked on https://github.com/emotion-js/emotion/issues/1193.
+ *
+ * @example
+ * export const ErrorMessage = () => {
+ *  const theme = useTheme();
+ *  return (
+ *    <Subtext size="large" color={theme.canvas.palette.error.main}>
+ *  );
+ * }
  */
 export declare function useTheme(theme?: PartialEmotionCanvasTheme): EmotionCanvasTheme;
 //# sourceMappingURL=useTheme.d.ts.map