pasika 0.10.51 → 0.10.53

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

@@ -208,6 +208,7 @@ declare const pasikaPlugin: {
         "value-extraction": eslint.Rule.RuleModule;
         "constant-casing": eslint.Rule.RuleModule;
         "prefer-enum": eslint.Rule.RuleModule;
+        "enum-placement": 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

@@ -229,6 +229,14 @@ function parseModule(file) {
       }
       continue;
     }
+    if (ts.isEnumDeclaration(statement)) {
+      exports.push({
+        name: statement.name.text,
+        kind: "constant",
+        line: lineOf(sourceFile, statement)
+      });
+      continue;
+    }
     if (ts.isTypeAliasDeclaration(statement) || ts.isInterfaceDeclaration(statement)) {
       exports.push({
         name: statement.name.text,
@@ -2925,6 +2933,32 @@ var enforceCvaVariantPropsRule = {
   }
 };
 
+// eslint/rules/enum-placement.ts
+import path24 from "path";
+var enumPlacementRule = {
+  meta: {
+    schema: [],
+    type: "problem",
+    docs: {
+      description: "Require TypeScript enum declarations to live in constants/ folders."
+    }
+  },
+  create(context) {
+    const filename = path24.resolve(context.filename);
+    const sourceRoot = sourceRootOf(context);
+    if (!filename.startsWith(sourceRoot + path24.sep)) return {};
+    if (path24.basename(path24.dirname(filename)) === "constants") return {};
+    return {
+      TSEnumDeclaration(node) {
+        context.report({
+          node,
+          message: "A TypeScript enum must live in a constants/ folder because it creates runtime values as well as a type. See docs/next-codebase-guide/rules/constants-rule.md"
+        });
+      }
+    };
+  }
+};
+
 // eslint/rules/file-length.ts
 var MAX_SOURCE_FILE_LINES = 300;
 var fileLengthRule = {
@@ -2951,7 +2985,7 @@ var fileLengthRule = {
 };
 
 // eslint/rules/filename-case.ts
-import path24 from "path";
+import path25 from "path";
 var NEXT_ROUTING_FILES2 = /* @__PURE__ */ new Set([
   "page",
   "layout",
@@ -2997,11 +3031,11 @@ var filenameCaseRule = {
     if (!normalized.includes("/src/")) {
       return {};
     }
-    const ext = path24.extname(filename);
-    let base = path24.basename(filename, ext);
-    const baseExt = path24.extname(base);
+    const ext = path25.extname(filename);
+    let base = path25.basename(filename, ext);
+    const baseExt = path25.extname(base);
     if (baseExt && COMPOUND_SUFFIXES.has(baseExt.slice(1))) {
-      base = path24.basename(base, baseExt);
+      base = path25.basename(base, baseExt);
     }
     if (NEXT_ROUTING_FILES2.has(base)) {
       return {};
@@ -3014,21 +3048,21 @@ var filenameCaseRule = {
           if (component?.smart && !isPascalCase5(base)) {
             context.report({
               node,
-              message: `Smart component files must use PascalCase.tsx. Filename "${path24.basename(filename)}" is not PascalCase.`
+              message: `Smart component files must use PascalCase.tsx. Filename "${path25.basename(filename)}" is not PascalCase.`
             });
             return;
           }
           if (component && !component.smart && !isKebabCase2(base)) {
             context.report({
               node,
-              message: `Dumb component files must use kebab-case.tsx. Filename "${path24.basename(filename)}" is not kebab-case.`
+              message: `Dumb component files must use kebab-case.tsx. Filename "${path25.basename(filename)}" is not kebab-case.`
             });
             return;
           }
           if (!component && !(isPascalCase5(base) || isKebabCase2(base))) {
             context.report({
               node,
-              message: `Filename "${path24.basename(filename)}" does not match pasika conventions. Component files must be PascalCase.tsx (smart) or kebab-case.tsx (dumb).`
+              message: `Filename "${path25.basename(filename)}" does not match pasika conventions. Component files must be PascalCase.tsx (smart) or kebab-case.tsx (dumb).`
             });
           }
         }
@@ -3047,14 +3081,14 @@ function report2(context, filename, ext) {
       context.report({
         node,
         loc: { line: 1, column: 0 },
-        message: `Filename "${path24.basename(filename)}" does not match pasika conventions. ${convention}`
+        message: `Filename "${path25.basename(filename)}" does not match pasika conventions. ${convention}`
       });
     }
   };
 }
 
 // eslint/rules/hook-complexity.ts
-import path25 from "path";
+import path26 from "path";
 import ts3 from "typescript";
 var REACT_HOOKS = /* @__PURE__ */ new Set([
   "useState",
@@ -3179,9 +3213,9 @@ var hookComplexityRule = {
   create(context) {
     const filename = context.filename;
     const sourceRoot = sourceRootOf(context);
-    const relative = path25.relative(sourceRoot, filename);
+    const relative = path26.relative(sourceRoot, filename);
     if (relative.startsWith("..")) return {};
-    const segments = relative.split(path25.sep);
+    const segments = relative.split(path26.sep);
     const sourceText = context.sourceCode.text;
     const index = getProjectIndex(sourceRoot);
     const localHookCalls = /* @__PURE__ */ new Set();
@@ -3268,7 +3302,7 @@ var hookComplexityRule = {
 };
 
 // eslint/rules/hook-extraction.ts
-import path26 from "path";
+import path27 from "path";
 var hookExtractionRule = {
   meta: {
     schema: [],
@@ -3279,7 +3313,7 @@ var hookExtractionRule = {
   },
   create(context) {
     const sourceRoot = sourceRootOf(context);
-    const file = path26.resolve(context.filename);
+    const file = path27.resolve(context.filename);
     const segments = segmentsOf(file, sourceRoot);
     if (segments.length === 0) return {};
     const index = getProjectIndex(sourceRoot);
@@ -3306,7 +3340,7 @@ var hookExtractionRule = {
 
 // eslint/rules/http-error-usage.ts
 import { readFileSync as readFileSync5 } from "fs";
-import path27 from "path";
+import path28 from "path";
 import ts4 from "typescript";
 var HTTP_ERROR = "HttpError";
 var ROUTE_FILE = "route.ts";
@@ -3350,13 +3384,13 @@ function parentClassOf(file, name) {
   return void 0;
 }
 function importedFrom(file, name, sourceRoot, index) {
-  const module = index.modules.get(path27.resolve(file));
+  const module = index.modules.get(path28.resolve(file));
   const moduleImport = module?.imports.find((entry) => entry.names.includes(name));
   if (!moduleImport) return void 0;
   return resolveSpecifier(file, moduleImport.specifier, sourceRoot);
 }
 function isHttpErrorClass(file, name, sourceRoot, index) {
-  let currentFile = path27.resolve(file);
+  let currentFile = path28.resolve(file);
   let currentName = name;
   for (let depth = 0; depth <= HERITAGE_DEPTH; depth += 1) {
     if (currentName === HTTP_ERROR) return true;
@@ -3377,7 +3411,7 @@ function pipelineFiles(sourceRoot) {
   if (!index) return void 0;
   if (pipelineCache?.index === index) return pipelineCache.files;
   const files = /* @__PURE__ */ new Set();
-  const queue = [...index.modules.keys()].filter((file) => path27.basename(file) === ROUTE_FILE);
+  const queue = [...index.modules.keys()].filter((file) => path28.basename(file) === ROUTE_FILE);
   while (queue.length > 0) {
     const file = queue.pop();
     if (file === void 0 || files.has(file)) continue;
@@ -3400,7 +3434,7 @@ var httpErrorUsageRule = {
   },
   create(context) {
     const sourceRoot = sourceRootOf(context);
-    const file = path27.resolve(context.filename);
+    const file = path28.resolve(context.filename);
     let delegated;
     function inPipeline() {
       delegated ??= pipelineFiles(sourceRoot)?.has(file) ?? false;
@@ -3435,7 +3469,7 @@ var httpErrorUsageRule = {
 
 // eslint/rules/husky/husky-hook.ts
 import { existsSync as existsSync4, readFileSync as readFileSync6 } from "fs";
-import path28 from "path";
+import path29 from "path";
 function memberName(member) {
   return member.name.type === "String" ? member.name.value : member.name.name;
 }
@@ -3453,7 +3487,7 @@ var huskyHookRule = {
         const root = node.body;
         if (root.type !== "Object") return;
         if (!context.filename.endsWith("package.json")) return;
-        const hookPath = path28.join(context.cwd, ".husky", "pre-commit");
+        const hookPath = path29.join(context.cwd, ".husky", "pre-commit");
         if (!existsSync4(hookPath)) {
           context.report({
             node,
@@ -3480,7 +3514,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 = path28.join(context.cwd, "eslint-suppressions.json");
+        const suppressionsPath = path29.join(context.cwd, "eslint-suppressions.json");
         if (existsSync4(suppressionsPath)) {
           requireNamedScript("lint:prune");
           const pruneIndex = content.indexOf("npm run lint:prune");
@@ -3512,28 +3546,28 @@ var huskyRules = {
 };
 
 // eslint/rules/import-boundaries.ts
-import path29 from "path";
+import path30 from "path";
 var rootSupportFolders = /* @__PURE__ */ new Set(["config", "constants", "hooks", "locales", "schemas", "types", "utils"]);
 var moduleExtensions = /* @__PURE__ */ new Set([".cjs", ".cts", ".js", ".jsx", ".mjs", ".mts", ".ts", ".tsx"]);
 var styleExtensions = /* @__PURE__ */ new Set([".css", ".less", ".sass", ".scss"]);
 function resolveSourceImport(sourceRoot, filename, importPath) {
   if (importPath.startsWith("@/")) {
-    return path29.resolve(sourceRoot, importPath.slice(2));
+    return path30.resolve(sourceRoot, importPath.slice(2));
   }
   if (importPath.startsWith(".")) {
-    return path29.resolve(path29.dirname(filename), importPath);
+    return path30.resolve(path30.dirname(filename), importPath);
   }
   return void 0;
 }
 function sourceSegments(sourceRoot, absolutePath) {
-  const relativePath = path29.relative(sourceRoot, absolutePath);
-  if (relativePath.startsWith("..") || path29.isAbsolute(relativePath)) {
+  const relativePath = path30.relative(sourceRoot, absolutePath);
+  if (relativePath.startsWith("..") || path30.isAbsolute(relativePath)) {
     return void 0;
   }
-  return relativePath.split(path29.sep);
+  return relativePath.split(path30.sep);
 }
 function relativeSpecifier(filename, resolvedPath) {
-  const relativePath = path29.relative(path29.dirname(filename), resolvedPath).split(path29.sep).join("/");
+  const relativePath = path30.relative(path30.dirname(filename), resolvedPath).split(path30.sep).join("/");
   return relativePath.startsWith(".") ? relativePath : `./${relativePath}`;
 }
 function aliasSpecifier(sourceRoot, resolvedPath) {
@@ -3572,7 +3606,7 @@ var importBoundariesRule = {
       }
       const [importerLayer = "", importerFeature] = importer;
       const [importedLayer = "", importedFeature] = imported;
-      const extension = path29.extname(importPath);
+      const extension = path30.extname(importPath);
       const isCodeModule = !extension || moduleExtensions.has(extension);
       const isAppLocalStyleImport = importerLayer === "app" && importedLayer === "app" && styleExtensions.has(extension);
       const importedIsRootSupport = rootSupportFolders.has(importedLayer);
@@ -3670,7 +3704,7 @@ var importSpacingRule = {
 };
 
 // eslint/rules/import-through-index.ts
-import path30 from "path";
+import path31 from "path";
 var importThroughIndexRule = {
   meta: {
     schema: [],
@@ -3680,7 +3714,7 @@ var importThroughIndexRule = {
     }
   },
   create(context) {
-    const filename = path30.resolve(context.filename);
+    const filename = path31.resolve(context.filename);
     const sourceRoot = sourceRootOf2(context, filename);
     return {
       Program(node) {
@@ -3692,7 +3726,7 @@ var importThroughIndexRule = {
             (segment) => ["constants", "types", "schemas"].includes(segment)
           );
           const supportFolder = supportFolderIndex >= 0 ? targetSegments[supportFolderIndex] : void 0;
-          if (!supportFolder || path30.basename(target).startsWith("index.")) continue;
+          if (!supportFolder || path31.basename(target).startsWith("index.")) continue;
           const folderIndex = targetSegments.slice(0, supportFolderIndex + 1);
           const expected = `@/${folderIndex.join("/")}`;
           context.report({
@@ -3714,14 +3748,14 @@ function importSpecifiers(source) {
   return specifiers;
 }
 function sourceRootOf2(context, filename) {
-  const marker = `${path30.sep}src${path30.sep}`;
+  const marker = `${path31.sep}src${path31.sep}`;
   const srcIndex = filename.lastIndexOf(marker);
   if (srcIndex >= 0) return filename.slice(0, srcIndex + marker.length - 1);
-  return path30.resolve(context.cwd ?? process.cwd(), "src");
+  return path31.resolve(context.cwd ?? process.cwd(), "src");
 }
 
 // eslint/rules/interactive-component.ts
-import path31 from "path";
+import path32 from "path";
 var INTERACTIVE_TAGS = /* @__PURE__ */ new Set([
   "a",
   "button",
@@ -3877,8 +3911,8 @@ var interactiveComponentRule = {
   },
   create(context) {
     if (!context.filename.endsWith(".tsx") && !context.filename.endsWith(".jsx")) return {};
-    const filename = path31.resolve(context.filename);
-    const base = path31.basename(filename, path31.extname(filename));
+    const filename = path32.resolve(context.filename);
+    const base = path32.basename(filename, path32.extname(filename));
     if (NEXT_ROUTING_FILES3.has(base)) return {};
     return {
       JSXElement(node) {
@@ -4002,9 +4036,9 @@ var jsxHygieneRule = {
 };
 
 // eslint/rules/locale-dotted-path.ts
-import path32 from "path";
+import path33 from "path";
 function isInLocalesDir(filename) {
-  const segments = path32.resolve(filename).split(path32.sep);
+  const segments = path33.resolve(filename).split(path33.sep);
   const srcIdx = segments.lastIndexOf("src");
   return srcIdx !== -1 && segments[srcIdx + 1] === "locales";
 }
@@ -4053,7 +4087,7 @@ var localeDottedPathRule = {
 };
 
 // eslint/rules/locale-key-shape.ts
-import path33 from "path";
+import path34 from "path";
 var MAX_KEY_LENGTH = 30;
 var ROLE_POSTFIXES = /* @__PURE__ */ new Set([
   "Button",
@@ -4103,7 +4137,7 @@ var ROLE_POSTFIXES = /* @__PURE__ */ new Set([
 var CAMEL_CASE = /^[a-z][a-zA-Z0-9]*$/;
 var ENGLISH = /^[A-Za-z0-9_]*$/;
 function isLocalesFile(filename) {
-  const segments = path33.resolve(filename).split(path33.sep);
+  const segments = path34.resolve(filename).split(path34.sep);
   const srcIdx = segments.lastIndexOf("src");
   return srcIdx !== -1 && segments[srcIdx + 1] === "locales";
 }
@@ -4175,7 +4209,7 @@ var localeKeyShapeRule = {
 
 // eslint/rules/locale-placement.ts
 import { readFileSync as readFileSync7 } from "fs";
-import path34 from "path";
+import path35 from "path";
 import ts6 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());
@@ -4222,7 +4256,7 @@ var localePlacementRule = {
   },
   create(context) {
     const sourceRoot = sourceRootOf(context);
-    const file = path34.resolve(context.filename);
+    const file = path35.resolve(context.filename);
     const segments = segmentsOf(file, sourceRoot);
     if (segments.length === 0) return {};
     const index = getProjectIndex(sourceRoot);
@@ -4300,9 +4334,9 @@ var localePlacementRule = {
 };
 
 // eslint/rules/locales-location.ts
-import path35 from "path";
+import path36 from "path";
 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";
 }
@@ -4382,7 +4416,7 @@ var localesLocationRule = {
   create(context) {
     if (isLocalesFile2(context.filename) || isTestFile(context.filename)) return {};
     const filename = context.filename;
-    const segments = path35.resolve(filename).split(path35.sep);
+    const segments = path36.resolve(filename).split(path36.sep);
     const srcIdx = segments.lastIndexOf("src");
     if (srcIdx === -1) return {};
     const folder = segments[srcIdx + 1];
@@ -4467,7 +4501,7 @@ var localesLocationRule = {
 };
 
 // eslint/rules/named-exports.ts
-import path36 from "path";
+import path37 from "path";
 var FRAMEWORK_DEFAULT_EXPORT_FILES = /* @__PURE__ */ new Set([
   // App Router routing files
   "default",
@@ -4489,9 +4523,9 @@ var FRAMEWORK_DEFAULT_EXPORT_FILES = /* @__PURE__ */ new Set([
   "twitter-image"
 ]);
 function isFrameworkDefaultExportFile(filename) {
-  const normalized = filename.replaceAll(path36.sep, "/");
+  const normalized = filename.replaceAll(path37.sep, "/");
   if (!normalized.includes("/src/app/")) return false;
-  const basename = path36.basename(filename, path36.extname(filename));
+  const basename = path37.basename(filename, path37.extname(filename));
   return FRAMEWORK_DEFAULT_EXPORT_FILES.has(basename);
 }
 var namedExportsRule = {
@@ -4754,7 +4788,7 @@ var noMixedConcernsRule = {
 };
 
 // eslint/rules/no-redundant-alias.ts
-import path37 from "path";
+import path38 from "path";
 var DOC3 = "See docs/next-codebase-guide/rules/redundant-aliases-rule.md";
 var VALUE_SENTINELS = /* @__PURE__ */ new Set(["undefined", "NaN", "Infinity"]);
 var HTTP_METHODS = /* @__PURE__ */ new Set(["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]);
@@ -4804,7 +4838,7 @@ var noRedundantAliasRule = {
         const declaration = node.parent;
         if (declaration.type !== "VariableDeclaration" || declaration.kind !== "const") return;
         const exported = declaration.parent.type === "ExportNamedDeclaration";
-        const frameworkRouteAlias = path37.basename(context.filename) === "route.ts" && exported && HTTP_METHODS.has(node.id.name);
+        const frameworkRouteAlias = path38.basename(context.filename) === "route.ts" && exported && HTTP_METHODS.has(node.id.name);
         if (frameworkRouteAlias || VALUE_SENTINELS.has(node.init.name)) return;
         context.report({
           node,
@@ -4828,7 +4862,7 @@ var noRedundantAliasRule = {
           const source = specifier.local.name;
           const alias = specifier.exported.name;
           if (source === alias) continue;
-          const frameworkRouteAlias = path37.basename(context.filename) === "route.ts" && HTTP_METHODS.has(alias);
+          const frameworkRouteAlias = path38.basename(context.filename) === "route.ts" && HTTP_METHODS.has(alias);
           if (frameworkRouteAlias) continue;
           context.report({
             node: specifier,
@@ -4853,7 +4887,7 @@ var noRedundantAliasRule = {
 };
 
 // eslint/rules/no-util-barrel.ts
-import path38 from "path";
+import path39 from "path";
 var noUtilBarrelRule = {
   meta: {
     schema: [],
@@ -4863,7 +4897,7 @@ var noUtilBarrelRule = {
     }
   },
   create(context) {
-    const filename = path38.resolve(context.filename);
+    const filename = path39.resolve(context.filename);
     const sourceRoot = sourceRootOf3(context, filename);
     return {
       Program(node) {
@@ -4872,7 +4906,7 @@ var noUtilBarrelRule = {
           if (!target) continue;
           const segments = target.replace(/\\/g, "/").split("/");
           const utilsIndex = segments.lastIndexOf("utils");
-          if (utilsIndex < 0 || !path38.basename(target).startsWith("index.")) continue;
+          if (utilsIndex < 0 || !path39.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`
@@ -4892,10 +4926,10 @@ function importSpecifiers2(source) {
   return specifiers;
 }
 function sourceRootOf3(context, filename) {
-  const marker = `${path38.sep}src${path38.sep}`;
+  const marker = `${path39.sep}src${path39.sep}`;
   const srcIndex = filename.lastIndexOf(marker);
   if (srcIndex >= 0) return filename.slice(0, srcIndex + marker.length - 1);
-  return path38.resolve(context.cwd ?? process.cwd(), "src");
+  return path39.resolve(context.cwd ?? process.cwd(), "src");
 }
 
 // eslint/rules/package-json/exact-version.ts
@@ -5114,7 +5148,7 @@ var nextjsStackRule = {
 
 // eslint/rules/package-json/vitest-coverage.ts
 import { existsSync as existsSync5, readFileSync as readFileSync8 } from "fs";
-import path39 from "path";
+import path40 from "path";
 function memberName5(member) {
   return member.name.type === "String" ? member.name.value : member.name.name;
 }
@@ -5183,7 +5217,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) => existsSync5(path39.join(context.cwd, name)));
+        const configName = VITEST_CONFIG_NAMES.find((name) => existsSync5(path40.join(context.cwd, name)));
         if (!configName) {
           context.report({
             node,
@@ -5191,7 +5225,7 @@ var vitestCoverageRule = {
           });
           return;
         }
-        const content = readFileSync8(path39.join(context.cwd, configName), "utf8");
+        const content = readFileSync8(path40.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}.` });
@@ -5237,7 +5271,7 @@ var nextjsPackageJsonRules = {
 };
 
 // eslint/rules/prefer-enum.ts
-import path40 from "path";
+import path41 from "path";
 function isConstAssertion(node) {
   const typeAnnotation = node.typeAnnotation;
   return typeAnnotation?.type === "TSTypeReference" && typeAnnotation.typeName?.type === "Identifier" && typeAnnotation.typeName.name === "const";
@@ -5289,9 +5323,9 @@ var preferEnumRule = {
     }
   },
   create(context) {
-    const filename = path40.resolve(context.filename);
+    const filename = path41.resolve(context.filename);
     const sourceRoot = sourceRootOf(context);
-    if (!filename.startsWith(sourceRoot + path40.sep)) return {};
+    if (!filename.startsWith(sourceRoot + path41.sep)) return {};
     const objectSchemas = /* @__PURE__ */ new Map();
     const discriminatedUnions = [];
     const reportedDiscriminants = /* @__PURE__ */ new Set();
@@ -5362,7 +5396,7 @@ var preferEnumRule = {
 };
 
 // eslint/rules/pure-function-extract.ts
-import path41 from "path";
+import path42 from "path";
 var ROUTE_HANDLER_EXPORT_NAMES = /* @__PURE__ */ new Set([
   "GET",
   "POST",
@@ -5427,12 +5461,12 @@ var pureFunctionExtractRule = {
   },
   create(context) {
     const filename = context.filename;
-    const isRouteFile = path41.basename(filename) === "route.ts";
+    const isRouteFile = path42.basename(filename) === "route.ts";
     const isComponentFile = filename.endsWith(".tsx") || filename.endsWith(".jsx");
     const sourceRoot = sourceRootOf(context);
-    const relative = path41.relative(sourceRoot, filename);
+    const relative = path42.relative(sourceRoot, filename);
     if (relative.startsWith("..")) return {};
-    const segments = relative.split(path41.sep);
+    const segments = relative.split(path42.sep);
     const folders = segments.slice(0, -1);
     const isHookSupportFile = folders.includes("hooks") && /\.(?:[cm]?[jt]s)$/.test(filename);
     if (!isComponentFile && !isRouteFile && !isHookSupportFile) return {};
@@ -5672,7 +5706,7 @@ var repeatedStructureRule = {
 };
 
 // eslint/rules/root-support-placement.ts
-import path42 from "path";
+import path43 from "path";
 function isSupportFolder(value) {
   return value === "utils" || value === "types" || value === "schemas" || value === "constants";
 }
@@ -5705,7 +5739,7 @@ var rootSupportPlacementRule = {
   },
   create(context) {
     const sourceRoot = sourceRootOf(context);
-    const file = path42.resolve(context.filename);
+    const file = path43.resolve(context.filename);
     const segments = segmentsOf(file, sourceRoot);
     const folderSegments = folderSegmentsOf(file, sourceRoot);
     const supportFolder = folderSegments[folderSegments.length - 1];
@@ -5745,7 +5779,7 @@ var rootSupportPlacementRule = {
 };
 
 // eslint/rules/route-handler-shape.ts
-import path43 from "path";
+import path44 from "path";
 import ts7 from "typescript";
 var HTTP_METHODS2 = /* @__PURE__ */ new Set(["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]);
 var REQUIRED_BOUNDARY = "withResponse";
@@ -5830,7 +5864,7 @@ var routeHandlerShapeRule = {
     }
   },
   create(context) {
-    if (path43.basename(context.filename) !== "route.ts") return {};
+    if (path44.basename(context.filename) !== "route.ts") return {};
     const sourceText = context.sourceCode.text;
     function reportUnwrapped(node, name) {
       context.report({
@@ -5889,7 +5923,7 @@ var routeHandlerShapeRule = {
 };
 
 // eslint/rules/schema-casing.ts
-import path44 from "path";
+import path45 from "path";
 function isCamelCase(name) {
   return /^[a-z][a-zA-Z0-9]*$/.test(name);
 }
@@ -5917,9 +5951,9 @@ var schemaCasingRule = {
     }
   },
   create(context) {
-    const filename = path44.resolve(context.filename);
+    const filename = path45.resolve(context.filename);
     const sourceRoot = sourceRootOf(context);
-    if (!filename.startsWith(sourceRoot + path44.sep)) return {};
+    if (!filename.startsWith(sourceRoot + path45.sep)) return {};
     let zodLocalName;
     return {
       ImportDeclaration(node) {
@@ -5951,7 +5985,7 @@ var schemaCasingRule = {
 };
 
 // eslint/rules/sole-state-owner.ts
-import path45 from "path";
+import path46 from "path";
 import ts8 from "typescript";
 function findStateHooks(node) {
   const hooks = [];
@@ -6031,7 +6065,7 @@ var soleStateOwnerRule = {
     }
   },
   create(context) {
-    const filename = path45.resolve(context.filename);
+    const filename = path46.resolve(context.filename);
     if (!filename.endsWith(".tsx") && !filename.endsWith(".jsx")) return {};
     const text = context.sourceCode.text;
     const components = parseComponentInfo(text, filename);
@@ -6110,7 +6144,7 @@ function usesOutsideJsx(declaration, hook, children) {
 }
 
 // eslint/rules/source-under-src.ts
-import path46 from "path";
+import path47 from "path";
 var NON_SOURCE_ROOT_DIRS = /* @__PURE__ */ new Set([
   ".agents",
   ".cache",
@@ -6151,14 +6185,14 @@ var sourceUnderSrcRule = {
     }
   },
   create(context) {
-    const filename = path46.resolve(context.filename);
+    const filename = path47.resolve(context.filename);
     if (!MODULE_EXTENSION.test(filename)) return {};
-    const relative = path46.relative(context.cwd, filename).replace(/\\/g, "/");
+    const relative = path47.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 = path46.basename(filename);
+      const basename = path47.basename(filename);
       if (CONFIG_FILE.test(basename) || DECLARATION_FILE.test(basename) || basename.startsWith(".")) return {};
     }
     return {
@@ -6174,7 +6208,7 @@ var sourceUnderSrcRule = {
 };
 
 // eslint/rules/stay-flat.ts
-import path47 from "path";
+import path48 from "path";
 var stayFlatRule = {
   meta: {
     schema: [],
@@ -6185,7 +6219,7 @@ var stayFlatRule = {
   },
   create(context) {
     const sourceRoot = sourceRootOf(context);
-    const file = path47.resolve(context.filename);
+    const file = path48.resolve(context.filename);
     const segments = segmentsOf(file, sourceRoot);
     if (segments.length !== 3 || segments[0] !== "features") return {};
     const index = getProjectIndex(sourceRoot);
@@ -6225,7 +6259,7 @@ var stayFlatRule = {
 };
 
 // eslint/rules/support-file-placement.ts
-import path48 from "path";
+import path49 from "path";
 var CONFIG_OWNED_FOLDERS = /* @__PURE__ */ new Set(["types", "constants"]);
 var EXPORT_KIND_BY_SUPPORT_FOLDER = /* @__PURE__ */ new Map([
   ["constants", "constant"],
@@ -6250,7 +6284,7 @@ var supportFilePlacementRule = {
   },
   create(context) {
     const sourceRoot = sourceRootOf(context);
-    const supportFile = path48.resolve(context.filename);
+    const supportFile = path49.resolve(context.filename);
     const currentFolder = folderSegmentsOf(supportFile, sourceRoot);
     const supportFolder = currentFolder[currentFolder.length - 1];
     if (supportFolder === void 0 || !SUPPORT_FOLDERS.has(supportFolder)) return {};
@@ -6304,7 +6338,7 @@ var supportFilePlacementRule = {
 
 // eslint/rules/support-folder-shape.ts
 import fs5 from "fs";
-import path49 from "path";
+import path50 from "path";
 var SUPPORT_FOLDERS3 = /* @__PURE__ */ new Set(["constants", "types", "schemas"]);
 var INDEX_NAMES = /* @__PURE__ */ new Set(["index.ts", "index.tsx", "index.mts", "index.cts"]);
 var supportFolderShapeRule = {
@@ -6316,12 +6350,12 @@ var supportFolderShapeRule = {
     }
   },
   create(context) {
-    const filename = path49.resolve(context.filename);
-    const baseName = path49.basename(filename);
+    const filename = path50.resolve(context.filename);
+    const baseName = path50.basename(filename);
     if (!INDEX_NAMES.has(baseName)) return {};
-    const folder = path49.basename(path49.dirname(filename));
+    const folder = path50.basename(path50.dirname(filename));
     if (!SUPPORT_FOLDERS3.has(folder)) return {};
-    const directory = path49.dirname(filename);
+    const directory = path50.dirname(filename);
     let entries;
     try {
       entries = fs5.readdirSync(directory);
@@ -6332,14 +6366,14 @@ var supportFolderShapeRule = {
     return {
       Program(node) {
         const source = context.sourceCode.text;
-        const hasDirectExport = /export\s+(?:const|let|var|function|class|type|interface|enum)\b/.test(source);
+        const hasDirectExport = /export\s+(?:const|let|var|function|class|interface|enum)\b/.test(source) || /export\s+type\s+[A-Za-z_$][\w$]*(?:\s*<[^;=]*>)?\s*=/.test(source);
         const exportedFiles = /* @__PURE__ */ new Set();
         let hasAnyReExport = false;
         const exportPattern = /export\s+(?:type\s+)?(?:\{[^}]*\}|\*)\s+from\s+["'](?<specifier>[^"']+)["']/g;
         for (const match of source.matchAll(exportPattern)) {
           hasAnyReExport = true;
           const specifier = match.groups?.specifier;
-          if (specifier?.startsWith(".")) exportedFiles.add(path49.basename(specifier));
+          if (specifier?.startsWith(".")) exportedFiles.add(path50.basename(specifier));
         }
         const guide = `docs/next-codebase-guide/rules/${folder === "constants" ? "constants" : "types-and-schemas"}-rule.md`;
         if (siblingModules.length === 0) {
@@ -6518,11 +6552,11 @@ var baseLayerPairRule = {
 
 // eslint/rules/tailwind/css-entry-point.ts
 import { statSync as statSync4 } from "fs";
-import path52 from "path";
+import path53 from "path";
 
 // eslint/rules/tailwind/source-files.ts
 import { readdirSync as readdirSync3, readFileSync as readFileSync9, statSync as statSync3 } from "fs";
-import path50 from "path";
+import path51 from "path";
 var CSS_EXTENSIONS = [".css"];
 var MODULE_EXTENSIONS3 = [".ts", ".tsx", ".mts", ".cts", ".js", ".jsx", ".mjs", ".cjs"];
 var SOURCE_EXTENSIONS = [...MODULE_EXTENSIONS3, ...CSS_EXTENSIONS];
@@ -6535,7 +6569,7 @@ function findFiles(dir, extensions) {
   }
   return entries.flatMap((entry) => {
     if (entry.startsWith(".") || entry === "node_modules") return [];
-    const entryPath = path50.join(dir, entry);
+    const entryPath = path51.join(dir, entry);
     let stats;
     try {
       stats = statSync3(entryPath);
@@ -6543,7 +6577,7 @@ function findFiles(dir, extensions) {
       return [];
     }
     if (stats.isDirectory()) return findFiles(entryPath, extensions);
-    return extensions.includes(path50.extname(entry)) ? [entryPath] : [];
+    return extensions.includes(path51.extname(entry)) ? [entryPath] : [];
   });
 }
 function cachedTextReader() {
@@ -6566,7 +6600,7 @@ function escapeRegExp(text) {
 }
 
 // eslint/rules/tailwind/stylesheet-graph.ts
-import path51 from "path";
+import path52 from "path";
 function registersTailwind(text) {
   return /@import\s+(?:url\(\s*)?["']tailwindcss["']\s*\)?/i.test(text);
 }
@@ -6580,25 +6614,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 path51.resolve(spec);
-  if (spec.startsWith("./") || spec.startsWith("../")) return path51.resolve(path51.dirname(fromFile), spec);
-  if (spec.startsWith("@/")) return path51.resolve(sourceRoot, spec.slice(2));
+  if (spec.startsWith("/")) return path52.resolve(spec);
+  if (spec.startsWith("./") || spec.startsWith("../")) return path52.resolve(path52.dirname(fromFile), spec);
+  if (spec.startsWith("@/")) return path52.resolve(sourceRoot, spec.slice(2));
   return void 0;
 }
 function buildStylesheetGraph(options) {
   const { cssFiles, sourceRoot, textOf } = options;
-  const cssSet = new Set(cssFiles.map((file) => path51.normalize(file)));
+  const cssSet = new Set(cssFiles.map((file) => path52.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(path51.normalize(global));
+  for (const global of globals) reachable.add(path52.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 = path51.normalize(target);
+      const normalized = path52.normalize(target);
       if (cssSet.has(normalized) && !reachable.has(normalized)) {
         reachable.add(normalized);
         queue.push(normalized);
@@ -6610,7 +6644,7 @@ function buildStylesheetGraph(options) {
     for (const spec of importedSpecifiers(textOf(global))) {
       const target = resolveSpecifier2(global, spec, sourceRoot);
       if (!target) continue;
-      const normalized = path51.normalize(target);
+      const normalized = path52.normalize(target);
       if (cssSet.has(normalized)) directChildren.add(normalized);
     }
   }
@@ -6618,8 +6652,8 @@ function buildStylesheetGraph(options) {
 }
 
 // eslint/rules/tailwind/css-entry-point.ts
-var APP_STYLES_DIR = path52.join("app", "styles");
-var GLOBAL_STYLESHEET_PATH = path52.join(APP_STYLES_DIR, "globals.css");
+var APP_STYLES_DIR = path53.join("app", "styles");
+var GLOBAL_STYLESHEET_PATH = path53.join(APP_STYLES_DIR, "globals.css");
 var cssEntryPointRule = {
   meta: {
     schema: [],
@@ -6645,8 +6679,8 @@ var cssEntryPointRule = {
     return {
       "StyleSheet:exit"(node) {
         if (globals.length === 0) return;
-        const current = path52.normalize(path52.resolve(context.filename));
-        const relative = path52.relative(sourceRoot, current);
+        const current = path53.normalize(path53.resolve(context.filename));
+        const relative = path53.relative(sourceRoot, current);
         if (globals.includes(current)) {
           if (globals.length > 1) {
             context.report({
@@ -6662,7 +6696,7 @@ var cssEntryPointRule = {
             });
             return;
           }
-          const basename = path52.basename(current);
+          const basename = path53.basename(current);
           const importCount = moduleFiles.filter((modulePath) => moduleImports(textOf(modulePath), basename)).length;
           if (importCount !== 1) {
             context.report({
@@ -6672,7 +6706,7 @@ var cssEntryPointRule = {
           }
           return;
         }
-        const isInAppStyles = relative === APP_STYLES_DIR || relative.startsWith(`${APP_STYLES_DIR}${path52.sep}`);
+        const isInAppStyles = relative === APP_STYLES_DIR || relative.startsWith(`${APP_STYLES_DIR}${path53.sep}`);
         if (!isInAppStyles) {
           context.report({
             node,
@@ -7161,7 +7195,7 @@ var tailwindRules = {
 };
 
 // eslint/rules/type-extraction.ts
-import path53 from "path";
+import path54 from "path";
 var typeExtractionRule = {
   meta: {
     schema: [],
@@ -7172,7 +7206,7 @@ var typeExtractionRule = {
   },
   create(context) {
     const sourceRoot = sourceRootOf(context);
-    const file = path53.resolve(context.filename);
+    const file = path54.resolve(context.filename);
     const segments = segmentsOf(file, sourceRoot);
     if (segments.length === 0) return {};
     const index = getProjectIndex(sourceRoot);
@@ -7307,7 +7341,7 @@ var uiStateRule = {
 // eslint/rules/unknown-utility.ts
 import { existsSync as existsSync6, readdirSync as readdirSync4, readFileSync as readFileSync10, statSync as statSync6 } from "fs";
 import { createRequire } from "module";
-import path54 from "path";
+import path55 from "path";
 var PREFIX_NAMESPACES = {
   bg: ["color"],
   text: ["color", "text"],
@@ -7547,7 +7581,7 @@ function stylesheetFiles(dir) {
   }
   return entries.flatMap((entry) => {
     if (entry.startsWith(".") || entry === "node_modules") return [];
-    const entryPath = path54.join(dir, entry);
+    const entryPath = path55.join(dir, entry);
     let stats;
     try {
       stats = statSync6(entryPath);
@@ -7555,7 +7589,7 @@ function stylesheetFiles(dir) {
       return [];
     }
     if (stats.isDirectory()) return stylesheetFiles(entryPath);
-    return path54.extname(entry) === ".css" ? [entryPath] : [];
+    return path55.extname(entry) === ".css" ? [entryPath] : [];
   });
 }
 function packageNameOf(specifier) {
@@ -7566,10 +7600,10 @@ function packageNameOf(specifier) {
 function resolvePackageStylesheet(fromFile, specifier) {
   const packageName = packageNameOf(specifier);
   if (!packageName || packageName === "tailwindcss") return void 0;
-  let directory = path54.dirname(fromFile);
-  while (directory !== path54.dirname(directory)) {
-    const packageRoot = path54.join(directory, "node_modules", packageName);
-    const manifestPath = path54.join(packageRoot, "package.json");
+  let directory = path55.dirname(fromFile);
+  while (directory !== path55.dirname(directory)) {
+    const packageRoot = path55.join(directory, "node_modules", packageName);
+    const manifestPath = path55.join(packageRoot, "package.json");
     if (existsSync6(manifestPath)) {
       try {
         const manifest = readFileSync10(manifestPath, "utf8");
@@ -7577,13 +7611,13 @@ function resolvePackageStylesheet(fromFile, specifier) {
         const main = /"main"\s*:\s*"(?<file>[^"]+\.css)"/.exec(manifest)?.groups?.file;
         const target = stylesheet ?? main;
         if (!target) return void 0;
-        const resolved = path54.resolve(packageRoot, target);
+        const resolved = path55.resolve(packageRoot, target);
         return existsSync6(resolved) ? resolved : void 0;
       } catch {
         return void 0;
       }
     }
-    directory = path54.dirname(directory);
+    directory = path55.dirname(directory);
   }
   return void 0;
 }
@@ -7834,7 +7868,7 @@ var unknownUtilityRule = {
 };
 
 // eslint/rules/util-file-name.ts
-import path55 from "path";
+import path56 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();
 }
@@ -7847,7 +7881,7 @@ var utilFileNameRule = {
     }
   },
   create(context) {
-    const filename = path55.resolve(context.filename);
+    const filename = path56.resolve(context.filename);
     const segments = filename.replace(/\\/g, "/").split("/");
     if (!segments.includes("utils")) return {};
     let module;
@@ -7861,13 +7895,13 @@ var utilFileNameRule = {
     const functionName = functions[0]?.name;
     if (!functionName) return {};
     const expected = toKebabCase2(functionName);
-    const actual = path55.basename(filename, path55.extname(filename));
+    const actual = path56.basename(filename, path56.extname(filename));
     if (!expected || actual === expected) return {};
     return {
       Program(node) {
         context.report({
           node,
-          message: `A utility file exporting ${functionName} must be named ${expected}.${path55.extname(filename).slice(1)}.`
+          message: `A utility file exporting ${functionName} must be named ${expected}.${path56.extname(filename).slice(1)}.`
         });
       }
     };
@@ -7875,7 +7909,7 @@ var utilFileNameRule = {
 };
 
 // eslint/rules/value-extraction.ts
-import path56 from "path";
+import path57 from "path";
 var valueExtractionRule = {
   meta: {
     schema: [],
@@ -7886,7 +7920,7 @@ var valueExtractionRule = {
   },
   create(context) {
     const sourceRoot = sourceRootOf(context);
-    const file = path56.resolve(context.filename);
+    const file = path57.resolve(context.filename);
     const segments = segmentsOf(file, sourceRoot);
     if (segments.length === 0 || segments[0] !== "app") return {};
     const index = getProjectIndex(sourceRoot);
@@ -7908,7 +7942,7 @@ var valueExtractionRule = {
 
 // eslint/rules/vulyk/tracked-docs.ts
 import { existsSync as existsSync7, readFileSync as readFileSync11 } from "fs";
-import path57 from "path";
+import path58 from "path";
 var PASIKA_REPO = "Bredansky/pasika";
 var BASE_REQUIRED_TRACKED_DOCS = [
   { name: "documentation-guide", path: "docs/documentation-guide" },
@@ -7941,8 +7975,8 @@ var trackedDocsRule = {
         if (!context.filename.endsWith("package.json")) return;
         const root = node.body;
         if (root.type !== "Object") return;
-        const projectRoot = path57.dirname(path57.resolve(context.filename));
-        const configPath = path57.join(projectRoot, "vulyk.config.ts");
+        const projectRoot = path58.dirname(path58.resolve(context.filename));
+        const configPath = path58.join(projectRoot, "vulyk.config.ts");
         if (!existsSync7(configPath)) {
           context.report({
             node,
@@ -7967,7 +8001,7 @@ var trackedDocsRule = {
             });
           }
         }
-        const agentsPath = path57.join(projectRoot, "AGENTS.md");
+        const agentsPath = path58.join(projectRoot, "AGENTS.md");
         if (!existsSync7(agentsPath)) {
           context.report({
             node,
@@ -8067,7 +8101,7 @@ var withResponseHelperRule = {
 
 // eslint/rules/zirka-baseline.ts
 import fs6 from "fs";
-import path58 from "path";
+import path59 from "path";
 var ESLINT_CONFIG = /^eslint\.config\.(?:ts|mts|cts|js|mjs|cjs)$/;
 var PRETTIER_CONFIGS = [
   "prettier.config.mjs",
@@ -8086,10 +8120,10 @@ var zirkaBaselineRule = {
     }
   },
   create(context) {
-    const filename = path58.resolve(context.filename);
-    const basename = path58.basename(filename);
+    const filename = path59.resolve(context.filename);
+    const basename = path59.basename(filename);
     if (!ESLINT_CONFIG.test(basename)) return {};
-    const projectRoot = path58.dirname(filename);
+    const projectRoot = path59.dirname(filename);
     const report3 = (message) => {
       context.report({
         node: context.sourceCode.ast,
@@ -8104,7 +8138,7 @@ var zirkaBaselineRule = {
             'ESLint config must take its configuration from zirka (import { styleguide } from "zirka") instead of restating rules locally.'
           );
         }
-        const tsconfigPath = path58.join(projectRoot, "tsconfig.json");
+        const tsconfigPath = path59.join(projectRoot, "tsconfig.json");
         if (!fs6.existsSync(tsconfigPath)) {
           report3('No tsconfig.json found. Create one extending the zirka TypeScript base config ("zirka/typescript").');
         } else {
@@ -8122,13 +8156,13 @@ var zirkaBaselineRule = {
             report3('tsconfig.json must extend the zirka TypeScript base config ("zirka/typescript").');
           }
         }
-        const prettierConfigFile = PRETTIER_CONFIGS.find((name) => fs6.existsSync(path58.join(projectRoot, name)));
+        const prettierConfigFile = PRETTIER_CONFIGS.find((name) => fs6.existsSync(path59.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 = fs6.readFileSync(path58.join(projectRoot, prettierConfigFile), "utf8");
+          const content = fs6.readFileSync(path59.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."
@@ -8339,6 +8373,7 @@ var pasikaNextjsAppRules = {
   "value-extraction": valueExtractionRule,
   "constant-casing": constantCasingRule,
   "prefer-enum": preferEnumRule,
+  "enum-placement": enumPlacementRule,
   "type-extraction": typeExtractionRule,
   "zod-schema-validation": zodSchemaValidationRule,
   "schema-casing": schemaCasingRule,

package/package.json

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