@stencil/core 2.14.2 → 2.15.2

package/internal/hydrate/runner.js

@@ -655,7 +655,7 @@ const templateWindows = new Map, createHydrateBuildId = () => {
 }, commentre = /\/\*[^*]*\*+([^/*][^*]*\*+)*\//g, getCssSelectors = e => {
  SELECTORS.all.length = SELECTORS.tags.length = SELECTORS.classNames.length = SELECTORS.ids.length = SELECTORS.attrs.length = 0;
  const t = (e = e.replace(/\./g, " .").replace(/\#/g, " #").replace(/\[/g, " [").replace(/\>/g, " > ").replace(/\+/g, " + ").replace(/\~/g, " ~ ").replace(/\*/g, " * ").replace(/\:not\((.*?)\)/g, " ")).split(" ");
- for (let e = 0, r = t.length; e < r; e++) t[e] = t[e].split(":")[0], 0 !== t[e].length && ("." === t[e].charAt(0) ? SELECTORS.classNames.push(t[e].substr(1)) : "#" === t[e].charAt(0) ? SELECTORS.ids.push(t[e].substr(1)) : "[" === t[e].charAt(0) ? (t[e] = t[e].substr(1).split("=")[0].split("]")[0].trim(), 
+ for (let e = 0, r = t.length; e < r; e++) t[e] = t[e].split(":")[0], 0 !== t[e].length && ("." === t[e].charAt(0) ? SELECTORS.classNames.push(t[e].slice(1)) : "#" === t[e].charAt(0) ? SELECTORS.ids.push(t[e].slice(1)) : "[" === t[e].charAt(0) ? (t[e] = t[e].slice(1).split("=")[0].split("]")[0].trim(), 
  SELECTORS.attrs.push(t[e].toLowerCase())) : /[a-z]/g.test(t[e].charAt(0)) && SELECTORS.tags.push(t[e].toLowerCase()));
  return SELECTORS.classNames = SELECTORS.classNames.sort(((e, t) => e.length < t.length ? -1 : e.length > t.length ? 1 : 0)), 
  SELECTORS;

package/internal/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stencil/core/internal",
-  "version": "2.14.2",
+  "version": "2.15.2",
   "description": "Stencil internals only to be imported by the Stencil Compiler. Breaking changes can and will happen at any time.",
   "main": "./index.js",
   "types": "./index.d.ts",

package/internal/stencil-private.d.ts

@@ -708,11 +708,29 @@ export interface ComponentCompilerPropertyComplexType {
     resolved: string;
     references: ComponentCompilerTypeReferences;
 }
-export interface ComponentCompilerTypeReferences {
-    [key: string]: ComponentCompilerTypeReference;
-}
+/**
+ * A record of `ComponentCompilerTypeReference` entities.
+ *
+ * Each key in this record is intended to be the names of the types used by a component. However, this is not enforced
+ * by the type system (I.E. any string can be used as a key).
+ *
+ * Note any key can be a user defined type or a TypeScript standard type.
+ */
+export declare type ComponentCompilerTypeReferences = Record<string, ComponentCompilerTypeReference>;
+/**
+ * Describes a reference to a type used by a component.
+ */
 export interface ComponentCompilerTypeReference {
+    /**
+     * A type may be defined:
+     * - locally (in the same file as the component that uses it)
+     * - globally
+     * - by importing it into a file (and is defined elsewhere)
+     */
     location: 'local' | 'global' | 'import';
+    /**
+     * The path to the type reference, if applicable (global types should not need a path associated with them)
+     */
     path?: string;
 }
 export interface ComponentCompilerStaticEvent {
@@ -2087,11 +2105,29 @@ export interface NewSpecPageOptions {
     attachStyles?: boolean;
     strictBuild?: boolean;
 }
+/**
+ * A record of `TypesMemberNameData` entities.
+ *
+ * Each key in this record is intended to be the path to a file that declares one or more types used by a component.
+ * However, this is not enforced by the type system - users of this interface should not make any assumptions regarding
+ * the format of the path used as a key (relative vs. absolute)
+ */
 export interface TypesImportData {
     [key: string]: TypesMemberNameData[];
 }
+/**
+ * A type describing how Stencil may alias an imported type to avoid naming collisions when performing operations such
+ * as generating `components.d.ts` files.
+ */
 export interface TypesMemberNameData {
+    /**
+     * The name of the type as it's used within a file.
+     */
     localName: string;
+    /**
+     * An alias that Stencil may apply to the `localName` to avoid naming collisions. This name does not appear in the
+     * file that is using `localName`.
+     */
     importName?: string;
 }
 export interface TypesModule {

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

@@ -43,7 +43,7 @@ export interface StencilConfig {
      * However, it's still common to have styles which should be "global" across all components and the website.
      * A global CSS file is often useful to set CSS Variables.
      *
-     * Additonally, the globalStyle config can be used to precompile styles with Sass, PostCss, etc.
+     * Additionally, the globalStyle config can be used to precompile styles with Sass, PostCss, etc.
      * Below is an example folder structure containing a webapp's global sass file, named app.css.
      */
     globalStyle?: string;
@@ -102,7 +102,7 @@ export interface StencilConfig {
      */
     nodeResolve?: NodeResolveConfig;
     /**
-     * Passes custom configuration down to rollup itself, not all rollup options can be overriden.
+     * Passes custom configuration down to rollup itself, not all rollup options can be overridden.
      */
     rollupConfig?: RollupConfig;
     /**
@@ -145,14 +145,14 @@ export interface StencilConfig {
      * The hydrated flag identifies if a component and all of its child components
      * have finished hydrating. This helps prevent any flash of unstyled content (FOUC)
      * as various components are asynchronously downloaded and rendered. By default it
-     * will add the `hydrated` CSS class to the element. The `hydratedFlag` confg can be used
+     * will add the `hydrated` CSS class to the element. The `hydratedFlag` config can be used
      * to change the name of the CSS class, change it to an attribute, or change which
      * type of CSS properties and values are assigned before and after hydrating. This config
      * can also be used to not include the hydrated flag at all by setting it to `null`.
      */
     hydratedFlag?: HydratedFlag;
     /**
-     * Ionic perfers to hide all components prior to hydration with a style tag appended
+     * Ionic prefers to hide all components prior to hydration with a style tag appended
      * to the head of the document containing some `visibility: hidden;` css rules.
      *
      * Disabling this will remove the style tag that sets `visibility: hidden;` on all
@@ -178,11 +178,11 @@ export interface StencilConfig {
      * - `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
-     *   also introduce unnecesary reflows in some cases, especially during startup. `congestionAsync`
-     *   is ideal for apps running animations while also simultaniously executing intesive tasks
+     *   also introduce unnecessary reflows in some cases, especially during startup. `congestionAsync`
+     *   is ideal for apps running animations while also simultaneously executing intensive tasks
      *   which may lock-up the main thread.
      *
-     * - `immediate`: Makes writeTask() and readTask() callbacks to be executed syncronously. Tasks
+     * - `immediate`: Makes writeTask() and readTask() callbacks to be executed synchronously. 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
      *   animations. Like the async setting, if the app has intensive tasks causing the main thread
@@ -229,7 +229,7 @@ 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 when using `element.appendChild(node)` and expecting the
-     * child to be appended in the same location shadom dom would. This is not required for
+     * child to be appended in the same location shadow 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;
@@ -432,7 +432,7 @@ export interface StencilDevServerConfig {
      */
     ssr?: boolean;
     /**
-     * If the dev server fails to start up within the given timout (in milliseconds), the startup will
+     * If the dev server fails to start up within the given timeout (in milliseconds), the startup will
      * be canceled. Set to zero to disable the timeout. Defaults to `15000`.
      */
     startupTimeout?: number;
@@ -722,7 +722,7 @@ export interface SerializeDocumentOptions extends HydrateDocumentOptions {
      * Sets an approximate line width the HTML should attempt to stay within.
      * Note that this is "approximate", in that HTML may often not be able
      * to be split at an exact line width. Additionally, new lines created
-     * is where HTML naturally already has whitespce, such as before an
+     * is where HTML naturally already has whitespace, such as before an
      * attribute or spaces between words. Defaults to `100`.
      */
     approximateLineWidth?: number;
@@ -823,7 +823,7 @@ export interface SitemapXmpResults {
  * build all actions the in-memory fs performed will be written to disk using this system.
  * A NodeJS based system will use APIs such as `fs` and `crypto`, and a web-based system
  * will use in-memory Maps and browser APIs. Either way, the compiler itself is unaware
- * of the actual platform it's being ran ontop of.
+ * of the actual platform it's being ran on top of.
  */
 export interface CompilerSystem {
     name: 'node' | 'in-memory';
@@ -872,7 +872,7 @@ export interface CompilerSystem {
      */
     isTTY(): boolean;
     /**
-     * Each plaform as a different way to dynamically import modules.
+     * Each platform as a different way to dynamically import modules.
      */
     dynamicImport?(p: string): Promise<any>;
     /**
@@ -1553,7 +1553,7 @@ export interface TestingConfig extends JestConfig {
     browserSlowMo?: number;
     /**
      * By default, all E2E pages wait until the "load" event, this global setting can be used
-     * to change the default `waitUntil` behaviour.
+     * to change the default `waitUntil` behavior.
      */
     browserWaitUntil?: 'load' | 'domcontentloaded' | 'networkidle0' | 'networkidle2';
     /**
@@ -1665,6 +1665,7 @@ export interface OutputTargetDist extends OutputTargetBase {
 }
 export interface OutputTargetDistCollection extends OutputTargetBase {
     type: 'dist-collection';
+    empty?: boolean;
     dir: string;
     collectionDir: string;
 }
@@ -1685,6 +1686,7 @@ export interface OutputTargetDistLazy extends OutputTargetBase {
     esmIndexFile?: string;
     cjsIndexFile?: string;
     systemLoaderFile?: string;
+    legacyLoaderFile?: string;
     empty?: boolean;
 }
 export interface OutputTargetDistGlobalStyles extends OutputTargetBase {
@@ -1695,7 +1697,7 @@ export interface OutputTargetDistLazyLoader extends OutputTargetBase {
     type: 'dist-lazy-loader';
     dir: string;
     esmDir: string;
-    esmEs5Dir: string;
+    esmEs5Dir?: string;
     cjsDir: string;
     componentDts: string;
     empty: boolean;
@@ -1763,6 +1765,10 @@ export interface OutputTargetDistCustomElements extends OutputTargetBaseNext {
      * children, etc. Users of this flag should be aware that enabling this functionality may increase bundle size.
      */
     autoDefineCustomElements?: boolean;
+    /**
+     * Enables the generation of type definition files for the output target.
+     */
+    generateTypeDeclarations?: boolean;
 }
 export interface OutputTargetDistCustomElementsBundle extends OutputTargetBaseNext {
     type: 'dist-custom-elements-bundle';
@@ -1840,7 +1846,7 @@ export interface OutputTargetWww extends OutputTargetBase {
     baseUrl?: string;
     /**
      * By default, stencil will include all the polyfills required by legacy browsers in the ES5 build.
-     * If it's `false`, stencil will not emit this polyfills anymore and it's your responsability to provide them before
+     * If it's `false`, stencil will not emit this polyfills anymore and it's your responsibility to provide them before
      * stencil initializes.
      */
     polyfills?: boolean;

package/internal/testing/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stencil/core/internal/testing",
-  "version": "2.14.2",
+  "version": "2.15.2",
   "description": "Stencil internal testing platform to be imported by the Stencil Compiler. Breaking changes can and will happen at any time.",
   "main": "./index.js",
   "private": true

package/mock-doc/index.cjs

@@ -1,5 +1,5 @@
 /*!
- Stencil Mock Doc (CommonJS) v2.14.2 | MIT Licensed | https://stenciljs.com
+ Stencil Mock Doc (CommonJS) v2.15.2 | MIT Licensed | https://stenciljs.com
  */
 var mockDoc = (function(exports) {
 'use strict';
@@ -381,7 +381,7 @@ function toDataAttribute(str) {
       .toLowerCase());
 }
 function dashToPascalCase(str) {
-  str = String(str).substr(5);
+  str = String(str).slice(5);
   return str
     .split('-')
     .map((segment, index) => {
@@ -585,7 +585,7 @@ function cssCaseToJsCase(str) {
       .split('-')
       .map((segment) => segment.charAt(0).toUpperCase() + segment.slice(1))
       .join('');
-    str = str.substr(0, 1).toLowerCase() + str.substr(1);
+    str = str.slice(0, 1).toLowerCase() + str.slice(1);
   }
   return str;
 }
@@ -3165,6 +3165,15 @@ class MockResponse {
   }
 }
 
+class MockDOMParser {
+  parseFromString(htmlToParse, mimeType) {
+    if (mimeType !== 'text/html') {
+      console.error('XML parsing not implemented yet, continuing as html');
+    }
+    return parseHtmlToDocument(htmlToParse);
+  }
+}
+
 function setupGlobal(gbl) {
   if (gbl.window == null) {
     const win = (gbl.window = new MockWindow());
@@ -3294,6 +3303,7 @@ const GLOBAL_CONSTRUCTORS = [
   ['MouseEvent', MockMouseEvent],
   ['Request', MockRequest],
   ['Response', MockResponse],
+  ['DOMParser', MockDOMParser],
   ['HTMLAnchorElement', MockAnchorElement],
   ['HTMLBaseElement', MockBaseElement],
   ['HTMLButtonElement', MockButtonElement],

package/mock-doc/index.d.ts

@@ -624,6 +624,10 @@ declare function parseHtmlToDocument(html: string, ownerDocument?: MockDocument)
 declare function parseHtmlToFragment(html: string, ownerDocument?: MockDocument): any;
 declare function parseDocumentUtil(ownerDocument: any, html: string): any;
 declare function parseFragmentUtil(ownerDocument: any, html: string): any;
+declare type DOMParserSupportedType = 'text/html' | 'text/xml' | 'application/xml' | 'application/xhtml+xml' | 'image/svg+xml';
+declare class MockDOMParser {
+  parseFromString(htmlToParse: string, mimeType: DOMParserSupportedType): MockDocument;
+}
 /**
  * https://developer.mozilla.org/en-US/docs/Web/API/Performance
  */

package/mock-doc/index.js

@@ -1,5 +1,5 @@
 /*!
- Stencil Mock Doc v2.14.2 | MIT Licensed | https://stenciljs.com
+ Stencil Mock Doc v2.15.2 | MIT Licensed | https://stenciljs.com
  */
 const CONTENT_REF_ID = 'r';
 const ORG_LOCATION_ID = 'o';
@@ -378,7 +378,7 @@ function toDataAttribute(str) {
       .toLowerCase());
 }
 function dashToPascalCase(str) {
-  str = String(str).substr(5);
+  str = String(str).slice(5);
   return str
     .split('-')
     .map((segment, index) => {
@@ -582,7 +582,7 @@ function cssCaseToJsCase(str) {
       .split('-')
       .map((segment) => segment.charAt(0).toUpperCase() + segment.slice(1))
       .join('');
-    str = str.substr(0, 1).toLowerCase() + str.substr(1);
+    str = str.slice(0, 1).toLowerCase() + str.slice(1);
   }
   return str;
 }
@@ -3162,6 +3162,15 @@ class MockResponse {
   }
 }
 
+class MockDOMParser {
+  parseFromString(htmlToParse, mimeType) {
+    if (mimeType !== 'text/html') {
+      console.error('XML parsing not implemented yet, continuing as html');
+    }
+    return parseHtmlToDocument(htmlToParse);
+  }
+}
+
 function setupGlobal(gbl) {
   if (gbl.window == null) {
     const win = (gbl.window = new MockWindow());
@@ -3291,6 +3300,7 @@ const GLOBAL_CONSTRUCTORS = [
   ['MouseEvent', MockMouseEvent],
   ['Request', MockRequest],
   ['Response', MockResponse],
+  ['DOMParser', MockDOMParser],
   ['HTMLAnchorElement', MockAnchorElement],
   ['HTMLBaseElement', MockBaseElement],
   ['HTMLButtonElement', MockButtonElement],

package/mock-doc/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stencil/core/mock-doc",
-  "version": "2.14.2",
+  "version": "2.15.2",
   "description": "Mock window, document and DOM outside of a browser environment.",
   "main": "./index.cjs",
   "module": "./index.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stencil/core",
-  "version": "2.14.2",
+  "version": "2.15.2",
   "license": "MIT",
   "main": "./internal/stencil-core/index.cjs",
   "module": "./internal/stencil-core/index.js",
@@ -10,6 +10,8 @@
   },
   "files": [
     "!**/*.map",
+    "!**/*.stub.ts",
+    "!**/*.stub.tsx",
     "bin/",
     "cli/",
     "compiler/",
@@ -39,7 +41,7 @@
     "rollup.watch": "rollup --watch --config",
     "license": "node scripts --license",
     "prettier": "npm run prettier.base -- --write",
-    "prettier.base": "prettier \"./{bin,scripts,src,test}/**/*.{ts,tsx,js,jsx}\"",
+    "prettier.base": "prettier \"./({bin,scripts,src,test}/**/*.{ts,tsx,js,jsx})|bin/stencil\"",
     "prettier.dry-run": "npm run prettier.base -- --list-different",
     "test": "jest --coverage",
     "test.analysis": "cd test && npm run analysis.build-and-analyze",
@@ -49,7 +51,6 @@
     "test.karma": "cd test/karma && npm ci && npm run karma",
     "test.karma.prod": "cd test/karma && npm ci && npm run karma.prod",
     "test.testing": "node scripts/test/validate-testing.js",
-    "test.sys.node": "echo test.sys.node",
     "test.prod": "npm run test.dist && npm run test.end-to-end && npm run test.jest && npm run test.karma && npm run test.sys.node && npm run test.testing && npm run test.analysis",
     "test.watch": "jest --watch",
     "test.watch-all": "jest --watchAll --coverage"
@@ -106,7 +107,7 @@
     "merge-source-map": "^1.1.0",
     "mime-db": "^1.46.0",
     "minimatch": "3.0.4",
-    "node-fetch": "2.6.1",
+    "node-fetch": "2.6.7",
     "open": "8.2.1",
     "open-in-editor": "2.2.0",
     "parse5": "6.0.1",
@@ -118,7 +119,6 @@
     "puppeteer": "~10.0.0",
     "rollup": "2.42.3",
     "rollup-plugin-sourcemaps": "^0.6.3",
-    "semiver": "^1.1.0",
     "semver": "7.3.4",
     "sizzle": "^2.3.6",
     "terser": "5.6.1",

package/screenshot/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stencil/core/screenshot",
-  "version": "2.14.2",
+  "version": "2.15.2",
   "description": "Stencil Screenshot.",
   "main": "./index.js",
   "types": "./index.d.ts",