runmat 0.4.10-dev.1 → 0.4.10-dev.11

package/dist/generated/builtins/print.js

@@ -0,0 +1,112 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "print",
+    "category": "plotting",
+    "keywords": [
+        "print",
+        "figure export",
+        "png",
+        "plotting",
+        "save figure"
+    ],
+    "summary": "Export figures to files in MATLAB and RunMat.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "`print` is a figure export sink. It gathers filename and option arguments when needed, then serializes the figure through the plotting renderer. Existing GPU-backed plot geometry can still use the shared WGPU plotting path during export."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 4,
+        "constants": "inline"
+    },
+    "requires_feature": "plot-core",
+    "tested": {
+        "unit": "builtins::plotting::print::tests",
+        "integration": "direct headless Chrome WASM verification of print.json examples"
+    },
+    "description": "`print` exports the active or specified figure to files. Device tokens, resolution options, and argument forms follow MATLAB-style `print` semantics in RunMat.",
+    "behaviors": [
+        "`print(filename, '-dpng')` writes PNG bytes to `filename`. If the name has no `.png` extension, RunMat appends one.",
+        "`print(filename, '-dpng', '-rN')` scales the export dimensions from the default 800 by 600 canvas using `N` DPI relative to RunMat's 150 DPI default.",
+        "`print(fig, filename, '-dpng')` exports the specified figure handle instead of the active figure.",
+        "Command-style argument order is accepted when RunMat parses command calls into string arguments, such as `print -dpng plot.png`.",
+        "PDF, EPS, and SVG device tokens are recognized but return a clear unsupported-device error until those exporters are implemented."
+    ],
+    "examples": [
+        {
+            "description": "Export the active figure to a PNG file",
+            "input": "x = 0:0.1:2*pi;\nplot(x, sin(x));\nprint(\"sine_plot\", \"-dpng\");"
+        },
+        {
+            "description": "Export at a higher resolution",
+            "input": "x = 0:0.1:1;\nplot(x, x.^2, \"LineWidth\", 2);\nprint(\"quadratic_plot\", \"-dpng\", \"-r300\");"
+        },
+        {
+            "description": "Export a specific figure handle",
+            "input": "fig = figure();\nplot(1:5, [1 4 2 5 3]);\nprint(fig, \"explicit_handle_plot.png\", \"-dpng\");"
+        },
+        {
+            "description": "Command-style device order",
+            "input": "plot(1:4, [1 3 2 4]);\nprint -dpng command_style_plot.png"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Which formats does `print` support?",
+            "answer": "PNG is supported today with `-dpng`. RunMat recognizes PDF, EPS, and SVG device tokens, but they return an unsupported-device error until those exporters are available in the rendering stack."
+        },
+        {
+            "question": "Where does the file go in the browser?",
+            "answer": "The PNG is written through RunMat's filesystem provider. In the sandbox this is usually the in-memory or IndexedDB-backed virtual filesystem, and the host can expose the file as a download artifact."
+        },
+        {
+            "question": "Does `-r300` change the figure data?",
+            "answer": "No. It only changes the pixel dimensions used for export. The plot data and graphics handles remain unchanged."
+        }
+    ],
+    "links": [
+        {
+            "label": "figure",
+            "url": "./figure"
+        },
+        {
+            "label": "gcf",
+            "url": "./gcf"
+        },
+        {
+            "label": "plot",
+            "url": "./plot"
+        },
+        {
+            "label": "Plot replay and export",
+            "url": "/docs/plotting/plot-replay-and-export"
+        },
+        {
+            "label": "Complete plotting guide",
+            "url": "/blog/matlab-plotting-guide"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/plotting/ops/print.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/plotting/ops/print.rs"
+    },
+    "gpu_residency": "`print` is an I/O sink and returns a host logical status. Filename and option arguments are gathered before parsing. GPU-resident plot data already captured in figure state may still be consumed by the plotting renderer without forcing user-visible gathers when the shared WGPU export path is available.",
+    "gpu_behavior": [
+        "No numeric GPU kernels are launched for `print` itself.",
+        "The PNG exporter first attempts the interactive GPU render path and falls back to CPU rasterization when headless GPU initialization is unavailable.",
+        "The builtin writes PNG bytes through RunMat's filesystem layer, so output storage is host or virtual-filesystem backed."
+    ],
+    "key": "print",
+    "slug": "print",
+    "aliases": [],
+    "categoryPath": [
+        "plotting"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=print.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"print.js","sourceRoot":"","sources":["../../../src/generated/builtins/print.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,KAAK;QACL,UAAU;QACV,aAAa;KACd;IACD,SAAS,EAAE,+CAA+C;IAC1D,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,+OAA+O;KACzP;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;KACtB;IACD,kBAAkB,EAAE,WAAW;IAC/B,QAAQ,EAAE;QACR,MAAM,EAAE,kCAAkC;QAC1C,aAAa,EAAE,iEAAiE;KACjF;IACD,aAAa,EAAE,iKAAiK;IAChL,WAAW,EAAE;QACX,qHAAqH;QACrH,uJAAuJ;QACvJ,mGAAmG;QACnG,kIAAkI;QAClI,mIAAmI;KACpI;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,wCAAwC;YACvD,OAAO,EAAE,qEAAqE;SAC/E;QACD;YACE,aAAa,EAAE,+BAA+B;YAC9C,OAAO,EAAE,kGAAkG;SAC5G;QACD;YACE,aAAa,EAAE,iCAAiC;YAChD,OAAO,EAAE,gGAAgG;SAC1G;QACD;YACE,aAAa,EAAE,4BAA4B;YAC3C,OAAO,EAAE,2DAA2D;SACrE;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,qCAAqC;YACjD,QAAQ,EAAE,iMAAiM;SAC5M;QACD;YACE,UAAU,EAAE,wCAAwC;YACpD,QAAQ,EAAE,wMAAwM;SACnN;QACD;YACE,UAAU,EAAE,sCAAsC;YAClD,QAAQ,EAAE,gHAAgH;SAC3H;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;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,iTAAiT;IAClU,cAAc,EAAE;QACd,yDAAyD;QACzD,sJAAsJ;QACtJ,yHAAyH;KAC1H;IACD,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,OAAO;IACf,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/prod.js

@@ -10,7 +10,7 @@ const builtinDoc = {
         "omitnan",
         "gpu"
     ],
-    "summary": "Multiply elements of scalars, vectors, matrices, or N-D tensors with MATLAB-compatible options.",
+    "summary": "Multiply elements across dimensions in MATLAB and RunMat.",
     "references": [],
     "gpu_support": {
         "elementwise": false,
@@ -33,7 +33,7 @@ const builtinDoc = {
         "unit": "builtins::math::reduction::prod::tests",
         "integration": "builtins::math::reduction::prod::tests::prod_gpu_provider_roundtrip"
     },
-    "description": "`prod(X)` multiplies the elements of scalars, vectors, matrices, and higher-dimensional tensors. When no dimension is supplied, the reduction runs along the first non-singleton dimension.",
+    "description": "`prod(X)` multiplies elements of `X` along a selected dimension or across all elements. Default dimension behavior and option handling follow MATLAB semantics.",
     "behaviors": [
         "`prod(X)` on an `m × n` matrix returns a row vector (`1 × n`) with column-wise products.",
         "`prod(X, 2)` returns a column vector (`m × 1`) containing row-wise products.",

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

@@ -1 +1 @@
-{"version":3,"file":"prod.js","sourceRoot":"","sources":["../../../src/generated/builtins/prod.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"prod.js","sourceRoot":"","sources":["../../../src/generated/builtins/prod.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,MAAM;IACf,UAAU,EAAE,gBAAgB;IAC5B,UAAU,EAAE;QACV,MAAM;QACN,SAAS;QACT,WAAW;QACX,SAAS;QACT,KAAK;KACN;IACD,SAAS,EAAE,2DAA2D;IACtE,YAAY,EAAE,EAAE;IAChB,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,IAAI;QACjB,YAAY,EAAE;YACZ,KAAK;YACL,KAAK;SACN;QACD,cAAc,EAAE,QAAQ;QACxB,OAAO,EAAE,oIAAoI;KAC9I;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,IAAI;QACjB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;KACtB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,wCAAwC;QAChD,aAAa,EAAE,qEAAqE;KACrF;IACD,aAAa,EAAE,iKAAiK;IAChL,WAAW,EAAE;QACX,0FAA0F;QAC1F,8EAA8E;QAC9E,yIAAyI;QACzI,yEAAyE;QACzE,yIAAyI;QACzI,2IAA2I;QAC3I,8FAA8F;QAC9F,kGAAkG;QAClG,8HAA8H;QAC9H,2GAA2G;KAC5G;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,sCAAsC;YACrD,OAAO,EAAE,+DAA+D;YACxE,QAAQ,EAAE,0CAA0C;SACrD;QACD;YACE,aAAa,EAAE,wCAAwC;YACvD,OAAO,EAAE,sDAAsD;YAC/D,QAAQ,EAAE,kDAAkD;SAC7D;QACD;YACE,aAAa,EAAE,qCAAqC;YACpD,OAAO,EAAE,0DAA0D;YACnE,QAAQ,EAAE,eAAe;SAC1B;QACD;YACE,aAAa,EAAE,2DAA2D;YAC1E,OAAO,EAAE,yIAAyI;SACnJ;QACD;YACE,aAAa,EAAE,oDAAoD;YACnE,OAAO,EAAE,uBAAuB;YAChC,QAAQ,EAAE,aAAa;SACxB;QACD;YACE,aAAa,EAAE,qCAAqC;YACpD,OAAO,EAAE,2DAA2D;YACpE,QAAQ,EAAE,wBAAwB;SACnC;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,wCAAwC;YACpD,QAAQ,EAAE,mIAAmI;SAC9I;QACD;YACE,UAAU,EAAE,+CAA+C;YAC3D,QAAQ,EAAE,+HAA+H;SAC1I;QACD;YACE,UAAU,EAAE,6BAA6B;YACzC,QAAQ,EAAE,8JAA8J;SACzK;QACD;YACE,UAAU,EAAE,uDAAuD;YACnE,QAAQ,EAAE,oKAAoK;SAC/K;QACD;YACE,UAAU,EAAE,mEAAmE;YAC/E,QAAQ,EAAE,+FAA+F;SAC1G;QACD;YACE,UAAU,EAAE,uCAAuC;YACnD,QAAQ,EAAE,+JAA+J;SAC1K;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;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,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;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,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,+VAA+V;IAChX,cAAc,EAAE;QACd,ibAAib;KAClb;IACD,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IACd,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,WAAW;KACZ;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/pwd.js

@@ -9,7 +9,7 @@ const builtinDoc = {
         "working folder",
         "present working directory"
     ],
-    "summary": "Return the absolute path to the folder where RunMat is currently executing.",
+    "summary": "Return the current working folder path in MATLAB and RunMat.",
     "references": [],
     "gpu_support": {
         "elementwise": false,
@@ -29,7 +29,7 @@ const builtinDoc = {
         "unit": "builtins::io::repl_fs::pwd::tests",
         "integration": "builtins::io::repl_fs::pwd::tests::pwd_reflects_directory_changes"
     },
-    "description": "`pwd` returns the absolute path of the folder where RunMat is executing. The result is a character row vector (`1×N`) so existing MATLAB code that expects traditional character output keeps working.",
+    "description": "`pwd` returns the absolute path of the current working folder. Return type and path-format behavior follow MATLAB semantics.",
     "behaviors": [
         "Always returns the current working folder of the RunMat process.",
         "Output is a character vector using the platform-native path separators.",

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

@@ -1 +1 @@
-{"version":3,"file":"pwd.js","sourceRoot":"","sources":["../../../src/generated/builtins/pwd.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,KAAK;IACd,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE;QACV,KAAK;QACL,mBAAmB;QACnB,gBAAgB;QAChB,2BAA2B;KAC5B;IACD,SAAS,EAAE,6EAA6E;IACxF,YAAY,EAAE,EAAE;IAChB,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,gGAAgG;KAC1G;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,mEAAmE;KACnF;IACD,aAAa,EAAE,wMAAwM;IACvN,WAAW,EAAE;QACX,kEAAkE;QAClE,yEAAyE;QACzE,oKAAoK;QACpK,mFAAmF;QACnF,0IAA0I;KAC3I;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,iCAAiC;YAChD,OAAO,EAAE,+BAA+B;YACxC,QAAQ,EAAE,GAAG;SACd;QACD;YACE,aAAa,EAAE,gDAAgD;YAC/D,OAAO,EAAE,yJAAyJ;YAClK,QAAQ,EAAE,qDAAqD;SAChE;QACD;YACE,aAAa,EAAE,iDAAiD;YAChE,OAAO,EAAE,sEAAsE;YAC/E,QAAQ,EAAE,+HAA+H;SAC1I;QACD;YACE,aAAa,EAAE,mCAAmC;YAClD,OAAO,EAAE,2CAA2C;YACpD,QAAQ,EAAE,4CAA4C;SACvD;QACD;YACE,aAAa,EAAE,8CAA8C;YAC7D,OAAO,EAAE,kHAAkH;YAC3H,QAAQ,EAAE,gEAAgE;SAC3E;QACD;YACE,aAAa,EAAE,sDAAsD;YACrE,OAAO,EAAE,kEAAkE;YAC3E,QAAQ,EAAE,+JAA+J;SAC1K;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,+DAA+D;YAC3E,QAAQ,EAAE,uKAAuK;SAClL;QACD;YACE,UAAU,EAAE,4CAA4C;YACxD,QAAQ,EAAE,oGAAoG;SAC/G;QACD;YACE,UAAU,EAAE,iBAAiB;YAC7B,QAAQ,EAAE,iKAAiK;SAC5K;QACD;YACE,UAAU,EAAE,gCAAgC;YAC5C,QAAQ,EAAE,iFAAiF;SAC5F;QACD;YACE,UAAU,EAAE,+CAA+C;YAC3D,QAAQ,EAAE,oFAAoF;SAC/F;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,MAAM;SACd;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;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,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,MAAM;SACd;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;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;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,wDAAwD;QACjE,KAAK,EAAE,qGAAqG;KAC7G;IACD,eAAe,EAAE,4NAA4N;IAC7O,cAAc,EAAE;QACd,+aAA+a;KAChb;IACD,KAAK,EAAE,KAAK;IACZ,MAAM,EAAE,KAAK;IACb,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,IAAI;QACJ,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"pwd.js","sourceRoot":"","sources":["../../../src/generated/builtins/pwd.ts"],"names":[],"mappings":"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"}

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

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

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

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

package/dist/generated/builtins/qammod.js

@@ -0,0 +1,106 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "qammod",
+    "category": "comms/modulation",
+    "keywords": [
+        "qammod",
+        "qam",
+        "modulation",
+        "communications",
+        "gray",
+        "binary",
+        "constellation",
+        "gpu"
+    ],
+    "summary": "Map integers to QAM constellation points in MATLAB and RunMat.",
+    "references": [],
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f32",
+            "f64",
+            "i32",
+            "bool"
+        ],
+        "broadcasting": "none",
+        "notes": "gpuArray inputs are gathered through the active provider and modulated on the host because RunMat does not yet represent complex-valued GPU tensor handles. The result is a host ComplexTensor."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 1,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::comms::qammod::tests"
+    },
+    "description": "`qammod(X, M)` maps integer symbols `X` to complex QAM constellation points for modulation order `M`. Gray, binary, and custom symbol-ordering behavior follow MATLAB semantics.",
+    "behaviors": [
+        "`X` must contain finite integer values in the inclusive range `[0, M-1]`.",
+        "`M` must be a power-of-two integer greater than one.",
+        "Square QAM orders such as 4, 16, 64, and 256 use symmetric odd integer amplitudes with minimum distance two.",
+        "Non-square power-of-two orders use a rectangular grid with the larger dimension on the in-phase axis.",
+        "The default `'gray'` order applies Gray coding independently to the in-phase and quadrature grid indexes.",
+        "`'UnitAveragePower', true` scales the complete constellation so its average power is one.",
+        "`'OutputDataType', 'single'` rounds the real and imaginary samples through single precision before returning the host complex tensor.",
+        "`'PlotConstellation', true` and `InputType='bit'` are not implemented yet."
+    ],
+    "examples": [
+        {
+            "description": "Default 16-QAM Gray mapping",
+            "input": "y = qammod(0:15, 16)",
+            "output": "y = [-3+3i -3+1i -3-3i -3-1i -1+3i -1+1i -1-3i -1-1i 3+3i 3+1i 3-3i 3-1i 1+3i 1+1i 1-3i 1-1i]"
+        },
+        {
+            "description": "Binary symbol ordering",
+            "input": "y = qammod(0:4, 16, 'bin')",
+            "output": "y = [-3+3i -3+1i -3-1i -3-3i -1+3i]"
+        },
+        {
+            "description": "Unit-average-power 16-QAM",
+            "input": "y = qammod(0:15, 16, 'UnitAveragePower', true);\nmean(abs(y).^2)",
+            "output": "ans = 1"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does qammod execute on the GPU?",
+            "answer": "It accepts gpuArray inputs, but the current runtime gathers them to host memory and returns a host ComplexTensor because complex GPU tensor handles are not yet part of RunMat's value model."
+        },
+        {
+            "question": "Is bit input supported?",
+            "answer": "Not in this first implementation. Use integer symbols or convert bit groups to integer symbols before calling qammod."
+        }
+    ],
+    "links": [
+        {
+            "label": "gpuArray",
+            "url": "./gpuarray"
+        },
+        {
+            "label": "gather",
+            "url": "./gather"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/comms/qammod.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/comms/qammod.rs"
+    },
+    "gpu_residency": "The builtin declares `GatherImmediately` residency. A gpuArray input is downloaded once through the dispatcher and then mapped to complex host output.",
+    "gpu_behavior": [
+        "RunMat's current accelerator API stores real-valued GPU buffers. Since `qammod` necessarily produces complex-valued samples, the GPU-aware implementation preserves correctness by gathering device input and producing a `ComplexTensor` on the host.",
+        "The registered GPU metadata advertises the supported input scalar classes and the provider hook name future accelerators can use once complex GPU outputs are represented."
+    ],
+    "key": "qammod",
+    "slug": "qammod",
+    "aliases": [],
+    "categoryPath": [
+        "comms",
+        "modulation"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=qammod.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"qammod.js","sourceRoot":"","sources":["../../../src/generated/builtins/qammod.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,QAAQ;IACjB,UAAU,EAAE,kBAAkB;IAC9B,UAAU,EAAE;QACV,QAAQ;QACR,KAAK;QACL,YAAY;QACZ,gBAAgB;QAChB,MAAM;QACN,QAAQ;QACR,eAAe;QACf,KAAK;KACN;IACD,SAAS,EAAE,gEAAgE;IAC3E,YAAY,EAAE,EAAE;IAChB,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;YACL,KAAK;YACL,KAAK;YACL,MAAM;SACP;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,iMAAiM;KAC3M;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,gCAAgC;KACzC;IACD,aAAa,EAAE,kLAAkL;IACjM,WAAW,EAAE;QACX,2EAA2E;QAC3E,sDAAsD;QACtD,8GAA8G;QAC9G,uGAAuG;QACvG,2GAA2G;QAC3G,2FAA2F;QAC3F,uIAAuI;QACvI,4EAA4E;KAC7E;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,6BAA6B;YAC5C,OAAO,EAAE,sBAAsB;YAC/B,QAAQ,EAAE,+FAA+F;SAC1G;QACD;YACE,aAAa,EAAE,wBAAwB;YACvC,OAAO,EAAE,4BAA4B;YACrC,QAAQ,EAAE,qCAAqC;SAChD;QACD;YACE,aAAa,EAAE,2BAA2B;YAC1C,OAAO,EAAE,kEAAkE;YAC3E,QAAQ,EAAE,SAAS;SACpB;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,iCAAiC;YAC7C,QAAQ,EAAE,+LAA+L;SAC1M;QACD;YACE,UAAU,EAAE,yBAAyB;YACrC,QAAQ,EAAE,uHAAuH;SAClI;KACF;IACD,OAAO,EAAE;QACP;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,sDAAsD;QAC/D,KAAK,EAAE,mGAAmG;KAC3G;IACD,eAAe,EAAE,wJAAwJ;IACzK,cAAc,EAAE;QACd,wPAAwP;QACxP,4KAA4K;KAC7K;IACD,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,YAAY;KACb;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/qr.js

@@ -10,7 +10,7 @@ const builtinDoc = {
         "householder",
         "pivoting"
     ],
-    "summary": "QR factorization with optional column pivoting and economy-size outputs.",
+    "summary": "Compute QR factorizations in MATLAB and RunMat.",
     "references": [],
     "gpu_support": {
         "elementwise": false,
@@ -32,7 +32,7 @@ const builtinDoc = {
         "unit": "builtins::math::linalg::factor::qr::tests",
         "integration": "builtins::math::linalg::factor::qr::tests::qr_three_outputs_reconstructs_input"
     },
-    "description": "`qr(A)` computes an orthogonal (or unitary)–upper-triangular factorization of a real or complex matrix `A`. It matches MATLAB’s dense semantics, supporting full-size, economy-size, and column-pivoted variants.",
+    "description": "`qr(A)` computes orthogonal/unitary-upper-triangular factorizations of matrix `A`. Full, economy, and pivoted output forms follow MATLAB semantics.",
     "behaviors": [
         "Single output: `R = qr(A)` returns the upper-triangular (or upper-trapezoidal) factor. Column pivoting is applied implicitly for numerical stability.",
         "Two outputs: `[Q, R] = qr(A)` yields the orthonormal/unitary factor `Q` and the upper-triangular `R` such that `Q * R = A * E`, where `E` is the column permutation matrix selected during factorization. When you omit `E`, the columns of `R` already appear in that permuted order.",

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

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

package/dist/generated/builtins/quiver.js

@@ -11,7 +11,7 @@ const builtinDoc = {
         "matlab quiver",
         "direction field"
     ],
-    "summary": "Visualize 2-D vector fields with scalable arrows, GPU-aware execution, and MATLAB `quiver` call forms.",
+    "summary": "Visualize 2-D vector fields with quiver plots in MATLAB and RunMat.",
     "hero_image": "https://web.runmatstatic.com/builtin-image/runmat-matlab-plot-quiver-gradient-vector.webp",
     "gpu_support": {
         "elementwise": false,
@@ -34,7 +34,7 @@ const builtinDoc = {
         "unit": "builtins::plotting::quiver::tests",
         "integration": "runmat-plot/src/gpu/quiver.rs::tests"
     },
-    "description": "`quiver` visualizes 2-D vector fields as arrows anchored at data points. In RunMat it returns a quiver handle, supports MATLAB-style `quiver(U, V)` and `quiver(X, Y, U, V)` call forms, and uses GPU-backed geometry generation together with the plotting object, replay, and export systems.",
+    "description": "`quiver` visualizes 2-D vector fields as arrows anchored at data points. Supported call forms, scaling behavior, and returned handle semantics follow MATLAB behavior.",
     "behaviors": [
         "`quiver(U, V)` builds the default coordinate grid from the shape of `U` and `V`.",
         "`quiver(X, Y, U, V)` accepts explicit coordinate vectors or meshgrid-style axes, depending on the input layout.",

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,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,SAAS,EAAE,EAAE;IACb,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,qEAAqE;IAChF,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,wKAAwK;IACvL,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,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/rad2deg.js

@@ -11,7 +11,7 @@ const builtinDoc = {
         "trigonometry",
         "elementwise"
     ],
-    "summary": "Convert angles from radians to degrees.",
+    "summary": "Convert angle values from radians to degrees with MATLAB-compatible array behavior.",
     "references": [],
     "gpu_support": {
         "elementwise": true,
@@ -34,7 +34,7 @@ const builtinDoc = {
         "unit": "builtins::math::trigonometry::rad2deg::tests",
         "integration": null
     },
-    "description": "`d = rad2deg(r)` converts each angle in `r` from radians to degrees using `r*180/pi`.",
+    "description": "`d = rad2deg(r)` converts each angle in `r` from radians to degrees using `r * 180 / pi`. It applies element-wise across scalar, vector, matrix, and N-D inputs using MATLAB-compatible typing and shape rules.",
     "behaviors": [
         "Operates element-wise on scalars, vectors, matrices, and N-D tensors.",
         "Integer and logical inputs are promoted to double precision before conversion.",

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

@@ -1 +1 @@
-{"version":3,"file":"rad2deg.js","sourceRoot":"","sources":["../../../src/generated/builtins/rad2deg.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,SAAS;QACT,SAAS;QACT,OAAO;QACP,cAAc;QACd,aAAa;KACd;IACD,SAAS,EAAE,yCAAyC;IACpD,YAAY,EAAE,EAAE;IAChB,aAAa,EAAE;QACb,aAAa,EAAE,IAAI;QACnB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;YACL,KAAK;SACN;QACD,cAAc,EAAE,QAAQ;QACxB,OAAO,EAAE,qJAAqJ;KAC/J;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,IAAI;QACnB,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,IAAI;KACpB;IACD,aAAa,EAAE,uFAAuF;IACtG,WAAW,EAAE;QACX,uEAAuE;QACvE,gFAAgF;QAChF,yFAAyF;QACzF,uCAAuC;QACvC,iEAAiE;KAClE;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,2BAA2B;YAC1C,OAAO,EAAE,iBAAiB;YAC1B,QAAQ,EAAE,SAAS;SACpB;QACD;YACE,aAAa,EAAE,+BAA+B;YAC9C,OAAO,EAAE,wDAAwD;YACjE,QAAQ,EAAE,qBAAqB;SAChC;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,2CAA2C;YACvD,QAAQ,EAAE,mEAAmE;SAC9E;QACD;YACE,UAAU,EAAE,sCAAsC;YAClD,QAAQ,EAAE,mFAAmF;SAC9F;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;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,mEAAmE;QAC5E,KAAK,EAAE,gHAAgH;KACxH;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,cAAc;KACf;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"rad2deg.js","sourceRoot":"","sources":["../../../src/generated/builtins/rad2deg.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,SAAS;QACT,SAAS;QACT,OAAO;QACP,cAAc;QACd,aAAa;KACd;IACD,SAAS,EAAE,qFAAqF;IAChG,YAAY,EAAE,EAAE;IAChB,aAAa,EAAE;QACb,aAAa,EAAE,IAAI;QACnB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;YACL,KAAK;SACN;QACD,cAAc,EAAE,QAAQ;QACxB,OAAO,EAAE,qJAAqJ;KAC/J;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,IAAI;QACnB,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,IAAI;KACpB;IACD,aAAa,EAAE,iNAAiN;IAChO,WAAW,EAAE;QACX,uEAAuE;QACvE,gFAAgF;QAChF,yFAAyF;QACzF,uCAAuC;QACvC,iEAAiE;KAClE;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,2BAA2B;YAC1C,OAAO,EAAE,iBAAiB;YAC1B,QAAQ,EAAE,SAAS;SACpB;QACD;YACE,aAAa,EAAE,+BAA+B;YAC9C,OAAO,EAAE,wDAAwD;YACjE,QAAQ,EAAE,qBAAqB;SAChC;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,2CAA2C;YACvD,QAAQ,EAAE,mEAAmE;SAC9E;QACD;YACE,UAAU,EAAE,sCAAsC;YAClD,QAAQ,EAAE,mFAAmF;SAC9F;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;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,mEAAmE;QAC5E,KAAK,EAAE,gHAAgH;KACxH;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,cAAc;KACf;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/rand.js

@@ -10,7 +10,7 @@ const builtinDoc = {
         "gpu",
         "like"
     ],
-    "summary": "Uniform random numbers on (0, 1) within the MATLAB language.",
+    "summary": "Generate uniformly distributed pseudorandom numbers on the open interval (0, 1) with MATLAB-compatible syntax.",
     "references": [],
     "gpu_support": {
         "elementwise": false,
@@ -33,7 +33,7 @@ const builtinDoc = {
         "unit": "builtins::array::rand::tests",
         "integration": "builtins::array::rand::tests::rand_gpu_like_uniform"
     },
-    "description": "`rand` produces uniformly distributed pseudorandom numbers over the open interval (0, 1). RunMat mirrors MATLAB semantics across scalar, vector, matrix, and N-D invocations, including `'like'` prototypes that control data type and device residency.",
+    "description": "`rand` produces uniformly distributed pseudorandom numbers over the open interval (0, 1). It supports MATLAB-compatible size forms, class selection, and `'like'` prototypes that control output type and residency.",
     "behaviors": [
         "`rand()` returns a scalar double drawn from `U(0, 1)`.",
         "`rand(n)` returns an `n × n` double matrix.",

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

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

package/dist/generated/builtins/randi.js

@@ -10,7 +10,7 @@ const builtinDoc = {
         "gpu",
         "like"
     ],
-    "summary": "Uniform random integers with inclusive bounds.",
+    "summary": "Generate uniform random integers in MATLAB and RunMat.",
     "references": [],
     "gpu_support": {
         "elementwise": false,
@@ -33,7 +33,7 @@ const builtinDoc = {
         "unit": "builtins::array::creation::randi::tests",
         "integration": "builtins::array::creation::randi::tests::randi_gpu_like_roundtrip"
     },
-    "description": "`randi` draws uniformly distributed random integers from an inclusive range. RunMat mirrors MATLAB calling forms, supporting scalar upper bounds, two-element range vectors, explicit dimension lists, size vectors, and `'like'` prototypes that keep type and residency consistent with an existing array.",
+    "description": "`randi` draws uniformly distributed random integers from inclusive ranges. Size forms, range forms, and `'like'` behavior follow MATLAB semantics.",
     "behaviors": [
         "`randi(imax)` returns a scalar double selected uniformly from `1:imax`.",
         "`randi(imax, m, n, ...)` creates dense arrays whose entries are in `1:imax`.",

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

@@ -1 +1 @@
-{"version":3,"file":"randi.js","sourceRoot":"","sources":["../../../src/generated/builtins/randi.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,OAAO;IAChB,UAAU,EAAE,gBAAgB;IAC5B,UAAU,EAAE;QACV,OAAO;QACP,QAAQ;QACR,SAAS;QACT,KAAK;QACL,MAAM;KACP;IACD,SAAS,EAAE,gDAAgD;IAC3D,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,MAAM;QACtB,OAAO,EAAE,qIAAqI;KAC/I;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,MAAM;KACpB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,yCAAyC;QACjD,aAAa,EAAE,mEAAmE;KACnF;IACD,aAAa,EAAE,8SAA8S;IAC7T,WAAW,EAAE;QACX,yEAAyE;QACzE,8EAA8E;QAC9E,+GAA+G;QAC/G,iIAAiI;QACjI,gEAAgE;QAChE,kGAAkG;QAClG,+FAA+F;QAC/F,wIAAwI;KACzI;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,2BAA2B;YAC1C,OAAO,EAAE,0BAA0B;YACnC,QAAQ,EAAE,UAAU;SACrB;QACD;YACE,aAAa,EAAE,qCAAqC;YACpD,OAAO,EAAE,gCAAgC;YACzC,QAAQ,EAAE,+CAA+C;SAC1D;QACD;YACE,aAAa,EAAE,gDAAgD;YAC/D,OAAO,EAAE,yDAAyD;YAClE,QAAQ,EAAE,kMAAkM;SAC7M;QACD;YACE,aAAa,EAAE,iCAAiC;YAChD,OAAO,EAAE,8FAA8F;YACvG,QAAQ,EAAE,wKAAwK;SACnL;QACD;YACE,aAAa,EAAE,gCAAgC;YAC/C,OAAO,EAAE,+CAA+C;YACxD,QAAQ,EAAE,gHAAgH;SAC3H;QACD;YACE,aAAa,EAAE,2CAA2C;YAC1D,OAAO,EAAE,iCAAiC;YAC1C,QAAQ,EAAE,iBAAiB;SAC5B;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,oCAAoC;YAChD,QAAQ,EAAE,8JAA8J;SACzK;QACD;YACE,UAAU,EAAE,kCAAkC;YAC9C,QAAQ,EAAE,gHAAgH;SAC3H;QACD;YACE,UAAU,EAAE,gDAAgD;YAC5D,QAAQ,EAAE,wJAAwJ;SACnK;QACD;YACE,UAAU,EAAE,0CAA0C;YACtD,QAAQ,EAAE,wLAAwL;SACnM;QACD;YACE,UAAU,EAAE,mCAAmC;YAC/C,QAAQ,EAAE,0KAA0K;SACrL;QACD;YACE,UAAU,EAAE,uCAAuC;YACnD,QAAQ,EAAE,qJAAqJ;SAChK;QACD;YACE,UAAU,EAAE,uDAAuD;YACnE,QAAQ,EAAE,iKAAiK;SAC5K;QACD;YACE,UAAU,EAAE,4DAA4D;YACxE,QAAQ,EAAE,uIAAuI;SAClJ;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;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,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,8DAA8D;QACvE,KAAK,EAAE,2GAA2G;KACnH;IACD,eAAe,EAAE,qrBAAqrB;IACtsB,cAAc,EAAE;QACd,oZAAoZ;KACrZ;IACD,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,OAAO;IACf,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"randi.js","sourceRoot":"","sources":["../../../src/generated/builtins/randi.ts"],"names":[],"mappings":"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"}

package/dist/generated/builtins/randn.js

@@ -11,7 +11,7 @@ const builtinDoc = {
         "gpu",
         "like"
     ],
-    "summary": "Standard normal random numbers that mirror MATLAB semantics.",
+    "summary": "Generate standard normal random numbers in MATLAB and RunMat.",
     "references": [],
     "gpu_support": {
         "elementwise": false,
@@ -34,7 +34,7 @@ const builtinDoc = {
         "unit": "builtins::array::creation::randn::tests",
         "integration": "builtins::array::creation::randn::tests::randn_gpu_like_roundtrip"
     },
-    "description": "`randn` draws pseudorandom samples from the standard normal distribution (`μ = 0`, `σ = 1`). RunMat matches MATLAB call patterns for scalars, explicit dimension lists, size vectors, and `'like'` prototypes while honouring GPU residency whenever an acceleration provider is active.",
+    "description": "`randn` draws pseudorandom samples from the standard normal distribution (`μ = 0`, `σ = 1`). Size forms and `'like'` behavior follow MATLAB semantics.",
     "behaviors": [
         "`randn()` returns a scalar double drawn from `𝒩(0, 1)`.",
         "`randn(n)` returns an `n × n` dense double matrix.",

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

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

package/dist/generated/builtins/randperm.js

@@ -11,7 +11,7 @@ const builtinDoc = {
         "gpu",
         "like"
     ],
-    "summary": "Random permutations of the integers 1:n with MATLAB-compatible semantics.",
+    "summary": "Generate random permutations in MATLAB and RunMat.",
     "references": [],
     "gpu_support": {
         "elementwise": false,
@@ -33,7 +33,7 @@ const builtinDoc = {
         "unit": "builtins::array::creation::randperm::tests",
         "integration": "builtins::array::creation::randperm::tests::randperm_gpu_like_roundtrip"
     },
-    "description": "`randperm(n)` returns a uniformly random permutation of the integers `1:n`. `randperm(n, k)` selects `k` unique integers from `1:n` without replacement. RunMat mirrors MATLAB's behaviour, including RNG seeding through `rng`, GPU-aware `'like'` prototypes, and deterministic results during testing.",
+    "description": "`randperm(n)` returns a random permutation of integers `1:n`. `randperm(n, k)` returns `k` unique values without replacement, with RNG and shape behavior following MATLAB semantics.",
     "behaviors": [
         "`randperm(n)` produces a row vector whose length is `n` and whose entries are a random ordering of `1:n`.",
         "`randperm(n, k)` returns the first `k` entries of the permutation without replacement (`0 ≤ k ≤ n`). The result is a `1 × k` row vector.",

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

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

package/dist/generated/builtins/range.js

@@ -11,7 +11,7 @@ const builtinDoc = {
         "omitnan",
         "gpu"
     ],
-    "summary": "Compute the difference between the maximum and minimum values (max - min).",
+    "summary": "Compute the span of array data as `max - min`, with MATLAB-compatible dimension and NaN controls.",
     "references": [],
     "gpu_support": {
         "elementwise": false,
@@ -35,7 +35,7 @@ const builtinDoc = {
         "integration": "builtins::array::creation::range::tests::range_gpu_provider_roundtrip",
         "gpu": "builtins::array::creation::range::tests::range_wgpu_dim2_matches_cpu"
     },
-    "description": "`range(X)` returns the span (maximum minus minimum) of the elements in `X`. For arrays, the calculation happens along the first non-singleton dimension unless you specify one. The output keeps MATLAB's column-major shape conventions.",
+    "description": "`range(X)` returns the span (maximum minus minimum) of the elements in `X`. For arrays, it operates along the first non-singleton dimension unless you specify `dim` or `'all'`, and it follows MATLAB-compatible output-shape conventions.",
     "behaviors": [
         "Operates on scalars, vectors, matrices, and N-D tensors.",
         "`range(X)` measures the spread along the first non-singleton dimension.",

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

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

package/dist/generated/builtins/rank.js

@@ -34,7 +34,7 @@ const builtinDoc = {
         "gpu": "builtins::math::linalg::solve::rank::tests::rank_gpu_round_trip",
         "wgpu": "builtins::math::linalg::solve::rank::tests::rank_wgpu_matches_cpu"
     },
-    "description": "`r = rank(A)` returns the numerical rank of a real or complex matrix `A`. The rank equals the number of singular values greater than a tolerance derived from the matrix size and the largest singular value. RunMat mirrors MATLAB’s logic exactly so that results agree bit-for-bit with the reference implementation.",
+    "description": "`r = rank(A)` returns the numerical rank of a real or complex matrix `A`. The rank is the number of singular values above a tolerance derived from matrix size and scale, with MATLAB-compatible default and explicit-tolerance behavior.",
     "behaviors": [
         "Inputs must behave like 2-D matrices. Trailing singleton dimensions are accepted; other higher ranks result in `\"rank: inputs must be 2-D matrices or vectors\"`.",
         "The default tolerance is `tol = max(size(A)) * eps(max(s))`, where `s` are the singular values from an SVD of `A`. You can override this by supplying a second argument: `rank(A, tol)`.",