pasika 0.10.31 → 0.10.33

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

@@ -110,12 +110,11 @@ declare const tailwindRules: {
     "stylesheet-ordering": _eslint_css.CSSRuleDefinition;
     "css-variable-naming": _eslint_css.CSSRuleDefinition;
     "custom-utility-apply": _eslint_css.CSSRuleDefinition;
-    "skin-utility": _eslint_css.CSSRuleDefinition;
+    "utility-mapping": _eslint_css.CSSRuleDefinition;
     "theme-variable-namespace": _eslint_css.CSSRuleDefinition;
     "css-entry-point": _eslint_css.CSSRuleDefinition;
     "global-stylesheet": _eslint_css.CSSRuleDefinition;
     "unused-utility": _eslint_css.CSSRuleDefinition;
-    "single-use-utility": _eslint_css.CSSRuleDefinition;
     "global-selector-styling": _eslint_css.CSSRuleDefinition;
 };
 
@@ -143,7 +142,7 @@ declare const vulykRules: {
  * One plugin object every preset block references. ESLint only permits a
  * plugin name to be redefined across configs when the value is the same
  * object reference, and several blocks share file scopes (`src/**`, the
- * manifest, `globals.css`), so a per-block plugin object would collide when
+ * manifest, `src/app/styles/globals.css`), so a per-block plugin object would collide when
  * the blocks merge.
  */
 declare const pasikaPlugin: {
@@ -162,12 +161,11 @@ declare const pasikaPlugin: {
         "stylesheet-ordering": _eslint_css.CSSRuleDefinition;
         "css-variable-naming": _eslint_css.CSSRuleDefinition;
         "custom-utility-apply": _eslint_css.CSSRuleDefinition;
-        "skin-utility": _eslint_css.CSSRuleDefinition;
+        "utility-mapping": _eslint_css.CSSRuleDefinition;
         "theme-variable-namespace": _eslint_css.CSSRuleDefinition;
         "css-entry-point": _eslint_css.CSSRuleDefinition;
         "global-stylesheet": _eslint_css.CSSRuleDefinition;
         "unused-utility": _eslint_css.CSSRuleDefinition;
-        "single-use-utility": _eslint_css.CSSRuleDefinition;
         "global-selector-styling": _eslint_css.CSSRuleDefinition;
         "doc-kind-suffix": _eslint_markdown.MarkdownRuleDefinition;
         "title-matches-file-name": _eslint_markdown.MarkdownRuleDefinition;
@@ -222,6 +220,7 @@ declare const pasikaPlugin: {
         "ui-state": eslint.Rule.RuleModule;
         "no-mixed-concerns": eslint.Rule.RuleModule;
         "no-arbitrary-tailwind": eslint.Rule.RuleModule;
+        "no-literal-inline-style": eslint.Rule.RuleModule;
         "unknown-utility": eslint.Rule.RuleModule;
         "enforce-cn-merge": {
             meta: {
@@ -255,7 +254,6 @@ declare const pasikaPlugin: {
         "locale-placement": eslint.Rule.RuleModule;
         "sole-state-owner": eslint.Rule.RuleModule;
         "locale-key-shape": eslint.Rule.RuleModule;
-        "shared-style-dedup": eslint.Rule.RuleModule;
         "repeated-structure": eslint.Rule.RuleModule;
     };
 };

package/dist/eslint/pasika/index.js

@@ -727,6 +727,74 @@ var noArbitraryTailwindRule = {
   }
 };
 
+// eslint/rules/no-literal-inline-style.ts
+function isStaticValue(value) {
+  if (value.type === "Literal") {
+    return typeof value.value === "string" || typeof value.value === "number" || typeof value.value === "boolean";
+  }
+  if (value.type === "TemplateLiteral") {
+    return value.expressions.length === 0;
+  }
+  if (value.type === "UnaryExpression" && (value.operator === "-" || value.operator === "+") && value.argument.type === "Literal") {
+    return true;
+  }
+  if (value.type === "ConditionalExpression") {
+    return isStaticValue(value.consequent) || isStaticValue(value.alternate);
+  }
+  if (value.type === "LogicalExpression") {
+    return isStaticValue(value.left) || isStaticValue(value.right);
+  }
+  return false;
+}
+function propertyName(property) {
+  if (!property.computed && property.key.type === "Identifier") return property.key.name;
+  if (property.key.type === "Literal" && typeof property.key.value === "string") return property.key.value;
+  return void 0;
+}
+function findStaticDeclaration(expression) {
+  for (const property of expression.properties) {
+    if (property.type !== "Property" || property.kind !== "init") continue;
+    const name = propertyName(property);
+    if (!name) continue;
+    if (isStaticValue(property.value)) return name;
+  }
+  return void 0;
+}
+function findStaticStyle(expression) {
+  if (expression.type === "ObjectExpression") return findStaticDeclaration(expression);
+  if (expression.type === "ConditionalExpression") {
+    return findStaticStyle(expression.consequent) ?? findStaticStyle(expression.alternate);
+  }
+  if (expression.type === "LogicalExpression") {
+    return findStaticStyle(expression.left) ?? findStaticStyle(expression.right);
+  }
+  return void 0;
+}
+var noLiteralInlineStyleRule = {
+  meta: {
+    schema: [],
+    type: "problem",
+    docs: {
+      description: "Disallow static CSS declarations in JSX style attributes."
+    }
+  },
+  create(context) {
+    return {
+      JSXAttribute(node) {
+        if (node.name?.name !== "style" || node.value?.type !== "JSXExpressionContainer") return;
+        const expression = node.value.expression;
+        if (!expression) return;
+        const name = findStaticStyle(expression);
+        if (!name) return;
+        context.report({
+          node,
+          message: `Static inline style "${name}" should use Tailwind. Keep inline styles for runtime-sourced values. See docs/next-tailwind-guide/rules/inline-style-rule.md`
+        });
+      }
+    };
+  }
+};
+
 // eslint/rules/unknown-utility.ts
 import { existsSync, readdirSync, readFileSync as readFileSync2, statSync } from "fs";
 import { createRequire as createRequire2 } from "module";
@@ -4807,67 +4875,6 @@ var localeKeyShapeRule = {
   }
 };
 
-// eslint/rules/shared-style-dedup.ts
-import path40 from "path";
-import { readFileSync as readFileSync6, statSync as statSync3 } from "fs";
-var CLASS_NAME = /className="(?<classes>[^"]+)"/g;
-var comboCache;
-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) {
-    fingerprint2 += String(statSync3(file).mtimeMs);
-  }
-  if (comboCache?.sourceRoot === index.sourceRoot && comboCache.fingerprint === fingerprint2) {
-    return comboCache.combos;
-  }
-  const combos = /* @__PURE__ */ new Map();
-  for (const file of files) {
-    const text = readFileSync6(file, "utf8");
-    for (const match of text.matchAll(CLASS_NAME)) {
-      const classes = (match.groups?.classes ?? "").split(/\s+/).filter(Boolean);
-      if (classes.length < 2) continue;
-      const key = [...classes].sort().join(" ");
-      const users = combos.get(key) ?? /* @__PURE__ */ new Set();
-      users.add(file);
-      combos.set(key, users);
-    }
-  }
-  comboCache = { sourceRoot: index.sourceRoot, fingerprint: fingerprint2, combos };
-  return combos;
-}
-var sharedStyleDedupRule = {
-  meta: {
-    schema: [],
-    type: "problem",
-    docs: {
-      description: "Require a className combination used by two or more components to become a named *-skin utility."
-    }
-  },
-  create(context) {
-    const sourceRoot = sourceRootOf(context);
-    const file = path40.resolve(context.filename);
-    const segments = segmentsOf(file, sourceRoot);
-    if (segments.length === 0) return {};
-    const index = getProjectIndex(sourceRoot);
-    if (!index) return {};
-    const combos = combosFor(index);
-    const sharedHere = [...combos.entries()].filter(([, users]) => users.size >= 2 && users.has(file)).filter(([, users]) => [...users].sort((left, right) => left.localeCompare(right))[0] === file);
-    if (sharedHere.length === 0) return {};
-    return {
-      Program(node) {
-        for (const [combo, users] of sharedHere) {
-          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 *-skin Tailwind utility for it. See docs/next-tailwind-guide/rules/theme-and-utility-definition-rule.md`
-          });
-        }
-      }
-    };
-  }
-};
-
 // eslint/rules/repeated-structure.ts
 function nodeKind(node) {
   return node.type;
@@ -5083,7 +5090,7 @@ var zodSchemaValidationRule = {
 };
 
 // eslint/rules/schema-casing.ts
-import path41 from "path";
+import path40 from "path";
 function isCamelCase(name) {
   return /^[a-z][a-zA-Z0-9]*$/.test(name);
 }
@@ -5111,9 +5118,9 @@ var schemaCasingRule = {
     }
   },
   create(context) {
-    const filename = path41.resolve(context.filename);
+    const filename = path40.resolve(context.filename);
     const sourceRoot = sourceRootOf(context);
-    if (!filename.startsWith(sourceRoot + path41.sep)) return {};
+    if (!filename.startsWith(sourceRoot + path40.sep)) return {};
     let zodLocalName;
     return {
       ImportDeclaration(node) {
@@ -5145,7 +5152,7 @@ var schemaCasingRule = {
 };
 
 // eslint/rules/component-casing.ts
-import path42 from "path";
+import path41 from "path";
 function isPascalCase5(name) {
   return /^[A-Z][A-Za-z0-9]*$/.test(name);
 }
@@ -5158,10 +5165,10 @@ var componentCasingRule = {
     }
   },
   create(context) {
-    const filename = path42.resolve(context.filename);
+    const filename = path41.resolve(context.filename);
     const sourceRoot = sourceRootOf(context);
-    if (!filename.startsWith(sourceRoot + path42.sep)) return {};
-    if (path42.extname(filename) !== ".tsx") return {};
+    if (!filename.startsWith(sourceRoot + path41.sep)) return {};
+    if (path41.extname(filename) !== ".tsx") return {};
     return {
       Program(node) {
         for (const declaration of findJsxReturningDeclarations(context.sourceCode.text, filename)) {
@@ -5178,7 +5185,7 @@ var componentCasingRule = {
 };
 
 // eslint/rules/source-under-src.ts
-import path43 from "path";
+import path42 from "path";
 var NON_SOURCE_ROOT_DIRS = /* @__PURE__ */ new Set([
   ".agents",
   ".cache",
@@ -5219,14 +5226,14 @@ var sourceUnderSrcRule = {
     }
   },
   create(context) {
-    const filename = path43.resolve(context.filename);
+    const filename = path42.resolve(context.filename);
     if (!MODULE_EXTENSION.test(filename)) return {};
-    const relative = path43.relative(context.cwd, filename).replace(/\\/g, "/");
+    const relative = path42.relative(context.cwd, filename).replace(/\\/g, "/");
     if (relative === "src" || relative.startsWith("src/")) return {};
     const topLevel = relative.split("/")[0] ?? "";
     if (NON_SOURCE_ROOT_DIRS.has(topLevel)) return {};
     if (!relative.includes("/")) {
-      const basename = path43.basename(filename);
+      const basename = path42.basename(filename);
       if (CONFIG_FILE.test(basename) || DECLARATION_FILE.test(basename) || basename.startsWith(".")) return {};
     }
     return {
@@ -5243,7 +5250,7 @@ var sourceUnderSrcRule = {
 
 // eslint/rules/zirka-baseline.ts
 import fs6 from "fs";
-import path44 from "path";
+import path43 from "path";
 var ESLINT_CONFIG = /^eslint\.config\.(?:ts|mts|cts|js|mjs|cjs)$/;
 var PRETTIER_CONFIGS = [
   "prettier.config.mjs",
@@ -5262,10 +5269,10 @@ var zirkaBaselineRule = {
     }
   },
   create(context) {
-    const filename = path44.resolve(context.filename);
-    const basename = path44.basename(filename);
+    const filename = path43.resolve(context.filename);
+    const basename = path43.basename(filename);
     if (!ESLINT_CONFIG.test(basename)) return {};
-    const projectRoot = path44.dirname(filename);
+    const projectRoot = path43.dirname(filename);
     const report3 = (message) => {
       context.report({
         node: context.sourceCode.ast,
@@ -5280,7 +5287,7 @@ var zirkaBaselineRule = {
             'ESLint config must take its configuration from zirka (import { styleguide } from "zirka") instead of restating rules locally.'
           );
         }
-        const tsconfigPath = path44.join(projectRoot, "tsconfig.json");
+        const tsconfigPath = path43.join(projectRoot, "tsconfig.json");
         if (!fs6.existsSync(tsconfigPath)) {
           report3('No tsconfig.json found. Create one extending the zirka TypeScript base config ("zirka/typescript").');
         } else {
@@ -5298,13 +5305,13 @@ var zirkaBaselineRule = {
             report3('tsconfig.json must extend the zirka TypeScript base config ("zirka/typescript").');
           }
         }
-        const prettierConfigFile = PRETTIER_CONFIGS.find((name) => fs6.existsSync(path44.join(projectRoot, name)));
+        const prettierConfigFile = PRETTIER_CONFIGS.find((name) => fs6.existsSync(path43.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 = fs6.readFileSync(path44.join(projectRoot, prettierConfigFile), "utf8");
+          const content = fs6.readFileSync(path43.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."
@@ -5324,6 +5331,9 @@ function referencesZirka(sourceCode) {
   return /require\(\s*["']zirka["']\s*\)/.test(sourceCode.getText());
 }
 
+// eslint/rules/documentation/helpers.ts
+import path44 from "path";
+
 // constants/rfc2119.ts
 var RFC_2119_KEYWORDS = ["MUST NOT", "MUST", "SHOULD NOT", "SHOULD", "MAY"];
 var RFC_2119_PATTERN = new RegExp(`\\b(?<keyword>${RFC_2119_KEYWORDS.join("|")})\\b`);
@@ -5336,6 +5346,13 @@ function containsRfcKeyword(text) {
 function getFilename(context) {
   return context.filename;
 }
+function isAgentDocument(filename) {
+  const base = path44.basename(filename);
+  return base === "AGENTS.md" || base === "CLAUDE.md";
+}
+function isDocumentationTemplate(filename) {
+  return path44.basename(path44.dirname(filename)) === "_templates";
+}
 function getTextContent(node) {
   if ("value" in node && typeof node.value === "string") return node.value;
   if ("children" in node) {
@@ -5369,7 +5386,7 @@ var docKindSuffixRule = {
     return {
       root(node) {
         const filename = getFilename(context);
-        if (!filename.endsWith(".md")) return;
+        if (!filename.endsWith(".md") || isAgentDocument(filename) || isDocumentationTemplate(filename)) return;
         if (filename.endsWith("-guide.md") || filename.endsWith("-rule.md") || filename.endsWith("-reference.md") || filename.endsWith("-policy.md")) {
           return;
         }
@@ -5400,7 +5417,7 @@ var titleMatchesFileNameRule = {
       heading(node) {
         if (node.depth !== 1) return;
         const filename = getFilename(context);
-        if (!filename.endsWith(".md")) return;
+        if (!filename.endsWith(".md") || isAgentDocument(filename) || isDocumentationTemplate(filename)) return;
         const title = getTextContent(node).trim();
         const expectedFileName = toExpectedFileName(title);
         const actualFileName = path45.basename(filename);
@@ -5680,12 +5697,16 @@ var rulePairedExamplesRule = {
         if (!filename.endsWith("-rule.md")) return;
         const exampleHeadings = [];
         for (const child of node.children) {
-          if (child.type === "heading" && child.depth === 2) {
-            const text = getTextContent(child).trim();
-            if (/^(?:Incorrect|Correct)\b/.test(text)) {
-              exampleHeadings.push({ line: getLine(child), text });
-            }
+          if (child.type !== "heading" || child.depth !== 2) continue;
+          const text = getTextContent(child).trim();
+          if (/^(?:Incorrect|Correct)\b/.test(text)) {
+            exampleHeadings.push({ line: getLine(child), text });
+            continue;
           }
+          context.report({
+            node: child,
+            message: `Rule level-2 heading must be an Incorrect/Correct example: ${text}`
+          });
         }
         const incorrect = exampleHeadings.filter((h) => h.text.startsWith("Incorrect"));
         const correct = exampleHeadings.filter((h) => h.text.startsWith("Correct"));
@@ -5826,7 +5847,7 @@ var referenceBlockHeadingsRule = {
     return {
       root(node) {
         const filename = getFilename(context);
-        if (!filename.endsWith("-reference.md")) return;
+        if (!filename.endsWith("-reference.md") || isDocumentationTemplate(filename)) return;
         const sectionHeadings = [];
         for (const child of node.children) {
           if (child.type === "heading" && child.depth >= 2) {
@@ -5900,7 +5921,7 @@ var supportDocumentPlacementRule = {
     return {
       root(node) {
         const filename = getFilename(context);
-        if (!filename.endsWith(".md")) return;
+        if (!filename.endsWith(".md") || isDocumentationTemplate(filename)) return;
         let kind;
         if (filename.endsWith("-rule.md")) kind = "rule";
         if (filename.endsWith("-reference.md")) kind = "reference";
@@ -5928,6 +5949,7 @@ var noTemplatePromptRule = {
     }
   },
   create(context) {
+    if (isDocumentationTemplate(getFilename(context))) return {};
     return {
       text(node) {
         if (TEMPLATE_PROMPT.test(node.value)) {
@@ -5945,7 +5967,7 @@ var noTemplatePromptRule = {
 import path48 from "path";
 
 // eslint/rules/documentation/project-index.ts
-import { readdirSync as readdirSync3, readFileSync as readFileSync7, statSync as statSync4 } from "fs";
+import { readdirSync as readdirSync3, readFileSync as readFileSync6, statSync as statSync3 } from "fs";
 import path47 from "path";
 var KIND_BY_SUFFIX = [
   ["-rule.md", "rule"],
@@ -5956,14 +5978,14 @@ var KIND_BY_SUFFIX = [
 function listMarkdownFiles(dir) {
   return readdirSync3(dir).flatMap((entry) => {
     const entryPath = path47.join(dir, entry);
-    if (statSync4(entryPath).isDirectory()) {
+    if (statSync3(entryPath).isDirectory()) {
       return entry.startsWith("_") ? [] : listMarkdownFiles(entryPath);
     }
     return entry.endsWith(".md") ? [entryPath] : [];
   });
 }
 function extractTitle(filePath) {
-  const content = readFileSync7(filePath, "utf8");
+  const content = readFileSync6(filePath, "utf8");
   const match = /^# (?<title>.+)$/m.exec(content);
   return match?.groups?.title?.trim() ?? "";
 }
@@ -5989,7 +6011,7 @@ function getProjectDocs(docsRoot) {
 function findDocsRoot(filePath) {
   let dir = path47.dirname(filePath);
   for (; ; ) {
-    if (path47.basename(dir) === "docs" && statSync4(dir).isDirectory()) {
+    if (path47.basename(dir) === "docs" && statSync3(dir).isDirectory()) {
       return dir;
     }
     const parent = path47.dirname(dir);
@@ -6166,7 +6188,7 @@ var policySubjectHeadingsRule = {
 };
 
 // eslint/rules/documentation/guide-link-anchors.ts
-import { existsSync as existsSync3, readFileSync as readFileSync8 } from "fs";
+import { existsSync as existsSync3, readFileSync as readFileSync7 } from "fs";
 import path49 from "path";
 function visitSteps2(node, check) {
   if (node.type === "list" && node.ordered) {
@@ -6197,7 +6219,7 @@ function documentAnchors(filePath) {
   anchorsByFile.set(filePath, anchors);
   let content;
   try {
-    content = readFileSync8(filePath, "utf8");
+    content = readFileSync7(filePath, "utf8");
   } catch {
     return anchors;
   }
@@ -6296,7 +6318,7 @@ var noNestedHowToRule = {
 };
 
 // eslint/rules/documentation/glossary-term-linking.ts
-import { readFileSync as readFileSync9 } from "fs";
+import { readFileSync as readFileSync8 } from "fs";
 import path50 from "path";
 function isGlossary(filePath) {
   return path50.basename(filePath).includes("glossary");
@@ -6317,7 +6339,7 @@ function extractTableTerms(content) {
 }
 function extractGlossaryTerms(filePath) {
   if (!isGlossary(filePath)) return [];
-  const content = readFileSync9(filePath, "utf8");
+  const content = readFileSync8(filePath, "utf8");
   const tableTerms = extractTableTerms(content);
   if (tableTerms.length > 0) return tableTerms;
   const terms = [];
@@ -6331,7 +6353,7 @@ function extractGlossaryTerms(filePath) {
 function extractBlockHeadings(filePath) {
   const headings = [];
   let fenced = false;
-  for (const line of readFileSync9(filePath, "utf8").split("\n")) {
+  for (const line of readFileSync8(filePath, "utf8").split("\n")) {
     if (/^\s*(?:```|~~~)/.test(line)) {
       fenced = !fenced;
       continue;
@@ -6641,6 +6663,11 @@ function preludeIdentifiers(node) {
   });
   return names;
 }
+function rawValue(node) {
+  if (!node) return "";
+  if (node.type === "Raw") return node.value;
+  return "";
+}
 function rules(node) {
   const result = [];
   walkNodes(node, (current) => {
@@ -6988,39 +7015,40 @@ var customUtilityApplyRule = {
   }
 };
 
-// eslint/rules/tailwind/skin-utility.ts
-var skinUtilityRule = {
+// eslint/rules/tailwind/utility-mapping.ts
+function applyOperationCount(utility) {
+  let count = 0;
+  for (const apply of atrulesNamed(utility, "apply")) {
+    const identifiers = preludeIdentifiers(apply);
+    if (identifiers.length > 0) {
+      count += identifiers.length;
+      continue;
+    }
+    const prelude = "prelude" in apply ? apply.prelude : void 0;
+    const raw = prelude ? rawValue(prelude) : "";
+    const rawOperations = raw.trim().split(/\s+/).filter(Boolean);
+    count += rawOperations.length > 0 ? rawOperations.length : 1;
+  }
+  return count;
+}
+var utilityMappingRule = {
   meta: {
     schema: [],
     type: "problem",
     docs: {
-      description: "Require reusable style combinations to become *-skin utilities."
+      description: "Require custom utilities to map exactly one Tailwind styling operation."
     }
   },
   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;
+          const name = preludeIdentifiers(utility)[0] ?? "unknown";
+          const operationCount = applyOperationCount(utility);
+          if (operationCount === 1) 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 (new Set(classes).size < 2) continue;
-          const key = [...classes].sort().join(" ");
-          combinations.set(key, (combinations.get(key) ?? 0) + 1);
-        }
-        for (const [combo, count] of combinations) {
-          if (count < 2) continue;
-          context.report({
-            node,
-            message: `Combination "${combo}" appears ${String(count)} times. Create a *-skin custom Tailwind utility for it.`
+            message: `Custom utility "${name}" maps ${String(operationCount)} Tailwind operations; custom utilities must map exactly one operation. Reusable presentation belongs in a component.`
           });
         }
       }
@@ -7068,11 +7096,11 @@ var themeVariableNamespaceRule = {
 };
 
 // eslint/rules/tailwind/css-entry-point.ts
-import { statSync as statSync6 } from "fs";
+import { statSync as statSync5 } from "fs";
 import path54 from "path";
 
 // eslint/rules/tailwind/source-files.ts
-import { readdirSync as readdirSync4, readFileSync as readFileSync10, statSync as statSync5 } from "fs";
+import { readdirSync as readdirSync4, readFileSync as readFileSync9, statSync as statSync4 } from "fs";
 import path52 from "path";
 var CSS_EXTENSIONS = [".css"];
 var MODULE_EXTENSIONS3 = [".ts", ".tsx", ".mts", ".cts", ".js", ".jsx", ".mjs", ".cjs"];
@@ -7089,7 +7117,7 @@ function findFiles(dir, extensions) {
     const entryPath = path52.join(dir, entry);
     let stats;
     try {
-      stats = statSync5(entryPath);
+      stats = statSync4(entryPath);
     } catch {
       return [];
     }
@@ -7103,7 +7131,7 @@ function cachedTextReader() {
     let text = texts.get(file);
     if (text === void 0) {
       try {
-        text = readFileSync10(file, "utf8");
+        text = readFileSync9(file, "utf8");
       } catch {
         text = "";
       }
@@ -7169,12 +7197,14 @@ function buildStylesheetGraph(options) {
 }
 
 // eslint/rules/tailwind/css-entry-point.ts
+var APP_STYLES_DIR = path54.join("app", "styles");
+var GLOBAL_STYLESHEET_PATH = path54.join(APP_STYLES_DIR, "globals.css");
 var cssEntryPointRule = {
   meta: {
     schema: [],
     type: "problem",
     docs: {
-      description: "Require one global entry point; project CSS only in a stylesheet it imports directly."
+      description: "Require the app/styles CSS root, one global entry point, and direct project-CSS imports."
     }
   },
   create(context) {
@@ -7182,7 +7212,7 @@ var cssEntryPointRule = {
     let cssFiles;
     let moduleFiles;
     try {
-      if (!statSync6(sourceRoot).isDirectory()) return {};
+      if (!statSync5(sourceRoot).isDirectory()) return {};
       cssFiles = findFiles(sourceRoot, CSS_EXTENSIONS);
       moduleFiles = findFiles(sourceRoot, MODULE_EXTENSIONS3);
     } catch {
@@ -7195,6 +7225,7 @@ var cssEntryPointRule = {
       "StyleSheet:exit"(node) {
         if (globals.length === 0) return;
         const current = path54.normalize(path54.resolve(context.filename));
+        const relative = path54.relative(sourceRoot, current);
         if (globals.includes(current)) {
           if (globals.length > 1) {
             context.report({
@@ -7203,6 +7234,13 @@ var cssEntryPointRule = {
             });
             return;
           }
+          if (relative !== GLOBAL_STYLESHEET_PATH) {
+            context.report({
+              node,
+              message: "The global stylesheet entry point must be src/app/styles/globals.css."
+            });
+            return;
+          }
           const basename = path54.basename(current);
           const importCount = moduleFiles.filter((modulePath) => moduleImports(textOf(modulePath), basename)).length;
           if (importCount !== 1) {
@@ -7213,6 +7251,14 @@ var cssEntryPointRule = {
           }
           return;
         }
+        const isInAppStyles = relative === APP_STYLES_DIR || relative.startsWith(`${APP_STYLES_DIR}${path54.sep}`);
+        if (!isInAppStyles) {
+          context.report({
+            node,
+            message: "Project stylesheets must live under src/app/styles/."
+          });
+          return;
+        }
         const hasProjectCss = node.children.some((child) => {
           if (child.type === "Atrule" && child.name === "import") return false;
           if (child.type === "Comment") return false;
@@ -7270,7 +7316,7 @@ var globalStylesheetRule = {
 };
 
 // eslint/rules/tailwind/unused-utility.ts
-import { statSync as statSync7 } from "fs";
+import { statSync as statSync6 } from "fs";
 function usagePattern(name) {
   return new RegExp(`(?<![\\w-])${escapeRegExp(name)}(?![\\w-])`);
 }
@@ -7286,7 +7332,7 @@ var unusedUtilityRule = {
     const sourceRoot = sourceRootOf(context);
     let files;
     try {
-      if (!statSync7(sourceRoot).isDirectory()) return {};
+      if (!statSync6(sourceRoot).isDirectory()) return {};
       files = findFiles(sourceRoot, SOURCE_EXTENSIONS);
     } catch {
       return {};
@@ -7311,48 +7357,6 @@ var unusedUtilityRule = {
   }
 };
 
-// eslint/rules/tailwind/single-use-utility.ts
-import { statSync as statSync8 } from "fs";
-function usagePattern2(name) {
-  return new RegExp(`(?<![\\\\w-])${escapeRegExp(name)}(?![\\\\w-])`);
-}
-var singleUseUtilityRule = {
-  meta: {
-    schema: [],
-    type: "problem",
-    docs: {
-      description: "Disallow custom utilities referenced by only one source file."
-    }
-  },
-  create(context) {
-    const sourceRoot = sourceRootOf(context);
-    let files;
-    try {
-      if (!statSync8(sourceRoot).isDirectory()) return {};
-      files = findFiles(sourceRoot, SOURCE_EXTENSIONS);
-    } catch {
-      return {};
-    }
-    const textOf = cachedTextReader();
-    return {
-      "StyleSheet:exit"(node) {
-        for (const utility of atrulesNamed(node, "utility")) {
-          const name = preludeIdentifiers(utility)[0];
-          if (!name) continue;
-          const pattern = usagePattern2(name);
-          const definition = `@utility ${name}`;
-          const consumers = files.filter((file) => pattern.test(textOf(file).replaceAll(definition, "")));
-          if (consumers.length !== 1) continue;
-          context.report({
-            node: utility,
-            message: `Custom utility "${name}" is used by only one source file; keep that styling as static Tailwind classes in its consumer.`
-          });
-        }
-      }
-    };
-  }
-};
-
 // eslint/rules/tailwind/global-selector-styling.ts
 function hasStyling(node) {
   for (const child of blockChildren2(node)) {
@@ -7394,12 +7398,11 @@ var tailwindRules = {
   "stylesheet-ordering": stylesheetOrderingRule,
   "css-variable-naming": cssVariableNamingRule,
   "custom-utility-apply": customUtilityApplyRule,
-  "skin-utility": skinUtilityRule,
+  "utility-mapping": utilityMappingRule,
   "theme-variable-namespace": themeVariableNamespaceRule,
   "css-entry-point": cssEntryPointRule,
   "global-stylesheet": globalStylesheetRule,
   "unused-utility": unusedUtilityRule,
-  "single-use-utility": singleUseUtilityRule,
   "global-selector-styling": globalSelectorStylingRule
 };
 
@@ -7618,7 +7621,7 @@ var nextjsStackRule = {
 };
 
 // eslint/rules/package-json/vitest-coverage.ts
-import { existsSync as existsSync5, readFileSync as readFileSync11 } from "fs";
+import { existsSync as existsSync5, readFileSync as readFileSync10 } from "fs";
 import path55 from "path";
 function memberName4(member) {
   return member.name.type === "String" ? member.name.value : member.name.name;
@@ -7696,7 +7699,7 @@ var vitestCoverageRule = {
           });
           return;
         }
-        const content = readFileSync11(path55.join(context.cwd, configName), "utf8");
+        const content = readFileSync10(path55.join(context.cwd, configName), "utf8");
         for (const metric of THRESHOLD_METRICS) {
           if (!new RegExp(`\\b${metric}\\s*:\\s*[1-9]\\d*`).test(content)) {
             context.report({ node, message: `${configName} must set a coverage threshold above zero for ${metric}.` });
@@ -7742,7 +7745,7 @@ var nextjsPackageJsonRules = {
 };
 
 // eslint/rules/husky/husky-hook.ts
-import { existsSync as existsSync6, readFileSync as readFileSync12 } from "fs";
+import { existsSync as existsSync6, readFileSync as readFileSync11 } from "fs";
 import path56 from "path";
 var VITEST_CONFIG_NAMES2 = [
   "vitest.config.ts",
@@ -7777,7 +7780,7 @@ var huskyHookRule = {
           });
           return;
         }
-        const content = readFileSync12(hookPath, "utf8");
+        const content = readFileSync11(hookPath, "utf8");
         const scripts = root.members.find((member) => memberName5(member) === "scripts");
         const scriptNames = new Set(scripts?.value.type === "Object" ? scripts.value.members.map(memberName5) : []);
         const requireNamedScript = (name) => {
@@ -7839,7 +7842,7 @@ var huskyRules = {
 };
 
 // eslint/rules/vulyk/tracked-docs.ts
-import { existsSync as existsSync7, readFileSync as readFileSync13 } from "fs";
+import { existsSync as existsSync7, readFileSync as readFileSync12 } from "fs";
 import path57 from "path";
 var PASIKA_REPO = "Bredansky/pasika";
 var BASE_REQUIRED_TRACKED_DOCS = [
@@ -7882,7 +7885,7 @@ var trackedDocsRule = {
           });
           return;
         }
-        const config = readFileSync13(configPath, "utf8");
+        const config = readFileSync12(configPath, "utf8");
         if (!config.includes(PASIKA_REPO)) {
           context.report({
             node,
@@ -7989,6 +7992,7 @@ var pasikaNextjsAppRules = {
   "ui-state": uiStateRule,
   "no-mixed-concerns": noMixedConcernsRule,
   "no-arbitrary-tailwind": noArbitraryTailwindRule,
+  "no-literal-inline-style": noLiteralInlineStyleRule,
   "unknown-utility": unknownUtilityRule,
   "enforce-cn-merge": enforceCnMergeRule,
   "cn-helper": cnHelperRule,
@@ -8011,7 +8015,6 @@ var pasikaNextjsAppRules = {
   "locale-placement": localePlacementRule,
   "sole-state-owner": soleStateOwnerRule,
   "locale-key-shape": localeKeyShapeRule,
-  "shared-style-dedup": sharedStyleDedupRule,
   "repeated-structure": repeatedStructureRule
 };
 var pasikaPlugin = {
@@ -8064,7 +8067,7 @@ var pasikaNextjsAppConfig = {
   rules: Object.fromEntries(pasikaNextjsAppRuleIds.map((id) => [id, "error"]))
 };
 var tailwindStructureRules = {
-  files: ["src/**/globals.css"],
+  files: ["src/app/styles/globals.css"],
   plugins: {
     css,
     pasika: pasikaPlugin
@@ -8108,10 +8111,6 @@ var zirkaConfig = {
 };
 var documentationConfig = {
   files: ["docs/**/*.md"],
-  // vulyk-generated agent files are not authored docs: with per-directory
-  // targets they can land under docs/ (e.g. docs/AGENTS.md) and must not be
-  // held to the documentation guide.
-  ignores: ["**/_*/**", "**/AGENTS.md", "**/CLAUDE.md"],
   plugins: {
     markdown,
     pasika: pasikaPlugin

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pasika",
-  "version": "0.10.31",
+  "version": "0.10.33",
   "description": "Reusable agent setup package",
   "repository": {
     "type": "git",
@@ -88,6 +88,7 @@
     "tsx": "4.23.12",
     "typescript": "6.0.3",
     "vitest": "5.0.0",
+    "vulyk": "0.15.1",
     "zirka": "0.0.65",
     "zod": "4.4.3"
   },