Feature/Add command to load OpenAPI specifications from local disk

Author: jakubkozera

src/vsc-extension/openapi-ui/CHANGELOG.md

@@ -4,6 +4,16 @@ All notable changes to the "openapi-ui" extension will be documented in this fil
 
 Check [Keep a Changelog](http://keepachangelog.com/) for recommendations on how to structure this file.
 
+## [1.1.1] - 2026-01-27
+
+### Added
+
+- **Load from Disk**: New command `openapi-ui.loadFromDisk` to load OpenAPI specifications from local files
+  - Supports JSON and YAML files via file picker dialog
+  - Accepts optional file path parameter for programmatic usage
+  - Validates JSON content before loading
+  - Displays file name in webview title
+
 ## [1.1.0] - 2026-01-27
 
 ### Added
@@ -22,6 +32,8 @@ Check [Keep a Changelog](http://keepachangelog.com/) for recommendations on how
   - FetchInterceptor script validation tests
 
 
+
+
 ## [Unreleased]
 
 - Initial release

src/vsc-extension/openapi-ui/package.json

@@ -2,7 +2,7 @@
   "name": "openapi-ui",
   "displayName": "OpenAPI UI",
   "description": "OpenAPI UI viewer for VS Code",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "publisher": "JakubKozera",
   "icon": "openapi-ui.png",
   "repository": {
@@ -84,6 +84,11 @@
         "command": "openapi-ui.openWithUrl",
         "title": "Open OpenAPI UI with URL",
         "icon": "$(link-external)"
+      },
+      {
+        "command": "openapi-ui.loadFromDisk",
+        "title": "Load OpenAPI UI from Disk",
+        "icon": "$(file)"
       }
     ],
     "menus": {
@@ -113,6 +118,9 @@
         },
         {
           "command": "openapi-ui.openWithUrl"
+        },
+        {
+          "command": "openapi-ui.loadFromDisk"
         }
       ]
     }

src/vsc-extension/openapi-ui/src/extension.ts

@@ -363,7 +363,7 @@ export function activate(context: vscode.ExtensionContext) {
 
         const panel = vscode.window.createWebviewPanel(
           "openapiURLUI",
-          `OpenAPI UI - ${new URL(openapiUrl).hostname}`,
+          `OpenAPI UI`,
           vscode.ViewColumn.One,
           {
             enableScripts: true,
@@ -399,14 +399,88 @@ export function activate(context: vscode.ExtensionContext) {
     }
   );
 
+  // Register command to load OpenAPI UI from local disk file
+  let loadFromDiskDisposable = vscode.commands.registerCommand(
+    "openapi-ui.loadFromDisk",
+    async (filePath?: string) => {
+      let selectedFilePath = filePath;
+
+      // If no file path provided, show file picker
+      if (!selectedFilePath) {
+        const fileUri = await vscode.window.showOpenDialog({
+          canSelectMany: false,
+          openLabel: "Select OpenAPI Specification",
+          filters: {
+            "JSON files": ["json"],
+            "YAML files": ["yaml", "yml"],
+            "All files": ["*"],
+          },
+        });
+
+        if (!fileUri || fileUri.length === 0) {
+          return;
+        }
+
+        selectedFilePath = fileUri[0].fsPath;
+      }
+
+      try {
+        // Read file content
+        const fileContent = fs.readFileSync(selectedFilePath, "utf8");
+
+        // Validate JSON
+        JSON.parse(fileContent);
+
+        const fileName = path.basename(selectedFilePath);
+
+        const panel = vscode.window.createWebviewPanel(
+          "openapiDiskUI",
+          `OpenAPI UI`,
+          vscode.ViewColumn.One,
+          {
+            enableScripts: true,
+            localResourceRoots: [
+              vscode.Uri.file(path.join(context.extensionPath, "core-dist")),
+            ],
+          }
+        );
+
+        // Set webview icon
+        panel.iconPath = vscode.Uri.file(
+          path.join(context.extensionPath, "openapi-ui.png")
+        );
+
+        // Set up message handling for fetch proxy
+        const messageHandler = setupWebviewMessageHandler(panel);
+        panel.onDidDispose(() => messageHandler.dispose());
+
+        panel.webview.html = getWebviewContent(
+          panel.webview,
+          context.extensionPath,
+          undefined,
+          fileContent
+        );
+
+        vscode.window.showInformationMessage(
+          `Opened OpenAPI UI from ${fileName}`
+        );
+      } catch (error) {
+        vscode.window.showErrorMessage(
+          `Failed to load OpenAPI file: ${error}`
+        );
+      }
+    }
+  );
+
   context.subscriptions.push(
     openViewDisposable,
     addSourceDisposable,
     removeSourceDisposable,
     refreshSourcesDisposable,
     loadSourceDisposable,
     addJsonSourceDisposable,
-    openWithUrlDisposable
+    openWithUrlDisposable,
+    loadFromDiskDisposable
   );
 }