@atlaskit/primitives 0.12.5 → 0.12.6

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @atlaskit/primitives
 
+## 0.12.6
+
+### Patch Changes
+
+- [`3be327cdd6a`](https://bitbucket.org/atlassian/atlassian-frontend/commits/3be327cdd6a) - Allow styles to be applied to Inline through xcss.
+
 ## 0.12.5
 
 ### Patch Changes

package/dist/cjs/components/inline.js

@@ -7,6 +7,7 @@ exports.default = void 0;
 var _react = require("react");
 var _react2 = require("@emotion/react");
 var _styleMaps = require("../xcss/style-maps.partial");
+var _xcss = require("../xcss/xcss");
 /* eslint-disable @repo/internal/styles/no-exported-styles */
 /** @jsx jsx */
 
@@ -99,6 +100,7 @@ var Inline = /*#__PURE__*/(0, _react.memo)( /*#__PURE__*/(0, _react.forwardRef)(
     space = _ref2.space,
     rowSpace = _ref2.rowSpace,
     separator = _ref2.separator,
+    xcss = _ref2.xcss,
     testId = _ref2.testId,
     rawChildren = _ref2.children;
   var Component = as || 'div';
@@ -109,8 +111,11 @@ var Inline = /*#__PURE__*/(0, _react.memo)( /*#__PURE__*/(0, _react.forwardRef)(
     }, separator && index > 0 ? separatorComponent : null, child);
   }) : rawChildren;
   var justifyContent = spread || alignInline;
+  var className = xcss && (0, _xcss.parseXcss)(xcss);
   return (0, _react2.jsx)(Component, {
-    css: [baseStyles, space && _styleMaps.spaceStylesMap.gap[space], justifyContent && justifyContentMap[justifyContent], grow && flexGrowMap[grow], alignItems && alignItemsMap[alignItems], shouldWrap && flexWrapStyles, rowSpace && _styleMaps.spaceStylesMap.rowGap[rowSpace]],
+    css: [
+    // eslint-disable-next-line @atlaskit/design-system/consistent-css-prop-usage
+    className, baseStyles, space && _styleMaps.spaceStylesMap.gap[space], justifyContent && justifyContentMap[justifyContent], grow && flexGrowMap[grow], alignItems && alignItemsMap[alignItems], shouldWrap && flexWrapStyles, rowSpace && _styleMaps.spaceStylesMap.rowGap[rowSpace]],
     "data-testid": testId,
     ref: ref
   }, children);

package/dist/cjs/version.json

@@ -1,5 +1,5 @@
 {
 	"name": "@atlaskit/primitives",
-	"version": "0.12.5",
+	"version": "0.12.6",
 	"sideEffects": false
 }

package/dist/es2019/components/inline.js

@@ -3,6 +3,7 @@
 import { Children, forwardRef, Fragment, memo } from 'react';
 import { css, jsx } from '@emotion/react';
 import { spaceStylesMap } from '../xcss/style-maps.partial';
+import { parseXcss } from '../xcss/xcss';
 const alignItemsMap = {
   center: css({
     alignItems: 'center'
@@ -89,6 +90,7 @@ const Inline = /*#__PURE__*/memo( /*#__PURE__*/forwardRef(({
   space,
   rowSpace,
   separator,
+  xcss,
   testId,
   children: rawChildren
 }, ref) => {
@@ -100,8 +102,11 @@ const Inline = /*#__PURE__*/memo( /*#__PURE__*/forwardRef(({
     }, separator && index > 0 ? separatorComponent : null, child);
   }) : rawChildren;
   const justifyContent = spread || alignInline;
+  const className = xcss && parseXcss(xcss);
   return jsx(Component, {
-    css: [baseStyles, space && spaceStylesMap.gap[space], justifyContent && justifyContentMap[justifyContent], grow && flexGrowMap[grow], alignItems && alignItemsMap[alignItems], shouldWrap && flexWrapStyles, rowSpace && spaceStylesMap.rowGap[rowSpace]],
+    css: [
+    // eslint-disable-next-line @atlaskit/design-system/consistent-css-prop-usage
+    className, baseStyles, space && spaceStylesMap.gap[space], justifyContent && justifyContentMap[justifyContent], grow && flexGrowMap[grow], alignItems && alignItemsMap[alignItems], shouldWrap && flexWrapStyles, rowSpace && spaceStylesMap.rowGap[rowSpace]],
     "data-testid": testId,
     ref: ref
   }, children);

package/dist/es2019/version.json

@@ -1,5 +1,5 @@
 {
 	"name": "@atlaskit/primitives",
-	"version": "0.12.5",
+	"version": "0.12.6",
 	"sideEffects": false
 }

package/dist/esm/components/inline.js

@@ -3,6 +3,7 @@
 import { Children, forwardRef, Fragment, memo } from 'react';
 import { css, jsx } from '@emotion/react';
 import { spaceStylesMap } from '../xcss/style-maps.partial';
+import { parseXcss } from '../xcss/xcss';
 var alignItemsMap = {
   center: css({
     alignItems: 'center'
@@ -92,6 +93,7 @@ var Inline = /*#__PURE__*/memo( /*#__PURE__*/forwardRef(function (_ref2, ref) {
     space = _ref2.space,
     rowSpace = _ref2.rowSpace,
     separator = _ref2.separator,
+    xcss = _ref2.xcss,
     testId = _ref2.testId,
     rawChildren = _ref2.children;
   var Component = as || 'div';
@@ -102,8 +104,11 @@ var Inline = /*#__PURE__*/memo( /*#__PURE__*/forwardRef(function (_ref2, ref) {
     }, separator && index > 0 ? separatorComponent : null, child);
   }) : rawChildren;
   var justifyContent = spread || alignInline;
+  var className = xcss && parseXcss(xcss);
   return jsx(Component, {
-    css: [baseStyles, space && spaceStylesMap.gap[space], justifyContent && justifyContentMap[justifyContent], grow && flexGrowMap[grow], alignItems && alignItemsMap[alignItems], shouldWrap && flexWrapStyles, rowSpace && spaceStylesMap.rowGap[rowSpace]],
+    css: [
+    // eslint-disable-next-line @atlaskit/design-system/consistent-css-prop-usage
+    className, baseStyles, space && spaceStylesMap.gap[space], justifyContent && justifyContentMap[justifyContent], grow && flexGrowMap[grow], alignItems && alignItemsMap[alignItems], shouldWrap && flexWrapStyles, rowSpace && spaceStylesMap.rowGap[rowSpace]],
     "data-testid": testId,
     ref: ref
   }, children);

package/dist/esm/version.json

@@ -1,5 +1,5 @@
 {
 	"name": "@atlaskit/primitives",
-	"version": "0.12.5",
+	"version": "0.12.6",
 	"sideEffects": false
 }

package/dist/types/components/inline.d.ts

@@ -1,6 +1,7 @@
 /** @jsx jsx */
 import { ElementType, ReactNode } from 'react';
 import { type Space } from '../xcss/style-maps.partial';
+import { type InlineXCSS } from '../xcss/xcss';
 export interface InlineProps<T extends ElementType = 'div'> {
     /**
      * The DOM element to render as the Inline. Defaults to `div`.
@@ -39,6 +40,10 @@ export interface InlineProps<T extends ElementType = 'div'> {
      * Renders a separator string between each child.
      */
     separator?: string;
+    /**
+     * Safe subset of styles that can be applied as a classname.
+     */
+    xcss?: InlineXCSS | Array<InlineXCSS | false | undefined>;
     /**
      * A unique string that appears as data attribute data-testid in the rendered code, serving as a hook for automated tests.
      */
@@ -71,5 +76,5 @@ export type Grow = 'hug' | 'fill';
  * ```
  *
  */
-declare const Inline: import("react").MemoExoticComponent<import("react").ForwardRefExoticComponent<Pick<InlineProps<ElementType<any>>, "as" | "children" | "testId" | "alignInline" | "alignBlock" | "shouldWrap" | "spread" | "grow" | "space" | "rowSpace" | "separator"> & import("react").RefAttributes<any>>>;
+declare const Inline: import("react").MemoExoticComponent<import("react").ForwardRefExoticComponent<Pick<InlineProps<ElementType<any>>, "as" | "children" | "testId" | "alignInline" | "alignBlock" | "shouldWrap" | "spread" | "grow" | "space" | "rowSpace" | "separator" | "xcss"> & import("react").RefAttributes<any>>>;
 export default Inline;

package/dist/types/xcss/xcss.d.ts

@@ -28,7 +28,7 @@ declare const inlineWrapper: (style: any) => {
 };
 type XCSS = ReturnType<typeof boxWrapper> | ReturnType<typeof inlineWrapper>;
 type AllowedBoxStyles = keyof SafeCSSObject;
-type AllowedInlineStyles = 'backgroundColor' | 'padding';
+type Spacing = 'columnGap' | 'gap' | 'inset' | 'insetBlock' | 'insetBlockEnd' | 'insetBlockStart' | 'insetInline' | 'insetInlineEnd' | 'insetInlineStart' | 'outlineOffset' | 'padding' | 'paddingBlock' | 'paddingBlockEnd' | 'paddingBlockStart' | 'paddingBottom' | 'paddingInline' | 'paddingInlineEnd' | 'paddingInlineStart' | 'paddingLeft' | 'paddingRight' | 'paddingTop' | 'rowGap';
 /**
  * ### xcss
  *
@@ -41,8 +41,8 @@ type AllowedInlineStyles = 'backgroundColor' | 'padding';
  * })
  * ```
  */
-export declare function xcss<Primitive extends typeof Box | typeof Inline = typeof Box>(style: Primitive extends typeof Box ? ScopedSafeCSSObject<AllowedBoxStyles> | ScopedSafeCSSObject<AllowedBoxStyles>[] : Primitive extends typeof Inline ? ScopedSafeCSSObject<AllowedInlineStyles> | ScopedSafeCSSObject<AllowedInlineStyles>[] : never): {
-    readonly [uniqueSymbol]: Primitive extends (<T extends import("react").ElementType<any> = "div">(props: import("../index").BoxProps<T>) => import("react").ReactElement<any, string | import("react").JSXElementConstructor<any>> | null) & import("react").FC<import("../index").BoxProps<"div">> ? BoxStyles : Primitive extends import("react").MemoExoticComponent<import("react").ForwardRefExoticComponent<Pick<import("../index").InlineProps<import("react").ElementType<any>>, "as" | "children" | "testId" | "alignInline" | "alignBlock" | "shouldWrap" | "spread" | "grow" | "space" | "rowSpace" | "separator"> & import("react").RefAttributes<any>>> ? InlineStyles : never;
+export declare function xcss<Primitive extends typeof Box | typeof Inline = typeof Box>(style: Primitive extends typeof Box ? ScopedSafeCSSObject<AllowedBoxStyles> | ScopedSafeCSSObject<AllowedBoxStyles>[] : Primitive extends typeof Inline ? ScopedSafeCSSObject<Spacing> | ScopedSafeCSSObject<Spacing>[] : never): {
+    readonly [uniqueSymbol]: Primitive extends (<T extends import("react").ElementType<any> = "div">(props: import("../index").BoxProps<T>) => import("react").ReactElement<any, string | import("react").JSXElementConstructor<any>> | null) & import("react").FC<import("../index").BoxProps<"div">> ? BoxStyles : Primitive extends import("react").MemoExoticComponent<import("react").ForwardRefExoticComponent<Pick<import("../index").InlineProps<import("react").ElementType<any>>, "as" | "children" | "testId" | "alignInline" | "alignBlock" | "shouldWrap" | "spread" | "grow" | "space" | "rowSpace" | "separator" | "xcss"> & import("react").RefAttributes<any>>> ? InlineStyles : never;
 };
 declare const boxTag: unique symbol;
 export type BoxStyles = SerializedStyles & {

package/dist/types-ts4.5/components/inline.d.ts

@@ -1,6 +1,7 @@
 /** @jsx jsx */
 import { ElementType, ReactNode } from 'react';
 import { type Space } from '../xcss/style-maps.partial';
+import { type InlineXCSS } from '../xcss/xcss';
 export interface InlineProps<T extends ElementType = 'div'> {
     /**
      * The DOM element to render as the Inline. Defaults to `div`.
@@ -39,6 +40,10 @@ export interface InlineProps<T extends ElementType = 'div'> {
      * Renders a separator string between each child.
      */
     separator?: string;
+    /**
+     * Safe subset of styles that can be applied as a classname.
+     */
+    xcss?: InlineXCSS | Array<InlineXCSS | false | undefined>;
     /**
      * A unique string that appears as data attribute data-testid in the rendered code, serving as a hook for automated tests.
      */
@@ -71,5 +76,5 @@ export type Grow = 'hug' | 'fill';
  * ```
  *
  */
-declare const Inline: import("react").MemoExoticComponent<import("react").ForwardRefExoticComponent<Pick<InlineProps<ElementType<any>>, "as" | "children" | "testId" | "alignInline" | "alignBlock" | "shouldWrap" | "spread" | "grow" | "space" | "rowSpace" | "separator"> & import("react").RefAttributes<any>>>;
+declare const Inline: import("react").MemoExoticComponent<import("react").ForwardRefExoticComponent<Pick<InlineProps<ElementType<any>>, "as" | "children" | "testId" | "alignInline" | "alignBlock" | "shouldWrap" | "spread" | "grow" | "space" | "rowSpace" | "separator" | "xcss"> & import("react").RefAttributes<any>>>;
 export default Inline;

package/dist/types-ts4.5/xcss/xcss.d.ts

@@ -28,7 +28,7 @@ declare const inlineWrapper: (style: any) => {
 };
 type XCSS = ReturnType<typeof boxWrapper> | ReturnType<typeof inlineWrapper>;
 type AllowedBoxStyles = keyof SafeCSSObject;
-type AllowedInlineStyles = 'backgroundColor' | 'padding';
+type Spacing = 'columnGap' | 'gap' | 'inset' | 'insetBlock' | 'insetBlockEnd' | 'insetBlockStart' | 'insetInline' | 'insetInlineEnd' | 'insetInlineStart' | 'outlineOffset' | 'padding' | 'paddingBlock' | 'paddingBlockEnd' | 'paddingBlockStart' | 'paddingBottom' | 'paddingInline' | 'paddingInlineEnd' | 'paddingInlineStart' | 'paddingLeft' | 'paddingRight' | 'paddingTop' | 'rowGap';
 /**
  * ### xcss
  *
@@ -41,8 +41,8 @@ type AllowedInlineStyles = 'backgroundColor' | 'padding';
  * })
  * ```
  */
-export declare function xcss<Primitive extends typeof Box | typeof Inline = typeof Box>(style: Primitive extends typeof Box ? ScopedSafeCSSObject<AllowedBoxStyles> | ScopedSafeCSSObject<AllowedBoxStyles>[] : Primitive extends typeof Inline ? ScopedSafeCSSObject<AllowedInlineStyles> | ScopedSafeCSSObject<AllowedInlineStyles>[] : never): {
-    readonly [uniqueSymbol]: Primitive extends (<T extends import("react").ElementType<any> = "div">(props: import("../index").BoxProps<T>) => import("react").ReactElement<any, string | import("react").JSXElementConstructor<any>> | null) & import("react").FC<import("../index").BoxProps<"div">> ? BoxStyles : Primitive extends import("react").MemoExoticComponent<import("react").ForwardRefExoticComponent<Pick<import("../index").InlineProps<import("react").ElementType<any>>, "as" | "children" | "testId" | "alignInline" | "alignBlock" | "shouldWrap" | "spread" | "grow" | "space" | "rowSpace" | "separator"> & import("react").RefAttributes<any>>> ? InlineStyles : never;
+export declare function xcss<Primitive extends typeof Box | typeof Inline = typeof Box>(style: Primitive extends typeof Box ? ScopedSafeCSSObject<AllowedBoxStyles> | ScopedSafeCSSObject<AllowedBoxStyles>[] : Primitive extends typeof Inline ? ScopedSafeCSSObject<Spacing> | ScopedSafeCSSObject<Spacing>[] : never): {
+    readonly [uniqueSymbol]: Primitive extends (<T extends import("react").ElementType<any> = "div">(props: import("../index").BoxProps<T>) => import("react").ReactElement<any, string | import("react").JSXElementConstructor<any>> | null) & import("react").FC<import("../index").BoxProps<"div">> ? BoxStyles : Primitive extends import("react").MemoExoticComponent<import("react").ForwardRefExoticComponent<Pick<import("../index").InlineProps<import("react").ElementType<any>>, "as" | "children" | "testId" | "alignInline" | "alignBlock" | "shouldWrap" | "spread" | "grow" | "space" | "rowSpace" | "separator" | "xcss"> & import("react").RefAttributes<any>>> ? InlineStyles : never;
 };
 declare const boxTag: unique symbol;
 export type BoxStyles = SerializedStyles & {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atlaskit/primitives",
-  "version": "0.12.5",
+  "version": "0.12.6",
   "description": "Primitives are token-backed low-level building blocks.",
   "author": "Atlassian Pty Ltd",
   "license": "Apache-2.0",

package/report.api.md

@@ -58,9 +58,6 @@ const alignSelfMap: {
 // @public (undocumented)
 type AllowedBoxStyles = keyof SafeCSSObject;
 
-// @public (undocumented)
-type AllowedInlineStyles = 'backgroundColor' | 'padding';
-
 // @public (undocumented)
 type As =
   | 'article'
@@ -456,6 +453,7 @@ export const Inline: MemoExoticComponent<
       | 'space'
       | 'spread'
       | 'testId'
+      | 'xcss'
     > &
       RefAttributes<any>
   >
@@ -475,6 +473,7 @@ export interface InlineProps<T extends ElementType = 'div'> {
   space?: Space;
   spread?: Spread;
   testId?: string;
+  xcss?: Array<InlineXCSS | false | undefined> | InlineXCSS;
 }
 
 // @public (undocumented)
@@ -488,6 +487,11 @@ type InlineStyles = SerializedStyles & {
 // @public (undocumented)
 const inlineTag: unique symbol;
 
+// @public (undocumented)
+type InlineXCSS = {
+  readonly [uniqueSymbol]: InlineStyles;
+};
+
 // @public (undocumented)
 type Layer = keyof typeof layerMap;
 
@@ -627,6 +631,31 @@ const spaceMap: {
   'space.1000': 'var(--ds-space-1000)';
 };
 
+// @public (undocumented)
+type Spacing =
+  | 'columnGap'
+  | 'gap'
+  | 'inset'
+  | 'insetBlock'
+  | 'insetBlockEnd'
+  | 'insetBlockStart'
+  | 'insetInline'
+  | 'insetInlineEnd'
+  | 'insetInlineStart'
+  | 'outlineOffset'
+  | 'padding'
+  | 'paddingBlock'
+  | 'paddingBlockEnd'
+  | 'paddingBlockStart'
+  | 'paddingBottom'
+  | 'paddingInline'
+  | 'paddingInlineEnd'
+  | 'paddingInlineStart'
+  | 'paddingLeft'
+  | 'paddingRight'
+  | 'paddingTop'
+  | 'rowGap';
+
 // @public (undocumented)
 type Spread = 'space-between';
 
@@ -800,9 +829,7 @@ export function xcss<Primitive extends typeof Box | typeof Inline = typeof Box>(
         | ScopedSafeCSSObject<AllowedBoxStyles>
         | ScopedSafeCSSObject<AllowedBoxStyles>[]
     : Primitive extends typeof Inline
-    ?
-        | ScopedSafeCSSObject<AllowedInlineStyles>
-        | ScopedSafeCSSObject<AllowedInlineStyles>[]
+    ? ScopedSafeCSSObject<Spacing> | ScopedSafeCSSObject<Spacing>[]
     : never,
 ): {
   readonly [uniqueSymbol]: Primitive extends (<
@@ -827,6 +854,7 @@ export function xcss<Primitive extends typeof Box | typeof Inline = typeof Box>(
             | 'space'
             | 'spread'
             | 'testId'
+            | 'xcss'
           > &
             RefAttributes<any>
         >

package/tmp/api-report-tmp.d.ts

@@ -47,9 +47,6 @@ const alignSelfMap: {
 // @public (undocumented)
 type AllowedBoxStyles = keyof SafeCSSObject;
 
-// @public (undocumented)
-type AllowedInlineStyles = 'backgroundColor' | 'padding';
-
 // @public (undocumented)
 type As = 'article' | 'aside' | 'dialog' | 'div' | 'footer' | 'header' | 'li' | 'main' | 'nav' | 'ol' | 'section' | 'span' | 'ul';
 
@@ -403,7 +400,7 @@ type Grow_2 = 'fill' | 'hug';
 type Height = Dimension;
 
 // @public
-export const Inline: MemoExoticComponent<ForwardRefExoticComponent<Pick<InlineProps<ElementType<any>>, "alignBlock" | "alignInline" | "as" | "children" | "grow" | "rowSpace" | "separator" | "shouldWrap" | "space" | "spread" | "testId"> & RefAttributes<any>>>;
+export const Inline: MemoExoticComponent<ForwardRefExoticComponent<Pick<InlineProps<ElementType<any>>, "alignBlock" | "alignInline" | "as" | "children" | "grow" | "rowSpace" | "separator" | "shouldWrap" | "space" | "spread" | "testId" | "xcss"> & RefAttributes<any>>>;
 
 // @public (undocumented)
 export interface InlineProps<T extends ElementType = 'div'> {
@@ -419,6 +416,7 @@ export interface InlineProps<T extends ElementType = 'div'> {
     space?: Space;
     spread?: Spread;
     testId?: string;
+    xcss?: Array<InlineXCSS | false | undefined> | InlineXCSS;
 }
 
 // @public (undocumented)
@@ -432,6 +430,11 @@ type InlineStyles = SerializedStyles & {
 // @public (undocumented)
 const inlineTag: unique symbol;
 
+// @public (undocumented)
+type InlineXCSS = {
+    readonly [uniqueSymbol]: InlineStyles;
+};
+
 // @public (undocumented)
 type Layer = keyof typeof layerMap;
 
@@ -563,6 +566,9 @@ const spaceMap: {
     'space.1000': "var(--ds-space-1000)";
 };
 
+// @public (undocumented)
+type Spacing = 'columnGap' | 'gap' | 'inset' | 'insetBlock' | 'insetBlockEnd' | 'insetBlockStart' | 'insetInline' | 'insetInlineEnd' | 'insetInlineStart' | 'outlineOffset' | 'padding' | 'paddingBlock' | 'paddingBlockEnd' | 'paddingBlockStart' | 'paddingBottom' | 'paddingInline' | 'paddingInlineEnd' | 'paddingInlineStart' | 'paddingLeft' | 'paddingRight' | 'paddingTop' | 'rowGap';
+
 // @public (undocumented)
 type Spread = 'space-between';
 
@@ -715,8 +721,8 @@ const UNSAFE_media: {
 type Width = Dimension;
 
 // @public
-export function xcss<Primitive extends typeof Box | typeof Inline = typeof Box>(style: Primitive extends typeof Box ? ScopedSafeCSSObject<AllowedBoxStyles> | ScopedSafeCSSObject<AllowedBoxStyles>[] : Primitive extends typeof Inline ? ScopedSafeCSSObject<AllowedInlineStyles> | ScopedSafeCSSObject<AllowedInlineStyles>[] : never): {
-    readonly [uniqueSymbol]: Primitive extends (<T extends ElementType<any> = "div">(props: BoxProps<T>) => ReactElement<any, JSXElementConstructor<any>| string> | null) & FC<BoxProps<"div">> ? BoxStyles : Primitive extends MemoExoticComponent<ForwardRefExoticComponent<Pick<InlineProps<ElementType<any>>, "alignBlock" | "alignInline" | "as" | "children" | "grow" | "rowSpace" | "separator" | "shouldWrap" | "space" | "spread" | "testId"> & RefAttributes<any>>> ? InlineStyles : never;
+export function xcss<Primitive extends typeof Box | typeof Inline = typeof Box>(style: Primitive extends typeof Box ? ScopedSafeCSSObject<AllowedBoxStyles> | ScopedSafeCSSObject<AllowedBoxStyles>[] : Primitive extends typeof Inline ? ScopedSafeCSSObject<Spacing> | ScopedSafeCSSObject<Spacing>[] : never): {
+    readonly [uniqueSymbol]: Primitive extends (<T extends ElementType<any> = "div">(props: BoxProps<T>) => ReactElement<any, JSXElementConstructor<any>| string> | null) & FC<BoxProps<"div">> ? BoxStyles : Primitive extends MemoExoticComponent<ForwardRefExoticComponent<Pick<InlineProps<ElementType<any>>, "alignBlock" | "alignInline" | "as" | "children" | "grow" | "rowSpace" | "separator" | "shouldWrap" | "space" | "spread" | "testId" | "xcss"> & RefAttributes<any>>> ? InlineStyles : never;
 };
 
 // (No @packageDocumentation comment for this package)