Utilities and Helpers

const { 
  getLoader,           // function - deprecated, throws error
  loaderNameMatches,   // function - deprecated, throws error  
  getBabelLoader,      // function - deprecated, throws error
  injectBabelPlugin,   // function - deprecated, throws error
  compose,             // function - deprecated, throws error
  paths                // object - current paths configuration
} = require('react-app-rewired');

const { paths } = require('react-app-rewired');

// Access paths for third-party integration
console.log(paths.appSrc);        // Source directory path
console.log(paths.appBuild);      // Build directory path
console.log(paths.scriptVersion); // react-scripts module path

/**
 * Extended paths object with react-app-rewired specific properties
 */
const paths = require('react-app-rewired/scripts/utils/paths');

interface PathsObject {
  // react-scripts paths (inherited via Object.assign)
  appPath: string;              // Project root directory
  appSrc: string;               // Source directory  
  appBuild: string;             // Build output directory
  appPublic: string;            // Public assets directory
  appPackageJson: string;       // package.json file path
  appIndexJs: string;           // Main index.js file
  appHtml: string;              // HTML template file
  
  // react-app-rewired specific paths (from paths.js)
  scriptVersion: string;        // Path to react-scripts module directory
  configOverrides: string;      // Path to config-overrides file/directory
  customScriptsIndex: number;   // Index of --scripts-version arg (-1 if not present)
  configOverridesIndex: number; // Index of --config-overrides arg (-1 if not present)
  
  // All other paths from react-scripts/config/paths are also available
  // via Object.assign({}, paths, overrides.paths(pathsConfig, process.env.NODE_ENV))
}

const paths = require('react-app-rewired/scripts/utils/paths');

// Access react-scripts module directory
const webpackConfig = require(`${paths.scriptVersion}/config/webpack.config`);

// Check if custom scripts version was specified
if (paths.customScriptsIndex > -1) {
  console.log('Using custom react-scripts version');
}

// Access config overrides path
const overrides = require(paths.configOverrides);

/**
 * Dependency resolution utilities
 */
const { dependRequire, dependRequireResolve } = require('react-app-rewired/scripts/utils/dependRequire');

/**
 * Resolve module path relative to react-scripts
 * @param id - Module identifier to resolve
 * @returns Resolved module path
 */
function dependRequireResolve(id: string): string;

/**
 * Require module relative to react-scripts  
 * @param id - Module identifier to require
 * @returns Required module
 */
function dependRequire(id: string): any;

const { dependRequire, dependRequireResolve } = require('react-app-rewired/scripts/utils/dependRequire');

// Require babel-jest from react-scripts context
const babelJest = dependRequire('babel-jest');

// Resolve path to babel preset
const presetPath = dependRequireResolve('babel-preset-react-app');

// Use in webpack config
config.module.rules.push({
  test: /\.js$/,
  use: {
    loader: dependRequireResolve('babel-loader'),
    options: {
      presets: [dependRequireResolve('babel-preset-react-app')]
    }
  }
});

/**
 * Jest configuration merge utility
 * @param config - Base Jest configuration from react-scripts
 * @returns Merged Jest configuration with package.json overrides
 */
const rewireJestConfig = require('react-app-rewired/scripts/utils/rewireJestConfig');

function rewireJestConfig(config: any): any;

const rewireJestConfig = require('react-app-rewired/scripts/utils/rewireJestConfig');

// In jest override function
jest: function(config) {
  // Apply package.json jest overrides first
  config = rewireJestConfig(config);
  
  // Then apply additional customizations
  config.testTimeout = 10000;
  
  return config;
}

/**
 * Custom babel-jest transformer module with react-app preset
 * This is a pre-configured transformer, not a function
 */
const babelTransform = require('react-app-rewired/scripts/utils/babelTransform');

// The module exports a babel-jest transformer with this configuration:
interface BabelTransformerConfig {
  presets: [
    [string, { runtime: 'automatic' | 'classic' }]
  ];
  plugins: any[];
  babelrc: true;  // Allows .babelrc files to be respected
}

// JSX runtime detection logic
const hasJsxRuntime = (() => {
  if (process.env.DISABLE_NEW_JSX_TRANSFORM === 'true') {
    return false;
  }
  try {
    require.resolve('react/jsx-runtime');
    return true;
  } catch (e) {
    return false;
  }
})();

// Creates transformer with:
// runtime: hasJsxRuntime ? 'automatic' : 'classic'
// babelrc: true

/**
 * Export rewired webpack config for third-party tools
 * Create webpack.config.js in project root:
 */
const { paths } = require('react-app-rewired');
const overrides = require('react-app-rewired/config-overrides');
const config = require(paths.scriptVersion + '/config/webpack.config.dev');

module.exports = overrides.webpack(config, process.env.NODE_ENV);

// Environment variables used by utilities
process.env.NODE_ENV                    // 'development', 'production', 'test'
process.env.REACT_SCRIPTS_VERSION      // Custom react-scripts package name
process.env.DISABLE_NEW_JSX_TRANSFORM  // 'true' to disable automatic JSX runtime

// Custom config-overrides path detection
const projectDir = require('fs').realpathSync(process.cwd());
const packageJson = require(path.resolve(projectDir, 'package.json'));
const customPath = packageJson['config-overrides-path'];

// Resolves to:
// 1. Custom path from package.json 'config-overrides-path'
// 2. Command line --config-overrides argument  
// 3. Default: ./config-overrides (file or directory)