pasika 0.10.121 → 0.10.123

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

@@ -136,7 +136,6 @@ declare const tailwindRules: {
     "unique-css-definition": _eslint_css.CSSRuleDefinition;
     "unique-css-token-value": _eslint_css.CSSRuleDefinition;
     "no-utility-alias": _eslint_css.CSSRuleDefinition;
-    "global-selector-styling": _eslint_css.CSSRuleDefinition;
 };
 
 declare const vulykRules: {
@@ -177,7 +176,6 @@ declare const pasikaPlugin: {
         "unique-css-definition": _eslint_css.CSSRuleDefinition;
         "unique-css-token-value": _eslint_css.CSSRuleDefinition;
         "no-utility-alias": _eslint_css.CSSRuleDefinition;
-        "global-selector-styling": _eslint_css.CSSRuleDefinition;
         "doc-kind-suffix": _eslint_markdown.MarkdownRuleDefinition;
         "title-matches-file-name": _eslint_markdown.MarkdownRuleDefinition;
         overview: _eslint_markdown.MarkdownRuleDefinition;

package/dist/eslint/pasika/index.js

@@ -9671,17 +9671,19 @@ function selectorNames(node) {
 }
 
 // eslint/rules/tailwind/apply-usage.ts
-function reportRawDeclarations(context, rule) {
+function reportRawDeclarations(context, rule, insideBase) {
   for (const child of blockChildren2(rule)) {
     if (child.type === "Declaration") {
-      if (child.property.startsWith("--")) continue;
+      if (!insideBase && child.property.startsWith("--")) continue;
       context.report({
         node: child,
-        message: `Style declaration "${child.property}" inside a global selector must use @apply.`
+        message: insideBase ? `Global selectors inside @layer base may only contain @apply directives; found "${child.property}".` : `Style declaration "${child.property}" inside a global selector must use @apply.`
       });
       continue;
     }
-    if (child.type === "Rule") reportRawDeclarations(context, child);
+    if (child.type === "Rule" || child.type === "Atrule" && child.name !== "apply") {
+      reportRawDeclarations(context, child, insideBase);
+    }
   }
 }
 var applyUsageRule = {
@@ -9689,19 +9691,25 @@ var applyUsageRule = {
     schema: [],
     type: "problem",
     docs: {
-      description: "Require @apply for project style declarations inside global selectors."
+      description: "Require only @apply directives in global selectors inside @layer base."
     }
   },
   create(context) {
     return {
       "StyleSheet:exit"(node) {
-        for (const child of node.children) {
-          if (child.type === "Rule") reportRawDeclarations(context, child);
-          if (child.type !== "Atrule" || child.name !== "layer") continue;
-          for (const layered of blockChildren2(child)) {
-            if (layered.type === "Rule") reportRawDeclarations(context, layered);
+        function visit(current, insideBase = false) {
+          if (current.type === "Atrule" && ["theme", "utility", "keyframes"].includes(current.name)) return;
+          if (current.type === "Rule") {
+            reportRawDeclarations(context, current, insideBase);
+            return;
+          }
+          const inBaseLayer = insideBase || current.type === "Atrule" && current.name === "layer" && preludeIdentifiers(current).includes("base");
+          const children = current.type === "StyleSheet" ? current.children : blockChildren2(current);
+          for (const child of children) {
+            if (child.type === "Rule" || child.type === "Atrule") visit(child, inBaseLayer);
           }
         }
+        visit(node);
       }
     };
   }
@@ -9767,10 +9775,6 @@ function importedSpecifiers(text) {
     (match) => match.groups?.spec ?? ""
   );
 }
-function moduleImports(text, fileName) {
-  const escaped = fileName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-  return new RegExp(`(?:import|require)\\s*\\(?\\s*["'][^"']*${escaped}["']`, "i").test(text);
-}
 function resolveSpecifier2(fromFile, spec, sourceRoot) {
   if (spec.startsWith("/")) return path65.resolve(spec);
   if (spec.startsWith("./") || spec.startsWith("../")) return path65.resolve(path65.dirname(fromFile), spec);
@@ -9781,22 +9785,6 @@ function buildStylesheetGraph(options) {
   const { cssFiles, sourceRoot, textOf } = options;
   const cssSet = new Set(cssFiles.map((file) => path65.normalize(file)));
   const globals = cssFiles.filter((file) => registersTailwind(textOf(file)));
-  const reachable = /* @__PURE__ */ new Set();
-  const queue = [...globals];
-  for (const global of globals) reachable.add(path65.normalize(global));
-  while (queue.length > 0) {
-    const from = queue.shift();
-    if (!from) continue;
-    for (const spec of importedSpecifiers(textOf(from))) {
-      const target = resolveSpecifier2(from, spec, sourceRoot);
-      if (!target) continue;
-      const normalized = path65.normalize(target);
-      if (cssSet.has(normalized) && !reachable.has(normalized)) {
-        reachable.add(normalized);
-        queue.push(normalized);
-      }
-    }
-  }
   const directChildren = /* @__PURE__ */ new Set();
   for (const global of globals) {
     for (const spec of importedSpecifiers(textOf(global))) {
@@ -9806,7 +9794,7 @@ function buildStylesheetGraph(options) {
       if (cssSet.has(normalized)) directChildren.add(normalized);
     }
   }
-  return { globals, reachable, directChildren };
+  return { globals, directChildren };
 }
 
 // eslint/rules/tailwind/base-layer-pair.ts
@@ -9945,7 +9933,7 @@ var cssEntryPointRule = {
     schema: [],
     type: "problem",
     docs: {
-      description: "Require the app/styles CSS root, one global entry point, and direct project-CSS imports."
+      description: "Require the app/styles CSS root, one global entry point, and direct imports for every project stylesheet."
     }
   },
   create(context) {
@@ -9961,7 +9949,7 @@ var cssEntryPointRule = {
     }
     const textOf = cachedTextReader();
     const graph = buildStylesheetGraph({ cssFiles, sourceRoot, textOf });
-    const { globals, reachable, directChildren } = graph;
+    const { globals, directChildren } = graph;
     return {
       "StyleSheet:exit"(node) {
         if (globals.length === 0) return;
@@ -9982,13 +9970,33 @@ var cssEntryPointRule = {
             });
             return;
           }
-          const basename = path67.basename(current);
-          const importCount = moduleFiles.filter((modulePath) => moduleImports(textOf(modulePath), basename)).length;
+          const importers = moduleFiles.filter((modulePath) => {
+            const source = textOf(modulePath);
+            for (const match of source.matchAll(
+              /\b(?:import\s*(?:[^"'`;]*?\bfrom\s*)?|require\s*\(\s*)["'](?<specifier>[^"']+\.css)["']/gu
+            )) {
+              const specifier = match.groups?.specifier;
+              if (!specifier) continue;
+              const resolved = resolveSpecifier2(modulePath, specifier, sourceRoot);
+              if (resolved && path67.normalize(resolved) === current) return true;
+            }
+            return false;
+          });
+          const importCount = importers.length;
           if (importCount !== 1) {
             context.report({
               node,
               message: `The global stylesheet entry point must be imported by exactly one module (the root layout), but it is imported by ${String(importCount)} module(s).`
             });
+          } else {
+            const importer = importers[0];
+            const isRootLayout = importer !== void 0 && path67.dirname(importer) === path67.join(sourceRoot, "app") && /^layout\.(?:[cm]?[jt]sx?)$/u.test(path67.basename(importer));
+            if (!isRootLayout) {
+              context.report({
+                node,
+                message: "The global stylesheet entry point must be imported by src/app/layout, not another module."
+              });
+            }
           }
           return;
         }
@@ -10000,22 +10008,10 @@ var cssEntryPointRule = {
           });
           return;
         }
-        const hasProjectCss = node.children.some((child) => {
-          if (child.type === "Atrule" && child.name === "import") return false;
-          if (child.type === "Comment") return false;
-          return true;
-        });
-        if (hasProjectCss && !directChildren.has(current)) {
+        if (!directChildren.has(current)) {
           context.report({
             node,
-            message: "Project CSS may only live in a stylesheet the global entry point imports directly; route it through a direct import or into the entry point."
-          });
-          return;
-        }
-        if (!reachable.has(current)) {
-          context.report({
-            node,
-            message: "This stylesheet must be imported by the global stylesheet entry point via @import, so CSS arrives through one door."
+            message: "Every project stylesheet must be imported directly by src/app/styles/globals.css."
           });
         }
       }
@@ -10516,7 +10512,6 @@ var featureCssPlacementRule = {
     const basename = path70.basename(current);
     const featureName = basename.slice(0, -".css".length);
     const isFeatureFile = path70.dirname(current) === styles && FEATURE_CSS.test(basename) && existsSync9(path70.join(sourceRoot, "features", featureName));
-    if (basename !== GLOBALS && !isFeatureFile) return {};
     const read = cachedTextReader();
     const css2 = findFiles(sourceRoot, CSS_EXTENSIONS).map((file) => ({ path: file, content: read(file) }));
     const modules = findFiles(sourceRoot, MODULE_EXTENSIONS4).map((file) => ({ path: file, content: read(file) }));
@@ -10529,7 +10524,9 @@ var featureCssPlacementRule = {
           const owner = owners.get(symbolId(definition));
           if (!owner) continue;
           const expected = owner === GLOBALS ? GLOBALS : `${owner}.css`;
-          if (basename === GLOBALS && expected !== GLOBALS && !existsSync9(path70.join(styles, expected))) continue;
+          if (owner !== GLOBALS && (basename === GLOBALS || !isFeatureFile) && !existsSync9(path70.join(styles, expected))) {
+            continue;
+          }
           if (basename === expected) continue;
           const kind = LABELS[definition.kind] ?? definition.kind;
           context.report({
@@ -10546,38 +10543,6 @@ var featureCssPlacementRule = {
   }
 };
 
-// eslint/rules/tailwind/global-selector-styling.ts
-function hasStyling(node) {
-  for (const child of blockChildren2(node)) {
-    if (child.type === "Declaration" && !child.property.startsWith("--")) return true;
-    if (child.type === "Atrule" && child.name === "apply") return true;
-    if (child.type === "Rule" && hasStyling(child)) return true;
-  }
-  return false;
-}
-var globalSelectorStylingRule = {
-  meta: {
-    schema: [],
-    type: "problem",
-    docs: {
-      description: "Forbid element/component styling in global selectors outside @layer base."
-    }
-  },
-  create(context) {
-    return {
-      "StyleSheet:exit"(node) {
-        for (const child of node.children) {
-          if (child.type !== "Rule" || !hasStyling(child)) continue;
-          context.report({
-            node: child,
-            message: "Global selectors outside @layer base may only override CSS variables; keep element/component styling as Tailwind classes in the consumer."
-          });
-        }
-      }
-    };
-  }
-};
-
 // eslint/rules/tailwind/global-stylesheet.ts
 import { existsSync as existsSync10 } from "fs";
 import path71 from "path";
@@ -10662,13 +10627,24 @@ import path72 from "path";
 import { generate as generate3, parse as parse6, walk as walk3 } from "@eslint/css-tree";
 var INLINE_MESSAGE = "Define design tokens with direct values in @theme, not @theme inline.";
 var INDIRECT_MESSAGE = "Define design tokens that reference CSS variables via var() in @theme inline.";
+var MIXED_THEME_MESSAGE = "Use either @theme or @theme inline across the project; external font-loader mappings with valid fallbacks are the only exception.";
 var REDUNDANT_INLINE_MESSAGE = (name) => `Tailwind token "${name}" has no runtime overrides; define its value directly in @theme instead of using :root and @theme inline.`;
+var EXTERNAL_FONT_FALLBACK_MESSAGE = (name, variable) => `Tailwind font token "${name}" references external font "${variable}" without a fallback inside var(); use var(${variable}, Arial) or another font-family fallback.`;
+function hasVarFallback(source, variable) {
+  for (const match of source.matchAll(/\bvar\s*\(\s*(?<name>--[\w-]+)\s*,/gu)) {
+    if (match.groups?.name !== variable) continue;
+    const start = match.index + match[0].length;
+    const close = source.indexOf(")", start);
+    if (close !== -1 && /[^,\s]/u.test(source.slice(start, close))) return true;
+  }
+  return false;
+}
 var rootVariablesRule = {
   meta: {
     schema: [],
     type: "problem",
     docs: {
-      description: "Require @theme for fixed tokens, matching :root variables for @theme inline tokens, and no other token redeclarations."
+      description: "Require @theme for fixed tokens and fixed-token aliases, matching :root variables for @theme inline tokens, and no other token redeclarations."
     }
   },
   create(context) {
@@ -10685,15 +10661,54 @@ var rootVariablesRule = {
       modules: [],
       includeReferences: false
     });
+    const themeValues = new Map(
+      graph.definitions.filter((symbol) => symbol.kind === "theme-token" && symbol.value !== void 0).map((symbol) => [symbol.name, symbol.value ?? ""])
+    );
     const names = new Set(
       graph.definitions.filter((symbol) => symbol.kind === "theme-token").map((symbol) => symbol.name)
     );
+    function isFixedThemeAlias(name, value, visited = /* @__PURE__ */ new Set()) {
+      const match = /^var\(\s*(?<target>--[a-z][\w-]*)\s*\)$/u.exec(value.trim());
+      const target = match?.groups?.target;
+      if (!target || target === name || visited.has(target)) return false;
+      const next = themeValues.get(target);
+      if (!next) return false;
+      if (!/\bvar\s*\(/u.test(next)) return true;
+      visited.add(target);
+      return isFixedThemeAlias(name, next, visited);
+    }
     const mirroredTokens = /* @__PURE__ */ new Set();
+    let hasPlainThemeBlocks = false;
+    let hasInlineThemeBlocks = false;
+    let inlineBlocksAreExternalFonts = true;
     for (const file of [...stylesheets.filter((candidate) => path72.normalize(candidate) !== current), current]) {
       const source = (path72.normalize(file) === current ? context.sourceCode.text : textOf(file)).replace(
         /\/\*[\s\S]*?\*\//gu,
         " "
       );
+      for (const header of source.matchAll(/@theme(?<options>(?:\s+[\w-]+)*)\s*\{/gu)) {
+        if (/\binline\b/u.test(header.groups?.options ?? "")) hasInlineThemeBlocks = true;
+        else hasPlainThemeBlocks = true;
+      }
+      const inlineHeaders = [...source.matchAll(/@theme\s+inline\s*\{/gu)];
+      const inlineBlocks = [...source.matchAll(/@theme\s+inline\s*\{(?<body>[^{}]*)\}/gu)];
+      if (inlineHeaders.length !== inlineBlocks.length) inlineBlocksAreExternalFonts = false;
+      for (const block of inlineBlocks) {
+        const declarations = (block.groups?.body ?? "").split(";").map((part) => part.trim()).filter(Boolean);
+        if (declarations.length === 0) inlineBlocksAreExternalFonts = false;
+        for (const declaration of declarations) {
+          const match = /^(?<token>--font-[a-z][\w-]*)\s*:\s*(?<value>.+)$/u.exec(declaration);
+          const name = match?.groups?.token;
+          const value = match?.groups?.value ?? "";
+          const references = [...value.matchAll(/\bvar\s*\(\s*(?<name>--[\w-]+)/gu)].map(
+            (reference) => reference.groups?.name
+          );
+          const runtime = references[0];
+          if (!name || references.length !== 1 || !runtime?.startsWith("--font-") || runtime === name || names.has(runtime) || !hasVarFallback(value, runtime)) {
+            inlineBlocksAreExternalFonts = false;
+          }
+        }
+      }
       for (const theme of source.matchAll(/@theme(?<options>(?:\s+[\w-]+)*)\s*\{(?<body>[^{}]*)\}/gu)) {
         const inline = /\binline\b/u.test(theme.groups?.options ?? "");
         for (const declaration of (theme.groups?.body ?? "").matchAll(
@@ -10732,7 +10747,11 @@ var rootVariablesRule = {
     );
     return {
       "StyleSheet:exit"(node) {
-        for (const theme of atrulesNamed(node, "theme")) {
+        const localThemes = atrulesNamed(node, "theme");
+        if (hasPlainThemeBlocks && hasInlineThemeBlocks && !inlineBlocksAreExternalFonts && localThemes[0]) {
+          context.report({ node: localThemes[0], message: MIXED_THEME_MESSAGE });
+        }
+        for (const theme of localThemes) {
           const inline = preludeIdentifiers(theme).includes("inline");
           const source = context.sourceCode.getText(theme).replace(/\/\*[\s\S]*?\*\//gu, (comment) => comment.replace(/[^\r\n]/gu, " "));
           for (const match of source.matchAll(
@@ -10746,8 +10765,10 @@ var rootVariablesRule = {
               for (const reference of unquoted.matchAll(/\bvar\(\s*(?<variable>--[\w-]+)/gu)) {
                 const runtime = reference.groups?.variable;
                 if (runtime && runtime !== name) {
-                  const externalFont = name.startsWith("--font-") && runtime.startsWith("--font-") && /,\s*[^\s,)]+/u.test(unquoted);
-                  if (!names.has(runtime) && !externalFont) {
+                  const externalFont = name.startsWith("--font-") && runtime.startsWith("--font-");
+                  if (externalFont && !hasVarFallback(value, runtime)) {
+                    context.report({ node: theme, message: EXTERNAL_FONT_FALLBACK_MESSAGE(name, runtime) });
+                  } else if (!externalFont) {
                     context.report({
                       node: theme,
                       message: `Tailwind token "${name}" must reference its same-named CSS variable, not "${runtime}".`
@@ -10769,7 +10790,7 @@ var rootVariablesRule = {
                 context.report({ node: theme, message: REDUNDANT_INLINE_MESSAGE(name) });
               }
             }
-            if (inline === referencesVariable) continue;
+            if (inline === referencesVariable || !inline && isFixedThemeAlias(name, unquoted)) continue;
             const offset = (theme.loc?.start.offset ?? 0) + match.index + match[0].indexOf(name);
             const preceding = context.sourceCode.text.slice(0, offset);
             const line = preceding.split("\n").length;
@@ -10828,7 +10849,14 @@ var rootVariablesRule = {
 };
 
 // eslint/rules/tailwind/stylesheet-ordering.ts
+import path73 from "path";
 var SECTION_ORDER = ["imports", "custom-variant", "root", "theme", "utility", "base styles", "keyframes"];
+function scopesCustomProperties(node) {
+  if (node.type === "Declaration") return node.property.startsWith("--");
+  if (node.type === "Atrule" && !["media", "supports", "container"].includes(node.name)) return false;
+  if (node.type !== "Atrule" && node.type !== "Rule") return false;
+  return blockChildren2(node).some(scopesCustomProperties);
+}
 var stylesheetOrderingRule = {
   meta: {
     schema: [],
@@ -10838,6 +10866,9 @@ var stylesheetOrderingRule = {
     }
   },
   create(context) {
+    const sourceRoot = sourceRootOf(context);
+    const entryPoint = path73.normalize(path73.join(sourceRoot, "app", "styles", "globals.css"));
+    if (path73.normalize(path73.resolve(context.filename)) !== entryPoint) return {};
     return {
       "StyleSheet:exit"(node) {
         const sections = [];
@@ -10857,7 +10888,9 @@ var stylesheetOrderingRule = {
             if (preludeIdentifiers(child).includes("base")) {
               sections.push({ name: "base styles", at: index });
             }
-          } else if (child.type === "Rule" && selectorNames(child).includes("root")) {
+          } else if (child.type === "Rule" && (selectorNames(child).includes("root") || scopesCustomProperties(child))) {
+            sections.push({ name: "root", at: index });
+          } else if (child.type === "Atrule" && scopesCustomProperties(child)) {
             sections.push({ name: "root", at: index });
           }
           index += 1;
@@ -10902,7 +10935,7 @@ var stylesheetOrderingRule = {
 
 // eslint/rules/tailwind/theme-reset.ts
 import { existsSync as existsSync11 } from "fs";
-import path73 from "path";
+import path74 from "path";
 import { generate as generate4, parse as parse7, toPlainObject as toPlainObject2 } from "@eslint/css-tree";
 function isThemeReset(node) {
   if (!node) return false;
@@ -10930,8 +10963,8 @@ var themeResetRule = {
   },
   create(context) {
     const sourceRoot = sourceRootOf(context);
-    const current = path73.normalize(path73.resolve(context.filename));
-    const entryPoint = path73.normalize(path73.join(sourceRoot, "app", "styles", "globals.css"));
+    const current = path74.normalize(path74.resolve(context.filename));
+    const entryPoint = path74.normalize(path74.join(sourceRoot, "app", "styles", "globals.css"));
     if (current !== entryPoint) return {};
     return {
       "StyleSheet:exit"(node) {
@@ -10944,8 +10977,8 @@ var themeResetRule = {
           if (!from) continue;
           for (const specifier of importedSpecifiers(from.source)) {
             const target = resolveSpecifier2(from.file, specifier, sourceRoot);
-            if (!target || path73.extname(target) !== ".css") continue;
-            const filename = path73.normalize(target);
+            if (!target || path74.extname(target) !== ".css") continue;
+            const filename = path74.normalize(target);
             if (seen.has(filename) || !existsSync11(filename)) continue;
             seen.add(filename);
             const source = textOf(filename);
@@ -10964,7 +10997,7 @@ var themeResetRule = {
 };
 
 // eslint/rules/tailwind/unique-css-definition.ts
-import path74 from "path";
+import path75 from "path";
 function ownershipKey(symbol) {
   if (symbol.kind === "selector") return void 0;
   if (symbol.kind === "root-variable" && symbol.scope !== "default") return void 0;
@@ -10996,7 +11029,7 @@ var uniqueCssDefinitionRule = {
   },
   create(context) {
     const sourceRoot = sourceRootOf(context);
-    const current = path74.normalize(path74.resolve(context.filename));
+    const current = path75.normalize(path75.resolve(context.filename));
     const cssFiles = findFiles(sourceRoot, CSS_EXTENSIONS);
     if (cssFiles.length === 0) return {};
     const textOf = cachedTextReader();
@@ -11004,7 +11037,7 @@ var uniqueCssDefinitionRule = {
       sourceRoot,
       css: cssFiles.map((file) => ({
         path: file,
-        content: path74.normalize(file) === current ? context.sourceCode.text : textOf(file)
+        content: path75.normalize(file) === current ? context.sourceCode.text : textOf(file)
       })),
       modules: [],
       includeReferences: false
@@ -11026,7 +11059,7 @@ var uniqueCssDefinitionRule = {
           if (!canonical) continue;
           for (const symbol of definitions.slice(1)) {
             if (symbol.file !== current) continue;
-            const message = symbol.file === canonical.file ? `${symbolLabel(symbol)} "${symbol.name}" is defined more than once in this CSS file; define it only once.` : `${symbolLabel(symbol)} "${symbol.name}" is also defined in ${path74.relative(sourceRoot, canonical.file)}; define it in only one CSS file.`;
+            const message = symbol.file === canonical.file ? `${symbolLabel(symbol)} "${symbol.name}" is defined more than once in this CSS file; define it only once.` : `${symbolLabel(symbol)} "${symbol.name}" is also defined in ${path75.relative(sourceRoot, canonical.file)}; define it in only one CSS file.`;
             context.report({
               node,
               loc: {
@@ -11043,7 +11076,7 @@ var uniqueCssDefinitionRule = {
 };
 
 // eslint/rules/tailwind/unique-css-token-value.ts
-import path75 from "path";
+import path76 from "path";
 function valueIdentity(value) {
   const text = value.trim();
   const hex = /^#(?<digits>[\da-f]{3,4}|[\da-f]{6}|[\da-f]{8})$/iu.exec(text)?.groups?.digits;
@@ -11071,14 +11104,14 @@ var uniqueCssTokenValueRule = {
   },
   create(context) {
     const sourceRoot = sourceRootOf(context);
-    const current = path75.normalize(path75.resolve(context.filename));
+    const current = path76.normalize(path76.resolve(context.filename));
     const textOf = cachedTextReader();
     const cssFiles = findFiles(sourceRoot, CSS_EXTENSIONS);
     const graph = buildCssDependencyGraph({
       sourceRoot,
       css: cssFiles.map((file) => ({
         path: file,
-        content: path75.normalize(file) === current ? context.sourceCode.text : textOf(file)
+        content: path76.normalize(file) === current ? context.sourceCode.text : textOf(file)
       })),
       modules: [],
       includeReferences: false
@@ -11110,7 +11143,7 @@ var uniqueCssTokenValueRule = {
               start: { line: definition.line, column: 1 },
               end: { line: definition.line, column: 2 }
             },
-            message: `Token "${definition.name}" duplicates the value of "${original.name}" in ${path75.relative(
+            message: `Token "${definition.name}" duplicates the value of "${original.name}" in ${path76.relative(
               sourceRoot,
               original.file
             )}:${String(original.line)}; reuse one design token.`
@@ -11123,7 +11156,7 @@ var uniqueCssTokenValueRule = {
 
 // eslint/rules/tailwind/unused-utility.ts
 import { statSync as statSync5 } from "fs";
-import path76 from "path";
+import path77 from "path";
 var unusedUtilityRule = {
   meta: {
     schema: [],
@@ -11139,7 +11172,7 @@ var unusedUtilityRule = {
     } catch {
       return {};
     }
-    const current = path76.normalize(path76.resolve(context.filename));
+    const current = path77.normalize(path77.resolve(context.filename));
     const textOf = cachedTextReader();
     const cssFiles = findFiles(sourceRoot, CSS_EXTENSIONS);
     const moduleFiles = findFiles(sourceRoot, MODULE_EXTENSIONS4);
@@ -11147,7 +11180,7 @@ var unusedUtilityRule = {
       sourceRoot,
       css: cssFiles.map((file) => ({
         path: file,
-        content: path76.normalize(file) === current ? context.sourceCode.text : textOf(file)
+        content: path77.normalize(file) === current ? context.sourceCode.text : textOf(file)
       })),
       modules: moduleFiles.map((file) => ({ path: file, content: textOf(file) }))
     });
@@ -11168,7 +11201,7 @@ var unusedUtilityRule = {
 };
 
 // eslint/rules/tailwind/utility-mapping.ts
-import path77 from "path";
+import path78 from "path";
 function applyOperationCount(utility) {
   let count = 0;
   for (const apply of atrulesNamed(utility, "apply")) {
@@ -11294,6 +11327,26 @@ function canonicalToken(name) {
 function isTypographySize(name) {
   return /^--text-(?!.*--)(?:[a-z0-9]+-)*[a-z0-9]+$/u.test(name);
 }
+function suggestedThemeToken(candidate) {
+  if (candidate.namespace !== "color") return candidate.token;
+  let role = "edge";
+  if (["bg", "fill"].includes(candidate.prefix)) {
+    role = "canvas";
+  } else if (["text", "caret", "decoration"].includes(candidate.prefix)) {
+    role = "ink";
+  }
+  const semantic = /^--color-(?<domain>[a-z][a-z0-9-]*)-(?:canvas|ink|edge)$/u.exec(candidate.token);
+  const domain = semantic?.groups?.domain;
+  return domain ? `--color-${domain}-${role}` : `${candidate.token}-${role}`;
+}
+function themeMigrationGuidance(candidate, utilityName) {
+  const token = suggestedThemeToken(candidate);
+  const generatedClass = `${candidate.prefix}-${token.slice(`--${candidate.namespace}-`.length)}`;
+  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.`;
+}
 var utilityMappingRule = {
   meta: {
     schema: [],
@@ -11304,13 +11357,13 @@ var utilityMappingRule = {
   },
   create(context) {
     const sourceRoot = sourceRootOf(context);
-    const current = path77.normalize(path77.resolve(context.filename));
+    const current = path78.normalize(path78.resolve(context.filename));
     const textOf = cachedTextReader();
     const graph = buildCssDependencyGraph({
       sourceRoot,
       css: findFiles(sourceRoot, CSS_EXTENSIONS).map((file) => ({
         path: file,
-        content: path77.normalize(file) === current ? context.sourceCode.text : textOf(file)
+        content: path78.normalize(file) === current ? context.sourceCode.text : textOf(file)
       })),
       modules: [],
       includeReferences: false
@@ -11503,7 +11556,7 @@ var utilityMappingRule = {
           if (candidate.property === "font-size" && themeTokens.has(`--color-${name.slice(5)}`)) continue;
           context.report({
             node: utility,
-            message: `Custom utility "${name}" only maps ${candidate.property} (${candidate.value}); prefer @theme inline token "${candidate.token}" backed by a :root variable. Preserve the class name and compare compiled CSS before removing the utility.`
+            message: `Custom utility "${name}" only maps ${candidate.property} (${candidate.value}); ${themeMigrationGuidance(candidate, name)}`
           });
         }
         function checkClass(cssNode) {
@@ -11563,7 +11616,7 @@ var utilityMappingRule = {
 import { spawnSync } from "child_process";
 import { createHash } from "crypto";
 import { existsSync as existsSync12 } from "fs";
-import path78 from "path";
+import path79 from "path";
 import { generate as generate5, parse as parse8, toPlainObject as toPlainObject3 } from "@eslint/css-tree";
 function numericPart(value) {
   const match = /^(?<negative>-?)(?<number>(?:\d+(?:\.\d+)?|\.\d+))(?<unit>%|px|rem|em|vw|vh|dvw|dvh|ch|fr|s|ms|deg|turn)?$/u.exec(
@@ -11713,8 +11766,8 @@ var utilityNameParityRule = {
           return apply ? [{ utility, name, apply }] : [];
         });
         if (candidates.length === 0) return;
-        const physicalDir = path78.dirname(context.physicalFilename);
-        const cwd = path78.isAbsolute(physicalDir) && existsSync12(physicalDir) ? physicalDir : context.cwd;
+        const physicalDir = path79.dirname(context.physicalFilename);
+        const cwd = path79.isAbsolute(physicalDir) && existsSync12(physicalDir) ? physicalDir : context.cwd;
         const compiled = compileApplies(
           candidates.map((candidate) => candidate.apply),
           cwd
@@ -11758,12 +11811,11 @@ var tailwindRules = {
   "unused-utility": unusedUtilityRule,
   "unique-css-definition": uniqueCssDefinitionRule,
   "unique-css-token-value": uniqueCssTokenValueRule,
-  "no-utility-alias": noUtilityAliasRule,
-  "global-selector-styling": globalSelectorStylingRule
+  "no-utility-alias": noUtilityAliasRule
 };
 
 // eslint/rules/type-extraction.ts
-import path79 from "path";
+import path80 from "path";
 var typeExtractionRule = {
   meta: {
     schema: [],
@@ -11774,7 +11826,7 @@ var typeExtractionRule = {
   },
   create(context) {
     const sourceRoot = sourceRootOf(context);
-    const file = path79.resolve(context.filename);
+    const file = path80.resolve(context.filename);
     const segments = segmentsOf(file, sourceRoot);
     if (segments.length === 0) return {};
     const index = getProjectIndex(sourceRoot);
@@ -11915,7 +11967,7 @@ var uiStateRule = {
 // eslint/rules/unknown-utility.ts
 import { existsSync as existsSync13, readdirSync as readdirSync6, readFileSync as readFileSync15, statSync as statSync6 } from "fs";
 import { createRequire } from "module";
-import path80 from "path";
+import path81 from "path";
 var PREFIX_NAMESPACES = {
   bg: ["color", "background-image"],
   text: ["color", "text"],
@@ -12196,7 +12248,7 @@ function stylesheetFiles(dir) {
   }
   return entries.flatMap((entry) => {
     if (entry.startsWith(".") || entry === "node_modules") return [];
-    const entryPath = path80.join(dir, entry);
+    const entryPath = path81.join(dir, entry);
     let stats;
     try {
       stats = statSync6(entryPath);
@@ -12204,7 +12256,7 @@ function stylesheetFiles(dir) {
       return [];
     }
     if (stats.isDirectory()) return stylesheetFiles(entryPath);
-    return path80.extname(entry) === ".css" ? [entryPath] : [];
+    return path81.extname(entry) === ".css" ? [entryPath] : [];
   });
 }
 function packageNameOf(specifier) {
@@ -12215,10 +12267,10 @@ function packageNameOf(specifier) {
 function resolvePackageStylesheet(fromFile, specifier) {
   const packageName = packageNameOf(specifier);
   if (!packageName || packageName === "tailwindcss") return void 0;
-  let directory = path80.dirname(fromFile);
-  while (directory !== path80.dirname(directory)) {
-    const packageRoot = path80.join(directory, "node_modules", packageName);
-    const manifestPath = path80.join(packageRoot, "package.json");
+  let directory = path81.dirname(fromFile);
+  while (directory !== path81.dirname(directory)) {
+    const packageRoot = path81.join(directory, "node_modules", packageName);
+    const manifestPath = path81.join(packageRoot, "package.json");
     if (existsSync13(manifestPath)) {
       try {
         const manifest = readFileSync15(manifestPath, "utf8");
@@ -12226,13 +12278,13 @@ function resolvePackageStylesheet(fromFile, specifier) {
         const main = /"main"\s*:\s*"(?<file>[^"]+\.css)"/.exec(manifest)?.groups?.file;
         const target = stylesheet ?? main;
         if (!target) return void 0;
-        const resolved = path80.resolve(packageRoot, target);
+        const resolved = path81.resolve(packageRoot, target);
         return existsSync13(resolved) ? resolved : void 0;
       } catch {
         return void 0;
       }
     }
-    directory = path80.dirname(directory);
+    directory = path81.dirname(directory);
   }
   return void 0;
 }
@@ -12492,7 +12544,7 @@ var unknownUtilityRule = {
 };
 
 // eslint/rules/util-file-name.ts
-import path81 from "path";
+import path82 from "path";
 function toKebabCase2(value) {
   return value.replace(/(?<lower>[a-z0-9])(?<upper>[A-Z])/g, "$<lower>-$<upper>").replace(/(?<first>[A-Z])(?<rest>[A-Z][a-z])/g, "$<first>-$<rest>").toLowerCase();
 }
@@ -12505,7 +12557,7 @@ var utilFileNameRule = {
     }
   },
   create(context) {
-    const filename = path81.resolve(context.filename);
+    const filename = path82.resolve(context.filename);
     const segments = filename.replace(/\\/g, "/").split("/");
     if (!segments.includes("utils")) return {};
     let module;
@@ -12519,13 +12571,13 @@ var utilFileNameRule = {
     const functionName = functions[0]?.name;
     if (!functionName) return {};
     const expected = toKebabCase2(functionName);
-    const actual = path81.basename(filename, path81.extname(filename));
+    const actual = path82.basename(filename, path82.extname(filename));
     if (!expected || actual === expected) return {};
     return {
       Program(node) {
         context.report({
           node,
-          message: `A utility file exporting ${functionName} must be named ${expected}.${path81.extname(filename).slice(1)}.`
+          message: `A utility file exporting ${functionName} must be named ${expected}.${path82.extname(filename).slice(1)}.`
         });
       }
     };
@@ -12533,7 +12585,7 @@ var utilFileNameRule = {
 };
 
 // eslint/rules/value-extraction.ts
-import path82 from "path";
+import path83 from "path";
 var valueExtractionRule = {
   meta: {
     schema: [],
@@ -12544,7 +12596,7 @@ var valueExtractionRule = {
   },
   create(context) {
     const sourceRoot = sourceRootOf(context);
-    const file = path82.resolve(context.filename);
+    const file = path83.resolve(context.filename);
     const segments = segmentsOf(file, sourceRoot);
     if (segments.length === 0 || segments[0] !== "app") return {};
     const index = getProjectIndex(sourceRoot);
@@ -12566,7 +12618,7 @@ var valueExtractionRule = {
 
 // eslint/rules/vulyk/tracked-docs.ts
 import { existsSync as existsSync14, readFileSync as readFileSync16 } from "fs";
-import path83 from "path";
+import path84 from "path";
 var PASIKA_REPO = "Bredansky/pasika";
 var BASE_REQUIRED_TRACKED_DOCS = [
   { name: "documentation-guide", path: "docs/documentation-guide" },
@@ -12599,8 +12651,8 @@ var trackedDocsRule = {
         if (!context.filename.endsWith("package.json")) return;
         const root = node.body;
         if (root.type !== "Object") return;
-        const projectRoot = path83.dirname(path83.resolve(context.filename));
-        const configPath = path83.join(projectRoot, "vulyk.config.ts");
+        const projectRoot = path84.dirname(path84.resolve(context.filename));
+        const configPath = path84.join(projectRoot, "vulyk.config.ts");
         if (!existsSync14(configPath)) {
           context.report({
             node,
@@ -12625,7 +12677,7 @@ var trackedDocsRule = {
             });
           }
         }
-        const agentsPath = path83.join(projectRoot, "AGENTS.md");
+        const agentsPath = path84.join(projectRoot, "AGENTS.md");
         if (!existsSync14(agentsPath)) {
           context.report({
             node,
@@ -12725,7 +12777,7 @@ var withResponseHelperRule = {
 
 // eslint/rules/zirka-baseline.ts
 import fs7 from "fs";
-import path84 from "path";
+import path85 from "path";
 var ESLINT_CONFIG = /^eslint\.config\.(?:ts|mts|cts|js|mjs|cjs)$/;
 var PRETTIER_CONFIGS = [
   "prettier.config.mjs",
@@ -12744,10 +12796,10 @@ var zirkaBaselineRule = {
     }
   },
   create(context) {
-    const filename = path84.resolve(context.filename);
-    const basename = path84.basename(filename);
+    const filename = path85.resolve(context.filename);
+    const basename = path85.basename(filename);
     if (!ESLINT_CONFIG.test(basename)) return {};
-    const projectRoot = path84.dirname(filename);
+    const projectRoot = path85.dirname(filename);
     const report3 = (message) => {
       context.report({
         node: context.sourceCode.ast,
@@ -12762,7 +12814,7 @@ var zirkaBaselineRule = {
             'ESLint config must take its configuration from zirka (import { styleguide } from "zirka") instead of restating rules locally.'
           );
         }
-        const tsconfigPath = path84.join(projectRoot, "tsconfig.json");
+        const tsconfigPath = path85.join(projectRoot, "tsconfig.json");
         if (!fs7.existsSync(tsconfigPath)) {
           report3('No tsconfig.json found. Create one extending the zirka TypeScript base config ("zirka/typescript").');
         } else {
@@ -12780,13 +12832,13 @@ var zirkaBaselineRule = {
             report3('tsconfig.json must extend the zirka TypeScript base config ("zirka/typescript").');
           }
         }
-        const prettierConfigFile = PRETTIER_CONFIGS.find((name) => fs7.existsSync(path84.join(projectRoot, name)));
+        const prettierConfigFile = PRETTIER_CONFIGS.find((name) => fs7.existsSync(path85.join(projectRoot, name)));
         if (!prettierConfigFile) {
           report3(
             "No prettier config found. Create one that takes its configuration from zirka (styleguide({ prettier: true }).prettierConfig)."
           );
         } else {
-          const content = fs7.readFileSync(path84.join(projectRoot, prettierConfigFile), "utf8");
+          const content = fs7.readFileSync(path85.join(projectRoot, prettierConfigFile), "utf8");
           if (!content.includes("zirka")) {
             report3(
               "The prettier config must take its configuration from zirka (styleguide({ prettier: true }).prettierConfig) instead of restating it locally."

package/package.json

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