naive-ui 2.23.1 → 2.24.2

package/es/input/src/styles/input.cssr.js

@@ -1,36 +1,36 @@
 import { cB, c, cE, cM, cNotM, insideFormItem } from '../../../_utils/cssr'; // vars:
-// --bezier
-// --color
-// --font-size
-// --border-radius
-// --height
-// --padding-left
-// --padding-right
-// --text-color
-// --text-color-disabled
-// --caret-color
-// --text-decoration-color
-// --border
-// --border-disabled
-// --border-hover
-// --border-focus
-// --placeholder-color
-// --placeholder-color-disabled
-// --line-height-textarea
-// --color-disabled
-// --color-focus
-// --box-shadow-focus
-// --clear-color
-// --clear-size
-// --clear-color-hover
-// --clear-color-pressed
-// --suffix-text-color
-// --icon-color
-// --icon-color-hover
-// --icon-color-pressed
-// --icon-color-disabled
-// --count-text-color
-// --loading-color
+// --n-bezier
+// --n-color
+// --n-font-size
+// --n-border-radius
+// --n-height
+// --n-padding-left
+// --n-padding-right
+// --n-text-color
+// --n-text-color-disabled
+// --n-caret-color
+// --n-text-decoration-color
+// --n-border
+// --n-border-disabled
+// --n-border-hover
+// --n-border-focus
+// --n-placeholder-color
+// --n-placeholder-color-disabled
+// --n-line-height-textarea
+// --n-color-disabled
+// --n-color-focus
+// --n-box-shadow-focus
+// --n-clear-color
+// --n-clear-size
+// --n-clear-color-hover
+// --n-clear-color-pressed
+// --n-suffix-text-color
+// --n-icon-color
+// --n-icon-color-hover
+// --n-icon-color-pressed
+// --n-icon-color-disabled
+// --n-count-text-color
+// --n-loading-color
 // ...form item vars
 
 export default c([cB('input', `
@@ -42,11 +42,11 @@ export default c([cB('input', `
  box-sizing: border-box;
  position: relative;
  display: inline-flex;
- border-radius: var(--border-radius);
- background-color: var(--color);
- transition: background-color .3s var(--bezier);
- font-size: var(--font-size);
- --padding-vertical: calc((var(--height) - 1.5 * var(--font-size)) / 2);
+ border-radius: var(--n-border-radius);
+ background-color: var(--n-color);
+ transition: background-color .3s var(--n-bezier);
+ font-size: var(--n-font-size);
+ --n-padding-vertical: calc((var(--n-height) - 1.5 * var(--n-font-size)) / 2);
  `, [// common
 cE('input, textarea', `
  overflow: hidden;
@@ -62,22 +62,23 @@ cE('input, textarea', `
  background-color: #0000;
  text-align: inherit;
  transition:
- caret-color .3s var(--bezier),
- color .3s var(--bezier),
- text-decoration-color .3s var(--bezier);
+ caret-color .3s var(--n-bezier),
+ color .3s var(--n-bezier),
+ text-decoration-color .3s var(--n-bezier);
  `), cE('input-el, textarea-el', `
  -webkit-appearance: none;
+ scrollbar-width: none;
  width: 100%;
  min-width: 0;
- text-decoration-color: var(--text-decoration-color);
- color: var(--text-color);
- caret-color: var(--caret-color);
+ text-decoration-color: var(--n-text-decoration-color);
+ color: var(--n-text-color);
+ caret-color: var(--n-caret-color);
  background-color: transparent;
- `, [c('&::placeholder', {
-  color: '#0000'
-})]), cM('round', [cNotM('textarea', {
-  borderRadius: 'calc(var(--height) / 2)'
-})]), cE('placeholder', `
+ `, [c('&::-webkit-scrollbar, &::-webkit-scrollbar-track-piece, &::-webkit-scrollbar-thumb', `
+ width: 0;
+ height: 0;
+ display: none;
+ `), c('&::placeholder', 'color: #0000;'), c('&:-webkit-autofill ~', [cE('placeholder', 'display: none;')])]), cM('round', [cNotM('textarea', 'border-radius: calc(var(--n-height) / 2);')]), cE('placeholder', `
  pointer-events: none;
  position: absolute;
  left: 0;
@@ -85,13 +86,11 @@ cE('input, textarea', `
  top: 0;
  bottom: 0;
  overflow: hidden;
- color: var(--placeholder-color);
- `, [c('span', {
-  width: '100%',
-  display: 'inline-block'
-})]), cNotM('autosize', {
-  width: '100%'
-}), cM('autosize', [cE('textarea-el, input-el', `
+ color: var(--n-placeholder-color);
+ `, [c('span', `
+ width: 100%;
+ display: inline-block;
+ `)]), cM('textarea', [cE('placeholder', 'overflow: visible;')]), cNotM('autosize', 'width: 100%;'), cM('autosize', [cE('textarea-el, input-el', `
  position: absolute;
  top: 0;
  left: 0;
@@ -102,11 +101,11 @@ cB('input-wrapper', `
  display: inline-flex;
  flex-grow: 1;
  position: relative;
- padding-left: var(--padding-left);
- padding-right: var(--padding-right);
+ padding-left: var(--n-padding-left);
+ padding-right: var(--n-padding-right);
  `), cE('input-mirror', `
  padding: 0;
- height: var(--height);
+ height: var(--n-height);
  overflow: hidden;
  visibility: hidden;
  position: static;
@@ -114,37 +113,37 @@ cB('input-wrapper', `
  pointer-events: none;
  `), cE('input-el', `
  padding: 0;
- height: var(--height);
- line-height: var(--height);
+ height: var(--n-height);
+ line-height: var(--n-height);
  `, [c('+', [cE('placeholder', `
  display: flex;
  align-items: center; 
- `)])]), cNotM('textarea', [cE('placeholder', {
-  whiteSpace: 'nowrap'
-})]), cE('eye', `
- transition: color .3s var(--bezier);
+ `)])]), cNotM('textarea', [cE('placeholder', 'white-space: nowrap;')]), cE('eye', `
+ transition: color .3s var(--n-bezier);
  `), // textarea
-cM('textarea', {
-  width: '100%'
-}, [cB('input-word-count', `
+cM('textarea', 'width: 100%;', [cB('input-word-count', `
  position: absolute;
- right: var(--padding-right);
- bottom: var(--padding-vertical);
+ right: var(--n-padding-right);
+ bottom: var(--n-padding-vertical);
  `), cM('resizable', [cB('input-wrapper', `
  resize: vertical;
- overflow: auto;
- min-height: var(--height);
- `)]), cE('textarea-el, textarea-mirror, placeholder', `
- width: 100%;
+ min-height: var(--n-height);
+ `)]), // override scrollbar relative position
+cE('textarea', `
+ position: static;
+ `), cE('textarea-el, textarea-mirror, placeholder', `
  height: 100%;
+ left: var(--n-padding-left);
+ right: var(--n-padding-right);
  padding-left: 0;
  padding-right: 0;
- padding-top: var(--padding-vertical);
- padding-bottom: var(--padding-vertical);
+ padding-top: var(--n-padding-vertical);
+ padding-bottom: var(--n-padding-vertical);
+ word-break: break-word;
  display: inline-block;
  vertical-align: bottom;
  box-sizing: border-box;
- line-height: var(--line-height-textarea);
+ line-height: var(--n-line-height-textarea);
  margin: 0;
  resize: none;
  `), cE('textarea-mirror', `
@@ -155,55 +154,41 @@ cM('textarea', {
  white-space: pre-wrap;
  overflow-wrap: break-word;
  `)]), // pair
-cM('pair', [cE('input-el, placeholder', {
-  textAlign: 'center'
-}), cE('separator', `
+cM('pair', [cE('input-el, placeholder', 'text-align: center;'), cE('separator', `
  display: flex;
  align-items: center;
- transition: color .3s var(--bezier);
- color: var(--text-color);
+ transition: color .3s var(--n-bezier);
+ color: var(--n-text-color);
  `, [cB('icon', `
- color: var(--icon-color);
+ color: var(--n-icon-color);
  `), cB('base-icon', `
- color: var(--icon-color);
- `)])]), cM('disabled', {
-  cursor: 'not-allowed',
-  backgroundColor: 'var(--color-disabled)'
-}, [cE('border', {
-  border: 'var(--border-disabled)'
-}), cE('input-el, textarea-el', {
-  cursor: 'not-allowed',
-  color: 'var(--text-color-disabled)',
-  textDecorationColor: 'var(--text-color-disabled)'
-}), cE('placeholder', {
-  color: 'var(--placeholder-color-disabled)'
-}), cE('separator', {
-  color: 'var(--text-color-disabled)'
-}, [cB('icon', `
- color: var(--icon-color-disabled);
+ color: var(--n-icon-color);
+ `)])]), cM('disabled', `
+ cursor: not-allowed;
+ background-color: var(--n-color-disabled);
+ `, [cE('border', 'border: var(--n-border-disabled);'), cE('input-el, textarea-el', `
+ cursor: not-allowed;
+ color: var(--n-text-color-disabled);
+ text-decoration-color: var(--n-text-color-disabled);
+ `), cE('placeholder', 'color: var(--n-placeholder-color-disabled);'), cE('separator', 'color: var(--n-text-color-disabled);', [cB('icon', `
+ color: var(--n-icon-color-disabled);
  `), cB('base-icon', `
- color: var(--icon-color-disabled);
- `)]), cE('suffix, prefix', {
-  color: 'var(--text-color-disabled)'
-}, [cB('icon', `
- color: var(--icon-color-disabled);
+ color: var(--n-icon-color-disabled);
+ `)]), cE('suffix, prefix', 'color: var(--n-text-color-disabled);', [cB('icon', `
+ color: var(--n-icon-color-disabled);
  `), cB('internal-icon', `
- color: var(--icon-color-disabled);
+ color: var(--n-icon-color-disabled);
  `)])]), cNotM('disabled', [cE('eye', `
- color: var(--icon-color);
+ color: var(--n-icon-color);
  cursor: pointer;
  `, [c('&:hover', `
- color: var(--icon-color-hover);
+ color: var(--n-icon-color-hover);
  `), c('&:active', `
- color: var(--icon-color-pressed);
- `)]), cM('focus', {
-  backgroundColor: 'var(--color-focus)'
-}, [cE('state-border', {
-  border: 'var(--border-focus)',
-  boxShadow: 'var(--box-shadow-focus)'
-})]), c('&:hover', [cE('state-border', {
-  border: 'var(--border-hover)'
-})])]), cE('border, state-border', `
+ color: var(--n-icon-color-pressed);
+ `)]), cM('focus', 'background-color: var(--n-color-focus);', [cE('state-border', `
+ border: var(--n-border-focus);
+ box-shadow: var(--n-box-shadow-focus);
+ `)]), c('&:hover', [cE('state-border', 'border: var(--n-border-hover);')])]), cE('border, state-border', `
  box-sizing: border-box;
  position: absolute;
  left: 0;
@@ -212,68 +197,65 @@ cM('pair', [cE('input-el, placeholder', {
  bottom: 0;
  pointer-events: none;
  border-radius: inherit;
- border: var(--border);
+ border: var(--n-border);
  transition:
- box-shadow .3s var(--bezier),
- border-color .3s var(--bezier);
+ box-shadow .3s var(--n-bezier),
+ border-color .3s var(--n-bezier);
  `), cE('state-border', `
  border-color: #0000;
  z-index: 1;
- `), cE('prefix', {
-  marginRight: '4px'
-}), cE('suffix', `
+ `), cE('prefix', 'margin-right: 4px;'), cE('suffix', `
  margin-left: 4px;
  `), cE('suffix, prefix', `
- transition: color .3s var(--bezier);
+ transition: color .3s var(--n-bezier);
  flex-wrap: nowrap;
  flex-shrink: 0;
- line-height: var(--height);
+ line-height: var(--n-height);
  white-space: nowrap;
  display: inline-flex;
  align-items: center;
  justify-content: center;
- color: var(--suffix-text-color);
+ color: var(--n-suffix-text-color);
  `, [cB('base-loading', `
- font-size: var(--icon-size);
- margin-left: 4px;
- color: var(--loading-color);
+ font-size: var(--n-icon-size);
+ margin: 0 2px;
+ color: var(--n-loading-color);
  `), cB('base-clear', `
- font-size: var(--icon-size);
- margin-left: 4px;
+ font-size: var(--n-icon-size);
  `, [cE('placeholder', [cB('base-icon', `
- transition: color .3s var(--bezier);
- color: var(--icon-color);
- font-size: var(--icon-size);
+ transition: color .3s var(--n-bezier);
+ color: var(--n-icon-color);
+ font-size: var(--n-icon-size);
  `)])]), cB('icon', `
- transition: color .3s var(--bezier);
- color: var(--icon-color);
- font-size: var(--icon-size);
+ transition: color .3s var(--n-bezier);
+ color: var(--n-icon-color);
+ font-size: var(--n-icon-size);
  `), cB('base-icon', `
- font-size: var(--icon-size);
+ font-size: var(--n-icon-size);
  `)]), cB('input-word-count', `
  pointer-events: none;
  line-height: 1.5;
  font-size: .85em;
- color: var(--count-text-color);
- transition: color .3s var(--bezier);
+ color: var(--n-count-text-color);
+ transition: color .3s var(--n-bezier);
  margin-left: 4px;
  font-variant: tabular-nums;
  `)]), ['warning', 'error'].map(status => insideFormItem(status, cB('input', [cNotM('disabled', [cB('base-loading', `
- color: var(--loading-color-${status})
- `), cE('input-el, textarea-el', {
-  caretColor: `var(--caret-color-${status})`
-}), cE('state-border', {
-  border: `var(--border-${status})`
-}), c('&:hover', [cE('state-border', `
- border: var(--border-hover-${status});
- `)]), c('&:focus', {
-  backgroundColor: `var(--color-focus-${status})`
-}, [cE('state-border', `
- box-shadow: var(--box-shadow-focus-${status});
- border: var(--border-focus-${status});
- `)]), cM('focus', {
-  backgroundColor: `var(--color-focus-${status})`
-}, [cE('state-border', `
- box-shadow: var(--box-shadow-focus-${status});
- border: var(--border-focus-${status});
+ color: var(--n-loading-color-${status})
+ `), cE('input-el, textarea-el', `
+ caret-color: var(--n-caret-color-${status});
+ `), cE('state-border', `
+ border: var(--n-border-${status});
+ `), c('&:hover', [cE('state-border', `
+ border: var(--n-border-hover-${status});
+ `)]), c('&:focus', `
+ background-color: var(--n-color-focus-${status});
+ `, [cE('state-border', `
+ box-shadow: var(--n-box-shadow-focus-${status});
+ border: var(--n-border-focus-${status});
+ `)]), cM('focus', `
+ background-color: var(--n-color-focus-${status});
+ `, [cE('state-border', `
+ box-shadow: var(--n-box-shadow-focus-${status});
+ border: var(--n-border-focus-${status});
  `)])])])))]);

package/es/input-number/src/InputNumber.d.ts

@@ -2,6 +2,10 @@ import { PropType } from 'vue';
 import { MaybeArray, ExtractPublicPropTypes } from '../../_utils';
 import type { OnUpdateValue } from './interface';
 declare const inputNumberProps: {
+    loading: {
+        type: BooleanConstructor;
+        default: undefined;
+    };
     placeholder: StringConstructor;
     defaultValue: {
         type: PropType<number | null>;
@@ -858,6 +862,10 @@ declare const inputNumberProps: {
 };
 export declare type InputNumberProps = ExtractPublicPropTypes<typeof inputNumberProps>;
 declare const _default: import("vue").DefineComponent<{
+    loading: {
+        type: BooleanConstructor;
+        default: undefined;
+    };
     placeholder: StringConstructor;
     defaultValue: {
         type: PropType<number | null>;
@@ -2145,53 +2153,61 @@ declare const _default: import("vue").DefineComponent<{
     }>;
     focus: () => void;
     blur: () => void;
-}, unknown, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, Record<string, any>, string, import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly<{
-    placeholder?: unknown;
-    defaultValue?: unknown;
-    value?: unknown;
-    step?: unknown;
-    min?: unknown;
-    max?: unknown;
-    size?: unknown;
-    disabled?: unknown;
-    validator?: unknown;
-    bordered?: unknown;
-    showButton?: unknown;
-    readonly?: unknown;
-    clearable?: unknown;
-    keyboard?: unknown;
-    updateValueOnInput?: unknown;
-    'onUpdate:value'?: unknown;
-    onUpdateValue?: unknown;
-    onFocus?: unknown;
-    onBlur?: unknown;
-    onClear?: unknown;
-    onChange?: unknown;
-    theme?: unknown;
-    themeOverrides?: unknown;
-    builtinThemeOverrides?: unknown;
-} & {
-    readonly: boolean;
-    step: string | number;
-    clearable: boolean;
-    defaultValue: number | null;
+}, unknown, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, Record<string, any>, string, import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly<import("vue").ExtractPropTypes<{
+    loading: {
+        type: BooleanConstructor;
+        default: undefined;
+    };
+    placeholder: StringConstructor;
+    defaultValue: {
+        type: PropType<number | null>;
+        default: null;
+    };
+    value: PropType<number | null>;
+    step: {
+        type: (StringConstructor | NumberConstructor)[];
+        default: number;
+    };
+    min: (StringConstructor | NumberConstructor)[];
+    max: (StringConstructor | NumberConstructor)[];
+    size: PropType<"small" | "medium" | "large">;
+    disabled: {
+        type: PropType<boolean | undefined>;
+        default: undefined;
+    };
+    validator: PropType<(value: number) => boolean>;
+    bordered: {
+        type: PropType<boolean | undefined>;
+        default: undefined;
+    };
+    showButton: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    readonly: BooleanConstructor;
+    clearable: BooleanConstructor;
     keyboard: {
-        ArrowUp?: boolean | undefined;
-        ArrowDown?: boolean | undefined;
+        type: PropType<{
+            ArrowUp?: boolean | undefined;
+            ArrowDown?: boolean | undefined;
+        }>;
+        default: {};
     };
-    showButton: boolean;
-    updateValueOnInput: boolean;
-} & {
-    value?: number | null | undefined;
-    size?: "small" | "medium" | "large" | undefined;
-    disabled?: boolean | undefined;
-    onFocus?: MaybeArray<(e: FocusEvent) => void> | undefined;
-    onBlur?: MaybeArray<(e: FocusEvent) => void> | undefined;
-    onChange?: MaybeArray<OnUpdateValue> | undefined;
-    placeholder?: string | undefined;
-    max?: string | number | undefined;
-    min?: string | number | undefined;
-    theme?: import("../../_mixins").Theme<"InputNumber", {
+    updateValueOnInput: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    'onUpdate:value': PropType<MaybeArray<OnUpdateValue>>;
+    onUpdateValue: PropType<MaybeArray<OnUpdateValue>>;
+    onFocus: PropType<MaybeArray<(e: FocusEvent) => void>>;
+    onBlur: PropType<MaybeArray<(e: FocusEvent) => void>>;
+    onClear: PropType<MaybeArray<(e: MouseEvent) => void>>;
+    onChange: {
+        type: PropType<MaybeArray<OnUpdateValue> | undefined>;
+        validator: () => boolean;
+        default: undefined;
+    };
+    theme: PropType<import("../../_mixins").Theme<"InputNumber", {
         iconColorDisabled: string;
     }, {
         Button: import("../../_mixins").Theme<"Button", {
@@ -2458,8 +2474,8 @@ declare const _default: import("vue").DefineComponent<{
             paddingLarge: string;
             clearSize: string;
         }, any>;
-    }> | undefined;
-    themeOverrides?: import("../../_mixins/use-theme").ExtractThemeOverrides<import("../../_mixins").Theme<"InputNumber", {
+    }>>;
+    themeOverrides: PropType<import("../../_mixins/use-theme").ExtractThemeOverrides<import("../../_mixins").Theme<"InputNumber", {
         iconColorDisabled: string;
     }, {
         Button: import("../../_mixins").Theme<"Button", {
@@ -2726,8 +2742,8 @@ declare const _default: import("vue").DefineComponent<{
             paddingLarge: string;
             clearSize: string;
         }, any>;
-    }>> | undefined;
-    builtinThemeOverrides?: import("../../_mixins/use-theme").ExtractThemeOverrides<import("../../_mixins").Theme<"InputNumber", {
+    }>>>;
+    builtinThemeOverrides: PropType<import("../../_mixins/use-theme").ExtractThemeOverrides<import("../../_mixins").Theme<"InputNumber", {
         iconColorDisabled: string;
     }, {
         Button: import("../../_mixins").Theme<"Button", {
@@ -2994,17 +3010,13 @@ declare const _default: import("vue").DefineComponent<{
             paddingLarge: string;
             clearSize: string;
         }, any>;
-    }>> | undefined;
-    bordered?: boolean | undefined;
-    validator?: ((value: number) => boolean) | undefined;
-    onClear?: MaybeArray<(e: MouseEvent) => void> | undefined;
-    "onUpdate:value"?: MaybeArray<OnUpdateValue> | undefined;
-    onUpdateValue?: MaybeArray<OnUpdateValue> | undefined;
-}>, {
+    }>>>;
+}>>, {
     readonly: boolean;
     disabled: boolean | undefined;
     step: string | number;
     onChange: MaybeArray<OnUpdateValue> | undefined;
+    loading: boolean;
     bordered: boolean | undefined;
     clearable: boolean;
     defaultValue: number | null;

package/es/input-number/src/InputNumber.js

@@ -10,7 +10,10 @@ import { warn, call } from '../../_utils';
 import { inputNumberLight } from '../styles';
 import { parse, validator, format, parseNumber, isWipValue } from './utils';
 import style from './styles/input-number.cssr';
-const inputNumberProps = Object.assign(Object.assign({}, useTheme.props), { placeholder: String, defaultValue: {
+const inputNumberProps = Object.assign(Object.assign({}, useTheme.props), { loading: {
+        type: Boolean,
+        default: undefined
+    }, placeholder: String, defaultValue: {
         type: Number,
         default: null
     }, value: Number, step: {
@@ -365,7 +368,7 @@ export default defineComponent({
     render() {
         const { mergedClsPrefix } = this;
         return (h("div", { class: `${mergedClsPrefix}-input-number` },
-            h(NInput, { ref: "inputInstRef", bordered: this.mergedBordered, value: this.displayedValue, onUpdateValue: this.handleUpdateDisplayedValue, theme: this.mergedTheme.peers.Input, themeOverrides: this.mergedTheme.peerOverrides.Input, builtinThemeOverrides: this.inputThemeOverrides, size: this.mergedSize, placeholder: this.mergedPlaceholder, disabled: this.mergedDisabled, readonly: this.readonly, textDecoration: this.displayedValueInvalid ? 'line-through' : undefined, onFocus: this.handleFocus, onBlur: this.handleBlur, onKeydown: this.handleKeyDown, onMousedown: this.handleMouseDown, onClear: this.handleClear, clearable: this.clearable }, {
+            h(NInput, { ref: "inputInstRef", bordered: this.mergedBordered, loading: this.loading, value: this.displayedValue, onUpdateValue: this.handleUpdateDisplayedValue, theme: this.mergedTheme.peers.Input, themeOverrides: this.mergedTheme.peerOverrides.Input, builtinThemeOverrides: this.inputThemeOverrides, size: this.mergedSize, placeholder: this.mergedPlaceholder, disabled: this.mergedDisabled, readonly: this.readonly, textDecoration: this.displayedValueInvalid ? 'line-through' : undefined, onFocus: this.handleFocus, onBlur: this.handleBlur, onKeydown: this.handleKeyDown, onMousedown: this.handleMouseDown, onClear: this.handleClear, clearable: this.clearable, internalLoadingBeforeSuffix: true }, {
                 _: 2,
                 prefix: this.$slots.prefix,
                 suffix: this.showButton

package/es/input-number/src/utils.js

@@ -9,8 +9,9 @@ export function parse(value) {
     return Number(value);
 }
 // can be parsed to number but shouldn't be applied when inputing
+// when value includes `.`, ending with 0 and`.`, doesn't update, if 0 parse func will remove 0
 export function isWipValue(value) {
-    return /^(-)?\d+\.$/.test(value) || /^\.\d+$/.test(value);
+    return value.includes('.') && (/^(-)?\d+.*(\.|0)$/.test(value) || /^\.\d+$/.test(value));
 }
 // string => boolean (expected, not implemented)
 // number => boolean (legacy)