@botiverse/raft-ui 0.77.0 → 0.78.0

package/CHANGELOG.md

@@ -1,3 +1,21 @@
+## [0.78.0](https://github.com/botiverse/raft-design/compare/v0.77.1...v0.78.0) (2026-11-08)
+
+### Changed
+
+- **`raft-ui/prefer-scroll-area` also reads class lists kept in a const and a `className` property**: a native-scrolling class in a `const` of the same file is reported when the const is used as a class there (`const log = "max-h-64 overflow-auto"`, then `className={log}` or `cn(log)`), wherever in the file it is declared; and so is one in a `className`, `class` or `*ClassName` property, such as a recipe slot's option (`content({ className: "overflow-y-auto" })`). The escape comment works on them as before. ([#1078](https://github.com/botiverse/raft-design/pull/1078))
+  - Why: apps keep many class lists in consts; Stamp's port of the rule found four native scrollers this way that the rule missed (Kirby, #proj-raft-ui:#209).
+  - Affects: upgrading can report scrollers the rule didn't see before; fix them, or mark an allowed exception. The Raft app gets one, the onboarding form panel (`ONBOARDING_CREATE_FORM_PANEL_CLASS`); its desktop app none. A string in a const that is never used as a class is still not reported.
+  - Docs: https://raft-design.botiverse.build/about/use-raft-ui/#lint-rules
+
+## [0.77.1](https://github.com/botiverse/raft-design/compare/v0.77.0...v0.77.1) (2026-11-08)
+
+### Fixed
+
+- **The lint plugin's recommended config keeps the app's own Oxlint plugins**: `recommended.json` sets `"plugins": []`. ([#1076](https://github.com/botiverse/raft-design/pull/1076))
+  - Why: an extended config without `plugins` counts as Oxlint's default plugins, so extending it turned `unicorn` back on in an app that lists its plugins without it (36 new warnings in slock, Kirby, #proj-raft-ui:#209). Same on Oxlint 1.85, 1.87 and 1.91.
+  - Affects: an app that extends `recommended.json` keeps exactly the `plugins` it lists; an app that lists none keeps Oxlint's defaults, as before. The ESLint config is unchanged.
+  - Docs: https://raft-design.botiverse.build/about/use-raft-ui/#lint-rules
+
 ## [0.77.0](https://github.com/botiverse/raft-design/compare/v0.76.1...v0.77.0) (2026-11-08)
 
 ### Changed

package/dist/lint/prefer-scroll-area.d.mts

@@ -9,8 +9,13 @@
  *   set to auto or scroll, with any variant prefix, `!`, or as an arbitrary
  *   property) in a string or template literal that is a class: the value of a
  *   `className`, `class` or `*ClassName` JSX attribute, or an argument of
- *   `cn`, `clsx`, `cx`, `tv`, `cva`, `twMerge`, `twJoin` or `classNames`,
- *   through conditionals, `&&`, arrays, objects (keys and values) and `+`;
+ *   `cn`, `clsx`, `cx`, `tv`, `cva`, `twMerge`, `twJoin` or `classNames`, or
+ *   a `className`, `class` or `*ClassName` property (a recipe slot's option,
+ *   `content({ className: "…" })`), through conditionals, `&&`, arrays,
+ *   objects (keys and values) and `+`;
+ * - such a string in a `const` of the same file that is used as a class
+ *   (`const log = "max-h-64 …"`, then `className={log}` or
+ *   `cn(log)`), wherever in the file it is declared;
  * - an inline `style={{ overflow | overflowX | overflowY: "auto" | "scroll" }}`.
  *
  * Allowed with a `raft-ui: native-scroll <reason>` comment, line or block, on
@@ -20,8 +25,9 @@
  * still reported. For an inline style, the line of its property. A comment
  * without a reason doesn't count.
  *
- * It looks only at literals, with no scope or type information: a class built
- * in a variable outside these calls isn't seen.
+ * It reads the file as written, with no scope or type information: a const is
+ * matched by its name in the same file, and a class in a `let`, an import, a
+ * member (`styles.log`) or a function's return isn't seen.
  */
 export interface Position {
   line: number;

package/dist/lint/prefer-scroll-area.mjs

@@ -34,6 +34,7 @@ const PASS_THROUGH = /* @__PURE__ */ new Set([
 	"TSNonNullExpression",
 	"TSSatisfiesExpression"
 ]);
+const INIT_THROUGH = /* @__PURE__ */ new Set([...PASS_THROUGH, "CallExpression"]);
 const ESCAPE = /\braft-ui:\s*native-scroll\s+\S/;
 /** Whether a class string has a native-scrolling class in it. */
 function hasNativeScrollClass(value) {
@@ -44,7 +45,7 @@ function attributeName(node) {
 	const name = node.name;
 	return name?.type === "JSXIdentifier" ? name.name : void 0;
 }
-/** The attribute or call that makes a string a class, or undefined when it isn't one. */
+/** The attribute, call or property that makes a node a class, or undefined when it isn't one. */
 function classContext(node) {
 	let child = node;
 	let parent = node.parent;
@@ -57,11 +58,28 @@ function classContext(node) {
 			const callee = parent.callee;
 			return callee.type === "Identifier" && CLASS_FUNCTIONS.has(callee.name) && parent.arguments.includes(child) ? parent : void 0;
 		}
+		if (parent.type === "Property" && parent.value === child) {
+			const key = propertyKey(parent);
+			if (key !== void 0 && CLASS_ATTRIBUTE.test(key)) return parent;
+		}
 		if (!PASS_THROUGH.has(parent.type)) return void 0;
 		child = parent;
 		parent = parent.parent;
 	}
 }
+/** The `const` declarator whose initializer holds `node` (through conditionals, arrays, calls), if any. */
+function constDeclarator(node) {
+	let parent = node.parent;
+	while (parent) {
+		if (parent.type === "VariableDeclarator") {
+			const id = parent.id;
+			const declaration = parent.parent;
+			return id?.type === "Identifier" && declaration?.kind === "const" ? parent : void 0;
+		}
+		if (!INIT_THROUGH.has(parent.type)) return void 0;
+		parent = parent.parent;
+	}
+}
 function stringValue(node) {
 	if (node.type === "Literal" && typeof node.value === "string") return node.value;
 	if (node.type === "TemplateLiteral" && node.expressions.length === 0) {
@@ -127,9 +145,15 @@ const preferScrollArea = {
 				messageId: "preferScrollArea"
 			});
 		}
+		const constStrings = /* @__PURE__ */ new Map();
+		const classNames = /* @__PURE__ */ new Set();
 		function checkClassString(node, value) {
 			if (!hasNativeScrollClass(value)) return;
-			if (classContext(node)) report(node, node);
+			if (classContext(node)) return report(node, node);
+			const declarator = constDeclarator(node);
+			if (!declarator) return;
+			const name = declarator.id.name;
+			constStrings.set(name, [...constStrings.get(name) ?? [], node]);
 		}
 		return {
 			Literal(node) {
@@ -138,6 +162,11 @@ const preferScrollArea = {
 			TemplateLiteral(node) {
 				checkClassString(node, node.quasis.map((quasi) => quasi.value.raw).join(" "));
 			},
+			Identifier(node) {
+				const parent = node.parent;
+				if (parent?.type === "Property" && parent.key === node && !parent.computed && !parent.shorthand) return;
+				if (classContext(node)) classNames.add(node.name);
+			},
 			JSXAttribute(node) {
 				if (attributeName(node) !== "style") return;
 				const value = node.value;
@@ -149,6 +178,9 @@ const preferScrollArea = {
 					if (key === void 0 || !NATIVE_SCROLL_STYLE_KEYS.has(key)) continue;
 					for (const literal of styleValueStrings(property.value, [])) if (NATIVE_SCROLL_STYLE_VALUES.has(stringValue(literal).trim())) report(literal, property);
 				}
+			},
+			"Program:exit"() {
+				for (const name of classNames) for (const node of constStrings.get(name) ?? []) report(node, node);
 			}
 		};
 	}

package/dist/lint/recommended.json

@@ -1,4 +1,5 @@
 {
+  "plugins": [],
   "jsPlugins": ["@botiverse/raft-ui/lint"],
   "rules": {
     "raft-ui/prefer-scroll-area": "error"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botiverse/raft-ui",
-  "version": "0.77.0",
+  "version": "0.78.0",
   "description": "React components and CSS foundations for the Raft Design System.",
   "keywords": [
     "agent-skills",