update-readmes.js

#!/usr/bin/env node

const path = require( 'path' );
const { promisify } = require( 'util' );
const spawn = promisify( require( 'child_process' ).spawn );

const packages = [
	'a11y',
	'autop',
	'blob',
	'block-editor',
	'block-library',
	'block-serialization-default-parser',
	'blocks',
	'compose',
	//'data',
	'date',
	'deprecated',
	'dom',
	'dom-ready',
	'e2e-test-utils',
	'edit-post',
	'element',
	'escape-html',
	'html-entities',
	'i18n',
	'keycodes',
	'plugins',
	'priority-queue',
	'redux-routine',
	'rich-text',
	'shortcode',
	'url',
	'viewport',
	'wordcount',
];

const getArgsForPackage = ( packageName ) => {
	switch ( packageName ) {
		case 'rich-text':
			return [
				`packages/${ packageName }/src/index.js`,
				`--output packages/${ packageName }/README.md`,
				'--to-token',
				'--ignore "unstable|experimental|^apply$|^changeListType$|^charAt$|^getSelectionStart$|^getSelectionEnd$|^indentListItems$|^insertLineBreak$|^insertLineSeparator$|^isEmptyLine$|^LINE_SEPARATOR$|^outdentListItems$"',
			];
		default:
			return [
				`packages/${ packageName }/src/index.js`,
				`--output packages/${ packageName }/README.md`,
				'--to-token',
				'--ignore "unstable|experimental"',
			];
	}
};

Promise.all( packages.map( async ( packageName ) => {
	const args = getArgsForPackage( packageName );
	const pathToDocGen = path.join( __dirname, '..', 'node_modules', '.bin', 'docgen' );
	const { status, stderr } = await spawn(
		pathToDocGen,
		args,
		{ shell: true },
	);
	if ( status !== 0 ) {
		throw stderr.toString();
	}
} ) ).catch( ( error ) => {
	process.stderr.write( `${ error }\n` );
	process.exit( 1 );
} );