feat: v5 rename outputs (#6689)

* chore: v5 output target modernization - rename and refactor

Major refactor to rename output targets for clarity and elevate sub-outputs
to first-class citizens, creating parity between distribution strategies.

**Naming changes:**
- `dist` → `loader-bundle` (lazy-loaded bundles + loader infrastructure)
- `dist-custom-elements` → `standalone` (individual ES modules)
- `dist-hydrate-script` → `ssr` (server-side rendering)
- `dist-collection` (sub) → `stencil-meta` (first-class, metadata output)
- `dist-types` (sub) → `types` (first-class, shared type definitions)

**Key changes:**
- Updated all constants with v5 names + deprecated v4 aliases
- Updated all type definitions (OutputTarget interfaces)
- Renamed validator files and updated their logic
- Renamed output target implementation directories
- Updated type guards with backward-compatible deprecated aliases
- Removed collectionDir/typesDir from loader-bundle config
- Updated default directories to dist/loader-bundle/, dist/standalone/, etc.

**Backward compatibility:**
- All deprecated v4 aliases maintained for migration period
- Will be removed in v6

**Documentation:**
- Added comprehensive "Output Target Modernization" section to V5_PLANNING.md
- Updated breaking changes documentation

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

* feat: add auto-generation logic for types and stencil-meta outputs

Implement auto-generation of types and stencil-meta output targets in
production builds, elevating them to first-class citizens.

**Auto-generation behavior:**
- In production builds (!config.devMode), automatically add types and
  stencil-meta outputs if not explicitly configured by user
- User can override by explicitly adding these outputs to their config
- Both default to skipInDev: true for optimal dev performance

**Implementation:**
- Added autoGenerateOutputs() function in validateOutputTargets
- Created validate-types.ts for types output validation
- Default directories: dist/types/ and dist/stencil-meta/
- Maintains backward compatibility with explicit configs

This ensures parity between loader-bundle and standalone outputs,
as both now automatically get type definitions in production.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

* chore:

* chore: remove un-required config options

* chore: tests pass

* chore: fix knip

* chore: new tests

* chore: new migration tests

* chore: removed --prod and devMode

* chore: add transpileStyle inline

* chore:

* Revert "chore: add transpileStyle inline"

This reverts commit 9cf68f4.

* chore: change collection / stencil-meta to stencil-rebundle

* chore: fixes for package.json checking / validations

* chore: rename file extensions - .cjs.js > .cjs, .esm.js > .js

* chore: update all 'collection' naming to 'rebundle'

* chore: rename dist-custom-elements related files to standalone

* chore: update testing

* chore: remove 'loader' dir. fix build tests

* chore: add esm.js to browser bundle for posterity

* chore: main work

* chore: tidy codebase

* chore: update all tests

* chore: fixup tests

* chore: better explicit global-style output options

* chore:

* chore: change all server bundle 'hydrate' refs to 'ssr'

* chore:

* chore: update default skipInDev behaviour

* chore: tidy up

* chore:

* chore:

---------

Co-authored-by: Claude Sonnet 4.5 <noreply@anthropic.com>

Author: johnjenkins

CLAUDE.md

@@ -4,12 +4,18 @@ This is a major version development branch - breaking changes are ok.
 
 Read the `./V5_PLANNING.md` file at session start for more details on the goals and plans for this major version. Add and amend this document as needed to keep track of the major version planning and progress.
 
-The project has moved to a monorepo structure under `./packages` (using tsdown for bundling) but you can still see the legacy file structure under `./src` (main source / logic), `./scripts` (esbuild bundling) and `./test` (integration / e2e test suite) for reference; most files have the same name. Never change the files in the legacy dirs - they are only for reference and will be deleted once the new structure is fully in place. 
-
 Always seek to replace code with more modern standards and more modern 3rd party dependencies where possible, and remove older code and dependencies that are no longer needed - but please discuss this with the user before doing so.
 
 User should not have to ask you for your opinion explicitly. Always evaluate what the user is asking you to do, and voice your concerns before proceeding if you don’t think it's a good idea. If possible, propose a better solution, but you can voice concerns even without one.
 
 This applies even to direct requests to revert or simplify. Still evaluate whether your original approach was better. The user may be missing important context. If there was a solid reasoning you suggested that approach, push back with reasoning instead of silently complying.
 
-Assume any package starting with `@stencil/` is potentially updatable and suggest changes if you think it would be beneficial.
+Assume any package starting with `@stencil/` is potentially updatable and suggest changes if you think it would be beneficial.
+
+`as any` is very rarely an acceptable solution. Check with the user before using it, and use better alternatives whenever possible - don't be lazy.
+
+Never commit changes without the user explicitly asking you to. Always ask for confirmation before committing, and provide a clear summary of the changes that will be committed. If the user asks for changes after you’ve provided a summary but before you’ve committed, update the summary to reflect the new changes before asking for confirmation again.
+
+Keep all code comments terse as you can.
+
+To run a unit test `pnpm -F PACKAGE_NAME test TEST_NAME`

V5_PLANNING.md

@@ -96,6 +96,7 @@ microtasks
 minifier
 myapp
 mycomponent
+mylib
 myprop
 namespace
 nocheck
@@ -170,4 +171,5 @@ jsxs
 labelable
 lightningcss
 cooldown
+rebundle
 regen

cspell-wordlist.txt

@@ -1424,7 +1424,6 @@ describe('compiler', () => {
 {
   "scripts": {
     "build": "node scripts/build.js",
-    "build.prod": "node scripts/build.js --prod",
     "build.dev": "node scripts/build.js --dev",
     "watch": "node scripts/build.js --watch"
   }

docs/compiler.md

@@ -239,10 +239,10 @@ Most Node.js dependencies are externalized except:
 
 ```bash
 # Development build
-npm run build
+npm run build -- --dev
 
-# Production build
-npm run build -- --prod
+# Production build (default)
+npm run build
 
 # Watch mode
 npm run build -- --watch

docs/scripts.md

@@ -10,8 +10,8 @@
       "entry": [
         "build/version-utils.ts",
         "src/index.d.mts",
-        "src/runtime/bootstrap-lazy.ts",
-        "src/server/runner/hydrate-factory.ts",
+        "src/runtime/bootstrap-loader.ts",
+        "src/server/runner/ssr-factory.ts",
         "src/testing/platform/index.ts",
         "src/testing/app-data.ts"
       ],

knip.json

@@ -51,5 +51,10 @@
     "node": "24.14.0",
     "npm": "11.9.0"
   },
-  "packageManager": "pnpm@10.31.0"
+  "packageManager": "pnpm@10.31.0",
+  "pnpm": {
+    "overrides": {
+      "@stencil/core": "workspace:*"
+    }
+  }
 }

package.json

@@ -1,5 +1,5 @@
 import { describe, it, expect } from 'vitest';
-import type { Config } from '@stencil/core/compiler';
+import type { UnvalidatedConfig } from '@stencil/core/compiler';
 
 import { createConfigFlags, type ConfigFlags } from '../config-flags';
 import { mergeFlags } from '../merge-flags';
@@ -9,41 +9,23 @@ describe('mergeFlags', () => {
     return createConfigFlags(overrides);
   };
 
-  describe('devMode (--dev / --prod)', () => {
-    it('sets devMode to false when --prod is true', () => {
-      const config: Config = {};
-      const flags = createFlags({ prod: true });
-
-      const result = mergeFlags(config, flags);
-
-      expect(result.devMode).toBe(false);
-    });
-
+  describe('devMode (--dev)', () => {
     it('sets devMode to true when --dev is true', () => {
-      const config: Config = {};
+      const config: UnvalidatedConfig = {};
       const flags = createFlags({ dev: true });
 
       const result = mergeFlags(config, flags);
 
       expect(result.devMode).toBe(true);
     });
 
-    it('--prod takes precedence over --dev when both are set', () => {
-      const config: Config = {};
-      const flags = createFlags({ prod: true, dev: true });
-
-      const result = mergeFlags(config, flags);
-
-      expect(result.devMode).toBe(false);
-    });
-
-    it('preserves config devMode when neither flag is set', () => {
-      const config: Config = { devMode: true };
+    it('does not set devMode when --dev is absent (production is the default)', () => {
+      const config: UnvalidatedConfig = {};
       const flags = createFlags({});
 
       const result = mergeFlags(config, flags);
 
-      expect(result.devMode).toBe(true);
+      expect(result.devMode).toBeUndefined();
     });
   });
 

packages/cli/src/_test_/merge-flags.spec.ts

@@ -21,7 +21,6 @@ export const BOOLEAN_CLI_FLAGS = [
   'open',
   'prerender',
   'prerenderExternal',
-  'prod',
   'profile',
   'serviceWorker',
   'serve',

packages/cli/src/config-flags.ts

@@ -1,4 +1,4 @@
-import type { Config } from '@stencil/core/compiler';
+import type { UnvalidatedConfig } from '@stencil/core/compiler';
 
 import type { ConfigFlags } from './config-flags';
 
@@ -7,19 +7,17 @@ import type { ConfigFlags } from './config-flags';
  *
  * This function applies command-line flags to the config, with CLI flags
  * taking precedence over config file values. This is the canonical place
- * where flag values are translated into config properties.?
+ * where flag values are translated into config properties.
  *
  * @param config The config object (from stencil.config.ts or empty)
  * @param flags The parsed CLI flags
  * @returns The config with flags merged in
  */
-export const mergeFlags = (config: Config, flags: ConfigFlags): Config => {
-  const merged = { ...config };
+export const mergeFlags = (config: UnvalidatedConfig, flags: ConfigFlags): UnvalidatedConfig => {
+  const merged: UnvalidatedConfig = { ...config };
 
-  // --dev / --prod → devMode
-  if (flags.prod === true) {
-    merged.devMode = false;
-  } else if (flags.dev === true) {
+  // --dev → devMode (production is the default; --dev is the explicit opt-in)
+  if (flags.dev === true) {
     merged.devMode = true;
   }