From 00927aa8ade7d003d16b6b9da10bf917e15e0615 Mon Sep 17 00:00:00 2001
From: John Jenkins <johnljenkins@hotmail.com>
Date: Sat, 23 May 2026 12:03:57 +0100
Subject: [PATCH 1/3] chore: upgrade things

---
 package.json                     |  2 +-
 packages/cli/package.json        |  2 +-
 packages/core/package.json       | 12 ++---
 packages/dev-server/package.json |  2 +-
 packages/mock-doc/package.json   |  4 +-
 pnpm-lock.yaml                   | 88 +++++++++++---------------------
 6 files changed, 41 insertions(+), 69 deletions(-)

diff --git a/package.json b/package.json
index e67633bc250..d86082188e4 100644
--- a/package.json
+++ b/package.json
@@ -43,7 +43,7 @@
     "@changesets/cli": "^2.31.0",
     "@types/node": "^24.12.4",
     "cspell": "^9.8.0",
-    "knip": "^6.14.1",
+    "knip": "^6.14.2",
     "oxfmt": "^0.42.0",
     "oxlint": "^1.66.0"
   },
diff --git a/packages/cli/package.json b/packages/cli/package.json
index acab0c861bf..b1e9026cbcb 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -43,7 +43,7 @@
   },
   "dependencies": {
     "@stencil/dev-server": "workspace:*",
-    "prompts": "^2.4.2"
+    "prompts": "^2.0.0"
   },
   "devDependencies": {
     "@stencil/core": "workspace:*",
diff --git a/packages/core/package.json b/packages/core/package.json
index 086b0814e7c..e89f7e63631 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -107,27 +107,27 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@parcel/watcher": "^2.5.1",
-    "@preact/signals-core": "^1.14.2",
+    "@parcel/watcher": "^2.0.0",
+    "@preact/signals-core": "^1.0.0",
     "@rollup/pluginutils": "^5.3.0",
     "@stencil/cli": "workspace:*",
     "@stencil/dev-server": "workspace:*",
     "@stencil/mock-doc": "workspace:*",
     "browserslist": "^4.0.0",
-    "chalk": "^5.6.2",
+    "chalk": "^5.0.0",
     "css-what": "^7.0.0",
     "jiti": "^2.0.0",
     "lightningcss": "^1.0.0",
     "magic-string": "^0.30.0",
-    "picomatch": "^4.0.3",
+    "picomatch": "^4.0.0",
     "postcss": "^8.0.0",
     "postcss-safe-parser": "^7.0.0",
     "postcss-selector-parser": "^7.0.0",
     "resolve": "^1.22.0",
     "rolldown": "^1.0.0",
-    "semver": "^7.7.4",
+    "semver": "^7.0.0",
     "terser": "^5.0.0",
-    "tinyglobby": "^0.2.15",
+    "tinyglobby": "^0.2.0",
     "typescript": "catalog:"
   },
   "devDependencies": {
diff --git a/packages/dev-server/package.json b/packages/dev-server/package.json
index 3e6459656c7..a771eb4bd48 100644
--- a/packages/dev-server/package.json
+++ b/packages/dev-server/package.json
@@ -40,7 +40,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "launch-editor": "^2.9.1",
+    "launch-editor": "^2.0.0",
     "open": "^11.0.0",
     "ws": "^8.0.0"
   },
diff --git a/packages/mock-doc/package.json b/packages/mock-doc/package.json
index a5f8768ed99..4d8c5b417d9 100644
--- a/packages/mock-doc/package.json
+++ b/packages/mock-doc/package.json
@@ -37,8 +37,8 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "nwsapi": "^2.2.23",
-    "parse5": "7.2.1"
+    "nwsapi": "^2.0.0",
+    "parse5": "^8.0.0"
   },
   "devDependencies": {
     "@stencil/vitest": "catalog:",
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 332f00f3801..53151467b2e 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -54,8 +54,8 @@ importers:
         specifier: ^9.8.0
         version: 9.8.0
       knip:
-        specifier: ^6.14.1
-        version: 6.14.1(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0)
+        specifier: ^6.14.2
+        version: 6.14.2(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0)
       oxfmt:
         specifier: ^0.42.0
         version: 0.42.0
@@ -69,7 +69,7 @@ importers:
         specifier: workspace:*
         version: link:../dev-server
       prompts:
-        specifier: ^2.4.2
+        specifier: ^2.0.0
         version: 2.4.2
     devDependencies:
       '@stencil/core':
@@ -91,10 +91,10 @@ importers:
   packages/core:
     dependencies:
       '@parcel/watcher':
-        specifier: ^2.5.1
+        specifier: ^2.0.0
         version: 2.5.6
       '@preact/signals-core':
-        specifier: ^1.14.2
+        specifier: ^1.0.0
         version: 1.14.2
       '@rollup/pluginutils':
         specifier: ^5.3.0
@@ -112,7 +112,7 @@ importers:
         specifier: ^4.0.0
         version: 4.28.2
       chalk:
-        specifier: ^5.6.2
+        specifier: ^5.0.0
         version: 5.6.2
       css-what:
         specifier: ^7.0.0
@@ -127,7 +127,7 @@ importers:
         specifier: ^0.30.0
         version: 0.30.21
       picomatch:
-        specifier: ^4.0.3
+        specifier: ^4.0.0
         version: 4.0.4
       postcss:
         specifier: ^8.0.0
@@ -145,14 +145,14 @@ importers:
         specifier: ^1.0.0
         version: 1.0.2
       semver:
-        specifier: ^7.7.4
-        version: 7.7.4
+        specifier: ^7.0.0
+        version: 7.8.1
       terser:
         specifier: ^5.0.0
         version: 5.48.0
       tinyglobby:
-        specifier: ^0.2.15
-        version: 0.2.15
+        specifier: ^0.2.0
+        version: 0.2.16
       typescript:
         specifier: 'catalog:'
         version: 6.0.3
@@ -179,8 +179,8 @@ importers:
   packages/dev-server:
     dependencies:
       launch-editor:
-        specifier: ^2.9.1
-        version: 2.13.0
+        specifier: ^2.0.0
+        version: 2.13.2
       open:
         specifier: ^11.0.0
         version: 11.0.0
@@ -213,11 +213,11 @@ importers:
   packages/mock-doc:
     dependencies:
       nwsapi:
-        specifier: ^2.2.23
+        specifier: ^2.0.0
         version: 2.2.23
       parse5:
-        specifier: 7.2.1
-        version: 7.2.1
+        specifier: ^8.0.0
+        version: 8.0.1
     devDependencies:
       '@stencil/vitest':
         specifier: 'catalog:'
@@ -3359,10 +3359,6 @@ packages:
     resolution: {integrity: sha512-rRqJg/6gd538VHvR3PSrdRBb/1Vy2YfzHqzvbhGIQpDRKIa4FgV/54b5Q1xYSxOOwKvjXweS26E0Q+nAMwp2pQ==}
     engines: {node: '>=8.6'}
 
-  entities@4.5.0:
-    resolution: {integrity: sha512-V0hjH4dGPh9Ao5p0MoRY6BVqtwCjhz6vI5LT8AJ55H+4g9/4vbHx1I54fS0XuclLhDHArPQCiMjDxjaL8fPxhw==}
-    engines: {node: '>=0.12'}
-
   entities@8.0.0:
     resolution: {integrity: sha512-zwfzJecQ/Uej6tusMqwAqU/6KL2XaB2VZ2Jg54Je6ahNBGNH6Ek6g3jjNCF0fG9EWQKGZNddNjU5F1ZQn/sBnA==}
     engines: {node: '>=20.19.0'}
@@ -3990,13 +3986,13 @@ packages:
     resolution: {integrity: sha512-eTIzlVOSUR+JxdDFepEYcBMtZ9Qqdef+rnzWdRZuMbOywu5tO2w2N7rqjoANZ5k9vywhL6Br1VRjUIgTQx4E8w==}
     engines: {node: '>=6'}
 
-  knip@6.14.1:
-    resolution: {integrity: sha512-SN3Ly0ixzj5CQkY/rc4OPHpWrCC0XRIIjgdP76G9Cni5k72ur5jBYOyvJuF5oPTM14v8eHcMUgPbElHa+lnR0g==}
+  knip@6.14.2:
+    resolution: {integrity: sha512-Vg3JhIINjZew1I7qAFI4UHemW1mc4azP/BxJvsq9eGDfxpGO7oVCuD/bsWkog9TO/ZwwJeAeOMFZ1kd9jnY9+Q==}
     engines: {node: ^20.19.0 || >=22.12.0}
     hasBin: true
 
-  launch-editor@2.13.0:
-    resolution: {integrity: sha512-u+9asUHMJ99lA15VRMXw5XKfySFR9dGXwgsgS14YTbUq3GITP58mIM32At90P5fZ+MUId5Yw+IwI/yKub7jnCQ==}
+  launch-editor@2.13.2:
+    resolution: {integrity: sha512-4VVDnbOpLXy/s8rdRCSXb+zfMeFR0WlJWpET1iA9CQdlZDfwyLjUuGQzXU4VeOoey6AicSAluWan7Etga6Kcmg==}
 
   level-blobs@0.1.7:
     resolution: {integrity: sha512-n0iYYCGozLd36m/Pzm206+brIgXP8mxPZazZ6ZvgKr+8YwOZ8/PPpYC5zMUu2qFygRN8RO6WC/HH3XWMW7RMVg==}
@@ -4430,9 +4426,6 @@ packages:
     resolution: {integrity: sha512-aOIos8bujGN93/8Ox/jPLh7RwVnPEysynVFE+fQZyg6jKELEHwzgKdLRFHUgXJL6kylijVSBC4BvN9OmsB48Rw==}
     engines: {node: '>=4'}
 
-  parse5@7.2.1:
-    resolution: {integrity: sha512-BuBYQYlv1ckiPdQi/ohiivi9Sagc9JG+Ozs0r7b/0iK3sKmrb0b9FdWdBbOdx6hBCM/F9Ir82ofnBhtZOjCRPQ==}
-
   parse5@8.0.1:
     resolution: {integrity: sha512-z1e/HMG90obSGeidlli3hj7cbocou0/wa5HacvI3ASx34PecNjNQeaHNo5WIZpWofN9kgkqV1q5YvXe3F0FoPw==}
 
@@ -4486,10 +4479,6 @@ packages:
   picocolors@1.1.1:
     resolution: {integrity: sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==}
 
-  picomatch@2.3.1:
-    resolution: {integrity: sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==}
-    engines: {node: '>=8.6'}
-
   picomatch@2.3.2:
     resolution: {integrity: sha512-V7+vQEJ06Z+c5tSye8S+nHUfI51xoXIXjHQ99cQtKUkQqqO1kO/KCJUfZXuB47h/YBlDhah2H3hdUGXn8ie0oA==}
     engines: {node: '>=8.6'}
@@ -4933,11 +4922,6 @@ packages:
     resolution: {integrity: sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==}
     hasBin: true
 
-  semver@7.7.4:
-    resolution: {integrity: sha512-vFKC2IEtQnVhpT78h1Yp8wzwrf8CM+MzKMHGJZfBtzhZNycRFnXsHk6E5TxIkkMsgNS7mdX3AGB7x2QM2di4lA==}
-    engines: {node: '>=10'}
-    hasBin: true
-
   semver@7.8.0:
     resolution: {integrity: sha512-AcM7dV/5ul4EekoQ29Agm5vri8JNqRyj39o0qpX6vDF2GZrtutZl5RwgD1XnZjiTAfncsJhMI48QQH3sN87YNA==}
     engines: {node: '>=10'}
@@ -4980,8 +4964,8 @@ packages:
     resolution: {integrity: sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==}
     engines: {node: '>=8'}
 
-  shell-quote@1.8.3:
-    resolution: {integrity: sha512-ObmnIF4hXNg1BqhnHmgbDETF8dLPCggZWBjkQfhZpbszZnYur5DUljTcCHii5LC3J5E0yeO/1LIMyH+UvHQgyw==}
+  shell-quote@1.8.4:
+    resolution: {integrity: sha512-VsC6n6vz1ihYYyZZwX7YZSF5l5x36ca17OC+a69h94YqB7X6XLwf+5MOgynYir2SLFUbl8gIYvBo8K8RoNQ6bQ==}
     engines: {node: '>= 0.4'}
 
   siginfo@2.0.0:
@@ -6891,7 +6875,7 @@ snapshots:
     dependencies:
       '@types/estree': 0.0.39
       estree-walker: 1.0.1
-      picomatch: 2.3.1
+      picomatch: 2.3.2
       rollup: 4.57.1
 
   '@rollup/pluginutils@5.3.0(rollup@4.57.1)':
@@ -7404,7 +7388,7 @@ snapshots:
     dependencies:
       ansi-align: 3.0.1
       camelcase: 7.0.1
-      chalk: 5.6.2
+      chalk: 5.0.1
       cli-boxes: 3.0.0
       string-width: 5.1.2
       type-fest: 2.19.0
@@ -7977,10 +7961,7 @@ snapshots:
       ansi-colors: 4.1.3
       strip-ansi: 6.0.1
 
-  entities@4.5.0: {}
-
-  entities@8.0.0:
-    optional: true
+  entities@8.0.0: {}
 
   env-paths@4.0.0:
     dependencies:
@@ -8654,7 +8635,7 @@ snapshots:
 
   kleur@3.0.3: {}
 
-  knip@6.14.1(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0):
+  knip@6.14.2(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0):
     dependencies:
       fdir: 6.5.0(picomatch@4.0.4)
       formatly: 0.3.0
@@ -8674,10 +8655,10 @@ snapshots:
       - '@emnapi/core'
       - '@emnapi/runtime'
 
-  launch-editor@2.13.0:
+  launch-editor@2.13.2:
     dependencies:
       picocolors: 1.1.1
-      shell-quote: 1.8.3
+      shell-quote: 1.8.4
 
   level-blobs@0.1.7:
     dependencies:
@@ -9226,14 +9207,9 @@ snapshots:
       error-ex: 1.3.4
       json-parse-better-errors: 1.0.2
 
-  parse5@7.2.1:
-    dependencies:
-      entities: 4.5.0
-
   parse5@8.0.1:
     dependencies:
       entities: 8.0.0
-    optional: true
 
   pascalcase@0.1.1: {}
 
@@ -9273,8 +9249,6 @@ snapshots:
 
   picocolors@1.1.1: {}
 
-  picomatch@2.3.1: {}
-
   picomatch@2.3.2: {}
 
   picomatch@4.0.4: {}
@@ -9729,8 +9703,6 @@ snapshots:
 
   semver@6.3.1: {}
 
-  semver@7.7.4: {}
-
   semver@7.8.0: {}
 
   semver@7.8.1: {}
@@ -9791,7 +9763,7 @@ snapshots:
 
   shebang-regex@3.0.0: {}
 
-  shell-quote@1.8.3: {}
+  shell-quote@1.8.4: {}
 
   siginfo@2.0.0: {}
 
@@ -10172,7 +10144,7 @@ snapshots:
       picomatch: 4.0.4
       postcss: 8.5.15
       rollup: 4.57.1
-      tinyglobby: 0.2.15
+      tinyglobby: 0.2.16
     optionalDependencies:
       '@types/node': 25.9.1
       fsevents: 2.3.3

From 97dc667a20ddd75618c49eff787714b3b1ebb7af Mon Sep 17 00:00:00 2001
From: John Jenkins <johnljenkins@hotmail.com>
Date: Sat, 23 May 2026 12:04:18 +0100
Subject: [PATCH 2/3] chore: tidy

---
 V5_PLANNING.md                                | 92 +++++++++----------
 .../migrations/_test_/hash-file-names.spec.ts |  6 +-
 .../src/migrations/rules/external-runtime.ts  |  4 +-
 .../src/migrations/rules/hash-file-names.ts   |  2 +-
 .../src/migrations/rules/light-dom-patches.ts |  2 +-
 .../src/migrations/rules/rolldown-config.ts   |  4 +-
 packages/core/src/app-data/lazy.ts            |  2 +-
 .../core/src/compiler/app-core/app-data.ts    |  6 +-
 packages/core/src/compiler/build/build.ts     |  6 +-
 .../core/src/compiler/build/watch-build.ts    |  4 +-
 .../compiler/bundle/core-resolve-plugin.ts    |  2 +-
 .../compiler/bundle/ext-transforms-plugin.ts  |  2 +-
 .../src/compiler/bundle/file-load-plugin.ts   |  2 +-
 .../_test_/validate-output-ssr-wasm.spec.ts   |  2 +-
 .../_test_/validate-rolldown-config.spec.ts   |  2 +-
 .../compiler/config/outputs/validate-www.ts   |  2 +-
 .../src/compiler/config/validate-plugins.ts   |  4 +-
 .../src/compiler/fs-watch/fs-watch-rebuild.ts |  2 +-
 .../src/compiler/optimize/autoprefixer.ts     |  2 +-
 .../_test_/output-targets-www-dist.spec.ts    |  2 +-
 .../output-targets/collection/index.ts        |  8 +-
 .../output-targets/dist-lazy/lazy-output.ts   |  2 +-
 .../core/src/compiler/output-targets/index.ts |  2 +-
 .../ssr-wasm/generate-ssr-wasm.ts             | 16 ++--
 .../standalone/generate-loader-module.ts      |  6 +-
 .../compiler/style/_test_/css-imports.spec.ts |  4 +-
 .../core/src/compiler/style/css-imports.ts    |  2 +-
 .../sys/typescript/typescript-config.ts       |  2 +-
 .../compiler/sys/typescript/typescript-sys.ts |  2 +-
 .../transformers/_test_/parse-extends.spec.ts |  2 +-
 .../transformers/add-tag-transform.ts         |  2 +-
 .../automatic-key-insertion/utils.ts          |  2 +-
 .../src/compiler/transpile/run-program.ts     |  4 +-
 .../core/src/compiler/transpile/ts-config.ts  |  2 +-
 .../core/src/declarations/stencil-private.ts  |  6 +-
 .../declarations/stencil-public-compiler.ts   |  4 +-
 .../declarations/stencil-public-runtime.ts    |  2 +-
 .../runtime/_test_/signal-backing.spec.tsx    |  2 +-
 packages/core/src/runtime/hmr-component.ts    |  6 +-
 packages/core/src/runtime/render.ts           |  2 +-
 packages/core/src/runtime/set-value.ts        |  2 +-
 packages/core/src/runtime/signals.ts          |  2 +-
 packages/core/src/runtime/update-component.ts |  2 +-
 packages/core/src/runtime/vdom/h.ts           |  2 +-
 packages/core/src/signals/index.ts            |  2 +-
 packages/core/src/utils/constants.ts          |  4 +-
 packages/core/tsdown.config.ts                |  2 +-
 test/build/global-style/src/global.css        |  2 +-
 test/build/global-style/validate.js           |  4 +-
 .../render-vdom/render-vdom.spec.tsx          |  2 +-
 .../signal-prop-cmp/signal-prop-cmp.spec.tsx  |  2 +-
 51 files changed, 127 insertions(+), 127 deletions(-)

diff --git a/V5_PLANNING.md b/V5_PLANNING.md
index 1f7e6d516fe..c884ce49b32 100644
--- a/V5_PLANNING.md
+++ b/V5_PLANNING.md
@@ -127,9 +127,9 @@ Modernize Stencil after 10 years: shed tech debt, embrace modern tooling, simpli
 - **`global-style` output target now supports `inject`** - control whether styles are injected into component shadow DOMs (`'none'`, `'client'`, `'all'`)
 - **Multiple `global-style` outputs supported** - build separate CSS bundles from different input files, each with independent `inject` settings
 - **`www` can now use standalone loader**
-- **`@Component` now supports `globalStyleUrl` and `globalStyle`** — co-locate document-level styles with the component. Styles are collected at build time and injected wherever `@import "stencil-globals"` appears in a global stylesheet. Works for all encapsulation types (shadow, scoped, none). No mode variants — CSS handles runtime variants via selectors or custom properties. Changes to `globalStyleUrl` files invalidate the global style build cache and trigger HMR correctly.
-- **`@import "stencil-hydrate"` virtual placeholder** — add to any `global-style` input to inject static FOUC-prevention CSS at build time instead of relying on the dynamic `<style>` tag inserted by the loader. The compiler replaces the placeholder with the sorted component selectors + configured hydration CSS (e.g. `my-cmp,other-cmp{visibility:hidden}.hydrated{visibility:inherit}`). When detected, `BUILD.staticHydrationStyles = true` suppresses the loader's dynamic injection. For `standalone` builds (which have no loader), `stencil-hydrate.css` is auto-generated alongside the bundle.
-- **`loader-bundle` now supports `externalRuntime`** — set `externalRuntime: true` on the `loader-bundle` output target to mark `@stencil/core` as an external dependency in the ESM/CJS distribution output. Only affects the bundler variant; the browser/CDN build always includes the runtime. Useful when consumers already depend on `@stencil/core` and want to avoid bundling a second copy.
+- **`@Component` now supports `globalStyleUrl` and `globalStyle`**  co-locate document-level styles with the component. Styles are collected at build time and injected wherever `@import "stencil-globals"` appears in a global stylesheet. Works for all encapsulation types (shadow, scoped, none). No mode variants  CSS handles runtime variants via selectors or custom properties. Changes to `globalStyleUrl` files invalidate the global style build cache and trigger HMR correctly.
+- **`@import "stencil-hydrate"` virtual placeholder**  add to any `global-style` input to inject static FOUC-prevention CSS at build time instead of relying on the dynamic `<style>` tag inserted by the loader. The compiler replaces the placeholder with the sorted component selectors + configured hydration CSS (e.g. `my-cmp,other-cmp{visibility:hidden}.hydrated{visibility:inherit}`). When detected, `BUILD.staticHydrationStyles = true` suppresses the loader's dynamic injection. For `standalone` builds (which have no loader), `stencil-hydrate.css` is auto-generated alongside the bundle.
+- **`loader-bundle` now supports `externalRuntime`**  set `externalRuntime: true` on the `loader-bundle` output target to mark `@stencil/core` as an external dependency in the ESM/CJS distribution output. Only affects the bundler variant; the browser/CDN build always includes the runtime. Useful when consumers already depend on `@stencil/core` and want to avoid bundling a second copy.
 
 ---
 
@@ -140,11 +140,11 @@ Modernize Stencil after 10 years: shed tech debt, embrace modern tooling, simpli
 New output target that compiles the SSR script to a standalone `.wasm` binary, callable from any language with a WASM runtime (PHP via `ext-wasm`, Java via `wasmtime-java`, Ruby via `wasmtime-rb`, Go, Rust, etc.).
 
 **Key design decisions:**
-- Strip `streamToString()` and all `node:stream` usage entirely — not needed
+- Strip `streamToString()` and all `node:stream` usage entirely  not needed
 - Expose a single `renderToString(html: string, options?: string): string` interface
 - Toolchain: [javy](https://github.com/bytecodealliance/javy) (Shopify, bytecodealliance) compiles the bundled SSR JS → WASM via QuickJS; [Extism PDK](https://extism.org/) as an optional layer for cleaner host function call interface
-- Interface convention: stdin/stdout (javy default) or Extism plugin exports — TBD based on what host runtimes support best
-- No JS runtime required on the backend — any WASM-capable host can SSR a component document
+- Interface convention: stdin/stdout (javy default) or Extism plugin exports  TBD based on what host runtimes support best
+- No JS runtime required on the backend  any WASM-capable host can SSR a component document
 
 **What needs to happen:**
 - [ ] Add `ssr-wasm` output target type and validation
@@ -225,7 +225,7 @@ pnpm run dev       # Watch mode
 
 ### Vision
 
-Replace `@State`/`@Prop` internals with signals via a single opt-in config flag — zero API changes for component authors, cleaner reactivity, cross-framework interop. If it proves popular, make it the default in a later release.
+Replace `@State`/`@Prop` internals with signals via a single opt-in config flag  zero API changes for component authors, cleaner reactivity, cross-framework interop. If it proves popular, make it the default in a later release.
 
 ### Approach
 
@@ -239,7 +239,7 @@ export const config: Config = {
   }
 };
 
-// Components unchanged — @State and @Prop work identically
+// Components unchanged  @State and @Prop work identically
 @Component({ tag: 'my-counter' })
 export class MyCounter {
   @State() count = 0;
@@ -256,49 +256,49 @@ export class MyCounter {
 
 ### Signal library
 
-`@preact/signals-core` — production-stable, ~1.3kb, zero deps, convergent with TC39. Abstracted behind `packages/core/src/runtime/signals.ts` so it can be swapped if TC39 finalizes.
+`@preact/signals-core`  production-stable, ~1.3kb, zero deps, convergent with TC39. Abstracted behind `packages/core/src/runtime/signals.ts` so it can be swapped if TC39 finalizes.
 
 ### Why bother over `@Watch`?
 
 `@Watch` covers derived state within a component. Signal-backing adds:
 
-1. **Cross-framework interop** — Stencil component state becomes subscribable by Solid/Angular/Preact reactive systems natively, no event/attribute roundtrip.
-2. **Computed derivations** — lazy, auto-dep-tracked, composable. No intermediate `@State` + watcher boilerplate.
-3. **Path to JSX leaf bypass** — signal objects in JSX can skip the vdom diff and update DOM nodes directly (Phase 2).
+1. **Cross-framework interop**  Stencil component state becomes subscribable by Solid/Angular/Preact reactive systems natively, no event/attribute roundtrip.
+2. **Computed derivations**  lazy, auto-dep-tracked, composable. No intermediate `@State` + watcher boilerplate.
+3. **Path to JSX leaf bypass**  signal objects in JSX can skip the vdom diff and update DOM nodes directly (Phase 2).
 
 ### Phases
 
-#### Phase 1 — Signal-backed `@State` and `@Prop`
+#### Phase 1  Signal-backed `@State` and `@Prop`
 - [x] Add `@preact/signals-core` to `packages/core`
-- [x] Create `packages/core/src/runtime/signals.ts` — adapter (`signal`, `computed`, `effect`, `batch`, `untracked`) + `initializeSignals`
+- [x] Create `packages/core/src/runtime/signals.ts`  adapter (`signal`, `computed`, `effect`, `batch`, `untracked`) + `initializeSignals`
 - [x] Add `signalBacking?: boolean` to `extras` config type (`ConfigExtrasBase`)
 - [x] Add `BUILD.signalBacking` constant + wire from `updateBuildConditionals` + `COLLECTION_CONFIG_FLAGS`
 - [x] `$signalValues$` + `$signalCleanup$` added to `HostRef`; `signalBacking` added to `BuildConditionals`
-- [x] **`set-value.ts`:** signal fast-path in `getValue` + `setValue` — bypasses Map once signals are initialized
-- [x] **`initialize-component.ts`:** calls `initializeSignals` before first `scheduleUpdate` — allocates one `Signal.State` per `@Prop`/`@State` member, seeded from `$instanceValues$`
-- [x] **Scheduling:** per-prop `effect()` calls `scheduleUpdate()` on change (first run is no-op — `hasRendered` guard)
+- [x] **`set-value.ts`:** signal fast-path in `getValue` + `setValue`  bypasses Map once signals are initialized
+- [x] **`initialize-component.ts`:** calls `initializeSignals` before first `scheduleUpdate`  allocates one `Signal.State` per `@Prop`/`@State` member, seeded from `$instanceValues$`
+- [x] **Scheduling:** per-prop `effect()` calls `scheduleUpdate()` on change (first run is no-op  `hasRendered` guard)
 - [x] **Watchers:** per-prop `effect()` fires `@Watch` callbacks with old/new value
 - [x] **`componentShouldUpdate`:** called from within the scheduling effect, can still veto
 - [x] **`@Prop` attribute path:** works via existing `attributeChangedCallback` → proxy setter → `setValue` signal fast-path
 - [x] **Disconnect cleanup:** `disconnected-callback.ts` calls `$signalCleanup$()` and nulls it on real disconnects (skipped for temporary slot relocations)
 - [x] **`reflect: true` with custom serializers:** serializer now runs inside the signal fast-path before `sig.value` is set, populating `$serializerValues$` before the triggered re-render
-- [x] Tests — unit (`signals.spec.ts`) + integration (`signal-backing.spec.tsx`)
+- [x] Tests  unit (`signals.spec.ts`) + integration (`signal-backing.spec.tsx`)
 
-#### Phase 2 — `@stencil/core/signals` subpath ✅ Complete
-- [x] New `packages/core/src/signals/index.ts` — public entry for signal primitives + decorators
+#### Phase 2  `@stencil/core/signals` subpath ✅ Complete
+- [x] New `packages/core/src/signals/index.ts`  public entry for signal primitives + decorators
 - [x] Re-exports `signal`, `computed`, `effect`, `batch`, `untracked` from `@preact/signals-core` (bundled, no extra install)
 - [x] `Signal<T>` and `ReadonlySignal<T>` declared as Stencil-owned interfaces (not re-exported from preact) so generated `components.d.ts` references `@stencil/core/signals` rather than `@preact/signals-core`
-- [x] `@Effect()` — pure runtime TS decorator; marks a method as a reactive effect, auto-tracked deps, auto-cleaned up on disconnect. Requires `signalBacking: true` (wired in `initializeSignals`)
-- ~~`@Computed()` decorator~~ — **removed**. Adds no value over `computed()` as a class field, and the return-type change (`ReadonlySignal<T>` vs `T`) created a typing nightmare for users.
-- [x] `@Effect()` without `signalBacking` — currently requires `signalBacking: true`; wiring could be moved to `initialize-component.ts` to support external-signal-only use cases
-- [x] **`getSignal<T>(elm, prop)`** — returns the `ReadonlySignal<T>` backing a `@Prop` member; returns `null` for `@State` members (internal) or if not signal-backed. Enables Stencil-to-Stencil reactive composition without events.
-- [x] **`STENCIL_SIGNALS_SYMBOL`** (`Symbol.for('stencil.signals')`) — a `@Prop`-only signal map is set on the host element after `initializeSignals`, cleared on disconnect. `@State` is excluded. Framework adapters (Solid, Angular, Preact) can subscribe without importing from `@stencil/core`.
+- [x] `@Effect()`  pure runtime TS decorator; marks a method as a reactive effect, auto-tracked deps, auto-cleaned up on disconnect. Requires `signalBacking: true` (wired in `initializeSignals`)
+- ~~`@Computed()` decorator~~  **removed**. Adds no value over `computed()` as a class field, and the return-type change (`ReadonlySignal<T>` vs `T`) created a typing nightmare for users.
+- [x] `@Effect()` without `signalBacking`  currently requires `signalBacking: true`; wiring could be moved to `initialize-component.ts` to support external-signal-only use cases
+- [x] **`getSignal<T>(elm, prop)`**  returns the `ReadonlySignal<T>` backing a `@Prop` member; returns `null` for `@State` members (internal) or if not signal-backed. Enables Stencil-to-Stencil reactive composition without events.
+- [x] **`STENCIL_SIGNALS_SYMBOL`** (`Symbol.for('stencil.signals')`)  a `@Prop`-only signal map is set on the host element after `initializeSignals`, cleared on disconnect. `@State` is excluded. Framework adapters (Solid, Angular, Preact) can subscribe without importing from `@stencil/core`.
 
 **External Signal API:**
 
 Two mechanisms let code *outside* a component subscribe to its reactive state:
 
-`getSignal<T>(elm, prop)` — typed, null-safe access for Stencil-aware code:
+`getSignal<T>(elm, prop)`  typed, null-safe access for Stencil-aware code:
 
 ```ts
 import { getSignal } from '@stencil/core/signals';
@@ -313,47 +313,47 @@ const total = computed(() =>
 );
 ```
 
-`STENCIL_SIGNALS_SYMBOL` — zero-import interop for framework wrappers and adapters:
+`STENCIL_SIGNALS_SYMBOL`  zero-import interop for framework wrappers and adapters:
 
 ```ts
-// Works in Solid, Angular, Preact wrappers — no @stencil/core import required
+// Works in Solid, Angular, Preact wrappers  no @stencil/core import required
 const sigs = el[Symbol.for('stencil.signals')];
 sigs?.get('count')?.subscribe(v => console.log('count =', v));
 ```
 
 **Design decisions:**
 
-- **`@Prop` only, not `@State`:** `@State` is internal component implementation — exposing it would let external code depend on details that components are free to change. Framework adapters and parent components should only observe the declared public interface (`@Prop`). Internally, `$signalValues$` still holds both `@Prop` and `@State` signals (the write path in `set-value.ts` needs them); the symbol and `getSignal` expose a filtered copy containing only `@Prop` members.
-- **`ReadonlySignal<T>` not `Signal<T>` from `getSignal`:** External consumers must not write directly to a component's `@Prop` — they should set the attribute/property via the DOM. `ReadonlySignal` enforces this at the type level. `computed()` values also satisfy `ReadonlySignal`, so the type composes naturally.
-- **Symbol not typed as a property on `HostElement`:** TypeScript's `Symbol.for()` returns `symbol` (not `unique symbol`), which can't be used as a computed property key in interfaces. Adding an index signature (`[symbol: symbol]: Map<...>`) to `HostElement` breaks `HTMLElement` assignability throughout the codebase. Accepted limitation — framework adapters access it via `el[Symbol.for('stencil.signals')] as any`; typed code uses `getSignal` instead.
+- **`@Prop` only, not `@State`:** `@State` is internal component implementation  exposing it would let external code depend on details that components are free to change. Framework adapters and parent components should only observe the declared public interface (`@Prop`). Internally, `$signalValues$` still holds both `@Prop` and `@State` signals (the write path in `set-value.ts` needs them); the symbol and `getSignal` expose a filtered copy containing only `@Prop` members.
+- **`ReadonlySignal<T>` not `Signal<T>` from `getSignal`:** External consumers must not write directly to a component's `@Prop`  they should set the attribute/property via the DOM. `ReadonlySignal` enforces this at the type level. `computed()` values also satisfy `ReadonlySignal`, so the type composes naturally.
+- **Symbol not typed as a property on `HostElement`:** TypeScript's `Symbol.for()` returns `symbol` (not `unique symbol`), which can't be used as a computed property key in interfaces. Adding an index signature (`[symbol: symbol]: Map<...>`) to `HostElement` breaks `HTMLElement` assignability throughout the codebase. Accepted limitation  framework adapters access it via `el[Symbol.for('stencil.signals')] as any`; typed code uses `getSignal` instead.
 - **Cleared on disconnect:** The symbol property is set to `undefined` in `$signalCleanup$()`. Adapters must use optional chaining: `sigs?.get('prop')?.subscribe(...)`.
 
-#### Phase 3 — JSX vdom bypass ✅ Complete
-- [x] `BUILD.vdomSignals` flag — auto-enabled by `signalBacking: true`; also standalone via `extras.vdomSignals: true`
-- [x] Signal text children — `<div>{mySignal}</div>` → `effect()` updates `textNode.data` directly, bypasses vdom diff
-- [x] Signal attribute values — `<div class={mySignal}>` → `effect()` calls `setAccessor` directly
+#### Phase 3  JSX vdom bypass ✅ Complete
+- [x] `BUILD.vdomSignals` flag  auto-enabled by `signalBacking: true`; also standalone via `extras.vdomSignals: true`
+- [x] Signal text children  `<div>{mySignal}</div>` → `effect()` updates `textNode.data` directly, bypasses vdom diff
+- [x] Signal attribute values  `<div class={mySignal}>` → `effect()` calls `setAccessor` directly
 - [x] Per-node cleanup: `WeakMap<Node, () => void>` (text nodes) + `WeakMap<Node, Map<string, () => void>>` (per-attribute). `removeVnodes` recursively disposes.
-- [x] `SignalRef<T>` interface in public runtime declarations — JSX type compatibility without importing `@preact/signals-core`
-- [x] Tests — signal text children, signal attributes
+- [x] `SignalRef<T>` interface in public runtime declarations  JSX type compatibility without importing `@preact/signals-core`
+- [x] Tests  signal text children, signal attributes
 
 **Design decisions:**
 
-- **Signal detection:** Duck-type via `typeof v.peek === 'function' && typeof v.subscribe === 'function'` rather than `instanceof Signal`. Cross-bundle-safe — both the `signals/` bundle and the `runtime/` bundle inline `@preact/signals-core`; two separate class instances would make `instanceof` fail when signals are passed across bundle boundaries.
+- **Signal detection:** Duck-type via `typeof v.peek === 'function' && typeof v.subscribe === 'function'` rather than `instanceof Signal`. Cross-bundle-safe  both the `signals/` bundle and the `runtime/` bundle inline `@preact/signals-core`; two separate class instances would make `instanceof` fail when signals are passed across bundle boundaries.
 - **`$signal$?: any` on VNode:** Stores the signal reference through the `h()` → `createElm()` pipeline for text nodes.
-- **`<Show>` removed:** The `<Show when={signal}>` component was removed. It only toggled `display` on a wrapper element — no capability beyond what signal attributes already provide. Use a signal-driven `style` or `class` attribute directly instead.
+- **`<Show>` removed:** The `<Show when={signal}>` component was removed. It only toggled `display` on a wrapper element  no capability beyond what signal attributes already provide. Use a signal-driven `style` or `class` attribute directly instead.
 
-#### Phase 4 — `<For>` reactive list rendering (removed)
+#### Phase 4  `<For>` reactive list rendering (removed)
 
-Not implemented. The bypass benefit only applies when the array signal changes without a host component re-render — a narrow use case. The render function typically closes over component state, meaning arrow functions are recreated each render and the bypass is defeated. The implementation also requires capturing and restoring module-level renderer state (`hostTagName`, `scopeId`, `isSvgMode`) from inside signal effect callbacks — a fragile layering violation.
+Not implemented. The bypass benefit only applies when the array signal changes without a host component re-render  a narrow use case. The render function typically closes over component state, meaning arrow functions are recreated each render and the bypass is defeated. The implementation also requires capturing and restoring module-level renderer state (`hostTagName`, `scopeId`, `isSvgMode`) from inside signal effect callbacks  a fragile layering violation.
 
 Use keyed `.map()` instead: `{items.value.map((item, i) => <li key={item.id}>...</li>)}`
 
-#### Later — make default
+#### Later  make default
 - [ ] Evaluate adoption/feedback from Phases 1 + 2
 - [ ] If stable and popular: flip `signalBacking` default to `true`, deprecate old Map path, remove in next major
 
 #### Out of scope for now
-- Separate `@stencil/signals` store package — relegated; the `@stencil/core/signals` subpath covers the in-component use case
+- Separate `@stencil/signals` store package  relegated; the `@stencil/core/signals` subpath covers the in-component use case
 
 ### Files Changed
 
@@ -361,8 +361,8 @@ Use keyed `.map()` instead: `{items.value.map((item, i) => <li key={item.id}>...
 |------|--------|
 | `packages/core/package.json` | Added `@preact/signals-core` dep; `./signals` subpath export |
 | `packages/core/tsdown.config.ts` | Added `signals/index` entry |
-| `packages/core/src/signals/index.ts` | New — public entry: signal primitives re-export + `@Effect()` + `@Computed()` |
-| `packages/core/src/runtime/signals.ts` | `initializeSignals` — per-prop scheduling + watcher effects + `@Effect()` wiring |
+| `packages/core/src/signals/index.ts` | New  public entry: signal primitives re-export + `@Effect()` + `@Computed()` |
+| `packages/core/src/runtime/signals.ts` | `initializeSignals`  per-prop scheduling + watcher effects + `@Effect()` wiring |
 | `packages/core/src/declarations/stencil-private.ts` | `$signalValues$`, `$signalCleanup$` on `HostRef`; `signalBacking` on `BuildConditionals` |
 | `packages/core/src/declarations/stencil-public-compiler.ts` | `signalBacking` on `ConfigExtrasBase` |
 | `packages/core/src/compiler/app-core/app-data.ts` | Set `BUILD.signalBacking` from config; added to `COLLECTION_CONFIG_FLAGS` |
@@ -376,7 +376,7 @@ Use keyed `.map()` instead: `{items.value.map((item, i) => <li key={item.id}>...
 | `packages/core/src/runtime/vdom/set-accessor.ts` | Signal attribute subscriptions via `effect()`; `disposeAllSignalAttrs` |
 | `packages/core/src/runtime/vdom/vdom-render.ts` | `createElm` signal text + Show handling; `disposeSignalVNode` on `removeVnodes` |
 | `packages/core/src/declarations/stencil-public-runtime.ts` | `SignalRef<T>` interface; `class` attr type widened to accept `SignalRef<string>` |
-| `packages/core/src/runtime/_test_/signal-vdom.spec.tsx` | New — 12 integration tests for Phase 3 vdom bypass |
+| `packages/core/src/runtime/_test_/signal-vdom.spec.tsx` | New  12 integration tests for Phase 3 vdom bypass |
 
 ### Out of scope (v6+ / future)
 
diff --git a/packages/cli/src/migrations/_test_/hash-file-names.spec.ts b/packages/cli/src/migrations/_test_/hash-file-names.spec.ts
index 56c88d6bb52..18aab6448cb 100644
--- a/packages/cli/src/migrations/_test_/hash-file-names.spec.ts
+++ b/packages/cli/src/migrations/_test_/hash-file-names.spec.ts
@@ -52,7 +52,7 @@ describe('hashFileNamesRule', () => {
     });
   });
 
-  describe('transform — single-line output target', () => {
+  describe('transform  single-line output target', () => {
     it('injects hashFileNames into single-line loader-bundle', () => {
       const result = transform(`export const config = {
   hashFileNames: false,
@@ -80,7 +80,7 @@ describe('hashFileNamesRule', () => {
     });
   });
 
-  describe('transform — multi-line output target', () => {
+  describe('transform  multi-line output target', () => {
     it('injects hashFileNames into multi-line loader-bundle on its own line', () => {
       const result = transform(`export const config = {
   hashFileNames: false,
@@ -126,7 +126,7 @@ describe('hashFileNamesRule', () => {
     });
   });
 
-  describe('transform — edge cases', () => {
+  describe('transform  edge cases', () => {
     it('removes top-level prop even when no matching output targets exist', () => {
       const result = transform(`export const config = {
   hashFileNames: false,
diff --git a/packages/cli/src/migrations/rules/external-runtime.ts b/packages/cli/src/migrations/rules/external-runtime.ts
index 761a49434d3..d362fda0c7f 100644
--- a/packages/cli/src/migrations/rules/external-runtime.ts
+++ b/packages/cli/src/migrations/rules/external-runtime.ts
@@ -12,7 +12,7 @@ export const externalRuntimeRule: MigrationRule = {
   id: 'external-runtime',
   name: 'externalRuntime Default Change',
   description:
-    "Remove redundant 'externalRuntime: false' from standalone output targets — false is now the default",
+    "Remove redundant 'externalRuntime: false' from standalone output targets  false is now the default",
   fromVersion: '4.x',
   toVersion: '5.x',
 
@@ -40,7 +40,7 @@ export const externalRuntimeRule: MigrationRule = {
             const { line, character } = sourceFile.getLineAndCharacterOfPosition(node.getStart());
             matches.push({
               node,
-              message: "'externalRuntime: false' is now the default — this property can be removed",
+              message: "'externalRuntime: false' is now the default  this property can be removed",
               line: line + 1,
               column: character + 1,
             });
diff --git a/packages/cli/src/migrations/rules/hash-file-names.ts b/packages/cli/src/migrations/rules/hash-file-names.ts
index 66b679dc230..c3cb40be42a 100644
--- a/packages/cli/src/migrations/rules/hash-file-names.ts
+++ b/packages/cli/src/migrations/rules/hash-file-names.ts
@@ -30,7 +30,7 @@ export const hashFileNamesRule: MigrationRule = {
         ts.isIdentifier(node.name) &&
         (node.name.text === 'hashFileNames' || node.name.text === 'hashedFileNameLength')
       ) {
-        // Only match at top-level config — skip if inside an output target object
+        // Only match at top-level config  skip if inside an output target object
         // (output targets always have a sibling `type` property)
         const parent = node.parent;
         if (ts.isObjectLiteralExpression(parent)) {
diff --git a/packages/cli/src/migrations/rules/light-dom-patches.ts b/packages/cli/src/migrations/rules/light-dom-patches.ts
index 16e450a7b96..5dd36d095d8 100644
--- a/packages/cli/src/migrations/rules/light-dom-patches.ts
+++ b/packages/cli/src/migrations/rules/light-dom-patches.ts
@@ -107,7 +107,7 @@ export const lightDomPatchesRule: MigrationRule = {
       // Explicit opt-out
       replacement = 'lightDomPatches: false';
     } else if (experimentalValue === true && hasIndividualKeys) {
-      // experimentalSlotFixes: true overrides individual flags — treat as all-on
+      // experimentalSlotFixes: true overrides individual flags  treat as all-on
       replacement = null; // new default covers this
     } else {
       // Individual flags only (no experimentalSlotFixes, or unknown value)
diff --git a/packages/cli/src/migrations/rules/rolldown-config.ts b/packages/cli/src/migrations/rules/rolldown-config.ts
index 36bbccd24fb..1e6be9c6eb2 100644
--- a/packages/cli/src/migrations/rules/rolldown-config.ts
+++ b/packages/cli/src/migrations/rules/rolldown-config.ts
@@ -86,7 +86,7 @@ export const rolldownConfigRule: MigrationRule = {
               message:
                 name === 'rollupConfig'
                   ? `'rollupConfig' renamed to 'rolldownConfig'; 'inputOptions' wrapper removed`
-                  : `'rolldownConfig.inputOptions' wrapper removed — options are now top-level`,
+                  : `'rolldownConfig.inputOptions' wrapper removed  options are now top-level`,
               line: line + 1,
               column: character + 1,
             });
@@ -178,7 +178,7 @@ export const rolldownConfigRule: MigrationRule = {
         );
 
         if (!inputOptionsProp) {
-          // No inputOptions to flatten — just rename the key if needed
+          // No inputOptions to flatten  just rename the key if needed
           if (name === 'rollupConfig') {
             const nameStart = node.name.getStart(sourceFile);
             edits.push({
diff --git a/packages/core/src/app-data/lazy.ts b/packages/core/src/app-data/lazy.ts
index be7f4701993..e047b1f9383 100644
--- a/packages/core/src/app-data/lazy.ts
+++ b/packages/core/src/app-data/lazy.ts
@@ -1,7 +1,7 @@
 // Import Env/NAMESPACE/BUILD from the external app-data (kept external in the lazy build,
 // maps to @stencil/core/runtime/app-data in dist). Consumers alias that to their
 // collection's app-data to get correct Env values and component-specific BUILD flags.
-// We only override lazyLoad: true — the one flag that must always be set for the lazy
+// We only override lazyLoad: true  the one flag that must always be set for the lazy
 // runtime mechanism to work regardless of what the consumer's app-data provides.
 import { BUILD as _BUILD, Env, NAMESPACE } from 'virtual:app-data-external';
 import type { BuildConditionals } from '@stencil/core';
diff --git a/packages/core/src/compiler/app-core/app-data.ts b/packages/core/src/compiler/app-core/app-data.ts
index 2069eff1214..d2c996a68d7 100644
--- a/packages/core/src/compiler/app-core/app-data.ts
+++ b/packages/core/src/compiler/app-core/app-data.ts
@@ -156,7 +156,7 @@ const getModuleImports = (moduleMap: ModuleMap, filePath: string, importedModule
 /**
  * Config-driven extras flags that a collection lib author may have set explicitly.
  * These are the only flags propagated from a collection's buildFlags into the consumer's
- * build — everything else is a component-derived flag that the consumer recomputes itself
+ * build  everything else is a component-derived flag that the consumer recomputes itself
  * by scanning all components (including those from the collection).
  */
 const COLLECTION_CONFIG_FLAGS: ReadonlySet<keyof BuildConditionals> = new Set([
@@ -174,7 +174,7 @@ const COLLECTION_CONFIG_FLAGS: ReadonlySet<keyof BuildConditionals> = new Set([
 
 /**
  * Merge config-driven build flags from consumed collections into the active build conditionals.
- * Only flags explicitly set via the lib author's stencil.config extras are merged — component-
+ * Only flags explicitly set via the lib author's stencil.config extras are merged  component-
  * derived flags are excluded because the consumer recomputes them from source.
  *
  * **This function mutates the build conditionals argument**
@@ -222,7 +222,7 @@ export const updateBuildConditionals = (config: ValidatedConfig, b: BuildConditi
   b.asyncLoading = !!(b.asyncLoading || b.lazyLoad || b.taskQueue || b.initializeNextTick);
   b.cssAnnotations = true;
   // lightDomPatches only matter when there are non-shadow slotted components.
-  // Gating here keeps shadow-only bundles lean — patch functions get tree-shaken out.
+  // Gating here keeps shadow-only bundles lean  patch functions get tree-shaken out.
   const ldp = config.extras.lightDomPatches ?? true;
   if (b.slotRelocation && ldp !== false) {
     b.lightDomPatches = ldp === true;
diff --git a/packages/core/src/compiler/build/build.ts b/packages/core/src/compiler/build/build.ts
index abb6616323e..3ad980f8956 100644
--- a/packages/core/src/compiler/build/build.ts
+++ b/packages/core/src/compiler/build/build.ts
@@ -61,13 +61,13 @@ export const build = async (
     tsTimeSpan.finish('transpile finished');
     if (buildCtx.hasError) return buildAbort(buildCtx);
 
-    // If TS emitted nothing, the "script change" was a phantom duplicate event — clear the flag
+    // If TS emitted nothing, the "script change" was a phantom duplicate event  clear the flag
     // so type validation and bundling are skipped.
     if (buildCtx.isRebuild && buildCtx.hasScriptChanges && compilerCtx.changedModules.size === 0) {
       buildCtx.hasScriptChanges = false;
     }
 
-    // Skip type validation on rebuilds with no script changes — the type graph is unchanged.
+    // Skip type validation on rebuilds with no script changes  the type graph is unchanged.
     const skipTypeValidation = buildCtx.isRebuild && !buildCtx.hasScriptChanges;
 
     if (!skipTypeValidation) {
@@ -85,7 +85,7 @@ export const build = async (
         // Return null so watch-build restarts with a fresh program.
         return null;
       }
-      // types changed but no restart needed — components.d.ts is watch-ignored
+      // types changed but no restart needed  components.d.ts is watch-ignored
       // to prevent cascade rebuilds, so just continue with the current build.
     }
 
diff --git a/packages/core/src/compiler/build/watch-build.ts b/packages/core/src/compiler/build/watch-build.ts
index cf9308f898d..df0562b1669 100644
--- a/packages/core/src/compiler/build/watch-build.ts
+++ b/packages/core/src/compiler/build/watch-build.ts
@@ -50,7 +50,7 @@ export const createWatchBuild = async (
   // TS files that need cache invalidation before the next rebuild
   const tsFilesToInvalidate = new Set<string>();
 
-  // Debounce timer — multiple watchers can fire for the same change
+  // Debounce timer  multiple watchers can fire for the same change
   let rebuildTimeout: ReturnType<typeof setTimeout> | null = null;
 
   // Suppress FSEvents double-events (the same save can fire twice ~200-500ms apart),
@@ -175,7 +175,7 @@ export const createWatchBuild = async (
 
   /**
    * Returns files as a prefixed list, or 'none' if empty.
-   * No space before the filename — the logger wraps on whitespace.
+   * No space before the filename  the logger wraps on whitespace.
    * @param files the list of files to format for debug output
    * @returns the formatted string for debug output
    */
diff --git a/packages/core/src/compiler/bundle/core-resolve-plugin.ts b/packages/core/src/compiler/bundle/core-resolve-plugin.ts
index cd52b551e6c..8ff4b36fb7c 100644
--- a/packages/core/src/compiler/bundle/core-resolve-plugin.ts
+++ b/packages/core/src/compiler/bundle/core-resolve-plugin.ts
@@ -83,7 +83,7 @@ export const coreResolvePlugin = (
           id === STENCIL_INTERNAL_LAZY_CLIENT_PLATFORM_ID
         ) {
           if (externalRuntime) {
-            // not bundling the client runtime — must be a custom elements or loader-bundle
+            // not bundling the client runtime  must be a custom elements or loader-bundle
             // build where the runtime is an external import rather than bundled
             return { id, external: true };
           }
diff --git a/packages/core/src/compiler/bundle/ext-transforms-plugin.ts b/packages/core/src/compiler/bundle/ext-transforms-plugin.ts
index 79587efd71b..0460ce7938f 100644
--- a/packages/core/src/compiler/bundle/ext-transforms-plugin.ts
+++ b/packages/core/src/compiler/bundle/ext-transforms-plugin.ts
@@ -104,7 +104,7 @@ export const extTransformsPlugin = (
         // Memoize the expensive SASS + Lightning CSS computation across output targets.
         // customElements, lazy, and hydrate all process the same ~N stylesheets;
         // caching here means only the first output target pays the full per-sheet
-        // cost — subsequent targets hit the cache and complete in microseconds.
+        // cost  subsequent targets hit the cache and complete in microseconds.
         //
         // NOTE: this cache is keyed by the raw annotated `id` which encodes the
         // file path plus component metadata (tag, mode, encapsulation). Entries are
diff --git a/packages/core/src/compiler/bundle/file-load-plugin.ts b/packages/core/src/compiler/bundle/file-load-plugin.ts
index 2f5da2d2970..5603d7ff3fb 100644
--- a/packages/core/src/compiler/bundle/file-load-plugin.ts
+++ b/packages/core/src/compiler/bundle/file-load-plugin.ts
@@ -14,7 +14,7 @@ export const fileLoadPlugin = (fs: InMemoryFileSystem): Plugin => {
     // Confirm paths that exist only in the in-memory FS so rolldown's native
     // disk resolver doesn't reject virtual files before the load hook runs.
     resolveId(id, importer) {
-      // Preserve query params (e.g. ?tag=cmp-a) — strip only for FS lookup,
+      // Preserve query params (e.g. ?tag=cmp-a)  strip only for FS lookup,
       // then re-attach so extTransformsPlugin.transform can parse them.
       const qIdx = id.indexOf('?');
       const query = qIdx !== -1 ? id.slice(qIdx) : '';
diff --git a/packages/core/src/compiler/config/_test_/validate-output-ssr-wasm.spec.ts b/packages/core/src/compiler/config/_test_/validate-output-ssr-wasm.spec.ts
index c25f6b48504..e0cfab4a999 100644
--- a/packages/core/src/compiler/config/_test_/validate-output-ssr-wasm.spec.ts
+++ b/packages/core/src/compiler/config/_test_/validate-output-ssr-wasm.spec.ts
@@ -114,7 +114,7 @@ describe('validateSsrWasmOutputTarget', () => {
       const { config: validatedConfig } = validateConfig(config, mockLoadConfigInit());
 
       const ssrWasm = validatedConfig.outputTargets.find(isOutputTargetSsrWasm);
-      // ssr-wasm has no external field — everything is bundled into the binary
+      // ssr-wasm has no external field  everything is bundled into the binary
       expect((ssrWasm as any)?.external).toBeUndefined();
     });
   });
diff --git a/packages/core/src/compiler/config/_test_/validate-rolldown-config.spec.ts b/packages/core/src/compiler/config/_test_/validate-rolldown-config.spec.ts
index 779e2c47967..01b67414773 100644
--- a/packages/core/src/compiler/config/_test_/validate-rolldown-config.spec.ts
+++ b/packages/core/src/compiler/config/_test_/validate-rolldown-config.spec.ts
@@ -31,7 +31,7 @@ describe('validateRolldownConfig', () => {
     config.rolldownConfig = {
       external: ['foo', 'bar'],
       treeshake: false,
-      // @ts-expect-error — intentionally testing unknown key rejection
+      // @ts-expect-error  intentionally testing unknown key rejection
       notAnOption: {},
     };
     const rolldownConfig = validateRolldownConfig(config);
diff --git a/packages/core/src/compiler/config/outputs/validate-www.ts b/packages/core/src/compiler/config/outputs/validate-www.ts
index 32f4c8ef161..71819ad5739 100644
--- a/packages/core/src/compiler/config/outputs/validate-www.ts
+++ b/packages/core/src/compiler/config/outputs/validate-www.ts
@@ -34,7 +34,7 @@ export const validateWww = (
   diagnostics: d.Diagnostic[],
   userOutputs: d.OutputTarget[],
 ) => {
-  // Only count 'real' user-configured output targets — exclude auto-generated
+  // Only count 'real' user-configured output targets  exclude auto-generated
   // outputs (types, collection, global-style, assets) that autoGenerateOutputs()
   // may have injected into userOutputs before this function was called, so a bare config
   // (no explicit output targets) still gets the default www output added.
diff --git a/packages/core/src/compiler/config/validate-plugins.ts b/packages/core/src/compiler/config/validate-plugins.ts
index 14675a3a65d..9ba1e2713a9 100644
--- a/packages/core/src/compiler/config/validate-plugins.ts
+++ b/packages/core/src/compiler/config/validate-plugins.ts
@@ -22,12 +22,12 @@ export const validatePlugins = (config: d.UnvalidatedConfig, diagnostics: d.Diag
 
   if (hasCommonjs) {
     const warn = buildWarn(diagnostics);
-    warn.messageText = `Rolldown handles CommonJS natively — remove the commonjs plugin from your "stencil.config.ts" plugins.`;
+    warn.messageText = `Rolldown handles CommonJS natively  remove the commonjs plugin from your "stencil.config.ts" plugins.`;
   }
 
   if (hasResolveNode) {
     const warn = buildWarn(diagnostics);
-    warn.messageText = `Rolldown handles module resolution natively — remove the node-resolve plugin from your "stencil.config.ts" plugins. Use the "nodeResolve" config option to customise resolution.`;
+    warn.messageText = `Rolldown handles module resolution natively  remove the node-resolve plugin from your "stencil.config.ts" plugins. Use the "nodeResolve" config option to customise resolution.`;
   }
 
   config.rolldownPlugins.before = [
diff --git a/packages/core/src/compiler/fs-watch/fs-watch-rebuild.ts b/packages/core/src/compiler/fs-watch/fs-watch-rebuild.ts
index ea372c5ed70..0b76e7945ea 100644
--- a/packages/core/src/compiler/fs-watch/fs-watch-rebuild.ts
+++ b/packages/core/src/compiler/fs-watch/fs-watch-rebuild.ts
@@ -141,7 +141,7 @@ export const isWatchIgnorePath = (config: d.ValidatedConfig, path: string) => {
   }
   const outputTargets = config.outputTargets;
   const ignoreFiles = [
-    // Ignore components.d.ts — its disk write would cascade-rebuild all components.
+    // Ignore components.d.ts  its disk write would cascade-rebuild all components.
     getComponentsDtsSrcFilePath(config),
     ...outputTargets.filter(isOutputTargetDocsJson).map((o) => o.file),
     ...outputTargets.filter(isOutputTargetDocsJson).map((o) => o.typesFile),
diff --git a/packages/core/src/compiler/optimize/autoprefixer.ts b/packages/core/src/compiler/optimize/autoprefixer.ts
index b14a144a1f0..3e4aeac9668 100644
--- a/packages/core/src/compiler/optimize/autoprefixer.ts
+++ b/packages/core/src/compiler/optimize/autoprefixer.ts
@@ -133,7 +133,7 @@ export const autoprefixCss = async (
 
 /**
  * Default browserslist targets used when autoprefixing CSS in v5.
- * Targets modern browsers — IE11, old Edge, and very old mobile browsers
+ * Targets modern browsers  IE11, old Edge, and very old mobile browsers
  * are no longer included since Stencil v5 targets ES2017+ only.
  */
 const DEFAULT_BROWSER_TARGETS: string[] = [
diff --git a/packages/core/src/compiler/output-targets/_test_/output-targets-www-dist.spec.ts b/packages/core/src/compiler/output-targets/_test_/output-targets-www-dist.spec.ts
index a44e2d62776..51a684ce232 100644
--- a/packages/core/src/compiler/output-targets/_test_/output-targets-www-dist.spec.ts
+++ b/packages/core/src/compiler/output-targets/_test_/output-targets-www-dist.spec.ts
@@ -57,7 +57,7 @@ describe('outputTarget, www / loader-bundle', () => {
       path.join(root, 'custom-dist', 'cjs'),
     ]);
 
-    // default www/ must not exist — only custom-www/ should
+    // default www/ must not exist  only custom-www/ should
     expectFilesDoNotExist(compiler.fs, [
       path.join(root, 'www'),
       // custom-www with default index.html must not exist (custom indexHtml is custom-index.htm)
diff --git a/packages/core/src/compiler/output-targets/collection/index.ts b/packages/core/src/compiler/output-targets/collection/index.ts
index 8f2df766e1e..7d3534c9ca2 100644
--- a/packages/core/src/compiler/output-targets/collection/index.ts
+++ b/packages/core/src/compiler/output-targets/collection/index.ts
@@ -130,7 +130,7 @@ const writeCollectionOutput = async (
 };
 
 const generateAppDataModule = (build: d.BuildConditionals, config: d.ValidatedConfig): string => {
-  // JSON.stringify omits undefined fields — missing flags are treated as false by the runtime.
+  // JSON.stringify omits undefined fields  missing flags are treated as false by the runtime.
   const buildStr = JSON.stringify(build, null, 2);
   const envStr = JSON.stringify(config.env ?? {});
   const ns = JSON.stringify(config.fsNamespace);
@@ -167,7 +167,7 @@ const serializeCollectionManifest = (
   buildFlags.initializeNextTick = !!config.extras?.initializeNextTick;
   buildFlags.asyncQueue = config.taskQueue === 'congestionAsync';
 
-  // Hydration marker — consumers must know which selector the lib used so @stencil/vitest
+  // Hydration marker  consumers must know which selector the lib used so @stencil/vitest
   // and other tooling can detect when components are ready. Defaults to class-based.
   if (config.hydratedFlag) {
     buildFlags.hydratedAttribute = config.hydratedFlag.selector === 'attribute';
@@ -178,9 +178,9 @@ const serializeCollectionManifest = (
   }
   buildFlags.invisiblePrehydration =
     typeof config.invisiblePrehydration === 'undefined' ? true : config.invisiblePrehydration;
-  // constructableCSS is only false during HMR dev mode — always true in distributed output
+  // constructableCSS is only false during HMR dev mode  always true in distributed output
   buildFlags.constructableCSS = true;
-  // cssAnnotations gates addHydratedFlag (asyncLoading && cssAnnotations) — always true
+  // cssAnnotations gates addHydratedFlag (asyncLoading && cssAnnotations)  always true
   buildFlags.cssAnnotations = true;
 
   // create the single collection we're going to fill up with data
diff --git a/packages/core/src/compiler/output-targets/dist-lazy/lazy-output.ts b/packages/core/src/compiler/output-targets/dist-lazy/lazy-output.ts
index fb675c65c9c..25938c7628d 100644
--- a/packages/core/src/compiler/output-targets/dist-lazy/lazy-output.ts
+++ b/packages/core/src/compiler/output-targets/dist-lazy/lazy-output.ts
@@ -76,7 +76,7 @@ export const outputLazy = async (
           break;
         }
       } catch {
-        // file not readable yet — will be caught properly during actual style build
+        // file not readable yet  will be caught properly during actual style build
       }
     }
 
diff --git a/packages/core/src/compiler/output-targets/index.ts b/packages/core/src/compiler/output-targets/index.ts
index 4a1336fdf2a..1605fad8d0d 100644
--- a/packages/core/src/compiler/output-targets/index.ts
+++ b/packages/core/src/compiler/output-targets/index.ts
@@ -59,7 +59,7 @@ export const generateOutputTargets = async (
 
   invalidateRolldownCaches(compilerCtx);
 
-  // Skip bundler outputs on rebuilds where only HTML/assets changed — output would be identical.
+  // Skip bundler outputs on rebuilds where only HTML/assets changed  output would be identical.
   const needsBundlerRebuild =
     !buildCtx.isRebuild || buildCtx.hasScriptChanges || buildCtx.hasStyleChanges;
 
diff --git a/packages/core/src/compiler/output-targets/ssr-wasm/generate-ssr-wasm.ts b/packages/core/src/compiler/output-targets/ssr-wasm/generate-ssr-wasm.ts
index 57170ad6d2d..1ec7b31bea1 100644
--- a/packages/core/src/compiler/output-targets/ssr-wasm/generate-ssr-wasm.ts
+++ b/packages/core/src/compiler/output-targets/ssr-wasm/generate-ssr-wasm.ts
@@ -36,8 +36,8 @@ if (typeof globalThis !== "undefined") {
 `;
 
 // TypeScript interface file required by extism-js.
-// Must declare a 'main' module — extism-js uses this as the plugin entry point.
-// All functions are (): void — data flows via Host.inputString()/Host.outputString(),
+// Must declare a 'main' module  extism-js uses this as the plugin entry point.
+// All functions are (): void  data flows via Host.inputString()/Host.outputString(),
 // not as WASM return values. Use I32/I64/F32/F64 only for direct primitive returns.
 const SSR_WASM_INTERFACE = `declare module "main" {
   export function renderToString(): void;
@@ -46,8 +46,8 @@ const SSR_WASM_INTERFACE = `declare module "main" {
 }\n`;
 
 // Extism host entry points appended as rolldown `outro` inside the IIFE.
-// `Host` is a global provided by the Extism/QuickJS-ng runtime — no import needed.
-// Functions reference bundled symbols by name via closure — resolved lazily at call
+// `Host` is a global provided by the Extism/QuickJS-ng runtime  no import needed.
+// Functions reference bundled symbols by name via closure  resolved lazily at call
 // time, so QuickJS-ng sees the fully-initialized IIFE scope rather than an eager
 // snapshot taken during IIFE setup (which QuickJS-ng resolves incorrectly).
 // setTagTransformer accepts [{from: string, to: string}] and builds a tag transformer.
@@ -92,7 +92,7 @@ export const generateSsrWasmApp = async (
 
     const rolldownOptions: InputOptions = {
       ...config.rolldownConfig,
-      // No externals — everything must be self-contained in the WASM binary
+      // No externals  everything must be self-contained in the WASM binary
       external: [],
       input,
       plugins: [
@@ -123,7 +123,7 @@ export const generateSsrWasmApp = async (
         },
       ],
       treeshake: false,
-      // ES2020 max — QuickJS-ng constraint for extism-js compatibility
+      // ES2020 max  QuickJS-ng constraint for extism-js compatibility
       transform: { target: 'es2020' },
       onwarn: createOnWarnFn(buildCtx.diagnostics),
       checks: { pluginTimings: config.logLevel === 'debug' },
@@ -135,7 +135,7 @@ export const generateSsrWasmApp = async (
       outro: SSR_WASM_OUTRO,
       format: 'iife',
       // IIFE supplies `exports` as its parameter, which the bundled CJS code needs.
-      // The global name is unused — extism-js reads module.exports from inside the IIFE.
+      // The global name is unused  extism-js reads module.exports from inside the IIFE.
       name: 'StencilSsrWasm',
       file: 'index.js',
     });
@@ -203,7 +203,7 @@ const compileToWasm = async (
     const warn = buildWarn(buildCtx.diagnostics);
     if (e.code === 'ENOENT') {
       warn.messageText =
-        `ssr-wasm: extism-js not found — index.js was written but index.wasm was not generated. ` +
+        `ssr-wasm: extism-js not found  index.js was written but index.wasm was not generated. ` +
         `Install extism-js: https://github.com/extism/js-pdk`;
     } else {
       warn.messageText = `ssr-wasm: extism-js compile failed: ${e.message}`;
diff --git a/packages/core/src/compiler/output-targets/standalone/generate-loader-module.ts b/packages/core/src/compiler/output-targets/standalone/generate-loader-module.ts
index 317f1dc01e8..baa5419e33f 100644
--- a/packages/core/src/compiler/output-targets/standalone/generate-loader-module.ts
+++ b/packages/core/src/compiler/output-targets/standalone/generate-loader-module.ts
@@ -24,7 +24,7 @@ export const generateLoaderModule = (
   // Tag name list for the loader
   const tagsList = components.map((cmp) => `'${cmp.tagName}'`).join(', ');
 
-  // Static import switch cases — allows bundlers like Vite to analyze imports
+  // Static import switch cases  allows bundlers like Vite to analyze imports
   const switchCases = components
     .map(
       (cmp) => `      case '${cmp.tagName}': module = await import('./${cmp.tagName}.js'); break;`,
@@ -79,7 +79,7 @@ let observer;
  *    ancestor's \`s-p\` array. That Promise resolves only after the child's full
  *    initial lifecycle completes (\`componentDidLoad\`). This prevents the
  *    ancestor from calling its own \`componentDidLoad\` before all its
- *    descendants are ready — even when a descendant's module loads *after* the
+ *    descendants are ready  even when a descendant's module loads *after* the
  *    ancestor has already started rendering.
  *
  * @param root - The root element to scan
@@ -133,7 +133,7 @@ async function load(root) {
     }
   }
 
-  // Load all unique tags in parallel — lifecycle ordering is handled by the
+  // Load all unique tags in parallel  lifecycle ordering is handled by the
   // pre-marked s-p/s-rc arrays and the wired-up ready promises above.
   await Promise.allSettled([...pending].map(register));
 }
diff --git a/packages/core/src/compiler/style/_test_/css-imports.spec.ts b/packages/core/src/compiler/style/_test_/css-imports.spec.ts
index 364b6e48580..9c8024dd7cd 100644
--- a/packages/core/src/compiler/style/_test_/css-imports.spec.ts
+++ b/packages/core/src/compiler/style/_test_/css-imports.spec.ts
@@ -757,13 +757,13 @@ describe('css-imports', () => {
     describe('virtual imports', () => {
       const filePath = normalizePath(path.join(root, 'src', 'global.css'));
 
-      it('skips @import "stencil-globals" — not resolved as a file', async () => {
+      it('skips @import "stencil-globals"  not resolved as a file', async () => {
         const content = `@import "stencil-globals";`;
         const results = await getCssImports(config, compilerCtx, buildCtx, filePath, content);
         expect(results).toHaveLength(0);
       });
 
-      it('skips @import "stencil-hydrate" — not resolved as a file', async () => {
+      it('skips @import "stencil-hydrate"  not resolved as a file', async () => {
         const content = `@import "stencil-hydrate";`;
         const results = await getCssImports(config, compilerCtx, buildCtx, filePath, content);
         expect(results).toHaveLength(0);
diff --git a/packages/core/src/compiler/style/css-imports.ts b/packages/core/src/compiler/style/css-imports.ts
index 6d6c5caaef2..1d2fb24974c 100644
--- a/packages/core/src/compiler/style/css-imports.ts
+++ b/packages/core/src/compiler/style/css-imports.ts
@@ -199,7 +199,7 @@ export const getCssImports = async (
     }
 
     if (cssImportData.url === 'stencil-globals' || cssImportData.url === 'stencil-hydrate') {
-      // virtual imports resolved by Stencil at build time — leave them in the CSS unchanged
+      // virtual imports resolved by Stencil at build time  leave them in the CSS unchanged
       continue;
     }
 
diff --git a/packages/core/src/compiler/sys/typescript/typescript-config.ts b/packages/core/src/compiler/sys/typescript/typescript-config.ts
index 559a079514c..4ecde333f54 100644
--- a/packages/core/src/compiler/sys/typescript/typescript-config.ts
+++ b/packages/core/src/compiler/sys/typescript/typescript-config.ts
@@ -97,7 +97,7 @@ export const validateTsConfig = async (
         }
       }
 
-      // Always extract compilerOptions and watchOptions — even when TS reports
+      // Always extract compilerOptions and watchOptions  even when TS reports
       // non-fatal errors (e.g. TS18003 “No inputs found” on an empty src dir).
       if (results.watchOptions) {
         tsconfig.watchOptions = results.watchOptions;
diff --git a/packages/core/src/compiler/sys/typescript/typescript-sys.ts b/packages/core/src/compiler/sys/typescript/typescript-sys.ts
index 298bbbe8f18..61142fdb24d 100644
--- a/packages/core/src/compiler/sys/typescript/typescript-sys.ts
+++ b/packages/core/src/compiler/sys/typescript/typescript-sys.ts
@@ -108,7 +108,7 @@ export const patchTsSystemFileSystem = (
 
   tsSys.readDirectory = (path, extensions, exclude, include, depth) => {
     const cwd = compilerSys.getCurrentDirectory();
-    // `matchFiles` is an internal TypeScript API with no public equivalent — it handles
+    // `matchFiles` is an internal TypeScript API with no public equivalent  it handles
     // extension filtering, exclusion patterns, and depth traversal in one call.
     return (ts as any).matchFiles(
       path,
diff --git a/packages/core/src/compiler/transformers/_test_/parse-extends.spec.ts b/packages/core/src/compiler/transformers/_test_/parse-extends.spec.ts
index 46254892360..12468b4b1f6 100644
--- a/packages/core/src/compiler/transformers/_test_/parse-extends.spec.ts
+++ b/packages/core/src/compiler/transformers/_test_/parse-extends.spec.ts
@@ -144,7 +144,7 @@ describe('transpile() – cross-file class extension', () => {
 
     const cmp = results.data?.[0];
     const propNames = cmp.properties.map((p: any) => p.name);
-    // Only one entry for `baseProp` — it should not appear twice
+    // Only one entry for `baseProp`  it should not appear twice
     expect(propNames.filter((n: string) => n === 'baseProp')).toHaveLength(1);
   });
 });
diff --git a/packages/core/src/compiler/transformers/add-tag-transform.ts b/packages/core/src/compiler/transformers/add-tag-transform.ts
index a852c51296d..11aa2a50065 100644
--- a/packages/core/src/compiler/transformers/add-tag-transform.ts
+++ b/packages/core/src/compiler/transformers/add-tag-transform.ts
@@ -102,7 +102,7 @@ export const addTagTransform = (
 
                 // If no placeholders for whatever reason, fallback to original literal
                 if (!splitParts || splitParts.length === 0) {
-                  // fallback — keep original string literal
+                  // fallback  keep original string literal
                   newNode = ts.factory.updateCallExpression(
                     node,
                     node.expression,
diff --git a/packages/core/src/compiler/transformers/automatic-key-insertion/utils.ts b/packages/core/src/compiler/transformers/automatic-key-insertion/utils.ts
index b209618feef..222eecae4fe 100644
--- a/packages/core/src/compiler/transformers/automatic-key-insertion/utils.ts
+++ b/packages/core/src/compiler/transformers/automatic-key-insertion/utils.ts
@@ -15,7 +15,7 @@ export function resetKeyCounter(): void {
  * Keys are base-36 integers, reset to 0 for each render() method, so they
  * are short (1-2 chars for most components) and stable across re-renders.
  *
- * @param _jsxElement unused — kept for API compatibility
+ * @param _jsxElement unused  kept for API compatibility
  * @returns a short unique key string
  */
 export function deriveJSXKey(_jsxElement: ts.JsxOpeningElement | ts.JsxSelfClosingElement): string {
diff --git a/packages/core/src/compiler/transpile/run-program.ts b/packages/core/src/compiler/transpile/run-program.ts
index 313ee9ba544..369453949ae 100644
--- a/packages/core/src/compiler/transpile/run-program.ts
+++ b/packages/core/src/compiler/transpile/run-program.ts
@@ -215,7 +215,7 @@ export const validateTypesAfterGeneration = async (
   const componentsDtsPath = join(config.srcDir, 'components.d.ts');
   const componentsDtsExistedBefore = await compilerCtx.fs.access(componentsDtsPath);
 
-  // First run: components.d.ts doesn't exist yet — generate it and request a fresh TS program.
+  // First run: components.d.ts doesn't exist yet  generate it and request a fresh TS program.
   if (!componentsDtsExistedBefore) {
     await generateAppTypes(config, compilerCtx, buildCtx, 'src');
     return { hasTypesChanged: true, needsRebuild: true };
@@ -231,7 +231,7 @@ export const validateTypesAfterGeneration = async (
     };
 
     if (buildCtx.isRebuild) {
-      // Incremental: only walks changed files + transitive dependents — O(changed) not O(all).
+      // Incremental: only walks changed files + transitive dependents  O(changed) not O(all).
       const emitBuilder = tsBuilder as ts.EmitAndSemanticDiagnosticsBuilderProgram;
       let affected = emitBuilder.getSemanticDiagnosticsOfNextAffectedFile?.();
       while (affected) {
diff --git a/packages/core/src/compiler/transpile/ts-config.ts b/packages/core/src/compiler/transpile/ts-config.ts
index bc1e76edd57..c99ada2088c 100644
--- a/packages/core/src/compiler/transpile/ts-config.ts
+++ b/packages/core/src/compiler/transpile/ts-config.ts
@@ -33,7 +33,7 @@ export const getTsOptionsToExtend = (config: d.ValidatedConfig): ts.CompilerOpti
         : ts.ModuleResolutionKind.NodeJs,
     noEmitOnError: config.tsCompilerOptions?.noEmitOnError || false,
     // Explicitly set rootDir so TypeScript doesn't have to infer it from the
-    // LCA of source files — important when the tsconfig lives at a different
+    // LCA of source files  important when the tsconfig lives at a different
     // location from the source root (e.g. a shared test fixture).
     rootDir: config.rootDir,
     outDir: cacheDir,
diff --git a/packages/core/src/declarations/stencil-private.ts b/packages/core/src/declarations/stencil-private.ts
index 77e477aa21a..08647b5db60 100644
--- a/packages/core/src/declarations/stencil-private.ts
+++ b/packages/core/src/declarations/stencil-private.ts
@@ -175,7 +175,7 @@ export interface BuildConditionals extends Partial<BuildFeatures> {
   lazyLoad?: boolean;
   profile?: boolean;
   constructableCSS?: boolean;
-  /** True when `extras.lightDomPatches === true` — enables `applyLightDomPatches` shortcut. */
+  /** True when `extras.lightDomPatches === true`  enables `applyLightDomPatches` shortcut. */
   lightDomPatches?: boolean;
   /** Patch `childNodes`/`children` getters on light-dom slotted components. */
   slotChildNodes?: boolean;
@@ -188,13 +188,13 @@ export interface BuildConditionals extends Partial<BuildFeatures> {
   hydratedAttribute?: boolean;
   hydratedClass?: boolean;
   hydratedSelectorName?: string;
-  /** True when a global-style input contains `@import "stencil-hydrate"` — suppresses dynamic style injection in the loader. */
+  /** True when a global-style input contains `@import "stencil-hydrate"`  suppresses dynamic style injection in the loader. */
   staticHydrationStyles?: boolean;
   initializeNextTick?: boolean;
   asyncQueue?: boolean;
   additionalTagTransformers?: boolean | 'prod';
   signalBacking?: boolean;
-  /** True when JSX signal bypass is active — text nodes and attributes backed by Signal objects update the DOM directly. Auto-enabled when `signalBacking: true`. */
+  /** True when JSX signal bypass is active  text nodes and attributes backed by Signal objects update the DOM directly. Auto-enabled when `signalBacking: true`. */
   vdomSignals?: boolean;
 }
 
diff --git a/packages/core/src/declarations/stencil-public-compiler.ts b/packages/core/src/declarations/stencil-public-compiler.ts
index 815f846a820..53a65cb90da 100644
--- a/packages/core/src/declarations/stencil-public-compiler.ts
+++ b/packages/core/src/declarations/stencil-public-compiler.ts
@@ -357,7 +357,7 @@ interface ConfigExtrasBase {
 
   /**
    * Replace `@State` and `@Prop` internals with `@preact/signals-core` signal primitives.
-   * Enables cross-framework reactive interop — component state becomes subscribable by
+   * Enables cross-framework reactive interop  component state becomes subscribable by
    * Solid, Angular, Preact and any TC39-signal-compatible library without event/attribute
    * roundtrips. No API changes required in component code.
    * Defaults to `false`.
@@ -1981,7 +1981,7 @@ export interface OutputTargetLoaderBundle extends OutputTargetBaseNext {
    * When `true`, marks `@stencil/core` as an external dependency in the bundler (ESM/CJS)
    * distribution output. Consumers must provide `@stencil/core` themselves.
    *
-   * Has no effect on the browser/CDN build — the runtime is always bundled there.
+   * Has no effect on the browser/CDN build  the runtime is always bundled there.
    *
    * @default false
    */
diff --git a/packages/core/src/declarations/stencil-public-runtime.ts b/packages/core/src/declarations/stencil-public-runtime.ts
index d372faeafbe..84173b113c8 100644
--- a/packages/core/src/declarations/stencil-public-runtime.ts
+++ b/packages/core/src/declarations/stencil-public-runtime.ts
@@ -69,7 +69,7 @@ export interface ComponentOptions {
 
   /**
    * Relative URL to an external stylesheet providing document-level styles for this component.
-   * Unlike `styleUrl`, these styles are not scoped to shadow/scoped DOM — they are collected
+   * Unlike `styleUrl`, these styles are not scoped to shadow/scoped DOM  they are collected
    * at build time and injected wherever `@import "stencil-globals"` appears in a global stylesheet.
    *
    * Useful for
diff --git a/packages/core/src/runtime/_test_/signal-backing.spec.tsx b/packages/core/src/runtime/_test_/signal-backing.spec.tsx
index c6dc87b54bd..1c61318e3b3 100644
--- a/packages/core/src/runtime/_test_/signal-backing.spec.tsx
+++ b/packages/core/src/runtime/_test_/signal-backing.spec.tsx
@@ -635,7 +635,7 @@ describe('signals (signalBacking: true)', () => {
 // ── getSignal / STENCIL_SIGNALS_SYMBOL ────────────────────────────────────
 
 describe('getSignal', () => {
-  it('returns null for a @State member — state is internal', async () => {
+  it('returns null for a @State member  state is internal', async () => {
     @Component({ tag: 'cmp-a' })
     class CmpA {
       @State() count = 5;
diff --git a/packages/core/src/runtime/hmr-component.ts b/packages/core/src/runtime/hmr-component.ts
index 6b0c6090d76..4185fae669d 100644
--- a/packages/core/src/runtime/hmr-component.ts
+++ b/packages/core/src/runtime/hmr-component.ts
@@ -62,7 +62,7 @@ const hmrStandalone = async (
   console.log(`[Stencil HMR] hmrStandalone <${cmpMeta.$tagName$}> modulePath:`, modulePath);
   if (!modulePath) {
     console.warn(
-      `[Stencil HMR] No __stencil_module__ on <${cmpMeta.$tagName$}> constructor — was this built with devMode?`,
+      `[Stencil HMR] No __stencil_module__ on <${cmpMeta.$tagName$}> constructor  was this built with devMode?`,
     );
     return;
   }
@@ -74,7 +74,7 @@ const hmrStandalone = async (
       `${modulePath}?s-hmr=${hmrVersionId}`
     );
 
-    // Find the updated class — prefer a named export whose `.is` tag matches,
+    // Find the updated class  prefer a named export whose `.is` tag matches,
     // fall back to the default export
     const NewClass: any =
       Object.values(newModule).find(
@@ -87,7 +87,7 @@ const hmrStandalone = async (
 
     // Patch the registered constructor prototype in-place so all existing
     // instances pick up the new render/lifecycle methods.
-    // Object.assign is intentionally NOT used here — class methods are
+    // Object.assign is intentionally NOT used here  class methods are
     // non-enumerable and would be silently skipped.
     const ctor = customElements.get(cmpMeta.$tagName$) as any;
 
diff --git a/packages/core/src/runtime/render.ts b/packages/core/src/runtime/render.ts
index 4ff23215791..9d871f54c9b 100644
--- a/packages/core/src/runtime/render.ts
+++ b/packages/core/src/runtime/render.ts
@@ -4,7 +4,7 @@ import { renderVdom } from './vdom/vdom-render';
 
 /**
  * A WeakMap to persist HostRef objects across multiple render() calls to the
- * same container. This enables VNode diffing on re-renders — without it, each
+ * same container. This enables VNode diffing on re-renders  without it, each
  * call creates a fresh HostRef with no previous VNode, causing renderVdom to
  * replace the entire DOM subtree instead of patching only what changed.
  */
diff --git a/packages/core/src/runtime/set-value.ts b/packages/core/src/runtime/set-value.ts
index 1ec3c30ca08..8a16d0bcbea 100644
--- a/packages/core/src/runtime/set-value.ts
+++ b/packages/core/src/runtime/set-value.ts
@@ -165,7 +165,7 @@ export const setValue = (
             const [[watchMethodName, watcherFlags]] = Object.entries(watcher);
             if (flags & HOST_FLAGS.isWatchReady || watcherFlags & WATCH_FLAGS.Immediate) {
               // When signalBacking is on and signals haven't been initialized yet,
-              // skip watcher dispatch here — the signal watcher effect will fire
+              // skip watcher dispatch here  the signal watcher effect will fire
               // synchronously during initializeSignals and handle it instead.
               if (BUILD.signalBacking && !hostRef.$signalValues$) return;
               // fire off each of the watch methods that are watching this property
diff --git a/packages/core/src/runtime/signals.ts b/packages/core/src/runtime/signals.ts
index 28938858f30..d956b6b7a1e 100644
--- a/packages/core/src/runtime/signals.ts
+++ b/packages/core/src/runtime/signals.ts
@@ -122,7 +122,7 @@ export const initializeSignals = (
     );
   }
 
-  // Expose only @Prop signals externally — @State is internal implementation detail
+  // Expose only @Prop signals externally  @State is internal implementation detail
   const publicSignals = new Map(
     [...hostRef.$signalValues$].filter(
       ([k]) => (cmpMeta.$members$?.[k]?.[0] ?? 0) & MEMBER_FLAGS.Prop,
diff --git a/packages/core/src/runtime/update-component.ts b/packages/core/src/runtime/update-component.ts
index 99003ce5281..800e83cbc0f 100644
--- a/packages/core/src/runtime/update-component.ts
+++ b/packages/core/src/runtime/update-component.ts
@@ -85,7 +85,7 @@ const dispatchHooks = (hostRef: d.HostRef, isInitialLoad: boolean): Promise<void
   if (!instance) {
     if (BUILD.isDev) {
       throw new Error(
-        `Can't render <${elm.tagName.toLowerCase()} /> — compiled without externalRuntime: true. See https://stenciljs.com/docs/custom-elements#externalruntime`,
+        `Can't render <${elm.tagName.toLowerCase()} />  compiled without externalRuntime: true. See https://stenciljs.com/docs/custom-elements#externalruntime`,
       );
     }
     return;
diff --git a/packages/core/src/runtime/vdom/h.ts b/packages/core/src/runtime/vdom/h.ts
index 21ffe215d38..6799b737cbe 100644
--- a/packages/core/src/runtime/vdom/h.ts
+++ b/packages/core/src/runtime/vdom/h.ts
@@ -35,7 +35,7 @@ export const h = (nodeName: any, vnodeData: any, ...children: d.ChildType[]): d.
         if (BUILD.vdomSignals && isSignalLike(child)) {
           // Signal child: create a text VNode seeded with the current value,
           // store signal reference for createElm to subscribe.
-          // Handled as a complete branch — does NOT fall through to the outer push.
+          // Handled as a complete branch  does NOT fall through to the outer push.
           const sigVNode = newVNode(null, String(child.peek()));
           sigVNode.$signal$ = child;
           vNodeChildren.push(sigVNode);
diff --git a/packages/core/src/signals/index.ts b/packages/core/src/signals/index.ts
index 7da6b07b82d..e9ceec5db36 100644
--- a/packages/core/src/signals/index.ts
+++ b/packages/core/src/signals/index.ts
@@ -11,7 +11,7 @@ export type { ReadonlySignal, Signal } from '@preact/signals-core';
 /**
  * Returns the `ReadonlySignal` backing a `@Prop` member on a Stencil element.
  * Requires `extras.signalBacking: true` in `stencil.config.ts`.
- * Only `@Prop` members are exposed — `@State` is internal component state.
+ * Only `@Prop` members are exposed  `@State` is internal component state.
  *
  * Useful for cross-component or cross-framework reactivity without polling or events:
  * ```ts
diff --git a/packages/core/src/utils/constants.ts b/packages/core/src/utils/constants.ts
index bf9a603c08d..dc460ca5873 100644
--- a/packages/core/src/utils/constants.ts
+++ b/packages/core/src/utils/constants.ts
@@ -89,7 +89,7 @@ export const CMP_FLAGS = {
    * Used to determine if a component does not use the shadow DOM _and_ has `<slot/>` tags in its markup.
    */
   hasSlotRelocation: 1 << 2,
-  // bit 3 (1 << 3) is reserved — was needsShadowDomShim, removed in v5
+  // bit 3 (1 << 3) is reserved  was needsShadowDomShim, removed in v5
   /**
    * Determines if `delegatesFocus` is enabled for a component that uses the shadow DOM.
    * e.g. `shadow: { delegatesFocus: true }` is set on the `@Component()` decorator
@@ -100,7 +100,7 @@ export const CMP_FLAGS = {
    */
   hasMode: 1 << 5,
   /**
-   * Determines if styles must be scoped — i.e. the component uses scoped stylesheets.
+   * Determines if styles must be scoped  i.e. the component uses scoped stylesheets.
    */
   needsScopedEncapsulation: CF_scopedCssEncapsulation,
   /**
diff --git a/packages/core/tsdown.config.ts b/packages/core/tsdown.config.ts
index ec1bf207d6b..8cc75a7784d 100644
--- a/packages/core/tsdown.config.ts
+++ b/packages/core/tsdown.config.ts
@@ -206,7 +206,7 @@ export default defineConfig([
     plugins: [virtualModules({ resolve: virtualResolve })],
   },
 
-  // @stencil/core/signals — public signals primitives + @Effect decorator
+  // @stencil/core/signals  public signals primitives + @Effect decorator
   {
     entry: {
       'signals/index': 'src/signals/index.ts',
diff --git a/test/build/global-style/src/global.css b/test/build/global-style/src/global.css
index 0a82e567597..90a1e31f0d0 100644
--- a/test/build/global-style/src/global.css
+++ b/test/build/global-style/src/global.css
@@ -1,4 +1,4 @@
-/* FOUC prevention — replaced at build time with component visibility rules */
+/* FOUC prevention  replaced at build time with component visibility rules */
 @import 'stencil-hydrate';
 
 /* Base page styles */
diff --git a/test/build/global-style/validate.js b/test/build/global-style/validate.js
index 6d982de7c7a..e328a8e31c9 100644
--- a/test/build/global-style/validate.js
+++ b/test/build/global-style/validate.js
@@ -28,7 +28,7 @@ assert(
   'Missing cmp-b display rule',
 );
 
-// Both virtual imports are fully resolved — not present in output
+// Both virtual imports are fully resolved  not present in output
 assert(
   !css.includes('stencil-globals'),
   'stencil-globals virtual import should be resolved, not present in output',
@@ -51,7 +51,7 @@ assert(
 );
 
 // stencil-hydrate.css must NOT be generated when @import "stencil-hydrate" is present
-// in a global-style input — the standalone output target should detect this and skip it.
+// in a global-style input  the standalone output target should detect this and skip it.
 const hydrateCssPath = path.resolve(__dirname, 'dist', 'assets', 'stencil-hydrate.css');
 let hydrateFileExists = true;
 try {
diff --git a/test/runtime/src/components/rendering/render-vdom/render-vdom.spec.tsx b/test/runtime/src/components/rendering/render-vdom/render-vdom.spec.tsx
index f35d2d7dc88..11d38fe87c3 100644
--- a/test/runtime/src/components/rendering/render-vdom/render-vdom.spec.tsx
+++ b/test/runtime/src/components/rendering/render-vdom/render-vdom.spec.tsx
@@ -63,7 +63,7 @@ describe('render-vdom', () => {
     );
 
     const input = container.querySelector('#test-input') as HTMLInputElement;
-    // Simulate user typing — this is internal DOM state not controlled by VDOM
+    // Simulate user typing  this is internal DOM state not controlled by VDOM
     input.value = 'user typed this';
 
     // Re-render with updated content but same input
diff --git a/test/special-config/signals/src/components/signal-prop-cmp/signal-prop-cmp.spec.tsx b/test/special-config/signals/src/components/signal-prop-cmp/signal-prop-cmp.spec.tsx
index 8341dd3a25c..9d254a562b3 100644
--- a/test/special-config/signals/src/components/signal-prop-cmp/signal-prop-cmp.spec.tsx
+++ b/test/special-config/signals/src/components/signal-prop-cmp/signal-prop-cmp.spec.tsx
@@ -33,7 +33,7 @@ describe('signal-prop-cmp (@Prop)', () => {
   });
 });
 
-describe('signal-prop-cmp — External Signal API', () => {
+describe('signal-prop-cmp  External Signal API', () => {
   describe('getSignal()', () => {
     it('returns a ReadonlySignal for a @Prop member', async () => {
       const { root } = await render<HTMLSignalPropCmpElement>(<signal-prop-cmp label='hi' />);

From 83a71c4acd3c79b5969c47ccbf66b8b0aede1a48 Mon Sep 17 00:00:00 2001
From: John Jenkins <johnljenkins@hotmail.com>
Date: Sat, 23 May 2026 12:06:30 +0100
Subject: [PATCH 3/3] chore: tidy planning

---
 V5_PLANNING.md | 166 ++-----------------------------------------------
 1 file changed, 4 insertions(+), 162 deletions(-)

diff --git a/V5_PLANNING.md b/V5_PLANNING.md
index c884ce49b32..885717d5632 100644
--- a/V5_PLANNING.md
+++ b/V5_PLANNING.md
@@ -130,6 +130,7 @@ Modernize Stencil after 10 years: shed tech debt, embrace modern tooling, simpli
 - **`@Component` now supports `globalStyleUrl` and `globalStyle`**  co-locate document-level styles with the component. Styles are collected at build time and injected wherever `@import "stencil-globals"` appears in a global stylesheet. Works for all encapsulation types (shadow, scoped, none). No mode variants  CSS handles runtime variants via selectors or custom properties. Changes to `globalStyleUrl` files invalidate the global style build cache and trigger HMR correctly.
 - **`@import "stencil-hydrate"` virtual placeholder**  add to any `global-style` input to inject static FOUC-prevention CSS at build time instead of relying on the dynamic `<style>` tag inserted by the loader. The compiler replaces the placeholder with the sorted component selectors + configured hydration CSS (e.g. `my-cmp,other-cmp{visibility:hidden}.hydrated{visibility:inherit}`). When detected, `BUILD.staticHydrationStyles = true` suppresses the loader's dynamic injection. For `standalone` builds (which have no loader), `stencil-hydrate.css` is auto-generated alongside the bundle.
 - **`loader-bundle` now supports `externalRuntime`**  set `externalRuntime: true` on the `loader-bundle` output target to mark `@stencil/core` as an external dependency in the ESM/CJS distribution output. Only affects the bundler variant; the browser/CDN build always includes the runtime. Useful when consumers already depend on `@stencil/core` and want to avoid bundling a second copy.
+- **Signals** — opt-in signal-backed reactivity via `extras.signalBacking: true`. Zero API changes for component authors; `@State` and `@Prop` are backed by `@preact/signals-core` signals internally. New `@stencil/core/signals` subpath exports `signal`, `computed`, `effect`, `batch`, `untracked`, `@Effect()`, `getSignal<T>()`, and `STENCIL_SIGNALS_SYMBOL` for cross-framework interop. Signal values are valid JSX children and attributes — DOM updates bypass the vdom diff entirely. `@Prop`-only signals are exposed on the host element via `Symbol.for('stencil.signals')` for framework adapters without requiring a `@stencil/core` import.
 
 ---
 
@@ -219,169 +220,10 @@ pnpm run dev       # Watch mode
 
 ---
 
----
-
-## ⚡ Signals Integration (In Progress)
-
-### Vision
-
-Replace `@State`/`@Prop` internals with signals via a single opt-in config flag  zero API changes for component authors, cleaner reactivity, cross-framework interop. If it proves popular, make it the default in a later release.
-
-### Approach
-
-Global `extras.signalBacking: true` flag in `stencil.config.ts`. Controls a `BUILD.signalBacking` compile-time constant that tree-shakes the entire signal code path in or out. No per-component or per-decorator changes needed.
-
-```typescript
-// stencil.config.ts
-export const config: Config = {
-  extras: {
-    signalBacking: true  // opt-in
-  }
-};
-
-// Components unchanged  @State and @Prop work identically
-@Component({ tag: 'my-counter' })
-export class MyCounter {
-  @State() count = 0;
-  render() { return <div>{this.count}</div>; }
-}
-```
-
-### Why not per-decorator opt-in?
-
-- **Runtime bytes:** global flag means one code path (signal OR Map), tree-shaken cleanly. Per-decorator would ship both paths in every bundle.
-- **Hot path performance:** no per-member flag check on every getter/setter call.
-- **Simpler implementation:** no `MEMBER_FLAGS.SignalBacked` in compiler metadata, no branching in proxy internals.
-- **Simpler user model:** "my app uses signals" is a project-level decision.
-
-### Signal library
-
-`@preact/signals-core`  production-stable, ~1.3kb, zero deps, convergent with TC39. Abstracted behind `packages/core/src/runtime/signals.ts` so it can be swapped if TC39 finalizes.
-
-### Why bother over `@Watch`?
-
-`@Watch` covers derived state within a component. Signal-backing adds:
-
-1. **Cross-framework interop**  Stencil component state becomes subscribable by Solid/Angular/Preact reactive systems natively, no event/attribute roundtrip.
-2. **Computed derivations**  lazy, auto-dep-tracked, composable. No intermediate `@State` + watcher boilerplate.
-3. **Path to JSX leaf bypass**  signal objects in JSX can skip the vdom diff and update DOM nodes directly (Phase 2).
-
-### Phases
-
-#### Phase 1  Signal-backed `@State` and `@Prop`
-- [x] Add `@preact/signals-core` to `packages/core`
-- [x] Create `packages/core/src/runtime/signals.ts`  adapter (`signal`, `computed`, `effect`, `batch`, `untracked`) + `initializeSignals`
-- [x] Add `signalBacking?: boolean` to `extras` config type (`ConfigExtrasBase`)
-- [x] Add `BUILD.signalBacking` constant + wire from `updateBuildConditionals` + `COLLECTION_CONFIG_FLAGS`
-- [x] `$signalValues$` + `$signalCleanup$` added to `HostRef`; `signalBacking` added to `BuildConditionals`
-- [x] **`set-value.ts`:** signal fast-path in `getValue` + `setValue`  bypasses Map once signals are initialized
-- [x] **`initialize-component.ts`:** calls `initializeSignals` before first `scheduleUpdate`  allocates one `Signal.State` per `@Prop`/`@State` member, seeded from `$instanceValues$`
-- [x] **Scheduling:** per-prop `effect()` calls `scheduleUpdate()` on change (first run is no-op  `hasRendered` guard)
-- [x] **Watchers:** per-prop `effect()` fires `@Watch` callbacks with old/new value
-- [x] **`componentShouldUpdate`:** called from within the scheduling effect, can still veto
-- [x] **`@Prop` attribute path:** works via existing `attributeChangedCallback` → proxy setter → `setValue` signal fast-path
-- [x] **Disconnect cleanup:** `disconnected-callback.ts` calls `$signalCleanup$()` and nulls it on real disconnects (skipped for temporary slot relocations)
-- [x] **`reflect: true` with custom serializers:** serializer now runs inside the signal fast-path before `sig.value` is set, populating `$serializerValues$` before the triggered re-render
-- [x] Tests  unit (`signals.spec.ts`) + integration (`signal-backing.spec.tsx`)
-
-#### Phase 2  `@stencil/core/signals` subpath ✅ Complete
-- [x] New `packages/core/src/signals/index.ts`  public entry for signal primitives + decorators
-- [x] Re-exports `signal`, `computed`, `effect`, `batch`, `untracked` from `@preact/signals-core` (bundled, no extra install)
-- [x] `Signal<T>` and `ReadonlySignal<T>` declared as Stencil-owned interfaces (not re-exported from preact) so generated `components.d.ts` references `@stencil/core/signals` rather than `@preact/signals-core`
-- [x] `@Effect()`  pure runtime TS decorator; marks a method as a reactive effect, auto-tracked deps, auto-cleaned up on disconnect. Requires `signalBacking: true` (wired in `initializeSignals`)
-- ~~`@Computed()` decorator~~  **removed**. Adds no value over `computed()` as a class field, and the return-type change (`ReadonlySignal<T>` vs `T`) created a typing nightmare for users.
-- [x] `@Effect()` without `signalBacking`  currently requires `signalBacking: true`; wiring could be moved to `initialize-component.ts` to support external-signal-only use cases
-- [x] **`getSignal<T>(elm, prop)`**  returns the `ReadonlySignal<T>` backing a `@Prop` member; returns `null` for `@State` members (internal) or if not signal-backed. Enables Stencil-to-Stencil reactive composition without events.
-- [x] **`STENCIL_SIGNALS_SYMBOL`** (`Symbol.for('stencil.signals')`)  a `@Prop`-only signal map is set on the host element after `initializeSignals`, cleared on disconnect. `@State` is excluded. Framework adapters (Solid, Angular, Preact) can subscribe without importing from `@stencil/core`.
-
-**External Signal API:**
-
-Two mechanisms let code *outside* a component subscribe to its reactive state:
-
-`getSignal<T>(elm, prop)`  typed, null-safe access for Stencil-aware code:
-
-```ts
-import { getSignal } from '@stencil/core/signals';
-
-const countSig = getSignal<number>(document.querySelector('my-counter'), 'count');
-countSig?.subscribe(v => console.log('count =', v));
-
-// Derive from multiple components without polling or events:
-const total = computed(() =>
-  getSignal<number>(cartEl, 'itemCount')!.value +
-  getSignal<number>(wishlistEl, 'itemCount')!.value
-);
-```
-
-`STENCIL_SIGNALS_SYMBOL`  zero-import interop for framework wrappers and adapters:
-
-```ts
-// Works in Solid, Angular, Preact wrappers  no @stencil/core import required
-const sigs = el[Symbol.for('stencil.signals')];
-sigs?.get('count')?.subscribe(v => console.log('count =', v));
-```
-
-**Design decisions:**
-
-- **`@Prop` only, not `@State`:** `@State` is internal component implementation  exposing it would let external code depend on details that components are free to change. Framework adapters and parent components should only observe the declared public interface (`@Prop`). Internally, `$signalValues$` still holds both `@Prop` and `@State` signals (the write path in `set-value.ts` needs them); the symbol and `getSignal` expose a filtered copy containing only `@Prop` members.
-- **`ReadonlySignal<T>` not `Signal<T>` from `getSignal`:** External consumers must not write directly to a component's `@Prop`  they should set the attribute/property via the DOM. `ReadonlySignal` enforces this at the type level. `computed()` values also satisfy `ReadonlySignal`, so the type composes naturally.
-- **Symbol not typed as a property on `HostElement`:** TypeScript's `Symbol.for()` returns `symbol` (not `unique symbol`), which can't be used as a computed property key in interfaces. Adding an index signature (`[symbol: symbol]: Map<...>`) to `HostElement` breaks `HTMLElement` assignability throughout the codebase. Accepted limitation  framework adapters access it via `el[Symbol.for('stencil.signals')] as any`; typed code uses `getSignal` instead.
-- **Cleared on disconnect:** The symbol property is set to `undefined` in `$signalCleanup$()`. Adapters must use optional chaining: `sigs?.get('prop')?.subscribe(...)`.
-
-#### Phase 3  JSX vdom bypass ✅ Complete
-- [x] `BUILD.vdomSignals` flag  auto-enabled by `signalBacking: true`; also standalone via `extras.vdomSignals: true`
-- [x] Signal text children  `<div>{mySignal}</div>` → `effect()` updates `textNode.data` directly, bypasses vdom diff
-- [x] Signal attribute values  `<div class={mySignal}>` → `effect()` calls `setAccessor` directly
-- [x] Per-node cleanup: `WeakMap<Node, () => void>` (text nodes) + `WeakMap<Node, Map<string, () => void>>` (per-attribute). `removeVnodes` recursively disposes.
-- [x] `SignalRef<T>` interface in public runtime declarations  JSX type compatibility without importing `@preact/signals-core`
-- [x] Tests  signal text children, signal attributes
-
-**Design decisions:**
-
-- **Signal detection:** Duck-type via `typeof v.peek === 'function' && typeof v.subscribe === 'function'` rather than `instanceof Signal`. Cross-bundle-safe  both the `signals/` bundle and the `runtime/` bundle inline `@preact/signals-core`; two separate class instances would make `instanceof` fail when signals are passed across bundle boundaries.
-- **`$signal$?: any` on VNode:** Stores the signal reference through the `h()` → `createElm()` pipeline for text nodes.
-- **`<Show>` removed:** The `<Show when={signal}>` component was removed. It only toggled `display` on a wrapper element  no capability beyond what signal attributes already provide. Use a signal-driven `style` or `class` attribute directly instead.
-
-#### Phase 4  `<For>` reactive list rendering (removed)
-
-Not implemented. The bypass benefit only applies when the array signal changes without a host component re-render  a narrow use case. The render function typically closes over component state, meaning arrow functions are recreated each render and the bypass is defeated. The implementation also requires capturing and restoring module-level renderer state (`hostTagName`, `scopeId`, `isSvgMode`) from inside signal effect callbacks  a fragile layering violation.
-
-Use keyed `.map()` instead: `{items.value.map((item, i) => <li key={item.id}>...</li>)}`
-
-#### Later  make default
-- [ ] Evaluate adoption/feedback from Phases 1 + 2
+## ⚡ Signals — "make default" consideration
+- [ ] Evaluate adoption/feedback
 - [ ] If stable and popular: flip `signalBacking` default to `true`, deprecate old Map path, remove in next major
 
-#### Out of scope for now
-- Separate `@stencil/signals` store package  relegated; the `@stencil/core/signals` subpath covers the in-component use case
-
-### Files Changed
-
-| File | Change |
-|------|--------|
-| `packages/core/package.json` | Added `@preact/signals-core` dep; `./signals` subpath export |
-| `packages/core/tsdown.config.ts` | Added `signals/index` entry |
-| `packages/core/src/signals/index.ts` | New  public entry: signal primitives re-export + `@Effect()` + `@Computed()` |
-| `packages/core/src/runtime/signals.ts` | `initializeSignals`  per-prop scheduling + watcher effects + `@Effect()` wiring |
-| `packages/core/src/declarations/stencil-private.ts` | `$signalValues$`, `$signalCleanup$` on `HostRef`; `signalBacking` on `BuildConditionals` |
-| `packages/core/src/declarations/stencil-public-compiler.ts` | `signalBacking` on `ConfigExtrasBase` |
-| `packages/core/src/compiler/app-core/app-data.ts` | Set `BUILD.signalBacking` from config; added to `COLLECTION_CONFIG_FLAGS` |
-| `packages/core/src/runtime/set-value.ts` | Signal fast-path in `getValue` + `setValue`; `applySerializers` helper (deduped); serializer fix |
-| `packages/core/src/runtime/initialize-component.ts` | Calls `initializeSignals` before first `scheduleUpdate` |
-| `packages/core/src/runtime/disconnected-callback.ts` | Calls `$signalCleanup$()` on real disconnect |
-| `packages/core/src/runtime/_test_/signals.spec.ts` | Unit tests: `initializeSignals`, `@Effect()` wiring, decorator factories |
-| `packages/core/src/runtime/_test_/signal-backing.spec.tsx` | Integration tests: `@State`, `@Prop`, `@Watch`, `@Effect()`, `computed()` class fields |
-| `packages/core/src/runtime/runtime-constants.ts` | Added `SHOW_TAG = Symbol('s-show')` sentinel |
-| `packages/core/src/runtime/vdom/h.ts` | Signal text children in `walk()`; guard class→string for signal values |
-| `packages/core/src/runtime/vdom/set-accessor.ts` | Signal attribute subscriptions via `effect()`; `disposeAllSignalAttrs` |
-| `packages/core/src/runtime/vdom/vdom-render.ts` | `createElm` signal text + Show handling; `disposeSignalVNode` on `removeVnodes` |
-| `packages/core/src/declarations/stencil-public-runtime.ts` | `SignalRef<T>` interface; `class` attr type widened to accept `SignalRef<string>` |
-| `packages/core/src/runtime/_test_/signal-vdom.spec.tsx` | New  12 integration tests for Phase 3 vdom bypass |
-
-### Out of scope (v6+ / future)
-
-Fine-grained JSX compilation (Solid-style): JSX → direct DOM ops + effects, no vdom at all. Requires new compiler pass, new SSR strategy with reactive DOM markers, new hydration protocol. The right long-term direction but a separate multi-year effort.
-
 ---
 
 ## Build Commands
@@ -393,4 +235,4 @@ pnpm run dev       # Watch mode
 
 ---
 
-*Last updated: 2026-05-21*
+*Last updated: 2026-05-23*