runmat 0.4.3 → 0.4.4

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

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

package/dist/generated/builtins/plot3.js

@@ -55,6 +55,20 @@ const builtinDoc = {
             "output": "ans =\n    'line'"
         }
     ],
+    "faqs": [
+        {
+            "question": "How do I plot a 3-D trajectory from parametric equations?",
+            "answer": "Generate a parameter vector `t`, compute x(t), y(t), z(t), and pass all three to `plot3`. The line connects points in parameter order.\n\n```matlab\nt = linspace(0, 10*pi, 500);\nplot3(sin(t), cos(t), t);\nzlabel('z');\n```"
+        },
+        {
+            "question": "Can I overlay plot3 lines with scatter3 points?",
+            "answer": "Yes — use `hold on` between calls. Both `plot3` and `scatter3` share the same 3-D axes and camera state, so they compose directly.\n\n```matlab\nt = linspace(0, 4*pi, 200);\nplot3(cos(t), sin(t), t);\nhold on;\nscatter3(cos(t(1:20:end)), sin(t(1:20:end)), t(1:20:end));\n```"
+        },
+        {
+            "question": "How do I control the camera angle on a plot3 figure?",
+            "answer": "Call `view(az, el)` after plotting. `az` is the azimuth (horizontal rotation) and `el` is the elevation (vertical tilt), both in degrees. `view(3)` gives the default 3-D perspective. Camera state is subplot-local, so each subplot can have its own angle."
+        }
+    ],
     "links": [
         {
             "label": "scatter3",
@@ -71,6 +85,22 @@ const builtinDoc = {
         {
             "label": "legend",
             "url": "./legend"
+        },
+        {
+            "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/plot3.js.map

@@ -1 +1 @@
-{"version":3,"file":"plot3.js","sourceRoot":"","sources":["../../../src/generated/builtins/plot3.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,kBAAkB;QAClB,cAAc;QACd,cAAc;KACf;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,oHAAoH;KAC9H;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;KAC3C;IACD,aAAa,EAAE,kPAAkP;IACjQ,WAAW,EAAE;QACX,wEAAwE;QACxE,kGAAkG;QAClG,kHAAkH;QAClH,4GAA4G;QAC5G,8GAA8G;KAC/G;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,oBAAoB;YACnC,OAAO,EAAE,wDAAwD;SAClE;QACD;YACE,aAAa,EAAE,+CAA+C;YAC9D,OAAO,EAAE,yLAAyL;SACnM;QACD;YACE,aAAa,EAAE,8CAA8C;YAC7D,OAAO,EAAE,8GAA8G;YACvH,QAAQ,EAAE,mBAAmB;SAC9B;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,4DAA4D;QACrE,KAAK,EAAE,yGAAyG;KACjH;IACD,eAAe,EAAE,mMAAmM;IACpN,cAAc,EAAE;QACd,+HAA+H;QAC/H,sGAAsG;KACvG;IACD,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,OAAO;IACf,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"plot3.js","sourceRoot":"","sources":["../../../src/generated/builtins/plot3.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,kBAAkB;QAClB,cAAc;QACd,cAAc;KACf;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,oHAAoH;KAC9H;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;KAC3C;IACD,aAAa,EAAE,kPAAkP;IACjQ,WAAW,EAAE;QACX,wEAAwE;QACxE,kGAAkG;QAClG,kHAAkH;QAClH,4GAA4G;QAC5G,8GAA8G;KAC/G;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,oBAAoB;YACnC,OAAO,EAAE,wDAAwD;SAClE;QACD;YACE,aAAa,EAAE,+CAA+C;YAC9D,OAAO,EAAE,yLAAyL;SACnM;QACD;YACE,aAAa,EAAE,8CAA8C;YAC7D,OAAO,EAAE,8GAA8G;YACvH,QAAQ,EAAE,mBAAmB;SAC9B;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,2DAA2D;YACvE,QAAQ,EAAE,iOAAiO;SAC5O;QACD;YACE,UAAU,EAAE,iDAAiD;YAC7D,QAAQ,EAAE,oRAAoR;SAC/R;QACD;YACE,UAAU,EAAE,sDAAsD;YAClE,QAAQ,EAAE,+PAA+P;SAC1Q;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;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,mMAAmM;IACpN,cAAc,EAAE;QACd,+HAA+H;QAC/H,sGAAsG;KACvG;IACD,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,OAAO;IACf,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/polyder.js

@@ -34,7 +34,7 @@ const builtinDoc = {
     "tested": {
         "unit": "builtins::math::poly::polyder::tests",
         "integration": "builtins::math::poly::polyder::tests::{gpu_inputs_remain_on_device,gpu_product_matches_cpu,gpu_quotient_matches_cpu,wgpu_polyder_single_matches_cpu,wgpu_polyder_product_matches_cpu,wgpu_polyder_quotient_matches_cpu}",
-        "vm": "ignition::vm polyder multi-output dispatch"
+        "vm": "vm polyder multi-output dispatch"
     },
     "description": "`polyder` differentiates polynomials represented by their coefficient vectors. The coefficients follow MATLAB’s convention: the first element corresponds to the highest power of `x`. The builtin supports three related operations:\n\n1. `polyder(p)` returns the derivative of a polynomial `p`. 2. `polyder(p, a)` applies the product rule to the convolution `conv(p, a)`. 3. `[num, den] = polyder(u, v)` returns the derivative of a rational function `u(x) / v(x)` using the quotient rule, yielding the numerator `num` and denominator `den`.",
     "behaviors": [

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"polyval.d.ts","sourceRoot":"","sources":["../../../src/generated/builtins/polyval.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,QAAA,MAAM,UAAU,EAAE,UAgKjB,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"polyval.d.ts","sourceRoot":"","sources":["../../../src/generated/builtins/polyval.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/polyval.js

@@ -111,6 +111,18 @@ const builtinDoc = {
         {
             "question": "Does `polyval` support sparse inputs?",
             "answer": "Not yet. Dense inputs (including gpuArray tensors) are supported today. Sparse support will arrive once RunMat's sparse infrastructure stabilises."
+        },
+        {
+            "question": "What does `polyval` do?",
+            "answer": "— `polyval(p, x)` evaluates the polynomial whose coefficients are stored in `p` at every point in `x`. Coefficients are listed highest degree first, so `p = [2 -3 5]` represents `2*x^2 - 3*x + 5`. The output has the same shape as `x`."
+        },
+        {
+            "question": "How does `polyval` evaluate a polynomial?",
+            "answer": "— `polyval` uses Horner's method (nested multiplication), which rewrites `p(1)*x^n + p(2)*x^(n-1) + ... + p(end)` as `((p(1)*x + p(2))*x + p(3))*x + ...`. Horner's method needs only `n` multiplications and `n` additions and is more numerically stable than computing each power of `x` explicitly."
+        },
+        {
+            "question": "How do I use `polyval` with `polyfit`?",
+            "answer": "— Fit a polynomial with `polyfit`, then evaluate it on a smooth grid with `polyval`. For example:\n\n```matlab\np = polyfit(x, y, 3);\nxfine = linspace(min(x), max(x), 200);\nyfit = polyval(p, xfine);\nplot(x, y, 'o', xfine, yfit, '-');\n```\n\nWhen `polyfit` returns `[p, S, mu]`, pass them through (`polyval(p, xfine, S, mu)`) to get centring-aware evaluation and prediction intervals."
         }
     ],
     "links": [
@@ -154,6 +166,31 @@ const builtinDoc = {
     "gpu_behavior": [
         "When a GPU provider is active, RunMat first attempts to evaluate the polynomial in device memory using a dedicated Horner kernel. Coefficients and inputs are uploaded automatically when required. If the call requests complex arithmetic, prediction intervals, or otherwise falls outside the GPU kernel’s contract, RunMat gathers to the host, executes the CPU implementation, and (for real-valued results) pushes the output back to the GPU so downstream kernels retain residency."
     ],
+    "syntax": {
+        "example": {
+            "description": "Syntax",
+            "input": "y = polyval(p, x)\ny = polyval(p, x, [], mu)\n[y, delta] = polyval(p, x, S)\n[y, delta] = polyval(p, x, S, mu)"
+        },
+        "points": [
+            "`p` is the coefficient vector with the **highest-degree term first**: `p = [2 -3 5]` represents `2*x^2 - 3*x + 5`.",
+            "`x` is the scalar, vector, matrix, or N-D array of points at which to evaluate the polynomial. The output `y` has the same shape as `x`.",
+            "`S` is an optional error-estimation structure produced by `polyfit`. It must contain the fields `R`, `normr`, and `df`. When requested with two outputs, `polyval` returns `delta`, the standard error (1σ prediction interval) at each point.",
+            "`mu` is an optional two-element centring/scaling vector `[mean(x), std(x)]` returned by `polyfit`. When supplied, the polynomial is evaluated at `(x - mu(1)) / mu(2)`. Pass `[]` for `S` if you want centring without prediction intervals.",
+            "Returns `y`, the evaluated polynomial values, and optionally `delta`, the element-wise standard error from the fit."
+        ]
+    },
+    "validation": {
+        "summary": "`polyval` evaluates the polynomial using the standard Horner recurrence, the same scheme MATLAB and NumPy's `polyval` use. The CPU implementation covers real and complex coefficients plus the `polyfit` prediction-interval form. The GPU path has a dedicated Horner kernel for real inputs and falls back to CPU for complex or prediction-interval calls.",
+        "implementation": {
+            "label": "crates/runmat-runtime/src/builtins/math/poly/polyval.rs",
+            "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/math/poly/polyval.rs"
+        },
+        "parity_test": {
+            "label": "polyval unit tests",
+            "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/math/poly/polyval.rs"
+        },
+        "tolerance": "1e-9 (f64), 1e-3 (f32)"
+    },
     "key": "polyval",
     "slug": "polyval",
     "categoryPath": [

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

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

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

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

package/dist/generated/builtins/quiver.js

@@ -12,6 +12,7 @@ const builtinDoc = {
         "direction field"
     ],
     "summary": "Visualize 2-D vector fields with scalable arrows, GPU-aware execution, and MATLAB `quiver` call forms.",
+    "hero_image": "https://web.runmatstatic.com/builtin-image/runmat-matlab-plot-quiver-gradient-vector.webp",
     "gpu_support": {
         "elementwise": false,
         "reduction": false,
@@ -59,6 +60,25 @@ const builtinDoc = {
         {
             "description": "Adjust arrow scaling and head size through the handle",
             "input": "[X, Y] = meshgrid(-2:0.5:2, -2:0.5:2);\nU = -Y;\nV = X;\nh = quiver(X, Y, U, V);\nset(h, 'AutoScaleFactor', 1.5, 'MaxHeadSize', 0.2, 'DisplayName', 'rotation');\nlegend;"
+        },
+        {
+            "description": "Gradient vector field over a scalar potential",
+            "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));\n\ncontourf(X, Y, Z, 15);\nhold on;\nquiver(X, Y, DX, DY, 'k', 'LineWidth', 1);\nhold off;\n\ncolormap('turbo');\ncolorbar;\ntitle('Gradient Field over Scalar Potential');\nxlabel('x');\nylabel('y');",
+            "image_webp": "https://web.runmatstatic.com/builtin-image/runmat-matlab-plot-quiver-gradient-vector.webp"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "How do I control arrow lengths in a quiver plot?",
+            "answer": "Use the `'AutoScaleFactor'` property. A value of `1` means default scaling, `0` disables auto-scaling entirely (arrows drawn at raw data magnitude), and values like `1.5` or `2` make arrows proportionally longer.\n\n```matlab\nh = quiver(X, Y, U, V);\nset(h, 'AutoScaleFactor', 0); % raw magnitudes, no auto-scaling\n```"
+        },
+        {
+            "question": "Can I overlay quiver arrows on top of a contourf plot?",
+            "answer": "Yes. Plot the filled contour first, then call `hold on` and add the quiver layer. Both share the same axes, so the coordinate grids align automatically.\n\n```matlab\ncontourf(X, Y, Z);\nhold on;\nquiver(X, Y, U, V, 'Color', 'k');\n```"
+        },
+        {
+            "question": "Does RunMat support 3-D quiver plots?",
+            "answer": "Not yet. `quiver` currently handles 2-D vector fields only. For 3-D direction visualization, consider using `plot3` to draw line segments manually, or combine `scatter3` with custom arrow geometry."
         }
     ],
     "links": [
@@ -81,6 +101,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/quiver.js.map

@@ -1 +1 @@
-{"version":3,"file":"quiver.js","sourceRoot":"","sources":["../../../src/generated/builtins/quiver.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,QAAQ;IACjB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,QAAQ;QACR,cAAc;QACd,YAAY;QACZ,YAAY;QACZ,eAAe;QACf,iBAAiB;KAClB;IACD,SAAS,EAAE,wGAAwG;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,4IAA4I;KACtJ;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,mCAAmC;QAC3C,aAAa,EAAE,sCAAsC;KACtD;IACD,aAAa,EAAE,iSAAiS;IAChT,WAAW,EAAE;QACX,kFAAkF;QAClF,iHAAiH;QACjH,uGAAuG;QACvG,yHAAyH;QACzH,0HAA0H;KAC3H;IACD,SAAS,EAAE;QACT,yDAAyD;QACzD,iEAAiE;QACjE,2IAA2I;KAC5I;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,6CAA6C;YAC5D,OAAO,EAAE,wEAAwE;YACjF,QAAQ,EAAE,iEAAiE;SAC5E;QACD;YACE,aAAa,EAAE,+CAA+C;YAC9D,OAAO,EAAE,8EAA8E;SACxF;QACD;YACE,aAAa,EAAE,uDAAuD;YACtE,OAAO,EAAE,2KAA2K;SACrL;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,6DAA6D;QACtE,KAAK,EAAE,0GAA0G;KAClH;IACD,eAAe,EAAE,0QAA0Q;IAC3R,cAAc,EAAE;QACd,gGAAgG;QAChG,+HAA+H;KAChI;IACD,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"quiver.js","sourceRoot":"","sources":["../../../src/generated/builtins/quiver.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,QAAQ;IACjB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,QAAQ;QACR,cAAc;QACd,YAAY;QACZ,YAAY;QACZ,eAAe;QACf,iBAAiB;KAClB;IACD,SAAS,EAAE,wGAAwG;IACnH,YAAY,EAAE,2FAA2F;IACzG,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,4IAA4I;KACtJ;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,mCAAmC;QAC3C,aAAa,EAAE,sCAAsC;KACtD;IACD,aAAa,EAAE,iSAAiS;IAChT,WAAW,EAAE;QACX,kFAAkF;QAClF,iHAAiH;QACjH,uGAAuG;QACvG,yHAAyH;QACzH,0HAA0H;KAC3H;IACD,SAAS,EAAE;QACT,yDAAyD;QACzD,iEAAiE;QACjE,2IAA2I;KAC5I;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,6CAA6C;YAC5D,OAAO,EAAE,wEAAwE;YACjF,QAAQ,EAAE,iEAAiE;SAC5E;QACD;YACE,aAAa,EAAE,+CAA+C;YAC9D,OAAO,EAAE,8EAA8E;SACxF;QACD;YACE,aAAa,EAAE,uDAAuD;YACtE,OAAO,EAAE,2KAA2K;SACrL;QACD;YACE,aAAa,EAAE,+CAA+C;YAC9D,OAAO,EAAE,0VAA0V;YACnW,YAAY,EAAE,2FAA2F;SAC1G;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,kDAAkD;YAC9D,QAAQ,EAAE,kUAAkU;SAC7U;QACD;YACE,UAAU,EAAE,wDAAwD;YACpE,QAAQ,EAAE,6OAA6O;SACxP;QACD;YACE,UAAU,EAAE,uCAAuC;YACnD,QAAQ,EAAE,uMAAuM;SAClN;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,6DAA6D;QACtE,KAAK,EAAE,0GAA0G;KAClH;IACD,eAAe,EAAE,0QAA0Q;IAC3R,cAAc,EAAE;QACd,gGAAgG;QAChG,+HAA+H;KAChI;IACD,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

@@ -155,6 +155,18 @@ const builtinDoc = {
         {
             "question": "Can readmatrix skip header rows?",
             "answer": "Yes. Use the `'NumHeaderLines'` option: `readmatrix('file.csv', 'NumHeaderLines', 1)` skips the first row. RunMat supports this same option."
+        },
+        {
+            "question": "How do I customise import options for `readmatrix` with `detectImportOptions`?",
+            "answer": "— Call `detectImportOptions` first, tweak the returned struct, then pass it to `readmatrix` as the second argument. For example: `opts = detectImportOptions('data.csv'); opts.DataLines = [4 Inf]; opts.Delimiter = ','; A = readmatrix('data.csv', opts);`. This is the MATLAB-recommended workflow when the file needs more than a couple of overrides, and RunMat accepts the same option struct directly."
+        },
+        {
+            "question": "How do I read a UTF-8 CSV file that starts with a byte-order mark?",
+            "answer": "— `readmatrix` reads UTF-8 by default and silently strips a leading UTF-8 BOM (`EF BB BF`), so no extra option is needed. In MATLAB you can also make the encoding explicit with `readmatrix('data.csv', 'Encoding', 'UTF-8')`. For other encodings, convert the file to UTF-8 up front (for example with `iconv`) or read it via `fileread` and parse the result manually."
+        },
+        {
+            "question": "Which MATLAB release introduced `readmatrix`?",
+            "answer": "— MATLAB introduced `readmatrix` in **R2019a** as the modern replacement for `csvread`/`dlmread`. RunMat supports it today with no release gate, so you can call `readmatrix` regardless of the MATLAB version you normally target."
         }
     ],
     "links": [
@@ -202,6 +214,18 @@ const builtinDoc = {
     "gpu_behavior": [
         "`readmatrix` always executes on the host CPU. If the file name or option arguments are GPU-resident scalars, RunMat gathers them automatically before accessing the filesystem. The resulting matrix is created in host memory unless you pass `'Like', gpuPrototype`, in which case the parsed tensor is uploaded to the same provider so subsequent operations remain on the device. Acceleration providers do not need bespoke hooks for this builtin."
     ],
+    "syntax": {
+        "example": {
+            "description": "Syntax",
+            "input": "A = readmatrix(filename)\nA = readmatrix(filename, opts)\nA = readmatrix(filename, Name, Value)\n[A, delimiter] = readmatrix(___)"
+        },
+        "points": [
+            "`filename` is a character vector or string scalar pointing at the data file. Text (`.csv`, `.tsv`, `.txt`, `.dat`) is fully supported; spreadsheet formats (`.xls`, `.xlsx`) follow MATLAB's signature where available.",
+            "`opts` is an import-options struct (typically produced by `detectImportOptions`) that captures delimiter, header, type, and range settings in one place.",
+            "Common Name-Value pairs include `'NumHeaderLines'` (skip leading non-data rows), `'Delimiter'` (explicit column separator), `'Range'` (`\"B2:E10\"` or `[rowStart colStart rowEnd colEnd]`), `'Sheet'` (for spreadsheets), `'FileType'` (override detection), and `'Encoding'` (e.g. `'UTF-8'`).",
+            "Returns `A`, a double-precision matrix. MATLAB also offers an optional `delimiter` second output so you can discover the delimiter that was inferred from the file."
+        ]
+    },
     "key": "readmatrix",
     "slug": "readmatrix",
     "categoryPath": [

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

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

package/dist/generated/builtins/replace.js

@@ -75,8 +75,8 @@ const builtinDoc = {
         },
         {
             "description": "Replace text stored inside a cell array of strings",
-            "input": "cells = { \"Snapshot\", \"Ignition Interpreter\" };\nrenamed = replace(cells, \" \", \"_\")",
-            "output": "renamed = 1×2 cell array\n    {\"Snapshot\"}    {\"Ignition_Interpreter\"}"
+            "input": "cells = { \"Snapshot\", \"VM Interpreter\" };\nrenamed = replace(cells, \" \", \"_\")",
+            "output": "renamed = 1×2 cell array\n    {\"Snapshot\"}    {\"VM_Interpreter\"}"
         },
         {
             "description": "Preserve missing strings during replacement",

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

@@ -1 +1 @@
-{"version":3,"file":"replace.js","sourceRoot":"","sources":["../../../src/generated/builtins/replace.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"replace.js","sourceRoot":"","sources":["../../../src/generated/builtins/replace.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,mBAAmB;IAC/B,UAAU,EAAE;QACV,SAAS;QACT,mBAAmB;QACnB,gBAAgB;QAChB,QAAQ;QACR,cAAc;QACd,yBAAyB;KAC1B;IACD,SAAS,EAAE,8EAA8E;IACzF,YAAY,EAAE;QACZ,wDAAwD;KACzD;IACD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,mFAAmF;KAC7F;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,8CAA8C;QACtD,aAAa,EAAE,gFAAgF;KAChG;IACD,aAAa,EAAE,sVAAsV;IACrW,WAAW,EAAE;QACX,0FAA0F;QAC1F,kEAAkE;QAClE,uKAAuK;QACvK,2JAA2J;QAC3J,wMAAwM;QACxM,kGAAkG;KACnG;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,6CAA6C;YAC5D,OAAO,EAAE,qGAAqG;YAC9G,QAAQ,EAAE,wDAAwD;SACnE;QACD;YACE,aAAa,EAAE,0CAA0C;YACzD,OAAO,EAAE,sHAAsH;YAC/H,QAAQ,EAAE,qEAAqE;SAChF;QACD;YACE,aAAa,EAAE,kEAAkE;YACjF,OAAO,EAAE,yEAAyE;YAClF,QAAQ,EAAE,uDAAuD;SAClE;QACD;YACE,aAAa,EAAE,uDAAuD;YACtE,OAAO,EAAE,sGAAsG;YAC/G,QAAQ,EAAE,uEAAuE;SAClF;QACD;YACE,aAAa,EAAE,gDAAgD;YAC/D,OAAO,EAAE,sFAAsF;YAC/F,QAAQ,EAAE,4CAA4C;SACvD;QACD;YACE,aAAa,EAAE,4DAA4D;YAC3E,OAAO,EAAE,0HAA0H;YACnI,QAAQ,EAAE,yDAAyD;SACpE;QACD;YACE,aAAa,EAAE,oDAAoD;YACnE,OAAO,EAAE,uFAAuF;YAChG,QAAQ,EAAE,sEAAsE;SACjF;QACD;YACE,aAAa,EAAE,6CAA6C;YAC5D,OAAO,EAAE,kGAAkG;YAC3G,QAAQ,EAAE,iEAAiE;SAC5E;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,oDAAoD;YAChE,QAAQ,EAAE,kMAAkM;SAC7M;QACD;YACE,UAAU,EAAE,2CAA2C;YACvD,QAAQ,EAAE,yGAAyG;SACpH;QACD;YACE,UAAU,EAAE,oDAAoD;YAChE,QAAQ,EAAE,qKAAqK;SAChL;QACD;YACE,UAAU,EAAE,kCAAkC;YAC9C,QAAQ,EAAE,iIAAiI;SAC5I;QACD;YACE,UAAU,EAAE,qCAAqC;YACjD,QAAQ,EAAE,sGAAsG;SACjH;QACD;YACE,UAAU,EAAE,6CAA6C;YACzD,QAAQ,EAAE,6GAA6G;SACxH;QACD;YACE,UAAU,EAAE,0CAA0C;YACtD,QAAQ,EAAE,kMAAkM;SAC7M;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,cAAc;YACvB,KAAK,EAAE,gBAAgB;SACxB;QACD;YACE,OAAO,EAAE,gBAAgB;YACzB,KAAK,EAAE,kBAAkB;SAC1B;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,mEAAmE;QAC5E,KAAK,EAAE,gHAAgH;KACxH;IACD,eAAe,EAAE,oTAAoT;IACrU,cAAc,EAAE;QACd,gWAAgW;KACjW;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,cAAc,EAAE;QACd,SAAS;QACT,WAAW;KACZ;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/round.js

@@ -110,6 +110,14 @@ const builtinDoc = {
         {
             "question": "Does round support GPU acceleration in RunMat?",
             "answer": "Yes. `round` runs on the GPU with elementwise fusion support. It accepts `f32` and `f64` precisions and supports MATLAB-compatible broadcasting."
+        },
+        {
+            "question": "Does MATLAB's `round` use banker's rounding?",
+            "answer": "— **No.** MATLAB (and RunMat) round halves *away from zero*, not to even. So `round(0.5)` returns `1`, `round(-0.5)` returns `-1`, `round(2.5)` returns `3`, and `round(3.5)` returns `4`. This differs from Python's built-in `round` and IEEE 754 default rounding, which both use banker's rounding (round-half-to-even). NumPy's `np.round` also uses banker's rounding, so ported code may give different results on `.5` cases — use `round(x)` in MATLAB/RunMat when you specifically want half-away-from-zero."
+        },
+        {
+            "question": "How do I round to N decimal places?",
+            "answer": "— Use `round(X, N)`. Positive `N` rounds to digits to the right of the decimal point; negative `N` rounds to digits to the left. For example, `round(pi, 3)` returns `3.1416` and `round(12345, -3)` returns `12000`. Use `round(X, N, 'significant')` when you want `N` significant digits instead of decimal places."
         }
     ],
     "links": [
@@ -150,6 +158,18 @@ const builtinDoc = {
     "gpu_behavior": [
         "When a tensor already resides on the GPU, RunMat checks whether the active acceleration provider implements a specialised `unary_round` kernel. If available, `round(X)` executes entirely on the device. Advanced modes (`round(X, N)` and `round(X, N, 'significant')`) currently gather tensors to the host before rounding to keep semantics aligned with MATLAB. Providers that add digit-aware kernels can extend this path in the future."
     ],
+    "syntax": {
+        "example": {
+            "description": "Syntax",
+            "input": "Y = round(X)\nY = round(X, N)\nY = round(X, N, type)"
+        },
+        "points": [
+            "`X` is the numeric (or `duration`) input to round. Scalars, vectors, matrices, and N-D arrays are all accepted. Complex values are rounded component-wise; non-finite values (`NaN`, `Inf`) pass through unchanged.",
+            "`N` is an integer specifying the number of digits. When `type` is `'decimals'` (the default), positive `N` rounds to digits right of the decimal point and negative `N` rounds to digits left of it (tens, hundreds, thousands, ...). When `type` is `'significant'`, `N` must be a positive integer.",
+            "`type` is an optional string: `'decimals'` (default) or `'significant'`. `'significant'` rounds to `N` significant digits regardless of magnitude.",
+            "Returns `Y`, the rounded values, same shape and (promoted) class as `X`. Half values are rounded away from zero — MATLAB's `round` does **not** use banker's rounding."
+        ]
+    },
     "key": "round",
     "slug": "round",
     "categoryPath": [

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

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

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

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

package/dist/generated/builtins/scatter.js

@@ -55,6 +55,20 @@ const builtinDoc = {
             "input": "x = 1:10;\nh1 = scatter(x, x);\nset(h1, 'DisplayName', 'linear');\nhold on;\nh2 = scatter(x, x.^2);\nset(h2, 'DisplayName', 'quadratic');\nlegend;"
         }
     ],
+    "faqs": [
+        {
+            "question": "How do I color scatter points by a third variable?",
+            "answer": "Set the `CData` property on the scatter handle to a vector the same length as x and y. The values map into the current colormap.\n\n```matlab\nx = randn(1, 100);\ny = randn(1, 100);\nz = x.^2 + y.^2;\nh = scatter(x, y);\nset(h, 'CData', z);\ncolorbar;\n```\n\nEach point gets a color proportional to its `z` value. Call `colorbar` to show the mapping."
+        },
+        {
+            "question": "What's the difference between scatter and plot?",
+            "answer": "`scatter` draws unconnected markers and supports per-point size (`SizeData`) and per-point color (`CData`). `plot` connects points with lines and applies uniform styling to the whole series. Use `scatter` when the individual point properties carry meaning; use `plot` when the connection between points is what matters."
+        },
+        {
+            "question": "How do I control marker size in scatter?",
+            "answer": "Pass a scalar or vector to `SizeData` via the handle. A scalar sets uniform size; a vector sets per-point sizes.\n\n```matlab\nh = scatter(x, y);\nset(h, 'SizeData', 40);          % uniform size\nset(h, 'SizeData', abs(y) * 50); % size proportional to |y|\n```\n\nThe size unit is points squared, matching MATLAB conventions."
+        }
+    ],
     "links": [
         {
             "label": "plot",
@@ -75,6 +89,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/scatter.js.map

@@ -1 +1 @@
-{"version":3,"file":"scatter.js","sourceRoot":"","sources":["../../../src/generated/builtins/scatter.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,aAAa;QACb,aAAa;QACb,gBAAgB;QAChB,2BAA2B;KAC5B;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,kJAAkJ;KAC5J;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,sTAAsT;IACrU,WAAW,EAAE;QACX,iEAAiE;QACjE,0GAA0G;QAC1G,wHAAwH;QACxH,sIAAsI;QACtI,6KAA6K;KAC9K;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,iCAAiC;YAChD,OAAO,EAAE,uDAAuD;SACjE;QACD;YACE,aAAa,EAAE,6CAA6C;YAC5D,OAAO,EAAE,wHAAwH;SAClI;QACD;YACE,aAAa,EAAE,oDAAoD;YACnE,OAAO,EAAE,oJAAoJ;SAC9J;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,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,8DAA8D;QACvE,KAAK,EAAE,2GAA2G;KACnH;IACD,eAAe,EAAE,wPAAwP;IACzQ,cAAc,EAAE;QACd,8HAA8H;QAC9H,yGAAyG;KAC1G;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"scatter.js","sourceRoot":"","sources":["../../../src/generated/builtins/scatter.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,aAAa;QACb,aAAa;QACb,gBAAgB;QAChB,2BAA2B;KAC5B;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,kJAAkJ;KAC5J;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,sTAAsT;IACrU,WAAW,EAAE;QACX,iEAAiE;QACjE,0GAA0G;QAC1G,wHAAwH;QACxH,sIAAsI;QACtI,6KAA6K;KAC9K;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,iCAAiC;YAChD,OAAO,EAAE,uDAAuD;SACjE;QACD;YACE,aAAa,EAAE,6CAA6C;YAC5D,OAAO,EAAE,wHAAwH;SAClI;QACD;YACE,aAAa,EAAE,oDAAoD;YACnE,OAAO,EAAE,oJAAoJ;SAC9J;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,oDAAoD;YAChE,QAAQ,EAAE,iWAAiW;SAC5W;QACD;YACE,UAAU,EAAE,iDAAiD;YAC7D,QAAQ,EAAE,iUAAiU;SAC5U;QACD;YACE,UAAU,EAAE,0CAA0C;YACtD,QAAQ,EAAE,uUAAuU;SAClV;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,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,8DAA8D;QACvE,KAAK,EAAE,2GAA2G;KACnH;IACD,eAAe,EAAE,wPAAwP;IACzQ,cAAc,EAAE;QACd,8HAA8H;QAC9H,yGAAyG;KAC1G;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/scatter3.js

@@ -12,6 +12,7 @@ const builtinDoc = {
         "gpu plotting"
     ],
     "summary": "Create 3-D scatter plots for spatial point clouds, encoded markers, and MATLAB `scatter3` workflows.",
+    "hero_image": "https://web.runmatstatic.com/builtin-image/runmat-matlab-plot-scatter3-3D-point-cloud.webp",
     "gpu_support": {
         "elementwise": false,
         "reduction": false,
@@ -54,6 +55,25 @@ const builtinDoc = {
             "description": "Use subplot-local camera state with multiple 3-D plots",
             "input": "subplot(1, 2, 1);\nscatter3(1:10, rand(1,10), rand(1,10));\nview(3);\nsubplot(1, 2, 2);\nscatter3(rand(1,10), rand(1,10), rand(1,10));\nview(2);",
             "output": "% The two subplots keep independent 3-D view state"
+        },
+        {
+            "description": "3D point cloud with color-coded altitude",
+            "input": "n = 2000;\ntheta = 4*pi*rand(1, n);\nr = sqrt(rand(1, n));\nx = r .* cos(theta);\ny = r .* sin(theta);\nz = sin(3*r) ./ (1 + r);\n\nscatter3(x, y, z, 12, z, 'filled');\ncolormap('turbo');\ncolorbar;\ntitle('3-D Point Cloud — Altitude Encoded');\nxlabel('x');\nylabel('y');\nzlabel('z');\nview(35, 25);\ngrid on;",
+            "image_webp": "https://web.runmatstatic.com/builtin-image/runmat-matlab-plot-scatter3-3D-point-cloud.webp"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "How do I size scatter3 points by a data variable?",
+            "answer": "Pass a size vector as the fourth argument. Each element controls the marker area for the corresponding point.\n\n```matlab\nt = linspace(0, 4*pi, 200);\nsizes = linspace(5, 50, 200);\nscatter3(cos(t), sin(t), t, sizes);\n```\n\nA scalar fourth argument sets all points to the same size."
+        },
+        {
+            "question": "Can I color scatter3 points by a fourth variable?",
+            "answer": "Pass a color vector as the fifth argument after the size vector. Each value maps through the active colormap. Add `colorbar` to show the mapping.\n\n```matlab\nscatter3(x, y, z, 20, myValues);\ncolormap('turbo');\ncolorbar;\n```"
+        },
+        {
+            "question": "How do I rotate or orbit a scatter3 plot?",
+            "answer": "Use `view(az, el)` to set the camera angle programmatically. `az` is the horizontal orbit in degrees, `el` is the vertical tilt. `view(3)` gives the standard 3-D default. Each subplot keeps its own independent camera state, so you can show the same data from multiple angles in a subplot grid."
         }
     ],
     "links": [
@@ -76,6 +96,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/scatter3.js.map

@@ -1 +1 @@
-{"version":3,"file":"scatter3.js","sourceRoot":"","sources":["../../../src/generated/builtins/scatter3.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,kBAAkB;QAClB,aAAa;QACb,iBAAiB;QACjB,4BAA4B;QAC5B,cAAc;KACf;IACD,SAAS,EAAE,sGAAsG;IACjH,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,kIAAkI;KAC5I;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,mVAAmV;IAClW,WAAW,EAAE;QACX,+EAA+E;QAC/E,mEAAmE;QACnE,wGAAwG;QACxG,kIAAkI;QAClI,8GAA8G;KAC/G;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,mCAAmC;YAClD,OAAO,EAAE,2DAA2D;SACrE;QACD;YACE,aAAa,EAAE,qDAAqD;YACpE,OAAO,EAAE,+HAA+H;SACzI;QACD;YACE,aAAa,EAAE,wDAAwD;YACvE,OAAO,EAAE,kJAAkJ;YAC3J,QAAQ,EAAE,oDAAoD;SAC/D;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,+DAA+D;QACxE,KAAK,EAAE,4GAA4G;KACpH;IACD,eAAe,EAAE,yPAAyP;IAC1Q,cAAc,EAAE;QACd,wHAAwH;QACxH,gGAAgG;KACjG;IACD,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"scatter3.js","sourceRoot":"","sources":["../../../src/generated/builtins/scatter3.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,kBAAkB;QAClB,aAAa;QACb,iBAAiB;QACjB,4BAA4B;QAC5B,cAAc;KACf;IACD,SAAS,EAAE,sGAAsG;IACjH,YAAY,EAAE,4FAA4F;IAC1G,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,kIAAkI;KAC5I;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,mVAAmV;IAClW,WAAW,EAAE;QACX,+EAA+E;QAC/E,mEAAmE;QACnE,wGAAwG;QACxG,kIAAkI;QAClI,8GAA8G;KAC/G;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,mCAAmC;YAClD,OAAO,EAAE,2DAA2D;SACrE;QACD;YACE,aAAa,EAAE,qDAAqD;YACpE,OAAO,EAAE,+HAA+H;SACzI;QACD;YACE,aAAa,EAAE,wDAAwD;YACvE,OAAO,EAAE,kJAAkJ;YAC3J,QAAQ,EAAE,oDAAoD;SAC/D;QACD;YACE,aAAa,EAAE,0CAA0C;YACzD,OAAO,EAAE,yTAAyT;YAClU,YAAY,EAAE,4FAA4F;SAC3G;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,mDAAmD;YAC/D,QAAQ,EAAE,gSAAgS;SAC3S;QACD;YACE,UAAU,EAAE,mDAAmD;YAC/D,QAAQ,EAAE,sOAAsO;SACjP;QACD;YACE,UAAU,EAAE,2CAA2C;YACvD,QAAQ,EAAE,uSAAuS;SAClT;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;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,+DAA+D;QACxE,KAAK,EAAE,4GAA4G;KACpH;IACD,eAAe,EAAE,yPAAyP;IAC1Q,cAAc,EAAE;QACd,wHAAwH;QACxH,gGAAgG;KACjG;IACD,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/semilogx.js

@@ -53,6 +53,20 @@ const builtinDoc = {
             "output": "ans =\n    'log'"
         }
     ],
+    "faqs": [
+        {
+            "question": "When should I use semilogx instead of plot?",
+            "answer": "Use `semilogx` when your x-data spans several orders of magnitude and you care about relative differences across that range. Frequency response curves (Bode magnitude plots) are the classic example — frequencies from 1 Hz to 100 kHz are unreadable on a linear axis but spread evenly on a log scale."
+        },
+        {
+            "question": "How is semilogx different from calling plot and then switching the x-axis to log?",
+            "answer": "Functionally identical. `semilogx(x, y)` is shorthand for `plot(x, y)` followed by `set(gca, 'XScale', 'log')`. The convenience form just does both in one call and makes intent clearer when reading code."
+        },
+        {
+            "question": "What happens if my x-data contains zero or negative values?",
+            "answer": "Logarithmic axes only render positive values. Zero and negative x-values are silently excluded from the rendered line — the data handle still holds them, but they won't appear on the plot. Filter your data to the positive domain if you need a continuous curve."
+        }
+    ],
     "links": [
         {
             "label": "plot",
@@ -69,6 +83,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/semilogx.js.map

@@ -1 +1 @@
-{"version":3,"file":"semilogx.js","sourceRoot":"","sources":["../../../src/generated/builtins/semilogx.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,oBAAoB;QACpB,cAAc;QACd,iBAAiB;QACjB,gBAAgB;KACjB;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,sGAAsG;KAChH;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;KAC9C;IACD,aAAa,EAAE,sRAAsR;IACrS,WAAW,EAAE;QACX,qEAAqE;QACrE,sEAAsE;QACtE,2HAA2H;QAC3H,6JAA6J;KAC9J;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,qDAAqD;YACpE,OAAO,EAAE,iFAAiF;SAC3F;QACD;YACE,aAAa,EAAE,kDAAkD;YACjE,OAAO,EAAE,gOAAgO;SAC1O;QACD;YACE,aAAa,EAAE,2DAA2D;YAC1E,OAAO,EAAE,+EAA+E;YACxF,QAAQ,EAAE,kBAAkB;SAC7B;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,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,+DAA+D;QACxE,KAAK,EAAE,4GAA4G;KACpH;IACD,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"semilogx.js","sourceRoot":"","sources":["../../../src/generated/builtins/semilogx.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,oBAAoB;QACpB,cAAc;QACd,iBAAiB;QACjB,gBAAgB;KACjB;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,sGAAsG;KAChH;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;KAC9C;IACD,aAAa,EAAE,sRAAsR;IACrS,WAAW,EAAE;QACX,qEAAqE;QACrE,sEAAsE;QACtE,2HAA2H;QAC3H,6JAA6J;KAC9J;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,qDAAqD;YACpE,OAAO,EAAE,iFAAiF;SAC3F;QACD;YACE,aAAa,EAAE,kDAAkD;YACjE,OAAO,EAAE,gOAAgO;SAC1O;QACD;YACE,aAAa,EAAE,2DAA2D;YAC1E,OAAO,EAAE,+EAA+E;YACxF,QAAQ,EAAE,kBAAkB;SAC7B;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,6CAA6C;YACzD,QAAQ,EAAE,4SAA4S;SACvT;QACD;YACE,UAAU,EAAE,mFAAmF;YAC/F,QAAQ,EAAE,6MAA6M;SACxN;QACD;YACE,UAAU,EAAE,6DAA6D;YACzE,QAAQ,EAAE,sQAAsQ;SACjR;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,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,+DAA+D;QACxE,KAAK,EAAE,4GAA4G;KACpH;IACD,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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