feat: CLI tool for visualizing plans

.eslintrc.cjs

@@ -0,0 +1,17 @@
+module.exports = {
+  parser: '@typescript-eslint/parser',
+  plugins: ['@typescript-eslint', 'prettier', 'import'],
+  ignorePatterns: ['node_modules/', 'dist/', 'generated/'],
+  extends: ['plugin:@typescript-eslint/recommended', 'prettier'],
+  rules: {
+    '@typescript-eslint/no-explicit-any': 'off',
+    'prettier/prettier': 'error',
+    'import/order': [
+      'error',
+      {
+        'groups': [['builtin', 'external'], ['internal', 'parent', 'sibling', 'index']],
+        'newlines-between': 'always',
+      },
+    ],
+  },
+};

.github/workflows/lint.yaml

@@ -1,6 +1,6 @@
 name: Lint
 
-on: [push]
+on: [push, pull_request]
 
 jobs:
   ESLint: 

.nvmrc

@@ -0,0 +1 @@
+18.0.0

README.md

@@ -1,6 +1,6 @@
 
 # susbtrait-js
-Typescript typings for Substrait specifications. Also provides a parser for translating substrait plans.
+Typescript typings for Substrait specifications. Also provides a parser for translating substrait plans and a CLI tool to visualize substrait plans.
 
 Substrait is cross-language specification for data compute operations, composed primarily of:
 1. a formal specification
@@ -29,6 +29,20 @@ Installation includes the following steps:
 npm ci
 npm run build
 ```
+
+## Visualization
+substrait-JS provides a CLI tool for exporting graph visualization of substrait JSON and binary plans. The tool currently uses the `--experimental-specifier-resolution` flag for module resolution. The  visualization functions are the required helper methods for the [substrait-fiddle](https://github.com/voltrondata/substrait-fiddle) tool.
+
+The tool uses [viz-js](https://github.com/mdaines/viz-js) for rendering plots on JSDOM using [Graphviz](https://graphviz.org/)'s DOT language.
+
+Plot generation includes the following steps:
+```
+// The tool currently requires NodeJS version 18.0.0 for operation
+source ~/.nvm/nvm.sh
+nvm use 18.0.0
+
+substrait  -p ../plan.json -o <output path>
+```
 
 ## License
 [Apache-2.0 license](https://www.apache.org/licenses/LICENSE-2.0)