numbl 0.0.18 → 0.0.20

package/README.md

@@ -4,15 +4,27 @@ Numbl is an open-source numerical computing environment that aims to be compatib
 
 **Early stage project.** Numbl is under active development and new functionality is being added regularly.
 
+[Intro presentation](https://magland.github.io/mip-numbl-presentation)
+
 ## Try it in the browser
 
-You can try numbl directly in the browser at <https://numbl.org> — no installation required. All execution happens locally in your browser. Note that the browser version has limited functionality and is slower than the desktop/command-line version.
+[![numbl REPL](docs/repl-preview.svg)](https://numbl.org/embed-repl)
+
+Click the terminal above to launch an interactive REPL — no installation required. All execution happens locally in your browser. The full browser IDE with file management and plotting is available at <https://numbl.org>.
+
+Numbl scripts can also be embedded in HTML and Markdown pages (including GitHub Pages). See the [numbl-embed-example](https://magland.github.io/numbl-embed-example/) for usage and a [live demo](https://magland.github.io/numbl-embed-example/example1).
+
+## Command-line usage
 
-## Embedding in web pages
+For full performance, use the command-line version. If you have Node.js installed, you can run numbl directly with `npx` (no install needed):
 
-Numbl scripts can be embedded in HTML and Markdown pages (including GitHub Pages). See the [numbl-embed-example](https://magland.github.io/numbl-embed-example/) for usage info and a [live demo](https://magland.github.io/numbl-embed-example/example1).
+```bash
+npx numbl                      # interactive REPL
+npx numbl eval "disp(eye(3))"  # evaluate inline code
+npx numbl run script.m         # run a .m file
+```
 
-## Installation
+Or install globally for regular use:
 
 ```bash
 npm install -g numbl
@@ -27,14 +39,39 @@ numbl build-addon
 
 ## Usage
 
-```bash
-numbl                          # interactive REPL
-numbl run script.m             # run a .m file
-numbl eval "disp(eye(3))"      # evaluate inline code
-numbl info                     # print info (JSON), including native addon status
-numbl list-builtins            # list available built-in functions
-numbl --help                   # show all commands and options
+<!-- BEGIN CLI HELP -->
+```
+Usage: numbl <command> [options]
+
+Commands:
+  run <file.m>       Run a .m file
+  eval "<code>"      Evaluate inline code
+  run-tests [dir]    Run .m test scripts (default: numbl_test_scripts/)
+  build-addon        Build native LAPACK addon
+  info               Print machine-readable info (JSON)
+  list-builtins      List available built-in functions
+  mip <subcommand>   Package manager (install, uninstall, list, avail, info)
+  (no command)       Start interactive REPL
+
+Options (for REPL):
+  --plot             Enable plot server
+  --plot-port <port> Set plot server port (implies --plot)
+
+Options (for run and eval):
+  --dump-js <file>   Write all generated JavaScript (main + JIT) to file
+  --dump-ast         Print AST as JSON
+  --verbose          Detailed logging to stderr
+  --stream           NDJSON output mode
+  --path <dir>       Add extra workspace directory
+  --plot             Enable plot server
+  --plot-port <port> Set plot server port (implies --plot)
+  --add-script-path  Add the script's directory to the workspace (run only)
+  --no-line-tracking  Omit $rt.$file/$rt.$line from generated JS
+
+Environment variables:
+  NUMBL_PATH         Extra workspace directories (separated by :)
 ```
+<!-- END CLI HELP -->
 
 ## Upgrading
 

package/binding.gyp

@@ -13,7 +13,8 @@
         "native/lapack_eig.cpp",
         "native/lapack_chol.cpp",
         "native/lapack_qz.cpp",
-        "native/lapack_fft.cpp"
+        "native/lapack_fft.cpp",
+        "native/lapack_fft_batch.cpp"
       ],
       "include_dirs": [
         "<!@(node -p \"require('node-addon-api').include\")",