pasika 0.3.8 → 0.4.0

package/dist/eslint/pasika/index.js

@@ -1,3 +1,8 @@
+// eslint/index.ts
+import css from "@eslint/css";
+import jsonPlugin from "@eslint/json";
+import markdown from "@eslint/markdown";
+
 // eslint/rules/filename-case.ts
 import path2 from "path";
 
@@ -547,6 +552,43 @@ var enforceCnMergeRule = {
   }
 };
 
+// eslint/rules/cn-helper.ts
+function isIdentifier(node, name) {
+  return node?.type === "Identifier" && node.name === name;
+}
+var cnHelperRule = {
+  meta: {
+    schema: [],
+    type: "problem",
+    docs: {
+      description: "Require the cn helper to merge clsx and tailwind-merge."
+    }
+  },
+  create(context) {
+    return {
+      FunctionDeclaration(node) {
+        if (isIdentifier(node.id, "cn")) checkBody(context, node.body);
+      },
+      VariableDeclarator(node) {
+        if (node.init?.type === "ArrowFunctionExpression" && isIdentifier(node.id, "cn")) {
+          checkBody(context, node.init.body);
+        }
+      }
+    };
+  }
+};
+function checkBody(context, body) {
+  const source = context.sourceCode.getText(body);
+  const usesClsx = /\bclsx\b/.test(source);
+  const usesTwMerge = /\btwMerge\b|\btailwind-merge\b/.test(source);
+  if (!usesClsx || !usesTwMerge) {
+    context.report({
+      node: body,
+      message: "cn must be built from clsx and tailwind-merge (e.g. cn = twMerge(clsx(inputs)))."
+    });
+  }
+}
+
 // eslint/rules/enforce-cva-variant-props.ts
 var enforceCvaVariantPropsRule = {
   meta: {
@@ -3224,48 +3266,96 @@ var sourceUnderSrcRule = {
   }
 };
 
-// eslint/rules/config-baseline.ts
+// eslint/rules/zirka-baseline.ts
 import fs4 from "fs";
 import path33 from "path";
-var configBaselineRule = {
+var ESLINT_CONFIG = /^eslint\.config\.(?:ts|mts|cts|js|mjs|cjs)$/;
+var PRETTIER_CONFIGS = [
+  "prettier.config.mjs",
+  "prettier.config.cjs",
+  "prettier.config.js",
+  "prettier.config.ts",
+  "prettier.config.mts",
+  "prettier.config.cts"
+];
+var zirkaBaselineRule = {
   meta: {
     schema: [],
     type: "problem",
     docs: {
-      description: "Require eslint config to reference zirka and tsconfig.json to exist."
+      description: "Require eslint, prettier, and TypeScript configuration to come from zirka."
     }
   },
   create(context) {
     const filename = path33.resolve(context.filename);
     const basename = path33.basename(filename);
-    if (!/^eslint\.config\.(?:ts|mts|cts|js|mjs|cjs)$/.test(basename)) return {};
+    if (!ESLINT_CONFIG.test(basename)) return {};
+    const projectRoot = path33.dirname(filename);
+    const report3 = (message) => {
+      context.report({
+        node: context.sourceCode.ast,
+        loc: { line: 1, column: 0 },
+        message
+      });
+    };
     return {
-      Program(node) {
-        const content = context.sourceCode.getText();
-        if (!content.includes("zirka")) {
-          context.report({
-            node,
-            loc: { line: 1, column: 0 },
-            message: "ESLint config must reference zirka. Use the pasika/zirka baseline configuration."
-          });
+      Program() {
+        if (!referencesZirka(context.sourceCode)) {
+          report3(
+            'ESLint config must take its configuration from zirka (import { styleguide } from "zirka") instead of restating rules locally.'
+          );
         }
-        const projectRoot = path33.dirname(filename);
-        if (!fs4.existsSync(path33.join(projectRoot, "tsconfig.json"))) {
-          context.report({
-            node,
-            loc: { line: 1, column: 0 },
-            message: "No tsconfig.json found. Create one extending the pasika baseline."
-          });
+        const tsconfigPath = path33.join(projectRoot, "tsconfig.json");
+        if (!fs4.existsSync(tsconfigPath)) {
+          report3('No tsconfig.json found. Create one extending the zirka TypeScript base config ("zirka/typescript").');
+        } else {
+          let extendsValue;
+          try {
+            const parsed = JSON.parse(fs4.readFileSync(tsconfigPath, "utf8"));
+            extendsValue = typeof parsed === "object" && parsed !== null && "extends" in parsed ? parsed.extends : void 0;
+          } catch {
+            report3(
+              'tsconfig.json must be valid JSON and extend the zirka TypeScript base config ("zirka/typescript").'
+            );
+            return;
+          }
+          if (typeof extendsValue !== "string" || !extendsValue.startsWith("zirka")) {
+            report3('tsconfig.json must extend the zirka TypeScript base config ("zirka/typescript").');
+          }
+        }
+        const prettierConfigFile = PRETTIER_CONFIGS.find((name) => fs4.existsSync(path33.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 = fs4.readFileSync(path33.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."
+            );
+          }
         }
       }
     };
   }
 };
+function referencesZirka(sourceCode) {
+  for (const statement of sourceCode.ast.body) {
+    if (statement.type === "ImportDeclaration" && typeof statement.source.value === "string" && statement.source.value.startsWith("zirka")) {
+      return true;
+    }
+  }
+  return /require\(\s*["']zirka["']\s*\)/.test(sourceCode.getText());
+}
+
+// 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`);
 
-// eslint/rules/md/helpers.ts
-var RFC_PATTERN = /\b(?<keyword>MUST NOT|MUST|SHALL NOT|SHALL|SHOULD NOT|SHOULD|MAY|RECOMMENDED|NOT RECOMMENDED|OPTIONAL|REQUIRED)\b/;
+// eslint/rules/documentation/helpers.ts
 function containsRfcKeyword(text) {
-  const match = RFC_PATTERN.exec(text);
+  const match = RFC_2119_PATTERN.exec(text);
   return match?.groups?.keyword ?? null;
 }
 function getFilename(context) {
@@ -3282,7 +3372,7 @@ function getLine(node) {
   return node.position?.start.line ?? 0;
 }
 
-// eslint/rules/md/doc-kind-suffix.ts
+// eslint/rules/documentation/doc-kind-suffix.ts
 var docKindSuffixRule = {
   meta: {
     type: "problem",
@@ -3308,7 +3398,7 @@ var docKindSuffixRule = {
   }
 };
 
-// eslint/rules/md/title-matches-file-name.ts
+// eslint/rules/documentation/title-matches-file-name.ts
 import path34 from "path";
 function toExpectedFileName(title) {
   return `${title.toLowerCase().replaceAll(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "")}.md`;
@@ -3346,90 +3436,10 @@ var titleMatchesFileNameRule = {
   }
 };
 
-// eslint/rules/md/overview-present.ts
-var overviewPresentRule = {
-  meta: {
-    type: "problem",
-    docs: {
-      description: "Overview must follow the title in a documentation file.",
-      recommended: true
-    }
-  },
-  create(context) {
-    return {
-      root(node) {
-        const filename = getFilename(context);
-        if (!filename.endsWith(".md")) return;
-        let titleLine = 0;
-        for (const child of node.children) {
-          if (child.type === "heading" && child.depth === 1) {
-            titleLine = getLine(child);
-            break;
-          }
-        }
-        if (!titleLine) return;
-        let hasOverview = false;
-        for (const child of node.children) {
-          if (child.type === "paragraph" && getLine(child) > titleLine && getTextContent(child).trim()) {
-            hasOverview = true;
-            break;
-          }
-        }
-        if (!hasOverview) {
-          context.report({
-            node,
-            message: "no overview follows the title"
-          });
-        }
-      }
-    };
-  }
-};
-
-// eslint/rules/md/overview-length.ts
+// eslint/rules/documentation/overview.ts
 function countSentences(text) {
   return text.split(/[.!?](?:\s+|$)/).filter((part) => part.trim() !== "").length;
 }
-var overviewLengthRule = {
-  meta: {
-    type: "problem",
-    docs: {
-      description: "Overview must contain at most two sentences.",
-      recommended: true
-    }
-  },
-  create(context) {
-    return {
-      root(node) {
-        const filename = getFilename(context);
-        if (!filename.endsWith(".md")) return;
-        let titleLine = 0;
-        for (const child of node.children) {
-          if (child.type === "heading" && child.depth === 1) {
-            titleLine = getLine(child);
-            break;
-          }
-        }
-        if (!titleLine) return;
-        for (const child of node.children) {
-          if (child.type !== "paragraph" || getLine(child) <= titleLine) continue;
-          const text = getTextContent(child).trim();
-          if (!text || text.startsWith("#")) continue;
-          const sentenceCount = countSentences(text);
-          if (sentenceCount > 2) {
-            context.report({
-              node: child,
-              message: `overview uses ${String(sentenceCount)} sentences, at most two are allowed`
-            });
-          }
-          break;
-        }
-      }
-    };
-  }
-};
-
-// eslint/rules/md/guide-overview-no-links.ts
 function containsLink(node) {
   if (node.type === "link") return true;
   if ("children" in node) {
@@ -3437,11 +3447,11 @@ function containsLink(node) {
   }
   return false;
 }
-var guideOverviewNoLinksRule = {
+var overviewRule = {
   meta: {
     type: "problem",
     docs: {
-      description: "Guide overview must not link to other documents.",
+      description: "Overview must exist, contain at most two sentences, and not link to other documents.",
       recommended: true
     }
   },
@@ -3449,7 +3459,7 @@ var guideOverviewNoLinksRule = {
     return {
       root(node) {
         const filename = getFilename(context);
-        if (!filename.endsWith("-guide.md")) return;
+        if (!filename.endsWith(".md")) return;
         let titleLine = 0;
         for (const child of node.children) {
           if (child.type === "heading" && child.depth === 1) {
@@ -3458,24 +3468,38 @@ var guideOverviewNoLinksRule = {
           }
         }
         if (!titleLine) return;
+        let sentenceCount = 0;
+        let found = false;
         for (const child of node.children) {
+          if (child.type === "heading" && getLine(child) > titleLine) break;
           if (child.type !== "paragraph" || getLine(child) <= titleLine) continue;
           const text = getTextContent(child).trim();
           if (!text || text.startsWith("#")) continue;
+          found = true;
           if (containsLink(child)) {
             context.report({
               node: child,
-              message: "guide overview links another document"
+              message: "overview links another document"
             });
           }
-          break;
+          sentenceCount += countSentences(text);
+          if (sentenceCount > 2) {
+            context.report({
+              node: child,
+              message: `overview uses ${String(sentenceCount)} sentences, at most two are allowed`
+            });
+            break;
+          }
+        }
+        if (!found) {
+          context.report({ node, message: "no overview follows the title" });
         }
       }
     };
   }
 };
 
-// eslint/rules/md/guide-step-single-sentence.ts
+// eslint/rules/documentation/guide-step-single-sentence.ts
 function countSentences2(text) {
   return text.split(/[.!?](?:\s+|$)/).filter((part) => part.trim() !== "").length;
 }
@@ -3513,7 +3537,7 @@ var guideStepSingleSentenceRule = {
   }
 };
 
-// eslint/rules/md/guide-step-single-link.ts
+// eslint/rules/documentation/guide-step-single-link.ts
 function countDocLinks(node) {
   if (node.type === "link" && node.url.endsWith(".md")) return 1;
   if ("children" in node) {
@@ -3556,7 +3580,7 @@ var guideStepSingleLinkRule = {
   }
 };
 
-// eslint/rules/md/guide-states-no-requirement.ts
+// eslint/rules/documentation/guide-states-no-requirement.ts
 var guideStatesNoRequirementRule = {
   meta: {
     type: "problem",
@@ -3582,7 +3606,7 @@ var guideStatesNoRequirementRule = {
   }
 };
 
-// eslint/rules/md/requirement-present.ts
+// eslint/rules/documentation/requirement-present.ts
 function hasRequirement(node) {
   if (node.type === "listItem") {
     if (containsRfcKeyword(getTextContent(node))) return true;
@@ -3621,7 +3645,7 @@ var requirementPresentRule = {
   }
 };
 
-// eslint/rules/md/rule-paired-examples.ts
+// eslint/rules/documentation/rule-paired-examples.ts
 var rulePairedExamplesRule = {
   meta: {
     type: "problem",
@@ -3657,7 +3681,7 @@ var rulePairedExamplesRule = {
   }
 };
 
-// eslint/rules/md/example-heading-description.ts
+// eslint/rules/documentation/example-heading-description.ts
 var exampleHeadingDescriptionRule = {
   meta: {
     type: "problem",
@@ -3685,7 +3709,7 @@ var exampleHeadingDescriptionRule = {
   }
 };
 
-// eslint/rules/md/policy-no-examples.ts
+// eslint/rules/documentation/policy-no-examples.ts
 var policyNoExamplesRule = {
   meta: {
     type: "problem",
@@ -3712,7 +3736,7 @@ var policyNoExamplesRule = {
   }
 };
 
-// eslint/rules/md/no-cross-document-link.ts
+// eslint/rules/documentation/no-cross-document-link.ts
 function linkedKind(filename) {
   if (filename.endsWith("-rule.md")) return "rule";
   if (filename.endsWith("-reference.md")) return "reference";
@@ -3744,7 +3768,7 @@ var noCrossDocumentLinkRule = {
   }
 };
 
-// eslint/rules/md/reference-no-rfc-vocabulary.ts
+// eslint/rules/documentation/reference-no-rfc-vocabulary.ts
 var referenceNoRfcVocabularyRule = {
   meta: {
     type: "problem",
@@ -3770,7 +3794,7 @@ var referenceNoRfcVocabularyRule = {
   }
 };
 
-// eslint/rules/md/reference-block-headings.ts
+// eslint/rules/documentation/reference-block-headings.ts
 var referenceBlockHeadingsRule = {
   meta: {
     type: "problem",
@@ -3801,7 +3825,7 @@ var referenceBlockHeadingsRule = {
   }
 };
 
-// eslint/rules/md/support-document-placement.ts
+// eslint/rules/documentation/support-document-placement.ts
 import path35 from "path";
 var supportDocumentPlacementRule = {
   meta: {
@@ -3834,7 +3858,7 @@ var supportDocumentPlacementRule = {
   }
 };
 
-// eslint/rules/md/no-template-prompt.ts
+// eslint/rules/documentation/no-template-prompt.ts
 var TEMPLATE_PROMPT = /^\s*\[[A-Z0-9].*\]\s*$/;
 var noTemplatePromptRule = {
   meta: {
@@ -3858,10 +3882,10 @@ var noTemplatePromptRule = {
   }
 };
 
-// eslint/rules/md/guide-folder-entry-point.ts
+// eslint/rules/documentation/guide-folder-entry-point.ts
 import path37 from "path";
 
-// eslint/rules/md/project-index.ts
+// eslint/rules/documentation/project-index.ts
 import { readdirSync as readdirSync2, readFileSync as readFileSync4, statSync as statSync3 } from "fs";
 import path36 from "path";
 var KIND_BY_SUFFIX = [
@@ -3915,7 +3939,7 @@ function findDocsRoot(filePath) {
   }
 }
 
-// eslint/rules/md/guide-folder-entry-point.ts
+// eslint/rules/documentation/guide-folder-entry-point.ts
 var guideFolderEntryPointRule = {
   meta: {
     type: "problem",
@@ -3953,7 +3977,7 @@ var guideFolderEntryPointRule = {
   }
 };
 
-// eslint/rules/md/rfc-only-in-bullets.ts
+// eslint/rules/documentation/rfc-only-in-bullets.ts
 function checkOutsideBullets(node, context, insideBullet) {
   if (node.type === "listItem") {
     for (const child of node.children) {
@@ -3996,7 +4020,7 @@ var rfcOnlyInBulletsRule = {
   }
 };
 
-// eslint/rules/md/rfc-keyword-in-every-bullet.ts
+// eslint/rules/documentation/rfc-keyword-in-every-bullet.ts
 function checkBullets(node, context) {
   if (node.type === "listItem" && !containsRfcKeyword(getTextContent(node))) {
     context.report({
@@ -4029,7 +4053,7 @@ var rfcKeywordInEveryBulletRule = {
   }
 };
 
-// eslint/rules/md/policy-subject-headings.ts
+// eslint/rules/documentation/policy-subject-headings.ts
 var policySubjectHeadingsRule = {
   meta: {
     type: "problem",
@@ -4082,7 +4106,7 @@ var policySubjectHeadingsRule = {
   }
 };
 
-// eslint/rules/md/guide-link-anchors.ts
+// eslint/rules/documentation/guide-link-anchors.ts
 function visitSteps2(node, check) {
   if (node.type === "list" && node.ordered) {
     for (const child of node.children) check(child);
@@ -4126,7 +4150,7 @@ var guideLinkAnchorsRule = {
   }
 };
 
-// eslint/rules/md/no-nested-how-to.ts
+// eslint/rules/documentation/no-nested-how-to.ts
 var noNestedHowToRule = {
   meta: {
     type: "problem",
@@ -4162,7 +4186,7 @@ var noNestedHowToRule = {
   }
 };
 
-// eslint/rules/md/glossary-term-linking.ts
+// eslint/rules/documentation/glossary-term-linking.ts
 import { readFileSync as readFileSync5 } from "fs";
 import path38 from "path";
 function extractGlossaryTerms(filePath) {
@@ -4243,13 +4267,91 @@ var glossaryTermLinkingRule = {
   }
 };
 
-// eslint/rules/md/index.ts
-var mdRules = {
+// eslint/rules/documentation/guide-mentions-documents.ts
+import { existsSync } from "fs";
+import path39 from "path";
+function visitSteps3(node, check) {
+  if (node.type === "list" && node.ordered) {
+    for (const child of node.children) check(child);
+  }
+  if ("children" in node) {
+    for (const child of node.children) visitSteps3(child, check);
+  }
+}
+function collectMarkdownLinks(node, out) {
+  if (node.type === "link" && node.url.endsWith(".md")) out.push(node);
+  if ("children" in node) {
+    for (const child of node.children) collectMarkdownLinks(child, out);
+  }
+}
+function linkTarget(url) {
+  return url.split("#")[0] ?? url;
+}
+var guideMentionsDocumentsRule = {
+  meta: {
+    type: "problem",
+    docs: {
+      description: "A Guide entry point must reference each owned Rule from a How To step, mention every Reference, and not link a missing document.",
+      recommended: true
+    }
+  },
+  create(context) {
+    return {
+      root(node) {
+        const filename = getFilename(context);
+        if (!filename.endsWith("-guide.md")) return;
+        const docsRoot = findDocsRoot(filename);
+        if (!docsRoot) return;
+        const guideDir = path39.dirname(filename);
+        if (path39.basename(filename, ".md") !== path39.basename(guideDir)) return;
+        const docs = getProjectDocs(docsRoot);
+        const owned = docs.filter((doc) => {
+          const parent = path39.dirname(doc.filePath);
+          return parent === path39.join(guideDir, "rules") || parent === path39.join(guideDir, "references");
+        });
+        const allLinks = [];
+        collectMarkdownLinks(node, allLinks);
+        const stepLinks = [];
+        visitSteps3(node, (item) => {
+          collectMarkdownLinks(item, stepLinks);
+        });
+        const mentionsOf = (links, fileName) => links.some((link) => link.url.split("/").pop() === fileName);
+        for (const doc of owned) {
+          if (doc.kind === "rule") {
+            if (!mentionsOf(stepLinks, doc.fileName)) {
+              context.report({
+                node,
+                message: `Guide entry point does not reference a Rule it owns from a How To step: ${doc.doc}`
+              });
+            }
+          } else if (!mentionsOf(allLinks, doc.fileName)) {
+            context.report({
+              node,
+              message: `Guide entry point does not mention a document it owns: ${doc.doc}`
+            });
+          }
+        }
+        for (const link of allLinks) {
+          const target = linkTarget(link.url);
+          if (!target.endsWith(".md")) continue;
+          const resolved = path39.normalize(path39.join(guideDir, target));
+          if (!existsSync(resolved)) {
+            context.report({
+              node: link,
+              message: `Guide links a document that does not exist: ${link.url}`
+            });
+          }
+        }
+      }
+    };
+  }
+};
+
+// eslint/rules/documentation/index.ts
+var documentationRules = {
   "doc-kind-suffix": docKindSuffixRule,
   "title-matches-file-name": titleMatchesFileNameRule,
-  "overview-present": overviewPresentRule,
-  "overview-length": overviewLengthRule,
-  "guide-overview-no-links": guideOverviewNoLinksRule,
+  overview: overviewRule,
   "guide-step-single-sentence": guideStepSingleSentenceRule,
   "guide-step-single-link": guideStepSingleLinkRule,
   "guide-states-no-requirement": guideStatesNoRequirementRule,
@@ -4268,10 +4370,11 @@ var mdRules = {
   "policy-subject-headings": policySubjectHeadingsRule,
   "guide-link-anchors": guideLinkAnchorsRule,
   "no-nested-how-to": noNestedHowToRule,
-  "glossary-term-linking": glossaryTermLinkingRule
+  "glossary-term-linking": glossaryTermLinkingRule,
+  "guide-mentions-documents": guideMentionsDocumentsRule
 };
 
-// eslint/rules/css/helpers.ts
+// eslint/rules/tailwind/helpers.ts
 function walkNodes(node, visit) {
   visit(node);
   if ("children" in node && node.children) {
@@ -4328,7 +4431,7 @@ function selectorNames(node) {
   return names;
 }
 
-// eslint/rules/css/theme-reset.ts
+// eslint/rules/tailwind/theme-reset.ts
 var themeResetRule = {
   meta: {
     schema: [],
@@ -4358,7 +4461,7 @@ var themeResetRule = {
   }
 };
 
-// eslint/rules/css/root-variables.ts
+// eslint/rules/tailwind/root-variables.ts
 var rootVariablesRule = {
   meta: {
     schema: [],
@@ -4401,7 +4504,7 @@ var rootVariablesRule = {
   }
 };
 
-// eslint/rules/css/apply-usage.ts
+// eslint/rules/tailwind/apply-usage.ts
 var applyUsageRule = {
   meta: {
     schema: [],
@@ -4431,7 +4534,7 @@ var applyUsageRule = {
   }
 };
 
-// eslint/rules/css/base-layer-pair.ts
+// eslint/rules/tailwind/base-layer-pair.ts
 var baseLayerPairRule = {
   meta: {
     schema: [],
@@ -4469,7 +4572,7 @@ var baseLayerPairRule = {
   }
 };
 
-// eslint/rules/css/stylesheet-ordering.ts
+// eslint/rules/tailwind/stylesheet-ordering.ts
 var SECTION_ORDER = ["imports", "custom-variant", "root", "theme", "utility", "base styles", "keyframes"];
 var stylesheetOrderingRule = {
   meta: {
@@ -4526,7 +4629,7 @@ var stylesheetOrderingRule = {
   }
 };
 
-// eslint/rules/css/css-variable-naming.ts
+// eslint/rules/tailwind/css-variable-naming.ts
 var cssVariableNamingRule = {
   meta: {
     schema: [],
@@ -4558,7 +4661,7 @@ var cssVariableNamingRule = {
   }
 };
 
-// eslint/rules/css/custom-utility-apply.ts
+// eslint/rules/tailwind/custom-utility-apply.ts
 function rawProperty(raw) {
   const match = /^\s*(?<property>[a-z][a-z-]*)\s*:/.exec(raw);
   return match?.groups?.property;
@@ -4600,7 +4703,7 @@ var customUtilityApplyRule = {
   }
 };
 
-// eslint/rules/css/surface-utility.ts
+// eslint/rules/tailwind/surface-utility.ts
 var surfaceUtilityRule = {
   meta: {
     schema: [],
@@ -4633,7 +4736,7 @@ var surfaceUtilityRule = {
   }
 };
 
-// eslint/rules/css/theme-variable-namespace.ts
+// eslint/rules/tailwind/theme-variable-namespace.ts
 var themeVariableNamespaceRule = {
   meta: {
     schema: [],
@@ -4672,7 +4775,7 @@ var themeVariableNamespaceRule = {
   }
 };
 
-// eslint/rules/css/global-css-location.ts
+// eslint/rules/tailwind/global-css-location.ts
 var globalCssLocationRule = {
   meta: {
     schema: [],
@@ -4703,7 +4806,7 @@ var globalCssLocationRule = {
   }
 };
 
-// eslint/rules/css/global-stylesheet.ts
+// eslint/rules/tailwind/global-stylesheet.ts
 var globalStylesheetRule = {
   meta: {
     schema: [],
@@ -4736,8 +4839,8 @@ var globalStylesheetRule = {
   }
 };
 
-// eslint/rules/css/index.ts
-var cssRules = {
+// eslint/rules/tailwind/index.ts
+var tailwindRules = {
   "theme-reset": themeResetRule,
   "root-variables": rootVariablesRule,
   "apply-usage": applyUsageRule,
@@ -4751,10 +4854,50 @@ var cssRules = {
   "global-stylesheet": globalStylesheetRule
 };
 
-// eslint/rules/json/no-vulyk-dependency.ts
+// eslint/rules/package-json/exact-version.ts
 function memberName(member) {
   return member.name.type === "String" ? member.name.value : member.name.name;
 }
+var EXACT_VERSION_PATTERN = /^\d+\.\d+\.\d+$/;
+function memberValue(member) {
+  return member.value.type === "String" ? member.value.value : null;
+}
+var exactVersionRule = {
+  meta: {
+    schema: [],
+    type: "problem",
+    docs: {
+      description: "Require dependency and devDependency versions to be pinned exactly."
+    }
+  },
+  create(context) {
+    return {
+      Document(node) {
+        const root = node.body;
+        if (root.type !== "Object") return;
+        for (const key of ["dependencies", "devDependencies"]) {
+          const section = root.members.find((member) => memberName(member) === key);
+          if (section?.value.type !== "Object") continue;
+          for (const member of section.value.members) {
+            const version = memberValue(member);
+            if (version === null) continue;
+            if (!EXACT_VERSION_PATTERN.test(version)) {
+              context.report({
+                node: member,
+                message: `${memberName(member)} must pin an exact version (e.g. "1.2.3"), not a range or cap such as "${version}".`
+              });
+            }
+          }
+        }
+      }
+    };
+  }
+};
+
+// eslint/rules/package-json/no-vulyk-dependency.ts
+function memberName2(member) {
+  return member.name.type === "String" ? member.name.value : member.name.name;
+}
 var noVulykDependencyRule = {
   meta: {
     schema: [],
@@ -4769,9 +4912,9 @@ var noVulykDependencyRule = {
         const root = node.body;
         if (root.type !== "Object") return;
         for (const key of ["dependencies", "devDependencies"]) {
-          const section = root.members.find((member) => memberName(member) === key);
+          const section = root.members.find((member) => memberName2(member) === key);
           if (section?.value.type !== "Object") continue;
-          const vulyk = section.value.members.find((member) => memberName(member) === "vulyk");
+          const vulyk = section.value.members.find((member) => memberName2(member) === "vulyk");
           if (vulyk) {
             context.report({
               node: vulyk,
@@ -4784,16 +4927,39 @@ var noVulykDependencyRule = {
   }
 };
 
-// eslint/rules/json/zirka-installed.ts
-function memberName2(member) {
+// eslint/rules/package-json/nextjs-stack.ts
+var NEXTJS_STACK_DEPENDENCIES = [
+  "next",
+  "react",
+  "react-dom",
+  "zod",
+  "class-variance-authority",
+  "clsx",
+  "tailwind-merge"
+];
+var NEXTJS_STACK_DEV_DEPENDENCIES = [
+  "typescript",
+  "tailwindcss",
+  "eslint",
+  "prettier",
+  "husky",
+  "lint-staged",
+  "zirka"
+];
+function memberName3(member) {
   return member.name.type === "String" ? member.name.value : member.name.name;
 }
-var zirkaInstalledRule = {
+function sectionPackages(root, section) {
+  const member = root.type === "Object" ? root.members.find((entry) => memberName3(entry) === section) : void 0;
+  if (member?.value.type !== "Object") return /* @__PURE__ */ new Set();
+  return new Set(member.value.members.map(memberName3));
+}
+var nextjsStackRule = {
   meta: {
     schema: [],
     type: "problem",
     docs: {
-      description: "Require zirka to be listed in package.json as a devDependency."
+      description: "Require the framework's runtime packages in dependencies and toolchain packages in devDependencies."
     }
   },
   create(context) {
@@ -4801,18 +4967,20 @@ var zirkaInstalledRule = {
       Document(node) {
         const root = node.body;
         if (root.type !== "Object") return;
-        const allDeps = [];
-        for (const key of ["dependencies", "devDependencies"]) {
-          const section = root.members.find((member) => memberName2(member) === key);
-          if (section?.value.type !== "Object") continue;
-          for (const member of section.value.members) {
-            allDeps.push(memberName2(member));
-          }
+        const dependencies = sectionPackages(root, "dependencies");
+        const devDependencies = sectionPackages(root, "devDependencies");
+        for (const pkg of NEXTJS_STACK_DEPENDENCIES) {
+          if (dependencies.has(pkg)) continue;
+          context.report({
+            node,
+            message: `${pkg} must be listed in package.json as a dependency.`
+          });
         }
-        if (!allDeps.includes("zirka")) {
+        for (const pkg of NEXTJS_STACK_DEV_DEPENDENCIES) {
+          if (devDependencies.has(pkg)) continue;
           context.report({
             node,
-            message: "zirka must be listed in package.json as a devDependency."
+            message: `${pkg} must be listed in package.json as a devDependency.`
           });
         }
       }
@@ -4820,76 +4988,280 @@ var zirkaInstalledRule = {
   }
 };
 
-// eslint/rules/json/index.ts
-var jsonRules = {
+// eslint/rules/package-json/index.ts
+var repoPackageJsonRules = {
   "no-vulyk-dependency": noVulykDependencyRule,
-  "zirka-installed": zirkaInstalledRule
+  "exact-version": exactVersionRule
+};
+var nextPackageJsonRules = {
+  "nextjs-stack": nextjsStackRule
+};
+
+// eslint/rules/husky/husky-hook.ts
+import { existsSync as existsSync2, readFileSync as readFileSync6 } from "fs";
+import path40 from "path";
+function memberName4(member) {
+  return member.name.type === "String" ? member.name.value : member.name.name;
+}
+var huskyHookRule = {
+  meta: {
+    schema: [],
+    type: "problem",
+    docs: {
+      description: "Require a pre-commit hook that runs lint-staged, typecheck, and the libyear drift check."
+    }
+  },
+  create(context) {
+    return {
+      Document(node) {
+        const root = node.body;
+        if (root.type !== "Object") return;
+        const scriptName = context.filename;
+        if (!scriptName.endsWith("package.json")) return;
+        const hookPath = path40.join(process.cwd(), ".husky", "pre-commit");
+        if (!existsSync2(hookPath)) {
+          context.report({
+            node,
+            message: "No .husky/pre-commit hook found. Configure husky to run checks before commits."
+          });
+          return;
+        }
+        const content = readFileSync6(hookPath, "utf8");
+        if (!content.includes("lint-staged")) {
+          context.report({ node, message: ".husky/pre-commit must run lint-staged." });
+        }
+        if (!content.includes("typecheck")) {
+          context.report({ node, message: ".husky/pre-commit must run npm run typecheck." });
+        }
+        if (!content.includes("libyear --limit-major-individual=1")) {
+          context.report({ node, message: ".husky/pre-commit must run npx libyear --limit-major-individual=1." });
+        }
+        const scripts = root.members.find((member) => memberName4(member) === "scripts");
+        if (scripts?.value.type === "Object") {
+          const prepare = scripts.value.members.find((member) => memberName4(member) === "prepare");
+          if (prepare?.value.type === "String" && !prepare.value.value.includes("husky")) {
+            context.report({
+              node: prepare,
+              message: 'package.json "prepare" script must run husky (e.g. "prepare": "husky").'
+            });
+          }
+        }
+      }
+    };
+  }
+};
+
+// eslint/rules/husky/index.ts
+var huskyRules = {
+  "husky-hook": huskyHookRule
+};
+
+// eslint/rules/vulyk/vulyk-docs.ts
+import { existsSync as existsSync3, readFileSync as readFileSync7 } from "fs";
+import path41 from "path";
+var PASIKA_REPO = "Bredansky/pasika";
+var vulykDocsRule = {
+  meta: {
+    schema: [],
+    type: "problem",
+    docs: {
+      description: "Require vulyk.config.ts to track the framework's docs from pasika and the generated AGENTS.md."
+    }
+  },
+  create(context) {
+    return {
+      Document(node) {
+        if (!context.filename.endsWith("package.json")) return;
+        const projectRoot = path41.dirname(path41.resolve(context.filename));
+        const configPath = path41.join(projectRoot, "vulyk.config.ts");
+        if (!existsSync3(configPath)) {
+          context.report({
+            node,
+            message: "No vulyk.config.ts found. Run npx vulyk@latest init to create one that tracks the framework's docs."
+          });
+          return;
+        }
+        const config = readFileSync7(configPath, "utf8");
+        if (!config.includes(PASIKA_REPO)) {
+          context.report({
+            node,
+            message: "vulyk.config.ts must track the framework's docs from the pasika repository."
+          });
+        }
+        const agentsPath = path41.join(projectRoot, "AGENTS.md");
+        if (!existsSync3(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."
+          });
+        }
+      }
+    };
+  }
+};
+
+// eslint/rules/vulyk/index.ts
+var vulykRules = {
+  "vulyk-docs": vulykDocsRule
 };
 
 // eslint/index.ts
-var pasikaRules = {
-  "component-placement": componentPlacementRule,
-  "support-file-placement": supportFilePlacementRule,
-  "application-structure": applicationStructureRule,
+var typescriptAppRules = {
+  "filename-case": filenameCaseRule,
+  "import-boundaries": importBoundariesRule,
   "named-exports": namedExportsRule,
-  "data-testid-case": dataTestIdCaseRule,
+  "support-file-placement": supportFilePlacementRule,
   "support-folder-shape": supportFolderShapeRule,
   "import-through-index": importThroughIndexRule,
   "util-file-name": utilFileNameRule,
   "no-util-barrel": noUtilBarrelRule,
+  "enforce-barrel-exports": enforceBarrelExportsRule,
+  "config-extraction": configExtractionRule,
+  "value-extraction": valueExtractionRule,
+  "type-extraction": typeExtractionRule,
+  "zod-schema-validation": zodSchemaValidationRule,
+  "source-under-src": sourceUnderSrcRule,
+  "zirka-baseline": zirkaBaselineRule
+};
+var nextjsAppRules = {
+  "component-placement": componentPlacementRule,
+  "application-structure": applicationStructureRule,
+  "data-testid-case": dataTestIdCaseRule,
   "jsx-hygiene": jsxHygieneRule,
   "interactive-component": interactiveComponentRule,
   "ui-state": uiStateRule,
-  "filename-case": filenameCaseRule,
-  "import-boundaries": importBoundariesRule,
   "no-mixed-concerns": noMixedConcernsRule,
   "no-arbitrary-tailwind": noArbitraryTailwindRule,
   "enforce-cn-merge": enforceCnMergeRule,
+  "cn-helper": cnHelperRule,
   "enforce-cva-variant-props": enforceCvaVariantPropsRule,
   "cva-appearance-props": cvaAppearancePropsRule,
   "cva-boolean-variants": cvaBooleanVariantsRule,
-  "enforce-barrel-exports": enforceBarrelExportsRule,
   "cross-feature-import": crossFeatureImportRule,
   "pure-function-extract": pureFunctionExtractRule,
   "hook-complexity": hookComplexityRule,
   "locale-dotted-path": localeDottedPathRule,
   "locales-location": localesLocationRule,
   "hook-extraction": hookExtractionRule,
-  "value-extraction": valueExtractionRule,
-  "config-extraction": configExtractionRule,
   "component-nesting": componentNestingRule,
   "stay-flat": stayFlatRule,
-  "type-extraction": typeExtractionRule,
   "locale-placement": localePlacementRule,
   "sole-state-owner": soleStateOwnerRule,
   "locale-key-shape": localeKeyShapeRule,
   "shared-style-dedup": sharedStyleDedupRule,
-  "repeated-structure": repeatedStructureRule,
-  "zod-schema-validation": zodSchemaValidationRule,
-  "source-under-src": sourceUnderSrcRule,
-  "config-baseline": configBaselineRule
+  "repeated-structure": repeatedStructureRule
+};
+var pasikaRules = {
+  ...typescriptAppRules,
+  ...nextjsAppRules
 };
-var pasikaRuleIds = Object.keys(pasikaRules).map((name) => `pasika/${name}`);
-var pasikaMdRuleIds = Object.keys(mdRules).map((name) => `pasika/${name}`);
-var pasikaCssRuleIds = Object.keys(cssRules).map((name) => `pasika/${name}`);
-var pasikaJsonRuleIds = Object.keys(jsonRules).map((name) => `pasika/${name}`);
-var allPasikaRuleIds = [...pasikaRuleIds, ...pasikaMdRuleIds, ...pasikaCssRuleIds, ...pasikaJsonRuleIds];
-var pasikaConfig = {
+function ruleIds(rules2) {
+  return Object.keys(rules2).map((name) => `pasika/${name}`);
+}
+var typescriptAppRuleIds = ruleIds(typescriptAppRules);
+var nextjsAppRuleIds = ruleIds(nextjsAppRules);
+var pasikaRuleIds = ruleIds(pasikaRules);
+var documentationRuleIds = ruleIds(documentationRules);
+var tailwindRuleIds = ruleIds(tailwindRules);
+var repoPackageJsonRuleIds = ruleIds(repoPackageJsonRules);
+var nextPackageJsonRuleIds = ruleIds(nextPackageJsonRules);
+var huskyRuleIds = ruleIds(huskyRules);
+var vulykRuleIds = ruleIds(vulykRules);
+var allPasikaRuleIds = [
+  ...pasikaRuleIds,
+  ...documentationRuleIds,
+  ...tailwindRuleIds,
+  ...repoPackageJsonRuleIds,
+  ...nextPackageJsonRuleIds,
+  ...huskyRuleIds,
+  ...vulykRuleIds
+];
+var typescriptAppBlock = {
   files: ["src/**/*.{cjs,cts,js,jsx,mjs,mts,ts,tsx}"],
   plugins: {
-    pasika: { rules: pasikaRules }
+    pasika: { rules: typescriptAppRules }
   },
-  rules: Object.fromEntries(pasikaRuleIds.map((id) => [id, "error"]))
+  rules: Object.fromEntries(typescriptAppRuleIds.map((id) => [id, "error"]))
 };
+var nextjsAppBlock = {
+  files: ["src/**/*.{cjs,cts,js,jsx,mjs,mts,ts,tsx}"],
+  plugins: {
+    pasika: { rules: nextjsAppRules }
+  },
+  rules: Object.fromEntries(nextjsAppRuleIds.map((id) => [id, "error"]))
+};
+var tailwindGlobalsBlock = {
+  files: ["src/**/globals.css"],
+  plugins: {
+    css,
+    pasika: { rules: tailwindRules }
+  },
+  language: "css/css",
+  languageOptions: { tolerant: true },
+  rules: Object.fromEntries(
+    tailwindRuleIds.filter((id) => id !== "pasika/global-css-location").map((id) => [id, "error"])
+  )
+};
+var tailwindAnyCssBlock = {
+  files: ["src/**/*.css"],
+  plugins: {
+    css,
+    pasika: { rules: tailwindRules }
+  },
+  language: "css/css",
+  languageOptions: { tolerant: true },
+  rules: { "pasika/global-css-location": "error" }
+};
+var repoManifestBlock = {
+  files: ["package.json"],
+  plugins: {
+    json: { languages: { json: jsonPlugin.languages.json } },
+    pasika: { rules: { ...repoPackageJsonRules, ...huskyRules, ...vulykRules } }
+  },
+  language: "json/json",
+  rules: Object.fromEntries([...repoPackageJsonRuleIds, ...huskyRuleIds, ...vulykRuleIds].map((id) => [id, "error"]))
+};
+var nextManifestBlock = {
+  files: ["package.json"],
+  plugins: {
+    json: { languages: { json: jsonPlugin.languages.json } },
+    pasika: { rules: nextPackageJsonRules }
+  },
+  language: "json/json",
+  rules: Object.fromEntries(nextPackageJsonRuleIds.map((id) => [id, "error"]))
+};
+var zirkaBlock = {
+  files: ["eslint.config.{ts,mts,cts,js,mjs,cjs}"],
+  plugins: { pasika: { rules: { "zirka-baseline": zirkaBaselineRule } } },
+  rules: { "pasika/zirka-baseline": "error" }
+};
+var docsBlock = {
+  files: ["docs/**/*.md"],
+  ignores: ["**/_*/**"],
+  plugins: {
+    markdown,
+    pasika: { rules: documentationRules }
+  },
+  language: "markdown/gfm",
+  rules: Object.fromEntries(documentationRuleIds.map((id) => [id, "error"]))
+};
+var typescriptApp = [repoManifestBlock, zirkaBlock, typescriptAppBlock, docsBlock];
+var nextjsApp = [
+  ...typescriptApp,
+  nextManifestBlock,
+  nextjsAppBlock,
+  tailwindGlobalsBlock,
+  tailwindAnyCssBlock
+];
 export {
   allPasikaRuleIds,
-  cssRules,
-  jsonRules,
-  mdRules,
-  pasikaConfig,
-  pasikaCssRuleIds,
-  pasikaJsonRuleIds,
-  pasikaMdRuleIds,
-  pasikaRuleIds,
-  pasikaRules
+  documentationRules,
+  huskyRules,
+  nextPackageJsonRules,
+  nextjsApp,
+  pasikaRules,
+  repoPackageJsonRules,
+  tailwindRules,
+  typescriptApp,
+  vulykRules
 };