@rindo/core 1.17.4 → 2.5.2

package/internal/rindo-public-compiler.d.ts

@@ -1,5 +1,5 @@
-import { JsonDocs } from './rindo-public-docs';
-import { PrerenderUrlResults } from '../internal';
+import type { JsonDocs } from './rindo-public-docs';
+import type { PrerenderUrlResults } from '../internal';
 export * from './rindo-public-docs';
 /**
  * https://rindojs.web.app/docs/config/
@@ -11,10 +11,11 @@ export interface RindoConfig {
      */
     allowInlineScripts?: boolean;
     /**
-     * By default, Rindo will use the appropriate config to automatically prefix css. For example,
-     * developers can write modern and standard css properties, such as "transform", and Rindo
-     * will automatically add in the prefixed version, such as "-webkit-transform". To disable
-     * autoprefixing css, set this value to `false`.
+     * By setting `autoprefixCss` to `true`, Rindo will use the appropriate config to automatically
+     * prefix css. For example, developers can write modern and standard css properties, such as
+     * "transform", and Rindo will automatically add in the prefixed version, such as "-webkit-transform".
+     * As of Rindo v2, autoprefixing CSS is no longer the default.
+     * Defaults to `false`
      */
     autoprefixCss?: boolean | any;
     /**
@@ -31,34 +32,11 @@ export interface RindoConfig {
      * This config is rarely needed as Rindo handles this automatically behind the scenes.
      */
     bundles?: ConfigBundle[];
-    /**
-     * The copy config is an array of objects that defines any files or folders that should
-     * be copied over to the build directory.
-     *
-     * Each object in the array must include a src property which can be either an absolute path,
-     * a relative path or a glob pattern. The config can also provide an optional dest property
-     * which can be either an absolute path or a path relative to the build directory.
-     * Also note that any files within src/assets are automatically copied to www/assets for convenience.
-     *
-     * In the copy config below, it will copy the entire directory from src/docs-content over to www/docs-content.
-     *
-     * @deprecated
-     */
-    copy?: CopyTask[];
     /**
      * Rindo will cache build results in order to speed up rebuilds.
      * To disable this feature, set enableCache to false.
      */
     enableCache?: boolean;
-    /**
-     * The excludeSrc config setting specifies a set of regular expressions that should be excluded
-     * from the build process.
-     *
-     * The defaults are meant to exclude possible test files that you would not want to include in your final build.
-     *
-     * @deprecated Use the "exclude" option in "tsconfig.json"
-     */
-    excludeSrc?: string[];
     /**
      * Rindo is traditionally used to compile many components into an app,
      * and each component comes with its own compartmentalized styles.
@@ -87,7 +65,7 @@ export interface RindoConfig {
      * The namespace config is a string representing a namespace for the app.
      * For apps that are not meant to be a library of reusable components,
      * the default of App is just fine. However, if the app is meant to be consumed
-     * as a third-party library, such as Navify, a unique namespace is required.
+     * as a third-party library, such as Family, a unique namespace is required.
      */
     namespace?: string;
     /**
@@ -124,16 +102,13 @@ export interface RindoConfig {
      */
     rollupConfig?: RollupConfig;
     /**
-     * Sets if the ES5 build should be generated or not. It defaults to `false` in dev mode, and `true` in
-     * production mode. Notice that Rindo always generates a modern build too, whereas this setting
-     * will either disable es5 builds entirely with `false`, or always create es5 builds (even in dev mode)
-     * when set to `true`. Basically if the app does not need to run on legacy browsers
-     * (IE11 and Edge 18 and below), it's safe to set `buildEs5` to `false`, which will also speed up
-     * production build times. In addition to not creating es5 builds, apps may also be interested in
-     * disabling any unnecessary runtime when support legacy browsers. See
-     * [https://rindojs.web.app/docs/config-extras](/docs/config-extras) for more information.
+     * Sets if the ES5 build should be generated or not. Rindo generates a modern build without ES5,
+     * whereas this setting to `true` will also create es5 builds for both dev and prod modes. Setting
+     * `buildEs5` to `prod` will only build ES5 in prod mode. Basically if the app does not need to run
+     * on legacy browsers (IE11 and Edge 18 and below), it's safe to not build ES5, which will also speed
+     * up build times. Defaults to `false`.
      */
-    buildEs5?: boolean;
+    buildEs5?: boolean | 'prod';
     /**
      * Sets if the JS browser files are minified or not. Rindo uses `terser` under the hood.
      * Defaults to `false` in dev mode and `true` in production mode.
@@ -174,12 +149,18 @@ export interface RindoConfig {
     hydratedFlag?: HydratedFlag;
     /**
      * Sets the task queue used by rindo's runtime. The task queue schedules DOM read and writes
-     * across the frames to efficiently render and reduce layout thrashing. By default, the
-     * `congestionAsync` is used. It's recommended to also try each setting to decide which works
+     * across the frames to efficiently render and reduce layout thrashing. By default,
+     * `async` is used. It's recommended to also try each setting to decide which works
      * best for your use-case. In all cases, if your app has many CPU intensive tasks causing the
      * main thread to periodically lock-up, it's always recommended to try
      * [Web Workers](https://rindojs.web.app/docs/web-workers) for those tasks.
      *
+     * - `async`: DOM read and writes are scheduled in the next frame to prevent layout thrashing.
+     *   During intensive CPU tasks it will not reschedule rendering to happen in the next frame.
+     *   `async` is ideal for most apps, and if the app has many intensive tasks causing the main
+     *   thread to lock-up, it's recommended to try [Web Workers](https://rindojs.web.app/docs/web-workers)
+     *   rather than the congestion async queue.
+     *
      * - `congestionAsync`: DOM reads and writes are scheduled in the next frame to prevent layout
      *   thrashing. When the app is heavily tasked and the queue becomes congested it will then
      *   split the work across multiple frames to prevent blocking the main thread. However, it can
@@ -187,12 +168,6 @@ export interface RindoConfig {
      *   is ideal for apps running animations while also simultaniously executing intesive tasks
      *   which may lock-up the main thread.
      *
-     * - `async`: DOM read and writes are scheduled in the next frame to prevent layout thrashing.
-     *   During intensive CPU tasks it will not reschedule rendering to happen in the next frame.
-     *   `async` is ideal for most apps, and if the app has many intensive tasks causing the main
-     *   thread to lock-up, it's recommended to try [Web Workers](https://rindojs.web.app/docs/web-workers)
-     *   rather than the congestion async queue.
-     *
      * - `immediate`: Makes writeTask() and readTask() callbacks to be executed syncronously. Tasks
      *   are not scheduled to run in the next frame, but do note there is at least one microtask.
      *   The `immediate` setting is ideal for apps that do not provide long running and smooth
@@ -200,16 +175,18 @@ export interface RindoConfig {
      *   to lock-up, it's recommended to try [Web Workers](https://rindojs.web.app/docs/web-workers).
      */
     taskQueue?: 'async' | 'immediate' | 'congestionAsync';
+    /**
+     * Provide a object of key/values accessible within the app, using the `Env` object.
+     */
+    env?: {
+        [prop: string]: string | undefined;
+    };
     globalScript?: string;
     srcIndexHtml?: string;
     watch?: boolean;
     testing?: TestingConfig;
     maxConcurrentWorkers?: number;
     preamble?: string;
-    /**
-     * @deprecated Use the "include" option in "tsconfig.json"
-     */
-    includeSrc?: string[];
     rollupPlugins?: {
         before?: any[];
         after?: any[];
@@ -224,34 +201,40 @@ export interface RindoConfig {
     sys?: CompilerSystem;
     tsconfig?: string;
     validateTypes?: boolean;
-    watchIgnoredRegex?: RegExp;
+    /**
+     * An array of RegExp patterns that are matched against all source files before adding
+     * to the watch list in watch mode. If the file path matches any of the patterns, when it
+     * is updated, it will not trigger a re-run of tests.
+     */
+    watchIgnoredRegex?: RegExp | RegExp[];
     excludeUnusedDependencies?: boolean;
-    typescriptPath?: string;
     rindoCoreResolvedId?: string;
 }
 export interface ConfigExtras {
     /**
      * By default, the slot polyfill does not update `appendChild()` so that it appends
      * new child nodes into the correct child slot like how shadow dom works. This is an opt-in
-     * polyfill for those who need it. Defaults to `false`.
+     * polyfill for those who need it when using `element.appendChild(node)` and expecting the
+     * child to be appended in the same location shadom dom would. This is not required for
+     * IE11 or Edge 18, but can be enabled if the app is using `appendChild()`. Defaults to `false`.
      */
     appendChildSlotFix?: boolean;
     /**
      * By default, the runtime does not polyfill `cloneNode()` when cloning a component
      * that uses the slot polyfill. This is an opt-in polyfill for those who need it.
-     * Defaults to `false`.
+     * This is not required for IE11 or Edge 18, but can be enabled if the app is using
+     * `cloneNode()` and unexpected node are being cloned due to the slot polyfill
+     * simulating shadow dom. Defaults to `false`.
      */
     cloneNodeFix?: boolean;
     /**
-     * Include the CSS Custom Property polyfill/shim for legacy browsers. Defaults to `true`
-     * for legacy builds only. ESM builds will not include the css vars shim.
+     * Include the CSS Custom Property polyfill/shim for legacy browsers. ESM builds will
+     * not include the css vars shim. Defaults to `false`
      */
     cssVarsShim?: boolean;
     /**
      * Dynamic `import()` shim. This is only needed for Edge 18 and below, and Firefox 67
-     * and below. If you do not need to support Edge 18 and below (Edge before it moved
-     * to Chromium) then it's recommended to set `dynamicImportShim` to `false`.
-     * Defaults to `true`.
+     * and below. Defaults to `false`.
      */
     dynamicImportShim?: boolean;
     /**
@@ -260,29 +243,29 @@ export interface ConfigExtras {
     lifecycleDOMEvents?: boolean;
     /**
      * Safari 10 supports ES modules with `<script type="module">`, however, it did not implement
-     * `<script nomodule>`. When set to `false`, the runtime will not patch support for Safari 10.
-     * Defaults to `true`.
+     * `<script nomodule>`. When set to `true`, the runtime will patch support for Safari 10
+     * due to its lack of `nomodule` support.
+     * Defaults to `false`.
      */
     safari10?: boolean;
     /**
      * It is possible to assign data to the actual `<script>` element's `data-opts` property,
      * which then gets passed to Rindo's initial bootstrap. This feature is only required
-     * for very special cases and rarely needed. When set to `false` it will not read
-     * this data. Defaults to `true`.
+     * for very special cases and rarely needed. Defaults to `false`.
      */
     scriptDataOpts?: boolean;
     /**
      * If enabled `true`, the runtime will check if the shadow dom shim is required. However,
      * if it's determined that shadow dom is already natively supported by the browser then
-     * it does not request the shim. Setting to `false` will avoid all shadow dom tests.
-     * If the app does not need to support IE11 or Edge 18 it's recommended to set `shadowDomShim` to
-     * `false`. Defaults to `true`.
+     * it does not request the shim. When set to `false` it will avoid all shadow dom tests.
+     * Defaults to `false`.
      */
     shadowDomShim?: boolean;
     /**
-     * When a component is first attached to the DOM, wait a single tick before rendering.
-     * This worksaround an angular issue, where it attaches the elements before settings their initial state,
-     * leading to double renders and unnecesary event dispatchs.
+     * When a component is first attached to the DOM, this setting will wait a single tick before
+     * rendering. This worksaround an Angular issue, where Angular attaches the elements before
+     * settings their initial state, leading to double renders and unnecesary event dispatchs.
+     * Defaults to `false`.
      */
     initializeNextTick?: boolean;
     /**
@@ -293,7 +276,8 @@ export interface ConfigExtras {
      */
     slotChildNodesFix?: boolean;
     /**
-     * Enables the tagNameTransform option of `defineCustomElements()`, so the component tagName can be customized at runtime.
+     * Enables the tagNameTransform option of `defineCustomElements()`, so the component tagName
+     * can be customized at runtime. Defaults to `false`.
      */
     tagNameTransform?: boolean;
 }
@@ -344,7 +328,8 @@ export interface HydratedFlag {
 }
 export interface RindoDevServerConfig {
     /**
-     * IP address used by the dev server. The default is `0.0.0.0`, which points to all IPv4 addresses on the local machine, such as `localhost`.
+     * IP address used by the dev server. The default is `0.0.0.0`, which points to all IPv4 addresses
+     * on the local machine, such as `localhost`.
      */
     address?: string;
     /**
@@ -364,7 +349,8 @@ export interface RindoDevServerConfig {
      */
     gzip?: boolean;
     /**
-     * When set, the dev server will run via https using the SSL certificate and key you provide (use `fs` if you want to read them from files).
+     * When set, the dev server will run via https using the SSL certificate and key you provide
+     * (use `fs` if you want to read them from files).
      */
     https?: Credentials;
     /**
@@ -372,11 +358,13 @@ export interface RindoDevServerConfig {
      */
     initialLoadUrl?: string;
     /**
-     * When `true`, every request to the server will be logged within the terminal. Defaults to `false`.
+     * When `true`, every request to the server will be logged within the terminal.
+     * Defaults to `false`.
      */
     logRequests?: boolean;
     /**
-     * By default, when dev server is started the local dev URL is opened in your default browser. However, to prevent this URL to be opened change this value to `false`. Defaults to `true`.
+     * By default, when dev server is started the local dev URL is opened in your default browser.
+     * However, to prevent this URL to be opened change this value to `false`. Defaults to `true`.
      */
     openBrowser?: boolean;
     /**
@@ -384,23 +372,71 @@ export interface RindoDevServerConfig {
      */
     port?: number;
     /**
-     * When files are watched and updated, by default the dev server will use `hmr` (Hot Module Replacement) to update the page without a full page refresh. To have the page do a full refresh use `pageReload`. To disable any reloading, use `null`. Defaults to `hmr`.
+     * When files are watched and updated, by default the dev server will use `hmr` (Hot Module Replacement)
+     * to update the page without a full page refresh. To have the page do a full refresh use `pageReload`.
+     * To disable any reloading, use `null`. Defaults to `hmr`.
      */
     reloadStrategy?: PageReloadStrategy;
+    /**
+     * Local path to a NodeJs file with a dev server request listener as the default export.
+     * The user's request listener is given the first chance to handle every request the dev server
+     * receives, and can choose to handle it or instead pass it on to the default dev server
+     * by calling `next()`.
+     *
+     * Below is an example of a NodeJs file the `requestListenerPath` config is using.
+     * The request and response arguments are the same as Node's `http` module and `RequestListener`
+     * callback. https://nodejs.org/api/http.html#http_http_createserver_options_requestlistener
+     *
+     * ```js
+     * module.exports = function (req, res, next) {
+     *    if (req.url === '/ping') {
+     *      // custom response overriding the dev server
+     *      res.setHeader('Content-Type', 'text/plain');
+     *      res.writeHead(200);
+     *      res.end('pong');
+     *    } else {
+     *      // pass request on to the default dev server
+     *      next();
+     *    }
+     * };
+     * ```
+     */
+    requestListenerPath?: string;
+    /**
+     * The root directory to serve the files from.
+     */
     root?: string;
+    /**
+     * If the dev server should Server-Side Render (SSR) each page, meaning it'll dynamically generate
+     * server-side rendered html on each page load. The `--ssr` flag will most commonly be used with
+     * the`--dev --watch --serve` flags during development. Note that this is for development purposes
+     * only, and the built-in dev server should not be used for production. Defaults to `false`.
+     */
+    ssr?: boolean;
+    /**
+     * If the dev server fails to start up within the given timout (in milliseconds), the startup will
+     * be canceled. Set to zero to disable the timeout. Defaults to `15000`.
+     */
+    startupTimeout?: number;
+    /**
+     * Whether to use the dev server's websocket client or not. Defaults to `true`.
+     */
     websocket?: boolean;
+    /**
+     * If the dev server should fork a worker for the server process or not. A singled-threaded dev server
+     * is slower, however it is useful for debugging http requests and responses. Defaults to `true`.
+     */
+    worker?: boolean;
 }
 export interface DevServerConfig extends RindoDevServerConfig {
     browserUrl?: string;
-    contentTypes?: {
-        [ext: string]: string;
-    };
     devServerDir?: string;
-    editors?: DevServerEditor[];
     excludeHmr?: string[];
     historyApiFallback?: HistoryApiFallback;
     openBrowser?: boolean;
+    prerenderConfig?: string;
     protocol?: 'http' | 'https';
+    srcIndexHtml?: string;
 }
 export interface HistoryApiFallback {
     index?: string;
@@ -449,6 +485,7 @@ export interface ConfigFlags {
     serve?: boolean;
     serviceWorker?: boolean;
     spec?: boolean;
+    ssr?: boolean;
     stats?: boolean;
     updateScreenshot?: boolean;
     version?: boolean;
@@ -468,7 +505,7 @@ export declare type PageReloadStrategy = 'hmr' | 'pageReload' | null;
  *   outputTargets: [
  *     {
  *       type: 'www',
- *       baseUrl: 'https://rindojs.com/',
+ *       baseUrl: 'https://rindojs.web.app/',
  *       prerenderConfig: './prerender.config.ts',
  *     }
  *   ]
@@ -485,7 +522,7 @@ export declare type PageReloadStrategy = 'hmr' | 'pageReload' | null;
  * };
  * ```
  *
- * For more info: https://rindojs.com/docs/static-site-generation
+ * For more info: https://rindojs.web.app/docs/static-site-generation
  */
 export interface PrerenderConfig {
     /**
@@ -567,24 +604,29 @@ export interface PrerenderConfig {
     trailingSlash?: boolean;
 }
 export interface HydrateDocumentOptions {
+    /**
+     * Build ID that will be added to `<html data-rindo-build="BUILD_ID">`. By default
+     * a random ID will be generated
+     */
+    buildId?: string;
     /**
      * Sets the `href` attribute on the `<link rel="canonical">`
      * tag within the `<head>`. If the value is not defined it will
      * ensure a canonical link tag is no included in the `<head>`.
      */
     canonicalUrl?: string;
-    /**
-     * Constrain `setTimeout()` to 1ms, but still async. Also
-     * only allows `setInterval()` to fire once, also constrained to 1ms.
-     * Defaults to `true`.
-     */
-    constrainTimeouts?: boolean;
     /**
      * Include the HTML comments and attributes used by the clientside
      * JavaScript to read the structure of the HTML and rebuild each
      * component. Defaults to `true`.
      */
     clientHydrateAnnotations?: boolean;
+    /**
+     * Constrain `setTimeout()` to 1ms, but still async. Also
+     * only allows `setInterval()` to fire once, also constrained to 1ms.
+     * Defaults to `true`.
+     */
+    constrainTimeouts?: boolean;
     /**
      * Sets `document.cookie`
      */
@@ -706,9 +748,17 @@ export interface PrerenderHydrateOptions extends SerializeDocumentOptions {
      * Defaults to `true`.
      */
     addModulePreloads?: boolean;
+    /**
+     * Hash the content of assets, such as images, fonts and css files,
+     * and add the hashed value as `v` querystring. For example,
+     * `/assets/image.png?v=abcd1234`. This allows for assets to be
+     * heavily cached by setting the server's response header with
+     * `Cache-Control: max-age=31536000, immutable`.
+     */
+    hashAssets?: 'querystring';
     /**
      * External stylesheets from `<link rel="stylesheet">` are instead inlined
-     * into `<style>` elements. Defaults to `true`.
+     * into `<style>` elements. Defaults to `false`.
      */
     inlineExternalStyleSheets?: boolean;
     /**
@@ -758,7 +808,7 @@ export interface SitemapXmpResults {
  * of the actual platform it's being ran ontop of.
  */
 export interface CompilerSystem {
-    name: 'node' | 'in-memory';
+    name: 'deno' | 'node' | 'in-memory';
     version: string;
     events?: BuildEvents;
     details?: SystemDetails;
@@ -790,6 +840,17 @@ export interface CompilerSystem {
      * Used to destroy any listeners, file watchers or child processes.
      */
     destroy(): Promise<void>;
+    /**
+     * Does not throw.
+     */
+    createDir(p: string, opts?: CompilerSystemCreateDirectoryOptions): Promise<CompilerSystemCreateDirectoryResults>;
+    /**
+     * SYNC! Does not throw.
+     */
+    createDirSync(p: string, opts?: CompilerSystemCreateDirectoryOptions): CompilerSystemCreateDirectoryResults;
+    /**
+     * Each plaform as a different way to dynamically import modules.
+     */
     dynamicImport?(p: string): Promise<any>;
     /**
      * Creates the worker controller for the current system.
@@ -802,7 +863,6 @@ export interface CompilerSystem {
         dependencies: CompilerDependency[];
     }): Promise<{
         rindoPath: string;
-        typescriptPath: string;
         diagnostics: Diagnostic[];
     }>;
     ensureResources?(opts: {
@@ -813,7 +873,7 @@ export interface CompilerSystem {
     /**
      * process.exit()
      */
-    exit(exitCode: number): void;
+    exit(exitCode: number): Promise<void>;
     /**
      * Optionally provide a fetch() function rather than using the built-in fetch().
      * First arg is a url string or Request object (RequestInfo).
@@ -821,9 +881,13 @@ export interface CompilerSystem {
      */
     fetch?(input: string | any, init?: any): Promise<any>;
     /**
-     * Generates a MD5 digest encoded as HEX
+     * Generates a sha1 digest encoded as HEX
      */
-    generateContentHash?(content: string, length?: number): Promise<string>;
+    generateContentHash?(content: string | any, length?: number): Promise<string>;
+    /**
+     * Generates a sha1 digest encoded as HEX from a file path
+     */
+    generateFileHash?(filePath: string | any, length?: number): Promise<string>;
     /**
      * Get the current directory.
      */
@@ -870,14 +934,6 @@ export interface CompilerSystem {
      */
     isSymbolicLink(p: string): Promise<boolean>;
     lazyRequire?: LazyRequire;
-    /**
-     * Does not throw.
-     */
-    mkdir(p: string, opts?: CompilerSystemMakeDirectoryOptions): Promise<CompilerSystemMakeDirectoryResults>;
-    /**
-     * SYNC! Does not throw.
-     */
-    mkdirSync(p: string, opts?: CompilerSystemMakeDirectoryOptions): CompilerSystemMakeDirectoryResults;
     nextTick(cb: () => void): void;
     /**
      * Normalize file system path.
@@ -886,17 +942,19 @@ export interface CompilerSystem {
     onProcessInterrupt?(cb: () => void): void;
     platformPath: PlatformPath;
     /**
-     * All return paths are full normalized paths, not just the file names. Always returns an array, does not throw.
+     * All return paths are full normalized paths, not just the basenames. Always returns an array, does not throw.
      */
-    readdir(p: string): Promise<string[]>;
+    readDir(p: string): Promise<string[]>;
     /**
-     * SYNC! All return paths are full normalized paths, not just the file names. Always returns an array, does not throw.
+     * SYNC! All return paths are full normalized paths, not just the basenames. Always returns an array, does not throw.
      */
-    readdirSync(p: string): string[];
+    readDirSync(p: string): string[];
     /**
      * Returns undefined if file is not found. Does not throw.
      */
-    readFile(p: string, encoding?: string): Promise<string>;
+    readFile(p: string): Promise<string>;
+    readFile(p: string, encoding: 'utf8'): Promise<string>;
+    readFile(p: string, encoding: 'binary'): Promise<any>;
     /**
      * SYNC! Returns undefined if file is not found. Does not throw.
      */
@@ -922,28 +980,31 @@ export interface CompilerSystem {
     /**
      * Does not throw.
      */
-    rmdir(p: string, opts?: CompilerSystemRemoveDirectoryOptions): Promise<CompilerSystemRemoveDirectoryResults>;
+    removeDir(p: string, opts?: CompilerSystemRemoveDirectoryOptions): Promise<CompilerSystemRemoveDirectoryResults>;
     /**
      * SYNC! Does not throw.
      */
-    rmdirSync(p: string, opts?: CompilerSystemRemoveDirectoryOptions): CompilerSystemRemoveDirectoryResults;
+    removeDirSync(p: string, opts?: CompilerSystemRemoveDirectoryOptions): CompilerSystemRemoveDirectoryResults;
     /**
-     * Returns undefined if stat not found. Does not throw.
+     * Does not throw.
      */
-    stat(p: string): Promise<CompilerFsStats>;
+    removeFile(p: string): Promise<CompilerSystemRemoveFileResults>;
     /**
-     * SYNC! Returns undefined if stat not found. Does not throw.
+     * SYNC! Does not throw.
      */
-    statSync(p: string): CompilerFsStats;
-    tmpdir(): string;
+    removeFileSync(p: string): CompilerSystemRemoveFileResults;
+    setupCompiler?: (c: {
+        ts: any;
+    }) => void;
     /**
-     * Does not throw.
+     * Always returns an object. Does not throw. Check for "error" property if there's an error.
      */
-    unlink(p: string): Promise<CompilerSystemUnlinkResults>;
+    stat(p: string): Promise<CompilerFsStats>;
     /**
-     * SYNC! Does not throw.
+     * SYNC! Always returns an object. Does not throw. Check for "error" property if there's an error.
      */
-    unlinkSync(p: string): CompilerSystemUnlinkResults;
+    statSync(p: string): CompilerFsStats;
+    tmpDirSync(): string;
     watchDirectory?(p: string, callback: CompilerFileWatcherCallback, recursive?: boolean): CompilerFileWatcher;
     watchFile?(p: string, callback: CompilerFileWatcherCallback): CompilerFileWatcher;
     /**
@@ -1138,15 +1199,32 @@ export interface CompilerFileWatcher {
     close(): void | Promise<void>;
 }
 export interface CompilerFsStats {
-    isFile(): boolean;
-    isDirectory(): boolean;
-    isSymbolicLink(): boolean;
+    /**
+     * If it's a directory. `false` if there was an error.
+     */
+    isDirectory: boolean;
+    /**
+     * If it's a file. `false` if there was an error.
+     */
+    isFile: boolean;
+    /**
+     * If it's a symlink. `false` if there was an error.
+     */
+    isSymbolicLink: boolean;
+    /**
+     * The size of the file in bytes. `0` for directories or if there was an error.
+     */
     size: number;
-    mtime?: {
-        getTime(): number;
-    };
+    /**
+     * The timestamp indicating the last time this file was modified expressed in milliseconds since the POSIX Epoch.
+     */
+    mtimeMs?: number;
+    /**
+     * Error if there was one, otherwise `null`. `stat` and `statSync` do not throw errors but always returns this interface.
+     */
+    error: any;
 }
-export interface CompilerSystemMakeDirectoryOptions {
+export interface CompilerSystemCreateDirectoryOptions {
     /**
      * Indicates whether parent directories should be created.
      * @default false
@@ -1158,7 +1236,7 @@ export interface CompilerSystemMakeDirectoryOptions {
      */
     mode?: number;
 }
-export interface CompilerSystemMakeDirectoryResults {
+export interface CompilerSystemCreateDirectoryResults {
     basename: string;
     dirname: string;
     path: string;
@@ -1198,7 +1276,7 @@ export interface CompilerSystemRealpathResults {
     path: string;
     error: any;
 }
-export interface CompilerSystemUnlinkResults {
+export interface CompilerSystemRemoveFileResults {
     basename: string;
     dirname: string;
     path: string;
@@ -1375,10 +1453,6 @@ export interface JestConfig {
      */
     setupFiles?: string[];
     setupFilesAfterEnv?: string[];
-    /**
-     * @deprecated Use setupFilesAfterEnv instead.
-     */
-    setupTestFrameworkScriptFile?: string;
     snapshotSerializers?: any[];
     testEnvironment?: string;
     testEnvironmentOptions?: any;
@@ -1584,7 +1658,6 @@ export interface OutputTargetDistLazy extends OutputTargetBase {
     esmIndexFile?: string;
     cjsIndexFile?: string;
     systemLoaderFile?: string;
-    legacyLoaderFile?: string;
     empty?: boolean;
 }
 export interface OutputTargetDistGlobalStyles extends OutputTargetBase {
@@ -1600,15 +1673,15 @@ export interface OutputTargetDistLazyLoader extends OutputTargetBase {
     componentDts: string;
     empty: boolean;
 }
-export interface OutputTargetDistSelfContained extends OutputTargetBase {
-    type: 'dist-self-contained';
-    dir?: string;
-    buildDir?: string;
-    empty?: boolean;
-}
 export interface OutputTargetHydrate extends OutputTargetBase {
     type: 'dist-hydrate-script';
     dir?: string;
+    /**
+     * Module IDs that should not be bundled into the script.
+     * By default, all node builtin's, such as `fs` or `path`
+     * will be considered "external" and not bundled.
+     */
+    external?: string[];
     empty?: boolean;
 }
 export interface OutputTargetCustom extends OutputTargetBase {
@@ -1624,7 +1697,7 @@ export interface OutputTargetDocsVscode extends OutputTargetBase {
     sourceCodeBaseUrl?: string;
 }
 export interface OutputTargetDocsReadme extends OutputTargetBase {
-    type: 'docs-readme' | 'docs';
+    type: 'docs-readme';
     dir?: string;
     dependencies?: boolean;
     footer?: string;
@@ -1638,7 +1711,7 @@ export interface OutputTargetDocsJson extends OutputTargetBase {
 }
 export interface OutputTargetDocsCustom extends OutputTargetBase {
     type: 'docs-custom';
-    generator: (docs: JsonDocs) => void | Promise<void>;
+    generator: (docs: JsonDocs, config: Config) => void | Promise<void>;
     strict?: boolean;
 }
 export interface OutputTargetStats extends OutputTargetBase {
@@ -1652,14 +1725,20 @@ export interface OutputTargetBaseNext {
 export interface OutputTargetDistCustomElements extends OutputTargetBaseNext {
     type: 'dist-custom-elements';
     empty?: boolean;
+    externalRuntime?: boolean;
     copy?: CopyTask[];
+    inlineDynamicImports?: boolean;
+    includeGlobalScripts?: boolean;
+    minify?: boolean;
 }
 export interface OutputTargetDistCustomElementsBundle extends OutputTargetBaseNext {
-    type: 'dist-custom-elements-bundle' | 'experimental-dist-module';
+    type: 'dist-custom-elements-bundle';
     empty?: boolean;
     externalRuntime?: boolean;
     copy?: CopyTask[];
     inlineDynamicImports?: boolean;
+    includeGlobalScripts?: boolean;
+    minify?: boolean;
 }
 export interface OutputTargetBase {
     type: string;
@@ -1752,7 +1831,7 @@ export interface OutputTargetWww extends OutputTargetBase {
     serviceWorker?: ServiceWorkerConfig | null | false;
     appDir?: string;
 }
-export declare type OutputTarget = OutputTargetAngular | OutputTargetCopy | OutputTargetCustom | OutputTargetDist | OutputTargetDistCollection | OutputTargetDistCustomElements | OutputTargetDistCustomElementsBundle | OutputTargetDistLazy | OutputTargetDistGlobalStyles | OutputTargetDistLazyLoader | OutputTargetDistSelfContained | OutputTargetDocsJson | OutputTargetDocsCustom | OutputTargetDocsReadme | OutputTargetDocsVscode | OutputTargetWww | OutputTargetHydrate | OutputTargetStats | OutputTargetDistTypes;
+export declare type OutputTarget = OutputTargetAngular | OutputTargetCopy | OutputTargetCustom | OutputTargetDist | OutputTargetDistCollection | OutputTargetDistCustomElements | OutputTargetDistCustomElementsBundle | OutputTargetDistLazy | OutputTargetDistGlobalStyles | OutputTargetDistLazyLoader | OutputTargetDocsJson | OutputTargetDocsCustom | OutputTargetDocsReadme | OutputTargetDocsVscode | OutputTargetWww | OutputTargetHydrate | OutputTargetStats | OutputTargetDistTypes;
 export interface ServiceWorkerConfig {
     unregister?: boolean;
     swDest?: string;
@@ -1795,7 +1874,6 @@ export interface LoadConfigInit {
      * within the root directory.
      */
     initTsConfig?: boolean;
-    typescriptPath?: string;
 }
 export interface LoadConfigResults {
     config: Config;
@@ -1854,11 +1932,13 @@ export interface ResolveModuleOptions {
     packageJson?: boolean;
 }
 export interface PrerenderStartOptions {
+    buildId?: string;
     hydrateAppFilePath: string;
     componentGraph: BuildResultsComponentGraph;
     srcIndexHtmlPath: string;
 }
 export interface PrerenderResults {
+    buildId: string;
     diagnostics: Diagnostic[];
     urls: number;
     duration: number;
@@ -1870,6 +1950,7 @@ export interface OptimizeCssInput {
     autoprefixer?: any;
     minify?: boolean;
     sourceMap?: boolean;
+    resolveUrl?: (url: string) => Promise<string> | string;
 }
 export interface OptimizeCssOutput {
     output: string;
@@ -1888,14 +1969,9 @@ export interface OptimizeJsOutput {
     diagnostics: Diagnostic[];
 }
 export interface LazyRequire {
-    ensure(logger: Logger, fromDir: string, moduleIds: string[]): Promise<void>;
-    require(moduleId: string): any;
-    getModulePath(moduleId: string): string;
-}
-export interface FsWatcher {
-    addFile(path: string): Promise<boolean>;
-    addDirectory(path: string): Promise<boolean>;
-    close(): void;
+    ensure(fromDir: string, moduleIds: string[]): Promise<Diagnostic[]>;
+    require(fromDir: string, moduleId: string): any;
+    getModulePath(fromDir: string, moduleId: string): string;
 }
 export interface FsWatcherItem {
     close(): void;
@@ -1949,9 +2025,9 @@ export interface Compiler {
     sys: CompilerSystem;
 }
 export interface CompilerWatcher extends BuildOnEvents {
-    start(): Promise<WatcherCloseResults>;
-    close(): Promise<WatcherCloseResults>;
-    request(data: CompilerRequest): Promise<CompilerRequestResponse>;
+    start: () => Promise<WatcherCloseResults>;
+    close: () => Promise<WatcherCloseResults>;
+    request: (data: CompilerRequest) => Promise<CompilerRequestResponse>;
 }
 export interface CompilerRequest {
     path?: string;
@@ -1960,6 +2036,7 @@ export interface WatcherCloseResults {
     exitCode: number;
 }
 export interface CompilerRequestResponse {
+    path: string;
     nodeModuleId: string;
     nodeModuleVersion: string;
     nodeResolvedPath: string;
@@ -2023,7 +2100,6 @@ export interface TranspileOptions {
      * `latest`, `esnext`, `es2017`, `es2015`, or `es5`. Defaults to `latest`.
      */
     target?: CompileTarget;
-    typescriptPath?: string;
     /**
      * Create a source map. Using `inline` will inline the source map into the
      * code, otherwise the source map will be in the returned `map` property.