runmat 0.4.3 → 0.4.4-dev.0

package/dist/generated/builtins/eig.js

@@ -118,6 +118,22 @@ const builtinDoc = {
         {
             "question": "What happens if the eigenvector matrix is singular?",
             "answer": "When the right eigenvectors form a singular matrix, RunMat falls back to computing left eigenvectors from the conjugate-transposed problem. If that fails, requesting the third output raises an error, matching MATLAB’s failure behaviour."
+        },
+        {
+            "question": "What equation does `eig` solve?",
+            "answer": "For the standard form `[V, D] = eig(A)`, the outputs satisfy `A*V = V*D`, where the columns of `V` are right eigenvectors and `D` is a diagonal matrix of eigenvalues. The generalized form `A*V = B*V*D` (called as `eig(A, B)` in MATLAB) is recognised but not yet implemented in RunMat and raises a descriptive error."
+        },
+        {
+            "question": "How do I get just the eigenvalues versus eigenvalues and eigenvectors?",
+            "answer": "Call `d = eig(A)` with a single output to get a column vector of eigenvalues only. Use `[V, D] = eig(A)` to also get the eigenvectors, or `[V, D, W] = eig(A)` to additionally get the left eigenvectors in `W`."
+        },
+        {
+            "question": "Are the eigenvalues returned by `eig` sorted?",
+            "answer": "No. Unlike `svd`, which returns singular values in descending order, `eig` returns eigenvalues in whatever order the underlying decomposition produces. Sort them yourself when you need ordering, for example `[d, idx] = sort(diag(D)); D = diag(d); V = V(:, idx);`."
+        },
+        {
+            "question": "When should I use `eig` versus `eigs`?",
+            "answer": "Use `eig` for dense matrices when you want the full spectrum. Use `eigs` for sparse or very large matrices when you only need a few eigenvalues (for example the `k` largest or smallest), since it uses iterative Arnoldi/Lanczos methods instead of a full factorization."
         }
     ],
     "links": [
@@ -150,11 +166,37 @@ const builtinDoc = {
         "label": "crates/runmat-runtime/src/builtins/math/linalg/factor/eig.rs",
         "url": "crates/runmat-runtime/src/builtins/math/linalg/factor/eig.rs"
     },
+    "syntax": {
+        "example": {
+            "description": "Syntax",
+            "input": "d = eig(A)\n[V, D] = eig(A)\n[V, D, W] = eig(A)\nd = eig(A, B)\n[V, D] = eig(A, B)\neig(___, balanceOption)\neig(___, 'vector')\neig(___, 'matrix')"
+        },
+        "points": [
+            "`A` is a square matrix. Logical and integer inputs are promoted to double; complex inputs remain complex throughout the factorization.",
+            "`B` is an optional second square matrix that turns the call into the generalized problem `A*V = B*V*D`. RunMat recognises this syntax but does not yet implement it and raises a descriptive error.",
+            "`V` contains the right eigenvectors as columns; `D` is a diagonal matrix of eigenvalues satisfying `A*V = V*D`.",
+            "`W` (three-output form) holds the left eigenvectors as columns, satisfying `W' * A = D * W'`, and is scaled so that `W' * V = I`.",
+            "The trailing selector `'vector'` returns the eigenvalues as a column vector in the second output; `'matrix'` (the default) returns the diagonal-matrix form.",
+            "`balanceOption` is `'balance'` (default) or `'nobalance'`. The option is accepted for MATLAB compatibility; balancing is currently a no-op."
+        ]
+    },
     "gpu_behavior": [
         "The WGPU provider implements the reserved `eig` hook by downloading the input, running the same CPU decomposition used by the host path, and immediately re-uploading the double-precision eigenvalues, eigenvectors, and diagonal matrix. When the spectrum is real, the outputs therefore remain on the GPU without any user intervention.",
         "If any output requires complex storage or you pass `'nobalance'`, RunMat automatically falls back to the host implementation and returns CPU-resident arrays. The `'vector'` selector also triggers this transparent host fallback today. Reapply `gpuArray` if you want to continue on the device after such a fallback.",
         "Because `eig` is a residency sink, the fusion planner treats it as a barrier and does not attempt to fuse surrounding elementwise work."
     ],
+    "validation": {
+        "summary": "`eig` calls the production LAPACK routines `dgeev` and `zgeev` via the `lapack` Rust crate, which uses Apple Accelerate on macOS and OpenBLAS on Linux, the same libraries NumPy, SciPy, and MATLAB's own eigensolvers rely on. CPU correctness is exercised by the in-module tests linked below; GPU residency is validated at the host-fallback boundary described above rather than via a separate GPU eigensolver.",
+        "implementation": {
+            "label": "crates/runmat-runtime/src/builtins/math/linalg/factor/eig.rs",
+            "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/math/linalg/factor/eig.rs"
+        },
+        "parity_test": {
+            "label": "eig unit tests",
+            "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/math/linalg/factor/eig.rs"
+        },
+        "tolerance": "CPU-only validated; no dedicated GPU eigensolver"
+    },
     "key": "eig",
     "slug": "eig",
     "categoryPath": [

package/dist/generated/builtins/eig.js.map

@@ -1 +1 @@
-{"version":3,"file":"eig.js","sourceRoot":"","sources":["../../../src/generated/builtins/eig.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"eig.js","sourceRoot":"","sources":["../../../src/generated/builtins/eig.ts"],"names":[],"mappings":"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"}

package/dist/generated/builtins/errorbar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errorbar.d.ts","sourceRoot":"","sources":["../../../src/generated/builtins/errorbar.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,QAAA,MAAM,UAAU,EAAE,UA0FjB,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"errorbar.d.ts","sourceRoot":"","sources":["../../../src/generated/builtins/errorbar.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,QAAA,MAAM,UAAU,EAAE,UA8HjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/errorbar.js

@@ -11,6 +11,7 @@ const builtinDoc = {
         "matlab errorbar"
     ],
     "summary": "Plot data with symmetric or asymmetric error bars for uncertainty, intervals, and MATLAB `errorbar` workflows.",
+    "hero_image": "https://web.runmatstatic.com/builtin-image/runmat-matlab-plot-error-measurements-intervals.webp",
     "gpu_support": {
         "elementwise": false,
         "reduction": false,
@@ -52,6 +53,25 @@ const builtinDoc = {
         {
             "description": "Style an error-bar object and label it for the legend",
             "input": "x = 1:5;\ny = [1 2 1.5 3 2.5];\nh = errorbar(x, y, 0.2*ones(size(x)), 0.2*ones(size(x)));\nset(h, 'LineWidth', 2, 'DisplayName', 'measurement');\nlegend;"
+        },
+        {
+            "description": "Measurements with confidence intervals",
+            "input": "x = 1:8;\ny = [2.1 3.4 4.2 5.8 5.5 6.1 7.3 8.0];\nneg = [0.3 0.4 0.2 0.5 0.6 0.3 0.4 0.3];\npos = [0.4 0.3 0.3 0.6 0.5 0.4 0.5 0.4];\n\nerrorbar(x, y, neg, pos, 'o-', 'LineWidth', 1.5);\ntitle('Tensile Strength vs. Sample');\nxlabel('Sample #');\nylabel('Strength (MPa)');\ngrid on;",
+            "image_webp": "https://web.runmatstatic.com/builtin-image/runmat-matlab-plot-error-measurements-intervals.webp"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "How do I plot asymmetric error bars?",
+            "answer": "Pass separate lower and upper error vectors. For vertical-only asymmetric bars, use `errorbar(x, y, neg, pos)` where `neg` is the downward extent and `pos` is the upward extent.\n\n```matlab\nx = 1:5;\ny = [2 3 2.5 4 3.5];\nneg = [0.1 0.2 0.15 0.3 0.1];\npos = [0.3 0.4 0.2 0.5 0.25];\nerrorbar(x, y, neg, pos);\n```"
+        },
+        {
+            "question": "Can I add horizontal error bars?",
+            "answer": "Yes. Use the six-argument form `errorbar(x, y, yneg, ypos, xneg, xpos)` to get both vertical and horizontal bars. If you only want horizontal bars, set the vertical error vectors to zero.\n\n```matlab\nx = 1:4; y = [3 4 2 5];\nerrorbar(x, y, zeros(size(x)), zeros(size(x)), 0.2*ones(size(x)), 0.3*ones(size(x)));\n```"
+        },
+        {
+            "question": "Can I combine error bars with a line or scatter plot?",
+            "answer": "Yes—`errorbar` already draws a line through the data points by default. To overlay error bars on a separate plot, call `hold on` first. The error bar handle supports the same `set` properties as line handles, so you can match colors and widths.\n\n```matlab\nplot(x, y, 'b-', 'LineWidth', 2);\nhold on;\nerrorbar(x, y, err, err, 'LineStyle', 'none', 'Color', 'b');\n```"
         }
     ],
     "links": [
@@ -74,6 +94,22 @@ const builtinDoc = {
         {
             "label": "set",
             "url": "./set"
+        },
+        {
+            "label": "Choosing the right plot type",
+            "url": "/docs/plotting/choosing-the-right-plot-type"
+        },
+        {
+            "label": "Styling plots and axes",
+            "url": "/docs/plotting/styling-plots-and-axes"
+        },
+        {
+            "label": "Plot replay and export",
+            "url": "/docs/plotting/plot-replay-and-export"
+        },
+        {
+            "label": "Complete plotting guide",
+            "url": "/blog/matlab-plotting-guide"
         }
     ],
     "source": {

package/dist/generated/builtins/errorbar.js.map

@@ -1 +1 @@
-{"version":3,"file":"errorbar.js","sourceRoot":"","sources":["../../../src/generated/builtins/errorbar.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,UAAU;IACnB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,UAAU;QACV,YAAY;QACZ,kBAAkB;QAClB,0BAA0B;QAC1B,iBAAiB;KAClB;IACD,SAAS,EAAE,gHAAgH;IAC3H,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,QAAQ;YACR,QAAQ;SACT;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,8IAA8I;KACxJ;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;KACtB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,qCAAqC;QAC7C,aAAa,EAAE,qCAAqC;KACrD;IACD,aAAa,EAAE,2SAA2S;IAC1T,WAAW,EAAE;QACX,6GAA6G;QAC7G,mGAAmG;QACnG,kIAAkI;QAClI,sFAAsF;QACtF,2LAA2L;KAC5L;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,oCAAoC;YACnD,OAAO,EAAE,yFAAyF;SACnG;QACD;YACE,aAAa,EAAE,2CAA2C;YAC1D,OAAO,EAAE,+JAA+J;SACzK;QACD;YACE,aAAa,EAAE,uDAAuD;YACtE,OAAO,EAAE,2JAA2J;SACrK;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,+DAA+D;QACxE,KAAK,EAAE,4GAA4G;KACpH;IACD,eAAe,EAAE,2KAA2K;IAC5L,cAAc,EAAE;QACd,qGAAqG;QACrG,6HAA6H;KAC9H;IACD,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"errorbar.js","sourceRoot":"","sources":["../../../src/generated/builtins/errorbar.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,UAAU;IACnB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,UAAU;QACV,YAAY;QACZ,kBAAkB;QAClB,0BAA0B;QAC1B,iBAAiB;KAClB;IACD,SAAS,EAAE,gHAAgH;IAC3H,YAAY,EAAE,iGAAiG;IAC/G,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,QAAQ;YACR,QAAQ;SACT;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,8IAA8I;KACxJ;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;KACtB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,qCAAqC;QAC7C,aAAa,EAAE,qCAAqC;KACrD;IACD,aAAa,EAAE,2SAA2S;IAC1T,WAAW,EAAE;QACX,6GAA6G;QAC7G,mGAAmG;QACnG,kIAAkI;QAClI,sFAAsF;QACtF,2LAA2L;KAC5L;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,oCAAoC;YACnD,OAAO,EAAE,yFAAyF;SACnG;QACD;YACE,aAAa,EAAE,2CAA2C;YAC1D,OAAO,EAAE,+JAA+J;SACzK;QACD;YACE,aAAa,EAAE,uDAAuD;YACtE,OAAO,EAAE,2JAA2J;SACrK;QACD;YACE,aAAa,EAAE,wCAAwC;YACvD,OAAO,EAAE,4RAA4R;YACrS,YAAY,EAAE,iGAAiG;SAChH;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,sCAAsC;YAClD,QAAQ,EAAE,8TAA8T;SACzU;QACD;YACE,UAAU,EAAE,kCAAkC;YAC9C,QAAQ,EAAE,+TAA+T;SAC1U;QACD;YACE,UAAU,EAAE,uDAAuD;YACnE,QAAQ,EAAE,mXAAmX;SAC9X;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,8BAA8B;YACvC,KAAK,EAAE,6CAA6C;SACrD;QACD;YACE,OAAO,EAAE,wBAAwB;YACjC,KAAK,EAAE,uCAAuC;SAC/C;QACD;YACE,OAAO,EAAE,wBAAwB;YACjC,KAAK,EAAE,uCAAuC;SAC/C;QACD;YACE,OAAO,EAAE,yBAAyB;YAClC,KAAK,EAAE,6BAA6B;SACrC;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,+DAA+D;QACxE,KAAK,EAAE,4GAA4G;KACpH;IACD,eAAe,EAAE,2KAA2K;IAC5L,cAAc,EAAE;QACd,qGAAqG;QACrG,6HAA6H;KAC9H;IACD,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/exist.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exist.d.ts","sourceRoot":"","sources":["../../../src/generated/builtins/exist.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,QAAA,MAAM,UAAU,EAAE,UAgNjB,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"exist.d.ts","sourceRoot":"","sources":["../../../src/generated/builtins/exist.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,QAAA,MAAM,UAAU,EAAE,UAwOjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/exist.js

@@ -32,7 +32,7 @@ const builtinDoc = {
         "unit": "builtins::io::repl_fs::exist::tests",
         "integration": "builtins::io::repl_fs::exist::tests::exist_detects_workspace_variables"
     },
-    "description": "`exist(name)` returns an integer code that identifies which kind of item named `name` is currently available. The codes match MATLAB:\n\n| Code | Meaning                                   | | ---- | ----------------------------------------- | | 0    | Item not found                            | | 1    | Variable in the active workspace          | | 2    | File (including scripts and most data files) | | 3    | MEX-file                                  | | 4    | Simulink® model (`.slx` / `.mdl`)         | | 5    | Built-in MATLAB function                  | | 6    | P-code (`.p` / `.pp`)                     | | 7    | Folder                                    | | 8    | Class definition                          |\n\nPass a second argument to restrict the lookup (for example, `'file'`, `'dir'`, `'builtin'`, `'class'`, `'mex'`, `'pcode'`, `'method'`, or `'handle'`). The builtin mirrors MATLAB semantics for string handling, search order, and numeric return values.",
+    "description": "`exist(name)` returns an integer code that identifies which kind of item named `name` is currently available. The codes match MATLAB:\n\n| Code | Meaning |\n| ---- | ------- |\n| 0    | Item not found |\n| 1    | Variable in the active workspace |\n| 2    | File (including scripts and most data files) |\n| 3    | MEX-file |\n| 4    | Simulink® model (`.slx` / `.mdl`) |\n| 5    | Built-in MATLAB function |\n| 6    | P-code (`.p` / `.pp`) |\n| 7    | Folder |\n| 8    | Class definition |\n\nPass a second argument to restrict the lookup (for example, `'file'`, `'dir'`, `'builtin'`, `'class'`, `'mex'`, `'pcode'`, `'method'`, or `'handle'`). The builtin mirrors MATLAB semantics for string handling, search order, and numeric return values.",
     "behaviors": [
         "Searches follow MATLAB's precedence: variables first, then built-ins, classes, compiled code (MEX/P-code), standard files, and finally folders.",
         "When you omit the type, `exist` returns the first match respecting this precedence.",
@@ -114,6 +114,18 @@ const builtinDoc = {
         {
             "question": "What are the return codes for exist in MATLAB?",
             "answer": "`exist` returns `0` (not found), `1` (variable in workspace), `2` (file on path), `3` (MEX file), `4` (Simulink model), `5` (built-in function), `7` (folder), or `8` (Java class). RunMat supports codes 0, 1, 2, 5, and 7."
+        },
+        {
+            "question": "What does each `exist` return value mean?",
+            "answer": "— The complete MATLAB table is:\n\n| Code | Meaning |\n|------|---------|\n| `0` | Not found |\n| `1` | Variable in the active workspace |\n| `2` | File (including `.m` scripts, `.mat`, and most data files on the path) |\n| `3` | MEX-file (compiled C/C++/Fortran) |\n| `4` | Simulink model (`.slx` / `.mdl`) |\n| `5` | Built-in function |\n| `6` | P-code file (`.p`) |\n| `7` | Folder |\n| `8` | Class (classdef or `@Class` folder) |\n\nUse the two-argument form (`exist(name, 'file')`, `exist(name, 'dir')`, `exist(name, 'builtin')`, `exist(name, 'class')`) when you want to restrict the search to a single kind."
+        },
+        {
+            "question": "How do I check if a variable or file exists before using it?",
+            "answer": "— Use the two-argument form so the result is unambiguous:\n\n```matlab\nif exist('myVar', 'var')\n    disp(myVar);\nend\n\nif exist('data.mat', 'file')\n    load('data.mat');\nend\n```\n\nFor files specifically, `isfile('data.mat')` and `isfolder('outdir')` return plain logicals and are often clearer than `exist` alone."
+        },
+        {
+            "question": "How do I create a folder only if it doesn't already exist?",
+            "answer": "— Combine `exist` with `mkdir`:\n\n```matlab\nif ~exist('outdir', 'dir')\n    mkdir('outdir');\nend\n```\n\nA newer, equally idiomatic alternative is `if ~isfolder('outdir'), mkdir('outdir'); end`. `mkdir` itself is a no-op when the folder already exists (it just prints a warning), so either pattern is safe."
         }
     ],
     "links": [
@@ -202,6 +214,18 @@ const builtinDoc = {
     "gpu_behavior": [
         "The builtin runs entirely on the host CPU. If any argument lives on the GPU, RunMat gathers it to host memory before performing the lookup. Providers do not implement dedicated hooks for `exist`, and the result is always returned as a host-resident double scalar. Documented behaviour is identical regardless of whether acceleration is enabled."
     ],
+    "syntax": {
+        "example": {
+            "description": "Syntax",
+            "input": "tf = exist(name)\ntf = exist(name, kind)"
+        },
+        "points": [
+            "`name` is a character vector or string scalar identifying what to look up. It may be a simple name (`\"alpha\"`, `\"sin\"`), a file path (`\"utilities/process_data\"`), or a package-qualified identifier (`\"pkg.Widget\"`).",
+            "`kind` is an optional character vector or string scalar that restricts the search to a single category. Accepted values are `'var'`, `'file'`, `'dir'`, `'builtin'`, and `'class'` (plus the RunMat extensions `'mex'`, `'pcode'`, `'method'`, and `'handle'`).",
+            "Returns `tf`, an integer code between `0` and `8`: `0` (not found), `1` (variable), `2` (file), `3` (MEX file), `4` (Simulink model), `5` (built-in), `6` (P-code), `7` (folder), `8` (class).",
+            "When `kind` is omitted, MATLAB precedence applies (variables first, then built-ins, classes, compiled code, files, and folders)."
+        ]
+    },
     "key": "exist",
     "slug": "exist",
     "categoryPath": [

package/dist/generated/builtins/exist.js.map

@@ -1 +1 @@
-{"version":3,"file":"exist.js","sourceRoot":"","sources":["../../../src/generated/builtins/exist.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"exist.js","sourceRoot":"","sources":["../../../src/generated/builtins/exist.ts"],"names":[],"mappings":"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"}

package/dist/generated/builtins/fgets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fgets.d.ts","sourceRoot":"","sources":["../../../src/generated/builtins/fgets.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,QAAA,MAAM,UAAU,EAAE,UAuJjB,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"fgets.d.ts","sourceRoot":"","sources":["../../../src/generated/builtins/fgets.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,QAAA,MAAM,UAAU,EAAE,UA+KjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/fgets.js

@@ -98,6 +98,18 @@ const builtinDoc = {
         {
             "question": "Can I call `fgets` on files opened for writing only?",
             "answer": "No. The file must be opened with read permission (for example `'r'`, `'r+'`, or `'w+'`). Calling `fgets` on a write-only identifier raises an error."
+        },
+        {
+            "question": "Can `fgets` read from standard input with `fgets(0)`?",
+            "answer": "No. MATLAB disallows `fgets(0)` for the interactive stdin stream and RunMat follows the same convention. Use `input('prompt: ', 's')` for interactive prompts, or read a real file identifier returned by `fopen`."
+        },
+        {
+            "question": "How do I read a whole file line-by-line with `fgets`?",
+            "answer": "Open the file, loop while the return value is not `-1`, and close the handle when you are done. Pair the call with `feof` or compare against `-1` directly:\n\n```matlab\nfid = fopen('data.txt', 'r');\nwhile ~feof(fid)\n    line = fgets(fid);\n    if line == -1, break; end\n    fprintf('%s', line);\nend\nfclose(fid);\n```"
+        },
+        {
+            "question": "How do I reliably detect end-of-file with `fgets`?",
+            "answer": "Compare the return value to `-1` (`if line == -1`) or query `feof(fid)` before the next read. Do not use `ischar(line)`, because MATLAB's implicit numeric-to-char rules can report `true` for the sentinel value on some inputs."
         }
     ],
     "links": [
@@ -142,6 +154,18 @@ const builtinDoc = {
         "label": "crates/runmat-runtime/src/builtins/io/filetext/fgets.rs",
         "url": "crates/runmat-runtime/src/builtins/io/filetext/fgets.rs"
     },
+    "syntax": {
+        "example": {
+            "description": "Syntax",
+            "input": "line = fgets(fileID)\nline = fgets(fileID, nchar)\n[line, ltout] = fgets(___)"
+        },
+        "points": [
+            "`fileID` is a file handle returned by `fopen`. The file must be opened with read permission (`'r'`, `'r+'`, `'w+'`, or `'a+'`).",
+            "`nchar` is an optional positive integer that caps the read at `nchar - 1` characters. The call still stops early when a newline is encountered first.",
+            "`line` is a character row vector **including** any trailing newline (`\\n` or `\\r\\n`). When the file position is already at end-of-file, `fgets` returns the numeric sentinel `-1`.",
+            "The optional second output `ltout` reports the line terminator as a row of numeric codes (`10` for `\\n`, `[13 10]` for `\\r\\n`, `[]` when the line has no terminator, and `-1` at end-of-file)."
+        ]
+    },
     "gpu_behavior": [
         "`fgets` is a host-only operation. File identifiers live in the host registry created by `fopen`, so arguments that arrive as GPU-resident scalars are gathered back to the CPU before the read occurs. The returned line and optional terminator vector are regular host values; no GPU residency is tracked."
     ],

package/dist/generated/builtins/fgets.js.map

@@ -1 +1 @@
-{"version":3,"file":"fgets.js","sourceRoot":"","sources":["../../../src/generated/builtins/fgets.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fgets.js","sourceRoot":"","sources":["../../../src/generated/builtins/fgets.ts"],"names":[],"mappings":"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"}

package/dist/generated/builtins/flipud.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flipud.d.ts","sourceRoot":"","sources":["../../../src/generated/builtins/flipud.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,QAAA,MAAM,UAAU,EAAE,UAiMjB,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"flipud.d.ts","sourceRoot":"","sources":["../../../src/generated/builtins/flipud.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,QAAA,MAAM,UAAU,EAAE,UAwNjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/flipud.js

@@ -103,6 +103,18 @@ const builtinDoc = {
         {
             "question": "Is `flipud` numerically stable?",
             "answer": "Yes. The function only reorders elements; values are never modified, so it is numerically stable."
+        },
+        {
+            "question": "What does `flipud` do in MATLAB?",
+            "answer": "— `B = flipud(A)` returns `A` with the order of its rows reversed, so `B(i, :) = A(end - i + 1, :)`. The number of columns and every higher-dimension page stays exactly the same."
+        },
+        {
+            "question": "What's the difference between `flipud`, `fliplr`, and `flip`?",
+            "answer": "— `flipud` reverses dimension 1 (rows), `fliplr` reverses dimension 2 (columns), and `flip(A, dim)` reverses any dimension you pick. Modern MATLAB code tends to use `flip(A, dim)` directly; `flipud` and `fliplr` are convenience wrappers kept for readability."
+        },
+        {
+            "question": "How do I reverse a column vector?",
+            "answer": "— For a column vector, `flipud(v)` returns the reversed vector. A dimension-agnostic idiom that works for row or column vectors is `v(end:-1:1)`."
         }
     ],
     "links": [
@@ -187,6 +199,17 @@ const builtinDoc = {
     "gpu_behavior": [
         "RunMat first tries to execute `flipud` on the GPU by delegating to the provider’s generic `flip` implementation with axis `0` (zero-based). If the provider does not implement this hook, RunMat transparently gathers the tensor, performs the vertical flip on the host, and uploads the result back to the device so residency is preserved."
     ],
+    "syntax": {
+        "example": {
+            "description": "Syntax",
+            "input": "B = flipud(A)"
+        },
+        "points": [
+            "`A` is a scalar, vector, matrix, or N-D array. It may hold any MATLAB class: numeric, logical, complex, character, string, or cell. `gpuArray` inputs are supported and stay device-resident when the provider offers a `flip` hook.",
+            "`B` is the same size and class as `A` with its first dimension reversed: `B(i, :, ...) = A(end - i + 1, :, ...)`. All other dimensions are preserved. For arrays with more than two dimensions, higher pages are treated independently.",
+            "`flipud(A)` is equivalent to `flip(A, 1)`. Use `fliplr(A)` to reverse columns instead, or `flip(A, dim)` when you need a dimension other than 1 or 2."
+        ]
+    },
     "key": "flipud",
     "slug": "flipud",
     "categoryPath": [

package/dist/generated/builtins/flipud.js.map

@@ -1 +1 @@
-{"version":3,"file":"flipud.js","sourceRoot":"","sources":["../../../src/generated/builtins/flipud.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"flipud.js","sourceRoot":"","sources":["../../../src/generated/builtins/flipud.ts"],"names":[],"mappings":"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"}

package/dist/generated/builtins/fopen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fopen.d.ts","sourceRoot":"","sources":["../../../src/generated/builtins/fopen.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,QAAA,MAAM,UAAU,EAAE,UA2KjB,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"fopen.d.ts","sourceRoot":"","sources":["../../../src/generated/builtins/fopen.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,QAAA,MAAM,UAAU,EAAE,UAqMjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/fopen.js

@@ -118,6 +118,18 @@ const builtinDoc = {
         {
             "question": "What file modes does fopen support?",
             "answer": "`fopen` supports `'r'` (read), `'w'` (write, creates or overwrites), `'a'` (append), `'r+'` (read and write), `'w+'` (read and write, truncates), and `'a+'` (read and append)."
+        },
+        {
+            "question": "How do I read a file with a specific encoding?",
+            "answer": "Pass the encoding as the fourth argument after the machine-format placeholder, for example `fid = fopen('data.txt', 'r', 'n', 'UTF-8')`. RunMat accepts `'UTF-8'`, `'US-ASCII'`, `'ISO-8859-1'` (alias `'latin1'`), `'windows-1252'`, `'shift_jis'`, and `'system'`."
+        },
+        {
+            "question": "Do I need to `fclose` every file I open?",
+            "answer": "Yes. Every successful `fopen` registers a handle that holds OS resources until you call `fclose(fid)`. For robust code, tie the close to an `onCleanup` object so the file is released even if your code errors partway through:\n\n```matlab\nfid = fopen('data.txt', 'r');\ncleanup = onCleanup(@() fclose(fid));\n% ... use fid freely ...\n```"
+        },
+        {
+            "question": "Should I always check the return value of `fopen`?",
+            "answer": "Yes. Request two outputs so you can surface a useful error message: `[fid, errmsg] = fopen(filename, 'r'); if fid == -1, error(errmsg); end`. Without this guard, subsequent calls like `fread(fid)` fail with a generic invalid-identifier error that hides the real cause."
         }
     ],
     "links": [
@@ -162,6 +174,20 @@ const builtinDoc = {
         "label": "crates/runmat-runtime/src/builtins/io/filetext/fopen.rs",
         "url": "crates/runmat-runtime/src/builtins/io/filetext/fopen.rs"
     },
+    "syntax": {
+        "example": {
+            "description": "Syntax",
+            "input": "fileID = fopen(filename)\nfileID = fopen(filename, permission)\nfileID = fopen(filename, permission, machinefmt)\nfileID = fopen(filename, permission, machinefmt, encodingIn)\n[fileID, errmsg] = fopen(___)\nfilename = fopen(fileID)\n[filename, permission, machinefmt, encodingOut] = fopen(fileID)\nfIDs = fopen('all')"
+        },
+        "points": [
+            "`filename` is a character vector or string scalar naming the file. Relative paths are resolved against the current working directory.",
+            "`permission` is one of `'r'`, `'w'`, `'a'`, `'r+'`, `'w+'`, `'a+'`, or `'A'`, optionally suffixed with `'t'` (text mode) or `'b'` (binary mode).",
+            "`machinefmt` selects the endianness for binary reads and writes. Common values are `'native'` (alias `'n'`), `'ieee-le'` (little-endian), and `'ieee-be'` (big-endian).",
+            "`encodingIn` is the text encoding used for subsequent reads and writes. Accepted values include `'UTF-8'` (default for text mode), `'US-ASCII'`, `'ISO-8859-1'` (`'latin1'`), `'windows-1252'`, `'shift_jis'`, and `'system'`.",
+            "On success `fileID` is a positive integer. On failure it is `-1`, and the optional second output `errmsg` contains the operating-system error message.",
+            "Passing an existing `fileID` returns its recorded metadata; `fopen('all')` returns a row vector of every currently open user file identifier."
+        ]
+    },
     "gpu_behavior": [
         "`fopen` always executes on the CPU. When a filename argument resides on a GPU array, RunMat gathers it to host memory before opening the file. File identifiers and their associated metadata are managed by a host-side registry that other builtins (such as `fclose`, `fread`, and `fwrite`) consult."
     ],

package/dist/generated/builtins/fopen.js.map

@@ -1 +1 @@
-{"version":3,"file":"fopen.js","sourceRoot":"","sources":["../../../src/generated/builtins/fopen.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fopen.js","sourceRoot":"","sources":["../../../src/generated/builtins/fopen.ts"],"names":[],"mappings":"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"}

package/dist/generated/builtins/get.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../../src/generated/builtins/get.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,QAAA,MAAM,UAAU,EAAE,UAiEjB,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../../src/generated/builtins/get.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,QAAA,MAAM,UAAU,EAAE,UA+FjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/get.js

@@ -38,6 +38,20 @@ const builtinDoc = {
             "input": "plot(1:5, 1:5);\nlg = legend('series');\nget(lg, 'Orientation')"
         }
     ],
+    "faqs": [
+        {
+            "question": "How do I see all available properties on a handle?",
+            "answer": "Call `get(h)` with no property name. It returns a struct containing every known property for that handle type. This is the fastest way to discover what's queryable on a line, axes, legend, or text object."
+        },
+        {
+            "question": "Can I query properties on axes handles, not just plot objects?",
+            "answer": "Yes. `get(gca, 'XScale')` reads the x-axis scale mode, `get(gca, 'View')` reads the camera angle, and so on. Axes handles, legend handles, text handles, and plot-child handles all go through the same `get` interface."
+        },
+        {
+            "question": "What happens if I query a property that doesn't exist?",
+            "answer": "RunMat raises a plotting error rather than returning empty or silently succeeding. If you're unsure whether a property exists, call `get(h)` first to inspect the full property struct."
+        }
+    ],
     "links": [
         {
             "label": "set",
@@ -54,6 +68,22 @@ const builtinDoc = {
         {
             "label": "plot",
             "url": "./plot"
+        },
+        {
+            "label": "Choosing the right plot type",
+            "url": "/docs/plotting/choosing-the-right-plot-type"
+        },
+        {
+            "label": "Styling plots and axes",
+            "url": "/docs/plotting/styling-plots-and-axes"
+        },
+        {
+            "label": "Plot replay and export",
+            "url": "/docs/plotting/plot-replay-and-export"
+        },
+        {
+            "label": "Complete plotting guide",
+            "url": "/blog/matlab-plotting-guide"
         }
     ],
     "source": {

package/dist/generated/builtins/get.js.map

@@ -1 +1 @@
-{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../src/generated/builtins/get.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,KAAK;IACd,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,KAAK;QACL,iBAAiB;QACjB,iBAAiB;QACjB,YAAY;QACZ,wBAAwB;KACzB;IACD,SAAS,EAAE,sHAAsH;IACjI,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,gCAAgC;KACzC;IACD,aAAa,EAAE,wVAAwV;IACvW,WAAW,EAAE;QACX,mEAAmE;QACnE,2DAA2D;QAC3D,2IAA2I;QAC3I,qHAAqH;QACrH,4IAA4I;KAC7I;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,oDAAoD;YACnE,OAAO,EAAE,8CAA8C;SACxD;QACD;YACE,aAAa,EAAE,6BAA6B;YAC5C,OAAO,EAAE,8FAA8F;YACvG,QAAQ,EAAE,kBAAkB;SAC7B;QACD;YACE,aAAa,EAAE,wCAAwC;YACvD,OAAO,EAAE,iEAAiE;SAC3E;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,0DAA0D;QACnE,KAAK,EAAE,uGAAuG;KAC/G;IACD,KAAK,EAAE,KAAK;IACZ,MAAM,EAAE,KAAK;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../src/generated/builtins/get.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,KAAK;IACd,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,KAAK;QACL,iBAAiB;QACjB,iBAAiB;QACjB,YAAY;QACZ,wBAAwB;KACzB;IACD,SAAS,EAAE,sHAAsH;IACjI,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,gCAAgC;KACzC;IACD,aAAa,EAAE,wVAAwV;IACvW,WAAW,EAAE;QACX,mEAAmE;QACnE,2DAA2D;QAC3D,2IAA2I;QAC3I,qHAAqH;QACrH,4IAA4I;KAC7I;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,oDAAoD;YACnE,OAAO,EAAE,8CAA8C;SACxD;QACD;YACE,aAAa,EAAE,6BAA6B;YAC5C,OAAO,EAAE,8FAA8F;YACvG,QAAQ,EAAE,kBAAkB;SAC7B;QACD;YACE,aAAa,EAAE,wCAAwC;YACvD,OAAO,EAAE,iEAAiE;SAC3E;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,oDAAoD;YAChE,QAAQ,EAAE,8MAA8M;SACzN;QACD;YACE,UAAU,EAAE,gEAAgE;YAC5E,QAAQ,EAAE,0NAA0N;SACrO;QACD;YACE,UAAU,EAAE,wDAAwD;YACpE,QAAQ,EAAE,yLAAyL;SACpM;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,8BAA8B;YACvC,KAAK,EAAE,6CAA6C;SACrD;QACD;YACE,OAAO,EAAE,wBAAwB;YACjC,KAAK,EAAE,uCAAuC;SAC/C;QACD;YACE,OAAO,EAAE,wBAAwB;YACjC,KAAK,EAAE,uCAAuC;SAC/C;QACD;YACE,OAAO,EAAE,yBAAyB;YAClC,KAAK,EAAE,6BAA6B;SACrC;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,0DAA0D;QACnE,KAAK,EAAE,uGAAuG;KAC/G;IACD,KAAK,EAAE,KAAK;IACZ,MAAM,EAAE,KAAK;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/getfield.js

@@ -28,7 +28,7 @@ const builtinDoc = {
     "requires_feature": null,
     "tested": {
         "unit": "builtins::structs::core::getfield::tests",
-        "integration": "runmat_ignition::tests::functions::member_get_set_and_method_call_skeleton"
+        "integration": "runmat-vm/tests/functions.rs::member_get_set_and_method_call_skeleton"
     },
     "description": "`value = getfield(S, field)` returns the contents of `S.field`. RunMat matches MATLAB by supporting nested field access, struct arrays (via index cells), and MATLAB-style objects created with `new_object`.",
     "behaviors": [

package/dist/generated/builtins/getfield.js.map

@@ -1 +1 @@
-{"version":3,"file":"getfield.js","sourceRoot":"","sources":["../../../src/generated/builtins/getfield.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"getfield.js","sourceRoot":"","sources":["../../../src/generated/builtins/getfield.ts"],"names":[],"mappings":"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"}

package/dist/generated/builtins/gradient.d.ts

@@ -0,0 +1,4 @@
+import type { BuiltinDoc } from "../../builtins.js";
+declare const builtinDoc: BuiltinDoc;
+export default builtinDoc;
+//# sourceMappingURL=gradient.d.ts.map

package/dist/generated/builtins/gradient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gradient.d.ts","sourceRoot":"","sources":["../../../src/generated/builtins/gradient.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,QAAA,MAAM,UAAU,EAAE,UA4HjB,CAAC;AAEF,eAAe,UAAU,CAAC"}