@procore/core-react 10.21.0-rc.27 → 10.21.0-rc.31

package/dist/esm/components/TieredSelect/TieredSelect.d.ts

@@ -9,5 +9,19 @@ export declare const useHighlightItemEffects: ({ currentTier, searchValue, menuR
     loadingMore: TieredSelectProps['loadingMore'];
 }) => void;
 export declare const TieredSelectContext: React.Context<TieredSelectApi>;
+/**
+
+ We use tiered selects to allow users to choose a single parent or child option
+ that is nested within a tiered list. For example, choosing a location from
+ within a list of tiered locations. We typically see these selects on forms.
+
+ Other select components are group select, multi select, and select.
+ @since 10.19.0
+
+ @see [Storybook](https://procore.github.io/core/latest/?path=/story/tieredselect--basic)
+
+ @see [Design Guidelines](https://design.procore.com/tiered-select)
+
+ */
 export declare const TieredSelect: React.ForwardRefExoticComponent<TieredSelectProps & React.RefAttributes<HTMLDivElement>>;
 export default TieredSelect;

package/dist/esm/components/TieredSelect/TieredSelect.js

@@ -101,6 +101,20 @@ export var TieredSelectContext = React.createContext({
     i18nScope: 'core.tieredSelect',
     onChange: noop,
 });
+/**
+
+ We use tiered selects to allow users to choose a single parent or child option
+ that is nested within a tiered list. For example, choosing a location from
+ within a list of tiered locations. We typically see these selects on forms.
+
+ Other select components are group select, multi select, and select.
+ @since 10.19.0
+
+ @see [Storybook](https://procore.github.io/core/latest/?path=/story/tieredselect--basic)
+
+ @see [Design Guidelines](https://design.procore.com/tiered-select)
+
+ */
 export var TieredSelect = React.forwardRef(function TieredSelect(_a, ref) {
     var _b = _a.afterHide, afterHide = _b === void 0 ? noop : _b, _c = _a.afterShow, afterShow = _c === void 0 ? noop : _c, _d = _a.beforeHide, beforeHide = _d === void 0 ? always : _d, _e = _a.beforeShow, beforeShow = _e === void 0 ? always : _e, block = _a.block, _f = _a.getGroupId, getGroupId = _f === void 0 ? defaultGetGroupId : _f, _g = _a.getId, getId = _g === void 0 ? defaultGetId : _g, _h = _a.getLabel, getLabel = _h === void 0 ? defaultGetLabel : _h, _j = _a.getNextGroupId, getNextGroupId = _j === void 0 ? defaultGetNextGroupId : _j, _k = _a.getValueString, getValueString = _k === void 0 ? getFullPath(getLabel) : _k, _l = _a.i18nScope, i18nScope = _l === void 0 ? 'core.tieredSelect' : _l, _m = _a.onChange, onChange = _m === void 0 ? noop : _m, onClear = _a.onClear, onNavigate = _a.onNavigate, onQuickCreate = _a.onQuickCreate, onScrollBottom = _a.onScrollBottom, onSearch = _a.onSearch, _o = _a.selectableTiers, selectableTiers = _o === void 0 ? true : _o, tabIndex = _a.tabIndex, props = __rest(_a, ["afterHide", "afterShow", "beforeHide", "beforeShow", "block", "getGroupId", "getId", "getLabel", "getNextGroupId", "getValueString", "i18nScope", "onChange", "onClear", "onNavigate", "onQuickCreate", "onScrollBottom", "onSearch", "selectableTiers", "tabIndex"]);
     var isLeaf = React.useCallback(function (tier) {

package/dist/esm/components/TieredSelect/TieredSelect.js.map

@@ -1 +1 @@
-{"version":3,"file":"TieredSelect.js","sourceRoot":"","sources":["../../../../src/components/TieredSelect/TieredSelect.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"TieredSelect.js","sourceRoot":"","sources":["../../../../src/components/TieredSelect/TieredSelect.tsx"],"names":[],"mappings":"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"}

package/dist/esm/components/TieredSelect/TieredSelect.types.d.ts

@@ -5,50 +5,102 @@ export declare type GetValueString = 'full-path' | 'leaf-only' | GetValueStringF
 export declare type Div = React.ComponentPropsWithoutRef<'div'>;
 export declare type Id = number | string | null | undefined;
 export interface Tier {
+    /**
+     * @since 10.19.0
+     */
     id?: Id;
+    /**
+     * @since 10.19.0
+     */
     label?: string;
+    /**
+     * @since 10.19.0
+     */
     nextGroupId?: Id;
+    /**
+     * @since 10.19.0
+     */
     groupId?: Id;
 }
 export interface TierSelection extends Selection {
+    /**
+     * @since 10.19.0
+     */
     value: any[];
 }
 export interface InternalTieredSelectProps extends Omit<Div, 'onSelect' | 'onChange'> {
+    /**
+     * @since 10.19.0
+     */
     block?: SelectProps['block'];
+    /**
+     * @since 10.19.0
+     */
     disabled?: SelectProps['disabled'];
+    /**
+     * @since 10.19.0
+     */
     error?: SelectProps['error'];
+    /**
+     * @since 10.19.0
+     */
     loading?: SelectProps['loading'];
+    /**
+     * @since 10.19.0
+     */
     options?: any[];
+    /**
+     * @since 10.19.0
+     */
     value?: any[];
 }
 export interface TieredSelectApi {
+    /**
+     * @since 10.19.0
+     */
     afterHide: SelectProps['afterHide'];
+    /**
+     * @since 10.19.0
+     */
     afterShow: SelectProps['afterShow'];
+    /**
+     * @since 10.19.0
+     */
     beforeHide: SelectProps['beforeHide'];
+    /**
+     * @since 10.19.0
+     */
     beforeShow: SelectProps['beforeShow'];
+    /**
+     * @since 10.19.0
+     */
     block?: boolean;
     /**
      * Callback for using a custom <Code>tier</Code> shape
      * <CodeBlock>{'(tier: any) => Id'}</CodeBlock>
      * Defaults to <CodeBlock>{'(tier: any) => tier.GroupId'}</CodeBlock>
+     * @since 10.19.0
      */
     getGroupId: (tier: any) => Id;
     /**
      * Callback for using a custom <Code>tier</Code> shape
      * <CodeBlock>{'(tier: any) => Id'}</CodeBlock>
      * Defaults to <CodeBlock>{'(tier: any) => tier.Id'}</CodeBlock>
+     * @since 10.19.0
      */
     getId: (tier: any) => Id;
     /**
      * Callback for using a custom <Code>tier</Code> shape
      * <CodeBlock>{'(tier: any) => string'}</CodeBlock>
      * Defaults to <CodeBlock>{'(tier: any) => tier.Label'}</CodeBlock>
+     * @since 10.19.0
      */
     getLabel: (tier: any) => string | undefined;
     /**
      * Callback for using a custom <Code>tier</Code> shape
      * <CodeBlock>{'(tier: any) => Id'}</CodeBlock>
      * Defaults to <CodeBlock>{'(tier: any) => tier.NextGroupId'}</CodeBlock>
+     * @since 10.19.0
      */
     getNextGroupId: (tier: any) => Id;
     /**
@@ -61,19 +113,29 @@ export interface TieredSelectApi {
      *     '(value: any[]) => value.map((tier) => getLabel!(tier)).join(" > ")'
      * }
      * </CodeBlock>
+     * @since 10.19.0
      */
     getValueString: GetValueStringFn;
     /**
-     * The i18n key to use for the tiered select's configurable strings. Defaults to using the core library's default strings.
+     * The i18n key to use for the tiered select's configurable strings.
+     * Defaults to using the core library's default strings.
+     * @since 10.19.0
      */
     i18nScope: string;
+    /**
+     * @since 10.19.0
+     */
     isTierDisabled?: (tier: any) => boolean | string | undefined;
+    /**
+     * @since 10.19.0
+     */
     isLeaf?: (tier: any) => boolean;
     /**
      * Used to display a loading indicator as the last item of the list. Can
      * be used with <Code>onScrollBottom</Code> or <Code>onSearch</Code>{' '}
      * (empty <Code>options</Code> during search async call) to indicate the
      * loading of new items.
+     * @since 10.19.0
      */
     loadingMore?: boolean;
     /**
@@ -85,11 +147,13 @@ export interface TieredSelectApi {
      * <CodeBlock>
      *  {'(Selection: { event, item, group }, value) =>'}
      * </CodeBlock>
+     * @since 10.19.0
      */
     onChange: (selection: TierSelection) => void;
     /**
      * Callback for when the x icon is pressed.
      * <CodeBlock>{'(event) =>'}</CodeBlock>
+     * @since 10.19.0
      */
     onClear?: SelectProps['onClear'];
     /**
@@ -99,6 +163,7 @@ export interface TieredSelectApi {
      * <CodeBlock>
      *  {'(nextGroupId: string | number | undefined, path: any[]) => '}
      * </CodeBlock>
+     * @since 10.19.0
      */
     onNavigate?: (nextGroupId: Id, value: any[]) => void;
     /**
@@ -106,6 +171,7 @@ export interface TieredSelectApi {
      * when the "create" button in quick create mode is clicked. Returns the
      * value of the quick create input.
      * <CodeBlock>{'(string) =>'}</CodeBlock>
+     * @since 10.19.0
      */
     onQuickCreate?: (name: string) => void;
     /**
@@ -113,57 +179,128 @@ export interface TieredSelectApi {
      * combined with <Code>loadingMore</Code>
      * for an async infinite scrolling menu.
      * <CodeBlock>{'(event) =>'}</CodeBlock>
+     * @since 10.19.0
      */
     onScrollBottom?: SelectProps['onScrollBottom'];
     /**
      * Called when searching the TieredSelect. Behavior must be controlled by
      * implementor
      * <CodeBlock>{'(event) =>'}</CodeBlock>
+     * @since 10.19.0
      */
     onSearch?: SelectProps['onSearch'];
+    /**
+     * @since 10.19.0
+     */
     tabIndex?: number;
 }
 export interface TieredSelectProps extends Partial<Omit<TieredSelectApi, 'getValueString'>>, Omit<Div, 'onSelect' | 'onChange'> {
+    /**
+     * @since 10.19.0
+     */
     block?: SelectProps['block'];
+    /**
+     * @since 10.19.0
+     */
     disabled?: SelectProps['disabled'];
+    /**
+     * @since 10.19.0
+     */
     error?: SelectProps['error'];
+    /**
+     * @since 10.19.0
+     */
     getValueString?: GetValueString;
+    /**
+     * @since 10.19.0
+     */
     loading?: SelectProps['loading'];
     /**
      * Flat array of tier objects, this array is used as data for the component
+     * @since 10.19.0
      */
     options?: any[];
     /**
      * If true, any tier is selectable. If false, only leaf nodes are selectable
      * @default true
+     * @since 10.19.0
      */
     selectableTiers?: boolean;
     /**
      * Flat array of tier objects that represents the selected value
+     * @since 10.19.0
      */
     value?: any[];
 }
 export interface TieredSelectMenuProps extends Omit<Div, 'onSelect' | 'onChange' | 'onDragEnd'> {
+    /**
+     * @since 10.19.0
+     */
     currentTier: Id;
+    /**
+     * @since 10.19.0
+     */
     loading: TieredSelectProps['loading'];
+    /**
+     * @since 10.19.0
+     */
     loadingMore?: TieredSelectProps['loadingMore'];
+    /**
+     * @since 10.19.0
+     */
     menuRef: React.RefObject<MenuRef>;
+    /**
+     * @since 10.19.0
+     */
     onChange: (selection: TierSelection) => void;
+    /**
+     * @since 10.19.0
+     */
     onNavigate: (nextGroupId: Id, value: any[]) => void;
+    /**
+     * @since 10.19.0
+     */
     onSearch: (e: React.ChangeEvent<HTMLInputElement>) => void;
+    /**
+     * @since 10.19.0
+     */
     options: any[];
+    /**
+     * @since 10.19.0
+     */
     previousValue: any[];
+    /**
+     * @since 10.19.0
+     */
     value: any[];
 }
 export interface ArrowButtonProps {
+    /**
+     * @since 10.19.0
+     */
     onClick?: (event: React.SyntheticEvent) => void;
 }
 export interface QuickCreateInputProps {
+    /**
+     * @since 10.19.0
+     */
     autoFocus: boolean;
+    /**
+     * @since 10.19.0
+     */
     onSubmit: (name: string) => void;
+    /**
+     * @since 10.19.0
+     */
     placeholder: string;
 }
 export interface OptionsProps {
+    /**
+     * @since 10.19.0
+     */
     children: React.ReactNode;
+    /**
+     * @since 10.19.0
+     */
     emptyMessage?: string;
 }

package/dist/esm/components/Tile/Tile.types.d.ts

@@ -7,17 +7,27 @@ export interface HeroMediaProps extends Props {
     onOverlayClick?: React.MouseEventHandler<HTMLDivElement>;
 }
 export interface TileCommonProps extends Props {
+    /**
+     * @since 10.19.0
+     */
     orientation: 'portrait' | 'landscape';
 }
 export interface InteractableTileProps extends TileCommonProps, DivAttributes {
+    /**
+     * @since 10.19.0
+     */
     variant?: 'interactive';
 }
 export interface LinkTileProps extends TileCommonProps, AnchorAttributes {
+    /**
+     * @since 10.19.0
+     */
     variant?: 'link';
 }
 export interface SelectableTileProps extends TileCommonProps, Omit<DivAttributes, 'onClick'> {
     /**
      * To change tile behaviour
+     * @since 10.19.0
      */
     variant?: 'selectable';
     /**
@@ -33,16 +43,19 @@ export interface SelectableTileProps extends TileCommonProps, Omit<DivAttributes
      * <CodeBlock>{`React.MouseEventHandler<HTMLDivElement>`}</CodeBlock>
      * For variant link:
      * <CodeBlock>{`React.MouseEventHandler<HTMLAnchorElement>`}</CodeBlock>
+     * @since 10.19.0
      */
     onClick?: () => {};
     /**
      * Only with selectable variant.
      * @default false
+     * @since 10.19.0
      */
     selected?: boolean;
     /**
      * Only with selectable variant.
      * @default false
+     * @since 10.19.0
      */
     disabled?: boolean;
 }

package/dist/esm/components/Toast/Toast.d.ts

@@ -1,5 +1,20 @@
 import React from 'react';
 import { DivAttributes } from '../../utils/types';
 import { ToastProps } from './Toast.types';
+/**
+
+ We use toasts to temporarily display information to a user. For example,
+ as a confirmation that an action was successfully or unsuccessfully completed.
+
+ Toasts do not present the user with an action. If an action needs to be
+ performed because of the particular message, use a banner.
+
+ @since 10.19.0
+
+ @see [Storybook](https://procore.github.io/core/latest/?path=/story/demos-toast--demo)
+
+ @see [Design Guidelines](https://design.procore.com/toast)
+
+ */
 export declare const Toast: React.ForwardRefExoticComponent<DivAttributes & ToastProps & React.RefAttributes<HTMLDivElement>>;
 export default Toast;

package/dist/esm/components/Toast/Toast.js

@@ -23,6 +23,21 @@ var __rest = (this && this.__rest) || function (s, e) {
 import { Check, Error } from '@procore/core-icons/dist';
 import React from 'react';
 import { StyledToast, StyledToastLabel } from './Toast.styles';
+/**
+
+ We use toasts to temporarily display information to a user. For example,
+ as a confirmation that an action was successfully or unsuccessfully completed.
+
+ Toasts do not present the user with an action. If an action needs to be
+ performed because of the particular message, use a banner.
+
+ @since 10.19.0
+
+ @see [Storybook](https://procore.github.io/core/latest/?path=/story/demos-toast--demo)
+
+ @see [Design Guidelines](https://design.procore.com/toast)
+
+ */
 export var Toast = React.forwardRef(function Toast(_a, ref) {
     var children = _a.children, variant = _a.variant, props = __rest(_a, ["children", "variant"]);
     return (React.createElement(StyledToast, __assign({}, props, { "$variant": variant, ref: ref }),

package/dist/esm/components/Toast/Toast.js.map

@@ -1 +1 @@
-{"version":3,"file":"Toast.js","sourceRoot":"","sources":["../../../../src/components/Toast/Toast.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAA;AACvD,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAG9D,MAAM,CAAC,IAAM,KAAK,GAAG,KAAK,CAAC,UAAU,CAGnC,SAAS,KAAK,CAAC,EAA+B,EAAE,GAAG;IAAlC,IAAA,QAAQ,cAAA,EAAE,OAAO,aAAA,EAAK,KAAK,cAA7B,uBAA+B,CAAF;IAC5C,OAAO,CACL,oBAAC,WAAW,eAAK,KAAK,gBAAY,OAAO,EAAE,GAAG,EAAE,GAAG;QAChD,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,oBAAC,KAAK,IAAC,IAAI,EAAC,IAAI,GAAG,CAAC,CAAC,CAAC,oBAAC,KAAK,IAAC,IAAI,EAAC,IAAI,GAAG;QAClE,oBAAC,gBAAgB,QAAE,QAAQ,CAAoB,CACnC,CACf,CAAA;AACH,CAAC,CAAC,CAAA;AAEF,KAAK,CAAC,WAAW,GAAG,OAAO,CAAA;AAE3B,eAAe,KAAK,CAAA"}
+{"version":3,"file":"Toast.js","sourceRoot":"","sources":["../../../../src/components/Toast/Toast.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAA;AACvD,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAG9D;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,IAAM,KAAK,GAAG,KAAK,CAAC,UAAU,CAGnC,SAAS,KAAK,CAAC,EAA+B,EAAE,GAAG;IAAlC,IAAA,QAAQ,cAAA,EAAE,OAAO,aAAA,EAAK,KAAK,cAA7B,uBAA+B,CAAF;IAC5C,OAAO,CACL,oBAAC,WAAW,eAAK,KAAK,gBAAY,OAAO,EAAE,GAAG,EAAE,GAAG;QAChD,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,oBAAC,KAAK,IAAC,IAAI,EAAC,IAAI,GAAG,CAAC,CAAC,CAAC,oBAAC,KAAK,IAAC,IAAI,EAAC,IAAI,GAAG;QAClE,oBAAC,gBAAgB,QAAE,QAAQ,CAAoB,CACnC,CACf,CAAA;AACH,CAAC,CAAC,CAAA;AAEF,KAAK,CAAC,WAAW,GAAG,OAAO,CAAA;AAE3B,eAAe,KAAK,CAAA"}

package/dist/esm/components/Toast/Toast.types.d.ts

@@ -3,6 +3,7 @@ export declare type ToastVariant = 'error' | 'success';
 export interface ToastProps extends Props {
     /**
      * Controls icon and background color
+     * @since 10.19.0
      */
     variant: ToastVariant;
 }

package/dist/esm/components/ToggleButton/ToggleButton.d.ts

@@ -1,3 +1,16 @@
 import React from 'react';
 import { ToggleButtonProps } from './ToggleButton.types';
+/**
+
+ A toggle button can be used when an element needs to remain active or open
+ for extended periods of time. The affects of a toggle button should visibly
+ change content on the page.
+
+ @since 10.19.0
+
+ @see [Storybook](https://procore.github.io/core/latest/?path=/story/demos-togglebutton--demo)
+
+ @see [Design Guidelines](https://design.procore.com/toggle-button)
+
+ */
 export declare const ToggleButton: React.ForwardRefExoticComponent<ToggleButtonProps & React.RefAttributes<HTMLButtonElement>>;

package/dist/esm/components/ToggleButton/ToggleButton.js

@@ -22,6 +22,19 @@ var __rest = (this && this.__rest) || function (s, e) {
 };
 import React from 'react';
 import { StyledToggleButton } from './ToggleButton.styles';
+/**
+
+ A toggle button can be used when an element needs to remain active or open
+ for extended periods of time. The affects of a toggle button should visibly
+ change content on the page.
+
+ @since 10.19.0
+
+ @see [Storybook](https://procore.github.io/core/latest/?path=/story/demos-togglebutton--demo)
+
+ @see [Design Guidelines](https://design.procore.com/toggle-button)
+
+ */
 export var ToggleButton = React.forwardRef(function ToggleButton(_a, ref) {
     var children = _a.children, _b = _a.selected, selected = _b === void 0 ? false : _b, icon = _a.icon, size = _a.size, props = __rest(_a, ["children", "selected", "icon", "size"]);
     return (React.createElement(StyledToggleButton, __assign({}, props, { "$selected": selected, icon: icon, size: size, variant: "tertiary", ref: ref }), children || null));

package/dist/esm/components/ToggleButton/ToggleButton.js.map

@@ -1 +1 @@
-{"version":3,"file":"ToggleButton.js","sourceRoot":"","sources":["../../../../src/components/ToggleButton/ToggleButton.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAG1D,MAAM,CAAC,IAAM,YAAY,GAAG,KAAK,CAAC,UAAU,CAG1C,SAAS,YAAY,CACrB,EAAoD,EACpD,GAAG;IADD,IAAA,QAAQ,cAAA,EAAE,gBAAgB,EAAhB,QAAQ,mBAAG,KAAK,KAAA,EAAE,IAAI,UAAA,EAAE,IAAI,UAAA,EAAK,KAAK,cAAlD,wCAAoD,CAAF;IAGlD,OAAO,CACL,oBAAC,kBAAkB,eACb,KAAK,iBACE,QAAQ,EACnB,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,IAAI,EACV,OAAO,EAAC,UAAU,EAClB,GAAG,EAAE,GAAG,KAEP,QAAQ,IAAI,IAAI,CACE,CACtB,CAAA;AACH,CAAC,CAAC,CAAA;AAEF,YAAY,CAAC,WAAW,GAAG,cAAc,CAAA"}
+{"version":3,"file":"ToggleButton.js","sourceRoot":"","sources":["../../../../src/components/ToggleButton/ToggleButton.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAG1D;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,IAAM,YAAY,GAAG,KAAK,CAAC,UAAU,CAG1C,SAAS,YAAY,CACrB,EAAoD,EACpD,GAAG;IADD,IAAA,QAAQ,cAAA,EAAE,gBAAgB,EAAhB,QAAQ,mBAAG,KAAK,KAAA,EAAE,IAAI,UAAA,EAAE,IAAI,UAAA,EAAK,KAAK,cAAlD,wCAAoD,CAAF;IAGlD,OAAO,CACL,oBAAC,kBAAkB,eACb,KAAK,iBACE,QAAQ,EACnB,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,IAAI,EACV,OAAO,EAAC,UAAU,EAClB,GAAG,EAAE,GAAG,KAEP,QAAQ,IAAI,IAAI,CACE,CACtB,CAAA;AACH,CAAC,CAAC,CAAA;AAEF,YAAY,CAAC,WAAW,GAAG,cAAc,CAAA"}

package/dist/esm/components/ToggleButton/ToggleButton.types.d.ts

@@ -4,15 +4,18 @@ export interface ToggleButtonProps extends ButtonAttributes {
     /**
      * Set the current value of the toggle button
      * @default false
+     * @since 10.19.0
      */
     selected?: boolean;
     /**
      * The icon to display on the left side of the label. This should be an
      * icon from <Code>@procore/core-icons</Code>.
+     * @since 10.19.0
      */
     icon?: string | React.ReactNode;
     /**
      * The toggle button size
+     * @since 10.19.0
      */
     size?: ButtonSizes;
 }

package/dist/esm/components/Token/Token.d.ts

@@ -2,6 +2,18 @@ import React from 'react';
 import { DivAttributes, Props, SpanAttributes } from '../../utils/types';
 import { IconProps } from '../Icon';
 import { TokenProps } from './Token.types';
+/**
+
+ We use tokens in our multi select dropdowns and file attachers to indicate what
+ has been selected or attached. Tokens in these components are removable.
+
+ @since 10.19.0
+
+ @see [Storybook](https://procore.github.io/core/latest/?path=/story/demos-token--demo)
+
+ @see [Design Guidelines](https://design.procore.com/tokens)
+
+ */
 export declare const Token: React.ForwardRefExoticComponent<DivAttributes & TokenProps & React.RefAttributes<HTMLDivElement>> & {
     Icon: React.ForwardRefExoticComponent<SpanAttributes & IconProps & React.RefAttributes<HTMLSpanElement>>;
     Label: React.ForwardRefExoticComponent<SpanAttributes & Props & React.RefAttributes<HTMLSpanElement>>;

package/dist/esm/components/Token/Token.js

@@ -41,6 +41,18 @@ var Label = React.forwardRef(function Label(_a, ref) {
 Parent.displayName = 'Token';
 Icon.displayName = 'Token.Icon';
 Label.displayName = 'Token.Label';
+/**
+
+ We use tokens in our multi select dropdowns and file attachers to indicate what
+ has been selected or attached. Tokens in these components are removable.
+
+ @since 10.19.0
+
+ @see [Storybook](https://procore.github.io/core/latest/?path=/story/demos-token--demo)
+
+ @see [Design Guidelines](https://design.procore.com/tokens)
+
+ */
 export var Token = addSubcomponents({
     Icon: Icon,
     Label: Label,

package/dist/esm/components/Token/Token.js.map

@@ -1 +1 @@
-{"version":3,"file":"Token.js","sourceRoot":"","sources":["../../../../src/components/Token/Token.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAE/D,OAAO,EAAE,IAAI,IAAI,QAAQ,EAAa,MAAM,SAAS,CAAA;AACrD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAGrE,IAAM,MAAM,GAAG,KAAK,CAAC,UAAU,CAC7B,SAAS,KAAK,CACZ,EAOC,EACD,GAAG;IAPD,IAAA,QAAQ,cAAA,EACR,gBAAgB,EAAhB,QAAQ,mBAAG,KAAK,KAAA,EAChB,eAAe,EAAf,OAAO,mBAAG,KAAK,KAAA,EACf,aAAa,EAAb,KAAK,mBAAG,KAAK,KAAA,EACb,OAAO,aAAA,EACJ,KAAK,cANV,uDAOC,CADS;IAIV,OAAO,CACL,oBAAC,WAAW,eACN,KAAK,IACT,GAAG,EAAE,GAAG,eACG,QAAQ,IAAI,OAAO,KAAK,UAAU,cACnC,OAAO,IAAI,OAAO,KAAK,SAAS,YAClC,KAAK,KAEZ,QAAQ,CACG,CACf,CAAA;AACH,CAAC,CACF,CAAA;AAED,oEAAoE;AACpE,IAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAC3B,SAAS,SAAS,CAAC,EAAkB,EAAE,GAAG;IAArB,IAAA,IAAI,UAAA,EAAK,KAAK,cAAhB,QAAkB,CAAF;IACjC,OAAO,CACL,oBAAC,UAAU;QACT,oBAAC,QAAQ,aAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,IAAM,KAAK,EAAI,CAClC,CACd,CAAA;AACH,CAAC,CACF,CAAA;AAED,IAAM,KAAK,GAAG,KAAK,CAAC,UAAU,CAC5B,SAAS,KAAK,CAAC,EAAsB,EAAE,GAAG;IAAzB,IAAA,QAAQ,cAAA,EAAK,KAAK,cAApB,YAAsB,CAAF;IACjC,OAAO,CACL,oBAAC,WAAW,aAAC,GAAG,EAAE,GAAG,IAAM,KAAK,GAC7B,QAAQ,CACG,CACf,CAAA;AACH,CAAC,CACF,CAAA;AAED,MAAM,CAAC,WAAW,GAAG,OAAO,CAAA;AAE5B,IAAI,CAAC,WAAW,GAAG,YAAY,CAAA;AAE/B,KAAK,CAAC,WAAW,GAAG,aAAa,CAAA;AAEjC,MAAM,CAAC,IAAM,KAAK,GAAG,gBAAgB,CACnC;IACE,IAAI,MAAA;IACJ,KAAK,OAAA;CACN,EACD,MAAM,CACP,CAAA;AAED,eAAe,KAAK,CAAA,CAAC,6BAA6B"}
+{"version":3,"file":"Token.js","sourceRoot":"","sources":["../../../../src/components/Token/Token.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAE/D,OAAO,EAAE,IAAI,IAAI,QAAQ,EAAa,MAAM,SAAS,CAAA;AACrD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAGrE,IAAM,MAAM,GAAG,KAAK,CAAC,UAAU,CAC7B,SAAS,KAAK,CACZ,EAOC,EACD,GAAG;IAPD,IAAA,QAAQ,cAAA,EACR,gBAAgB,EAAhB,QAAQ,mBAAG,KAAK,KAAA,EAChB,eAAe,EAAf,OAAO,mBAAG,KAAK,KAAA,EACf,aAAa,EAAb,KAAK,mBAAG,KAAK,KAAA,EACb,OAAO,aAAA,EACJ,KAAK,cANV,uDAOC,CADS;IAIV,OAAO,CACL,oBAAC,WAAW,eACN,KAAK,IACT,GAAG,EAAE,GAAG,eACG,QAAQ,IAAI,OAAO,KAAK,UAAU,cACnC,OAAO,IAAI,OAAO,KAAK,SAAS,YAClC,KAAK,KAEZ,QAAQ,CACG,CACf,CAAA;AACH,CAAC,CACF,CAAA;AAED,oEAAoE;AACpE,IAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAC3B,SAAS,SAAS,CAAC,EAAkB,EAAE,GAAG;IAArB,IAAA,IAAI,UAAA,EAAK,KAAK,cAAhB,QAAkB,CAAF;IACjC,OAAO,CACL,oBAAC,UAAU;QACT,oBAAC,QAAQ,aAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,IAAM,KAAK,EAAI,CAClC,CACd,CAAA;AACH,CAAC,CACF,CAAA;AAED,IAAM,KAAK,GAAG,KAAK,CAAC,UAAU,CAC5B,SAAS,KAAK,CAAC,EAAsB,EAAE,GAAG;IAAzB,IAAA,QAAQ,cAAA,EAAK,KAAK,cAApB,YAAsB,CAAF;IACjC,OAAO,CACL,oBAAC,WAAW,aAAC,GAAG,EAAE,GAAG,IAAM,KAAK,GAC7B,QAAQ,CACG,CACf,CAAA;AACH,CAAC,CACF,CAAA;AAED,MAAM,CAAC,WAAW,GAAG,OAAO,CAAA;AAE5B,IAAI,CAAC,WAAW,GAAG,YAAY,CAAA;AAE/B,KAAK,CAAC,WAAW,GAAG,aAAa,CAAA;AAEjC;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,IAAM,KAAK,GAAG,gBAAgB,CACnC;IACE,IAAI,MAAA;IACJ,KAAK,OAAA;CACN,EACD,MAAM,CACP,CAAA;AAED,eAAe,KAAK,CAAA,CAAC,6BAA6B"}

package/dist/esm/components/Token/Token.types.d.ts

@@ -2,9 +2,16 @@ import { IconProps } from '../Icon';
 export interface TokenProps {
     /**
      * Disables the token
+     * @since 10.19.0
      */
     disabled?: boolean;
+    /**
+     * @since 10.19.0
+     */
     focused?: boolean;
+    /**
+     * @since 10.19.0
+     */
     error?: boolean;
     /**
      * @deprecated
@@ -22,6 +29,7 @@ export interface TokenProps {
      * `<Token disabled focused />`
      *
      * @deprecatedSince 10.20.0
+     * @since 10.19.0
      */
     variant?: 'disabled' | 'focused' | 'icon' | 'standard';
 }
@@ -32,6 +40,7 @@ export interface TokenProps {
 export interface LegacyIconProps extends Omit<IconProps, 'icon'> {
     /**
      * The token icon
+     * @since 10.19.0
      */
     icon: string | React.ReactNode;
 }

package/dist/esm/components/Tooltip/Tooltip.js

@@ -29,6 +29,23 @@ var Content = React.forwardRef(function Content(_a, ref) {
     return (React.createElement(StyledContainer, { ref: ref },
         React.createElement(StyledTooltip, __assign({}, props, { "$placement": placement }), children)));
 });
+/**
+
+ We use tooltips to display additional descriptive information about an element
+ or item to the user. For example, we could use them to explain a specific term
+ or phrase, to denote the specific format required (e.g. mm/dd/yyy), or to
+ clarify certain information (e.g. why a button is disabled).
+
+ They can be displayed either by hovering over an element in the product or by
+ hovering over an icon next to an element.
+
+ @since 10.19.0
+
+ @see [Storybook](https://procore.github.io/core/latest/?path=/story/tooltip--always-on-tooltip)
+
+ @see [Design Guidelines](https://design.procore.com/tooltip)
+
+ */
 var Tooltip_ = React.forwardRef(function Tooltip(_a, ref) {
     var children = _a.children, _b = _a.initialIsVisible, initialIsVisible = _b === void 0 ? false : _b, overlay = _a.overlay, _c = _a.placement, placement = _c === void 0 ? 'top' : _c, _d = _a.trigger, trigger = _d === void 0 ? 'hover' : _d, props = __rest(_a, ["children", "initialIsVisible", "overlay", "placement", "trigger"]);
     var overlayNode = React.isValidElement(overlay) ? (React.cloneElement(overlay, { placement: placement })) : (React.createElement(Content, { placement: placement }, overlay));

package/dist/esm/components/Tooltip/Tooltip.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tooltip.js","sourceRoot":"","sources":["../../../../src/components/Tooltip/Tooltip.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAC/D,OAAO,EAAE,cAAc,EAAuB,MAAM,mBAAmB,CAAA;AACvE,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAGjE,IAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAC9B,SAAS,OAAO,CAAC,EAAyC,EAAE,GAAG;IAA5C,IAAA,QAAQ,cAAA,EAAE,iBAAiB,EAAjB,SAAS,mBAAG,KAAK,KAAA,EAAK,KAAK,cAAvC,yBAAyC,CAAF;IACtD,OAAO,CACL,oBAAC,eAAe,IAAC,GAAG,EAAE,GAAG;QACvB,oBAAC,aAAa,eAAK,KAAK,kBAAc,SAAS,KAC5C,QAAQ,CACK,CACA,CACnB,CAAA;AACH,CAAC,CACF,CAAA;AAED,IAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAG/B,SAAS,OAAO,CAChB,EAOC,EACD,GAAG;IAPD,IAAA,QAAQ,cAAA,EACR,wBAAwB,EAAxB,gBAAgB,mBAAG,KAAK,KAAA,EACxB,OAAO,aAAA,EACP,iBAAiB,EAAjB,SAAS,mBAAG,KAAK,KAAA,EACjB,eAAiB,EAAjB,OAAO,mBAAG,OAAO,KAAA,EACd,KAAK,cANV,mEAOC,CADS;IAIV,IAAM,WAAW,GAAG,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAClD,KAAK,CAAC,YAAY,CAAC,OAA6B,EAAE,EAAE,SAAS,WAAA,EAAE,CAAC,CACjE,CAAC,CAAC,CAAC,CACF,oBAAC,OAAO,IAAC,SAAS,EAAE,SAAS,IAAG,OAAO,CAAW,CACnD,CAAA;IAED,OAAO,CACL,oBAAC,cAAc,qCAER,KAAK,KACR,gBAAgB,kBAAA,EAChB,OAAO,EAAE,WAAW,EACpB,SAAS,WAAA,EACT,GAAG,KAAA,EACH,kBAAkB,EAAE,KAAK,EACzB,OAAO,SAAA,EACP,aAAa,EAAE,IAAI,MAGpB,QAAQ,CACM,CAClB,CAAA;AACH,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,WAAW,GAAG,SAAS,CAAA;AAEhC,OAAO,CAAC,WAAW,GAAG,iBAAiB,CAAA;AAEvC,MAAM,CAAC,IAAM,OAAO,GAAG,gBAAgB,CACrC;IACE,OAAO,SAAA;CACR,EACD,QAAQ,CACT,CAAA;AAED,eAAe,OAAO,CAAA"}
+{"version":3,"file":"Tooltip.js","sourceRoot":"","sources":["../../../../src/components/Tooltip/Tooltip.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAC/D,OAAO,EAAE,cAAc,EAAuB,MAAM,mBAAmB,CAAA;AACvE,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAGjE,IAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAC9B,SAAS,OAAO,CAAC,EAAyC,EAAE,GAAG;IAA5C,IAAA,QAAQ,cAAA,EAAE,iBAAiB,EAAjB,SAAS,mBAAG,KAAK,KAAA,EAAK,KAAK,cAAvC,yBAAyC,CAAF;IACtD,OAAO,CACL,oBAAC,eAAe,IAAC,GAAG,EAAE,GAAG;QACvB,oBAAC,aAAa,eAAK,KAAK,kBAAc,SAAS,KAC5C,QAAQ,CACK,CACA,CACnB,CAAA;AACH,CAAC,CACF,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,IAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAG/B,SAAS,OAAO,CAChB,EAOC,EACD,GAAG;IAPD,IAAA,QAAQ,cAAA,EACR,wBAAwB,EAAxB,gBAAgB,mBAAG,KAAK,KAAA,EACxB,OAAO,aAAA,EACP,iBAAiB,EAAjB,SAAS,mBAAG,KAAK,KAAA,EACjB,eAAiB,EAAjB,OAAO,mBAAG,OAAO,KAAA,EACd,KAAK,cANV,mEAOC,CADS;IAIV,IAAM,WAAW,GAAG,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAClD,KAAK,CAAC,YAAY,CAAC,OAA6B,EAAE,EAAE,SAAS,WAAA,EAAE,CAAC,CACjE,CAAC,CAAC,CAAC,CACF,oBAAC,OAAO,IAAC,SAAS,EAAE,SAAS,IAAG,OAAO,CAAW,CACnD,CAAA;IAED,OAAO,CACL,oBAAC,cAAc,qCAER,KAAK,KACR,gBAAgB,kBAAA,EAChB,OAAO,EAAE,WAAW,EACpB,SAAS,WAAA,EACT,GAAG,KAAA,EACH,kBAAkB,EAAE,KAAK,EACzB,OAAO,SAAA,EACP,aAAa,EAAE,IAAI,MAGpB,QAAQ,CACM,CAClB,CAAA;AACH,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,WAAW,GAAG,SAAS,CAAA;AAEhC,OAAO,CAAC,WAAW,GAAG,iBAAiB,CAAA;AAEvC,MAAM,CAAC,IAAM,OAAO,GAAG,gBAAgB,CACrC;IACE,OAAO,SAAA;CACR,EACD,QAAQ,CACT,CAAA;AAED,eAAe,OAAO,CAAA"}