Change importModuleSpecifierEnding default to .js

Change the default value of `importModuleSpecifierEnding` from `""`
to `".js"`. This makes the generated TypeScript schema file work
correctly for both CommonJS and ES module projects out of the box,
since `.js` extensions are valid in CJS and required in ESM.

- Update configSpecRaw.json default and description
- Update generated TGratsConfig.ts types
- Remove now-redundant explicit `.js` setting from example tsconfigs
- Set explicit `""` for next-js (uses webpack bundler resolution)
- Update all test snapshots to reflect new default

Author: captbaritone

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/next-js/tsconfig.json

@@ -1,7 +1,7 @@
 {
   "grats": {
     "nullableByDefault": false,
-    "importModuleSpecifierEnding": ".js"
+    "importModuleSpecifierEnding": ""
   },
   "compilerOptions": {
     "target": "es5",

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

@@ -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;
   /**

scripts/TGratsConfig.ts

@@ -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.",