@bamboocss/generator 1.39.0 → 1.40.0

package/dist/index.cjs

@@ -4063,6 +4063,8 @@ var Generator = class extends _bamboocss_core.Context {
 	* markdown is invisible to a scan of your own source, and the failure is an element quietly
 	* losing its reset rather than anything that reports itself.
 	*/
+	/** Whether this context has already named what the reset lost; see `prunePreflight`. */
+	reportedPreflightPrune = false;
 	prunePreflight = (sheet, rendered) => {
 		const { preflight } = this.config;
 		if (!(0, _bamboocss_core.prunesPreflight)(preflight)) return;
@@ -4072,7 +4074,22 @@ var Generator = class extends _bamboocss_core.Context {
 			rendered,
 			scope
 		});
-		_bamboocss_logger.logger.debug("prune:preflight", `Removed ${result.removedRules} reset rule(s) and ${result.removedParts} selector part(s) for unrendered elements`);
+		/**
+		* Said out loud, and by name.
+		*
+		* `info` rather than `debug` because this only runs for a project that asked for it, so
+		* there is nobody to be noisy at — and because the objection to this pass is that being
+		* wrong is silent. An element rendered by a dependency's component, by markdown, or by
+		* `dangerouslySetInnerHTML` is invisible to the scan, loses its reset, and reports
+		* nothing; a list of what went is the only way a reader can check that against what they
+		* know their own app renders.
+		*
+		* Names rather than counts, for the same reason. "Removed 8 rules" is unverifiable.
+		*/
+		if (result.removedElements.size && !this.reportedPreflightPrune) {
+			this.reportedPreflightPrune = true;
+			_bamboocss_logger.logger.info("prune:preflight", `Reset rules removed for ${result.removedElements.size} element(s) your source never renders: ${[...result.removedElements].sort().join(", ")}. Anything rendered by a dependency, by markdown, or through \`dangerouslySetInnerHTML\` is invisible to this scan — check the list, or set \`preflight: { prune: false }\`.`);
+		}
 		return result;
 	};
 	/**

package/dist/index.d.cts

@@ -50,9 +50,12 @@ declare class Generator extends Context {
    * markdown is invisible to a scan of your own source, and the failure is an element quietly
    * losing its reset rather than anything that reports itself.
    */
+  /** Whether this context has already named what the reset lost; see `prunePreflight`. */
+  private reportedPreflightPrune;
   prunePreflight: (sheet: Stylesheet, rendered: Set<string>) => {
     removedRules: number;
     removedParts: number;
+    removedElements: Set<string>;
   } | undefined;
   /**
    * Drop `@keyframes` nothing can reach. Same completeness requirement as

package/dist/index.d.mts

@@ -50,9 +50,12 @@ declare class Generator extends Context {
    * markdown is invisible to a scan of your own source, and the failure is an element quietly
    * losing its reset rather than anything that reports itself.
    */
+  /** Whether this context has already named what the reset lost; see `prunePreflight`. */
+  private reportedPreflightPrune;
   prunePreflight: (sheet: Stylesheet, rendered: Set<string>) => {
     removedRules: number;
     removedParts: number;
+    removedElements: Set<string>;
   } | undefined;
   /**
    * Drop `@keyframes` nothing can reach. Same completeness requirement as

package/dist/index.mjs

@@ -4037,6 +4037,8 @@ var Generator = class extends Context {
 	* markdown is invisible to a scan of your own source, and the failure is an element quietly
 	* losing its reset rather than anything that reports itself.
 	*/
+	/** Whether this context has already named what the reset lost; see `prunePreflight`. */
+	reportedPreflightPrune = false;
 	prunePreflight = (sheet, rendered) => {
 		const { preflight } = this.config;
 		if (!prunesPreflight(preflight)) return;
@@ -4046,7 +4048,22 @@ var Generator = class extends Context {
 			rendered,
 			scope
 		});
-		logger.debug("prune:preflight", `Removed ${result.removedRules} reset rule(s) and ${result.removedParts} selector part(s) for unrendered elements`);
+		/**
+		* Said out loud, and by name.
+		*
+		* `info` rather than `debug` because this only runs for a project that asked for it, so
+		* there is nobody to be noisy at — and because the objection to this pass is that being
+		* wrong is silent. An element rendered by a dependency's component, by markdown, or by
+		* `dangerouslySetInnerHTML` is invisible to the scan, loses its reset, and reports
+		* nothing; a list of what went is the only way a reader can check that against what they
+		* know their own app renders.
+		*
+		* Names rather than counts, for the same reason. "Removed 8 rules" is unverifiable.
+		*/
+		if (result.removedElements.size && !this.reportedPreflightPrune) {
+			this.reportedPreflightPrune = true;
+			logger.info("prune:preflight", `Reset rules removed for ${result.removedElements.size} element(s) your source never renders: ${[...result.removedElements].sort().join(", ")}. Anything rendered by a dependency, by markdown, or through \`dangerouslySetInnerHTML\` is invisible to this scan — check the list, or set \`preflight: { prune: false }\`.`);
+		}
 		return result;
 	};
 	/**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bamboocss/generator",
-  "version": "1.39.0",
+  "version": "1.40.0",
   "description": "The css generator for css bamboo",
   "homepage": "https://bamboocss.com",
   "license": "MIT",
@@ -38,12 +38,12 @@
     "pluralize": "8.0.0",
     "postcss": "8.5.26",
     "ts-pattern": "5.9.0",
-    "@bamboocss/core": "1.39.0",
-    "@bamboocss/is-valid-prop": "^1.39.0",
-    "@bamboocss/logger": "1.39.0",
-    "@bamboocss/shared": "1.39.0",
-    "@bamboocss/token-dictionary": "1.39.0",
-    "@bamboocss/types": "1.39.0"
+    "@bamboocss/core": "1.40.0",
+    "@bamboocss/is-valid-prop": "^1.40.0",
+    "@bamboocss/logger": "1.40.0",
+    "@bamboocss/shared": "1.40.0",
+    "@bamboocss/token-dictionary": "1.40.0",
+    "@bamboocss/types": "1.40.0"
   },
   "devDependencies": {
     "@types/pluralize": "0.0.33"