rename develop.js => dev

Author: yaacovCR

resources/build-npm.ts

@@ -88,7 +88,7 @@ async function buildPackage(outDir: string): Promise<void> {
     extension: '.js',
   });
 
-  const devHelper = path.join(outDir, 'development.js');
+  const devHelper = path.join(outDir, 'dev/index.js');
 
   for (const prodFile of emittedTSFiles) {
     const { dir, base } = path.parse(prodFile);
@@ -107,8 +107,7 @@ async function buildPackage(outDir: string): Promise<void> {
       `${dir}/${name}`,
     );
 
-    const lines =
-      ext === 'd.ts' ? [] : [`import '${relativePathToProd}/development.js';`];
+    const lines = ext === 'd.ts' ? [] : [`import '${relativePathToProd}/dev';`];
     lines.push(
       `export * from '${relativePathToProd}/${relativePathAndName}.js';`,
     );

src/dev/README.md

@@ -0,0 +1,10 @@
+## GraphQL Dev
+
+The `graphql/dev` module is responsible for enabling development mode.
+
+In development mode, GraphQL.js provides additional checks to help avoid developer errors.
+
+```js
+import 'graphql/dev'; // ES6
+require('graphql/dev'); // CommonJS
+```

src/development.ts renamed to src/dev/index.ts

@@ -1,6 +1,6 @@
-import { inspect } from './jsutils/inspect.js';
-import type { Constructor } from './jsutils/instanceOf.js';
-import { symbolForGraphQLInstanceOfCheck } from './jsutils/instanceOf.js';
+import { inspect } from '../jsutils/inspect.js';
+import type { Constructor } from '../jsutils/instanceOf.js';
+import { symbolForGraphQLInstanceOfCheck } from '../jsutils/instanceOf.js';
 
 /**
  * An additional check to be included within instanceOf warning when

src/jsutils/__tests__/instanceOf-test.ts

@@ -1,7 +1,7 @@
 import { expect } from 'chai';
 import { describe, it } from 'mocha';
 
-import { developmentInstanceOfCheck } from '../../development.js';
+import { developmentInstanceOfCheck } from '../../dev/index.js';
 
 import { symbolForGraphQLInstanceOfCheck } from '../instanceOf.js';
 

src/jsutils/instanceOf.ts

@@ -7,7 +7,7 @@ export const symbolForGraphQLInstanceOfCheck = Symbol.for(
  * which throws on multiple versions of graphql-js.
  *
  * This additional check will be included:
- * 1. if 'graphql/development.js' is imported explicitly prior to all
+ * 1. if 'graphql/dev' is imported explicitly prior to all
  *    other imports from this library, or
  * 2. if the "development" condition is set.
  */

website/pages/docs/development-mode.mdx

@@ -16,7 +16,7 @@ Also, unlike earlier versions, development mode is not configured by use of
 environment variables, which are accessed in disparate ways in varying environments.
 In particular, the `NODE_ENV` environment variable now has no effect on triggering
 development mode. Rather, development mode is either enabled:
-1. explicitly, by importing `graphql/development.js` prior to other Graphql.JS imports or
+1. explicitly, by importing `graphql/dev` prior to other Graphql.JS imports or
 2. implicitly, by setting the 'development' condition, which is possible only in
    environments that support `package.json` conditional exports and custom conditions.
 
@@ -60,20 +60,20 @@ that should catch most cases of multiple GraphQL.js modules being used in the sa
 This additional validation is unnecessary in production, where the GraphQL.js library is
 expected to be have been setup correctly as a single module. So as to avoid the performance
 and bundle size overhead this check entails, it is only included when the `development`
-exports condition is explicitly enabled or when the `graphql/development.js` module is
+exports condition is explicitly enabled or when the `graphql/dev` module is
 explicitly imported before any other GraphQL.JS import.
 
 ## Enabling Development Mode
 
 ### A Catch-All Option: Explicit Enabling of Development Mode
 
-Development mode is activated by importing the `graphql/development.js` module before
+Development mode is activated by importing the `graphql/dev` module before
 any other GraphQL.js import. Introducing a new bootstrapping entrypoint simplifies this
 workflow:
 
 ```js
 // bootstrap.js
-import 'graphql/development.js';
+import 'graphql/dev';
 import './path/to/my/original-entry-point.js';
 ```
 
@@ -83,7 +83,7 @@ The bootstrapping file can be used to enable development mode conditionally:
 import process from 'node:process';
 // bootstrap.js
 if (process.env.NODE_ENV === 'development') {
-  await import('graphql/development.js');
+  await import('graphql/dev');
 }
 import './path/to/my/entry.js';
 ```