Development Integration

/**
 * Configure require hook for automatic Flow type removal
 * @param {RegisterOptions} options - Configuration options for file matching
 * @returns {Function} Function to configure options, also serves as require hook setup
 */
require('flow-remove-types/register')(options);

interface RegisterOptions {
  /** Transform all files, not just those with @flow comment (default: false) */
  all?: boolean;
  /** Pattern for files to transform (RegExp or glob string) */
  includes?: RegExp | string;
  /** Alternative name for includes */
  include?: RegExp | string;
  /** Pattern for files to exclude (RegExp or glob string, default: /\/node_modules\//) */
  excludes?: RegExp | string;
  /** Alternative name for excludes */
  exclude?: RegExp | string;
}

// Basic setup - transform files with @flow pragma
require('flow-remove-types/register');
require('./my-flow-module'); // Automatically transformed

// Transform all files
require('flow-remove-types/register')({ all: true });

// Custom include/exclude patterns
require('flow-remove-types/register')({
  includes: /\/src\//,           // Only files in src/
  excludes: /\/(test|spec)\//    // Exclude test files
});

// Glob-style patterns
require('flow-remove-types/register')({
  include: 'src/**/*.js',
  exclude: 'src/**/*.test.js'
});

/**
 * Jest transformer object for Flow type removal
 */
const transformer = {
  process(src: string, filename: string): { code: string };
}

// jest.config.js
module.exports = {
  transform: {
    "^.+\\.js(?:\\.flow)?$": "flow-remove-types/jest"
  }
};

// Alternative: package.json
{
  "jest": {
    "transform": {
      "^.+\\.js(?:\\.flow)?$": "flow-remove-types/jest"
    }
  }
}

// Support multiple Flow file extensions
module.exports = {
  transform: {
    "^.+\\.(js|jsx|mjs|cjs|flow)$": "flow-remove-types/jest"
  }
};

// webpack.config.js with remove-flow-types-loader
module.exports = {
  module: {
    rules: [
      {
        test: /\.js$/,
        use: 'remove-flow-types-loader'
      }
    ]
  }
};

// rollup.config.js with rollup-plugin-flow
import flow from 'rollup-plugin-flow';

export default {
  plugins: [
    flow({ all: true, pretty: true })
  ]
};

// With unflowify transform
browserify('src/app.js')
  .transform('unflowify')
  .bundle();

// With gulp-flow-remove-types
const gulp = require('gulp');
const flowRemoveTypes = require('gulp-flow-remove-types');

gulp.task('build', () => {
  return gulp.src('src/**/*.js')
    .pipe(flowRemoveTypes({ pretty: true }))
    .pipe(gulp.dest('dist/'));
});

mocha -r flow-remove-types/register test/**/*.js

// development.js - require hook for fast iteration
require('flow-remove-types/register')({ all: true });
require('./app');

// build.js - pre-compile for production
const flowRemoveTypes = require('flow-remove-types');
const fs = require('fs');

const input = fs.readFileSync('src/app.js', 'utf8');
const result = flowRemoveTypes(input, { pretty: true });
fs.writeFileSync('dist/app.js', result.toString());

// Enable source maps with pretty mode
const result = flowRemoveTypes(source, { 
  pretty: true 
});

// Write source map
fs.writeFileSync('dist/app.js.map', JSON.stringify(result.generateMap()));

/**
 * Convert string patterns to RegExp with glob-like syntax
 * Supports glob patterns like "src/*.js" -> /\/src\/.*\.js/
 */
function regexpPattern(pattern);

// String patterns (converted to RegExp)
require('flow-remove-types/register')({
  include: 'src/*.js',      // -> /\/src\/.*\.js/
  exclude: '*/test/*'       // -> /.*\/test\/.*/
});

// RegExp patterns (used directly)
require('flow-remove-types/register')({
  includes: /\/src\/.*\.js$/,
  excludes: /node_modules/
});

// Default exclude pattern
// excludes: /\/node_modules\//  (automatic)

const supportedExtensions = ['.js', '.mjs', '.cjs', '.jsx', '.flow', '.es6'];

try {
  require('./broken-flow-file');
} catch (error) {
  // Error message includes filename:
  // "broken-flow-file.js: Unexpected token"
}

try {
  require('flow-remove-types/register')({
    includes: 123  // Invalid pattern
  });
} catch (error) {
  // "flow-remove-types: includes and excludes must be RegExp or path strings"
}