Add examples

spec/abstract-semantic-graph/examples/attr.adoc

+[key=value]
+== Section
+
+:key: value
+
+[key=value]
+This is {key}.

spec/abstract-semantic-graph/examples/attr.asg.json

+{
+  "sections": [
+    {
+      "type": "Section",
+      "level": "1",
+      "title": "Section Title",
+      "attributes": {
+        "key": "value"
+      },
+      "children": [
+        {
+          "type": "Paragraph",
+          "attributes": {
+            "key": "value"
+          },
+          "children": [
+            {
+              "type": "Str",
+              "value": "This is value."
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}

spec/abstract-semantic-graph/examples/doc.adoc

+= Document Title
+Guillaume Grossetie
+:key: value
+
+This is {key}.

spec/abstract-semantic-graph/examples/doc.asg.json

+{
+  "header": {
+    "title": "Document Title",
+    "authors": [
+      {
+        "name": "Guillaume Grossetie"
+      }
+    ],
+    "attributes": {
+      "key": "value"
+    }
+  },
+  "sections": [
+    {
+      "type": "Paragraph",
+      "children": [
+        {
+          "type": "Str",
+          "value": "This is value."
+        }
+      ]
+    }
+  ]
+}

spec/abstract-semantic-graph/examples/paragraphs.adoc

+blk1
+
+blk2

spec/abstract-semantic-graph/examples/paragraphs.asg.json

+{
+  "sections": [
+    {
+      "type": "Paragraph",
+      "children": [
+        {
+          "type": "Str",
+          "value": "blk1"
+        }
+      ]
+    },
+    {
+      "type": "Paragraph",
+      "children": [
+        {
+          "type": "Str",
+          "value": "blk1"
+        }
+      ]
+    }
+  ]
+}

spec/abstract-semantic-graph/index.d.ts

@@ -2,19 +2,25 @@ export namespace AsciiDoc {
     interface Attributes {
         [key: string]: string
     }
+    interface AttributeEntries {
+        [key: string]: string
+    }
 }
 
 export namespace AsciiDocAbstractSemanticGraph {
 
     interface Document {
         header?: Header;
-        body: Body;
+        preamble?: Node;
+        sections: Node[]; // QUESTION: should we use "body" instead of "sections" (the reasoning is that some Documents don't have Section block).
     }
 
-    interface Header extends Node {
+    interface Header {
         title: string;
         authors?: Author[];
         revision: Revision;
+        // QUESTION: should we use a different name to disambiguate block attributes and document attributes (i.e., entries)?
+        attributes?: AsciiDoc.AttributeEntries;
     }
 
     interface Author {
@@ -30,38 +36,25 @@ export namespace AsciiDocAbstractSemanticGraph {
         date: string;
     }
 
-    type Body = Node[];
-
     interface Node {
         type: NodeType;
+        // QUESTION: should we always include raw, range and loc?
+        raw: string;
+        range: NodeRange;
+        loc: NodeLineLocation;
         attributes?: AsciiDoc.Attributes;
         children?: Node[]
     }
 
     type NodeType = 'Preamble' | 'Paragraph' | 'Section'
         | 'Verse' | 'STEM' | 'Sidebar' | 'Quote' | 'Open' | 'Example' | 'Listing' | 'Literal' | 'Admonition' | 'Image' | 'Video' | 'Audio' | 'Pass'
-        // Attributes are already resolved in an Abstract Semantic Graph
+        // QUESTION: attributes are already resolved in an Abstract Semantic Graph?
         //| 'AttributeReference' | 'AttributeDefinition'
         | 'Strong' | 'Emphasis' | 'Monospace' | 'Subscript' | 'Superscript' | 'SingleQuotation' | 'DoubleQuotation' | 'Str'
         | 'Anchor'
         | 'OrderedList' | 'UnorderedList' | 'DescriptionList'
         | 'InlineImage' | 'InlineBreak' | 'InlineButton' | 'InlineMenu' | 'InlineMacro'
         | 'Table';
-}
-
-/**
- * Syntax tree.
- */
-export namespace AsciiDocSyntaxTree {
-
-    interface Node {
-        type: string;
-        raw: string;
-        range: NodeRange;
-        loc: NodeLineLocation;
-        attributes?: AsciiDoc.Attributes;
-        children?: Node[]
-    }
 
     // 0-based index
     type NodeRange = [number, number];