pasika 0.5.16 → 0.5.18

package/README.md

@@ -9,10 +9,10 @@ Documentation, the lint rules derived from it, and the checks that apply and dia
 ```text
 docs/
   repository-policy.md            # repo-wide code and documentation requirements (Policy)
-  code-organization-guide/        # placement, extraction, module conventions
+  next-codebase-guide/        # placement, extraction, module conventions
   documentation-guide/            # how documents themselves are written
   pasika-adoption-guide/          # adopting and updating the framework
-  styling-guide/                  # Tailwind theme, composition, variants, states
+  next-tailwind-guide/                  # Tailwind theme, composition, variants, states
 scripts/
   registry.json                   # requirement → enforcement, keyed by content hash
   coverage.ts                     # reconciles the docs against the registry
@@ -39,7 +39,7 @@ Requirements are identified by a hash of their canonical text, not by a hand-wri
 
 ```jsonc
 {
-  "doc": "code-organization-guide/rules/no-mixed-concerns-rule.md",
+  "doc": "next-codebase-guide/rules/no-mixed-concerns-rule.md",
   "text": "A .tsx file that defines a component MUST contain exactly one component.",
   "hash": "b19fe3bd34",
   "ref": "pasika/no-mixed-concerns",
@@ -88,8 +88,8 @@ The script refuses a hash no requirement has, a `ref` naming a rule that does no
 
 ```bash
 npm run build
-npm run dogfood -- ../some/repo                 # nextjsApp preset (default)
-npm run dogfood -- ../some/repo --preset=typescriptApp
+npm run dogfood -- ../some/repo                 # pasikaNextjsApp preset (default)
+npm run dogfood -- ../some/repo --preset=pasikaApp
 npm run dogfood -- ../some/repo --pasika-only   # tally only pasika/* rules
 npm run dogfood -- ../some/repo --rule=css-entry-point --findings
 npm run dogfood -- ../some/repo --json          # machine-readable report
@@ -115,18 +115,18 @@ const { eslintConfig } = styleguide({
 export default eslintConfig;
 ```
 
-For a plain TypeScript repository, enable `pasikaTypescriptApp` instead of `pasikaNextjsApp`; that preset covers the manifest, the zirka contract, and the docs only — the `src/**` source rules belong to the Next.js app preset. `zirka` composes the pasika ruleset over four file scopes: TS/TSX under `src/**`, `globals.css` and other stylesheets, `package.json`, and markdown — each with its own ESLint language.
+For a plain TypeScript repository, enable `pasikaApp` instead of `pasikaNextjsApp`; that preset covers the manifest, the zirka contract, and the docs only — the `src/**` source rules belong to the Next.js app preset. `zirka` composes the pasika ruleset over four file scopes: TS/TSX under `src/**`, `globals.css` and other stylesheets, `package.json`, and markdown — each with its own ESLint language.
 
 ### Without Zirka
 
 ```ts
 // eslint.config.ts — plain TypeScript repository
-import { typescriptApp } from "pasika/eslint";
+import { pasikaApp } from "pasika/eslint";
 
-export default typescriptApp;
+export default pasikaApp;
 ```
 
-`typescriptApp` is the plain-TypeScript-repository preset — the package.json manifest, the zirka configuration contract, and the docs. It carries no `src/**` source block: source linting is the Next.js app's job. `nextjsApp` is the full framework preset: everything in `typescriptApp` plus the Next.js-stack manifest requirement, the `src/**` app source rules, and the Tailwind stylesheet blocks. The granular rule objects (`tailwindRules`, `repoPackageJsonRules`, `documentationRules`) stay exported for manual wiring.
+`pasikaApp` is the plain-TypeScript-repository preset — the package.json manifest, the zirka configuration contract, and the docs. It carries no `src/**` source block: source linting is the Next.js app's job. `pasikaNextjsApp` is the full framework preset: everything in `pasikaApp` plus the Next.js-stack manifest requirement, the `src/**` app source rules, and the Tailwind stylesheet blocks. The granular rule objects (`tailwindRules`, `repoPackageJsonRules`, `documentationRules`) stay exported for manual wiring.
 
 The `src/**` blocks ship `@typescript-eslint/parser` themselves, so a standalone preset parses `.ts`/`.tsx` correctly on its own (`pasika` lists it as a runtime dependency).
 

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

@@ -246,13 +246,16 @@ declare const allPasikaRuleIds: string[];
  * source block: source linting is the Next.js app's job.
  * Use this for a plain TypeScript repository that does not adopt the framework.
  */
-declare const typescriptApp: Linter.Config[];
+declare const pasikaApp: Linter.Config[];
 /**
  * Next.js app preset: the full adopted-to-the-framework stack. Anything in
- * `typescriptApp` plus the framework-only blocks — the Next.js-stack manifest
+ * `pasikaApp` plus the framework-only blocks — the Next.js-stack manifest
  * requirement, the `src/**` app source rules, and the Tailwind stylesheet
- * rules. `typescriptApp` is a strict subset of `nextjsApp`.
+ * rules. `pasikaApp` is a strict subset of `pasikaNextjsApp`. Consuming this
+ * preset (spreading or iterating it) runs the TypeScript alignment diagnostic
+ * first, so a mismatched compiler major fails config load with an actionable
+ * error instead of crashing every type-aware rule later.
  */
-declare const nextjsApp: Linter.Config[];
+declare const pasikaNextjsApp: Linter.Config[];
 
-export { allPasikaRuleIds, documentationRules, huskyRules, nextjsApp, nextjsPackageJsonRules, pasikaPlugin, repoPackageJsonRules, tailwindRules, typescriptApp, vulykRules };
+export { allPasikaRuleIds, documentationRules, huskyRules, nextjsPackageJsonRules, pasikaApp, pasikaNextjsApp, pasikaPlugin, repoPackageJsonRules, tailwindRules, vulykRules };

package/dist/eslint/pasika/index.js

@@ -4,6 +4,53 @@ import jsonPlugin from "@eslint/json";
 import markdown from "@eslint/markdown";
 import tsParser from "@typescript-eslint/parser";
 
+// eslint/ts-alignment.ts
+import { readFileSync } from "fs";
+import { createRequire } from "module";
+import { join } from "path";
+var ownRequire = createRequire(import.meta.url);
+var majorOf = (version) => Number(version.split(".")[0]);
+function versionOf(packagePath) {
+  try {
+    const parsed = JSON.parse(readFileSync(packagePath, "utf8"));
+    if (typeof parsed !== "object" || parsed === null || !("version" in parsed)) return null;
+    return typeof parsed.version === "string" ? parsed.version : null;
+  } catch {
+    return null;
+  }
+}
+function resolveTypescriptAlignment() {
+  let bundled = null;
+  try {
+    bundled = versionOf(ownRequire.resolve("typescript/package.json"));
+  } catch {
+    bundled = null;
+  }
+  let resolved = null;
+  try {
+    const consumerRequire = createRequire(join(process.cwd(), "package.json"));
+    resolved = versionOf(consumerRequire.resolve("typescript/package.json"));
+  } catch {
+    resolved = null;
+  }
+  return { bundled, resolved };
+}
+function alignmentError(bundled, resolved) {
+  if (bundled === null || resolved === null) return null;
+  const bundledMajor = majorOf(bundled);
+  const resolvedMajor = majorOf(resolved);
+  if (bundledMajor === resolvedMajor) return null;
+  const direction = resolvedMajor < bundledMajor ? `Upgrade your typescript to ^${String(bundledMajor)} (pinned exact) so a single hoisted copy serves the whole pipeline.` : `Your repository is ahead of the compiler pasika ships. Pin typescript to ^${String(bundledMajor)} for now and upgrade pasika when it bundles the newer major.`;
+  return new Error(
+    `[pasika] TypeScript major mismatch: the pasikaNextjsApp preset parses src/** with its bundled @typescript-eslint/parser, which runs on typescript ${bundled}; your repository resolves typescript ${resolved} for the type-aware rules. Two TypeScript majors mean the types the parser builds use a different TypeFlags layout than the rules expect, so every type-aware rule crashes (e.g. "undefined is not iterable" in ts-api-utils). Align them on ${String(bundledMajor)}, then lint will run again. ${direction}`
+  );
+}
+function assertTypescriptAlignment() {
+  const { bundled, resolved } = resolveTypescriptAlignment();
+  const error = alignmentError(bundled, resolved);
+  if (error) throw error;
+}
+
 // eslint/rules/filename-case.ts
 import path2 from "path";
 
@@ -395,7 +442,7 @@ var noMixedConcernsRule = {
         for (const extra of components.slice(1)) {
           context.report({
             loc: { line: 1, column: 0 },
-            message: `File defines multiple components. "${extra.name}" is an extra component. Move it to its own file. Each component file MUST define exactly one component. See docs/code-organization-guide/rules/no-mixed-concerns-rule.md`
+            message: `File defines multiple components. "${extra.name}" is an extra component. Move it to its own file. Each component file MUST define exactly one component. See docs/next-codebase-guide/rules/no-mixed-concerns-rule.md`
           });
         }
       }
@@ -421,7 +468,7 @@ var noArbitraryTailwindRule = {
       if (!match) return;
       context.report({
         node,
-        message: `Tailwind arbitrary-value class "${match[0]}" is not allowed. Use a named token or custom utility. See docs/styling-guide/rules/arbitrary-value-rule.md`
+        message: `Tailwind arbitrary-value class "${match[0]}" is not allowed. Use a named token or custom utility. See docs/next-tailwind-guide/rules/arbitrary-value-rule.md`
       });
     }
     function checkExpression(node, expression) {
@@ -473,7 +520,7 @@ var noArbitraryTailwindRule = {
 };
 
 // eslint/rules/unknown-utility.ts
-import { readdirSync, readFileSync, statSync } from "fs";
+import { readdirSync, readFileSync as readFileSync2, statSync } from "fs";
 import path5 from "path";
 var PREFIX_NAMESPACES = {
   bg: ["color"],
@@ -752,7 +799,7 @@ function readInventory(files) {
   for (const file of files) {
     let css2;
     try {
-      css2 = readFileSync(file, "utf8");
+      css2 = readFileSync2(file, "utf8");
     } catch {
       continue;
     }
@@ -922,7 +969,7 @@ import path7 from "path";
 
 // eslint/project/parse-module.ts
 import path6 from "path";
-import { readFileSync as readFileSync2 } from "fs";
+import { readFileSync as readFileSync3 } from "fs";
 import ts2 from "typescript";
 var isPascalCase3 = (name) => /^[A-Z][A-Za-z0-9]*$/.test(name);
 var isHookName = (name) => /^use[A-Z]/.test(name);
@@ -959,7 +1006,7 @@ function classifyValue(name, initializer, isTsx) {
   return "constant";
 }
 function parseModule(file) {
-  const text = readFileSync2(file, "utf8");
+  const text = readFileSync3(file, "utf8");
   const isTsx = file.endsWith(".tsx") || file.endsWith(".jsx");
   const sourceFile = ts2.createSourceFile(file, text, ts2.ScriptTarget.Latest, true, ts2.ScriptKind.TSX);
   const imports = [];
@@ -1178,7 +1225,7 @@ var enforceCnMergeRule = {
         if (isComponentProp && attributeName !== "className" && attributeName.endsWith("ClassName")) {
           context.report({
             node,
-            message: "Expose appearance through typed variant props instead of separate internal class-name props. See docs/styling-guide/rules/class-composition-rule.md"
+            message: "Expose appearance through typed variant props instead of separate internal class-name props. See docs/next-tailwind-guide/rules/class-composition-rule.md"
           });
           return;
         }
@@ -1192,7 +1239,7 @@ var enforceCnMergeRule = {
           if (invalidClass) {
             context.report({
               node,
-              message: `Passed className contains non-layout utility "${invalidClass}". Expose appearance through typed variant props. See docs/styling-guide/rules/class-composition-rule.md`
+              message: `Passed className contains non-layout utility "${invalidClass}". Expose appearance through typed variant props. See docs/next-tailwind-guide/rules/class-composition-rule.md`
             });
           }
           return;
@@ -1201,7 +1248,7 @@ var enforceCnMergeRule = {
           if (classCount(valueNode.value) > 5) {
             context.report({
               node,
-              message: "Static className with more than 5 classes must use cn() with grouped string literals. See docs/styling-guide/rules/class-composition-rule.md"
+              message: "Static className with more than 5 classes must use cn() with grouped string literals. See docs/next-tailwind-guide/rules/class-composition-rule.md"
             });
           }
           return;
@@ -1211,28 +1258,28 @@ var enforceCnMergeRule = {
         if (expr.type === "BinaryExpression" && expr.operator === "+") {
           context.report({
             node,
-            message: "Use cn() instead of + operator for className. See docs/styling-guide/rules/class-composition-rule.md"
+            message: "Use cn() instead of + operator for className. See docs/next-tailwind-guide/rules/class-composition-rule.md"
           });
           return;
         }
         if (expr.type === "TemplateLiteral" && expr.expressions.length > 0) {
           context.report({
             node,
-            message: "Use cn() instead of template literals with conditionals for className. See docs/styling-guide/rules/class-composition-rule.md"
+            message: "Use cn() instead of template literals with conditionals for className. See docs/next-tailwind-guide/rules/class-composition-rule.md"
           });
           return;
         }
         if (expr.type === "LogicalExpression" || expr.type === "ConditionalExpression") {
           context.report({
             node,
-            message: "Use cn() for conditional classes in className. See docs/styling-guide/rules/class-composition-rule.md"
+            message: "Use cn() for conditional classes in className. See docs/next-tailwind-guide/rules/class-composition-rule.md"
           });
           return;
         }
         if (expr.type === "Literal" && typeof expr.value === "string" && classCount(expr.value) > 5) {
           context.report({
             node,
-            message: "Static className with more than 5 classes must use cn() with grouped string literals. See docs/styling-guide/rules/class-composition-rule.md"
+            message: "Static className with more than 5 classes must use cn() with grouped string literals. See docs/next-tailwind-guide/rules/class-composition-rule.md"
           });
           return;
         }
@@ -1241,7 +1288,7 @@ var enforceCnMergeRule = {
             if (arg.type === "Literal" && typeof arg.value === "string" && classCount(arg.value) > 5) {
               context.report({
                 node: arg,
-                message: "Each cn() string argument must contain at most 5 class names. Group by styling concern. See docs/styling-guide/rules/class-composition-rule.md"
+                message: "Each cn() string argument must contain at most 5 class names. Group by styling concern. See docs/next-tailwind-guide/rules/class-composition-rule.md"
               });
             }
           }
@@ -1339,7 +1386,7 @@ var enforceCvaVariantPropsRule = {
               if (variantNames.includes(keyName2)) {
                 context.report({
                   node,
-                  message: `Variant prop "${keyName2}" duplicates CVA variant values. Use VariantProps<typeof variants> instead of manually writing union types. See docs/styling-guide/rules/component-variant-rule.md`
+                  message: `Variant prop "${keyName2}" duplicates CVA variant values. Use VariantProps<typeof variants> instead of manually writing union types. See docs/next-tailwind-guide/rules/component-variant-rule.md`
                 });
                 return;
               }
@@ -1407,7 +1454,7 @@ var enforceBarrelExportsRule = {
         if (!reExportedNames.has(parentName)) {
           context.report({
             loc: { line: 1, column: 0 },
-            message: `index.ts in "${folderName}/" must re-export "${parentName}". See docs/code-organization-guide/rules/folder-nesting-rule.md`
+            message: `index.ts in "${folderName}/" must re-export "${parentName}". See docs/next-codebase-guide/rules/folder-nesting-rule.md`
           });
           return;
         }
@@ -1415,7 +1462,7 @@ var enforceBarrelExportsRule = {
         if (nonParentExports.length > 0) {
           context.report({
             loc: { line: 1, column: 0 },
-            message: `index.ts must not re-export exclusive children: ${nonParentExports.join(", ")}. Only "${parentName}" may be re-exported. See docs/code-organization-guide/rules/folder-nesting-rule.md`
+            message: `index.ts must not re-export exclusive children: ${nonParentExports.join(", ")}. Only "${parentName}" may be re-exported. See docs/next-codebase-guide/rules/folder-nesting-rule.md`
           });
         }
       }
@@ -1559,7 +1606,7 @@ var componentPlacementRule = {
             context.report({
               node,
               loc: { line: 1, column: 0 },
-              message: `This component has no consumer outside src/app/ or a configuration module, so it belongs in the feature folder it represents, not in ${formatFolder(currentFolder)}. See docs/code-organization-guide/rules/component-placement-rule.md`
+              message: `This component has no consumer outside src/app/ or a configuration module, so it belongs in the feature folder it represents, not in ${formatFolder(currentFolder)}. See docs/next-codebase-guide/rules/component-placement-rule.md`
             });
           }
           return;
@@ -1570,7 +1617,7 @@ var componentPlacementRule = {
         context.report({
           node,
           loc: { line: 1, column: 0 },
-          message: `Move this component to ${formatFolder(placement.expectedFolder)} \u2014 ${explanation}. Imported by ${describeConsumers(placement.countedConsumers, sourceRoot)}. See docs/code-organization-guide/rules/component-placement-rule.md`
+          message: `Move this component to ${formatFolder(placement.expectedFolder)} \u2014 ${explanation}. Imported by ${describeConsumers(placement.countedConsumers, sourceRoot)}. See docs/next-codebase-guide/rules/component-placement-rule.md`
         });
       }
     };
@@ -1857,7 +1904,7 @@ var namedExportsRule = {
       ExportDefaultDeclaration(node) {
         context.report({
           node,
-          message: "Files that export values must use named exports unless a framework or third-party package requires a different export style for that file. See docs/code-organization-guide/rules/exports-and-imports-rule.md"
+          message: "Files that export values must use named exports unless a framework or third-party package requires a different export style for that file. See docs/next-codebase-guide/rules/exports-and-imports-rule.md"
         });
       }
     };
@@ -1928,7 +1975,7 @@ var dataTestIdCaseRule = {
           } else if (component.smart) {
             context.report({
               node,
-              message: `Smart component "${component.name}" has no single outer element; wrap its content in one outer element with data-testid="${component.name}" instead of rendering multiple roots. See docs/code-organization-guide/rules/smart-vs-dumb-component-rule.md`
+              message: `Smart component "${component.name}" has no single outer element; wrap its content in one outer element with data-testid="${component.name}" instead of rendering multiple roots. See docs/next-codebase-guide/rules/smart-vs-dumb-component-rule.md`
             });
           }
         }
@@ -1986,7 +2033,7 @@ var supportFolderShapeRule = {
         if (missing.length === 0) return;
         context.report({
           node,
-          message: `${folder}/index.ts must named-re-export every support file: ${missing.join(", ")}. See docs/code-organization-guide/rules/${folder === "constants" ? "constants" : "types-and-schemas"}-rule.md`
+          message: `${folder}/index.ts must named-re-export every support file: ${missing.join(", ")}. See docs/next-codebase-guide/rules/${folder === "constants" ? "constants" : "types-and-schemas"}-rule.md`
         });
       }
     };
@@ -2021,7 +2068,7 @@ var importThroughIndexRule = {
           const expected = `@/${folderIndex.join("/")}`;
           context.report({
             node,
-            message: `Import support files through ${expected} instead of "${specifier}". See the code-organization-guide exports and imports rules.`
+            message: `Import support files through ${expected} instead of "${specifier}". See the next-codebase-guide exports and imports rules.`
           });
         }
       }
@@ -2108,7 +2155,7 @@ var noUtilBarrelRule = {
           if (utilsIndex < 0 || !path19.basename(target).startsWith("index.")) continue;
           context.report({
             node,
-            message: `Import utilities directly instead of through "${specifier}". See docs/code-organization-guide/rules/utilities-rule.md`
+            message: `Import utilities directly instead of through "${specifier}". See docs/next-codebase-guide/rules/utilities-rule.md`
           });
         }
       }
@@ -2207,7 +2254,7 @@ var jsxHygieneRule = {
       if (!violation) return;
       context.report({
         node,
-        message: `Extract ${violation} from JSX before return. See docs/code-organization-guide/rules/jsx-hygiene-rule.md`
+        message: `Extract ${violation} from JSX before return. See docs/next-codebase-guide/rules/jsx-hygiene-rule.md`
       });
     }
     return {
@@ -2389,7 +2436,7 @@ var interactiveComponentRule = {
         if (name === void 0) return;
         context.report({
           node,
-          message: `Extract the interactive <${name}> into a descriptive component. See docs/code-organization-guide/rules/interactive-component-rule.md`
+          message: `Extract the interactive <${name}> into a descriptive component. See docs/next-codebase-guide/rules/interactive-component-rule.md`
         });
       }
     };
@@ -2453,7 +2500,7 @@ var uiStateRule = {
           if (!hasNativeState) {
             context.report({
               node: attribute,
-              message: `UI state prop "${name}" should be expressed with a native or ARIA state attribute. See docs/styling-guide/rules/component-ui-state-rule.md`
+              message: `UI state prop "${name}" should be expressed with a native or ARIA state attribute. See docs/next-tailwind-guide/rules/component-ui-state-rule.md`
             });
           }
         }
@@ -2470,7 +2517,7 @@ var uiStateRule = {
             if (classes.length > 0 && !classes.some((className) => STATE_CLASS_RE.test(className))) {
               context.report({
                 node: attribute,
-                message: "Use a Tailwind state variant for a UI state instead of conditional replacement classes. See docs/styling-guide/rules/component-ui-state-rule.md"
+                message: "Use a Tailwind state variant for a UI state instead of conditional replacement classes. See docs/next-tailwind-guide/rules/component-ui-state-rule.md"
               });
             }
           }
@@ -2532,7 +2579,7 @@ var cvaAppearancePropsRule = {
           if (typeAnnotation.type === "TSUnionType" || typeAnnotation.type === "TSTypeLiteral") {
             context.report({
               node,
-              message: `Visual option prop "${keyName2}" must be defined through a cva() call rather than a manual union type. See docs/styling-guide/rules/component-variant-rule.md`
+              message: `Visual option prop "${keyName2}" must be defined through a cva() call rather than a manual union type. See docs/next-tailwind-guide/rules/component-variant-rule.md`
             });
           }
         }
@@ -2606,7 +2653,7 @@ var cvaBooleanVariantsRule = {
           if (info.variantNames.has(propName)) {
             context.report({
               node,
-              message: `Boolean prop "${propName}" is used as a standalone conditional in cn() but is also defined as a CVA variant. Move it to one place: either CVA (with both true/false treatments) or cn() (standalone). See docs/styling-guide/rules/component-variant-rule.md`
+              message: `Boolean prop "${propName}" is used as a standalone conditional in cn() but is also defined as a CVA variant. Move it to one place: either CVA (with both true/false treatments) or cn() (standalone). See docs/next-tailwind-guide/rules/component-variant-rule.md`
             });
           }
         }
@@ -2665,7 +2712,7 @@ var crossFeatureImportRule = {
           const names = [...importedFeatures].sort().join(", ");
           context.report({
             node,
-            message: `This component imports from two or more feature folders (${names}) and must live in src/compositions/. See docs/code-organization-guide/rules/component-placement-rule.md`
+            message: `This component imports from two or more feature folders (${names}) and must live in src/compositions/. See docs/next-codebase-guide/rules/component-placement-rule.md`
           });
         }
       }
@@ -2713,7 +2760,7 @@ var pureFunctionExtractRule = {
     function report3(node, name) {
       context.report({
         node,
-        message: `Extract pure function "${name}" to utils/. See docs/code-organization-guide/rules/utilities-rule.md`
+        message: `Extract pure function "${name}" to utils/. See docs/next-codebase-guide/rules/utilities-rule.md`
       });
     }
     return {
@@ -2812,12 +2859,12 @@ var hookComplexityRule = {
       if (imperativeCount >= 2 && !inSupportFolder) {
         context.report({
           node,
-          message: `Hook "${name}" has ${String(imperativeCount)} imperative categories and must be extracted to a hooks/ folder. See docs/code-organization-guide/rules/hook-extraction-rule.md`
+          message: `Hook "${name}" has ${String(imperativeCount)} imperative categories and must be extracted to a hooks/ folder. See docs/next-codebase-guide/rules/hook-extraction-rule.md`
         });
       } else if (imperativeCount < 2 && inSupportFolder) {
         context.report({
           node,
-          message: `Hook "${name}" has fewer than two imperative categories and must stay inline in its consumer file. See docs/code-organization-guide/rules/hook-extraction-rule.md`
+          message: `Hook "${name}" has fewer than two imperative categories and must stay inline in its consumer file. See docs/next-codebase-guide/rules/hook-extraction-rule.md`
         });
       }
     }
@@ -2964,7 +3011,7 @@ var hookExtractionRule = {
           context.report({
             node,
             loc: { line: exp.line, column: 0 },
-            message: `Hook "${exp.name}" has ${String(consumers?.size ?? 0)} consumers; extract it to its own file in a hooks/ folder. See docs/code-organization-guide/rules/hook-extraction-rule.md`
+            message: `Hook "${exp.name}" has ${String(consumers?.size ?? 0)} consumers; extract it to its own file in a hooks/ folder. See docs/next-codebase-guide/rules/hook-extraction-rule.md`
           });
         }
       }
@@ -2997,7 +3044,7 @@ var valueExtractionRule = {
         context.report({
           node,
           loc: { line: 1, column: 0 },
-          message: `This file in src/app/ is imported by ${describeConsumers(outsideApp, sourceRoot)} outside src/app/. Extract the value to a shared or feature folder so it can be imported independently. See docs/code-organization-guide/rules/constants-rule.md`
+          message: `This file in src/app/ is imported by ${describeConsumers(outsideApp, sourceRoot)} outside src/app/. Extract the value to a shared or feature folder so it can be imported independently. See docs/next-codebase-guide/rules/constants-rule.md`
         });
       }
     };
@@ -3033,12 +3080,12 @@ var configExtractionRule = {
       if (outsideConfig.length > 0) {
         findings.push({
           line: exp.line,
-          message: `${exp.kind} "${exp.name}" in a configuration module is imported by ${describeConsumers(outsideConfig, sourceRoot)} outside src/config/. Move it to the matching root support folder. See docs/code-organization-guide/rules/configuration-rule.md`
+          message: `${exp.kind} "${exp.name}" in a configuration module is imported by ${describeConsumers(outsideConfig, sourceRoot)} outside src/config/. Move it to the matching root support folder. See docs/next-codebase-guide/rules/configuration-rule.md`
         });
       } else if (consumers.length > 0) {
         findings.push({
           line: exp.line,
-          message: `${exp.kind} "${exp.name}" is used only to implement this configuration module; extract it to the module's ${exp.kind === "schema" ? "schemas/" : "types/"} folder even with one consumer. See docs/code-organization-guide/rules/configuration-rule.md`
+          message: `${exp.kind} "${exp.name}" is used only to implement this configuration module; extract it to the module's ${exp.kind === "schema" ? "schemas/" : "types/"} folder even with one consumer. See docs/next-codebase-guide/rules/configuration-rule.md`
         });
       }
     }
@@ -3090,7 +3137,7 @@ var componentNestingRule = {
         context.report({
           node,
           loc: { line: 1, column: 0 },
-          message: `This component is nested in src/${folder.join("/")}/ but its folder has no exclusive child components \u2014 only support files. Flatten it back into src/${flatFolder}/. See docs/code-organization-guide/rules/folder-nesting-rule.md`
+          message: `This component is nested in src/${folder.join("/")}/ but its folder has no exclusive child components \u2014 only support files. Flatten it back into src/${flatFolder}/. See docs/next-codebase-guide/rules/folder-nesting-rule.md`
         });
       }
     };
@@ -3141,7 +3188,7 @@ var stayFlatRule = {
         context.report({
           node,
           loc: { line: 1, column: 0 },
-          message: `This component has exclusive child component(s) ${childNames.join(", ")}; nest it in a folder named after it inside src/features/${featureName}/. See docs/code-organization-guide/rules/folder-nesting-rule.md`
+          message: `This component has exclusive child component(s) ${childNames.join(", ")}; nest it in a folder named after it inside src/features/${featureName}/. See docs/next-codebase-guide/rules/folder-nesting-rule.md`
         });
       }
     };
@@ -3180,7 +3227,7 @@ var typeExtractionRule = {
         if (independent2.length === 0) continue;
         findings.push({
           line: exp.line,
-          message: `${exp.kind} "${exp.name}" is imported by ${describeConsumers(independent2, sourceRoot)} without the component "${componentExport.name}" that defines it. Extract it to a types/ or schemas/ folder. See docs/code-organization-guide/rules/types-and-schemas-rule.md`
+          message: `${exp.kind} "${exp.name}" is imported by ${describeConsumers(independent2, sourceRoot)} without the component "${componentExport.name}" that defines it. Extract it to a types/ or schemas/ folder. See docs/next-codebase-guide/rules/types-and-schemas-rule.md`
         });
         continue;
       }
@@ -3191,7 +3238,7 @@ var typeExtractionRule = {
       if (independent.length === 0) continue;
       findings.push({
         line: exp.line,
-        message: `${exp.kind} "${exp.name}" is imported by ${describeConsumers(independent, sourceRoot)} without using the code in this file. Extract it to a types/ or schemas/ folder. See docs/code-organization-guide/rules/types-and-schemas-rule.md`
+        message: `${exp.kind} "${exp.name}" is imported by ${describeConsumers(independent, sourceRoot)} without using the code in this file. Extract it to a types/ or schemas/ folder. See docs/next-codebase-guide/rules/types-and-schemas-rule.md`
       });
     }
     if (findings.length === 0) return {};
@@ -3207,7 +3254,7 @@ var typeExtractionRule = {
 
 // eslint/rules/locale-placement.ts
 import path32 from "path";
-import { readFileSync as readFileSync3 } from "fs";
+import { readFileSync as readFileSync4 } from "fs";
 import ts5 from "typescript";
 var LOCALE_ACCESS = /\blocales\.(?<key>[A-Za-z_$][\w$]*)/g;
 var camelCase = (name) => name.replace(/-[a-z]/g, (match) => match.slice(1).toUpperCase());
@@ -3264,7 +3311,7 @@ var localePlacementRule = {
       return candidateSegments.length === 2 && candidateSegments[0] === "locales" && candidateSegments[1]?.startsWith("index.");
     });
     if (!localesFile || file !== localesFile) return {};
-    const placement = localePlacement(readFileSync3(localesFile, "utf8"));
+    const placement = localePlacement(readFileSync4(localesFile, "utf8"));
     if (!placement) return {};
     const keyReaders = /* @__PURE__ */ new Map();
     const keyFeatures = /* @__PURE__ */ new Map();
@@ -3276,7 +3323,7 @@ var localePlacementRule = {
       );
       if (!importsLocales) continue;
       const candidateSegments = segmentsOf(candidateFile, sourceRoot);
-      for (const match of readFileSync3(candidateFile, "utf8").matchAll(LOCALE_ACCESS)) {
+      for (const match of readFileSync4(candidateFile, "utf8").matchAll(LOCALE_ACCESS)) {
         const key = match.groups?.key;
         if (key === void 0) continue;
         const readers = keyReaders.get(key) ?? /* @__PURE__ */ new Set();
@@ -3300,7 +3347,7 @@ var localePlacementRule = {
         if (current?.kind === "nested") {
           findings.push({
             line: current.line,
-            message: `Locale "${key}" is read by ${describeConsumers([...readers], sourceRoot)} and must live at the top level of locales. See docs/code-organization-guide/rules/locales-rule.md`
+            message: `Locale "${key}" is read by ${describeConsumers([...readers], sourceRoot)} and must live at the top level of locales. See docs/next-codebase-guide/rules/locales-rule.md`
           });
         }
         continue;
@@ -3311,12 +3358,12 @@ var localePlacementRule = {
       if (current?.kind === "top") {
         findings.push({
           line: current.line,
-          message: `Locale "${key}" is read only by the ${featureName} feature; it must live in an object named "${expected}". See docs/code-organization-guide/rules/locales-rule.md`
+          message: `Locale "${key}" is read only by the ${featureName} feature; it must live in an object named "${expected}". See docs/next-codebase-guide/rules/locales-rule.md`
         });
       } else if (current?.kind === "nested" && key !== expected) {
         findings.push({
           line: current.line,
-          message: `Locale "${key}" is read only by the ${featureName} feature; it must live in an object named "${expected}", not "${key}". See docs/code-organization-guide/rules/locales-rule.md`
+          message: `Locale "${key}" is read only by the ${featureName} feature; it must live in an object named "${expected}", not "${key}". See docs/next-codebase-guide/rules/locales-rule.md`
         });
       }
     }
@@ -3428,7 +3475,7 @@ var soleStateOwnerRule = {
             context.report({
               node,
               loc: { line: 1, column: 0 },
-              message: `Component "${component.name}" uses state "${hook.value}" in ${String(run)} contiguous top-level JSX part${run === 1 ? "" : "s"}; extract that part into a named component that owns useState instead of reading it in the parent. See docs/code-organization-guide/rules/sole-state-owner-rule.md`
+              message: `Component "${component.name}" uses state "${hook.value}" in ${String(run)} contiguous top-level JSX part${run === 1 ? "" : "s"}; extract that part into a named component that owns useState instead of reading it in the parent. See docs/next-codebase-guide/rules/sole-state-owner-rule.md`
             });
           }
         }
@@ -3558,7 +3605,7 @@ function checkKey(context, node, name) {
     reportFor(
       context,
       node,
-      `Locale key "${name}" must be English; write it in the Latin alphabet. See docs/code-organization-guide/rules/locales-rule.md`
+      `Locale key "${name}" must be English; write it in the Latin alphabet. See docs/next-codebase-guide/rules/locales-rule.md`
     );
     return;
   }
@@ -3566,7 +3613,7 @@ function checkKey(context, node, name) {
     reportFor(
       context,
       node,
-      `Locale key "${name}" must be camelCase English based on the text. See docs/code-organization-guide/rules/locales-rule.md`
+      `Locale key "${name}" must be camelCase English based on the text. See docs/next-codebase-guide/rules/locales-rule.md`
     );
     return;
   }
@@ -3576,7 +3623,7 @@ function checkKey(context, node, name) {
   reportFor(
     context,
     node,
-    `Locale key "${name}" is longer than ${String(MAX_KEY_LENGTH)} characters, so it must describe the message's purpose instead of the text; end it with an element role such as "Button", "Link", or "Dialog" (see WAI-ARIA roles). See docs/code-organization-guide/rules/locales-rule.md`
+    `Locale key "${name}" is longer than ${String(MAX_KEY_LENGTH)} characters, so it must describe the message's purpose instead of the text; end it with an element role such as "Button", "Link", or "Dialog" (see WAI-ARIA roles). See docs/next-codebase-guide/rules/locales-rule.md`
   );
 }
 var localeKeyShapeRule = {
@@ -3613,7 +3660,7 @@ var localeKeyShapeRule = {
 
 // eslint/rules/shared-style-dedup.ts
 import path35 from "path";
-import { readFileSync as readFileSync4, statSync as statSync3 } from "fs";
+import { readFileSync as readFileSync5, statSync as statSync3 } from "fs";
 var CLASS_NAME = /className="(?<classes>[^"]+)"/g;
 var comboCache;
 function combosFor(index) {
@@ -3631,7 +3678,7 @@ function combosFor(index) {
   }
   const combos = /* @__PURE__ */ new Map();
   for (const file of files) {
-    const text = readFileSync4(file, "utf8");
+    const text = readFileSync5(file, "utf8");
     for (const match of text.matchAll(CLASS_NAME)) {
       const classes = (match.groups?.classes ?? "").split(/\s+/).filter(Boolean);
       if (classes.length < 2) continue;
@@ -3668,7 +3715,7 @@ var sharedStyleDedupRule = {
           context.report({
             node,
             loc: { line: 1, column: 0 },
-            message: `Class combination "${combo}" is used by ${String(users.size)} components and should change together; create a named custom Tailwind utility for it. See docs/styling-guide/rules/theme-and-utility-definition-rule.md`
+            message: `Class combination "${combo}" is used by ${String(users.size)} components and should change together; create a named custom Tailwind utility for it. See docs/next-tailwind-guide/rules/theme-and-utility-definition-rule.md`
           });
         }
       }
@@ -3777,7 +3824,7 @@ var repeatedStructureRule = {
         if (!first || !isSubstantial(first)) continue;
         context.report({
           node: first,
-          message: `The same arrangement of elements appears ${String(group.length)} times here; extract it as a named component. Different data or labels do not prevent extraction. See docs/code-organization-guide/rules/repeated-structure-rule.md`
+          message: `The same arrangement of elements appears ${String(group.length)} times here; extract it as a named component. Different data or labels do not prevent extraction. See docs/next-codebase-guide/rules/repeated-structure-rule.md`
         });
       }
     }
@@ -4541,7 +4588,7 @@ var noTemplatePromptRule = {
 import path41 from "path";
 
 // eslint/rules/documentation/project-index.ts
-import { readdirSync as readdirSync3, readFileSync as readFileSync5, statSync as statSync4 } from "fs";
+import { readdirSync as readdirSync3, readFileSync as readFileSync6, statSync as statSync4 } from "fs";
 import path40 from "path";
 var KIND_BY_SUFFIX = [
   ["-rule.md", "rule"],
@@ -4559,7 +4606,7 @@ function listMarkdownFiles(dir) {
   });
 }
 function extractTitle(filePath) {
-  const content = readFileSync5(filePath, "utf8");
+  const content = readFileSync6(filePath, "utf8");
   const match = /^# (?<title>.+)$/m.exec(content);
   return match?.groups?.title?.trim() ?? "";
 }
@@ -4842,10 +4889,10 @@ var noNestedHowToRule = {
 };
 
 // eslint/rules/documentation/glossary-term-linking.ts
-import { readFileSync as readFileSync6 } from "fs";
+import { readFileSync as readFileSync7 } from "fs";
 import path42 from "path";
 function extractGlossaryTerms(filePath) {
-  const content = readFileSync6(filePath, "utf8");
+  const content = readFileSync7(filePath, "utf8");
   const terms = [];
   const headingPattern = /^## (?<term>.+)$/gm;
   let match;
@@ -5444,7 +5491,7 @@ import { statSync as statSync6 } from "fs";
 import path46 from "path";
 
 // eslint/rules/tailwind/source-files.ts
-import { readdirSync as readdirSync4, readFileSync as readFileSync7, statSync as statSync5 } from "fs";
+import { readdirSync as readdirSync4, readFileSync as readFileSync8, statSync as statSync5 } from "fs";
 import path44 from "path";
 var CSS_EXTENSIONS = [".css"];
 var MODULE_EXTENSIONS3 = [".ts", ".tsx", ".mts", ".cts", ".js", ".jsx", ".mjs", ".cjs"];
@@ -5475,7 +5522,7 @@ function cachedTextReader() {
     let text = texts.get(file);
     if (text === void 0) {
       try {
-        text = readFileSync7(file, "utf8");
+        text = readFileSync8(file, "utf8");
       } catch {
         text = "";
       }
@@ -5843,7 +5890,7 @@ var nextjsPackageJsonRules = {
 };
 
 // eslint/rules/husky/husky-hook.ts
-import { existsSync as existsSync2, readFileSync as readFileSync8 } from "fs";
+import { existsSync as existsSync2, readFileSync as readFileSync9 } from "fs";
 import path47 from "path";
 function memberName4(member) {
   return member.name.type === "String" ? member.name.value : member.name.name;
@@ -5871,7 +5918,7 @@ var huskyHookRule = {
           });
           return;
         }
-        const content = readFileSync8(hookPath, "utf8");
+        const content = readFileSync9(hookPath, "utf8");
         if (!content.includes("lint-staged")) {
           context.report({ node, message: ".husky/pre-commit must run lint-staged." });
         }
@@ -5902,7 +5949,7 @@ var huskyRules = {
 };
 
 // eslint/rules/vulyk/vulyk-docs.ts
-import { existsSync as existsSync3, readFileSync as readFileSync9 } from "fs";
+import { existsSync as existsSync3, readFileSync as readFileSync10 } from "fs";
 import path48 from "path";
 var PASIKA_REPO = "Bredansky/pasika";
 var BASE_REQUIRED_DOCS = [
@@ -5911,8 +5958,8 @@ var BASE_REQUIRED_DOCS = [
   { name: "repository-policy", path: "docs/repository-policy.md" }
 ];
 var NEXTJS_REQUIRED_DOCS = [
-  { name: "code-organization-guide", path: "docs/code-organization-guide" },
-  { name: "styling-guide", path: "docs/styling-guide" }
+  { name: "next-codebase-guide", path: "docs/next-codebase-guide" },
+  { name: "next-tailwind-guide", path: "docs/next-tailwind-guide" }
 ];
 function memberName5(member) {
   return member.name.type === "String" ? member.name.value : member.name.name;
@@ -5945,7 +5992,7 @@ var vulykDocsRule = {
           });
           return;
         }
-        const config = readFileSync9(configPath, "utf8");
+        const config = readFileSync10(configPath, "utf8");
         if (!config.includes(PASIKA_REPO)) {
           context.report({
             node,
@@ -5980,7 +6027,7 @@ var vulykRules = {
 };
 
 // eslint/index.ts
-var nextjsAppRules = {
+var pasikaNextjsAppRules = {
   // Framework-agnostic TypeScript rules.
   "filename-case": filenameCaseRule,
   "import-boundaries": importBoundariesRule,
@@ -6030,7 +6077,7 @@ var pasikaPlugin = {
   rules: {
     // The shared plugin must register every rule the preset blocks reference,
     // so all rule sets live here.
-    ...nextjsAppRules,
+    ...pasikaNextjsAppRules,
     ...documentationRules,
     ...tailwindRules,
     ...repoPackageJsonRules,
@@ -6043,7 +6090,7 @@ var jsonLanguage = { languages: { json: jsonPlugin.languages.json } };
 function ruleIds(rules2) {
   return Object.keys(rules2).map((name) => `pasika/${name}`);
 }
-var nextjsAppRuleIds = ruleIds(nextjsAppRules);
+var pasikaNextjsAppRuleIds = ruleIds(pasikaNextjsAppRules);
 var documentationRuleIds = ruleIds(documentationRules);
 var tailwindRuleIds = ruleIds(tailwindRules);
 var repoPackageJsonRuleIds = ruleIds(repoPackageJsonRules);
@@ -6051,7 +6098,7 @@ var nextjsPackageJsonRuleIds = ruleIds(nextjsPackageJsonRules);
 var huskyRuleIds = ruleIds(huskyRules);
 var vulykRuleIds = ruleIds(vulykRules);
 var allPasikaRuleIds = [
-  ...nextjsAppRuleIds,
+  ...pasikaNextjsAppRuleIds,
   ...documentationRuleIds,
   ...tailwindRuleIds,
   ...repoPackageJsonRuleIds,
@@ -6059,7 +6106,7 @@ var allPasikaRuleIds = [
   ...huskyRuleIds,
   ...vulykRuleIds
 ];
-var typescriptAppLanguageOptions = {
+var pasikaAppLanguageOptions = {
   parser: tsParser,
   parserOptions: {
     ecmaVersion: "latest",
@@ -6067,13 +6114,13 @@ var typescriptAppLanguageOptions = {
     ecmaFeatures: { jsx: true }
   }
 };
-var nextjsAppConfig = {
+var pasikaNextjsAppConfig = {
   files: ["src/**/*.{cjs,cts,js,jsx,mjs,mts,ts,tsx}"],
-  languageOptions: typescriptAppLanguageOptions,
+  languageOptions: pasikaAppLanguageOptions,
   plugins: {
     pasika: pasikaPlugin
   },
-  rules: Object.fromEntries(nextjsAppRuleIds.map((id) => [id, "error"]))
+  rules: Object.fromEntries(pasikaNextjsAppRuleIds.map((id) => [id, "error"]))
 };
 var tailwindStructureRules = {
   files: ["src/**/globals.css"],
@@ -6097,7 +6144,7 @@ var tailwindImportGraph = {
   languageOptions: { tolerant: true },
   rules: { "pasika/css-entry-point": "error" }
 };
-var typescriptAppPackageJsonConfig = {
+var pasikaAppPackageJsonConfig = {
   files: ["package.json"],
   plugins: {
     json: jsonLanguage,
@@ -6106,7 +6153,7 @@ var typescriptAppPackageJsonConfig = {
   language: "json/json",
   rules: Object.fromEntries([...repoPackageJsonRuleIds, ...huskyRuleIds, ...vulykRuleIds].map((id) => [id, "error"]))
 };
-var nextjsAppPackageJsonConfig = {
+var pasikaNextjsAppPackageJsonConfig = {
   files: ["package.json"],
   plugins: {
     json: jsonLanguage,
@@ -6133,27 +6180,39 @@ var documentationConfig = {
   language: "markdown/gfm",
   rules: Object.fromEntries(documentationRuleIds.map((id) => [id, "error"]))
 };
-var typescriptApp = [
-  typescriptAppPackageJsonConfig,
+var pasikaApp = [
+  pasikaAppPackageJsonConfig,
   zirkaConfig,
   documentationConfig
 ];
-var nextjsApp = [
-  ...typescriptApp,
-  nextjsAppPackageJsonConfig,
-  nextjsAppConfig,
+var pasikaNextjsAppWithDiagnostic = (preset) => {
+  let checked = false;
+  return new Proxy(preset, {
+    get(target, property, receiver) {
+      if (!checked && (property === Symbol.iterator || property === "length")) {
+        checked = true;
+        assertTypescriptAlignment();
+      }
+      return Reflect.get(target, property, receiver);
+    }
+  });
+};
+var pasikaNextjsApp = pasikaNextjsAppWithDiagnostic([
+  ...pasikaApp,
+  pasikaNextjsAppPackageJsonConfig,
+  pasikaNextjsAppConfig,
   tailwindStructureRules,
   tailwindImportGraph
-];
+]);
 export {
   allPasikaRuleIds,
   documentationRules,
   huskyRules,
-  nextjsApp,
   nextjsPackageJsonRules,
+  pasikaApp,
+  pasikaNextjsApp,
   pasikaPlugin,
   repoPackageJsonRules,
   tailwindRules,
-  typescriptApp,
   vulykRules
 };

package/package.json

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