{ "file": "lib/parse-markdown.js", "content": "
'use strict';\nconst Prism = require('prismjs');\n// Prism will attach required modules through some globals majic spells\nrequire('prismjs/components/prism-handlebars');\nrequire('prismjs/components/prism-markdown');\nrequire('prismjs/components/prism-bash');\nrequire('prismjs/components/prism-diff');\nrequire('prismjs/components/prism-json');\nrequire('prismjs/components/prism-scss');\n\nvar stripDataTags = require('./strip-data-tag');\n\n/**\n * Handle parsing markdown using [Prism](http://prismjs.com/)\n * @class parseMarkdown\n * @constructor\n * @param {string} description Markdown string to parse\n * @return {string} HTML string parsed from passed markdown\n */\n\nconst md = require('markdown-it')({\n  html: true, // Allow html tags\n  linkify: true,\n  typographer: true,\n  highlight(str, lang) {\n    // We support flagging code blocks with `glimmer` or `htmlbars`, but Prism\n    // only recognizes 'handlebars'\n    if (lang === 'glimmer' || lang === 'htmlbars' ) { lang = 'handlebars'; }\n    let stripped = stripDataTags(str);\n    if (lang && Prism.languages[lang]) {\n      try {\n        return `<pre class=\\\"language-${lang}\\\"><code class=\\\"language-${lang}\\\">` +\n          Prism.highlight(stripped, Prism.languages.javascript) +\n          '</code></pre>';\n      } catch(ex) {\n        console.warn('Failed parsing language: ', ex);\n        return '';\n      }\n    }\n\n    return ''; // use external default escaping\n  }\n});\n\n// Custom Render Methods\n// ---------------------------------------------------------------------------\n/**\n * NEW render rule `heading_open` is called for any header element's opening token.\n * For all header opening tags, return an opening glimmer block for a\n * {{c-l class='FountainheadHeader'}} component.\n *\n * Header elements follow the token pattern:<br/>\n * `heading_open => inline => heading_close`\n *\n * Using this pattern, we also get the content from the next token to create the\n * anchor id hash fragment for the link header.\n * @method heading_open\n * @param {Array} tokens\n * @param {number} index\n * @return {string} Opening glimmer block string for a\n *                  {{c-l class='FountainheadHeader'}} with tag type and href id.\n */\nmd.renderer.rules.heading_open = (tokens, index) => {\n  let header = tokens[index];\n  let text = tokens[index + 1];\n  let href = '';\n\n  if (text && text.content) {\n    href = text.content.toLowerCase().replace(/\\s/g, '-');\n  }\n\n  return `{{#fountainhead-header tagName=\"${header.tag}\" elementId=\"${href}\"}}`;\n};\n/**\n * NEW render rule `heading_close` called for any header closing token. Replace HTML\n * closing tag with a closing {{c-l class='FountainheadHeader'}} glimmer block to\n * close opening glimmer block.\n * @method heading_close\n * @return {string}\n */\nmd.renderer.rules.heading_close = () => '{{/fountainhead-header}}\\n';\n\n/**\n * Scans the description text for instances of markdown code blocks flagged\n * as `\"glimmer\"` syntax. If any such instances are found, they are copied,\n * stripped of their triple backticks and re-inserted into the\n * `templateString` immediately after the original declaration. This allows\n * for functional copies of your code examples to be automatically rendered\n * into the description, without having to duplicate the code block itself.\n *\n * If your functional code needs to have different setup to work correctly in\n * the Fountainhead context (for example, if you need to use `core-state` to\n * set up sandboxed state and controls), simply use `\"handlebars\"` or no\n * syntax flag, and manually add the code block you want Fountainhead to\n * render after your example. Neato!\n *\n * @method _renderCodeBlocks\n * @param {String} description The description text to scan for code blocks\n * @return {String}\n */\nconst renderCodeBlocks = function(description) {\n  // Look for triple backtick code blocks flagged as `glimmer`;\n  // define end of block as triple backticks followed by a newline\n  let matches = description.match(/(```glimmer)(.|\\n)*?```/gi);\n\n  if (matches && matches.length) {\n    matches.map(codeBlock => {\n      let blockEnd = codeBlock.length + description.indexOf(codeBlock);\n      let plainCode = codeBlock.replace(/(```glimmer|```)/gi, '');\n      description = `${description.slice(0, (blockEnd))}${plainCode}${ description.slice(blockEnd)}`;\n    });\n  }\n\n  return description;\n};\n\n// Export parse function\nmodule.exports = function parseMarkdown(description) {\n\n  // Check for glimmer code blocks and make them REAL BOYS AND GIRLS\n  description = renderCodeBlocks(description);\n\n  // Parse description markdown\n  description = md.render(description);\n\n  // Check for codeblocks, we need to escape double curlies b/c these are code examples\n  let codeBlocks = description.match(/<code([\\s\\S]*?)<\\/code/g);\n\n  if (codeBlocks) {\n    // If there are code blocks in this description, sanitize them for templates\n    codeBlocks.forEach(function(codeBlock) {\n      if (codeBlock.indexOf('{{') === -1 ) { return; } // If there's not a double curly do less\n\n      var sanitizedBlock = codeBlock.replace(/{{/g, '\\\\{{'); // Prep sanitized block version\n      // Replace block in description w/ sanitized version\n      description = description.replace(codeBlock, sanitizedBlock);\n    });\n  }\n\n  // Markdown-it replaces single and double quotes with fancy characters which\n  // break the runtime template compiler. Handle sanitizing them here.\n  description = description.replace(/[“”]/g, '\\\"'); // Double quotes\n  description = description.replace(/&quot;|‘|’/g, '\\''); // Single quotes\n\n  return description;\n};\n
" }