@stencil/core 2.10.0 → 2.12.1

package/cli/index.cjs

@@ -1,5 +1,5 @@
 /*!
- Stencil CLI (CommonJS) v2.10.0 | MIT Licensed | https://stenciljs.com
+ Stencil CLI (CommonJS) v2.12.1 | 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',
@@ -79,6 +89,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;
@@ -230,6 +246,11 @@ const pathComponents = (path, rootLength) => {
     return [root, ...rest];
 };
 
+/**
+ * Validates that a component tag meets required naming conventions to be used for a web component
+ * @param tag the tag to validate
+ * @returns an error message if the tag has an invalid name, undefined if the tag name passes all checks
+ */
 const validateComponentTag = (tag) => {
     if (tag !== tag.trim()) {
         return `Tag can not contain white spaces`;
@@ -485,7 +506,7 @@ const getNpmConfigEnvArgs = (sys) => {
 const dependencies = [
 	{
 		name: "@stencil/core",
-		version: "2.10.0",
+		version: "2.12.1",
 		main: "compiler/stencil.js",
 		resources: [
 			"package.json",
@@ -1684,7 +1705,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);
@@ -1706,7 +1727,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.10.0 | MIT Licensed | https://stenciljs.com
+ Stencil CLI v2.12.1 | 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',
@@ -55,6 +65,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;
@@ -206,6 +222,11 @@ const pathComponents = (path, rootLength) => {
     return [root, ...rest];
 };
 
+/**
+ * Validates that a component tag meets required naming conventions to be used for a web component
+ * @param tag the tag to validate
+ * @returns an error message if the tag has an invalid name, undefined if the tag name passes all checks
+ */
 const validateComponentTag = (tag) => {
     if (tag !== tag.trim()) {
         return `Tag can not contain white spaces`;
@@ -461,7 +482,7 @@ const getNpmConfigEnvArgs = (sys) => {
 const dependencies = [
 	{
 		name: "@stencil/core",
-		version: "2.10.0",
+		version: "2.12.1",
 		main: "compiler/stencil.js",
 		resources: [
 			"package.json",
@@ -1660,7 +1681,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);
@@ -1682,7 +1703,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.10.0",
+  "version": "2.12.1",
   "description": "Stencil CLI.",
   "main": "./index.cjs",
   "module": "./index.js",

package/compiler/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stencil/core/compiler",
-  "version": "2.10.0",
+  "version": "2.12.1",
   "description": "Stencil Compiler.",
   "main": "./stencil.js",
   "types": "./stencil.d.ts",