Release: Emulsify Wordpress 2.0

.browserslistrc

@@ -1,7 +1,8 @@
 # Browsers that we support
 
-last 1 version
 > 1%
-maintained node versions
+last 2 versions
+Firefox ESR
+Chrome 41 # Support for Googlebot
 not dead
-ie 11
+not IE 9-11 # For IE 9-11 support, remove 'not'.

.gitattributes

@@ -0,0 +1,22 @@
+/.gitattributes export-ignore
+/.github export-ignore
+/.github/** export-ignore
+/.gitignore export-ignore
+/.husky export-ignore
+/.husky/** export-ignore
+/.browserslistrc export-ignore
+/.editorconfig export-ignore
+/.nvmrc export-ignore
+/CODE_OF_CONDUCT.md export-ignore
+/commitlint.config.js export-ignore
+/composer.lock export-ignore
+/husky.config.js export-ignore
+/package-lock.json export-ignore
+/package.json export-ignore
+/phpcs.xml.dist export-ignore
+/phpstan.neon.dist export-ignore
+/release.config.js export-ignore
+/scripts export-ignore
+/scripts/** export-ignore
+/whisk/.cli export-ignore
+/whisk/.cli/** export-ignore

.github/ISSUE_TEMPLATE.md

@@ -0,0 +1,11 @@
+Emulsify WordPress version (see [releases](https://github.com/emulsify-ds/emulsify-wordpress/releases)):
+
+**What you did:**
+
+**What happened:**
+
+**Reproduction repository (if necessary):**
+
+**Problem description:**
+
+**Suggested solution:**

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,13 @@
+**This PR does the following:**
+- Adds functionality bullet item
+- Fixes this or that bullet item
+
+### Related Issue(s)
+- [Title of the issue](https://github.com/emulsify-ds/emulsify-wordpress/issues/1) (if applicable)
+
+### Notes:
+- (optional) Document any intentionally unfinished parts or known issues within this PR
+
+### Functional Testing:
+- [ ] Document steps that allow someone to fully test your code changes. Include screenshot and links when appropriate.
+- [ ] Confirm `Practical theme readiness`, `PHP coding standards and static analysis`, `WordPress fixture smoke`, and `Extended Whisk Storybook and a11y` pass for changes targeting the protected release branches.

.github/fixtures/whisk-a11y/ci-readiness/ci-readiness.js

@@ -0,0 +1,4 @@
+/**
+ * Harmless Vite entry used only by the CI-seeded Whisk readiness fixture.
+ */
+export const ciReadinessFixture = true;

.github/fixtures/whisk-a11y/ci-readiness/ci-readiness.stories.js

@@ -0,0 +1,16 @@
+import template from './ci-readiness.twig';
+
+export default {
+  title: 'CI/Readiness fixture',
+};
+
+export const Default = {
+  render: (args) => template(args),
+  args: {
+    title: 'CI accessibility readiness',
+    summary:
+      'This component gives the component-agnostic starter one real story during continuous integration.',
+    url: 'https://www.emulsify.info',
+    link_text: 'Visit the Emulsify documentation',
+  },
+};

.github/fixtures/whisk-a11y/ci-readiness/ci-readiness.twig

@@ -0,0 +1,7 @@
+<main>
+  <article aria-labelledby="ci-readiness-title">
+    <h2 id="ci-readiness-title">{{ title }}</h2>
+    <p>{{ summary }}</p>
+    <a href="{{ url }}">{{ link_text }}</a>
+  </article>
+</main>

.github/scripts/acf-local-json-smoke.php

@@ -0,0 +1,216 @@
+<?php
+/**
+ * Smoke checks for ACF Local JSON path integration.
+ *
+ * @package Emulsify
+ */
+
+if ( PHP_SAPI !== 'cli' ) {
+	fwrite( STDERR, "This script must be run from the command line.\n" );
+	exit( 1 );
+}
+
+$GLOBALS['emulsify_acf_json_smoke_filters'] = array();
+
+if ( ! function_exists( 'add_filter' ) ) {
+	function add_filter( string $hook, callable $callback, int $priority = 10, int $accepted_args = 1 ): bool {
+		$GLOBALS['emulsify_acf_json_smoke_filters'][ $hook ][ $priority ][] = array(
+			'accepted_args' => $accepted_args,
+			'callback'      => $callback,
+		);
+
+		ksort( $GLOBALS['emulsify_acf_json_smoke_filters'][ $hook ] );
+
+		return true;
+	}
+}
+
+if ( ! function_exists( 'apply_filters' ) ) {
+	function apply_filters( string $hook, $value, ...$arguments ) {
+		if ( empty( $GLOBALS['emulsify_acf_json_smoke_filters'][ $hook ] ) ) {
+			return $value;
+		}
+
+		foreach ( $GLOBALS['emulsify_acf_json_smoke_filters'][ $hook ] as $callbacks ) {
+			foreach ( $callbacks as $callback ) {
+				$value = call_user_func_array(
+					$callback['callback'],
+					array_slice(
+						array_merge( array( $value ), $arguments ),
+						0,
+						$callback['accepted_args']
+					)
+				);
+			}
+		}
+
+		return $value;
+	}
+}
+
+if ( ! function_exists( 'get_stylesheet_directory' ) ) {
+	function get_stylesheet_directory(): string {
+		return $GLOBALS['emulsify_acf_json_smoke_child'];
+	}
+}
+
+/**
+ * Fails the smoke script when an assertion is false.
+ *
+ * @param bool   $condition Assertion condition.
+ * @param string $message   Failure message.
+ * @return void
+ */
+function emulsify_acf_json_smoke_assert( bool $condition, string $message ): void {
+	if ( ! $condition ) {
+		throw new RuntimeException( $message );
+	}
+}
+
+/**
+ * Recursively removes a path.
+ *
+ * @param string $path Path to remove.
+ * @return void
+ */
+function emulsify_acf_json_smoke_remove( string $path ): void {
+	if ( ! file_exists( $path ) ) {
+		return;
+	}
+
+	if ( is_file( $path ) || is_link( $path ) ) {
+		unlink( $path );
+		return;
+	}
+
+	$iterator = new RecursiveIteratorIterator(
+		new RecursiveDirectoryIterator( $path, RecursiveDirectoryIterator::SKIP_DOTS ),
+		RecursiveIteratorIterator::CHILD_FIRST
+	);
+
+	foreach ( $iterator as $item ) {
+		$item->isDir() && ! $item->isLink() ? rmdir( $item->getPathname() ) : unlink( $item->getPathname() );
+	}
+
+	rmdir( $path );
+}
+
+$repo_root = dirname( __DIR__, 2 );
+$work_root = sys_get_temp_dir() . '/emulsify-acf-local-json-' . uniqid( '', true );
+$child     = $work_root . '/child-theme';
+$default   = $child . '/config/acf-json';
+$custom    = $work_root . '/custom-acf-json';
+$extra     = $work_root . '/extra-acf-json';
+
+$GLOBALS['emulsify_acf_json_smoke_child'] = $child;
+
+try {
+	require_once $repo_root . '/includes/Acf/LocalJson.php';
+
+	$inactive = new Emulsify\Theme\Acf\LocalJson();
+	$inactive->register();
+
+	emulsify_acf_json_smoke_assert(
+		empty( $GLOBALS['emulsify_acf_json_smoke_filters']['acf/settings/save_json'] )
+		&& empty( $GLOBALS['emulsify_acf_json_smoke_filters']['acf/settings/load_json'] ),
+		'ACF Local JSON service should not register ACF filters when ACF is unavailable.'
+	);
+
+	if ( ! function_exists( 'acf' ) ) {
+		function acf(): bool {
+			return true;
+		}
+	}
+
+	$service = new Emulsify\Theme\Acf\LocalJson();
+	$service->register();
+
+	emulsify_acf_json_smoke_assert(
+		isset( $GLOBALS['emulsify_acf_json_smoke_filters']['acf/settings/save_json'] )
+		&& isset( $GLOBALS['emulsify_acf_json_smoke_filters']['acf/settings/load_json'] ),
+		'ACF Local JSON service should register ACF filters when ACF is available.'
+	);
+
+	$incoming_save = '/acf/default-save';
+	$incoming_load = array( '/acf/default-load' );
+
+	emulsify_acf_json_smoke_assert(
+		$incoming_save === apply_filters( 'acf/settings/save_json', $incoming_save ),
+		'ACF Local JSON save path should no-op when config/acf-json is missing.'
+	);
+	emulsify_acf_json_smoke_assert(
+		$incoming_load === apply_filters( 'acf/settings/load_json', $incoming_load ),
+		'ACF Local JSON load paths should no-op when config/acf-json is missing.'
+	);
+
+	if ( ! mkdir( $default, 0777, true ) || ! mkdir( $custom, 0777, true ) || ! mkdir( $extra, 0777, true ) ) {
+		throw new RuntimeException( 'Could not create ACF JSON smoke fixture directories.' );
+	}
+
+	emulsify_acf_json_smoke_assert(
+		$default === apply_filters( 'acf/settings/save_json', $incoming_save ),
+		'ACF Local JSON save path should use child config/acf-json by default.'
+	);
+	emulsify_acf_json_smoke_assert(
+		array( '/acf/default-load', $default ) === apply_filters( 'acf/settings/load_json', $incoming_load ),
+		'ACF Local JSON load paths should keep the default path and add child config/acf-json.'
+	);
+
+	add_filter(
+		'emulsify_theme_acf_json_remove_default_load_path',
+		static function (): bool {
+			return true;
+		}
+	);
+
+	emulsify_acf_json_smoke_assert(
+		array( $default ) === apply_filters( 'acf/settings/load_json', $incoming_load ),
+		'ACF Local JSON should remove the default load path only when explicitly configured.'
+	);
+
+	add_filter(
+		'emulsify_theme_acf_json_save_path',
+		static function () use ( $custom ): string {
+			return $custom;
+		}
+	);
+
+	add_filter(
+		'emulsify_theme_acf_json_load_paths',
+		static function ( array $paths ) use ( $extra ): array {
+			$paths[] = $extra;
+
+			return $paths;
+		}
+	);
+
+	emulsify_acf_json_smoke_assert(
+		$custom === apply_filters( 'acf/settings/save_json', $incoming_save ),
+		'ACF Local JSON save path filter should override the default save path.'
+	);
+	emulsify_acf_json_smoke_assert(
+		array( $custom, $extra ) === apply_filters( 'acf/settings/load_json', $incoming_load ),
+		'ACF Local JSON load paths filter should alter final load paths.'
+	);
+
+	add_filter(
+		'emulsify_theme_acf_json_enabled',
+		static function (): bool {
+			return false;
+		},
+		1
+	);
+
+	emulsify_acf_json_smoke_assert(
+		$incoming_save === apply_filters( 'acf/settings/save_json', $incoming_save )
+		&& $incoming_load === apply_filters( 'acf/settings/load_json', $incoming_load ),
+		'ACF Local JSON enabled filter should disable all path changes.'
+	);
+
+	echo "ACF Local JSON smoke checks passed.\n";
+} catch ( Throwable $throwable ) {
+	fwrite( STDERR, $throwable->getMessage() . "\n" );
+	exit( 1 );
+} finally {
+	emulsify_acf_json_smoke_remove( $work_root );
+}