Make inline content "state-oriented", not "string-oriented"

Summary:
Ref T13513. Currently, all the inline code passes around strings to describe content. I plan to add background music, animation effects, etc., soon. To prepare for this change, make content a state object.

This does not change any user-visible behavior, it just prepares for content to become more complicated than a single string.

Test Plan: Created, edited, submitted, cancelled, etc., comments.

Maniphest Tasks: T13513

Differential Revision: https://secure.phabricator.com/D21273

Author: epriestley

resources/celerity/map.php

@@ -13,7 +13,7 @@
     'core.pkg.js' => '845355f4',
     'dark-console.pkg.js' => '187792c2',
     'differential.pkg.css' => '42a2334f',
-    'differential.pkg.js' => '8f59bce2',
+    'differential.pkg.js' => 'ff8ca085',
     'diffusion.pkg.css' => '42c75c37',
     'diffusion.pkg.js' => 'a98c0bf7',
     'maniphest.pkg.css' => '35995d6d',
@@ -379,9 +379,9 @@
     'rsrc/js/application/dashboard/behavior-dashboard-move-panels.js' => 'a2ab19be',
     'rsrc/js/application/dashboard/behavior-dashboard-query-panel-select.js' => '1e413dc9',
     'rsrc/js/application/dashboard/behavior-dashboard-tab-panel.js' => '0116d3e8',
-    'rsrc/js/application/diff/DiffChangeset.js' => '0c083409',
-    'rsrc/js/application/diff/DiffChangesetList.js' => 'db615898',
-    'rsrc/js/application/diff/DiffInline.js' => 'b00168c1',
+    'rsrc/js/application/diff/DiffChangeset.js' => '6e5e03d2',
+    'rsrc/js/application/diff/DiffChangesetList.js' => 'b51ba93a',
+    'rsrc/js/application/diff/DiffInline.js' => '28e53a2c',
     'rsrc/js/application/diff/DiffPathView.js' => '8207abf9',
     'rsrc/js/application/diff/DiffTreeView.js' => '5d83623b',
     'rsrc/js/application/differential/behavior-diff-radios.js' => '925fe8cd',
@@ -774,9 +774,9 @@
     'phabricator-darklog' => '3b869402',
     'phabricator-darkmessage' => '26cd4b73',
     'phabricator-dashboard-css' => '5a205b9d',
-    'phabricator-diff-changeset' => '0c083409',
-    'phabricator-diff-changeset-list' => 'db615898',
-    'phabricator-diff-inline' => 'b00168c1',
+    'phabricator-diff-changeset' => '6e5e03d2',
+    'phabricator-diff-changeset-list' => 'b51ba93a',
+    'phabricator-diff-inline' => '28e53a2c',
     'phabricator-diff-path-view' => '8207abf9',
     'phabricator-diff-tree-view' => '5d83623b',
     'phabricator-drag-and-drop-file-upload' => '4370900d',
@@ -1000,19 +1000,6 @@
       'javelin-dom',
       'phabricator-draggable-list',
     ),
-    '0c083409' => array(
-      'javelin-dom',
-      'javelin-util',
-      'javelin-stratcom',
-      'javelin-install',
-      'javelin-workflow',
-      'javelin-router',
-      'javelin-behavior-device',
-      'javelin-vector',
-      'phabricator-diff-inline',
-      'phabricator-diff-path-view',
-      'phuix-button-view',
-    ),
     '0cf79f45' => array(
       'javelin-behavior',
       'javelin-stratcom',
@@ -1150,6 +1137,9 @@
       'javelin-install',
       'javelin-util',
     ),
+    '28e53a2c' => array(
+      'javelin-dom',
+    ),
     '29819b75' => array(
       'phabricator-notification',
       'javelin-stratcom',
@@ -1561,6 +1551,19 @@
       'javelin-install',
       'javelin-util',
     ),
+    '6e5e03d2' => array(
+      'javelin-dom',
+      'javelin-util',
+      'javelin-stratcom',
+      'javelin-install',
+      'javelin-workflow',
+      'javelin-router',
+      'javelin-behavior-device',
+      'javelin-vector',
+      'phabricator-diff-inline',
+      'phabricator-diff-path-view',
+      'phuix-button-view',
+    ),
     70245195 => array(
       'javelin-behavior',
       'javelin-stratcom',
@@ -1935,9 +1938,6 @@
       'javelin-behavior-device',
       'javelin-vector',
     ),
-    'b00168c1' => array(
-      'javelin-dom',
-    ),
     'b105a3a6' => array(
       'javelin-behavior',
       'javelin-stratcom',
@@ -1970,6 +1970,11 @@
     'b517bfa0' => array(
       'phui-oi-list-view-css',
     ),
+    'b51ba93a' => array(
+      'javelin-install',
+      'phuix-button-view',
+      'phabricator-diff-tree-view',
+    ),
     'b557770a' => array(
       'javelin-install',
       'javelin-util',
@@ -2119,11 +2124,6 @@
       'javelin-uri',
       'phabricator-notification',
     ),
-    'db615898' => array(
-      'javelin-install',
-      'phuix-button-view',
-      'phabricator-diff-tree-view',
-    ),
     'e150bd50' => array(
       'javelin-behavior',
       'javelin-stratcom',

src/infrastructure/diff/PhabricatorInlineCommentController.php

@@ -39,7 +39,6 @@ protected function showComments(array $ids) {
   private $isOnRight;
   private $lineNumber;
   private $lineLength;
-  private $commentText;
   private $operation;
   private $commentID;
   private $renderer;
@@ -99,16 +98,16 @@ public function processRequest() {
     $request = $this->getRequest();
     $viewer = $this->getViewer();
 
+    if (!$request->validateCSRF()) {
+      return new Aphront404Response();
+    }
+
     $this->readRequestParameters();
 
     $op = $this->getOperation();
     switch ($op) {
       case 'hide':
       case 'show':
-        if (!$request->validateCSRF()) {
-          return new Aphront404Response();
-        }
-
         $ids = $request->getStrList('ids');
         if ($ids) {
           if ($op == 'hide') {
@@ -120,9 +119,6 @@ public function processRequest() {
 
         return id(new AphrontAjaxResponse())->setContent(array());
       case 'done':
-        if (!$request->validateCSRF()) {
-          return new Aphront404Response();
-        }
         $inline = $this->loadCommentForDone($this->getCommentID());
 
         $is_draft_state = false;
@@ -158,10 +154,6 @@ public function processRequest() {
       case 'delete':
       case 'undelete':
       case 'refdelete':
-        if (!$request->validateCSRF()) {
-          return new Aphront404Response();
-        }
-
         // NOTE: For normal deletes, we just process the delete immediately
         // and show an "Undo" action. For deletes by reference from the
         // preview ("refdelete"), we prompt first (because the "Undo" may
@@ -193,15 +185,14 @@ public function processRequest() {
 
         return $this->buildEmptyResponse();
       case 'edit':
+      case 'save':
         $inline = $this->loadCommentByIDForEdit($this->getCommentID());
-        $text = $this->getCommentText();
+        if ($op === 'save') {
+          $this->updateCommentContentState($inline);
 
-        if ($request->isFormPost()) {
-          if (strlen($text)) {
-            $inline
-              ->setContent($text)
-              ->setIsEditing(false);
+          $inline->setIsEditing(false);
 
+          if (!$inline->isVoidComment($viewer)) {
             $this->saveComment($inline);
 
             return $this->buildRenderedCommentResponse(
@@ -216,7 +207,7 @@ public function processRequest() {
           }
         } else {
           // NOTE: At time of writing, the "editing" state of inlines is
-          // preserved by simluating a click on "Edit" when the inline loads.
+          // preserved by simulating a click on "Edit" when the inline loads.
 
           // In this case, we don't want to "saveComment()", because it
           // recalculates object drafts and purges versioned drafts.
@@ -234,8 +225,8 @@ public function processRequest() {
             $is_dirty = true;
           }
 
-          if (strlen($text)) {
-            $inline->setContent($text);
+          if ($this->hasContentState()) {
+            $this->updateCommentContentState($inline);
             $is_dirty = true;
           } else {
             PhabricatorInlineComment::loadAndAttachVersionedDrafts(
@@ -262,13 +253,9 @@ public function processRequest() {
         // If the user uses "Undo" to get into an edited state ("AB"), then
         // clicks cancel to return to the previous state ("A"), we also want
         // to set the stored state back to "A".
-        $text = $this->getCommentText();
-        if (strlen($text)) {
-          $inline->setContent($text);
-        }
+        $this->updateCommentContentState($inline);
 
-        $content = $inline->getContent();
-        if (!strlen($content)) {
+        if ($inline->isVoidComment($viewer)) {
           $inline->setIsDeleted(1);
         }
 
@@ -283,11 +270,11 @@ public function processRequest() {
           $viewer->getPHID(),
           $inline->getID());
 
-        $text = $this->getCommentText();
-
-        $versioned_draft
-          ->setProperty('inline.text', $text)
-          ->save();
+        $map = $this->getContentState();
+        foreach ($map as $key => $value) {
+          $versioned_draft->setProperty($key, $value);
+        }
+        $versioned_draft->save();
 
         // We have to synchronize the draft engine after saving a versioned
         // draft, because taking an inline comment from "no text, no draft"
@@ -318,11 +305,11 @@ public function processRequest() {
           ->setIsNewFile($is_new)
           ->setLineNumber($number)
           ->setLineLength($length)
-          ->setContent((string)$this->getCommentText())
           ->setReplyToCommentPHID($this->getReplyToCommentPHID())
           ->setIsEditing(true)
           ->setStartOffset($request->getInt('startOffset'))
-          ->setEndOffset($request->getInt('endOffset'));
+          ->setEndOffset($request->getInt('endOffset'))
+          ->setContent('');
 
         $document_engine_key = $request->getStr('documentEngineKey');
         if ($document_engine_key !== null) {
@@ -338,6 +325,10 @@ public function processRequest() {
           }
         }
 
+        if ($this->hasContentState()) {
+          $this->updateCommentContentState($inline);
+        }
+
         $this->saveComment($inline);
 
         $edit_dialog = $this->buildEditDialog($inline);
@@ -365,7 +356,6 @@ private function readRequestParameters() {
     $this->isOnRight = $request->getBool('on_right');
     $this->lineNumber = $request->getInt('number');
     $this->lineLength = $request->getInt('length');
-    $this->commentText = $request->getStr('text');
     $this->commentID = $request->getInt('id');
     $this->operation = $request->getStr('op');
     $this->renderer = $request->getStr('renderer');
@@ -529,6 +519,36 @@ private function loadCommentByQuery(
     return $inline;
   }
 
+  private function hasContentState() {
+    $request = $this->getRequest();
+    return (bool)$request->getBool('hasContentState');
+  }
+
+  private function getContentState() {
+    $request = $this->getRequest();
+
+    $comment_text = $request->getStr('text');
+
+    return array(
+      'inline.text' => (string)$comment_text,
+    );
+  }
+
+  private function updateCommentContentState(PhabricatorInlineComment $inline) {
+    if (!$this->hasContentState()) {
+      throw new Exception(
+        pht(
+          'Attempting to update comment content state, but request has no '.
+          'content state.'));
+    }
+
+    $state = $this->getContentState();
+
+    $text = $state['inline.text'];
+
+    $inline->setContent($text);
+  }
+
   private function saveComment(PhabricatorInlineComment $inline) {
     $viewer = $this->getViewer();
     $draft_engine = $this->newDraftEngine();

src/infrastructure/diff/interface/PhabricatorInlineComment.php

@@ -322,6 +322,11 @@ public function getContentForEdit(PhabricatorUser $viewer) {
     return $draft_text;
   }
 
+  public function getContentState() {
+    return array(
+      'text' => $this->getContent(),
+    );
+  }
 
 /* -(  PhabricatorMarkupInterface Implementation  )-------------------------- */
 

src/infrastructure/diff/view/PHUIDiffInlineCommentEditView.php

@@ -22,39 +22,12 @@ public function render() {
         'sigil' => 'inline-edit-form',
       ),
       array(
-        $this->renderInputs(),
         $this->renderBody(),
       ));
 
     return $content;
   }
 
-  private function renderInputs() {
-    $inputs = array();
-    $inline = $this->getInlineComment();
-
-    $inputs[] = array('op', 'edit');
-    $inputs[] = array('id', $inline->getID());
-
-    $inputs[] = array('on_right', $this->getIsOnRight());
-    $inputs[] = array('renderer', $this->getRenderer());
-
-    $out = array();
-
-    foreach ($inputs as $input) {
-      list($name, $value) = $input;
-      $out[] = phutil_tag(
-        'input',
-        array(
-          'type'  => 'hidden',
-          'name'  => $name,
-          'value' => $value,
-        ));
-    }
-
-    return $out;
-  }
-
   private function renderBody() {
     $buttons = array();
 

src/infrastructure/diff/view/PHUIDiffInlineCommentView.php

@@ -82,7 +82,6 @@ protected function getInlineCommentMetadata() {
       'number' => $inline->getLineNumber(),
       'length' => $inline->getLineLength(),
       'isNewFile' => (bool)$inline->getIsNewFile(),
-      'original' => $inline->getContent(),
       'replyToCommentPHID' => $inline->getReplyToCommentPHID(),
       'isDraft' => $inline->isDraft(),
       'isFixed' => $is_fixed,
@@ -93,8 +92,8 @@ protected function getInlineCommentMetadata() {
       'documentEngineKey' => $inline->getDocumentEngineKey(),
       'startOffset' => $inline->getStartOffset(),
       'endOffset' => $inline->getEndOffset(),
-
       'on_right' => $this->getIsOnRight(),
+      'contentState' => $inline->getContentState(),
     );
   }
 

webroot/rsrc/js/application/diff/DiffChangeset.js

@@ -761,14 +761,14 @@ JX.install('DiffChangeset', {
       return inline;
     },
 
-    newInlineReply: function(original, text) {
+    newInlineReply: function(original, state) {
       var inline = new JX.DiffInline()
         .setChangeset(this)
         .bindToReply(original);
 
       this._inlines.push(inline);
 
-      inline.create(text);
+      inline.create(state);
 
       return inline;
     },