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

package/dist/{index-BopBfjPu.d.mts → index-BogZpjP2.d.mts}

@@ -1111,6 +1111,11 @@ interface JsonDocsComponent {
    * A deprecation reason/description found following a `@deprecated` tag
    */
   deprecation?: string;
+  /**
+   * `true` if this is a "CSS-only component"
+   * discovered in .css file via `@component`-marked JSDoc block
+   */
+  cssOnly?: boolean;
 }
 interface JsonDocsDependencyGraph {
   [tagName: string]: string[];
@@ -1270,6 +1275,16 @@ interface JsonDocsStyle {
    * The annotation used in the JSDoc of the style (e.g. `@prop`)
    */
   annotation: string;
+  /**
+   * The CSS `syntax` descriptor for a custom property, if it was registered via a native
+   * `@property` at-rule (e.g. `"<length>"`).
+   */
+  syntax?: string;
+  /**
+   * The `initial-value` descriptor for a custom property, if it was registered via a native
+   * `@property` at-rule.
+   */
+  default?: string;
   /**
    * The mode associated with the style
    */
@@ -1356,6 +1371,14 @@ interface StyleDoc {
    * The Stencil style-mode that is associated with this property.
    */
   mode: string | undefined;
+  /**
+   * The CSS `syntax` descriptor, if this property was registered via a native `@property` at-rule.
+   */
+  syntax?: string;
+  /**
+   * The `initial-value` descriptor, if this property was registered via a native `@property` at-rule.
+   */
+  default?: string;
 }
 //#endregion
 //#region src/declarations/stencil-public-runtime.d.ts
@@ -1412,7 +1435,7 @@ interface ComponentOptions {
   /**
    * Relative URL to an external stylesheet providing document-level styles for this component.
    * Unlike `styleUrl`, these styles are not scoped to shadow/scoped DOM - they are collected
-   * at build time and injected wherever `@import "stencil-globals"` appears in a global stylesheet.
+   * at build time and injected wherever `@import "stencil-component-globals"` appears in a global stylesheet.
    *
    * Useful for
    * - pre-first-js-render styles (combatting cumulative layout shift)
@@ -1427,7 +1450,7 @@ interface ComponentOptions {
   globalStyleUrl?: string;
   /**
    * Inline CSS string providing document-level styles for this component.
-   * Collected at build time and injected wherever `@import "stencil-globals"` appears.
+   * Collected at build time and injected wherever `@import "stencil-component-globals"` appears.
    * @see globalStyleUrl
    */
   globalStyle?: string;
@@ -1787,6 +1810,15 @@ interface StencilConfig {
    * @default false
    */
   generateExportMaps?: boolean;
+  /**
+   * Set to `false` to disable discovery of "CSS-only components" - pure-CSS custom-element
+   * definitions marked with a `@component` JSDoc tag in `.css` files under `srcDir`. No JS
+   * class, never registered via `customElements.define()` - just a documented,
+   * type-checked tag name and its CSS custom properties/attribute variants.
+   *
+   * Defaults to `true`.
+   */
+  enableCssOnlyComponents?: 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,
@@ -1829,7 +1861,7 @@ interface StencilConfig {
    */
   transformAliasedImportPaths?: boolean;
   /**
-   * Passes custom configuration down to the "@rolldown/plugin-node-resolve" that Stencil uses under the hood.
+   * Passes custom configuration to Rolldown's module resolution (its `resolve` option), e.g. `alias`.
    * For further information: https://stenciljs.com/docs/module-bundling
    */
   nodeResolve?: NodeResolveConfig;
@@ -2109,11 +2141,6 @@ 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)
    */
@@ -2633,7 +2660,7 @@ interface SerializeDocumentOptions extends SsrDocumentOptions {
    * Note that this is "approximate", in that HTML may often not be able
    * to be split at an exact line width. Additionally, new lines created
    * is where HTML naturally already has whitespace, such as before an
-   * attribute or spaces between words. Defaults to `100`.
+   * attribute or spaces between words. Defaults to no wrapping (`100` when prerendering).
    */
   approximateLineWidth?: number;
   /**
@@ -2651,12 +2678,12 @@ interface SerializeDocumentOptions extends SsrDocumentOptions {
   prettyHtml?: boolean;
   /**
    * Remove quotes from attribute values when possible.
-   * Defaults to `true`.
+   * Defaults to `false` (`true` when prerendering).
    */
   removeAttributeQuotes?: boolean;
   /**
    * Remove the `=""` from standardized `boolean` attributes,
-   * such as `hidden` or `checked`. Defaults to `true`.
+   * such as `hidden` or `checked`. Defaults to `false` (`true` when prerendering).
    */
   removeBooleanAttributeQuotes?: boolean;
   /**
@@ -2665,7 +2692,7 @@ interface SerializeDocumentOptions extends SsrDocumentOptions {
    */
   removeEmptyAttributes?: boolean;
   /**
-   * Remove HTML comments. Defaults to `true`.
+   * Remove HTML comments. Defaults to `false` (`true` when prerendering).
    */
   removeHtmlComments?: boolean;
   /**
@@ -2764,7 +2791,7 @@ interface CompilerSystem {
   name: 'node' | 'in-memory';
   version: string;
   events?: BuildEvents;
-  details?: SystemDetails;
+  details: SystemDetails;
   /**
    * Add a callback which will be ran when destroy() is called.
    */
@@ -2777,14 +2804,15 @@ interface CompilerSystem {
    * SYNC! Always returns a boolean, does not throw.
    */
   accessSync(p: string): boolean;
-  applyGlobalPatch?(fromDir: string): Promise<void>;
   applyPrerenderGlobalPatch?(opts: {
     devServerHostUrl: string;
     window: any;
   }): void;
-  cacheStorage?: CacheStorage;
-  checkVersion?: (logger: Logger, currentVersion: string) => Promise<() => void>;
-  copy?(copyTasks: Required<CopyTask>[], srcDir: string): Promise<CopyResults>;
+  /**
+   * Check npm for a newer Stencil version. Resolves a function that logs the result.
+   */
+  checkVersion(logger: Logger, currentVersion: string): Promise<() => void>;
+  copy(copyTasks: Required<CopyTask>[], srcDir: string): Promise<CopyResults>;
   /**
    * Always returns a boolean if the files were copied or not. Does not throw.
    */
@@ -2809,7 +2837,7 @@ interface CompilerSystem {
   /**
    * Each platform has a different way to dynamically import modules.
    */
-  dynamicImport?(p: string): Promise<any>;
+  dynamicImport(p: string): Promise<any>;
   /**
    * Creates the worker controller for the current system.
    *
@@ -2823,20 +2851,14 @@ interface CompilerSystem {
    * process.exit()
    */
   exit(exitCode: number): Promise<void>;
-  /**
-   * Optionally provide a fetch() function rather than using the built-in fetch().
-   * First arg is a url string or Request object (RequestInfo).
-   * Second arg is the RequestInit. Returns the Response object
-   */
-  fetch?(input: string | any, init?: any): Promise<any>;
   /**
    * Generates a sha1 digest encoded as HEX
    */
-  generateContentHash?(content: string | any, length?: number): Promise<string>;
+  generateContentHash(content: string | any, length?: number): Promise<string>;
   /**
    * Generates a sha1 digest encoded as HEX from a file path
    */
-  generateFileHash?(filePath: string | any, length?: number): Promise<string>;
+  generateFileHash(filePath: string | any, length?: number): Promise<string>;
   /**
    * Get the current directory.
    */
@@ -2845,7 +2867,6 @@ interface CompilerSystem {
    * The compiler's executing path.
    */
   getCompilerExecutingPath(): string;
-  getEnvironmentVar?(key: string): string;
   /**
    * Gets the absolute file path when for a dependency module.
    */
@@ -2884,11 +2905,7 @@ interface CompilerSystem {
    * Normalize file system path.
    */
   normalizePath(p: string): string;
-  onProcessInterrupt?(cb: () => void): void;
-  parseYarnLockFile?: (content: string) => {
-    type: 'success' | 'merge' | 'conflict';
-    object: any;
-  };
+  onProcessInterrupt(cb: () => void): void;
   platformPath: PlatformPath;
   /**
    * All return paths are full normalized paths, not just the basenames. Always returns an array, does not throw.
@@ -2924,6 +2941,9 @@ interface CompilerSystem {
    * Rename old path to new path. Does not throw.
    */
   rename(oldPath: string, newPath: string): Promise<CompilerSystemRenameResults>;
+  /**
+   * Assigned by the compiler. Used by plugins (e.g. `@stencil/sass`) to resolve `~` imports.
+   */
   resolveModuleId?(opts: ResolveModuleIdOptions): Promise<ResolveModuleIdResults>;
   resolvePath(p: string): string;
   /**
@@ -3117,6 +3137,7 @@ interface CompilerBuildResults {
   buildId: number;
   componentGraph?: BuildResultsComponentGraph;
   components: ComponentCompilerMeta[];
+  cssOnlyComponents: ComponentCompilerMeta[];
   diagnostics: Diagnostic$1[];
   dirsAdded: string[];
   dirsDeleted: string[];
@@ -3133,6 +3154,15 @@ interface CompilerBuildResults {
   namespace: string;
   fsNamespace: string;
   outputs: BuildOutput[];
+  /**
+   * Absolute paths to every global stylesheet, in cascade order: each `global-style` output
+   * target's compiled CSS in the order those targets are declared in `config.outputTargets` - or,
+   * with none configured, the generated `{fsNamespace}.css` holding Stencil's auto-placed CSS (when
+   * emitted). Unlike `outputs`, which groups files by type and sorts them alphabetically, this
+   * preserves author-intended order for consumers like the dev-server's auto-generated component
+   * preview.
+   */
+  globalStyleFiles: string[];
   rootDir: string;
   srcDir: string;
   timestamp: string;
@@ -3148,6 +3178,7 @@ interface HotModuleReplacement {
   componentsUpdated?: string[];
   excludeHmr?: string[];
   externalStylesUpdated?: string[];
+  globalStylesUpdated?: HmrGlobalStyleUpdate[];
   imagesUpdated?: string[];
   indexHtmlUpdated?: boolean;
   inlineStylesUpdated?: HmrStyleUpdate[];
@@ -3162,6 +3193,15 @@ interface HmrStyleUpdate {
   styleTag: string;
   styleText: string;
 }
+/**
+ * A live-reload update for a `global-style` output target's CSS. Applied on
+ * the client by matching `fileName` against the `<link>` that loads it and
+ * inserting/updating an adjacent `<style>` override
+ */
+interface HmrGlobalStyleUpdate {
+  fileName: string;
+  styleText: string;
+}
 type BuildOnEventRemove = () => boolean;
 interface BuildEvents extends BuildOnEvents, BuildEmitEvents {
   unsubscribeAll(): void;
@@ -3316,7 +3356,9 @@ interface CopyTask {
   /**
    * 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`.
+   * `.ds_store`, `.gitignore`, `desktop.ini`, `thumbs.db`. For a directory
+   * `src`, patterns match paths relative to that directory; an explicitly
+   * named `src` file is never ignored.
    */
   ignore?: string[];
   /**
@@ -3554,7 +3596,7 @@ interface OutputTargetCollection extends OutputTargetBaseNext {
    * When `true` this flag will transform aliased import paths defined in
    * a project's `tsconfig.json` to relative import paths in the compiled output.
    *
-   * Paths will be left in aliased format if `false` or `undefined`.
+   * Paths will be left in aliased format if `false`. Defaults to `true`.
    *
    * @example
    * // tsconfig.json
@@ -3656,11 +3698,11 @@ interface OutputTargetGlobalStyle extends OutputTargetBaseNext {
    * 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>`)
+   * - `'none'`: 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'
+   * @default 'client' when the stylesheet comes from `globalStyle` (or an auto-detected `src/global.*`), 'none' when `input` is set
    */
   inject?: 'none' | 'client' | 'all';
 }
@@ -3718,6 +3760,10 @@ interface OutputTargetSsr extends OutputTargetBase {
    */
   cjs?: boolean;
 }
+/**
+ * Compiles the SSR hydrate app to a WASM plugin (via `extism-js`/QuickJS-ng) that can run
+ * outside of Node
+ */
 interface OutputTargetSsrWasm extends OutputTargetBase {
   type: 'ssr-wasm';
   /** Output directory. @default 'dist/ssr-wasm' */
@@ -3828,9 +3874,11 @@ interface OutputTargetDocsCustomElementsManifest extends OutputTargetBase {
   type: 'docs-custom-elements-manifest';
   /**
    * The file path where the custom-elements.json manifest will be written.
-   * Defaults to 'custom-elements.json' in the root directory.
+   * Defaults to 'dist/custom-elements.json'.
+   *
+   * The `customElements` field of the project's `package.json` is set to this path.
    */
-  file: string;
+  file?: string;
   strict?: boolean;
 }
 interface OutputTargetDocsCustom extends OutputTargetBase {
@@ -3855,7 +3903,7 @@ interface OutputTargetDocsAgentSkill extends OutputTargetBase {
   /**
    * The skill's name, used in the `SKILL.md` frontmatter.
    *
-   * Defaults to a kebab-cased form of {@link Config.namespace}.
+   * Defaults to {@link Config.namespace}, lowercased, with anything other than letters and numbers replaced by `-`.
    */
   name?: string;
   /**
@@ -3918,10 +3966,8 @@ 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.
+   * When `true`, all `@stencil/core/*` module references are treated as external
+   * during bundling rather than being included in the generated output.
    *
    * @default false
    */
@@ -3985,8 +4031,10 @@ interface OutputTargetBase {
    * 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)
+   * - `loader-bundle`: `true` (skips the npm distribution files; the browser bundle always builds)
+   * - `standalone`: `true` if `loader-bundle` is also configured, otherwise `false`
+   * - `types`, `collection`, `ssr-wasm`: `true` (skips in dev)
+   * - `assets`, `global-style`: `false` (always runs)
    * - `ssr`: `true` (skips in dev, unless `devServer.ssr` is enabled)
    * - `docs-*`: `true` (skips in dev)
    * - `custom`: `true` (skips in dev)
@@ -4181,10 +4229,6 @@ interface Diagnostic$1 {
   relFilePath?: string | undefined;
   type: string;
 }
-interface CacheStorage {
-  get(key: string): Promise<any>;
-  set(key: string, value: any): Promise<void>;
-}
 interface WorkerOptions {
   maxConcurrentWorkers?: number;
   maxConcurrentTasksPerWorker?: number;
@@ -4446,13 +4490,19 @@ interface TranspileOptions {
    * that the specified flags take effect for this component at runtime.
    */
   buildOverrides?: BuildOverrides;
+  /**
+   * When `true`, a `.css`/`.scss` transpile also collects CSS custom-property docs
+   * onto {@link TranspileResults.styleDocs}. Off by default, since it costs an extra parse
+   * of the style text.
+   */
+  docs?: boolean;
 }
 /**
  * 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';
+type BuildOverrideKeys = 'isDev' | 'isTesting' | '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
@@ -4471,6 +4521,7 @@ interface TranspileResults {
   inputFilePath: string;
   map: any;
   outputFilePath: string;
+  styleDocs?: StyleDoc[];
 }
 interface TransformOptions {
   coreImportPath: string;
@@ -4514,8 +4565,35 @@ interface CliInitOptions {
   logger: Logger;
   sys: CompilerSystem;
 }
+/**
+ * A Stencil `resolveId`/`load`/`transform` plugin, as accepted by {@link StencilConfig.plugins}.
+ */
+interface Plugin$1 {
+  name?: string;
+  pluginType?: string;
+  load?: (id: string, context: PluginCtx) => Promise<string> | string;
+  resolveId?: (importee: string, importer: string, context: PluginCtx) => Promise<string> | string;
+  transform?: (sourceText: string, id: string, context: PluginCtx) => Promise<PluginTransformResults> | PluginTransformResults;
+}
+type PluginTransformResults = PluginTransformationDescriptor | string | null;
+interface PluginTransformationDescriptor {
+  code?: string;
+  map?: string;
+  id?: string;
+  diagnostics?: Diagnostic$1[];
+  dependencies?: string[];
+}
+interface PluginCtx {
+  config: Config;
+  sys: CompilerSystem;
+  fs: InMemoryFileSystem;
+  cache: Cache;
+  diagnostics: Diagnostic$1[];
+}
 //#endregion
 //#region src/declarations/stencil-private.d.ts
+/** Build-time virtual `@import`s a `global-style` input can use to place Stencil-generated CSS. */
+type StencilVirtualImport = 'stencil-hydrate' | 'stencil-component-globals' | 'stencil-css-components';
 interface SourceMap$1 {
   file: string;
   mappings: string;
@@ -4654,6 +4732,7 @@ interface BuildCtx {
   esmComponentBundle: ReadonlyArray<BundleModule>;
   commonJsComponentBundle: ReadonlyArray<BundleModule>;
   components: ComponentCompilerMeta[];
+  cssOnlyComponents: ComponentCompilerMeta[];
   componentGraph: Map<string, string[]>;
   config: ValidatedConfig;
   createTimeSpan(msg: string, debug?: boolean): LoggerTimeSpan;
@@ -4702,6 +4781,9 @@ interface BuildCtx {
    */
   stylesPromise: Promise<string>;
   stylesUpdated: BuildStyleUpdate[];
+  globalStylesUpdated: BuildGlobalStyleLinkUpdate[];
+  /** Absolute path of the generated `{fsNamespace}.css`, when this build emitted one */
+  stencilCssFile?: string;
   timeSpan: LoggerTimeSpan;
   timestamp: string;
   transpileBuildCount: number;
@@ -4714,6 +4796,14 @@ interface BuildStyleUpdate {
   styleText: string;
   styleMode: string;
 }
+/**
+ * A live-reload update for a `global-style` output target's CSS, matched on
+ * the client by `fileName` against the `<link>`
+ */
+interface BuildGlobalStyleLinkUpdate {
+  fileName: string;
+  styleText: string;
+}
 type BuildTask = any;
 interface CompilerBuildStats {
   timestamp: string;
@@ -4855,6 +4945,12 @@ interface CompilerCtx {
   cssModuleImports: Map<string, string[]>;
   /** Cache of built global styles, keyed by input file path */
   globalStyleCache: Map<string, string>;
+  /** Cache of discovered CSS-only components from the last scan, keyed by absolute .css file path */
+  cssOnlyComponentsCache: Map<string, ComponentCompilerMeta[]>;
+  /** Contents of the last auto-placed `stencil-*` CSS, used to detect changes for HMR */
+  stencilCss?: string;
+  /** Virtual imports found in each built global style (post-preprocessing), keyed by input path */
+  globalStyleVirtualImports: Map<string, Set<StencilVirtualImport>>;
   collections: CollectionCompilerMeta[];
   compilerOptions: any;
   events: BuildEvents;
@@ -5000,7 +5096,7 @@ interface ComponentCompilerMeta extends ComponentCompilerFeatures {
    * Custom states to initialize on the ElementInternals.states CustomStateSet.
    * These are defined via @AttachInternals({ states: {...} }).
    */
-  attachInternalsCustomStates: ComponentCompilerCustomState[];
+  attachInternalsCustomStates: JsonDocsCustomState[];
   componentClassName: string;
   /**
    * A list of web component tag names that are either:
@@ -5070,7 +5166,7 @@ interface ComponentCompilerMeta extends ComponentCompilerFeatures {
   sourceFilePath: string;
   sourceMapPath: string;
   states: ComponentCompilerState[];
-  styleDocs: CompilerStyleDoc[];
+  styleDocs: StyleDoc[];
   styles: StyleCompiler[];
   globalStyles: ComponentGlobalStyle[];
   tagName: string;
@@ -5273,20 +5369,6 @@ interface ComponentCompilerState {
  * Custom states are exposed via the ElementInternals.states CustomStateSet
  * and can be targeted with the CSS :state() pseudo-class.
  */
-interface ComponentCompilerCustomState {
-  /**
-   * The name of the custom state (without dashes)
-   */
-  name: string;
-  /**
-   * The initial value of the state
-   */
-  initialValue: boolean;
-  /**
-   * Optional JSDoc description for the state
-   */
-  docs: string;
-}
 /**
  * Representation of JSDoc that is pulled off a node in the AST
  */
@@ -5298,44 +5380,7 @@ interface CompilerJsDoc {
   /**
    * Tags included in the JSDoc
    */
-  tags: CompilerJsDocTagInfo[];
-}
-/**
- * Representation of a tag that exists in a JSDoc
- */
-interface CompilerJsDocTagInfo {
-  /**
-   * The name of the tag - e.g. `@deprecated`
-   */
-  name: string;
-  /**
-   * Additional text that is associated with the tag - e.g. `@deprecated use v2 of this API`
-   */
-  text?: string;
-}
-/**
- * The (internal) representation of a CSS block comment in a CSS, Sass, etc. file. This data structure is used during
- * the initial compilation phases of Stencil, as a piece of {@link ComponentCompilerMeta}.
- */
-interface CompilerStyleDoc {
-  /**
-   * The name of the CSS property
-   */
-  name: string;
-  /**
-   * The user-defined description of the CSS property
-   */
-  docs: string;
-  /**
-   * The JSDoc-style annotation (e.g. `@prop`) that was used in the block comment to detect the comment.
-   * Used to inform Stencil where the start of a new property's description starts (and where the previous description
-   * ends).
-   */
-  annotation: 'prop';
-  /**
-   * The Stencil style-mode that is associated with this property.
-   */
-  mode: string;
+  tags: JsonDocsTag[];
 }
 interface CompilerAssetDir {
   absolutePath?: string;
@@ -5556,28 +5601,6 @@ interface Module {
   hasVdomXlink: boolean;
   hasSignalsImport: boolean;
 }
-interface Plugin$1 {
-  name?: string;
-  pluginType?: string;
-  load?: (id: string, context: PluginCtx) => Promise<string> | string;
-  resolveId?: (importee: string, importer: string, context: PluginCtx) => Promise<string> | string;
-  transform?: (sourceText: string, id: string, context: PluginCtx) => Promise<PluginTransformResults> | PluginTransformResults;
-}
-type PluginTransformResults = PluginTransformationDescriptor | string | null;
-interface PluginTransformationDescriptor {
-  code?: string;
-  map?: string;
-  id?: string;
-  diagnostics?: Diagnostic$1[];
-  dependencies?: string[];
-}
-interface PluginCtx {
-  config: Config;
-  sys: CompilerSystem;
-  fs: InMemoryFileSystem;
-  cache: Cache;
-  diagnostics: Diagnostic$1[];
-}
 interface PrerenderUrlResults {
   anchorUrls: string[];
   diagnostics: Diagnostic$1[];
@@ -6182,4 +6205,4 @@ type MsgToWorker<T extends WorkerContextMethod> = IPCSerializable<{
  */
 type WorkerMsgHandler = <T extends WorkerContextMethod>(msgToWorker: MsgToWorker<T>) => ReturnType<CompilerWorkerContext[T]>;
 //#endregion
-export { CompilerSystemRemoveDirectoryResults as $, HOST_FLAGS as $i, JsonDocMethodParameter as $n, isOutputTargetDocsCustom as $r, OutputTargetDocsReadme as $t, CompilerDependency as A, isRolldownError as Ai, StencilDevServerConfig as An, isTsFile as Ar, LogLevel as At, CompilerEventFsChange as B, COPY as Bi, WatcherCloseResults as Bn, FilterComponentsResult as Br, OutputTarget as Bt, CacheStorage as C, escapeHtml as Ci, SerializeDocumentOptions as Cn, createJsVarName as Cr, HydrateFactoryOptions as Ct, Compiler as D, loadTypeScriptDiagnostic as Di, SsrDocumentOptions as Dn, isDtsFile as Dr, LightDomPatches as Dt, CompileTarget as E, augmentDiagnosticWithNode as Ei, SitemapXmpResults as En, hasDependency as Er, LazyRequire as Et, CompilerEventDirAdd as F, ASSETS as Fi, TranspileOptions as Fn, getInlineSourceMappingUrlLinker as Fr, NodeResolveConfig as Ft, CompilerFsStats as G, DOCS_CUSTOM as Gi, FunctionalComponent as Gn, getComponentsFromModules as Gr, OutputTargetCollection as Gt, CompilerFileWatcher as H, DEFAULT_STYLE_MODE as Hi, WorkerOptions as Hn, filterExcludedComponents as Hr, OutputTargetBase as Ht, CompilerEventDirDelete as I, CMP_FLAGS as Ii, TranspileResults as In, getSourceMappingUrlForEndOfFile as Ir, OptimizeCssInput as It, CompilerSystem as J, DOCS_README as Ji, ReactiveControllerHostInterface as Jn, isOutputTargetCopy as Jr, OutputTargetDistLazy as Jt, CompilerRequest as K, DOCS_CUSTOM_ELEMENTS_MANIFEST as Ki, MixedInCtor as Kn, isOutputTargetAssets as Kr, OutputTargetCopy as Kt, CompilerEventFileAdd as L, COLLECTION as Li, UnvalidatedConfig as Ln, getSourceMappingUrlLinker as Lr, OptimizeCssOutput as Lt, CompilerEventBuildLog as M, formatComponentRuntimeMeta as Mi, SystemDetails as Mn, parsePackageJson as Mr, LoggerLineUpdater as Mt, CompilerEventBuildNoChange as N, formatLazyBundleRuntimeMeta as Ni, TransformOptions as Nn, readOnlyArrayHasStringMember as Nr, LoggerTimeSpan as Nt, CompilerBuildResults as O, loadTypeScriptDiagnostics as Oi, SsrFactoryOptions as On, isJsFile as Or, LoadConfigInit as Ot, CompilerEventBuildStart as P, stringifyRuntimeData as Pi, TranspileOnlyResults as Pn, readPackageJson as Pr, ModeConfig as Pt, CompilerSystemRemoveDirectoryOptions as Q, GLOBAL_STYLE as Qi, VNode as Qn, isOutputTargetDocsAgentSkill as Qr, OutputTargetDocsJson as Qt, CompilerEventFileDelete as R, COLLECTION_APP_DATA_FILE_NAME as Ri, ValidatedConfig as Rn, rolldownToStencilSourceMap as Rr, OptimizeJsInput as Rt, BuildResultsComponentGraph as S, shouldIgnoreError as Si, RolldownConfig as Sn, addDocBlock as Sr, HydrateDocumentOptions as St, CompileScriptMinifyOptions as T, splitLineBreaks as Ti, SitemapXmpOpts as Tn, getTextDocs as Tr, LOG_LEVELS as Tt, CompilerFileWatcherCallback as U, DIST_LAZY as Ui, ComponentInterface as Un, getComponentsDtsSrcFilePath as Ur, OutputTargetBaseNext as Ut, CompilerEventName as V, CUSTOM as Vi, WorkerMainController as Vn, filterActiveTargets as Vr, OutputTargetAssets as Vt, CompilerFileWatcherEvent as W, DOCS_AGENT_SKILL as Wi, ErrorHandler as Wn, getComponentsDtsTypesFilePath as Wr, OutputTargetBuild as Wt, CompilerSystemCreateDirectoryResults as X, EVENT_FLAGS as Xi, TagTransformer as Xn, isOutputTargetDistLazy as Xr, OutputTargetDocsCustom as Xt, CompilerSystemCreateDirectoryOptions as Y, DOCS_VSCODE as Yi, ResolutionHandler as Yn, isOutputTargetCustom as Yr, OutputTargetDocsAgentSkill as Yt, CompilerSystemRealpathResults as Z, GENERATED_DTS as Zi, UserBuildConditionals as Zn, isOutputTargetDocs as Zr, OutputTargetDocsCustomElementsManifest as Zt, BuildNoChangeResults as _, buildJsonFileError as _i, ResolveModuleIdOptions as _n, FsWriteResults as _r, DocsReadmeCustomColumn as _t, HostElement as a, SSR as aa, isOutputTargetLoaderBundle as ai, OutputTargetStandalone as an, JsonDocsListener as ar, Config as at, BuildOutput as b, hasError as bi, RobotsTxtOpts as bn, validateComponentTag as br, HmrStyleUpdate as bt, PrintLine as c, STATS as ca, isOutputTargetStandalone as ci, OutputTargetWww as cn, JsonDocsPart as cr, CopyResults as ct, SsrResults as d, TYPES as da, isOutputTargetWww as di, PlatformPath as dn, JsonDocsStyle as dr, CustomElementsExportBehavior as dt, HTML_NS as ea, isOutputTargetDocsCustomElementsManifest as ei, OutputTargetDocsVscode as en, JsonDocs as er, CompilerSystemRemoveFileResults as et, WorkerMsgHandler as f, VALID_CONFIG_OUTPUT_TARGETS as fa, isValidConfigOutputTarget as fi, PrerenderConfig as fn, JsonDocsTag as fr, CustomElementsExportBehaviorOptions as ft, BuildLog as g, buildError as gi, PrerenderStartOptions as gn, StyleDoc as gr, Diagnostic$1 as gt, BuildEvents as h, XLINK_NS as ha, TASK_CANCELED_MSG as hi, PrerenderResults as hn, JsonDocsValue as hr, DevServerEditor as ht, ComponentCompilerTypeReferences as i, NODE_TYPES as ia, isOutputTargetGlobalStyle as ii, OutputTargetSsrWasm as in, JsonDocsEvent as ir, CompilerWatcher as it, CompilerEventBuildFinish as j, loadRolldownDiagnostics as ji, StencilDocsConfig as jn, isTsxFile as jr, Logger as jt, CompilerBuildStart as k, createOnWarnFn as ki, StencilConfig as kn, isJsxFile as kr, LoadConfigResults as kt, PropsType as l, STYLE_EXT as la, isOutputTargetStats as li, PageReloadStrategy as ln, JsonDocsProp as lr, CopyTask as lt, BuildEmitEvents as m, WWW as ma, shouldExcludeComponent as mi, PrerenderOptions as mn, JsonDocsUsage as mr, DevServerConfig as mt, CompilerWorkerContext as n, LOADER_BUNDLE as na, isOutputTargetDocsReadme as ni, OutputTargetLoaderBundle as nn, JsonDocsCustomState as nr, CompilerSystemRenamedPath as nt, LazyBundlesRuntimeData as o, SSR_WASM as oa, isOutputTargetSsr as oi, OutputTargetStats as on, JsonDocsMethod as or, ConfigBundle as ot, AutoprefixerOptions as p, WATCH_FLAGS as pa, relativeImport as pi, PrerenderHydrateOptions as pn, JsonDocsTypeLibrary as pr, DevServer as pt, CompilerRequestResponse as q, DOCS_JSON as qi, RafCallback as qn, isOutputTargetCollection as qr, OutputTargetCustom as qt, ComponentCompilerMeta as r, MEMBER_FLAGS as ra, isOutputTargetDocsVscode as ri, OutputTargetSsr as rn, JsonDocsDependencyGraph as rr, CompilerSystemWriteFileResults as rt, PackageJsonData as s, STANDALONE as sa, isOutputTargetSsrWasm as si, OutputTargetTypes as sn, JsonDocsMethodReturn as sr, ConfigCompat as st, ChildType as t, LISTENER_FLAGS as ta, isOutputTargetDocsJson as ti, OutputTargetGlobalStyle as tn, JsonDocsComponent as tr, CompilerSystemRenameResults as tt, RuntimeRef as u, SVG_NS as ua, isOutputTargetTypes as ui, ParsedPath as un, JsonDocsSlot as ur, Credentials as ut, BuildOnEventRemove as v, buildWarn as vi, ResolveModuleIdResults as vn, ModeValidationError as vr, FsWatchResults as vt, CliInitOptions as w, normalizeDiagnostics as wi, ServiceWorkerConfig as wn, generatePreamble as wr, HydratedFlag as wt, BuildOverrides as x, hasWarning as xi, RobotsTxtResults as xn, ParsePackageJsonResult as xr, HotModuleReplacement as xt, BuildOnEvents as y, catchError as yi, ResolveModuleOptions as yn, validateComponentModes as yr, HistoryApiFallback as yt, CompilerEventFileUpdate as z, COLLECTION_MANIFEST_FILE_NAME as zi, ValidatedOutputTargetWww as zn, result_d_exports as zr, OptimizeJsOutput as zt };
+export { CompilerFsStats as $, CUSTOM as $i, WorkerMainController as $n, filterActiveTargets as $r, OutputTargetBuild as $t, BuildOverrides as A, buildWarn as Ai, ResolveModuleIdResults as An, ModeValidationError as Ar, HotModuleReplacement as At, CompilerEventBuildLog as B, loadTypeScriptDiagnostics as Bi, SsrFactoryOptions as Bn, isJsFile as Br, Logger as Bt, BuildEmitEvents as C, TYPES as Ca, isOutputTargetWww as Ci, PluginTransformResults as Cn, JsonDocsStyle as Cr, DevServerEditor as Ct, BuildOnEventRemove as D, XLINK_NS as Da, TASK_CANCELED_MSG as Di, PrerenderResults as Dn, JsonDocsValue as Dr, HistoryApiFallback as Dt, BuildNoChangeResults as E, WWW as Ea, shouldExcludeComponent as Ei, PrerenderOptions as En, JsonDocsUsage as Er, FsWatchResults as Et, Compiler as F, escapeHtml as Fi, SerializeDocumentOptions as Fn, createJsVarName as Fr, LazyRequire as Ft, CompilerEventFileAdd as G, formatLazyBundleRuntimeMeta as Gi, TransformOptions as Gn, readOnlyArrayHasStringMember as Gr, OptimizeCssInput as Gt, CompilerEventBuildStart as H, isRolldownError as Hi, StencilDevServerConfig as Hn, isTsFile as Hr, LoggerTimeSpan as Ht, CompilerBuildResults as I, normalizeDiagnostics as Ii, ServiceWorkerConfig as In, generatePreamble as Ir, LightDomPatches as It, CompilerEventFsChange as J, CMP_FLAGS as Ji, TranspileResults as Jn, getSourceMappingUrlForEndOfFile as Jr, OptimizeJsOutput as Jt, CompilerEventFileDelete as K, stringifyRuntimeData as Ki, TranspileOnlyResults as Kn, readPackageJson as Kr, OptimizeCssOutput as Kt, CompilerBuildStart as L, splitLineBreaks as Li, SitemapXmpOpts as Ln, getTextDocs as Lr, LoadConfigInit as Lt, CliInitOptions as M, hasError as Mi, RobotsTxtOpts as Mn, validateComponentTag as Mr, HydrateFactoryOptions as Mt, CompileScriptMinifyOptions as N, hasWarning as Ni, RobotsTxtResults as Nn, ParsePackageJsonResult as Nr, HydratedFlag as Nt, BuildOnEvents as O, buildError as Oi, PrerenderStartOptions as On, StyleDoc as Or, HmrGlobalStyleUpdate as Ot, CompileTarget as P, shouldIgnoreError as Pi, RolldownConfig as Pn, addDocBlock as Pr, LOG_LEVELS as Pt, CompilerFileWatcherEvent as Q, COPY as Qi, WatcherCloseResults as Qn, FilterComponentsResult as Qr, OutputTargetBaseNext as Qt, CompilerDependency as R, augmentDiagnosticWithNode as Ri, SitemapXmpResults as Rn, hasDependency as Rr, LoadConfigResults as Rt, AutoprefixerOptions as S, SVG_NS as Sa, isOutputTargetTypes as Si, PluginCtx as Sn, JsonDocsSlot as Sr, DevServerConfig as St, BuildLog as T, WATCH_FLAGS as Ta, relativeImport as Ti, PrerenderHydrateOptions as Tn, JsonDocsTypeLibrary as Tr, DocsReadmeCustomColumn as Tt, CompilerEventDirAdd as U, loadRolldownDiagnostics as Ui, StencilDocsConfig as Un, isTsxFile as Ur, ModeConfig as Ut, CompilerEventBuildNoChange as V, createOnWarnFn as Vi, StencilConfig as Vn, isJsxFile as Vr, LoggerLineUpdater as Vt, CompilerEventDirDelete as W, formatComponentRuntimeMeta as Wi, SystemDetails as Wn, parsePackageJson as Wr, NodeResolveConfig as Wt, CompilerFileWatcher as X, COLLECTION_APP_DATA_FILE_NAME as Xi, ValidatedConfig as Xn, rolldownToStencilSourceMap as Xr, OutputTargetAssets as Xt, CompilerEventName as Y, COLLECTION as Yi, UnvalidatedConfig as Yn, getSourceMappingUrlLinker as Yr, OutputTarget as Yt, CompilerFileWatcherCallback as Z, COLLECTION_MANIFEST_FILE_NAME as Zi, ValidatedOutputTargetWww as Zn, result_d_exports as Zr, OutputTargetBase as Zt, PrintLine as _, SSR as _a, isOutputTargetLoaderBundle as _i, OutputTargetWww as _n, JsonDocsListener as _r, CopyTask as _t, ComponentCompilerEvent as a, DOCS_JSON as aa, isOutputTargetCollection as ai, OutputTargetDocsCustom as an, RafCallback as ar, CompilerSystemRealpathResults as at, SsrResults as b, STATS as ba, isOutputTargetStandalone as bi, PlatformPath as bn, JsonDocsPart as br, CustomElementsExportBehaviorOptions as bt, ComponentCompilerMethod as c, EVENT_FLAGS as ca, isOutputTargetDistLazy as ci, OutputTargetDocsReadme as cn, TagTransformer as cr, CompilerSystemRemoveFileResults as ct, ComponentCompilerTypeReferences as d, HOST_FLAGS as da, isOutputTargetDocsCustom as di, OutputTargetLoaderBundle as dn, JsonDocMethodParameter as dr, CompilerSystemWriteFileResults as dt, DEFAULT_STYLE_MODE as ea, filterExcludedComponents as ei, OutputTargetCollection as en, WorkerOptions as er, CompilerRequest as et, ComponentGlobalStyle as f, HTML_NS as fa, isOutputTargetDocsCustomElementsManifest as fi, OutputTargetSsr as fn, JsonDocs as fr, CompilerWatcher as ft, PrerenderUrlResults as g, NODE_TYPES as ga, isOutputTargetGlobalStyle as gi, OutputTargetTypes as gn, JsonDocsEvent as gr, CopyResults as gt, PackageJsonData as h, MEMBER_FLAGS as ha, isOutputTargetDocsVscode as hi, OutputTargetStats as hn, JsonDocsDependencyGraph as hr, ConfigCompat as ht, CompilerWorkerContext as i, DOCS_CUSTOM_ELEMENTS_MANIFEST as ia, isOutputTargetAssets as ii, OutputTargetDocsAgentSkill as in, MixedInCtor as ir, CompilerSystemCreateDirectoryResults as it, BuildResultsComponentGraph as j, catchError as ji, ResolveModuleOptions as jn, validateComponentModes as jr, HydrateDocumentOptions as jt, BuildOutput as k, buildJsonFileError as ki, ResolveModuleIdOptions as kn, FsWriteResults as kr, HmrStyleUpdate as kt, ComponentCompilerProperty as l, GENERATED_DTS as la, isOutputTargetDocs as li, OutputTargetDocsVscode as ln, UserBuildConditionals as lr, CompilerSystemRenameResults as lt, LazyBundlesRuntimeData as m, LOADER_BUNDLE as ma, isOutputTargetDocsReadme as mi, OutputTargetStandalone as mn, JsonDocsCustomState as mr, ConfigBundle as mt, ChildType as n, DOCS_AGENT_SKILL as na, getComponentsDtsTypesFilePath as ni, OutputTargetCustom as nn, ErrorHandler as nr, CompilerSystem as nt, ComponentCompilerListener as o, DOCS_README as oa, isOutputTargetCopy as oi, OutputTargetDocsCustomElementsManifest as on, ReactiveControllerHostInterface as or, CompilerSystemRemoveDirectoryOptions as ot, HostElement as p, LISTENER_FLAGS as pa, isOutputTargetDocsJson as pi, OutputTargetSsrWasm as pn, JsonDocsComponent as pr, Config as pt, CompilerEventFileUpdate as q, ASSETS as qi, TranspileOptions as qn, getInlineSourceMappingUrlLinker as qr, OptimizeJsInput as qt, CompilerCtx as r, DOCS_CUSTOM as ra, getComponentsFromModules as ri, OutputTargetDistLazy as rn, FunctionalComponent as rr, CompilerSystemCreateDirectoryOptions as rt, ComponentCompilerMeta as s, DOCS_VSCODE as sa, isOutputTargetCustom as si, OutputTargetDocsJson as sn, ResolutionHandler as sr, CompilerSystemRemoveDirectoryResults as st, BuildCtx as t, DIST_LAZY as ta, getComponentsDtsSrcFilePath as ti, OutputTargetCopy as tn, ComponentInterface as tr, CompilerRequestResponse as tt, ComponentCompilerState as u, GLOBAL_STYLE as ua, isOutputTargetDocsAgentSkill as ui, OutputTargetGlobalStyle as un, VNode as ur, CompilerSystemRenamedPath as ut, PropsType as v, SSR_WASM as va, isOutputTargetSsr as vi, PageReloadStrategy as vn, JsonDocsMethod as vr, Credentials as vt, BuildEvents as w, VALID_CONFIG_OUTPUT_TARGETS as wa, isValidConfigOutputTarget as wi, PrerenderConfig as wn, JsonDocsTag as wr, Diagnostic$1 as wt, WorkerMsgHandler as x, STYLE_EXT as xa, isOutputTargetStats as xi, Plugin$1 as xn, JsonDocsProp as xr, DevServer as xt, RuntimeRef as y, STANDALONE as ya, isOutputTargetSsrWasm as yi, ParsedPath as yn, JsonDocsMethodReturn as yr, CustomElementsExportBehavior as yt, CompilerEventBuildFinish as z, loadTypeScriptDiagnostic as zi, SsrDocumentOptions as zn, isDtsFile as zr, LogLevel as zt };

package/dist/index.d.mts

@@ -14,6 +14,7 @@ export type {
   ComponentShouldUpdateChanges,
   ComponentWillLoad,
   ComponentWillUpdate,
+  ErrorHandler,
   EventEmitter,
   EventOptions,
   FunctionalComponent,
@@ -28,6 +29,8 @@ export type {
   RafCallback,
   ReactiveController,
   ReactiveControllerHostInterface,
+  ResolutionHandler,
+  TagTransformer,
   VNode,
   VNodeData,
 } from './declarations/stencil-public-runtime';

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { C as setErrorHandler, _ as getAssetPath, a as transformTag, b as writeTask, c as Mixin, d as Host, f as h, g as getShadowRoot, h as getElement, i as setTagTransformer, l as getMode, m as getRenderingRef, o as render, p as forceUpdate, s as ReactiveControllerHost, u as setMode, v as setAssetPath, w as Build, x as setPlatformHelpers, y as readTask } from "./client-BRu0GtRn.mjs";
+import { C as Build, S as setErrorHandler, _ as getAssetPath, a as transformTag, b as writeTask, c as Mixin, d as Host, f as h, g as getShadowRoot, h as getElement, i as setTagTransformer, l as getMode, m as getRenderingRef, o as render, p as forceUpdate, s as ReactiveControllerHost, u as setMode, v as setAssetPath, x as setPlatformHelpers, y as readTask } from "./client-BYvfR_Hx.mjs";
 import { t as Fragment } from "./fragment-Di1hWOC8.mjs";
 //#region src/client/client-decorators.ts
 /**

package/dist/jsx-runtime.d.mts

@@ -15,4 +15,10 @@ export namespace JSX {
   };
 
   export type Element = VNode;
+
+  // Functional components receive children as their 2nd argument, never via props
+  export interface IntrinsicAttributes {
+    key?: string | number;
+    children?: any;
+  }
 }