@stencil/core 5.0.0-alpha.5 → 5.0.0-alpha.7

package/dist/declarations/stencil-public-compiler.d.ts

@@ -1,4 +1,5 @@
 import { ListenTargetOptions, ResolutionHandler } from "./stencil-public-runtime.js";
+import { InputOptions, SourceMap as RolldownSourceMap } from "rolldown";
 //#region src/utils/result.d.ts
 /**
  * A Result wraps up a success state and a failure state, allowing you to
@@ -670,6 +671,103 @@ interface PrintLine {
   errorCharStart: number;
   errorLength?: number;
 }
+interface BuildFeatures {
+  style: boolean;
+  mode: boolean;
+  formAssociated: boolean;
+  shadowDom: boolean;
+  shadowDelegatesFocus: boolean;
+  shadowModeClosed: boolean;
+  shadowSlotAssignmentManual: boolean;
+  scoped: boolean;
+  /**
+   * Every component has a render function
+   */
+  allRenderFn: boolean;
+  /**
+   * At least one component has a render function
+   */
+  hasRenderFn: boolean;
+  vdomRender: boolean;
+  vdomAttribute: boolean;
+  vdomClass: boolean;
+  vdomFunctional: boolean;
+  vdomKey: boolean;
+  vdomListener: boolean;
+  vdomPropOrAttr: boolean;
+  vdomRef: boolean;
+  vdomStyle: boolean;
+  vdomText: boolean;
+  vdomXlink: boolean;
+  vdomSignals: boolean;
+  slotRelocation: boolean;
+  patchAll: boolean;
+  patchChildren: boolean;
+  patchClone: boolean;
+  patchInsert: boolean;
+  slot: boolean;
+  svg: boolean;
+  element: boolean;
+  event: boolean;
+  hostListener: boolean;
+  hostListenerTargetWindow: boolean;
+  hostListenerTargetDocument: boolean;
+  hostListenerTargetBody: boolean;
+  hostListenerTarget: boolean;
+  method: boolean;
+  prop: boolean;
+  propChangeCallback: boolean;
+  propMutable: boolean;
+  state: boolean;
+  member: boolean;
+  updatable: boolean;
+  propBoolean: boolean;
+  propNumber: boolean;
+  propString: boolean;
+  serializer: boolean;
+  deserializer: boolean;
+  lifecycle: boolean;
+  asyncLoading: boolean;
+  observeAttribute: boolean;
+  reflect: boolean;
+  taskQueue: boolean;
+}
+interface BuildConditionals extends Partial<BuildFeatures> {
+  hotModuleReplacement?: boolean;
+  isDebug?: boolean;
+  isTesting?: boolean;
+  isDev?: boolean;
+  devTools?: boolean;
+  invisiblePrehydration?: boolean;
+  hydrateServerSide?: boolean;
+  hydrateClientSide?: boolean;
+  lifecycleDOMEvents?: boolean;
+  cssAnnotations?: boolean;
+  lazyLoad?: boolean;
+  profile?: boolean;
+  constructableCSS?: boolean;
+  /** True when `compat.lightDomPatches === true` - enables `applyLightDomPatches` shortcut. */
+  lightDomPatches?: boolean;
+  /** Patch `childNodes`/`children` getters on light-dom slotted components. */
+  slotChildNodes?: boolean;
+  /** Patch `cloneNode()` on light-dom slotted components. */
+  slotCloneNode?: boolean;
+  /** Patch `appendChild`/`insertBefore`/`removeChild` on light-dom slotted components. */
+  slotDomMutations?: boolean;
+  /** Patch `textContent` on light-dom slotted components. */
+  slotTextContent?: boolean;
+  hydratedAttribute?: boolean;
+  hydratedClass?: boolean;
+  hydratedSelectorName?: string;
+  /** 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`. */
+  vdomSignals?: boolean;
+}
 type ModuleFormat = 'amd' | 'cjs' | 'es' | 'iife' | 'system' | 'umd' | 'commonjs' | 'esm' | 'module' | 'systemjs';
 interface RolldownResultModule {
   id: string;
@@ -718,12 +816,14 @@ interface BuildCtx {
   ssrAppFilePath: string;
   indexBuildCount: number;
   indexDoc: Document;
+  /** All non-entry HTML files found in srcDir, keyed by path relative to srcDir */
+  htmlDocs: Map<string, Document>;
   isRebuild: boolean;
   /**
    * A collection of Stencil's intermediate representation of components, tied to the current build
    */
   moduleFiles: Module[];
-  packageJson: PackageJsonData;
+  packageJson: PackageJsonData | null;
   pendingCopyTasks: Promise<CopyResults>[];
   progress(task: BuildTask): void;
   requiresFullBuild: boolean;
@@ -767,8 +867,6 @@ interface CompilerBuildStats {
   options: {
     minifyJs: boolean;
     minifyCss: boolean;
-    hashFileNames: boolean;
-    hashedFileNameLength: number;
   };
   formats: {
     esmBrowser: ReadonlyArray<CompilerBuildStatBundle>;
@@ -817,16 +915,6 @@ interface RolldownChunkResult {
   moduleFormat: ModuleFormat;
   map?: RolldownSourceMap;
 }
-interface RolldownSourceMap {
-  file: string;
-  mappings: string;
-  names: string[];
-  sources: string[];
-  sourcesContent: string[];
-  version: number;
-  toString(): string;
-  toUrl(): string;
-}
 interface BundleModule {
   entryKey: string;
   rolldownResult: RolldownChunkResult;
@@ -862,6 +950,7 @@ interface CollectionCompilerMeta {
   bundles?: {
     components: string[];
   }[];
+  buildFlags?: Partial<BuildConditionals>;
 }
 interface CollectionCompilerVersion {
   name: string;
@@ -1008,6 +1097,7 @@ interface ComponentCompilerFeatures {
   hasVdomStyle: boolean;
   hasVdomText: boolean;
   hasVdomXlink: boolean;
+  hasSignalsImport: boolean;
   hasWatchCallback: boolean;
   htmlAttrNames: string[];
   htmlTagNames: string[];
@@ -1105,6 +1195,7 @@ interface ComponentCompilerMeta extends ComponentCompilerFeatures {
   states: ComponentCompilerState[];
   styleDocs: CompilerStyleDoc[];
   styles: StyleCompiler[];
+  globalStyles: ComponentGlobalStyle[];
   tagName: string;
   virtualProperties: ComponentCompilerVirtualProperty[];
   watchers: ComponentCompilerChangeHandler[];
@@ -1121,7 +1212,7 @@ type Encapsulation = 'shadow' | 'scoped' | 'none';
  * These enable proper slot behavior when not using native Shadow DOM.
  */
 interface ComponentPatches {
-  /** Apply all slot patches (equivalent to experimentalSlotFixes) */
+  /** Apply all slot patches (equivalent to lightDomPatches) */
   all?: boolean;
   /** Patch child node accessors (children, firstChild, lastChild, etc.) */
   children?: boolean;
@@ -1181,6 +1272,11 @@ interface ComponentCompilerPropertyComplexType {
    * annotation in the original source file.
    */
   references: ComponentCompilerTypeReferences;
+  /**
+   * @internal TypeScript AST node used for semantic type analysis during compilation.
+   * Not serialized, only used internally for improved type renaming logic.
+   */
+  _astNode?: any;
 }
 /**
  * A record of `ComponentCompilerTypeReference` entities.
@@ -1274,6 +1370,11 @@ interface ComponentCompilerMethodComplexType {
   parameters: JsonDocMethodParameter[];
   references: ComponentCompilerTypeReferences;
   return: string;
+  /**
+   * @internal TypeScript AST method node used for semantic type analysis during compilation.
+   * Not serialized, only used internally for improved type renaming logic.
+   */
+  _astNode?: any;
 }
 interface ComponentCompilerChangeHandler {
   propName: string;
@@ -1438,6 +1539,7 @@ interface Module {
   hasVdomStyle: boolean;
   hasVdomText: boolean;
   hasVdomXlink: boolean;
+  hasSignalsImport: boolean;
 }
 interface PrerenderUrlResults {
   anchorUrls: string[];
@@ -1470,6 +1572,12 @@ interface ExternalStyleCompiler {
   relativePath: string;
   originalComponentPath: string;
 }
+interface ComponentGlobalStyle {
+  /** Absolute path to the CSS file, or null for inline styles */
+  absolutePath: string | null;
+  /** Raw inline CSS string, or null for file-based styles */
+  styleStr: string | null;
+}
 /**
  * Input CSS to be transformed into ESM
  */
@@ -1534,9 +1642,7 @@ interface PackageJsonData {
   module?: string;
   'jsnext:main'?: string;
   unpkg?: string;
-  /** @deprecated Use `stencilRebundle` instead. Kept for reading v4 dependencies. */
   collection?: string;
-  stencilRebundle?: string;
   types?: string;
   files?: string[];
   ['dist-tags']?: {
@@ -1661,20 +1767,6 @@ interface StencilConfig {
    * @default false
    */
   generateExportMaps?: boolean;
-  /**
-   * When the hashFileNames config is set to true, and it is a production build,
-   * the hashedFileNameLength config is used to determine how many characters the file name's hash should be.
-   */
-  hashedFileNameLength?: number;
-  /**
-   * During production builds, the content of each generated file is hashed to represent the content,
-   * and the hashed value is used as the filename. If the content isn't updated between builds,
-   * then it receives the same filename. When the content is updated, then the filename is different.
-   *
-   * By doing this, deployed apps can "forever-cache" the build directory and take full advantage of
-   * content delivery networks (CDNs) and heavily caching files for faster apps.
-   */
-  hashFileNames?: boolean;
   /**
    * The namespace config is a string representing a namespace for the app.
    * For apps that are not meant to be a library of reusable components,
@@ -1745,11 +1837,17 @@ interface StencilConfig {
    */
   logger?: Logger;
   /**
-   * Config to add extra runtime for DOM features that require more polyfills. Note
-   * that not all DOM APIs are fully polyfilled when using the slot polyfill. These
-   * are opt-in since not all users will require the additional runtime.
+   * Compatibility and workaround flags for framework integration and bundler edge cases.
+   */
+  compat?: ConfigCompat;
+  /**
+   * Replace `@State` and `@Prop` internals with `@preact/signals-core` signal primitives.
+   * 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`.
    */
-  extras?: ConfigExtras;
+  signalBacking?: boolean;
   /**
    * The hydrated flag identifies if a component and all of its child components
    * have finished hydrating. This helps prevent any flash of unstyled content (FOUC)
@@ -1865,14 +1963,56 @@ interface StencilConfig {
    * Set whether unused dependencies should be excluded from the built output.
    */
   excludeUnusedDependencies?: boolean;
+  /**
+   * Explicitly declare which npm packages are Stencil collections to be re-bundled into this project.
+   *
+   * Without this option, collection ingestion is triggered only by a side-effect import:
+   * ```ts
+   * import '@ionic/core';
+   * ```
+   * @example
+   * ```ts
+   * export const config: Config = {
+   *   collections: ['@ionic/core', '@my-org/design-system'],
+   * };
+   * ```
+   *
+   * @default []
+   */
+  collections?: string[];
   stencilCoreResolvedId?: string;
 }
-interface ConfigExtrasBase {
+/**
+ * DOM patches for light-dom / scoped components that use `<slot>`.
+ *
+ * These patches shield the component's slot machinery from framework DOM mutations
+ * (e.g. when Angular or React insert / remove nodes they route directly to the host
+ * element, bypassing the slot polyfill) and prevent hydration errors when a framework
+ * encounters Stencil's internal slot reference nodes during SSR reconciliation.
+ *
+ * Patches are only applied at runtime when a component is both non-shadow **and**
+ * declares at least one `<slot>`, so enabling them has no effect on pure shadow-DOM
+ * components.
+ *
+ * Set to `true` (default) to enable all patches, `false` to disable all, or an object
+ * for granular control.
+ */
+type LightDomPatches = {
+  /** Patches `childNodes`/`children` getters to return only slotted content. */childNodes?: boolean; /** Patches `cloneNode()` to correctly deep-clone slotted content. */
+  cloneNode?: boolean; /** Patches `appendChild()`, `insertBefore()`, and `removeChild()` to route to the correct slot. */
+  domMutations?: boolean; /** Patches `textContent` to act like shadow DOM (reads/writes slotted text only). */
+  textContent?: boolean;
+};
+/**
+ * Compatibility and workaround flags for framework integration and bundler edge cases.
+ * These are opt-in runtime behaviors that aren't needed by every project.
+ */
+interface ConfigCompat {
   /**
    * Projects that use a Stencil library built using the `dist` output target may have trouble lazily
    * loading components when using a bundler such as Vite or Parcel. Setting this flag to `true` will change how Stencil
    * lazily loads components in a way that works with additional bundlers. Setting this flag to `true` will increase
-   * the size of the compiled output. Defaults to `false`.
+   * the size of the compiled output. Defaults to `true`.
    */
   enableImportInjection?: boolean;
   /**
@@ -1887,53 +2027,16 @@ interface ConfigExtrasBase {
    */
   initializeNextTick?: boolean;
   /**
-   * Adds `transformTag` calls to css strings and querySelector(All) calls
+   * Adds `transformTag` calls to css strings and querySelector(All) calls.
+   * Use `'prod'` to enable only in production builds.
    */
   additionalTagTransformers?: boolean | 'prod';
   /**
-   * Experimental flag.
-   * Updates the behavior of scoped components to align more closely with the behavior of the native
-   * Shadow DOM when using `slot`s.
-   * Defaults to `false`.
+   * DOM patches for light-dom / scoped components that use `<slot>`.
+   * See {@link LightDomPatches} for granular control. Defaults to `true`.
    */
-  experimentalScopedSlotChanges?: boolean;
+  lightDomPatches?: boolean | LightDomPatches;
 }
-type ConfigExtrasSlotFixes<ExperimentalFixesEnabled extends boolean, IndividualFlags extends boolean> = {
-  /**
-   * By default, the slot polyfill does not update `appendChild()` so that it appends
-   * new child nodes into the correct child slot like how shadow dom works. This is an opt-in
-   * polyfill for those who need it when using `element.appendChild(node)` and expecting the
-   * child to be appended in the same location shadow dom would. This is not required for
-   * IE11 or Edge 18, but can be enabled if the app is using `appendChild()`. Defaults to `false`.
-   */
-  appendChildSlotFix?: IndividualFlags;
-  /**
-   * By default, the runtime does not polyfill `cloneNode()` when cloning a component
-   * that uses the slot polyfill. This is an opt-in polyfill for those who need it.
-   * This is not required for IE11 or Edge 18, but can be enabled if the app is using
-   * `cloneNode()` and unexpected node are being cloned due to the slot polyfill
-   * simulating shadow dom. Defaults to `false`.
-   */
-  cloneNodeFix?: IndividualFlags;
-  /**
-   * Experimental flag to align the behavior of invoking `textContent` on a scoped component to act more like a
-   * component that uses the shadow DOM. Defaults to `false`
-   */
-  scopedSlotTextContentFix?: IndividualFlags;
-  /**
-   * For browsers that do not support shadow dom (IE11 and Edge 18 and below), slot is polyfilled
-   * to simulate the same behavior. However, the host element's `childNodes` and `children`
-   * getters are not patched to only show the child nodes and elements of the default slot.
-   * Defaults to `false`.
-   */
-  slotChildNodesFix?: IndividualFlags;
-  /**
-   * Enables all slot-related fixes such as {@link slotChildNodesFix}, and
-   * {@link scopedSlotTextContentFix}.
-   */
-  experimentalSlotFixes?: ExperimentalFixesEnabled;
-};
-type ConfigExtras = ConfigExtrasBase & (ConfigExtrasSlotFixes<true, true> | ConfigExtrasSlotFixes<false, boolean>);
 interface Config extends StencilConfig {
   buildAppCore?: boolean;
   configPath?: string;
@@ -2036,7 +2139,7 @@ type RequireFields<T, K extends keyof T> = T & { [P in K]-?: T[P] };
 /**
  * Fields in {@link Config} to make required for {@link ValidatedConfig}
  */
-type StrictConfigFields = keyof Pick<Config, 'cacheDir' | 'devServer' | 'extras' | 'fsNamespace' | 'hashFileNames' | 'hashedFileNameLength' | 'hydratedFlag' | 'logLevel' | 'logger' | 'minifyCss' | 'minifyJs' | 'namespace' | 'outputTargets' | 'packageJsonFilePath' | 'rolldownConfig' | 'rootDir' | 'srcDir' | 'srcIndexHtml' | 'sys' | 'transformAliasedImportPaths'>;
+type StrictConfigFields = keyof Pick<Config, 'cacheDir' | 'devServer' | 'compat' | 'fsNamespace' | 'hydratedFlag' | 'logLevel' | 'logger' | 'minifyCss' | 'minifyJs' | 'namespace' | 'outputTargets' | 'packageJsonFilePath' | 'rolldownConfig' | 'rootDir' | 'srcDir' | 'srcIndexHtml' | 'sys' | 'transformAliasedImportPaths'>;
 /**
  * A version of {@link Config} that makes certain fields required. This type represents a valid configuration entity.
  * When a configuration is received by the user, it is a bag of unverified data. In order to make stricter guarantees
@@ -2867,18 +2970,18 @@ interface ResolveModuleIdResults {
  * A controller which provides for communication and coordination between
  * threaded workers.
  */
-interface WorkerMainController {
+interface WorkerMainController<T extends Record<string, (...args: any[]) => Promise<any>> = Record<string, (...args: any[]) => Promise<any>>> {
   /**
    * Send a given set of arguments to a worker
    */
-  send(...args: any[]): Promise<any>;
+  send<K extends keyof T>(methodName: K, ...args: Parameters<T[K]>): ReturnType<T[K]>;
   /**
    * Handle a particular method
    *
    * @param name of the method to be passed to a worker
    * @returns a Promise wrapping the results
    */
-  handler(name: string): (...args: any[]) => Promise<any>;
+  handler<K extends keyof T>(name: K): T[K];
   /**
    * Destroy the worker represented by this instance, rejecting all outstanding
    * tasks and killing the child process.
@@ -2945,6 +3048,7 @@ interface BuildNoChangeResults {
 interface CompilerBuildResults {
   buildId: number;
   componentGraph?: BuildResultsComponentGraph;
+  components: ComponentCompilerMeta[];
   diagnostics: Diagnostic[];
   dirsAdded: string[];
   dirsDeleted: string[];
@@ -2959,6 +3063,7 @@ interface CompilerBuildResults {
   ssrAppFilePath?: string;
   isRebuild: boolean;
   namespace: string;
+  fsNamespace: string;
   outputs: BuildOutput[];
   rootDir: string;
   srcDir: string;
@@ -3141,8 +3246,9 @@ interface CopyTask {
    */
   dest?: string;
   /**
-   * An optional array of glob patterns to exclude from the copy operation.
-   * @default ['**\/__mocks__/**', '**\/__fixtures__/**', '**\/dist/**', '**\/.{idea,git,cache,output,temp}/**', '**\/.ds_store', '**\/.gitignore', '**\/desktop.ini', '**\/thumbs.db']
+   * Additional glob patterns to exclude from the copy operation, merged with
+   * the built-in defaults: `__mocks__`, `__fixtures__`, `dist`, hidden dirs,
+   * `.ds_store`, `.gitignore`, `desktop.ini`, `thumbs.db`.
    */
   ignore?: string[];
   /**
@@ -3221,39 +3327,12 @@ interface StencilDocsConfig {
     };
   };
 }
-interface NodeResolveConfig {
-  exportConditions?: string[];
-  browser?: boolean;
-  moduleDirectories?: string[];
-  modulePaths?: string[];
-  dedupe?: string[] | ((importee: string) => boolean);
-  extensions?: readonly string[];
-  jail?: string;
-  mainFields?: readonly string[];
-  modulesOnly?: boolean;
-  preferBuiltins?: boolean | ((module: string) => boolean);
-  resolveOnly?: ReadonlyArray<string | RegExp> | null | ((module: string) => boolean);
-  rootDir?: string;
-  allowExportsFolderMapping?: boolean;
-}
+/** Options for rolldown's built-in module resolver, passed directly to rolldown's `resolve` input option. */
+type NodeResolveConfig = NonNullable<InputOptions['resolve']>;
 interface RolldownConfig {
-  inputOptions?: RolldownInputOptions;
-  outputOptions?: RolldownOutputOptions;
-}
-interface RolldownInputOptions {
-  context?: string;
-  moduleContext?: ((id: string) => string) | {
-    [id: string]: string;
-  };
   treeshake?: boolean;
-  maxParallelFileOps?: number;
   external?: (string | RegExp)[] | string | RegExp | ((source: string, importer: string | undefined, isResolved: boolean) => boolean | null | undefined);
 }
-interface RolldownOutputOptions {
-  globals?: {
-    [name: string]: string;
-  } | ((name: string) => string);
-}
 /**
  * This sets the log level hierarchy for our terminal logger, ranging from
  * most to least verbose.
@@ -3359,6 +3438,28 @@ interface OutputTargetLoaderBundle extends OutputTargetBaseNext {
    * @default 'loader' (relative to output directory)
    */
   loaderPath?: string;
+  /**
+   * Hash the filenames of generated chunks based on their content.
+   * Enables forever-caching of CDN-served bundles.
+   *
+   * @default true in production, false in dev mode
+   */
+  hashFileNames?: boolean;
+  /**
+   * Number of characters to use for the content hash in filenames.
+   *
+   * @default 8
+   */
+  hashedFileNameLength?: number;
+  /**
+   * 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.
+   *
+   * @default false
+   */
+  externalRuntime?: boolean;
 }
 /**
  * Output target for generating Stencil component source for downstream re-bundling.
@@ -3372,14 +3473,14 @@ interface OutputTargetLoaderBundle extends OutputTargetBaseNext {
  * @example
  * ```typescript
  * {
- *   type: 'stencil-rebundle',
- *   dir: 'dist/stencil-rebundle',
+ *   type: 'collection',
+ *   dir: 'dist/collection',
  *   transformAliasedImportPaths: true
  * }
  * ```
  */
-interface OutputTargetStencilRebundle extends OutputTargetBaseNext {
-  type: 'stencil-rebundle';
+interface OutputTargetCollection extends OutputTargetBaseNext {
+  type: 'collection';
   empty?: boolean;
   /**
    * When `true` this flag will transform aliased import paths defined in
@@ -3433,6 +3534,12 @@ interface OutputTargetDistLazy extends OutputTargetBase {
   loaderDir?: string;
   typesDir?: string;
   empty?: boolean;
+  /** Inherited from parent output target (loader-bundle or www). Only meaningful for browser builds. */
+  hashFileNames?: boolean;
+  /** Inherited from parent output target (loader-bundle or www). */
+  hashedFileNameLength?: number;
+  /** Inherited from loader-bundle. When true, @stencil/core is external in this bundler output. */
+  externalRuntime?: boolean;
 }
 /**
  * Output target for global styles.
@@ -3543,6 +3650,13 @@ interface OutputTargetSsr extends OutputTargetBase {
    */
   cjs?: boolean;
 }
+interface OutputTargetSsrWasm extends OutputTargetBase {
+  type: 'ssr-wasm';
+  /** Output directory. @default 'dist/ssr-wasm' */
+  dir?: string;
+  empty?: boolean;
+  minify?: boolean;
+}
 interface OutputTargetCustom extends OutputTargetBase {
   type: 'custom';
   name: string;
@@ -3696,7 +3810,7 @@ interface OutputTargetStandalone extends OutputTargetBaseNext {
    * 2. File names are not hashed.
    * 3. File minification will follow the behavior defined at the root of the Stencil config.
    *
-   * @default true
+   * @default false
    */
   externalRuntime?: boolean;
   copy?: CopyTask[];
@@ -3767,7 +3881,7 @@ interface OutputTargetBase {
    */
   skipInDev?: boolean;
 }
-type OutputTargetBuild = OutputTargetStencilRebundle | OutputTargetDistLazy;
+type OutputTargetBuild = OutputTargetCollection | OutputTargetDistLazy;
 interface OutputTargetCopy extends OutputTargetBase {
   type: 'copy';
   dir: string;
@@ -3846,15 +3960,35 @@ interface OutputTargetWww extends OutputTargetBase {
    */
   prerenderConfig?: string;
   /**
-   * Service worker config for production builds. During development builds
-   * service worker script will be injected to automatically deregister existing
-   * service workers. When set to `false` neither a service worker registration
-   * or deregistration will be added to the index.html.
+   * Service worker config for production builds. In development mode, a script
+   * to deregister existing service workers is always injected. Defaults to
+   * `null` (disabled). Set to `true` to enable with default settings, or provide
+   * a config object for custom settings.
    */
-  serviceWorker?: ServiceWorkerConfig | null | false;
+  serviceWorker?: ServiceWorkerConfig | true | null;
   appDir?: string;
+  /**
+   * Hash the filenames of generated chunks based on their content.
+   * Enables forever-caching of CDN-served bundles.
+   *
+   * @default true in production, false in dev mode
+   */
+  hashFileNames?: boolean;
+  /**
+   * Number of characters to use for the content hash in filenames.
+   *
+   * @default 8
+   */
+  hashedFileNameLength?: number;
 }
-type OutputTarget = OutputTargetCopy | OutputTargetCustom | OutputTargetLoaderBundle | OutputTargetStandalone | OutputTargetSsr | OutputTargetStencilRebundle | OutputTargetTypes | OutputTargetGlobalStyle | OutputTargetAssets | OutputTargetDistLazy | OutputTargetDocsJson | OutputTargetDocsCustom | OutputTargetDocsReadme | OutputTargetDocsVscode | OutputTargetDocsCustomElementsManifest | OutputTargetWww | OutputTargetStats;
+type OutputTarget = OutputTargetCopy | OutputTargetCustom | OutputTargetLoaderBundle | OutputTargetStandalone | OutputTargetSsr | OutputTargetSsrWasm | OutputTargetCollection | OutputTargetTypes | OutputTargetGlobalStyle | OutputTargetAssets | OutputTargetDistLazy | OutputTargetDocsJson | OutputTargetDocsCustom | OutputTargetDocsReadme | OutputTargetDocsVscode | OutputTargetDocsCustomElementsManifest | OutputTargetWww | OutputTargetStats;
+/**
+ * A post-validation form of {@link OutputTargetWww} where `serviceWorker`
+ * has been normalized - `true` is resolved to a {@link ServiceWorkerConfig}.
+ */
+type ValidatedOutputTargetWww = Omit<OutputTargetWww, 'serviceWorker'> & {
+  serviceWorker?: ServiceWorkerConfig | null;
+};
 /**
  * Our custom configuration interface for generated caching Service Workers
  * using the Workbox library (see https://developer.chrome.com/docs/workbox/).
@@ -3902,12 +4036,6 @@ interface LoadConfigInit {
   configPath?: string;
   logger?: Logger;
   sys?: CompilerSystem;
-  /**
-   * When set to true, if the "tsconfig.json" file is not found
-   * it'll automatically generate and save a default tsconfig
-   * within the root directory.
-   */
-  initTsConfig?: boolean;
 }
 /**
  * Results from an attempt to load a config. The values on this interface
@@ -3949,17 +4077,6 @@ interface WorkerOptions {
   maxConcurrentTasksPerWorker?: number;
   logger?: Logger;
 }
-interface RolldownInterface {
-  rolldown: {
-    (config: any): Promise<any>;
-  };
-  plugins: {
-    nodeResolve(opts: any): any;
-    replace(opts: any): any;
-    commonjs(opts: any): any;
-    json(): any;
-  };
-}
 interface ResolveModuleOptions {
   manuallyResolve?: boolean;
   packageJson?: boolean;
@@ -4041,6 +4158,18 @@ interface Compiler {
   createWatcher(): Promise<CompilerWatcher>;
   destroy(): Promise<void>;
   sys: CompilerSystem;
+  /**
+   * @internal - Testing only. Access to the in-memory filesystem
+   */
+  fs?: InMemoryFileSystem;
+  /**
+   * @internal - Testing only. Access to the validated configuration
+   */
+  config?: ValidatedConfig;
+  /**
+   * @internal - Testing only. Access to the compiler context
+   */
+  compilerCtx?: CompilerCtx;
 }
 interface CompilerWatcher extends BuildOnEvents {
   start: () => Promise<WatcherCloseResults>;
@@ -4081,7 +4210,7 @@ interface TranspileOptions {
   componentMetadata?: 'runtimestatic' | 'compilerstatic' | string | undefined;
   /**
    * The actual internal import path for any `@stencil/core` imports.
-   * Default is `@stencil/core/runtime/client`.
+   * Default is `@stencil/core/runtime/client/standalone`.
    */
   coreImportPath?: string;
   /**
@@ -4238,4 +4367,4 @@ interface CliInitOptions {
   sys: CompilerSystem;
 }
 //#endregion
-export { AutoprefixerOptions, BuildEmitEvents, BuildEvents, BuildLog, BuildNoChangeResults, BuildOnEventRemove, BuildOnEvents, BuildOutput, BuildResultsComponentGraph, CacheStorage, CliInitOptions, CompileScriptMinifyOptions, CompileTarget, Compiler, CompilerBuildResults, CompilerBuildStart, CompilerDependency, CompilerEventBuildFinish, CompilerEventBuildLog, CompilerEventBuildNoChange, CompilerEventBuildStart, CompilerEventDirAdd, CompilerEventDirDelete, CompilerEventFileAdd, CompilerEventFileDelete, CompilerEventFileUpdate, CompilerEventFsChange, CompilerEventName, CompilerFileWatcher, CompilerFileWatcherCallback, CompilerFileWatcherEvent, CompilerFsStats, CompilerRequest, CompilerRequestResponse, CompilerSystem, CompilerSystemCreateDirectoryOptions, CompilerSystemCreateDirectoryResults, CompilerSystemRealpathResults, CompilerSystemRemoveDirectoryOptions, CompilerSystemRemoveDirectoryResults, CompilerSystemRemoveFileResults, CompilerSystemRenameResults, CompilerSystemRenamedPath, CompilerSystemWriteFileResults, CompilerWatcher, Config, ConfigBundle, ConfigExtras, CopyResults, CopyTask, Credentials, CustomElementsExportBehavior, CustomElementsExportBehaviorOptions, DevServer, DevServerConfig, DevServerEditor, Diagnostic, FsWatchResults, HistoryApiFallback, HmrStyleUpdate, HotModuleReplacement, HydrateDocumentOptions, HydrateFactoryOptions, HydratedFlag, JsonDocMethodParameter, JsonDocs, JsonDocsComponent, JsonDocsCustomState, JsonDocsDependencyGraph, JsonDocsEvent, JsonDocsListener, JsonDocsMethod, JsonDocsMethodReturn, JsonDocsPart, JsonDocsProp, JsonDocsSlot, JsonDocsStyle, JsonDocsTag, JsonDocsTypeLibrary, JsonDocsUsage, JsonDocsValue, LOG_LEVELS, LazyRequire, LoadConfigInit, LoadConfigResults, LogLevel, Logger, LoggerLineUpdater, LoggerTimeSpan, NodeResolveConfig, OptimizeCssInput, OptimizeCssOutput, OptimizeJsInput, OptimizeJsOutput, OutputTarget, OutputTargetAssets, OutputTargetBase, OutputTargetBaseNext, OutputTargetBuild, OutputTargetCopy, OutputTargetCustom, OutputTargetDistLazy, OutputTargetDocsCustom, OutputTargetDocsCustomElementsManifest, OutputTargetDocsJson, OutputTargetDocsReadme, OutputTargetDocsVscode, OutputTargetGlobalStyle, OutputTargetLoaderBundle, OutputTargetSsr, OutputTargetStandalone, OutputTargetStats, OutputTargetStencilRebundle, OutputTargetTypes, OutputTargetWww, PageReloadStrategy, ParsedPath, PlatformPath, PrerenderConfig, PrerenderHydrateOptions, PrerenderOptions, PrerenderResults, PrerenderStartOptions, ResolveModuleIdOptions, ResolveModuleIdResults, ResolveModuleOptions, RobotsTxtOpts, RobotsTxtResults, RolldownConfig, RolldownInputOptions, RolldownInterface, RolldownOutputOptions, SerializeDocumentOptions, ServiceWorkerConfig, SitemapXmpOpts, SitemapXmpResults, SsrDocumentOptions, SsrFactoryOptions, StencilConfig, StencilDevServerConfig, StencilDocsConfig, StyleDoc, SystemDetails, TransformOptions, TranspileOnlyResults, TranspileOptions, TranspileResults, UnvalidatedConfig, ValidatedConfig, WatcherCloseResults, WorkerMainController, WorkerOptions };
+export { AutoprefixerOptions, BuildEmitEvents, BuildEvents, BuildLog, BuildNoChangeResults, BuildOnEventRemove, BuildOnEvents, BuildOutput, BuildResultsComponentGraph, CacheStorage, CliInitOptions, CompileScriptMinifyOptions, CompileTarget, Compiler, CompilerBuildResults, CompilerBuildStart, CompilerDependency, CompilerEventBuildFinish, CompilerEventBuildLog, CompilerEventBuildNoChange, CompilerEventBuildStart, CompilerEventDirAdd, CompilerEventDirDelete, CompilerEventFileAdd, CompilerEventFileDelete, CompilerEventFileUpdate, CompilerEventFsChange, CompilerEventName, CompilerFileWatcher, CompilerFileWatcherCallback, CompilerFileWatcherEvent, CompilerFsStats, CompilerRequest, CompilerRequestResponse, CompilerSystem, CompilerSystemCreateDirectoryOptions, CompilerSystemCreateDirectoryResults, CompilerSystemRealpathResults, CompilerSystemRemoveDirectoryOptions, CompilerSystemRemoveDirectoryResults, CompilerSystemRemoveFileResults, CompilerSystemRenameResults, CompilerSystemRenamedPath, CompilerSystemWriteFileResults, CompilerWatcher, Config, ConfigBundle, ConfigCompat, CopyResults, CopyTask, Credentials, CustomElementsExportBehavior, CustomElementsExportBehaviorOptions, DevServer, DevServerConfig, DevServerEditor, Diagnostic, FsWatchResults, HistoryApiFallback, HmrStyleUpdate, HotModuleReplacement, HydrateDocumentOptions, HydrateFactoryOptions, HydratedFlag, JsonDocMethodParameter, JsonDocs, JsonDocsComponent, JsonDocsCustomState, JsonDocsDependencyGraph, JsonDocsEvent, JsonDocsListener, JsonDocsMethod, JsonDocsMethodReturn, JsonDocsPart, JsonDocsProp, JsonDocsSlot, JsonDocsStyle, JsonDocsTag, JsonDocsTypeLibrary, JsonDocsUsage, JsonDocsValue, LOG_LEVELS, LazyRequire, LightDomPatches, LoadConfigInit, LoadConfigResults, LogLevel, Logger, LoggerLineUpdater, LoggerTimeSpan, NodeResolveConfig, OptimizeCssInput, OptimizeCssOutput, OptimizeJsInput, OptimizeJsOutput, OutputTarget, OutputTargetAssets, OutputTargetBase, OutputTargetBaseNext, OutputTargetBuild, OutputTargetCollection, OutputTargetCopy, OutputTargetCustom, OutputTargetDistLazy, OutputTargetDocsCustom, OutputTargetDocsCustomElementsManifest, OutputTargetDocsJson, OutputTargetDocsReadme, OutputTargetDocsVscode, OutputTargetGlobalStyle, OutputTargetLoaderBundle, OutputTargetSsr, OutputTargetSsrWasm, OutputTargetStandalone, OutputTargetStats, OutputTargetTypes, OutputTargetWww, PageReloadStrategy, ParsedPath, PlatformPath, PrerenderConfig, PrerenderHydrateOptions, PrerenderOptions, PrerenderResults, PrerenderStartOptions, ResolveModuleIdOptions, ResolveModuleIdResults, ResolveModuleOptions, RobotsTxtOpts, RobotsTxtResults, RolldownConfig, SerializeDocumentOptions, ServiceWorkerConfig, SitemapXmpOpts, SitemapXmpResults, SsrDocumentOptions, SsrFactoryOptions, StencilConfig, StencilDevServerConfig, StencilDocsConfig, StyleDoc, SystemDetails, TransformOptions, TranspileOnlyResults, TranspileOptions, TranspileResults, UnvalidatedConfig, ValidatedConfig, ValidatedOutputTargetWww, WatcherCloseResults, WorkerMainController, WorkerOptions };