pasika 0.10.131 → 0.10.133

package/dist/eslint/pasika/index.d.ts

@@ -120,6 +120,7 @@ declare const nextjsPackageJsonRules: {
 };
 
 declare const tailwindRules: {
+    "at-rule-spacing": _eslint_css.CSSRuleDefinition;
     "theme-reset": _eslint_css.CSSRuleDefinition;
     "theme-mode": _eslint_css.CSSRuleDefinition;
     "color-role-usage": _eslint_css.CSSRuleDefinition;
@@ -161,6 +162,7 @@ declare const pasikaPlugin: {
         "exact-version": _eslint_json.JSONRuleDefinition;
         "lint-setup": _eslint_json.JSONRuleDefinition;
         "vitest-coverage": _eslint_json.JSONRuleDefinition;
+        "at-rule-spacing": _eslint_css.CSSRuleDefinition;
         "theme-reset": _eslint_css.CSSRuleDefinition;
         "theme-mode": _eslint_css.CSSRuleDefinition;
         "color-role-usage": _eslint_css.CSSRuleDefinition;

package/dist/eslint/pasika/index.js

@@ -9720,6 +9720,46 @@ var applyUsageRule = {
   }
 };
 
+// eslint/rules/tailwind/at-rule-spacing.ts
+var EMPTY_LINE = /\n[ \t]*\n/u;
+var LINE_BREAK = /\r\n|\n|\r/u;
+var atRuleSpacingRule = {
+  meta: {
+    schema: [],
+    type: "layout",
+    fixable: "whitespace",
+    docs: {
+      description: "Require a blank line between adjacent top-level CSS at-rules, excluding grouped imports."
+    }
+  },
+  create(context) {
+    return {
+      "StyleSheet:exit"(node) {
+        const source = context.sourceCode.text;
+        const newline = source.includes("\r\n") ? "\r\n" : "\n";
+        for (let index = 1; index < node.children.length; index += 1) {
+          const previous = node.children[index - 1];
+          const current = node.children[index];
+          if (previous?.type !== "Atrule" || current?.type !== "Atrule") continue;
+          if (previous.name === "import" && current.name === "import") continue;
+          if (!previous.loc || !current.loc) continue;
+          const start = previous.loc.end.offset;
+          const end = current.loc.start.offset;
+          const between = source.slice(start, end);
+          if (EMPTY_LINE.test(between.replace(/\r\n|\r/gu, "\n"))) continue;
+          context.report({
+            node: current,
+            message: "Adjacent top-level @ rules must have a blank line between them.",
+            fix(fixer) {
+              return fixer.insertTextBeforeRange([end, end], LINE_BREAK.test(between) ? newline : newline + newline);
+            }
+          });
+        }
+      }
+    };
+  }
+};
+
 // eslint/rules/tailwind/base-layer-pair.ts
 import { existsSync as existsSync8 } from "fs";
 import path66 from "path";
@@ -11542,6 +11582,27 @@ function singleCssFunction(value) {
   const args = value.slice(match[0].length, -1).trim();
   return args ? { name, args } : void 0;
 }
+function gradientOnlyBackground(value) {
+  if (!value || /[;{}'"\\]/u.test(value)) return false;
+  const layers = [];
+  let depth = 0;
+  let start = 0;
+  for (let index = 0; index < value.length; index++) {
+    if (value[index] === "(") depth++;
+    if (value[index] === ")") depth--;
+    if (depth < 0) return false;
+    if (value[index] === "," && depth === 0) {
+      layers.push(value.slice(start, index).trim());
+      start = index + 1;
+    }
+  }
+  if (depth !== 0) return false;
+  layers.push(value.slice(start).trim());
+  return layers.every((layer) => {
+    const fn = singleCssFunction(layer);
+    return fn !== void 0 && /^(?:repeating-)?(?:linear|radial|conic)-gradient$/u.test(fn.name);
+  });
+}
 function boxShadowNamespace(value) {
   const layers = [];
   let depth = 0;
@@ -11604,7 +11665,9 @@ function themeCandidate(name, utilityText) {
   if (!cssValue) return void 0;
   const namedOperation = arbitraryApply?.groups?.prefix ? arbitraryApplyOperation(arbitraryApply.groups.prefix, cssValue) : void 0;
   if (arbitraryApply && !namedOperation) return void 0;
-  const property = arbitrary?.groups?.property ?? direct?.groups?.property ?? namedOperation?.property;
+  const declaredProperty = arbitrary?.groups?.property ?? direct?.groups?.property ?? namedOperation?.property;
+  const gradientShorthand = declaredProperty === "background" && gradientOnlyBackground(cssValue);
+  const property = gradientShorthand ? "background-image" : declaredProperty;
   const functionValue = property === "filter" || property === "backdrop-filter" ? singleCssFunction(cssValue) : void 0;
   const shadowNamespace = property === "box-shadow" ? boxShadowNamespace(cssValue) : void 0;
   if (property === "box-shadow" && !shadowNamespace) return void 0;
@@ -11640,7 +11703,8 @@ function themeCandidate(name, utilityText) {
     value,
     prefix: matched.prefix,
     namespace: matched.namespace,
-    probe: Boolean(arbitraryApply) || matched.property === "transition-property"
+    probe: Boolean(arbitraryApply) || matched.property === "transition-property",
+    gradientShorthand
   };
 }
 var builtInTextSizes = /* @__PURE__ */ new Set([
@@ -11679,6 +11743,9 @@ function isTypographySize(name) {
   return /^--text-(?!.*--)(?:[a-z0-9]+-)*[a-z0-9]+$/u.test(name);
 }
 function suggestedThemeToken(candidate) {
+  if (candidate.namespace === "background-image") {
+    return candidate.token.endsWith("-canvas") ? candidate.token : `${candidate.token}-canvas`;
+  }
   if (candidate.namespace !== "color") return candidate.token;
   let role = "edge";
   if (["bg", "fill"].includes(candidate.prefix)) {
@@ -11696,7 +11763,8 @@ function themeMigrationGuidance(candidate, utilityName) {
   const runtimeDependent = /\bvar\s*\(/iu.test(candidate.value);
   const action = runtimeDependent ? `only use a self-named @theme inline token "${token}" with an unconditional :root default and a detected runtime override; otherwise resolve the fixed value directly in @theme. ` : `define a direct @theme token "${token}" with value "${candidate.value}" rather than adding a :root bridge. `;
   const classGuidance = generatedClass === utilityName ? "Preserve the generated class name" : `Update class usages to "${generatedClass}"`;
-  return `${action}${classGuidance} and compare compiled CSS before removing the utility.`;
+  const resetWarning = candidate.gradientShorthand ? " Replacing the background shorthand with background-image stops resetting other background properties; verify cascade and rendering." : "";
+  return `${action}${classGuidance} and compare compiled CSS before removing the utility.${resetWarning}`;
 }
 var utilityMappingRule = {
   meta: {
@@ -11889,7 +11957,7 @@ var utilityMappingRule = {
           if (candidate && equivalent && nameCounts.get(name) === 1) {
             context.report({
               node: utility,
-              message: `Custom utility "${name}" duplicates theme-generated "${equivalent}" (${candidate.property}: ${candidate.value}); reuse "${equivalent}" instead.`
+              message: `Custom utility "${name}" duplicates theme-generated "${equivalent}" (${candidate.property}: ${candidate.value}); reuse "${equivalent}" instead.${candidate.gradientShorthand ? " Check background shorthand reset behavior before switching to background-image." : ""}`
             });
             continue;
           }
@@ -11905,7 +11973,7 @@ var utilityMappingRule = {
           if (!candidate.token) {
             context.report({
               node: utility,
-              message: `Custom utility "${name}" only maps ${candidate.property} (${candidate.value}); define an @theme token in the "--${candidate.namespace}-*" namespace and use its generated "${candidate.prefix}-*" class instead.${candidate.property === "box-shadow" ? " Compare compiled CSS and ring/inset-shadow composition before migration." : ""}`
+              message: `Custom utility "${name}" only maps ${candidate.property} (${candidate.value}); define ${candidate.gradientShorthand ? "a semantic" : "an"} @theme token in the "--${candidate.namespace}-*${candidate.gradientShorthand ? "-canvas" : ""}" namespace and use its generated "${candidate.prefix}-*" class instead.${candidate.property === "box-shadow" ? " Compare compiled CSS and ring/inset-shadow composition before migration." : ""}${candidate.gradientShorthand ? " Check background shorthand reset behavior before switching to background-image." : ""}`
             });
             continue;
           }
@@ -11972,7 +12040,6 @@ var utilityMappingRule = {
 
 // eslint/rules/tailwind/utility-name-parity.ts
 import { spawnSync as spawnSync2 } from "child_process";
-import { createHash } from "crypto";
 import { existsSync as existsSync13 } from "fs";
 import path80 from "path";
 import { generate as generate7, parse as parse7, toPlainObject as toPlainObject2 } from "@eslint/css-tree";
@@ -12014,14 +12081,6 @@ function readableValue(value) {
   const slug = parts.join("-");
   return slug.length <= 70 ? slug : void 0;
 }
-function compoundValue(value) {
-  const readable = readableValue(value);
-  if (readable) return readable;
-  const candidate = /^(?<fn>[a-z][a-z0-9-]*)\(/iu.exec(value.trim())?.groups?.fn?.toLowerCase();
-  const hint = candidate?.endsWith("-") ? void 0 : candidate;
-  const digest = createHash("sha256").update(value.trim()).digest("hex").slice(0, 12);
-  return [hint, "hash", digest].filter(Boolean).join("-");
-}
 var TAILWIND_WORKER = String.raw`
 import { readFileSync } from "node:fs";
 import { compile } from "tailwindcss";
@@ -12095,7 +12154,8 @@ function compiledOperation(compiled, index) {
   return { property: declaration.property, value: generate7(declaration.value).trim() };
 }
 function expectedName(operation) {
-  const value = compoundValue(operation.value);
+  const value = readableValue(operation.value);
+  if (!value) return void 0;
   const property = operation.property.replace(/^-+/u, "").replace(/^background-/u, "bg-");
   return `${property}-${value}`;
 }
@@ -12111,7 +12171,7 @@ var utilityNameParityRule = {
     schema: [],
     type: "problem",
     docs: {
-      description: "Require single-operation custom utilities to have deterministic property/value-derived names."
+      description: "Use property/value-derived names for readable values and semantic names for complex values."
     }
   },
   create(context) {
@@ -12141,6 +12201,15 @@ var utilityNameParityRule = {
             continue;
           }
           const expected = expectedName(operation);
+          if (!expected) {
+            if (/-hash-[a-f0-9]{12}$/u.test(candidate.name)) {
+              context.report({
+                node: candidate.utility,
+                message: `Custom utility "${candidate.name}" uses an opaque hash for a complex ${operation.property} value; use a semantic name, or prefer a theme-generated utility where supported.`
+              });
+            }
+            continue;
+          }
           if (candidate.name === expected) continue;
           context.report({
             node: candidate.utility,
@@ -12154,6 +12223,7 @@ var utilityNameParityRule = {
 
 // eslint/rules/tailwind/index.ts
 var tailwindRules = {
+  "at-rule-spacing": atRuleSpacingRule,
   "theme-reset": themeResetRule,
   "theme-mode": themeModeRule,
   "color-role-usage": colorRoleUsageRule,
@@ -13563,6 +13633,7 @@ var tailwindImportGraph = {
   language: "css/css",
   languageOptions: { tolerant: true },
   rules: {
+    "pasika/at-rule-spacing": "error",
     "pasika/css-entry-point": "error",
     "pasika/feature-css-placement": "error",
     "pasika/unique-css-definition": "error",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pasika",
-  "version": "0.10.131",
+  "version": "0.10.133",
   "description": "Reusable agent setup package",
   "repository": {
     "type": "git",