From cc1ecc5c86f97d93440b097ee6840a1ca62e021e Mon Sep 17 00:00:00 2001
From: Bec White <white@palantir.net>
Date: Wed, 22 Aug 2018 19:01:41 -0500
Subject: [PATCH 1/9] Add styleguide build command.

---
 tasks/styleguide.xml | 102 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 102 insertions(+)
 create mode 100644 tasks/styleguide.xml

diff --git a/tasks/styleguide.xml b/tasks/styleguide.xml
new file mode 100644
index 00000000..fc38ee79
--- /dev/null
+++ b/tasks/styleguide.xml
@@ -0,0 +1,102 @@
+<?xml version="1.0"?>
+
+<!--
+  @file styleguide.xml
+  Targets for managing the styleguide.
+
+  Copyright 2018 Palantir.net, Inc.
+  -->
+
+<project name="Styleguide" default="styleguide">
+    <!--
+      Include this file in your build.xml with:
+        <import file="vendor/palantirnet/the-build/tasks/styleguide.xml" />
+      -->
+
+
+    <fail unless="build.dir" />
+    <fail unless="build.env" />
+    <fail unless="projectname" />
+
+
+    <!-- These properties will generally be set in the default build properties file. -->
+    <property name="styleguide.root" value="styleguide" />
+    <property name="styleguide.command" value="yarn default" />
+
+    <!-- This is resolved at runtime. -->
+    <resolvepath propertyName="styleguide.root.resolved" file="${styleguide.root}" dir="${build.dir}" />
+
+
+    <!-- Target: styleguide-configure -->
+    <target name="styleguide-configure" description="Configure the styleguide build.">
+        <phing phingfile="${phing.dir.styleguide}/configure.xml" inheritAll="false" dir="${build.dir}">
+            <property name="build.env" value="${build.env}" />
+            <property name="build.dir" value="${build.dir}" />
+
+            <!-- Load properties from the environment we're editing, with the prefix "default.*" -->
+            <property file="${build.dir}/conf/build.${build.env}.properties" prefix="default" />
+            <property file="${build.dir}/conf/build.default.properties" prefix="default" />
+
+            <!-- Prompts and defaults -->
+            <property name="prompt.styleguide.root" value="Style guide directory, relative to the project root" />
+            <property name="default.styleguide.root" value="${styleguide.root}" />
+
+            <property name="prompt.styleguide.command" value="Style guide build command" />
+            <property name="default.styleguide.command" value="${styleguide.command}" />
+
+            <property name="update" value="styleguide.root,styleguide.command" />
+            <property name="dump" value="" />
+        </phing>
+    </target>
+
+
+    <!-- Target: styleguide -->
+    <target name="styleguide" description="Install and build the style guide.">
+
+        <phingcall target="styleguide-install" />
+
+        <!-- Run the styleguide build command. -->
+        <echo>Running build command in ${styleguide.root}: ${styleguide.command}</echo>
+        <exec dir="${styleguide.root.resolved}" command="${styleguide.command}" passthru="true" checkreturn="true" />
+    </target>
+
+
+    <!-- Target: styleguide-install -->
+    <target name="styleguide-install" description="Install the style guide.">
+
+        <!-- Run composer install in the styleguide. -->
+        <if>
+            <and>
+                <available file="${styleguide.root.resolved}/composer.lock" type="file" />
+                <not><available file="${styleguide.root.resolved}/vendor/autoload.php" type="file" /></not>
+            </and>
+            <then>
+                <exec dir="${styleguide.root.resolved}" command="composer install --no-interaction" passthru="true" checkreturn="true" />
+            </then>
+        </if>
+
+        <!-- Run yarn install in the styleguide. -->
+        <if>
+            <and>
+                <available file="${styleguide.root.resolved}/yarn.lock" type="file" />
+                <not><available file="${styleguide.root.resolved}/node_modules/.yarn-integrity" type="file" /></not>
+            </and>
+            <then>
+                <exec dir="${styleguide.root.resolved}" command="yarn install" passthru="true" checkreturn="true" />
+            </then>
+        </if>
+
+        <!-- Run npm install in the styleguide, if there's no yarn.lock file. -->
+        <if>
+            <and>
+                <available file="${styleguide.root.resolved}/package.json" type="file" />
+                <not><available file="${styleguide.root.resolved}/yarn.lock" type="file" /></not>
+            </and>
+            <then>
+                <exec dir="${styleguide.root.resolved}" command="npm install" passthru="true" checkreturn="true" />
+            </then>
+        </if>
+    </target>
+
+
+</project>

From 23af2c019d0ff4a10589aa20a59cdc99bdcef7cb Mon Sep 17 00:00:00 2001
From: Bec White <white@palantir.net>
Date: Wed, 22 Aug 2018 19:15:11 -0500
Subject: [PATCH 2/9] Add the styleguide target to the template build.xml file,
 and include the configuration task in the install process.

---
 build.dist.xml    | 1 +
 tasks/install.xml | 1 +
 2 files changed, 2 insertions(+)

diff --git a/build.dist.xml b/build.dist.xml
index 04ee5adf..975521e8 100644
--- a/build.dist.xml
+++ b/build.dist.xml
@@ -9,6 +9,7 @@
     <!-- Make these commands available by default. -->
     <import file="vendor/palantirnet/the-build/tasks/drupal.xml" />
     <import file="vendor/palantirnet/the-build/tasks/acquia.xml" />
+    <import file="vendor/palantirnet/the-build/tasks/styleguide.xml" />
 
 
     <!-- Default target: build -->
diff --git a/tasks/install.xml b/tasks/install.xml
index 9e179925..82fe5493 100644
--- a/tasks/install.xml
+++ b/tasks/install.xml
@@ -61,6 +61,7 @@
         <echo message="Configure the default environment..." />
         <phing target="configure" phingfile="${phing.dir.install}/boilerplate.xml" />
         <phing target="drupal-configure" phingfile="${phing.dir.install}/drupal.xml" />
+        <phing target="styleguide-configure" phingfile="${phing.dir.install}/styleguide.xml" />
         <phing target="drush-prepare-drushrc" phingfile="${phing.dir.install}/drupal.xml" />
 
         <echo message="To configure properties for more environments, run: vendor/bin/phing configure -Dbuild.env=your_environment" />

From 686a08a290cb6c1e1679e897cf3b809b41413fdb Mon Sep 17 00:00:00 2001
From: Bec White <white@palantir.net>
Date: Wed, 22 Aug 2018 19:24:34 -0500
Subject: [PATCH 3/9] Run the styleguide build as part of the default build
 tasks.

---
 build.dist.xml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/build.dist.xml b/build.dist.xml
index 975521e8..5e548143 100644
--- a/build.dist.xml
+++ b/build.dist.xml
@@ -15,6 +15,7 @@
     <!-- Default target: build -->
     <target name="build" description="Build the application.">
         <phingcall target="drupal-build" />
+        <phingcall target="styleguide" />
     </target>
 
 

From 47dfa07115b1a299b719ebb7f2843d579f73a388 Mon Sep 17 00:00:00 2001
From: Bec White <white@palantir.net>
Date: Wed, 22 Aug 2018 19:25:01 -0500
Subject: [PATCH 4/9] Run yarn install in non-interactive mode.

---
 tasks/styleguide.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tasks/styleguide.xml b/tasks/styleguide.xml
index fc38ee79..6b910d63 100644
--- a/tasks/styleguide.xml
+++ b/tasks/styleguide.xml
@@ -82,7 +82,7 @@
                 <not><available file="${styleguide.root.resolved}/node_modules/.yarn-integrity" type="file" /></not>
             </and>
             <then>
-                <exec dir="${styleguide.root.resolved}" command="yarn install" passthru="true" checkreturn="true" />
+                <exec dir="${styleguide.root.resolved}" command="yarn install --non-interactive --no-progress --prefer-offline" passthru="true" checkreturn="true" />
             </then>
         </if>
 

From eeb45d5431a4021b5afcab9d1c93337065adae9e Mon Sep 17 00:00:00 2001
From: Bec White <white@palantir.net>
Date: Wed, 22 Aug 2018 19:26:14 -0500
Subject: [PATCH 5/9] Add a todo for npm -- should we even support npm this
 way?

---
 tasks/styleguide.xml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/tasks/styleguide.xml b/tasks/styleguide.xml
index 6b910d63..38010f04 100644
--- a/tasks/styleguide.xml
+++ b/tasks/styleguide.xml
@@ -87,6 +87,7 @@
         </if>
 
         <!-- Run npm install in the styleguide, if there's no yarn.lock file. -->
+        <!-- @todo is there a decent way to check whether npm install has run? -->
         <if>
             <and>
                 <available file="${styleguide.root.resolved}/package.json" type="file" />

From 9c03f311fa3a3624d8f603b22ca53cd69758ff2a Mon Sep 17 00:00:00 2001
From: Bec White <white@palantir.net>
Date: Wed, 22 Aug 2018 19:31:27 -0500
Subject: [PATCH 6/9] Don't support npm only right now.

---
 tasks/styleguide.xml | 12 ------------
 1 file changed, 12 deletions(-)

diff --git a/tasks/styleguide.xml b/tasks/styleguide.xml
index 38010f04..e16bb568 100644
--- a/tasks/styleguide.xml
+++ b/tasks/styleguide.xml
@@ -85,18 +85,6 @@
                 <exec dir="${styleguide.root.resolved}" command="yarn install --non-interactive --no-progress --prefer-offline" passthru="true" checkreturn="true" />
             </then>
         </if>
-
-        <!-- Run npm install in the styleguide, if there's no yarn.lock file. -->
-        <!-- @todo is there a decent way to check whether npm install has run? -->
-        <if>
-            <and>
-                <available file="${styleguide.root.resolved}/package.json" type="file" />
-                <not><available file="${styleguide.root.resolved}/yarn.lock" type="file" /></not>
-            </and>
-            <then>
-                <exec dir="${styleguide.root.resolved}" command="npm install" passthru="true" checkreturn="true" />
-            </then>
-        </if>
     </target>
 
 

From 2aea62ba417903ac45b43f5bba3d1b4b62842e76 Mon Sep 17 00:00:00 2001
From: Bec White <white@palantir.net>
Date: Wed, 22 Aug 2018 19:39:04 -0500
Subject: [PATCH 7/9] Add documentation on style guide configuration
 properties.

---
 docs/properties.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/docs/properties.md b/docs/properties.md
index 095eb5b9..2d2ac56a 100644
--- a/docs/properties.md
+++ b/docs/properties.md
@@ -62,6 +62,15 @@ Cool! This phing-ism is what powers our environment-specific property layering a
 
 [More info](../tasks/drupal.xml#L16-L38)
 
+### Style Guide
+
+| Property | Default value | What is it? |
+|---|---|---|
+| `styleguide.root` | `styleguide` | Location of the style guide, relative to the project root. |
+| `styleguide.command` | `yarn default` | Command to compile the style guide assets, for use during the build and artifact steps. |
+
+[More info](../tasks/styleguide.xml#L22-L24)
+
 ### Code Review
 
 | Property | Default value | What is it? |

From 702c67d470a8ab19a89ab031ac443a434af8151c Mon Sep 17 00:00:00 2001
From: Bec White <white@palantir.net>
Date: Tue, 16 Oct 2018 16:29:31 -0500
Subject: [PATCH 8/9] Build the styleguide before running the drupal-build, and
 include an example <includeresource /> call.

---
 build.dist.xml | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/build.dist.xml b/build.dist.xml
index 5e548143..c32c0c42 100644
--- a/build.dist.xml
+++ b/build.dist.xml
@@ -14,8 +14,11 @@
 
     <!-- Default target: build -->
     <target name="build" description="Build the application.">
-        <phingcall target="drupal-build" />
         <phingcall target="styleguide" />
+        <phingcall target="drupal-build" />
+        <!-- Include styleguide resources in the theme. This approach will symlink
+             resources in development environments, and copy them for artifact builds. -->
+        <!-- <includeresource mode="${build.artifact_mode}" source="styleguide/source/assets/css" dest="${drupal.root}/themes/custom/example_theme/css" /> -->
     </target>
 
 

From b25d333e3a57b5ba1a6e0886d107588c5da9d358 Mon Sep 17 00:00:00 2001
From: byrond <duvall@palantir.net>
Date: Thu, 1 Nov 2018 16:18:36 -0400
Subject: [PATCH 9/9] run yarn install if node-sass binding for linux is
 missing

---
 tasks/styleguide.xml | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/tasks/styleguide.xml b/tasks/styleguide.xml
index e16bb568..ccd2e649 100644
--- a/tasks/styleguide.xml
+++ b/tasks/styleguide.xml
@@ -79,7 +79,10 @@
         <if>
             <and>
                 <available file="${styleguide.root.resolved}/yarn.lock" type="file" />
-                <not><available file="${styleguide.root.resolved}/node_modules/.yarn-integrity" type="file" /></not>
+                <or>
+                  <not><available file="${styleguide.root.resolved}/node_modules/.yarn-integrity" type="file" /></not>
+                  <not><available file="${styleguide.root.resolved}/node_modules/node-sass/vendor/linux-x64-59/binding.node" type="file" /></not>
+                </or>
             </and>
             <then>
                 <exec dir="${styleguide.root.resolved}" command="yarn install --non-interactive --no-progress --prefer-offline" passthru="true" checkreturn="true" />