feat: warn when using --unstable, prefer granular flags (#21452)

This commit deprecates "--unstable" flag. 

When "--unstable" flag is encountered a warning like this is printed:
```
The `--unstable` flag is deprecated, use granular `--unstable-*` flags instead.
Learn more at: https://docs.deno.com/runtime/manual/tools/unstable_flags
```
When "--unstable" flag is used and an unstable API is called an
additional warning like this is printed for each API call:
```
The `Deno.dlopen` API was used with `--unstable` flag. The `--unstable` flag is deprecated, use granular `--unstable-ffi` instead. 
Learn more at: https://docs.deno.com/runtime/manual/tools/unstable_flags
```
When no "--unstable-*" flag is provided and an unstable API is called
following
warning is issued before exiting:
```
Unstable API 'Deno.dlopen'. The `--unstable-ffi` flag must be provided.
```

---------

Signed-off-by: Divy Srivastava <dj.srivastava23@gmail.com>
Signed-off-by: Bartek Iwańczuk <biwanczuk@gmail.com>
Co-authored-by: Divy Srivastava <dj.srivastava23@gmail.com>
Co-authored-by: Asher Gomez <ashersaupingomez@gmail.com>

21 files changed, 21 insertions, 21 deletions

diff --git a/cli/tests/testdata/npm/registry/@denotest/child-process-fork/1.0.0/index.js b/cli/tests/testdata/npm/registry/@denotest/child-process-fork/1.0.0/index.js
index 9f84afe35..0482be404 100644
--- a/cli/tests/testdata/npm/registry/@denotest/child-process-fork/1.0.0/index.js
+++ b/cli/tests/testdata/npm/registry/@denotest/child-process-fork/1.0.0/index.js
@@ -2,7 +2,7 @@ const path = require("path");
 
 function childProcessFork(path) {
   const command = new Deno.Command(Deno.execPath(), {
-    args: ["run", "--unstable", "-A", path],
+    args: ["run", "-A", path],
     env: {
       "DENO_DONT_USE_INTERNAL_NODE_COMPAT_STATE": Deno[Deno.internal].core.ops.op_npm_process_state(),
     }
diff --git a/cli/tests/testdata/run/ffi/unstable_ffi_1.js.out b/cli/tests/testdata/run/ffi/unstable_ffi_1.js.out
index 7c564be8c..fe172c2c6 100644
--- a/cli/tests/testdata/run/ffi/unstable_ffi_1.js.out
+++ b/cli/tests/testdata/run/ffi/unstable_ffi_1.js.out
@@ -1 +1 @@
-Unstable API 'Deno.dlopen'. The --unstable flag must be provided.
+Unstable API 'Deno.dlopen'. The `--unstable-ffi` flag must be provided.
diff --git a/cli/tests/testdata/run/ffi/unstable_ffi_10.js.out b/cli/tests/testdata/run/ffi/unstable_ffi_10.js.out
index bf7e1bd4f..b9fe500b5 100644
--- a/cli/tests/testdata/run/ffi/unstable_ffi_10.js.out
+++ b/cli/tests/testdata/run/ffi/unstable_ffi_10.js.out
@@ -1 +1 @@
-Unstable API 'Deno.UnsafePointerView#getInt16'. The --unstable flag must be provided.
+Unstable API 'Deno.UnsafePointerView#getInt16'. The `--unstable-ffi` flag must be provided.
diff --git a/cli/tests/testdata/run/ffi/unstable_ffi_11.js.out b/cli/tests/testdata/run/ffi/unstable_ffi_11.js.out
index 2d2d72666..74039db43 100644
--- a/cli/tests/testdata/run/ffi/unstable_ffi_11.js.out
+++ b/cli/tests/testdata/run/ffi/unstable_ffi_11.js.out
@@ -1 +1 @@
-Unstable API 'Deno.UnsafePointerView#getUint32'. The --unstable flag must be provided.
+Unstable API 'Deno.UnsafePointerView#getUint32'. The `--unstable-ffi` flag must be provided.
diff --git a/cli/tests/testdata/run/ffi/unstable_ffi_12.js.out b/cli/tests/testdata/run/ffi/unstable_ffi_12.js.out
index 377d8e4a5..1a366b8c6 100644
--- a/cli/tests/testdata/run/ffi/unstable_ffi_12.js.out
+++ b/cli/tests/testdata/run/ffi/unstable_ffi_12.js.out
@@ -1 +1 @@
-Unstable API 'Deno.UnsafePointerView#getInt32'. The --unstable flag must be provided.
+Unstable API 'Deno.UnsafePointerView#getInt32'. The `--unstable-ffi` flag must be provided.
diff --git a/cli/tests/testdata/run/ffi/unstable_ffi_13.js.out b/cli/tests/testdata/run/ffi/unstable_ffi_13.js.out
index 6ca67a6f2..93afbe5ed 100644
--- a/cli/tests/testdata/run/ffi/unstable_ffi_13.js.out
+++ b/cli/tests/testdata/run/ffi/unstable_ffi_13.js.out
@@ -1 +1 @@
-Unstable API 'Deno.UnsafePointerView#getBigUint64'. The --unstable flag must be provided.
+Unstable API 'Deno.UnsafePointerView#getBigUint64'. The `--unstable-ffi` flag must be provided.
diff --git a/cli/tests/testdata/run/ffi/unstable_ffi_14.js.out b/cli/tests/testdata/run/ffi/unstable_ffi_14.js.out
index 11fcd5580..7f4c900f8 100644
--- a/cli/tests/testdata/run/ffi/unstable_ffi_14.js.out
+++ b/cli/tests/testdata/run/ffi/unstable_ffi_14.js.out
@@ -1 +1 @@
-Unstable API 'Deno.UnsafePointerView#getFloat32'. The --unstable flag must be provided.
+Unstable API 'Deno.UnsafePointerView#getFloat32'. The `--unstable-ffi` flag must be provided.
diff --git a/cli/tests/testdata/run/ffi/unstable_ffi_15.js.out b/cli/tests/testdata/run/ffi/unstable_ffi_15.js.out
index 3015e5c91..5e2c55968 100644
--- a/cli/tests/testdata/run/ffi/unstable_ffi_15.js.out
+++ b/cli/tests/testdata/run/ffi/unstable_ffi_15.js.out
@@ -1 +1 @@
-Unstable API 'Deno.UnsafePointerView#getFloat64'. The --unstable flag must be provided.
+Unstable API 'Deno.UnsafePointerView#getFloat64'. The `--unstable-ffi` flag must be provided.
diff --git a/cli/tests/testdata/run/ffi/unstable_ffi_16.js.out b/cli/tests/testdata/run/ffi/unstable_ffi_16.js.out
index d68870784..05362e5b3 100644
--- a/cli/tests/testdata/run/ffi/unstable_ffi_16.js.out
+++ b/cli/tests/testdata/run/ffi/unstable_ffi_16.js.out
@@ -1 +1 @@
-Unstable API 'Deno.UnsafePointer#value'. The --unstable flag must be provided.
+Unstable API 'Deno.UnsafePointer#value'. The `--unstable-ffi` flag must be provided.
diff --git a/cli/tests/testdata/run/ffi/unstable_ffi_17.js.out b/cli/tests/testdata/run/ffi/unstable_ffi_17.js.out
index 294931243..c9d6ca821 100644
--- a/cli/tests/testdata/run/ffi/unstable_ffi_17.js.out
+++ b/cli/tests/testdata/run/ffi/unstable_ffi_17.js.out
@@ -1 +1 @@
-Unstable API 'Deno.UnsafePointerView#getArrayBuffer'. The --unstable flag must be provided.
+Unstable API 'Deno.UnsafePointerView#getArrayBuffer'. The `--unstable-ffi` flag must be provided.
diff --git a/cli/tests/testdata/run/ffi/unstable_ffi_18.js.out b/cli/tests/testdata/run/ffi/unstable_ffi_18.js.out
index 6f7ea0d8f..2474f86bd 100644
--- a/cli/tests/testdata/run/ffi/unstable_ffi_18.js.out
+++ b/cli/tests/testdata/run/ffi/unstable_ffi_18.js.out
@@ -1 +1 @@
-Unstable API 'Deno.UnsafePointer#create'. The --unstable flag must be provided.
+Unstable API 'Deno.UnsafePointer#create'. The `--unstable-ffi` flag must be provided.
diff --git a/cli/tests/testdata/run/ffi/unstable_ffi_19.js.out b/cli/tests/testdata/run/ffi/unstable_ffi_19.js.out
index 15a99b9ab..8d97f87e9 100644
--- a/cli/tests/testdata/run/ffi/unstable_ffi_19.js.out
+++ b/cli/tests/testdata/run/ffi/unstable_ffi_19.js.out
@@ -1 +1 @@
-Unstable API 'Deno.UnsafePointer#equals'. The --unstable flag must be provided.
+Unstable API 'Deno.UnsafePointer#equals'. The `--unstable-ffi` flag must be provided.
diff --git a/cli/tests/testdata/run/ffi/unstable_ffi_2.js.out b/cli/tests/testdata/run/ffi/unstable_ffi_2.js.out
index cc4cc3dc6..094a69b5b 100644
--- a/cli/tests/testdata/run/ffi/unstable_ffi_2.js.out
+++ b/cli/tests/testdata/run/ffi/unstable_ffi_2.js.out
@@ -1 +1 @@
-Unstable API 'Deno.UnsafeFnPointer#call'. The --unstable flag must be provided.
+Unstable API 'Deno.UnsafeFnPointer#call'. The `--unstable-ffi` flag must be provided.
diff --git a/cli/tests/testdata/run/ffi/unstable_ffi_3.js.out b/cli/tests/testdata/run/ffi/unstable_ffi_3.js.out
index cc4cc3dc6..094a69b5b 100644
--- a/cli/tests/testdata/run/ffi/unstable_ffi_3.js.out
+++ b/cli/tests/testdata/run/ffi/unstable_ffi_3.js.out
@@ -1 +1 @@
-Unstable API 'Deno.UnsafeFnPointer#call'. The --unstable flag must be provided.
+Unstable API 'Deno.UnsafeFnPointer#call'. The `--unstable-ffi` flag must be provided.
diff --git a/cli/tests/testdata/run/ffi/unstable_ffi_4.js.out b/cli/tests/testdata/run/ffi/unstable_ffi_4.js.out
index e0f40f2ee..55bbc063d 100644
--- a/cli/tests/testdata/run/ffi/unstable_ffi_4.js.out
+++ b/cli/tests/testdata/run/ffi/unstable_ffi_4.js.out
@@ -1 +1 @@
-Unstable API 'Deno.UnsafePointer#of'. The --unstable flag must be provided.
+Unstable API 'Deno.UnsafePointer#of'. The `--unstable-ffi` flag must be provided.
diff --git a/cli/tests/testdata/run/ffi/unstable_ffi_5.js.out b/cli/tests/testdata/run/ffi/unstable_ffi_5.js.out
index e3db6af26..81dd950ac 100644
--- a/cli/tests/testdata/run/ffi/unstable_ffi_5.js.out
+++ b/cli/tests/testdata/run/ffi/unstable_ffi_5.js.out
@@ -1 +1 @@
-Unstable API 'Deno.UnsafePointerView#copyInto'. The --unstable flag must be provided.
+Unstable API 'Deno.UnsafePointerView#copyInto'. The `--unstable-ffi` flag must be provided.
diff --git a/cli/tests/testdata/run/ffi/unstable_ffi_6.js.out b/cli/tests/testdata/run/ffi/unstable_ffi_6.js.out
index c59f51d04..b48fc264f 100644
--- a/cli/tests/testdata/run/ffi/unstable_ffi_6.js.out
+++ b/cli/tests/testdata/run/ffi/unstable_ffi_6.js.out
@@ -1 +1 @@
-Unstable API 'Deno.UnsafePointerView#getCString'. The --unstable flag must be provided.
+Unstable API 'Deno.UnsafePointerView#getCString'. The `--unstable-ffi` flag must be provided.
diff --git a/cli/tests/testdata/run/ffi/unstable_ffi_7.js.out b/cli/tests/testdata/run/ffi/unstable_ffi_7.js.out
index 6ab413537..935ebe195 100644
--- a/cli/tests/testdata/run/ffi/unstable_ffi_7.js.out
+++ b/cli/tests/testdata/run/ffi/unstable_ffi_7.js.out
@@ -1 +1 @@
-Unstable API 'Deno.UnsafePointerView#getUint8'. The --unstable flag must be provided.
+Unstable API 'Deno.UnsafePointerView#getUint8'. The `--unstable-ffi` flag must be provided.
diff --git a/cli/tests/testdata/run/ffi/unstable_ffi_8.js.out b/cli/tests/testdata/run/ffi/unstable_ffi_8.js.out
index 338db2631..02883d0c3 100644
--- a/cli/tests/testdata/run/ffi/unstable_ffi_8.js.out
+++ b/cli/tests/testdata/run/ffi/unstable_ffi_8.js.out
@@ -1 +1 @@
-Unstable API 'Deno.UnsafePointerView#getInt8'. The --unstable flag must be provided.
+Unstable API 'Deno.UnsafePointerView#getInt8'. The `--unstable-ffi` flag must be provided.
diff --git a/cli/tests/testdata/run/ffi/unstable_ffi_9.js.out b/cli/tests/testdata/run/ffi/unstable_ffi_9.js.out
index fb6d75f14..97ac97017 100644
--- a/cli/tests/testdata/run/ffi/unstable_ffi_9.js.out
+++ b/cli/tests/testdata/run/ffi/unstable_ffi_9.js.out
@@ -1 +1 @@
-Unstable API 'Deno.UnsafePointerView#getUint16'. The --unstable flag must be provided.
+Unstable API 'Deno.UnsafePointerView#getUint16'. The `--unstable-ffi` flag must be provided.
diff --git a/cli/tests/testdata/run/unstable_worker_options.disabled.out b/cli/tests/testdata/run/unstable_worker_options.disabled.out
index 03f189c25..ba50ca539 100644
--- a/cli/tests/testdata/run/unstable_worker_options.disabled.out
+++ b/cli/tests/testdata/run/unstable_worker_options.disabled.out
@@ -1 +1 @@
-Unstable API 'Worker.deno.permissions'. The --unstable flag must be provided.
+Unstable API 'Worker.deno.permissions'. The `--unstable-worker-options` flag must be provided.