add iconography to documentation live preview (#1290)

assets/icons/README.md

@@ -0,0 +1,13 @@
+# Custom Icons for the Swift extension
+
+This folder contains custom iconography used in various sections of the Swift extension for VS Code.
+
+All icons are compiled into a single icon font using [IcoMoon](https://icomoon.io/app). The icons must be placed at the following codes within the font file:
+
+```
+\\E001 - swift-icon
+\\E002 - swift-documentation
+\\E003 - swift-documentation-preview
+```
+
+Any newly added icons will need to be added to the icons contribution point in the [package.json](../../package.json) for them to be usable from within the extension.

package.json

@@ -36,9 +36,23 @@
       "swift-icon": {
         "description": "The official icon for the Swift programming language",
         "default": {
-          "fontPath": "assets/icon-font.woff",
+          "fontPath": "assets/icons/icon-font.woff",
           "fontCharacter": "\\E001"
         }
+      },
+      "swift-documentation": {
+        "description": "The icon for the Swift documentation preview editor",
+        "default": {
+          "fontPath": "assets/icons/icon-font.woff",
+          "fontCharacter": "\\E002"
+        }
+      },
+      "swift-documentation-preview": {
+        "description": "The icon used as a button for showing the Swift documentation preview editor",
+        "default": {
+          "fontPath": "assets/icons/icon-font.woff",
+          "fontCharacter": "\\E003"
+        }
       }
     },
     "terminal": {
@@ -88,7 +102,8 @@
       {
         "command": "swift.previewDocumentation",
         "title": "Preview Documentation",
-        "category": "Swift"
+        "category": "Swift",
+        "icon": "$(swift-documentation-preview)"
       },
       {
         "command": "swift.createNewProject",
@@ -779,6 +794,13 @@
           "submenu": "swift.editor"
         }
       ],
+      "editor/title": [
+        {
+          "command": "swift.previewDocumentation",
+          "when": "swift.supportsDocumentationLivePreview && (editorLangId == markdown || editorLangId == tutorial || editorLangId == swift)",
+          "group": "navigation"
+        }
+      ],
       "swift.editor": [
         {
           "command": "swift.run",

src/documentation/DocumentationPreviewEditor.ts

@@ -48,6 +48,18 @@ export class DocumentationPreviewEditor implements vscode.Disposable {
                 ],
             }
         );
+        webviewPanel.iconPath = {
+            light: vscode.Uri.file(
+                extension.asAbsolutePath(
+                    path.join("assets", "icons", "light", "swift-documentation.svg")
+                )
+            ),
+            dark: vscode.Uri.file(
+                extension.asAbsolutePath(
+                    path.join("assets", "icons", "dark", "swift-documentation.svg")
+                )
+            ),
+        };
         const webviewBaseURI = webviewPanel.webview.asWebviewUri(
             vscode.Uri.file(swiftDoccRenderPath)
         );