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

package/dist/generated/builtins/sprand.js

@@ -0,0 +1,95 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "sprand",
+    "category": "array/creation",
+    "keywords": [
+        "sprand",
+        "sparse",
+        "random",
+        "density"
+    ],
+    "summary": "Create sparse random matrices.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f64"
+        ],
+        "broadcasting": "none",
+        "notes": "`sprand` uses RunMat's host RNG and returns host-resident sparse CSC storage."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 5,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::array::creation::sparse::tests::sprand_pattern_form_preserves_shape_and_pattern; builtins::array::creation::sparse::tests::sprand_density_form_constructs_requested_sparse_shape; builtins::array::creation::sparse::tests::sprand_scalar_rc_form_matches_requested_condition_at_full_density; builtins::array::creation::sparse::tests::sprand_vector_rc_form_uses_requested_singular_values; builtins::array::creation::sparse::tests::sprand_rc_form_respects_density_and_typename_validation; builtins::array::creation::sparse::tests::sprand_rc_vector_shape_preserves_singular_value_without_rotation_cap"
+    },
+    "description": "`sprand` creates sparse double matrices with random values and optional reciprocal-condition control.",
+    "behaviors": [
+        "`sprand(S)` preserves the nonzero pattern and shape of `S` while replacing stored values with uniform random values.",
+        "`sprand(m, n, density)` creates an `m x n` sparse matrix with approximately `round(m*n*density)` stored entries.",
+        "`density` must be finite and between `0` and `1`.",
+        "`sprand(m, n, density, rc)` accepts a scalar reciprocal-condition target or a vector of singular values in `[0,1]`. RunMat starts from the requested singular profile and applies random orthogonal plane rotations to add sparse fill while preserving that profile.",
+        "A trailing `\"double\"` typename is accepted for MATLAB compatibility. `\"single\"` sparse storage is rejected until RunMat has native single-precision sparse matrices.",
+        "Large requested sparse patterns, condition-profile dense intermediates, and excessive plane-rotation work are rejected before allocating or running unbounded work."
+    ],
+    "examples": [
+        {
+            "description": "Random values on an existing pattern",
+            "input": "P = sparse([1; 3], [1; 2], [10; 20], 3, 2);\nR = sprand(P);\nissparse(R)",
+            "output": "ans = 1"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does `sprand(...,rc)` enforce the reciprocal condition number?",
+            "answer": "Yes. RunMat uses orthogonal row and column plane rotations, which preserve the singular values of the requested scalar reciprocal condition target or vector singular profile. The requested density remains approximate for small or structurally constrained shapes."
+        }
+    ],
+    "links": [
+        {
+            "label": "sparse",
+            "url": "./sparse"
+        },
+        {
+            "label": "rand",
+            "url": "./rand"
+        },
+        {
+            "label": "sprandn",
+            "url": "./sprandn"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/array/creation/sparse/mod.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/array/creation/sparse/mod.rs"
+    },
+    "syntax": {
+        "example": {
+            "description": "Supported forms",
+            "input": "R = sprand(S)\nR = sprand(S, \"double\")\nR = sprand(m, n, density)\nR = sprand(m, n, density, \"double\")\nR = sprand(m, n, density, rc)\nR = sprand(m, n, density, rc, \"double\")",
+            "output": "`R` is a sparse double matrix."
+        },
+        "points": [
+            "The output is host-resident sparse CSC storage.",
+            "`rc` can be a scalar reciprocal condition number or a vector of singular values with length at most `min(m,n)`.",
+            "The `rc` form is bounded by dense working-storage and plane-rotation work limits.",
+            "Only `\"double\"` sparse storage is currently supported."
+        ]
+    },
+    "gpu_residency": "`sprand` runs on the host RNG and produces a host sparse matrix.",
+    "key": "sprand",
+    "slug": "sprand",
+    "aliases": [],
+    "categoryPath": [
+        "array",
+        "creation"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=sprand.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sprand.js","sourceRoot":"","sources":["../../../src/generated/builtins/sprand.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,QAAQ;IACjB,UAAU,EAAE,gBAAgB;IAC5B,UAAU,EAAE;QACV,QAAQ;QACR,QAAQ;QACR,QAAQ;QACR,SAAS;KACV;IACD,SAAS,EAAE,gCAAgC;IAC3C,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;SACN;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,+EAA+E;KACzF;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,4lBAA4lB;KACrmB;IACD,aAAa,EAAE,uGAAuG;IACtH,WAAW,EAAE;QACX,sHAAsH;QACtH,kHAAkH;QAClH,mDAAmD;QACnD,uQAAuQ;QACvQ,0KAA0K;QAC1K,qKAAqK;KACtK;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,sCAAsC;YACrD,OAAO,EAAE,0EAA0E;YACnF,QAAQ,EAAE,SAAS;SACpB;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,gEAAgE;YAC5E,QAAQ,EAAE,wQAAwQ;SACnR;KACF;IACD,OAAO,EAAE;QACP;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;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,mEAAmE;QAC5E,KAAK,EAAE,gHAAgH;KACxH;IACD,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,aAAa,EAAE,iBAAiB;YAChC,OAAO,EAAE,sLAAsL;YAC/L,QAAQ,EAAE,gCAAgC;SAC3C;QACD,QAAQ,EAAE;YACR,iDAAiD;YACjD,iHAAiH;YACjH,mFAAmF;YACnF,0DAA0D;SAC3D;KACF;IACD,eAAe,EAAE,kEAAkE;IACnF,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/squareform.js

@@ -0,0 +1,89 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "squareform",
+    "category": "stats/ml",
+    "keywords": [
+        "squareform",
+        "distance",
+        "condensed",
+        "symmetric",
+        "statistics",
+        "machine learning"
+    ],
+    "summary": "Convert between condensed distance vectors and square distance matrices.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f64"
+        ],
+        "broadcasting": "none",
+        "notes": "GPU inputs are gathered to host before conversion."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "none"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::stats::ml::distance::tests",
+        "integration": "crates/runmat-vm/tests/stats_ml.rs"
+    },
+    "description": "`squareform` converts a condensed pairwise-distance vector into a square symmetric matrix, or converts a square symmetric distance matrix back into condensed form.",
+    "behaviors": [
+        "Vector inputs must have length `n*(n-1)/2` for an integer `n`.",
+        "Matrix inputs must be square, symmetric, and have a zero diagonal.",
+        "`squareform(Z,\"tomatrix\")` forces vector-to-matrix conversion.",
+        "`squareform(Z,\"tovector\")` forces matrix-to-vector conversion.",
+        "Condensed vectors use the same pair ordering as `pdist`."
+    ],
+    "examples": [
+        {
+            "description": "Expand a condensed vector",
+            "input": "D = [5 4 7];\nM = squareform(D)",
+            "output": "M is a 3-by-3 symmetric matrix with zeros on the diagonal."
+        },
+        {
+            "description": "Convert back to condensed form",
+            "input": "D2 = squareform(M)",
+            "output": "D2 is [5 4 7]."
+        },
+        {
+            "description": "Force output mode",
+            "input": "M = squareform(D, \"tomatrix\")",
+            "output": "The input is interpreted as a condensed distance vector."
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Why does a matrix input need a zero diagonal?",
+            "answer": "A distance matrix represents distance from each observation to itself on the diagonal, which must be zero for condensed conversion."
+        }
+    ],
+    "links": [
+        {
+            "label": "pdist",
+            "url": "./pdist"
+        },
+        {
+            "label": "pdist2",
+            "url": "./pdist2"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/stats/ml/distance.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/stats/ml/distance.rs"
+    },
+    "key": "squareform",
+    "slug": "squareform",
+    "aliases": [],
+    "categoryPath": [
+        "stats",
+        "ml"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=squareform.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"squareform.js","sourceRoot":"","sources":["../../../src/generated/builtins/squareform.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,YAAY;IACrB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,YAAY;QACZ,UAAU;QACV,WAAW;QACX,WAAW;QACX,YAAY;QACZ,kBAAkB;KACnB;IACD,SAAS,EAAE,0EAA0E;IACrF,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;SACN;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,oDAAoD;KAC9D;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,sCAAsC;QAC9C,aAAa,EAAE,oCAAoC;KACpD;IACD,aAAa,EAAE,qKAAqK;IACpL,WAAW,EAAE;QACX,gEAAgE;QAChE,oEAAoE;QACpE,kEAAkE;QAClE,kEAAkE;QAClE,0DAA0D;KAC3D;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,2BAA2B;YAC1C,OAAO,EAAE,iCAAiC;YAC1C,QAAQ,EAAE,4DAA4D;SACvE;QACD;YACE,aAAa,EAAE,gCAAgC;YAC/C,OAAO,EAAE,oBAAoB;YAC7B,QAAQ,EAAE,gBAAgB;SAC3B;QACD;YACE,aAAa,EAAE,mBAAmB;YAClC,OAAO,EAAE,iCAAiC;YAC1C,QAAQ,EAAE,0DAA0D;SACrE;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,+CAA+C;YAC3D,QAAQ,EAAE,qIAAqI;SAChJ;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,2DAA2D;QACpE,KAAK,EAAE,wGAAwG;KAChH;IACD,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,YAAY;IACpB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,IAAI;KACL;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/sscanf.js

@@ -0,0 +1,96 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "sscanf",
+    "category": "strings/core",
+    "keywords": [
+        "sscanf",
+        "strings",
+        "core",
+        "matlab",
+        "compatibility"
+    ],
+    "summary": "Parse formatted values from text.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "No GPU kernel is registered for this compatibility builtin; GPU-resident inputs are gathered to host memory before evaluation."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": null,
+        "constants": "not applicable",
+        "notes": "Not eligible for fusion; this builtin materializes host text or logical results."
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::strings::core::compat::tests",
+        "integration": null
+    },
+    "description": "[A, count, errmsg, nextindex] = sscanf(text, format, size) - Parse formatted values from text.",
+    "signatures": [
+        {
+            "label": "[A, count, errmsg, nextindex] = sscanf(text, format, size)",
+            "inputs": [
+                {
+                    "name": "text",
+                    "ty": "Any",
+                    "arity": "Required",
+                    "default": null,
+                    "description": "Input text."
+                },
+                {
+                    "name": "arg",
+                    "ty": "Any",
+                    "arity": "Variadic",
+                    "default": null,
+                    "description": "Additional arguments."
+                }
+            ],
+            "outputs": [
+                {
+                    "name": "out",
+                    "ty": "Any",
+                    "arity": "Required",
+                    "default": null,
+                    "description": "Output value."
+                }
+            ]
+        }
+    ],
+    "behaviors": [
+        "Parse formatted values from text.",
+        "Supports repeated literal/whitespace-aware scan formats for %f/%e/%g, %d/%i/%u, %s, %c, field widths, assignment suppression, optional size truncation, and requested outputs for count, errmsg, and nextindex.",
+        "String and character scan specifiers return character code values in the numeric output array."
+    ],
+    "examples": [
+        "[A,count,errmsg,nextindex] = sscanf(\"1 2 x\", \"%f\") returns A = [1;2], count = 2, errmsg = \"\", nextindex at the first unconsumed character after the successful scan."
+    ],
+    "faqs": [],
+    "links": [
+        {
+            "label": "string",
+            "url": "./string"
+        },
+        {
+            "label": "char",
+            "url": "./char"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/strings/core/compat.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/strings/core/compat.rs"
+    },
+    "key": "sscanf",
+    "slug": "sscanf",
+    "aliases": [],
+    "categoryPath": [
+        "strings",
+        "core"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=sscanf.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sscanf.js","sourceRoot":"","sources":["../../../src/generated/builtins/sscanf.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,MAAM;QACN,QAAQ;QACR,eAAe;KAChB;IACD,SAAS,EAAE,mCAAmC;IAC9C,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,gIAAgI;KAC1I;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,IAAI;QAClB,WAAW,EAAE,gBAAgB;QAC7B,OAAO,EAAE,kFAAkF;KAC5F;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,wCAAwC;QAChD,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,gGAAgG;IAC/G,YAAY,EAAE;QACZ;YACE,OAAO,EAAE,4DAA4D;YACrE,QAAQ,EAAE;gBACR;oBACE,MAAM,EAAE,MAAM;oBACd,IAAI,EAAE,KAAK;oBACX,OAAO,EAAE,UAAU;oBACnB,SAAS,EAAE,IAAI;oBACf,aAAa,EAAE,aAAa;iBAC7B;gBACD;oBACE,MAAM,EAAE,KAAK;oBACb,IAAI,EAAE,KAAK;oBACX,OAAO,EAAE,UAAU;oBACnB,SAAS,EAAE,IAAI;oBACf,aAAa,EAAE,uBAAuB;iBACvC;aACF;YACD,SAAS,EAAE;gBACT;oBACE,MAAM,EAAE,KAAK;oBACb,IAAI,EAAE,KAAK;oBACX,OAAO,EAAE,UAAU;oBACnB,SAAS,EAAE,IAAI;oBACf,aAAa,EAAE,eAAe;iBAC/B;aACF;SACF;KACF;IACD,WAAW,EAAE;QACX,mCAAmC;QACnC,iNAAiN;QACjN,gGAAgG;KACjG;IACD,UAAU,EAAE;QACV,4KAA4K;KAC7K;IACD,MAAM,EAAE,EAAE;IACV,OAAO,EAAE;QACP;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,6DAA6D;QACtE,KAAK,EAAE,0GAA0G;KAClH;IACD,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,SAAS;QACT,MAAM;KACP;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/stackedplot.js

@@ -0,0 +1,109 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "stackedplot",
+    "category": "plotting",
+    "keywords": [
+        "stackedplot",
+        "stacked plot",
+        "stacked line chart",
+        "table plot",
+        "timetable plot",
+        "matlab stackedplot"
+    ],
+    "summary": "Create a stacked line chart with one y-axis per plotted variable.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "`stackedplot` is a composite chart/rendering sink. RunMat materializes matrix and table columns on the host to split them across stacked axes; grouped table variables can place multiple child lines on one stacked axes."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 2,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::plotting::stackedplot::tests",
+        "vm": "crates/runmat-vm/tests/plotting.rs"
+    },
+    "description": "`stackedplot(Y)` plots vector or matrix data with matrix columns in separate stacked axes and row/column vectors as one series. `stackedplot(X,Y)` uses a common x vector. `stackedplot(tbl)`, `stackedplot(tbl,vars)`, `stackedplot(tbl1,...,tblN)`, and `stackedplot({tbl1,...,tblN})` plot selected numeric, logical, datetime, duration, or categorical table/timetable variables and use timetable row times as x data when available.",
+    "behaviors": [
+        "`Y` can be a vector or matrix. Row and column vectors become one stacked axes; matrix columns become separate stacked axes.",
+        "`X` must be a vector whose length matches the vector length or matrix row count of `Y`.",
+        "Table and timetable inputs select plottable variables by default. Text, cell, struct, and unsupported object variables are skipped unless explicitly selected, in which case the chart errors if no plottable variables remain.",
+        "`vars` and `DisplayVariables` use the shared table variable selector machinery for table inputs, including names, string arrays, cellstr, numeric indices, logical masks, and supported selector objects. `DisplayLabels` accepts text scalars, string arrays, character arrays, or cell arrays of text scalars.",
+        "Multiple table or multiple timetable inputs must be the same tabular kind. Matching variable names combine on one stacked axes by default; `CombineMatchingNames=false` separates them by input.",
+        "`XVariable` selects the common x-axis variable from table inputs. It may be one variable shared by all table inputs or one variable per input table. Timetable row times are used automatically, and `XVariable` is rejected for timetables.",
+        "LineSpec and line style name-value properties apply to every child line.",
+        "The returned handle is a `stackedplot` chart object. `get` supports `Type`, `Parent`, `DisplayVariables`, `SourceTable`, `XVariable`, `CombineMatchingNames`, `XData`, `YData`, `XLabel`, `Title`, `Visible`, `GridVisible`, `XLimits`, `LineWidth`, `LineStyle`, and `Color`. `YData` is a numeric matrix when child lines have matching lengths and a cell array of vectors when multiple source tables have unequal lengths.",
+        "`SourceTable` returns a lightweight provenance snapshot with source table classes and variable names rather than embedding the original table objects in plotting registry state.",
+        "`set` supports `Title`, `XLabel`, `DisplayLabels`, `YLabels`, `Visible`, `GridVisible`, `XLimits`, `Color`, `LineStyle`, `LineWidth`, `Marker`, and `MarkerSize`. `XLimits` accepts finite or infinite numeric bounds as long as the range is increasing.",
+        "Figure handles are accepted as parents. Axes handles, nested grouped `DisplayVariables` cells, event-table rendering, interactive chart controls, and provider-resident column splitting are not implemented yet and raise explicit errors or documented compatibility fallbacks."
+    ],
+    "examples": [
+        {
+            "description": "Plot each matrix column in a separate stacked axes",
+            "input": "Y = [1 10; 2 20; 3 30];\ns = stackedplot(Y);"
+        },
+        {
+            "description": "Use a common x vector and line style",
+            "input": "x = [0 1 2];\nY = [1 10; 2 20; 3 30];\nstackedplot(x, Y, '--o', 'LineWidth', 1.5);"
+        },
+        {
+            "description": "Plot selected table variables",
+            "input": "T = table([1;2;3], [4;5;6], [7;8;9], 'VariableNames', {'Time','A','B'});\ns = stackedplot(T, {'A','B'}, 'XVariable', 'Time');\nget(s, 'DisplayVariables')"
+        },
+        {
+            "description": "Combine matching variables from multiple tables",
+            "input": "T1 = table([1;2], 'VariableNames', {'A'});\nT2 = table([3;4], 'VariableNames', {'A'});\ns = stackedplot(T1, T2, 'A');"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does stackedplot return line handles?",
+            "answer": "No. RunMat returns a first-class `stackedplot` chart handle that owns the child line plots and stacked axes."
+        },
+        {
+            "question": "Does stackedplot preserve gpuArray residency?",
+            "answer": "Not currently. Matrix and table inputs must be split into stacked axes and grouped child lines, so RunMat materializes inputs before handing each child line to the renderer. This is tracked for the dedicated GPU/provider audit rather than hidden behind a partial fast path."
+        }
+    ],
+    "links": [
+        {
+            "label": "plot",
+            "url": "./plot"
+        },
+        {
+            "label": "table",
+            "url": "./table"
+        },
+        {
+            "label": "timetable",
+            "url": "./timetable"
+        },
+        {
+            "label": "get",
+            "url": "./get"
+        },
+        {
+            "label": "set",
+            "url": "./set"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/plotting/ops/stackedplot.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/plotting/ops/stackedplot.rs"
+    },
+    "key": "stackedplot",
+    "slug": "stackedplot",
+    "aliases": [],
+    "categoryPath": [
+        "plotting"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=stackedplot.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stackedplot.js","sourceRoot":"","sources":["../../../src/generated/builtins/stackedplot.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,aAAa;IACtB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,aAAa;QACb,cAAc;QACd,oBAAoB;QACpB,YAAY;QACZ,gBAAgB;QAChB,oBAAoB;KACrB;IACD,SAAS,EAAE,mEAAmE;IAC9E,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,4NAA4N;KACtO;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,wCAAwC;QAChD,IAAI,EAAE,oCAAoC;KAC3C;IACD,aAAa,EAAE,6aAA6a;IAC5b,WAAW,EAAE;QACX,6HAA6H;QAC7H,yFAAyF;QACzF,iOAAiO;QACjO,kTAAkT;QAClT,kMAAkM;QAClM,8OAA8O;QAC9O,0EAA0E;QAC1E,iaAAia;QACja,mLAAmL;QACnL,2PAA2P;QAC3P,mRAAmR;KACpR;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,oDAAoD;YACnE,OAAO,EAAE,8CAA8C;SACxD;QACD;YACE,aAAa,EAAE,sCAAsC;YACrD,OAAO,EAAE,oFAAoF;SAC9F;QACD;YACE,aAAa,EAAE,+BAA+B;YAC9C,OAAO,EAAE,2JAA2J;SACrK;QACD;YACE,aAAa,EAAE,iDAAiD;YAChE,OAAO,EAAE,uHAAuH;SACjI;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,uCAAuC;YACnD,QAAQ,EAAE,8GAA8G;SACzH;QACD;YACE,UAAU,EAAE,+CAA+C;YAC3D,QAAQ,EAAE,mRAAmR;SAC9R;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,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,kEAAkE;QAC3E,KAAK,EAAE,+GAA+G;KACvH;IACD,KAAK,EAAE,aAAa;IACpB,MAAM,EAAE,aAAa;IACrB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/standardizeMissing.js

@@ -0,0 +1,67 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "standardizeMissing",
+    "category": "missing",
+    "keywords": [
+        "standardizeMissing",
+        "missing",
+        "NaN",
+        "string",
+        "table"
+    ],
+    "summary": "Replace user-specified missing indicators with canonical missing values.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "GPU inputs are gathered before standardization."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 2,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::missing::tests",
+        "integration": "crates/runmat-vm/tests/missing_values.rs"
+    },
+    "description": "`standardizeMissing(A, indicators)` converts numeric indicators to `NaN` and text indicators to `<missing>`.",
+    "behaviors": [
+        "Numeric arrays accept scalar or array indicators; `NaN` indicators match existing NaNs.",
+        "String arrays and character-array rows accept text indicators and are converted to the missing string sentinel.",
+        "Cell arrays and tables are processed recursively."
+    ],
+    "examples": [
+        {
+            "description": "Convert sentinel values to NaN",
+            "input": "B = standardizeMissing([-99 2 4], -99)",
+            "output": "B = [NaN 2 4]"
+        }
+    ],
+    "links": [
+        {
+            "label": "ismissing",
+            "url": "./ismissing"
+        },
+        {
+            "label": "fillmissing",
+            "url": "./fillmissing"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/missing/mod.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/missing/mod.rs"
+    },
+    "key": "standardizemissing",
+    "slug": "standardizemissing",
+    "aliases": [],
+    "categoryPath": [
+        "missing"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=standardizeMissing.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"standardizeMissing.js","sourceRoot":"","sources":["../../../src/generated/builtins/standardizeMissing.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,oBAAoB;IAC7B,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE;QACV,oBAAoB;QACpB,SAAS;QACT,KAAK;QACL,QAAQ;QACR,OAAO;KACR;IACD,SAAS,EAAE,0EAA0E;IACrF,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,iDAAiD;KAC3D;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,0BAA0B;QAClC,aAAa,EAAE,0CAA0C;KAC1D;IACD,aAAa,EAAE,8GAA8G;IAC7H,WAAW,EAAE;QACX,yFAAyF;QACzF,iHAAiH;QACjH,mDAAmD;KACpD;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,gCAAgC;YAC/C,OAAO,EAAE,wCAAwC;YACjD,QAAQ,EAAE,eAAe;SAC1B;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;QACD;YACE,OAAO,EAAE,aAAa;YACtB,KAAK,EAAE,eAAe;SACvB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,qDAAqD;QAC9D,KAAK,EAAE,kGAAkG;KAC1G;IACD,KAAK,EAAE,oBAAoB;IAC3B,MAAM,EAAE,oBAAoB;IAC5B,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/statget.js

@@ -0,0 +1,73 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "statget",
+    "category": "stats/options",
+    "keywords": [
+        "statget",
+        "statset",
+        "statistics options"
+    ],
+    "summary": "Read values from statistics options structures.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "Options are host metadata. gpuArray option values are gathered before lookup."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::stats::options::tests",
+        "integration": "crates/runmat-vm/tests/stats_ml.rs"
+    },
+    "description": "`statget(options,field)` returns a field value from a statistics options struct. `statget(options,field,defaultData)` returns `defaultData` when the selected field is empty.",
+    "behaviors": [
+        "`options` must be a struct, typically created by `statset`.",
+        "`field` is matched case-insensitively and can be a unique leading prefix of a known statistics option field.",
+        "If the requested field is recognized but empty, `statget` returns the supplied default value when present, otherwise it returns the empty value.",
+        "If the requested field is not recognized or is ambiguous, RunMat returns an empty numeric value for compatibility with loose MATLAB option probing."
+    ],
+    "examples": [
+        {
+            "description": "Read an explicit option",
+            "input": "opts = statset('TolX', 1e-8);\ntol = statget(opts, 'TolX')",
+            "output": "`tol` is `1e-8`."
+        },
+        {
+            "description": "Use a default for an empty option",
+            "input": "opts = statset('MaxIter', 100);\ntol = statget(opts, 'TolFun', 1e-6)",
+            "output": "`tol` is `1e-6` because `TolFun` is empty."
+        },
+        {
+            "description": "Use a unique prefix",
+            "input": "opts = statset('MaxIter', 100);\niter = statget(opts, 'MaxI')",
+            "output": "`iter` is `100`."
+        }
+    ],
+    "links": [
+        {
+            "label": "statset",
+            "url": "./statset"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/stats/options.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/stats/options.rs"
+    },
+    "key": "statget",
+    "slug": "statget",
+    "aliases": [],
+    "categoryPath": [
+        "stats",
+        "options"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=statget.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"statget.js","sourceRoot":"","sources":["../../../src/generated/builtins/statget.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,eAAe;IAC3B,UAAU,EAAE;QACV,SAAS;QACT,SAAS;QACT,oBAAoB;KACrB;IACD,SAAS,EAAE,iDAAiD;IAC5D,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,+EAA+E;KACzF;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;KACtB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,iCAAiC;QACzC,aAAa,EAAE,oCAAoC;KACpD;IACD,aAAa,EAAE,+KAA+K;IAC9L,WAAW,EAAE;QACX,6DAA6D;QAC7D,8GAA8G;QAC9G,kJAAkJ;QAClJ,qJAAqJ;KACtJ;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,yBAAyB;YACxC,OAAO,EAAE,4DAA4D;YACrE,QAAQ,EAAE,kBAAkB;SAC7B;QACD;YACE,aAAa,EAAE,mCAAmC;YAClD,OAAO,EAAE,sEAAsE;YAC/E,QAAQ,EAAE,4CAA4C;SACvD;QACD;YACE,aAAa,EAAE,qBAAqB;YACpC,OAAO,EAAE,+DAA+D;YACxE,QAAQ,EAAE,kBAAkB;SAC7B;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,uDAAuD;QAChE,KAAK,EAAE,oGAAoG;KAC5G;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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