remark: Add support for label to associations

* remark-parse: add label to definition, footnote definition, link reference, image reference,
  footnote reference
* remark-stringify: use full reference if no type is set

Related to syntax-tree/mdast#23.
Related to syntax-tree/mdast-util-to-hast#22.

Supersedes GH-346.

Closes GH-363.

Reviewed-by: Christian Murphy <[email protected]>

Co-authored-by: Sam Ruby <[email protected]>

Author: wooorm

packages/remark-parse/lib/tokenize/definition.js

@@ -255,6 +255,7 @@ function definition(eat, value, silent) {
     return eat(subvalue)({
       type: 'definition',
       identifier: normalize(identifier),
+      label: identifier,
       title: title || null,
       url: url
     });

packages/remark-parse/lib/tokenize/footnote-definition.js

@@ -93,7 +93,7 @@ function footnoteDefinition(eat, value, silent) {
     return true;
   }
 
-  identifier = normalize(queue);
+  identifier = queue;
   subvalue += queue + C_BRACKET_CLOSE + C_COLON;
   index = subvalue.length;
 
@@ -179,7 +179,8 @@ function footnoteDefinition(eat, value, silent) {
 
   return add({
     type: 'footnoteDefinition',
-    identifier: identifier,
+    identifier: normalize(identifier),
+    label: identifier,
     children: content
   });
 }

packages/remark-parse/lib/tokenize/reference.js

@@ -193,7 +193,8 @@ function reference(eat, value, silent) {
 
   node = {
     type: type + 'Reference',
-    identifier: normalize(identifier)
+    identifier: normalize(identifier),
+    label: identifier
   };
 
   if (type === T_LINK || type === T_IMAGE) {

packages/remark-stringify/lib/util/label.js

@@ -10,7 +10,10 @@ module.exports = label;
  * changes. */
 function label(node) {
   var type = node.referenceType;
-  var value = type === 'full' ? node.identifier : '';
 
-  return type === 'shortcut' ? value : '[' + value + ']';
+  if (type === 'shortcut') {
+    return '';
+  }
+
+  return type === 'collapsed' ? '[]' : '[' + (node.label || node.identifier) + ']';
 }

packages/remark-stringify/lib/visitors/definition.js

@@ -19,5 +19,5 @@ function definition(node) {
     content += ' ' + title(node.title);
   }
 
-  return '[' + node.identifier + ']: ' + content;
+  return '[' + (node.label || node.identifier) + ']: ' + content;
 }

packages/remark-stringify/lib/visitors/footnote-definition.js

@@ -5,8 +5,7 @@ var repeat = require('repeat-string');
 module.exports = footnoteDefinition;
 
 function footnoteDefinition(node) {
-  var id = node.identifier.toLowerCase();
   var content = this.all(node).join('\n\n' + repeat(' ', 4));
 
-  return '[^' + id + ']: ' + content;
+  return '[^' + (node.label || node.identifier) + ']: ' + content;
 }

packages/remark-stringify/lib/visitors/footnote-reference.js

@@ -3,5 +3,5 @@
 module.exports = footnoteReference;
 
 function footnoteReference(node) {
-  return '[^' + node.identifier + ']';
+  return '[^' + (node.label || node.identifier) + ']';
 }

packages/remark-stringify/lib/visitors/link-reference.js

@@ -14,7 +14,7 @@ function linkReference(node) {
   exit();
 
   if (type === 'shortcut' || type === 'collapsed') {
-    value = copy(value, node.identifier);
+    value = copy(value, node.label || node.identifier);
   }
 
   return '[' + value + ']' + label(node);

test/fixtures/input/footnote-proto.nooutput.text renamed to test/fixtures/input/footnote-proto.text

@@ -233,6 +233,7 @@
         {
           "type": "linkReference",
           "identifier": "1",
+          "label": "1",
           "referenceType": "full",
           "children": [
             {
@@ -322,6 +323,7 @@
         {
           "type": "linkReference",
           "identifier": "2",
+          "label": "2",
           "referenceType": "full",
           "children": [
             {
@@ -569,6 +571,7 @@
     {
       "type": "definition",
       "identifier": "1",
+      "label": "1",
       "title": null,
       "url": "http://example.com/?foo=1&bar=2",
       "position": {
@@ -588,6 +591,7 @@
     {
       "type": "definition",
       "identifier": "2",
+      "label": "2",
       "title": "AT&T",
       "url": "http://att.com/",
       "position": {