Add rules for Float16Array (#239)

Author: ota-meshi

docs/.vitepress/theme/components/eslint-playground.vue

@@ -2,6 +2,7 @@
 import EslintEditor from "./eslint-editor.vue"
 import { markRaw, ref, reactive, computed, onMounted, useSlots } from "vue"
 import * as plugin from "../../../.."
+import { builtin } from "globals"
 const { rules } = plugin.default || plugin
 
 const props = defineProps({
@@ -56,6 +57,10 @@ const config = computed(() => ({
                 jsx: true,
             },
         },
+        globals: {
+            Float16Array: "readonly",
+            ...builtin,
+        },
     },
     rules: {},
     settings: {

docs/configs/index.md

@@ -1029,6 +1029,34 @@ export default [
 }
 ```
 
+## no-float16array
+
+disallow proposal ES2025 [Float16Array](https://github.com/tc39/proposal-float16array)\
+⚠️ This config will be changed in the minor versions of this plugin.
+
+This configs includes rules for [es-x/no-dataview-prototype-getfloat16-setfloat16](../rules/no-dataview-prototype-getfloat16-setfloat16.md), [es-x/no-float16array](../rules/no-float16array.md), and [es-x/no-math-f16round](../rules/no-math-f16round.md).
+
+### [Config (Flat Config)]
+
+eslint.config.js:
+
+```js
+import pluginESx from "eslint-plugin-es-x"
+export default [
+    pluginESx.configs['flat/no-float16array']
+]
+```
+
+### [Legacy Config]
+
+.eslintrc.*:
+
+```json
+{
+    "extends": ["plugin:es-x/no-float16array"],
+}
+```
+
 ## no-import-attributes
 
 disallow proposal ES2025 [Import Attributes](https://github.com/tc39/proposal-import-attributes)\

docs/rules/index.md

@@ -10,7 +10,9 @@ There is a config that enables the rules in this category: [`no-new-in-esnext`]
 
 | Rule ID | Description |    |
 |:--------|:------------|:--:|
+| [es-x/no-dataview-prototype-getfloat16-setfloat16](./no-dataview-prototype-getfloat16-setfloat16.md) | disallow the `DataView.prototype.{getFloat16,setFloat16}` methods. |  |
 | [es-x/no-dynamic-import-options](./no-dynamic-import-options.md) | disallow the second parameter to `import()`. |  |
+| [es-x/no-float16array](./no-float16array.md) | disallow the `Float16Array` class. |  |
 | [es-x/no-import-attributes](./no-import-attributes.md) | disallow Import Attributes. |  |
 | [es-x/no-iterator-prototype-drop](./no-iterator-prototype-drop.md) | disallow the `Iterator.prototype.drop` method. |  |
 | [es-x/no-iterator-prototype-every](./no-iterator-prototype-every.md) | disallow the `Iterator.prototype.every` method. |  |
@@ -25,6 +27,7 @@ There is a config that enables the rules in this category: [`no-new-in-esnext`]
 | [es-x/no-iterator-prototype-toarray](./no-iterator-prototype-toarray.md) | disallow the `Iterator.prototype.toArray` method. |  |
 | [es-x/no-iterator](./no-iterator.md) | disallow the `Iterator` class. |  |
 | [es-x/no-json-modules](./no-json-modules.md) | disallow JSON Modules. |  |
+| [es-x/no-math-f16round](./no-math-f16round.md) | disallow the `Math.f16round` method. |  |
 | [es-x/no-promise-try](./no-promise-try.md) | disallow `Promise.try` function. |  |
 | [es-x/no-regexp-duplicate-named-capturing-groups](./no-regexp-duplicate-named-capturing-groups.md) | disallow RegExp duplicate named capturing groups. |  |
 | [es-x/no-regexp-escape](./no-regexp-escape.md) | disallow `RegExp.escape` function. |  |

docs/rules/no-dataview-prototype-getfloat16-setfloat16.md

@@ -0,0 +1,40 @@
+---
+title: "es-x/no-dataview-prototype-getfloat16-setfloat16"
+description: "disallow the `DataView.prototype.{getFloat16,setFloat16}` methods"
+---
+
+# es-x/no-dataview-prototype-getfloat16-setfloat16
+> disallow the `DataView.prototype.{getFloat16,setFloat16}` methods
+
+- ❗ <badge text="This rule has not been released yet." vertical="middle" type="error"> ***This rule has not been released yet.*** </badge>
+- ✅ The following configurations enable this rule: [no-float16array] and [no-new-in-esnext]
+
+This rule reports ES2025 [`DataView.prototype.{getFloat16,setFloat16}` methods](https://github.com/tc39/proposal-float16array) as errors.
+
+This rule is silent by default because it's hard to know types. You need to configure [the aggressive mode](../#the-aggressive-mode) or TypeScript in order to enable this rule.
+
+## 💡 Examples
+
+⛔ Examples of **incorrect** code for this rule:
+
+<eslint-playground type="bad">
+
+```js
+/*eslint es-x/no-dataview-prototype-getfloat16-setfloat16: error */
+const buffer = new ArrayBuffer(16);
+
+const view = new DataView(buffer);
+view.setFloat16(1, Math.PI);
+
+console.log(view.getFloat16(1));
+```
+
+</eslint-playground>
+
+## 📚 References
+
+- [Rule source](https://github.com/eslint-community/eslint-plugin-es-x/blob/master/lib/rules/no-dataview-prototype-getfloat16-setfloat16.js)
+- [Test source](https://github.com/eslint-community/eslint-plugin-es-x/blob/master/tests/lib/rules/no-dataview-prototype-getfloat16-setfloat16.js)
+
+[no-float16array]: ../configs/index.md#no-float16array
+[no-new-in-esnext]: ../configs/index.md#no-new-in-esnext

docs/rules/no-float16array.md

@@ -0,0 +1,33 @@
+---
+title: "es-x/no-float16array"
+description: "disallow the `Float16Array` class"
+---
+
+# es-x/no-float16array
+> disallow the `Float16Array` class
+
+- ❗ <badge text="This rule has not been released yet." vertical="middle" type="error"> ***This rule has not been released yet.*** </badge>
+- ✅ The following configurations enable this rule: [no-float16array] and [no-new-in-esnext]
+
+This rule reports ES2025 [`Float16Array` class](https://github.com/tc39/proposal-float16array) as errors.
+
+## 💡 Examples
+
+⛔ Examples of **incorrect** code for this rule:
+
+<eslint-playground type="bad">
+
+```js
+/*eslint es-x/no-float16array: error */
+const float16 = new Float16Array(2);
+```
+
+</eslint-playground>
+
+## 📚 References
+
+- [Rule source](https://github.com/eslint-community/eslint-plugin-es-x/blob/master/lib/rules/no-float16array.js)
+- [Test source](https://github.com/eslint-community/eslint-plugin-es-x/blob/master/tests/lib/rules/no-float16array.js)
+
+[no-float16array]: ../configs/index.md#no-float16array
+[no-new-in-esnext]: ../configs/index.md#no-new-in-esnext

docs/rules/no-math-f16round.md

@@ -0,0 +1,33 @@
+---
+title: "es-x/no-math-f16round"
+description: "disallow the `Math.f16round` method"
+---
+
+# es-x/no-math-f16round
+> disallow the `Math.f16round` method
+
+- ❗ <badge text="This rule has not been released yet." vertical="middle" type="error"> ***This rule has not been released yet.*** </badge>
+- ✅ The following configurations enable this rule: [no-float16array] and [no-new-in-esnext]
+
+This rule reports ES2025 [`Math.f16round` method](https://github.com/tc39/proposal-float16array) as errors.
+
+## 💡 Examples
+
+⛔ Examples of **incorrect** code for this rule:
+
+<eslint-playground type="bad">
+
+```js
+/*eslint es-x/no-math-f16round: error */
+const n = Math.f16round(value)
+```
+
+</eslint-playground>
+
+## 📚 References
+
+- [Rule source](https://github.com/eslint-community/eslint-plugin-es-x/blob/master/lib/rules/no-math-f16round.js)
+- [Test source](https://github.com/eslint-community/eslint-plugin-es-x/blob/master/tests/lib/rules/no-math-f16round.js)
+
+[no-float16array]: ../configs/index.md#no-float16array
+[no-new-in-esnext]: ../configs/index.md#no-new-in-esnext

lib/configs/flat/no-float16array.js

@@ -0,0 +1,18 @@
+/**
+ * DON'T EDIT THIS FILE.
+ * This file was generated by "scripts/update-lib-flat-configs.js" script.
+ */
+"use strict"
+
+module.exports = {
+    plugins: {
+        get "es-x"() {
+            return require("../../index.js")
+        },
+    },
+    rules: {
+        "es-x/no-dataview-prototype-getfloat16-setfloat16": "error",
+        "es-x/no-float16array": "error",
+        "es-x/no-math-f16round": "error",
+    },
+}

lib/configs/flat/no-new-in-esnext.js

@@ -11,7 +11,9 @@ module.exports = {
         },
     },
     rules: {
+        "es-x/no-dataview-prototype-getfloat16-setfloat16": "error",
         "es-x/no-dynamic-import-options": "error",
+        "es-x/no-float16array": "error",
         "es-x/no-import-attributes": "error",
         "es-x/no-iterator-prototype-drop": "error",
         "es-x/no-iterator-prototype-every": "error",
@@ -26,6 +28,7 @@ module.exports = {
         "es-x/no-iterator-prototype-toarray": "error",
         "es-x/no-iterator": "error",
         "es-x/no-json-modules": "error",
+        "es-x/no-math-f16round": "error",
         "es-x/no-promise-try": "error",
         "es-x/no-regexp-duplicate-named-capturing-groups": "error",
         "es-x/no-regexp-escape": "error",

lib/configs/no-float16array.js

@@ -0,0 +1,14 @@
+/**
+ * DON'T EDIT THIS FILE.
+ * This file was generated by "scripts/update-lib-configs.js" script.
+ */
+"use strict"
+
+module.exports = {
+    plugins: ["es-x"],
+    rules: {
+        "es-x/no-dataview-prototype-getfloat16-setfloat16": "error",
+        "es-x/no-float16array": "error",
+        "es-x/no-math-f16round": "error",
+    },
+}

lib/configs/no-new-in-esnext.js

@@ -7,7 +7,9 @@
 module.exports = {
     plugins: ["es-x"],
     rules: {
+        "es-x/no-dataview-prototype-getfloat16-setfloat16": "error",
         "es-x/no-dynamic-import-options": "error",
+        "es-x/no-float16array": "error",
         "es-x/no-import-attributes": "error",
         "es-x/no-iterator-prototype-drop": "error",
         "es-x/no-iterator-prototype-every": "error",
@@ -22,6 +24,7 @@ module.exports = {
         "es-x/no-iterator-prototype-toarray": "error",
         "es-x/no-iterator": "error",
         "es-x/no-json-modules": "error",
+        "es-x/no-math-f16round": "error",
         "es-x/no-promise-try": "error",
         "es-x/no-regexp-duplicate-named-capturing-groups": "error",
         "es-x/no-regexp-escape": "error",