@bamboocss/generator 1.53.1 → 1.54.0

package/dist/index.cjs

@@ -4073,14 +4073,32 @@ var Generator = class extends _bamboocss_core.Context {
 	getParserCss = (decoder) => {
 		return generateParserCss(this, decoder);
 	};
+	/**
+	* Each atom's first call site, by the class name the sheet writes it under.
+	*
+	* Only what the encoder recorded — see `StyleEncoder.recordOrigins` — so empty unless an
+	* integration asked for origins. Several hashes can decode to one class; the first wins.
+	*/
+	getAtomOrigins = () => {
+		const byHash = this.encoder.atomOrigins();
+		const origins = /* @__PURE__ */ new Map();
+		if (!byHash.size) return origins;
+		for (const atom of this.decoder.collect(this.encoder).atomic) {
+			const origin = byHash.get(atom.hash);
+			if (origin && !origins.has(atom.className)) origins.set(atom.className, origin);
+		}
+		return origins;
+	};
 	getCss = (stylesheet) => {
-		let css = (stylesheet ?? this.createSheet()).toCss({ minify: this.config.minify });
+		const sheet = stylesheet ?? this.createSheet();
+		let css = sheet.toCss({ minify: this.config.minify });
 		if (this.hooks["cssgen:done"]) css = this.hooks["cssgen:done"]({
 			artifact: "styles.css",
 			content: css
 		}) ?? css;
 		this.assertNoUnresolvedTokens();
 		this.reportRawValues();
+		this.reportInvalidDeclarations(sheet);
 		return css;
 	};
 	/**
@@ -4187,6 +4205,63 @@ var Generator = class extends _bamboocss_core.Context {
 		throw new _bamboocss_shared.BambooError("UNRESOLVED_TOKEN", `${found.size} style value(s) name a token that does not exist:\n\n${detail}\n\nEach is emitted as written, which parses — so the stylesheet is valid and nothing downstream objects. The browser drops the declaration at compute time and the style is simply absent from the element, which surfaces as "this never applied" a long way from the typo that caused it. Write \`[value]\` to mark one as a literal, or set \`unresolvedToken: 'warn'\` to report these without failing.`);
 	};
 	/**
+	* The findings `warn` has already printed, keyed `property:value`.
+	*
+	* A dev server emits the sheet on every edit, and extraction is additive within a watch, so
+	* a finding that warned on every rebuild would bury the edit that introduced the next one.
+	* Per process, like the sheet it describes.
+	*/
+	reportedInvalidDeclarations = /* @__PURE__ */ new Set();
+	/**
+	* Report every declaration in the sheet just emitted that its property's grammar rejects.
+	*
+	* The other side of `assertNoUnresolvedTokens`. That one reads the *values* the source asked
+	* for; this reads what the sheet *contains*, after every utility transform, mixin and recipe
+	* has had its say — which is the only place a transform that handed a value through
+	* unchanged, or a `[…]` literal that was never valid CSS, can be seen at all. Collected by
+	* `Stylesheet.toCss`, where the finished tree exists; graded here, where the sheet is
+	* emitted.
+	*
+	* A finding the unresolved-token pass owns is left to it, whatever that pass is set to, so
+	* one mistake is one report and `unresolvedToken: 'off'` means silence rather than the same
+	* value reported in this check's voice: `display: 'flexx'` is that pass's grammar half, and
+	* would otherwise be rejected again here as the declaration it became. Keyed on the
+	* property the utility *emits*, because that is how the sheet spells it.
+	*
+	* `warn` reports each distinct declaration once per process. `error` lists everything the
+	* sheet holds each time, because each time the build is failing on it.
+	*/
+	reportInvalidDeclarations = (sheet) => {
+		const severity = this.utility.invalidDeclaration;
+		if (severity === "off") return;
+		const owned = /* @__PURE__ */ new Set();
+		for (const ref of this.utility.unresolvedTokens.values()) owned.add(`${this.utility.cssPropertyOf(ref.prop)}:${ref.value}`);
+		const id = (finding) => `${finding.prop}:${finding.value}`;
+		const findings = sheet.invalidDeclarations.filter((finding) => !owned.has(id(finding)));
+		if (!findings.length) return;
+		const describe = ({ prop, value, selector, layer, count }) => {
+			return `- \`${prop}: ${value}\`${selector ? ` in \`${selector}\`` : ""}${layer ? `, \`@layer ${layer}\`` : ""}${count > 1 ? ` (${count} rules)` : ""}`;
+		};
+		const dropped = "Each parses, so the stylesheet is valid and nothing downstream objects. The browser drops the declaration at compute time and the style is simply absent from the element.";
+		if (severity === "error") {
+			const detail = (0, _bamboocss_shared.truncateList)(findings.map(describe), {
+				limit: 25,
+				unit: "declaration",
+				separator: "\n"
+			});
+			throw new _bamboocss_shared.BambooError("INVALID_DECLARATION", `${findings.length} declaration(s) in the stylesheet are not valid CSS for their property:\n\n${detail}\n\n${dropped} Fix the value, or set \`invalidDeclaration: 'warn'\` to report these without failing.`);
+		}
+		const fresh = findings.filter((finding) => !this.reportedInvalidDeclarations.has(id(finding)));
+		if (!fresh.length) return;
+		for (const finding of fresh) this.reportedInvalidDeclarations.add(id(finding));
+		const detail = (0, _bamboocss_shared.truncateList)(fresh.map(describe), {
+			limit: 25,
+			unit: "declaration",
+			separator: "\n"
+		});
+		_bamboocss_logger.logger.warn("sheet", `${fresh.length} declaration(s) in the stylesheet are not valid CSS for their property:\n\n${detail}\n\n${dropped} Set \`invalidDeclaration: 'error'\` to fail the build on these, or \`'off'\` to stop reporting them.`);
+	};
+	/**
 	* Get CSS for a specific layer from the stylesheet
 	*/
 	getLayerCss = (sheet, layer) => {

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { Context, StyleDecoder, Stylesheet } from "@bamboocss/core";
+import { AtomOrigin, Context, StyleDecoder, Stylesheet } from "@bamboocss/core";
 import { ArtifactId, CssArtifactType, LoadConfigResult, SpecFile, SpecType, SpecTypeMap } from "@bamboocss/types";
 
 //#region src/generator.d.ts
@@ -131,6 +131,13 @@ declare class Generator extends Context {
    */
   private getAlwaysKeptTokenVars;
   getParserCss: (decoder: StyleDecoder) => string;
+  /**
+   * Each atom's first call site, by the class name the sheet writes it under.
+   *
+   * Only what the encoder recorded — see `StyleEncoder.recordOrigins` — so empty unless an
+   * integration asked for origins. Several hashes can decode to one class; the first wins.
+   */
+  getAtomOrigins: () => Map<string, AtomOrigin>;
   getCss: (stylesheet?: Stylesheet) => string;
   /**
    * Fail on a style value shaped like a token path that names no token.
@@ -192,6 +199,34 @@ declare class Generator extends Context {
    */
   reportRawValues: () => void;
   assertNoUnresolvedTokens: () => void;
+  /**
+   * The findings `warn` has already printed, keyed `property:value`.
+   *
+   * A dev server emits the sheet on every edit, and extraction is additive within a watch, so
+   * a finding that warned on every rebuild would bury the edit that introduced the next one.
+   * Per process, like the sheet it describes.
+   */
+  private reportedInvalidDeclarations;
+  /**
+   * Report every declaration in the sheet just emitted that its property's grammar rejects.
+   *
+   * The other side of `assertNoUnresolvedTokens`. That one reads the *values* the source asked
+   * for; this reads what the sheet *contains*, after every utility transform, mixin and recipe
+   * has had its say — which is the only place a transform that handed a value through
+   * unchanged, or a `[…]` literal that was never valid CSS, can be seen at all. Collected by
+   * `Stylesheet.toCss`, where the finished tree exists; graded here, where the sheet is
+   * emitted.
+   *
+   * A finding the unresolved-token pass owns is left to it, whatever that pass is set to, so
+   * one mistake is one report and `unresolvedToken: 'off'` means silence rather than the same
+   * value reported in this check's voice: `display: 'flexx'` is that pass's grammar half, and
+   * would otherwise be rejected again here as the declaration it became. Keyed on the
+   * property the utility *emits*, because that is how the sheet spells it.
+   *
+   * `warn` reports each distinct declaration once per process. `error` lists everything the
+   * sheet holds each time, because each time the build is failing on it.
+   */
+  reportInvalidDeclarations: (sheet: Stylesheet) => void;
   /**
    * Get CSS for a specific layer from the stylesheet
    */

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { Context, StyleDecoder, Stylesheet } from "@bamboocss/core";
+import { AtomOrigin, Context, StyleDecoder, Stylesheet } from "@bamboocss/core";
 import { ArtifactId, CssArtifactType, LoadConfigResult, SpecFile, SpecType, SpecTypeMap } from "@bamboocss/types";
 
 //#region src/generator.d.ts
@@ -131,6 +131,13 @@ declare class Generator extends Context {
    */
   private getAlwaysKeptTokenVars;
   getParserCss: (decoder: StyleDecoder) => string;
+  /**
+   * Each atom's first call site, by the class name the sheet writes it under.
+   *
+   * Only what the encoder recorded — see `StyleEncoder.recordOrigins` — so empty unless an
+   * integration asked for origins. Several hashes can decode to one class; the first wins.
+   */
+  getAtomOrigins: () => Map<string, AtomOrigin>;
   getCss: (stylesheet?: Stylesheet) => string;
   /**
    * Fail on a style value shaped like a token path that names no token.
@@ -192,6 +199,34 @@ declare class Generator extends Context {
    */
   reportRawValues: () => void;
   assertNoUnresolvedTokens: () => void;
+  /**
+   * The findings `warn` has already printed, keyed `property:value`.
+   *
+   * A dev server emits the sheet on every edit, and extraction is additive within a watch, so
+   * a finding that warned on every rebuild would bury the edit that introduced the next one.
+   * Per process, like the sheet it describes.
+   */
+  private reportedInvalidDeclarations;
+  /**
+   * Report every declaration in the sheet just emitted that its property's grammar rejects.
+   *
+   * The other side of `assertNoUnresolvedTokens`. That one reads the *values* the source asked
+   * for; this reads what the sheet *contains*, after every utility transform, mixin and recipe
+   * has had its say — which is the only place a transform that handed a value through
+   * unchanged, or a `[…]` literal that was never valid CSS, can be seen at all. Collected by
+   * `Stylesheet.toCss`, where the finished tree exists; graded here, where the sheet is
+   * emitted.
+   *
+   * A finding the unresolved-token pass owns is left to it, whatever that pass is set to, so
+   * one mistake is one report and `unresolvedToken: 'off'` means silence rather than the same
+   * value reported in this check's voice: `display: 'flexx'` is that pass's grammar half, and
+   * would otherwise be rejected again here as the declaration it became. Keyed on the
+   * property the utility *emits*, because that is how the sheet spells it.
+   *
+   * `warn` reports each distinct declaration once per process. `error` lists everything the
+   * sheet holds each time, because each time the build is failing on it.
+   */
+  reportInvalidDeclarations: (sheet: Stylesheet) => void;
   /**
    * Get CSS for a specific layer from the stylesheet
    */

package/dist/index.mjs

@@ -4047,14 +4047,32 @@ var Generator = class extends Context {
 	getParserCss = (decoder) => {
 		return generateParserCss(this, decoder);
 	};
+	/**
+	* Each atom's first call site, by the class name the sheet writes it under.
+	*
+	* Only what the encoder recorded — see `StyleEncoder.recordOrigins` — so empty unless an
+	* integration asked for origins. Several hashes can decode to one class; the first wins.
+	*/
+	getAtomOrigins = () => {
+		const byHash = this.encoder.atomOrigins();
+		const origins = /* @__PURE__ */ new Map();
+		if (!byHash.size) return origins;
+		for (const atom of this.decoder.collect(this.encoder).atomic) {
+			const origin = byHash.get(atom.hash);
+			if (origin && !origins.has(atom.className)) origins.set(atom.className, origin);
+		}
+		return origins;
+	};
 	getCss = (stylesheet) => {
-		let css = (stylesheet ?? this.createSheet()).toCss({ minify: this.config.minify });
+		const sheet = stylesheet ?? this.createSheet();
+		let css = sheet.toCss({ minify: this.config.minify });
 		if (this.hooks["cssgen:done"]) css = this.hooks["cssgen:done"]({
 			artifact: "styles.css",
 			content: css
 		}) ?? css;
 		this.assertNoUnresolvedTokens();
 		this.reportRawValues();
+		this.reportInvalidDeclarations(sheet);
 		return css;
 	};
 	/**
@@ -4161,6 +4179,63 @@ var Generator = class extends Context {
 		throw new BambooError("UNRESOLVED_TOKEN", `${found.size} style value(s) name a token that does not exist:\n\n${detail}\n\nEach is emitted as written, which parses — so the stylesheet is valid and nothing downstream objects. The browser drops the declaration at compute time and the style is simply absent from the element, which surfaces as "this never applied" a long way from the typo that caused it. Write \`[value]\` to mark one as a literal, or set \`unresolvedToken: 'warn'\` to report these without failing.`);
 	};
 	/**
+	* The findings `warn` has already printed, keyed `property:value`.
+	*
+	* A dev server emits the sheet on every edit, and extraction is additive within a watch, so
+	* a finding that warned on every rebuild would bury the edit that introduced the next one.
+	* Per process, like the sheet it describes.
+	*/
+	reportedInvalidDeclarations = /* @__PURE__ */ new Set();
+	/**
+	* Report every declaration in the sheet just emitted that its property's grammar rejects.
+	*
+	* The other side of `assertNoUnresolvedTokens`. That one reads the *values* the source asked
+	* for; this reads what the sheet *contains*, after every utility transform, mixin and recipe
+	* has had its say — which is the only place a transform that handed a value through
+	* unchanged, or a `[…]` literal that was never valid CSS, can be seen at all. Collected by
+	* `Stylesheet.toCss`, where the finished tree exists; graded here, where the sheet is
+	* emitted.
+	*
+	* A finding the unresolved-token pass owns is left to it, whatever that pass is set to, so
+	* one mistake is one report and `unresolvedToken: 'off'` means silence rather than the same
+	* value reported in this check's voice: `display: 'flexx'` is that pass's grammar half, and
+	* would otherwise be rejected again here as the declaration it became. Keyed on the
+	* property the utility *emits*, because that is how the sheet spells it.
+	*
+	* `warn` reports each distinct declaration once per process. `error` lists everything the
+	* sheet holds each time, because each time the build is failing on it.
+	*/
+	reportInvalidDeclarations = (sheet) => {
+		const severity = this.utility.invalidDeclaration;
+		if (severity === "off") return;
+		const owned = /* @__PURE__ */ new Set();
+		for (const ref of this.utility.unresolvedTokens.values()) owned.add(`${this.utility.cssPropertyOf(ref.prop)}:${ref.value}`);
+		const id = (finding) => `${finding.prop}:${finding.value}`;
+		const findings = sheet.invalidDeclarations.filter((finding) => !owned.has(id(finding)));
+		if (!findings.length) return;
+		const describe = ({ prop, value, selector, layer, count }) => {
+			return `- \`${prop}: ${value}\`${selector ? ` in \`${selector}\`` : ""}${layer ? `, \`@layer ${layer}\`` : ""}${count > 1 ? ` (${count} rules)` : ""}`;
+		};
+		const dropped = "Each parses, so the stylesheet is valid and nothing downstream objects. The browser drops the declaration at compute time and the style is simply absent from the element.";
+		if (severity === "error") {
+			const detail = truncateList(findings.map(describe), {
+				limit: 25,
+				unit: "declaration",
+				separator: "\n"
+			});
+			throw new BambooError("INVALID_DECLARATION", `${findings.length} declaration(s) in the stylesheet are not valid CSS for their property:\n\n${detail}\n\n${dropped} Fix the value, or set \`invalidDeclaration: 'warn'\` to report these without failing.`);
+		}
+		const fresh = findings.filter((finding) => !this.reportedInvalidDeclarations.has(id(finding)));
+		if (!fresh.length) return;
+		for (const finding of fresh) this.reportedInvalidDeclarations.add(id(finding));
+		const detail = truncateList(fresh.map(describe), {
+			limit: 25,
+			unit: "declaration",
+			separator: "\n"
+		});
+		logger.warn("sheet", `${fresh.length} declaration(s) in the stylesheet are not valid CSS for their property:\n\n${detail}\n\n${dropped} Set \`invalidDeclaration: 'error'\` to fail the build on these, or \`'off'\` to stop reporting them.`);
+	};
+	/**
 	* Get CSS for a specific layer from the stylesheet
 	*/
 	getLayerCss = (sheet, layer) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bamboocss/generator",
-  "version": "1.53.1",
+  "version": "1.54.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.53.1",
-    "@bamboocss/is-valid-prop": "^1.53.1",
-    "@bamboocss/logger": "1.53.1",
-    "@bamboocss/shared": "1.53.1",
-    "@bamboocss/token-dictionary": "1.53.1",
-    "@bamboocss/types": "1.53.1"
+    "@bamboocss/core": "1.54.0",
+    "@bamboocss/is-valid-prop": "^1.54.0",
+    "@bamboocss/logger": "1.54.0",
+    "@bamboocss/shared": "1.54.0",
+    "@bamboocss/token-dictionary": "1.54.0",
+    "@bamboocss/types": "1.54.0"
   },
   "devDependencies": {
     "@types/pluralize": "0.0.33"