Add onFontNameChanged event to Font Settings API

chrome/common/extensions/api/experimental.fontSettings.json

 // Copyright (c) 2012 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.
 
 [
   {
     "namespace": "experimental.fontSettings",
     "types": [
       {
         "id": "FontName",
         "type": "object",
         "description": "Represents a font name.",
         "properties": {
           "fontName": {
             "type": "string",
             "description": "The font name."
           },
           "localizedName": {
             "type": "string",
             "description": "The font name localized for the current locale."
           }
         }
+      },
+      {
+        "id": "ScriptCode",
+        "type": "string",
+        "enum": [ "Arab", "Armn", "Beng", "Cans", "Cher", "Cyrl", "Deva", "Ethi", "Geor",
+                  "Grek", "Gujr", "Guru", "Hang", "Hans", "Hant", "Hebr", "Hrkt", "Knda",
+                  "Khmr", "Laoo", "Mlym", "Mong", "Mymr", "Orya", "Sinh", "Taml", "Telu",
+                  "Thaa", "Thai", "Tibt", "Yiii"
+                ],
+        "description": "An ISO 15924 script code."
+      },
+      {
+        "id": "GenericFamily",
+        "type": "string",
+        "enum": ["standard", "sansserif", "serif", "fixed", "cursive", "fantasy"],
+        "description": "A CSS generic font family."
       }
     ],
     "functions": [
       {
         "name": "getFontName",
-        "type": "function",
         "description": "Gets the font name of the current setting for a given script and generic font family.",
         "parameters": [
           {
             "name": "details",
             "type": "object",
             "properties": {
               "script": {
-                "type": "string",
-                "enum": [
-                    "Arab", "Armn", "Beng", "Cans", "Cher", "Cyrl", "Deva", "Ethi", "Geor",
-                    "Grek", "Gujr", "Guru", "Hang", "Hans", "Hant", "Hebr", "Hrkt", "Knda",
-                    "Khmr", "Laoo", "Mlym", "Mong", "Mymr", "Orya", "Sinh", "Taml", "Telu",
-                    "Thaa", "Thai", "Tibt", "Yiii"
-                ],
-                "description": "The ISO 15924 script code for which the font setting should be retrieved. If omitted, the global script font setting is retrieved.",
+                "$ref": "ScriptCode",
+                "description": "The script for which the font setting should be retrieved. If omitted, the global script font setting is retrieved.",
                 "optional": true
               },
               "genericFamily": {
-                "type": "string",
-                "enum": ["standard", "sansserif", "serif", "fixed", "cursive", "fantasy"],
-                "description": "The CSS generic font family for which the font setting should be retrieved."
+                "$ref": "GenericFamily",
+                "description": "The generic font family for which the font setting should be retrieved."
               }
             }
           },
           {
             "type": "function",
             "name": "callback",
             "optional": true,
             "parameters": [
               {
                 "name": "details",
                 "type": "object",
                 "properties": {
                   "fontName": {
                     "type": "string",
                     "description": "The font name. Rather than the literal font name preference value, this may be the name of the font that the system resolves the preference value to. The empty string signifies fallback to the global script font setting."
                   }
                 }
               }
             ]
           }
         ]
       },
       {
         "name": "setFontName",
-        "type": "function",
         "description": "Sets the font name of the current setting for a given script and generic font family.",
         "parameters": [
           {
             "name": "details",
             "type": "object",
             "properties": {
               "script": {
-                "type": "string",
-                "enum": [
-                    "Arab", "Armn", "Beng", "Cans", "Cher", "Cyrl", "Deva", "Ethi", "Geor",
-                    "Grek", "Gujr", "Guru", "Hang", "Hans", "Hant", "Hebr", "Hrkt", "Knda",
-                    "Khmr", "Laoo", "Mlym", "Mong", "Mymr", "Orya", "Sinh", "Taml", "Telu",
-                    "Thaa", "Thai", "Tibt", "Yiii"
-                ],
-                "description": "The ISO 15924 script code for which the font setting should be set. If omitted, the global script font setting is set.",
+                "$ref": "ScriptCode",
+                "description": "The script code which the font setting should be set. If omitted, the global script font setting is set.",
                 "optional": true
               },
               "genericFamily": {
-                "type": "string",
-                "enum": ["standard", "sansserif", "serif", "fixed", "cursive", "fantasy"],
-                "description": "The CSS generic font family for which the font setting should be set."
+                "$ref": "GenericFamily",
+                "description": "The generic font family for which the font setting should be set."
               },
               "fontName": {
                 "type": "string",
                 "description": "The font name. If a script is specified, the empty string means to fallback to the global script font setting."
               }
             }
           },
           {
             "type": "function",
             "name": "callback",
             "optional": true,
             "parameters": []
           }
         ]
       },
       {
         "name": "getFontList",
-        "type": "function",
         "description": "Gets a list of fonts on the system.",
         "parameters": [
           {
             "type": "function",
             "name": "callback",
             "parameters": [
               {
                 "name": "results",
                 "type": "array",
                 "items": { "$ref": "FontName" }
               }
             ]
           }
         ]
       },
       {
         "name": "getDefaultFontSize",
-        "type": "function",
         "description": "Gets the default font size.",
         "parameters": [
           {
             "name": "details",
             "type": "object",
             "optional": true,
             "description": "This parameter is currently unused."
           },
           {
             "name": "callback",
             "type": "function",
             "optional": true,
             "parameters": [
               {
                 "name": "details",
                 "type": "object",
                 "properties": {
                   "pixelSize": {
                     "type": "integer",
                     "description": "The font size in pixels."
                   }
                 }
               }
             ]
           }
         ]
       },
       {
         "name": "setDefaultFontSize",
-        "type": "function",
         "description": "Sets the default font size.",
         "parameters": [
           {
             "name": "details",
             "type": "object",
             "properties": {
               "pixelSize": {
                 "type": "integer",
                 "description": "The font size in pixels."
               }
             }
           },
           {
             "type": "function",
             "name": "callback",
             "optional": true,
             "parameters": []
           }
         ]
       },
       {
         "name": "getDefaultFixedFontSize",
-        "type": "function",
         "description": "Gets the default size for fixed width fonts.",
         "parameters": [
           {
             "name": "details",
             "type": "object",
             "optional": true,
             "description": "This parameter is currently unused."
           },
           {
             "name": "callback",
             "type": "function",
             "optional": true,
             "parameters": [
               {
                 "name": "details",
                 "type": "object",
                 "properties": {
                   "pixelSize": {
                     "type": "integer",
                     "description": "The font size in pixels."
                   }
                 }
               }
             ]
           }
         ]
       },
       {
         "name": "setDefaultFixedFontSize",
-        "type": "function",
         "description": "Sets the default size for fixed width fonts.",
         "parameters": [
           {
             "name": "details",
             "type": "object",
             "properties": {
               "pixelSize": {
                 "type": "integer",
                 "description": "The font size in pixels."
               }
             }
           },
           {
             "type": "function",
             "name": "callback",
             "optional": true,
             "parameters": []
           }
         ]
       },
       {
         "name": "getMinimumFontSize",
-        "type": "function",
         "description": "Gets the minimum font size.",
         "parameters": [
           {
             "name": "details",
             "type": "object",
             "optional": true,
             "description": "This parameter is currently unused."
           },
           {
             "name": "callback",
             "type": "function",
             "optional": true,
             "parameters": [
               {
                 "name": "details",
                 "type": "object",
                 "properties": {
                   "pixelSize": {
                     "type": "integer",
                     "description": "The font size in pixels."
                   }
                 }
               }
             ]
           }
         ]
       },
       {
         "name": "setMinimumFontSize",
-        "type": "function",
         "description": "Sets the minimum font size.",
         "parameters": [
           {
             "name": "details",
             "type": "object",
             "properties": {
               "pixelSize": {
                 "type": "integer",
                 "description": "The font size in pixels."
               }
             }
           },
           {
             "type": "function",
             "name": "callback",
             "optional": true,
             "parameters": []
           }
         ]
       }
+    ],
+    "events": [
+      {
+        "name": "onFontNameChanged",
+        "description": "Fired when a font name preference changes.",
+        "parameters": [
+          {
+            "type": "object",
+            "name": "details",
+            "properties": {
+              "fontName": { "type": "string" },
+              "script": {
+                "$ref": "ScriptCode",
+                "description": "The script code for which the font setting has changed. If omitted, the global script font setting has changed.",
+                "optional": true
+              },
+              "genericFamily": {
+                "$ref": "GenericFamily",
+                "description": "The generic font family for which the font setting has changed."
+              },
+              "levelOfControl": {
+                "description": "One of<br><var>not_controllable</var>: cannot be controlled by any extension<br><var>controlled_by_other_extensions</var>: controlled by extensions with higher precedence<br><var>controllable_by_this_extension</var>: can be controlled by this extension<br><var>controlled_by_this_extension</var>: controlled by this extension",
+                "type": "string",
+                "enum": ["not_controllable", "controlled_by_other_extensions", "controllable_by_this_extension", "controlled_by_this_extension"]
+              }
+            }
+          }
+        ]
+      }
     ]
   }
 ]