pasika 0.3.8 → 0.3.9

package/README.md

@@ -1,6 +1,6 @@
 # pasika
 
-Documentation, the lint rules derived from it, and the CLI that applies and diagnoses both.
+Documentation, the lint rules derived from it, and the checks that apply and diagnose both.
 
 `pasika` owns the framework's documentation and turns it into checks. Every requirement in `docs/` is recorded in an enforcement registry that says which ESLint rule or `pasika` check governs it — or, when none does, how a reviewer or agent applies it by hand. CI fails when a requirement has no recorded answer.
 
@@ -8,20 +8,24 @@ Documentation, the lint rules derived from it, and the CLI that applies and diag
 
 ```text
 docs/
-  repository-policy.md                 # agent-conduct requirements (Policy)
   repository-policy.md            # repo-wide code and documentation requirements (Policy)
   code-organization-guide/        # placement, extraction, module conventions
   documentation-guide/            # how documents themselves are written
   framework-adoption-guide/       # adopting and updating the framework
   styling-guide/                  # Tailwind theme, composition, variants, states
-enforcement/
+scripts/
   registry.json                   # requirement → enforcement, keyed by content hash
   coverage.ts                     # reconciles the docs against the registry
+  utils/                          # doc parsing, classification, registry IO
+  types/                          # registry schema
+constants/
+  rfc2119.ts                      # single source of truth for RFC 2119 vocabulary
 eslint/
-  pasika/rules/                   # the lint rules, with fixture tests beside them
-  pasika/rules/md/                # the documentation-guide rules, linting docs/ itself
-cli/
-  index.ts                        # the `pasika` command
+  rules/                          # the lint rules, with fixture tests beside them
+  rules/documentation/            # the documentation-guide rules, linting docs/ itself
+  rules/tailwind/                 # the Tailwind stylesheet rules
+  rules/package-json/             # the package.json rules
+  rules/husky/                    # the husky-hook rules
 ```
 
 ## Documentation
@@ -46,27 +50,36 @@ The `text` field is the bullet as written in the document (markdown links and co
 
 Every requirement carries a `note` explaining how it is met: what the ref'd rule or doctor check does and where it falls short, or — with no `ref` — how a reviewer or agent applies it by hand. When a rule governs the requirement's subject without fully deciding it (e.g. its placement), the `ref` still names that rule and the `note` says what stays judgment, so a partial check never reads as a complete one.
 
-`pasika coverage` fails when a requirement has no recorded answer, when its text changed, when it disappeared, when its `ref` names a rule or doctor check that does not exist, or when a requirement a rule governs has no test titled with its text. Confirm a reworded requirement with `pasika coverage --accept`.
+`npm run coverage` fails when a requirement has no recorded answer, when its text changed, when it disappeared, when its `ref` names a rule or doctor check that does not exist, or when a requirement a rule governs has no test titled with its text. Confirm a reworded requirement with `npx tsx scripts/coverage.ts --accept`.
 
 ## Commands
 
 The documentation guide itself is linted: the `pasika/*` markdown rules run over `docs/**/*.md` and report title, overview, structure, example-pairing, and RFC 2119 violations at the exact node.
 
+The coverage checks are standalone scripts under `scripts/`, run with `tsx`; the drift check is the published `libyear` tool — there is no `pasika` binary:
+
 ```bash
-npx pasika coverage            # check that every requirement has recorded enforcement
-npx pasika coverage --accept   # record reworded and removed requirements
+npm run coverage             # check that every requirement has recorded enforcement
+npm run coverage -- --accept # record reworded and removed requirements
+npx libyear --limit-major-individual=1   # fail when a dependency trails the latest by >1 major (drift check)
 ```
 
-Both accept `--json` for agent use.
+Both acceptance and the report accept `--json` for agent use:
 
-A requirement `coverage` reports as `new` is classified with the hash it prints:
+```bash
+npx tsx scripts/coverage.ts            # text report
+npx tsx scripts/coverage.ts --json     # full report as JSON
+npx tsx scripts/coverage.ts --accept   # record accepted changes
+```
+
+A requirement the report shows as `new` is classified with the hash it prints:
 
 ```bash
-npx pasika coverage --classify d311a1457a --ref pasika/import-boundaries --note "reports imports that cross a feature boundary"
-npx pasika coverage --classify 041b665bd7 --note "no check can compare against the previous state"
+npx tsx scripts/coverage.ts --classify d311a1457a --ref pasika/import-boundaries --note "reports imports that cross a feature boundary"
+npx tsx scripts/coverage.ts --classify 041b665bd7 --note "no check can compare against the previous state"
 ```
 
-The command refuses a hash no requirement has, a `ref` naming a rule or doctor check that does not exist, and an entry without a note — so a mismatch cannot reach the registry by hand. Re-running it on an already-recorded requirement replaces the earlier entry.
+The script refuses a hash no requirement has, a `ref` naming a rule or doctor check that does not exist, and a classification without a note — so a mismatch cannot reach the registry by hand. Re-running it on an already-recorded requirement replaces the earlier entry. All of it reads and writes `scripts/registry.json`.
 
 ## ESLint ruleset
 
@@ -90,14 +103,14 @@ export default eslintConfig;
 
 ### Without Zirka
 
-```ts
+````ts
 // eslint.config.ts
-import { pasikaConfig } from "pasika/eslint";
+import { pasikaNext } from "pasika/eslint";
 
-export default [pasikaConfig];
-```
+export default pasikaNext;
+``` `pasikaNext` is the full flat-config array: the `src/**` TS/TSX and Tailwind stylesheet blocks plus everything in `pasikaRepo`. `pasikaRepo` is the repository-level preset — every block that does not touch `src/**` (the package.json manifest, husky hooks, and docs) — and is a strict subset of `pasikaNext`. The granular rule objects (`tailwindRules`, `repoPackageJsonRules`, `documentationRules`) stay exported for manual wiring.
 
-`pasikaConfig` applies the TS/TSX rules to `src/**` only, so a repository without a `src/` tree passes it trivially. The CSS, JSON, and markdown language configs are composed by `zirka`'s `styleguide()`; the individual rule objects (`cssRules`, `jsonRules`, `mdRules`) are exported for manual wiring.
+Because the preset blocks wire ESLint's language plugins, using `pasikaNext` directly (without `zirka`) requires `@eslint/css`, `@eslint/json`, and `@eslint/markdown` to be installed in the consuming project — they are `peerDependencies` of `pasika`. A `zirka`-based setup gets them automatically.
 
 ### TS/TSX rules
 
@@ -140,11 +153,11 @@ export default [pasikaConfig];
 | `pasika/shared-style-dedup` †      | A className combo used by two or more components becomes a named utility                                            |
 | `pasika/repeated-structure`        | A block of elements repeated two or more times is extracted as a named component                                    |
 | `pasika/sole-state-owner`          | A contiguous JSX part that is the sole consumer of a useState hook is extracted into a named component              |
-| `pasika/no-eslint-disable`         | No `eslint-disable` directives                                                                                      |
+| `pasika/config-baseline`           | `eslint.config.*` references zirka and `tsconfig.json` exists                                                       |
 | `pasika/zod-schema-validation`     | Runtime validation through Zod schemas, not hand-written type guards                                                |
 | `pasika/source-under-src`          | Application source lives under `src/`, not in root-level folders                                                    |
 
-### CSS rules
+### Tailwind rules
 
 Applied to `src/**/globals.css` (and other stylesheets) through `@eslint/css` with tolerant Tailwind v4 parsing.
 
@@ -161,20 +174,21 @@ Applied to `src/**/globals.css` (and other stylesheets) through `@eslint/css` wi
 | `pasika/theme-variable-namespace` | Utility class groups share a namespace prefix                                 |
 | `pasika/global-css-location`      | Global CSS lives in the correct entry point                                   |
 
-### JSON rules
+### Package.json rules
 
-Applied to `package.json` through `@eslint/json`.
+Applied to `package.json` through `@eslint/json`. The framework-agnostic subset (`no-vulyk-dependency`, `exact-version`) applies to any repository, including pasika itself; `nextjs-stack` applies to a Next.js/React application.
 
-| Rule                         | Enforces                          |
-| ---------------------------- | --------------------------------- |
-| `pasika/no-cache-flag`       | Lint scripts don't pass `--cache` |
-| `pasika/no-vulyk-dependency` | `vulyk` is not in `dependencies`  |
+| Rule                         | Enforces                                                                            |
+| ---------------------------- | ----------------------------------------------------------------------------------- |
+| `pasika/no-vulyk-dependency` | `vulyk` is not in `dependencies`                                                    |
+| `pasika/exact-version`       | Dependency and devDependency versions are pinned exactly, never ranges              |
+| `pasika/nextjs-stack`        | All Tech Stack Reference packages are listed in `package.json` (Next.js/React apps) |
 
 ### Documentation rules
 
-The `pasika/*` markdown rules enforce the documentation guide over `docs/**/*.md` (24 rules): file-name suffixes and titles, overview presence and length, guide step structure, Incorrect/Correct pairing, policy document shape, reference block headings, RFC 2119 placement, template hygiene, link anchoring, and glossary-term linking. They run through `@eslint/markdown`; `pasika coverage` verifies each has a test and a registry entry. Pasika's own `docs/` are linted by them in CI (`npm run lint`).
+The `pasika/*` markdown rules enforce the documentation guide over `docs/**/*.md` (24 rules): file-name suffixes and titles, overview presence and length, guide step structure, Incorrect/Correct pairing, policy document shape, reference block headings, RFC 2119 placement, template hygiene, link anchoring, and glossary-term linking. They run through `@eslint/markdown`; `npm run coverage` verifies each has a test and a registry entry. Pasika's own `docs/` are linted by them in CI (`npm run lint`).
 
-Run `pasika coverage --json` for the exact requirement each rule covers.
+Run `npx tsx scripts/coverage.ts --json` for the exact requirement each rule covers.
 
 ### † Cross-file rules
 
@@ -185,6 +199,10 @@ Where a component, hook, value, type, or style belongs depends on which files us
 
 All are inert in a repository with no `src/` tree.
 
+## Runtime dependency on typescript
+
+Many of the TS/TSX rules call the TypeScript compiler API directly at lint time, so the published package imports `typescript` at runtime. `tsup` keeps it external (unbundled); `pasika` lists it as a pinned `dependency` so an installing consumer gets a version known to work with the rules. There is no `typescript` `peerDependency`.
+
 ## Development
 
 ```bash
@@ -193,4 +211,4 @@ npm run typecheck
 npm run test
 npm run coverage
 npm run build
-```
+````

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

@@ -74,7 +74,7 @@ type JsxOpeningElementNode = Rule.Node & {
     parent?: JsxElementNode;
 };
 
-declare const mdRules: {
+declare const documentationRules: {
     "doc-kind-suffix": _eslint_markdown.MarkdownRuleDefinition;
     "title-matches-file-name": _eslint_markdown.MarkdownRuleDefinition;
     "overview-present": _eslint_markdown.MarkdownRuleDefinition;
@@ -101,7 +101,7 @@ declare const mdRules: {
     "glossary-term-linking": _eslint_markdown.MarkdownRuleDefinition;
 };
 
-declare const cssRules: {
+declare const tailwindRules: {
     "theme-reset": _eslint_css.CSSRuleDefinition;
     "root-variables": _eslint_css.CSSRuleDefinition;
     "apply-usage": _eslint_css.CSSRuleDefinition;
@@ -115,26 +115,28 @@ declare const cssRules: {
     "global-stylesheet": _eslint_css.CSSRuleDefinition;
 };
 
-declare const jsonRules: {
+/** Framework-agnostic package.json rules any repository should follow. */
+declare const repoPackageJsonRules: {
     "no-vulyk-dependency": _eslint_json.JSONRuleDefinition;
-    "zirka-installed": _eslint_json.JSONRuleDefinition;
+    "exact-version": _eslint_json.JSONRuleDefinition;
+};
+/** Package.json rules specific to a Next.js (or React) application. */
+declare const nextPackageJsonRules: {
+    "nextjs-stack": _eslint_json.JSONRuleDefinition;
+};
+
+declare const huskyRules: {
+    "husky-hook": _eslint_json.JSONRuleDefinition;
 };
 
+/** Every source rule, merged so the Next preset applies them all. */
 declare const pasikaRules: {
     "component-placement": eslint.Rule.RuleModule;
-    "support-file-placement": eslint.Rule.RuleModule;
     "application-structure": eslint.Rule.RuleModule;
-    "named-exports": eslint.Rule.RuleModule;
     "data-testid-case": eslint.Rule.RuleModule;
-    "support-folder-shape": eslint.Rule.RuleModule;
-    "import-through-index": eslint.Rule.RuleModule;
-    "util-file-name": eslint.Rule.RuleModule;
-    "no-util-barrel": eslint.Rule.RuleModule;
     "jsx-hygiene": eslint.Rule.RuleModule;
     "interactive-component": eslint.Rule.RuleModule;
     "ui-state": eslint.Rule.RuleModule;
-    "filename-case": eslint.Rule.RuleModule;
-    "import-boundaries": eslint.Rule.RuleModule;
     "no-mixed-concerns": eslint.Rule.RuleModule;
     "no-arbitrary-tailwind": eslint.Rule.RuleModule;
     "enforce-cn-merge": {
@@ -149,38 +151,54 @@ declare const pasikaRules: {
             JSXAttribute(node: JsxAttributeNode): void;
         };
     };
+    "cn-helper": eslint.Rule.RuleModule;
     "enforce-cva-variant-props": eslint.Rule.RuleModule;
     "cva-appearance-props": eslint.Rule.RuleModule;
     "cva-boolean-variants": eslint.Rule.RuleModule;
-    "enforce-barrel-exports": eslint.Rule.RuleModule;
     "cross-feature-import": eslint.Rule.RuleModule;
     "pure-function-extract": eslint.Rule.RuleModule;
     "hook-complexity": eslint.Rule.RuleModule;
     "locale-dotted-path": eslint.Rule.RuleModule;
     "locales-location": eslint.Rule.RuleModule;
     "hook-extraction": eslint.Rule.RuleModule;
-    "value-extraction": eslint.Rule.RuleModule;
-    "config-extraction": eslint.Rule.RuleModule;
     "component-nesting": eslint.Rule.RuleModule;
     "stay-flat": eslint.Rule.RuleModule;
-    "type-extraction": eslint.Rule.RuleModule;
     "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;
+    "filename-case": eslint.Rule.RuleModule;
+    "import-boundaries": eslint.Rule.RuleModule;
+    "named-exports": eslint.Rule.RuleModule;
+    "support-file-placement": eslint.Rule.RuleModule;
+    "support-folder-shape": eslint.Rule.RuleModule;
+    "import-through-index": eslint.Rule.RuleModule;
+    "util-file-name": eslint.Rule.RuleModule;
+    "no-util-barrel": eslint.Rule.RuleModule;
+    "enforce-barrel-exports": eslint.Rule.RuleModule;
+    "config-extraction": eslint.Rule.RuleModule;
+    "value-extraction": eslint.Rule.RuleModule;
+    "type-extraction": eslint.Rule.RuleModule;
     "zod-schema-validation": eslint.Rule.RuleModule;
     "source-under-src": eslint.Rule.RuleModule;
     "config-baseline": eslint.Rule.RuleModule;
 };
 
-/** Rule ids as they appear in configuration and in lint output. */
-declare const pasikaRuleIds: string[];
-declare const pasikaMdRuleIds: string[];
-declare const pasikaCssRuleIds: string[];
-declare const pasikaJsonRuleIds: string[];
 /** Every rule id, as they appear in configuration and in lint output. */
 declare const allPasikaRuleIds: string[];
-declare const pasikaConfig: Linter.Config;
+/**
+ * Repository-level preset: every block that does NOT touch `src/**` — the
+ * package.json manifest (including husky hook requirements) and the
+ * documentation-guide markdown rules. This governs the repository itself,
+ * independent of any application source.
+ */
+declare const pasikaRepo: Linter.Config[];
+/**
+ * Framework-wide preset: the full adopted-to-the-framework stack. Anything in
+ * `pasikaRepo` plus the `src/**` blocks — TS/TSX source rules and the Tailwind
+ * stylesheet rules. `pasikaRepo` is a strict subset of `pasikaNext`.
+ */
+declare const pasikaNext: Linter.Config[];
 
-export { allPasikaRuleIds, cssRules, jsonRules, mdRules, pasikaConfig, pasikaCssRuleIds, pasikaJsonRuleIds, pasikaMdRuleIds, pasikaRuleIds, pasikaRules };
+export { allPasikaRuleIds, documentationRules, huskyRules, nextPackageJsonRules, pasikaNext, pasikaRepo, pasikaRules, repoPackageJsonRules, tailwindRules };

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: {
@@ -3262,10 +3304,13 @@ var configBaselineRule = {
   }
 };
 
-// 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/;
+// 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/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 +3327,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 +3353,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,7 +3391,7 @@ var titleMatchesFileNameRule = {
   }
 };
 
-// eslint/rules/md/overview-present.ts
+// eslint/rules/documentation/overview-present.ts
 var overviewPresentRule = {
   meta: {
     type: "problem",
@@ -3386,7 +3431,7 @@ var overviewPresentRule = {
   }
 };
 
-// eslint/rules/md/overview-length.ts
+// eslint/rules/documentation/overview-length.ts
 function countSentences(text) {
   return text.split(/[.!?](?:\s+|$)/).filter((part) => part.trim() !== "").length;
 }
@@ -3429,7 +3474,7 @@ var overviewLengthRule = {
   }
 };
 
-// eslint/rules/md/guide-overview-no-links.ts
+// eslint/rules/documentation/guide-overview-no-links.ts
 function containsLink(node) {
   if (node.type === "link") return true;
   if ("children" in node) {
@@ -3475,7 +3520,7 @@ var guideOverviewNoLinksRule = {
   }
 };
 
-// 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 +3558,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 +3601,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 +3627,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 +3666,7 @@ var requirementPresentRule = {
   }
 };
 
-// eslint/rules/md/rule-paired-examples.ts
+// eslint/rules/documentation/rule-paired-examples.ts
 var rulePairedExamplesRule = {
   meta: {
     type: "problem",
@@ -3657,7 +3702,7 @@ var rulePairedExamplesRule = {
   }
 };
 
-// eslint/rules/md/example-heading-description.ts
+// eslint/rules/documentation/example-heading-description.ts
 var exampleHeadingDescriptionRule = {
   meta: {
     type: "problem",
@@ -3685,7 +3730,7 @@ var exampleHeadingDescriptionRule = {
   }
 };
 
-// eslint/rules/md/policy-no-examples.ts
+// eslint/rules/documentation/policy-no-examples.ts
 var policyNoExamplesRule = {
   meta: {
     type: "problem",
@@ -3712,7 +3757,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 +3789,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 +3815,7 @@ var referenceNoRfcVocabularyRule = {
   }
 };
 
-// eslint/rules/md/reference-block-headings.ts
+// eslint/rules/documentation/reference-block-headings.ts
 var referenceBlockHeadingsRule = {
   meta: {
     type: "problem",
@@ -3801,7 +3846,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 +3879,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 +3903,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 +3960,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 +3998,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 +4041,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 +4074,7 @@ var rfcKeywordInEveryBulletRule = {
   }
 };
 
-// eslint/rules/md/policy-subject-headings.ts
+// eslint/rules/documentation/policy-subject-headings.ts
 var policySubjectHeadingsRule = {
   meta: {
     type: "problem",
@@ -4082,7 +4127,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 +4171,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 +4207,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,8 +4288,8 @@ var glossaryTermLinkingRule = {
   }
 };
 
-// eslint/rules/md/index.ts
-var mdRules = {
+// eslint/rules/documentation/index.ts
+var documentationRules = {
   "doc-kind-suffix": docKindSuffixRule,
   "title-matches-file-name": titleMatchesFileNameRule,
   "overview-present": overviewPresentRule,
@@ -4271,7 +4316,7 @@ var mdRules = {
   "glossary-term-linking": glossaryTermLinkingRule
 };
 
-// eslint/rules/css/helpers.ts
+// eslint/rules/tailwind/helpers.ts
 function walkNodes(node, visit) {
   visit(node);
   if ("children" in node && node.children) {
@@ -4328,7 +4373,7 @@ function selectorNames(node) {
   return names;
 }
 
-// eslint/rules/css/theme-reset.ts
+// eslint/rules/tailwind/theme-reset.ts
 var themeResetRule = {
   meta: {
     schema: [],
@@ -4358,7 +4403,7 @@ var themeResetRule = {
   }
 };
 
-// eslint/rules/css/root-variables.ts
+// eslint/rules/tailwind/root-variables.ts
 var rootVariablesRule = {
   meta: {
     schema: [],
@@ -4401,7 +4446,7 @@ var rootVariablesRule = {
   }
 };
 
-// eslint/rules/css/apply-usage.ts
+// eslint/rules/tailwind/apply-usage.ts
 var applyUsageRule = {
   meta: {
     schema: [],
@@ -4431,7 +4476,7 @@ var applyUsageRule = {
   }
 };
 
-// eslint/rules/css/base-layer-pair.ts
+// eslint/rules/tailwind/base-layer-pair.ts
 var baseLayerPairRule = {
   meta: {
     schema: [],
@@ -4469,7 +4514,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 +4571,7 @@ var stylesheetOrderingRule = {
   }
 };
 
-// eslint/rules/css/css-variable-naming.ts
+// eslint/rules/tailwind/css-variable-naming.ts
 var cssVariableNamingRule = {
   meta: {
     schema: [],
@@ -4558,7 +4603,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 +4645,7 @@ var customUtilityApplyRule = {
   }
 };
 
-// eslint/rules/css/surface-utility.ts
+// eslint/rules/tailwind/surface-utility.ts
 var surfaceUtilityRule = {
   meta: {
     schema: [],
@@ -4633,7 +4678,7 @@ var surfaceUtilityRule = {
   }
 };
 
-// eslint/rules/css/theme-variable-namespace.ts
+// eslint/rules/tailwind/theme-variable-namespace.ts
 var themeVariableNamespaceRule = {
   meta: {
     schema: [],
@@ -4672,7 +4717,7 @@ var themeVariableNamespaceRule = {
   }
 };
 
-// eslint/rules/css/global-css-location.ts
+// eslint/rules/tailwind/global-css-location.ts
 var globalCssLocationRule = {
   meta: {
     schema: [],
@@ -4703,7 +4748,7 @@ var globalCssLocationRule = {
   }
 };
 
-// eslint/rules/css/global-stylesheet.ts
+// eslint/rules/tailwind/global-stylesheet.ts
 var globalStylesheetRule = {
   meta: {
     schema: [],
@@ -4736,8 +4781,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 +4796,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 +4854,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 +4869,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 +4909,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 +4930,201 @@ 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, readFileSync as readFileSync6 } from "fs";
+import path39 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 = path39.join(process.cwd(), ".husky", "pre-commit");
+        if (!existsSync(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/index.ts
-var pasikaRules = {
-  "component-placement": componentPlacementRule,
-  "support-file-placement": supportFilePlacementRule,
-  "application-structure": applicationStructureRule,
+var repoSourceRules = {
+  "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,
+  "config-baseline": configBaselineRule
+};
+var nextSourceRules = {
+  "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 = {
+  ...repoSourceRules,
+  ...nextSourceRules
 };
-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 pasikaRuleIds = ruleIds(pasikaRules);
+var documentationRuleIds = ruleIds(documentationRules);
+var tailwindRuleIds = ruleIds(tailwindRules);
+var repoPackageJsonRuleIds = ruleIds(repoPackageJsonRules);
+var nextPackageJsonRuleIds = ruleIds(nextPackageJsonRules);
+var huskyRuleIds = ruleIds(huskyRules);
+var allPasikaRuleIds = [
+  ...pasikaRuleIds,
+  ...documentationRuleIds,
+  ...tailwindRuleIds,
+  ...repoPackageJsonRuleIds,
+  ...nextPackageJsonRuleIds,
+  ...huskyRuleIds
+];
+var nextAppBlock = {
   files: ["src/**/*.{cjs,cts,js,jsx,mjs,mts,ts,tsx}"],
   plugins: {
     pasika: { rules: pasikaRules }
   },
   rules: Object.fromEntries(pasikaRuleIds.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 manifestBlock = {
+  files: ["package.json"],
+  plugins: {
+    json: { languages: { json: jsonPlugin.languages.json } },
+    pasika: { rules: { ...repoPackageJsonRules, ...nextPackageJsonRules, ...huskyRules } }
+  },
+  language: "json/json",
+  rules: Object.fromEntries(
+    [...repoPackageJsonRuleIds, ...nextPackageJsonRuleIds, ...huskyRuleIds].map((id) => [id, "error"])
+  )
+};
+var docsBlock = {
+  files: ["docs/**/*.md"],
+  ignores: ["**/_*/**"],
+  plugins: {
+    markdown,
+    pasika: { rules: documentationRules }
+  },
+  language: "markdown/gfm",
+  rules: Object.fromEntries(documentationRuleIds.map((id) => [id, "error"]))
+};
+var pasikaRepo = [manifestBlock, docsBlock];
+var pasikaNext = [...pasikaRepo, nextAppBlock, tailwindGlobalsBlock, tailwindAnyCssBlock];
 export {
   allPasikaRuleIds,
-  cssRules,
-  jsonRules,
-  mdRules,
-  pasikaConfig,
-  pasikaCssRuleIds,
-  pasikaJsonRuleIds,
-  pasikaMdRuleIds,
-  pasikaRuleIds,
-  pasikaRules
+  documentationRules,
+  huskyRules,
+  nextPackageJsonRules,
+  pasikaNext,
+  pasikaRepo,
+  pasikaRules,
+  repoPackageJsonRules,
+  tailwindRules
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pasika",
-  "version": "0.3.8",
+  "version": "0.3.9",
   "description": "Reusable agent setup package",
   "repository": {
     "type": "git",
@@ -31,28 +31,33 @@
     "!(*.ts|*.mts|*.cts|*.tsx|*.js|*.cjs|*.mjs|*.jsx)": "prettier --write --ignore-unknown",
     "*.ts|*.mts|*.cts|*.tsx|*.js|*.cjs|*.mjs|*.jsx": "npx eslint --fix"
   },
+  "dependencies": {
+    "typescript": "6.0.3"
+  },
   "devDependencies": {
-    "@eslint/css": "^1.4.0",
-    "@eslint/css-tree": "^4.0.5",
-    "@eslint/json": "^2.0.1",
-    "@eslint/markdown": "^8.0.3",
-    "@humanwhocodes/momoa": "^3.3.12",
-    "@types/estree": "^1.0.9",
-    "@types/mdast": "^4.0.4",
-    "@types/node": "^26.4.0",
-    "@typescript-eslint/parser": "^8.68.0",
-    "eslint": "^10.9.1",
-    "husky": "^9.1.7",
-    "lint-staged": "^16.4.0",
-    "prettier": "^3.8.1",
-    "tsup": "^8.5.1",
-    "tsx": "^4.23.12",
-    "typescript": "^5.9.2",
-    "zirka": "^0.0.42",
-    "zod": "^4.4.3"
+    "@eslint/css": "1.4.0",
+    "@eslint/css-tree": "4.0.5",
+    "@eslint/json": "2.0.1",
+    "@eslint/markdown": "8.0.3",
+    "@humanwhocodes/momoa": "3.3.12",
+    "@types/estree": "1.0.9",
+    "@types/mdast": "4.0.4",
+    "@types/node": "26.4.0",
+    "@typescript-eslint/parser": "8.68.0",
+    "eslint": "10.9.1",
+    "husky": "9.1.7",
+    "lint-staged": "17.4.1",
+    "prettier": "3.8.1",
+    "tsup": "8.5.1",
+    "tsx": "4.23.12",
+    "typescript": "6.0.3",
+    "zirka": "0.0.45",
+    "zod": "4.4.3"
   },
   "peerDependencies": {
-    "typescript": ">=5.0.0"
+    "@eslint/css": ">=1.4.0",
+    "@eslint/json": ">=2.0.1",
+    "@eslint/markdown": ">=8.0.3"
   },
   "engines": {
     "node": ">=22"