pasika 0.7.7 → 0.8.1

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

@@ -199,11 +199,14 @@ declare const pasikaPlugin: {
         "enforce-barrel-exports": eslint.Rule.RuleModule;
         "config-extraction": eslint.Rule.RuleModule;
         "value-extraction": eslint.Rule.RuleModule;
+        "constant-casing": eslint.Rule.RuleModule;
         "type-extraction": eslint.Rule.RuleModule;
         "zod-schema-validation": eslint.Rule.RuleModule;
+        "schema-casing": eslint.Rule.RuleModule;
         "source-under-src": eslint.Rule.RuleModule;
         "zirka-baseline": eslint.Rule.RuleModule;
         "component-placement": eslint.Rule.RuleModule;
+        "component-casing": eslint.Rule.RuleModule;
         "application-structure": eslint.Rule.RuleModule;
         "data-testid-case": eslint.Rule.RuleModule;
         "jsx-hygiene": eslint.Rule.RuleModule;

package/dist/eslint/pasika/index.js

@@ -137,6 +137,30 @@ function parseComponentInfo(text, filename, options) {
   }
   return components;
 }
+function findJsxReturningDeclarations(text, filename) {
+  const sourceFile = ts.createSourceFile(path.resolve(filename), text, ts.ScriptTarget.Latest, true, ts.ScriptKind.TSX);
+  const results = [];
+  const record = (identifier, body) => {
+    if (isHookCallName(identifier.text) || !containsJsx(body)) return;
+    const { line, character } = sourceFile.getLineAndCharacterOfPosition(identifier.getStart(sourceFile));
+    results.push({ name: identifier.text, line: line + 1, column: character });
+  };
+  for (const statement of sourceFile.statements) {
+    if (ts.isFunctionDeclaration(statement) && statement.name) {
+      record(statement.name, statement);
+      continue;
+    }
+    if (ts.isVariableStatement(statement)) {
+      for (const declaration of statement.declarationList.declarations) {
+        if (!ts.isIdentifier(declaration.name)) continue;
+        const initializer = declaration.initializer;
+        if (!initializer || !ts.isArrowFunction(initializer) && !ts.isFunctionExpression(initializer)) continue;
+        record(declaration.name, initializer);
+      }
+    }
+  }
+  return results;
+}
 function jsxTagName(element) {
   const tagName2 = ts.isJsxElement(element) ? element.openingElement.tagName : element.tagName;
   return ts.isIdentifier(tagName2) ? tagName2.text : void 0;
@@ -2108,8 +2132,46 @@ var supportFolderShapeRule = {
   }
 };
 
-// eslint/rules/import-through-index.ts
+// eslint/rules/constant-casing.ts
 import path17 from "path";
+var NEXTJS_ROUTE_HANDLER_NAMES = /* @__PURE__ */ new Set(["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]);
+function isScreamingSnakeCase(name) {
+  return /^[A-Z][A-Z0-9]*(?:_[A-Z0-9]+)*$/.test(name);
+}
+var constantCasingRule = {
+  meta: {
+    schema: [],
+    type: "problem",
+    docs: {
+      description: "Require a module-level constant to be camelCase, unless a framework requires a specific name."
+    }
+  },
+  create(context) {
+    const filename = path17.resolve(context.filename);
+    const sourceRoot = sourceRootOf(context);
+    if (!filename.startsWith(sourceRoot + path17.sep)) return {};
+    return {
+      VariableDeclarator(node) {
+        if (node.id.type !== "Identifier") return;
+        const declaration = node.parent;
+        if (declaration.type !== "VariableDeclaration" || declaration.kind !== "const") return;
+        const container = declaration.parent;
+        const isModuleLevel = container.type === "Program" || container.type === "ExportNamedDeclaration" && container.parent.type === "Program";
+        if (!isModuleLevel) return;
+        const { name } = node.id;
+        if (!isScreamingSnakeCase(name)) return;
+        if (NEXTJS_ROUTE_HANDLER_NAMES.has(name)) return;
+        context.report({
+          node,
+          message: `${name} must be camelCase, unless a framework requires this exact name. See docs/next-codebase-guide/rules/constants-rule.md`
+        });
+      }
+    };
+  }
+};
+
+// eslint/rules/import-through-index.ts
+import path18 from "path";
 var importThroughIndexRule = {
   meta: {
     schema: [],
@@ -2119,7 +2181,7 @@ var importThroughIndexRule = {
     }
   },
   create(context) {
-    const filename = path17.resolve(context.filename);
+    const filename = path18.resolve(context.filename);
     const sourceRoot = sourceRootOf2(context, filename);
     return {
       Program(node) {
@@ -2131,7 +2193,7 @@ var importThroughIndexRule = {
             (segment) => ["constants", "types", "schemas"].includes(segment)
           );
           const supportFolder = supportFolderIndex >= 0 ? targetSegments[supportFolderIndex] : void 0;
-          if (!supportFolder || path17.basename(target).startsWith("index.")) continue;
+          if (!supportFolder || path18.basename(target).startsWith("index.")) continue;
           const folderIndex = targetSegments.slice(0, supportFolderIndex + 1);
           const expected = `@/${folderIndex.join("/")}`;
           context.report({
@@ -2153,14 +2215,14 @@ function importSpecifiers(source) {
   return specifiers;
 }
 function sourceRootOf2(context, filename) {
-  const marker = `${path17.sep}src${path17.sep}`;
+  const marker = `${path18.sep}src${path18.sep}`;
   const srcIndex = filename.lastIndexOf(marker);
   if (srcIndex >= 0) return filename.slice(0, srcIndex + marker.length - 1);
-  return path17.resolve(context.cwd ?? process.cwd(), "src");
+  return path18.resolve(context.cwd ?? process.cwd(), "src");
 }
 
 // eslint/rules/util-file-name.ts
-import path18 from "path";
+import path19 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();
 }
@@ -2173,7 +2235,7 @@ var utilFileNameRule = {
     }
   },
   create(context) {
-    const filename = path18.resolve(context.filename);
+    const filename = path19.resolve(context.filename);
     const segments = filename.replace(/\\/g, "/").split("/");
     if (!segments.includes("utils")) return {};
     let module;
@@ -2187,13 +2249,13 @@ var utilFileNameRule = {
     const functionName = functions[0]?.name;
     if (!functionName) return {};
     const expected = toKebabCase2(functionName);
-    const actual = path18.basename(filename, path18.extname(filename));
+    const actual = path19.basename(filename, path19.extname(filename));
     if (!expected || actual === expected) return {};
     return {
       Program(node) {
         context.report({
           node,
-          message: `A utility file exporting ${functionName} must be named ${expected}.${path18.extname(filename).slice(1)}.`
+          message: `A utility file exporting ${functionName} must be named ${expected}.${path19.extname(filename).slice(1)}.`
         });
       }
     };
@@ -2201,7 +2263,7 @@ var utilFileNameRule = {
 };
 
 // eslint/rules/no-util-barrel.ts
-import path19 from "path";
+import path20 from "path";
 var noUtilBarrelRule = {
   meta: {
     schema: [],
@@ -2211,7 +2273,7 @@ var noUtilBarrelRule = {
     }
   },
   create(context) {
-    const filename = path19.resolve(context.filename);
+    const filename = path20.resolve(context.filename);
     const sourceRoot = sourceRootOf3(context, filename);
     return {
       Program(node) {
@@ -2220,7 +2282,7 @@ var noUtilBarrelRule = {
           if (!target) continue;
           const segments = target.replace(/\\/g, "/").split("/");
           const utilsIndex = segments.lastIndexOf("utils");
-          if (utilsIndex < 0 || !path19.basename(target).startsWith("index.")) continue;
+          if (utilsIndex < 0 || !path20.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`
@@ -2240,10 +2302,10 @@ function importSpecifiers2(source) {
   return specifiers;
 }
 function sourceRootOf3(context, filename) {
-  const marker = `${path19.sep}src${path19.sep}`;
+  const marker = `${path20.sep}src${path20.sep}`;
   const srcIndex = filename.lastIndexOf(marker);
   if (srcIndex >= 0) return filename.slice(0, srcIndex + marker.length - 1);
-  return path19.resolve(context.cwd ?? process.cwd(), "src");
+  return path20.resolve(context.cwd ?? process.cwd(), "src");
 }
 
 // eslint/rules/jsx-hygiene.ts
@@ -2336,7 +2398,7 @@ var jsxHygieneRule = {
 };
 
 // eslint/rules/interactive-component.ts
-import path20 from "path";
+import path21 from "path";
 var INTERACTIVE_TAGS = /* @__PURE__ */ new Set([
   "a",
   "button",
@@ -2491,8 +2553,8 @@ var interactiveComponentRule = {
   },
   create(context) {
     if (!context.filename.endsWith(".tsx") && !context.filename.endsWith(".jsx")) return {};
-    const filename = path20.resolve(context.filename);
-    const base = path20.basename(filename, path20.extname(filename));
+    const filename = path21.resolve(context.filename);
+    const base = path21.basename(filename, path21.extname(filename));
     if (NEXT_ROUTING_FILES3.has(base)) return {};
     return {
       JSXElement(node) {
@@ -2743,12 +2805,12 @@ var cvaBooleanVariantsRule = {
 };
 
 // eslint/rules/cross-feature-import.ts
-import path21 from "path";
+import path22 from "path";
 var FEATURES_SEGMENT = "features";
 function featureNameOf(resolvedPath, sourceRoot) {
-  const relative = path21.relative(sourceRoot, resolvedPath);
+  const relative = path22.relative(sourceRoot, resolvedPath);
   if (relative.startsWith("..")) return void 0;
-  const segments = relative.split(path21.sep);
+  const segments = relative.split(path22.sep);
   if (segments[0] !== FEATURES_SEGMENT || segments.length < 2) return void 0;
   return segments[1];
 }
@@ -2764,9 +2826,9 @@ var crossFeatureImportRule = {
     const filename = context.filename;
     if (!filename.endsWith(".tsx") && !filename.endsWith(".jsx")) return {};
     const sourceRoot = sourceRootOf(context);
-    const fileRelative = path21.relative(sourceRoot, filename);
+    const fileRelative = path22.relative(sourceRoot, filename);
     if (fileRelative.startsWith("..")) return {};
-    const fileSegments = fileRelative.split(path21.sep);
+    const fileSegments = fileRelative.split(path22.sep);
     const isInCompositions = fileSegments[0] === "compositions";
     const isInApp = fileSegments[0] === "app";
     const isConfig = fileSegments[0] === "config";
@@ -2780,9 +2842,9 @@ var crossFeatureImportRule = {
         if (typeof source.value !== "string") return;
         let resolved;
         if (source.value.startsWith("@/")) {
-          resolved = path21.resolve(sourceRoot, source.value.slice(2));
+          resolved = path22.resolve(sourceRoot, source.value.slice(2));
         } else if (source.value.startsWith(".")) {
-          resolved = path21.resolve(path21.dirname(filename), source.value);
+          resolved = path22.resolve(path22.dirname(filename), source.value);
         }
         if (!resolved) return;
         const feature = featureNameOf(resolved, sourceRoot);
@@ -2801,7 +2863,7 @@ var crossFeatureImportRule = {
 };
 
 // eslint/rules/pure-function-extract.ts
-import path22 from "path";
+import path23 from "path";
 function isComponentLikeName(name) {
   return /^[A-Z]/.test(name);
 }
@@ -2830,9 +2892,9 @@ var pureFunctionExtractRule = {
     const filename = context.filename;
     if (!filename.endsWith(".tsx") && !filename.endsWith(".jsx")) return {};
     const sourceRoot = sourceRootOf(context);
-    const relative = path22.relative(sourceRoot, filename);
+    const relative = path23.relative(sourceRoot, filename);
     if (relative.startsWith("..")) return {};
-    const segments = relative.split(path22.sep);
+    const segments = relative.split(path23.sep);
     if (segments[0] === "utils") return {};
     if (segments[0] === "app") return {};
     const supportFolders = /* @__PURE__ */ new Set(["hooks", "types", "schemas", "constants", "utils"]);
@@ -2872,7 +2934,7 @@ var pureFunctionExtractRule = {
 };
 
 // eslint/rules/hook-complexity.ts
-import path23 from "path";
+import path24 from "path";
 import ts4 from "typescript";
 var REACT_HOOKS = /* @__PURE__ */ new Set([
   "useState",
@@ -2925,9 +2987,9 @@ var hookComplexityRule = {
   create(context) {
     const filename = context.filename;
     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);
     const sourceText = context.sourceCode.text;
     function checkHook(node, name, body, exported) {
       if (!exported) return;
@@ -2969,9 +3031,9 @@ var hookComplexityRule = {
 };
 
 // eslint/rules/locale-dotted-path.ts
-import path24 from "path";
+import path25 from "path";
 function isInLocalesDir(filename) {
-  const segments = path24.resolve(filename).split(path24.sep);
+  const segments = path25.resolve(filename).split(path25.sep);
   const srcIdx = segments.lastIndexOf("src");
   return srcIdx !== -1 && segments[srcIdx + 1] === "locales";
 }
@@ -3020,16 +3082,22 @@ var localeDottedPathRule = {
 };
 
 // eslint/rules/locales-location.ts
-import path25 from "path";
+import path26 from "path";
 function isLocalesFile(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";
 }
+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: [],
@@ -3039,9 +3107,9 @@ var localesLocationRule = {
     }
   },
   create(context) {
-    if (isLocalesFile(context.filename)) return {};
+    if (isLocalesFile(context.filename) || isTestFile(context.filename)) return {};
     const filename = context.filename;
-    const segments = path25.resolve(filename).split(path25.sep);
+    const segments = path26.resolve(filename).split(path26.sep);
     const srcIdx = segments.lastIndexOf("src");
     if (srcIdx === -1) return {};
     const folder = segments[srcIdx + 1];
@@ -3049,8 +3117,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."
@@ -3063,7 +3133,7 @@ var localesLocationRule = {
 };
 
 // eslint/rules/hook-extraction.ts
-import path26 from "path";
+import path27 from "path";
 var hookExtractionRule = {
   meta: {
     schema: [],
@@ -3074,7 +3144,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);
@@ -3100,7 +3170,7 @@ var hookExtractionRule = {
 };
 
 // eslint/rules/value-extraction.ts
-import path27 from "path";
+import path28 from "path";
 var valueExtractionRule = {
   meta: {
     schema: [],
@@ -3111,7 +3181,7 @@ var valueExtractionRule = {
   },
   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 || segments[0] !== "app") return {};
     const index = getProjectIndex(sourceRoot);
@@ -3132,7 +3202,7 @@ var valueExtractionRule = {
 };
 
 // eslint/rules/config-extraction.ts
-import path28 from "path";
+import path29 from "path";
 var configExtractionRule = {
   meta: {
     schema: [],
@@ -3143,7 +3213,7 @@ var configExtractionRule = {
   },
   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 < 3 || segments[0] !== "config") return {};
     if (SUPPORT_FOLDERS2.has(segments[2] ?? "")) return {};
@@ -3181,7 +3251,7 @@ var configExtractionRule = {
 };
 
 // eslint/rules/component-nesting.ts
-import path29 from "path";
+import path30 from "path";
 var componentNestingRule = {
   meta: {
     schema: [],
@@ -3192,7 +3262,7 @@ var componentNestingRule = {
   },
   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 !== 4 || segments[0] !== "features") return {};
     const index = getProjectIndex(sourceRoot);
@@ -3225,7 +3295,7 @@ var componentNestingRule = {
 };
 
 // eslint/rules/stay-flat.ts
-import path30 from "path";
+import path31 from "path";
 var stayFlatRule = {
   meta: {
     schema: [],
@@ -3236,7 +3306,7 @@ var stayFlatRule = {
   },
   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 !== 3 || segments[0] !== "features") return {};
     const index = getProjectIndex(sourceRoot);
@@ -3276,7 +3346,7 @@ var stayFlatRule = {
 };
 
 // eslint/rules/type-extraction.ts
-import path31 from "path";
+import path32 from "path";
 var typeExtractionRule = {
   meta: {
     schema: [],
@@ -3287,7 +3357,7 @@ var typeExtractionRule = {
   },
   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 === 0) return {};
     const index = getProjectIndex(sourceRoot);
@@ -3333,7 +3403,7 @@ var typeExtractionRule = {
 };
 
 // eslint/rules/locale-placement.ts
-import path32 from "path";
+import path33 from "path";
 import { readFileSync as readFileSync4 } from "fs";
 import ts5 from "typescript";
 var LOCALE_ACCESS = /\blocales\.(?<key>[A-Za-z_$][\w$]*)/g;
@@ -3381,7 +3451,7 @@ var localePlacementRule = {
   },
   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);
@@ -3459,7 +3529,7 @@ var localePlacementRule = {
 };
 
 // eslint/rules/sole-state-owner.ts
-import path33 from "path";
+import path34 from "path";
 import ts6 from "typescript";
 function findStateHooks(node) {
   const hooks = [];
@@ -3539,7 +3609,7 @@ var soleStateOwnerRule = {
     }
   },
   create(context) {
-    const filename = path33.resolve(context.filename);
+    const filename = path34.resolve(context.filename);
     if (!filename.endsWith(".tsx") && !filename.endsWith(".jsx")) return {};
     const text = context.sourceCode.text;
     const components = parseComponentInfo(text, filename);
@@ -3618,7 +3688,7 @@ function usesOutsideJsx(declaration, hook, children) {
 }
 
 // eslint/rules/locale-key-shape.ts
-import path34 from "path";
+import path35 from "path";
 var MAX_KEY_LENGTH = 30;
 var ROLE_POSTFIXES = /* @__PURE__ */ new Set([
   "Button",
@@ -3668,7 +3738,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 = path34.resolve(filename).split(path34.sep);
+  const segments = path35.resolve(filename).split(path35.sep);
   const srcIdx = segments.lastIndexOf("src");
   return srcIdx !== -1 && segments[srcIdx + 1] === "locales";
 }
@@ -3739,7 +3809,7 @@ var localeKeyShapeRule = {
 };
 
 // eslint/rules/shared-style-dedup.ts
-import path35 from "path";
+import path36 from "path";
 import { readFileSync as readFileSync5, statSync as statSync3 } from "fs";
 var CLASS_NAME = /className="(?<classes>[^"]+)"/g;
 var comboCache;
@@ -3777,7 +3847,7 @@ var sharedStyleDedupRule = {
   },
   create(context) {
     const sourceRoot = sourceRootOf(context);
-    const file = path35.resolve(context.filename);
+    const file = path36.resolve(context.filename);
     const segments = segmentsOf(file, sourceRoot);
     if (segments.length === 0) return {};
     const index = getProjectIndex(sourceRoot);
@@ -3980,8 +4050,103 @@ var zodSchemaValidationRule = {
   }
 };
 
+// eslint/rules/schema-casing.ts
+import path37 from "path";
+function isCamelCase(name) {
+  return /^[a-z][a-zA-Z0-9]*$/.test(name);
+}
+function rootIdentifierName(node) {
+  let current = node;
+  for (; ; ) {
+    if (current.type === "Identifier") return current.name;
+    if (current.type === "CallExpression") {
+      current = current.callee;
+      continue;
+    }
+    if (current.type === "MemberExpression") {
+      current = current.object;
+      continue;
+    }
+    return void 0;
+  }
+}
+var schemaCasingRule = {
+  meta: {
+    schema: [],
+    type: "problem",
+    docs: {
+      description: "Require a Zod schema constant to be named in camelCase."
+    }
+  },
+  create(context) {
+    const filename = path37.resolve(context.filename);
+    const sourceRoot = sourceRootOf(context);
+    if (!filename.startsWith(sourceRoot + path37.sep)) return {};
+    let zodLocalName;
+    return {
+      ImportDeclaration(node) {
+        if (node.source.value !== "zod") return;
+        for (const specifier of node.specifiers) {
+          if (specifier.type === "ImportSpecifier" && specifier.imported.type === "Identifier" && specifier.imported.name === "z") {
+            zodLocalName = specifier.local.name;
+          }
+        }
+      },
+      VariableDeclarator(node) {
+        if (!zodLocalName) return;
+        if (node.id.type !== "Identifier") return;
+        const declaration = node.parent;
+        if (declaration.type !== "VariableDeclaration" || declaration.kind !== "const") return;
+        const container = declaration.parent;
+        const isModuleLevel = container.type === "Program" || container.type === "ExportNamedDeclaration" && container.parent.type === "Program";
+        if (!isModuleLevel) return;
+        if (!node.init || rootIdentifierName(node.init) !== zodLocalName) return;
+        const { name } = node.id;
+        if (isCamelCase(name)) return;
+        context.report({
+          node,
+          message: `${name} must be camelCase. See docs/next-codebase-guide/rules/types-and-schemas-rule.md`
+        });
+      }
+    };
+  }
+};
+
+// eslint/rules/component-casing.ts
+import path38 from "path";
+function isPascalCase6(name) {
+  return /^[A-Z][A-Za-z0-9]*$/.test(name);
+}
+var componentCasingRule = {
+  meta: {
+    schema: [],
+    type: "problem",
+    docs: {
+      description: "Require a JSX-returning function or const to be named in PascalCase."
+    }
+  },
+  create(context) {
+    const filename = path38.resolve(context.filename);
+    const sourceRoot = sourceRootOf(context);
+    if (!filename.startsWith(sourceRoot + path38.sep)) return {};
+    if (path38.extname(filename) !== ".tsx") return {};
+    return {
+      Program(node) {
+        for (const declaration of findJsxReturningDeclarations(context.sourceCode.text, filename)) {
+          if (isPascalCase6(declaration.name)) continue;
+          context.report({
+            node,
+            loc: { line: declaration.line, column: declaration.column },
+            message: `${declaration.name} must be PascalCase; only a PascalCase name resolves as a JSX component. See docs/next-codebase-guide/rules/smart-vs-dumb-component-rule.md`
+          });
+        }
+      }
+    };
+  }
+};
+
 // eslint/rules/source-under-src.ts
-import path36 from "path";
+import path39 from "path";
 var NON_SOURCE_ROOT_DIRS = /* @__PURE__ */ new Set([
   ".agents",
   ".cache",
@@ -4022,14 +4187,14 @@ var sourceUnderSrcRule = {
     }
   },
   create(context) {
-    const filename = path36.resolve(context.filename);
+    const filename = path39.resolve(context.filename);
     if (!MODULE_EXTENSION.test(filename)) return {};
-    const relative = path36.relative(context.cwd, filename).replace(/\\/g, "/");
+    const relative = path39.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 = path36.basename(filename);
+      const basename = path39.basename(filename);
       if (CONFIG_FILE.test(basename) || DECLARATION_FILE.test(basename) || basename.startsWith(".")) return {};
     }
     return {
@@ -4046,7 +4211,7 @@ var sourceUnderSrcRule = {
 
 // eslint/rules/zirka-baseline.ts
 import fs5 from "fs";
-import path37 from "path";
+import path40 from "path";
 var ESLINT_CONFIG = /^eslint\.config\.(?:ts|mts|cts|js|mjs|cjs)$/;
 var PRETTIER_CONFIGS = [
   "prettier.config.mjs",
@@ -4065,10 +4230,10 @@ var zirkaBaselineRule = {
     }
   },
   create(context) {
-    const filename = path37.resolve(context.filename);
-    const basename = path37.basename(filename);
+    const filename = path40.resolve(context.filename);
+    const basename = path40.basename(filename);
     if (!ESLINT_CONFIG.test(basename)) return {};
-    const projectRoot = path37.dirname(filename);
+    const projectRoot = path40.dirname(filename);
     const report3 = (message) => {
       context.report({
         node: context.sourceCode.ast,
@@ -4083,7 +4248,7 @@ var zirkaBaselineRule = {
             'ESLint config must take its configuration from zirka (import { styleguide } from "zirka") instead of restating rules locally.'
           );
         }
-        const tsconfigPath = path37.join(projectRoot, "tsconfig.json");
+        const tsconfigPath = path40.join(projectRoot, "tsconfig.json");
         if (!fs5.existsSync(tsconfigPath)) {
           report3('No tsconfig.json found. Create one extending the zirka TypeScript base config ("zirka/typescript").');
         } else {
@@ -4101,13 +4266,13 @@ var zirkaBaselineRule = {
             report3('tsconfig.json must extend the zirka TypeScript base config ("zirka/typescript").');
           }
         }
-        const prettierConfigFile = PRETTIER_CONFIGS.find((name) => fs5.existsSync(path37.join(projectRoot, name)));
+        const prettierConfigFile = PRETTIER_CONFIGS.find((name) => fs5.existsSync(path40.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(path37.join(projectRoot, prettierConfigFile), "utf8");
+          const content = fs5.readFileSync(path40.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."
@@ -4177,7 +4342,7 @@ var docKindSuffixRule = {
 };
 
 // eslint/rules/documentation/title-matches-file-name.ts
-import path38 from "path";
+import path41 from "path";
 function toExpectedFileName(title) {
   return `${title.toLowerCase().replaceAll(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "")}.md`;
 }
@@ -4197,7 +4362,7 @@ var titleMatchesFileNameRule = {
         if (!filename.endsWith(".md")) return;
         const title = getTextContent(node).trim();
         const expectedFileName = toExpectedFileName(title);
-        const actualFileName = path38.basename(filename);
+        const actualFileName = path41.basename(filename);
         if (!title) {
           context.report({
             node,
@@ -4640,20 +4805,20 @@ var referenceBlockHeadingsRule = {
 
 // eslint/rules/documentation/support-document-placement.ts
 import { existsSync as existsSync2 } from "fs";
-import path39 from "path";
+import path42 from "path";
 function checkPlacement(filename, kind) {
-  const parentFolder = path39.basename(path39.dirname(filename));
+  const parentFolder = path42.basename(path42.dirname(filename));
   const expectedParent = `${kind}s`;
   if (parentFolder !== expectedParent) {
     return `${kind} lives in "${parentFolder}/" instead of "${expectedParent}/"`;
   }
-  const guideFolderPath = path39.dirname(path39.dirname(filename));
-  const guideFolder = path39.basename(guideFolderPath);
+  const guideFolderPath = path42.dirname(path42.dirname(filename));
+  const guideFolder = path42.basename(guideFolderPath);
   if (!guideFolder.endsWith("-guide")) {
     return `${kind} owner folder "${guideFolder}/" does not use the "*-guide/" suffix`;
   }
   const entryPoint = `${guideFolder}.md`;
-  if (!existsSync2(path39.join(guideFolderPath, entryPoint))) {
+  if (!existsSync2(path42.join(guideFolderPath, entryPoint))) {
     return `${kind} owner folder "${guideFolder}/" has no "${entryPoint}" entry point`;
   }
   return void 0;
@@ -4712,11 +4877,11 @@ var noTemplatePromptRule = {
 };
 
 // eslint/rules/documentation/guide-folder-entry-point.ts
-import path41 from "path";
+import path44 from "path";
 
 // eslint/rules/documentation/project-index.ts
 import { readdirSync as readdirSync3, readFileSync as readFileSync6, statSync as statSync4 } from "fs";
-import path40 from "path";
+import path43 from "path";
 var KIND_BY_SUFFIX = [
   ["-rule.md", "rule"],
   ["-guide.md", "guide"],
@@ -4725,7 +4890,7 @@ var KIND_BY_SUFFIX = [
 ];
 function listMarkdownFiles(dir) {
   return readdirSync3(dir).flatMap((entry) => {
-    const entryPath = path40.join(dir, entry);
+    const entryPath = path43.join(dir, entry);
     if (statSync4(entryPath).isDirectory()) {
       return entry.startsWith("_") ? [] : listMarkdownFiles(entryPath);
     }
@@ -4743,11 +4908,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 = path40.basename(filePath);
+    const fileName = path43.basename(filePath);
     const kind = KIND_BY_SUFFIX.find(([suffix]) => fileName.endsWith(suffix))?.[1];
     return {
       filePath,
-      doc: path40.relative(docsRoot, filePath).split(path40.sep).join("/"),
+      doc: path43.relative(docsRoot, filePath).split(path43.sep).join("/"),
       fileName,
       kind,
       title: extractTitle(filePath)
@@ -4757,12 +4922,12 @@ function getProjectDocs(docsRoot) {
   return docs;
 }
 function findDocsRoot(filePath) {
-  let dir = path40.dirname(filePath);
+  let dir = path43.dirname(filePath);
   for (; ; ) {
-    if (path40.basename(dir) === "docs" && statSync4(dir).isDirectory()) {
+    if (path43.basename(dir) === "docs" && statSync4(dir).isDirectory()) {
       return dir;
     }
-    const parent = path40.dirname(dir);
+    const parent = path43.dirname(dir);
     if (parent === dir) return void 0;
     dir = parent;
   }
@@ -4786,13 +4951,13 @@ var guideFolderEntryPointRule = {
         if (!docsRoot) return;
         const docs = getProjectDocs(docsRoot);
         const guideFolders = new Set(
-          docs.filter((doc) => ["rules", "references"].includes(path41.basename(path41.dirname(doc.filePath)))).map((doc) => path41.dirname(path41.dirname(doc.filePath))).filter((folder) => path41.resolve(folder) !== path41.resolve(docsRoot))
+          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))
         );
-        const currentDir = path41.dirname(filename);
+        const currentDir = path44.dirname(filename);
         if (guideFolders.has(currentDir)) {
-          const expectedEntryPoint = `${path41.basename(currentDir)}.md`;
+          const expectedEntryPoint = `${path44.basename(currentDir)}.md`;
           const hasEntryPoint = docs.some(
-            (doc) => doc.kind === "guide" && path41.dirname(doc.filePath) === currentDir && doc.fileName === expectedEntryPoint
+            (doc) => doc.kind === "guide" && path44.dirname(doc.filePath) === currentDir && doc.fileName === expectedEntryPoint
           );
           if (!hasEntryPoint) {
             context.report({
@@ -5017,7 +5182,7 @@ var noNestedHowToRule = {
 
 // eslint/rules/documentation/glossary-term-linking.ts
 import { readFileSync as readFileSync7 } from "fs";
-import path42 from "path";
+import path45 from "path";
 function extractGlossaryTerms(filePath) {
   const content = readFileSync7(filePath, "utf8");
   const terms = [];
@@ -5071,9 +5236,9 @@ var glossaryTermLinkingRule = {
         const docsRoot = findDocsRoot(filename);
         if (!docsRoot) return;
         const docs = getProjectDocs(docsRoot);
-        const guideDir = path42.dirname(filename);
+        const guideDir = path45.dirname(filename);
         const guideReferences = docs.filter(
-          (doc) => doc.kind === "reference" && path42.dirname(doc.filePath) === guideDir
+          (doc) => doc.kind === "reference" && path45.dirname(doc.filePath) === guideDir
         );
         if (guideReferences.length === 0) return;
         const glossaryTerms = [];
@@ -5098,7 +5263,7 @@ var glossaryTermLinkingRule = {
 
 // eslint/rules/documentation/guide-mentions-documents.ts
 import { existsSync as existsSync3 } from "fs";
-import path43 from "path";
+import path46 from "path";
 function visitSteps3(node, check) {
   if (node.type === "list" && node.ordered) {
     for (const child of node.children) check(child);
@@ -5131,12 +5296,12 @@ var guideMentionsDocumentsRule = {
         if (!filename.endsWith("-guide.md")) return;
         const docsRoot = findDocsRoot(filename);
         if (!docsRoot) return;
-        const guideDir = path43.dirname(filename);
-        if (path43.basename(filename, ".md") !== path43.basename(guideDir)) return;
+        const guideDir = path46.dirname(filename);
+        if (path46.basename(filename, ".md") !== path46.basename(guideDir)) return;
         const docs = getProjectDocs(docsRoot);
         const owned = docs.filter((doc) => {
-          const parent = path43.dirname(doc.filePath);
-          return parent === path43.join(guideDir, "rules") || parent === path43.join(guideDir, "references");
+          const parent = path46.dirname(doc.filePath);
+          return parent === path46.join(guideDir, "rules") || parent === path46.join(guideDir, "references");
         });
         const allLinks = [];
         collectMarkdownLinks(node, allLinks);
@@ -5163,7 +5328,7 @@ var guideMentionsDocumentsRule = {
         for (const link of allLinks) {
           const target = linkTarget(link.url);
           if (!target.endsWith(".md")) continue;
-          const resolved = path43.normalize(path43.join(guideDir, target));
+          const resolved = path46.normalize(path46.join(guideDir, target));
           if (!existsSync3(resolved)) {
             context.report({
               node: link,
@@ -5713,11 +5878,11 @@ var themeVariableNamespaceRule = {
 
 // eslint/rules/tailwind/css-entry-point.ts
 import { statSync as statSync6 } from "fs";
-import path46 from "path";
+import path49 from "path";
 
 // eslint/rules/tailwind/source-files.ts
 import { readdirSync as readdirSync4, readFileSync as readFileSync8, statSync as statSync5 } from "fs";
-import path44 from "path";
+import path47 from "path";
 var CSS_EXTENSIONS = [".css"];
 var MODULE_EXTENSIONS3 = [".ts", ".tsx", ".mts", ".cts", ".js", ".jsx", ".mjs", ".cjs"];
 var SOURCE_EXTENSIONS = [...MODULE_EXTENSIONS3, ...CSS_EXTENSIONS];
@@ -5730,7 +5895,7 @@ function findFiles(dir, extensions) {
   }
   return entries.flatMap((entry) => {
     if (entry.startsWith(".") || entry === "node_modules") return [];
-    const entryPath = path44.join(dir, entry);
+    const entryPath = path47.join(dir, entry);
     let stats;
     try {
       stats = statSync5(entryPath);
@@ -5738,7 +5903,7 @@ function findFiles(dir, extensions) {
       return [];
     }
     if (stats.isDirectory()) return findFiles(entryPath, extensions);
-    return extensions.includes(path44.extname(entry)) ? [entryPath] : [];
+    return extensions.includes(path47.extname(entry)) ? [entryPath] : [];
   });
 }
 function cachedTextReader() {
@@ -5761,7 +5926,7 @@ function escapeRegExp(text) {
 }
 
 // eslint/rules/tailwind/stylesheet-graph.ts
-import path45 from "path";
+import path48 from "path";
 function registersTailwind(text) {
   return /@import\s+(?:url\(\s*)?["']tailwindcss["']\s*\)?/i.test(text);
 }
@@ -5775,25 +5940,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 path45.resolve(spec);
-  if (spec.startsWith("./") || spec.startsWith("../")) return path45.resolve(path45.dirname(fromFile), spec);
-  if (spec.startsWith("@/")) return path45.resolve(sourceRoot, spec.slice(2));
+  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));
   return void 0;
 }
 function buildStylesheetGraph(options) {
   const { cssFiles, sourceRoot, textOf } = options;
-  const cssSet = new Set(cssFiles.map((file) => path45.normalize(file)));
+  const cssSet = new Set(cssFiles.map((file) => path48.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(path45.normalize(global));
+  for (const global of globals) reachable.add(path48.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 = path45.normalize(target);
+      const normalized = path48.normalize(target);
       if (cssSet.has(normalized) && !reachable.has(normalized)) {
         reachable.add(normalized);
         queue.push(normalized);
@@ -5805,7 +5970,7 @@ function buildStylesheetGraph(options) {
     for (const spec of importedSpecifiers(textOf(global))) {
       const target = resolveSpecifier2(global, spec, sourceRoot);
       if (!target) continue;
-      const normalized = path45.normalize(target);
+      const normalized = path48.normalize(target);
       if (cssSet.has(normalized)) directChildren.add(normalized);
     }
   }
@@ -5838,7 +6003,7 @@ var cssEntryPointRule = {
     return {
       "StyleSheet:exit"(node) {
         if (globals.length === 0) return;
-        const current = path46.normalize(path46.resolve(context.filename));
+        const current = path49.normalize(path49.resolve(context.filename));
         if (globals.includes(current)) {
           if (globals.length > 1) {
             context.report({
@@ -5847,7 +6012,7 @@ var cssEntryPointRule = {
             });
             return;
           }
-          const basename = path46.basename(current);
+          const basename = path49.basename(current);
           const importCount = moduleFiles.filter((modulePath) => moduleImports(textOf(modulePath), basename)).length;
           if (importCount !== 1) {
             context.report({
@@ -6176,7 +6341,7 @@ var nextjsStackRule = {
 
 // eslint/rules/package-json/vitest-coverage.ts
 import { existsSync as existsSync4, readFileSync as readFileSync9 } from "fs";
-import path47 from "path";
+import path50 from "path";
 function memberName4(member) {
   return member.name.type === "String" ? member.name.value : member.name.name;
 }
@@ -6245,7 +6410,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(path47.join(context.cwd, name)));
+        const configName = VITEST_CONFIG_NAMES.find((name) => existsSync4(path50.join(context.cwd, name)));
         if (!configName) {
           context.report({
             node,
@@ -6253,7 +6418,7 @@ var vitestCoverageRule = {
           });
           return;
         }
-        const content = readFileSync9(path47.join(context.cwd, configName), "utf8");
+        const content = readFileSync9(path50.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}.` });
@@ -6300,7 +6465,7 @@ var nextjsPackageJsonRules = {
 
 // eslint/rules/husky/husky-hook.ts
 import { existsSync as existsSync5, readFileSync as readFileSync10 } from "fs";
-import path48 from "path";
+import path51 from "path";
 var VITEST_CONFIG_NAMES2 = [
   "vitest.config.ts",
   "vitest.config.mts",
@@ -6326,7 +6491,7 @@ var huskyHookRule = {
         const root = node.body;
         if (root.type !== "Object") return;
         if (!context.filename.endsWith("package.json")) return;
-        const hookPath = path48.join(context.cwd, ".husky", "pre-commit");
+        const hookPath = path51.join(context.cwd, ".husky", "pre-commit");
         if (!existsSync5(hookPath)) {
           context.report({
             node,
@@ -6350,7 +6515,7 @@ var huskyHookRule = {
         }
         requireNamedScript("typecheck");
         requireNamedScript("test:unit:coverage");
-        const vitestConfigName = VITEST_CONFIG_NAMES2.find((name) => existsSync5(path48.join(context.cwd, name)));
+        const vitestConfigName = VITEST_CONFIG_NAMES2.find((name) => existsSync5(path51.join(context.cwd, name)));
         if (vitestConfigName !== void 0) {
           const coverageIndex = content.indexOf("npm run test:unit:coverage");
           const localAddIndex = content.indexOf(`git add ${vitestConfigName}`);
@@ -6364,7 +6529,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 = path48.join(context.cwd, "eslint-suppressions.json");
+        const suppressionsPath = path51.join(context.cwd, "eslint-suppressions.json");
         if (existsSync5(suppressionsPath)) {
           requireNamedScript("lint:prune");
           const pruneIndex = content.indexOf("npm run lint:prune");
@@ -6437,7 +6602,7 @@ var vulykDependencyRule = {
 
 // eslint/rules/vulyk/vulyk-docs.ts
 import { existsSync as existsSync6, readFileSync as readFileSync11 } from "fs";
-import path49 from "path";
+import path52 from "path";
 var PASIKA_REPO = "Bredansky/pasika";
 var BASE_REQUIRED_DOCS = [
   { name: "documentation-guide", path: "docs/documentation-guide" },
@@ -6470,8 +6635,8 @@ var vulykDocsRule = {
         if (!context.filename.endsWith("package.json")) return;
         const root = node.body;
         if (root.type !== "Object") return;
-        const projectRoot = path49.dirname(path49.resolve(context.filename));
-        const configPath = path49.join(projectRoot, "vulyk.config.ts");
+        const projectRoot = path52.dirname(path52.resolve(context.filename));
+        const configPath = path52.join(projectRoot, "vulyk.config.ts");
         if (!existsSync6(configPath)) {
           context.report({
             node,
@@ -6496,7 +6661,7 @@ var vulykDocsRule = {
             });
           }
         }
-        const agentsPath = path49.join(projectRoot, "AGENTS.md");
+        const agentsPath = path52.join(projectRoot, "AGENTS.md");
         if (!existsSync6(agentsPath)) {
           context.report({
             node,
@@ -6528,12 +6693,15 @@ var pasikaNextjsAppRules = {
   "enforce-barrel-exports": enforceBarrelExportsRule,
   "config-extraction": configExtractionRule,
   "value-extraction": valueExtractionRule,
+  "constant-casing": constantCasingRule,
   "type-extraction": typeExtractionRule,
   "zod-schema-validation": zodSchemaValidationRule,
+  "schema-casing": schemaCasingRule,
   "source-under-src": sourceUnderSrcRule,
   "zirka-baseline": zirkaBaselineRule,
   // Next.js/React application rules.
   "component-placement": componentPlacementRule,
+  "component-casing": componentCasingRule,
   "application-structure": applicationStructureRule,
   "data-testid-case": dataTestIdCaseRule,
   "jsx-hygiene": jsxHygieneRule,

package/package.json

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