feat(namedParameters): Add global named parameters option (#914)

* fix: correct `jsStringEscape` import

* feat(namedParameters): add global `useNamedParameters` option

* feat(namedParameters): add NAMED_PATH_PARAMS prop type

* test(axios): add named parameters test

* test(angular): add named parameters test

* test(react-query): add named parameters test

* fix(query): introduce destructured usage

* test(svelte-query): add named parameters test

* test(vue-query): add named parameters test

* fix(vue-query): rework MaybeRef logic

* fix(swr): introduce destructured usage

* test(swr): add named parameters test

* chore(cra): update react-scripts

* fix(angular-app): update sample

* fix(react-app): update sample

* fix(react-app-with-swr): update sample

* fix(react-query/basic-app): update sample

* fix(react-query/custom-client-app): update sample

* fix(react-query/form-data-app): update sample

* fix(react-query/form-data-mutator-app): update sample

* fix(react-query/form-url-encoded-mutator-app): update sample

* fix(react-query/hook-mutator-app): update sample

* fix(svelte-query): update sample

* fix(vue-query-app): update sample

* fix(namedParameters): optional arg when all params are optional

Author: Marcel-G

docs/src/pages/reference/configuration/output.md

@@ -1072,6 +1072,28 @@ module.exports = {
 };
 ```
 
+#### useNamedParameters
+
+Type: `Boolean`.
+
+Default Value: `false`.
+
+Generates the operation interfaces with named path parameters instead of individual arguments for each path parameter.
+
+Example:
+
+```js
+module.exports = {
+  petstore: {
+    output: {
+      override: {
+        useNamedParameters: true,
+      },
+    },
+  },
+};
+```
+
 #### useTypeOverInterfaces
 
 Type: `Boolean`

packages/core/src/generators/imports.ts

@@ -4,6 +4,7 @@ import {
   GeneratorImport,
   GeneratorMutator,
   GeneratorVerbOptions,
+  GetterPropType,
 } from '../types';
 import { camel, upath } from '../utils';
 
@@ -275,11 +276,17 @@ export const generateVerbImports = ({
   response,
   body,
   queryParams,
+  props,
   headers,
   params,
 }: GeneratorVerbOptions): GeneratorImport[] => [
   ...response.imports,
   ...body.imports,
+  ...props.flatMap((prop) =>
+    prop.type === GetterPropType.NAMED_PATH_PARAMS
+      ? [{ name: prop.schema.name }]
+      : [],
+  ),
   ...(queryParams ? [{ name: queryParams.schema.name }] : []),
   ...(headers ? [{ name: headers.schema.name }] : []),
   ...params.flatMap<GeneratorImport>(({ imports }) => imports),