@sarj/eslint-plugin 15.13.2 → 15.13.3

package/dist/index.cjs

@@ -3720,8 +3720,6 @@ var no_json_stringify_error_default = createRule({
 var import_utils18 = require("@typescript-eslint/utils");
 
 // src/rules/_zod.ts
-var ZOD_PREFIX_RE = /^Z[A-Z]/;
-var ZOD_SUFFIX_RE = /Schema$/;
 var ZOD_SCHEMA_NAME_RE = /Schema$|^Z[A-Z]/;
 function isZodModule(source) {
   return /(^|[/@-])zod([/-]|$)/.test(source);
@@ -16683,24 +16681,26 @@ var iac_source_coupled_test_default = createSourceCoupledRule(
   IAC_SOURCE_SUFFIX_RE
 );
 
-// src/rules/zod-naming-convention.ts
+// src/rules/require-pascal-case-zod-schema-name.ts
 var import_utils85 = require("@typescript-eslint/utils");
-var ZOD_NAMING_CONVENTION_DOCUMENTATION = {
-  summary: "Enforce a consistent Zod schema naming convention \u2014 a `Z` prefix (`ZUser`) or a `Schema` suffix (`userSchema`); both are accepted by default.",
-  rationale: "A recognizable schema name distinguishes runtime validators from ordinary values at each use site.",
-  remediation: "Rename the schema with a `Z` prefix or `Schema` suffix, according to the configured convention.",
+var REQUIRE_PASCAL_CASE_ZOD_SCHEMA_NAME_DOCUMENTATION = {
+  summary: "Require confirmed module-level Zod schema contracts to use PascalCase with a `Schema` suffix.",
+  rationale: "A reusable Zod schema is a runtime type contract. PascalCase mirrors that role; SCREAMING_SNAKE_CASE should remain reserved for scalar values and lookup tables.",
+  remediation: "Rename the binding to PascalCase ending in `Schema` (for example, `MutationRouteBaseSchema`).",
   category: "style",
+  aliases: ["zod-naming-convention"],
+  autofix: "none",
+  limitations: [
+    "Only module-level bindings proven from a Zod import or a same-file proven schema are checked.",
+    "Tests, benchmarks, generated files, imported schemas, re-export aliases, and arbitrary wrapper-factory results are excluded.",
+    "Cross-file and exported renames are not safely file-local, so the rule has no autofix."
+  ],
   examples: [
-    { id: "recognizable-schema-name", title: "Mark the value as a schema", outcome: "no-match", files: [{ path: "src/user.ts", source: "import { z } from 'zod';\nconst userSchema = z.object({ id: z.string() });" }], focusPath: "src/user.ts", expectedCount: 0, public: true },
-    { id: "unmarked-schema-name", title: "Do not hide the schema behind a value name", outcome: "match", files: [{ path: "src/user.ts", source: "import { z } from 'zod';\nconst user = z.object({ id: z.string() });" }], focusPath: "src/user.ts", expectedCount: 1, public: true }
+    { id: "runtime-type-schema-name", title: "Name a reusable schema like a runtime type contract", outcome: "no-match", files: [{ path: "src/user.ts", source: "import { z } from 'zod';\nexport const UserSchema = z.object({ id: z.string() });" }], focusPath: "src/user.ts", expectedCount: 0, public: true },
+    { id: "screaming-schema-name", title: "Do not name a schema like a scalar constant", outcome: "match", files: [{ path: "src/user.ts", source: "import { z } from 'zod';\nexport const USER_SCHEMA = z.object({ id: z.string() });" }], focusPath: "src/user.ts", expectedCount: 1, public: true }
   ]
 };
-var CONVENTIONS = {
-  prefix: { test: ZOD_PREFIX_RE, messageId: "zPrefix" },
-  suffix: { test: ZOD_SUFFIX_RE, messageId: "schemaSuffix" },
-  either: { test: ZOD_SCHEMA_NAME_RE, messageId: "zodSchemaName" }
-};
-var CONTAINS_SCHEMA_RE = /schema/i;
+var PASCAL_SCHEMA_NAME_RE = /^[A-Z][A-Za-z0-9]*Schema$/;
 var BENCHMARK_PATH_RE = /(^|[\\/])(?:benchmarks?|bench)[\\/]/;
 var NON_SCHEMA_TERMINALS = /* @__PURE__ */ new Set([
   "parse",
@@ -16725,6 +16725,95 @@ var NON_SCHEMA_TERMINALS = /* @__PURE__ */ new Set([
   "prettifyError",
   "treeifyError"
 ]);
+var ZOD_SCHEMA_FACTORIES = /* @__PURE__ */ new Set([
+  "any",
+  "array",
+  "base64",
+  "base64url",
+  "bigint",
+  "boolean",
+  "cidrv4",
+  "cidrv6",
+  "codec",
+  "custom",
+  "date",
+  "discriminatedUnion",
+  "email",
+  "emoji",
+  "enum",
+  "file",
+  "function",
+  "hash",
+  "hex",
+  "hostname",
+  "instanceof",
+  "intersection",
+  "ipv4",
+  "ipv6",
+  "json",
+  "jwt",
+  "lazy",
+  "literal",
+  "looseObject",
+  "map",
+  "nan",
+  "nativeEnum",
+  "never",
+  "null",
+  "nullable",
+  "nullish",
+  "number",
+  "object",
+  "optional",
+  "partialRecord",
+  "preprocess",
+  "promise",
+  "record",
+  "set",
+  "strictObject",
+  "string",
+  "stringbool",
+  "symbol",
+  "templateLiteral",
+  "tuple",
+  "undefined",
+  "union",
+  "unknown",
+  "url",
+  "uuid",
+  "void"
+]);
+var ZOD_FACTORY_NAMESPACES = /* @__PURE__ */ new Set(["coerce", "iso"]);
+var SCHEMA_RETURNING_METHODS = /* @__PURE__ */ new Set([
+  "and",
+  "array",
+  "brand",
+  "catch",
+  "check",
+  "clone",
+  "default",
+  "describe",
+  "extend",
+  "keyof",
+  "meta",
+  "nullable",
+  "nullish",
+  "omit",
+  "optional",
+  "or",
+  "overwrite",
+  "partial",
+  "pick",
+  "pipe",
+  "prefault",
+  "readonly",
+  "refine",
+  "register",
+  "required",
+  "safeExtend",
+  "superRefine",
+  "transform"
+]);
 var terminalMethodName = (callee) => !callee.computed && callee.property.type === import_utils85.AST_NODE_TYPES.Identifier ? callee.property.name : null;
 var calleeChainRoot = (node) => {
   let current = node;
@@ -16743,38 +16832,55 @@ var calleeChainRoot = (node) => {
     return null;
   }
 };
-var zod_naming_convention_default = createRule({
-  name: "zod-naming-convention",
-  documentation: ZOD_NAMING_CONVENTION_DOCUMENTATION,
+var chainMemberNames = (node) => {
+  const names = [];
+  let current = node;
+  for (; ; ) {
+    if (current.type === import_utils85.AST_NODE_TYPES.MemberExpression) {
+      if (current.computed || current.property.type !== import_utils85.AST_NODE_TYPES.Identifier) return [];
+      names.push(current.property.name);
+      current = current.object;
+      continue;
+    }
+    if (current.type === import_utils85.AST_NODE_TYPES.CallExpression) {
+      current = current.callee;
+      continue;
+    }
+    break;
+  }
+  names.reverse();
+  return names;
+};
+var unwrapExpression4 = (node) => {
+  let current = node;
+  while (current.type === import_utils85.AST_NODE_TYPES.TSAsExpression || current.type === import_utils85.AST_NODE_TYPES.TSSatisfiesExpression || current.type === import_utils85.AST_NODE_TYPES.TSNonNullExpression || current.type === import_utils85.AST_NODE_TYPES.TSTypeAssertion) {
+    current = current.expression;
+  }
+  return current;
+};
+var isModuleDeclarator = (node) => {
+  const declaration = node.parent;
+  if (declaration.type !== import_utils85.AST_NODE_TYPES.VariableDeclaration) return false;
+  const owner = declaration.parent;
+  return owner.type === import_utils85.AST_NODE_TYPES.Program || owner.type === import_utils85.AST_NODE_TYPES.ExportNamedDeclaration && owner.parent.type === import_utils85.AST_NODE_TYPES.Program;
+};
+var require_pascal_case_zod_schema_name_default = createRule({
+  name: "require-pascal-case-zod-schema-name",
+  documentation: REQUIRE_PASCAL_CASE_ZOD_SCHEMA_NAME_DOCUMENTATION,
   meta: {
     type: "suggestion",
     docs: {
-      description: "Enforce a consistent Zod schema naming convention \u2014 a `Z` prefix (`ZUser`) or a `Schema` suffix (`userSchema`); both are accepted by default."
+      description: "Require confirmed module-level Zod schema contracts to use PascalCase with a `Schema` suffix."
     },
-    schema: [
-      {
-        type: "object",
-        additionalProperties: false,
-        properties: {
-          convention: {
-            type: "string",
-            enum: ["prefix", "suffix", "either"]
-          }
-        }
-      }
-    ],
+    schema: [],
     messages: {
-      zPrefix: "Zod schema names should start with Z (e.g. `ZUser`)",
-      schemaSuffix: "Zod schema names should end with Schema (e.g. `userSchema`)",
-      zodSchemaName: "Zod schema names should start with Z (`ZUser`) or end with Schema (`userSchema`)"
+      requirePascalSchema: "Zod schema contracts must use PascalCase ending in Schema (for example, `MutationRouteBaseSchema`); reserve SCREAMING_SNAKE_CASE for scalar/table constants."
     }
   },
-  defaultOptions: [{}],
-  create(context, [optionsArg]) {
-    const convention = optionsArg?.convention ?? "either";
-    const { test, messageId } = CONVENTIONS[convention];
-    const acceptsSchemaWord = convention !== "prefix";
+  defaultOptions: [],
+  create(context) {
     const zodBindings = /* @__PURE__ */ new Set();
+    const schemaBindings = /* @__PURE__ */ new Set();
     function resolvedBinding(identifier) {
       return import_utils85.ASTUtils.findVariable(
         context.sourceCode.getScope(identifier),
@@ -16791,6 +16897,26 @@ var zod_naming_convention_default = createRule({
       const binding = resolvedBinding(root);
       return binding !== null && zodBindings.has(binding);
     }
+    function isSchemaBinding(identifier) {
+      const binding = resolvedBinding(identifier);
+      return binding !== null && schemaBindings.has(binding);
+    }
+    function isConfirmedSchema(expression) {
+      const init = unwrapExpression4(expression);
+      if (init.type === import_utils85.AST_NODE_TYPES.Identifier) return isSchemaBinding(init);
+      if (init.type !== import_utils85.AST_NODE_TYPES.CallExpression || init.callee.type !== import_utils85.AST_NODE_TYPES.MemberExpression) {
+        return false;
+      }
+      const terminal = terminalMethodName(init.callee);
+      if (terminal === null || NON_SCHEMA_TERMINALS.has(terminal)) return false;
+      const names = chainMemberNames(init.callee);
+      if (names.length === 0) return false;
+      if (isZodChain(init.callee)) {
+        return ZOD_SCHEMA_FACTORIES.has(names[0] ?? "") || ZOD_FACTORY_NAMESPACES.has(names[0] ?? "") && ZOD_SCHEMA_FACTORIES.has(names[1] ?? "");
+      }
+      const root = calleeChainRoot(init.callee);
+      return root !== null && isSchemaBinding(root) && SCHEMA_RETURNING_METHODS.has(terminal);
+    }
     if (isTestFile(context.filename) || BENCHMARK_PATH_RE.test(context.filename.replaceAll("\\", "/")) || isGeneratedFile(context.filename, context.sourceCode.text)) {
       return {};
     }
@@ -16804,20 +16930,17 @@ var zod_naming_convention_default = createRule({
         }
       },
       VariableDeclarator(node) {
+        if (!isModuleDeclarator(node)) return;
         const init = node.init;
         if (init === null || init === void 0) return;
-        if (init.type !== import_utils85.AST_NODE_TYPES.CallExpression) return;
-        const callee = init.callee;
-        if (callee.type !== import_utils85.AST_NODE_TYPES.MemberExpression) return;
-        if (!isZodChain(callee)) return;
-        const terminal = terminalMethodName(callee);
-        if (terminal !== null && NON_SCHEMA_TERMINALS.has(terminal)) return;
         if (node.id.type !== import_utils85.AST_NODE_TYPES.Identifier) return;
-        if (test.test(node.id.name)) return;
-        if (acceptsSchemaWord && CONTAINS_SCHEMA_RE.test(node.id.name)) return;
+        if (!isConfirmedSchema(init)) return;
+        const binding = resolvedBinding(node.id);
+        if (binding !== null) schemaBindings.add(binding);
+        if (PASCAL_SCHEMA_NAME_RE.test(node.id.name)) return;
         context.report({
           node: node.id,
-          messageId
+          messageId: "requirePascalSchema"
         });
       }
     };
@@ -16827,6 +16950,7 @@ var zod_naming_convention_default = createRule({
 // src/rules/_renames.ts
 var RENAMED_RULES = {
   "jsdoc-restates-signature": "no-restated-jsdoc",
+  "zod-naming-convention": "require-pascal-case-zod-schema-name",
   "require-interface-for-injected-service": "require-port-for-service",
   "strict-test-assertions": "prefer-whole-object-assertion",
   "trailing-value-narration": "no-trailing-value-narration"
@@ -16984,18 +17108,18 @@ var RULES = {
   "store-insert-requires-on-conflict": store_insert_requires_on_conflict_default,
   "stepdown": stepdown_default,
   "source-coupled-test": source_coupled_test_default,
-  "zod-naming-convention": zod_naming_convention_default
+  "require-pascal-case-zod-schema-name": require_pascal_case_zod_schema_name_default
 };
 var meta = {
   name: "@sarj/eslint-plugin",
-  version: "15.13.2"
+  version: "15.13.3"
 };
 var APPLICATION_ONLY_RULES = [
   "no-restricted-library-load",
   "prefer-native-random-uuid",
   "prefer-shadcn-primitives"
 ];
-var ADVISORY_RULES = [];
+var ADVISORY_RULES = ["@sarj/require-pascal-case-zod-schema-name"];
 var RECOMMENDED_RULES = {
   "@sarj/interface-contract-members-private": "error",
   "@sarj/iac-source-coupled-test": "error",
@@ -17068,7 +17192,7 @@ var RECOMMENDED_RULES = {
   "@sarj/stepdown": "error",
   "@sarj/source-coupled-test": "error",
   "@sarj/test-phase-label-comment": "error",
-  "@sarj/zod-naming-convention": "error"
+  "@sarj/require-pascal-case-zod-schema-name": "warn"
 };
 var STRICT_RULES = {
   "@sarj/interface-contract-members-private": "error",
@@ -17146,7 +17270,7 @@ var STRICT_RULES = {
   "@sarj/stepdown": "error",
   "@sarj/source-coupled-test": "error",
   "@sarj/test-phase-label-comment": "error",
-  "@sarj/zod-naming-convention": "error"
+  "@sarj/require-pascal-case-zod-schema-name": "warn"
 };
 var PLUGIN = {
   meta,

package/dist/index.d.cts

@@ -182,6 +182,7 @@ interface RuleOptions {
  */
 declare const RENAMED_RULES: {
     readonly "jsdoc-restates-signature": "no-restated-jsdoc";
+    readonly "zod-naming-convention": "require-pascal-case-zod-schema-name";
     readonly "require-interface-for-injected-service": "require-port-for-service";
     readonly "strict-test-assertions": "prefer-whole-object-assertion";
     readonly "trailing-value-narration": "no-trailing-value-narration";
@@ -289,14 +290,12 @@ declare const RULES: {
     readonly "store-insert-requires-on-conflict": DocumentedRule<readonly [], "storeInsertRequiresOnConflict">;
     readonly stepdown: DocumentedRule<[], "helperAboveOnlyCaller">;
     readonly "source-coupled-test": DocumentedRule<readonly [], "rawSourceOracle">;
-    readonly "zod-naming-convention": DocumentedRule<readonly [{
-        convention?: "prefix" | "suffix" | "either";
-    }?], "zPrefix" | "schemaSuffix" | "zodSchemaName">;
+    readonly "require-pascal-case-zod-schema-name": DocumentedRule<readonly [], "requirePascalSchema">;
 };
 /** Rules registered for application-profile configs but intentionally absent from general presets. */
 declare const APPLICATION_ONLY_RULES: readonly ["no-restricted-library-load", "prefer-native-random-uuid", "prefer-shadcn-primitives"];
 /** No active rule remains advisory; retained as a public compatibility export. */
-declare const ADVISORY_RULES: readonly [];
+declare const ADVISORY_RULES: readonly ["@sarj/require-pascal-case-zod-schema-name"];
 declare const RECOMMENDED_RULES: {
     readonly "@sarj/interface-contract-members-private": "error";
     readonly "@sarj/iac-source-coupled-test": "error";
@@ -373,7 +372,7 @@ declare const RECOMMENDED_RULES: {
     readonly "@sarj/stepdown": "error";
     readonly "@sarj/source-coupled-test": "error";
     readonly "@sarj/test-phase-label-comment": "error";
-    readonly "@sarj/zod-naming-convention": "error";
+    readonly "@sarj/require-pascal-case-zod-schema-name": "warn";
 };
 declare const STRICT_RULES: {
     readonly "@sarj/interface-contract-members-private": "error";
@@ -455,7 +454,7 @@ declare const STRICT_RULES: {
     readonly "@sarj/stepdown": "error";
     readonly "@sarj/source-coupled-test": "error";
     readonly "@sarj/test-phase-label-comment": "error";
-    readonly "@sarj/zod-naming-convention": "error";
+    readonly "@sarj/require-pascal-case-zod-schema-name": "warn";
 };
 type FlatPreset = {
     readonly name: string;
@@ -465,7 +464,7 @@ type FlatPreset = {
 declare const PLUGIN: {
     readonly meta: {
         readonly name: "@sarj/eslint-plugin";
-        readonly version: "15.13.2";
+        readonly version: "15.13.3";
     };
     readonly rules: {
         readonly "iac-source-coupled-test": DocumentedRule<readonly [], "rawSourceOracle">;
@@ -569,9 +568,7 @@ declare const PLUGIN: {
         readonly "store-insert-requires-on-conflict": DocumentedRule<readonly [], "storeInsertRequiresOnConflict">;
         readonly stepdown: DocumentedRule<[], "helperAboveOnlyCaller">;
         readonly "source-coupled-test": DocumentedRule<readonly [], "rawSourceOracle">;
-        readonly "zod-naming-convention": DocumentedRule<readonly [{
-            convention?: "prefix" | "suffix" | "either";
-        }?], "zPrefix" | "schemaSuffix" | "zodSchemaName">;
+        readonly "require-pascal-case-zod-schema-name": DocumentedRule<readonly [], "requirePascalSchema">;
     };
     readonly retiredRules: Readonly<Record<string, RetiredRule>>;
     readonly configs: {

package/dist/index.d.ts

@@ -182,6 +182,7 @@ interface RuleOptions {
  */
 declare const RENAMED_RULES: {
     readonly "jsdoc-restates-signature": "no-restated-jsdoc";
+    readonly "zod-naming-convention": "require-pascal-case-zod-schema-name";
     readonly "require-interface-for-injected-service": "require-port-for-service";
     readonly "strict-test-assertions": "prefer-whole-object-assertion";
     readonly "trailing-value-narration": "no-trailing-value-narration";
@@ -289,14 +290,12 @@ declare const RULES: {
     readonly "store-insert-requires-on-conflict": DocumentedRule<readonly [], "storeInsertRequiresOnConflict">;
     readonly stepdown: DocumentedRule<[], "helperAboveOnlyCaller">;
     readonly "source-coupled-test": DocumentedRule<readonly [], "rawSourceOracle">;
-    readonly "zod-naming-convention": DocumentedRule<readonly [{
-        convention?: "prefix" | "suffix" | "either";
-    }?], "zPrefix" | "schemaSuffix" | "zodSchemaName">;
+    readonly "require-pascal-case-zod-schema-name": DocumentedRule<readonly [], "requirePascalSchema">;
 };
 /** Rules registered for application-profile configs but intentionally absent from general presets. */
 declare const APPLICATION_ONLY_RULES: readonly ["no-restricted-library-load", "prefer-native-random-uuid", "prefer-shadcn-primitives"];
 /** No active rule remains advisory; retained as a public compatibility export. */
-declare const ADVISORY_RULES: readonly [];
+declare const ADVISORY_RULES: readonly ["@sarj/require-pascal-case-zod-schema-name"];
 declare const RECOMMENDED_RULES: {
     readonly "@sarj/interface-contract-members-private": "error";
     readonly "@sarj/iac-source-coupled-test": "error";
@@ -373,7 +372,7 @@ declare const RECOMMENDED_RULES: {
     readonly "@sarj/stepdown": "error";
     readonly "@sarj/source-coupled-test": "error";
     readonly "@sarj/test-phase-label-comment": "error";
-    readonly "@sarj/zod-naming-convention": "error";
+    readonly "@sarj/require-pascal-case-zod-schema-name": "warn";
 };
 declare const STRICT_RULES: {
     readonly "@sarj/interface-contract-members-private": "error";
@@ -455,7 +454,7 @@ declare const STRICT_RULES: {
     readonly "@sarj/stepdown": "error";
     readonly "@sarj/source-coupled-test": "error";
     readonly "@sarj/test-phase-label-comment": "error";
-    readonly "@sarj/zod-naming-convention": "error";
+    readonly "@sarj/require-pascal-case-zod-schema-name": "warn";
 };
 type FlatPreset = {
     readonly name: string;
@@ -465,7 +464,7 @@ type FlatPreset = {
 declare const PLUGIN: {
     readonly meta: {
         readonly name: "@sarj/eslint-plugin";
-        readonly version: "15.13.2";
+        readonly version: "15.13.3";
     };
     readonly rules: {
         readonly "iac-source-coupled-test": DocumentedRule<readonly [], "rawSourceOracle">;
@@ -569,9 +568,7 @@ declare const PLUGIN: {
         readonly "store-insert-requires-on-conflict": DocumentedRule<readonly [], "storeInsertRequiresOnConflict">;
         readonly stepdown: DocumentedRule<[], "helperAboveOnlyCaller">;
         readonly "source-coupled-test": DocumentedRule<readonly [], "rawSourceOracle">;
-        readonly "zod-naming-convention": DocumentedRule<readonly [{
-            convention?: "prefix" | "suffix" | "either";
-        }?], "zPrefix" | "schemaSuffix" | "zodSchemaName">;
+        readonly "require-pascal-case-zod-schema-name": DocumentedRule<readonly [], "requirePascalSchema">;
     };
     readonly retiredRules: Readonly<Record<string, RetiredRule>>;
     readonly configs: {

package/dist/index.js

@@ -3674,8 +3674,6 @@ import {
 } from "@typescript-eslint/utils";
 
 // src/rules/_zod.ts
-var ZOD_PREFIX_RE = /^Z[A-Z]/;
-var ZOD_SUFFIX_RE = /Schema$/;
 var ZOD_SCHEMA_NAME_RE = /Schema$|^Z[A-Z]/;
 function isZodModule(source) {
   return /(^|[/@-])zod([/-]|$)/.test(source);
@@ -16662,27 +16660,29 @@ var iac_source_coupled_test_default = createSourceCoupledRule(
   IAC_SOURCE_SUFFIX_RE
 );
 
-// src/rules/zod-naming-convention.ts
+// src/rules/require-pascal-case-zod-schema-name.ts
 import {
   AST_NODE_TYPES as AST_NODE_TYPES65,
   ASTUtils as ASTUtils22
 } from "@typescript-eslint/utils";
-var ZOD_NAMING_CONVENTION_DOCUMENTATION = {
-  summary: "Enforce a consistent Zod schema naming convention \u2014 a `Z` prefix (`ZUser`) or a `Schema` suffix (`userSchema`); both are accepted by default.",
-  rationale: "A recognizable schema name distinguishes runtime validators from ordinary values at each use site.",
-  remediation: "Rename the schema with a `Z` prefix or `Schema` suffix, according to the configured convention.",
+var REQUIRE_PASCAL_CASE_ZOD_SCHEMA_NAME_DOCUMENTATION = {
+  summary: "Require confirmed module-level Zod schema contracts to use PascalCase with a `Schema` suffix.",
+  rationale: "A reusable Zod schema is a runtime type contract. PascalCase mirrors that role; SCREAMING_SNAKE_CASE should remain reserved for scalar values and lookup tables.",
+  remediation: "Rename the binding to PascalCase ending in `Schema` (for example, `MutationRouteBaseSchema`).",
   category: "style",
+  aliases: ["zod-naming-convention"],
+  autofix: "none",
+  limitations: [
+    "Only module-level bindings proven from a Zod import or a same-file proven schema are checked.",
+    "Tests, benchmarks, generated files, imported schemas, re-export aliases, and arbitrary wrapper-factory results are excluded.",
+    "Cross-file and exported renames are not safely file-local, so the rule has no autofix."
+  ],
   examples: [
-    { id: "recognizable-schema-name", title: "Mark the value as a schema", outcome: "no-match", files: [{ path: "src/user.ts", source: "import { z } from 'zod';\nconst userSchema = z.object({ id: z.string() });" }], focusPath: "src/user.ts", expectedCount: 0, public: true },
-    { id: "unmarked-schema-name", title: "Do not hide the schema behind a value name", outcome: "match", files: [{ path: "src/user.ts", source: "import { z } from 'zod';\nconst user = z.object({ id: z.string() });" }], focusPath: "src/user.ts", expectedCount: 1, public: true }
+    { id: "runtime-type-schema-name", title: "Name a reusable schema like a runtime type contract", outcome: "no-match", files: [{ path: "src/user.ts", source: "import { z } from 'zod';\nexport const UserSchema = z.object({ id: z.string() });" }], focusPath: "src/user.ts", expectedCount: 0, public: true },
+    { id: "screaming-schema-name", title: "Do not name a schema like a scalar constant", outcome: "match", files: [{ path: "src/user.ts", source: "import { z } from 'zod';\nexport const USER_SCHEMA = z.object({ id: z.string() });" }], focusPath: "src/user.ts", expectedCount: 1, public: true }
   ]
 };
-var CONVENTIONS = {
-  prefix: { test: ZOD_PREFIX_RE, messageId: "zPrefix" },
-  suffix: { test: ZOD_SUFFIX_RE, messageId: "schemaSuffix" },
-  either: { test: ZOD_SCHEMA_NAME_RE, messageId: "zodSchemaName" }
-};
-var CONTAINS_SCHEMA_RE = /schema/i;
+var PASCAL_SCHEMA_NAME_RE = /^[A-Z][A-Za-z0-9]*Schema$/;
 var BENCHMARK_PATH_RE = /(^|[\\/])(?:benchmarks?|bench)[\\/]/;
 var NON_SCHEMA_TERMINALS = /* @__PURE__ */ new Set([
   "parse",
@@ -16707,6 +16707,95 @@ var NON_SCHEMA_TERMINALS = /* @__PURE__ */ new Set([
   "prettifyError",
   "treeifyError"
 ]);
+var ZOD_SCHEMA_FACTORIES = /* @__PURE__ */ new Set([
+  "any",
+  "array",
+  "base64",
+  "base64url",
+  "bigint",
+  "boolean",
+  "cidrv4",
+  "cidrv6",
+  "codec",
+  "custom",
+  "date",
+  "discriminatedUnion",
+  "email",
+  "emoji",
+  "enum",
+  "file",
+  "function",
+  "hash",
+  "hex",
+  "hostname",
+  "instanceof",
+  "intersection",
+  "ipv4",
+  "ipv6",
+  "json",
+  "jwt",
+  "lazy",
+  "literal",
+  "looseObject",
+  "map",
+  "nan",
+  "nativeEnum",
+  "never",
+  "null",
+  "nullable",
+  "nullish",
+  "number",
+  "object",
+  "optional",
+  "partialRecord",
+  "preprocess",
+  "promise",
+  "record",
+  "set",
+  "strictObject",
+  "string",
+  "stringbool",
+  "symbol",
+  "templateLiteral",
+  "tuple",
+  "undefined",
+  "union",
+  "unknown",
+  "url",
+  "uuid",
+  "void"
+]);
+var ZOD_FACTORY_NAMESPACES = /* @__PURE__ */ new Set(["coerce", "iso"]);
+var SCHEMA_RETURNING_METHODS = /* @__PURE__ */ new Set([
+  "and",
+  "array",
+  "brand",
+  "catch",
+  "check",
+  "clone",
+  "default",
+  "describe",
+  "extend",
+  "keyof",
+  "meta",
+  "nullable",
+  "nullish",
+  "omit",
+  "optional",
+  "or",
+  "overwrite",
+  "partial",
+  "pick",
+  "pipe",
+  "prefault",
+  "readonly",
+  "refine",
+  "register",
+  "required",
+  "safeExtend",
+  "superRefine",
+  "transform"
+]);
 var terminalMethodName = (callee) => !callee.computed && callee.property.type === AST_NODE_TYPES65.Identifier ? callee.property.name : null;
 var calleeChainRoot = (node) => {
   let current = node;
@@ -16725,38 +16814,55 @@ var calleeChainRoot = (node) => {
     return null;
   }
 };
-var zod_naming_convention_default = createRule({
-  name: "zod-naming-convention",
-  documentation: ZOD_NAMING_CONVENTION_DOCUMENTATION,
+var chainMemberNames = (node) => {
+  const names = [];
+  let current = node;
+  for (; ; ) {
+    if (current.type === AST_NODE_TYPES65.MemberExpression) {
+      if (current.computed || current.property.type !== AST_NODE_TYPES65.Identifier) return [];
+      names.push(current.property.name);
+      current = current.object;
+      continue;
+    }
+    if (current.type === AST_NODE_TYPES65.CallExpression) {
+      current = current.callee;
+      continue;
+    }
+    break;
+  }
+  names.reverse();
+  return names;
+};
+var unwrapExpression4 = (node) => {
+  let current = node;
+  while (current.type === AST_NODE_TYPES65.TSAsExpression || current.type === AST_NODE_TYPES65.TSSatisfiesExpression || current.type === AST_NODE_TYPES65.TSNonNullExpression || current.type === AST_NODE_TYPES65.TSTypeAssertion) {
+    current = current.expression;
+  }
+  return current;
+};
+var isModuleDeclarator = (node) => {
+  const declaration = node.parent;
+  if (declaration.type !== AST_NODE_TYPES65.VariableDeclaration) return false;
+  const owner = declaration.parent;
+  return owner.type === AST_NODE_TYPES65.Program || owner.type === AST_NODE_TYPES65.ExportNamedDeclaration && owner.parent.type === AST_NODE_TYPES65.Program;
+};
+var require_pascal_case_zod_schema_name_default = createRule({
+  name: "require-pascal-case-zod-schema-name",
+  documentation: REQUIRE_PASCAL_CASE_ZOD_SCHEMA_NAME_DOCUMENTATION,
   meta: {
     type: "suggestion",
     docs: {
-      description: "Enforce a consistent Zod schema naming convention \u2014 a `Z` prefix (`ZUser`) or a `Schema` suffix (`userSchema`); both are accepted by default."
+      description: "Require confirmed module-level Zod schema contracts to use PascalCase with a `Schema` suffix."
     },
-    schema: [
-      {
-        type: "object",
-        additionalProperties: false,
-        properties: {
-          convention: {
-            type: "string",
-            enum: ["prefix", "suffix", "either"]
-          }
-        }
-      }
-    ],
+    schema: [],
     messages: {
-      zPrefix: "Zod schema names should start with Z (e.g. `ZUser`)",
-      schemaSuffix: "Zod schema names should end with Schema (e.g. `userSchema`)",
-      zodSchemaName: "Zod schema names should start with Z (`ZUser`) or end with Schema (`userSchema`)"
+      requirePascalSchema: "Zod schema contracts must use PascalCase ending in Schema (for example, `MutationRouteBaseSchema`); reserve SCREAMING_SNAKE_CASE for scalar/table constants."
     }
   },
-  defaultOptions: [{}],
-  create(context, [optionsArg]) {
-    const convention = optionsArg?.convention ?? "either";
-    const { test, messageId } = CONVENTIONS[convention];
-    const acceptsSchemaWord = convention !== "prefix";
+  defaultOptions: [],
+  create(context) {
     const zodBindings = /* @__PURE__ */ new Set();
+    const schemaBindings = /* @__PURE__ */ new Set();
     function resolvedBinding(identifier) {
       return ASTUtils22.findVariable(
         context.sourceCode.getScope(identifier),
@@ -16773,6 +16879,26 @@ var zod_naming_convention_default = createRule({
       const binding = resolvedBinding(root);
       return binding !== null && zodBindings.has(binding);
     }
+    function isSchemaBinding(identifier) {
+      const binding = resolvedBinding(identifier);
+      return binding !== null && schemaBindings.has(binding);
+    }
+    function isConfirmedSchema(expression) {
+      const init = unwrapExpression4(expression);
+      if (init.type === AST_NODE_TYPES65.Identifier) return isSchemaBinding(init);
+      if (init.type !== AST_NODE_TYPES65.CallExpression || init.callee.type !== AST_NODE_TYPES65.MemberExpression) {
+        return false;
+      }
+      const terminal = terminalMethodName(init.callee);
+      if (terminal === null || NON_SCHEMA_TERMINALS.has(terminal)) return false;
+      const names = chainMemberNames(init.callee);
+      if (names.length === 0) return false;
+      if (isZodChain(init.callee)) {
+        return ZOD_SCHEMA_FACTORIES.has(names[0] ?? "") || ZOD_FACTORY_NAMESPACES.has(names[0] ?? "") && ZOD_SCHEMA_FACTORIES.has(names[1] ?? "");
+      }
+      const root = calleeChainRoot(init.callee);
+      return root !== null && isSchemaBinding(root) && SCHEMA_RETURNING_METHODS.has(terminal);
+    }
     if (isTestFile(context.filename) || BENCHMARK_PATH_RE.test(context.filename.replaceAll("\\", "/")) || isGeneratedFile(context.filename, context.sourceCode.text)) {
       return {};
     }
@@ -16786,20 +16912,17 @@ var zod_naming_convention_default = createRule({
         }
       },
       VariableDeclarator(node) {
+        if (!isModuleDeclarator(node)) return;
         const init = node.init;
         if (init === null || init === void 0) return;
-        if (init.type !== AST_NODE_TYPES65.CallExpression) return;
-        const callee = init.callee;
-        if (callee.type !== AST_NODE_TYPES65.MemberExpression) return;
-        if (!isZodChain(callee)) return;
-        const terminal = terminalMethodName(callee);
-        if (terminal !== null && NON_SCHEMA_TERMINALS.has(terminal)) return;
         if (node.id.type !== AST_NODE_TYPES65.Identifier) return;
-        if (test.test(node.id.name)) return;
-        if (acceptsSchemaWord && CONTAINS_SCHEMA_RE.test(node.id.name)) return;
+        if (!isConfirmedSchema(init)) return;
+        const binding = resolvedBinding(node.id);
+        if (binding !== null) schemaBindings.add(binding);
+        if (PASCAL_SCHEMA_NAME_RE.test(node.id.name)) return;
         context.report({
           node: node.id,
-          messageId
+          messageId: "requirePascalSchema"
         });
       }
     };
@@ -16809,6 +16932,7 @@ var zod_naming_convention_default = createRule({
 // src/rules/_renames.ts
 var RENAMED_RULES = {
   "jsdoc-restates-signature": "no-restated-jsdoc",
+  "zod-naming-convention": "require-pascal-case-zod-schema-name",
   "require-interface-for-injected-service": "require-port-for-service",
   "strict-test-assertions": "prefer-whole-object-assertion",
   "trailing-value-narration": "no-trailing-value-narration"
@@ -16966,18 +17090,18 @@ var RULES = {
   "store-insert-requires-on-conflict": store_insert_requires_on_conflict_default,
   "stepdown": stepdown_default,
   "source-coupled-test": source_coupled_test_default,
-  "zod-naming-convention": zod_naming_convention_default
+  "require-pascal-case-zod-schema-name": require_pascal_case_zod_schema_name_default
 };
 var meta = {
   name: "@sarj/eslint-plugin",
-  version: "15.13.2"
+  version: "15.13.3"
 };
 var APPLICATION_ONLY_RULES = [
   "no-restricted-library-load",
   "prefer-native-random-uuid",
   "prefer-shadcn-primitives"
 ];
-var ADVISORY_RULES = [];
+var ADVISORY_RULES = ["@sarj/require-pascal-case-zod-schema-name"];
 var RECOMMENDED_RULES = {
   "@sarj/interface-contract-members-private": "error",
   "@sarj/iac-source-coupled-test": "error",
@@ -17050,7 +17174,7 @@ var RECOMMENDED_RULES = {
   "@sarj/stepdown": "error",
   "@sarj/source-coupled-test": "error",
   "@sarj/test-phase-label-comment": "error",
-  "@sarj/zod-naming-convention": "error"
+  "@sarj/require-pascal-case-zod-schema-name": "warn"
 };
 var STRICT_RULES = {
   "@sarj/interface-contract-members-private": "error",
@@ -17128,7 +17252,7 @@ var STRICT_RULES = {
   "@sarj/stepdown": "error",
   "@sarj/source-coupled-test": "error",
   "@sarj/test-phase-label-comment": "error",
-  "@sarj/zod-naming-convention": "error"
+  "@sarj/require-pascal-case-zod-schema-name": "warn"
 };
 var PLUGIN = {
   meta,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sarj/eslint-plugin",
-  "version": "15.13.2",
+  "version": "15.13.3",
   "packageManager": "npm@12.0.2",
   "description": "Custom ESLint rules for hypermodern TypeScript / React / Next.js projects",
   "type": "module",