foster/denoland-deno
1
0
Fork 0
mirror of https://github.com/denoland/deno.git synced 2024-11-21 15:04:11 -05:00
Code Issues Packages 1 Wiki Activity

chore: add code generation for @types/deno (#25545)

Browse source
This commit is contained in:
David Sherret 2024-09-23 15:18:52 -04:00 committed by GitHub
parent e1c8d2755e
commit 33f169beb9
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
19 changed files with 485 additions and 356 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

21
cli/tsc/dts/lib.deno.ns.d.ts vendored
View file

@ -10,7 +10,7 @@
*
* @category Platform
*/
declare interface ImportMeta {
interface ImportMeta {
/** A string representation of the fully qualified module URL. When the
* module is loaded locally, the value will be a file URL (e.g.
* `file:///path/module.ts`).
@ -89,7 +89,7 @@ declare interface ImportMeta {
*
* @category Performance
*/
declare interface Performance {
interface Performance {
/** Stores a timestamp with the associated name (a "mark"). */
mark(markName: string, options?: PerformanceMarkOptions): PerformanceMark;
@ -109,7 +109,7 @@ declare interface Performance {
*
* @category Performance
*/
declare interface PerformanceMarkOptions {
interface PerformanceMarkOptions {
/** Metadata to be included in the mark. */
// deno-lint-ignore no-explicit-any
detail?: any;
@ -126,7 +126,7 @@ declare interface PerformanceMarkOptions {
*
* @category Performance
*/
declare interface PerformanceMeasureOptions {
interface PerformanceMeasureOptions {
/** Metadata to be included in the measure. */
// deno-lint-ignore no-explicit-any
detail?: any;
@ -317,6 +317,7 @@ declare namespace Deno {
*
* @category Errors */
export class NotADirectory extends Error {}
/**
* Raised when trying to perform an operation while the relevant Deno
* permission (like `--allow-read`) has not been granted.
@ -326,6 +327,8 @@ declare namespace Deno {
*
* @category Errors */
export class NotCapable extends Error {}
export {}; // only export exports
}
/** The current process ID of this instance of the Deno CLI.
@ -5407,7 +5410,9 @@ declare namespace Deno {
*
* @category FFI
*/
export type NativeStructType = { readonly struct: readonly NativeType[] };
export interface NativeStructType {
readonly struct: readonly NativeType[];
}
/**
* @category FFI
@ -5700,7 +5705,9 @@ declare namespace Deno {
*
* @category FFI
*/
export type PointerObject<T = unknown> = { [brand]: T };
export interface PointerObject<T = unknown> {
[brand]: T;
}
/** Pointers are represented either with a {@linkcode PointerObject}
* object or a `null` if the pointer is null.
@ -6137,4 +6144,6 @@ declare namespace Deno {
| CreateHttpClientOptions
| (CreateHttpClientOptions & TlsCertifiedKeyPem),
): HttpClient;
export {}; // only export exports
}

42
cli/tsc/dts/lib.deno.shared_globals.d.ts vendored
View file

@ -413,7 +413,7 @@ declare function clearInterval(id?: number): void;
declare function clearTimeout(id?: number): void;
/** @category Platform */
declare interface VoidFunction {
interface VoidFunction {
(): void;
}
@ -445,7 +445,7 @@ declare function queueMicrotask(func: VoidFunction): void;
declare function dispatchEvent(event: Event): boolean;
/** @category Platform */
declare interface DOMStringList {
interface DOMStringList {
/** Returns the number of strings in strings. */
readonly length: number;
/** Returns true if strings contains string, and false otherwise. */
@ -456,13 +456,13 @@ declare interface DOMStringList {
}
/** @category Platform */
declare type BufferSource = ArrayBufferView | ArrayBuffer;
type BufferSource = ArrayBufferView | ArrayBuffer;
/** @category I/O */
declare var console: Console;
/** @category Events */
declare interface ErrorEventInit extends EventInit {
interface ErrorEventInit extends EventInit {
message?: string;
filename?: string;
lineno?: number;
@ -471,7 +471,7 @@ declare interface ErrorEventInit extends EventInit {
}
/** @category Events */
declare interface ErrorEvent extends Event {
interface ErrorEvent extends Event {
readonly message: string;
readonly filename: string;
readonly lineno: number;
@ -486,13 +486,13 @@ declare var ErrorEvent: {
};
/** @category Events */
declare interface PromiseRejectionEventInit extends EventInit {
interface PromiseRejectionEventInit extends EventInit {
promise: Promise<any>;
reason?: any;
}
/** @category Events */
declare interface PromiseRejectionEvent extends Event {
interface PromiseRejectionEvent extends Event {
readonly promise: Promise<any>;
readonly reason: any;
}
@ -507,24 +507,24 @@ declare var PromiseRejectionEvent: {
};
/** @category Workers */
declare interface AbstractWorkerEventMap {
interface AbstractWorkerEventMap {
"error": ErrorEvent;
}
/** @category Workers */
declare interface WorkerEventMap extends AbstractWorkerEventMap {
interface WorkerEventMap extends AbstractWorkerEventMap {
"message": MessageEvent;
"messageerror": MessageEvent;
}
/** @category Workers */
declare interface WorkerOptions {
interface WorkerOptions {
type?: "classic" | "module";
name?: string;
}
/** @category Workers */
declare interface Worker extends EventTarget {
interface Worker extends EventTarget {
onerror: (this: Worker, e: ErrorEvent) => any | null;
onmessage: (this: Worker, e: MessageEvent) => any | null;
onmessageerror: (this: Worker, e: MessageEvent) => any | null;
@ -560,10 +560,10 @@ declare var Worker: {
};
/** @category Performance */
declare type PerformanceEntryList = PerformanceEntry[];
type PerformanceEntryList = PerformanceEntry[];
/** @category Performance */
declare interface Performance extends EventTarget {
interface Performance extends EventTarget {
/** Returns a timestamp representing the start of the performance measurement. */
readonly timeOrigin: number;
@ -617,7 +617,7 @@ declare var Performance: {
declare var performance: Performance;
/** @category Performance */
declare interface PerformanceMarkOptions {
interface PerformanceMarkOptions {
/** Metadata to be included in the mark. */
detail?: any;
@ -626,7 +626,7 @@ declare interface PerformanceMarkOptions {
}
/** @category Performance */
declare interface PerformanceMeasureOptions {
interface PerformanceMeasureOptions {
/** Metadata to be included in the measure. */
detail?: any;
@ -648,7 +648,7 @@ declare interface PerformanceMeasureOptions {
*
* @category Performance
*/
declare interface PerformanceEntry {
interface PerformanceEntry {
readonly duration: number;
readonly entryType: string;
readonly name: string;
@ -675,7 +675,7 @@ declare var PerformanceEntry: {
*
* @category Performance
*/
declare interface PerformanceMark extends PerformanceEntry {
interface PerformanceMark extends PerformanceEntry {
readonly detail: any;
readonly entryType: "mark";
}
@ -699,7 +699,7 @@ declare var PerformanceMark: {
*
* @category Performance
*/
declare interface PerformanceMeasure extends PerformanceEntry {
interface PerformanceMeasure extends PerformanceEntry {
readonly detail: any;
readonly entryType: "measure";
}
@ -717,12 +717,12 @@ declare var PerformanceMeasure: {
};
/** @category Events */
declare interface CustomEventInit<T = any> extends EventInit {
interface CustomEventInit<T = any> extends EventInit {
detail?: T;
}
/** @category Events */
declare interface CustomEvent<T = any> extends Event {
interface CustomEvent<T = any> extends Event {
/** Returns any custom data event was created with. Typically used for
* synthetic events. */
readonly detail: T;
@ -735,7 +735,7 @@ declare var CustomEvent: {
};
/** @category Platform */
declare interface ErrorConstructor {
interface ErrorConstructor {
/** See https://v8.dev/docs/stack-trace-api#stack-trace-collection-for-custom-exceptions. */
captureStackTrace(error: Object, constructor?: Function): void;
// TODO(nayeemrmn): Support `Error.prepareStackTrace()`. We currently use this

62
cli/tsc/dts/lib.deno.unstable.d.ts vendored
View file

@ -212,7 +212,7 @@ declare namespace Deno {
* @category Cloud
* @experimental
*/
export function openKv(path?: string): Promise<Deno.Kv>;
export function openKv(path?: string): Promise<Kv>;
/** **UNSTABLE**: New API, yet to be vetted.
*
@ -475,7 +475,11 @@ declare namespace Deno {
* @category Cloud
* @experimental
*/
export type KvEntry<T> = { key: KvKey; value: T; versionstamp: string };
export interface KvEntry<T> {
key: KvKey;
value: T;
versionstamp: string;
}
/**
* **UNSTABLE**: New API, yet to be vetted.
@ -680,7 +684,7 @@ declare namespace Deno {
value: unknown,
options?: {
delay?: number;
keysIfUndelivered?: Deno.KvKey[];
keysIfUndelivered?: KvKey[];
backoffSchedule?: number[];
},
): this;
@ -911,7 +915,7 @@ declare namespace Deno {
value: unknown,
options?: {
delay?: number;
keysIfUndelivered?: Deno.KvKey[];
keysIfUndelivered?: KvKey[];
backoffSchedule?: number[];
},
): Promise<KvCommitResult>;
@ -1041,10 +1045,10 @@ declare namespace Deno {
* @category Jupyter
* @experimental
*/
export type VegaObject = {
export interface VegaObject {
$schema: string;
[key: string]: unknown;
};
}
/**
* A collection of supported media types and data for Jupyter frontends.
@ -1052,7 +1056,7 @@ declare namespace Deno {
* @category Jupyter
* @experimental
*/
export type MediaBundle = {
export interface MediaBundle {
"text/plain"?: string;
"text/html"?: string;
"image/svg+xml"?: string;
@ -1078,7 +1082,7 @@ declare namespace Deno {
// Must support a catch all for custom media types / mimetypes
[key: string]: string | object | undefined;
};
}
/**
* @category Jupyter
@ -1090,9 +1094,9 @@ declare namespace Deno {
* @category Jupyter
* @experimental
*/
export type Displayable = {
export interface Displayable {
[$display]: () => MediaBundle | Promise<MediaBundle>;
};
}
/**
* Display function for Jupyter Deno Kernel.
@ -1217,7 +1221,11 @@ declare namespace Deno {
buffers?: Uint8Array[];
},
): Promise<void>;
export {}; // only export exports
}
export {}; // only export exports
}
/** **UNSTABLE**: New API, yet to be vetted.
@ -1225,7 +1233,7 @@ declare namespace Deno {
* @category Workers
* @experimental
*/
declare interface WorkerOptions {
interface WorkerOptions {
/** **UNSTABLE**: New API, yet to be vetted.
*
* Configure permissions options to change the level of access the worker will
@ -1266,7 +1274,7 @@ declare interface WorkerOptions {
* @category WebSockets
* @experimental
*/
declare interface WebSocketStreamOptions {
interface WebSocketStreamOptions {
protocols?: string[];
signal?: AbortSignal;
headers?: HeadersInit;
@ -1277,7 +1285,7 @@ declare interface WebSocketStreamOptions {
* @category WebSockets
* @experimental
*/
declare interface WebSocketConnection {
interface WebSocketConnection {
readable: ReadableStream<string | Uint8Array>;
writable: WritableStream<string | Uint8Array>;
extensions: string;
@ -1289,7 +1297,7 @@ declare interface WebSocketConnection {
* @category WebSockets
* @experimental
*/
declare interface WebSocketCloseInfo {
interface WebSocketCloseInfo {
code?: number;
reason?: string;
}
@ -1300,7 +1308,7 @@ declare interface WebSocketCloseInfo {
* @category WebSockets
* @experimental
*/
declare interface WebSocketStream {
interface WebSocketStream {
url: string;
opened: Promise<WebSocketConnection>;
closed: Promise<WebSocketCloseInfo>;
@ -1324,7 +1332,7 @@ declare var WebSocketStream: {
* @category WebSockets
* @experimental
*/
declare interface WebSocketError extends DOMException {
interface WebSocketError extends DOMException {
readonly closeCode: number;
readonly reason: string;
}
@ -2884,7 +2892,7 @@ declare namespace Temporal {
* @category Temporal
* @experimental
*/
declare interface Date {
interface Date {
toTemporalInstant(): Temporal.Instant;
}
@ -2986,7 +2994,7 @@ declare namespace Intl {
* @category Platform
* @experimental
*/
declare interface Float16Array {
interface Float16Array {
/**
* The size in bytes of each element in the array.
*/
@ -3301,7 +3309,7 @@ declare interface Float16Array {
* @category Platform
* @experimental
*/
declare interface Float16ArrayConstructor {
interface Float16ArrayConstructor {
readonly prototype: Float16Array;
new (length: number): Float16Array;
new (array: ArrayLike<number> | ArrayBufferLike): Float16Array;
@ -3350,7 +3358,7 @@ declare var Float16Array: Float16ArrayConstructor;
* @category Platform
* @experimental
*/
declare interface Float16Array {
interface Float16Array {
[Symbol.iterator](): IterableIterator<number>;
/**
* Returns an array of key, value pairs for every entry in the array
@ -3370,7 +3378,7 @@ declare interface Float16Array {
* @category Platform
* @experimental
*/
declare interface Float16Constructor {
interface Float16Constructor {
new (elements: Iterable<number>): Float16Array;
/**
@ -3390,7 +3398,7 @@ declare interface Float16Constructor {
* @category Platform
* @experimental
*/
declare interface Float16Array {
interface Float16Array {
readonly [Symbol.toStringTag]: "Float16Array";
}
@ -3398,7 +3406,7 @@ declare interface Float16Array {
* @category Platform
* @experimental
*/
declare interface Float16Array {
interface Float16Array {
/**
* Determines whether an array includes a certain element, returning true or false as appropriate.
* @param searchElement The element to search for.
@ -3411,7 +3419,7 @@ declare interface Float16Array {
* @category Platform
* @experimental
*/
declare interface Float16ArrayConstructor {
interface Float16ArrayConstructor {
new (): Float16Array;
}
@ -3419,7 +3427,7 @@ declare interface Float16ArrayConstructor {
* @category Platform
* @experimental
*/
declare interface Float16Array {
interface Float16Array {
/**
* Returns the item located at the specified index.
* @param index The zero-based index of the desired code unit. A negative index will count back from the last item.
@ -3431,7 +3439,7 @@ declare interface Float16Array {
* @category Platform
* @experimental
*/
declare interface Float16Array {
interface Float16Array {
/**
* Returns the value of the last element in the array where predicate is true, and undefined
* otherwise.
@ -3507,7 +3515,7 @@ declare interface Float16Array {
* @category Platform
* @experimental
*/
declare interface DataView {
interface DataView {
/**
* Gets the Float16 value at the specified byte offset from the start of the view. There is
* no alignment constraint; multi-byte values may be fetched from any offset.

8
cli/tsc/dts/lib.deno.window.d.ts vendored
View file

@ -8,14 +8,14 @@
/// <reference lib="deno.cache" />
/** @category Platform */
declare interface WindowEventMap {
interface WindowEventMap {
"error": ErrorEvent;
"unhandledrejection": PromiseRejectionEvent;
"rejectionhandled": PromiseRejectionEvent;
}
/** @category Platform */
declare interface Window extends EventTarget {
interface Window extends EventTarget {
readonly window: Window & typeof globalThis;
readonly self: Window & typeof globalThis;
onerror: ((this: Window, ev: ErrorEvent) => any) | null;
@ -105,7 +105,7 @@ declare var sessionStorage: Storage;
declare var caches: CacheStorage;
/** @category Platform */
declare interface Navigator {
interface Navigator {
readonly gpu: GPU;
readonly hardwareConcurrency: number;
readonly userAgent: string;
@ -221,7 +221,7 @@ declare function removeEventListener(
*
* @category Platform
*/
declare interface Location {
interface Location {
/** Returns a DOMStringList object listing the origins of the ancestor
* browsing contexts, from the parent browsing context to the top-level
* browsing context.

212
cli/tsc/dts/lib.deno_webgpu.d.ts vendored
View file

@ -6,12 +6,12 @@
/// <reference lib="esnext" />
/** @category GPU */
declare interface GPUObjectBase {
interface GPUObjectBase {
label: string;
}
/** @category GPU */
declare interface GPUObjectDescriptorBase {
interface GPUObjectDescriptorBase {
label?: string;
}
@ -84,13 +84,13 @@ declare class GPU {
}
/** @category GPU */
declare interface GPURequestAdapterOptions {
interface GPURequestAdapterOptions {
powerPreference?: GPUPowerPreference;
forceFallbackAdapter?: boolean;
}
/** @category GPU */
declare type GPUPowerPreference = "low-power" | "high-performance";
type GPUPowerPreference = "low-power" | "high-performance";
/** @category GPU */
declare class GPUAdapter {
@ -103,13 +103,13 @@ declare class GPUAdapter {
}
/** @category GPU */
declare interface GPUDeviceDescriptor extends GPUObjectDescriptorBase {
interface GPUDeviceDescriptor extends GPUObjectDescriptorBase {
requiredFeatures?: GPUFeatureName[];
requiredLimits?: Record<string, number>;
}
/** @category GPU */
declare type GPUFeatureName =
type GPUFeatureName =
| "depth-clip-control"
| "depth32float-stencil8"
| "pipeline-statistics-query"
@ -206,20 +206,20 @@ declare class GPUBuffer implements GPUObjectBase {
}
/** @category GPU */
declare type GPUBufferMapState = "unmapped" | "pending" | "mapped";
type GPUBufferMapState = "unmapped" | "pending" | "mapped";
/** @category GPU */
declare interface GPUBufferDescriptor extends GPUObjectDescriptorBase {
interface GPUBufferDescriptor extends GPUObjectDescriptorBase {
size: number;
usage: GPUBufferUsageFlags;
mappedAtCreation?: boolean;
}
/** @category GPU */
declare type GPUBufferUsageFlags = number;
type GPUBufferUsageFlags = number;
/** @category GPU */
declare type GPUFlagsConstant = number;
type GPUFlagsConstant = number;
/** @category GPU */
declare class GPUBufferUsage {
@ -236,7 +236,7 @@ declare class GPUBufferUsage {
}
/** @category GPU */
declare type GPUMapModeFlags = number;
type GPUMapModeFlags = number;
/** @category GPU */
declare class GPUMapMode {
@ -262,7 +262,7 @@ declare class GPUTexture implements GPUObjectBase {
}
/** @category GPU */
declare interface GPUTextureDescriptor extends GPUObjectDescriptorBase {
interface GPUTextureDescriptor extends GPUObjectDescriptorBase {
size: GPUExtent3D;
mipLevelCount?: number;
sampleCount?: number;
@ -273,10 +273,10 @@ declare interface GPUTextureDescriptor extends GPUObjectDescriptorBase {
}
/** @category GPU */
declare type GPUTextureDimension = "1d" | "2d" | "3d";
type GPUTextureDimension = "1d" | "2d" | "3d";
/** @category GPU */
declare type GPUTextureUsageFlags = number;
type GPUTextureUsageFlags = number;
/** @category GPU */
declare class GPUTextureUsage {
@ -293,7 +293,7 @@ declare class GPUTextureView implements GPUObjectBase {
}
/** @category GPU */
declare interface GPUTextureViewDescriptor extends GPUObjectDescriptorBase {
interface GPUTextureViewDescriptor extends GPUObjectDescriptorBase {
format?: GPUTextureFormat;
dimension?: GPUTextureViewDimension;
aspect?: GPUTextureAspect;
@ -304,7 +304,7 @@ declare interface GPUTextureViewDescriptor extends GPUObjectDescriptorBase {
}
/** @category GPU */
declare type GPUTextureViewDimension =
type GPUTextureViewDimension =
| "1d"
| "2d"
| "2d-array"
@ -313,10 +313,10 @@ declare type GPUTextureViewDimension =
| "3d";
/** @category GPU */
declare type GPUTextureAspect = "all" | "stencil-only" | "depth-only";
type GPUTextureAspect = "all" | "stencil-only" | "depth-only";
/** @category GPU */
declare type GPUTextureFormat =
type GPUTextureFormat =
| "r8unorm"
| "r8snorm"
| "r8uint"
@ -419,7 +419,7 @@ declare class GPUSampler implements GPUObjectBase {
}
/** @category GPU */
declare interface GPUSamplerDescriptor extends GPUObjectDescriptorBase {
interface GPUSamplerDescriptor extends GPUObjectDescriptorBase {
addressModeU?: GPUAddressMode;
addressModeV?: GPUAddressMode;
addressModeW?: GPUAddressMode;
@ -433,16 +433,16 @@ declare interface GPUSamplerDescriptor extends GPUObjectDescriptorBase {
}
/** @category GPU */
declare type GPUAddressMode = "clamp-to-edge" | "repeat" | "mirror-repeat";
type GPUAddressMode = "clamp-to-edge" | "repeat" | "mirror-repeat";
/** @category GPU */
declare type GPUFilterMode = "nearest" | "linear";
type GPUFilterMode = "nearest" | "linear";
/** @category GPU */
declare type GPUMipmapFilterMode = "nearest" | "linear";
type GPUMipmapFilterMode = "nearest" | "linear";
/** @category GPU */
declare type GPUCompareFunction =
type GPUCompareFunction =
| "never"
| "less"
| "equal"
@ -458,12 +458,12 @@ declare class GPUBindGroupLayout implements GPUObjectBase {
}
/** @category GPU */
declare interface GPUBindGroupLayoutDescriptor extends GPUObjectDescriptorBase {
interface GPUBindGroupLayoutDescriptor extends GPUObjectDescriptorBase {
entries: GPUBindGroupLayoutEntry[];
}
/** @category GPU */
declare interface GPUBindGroupLayoutEntry {
interface GPUBindGroupLayoutEntry {
binding: number;
visibility: GPUShaderStageFlags;
@ -474,7 +474,7 @@ declare interface GPUBindGroupLayoutEntry {
}
/** @category GPU */
declare type GPUShaderStageFlags = number;
type GPUShaderStageFlags = number;
/** @category GPU */
declare class GPUShaderStage {
@ -484,35 +484,35 @@ declare class GPUShaderStage {
}
/** @category GPU */
declare interface GPUBufferBindingLayout {
interface GPUBufferBindingLayout {
type?: GPUBufferBindingType;
hasDynamicOffset?: boolean;
minBindingSize?: number;
}
/** @category GPU */
declare type GPUBufferBindingType = "uniform" | "storage" | "read-only-storage";
type GPUBufferBindingType = "uniform" | "storage" | "read-only-storage";
/** @category GPU */
declare interface GPUSamplerBindingLayout {
interface GPUSamplerBindingLayout {
type?: GPUSamplerBindingType;
}
/** @category GPU */
declare type GPUSamplerBindingType =
type GPUSamplerBindingType =
| "filtering"
| "non-filtering"
| "comparison";
/** @category GPU */
declare interface GPUTextureBindingLayout {
interface GPUTextureBindingLayout {
sampleType?: GPUTextureSampleType;
viewDimension?: GPUTextureViewDimension;
multisampled?: boolean;
}
/** @category GPU */
declare type GPUTextureSampleType =
type GPUTextureSampleType =
| "float"
| "unfilterable-float"
| "depth"
@ -520,13 +520,13 @@ declare type GPUTextureSampleType =
| "uint";
/** @category GPU */
declare type GPUStorageTextureAccess =
type GPUStorageTextureAccess =
| "write-only"
| "read-only"
| "read-write";
/** @category GPU */
declare interface GPUStorageTextureBindingLayout {
interface GPUStorageTextureBindingLayout {
access: GPUStorageTextureAccess;
format: GPUTextureFormat;
viewDimension?: GPUTextureViewDimension;
@ -538,25 +538,25 @@ declare class GPUBindGroup implements GPUObjectBase {
}
/** @category GPU */
declare interface GPUBindGroupDescriptor extends GPUObjectDescriptorBase {
interface GPUBindGroupDescriptor extends GPUObjectDescriptorBase {
layout: GPUBindGroupLayout;
entries: GPUBindGroupEntry[];
}
/** @category GPU */
declare type GPUBindingResource =
type GPUBindingResource =
| GPUSampler
| GPUTextureView
| GPUBufferBinding;
/** @category GPU */
declare interface GPUBindGroupEntry {
interface GPUBindGroupEntry {
binding: number;
resource: GPUBindingResource;
}
/** @category GPU */
declare interface GPUBufferBinding {
interface GPUBufferBinding {
buffer: GPUBuffer;
offset?: number;
size?: number;
@ -568,15 +568,15 @@ declare class GPUPipelineLayout implements GPUObjectBase {
}
/** @category GPU */
declare interface GPUPipelineLayoutDescriptor extends GPUObjectDescriptorBase {
interface GPUPipelineLayoutDescriptor extends GPUObjectDescriptorBase {
bindGroupLayouts: GPUBindGroupLayout[];
}
/** @category GPU */
declare type GPUCompilationMessageType = "error" | "warning" | "info";
type GPUCompilationMessageType = "error" | "warning" | "info";
/** @category GPU */
declare interface GPUCompilationMessage {
interface GPUCompilationMessage {
readonly message: string;
readonly type: GPUCompilationMessageType;
readonly lineNum: number;
@ -584,7 +584,7 @@ declare interface GPUCompilationMessage {
}
/** @category GPU */
declare interface GPUCompilationInfo {
interface GPUCompilationInfo {
readonly messages: ReadonlyArray<GPUCompilationMessage>;
}
@ -596,12 +596,12 @@ declare class GPUPipelineError extends DOMException {
}
/** @category GPU */
declare interface GPUPipelineErrorInit {
interface GPUPipelineErrorInit {
reason: GPUPipelineErrorReason;
}
/** @category GPU */
declare type GPUPipelineErrorReason = "validation" | "internal";
type GPUPipelineErrorReason = "validation" | "internal";
/** @category GPU */
declare class GPUShaderModule implements GPUObjectBase {
@ -609,26 +609,26 @@ declare class GPUShaderModule implements GPUObjectBase {
}
/** @category GPU */
declare interface GPUShaderModuleDescriptor extends GPUObjectDescriptorBase {
interface GPUShaderModuleDescriptor extends GPUObjectDescriptorBase {
code: string;
sourceMap?: any;
}
/** @category GPU */
declare type GPUAutoLayoutMode = "auto";
type GPUAutoLayoutMode = "auto";
/** @category GPU */
declare interface GPUPipelineDescriptorBase extends GPUObjectDescriptorBase {
interface GPUPipelineDescriptorBase extends GPUObjectDescriptorBase {
layout: GPUPipelineLayout | GPUAutoLayoutMode;
}
/** @category GPU */
declare interface GPUPipelineBase {
interface GPUPipelineBase {
getBindGroupLayout(index: number): GPUBindGroupLayout;
}
/** @category GPU */
declare interface GPUProgrammableStage {
interface GPUProgrammableStage {
module: GPUShaderModule;
entryPoint?: string;
constants?: Record<string, number>;
@ -642,8 +642,7 @@ declare class GPUComputePipeline implements GPUObjectBase, GPUPipelineBase {
}
/** @category GPU */
declare interface GPUComputePipelineDescriptor
extends GPUPipelineDescriptorBase {
interface GPUComputePipelineDescriptor extends GPUPipelineDescriptorBase {
compute: GPUProgrammableStage;
}
@ -655,8 +654,7 @@ declare class GPURenderPipeline implements GPUObjectBase, GPUPipelineBase {
}
/** @category GPU */
declare interface GPURenderPipelineDescriptor
extends GPUPipelineDescriptorBase {
interface GPURenderPipelineDescriptor extends GPUPipelineDescriptorBase {
vertex: GPUVertexState;
primitive?: GPUPrimitiveState;
depthStencil?: GPUDepthStencilState;
@ -665,7 +663,7 @@ declare interface GPURenderPipelineDescriptor
}
/** @category GPU */
declare interface GPUPrimitiveState {
interface GPUPrimitiveState {
topology?: GPUPrimitiveTopology;
stripIndexFormat?: GPUIndexFormat;
frontFace?: GPUFrontFace;
@ -674,7 +672,7 @@ declare interface GPUPrimitiveState {
}
/** @category GPU */
declare type GPUPrimitiveTopology =
type GPUPrimitiveTopology =
| "point-list"
| "line-list"
| "line-strip"
@ -682,25 +680,25 @@ declare type GPUPrimitiveTopology =
| "triangle-strip";
/** @category GPU */
declare type GPUFrontFace = "ccw" | "cw";
type GPUFrontFace = "ccw" | "cw";
/** @category GPU */
declare type GPUCullMode = "none" | "front" | "back";
type GPUCullMode = "none" | "front" | "back";
/** @category GPU */
declare interface GPUMultisampleState {
interface GPUMultisampleState {
count?: number;
mask?: number;
alphaToCoverageEnabled?: boolean;
}
/** @category GPU */
declare interface GPUFragmentState extends GPUProgrammableStage {
interface GPUFragmentState extends GPUProgrammableStage {
targets: (GPUColorTargetState | null)[];
}
/** @category GPU */
declare interface GPUColorTargetState {
interface GPUColorTargetState {
format: GPUTextureFormat;
blend?: GPUBlendState;
@ -708,13 +706,13 @@ declare interface GPUColorTargetState {
}
/** @category GPU */
declare interface GPUBlendState {
interface GPUBlendState {
color: GPUBlendComponent;
alpha: GPUBlendComponent;
}
/** @category GPU */
declare type GPUColorWriteFlags = number;
type GPUColorWriteFlags = number;
/** @category GPU */
declare class GPUColorWrite {
@ -726,14 +724,14 @@ declare class GPUColorWrite {
}
/** @category GPU */
declare interface GPUBlendComponent {
interface GPUBlendComponent {
operation?: GPUBlendOperation;
srcFactor?: GPUBlendFactor;
dstFactor?: GPUBlendFactor;
}
/** @category GPU */
declare type GPUBlendFactor =
type GPUBlendFactor =
| "zero"
| "one"
| "src"
@ -749,7 +747,7 @@ declare type GPUBlendFactor =
| "one-minus-constant";
/** @category GPU */
declare type GPUBlendOperation =
type GPUBlendOperation =
| "add"
| "subtract"
| "reverse-subtract"
@ -757,7 +755,7 @@ declare type GPUBlendOperation =
| "max";
/** @category GPU */
declare interface GPUDepthStencilState {
interface GPUDepthStencilState {
format: GPUTextureFormat;
depthWriteEnabled: boolean;
@ -775,7 +773,7 @@ declare interface GPUDepthStencilState {
}
/** @category GPU */
declare interface GPUStencilFaceState {
interface GPUStencilFaceState {
compare?: GPUCompareFunction;
failOp?: GPUStencilOperation;
depthFailOp?: GPUStencilOperation;
@ -783,7 +781,7 @@ declare interface GPUStencilFaceState {
}
/** @category GPU */
declare type GPUStencilOperation =
type GPUStencilOperation =
| "keep"
| "zero"
| "replace"
@ -794,10 +792,10 @@ declare type GPUStencilOperation =
| "decrement-wrap";
/** @category GPU */
declare type GPUIndexFormat = "uint16" | "uint32";
type GPUIndexFormat = "uint16" | "uint32";
/** @category GPU */
declare type GPUVertexFormat =
type GPUVertexFormat =
| "uint8x2"
| "uint8x4"
| "sint8x2"
@ -831,22 +829,22 @@ declare type GPUVertexFormat =
| "unorm10-10-10-2";
/** @category GPU */
declare type GPUVertexStepMode = "vertex" | "instance";
type GPUVertexStepMode = "vertex" | "instance";
/** @category GPU */
declare interface GPUVertexState extends GPUProgrammableStage {
interface GPUVertexState extends GPUProgrammableStage {
buffers?: (GPUVertexBufferLayout | null)[];
}
/** @category GPU */
declare interface GPUVertexBufferLayout {
interface GPUVertexBufferLayout {
arrayStride: number;
stepMode?: GPUVertexStepMode;
attributes: GPUVertexAttribute[];
}
/** @category GPU */
declare interface GPUVertexAttribute {
interface GPUVertexAttribute {
format: GPUVertexFormat;
offset: number;
@ -854,7 +852,7 @@ declare interface GPUVertexAttribute {
}
/** @category GPU */
declare interface GPUImageDataLayout {
interface GPUImageDataLayout {
offset?: number;
bytesPerRow?: number;
rowsPerImage?: number;
@ -866,7 +864,7 @@ declare class GPUCommandBuffer implements GPUObjectBase {
}
/** @category GPU */
declare interface GPUCommandBufferDescriptor extends GPUObjectDescriptorBase {}
interface GPUCommandBufferDescriptor extends GPUObjectDescriptorBase {}
/** @category GPU */
declare class GPUCommandEncoder implements GPUObjectBase {
@ -927,15 +925,15 @@ declare class GPUCommandEncoder implements GPUObjectBase {
}
/** @category GPU */
declare interface GPUCommandEncoderDescriptor extends GPUObjectDescriptorBase {}
interface GPUCommandEncoderDescriptor extends GPUObjectDescriptorBase {}
/** @category GPU */
declare interface GPUImageCopyBuffer extends GPUImageDataLayout {
interface GPUImageCopyBuffer extends GPUImageDataLayout {
buffer: GPUBuffer;
}
/** @category GPU */
declare interface GPUImageCopyTexture {
interface GPUImageCopyTexture {
texture: GPUTexture;
mipLevel?: number;
origin?: GPUOrigin3D;
@ -943,7 +941,7 @@ declare interface GPUImageCopyTexture {
}
/** @category GPU */
declare interface GPUProgrammablePassEncoder {
interface GPUProgrammablePassEncoder {
setBindGroup(
index: number,
bindGroup: GPUBindGroup,
@ -993,19 +991,19 @@ declare class GPUComputePassEncoder
}
/** @category GPU */
declare interface GPUComputePassTimestampWrites {
interface GPUComputePassTimestampWrites {
querySet: GPUQuerySet;
beginningOfPassWriteIndex?: number;
endOfPassWriteIndex?: number;
}
/** @category GPU */
declare interface GPUComputePassDescriptor extends GPUObjectDescriptorBase {
interface GPUComputePassDescriptor extends GPUObjectDescriptorBase {
timestampWrites?: GPUComputePassTimestampWrites;
}
/** @category GPU */
declare interface GPURenderEncoderBase {
interface GPURenderEncoderBase {
setPipeline(pipeline: GPURenderPipeline): undefined;
setIndexBuffer(
@ -1120,14 +1118,14 @@ declare class GPURenderPassEncoder
}
/** @category GPU */
declare interface GPURenderPassTimestampWrites {
interface GPURenderPassTimestampWrites {
querySet: GPUQuerySet;
beginningOfPassWriteIndex?: number;
endOfPassWriteIndex?: number;
}
/** @category GPU */
declare interface GPURenderPassDescriptor extends GPUObjectDescriptorBase {
interface GPURenderPassDescriptor extends GPUObjectDescriptorBase {
colorAttachments: (GPURenderPassColorAttachment | null)[];
depthStencilAttachment?: GPURenderPassDepthStencilAttachment;
occlusionQuerySet?: GPUQuerySet;
@ -1135,7 +1133,7 @@ declare interface GPURenderPassDescriptor extends GPUObjectDescriptorBase {
}
/** @category GPU */
declare interface GPURenderPassColorAttachment {
interface GPURenderPassColorAttachment {
view: GPUTextureView;
resolveTarget?: GPUTextureView;
@ -1145,7 +1143,7 @@ declare interface GPURenderPassColorAttachment {
}
/** @category GPU */
declare interface GPURenderPassDepthStencilAttachment {
interface GPURenderPassDepthStencilAttachment {
view: GPUTextureView;
depthClearValue?: number;
@ -1160,10 +1158,10 @@ declare interface GPURenderPassDepthStencilAttachment {
}
/** @category GPU */
declare type GPULoadOp = "load" | "clear";
type GPULoadOp = "load" | "clear";
/** @category GPU */
declare type GPUStoreOp = "store" | "discard";
type GPUStoreOp = "store" | "discard";
/** @category GPU */
declare class GPURenderBundle implements GPUObjectBase {
@ -1171,7 +1169,7 @@ declare class GPURenderBundle implements GPUObjectBase {
}
/** @category GPU */
declare interface GPURenderBundleDescriptor extends GPUObjectDescriptorBase {}
interface GPURenderBundleDescriptor extends GPUObjectDescriptorBase {}
/** @category GPU */
declare class GPURenderBundleEncoder
@ -1228,14 +1226,14 @@ declare class GPURenderBundleEncoder
}
/** @category GPU */
declare interface GPURenderPassLayout extends GPUObjectDescriptorBase {
interface GPURenderPassLayout extends GPUObjectDescriptorBase {
colorFormats: (GPUTextureFormat | null)[];
depthStencilFormat?: GPUTextureFormat;
sampleCount?: number;
}
/** @category GPU */
declare interface GPURenderBundleEncoderDescriptor extends GPURenderPassLayout {
interface GPURenderBundleEncoderDescriptor extends GPURenderPassLayout {
depthReadOnly?: boolean;
stencilReadOnly?: boolean;
}
@ -1275,19 +1273,19 @@ declare class GPUQuerySet implements GPUObjectBase {
}
/** @category GPU */
declare interface GPUQuerySetDescriptor extends GPUObjectDescriptorBase {
interface GPUQuerySetDescriptor extends GPUObjectDescriptorBase {
type: GPUQueryType;
count: number;
}
/** @category GPU */
declare type GPUQueryType = "occlusion" | "timestamp";
type GPUQueryType = "occlusion" | "timestamp";
/** @category GPU */
declare type GPUDeviceLostReason = "destroyed";
type GPUDeviceLostReason = "destroyed";
/** @category GPU */
declare interface GPUDeviceLostInfo {
interface GPUDeviceLostInfo {
readonly reason: GPUDeviceLostReason;
readonly message: string;
}
@ -1313,7 +1311,7 @@ declare class GPUInternalError extends GPUError {
}
/** @category GPU */
declare type GPUErrorFilter = "out-of-memory" | "validation" | "internal";
type GPUErrorFilter = "out-of-memory" | "validation" | "internal";
/** @category GPU */
declare class GPUUncapturedErrorEvent extends Event {
@ -1326,12 +1324,12 @@ declare class GPUUncapturedErrorEvent extends Event {
}
/** @category GPU */
declare interface GPUUncapturedErrorEventInit extends EventInit {
interface GPUUncapturedErrorEventInit extends EventInit {
error: GPUError;
}
/** @category GPU */
declare interface GPUColorDict {
interface GPUColorDict {
r: number;
g: number;
b: number;
@ -1339,33 +1337,33 @@ declare interface GPUColorDict {
}
/** @category GPU */
declare type GPUColor = number[] | GPUColorDict;
type GPUColor = number[] | GPUColorDict;
/** @category GPU */
declare interface GPUOrigin3DDict {
interface GPUOrigin3DDict {
x?: number;
y?: number;
z?: number;
}
/** @category GPU */
declare type GPUOrigin3D = number[] | GPUOrigin3DDict;
type GPUOrigin3D = number[] | GPUOrigin3DDict;
/** @category GPU */
declare interface GPUExtent3DDict {
interface GPUExtent3DDict {
width: number;
height?: number;
depthOrArrayLayers?: number;
}
/** @category GPU */
declare type GPUExtent3D = number[] | GPUExtent3DDict;
type GPUExtent3D = number[] | GPUExtent3DDict;
/** @category GPU */
declare type GPUCanvasAlphaMode = "opaque" | "premultiplied";
type GPUCanvasAlphaMode = "opaque" | "premultiplied";
/** @category GPU */
declare interface GPUCanvasConfiguration {
interface GPUCanvasConfiguration {
device: GPUDevice;
format: GPUTextureFormat;
usage?: GPUTextureUsageFlags;
@ -1374,7 +1372,7 @@ declare interface GPUCanvasConfiguration {
alphaMode?: GPUCanvasAlphaMode;
}
/** @category GPU */
declare interface GPUCanvasContext {
interface GPUCanvasContext {
configure(configuration: GPUCanvasConfiguration): undefined;
unconfigure(): undefined;
getCurrentTexture(): GPUTexture;

4
ext/broadcast_channel/lib.deno_broadcast_channel.d.ts vendored
View file

@ -9,7 +9,7 @@
* @category Messaging
* @experimental
*/
declare interface BroadcastChannelEventMap {
interface BroadcastChannelEventMap {
"message": MessageEvent;
"messageerror": MessageEvent;
}
@ -18,7 +18,7 @@ declare interface BroadcastChannelEventMap {
* @category Messaging
* @experimental
*/
declare interface BroadcastChannel extends EventTarget {
interface BroadcastChannel extends EventTarget {
/**
* Returns the channel name (as passed to the constructor).
*/

6
ext/cache/lib.deno_cache.d.ts vendored
View file

@ -9,7 +9,7 @@
declare var caches: CacheStorage;
/** @category Cache */
declare interface CacheStorage {
interface CacheStorage {
/** Open a cache storage for the provided name. */
open(cacheName: string): Promise<Cache>;
/** Check if cache already exists for the provided name. */
@ -19,7 +19,7 @@ declare interface CacheStorage {
}
/** @category Cache */
declare interface Cache {
interface Cache {
/**
* Put the provided request/response into the cache.
*
@ -65,7 +65,7 @@ declare var CacheStorage: {
};
/** @category Cache */
declare interface CacheQueryOptions {
interface CacheQueryOptions {
ignoreMethod?: boolean;
ignoreSearch?: boolean;
ignoreVary?: boolean;

14
ext/canvas/lib.deno_canvas.d.ts vendored
View file

@ -12,14 +12,14 @@
*
* @category Canvas
*/
declare type ColorSpaceConversion = "default" | "none";
type ColorSpaceConversion = "default" | "none";
/**
* Specifies how the bitmap image should be oriented.
*
* @category Canvas
*/
declare type ImageOrientation = "flipY" | "from-image" | "none";
type ImageOrientation = "flipY" | "from-image" | "none";
/**
* Specifies whether the bitmap's color channels should be premultiplied by
@ -27,7 +27,7 @@ declare type ImageOrientation = "flipY" | "from-image" | "none";
*
* @category Canvas
*/
declare type PremultiplyAlpha = "default" | "none" | "premultiply";
type PremultiplyAlpha = "default" | "none" | "premultiply";
/**
* Specifies the algorithm to be used for resizing the input to match the
@ -35,20 +35,20 @@ declare type PremultiplyAlpha = "default" | "none" | "premultiply";
*
* @category Canvas
*/
declare type ResizeQuality = "high" | "low" | "medium" | "pixelated";
type ResizeQuality = "high" | "low" | "medium" | "pixelated";
/**
* The `ImageBitmapSource` type represents an image data source that can be
* used to create an `ImageBitmap`.
*
* @category Canvas */
declare type ImageBitmapSource = Blob | ImageData;
type ImageBitmapSource = Blob | ImageData;
/**
* The options of {@linkcode createImageBitmap}.
*
* @category Canvas */
declare interface ImageBitmapOptions {
interface ImageBitmapOptions {
/**
* Specifies whether the image should be decoded using color space
* conversion. Either none or default (default). The value default
@ -116,7 +116,7 @@ declare function createImageBitmap(
*
* @category Canvas
*/
declare interface ImageBitmap {
interface ImageBitmap {
/**
* The height of the bitmap.
*/

2
ext/console/lib.deno_console.d.ts vendored
View file

@ -6,7 +6,7 @@
/// <reference lib="esnext" />
/** @category I/O */
declare interface Console {
interface Console {
assert(condition?: boolean, ...data: any[]): void;
clear(): void;
count(label?: string): void;

75
ext/crypto/lib.deno_crypto.d.ts vendored
View file

@ -9,23 +9,23 @@
declare var crypto: Crypto;
/** @category Crypto */
declare interface Algorithm {
interface Algorithm {
name: string;
}
/** @category Crypto */
declare interface KeyAlgorithm {
interface KeyAlgorithm {
name: string;
}
/** @category Crypto */
declare type AlgorithmIdentifier = string | Algorithm;
type AlgorithmIdentifier = string | Algorithm;
/** @category Crypto */
declare type HashAlgorithmIdentifier = AlgorithmIdentifier;
type HashAlgorithmIdentifier = AlgorithmIdentifier;
/** @category Crypto */
declare type KeyType = "private" | "public" | "secret";
type KeyType = "private" | "public" | "secret";
/** @category Crypto */
declare type KeyUsage =
type KeyUsage =
| "decrypt"
| "deriveBits"
| "deriveKey"
@ -35,19 +35,19 @@ declare type KeyUsage =
| "verify"
| "wrapKey";
/** @category Crypto */
declare type KeyFormat = "jwk" | "pkcs8" | "raw" | "spki";
type KeyFormat = "jwk" | "pkcs8" | "raw" | "spki";
/** @category Crypto */
declare type NamedCurve = string;
type NamedCurve = string;
/** @category Crypto */
declare interface RsaOtherPrimesInfo {
interface RsaOtherPrimesInfo {
d?: string;
r?: string;
t?: string;
}
/** @category Crypto */
declare interface JsonWebKey {
interface JsonWebKey {
alg?: string;
crv?: string;
d?: string;
@ -56,6 +56,7 @@ declare interface JsonWebKey {
e?: string;
ext?: boolean;
k?: string;
// deno-lint-ignore camelcase
key_ops?: string[];
kty?: string;
n?: string;
@ -69,129 +70,129 @@ declare interface JsonWebKey {
}
/** @category Crypto */
declare interface AesCbcParams extends Algorithm {
interface AesCbcParams extends Algorithm {
iv: BufferSource;
}
/** @category Crypto */
declare interface AesGcmParams extends Algorithm {
interface AesGcmParams extends Algorithm {
iv: BufferSource;
additionalData?: BufferSource;
tagLength?: number;
}
/** @category Crypto */
declare interface AesCtrParams extends Algorithm {
interface AesCtrParams extends Algorithm {
counter: BufferSource;
length: number;
}
/** @category Crypto */
declare interface HmacKeyGenParams extends Algorithm {
interface HmacKeyGenParams extends Algorithm {
hash: HashAlgorithmIdentifier;
length?: number;
}
/** @category Crypto */
declare interface EcKeyGenParams extends Algorithm {
interface EcKeyGenParams extends Algorithm {
namedCurve: NamedCurve;
}
/** @category Crypto */
declare interface EcKeyImportParams extends Algorithm {
interface EcKeyImportParams extends Algorithm {
namedCurve: NamedCurve;
}
/** @category Crypto */
declare interface EcdsaParams extends Algorithm {
interface EcdsaParams extends Algorithm {
hash: HashAlgorithmIdentifier;
}
/** @category Crypto */
declare interface RsaHashedImportParams extends Algorithm {
interface RsaHashedImportParams extends Algorithm {
hash: HashAlgorithmIdentifier;
}
/** @category Crypto */
declare interface RsaHashedKeyGenParams extends RsaKeyGenParams {
interface RsaHashedKeyGenParams extends RsaKeyGenParams {
hash: HashAlgorithmIdentifier;
}
/** @category Crypto */
declare interface RsaKeyGenParams extends Algorithm {
interface RsaKeyGenParams extends Algorithm {
modulusLength: number;
publicExponent: Uint8Array;
}
/** @category Crypto */
declare interface RsaPssParams extends Algorithm {
interface RsaPssParams extends Algorithm {
saltLength: number;
}
/** @category Crypto */
declare interface RsaOaepParams extends Algorithm {
interface RsaOaepParams extends Algorithm {
label?: Uint8Array;
}
/** @category Crypto */
declare interface HmacImportParams extends Algorithm {
interface HmacImportParams extends Algorithm {
hash: HashAlgorithmIdentifier;
length?: number;
}
/** @category Crypto */
declare interface EcKeyAlgorithm extends KeyAlgorithm {
interface EcKeyAlgorithm extends KeyAlgorithm {
namedCurve: NamedCurve;
}
/** @category Crypto */
declare interface HmacKeyAlgorithm extends KeyAlgorithm {
interface HmacKeyAlgorithm extends KeyAlgorithm {
hash: KeyAlgorithm;
length: number;
}
/** @category Crypto */
declare interface RsaHashedKeyAlgorithm extends RsaKeyAlgorithm {
interface RsaHashedKeyAlgorithm extends RsaKeyAlgorithm {
hash: KeyAlgorithm;
}
/** @category Crypto */
declare interface RsaKeyAlgorithm extends KeyAlgorithm {
interface RsaKeyAlgorithm extends KeyAlgorithm {
modulusLength: number;
publicExponent: Uint8Array;
}
/** @category Crypto */
declare interface HkdfParams extends Algorithm {
interface HkdfParams extends Algorithm {
hash: HashAlgorithmIdentifier;
info: BufferSource;
salt: BufferSource;
}
/** @category Crypto */
declare interface Pbkdf2Params extends Algorithm {
interface Pbkdf2Params extends Algorithm {
hash: HashAlgorithmIdentifier;
iterations: number;
salt: BufferSource;
}
/** @category Crypto */
declare interface AesDerivedKeyParams extends Algorithm {
interface AesDerivedKeyParams extends Algorithm {
length: number;
}
/** @category Crypto */
declare interface EcdhKeyDeriveParams extends Algorithm {
interface EcdhKeyDeriveParams extends Algorithm {
public: CryptoKey;
}
/** @category Crypto */
declare interface AesKeyGenParams extends Algorithm {
interface AesKeyGenParams extends Algorithm {
length: number;
}
/** @category Crypto */
declare interface AesKeyAlgorithm extends KeyAlgorithm {
interface AesKeyAlgorithm extends KeyAlgorithm {
length: number;
}
@ -200,7 +201,7 @@ declare interface AesKeyAlgorithm extends KeyAlgorithm {
*
* @category Crypto
*/
declare interface CryptoKey {
interface CryptoKey {
readonly algorithm: KeyAlgorithm;
readonly extractable: boolean;
readonly type: KeyType;
@ -218,7 +219,7 @@ declare var CryptoKey: {
*
* @category Crypto
*/
declare interface CryptoKeyPair {
interface CryptoKeyPair {
privateKey: CryptoKey;
publicKey: CryptoKey;
}
@ -235,7 +236,7 @@ declare var CryptoKeyPair: {
*
* @category Crypto
*/
declare interface SubtleCrypto {
interface SubtleCrypto {
generateKey(
algorithm: RsaHashedKeyGenParams | EcKeyGenParams,
extractable: boolean,
@ -374,7 +375,7 @@ declare var SubtleCrypto: {
};
/** @category Crypto */
declare interface Crypto {
interface Crypto {
readonly subtle: SubtleCrypto;
getRandomValues<
T extends

44
ext/fetch/lib.deno_fetch.d.ts vendored
View file

@ -6,7 +6,7 @@
/// <reference lib="esnext" />
/** @category Platform */
declare interface DomIterable<K, V> {
interface DomIterable<K, V> {
keys(): IterableIterator<K>;
values(): IterableIterator<V>;
entries(): IterableIterator<[K, V]>;
@ -18,7 +18,7 @@ declare interface DomIterable<K, V> {
}
/** @category Fetch */
declare type FormDataEntryValue = File | string;
type FormDataEntryValue = File | string;
/** Provides a way to easily construct a set of key/value pairs representing
* form fields and their values, which can then be easily sent using the
@ -27,7 +27,7 @@ declare type FormDataEntryValue = File | string;
*
* @category Fetch
*/
declare interface FormData extends DomIterable<string, FormDataEntryValue> {
interface FormData extends DomIterable<string, FormDataEntryValue> {
append(name: string, value: string | Blob, fileName?: string): void;
delete(name: string): void;
get(name: string): FormDataEntryValue | null;
@ -43,7 +43,7 @@ declare var FormData: {
};
/** @category Fetch */
declare interface Body {
interface Body {
/** A simple getter used to expose a `ReadableStream` of the body contents. */
readonly body: ReadableStream<Uint8Array> | null;
/** Stores a `Boolean` that declares whether the body has been used in a
@ -77,7 +77,7 @@ declare interface Body {
}
/** @category Fetch */
declare type HeadersInit = Iterable<string[]> | Record<string, string>;
type HeadersInit = Iterable<string[]> | Record<string, string>;
/** This Fetch API interface allows you to perform various actions on HTTP
* request and response headers. These actions include retrieving, setting,
@ -89,7 +89,7 @@ declare type HeadersInit = Iterable<string[]> | Record<string, string>;
*
* @category Fetch
*/
declare interface Headers extends DomIterable<string, string> {
interface Headers extends DomIterable<string, string> {
/** Appends a new value onto an existing header inside a `Headers` object, or
* adds the header if it does not already exist.
*/
@ -130,9 +130,9 @@ declare var Headers: {
};
/** @category Fetch */
declare type RequestInfo = Request | string;
type RequestInfo = Request | string;
/** @category Fetch */
declare type RequestCache =
type RequestCache =
| "default"
| "force-cache"
| "no-cache"
@ -140,13 +140,13 @@ declare type RequestCache =
| "only-if-cached"
| "reload";
/** @category Fetch */
declare type RequestCredentials = "include" | "omit" | "same-origin";
type RequestCredentials = "include" | "omit" | "same-origin";
/** @category Fetch */
declare type RequestMode = "cors" | "navigate" | "no-cors" | "same-origin";
type RequestMode = "cors" | "navigate" | "no-cors" | "same-origin";
/** @category Fetch */
declare type RequestRedirect = "error" | "follow" | "manual";
type RequestRedirect = "error" | "follow" | "manual";
/** @category Fetch */
declare type ReferrerPolicy =
type ReferrerPolicy =
| ""
| "no-referrer"
| "no-referrer-when-downgrade"
@ -157,7 +157,7 @@ declare type ReferrerPolicy =
| "strict-origin-when-cross-origin"
| "unsafe-url";
/** @category Fetch */
declare type BodyInit =
type BodyInit =
| Blob
| BufferSource
| FormData
@ -165,7 +165,7 @@ declare type BodyInit =
| ReadableStream<Uint8Array>
| string;
/** @category Fetch */
declare type RequestDestination =
type RequestDestination =
| ""
| "audio"
| "audioworklet"
@ -186,7 +186,7 @@ declare type RequestDestination =
| "xslt";
/** @category Fetch */
declare interface RequestInit {
interface RequestInit {
/**
* A BodyInit object or null to set request's body.
*/
@ -254,7 +254,7 @@ declare interface RequestInit {
*
* @category Fetch
*/
declare interface Request extends Body {
interface Request extends Body {
/**
* Returns the cache mode associated with request, which is a string
* indicating how the request will interact with the browser's cache when
@ -350,14 +350,14 @@ declare var Request: {
};
/** @category Fetch */
declare interface ResponseInit {
interface ResponseInit {
headers?: HeadersInit;
status?: number;
statusText?: string;
}
/** @category Fetch */
declare type ResponseType =
type ResponseType =
| "basic"
| "cors"
| "default"
@ -369,7 +369,7 @@ declare type ResponseType =
*
* @category Fetch
*/
declare interface Response extends Body {
interface Response extends Body {
readonly headers: Headers;
readonly ok: boolean;
readonly redirected: boolean;
@ -413,14 +413,14 @@ declare function fetch(
/**
* @category Fetch
*/
declare interface EventSourceInit {
interface EventSourceInit {
withCredentials?: boolean;
}
/**
* @category Fetch
*/
declare interface EventSourceEventMap {
interface EventSourceEventMap {
"error": Event;
"message": MessageEvent;
"open": Event;
@ -429,7 +429,7 @@ declare interface EventSourceEventMap {
/**
* @category Fetch
*/
declare interface EventSource extends EventTarget {
interface EventSource extends EventTarget {
onerror: ((this: EventSource, ev: Event) => any) | null;
onmessage: ((this: EventSource, ev: MessageEvent) => any) | null;
onopen: ((this: EventSource, ev: Event) => any) | null;

2
ext/net/lib.deno_net.d.ts vendored
View file

@ -449,4 +449,6 @@ declare namespace Deno {
conn: TcpConn,
options?: StartTlsOptions,
): Promise<TlsConn>;
export {}; // only export exports
}

16
ext/url/lib.deno_url.d.ts vendored
View file

@ -6,7 +6,7 @@
/// <reference lib="esnext" />
/** @category URL */
declare interface URLSearchParams {
interface URLSearchParams {
/** Appends a specified key/value pair as a new search parameter.
*
* ```ts
@ -170,7 +170,7 @@ declare var URLSearchParams: {
*
* @category URL
*/
declare interface URL {
interface URL {
hash: string;
host: string;
hostname: string;
@ -202,7 +202,7 @@ declare var URL: {
};
/** @category URL */
declare interface URLPatternInit {
interface URLPatternInit {
protocol?: string;
username?: string;
password?: string;
@ -215,10 +215,10 @@ declare interface URLPatternInit {
}
/** @category URL */
declare type URLPatternInput = string | URLPatternInit;
type URLPatternInput = string | URLPatternInit;
/** @category URL */
declare interface URLPatternComponentResult {
interface URLPatternComponentResult {
input: string;
groups: Record<string, string | undefined>;
}
@ -227,7 +227,7 @@ declare interface URLPatternComponentResult {
*
* @category URL
*/
declare interface URLPatternResult {
interface URLPatternResult {
/** The inputs provided when matching. */
inputs: [URLPatternInit] | [URLPatternInit, string];
@ -254,7 +254,7 @@ declare interface URLPatternResult {
*
* @category URL
*/
declare interface URLPatternOptions {
interface URLPatternOptions {
/**
* Enables case-insensitive matching.
*
@ -293,7 +293,7 @@ declare interface URLPatternOptions {
*
* @category URL
*/
declare interface URLPattern {
interface URLPattern {
/**
* Test if the given input matches the stored pattern.
*

7
ext/web/06_streams_types.d.ts vendored
View file

@ -71,5 +71,10 @@ interface ReadableStreamGenericReader<T> {
declare function queueMicrotask(callback: VoidFunction): void;
declare namespace Deno {
function inspect(value: unknown, options?: Record<string, unknown>): string;
export function inspect(
value: unknown,
options?: Record<string, unknown>,
): string;
export {}; // only export exports
}

188
ext/web/lib.deno_web.d.ts vendored
View file

@ -6,7 +6,7 @@
/// <reference lib="esnext" />
/** @category Platform */
declare interface DOMException extends Error {
interface DOMException extends Error {
readonly name: string;
readonly message: string;
/** @deprecated */
@ -70,7 +70,7 @@ declare var DOMException: {
};
/** @category Events */
declare interface EventInit {
interface EventInit {
bubbles?: boolean;
cancelable?: boolean;
composed?: boolean;
@ -80,7 +80,7 @@ declare interface EventInit {
*
* @category Events
*/
declare interface Event {
interface Event {
/** Returns true or false depending on how event was initialized. True if
* event goes through its target's ancestors in reverse tree order, and
* false otherwise. */
@ -163,7 +163,7 @@ declare var Event: {
*
* @category Events
*/
declare interface EventTarget {
interface EventTarget {
/** Appends an event listener for events whose type attribute value is type.
* The callback argument sets the callback that will be invoked when the event
* is dispatched.
@ -217,34 +217,34 @@ declare var EventTarget: {
};
/** @category Events */
declare interface EventListener {
interface EventListener {
(evt: Event): void;
}
/** @category Events */
declare interface EventListenerObject {
interface EventListenerObject {
handleEvent(evt: Event): void;
}
/** @category Events */
declare type EventListenerOrEventListenerObject =
type EventListenerOrEventListenerObject =
| EventListener
| EventListenerObject;
/** @category Events */
declare interface AddEventListenerOptions extends EventListenerOptions {
interface AddEventListenerOptions extends EventListenerOptions {
once?: boolean;
passive?: boolean;
signal?: AbortSignal;
}
/** @category Events */
declare interface EventListenerOptions {
interface EventListenerOptions {
capture?: boolean;
}
/** @category Events */
declare interface ProgressEventInit extends EventInit {
interface ProgressEventInit extends EventInit {
lengthComputable?: boolean;
loaded?: number;
total?: number;
@ -256,8 +256,7 @@ declare interface ProgressEventInit extends EventInit {
*
* @category Events
*/
declare interface ProgressEvent<T extends EventTarget = EventTarget>
extends Event {
interface ProgressEvent<T extends EventTarget = EventTarget> extends Event {
readonly lengthComputable: boolean;
readonly loaded: number;
readonly target: T | null;
@ -296,13 +295,13 @@ declare function atob(s: string): string;
declare function btoa(s: string): string;
/** @category Encoding */
declare interface TextDecoderOptions {
interface TextDecoderOptions {
fatal?: boolean;
ignoreBOM?: boolean;
}
/** @category Encoding */
declare interface TextDecodeOptions {
interface TextDecodeOptions {
stream?: boolean;
}
@ -320,7 +319,7 @@ declare interface TextDecodeOptions {
*
* @category Encoding
*/
declare interface TextDecoder extends TextDecoderCommon {
interface TextDecoder extends TextDecoderCommon {
/** Turns binary data, often in the form of a Uint8Array, into a string given
* the encoding.
*/
@ -334,7 +333,7 @@ declare var TextDecoder: {
};
/** @category Encoding */
declare interface TextDecoderCommon {
interface TextDecoderCommon {
/** Returns encoding's name, lowercased. */
readonly encoding: string;
/** Returns true if error mode is "fatal", otherwise false. */
@ -344,13 +343,13 @@ declare interface TextDecoderCommon {
}
/** @category Encoding */
declare interface TextEncoderEncodeIntoResult {
interface TextEncoderEncodeIntoResult {
read: number;
written: number;
}
/** @category Encoding */
declare interface TextEncoder extends TextEncoderCommon {
interface TextEncoder extends TextEncoderCommon {
/** Returns the result of running UTF-8's encoder. */
encode(input?: string): Uint8Array;
encodeInto(input: string, dest: Uint8Array): TextEncoderEncodeIntoResult;
@ -369,7 +368,7 @@ declare interface TextEncoder extends TextEncoderCommon {
*
* @category Encoding
*/
declare interface TextEncoder extends TextEncoderCommon {
interface TextEncoder extends TextEncoderCommon {
/** Turns a string into binary data (in the form of a Uint8Array) using UTF-8 encoding. */
encode(input?: string): Uint8Array;
@ -384,14 +383,13 @@ declare var TextEncoder: {
};
/** @category Encoding */
declare interface TextEncoderCommon {
interface TextEncoderCommon {
/** Returns "utf-8". */
readonly encoding: string;
}
/** @category Encoding */
declare interface TextDecoderStream
extends GenericTransformStream, TextDecoderCommon {
interface TextDecoderStream extends GenericTransformStream, TextDecoderCommon {
readonly readable: ReadableStream<string>;
readonly writable: WritableStream<BufferSource>;
}
@ -403,8 +401,7 @@ declare var TextDecoderStream: {
};
/** @category Encoding */
declare interface TextEncoderStream
extends GenericTransformStream, TextEncoderCommon {
interface TextEncoderStream extends GenericTransformStream, TextEncoderCommon {
readonly readable: ReadableStream<Uint8Array>;
readonly writable: WritableStream<string>;
}
@ -420,7 +417,7 @@ declare var TextEncoderStream: {
*
* @category Platform
*/
declare interface AbortController {
interface AbortController {
/** Returns the AbortSignal object associated with this object. */
readonly signal: AbortSignal;
/** Invoking this method will set this object's AbortSignal's aborted flag and
@ -439,7 +436,7 @@ declare var AbortController: {
};
/** @category Platform */
declare interface AbortSignalEventMap {
interface AbortSignalEventMap {
abort: Event;
}
@ -448,7 +445,7 @@ declare interface AbortSignalEventMap {
*
* @category Platform
*/
declare interface AbortSignal extends EventTarget {
interface AbortSignal extends EventTarget {
/** Returns true if this AbortSignal's AbortController has signaled to abort,
* and false otherwise. */
readonly aborted: boolean;
@ -490,7 +487,7 @@ declare var AbortSignal: {
};
/** @category File */
declare interface FileReaderEventMap {
interface FileReaderEventMap {
"abort": ProgressEvent<FileReader>;
"error": ProgressEvent<FileReader>;
"load": ProgressEvent<FileReader>;
@ -505,7 +502,7 @@ declare interface FileReaderEventMap {
*
* @category File
*/
declare interface FileReader extends EventTarget {
interface FileReader extends EventTarget {
readonly error: DOMException | null;
onabort: ((this: FileReader, ev: ProgressEvent<FileReader>) => any) | null;
onerror: ((this: FileReader, ev: ProgressEvent<FileReader>) => any) | null;
@ -561,13 +558,13 @@ declare var FileReader: {
};
/** @category File */
declare type BlobPart = BufferSource | Blob | string;
type BlobPart = BufferSource | Blob | string;
/** @category File */
declare type EndingType = "transparent" | "native";
type EndingType = "transparent" | "native";
/** @category File */
declare interface BlobPropertyBag {
interface BlobPropertyBag {
type?: string;
endings?: EndingType;
}
@ -579,7 +576,7 @@ declare interface BlobPropertyBag {
*
* @category File
*/
declare interface Blob {
interface Blob {
readonly size: number;
readonly type: string;
arrayBuffer(): Promise<ArrayBuffer>;
@ -602,7 +599,7 @@ declare var Blob: {
};
/** @category File */
declare interface FilePropertyBag extends BlobPropertyBag {
interface FilePropertyBag extends BlobPropertyBag {
lastModified?: number;
}
@ -611,7 +608,7 @@ declare interface FilePropertyBag extends BlobPropertyBag {
*
* @category File
*/
declare interface File extends Blob {
interface File extends Blob {
readonly lastModified: number;
readonly name: string;
readonly webkitRelativePath: string;
@ -628,40 +625,40 @@ declare var File: {
};
/** @category Streams */
declare type ReadableStreamReader<T> =
type ReadableStreamReader<T> =
| ReadableStreamDefaultReader<T>
| ReadableStreamBYOBReader;
/** @category Streams */
declare type ReadableStreamController<T> =
type ReadableStreamController<T> =
| ReadableStreamDefaultController<T>
| ReadableByteStreamController;
/** @category Streams */
declare interface ReadableStreamGenericReader {
interface ReadableStreamGenericReader {
readonly closed: Promise<undefined>;
cancel(reason?: any): Promise<void>;
}
/** @category Streams */
declare interface ReadableStreamReadDoneResult<T> {
interface ReadableStreamReadDoneResult<T> {
done: true;
value?: T;
}
/** @category Streams */
declare interface ReadableStreamReadValueResult<T> {
interface ReadableStreamReadValueResult<T> {
done: false;
value: T;
}
/** @category Streams */
declare type ReadableStreamReadResult<T> =
type ReadableStreamReadResult<T> =
| ReadableStreamReadValueResult<T>
| ReadableStreamReadDoneResult<T>;
/** @category Streams */
declare interface ReadableStreamDefaultReader<R = any>
interface ReadableStreamDefaultReader<R = any>
extends ReadableStreamGenericReader {
read(): Promise<ReadableStreamReadResult<R>>;
releaseLock(): void;
@ -674,12 +671,12 @@ declare var ReadableStreamDefaultReader: {
};
/** @category Streams */
declare interface ReadableStreamBYOBReaderReadOptions {
interface ReadableStreamBYOBReaderReadOptions {
min?: number;
}
/** @category Streams */
declare interface ReadableStreamBYOBReader extends ReadableStreamGenericReader {
interface ReadableStreamBYOBReader extends ReadableStreamGenericReader {
read<T extends ArrayBufferView>(
view: T,
options?: ReadableStreamBYOBReaderReadOptions,
@ -694,7 +691,7 @@ declare var ReadableStreamBYOBReader: {
};
/** @category Streams */
declare interface ReadableStreamBYOBRequest {
interface ReadableStreamBYOBRequest {
readonly view: ArrayBufferView | null;
respond(bytesWritten: number): void;
respondWithNewView(view: ArrayBufferView): void;
@ -707,7 +704,7 @@ declare var ReadableStreamBYOBRequest: {
};
/** @category Streams */
declare interface UnderlyingByteSource {
interface UnderlyingByteSource {
autoAllocateChunkSize?: number;
cancel?: UnderlyingSourceCancelCallback;
pull?: (controller: ReadableByteStreamController) => void | PromiseLike<void>;
@ -716,7 +713,7 @@ declare interface UnderlyingByteSource {
}
/** @category Streams */
declare interface UnderlyingDefaultSource<R = any> {
interface UnderlyingDefaultSource<R = any> {
cancel?: UnderlyingSourceCancelCallback;
pull?: (
controller: ReadableStreamDefaultController<R>,
@ -726,7 +723,7 @@ declare interface UnderlyingDefaultSource<R = any> {
}
/** @category Streams */
declare interface UnderlyingSink<W = any> {
interface UnderlyingSink<W = any> {
abort?: UnderlyingSinkAbortCallback;
close?: UnderlyingSinkCloseCallback;
start?: UnderlyingSinkStartCallback;
@ -735,10 +732,10 @@ declare interface UnderlyingSink<W = any> {
}
/** @category Streams */
declare type ReadableStreamType = "bytes";
type ReadableStreamType = "bytes";
/** @category Streams */
declare interface UnderlyingSource<R = any> {
interface UnderlyingSource<R = any> {
autoAllocateChunkSize?: number;
cancel?: UnderlyingSourceCancelCallback;
pull?: UnderlyingSourcePullCallback<R>;
@ -747,22 +744,22 @@ declare interface UnderlyingSource<R = any> {
}
/** @category Streams */
declare interface UnderlyingSourceCancelCallback {
interface UnderlyingSourceCancelCallback {
(reason?: any): void | PromiseLike<void>;
}
/** @category Streams */
declare interface UnderlyingSourcePullCallback<R> {
interface UnderlyingSourcePullCallback<R> {
(controller: ReadableStreamController<R>): void | PromiseLike<void>;
}
/** @category Streams */
declare interface UnderlyingSourceStartCallback<R> {
interface UnderlyingSourceStartCallback<R> {
(controller: ReadableStreamController<R>): any;
}
/** @category Streams */
declare interface ReadableStreamDefaultController<R = any> {
interface ReadableStreamDefaultController<R = any> {
readonly desiredSize: number | null;
close(): void;
enqueue(chunk?: R): void;
@ -776,7 +773,7 @@ declare var ReadableStreamDefaultController: {
};
/** @category Streams */
declare interface ReadableByteStreamController {
interface ReadableByteStreamController {
readonly byobRequest: ReadableStreamBYOBRequest | null;
readonly desiredSize: number | null;
close(): void;
@ -791,7 +788,7 @@ declare var ReadableByteStreamController: {
};
/** @category Streams */
declare interface StreamPipeOptions {
interface StreamPipeOptions {
preventAbort?: boolean;
preventCancel?: boolean;
preventClose?: boolean;
@ -799,12 +796,12 @@ declare interface StreamPipeOptions {
}
/** @category Streams */
declare interface QueuingStrategySize<T = any> {
interface QueuingStrategySize<T = any> {
(chunk: T): number;
}
/** @category Streams */
declare interface QueuingStrategy<T = any> {
interface QueuingStrategy<T = any> {
highWaterMark?: number;
size?: QueuingStrategySize<T>;
}
@ -814,7 +811,7 @@ declare interface QueuingStrategy<T = any> {
*
* @category Streams
*/
declare interface CountQueuingStrategy extends QueuingStrategy {
interface CountQueuingStrategy extends QueuingStrategy {
readonly highWaterMark: number;
readonly size: QueuingStrategySize;
}
@ -826,8 +823,7 @@ declare var CountQueuingStrategy: {
};
/** @category Streams */
declare interface ByteLengthQueuingStrategy
extends QueuingStrategy<ArrayBufferView> {
interface ByteLengthQueuingStrategy extends QueuingStrategy<ArrayBufferView> {
readonly highWaterMark: number;
readonly size: QueuingStrategySize<ArrayBufferView>;
}
@ -839,7 +835,7 @@ declare var ByteLengthQueuingStrategy: {
};
/** @category Streams */
declare interface QueuingStrategyInit {
interface QueuingStrategyInit {
highWaterMark: number;
}
@ -849,7 +845,7 @@ declare interface QueuingStrategyInit {
*
* @category Streams
*/
declare interface ReadableStream<R = any> {
interface ReadableStream<R = any> {
readonly locked: boolean;
cancel(reason?: any): Promise<void>;
getReader(options: { mode: "byob" }): ReadableStreamBYOBReader;
@ -891,36 +887,36 @@ declare var ReadableStream: {
};
/** @category Streams */
declare interface ReadableStreamIteratorOptions {
interface ReadableStreamIteratorOptions {
preventCancel?: boolean;
}
/** @category Streams */
declare type ReadableStreamReaderMode = "byob";
type ReadableStreamReaderMode = "byob";
/** @category Streams */
declare interface ReadableStreamGetReaderOptions {
interface ReadableStreamGetReaderOptions {
mode?: ReadableStreamReaderMode;
}
/** @category Streams */
declare interface ReadableWritablePair<R = any, W = any> {
interface ReadableWritablePair<R = any, W = any> {
readable: ReadableStream<R>;
writable: WritableStream<W>;
}
/** @category Streams */
declare interface UnderlyingSinkCloseCallback {
interface UnderlyingSinkCloseCallback {
(): void | PromiseLike<void>;
}
/** @category Streams */
declare interface UnderlyingSinkStartCallback {
interface UnderlyingSinkStartCallback {
(controller: WritableStreamDefaultController): any;
}
/** @category Streams */
declare interface UnderlyingSinkWriteCallback<W> {
interface UnderlyingSinkWriteCallback<W> {
(
chunk: W,
controller: WritableStreamDefaultController,
@ -928,7 +924,7 @@ declare interface UnderlyingSinkWriteCallback<W> {
}
/** @category Streams */
declare interface UnderlyingSinkAbortCallback {
interface UnderlyingSinkAbortCallback {
(reason?: any): void | PromiseLike<void>;
}
@ -938,7 +934,7 @@ declare interface UnderlyingSinkAbortCallback {
*
* @category Streams
*/
declare interface WritableStream<W = any> {
interface WritableStream<W = any> {
readonly locked: boolean;
abort(reason?: any): Promise<void>;
close(): Promise<void>;
@ -961,7 +957,7 @@ declare var WritableStream: {
*
* @category Streams
*/
declare interface WritableStreamDefaultController {
interface WritableStreamDefaultController {
readonly signal: AbortSignal;
error(e?: any): void;
}
@ -979,7 +975,7 @@ declare var WritableStreamDefaultController: {
*
* @category Streams
*/
declare interface WritableStreamDefaultWriter<W = any> {
interface WritableStreamDefaultWriter<W = any> {
readonly closed: Promise<undefined>;
readonly desiredSize: number | null;
readonly ready: Promise<undefined>;
@ -996,7 +992,7 @@ declare var WritableStreamDefaultWriter: {
};
/** @category Streams */
declare interface TransformStream<I = any, O = any> {
interface TransformStream<I = any, O = any> {
readonly readable: ReadableStream<O>;
readonly writable: WritableStream<I>;
}
@ -1012,7 +1008,7 @@ declare var TransformStream: {
};
/** @category Streams */
declare interface TransformStreamDefaultController<O = any> {
interface TransformStreamDefaultController<O = any> {
readonly desiredSize: number | null;
enqueue(chunk?: O): void;
error(reason?: any): void;
@ -1026,7 +1022,7 @@ declare var TransformStreamDefaultController: {
};
/** @category Streams */
declare interface Transformer<I = any, O = any> {
interface Transformer<I = any, O = any> {
flush?: TransformerFlushCallback<O>;
readableType?: undefined;
start?: TransformerStartCallback<O>;
@ -1036,17 +1032,17 @@ declare interface Transformer<I = any, O = any> {
}
/** @category Streams */
declare interface TransformerFlushCallback<O> {
interface TransformerFlushCallback<O> {
(controller: TransformStreamDefaultController<O>): void | PromiseLike<void>;
}
/** @category Streams */
declare interface TransformerStartCallback<O> {
interface TransformerStartCallback<O> {
(controller: TransformStreamDefaultController<O>): any;
}
/** @category Streams */
declare interface TransformerTransformCallback<I, O> {
interface TransformerTransformCallback<I, O> {
(
chunk: I,
controller: TransformStreamDefaultController<O>,
@ -1054,21 +1050,21 @@ declare interface TransformerTransformCallback<I, O> {
}
/** @category Streams */
declare interface TransformerCancelCallback {
interface TransformerCancelCallback {
(reason: any): void | PromiseLike<void>;
}
/** @category Streams */
declare interface GenericTransformStream {
interface GenericTransformStream {
readonly readable: ReadableStream;
readonly writable: WritableStream;
}
/** @category Events */
declare type MessageEventSource = Window | MessagePort;
type MessageEventSource = Window | MessagePort;
/** @category Events */
declare interface MessageEventInit<T = any> extends EventInit {
interface MessageEventInit<T = any> extends EventInit {
data?: T;
lastEventId?: string;
origin?: string;
@ -1077,7 +1073,7 @@ declare interface MessageEventInit<T = any> extends EventInit {
}
/** @category Events */
declare interface MessageEvent<T = any> extends Event {
interface MessageEvent<T = any> extends Event {
/**
* Returns the data of the message.
*/
@ -1115,10 +1111,10 @@ declare var MessageEvent: {
};
/** @category Events */
declare type Transferable = MessagePort | ArrayBuffer;
type Transferable = MessagePort | ArrayBuffer;
/** @category Platform */
declare interface StructuredSerializeOptions {
interface StructuredSerializeOptions {
transfer?: Transferable[];
}
@ -1128,7 +1124,7 @@ declare interface StructuredSerializeOptions {
*
* @category Messaging
*/
declare interface MessageChannel {
interface MessageChannel {
readonly port1: MessagePort;
readonly port2: MessagePort;
}
@ -1145,7 +1141,7 @@ declare var MessageChannel: {
};
/** @category Messaging */
declare interface MessagePortEventMap {
interface MessagePortEventMap {
"message": MessageEvent;
"messageerror": MessageEvent;
}
@ -1156,7 +1152,7 @@ declare interface MessagePortEventMap {
*
* @category Messaging
*/
declare interface MessagePort extends EventTarget {
interface MessagePort extends EventTarget {
onmessage: ((this: MessagePort, ev: MessageEvent) => any) | null;
onmessageerror: ((this: MessagePort, ev: MessageEvent) => any) | null;
/**
@ -1255,13 +1251,13 @@ declare function structuredClone<T = any>(
*
* @category Streams
*/
declare interface CompressionStream extends GenericTransformStream {
interface CompressionStream extends GenericTransformStream {
readonly readable: ReadableStream<Uint8Array>;
readonly writable: WritableStream<BufferSource>;
}
/** @category Streams */
declare type CompressionFormat = "deflate" | "deflate-raw" | "gzip";
type CompressionFormat = "deflate" | "deflate-raw" | "gzip";
/**
* An API for compressing a stream of data.
@ -1302,7 +1298,7 @@ declare var CompressionStream: {
*
* @category Streams
*/
declare interface DecompressionStream extends GenericTransformStream {
interface DecompressionStream extends GenericTransformStream {
readonly readable: ReadableStream<Uint8Array>;
readonly writable: WritableStream<BufferSource>;
}
@ -1356,15 +1352,15 @@ declare function reportError(
): void;
/** @category Platform */
declare type PredefinedColorSpace = "srgb" | "display-p3";
type PredefinedColorSpace = "srgb" | "display-p3";
/** @category Platform */
declare interface ImageDataSettings {
interface ImageDataSettings {
readonly colorSpace?: PredefinedColorSpace;
}
/** @category Platform */
declare interface ImageData {
interface ImageData {
readonly colorSpace: PredefinedColorSpace;
readonly data: Uint8ClampedArray;
readonly height: number;

10
ext/websocket/lib.deno_websocket.d.ts vendored
View file

@ -6,14 +6,14 @@
/// <reference lib="esnext" />
/** @category WebSockets */
declare interface CloseEventInit extends EventInit {
interface CloseEventInit extends EventInit {
code?: number;
reason?: string;
wasClean?: boolean;
}
/** @category WebSockets */
declare interface CloseEvent extends Event {
interface CloseEvent extends Event {
/**
* Returns the WebSocket connection close code provided by the server.
*/
@ -35,7 +35,7 @@ declare var CloseEvent: {
};
/** @category WebSockets */
declare interface WebSocketEventMap {
interface WebSocketEventMap {
close: CloseEvent;
error: Event;
message: MessageEvent;
@ -52,7 +52,7 @@ declare interface WebSocketEventMap {
* @tags allow-net
* @category WebSockets
*/
declare interface WebSocket extends EventTarget {
interface WebSocket extends EventTarget {
/**
* Returns a string that indicates how binary data from the WebSocket object is exposed to scripts:
*
@ -130,4 +130,4 @@ declare var WebSocket: {
};
/** @category WebSockets */
declare type BinaryType = "arraybuffer" | "blob";
type BinaryType = "arraybuffer" | "blob";

2
ext/webstorage/lib.deno_webstorage.d.ts vendored
View file

@ -11,7 +11,7 @@
*
* @category Storage
*/
declare interface Storage {
interface Storage {
/**
* Returns the number of key/value pairs currently present in the list associated with the object.
*/

100
tools/generate_types_deno.ts Executable file
View file

@ -0,0 +1,100 @@
#!/usr/bin/env -S deno run -A
// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
// This script is used to generate the @types/deno package on DefinitelyTyped.
import $ from "jsr:@david/dax@0.42.0";
import { Node, Project } from "jsr:@ts-morph/ts-morph@23.0.0";
import * as semver from "jsr:@std/semver@1.0.3";
const rootDir = $.path(import.meta.dirname!).parentOrThrow();
const definitelyTypedDir = rootDir.join(
"../DefinitelyTyped/types/deno/",
);
if (!definitelyTypedDir.existsSync()) {
throw new Error(`Makes sure ${definitelyTypedDir} exists.`);
}
const denoExec = rootDir.join(
"target/debug/deno" + (Deno.build.os === "windows" ? ".exe" : ""),
);
$.logStep("Building Deno executable...");
await $`cargo build`;
$.logStep("Creating declaration file...");
await createDenoDtsFile();
$.logStep("Updating package.json...");
await updatePkgJson();
$.logStep("Formatting...");
await $`pnpm dprint fmt`.cwd(definitelyTypedDir);
async function createDenoDtsFile() {
function matchesAny(text: string | undefined, patterns: string[]): boolean {
if (text == null) {
return false;
}
for (const pattern of patterns) {
if (text.includes(pattern)) {
return true;
}
}
return false;
}
const text = await $`${denoExec} types`.text();
const project = new Project();
const file = project.createSourceFile(
definitelyTypedDir.join("index.d.ts").toString(),
text,
{
overwrite: true,
},
);
for (const statement of file.getStatementsWithComments()) {
if (Node.isCommentStatement(statement)) {
const statementText = statement.getText();
if (statementText.includes("<reference")) {
statement.remove();
continue;
}
}
const shouldKeepKeep = (Node.isModuleDeclaration(statement) ||
Node.isInterfaceDeclaration(statement) ||
Node.isTypeAliasDeclaration(statement) ||
Node.isClassDeclaration(statement)) &&
(matchesAny(statement.getName(), [
"Deno",
]) || statement.getName()?.startsWith("GPU"));
if (!shouldKeepKeep) {
statement.remove();
continue;
}
}
file.insertStatements(
0,
"// Copyright 2018-2024 the Deno authors. MIT license.\n\n",
);
file.saveSync();
}
async function updatePkgJson() {
const pkgJsonFile = definitelyTypedDir.join("package.json");
const obj = pkgJsonFile.readJsonSync();
const version = semver.parse(await getDenoVersion());
version.patch = 9999;
version.prerelease = undefined;
version.build = undefined;
// deno-lint-ignore no-explicit-any
(obj as any).version = semver.format(version);
pkgJsonFile.writeTextSync(JSON.stringify(obj, undefined, 4) + "\n"); // 4 spaces indent
}
async function getDenoVersion() {
const text = await $`${denoExec} -v`.text();
return text.match(/deno (.*)/)![1];
}

26
tools/jsdoc_checker.js
View file

@ -45,33 +45,39 @@ for (const file of project.getSourceFiles()) {
}
const parent = node.getFirstAncestorByKind(ts.SyntaxKind.ModuleDeclaration);
const isInterfaceOrType =
node.getKind() === ts.SyntaxKind.InterfaceDeclaration ||
node.getKind() === ts.SyntaxKind.TypeAliasDeclaration;
if (parent) {
if (!node.isExported()) {
errors.push(getErrorPrefix(node) + "export keyword");
errors.push(getMissingErrorPrefix(node) + "export keyword");
continue;
}
} else if (!node.hasDeclareKeyword()) {
errors.push(getErrorPrefix(node) + "declare keyword");
} else if (!isInterfaceOrType && !node.hasDeclareKeyword()) {
errors.push(getMissingErrorPrefix(node) + "declare keyword");
continue;
} else if (isInterfaceOrType && node.hasDeclareKeyword()) {
errors.push(getErrorPrefix(node) + "has incorrect declare keyword");
continue;
}
const jsDoc = node.getFirstChildIfKind(ts.SyntaxKind.JSDoc);
if (!jsDoc) {
errors.push(getErrorPrefix(node) + "JSDoc comment");
errors.push(getMissingErrorPrefix(node) + "JSDoc comment");
continue;
}
const tags = jsDoc.getTags();
if (!tags.find((tag) => tag.getTagName() === "category")) {
errors.push(getErrorPrefix(node) + "JSDoc @category tag");
errors.push(getMissingErrorPrefix(node) + "JSDoc @category tag");
continue;
}
if (unstableFiles.includes(file)) {
if (!tags.find((tag) => tag.getTagName() === "experimental")) {
errors.push(getErrorPrefix(node) + "JSDoc @experimental tag");
errors.push(getMissingErrorPrefix(node) + "JSDoc @experimental tag");
}
}
}
@ -81,6 +87,10 @@ if (errors.length > 0) {
throw new AggregateError(errors);
}
function getErrorPrefix(node) {
return `Symbol at file://${node.getSourceFile().getFilePath()}:${node.getStartLineNumber()} is missing a `;
function getMissingErrorPrefix(node) {
return getErrorPrefix(node) + `is missing a `;
}
function getErrorPrefix(node) {
return `Symbol at file://${node.getSourceFile().getFilePath()}:${node.getStartLineNumber()} `;
}