runmat 0.4.3 → 0.4.4

package/dist/generated/builtins/gradient.js

@@ -0,0 +1,129 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "gradient",
+    "category": "math/reduction",
+    "keywords": [
+        "gradient",
+        "numerical gradient",
+        "finite difference",
+        "derivative",
+        "gpu"
+    ],
+    "summary": "Numerical gradients using central differences with MATLAB-compatible output ordering.",
+    "references": [],
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f32",
+            "f64"
+        ],
+        "broadcasting": "matlab",
+        "notes": "Scalar-spacing gradients call the provider's `gradient_dim` hook and can stay GPU-resident. Coordinate-vector spacing falls back to the host in this implementation."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 1,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::math::reduction::gradient::tests",
+        "integration": "builtins::math::reduction::gradient::tests::gradient_gpu_scalar_spacing_matches_cpu_and_stays_resident"
+    },
+    "description": "`gradient(F)` computes numerical derivatives with central differences in the interior and one-sided differences at the boundaries. For matrices, a single output returns the derivative along columns, while multiple outputs follow MATLAB ordering: first columns, then rows, then higher dimensions.",
+    "behaviors": [
+        "`gradient(F)` chooses the first non-singleton dimension for vectors and returns the column-direction derivative for matrices.",
+        "`[FX, FY] = gradient(F)` on a matrix returns `FX` for dimension 2 (across columns) and `FY` for dimension 1 (down rows), matching MATLAB.",
+        "`gradient(F, h)` applies the same scalar spacing to every returned dimension.",
+        "`gradient(F, hx, hy, ...)` accepts one scalar spacing per output dimension. In v1, each spacing must be scalar.",
+        "Interior points use central differences `(f(i+1) - f(i-1)) / (2*h)`, while the first and last points use one-sided differences.",
+        "Real, logical, and scalar numeric inputs promote through the standard tensor conversion path. Complex host inputs are supported by differentiating the real and imaginary parts independently.",
+        "When a GPU tensor is passed and the active provider implements `gradient_dim`, scalar-spacing gradients stay resident on the device. Complex GPU tensors and coordinate-vector spacing currently gather to the host."
+    ],
+    "examples": [
+        {
+            "description": "Differentiating a row vector",
+            "input": "v = [1 4 9];\ng = gradient(v)",
+            "output": "g = [3 4 5]"
+        },
+        {
+            "description": "Requesting both matrix gradient components",
+            "input": "A = [1 2; 3 4];\n[FX, FY] = gradient(A)",
+            "output": "FX =\n     1     1\n     1     1\n\nFY =\n     2     2\n     2     2"
+        },
+        {
+            "description": "Using scalar spacing on GPU data",
+            "input": "G = gpuArray(single([1 4 9]));\nD = gradient(G, 2);\nout = gather(D)",
+            "output": "out = single([1.5 2.0 2.5])"
+        },
+        {
+            "description": "Feeding `gradient` into a vector-field plot",
+            "input": "[X, Y] = meshgrid(linspace(-2, 2, 25), linspace(-2, 2, 25));\nZ = X .* exp(-X.^2 - Y.^2);\n[DX, DY] = gradient(Z, X(1,2)-X(1,1), Y(2,1)-Y(1,1));\nquiver(X, Y, DX, DY)"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "What finite-difference stencil does `gradient` use?",
+            "answer": "RunMat matches MATLAB's shape-preserving behavior: central differences in the interior and first-order one-sided differences at the boundaries."
+        },
+        {
+            "question": "Why does a matrix return the x-direction first?",
+            "answer": "MATLAB defines the first matrix output along dimension 2 (columns), then dimension 1 (rows). RunMat preserves that ordering so plotting workflows like `quiver` line up correctly."
+        },
+        {
+            "question": "Can I pass coordinate vectors for spacing?",
+            "answer": "Not in this version. `gradient(F, X)` and vector-valued `hx`, `hy`, ... are reserved for a follow-up implementation."
+        },
+        {
+            "question": "Does `gradient` support GPU arrays?",
+            "answer": "Yes for default spacing and scalar spacings. With an active provider such as WGPU, the scalar-spacing path stays on the GPU via the `gradient_dim` hook."
+        },
+        {
+            "question": "Do complex inputs work?",
+            "answer": "Yes on the host. Complex GPU tensors currently gather to the host before differencing."
+        }
+    ],
+    "links": [
+        {
+            "label": "diff",
+            "url": "./diff"
+        },
+        {
+            "label": "meshgrid",
+            "url": "./meshgrid"
+        },
+        {
+            "label": "quiver",
+            "url": "./quiver"
+        },
+        {
+            "label": "gpuArray",
+            "url": "./gpuarray"
+        },
+        {
+            "label": "gather",
+            "url": "./gather"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/math/reduction/gradient.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/math/reduction/gradient.rs"
+    },
+    "gpu_residency": "Manual `gpuArray` promotion is optional. When a scalar-spacing gradient starts with GPU-resident data and the active provider implements `gradient_dim`, RunMat keeps the result on the device. If the provider lacks the hook, if spacing is specified with coordinate vectors, or if the input is complex GPU data, RunMat gathers to the host and preserves MATLAB-compatible results.",
+    "gpu_behavior": [
+        "The WGPU backend implements `gradient_dim`, so scalar-spacing gradients execute on the device and return GPU tensors for both single-output and multi-output calls.",
+        "The simple in-process provider also exposes `gradient_dim`, allowing provider-level parity tests without requiring a physical GPU.",
+        "Coordinate-vector spacing is intentionally out of scope for this version and falls back to host evaluation."
+    ],
+    "key": "gradient",
+    "slug": "gradient",
+    "categoryPath": [
+        "math",
+        "reduction"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=gradient.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gradient.js","sourceRoot":"","sources":["../../../src/generated/builtins/gradient.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,UAAU;IACnB,UAAU,EAAE,gBAAgB;IAC5B,UAAU,EAAE;QACV,UAAU;QACV,oBAAoB;QACpB,mBAAmB;QACnB,YAAY;QACZ,KAAK;KACN;IACD,SAAS,EAAE,uFAAuF;IAClG,YAAY,EAAE,EAAE;IAChB,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;YACL,KAAK;SACN;QACD,cAAc,EAAE,QAAQ;QACxB,OAAO,EAAE,sKAAsK;KAChL;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,4CAA4C;QACpD,aAAa,EAAE,wGAAwG;KACxH;IACD,aAAa,EAAE,ySAAyS;IACxT,WAAW,EAAE;QACX,+HAA+H;QAC/H,2IAA2I;QAC3I,+EAA+E;QAC/E,iHAAiH;QACjH,iIAAiI;QACjI,gMAAgM;QAChM,sNAAsN;KACvN;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,8BAA8B;YAC7C,OAAO,EAAE,+BAA+B;YACxC,QAAQ,EAAE,aAAa;SACxB;QACD;YACE,aAAa,EAAE,4CAA4C;YAC3D,OAAO,EAAE,yCAAyC;YAClD,QAAQ,EAAE,sEAAsE;SACjF;QACD;YACE,aAAa,EAAE,kCAAkC;YACjD,OAAO,EAAE,sEAAsE;YAC/E,QAAQ,EAAE,6BAA6B;SACxC;QACD;YACE,aAAa,EAAE,6CAA6C;YAC5D,OAAO,EAAE,wKAAwK;SAClL;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,qDAAqD;YACjE,QAAQ,EAAE,iJAAiJ;SAC5J;QACD;YACE,UAAU,EAAE,iDAAiD;YAC7D,QAAQ,EAAE,oLAAoL;SAC/L;QACD;YACE,UAAU,EAAE,4CAA4C;YACxD,QAAQ,EAAE,sHAAsH;SACjI;QACD;YACE,UAAU,EAAE,qCAAqC;YACjD,QAAQ,EAAE,0JAA0J;SACrK;QACD;YACE,UAAU,EAAE,yBAAyB;YACrC,QAAQ,EAAE,wFAAwF;SACnG;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,iEAAiE;QAC1E,KAAK,EAAE,8GAA8G;KACtH;IACD,eAAe,EAAE,2XAA2X;IAC5Y,cAAc,EAAE;QACd,qKAAqK;QACrK,oIAAoI;QACpI,6GAA6G;KAC9G;IACD,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,cAAc,EAAE;QACd,MAAM;QACN,WAAW;KACZ;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/grid.js

@@ -32,6 +32,20 @@ const builtinDoc = {
             "input": "subplot(1, 2, 1);\nplot(1:5, 1:5);\ngrid off;\nsubplot(1, 2, 2);\nplot(1:5, [5 4 3 2 1]);\ngrid on;"
         }
     ],
+    "faqs": [
+        {
+            "question": "Does RunMat support minor grid lines?",
+            "answer": "Not yet — `grid on` enables major grid lines only. Minor grid support (the MATLAB `grid minor` form) is planned. For now, you get the primary tick grid, which covers most use cases."
+        },
+        {
+            "question": "Can I style the grid line color or width?",
+            "answer": "Grid styling is tied to axes properties. You can adjust the grid appearance through the axes handle with `set(gca, 'GridColor', [0.5 0.5 0.5])` and related properties when the axes property path supports them. Check `get(gca)` to see what's currently exposed."
+        },
+        {
+            "question": "Does grid state carry across subplots?",
+            "answer": "No. Grid visibility is subplot-local. Calling `grid on` in one panel doesn't turn it on in others — you need to enable it explicitly in each subplot where you want grid lines."
+        }
+    ],
     "links": [
         {
             "label": "axis",
@@ -44,6 +58,22 @@ const builtinDoc = {
         {
             "label": "subplot",
             "url": "./subplot"
+        },
+        {
+            "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/grid.js.map

@@ -1 +1 @@
-{"version":3,"file":"grid.js","sourceRoot":"","sources":["../../../src/generated/builtins/grid.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,MAAM;IACf,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,MAAM;QACN,SAAS;QACT,UAAU;QACV,kBAAkB;QAClB,aAAa;KACd;IACD,SAAS,EAAE,sFAAsF;IACjG,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,0BAA0B;KACnC;IACD,aAAa,EAAE,wPAAwP;IACvQ,WAAW,EAAE;QACX,mDAAmD;QACnD,qDAAqD;QACrD,4DAA4D;QAC5D,oFAAoF;KACrF;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,0CAA0C;YACzD,OAAO,EAAE,mCAAmC;SAC7C;QACD;YACE,aAAa,EAAE,uCAAuC;YACtD,OAAO,EAAE,qGAAqG;SAC/G;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,2DAA2D;QACpE,KAAK,EAAE,wGAAwG;KAChH;IACD,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IACd,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"grid.js","sourceRoot":"","sources":["../../../src/generated/builtins/grid.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,MAAM;IACf,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,MAAM;QACN,SAAS;QACT,UAAU;QACV,kBAAkB;QAClB,aAAa;KACd;IACD,SAAS,EAAE,sFAAsF;IACjG,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,0BAA0B;KACnC;IACD,aAAa,EAAE,wPAAwP;IACvQ,WAAW,EAAE;QACX,mDAAmD;QACnD,qDAAqD;QACrD,4DAA4D;QAC5D,oFAAoF;KACrF;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,0CAA0C;YACzD,OAAO,EAAE,mCAAmC;SAC7C;QACD;YACE,aAAa,EAAE,uCAAuC;YACtD,OAAO,EAAE,qGAAqG;SAC/G;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,uCAAuC;YACnD,QAAQ,EAAE,uLAAuL;SAClM;QACD;YACE,UAAU,EAAE,2CAA2C;YACvD,QAAQ,EAAE,qQAAqQ;SAChR;QACD;YACE,UAAU,EAAE,wCAAwC;YACpD,QAAQ,EAAE,iLAAiL;SAC5L;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;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,2DAA2D;QACpE,KAAK,EAAE,wGAAwG;KAChH;IACD,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IACd,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/hist.js

@@ -56,6 +56,16 @@ const builtinDoc = {
             "output": "% Use histogram(...) instead when you want bin-edge semantics and an object handle"
         }
     ],
+    "faqs": [
+        {
+            "question": "What's the actual difference between hist and histogram?",
+            "answer": "The critical difference is how the second argument is interpreted. `hist(data, v)` treats `v` as **bin centers**. `histogram(data, 'BinEdges', v)` treats `v` as **bin edges**. Beyond that, `histogram` returns a handle object with properties you can query via `get`, while `hist` is a fire-and-forget plotting command."
+        },
+        {
+            "question": "When should I use hist instead of histogram?",
+            "answer": "Use `hist` when you're porting legacy MATLAB code that relies on center-based binning or when you want a quick distribution plot without needing a handle object. For anything new—especially if you need normalization modes, bin-edge control, or programmatic access to bin counts—use `histogram` instead."
+        }
+    ],
     "links": [
         {
             "label": "histogram",
@@ -68,6 +78,22 @@ const builtinDoc = {
         {
             "label": "pie",
             "url": "./pie"
+        },
+        {
+            "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/hist.js.map

@@ -1 +1 @@
-{"version":3,"file":"hist.js","sourceRoot":"","sources":["../../../src/generated/builtins/hist.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,MAAM;IACf,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,MAAM;QACN,kBAAkB;QAClB,aAAa;QACb,mBAAmB;QACnB,aAAa;QACb,mBAAmB;KACpB;IACD,SAAS,EAAE,iGAAiG;IAC5G,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,2KAA2K;KACrL;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,iCAAiC;KAC1C;IACD,aAAa,EAAE,ibAAib;IAChc,WAAW,EAAE;QACX,6GAA6G;QAC7G,qHAAqH;QACrH,gHAAgH;QAChH,8LAA8L;QAC9L,+GAA+G;KAChH;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,mCAAmC;YAClD,OAAO,EAAE,qCAAqC;SAC/C;QACD;YACE,aAAa,EAAE,2BAA2B;YAC1C,OAAO,EAAE,kEAAkE;YAC3E,QAAQ,EAAE,qEAAqE;SAChF;QACD;YACE,aAAa,EAAE,4DAA4D;YAC3E,OAAO,EAAE,8CAA8C;YACvD,QAAQ,EAAE,oFAAoF;SAC/F;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;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,2DAA2D;QACpE,KAAK,EAAE,wGAAwG;KAChH;IACD,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IACd,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"hist.js","sourceRoot":"","sources":["../../../src/generated/builtins/hist.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,MAAM;IACf,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,MAAM;QACN,kBAAkB;QAClB,aAAa;QACb,mBAAmB;QACnB,aAAa;QACb,mBAAmB;KACpB;IACD,SAAS,EAAE,iGAAiG;IAC5G,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,2KAA2K;KACrL;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,iCAAiC;KAC1C;IACD,aAAa,EAAE,ibAAib;IAChc,WAAW,EAAE;QACX,6GAA6G;QAC7G,qHAAqH;QACrH,gHAAgH;QAChH,8LAA8L;QAC9L,+GAA+G;KAChH;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,mCAAmC;YAClD,OAAO,EAAE,qCAAqC;SAC/C;QACD;YACE,aAAa,EAAE,2BAA2B;YAC1C,OAAO,EAAE,kEAAkE;YAC3E,QAAQ,EAAE,qEAAqE;SAChF;QACD;YACE,aAAa,EAAE,4DAA4D;YAC3E,OAAO,EAAE,8CAA8C;YACvD,QAAQ,EAAE,oFAAoF;SAC/F;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,0DAA0D;YACtE,QAAQ,EAAE,+TAA+T;SAC1U;QACD;YACE,UAAU,EAAE,8CAA8C;YAC1D,QAAQ,EAAE,gTAAgT;SAC3T;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;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,2DAA2D;QACpE,KAAK,EAAE,wGAAwG;KAChH;IACD,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IACd,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/histcounts2.js

@@ -113,6 +113,18 @@ const builtinDoc = {
         {
             "question": "Can I use histcounts2 on GPU arrays in RunMat?",
             "answer": "Yes. RunMat supports `histcounts2` on GPU arrays with `f32` and `f64` precision. GPU providers can attach a device kernel for full hardware acceleration."
+        },
+        {
+            "question": "What's the relationship between `N`, `Xedges`, and `Yedges`?",
+            "answer": "The count matrix `N` has size `(length(Xedges)-1) × (length(Yedges)-1)`: one row per `X` bin and one column per `Y` bin. Each bin covers the half-open interval `[edge(k), edge(k+1))`, except the final row and column, which include their upper edge so the largest finite values are counted."
+        },
+        {
+            "question": "How do I get a 2-D probability density from `histcounts2`?",
+            "answer": "Pass `'Normalization', 'pdf'`, for example `[N, Xedges, Yedges] = histcounts2(X, Y, 'Normalization', 'pdf')`. Each bin value is divided by the bin area and by the total number of pairs, so `sum(N .* diff(Xedges)' .* diff(Yedges), 'all')` equals `1` when no samples fall outside the bin limits."
+        },
+        {
+            "question": "How do I use explicit bin edges with `histcounts2`?",
+            "answer": "Supply two monotonically increasing edge vectors as the third and fourth arguments, for example `Xedges = 0:0.1:1; Yedges = 0:0.1:1; N = histcounts2(X, Y, Xedges, Yedges)`. This gives you full control over bin placement and is the easiest way to reproduce a 2-D histogram across multiple datasets."
         }
     ],
     "links": [
@@ -133,6 +145,19 @@ const builtinDoc = {
         "label": "crates/runmat-runtime/src/builtins/stats/hist/histcounts2.rs",
         "url": "crates/runmat-runtime/src/builtins/stats/hist/histcounts2.rs"
     },
+    "syntax": {
+        "example": {
+            "description": "Syntax",
+            "input": "[N, Xedges, Yedges] = histcounts2(X, Y)\n[N, Xedges, Yedges] = histcounts2(X, Y, nbins)\n[N, Xedges, Yedges] = histcounts2(X, Y, Xedges, Yedges)\n[N, Xedges, Yedges] = histcounts2(___, Name, Value)\n[N, Xedges, Yedges, binX, binY] = histcounts2(___)"
+        },
+        "points": [
+            "`X` and `Y` are numeric vectors (or arrays flattened column-major) of equal length holding paired observations.",
+            "`nbins` is either a scalar bin count applied to both axes or a two-element vector `[nX nY]` giving separate counts for the `X` and `Y` axes.",
+            "`Xedges` and `Yedges` are monotonically increasing edge vectors. Bin `k` covers `[edge(k), edge(k+1))`; the final bin also includes its right edge so maximum values are counted.",
+            "Name/value options include `'Normalization'` (`'count'`, `'probability'`, `'pdf'`, `'countdensity'`, `'cumcount'`, `'cdf'`), `'BinMethod'`, `'BinWidth'`, `'NumBins'`, `'XBinLimits'`, and `'YBinLimits'`.",
+            "With five outputs, `binX` and `binY` are integer indices the same size as the flattened inputs, giving the `X`- and `Y`-bin that each pair falls into (`0` when an observation is excluded)."
+        ]
+    },
     "gpu_residency": "As with other RunMat histogram routines, you do not need to call `gpuArray` explicitly just to obtain GPU execution. Once providers implement the `histcounts2` hook, the fusion planner will keep residency on the device automatically. Until then, the builtin gathers data to the host and returns CPU tensors even when inputs originate on the GPU, matching MATLAB semantics after an explicit `gather`.",
     "gpu_behavior": [
         "When either input is a `gpuArray`, RunMat gathers the samples back to host memory, performs the reference CPU implementation, and returns dense CPU tensors for the histogram and edges. The acceleration layer exposes a `histcounts2` provider hook; once kernels land, the runtime will automatically keep residency on the GPU and skip gathering. The builtin is registered as a sink, so fusion plans flush GPU residency before histogramming and the current implementation always yields host-resident outputs."

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

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

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

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

package/dist/generated/builtins/histogram.js

@@ -12,6 +12,7 @@ const builtinDoc = {
         "distribution analysis"
     ],
     "summary": "Create histogram objects with bin-edge semantics, normalization controls, and MATLAB `histogram` workflows.",
+    "hero_image": "https://web.runmatstatic.com/builtin-image/runmat-matlab-histogram-plot-overlaid-distributions.webp",
     "gpu_support": {
         "elementwise": false,
         "reduction": false,
@@ -54,6 +55,25 @@ const builtinDoc = {
             "description": "Apply normalization through histogram semantics",
             "input": "data = randn(1, 500);\nh = histogram(data, 'Normalization', 'probability');\nget(h, 'Normalization')",
             "output": "ans =\n    'probability'"
+        },
+        {
+            "description": "Overlaid distributions",
+            "input": "a = 2 + 1.2*randn(1, 5000);\nb = 4 + 0.8*randn(1, 5000);\n\nh1 = histogram(a, 'BinEdges', -2:0.25:8, 'Normalization', 'probability');\nset(h1, 'DisplayName', 'Process A');\nhold on;\nh2 = histogram(b, 'BinEdges', -2:0.25:8, 'Normalization', 'probability');\nset(h2, 'DisplayName', 'Process B');\nhold off;\n\ntitle('Distribution Comparison');\nxlabel('Measurement');\nylabel('Probability');\nlegend;\ngrid on;",
+            "image_webp": "https://web.runmatstatic.com/builtin-image/runmat-matlab-histogram-plot-overlaid-distributions.webp"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "How do I set a specific number of bins?",
+            "answer": "Pass the bin count as a second positional argument or use the `'NumBins'` name-value pair.\n\n```matlab\ndata = randn(1, 1000);\nhistogram(data, 30);                    % 30 bins\nhistogram(data, 'NumBins', 50);         % 50 bins\nhistogram(data, 'BinEdges', -3:0.1:3); % exact edges\n```\n\nExplicit `BinEdges` gives you full control over where each bin starts and ends."
+        },
+        {
+            "question": "How do I overlay two distributions on the same axes?",
+            "answer": "Use `hold on` between `histogram` calls and set `'Normalization'` to `'probability'` so both distributions are on a comparable scale.\n\n```matlab\nhistogram(randn(1,1000), 'Normalization', 'probability');\nhold on;\nhistogram(randn(1,1000) + 2, 'Normalization', 'probability');\nlegend('dist A', 'dist B');\n```"
+        },
+        {
+            "question": "What's the difference between histogram and hist?",
+            "answer": "`histogram` is the modern API: it uses bin-edge semantics, returns a handle object you can inspect with `get`/`set`, and supports normalization modes like `'probability'` and `'pdf'`. `hist` is the legacy API that interprets a second vector argument as bin centers. Use `histogram` for new code unless you specifically need center-based binning from a legacy workflow."
         }
     ],
     "links": [
@@ -72,6 +92,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/histogram.js.map

@@ -1 +1 @@
-{"version":3,"file":"histogram.js","sourceRoot":"","sources":["../../../src/generated/builtins/histogram.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,WAAW;IACpB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,WAAW;QACX,kBAAkB;QAClB,WAAW;QACX,sBAAsB;QACtB,kBAAkB;QAClB,uBAAuB;KACxB;IACD,SAAS,EAAE,6GAA6G;IACxH,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,sFAAsF;KAChG;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,sCAAsC;KAC/C;IACD,aAAa,EAAE,6RAA6R;IAC5S,WAAW,EAAE;QACX,sDAAsD;QACtD,uHAAuH;QACvH,2IAA2I;QAC3I,6JAA6J;QAC7J,qIAAqI;KACtI;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,qCAAqC;YACpD,OAAO,EAAE,8CAA8C;YACvD,QAAQ,EAAE,kCAAkC;SAC7C;QACD;YACE,aAAa,EAAE,+CAA+C;YAC9D,OAAO,EAAE,yGAAyG;SACnH;QACD;YACE,aAAa,EAAE,iDAAiD;YAChE,OAAO,EAAE,sGAAsG;YAC/G,QAAQ,EAAE,0BAA0B;SACrC;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;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,gEAAgE;QACzE,KAAK,EAAE,6GAA6G;KACrH;IACD,KAAK,EAAE,WAAW;IAClB,MAAM,EAAE,WAAW;IACnB,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"histogram.js","sourceRoot":"","sources":["../../../src/generated/builtins/histogram.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,WAAW;IACpB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,WAAW;QACX,kBAAkB;QAClB,WAAW;QACX,sBAAsB;QACtB,kBAAkB;QAClB,uBAAuB;KACxB;IACD,SAAS,EAAE,6GAA6G;IACxH,YAAY,EAAE,qGAAqG;IACnH,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,sFAAsF;KAChG;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,sCAAsC;KAC/C;IACD,aAAa,EAAE,6RAA6R;IAC5S,WAAW,EAAE;QACX,sDAAsD;QACtD,uHAAuH;QACvH,2IAA2I;QAC3I,6JAA6J;QAC7J,qIAAqI;KACtI;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,qCAAqC;YACpD,OAAO,EAAE,8CAA8C;YACvD,QAAQ,EAAE,kCAAkC;SAC7C;QACD;YACE,aAAa,EAAE,+CAA+C;YAC9D,OAAO,EAAE,yGAAyG;SACnH;QACD;YACE,aAAa,EAAE,iDAAiD;YAChE,OAAO,EAAE,sGAAsG;YAC/G,QAAQ,EAAE,0BAA0B;SACrC;QACD;YACE,aAAa,EAAE,wBAAwB;YACvC,OAAO,EAAE,2ZAA2Z;YACpa,YAAY,EAAE,qGAAqG;SACpH;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,yCAAyC;YACrD,QAAQ,EAAE,qXAAqX;SAChY;QACD;YACE,UAAU,EAAE,sDAAsD;YAClE,QAAQ,EAAE,0TAA0T;SACrU;QACD;YACE,UAAU,EAAE,mDAAmD;YAC/D,QAAQ,EAAE,kXAAkX;SAC7X;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;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,gEAAgE;QACzE,KAAK,EAAE,6GAA6G;KACrH;IACD,KAAK,EAAE,WAAW;IAClB,MAAM,EAAE,WAAW;IACnB,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/image.js

@@ -57,6 +57,20 @@ const builtinDoc = {
             "output": "ans =\n    'image'"
         }
     ],
+    "faqs": [
+        {
+            "question": "How do I display RGB data with image?",
+            "answer": "Pass an MxNx3 array where the third dimension holds red, green, and blue channels. Values should be in `[0, 1]` for doubles or `[0, 255]` for uint8.\n\n```matlab\nimg = zeros(100, 100, 3);\nimg(:,:,1) = 1;           % full red\nimg(30:70, 30:70, 2) = 1; % green square\nimage(img);\n```"
+        },
+        {
+            "question": "When should I use image vs imagesc?",
+            "answer": "`image` displays pixel data as-is — either indexed colors through a colormap or direct RGB truecolor. `imagesc` automatically scales a 2-D matrix so its min and max span the full colormap range. If you're showing actual image pixels or pre-indexed data, use `image`. If you're visualizing a matrix of computed values as a heatmap, use `imagesc`."
+        },
+        {
+            "question": "Why does my image appear upside down?",
+            "answer": "By default, `image` sets the y-axis to go from top to bottom (row 1 at the top), which matches matrix indexing. If your coordinate system expects y to increase upward, call `axis xy` after `image` to flip the axis direction. Use `axis ij` to restore the default matrix-style orientation."
+        }
+    ],
     "links": [
         {
             "label": "imagesc",
@@ -77,6 +91,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/image.js.map

@@ -1 +1 @@
-{"version":3,"file":"image.js","sourceRoot":"","sources":["../../../src/generated/builtins/image.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,OAAO;IAChB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,OAAO;QACP,eAAe;QACf,iBAAiB;QACjB,eAAe;QACf,cAAc;QACd,oBAAoB;KACrB;IACD,SAAS,EAAE,uHAAuH;IAClI,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,kHAAkH;KAC5H;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,kCAAkC;QAC1C,aAAa,EAAE,qCAAqC;KACrD;IACD,aAAa,EAAE,qXAAqX;IACpY,WAAW,EAAE;QACX,sHAAsH;QACtH,+FAA+F;QAC/F,+EAA+E;QAC/E,uJAAuJ;QACvJ,0HAA0H;KAC3H;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,gCAAgC;YAC/C,OAAO,EAAE,yDAAyD;SACnE;QACD;YACE,aAAa,EAAE,+BAA+B;YAC9C,OAAO,EAAE,kFAAkF;YAC3F,QAAQ,EAAE,qCAAqC;SAChD;QACD;YACE,aAAa,EAAE,6DAA6D;YAC5E,OAAO,EAAE,yEAAyE;YAClF,QAAQ,EAAE,oBAAoB;SAC/B;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;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,4DAA4D;QACrE,KAAK,EAAE,yGAAyG;KACjH;IACD,eAAe,EAAE,2QAA2Q;IAC5R,cAAc,EAAE;QACd,uGAAuG;QACvG,kHAAkH;KACnH;IACD,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,OAAO;IACf,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"image.js","sourceRoot":"","sources":["../../../src/generated/builtins/image.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,OAAO;IAChB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,OAAO;QACP,eAAe;QACf,iBAAiB;QACjB,eAAe;QACf,cAAc;QACd,oBAAoB;KACrB;IACD,SAAS,EAAE,uHAAuH;IAClI,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,kHAAkH;KAC5H;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,kCAAkC;QAC1C,aAAa,EAAE,qCAAqC;KACrD;IACD,aAAa,EAAE,qXAAqX;IACpY,WAAW,EAAE;QACX,sHAAsH;QACtH,+FAA+F;QAC/F,+EAA+E;QAC/E,uJAAuJ;QACvJ,0HAA0H;KAC3H;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,gCAAgC;YAC/C,OAAO,EAAE,yDAAyD;SACnE;QACD;YACE,aAAa,EAAE,+BAA+B;YAC9C,OAAO,EAAE,kFAAkF;YAC3F,QAAQ,EAAE,qCAAqC;SAChD;QACD;YACE,aAAa,EAAE,6DAA6D;YAC5E,OAAO,EAAE,yEAAyE;YAClF,QAAQ,EAAE,oBAAoB;SAC/B;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,uCAAuC;YACnD,QAAQ,EAAE,gSAAgS;SAC3S;QACD;YACE,UAAU,EAAE,qCAAqC;YACjD,QAAQ,EAAE,2VAA2V;SACtW;QACD;YACE,UAAU,EAAE,uCAAuC;YACnD,QAAQ,EAAE,iSAAiS;SAC5S;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;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,4DAA4D;QACrE,KAAK,EAAE,yGAAyG;KACjH;IACD,eAAe,EAAE,2QAA2Q;IAC5R,cAAc,EAAE;QACd,uGAAuG;QACvG,kHAAkH;KACnH;IACD,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,OAAO;IACf,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/imagesc.js

@@ -12,6 +12,7 @@ const builtinDoc = {
         "colormap image"
     ],
     "summary": "Display scaled matrix images for heatmaps, colormaps, and MATLAB `imagesc` style visualization.",
+    "hero_image": "https://web.runmatstatic.com/builtin-image/runmat-matlab-plot-imagesc-scaler-field-heatmap.webp",
     "gpu_support": {
         "elementwise": false,
         "reduction": false,
@@ -53,6 +54,25 @@ const builtinDoc = {
         {
             "description": "Use subplot-local color workflows",
             "input": "[X, Y] = meshgrid(linspace(-3, 3, 40), linspace(-3, 3, 40));\nZ = sin(X) .* cos(Y);\nsubplot(1, 2, 1);\nimagesc(Z);\ncolormap('jet');\ncolorbar;\nsubplot(1, 2, 2);\nimagesc(magic(20));\ncolormap('gray');"
+        },
+        {
+            "description": "Dense matrix as a heatmap",
+            "input": "[X, Y] = meshgrid(linspace(-pi, pi, 300), linspace(-pi, pi, 300));\nZ = sin(3*X) .* cos(2*Y) + cos(X.*Y);\n\nimagesc(Z);\ncolormap('turbo');\ncolorbar;\ntitle('Scalar Field Heatmap');\nxlabel('Column');\nylabel('Row');\naxis equal;",
+            "image_webp": "https://web.runmatstatic.com/builtin-image/runmat-matlab-plot-imagesc-scaler-field-heatmap.webp"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "What's the difference between imagesc and image?",
+            "answer": "`imagesc` maps a 2-D matrix through the colormap with automatic scaling — the min value maps to the bottom of the colormap and the max to the top. `image` treats input as direct indexed or truecolor data without automatic scaling. Use `imagesc` for heatmaps and value visualization; use `image` when you have actual image pixel data (RGB arrays or pre-indexed values)."
+        },
+        {
+            "question": "How does colormap scaling work with imagesc?",
+            "answer": "`imagesc` sets the color limits (`caxis`) to `[min(C(:)), max(C(:))]` automatically. Every value in the matrix maps linearly into that range across the active colormap. To override the auto-scaling, call `caxis([lo hi])` after `imagesc`.\n\n```matlab\nimagesc(A);\ncaxis([-1 1]);\ncolorbar;\n```"
+        },
+        {
+            "question": "How do I display a matrix as a heatmap?",
+            "answer": "Pass the matrix directly to `imagesc` and add a colorbar for the legend. Pair with a colormap that suits your data — diverging maps like `'coolwarm'` work well for data centered around zero, sequential maps like `'parula'` for positive-only ranges.\n\n```matlab\nimagesc(myMatrix);\ncolormap('parula');\ncolorbar;\n```"
         }
     ],
     "links": [
@@ -71,6 +91,22 @@ const builtinDoc = {
         {
             "label": "axis",
             "url": "./axis"
+        },
+        {
+            "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/imagesc.js.map

@@ -1 +1 @@
-{"version":3,"file":"imagesc.js","sourceRoot":"","sources":["../../../src/generated/builtins/imagesc.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,SAAS;QACT,cAAc;QACd,SAAS;QACT,sBAAsB;QACtB,gBAAgB;QAChB,gBAAgB;KACjB;IACD,SAAS,EAAE,iGAAiG;IAC5G,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,wIAAwI;KAClJ;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,oCAAoC;QAC5C,aAAa,EAAE,qCAAqC;KACrD;IACD,aAAa,EAAE,4bAA4b;IAC3c,WAAW,EAAE;QACX,8EAA8E;QAC9E,0GAA0G;QAC1G,sJAAsJ;QACtJ,0FAA0F;QAC1F,+FAA+F;KAChG;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,kDAAkD;YACjE,OAAO,EAAE,6GAA6G;SACvH;QACD;YACE,aAAa,EAAE,uCAAuC;YACtD,OAAO,EAAE,8EAA8E;SACxF;QACD;YACE,aAAa,EAAE,mCAAmC;YAClD,OAAO,EAAE,6MAA6M;SACvN;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,8DAA8D;QACvE,KAAK,EAAE,2GAA2G;KACnH;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"imagesc.js","sourceRoot":"","sources":["../../../src/generated/builtins/imagesc.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,SAAS;QACT,cAAc;QACd,SAAS;QACT,sBAAsB;QACtB,gBAAgB;QAChB,gBAAgB;KACjB;IACD,SAAS,EAAE,iGAAiG;IAC5G,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,wIAAwI;KAClJ;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,oCAAoC;QAC5C,aAAa,EAAE,qCAAqC;KACrD;IACD,aAAa,EAAE,4bAA4b;IAC3c,WAAW,EAAE;QACX,8EAA8E;QAC9E,0GAA0G;QAC1G,sJAAsJ;QACtJ,0FAA0F;QAC1F,+FAA+F;KAChG;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,kDAAkD;YACjE,OAAO,EAAE,6GAA6G;SACvH;QACD;YACE,aAAa,EAAE,uCAAuC;YACtD,OAAO,EAAE,8EAA8E;SACxF;QACD;YACE,aAAa,EAAE,mCAAmC;YAClD,OAAO,EAAE,6MAA6M;SACvN;QACD;YACE,aAAa,EAAE,2BAA2B;YAC1C,OAAO,EAAE,yOAAyO;YAClP,YAAY,EAAE,iGAAiG;SAChH;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,kDAAkD;YAC9D,QAAQ,EAAE,kXAAkX;SAC7X;QACD;YACE,UAAU,EAAE,8CAA8C;YAC1D,QAAQ,EAAE,ySAAyS;SACpT;QACD;YACE,UAAU,EAAE,yCAAyC;YACrD,QAAQ,EAAE,gUAAgU;SAC3U;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;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,8DAA8D;QACvE,KAAK,EAAE,2GAA2G;KACnH;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/isfield.js

@@ -28,7 +28,7 @@ const builtinDoc = {
     "requires_feature": null,
     "tested": {
         "unit": "builtins::structs::core::isfield::tests",
-        "integration": "runmat_ignition::functions::struct_isfield_multi_and_fieldnames"
+        "integration": "runmat-vm/tests/functions.rs::struct_isfield_multi_and_fieldnames"
     },
     "description": "`tf = isfield(S, name)` returns a logical value that indicates whether the struct `S` defines the field `name`. When `name` is a string array or a cell array of names, `isfield` returns a logical array with the same size, reporting the result for each requested field.",
     "behaviors": [

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

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

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

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

package/dist/generated/builtins/isnan.js

@@ -116,6 +116,18 @@ const builtinDoc = {
         {
             "question": "Does isnan support GPU acceleration in RunMat?",
             "answer": "Yes. `isnan` runs on the GPU with elementwise fusion, meaning it can be combined with other operations without extra memory round-trips."
+        },
+        {
+            "question": "What's the difference between `isnan`, `isinf`, and `isfinite`?",
+            "answer": "`isnan(x)` is true only for `NaN` values, `isinf(x)` is true only for `Inf` and `-Inf`, and `isfinite(x)` is true for everything else (neither `NaN` nor infinite). For any numeric `x`, exactly one of `isnan(x)`, `isinf(x)`, or `isfinite(x)` is `true`."
+        },
+        {
+            "question": "How do I check for NaN without calling `isnan`?",
+            "answer": "`NaN` is the only IEEE value that is not equal to itself, so `x ~= x` is `true` exactly when `x` is `NaN`. This trick works on scalars and arrays, but `isnan` is clearer, matches MATLAB idioms, and is what you should reach for in production code."
+        },
+        {
+            "question": "How do I filter NaN values out of a vector?",
+            "answer": "Index with the negated mask: `A(~isnan(A))` keeps only the finite entries. For matrices, use row-wise logic such as `A(~any(isnan(A), 2), :)` to keep rows with no `NaN`."
         }
     ],
     "links": [
@@ -156,6 +168,17 @@ const builtinDoc = {
         "label": "`crates/runmat-runtime/src/builtins/logical/tests/isnan.rs`",
         "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/logical/tests/isnan.rs"
     },
+    "syntax": {
+        "example": {
+            "description": "Syntax",
+            "input": "tf = isnan(A)"
+        },
+        "points": [
+            "`A` is a numeric scalar or array (real, complex, or `gpuArray`). Logical, character, and string inputs are accepted and map to `false`, matching MATLAB.",
+            "For complex inputs, `isnan` returns `true` whenever either the real or imaginary component is `NaN`.",
+            "`tf` is a logical array the same size as `A`, with `true` where the corresponding element is `NaN` and `false` otherwise."
+        ]
+    },
     "gpu_residency": "You usually do **not** need to call `gpuArray` explicitly. RunMat's auto-offload planner keeps tensors on the GPU across fused expressions when that improves performance. You can still seed residency manually with `gpuArray` for compatibility with MATLAB scripts or when you want fine-grained control over data movement.",
     "gpu_behavior": [
         "When RunMat Accelerate is active, `isnan` looks for the provider hook `logical_isnan`. Providers that implement the hook execute the NaN test entirely on the GPU, producing a logical gpuArray result without any host transfers. If the hook is absent, RunMat gathers the input tensor back to the CPU, computes the mask on the host, and returns a regular logical array so the builtin always succeeds."

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

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