2023-02-14 11:38:45 -05:00
|
|
|
// Copyright 2018-2023 the Deno authors. All rights reserved. MIT license.
|
refactor(core): include_js_files! 'dir' option doesn't change specifiers (#18019)
This commit changes "include_js_files!" macro from "deno_core"
in a way that "dir" option doesn't cause specifiers to be rewritten
to include it.
Example:
```
include_js_files! {
dir "js",
"hello.js",
}
```
The above definition required embedders to use:
`import ... from "internal:<ext_name>/js/hello.js"`.
But with this change, the "js" directory in which the files are stored
is an implementation detail, which for embedders results in:
`import ... from "internal:<ext_name>/hello.js"`.
The directory the files are stored in, is an implementation detail and
in some cases might result in a significant size difference for the
snapshot. As an example, in "deno_node" extension, we store the
source code in "polyfills" directory; which resulted in each specifier
to look like "internal:deno_node/polyfills/<module_name>", but with
this change it's "internal:deno_node/<module_name>".
Given that "deno_node" has over 100 files, many of them having
several import specifiers to the same extension, this change removes
10 characters from each import specifier.
2023-03-04 21:31:38 -05:00
|
|
|
import { EventEmitter } from "internal:deno_node/_events.d.ts";
|
|
|
|
import { Buffer } from "internal:deno_node/buffer.ts";
|
2023-02-14 11:38:45 -05:00
|
|
|
|
|
|
|
/** One of:
|
|
|
|
* | "ascii"
|
|
|
|
* | "utf8"
|
|
|
|
* | "utf-8"
|
|
|
|
* | "utf16le"
|
|
|
|
* | "ucs2"
|
|
|
|
* | "ucs-2"
|
|
|
|
* | "base64"
|
|
|
|
* | "base64url"
|
|
|
|
* | "latin1"
|
|
|
|
* | "binary"
|
|
|
|
* | "hex";
|
|
|
|
*/
|
|
|
|
export type BufferEncoding = string;
|
|
|
|
|
|
|
|
export interface Buffered {
|
|
|
|
chunk: Buffer;
|
|
|
|
encoding: string;
|
|
|
|
callback: (err?: Error | null) => void;
|
|
|
|
}
|
|
|
|
|
|
|
|
export interface ErrnoException extends Error {
|
|
|
|
errno?: number | undefined;
|
|
|
|
code?: string | undefined;
|
|
|
|
path?: string | undefined;
|
|
|
|
syscall?: string | undefined;
|
|
|
|
}
|
|
|
|
|
|
|
|
export interface ReadableStream extends EventEmitter {
|
|
|
|
readable: boolean;
|
|
|
|
read(size?: number): string | Buffer;
|
|
|
|
setEncoding(encoding: BufferEncoding): this;
|
|
|
|
pause(): this;
|
|
|
|
resume(): this;
|
|
|
|
isPaused(): boolean;
|
|
|
|
pipe<T extends WritableStream>(
|
|
|
|
destination: T,
|
|
|
|
options?: { end?: boolean | undefined },
|
|
|
|
): T;
|
|
|
|
unpipe(destination?: WritableStream): this;
|
|
|
|
unshift(chunk: string | Uint8Array, encoding?: BufferEncoding): void;
|
|
|
|
wrap(oldStream: ReadableStream): this;
|
|
|
|
[Symbol.asyncIterator](): AsyncIterableIterator<string | Buffer>;
|
|
|
|
}
|
|
|
|
|
|
|
|
export interface WritableStream extends EventEmitter {
|
|
|
|
writable: boolean;
|
|
|
|
write(
|
|
|
|
buffer: Uint8Array | string,
|
|
|
|
cb?: (err?: Error | null) => void,
|
|
|
|
): boolean;
|
|
|
|
write(
|
|
|
|
str: string,
|
|
|
|
encoding?: BufferEncoding,
|
|
|
|
cb?: (err?: Error | null) => void,
|
|
|
|
): boolean;
|
|
|
|
end(cb?: () => void): void;
|
|
|
|
end(data: string | Uint8Array, cb?: () => void): void;
|
|
|
|
end(str: string, encoding?: BufferEncoding, cb?: () => void): void;
|
|
|
|
}
|
|
|
|
|
|
|
|
export interface ReadWriteStream extends ReadableStream, WritableStream {}
|