@stencil/core 2.17.0 → 2.17.2

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

@@ -1,5 +1,6 @@
 import type { JsonDocs } from './stencil-public-docs';
 import type { PrerenderUrlResults } from '../internal';
+import type { ConfigFlags } from '../cli/config-flags';
 export * from './stencil-public-docs';
 /**
  * https://stenciljs.com/docs/config/
@@ -356,6 +357,29 @@ declare type Loose<T extends Object> = Record<string, any> & Partial<T>;
  * and have type information carry though as we construct an object which is a valid `Config`.
  */
 export declare type UnvalidatedConfig = Loose<Config>;
+/**
+ * Helper type to strip optional markers from keys in a type, while preserving other type information for the key.
+ * This type takes a union of keys, K, in type T to allow for the type T to be gradually updated.
+ *
+ * ```typescript
+ * type Foo { bar?: number, baz?: string }
+ * type ReqFieldFoo = RequireFields<Foo, 'bar'>; // { bar: number, baz?: string }
+ * ```
+ */
+declare type RequireFields<T, K extends keyof T> = T & {
+    [P in K]-?: T[P];
+};
+/**
+ * Fields in {@link Config} to make required for {@link ValidatedConfig}
+ */
+declare type StrictConfigFields = 'flags' | 'logger' | 'outputTargets' | 'sys';
+/**
+ * A version of {@link Config} that makes certain fields required. This type represents a valid configuration entity.
+ * When a configuration is received by the user, it is a bag of unverified data. In order to make stricter guarantees
+ * about the data from a type-safety perspective, this type is intended to be used throughout the codebase once
+ * validations have occurred at runtime.
+ */
+export declare type ValidatedConfig = RequireFields<Config, StrictConfigFields>;
 export interface HydratedFlag {
     /**
      * Defaults to `hydrated`.
@@ -505,51 +529,6 @@ export interface DevServerEditor {
     supported?: boolean;
     priority?: number;
 }
-export interface ConfigFlags {
-    task?: TaskCommand;
-    args?: string[];
-    knownArgs?: string[];
-    unknownArgs?: string[];
-    address?: string;
-    build?: boolean;
-    cache?: boolean;
-    checkVersion?: boolean;
-    ci?: boolean;
-    compare?: boolean;
-    config?: string;
-    debug?: boolean;
-    dev?: boolean;
-    docs?: boolean;
-    docsApi?: string;
-    docsJson?: string;
-    e2e?: boolean;
-    emulate?: string;
-    es5?: boolean;
-    esm?: boolean;
-    headless?: boolean;
-    help?: boolean;
-    log?: boolean;
-    logLevel?: LogLevel;
-    verbose?: boolean;
-    maxWorkers?: number;
-    open?: boolean;
-    port?: number;
-    prerender?: boolean;
-    prod?: boolean;
-    profile?: boolean;
-    root?: string;
-    screenshot?: boolean;
-    screenshotConnector?: string;
-    serve?: boolean;
-    serviceWorker?: boolean;
-    spec?: boolean;
-    ssr?: boolean;
-    stats?: boolean;
-    updateScreenshot?: boolean;
-    version?: boolean;
-    watch?: boolean;
-    devtools?: boolean;
-}
 export declare type TaskCommand = 'build' | 'docs' | 'generate' | 'g' | 'help' | 'info' | 'prerender' | 'serve' | 'telemetry' | 'test' | 'version';
 export declare type PageReloadStrategy = 'hmr' | 'pageReload' | null;
 /**
@@ -1653,7 +1632,29 @@ export interface EmulateViewport {
      */
     isLandscape?: boolean;
 }
-export declare type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+/**
+ * This sets the log level hierarchy for our terminal logger, ranging from
+ * most to least verbose.
+ *
+ * Ordering the levels like this lets us easily check whether we should log a
+ * message at a given time. For instance, if the log level is set to `'warn'`,
+ * then anything passed to the logger with level `'warn'` or `'error'` should
+ * be logged, but we should _not_ log anything with level `'info'` or `'debug'`.
+ *
+ * If we have a current log level `currentLevel` and a message with level
+ * `msgLevel` is passed to the logger, we can determine whether or not we should
+ * log it by checking if the log level on the message is further up or at the
+ * same level in the hierarchy than `currentLevel`, like so:
+ *
+ * ```ts
+ * LOG_LEVELS.indexOf(msgLevel) >= LOG_LEVELS.indexOf(currentLevel)
+ * ```
+ *
+ * NOTE: for the reasons described above, do not change the order of the entries
+ * in this array without good reason!
+ */
+export declare const LOG_LEVELS: readonly ["debug", "info", "warn", "error"];
+export declare type LogLevel = typeof LOG_LEVELS[number];
 /**
  * Common logger to be used by the compiler, dev-server and CLI. The CLI will use a
  * NodeJS based console logging and colors, and the web will use browser based
@@ -1980,7 +1981,7 @@ export interface LoadConfigInit {
  * operations around the codebase.
  */
 export interface LoadConfigResults {
-    config: UnvalidatedConfig;
+    config: ValidatedConfig;
     diagnostics: Diagnostic[];
     tsconfig: {
         path: string;
@@ -2048,14 +2049,32 @@ export interface PrerenderResults {
     duration: number;
     average: number;
 }
+/**
+ * Input for CSS optimization functions, including the input CSS
+ * string and a few boolean options which turn on or off various
+ * optimizations.
+ */
 export interface OptimizeCssInput {
     input: string;
     filePath?: string;
-    autoprefixer?: any;
+    autoprefixer?: boolean | null | AutoprefixerOptions;
     minify?: boolean;
     sourceMap?: boolean;
     resolveUrl?: (url: string) => Promise<string> | string;
 }
+/**
+ * This is not a real interface describing the options which can
+ * be passed to autoprefixer, for that see the docs, here:
+ * https://github.com/postcss/autoprefixer#options
+ *
+ * Instead, this basically just serves as a label type to track
+ * that arguments are being passed consistently.
+ */
+export declare type AutoprefixerOptions = Object;
+/**
+ * Output from CSS optimization functions, wrapping up optimized
+ * CSS and any diagnostics produced during optimization.
+ */
 export interface OptimizeCssOutput {
     output: string;
     diagnostics: Diagnostic[];

package/internal/testing/index.js

@@ -1089,5 +1089,5 @@ exports.setMode = e => modeResolutionChain.push(e), exports.setPlatformHelpers =
   }), 100));
  }));
 }, exports.stopAutoApplyChanges = stopAutoApplyChanges, exports.styles = styles, 
-exports.supportsConstructibleStylesheets = !1, exports.supportsListenerOptions = !0, 
+exports.supportsConstructableStylesheets = !1, exports.supportsListenerOptions = !0, 
 exports.win = win, exports.writeTask = writeTask;

package/internal/testing/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stencil/core/internal/testing",
-  "version": "2.17.0",
+  "version": "2.17.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.17.0 | MIT Licensed | https://stenciljs.com
+ Stencil Mock Doc (CommonJS) v2.17.2 | MIT Licensed | https://stenciljs.com
  */
 var mockDoc = (function(exports) {
 'use strict';
@@ -689,6 +689,25 @@ class MockMouseEvent extends MockEvent {
     }
   }
 }
+class MockUIEvent extends MockEvent {
+  constructor(type, uiEventInitDic) {
+    super(type);
+    this.detail = null;
+    this.view = null;
+    if (uiEventInitDic != null) {
+      Object.assign(this, uiEventInitDic);
+    }
+  }
+}
+class MockFocusEvent extends MockUIEvent {
+  constructor(type, focusEventInitDic) {
+    super(type);
+    this.relatedTarget = null;
+    if (focusEventInitDic != null) {
+      Object.assign(this, focusEventInitDic);
+    }
+  }
+}
 class MockEventListener {
   constructor(type, handler) {
     this.type = type;
@@ -1602,7 +1621,7 @@ class MockElement extends MockNode {
     return shadowRoot;
   }
   blur() {
-    /**/
+    dispatchEvent(this, new MockFocusEvent('blur', { relatedTarget: null, bubbles: true, cancelable: true, composed: true }));
   }
   get shadowRoot() {
     return this.__shadowRoot || null;
@@ -1672,7 +1691,9 @@ class MockElement extends MockNode {
   get firstElementChild() {
     return this.children[0] || null;
   }
-  focus(_options) { }
+  focus(_options) {
+    dispatchEvent(this, new MockFocusEvent('focus', { relatedTarget: null, bubbles: true, cancelable: true, composed: true }));
+  }
   getAttribute(attrName) {
     if (attrName === 'style') {
       if (this.__style != null && this.__style.length > 0) {
@@ -2017,6 +2038,9 @@ class MockElement extends MockNode {
   set title(value) {
     this.setAttributeNS(null, 'title', value);
   }
+  animate() {
+    /**/
+  }
   onanimationstart() {
     /**/
   }
@@ -2281,6 +2305,18 @@ class MockElement extends MockNode {
   onwheel() {
     /**/
   }
+  requestFullscreen() {
+    /**/
+  }
+  scrollBy() {
+    /**/
+  }
+  scrollTo() {
+    /**/
+  }
+  scrollIntoView() {
+    /**/
+  }
   toString(opts) {
     return serializeNodeToHtml(this, opts);
   }
@@ -3431,6 +3467,7 @@ const WINDOW_PROPS = [
   'HTMLElement',
   'Node',
   'NodeList',
+  'FocusEvent',
   'KeyboardEvent',
   'MouseEvent',
 ];
@@ -3438,6 +3475,7 @@ const GLOBAL_CONSTRUCTORS = [
   ['CustomEvent', MockCustomEvent],
   ['Event', MockEvent],
   ['Headers', MockHeaders],
+  ['FocusEvent', MockFocusEvent],
   ['KeyboardEvent', MockKeyboardEvent],
   ['MouseEvent', MockMouseEvent],
   ['Request', MockRequest],

package/mock-doc/index.d.ts

@@ -386,6 +386,15 @@ declare class MockMouseEvent extends MockEvent {
   relatedTarget: EventTarget;
   constructor(type: string, mouseEventInitDic?: MouseEventInit);
 }
+declare class MockUIEvent extends MockEvent {
+  detail: number | null;
+  view: MockWindow | null;
+  constructor(type: string, uiEventInitDic?: UIEventInit);
+}
+declare class MockFocusEvent extends MockUIEvent {
+  relatedTarget: EventTarget | null;
+  constructor(type: 'blur' | 'focus', focusEventInitDic?: FocusEventInit);
+}
 declare class MockEventListener {
   type: string;
   handler: (ev?: any) => void;
@@ -588,6 +597,7 @@ declare class MockElement extends MockNode {
   set textContent(value: string);
   get title(): string;
   set title(value: string);
+  animate(): void;
   onanimationstart(): void;
   onanimationend(): void;
   onanimationiteration(): void;
@@ -676,6 +686,10 @@ declare class MockElement extends MockNode {
   onwebkitfullscreenchange(): void;
   onwebkitfullscreenerror(): void;
   onwheel(): void;
+  requestFullscreen(): void;
+  scrollBy(): void;
+  scrollTo(): void;
+  scrollIntoView(): void;
   toString(opts?: SerializeNodeToHtmlOptions): string;
 }
 declare function resetElement(elm: MockElement): void;
@@ -833,6 +847,7 @@ declare class MockWindow {
   CustomEvent: typeof MockCustomEvent;
   Event: typeof MockEvent;
   Headers: typeof MockHeaders;
+  FocusEvent: typeof MockFocusEvent;
   KeyboardEvent: typeof MockKeyboardEvent;
   MouseEvent: typeof MockMouseEvent;
   constructor(html?: string | boolean);

package/mock-doc/index.js

@@ -1,5 +1,5 @@
 /*!
- Stencil Mock Doc v2.17.0 | MIT Licensed | https://stenciljs.com
+ Stencil Mock Doc v2.17.2 | MIT Licensed | https://stenciljs.com
  */
 const CONTENT_REF_ID = 'r';
 const ORG_LOCATION_ID = 'o';
@@ -686,6 +686,25 @@ class MockMouseEvent extends MockEvent {
     }
   }
 }
+class MockUIEvent extends MockEvent {
+  constructor(type, uiEventInitDic) {
+    super(type);
+    this.detail = null;
+    this.view = null;
+    if (uiEventInitDic != null) {
+      Object.assign(this, uiEventInitDic);
+    }
+  }
+}
+class MockFocusEvent extends MockUIEvent {
+  constructor(type, focusEventInitDic) {
+    super(type);
+    this.relatedTarget = null;
+    if (focusEventInitDic != null) {
+      Object.assign(this, focusEventInitDic);
+    }
+  }
+}
 class MockEventListener {
   constructor(type, handler) {
     this.type = type;
@@ -1599,7 +1618,7 @@ class MockElement extends MockNode {
     return shadowRoot;
   }
   blur() {
-    /**/
+    dispatchEvent(this, new MockFocusEvent('blur', { relatedTarget: null, bubbles: true, cancelable: true, composed: true }));
   }
   get shadowRoot() {
     return this.__shadowRoot || null;
@@ -1669,7 +1688,9 @@ class MockElement extends MockNode {
   get firstElementChild() {
     return this.children[0] || null;
   }
-  focus(_options) { }
+  focus(_options) {
+    dispatchEvent(this, new MockFocusEvent('focus', { relatedTarget: null, bubbles: true, cancelable: true, composed: true }));
+  }
   getAttribute(attrName) {
     if (attrName === 'style') {
       if (this.__style != null && this.__style.length > 0) {
@@ -2014,6 +2035,9 @@ class MockElement extends MockNode {
   set title(value) {
     this.setAttributeNS(null, 'title', value);
   }
+  animate() {
+    /**/
+  }
   onanimationstart() {
     /**/
   }
@@ -2278,6 +2302,18 @@ class MockElement extends MockNode {
   onwheel() {
     /**/
   }
+  requestFullscreen() {
+    /**/
+  }
+  scrollBy() {
+    /**/
+  }
+  scrollTo() {
+    /**/
+  }
+  scrollIntoView() {
+    /**/
+  }
   toString(opts) {
     return serializeNodeToHtml(this, opts);
   }
@@ -3428,6 +3464,7 @@ const WINDOW_PROPS = [
   'HTMLElement',
   'Node',
   'NodeList',
+  'FocusEvent',
   'KeyboardEvent',
   'MouseEvent',
 ];
@@ -3435,6 +3472,7 @@ const GLOBAL_CONSTRUCTORS = [
   ['CustomEvent', MockCustomEvent],
   ['Event', MockEvent],
   ['Headers', MockHeaders],
+  ['FocusEvent', MockFocusEvent],
   ['KeyboardEvent', MockKeyboardEvent],
   ['MouseEvent', MockMouseEvent],
   ['Request', MockRequest],

package/mock-doc/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stencil/core/mock-doc",
-  "version": "2.17.0",
+  "version": "2.17.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.17.0",
+  "version": "2.17.2",
   "license": "MIT",
   "main": "./internal/stencil-core/index.cjs",
   "module": "./internal/stencil-core/index.js",
@@ -98,6 +98,7 @@
     "dts-bundle-generator": "~5.3.0",
     "eslint": "^8.13.0",
     "eslint-config-prettier": "^8.5.0",
+    "eslint-plugin-jest": "^26.5.3",
     "eslint-plugin-jsdoc": "^39.3.1",
     "execa": "4.1.0",
     "exit": "^0.1.2",

package/screenshot/package.json

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

package/sys/node/index.js

@@ -1,5 +1,5 @@
 /*!
- Stencil Node System v2.17.0 | MIT Licensed | https://stenciljs.com
+ Stencil Node System v2.17.2 | MIT Licensed | https://stenciljs.com
  */
 function _interopDefaultLegacy(e) {
  return e && "object" == typeof e && "default" in e ? e : {
@@ -274,7 +274,7 @@ Object.defineProperty(exports, "__esModule", {
  value: !0
 });
 
-const fs = require("./graceful-fs.js"), path = require("path"), require$$1 = require("util"), glob = require("./glob.js"), require$$6 = require("os"), require$$3 = require("crypto"), require$$2 = require("fs"), require$$4 = require("stream"), require$$5 = require("assert"), require$$7 = require("events"), require$$8 = require("buffer"), require$$9 = require("tty"), cp = require("child_process"), fs__default = _interopDefaultLegacy(fs), path__default = _interopDefaultLegacy(path), require$$1__default = _interopDefaultLegacy(require$$1), glob__default = _interopDefaultLegacy(glob), require$$6__default = _interopDefaultLegacy(require$$6), require$$6__namespace = _interopNamespace(require$$6), require$$3__default = _interopDefaultLegacy(require$$3), require$$2__default = _interopDefaultLegacy(require$$2), require$$4__default = _interopDefaultLegacy(require$$4), require$$5__default = _interopDefaultLegacy(require$$5), require$$7__default = _interopDefaultLegacy(require$$7), require$$8__default = _interopDefaultLegacy(require$$8), require$$9__default = _interopDefaultLegacy(require$$9), cp__namespace = _interopNamespace(cp);
+const fs = require("./graceful-fs.js"), path = require("path"), require$$1 = require("util"), glob = require("./glob.js"), require$$6 = require("os"), require$$3 = require("crypto"), require$$2 = require("fs"), require$$4 = require("stream"), require$$5 = require("assert"), require$$7 = require("events"), require$$8 = require("buffer"), require$$9 = require("tty"), cp = require("child_process"), fs__default = _interopDefaultLegacy(fs), path__default = _interopDefaultLegacy(path), require$$1__default = _interopDefaultLegacy(require$$1), glob__default = _interopDefaultLegacy(glob), require$$6__default = _interopDefaultLegacy(require$$6), require$$6__namespace = _interopNamespace(require$$6), require$$3__default = _interopDefaultLegacy(require$$3), require$$2__default = _interopDefaultLegacy(require$$2), require$$4__default = _interopDefaultLegacy(require$$4), require$$5__default = _interopDefaultLegacy(require$$5), require$$7__default = _interopDefaultLegacy(require$$7), require$$8__default = _interopDefaultLegacy(require$$8), require$$9__default = _interopDefaultLegacy(require$$9), cp__namespace = _interopNamespace(cp), LOG_LEVELS = [ "debug", "info", "warn", "error" ];
 
 symbols = createCommonjsModule((function(e) {
  const t = "Hyper" === process.env.TERM_PROGRAM, r = "win32" === process.platform, n = "linux" === process.platform, i = {
@@ -607,7 +607,7 @@ const createTerminalLogger = e => {
   red: ansiColors.red,
   yellow: ansiColors.yellow
  };
-}, LOG_LEVELS = [ "debug", "info", "warn", "error" ], shouldLog = (e, t) => LOG_LEVELS.indexOf(t) >= LOG_LEVELS.indexOf(e), formatPrefixTimestamp = () => {
+}, shouldLog = (e, t) => LOG_LEVELS.indexOf(t) >= LOG_LEVELS.indexOf(e), formatPrefixTimestamp = () => {
  const e = new Date;
  return `[${clampTwoDigits(e.getMinutes())}:${clampTwoDigits(e.getSeconds())}.${Math.floor(e.getMilliseconds() / 1e3 * 10)}]`;
 }, clampTwoDigits = e => ("0" + e.toString()).slice(-2), wordWrap = (e, t) => {
@@ -5632,7 +5632,7 @@ exports.createNodeLogger = e => {
    getColumns: () => {
     var t, r;
     const n = null !== (r = null === (t = null == e ? void 0 : e.stdout) || void 0 === t ? void 0 : t.columns) && void 0 !== r ? r : 80;
-    return Math.max(Math.min(120, n), 60);
+    return Math.max(Math.min(n, 120), 60);
    },
    memoryUsage: () => e.memoryUsage().rss,
    relativePath: (e, t) => path__default.default.relative(e, t),

package/sys/node/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stencil/core/sys/node",
-  "version": "2.17.0",
+  "version": "2.17.2",
   "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.17.0 | MIT Licensed | https://stenciljs.com
+ Stencil Node System Worker v2.17.2 | MIT Licensed | https://stenciljs.com
  */
 function _interopNamespace(e) {
  if (e && e.__esModule) return e;

package/testing/index.d.ts

@@ -3,7 +3,7 @@ export { createTesting } from './testing';
 export { createTestRunner } from './jest/jest-runner';
 export { jestPreprocessor } from './jest/jest-preprocessor';
 export { jestSetupTestFramework } from './jest/jest-setup-test-framework';
-export { mockBuildCtx, mockConfig, mockCompilerCtx, mockDocument, mockLogger, mockCompilerSystem, mockWindow, mockModule, } from './mocks';
+export { mockBuildCtx, mockConfig, mockCompilerCtx, mockDocument, mockLoadConfigInit, mockValidatedConfig, mockLogger, mockCompilerSystem, mockWindow, mockModule, } from './mocks';
 export { MockHeaders, MockRequest, MockRequestInit, MockRequestInfo, MockResponse, MockResponseInit, mockFetch, } from './mock-fetch';
 export { newSpecPage } from './spec-page';
 export { shuffleArray } from './testing-utils';