initial support for #410

Author: bmuenzenmeyer

core/lib/pattern_assembler.js

@@ -117,8 +117,6 @@ var pattern_assembler = function () {
       }
 
       // do global registration
-
-
       if (pattern.isPattern) {
         patternlab.partials[pattern.patternPartial] = pattern.extendedTemplate || pattern.template;
 
@@ -202,6 +200,48 @@ var pattern_assembler = function () {
     }
   }
 
+  /**
+   * A helper that unravels a pattern looking for partials or listitems to unravel.
+   * The goal is really to convert pattern.template into pattern.extendedTemplate
+   * @param pattern - the pattern to decompose
+   * @param patternlab - global data store
+   * @param ignoreLineage - whether or not to hunt for lineage for this pattern
+     */
+  function decomposePattern(pattern, patternlab, ignoreLineage) {
+
+    var lineage_hunter = new lh(),
+      list_item_hunter = new lih();
+
+    pattern.extendedTemplate = pattern.template;
+
+    //find how many partials there may be for the given pattern
+    var foundPatternPartials = pattern.findPartials();
+
+    //find any listItem blocks that within the pattern, even if there are no partials
+    list_item_hunter.process_list_item_partials(pattern, patternlab);
+
+    // expand any partials present in this pattern; that is, drill down into
+    // the template and replace their calls in this template with rendered
+    // results
+
+    if (pattern.engine.expandPartials && (foundPatternPartials !== null && foundPatternPartials.length > 0)) {
+      // eslint-disable-next-line
+      expandPartials(foundPatternPartials, list_item_hunter, patternlab, pattern);
+
+      // update the extendedTemplate in the partials object in case this
+      // pattern is consumed later
+      patternlab.partials[pattern.patternPartial] = pattern.extendedTemplate;
+    }
+
+    //find pattern lineage
+    if (!ignoreLineage) {
+      lineage_hunter.find_lineage(pattern, patternlab);
+    }
+
+    //add to patternlab object so we can look these up later.
+    addPattern(pattern, patternlab);
+  }
+
   function processPatternIterative(relPath, patternlab) {
 
     //check if the found file is a top-level markdown file
@@ -323,9 +363,6 @@ var pattern_assembler = function () {
 
   function processPatternRecursive(file, patternlab) {
 
-    var lineage_hunter = new lh(),
-      list_item_hunter = new lih();
-
     //find current pattern in patternlab object using var file as a partial
     var currentPattern, i;
 
@@ -341,32 +378,8 @@ var pattern_assembler = function () {
     //we are processing a markdown only pattern
     if (currentPattern.engine === null) { return; }
 
-    currentPattern.extendedTemplate = currentPattern.template;
-
-    //find how many partials there may be for the given pattern
-    var foundPatternPartials = currentPattern.findPartials();
-
-    //find any listItem blocks that within the pattern, even if there are no partials
-    list_item_hunter.process_list_item_partials(currentPattern, patternlab);
-
-    // expand any partials present in this pattern; that is, drill down into
-    // the template and replace their calls in this template with rendered
-    // results
-
-    if (currentPattern.engine.expandPartials && (foundPatternPartials !== null && foundPatternPartials.length > 0)) {
-      // eslint-disable-next-line
-      expandPartials(foundPatternPartials, list_item_hunter, patternlab, currentPattern);
-
-      // update the extendedTemplate in the partials object in case this
-      // pattern is consumed later
-      patternlab.partials[currentPattern.patternPartial] = currentPattern.extendedTemplate;
-    }
-
-    //find pattern lineage
-    lineage_hunter.find_lineage(currentPattern, patternlab);
-
-    //add to patternlab object so we can look these up later.
-    addPattern(currentPattern, patternlab);
+    //call our helper method to actually unravel the pattern with any partials
+    decomposePattern(currentPattern, patternlab);
   }
 
   function expandPartials(foundPatternPartials, list_item_hunter, patternlab, currentPattern) {
@@ -501,6 +514,9 @@ var pattern_assembler = function () {
     addSubtypePattern: function (subtypePattern, patternlab) {
       addSubtypePattern(subtypePattern, patternlab);
     },
+    decomposePattern: function (pattern, patternlab, ignoreLineage) {
+      decomposePattern(pattern, patternlab, ignoreLineage);
+    },
     renderPattern: function (template, data, partials) {
       return renderPattern(template, data, partials);
     },

core/lib/pattern_engines.js

@@ -1,13 +1,4 @@
-/*
- * patternlab-node - v0.10.1 - 2015
- *
- * Geoffrey Pursell, Brian Muenzenmeyer, and the web community.
- * Licensed under the MIT license.
- *
- * Many thanks to Brad Frost and Dave Olsen for inspiration, encouragement, and advice.
- *
- */
-
+// special shoutout to Geoffrey Pursell for single-handedly making Pattern Lab Node Pattern Engines possible!
 'use strict';
 
 var path = require('path');

core/lib/patternlab.js

@@ -1,5 +1,5 @@
 /* 
- * patternlab-node - v2.4.4 - 2016 
+ * patternlab-node - v2.5.0 - 2016 
  * 
  * Brian Muenzenmeyer, Geoff Pursell, and the web community.
  * Licensed under the MIT license. 
@@ -17,7 +17,6 @@ var diveSync = require('diveSync'),
   plutils = require('./utilities');
 
 function buildPatternData(dataFilesPath, fs) {
-  var dataFilesPath = dataFilesPath;
   var dataFiles = glob.sync(dataFilesPath + '*.json', {"ignore" : [dataFilesPath + 'listitems.json']});
   var mergeObject = {};
   dataFiles.forEach(function (filePath) {
@@ -84,8 +83,13 @@ var patternlab_engine = function (config) {
     lh = require('./lineage_hunter'),
     ui = require('./ui_builder'),
     sm = require('./starterkit_manager'),
+    Pattern = require('./object_factory').Pattern,
     patternlab = {};
 
+  var pattern_assembler = new pa(),
+    pattern_exporter = new pe(),
+    lineage_hunter = new lh();
+
   patternlab.package = fs.readJSONSync(path.resolve(__dirname, '../../package.json'));
   patternlab.config = config || fs.readJSONSync(path.resolve(__dirname, '../../patternlab-config.json'));
 
@@ -191,6 +195,46 @@ var patternlab_engine = function (config) {
     starterkit_manager.load_starterkit(starterkitName, clean);
   }
 
+  /**
+   * Process the user-defined pattern head and prepare it for rendering
+   */
+  function processHeadPattern() {
+    try {
+      var headPath = path.resolve(paths.source.meta, '_00-head.mustache');
+      var headPattern = new Pattern(headPath, null, patternlab);
+      headPattern.template = fs.readFileSync(headPath, 'utf8');
+      headPattern.isPattern = false;
+      headPattern.isMetaPattern = true;
+      pattern_assembler.decomposePattern(headPattern, patternlab, true);
+      patternlab.userHead = headPattern.extendedTemplate;
+    }
+    catch (ex) {
+      plutils.logRed('\nWARNING: Could not find the user-editable header template, currently configured to be at ' + path.join(config.paths.source.meta, '_00-head.mustache') + '. Your configured path may be incorrect (check paths.source.meta in your config file), the file may have been deleted, or it may have been left in the wrong place during a migration or update.\n');
+      if (patternlab.config.debug) { console.log(ex); }
+      process.exit(1);
+    }
+  }
+
+  /**
+   * Process the user-defined pattern footer and prepare it for rendering
+   */
+  function processFootPattern() {
+    try {
+      var footPath = path.resolve(paths.source.meta, '_01-foot.mustache');
+      var footPattern = new Pattern(footPath, null, patternlab);
+      footPattern.template = fs.readFileSync(footPath, 'utf8');
+      footPattern.isPattern = false;
+      footPattern.isMetaPattern = true;
+      pattern_assembler.decomposePattern(footPattern, patternlab, true);
+      patternlab.userFoot = footPattern.extendedTemplate;
+    }
+    catch (ex) {
+      plutils.logRed('\nWARNING: Could not find the user-editable footer template, currently configured to be at ' + path.join(config.paths.source.meta, '_01-foot.mustache') + '. Your configured path may be incorrect (check paths.source.meta in your config file), the file may have been deleted, or it may have been left in the wrong place during a migration or update.\n');
+      if (patternlab.config.debug) { console.log(ex); }
+      process.exit(1);
+    }
+  }
+
   function buildPatterns(deletePatternDir) {
     try {
       patternlab.data = buildPatternData(paths.source.data, fs);
@@ -222,37 +266,18 @@ var patternlab_engine = function (config) {
 
     setCacheBust();
 
-    var pattern_assembler = new pa(),
-      pattern_exporter = new pe(),
-      lineage_hunter = new lh(),
-      patterns_dir = paths.source.patterns;
-
     pattern_assembler.combine_listItems(patternlab);
 
     // diveSync once to perform iterative populating of patternlab object
-    processAllPatternsIterative(pattern_assembler, patterns_dir, patternlab);
+    processAllPatternsIterative(pattern_assembler, paths.source.patterns, patternlab);
 
     //diveSync again to recursively include partials, filling out the
     //extendedTemplate property of the patternlab.patterns elements
-    processAllPatternsRecursive(pattern_assembler, patterns_dir, patternlab);
+    processAllPatternsRecursive(pattern_assembler, paths.source.patterns, patternlab);
 
-    //set user defined head and foot if they exist
-    try {
-      patternlab.userHead = fs.readFileSync(path.resolve(paths.source.meta, '_00-head.mustache'), 'utf8');
-    }
-    catch (ex) {
-      plutils.logRed('\nWARNING: Could not find the user-editable header template, currently configured to be at ' + path.join(config.paths.source.meta, '_00-head.mustache') + '. Your configured path may be incorrect (check paths.source.meta in your config file), the file may have been deleted, or it may have been left in the wrong place during a migration or update.\n');
-      if (patternlab.config.debug) { console.log(ex); }
-      process.exit(1);
-    }
-    try {
-      patternlab.userFoot = fs.readFileSync(path.resolve(paths.source.meta, '_01-foot.mustache'), 'utf8');
-    }
-    catch (ex) {
-      plutils.logRed('\nWARNING: Could not find the user-editable footer template, currently configured to be at ' + path.join(config.paths.source.meta, '_01-foot.mustache') + '. Your configured path may be incorrect (check paths.source.meta in your config file), the file may have been deleted, or it may have been left in the wrong place during a migration or update.\n');
-      if (patternlab.config.debug) { console.log(ex); }
-      process.exit(1);
-    }
+    //take the user defined head and foot and process any data and patterns that apply
+    processHeadPattern();
+    processFootPattern();
 
     //now that all the main patterns are known, look for any links that might be within data and expand them
     //we need to do this before expanding patterns & partials into extendedTemplates, otherwise we could lose the data -> partial reference
@@ -287,8 +312,6 @@ var patternlab_engine = function (config) {
         return false;
       }
 
-      pattern.header = head;
-
       //todo move this into lineage_hunter
       pattern.patternLineages = pattern.lineage;
       pattern.patternLineageExists = pattern.lineage.length > 0;
@@ -307,14 +330,13 @@ var patternlab_engine = function (config) {
       allData = plutils.mergeData(allData, pattern.jsonFileData);
       allData.cacheBuster = patternlab.cacheBuster;
 
+      //re-rendering the headHTML each time allows pattern-specific data to influence the head of the pattern
+      pattern.header = head;
       var headHTML = pattern_assembler.renderPattern(pattern.header, allData);
 
       //render the extendedTemplate with all data
       pattern.patternPartialCode = pattern_assembler.renderPattern(pattern, allData);
 
-      //todo see if this is still needed
-      //pattern.patternPartialCodeE = entity_encoder.encode(pattern.patternPartialCode);
-
       // stringify this data for individual pattern rendering and use on the styleguide
       // see if patternData really needs these other duped values
       pattern.patternData = JSON.stringify({
@@ -350,9 +372,17 @@ var patternlab_engine = function (config) {
         cacheBuster: patternlab.cacheBuster
       });
 
-      var footerHTML = pattern_assembler.renderPattern(patternlab.userFoot, {
-        patternLabFoot : footerPartial
-      });
+      var allFooterData;
+      try {
+        allFooterData = JSON5.parse(JSON5.stringify(patternlab.data));
+      } catch (err) {
+        console.log('There was an error parsing JSON for ' + pattern.relPath);
+        console.log(err);
+      }
+      allFooterData = plutils.mergeData(allFooterData, pattern.jsonFileData);
+      allFooterData.patternLabFoot = footerPartial;
+
+      var footerHTML = pattern_assembler.renderPattern(patternlab.userFoot, allFooterData);
 
       //write the compiled template to the public patterns directory
       var patternPage = headHTML + pattern.patternPartialCode + footerHTML;

core/lib/ui_builder.js

@@ -1,6 +1,7 @@
 "use strict";
 
 var path = require('path');
+var JSON5 = require('json5');
 var fs = require('fs-extra');
 var ae = require('./annotation_exporter');
 var of = require('./object_factory');
@@ -98,7 +99,16 @@ var ui_builder = function () {
     isOmitted = pattern.relPath.charAt(0) === '_' || pattern.relPath.indexOf('/_') > -1;
     if (isOmitted) {
       if (patternlab.config.debug) {
-        console.log('Omitting ' + pattern.patternPartial + ' from styleguide patterns its contained within an underscored directory.');
+        console.log('Omitting ' + pattern.patternPartial + ' from styleguide patterns because its contained within an underscored directory.');
+      }
+      return true;
+    }
+
+    //this pattern is a head or foot pattern
+    isOmitted = pattern.isMetaPattern;
+    if (isOmitted) {
+      if (patternlab.config.debug) {
+        console.log('Omitting ' + pattern.patternPartial + ' from styleguide patterns because its a meta pattern.');
       }
       return true;
     }
@@ -396,10 +406,17 @@ var ui_builder = function () {
       cacheBuster: patternlab.cacheBuster
     });
 
+    var allFooterData;
+    try {
+      allFooterData = JSON5.parse(JSON5.stringify(patternlab.data));
+    } catch (err) {
+      console.log('There was an error parsing JSON for patternlab.data');
+      console.log(err);
+    }
+    allFooterData.patternLabFoot = footerPartial;
+
     //then add it to the user footer
-    var footerHTML = pattern_assembler.renderPattern(patternlab.userFoot, {
-      patternLabFoot : footerPartial
-    });
+    var footerHTML = pattern_assembler.renderPattern(patternlab.userFoot, allFooterData);
     return footerHTML;
   }
 
@@ -505,7 +522,6 @@ var ui_builder = function () {
     return patterns;
   }
 
-
   /**
    * Write out our pattern information for use by the front end
    * @param patternlab - global data store
@@ -574,19 +590,19 @@ var ui_builder = function () {
     var headerPartial = pattern_assembler.renderPattern(patternlab.header, {
       cacheBuster: patternlab.cacheBuster
     });
-    var headerHTML = pattern_assembler.renderPattern(patternlab.userHead, {
-      patternLabHead : headerPartial,
-      cacheBuster: patternlab.cacheBuster
-    });
+
+    var headFootData = patternlab.data;
+    headFootData.patternLabHead = headerPartial;
+    headFootData.cacheBuster = patternlab.cacheBuster;
+    var headerHTML = pattern_assembler.renderPattern(patternlab.userHead, headFootData);
 
     //set the pattern-specific footer by compiling the general-footer with data, and then adding it to the meta footer
     var footerPartial = pattern_assembler.renderPattern(patternlab.footer, {
       patternData: '{}',
       cacheBuster: patternlab.cacheBuster
     });
-    var footerHTML = pattern_assembler.renderPattern(patternlab.userFoot, {
-      patternLabFoot : footerPartial
-    });
+    headFootData.patternLabFoot = footerPartial;
+    var footerHTML = pattern_assembler.renderPattern(patternlab.userFoot, headFootData);
 
     //build the viewall pages
     var allPatterns = buildViewAllPages(headerHTML, patternlab, styleguidePatterns);

package.json

@@ -1,7 +1,7 @@
 {
   "name": "patternlab-node",
   "description": "Pattern Lab is a collection of tools to help you create atomic design systems. This is the node command line interface (CLI).",
-  "version": "2.4.4",
+  "version": "2.5.0",
   "main": "./core/lib/patternlab.js",
   "dependencies": {
     "diveSync": "^0.3.0",