@jentic/arazzo-ui 1.0.0-alpha.18 → 1.0.0-alpha.20

package/CHANGELOG.md

@@ -3,6 +3,23 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.0.0-alpha.20](https://github.com/jentic/jentic-arazzo-tools/compare/v1.0.0-alpha.19...v1.0.0-alpha.20) (2026-02-24)
+
+**Note:** Version bump only for package @jentic/arazzo-ui
+
+# [1.0.0-alpha.19](https://github.com/jentic/jentic-arazzo-tools/compare/v1.0.0-alpha.18...v1.0.0-alpha.19) (2026-02-23)
+
+### Bug Fixes
+
+- **arazzo-ui:** fix demo URL ([418982e](https://github.com/jentic/jentic-arazzo-tools/commit/418982e231e83e509e2e0705d9a2029ea639b6ae))
+
+### Features
+
+- **arazoo-ui:** align with Arazzo logo color scheme ([#101](https://github.com/jentic/jentic-arazzo-tools/issues/101)) ([850fdca](https://github.com/jentic/jentic-arazzo-tools/commit/850fdca3d067c28b79b6590ed1cbf449b7d510a1))
+- **arazzo-ui:** add CLI for opening any URL from command cli ([#103](https://github.com/jentic/jentic-arazzo-tools/issues/103)) ([6923e7b](https://github.com/jentic/jentic-arazzo-tools/commit/6923e7bdcb62e86266789e18ef6af5dc27459110)), closes [#96](https://github.com/jentic/jentic-arazzo-tools/issues/96)
+- **arazzo-ui:** add support for document url query param ([2a1aed6](https://github.com/jentic/jentic-arazzo-tools/commit/2a1aed6cb1f07bcbe9a0cd7fd9d2e04cc27cf599))
+- **arazzo-ui:** provide Arazzo favicon ([019b45d](https://github.com/jentic/jentic-arazzo-tools/commit/019b45d42a8746b23e7328d5d03ce9328e82fb70))
+
 # [1.0.0-alpha.18](https://github.com/jentic/jentic-arazzo-tools/compare/v1.0.0-alpha.17...v1.0.0-alpha.18) (2026-02-20)
 
 **Note:** Version bump only for package @jentic/arazzo-ui

package/README.md

@@ -3,14 +3,20 @@
 `@jentic/arazzo-ui` is a UI component for visualizing [Arazzo Specification](https://spec.openapis.org/arazzo/latest.html) workflows.
 It provides interactive diagram views, documentation views, and a split view combining both.
 
-[![Live Demo](https://img.shields.io/badge/Live%20Demo-jentic.github.io-blue?style=for-the-badge)](https://jentic.github.io/jentic-arazzo-tools/)
+[![Live Demo](https://img.shields.io/badge/Live%20Demo-arazzo--ui.jentic.com-blue?style=for-the-badge)](https://arazzo-ui.jentic.com)
 
 <p align="center">
-  <a href="https://jentic.github.io/jentic-arazzo-tools/">
-    <img src="https://github.com/jentic/jentic-arazzo-tools/blob/main/assets/arazzo-ui.png" alt="ArazzoUI Screenshot" />
+  <a href="https://arazzo-ui.jentic.com">
+    <img src="https://raw.githubusercontent.com/jentic/jentic-arazzo-tools/main/assets/arazzo-ui.png" alt="ArazzoUI Screenshot" />
   </a>
 </p>
 
+Load any Arazzo Document by appending a `?document=` query parameter:
+
+```
+https://arazzo-ui.jentic.com?document=https://arazzo-ui.jentic.com/petstore-order-workflow.arazzo.yaml
+```
+
 **Supported Arazzo versions:**
 - [Arazzo 1.0.0](https://spec.openapis.org/arazzo/v1.0.0)
 - [Arazzo 1.0.1](https://spec.openapis.org/arazzo/v1.0.1)
@@ -25,6 +31,16 @@ npm install @jentic/arazzo-ui
 
 **Peer dependencies:** React 18 or 19 ([react](https://www.npmjs.com/package/react) and [react-dom](https://www.npmjs.com/package/react-dom)).
 
+## CLI
+
+Open any Arazzo document in the browser without installing anything locally:
+
+```sh
+npx @jentic/arazzo-ui https://arazzo-ui.jentic.com/petstore-order-workflow.arazzo.yaml
+```
+
+This opens `https://arazzo-ui.jentic.com` with the document pre-loaded.
+
 ## Components
 
 ### ArazzoUI

package/bin/arazzo-ui.mjs

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+
+import { execFile } from 'node:child_process';
+
+const BASE_URL = 'https://arazzo-ui.jentic.com';
+
+function openBrowser(url) {
+  const { platform } = process;
+
+  const onError = (error) => {
+    if (error) {
+      console.error(`Could not open browser. Visit the URL manually:\n${url}`);
+    }
+  };
+
+  if (platform === 'darwin') {
+    execFile('open', [url], onError);
+  } else if (platform === 'win32') {
+    execFile('cmd', ['/c', 'start', '', url], onError);
+  } else {
+    execFile('xdg-open', [url], onError);
+  }
+}
+
+const url = process.argv[2];
+
+if (!url || url === '--help' || url === '-h') {
+  console.log('Usage: arazzo-ui <url>\n');
+  console.log('Open an Arazzo document in the browser.\n');
+  console.log('Example:');
+  console.log(
+    '  npx @jentic/arazzo-ui https://arazzo-ui.jentic.com/petstore-order-workflow.arazzo.yaml',
+  );
+  process.exit(url ? 0 : 1);
+}
+
+try {
+  new URL(url);
+} catch {
+  console.error(`Invalid URL: ${url}\nPlease provide a valid URL to an Arazzo document.`);
+  process.exit(1);
+}
+
+const viewerURL = `${BASE_URL}?document=${encodeURIComponent(url)}`;
+console.log(`Opening ${viewerURL}`);
+openBrowser(viewerURL);