Surface lock icon explanations in the DevTools Security panel.

Source/devtools/front_end/security/SecurityModel.js

 // Copyright 2015 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 /**
  * @constructor
  * @extends {WebInspector.SDKModel}
  * @param {!WebInspector.Target} target
  */
 WebInspector.SecurityModel = function(target)
 {
     WebInspector.SDKModel.call(this, WebInspector.SecurityModel, target);
     this._dispatcher = new WebInspector.SecurityDispatcher(this);
     this._securityAgent = target.securityAgent();
     target.registerSecurityDispatcher(this._dispatcher);
     this._securityAgent.enable();
 
-    this._securityState = "unknown";
+    this._securityState = /** @type {!SecurityAgent.SecurityState} */ ("unknown");
 }
 
 WebInspector.SecurityModel.EventTypes = {
     SecurityStateChanged: "SecurityStateChanged"
 }
 
+/** @typedef {!{

[dgozman, 2015/06/18 10:50:48]

Just put this in a single line.

[lgarron, 2015/06/18 18:16:18]

Done.

+        securityState: SecurityAgent.SecurityState,
+        summary: string,
+        description: string
+    }}
+ */
+WebInspector.SecurityModel.SecurityStateExplanation;
+
 WebInspector.SecurityModel.prototype = {
     /**
      * @return {!SecurityAgent.SecurityState} securityState
      */
     securityState: function()
     {
         return /** @type {!SecurityAgent.SecurityState} */ (this._securityState);
     },
 
     __proto__: WebInspector.SDKModel.prototype
@@ skipping 13 matching lines @@
 
 /**
  * @constructor
  * @implements {SecurityAgent.Dispatcher}
  */
 WebInspector.SecurityDispatcher = function(model)
 {
     this._model = model;
 }
 
+/** @typedef {!{

[dgozman, 2015/06/18 10:50:48]

We don't usually typdef events, since you will cast in handler anyway. Just pass
object as an event data.

[lgarron, 2015/06/18 18:16:17]

Done.

+        securityState: !SecurityAgent.SecurityState,
+        explanations: !Array<!WebInspector.SecurityModel.SecurityStateExplanation>
+    }}
+ */
+WebInspector.SecurityDispatcher.SecurityStateChangedEvent;
+
 WebInspector.SecurityDispatcher.prototype = {
     /**
      * @override
      * @param {!SecurityAgent.SecurityState} securityState
+     * @param {!Array<!WebInspector.SecurityModel.SecurityStateExplanation>=} explanations
      */
-    securityStateChanged: function(securityState)
+    securityStateChanged: function(securityState, explanations)
     {
-        this._model._securityState = securityState;
-        this._model.dispatchEventToListeners(WebInspector.SecurityModel.EventTypes.SecurityStateChanged, securityState);
+        var event = /** @type {!WebInspector.SecurityDispatcher.SecurityStateChangedEvent} */ ({
+            "securityState": securityState,
+            "explanations": explanations || []
+        });
+        this._model.dispatchEventToListeners(WebInspector.SecurityModel.EventTypes.SecurityStateChanged, event);

[dgozman, 2015/06/18 10:50:48]

event->data

[lgarron, 2015/06/18 18:16:18]

Good point. Done.

     }
 }