@stencil/core 4.43.2 → 4.43.3

package/internal/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stencil/core/internal",
-  "version": "4.43.2",
+  "version": "4.43.3",
   "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

@@ -142,7 +142,7 @@ export interface BuildConditionals extends Partial<BuildFeatures> {
     attachStyles?: boolean;
     experimentalSlotFixes?: boolean;
     experimentalScopedSlotChanges?: boolean;
-    addGlobalStyleToComponents?: boolean;
+    addGlobalStyleToComponents?: boolean | 'client';
 }
 export type ModuleFormat = 'amd' | 'cjs' | 'es' | 'iife' | 'system' | 'umd' | 'commonjs' | 'esm' | 'module' | 'systemjs';
 export interface RollupResultModule {

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

@@ -258,6 +258,15 @@ export interface StencilConfig {
     docs?: StencilDocsConfig;
     globalScript?: string;
     srcIndexHtml?: string;
+    /**
+     * Configuration for Stencil's integrated testing (Jest + Puppeteer).
+     *
+     * @deprecated Integrated testing support will be removed in Stencil v5. Migrate spec tests to
+     * [`@stencil/vitest`](https://github.com/stenciljs/vitest) and e2e / browser tests to either
+     * [`@stencil/vitest`](https://github.com/stenciljs/vitest) or
+     * [`@stencil/playwright`](https://github.com/stenciljs/playwright).
+     * See https://github.com/stenciljs/core/issues/6584 for full discussion and migration guidance.
+     */
     testing?: TestingConfig;
     maxConcurrentWorkers?: number;
     preamble?: string;
@@ -381,15 +390,18 @@ interface ConfigExtrasBase {
     experimentalScopedSlotChanges?: boolean;
     /**
      * By default Stencil turns the stylesheet provided to `globalStyle` into a constructable stylesheet
-     * and adds it to each component which can be useful for sharing styles efficiently across components.
-     * In some cases this can be undesirable:
-     * - If `globalStyle` is intended to configure the lightDOM only
-     * - If `globalStyle` is large it can bloat the size of SSR output when using declarative-shadow-dom
+     * and adds it to each component when rendered on the client which can be useful for sharing styles
+     * efficiently across components.
+     *
+     * If you want Stencil to also add the `globalStyle` to each component when rendering on the server
+     * then set this to `true`. If your `globalStyle` sheet is large then doing this may bloat the size
+     * of your SSR output when using declarative-shadow-dom.
+     *
      * Setting this to `false` will prevent Stencil from adding any `globalStyle` to each component.
      *
-     * Defaults to `true`.
+     * Defaults to `'client'`.
      */
-    addGlobalStyleToComponents?: boolean;
+    addGlobalStyleToComponents?: boolean | 'client';
 }
 type ConfigExtrasSlotFixes<ExperimentalFixesEnabled extends boolean, IndividualFlags extends boolean> = {
     /**
@@ -1735,6 +1747,13 @@ export interface RollupOutputOptions {
         [name: string]: string;
     } | ((name: string) => string);
 }
+/**
+ * @deprecated Integrated testing support will be removed in Stencil v5. Migrate spec tests to
+ * [`@stencil/vitest`](https://github.com/stenciljs/vitest) and e2e / browser tests to either
+ * [`@stencil/vitest`](https://github.com/stenciljs/vitest) or
+ * [`@stencil/playwright`](https://github.com/stenciljs/playwright).
+ * See https://github.com/stenciljs/core/issues/6584 for full discussion and migration guidance.
+ */
 export interface Testing {
     run(opts: TestingRunOptions): Promise<boolean>;
     destroy(): Promise<void>;
@@ -1743,6 +1762,12 @@ export declare type Path = string;
 export declare type TransformerConfig = [string, Record<string, unknown>];
 /**
  * Options for initiating a run of Stencil tests (spec and/or end-to-end)
+ *
+ * @deprecated Integrated testing support will be removed in Stencil v5. Migrate spec tests to
+ * [`@stencil/vitest`](https://github.com/stenciljs/vitest) and e2e / browser tests to either
+ * [`@stencil/vitest`](https://github.com/stenciljs/vitest) or
+ * [`@stencil/playwright`](https://github.com/stenciljs/playwright).
+ * See https://github.com/stenciljs/core/issues/6584 for full discussion and migration guidance.
  */
 export interface TestingRunOptions {
     /**
@@ -1762,6 +1787,13 @@ export interface TestingRunOptions {
      */
     updateScreenshot?: boolean;
 }
+/**
+ * @deprecated Integrated testing support will be removed in Stencil v5. Migrate spec tests to
+ * [`@stencil/vitest`](https://github.com/stenciljs/vitest) and e2e / browser tests to either
+ * [`@stencil/vitest`](https://github.com/stenciljs/vitest) or
+ * [`@stencil/playwright`](https://github.com/stenciljs/playwright).
+ * See https://github.com/stenciljs/core/issues/6584 for full discussion and migration guidance.
+ */
 export interface JestConfig {
     /**
      * This option tells Jest that all imported modules in your tests should be mocked automatically.
@@ -1877,6 +1909,15 @@ export interface JestConfig {
     verbose?: boolean;
     watchPathIgnorePatterns?: any[];
 }
+/**
+ * Configuration for Stencil's integrated testing (Jest + Puppeteer).
+ *
+ * @deprecated Integrated testing support will be removed in Stencil v5. Migrate spec tests to
+ * [`@stencil/vitest`](https://github.com/stenciljs/vitest) and e2e / browser tests to either
+ * [`@stencil/vitest`](https://github.com/stenciljs/vitest) or
+ * [`@stencil/playwright`](https://github.com/stenciljs/playwright).
+ * See https://github.com/stenciljs/core/issues/6584 for full discussion and migration guidance.
+ */
 export interface TestingConfig extends JestConfig {
     /**
      * The `allowableMismatchedPixels` value is used to determine an acceptable
@@ -1969,6 +2010,13 @@ export interface TestingConfig extends JestConfig {
      */
     waitBeforeScreenshot?: number;
 }
+/**
+ * @deprecated Integrated testing support will be removed in Stencil v5. Migrate spec tests to
+ * [`@stencil/vitest`](https://github.com/stenciljs/vitest) and e2e / browser tests to either
+ * [`@stencil/vitest`](https://github.com/stenciljs/vitest) or
+ * [`@stencil/playwright`](https://github.com/stenciljs/playwright).
+ * See https://github.com/stenciljs/core/issues/6584 for full discussion and migration guidance.
+ */
 export interface EmulateConfig {
     /**
      * Predefined device descriptor name, such as "iPhone X" or "Nexus 10".
@@ -1981,6 +2029,13 @@ export interface EmulateConfig {
     userAgent?: string;
     viewport?: EmulateViewport;
 }
+/**
+ * @deprecated Integrated testing support will be removed in Stencil v5. Migrate spec tests to
+ * [`@stencil/vitest`](https://github.com/stenciljs/vitest) and e2e / browser tests to either
+ * [`@stencil/vitest`](https://github.com/stenciljs/vitest) or
+ * [`@stencil/playwright`](https://github.com/stenciljs/playwright).
+ * See https://github.com/stenciljs/core/issues/6584 for full discussion and migration guidance.
+ */
 export interface EmulateViewport {
     /**
      * Page width in pixels.