@stencil/core 2.11.0 → 2.12.0

package/sys/node/index.js

@@ -1,5 +1,5 @@
 /*!
- Stencil Node System v2.11.0 | MIT Licensed | https://stenciljs.com
+ Stencil Node System v2.12.0 | MIT Licensed | https://stenciljs.com
  */
 function _interopDefaultLegacy(e) {
  return e && "object" == typeof e && "default" in e ? e : {

package/sys/node/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stencil/core/sys/node",
-  "version": "2.11.0",
+  "version": "2.12.0",
   "description": "Stencil Node System.",
   "main": "./index.js",
   "types": "./index.d.ts",

package/sys/node/worker.js

@@ -1,5 +1,5 @@
 /*!
- Stencil Node System Worker v2.11.0 | MIT Licensed | https://stenciljs.com
+ Stencil Node System Worker v2.12.0 | MIT Licensed | https://stenciljs.com
  */
 function _interopNamespace(e) {
  if (e && e.__esModule) return e;

package/testing/index.js

@@ -1,5 +1,5 @@
 /*!
- Stencil Testing v2.11.0 | MIT Licensed | https://stenciljs.com
+ Stencil Testing v2.12.0 | MIT Licensed | https://stenciljs.com
  */
 function _lazyRequire(e) {
  return new Proxy({}, {
@@ -205,6 +205,64 @@ function formatDiagnostic(e) {
  t;
 }
 
+function getCompilerOptions(e) {
+ if (_tsCompilerOptions) return _tsCompilerOptions;
+ if ("string" != typeof e) return null;
+ e = normalizePath(e);
+ const t = stencil_js.ts.findConfigFile(e, stencil_js.ts.sys.fileExists);
+ if (!t) return null;
+ const r = stencil_js.ts.readConfigFile(t, stencil_js.ts.sys.readFile);
+ if (r.error) throw new Error(formatDiagnostic((e => {
+  const t = {
+   level: "warn",
+   type: "typescript",
+   language: "typescript",
+   header: "TypeScript",
+   code: e.code.toString(),
+   messageText: flattenDiagnosticMessageText(e, e.messageText),
+   relFilePath: null,
+   absFilePath: null,
+   lines: []
+  };
+  if (1 === e.category && (t.level = "error"), e.file) {
+   t.absFilePath = e.file.fileName;
+   const s = "string" != typeof (r = e.file.text) ? [] : (r = r.replace(/\\r/g, "\n")).split("\n"), n = e.file.getLineAndCharacterOfPosition(e.start), i = {
+    lineIndex: n.line,
+    lineNumber: n.line + 1,
+    text: s[n.line],
+    errorCharStart: n.character,
+    errorLength: Math.max(e.length, 1)
+   };
+   if (t.lineNumber = i.lineNumber, t.columnNumber = i.errorCharStart + 1, t.lines.push(i), 
+   0 === i.errorLength && i.errorCharStart > 0 && (i.errorLength = 1, i.errorCharStart--), 
+   i.lineIndex > 0) {
+    const e = {
+     lineIndex: i.lineIndex - 1,
+     lineNumber: i.lineNumber - 1,
+     text: s[i.lineIndex - 1],
+     errorCharStart: -1,
+     errorLength: -1
+    };
+    t.lines.unshift(e);
+   }
+   if (i.lineIndex + 1 < s.length) {
+    const e = {
+     lineIndex: i.lineIndex + 1,
+     lineNumber: i.lineNumber + 1,
+     text: s[i.lineIndex + 1],
+     errorCharStart: -1,
+     errorLength: -1
+    };
+    t.lines.push(e);
+   }
+  }
+  var r;
+  return t;
+ })(r.error)));
+ const s = stencil_js.ts.parseJsonConfigFileContent(r.config, stencil_js.ts.sys, e, void 0, t);
+ return _tsCompilerOptions = s.options, _tsCompilerOptions;
+}
+
 function compareHtml(e, t, r) {
  if (null == e) throw new Error(`expect toEqualHtml() value is "${e}"`);
  if ("function" == typeof e.then) throw new Error("element must be a resolved value, not a promise, before it can be tested");
@@ -1235,9 +1293,13 @@ const path$2 = require("path"), index_js = _lazyRequire("../dev-server/index.js"
  if (!r.includes(t.code) && (n = t.messageText, isIterable(t.next))) for (const r of t.next) n += flattenDiagnosticMessageText(e, r);
  return s && (n = n.replace("type 'StencilConfig'", "Stencil Config"), n = n.replace("Object literal may only specify known properties, but ", ""), 
  n = n.replace("Object literal may only specify known properties, and ", "")), n.trim();
-}, isOutputTargetDistLazy = e => e.type === DIST_LAZY, isOutputTargetWww = e => e.type === WWW, DIST_LAZY = "dist-lazy", WWW = "www", jestPreprocessor = {
- process(e, t, r) {
-  if (function s(e, t) {
+}, isOutputTargetDistLazy = e => e.type === DIST_LAZY, isOutputTargetWww = e => e.type === WWW, DIST_LAZY = "dist-lazy", WWW = "www", isJest27TransformOptions = e => "object" == typeof e && e.hasOwnProperty("config");
+
+let _tsCompilerOptions = null, _tsCompilerOptionsKey = null;
+
+const jestPreprocessor = {
+ process(e, t, r, s) {
+  if (isJest27TransformOptions(r) && (s = r.config), function n(e, t) {
    const r = e.split(".").pop().toLowerCase().split("?")[0];
    if ("ts" === r || "tsx" === r || "jsx" === r) return !0;
    if ("mjs" === r) return !0;
@@ -1247,12 +1309,12 @@ const path$2 = require("path"), index_js = _lazyRequire("../dev-server/index.js"
    }
    return "css" === r;
   }(t, e)) {
-   const s = {
+   const r = {
     file: t,
-    currentDirectory: r.rootDir
-   }, n = this.getCompilerOptions(r.rootDir);
-   n && (n.baseUrl && (s.baseUrl = n.baseUrl), n.paths && (s.paths = n.paths));
-   const i = transpile(e, s), o = i.diagnostics.some((e => "error" === e.level));
+    currentDirectory: s.rootDir
+   }, n = getCompilerOptions(s.rootDir);
+   n && (n.baseUrl && (r.baseUrl = n.baseUrl), n.paths && (r.paths = n.paths));
+   const i = transpile(e, r), o = i.diagnostics.some((e => "error" === e.level));
    if (i.diagnostics && o) {
     const e = i.diagnostics.map(formatDiagnostic).join("\n\n");
     throw new Error(e);
@@ -1261,69 +1323,12 @@ const path$2 = require("path"), index_js = _lazyRequire("../dev-server/index.js"
   }
   return e;
  },
- getCompilerOptions(e) {
-  return this._tsCompilerOptions || (this._tsCompilerOptions = function t(e) {
-   if ("string" != typeof e) return null;
-   e = normalizePath(e);
-   const t = stencil_js.ts.findConfigFile(e, stencil_js.ts.sys.fileExists);
-   if (!t) return null;
-   const r = stencil_js.ts.readConfigFile(t, stencil_js.ts.sys.readFile);
-   if (r.error) throw new Error(formatDiagnostic((e => {
-    const t = {
-     level: "warn",
-     type: "typescript",
-     language: "typescript",
-     header: "TypeScript",
-     code: e.code.toString(),
-     messageText: flattenDiagnosticMessageText(e, e.messageText),
-     relFilePath: null,
-     absFilePath: null,
-     lines: []
-    };
-    if (1 === e.category && (t.level = "error"), e.file) {
-     t.absFilePath = e.file.fileName;
-     const s = "string" != typeof (r = e.file.text) ? [] : (r = r.replace(/\\r/g, "\n")).split("\n"), n = e.file.getLineAndCharacterOfPosition(e.start), i = {
-      lineIndex: n.line,
-      lineNumber: n.line + 1,
-      text: s[n.line],
-      errorCharStart: n.character,
-      errorLength: Math.max(e.length, 1)
-     };
-     if (t.lineNumber = i.lineNumber, t.columnNumber = i.errorCharStart + 1, t.lines.push(i), 
-     0 === i.errorLength && i.errorCharStart > 0 && (i.errorLength = 1, i.errorCharStart--), 
-     i.lineIndex > 0) {
-      const e = {
-       lineIndex: i.lineIndex - 1,
-       lineNumber: i.lineNumber - 1,
-       text: s[i.lineIndex - 1],
-       errorCharStart: -1,
-       errorLength: -1
-      };
-      t.lines.unshift(e);
-     }
-     if (i.lineIndex + 1 < s.length) {
-      const e = {
-       lineIndex: i.lineIndex + 1,
-       lineNumber: i.lineNumber + 1,
-       text: s[i.lineIndex + 1],
-       errorCharStart: -1,
-       errorLength: -1
-      };
-      t.lines.push(e);
-     }
-    }
-    var r;
-    return t;
-   })(r.error)));
-   return stencil_js.ts.parseJsonConfigFileContent(r.config, stencil_js.ts.sys, e, void 0, t).options;
-  }(e)), this._tsCompilerOptions;
- },
  getCacheKey(e, t, r, s) {
-  if (!this._tsCompilerOptionsKey) {
-   const e = this.getCompilerOptions(s.rootDir);
-   this._tsCompilerOptionsKey = JSON.stringify(e);
+  if (isJest27TransformOptions(r) && (s = r.config), !_tsCompilerOptionsKey) {
+   const e = getCompilerOptions(s.rootDir);
+   _tsCompilerOptionsKey = JSON.stringify(e);
   }
-  return [ process.version, this._tsCompilerOptionsKey, e, t, r, !!s.instrument, 6 ].join(":");
+  return [ process.version, _tsCompilerOptionsKey, e, t, r, !!s.instrument, 7 ].join(":");
  }
 }, deepEqual = function e(t, r) {
  var s, n, i, o, a, l, c, u, d, h;
@@ -2858,7 +2863,7 @@ const createSystem = e => {
  u("/");
  const S = {
   name: "in-memory",
-  version: "2.11.0",
+  version: "2.12.0",
   events: o,
   access: async e => c(e),
   accessSync: c,
@@ -3592,6 +3597,9 @@ exports.createJestPuppeteerEnvironment = function createJestPuppeteerEnvironment
     } catch (e) {}
    }(this.browser), this.browser = null;
   }
+  getVmContext() {
+   return super.getVmContext();
+  }
  };
 }, exports.createTestRunner = function createTestRunner() {
  const e = require("jest-runner");

package/testing/jest/jest-environment.d.ts

@@ -9,6 +9,7 @@ export declare function createJestPuppeteerEnvironment(): {
         newPuppeteerPage(): Promise<import("puppeteer").Page>;
         closeOpenPages(): Promise<void>;
         teardown(): Promise<void>;
+        getVmContext(): any;
     };
     [x: string]: any;
 };

package/testing/jest/jest-preprocessor.d.ts

@@ -1,11 +1,59 @@
+declare type Jest26CacheKeyOptions = {
+    instrument: boolean;
+    rootDir: string;
+};
+declare type Jest26Config = {
+    instrument: boolean;
+    rootDir: string;
+};
+declare type Jest27TransformOptions = {
+    config: Jest26Config;
+};
 export declare const jestPreprocessor: {
-    process(sourceText: string, filePath: string, jestConfig: {
-        rootDir: string;
-    }): string;
-    getCompilerOptions(rootDir: string): any;
-    getCacheKey(code: string, filePath: string, jestConfigStr: string, transformOptions: {
-        instrument: boolean;
-        rootDir: string;
-    }): string;
+    /**
+     * Transforms a file to CommonJS to be used by Jest. The API for `process` is described in the
+     * ["Writing custom transformers"](https://jestjs.io/docs/code-transformation#writing-custom-transformers)
+     * documentation on the jest site. Unfortunately, the URL is not versioned at the time of this writing. For
+     * reference, the v27.2 docs were referenced (the most recent available).
+     *
+     * This function attempts to support several versions of Jest (v23 through v27). Support for earlier versions of Jest
+     * will be removed in a future major version of Stencil.
+     *
+     * @param sourceText the contents of the source file
+     * @param sourcePath the path to the source file
+     * @param jestConfig the jest configuration when called by Jest 26 and lower. This parameter is folded into
+     * `transformOptions` when called by Jest 27+ as a top level `config` property. Calls to this function from Jest 27+
+     * will have a `Jest27TransformOptions` shape
+     * @param transformOptions an object containing the various transformation options. In Jest 27+ this parameter occurs
+     * third in this function signature (and no fourth parameter is formally accepted)
+     * @returns the transformed file contents if the file should be transformed. returns the original source otherwise
+     */
+    process(sourceText: string, sourcePath: string, jestConfig: Jest26Config | Jest27TransformOptions, transformOptions?: Jest26Config): string;
+    /**
+     * Generates a key used to cache the results of transforming a file. This helps avoid re-processing a file via the
+     * `transform` function unnecessarily (when no changes have occurred). The API for `getCacheKey` is described in the
+     * ["Writing custom transformers"](https://jestjs.io/docs/code-transformation#writing-custom-transformers)
+     * documentation on the jest site. Unfortunately, the URL is not versioned at the time of this writing. For
+     * reference, the v27.2 docs were referenced (the most recent available).
+     *
+     * This function attempts to support several versions of Jest (v23 through v27). Support for earlier versions of Jest
+     * will be removed in a future major version of Stencil.
+     *
+     * @param sourceText the contents of the source file
+     * @param sourcePath the path to the source file
+     * @param jestConfigStr a stringified version of the jest configuration when called by Jest 26 and lower. This
+     * parameter takes the shape of `transformOptions` when called by Jest 27+.
+     * @param transformOptions an object containing the various transformation options. In Jest 27+ this parameter occurs
+     * third in this function signature (and no fourth parameter is formally accepted)
+     * @returns the key to cache a file with
+     */
+    getCacheKey(sourceText: string, sourcePath: string, jestConfigStr: string | Jest27TransformOptions, transformOptions?: Jest26CacheKeyOptions): string;
 };
+/**
+ * Determines if a file should be transformed prior to being consumed by Jest, based on the file name and its contents
+ * @param filePath the path of the file
+ * @param sourceText the contents of the file
+ * @returns `true` if the file should be transformed, `false` otherwise
+ */
 export declare function shouldTransform(filePath: string, sourceText: string): boolean;
+export {};

package/testing/jest-preset.js

@@ -1,3 +1,8 @@
+/**
+ * The path's declared below are relative. Specifically, they are relative to the location of this file after
+ * compilation of the Stencil compiler has completed. See `scripts/bundles/testing` for the location of this file
+ * following compilation.
+ */
 const path = require('path');
 const testingDir = __dirname;
 const rootDir = path.join(testingDir, '..');

package/testing/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stencil/core/testing",
-  "version": "2.11.0",
+  "version": "2.12.0",
   "description": "Stencil testing suite.",
   "main": "./index.js",
   "types": "./index.d.ts",