Change importModuleSpecifierEnding default to .js

examples/apollo-server/tsconfig.json

@@ -1,7 +1,6 @@
 {
   "grats": {
-    "nullableByDefault": false,
-    "importModuleSpecifierEnding": ".js"
+    "nullableByDefault": false
   },
   "compilerOptions": {
     "outDir": "dist",

examples/express-graphql-http/tsconfig.json

@@ -1,7 +1,6 @@
 {
   "grats": {
-    "nullableByDefault": false,
-    "importModuleSpecifierEnding": ".js"
+    "nullableByDefault": false
   },
   "compilerOptions": {
     "outDir": "dist",

examples/incremental-migration/tsconfig.json

@@ -4,8 +4,7 @@
     "tsSchema": "./schemas/gratsGeneratedSchema.ts",
     "graphqlSchema": "gratsSchema.graphql",
     "tsSchemaHeader": "// DO NOT USE DIRECTLY. Prefer the merged schema in `./mergedSchema.ts`.",
-    "schemaHeader": "# DO NOT USE DIRECTLY. Prefer the merged schema in `../schema.graphql`.",
-    "importModuleSpecifierEnding": ".js"
+    "schemaHeader": "# DO NOT USE DIRECTLY. Prefer the merged schema in `../schema.graphql`."
   },
   "compilerOptions": {
     "outDir": "dist",

examples/production-app/tsconfig.json

@@ -1,7 +1,5 @@
 {
-  "grats": {
-    "importModuleSpecifierEnding": ".js"
-  },
+  "grats": {},
   "compilerOptions": {
     "outDir": "dist",
     "module": "NodeNext",

examples/strict-semantic-nullability/tsconfig.json

@@ -1,8 +1,7 @@
 {
   "grats": {
     "nullableByDefault": true,
-    "strictSemanticNullability": true,
-    "importModuleSpecifierEnding": ".js"
+    "strictSemanticNullability": true
   },
   "compilerOptions": {
     "outDir": "dist",

examples/yoga/tsconfig.json

@@ -1,7 +1,6 @@
 {
   "grats": {
-    "nullableByDefault": false,
-    "importModuleSpecifierEnding": ".js"
+    "nullableByDefault": false
   },
   "compilerOptions": {
     "outDir": "dist",

llm-docs/getting-started/configuration.md

@@ -122,11 +122,9 @@ Default:
 
 ### "importModuleSpecifierEnding": string
 
-This option allows you configure an extension that will be appended to the end of all import paths in the generated TypeScript schema file.
+The extension appended to the end of all import paths in the generated TypeScript schema file. Defaults to `.js` which works for both CommonJS and ES module projects. Set to an empty string to omit the extension.
 
-When building a package that uses ES modules, import paths must not omit the file extension. In TypeScript code this generally means import paths must end with `.js`. If set to null, no ending will be appended.
-
-Default: `""`
+Default: `".js"`
 
 * * *
 

scripts/TGratsConfig.ts

@@ -71,11 +71,9 @@ export type GratsConfig = {
    */
   tsClientEnumsHeader: string | null;
   /**
-   * This option allows you configure an extension that will be appended to
-   * the end of all import paths in the generated TypeScript schema file.
-   * When building a package that uses ES modules, import paths must not
-   * omit the file extension. In TypeScript code this generally means import
-   * paths must end with `.js`. If set to null, no ending will be appended.
+   * The extension appended to the end of all import paths in the generated
+   * TypeScript schema file. Defaults to `.js` which works for both CommonJS
+   * and ES module projects. Set to an empty string to omit the extension.
    */
   importModuleSpecifierEnding: string;
   /**

src/configSpecRaw.json

@@ -56,10 +56,10 @@
       "default": "/**\n * TypeScript enum definitions generated by Grats (https://grats.capt.dev)\n * Do not manually edit. Regenerate by running `npx grats`.\n */"
     },
     "importModuleSpecifierEnding": {
-      "description": "This option allows you configure an extension that will be appended to the end of all import paths in the generated TypeScript schema file.\nWhen building a package that uses ES modules, import paths must not omit the file extension. In TypeScript code this generally means import paths must end with `.js`. If set to null, no ending will be appended.",
+      "description": "The extension appended to the end of all import paths in the generated TypeScript schema file. Defaults to `.js` which works for both CommonJS and ES module projects. Set to an empty string to omit the extension.",
       "type": { "kind": "string" },
       "nullable": false,
-      "default": ""
+      "default": ".js"
     },
     "EXPERIMENTAL__emitMetadata": {
       "description": "EXPERIMENTAL: THIS OPTION WILL BE RENAMED OR REMOVED IN A FUTURE RELEASE\nEmit a JSON file alongside the generated schema file which contains the metadata containing information about the resolvers.",

src/tests/configParserFixtures/empty.json.expected.md

@@ -21,7 +21,7 @@
   "schemaHeader": "# Schema generated by Grats (https://grats.capt.dev)\n# Do not manually edit. Regenerate by running `npx grats`.",
   "tsSchemaHeader": "/**\n * Executable schema generated by Grats (https://grats.capt.dev)\n * Do not manually edit. Regenerate by running `npx grats`.\n */",
   "tsClientEnumsHeader": "/**\n * TypeScript enum definitions generated by Grats (https://grats.capt.dev)\n * Do not manually edit. Regenerate by running `npx grats`.\n */",
-  "importModuleSpecifierEnding": "",
+  "importModuleSpecifierEnding": ".js",
   "EXPERIMENTAL__emitMetadata": false,
   "EXPERIMENTAL__emitResolverMap": false
 }

src/tests/configParserFixtures/experimentalField.json.expected.md

@@ -23,7 +23,7 @@
   "schemaHeader": "# Schema generated by Grats (https://grats.capt.dev)\n# Do not manually edit. Regenerate by running `npx grats`.",
   "tsSchemaHeader": "/**\n * Executable schema generated by Grats (https://grats.capt.dev)\n * Do not manually edit. Regenerate by running `npx grats`.\n */",
   "tsClientEnumsHeader": "/**\n * TypeScript enum definitions generated by Grats (https://grats.capt.dev)\n * Do not manually edit. Regenerate by running `npx grats`.\n */",
-  "importModuleSpecifierEnding": "",
+  "importModuleSpecifierEnding": ".js",
   "EXPERIMENTAL__emitMetadata": true,
   "EXPERIMENTAL__emitResolverMap": false
 }

src/tests/configParserFixtures/multiLineHeader.json.expected.md

@@ -23,7 +23,7 @@
   "schemaHeader": "/**\n * An amazing GraphQL schema\n */",
   "tsSchemaHeader": "/**\n * Executable schema generated by Grats (https://grats.capt.dev)\n * Do not manually edit. Regenerate by running `npx grats`.\n */",
   "tsClientEnumsHeader": "/**\n * TypeScript enum definitions generated by Grats (https://grats.capt.dev)\n * Do not manually edit. Regenerate by running `npx grats`.\n */",
-  "importModuleSpecifierEnding": "",
+  "importModuleSpecifierEnding": ".js",
   "EXPERIMENTAL__emitMetadata": false,
   "EXPERIMENTAL__emitResolverMap": false
 }

src/tests/fixtures/arguments/CustomScalarArgument.ts.expected.md

@@ -31,7 +31,7 @@ type SomeType {
 
 ```ts
 import type { GqlScalar } from "grats";
-import type { MyString as MyStringInternal } from "./CustomScalarArgument";
+import type { MyString as MyStringInternal } from "./CustomScalarArgument.js";
 import { GraphQLSchema, GraphQLScalarType, GraphQLObjectType, GraphQLString, GraphQLNonNull } from "graphql";
 export type SchemaConfig = {
     scalars: {

src/tests/fixtures/custom_scalars/DefineCustomScalar.ts.expected.md

@@ -29,7 +29,7 @@ type SomeType {
 
 ```ts
 import type { GqlScalar } from "grats";
-import type { MyUrl as MyUrlInternal } from "./DefineCustomScalar";
+import type { MyUrl as MyUrlInternal } from "./DefineCustomScalar.js";
 import { GraphQLSchema, GraphQLScalarType, GraphQLObjectType, GraphQLString } from "graphql";
 export type SchemaConfig = {
     scalars: {

src/tests/fixtures/custom_scalars/DefineCustomScalarWithDescription.ts.expected.md

@@ -33,7 +33,7 @@ type SomeType {
 
 ```ts
 import type { GqlScalar } from "grats";
-import type { MyUrl as MyUrlInternal } from "./DefineCustomScalarWithDescription";
+import type { MyUrl as MyUrlInternal } from "./DefineCustomScalarWithDescription.js";
 import { GraphQLSchema, GraphQLScalarType, GraphQLObjectType, GraphQLString } from "graphql";
 export type SchemaConfig = {
     scalars: {

src/tests/fixtures/custom_scalars/DefineRenamedCustomScalar.ts.expected.md

@@ -29,7 +29,7 @@ type SomeType {
 
 ```ts
 import type { GqlScalar } from "grats";
-import type { MyUrl as CustomNameInternal } from "./DefineRenamedCustomScalar";
+import type { MyUrl as CustomNameInternal } from "./DefineRenamedCustomScalar.js";
 import { GraphQLSchema, GraphQLScalarType, GraphQLObjectType, GraphQLString } from "graphql";
 export type SchemaConfig = {
     scalars: {

src/tests/fixtures/custom_scalars/SpecifiedBy.ts.expected.md

@@ -22,7 +22,7 @@ scalar UUID @specifiedBy(url: "https://tools.ietf.org/html/rfc4122")
 
 ```ts
 import type { GqlScalar } from "grats";
-import type { UUID as UUIDInternal } from "./SpecifiedBy";
+import type { UUID as UUIDInternal } from "./SpecifiedBy.js";
 import { GraphQLSchema, GraphQLScalarType } from "graphql";
 export type SchemaConfig = {
     scalars: {

src/tests/fixtures/derived_context/derivedContextPromiseValid.ts.expected.md

@@ -39,7 +39,7 @@ type Query {
 
 ```ts
 import { GraphQLSchema, GraphQLObjectType, GraphQLString } from "graphql";
-import { greeting as queryGreetingResolver, createDerivedContext } from "./derivedContextPromiseValid";
+import { greeting as queryGreetingResolver, createDerivedContext } from "./derivedContextPromiseValid.js";
 export function getSchema(): GraphQLSchema {
     const QueryType: GraphQLObjectType = new GraphQLObjectType({
         name: "Query",

src/tests/fixtures/derived_context/derivedContextUsedMultipleTimes.ts.expected.md

@@ -46,7 +46,7 @@ type Query {
 
 ```ts
 import { GraphQLSchema, GraphQLObjectType, GraphQLString } from "graphql";
-import { farewell as queryFarewellResolver, greetingContext, greeting as queryGreetingResolver } from "./derivedContextUsedMultipleTimes";
+import { farewell as queryFarewellResolver, greetingContext, greeting as queryGreetingResolver } from "./derivedContextUsedMultipleTimes.js";
 export function getSchema(): GraphQLSchema {
     const QueryType: GraphQLObjectType = new GraphQLObjectType({
         name: "Query",

src/tests/fixtures/derived_context/nestedAsyncDerivedContext.ts.expected.md

@@ -49,7 +49,7 @@ type Query {
 
 ```ts
 import { GraphQLSchema, GraphQLObjectType, GraphQLString } from "graphql";
-import { greeting as queryGreetingResolver, createDerivedContext2, createDerivedContext1 } from "./nestedAsyncDerivedContext";
+import { greeting as queryGreetingResolver, createDerivedContext2, createDerivedContext1 } from "./nestedAsyncDerivedContext.js";
 export function getSchema(): GraphQLSchema {
     const QueryType: GraphQLObjectType = new GraphQLObjectType({
         name: "Query",

src/tests/fixtures/derived_context/simpleDerivedContext.ts.expected.md

@@ -40,7 +40,7 @@ type Query {
 
 ```ts
 import { GraphQLSchema, GraphQLObjectType, GraphQLString } from "graphql";
-import { greeting as queryGreetingResolver, createDerivedContext } from "./simpleDerivedContext";
+import { greeting as queryGreetingResolver, createDerivedContext } from "./simpleDerivedContext.js";
 export function getSchema(): GraphQLSchema {
     const QueryType: GraphQLObjectType = new GraphQLObjectType({
         name: "Query",

src/tests/fixtures/derived_context/simpleDerivedContextNoArgs.ts.expected.md

@@ -40,7 +40,7 @@ type Query {
 
 ```ts
 import { GraphQLSchema, GraphQLObjectType, GraphQLString } from "graphql";
-import { greeting as queryGreetingResolver, createDerivedContext } from "./simpleDerivedContextNoArgs";
+import { greeting as queryGreetingResolver, createDerivedContext } from "./simpleDerivedContextNoArgs.js";
 export function getSchema(): GraphQLSchema {
     const QueryType: GraphQLObjectType = new GraphQLObjectType({
         name: "Query",

src/tests/fixtures/directives/directiveOnArgumentDefinition.ts.expected.md

@@ -39,7 +39,7 @@ type Query {
 
 ```ts
 import { GraphQLSchema, GraphQLDirective, DirectiveLocation, GraphQLNonNull, GraphQLInt, specifiedDirectives, GraphQLObjectType, GraphQLString } from "graphql";
-import { likes as queryLikesResolver } from "./directiveOnArgumentDefinition";
+import { likes as queryLikesResolver } from "./directiveOnArgumentDefinition.js";
 export function getSchema(): GraphQLSchema {
     const QueryType: GraphQLObjectType = new GraphQLObjectType({
         name: "Query",

src/tests/fixtures/directives/directiveOnFieldDefinition.ts.expected.md

@@ -38,7 +38,7 @@ type Query {
 
 ```ts
 import { GraphQLSchema, GraphQLDirective, DirectiveLocation, GraphQLNonNull, GraphQLInt, specifiedDirectives, GraphQLObjectType, GraphQLString } from "graphql";
-import { likes as queryLikesResolver } from "./directiveOnFieldDefinition";
+import { likes as queryLikesResolver } from "./directiveOnFieldDefinition.js";
 export function getSchema(): GraphQLSchema {
     const QueryType: GraphQLObjectType = new GraphQLObjectType({
         name: "Query",

src/tests/fixtures/directives/directiveOnScalar.ts.expected.md

@@ -32,7 +32,7 @@ scalar MyScalar @max(foo: 10)
 
 ```ts
 import type { GqlScalar } from "grats";
-import type { MyScalar as MyScalarInternal } from "./directiveOnScalar";
+import type { MyScalar as MyScalarInternal } from "./directiveOnScalar.js";
 import { GraphQLSchema, GraphQLDirective, DirectiveLocation, GraphQLNonNull, GraphQLInt, specifiedDirectives, GraphQLScalarType } from "graphql";
 export type SchemaConfig = {
     scalars: {

src/tests/fixtures/directives/undefinedDirectiveWithoutArgs.ts.expected.md

@@ -26,7 +26,7 @@ type Query {
 
 ```ts
 import { GraphQLSchema, GraphQLObjectType, GraphQLString } from "graphql";
-import { myQueryField as queryMyQueryFieldResolver } from "./undefinedDirectiveWithoutArgs";
+import { myQueryField as queryMyQueryFieldResolver } from "./undefinedDirectiveWithoutArgs.js";
 export function getSchema(): GraphQLSchema {
     const QueryType: GraphQLObjectType = new GraphQLObjectType({
         name: "Query",

src/tests/fixtures/enums/NonNullEnumDefault.ts.expected.md

@@ -34,7 +34,7 @@ type Query {
 
 ```ts
 import { GraphQLSchema, GraphQLObjectType, GraphQLString, GraphQLNonNull, GraphQLEnumType } from "graphql";
-import { hello as queryHelloResolver } from "./NonNullEnumDefault";
+import { hello as queryHelloResolver } from "./NonNullEnumDefault.js";
 export function getSchema(): GraphQLSchema {
     const GreetingOptionsType: GraphQLEnumType = new GraphQLEnumType({
         name: "GreetingOptions",

src/tests/fixtures/enums/NonNullEnumDefaultInInputObject.ts.expected.md

@@ -45,7 +45,7 @@ type Query {
 
 ```ts
 import { GraphQLSchema, GraphQLObjectType, GraphQLString, GraphQLNonNull, GraphQLInputObjectType, GraphQLEnumType } from "graphql";
-import { hello as queryHelloResolver } from "./NonNullEnumDefaultInInputObject";
+import { hello as queryHelloResolver } from "./NonNullEnumDefaultInInputObject.js";
 export function getSchema(): GraphQLSchema {
     const GreetingOptionsType: GraphQLEnumType = new GraphQLEnumType({
         name: "GreetingOptions",

src/tests/fixtures/enums/NonNullPluralEnumDefaults.ts.expected.md

@@ -36,7 +36,7 @@ type Query {
 
 ```ts
 import { GraphQLSchema, GraphQLObjectType, GraphQLString, GraphQLNonNull, GraphQLList, GraphQLEnumType } from "graphql";
-import { hello as queryHelloResolver } from "./NonNullPluralEnumDefaults";
+import { hello as queryHelloResolver } from "./NonNullPluralEnumDefaults.js";
 export function getSchema(): GraphQLSchema {
     const GreetingOptionsType: GraphQLEnumType = new GraphQLEnumType({
         name: "GreetingOptions",

src/tests/fixtures/enums/NonNullTsEnumDefault.ts.expected.md

@@ -41,7 +41,7 @@ type Query {
 
 ```ts
 import { GraphQLSchema, GraphQLObjectType, GraphQLString, GraphQLNonNull, GraphQLEnumType } from "graphql";
-import { hello as queryHelloResolver } from "./NonNullTsEnumDefault";
+import { hello as queryHelloResolver } from "./NonNullTsEnumDefault.js";
 export function getSchema(): GraphQLSchema {
     const GreetingOptionsType: GraphQLEnumType = new GraphQLEnumType({
         name: "GreetingOptions",

src/tests/fixtures/enums/NonNullTsEnumDefaultStringLiteral.ts.expected.md

@@ -41,7 +41,7 @@ type Query {
 
 ```ts
 import { GraphQLSchema, GraphQLObjectType, GraphQLString, GraphQLNonNull, GraphQLEnumType } from "graphql";
-import { hello as queryHelloResolver } from "./NonNullTsEnumDefaultStringLiteral";
+import { hello as queryHelloResolver } from "./NonNullTsEnumDefaultStringLiteral.js";
 export function getSchema(): GraphQLSchema {
     const GreetingOptionsType: GraphQLEnumType = new GraphQLEnumType({
         name: "GreetingOptions",

src/tests/fixtures/examples/playground.ts.expected.md

@@ -60,7 +60,7 @@ type User {
 
 ```ts
 import { GraphQLSchema, GraphQLObjectType, GraphQLString, GraphQLNonNull } from "graphql";
-import { getUser as someTypeGetUserResolver } from "./playground";
+import { getUser as someTypeGetUserResolver } from "./playground.js";
 export function getSchema(): GraphQLSchema {
     const UserType: GraphQLObjectType = new GraphQLObjectType({
         name: "User",

src/tests/fixtures/examples/readme.ts.expected.md

@@ -54,7 +54,7 @@ type User {
 
 ```ts
 import { GraphQLSchema, GraphQLObjectType, GraphQLString, GraphQLNonNull } from "graphql";
-import { me as queryMeResolver, viewer as queryViewerResolver } from "./readme";
+import { me as queryMeResolver, viewer as queryViewerResolver } from "./readme.js";
 export function getSchema(): GraphQLSchema {
     const UserType: GraphQLObjectType = new GraphQLObjectType({
         name: "User",

src/tests/fixtures/extend_interface/addStringFieldToInterface.ts.expected.md

@@ -57,7 +57,7 @@ type User implements IPerson {
 
 ```ts
 import { GraphQLSchema, GraphQLInterfaceType, GraphQLString, GraphQLObjectType } from "graphql";
-import { greeting as adminGreetingResolver, greeting as userGreetingResolver } from "./addStringFieldToInterface";
+import { greeting as adminGreetingResolver, greeting as userGreetingResolver } from "./addStringFieldToInterface.js";
 export function getSchema(): GraphQLSchema {
     const IPersonType: GraphQLInterfaceType = new GraphQLInterfaceType({
         name: "IPerson",

src/tests/fixtures/extend_interface/addStringFieldToInterfaceImplementedByInterface.ts.expected.md

@@ -63,7 +63,7 @@ type User implements IPerson & IThing {
 
 ```ts
 import { GraphQLSchema, GraphQLInterfaceType, GraphQLString, GraphQLObjectType } from "graphql";
-import { greeting as adminGreetingResolver, greeting as userGreetingResolver } from "./addStringFieldToInterfaceImplementedByInterface";
+import { greeting as adminGreetingResolver, greeting as userGreetingResolver } from "./addStringFieldToInterfaceImplementedByInterface.js";
 export function getSchema(): GraphQLSchema {
     const IThingType: GraphQLInterfaceType = new GraphQLInterfaceType({
         name: "IThing",

src/tests/fixtures/extend_type/addDeprecatedField.ts.expected.md

@@ -31,7 +31,7 @@ type SomeType {
 
 ```ts
 import { GraphQLSchema, GraphQLObjectType, GraphQLString } from "graphql";
-import { greeting as someTypeGreetingResolver } from "./addDeprecatedField";
+import { greeting as someTypeGreetingResolver } from "./addDeprecatedField.js";
 export function getSchema(): GraphQLSchema {
     const SomeTypeType: GraphQLObjectType = new GraphQLObjectType({
         name: "SomeType",

src/tests/fixtures/extend_type/addFieldWithArguments.ts.expected.md

@@ -28,7 +28,7 @@ type SomeType {
 
 ```ts
 import { GraphQLSchema, GraphQLObjectType, GraphQLString, GraphQLNonNull } from "graphql";
-import { greeting as someTypeGreetingResolver } from "./addFieldWithArguments";
+import { greeting as someTypeGreetingResolver } from "./addFieldWithArguments.js";
 export function getSchema(): GraphQLSchema {
     const SomeTypeType: GraphQLObjectType = new GraphQLObjectType({
         name: "SomeType",

src/tests/fixtures/extend_type/addFieldWithDescription.ts.expected.md

@@ -32,7 +32,7 @@ type SomeType {
 
 ```ts
 import { GraphQLSchema, GraphQLObjectType, GraphQLString } from "graphql";
-import { greeting as someTypeGreetingResolver } from "./addFieldWithDescription";
+import { greeting as someTypeGreetingResolver } from "./addFieldWithDescription.js";
 export function getSchema(): GraphQLSchema {
     const SomeTypeType: GraphQLObjectType = new GraphQLObjectType({
         name: "SomeType",

src/tests/fixtures/extend_type/addRenamedFieldToSomeType.ts.expected.md

@@ -28,7 +28,7 @@ type SomeType {
 
 ```ts
 import { GraphQLSchema, GraphQLObjectType, GraphQLString } from "graphql";
-import { greeting as someTypeHelloResolver } from "./addRenamedFieldToSomeType";
+import { greeting as someTypeHelloResolver } from "./addRenamedFieldToSomeType.js";
 export function getSchema(): GraphQLSchema {
     const SomeTypeType: GraphQLObjectType = new GraphQLObjectType({
         name: "SomeType",

src/tests/fixtures/extend_type/addStringFieldToSomeType.ts.expected.md

@@ -28,7 +28,7 @@ type SomeType {
 
 ```ts
 import { GraphQLSchema, GraphQLObjectType, GraphQLString } from "graphql";
-import { greeting as someTypeGreetingResolver } from "./addStringFieldToSomeType";
+import { greeting as someTypeGreetingResolver } from "./addStringFieldToSomeType.js";
 export function getSchema(): GraphQLSchema {
     const SomeTypeType: GraphQLObjectType = new GraphQLObjectType({
         name: "SomeType",

src/tests/fixtures/extend_type/defaultExport.ts.expected.md

@@ -27,7 +27,7 @@ type SomeType {
 ### TypeScript
 
 ```ts
-import someTypeGreetingResolver from "./defaultExport";
+import someTypeGreetingResolver from "./defaultExport.js";
 import { GraphQLSchema, GraphQLObjectType, GraphQLString } from "graphql";
 export function getSchema(): GraphQLSchema {
     const SomeTypeType: GraphQLObjectType = new GraphQLObjectType({

src/tests/fixtures/extend_type/fieldAsExportedArrowFunction.ts.expected.md

@@ -28,7 +28,7 @@ type SomeType {
 
 ```ts
 import { GraphQLSchema, GraphQLObjectType, GraphQLString } from "graphql";
-import { greeting as someTypeGreetingResolver } from "./fieldAsExportedArrowFunction";
+import { greeting as someTypeGreetingResolver } from "./fieldAsExportedArrowFunction.js";
 export function getSchema(): GraphQLSchema {
     const SomeTypeType: GraphQLObjectType = new GraphQLObjectType({
         name: "SomeType",