numbl 0.0.8 → 0.0.11

package/README.md

@@ -1,12 +1,12 @@
 # Numbl
 
-Numbl lets you run MATLAB-compatible code in the browser and on the command line. It works by compiling `.m` source code to JavaScript and executing it directly. In the browser, all execution happens locally — no code is sent to a remote server.
+Numbl is an open-source numerical computing environment that aims to be compatible with Matlab. It works by compiling `.m` source code to JavaScript and executing it directly. It can work in the browser or on the command line.
 
-**Early stage project.** Numbl is under active development and new functionality is being added regularly. Performance is currently very slow compared to MATLAB — we intend to improve this over time, with the goal of reaching performance comparable to desktop MATLAB and as fast as possible in the browser.
+**Early stage project.** Numbl is under active development and new functionality is being added regularly.
 
 ## Try it in the browser
 
-You can try numbl directly in the browser at <https://magland.github.io/numbl> — no installation required. All execution happens locally in your browser. Note that the browser version does not include LAPACK support, so linear algebra operations (matrix inverse, SVD, eigenvalues, etc.) will use a slower pure JavaScript fallback.
+You can try numbl directly in the browser at <https://magland.github.io/numbl> — no installation required. All execution happens locally in your browser. Note that the browser version has limited functionality and is slower than the CLI.
 
 ## Installation
 
@@ -14,20 +14,22 @@ You can try numbl directly in the browser at <https://magland.github.io/numbl>
 npm install -g numbl
 ```
 
-To enable fast linear algebra (matrix inverse, SVD, eigenvalues, etc.), build the native LAPACK addon. This links to your system's LAPACK/OpenBLAS library and is significantly faster than the pure JavaScript fallback.
+To enable fast linear algebra (matrix inverse, SVD, eigenvalues, etc.), build the native LAPACK addon:
 
 ```bash
-# Prerequisites: C++ compiler, libopenblas-dev (or equivalent for your OS)
+# Prerequisites: C++ compiler, libopenblas-dev, libfftw3-dev (or equivalents for your OS)
 numbl build-addon
 ```
 
 ## Usage
 
 ```bash
-numbl script.m                 # run a .m file
-numbl -e "disp(eye(3))"       # run inline code
 numbl                          # interactive REPL
-numbl --info                   # check native addon status
+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
 ```
 
 ## Try it with Docker
@@ -47,13 +49,13 @@ docker run -it -p 8234:8234 node:22 npx numbl --plot-port 8234
 With native LAPACK support for fast linear algebra:
 
 ```bash
-docker run -it node:22 bash -c "apt-get update && apt-get install -y libopenblas-dev && npx numbl build-addon && npx numbl"
+docker run -it node:22 bash -c "apt-get update && apt-get install -y libopenblas-dev libfftw3-dev && npx numbl build-addon && npx numbl"
 ```
 
 With both LAPACK and plotting:
 
 ```bash
-docker run -it -p 8234:8234 node:22 bash -c "apt-get update && apt-get install -y libopenblas-dev && npx numbl build-addon && npx numbl --plot-port 8234"
+docker run -it -p 8234:8234 node:22 bash -c "apt-get update && apt-get install -y libopenblas-dev libfftw3-dev && npx numbl build-addon && npx numbl --plot-port 8234"
 ```
 
 ## Upgrading

package/binding.gyp

@@ -6,19 +6,28 @@
         "native/lapack_addon.cpp",
         "native/lapack_inv.cpp",
         "native/lapack_qr.cpp",
+        "native/lapack_lu.cpp",
         "native/lapack_svd.cpp",
         "native/lapack_matmul.cpp",
         "native/lapack_linsolve.cpp",
-        "native/lapack_eig.cpp"
+        "native/lapack_eig.cpp",
+        "native/lapack_chol.cpp",
+        "native/lapack_qz.cpp",
+        "native/lapack_fft.cpp"
       ],
       "include_dirs": [
-        "<!@(node -p \"require('node-addon-api').include\")"
+        "<!@(node -p \"require('node-addon-api').include\")",
+        "<!@(pkg-config --cflags-only-I fftw3 2>/dev/null | sed 's/-I//g' || true)"
       ],
       "dependencies": [
         "<!(node -p \"require('node-addon-api').gyp\")"
       ],
       "defines": [ "NAPI_DISABLE_CPP_EXCEPTIONS" ],
-      "libraries": [ "-lopenblas" ],
+      "libraries": [
+        "-lopenblas",
+        "<!@(pkg-config --libs fftw3 2>/dev/null || echo '-lfftw3')",
+        "<!@(pkg-config --libs-only-L fftw3 2>/dev/null | sed 's/-L/-Wl,-rpath,/g' || true)"
+      ],
       "cflags_cc": [ "-std=c++17", "-O2" ]
     }
   ]