@graphcommerce/next-config 10.0.0 → 10.0.1-canary.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Change Log
 
+## 10.0.1-canary.1
+
+### Patch Changes
+
+- [#2571](https://github.com/graphcommerce-org/graphcommerce/pull/2571) [`a16bed1`](https://github.com/graphcommerce-org/graphcommerce/commit/a16bed1b8670932e273d5ea7114bf01fda40f2f8) - Always copy the file if the original file is a core file, allowing overrides. ([@paales](https://github.com/paales))
+
+## 10.0.1-canary.0
+
+### Patch Changes
+
+- [#2568](https://github.com/graphcommerce-org/graphcommerce/pull/2568) [`64d843e`](https://github.com/graphcommerce-org/graphcommerce/commit/64d843e4b98edbc2779ae75930d657dd7c7fdda2) - "No graphcommerce.config.js found in the project, using demo config" should have referenced 'graphcommerce.config.ts' ([@paales](https://github.com/paales))
+
 ## 10.0.0
 
 ### Major Changes
@@ -110,274 +122,6 @@
 
 - [#2487](https://github.com/graphcommerce-org/graphcommerce/pull/2487) [`5ffa0ee`](https://github.com/graphcommerce-org/graphcommerce/commit/5ffa0ee1d620f4f1c38bc5df36cbd527bcc43cf9) - Migrated `@graphcommerce/next-config` package to `"type": "module"` ([@paales](https://github.com/paales))
 
-## 10.0.0-canary.72
-
-## 10.0.0-canary.71
-
-## 10.0.0-canary.70
-
-### Major Changes
-
-- [#2565](https://github.com/graphcommerce-org/graphcommerce/pull/2565) [`c96dfcd`](https://github.com/graphcommerce-org/graphcommerce/commit/c96dfcdca981baca387c270ad9e2b9515cdd00cc) - Updated to Apollo Client 4 ([@paales](https://github.com/paales))
-
-### Minor Changes
-
-- [#2565](https://github.com/graphcommerce-org/graphcommerce/pull/2565) [`ea75841`](https://github.com/graphcommerce-org/graphcommerce/commit/ea758413b1ee8b8f2584e8f4135cb582fb87445f) - Migrated to vitest ([@paales](https://github.com/paales))
-
-## 10.0.0-canary.69
-
-## 10.0.0-canary.68
-
-## 10.0.0-canary.67
-
-## 10.0.0-canary.66
-
-## 10.0.0-canary.65
-
-## 10.0.0-canary.64
-
-## 10.0.0-canary.63
-
-## 10.0.0-canary.62
-
-## 10.0.0-canary.61
-
-## 10.0.0-canary.60
-
-## 10.0.0-canary.59
-
-## 10.0.0-canary.58
-
-## 10.0.0-canary.57
-
-## 10.0.0-canary.56
-
-### Major Changes
-
-- [#2546](https://github.com/graphcommerce-org/graphcommerce/pull/2546) [`ed9332a`](https://github.com/graphcommerce-org/graphcommerce/commit/ed9332a7f78966d932041d9a7725641edc92b28d) - ## GraphCommerce 10 - Turbopack Support
-
-  This major release brings full Turbopack compatibility, dramatically improving development speed.
-
-  ### 🚀 Turbopack-Compatible Interceptor System
-
-  The entire plugin/interceptor system has been rewritten to work with Turbopack:
-
-  - **No more Webpack plugins** - Removed `InterceptorPlugin` webpack plugin entirely
-  - **File-based interception** - Original files are moved to `.original.tsx` and replaced with interceptor content
-  - **Direct imports** - Interceptors import from `.original` files instead of embedding source
-  - **New CLI commands**:
-    - `graphcommerce codegen-interceptors` - Generate interceptor files
-    - `graphcommerce cleanup-interceptors` - Reset interceptor system, restore original files
-  - **Stable file hashing** - Deterministic interceptor generation for better caching
-
-  ### ⚙️ Treeshakable Configuration System
-
-  Replaced Webpack `DefinePlugin`-based `import.meta.graphCommerce` with a new generated configuration system:
-
-  - **New `codegen-config-values` command** - Generates TypeScript files with precise typing
-  - **Schema-driven** - Dynamically introspects Zod schemas to determine all available properties
-  - **Fully treeshakable** - Unused config values are eliminated from the bundle
-  - **Type-safe** - Uses `Get<GraphCommerceConfig, 'path'>` for nested property access
-  - **Separate files for nested objects** - Optimal treeshaking for complex configurations
-
-  ### 🔧 withGraphCommerce Changes
-
-  - **Removed** `InterceptorPlugin` - No longer needed with file-based interception
-  - **Removed** `DefinePlugin` for `import.meta.graphCommerce` - Replaced with generated config
-  - **Removed** `@mui/*` alias rewrites - No longer required
-  - **Added** Turbopack loader rules for `.yaml`, `.yml`, and `.po` files
-  - **Added** `serverExternalPackages` for all `@whatwg-node/*` packages
-  - **Added** `optimizePackageImports` for better bundle optimization
-  - **Added** `images.qualities: [52, 75]` for Next.js image optimization
-
-  ### 📦 Lingui Configuration
-
-  - **Renamed** `lingui.config.js` → `lingui.config.ts` with TypeScript support
-  - **Updated** `@graphcommerce/lingui-next/config` to TypeScript with proper exports
-  - **Simplified** formatter options
-
-  ### ⚛️ React 19 & Next.js 16 Compatibility
-
-  - Updated `RefObject<T>` types for React 19 (now includes `null` by default)
-  - Replaced deprecated `React.VFC` with `React.FC`
-  - Fixed `useRef` calls to require explicit initial values
-  - Updated `MutableRefObject` usage in `framer-scroller`
-
-  ### 📋 ESLint 9 Flat Config
-
-  - Migrated from legacy `.eslintrc` to new flat config format (`eslint.config.mjs`)
-  - Updated `@typescript-eslint/*` packages to v8
-  - Fixed AST selector for `SxProps` rule (`typeParameters` → `typeArguments`)
-
-  ### 🔄 Apollo Client
-
-  - Fixed deprecated `name` option → `clientAwareness: { name: 'ssr' }`
-  - Updated error handling types to accept `ApolloError | null | undefined`
-
-  ### ⚠️ Breaking Changes
-
-  - **Node.js 24.x not supported** - Restricted to `>=20 <24.0.0` due to [nodejs/undici#4290](https://github.com/nodejs/undici/issues/4290)
-  - **Interceptor files changed** - Original components now at `.original.tsx`
-  - **Config access changed** - Use generated config values instead of `import.meta.graphCommerce`
-  - **ESLint config format** - Must use flat config (`eslint.config.mjs`)
-  - **Lingui config** - Rename `lingui.config.js` to `lingui.config.ts`
-
-  ### 🗑️ Removed
-
-  - `InterceptorPlugin` webpack plugin
-  - `configToImportMeta` utility
-  - Webpack `DefinePlugin` usage for config
-  - `@mui/*` modern alias rewrites
-  - Debug plugins (`CircularDependencyPlugin`, `DuplicatesPlugin`) ([@paales](https://github.com/paales))
-
-## 9.1.0-canary.55
-
-## 9.1.0-canary.54
-
-## 9.1.0-canary.53
-
-## 9.1.0-canary.52
-
-## 9.1.0-canary.51
-
-### Patch Changes
-
-- [#2537](https://github.com/graphcommerce-org/graphcommerce/pull/2537) [`6492d81`](https://github.com/graphcommerce-org/graphcommerce/commit/6492d819a858ffdc01a97e6914053e9cc14c8fc5) - Reduce exported scope of config so we dont introduce a hidden dependency on Magento ([@paales](https://github.com/paales))
-
-## 9.1.0-canary.50
-
-## 9.1.0-canary.49
-
-## 9.1.0-canary.48
-
-## 9.1.0-canary.47
-
-## 9.1.0-canary.46
-
-### Patch Changes
-
-- [`f6b9c0d`](https://github.com/graphcommerce-org/graphcommerce/commit/f6b9c0d2bc5f678fc6cde279f1590b30ef631f8a) - Temporarily pin prettier to 3.5.3 to fix the GraphCommerce build: https://github.com/hosseinmd/prettier-plugin-jsdoc/pull/246/files ([@paales](https://github.com/paales))
-
-## 9.1.0-canary.45
-
-### Patch Changes
-
-- [`f508396`](https://github.com/graphcommerce-org/graphcommerce/commit/f50839619c75c8f7b1782c079f1c25998cb9217b) - Solve issue where optional chaining for import.meta.graphCommmerce configuration paths didn't work. ([@paales](https://github.com/paales))
-
-## 9.1.0-canary.44
-
-## 9.1.0-canary.43
-
-## 9.1.0-canary.42
-
-## 9.1.0-canary.41
-
-## 9.1.0-canary.40
-
-## 9.1.0-canary.39
-
-## 9.1.0-canary.38
-
-## 9.1.0-canary.37
-
-## 9.1.0-canary.36
-
-## 9.1.0-canary.35
-
-## 9.1.0-canary.34
-
-## 9.1.0-canary.33
-
-## 9.1.0-canary.32
-
-## 9.1.0-canary.31
-
-## 9.1.0-canary.30
-
-## 9.1.0-canary.29
-
-## 9.1.0-canary.28
-
-## 9.1.0-canary.27
-
-## 9.1.0-canary.26
-
-## 9.1.0-canary.25
-
-## 9.1.0-canary.24
-
-## 9.1.0-canary.23
-
-## 9.1.0-canary.22
-
-## 9.1.0-canary.21
-
-## 9.1.0-canary.20
-
-## 9.1.0-canary.19
-
-### Patch Changes
-
-- [#2499](https://github.com/graphcommerce-org/graphcommerce/pull/2499) [`9cf0450`](https://github.com/graphcommerce-org/graphcommerce/commit/9cf0450a41c4c74292b96f5795c7428f9d6a930c) - Remove the 'ignored' string when loading the graphcommerce config env variable loading, as that isn't always correct ([@paales](https://github.com/paales))
-
-## 9.1.0-canary.18
-
-### Patch Changes
-
-- [`62b71d5`](https://github.com/graphcommerce-org/graphcommerce/commit/62b71d5ed1d482fdb5b76dc19ac4d55fc41fb191) - Solve issue: TypeError: InMemoryLRUCache is not a constructor ([@paales](https://github.com/paales))
-
-## 9.1.0-canary.17
-
-## 9.1.0-canary.16
-
-## 9.1.0-canary.15
-
-## 9.0.4-canary.14
-
-## 9.0.4-canary.13
-
-## 9.0.4-canary.12
-
-## 9.0.4-canary.11
-
-## 9.0.4-canary.10
-
-### Patch Changes
-
-- [#2487](https://github.com/graphcommerce-org/graphcommerce/pull/2487) [`8b25322`](https://github.com/graphcommerce-org/graphcommerce/commit/8b253224997b59ac74d72813214dfc224f526c0a) - When a dependency is optional or has peerDependenciesMeta set to optional, make sure it doesn't crash when it is not found when calling resolveDependenciesSync ([@paales](https://github.com/paales))
-
-- [#2487](https://github.com/graphcommerce-org/graphcommerce/pull/2487) [`2c79a4c`](https://github.com/graphcommerce-org/graphcommerce/commit/2c79a4cba2779bc367104ebb13e6c0d6feb6574f) - Remove redirects for `/product/$type/[url]` routes, those haven't been used for years anymore. ([@paales](https://github.com/paales))
-
-- [#2487](https://github.com/graphcommerce-org/graphcommerce/pull/2487) [`30b7356`](https://github.com/graphcommerce-org/graphcommerce/commit/30b7356790efbac0f0017ef61cb1619b920100ab) - Solve issue where withGraphCommerce had a hard dependency on Magento specific configurations ([@paales](https://github.com/paales))
-
-- [#2487](https://github.com/graphcommerce-org/graphcommerce/pull/2487) [`9825f59`](https://github.com/graphcommerce-org/graphcommerce/commit/9825f59b8626c315e6092950faceeab4311a5424) - Remove rewriteLegacyEnv as that hasn't been used for years ([@paales](https://github.com/paales))
-
-- [#2487](https://github.com/graphcommerce-org/graphcommerce/pull/2487) [`5ffa0ee`](https://github.com/graphcommerce-org/graphcommerce/commit/5ffa0ee1d620f4f1c38bc5df36cbd527bcc43cf9) - Migrated `@graphcommerce/next-config` package to `"type": "module"` ([@paales](https://github.com/paales))
-
-## 9.0.4-canary.9
-
-## 9.0.4-canary.8
-
-## 9.0.4-canary.7
-
-## 9.0.4-canary.6
-
-## 9.0.4-canary.5
-
-## 9.0.4-canary.4
-
-## 9.0.4-canary.3
-
-## 9.0.4-canary.2
-
-## 9.0.4-canary.1
-
-## 9.0.4-canary.0
-
-### Patch Changes
-
-- [#2472](https://github.com/graphcommerce-org/graphcommerce/pull/2472) [`905157b`](https://github.com/graphcommerce-org/graphcommerce/commit/905157bec2c9e1dcf51b6e6f7b6913aa9be7b609) - Solve issue with chalk compilation because we’re not migrated to esm modules. ([@paales](https://github.com/paales))
-
 ## 9.0.0
 
 ### Major Changes

package/__tests__/commands/copyFiles.ts

@@ -16,6 +16,7 @@ vi.mock('fs/promises', () => ({
     stat: vi.fn(),
     unlink: vi.fn(),
     rmdir: vi.fn(),
+    rename: vi.fn(),
   },
   readFile: vi.fn(),
   writeFile: vi.fn(),
@@ -24,6 +25,7 @@ vi.mock('fs/promises', () => ({
   stat: vi.fn(),
   unlink: vi.fn(),
   rmdir: vi.fn(),
+  rename: vi.fn(),
 }))
 
 // Mock fast-glob
@@ -425,11 +427,17 @@ describe('copyFiles', () => {
       }
       return Promise.reject(new Error(`ENOENT: no such file or directory, open '${filePath}'`))
     })
+    mockFs.rename.mockResolvedValue(undefined)
 
     await copyFiles()
 
+    // Unmanaged files should be renamed to .original and a new managed file created
+    expect(mockFs.rename).toHaveBeenCalledWith(
+      path.join(mockCwd, 'file.ts'),
+      path.join(mockCwd, 'file.original.ts'),
+    )
     expect(consoleInfo).toHaveBeenCalledWith(
-      expect.stringContaining('Note: File file.ts has been modified'),
+      expect.stringContaining('Renamed existing file to: file.original.ts'),
     )
   })
 

package/__tests__/config/utils/__snapshots__/mergeEnvIntoConfig.ts.snap

@@ -2,7 +2,6 @@
 
 exports[`parses an env config object 1`] = `
 {
-  "GC_DEMO_MODE": true,
   "GC_STOREFRONT": [
     {
       "defaultLocale": true,
@@ -14,10 +13,8 @@ exports[`parses an env config object 1`] = `
     },
   ],
   "GC_STOREFRONT_0_DEFAULT_LOCALE": true,
-  "GC_STOREFRONT_0_HYGRAPH_LOCALES_0": "en",
   "GC_STOREFRONT_0_LOCALE": "en",
   "GC_STOREFRONT_0_MAGENTO_STORE_CODE": "en_us",
-  "GC_STOREFRONT_1_HYGRAPH_LOCALES_0": "de",
   "GC_STOREFRONT_1_LOCALE": "de",
   "GC_STOREFRONT_1_MAGENTO_STORE_CODE": "de_de",
 }

package/__tests__/interceptors/findPlugins.ts

@@ -557,6 +557,14 @@ it('finds plugins', () => {
         "targetModule": "@graphcommerce/magento-product-configurable",
         "type": "component",
       },
+      {
+        "enabled": true,
+        "sourceExport": "GraphQLProvider",
+        "sourceModule": "@graphcommerce/magento-recently-viewed-products/plugins/AddRecentlyViewedProductsTypePolicies",
+        "targetExport": "GraphQLProvider",
+        "targetModule": "@graphcommerce/graphql",
+        "type": "component",
+      },
       {
         "enabled": true,
         "sourceExport": "cartItemToCartItemInput",

package/__tests__/interceptors/generateInterceptors.ts

@@ -87,7 +87,7 @@ it('it generates an interceptor', async () => {
      * This file is NOT meant to be modified directly and is auto-generated if the plugins or the
      * original source changes.
      *
-     * @see {@link file://./PaymentMethodContextProvider.tsx} for original source file
+     * @see {@link file://./PaymentMethodContextProvider.original.tsx} for original source file
      * @see {PluginAddBraintreeMethods} for source of applied plugin
      * @see {PluginAddMollieMethods} for source of applied plugin
      */
@@ -188,7 +188,7 @@ it('it can apply multiple plugins to a single export', async () => {
      * This file is NOT meant to be modified directly and is auto-generated if the plugins or the
      * original source changes.
      *
-     * @see {@link file://./PaymentMethodContextProvider.tsx} for original source file
+     * @see {@link file://./PaymentMethodContextProvider.original.tsx} for original source file
      * @see {PluginAddAdyenMethods} for source of applied plugin
      * @see {PluginAddMollieMethods} for source of applied plugin
      */
@@ -257,7 +257,7 @@ it('it handles on duplicates gracefully', async () => {
      * This file is NOT meant to be modified directly and is auto-generated if the plugins or the
      * original source changes.
      *
-     * @see {@link file://./PaymentMethodContextProvider.tsx} for original source file
+     * @see {@link file://./PaymentMethodContextProvider.original.tsx} for original source file
      * @see {PluginAddBraintreeMethods} for source of applied plugin
      * @see {PluginAddBraintreeMethods} for source of applied plugin
      */
@@ -434,7 +434,7 @@ it('adds debug logging to interceptors for components', async () => {
      * This file is NOT meant to be modified directly and is auto-generated if the plugins or the
      * original source changes.
      *
-     * @see {@link file://./graphqlConfig.ts} for original source file
+     * @see {@link file://./graphqlConfig.original.ts} for original source file
      * @see {pluginhygraphInitMemoryCache} for source of applied plugin
      * @see {pluginmagentoInitMemoryCache} for source of applied plugin
      */

package/dist/config/loadConfig.js

@@ -1,6 +1,6 @@
 import 'cosmiconfig';
 import '../generated/config.js';
-export { l as loadConfig, r as replaceConfigInString } from '../loadConfig-CZYUe1jE.js';
+export { l as loadConfig, r as replaceConfigInString } from '../loadConfig-DFvwanrZ.js';
 import 'zod';
 import '@apollo/client/utilities/internal';
 import 'chalk';

package/dist/index.js

@@ -4,8 +4,8 @@ import path from 'path';
 import { glob, sync } from 'glob';
 import { findParentPath } from './utils/findParentPath.js';
 import { spawn } from 'child_process';
-import { l as loadConfig, t as toEnvStr } from './loadConfig-CZYUe1jE.js';
-export { r as replaceConfigInString } from './loadConfig-CZYUe1jE.js';
+import { l as loadConfig, t as toEnvStr } from './loadConfig-DFvwanrZ.js';
+export { r as replaceConfigInString } from './loadConfig-DFvwanrZ.js';
 import { parseFileSync, parseSync as parseSync$1, transformFileSync } from '@swc/core';
 import fs$1, { writeFileSync, readFileSync, existsSync, rmSync, mkdirSync } from 'fs';
 import { resolve as resolve$2 } from 'import-meta-resolve';
@@ -729,7 +729,9 @@ async function generateInterceptor(interceptor, config, oldInterceptorSource) {
           `@see {${sourceName(name(replacePlugin))}} for source of replaced component`
         );
       } else {
-        pluginSee.push(`@see {@link file://./${targetExport}.tsx} for original source file`);
+        pluginSee.push(
+          `@see {@link file://./${targetExport}.original.tsx} for original source file`
+        );
       }
       const pluginInterceptors = componentPlugins.reverse().map((plugin) => {
         const pluginName = sourceName(name(plugin));
@@ -774,7 +776,9 @@ export const ${targetExport} = ${carry}`;
           `@see {${sourceName(name(replacePlugin))}} for source of replaced function`
         );
       } else {
-        pluginSee.push(`@see {@link file://./${targetExport}.ts} for original source file`);
+        pluginSee.push(
+          `@see {@link file://./${targetExport}.original.ts} for original source file`
+        );
       }
       const pluginInterceptors = functionPlugins.reverse().map((plugin) => {
         const pluginName = sourceName(name(plugin));
@@ -1079,7 +1083,7 @@ async function updateGitignore(managedFiles) {
   try {
     content = await fs.readFile(gitignorePath, "utf-8");
     debug("Reading existing .gitignore");
-  } catch (err) {
+  } catch {
     debug(".gitignore not found, creating new file");
     content = "";
   }
@@ -1114,6 +1118,11 @@ function getFileManagement(content) {
   if (contentStr.startsWith(MANAGED_BY_GC)) return "graphcommerce";
   return "unmanaged";
 }
+function getOriginalFilename(filePath) {
+  const ext = path.extname(filePath);
+  const base = filePath.slice(0, -ext.length);
+  return `${base}.original${ext}`;
+}
 async function copyFiles() {
   const startTime = performance.now();
   debug("Starting copyFiles");
@@ -1220,11 +1229,15 @@ Path: ${copyDir}`
             return;
           }
           if (management === "unmanaged") {
+            const originalPath = getOriginalFilename(targetPath);
+            await fs.rename(targetPath, originalPath);
+            const originalRelative = getOriginalFilename(file);
             console.info(
-              `Note: File ${file} has been modified. Add '${MANAGED_LOCALLY.trim()}' at the top to manage it locally.`
+              `Renamed existing file to: ${originalRelative}
+Creating managed file: ${file}`
             );
-            debug(`File ${file} doesn't have management comment, skipping`);
-            return;
+            debug(`Renamed ${file} to ${originalRelative}`);
+            targetContent = void 0;
           }
           debug(`File ${file} is managed by graphcommerce, will update if needed`);
         } catch (err) {

package/dist/{loadConfig-CZYUe1jE.js → loadConfig-DFvwanrZ.js}

@@ -284,7 +284,7 @@ function loadConfig(cwd) {
     let confFile = result?.config;
     if (!confFile) {
       if (isMainProcess)
-        console.warn("No graphcommerce.config.js found in the project, using demo config");
+        console.warn("No graphcommerce.config.ts found in the project, using demo config");
       confFile = demoConfig;
     }
     confFile ||= {};

package/package.json

@@ -2,7 +2,7 @@
   "name": "@graphcommerce/next-config",
   "homepage": "https://www.graphcommerce.org/",
   "repository": "github:graphcommerce-org/graphcommerce",
-  "version": "10.0.0",
+  "version": "10.0.1-canary.1",
   "type": "module",
   "exports": {
     ".": {
@@ -63,7 +63,7 @@
   },
   "peerDependencies": {
     "@apollo/client": "*",
-    "@graphcommerce/prettier-config-pwa": "^10.0.0",
+    "@graphcommerce/prettier-config-pwa": "^10.0.1-canary.1",
     "@lingui/loader": "*",
     "@lingui/macro": "*",
     "@lingui/react": "*",

package/src/commands/copyFiles.ts

@@ -1,4 +1,3 @@
-/* eslint-disable no-await-in-loop */
 import fs from 'fs/promises'
 import path from 'path'
 import fg from 'fast-glob'
@@ -38,7 +37,7 @@ async function updateGitignore(managedFiles: string[]) {
   try {
     content = await fs.readFile(gitignorePath, 'utf-8')
     debug('Reading existing .gitignore')
-  } catch (err) {
+  } catch {
     debug('.gitignore not found, creating new file')
     content = ''
   }
@@ -79,6 +78,13 @@ function getFileManagement(content: Buffer | undefined): 'local' | 'graphcommerc
   return 'unmanaged'
 }
 
+/** Generates the .original filename for a given file path (e.g., file.tsx -> file.original.tsx) */
+function getOriginalFilename(filePath: string): string {
+  const ext = path.extname(filePath)
+  const base = filePath.slice(0, -ext.length)
+  return `${base}.original${ext}`
+}
+
 /**
  * The packages are @graphcommerce/* packages and have special treatment.
  *
@@ -88,7 +94,8 @@ function getFileManagement(content: Buffer | undefined): 'local' | 'graphcommerc
  *
  *    1. If the file doesn't exist: Create directories and the file with "managed by: graphcommerce"
  *    2. If the file exists and starts with "managed by: local": Skip the file
- *    3. If the file exists but doesn't have a management comment: Suggest adding "managed by: local"
+ *    3. If the file exists but doesn't have a management comment: Rename to filename.original.ext and
+ *          create the new managed file
  *    4. If the file is managed by graphcommerce: Update if content differs
  */
 export async function copyFiles() {
@@ -213,11 +220,15 @@ Found in packages:
             return
           }
           if (management === 'unmanaged') {
+            // Rename existing file to .original and create new managed file
+            const originalPath = getOriginalFilename(targetPath)
+            await fs.rename(targetPath, originalPath)
+            const originalRelative = getOriginalFilename(file)
             console.info(
-              `Note: File ${file} has been modified. Add '${MANAGED_LOCALLY.trim()}' at the top to manage it locally.`,
+              `Renamed existing file to: ${originalRelative}\nCreating managed file: ${file}`,
             )
-            debug(`File ${file} doesn't have management comment, skipping`)
-            return
+            debug(`Renamed ${file} to ${originalRelative}`)
+            targetContent = undefined // Treat as new file from here
           }
 
           debug(`File ${file} is managed by graphcommerce, will update if needed`)

package/src/config/loadConfig.ts

@@ -19,7 +19,7 @@ export function loadConfig(cwd: string): GraphCommerceConfig {
     let confFile = result?.config
     if (!confFile) {
       if (isMainProcess)
-        console.warn('No graphcommerce.config.js found in the project, using demo config')
+        console.warn('No graphcommerce.config.ts found in the project, using demo config')
       confFile = demoConfig
     }
     confFile ||= {}

package/src/interceptors/generateInterceptor.ts

@@ -199,7 +199,9 @@ export async function generateInterceptor(
             `@see {${sourceName(name(replacePlugin))}} for source of replaced component`,
           )
         } else {
-          pluginSee.push(`@see {@link file://./${targetExport}.tsx} for original source file`)
+          pluginSee.push(
+            `@see {@link file://./${targetExport}.original.tsx} for original source file`,
+          )
         }
 
         const pluginInterceptors = componentPlugins
@@ -259,7 +261,9 @@ export const ${targetExport} = ${carry}`
             `@see {${sourceName(name(replacePlugin))}} for source of replaced function`,
           )
         } else {
-          pluginSee.push(`@see {@link file://./${targetExport}.ts} for original source file`)
+          pluginSee.push(
+            `@see {@link file://./${targetExport}.original.ts} for original source file`,
+          )
         }
 
         const pluginInterceptors = functionPlugins