@graphql-eslint/eslint-plugin 3.14.4-alpha-20230111221804-f30b422 → 3.14.4-alpha-20230111225020-02d9c28

package/docs/rules/selection-set-depth.md

@@ -1,86 +0,0 @@
-# `selection-set-depth`
-
-✅ The `"extends": "plugin:@graphql-eslint/operations-recommended"` property in a configuration file
-enables this rule.
-
-💡 This rule provides
-[suggestions](https://eslint.org/docs/developer-guide/working-with-rules#providing-suggestions)
-
-- Category: `Operations`
-- Rule name: `@graphql-eslint/selection-set-depth`
-- Requires GraphQL Schema: `false` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
-- Requires GraphQL Operations: `true`
-  [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)
-
-Limit the complexity of the GraphQL operations solely by their depth. Based on
-[graphql-depth-limit](https://npmjs.com/package/graphql-depth-limit).
-
-## Usage Examples
-
-### Incorrect
-
-```graphql
-# eslint @graphql-eslint/selection-set-depth: ['error', { maxDepth: 1 }]
-
-query deep2 {
-  viewer {
-    # Level 0
-    albums {
-      # Level 1
-      title # Level 2
-    }
-  }
-}
-```
-
-### Correct
-
-```graphql
-# eslint @graphql-eslint/selection-set-depth: ['error', { maxDepth: 4 }]
-
-query deep2 {
-  viewer {
-    # Level 0
-    albums {
-      # Level 1
-      title # Level 2
-    }
-  }
-}
-```
-
-### Correct (ignored field)
-
-```graphql
-# eslint @graphql-eslint/selection-set-depth: ['error', { maxDepth: 1, ignore: ['albums'] }]
-
-query deep2 {
-  viewer {
-    # Level 0
-    albums {
-      # Level 1
-      title # Level 2
-    }
-  }
-}
-```
-
-## Config Schema
-
-The schema defines the following properties:
-
-### `maxDepth` (number, required)
-
-### `ignore` (array)
-
-The object is an array with all elements of the type `string`.
-
-Additional restrictions:
-
-- Minimum items: `1`
-- Unique items: `true`
-
-## Resources
-
-- [Rule source](../../packages/plugin/src/rules/selection-set-depth.ts)
-- [Test source](../../packages/plugin/tests/selection-set-depth.spec.ts)

package/docs/rules/strict-id-in-types.md

@@ -1,129 +0,0 @@
-# `strict-id-in-types`
-
-✅ The `"extends": "plugin:@graphql-eslint/schema-recommended"` property in a configuration file
-enables this rule.
-
-- Category: `Schema`
-- Rule name: `@graphql-eslint/strict-id-in-types`
-- Requires GraphQL Schema: `true` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
-- Requires GraphQL Operations: `false`
-  [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)
-
-Requires output types to have one unique identifier unless they do not have a logical one.
-Exceptions can be used to ignore output types that do not have unique identifiers.
-
-## Usage Examples
-
-### Incorrect
-
-```graphql
-# eslint @graphql-eslint/strict-id-in-types: ['error', { acceptedIdNames: ['id', '_id'], acceptedIdTypes: ['ID'], exceptions: { suffixes: ['Payload'] } }]
-
-# Incorrect field name
-type InvalidFieldName {
-  key: ID!
-}
-
-# Incorrect field type
-type InvalidFieldType {
-  id: String!
-}
-
-# Incorrect exception suffix
-type InvalidSuffixResult {
-  data: String!
-}
-
-# Too many unique identifiers. Must only contain one.
-type InvalidFieldName {
-  id: ID!
-  _id: ID!
-}
-```
-
-### Correct
-
-```graphql
-# eslint @graphql-eslint/strict-id-in-types: ['error', { acceptedIdNames: ['id', '_id'], acceptedIdTypes: ['ID'], exceptions: { types: ['Error'], suffixes: ['Payload'] } }]
-
-type User {
-  id: ID!
-}
-
-type Post {
-  _id: ID!
-}
-
-type CreateUserPayload {
-  data: String!
-}
-
-type Error {
-  message: String!
-}
-```
-
-## Config Schema
-
-The schema defines the following properties:
-
-### `acceptedIdNames` (array)
-
-The object is an array with all elements of the type `string`.
-
-Default:
-
-```json
-["id"]
-```
-
-Additional restrictions:
-
-- Minimum items: `1`
-- Unique items: `true`
-
-### `acceptedIdTypes` (array)
-
-The object is an array with all elements of the type `string`.
-
-Default:
-
-```json
-["ID"]
-```
-
-Additional restrictions:
-
-- Minimum items: `1`
-- Unique items: `true`
-
-### `exceptions` (object)
-
-Properties of the `exceptions` object:
-
-#### `types` (array)
-
-This is used to exclude types with names that match one of the specified values.
-
-The object is an array with all elements of the type `string`.
-
-Additional restrictions:
-
-- Minimum items: `1`
-- Unique items: `true`
-
-#### `suffixes` (array)
-
-This is used to exclude types with names with suffixes that match one of the specified values.
-
-The object is an array with all elements of the type `string`.
-
-Additional restrictions:
-
-- Minimum items: `1`
-- Unique items: `true`
-
-## Resources
-
-- [Rule source](../../packages/plugin/src/rules/strict-id-in-types.ts)
-- [Test source](../../packages/plugin/tests/strict-id-in-types.spec.ts)

package/docs/rules/unique-argument-names.md

@@ -1,19 +0,0 @@
-# `unique-argument-names`
-
-✅ The `"extends": "plugin:@graphql-eslint/operations-recommended"` property in a configuration file
-enables this rule.
-
-- Category: `Operations`
-- Rule name: `@graphql-eslint/unique-argument-names`
-- Requires GraphQL Schema: `true` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
-- Requires GraphQL Operations: `false`
-  [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)
-
-A GraphQL field or directive is only valid if all supplied arguments are uniquely named.
-
-> This rule is a wrapper around a `graphql-js` validation function.
-
-## Resources
-
-- [Rule source](https://github.com/graphql/graphql-js/blob/main/src/validation/rules/UniqueArgumentNamesRule.ts)
-- [Test source](https://github.com/graphql/graphql-js/tree/main/src/validation/__tests__/UniqueArgumentNamesRule-test.ts)

package/docs/rules/unique-directive-names-per-location.md

@@ -1,21 +0,0 @@
-# `unique-directive-names-per-location`
-
-✅ The `"extends": "plugin:@graphql-eslint/schema-recommended"` and
-`"plugin:@graphql-eslint/operations-recommended"` property in a configuration file enables this
-rule.
-
-- Category: `Schema & Operations`
-- Rule name: `@graphql-eslint/unique-directive-names-per-location`
-- Requires GraphQL Schema: `true` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
-- Requires GraphQL Operations: `false`
-  [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)
-
-A GraphQL document is only valid if all non-repeatable directives at a given location are uniquely
-named.
-
-> This rule is a wrapper around a `graphql-js` validation function.
-
-## Resources
-
-- [Rule source](https://github.com/graphql/graphql-js/blob/main/src/validation/rules/UniqueDirectivesPerLocationRule.ts)
-- [Test source](https://github.com/graphql/graphql-js/tree/main/src/validation/__tests__/UniqueDirectivesPerLocationRule-test.ts)

package/docs/rules/unique-directive-names.md

@@ -1,19 +0,0 @@
-# `unique-directive-names`
-
-✅ The `"extends": "plugin:@graphql-eslint/schema-recommended"` property in a configuration file
-enables this rule.
-
-- Category: `Schema`
-- Rule name: `@graphql-eslint/unique-directive-names`
-- Requires GraphQL Schema: `false` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
-- Requires GraphQL Operations: `false`
-  [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)
-
-A GraphQL document is only valid if all defined directives have unique names.
-
-> This rule is a wrapper around a `graphql-js` validation function.
-
-## Resources
-
-- [Rule source](https://github.com/graphql/graphql-js/blob/main/src/validation/rules/UniqueDirectiveNamesRule.ts)
-- [Test source](https://github.com/graphql/graphql-js/tree/main/src/validation/__tests__/UniqueDirectiveNamesRule-test.ts)

package/docs/rules/unique-enum-value-names.md

@@ -1,16 +0,0 @@
-# `unique-enum-value-names`
-
-- Category: `Schema`
-- Rule name: `@graphql-eslint/unique-enum-value-names`
-- Requires GraphQL Schema: `false` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
-- Requires GraphQL Operations: `false`
-  [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)
-
-A GraphQL enum type is only valid if all its values are uniquely named.
-
-> This rule is a wrapper around a `graphql-js` validation function.
-
-## Resources
-
-- [Rule source](https://github.com/graphql/graphql-js/blob/main/src/validation/rules/UniqueEnumValueNamesRule.ts)
-- [Test source](https://github.com/graphql/graphql-js/tree/main/src/validation/__tests__/UniqueEnumValueNamesRule-test.ts)

package/docs/rules/unique-field-definition-names.md

@@ -1,19 +0,0 @@
-# `unique-field-definition-names`
-
-✅ The `"extends": "plugin:@graphql-eslint/schema-recommended"` property in a configuration file
-enables this rule.
-
-- Category: `Schema`
-- Rule name: `@graphql-eslint/unique-field-definition-names`
-- Requires GraphQL Schema: `false` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
-- Requires GraphQL Operations: `false`
-  [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)
-
-A GraphQL complex type is only valid if all its fields are uniquely named.
-
-> This rule is a wrapper around a `graphql-js` validation function.
-
-## Resources
-
-- [Rule source](https://github.com/graphql/graphql-js/blob/main/src/validation/rules/UniqueFieldDefinitionNamesRule.ts)
-- [Test source](https://github.com/graphql/graphql-js/tree/main/src/validation/__tests__/UniqueFieldDefinitionNamesRule-test.ts)

package/docs/rules/unique-fragment-name.md

@@ -1,52 +0,0 @@
-# `unique-fragment-name`
-
-- Category: `Operations`
-- Rule name: `@graphql-eslint/unique-fragment-name`
-- Requires GraphQL Schema: `false` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
-- Requires GraphQL Operations: `true`
-  [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)
-
-Enforce unique fragment names across your project.
-
-## Usage Examples
-
-### Incorrect
-
-```graphql
-# eslint @graphql-eslint/unique-fragment-name: 'error'
-
-# user.fragment.graphql
-fragment UserFields on User {
-  id
-  name
-  fullName
-}
-
-# user-fields.graphql
-fragment UserFields on User {
-  id
-}
-```
-
-### Correct
-
-```graphql
-# eslint @graphql-eslint/unique-fragment-name: 'error'
-
-# user.fragment.graphql
-fragment AllUserFields on User {
-  id
-  name
-  fullName
-}
-
-# user-fields.graphql
-fragment UserFields on User {
-  id
-}
-```
-
-## Resources
-
-- [Rule source](../../packages/plugin/src/rules/unique-fragment-name.ts)
-- [Test source](../../packages/plugin/tests/unique-fragment-name.spec.ts)

package/docs/rules/unique-input-field-names.md

@@ -1,19 +0,0 @@
-# `unique-input-field-names`
-
-✅ The `"extends": "plugin:@graphql-eslint/operations-recommended"` property in a configuration file
-enables this rule.
-
-- Category: `Operations`
-- Rule name: `@graphql-eslint/unique-input-field-names`
-- Requires GraphQL Schema: `false` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
-- Requires GraphQL Operations: `false`
-  [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)
-
-A GraphQL input object value is only valid if all supplied fields are uniquely named.
-
-> This rule is a wrapper around a `graphql-js` validation function.
-
-## Resources
-
-- [Rule source](https://github.com/graphql/graphql-js/blob/main/src/validation/rules/UniqueInputFieldNamesRule.ts)
-- [Test source](https://github.com/graphql/graphql-js/tree/main/src/validation/__tests__/UniqueInputFieldNamesRule-test.ts)

package/docs/rules/unique-operation-name.md

@@ -1,56 +0,0 @@
-# `unique-operation-name`
-
-- Category: `Operations`
-- Rule name: `@graphql-eslint/unique-operation-name`
-- Requires GraphQL Schema: `false` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
-- Requires GraphQL Operations: `true`
-  [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)
-
-Enforce unique operation names across your project.
-
-## Usage Examples
-
-### Incorrect
-
-```graphql
-# eslint @graphql-eslint/unique-operation-name: 'error'
-
-# foo.query.graphql
-query user {
-  user {
-    id
-  }
-}
-
-# bar.query.graphql
-query user {
-  me {
-    id
-  }
-}
-```
-
-### Correct
-
-```graphql
-# eslint @graphql-eslint/unique-operation-name: 'error'
-
-# foo.query.graphql
-query user {
-  user {
-    id
-  }
-}
-
-# bar.query.graphql
-query me {
-  me {
-    id
-  }
-}
-```
-
-## Resources
-
-- [Rule source](../../packages/plugin/src/rules/unique-operation-name.ts)
-- [Test source](../../packages/plugin/tests/unique-operation-name.spec.ts)

package/docs/rules/unique-operation-types.md

@@ -1,19 +0,0 @@
-# `unique-operation-types`
-
-✅ The `"extends": "plugin:@graphql-eslint/schema-recommended"` property in a configuration file
-enables this rule.
-
-- Category: `Schema`
-- Rule name: `@graphql-eslint/unique-operation-types`
-- Requires GraphQL Schema: `false` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
-- Requires GraphQL Operations: `false`
-  [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)
-
-A GraphQL document is only valid if it has only one type per operation.
-
-> This rule is a wrapper around a `graphql-js` validation function.
-
-## Resources
-
-- [Rule source](https://github.com/graphql/graphql-js/blob/main/src/validation/rules/UniqueOperationTypesRule.ts)
-- [Test source](https://github.com/graphql/graphql-js/tree/main/src/validation/__tests__/UniqueOperationTypesRule-test.ts)

package/docs/rules/unique-type-names.md

@@ -1,19 +0,0 @@
-# `unique-type-names`
-
-✅ The `"extends": "plugin:@graphql-eslint/schema-recommended"` property in a configuration file
-enables this rule.
-
-- Category: `Schema`
-- Rule name: `@graphql-eslint/unique-type-names`
-- Requires GraphQL Schema: `false` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
-- Requires GraphQL Operations: `false`
-  [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)
-
-A GraphQL document is only valid if all defined types have unique names.
-
-> This rule is a wrapper around a `graphql-js` validation function.
-
-## Resources
-
-- [Rule source](https://github.com/graphql/graphql-js/blob/main/src/validation/rules/UniqueTypeNamesRule.ts)
-- [Test source](https://github.com/graphql/graphql-js/tree/main/src/validation/__tests__/UniqueTypeNamesRule-test.ts)

package/docs/rules/unique-variable-names.md

@@ -1,19 +0,0 @@
-# `unique-variable-names`
-
-✅ The `"extends": "plugin:@graphql-eslint/operations-recommended"` property in a configuration file
-enables this rule.
-
-- Category: `Operations`
-- Rule name: `@graphql-eslint/unique-variable-names`
-- Requires GraphQL Schema: `true` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
-- Requires GraphQL Operations: `false`
-  [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)
-
-A GraphQL operation is only valid if all its variables are uniquely named.
-
-> This rule is a wrapper around a `graphql-js` validation function.
-
-## Resources
-
-- [Rule source](https://github.com/graphql/graphql-js/blob/main/src/validation/rules/UniqueVariableNamesRule.ts)
-- [Test source](https://github.com/graphql/graphql-js/tree/main/src/validation/__tests__/UniqueVariableNamesRule-test.ts)

package/docs/rules/value-literals-of-correct-type.md

@@ -1,22 +0,0 @@
-# `value-literals-of-correct-type`
-
-✅ The `"extends": "plugin:@graphql-eslint/operations-recommended"` property in a configuration file
-enables this rule.
-
-💡 This rule provides
-[suggestions](https://eslint.org/docs/developer-guide/working-with-rules#providing-suggestions)
-
-- Category: `Operations`
-- Rule name: `@graphql-eslint/value-literals-of-correct-type`
-- Requires GraphQL Schema: `true` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
-- Requires GraphQL Operations: `false`
-  [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)
-
-A GraphQL document is only valid if all value literals are of the type expected at their position.
-
-> This rule is a wrapper around a `graphql-js` validation function.
-
-## Resources
-
-- [Rule source](https://github.com/graphql/graphql-js/blob/main/src/validation/rules/ValuesOfCorrectTypeRule.ts)
-- [Test source](https://github.com/graphql/graphql-js/tree/main/src/validation/__tests__/ValuesOfCorrectTypeRule-test.ts)

package/docs/rules/variables-are-input-types.md

@@ -1,20 +0,0 @@
-# `variables-are-input-types`
-
-✅ The `"extends": "plugin:@graphql-eslint/operations-recommended"` property in a configuration file
-enables this rule.
-
-- Category: `Operations`
-- Rule name: `@graphql-eslint/variables-are-input-types`
-- Requires GraphQL Schema: `true` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
-- Requires GraphQL Operations: `false`
-  [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)
-
-A GraphQL operation is only valid if all the variables it defines are of input types (scalar, enum,
-or input object).
-
-> This rule is a wrapper around a `graphql-js` validation function.
-
-## Resources
-
-- [Rule source](https://github.com/graphql/graphql-js/blob/main/src/validation/rules/VariablesAreInputTypesRule.ts)
-- [Test source](https://github.com/graphql/graphql-js/tree/main/src/validation/__tests__/VariablesAreInputTypesRule-test.ts)

package/docs/rules/variables-in-allowed-position.md

@@ -1,19 +0,0 @@
-# `variables-in-allowed-position`
-
-✅ The `"extends": "plugin:@graphql-eslint/operations-recommended"` property in a configuration file
-enables this rule.
-
-- Category: `Operations`
-- Rule name: `@graphql-eslint/variables-in-allowed-position`
-- Requires GraphQL Schema: `true` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
-- Requires GraphQL Operations: `false`
-  [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)
-
-Variables passed to field arguments conform to type.
-
-> This rule is a wrapper around a `graphql-js` validation function.
-
-## Resources
-
-- [Rule source](https://github.com/graphql/graphql-js/blob/main/src/validation/rules/VariablesInAllowedPositionRule.ts)
-- [Test source](https://github.com/graphql/graphql-js/tree/main/src/validation/__tests__/VariablesInAllowedPositionRule-test.ts)