pasika 0.6.1 → 0.7.1

package/README.md

@@ -191,7 +191,7 @@ Applied to `src/**/globals.css` (and other stylesheets) through `@eslint/css` wi
 | `pasika/stylesheet-ordering`      | Imports → `@custom-variant` → `:root` → `@theme` → `@utility` → `@layer base`                         |
 | `pasika/css-variable-naming`      | Background vars named `--<role>-canvas`, text vars `--<role>-ink`                                     |
 | `pasika/custom-utility-apply`     | `@utility` blocks use `@apply`                                                                        |
-| `pasika/surface-utility`          | Repeated canvas+ink combos become a named surface utility                                             |
+| `pasika/skin-utility`             | Repeated style combinations become a named skin utility                                               |
 | `pasika/theme-variable-namespace` | Utility class groups share a namespace prefix                                                         |
 | `pasika/css-entry-point` †        | One global entry, imported by one module, project CSS only in a stylesheet the entry imports directly |
 | `pasika/unused-utility`           | A custom `@utility` no source file references is reported as dead                                     |

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

@@ -109,7 +109,7 @@ declare const tailwindRules: {
     "stylesheet-ordering": _eslint_css.CSSRuleDefinition;
     "css-variable-naming": _eslint_css.CSSRuleDefinition;
     "custom-utility-apply": _eslint_css.CSSRuleDefinition;
-    "surface-utility": _eslint_css.CSSRuleDefinition;
+    "skin-utility": _eslint_css.CSSRuleDefinition;
     "theme-variable-namespace": _eslint_css.CSSRuleDefinition;
     "css-entry-point": _eslint_css.CSSRuleDefinition;
     "global-stylesheet": _eslint_css.CSSRuleDefinition;
@@ -159,7 +159,7 @@ declare const pasikaPlugin: {
         "stylesheet-ordering": _eslint_css.CSSRuleDefinition;
         "css-variable-naming": _eslint_css.CSSRuleDefinition;
         "custom-utility-apply": _eslint_css.CSSRuleDefinition;
-        "surface-utility": _eslint_css.CSSRuleDefinition;
+        "skin-utility": _eslint_css.CSSRuleDefinition;
         "theme-variable-namespace": _eslint_css.CSSRuleDefinition;
         "css-entry-point": _eslint_css.CSSRuleDefinition;
         "global-stylesheet": _eslint_css.CSSRuleDefinition;

package/dist/eslint/pasika/index.js

@@ -522,7 +522,7 @@ var noArbitraryTailwindRule = {
 };
 
 // eslint/rules/unknown-utility.ts
-import { readdirSync, readFileSync as readFileSync2, statSync } from "fs";
+import { existsSync, readdirSync, readFileSync as readFileSync2, statSync } from "fs";
 import path5 from "path";
 var PREFIX_NAMESPACES = {
   bg: ["color"],
@@ -749,6 +749,53 @@ function stylesheetFiles(dir) {
     return path5.extname(entry) === ".css" ? [entryPath] : [];
   });
 }
+function packageNameOf(specifier) {
+  if (specifier.startsWith(".") || specifier.startsWith("/")) return void 0;
+  const segments = specifier.split("/");
+  return specifier.startsWith("@") ? segments.slice(0, 2).join("/") : segments[0];
+}
+function resolvePackageStylesheet(fromFile, specifier) {
+  const packageName = packageNameOf(specifier);
+  if (!packageName || packageName === "tailwindcss") return void 0;
+  let directory = path5.dirname(fromFile);
+  while (directory !== path5.dirname(directory)) {
+    const packageRoot = path5.join(directory, "node_modules", packageName);
+    const manifestPath = path5.join(packageRoot, "package.json");
+    if (existsSync(manifestPath)) {
+      try {
+        const manifest = readFileSync2(manifestPath, "utf8");
+        const stylesheet = /"style"\s*:\s*"(?<file>[^"]+\.css)"/.exec(manifest)?.groups?.file;
+        const main = /"main"\s*:\s*"(?<file>[^"]+\.css)"/.exec(manifest)?.groups?.file;
+        const target = stylesheet ?? main;
+        if (!target) return void 0;
+        const resolved = path5.resolve(packageRoot, target);
+        return existsSync(resolved) ? resolved : void 0;
+      } catch {
+        return void 0;
+      }
+    }
+    directory = path5.dirname(directory);
+  }
+  return void 0;
+}
+function inventoryStylesheetFiles(projectFiles) {
+  const files = new Set(projectFiles);
+  for (const file of projectFiles) {
+    let css2;
+    try {
+      css2 = readFileSync2(file, "utf8");
+    } catch {
+      continue;
+    }
+    for (const match of css2.matchAll(/@import\s+(?:url\(\s*)?["'](?<specifier>[^"']+)["']/gi)) {
+      const specifier = match.groups?.specifier;
+      if (!specifier) continue;
+      const imported = resolvePackageStylesheet(file, specifier);
+      if (imported) files.add(imported);
+    }
+  }
+  return [...files];
+}
 function themeBlocks(css2) {
   const blocks = [];
   let index = 0;
@@ -794,6 +841,7 @@ function classSelectors(css2) {
 }
 function readInventory(files) {
   const utilities = /* @__PURE__ */ new Set();
+  const wildcardUtilities = /* @__PURE__ */ new Set();
   const utilityPrefixes = /* @__PURE__ */ new Set();
   const themeTokensByNamespace = /* @__PURE__ */ new Map();
   const plainClasses = /* @__PURE__ */ new Set();
@@ -805,9 +853,10 @@ function readInventory(files) {
     } catch {
       continue;
     }
-    for (const name of css2.matchAll(/@utility\s+(?<utilityName>[a-zA-Z0-9_-]+)/g)) {
+    for (const name of css2.matchAll(/@utility\s+(?<utilityName>[a-zA-Z0-9_*-]+)/g)) {
       const utilityName = name.groups?.utilityName;
       if (!utilityName) continue;
+      if (utilityName.endsWith("-*")) wildcardUtilities.add(utilityName.slice(0, -1));
       utilities.add(utilityName);
       const dash = utilityName.indexOf("-");
       if (dash > 0) utilityPrefixes.add(utilityName.slice(0, dash));
@@ -828,7 +877,14 @@ function readInventory(files) {
       }
     }
   }
-  return { utilities, utilityPrefixes, themeTokens: themeTokensByNamespace, defaultsReset, plainClasses };
+  return {
+    utilities,
+    wildcardUtilities,
+    utilityPrefixes,
+    themeTokens: themeTokensByNamespace,
+    defaultsReset,
+    plainClasses
+  };
 }
 function isColorToken(token, inventory) {
   if (inventory.themeTokens.get("color")?.has(token)) return true;
@@ -852,6 +908,7 @@ function isKnown(className, inventory) {
   const token = compound ? utility.slice(compound.length + 1) : utility.slice(dash + 1);
   if (!token) return true;
   if (inventory.utilities.has(utility)) return true;
+  if ([...inventory.wildcardUtilities].some((wildcardPrefix) => utility.startsWith(wildcardPrefix))) return true;
   const namespaces = PREFIX_NAMESPACES[prefix];
   if (!namespaces) {
     if (STATIC_VALUE_TOKENS[prefix]?.includes(token)) return true;
@@ -890,7 +947,7 @@ var unknownUtilityRule = {
     let inventory;
     try {
       if (!statSync(sourceRoot).isDirectory()) return {};
-      inventory = readInventory(stylesheetFiles(sourceRoot));
+      inventory = readInventory(inventoryStylesheetFiles(stylesheetFiles(sourceRoot)));
     } catch {
       return {};
     }
@@ -3681,11 +3738,7 @@ function combosFor(index) {
   const files = [...index.modules.keys()].filter((file) => file.endsWith(".tsx") || file.endsWith(".jsx")).sort((left, right) => left.localeCompare(right));
   let fingerprint2 = "";
   for (const file of files) {
-    try {
-      fingerprint2 += String(statSync3(file).mtimeMs);
-    } catch {
-      fingerprint2 += "0";
-    }
+    fingerprint2 += String(statSync3(file).mtimeMs);
   }
   if (comboCache?.sourceRoot === index.sourceRoot && comboCache.fingerprint === fingerprint2) {
     return comboCache.combos;
@@ -3710,7 +3763,7 @@ var sharedStyleDedupRule = {
     schema: [],
     type: "problem",
     docs: {
-      description: "Require a className combination used by two or more components to become a named custom utility."
+      description: "Require a className combination used by two or more components to become a named *-skin utility."
     }
   },
   create(context) {
@@ -3729,7 +3782,7 @@ var sharedStyleDedupRule = {
           context.report({
             node,
             loc: { line: 1, column: 0 },
-            message: `Class combination "${combo}" is used by ${String(users.size)} components and should change together; create a named custom Tailwind utility for it. See docs/next-tailwind-guide/rules/theme-and-utility-definition-rule.md`
+            message: `Class combination "${combo}" is used by ${String(users.size)} components and should change together; create a named *-skin Tailwind utility for it. See docs/next-tailwind-guide/rules/theme-and-utility-definition-rule.md`
           });
         }
       }
@@ -5019,7 +5072,7 @@ var glossaryTermLinkingRule = {
 };
 
 // eslint/rules/documentation/guide-mentions-documents.ts
-import { existsSync } from "fs";
+import { existsSync as existsSync2 } from "fs";
 import path43 from "path";
 function visitSteps3(node, check) {
   if (node.type === "list" && node.ordered) {
@@ -5086,7 +5139,7 @@ var guideMentionsDocumentsRule = {
           const target = linkTarget(link.url);
           if (!target.endsWith(".md")) continue;
           const resolved = path43.normalize(path43.join(guideDir, target));
-          if (!existsSync(resolved)) {
+          if (!existsSync2(resolved)) {
             context.report({
               node: link,
               message: `Guide links a document that does not exist: ${link.url}`
@@ -5441,12 +5494,45 @@ var stylesheetOrderingRule = {
 };
 
 // eslint/rules/tailwind/css-variable-naming.ts
+var EDGE_PROPERTY_WORDS = /* @__PURE__ */ new Set(["border", "outline", "ring", "stroke"]);
+var NON_COLOR_WORDS = /* @__PURE__ */ new Set(["height", "leading", "offset", "radius", "size", "spacing", "style", "width"]);
+var TAILWIND_THEME_NAMESPACES = /* @__PURE__ */ new Set([
+  "animate",
+  "aspect",
+  "blur",
+  "breakpoint",
+  "color",
+  "container",
+  "drop",
+  "ease",
+  "font",
+  "inset",
+  "leading",
+  "perspective",
+  "radius",
+  "shadow",
+  "spacing",
+  "text",
+  "tracking"
+]);
+function isTailwindThemeVariable(property) {
+  const namespace = property.slice(2).split("-")[0];
+  return namespace !== void 0 && TAILWIND_THEME_NAMESPACES.has(namespace);
+}
+function looksLikeEdgeColor(lower) {
+  const words = lower.slice(2).split("-");
+  return words.some((word) => EDGE_PROPERTY_WORDS.has(word)) && !words.some((word) => NON_COLOR_WORDS.has(word));
+}
+function looksLikeTextColor(lower) {
+  const words = lower.slice(2).split("-");
+  return words.includes("text") && !words.some((word) => NON_COLOR_WORDS.has(word));
+}
 var cssVariableNamingRule = {
   meta: {
     schema: [],
     type: "problem",
     docs: {
-      description: "Require background variables to end in -canvas and text variables to end in -ink."
+      description: "Require property-specific color variables to use canvas, ink, and edge role suffixes."
     }
   },
   create(context) {
@@ -5454,6 +5540,7 @@ var cssVariableNamingRule = {
       Declaration(node) {
         const property = node.property;
         if (!property.startsWith("--")) return;
+        if (isTailwindThemeVariable(property)) return;
         const lower = property.toLowerCase();
         if ((lower.includes("bg") || lower.includes("background")) && !lower.endsWith("-canvas")) {
           context.report({
@@ -5461,12 +5548,18 @@ var cssVariableNamingRule = {
             message: `CSS variable "${property}" looks like a background token; name it --<role>-canvas instead.`
           });
         }
-        if (lower.includes("text") && !lower.endsWith("-ink")) {
+        if (looksLikeTextColor(lower) && !lower.endsWith("-ink")) {
           context.report({
             node,
             message: `CSS variable "${property}" looks like a text token; name it --<role>-ink instead.`
           });
         }
+        if (looksLikeEdgeColor(lower) && !lower.endsWith("-edge")) {
+          context.report({
+            node,
+            message: `CSS variable "${property}" looks like a boundary token; name it --<role>-edge instead.`
+          });
+        }
       }
     };
   }
@@ -5514,24 +5607,31 @@ var customUtilityApplyRule = {
   }
 };
 
-// eslint/rules/tailwind/surface-utility.ts
-var surfaceUtilityRule = {
+// eslint/rules/tailwind/skin-utility.ts
+var skinUtilityRule = {
   meta: {
     schema: [],
     type: "problem",
     docs: {
-      description: "Require repeated canvas+ink combinations to become a *-surface utility."
+      description: "Require reusable style combinations to become *-skin utilities."
     }
   },
   create(context) {
     return {
       "StyleSheet:exit"(node) {
+        for (const utility of atrulesNamed(node, "utility")) {
+          const name = preludeIdentifiers(utility)[0];
+          const applied = new Set(atrulesNamed(utility, "apply").flatMap((apply) => preludeIdentifiers(apply)));
+          if (applied.size < 2 || name?.endsWith("-skin") === true) continue;
+          context.report({
+            node: utility,
+            message: `Custom utility "${name ?? "unknown"}" combines ${String(applied.size)} styles; use the *-skin suffix.`
+          });
+        }
         const combinations = /* @__PURE__ */ new Map();
         for (const apply of atrulesNamed(node, "apply")) {
           const classes = preludeIdentifiers(apply);
-          if (!classes.some((name) => name.includes("canvas")) || !classes.some((name) => name.includes("ink"))) {
-            continue;
-          }
+          if (new Set(classes).size < 2) continue;
           const key = [...classes].sort().join(" ");
           combinations.set(key, (combinations.get(key) ?? 0) + 1);
         }
@@ -5539,7 +5639,7 @@ var surfaceUtilityRule = {
           if (count < 2) continue;
           context.report({
             node,
-            message: `Combination "${combo}" appears ${String(count)} times. Create a *-surface custom Tailwind utility for it.`
+            message: `Combination "${combo}" appears ${String(count)} times. Create a *-skin custom Tailwind utility for it.`
           });
         }
       }
@@ -5839,7 +5939,7 @@ var tailwindRules = {
   "stylesheet-ordering": stylesheetOrderingRule,
   "css-variable-naming": cssVariableNamingRule,
   "custom-utility-apply": customUtilityApplyRule,
-  "surface-utility": surfaceUtilityRule,
+  "skin-utility": skinUtilityRule,
   "theme-variable-namespace": themeVariableNamespaceRule,
   "css-entry-point": cssEntryPointRule,
   "global-stylesheet": globalStylesheetRule,
@@ -6083,7 +6183,7 @@ var nextjsStackRule = {
 };
 
 // eslint/rules/package-json/vitest-coverage.ts
-import { existsSync as existsSync2, readFileSync as readFileSync9 } from "fs";
+import { existsSync as existsSync3, readFileSync as readFileSync9 } from "fs";
 import path47 from "path";
 function memberName5(member) {
   return member.name.type === "String" ? member.name.value : member.name.name;
@@ -6159,7 +6259,7 @@ var vitestCoverageRule = {
             message: 'package.json must declare a "test:unit:coverage" script that runs Vitest with coverage.'
           });
         }
-        const configName = VITEST_CONFIG_NAMES.find((name) => existsSync2(path47.join(context.cwd, name)));
+        const configName = VITEST_CONFIG_NAMES.find((name) => existsSync3(path47.join(context.cwd, name)));
         if (!configName) {
           context.report({
             node,
@@ -6224,7 +6324,7 @@ var nextjsPackageJsonRules = {
 };
 
 // eslint/rules/husky/husky-hook.ts
-import { existsSync as existsSync3, readFileSync as readFileSync10 } from "fs";
+import { existsSync as existsSync4, readFileSync as readFileSync10 } from "fs";
 import path48 from "path";
 function memberName6(member) {
   return member.name.type === "String" ? member.name.value : member.name.name;
@@ -6244,7 +6344,7 @@ var huskyHookRule = {
         if (root.type !== "Object") return;
         if (!context.filename.endsWith("package.json")) return;
         const hookPath = path48.join(context.cwd, ".husky", "pre-commit");
-        if (!existsSync3(hookPath)) {
+        if (!existsSync4(hookPath)) {
           context.report({
             node,
             message: "No .husky/pre-commit hook found. Configure husky to run checks before commits."
@@ -6270,7 +6370,7 @@ var huskyHookRule = {
           context.report({ node, message: ".husky/pre-commit must run npx libyear --limit-major-individual=1." });
         }
         const suppressionsPath = path48.join(context.cwd, "eslint-suppressions.json");
-        if (existsSync3(suppressionsPath)) {
+        if (existsSync4(suppressionsPath)) {
           requireNamedScript("lint:prune");
         }
         if (scripts?.value.type === "Object") {
@@ -6293,7 +6393,7 @@ var huskyRules = {
 };
 
 // eslint/rules/vulyk/vulyk-docs.ts
-import { existsSync as existsSync4, readFileSync as readFileSync11 } from "fs";
+import { existsSync as existsSync5, readFileSync as readFileSync11 } from "fs";
 import path49 from "path";
 var PASIKA_REPO = "Bredansky/pasika";
 var BASE_REQUIRED_DOCS = [
@@ -6329,7 +6429,7 @@ var vulykDocsRule = {
         if (root.type !== "Object") return;
         const projectRoot = path49.dirname(path49.resolve(context.filename));
         const configPath = path49.join(projectRoot, "vulyk.config.ts");
-        if (!existsSync4(configPath)) {
+        if (!existsSync5(configPath)) {
           context.report({
             node,
             message: "No vulyk.config.ts found. Run npx vulyk@latest init to create one that tracks the framework's docs."
@@ -6354,7 +6454,7 @@ var vulykDocsRule = {
           }
         }
         const agentsPath = path49.join(projectRoot, "AGENTS.md");
-        if (!existsSync4(agentsPath)) {
+        if (!existsSync5(agentsPath)) {
           context.report({
             node,
             message: "No AGENTS.md found. Run npx vulyk@latest agents to generate the agent file that routes to the tracked docs."

package/package.json

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