pasika 0.8.0 → 0.9.0

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

@@ -200,6 +200,7 @@ declare const pasikaPlugin: {
         "config-extraction": eslint.Rule.RuleModule;
         "value-extraction": eslint.Rule.RuleModule;
         "constant-casing": eslint.Rule.RuleModule;
+        "prefer-enum": eslint.Rule.RuleModule;
         "type-extraction": eslint.Rule.RuleModule;
         "zod-schema-validation": eslint.Rule.RuleModule;
         "schema-casing": eslint.Rule.RuleModule;

package/dist/eslint/pasika/index.js

@@ -2170,8 +2170,47 @@ var constantCasingRule = {
   }
 };
 
-// eslint/rules/import-through-index.ts
+// eslint/rules/prefer-enum.ts
 import path18 from "path";
+function isConstAssertion(node) {
+  const typeAnnotation = node.typeAnnotation;
+  return typeAnnotation?.type === "TSTypeReference" && typeAnnotation.typeName?.type === "Identifier" && typeAnnotation.typeName.name === "const";
+}
+function isEnumConvertibleProperty(property) {
+  if (property.type !== "Property" || property.computed) return false;
+  const { value } = property;
+  return value.type === "Literal" && (typeof value.value === "string" || typeof value.value === "number");
+}
+var preferEnumRule = {
+  meta: {
+    schema: [],
+    type: "problem",
+    docs: {
+      description: "Require a fixed set of named string/number values to be a TypeScript enum, not an `as const` object literal."
+    }
+  },
+  create(context) {
+    const filename = path18.resolve(context.filename);
+    const sourceRoot = sourceRootOf(context);
+    if (!filename.startsWith(sourceRoot + path18.sep)) return {};
+    return {
+      TSAsExpression(node) {
+        if (!isConstAssertion(node)) return;
+        const expression = node.expression;
+        if (!expression || expression.type !== "ObjectExpression") return;
+        if (expression.properties.length === 0) return;
+        if (!expression.properties.every(isEnumConvertibleProperty)) return;
+        context.report({
+          node,
+          message: "A fixed set of named values must be a TypeScript enum, not an object literal marked as const. See docs/next-codebase-guide/rules/constants-rule.md"
+        });
+      }
+    };
+  }
+};
+
+// eslint/rules/import-through-index.ts
+import path19 from "path";
 var importThroughIndexRule = {
   meta: {
     schema: [],
@@ -2181,7 +2220,7 @@ var importThroughIndexRule = {
     }
   },
   create(context) {
-    const filename = path18.resolve(context.filename);
+    const filename = path19.resolve(context.filename);
     const sourceRoot = sourceRootOf2(context, filename);
     return {
       Program(node) {
@@ -2193,7 +2232,7 @@ var importThroughIndexRule = {
             (segment) => ["constants", "types", "schemas"].includes(segment)
           );
           const supportFolder = supportFolderIndex >= 0 ? targetSegments[supportFolderIndex] : void 0;
-          if (!supportFolder || path18.basename(target).startsWith("index.")) continue;
+          if (!supportFolder || path19.basename(target).startsWith("index.")) continue;
           const folderIndex = targetSegments.slice(0, supportFolderIndex + 1);
           const expected = `@/${folderIndex.join("/")}`;
           context.report({
@@ -2215,14 +2254,14 @@ function importSpecifiers(source) {
   return specifiers;
 }
 function sourceRootOf2(context, filename) {
-  const marker = `${path18.sep}src${path18.sep}`;
+  const marker = `${path19.sep}src${path19.sep}`;
   const srcIndex = filename.lastIndexOf(marker);
   if (srcIndex >= 0) return filename.slice(0, srcIndex + marker.length - 1);
-  return path18.resolve(context.cwd ?? process.cwd(), "src");
+  return path19.resolve(context.cwd ?? process.cwd(), "src");
 }
 
 // eslint/rules/util-file-name.ts
-import path19 from "path";
+import path20 from "path";
 function toKebabCase2(value) {
   return value.replace(/(?<lower>[a-z0-9])(?<upper>[A-Z])/g, "$<lower>-$<upper>").replace(/(?<first>[A-Z])(?<rest>[A-Z][a-z])/g, "$<first>-$<rest>").toLowerCase();
 }
@@ -2235,7 +2274,7 @@ var utilFileNameRule = {
     }
   },
   create(context) {
-    const filename = path19.resolve(context.filename);
+    const filename = path20.resolve(context.filename);
     const segments = filename.replace(/\\/g, "/").split("/");
     if (!segments.includes("utils")) return {};
     let module;
@@ -2249,13 +2288,13 @@ var utilFileNameRule = {
     const functionName = functions[0]?.name;
     if (!functionName) return {};
     const expected = toKebabCase2(functionName);
-    const actual = path19.basename(filename, path19.extname(filename));
+    const actual = path20.basename(filename, path20.extname(filename));
     if (!expected || actual === expected) return {};
     return {
       Program(node) {
         context.report({
           node,
-          message: `A utility file exporting ${functionName} must be named ${expected}.${path19.extname(filename).slice(1)}.`
+          message: `A utility file exporting ${functionName} must be named ${expected}.${path20.extname(filename).slice(1)}.`
         });
       }
     };
@@ -2263,7 +2302,7 @@ var utilFileNameRule = {
 };
 
 // eslint/rules/no-util-barrel.ts
-import path20 from "path";
+import path21 from "path";
 var noUtilBarrelRule = {
   meta: {
     schema: [],
@@ -2273,7 +2312,7 @@ var noUtilBarrelRule = {
     }
   },
   create(context) {
-    const filename = path20.resolve(context.filename);
+    const filename = path21.resolve(context.filename);
     const sourceRoot = sourceRootOf3(context, filename);
     return {
       Program(node) {
@@ -2282,7 +2321,7 @@ var noUtilBarrelRule = {
           if (!target) continue;
           const segments = target.replace(/\\/g, "/").split("/");
           const utilsIndex = segments.lastIndexOf("utils");
-          if (utilsIndex < 0 || !path20.basename(target).startsWith("index.")) continue;
+          if (utilsIndex < 0 || !path21.basename(target).startsWith("index.")) continue;
           context.report({
             node,
             message: `Import utilities directly instead of through "${specifier}". See docs/next-codebase-guide/rules/utilities-rule.md`
@@ -2302,10 +2341,10 @@ function importSpecifiers2(source) {
   return specifiers;
 }
 function sourceRootOf3(context, filename) {
-  const marker = `${path20.sep}src${path20.sep}`;
+  const marker = `${path21.sep}src${path21.sep}`;
   const srcIndex = filename.lastIndexOf(marker);
   if (srcIndex >= 0) return filename.slice(0, srcIndex + marker.length - 1);
-  return path20.resolve(context.cwd ?? process.cwd(), "src");
+  return path21.resolve(context.cwd ?? process.cwd(), "src");
 }
 
 // eslint/rules/jsx-hygiene.ts
@@ -2398,7 +2437,7 @@ var jsxHygieneRule = {
 };
 
 // eslint/rules/interactive-component.ts
-import path21 from "path";
+import path22 from "path";
 var INTERACTIVE_TAGS = /* @__PURE__ */ new Set([
   "a",
   "button",
@@ -2553,8 +2592,8 @@ var interactiveComponentRule = {
   },
   create(context) {
     if (!context.filename.endsWith(".tsx") && !context.filename.endsWith(".jsx")) return {};
-    const filename = path21.resolve(context.filename);
-    const base = path21.basename(filename, path21.extname(filename));
+    const filename = path22.resolve(context.filename);
+    const base = path22.basename(filename, path22.extname(filename));
     if (NEXT_ROUTING_FILES3.has(base)) return {};
     return {
       JSXElement(node) {
@@ -2805,12 +2844,12 @@ var cvaBooleanVariantsRule = {
 };
 
 // eslint/rules/cross-feature-import.ts
-import path22 from "path";
+import path23 from "path";
 var FEATURES_SEGMENT = "features";
 function featureNameOf(resolvedPath, sourceRoot) {
-  const relative = path22.relative(sourceRoot, resolvedPath);
+  const relative = path23.relative(sourceRoot, resolvedPath);
   if (relative.startsWith("..")) return void 0;
-  const segments = relative.split(path22.sep);
+  const segments = relative.split(path23.sep);
   if (segments[0] !== FEATURES_SEGMENT || segments.length < 2) return void 0;
   return segments[1];
 }
@@ -2826,9 +2865,9 @@ var crossFeatureImportRule = {
     const filename = context.filename;
     if (!filename.endsWith(".tsx") && !filename.endsWith(".jsx")) return {};
     const sourceRoot = sourceRootOf(context);
-    const fileRelative = path22.relative(sourceRoot, filename);
+    const fileRelative = path23.relative(sourceRoot, filename);
     if (fileRelative.startsWith("..")) return {};
-    const fileSegments = fileRelative.split(path22.sep);
+    const fileSegments = fileRelative.split(path23.sep);
     const isInCompositions = fileSegments[0] === "compositions";
     const isInApp = fileSegments[0] === "app";
     const isConfig = fileSegments[0] === "config";
@@ -2842,9 +2881,9 @@ var crossFeatureImportRule = {
         if (typeof source.value !== "string") return;
         let resolved;
         if (source.value.startsWith("@/")) {
-          resolved = path22.resolve(sourceRoot, source.value.slice(2));
+          resolved = path23.resolve(sourceRoot, source.value.slice(2));
         } else if (source.value.startsWith(".")) {
-          resolved = path22.resolve(path22.dirname(filename), source.value);
+          resolved = path23.resolve(path23.dirname(filename), source.value);
         }
         if (!resolved) return;
         const feature = featureNameOf(resolved, sourceRoot);
@@ -2863,7 +2902,7 @@ var crossFeatureImportRule = {
 };
 
 // eslint/rules/pure-function-extract.ts
-import path23 from "path";
+import path24 from "path";
 function isComponentLikeName(name) {
   return /^[A-Z]/.test(name);
 }
@@ -2892,9 +2931,9 @@ var pureFunctionExtractRule = {
     const filename = context.filename;
     if (!filename.endsWith(".tsx") && !filename.endsWith(".jsx")) return {};
     const sourceRoot = sourceRootOf(context);
-    const relative = path23.relative(sourceRoot, filename);
+    const relative = path24.relative(sourceRoot, filename);
     if (relative.startsWith("..")) return {};
-    const segments = relative.split(path23.sep);
+    const segments = relative.split(path24.sep);
     if (segments[0] === "utils") return {};
     if (segments[0] === "app") return {};
     const supportFolders = /* @__PURE__ */ new Set(["hooks", "types", "schemas", "constants", "utils"]);
@@ -2934,7 +2973,7 @@ var pureFunctionExtractRule = {
 };
 
 // eslint/rules/hook-complexity.ts
-import path24 from "path";
+import path25 from "path";
 import ts4 from "typescript";
 var REACT_HOOKS = /* @__PURE__ */ new Set([
   "useState",
@@ -2987,9 +3026,9 @@ var hookComplexityRule = {
   create(context) {
     const filename = context.filename;
     const sourceRoot = sourceRootOf(context);
-    const relative = path24.relative(sourceRoot, filename);
+    const relative = path25.relative(sourceRoot, filename);
     if (relative.startsWith("..")) return {};
-    const segments = relative.split(path24.sep);
+    const segments = relative.split(path25.sep);
     const sourceText = context.sourceCode.text;
     function checkHook(node, name, body, exported) {
       if (!exported) return;
@@ -3031,9 +3070,9 @@ var hookComplexityRule = {
 };
 
 // eslint/rules/locale-dotted-path.ts
-import path25 from "path";
+import path26 from "path";
 function isInLocalesDir(filename) {
-  const segments = path25.resolve(filename).split(path25.sep);
+  const segments = path26.resolve(filename).split(path26.sep);
   const srcIdx = segments.lastIndexOf("src");
   return srcIdx !== -1 && segments[srcIdx + 1] === "locales";
 }
@@ -3082,16 +3121,22 @@ var localeDottedPathRule = {
 };
 
 // eslint/rules/locales-location.ts
-import path26 from "path";
+import path27 from "path";
 function isLocalesFile(filename) {
-  const segments = path26.resolve(filename).split(path26.sep);
+  const segments = path27.resolve(filename).split(path27.sep);
   const srcIdx = segments.lastIndexOf("src");
   return srcIdx !== -1 && segments[srcIdx + 1] === "locales";
 }
+function isTestFile(filename) {
+  return /\.(?:test|spec)\.[cm]?tsx?$/.test(filename);
+}
 var LOCALE_NAME_RE = /^[a-z][a-zA-Z0-9]*$/;
 function looksLikeLocaleKey(name) {
   return LOCALE_NAME_RE.test(name);
 }
+function looksLikeUserFacingString(value) {
+  return typeof value === "string" && /^\p{Lu}/u.test(value);
+}
 var localesLocationRule = {
   meta: {
     schema: [],
@@ -3101,9 +3146,9 @@ var localesLocationRule = {
     }
   },
   create(context) {
-    if (isLocalesFile(context.filename)) return {};
+    if (isLocalesFile(context.filename) || isTestFile(context.filename)) return {};
     const filename = context.filename;
-    const segments = path26.resolve(filename).split(path26.sep);
+    const segments = path27.resolve(filename).split(path27.sep);
     const srcIdx = segments.lastIndexOf("src");
     if (srcIdx === -1) return {};
     const folder = segments[srcIdx + 1];
@@ -3111,8 +3156,10 @@ var localesLocationRule = {
     return {
       VariableDeclarator(node) {
         if (node.id.type === "Identifier" && node.init?.type === "ObjectExpression" && node.init.properties.length > 0 && looksLikeLocaleKey(node.id.name)) {
-          const hasStringValues = node.init.properties.some((p) => p.type === "Property" && p.value.type === "Literal");
-          if (hasStringValues) {
+          const hasUserFacingStringValues = node.init.properties.some(
+            (p) => p.type === "Property" && p.value.type === "Literal" && looksLikeUserFacingString(p.value.value)
+          );
+          if (hasUserFacingStringValues) {
             context.report({
               node,
               message: "User-facing strings must live in src/locales/, not inline in component files."
@@ -3125,7 +3172,7 @@ var localesLocationRule = {
 };
 
 // eslint/rules/hook-extraction.ts
-import path27 from "path";
+import path28 from "path";
 var hookExtractionRule = {
   meta: {
     schema: [],
@@ -3136,7 +3183,7 @@ var hookExtractionRule = {
   },
   create(context) {
     const sourceRoot = sourceRootOf(context);
-    const file = path27.resolve(context.filename);
+    const file = path28.resolve(context.filename);
     const segments = segmentsOf(file, sourceRoot);
     if (segments.length === 0) return {};
     const index = getProjectIndex(sourceRoot);
@@ -3162,7 +3209,7 @@ var hookExtractionRule = {
 };
 
 // eslint/rules/value-extraction.ts
-import path28 from "path";
+import path29 from "path";
 var valueExtractionRule = {
   meta: {
     schema: [],
@@ -3173,7 +3220,7 @@ var valueExtractionRule = {
   },
   create(context) {
     const sourceRoot = sourceRootOf(context);
-    const file = path28.resolve(context.filename);
+    const file = path29.resolve(context.filename);
     const segments = segmentsOf(file, sourceRoot);
     if (segments.length === 0 || segments[0] !== "app") return {};
     const index = getProjectIndex(sourceRoot);
@@ -3194,7 +3241,7 @@ var valueExtractionRule = {
 };
 
 // eslint/rules/config-extraction.ts
-import path29 from "path";
+import path30 from "path";
 var configExtractionRule = {
   meta: {
     schema: [],
@@ -3205,7 +3252,7 @@ var configExtractionRule = {
   },
   create(context) {
     const sourceRoot = sourceRootOf(context);
-    const file = path29.resolve(context.filename);
+    const file = path30.resolve(context.filename);
     const segments = segmentsOf(file, sourceRoot);
     if (segments.length < 3 || segments[0] !== "config") return {};
     if (SUPPORT_FOLDERS2.has(segments[2] ?? "")) return {};
@@ -3243,7 +3290,7 @@ var configExtractionRule = {
 };
 
 // eslint/rules/component-nesting.ts
-import path30 from "path";
+import path31 from "path";
 var componentNestingRule = {
   meta: {
     schema: [],
@@ -3254,7 +3301,7 @@ var componentNestingRule = {
   },
   create(context) {
     const sourceRoot = sourceRootOf(context);
-    const file = path30.resolve(context.filename);
+    const file = path31.resolve(context.filename);
     const segments = segmentsOf(file, sourceRoot);
     if (segments.length !== 4 || segments[0] !== "features") return {};
     const index = getProjectIndex(sourceRoot);
@@ -3287,7 +3334,7 @@ var componentNestingRule = {
 };
 
 // eslint/rules/stay-flat.ts
-import path31 from "path";
+import path32 from "path";
 var stayFlatRule = {
   meta: {
     schema: [],
@@ -3298,7 +3345,7 @@ var stayFlatRule = {
   },
   create(context) {
     const sourceRoot = sourceRootOf(context);
-    const file = path31.resolve(context.filename);
+    const file = path32.resolve(context.filename);
     const segments = segmentsOf(file, sourceRoot);
     if (segments.length !== 3 || segments[0] !== "features") return {};
     const index = getProjectIndex(sourceRoot);
@@ -3338,7 +3385,7 @@ var stayFlatRule = {
 };
 
 // eslint/rules/type-extraction.ts
-import path32 from "path";
+import path33 from "path";
 var typeExtractionRule = {
   meta: {
     schema: [],
@@ -3349,7 +3396,7 @@ var typeExtractionRule = {
   },
   create(context) {
     const sourceRoot = sourceRootOf(context);
-    const file = path32.resolve(context.filename);
+    const file = path33.resolve(context.filename);
     const segments = segmentsOf(file, sourceRoot);
     if (segments.length === 0) return {};
     const index = getProjectIndex(sourceRoot);
@@ -3395,7 +3442,7 @@ var typeExtractionRule = {
 };
 
 // eslint/rules/locale-placement.ts
-import path33 from "path";
+import path34 from "path";
 import { readFileSync as readFileSync4 } from "fs";
 import ts5 from "typescript";
 var LOCALE_ACCESS = /\blocales\.(?<key>[A-Za-z_$][\w$]*)/g;
@@ -3443,7 +3490,7 @@ var localePlacementRule = {
   },
   create(context) {
     const sourceRoot = sourceRootOf(context);
-    const file = path33.resolve(context.filename);
+    const file = path34.resolve(context.filename);
     const segments = segmentsOf(file, sourceRoot);
     if (segments.length === 0) return {};
     const index = getProjectIndex(sourceRoot);
@@ -3521,7 +3568,7 @@ var localePlacementRule = {
 };
 
 // eslint/rules/sole-state-owner.ts
-import path34 from "path";
+import path35 from "path";
 import ts6 from "typescript";
 function findStateHooks(node) {
   const hooks = [];
@@ -3601,7 +3648,7 @@ var soleStateOwnerRule = {
     }
   },
   create(context) {
-    const filename = path34.resolve(context.filename);
+    const filename = path35.resolve(context.filename);
     if (!filename.endsWith(".tsx") && !filename.endsWith(".jsx")) return {};
     const text = context.sourceCode.text;
     const components = parseComponentInfo(text, filename);
@@ -3680,7 +3727,7 @@ function usesOutsideJsx(declaration, hook, children) {
 }
 
 // eslint/rules/locale-key-shape.ts
-import path35 from "path";
+import path36 from "path";
 var MAX_KEY_LENGTH = 30;
 var ROLE_POSTFIXES = /* @__PURE__ */ new Set([
   "Button",
@@ -3730,7 +3777,7 @@ var ROLE_POSTFIXES = /* @__PURE__ */ new Set([
 var CAMEL_CASE = /^[a-z][a-zA-Z0-9]*$/;
 var ENGLISH = /^[A-Za-z0-9_]*$/;
 function isLocalesFile2(filename) {
-  const segments = path35.resolve(filename).split(path35.sep);
+  const segments = path36.resolve(filename).split(path36.sep);
   const srcIdx = segments.lastIndexOf("src");
   return srcIdx !== -1 && segments[srcIdx + 1] === "locales";
 }
@@ -3801,7 +3848,7 @@ var localeKeyShapeRule = {
 };
 
 // eslint/rules/shared-style-dedup.ts
-import path36 from "path";
+import path37 from "path";
 import { readFileSync as readFileSync5, statSync as statSync3 } from "fs";
 var CLASS_NAME = /className="(?<classes>[^"]+)"/g;
 var comboCache;
@@ -3839,7 +3886,7 @@ var sharedStyleDedupRule = {
   },
   create(context) {
     const sourceRoot = sourceRootOf(context);
-    const file = path36.resolve(context.filename);
+    const file = path37.resolve(context.filename);
     const segments = segmentsOf(file, sourceRoot);
     if (segments.length === 0) return {};
     const index = getProjectIndex(sourceRoot);
@@ -4043,7 +4090,7 @@ var zodSchemaValidationRule = {
 };
 
 // eslint/rules/schema-casing.ts
-import path37 from "path";
+import path38 from "path";
 function isCamelCase(name) {
   return /^[a-z][a-zA-Z0-9]*$/.test(name);
 }
@@ -4071,9 +4118,9 @@ var schemaCasingRule = {
     }
   },
   create(context) {
-    const filename = path37.resolve(context.filename);
+    const filename = path38.resolve(context.filename);
     const sourceRoot = sourceRootOf(context);
-    if (!filename.startsWith(sourceRoot + path37.sep)) return {};
+    if (!filename.startsWith(sourceRoot + path38.sep)) return {};
     let zodLocalName;
     return {
       ImportDeclaration(node) {
@@ -4105,7 +4152,7 @@ var schemaCasingRule = {
 };
 
 // eslint/rules/component-casing.ts
-import path38 from "path";
+import path39 from "path";
 function isPascalCase6(name) {
   return /^[A-Z][A-Za-z0-9]*$/.test(name);
 }
@@ -4118,10 +4165,10 @@ var componentCasingRule = {
     }
   },
   create(context) {
-    const filename = path38.resolve(context.filename);
+    const filename = path39.resolve(context.filename);
     const sourceRoot = sourceRootOf(context);
-    if (!filename.startsWith(sourceRoot + path38.sep)) return {};
-    if (path38.extname(filename) !== ".tsx") return {};
+    if (!filename.startsWith(sourceRoot + path39.sep)) return {};
+    if (path39.extname(filename) !== ".tsx") return {};
     return {
       Program(node) {
         for (const declaration of findJsxReturningDeclarations(context.sourceCode.text, filename)) {
@@ -4138,7 +4185,7 @@ var componentCasingRule = {
 };
 
 // eslint/rules/source-under-src.ts
-import path39 from "path";
+import path40 from "path";
 var NON_SOURCE_ROOT_DIRS = /* @__PURE__ */ new Set([
   ".agents",
   ".cache",
@@ -4179,14 +4226,14 @@ var sourceUnderSrcRule = {
     }
   },
   create(context) {
-    const filename = path39.resolve(context.filename);
+    const filename = path40.resolve(context.filename);
     if (!MODULE_EXTENSION.test(filename)) return {};
-    const relative = path39.relative(context.cwd, filename).replace(/\\/g, "/");
+    const relative = path40.relative(context.cwd, filename).replace(/\\/g, "/");
     if (relative === "src" || relative.startsWith("src/")) return {};
     const topLevel = relative.split("/")[0] ?? "";
     if (NON_SOURCE_ROOT_DIRS.has(topLevel)) return {};
     if (!relative.includes("/")) {
-      const basename = path39.basename(filename);
+      const basename = path40.basename(filename);
       if (CONFIG_FILE.test(basename) || DECLARATION_FILE.test(basename) || basename.startsWith(".")) return {};
     }
     return {
@@ -4203,7 +4250,7 @@ var sourceUnderSrcRule = {
 
 // eslint/rules/zirka-baseline.ts
 import fs5 from "fs";
-import path40 from "path";
+import path41 from "path";
 var ESLINT_CONFIG = /^eslint\.config\.(?:ts|mts|cts|js|mjs|cjs)$/;
 var PRETTIER_CONFIGS = [
   "prettier.config.mjs",
@@ -4222,10 +4269,10 @@ var zirkaBaselineRule = {
     }
   },
   create(context) {
-    const filename = path40.resolve(context.filename);
-    const basename = path40.basename(filename);
+    const filename = path41.resolve(context.filename);
+    const basename = path41.basename(filename);
     if (!ESLINT_CONFIG.test(basename)) return {};
-    const projectRoot = path40.dirname(filename);
+    const projectRoot = path41.dirname(filename);
     const report3 = (message) => {
       context.report({
         node: context.sourceCode.ast,
@@ -4240,7 +4287,7 @@ var zirkaBaselineRule = {
             'ESLint config must take its configuration from zirka (import { styleguide } from "zirka") instead of restating rules locally.'
           );
         }
-        const tsconfigPath = path40.join(projectRoot, "tsconfig.json");
+        const tsconfigPath = path41.join(projectRoot, "tsconfig.json");
         if (!fs5.existsSync(tsconfigPath)) {
           report3('No tsconfig.json found. Create one extending the zirka TypeScript base config ("zirka/typescript").');
         } else {
@@ -4258,13 +4305,13 @@ var zirkaBaselineRule = {
             report3('tsconfig.json must extend the zirka TypeScript base config ("zirka/typescript").');
           }
         }
-        const prettierConfigFile = PRETTIER_CONFIGS.find((name) => fs5.existsSync(path40.join(projectRoot, name)));
+        const prettierConfigFile = PRETTIER_CONFIGS.find((name) => fs5.existsSync(path41.join(projectRoot, name)));
         if (!prettierConfigFile) {
           report3(
             "No prettier config found. Create one that takes its configuration from zirka (styleguide({ prettier: true }).prettierConfig)."
           );
         } else {
-          const content = fs5.readFileSync(path40.join(projectRoot, prettierConfigFile), "utf8");
+          const content = fs5.readFileSync(path41.join(projectRoot, prettierConfigFile), "utf8");
           if (!content.includes("zirka")) {
             report3(
               "The prettier config must take its configuration from zirka (styleguide({ prettier: true }).prettierConfig) instead of restating it locally."
@@ -4334,7 +4381,7 @@ var docKindSuffixRule = {
 };
 
 // eslint/rules/documentation/title-matches-file-name.ts
-import path41 from "path";
+import path42 from "path";
 function toExpectedFileName(title) {
   return `${title.toLowerCase().replaceAll(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "")}.md`;
 }
@@ -4354,7 +4401,7 @@ var titleMatchesFileNameRule = {
         if (!filename.endsWith(".md")) return;
         const title = getTextContent(node).trim();
         const expectedFileName = toExpectedFileName(title);
-        const actualFileName = path41.basename(filename);
+        const actualFileName = path42.basename(filename);
         if (!title) {
           context.report({
             node,
@@ -4797,20 +4844,20 @@ var referenceBlockHeadingsRule = {
 
 // eslint/rules/documentation/support-document-placement.ts
 import { existsSync as existsSync2 } from "fs";
-import path42 from "path";
+import path43 from "path";
 function checkPlacement(filename, kind) {
-  const parentFolder = path42.basename(path42.dirname(filename));
+  const parentFolder = path43.basename(path43.dirname(filename));
   const expectedParent = `${kind}s`;
   if (parentFolder !== expectedParent) {
     return `${kind} lives in "${parentFolder}/" instead of "${expectedParent}/"`;
   }
-  const guideFolderPath = path42.dirname(path42.dirname(filename));
-  const guideFolder = path42.basename(guideFolderPath);
+  const guideFolderPath = path43.dirname(path43.dirname(filename));
+  const guideFolder = path43.basename(guideFolderPath);
   if (!guideFolder.endsWith("-guide")) {
     return `${kind} owner folder "${guideFolder}/" does not use the "*-guide/" suffix`;
   }
   const entryPoint = `${guideFolder}.md`;
-  if (!existsSync2(path42.join(guideFolderPath, entryPoint))) {
+  if (!existsSync2(path43.join(guideFolderPath, entryPoint))) {
     return `${kind} owner folder "${guideFolder}/" has no "${entryPoint}" entry point`;
   }
   return void 0;
@@ -4869,11 +4916,11 @@ var noTemplatePromptRule = {
 };
 
 // eslint/rules/documentation/guide-folder-entry-point.ts
-import path44 from "path";
+import path45 from "path";
 
 // eslint/rules/documentation/project-index.ts
 import { readdirSync as readdirSync3, readFileSync as readFileSync6, statSync as statSync4 } from "fs";
-import path43 from "path";
+import path44 from "path";
 var KIND_BY_SUFFIX = [
   ["-rule.md", "rule"],
   ["-guide.md", "guide"],
@@ -4882,7 +4929,7 @@ var KIND_BY_SUFFIX = [
 ];
 function listMarkdownFiles(dir) {
   return readdirSync3(dir).flatMap((entry) => {
-    const entryPath = path43.join(dir, entry);
+    const entryPath = path44.join(dir, entry);
     if (statSync4(entryPath).isDirectory()) {
       return entry.startsWith("_") ? [] : listMarkdownFiles(entryPath);
     }
@@ -4900,11 +4947,11 @@ function getProjectDocs(docsRoot) {
   if (cached) return cached;
   const files = listMarkdownFiles(docsRoot);
   const docs = files.sort((a, b) => a.localeCompare(b)).map((filePath) => {
-    const fileName = path43.basename(filePath);
+    const fileName = path44.basename(filePath);
     const kind = KIND_BY_SUFFIX.find(([suffix]) => fileName.endsWith(suffix))?.[1];
     return {
       filePath,
-      doc: path43.relative(docsRoot, filePath).split(path43.sep).join("/"),
+      doc: path44.relative(docsRoot, filePath).split(path44.sep).join("/"),
       fileName,
       kind,
       title: extractTitle(filePath)
@@ -4914,12 +4961,12 @@ function getProjectDocs(docsRoot) {
   return docs;
 }
 function findDocsRoot(filePath) {
-  let dir = path43.dirname(filePath);
+  let dir = path44.dirname(filePath);
   for (; ; ) {
-    if (path43.basename(dir) === "docs" && statSync4(dir).isDirectory()) {
+    if (path44.basename(dir) === "docs" && statSync4(dir).isDirectory()) {
       return dir;
     }
-    const parent = path43.dirname(dir);
+    const parent = path44.dirname(dir);
     if (parent === dir) return void 0;
     dir = parent;
   }
@@ -4943,13 +4990,13 @@ var guideFolderEntryPointRule = {
         if (!docsRoot) return;
         const docs = getProjectDocs(docsRoot);
         const guideFolders = new Set(
-          docs.filter((doc) => ["rules", "references"].includes(path44.basename(path44.dirname(doc.filePath)))).map((doc) => path44.dirname(path44.dirname(doc.filePath))).filter((folder) => path44.resolve(folder) !== path44.resolve(docsRoot))
+          docs.filter((doc) => ["rules", "references"].includes(path45.basename(path45.dirname(doc.filePath)))).map((doc) => path45.dirname(path45.dirname(doc.filePath))).filter((folder) => path45.resolve(folder) !== path45.resolve(docsRoot))
         );
-        const currentDir = path44.dirname(filename);
+        const currentDir = path45.dirname(filename);
         if (guideFolders.has(currentDir)) {
-          const expectedEntryPoint = `${path44.basename(currentDir)}.md`;
+          const expectedEntryPoint = `${path45.basename(currentDir)}.md`;
           const hasEntryPoint = docs.some(
-            (doc) => doc.kind === "guide" && path44.dirname(doc.filePath) === currentDir && doc.fileName === expectedEntryPoint
+            (doc) => doc.kind === "guide" && path45.dirname(doc.filePath) === currentDir && doc.fileName === expectedEntryPoint
           );
           if (!hasEntryPoint) {
             context.report({
@@ -5174,7 +5221,7 @@ var noNestedHowToRule = {
 
 // eslint/rules/documentation/glossary-term-linking.ts
 import { readFileSync as readFileSync7 } from "fs";
-import path45 from "path";
+import path46 from "path";
 function extractGlossaryTerms(filePath) {
   const content = readFileSync7(filePath, "utf8");
   const terms = [];
@@ -5228,9 +5275,9 @@ var glossaryTermLinkingRule = {
         const docsRoot = findDocsRoot(filename);
         if (!docsRoot) return;
         const docs = getProjectDocs(docsRoot);
-        const guideDir = path45.dirname(filename);
+        const guideDir = path46.dirname(filename);
         const guideReferences = docs.filter(
-          (doc) => doc.kind === "reference" && path45.dirname(doc.filePath) === guideDir
+          (doc) => doc.kind === "reference" && path46.dirname(doc.filePath) === guideDir
         );
         if (guideReferences.length === 0) return;
         const glossaryTerms = [];
@@ -5255,7 +5302,7 @@ var glossaryTermLinkingRule = {
 
 // eslint/rules/documentation/guide-mentions-documents.ts
 import { existsSync as existsSync3 } from "fs";
-import path46 from "path";
+import path47 from "path";
 function visitSteps3(node, check) {
   if (node.type === "list" && node.ordered) {
     for (const child of node.children) check(child);
@@ -5288,12 +5335,12 @@ var guideMentionsDocumentsRule = {
         if (!filename.endsWith("-guide.md")) return;
         const docsRoot = findDocsRoot(filename);
         if (!docsRoot) return;
-        const guideDir = path46.dirname(filename);
-        if (path46.basename(filename, ".md") !== path46.basename(guideDir)) return;
+        const guideDir = path47.dirname(filename);
+        if (path47.basename(filename, ".md") !== path47.basename(guideDir)) return;
         const docs = getProjectDocs(docsRoot);
         const owned = docs.filter((doc) => {
-          const parent = path46.dirname(doc.filePath);
-          return parent === path46.join(guideDir, "rules") || parent === path46.join(guideDir, "references");
+          const parent = path47.dirname(doc.filePath);
+          return parent === path47.join(guideDir, "rules") || parent === path47.join(guideDir, "references");
         });
         const allLinks = [];
         collectMarkdownLinks(node, allLinks);
@@ -5320,7 +5367,7 @@ var guideMentionsDocumentsRule = {
         for (const link of allLinks) {
           const target = linkTarget(link.url);
           if (!target.endsWith(".md")) continue;
-          const resolved = path46.normalize(path46.join(guideDir, target));
+          const resolved = path47.normalize(path47.join(guideDir, target));
           if (!existsSync3(resolved)) {
             context.report({
               node: link,
@@ -5870,11 +5917,11 @@ var themeVariableNamespaceRule = {
 
 // eslint/rules/tailwind/css-entry-point.ts
 import { statSync as statSync6 } from "fs";
-import path49 from "path";
+import path50 from "path";
 
 // eslint/rules/tailwind/source-files.ts
 import { readdirSync as readdirSync4, readFileSync as readFileSync8, statSync as statSync5 } from "fs";
-import path47 from "path";
+import path48 from "path";
 var CSS_EXTENSIONS = [".css"];
 var MODULE_EXTENSIONS3 = [".ts", ".tsx", ".mts", ".cts", ".js", ".jsx", ".mjs", ".cjs"];
 var SOURCE_EXTENSIONS = [...MODULE_EXTENSIONS3, ...CSS_EXTENSIONS];
@@ -5887,7 +5934,7 @@ function findFiles(dir, extensions) {
   }
   return entries.flatMap((entry) => {
     if (entry.startsWith(".") || entry === "node_modules") return [];
-    const entryPath = path47.join(dir, entry);
+    const entryPath = path48.join(dir, entry);
     let stats;
     try {
       stats = statSync5(entryPath);
@@ -5895,7 +5942,7 @@ function findFiles(dir, extensions) {
       return [];
     }
     if (stats.isDirectory()) return findFiles(entryPath, extensions);
-    return extensions.includes(path47.extname(entry)) ? [entryPath] : [];
+    return extensions.includes(path48.extname(entry)) ? [entryPath] : [];
   });
 }
 function cachedTextReader() {
@@ -5918,7 +5965,7 @@ function escapeRegExp(text) {
 }
 
 // eslint/rules/tailwind/stylesheet-graph.ts
-import path48 from "path";
+import path49 from "path";
 function registersTailwind(text) {
   return /@import\s+(?:url\(\s*)?["']tailwindcss["']\s*\)?/i.test(text);
 }
@@ -5932,25 +5979,25 @@ function moduleImports(text, fileName) {
   return new RegExp(`(?:import|require)\\s*\\(?\\s*["'][^"']*${escaped}["']`, "i").test(text);
 }
 function resolveSpecifier2(fromFile, spec, sourceRoot) {
-  if (spec.startsWith("/")) return path48.resolve(spec);
-  if (spec.startsWith("./") || spec.startsWith("../")) return path48.resolve(path48.dirname(fromFile), spec);
-  if (spec.startsWith("@/")) return path48.resolve(sourceRoot, spec.slice(2));
+  if (spec.startsWith("/")) return path49.resolve(spec);
+  if (spec.startsWith("./") || spec.startsWith("../")) return path49.resolve(path49.dirname(fromFile), spec);
+  if (spec.startsWith("@/")) return path49.resolve(sourceRoot, spec.slice(2));
   return void 0;
 }
 function buildStylesheetGraph(options) {
   const { cssFiles, sourceRoot, textOf } = options;
-  const cssSet = new Set(cssFiles.map((file) => path48.normalize(file)));
+  const cssSet = new Set(cssFiles.map((file) => path49.normalize(file)));
   const globals = cssFiles.filter((file) => registersTailwind(textOf(file)));
   const reachable = /* @__PURE__ */ new Set();
   const queue = [...globals];
-  for (const global of globals) reachable.add(path48.normalize(global));
+  for (const global of globals) reachable.add(path49.normalize(global));
   while (queue.length > 0) {
     const from = queue.shift();
     if (!from) continue;
     for (const spec of importedSpecifiers(textOf(from))) {
       const target = resolveSpecifier2(from, spec, sourceRoot);
       if (!target) continue;
-      const normalized = path48.normalize(target);
+      const normalized = path49.normalize(target);
       if (cssSet.has(normalized) && !reachable.has(normalized)) {
         reachable.add(normalized);
         queue.push(normalized);
@@ -5962,7 +6009,7 @@ function buildStylesheetGraph(options) {
     for (const spec of importedSpecifiers(textOf(global))) {
       const target = resolveSpecifier2(global, spec, sourceRoot);
       if (!target) continue;
-      const normalized = path48.normalize(target);
+      const normalized = path49.normalize(target);
       if (cssSet.has(normalized)) directChildren.add(normalized);
     }
   }
@@ -5995,7 +6042,7 @@ var cssEntryPointRule = {
     return {
       "StyleSheet:exit"(node) {
         if (globals.length === 0) return;
-        const current = path49.normalize(path49.resolve(context.filename));
+        const current = path50.normalize(path50.resolve(context.filename));
         if (globals.includes(current)) {
           if (globals.length > 1) {
             context.report({
@@ -6004,7 +6051,7 @@ var cssEntryPointRule = {
             });
             return;
           }
-          const basename = path49.basename(current);
+          const basename = path50.basename(current);
           const importCount = moduleFiles.filter((modulePath) => moduleImports(textOf(modulePath), basename)).length;
           if (importCount !== 1) {
             context.report({
@@ -6333,7 +6380,7 @@ var nextjsStackRule = {
 
 // eslint/rules/package-json/vitest-coverage.ts
 import { existsSync as existsSync4, readFileSync as readFileSync9 } from "fs";
-import path50 from "path";
+import path51 from "path";
 function memberName4(member) {
   return member.name.type === "String" ? member.name.value : member.name.name;
 }
@@ -6402,7 +6449,7 @@ var vitestCoverageRule = {
             message: 'package.json must declare a "test:unit:coverage" script that runs Vitest with coverage.'
           });
         }
-        const configName = VITEST_CONFIG_NAMES.find((name) => existsSync4(path50.join(context.cwd, name)));
+        const configName = VITEST_CONFIG_NAMES.find((name) => existsSync4(path51.join(context.cwd, name)));
         if (!configName) {
           context.report({
             node,
@@ -6410,7 +6457,7 @@ var vitestCoverageRule = {
           });
           return;
         }
-        const content = readFileSync9(path50.join(context.cwd, configName), "utf8");
+        const content = readFileSync9(path51.join(context.cwd, configName), "utf8");
         for (const metric of THRESHOLD_METRICS) {
           if (!new RegExp(`\\b${metric}\\s*:\\s*[1-9]\\d*`).test(content)) {
             context.report({ node, message: `${configName} must set a coverage threshold above zero for ${metric}.` });
@@ -6457,7 +6504,7 @@ var nextjsPackageJsonRules = {
 
 // eslint/rules/husky/husky-hook.ts
 import { existsSync as existsSync5, readFileSync as readFileSync10 } from "fs";
-import path51 from "path";
+import path52 from "path";
 var VITEST_CONFIG_NAMES2 = [
   "vitest.config.ts",
   "vitest.config.mts",
@@ -6483,7 +6530,7 @@ var huskyHookRule = {
         const root = node.body;
         if (root.type !== "Object") return;
         if (!context.filename.endsWith("package.json")) return;
-        const hookPath = path51.join(context.cwd, ".husky", "pre-commit");
+        const hookPath = path52.join(context.cwd, ".husky", "pre-commit");
         if (!existsSync5(hookPath)) {
           context.report({
             node,
@@ -6507,7 +6554,7 @@ var huskyHookRule = {
         }
         requireNamedScript("typecheck");
         requireNamedScript("test:unit:coverage");
-        const vitestConfigName = VITEST_CONFIG_NAMES2.find((name) => existsSync5(path51.join(context.cwd, name)));
+        const vitestConfigName = VITEST_CONFIG_NAMES2.find((name) => existsSync5(path52.join(context.cwd, name)));
         if (vitestConfigName !== void 0) {
           const coverageIndex = content.indexOf("npm run test:unit:coverage");
           const localAddIndex = content.indexOf(`git add ${vitestConfigName}`);
@@ -6521,7 +6568,7 @@ var huskyHookRule = {
         if (!content.includes("libyear --limit-major-individual=1")) {
           context.report({ node, message: ".husky/pre-commit must run npx libyear --limit-major-individual=1." });
         }
-        const suppressionsPath = path51.join(context.cwd, "eslint-suppressions.json");
+        const suppressionsPath = path52.join(context.cwd, "eslint-suppressions.json");
         if (existsSync5(suppressionsPath)) {
           requireNamedScript("lint:prune");
           const pruneIndex = content.indexOf("npm run lint:prune");
@@ -6594,7 +6641,7 @@ var vulykDependencyRule = {
 
 // eslint/rules/vulyk/vulyk-docs.ts
 import { existsSync as existsSync6, readFileSync as readFileSync11 } from "fs";
-import path52 from "path";
+import path53 from "path";
 var PASIKA_REPO = "Bredansky/pasika";
 var BASE_REQUIRED_DOCS = [
   { name: "documentation-guide", path: "docs/documentation-guide" },
@@ -6627,8 +6674,8 @@ var vulykDocsRule = {
         if (!context.filename.endsWith("package.json")) return;
         const root = node.body;
         if (root.type !== "Object") return;
-        const projectRoot = path52.dirname(path52.resolve(context.filename));
-        const configPath = path52.join(projectRoot, "vulyk.config.ts");
+        const projectRoot = path53.dirname(path53.resolve(context.filename));
+        const configPath = path53.join(projectRoot, "vulyk.config.ts");
         if (!existsSync6(configPath)) {
           context.report({
             node,
@@ -6653,7 +6700,7 @@ var vulykDocsRule = {
             });
           }
         }
-        const agentsPath = path52.join(projectRoot, "AGENTS.md");
+        const agentsPath = path53.join(projectRoot, "AGENTS.md");
         if (!existsSync6(agentsPath)) {
           context.report({
             node,
@@ -6686,6 +6733,7 @@ var pasikaNextjsAppRules = {
   "config-extraction": configExtractionRule,
   "value-extraction": valueExtractionRule,
   "constant-casing": constantCasingRule,
+  "prefer-enum": preferEnumRule,
   "type-extraction": typeExtractionRule,
   "zod-schema-validation": zodSchemaValidationRule,
   "schema-casing": schemaCasingRule,

package/package.json

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