pasika 0.5.17 → 0.5.18

package/README.md

@@ -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";
 
@@ -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 = [];
@@ -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();
@@ -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;
@@ -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 = [
@@ -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.17",
+  "version": "0.5.18",
   "description": "Reusable agent setup package",
   "repository": {
     "type": "git",