Let API properties declare their return values should be captured.

Auto complete will know when to add a variable asingment.

app/schemas/models/level_component.coffee

@@ -97,6 +97,15 @@ PropertyDocumentationSchema = c.object {
     description: 'How important this property is to autocomplete.'
     minimum: 0
     default: 1.0
+  userShouldCaptureReturn:
+    type: 'object'
+    title: 'User Should Capture Return'
+    properties:
+      variableName:
+        type: 'string'
+        title: 'Variable Name'
+        description: 'Variable name this property is autocompleted into.'
+        default: 'result'
 
 DependencySchema = c.object {
   title: 'Component Dependency'

app/views/play/level/tome/SpellView.coffee

@@ -445,6 +445,14 @@ module.exports = class SpellView extends CocoView
           else
             snippetEntries.push entry
 
+          if doc.userShouldCaptureReturn
+            varName = doc.userShouldCaptureReturn.variableName ? 'result'
+            entry.captureReturn = switch e.language
+              when 'io' then varName + ' := '
+              when 'javascript' then 'var ' + varName + ' = '
+              when 'clojure' then '(let [' + varName + ' ' 
+              else varName + ' = '
+
     # TODO: Generalize this snippet replacement
     # TODO: Where should this logic live, and what format should it be in?
     if attackEntry?