Merge branch 'main' into v5

Author: johnjenkins

.github/workflows/publish-npm.yml

@@ -15,7 +15,7 @@ on:
         description: 'Node.js version to use when publishing.'
         required: false
         type: string
-        default: '20'
+        default: '24'
       registry-url:
         description: 'Registry URL used for npm publish.'
         required: false

.github/workflows/release-production.yml

@@ -54,7 +54,7 @@ jobs:
       - name: 🟢 Configure Node for Publish
         uses: actions/setup-node@2028fbc5c25fe9cf00d9f06a71cc4710d4507903 # v6.0.0
         with:
-          node-version: '20'
+          node-version: '24'
           registry-url: 'https://registry.npmjs.org'
 
       - name: 🔄 Ensure Latest npm

CHANGELOG.md

@@ -1,3 +1,33 @@
+# 🐓 [4.44.0](https://github.com/stenciljs/core/compare/v4.43.5...v4.44.0) (2026-08-10)
+
+
+### Bug Fixes
+
+* **compiler:** escape backslashes before other escape sequences in styles ([#6773](https://github.com/stenciljs/core/issues/6773)) ([348f226](https://github.com/stenciljs/core/commit/348f226f6f1502c5e3b93eb0a337a09ae04b06e4))
+* **compiler:** handle constructor overloads ([#6766](https://github.com/stenciljs/core/issues/6766)) ([1dca769](https://github.com/stenciljs/core/commit/1dca7692a6b279ef65156285e90fd9ea4852116f)), closes [#6712](https://github.com/stenciljs/core/issues/6712)
+* **compiler:** preserve bundler directive comments in es5 output ([#6779](https://github.com/stenciljs/core/issues/6779)) ([f82296d](https://github.com/stenciljs/core/commit/f82296d387ff78f588debd3bdd196b6f89ac76dd))
+* **compiler:** resolve inherited type references against the declaring file ([#6782](https://github.com/stenciljs/core/issues/6782)) ([267d88c](https://github.com/stenciljs/core/commit/267d88caf2345be90faaecef91f88d4cd439adec))
+* **compiler:** resolveVar follows import chain ([#6801](https://github.com/stenciljs/core/issues/6801)) ([85235c3](https://github.com/stenciljs/core/commit/85235c3a3e4d095004a6e44a4c72106cbb138b60))
+* **compiler:** too many required props / "union type too complex" error ([#6804](https://github.com/stenciljs/core/issues/6804)) ([74722db](https://github.com/stenciljs/core/commit/74722db38c86dbf52405d1ec2e544683631425f8))
+* **docs:** stop `toLowerCase()` shadow part names ([#6813](https://github.com/stenciljs/core/issues/6813)) ([77f4510](https://github.com/stenciljs/core/commit/77f45103adddc4518fce5dbb5185991a44db786f))
+* **runtime:** ensure non-shadow DOM getters return null instead of undefined ([#6792](https://github.com/stenciljs/core/issues/6792)) ([6b63cb3](https://github.com/stenciljs/core/commit/6b63cb32ad1373f96671b69199280eda1489aa8f))
+* **runtime:** guard against render reentrancy under `taskQueue: 'immediate'` ([#6817](https://github.com/stenciljs/core/issues/6817)) ([b9b5b55](https://github.com/stenciljs/core/commit/b9b5b55db716fa3f57a43a25a2a87d0b11318049))
+* **runtime:** memory leak on document.hidden ([#6811](https://github.com/stenciljs/core/issues/6811)) ([cda3b04](https://github.com/stenciljs/core/commit/cda3b0481fc26ffce9113009cca9a9883efe9040))
+* **runtime:** retry lazy component load after a failed dynamic import ([#6772](https://github.com/stenciljs/core/issues/6772)) ([1be6b13](https://github.com/stenciljs/core/commit/1be6b13231a940217ba0968b5c531b4bbaff19ef))
+* **runtime:** stop forwarded named slot being added to nested default slot ([#6815](https://github.com/stenciljs/core/issues/6815)) ([b493d61](https://github.com/stenciljs/core/commit/b493d61a960deeb656f940248759f19a3094de6b))
+* **runtime:** VDOM should not process non-vnode objects ([#6812](https://github.com/stenciljs/core/issues/6812)) ([ffc5212](https://github.com/stenciljs/core/commit/ffc52124017581c77034b97e7ec5dcf3cf7f050b))
+
+
+### Features
+
+* **config:** allow suppressing reserved event name warnings ([#6748](https://github.com/stenciljs/core/issues/6748)) ([ca85879](https://github.com/stenciljs/core/commit/ca858791094349a3d5ccfd9afbdb71612973c2cc))
+* **docs:** better default part / slot handling ([#6819](https://github.com/stenciljs/core/issues/6819)) ([76a3d74](https://github.com/stenciljs/core/commit/76a3d74934cba0006bc9001aaf3d04e9def981db))
+* **jsx:** add `closedby` and `focusgroup` HTML attributes ([#6797](https://github.com/stenciljs/core/issues/6797)) ([449d7ec](https://github.com/stenciljs/core/commit/449d7ec956ecbffb963ba6ce1fe45f4830e8e7c3))
+* **jsx:** add fetchpriority attribute to img, link, script, iframe ([#6803](https://github.com/stenciljs/core/issues/6803)) ([1a5bcc8](https://github.com/stenciljs/core/commit/1a5bcc8083d696be998bc732d2e4a65326553a30)), closes [#6802](https://github.com/stenciljs/core/issues/6802)
+* **jsx:** add global `translate` attribute to HTMLAttributes ([#6808](https://github.com/stenciljs/core/issues/6808)) ([1626295](https://github.com/stenciljs/core/commit/1626295f3d40dcdab116aa56e9599a1c818a3036))
+
+
+
 ## 🍐 [4.43.5](https://github.com/stenciljs/core/compare/v4.43.4...v4.43.5) (2026-05-28)
 
 

cspell-wordlist.txt

@@ -183,4 +183,5 @@ dotless
 queryparams
 extensionless
 rgba
-unhashed
+unhashed
+reentrancy

packages/core/src/client/__test__/client-load-module.spec.ts

@@ -0,0 +1,54 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import type * as d from '@stencil/core';
+
+/**
+ * Test loadModule()'s cache-busting behavior when a module fails to load and is retried.
+ */
+describe('loadModule cache-busting on retry', () => {
+  const bundleId = 'cmp-retry-cache-bust';
+  const cmpMeta = {
+    $tagName$: 'cmp-retry-cache-bust',
+    $lazyBundleId$: bundleId,
+  } as d.ComponentRuntimeMeta;
+  const hostRef = { $hostElement$: {} } as d.HostRef;
+
+  // client-load-module.ts caches failed-attempt counts at module scope, so each test needs
+  // a fresh module instance to start from a clean retry count.
+  beforeEach(() => {
+    vi.resetModules();
+  });
+
+  const attemptedSpecifier = async (
+    loadModule: typeof import('../client-load-module').loadModule,
+    hmrVersionId?: string,
+  ) => {
+    const errorSpy = vi.spyOn(console, 'error').mockImplementation(() => {});
+    await loadModule(cmpMeta, hostRef, hmrVersionId);
+    const [error] = errorSpy.mock.calls.at(-1)!;
+    errorSpy.mockRestore();
+    return (error as Error).message;
+  };
+
+  it('retries a failed import with an incrementing ?s-retry=N param', async () => {
+    const { loadModule } = await import('../client-load-module');
+
+    expect(await attemptedSpecifier(loadModule)).toContain(`${bundleId}.entry.js'`);
+    expect(await attemptedSpecifier(loadModule)).toContain(`${bundleId}.entry.js?s-retry=1`);
+    expect(await attemptedSpecifier(loadModule)).toContain(`${bundleId}.entry.js?s-retry=2`);
+  });
+
+  it('joins the retry and HMR params with "&", retry first', async () => {
+    const { loadModule } = await import('../client-load-module');
+    const { BUILD } = await import('virtual:app-data');
+    BUILD.hotModuleReplacement = true;
+
+    expect(await attemptedSpecifier(loadModule, 'abc123')).toContain(
+      `${bundleId}.entry.js?s-hmr=abc123`,
+    );
+    expect(await attemptedSpecifier(loadModule, 'abc123')).toContain(
+      `${bundleId}.entry.js?s-retry=1&s-hmr=abc123`,
+    );
+
+    BUILD.hotModuleReplacement = false;
+  });
+});

packages/core/src/client/client-load-module.ts

@@ -8,6 +8,12 @@ export const cmpModules = /*@__PURE__*/ new Map<
   { [exportName: string]: d.ComponentConstructor }
 >();
 
+/**
+ * Tracks how many times a dynamic `import()` for a given lazy bundle has failed.
+ * Used to cache bust the retry attempt in connected-callback.ts
+ */
+const failedLoadAttempts = /*@__PURE__*/ new Map<string, number>();
+
 /**
  * We need to separate out this prefix so that Esbuild doesn't try to resolve
  * the below, but instead retains a dynamic `import()` statement in the
@@ -54,13 +60,26 @@ export const loadModule = (
   if (module) {
     return module[exportName];
   }
+  const retryCount = failedLoadAttempts.get(bundleId) ?? 0;
+  const cacheBustParams = [
+    retryCount > 0 ? `s-retry=${retryCount}` : '',
+    BUILD.hotModuleReplacement && hmrVersionId ? `s-hmr=${hmrVersionId}` : '',
+  ]
+    .filter(Boolean)
+    .join('&');
   /*!__STENCIL_STATIC_IMPORT_SWITCH__*/
-  const entryFile = `${bundleId}.entry.js${BUILD.hotModuleReplacement && hmrVersionId ? '?s-hmr=' + hmrVersionId : ''}`;
+  const entryFile = `${bundleId}.entry.js${cacheBustParams ? '?' + cacheBustParams : ''}`;
   const onLoad = (importedModule: any) => {
-    if (!BUILD.hotModuleReplacement) cmpModules.set(bundleId, importedModule);
+    if (!BUILD.hotModuleReplacement) {
+      failedLoadAttempts.delete(bundleId);
+      cmpModules.set(bundleId, importedModule);
+    }
     return importedModule[exportName];
   };
-  const onError = (e: Error) => consoleError(e, hostRef.$hostElement$);
+  const onError = (e: Error) => {
+    failedLoadAttempts.set(bundleId, retryCount + 1);
+    consoleError(e, hostRef.$hostElement$);
+  };
   if (lazyLoadBasePath) {
     return import(
       /* @vite-ignore */

packages/core/src/compiler/build/compiler-ctx.ts

@@ -129,6 +129,7 @@ export const getModuleLegacy = (compilerCtx: d.CompilerCtx, sourceFilePath: stri
       htmlAttrNames: [],
       htmlTagNames: [],
       htmlParts: [],
+      htmlSlots: [],
       isCollectionDependency: false,
       isLegacy: false,
       localImports: [],

packages/core/src/compiler/docs/_test_/generate-doc-data.spec.ts

@@ -10,7 +10,7 @@ import type * as d from '@stencil/core';
 import { DEFAULT_STYLE_MODE, getComponentsFromModules } from '../../../utils';
 import { stubComponentCompilerMeta } from '../../types/_tests_/ComponentCompilerMeta.stub';
 import { AUTO_GENERATE_COMMENT } from '../constants';
-import { generateDocData, getDocsStyles } from '../generate-doc-data';
+import { generateDocData, getDocsSlots, getDocsStyles } from '../generate-doc-data';
 
 describe('generate-doc-data', () => {
   describe('getDocsComponents', () => {
@@ -204,6 +204,39 @@ auto-generated content
     });
   });
 
+  describe('getDocsSlots', () => {
+    it('returns an empty array when there are no JSDoc @slot tags or scraped slots', () => {
+      const actual = getDocsSlots([], []);
+
+      expect(actual).toEqual([]);
+    });
+
+    it('includes slots scraped from the vdom that have no JSDoc', () => {
+      const actual = getDocsSlots(['', 'header'], []);
+
+      expect(actual).toEqual([
+        { name: '', docs: 'The default slot' },
+        { name: 'header', docs: '' },
+      ]);
+    });
+
+    it('includes slots documented only via the `@slot` JSDoc tag', () => {
+      const tags: d.JsonDocsTag[] = [{ name: 'slot', text: 'footer - the footer slot' }];
+
+      const actual = getDocsSlots([], tags);
+
+      expect(actual).toEqual([{ name: 'footer', docs: 'the footer slot' }]);
+    });
+
+    it('prefers the JSDoc description over the scraped entry for the same slot name', () => {
+      const tags: d.JsonDocsTag[] = [{ name: 'slot', text: 'header - the header slot' }];
+
+      const actual = getDocsSlots(['header'], tags);
+
+      expect(actual).toEqual([{ name: 'header', docs: 'the header slot' }]);
+    });
+  });
+
   describe('getDocsStyles', () => {
     it('returns an empty array if no styleDocs exist on the compiler metadata', () => {
       const compilerMeta = stubComponentCompilerMeta();

packages/core/src/compiler/docs/generate-doc-data.ts

@@ -117,7 +117,7 @@ const getDocsComponents = async (
           methods: getDocsMethods(cmp.methods),
           events: getDocsEvents(cmp.events),
           styles: getDocsStyles(cmp),
-          slots: getDocsSlots(cmp.docs.tags),
+          slots: getDocsSlots(cmp.htmlSlots, cmp.docs.tags),
           parts: getDocsParts(cmp.htmlParts, cmp.docs.tags),
           customStates: getDocsCustomStates(cmp),
           listeners: getDocsListeners(cmp.listeners),
@@ -377,9 +377,13 @@ const getDocsDeprecationText = (tags: d.JsonDocsTag[]): string | undefined => {
   return undefined;
 };
 
-const getDocsSlots = (tags: d.JsonDocsTag[]): d.JsonDocsSlot[] => {
+const DEFAULT_SLOT_DOCS = 'The default slot';
+
+export const getDocsSlots = (vdom: string[], tags: d.JsonDocsTag[]): d.JsonDocsSlot[] => {
+  const docsSlots = getNameText('slot', tags).map(([name, docs]) => ({ name, docs }));
+  const vdomSlots = vdom.map((name) => ({ name, docs: name === '' ? DEFAULT_SLOT_DOCS : '' }));
   return sortBy(
-    getNameText('slot', tags).map(([name, docs]) => ({ name, docs })),
+    unique([...docsSlots, ...vdomSlots], (s) => s.name),
     (a) => a.name,
   );
 };