@penskemediacorp/twig-to-php-parser 1.10.0-alpha.0 → 1.14.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2019 Penske Media Corporation
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -20,7 +20,7 @@ This package is intended to work with Larva Patterns to both parse patterns into
 
 ~When parsing includes, the parser looks for the `@larva` namespace, and will point includes to `PMC_CORE_PATH` when it finds it. Otherwise, includes will point to CHILD_THEME_PATH.~ This is not in effect yet. Everything is contained to the child theme.
 
-The parser supports a *very limited amount of Twig* and relies on keywords in data names in order to parse escaping correctly. Please refer to the Confluence documentation for Twig authoring guidelies: https://confluence.pmcdev.io/x/JoGJAg
+The parser supports a *very limited amount of Twig* and relies on keywords in data names in order to parse escaping correctly. Please refer to the Confluence documentation for Twig authoring guidelines: https://confluence.pmcdev.io/x/JoGJAg
 
 ## Usage
 
@@ -30,13 +30,60 @@ module.exports = {
 	// Other config
 
 	parser: {
-		relativeSrcOverride: false, // The default will look in src/patterns for the source path, but if you want to parse from a different directory, you can add that path here.
-		isCore: false // Or true, if it is the core theme and should parse everything to PMC_CORE_PATH
 	}
 }
 ```
 
+The parser object supports the following configuration:
+```language-js
+	parser: {
+		twigDir: path.resolve( './new-path/to-twig/' ), // Default /theme/assets/src/patterns.
+		phpDir: path.resolve( './new-path/to-php/' ), // Default /theme/template-parts/patterns.
+		isUsingPlugin: true, // Default false.
+	}
+```
+
 Then, run the script from the assets directory by executing the package binary like so:
 ```
-$ node_modules/.bin/twig-to-php-parser
+./node_modules/.bin/twig-to-php-parser
+```
+
+Supported wp action in twig markup:
+```language-twig
+{{ wp_action( 'action_name', arg1, arg2, ... ) }}
+```
+would translate to
+```language-php
+<?php do_action( 'action_name', $arg1, $arg2, ... ); ?>
 ```
+
+## How To
+TODO: Standardize and improve code structure for future improvement
+
+### Add a new function
+
+- New function add must follow twig function syntax: function_name( p1, p2, ... )
+- The new `function_name` must be added to larva/lib/server.js to support twig linting
+
+		// Add custom function support for doing wp action: {{ function_name( ... ) }}
+		twing.addFunction(new TwingFunction('function_name',() => {
+			return Promise.resolve(''); // must return a promise result
+		}));
+
+- Add a new code block function/class to translate twig markup into php code block to twig-to-php-parse.php
+	- Code block function should take a twig markup string as input 
+	- Return the translated php code block
+	  
+			function parse_my_new_function( $twig_markup ) {
+				// Code to parse and translate $twig_markup
+				return $twig_patterns;
+			}
+	  
+	- Modify function twig_to_php_parser and call to the new parser function to process $twig_markup_replace_main variable
+		
+			$twig_markup_replace_main = parse_my_new_function( $twig_markup_replace_main ) 
+
+- Add unit test
+	- Add js function to index.js to load the php code
+	- Add unit test to test the new parser function
+		

package/__tests__/fixtures/larva.config.js

@@ -0,0 +1,7 @@
+module.exports = {
+	parser: {
+		twigDir: `${__dirname}/src/patterns/`,
+		phpDir: `${__dirname}/template-parts/patterns/`,
+		isUsingPlugin: true,
+	}
+};

package/__tests__/fixtures/src/patterns/04-components/c-byline/c-byline.twig

@@ -1,5 +1,5 @@
 <p class="c-byline {{ modifier_class }} {{ c_byline_classes }}">
 	{{ c_byline_by_text }}
 
-	{{ c_byline_markup }}
+	{{ c_byline_markup|raw }}
 </p>

package/__tests__/fixtures/src/patterns/04-components/c-heading/c-heading.twig

@@ -1,2 +1 @@
 <h2 class="c-heading {{ modifier_class }}">{{ c_heading_text }}</h2>
-{% include "../modules/trending.twig" with item %}

package/__tests__/fixtures/src/patterns/04-components/c-logo/c-logo.twig

@@ -0,0 +1,3 @@
+<div>
+	{% include '/assets/build/svg/' ~ c_logo_svg ~ '.svg' %}
+</div>

package/__tests__/fixtures/src/patterns/08-modules/array-key-in-loop/array-key-in-loop.twig

@@ -0,0 +1,11 @@
+{% for item in list_items %}
+	<li class="list__item larva // {{ list_item_classes }}">
+		{% if item['list_items'] %}
+			{% include "@larva/modules/list/list.twig" with item %}
+		{% else %}
+			<div class="{{ item['list_item_classes'] }}">
+				{{ item['list_item_markup'] }}
+			</div>
+		{% endif %}
+	</li>
+{% endfor %}

package/__tests__/fixtures/src/patterns/08-modules/escaped-output-in-loop/escaped-output-in-loop.twig

@@ -0,0 +1,5 @@
+{% for item in slides %}
+	<div>
+		{{ item|markup }}
+	</div>
+{% endfor %}

package/__tests__/fixtures/src/patterns/08-modules/html-tag-interpolation/html-tag-interpolation.twig

@@ -0,0 +1,7 @@
+<{{ list_type_name }}l class="list larva // {{ list_classes }}">
+	{% for item in list_items %}
+		<li class="list__item larva // {{ list_item_classes }}">
+			{% include "@larva/modules/list/list.twig" with item %}
+		</li>
+	{% endfor %}
+</{{ list_type_name }}l>

package/__tests__/fixtures/src/patterns/08-modules/trending/trending.twig

@@ -5,4 +5,5 @@
 	<div class="pmc-u-margin-b-0 u-border-bottom-2">
 		{% include "../../05-objects/o-story-list/o-story-list.twig" with o_story_list %}
 	</div>
+	{{ trending_ads_wp_action }}
 </section>

package/__tests__/fixtures/src/patterns/99-objects/o-nav/o-nav.twig

@@ -8,6 +8,10 @@
 		{% for item in o_nav_list_items %}
 			<li class="o-nav__list-item {{ o_nav_list_item_classes }}" data-dropdown-list-item="{{ o_nav_list_item_data_attributes }}">
 				{% include "../../04-components/c-nav-link/c-nav-link.twig" with item %}
+				
+				{% if item['newsletter_dropdown'] %}
+					{% include "@project/modules/newsletter-dropdown/newsletter-dropdown.twig" with item['newsletter_dropdown'] %}
+				{% endif %}
 			</li>
 		{% endfor %}
 	</ul>

package/__tests__/fixtures/template-parts/.gitkeep

@@ -0,0 +1 @@
+Directory is required for tests.

package/__tests__/fixtures/template-parts-expected/patterns/components/c-button.php

@@ -1,6 +1,12 @@
 <?php
-// This is a generated file. Refer to the relevant Twig file for adjusting this markup.
+/**
+ * Generated file.
+ *
+ * Refer to the relevant Twig file for adjusting this markup.
+ */
+
 ?>
+
 <a class="c-button <?php echo esc_attr( $modifier_class ?? '' ); ?>" href="<?php echo esc_url( $c_button_url ?? '' ); ?>">
 	<?php echo esc_html( $c_button_text ?? '' ); ?>
 </a>

package/__tests__/fixtures/template-parts-expected/patterns/components/c-byline.php

@@ -1,6 +1,12 @@
 <?php
-// This is a generated file. Refer to the relevant Twig file for adjusting this markup.
+/**
+ * Generated file.
+ *
+ * Refer to the relevant Twig file for adjusting this markup.
+ */
+
 ?>
+
 <p class="c-byline <?php echo esc_attr( $modifier_class ?? '' ); ?> <?php echo esc_attr( $c_byline_classes ?? '' ); ?>">
 	<?php echo esc_html( $c_byline_by_text ?? '' ); ?>
 

package/__tests__/fixtures/template-parts-expected/patterns/components/c-heading.php

@@ -1,5 +1,10 @@
 <?php
-// This is a generated file. Refer to the relevant Twig file for adjusting this markup.
+/**
+ * Generated file.
+ *
+ * Refer to the relevant Twig file for adjusting this markup.
+ */
+
 ?>
+
 <h2 class="c-heading <?php echo esc_attr( $modifier_class ?? '' ); ?>"><?php echo esc_html( $c_heading_text ?? '' ); ?></h2>
-<?php \PMC::render_template( CHILD_THEME_PATH . '/template-parts/patterns/modules/trending.php', $item, true ); ?>

package/__tests__/fixtures/template-parts-expected/patterns/components/c-logo.php

@@ -0,0 +1,12 @@
+<?php
+/**
+ * Generated file.
+ *
+ * Refer to the relevant Twig file for adjusting this markup.
+ */
+
+?>
+
+<div>
+	<?php \PMC::render_template( \PMC\Larva\Config::get_instance()->get( 'brand_directory' ) . '/build/svg/' . ( $c_logo_svg ?? '' ) . '.svg', [], true ); ?>
+</div>

package/__tests__/fixtures/template-parts-expected/patterns/components/c-nav-link.php

@@ -1,6 +1,12 @@
 <?php
-// This is a generated file. Refer to the relevant Twig file for adjusting this markup.
+/**
+ * Generated file.
+ *
+ * Refer to the relevant Twig file for adjusting this markup.
+ */
+
 ?>
+
 <a class="c-nav-link <?php echo esc_attr( $c_nav_link_classes ?? '' ); ?>" href="<?php echo esc_url( $c_nav_link_url ?? '' ); ?>">
 	<?php echo esc_html( $c_nav_link_text ?? '' ); ?>
-</a>
+</a>

package/__tests__/fixtures/template-parts-expected/patterns/modules/array-key-in-loop.php

@@ -0,0 +1,20 @@
+<?php
+/**
+ * Generated file.
+ *
+ * Refer to the relevant Twig file for adjusting this markup.
+ */
+
+?>
+
+<?php foreach ( $list_items ?? [] as $item ) { ?>
+	<li class="list__item larva // <?php echo esc_attr( $list_item_classes ?? '' ); ?>">
+		<?php if ( ! empty( $item['list_items'] ) ) { ?>
+			<?php \PMC\Larva\Pattern::get_instance()->render_pattern_template( 'modules/list', $item, true ); ?>
+		<?php } else { ?>
+			<div class="<?php echo esc_attr( $item['list_item_classes'] ?? '' ); ?>">
+				<?php echo wp_kses_post( $item['list_item_markup'] ?? '' ); ?>
+			</div>
+		<?php } ?>
+	</li>
+<?php } ?>

package/__tests__/fixtures/template-parts-expected/patterns/modules/breadcrumbs.php

@@ -1,4 +1,10 @@
 <?php
-// This is a generated file. Refer to the relevant Twig file for adjusting this markup.
+/**
+ * Generated file.
+ *
+ * Refer to the relevant Twig file for adjusting this markup.
+ */
+
 ?>
-<?php \PMC::render_template( CHILD_THEME_PATH . '/template-parts/patterns/objects/o-nav.php', $o_nav, true ); ?>
+
+<?php \PMC\Larva\Pattern::get_instance()->render_pattern_template( 'objects/o-nav', $o_nav, true ); ?>

package/__tests__/fixtures/template-parts-expected/patterns/modules/escaped-output-in-loop.php

@@ -0,0 +1,5 @@
+<?php foreach ( $slides ?? [] as $item ) { ?>
+	<div>
+		<?php echo wp_kses_post( $item ?? '' ); ?>
+	</div>
+<?php } ?>

package/__tests__/fixtures/template-parts-expected/patterns/modules/html-tag-interpolation.php

@@ -0,0 +1,16 @@
+<?php
+/**
+ * Generated file.
+ *
+ * Refer to the relevant Twig file for adjusting this markup.
+ */
+
+?>
+
+<<?php echo esc_attr( $list_type_name ?? '' ); ?>l class="list larva // <?php echo esc_attr( $list_classes ?? '' ); ?>">
+	<?php foreach ( $list_items ?? [] as $item ) { ?>
+		<li class="list__item larva // <?php echo esc_attr( $list_item_classes ?? '' ); ?>">
+			<?php \PMC\Larva\Pattern::get_instance()->render_pattern_template( 'modules/list', $item, true ); ?>
+		</li>
+	<?php } ?>
+</<?php echo esc_attr( $list_type_name ?? '' ); ?>l>

package/__tests__/fixtures/template-parts-expected/patterns/modules/trending.php

@@ -1,11 +1,18 @@
 <?php
-// This is a generated file. Refer to the relevant Twig file for adjusting this markup.
+/**
+ * Generated file.
+ *
+ * Refer to the relevant Twig file for adjusting this markup.
+ */
+
 ?>
+
 <section class="u-max-width-300">
 	<header>
-		<?php \PMC::render_template( CHILD_THEME_PATH . '/template-parts/patterns/components/c-heading.php', $c_heading, true ); ?>
+		<?php \PMC\Larva\Pattern::get_instance()->render_pattern_template( 'components/c-heading', $c_heading, true ); ?>
 	</header>
 	<div class="pmc-u-margin-b-0 u-border-bottom-2">
-		<?php \PMC::render_template( CHILD_THEME_PATH . '/template-parts/patterns/objects/o-story-list.php', $o_story_list, true ); ?>
+		<?php \PMC\Larva\Pattern::get_instance()->render_pattern_template( 'objects/o-story-list', $o_story_list, true ); ?>
 	</div>
+	<?php do_action( 'trending_ads_wp_action' ); ?>
 </section>

package/__tests__/fixtures/template-parts-expected/patterns/objects/o-crap.php

@@ -1,4 +1,10 @@
 <?php
-// This is a generated file. Refer to the relevant Twig file for adjusting this markup.
+/**
+ * Generated file.
+ *
+ * Refer to the relevant Twig file for adjusting this markup.
+ */
+
 ?>
+
 <p class="o-crap <?php echo esc_attr( $modifier_class ?? '' ); ?> <?php echo esc_attr( $o_crap_classes ?? '' ); ?>"><?php echo esc_html( $o_crap_text ?? '' ); ?></p>

package/__tests__/fixtures/template-parts-expected/patterns/objects/o-nav.php

@@ -1,6 +1,12 @@
 <?php
-// This is a generated file. Refer to the relevant Twig file for adjusting this markup.
+/**
+ * Generated file.
+ *
+ * Refer to the relevant Twig file for adjusting this markup.
+ */
+
 ?>
+
 <nav class="o-nav <?php echo esc_attr( $modifier_class ?? '' ); ?> <?php echo esc_attr( $o_nav_classes ?? '' ); ?>" data-dropdown="<?php echo esc_attr( $o_nav_data_attributes ?? '' ); ?>">
 
 	<?php if ( ! empty( $o_nav_title_text ) ) { ?>
@@ -10,7 +16,11 @@
 	<ul class="o-nav__list <?php echo esc_attr( $o_nav_list_classes ?? '' ); ?>" data-dropdown-list="<?php echo esc_attr( $o_nav_list_data_attributes ?? '' ); ?>">
 		<?php foreach ( $o_nav_list_items ?? [] as $item ) { ?>
 			<li class="o-nav__list-item <?php echo esc_attr( $o_nav_list_item_classes ?? '' ); ?>" data-dropdown-list-item="<?php echo esc_attr( $o_nav_list_item_data_attributes ?? '' ); ?>">
-				<?php \PMC::render_template( CHILD_THEME_PATH . '/template-parts/patterns/components/c-nav-link.php', $item, true ); ?>
+				<?php \PMC\Larva\Pattern::get_instance()->render_pattern_template( 'components/c-nav-link', $item, true ); ?>
+				
+				<?php if ( ! empty( $item['newsletter_dropdown'] ) ) { ?>
+					<?php \PMC\Larva\Pattern::get_instance()->render_pattern_template( 'modules/newsletter-dropdown', $item['newsletter_dropdown'], true ); ?>
+				<?php } ?>
 			</li>
 		<?php } ?>
 	</ul>

package/__tests__/fixtures/template-parts-expected/patterns/objects/o-story-list.php

@@ -1,10 +1,16 @@
 <?php
-// This is a generated file. Refer to the relevant Twig file for adjusting this markup.
+/**
+ * Generated file.
+ *
+ * Refer to the relevant Twig file for adjusting this markup.
+ */
+
 ?>
+
 <ul class="o-story-list <?php echo esc_attr( $modifier_class ?? '' ); ?> <?php echo esc_attr( $o_story_list_classes ?? '' ); ?>">
 	<?php foreach ( $o_story_list_teases ?? [] as $item ) { ?>
 		<li class="o-story-list__item <?php echo esc_attr( $o_story_list_item_classes ?? '' ); ?>">
-			<?php \PMC::render_template( CHILD_THEME_PATH . '/template-parts/patterns/objects/o-tease.php', $item, true ); ?>
+			<?php \PMC\Larva\Pattern::get_instance()->render_pattern_template( 'objects/o-tease', $item, true ); ?>
 		</li>
 	<?php } ?>
 </ul>

package/__tests__/parser-methods.test.js

@@ -1,16 +1,11 @@
 const assert = require( 'assert' );
-( path = require( 'path' ) );
-( fs = require( 'fs' ) );
 
 const parserMethods = require( '../index.js' ).methods;
-const exec = require( 'child_process' ).exec;
-
-const fixture = path.join( __dirname, 'fixtures' );
 
 const expectations = {
 	childInclude: '<?php \\PMC::render_template( CHILD_THEME_PATH . \'/template-parts/patterns/objects/o-nav.php\', $o_nav, true ); ?>',
-	larvaInclude: '<?php \\PMC::render_template( CHILD_THEME_PATH . \'/template-parts/patterns/objects/o-nav.php\', $o_nav, true ); ?>'
-	// larvaInclude: '<?php \\PMC::render_template( PMC_CORE_PATH . \'/template-parts/patterns/objects/o-nav.php\', $o_nav, true ); ?>' - uncomment when core logic is reactivated
+	larvaInclude: '<?php \\PMC::render_template( PMC_CORE_PATH . \'/template-parts/patterns/objects/o-nav.php\', $o_nav, true ); ?>',
+	pluginEnabled: '<?php \\PMC\\Larva\\Pattern::get_instance()->render_pattern_template( \'objects/o-nav\', $o_nav, true ); ?>'
 };
 
 describe( 'parse include statements', function() {
@@ -28,16 +23,86 @@ describe( 'parse include statements', function() {
 	});
 
 	it( 'if larva namespace, parsed path references the parent theme', ( done ) => {
+
 		parserMethods.parseIncludePath(
 			'{% include "@larva/objects/o-nav.twig" with o_nav %}',
 			'o-nav',
-			'o_nav' )
+			'o_nav'
+		)
 		.catch( e => console.log( e ) )
 		.then( ( result ) => {
 			assert.equal( result, expectations.larvaInclude );
 			done();
+		} );
+	} );
+
+	it( 'if plugin is enabled, use the render_pattern_template method from Larva', ( done ) => {
+
+		parserMethods.parseIncludePath(
+			'{% include "@project/objects/o-nav.twig" with o_nav %}',
+			'o-nav',
+			'o_nav',
+			true )
+			.catch( e => console.log( e ) )
+			.then( ( result ) => {
+				assert.equal( result, expectations.pluginEnabled );
+				done();
+			} );
+	} );
+
+});
+
+describe( 'parse SVG includes', function () {
+	it( 'parses includes to brand_directory when using plugin', ( done ) => {
+
+		const expectedPluginEnabled = '<?php \\PMC::render_template( \\PMC\\Larva\\Config::get_instance()->get( \'brand_directory\' ) . \'/build/svg/\' . ( $c_logo_svg ?? \'\' ) . \'.svg\', [], true ); ?>';
+
+		parserMethods.parseSvgPath(
+			"{% include '../../build/svg/' ~ c_logo_svg ~ '.svg' %}",
+			'c_logo_svg',
+			true
+		)
+		.catch( e => console.log( e ) )
+		.then( ( result ) => {
+			assert.equal( result, expectedPluginEnabled );
+			done();
+		});
+	} );
+	it( 'parses includes to CHILD_THEME_PATH when not using plugin', ( done ) => {
+
+		const expected = '<?php \\PMC::render_template( CHILD_THEME_PATH . \'/assets/build/svg/\' . ( $c_logo_svg ?? \'\' ) . \'.svg\', [], true ); ?>';
+
+		parserMethods.parseSvgPath(
+			"{% include '../../build/svg/' ~ c_logo_svg ~ '.svg' %}",
+			'c_logo_svg'
+		)
+		.catch( e => console.log( e ) )
+		.then( ( result ) => {
+			assert.equal( result, expected );
+			done();
 		});
 	});
+} );
 
-});
+describe( 'parse custom functions', function () {
+	it( 'parses wp_action function', ( done ) => {
+
+		parserMethods.parseWpAction("{{wp_action('test','param',variable)}}")
+			.catch( e => console.log( e ) )
+			.then( ( result ) => {
+				assert.equal( result, "<?php do_action( 'test', 'param', $variable ); ?>" );
+				done();
+			});
+
+		// Test spacing
+		parserMethods.parseWpAction("{{ 	wp_action( 	'test', 	'param', 	variable 	) 	}}")
+			.catch( e => console.log( e ) )
+			.then( ( result ) => {
+				assert.equal( result, "<?php do_action( 'test', 'param', $variable ); ?>" );
+				done();
+			});
+
+	} );
+
+} );
 

package/__tests__/twig-to-php-parser.test.js

@@ -5,55 +5,57 @@ const twigToPhpParser = require( '../index' ).twigToPhpParser;
 const exec = require( 'child_process' ).exec;
 
 const fixture = path.join( __dirname, 'fixtures' );
+const expectedDir = `${fixture}/template-parts-expected/patterns/`;
 
-const pathConfig = {
-	twigDir: `${fixture}/src/patterns/`,
-	phpDir: `${fixture}/template-parts/patterns/`,
-	expectedDir: `${fixture}/template-parts-expected/patterns/`,
-};
+const getAppConfiguration = require( '../lib/getConfig' );
+const appConfiguration = getAppConfiguration( 'parser' );
 
 const patternShortPaths = [
 	'components/c-byline.php',
 	'components/c-heading.php',
 	'components/c-button.php',
+	'components/c-logo.php',
 	'objects/o-nav.php',
 	'objects/o-story-list.php',
 	'modules/trending.php',
+	'modules/array-key-in-loop.php',
+	'modules/html-tag-interpolation.php',
 ];
 
 describe( 'twig to php parser', function() {
 
 	beforeEach( ( done ) => {
-		exec( 'mkdir ' + pathConfig.phpDir, ( err  ) => {
+
+		exec( 'mkdir ' + appConfiguration.phpDir, ( err  ) => {
 			if ( err ) {
 				console.error( err );
 			}
 		});
 
-		return twigToPhpParser( pathConfig.twigDir, pathConfig.phpDir )
+		return twigToPhpParser( appConfiguration )
 		.catch( ( e ) => console.log( e ) )
 		.then( ( result ) => done() ); // Catch PHP errors.
 	});
 
 	it( 'creates new files and directories for objects, components, and modules', ( done ) => {
-		assert.equal( fs.existsSync( pathConfig.phpDir + 'objects/o-nav.php' ), true );
-		assert.equal( fs.existsSync( pathConfig.phpDir + 'components/c-nav-link.php' ), true );
-		assert.equal( fs.existsSync( pathConfig.phpDir + 'modules/breadcrumbs.php' ), true );
+		assert.equal( fs.existsSync( appConfiguration.phpDir + 'objects/o-nav.php' ), true );
+		assert.equal( fs.existsSync( appConfiguration.phpDir + 'components/c-nav-link.php' ), true );
+		assert.equal( fs.existsSync( appConfiguration.phpDir + 'modules/breadcrumbs.php' ), true );
 		done();
 	});
 
 	it( 'parses patterns as expected', ( done ) => {
 		patternShortPaths.forEach( ( shortpath ) => {
-			let expectedContents = fs.readFileSync( pathConfig.expectedDir + shortpath ).toString();
-			let actualContents = fs.readFileSync( pathConfig.phpDir + shortpath ).toString();
-			
-			assert.equal( expectedContents, actualContents );
+			let expectedContents = fs.readFileSync( expectedDir + shortpath ).toString();
+			let actualContents = fs.readFileSync( appConfiguration.phpDir + shortpath ).toString();
+
+			assert.equal( actualContents, expectedContents );
 		});
 		done();
 	});
 
 	afterEach( () => {
-		exec( 'rm -r ' + pathConfig.phpDir, ( err ) => {
+		exec( 'rm -r ' + appConfiguration.phpDir, ( err ) => {
 			if ( err ) {
 				console.error( err );
 			}

package/index.js

@@ -1,18 +1,48 @@
 const execPhp = require( 'exec-php' );
 const path = require( 'path' );
 const chalk = require( 'chalk' );
-const getAppConfiguration = require( '@penskemediacorp/larva' ).config;
-const RELATIVE_OUPUT_PATH = '../template-parts/patterns'; // Not permitted to override this because it will break the include paths.
+const getAppConfiguration = require( './lib/getConfig' );
+const config = getAppConfiguration( 'parser' );
 
 /**
  * Twig to PHP Parser
- * 
- * @param {string} twigDirPath Absolute path to Twig patterns
- * @param {string} phpDirPath Absolute path to PHP output
- * @param {object} config Containing 
+ *
+ * @param {object} config Optional object containing configuration. See the
+ *                        package README for supported configuration.
  */
 
-function twigToPhpParser( twigDirPath, phpDirPath, config = {} ) {
+function twigToPhpParser( config = {} ) {
+
+	// TODO: We need some kind of wrapper here for config...or better:
+	// move this to pmc-plugins/pmc-larva and scrap this awkward JS
+	// execPhp wrapper situation, and use Larva\Config for this config.
+	let twigDir = path.join( process.cwd(), './src/patterns' );
+	let phpDir = path.join( process.cwd(), '../template-parts/patterns' );
+	let isUsingPlugin = false;
+
+	if ( 'undefined' !== typeof config.twigDir ) {
+		if ( config.twigDir.startsWith( '.' ) ) {
+			twigDir = path.join( process.cwd(), config.twigDir );
+		} else {
+			twigDir = config.twigDir;
+		}
+	}
+	else if ( 'undefined' !== typeof config.relativeSrcOverride ) {
+		if ( config.relativeSrcOverride.startsWith( '/' ) ) {
+			twigDir = config.relativeSrcOverride;
+		}
+		else {
+			twigDir = path.join( process.cwd(), config.relativeSrcOverride );
+		}
+	}
+
+	if ( 'undefined' !== typeof config.isUsingPlugin ) {
+		isUsingPlugin = config.isUsingPlugin;
+	}
+
+	if ( 'undefined' !== typeof config.phpDir ) {
+		phpDir = config.phpDir;
+	}
 
 	return new Promise( ( resolve, reject ) => {
 
@@ -22,7 +52,7 @@ function twigToPhpParser( twigDirPath, phpDirPath, config = {} ) {
 				reject( error );
 			}
 
-			php.twig_to_php_parser( twigDirPath, phpDirPath, function( error, result, output, printed ) {
+			php.twig_to_php_parser( twigDir, phpDir, isUsingPlugin, function( error, result, output, printed ) {
 
 				if ( error ) {
 					reject( error );
@@ -38,7 +68,7 @@ function twigToPhpParser( twigDirPath, phpDirPath, config = {} ) {
 
 };
 
-function parseIncludePath( twigIncludeStr, patternName, dataName, config = {} ) {
+function parseIncludePath( twigIncludeStr, patternName, dataName, isUsingPlugin = false ) {
 
 	return new Promise( ( resolve, reject ) => {
 
@@ -48,7 +78,7 @@ function parseIncludePath( twigIncludeStr, patternName, dataName, config = {} )
 				reject( error );
 			}
 
-			php.parse_include_path( twigIncludeStr, patternName, dataName, function( error, result, output, printed ) {
+			php.parse_include_path( twigIncludeStr, patternName, dataName, isUsingPlugin, function( error, result, output, printed ) {
 
 				if ( error ) {
 					reject( error );
@@ -64,18 +94,70 @@ function parseIncludePath( twigIncludeStr, patternName, dataName, config = {} )
 
 };
 
+function parseSvgPath( twigSvgIncludeStr, svgName, isUsingPlugin = false ) {
+
+	return new Promise( ( resolve, reject ) => {
+
+		execPhp( path.resolve( __dirname, './lib/twig-to-php-parser.php' ), config.phpBinaryPath, function( error, php, output ) {
+
+			if ( error ) {
+				reject( error );
+			}
+
+			php.parse_svg_path( twigSvgIncludeStr, svgName, isUsingPlugin, function( error, result, output, printed ) {
+
+				if ( error ) {
+					reject( error );
+				}
+
+				resolve( result );
+
+			});
+
+		});
+
+	});
+
+};
+
+function parseWpAction( twigMarkup ) {
+	return new Promise( ( resolve, reject ) => {
+
+		execPhp( path.resolve( __dirname, './lib/twig-to-php-parser.php' ), config.phpBinaryPath, function( error, php, output ) {
+
+			if ( error ) {
+				reject( error );
+			}
+
+			php.parse_wp_action( twigMarkup, function( error, result, output, printed ) {
+
+				if ( error ) {
+					reject( error );
+				}
+
+				resolve( result );
+
+			});
+
+		});
+
+	});
+
+}
+
 module.exports = {
 	twigToPhpParser: twigToPhpParser,
 	methods: {
-		parseIncludePath: parseIncludePath
+		parseIncludePath: parseIncludePath,
+		parseSvgPath: parseSvgPath,
+		parseWpAction: parseWpAction
 	},
 	run: () => {
-		let config = getAppConfiguration( 'parser' );
-		let relativeSrcPath = config.relativeSrcOverride || './src/patterns';
-
-		twigToPhpParser( path.resolve( process.cwd(), relativeSrcPath ), path.resolve( process.cwd(), RELATIVE_OUPUT_PATH ), config )
-		.catch( e => console.log( e ) ) // PHP errors
-		.then( result => console.log( chalk.green( 'Completed parsing Twig templates to PHP.' ) ) )
-		.catch( e => console.log( e ) );
+		twigToPhpParser( config )
+			.catch( e => console.log( e ) ) // PHP errors
+			.then( result => console.log(
+				chalk.green( 'Completed parsing Twig templates to PHP.' )
+			) )
+			.catch( e => console.log( e ) );
 	}
 };

package/lib/getConfig.js

@@ -0,0 +1,42 @@
+const chalk = require( 'chalk' );
+const path = require( 'path' );
+
+/**
+ * Get Larva Configuration.
+ *
+ * Find larva.config.js according to the current working directory.
+ * For consuming projects, this will be theme/assets/, and for the
+ * mono-repo, it will be packages/larva.
+ *
+ * For test env, the CWD is overridden to the local directory for fixtures.
+ * (this is a problem for writing project-level tests, but for a later time.)
+ *
+ * Note that this is copied from packages/larva/lib in order to
+ * remove dependency.
+ *
+ * @param tool string that indicates a specific configuration property, e.g. patterns.
+ *
+ * @return value of the specified key.
+ */
+
+module.exports = function getAppConfiguration( key ) {
+
+	try {
+		let appRoot = process.cwd();
+
+		if ( 'test' === process.env.NODE_ENV ) {
+			appRoot = path.join( __dirname, '../__tests__/fixtures' );
+		}
+
+		let config = require( `${appRoot}/larva.config.js` )[ key ];
+
+		if ( undefined === config ) {
+			throw new Error( `Configuration for \`${key}\` is required in larva.config.js. \nPlease refer to the Larva's docs for adding configuration: https://github.com/penske-media-corp/pmc-larva` );
+		}
+
+		return config;
+
+	} catch ( error ) {
+		console.error( chalk.red( chalk.bold( 'There is no larva.config.js in this directory.\n' ) + error ) );
+	}
+};

package/lib/twig-to-php-parser.php

@@ -1,80 +1,94 @@
 <?php
-
 /**
  * Twig to PHP Patterns Parser
- * 
+ *
  * This will slowly be broken up into smaller, testable functions that
  * can be refactored into node if we choose to go that route.
- * 
- * @since 06/26/2019
- * @author Lara Schenck and Amit Sannad
+ *
+ * @since   06/26/2019
+ * @author  Lara Schenck and Amit Sannad
+ * @package pmc-lavra
  */
 
-function twig_to_php_parser( $patterns_dir_path, $template_dir_path ) {
-	$twig_files        = [];
+/**
+ * Function parser to convert twig to php.
+ *
+ * @param  string $patterns_dir_path patterns path.
+ * @param  string $template_dir_path template directory path.
+ * @param  bool   $is_using_plugin   whether or not plugin is in use.
+ * @return void
+ */
+function twig_to_php_parser( $patterns_dir_path, $template_dir_path, $is_using_plugin ) {
+	$twig_files = [];
 
 	$twig_dir_iterator      = new \RecursiveDirectoryIterator( $patterns_dir_path );
 	$recirsive_dir_iterator = new \RecursiveIteratorIterator( $twig_dir_iterator );
 	$all_twig_files         = new \RegexIterator( $recirsive_dir_iterator, '/\.twig/' );
 
-	// Get all twig twig_files to generate template for
+	// Get all twig twig_files to generate template for.
 	foreach ( $all_twig_files as $info ) {
 		$twig_files[] = $info->getPathname();
 	}
 
 	foreach ( $twig_files as $twig_file ) {
 
-		// All components of path in array split by /
+		// All components of path in array split by /.
 		$twig_path_arr = explode( '/', $twig_file );
-		
-		// Get last three parts of the file that includes directory
+
+		// Get last three parts of the file that includes directory.
 		$path_info = array_slice( $twig_path_arr, count( $twig_path_arr ) - 3, 3 );
 
 		// Generate directory where we wanna write PHP template. Remove any thing thats not alpha string i.e. remove specials chars including numbers
-		// "/patterns/06-components/c-title/c-title.twig" => "/template-parts/patterns/components/c-title.php"
+		// "/patterns/06-components/c-title/c-title.twig" => "/template-parts/patterns/components/c-title.php".
 		$template_dir = $template_dir_path . '/' . preg_replace( '/[^A-Za-z]/', '', $path_info[0] );
 
-		// Generate path where we wanna write php template
+		// Generate path where we wanna write php template.
 		$path = $template_dir . '/' . str_replace( '.twig', '.php', $path_info[2] );
 
+		debug_log( sprintf( 'Source: %s', $twig_file ) );
+		debug_log( sprintf( 'Target: %s', $path ) );
+
 		if ( file_exists( $path ) ) {
 
-			// Get file time of template and twig
+			// Get file time of template and twig.
 			$fmtime_twig     = filemtime( $twig_file );
 			$fmtime_template = filemtime( $path );
 
-			// Compare twig file time to php template filetime. If twig file is newer than php template then overwrite the php template
-			// This is to make sure we are not unnecessarily overwriting the php template
+			// Compare twig file time to php template filetime. If twig file is newer than php template then overwrite the php template.
+			// This is to make sure we are not unnecessarily overwriting the php template.
 			if ( $fmtime_twig < $fmtime_template ) {
-
+				debug_log( sprintf( "  -> Skipped, twig timestamp: %s, template timestamp: %s\n", $fmtime_twig, $fmtime_template ) );
 				// NOTE: Ignoring this just to fixing pipeline, however it's showing 100% coverage in local.
 				// Ignoring this line is suggested by teach lead.
 				continue; // @codeCoverageIgnore
 			}
-
 		}
 
 		// Get matches for `{% if VARIABLE %}`
 		// If condition regex.
-		// https://regex101.com/r/Lnoaau/1
-		$if_condition_regex = '/({% if\s*)(\w*)(\s*%})/';
+		// https://regex101.com/r/BwA2r0/1.
+		$if_condition_regex = '/({% if\s*)(\w*\[\'\w+\'\]|\w+)(\s*%})/';
 
-		// Get matches for `{% for item in VARIABLE`
-		// https://regex101.com/r/lceCnz/2/
-		$loop_regex = '/({% for item in\s*)(\w*)/';
+		// Get matches for `{% for item in VARIABLE`.
+		// https://regex101.com/r/ijLuIA/3.
+		$loop_regex = '/({% for (\w*\[\'\w+\'\]|\w+) in\s*)(\w*\[\'\w+\'\]|\w+)/';
 
-		// Get matches for {{ name }}
-		// https://regex101.com/r/ACN0rE/1
-		$mustache_regex = '/({{\s*)(\w*)(\s*}})/';
+		// Get matches for {{ name }}, {{ name|filter }}, {{ name['item'] }}
+		// https://regex101.com/r/ACN0rE/5.
+		$mustache_regex = '/({{\s*)(\w*?\[?\'?\w*\'?\]?\|?\w*)(\s*}})/';
 
-		// Get matches for {% include "path/c-element.twig" with data %}
-		// https://regex101.com/r/ns5kBR/2
-		$include_regex = '/({%\sinclude ")(.*[c-|o-|l-].*\/)(.*)(.twig)(" with )(\w*)(.*\s%})/';
+		// Get matches for {% include "path/c-element.twig" with data['some_data'] %}
+		// https://regex101.com/r/ns5kBR/3.
+		$include_regex = '/({%\sinclude ")(.*[c-|o-|l-].*\/)(.*)(.twig)(" with )(\w*?\[?\'?\w*\'?\]?\|?\w*)(\s%})/';
 
-		$twig_markup = \file_get_contents( $twig_file );
+		// Get matches for {% include '/path/here/' ~ variable_svg ~ '.svg' %}
+		// https://regex101.com/r/pdleQb/3.
+		$svg_regex = '/({%\sinclude\s.*)(\s?\~\s?)(\S*)(\s?\~\s?)(.*\s.*)(%})/';
+
+		$twig_markup = \file_get_contents( $twig_file ); // phpcs:ignore
 
 		$general_replacers = [
-			'{#'           => '<?php /*' . "\n",
+			'{#'           => '<?php' . "\n/**" . "\n",
 			'#}'           => '*/' . "\n" . '?>',
 			'{% endif %}'  => '<?php } ?>',
 			'{% else %}'   => '<?php } else { ?>',
@@ -88,12 +102,14 @@ function twig_to_php_parser( $patterns_dir_path, $template_dir_path ) {
 		preg_match_all( $loop_regex, $twig_markup, $loop_matches );
 		preg_match_all( $mustache_regex, $twig_markup, $mustache_matches );
 		preg_match_all( $include_regex, $twig_markup, $include_matches );
+		preg_match_all( $svg_regex, $twig_markup, $svg_matches );
 
 		// Prepare empty arrays to gather the replacements as they are processed.
 		$if_condition_replacements = [];
 		$loop_replacements         = [];
 		$mustache_replacements     = [];
 		$include_replacements      = [];
+		$svg_replacements          = [];
 
 		$count = 0;
 		foreach ( $if_condition_matches[0] as $key => $match ) {
@@ -108,9 +124,10 @@ function twig_to_php_parser( $patterns_dir_path, $template_dir_path ) {
 		$count = 0;
 		foreach ( $loop_matches[0] as $key => $match ) {
 
-			$variable_name = $loop_matches[2][ $count ];
+			$key_name      = $loop_matches[2][ $count ];
+			$variable_name = $loop_matches[3][ $count ];
 
-			$loop_replacements[ $count ] = '<?php foreach ( $' . $variable_name . ' ?? [] as $item';
+			$loop_replacements[ $count ] = '<?php foreach ( $' . $variable_name . ' ?? [] as $' . $key_name;
 
 			$count ++;
 		}
@@ -119,11 +136,24 @@ function twig_to_php_parser( $patterns_dir_path, $template_dir_path ) {
 		foreach ( $mustache_matches[0] as $key => $match ) {
 
 			$variable_name = $mustache_matches[2][ $count ];
-			$is_attr       = strpos( $match, 'class' ) || strpos( $match, 'name' ) || strpos( $match, 'attr' );
-			$is_url        = strpos( $match, 'url' );
-			$is_text       = strpos( $match, 'text' );
-			$is_data_attr  = strpos( $match, 'attributes' );
-			$is_markup     = strpos( $match, 'markup' );
+
+			$is_attr      = strpos( $match, '_class' ) || strpos( $match, '_name' ) || strpos( $match, '_attr' );
+			$is_url       = strpos( $match, '_url' );
+			$is_text      = strpos( $match, '_text' );
+			$is_data_attr = strpos( $match, '_attributes' );
+			$is_markup    = strpos( $match, '_markup' );
+			$is_action    = strpos( $match, '_wp_action' );
+			$has_filter   = strpos( $match, '|' );
+
+			// Remove the Twig filter from the variable name.
+			if ( $has_filter ) {
+				$string_parts  = explode( '|', $variable_name );
+				$variable_name = $string_parts[0];
+
+				if ( 'markup' === $string_parts[1] ) {
+					$is_markup = true;
+				}
+			}
 
 			if ( ! empty( $is_url ) ) {
 				$mustache_replacements[ $count ] = '<?php echo esc_url( $' . $variable_name . ' ?? \'\' ); ?>';
@@ -141,68 +171,195 @@ function twig_to_php_parser( $patterns_dir_path, $template_dir_path ) {
 				$mustache_replacements[ $count ] = '<?php echo wp_kses_post( $' . $variable_name . ' ?? \'\' ); ?>';
 			}
 
+			if ( ! empty( $is_action ) ) {
+				$mustache_replacements[ $count ] = '<?php do_action( \'' . $variable_name . '\' ); ?>';
+			}
+
 			$count ++;
 		}
 
 		// Reset the count to begin accumulating $include_replacements.
 		$count = 0;
-
 		foreach ( $include_matches[0] as $include ) {
 			$include_replacements[ $count ] = parse_include_path(
 				$include,
 				$include_matches[3][ $count ],
-				$include_matches[6][ $count ]
+				$include_matches[6][ $count ],
+				$is_using_plugin
+			);
+			$count ++;
+		}
+
+		// Reset the count to begin accumulating $include_replacements.
+		$count = 0;
+		foreach ( $svg_matches[0] as $svg ) {
+			$svg_replacements[ $count ] = parse_svg_path(
+				$svg,
+				$svg_matches[3][ $count ],
+				$is_using_plugin
 			);
 			$count ++;
 		}
 
 		// Merge replacements and matches arrays.
-		$all_matches      = (array) array_merge( $mustache_matches[0], $include_matches[0], $loop_matches[0], $if_condition_matches[0] );
-		$all_replacements = (array) array_merge( $mustache_replacements, $include_replacements, $loop_replacements, $if_condition_replacements );
+		$all_matches = (array) array_merge(
+			$mustache_matches[0],
+			$include_matches[0],
+			$loop_matches[0],
+			$if_condition_matches[0],
+			$svg_matches[0]
+		);
+
+		$all_replacements = (array) array_merge(
+			$mustache_replacements,
+			$include_replacements,
+			$loop_replacements,
+			$if_condition_replacements,
+			$svg_replacements
+		);
 
 		// First replace matches from the regex's, then apply the general replacements.
 		$twig_markup_replace_main     = str_replace( $all_matches, $all_replacements, $twig_markup );
+		$twig_markup_replace_main     = parse_wp_action( $twig_markup_replace_main );
 		$twig_markup_replace_complete = str_replace( array_keys( (array) $general_replacers ), array_values( $general_replacers ), $twig_markup_replace_main );
 
-		$php_markup  = "<?php\n// This is a generated file. Refer to the relevant Twig file for adjusting this markup.\n?>\n";
+		$php_markup  = "<?php\n/**\n * Generated file.\n *\n * Refer to the relevant Twig file for adjusting this markup.\n */\n\n?>\n\n";
 		$php_markup .= $twig_markup_replace_complete;
 
 		if ( ! file_exists( $template_dir ) ) {
 			mkdir( $template_dir );
 		}
 
-		file_put_contents( $path, $php_markup );
+		file_put_contents( $path, $php_markup ); // phpcs:ignore
+
+		debug_log( "  -> Template generated\n" );
 
 	}
 }
 
 /**
  * Parse Twig Includes
- * 
- * @param string $twig_include Full include expression
- * @param string $pattern_name o-nav
- * @param string $data_name o_nav / usually name of pattern with underscores
- * 
+ *
+ * @param string  $twig_include    Full include expression.
+ * @param string  $pattern_name    o-nav.
+ * @param string  $data_name       o_nav / usually name of pattern with underscores.
+ * @param boolean $is_using_plugin Whether or not the plugin is in use.
+ *
  * @return string PMC::render_template call
  */
-function parse_include_path( $twig_include, $pattern_name, $data_name ) {
-	$theme_dir = 'CHILD_THEME_PATH';
-	$start_name = substr( $pattern_name, 0, 2 );
+function parse_include_path( $twig_include, $pattern_name, $data_name, $is_using_plugin ) {
+
+	$brand_directory   = 'CHILD_THEME_PATH';
+	$pattern_directory = '/template-parts/patterns/';
+	$start_name        = substr( $pattern_name, 0, 2 );
+	$pattern_type      = '';
 
-	// 08/09/19 - Disabling larva/core theme logic
-	// if ( strpos( $twig_include, "@larva" ) ) {
-	// 	$theme_dir = 'PMC_CORE_PATH';
-	// }
+	if ( strpos( $twig_include, '@larva' ) ) {
+		$brand_directory = 'PMC_CORE_PATH';
+	}
 
 	if ( 'c-' === $start_name ) {
-		$directory = 'components';
+		$pattern_type = 'components';
 	} elseif ( 'o-' === $start_name ) {
-		$directory = 'objects';
+		$pattern_type = 'objects';
 	} elseif ( '-' !== substr( $pattern_name, 1, 2 ) ) { // If there is no namespace, it is a module.
-		$directory = 'modules';
+		$pattern_type = 'modules';
 	}
 
-	 return "<?php \PMC::render_template( " . $theme_dir . " . '/template-parts/patterns/" . $directory . "/" . $pattern_name . ".php', $" . $data_name . ', true ); ?>';
+	if ( $is_using_plugin ) {
+		return "<?php \PMC\Larva\Pattern::get_instance()->render_pattern_template( '" . $pattern_type . '/' . $pattern_name . "', $" . $data_name . ", true ); ?>";
+	} else {
+		$pattern_partial_path = $pattern_directory . $pattern_type . '/' . $pattern_name;
+
+		return '<?php \PMC::render_template( ' . $brand_directory . " . '" . $pattern_partial_path  . ".php', $" . $data_name . ', true ); ?>';
+	}
+}
+
+/**
+ * Parse SVG Path
+ *
+ * @param string  $twig_include    Full include expression.
+ * @param string  $svg_name        Name of SVG file, excluding extension.
+ * @param boolean $is_using_plugin Whether or not the plugin is in use.
+ *
+ * @return string PMC::render_template call
+ */
+function parse_svg_path( $twig_include, $svg_name, $is_using_plugin ) {
+	$brand_directory = 'CHILD_THEME_PATH';
+	$svg_directory   = '/assets/build/svg/';
+	$start_name      = substr( $svg_name, 0, 2 );
+
+	if ( true === $is_using_plugin ) {
+		$svg_directory   = '/build/svg/';
+		$key_name        = 'brand_directory';
+		$brand_directory = "\PMC\Larva\Config::get_instance()->get( '" . $key_name . "' )";
+	} else {
+		if ( strpos( $twig_include, '@larva' ) ) {
+			$brand_directory = 'PMC_CORE_PATH';
+		}
+	}
+
+	return "<?php \PMC::render_template( " . $brand_directory . " . '" . $svg_directory . "' . ( $" . $svg_name . " ?? '' ) . '.svg', [], true ); ?>";
+}
+
+/**
+ * Parser responsible for translation custom twig function: {{ wp_action( ... ) }}
+ * See larva/lib/server.js twing.addFunction for details
+ *
+ * @param string $twig_markup twig markup string.
+ * @return string
+ */
+function parse_wp_action( string $twig_markup ) : string {
+
+	$twig_markup = preg_replace_callback(
+		'/{{\s*wp_action\s*\(\s*(.*?)\s*\)\s*}}/',
+		function ( $matches ) {
+
+			$args = $matches[1];
+
+			$args = preg_replace_callback(
+				'/\s*([\'"])?(\w+)\1?\s*/',
+				function ( $matches ) {
+					if ( ! empty( $matches[1] ) ) {
+						return sprintf( ' \'%s\'', $matches[2] );
+					} else {
+						return sprintf( ' $%s', $matches[2] );
+					}
+				},
+				$args
+			);
+
+			return '<?php do_action('. $args . ' ); ?>';
+
+		},
+		$twig_markup
+	);
+
+	return $twig_markup;
+}
+
+/**
+ * Set debug state.
+ *
+ * @param boolean $state debug state.
+ */
+function set_debug( bool $state ): void {
+	global $debug_state;
+	$debug_state = $state;
+}
+
+/**
+ * Log debug values.
+ *
+ * @param string $msg message to debug.
+ */
+function debug_log( string $msg ): void {
+	global $debug_state;
+	// write out to stderr for now.
+	if ( $debug_state ) {
+		fwrite( STDERR, sprintf( "%s\n", $msg ) ); // phpcs:ignore
+	}
 }
 
-//EOF
+// Set default to debug mode.
+set_debug( true );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@penskemediacorp/twig-to-php-parser",
-  "version": "1.10.0-alpha.0",
+  "version": "1.14.0",
   "description": "> TODO: description",
   "author": "laras126 <laras126@gmail.com>",
   "homepage": "https://github.com/penske-media-corp/pmc-larva#readme",
@@ -23,8 +23,8 @@
     "url": "https://github.com/penske-media-corp/pmc-larva/issues"
   },
   "dependencies": {
-    "@penskemediacorp/larva": "^1.10.0-alpha.0",
+    "chalk": "^4.1.0",
     "exec-php": "0.0.5"
   },
-  "gitHead": "b5be68c48f8238f421e6521abfe46eca18d51781"
+  "gitHead": "fbf545499333b58c945ad92d4be8ffa8a233bae3"
 }

package/__tests__/fixtures/template-parts/some-template.php

@@ -1,3 +0,0 @@
-<?php
-
-echo "placeholder to commit this directory";