fix lint

Author: jpatovh

docs/features/pattern-lab.md

@@ -22,6 +22,12 @@ From your Drupal Twig templates in `templates/` you can `{% include %}`, `{% ext
 
 For a demonstration in a sample codebase of how exactly to integrate templates, see the [`drupal-lab`](https://github.com/phase2/drupal-lab) repo; in particular note how both a [node teaser template](https://github.com/phase2/drupal-lab/blob/master/web/themes/dashing/templates/content/node--article--teaser.html.twig) and a [views field template](https://github.com/phase2/drupal-lab/blob/master/web/themes/dashing/templates/views/views-view-fields--newspage--page.html.twig) in the Drupal `templates/` folder can embed the [card template](https://github.com/phase2/drupal-lab/blob/master/web/themes/dashing/pattern-lab/source/_patterns/02-molecules/cards/card.twig) from Pattern Lab while formatting the data.
 
+### A word on twig template inheritance
+
+- `include`: Dump the contents of that template into this one.
+- `extends`: Take the old template and allow me to override blocks defined in the other template - I don't get to redefine everything and I don't get to define new blocks - I just get to suppress the old block definition and redefine it (and then I can dump the parent template's block definition into my definition if I use` {{ parent() }}` – kinda like doing an include just of that one block from the parent template's definition into your child template definition
+- `embed`: Include but then override blocks from that include (super useful for layouts).
+
 
 ## Additional features
 

lib/pattern-lab--php-twig.js

@@ -1,4 +1,5 @@
 'use strict';
+
 const core = require('./core');
 const path = require('path');
 const yaml = require('js-yaml');
@@ -9,9 +10,7 @@ const browserSync = require('browser-sync');
 const glob = require('glob');
 
 module.exports = (gulp, config, tasks) => {
-  let plConfig = yaml.safeLoad(
-    fs.readFileSync(config.patternLab.configFile, 'utf8')
-  );
+  let plConfig = yaml.safeLoad(fs.readFileSync(config.patternLab.configFile, 'utf8'));
   const plRoot = path.join(config.patternLab.configFile, '../..');
   const plSource = path.join(plRoot, plConfig.sourceDir);
   const plPublic = path.join(plRoot, plConfig.publicDir);
@@ -62,7 +61,7 @@ module.exports = (gulp, config, tasks) => {
         relative: false,
         addRootSlash: false,
         addSuffix: '?cacheBuster={{ cacheBuster }}',
-        addPrefix: path.join('../..', path.relative(plPublic, process.cwd())),
+        addPrefix: path.join('../..', path.relative(plPublic, process.cwd()))
       }))
       .pipe(gulp.dest(plMeta))
       .on('end', done);
@@ -83,7 +82,7 @@ module.exports = (gulp, config, tasks) => {
         return {
           name: x[0].trim(), // i.e. $color-gray
           value: y[0].replace(/!.*/, '').trim(), // i.e. hsl(0, 0%, 50%) after removing `!default`
-          comment: y[1].replace('//', '').trim(), // any inline comment coming after, i.e. `// main gray color`
+          comment: y[1].replace('//', '').trim() // any inline comment coming after, i.e. `// main gray color`
         };
       });
 
@@ -94,8 +93,8 @@ module.exports = (gulp, config, tasks) => {
       fs.writeFileSync(pair.dest, JSON.stringify({
         items: varsAndValues,
         meta: {
-          description: `To add to these items, use Sass variables that start with <code>${pair.lineStartsWith}</code> in <code>${pair.src}</code>`,
-        },
+          description: `To add to these items, use Sass variables that start with <code>${pair.lineStartsWith}</code> in <code>${pair.src}</code>`
+        }
       }, null, '  '));
     });
     done();
@@ -124,17 +123,15 @@ module.exports = (gulp, config, tasks) => {
         return results;
       });
       twigNamespaceConfig[namespaceSet.namespace] = {
-        paths: core.uniqueArray(core.flattenArray(pathArray)),
+        paths: core.uniqueArray(core.flattenArray(pathArray))
       };
     });
     return twigNamespaceConfig;
   }
 
   function addTwigNamespaceConfigToDrupal(done) {
     const twigNamespaceConfig = getTwigNamespaceConfig(path.dirname(config.drupal.themeFile));
-    const drupalThemeFile = yaml.safeLoad(
-      fs.readFileSync(config.drupal.themeFile, 'utf8')
-    );
+    const drupalThemeFile = yaml.safeLoad(fs.readFileSync(config.drupal.themeFile, 'utf8'));
 
     if (!drupalThemeFile['component-libraries']) {
       drupalThemeFile['component-libraries'] = {};
@@ -148,18 +145,16 @@ module.exports = (gulp, config, tasks) => {
 
   function addTwigNamespaceConfigToPl(done) {
     const twigNamespaceConfig = getTwigNamespaceConfig(plRoot);
-    plConfig = yaml.safeLoad(
-      fs.readFileSync(config.patternLab.configFile, 'utf8')
-    );
+    plConfig = yaml.safeLoad(fs.readFileSync(config.patternLab.configFile, 'utf8'));
     if (!plConfig.plugins) {
       Object.assign(plConfig, {
         plugins: {
-          twigNamespaces: { enabled: true, namespaces: {} },
-        },
+          twigNamespaces: { enabled: true, namespaces: {} }
+        }
       });
     } else if (!plConfig.plugins.twigNamespaces) {
       Object.assign(plConfig.plugins, {
-        twigNamespaces: { enabled: true, namespaces: {} },
+        twigNamespaces: { enabled: true, namespaces: {} }
       });
     } else if (!plConfig.plugins.twigNamespaces.namespaces) {
       plConfig.plugins.twigNamespaces.namespaces = {};