Deprecate visibilityMenuItems in contextMenu notification (#1938)

Author: noisysocks

special-pages/pages/new-tab/app/new-tab.md

@@ -34,6 +34,7 @@ children:
 - Sent when the user right-clicks in the page
 - Note: Other widgets might prevent this (and send their own, eg: favorites)
 - Sends: {@link "NewTab Messages".ContextMenuNotify}
+- **DEPRECATED**: The `visibilityMenuItems` property is deprecated and will be removed in a future version. Native apps should populate the context menu themselves instead of relying on frontend to tell it what widgets exist in the New Tab Page.
 - Example:
 
 ```json

special-pages/pages/new-tab/messages/contextMenu.notify.json

@@ -5,6 +5,8 @@
   "properties": {
     "visibilityMenuItems": {
       "type": "array",
+      "deprecated": true,
+      "description": "DEPRECATED: This property is deprecated and will be removed in a future version. Native apps should populate the context menu themselves instead of relying on frontend to tell it what widgets exist in the New Tab Page.",
       "items": {
         "type": "object",
         "title": "Visibility Menu Item",

special-pages/pages/new-tab/types/new-tab.ts

@@ -239,6 +239,10 @@ export interface ContextMenuNotification {
   params: ContextMenuNotify;
 }
 export interface ContextMenuNotify {
+  /**
+   * @deprecated
+   * DEPRECATED: This property is deprecated and will be removed in a future version. Native apps should populate the context menu themselves instead of relying on frontend to tell it what widgets exist in the New Tab Page.
+   */
   visibilityMenuItems: VisibilityMenuItem[];
 }
 export interface VisibilityMenuItem {