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

package/dist/{compiler-CdUbDTbV.mjs → compiler-BmT_yLHU.mjs}

@@ -1,8 +1,8 @@
 import { n as __require } from "./chunk-z9aeyW2b.mjs";
-import { D as HYDRATED_CSS, p as scopeCss } from "./client-fWOou5EW.mjs";
-import { $ as WATCH_FLAGS, A as DIST_LAZY, C as ASSETS, D as COPY, E as COLLECTION_MANIFEST_FILE_NAME, I as EVENT_FLAGS, J as STATS, L as GENERATED_DTS, N as DOCS_JSON, P as DOCS_README, Q as VALID_CONFIG_OUTPUT_TARGETS, R as GLOBAL_STYLE, T as COLLECTION_APP_DATA_FILE_NAME, Y as STENCIL_REBUNDLE, Z as TYPES, _ as sortBy, a as fromEntries, b as toTitleCase, d as isNumber$1, f as isObject, h as noop, i as flatOne, l as isFunction, m as mergeIntoWith, n as dashToPascalCase, o as isBoolean$1, p as isString$1, q as STANDALONE, u as isIterable, x as unique, y as toDashCase } from "./regular-expression-DUdhF3Ei.mjs";
-import { $ as loadTypeScriptDiagnostics, A as isOutputTargetCollection, B as isOutputTargetGlobalStyle, Ct as formatComponentRuntimeMeta, E as getComponentsDtsSrcFilePath, Et as byteSize, F as isOutputTargetDocsCustom, G as isOutputTargetStats, H as isOutputTargetSsr, I as isOutputTargetDocsCustomElementsManifest, J as isValidConfigOutputTarget, K as isOutputTargetTypes, L as isOutputTargetDocsJson, M as isOutputTargetCustom, N as isOutputTargetDistLazy, O as getComponentsFromModules, P as isOutputTargetDocs, Q as loadTypeScriptDiagnostic, R as isOutputTargetDocsReadme, S as ok, St as isGlob, T as filterExcludedComponents, Tt as stringifyRuntimeData, U as isOutputTargetSsrWasm, V as isOutputTargetLoaderBundle, W as isOutputTargetStandalone, Y as relativeImport, Z as augmentDiagnosticWithNode, _ as getSourceMappingUrlForEndOfFile, _t as catchError, a as getTextDocs, at as relative$1, b as err, ct as isRolldownError, d as isTsxFile, dt as normalizeDiagnostics, et as join$2, f as parsePackageJson, ft as splitLineBreaks, g as getInlineSourceMappingUrlLinker, gt as buildWarn, h as isRemoteUrl, ht as buildJsonFileError, i as generatePreamble, it as normalizePath, j as isOutputTargetCopy, k as isOutputTargetAssets, lt as loadRolldownDiagnostics, m as readPackageJson, mt as buildError, n as addDocBlock, nt as normalizeFsPath, o as hasDependency, ot as resolve$2, p as readOnlyArrayHasStringMember, q as isOutputTargetWww, r as createJsVarName, rt as normalizeFsPathQuery, s as isDtsFile, st as createOnWarnFn, t as validateComponentTag, u as isTsFile, vt as hasError, w as filterActiveTargets, x as map, xt as isRootPath, y as rolldownToStencilSourceMap, yt as hasWarning, z as isOutputTargetDocsVscode } from "./validation-2QipI30K.mjs";
-import { i as CustomElementsExportBehaviorOptions, o as buildEvents, r as createNodeLogger, t as createNodeSys } from "./node-klLZLdDe.mjs";
+import { D as HYDRATED_CSS, p as scopeCss } from "./client-Dd-NB5Ei.mjs";
+import { $ as VALID_CONFIG_OUTPUT_TARGETS, C as ASSETS, D as COLLECTION_MANIFEST_FILE_NAME, E as COLLECTION_APP_DATA_FILE_NAME, F as DOCS_README, J as STANDALONE, L as EVENT_FLAGS, O as COPY, P as DOCS_JSON, Q as TYPES, R as GENERATED_DTS, T as COLLECTION, U as LOADER_BUNDLE, X as STYLE_EXT, Y as STATS, _ as sortBy, a as fromEntries, b as toTitleCase, d as isNumber$1, et as WATCH_FLAGS, f as isObject, h as noop, i as flatOne, j as DIST_LAZY, l as isFunction, m as mergeIntoWith, n as dashToPascalCase, o as isBoolean$1, p as isString$1, u as isIterable, x as unique, y as toDashCase, z as GLOBAL_STYLE } from "./regular-expression-CFVJOTUh.mjs";
+import { $ as loadTypeScriptDiagnostics, A as isOutputTargetCollection, B as isOutputTargetGlobalStyle, Ct as formatComponentRuntimeMeta, E as getComponentsDtsSrcFilePath, Et as byteSize, F as isOutputTargetDocsCustom, G as isOutputTargetStats, H as isOutputTargetSsr, I as isOutputTargetDocsCustomElementsManifest, J as isValidConfigOutputTarget, K as isOutputTargetTypes, L as isOutputTargetDocsJson, M as isOutputTargetCustom, N as isOutputTargetDistLazy, O as getComponentsFromModules, P as isOutputTargetDocs, Q as loadTypeScriptDiagnostic, R as isOutputTargetDocsReadme, S as ok, St as isGlob, T as filterExcludedComponents, Tt as stringifyRuntimeData, U as isOutputTargetSsrWasm, V as isOutputTargetLoaderBundle, W as isOutputTargetStandalone, Y as relativeImport, Z as augmentDiagnosticWithNode, _ as getSourceMappingUrlForEndOfFile, _t as catchError, a as getTextDocs, at as relative$1, b as err, ct as isRolldownError, d as isTsxFile, dt as normalizeDiagnostics, et as join$2, f as parsePackageJson, ft as splitLineBreaks, g as getInlineSourceMappingUrlLinker, gt as buildWarn, h as isRemoteUrl, ht as buildJsonFileError, i as generatePreamble, it as normalizePath, j as isOutputTargetCopy, k as isOutputTargetAssets, lt as loadRolldownDiagnostics, m as readPackageJson, mt as buildError, n as addDocBlock, nt as normalizeFsPath, o as hasDependency, ot as resolve$2, p as readOnlyArrayHasStringMember, q as isOutputTargetWww, r as createJsVarName, rt as normalizeFsPathQuery, s as isDtsFile, st as createOnWarnFn, t as validateComponentTag, u as isTsFile, vt as hasError, w as filterActiveTargets, x as map, xt as isRootPath, y as rolldownToStencilSourceMap, yt as hasWarning, z as isOutputTargetDocsVscode } from "./validation-ByxKj8bC.mjs";
+import { i as CustomElementsExportBehaviorOptions, o as buildEvents, r as createNodeLogger, t as createNodeSys } from "./node-10UamZmn.mjs";
 import ts, { default as ts$1 } from "typescript";
 import { readFileSync } from "node:fs";
 import { basename, dirname, isAbsolute, join, resolve } from "node:path";
@@ -28,8 +28,8 @@ import { createJiti } from "jiti";
 import * as process$1 from "process";
 import { dataToEsm } from "@rollup/pluginutils";
 //#region src/version.ts
-const version = "5.0.0-alpha.6";
-const buildId = "1779811269";
+const version = "5.0.0-alpha.7";
+const buildId = "1780784182";
 const vermoji = "❓";
 /**
 * Get the installed version of a tool/dependency.
@@ -484,7 +484,7 @@ const getModuleImports = (moduleMap, filePath, importedModules) => {
 	return importedModules;
 };
 /**
-* Config-driven extras flags that a collection lib author may have set explicitly.
+* Config-driven flags that a collection lib author may have set explicitly.
 * These are the only flags propagated from a collection's buildFlags into the consumer's
 * build - everything else is a component-derived flag that the consumer recomputes itself
 * by scanning all components (including those from the collection).
@@ -503,7 +503,7 @@ const COLLECTION_CONFIG_FLAGS = new Set([
 ]);
 /**
 * Merge config-driven build flags from consumed collections into the active build conditionals.
-* Only flags explicitly set via the lib author's stencil.config extras are merged - component-
+* Only flags explicitly set via the lib author's stencil.config are merged - component-
 * derived flags are excluded because the consumer recomputes them from source.
 *
 * **This function mutates the build conditionals argument**
@@ -537,7 +537,7 @@ const updateBuildConditionals = (config, b) => {
 	b.constructableCSS = !b.hotModuleReplacement || !!config._isTesting;
 	b.asyncLoading = !!(b.asyncLoading || b.lazyLoad || b.taskQueue || b.initializeNextTick);
 	b.cssAnnotations = true;
-	const ldp = config.extras.lightDomPatches ?? true;
+	const ldp = config.compat.lightDomPatches ?? true;
 	if (b.slotRelocation && ldp !== false) {
 		b.lightDomPatches = ldp === true;
 		b.slotChildNodes = ldp === true || typeof ldp === "object" && !!ldp.childNodes;
@@ -551,9 +551,9 @@ const updateBuildConditionals = (config, b) => {
 		b.slotDomMutations = false;
 		b.slotTextContent = false;
 	}
-	b.lifecycleDOMEvents = !!(b.isDebug || config._isTesting || config.extras.lifecycleDOMEvents);
-	b.signalBacking = !!config.extras?.signalBacking;
-	b.vdomSignals = b.vdomSignals || !!(config.extras?.signalBacking || config.extras?.vdomSignals);
+	b.lifecycleDOMEvents = !!(b.isDebug || config._isTesting || config.compat.lifecycleDOMEvents);
+	b.signalBacking = !!config.signalBacking;
+	b.vdomSignals = b.vdomSignals || !!config.signalBacking;
 	b.invisiblePrehydration = typeof config.invisiblePrehydration === "undefined" ? true : config.invisiblePrehydration;
 	if (config.hydratedFlag) {
 		b.hydratedAttribute = config.hydratedFlag.selector === "attribute";
@@ -2111,7 +2111,7 @@ const generateAppDataModule = (build, config) => {
 };
 const serializeCollectionManifest = (config, compilerCtx, buildCtx) => {
 	const buildFlags = getBuildFeatures(buildCtx.moduleFiles.filter((mod) => !mod.isCollectionDependency).flatMap((mod) => mod.cmps));
-	const ldp = config.extras?.lightDomPatches ?? true;
+	const ldp = config.compat?.lightDomPatches ?? true;
 	if (buildFlags.slotRelocation && ldp !== false) {
 		buildFlags.lightDomPatches = ldp === true;
 		buildFlags.slotChildNodes = ldp === true || typeof ldp === "object" && !!ldp.childNodes;
@@ -2125,8 +2125,8 @@ const serializeCollectionManifest = (config, compilerCtx, buildCtx) => {
 		buildFlags.slotDomMutations = false;
 		buildFlags.slotTextContent = false;
 	}
-	buildFlags.lifecycleDOMEvents = !!config.extras?.lifecycleDOMEvents;
-	buildFlags.initializeNextTick = !!config.extras?.initializeNextTick;
+	buildFlags.lifecycleDOMEvents = !!config.compat?.lifecycleDOMEvents;
+	buildFlags.initializeNextTick = !!config.compat?.initializeNextTick;
 	buildFlags.asyncQueue = config.taskQueue === "congestionAsync";
 	if (config.hydratedFlag) {
 		buildFlags.hydratedAttribute = config.hydratedFlag.selector === "attribute";
@@ -3734,7 +3734,7 @@ const extTransformsPlugin = (config, compilerCtx, buildCtx) => {
 							input: pluginTransforms.code,
 							tag: data.tag,
 							tags: buildCtx.components.map((c) => c.tagName),
-							addTagTransformers: !!buildCtx.config.extras.additionalTagTransformers,
+							addTagTransformers: !!buildCtx.config.compat.additionalTagTransformers,
 							encapsulation: data.encapsulation,
 							mode: data.mode,
 							sourceMap: config.sourceMap,
@@ -5529,7 +5529,7 @@ const getSingleStyle = (cmp, style, buildCtx) => {
 	return null;
 };
 const addTagTransform$1 = (cssCode, buildCtx) => {
-	if (!buildCtx.config.extras.additionalTagTransformers) return ts.factory.createNoSubstitutionTemplateLiteral(cssCode);
+	if (!buildCtx.config.compat.additionalTagTransformers) return ts.factory.createNoSubstitutionTemplateLiteral(cssCode);
 	return addTagTransformToCssTsAST(cssCode, buildCtx.components.map((c) => c.tagName));
 };
 const createStyleLiteral$1 = (cmp, style, buildCtx) => {
@@ -6007,7 +6007,7 @@ const generateLazyModules = async (config, compilerCtx, buildCtx, outputTargetTy
 	const bundleModules = await Promise.all(entryComponentsResults.map((rolldownResult) => {
 		return generateLazyEntryModule(config, compilerCtx, buildCtx, rolldownResult, outputTargetType, destinations, sourceTarget, shouldMinify, isBrowserBuild);
 	}));
-	if (config.extras.enableImportInjection && !isBrowserBuild) addStaticImports(rolldownResults, bundleModules);
+	if (config.compat.enableImportInjection && !isBrowserBuild) addStaticImports(rolldownResults, bundleModules);
 	else if (isBrowserBuild) rolldownResults.filter(isStencilCoreResult).forEach((chunk) => {
 		chunk.code = chunk.code.replace("/*!__STENCIL_STATIC_IMPORT_SWITCH__*/", "");
 	});
@@ -6310,7 +6310,7 @@ const generateCjs = async (config, compilerCtx, buildCtx, rolldownBuild, outputT
 			sourcemap: config.sourceMap,
 			plugins: [lazyBundleIdPlugin(buildCtx, config, false, 8, ".cjs")]
 		};
-		if (config.extras.enableImportInjection) esmOpts.dynamicImportInCjs = false;
+		if (config.compat.enableImportInjection) esmOpts.dynamicImportInCjs = false;
 		const results = await generateRolldownOutput(rolldownBuild, esmOpts, config, buildCtx.entryModules);
 		if (results != null) {
 			buildCtx.commonJsComponentBundle = await generateLazyModules(config, compilerCtx, buildCtx, outputTargetType, cjsOutputs.map((o) => o.cjsDir).filter((cjsDir) => typeof cjsDir === "string"), results, "es2017", false);
@@ -6444,7 +6444,7 @@ const getLazyBuildConditionals = (config, cmps, staticHydrationStyles = false) =
 	build.hydrateServerSide = false;
 	build.asyncQueue = config.taskQueue === "congestionAsync";
 	build.taskQueue = config.taskQueue !== "immediate";
-	build.initializeNextTick = config.extras.initializeNextTick;
+	build.initializeNextTick = config.compat.initializeNextTick;
 	build.staticHydrationStyles = staticHydrationStyles;
 	build.hydrateClientSide = config.outputTargets.some(isOutputTargetSsr);
 	updateBuildConditionals(config, build);
@@ -6556,7 +6556,7 @@ const getCustomBeforeTransformers$2 = (config, compilerCtx, buildCtx) => {
 	};
 	const customBeforeTransformers = [updateStencilCoreImports(transformOpts.coreImportPath)];
 	if (config.transformAliasedImportPaths) customBeforeTransformers.push(rewriteAliasedSourceFileImportPaths);
-	if (buildCtx.config.extras.additionalTagTransformers) customBeforeTransformers.push(addTagTransform$2(compilerCtx, buildCtx));
+	if (buildCtx.config.compat.additionalTagTransformers) customBeforeTransformers.push(addTagTransform$2(compilerCtx, buildCtx));
 	customBeforeTransformers.push(lazyComponentTransform(compilerCtx, transformOpts, buildCtx), removeCollectionImports(compilerCtx));
 	return customBeforeTransformers;
 };
@@ -6757,7 +6757,7 @@ var BuildContext = class {
 	isRebuild = false;
 	moduleFiles = [];
 	outputs = [];
-	packageJson = {};
+	packageJson = null;
 	packageJsonFilePath = null;
 	pendingCopyTasks = [];
 	requiresFullBuild = true;
@@ -7962,19 +7962,88 @@ const generateReadme = async (config, compilerCtx, readmeOutputs, docsData, cmps
 		if (readmeOutput.dir) {
 			const relativeReadmePath = relative$1(config.srcDir, docsData.readmePath);
 			const readmeOutputPath = join$2(readmeOutput.dir, relativeReadmePath);
-			const readmeContent = generateMarkdown(readmeOutput.overwriteExisting === true ? userContent : normalizePath(readmeOutput.dir) !== normalizePath(config.srcDir) ? readmeOutput.overwriteExisting === "if-missing" && await compilerCtx.fs.access(readmeOutputPath) || (readmeOutput.overwriteExisting ?? false) === false ? await getUserReadmeContent(compilerCtx, readmeOutputPath) : userContent : userContent, docsData, cmps, readmeOutput, config);
-			if ((await compilerCtx.fs.writeFile(readmeOutputPath, readmeContent)).changedContent) if (isUpdate) config.logger.info(`updated readme docs: ${docsData.tag}`);
+			const readmeContent = generateMarkdown(await resolveUserContent(compilerCtx, readmeOutput, readmeOutputPath, config, userContent), docsData, cmps, readmeOutput, config);
+			if ((await compilerCtx.fs.readFile(readmeOutputPath))?.replace(/\r/g, "") === readmeContent.replace(/\r/g, "")) return;
+			await compilerCtx.fs.writeFile(readmeOutputPath, readmeContent);
+			if (isUpdate) config.logger.info(`updated readme docs: ${docsData.tag}`);
 			else config.logger.info(`created readme docs: ${docsData.tag}`);
 		}
 	}));
 };
+/**
+* Generate a single README for multiple components that share a directory and
+* therefore share a single readme.md file.
+*
+* Each component gets an '## `tag`' section; existing section headings are
+* shifted from h2 to h3 so they nest correctly under that heading.
+*
+* @param config a validated Stencil config
+* @param compilerCtx the current compiler context
+* @param readmeOutputs docs-readme output targets
+* @param cmps the components to include in the README (typically components that share a directory)
+* @param allCmps metadata for all the components in the project, used to generate dependency lists
+*/
+const generateMergedReadme = async (config, compilerCtx, readmeOutputs, cmps, allCmps) => {
+	const primaryCmp = cmps[0];
+	const isUpdate = !!primaryCmp.readme;
+	const userContent = isUpdate ? primaryCmp.readme : getDefaultReadme(primaryCmp);
+	await Promise.all(readmeOutputs.map(async (readmeOutput) => {
+		if (readmeOutput.dir) {
+			const relativeReadmePath = relative$1(config.srcDir, primaryCmp.readmePath);
+			const readmeOutputPath = join$2(readmeOutput.dir, relativeReadmePath);
+			const readmeContent = generateMergedMarkdown(await resolveUserContent(compilerCtx, readmeOutput, readmeOutputPath, config, userContent), cmps, allCmps, readmeOutput, config);
+			if ((await compilerCtx.fs.readFile(readmeOutputPath))?.replace(/\r/g, "") === readmeContent.replace(/\r/g, "")) return;
+			await compilerCtx.fs.writeFile(readmeOutputPath, readmeContent);
+			const tags = cmps.map((c) => c.tag).join(", ");
+			if (isUpdate) config.logger.info(`updated readme docs: ${tags}`);
+			else config.logger.info(`created readme docs: ${tags}`);
+		}
+	}));
+};
 const generateMarkdown = (userContent, cmp, cmps, readmeOutput, config) => {
-	const dependencies = readmeOutput.dependencies !== false ? depsToMarkdown(cmp, cmps, config) : [];
 	return [
 		userContent || "",
 		AUTO_GENERATE_COMMENT,
 		"",
 		"",
+		...generateComponentBody(cmp, cmps, readmeOutput, config),
+		`----------------------------------------------`,
+		"",
+		readmeOutput.footer,
+		""
+	].join("\n");
+};
+const generateMergedMarkdown = (userContent, cmps, allCmps, readmeOutput, config) => {
+	const sections = [];
+	for (const cmp of cmps) {
+		const body = generateComponentBody(cmp, allCmps, readmeOutput, config);
+		if (body.length === 0) continue;
+		const shiftedBody = body.map((line) => line.replace(/^## /, "### "));
+		sections.push(`## \`${cmp.tag}\``, "", ...shiftedBody, "");
+	}
+	return [
+		userContent || "",
+		AUTO_GENERATE_COMMENT,
+		"",
+		"",
+		...sections,
+		`----------------------------------------------`,
+		"",
+		readmeOutput.footer,
+		""
+	].join("\n");
+};
+/**
+* Returns the auto-generated lines for a single component (no header/footer).
+* @param cmp the component documentation data
+* @param cmps all components documentation data
+* @param readmeOutput the readme output target config
+* @param config the Stencil config
+* @returns an array of strings representing the auto-generated lines for the component
+*/
+const generateComponentBody = (cmp, cmps, readmeOutput, config) => {
+	const dependencies = readmeOutput.dependencies !== false ? depsToMarkdown(cmp, cmps, config) : [];
+	return [
 		...getDocsDeprecation(cmp),
 		...overviewToMarkdown(cmp.overview),
 		...usageToMarkdown(cmp.usage),
@@ -7985,12 +8054,26 @@ const generateMarkdown = (userContent, cmp, cmps, readmeOutput, config) => {
 		...partsToMarkdown(cmp.parts),
 		...customStatesToMarkdown(cmp.customStates),
 		...stylesToMarkdown(cmp.styles),
-		...dependencies,
-		`----------------------------------------------`,
-		"",
-		readmeOutput.footer,
-		""
-	].join("\n");
+		...dependencies
+	];
+};
+/**
+* Resolves the user-written content (above AUTO_GENERATE_COMMENT) to use when
+* generating a readme, respecting the `overwriteExisting` option and whether
+* the output dir differs from the source dir.
+* @param compilerCtx the current compiler context
+* @param readmeOutput the readme output target config
+* @param readmeOutputPath the full path to the output readme file
+* @param config the Stencil config
+* @param userContent the content located above AUTO_GENERATE_COMMENT in the existing readme, or a default template if no existing readme
+* @returns the content to use as the "user content" (content above AUTO_GENERATE_COMMENT) for the new readme
+*/
+const resolveUserContent = async (compilerCtx, readmeOutput, readmeOutputPath, config, userContent) => {
+	if (readmeOutput.overwriteExisting === true) return userContent;
+	if (normalizePath(readmeOutput.dir) !== normalizePath(config.srcDir)) {
+		if (readmeOutput.overwriteExisting === "if-missing" && await compilerCtx.fs.access(readmeOutputPath) || (readmeOutput.overwriteExisting ?? false) === false) return getUserReadmeContent(compilerCtx, readmeOutputPath);
+	}
+	return userContent;
 };
 const getDocsDeprecation = (cmp) => {
 	if (cmp.deprecation !== void 0) return [`> **[DEPRECATED]** ${cmp.deprecation}`, ""];
@@ -8058,9 +8141,13 @@ const generateReadmeDocs = async (config, compilerCtx, docsData, outputTargets)
 	const readmeOutputTargets = outputTargets.filter(isOutputTargetDocsReadme);
 	if (readmeOutputTargets.length === 0) return;
 	if (readmeOutputTargets.some((o) => o.strict)) strictCheckDocs(config, docsData);
-	await Promise.all(docsData.components.map((cmpData) => {
-		return generateReadme(config, compilerCtx, readmeOutputTargets, cmpData, docsData.components);
-	}));
+	const byReadmePath = /* @__PURE__ */ new Map();
+	for (const cmpData of docsData.components) {
+		const group = byReadmePath.get(cmpData.readmePath);
+		if (group) group.push(cmpData);
+		else byReadmePath.set(cmpData.readmePath, [cmpData]);
+	}
+	await Promise.all(Array.from(byReadmePath.values()).map((group) => group.length === 1 ? generateReadme(config, compilerCtx, readmeOutputTargets, group[0], docsData.components) : generateMergedReadme(config, compilerCtx, readmeOutputTargets, group, docsData.components)));
 };
 const strictCheckDocs = (config, docsData) => {
 	docsData.components.forEach((component) => {
@@ -8209,7 +8296,7 @@ const outputGlobalStyle = async (config, compilerCtx, buildCtx) => {
 		if (!css) return;
 		const writePromises = [];
 		const primaryPath = join$2(outputTarget.dir, outputTarget.fileName);
-		writePromises.push(compilerCtx.fs.writeFile(primaryPath, css));
+		writePromises.push(compilerCtx.fs.writeFile(primaryPath, css, { outputTargetType: outputTarget.type }));
 		if (outputTarget.copyToLoaderBrowser && loaderBundleTargets.length > 0) for (const loaderTarget of loaderBundleTargets) {
 			const compatPath = join$2(join$2(loaderTarget.buildDir, namespace), outputTarget.fileName);
 			writePromises.push(compilerCtx.fs.writeFile(compatPath, css));
@@ -9117,11 +9204,11 @@ const generateComponentTypesFile = (config, buildCtx, areTypesInternal) => {
 		* Only generate event detail types for components that have events.
 		*/
 		componentEventDetailTypes.push(generateEventDetailTypes(cmp));
-		return generateComponentTypes(cmp, typeImportData, areTypesInternal, !!config.extras?.signalBacking);
+		return generateComponentTypes(cmp, typeImportData, areTypesInternal, !!config.signalBacking);
 	});
 	c.push(COMPONENTS_DTS_HEADER);
 	c.push(`import { HTMLStencilElement, JSXBase } from "@stencil/core/runtime";`);
-	if (config.extras?.signalBacking) {
+	if (config.signalBacking) {
 		c.push(`import { STENCIL_SIGNALS_SYMBOL, type ReadonlySignal } from "@stencil/core/signals";`);
 		c.push(`export { STENCIL_SIGNALS_SYMBOL } from "@stencil/core/signals";`);
 	}
@@ -9438,7 +9525,7 @@ const injectManifest = async (buildCtx, serviceWorker, workbox) => {
 };
 const hasServiceWorkerChanges = (config, buildCtx) => {
 	if (config.devMode && !config.generateServiceWorker) return false;
-	return config.outputTargets.filter(isOutputTargetWww).filter((o) => o.serviceWorker && o.serviceWorker.swSrc).some((outputTarget) => {
+	return config.outputTargets.filter(isOutputTargetWww).filter((o) => o.serviceWorker?.swSrc).some((outputTarget) => {
 		return buildCtx.filesChanged.some((fileChanged) => {
 			if (outputTarget.serviceWorker) return basename$1(fileChanged).toLowerCase() === basename$1(outputTarget.serviceWorker.swSrc).toLowerCase();
 			return false;
@@ -9509,11 +9596,9 @@ const generateServiceWorkerUrl = (outputTarget, serviceWorker) => {
 //#endregion
 //#region src/compiler/html/inject-sw-script.ts
 const updateIndexHtmlServiceWorker = async (config, buildCtx, doc, outputTarget) => {
-	const serviceWorker = outputTarget.serviceWorker;
-	if (serviceWorker !== false) {
-		if (serviceWorker && serviceWorker.unregister || !serviceWorker && config.devMode) injectUnregisterServiceWorker(doc);
-		else if (serviceWorker) await injectRegisterServiceWorker(buildCtx, outputTarget, doc);
-	}
+	const serviceWorker = outputTarget.serviceWorker ?? null;
+	if (serviceWorker && serviceWorker.unregister || !serviceWorker && config.devMode) injectUnregisterServiceWorker(doc);
+	else if (serviceWorker) await injectRegisterServiceWorker(buildCtx, outputTarget, doc);
 };
 const injectRegisterServiceWorker = async (buildCtx, outputTarget, doc) => {
 	const serviceWorker = getRegisterSwScript(doc, buildCtx, generateServiceWorkerUrl(outputTarget, outputTarget.serviceWorker));
@@ -10051,7 +10136,7 @@ const getCustomBeforeTransformers$1 = (config, compilerCtx, buildCtx) => {
 	};
 	const customBeforeTransformers = [updateStencilCoreImports(transformOpts.coreImportPath)];
 	if (config.transformAliasedImportPaths) customBeforeTransformers.push(rewriteAliasedSourceFileImportPaths);
-	if (buildCtx.config.extras.additionalTagTransformers) customBeforeTransformers.push(addTagTransform$2(compilerCtx, buildCtx));
+	if (buildCtx.config.compat.additionalTagTransformers) customBeforeTransformers.push(addTagTransform$2(compilerCtx, buildCtx));
 	customBeforeTransformers.push(ssrComponentTransform(compilerCtx, transformOpts, buildCtx), removeCollectionImports(compilerCtx));
 	return customBeforeTransformers;
 };
@@ -11077,7 +11162,7 @@ const addSingleStyleGetter = (classMembers, cmp, style, buildCtx) => {
 	}
 };
 const addTagTransform = (cssCode, buildCtx) => {
-	if (!buildCtx.config.extras.additionalTagTransformers) return ts.factory.createNoSubstitutionTemplateLiteral(cssCode);
+	if (!buildCtx.config.compat.additionalTagTransformers) return ts.factory.createNoSubstitutionTemplateLiteral(cssCode);
 	return addTagTransformToCssTsAST(cssCode, buildCtx.components.map((c) => c.tagName));
 };
 const createStyleLiteral = (cmp, style, buildCtx) => {
@@ -11441,7 +11526,7 @@ const getStandaloneBuildConditionals = (config, cmps) => {
 	build.hydrateServerSide = false;
 	build.asyncQueue = config.taskQueue === "congestionAsync";
 	build.taskQueue = config.taskQueue !== "immediate";
-	build.initializeNextTick = config.extras.initializeNextTick;
+	build.initializeNextTick = config.compat.initializeNextTick;
 	updateBuildConditionals(config, build);
 	build.devTools = false;
 	return build;
@@ -11676,7 +11761,7 @@ const getCustomBeforeTransformers = (config, compilerCtx, components, outputTarg
 	};
 	const customBeforeTransformers = [addDefineCustomElementFunctions(compilerCtx, components, outputTarget, config.devMode), updateStencilCoreImports(transformOpts.coreImportPath)];
 	if (config.transformAliasedImportPaths) customBeforeTransformers.push(rewriteAliasedSourceFileImportPaths);
-	if (buildCtx.config.extras.additionalTagTransformers) customBeforeTransformers.push(addTagTransform$2(compilerCtx, buildCtx));
+	if (buildCtx.config.compat.additionalTagTransformers) customBeforeTransformers.push(addTagTransform$2(compilerCtx, buildCtx));
 	customBeforeTransformers.push(nativeComponentTransform(compilerCtx, transformOpts, buildCtx), proxyCustomElement(compilerCtx, transformOpts), removeCollectionImports(compilerCtx));
 	return customBeforeTransformers;
 };
@@ -15861,6 +15946,7 @@ const generateBuildResults = (config, compilerCtx, buildCtx) => {
 		hasSuccessfulBuild: compilerCtx.hasSuccessfulBuild,
 		isRebuild: buildCtx.isRebuild,
 		namespace: config.namespace,
+		fsNamespace: config.fsNamespace,
 		outputs: compilerCtx.fs.getBuildOutputs(),
 		components: buildCtx.components.slice(),
 		rootDir: config.rootDir,
@@ -16493,7 +16579,7 @@ const writeExportMaps = (config, buildCtx) => {
 */
 const generateRootExport = (config, buildCtx, loaderBundle, standalone, types) => {
 	if (!loaderBundle && !standalone) return;
-	const currentImport = (buildCtx.packageJson.exports?.["."])?.import;
+	const currentImport = ((buildCtx.packageJson?.exports)?.["."])?.import;
 	if (!(currentImport && isValidRootExport(config, currentImport, loaderBundle, standalone))) {
 		const primaryDir = loaderBundle?.dir ?? standalone?.dir;
 		if (primaryDir) {
@@ -16873,15 +16959,6 @@ const hasScriptExt = (filePath) => {
 	const ext = getExt(filePath);
 	return ext ? SCRIPT_EXT.includes(ext) : false;
 };
-const STYLE_EXT = [
-	"css",
-	"scss",
-	"sass",
-	"pcss",
-	"styl",
-	"stylus",
-	"less"
-];
 /**
 * Helper to check if a filepath has a style extension
 *
@@ -16929,7 +17006,17 @@ const hasStyleChanges = (buildCtx) => buildCtx.filesChanged.some(hasStyleExt);
 */
 const hasHtmlChanges = (config, buildCtx) => {
 	const srcDirPrefix = config.srcDir + "/";
-	return buildCtx.filesChanged.some((f) => f.toLowerCase().endsWith(".html") && f.startsWith(srcDirPrefix));
+	const isHtmlOrUsageMd = (f) => {
+		if (!f.startsWith(srcDirPrefix)) return false;
+		const lower = f.toLowerCase();
+		return lower.endsWith(".html") || lower.endsWith(".md") && f.includes("/usage/");
+	};
+	if (buildCtx.filesChanged.some(isHtmlOrUsageMd)) return true;
+	if (buildCtx.filesDeleted.some(isHtmlOrUsageMd)) return true;
+	const isUsageDir = (d) => d.startsWith(srcDirPrefix) && /\/usage\/?$/.test(d);
+	if (buildCtx.dirsDeleted.some(isUsageDir)) return true;
+	const isSrcTsx = (f) => f.startsWith(srcDirPrefix) && f.toLowerCase().endsWith(".tsx");
+	return buildCtx.filesAdded.some(isSrcTsx) || buildCtx.filesDeleted.some(isSrcTsx);
 };
 /**
 * Checks if a path is ignored by the watch configuration
@@ -18114,17 +18201,13 @@ const validatePrerender = (config, diagnostics, outputTarget) => {
 * configuration we want to validate. **Note**: the `.serviceWorker` object
 * _will be mutated_ if it is present.
 */
-const validateServiceWorker = (config, outputTarget) => {
-	if (outputTarget.serviceWorker === false) return;
-	if (config.devMode && !config.generateServiceWorker) {
-		outputTarget.serviceWorker = null;
-		return;
-	}
-	if (outputTarget.serviceWorker === null) {
+function validateServiceWorker(config, outputTarget) {
+	if (!outputTarget.serviceWorker) {
 		outputTarget.serviceWorker = null;
 		return;
 	}
-	if (!outputTarget.serviceWorker && config.devMode) {
+	if (outputTarget.serviceWorker === true) outputTarget.serviceWorker = {};
+	if (config.devMode && !config.generateServiceWorker) {
 		outputTarget.serviceWorker = null;
 		return;
 	}
@@ -18144,7 +18227,7 @@ const validateServiceWorker = (config, outputTarget) => {
 	outputTarget.serviceWorker.dontCacheBustURLsMatching = /p-\w{8}/;
 	if (isString$1(outputTarget.serviceWorker.swSrc) && !isAbsolute$1(outputTarget.serviceWorker.swSrc)) outputTarget.serviceWorker.swSrc = join$2(config.rootDir, outputTarget.serviceWorker.swSrc);
 	if (isString$1(outputTarget.serviceWorker.swDest) && !isAbsolute$1(outputTarget.serviceWorker.swDest)) outputTarget.serviceWorker.swDest = join$2(outputTarget.appDir ?? "", outputTarget.serviceWorker.swDest);
-};
+}
 /**
 * Add file glob patterns to the `globIgnores` for files we don't want to cache
 * with the service worker.
@@ -18160,15 +18243,7 @@ const DEFAULT_FILENAME = "sw.js";
 //#endregion
 //#region src/compiler/config/outputs/validate-www.ts
 const validateWww = (config, diagnostics, userOutputs) => {
-	const AUTO_GENERATED_TYPES = [
-		TYPES,
-		STENCIL_REBUNDLE,
-		GLOBAL_STYLE,
-		ASSETS
-	];
-	const hasOutputTargets = userOutputs.some((o) => !AUTO_GENERATED_TYPES.includes(o.type));
 	const userWwwOutputs = userOutputs.filter(isOutputTargetWww);
-	if (!hasOutputTargets) userWwwOutputs.push({ type: "www" });
 	const hasLoaderBundle = userOutputs.some(isOutputTargetLoaderBundle);
 	const hasStandalone = userOutputs.some(isOutputTargetStandalone);
 	const defaultBundleMode = !hasLoaderBundle && hasStandalone ? "standalone" : "loader";
@@ -18260,6 +18335,13 @@ const validateOutputTargets = (config, diagnostics) => {
 			err.messageText = `Invalid outputTarget type "${outputTarget.type}". Valid outputTarget types include: ${VALID_CONFIG_OUTPUT_TARGETS.map((t) => `"${t}"`).join(", ")}`;
 		}
 	});
+	const IMPLICIT_TYPES = [
+		TYPES,
+		COLLECTION,
+		GLOBAL_STYLE,
+		ASSETS
+	];
+	if (!userOutputs.some((o) => !IMPLICIT_TYPES.includes(o.type))) userOutputs.push({ type: LOADER_BUNDLE });
 	autoGenerateOutputs(config, userOutputs, diagnostics);
 	config.outputTargets = [
 		...validateTypes(config, userOutputs),
@@ -18303,7 +18385,7 @@ const autoGenerateOutputs = (config, userOutputs, diagnostics) => {
 	if (!hasExplicitAssets) userOutputs.push({ type: ASSETS });
 	if (config.devMode) return;
 	if (!hasExplicitTypes) userOutputs.push({ type: TYPES });
-	if (!hasExplicitCollection) userOutputs.push({ type: STENCIL_REBUNDLE });
+	if (!hasExplicitCollection) userOutputs.push({ type: COLLECTION });
 };
 //#endregion
 //#region src/compiler/config/validate-dev-server.ts
@@ -18448,6 +18530,17 @@ const validateHydrated = (config) => {
 };
 //#endregion
 //#region src/compiler/config/validate-namespace.ts
+const deriveDefaultNamespace = (rootDir, sys) => {
+	try {
+		const pkgContent = sys.readFileSync(join$1(rootDir, "package.json"));
+		if (pkgContent) {
+			const name = JSON.parse(pkgContent)?.name;
+			if (isString$1(name) && name.length >= 3) return name.replace(/^@[^/]+\//, "");
+		}
+	} catch {}
+	const dirName = basename$1(rootDir);
+	return dirName.length >= 3 ? dirName : "App";
+};
 /**
 * Ensures that the `namespace` and `fsNamespace` properties on a project's
 * Stencil config are valid strings. A valid namespace means:
@@ -18458,15 +18551,18 @@ const validateHydrated = (config) => {
 *
 * If any conditions are not met, a diagnostic is added to the provided array.
 *
-* If a namespace is not provided, the default value is `App`.
+* If a namespace is not provided, it is derived from the package.json `name` field,
+* falling back to the root directory name, then `App` as a last resort.
 *
 * @param namespace The namespace to validate
 * @param fsNamespace The fsNamespace to validate
 * @param diagnostics The array of diagnostics to add to if the namespace is invalid
+* @param rootDir The project root directory, used for package.json lookup
+* @param sys The compiler system, used to read package.json
 * @returns The validated namespace and fsNamespace
 */
-const validateNamespace = (namespace, fsNamespace, diagnostics) => {
-	namespace = isString$1(namespace) ? namespace : "App";
+const validateNamespace = (namespace, fsNamespace, diagnostics, rootDir, sys) => {
+	namespace = isString$1(namespace) ? namespace : rootDir && sys ? deriveDefaultNamespace(rootDir, sys) : "App";
 	namespace = namespace.trim();
 	const invalidNamespaceChars = namespace.replace(/(\w)|(-)|(\$)/g, "");
 	if (invalidNamespaceChars !== "") {
@@ -18496,14 +18592,6 @@ const validateNamespace = (namespace, fsNamespace, diagnostics) => {
 		fsNamespace
 	};
 };
-const validateDistNamespace = (config, diagnostics) => {
-	if ((config.outputTargets ?? []).some(isOutputTargetLoaderBundle)) {
-		if (!isString$1(config.namespace) || config.namespace.toLowerCase() === "app") {
-			const err = buildError(diagnostics);
-			err.messageText = `When generating a distribution it is recommended to choose a unique namespace rather than the default setting "App". Please updated the "namespace" config property within the stencil config.`;
-		}
-	}
-};
 //#endregion
 //#region src/compiler/config/validate-paths.ts
 /**
@@ -18629,11 +18717,30 @@ const validateConfig = (userConfig = {}, bootstrapConfig) => {
 	logger.setLevel(logLevel);
 	const devMode = isBoolean$1(config.devMode) ? config.devMode : false;
 	config._isTesting = !!(process.env.VITEST || process.env.PLAYWRIGHT_TEST || process.env.TEST_WORKER_INDEX || process.env.TEST_PARALLEL_INDEX || process.env.NODE_ENV === "test");
+	const sys = config.sys ?? bootstrapConfig.sys ?? createNodeSys({ logger });
+	if ((!isString$1(config.globalStyle) || !isString$1(config.globalScript)) && typeof sys.accessSync === "function") {
+		const preRootDir = typeof config.rootDir !== "string" ? "/" : config.rootDir;
+		const srcDir = typeof config.srcDir === "string" ? isAbsolute$1(config.srcDir) ? config.srcDir : join$1(preRootDir, config.srcDir) : join$1(preRootDir, "src");
+		if (!isString$1(config.globalStyle)) for (const ext of STYLE_EXT) {
+			const candidate = join$1(srcDir, `global.${ext}`);
+			if (sys.accessSync(candidate)) {
+				config.globalStyle = candidate;
+				break;
+			}
+		}
+		if (!isString$1(config.globalScript)) for (const ext of ["ts", "js"]) {
+			const candidate = join$1(srcDir, `global.${ext}`);
+			if (sys.accessSync(candidate)) {
+				config.globalScript = candidate;
+				break;
+			}
+		}
+	}
 	const validatedConfig = {
 		devServer: {},
 		...config,
 		devMode,
-		extras: config.extras || {},
+		compat: config.compat || {},
 		generateExportMaps: isBoolean$1(config.generateExportMaps) ? config.generateExportMaps : false,
 		hydratedFlag: validateHydrated(config),
 		logLevel,
@@ -18643,20 +18750,20 @@ const validateConfig = (userConfig = {}, bootstrapConfig) => {
 		outputTargets: config.outputTargets ?? [],
 		rolldownConfig: validateRolldownConfig(config),
 		sourceMap: config.sourceMap === true || devMode && (config.sourceMap === "dev" || typeof config.sourceMap === "undefined"),
-		sys: config.sys ?? bootstrapConfig.sys ?? createNodeSys({ logger }),
+		sys,
 		docs: validateDocs(config, logger),
 		transformAliasedImportPaths: isBoolean$1(userConfig.transformAliasedImportPaths) ? userConfig.transformAliasedImportPaths : true,
-		...validateNamespace(config.namespace, config.fsNamespace, diagnostics),
+		...validateNamespace(config.namespace, config.fsNamespace, diagnostics, config.rootDir, sys),
 		...validatePaths(config)
 	};
 	if (validatedConfig.buildLogFilePath) logger.setLogFilePath(validatedConfig.buildLogFilePath);
-	validatedConfig.extras.enableImportInjection = validatedConfig.extras.enableImportInjection !== false;
-	validatedConfig.extras.lifecycleDOMEvents = !!validatedConfig.extras.lifecycleDOMEvents;
-	validatedConfig.extras.initializeNextTick = !!validatedConfig.extras.initializeNextTick;
-	validatedConfig.extras.additionalTagTransformers = validatedConfig.extras.additionalTagTransformers === true || !devMode && validatedConfig.extras.additionalTagTransformers === "prod";
-	const ldp = validatedConfig.extras.lightDomPatches;
-	if (ldp === void 0) validatedConfig.extras.lightDomPatches = true;
-	else if (typeof ldp !== "boolean" && typeof ldp !== "object") validatedConfig.extras.lightDomPatches = true;
+	validatedConfig.compat.enableImportInjection = validatedConfig.compat.enableImportInjection !== false;
+	validatedConfig.compat.lifecycleDOMEvents = !!validatedConfig.compat.lifecycleDOMEvents;
+	validatedConfig.compat.initializeNextTick = !!validatedConfig.compat.initializeNextTick;
+	validatedConfig.compat.additionalTagTransformers = validatedConfig.compat.additionalTagTransformers === true || !devMode && validatedConfig.compat.additionalTagTransformers === "prod";
+	const ldp = validatedConfig.compat.lightDomPatches;
+	if (ldp === void 0) validatedConfig.compat.lightDomPatches = true;
+	else if (typeof ldp !== "boolean" && typeof ldp !== "object") validatedConfig.compat.lightDomPatches = true;
 	setBooleanConfig(validatedConfig, "watch", false);
 	setBooleanConfig(validatedConfig, "profile", validatedConfig.devMode);
 	setBooleanConfig(validatedConfig, "writeLog", false);
@@ -18676,7 +18783,6 @@ const validateConfig = (userConfig = {}, bootstrapConfig) => {
 	if (!Array.isArray(validatedConfig.collections)) validatedConfig.collections = [];
 	validateWorkers(validatedConfig);
 	setBooleanConfig(validatedConfig, "devInspector", validatedConfig.devMode);
-	if (!validatedConfig._isTesting) validateDistNamespace(validatedConfig, diagnostics);
 	setBooleanConfig(validatedConfig, "enableCache", true);
 	if (!Array.isArray(validatedConfig.watchIgnoredRegex) && validatedConfig.watchIgnoredRegex != null) validatedConfig.watchIgnoredRegex = [validatedConfig.watchIgnoredRegex];
 	validatedConfig.watchIgnoredRegex = (validatedConfig.watchIgnoredRegex || []).reduce((arr, reg) => {
@@ -21334,7 +21440,7 @@ const createCompiler = async (userConfig) => {
 };
 //#endregion
 //#region src/compiler/sys/typescript/typescript-config.ts
-const validateTsConfig = async (config, sys, init) => {
+const validateTsConfig = async (config, sys) => {
 	const tsconfig = {
 		path: "",
 		compilerOptions: {},
@@ -21346,7 +21452,7 @@ const validateTsConfig = async (config, sys, init) => {
 		diagnostics: []
 	};
 	try {
-		const readTsConfig = await getTsConfigPath(config, sys, init);
+		const readTsConfig = await getTsConfigPath(config, sys);
 		if (!readTsConfig) {
 			const diagnostic = buildError(tsconfig.diagnostics);
 			diagnostic.header = `Missing tsconfig.json`;
@@ -21391,13 +21497,7 @@ const validateTsConfig = async (config, sys, init) => {
 			if (results.watchOptions) tsconfig.watchOptions = results.watchOptions;
 			if (results.options) {
 				tsconfig.compilerOptions = results.options;
-				const target = tsconfig.compilerOptions.target ?? ts.ScriptTarget.ES2017;
-				if ([
-					ts.ScriptTarget.ES3,
-					ts.ScriptTarget.ES5,
-					ts.ScriptTarget.ES2015,
-					ts.ScriptTarget.ES2016
-				].includes(target)) {
+				if ((tsconfig.compilerOptions.target ?? ts.ScriptTarget.ES2017) < ts.ScriptTarget.ES2017) {
 					const warn = buildWarn(tsconfig.diagnostics);
 					warn.messageText = `Stencil requires the tsconfig.json “target” setting to be “es2017” or higher. ES5 build output is no longer supported.`;
 				}
@@ -21414,7 +21514,7 @@ const validateTsConfig = async (config, sys, init) => {
 	}
 	return tsconfig;
 };
-const getTsConfigPath = async (config, sys, init) => {
+const getTsConfigPath = async (config, sys) => {
 	const tsconfig = {
 		path: "",
 		content: ""
@@ -21424,27 +21524,31 @@ const getTsConfigPath = async (config, sys, init) => {
 	else tsconfig.path = join$2(config.rootDir, "tsconfig.json");
 	tsconfig.content = await sys.readFile(tsconfig.path);
 	if (!isString$1(tsconfig.content)) {
-		if (!init.initTsConfig) return null;
 		tsconfig.path = join$2(config.rootDir, "tsconfig.json");
 		tsconfig.content = createDefaultTsConfig(config);
 		await sys.writeFile(tsconfig.path, tsconfig.content);
 	}
+	if (!isString$1(config.configPath)) {
+		const componentsDtsPath = getComponentsDtsSrcFilePath(config);
+		if (!isString$1(await sys.readFile(componentsDtsPath))) await sys.writeFile(componentsDtsPath, "/* auto-generated by stencil */\nexport {};\n");
+	}
 	tsconfig.path = normalizePath(tsconfig.path);
 	return tsconfig;
 };
 const createDefaultTsConfig = (config) => JSON.stringify({
 	compilerOptions: {
-		allowSyntheticDefaultImports: true,
 		experimentalDecorators: true,
-		lib: ["dom", "es2015"],
-		moduleResolution: "node",
-		module: "esnext",
-		target: "es2017",
-		jsx: "react",
-		jsxFactory: "h",
-		jsxFragmentFactory: "Fragment",
-		sourceMap: config.sourceMap,
-		inlineSources: config.sourceMap
+		strict: true,
+		target: "ES2022",
+		module: "ESNext",
+		moduleResolution: "bundler",
+		lib: ["ES2022", "DOM"],
+		jsx: "react-jsx",
+		jsxImportSource: "@stencil/core",
+		resolveJsonModule: true,
+		allowJs: true,
+		rootDir: "./",
+		outDir: "./dist"
 	},
 	include: [relative$1(config.rootDir, config.srcDir)]
 }, null, 2);
@@ -21518,7 +21622,7 @@ const loadConfig = async (init = {}) => {
 		if (hasError(results.diagnostics)) return results;
 		results.config = validated.config;
 		if (!hasError(results.diagnostics)) {
-			const tsConfigResults = await validateTsConfig(results.config, sys, init);
+			const tsConfigResults = await validateTsConfig(results.config, sys);
 			results.diagnostics.push(...tsConfigResults.diagnostics);
 			results.config.tsconfig = tsConfigResults.path;
 			results.config.tsCompilerOptions = tsConfigResults.compilerOptions;