RunMat
GitHub

RunMat Changelog

What's new across the RunMat runtime, app, and sandbox. For technical runtime details and commit diffs, see GitHub Releases (runtime only).

v0.4.8

May 15, 2026

Runtime

Added

  • Add tf — scalar-input scalar-output transfer-function objects now support numeric, logical, integer, complex, row-vector, and column-vector coefficient inputs, continuous and discrete sample-time defaults, Variable, Ts/SampleTime, Numerator, Denominator, InputDelay, and OutputDelay properties, and class(H) == "tf"
  • Add angle conversion builtins — deg2rad and rad2deg now operate element-wise on scalars, vectors, matrices, N-D tensors, complex values, integer/logical inputs, and GPU-resident inputs, with fusion support for compatible element-wise expressions
  • Add reference-line plotting — xline and yline now draw vertical and horizontal reference lines with scalar or vector coordinates, line-style strings, labels, LineWidth, Color, LabelOrientation, Visible, returned graphics handles, and get/set/dot-property integration

Changed

  • Track workspace assignments through the VM and Turbine JIT so interpreter fallback, compiled stores, clear, and clearvars publish only the variables assigned or removed by the current execution
  • Route browser-backed file handles through async open and flush paths so fopen, fclose, fread, fwrite, feof, fgets, fprintf, and frewind share consistent registry and provider behavior across native and WASM hosts
  • Expand plotting metadata and property handling for reference-line handles, including reference-line render data, legend labels, Value, style properties, and preservation of existing axis labels when reference lines are appended

Fixed

  • Fix native session result handling for repeated multi-statement execution so final assignment values and workspace previews stay numeric after JIT compilation and fallback
  • Fix parser diagnostic locations for malformed calls, expected identifiers, and member access after ., reporting the offending token instead of a stale source position
  • Fix WGPU fused-kernel preflight checks to reject storage-buffer, bind-group, and arithmetic binding-count overflows before creating invalid WebGPU layouts
  • Fix browser/WASM file close behavior so async flush failures keep the file registered, concurrent fclose calls close a file only once, and dirty buffers are restored if async write-back fails
  • Fix plot(x, y) compatibility for matching row-vector and column-vector pairs with the same number of elements
  • Fix fft default-dimension output for row vectors so row orientation is preserved
  • Fix single-point hann, hamming, and blackman windows by using the host path instead of provider paths that expect longer window lengths

Sandbox

Changed

  • Move the browser filesystem provider to async JavaScript filesystem operations for open, read, write, metadata, directory, rename, removal, and permission updates
  • Avoid unnecessary initial file reads for write-create-truncate opens while preserving create_new, read, and append semantics

v0.4.6

May 8, 2026

Runtime

Added

  • Add ODE solvers — ode23, ode45, and ode15s now solve scalar, vector, and matrix-valued initial-value problems with adaptive stepping, requested tspan output points, and RelTol, AbsTol, InitialStep, and MaxStep options
  • Add random distribution builtins — exprnd, normrnd, and unifrnd, including scalar and shaped outputs, deterministic host RNG behavior, parameter validation, and WGPU-backed generation when the active provider supports it
  • Add image color and class conversion builtins — rgb2gray, gray2rgb, ind2rgb, im2double, im2uint8, im2uint16, rgb2hsv, hsv2rgb, rgb2lab, and lab2rgb
  • Add heatmap plot support with matrix CData input, optional row and column labels, returned graphics handles, colorbar support, and get/set/dot-property integration
  • Add clearvars with explicit variable clearing and -except exclusions

Changed

  • Split WGPU random distribution execution into dedicated provider code and add parameterized kernels for exponential, normal, and uniform distributions
  • Reuse the shared value-to-string conversion path for graphics labels and property handling

v0.4.5

May 1, 2026

Runtime

Added

  • Add image I/O and display support — imread reads raster images into MATLAB-compatible grayscale, truecolor, and alpha arrays, and imshow displays numeric, logical, truecolor, and file-backed images with MATLAB-style display ranges
  • Add interpolation builtins — interp1, interp2, spline, pchip, and ppval, including piecewise-polynomial structs and linear, nearest, spline, and shape-preserving cubic paths
  • Add optimization builtins — fzero, fsolve, and optimset, with bracket expansion, Brent refinement, finite-difference Levenberg-Marquardt solving, display/tolerance options, and output shape preservation
  • Add format — session-persistent numeric display modes for short, long, shortE, longE, shortG, longG, rat, and hex
  • Add strsplit with simple and regular-expression delimiters, CollapseDelimiters, DelimiterType, and optional delimiter-match output

Changed

  • Extend tensor dtype metadata for uint8 and uint16 so class, WASM value previews, image operations, diag, reductions, and zeros/ones(..., "like", value) report and preserve integer image-style arrays correctly
  • Share common tensor dtype coercion and clamping helpers across image, reduction, and array creation builtins
  • Route numeric-to-string conversion through the active format mode so display output, string conversion, and complex formatting stay consistent

Fixed

  • Fix command-form parsing so bare newlines terminate commands, while ... continuations still work after multiple blank lines
  • Fix whos and value metadata size reporting for tensors stored in the runtime's f64 backing representation

Sandbox

Changed

  • Share the default browser filesystem provider and IndexedDB backing across session instances, with ref-counted cleanup and consistent flush behavior
  • Reject incompatible IndexedDB backing options instead of silently mixing providers with different timing hooks or flush policies

v0.4.4

April 24, 2026

Runtime

Added

  • Add cross — MATLAB-compatible vector cross products across row vectors, column vectors, matrices, and higher-rank tensors, with GPU-resident execution for real-valued inputs when the active provider supports it
  • Add gradient — numerical gradients with MATLAB-compatible matrix output ordering, scalar spacing support, complex host support, and WGPU-backed GPU residency for scalar-spacing gradients
  • Add trapz and cumtrapz — trapezoidal and cumulative trapezoidal integration with scalar spacing, coordinate-vector spacing, explicit dimension selection, complex inputs, and GPU input fallback that re-uploads real-valued outputs for downstream GPU work
  • Add sgtitle — figure-level titles for subplot layouts with text styling, explicit figure-handle targeting, get/set support, scene replay, and vector/native export support
  • Add CLI artifact capture for script runs — --artifacts-dir, --artifacts-manifest, --capture-figures, --figure-size, and --max-figures

Changed

  • Rename runmat-ignition to runmat-vm and split the VM, compiler, interpreter dispatch, indexing, runtime state, and acceleration paths into smaller modules
  • Refactor the lexer, parser, HIR, core session, WASM runtime, and CLI layers for maintainability without changing their public behavior
  • Expand TypeScript/WASM figure metadata to include sgTitle and sgTitleStyle, matching the new figure-level title support

Fixed

  • Fix WGPU provider cleanup for intermediate GPU tensor handles so error paths release temporary device resources correctly
  • Fix gradient shape handling for empty tensors and align WGPU gradient parameters for the backend layout
  • Fix SVG/vector-export text positioning so subplot titles and figure-level titles scale correctly with font size
  • Fix sgtitle serialization and child enumeration, and allow numeric values to be used as title text

Sandbox

Changed

  • Reorganize the browser/WASM runtime into dedicated API, plotting, session, stream, filesystem, GPU, snapshot, state, and wire-format modules
  • Improve replay smoke coverage and GPU gradient coverage for the WASM target

App

Changed

  • Update remote-project CLI documentation around authentication, project selection, filesystem history, snapshots, git sync, retention policies, and remote run

v0.4.1

April 15, 2026

Runtime

Added

  • Expand input() compatibility — numeric prompts now accept logical values, named constants (pi, inf, nan), and matrix/vector literals with MATLAB-compatible output types. Complex expressions such as sqrt(2) and ones(3) now evaluate through the full MATLAB pipeline when an eval hook is available
  • Add configurable CLI credential storage for runmat login — auto, secure, file, and memory

Changed

  • Improve CLI auth persistence — auto mode now prefers secure keyring storage and falls back to file-backed credentials with restricted permissions when secure storage is unavailable
  • Extract remote auth and public API client logic into a dedicated runmat-server-client crate

Fixed

  • Fix native input() evaluation stack overflow by isolating nested prompt evaluation from the outer interpreter call stack
  • Fix GPU-backed selector indexing — GPU-resident index tensors now materialize correctly before linear and dimensional indexing

Sandbox

Fixed

  • Fix workspace/variable display after clear() — variables assigned later in the same execution block now reappear correctly in workspace snapshots
  • Fix browser input() handling after session resets — reinitializing the WASM session now preserves the installed async input handler

App

Added

  • Expand the public API with project git import, project import status, usage notices, upgrade requests, chunk upload targets, data manifest access, run indexes, storage summaries, storage-category deletion, telemetry ingest, and web intake submission endpoints

v0.4.0

April 13, 2026

Runtime

Added

New plot types:

  • Add stem with GPU-accelerated rendering
  • Add errorbar visualization
  • Add area filled area plots
  • Add contour / contourf with GPU-resident path rendering
  • Add plot3 3D line plots
  • Add imagesc scaled image display
  • Add pie charts
  • Add histogram plotting
  • Add semilogx, semilogy, loglog log-scale axes
  • Add plot(y) shorthand — single-argument plot

Plotting infrastructure:

  • Add graphics handles and per-axes subplot state
  • Add axes helpers: xlim, ylim, zlim, caxis/clim
  • Add common signature forms: bar(x,y), surf(Z), mesh(Z), surfc(Z), meshc(Z), stairs(y)
  • Add get/set for plot handles with shared property access
  • Add annotation and legend builtins: title, xlabel, ylabel, zlabel, legend
  • Add 3D view controls: view(az, el)
  • Add world-space text annotations

Numerical computing:

  • Implement correct matrix division semantics — \, /, .\, ./ now have distinct, correct semantics through parser, HIR, bytecode, VM, and GPU paths. mldivide and mrdivide support triangular solves, dense square solves, tall least-squares, wide minimum-norm solves, transpose variants, and Cholesky-backed solves with GPU-resident F32 execution
  • Implement full FFT/IFFT family — fft, ifft, fft2, ifft2, fftn, ifftn now fully implemented with underlying RustFFT for CPU paths and high-performance staged GPU shaders supporting power-of-two, radix-3, radix-5, mixed compositions, and Bluestein fallback for non-smooth/prime lengths. Complex array indexing now works throughout (Y = fft(x); Y = Y(1:N/2))
  • Add signal processing helpers — hann, hamming, blackman windowing functions and nextpow2, all with GPU acceleration. Supports symmetric/periodic modes and output type selection

Other:

  • Add clear, clc, close all — session management commands now work in browser and native
  • Add datetime — MATLAB-compatible construction, formatting, string conversion, and subtraction
  • Add duration — display, arithmetic, and datetime interop
  • Add peaks builtin — GPU-accelerated with mixed-residency tensor support and type inference

Changed

  • Expand GPU fusion coverage — sign, fix, hypot, pow2, asinh, acosh, atanh, mod, rem now fuse into single GPU kernels automatically

Fixed

  • Fix struct field indexing — s.arr(k) and s.arr(1:n) now work with MATLAB-compatible semantics
  • Fix implicit struct creation — assigning to r.x = 10 on an uninitialized variable now materializes a struct
  • Fix fprintf compatibility for literal dollar signs and casted numeric inputs
  • Fix atan2 stack underflow that crashed scripts calling atan2 with compound expressions
  • Fix leading-dot floats — .5 parsed as 0.5
  • Fix GPU tensor to f64 conversion for iterative solve workflows
  • Fix range-indexing type errors
  • Fix GPU memory cleanup on QR and mrdivide errors
  • Fix matmul parameter caching
  • Fix histogram and bar charts not displaying
  • Fix right bar chart persisting after generating new charts
  • Fix contourf Z dimension mismatch
  • Fix area X/Y length mismatch
  • Fix image surface data handling
  • Fix stairs 1-argument form
  • Fix Z-axis label styling
  • Fix plot 3-argument overload
  • Fix stem shader offset when baseline is hidden

Sandbox

Added

  • Add notebook editor infrastructure — markdown cells alongside code cells (not yet user-facing)
  • Add RunMat Agent infrastructure — typed protocol, config, ops, and event model (not yet user-facing)

Fixed

  • Fix artifact loading to return newest entry when an ID is reused
  • Fix browser terminal clear/clc handling
  • Fix runtime state leaking between notebook run sessions

Changed

  • Improve path handling with safe segment escaping for dot components
  • Improve auth flow — email verification now redirects directly to the sandbox with an auth modal
  • Improve Auth0 email login flow
  • Improve stdout deduplication and clear event handling

App

Added

  • Add durable persistence and replay for run artifacts

v0.3.2

March 24, 2026

Deployment and infrastructure improvements for macOS, Windows, and Linux — no runtime or engine changes. Covers v0.3.1 through v0.3.2.

v0.3.0

March 24, 2026

Runtime

Added

  • WebAssembly (WASM) compile target — RunMat now runs entirely in the browser with WebGPU acceleration, published as the runmat npm package
  • Add fused GPU rendering pipeline for 2D and 3D plots with zero-copy surface data path
  • Add 3D depth camera with reversed-Z and dynamic clip planes
  • Add type inference — context-aware shape resolvers track tensor shapes through the compiler
  • Add builtins: int32, uint16, isgpuarray, magic, empty, frewind, rand(m,n,p), uint8 elementwise ops, isequal, logical, cellfun handle support, fullfile, erase, atanh, tempname
  • Add full call stack in error diagnostics with stack depth limit and source location tracking
  • Add MATLAB compatibility mode

Changed

  • Migrate the entire VM, all builtins, and the GPU provider to async
  • Change default error namespace to RunMat (from MATLAB)

Fixed

  • Fix slice indexing shape preservation, conv2 kernel flip, chol multi-output control flow, load auto-assignment, dlmread/csvread header parsing, cummax/cummin alignment, fgets character limit, native auto-init race condition, and GPU compute dispatch stack layout

Sandbox

Added

Fixed

  • Fix save file behavior
  • Fix figure state reset on re-run
  • Fix variable inspector pagination — large vectors now paginate correctly
  • Fix variable inspector caching — stale values no longer shown after re-runs
  • Fix data file viewer error handling

Changed

  • Show struct values before tensor values in the output panel
  • Improve variable inspector layout

App

Added

  • Add organizations, projects, and team memberships

v0.2.8

December 22, 2025

Added

  • Add complex number support — complex arithmetic works throughout the runtime
  • Add non-conjugate transpose (.') — apostrophe handling now distinguishes from conjugate transpose
  • Add Homebrew installation — brew install runmat (see CLI docs)

Changed

  • Replace manual REPL input with rustyline for line editing, command history, and formatting
  • Persist ans variable across expressions
  • Display struct content in the REPL
  • Improve multi-line formatting for ls and matrices
  • Suppress output for assignments ending in ;

Fixed

  • Fix save() stack overflow bug

v0.2.7

December 2, 2025

Added

  • Add anonymous telemetry to help improve RunMat. No code is ever captured — only internal error codes. See Telemetry for details

Fixed

  • Fix CLI version display

v0.2.6

November 21 – 24, 2025

Covers v0.2.0 through v0.2.6.

Added

Accelerate (GPU backend):

  • Add wgpu-based GPU backend — Metal (macOS), DirectX 12 (Windows), Vulkan (Linux)
  • Add cost model — runtime profiling routes work to CPU or GPU based on data size and transfer cost
  • Add f32/f64 compute shaders for a broad set of builtins — ones, zeros, rand, reductions, and many more now dispatch to the GPU automatically

Fusion engine:

  • Add computation graph pattern scanning — the runtime analyzes your code's computation graph, matches sequences against a library of fusible patterns, and replaces them with optimized GPU kernels automatically
  • Add 5–6 initial fusion operations including elementwise math chains, where multiple operations collapse into a single GPU kernel eliminating intermediate memory traffic

v0.0.3

August 25, 2025

Added

  • Add Jupyter kernel support — ZMQ transport so RunMat can serve as a Jupyter kernel
  • Add PowerShell installer for Windows

v0.0.2

August 19, 2025

Added

  • Implement interpretation for the core MATLAB language grammar and semantic surface, across the parser, HIR, and VM. See Language Coverage for the full matrix of implemented coverage

v0.0.1

August 10, 2025

Added

  • Initial release — lexer, architecture plan, project scaffolding
  • Add release workflow with macOS signing, cross-compilation, crates.io publishing