@jentic/arazzo-ui 1.0.0-alpha.28 → 1.0.0-alpha.30

package/CHANGELOG.md

@@ -3,6 +3,21 @@
 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.30](https://github.com/jentic/jentic-arazzo-tools/compare/v1.0.0-alpha.29...v1.0.0-alpha.30) (2026-04-04)
+
+**Note:** Version bump only for package @jentic/arazzo-ui
+
+# [1.0.0-alpha.29](https://github.com/jentic/jentic-arazzo-tools/compare/v1.0.0-alpha.28...v1.0.0-alpha.29) (2026-03-19)
+
+### Bug Fixes
+
+- **parser:** avoid dumping entire source document to error ([#176](https://github.com/jentic/jentic-arazzo-tools/issues/176)) ([2e51fde](https://github.com/jentic/jentic-arazzo-tools/commit/2e51fdea7d0d7aa9be0d54ae1df30eee2117fb76))
+- **ui:** fix file upload UX accessibility ([#175](https://github.com/jentic/jentic-arazzo-tools/issues/175)) ([704f07e](https://github.com/jentic/jentic-arazzo-tools/commit/704f07e27b4848bd95277944a93e01e205cb9786))
+
+### Features
+
+- **ui:** open local files via CLI in browser ([#177](https://github.com/jentic/jentic-arazzo-tools/issues/177)) ([ef440d3](https://github.com/jentic/jentic-arazzo-tools/commit/ef440d36fdff0f1a1bab2453e57ae1b957f9ccc5)), closes [#144](https://github.com/jentic/jentic-arazzo-tools/issues/144)
+
 # [1.0.0-alpha.28](https://github.com/jentic/jentic-arazzo-tools/compare/v1.0.0-alpha.27...v1.0.0-alpha.28) (2026-03-19)
 
 ### Features

package/README.md

@@ -36,10 +36,16 @@ npm install @jentic/arazzo-ui
 Open any Arazzo document in the browser without installing anything locally:
 
 ```sh
+# from a URL
 npx @jentic/arazzo-ui https://arazzo-ui.jentic.com/petstore-order-workflow.arazzo.yaml
+
+# from a local file
+npx @jentic/arazzo-ui ./workflow.arazzo.yaml
 ```
 
 This opens `https://arazzo-ui.jentic.com` with the document pre-loaded.
+Local files are passed via the URL fragment (`#document=`), so the document content is never sent to the server.
+The resulting URL is also shareable if the workflow size is not too large.
 
 ## Components
 

package/bin/arazzo-ui.mjs

@@ -1,6 +1,9 @@
 #!/usr/bin/env node
 
 import { execFile } from 'node:child_process';
+import { readFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { url as urlUtils } from '@speclynx/apidom-reference/configuration/empty';
 
 const BASE_URL = 'https://arazzo-ui.jentic.com';
 
@@ -22,25 +25,33 @@ function openBrowser(url) {
   }
 }
 
-const url = process.argv[2];
+const input = 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:');
+if (!input || input === '--help' || input === '-h') {
+  console.log('Usage: arazzo-ui <url-or-file>\n');
+  console.log('Open an Arazzo Document in the browser.\n');
+  console.log('Examples:');
   console.log(
     '  npx @jentic/arazzo-ui https://arazzo-ui.jentic.com/petstore-order-workflow.arazzo.yaml',
   );
-  process.exit(url ? 0 : 1);
+  console.log('  npx @jentic/arazzo-ui ./workflow.arazzo.yaml');
+  process.exit(input ? 0 : 1);
 }
 
-try {
-  new URL(url);
-} catch {
-  console.error(`Invalid URL: ${url}\nPlease provide a valid URL to an Arazzo document.`);
-  process.exit(1);
+let viewerURL;
+
+if (urlUtils.isHttpUrl(input)) {
+  viewerURL = `${BASE_URL}?document=${encodeURIComponent(input)}`;
+} else {
+  const filePath = resolve(input);
+  try {
+    const content = await readFile(filePath, 'utf-8');
+    viewerURL = `${BASE_URL}#document=${encodeURIComponent(content)}`;
+  } catch (err) {
+    console.error(`Failed to read file: ${filePath}\n${err.message}`);
+    process.exit(1);
+  }
 }
 
-const viewerURL = `${BASE_URL}?document=${encodeURIComponent(url)}`;
 console.log(`Opening ${viewerURL}`);
 openBrowser(viewerURL);