fix(scopes): Support inner scope (#665)

* fix(scopes): Support inner scope

The purpose and usage of inner is still unclear, unfortunately, so this is an interim fix at best.

Fixes #652

* Improve comment typedef while we're at it

Author: tmcw

declarations/comment.js

@@ -71,7 +71,9 @@ declare type CommentTag = {
 declare type CommentMembers = {
   static: Array<Comment>,
   instance: Array<Comment>,
-  events: Array<Comment>
+  events: Array<Comment>,
+  global: Array<Comment>,
+  inner: Array<Comment>
 };
 
 declare type CommentExample = {
@@ -84,6 +86,20 @@ declare type Remark = {
   children: Array<Object>
 };
 
+declare type Access = 'private' | 'public' | 'protected';
+declare type Scope = 'instance' | 'static' | 'inner' | 'global';
+declare type Kind = 'class' |
+  'constant' |
+  'event' |
+  'external' |
+  'file' |
+  'function' |
+  'member' |
+  'mixin' |
+  'module' |
+  'namespace' |
+  'typedef';
+
 declare type Comment = {
   errors: Array<CommentError>,
   tags: Array<CommentTag>,
@@ -106,10 +122,11 @@ declare type Comment = {
   members: CommentMembers,
 
   name?: string,
-  kind?: string,
+  kind?: Kind,
+
   memberof?: string,
-  scope?: string,
-  access?: string,
+  scope?: Scope,
+  access?: Access,
   alias?: string,
 
   copyright?: string,
@@ -126,6 +143,12 @@ declare type Comment = {
 
   path?: Array<{
     name: string,
-    scope: string
+    scope: Scope
   }>
 };
+
+declare type ReducedComment = {
+  name: string,
+  kind: ?Kind,
+  scope?: ?Scope
+}

default_theme/index._

@@ -56,6 +56,18 @@
                       <% }) %>
                     </ul>
                   <% } %>
+                  <% if (doc.members.inner && doc.members.inner.length) { %>
+                    <ul class='list-reset py1-ul pl1'>
+                      <li class='h5'><span>Inner members</span></li>
+                      <% doc.members.inner.forEach(function(member) { %>
+                      <li><a
+                        href='#<%=member.namespace%>'
+                        class='regular pre-open'>
+                        #<%- member.name %>
+                      </a></li>
+                      <% }) %>
+                    </ul>
+                  <% } %>
                   <% if (doc.members.events && doc.members.events.length) { %>
                     <ul class='list-reset py1-ul pl1'>
                       <li class='h5'>Events</li>