runmat 0.5.7-dev.2 → 0.5.7-dev.4

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

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

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

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

package/dist/generated/builtins/qqplot.js

@@ -0,0 +1,60 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "qqplot",
+    "slug": "qqplot",
+    "keywords": [
+        "qqplot",
+        "quantile",
+        "normal",
+        "probability",
+        "statistics",
+        "plotting"
+    ],
+    "summary": "Create a quantile-quantile plot against a normal distribution or another sample.",
+    "description": "`qqplot(x)` plots sorted sample quantiles against standard-normal theoretical quantiles. `qqplot(x,y)` compares the quantiles of two samples. `qqplot(x,[],pvec)` and `qqplot(x,y,pvec)` evaluate quantiles at explicit percentage values in the interval [0,100]. Matrix inputs create one series per column, omitting NaN and Inf observations.",
+    "notes": [
+        "The returned handle vector contains the data line, solid quartile line, and dashed fitted reference line for each plotted series.",
+        "For one-sample plots, the reference line is fitted through the first and third quartiles of the theoretical normal quantiles and sample quantiles.",
+        "RunMat supports numeric vector and matrix data. Two-sample matrices are paired by column; a vector can be compared with each column of a matrix. Distribution-object inputs and table variable routing are not part of this compatibility surface yet."
+    ],
+    "examples": [
+        {
+            "description": "Normal quantile plot",
+            "input": "h = qqplot([1; 2; 4; 8])",
+            "output": "h is a 3-by-1 vector of line handles."
+        },
+        {
+            "description": "Use explicit probabilities",
+            "input": "h = qqplot([0; 10; 20], [], [25 50 75]);\ny = get(h(1), 'YData')",
+            "output": "y is [5 10 15]."
+        },
+        {
+            "description": "Compare two samples",
+            "input": "h = qqplot([1; 3; 5], [2; 4; 6], 50)",
+            "output": "The plotted point compares median quantiles 3 and 4."
+        }
+    ],
+    "errors": [
+        {
+            "identifier": "RunMat:qqplot:InvalidArgument",
+            "message": "qqplot: invalid argument"
+        },
+        {
+            "identifier": "RunMat:qqplot:Internal",
+            "message": "qqplot: internal error"
+        }
+    ],
+    "links": [
+        {
+            "label": "Source",
+            "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/stats/summary/qqplot.rs"
+        }
+    ],
+    "key": "qqplot",
+    "aliases": [],
+    "category": "",
+    "categoryPath": []
+};
+export default builtinDoc;
+//# sourceMappingURL=qqplot.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"qqplot.js","sourceRoot":"","sources":["../../../src/generated/builtins/qqplot.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,QAAQ;IACjB,MAAM,EAAE,QAAQ;IAChB,UAAU,EAAE;QACV,QAAQ;QACR,UAAU;QACV,QAAQ;QACR,aAAa;QACb,YAAY;QACZ,UAAU;KACX;IACD,SAAS,EAAE,kFAAkF;IAC7F,aAAa,EAAE,mVAAmV;IAClW,OAAO,EAAE;QACP,mIAAmI;QACnI,oJAAoJ;QACpJ,wPAAwP;KACzP;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,sBAAsB;YACrC,OAAO,EAAE,0BAA0B;YACnC,QAAQ,EAAE,uCAAuC;SAClD;QACD;YACE,aAAa,EAAE,4BAA4B;YAC3C,OAAO,EAAE,kEAAkE;YAC3E,QAAQ,EAAE,iBAAiB;SAC5B;QACD;YACE,aAAa,EAAE,qBAAqB;YACpC,OAAO,EAAE,sCAAsC;YAC/C,QAAQ,EAAE,sDAAsD;SACjE;KACF;IACD,QAAQ,EAAE;QACR;YACE,YAAY,EAAE,+BAA+B;YAC7C,SAAS,EAAE,0BAA0B;SACtC;QACD;YACE,YAAY,EAAE,wBAAwB;YACtC,SAAS,EAAE,wBAAwB;SACpC;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,2GAA2G;SACnH;KACF;IACD,KAAK,EAAE,QAAQ;IACf,SAAS,EAAE,EAAE;IACb,UAAU,EAAE,EAAE;IACd,cAAc,EAAE,EAAE;CACnB,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/quantile.js

@@ -0,0 +1,76 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "quantile",
+    "category": "stats/summary",
+    "keywords": [
+        "quantile",
+        "percentile",
+        "statistics",
+        "order"
+    ],
+    "summary": "Compute sample quantiles.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f64"
+        ],
+        "broadcasting": "none",
+        "notes": "GPU inputs are gathered to host."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "none"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::stats::summary::order_stats::tests",
+        "integration": null
+    },
+    "description": "`quantile(X,p)` computes sample quantiles along the first nonsingleton dimension using linear interpolation.",
+    "behaviors": [
+        "`p` must contain probabilities in `[0,1]`.",
+        "`quantile(X,p,dim)` operates along a selected dimension.",
+        "NaNs are omitted by default in each slice.",
+        "`\"omitnan\"` omits NaNs in each slice; `\"includenan\"` returns NaN for slices containing NaN.",
+        "`\"Method\",\"linear\"` and `\"Method\",\"exact\"` use in-memory linear interpolation; `\"approximate\"` is rejected because tall arrays are not supported here."
+    ],
+    "examples": [
+        {
+            "description": "Quartiles",
+            "input": "q = quantile([1 2 4 8], [0.25 0.5 0.75])"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "How is prctile different?",
+            "answer": "`prctile(X,p)` is equivalent to `quantile(X,p/100)` for supported forms."
+        }
+    ],
+    "links": [
+        {
+            "label": "prctile",
+            "url": "./prctile"
+        },
+        {
+            "label": "median",
+            "url": "./median"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/stats/summary/order_stats.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/stats/summary/order_stats.rs"
+    },
+    "key": "quantile",
+    "slug": "quantile",
+    "aliases": [],
+    "categoryPath": [
+        "stats",
+        "summary"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=quantile.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"quantile.js","sourceRoot":"","sources":["../../../src/generated/builtins/quantile.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,UAAU;IACnB,UAAU,EAAE,eAAe;IAC3B,UAAU,EAAE;QACV,UAAU;QACV,YAAY;QACZ,YAAY;QACZ,OAAO;KACR;IACD,SAAS,EAAE,2BAA2B;IACtC,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;SACN;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,kCAAkC;KAC5C;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,8CAA8C;QACtD,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,8GAA8G;IAC7H,WAAW,EAAE;QACX,4CAA4C;QAC5C,0DAA0D;QAC1D,4CAA4C;QAC5C,iGAAiG;QACjG,kKAAkK;KACnK;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,WAAW;YAC1B,OAAO,EAAE,0CAA0C;SACpD;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,2BAA2B;YACvC,QAAQ,EAAE,0EAA0E;SACrF;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,mEAAmE;QAC5E,KAAK,EAAE,gHAAgH;KACxH;IACD,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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,UAsIjB,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,UAuIjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/quiver.js

@@ -21,7 +21,7 @@ const builtinDoc = {
             "double"
         ],
         "broadcasting": "none",
-        "notes": "`quiver` uses a GPU-backed geometry path and can keep vector-field inputs resident on device when the shared plotting device is available."
+        "notes": "`quiver` uses a GPU-backed geometry path and can keep vector-field inputs resident on device when the shared plotting device is available. Default X/Y grids are represented as compact axis buffers while U/V remain resident; explicit host X/Y coordinates are uploaded as axis buffers for the packer."
     },
     "fusion": {
         "elementwise": false,
@@ -40,7 +40,7 @@ const builtinDoc = {
         "`quiver(X, Y, U, V)` accepts explicit coordinate vectors or meshgrid-style axes, depending on the input layout.",
         "The returned value is a quiver-handle object that can be queried and updated through `get` and `set`.",
         "Auto-scale factor, head size, line width, color, and display-name workflows are all part of the plotting property path.",
-        "Dedicated GPU geometry generation keeps vector-field rendering on device when plotting-compatible buffers are available."
+        "Dedicated GPU geometry generation keeps vector-field rendering on device when plotting-compatible U/V buffers are available, including `quiver(U,V)` with an implicit coordinate grid."
     ],
     "options": [
         "`'AutoScaleFactor'` / `'Scale'` controls arrow scaling.",
@@ -78,7 +78,7 @@ const builtinDoc = {
         },
         {
             "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."
+            "answer": "Yes. Use `quiver3` for 3-D vector fields.\n\n```matlab\nquiver3(X, Y, Z, U, V, W);\n```"
         }
     ],
     "links": [
@@ -123,10 +123,11 @@ const builtinDoc = {
         "label": "`crates/runmat-runtime/src/builtins/plotting/ops/quiver.rs`",
         "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/plotting/ops/quiver.rs"
     },
-    "gpu_residency": "`quiver` preserves GPU residency on the direct path by building arrow geometry from exported GPU buffers. If the direct geometry path is unavailable for the active input combination, RunMat falls back while preserving the same quiver semantics and handle behavior.",
+    "gpu_residency": "`quiver` preserves GPU residency on the direct path by building arrow geometry from exported GPU U/V buffers. Explicit GPU X/Y coordinates also stay resident when their precision matches U/V. Implicit default X/Y grids are uploaded as compact meshgrid-vector axis buffers, and explicit host X/Y coordinates are uploaded as axis buffers, so resident U/V inputs do not have to be gathered. If the direct geometry path is unavailable for the active input combination, RunMat falls back while preserving the same quiver semantics and handle behavior.",
     "gpu_behavior": [
         "The direct quiver path emits renderer-ready arrow geometry from GPU buffers on the happy path.",
-        "Axes-local state, handle/property workflows, and replay/export behavior stay aligned across GPU and fallback rendering paths."
+        "Axes-local state and handle/property workflows stay aligned across GPU and fallback rendering paths.",
+        "Replay/export paths read back GPU source buffers when serializable plot data is required."
     ],
     "key": "quiver",
     "slug": "quiver",

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,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"}
+{"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,4SAA4S;KACtT;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,wLAAwL;KACzL;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,yFAAyF;SACpG;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,oiBAAoiB;IACrjB,cAAc,EAAE;QACd,gGAAgG;QAChG,sGAAsG;QACtG,2FAA2F;KAC5F;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/quiver3.d.ts

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

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

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

package/dist/generated/builtins/quiver3.js

@@ -0,0 +1,129 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "quiver3",
+    "category": "plotting",
+    "keywords": [
+        "quiver3",
+        "3-D vector field",
+        "arrow plot",
+        "matlab quiver3",
+        "direction field"
+    ],
+    "summary": "Visualize 3-D vector fields with MATLAB-compatible quiver3 plots.",
+    "hero_image": "https://web.runmatstatic.com/builtin-image/runmat-matlab-plot-scatter3-3D-point-cloud.webp",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "single",
+            "double"
+        ],
+        "broadcasting": "none",
+        "notes": "`quiver3` is a rendering sink. RunMat currently gathers GPU inputs once to build 3-D quiver geometry; direct WGPU geometry packing is tracked by the eval-loop GPU fast-path audit."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 6,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::plotting::quiver3::tests",
+        "integration": "runmat-plot/src/plots/quiver.rs::tests"
+    },
+    "description": "`quiver3` draws arrows anchored at 3-D coordinates and returns a graphics handle. It supports implicit grid coordinates from `Z`, explicit `X`, `Y`, and `Z` coordinates, axes targeting, numeric scale factors, line-style shorthand, and name/value styling.",
+    "behaviors": [
+        "`quiver3(Z, U, V, W)` builds default X/Y grid coordinates from the shape of `Z`.",
+        "`quiver3(X, Y, Z, U, V, W)` accepts matching coordinate arrays or meshgrid-style X/Y vectors for matrix vector fields.",
+        "The returned graphics handle exposes XData, YData, ZData, UData, VData, WData, Color, LineWidth, AutoScaleFactor, MaxHeadSize, Parent, Children, and Type through `get` and style updates through `set`.",
+        "3-D arrow geometry is stored in the shared quiver plot primitive, so replay/export preserves Z/W data and 3-D bounds.",
+        "Changing scale, head size, color, or data properties invalidates cached quiver geometry before the next render."
+    ],
+    "options": [
+        "A numeric argument after the vector data controls the arrow scale factor.",
+        "`'AutoScaleFactor'` / `'Scale'` controls arrow scaling.",
+        "`'MaxHeadSize'` / `'HeadSize'` controls the size of arrowheads.",
+        "Line-style color and width workflows use the same parser as other line-like plotting builtins."
+    ],
+    "examples": [
+        {
+            "description": "Create a 3-D vector field from Z and vector components",
+            "input": "[X, Y] = meshgrid(-2:1:2, -2:1:2);\nZ = X.^2 - Y.^2;\nU = -Y;\nV = X;\nW = ones(size(Z));\nquiver3(Z, U, V, W);"
+        },
+        {
+            "description": "Provide explicit coordinates and style the arrows",
+            "input": "[X, Y, Z] = meshgrid(-1:1, -1:1, 0:1);\nU = -Y;\nV = X;\nW = 0.5 * ones(size(Z));\nh = quiver3(X, Y, Z, U, V, W, 1.5, 'r');\nset(h, 'DisplayName', 'flow', 'MaxHeadSize', 0.2);\nview(45, 30);"
+        },
+        {
+            "description": "Target a specific axes",
+            "input": "ax = axes;\nquiver3(ax, 1:3, 1:3, 1:3, [1 0 -1], [0 1 0], [0 0 1]);"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "How do I control arrow lengths in a quiver3 plot?",
+            "answer": "Pass a numeric scale after the vector data or set the `'AutoScaleFactor'` property.\n\n```matlab\nh = quiver3(X, Y, Z, U, V, W, 0.75);\nset(h, 'AutoScaleFactor', 1.5);\n```"
+        },
+        {
+            "question": "Can I inspect the 3-D vector data after plotting?",
+            "answer": "Yes. Use `get(h, 'XData')`, `get(h, 'YData')`, `get(h, 'ZData')`, `get(h, 'UData')`, `get(h, 'VData')`, and `get(h, 'WData')` on the returned handle."
+        },
+        {
+            "question": "Does quiver3 keep GPU data resident?",
+            "answer": "Not yet on the direct geometry path. RunMat gathers GPU inputs once and preserves the same plotting and handle semantics; direct WGPU packing for 3-D arrows is tracked by the eval-loop GPU fast-path audit."
+        }
+    ],
+    "links": [
+        {
+            "label": "quiver",
+            "url": "./quiver"
+        },
+        {
+            "label": "plot3",
+            "url": "./plot3"
+        },
+        {
+            "label": "scatter3",
+            "url": "./scatter3"
+        },
+        {
+            "label": "view",
+            "url": "./view"
+        },
+        {
+            "label": "zlabel",
+            "url": "./zlabel"
+        },
+        {
+            "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"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/plotting/ops/quiver3.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/plotting/ops/quiver3.rs"
+    },
+    "gpu_residency": "`quiver3` is currently a gather-immediate plotting sink. GPU-resident inputs are materialized once before building 3-D arrow geometry; direct provider-backed geometry emission is intentionally left to the queued GPU fast-path audit.",
+    "gpu_behavior": [
+        "Host and GPU-fallback paths produce the same handle semantics and replay/export data.",
+        "A future direct WGPU path should mirror the existing 2-D `quiver` GPU packer with Z/W coordinate buffers."
+    ],
+    "key": "quiver3",
+    "slug": "quiver3",
+    "aliases": [],
+    "categoryPath": [
+        "plotting"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=quiver3.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"quiver3.js","sourceRoot":"","sources":["../../../src/generated/builtins/quiver3.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,kBAAkB;QAClB,YAAY;QACZ,gBAAgB;QAChB,iBAAiB;KAClB;IACD,SAAS,EAAE,mEAAmE;IAC9E,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,qLAAqL;KAC/L;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,wCAAwC;KACxD;IACD,aAAa,EAAE,gQAAgQ;IAC/Q,WAAW,EAAE;QACX,kFAAkF;QAClF,wHAAwH;QACxH,0MAA0M;QAC1M,uHAAuH;QACvH,iHAAiH;KAClH;IACD,SAAS,EAAE;QACT,2EAA2E;QAC3E,yDAAyD;QACzD,iEAAiE;QACjE,gGAAgG;KACjG;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,wDAAwD;YACvE,OAAO,EAAE,iHAAiH;SAC3H;QACD;YACE,aAAa,EAAE,mDAAmD;YAClE,OAAO,EAAE,gMAAgM;SAC1M;QACD;YACE,aAAa,EAAE,wBAAwB;YACvC,OAAO,EAAE,qEAAqE;SAC/E;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,mDAAmD;YAC/D,QAAQ,EAAE,8KAA8K;SACzL;QACD;YACE,UAAU,EAAE,mDAAmD;YAC/D,QAAQ,EAAE,uJAAuJ;SAClK;QACD;YACE,UAAU,EAAE,sCAAsC;YAClD,QAAQ,EAAE,+MAA+M;SAC1N;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;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,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;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,8DAA8D;QACvE,KAAK,EAAE,2GAA2G;KACnH;IACD,eAAe,EAAE,0OAA0O;IAC3P,cAAc,EAAE;QACd,uFAAuF;QACvF,2GAA2G;KAC5G;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/rand.js

@@ -32,14 +32,15 @@ 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). It supports MATLAB-compatible size forms, class selection, and `'like'` prototypes that control output type and residency.",
+    "description": "`rand` produces uniformly distributed pseudorandom numbers over the open interval (0, 1). It supports MATLAB-compatible size forms, class selection, `'like'` prototypes that control output type and residency, and the legacy `rand('seed', seed)` control form.",
     "behaviors": [
         "`rand()` returns a scalar double drawn from `U(0, 1)`.",
         "`rand(n)` returns an `n × n` double matrix.",
         "`rand(m, n, ...)` returns a dense double array of the requested dimensions.",
         "`rand(sz)` accepts a size vector (row or column) and returns a tensor whose shape is `sz`.",
         "`rand(A)` or `rand(___, 'like', A)` matches the shape and residency of `A`, including GPU tensors when an acceleration provider is active.",
-        "`rand(___, 'double')` leaves the output as double precision (default). `'single'` returns single-precision results that mirror MATLAB's behaviour."
+        "`rand(___, 'double')` leaves the output as double precision (default). `'single'` returns single-precision results that mirror MATLAB's behaviour.",
+        "`rand('seed', seed)` and `rand(\"seed\", seed)` accept non-negative integer scalar seeds and reset RunMat's shared pseudorandom stream. `rand('seed')` queries a restorable legacy state token for the current stream position; passing that token back to `rand('seed', token)` restores subsequent draws. This legacy control form also synchronizes the active acceleration provider's RNG state when provider hooks are available."
     ],
     "examples": [
         {
@@ -56,6 +57,11 @@ const builtinDoc = {
             "description": "Creating a 128x128 matrix of random numbers on a GPU",
             "input": "G = rand(128, 128)",
             "output": "H = [0.8147 0.9134 0.1270 0.9058 0.6324 0.0975 0.1270 0.0975 0.2785; 0.9134 0.6324 0.0975 0.2785 0.0975 0.1270 0.9058 0.6324 0.0975]"
+        },
+        {
+            "description": "Use legacy seed syntax",
+            "input": "rand('seed', 2026);\na = rand(1, 4);\ns = rand('seed');\nb = rand(1, 4);\nrand('seed', s);\nc = rand(1, 4);",
+            "output": "b and c contain the same values because s restores the post-a stream position."
         }
     ],
     "faqs": [
@@ -94,6 +100,10 @@ const builtinDoc = {
         {
             "question": "What if I call `rand` with no arguments?",
             "answer": "`rand()` returns a scalar double drawn from `U(0, 1)`."
+        },
+        {
+            "question": "Should I use `rand('seed', seed)` or `rng(seed)`?",
+            "answer": "`rng(seed)` is the preferred modern spelling. `rand('seed', seed)` remains supported for legacy MATLAB scripts and maps to RunMat's shared random generator state. `rand('seed')` returns an opaque numeric state token intended for same-session save/restore workflows."
         }
     ],
     "links": [

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/random.d.ts

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

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

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

package/dist/generated/builtins/random.js

@@ -0,0 +1,85 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "random",
+    "category": "stats/random",
+    "keywords": [
+        "random",
+        "fitdist",
+        "probability distribution",
+        "sampling",
+        "statistics"
+    ],
+    "summary": "Generate random samples from a fitted or named probability distribution.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f64"
+        ],
+        "broadcasting": "size arguments",
+        "notes": "Sampling currently uses the host RNG and returns CPU arrays."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "none"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::stats::summary::fitdist::tests",
+        "integration": "crates/runmat-vm/tests/stats_ml.rs"
+    },
+    "description": "`random(pd)` and `random(pd,sz...)` generate random samples from a `ProbabilityDistribution` object returned by `fitdist`. `random(distname,params...,sz...)` samples supported named distributions directly.",
+    "behaviors": [
+        "`pd` must be a fitted distribution object returned by `fitdist`, or `distname` must name a supported distribution.",
+        "`random(pd)` returns one scalar sample.",
+        "`random(pd,m,n,...)` returns an array with the requested size. A vector size argument such as `[m n]` is also accepted.",
+        "Named normal, exponential, lognormal, gamma, Weibull, and Poisson distributions are supported with scalar parameters followed by optional size arguments.",
+        "Normal, exponential, lognormal, gamma, Weibull, and Poisson fitted distributions are supported."
+    ],
+    "examples": [
+        {
+            "description": "Draw a matrix of samples",
+            "input": "pd = fitdist([1;2;3], \"Normal\"); r = random(pd, 2, 3)"
+        },
+        {
+            "description": "Draw from a named Weibull distribution",
+            "input": "r = random(\"Weibull\", 2, 3, 4, 5)"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does random support named distribution parameters?",
+            "answer": "Yes for normal, exponential, lognormal, gamma, Weibull, and Poisson with scalar parameters. Distribution-specific random helpers such as `normrnd` remain available separately."
+        }
+    ],
+    "links": [
+        {
+            "label": "fitdist",
+            "url": "./fitdist"
+        },
+        {
+            "label": "normrnd",
+            "url": "./normrnd"
+        },
+        {
+            "label": "gamrnd",
+            "url": "./gamrnd"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/stats/summary/fitdist.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/stats/summary/fitdist.rs"
+    },
+    "key": "random",
+    "slug": "random",
+    "aliases": [],
+    "categoryPath": [
+        "stats",
+        "random"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=random.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"random.js","sourceRoot":"","sources":["../../../src/generated/builtins/random.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,QAAQ;IACjB,UAAU,EAAE,cAAc;IAC1B,UAAU,EAAE;QACV,QAAQ;QACR,SAAS;QACT,0BAA0B;QAC1B,UAAU;QACV,YAAY;KACb;IACD,SAAS,EAAE,0EAA0E;IACrF,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;SACN;QACD,cAAc,EAAE,gBAAgB;QAChC,OAAO,EAAE,8DAA8D;KACxE;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,0CAA0C;QAClD,aAAa,EAAE,oCAAoC;KACpD;IACD,aAAa,EAAE,+MAA+M;IAC9N,WAAW,EAAE;QACX,oHAAoH;QACpH,yCAAyC;QACzC,yHAAyH;QACzH,2JAA2J;QAC3J,iGAAiG;KAClG;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,0BAA0B;YACzC,OAAO,EAAE,yDAAyD;SACnE;QACD;YACE,aAAa,EAAE,wCAAwC;YACvD,OAAO,EAAE,qCAAqC;SAC/C;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,oDAAoD;YAChE,QAAQ,EAAE,iLAAiL;SAC5L;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,+DAA+D;QACxE,KAAK,EAAE,4GAA4G;KACpH;IACD,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,QAAQ;KACT;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/randsample.js

@@ -0,0 +1,82 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "randsample",
+    "category": "stats/random",
+    "keywords": [
+        "randsample",
+        "random",
+        "sample",
+        "replacement",
+        "weights",
+        "statistics"
+    ],
+    "summary": "Randomly sample from an integer range or population vector.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f64"
+        ],
+        "broadcasting": "none",
+        "notes": "GPU inputs are gathered to host for compatibility until provider sampling hooks exist."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "none"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::stats::random::sampling::tests",
+        "integration": null
+    },
+    "description": "`randsample(n,k)` samples from integers `1:n`. `randsample(population,k)` samples from a population vector. Replacement and weights are supported with `randsample(...,replacement,w)`.",
+    "behaviors": [
+        "Samples without replacement by default.",
+        "When the first argument is a numeric scalar, it is treated as the upper limit `n`.",
+        "Population vectors preserve their row or column orientation.",
+        "Weights are supported for sampling with replacement, matching MATLAB's documented restriction.",
+        "Numeric, logical, string, and char population vectors are supported."
+    ],
+    "examples": [
+        {
+            "description": "Sample unique integers",
+            "input": "y = randsample(20, 10)"
+        },
+        {
+            "description": "Sample with replacement and weights",
+            "input": "y = randsample(population, 5, true, weights)"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "How is randsample different from datasample?",
+            "answer": "`randsample(n,k)` is specialized for integer ranges and population vectors. Use `datasample` to sample along dimensions of arrays."
+        }
+    ],
+    "links": [
+        {
+            "label": "datasample",
+            "url": "./datasample"
+        },
+        {
+            "label": "randperm",
+            "url": "./randperm"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/stats/random/sampling.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/stats/random/sampling.rs"
+    },
+    "key": "randsample",
+    "slug": "randsample",
+    "aliases": [],
+    "categoryPath": [
+        "stats",
+        "random"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=randsample.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"randsample.js","sourceRoot":"","sources":["../../../src/generated/builtins/randsample.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,YAAY;IACrB,UAAU,EAAE,cAAc;IAC1B,UAAU,EAAE;QACV,YAAY;QACZ,QAAQ;QACR,QAAQ;QACR,aAAa;QACb,SAAS;QACT,YAAY;KACb;IACD,SAAS,EAAE,6DAA6D;IACxE,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;SACN;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,wFAAwF;KAClG;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,0CAA0C;QAClD,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,yLAAyL;IACxM,WAAW,EAAE;QACX,yCAAyC;QACzC,oFAAoF;QACpF,8DAA8D;QAC9D,gGAAgG;QAChG,sEAAsE;KACvE;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,wBAAwB;YACvC,OAAO,EAAE,wBAAwB;SAClC;QACD;YACE,aAAa,EAAE,qCAAqC;YACpD,OAAO,EAAE,8CAA8C;SACxD;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,8CAA8C;YAC1D,QAAQ,EAAE,oIAAoI;SAC/I;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,cAAc;SACtB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,+DAA+D;QACxE,KAAK,EAAE,4GAA4G;KACpH;IACD,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,YAAY;IACpB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,QAAQ;KACT;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}