@graphql-codegen/cli 6.0.2-alpha-20251107100146-ab5264c4ff8fd142a45caf57bfe2e845bf83b2d1 → 6.1.0-alpha-20251107131717-adc4d901f6e53e023001b84e0cef353e6dad8629

package/cjs/codegen.js

@@ -51,7 +51,7 @@ function createCache() {
         return value;
     };
 }
-async function executeCodegen(input) {
+async function executeCodegen(input, options = { onlyGeneratesKeys: {} }) {
     const context = (0, config_js_1.ensureContext)(input);
     const config = context.getConfig();
     const pluginContext = context.getPluginContext();
@@ -150,7 +150,14 @@ async function executeCodegen(input) {
         {
             title: 'Generate outputs',
             task: (ctx, task) => {
-                const generateTasks = Object.keys(generates).map(filename => {
+                const originalGeneratesKeys = Object.keys(generates);
+                const foundGeneratesKeys = originalGeneratesKeys.filter(generatesKey => options.onlyGeneratesKeys[generatesKey]);
+                const effectiveGeneratesKeys = foundGeneratesKeys.length === 0 ? originalGeneratesKeys : foundGeneratesKeys;
+                const hasFilteredDownGeneratesKeys = originalGeneratesKeys.length > effectiveGeneratesKeys.length;
+                if (hasFilteredDownGeneratesKeys) {
+                    (0, debugging_js_1.debugLog)(`[CLI] Generating partial config:\n${effectiveGeneratesKeys.map(key => `- ${key}`).join('\n')}`);
+                }
+                const generateTasks = effectiveGeneratesKeys.map(filename => {
                     const outputConfig = generates[filename];
                     const hasPreset = !!outputConfig.preset;
                     const title = `Generate to ${filename}`;

package/cjs/utils/patterns.js

@@ -39,9 +39,12 @@ exports.allAffirmativePatternsFromPatternSets = allAffirmativePatternsFromPatter
  *    a match even if it would be negated by some pattern in documents or schemas
  *  * The trigger returns true if any output target's local patterns result in
  *    a match, after considering the precedence of any global and local negations
+ *
+ * The result is a function that when given an absolute path,
+ * it will tell which generates blocks' keys are affected so we can re-run for those keys
  */
 const makeShouldRebuild = ({ globalPatternSet, localPatternSets, }) => {
-    const localMatchers = localPatternSets.map(localPatternSet => {
+    const localMatchers = Object.entries(localPatternSets).map(([generatesPath, localPatternSet]) => {
         return (path) => {
             // Is path negated by any negating watch pattern?
             if (matchesAnyNegatedPattern(path, [...globalPatternSet.watch.negated, ...localPatternSet.watch.negated])) {
@@ -54,7 +57,7 @@ const makeShouldRebuild = ({ globalPatternSet, localPatternSets, }) => {
                 ...localPatternSet.watch.affirmative,
             ])) {
                 // Immediately return true: Watch pattern takes priority, even if documents or schema would negate it
-                return true;
+                return generatesPath;
             }
             // Does path match documents patterns (without being negated)?
             if (matchesAnyAffirmativePattern(path, [
@@ -62,7 +65,7 @@ const makeShouldRebuild = ({ globalPatternSet, localPatternSets, }) => {
                 ...localPatternSet.documents.affirmative,
             ]) &&
                 !matchesAnyNegatedPattern(path, [...globalPatternSet.documents.negated, ...localPatternSet.documents.negated])) {
-                return true;
+                return generatesPath;
             }
             // Does path match schemas patterns (without being negated)?
             if (matchesAnyAffirmativePattern(path, [
@@ -70,22 +73,25 @@ const makeShouldRebuild = ({ globalPatternSet, localPatternSets, }) => {
                 ...localPatternSet.schemas.affirmative,
             ]) &&
                 !matchesAnyNegatedPattern(path, [...globalPatternSet.schemas.negated, ...localPatternSet.schemas.negated])) {
-                return true;
+                return generatesPath;
             }
             // Otherwise, there is no match
             return false;
         };
     });
-    /**
-     * Return `true` if `path` should trigger a rebuild
-     */
     return ({ path: absolutePath }) => {
         if (!(0, path_1.isAbsolute)(absolutePath)) {
             throw new Error('shouldRebuild trigger should be called with absolute path');
         }
         const path = (0, path_1.relative)(process.cwd(), absolutePath);
-        const shouldRebuild = localMatchers.some(matcher => matcher(path));
-        return shouldRebuild;
+        const generatesKeysToRebuild = {};
+        for (const matcher of localMatchers) {
+            const result = matcher(path);
+            if (result) {
+                generatesKeysToRebuild[result] = true;
+            }
+        }
+        return generatesKeysToRebuild;
     };
 };
 exports.makeShouldRebuild = makeShouldRebuild;

package/cjs/utils/watcher.js

@@ -26,10 +26,14 @@ const createWatcher = (initialContext, onNext) => {
     (0, debugging_js_1.debugLog)(`[Watcher] Starting watcher...`);
     let config = initialContext.getConfig();
     const globalPatternSet = (0, patterns_js_1.makeGlobalPatternSet)(initialContext);
-    const localPatternSets = Object.keys(config.generates)
-        .map(filename => (0, plugin_helpers_1.normalizeOutputParam)(config.generates[filename]))
-        .map(conf => (0, patterns_js_1.makeLocalPatternSet)(conf));
-    const allAffirmativePatterns = (0, patterns_js_1.allAffirmativePatternsFromPatternSets)([globalPatternSet, ...localPatternSets]);
+    const localPatternSetArray = [];
+    const localPatternSets = Object.entries(config.generates).reduce((res, [filename, conf]) => {
+        const patternSet = (0, patterns_js_1.makeLocalPatternSet)((0, plugin_helpers_1.normalizeOutputParam)(conf));
+        res[filename] = patternSet;
+        localPatternSetArray.push(patternSet);
+        return res;
+    }, {});
+    const allAffirmativePatterns = (0, patterns_js_1.allAffirmativePatternsFromPatternSets)([globalPatternSet, ...localPatternSetArray]);
     const shouldRebuild = (0, patterns_js_1.makeShouldRebuild)({ globalPatternSet, localPatternSets });
     let watcherSubscription;
     const runWatcher = async (abortSignal) => {
@@ -45,9 +49,9 @@ const createWatcher = (initialContext, onNext) => {
         }
         (0, debugging_js_1.debugLog)(`[Watcher] Parcel watcher loaded...`);
         let isShutdown = false;
-        const debouncedExec = (0, debounce_1.default)(() => {
+        const debouncedExec = (0, debounce_1.default)((generatesKeysToRebuild) => {
             if (!isShutdown) {
-                (0, codegen_js_1.executeCodegen)(initialContext)
+                (0, codegen_js_1.executeCodegen)(initialContext, { onlyGeneratesKeys: generatesKeysToRebuild })
                     .then(({ result, error }) => {
                     // FIXME: this is a quick fix to stop `onNext` (writeOutput) from
                     // removing all files when there is an error.
@@ -86,11 +90,11 @@ const createWatcher = (initialContext, onNext) => {
             }
         }
         watcherSubscription = await parcelWatcher.subscribe(watchDirectory, async (_, events) => {
-            // it doesn't matter what has changed, need to run whole process anyway
             await Promise.all(
             // NOTE: @parcel/watcher always provides path as an absolute path
             events.map(async ({ type: eventName, path }) => {
-                if (!shouldRebuild({ path })) {
+                const generatesKeysToRebuild = shouldRebuild({ path });
+                if (Object.keys(generatesKeysToRebuild).length === 0) {
                     return;
                 }
                 (0, hooks_js_1.lifecycleHooks)(config.hooks).onWatchTriggered(eventName, path);
@@ -111,7 +115,7 @@ const createWatcher = (initialContext, onNext) => {
                     config = newParsedConfig;
                     initialContext.updateConfig(config);
                 }
-                debouncedExec();
+                debouncedExec(generatesKeysToRebuild);
             }));
         }, { ignore: ignored });
         (0, debugging_js_1.debugLog)(`[Watcher] Started`);

package/esm/codegen.js

@@ -47,7 +47,7 @@ function createCache() {
         return value;
     };
 }
-export async function executeCodegen(input) {
+export async function executeCodegen(input, options = { onlyGeneratesKeys: {} }) {
     const context = ensureContext(input);
     const config = context.getConfig();
     const pluginContext = context.getPluginContext();
@@ -146,7 +146,14 @@ export async function executeCodegen(input) {
         {
             title: 'Generate outputs',
             task: (ctx, task) => {
-                const generateTasks = Object.keys(generates).map(filename => {
+                const originalGeneratesKeys = Object.keys(generates);
+                const foundGeneratesKeys = originalGeneratesKeys.filter(generatesKey => options.onlyGeneratesKeys[generatesKey]);
+                const effectiveGeneratesKeys = foundGeneratesKeys.length === 0 ? originalGeneratesKeys : foundGeneratesKeys;
+                const hasFilteredDownGeneratesKeys = originalGeneratesKeys.length > effectiveGeneratesKeys.length;
+                if (hasFilteredDownGeneratesKeys) {
+                    debugLog(`[CLI] Generating partial config:\n${effectiveGeneratesKeys.map(key => `- ${key}`).join('\n')}`);
+                }
+                const generateTasks = effectiveGeneratesKeys.map(filename => {
                     const outputConfig = generates[filename];
                     const hasPreset = !!outputConfig.preset;
                     const title = `Generate to ${filename}`;

package/esm/utils/patterns.js

@@ -34,9 +34,12 @@ export const allAffirmativePatternsFromPatternSets = (patternSets) => {
  *    a match even if it would be negated by some pattern in documents or schemas
  *  * The trigger returns true if any output target's local patterns result in
  *    a match, after considering the precedence of any global and local negations
+ *
+ * The result is a function that when given an absolute path,
+ * it will tell which generates blocks' keys are affected so we can re-run for those keys
  */
 export const makeShouldRebuild = ({ globalPatternSet, localPatternSets, }) => {
-    const localMatchers = localPatternSets.map(localPatternSet => {
+    const localMatchers = Object.entries(localPatternSets).map(([generatesPath, localPatternSet]) => {
         return (path) => {
             // Is path negated by any negating watch pattern?
             if (matchesAnyNegatedPattern(path, [...globalPatternSet.watch.negated, ...localPatternSet.watch.negated])) {
@@ -49,7 +52,7 @@ export const makeShouldRebuild = ({ globalPatternSet, localPatternSets, }) => {
                 ...localPatternSet.watch.affirmative,
             ])) {
                 // Immediately return true: Watch pattern takes priority, even if documents or schema would negate it
-                return true;
+                return generatesPath;
             }
             // Does path match documents patterns (without being negated)?
             if (matchesAnyAffirmativePattern(path, [
@@ -57,7 +60,7 @@ export const makeShouldRebuild = ({ globalPatternSet, localPatternSets, }) => {
                 ...localPatternSet.documents.affirmative,
             ]) &&
                 !matchesAnyNegatedPattern(path, [...globalPatternSet.documents.negated, ...localPatternSet.documents.negated])) {
-                return true;
+                return generatesPath;
             }
             // Does path match schemas patterns (without being negated)?
             if (matchesAnyAffirmativePattern(path, [
@@ -65,22 +68,25 @@ export const makeShouldRebuild = ({ globalPatternSet, localPatternSets, }) => {
                 ...localPatternSet.schemas.affirmative,
             ]) &&
                 !matchesAnyNegatedPattern(path, [...globalPatternSet.schemas.negated, ...localPatternSet.schemas.negated])) {
-                return true;
+                return generatesPath;
             }
             // Otherwise, there is no match
             return false;
         };
     });
-    /**
-     * Return `true` if `path` should trigger a rebuild
-     */
     return ({ path: absolutePath }) => {
         if (!isAbsolute(absolutePath)) {
             throw new Error('shouldRebuild trigger should be called with absolute path');
         }
         const path = relative(process.cwd(), absolutePath);
-        const shouldRebuild = localMatchers.some(matcher => matcher(path));
-        return shouldRebuild;
+        const generatesKeysToRebuild = {};
+        for (const matcher of localMatchers) {
+            const result = matcher(path);
+            if (result) {
+                generatesKeysToRebuild[result] = true;
+            }
+        }
+        return generatesKeysToRebuild;
     };
 };
 /**

package/esm/utils/watcher.js

@@ -22,10 +22,14 @@ export const createWatcher = (initialContext, onNext) => {
     debugLog(`[Watcher] Starting watcher...`);
     let config = initialContext.getConfig();
     const globalPatternSet = makeGlobalPatternSet(initialContext);
-    const localPatternSets = Object.keys(config.generates)
-        .map(filename => normalizeOutputParam(config.generates[filename]))
-        .map(conf => makeLocalPatternSet(conf));
-    const allAffirmativePatterns = allAffirmativePatternsFromPatternSets([globalPatternSet, ...localPatternSets]);
+    const localPatternSetArray = [];
+    const localPatternSets = Object.entries(config.generates).reduce((res, [filename, conf]) => {
+        const patternSet = makeLocalPatternSet(normalizeOutputParam(conf));
+        res[filename] = patternSet;
+        localPatternSetArray.push(patternSet);
+        return res;
+    }, {});
+    const allAffirmativePatterns = allAffirmativePatternsFromPatternSets([globalPatternSet, ...localPatternSetArray]);
     const shouldRebuild = makeShouldRebuild({ globalPatternSet, localPatternSets });
     let watcherSubscription;
     const runWatcher = async (abortSignal) => {
@@ -41,9 +45,9 @@ export const createWatcher = (initialContext, onNext) => {
         }
         debugLog(`[Watcher] Parcel watcher loaded...`);
         let isShutdown = false;
-        const debouncedExec = debounce(() => {
+        const debouncedExec = debounce((generatesKeysToRebuild) => {
             if (!isShutdown) {
-                executeCodegen(initialContext)
+                executeCodegen(initialContext, { onlyGeneratesKeys: generatesKeysToRebuild })
                     .then(({ result, error }) => {
                     // FIXME: this is a quick fix to stop `onNext` (writeOutput) from
                     // removing all files when there is an error.
@@ -82,11 +86,11 @@ export const createWatcher = (initialContext, onNext) => {
             }
         }
         watcherSubscription = await parcelWatcher.subscribe(watchDirectory, async (_, events) => {
-            // it doesn't matter what has changed, need to run whole process anyway
             await Promise.all(
             // NOTE: @parcel/watcher always provides path as an absolute path
             events.map(async ({ type: eventName, path }) => {
-                if (!shouldRebuild({ path })) {
+                const generatesKeysToRebuild = shouldRebuild({ path });
+                if (Object.keys(generatesKeysToRebuild).length === 0) {
                     return;
                 }
                 lifecycleHooks(config.hooks).onWatchTriggered(eventName, path);
@@ -107,7 +111,7 @@ export const createWatcher = (initialContext, onNext) => {
                     config = newParsedConfig;
                     initialContext.updateConfig(config);
                 }
-                debouncedExec();
+                debouncedExec(generatesKeysToRebuild);
             }));
         }, { ignore: ignored });
         debugLog(`[Watcher] Started`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@graphql-codegen/cli",
-  "version": "6.0.2-alpha-20251107100146-ab5264c4ff8fd142a45caf57bfe2e845bf83b2d1",
+  "version": "6.1.0-alpha-20251107131717-adc4d901f6e53e023001b84e0cef353e6dad8629",
   "peerDependenciesMeta": {
     "@parcel/watcher": {
       "optional": true
@@ -20,11 +20,11 @@
     "@graphql-tools/apollo-engine-loader": "^8.0.0",
     "@graphql-tools/code-file-loader": "^8.0.0",
     "@graphql-tools/git-loader": "^8.0.0",
-    "@graphql-tools/github-loader": "^9.0.0",
+    "@graphql-tools/github-loader": "^8.0.0",
     "@graphql-tools/graphql-file-loader": "^8.0.0",
     "@graphql-tools/json-file-loader": "^8.0.0",
     "@graphql-tools/load": "^8.1.0",
-    "@graphql-tools/url-loader": "^9.0.0",
+    "@graphql-tools/url-loader": "^8.0.0",
     "@graphql-tools/utils": "^10.0.0",
     "@inquirer/prompts": "^7.8.2",
     "@whatwg-node/fetch": "^0.10.0",

package/typings/codegen.d.cts

@@ -1,6 +1,8 @@
 import { Types } from '@graphql-codegen/plugin-helpers';
 import { CodegenContext } from './config.cjs';
-export declare function executeCodegen(input: CodegenContext | Types.Config): Promise<{
+export declare function executeCodegen(input: CodegenContext | Types.Config, options?: {
+    onlyGeneratesKeys: Record<string, true>;
+}): Promise<{
     result: Types.FileOutput[];
     error: Error | null;
 }>;

package/typings/codegen.d.ts

@@ -1,6 +1,8 @@
 import { Types } from '@graphql-codegen/plugin-helpers';
 import { CodegenContext } from './config.js';
-export declare function executeCodegen(input: CodegenContext | Types.Config): Promise<{
+export declare function executeCodegen(input: CodegenContext | Types.Config, options?: {
+    onlyGeneratesKeys: Record<string, true>;
+}): Promise<{
     result: Types.FileOutput[];
     error: Error | null;
 }>;

package/typings/utils/patterns.d.cts

@@ -25,13 +25,16 @@ export declare const allAffirmativePatternsFromPatternSets: (patternSets: Patter
  *    a match even if it would be negated by some pattern in documents or schemas
  *  * The trigger returns true if any output target's local patterns result in
  *    a match, after considering the precedence of any global and local negations
+ *
+ * The result is a function that when given an absolute path,
+ * it will tell which generates blocks' keys are affected so we can re-run for those keys
  */
 export declare const makeShouldRebuild: ({ globalPatternSet, localPatternSets, }: {
     globalPatternSet: PatternSet;
-    localPatternSets: PatternSet[];
-}) => ({ path: absolutePath }: {
+    localPatternSets: Record<string, PatternSet>;
+}) => ((params: {
     path: string;
-}) => boolean;
+}) => Record<string, true>);
 /**
  * Create the pattern set for the "global" (top level) config.
  *
@@ -52,11 +55,7 @@ export declare const makeGlobalPatternSet: (initialContext: CodegenContext) => {
  * patterns will be mixed into the pattern set of their respective gobal pattern
  * set equivalents.
  */
-export declare const makeLocalPatternSet: (conf: Types.ConfiguredOutput) => {
-    watch: SortedPatterns<string>;
-    documents: SortedPatterns<string>;
-    schemas: SortedPatterns<string>;
-};
+export declare const makeLocalPatternSet: (conf: Types.ConfiguredOutput) => PatternSet;
 /**
  * Given a list of micromatch patterns, sort them into `patterns` (all of them),
  * `affirmative` (only the affirmative patterns), and `negated` (only the negated patterns)
@@ -83,7 +82,7 @@ type SortedPatterns<PP extends string | NegatedPattern = string | NegatedPattern
  * patterns which are separable into "watch" (always takes precedence), "documents",
  * and "schemas". This type can hold sorted versions of these patterns.
  */
-type PatternSet = {
+export type PatternSet = {
     watch: SortedPatterns;
     documents: SortedPatterns;
     schemas: SortedPatterns;

package/typings/utils/patterns.d.ts

@@ -25,13 +25,16 @@ export declare const allAffirmativePatternsFromPatternSets: (patternSets: Patter
  *    a match even if it would be negated by some pattern in documents or schemas
  *  * The trigger returns true if any output target's local patterns result in
  *    a match, after considering the precedence of any global and local negations
+ *
+ * The result is a function that when given an absolute path,
+ * it will tell which generates blocks' keys are affected so we can re-run for those keys
  */
 export declare const makeShouldRebuild: ({ globalPatternSet, localPatternSets, }: {
     globalPatternSet: PatternSet;
-    localPatternSets: PatternSet[];
-}) => ({ path: absolutePath }: {
+    localPatternSets: Record<string, PatternSet>;
+}) => ((params: {
     path: string;
-}) => boolean;
+}) => Record<string, true>);
 /**
  * Create the pattern set for the "global" (top level) config.
  *
@@ -52,11 +55,7 @@ export declare const makeGlobalPatternSet: (initialContext: CodegenContext) => {
  * patterns will be mixed into the pattern set of their respective gobal pattern
  * set equivalents.
  */
-export declare const makeLocalPatternSet: (conf: Types.ConfiguredOutput) => {
-    watch: SortedPatterns<string>;
-    documents: SortedPatterns<string>;
-    schemas: SortedPatterns<string>;
-};
+export declare const makeLocalPatternSet: (conf: Types.ConfiguredOutput) => PatternSet;
 /**
  * Given a list of micromatch patterns, sort them into `patterns` (all of them),
  * `affirmative` (only the affirmative patterns), and `negated` (only the negated patterns)
@@ -83,7 +82,7 @@ type SortedPatterns<PP extends string | NegatedPattern = string | NegatedPattern
  * patterns which are separable into "watch" (always takes precedence), "documents",
  * and "schemas". This type can hold sorted versions of these patterns.
  */
-type PatternSet = {
+export type PatternSet = {
     watch: SortedPatterns;
     documents: SortedPatterns;
     schemas: SortedPatterns;