@stencil/core 2.11.0 → 2.14.0

package/cli/index.cjs

@@ -1,5 +1,5 @@
 /*!
- Stencil CLI (CommonJS) v2.11.0 | MIT Licensed | https://stenciljs.com
+ Stencil CLI (CommonJS) v2.14.0 | MIT Licensed | https://stenciljs.com
  */
 'use strict';
 
@@ -33,6 +33,16 @@ const dashToPascalCase = (str) => toLowerCase(str)
 const isFunction = (v) => typeof v === 'function';
 const isString = (v) => typeof v === 'string';
 
+/**
+ * Builds a template `Diagnostic` entity for a build error. The created `Diagnostic` is returned, and have little
+ * detail attached to it regarding the specifics of the error - it is the responsibility of the caller of this method
+ * to attach the specifics of the error message.
+ *
+ * The created `Diagnostic` is pushed to the `diagnostics` argument as a side effect of calling this method.
+ *
+ * @param diagnostics the existing diagnostics that the created template `Diagnostic` should be added to
+ * @returns the created `Diagnostic`
+ */
 const buildError = (diagnostics) => {
     const diagnostic = {
         level: 'error',
@@ -48,6 +58,13 @@ const buildError = (diagnostics) => {
     }
     return diagnostic;
 };
+/**
+ * Builds a diagnostic from an `Error`, appends it to the `diagnostics` parameter, and returns the created diagnostic
+ * @param diagnostics the series of diagnostics the newly created diagnostics should be added to
+ * @param err the error to derive information from in generating the diagnostic
+ * @param msg an optional message to use in place of `err` to generate the diagnostic
+ * @returns the generated diagnostic
+ */
 const catchError = (diagnostics, err, msg) => {
     const diagnostic = {
         level: 'error',
@@ -59,7 +76,7 @@ const catchError = (diagnostics, err, msg) => {
         lines: [],
     };
     if (isString(msg)) {
-        diagnostic.messageText = msg;
+        diagnostic.messageText = msg.length ? msg : 'UNKNOWN ERROR';
     }
     else if (err != null) {
         if (err.stack != null) {
@@ -67,7 +84,7 @@ const catchError = (diagnostics, err, msg) => {
         }
         else {
             if (err.message != null) {
-                diagnostic.messageText = err.message.toString();
+                diagnostic.messageText = err.message.length ? err.message : 'UNKNOWN ERROR';
             }
             else {
                 diagnostic.messageText = err.toString();
@@ -79,6 +96,12 @@ const catchError = (diagnostics, err, msg) => {
     }
     return diagnostic;
 };
+/**
+ * Determine if the provided diagnostics have any build errors
+ * @param diagnostics the diagnostics to inspect
+ * @returns true if any of the diagnostics in the list provided are errors that did not occur at runtime. false
+ * otherwise.
+ */
 const hasError = (diagnostics) => {
     if (diagnostics == null || diagnostics.length === 0) {
         return false;
@@ -490,7 +513,7 @@ const getNpmConfigEnvArgs = (sys) => {
 const dependencies = [
 	{
 		name: "@stencil/core",
-		version: "2.11.0",
+		version: "2.14.0",
 		main: "compiler/stencil.js",
 		resources: [
 			"package.json",
@@ -540,6 +563,7 @@ const dependencies = [
 			"compiler/lib.es2020.symbol.wellknown.d.ts",
 			"compiler/lib.es2021.d.ts",
 			"compiler/lib.es2021.full.d.ts",
+			"compiler/lib.es2021.intl.d.ts",
 			"compiler/lib.es2021.promise.d.ts",
 			"compiler/lib.es2021.string.d.ts",
 			"compiler/lib.es2021.weakref.d.ts",
@@ -592,7 +616,7 @@ const dependencies = [
 	},
 	{
 		name: "typescript",
-		version: "4.3.5",
+		version: "4.5.4",
 		main: "lib/typescript.js"
 	}
 ];
@@ -1669,7 +1693,8 @@ const run = async (init) => {
     }
     catch (e) {
         if (!shouldIgnoreError(e)) {
-            logger.error(`uncaught cli error: ${e}${logger.getLevel() === 'debug' ? e.stack : ''}`);
+            const details = `${logger.getLevel() === 'debug' && e instanceof Error ? e.stack : ''}`;
+            logger.error(`uncaught cli error: ${e}${details}`);
             return sys.exit(1);
         }
     }
@@ -1689,7 +1714,7 @@ const runTask = async (coreCompiler, config, task, sys) => {
             await taskGenerate(coreCompiler, config);
             break;
         case 'help':
-            taskHelp(config, config.logger, sys);
+            await taskHelp(config, config.logger, sys);
             break;
         case 'prerender':
             await taskPrerender(coreCompiler, config);
@@ -1711,7 +1736,7 @@ const runTask = async (coreCompiler, config, task, sys) => {
             break;
         default:
             config.logger.error(`${config.logger.emoji('❌ ')}Invalid stencil command, please see the options below:`);
-            taskHelp(config, config.logger, sys);
+            await taskHelp(config, config.logger, sys);
             return config.sys.exit(1);
     }
 };

package/cli/index.js

@@ -1,5 +1,5 @@
 /*!
- Stencil CLI v2.11.0 | MIT Licensed | https://stenciljs.com
+ Stencil CLI v2.14.0 | MIT Licensed | https://stenciljs.com
  */
 const toLowerCase = (str) => str.toLowerCase();
 const dashToPascalCase = (str) => toLowerCase(str)
@@ -9,6 +9,16 @@ const dashToPascalCase = (str) => toLowerCase(str)
 const isFunction = (v) => typeof v === 'function';
 const isString = (v) => typeof v === 'string';
 
+/**
+ * Builds a template `Diagnostic` entity for a build error. The created `Diagnostic` is returned, and have little
+ * detail attached to it regarding the specifics of the error - it is the responsibility of the caller of this method
+ * to attach the specifics of the error message.
+ *
+ * The created `Diagnostic` is pushed to the `diagnostics` argument as a side effect of calling this method.
+ *
+ * @param diagnostics the existing diagnostics that the created template `Diagnostic` should be added to
+ * @returns the created `Diagnostic`
+ */
 const buildError = (diagnostics) => {
     const diagnostic = {
         level: 'error',
@@ -24,6 +34,13 @@ const buildError = (diagnostics) => {
     }
     return diagnostic;
 };
+/**
+ * Builds a diagnostic from an `Error`, appends it to the `diagnostics` parameter, and returns the created diagnostic
+ * @param diagnostics the series of diagnostics the newly created diagnostics should be added to
+ * @param err the error to derive information from in generating the diagnostic
+ * @param msg an optional message to use in place of `err` to generate the diagnostic
+ * @returns the generated diagnostic
+ */
 const catchError = (diagnostics, err, msg) => {
     const diagnostic = {
         level: 'error',
@@ -35,7 +52,7 @@ const catchError = (diagnostics, err, msg) => {
         lines: [],
     };
     if (isString(msg)) {
-        diagnostic.messageText = msg;
+        diagnostic.messageText = msg.length ? msg : 'UNKNOWN ERROR';
     }
     else if (err != null) {
         if (err.stack != null) {
@@ -43,7 +60,7 @@ const catchError = (diagnostics, err, msg) => {
         }
         else {
             if (err.message != null) {
-                diagnostic.messageText = err.message.toString();
+                diagnostic.messageText = err.message.length ? err.message : 'UNKNOWN ERROR';
             }
             else {
                 diagnostic.messageText = err.toString();
@@ -55,6 +72,12 @@ const catchError = (diagnostics, err, msg) => {
     }
     return diagnostic;
 };
+/**
+ * Determine if the provided diagnostics have any build errors
+ * @param diagnostics the diagnostics to inspect
+ * @returns true if any of the diagnostics in the list provided are errors that did not occur at runtime. false
+ * otherwise.
+ */
 const hasError = (diagnostics) => {
     if (diagnostics == null || diagnostics.length === 0) {
         return false;
@@ -466,7 +489,7 @@ const getNpmConfigEnvArgs = (sys) => {
 const dependencies = [
 	{
 		name: "@stencil/core",
-		version: "2.11.0",
+		version: "2.14.0",
 		main: "compiler/stencil.js",
 		resources: [
 			"package.json",
@@ -516,6 +539,7 @@ const dependencies = [
 			"compiler/lib.es2020.symbol.wellknown.d.ts",
 			"compiler/lib.es2021.d.ts",
 			"compiler/lib.es2021.full.d.ts",
+			"compiler/lib.es2021.intl.d.ts",
 			"compiler/lib.es2021.promise.d.ts",
 			"compiler/lib.es2021.string.d.ts",
 			"compiler/lib.es2021.weakref.d.ts",
@@ -568,7 +592,7 @@ const dependencies = [
 	},
 	{
 		name: "typescript",
-		version: "4.3.5",
+		version: "4.5.4",
 		main: "lib/typescript.js"
 	}
 ];
@@ -1645,7 +1669,8 @@ const run = async (init) => {
     }
     catch (e) {
         if (!shouldIgnoreError(e)) {
-            logger.error(`uncaught cli error: ${e}${logger.getLevel() === 'debug' ? e.stack : ''}`);
+            const details = `${logger.getLevel() === 'debug' && e instanceof Error ? e.stack : ''}`;
+            logger.error(`uncaught cli error: ${e}${details}`);
             return sys.exit(1);
         }
     }
@@ -1665,7 +1690,7 @@ const runTask = async (coreCompiler, config, task, sys) => {
             await taskGenerate(coreCompiler, config);
             break;
         case 'help':
-            taskHelp(config, config.logger, sys);
+            await taskHelp(config, config.logger, sys);
             break;
         case 'prerender':
             await taskPrerender(coreCompiler, config);
@@ -1687,7 +1712,7 @@ const runTask = async (coreCompiler, config, task, sys) => {
             break;
         default:
             config.logger.error(`${config.logger.emoji('❌ ')}Invalid stencil command, please see the options below:`);
-            taskHelp(config, config.logger, sys);
+            await taskHelp(config, config.logger, sys);
             return config.sys.exit(1);
     }
 };

package/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stencil/core/cli",
-  "version": "2.11.0",
+  "version": "2.14.0",
   "description": "Stencil CLI.",
   "main": "./index.cjs",
   "module": "./index.js",