@stencil/core 5.0.0-alpha.3 → 5.0.0-alpha.30

package/dist/{index-tUR6pD3J.d.mts → index-BHj3EBl2.d.mts}

@@ -1,16 +1,6 @@
 import { Diagnostic, Node as Node$1 } from "typescript";
-import { RolldownError, SourceMap } from "rolldown";
+import { InputOptions, RolldownError, SourceMap, SourceMap as RolldownSourceMap } from "rolldown";
 import { Serializable } from "child_process";
-
-//#region src/utils/byte-size.d.ts
-/**
- * Used to learn the size of a string in bytes.
- *
- * @param str The string to measure
- * @returns number
- */
-declare const byteSize: (str: string) => number;
-//#endregion
 //#region src/utils/constants.d.ts
 declare const MEMBER_FLAGS: {
   readonly String: number;
@@ -56,6 +46,18 @@ declare const HOST_FLAGS: {
   readonly isWatchReady: number;
   readonly isListenReady: number;
   readonly needsRerender: number;
+  /**
+   * Set once this component's real (lazy-loaded) `connectedCallback` has fired for
+   * the first time. Lets a descendant skip creating/awaiting a connect-promise for
+   * an ancestor that's already connected. See {@link HostRef.$onFirstConnectResolve$}.
+   */
+  readonly hasFiredConnected: number;
+  /**
+   * Set when a lazy component's dynamic `import()` fails to resolve a
+   * constructor. Distinct from `hasInitializedComponent` being unset, which
+   * is true while an initialization attempt is merely queued/in-flight.
+   */
+  readonly hasFailedLoad: number;
   readonly devOnRender: number;
   readonly devOnDidLoad: number;
 };
@@ -80,13 +82,6 @@ declare const CMP_FLAGS: {
    * Used to determine if a component does not use the shadow DOM _and_ has `<slot/>` tags in its markup.
    */
   readonly hasSlotRelocation: number;
-  /**
-   * Determines if a shim for the shadow DOM is necessary.
-   *
-   * The shim should only be needed if a component requires {@link shadowDomEncapsulation} and if any output
-   * target-specific criteria are met. Refer to this flag's usage to determine each output target's criteria.
-   */
-  readonly needsShadowDomShim: number;
   /**
    * Determines if `delegatesFocus` is enabled for a component that uses the shadow DOM.
    * e.g. `shadow: { delegatesFocus: true }` is set on the `@Component()` decorator
@@ -97,10 +92,7 @@ declare const CMP_FLAGS: {
    */
   readonly hasMode: number;
   /**
-   * Determines if styles must be scoped due to either:
-   * 1. A component is using scoped stylesheets ({@link scopedCssEncapsulation})
-   * 2. A component is using the shadow DOM _and_ the output target's rules for requiring a shadow DOM shim have been
-   * met ({@link needsShadowDomShim})
+   * Determines if styles must be scoped - i.e. the component uses scoped stylesheets.
    */
   readonly needsScopedEncapsulation: number;
   /**
@@ -167,6 +159,7 @@ declare const XLINK_NS = "http://www.w3.org/1999/xlink";
  * File names and value
  */
 declare const COLLECTION_MANIFEST_FILE_NAME = "collection-manifest.json";
+declare const COLLECTION_APP_DATA_FILE_NAME = "app-data.js";
 /**
  * Constant for the 'copy' output target
  */
@@ -176,37 +169,54 @@ declare const COPY = "copy";
  */
 declare const CUSTOM = "custom";
 /**
- * Constant for the 'dist' output target
+ * Constant for the 'loader-bundle' output target
+ * (formerly 'dist' in v4)
  */
-declare const DIST = "dist";
+declare const LOADER_BUNDLE = "loader-bundle";
 /**
- * Constant for the 'dist-collection' output target
+ * Constant for the 'standalone' output target
+ * (formerly 'dist-custom-elements' in v4)
  */
-declare const DIST_COLLECTION = "dist-collection";
+declare const STANDALONE = "standalone";
 /**
- * Constant for the 'dist-custom-elements' output target
+ * Constant for the 'ssr' output target
+ * (formerly 'dist-hydrate-script' in v4)
  */
-declare const DIST_CUSTOM_ELEMENTS = "dist-custom-elements";
+declare const SSR = "ssr";
 /**
- * Constant for the 'dist-types' output target
+ * Constant for the 'ssr-wasm' output target.
+ * Compiles the SSR script to a WASM binary via javy for use in any WASM-capable host
+ * (PHP, Java, Ruby, Go, etc.) without requiring a JavaScript runtime.
  */
-declare const DIST_TYPES = "dist-types";
+declare const SSR_WASM = "ssr-wasm";
 /**
- * Constant for the 'dist-hydrate-script' output target
+ * Constant for the 'collection' output target
+ * (formerly 'dist-collection' sub-output in v4)
+ *
+ * Contains transpiled source + metadata for downstream Stencil projects
+ * to re-compile/bundle.
  */
-declare const DIST_HYDRATE_SCRIPT = "dist-hydrate-script";
+declare const COLLECTION = "collection";
 /**
- * Constant for the 'dist-lazy' output target
+ * Constant for the 'types' output target
+ * (formerly 'dist-types' sub-output in v4)
  */
-declare const DIST_LAZY = "dist-lazy";
+declare const TYPES = "types";
 /**
- * Constant for the 'dist-lazy-loader' output target
+ * Constant for the 'global-style' output target
+ * Outputs global styles to a unified location available to all distributions.
  */
-declare const DIST_LAZY_LOADER = "dist-lazy-loader";
+declare const GLOBAL_STYLE = "global-style";
 /**
- * Constant for the 'dist-global-styles' output target
+ * Constant for the 'assets' output target
+ * Copies component assetsDirs to a unified location available to all distributions.
  */
-declare const DIST_GLOBAL_STYLES = "dist-global-styles";
+declare const ASSETS = "assets";
+/**
+ * Internal constant for the 'dist-lazy' output target
+ * (used by loader-bundle and www)
+ */
+declare const DIST_LAZY = "dist-lazy";
 /**
  * Constant for the 'docs-custom' output target
  */
@@ -227,6 +237,10 @@ declare const DOCS_VSCODE = "docs-vscode";
  * Constant for the 'docs-custom-elements-manifest' output target
  */
 declare const DOCS_CUSTOM_ELEMENTS_MANIFEST = "docs-custom-elements-manifest";
+/**
+ * Constant for the 'docs-agent-skill' output target
+ */
+declare const DOCS_AGENT_SKILL = "docs-agent-skill";
 /**
  * Constant for the 'stats' output target
  */
@@ -238,13 +252,14 @@ declare const WWW = "www";
 /**
  * Valid output targets to specify in a Stencil config.
  *
- * Note that there are some output targets (e.g. `DIST_TYPES`) which are
- * programmatically set as output targets by the compiler when other output
- * targets (in that case `DIST`) are set, but which are _not_ supported in a
- * Stencil config. This is enforced in the output target validation code.
+ * Note that some internal output targets (e.g. `DIST_LAZY`, `DIST_GLOBAL_STYLES`)
+ * are programmatically created by the compiler and are not user-configurable.
+ *
+ * In v5, `TYPES` and `COLLECTION` are auto-generated in production builds unless explicitly configured.
  */
-declare const VALID_CONFIG_OUTPUT_TARGETS: readonly ["www", "dist", "dist-collection", "dist-custom-elements", "dist-lazy", "dist-hydrate-script", "docs-json", "docs-readme", "docs-vscode", "docs-custom", "docs-custom-elements-manifest", "copy", "custom", "stats"];
+declare const VALID_CONFIG_OUTPUT_TARGETS: readonly ["www", "loader-bundle", "standalone", "ssr", "ssr-wasm", "collection", "types", "global-style", "assets", "dist", "dist-custom-elements", "dist-hydrate-script", "dist-collection", "dist-types", "docs-json", "docs-readme", "docs-vscode", "docs-custom", "docs-custom-elements-manifest", "docs-agent-skill", "copy", "custom", "stats"];
 declare const GENERATED_DTS = "components.d.ts";
+declare const STYLE_EXT: string[];
 /**
  * DOM Node types
  *
@@ -283,162 +298,8 @@ declare const formatLazyBundleRuntimeMeta: (bundleId: any, cmps: ComponentCompil
 declare const formatComponentRuntimeMeta: (compilerMeta: ComponentCompilerMeta, includeMethods: boolean) => ComponentRuntimeMetaCompact;
 declare const stringifyRuntimeData: (data: any) => string;
 //#endregion
-//#region src/utils/helpers.d.ts
-/**
- * Check if a value is defined (not null and not undefined).
- *
- * @param v - the value to check
- * @returns true if the value is defined
- */
-declare const isDef: (v: any) => boolean;
-/**
- * Convert a string from PascalCase to dash-case
- *
- * @param str the string to convert
- * @returns a converted string
- */
-declare const toDashCase: (str: string) => string;
-/**
- * Convert a string from dash-case / kebab-case to PascalCase (or CamelCase,
- * or whatever you call it!)
- *
- * @param str a string to convert
- * @returns a converted string
- */
-declare const dashToPascalCase: (str: string) => string;
-/**
- * Convert a string to 'camelCase'
- *
- * @param str the string to convert
- * @returns the converted string
- */
-declare const toCamelCase: (str: string) => string;
-/**
- * Capitalize the first letter of a string
- *
- * @param str the string to capitalize
- * @returns a capitalized string
- */
-declare const toTitleCase: (str: string) => string;
-/**
- * Escapes all occurrences of a specified pattern in a string.
- * This function replaces all matches of a given pattern in the input text with a specified replacement string.
- * It can handle both string and regular expression patterns and allows toggling between global and single-match replacements.
- *
- * @param text - The input string to process.
- * @param pattern - The pattern to search for in the input string. Can be a regular expression or a string.
- * @param replacement - The string to replace each match with.
- * @param replaceAll - Whether to replace all occurrences (true) or just the first occurrence (false). Defaults to true.
- * @returns The processed string with the replacements applied.
- */
-declare const escapeWithPattern: (text: string, pattern: RegExp | string, replacement: string, replaceAll?: boolean) => string;
-/**
- * This is just a no-op, don't expect it to do anything.
- */
-declare const noop: () => any;
-/**
- * Check whether a value is a 'complex type', defined here as an object or a
- * function.
- *
- * @param o the value to check
- * @returns whether it's a complex type or not
- */
-declare const isComplexType: (o: unknown) => boolean;
-/**
- * Sort an array without mutating it in-place (as `Array.prototype.sort`
- * unfortunately does)
- *
- * @param array the array you'd like to sort
- * @param prop a function for deriving sortable values (strings or numbers)
- * from array members
- * @returns a new array of all items `x` in `array` ordered by `prop(x)`
- */
-declare const sortBy: <T>(array: T[], prop: (item: T) => string | number) => T[];
-/**
- * A polyfill of sorts for `Array.prototype.flat` which will return the result
- * of calling that method if present and, if not, return an equivalent based on
- * `Array.prototype.reduce`.
- *
- * @param array the array to flatten (one level)
- * @returns a flattened array
- */
-declare const flatOne: <T>(array: T[][]) => T[];
-/**
- * Deduplicate an array, retaining items at the earliest position in which
- * they appear.
- *
- * So `unique([1,3,2,1,1,4])` would be `[1,3,2,4]`.
- *
- * @param array the array to deduplicate
- * @param predicate an optional function used to generate the key used to
- * determine uniqueness
- * @returns a new, deduplicated array
- */
-declare const unique: <T, K>(array: T[], predicate?: (item: T) => K) => T[];
-/**
- * Merge elements of an array into an existing array, using a predicate to
- * determine uniqueness and only adding elements when they are not present in
- * the first array.
- *
- * **Note**: this mutates the target array! This is intentional to avoid
- * unnecessary array allocation, but be sure that it's what you want!
- *
- * @param target the target array, to which new unique items should be added
- * @param newItems a list of new items, some (or all!) of which may be added
- * @param mergeWith a predicate function which reduces the items in `target`
- * and `newItems` to a value which can be equated with `===` for the purposes
- * of determining uniqueness
- */
-declare function mergeIntoWith<T1, T2>(target: T1[], newItems: T1[], mergeWith: (item: T1) => T2): void;
-/**
- * A utility for building an object from an iterable very similar to
- * `Object.fromEntries`
- *
- * @param entries an iterable object holding entries (key-value tuples) to
- * plop into a new object
- * @returns an object containing those entries
- */
-declare const fromEntries: <V>(entries: IterableIterator<[string, V]>) => Record<string, V>;
-/**
- * Based on a given object, create a new object which has only the specified
- * key-value pairs included in it.
- *
- * @param obj the object from which to take values
- * @param keys a set of keys to take
- * @returns an object mapping `key` to `obj[key]` if `obj[key]` is truthy for
- * every `key` in `keys`
- */
-declare const pluck: (obj: {
-  [key: string]: any;
-}, keys: string[]) => {
-  [key: string]: any;
-};
-declare const isBoolean: (v: any) => v is boolean;
-declare const isFunction: (v: any) => v is Function;
-declare const isNumber: (v: any) => v is number;
-declare const isObject: (val: object) => val is object;
-declare const isString: (v: any) => v is string;
-declare const isIterable: <T>(v: any) => v is Iterable<T>;
-//#endregion
-//#region src/utils/is-glob.d.ts
-/**
- * Check if a string is a glob pattern (e.g. 'src/*.js' or something like that)
- *
- * @param str a string to check
- * @returns whether the string is a glob pattern or not
- */
-declare const isGlob: (str: string) => boolean;
-//#endregion
-//#region src/utils/is-root-path.d.ts
-/**
- * Checks if the path is the Operating System (OS) root path, such as "/" or "C:\". This function does not take the OS
- * the code is running on into account when performing this evaluation.
- * @param p the path to check
- * @returns `true` if the path is an OS root path, `false` otherwise
- */
-declare const isRootPath: (p: string) => boolean;
-//#endregion
 //#region src/utils/logger/logger-rolldown.d.ts
+declare const isRolldownError: (e: unknown) => e is RolldownError;
 declare const loadRolldownDiagnostics: (config: ValidatedConfig, compilerCtx: CompilerCtx, buildCtx: BuildCtx, rolldownError: RolldownError) => void;
 declare const createOnWarnFn: (diagnostics: Diagnostic$1[], bundleModulesFiles?: Module[]) => (warning: {
   code?: string;
@@ -523,7 +384,8 @@ declare const buildWarn: (diagnostics: Diagnostic$1[]) => Diagnostic$1;
  * @param jsonFilePath the path to the JSON file where the error occurred
  * @param msg the error message
  * @param jsonField the key for the field which caused the error, used for finding
- * the error line in the original JSON file
+ * the error line in the original JSON file. Only root-level keys (with minimal
+ * indentation, typically 2 spaces) are highlighted to avoid matching nested keys.
  * @returns a reference to the newly-created diagnostic
  */
 declare const buildJsonFileError: (compilerCtx: CompilerCtx, diagnostics: Diagnostic$1[], jsonFilePath: string, msg: string, jsonField: string) => Diagnostic$1;
@@ -577,39 +439,32 @@ declare const filterExcludedComponents: (components: ComponentCompilerMeta[], co
 declare const relativeImport: (pathFrom: string, pathTo: string, ext?: string, addPrefix?: boolean) => string;
 declare const getComponentsDtsSrcFilePath: (config: ValidatedConfig) => string;
 /**
- * Helper to get an appropriate file path for `components.d.ts` for a `"dist"`
- * or `"dist-types"` output target.
+ * Helper to get an appropriate file path for `components.d.ts` for an output target.
  *
- * @param outputTarget the output target of interest
+ * @param typesDir the directory where types are generated
  * @returns a properly-formatted path
  */
-declare const getComponentsDtsTypesFilePath: (outputTarget: Required<OutputTargetDist> | OutputTargetDistTypes) => string;
-declare const isOutputTargetDist: (o: OutputTarget) => o is OutputTargetDist;
-declare const isOutputTargetDistCollection: (o: OutputTarget) => o is OutputTargetDistCollection;
-declare const isOutputTargetDistCustomElements: (o: OutputTarget) => o is OutputTargetDistCustomElements;
+declare const getComponentsDtsTypesFilePath: (typesDir: string) => string;
+declare const isOutputTargetLoaderBundle: (o: OutputTarget) => o is OutputTargetLoaderBundle;
+declare const isOutputTargetStandalone: (o: OutputTarget) => o is OutputTargetStandalone;
+declare const isOutputTargetSsr: (o: OutputTarget) => o is OutputTargetSsr;
+declare const isOutputTargetSsrWasm: (o: OutputTarget) => o is OutputTargetSsrWasm;
+declare const isOutputTargetCollection: (o: OutputTarget) => o is OutputTargetCollection;
+declare const isOutputTargetTypes: (o: OutputTarget) => o is OutputTargetTypes;
+declare const isOutputTargetGlobalStyle: (o: OutputTarget) => o is OutputTargetGlobalStyle;
+declare const isOutputTargetAssets: (o: OutputTarget) => o is OutputTargetAssets;
 declare const isOutputTargetCopy: (o: OutputTarget) => o is OutputTargetCopy;
 declare const isOutputTargetDistLazy: (o: OutputTarget) => o is OutputTargetDistLazy;
-declare const isOutputTargetDistLazyLoader: (o: OutputTarget) => o is OutputTargetDistLazyLoader;
-declare const isOutputTargetDistGlobalStyles: (o: OutputTarget) => o is OutputTargetDistGlobalStyles;
-declare const isOutputTargetHydrate: (o: OutputTarget) => o is OutputTargetHydrate;
 declare const isOutputTargetCustom: (o: OutputTarget) => o is OutputTargetCustom;
-declare const isOutputTargetDocs: (o: OutputTarget) => o is OutputTargetDocsJson | OutputTargetDocsReadme | OutputTargetDocsVscode | OutputTargetDocsCustom | OutputTargetDocsCustomElementsManifest;
+declare const isOutputTargetDocs: (o: OutputTarget) => o is OutputTargetDocsJson | OutputTargetDocsReadme | OutputTargetDocsVscode | OutputTargetDocsCustom | OutputTargetDocsCustomElementsManifest | OutputTargetDocsAgentSkill;
 declare const isOutputTargetDocsReadme: (o: OutputTarget) => o is OutputTargetDocsReadme;
 declare const isOutputTargetDocsJson: (o: OutputTarget) => o is OutputTargetDocsJson;
 declare const isOutputTargetDocsCustom: (o: OutputTarget) => o is OutputTargetDocsCustom;
 declare const isOutputTargetDocsVscode: (o: OutputTarget) => o is OutputTargetDocsVscode;
 declare const isOutputTargetDocsCustomElementsManifest: (o: OutputTarget) => o is OutputTargetDocsCustomElementsManifest;
+declare const isOutputTargetDocsAgentSkill: (o: OutputTarget) => o is OutputTargetDocsAgentSkill;
 declare const isOutputTargetWww: (o: OutputTarget) => o is OutputTargetWww;
 declare const isOutputTargetStats: (o: OutputTarget) => o is OutputTargetStats;
-declare const isOutputTargetDistTypes: (o: OutputTarget) => o is OutputTargetDistTypes;
-/**
- * Checks whether or not the supplied output target's type matches one of the eligible primary
- * package output target types (i.e. it can have `isPrimaryPackageOutputTarget: true` in its config).
- *
- * @param o The output target to check.
- * @returns Whether the output target type is one of the "primary" output targets.
- */
-declare const isEligiblePrimaryPackageOutputTarget: (o: OutputTarget) => o is EligiblePrimaryPackageOutputTarget;
 /**
  * Retrieve the Stencil component compiler metadata from a collection of Stencil {@link d.Module}s
  * @param moduleFiles the collection of `Module`s to retrieve the metadata from
@@ -624,100 +479,16 @@ type ValidConfigOutputTarget = (typeof VALID_CONFIG_OUTPUT_TARGETS)[number];
  * @returns whether or not the targetType is a valid, configurable output target.
  */
 declare function isValidConfigOutputTarget(targetType: string): targetType is ValidConfigOutputTarget;
-//#endregion
-//#region src/utils/path.d.ts
-/**
- * Convert Windows backslash paths to slash paths: foo\\bar ➔ foo/bar
- * Forward-slash paths can be used in Windows as long as they're not
- * extended-length paths and don't contain any non-ascii characters.
- * This was created since the path methods in Node.js outputs \\ paths on Windows.
- * @param path the Windows-based path to convert
- * @param relativize whether or not a relative path should have `./` prepended
- * @returns the converted path
- */
-declare const normalizePath: (path: string, relativize?: boolean) => string;
-/**
- * Same as normalizePath(), expect it'll also strip any query strings
- * from the path name. So /dir/file.css?tag=cmp-a becomes /dir/file.css
- * @param p the path to normalize
- * @returns the normalized path, sans any query strings
- */
-declare const normalizeFsPath: (p: string) => string;
-declare const normalizeFsPathQuery: (importPath: string) => {
-  filePath: string;
-  ext: string;
-  format: string;
-};
 /**
- * A wrapped version of node.js' {@link path.relative} which adds our custom
- * normalization logic. This solves the relative path between `from` and `to`!
+ * Filter output targets based on devMode and their skipInDev setting.
+ * In dev mode, targets with `skipInDev: true` are filtered out.
+ * In prod mode, all targets are included.
  *
- * The calculation of the returned path follows that of Node's logic, with one exception - if the calculated path
- * results in an empty string, a string of length one with a period (`'.'`) is returned.
- *
- * @throws the underlying node.js function can throw if either path is not a
- * string
- * @param from the path where relative resolution starts
- * @param to the destination path
- * @returns the resolved relative path
- */
-declare function relative(from: string, to: string): string;
-/**
- * A wrapped version of node.js' {@link path.join} which adds our custom
- * normalization logic. This joins all the arguments (path fragments) into a
- * single path.
- *
- * The calculation of the returned path follows that of Node's logic, with one exception - any trailing slashes will
- * be removed from the calculated path.
- *
- * @throws the underlying node function will throw if any argument is not a
- * string
- * @param paths the paths to join together
- * @returns a joined path!
+ * @param targets Array of output targets to filter
+ * @param devMode Whether we're in dev mode
+ * @returns Filtered array of active targets
  */
-declare function join(...paths: string[]): string;
-/**
- * A wrapped version of node.js' {@link path.resolve} which adds our custom
- * normalization logic. This resolves a path to a given (relative or absolute)
- * path.
- *
- * @throws the underlying node function will throw if any argument is not a
- * string
- * @param paths a path or path fragments to resolve
- * @returns a resolved path!
- */
-declare function resolve(...paths: string[]): string;
-/**
- * A wrapped version of node.js' {@link path.normalize} which adds our custom
- * normalization logic. This normalizes a path, de-duping repeated segment
- * separators and resolving `'..'` segments.
- *
- * @throws the underlying node function will throw if the argument is not a
- * string
- * @param toNormalize a path to normalize
- * @returns a normalized path!
- */
-declare function normalize(toNormalize: string): string;
-//#endregion
-//#region src/utils/query-nonce-meta-tag-content.d.ts
-/**
- * Helper method for querying a `meta` tag that contains a nonce value
- * out of a DOM's head.
- *
- * @param doc The DOM containing the `head` to query against
- * @returns The content of the meta tag representing the nonce value, or `undefined` if no tag
- * exists or the tag has no content.
- */
-declare function queryNonceMetaTagContent(doc: Document): string | undefined;
-//#endregion
-//#region src/utils/regular-expression.d.ts
-/**
- * Utility function that will escape all regular expression special characters in a string.
- *
- * @param text The string potentially containing special characters.
- * @returns The string with all special characters escaped.
- */
-declare const escapeRegExpSpecialCharacters: (text: string) => string;
+declare const filterActiveTargets: <T extends OutputTarget>(targets: T[], devMode: boolean) => T[];
 declare namespace result_d_exports {
   export { Result, err, map, ok, unwrap, unwrapErr };
 }
@@ -864,18 +635,6 @@ declare const getInlineSourceMappingUrlLinker: (sourceMapContents: string) => st
  */
 declare const getSourceMappingUrlForEndOfFile: (url: string) => string;
 //#endregion
-//#region src/utils/url-paths.d.ts
-/**
- * Determines whether a string should be considered a remote url or not.
- *
- * This helper only checks the provided string to evaluate is one of a few pre-defined schemes, and should not be
- * considered all-encompassing
- *
- * @param p the string to evaluate
- * @returns `true` if the provided string is a remote url, `false` otherwise
- */
-declare const isRemoteUrl: (p: string) => boolean;
-//#endregion
 //#region src/utils/util.d.ts
 /**
  * Create a stylistically-appropriate JS variable name from a filename
@@ -974,6 +733,21 @@ declare const parsePackageJson: (pkgJsonStr: string, pkgJsonFilePath: string) =>
 declare const readOnlyArrayHasStringMember: <T extends string>(readOnlyArray: ReadonlyArray<T>, maybeMember: T | string) => maybeMember is T;
 //#endregion
 //#region src/utils/validation.d.ts
+/**
+ * The result of an invalid `modes` check on a component's `styleUrls`/`styles`.
+ */
+interface ModeValidationError {
+  propName: 'styleUrls' | 'styles';
+  message: string;
+}
+/**
+ * Validates the mode keys used in a component's `styleUrls`/`styles` against a
+ * `config.modes` allowlist, if one is declared.
+ * @param configModes the `config.modes` allowlist (mixed string/{@link d.ModeConfig} entries)
+ * @param componentOptions the `@Component()` decorator options for a single component
+ * @returns a validation error if a used mode is unknown or a required mode is missing, undefined otherwise
+ */
+declare const validateComponentModes: (configModes: (string | ModeConfig)[] | undefined, componentOptions: Pick<ComponentOptions, "styleUrls" | "styles">) => ModeValidationError | undefined;
 /**
  * Validates that a component tag meets required naming conventions to be used for a web component
  * @param tag the tag to validate
@@ -1156,10 +930,6 @@ declare const createInMemoryFs: (sys: CompilerSystem) => {
  * `[ source, destination ]`
  */
 type FileCopyTuple = [string, string];
-/**
- * Collected instructions for all pending filesystem operations saved
- * to the in-memory filesystem.
- */
 /**
  * Results from committing pending filesystem operations
  */
@@ -1170,14 +940,6 @@ interface FsCommitResults {
   dirsDeleted: string[];
   dirsAdded: string[];
 }
-/**
- * Given the current state of the in-memory proxy filesystem, collect all of
- * the changes that need to be made in order to commit the currently-pending
- * operations (e.g. write, copy, delete) to the OS filesystem.
- *
- * @param items the storage data structure for the in-memory FS cache
- * @returns a collection of all the operations that need to be done
- */
 //#endregion
 //#region src/declarations/stencil-public-docs.d.ts
 /**
@@ -1200,6 +962,13 @@ interface JsonDocs {
    * The metadata for the JSDocs for each component in a Stencil project
    */
   components: JsonDocsComponent[];
+  /**
+   * Project-level usage content, collected from markdown files in a `usage`
+   * directory at the project's {@link Config.srcDir} root (as opposed to
+   * per-component usage content, which lives in {@link JsonDocsComponent.usage}).
+   * Keyed by file name (without extension), same shape as component usage.
+   */
+  usage?: JsonDocsUsage;
   /**
    * The timestamp at which the metadata was generated, in the format YYYY-MM-DDThh:mm:ss
    */
@@ -1580,6 +1349,142 @@ interface StyleDoc {
 }
 //#endregion
 //#region src/declarations/stencil-public-runtime.d.ts
+interface ComponentOptions {
+  /**
+   * Tag name of the web component. Ideally, the tag name must be globally unique,
+   * so it's recommended to choose an unique prefix for all your components within the same collection.
+   *
+   * In addition, tag name must contain a '-'
+   */
+  tag: string;
+  /**
+   * Encapsulation strategy for the component. Determines how styles and DOM are isolated.
+   *
+   * @example
+   * ```tsx
+   * // Shadow DOM (recommended for isolation)
+   * encapsulation: { type: 'shadow' }
+   * encapsulation: { type: 'shadow', mode: 'closed', delegatesFocus: true }
+   *
+   * // Scoped styles (class-based isolation without Shadow DOM)
+   * encapsulation: { type: 'scoped' }
+   *
+   * // No encapsulation (light DOM)
+   * encapsulation: { type: 'none' }
+   * encapsulation: { type: 'none', patches: ['all'] }  // with slot patches
+   * ```
+   *
+   * If not specified, defaults to `{ type: 'none' }` (no encapsulation).
+   */
+  encapsulation?: EncapsulationOptions;
+  /**
+   * Relative URL to some external stylesheet file. It should be a `.css` file unless some
+   * external plugin is installed like `@stencil/sass`.
+   */
+  styleUrl?: string;
+  /**
+   * Similar as `styleUrl` but allows to specify different stylesheets for different modes.
+   */
+  styleUrls?: string[] | ModeStyles;
+  /**
+   * String that contains inlined CSS instead of using an external stylesheet.
+   * The performance characteristics of this feature are the same as using an external stylesheet.
+   *
+   * Notice, you can't use sass, or less, only `css` is allowed using `styles`, use `styleUrl` is you need more advanced features.
+   */
+  styles?: string | {
+    [modeName: string]: any;
+  };
+  /**
+   * Array of relative links to folders of assets required by the component.
+   */
+  assetsDirs?: string[];
+  /**
+   * 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
+   * at build time and injected wherever `@import "stencil-globals"` appears in a global stylesheet.
+   *
+   * Useful for
+   * - pre-first-js-render styles (combatting cumulative layout shift)
+   * - host element and slotted content style
+   * - 'css-only' CEs - those that don't use a JS runtime at all
+   *
+   * @example
+   * ```tsx
+   * @Component({ tag: 'my-button', globalStyleUrl: './my-button.global.css' })
+   * ```
+   */
+  globalStyleUrl?: string;
+  /**
+   * Inline CSS string providing document-level styles for this component.
+   * Collected at build time and injected wherever `@import "stencil-globals"` appears.
+   * @see globalStyleUrl
+   */
+  globalStyle?: string;
+}
+/**
+ * Shadow DOM encapsulation options for the `encapsulation` property.
+ * Uses native Shadow DOM for style and DOM isolation.
+ */
+interface ShadowEncapsulation {
+  type: 'shadow';
+  /**
+   * The mode of the shadow root. Defaults to `'open'`.
+   * - `'open'`: The shadow root is accessible via `element.shadowRoot`
+   * - `'closed'`: The shadow root is not accessible via `element.shadowRoot`
+   */
+  mode?: 'open' | 'closed';
+  /**
+   * When set to `true`, specifies behavior that mitigates custom element issues
+   * around focusability. When a non-focusable part of the shadow DOM is clicked, the first
+   * focusable part is given focus, and the shadow host is given any available `:focus` styling.
+   */
+  delegatesFocus?: boolean;
+  /**
+   * Sets the slot assignment mode for the shadow root. When set to `'manual'`, enables imperative
+   * slotting using the `HTMLSlotElement.assign()` method. Defaults to `'named'` for standard
+   * declarative slotting behavior.
+   */
+  slotAssignment?: 'manual' | 'named';
+}
+/**
+ * Patch types for non-shadow DOM components that use slots.
+ * - `'all'`: Apply all slot-related patches (equivalent to `lightDomPatches: true`)
+ * - `'children'`: Patch child node accessors (children, firstChild, lastChild, etc.)
+ * - `'clone'`: Patch `cloneNode()` to handle slotted content
+ * - `'insert'`: Patch `appendChild()`, `insertBefore()`, etc. for slot relocation
+ */
+type SlotPatch = 'all' | 'children' | 'clone' | 'insert';
+/**
+ * No encapsulation - component renders to light DOM with optional slot patches.
+ */
+interface NoneEncapsulation {
+  type: 'none';
+  /**
+   * Patches to apply for slot handling in light DOM.
+   * Only relevant if the component uses `<slot>` elements.
+   */
+  patches?: SlotPatch[];
+}
+/**
+ * Scoped CSS encapsulation - styles are scoped via class names without Shadow DOM.
+ */
+interface ScopedEncapsulation {
+  type: 'scoped';
+  /**
+   * Patches to apply for slot handling with scoped styles.
+   * Only relevant if the component uses `<slot>` elements.
+   */
+  patches?: SlotPatch[];
+}
+/**
+ * Encapsulation options for the `@Component()` decorator.
+ * Determines how styles and DOM are isolated for the component.
+ */
+type EncapsulationOptions = ShadowEncapsulation | NoneEncapsulation | ScopedEncapsulation;
+interface ModeStyles {
+  [modeName: string]: string | string[];
+}
 type ListenTargetOptions = 'body' | 'document' | 'window';
 interface UserBuildConditionals {
   isDev: boolean;
@@ -1590,6 +1495,27 @@ interface UserBuildConditionals {
 type ResolutionHandler = (elm: HTMLElement) => string | undefined | null;
 type ErrorHandler = (err: any, element?: HTMLElement) => void;
 type TagTransformer = (tag: string) => string;
+/**
+ * A constructor type that can be used as the base for mixin factories.
+ *
+ * ```ts
+ * import { MixedInCtor } from '@stencil/core';
+ *
+ * const AFactoryFn = <B extends MixedInCtor>(Base: B) => {class A extends Base { propA = A }; return A;}
+ * ```
+ */
+type MixedInCtor<T = {}> = new (...args: any[]) => T;
+/**
+ * A map of `@Prop`/`@State` property names to their new and previous
+ * values, passed to `componentShouldUpdate` once per render cycle.
+ *
+ * Pass `this` as `T` to type `changes` against your component's own
+ * members, e.g. `componentShouldUpdate(changes: ComponentShouldUpdateChanges<this>)`.
+ */
+type ComponentShouldUpdateChanges<T = any> = { [K in Extract<keyof T, string>]?: {
+  newVal: T[K];
+  oldVal: T[K];
+}; };
 interface ComponentInterface {
   connectedCallback?(): void;
   disconnectedCallback?(): void;
@@ -1615,14 +1541,18 @@ interface ComponentInterface {
    */
   componentDidLoad?(): void;
   /**
-   * A `@Prop` or `@State` property changed and a rerender is about to be requested.
+   * One or more `@Prop` or `@State` properties changed and a rerender is
+   * about to be requested. `changes` contains every property that changed
+   * since the last render, keyed by property name.
    *
-   * Called multiple times throughout the life of
-   * the component as its properties change.
+   * Called once per render cycle, batching all properties that changed
+   * synchronously since the last render.
+   *
+   * Return `false` to prevent the pending render.
    *
    * componentShouldUpdate is not called on the first render.
    */
-  componentShouldUpdate?(newVal: any, oldVal: any, propName: string): boolean | void;
+  componentShouldUpdate?(changes: ComponentShouldUpdateChanges<this>): boolean | void;
   /**
    * The component is about to update and re-render.
    *
@@ -1645,6 +1575,36 @@ interface ComponentInterface {
   render?(): any;
   [memberName: string]: any;
 }
+/**
+ * A reusable behavior that hooks into a `ReactiveControllerHost`'s lifecycle. Modeled after Lit's
+ * `ReactiveController` pattern: implement the hooks you need, then register an instance with a host
+ * via `host.addController(this)`.
+ */
+interface ReactiveController {
+  hostConnected?(): void;
+  hostDisconnected?(): void;
+  hostWillLoad?(): Promise<void> | void;
+  hostDidLoad?(): void;
+  hostWillRender?(): Promise<void> | void;
+  hostDidRender?(): void;
+  hostWillUpdate?(): Promise<void> | void;
+  hostDidUpdate?(): void;
+}
+/**
+ * The shape added to a component by mixing in `ReactiveControllerHost` (see below).
+ */
+interface ReactiveControllerHostInterface extends ComponentInterface, HTMLElement {
+  readonly controllers: ReadonlySet<ReactiveController>;
+  addController(controller: ReactiveController): void;
+  removeController(controller: ReactiveController): void;
+  requestUpdate(): void;
+  /**
+   * Resolves once the next pending render commits. Matches the shape of Lit's
+   * `ReactiveControllerHost.updateComplete`, for interop with controllers written against Lit's API
+   * (e.g. `@lit/context`).
+   */
+  readonly updateComplete: Promise<boolean>;
+}
 interface RafCallback {
   (timeStamp: number): void;
 }
@@ -1689,7 +1649,7 @@ interface FunctionalUtilities {
   map: (children: VNode[], cb: (vnode: ChildNode$1, index: number, array: ChildNode$1[]) => ChildNode$1) => VNode[];
 }
 interface FunctionalComponent<T = {}> {
-  (props: T, children: VNode[], utils: FunctionalUtilities): VNode | VNode[] | null;
+  (props: T, children: VNode[], utils: FunctionalUtilities): VNode | null;
 }
 /**
  * A Child VDOM node
@@ -1700,7 +1660,7 @@ interface FunctionalComponent<T = {}> {
  * {@link FunctionalUtilities}).
  */
 interface ChildNode$1 {
-  vtag?: string | number | Function;
+  vtag?: string | number | Function | symbol | null;
   vkey?: string | number;
   vtext?: string;
   vchildren?: VNode[];
@@ -1712,13 +1672,15 @@ interface ChildNode$1 {
  */
 interface VNode {
   $flags$: number;
-  $tag$: string | number | Function;
+  $tag$: string | number | Function | symbol | null;
   $elm$: any;
   $text$: string;
   $children$: VNode[];
   $attrs$?: any;
   $name$?: string;
   $key$?: string | number;
+  /** Signal reference for vdom bypass: signal text nodes store the signal here. */
+  $signal$?: any;
 }
 //#endregion
 //#region src/declarations/stencil-public-compiler.d.ts
@@ -1805,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,
@@ -1859,16 +1807,6 @@ interface StencilConfig {
    * This behavior defaults to `true`, but may be opted-out of by setting this flag to `false`.
    */
   transformAliasedImportPaths?: boolean;
-  /**
-   * When `true`, Stencil will suppress diagnostics which warn about public members using reserved names
-   * (for example, decorating a method named `focus` with `@Method()`). Defaults to `false`.
-   */
-  suppressReservedPublicNameWarnings?: boolean;
-  /**
-   * When `true`, we will validate a project's `package.json` based on the output target the user has designated
-   * as `isPrimaryPackageOutputTarget: true` in their Stencil config.
-   */
-  validatePrimaryPackageOutputTarget?: boolean;
   /**
    * Passes custom configuration down to the "@rolldown/plugin-node-resolve" that Stencil uses under the hood.
    * For further information: https://stenciljs.com/docs/module-bundling
@@ -1888,24 +1826,24 @@ interface StencilConfig {
    * Defaults to `false` in dev mode and `true` in production mode.
    */
   minifyCss?: boolean;
-  /**
-   * Forces Stencil to run in `dev` mode if the value is `true` and `production` mode
-   * if it's `false`.
-   *
-   * Defaults to `false` (ie. production) unless the `--dev` flag is used in the CLI.
-   */
-  devMode?: boolean;
   /**
    * Object to provide a custom logger. By default a `logger` is already provided for the
    * platform the compiler is running on, such as NodeJS or a browser.
    */
   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/bundler edge cases
+   * and rarely-needed diagnostic suppressions.
+   */
+  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)
@@ -1970,14 +1908,6 @@ interface StencilConfig {
     after?: any[];
   };
   entryComponentsHint?: string[];
-  /**
-   * Sets whether Stencil will write files to `dist/` during the build or not.
-   *
-   * By default this value is set to the opposite value of {@link devMode},
-   * i.e. it will be `true` when building for production and `false` when
-   * building for development.
-   */
-  buildDist?: boolean;
   buildLogFilePath?: string;
   devInspector?: boolean;
   devServer?: StencilDevServerConfig;
@@ -2005,7 +1935,7 @@ interface StencilConfig {
    * An array of component tag names to exclude from production builds.
    * Useful to remove test, demo or experimental components from final output.
    *
-   * **Note:** Exclusion only applies to production builds (default, or when `--prod` is used).
+   * **Note:** Exclusion only applies to production builds (the default).
    * Development builds (with `--dev` flag) will include all components to support local testing.
    *
    * Supports glob patterns for matching multiple components:
@@ -2029,14 +1959,78 @@ interface StencilConfig {
    * Set whether unused dependencies should be excluded from the built output.
    */
   excludeUnusedDependencies?: boolean;
-  stencilCoreResolvedId?: string;
+  /**
+   * Declares the set of valid style "modes" (e.g. `ios`, `md`) used by mode-keyed
+   * `styleUrls`/`styles` in `@Component()`. When set, the compiler validates that
+   * every mode key used in a component matches one of these entries, catching typos
+   * at build time. Entries marked `required` must be present on every component that
+   * defines any mode-keyed styles.
+   *
+   * @example
+   * ```ts
+   * export const config: Config = {
+   *   modes: ['ios', { mode: 'md', required: true }],
+   * };
+   * ```
+   *
+   * @default []
+   */
+  modes?: (string | ModeConfig)[];
+  /**
+   * 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[];
 }
-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, primarily for shielding non-shadow DOM components
+ * from consuming frameworks that mutate internals they don't know about, plus other
+ * framework/bundler integration edge cases and rarely-needed diagnostic suppressions.
+ * These are opt-in 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;
   /**
@@ -2051,70 +2045,27 @@ 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;
   /**
-   * By default Stencil turns the stylesheet provided to `globalStyle` into a constructable stylesheet
-   * and adds it to each component when rendered on the client which can be useful for sharing styles
-   * efficiently across components.
-   *
-   * If you want Stencil to also add the `globalStyle` to each component when rendering on the server
-   * then set this to `true`. If your `globalStyle` sheet is large then doing this may bloat the size
-   * of your SSR output when using declarative-shadow-dom.
-   *
-   * Setting this to `false` will prevent Stencil from adding any `globalStyle` to each component.
-   *
-   * Defaults to `'client'`.
-   */
-  addGlobalStyleToComponents?: boolean | 'client';
-}
-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`.
+   * When `true`, Stencil will suppress diagnostics which warn about public members using reserved names
+   * (for example, decorating a method named `focus` with `@Method()`). Defaults to `false`.
    */
-  slotChildNodesFix?: IndividualFlags;
+  suppressPublicNameWarnings?: boolean;
   /**
-   * Enables all slot-related fixes such as {@link slotChildNodesFix}, and
-   * {@link scopedSlotTextContentFix}.
+   * When `true`, Stencil will suppress diagnostics which warn about event names conflicting with native DOM event names. Defaults to `false`.
    */
-  experimentalSlotFixes?: ExperimentalFixesEnabled;
-};
-type ConfigExtras = ConfigExtrasBase & (ConfigExtrasSlotFixes<true, true> | ConfigExtrasSlotFixes<false, boolean>);
+  suppressEventNameWarnings?: boolean;
+}
 interface Config extends StencilConfig {
   buildAppCore?: boolean;
-  buildDocs?: boolean;
   configPath?: string;
   writeLog?: boolean;
   devServer?: DevServerConfig;
@@ -2128,6 +2079,11 @@ interface Config extends StencilConfig {
   tsWatchOptions?: any;
   _isValidated?: boolean;
   _isTesting?: boolean;
+  /**
+   * Internal flag set when --docs CLI flag is used.
+   * Forces docs output targets to build even in dev mode.
+   */
+  _docsFlag?: boolean;
   /**
    * Whether running in a CI environment (disables interactive features, adjusts worker count)
    */
@@ -2206,11 +2162,11 @@ type UnvalidatedConfig = Loose<Config>;
  * type ReqFieldFoo = RequireFields<Foo, 'bar'>; // { bar: number, baz?: string }
  * ```
  */
-type RequireFields<T, K extends keyof T> = T & { [P in K]-?: T[P] };
+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' | 'devMode' | 'devServer' | 'extras' | 'fsNamespace' | 'hashFileNames' | 'hashedFileNameLength' | 'hydratedFlag' | 'logLevel' | 'logger' | 'minifyCss' | 'minifyJs' | 'namespace' | 'outputTargets' | 'packageJsonFilePath' | 'rolldownConfig' | 'rootDir' | 'srcDir' | 'srcIndexHtml' | 'sys' | 'transformAliasedImportPaths' | 'validatePrimaryPackageOutputTarget'>;
+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
@@ -2218,8 +2174,24 @@ type StrictConfigFields = keyof Pick<Config, 'cacheDir' | 'devMode' | 'devServer
  * validations have occurred at runtime.
  */
 type ValidatedConfig = RequireFields<Config, StrictConfigFields> & {
+  /**
+   * Whether the build is running in development mode.
+   * Set by the `--dev` CLI flag. Not user-configurable in `stencil.config.ts`.
+   */
+  devMode: boolean;
   sourceMap: boolean;
 };
+interface ModeConfig {
+  /**
+   * The mode name, matched against `styleUrls`/`styles` object keys in `@Component()`.
+   */
+  mode: string;
+  /**
+   * When `true`, every component that defines mode-keyed `styleUrls` or `styles`
+   * must include this mode. Defaults to `false`.
+   */
+  required?: boolean;
+}
 interface HydratedFlag {
   /**
    * Defaults to `hydrated`.
@@ -2422,11 +2394,11 @@ interface PrerenderConfig {
    * Run after each `document` is hydrated, but before it is serialized
    * into an HTML string. Hook is passed the `document` and its `URL`.
    */
-  afterHydrate?(document: Document, url: URL, results: PrerenderUrlResults): any | Promise<any>;
+  afterSsr?(document: Document, url: URL, results: PrerenderUrlResults): any | Promise<any>;
   /**
    * Run before each `document` is hydrated. Hook is passed the `document` it's `URL`.
    */
-  beforeHydrate?(document: Document, url: URL): any | Promise<any>;
+  beforeSsr?(document: Document, url: URL): any | Promise<any>;
   /**
    * Runs after the template Document object has serialize into an
    * HTML formatted string. Returns an HTML string to be used as the
@@ -2470,9 +2442,9 @@ interface PrerenderConfig {
    */
   filePath?(url: URL, filePath: string): string;
   /**
-   * Returns the hydrate options to use for each individual prerendered page.
+   * Returns the prerender options to use for each individual prerendered page.
    */
-  hydrateOptions?(url: URL): PrerenderHydrateOptions;
+  prerenderOptions?(url: URL): PrerenderOptions;
   /**
    * Returns the template file's content. The template is the base
    * HTML used for all prerendered pages.
@@ -2496,7 +2468,7 @@ interface PrerenderConfig {
    */
   trailingSlash?: boolean;
 }
-interface HydrateDocumentOptions {
+interface SsrDocumentOptions {
   /**
    * Build ID that will be added to `<html data-stencil-build="BUILD_ID">`. By default
    * a random ID will be generated
@@ -2513,7 +2485,7 @@ interface HydrateDocumentOptions {
    * JavaScript to read the structure of the HTML and rebuild each
    * component. Defaults to `true`.
    */
-  clientHydrateAnnotations?: boolean;
+  clientSsrAnnotations?: boolean;
   /**
    * Constrain `setTimeout()` to 1ms, but still async. Also
    * only allows `setInterval()` to fire once, also constrained to 1ms.
@@ -2612,10 +2584,19 @@ interface HydrateDocumentOptions {
     default: 'declarative-shadow-dom' | 'scoped';
   } | boolean;
 }
-interface SerializeDocumentOptions extends HydrateDocumentOptions {
+/**
+ * Backwards compat for v4
+ * @deprecated - use SsrDocumentOptions instead
+ */
+interface HydrateDocumentOptions extends SsrDocumentOptions {}
+interface SerializeDocumentOptions extends SsrDocumentOptions {
   /**
    * Runs after the `document` has been hydrated.
    */
+  afterSsr?(document: any): any | Promise<any>;
+  /**
+   * @deprecated Use `afterSsr` instead.
+   */
   afterHydrate?(document: any): any | Promise<any>;
   /**
    * Sets an approximate line width the HTML should attempt to stay within.
@@ -2628,6 +2609,10 @@ interface SerializeDocumentOptions extends HydrateDocumentOptions {
   /**
    * Runs before the `document` has been hydrated.
    */
+  beforeSsr?(document: any): any | Promise<any>;
+  /**
+   * @deprecated Use `beforeSsr` instead.
+   */
   beforeHydrate?(document: any): any | Promise<any>;
   /**
    * Format the HTML in a nicely indented format.
@@ -2665,12 +2650,17 @@ interface SerializeDocumentOptions extends HydrateDocumentOptions {
    */
   modes?: ResolutionHandler[];
 }
-interface HydrateFactoryOptions extends SerializeDocumentOptions {
+interface SsrFactoryOptions extends SerializeDocumentOptions {
   serializeToHtml: boolean;
   destroyWindow: boolean;
   destroyDocument: boolean;
 }
-interface PrerenderHydrateOptions extends SerializeDocumentOptions {
+/**
+ * Backwards compat for v4
+ * @deprecated - use SsrFactoryOptions instead
+ */
+interface HydrateFactoryOptions extends SsrFactoryOptions {}
+interface PrerenderOptions extends SerializeDocumentOptions {
   /**
    * Adds `<link rel="modulepreload">` for modules that will eventually be requested.
    * Defaults to `true`.
@@ -2705,6 +2695,11 @@ interface PrerenderHydrateOptions extends SerializeDocumentOptions {
    */
   staticDocument?: boolean;
 }
+/**
+ * v4 backwards compat
+ * @deprecated - use PrerenderOptions instead
+ */
+interface PrerenderHydrateOptions extends PrerenderOptions {}
 interface RobotsTxtOpts {
   urls: string[];
   sitemapUrl: string;
@@ -3013,18 +3008,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.
@@ -3091,6 +3086,7 @@ interface BuildNoChangeResults {
 interface CompilerBuildResults {
   buildId: number;
   componentGraph?: BuildResultsComponentGraph;
+  components: ComponentCompilerMeta[];
   diagnostics: Diagnostic$1[];
   dirsAdded: string[];
   dirsDeleted: string[];
@@ -3102,9 +3098,10 @@ interface CompilerBuildResults {
   hasError: boolean;
   hasSuccessfulBuild: boolean;
   hmr?: HotModuleReplacement;
-  hydrateAppFilePath?: string;
+  ssrAppFilePath?: string;
   isRebuild: boolean;
   namespace: string;
+  fsNamespace: string;
   outputs: BuildOutput[];
   rootDir: string;
   srcDir: string;
@@ -3265,8 +3262,8 @@ interface ConfigBundle {
 }
 /**
  * A file and/or directory copy operation that may be specified as part of
- * certain output targets for Stencil (in particular `dist`,
- * `dist-custom-elements`, and `www`).
+ * certain output targets for Stencil (in particular `loader-bundle`,
+ * `standalone`, and `www`).
  */
 interface CopyTask {
   /**
@@ -3287,8 +3284,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[];
   /**
@@ -3367,39 +3365,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;
-}
-interface RolldownConfig {
-  inputOptions?: RolldownInputOptions;
-  outputOptions?: RolldownOutputOptions;
-}
-interface RolldownInputOptions {
-  context?: string;
-  moduleContext?: ((id: string) => string) | {
-    [id: string]: string;
-  };
+/** Options for rolldown's built-in module resolver, passed directly to rolldown's `resolve` input option. */
+type NodeResolveConfig = NonNullable<InputOptions['resolve']>;
+interface RolldownConfig {
   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.
@@ -3464,57 +3435,91 @@ interface LoggerTimeSpan {
   duration(): number;
   finish(finishedMsg: string, color?: string, bold?: boolean, newLineSuffix?: boolean): number;
 }
-interface OutputTargetDist extends OutputTargetValidationConfig {
-  type: 'dist';
+/**
+ * Output target for generating lazy-loaded component bundles with a loader infrastructure.
+ * This creates an optimized distribution for CDN usage and applications that benefit from
+ * lazy-loading components on demand.
+ *
+ * Formerly known as 'dist' in v4.
+ *
+ * @example
+ * ```typescript
+ * {
+ *   type: 'loader-bundle',
+ *   dir: 'dist/loader-bundle'
+ * }
+ * ```
+ */
+interface OutputTargetLoaderBundle extends OutputTargetBaseNext {
+  type: 'loader-bundle';
+  /**
+   * Directory where lazy-loaded bundles will be written.
+   * @default '' (root of output directory)
+   */
   buildDir?: string;
-  collectionDir?: string | null;
+  copy?: CopyTask[];
+  empty?: boolean;
   /**
-   * When `true` this flag will transform aliased import paths defined in
-   * a project's `tsconfig.json` to relative import paths in the compiled output's
-   * `dist-collection` bundle if it is generated (i.e. `collectionDir` is set).
-   *
-   * Paths will be left in aliased format if `false`.
+   * Whether to generate CommonJS (CJS) bundles.
    *
-   * @example
-   * // tsconfig.json
-   * {
-   *   paths: {
-   *     "@utils/*": ['/src/utils/*']
-   *   }
-   * }
+   * When `true`, generates CJS output in `cjs/` subdirectory.
+   * When `false` (default in v5+), only ESM bundles are generated.
    *
-   * // Source file
-   * import * as dateUtils from '@utils/date-utils';
-   * // Output file
-   * import * as dateUtils from '../utils/date-utils';
+   * @default false
    */
-  transformAliasedImportPathsInCollection?: boolean | null;
-  typesDir?: string;
+  cjs?: boolean;
   /**
-   * Provide a custom path for the ESM loader directory, containing files you can import
+   * Custom path for the loader directory; files you can import
    * in an initiation script within your application to register all your components for
    * lazy loading.
    *
-   * @default /dist/loader
+   * @default 'loader' (relative to output directory)
    */
-  esmLoaderPath?: string;
-  copy?: CopyTask[];
-  empty?: boolean;
+  loaderPath?: string;
   /**
-   * Whether to generate CommonJS (CJS) bundles.
+   * Hash the filenames of generated chunks based on their content.
+   * Enables forever-caching of CDN-served bundles.
    *
-   * When `true`, generates CJS output in `dist/cjs/` and `dist/index.cjs.js`.
-   * When `false` (default in v5+), only ESM bundles are generated.
+   * @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
    */
-  cjs?: boolean;
+  externalRuntime?: boolean;
 }
-interface OutputTargetDistCollection extends OutputTargetValidationConfig {
-  type: 'dist-collection';
+/**
+ * Output target for generating Stencil component source for downstream re-bundling.
+ * This output contains transpiled source code, component metadata, and configuration
+ * that downstream Stencil projects can re-compile and bundle.
+ *
+ * Formerly 'dist-collection' sub-output in v4, now a first-class output target in v5.
+ *
+ * In production builds, this output is auto-generated unless explicitly configured.
+ *
+ * @example
+ * ```typescript
+ * {
+ *   type: 'collection',
+ *   dir: 'dist/collection',
+ *   transformAliasedImportPaths: true
+ * }
+ * ```
+ */
+interface OutputTargetCollection extends OutputTargetBaseNext {
+  type: 'collection';
   empty?: boolean;
-  dir: string;
-  collectionDir: string;
   /**
    * When `true` this flag will transform aliased import paths defined in
    * a project's `tsconfig.json` to relative import paths in the compiled output.
@@ -3536,10 +3541,25 @@ interface OutputTargetDistCollection extends OutputTargetValidationConfig {
    */
   transformAliasedImportPaths?: boolean | null;
 }
-interface OutputTargetDistTypes extends OutputTargetValidationConfig {
-  type: 'dist-types';
-  dir: string;
-  typesDir: string;
+/**
+ * Output target for generating TypeScript type definitions (.d.ts files).
+ *
+ * Formerly a sub-output of 'dist' and 'dist-custom-elements' in v4,
+ * now a first-class output target in v5 that can be shared across multiple outputs.
+ *
+ * In production builds, this output is auto-generated unless explicitly configured.
+ *
+ * @example
+ * ```typescript
+ * {
+ *   type: 'types',
+ *   dir: 'dist/types'
+ * }
+ * ```
+ */
+interface OutputTargetTypes extends OutputTargetBaseNext {
+  type: 'types';
+  empty?: boolean;
 }
 interface OutputTargetDistLazy extends OutputTargetBase {
   type: 'dist-lazy';
@@ -3549,22 +3569,106 @@ interface OutputTargetDistLazy extends OutputTargetBase {
   isBrowserBuild?: boolean;
   esmIndexFile?: string;
   cjsIndexFile?: string;
+  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;
 }
-interface OutputTargetDistGlobalStyles extends OutputTargetBase {
-  type: 'dist-global-styles';
-  file: string;
+/**
+ * Output target for global styles.
+ * Generates a CSS file from an input stylesheet.
+ *
+ * Can be configured in two ways:
+ * 1. **Implicit** (backwards compat): Set `globalStyle` in the config and this output is auto-generated
+ * 2. **Explicit**: Define this output target with an `input` property
+ *
+ * Multiple `global-style` outputs are supported for building separate CSS bundles.
+ *
+ * @example
+ * ```typescript
+ * // Explicit configuration with custom input/output
+ * {
+ *   type: 'global-style',
+ *   input: './src/theme.css',
+ *   fileName: 'theme.css',
+ *   dir: 'dist/assets',
+ *   copyToLoaderBrowser: false
+ * }
+ * ```
+ */
+interface OutputTargetGlobalStyle extends OutputTargetBaseNext {
+  type: 'global-style';
+  /**
+   * Path to the input CSS file to compile.
+   * When specified, this takes precedence over the `globalStyle` config option.
+   *
+   * If neither `input` nor `globalStyle` config is set, no CSS will be built.
+   */
+  input?: string;
+  /**
+   * Output filename for the compiled CSS.
+   * @default '{namespace}.css' when using globalStyle config, or basename of input file
+   */
+  fileName?: string;
+  /**
+   * When `true`, also copies the global style CSS to the loader-bundle browser directory
+   * for backwards compatibility with existing CDN consumers who have hardcoded CSS paths.
+   *
+   * @default true
+   */
+  copyToLoaderBrowser?: boolean;
+  /**
+   * Controls whether this global stylesheet is injected into component shadow DOMs
+   * as a constructable stylesheet at runtime.
+   *
+   * - `'none'` (default): Don't inject - stylesheet must be loaded externally (e.g., via `<link>`)
+   * - `'client'`: Inject only in client builds, not SSR (reduces SSR output size)
+   * - `'all'`: Inject in both client and SSR builds
+   *
+   * @default 'none'
+   */
+  inject?: 'none' | 'client' | 'all';
 }
-interface OutputTargetDistLazyLoader extends OutputTargetBase {
-  type: 'dist-lazy-loader';
-  dir: string;
-  esmDir: string;
-  cjsDir?: string;
-  componentDts: string;
-  empty: boolean;
+/**
+ * Output target for component assets.
+ * Copies all component `assetsDirs` to a unified location.
+ *
+ * auto-generated when components have `assetsDirs` unless explicitly configured.
+ * The output is placed in `dist/assets/` by default and is available to all distribution strategies.
+ *
+ * @example
+ * ```typescript
+ * {
+ *   type: 'assets',
+ *   dir: 'dist/assets'
+ * }
+ * ```
+ */
+interface OutputTargetAssets extends OutputTargetBaseNext {
+  type: 'assets';
 }
-interface OutputTargetHydrate extends OutputTargetBase {
-  type: 'dist-hydrate-script';
+/**
+ * Output target for server-side rendering (SSR) and hydration.
+ * Generates a script that can be used for SSR and static site generation (prerendering).
+ *
+ * Formerly known as 'dist-hydrate-script' in v4.
+ *
+ * @example
+ * ```typescript
+ * {
+ *   type: 'ssr',
+ *   dir: 'dist/ssr',
+ *   minify: true
+ * }
+ * ```
+ */
+interface OutputTargetSsr extends OutputTargetBase {
+  type: 'ssr';
   dir?: string;
   /**
    * Module IDs that should not be bundled into the script.
@@ -3584,6 +3688,13 @@ interface OutputTargetHydrate 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;
@@ -3641,6 +3752,22 @@ interface OutputTargetDocsReadme extends OutputTargetBase {
   overwriteExisting?: boolean | 'if-missing';
   footer?: string;
   strict?: boolean;
+  /**
+   * Add extra columns to the generated Properties/Events tables, e.g. to
+   * surface custom JSDoc tags as a column of their own.
+   */
+  customColumns?: {
+    props?: DocsReadmeCustomColumn<JsonDocsProp>[];
+    events?: DocsReadmeCustomColumn<JsonDocsEvent>[];
+  };
+}
+/**
+ * A custom column to render in a `docs-readme` Properties/Events table.
+ * `content` is invoked once per row.
+ */
+interface DocsReadmeCustomColumn<T> {
+  header: string;
+  content: (member: T, cmp: JsonDocsComponent) => string;
 }
 interface OutputTargetDocsJson extends OutputTargetBase {
   type: 'docs-json';
@@ -3681,18 +3808,46 @@ interface OutputTargetDocsCustom extends OutputTargetBase {
   generator: (docs: JsonDocs, config: Config) => void | Promise<void>;
   strict?: boolean;
 }
+/**
+ * Output target for generating an [Agent Skill](https://agentskills.io)
+ * (`SKILL.md` + per-component reference files) describing a component
+ * library, so AI coding agents can consume its API and usage examples
+ * directly.
+ */
+interface OutputTargetDocsAgentSkill extends OutputTargetBase {
+  type: 'docs-agent-skill';
+  /**
+   * The root directory where the skill (`SKILL.md` + `components/*.md`) is written.
+   *
+   * defaults to `dist/skill`
+   */
+  dir?: string;
+  /**
+   * The skill's name, used in the `SKILL.md` frontmatter.
+   *
+   * Defaults to a kebab-cased form of {@link Config.namespace}.
+   */
+  name?: string;
+  /**
+   * The skill's description, used in the `SKILL.md` frontmatter - this is the
+   * text agents use to decide when to load the skill.
+   *
+   * Defaults to an auto-generated sentence built from the project's
+   * {@link JsonDocs.usage} (if present) or its component tags.
+   */
+  description?: string;
+}
 interface OutputTargetStats extends OutputTargetBase {
   type: 'stats';
   file?: string;
 }
-interface OutputTargetBaseNext {
-  type: string;
+interface OutputTargetBaseNext extends OutputTargetBase {
   dir?: string;
 }
 /**
  * The collection of valid export behaviors.
  * Used to generate a type for typed configs as well as output target validation
- * for the `dist-custom-elements` output target.
+ * for the `standalone` output target.
  *
  * Adding a value to this const array will automatically add it as a valid option on the
  * output target configuration for `customElementsExportBehavior`.
@@ -3701,8 +3856,7 @@ interface OutputTargetBaseNext {
  * - `auto-define-custom-elements`: Enables the auto-definition of a component and its children (recursively) in the custom elements registry. This
  * functionality allows consumers to bypass the explicit call to define a component, its children, its children's
  * children, etc. Users of this flag should be aware that enabling this functionality may increase bundle size.
- * - `bundle`: A `defineCustomElements` function will be exported from the distribution directory. This behavior was added to allow easy migration
- * from `dist-custom-elements-bundle` to `dist-custom-elements`.
+ * - `bundle`: A `defineCustomElements` function will be exported from the distribution directory.
  * - `single-export-module`: All components will be re-exported from the specified directory's root `index.js` file.
  */
 declare const CustomElementsExportBehaviorOptions: readonly ["default", "auto-define-custom-elements", "bundle", "single-export-module"];
@@ -3711,23 +3865,40 @@ declare const CustomElementsExportBehaviorOptions: readonly ["default", "auto-de
  * This is used on the output target config for intellisense in typed configs.
  */
 type CustomElementsExportBehavior = (typeof CustomElementsExportBehaviorOptions)[number];
-interface OutputTargetDistCustomElements extends OutputTargetValidationConfig {
-  type: 'dist-custom-elements';
+/**
+ * Output target for generating standalone component modules.
+ * Each component is output as an individual ES module that can be directly imported.
+ *
+ * This output target is ideal for npm consumption and tree-shaking, as consumers
+ * can import only the components they need.
+ *
+ * Formerly known as 'dist-custom-elements' in v4.
+ *
+ * @example
+ * ```typescript
+ * {
+ *   type: 'standalone',
+ *   dir: 'dist/standalone',
+ *   externalRuntime: true,
+ *   autoLoader: true
+ * }
+ * ```
+ */
+interface OutputTargetStandalone extends OutputTargetBaseNext {
+  type: 'standalone';
   empty?: boolean;
   /**
    * Triggers the following behaviors when enabled:
    * 1. All `@stencil/core/*` module references are treated as external during bundling.
    * 2. File names are not hashed.
    * 3. File minification will follow the behavior defined at the root of the Stencil config.
+   *
+   * @default false
    */
   externalRuntime?: boolean;
   copy?: CopyTask[];
   includeGlobalScripts?: boolean;
   minify?: boolean;
-  /**
-   * Enables the generation of type definition files for the output target.
-   */
-  generateTypeDeclarations?: boolean;
   /**
    * Define the export/definition behavior for the output target's generated output.
    * This controls if/how custom elements will be defined or where components will be exported from.
@@ -3738,6 +3909,8 @@ interface OutputTargetDistCustomElements extends OutputTargetValidationConfig {
    * Generate an auto-loader script that uses MutationObserver to lazily load
    * and define custom elements as they appear in the DOM.
    *
+   * @default true
+   *
    * When set to `true`, generates a `loader.js` file that auto-starts on import.
    * Can also be configured with an object for more control:
    * - `fileName`: Custom filename for the loader (default: 'loader.js')
@@ -3777,27 +3950,45 @@ interface OutputTargetBase {
    * A unique string to differentiate one output target from another
    */
   type: string;
+  /**
+   * When `true`, this output target will be skipped during development builds (`--dev`).
+   * This improves dev build times by not generating production-only artifacts.
+   *
+   * Defaults vary by output target type:
+   * - `loader-bundle`: `false` (always builds)
+   * - `standalone`: `true` (skips in dev)
+   * - `ssr`: `true` (skips in dev, unless `devServer.ssr` is enabled)
+   * - `docs-*`: `true` (skips in dev)
+   * - `custom`: `true` (skips in dev)
+   * - `www`, `copy`, `stats`: `false` (always runs)
+   */
+  skipInDev?: boolean;
 }
-/**
- * Output targets that can have validation for common `package.json` field values
- * (module, types, etc.). This allows them to be marked for validation in a project's Stencil config.
- */
-interface OutputTargetValidationConfig extends OutputTargetBaseNext {
-  isPrimaryPackageOutputTarget?: boolean;
-}
-type EligiblePrimaryPackageOutputTarget = OutputTargetDist | OutputTargetDistCustomElements | OutputTargetDistCollection | OutputTargetDistTypes;
-type OutputTargetBuild = OutputTargetDistCollection | OutputTargetDistLazy;
+type OutputTargetBuild = OutputTargetCollection | OutputTargetDistLazy;
 interface OutputTargetCopy extends OutputTargetBase {
   type: 'copy';
   dir: string;
   copy?: CopyTask[];
-  copyAssets?: 'collection' | 'dist';
 }
 interface OutputTargetWww extends OutputTargetBase {
   /**
    * Webapp output target.
    */
   type: 'www';
+  /**
+   * Choose how components are bundled for the www output.
+   *
+   * - `'loader'` (default): Uses the loader-bundle architecture with chunk
+   *   splitting and a loader infrastructure. Best for production apps with many
+   *   components where you want optimal loading performance.
+   *
+   * - `'standalone'`: Uses standalone component modules with an auto-loader that
+   *   uses MutationObserver to dynamically import components as they appear in
+   *   the DOM. Simpler architecture, easier debugging, one module per component.
+   *
+   * Default: `'loader'`
+   */
+  bundleMode?: 'loader' | 'standalone';
   /**
    * The directory to write the app's JavaScript and CSS build
    * files to. The default is to place this directory as a child
@@ -3844,7 +4035,7 @@ interface OutputTargetWww extends OutputTargetBase {
    * Path to an external node module which has exports of the prerender config object.
    * ```
    * module.exports = {
-   *   afterHydrate(document, url) {
+   *   afterSsr(document, url) {
    *     document.title = `URL: ${url.href}`;
    *   }
    * }
@@ -3852,15 +4043,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 | OutputTargetDist | OutputTargetDistCollection | OutputTargetDistCustomElements | OutputTargetDistLazy | OutputTargetDistGlobalStyles | OutputTargetDistLazyLoader | OutputTargetDocsJson | OutputTargetDocsCustom | OutputTargetDocsReadme | OutputTargetDocsVscode | OutputTargetDocsCustomElementsManifest | OutputTargetWww | OutputTargetHydrate | OutputTargetStats | OutputTargetDistTypes;
+type OutputTarget = OutputTargetCopy | OutputTargetCustom | OutputTargetLoaderBundle | OutputTargetStandalone | OutputTargetSsr | OutputTargetSsrWasm | OutputTargetCollection | OutputTargetTypes | OutputTargetGlobalStyle | OutputTargetAssets | OutputTargetDistLazy | OutputTargetDocsJson | OutputTargetDocsCustom | OutputTargetDocsReadme | OutputTargetDocsVscode | OutputTargetDocsCustomElementsManifest | OutputTargetDocsAgentSkill | 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/).
@@ -3908,12 +4119,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
@@ -3955,24 +4160,13 @@ 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;
 }
 interface PrerenderStartOptions {
   buildId?: string;
-  hydrateAppFilePath?: string;
+  ssrAppFilePath?: string;
   componentGraph?: BuildResultsComponentGraph;
   srcIndexHtmlPath?: string;
 }
@@ -4047,6 +4241,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>;
@@ -4087,7 +4293,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;
   /**
@@ -4173,7 +4379,51 @@ interface TranspileOptions {
    * Adds `transformTag` calls to css strings and querySelector(All) calls
    */
   additionalTagTransformers?: boolean;
+  /**
+   * Callback used to resolve parent-class source for inheritance-chain analysis.
+   * Called when a component's `extends` clause references a class from another
+   * module.  Return the resolved absolute path and source text of that module,
+   * or `null` to skip inheritance resolution for that specifier.
+   *
+   * @example
+   * ```ts
+   * transpile(myComponentCode, {
+   *   resolveImport: (specifier, importer) => {
+   *     const resolved = require.resolve(specifier, { paths: [path.dirname(importer)] });
+   *     return { code: fs.readFileSync(resolved, 'utf8'), path: resolved };
+   *   },
+   * });
+   * ```
+   */
+  resolveImport?: (specifier: string, importer: string) => {
+    code: string;
+    path: string;
+  } | null;
+  /**
+   * When `true` class declarations at the end of a `@Component` inheritance chain
+   * * that have no `extends` clause * will get `extends HTMLElement` injected, and a minimal
+   * `constructor() { super(); }`. Any stencil static meta-getters are also stripped.
+   */
+  transformAsBaseClass?: boolean;
+  /**
+   * Overrides for Stencil's BUILD feature flags in the generated output.
+   * When set, a BUILD mutation statement is prepended to the compiled code so
+   * that the specified flags take effect for this component at runtime.
+   */
+  buildOverrides?: BuildOverrides;
 }
+/**
+ * Keys of {@link BuildConditionals} that can be meaningfully overridden at
+ * transpile time — config-driven flags that are not derived from component
+ * scanning or runtime environment detection.
+ */
+type BuildOverrideKeys = 'hotModuleReplacement' | 'signalBacking' | 'vdomSignals' | 'lightDomPatches' | 'slotChildNodes' | 'slotCloneNode' | 'slotDomMutations' | 'slotTextContent' | 'lifecycleDOMEvents' | 'initializeNextTick';
+/**
+ * Subset of Stencil's BUILD feature flags that can be overridden at transpile
+ * time. Derived from {@link BuildConditionals} via `Pick` so the field list
+ * and types stay in sync with the authoritative definition.
+ */
+type BuildOverrides = Pick<BuildConditionals, BuildOverrideKeys>;
 type CompileTarget = 'latest' | 'esnext' | 'es2020' | 'es2019' | 'es2018' | 'es2017' | 'es2015' | string | undefined;
 interface TranspileResults {
   code: string;
@@ -4199,6 +4449,17 @@ interface TransformOptions {
   style: 'static' | null;
   styleImportData: 'queryparams' | null;
   target?: string;
+  /**
+   * @see {@link TranspileOptions.resolveImport}
+   */
+  resolveImport?: (specifier: string, importer: string) => {
+    code: string;
+    path: string;
+  } | null;
+  /** @see {@link TranspileOptions.transformAsBaseClass} */
+  transformAsBaseClass?: boolean;
+  /** @see {@link TranspileOptions.buildOverrides} */
+  buildOverrides?: BuildOverrides;
 }
 interface CompileScriptMinifyOptions {
   target?: CompileTarget;
@@ -4297,6 +4558,7 @@ interface BuildFeatures {
   vdomStyle: boolean;
   vdomText: boolean;
   vdomXlink: boolean;
+  vdomSignals: boolean;
   slotRelocation: boolean;
   patchAll: boolean;
   patchChildren: boolean;
@@ -4343,21 +4605,27 @@ interface BuildConditionals extends Partial<BuildFeatures> {
   lazyLoad?: boolean;
   profile?: boolean;
   constructableCSS?: boolean;
-  appendChildSlotFix?: boolean;
-  slotChildNodesFix?: boolean;
-  scopedSlotTextContentFix?: boolean;
-  cloneNodeFix?: 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;
-  shadowDomShim?: boolean;
   asyncQueue?: boolean;
   additionalTagTransformers?: boolean | 'prod';
-  attachStyles?: boolean;
-  experimentalSlotFixes?: boolean;
-  experimentalScopedSlotChanges?: boolean;
-  addGlobalStyleToComponents?: boolean | 'client';
+  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 {
@@ -4408,15 +4676,17 @@ interface BuildCtx {
   hasScriptChanges: boolean;
   hasStyleChanges: boolean;
   hasWarning: boolean;
-  hydrateAppFilePath: string;
+  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;
@@ -4460,8 +4730,6 @@ interface CompilerBuildStats {
   options: {
     minifyJs: boolean;
     minifyCss: boolean;
-    hashFileNames: boolean;
-    hashedFileNameLength: number;
   };
   formats: {
     esmBrowser: ReadonlyArray<CompilerBuildStatBundle>;
@@ -4497,12 +4765,6 @@ interface BuildComponent {
   dependencies?: string[];
 }
 type SourceTarget = 'es2017' | 'latest';
-/**
- * A note regarding Rolldown types:
- * As of this writing, there is no great way to import external types for packages that are directly embedded in the
- * Stencil source. As a result, some types are duplicated here for Rolldown that will be used within the codebase.
- * Updates to rolldown may require these typings to be updated.
- */
 type RolldownResult = RolldownChunkResult | RolldownAssetResult;
 interface RolldownAssetResult {
   type: 'asset';
@@ -4523,16 +4785,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;
-}
 /**
  * Result of Stencil compressing, mangling, and otherwise 'minifying' JavaScript
  */
@@ -4576,6 +4828,7 @@ interface CollectionCompilerMeta {
   bundles?: {
     components: string[];
   }[];
+  buildFlags?: Partial<BuildConditionals>;
 }
 interface CollectionCompilerVersion {
   name: string;
@@ -4594,6 +4847,8 @@ interface CollectionManifest {
   global?: string;
   compiler?: CollectionCompilerVersion;
   bundles?: CollectionBundleManifest[];
+  /** Build flags the lib was compiled with. Consuming Stencil projects OR-merge these in. */
+  buildFlags?: Partial<BuildConditionals>;
 }
 type CollectionComponentEntryPath = string;
 interface CollectionBundleManifest {
@@ -4612,6 +4867,25 @@ interface CollectionDependencyData {
   name: string;
   tags: string[];
 }
+/**
+ * A memoized result of the SASS + Lightning CSS transformation for a single stylesheet, keyed by
+ * the annotated Rolldown import id (e.g. `/path/to/comp.scss?tag=ion-button&encapsulation=shadow`).
+ *
+ * Storing this allows all output targets (customElements, lazy, hydrate) that process the same
+ * stylesheets to share a single computation instead of repeating it N times.
+ */
+interface CssTransformCacheEntry {
+  /** Resolved file ID after plugin (SASS) transforms */
+  pluginTransformId: string;
+  /** CSS source produced by the SASS / plugin pipeline */
+  pluginTransformCode: string;
+  /** File dependencies discovered during the SASS transform (e.g. `@import`-ed partials) */
+  pluginTransformDependencies: string[];
+  /** Diagnostics emitted during the plugin transform pass */
+  pluginTransformDiagnostics: Diagnostic$1[];
+  /** Full output of the subsequent `transformCssToEsm` call */
+  cssTransformOutput: TransformCssToEsmOutput;
+}
 interface CompilerCtx {
   version: number;
   activeBuildId: number;
@@ -4624,7 +4898,8 @@ interface CompilerCtx {
   addWatchFile: (path: string) => void;
   cache: Cache;
   cssModuleImports: Map<string, string[]>;
-  cachedGlobalStyle: string;
+  /** Cache of built global styles, keyed by input file path */
+  globalStyleCache: Map<string, string>;
   collections: CollectionCompilerMeta[];
   compilerOptions: any;
   events: BuildEvents;
@@ -4638,7 +4913,7 @@ interface CompilerCtx {
   moduleMap: ModuleMap;
   nodeMap: NodeMap;
   resolvedCollections: Set<string>;
-  rolldownCacheHydrate: any;
+  rolldownCacheSsr: any;
   rolldownCacheLazy: any;
   rolldownCacheNative: any;
   styleModeNames: Set<string>;
@@ -4646,6 +4921,32 @@ interface CompilerCtx {
   changedFiles: Set<string>;
   worker?: CompilerWorkerContext;
   rolldownCache: Map<string, any>;
+  /**
+   * Cross-build cache for {@link ts.transpileModule} results.
+   * Keyed by `"${bundleId}:${normalizedFilePath}"`. Invalidated for any
+   * file that appears in {@link changedModules} after TypeScript re-emits.
+   * @see transpileCache in compiler-ctx.ts
+   */
+  transpileCache: Map<string, {
+    outputText: string;
+    sourceMapText: string | null;
+  }>;
+  /**
+   * Cross-build cache of the last style text pushed to the HMR client.
+   * Keyed by getScopeId result (e.g. "ion-accordion$ios"). Used by
+   * extTransformsPlugin to avoid re-pushing unchanged styles on every rebuild.
+   */
+  prevStylesMap: Map<string, string>;
+  /**
+   * Cross-output-target cache for the SASS + Lightning CSS computation.
+   * Keyed by the annotated Rolldown import id. Null entries indicate that the
+   * source file could not be read (propagated as a `null` return from the
+   * transform hook).
+   *
+   * Entries are invalidated in `invalidateRolldownCaches` whenever a
+   * source file or one of its SASS dependencies is modified.
+   */
+  cssTransformCache: Map<string, CssTransformCacheEntry | null>;
   reset(): void;
 }
 type NodeMap = WeakMap<any, ComponentCompilerMeta>;
@@ -4706,10 +5007,12 @@ interface ComponentCompilerFeatures {
   hasVdomStyle: boolean;
   hasVdomText: boolean;
   hasVdomXlink: boolean;
+  hasSignalsImport: boolean;
   hasWatchCallback: boolean;
   htmlAttrNames: string[];
   htmlTagNames: string[];
   htmlParts: string[];
+  htmlSlots: string[];
   isUpdateable: boolean;
   /**
    * A plain component is one that doesn't have:
@@ -4803,6 +5106,7 @@ interface ComponentCompilerMeta extends ComponentCompilerFeatures {
   states: ComponentCompilerState[];
   styleDocs: CompilerStyleDoc[];
   styles: StyleCompiler[];
+  globalStyles: ComponentGlobalStyle[];
   tagName: string;
   virtualProperties: ComponentCompilerVirtualProperty[];
   watchers: ComponentCompilerChangeHandler[];
@@ -4819,7 +5123,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;
@@ -4879,6 +5183,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.
@@ -4972,6 +5281,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;
@@ -5150,7 +5464,7 @@ interface HostElement extends HTMLElement {
   disconnectedCallback?: () => void;
   host?: Element;
   forceUpdate?: () => void;
-  __stencil__getHostRef?: () => HostRef;
+  __s_ghr?: () => HostRef;
   /**
    * Unique stencil id for this element
    */
@@ -5204,9 +5518,18 @@ interface HostElement extends HTMLElement {
    * must be resolved for the top, ancestor component to be fully hydrated
    */
   ['s-p']?: Promise<void>[];
+  /**
+   * Pending Connects:
+   * A list of {@link HostRef.$onFirstConnectPromise$} promises for descendants that
+   * were already registered with this component (their nearest Stencil ancestor) by
+   * the time this component's own initial `componentWillLoad` was scheduled. Awaited
+   * so this component's `componentWillLoad` can't fire before those descendants'
+   * real `connectedCallback`s have.
+   */
+  ['s-pc']?: Promise<void>[];
   componentOnReady?: () => Promise<this>;
 }
-interface HydrateResults {
+interface SsrResults {
   buildId: string;
   diagnostics: Diagnostic$1[];
   url: string;
@@ -5218,42 +5541,42 @@ interface HydrateResults {
   search: string | null;
   hash: string | null;
   html: string | null;
-  components: HydrateComponent[];
-  anchors: HydrateAnchorElement[];
-  imgs: HydrateImgElement[];
-  scripts: HydrateScriptElement[];
-  styles: HydrateStyleElement[];
-  staticData: HydrateStaticData[];
+  components: SsrComponent[];
+  anchors: SsrAnchorElement[];
+  imgs: SsrImgElement[];
+  scripts: SsrScriptElement[];
+  styles: SsrStyleElement[];
+  staticData: SsrStaticData[];
   title: string | null;
   hydratedCount: number;
   httpStatus: number | null;
 }
-interface HydrateComponent {
+interface SsrComponent {
   tag: string;
   mode: string;
   count: number;
   depth: number;
 }
-interface HydrateElement {
+interface SsrElement {
   [attrName: string]: string | undefined;
 }
-interface HydrateAnchorElement extends HydrateElement {
+interface SsrAnchorElement extends SsrElement {
   href?: string;
   target?: string;
 }
-interface HydrateImgElement extends HydrateElement {
+interface SsrImgElement extends SsrElement {
   src?: string;
 }
-interface HydrateScriptElement extends HydrateElement {
+interface SsrScriptElement extends SsrElement {
   src?: string;
   type?: string;
 }
-interface HydrateStyleElement extends HydrateElement {
+interface SsrStyleElement extends SsrElement {
   id?: string;
   href?: string;
   content?: string;
 }
-interface HydrateStaticData {
+interface SsrStaticData {
   id: string;
   type: string;
   content: string;
@@ -5315,6 +5638,7 @@ interface Module {
   htmlAttrNames: string[];
   htmlTagNames: string[];
   htmlParts: string[];
+  htmlSlots: string[];
   isCollectionDependency: boolean;
   isLegacy: boolean;
   jsFilePath: string;
@@ -5344,6 +5668,7 @@ interface Module {
   hasVdomStyle: boolean;
   hasVdomText: boolean;
   hasVdomXlink: boolean;
+  hasSignalsImport: boolean;
 }
 interface Plugin {
   name?: string;
@@ -5378,7 +5703,7 @@ interface PrerenderUrlRequest {
   baseUrl: string;
   componentGraphPath: string;
   devServerHostUrl: string;
-  hydrateAppFilePath: string;
+  ssrAppFilePath: string;
   isDebug: boolean;
   prerenderConfigPath: string;
   staticSite: boolean;
@@ -5391,7 +5716,7 @@ interface PrerenderManager {
   prerenderUrlWorker: (prerenderRequest: PrerenderUrlRequest) => Promise<PrerenderUrlResults>;
   devServerHostUrl: string;
   diagnostics: Diagnostic$1[];
-  hydrateAppFilePath: string;
+  ssrAppFilePath: string;
   isDebug: boolean;
   logCount: number;
   outputTarget: OutputTargetWww;
@@ -5444,6 +5769,11 @@ interface RenderNode extends HostElement {
    * Slot name of either the slot itself or the slotted node
    */
   ['s-sn']?: string;
+  /**
+   * `slot` attribute of a `<slot>` reference rendered as a text node (no fallback content),
+   * since text nodes can't carry real DOM attributes.
+   */
+  ['s-sa']?: string;
   /**
    * Host element tag name:
    * The tag name of the host element that this
@@ -5496,64 +5826,64 @@ interface RenderNode extends HostElement {
    * Used to know the components encapsulation.
    * empty "" for shadow, "c" from scoped
    */
-  ['s-en']?: '' | /*shadow*/'c';
+  ['s-en']?: '' | /*shadow*/ 'c';
   /**
    * On a `scoped: true` component
-   * with `experimentalSlotFixes` flag enabled,
+   * with `lightDomPatches` flag enabled,
    * returns the internal `childNodes` of the component
    */
   readonly __childNodes?: NodeListOf<ChildNode>;
   /**
    * On a `scoped: true` component
-   * with `experimentalSlotFixes` flag enabled,
+   * with `lightDomPatches` flag enabled,
    * returns the internal `children` of the component
    */
   readonly __children?: HTMLCollectionOf<Element>;
   /**
    * On a `scoped: true` component
-   * with `experimentalSlotFixes` flag enabled,
+   * with `lightDomPatches` flag enabled,
    * returns the internal `firstChild` of the component
    */
   readonly __firstChild?: ChildNode;
   /**
    * On a `scoped: true` component
-   * with `experimentalSlotFixes` flag enabled,
+   * with `lightDomPatches` flag enabled,
    * returns the internal `lastChild` of the component
    */
   readonly __lastChild?: ChildNode;
   /**
    * On a `scoped: true` component
-   * with `experimentalSlotFixes` flag enabled,
+   * with `lightDomPatches` flag enabled,
    * returns the internal `textContent` of the component
    */
   __textContent?: string;
   /**
    * On a `scoped: true` component
-   * with `experimentalSlotFixes` flag enabled,
+   * with `lightDomPatches` flag enabled,
    * gives access to the original `append` method
    */
   __append?: (...nodes: (Node | string)[]) => void;
   /**
    * On a `scoped: true` component
-   * with `experimentalSlotFixes` flag enabled,
+   * with `lightDomPatches` flag enabled,
    * gives access to the original `prepend` method
    */
   __prepend?: (...nodes: (Node | string)[]) => void;
   /**
    * On a `scoped: true` component
-   * with `experimentalSlotFixes` flag enabled,
+   * with `lightDomPatches` flag enabled,
    * gives access to the original `appendChild` method
    */
   __appendChild?: <T extends Node>(newChild: T) => T;
   /**
    * On a `scoped: true` component
-   * with `experimentalSlotFixes` flag enabled,
+   * with `lightDomPatches` flag enabled,
    * gives access to the original `insertBefore` method
    */
   __insertBefore?: <T extends Node>(node: T, child: Node | null) => T;
   /**
    * On a `scoped: true` component
-   * with `experimentalSlotFixes` flag enabled,
+   * with `lightDomPatches` flag enabled,
    * gives access to the original `removeChild` method
    */
   __removeChild?: <T extends Node>(child: T) => T;
@@ -5591,40 +5921,56 @@ interface PatchedSlotNode extends Node {
   ['s-sr']?: boolean;
   /**
    * On a `scoped: true` component
-   * with `experimentalSlotFixes` flag enabled,
+   * with `lightDomPatches` flag enabled,
    * returns the actual `parentNode` of the component
    */
   __parentNode?: RenderNode;
   /**
    * On a `scoped: true` component
-   * with `experimentalSlotFixes` flag enabled,
+   * with `lightDomPatches` flag enabled,
    * returns the actual `nextSibling` of the component
    */
   __nextSibling?: RenderNode;
   /**
    * On a `scoped: true` component
-   * with `experimentalSlotFixes` flag enabled,
+   * with `lightDomPatches` flag enabled,
    * returns the actual `previousSibling` of the component
    */
   __previousSibling?: RenderNode;
   /**
    * On a `scoped: true` component
-   * with `experimentalSlotFixes` flag enabled,
+   * with `lightDomPatches` flag enabled,
    * returns the actual `nextElementSibling` of the component
    */
   __nextElementSibling?: RenderNode;
   /**
    * On a `scoped: true` component
-   * with `experimentalSlotFixes` flag enabled,
+   * with `lightDomPatches` flag enabled,
    * returns the actual `nextElementSibling` of the component
    */
   __previousElementSibling?: RenderNode;
 }
 type LazyBundlesRuntimeData = LazyBundleRuntimeData[];
-type LazyBundleRuntimeData = [/** bundleIds */string, ComponentRuntimeMetaCompact[]];
-type ComponentRuntimeMetaCompact = [/** flags */number, /** tagname */string, /** members */{
+type LazyBundleRuntimeData = [
+/** bundleIds */
+string, ComponentRuntimeMetaCompact[]];
+type ComponentRuntimeMetaCompact = [
+/** flags */
+number,
+/** tagname */
+string,
+/** members */
+{
   [memberName: string]: ComponentRuntimeMember;
-}?, /** listeners */ComponentRuntimeHostListener[]?, /** watchers */ComponentConstructorChangeHandlers?, /** serializers */ComponentConstructorChangeHandlers?, /** deserializers */ComponentConstructorChangeHandlers?];
+}?,
+/** listeners */
+ComponentRuntimeHostListener[]?,
+/** watchers */
+ComponentConstructorChangeHandlers?,
+/** serializers */
+ComponentConstructorChangeHandlers?,
+/** deserializers */
+ComponentConstructorChangeHandlers?];
 /**
  * Runtime metadata for a Stencil component
  */
@@ -5716,7 +6062,7 @@ type ComponentRuntimeReflectingAttr = [string, string | undefined];
  * associated {@link HostRef} instance.
  */
 type RuntimeRef = HostElement | {
-  __stencil__getHostRef?: () => HostRef;
+  __s_ghr?: () => HostRef;
 };
 /**
  * Interface used to track an Element, it's virtual Node (`VNode`), and other data
@@ -5727,6 +6073,14 @@ interface HostRef {
   $cmpMeta$: ComponentRuntimeMeta;
   $hostElement$: HostElement;
   $instanceValues$?: Map<string, any>;
+  /**
+   * Prop/state changes accumulated since the last render, flushed to
+   * `componentShouldUpdate` once per render cycle.
+   */
+  $queuedPropChanges$?: ComponentShouldUpdateChanges;
+  $signalValues$?: Map<string, import('@preact/signals-core').Signal<any>>;
+  /** Dispose function that tears down all signal effects for this component. */
+  $signalCleanup$?: () => void;
   $serializerValues$?: Map<string, string>;
   $lazyInstance$?: ComponentInterface;
   /**
@@ -5759,6 +6113,21 @@ interface HostRef {
    * It is called after {@link HostRef.$onInstancePromise$} resolves.
    */
   $onRenderResolve$?: () => void;
+  /**
+   * A promise that resolves once this component's real `connectedCallback` has fired
+   * for the first time. Created lazily - either by a descendant that needs to wait for
+   * this component's connection before firing its own real `connectedCallback`
+   * ({@link HOST_FLAGS.hasFiredConnected}), or by this component registering itself
+   * with its nearest Stencil ancestor's `s-pc` list. This is what lets a component's
+   * real `connectedCallback` (and, transitively, a pending ancestor's initial
+   * `componentWillLoad`) stay ordered correctly regardless of which of an
+   * ancestor/descendant pair's lazy module happens to resolve first.
+   */
+  $onFirstConnectPromise$?: Promise<void>;
+  /**
+   * A callback which resolves {@link HostRef.$onFirstConnectPromise$}
+   */
+  $onFirstConnectResolve$?: () => void;
   $vnode$?: VNode;
   $queuedListeners$?: [string, any][];
   $rmListeners$?: (() => void)[];
@@ -5768,6 +6137,11 @@ interface HostRef {
    * Defer connectedCallback until after first render for components with slot relocation.
    */
   $deferredConnectedCallback$?: boolean;
+  /**
+   * The number of times this host's lazy component load has failed and been retried.
+   * Used to give up retrying after {@link MAX_LAZY_LOAD_RETRIES} failed attempts.
+   */
+  $loadRetryCount$?: number;
 }
 interface PlatformRuntime {
   /**
@@ -5825,6 +6199,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;
+}
 interface CompilerModeStyles {
   [modeName: string]: string[];
 }
@@ -5911,7 +6291,6 @@ interface PackageJsonData {
   browser?: string;
   module?: string;
   'jsnext:main'?: string;
-  'collection:main'?: string;
   unpkg?: string;
   collection?: string;
   types?: string;
@@ -6049,10 +6428,6 @@ interface NewSpecPageOptions {
    * Sets the mocked `document.referrer`.
    */
   referrer?: string;
-  /**
-   * Manually set if the mocked document supports Shadow DOM or not. Default is `true`.
-   */
-  supportsShadowDom?: boolean;
   /**
    * When a component is pre-rendered it includes HTML annotations, such as `s-id` attributes and `<!-t.0->` comments. This information is used by client-side hydrating. Default is `false`.
    */
@@ -6069,11 +6444,6 @@ interface NewSpecPageOptions {
    * By default, any changes to component properties and attributes must `page.waitForChanges()` in order to test the updates. As an option, `autoApplyChanges` continuously flushes the queue on the background. Default is `false`.
    */
   autoApplyChanges?: boolean;
-  /**
-   * By default, styles are not attached to the DOM and they are not reflected in the serialized HTML.
-   * Setting this option to `true` will include the component's styles in the serializable output.
-   */
-  attachStyles?: boolean;
   /**
    * Set {@link BuildConditionals} for testing based off the metadata of the component under test.
    * When `true` all `BuildConditionals` will be assigned to the global testing `BUILD` object, regardless of their
@@ -6085,6 +6455,20 @@ interface NewSpecPageOptions {
    * the spec page.
    */
   platform?: Partial<PlatformRuntime>;
+  /**
+   * Controls how shadow DOM components are serialized during `hydrateServerSide`.
+   * When set to `'scoped'`, shadow DOM components are rendered as scoped light DOM
+   * (matching the behavior of `serializeShadowRoot: 'scoped'` in production SSR).
+   * When set to `false`, shadow DOM components render with a real shadow root.
+   * Default is `false`.
+   */
+  serializeShadowRoot?: 'scoped' | false;
+  /**
+   * Override individual {@link BuildConditionals} for this test. Applied after all other
+   * BUILD setup so these values take final precedence. Useful for testing code paths that
+   * are gated behind a build flag (e.g. `{ signalBacking: true }`).
+   */
+  buildFlags?: Partial<BuildConditionals>;
 }
 /**
  * A record of `TypesMemberNameData` entities.
@@ -6251,4 +6635,4 @@ interface ValidateTypesResults {
   filePaths: string[];
 }
 //#endregion
-export { ComponentCompilerVirtualProperty as $, escapeRegExpSpecialCharacters as $a, TranspileOptions as $i, CompilerEventBuildFinish as $n, dashToPascalCase as $o, LoggerLineUpdater as $r, byteSize as $s, PluginTransformResults as $t, CompilerStyleDoc as A, StyleDoc as Aa, PrerenderConfig as Ai, UpdatedLazyBuildCtx as An, isOutputTargetStats as Ao, CopyResults as Ar, DIST_GLOBAL_STYLES as As, HydrateResults as At, ComponentCompilerMeta as B, isJsFile as Ba, RolldownInputOptions as Bi, BuildNoChangeResults as Bn, hasError as Bo, FsWatchResults as Br, EVENT_FLAGS as Bs, ModuleFormat as Bt, CompilerBuildStatBundle as C, JsonDocsProp as Ca, OutputTargetDocsVscode as Ci, TransformCssToEsmInput as Cn, isOutputTargetDocs as Co, CompilerSystemRenameResults as Cr, COLLECTION_MANIFEST_FILE_NAME as Cs, ExternalStyleCompiler as Ct, CompilerJsDoc as D, JsonDocsTypeLibrary as Da, PageReloadStrategy as Di, TypesImportData as Dn, isOutputTargetDocsReadme as Do, Config as Dr, DIST as Ds, HydrateComponent as Dt, CompilerCtx as E, JsonDocsTag as Ea, OutputTargetWww as Ei, TypeInfo as En, isOutputTargetDocsJson as Eo, CompilerWatcher as Er, DEFAULT_STYLE_MODE as Es, HydrateAnchorElement as Et, ComponentCompilerData as F, createJsVarName as Fa, ResolveModuleIdResults as Fi, WorkerMsgHandler as Fn, TASK_CANCELED_MSG as Fo, DevServer as Fr, DOCS_CUSTOM as Fs, JSDocTagInfo as Ft, ComponentCompilerPropertyType as G, readOnlyArrayHasStringMember as Ga, SitemapXmpOpts as Gi, CacheStorage as Gn, splitLineBreaks as Go, HydrateFactoryOptions as Gr, MEMBER_FLAGS as Gs, NodeMap as Gt, ComponentCompilerMethodComplexType as H, isTsFile as Ha, RolldownOutputOptions as Hi, BuildOnEvents as Hn, shouldIgnoreError as Ho, HmrStyleUpdate as Hr, HOST_FLAGS as Hs, MsgFromWorker as Ht, ComponentCompilerEvent as I, generatePreamble as Ia, ResolveModuleOptions as Ii, AutoprefixerOptions as In, buildError as Io, DevServerConfig as Ir, DOCS_CUSTOM_ELEMENTS_MANIFEST as Is, JsDoc as It, ComponentCompilerStaticEvent as J, getInlineSourceMappingUrlLinker as Ja, StencilDevServerConfig as Ji, CompileTarget as Jn, loadTypeScriptDiagnostics as Jo, LazyRequire as Jr, SVG_NS as Js, ParsedImport as Jt, ComponentCompilerReferencedType as K, readPackageJson as Ka, SitemapXmpResults as Ki, CliInitOptions as Kn, augmentDiagnosticWithNode as Ko, HydratedFlag as Kr, NODE_TYPES as Ks, OptimizeJsResult as Kt, ComponentCompilerEventComplexType as L, getTextDocs as La, RobotsTxtOpts as Li, BuildEmitEvents as Ln, buildJsonFileError as Lo, DevServerEditor as Lr, DOCS_JSON as Ls, LazyBundleRuntimeData as Lt, CompilerWorkerTask as M, validateComponentTag as Ma, PrerenderResults as Mi, ValidateTypesResults as Mn, isValidConfigOutputTarget as Mo, Credentials as Mr, DIST_LAZY as Ms, HydrateStaticData as Mt, ComponentCompilerChangeHandler as N, ParsePackageJsonResult as Na, PrerenderStartOptions as Ni, Workbox as Nn, relativeImport as No, CustomElementsExportBehavior as Nr, DIST_LAZY_LOADER as Ns, HydrateStyleElement as Nt, CompilerJsDocTagInfo as O, JsonDocsUsage as Oa, ParsedPath as Oi, TypesMemberNameData as On, isOutputTargetDocsVscode as Oo, ConfigBundle as Or, DIST_COLLECTION as Os, HydrateElement as Ot, ComponentCompilerCustomState as P, addDocBlock as Pa, ResolveModuleIdOptions as Pi, WorkerContextMethod as Pn, shouldExcludeComponent as Po, CustomElementsExportBehaviorOptions as Pr, DIST_TYPES as Ps, ImportData as Pt, ComponentCompilerTypeReferences as Q, result_d_exports as Qa, TranspileOnlyResults as Qi, CompilerDependency as Qn, isGlob as Qo, Logger as Qr, XLINK_NS as Qs, PluginCtx as Qt, ComponentCompilerFeatures as R, hasDependency as Ra, RobotsTxtResults as Ri, BuildEvents as Rn, buildWarn as Ro, Diagnostic$1 as Rr, DOCS_README as Rs, LazyBundlesRuntimeData as Rt, CompilerAssetDir as S, JsonDocsPart as Sa, OutputTargetDocsReadme as Si, StyleMap as Sn, isOutputTargetDistTypes as So, CompilerSystemRemoveFileResults as Sr, CMP_FLAGS as Ss, EventInitDict as St, CompilerBuildStats as T, JsonDocsStyle as Ta, OutputTargetStats as Ti, TranspileModuleResults as Tn, isOutputTargetDocsCustomElementsManifest as To, CompilerSystemWriteFileResults as Tr, CUSTOM as Ts, HostRef as Tt, ComponentCompilerProperty as U, isTsxFile as Ua, SerializeDocumentOptions as Ui, BuildOutput as Un, escapeHtml as Uo, HotModuleReplacement as Ur, HTML_NS as Us, MsgToWorker as Ut, ComponentCompilerMethod as V, isJsxFile as Va, RolldownInterface as Vi, BuildOnEventRemove as Vn, hasWarning as Vo, HistoryApiFallback as Vr, GENERATED_DTS as Vs, ModuleMap as Vt, ComponentCompilerPropertyComplexType as W, parsePackageJson as Wa, ServiceWorkerConfig as Wi, BuildResultsComponentGraph as Wn, normalizeDiagnostics as Wo, HydrateDocumentOptions as Wr, LISTENER_FLAGS as Ws, NewSpecPageOptions as Wt, ComponentCompilerStaticProperty as X, getSourceMappingUrlLinker as Xa, SystemDetails as Xi, CompilerBuildResults as Xn, loadRolldownDiagnostics as Xo, LoadConfigResults as Xr, WATCH_FLAGS as Xs, PlatformRuntime as Xt, ComponentCompilerStaticMethod as Y, getSourceMappingUrlForEndOfFile as Ya, StencilDocsConfig as Yi, Compiler as Yn, createOnWarnFn as Yo, LoadConfigInit as Yr, VALID_CONFIG_OUTPUT_TARGETS as Ys, PatchedSlotNode as Yt, ComponentCompilerTypeReference as Z, rolldownToStencilSourceMap as Za, TransformOptions as Zi, CompilerBuildStart as Zn, isRootPath as Zo, LogLevel as Zr, WWW as Zs, Plugin as Zt, CollectionCompilerVersion as _, JsonDocsDependencyGraph as _a, OutputTargetDistLazyLoader as _i, SourceMap$1 as _n, isOutputTargetDistCollection as _o, CompilerSystemCreateDirectoryOptions as _r, toTitleCase as _s, CssImportData as _t, BuildCtx as a, WorkerOptions as aa, OptimizeJsOutput as ai, PropsType as an, normalizePath as ao, CompilerEventFileAdd as ar, isDef as as, ComponentConstructorProperties as at, CollectionDependencyManifest as b, JsonDocsMethod as ba, OutputTargetDocsCustomElementsManifest as bi, StencilDocument as bn, isOutputTargetDistLazy as bo, CompilerSystemRemoveDirectoryOptions as br, formatLazyBundleRuntimeMeta as bs, Encapsulation as bt, BuildStyleUpdate as c, RafCallback as ca, OutputTargetBaseNext as ci, RolldownChunkResult as cn, FilterComponentsResult as co, CompilerEventFsChange as cr, isNumber as cs, ComponentNativeConstructor as ct, BundleModuleOutput as d, UserBuildConditionals as da, OutputTargetCustom as di, RolldownResults as dn, getComponentsDtsTypesFilePath as do, CompilerFileWatcherCallback as dr, mergeIntoWith as ds, ComponentRuntimeMember as dt, TranspileResults as ea, LoggerTimeSpan as ei, PluginTransformationDescriptor as en, queryNonceMetaTagContent as eo, CompilerEventBuildLog as er, escapeWithPattern as es, ComponentConstructor as et, Cache as f, VNode as fa, OutputTargetDist as fi, RolldownSourceMap as fn, getComponentsFromModules as fo, CompilerFileWatcherEvent as fr, noop as fs, ComponentRuntimeMembers as ft, CollectionCompilerMeta as g, JsonDocsCustomState as ga, OutputTargetDistLazy as gi, SerializedEvent as gn, isOutputTargetDist as go, CompilerSystem as gr, toDashCase as gs, ComponentTestingConstructor as gt, CollectionCompiler as h, JsonDocsComponent as ha, OutputTargetDistGlobalStyles as hi, SerializeImportData as hn, isOutputTargetCustom as ho, CompilerRequestResponse as hr, toCamelCase as hs, ComponentRuntimeReflectingAttr as ht, BuildConditionals as i, WorkerMainController as ia, OptimizeJsInput as ii, PrintLine as in, normalizeFsPathQuery as io, CompilerEventDirDelete as ir, isComplexType as is, ComponentConstructorListener as it, CompilerWorkerContext as j, FsWriteResults as ja, PrerenderHydrateOptions as ji, VNodeProdData as jn, isOutputTargetWww as jo, CopyTask as jr, DIST_HYDRATE_SCRIPT as js, HydrateScriptElement as jt, CompilerModeStyles as k, JsonDocsValue as ka, PlatformPath as ki, TypesModule as kn, isOutputTargetHydrate as ko, ConfigExtras as kr, DIST_CUSTOM_ELEMENTS as ks, HydrateImgElement as kt, BuildTask as l, ResolutionHandler as la, OutputTargetBuild as li, RolldownResult as ln, filterExcludedComponents as lo, CompilerEventName as lr, isObject as ls, ComponentPatches as lt, CollectionBundleManifest as m, JsonDocs as ma, OutputTargetDistCustomElements as mi, RuntimeRef as mn, isOutputTargetCopy as mo, CompilerRequest as mr, sortBy as ms, ComponentRuntimeMetaCompact as mt, AssetsMeta as n, ValidatedConfig as na, OptimizeCssInput as ni, PrerenderUrlRequest as nn, normalize as no, CompilerEventBuildStart as nr, fromEntries as ns, ComponentConstructorEncapsulation as nt, BuildFeatures as o, ErrorHandler as oa, OutputTarget as oi, RenderNode as on, relative as oo, CompilerEventFileDelete as or, isFunction as os, ComponentConstructorProperty as ot, ChildType as p, JsonDocMethodParameter as pa, OutputTargetDistCollection as pi, RootAppliedStyleMap as pn, isEligiblePrimaryPackageOutputTarget as po, CompilerFsStats as pr, pluck as ps, ComponentRuntimeMeta as pt, ComponentCompilerState as q, isRemoteUrl as qa, StencilConfig as qi, CompileScriptMinifyOptions as qn, loadTypeScriptDiagnostic as qo, LOG_LEVELS as qr, STATS as qs, PackageJsonData as qt, BuildComponent as r, WatcherCloseResults as ra, OptimizeCssOutput as ri, PrerenderUrlResults as rn, normalizeFsPath as ro, CompilerEventDirAdd as rr, isBoolean as rs, ComponentConstructorEvent as rt, BuildSourceGraph as s, FunctionalComponent as sa, OutputTargetBase as si, RolldownAssetResult as sn, resolve as so, CompilerEventFileUpdate as sr, isIterable as ss, ComponentConstructorPropertyType as st, AnyHTMLElement as t, UnvalidatedConfig as ta, NodeResolveConfig as ti, PrerenderManager as tn, join as to, CompilerEventBuildNoChange as tr, flatOne as ts, ComponentConstructorChangeHandlers as tt, BundleModule as u, TagTransformer as ua, OutputTargetCopy as ui, RolldownResultModule as un, getComponentsDtsSrcFilePath as uo, CompilerFileWatcher as ur, isString as us, ComponentRuntimeHostListener as ut, CollectionComponentEntryPath as v, JsonDocsEvent as va, OutputTargetDistTypes as vi, SourceTarget as vn, isOutputTargetDistCustomElements as vo, CompilerSystemCreateDirectoryResults as vr, unique as vs, CssToEsmImportData as vt, CompilerBuildStatCollection as w, JsonDocsSlot as wa, OutputTargetHydrate as wi, TransformCssToEsmOutput as wn, isOutputTargetDocsCustom as wo, CompilerSystemRenamedPath as wr, COPY as ws, HostElement as wt, CollectionManifest as x, JsonDocsMethodReturn as xa, OutputTargetDocsJson as xi, StyleCompiler as xn, isOutputTargetDistLazyLoader as xo, CompilerSystemRemoveDirectoryResults as xr, stringifyRuntimeData as xs, EntryModule as xt, CollectionDependencyData as y, JsonDocsListener as ya, OutputTargetDocsCustom as yi, SpecPage as yn, isOutputTargetDistGlobalStyles as yo, CompilerSystemRealpathResults as yr, formatComponentRuntimeMeta as ys, DocData as yt, ComponentCompilerListener as z, isDtsFile as za, RolldownConfig as zi, BuildLog as zn, catchError as zo, EligiblePrimaryPackageOutputTarget as zr, DOCS_VSCODE as zs, Module as zt };
+export { ComponentCompilerVirtualProperty as $, isDtsFile as $a, SsrFactoryOptions as $i, CompilerBuildResults as $n, loadTypeScriptDiagnostic as $o, LoadConfigInit as $r, PropsType as $t, CompilerStyleDoc as A, JsonDocsListener as Aa, OutputTargetStandalone as Ai, TypesMemberNameData as An, isOutputTargetGlobalStyle as Ao, Config as Ar, NODE_TYPES as As, JsDoc as At, ComponentCompilerMeta as B, JsonDocsValue as Ba, PrerenderResults as Bi, BuildEvents as Bn, shouldExcludeComponent as Bo, DevServerEditor as Br, WWW as Bs, OptimizeJsResult as Bt, CompilerBuildStatBundle as C, VNode as Ca, OutputTargetDocsJson as Ci, StyleCompiler as Cn, isOutputTargetDocs as Co, CompilerSystemRemoveDirectoryOptions as Cr, GENERATED_DTS as Cs, EntryModule as Ct, CompilerJsDoc as D, JsonDocsCustomState as Da, OutputTargetLoaderBundle as Di, TranspileModuleResults as Dn, isOutputTargetDocsJson as Do, CompilerSystemRenamedPath as Dr, LISTENER_FLAGS as Ds, HostRef as Dt, CompilerCtx as E, JsonDocsComponent as Ea, OutputTargetGlobalStyle as Ei, TransformCssToEsmOutput as En, isOutputTargetDocsCustomElementsManifest as Eo, CompilerSystemRenameResults as Er, HTML_NS as Es, HostElement as Et, ComponentCompilerData as F, JsonDocsSlot as Fa, ParsedPath as Fi, Workbox as Fn, isOutputTargetStats as Fo, Credentials as Fr, STYLE_EXT as Fs, ModuleMap as Ft, ComponentCompilerPropertyType as G, validateComponentModes as Ga, RobotsTxtOpts as Gi, BuildOutput as Gn, catchError as Go, HmrStyleUpdate as Gr, Plugin as Gt, ComponentCompilerMethodComplexType as H, FsWriteResults as Ha, ResolveModuleIdOptions as Hi, BuildNoChangeResults as Hn, buildError as Ho, DocsReadmeCustomColumn as Hr, ParsedImport as Ht, ComponentCompilerEvent as I, JsonDocsStyle as Ia, PlatformPath as Ii, WorkerContextMethod as In, isOutputTargetTypes as Io, CustomElementsExportBehavior as Ir, SVG_NS as Is, MsgFromWorker as It, ComponentCompilerStaticEvent as J, addDocBlock as Ja, SerializeDocumentOptions as Ji, CacheStorage as Jn, shouldIgnoreError as Jo, HydrateFactoryOptions as Jr, PluginTransformationDescriptor as Jt, ComponentCompilerReferencedType as K, validateComponentTag as Ka, RobotsTxtResults as Ki, BuildOverrides as Kn, hasError as Ko, HotModuleReplacement as Kr, PluginCtx as Kt, ComponentCompilerEventComplexType as L, JsonDocsTag as La, PrerenderConfig as Li, WorkerMsgHandler as Ln, isOutputTargetWww as Lo, CustomElementsExportBehaviorOptions as Lr, TYPES as Ls, MsgToWorker as Lt, CompilerWorkerTask as M, JsonDocsMethodReturn as Ma, OutputTargetTypes as Mi, UpdatedLazyBuildCtx as Mn, isOutputTargetSsr as Mo, ConfigCompat as Mr, SSR_WASM as Ms, LazyBundlesRuntimeData as Mt, ComponentCompilerChangeHandler as N, JsonDocsPart as Na, OutputTargetWww as Ni, VNodeProdData as Nn, isOutputTargetSsrWasm as No, CopyResults as Nr, STANDALONE as Ns, Module as Nt, CompilerJsDocTagInfo as O, JsonDocsDependencyGraph as Oa, OutputTargetSsr as Oi, TypeInfo as On, isOutputTargetDocsReadme as Oo, CompilerSystemWriteFileResults as Or, LOADER_BUNDLE as Os, ImportData as Ot, ComponentCompilerCustomState as P, JsonDocsProp as Pa, PageReloadStrategy as Pi, ValidateTypesResults as Pn, isOutputTargetStandalone as Po, CopyTask as Pr, STATS as Ps, ModuleFormat as Pt, ComponentCompilerTypeReferences as Q, hasDependency as Qa, SsrDocumentOptions as Qi, Compiler as Qn, augmentDiagnosticWithNode as Qo, LightDomPatches as Qr, PrintLine as Qt, ComponentCompilerFeatures as R, JsonDocsTypeLibrary as Ra, PrerenderHydrateOptions as Ri, AutoprefixerOptions as Rn, isValidConfigOutputTarget as Ro, DevServer as Rr, VALID_CONFIG_OUTPUT_TARGETS as Rs, NewSpecPageOptions as Rt, CompilerAssetDir as S, UserBuildConditionals as Sa, OutputTargetDocsCustomElementsManifest as Si, StencilDocument as Sn, isOutputTargetDistLazy as So, CompilerSystemRealpathResults as Sr, EVENT_FLAGS as Ss, Encapsulation as St, CompilerBuildStats as T, JsonDocs as Ta, OutputTargetDocsVscode as Ti, TransformCssToEsmInput as Tn, isOutputTargetDocsCustom as To, CompilerSystemRemoveFileResults as Tr, HOST_FLAGS as Ts, ExternalStyleCompiler as Tt, ComponentCompilerProperty as U, InMemoryFileSystem as Ua, ResolveModuleIdResults as Ui, BuildOnEventRemove as Un, buildJsonFileError as Uo, FsWatchResults as Ur, PatchedSlotNode as Ut, ComponentCompilerMethod as V, StyleDoc as Va, PrerenderStartOptions as Vi, BuildLog as Vn, TASK_CANCELED_MSG as Vo, Diagnostic$1 as Vr, XLINK_NS as Vs, PackageJsonData as Vt, ComponentCompilerPropertyComplexType as W, ModeValidationError as Wa, ResolveModuleOptions as Wi, BuildOnEvents as Wn, buildWarn as Wo, HistoryApiFallback as Wr, PlatformRuntime as Wt, ComponentCompilerStaticProperty as X, generatePreamble as Xa, SitemapXmpOpts as Xi, CompileScriptMinifyOptions as Xn, normalizeDiagnostics as Xo, LOG_LEVELS as Xr, PrerenderUrlRequest as Xt, ComponentCompilerStaticMethod as Y, createJsVarName as Ya, ServiceWorkerConfig as Yi, CliInitOptions as Yn, escapeHtml as Yo, HydratedFlag as Yr, PrerenderManager as Yt, ComponentCompilerTypeReference as Z, getTextDocs as Za, SitemapXmpResults as Zi, CompileTarget as Zn, splitLineBreaks as Zo, LazyRequire as Zr, PrerenderUrlResults as Zt, CollectionCompilerVersion as _, MixedInCtor as _a, OutputTargetCopy as _i, SsrImgElement as _n, getComponentsFromModules as _o, CompilerRequest as _r, DOCS_CUSTOM as _s, ComponentTestingConstructor as _t, BuildCtx as a, TranspileOnlyResults as aa, ModeConfig as ai, RolldownResults as an, readOnlyArrayHasStringMember as ao, CompilerEventBuildStart as ar, formatLazyBundleRuntimeMeta as as, ComponentConstructorProperties as at, CollectionDependencyManifest as b, ResolutionHandler as ba, OutputTargetDocsAgentSkill as bi, SsrStaticData as bn, isOutputTargetCopy as bo, CompilerSystemCreateDirectoryOptions as br, DOCS_README as bs, CssTransformCacheEntry as bt, BuildStyleUpdate as c, UnvalidatedConfig as ca, OptimizeCssOutput as ci, RuntimeRef as cn, getSourceMappingUrlForEndOfFile as co, CompilerEventFileAdd as cr, CMP_FLAGS as cs, ComponentGlobalStyle as ct, BundleModuleOutput as d, WatcherCloseResults as da, OutputTarget as di, SourceMap$1 as dn, result_d_exports as do, CompilerEventFsChange as dr, COLLECTION_MANIFEST_FILE_NAME as ds, ComponentRuntimeHostListener as dt, StencilConfig as ea, LoadConfigResults as ei, RenderNode as en, isJsFile as eo, CompilerBuildStart as er, loadTypeScriptDiagnostics as es, ComponentConstructor as et, Cache as f, WorkerMainController as fa, OutputTargetAssets as fi, SourceTarget as fn, FilterComponentsResult as fo, CompilerEventName as fr, COPY as fs, ComponentRuntimeMember as ft, CollectionCompilerMeta as g, FunctionalComponent as ga, OutputTargetCollection as gi, SsrElement as gn, getComponentsDtsTypesFilePath as go, CompilerFsStats as gr, DOCS_AGENT_SKILL as gs, ComponentRuntimeReflectingAttr as gt, CollectionCompiler as h, ErrorHandler as ha, OutputTargetBuild as hi, SsrComponent as hn, getComponentsDtsSrcFilePath as ho, CompilerFileWatcherEvent as hr, DIST_LAZY as hs, ComponentRuntimeMetaCompact as ht, BuildConditionals as i, TransformOptions as ia, LoggerTimeSpan as ii, RolldownResultModule as in, parsePackageJson as io, CompilerEventBuildNoChange as ir, formatComponentRuntimeMeta as is, ComponentConstructorListener as it, CompilerWorkerContext as j, JsonDocsMethod as ja, OutputTargetStats as ji, TypesModule as jn, isOutputTargetLoaderBundle as jo, ConfigBundle as jr, SSR as js, LazyBundleRuntimeData as jt, CompilerModeStyles as k, JsonDocsEvent as ka, OutputTargetSsrWasm as ki, TypesImportData as kn, isOutputTargetDocsVscode as ko, CompilerWatcher as kr, MEMBER_FLAGS as ks, JSDocTagInfo as kt, BuildTask as l, ValidatedConfig as la, OptimizeJsInput as li, SerializeImportData as ln, getSourceMappingUrlLinker as lo, CompilerEventFileDelete as lr, COLLECTION as ls, ComponentNativeConstructor as lt, CollectionBundleManifest as m, ComponentInterface as ma, OutputTargetBaseNext as mi, SsrAnchorElement as mn, filterExcludedComponents as mo, CompilerFileWatcherCallback as mr, DEFAULT_STYLE_MODE as ms, ComponentRuntimeMeta as mt, AssetsMeta as n, StencilDocsConfig as na, Logger as ni, RolldownChunkResult as nn, isTsFile as no, CompilerEventBuildFinish as nr, isRolldownError as ns, ComponentConstructorEncapsulation as nt, BuildFeatures as o, TranspileOptions as oa, NodeResolveConfig as oi, RolldownSourceMap as on, readPackageJson as oo, CompilerEventDirAdd as or, stringifyRuntimeData as os, ComponentConstructorProperty as ot, ChildType as p, WorkerOptions as pa, OutputTargetBase as pi, SpecPage as pn, filterActiveTargets as po, CompilerFileWatcher as pr, CUSTOM as ps, ComponentRuntimeMembers as pt, ComponentCompilerState as q, ParsePackageJsonResult as qa, RolldownConfig as qi, BuildResultsComponentGraph as qn, hasWarning as qo, HydrateDocumentOptions as qr, PluginTransformResults as qt, BuildComponent as r, SystemDetails as ra, LoggerLineUpdater as ri, RolldownResult as rn, isTsxFile as ro, CompilerEventBuildLog as rr, loadRolldownDiagnostics as rs, ComponentConstructorEvent as rt, BuildSourceGraph as s, TranspileResults as sa, OptimizeCssInput as si, RootAppliedStyleMap as sn, getInlineSourceMappingUrlLinker as so, CompilerEventDirDelete as sr, ASSETS as ss, ComponentConstructorPropertyType as st, AnyHTMLElement as t, StencilDevServerConfig as ta, LogLevel as ti, RolldownAssetResult as tn, isJsxFile as to, CompilerDependency as tr, createOnWarnFn as ts, ComponentConstructorChangeHandlers as tt, BundleModule as u, ValidatedOutputTargetWww as ua, OptimizeJsOutput as ui, SerializedEvent as un, rolldownToStencilSourceMap as uo, CompilerEventFileUpdate as ur, COLLECTION_APP_DATA_FILE_NAME as us, ComponentPatches as ut, CollectionComponentEntryPath as v, RafCallback as va, OutputTargetCustom as vi, SsrResults as vn, isOutputTargetAssets as vo, CompilerRequestResponse as vr, DOCS_CUSTOM_ELEMENTS_MANIFEST as vs, CssImportData as vt, CompilerBuildStatCollection as w, JsonDocMethodParameter as wa, OutputTargetDocsReadme as wi, StyleMap as wn, isOutputTargetDocsAgentSkill as wo, CompilerSystemRemoveDirectoryResults as wr, GLOBAL_STYLE as ws, EventInitDict as wt, CollectionManifest as x, TagTransformer as xa, OutputTargetDocsCustom as xi, SsrStyleElement as xn, isOutputTargetCustom as xo, CompilerSystemCreateDirectoryResults as xr, DOCS_VSCODE as xs, DocData as xt, CollectionDependencyData as y, ReactiveControllerHostInterface as ya, OutputTargetDistLazy as yi, SsrScriptElement as yn, isOutputTargetCollection as yo, CompilerSystem as yr, DOCS_JSON as ys, CssToEsmImportData as yt, ComponentCompilerListener as z, JsonDocsUsage as za, PrerenderOptions as zi, BuildEmitEvents as zn, relativeImport as zo, DevServerConfig as zr, WATCH_FLAGS as zs, NodeMap as zt };