summaryrefslogtreecommitdiff
path: root/cli/tsc/dts/lib.deno.unstable.d.ts
diff options
context:
space:
mode:
Diffstat (limited to 'cli/tsc/dts/lib.deno.unstable.d.ts')
-rw-r--r--cli/tsc/dts/lib.deno.unstable.d.ts366
1 files changed, 188 insertions, 178 deletions
diff --git a/cli/tsc/dts/lib.deno.unstable.d.ts b/cli/tsc/dts/lib.deno.unstable.d.ts
index 488780ff7..f4588a23c 100644
--- a/cli/tsc/dts/lib.deno.unstable.d.ts
+++ b/cli/tsc/dts/lib.deno.unstable.d.ts
@@ -13,7 +13,7 @@ declare namespace Deno {
/** Information for a HTTP request.
*
* @category HTTP Server
- * @tags unstable
+ * @experimental
*/
export interface ServeHandlerInfo {
/** The remote address of the connection. */
@@ -39,7 +39,7 @@ declare namespace Deno {
* *Note*: This API is not implemented on Windows
*
* @category File System
- * @tags unstable
+ * @experimental
*/
export function umask(mask?: number): number;
@@ -48,7 +48,7 @@ declare namespace Deno {
* All plain number types for interfacing with foreign functions.
*
* @category FFI
- * @tags unstable
+ * @experimental
*/
export type NativeNumberType =
| "u8"
@@ -65,7 +65,7 @@ declare namespace Deno {
* All BigInt number types for interfacing with foreign functions.
*
* @category FFI
- * @tags unstable
+ * @experimental
*/
export type NativeBigIntType =
| "u64"
@@ -78,7 +78,7 @@ declare namespace Deno {
* The native boolean type for interfacing to foreign functions.
*
* @category FFI
- * @tags unstable
+ * @experimental
*/
export type NativeBooleanType = "bool";
@@ -87,7 +87,7 @@ declare namespace Deno {
* The native pointer type for interfacing to foreign functions.
*
* @category FFI
- * @tags unstable
+ * @experimental
*/
export type NativePointerType = "pointer";
@@ -96,7 +96,7 @@ declare namespace Deno {
* The native buffer type for interfacing to foreign functions.
*
* @category FFI
- * @tags unstable
+ * @experimental
*/
export type NativeBufferType = "buffer";
@@ -105,7 +105,7 @@ declare namespace Deno {
* The native function type for interfacing with foreign functions.
*
* @category FFI
- * @tags unstable
+ * @experimental
*/
export type NativeFunctionType = "function";
@@ -114,7 +114,7 @@ declare namespace Deno {
* The native void type for interfacing with foreign functions.
*
* @category FFI
- * @tags unstable
+ * @experimental
*/
export type NativeVoidType = "void";
@@ -123,56 +123,56 @@ declare namespace Deno {
* The native struct type for interfacing with foreign functions.
*
* @category FFI
- * @tags unstable
+ * @experimental
*/
export type NativeStructType = { readonly struct: readonly NativeType[] };
/**
* @category FFI
- * @tags unstable
+ * @experimental
*/
export const brand: unique symbol;
/**
* @category FFI
- * @tags unstable
+ * @experimental
*/
export type NativeU8Enum<T extends number> = "u8" & { [brand]: T };
/**
* @category FFI
- * @tags unstable
+ * @experimental
*/
export type NativeI8Enum<T extends number> = "i8" & { [brand]: T };
/**
* @category FFI
- * @tags unstable
+ * @experimental
*/
export type NativeU16Enum<T extends number> = "u16" & { [brand]: T };
/**
* @category FFI
- * @tags unstable
+ * @experimental
*/
export type NativeI16Enum<T extends number> = "i16" & { [brand]: T };
/**
* @category FFI
- * @tags unstable
+ * @experimental
*/
export type NativeU32Enum<T extends number> = "u32" & { [brand]: T };
/**
* @category FFI
- * @tags unstable
+ * @experimental
*/
export type NativeI32Enum<T extends number> = "i32" & { [brand]: T };
/**
* @category FFI
- * @tags unstable
+ * @experimental
*/
export type NativeTypedPointer<T extends PointerObject> = "pointer" & {
[brand]: T;
};
/**
* @category FFI
- * @tags unstable
+ * @experimental
*/
export type NativeTypedFunction<T extends UnsafeCallbackDefinition> =
& "function"
@@ -185,7 +185,7 @@ declare namespace Deno {
* All supported types for interfacing with foreign functions.
*
* @category FFI
- * @tags unstable
+ * @experimental
*/
export type NativeType =
| NativeNumberType
@@ -199,7 +199,7 @@ declare namespace Deno {
/** **UNSTABLE**: New API, yet to be vetted.
*
* @category FFI
- * @tags unstable
+ * @experimental
*/
export type NativeResultType = NativeType | NativeVoidType;
@@ -209,7 +209,7 @@ declare namespace Deno {
* types.
*
* @category FFI
- * @tags unstable
+ * @experimental
*/
export type ToNativeType<T extends NativeType = NativeType> = T extends
NativeStructType ? BufferSource
@@ -235,7 +235,7 @@ declare namespace Deno {
* Type conversion for unsafe callback return types.
*
* @category FFI
- * @tags unstable
+ * @experimental
*/
export type ToNativeResultType<
T extends NativeResultType = NativeResultType,
@@ -263,7 +263,7 @@ declare namespace Deno {
* A utility type for conversion of parameter types of foreign functions.
*
* @category FFI
- * @tags unstable
+ * @experimental
*/
export type ToNativeParameterTypes<T extends readonly NativeType[]> =
//
@@ -281,7 +281,7 @@ declare namespace Deno {
* parameters.
*
* @category FFI
- * @tags unstable
+ * @experimental
*/
export type FromNativeType<T extends NativeType = NativeType> = T extends
NativeStructType ? Uint8Array
@@ -307,7 +307,7 @@ declare namespace Deno {
* Type conversion for foreign symbol return types.
*
* @category FFI
- * @tags unstable
+ * @experimental
*/
export type FromNativeResultType<
T extends NativeResultType = NativeResultType,
@@ -333,7 +333,7 @@ declare namespace Deno {
/** **UNSTABLE**: New API, yet to be vetted.
*
* @category FFI
- * @tags unstable
+ * @experimental
*/
export type FromNativeParameterTypes<
T extends readonly NativeType[],
@@ -353,7 +353,7 @@ declare namespace Deno {
* types.
*
* @category FFI
- * @tags unstable
+ * @experimental
*/
export interface ForeignFunction<
Parameters extends readonly NativeType[] = readonly NativeType[],
@@ -386,7 +386,7 @@ declare namespace Deno {
/** **UNSTABLE**: New API, yet to be vetted.
*
* @category FFI
- * @tags unstable
+ * @experimental
*/
export interface ForeignStatic<Type extends NativeType = NativeType> {
/** Name of the symbol, defaults to the key name in symbols object. */
@@ -405,7 +405,7 @@ declare namespace Deno {
* A foreign library interface descriptor.
*
* @category FFI
- * @tags unstable
+ * @experimental
*/
export interface ForeignLibraryInterface {
[name: string]: ForeignFunction | ForeignStatic;
@@ -416,7 +416,7 @@ declare namespace Deno {
* A utility type that infers a foreign symbol.
*
* @category FFI
- * @tags unstable
+ * @experimental
*/
export type StaticForeignSymbol<T extends ForeignFunction | ForeignStatic> =
T extends ForeignFunction ? FromForeignFunction<T>
@@ -426,7 +426,7 @@ declare namespace Deno {
/** **UNSTABLE**: New API, yet to be vetted.
*
* @category FFI
- * @tags unstable
+ * @experimental
*/
export type FromForeignFunction<T extends ForeignFunction> =
T["parameters"] extends readonly [] ? () => StaticForeignSymbolReturnType<T>
@@ -437,7 +437,7 @@ declare namespace Deno {
/** **UNSTABLE**: New API, yet to be vetted.
*
* @category FFI
- * @tags unstable
+ * @experimental
*/
export type StaticForeignSymbolReturnType<T extends ForeignFunction> =
ConditionalAsync<T["nonblocking"], FromNativeResultType<T["result"]>>;
@@ -445,7 +445,7 @@ declare namespace Deno {
/** **UNSTABLE**: New API, yet to be vetted.
*
* @category FFI
- * @tags unstable
+ * @experimental
*/
export type ConditionalAsync<IsAsync extends boolean | undefined, T> =
IsAsync extends true ? Promise<T> : T;
@@ -455,7 +455,7 @@ declare namespace Deno {
* A utility type that infers a foreign library interface.
*
* @category FFI
- * @tags unstable
+ * @experimental
*/
export type StaticForeignLibraryInterface<T extends ForeignLibraryInterface> =
{
@@ -478,7 +478,7 @@ declare namespace Deno {
* {@linkcode UnsafePointer} class.
*
* @category FFI
- * @tags unstable
+ * @experimental
*/
export type PointerObject<T = unknown> = { [brand]: T };
@@ -488,7 +488,7 @@ declare namespace Deno {
* object or a `null` if the pointer is null.
*
* @category FFI
- * @tags unstable
+ * @experimental
*/
export type PointerValue<T = unknown> = null | PointerObject<T>;
@@ -497,7 +497,7 @@ declare namespace Deno {
* A collection of static functions for interacting with pointer objects.
*
* @category FFI
- * @tags unstable
+ * @experimental
*/
export class UnsafePointer {
/** Create a pointer from a numeric value. This one is <i>really</i> dangerous! */
@@ -525,7 +525,7 @@ declare namespace Deno {
* location (numbers, strings and raw bytes).
*
* @category FFI
- * @tags unstable
+ * @experimental
*/
export class UnsafePointerView {
constructor(pointer: PointerObject);
@@ -609,7 +609,7 @@ declare namespace Deno {
* as symbols.
*
* @category FFI
- * @tags unstable
+ * @experimental
*/
export class UnsafeFnPointer<const Fn extends ForeignFunction> {
/** The pointer to the function. */
@@ -630,7 +630,7 @@ declare namespace Deno {
* Definition of a unsafe callback function.
*
* @category FFI
- * @tags unstable
+ * @experimental
*/
export interface UnsafeCallbackDefinition<
Parameters extends readonly NativeType[] = readonly NativeType[],
@@ -647,7 +647,7 @@ declare namespace Deno {
* An unsafe callback function.
*
* @category FFI
- * @tags unstable
+ * @experimental
*/
export type UnsafeCallbackFunction<
Parameters extends readonly NativeType[] = readonly NativeType[],
@@ -678,7 +678,7 @@ declare namespace Deno {
* called from foreign threads.
*
* @category FFI
- * @tags unstable
+ * @experimental
*/
export class UnsafeCallback<
const Definition extends UnsafeCallbackDefinition =
@@ -762,7 +762,7 @@ declare namespace Deno {
* library and return this interface.
*
* @category FFI
- * @tags unstable
+ * @experimental
*/
export interface DynamicLibrary<S extends ForeignLibraryInterface> {
/** All of the registered library along with functions for calling them. */
@@ -821,8 +821,9 @@ declare namespace Deno {
* console.log(`Result from external addition of 35 and 34: ${result}`);
* ```
*
- * @tags allow-ffi, unstable
+ * @tags allow-ffi
* @category FFI
+ * @experimental
*/
export function dlopen<const S extends ForeignLibraryInterface>(
filename: string | URL,
@@ -844,7 +845,7 @@ declare namespace Deno {
* | "wayland" (Linux) | `wl_surface*` | `wl_display*` |
*
* @category GPU
- * @tags unstable
+ * @experimental
*/
export class UnsafeWindowSurface {
constructor(
@@ -861,7 +862,7 @@ declare namespace Deno {
* These are unstable options which can be used with {@linkcode Deno.run}.
*
* @category Sub Process
- * @tags unstable
+ * @experimental
*/
export interface UnstableRunOptions extends RunOptions {
/** If `true`, clears the environment variables before executing the
@@ -922,8 +923,9 @@ declare namespace Deno {
*
* Requires `allow-run` permission.
*
- * @tags allow-run, unstable
+ * @tags allow-run
* @category Sub Process
+ * @experimental
*/
export function run<T extends UnstableRunOptions = UnstableRunOptions>(
opt: T,
@@ -941,7 +943,7 @@ declare namespace Deno {
* ```
*
* @category Fetch
- * @tags unstable
+ * @experimental
*/
export interface HttpClient extends Disposable {
/** Close the HTTP client. */
@@ -953,7 +955,7 @@ declare namespace Deno {
* The options used when creating a {@linkcode Deno.HttpClient}.
*
* @category Fetch
- * @tags unstable
+ * @experimental
*/
export interface CreateHttpClientOptions {
/** A list of root certificates that will be used in addition to the
@@ -992,7 +994,7 @@ declare namespace Deno {
* {@linkcode Deno.CreateHttpClientOptions}.
*
* @category Fetch
- * @tags unstable
+ * @experimental
*/
export interface Proxy {
/** The string URL of the proxy server to use. */
@@ -1007,7 +1009,7 @@ declare namespace Deno {
* server when specifying {@linkcode Deno.CreateHttpClientOptions}.
*
* @category Fetch
- * @tags unstable
+ * @experimental
*/
export interface BasicAuth {
/** The username to be used against the proxy server. */
@@ -1036,7 +1038,7 @@ declare namespace Deno {
* ```
*
* @category Fetch
- * @tags unstable
+ * @experimental
*/
export function createHttpClient(
options: CreateHttpClientOptions,
@@ -1058,7 +1060,7 @@ declare namespace Deno {
* ```
*
* @category Fetch
- * @tags unstable
+ * @experimental
*/
export function createHttpClient(
options: CreateHttpClientOptions & TlsCertifiedKeyOptions,
@@ -1069,7 +1071,7 @@ declare namespace Deno {
* Represents membership of a IPv4 multicast group.
*
* @category Network
- * @tags unstable
+ * @experimental
*/
export interface MulticastV4Membership {
/** Leaves the multicast group. */
@@ -1085,7 +1087,7 @@ declare namespace Deno {
* Represents membership of a IPv6 multicast group.
*
* @category Network
- * @tags unstable
+ * @experimental
*/
export interface MulticastV6Membership {
/** Leaves the multicast group. */
@@ -1099,7 +1101,7 @@ declare namespace Deno {
* A generic transport listener for message-oriented protocols.
*
* @category Network
- * @tags unstable
+ * @experimental
*/
export interface DatagramConn extends AsyncIterable<[Uint8Array, Addr]> {
/** Joins an IPv4 multicast group. */
@@ -1133,7 +1135,7 @@ declare namespace Deno {
/**
* @category Network
- * @tags unstable
+ * @experimental
*/
export interface TcpListenOptions extends ListenOptions {
/** When `true` the SO_REUSEPORT flag will be set on the listener. This
@@ -1156,7 +1158,7 @@ declare namespace Deno {
* {@linkcode Deno.listenDatagram}.
*
* @category Network
- * @tags unstable
+ * @experimental
*/
export interface UdpListenOptions extends ListenOptions {
/** When `true` the specified address will be reused, even if another
@@ -1190,8 +1192,9 @@ declare namespace Deno {
*
* Requires `allow-net` permission.
*
- * @tags allow-net, unstable
+ * @tags allow-net
* @category Network
+ * @experimental
*/
export function listenDatagram(
options: UdpListenOptions & { transport: "udp" },
@@ -1210,8 +1213,9 @@ declare namespace Deno {
*
* Requires `allow-read` and `allow-write` permission.
*
- * @tags allow-read, allow-write, unstable
+ * @tags allow-read, allow-write
* @category Network
+ * @experimental
*/
export function listenDatagram(
options: UnixListenOptions & { transport: "unixpacket" },
@@ -1223,7 +1227,7 @@ declare namespace Deno {
*
* @param [exclusive=false]
* @category File System
- * @tags unstable
+ * @experimental
*/
export function flock(rid: number, exclusive?: boolean): Promise<void>;
@@ -1233,7 +1237,7 @@ declare namespace Deno {
*
* @param [exclusive=false]
* @category File System
- * @tags unstable
+ * @experimental
*/
export function flockSync(rid: number, exclusive?: boolean): void;
@@ -1242,7 +1246,7 @@ declare namespace Deno {
* Release an advisory file-system lock for the provided file.
*
* @category File System
- * @tags unstable
+ * @experimental
*/
export function funlock(rid: number): Promise<void>;
@@ -1251,7 +1255,7 @@ declare namespace Deno {
* Release an advisory file-system lock for the provided file synchronously.
*
* @category File System
- * @tags unstable
+ * @experimental
*/
export function funlockSync(rid: number): void;
@@ -1268,8 +1272,9 @@ declare namespace Deno {
* `localStorage` persistence). More information about the origin storage key
* can be found in the Deno Manual.
*
- * @tags allow-read, allow-write, unstable
+ * @tags allow-read, allow-write
* @category Cloud
+ * @experimental
*/
export function openKv(path?: string): Promise<Deno.Kv>;
@@ -1278,7 +1283,7 @@ declare namespace Deno {
* CronScheduleExpression is used as the type of `minute`, `hour`,
* `dayOfMonth`, `month`, and `dayOfWeek` in {@linkcode CronSchedule}.
* @category Cloud
- * @tags unstable
+ * @experimental
*/
export type CronScheduleExpression = number | { exact: number | number[] } | {
start?: number;
@@ -1291,7 +1296,7 @@ declare namespace Deno {
* CronSchedule is the interface used for JSON format
* cron `schedule`.
* @category Cloud
- * @tags unstable
+ * @experimental
*/
export interface CronSchedule {
minute?: CronScheduleExpression;
@@ -1323,7 +1328,7 @@ declare namespace Deno {
* using UTC time zone.
*
* @category Cloud
- * @tags unstable
+ * @experimental
*/
export function cron(
name: string,
@@ -1355,7 +1360,7 @@ declare namespace Deno {
* second, 5 seconds, and 10 seconds delay between each retry.
*
* @category Cloud
- * @tags unstable
+ * @experimental
*/
export function cron(
name: string,
@@ -1380,7 +1385,7 @@ declare namespace Deno {
* was passed to.
*
* @category Cloud
- * @tags unstable
+ * @experimental
*/
export type KvKey = readonly KvKeyPart[];
@@ -1417,7 +1422,7 @@ declare namespace Deno {
* over the ordering of values within a type.
*
* @category Cloud
- * @tags unstable
+ * @experimental
*/
export type KvKeyPart =
| Uint8Array
@@ -1435,7 +1440,7 @@ declare namespace Deno {
* - `eventual` - Eventually-consistent behavior is allowed.
*
* @category Cloud
- * @tags unstable
+ * @experimental
*/
export type KvConsistencyLevel = "strong" | "eventual";
@@ -1450,7 +1455,7 @@ declare namespace Deno {
* lexicographically between the given start and end keys.
*
* @category Cloud
- * @tags unstable
+ * @experimental
*/
export type KvListSelector =
| { prefix: KvKey }
@@ -1489,7 +1494,7 @@ declare namespace Deno {
* the value is set to the given value.
*
* @category Cloud
- * @tags unstable
+ * @experimental
*/
export type KvMutation =
& { key: KvKey }
@@ -1509,7 +1514,7 @@ declare namespace Deno {
* iteration from the current position in the future.
*
* @category Cloud
- * @tags unstable
+ * @experimental
*/
export class KvListIterator<T> implements AsyncIterableIterator<KvEntry<T>> {
/**
@@ -1532,7 +1537,7 @@ declare namespace Deno {
* by passing it to the `check` method of a {@linkcode Deno.AtomicOperation}.
*
* @category Cloud
- * @tags unstable
+ * @experimental
*/
export type KvEntry<T> = { key: KvKey; value: T; versionstamp: string };
@@ -1545,7 +1550,7 @@ declare namespace Deno {
* fields may be `null` if no value exists for the given key in the KV store.
*
* @category Cloud
- * @tags unstable
+ * @experimental
*/
export type KvEntryMaybe<T> = KvEntry<T> | {
key: KvKey;
@@ -1558,7 +1563,7 @@ declare namespace Deno {
* Options for listing key-value pairs in a {@linkcode Deno.Kv}.
*
* @category Cloud
- * @tags unstable
+ * @experimental
*/
export interface KvListOptions {
/**
@@ -1613,7 +1618,7 @@ declare namespace Deno {
/**
* @category Cloud
- * @tags unstable
+ * @experimental
*/
export interface KvCommitResult {
ok: true;
@@ -1623,7 +1628,7 @@ declare namespace Deno {
/**
* @category Cloud
- * @tags unstable
+ * @experimental
*/
export interface KvCommitError {
ok: false;
@@ -1637,7 +1642,7 @@ declare namespace Deno {
* that the key-value pair does not currently exist in the KV store.
*
* @category Cloud
- * @tags unstable
+ * @experimental
*/
export interface AtomicCheck {
key: KvKey;
@@ -1679,7 +1684,7 @@ declare namespace Deno {
* and the versionstamp of the value committed to KV.
*
* @category Cloud
- * @tags unstable
+ * @experimental
*/
export class AtomicOperation {
/**
@@ -1796,7 +1801,7 @@ declare namespace Deno {
* an exception will be thrown.
*
* @category Cloud
- * @tags unstable
+ * @experimental
*/
export class Kv implements Disposable {
/**
@@ -2067,7 +2072,7 @@ declare namespace Deno {
* {@linkcode Deno.Kv}.
*
* @category Cloud
- * @tags unstable
+ * @experimental
*/
export class KvU64 {
/** Create a new `KvU64` instance from the given bigint value. If the value
@@ -2083,12 +2088,12 @@ declare namespace Deno {
* When accessed outside of Jupyter notebook context an error will be thrown.
*
* @category Jupyter
- * @tags unstable
+ * @experimental
*/
export namespace jupyter {
/**
* @category Jupyter
- * @tags unstable
+ * @experimental
*/
export interface DisplayOptions {
raw?: boolean;
@@ -2098,7 +2103,7 @@ declare namespace Deno {
/**
* @category Jupyter
- * @tags unstable
+ * @experimental
*/
export type VegaObject = {
$schema: string;
@@ -2109,7 +2114,7 @@ declare namespace Deno {
* A collection of supported media types and data for Jupyter frontends.
*
* @category Jupyter
- * @tags unstable
+ * @experimental
*/
export type MediaBundle = {
"text/plain"?: string;
@@ -2141,13 +2146,13 @@ declare namespace Deno {
/**
* @category Jupyter
- * @tags unstable
+ * @experimental
*/
export const $display: unique symbol;
/**
* @category Jupyter
- * @tags unstable
+ * @experimental
*/
export type Displayable = {
[$display]: () => MediaBundle | Promise<MediaBundle>;
@@ -2161,7 +2166,7 @@ declare namespace Deno {
* @param obj - The object to be displayed
* @param options - Display options with a default { raw: true }
* @category Jupyter
- * @tags unstable
+ * @experimental
*/
export function display(obj: unknown, options?: DisplayOptions): void;
@@ -2186,7 +2191,7 @@ declare namespace Deno {
* ```
*
* @category Jupyter
- * @tags unstable
+ * @experimental
*/
export function md(
strings: TemplateStringsArray,
@@ -2206,7 +2211,7 @@ declare namespace Deno {
* ```
*
* @category Jupyter
- * @tags unstable
+ * @experimental
*/
export function html(
strings: TemplateStringsArray,
@@ -2225,7 +2230,7 @@ declare namespace Deno {
* </svg>`
*
* @category Jupyter
- * @tags unstable
+ * @experimental
*/
export function svg(
strings: TemplateStringsArray,
@@ -2239,7 +2244,7 @@ declare namespace Deno {
* @returns MediaBundle
*
* @category Jupyter
- * @tags unstable
+ * @experimental
*/
export function format(obj: unknown): MediaBundle;
@@ -2263,7 +2268,7 @@ declare namespace Deno {
* ```
*
* @category Jupyter
- * @tags unstable
+ * @experimental
*/
export function broadcast(
msgType: string,
@@ -2282,8 +2287,9 @@ declare namespace Deno {
* which also supports setting a {@linkcode Deno.HttpClient} which provides a
* way to connect via proxies and use custom TLS certificates.
*
- * @tags allow-net, allow-read, unstable
+ * @tags allow-net, allow-read
* @category Fetch
+ * @experimental
*/
declare function fetch(
input: Request | URL | string,
@@ -2293,7 +2299,7 @@ declare function fetch(
/** **UNSTABLE**: New API, yet to be vetted.
*
* @category Workers
- * @tags unstable
+ * @experimental
*/
declare interface WorkerOptions {
/** **UNSTABLE**: New API, yet to be vetted.
@@ -2334,7 +2340,7 @@ declare interface WorkerOptions {
/** **UNSTABLE**: New API, yet to be vetted.
*
* @category WebSockets
- * @tags unstable
+ * @experimental
*/
declare interface WebSocketStreamOptions {
protocols?: string[];
@@ -2345,7 +2351,7 @@ declare interface WebSocketStreamOptions {
/** **UNSTABLE**: New API, yet to be vetted.
*
* @category WebSockets
- * @tags unstable
+ * @experimental
*/
declare interface WebSocketConnection {
readable: ReadableStream<string | Uint8Array>;
@@ -2357,7 +2363,7 @@ declare interface WebSocketConnection {
/** **UNSTABLE**: New API, yet to be vetted.
*
* @category WebSockets
- * @tags unstable
+ * @experimental
*/
declare interface WebSocketCloseInfo {
code?: number;
@@ -2366,8 +2372,9 @@ declare interface WebSocketCloseInfo {
/** **UNSTABLE**: New API, yet to be vetted.
*
- * @tags allow-net, unstable
+ * @tags allow-net
* @category WebSockets
+ * @experimental
*/
declare interface WebSocketStream {
url: string;
@@ -2378,8 +2385,9 @@ declare interface WebSocketStream {
/** **UNSTABLE**: New API, yet to be vetted.
*
- * @tags allow-net, unstable
+ * @tags allow-net
* @category WebSockets
+ * @experimental
*/
declare var WebSocketStream: {
readonly prototype: WebSocketStream;
@@ -2388,8 +2396,9 @@ declare var WebSocketStream: {
/** **UNSTABLE**: New API, yet to be vetted.
*
- * @tags allow-net, unstable
+ * @tags allow-net
* @category WebSockets
+ * @experimental
*/
declare interface WebSocketError extends DOMException {
readonly closeCode: number;
@@ -2398,8 +2407,9 @@ declare interface WebSocketError extends DOMException {
/** **UNSTABLE**: New API, yet to be vetted.
*
- * @tags allow-net, unstable
+ * @tags allow-net
* @category WebSockets
+ * @experimental
*/
declare var WebSocketError: {
readonly prototype: WebSocketError;
@@ -2412,17 +2422,17 @@ declare var WebSocketError: {
* [Specification](https://tc39.es/proposal-temporal/docs/index.html)
*
* @category Temporal
- * @tags unstable
+ * @experimental
*/
declare namespace Temporal {
/**
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export type ComparisonResult = -1 | 0 | 1;
/**
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export type RoundingMode =
| "ceil"
@@ -2440,7 +2450,7 @@ declare namespace Temporal {
* `from()`.
*
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export type AssignmentOptions = {
/**
@@ -2462,7 +2472,7 @@ declare namespace Temporal {
* `Duration.prototype.add()` and `Duration.prototype.subtract()`.
*
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export type DurationOptions = {
/**
@@ -2482,7 +2492,7 @@ declare namespace Temporal {
* Options for conversions of `Temporal.PlainDateTime` to `Temporal.Instant`
*
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export type ToInstantOptions = {
/**
@@ -2512,7 +2522,7 @@ declare namespace Temporal {
/**
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export type OffsetDisambiguationOptions = {
/**
@@ -2552,7 +2562,7 @@ declare namespace Temporal {
/**
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export type ZonedDateTimeAssignmentOptions = Partial<
AssignmentOptions & ToInstantOptions & OffsetDisambiguationOptions
@@ -2562,7 +2572,7 @@ declare namespace Temporal {
* Options for arithmetic operations like `add()` and `subtract()`
*
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export type ArithmeticOptions = {
/**
@@ -2578,12 +2588,12 @@ declare namespace Temporal {
/**
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export type DateUnit = "year" | "month" | "week" | "day";
/**
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export type TimeUnit =
| "hour"
@@ -2594,7 +2604,7 @@ declare namespace Temporal {
| "nanosecond";
/**
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export type DateTimeUnit = DateUnit | TimeUnit;
@@ -2604,7 +2614,7 @@ declare namespace Temporal {
* or 'hours' are aso accepted too.
*
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export type PluralUnit<T extends DateTimeUnit> = {
year: "years";
@@ -2621,17 +2631,17 @@ declare namespace Temporal {
/**
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export type LargestUnit<T extends DateTimeUnit> = "auto" | T | PluralUnit<T>;
/**
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export type SmallestUnit<T extends DateTimeUnit> = T | PluralUnit<T>;
/**
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export type TotalUnit<T extends DateTimeUnit> = T | PluralUnit<T>;
@@ -2639,7 +2649,7 @@ declare namespace Temporal {
* Options for outputting precision in toString() on types with seconds
*
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export type ToStringPrecisionOptions = {
fractionalSecondDigits?: "auto" | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;
@@ -2666,7 +2676,7 @@ declare namespace Temporal {
/**
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export type ShowCalendarOption = {
calendarName?: "auto" | "always" | "never" | "critical";
@@ -2674,7 +2684,7 @@ declare namespace Temporal {
/**
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export type CalendarTypeToStringOptions = Partial<
ToStringPrecisionOptions & ShowCalendarOption
@@ -2682,7 +2692,7 @@ declare namespace Temporal {
/**
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export type ZonedDateTimeToStringOptions = Partial<
CalendarTypeToStringOptions & {
@@ -2693,7 +2703,7 @@ declare namespace Temporal {
/**
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export type InstantToStringOptions = Partial<
ToStringPrecisionOptions & {
@@ -2706,7 +2716,7 @@ declare namespace Temporal {
* `Temporal` types.
*
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export interface DifferenceOptions<T extends DateTimeUnit> {
/**
@@ -2769,7 +2779,7 @@ declare namespace Temporal {
* `smallestUnit` property value is that string.
*
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export type RoundTo<T extends DateTimeUnit> =
| SmallestUnit<T>
@@ -2815,7 +2825,7 @@ declare namespace Temporal {
* object whose `smallestUnit` property value is that string.
*
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export type DurationRoundTo =
| SmallestUnit<DateTimeUnit>
@@ -2946,7 +2956,7 @@ declare namespace Temporal {
* Options to control behavior of `Duration.prototype.total()`
*
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export type DurationTotalOf =
| TotalUnit<DateTimeUnit>
@@ -2991,7 +3001,7 @@ declare namespace Temporal {
* `Duration.subtract()`
*
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export interface DurationArithmeticOptions {
/**
@@ -3024,7 +3034,7 @@ declare namespace Temporal {
/**
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export type DurationLike = {
years?: number;
@@ -3046,7 +3056,7 @@ declare namespace Temporal {
* See https://tc39.es/proposal-temporal/docs/duration.html for more details.
*
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export class Duration {
static from(
@@ -3119,7 +3129,7 @@ declare namespace Temporal {
* See https://tc39.es/proposal-temporal/docs/instant.html for more details.
*
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export class Instant {
static fromEpochSeconds(epochSeconds: number): Temporal.Instant;
@@ -3201,14 +3211,14 @@ declare namespace Temporal {
/**
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export type YearOrEraAndEraYear = { era: string; eraYear: number } | {
year: number;
};
/**
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export type MonthCodeOrMonthAndYear =
| (YearOrEraAndEraYear & { month: number })
@@ -3217,13 +3227,13 @@ declare namespace Temporal {
};
/**
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export type MonthOrMonthCode = { month: number } | { monthCode: string };
/**
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export interface CalendarProtocol {
id: string;
@@ -3377,7 +3387,7 @@ declare namespace Temporal {
* Any of these types can be passed to Temporal methods instead of a Temporal.Calendar.
*
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export type CalendarLike =
| string
@@ -3397,7 +3407,7 @@ declare namespace Temporal {
* See https://tc39.es/proposal-temporal/docs/calendar.html for more details.
*
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export class Calendar implements CalendarProtocol {
static from(item: CalendarLike): Temporal.Calendar | CalendarProtocol;
@@ -3552,7 +3562,7 @@ declare namespace Temporal {
/**
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export type PlainDateLike = {
era?: string | undefined;
@@ -3566,7 +3576,7 @@ declare namespace Temporal {
/**
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export type PlainDateISOFields = {
isoYear: number;
@@ -3585,7 +3595,7 @@ declare namespace Temporal {
* See https://tc39.es/proposal-temporal/docs/date.html for more details.
*
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export class PlainDate {
static from(
@@ -3668,7 +3678,7 @@ declare namespace Temporal {
/**
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export type PlainDateTimeLike = {
era?: string | undefined;
@@ -3688,7 +3698,7 @@ declare namespace Temporal {
/**
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export type PlainDateTimeISOFields = {
isoYear: number;
@@ -3714,7 +3724,7 @@ declare namespace Temporal {
* See https://tc39.es/proposal-temporal/docs/datetime.html for more details.
*
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export class PlainDateTime {
static from(
@@ -3842,7 +3852,7 @@ declare namespace Temporal {
/**
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export type PlainMonthDayLike = {
era?: string | undefined;
@@ -3862,7 +3872,7 @@ declare namespace Temporal {
* See https://tc39.es/proposal-temporal/docs/monthday.html for more details.
*
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export class PlainMonthDay {
static from(
@@ -3898,7 +3908,7 @@ declare namespace Temporal {
/**
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export type PlainTimeLike = {
hour?: number;
@@ -3911,7 +3921,7 @@ declare namespace Temporal {
/**
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export type PlainTimeISOFields = {
isoHour: number;
@@ -3938,7 +3948,7 @@ declare namespace Temporal {
* See https://tc39.es/proposal-temporal/docs/time.html for more details.
*
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export class PlainTime {
static from(
@@ -4030,7 +4040,7 @@ declare namespace Temporal {
* A plain object implementing the protocol for a custom time zone.
*
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export interface TimeZoneProtocol {
id: string;
@@ -4061,7 +4071,7 @@ declare namespace Temporal {
* Any of these types can be passed to Temporal methods instead of a Temporal.TimeZone.
*
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export type TimeZoneLike = string | TimeZoneProtocol | ZonedDateTime;
@@ -4080,7 +4090,7 @@ declare namespace Temporal {
* See https://tc39.es/proposal-temporal/docs/timezone.html for more details.
*
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export class TimeZone implements TimeZoneProtocol {
static from(timeZone: TimeZoneLike): Temporal.TimeZone | TimeZoneProtocol;
@@ -4113,7 +4123,7 @@ declare namespace Temporal {
/**
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export type PlainYearMonthLike = {
era?: string | undefined;
@@ -4132,7 +4142,7 @@ declare namespace Temporal {
* See https://tc39.es/proposal-temporal/docs/yearmonth.html for more details.
*
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export class PlainYearMonth {
static from(
@@ -4197,7 +4207,7 @@ declare namespace Temporal {
/**
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export type ZonedDateTimeLike = {
era?: string | undefined;
@@ -4219,7 +4229,7 @@ declare namespace Temporal {
/**
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export type ZonedDateTimeISOFields = {
isoYear: number;
@@ -4238,7 +4248,7 @@ declare namespace Temporal {
/**
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export class ZonedDateTime {
static from(
@@ -4373,7 +4383,7 @@ declare namespace Temporal {
* See https://tc39.es/proposal-temporal/docs/now.html for more details.
*
* @category Temporal
- * @tags unstable
+ * @experimental
*/
export const Now: {
/**
@@ -4529,7 +4539,7 @@ declare namespace Temporal {
/**
* @category Temporal
- * @tags unstable
+ * @experimental
*/
declare interface Date {
toTemporalInstant(): Temporal.Instant;
@@ -4537,12 +4547,12 @@ declare interface Date {
/**
* @category Intl
- * @tags unstable
+ * @experimental
*/
declare namespace Intl {
/**
* @category Intl
- * @tags unstable
+ * @experimental
*/
export type Formattable =
| Date
@@ -4556,7 +4566,7 @@ declare namespace Intl {
/**
* @category Intl
- * @tags unstable
+ * @experimental
*/
export interface DateTimeFormatRangePart {
source: "shared" | "startRange" | "endRange";
@@ -4564,7 +4574,7 @@ declare namespace Intl {
/**
* @category Intl
- * @tags unstable
+ * @experimental
*/
export interface DateTimeFormat {
/**
@@ -4616,7 +4626,7 @@ declare namespace Intl {
/**
* @category Intl
- * @tags unstable
+ * @experimental
*/
export interface DateTimeFormatOptions {
// TODO: remove the props below after TS lib declarations are updated
@@ -4631,7 +4641,7 @@ declare namespace Intl {
* of bytes could not be allocated an exception is raised.
*
* @category Platform
- * @tags unstable
+ * @experimental
*/
declare interface Float16Array {
/**
@@ -4946,7 +4956,7 @@ declare interface Float16Array {
/**
* @category Platform
- * @tags unstable
+ * @experimental
*/
declare interface Float16ArrayConstructor {
readonly prototype: Float16Array;
@@ -4989,13 +4999,13 @@ declare interface Float16ArrayConstructor {
}
/**
* @category Platform
- * @tags unstable
+ * @experimental
*/
declare var Float16Array: Float16ArrayConstructor;
/**
* @category Platform
- * @tags unstable
+ * @experimental
*/
declare interface Float16 {
[Symbol.iterator](): IterableIterator<number>;
@@ -5015,7 +5025,7 @@ declare interface Float16 {
/**
* @category Platform
- * @tags unstable
+ * @experimental
*/
declare interface Float16Constructor {
new (elements: Iterable<number>): Float16;
@@ -5035,7 +5045,7 @@ declare interface Float16Constructor {
/**
* @category Platform
- * @tags unstable
+ * @experimental
*/
declare interface Float16Array {
readonly [Symbol.toStringTag]: "Float16Array";
@@ -5043,7 +5053,7 @@ declare interface Float16Array {
/**
* @category Platform
- * @tags unstable
+ * @experimental
*/
declare interface Float16Array {
/**
@@ -5056,7 +5066,7 @@ declare interface Float16Array {
/**
* @category Platform
- * @tags unstable
+ * @experimental
*/
declare interface Float16ArrayConstructor {
new (): Float16Array;
@@ -5064,7 +5074,7 @@ declare interface Float16ArrayConstructor {
/**
* @category Platform
- * @tags unstable
+ * @experimental
*/
declare interface Float16Array {
/**
@@ -5076,7 +5086,7 @@ declare interface Float16Array {
/**
* @category Platform
- * @tags unstable
+ * @experimental
*/
declare interface Float16Array {
/**
@@ -5152,7 +5162,7 @@ declare interface Float16Array {
/**
* @category Platform
- * @tags unstable
+ * @experimental
*/
declare interface DataView {
/**