packages/docgen/lib/engine.js - trunk - githubmirror/gutenberg

packages/docgen/lib/engine.js

41 строка1 KB

Marco Ciampini

ESLint: Replace strict config with bulk suppressions (#81248)

07 авг 2026, 14:34

07 авг 2026, 14:347f43eaf

const babel = require( '@babel/core' );
const getIntermediateRepresentation = require( './get-intermediate-representation' );

const getAST = ( source, filename ) => {
	return babel.parse( source, { filename } ).program;
};

const getExportTokens = ( ast ) =>
	ast.body.filter( ( node ) =>
		[
			'ExportNamedDeclaration',
			'ExportDefaultDeclaration',
			'ExportAllDeclaration',
		].includes( node.type )
	);

const engine = ( path, code, getIRFromPath = () => {} ) => {
	if ( ! path || ! code ) {
		return { ast: null, tokens: null, ir: [] };
	}

	const ast = getAST( code, path );
	const tokens = getExportTokens( ast );
	const ir = tokens.flatMap( ( token ) =>
		getIntermediateRepresentation( path, token, ast, getIRFromPath )
	);

	return { ast, tokens, ir };
};

/**
 * Function that takes code and returns an intermediate representation.
 *
 * @param {string}   code                 The code to parse.
 * @param {Function} [getIRFromPath=noop] Callback to retrieve the
 *                                        Intermediate Representation from a path relative to the file
 *                                        being parsed.
 *
 * @return {Object} Intermediate Representation in JSON.
 */
module.exports = engine;