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

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

@@ -0,0 +1 @@
+{"version":3,"file":"mustBeText.js","sourceRoot":"","sources":["../../../src/generated/builtins/mustBeText.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,YAAY;IACrB,UAAU,EAAE,qBAAqB;IACjC,UAAU,EAAE;QACV,YAAY;QACZ,qBAAqB;QACrB,iBAAiB;QACjB,sBAAsB;KACvB;IACD,SAAS,EAAE,gCAAgC;IAC3C,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,qFAAqF;QAC7F,aAAa,EAAE,2IAA2I;KAC3J;IACD,aAAa,EAAE,yZAAyZ;IACxa,WAAW,EAAE;QACX,gIAAgI;QAChI,sHAAsH;QACtH,+JAA+J;QAC/J,6IAA6I;KAC9I;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,gDAAgD;YAC/D,OAAO,EAAE,eAAe;YACxB,QAAQ,EAAE,6EAA6E;SACxF;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,mDAAmD;YAC/D,QAAQ,EAAE,+JAA+J;SAC1K;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,oBAAoB;YAC7B,KAAK,EAAE,uBAAuB;SAC/B;KACF;IACD,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,YAAY;IACpB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,qBAAqB;KACtB;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/mustBeTextScalar.js

@@ -0,0 +1,65 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "mustBeTextScalar",
+    "category": "argument-validation",
+    "keywords": [
+        "mustBeTextScalar",
+        "argument validation",
+        "arguments block",
+        "MATLAB compatibility"
+    ],
+    "summary": "Validate that a value is a scalar text value.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "Validators run on host values and metadata; they throw on validation failure."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "crates/runmat-runtime/src/builtins/common/validation.rs table-style pass/fail tests",
+        "integration": "Representative callable and arguments-block coverage in crates/runmat-vm/tests/functions.rs; not every validator has a dedicated VM case."
+    },
+    "description": "`mustBeTextScalar` is available as a callable MATLAB argument validator. It returns no user-facing value when validation passes and throws a structured RunMat error when validation fails. Validators with literal/static payloads are also encoded in MATLAB `arguments` blocks; dynamic validator payload expressions should call the validator directly until runtime-evaluated arguments-block payloads are implemented.",
+    "behaviors": [
+        "Callable validator forms enforce exact supported arity, throw on validation failure, and suppress automatic output on success.",
+        "Arguments-block validation uses the same shared runtime predicates for validators that RunMat can encode statically.",
+        "Numeric validators check every element without materializing a cloned numeric array, including sparse stored values and implicit sparse zeros where relevant.",
+        "Text validators accept string scalars/arrays, character row vectors, and compatible cell arrays of text where MATLAB commonly permits them."
+    ],
+    "examples": [
+        {
+            "description": "Using the validator as a normal callable guard",
+            "input": "mustBeTextScalar(A)",
+            "output": "No output when validation passes; an error is thrown when validation fails."
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does this validator work in an `arguments` block?",
+            "answer": "Yes for literal/static validator payloads that RunMat can encode at compile time. Dynamic validator payload expressions should use the callable form for now."
+        }
+    ],
+    "links": [
+        {
+            "label": "`arguments` blocks",
+            "url": "../language/arguments"
+        }
+    ],
+    "key": "mustbetextscalar",
+    "slug": "mustbetextscalar",
+    "aliases": [],
+    "categoryPath": [
+        "argument-validation"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=mustBeTextScalar.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mustBeTextScalar.js","sourceRoot":"","sources":["../../../src/generated/builtins/mustBeTextScalar.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,kBAAkB;IAC3B,UAAU,EAAE,qBAAqB;IACjC,UAAU,EAAE;QACV,kBAAkB;QAClB,qBAAqB;QACrB,iBAAiB;QACjB,sBAAsB;KACvB;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,+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,qFAAqF;QAC7F,aAAa,EAAE,2IAA2I;KAC3J;IACD,aAAa,EAAE,+ZAA+Z;IAC9a,WAAW,EAAE;QACX,gIAAgI;QAChI,sHAAsH;QACtH,+JAA+J;QAC/J,6IAA6I;KAC9I;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,gDAAgD;YAC/D,OAAO,EAAE,qBAAqB;YAC9B,QAAQ,EAAE,6EAA6E;SACxF;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,mDAAmD;YAC/D,QAAQ,EAAE,+JAA+J;SAC1K;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,oBAAoB;YAC7B,KAAK,EAAE,uBAAuB;SAC/B;KACF;IACD,KAAK,EAAE,kBAAkB;IACzB,MAAM,EAAE,kBAAkB;IAC1B,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,qBAAqB;KACtB;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/mustBeUnderlyingType.js

@@ -0,0 +1,66 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "mustBeUnderlyingType",
+    "category": "argument-validation",
+    "keywords": [
+        "mustBeUnderlyingType",
+        "argument validation",
+        "arguments block",
+        "MATLAB compatibility"
+    ],
+    "summary": "Validate that numeric or logical storage uses a requested underlying type.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "Validators run on host values and metadata; they throw on validation failure."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "crates/runmat-runtime/src/builtins/common/validation.rs table-style pass/fail tests",
+        "integration": "Representative callable and arguments-block coverage in crates/runmat-vm/tests/functions.rs; not every validator has a dedicated VM case."
+    },
+    "description": "`mustBeUnderlyingType` is available as a callable MATLAB argument validator. It returns no user-facing value when validation passes and throws a structured RunMat error when validation fails. Validators with literal/static payloads are also encoded in MATLAB `arguments` blocks; dynamic validator payload expressions should call the validator directly until runtime-evaluated arguments-block payloads are implemented.",
+    "behaviors": [
+        "Callable validator forms enforce exact supported arity, throw on validation failure, and suppress automatic output on success.",
+        "Arguments-block validation uses the same shared runtime predicates for validators that RunMat can encode statically.",
+        "Requested type names are compared exactly after trimming surrounding whitespace, matching `isUnderlyingType` and `underlyingType`.",
+        "Numeric validators check every element without materializing a cloned numeric array, including sparse stored values and implicit sparse zeros where relevant.",
+        "Text validators accept string scalars/arrays, character row vectors, and compatible cell arrays of text where MATLAB commonly permits them."
+    ],
+    "examples": [
+        {
+            "description": "Using the validator as a normal callable guard",
+            "input": "mustBeUnderlyingType(A, \"double\")",
+            "output": "No output when validation passes; an error is thrown when validation fails."
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does this validator work in an `arguments` block?",
+            "answer": "Yes for literal/static validator payloads that RunMat can encode at compile time. Dynamic validator payload expressions should use the callable form for now."
+        }
+    ],
+    "links": [
+        {
+            "label": "`arguments` blocks",
+            "url": "../language/arguments"
+        }
+    ],
+    "key": "mustbeunderlyingtype",
+    "slug": "mustbeunderlyingtype",
+    "aliases": [],
+    "categoryPath": [
+        "argument-validation"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=mustBeUnderlyingType.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mustBeUnderlyingType.js","sourceRoot":"","sources":["../../../src/generated/builtins/mustBeUnderlyingType.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,sBAAsB;IAC/B,UAAU,EAAE,qBAAqB;IACjC,UAAU,EAAE;QACV,sBAAsB;QACtB,qBAAqB;QACrB,iBAAiB;QACjB,sBAAsB;KACvB;IACD,SAAS,EAAE,4EAA4E;IACvF,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,qFAAqF;QAC7F,aAAa,EAAE,2IAA2I;KAC3J;IACD,aAAa,EAAE,maAAma;IAClb,WAAW,EAAE;QACX,gIAAgI;QAChI,sHAAsH;QACtH,oIAAoI;QACpI,+JAA+J;QAC/J,6IAA6I;KAC9I;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,gDAAgD;YAC/D,OAAO,EAAE,qCAAqC;YAC9C,QAAQ,EAAE,6EAA6E;SACxF;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,mDAAmD;YAC/D,QAAQ,EAAE,+JAA+J;SAC1K;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,oBAAoB;YAC7B,KAAK,EAAE,uBAAuB;SAC/B;KACF;IACD,KAAK,EAAE,sBAAsB;IAC7B,MAAM,EAAE,sBAAsB;IAC9B,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,qBAAqB;KACtB;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/mustBeValidVariableName.js

@@ -0,0 +1,66 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "mustBeValidVariableName",
+    "category": "argument-validation",
+    "keywords": [
+        "mustBeValidVariableName",
+        "argument validation",
+        "arguments block",
+        "MATLAB compatibility"
+    ],
+    "summary": "Validate that text values are valid MATLAB variable names.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "Validators run on host values and metadata; they throw on validation failure."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "crates/runmat-runtime/src/builtins/common/validation.rs table-style pass/fail tests",
+        "integration": "Representative callable and arguments-block coverage in crates/runmat-vm/tests/functions.rs; not every validator has a dedicated VM case."
+    },
+    "description": "`mustBeValidVariableName` is available as a callable MATLAB argument validator. It returns no user-facing value when validation passes and throws a structured RunMat error when validation fails. Validators with literal/static payloads are also encoded in MATLAB `arguments` blocks; dynamic validator payload expressions should call the validator directly until runtime-evaluated arguments-block payloads are implemented.",
+    "behaviors": [
+        "Callable validator forms enforce exact supported arity, throw on validation failure, and suppress automatic output on success.",
+        "Arguments-block validation uses the same shared runtime predicates for validators that RunMat can encode statically.",
+        "Numeric validators check every element without materializing a cloned numeric array, including sparse stored values and implicit sparse zeros where relevant.",
+        "Text validators accept string scalars/arrays, character row vectors, and compatible cell arrays of text where MATLAB commonly permits them.",
+        "Variable names must be nonempty, start with a letter, stay within `namelengthmax`, contain only letters/digits/underscores after the first character, and not be MATLAB keywords."
+    ],
+    "examples": [
+        {
+            "description": "Using the validator as a normal callable guard",
+            "input": "mustBeValidVariableName(A)",
+            "output": "No output when validation passes; an error is thrown when validation fails."
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does this validator work in an `arguments` block?",
+            "answer": "Yes for literal/static validator payloads that RunMat can encode at compile time. Dynamic validator payload expressions should use the callable form for now."
+        }
+    ],
+    "links": [
+        {
+            "label": "`arguments` blocks",
+            "url": "../language/arguments"
+        }
+    ],
+    "key": "mustbevalidvariablename",
+    "slug": "mustbevalidvariablename",
+    "aliases": [],
+    "categoryPath": [
+        "argument-validation"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=mustBeValidVariableName.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mustBeValidVariableName.js","sourceRoot":"","sources":["../../../src/generated/builtins/mustBeValidVariableName.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,yBAAyB;IAClC,UAAU,EAAE,qBAAqB;IACjC,UAAU,EAAE;QACV,yBAAyB;QACzB,qBAAqB;QACrB,iBAAiB;QACjB,sBAAsB;KACvB;IACD,SAAS,EAAE,4DAA4D;IACvE,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,qFAAqF;QAC7F,aAAa,EAAE,2IAA2I;KAC3J;IACD,aAAa,EAAE,saAAsa;IACrb,WAAW,EAAE;QACX,gIAAgI;QAChI,sHAAsH;QACtH,+JAA+J;QAC/J,6IAA6I;QAC7I,mLAAmL;KACpL;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,gDAAgD;YAC/D,OAAO,EAAE,4BAA4B;YACrC,QAAQ,EAAE,6EAA6E;SACxF;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,mDAAmD;YAC/D,QAAQ,EAAE,+JAA+J;SAC1K;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,oBAAoB;YAC7B,KAAK,EAAE,uBAAuB;SAC/B;KACF;IACD,KAAK,EAAE,yBAAyB;IAChC,MAAM,EAAE,yBAAyB;IACjC,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,qBAAqB;KACtB;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/mustBeVector.js

@@ -0,0 +1,65 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "mustBeVector",
+    "category": "argument-validation",
+    "keywords": [
+        "mustBeVector",
+        "argument validation",
+        "arguments block",
+        "MATLAB compatibility"
+    ],
+    "summary": "Validate that a value is vector-shaped.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "Validators run on host values and metadata; they throw on validation failure."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "crates/runmat-runtime/src/builtins/common/validation.rs table-style pass/fail tests",
+        "integration": "Representative callable and arguments-block coverage in crates/runmat-vm/tests/functions.rs; not every validator has a dedicated VM case."
+    },
+    "description": "`mustBeVector` is available as a callable MATLAB argument validator. It returns no user-facing value when validation passes and throws a structured RunMat error when validation fails. Validators with literal/static payloads are also encoded in MATLAB `arguments` blocks; dynamic validator payload expressions should call the validator directly until runtime-evaluated arguments-block payloads are implemented.",
+    "behaviors": [
+        "Callable validator forms enforce exact supported arity, throw on validation failure, and suppress automatic output on success.",
+        "Arguments-block validation uses the same shared runtime predicates for validators that RunMat can encode statically.",
+        "Numeric validators check every element without materializing a cloned numeric array, including sparse stored values and implicit sparse zeros where relevant.",
+        "Text validators accept string scalars/arrays, character row vectors, and compatible cell arrays of text where MATLAB commonly permits them."
+    ],
+    "examples": [
+        {
+            "description": "Using the validator as a normal callable guard",
+            "input": "mustBeVector(A)",
+            "output": "No output when validation passes; an error is thrown when validation fails."
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does this validator work in an `arguments` block?",
+            "answer": "Yes for literal/static validator payloads that RunMat can encode at compile time. Dynamic validator payload expressions should use the callable form for now."
+        }
+    ],
+    "links": [
+        {
+            "label": "`arguments` blocks",
+            "url": "../language/arguments"
+        }
+    ],
+    "key": "mustbevector",
+    "slug": "mustbevector",
+    "aliases": [],
+    "categoryPath": [
+        "argument-validation"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=mustBeVector.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mustBeVector.js","sourceRoot":"","sources":["../../../src/generated/builtins/mustBeVector.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,cAAc;IACvB,UAAU,EAAE,qBAAqB;IACjC,UAAU,EAAE;QACV,cAAc;QACd,qBAAqB;QACrB,iBAAiB;QACjB,sBAAsB;KACvB;IACD,SAAS,EAAE,yCAAyC;IACpD,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,qFAAqF;QAC7F,aAAa,EAAE,2IAA2I;KAC3J;IACD,aAAa,EAAE,2ZAA2Z;IAC1a,WAAW,EAAE;QACX,gIAAgI;QAChI,sHAAsH;QACtH,+JAA+J;QAC/J,6IAA6I;KAC9I;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,gDAAgD;YAC/D,OAAO,EAAE,iBAAiB;YAC1B,QAAQ,EAAE,6EAA6E;SACxF;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,mDAAmD;YAC/D,QAAQ,EAAE,+JAA+J;SAC1K;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,oBAAoB;YAC7B,KAAK,EAAE,uBAAuB;SAC/B;KACF;IACD,KAAK,EAAE,cAAc;IACrB,MAAM,EAAE,cAAc;IACtB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,qBAAqB;KACtB;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/mvnrnd.js

@@ -0,0 +1,99 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "mvnrnd",
+    "category": "stats/random",
+    "keywords": [
+        "mvnrnd",
+        "multivariate normal",
+        "gaussian",
+        "random",
+        "statistics"
+    ],
+    "summary": "Generate multivariate normal random samples.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f64"
+        ],
+        "broadcasting": "none",
+        "notes": "Sampling currently runs on the host RNG path. GPU inputs are gathered to host."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "none"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::stats::random::mvnrnd::tests",
+        "integration": "crates/runmat-vm/tests/stats_ml.rs"
+    },
+    "description": "`mvnrnd(mu,Sigma)` draws rows from one or more multivariate normal distributions. `mu` supplies mean vectors and `Sigma` supplies covariance matrices.",
+    "behaviors": [
+        "`mu` can be a scalar, a vector, or an m-by-d matrix with one mean vector per row. A d-by-1 column vector is treated as d one-dimensional means.",
+        "`Sigma` can be a d-by-d covariance matrix, a 1-by-d diagonal-variance vector, a d-by-d-by-m array of covariance pages, or a 1-by-d-by-m array of diagonal-variance pages.",
+        "`mvnrnd(mu,Sigma,n)` draws `n` rows when `mu` is a single mean vector and `Sigma` has one covariance page; `n` must be a positive scalar integer.",
+        "Without `n`, RunMat draws one row for each row of `mu`, each page of `Sigma`, or their shared row/page count.",
+        "A single covariance matrix is reused for all rows of matrix `mu`; a single mean vector is reused for all covariance pages.",
+        "`Sigma` must be symmetric positive semidefinite. Positive-definite covariances use Cholesky; singular semidefinite covariances use a symmetric eigen factor.",
+        "All inputs must be real finite numeric values, and outputs are double precision with observations in rows."
+    ],
+    "examples": [
+        {
+            "description": "Draw five bivariate samples",
+            "input": "rng('default');\nR = mvnrnd([1 2], [4 1; 1 9], 5)"
+        },
+        {
+            "description": "Use one covariance page per mean row",
+            "input": "mu = [0 0; 10 20];\nSigma = cat(3, eye(2), [4 0; 0 9]);\nR = mvnrnd(mu, Sigma)"
+        },
+        {
+            "description": "Use diagonal variances",
+            "input": "R = mvnrnd([1 2], [4 9], 5)"
+        },
+        {
+            "description": "Draw from a singular covariance",
+            "input": "R = mvnrnd([0 0], [1 1; 1 1], 3)"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does mvnrnd use the same RNG as randn and normrnd?",
+            "answer": "Yes. RunMat draws standard normal variates from the shared deterministic RNG state, so `rng` controls reproducibility."
+        },
+        {
+            "question": "Does RunMat require Sigma to be positive definite?",
+            "answer": "No. Positive semidefinite covariance matrices are accepted. Negative eigenvalues outside numerical tolerance raise an error."
+        }
+    ],
+    "links": [
+        {
+            "label": "normrnd",
+            "url": "./normrnd"
+        },
+        {
+            "label": "randn",
+            "url": "./randn"
+        },
+        {
+            "label": "rng",
+            "url": "./rng"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/stats/random/mvnrnd.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/stats/random/mvnrnd.rs"
+    },
+    "key": "mvnrnd",
+    "slug": "mvnrnd",
+    "aliases": [],
+    "categoryPath": [
+        "stats",
+        "random"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=mvnrnd.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mvnrnd.js","sourceRoot":"","sources":["../../../src/generated/builtins/mvnrnd.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,qBAAqB;QACrB,UAAU;QACV,QAAQ;QACR,YAAY;KACb;IACD,SAAS,EAAE,8CAA8C;IACzD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;SACN;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,gFAAgF;KAC1F;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,wCAAwC;QAChD,aAAa,EAAE,oCAAoC;KACpD;IACD,aAAa,EAAE,wJAAwJ;IACvK,WAAW,EAAE;QACX,iJAAiJ;QACjJ,2KAA2K;QAC3K,mJAAmJ;QACnJ,+GAA+G;QAC/G,4HAA4H;QAC5H,8JAA8J;QAC9J,4GAA4G;KAC7G;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,6BAA6B;YAC5C,OAAO,EAAE,mDAAmD;SAC7D;QACD;YACE,aAAa,EAAE,sCAAsC;YACrD,OAAO,EAAE,gFAAgF;SAC1F;QACD;YACE,aAAa,EAAE,wBAAwB;YACvC,OAAO,EAAE,6BAA6B;SACvC;QACD;YACE,aAAa,EAAE,iCAAiC;YAChD,OAAO,EAAE,kCAAkC;SAC5C;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,oDAAoD;YAChE,QAAQ,EAAE,wHAAwH;SACnI;QACD;YACE,UAAU,EAAE,oDAAoD;YAChE,QAAQ,EAAE,8HAA8H;SACzI;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;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,OAAO;QACP,QAAQ;KACT;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/namedargs2cell.js

@@ -0,0 +1,52 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "namedargs2cell",
+    "category": "argument-validation",
+    "keywords": [
+        "namedargs2cell",
+        "name-value arguments",
+        "MATLAB compatibility"
+    ],
+    "summary": "Convert a scalar name-value struct into an alternating name/value cell row.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "Host metadata/text helper."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 1,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::common::validation::tests",
+        "integration": "crates/runmat-vm/tests/functions.rs::argument_validation_helpers_are_callable_builtins"
+    },
+    "description": "`namedargs2cell(S)` preserves scalar struct field order and returns `{name1, value1, name2, value2, ...}` for name-value forwarding patterns.",
+    "behaviors": [
+        "Returns a normal value and does not mutate inputs.",
+        "Accepts MATLAB text/struct representations supported by RunMat."
+    ],
+    "examples": [
+        {
+            "description": "Basic use",
+            "input": "namedargs2cell(x)",
+            "output": "Result depends on input value."
+        }
+    ],
+    "faqs": [],
+    "links": [],
+    "key": "namedargs2cell",
+    "slug": "namedargs2cell",
+    "aliases": [],
+    "categoryPath": [
+        "argument-validation"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=namedargs2cell.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"namedargs2cell.js","sourceRoot":"","sources":["../../../src/generated/builtins/namedargs2cell.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,gBAAgB;IACzB,UAAU,EAAE,qBAAqB;IACjC,UAAU,EAAE;QACV,gBAAgB;QAChB,sBAAsB;QACtB,sBAAsB;KACvB;IACD,SAAS,EAAE,6EAA6E;IACxF,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,4BAA4B;KACtC;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;KACtB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,qCAAqC;QAC7C,aAAa,EAAE,wFAAwF;KACxG;IACD,aAAa,EAAE,+IAA+I;IAC9J,WAAW,EAAE;QACX,oDAAoD;QACpD,iEAAiE;KAClE;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,WAAW;YAC1B,OAAO,EAAE,mBAAmB;YAC5B,QAAQ,EAAE,gCAAgC;SAC3C;KACF;IACD,MAAM,EAAE,EAAE;IACV,OAAO,EAAE,EAAE;IACX,KAAK,EAAE,gBAAgB;IACvB,MAAM,EAAE,gBAAgB;IACxB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,qBAAqB;KACtB;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/namelengthmax.js

@@ -0,0 +1,86 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "namelengthmax",
+    "category": "introspection",
+    "keywords": [
+        "namelengthmax",
+        "identifier",
+        "variable name",
+        "field name",
+        "MATLAB compatibility"
+    ],
+    "summary": "Return the maximum MATLAB identifier length.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "Host language constant; no GPU kernels or provider dispatch are involved."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::introspection::identifiers::tests",
+        "integration": null
+    },
+    "description": "`namelengthmax` returns the maximum number of characters allowed in MATLAB identifiers. RunMat reports `2048`, matching current MATLAB behavior.",
+    "behaviors": [
+        "Accepts no input arguments and returns a double scalar.",
+        "The shared identifier validator uses the same value for `isvarname`, `genvarname`, struct field-name validation, and argument-validation helpers.",
+        "Identifiers longer than `namelengthmax` are rejected by `isvarname` and repaired or truncated by compatibility helpers that generate names."
+    ],
+    "examples": [
+        {
+            "description": "Read the identifier length limit",
+            "input": "l = namelengthmax",
+            "output": "l = 2048"
+        },
+        {
+            "description": "Use the limit when validating generated names",
+            "input": "name = repmat('a', 1, namelengthmax);\ntf = isvarname(name)",
+            "output": "tf = logical(1)"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Why is the value 2048 rather than 63?",
+            "answer": "Older MATLAB releases used 63. Current MATLAB releases report 2048, and RunMat follows the current compatibility surface."
+        },
+        {
+            "question": "Does this run on the GPU?",
+            "answer": "No. This is a language metadata constant and always returns a host scalar."
+        }
+    ],
+    "links": [
+        {
+            "label": "isvarname",
+            "url": "./isvarname"
+        },
+        {
+            "label": "iskeyword",
+            "url": "./iskeyword"
+        },
+        {
+            "label": "genvarname",
+            "url": "./genvarname"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/introspection/identifiers.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/introspection/identifiers.rs"
+    },
+    "key": "namelengthmax",
+    "slug": "namelengthmax",
+    "aliases": [],
+    "categoryPath": [
+        "introspection"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=namelengthmax.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"namelengthmax.js","sourceRoot":"","sources":["../../../src/generated/builtins/namelengthmax.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,eAAe;IACxB,UAAU,EAAE,eAAe;IAC3B,UAAU,EAAE;QACV,eAAe;QACf,YAAY;QACZ,eAAe;QACf,YAAY;QACZ,sBAAsB;KACvB;IACD,SAAS,EAAE,8CAA8C;IACzD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,2EAA2E;KACrF;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,6CAA6C;QACrD,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,kJAAkJ;IACjK,WAAW,EAAE;QACX,yDAAyD;QACzD,mJAAmJ;QACnJ,6IAA6I;KAC9I;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,kCAAkC;YACjD,OAAO,EAAE,mBAAmB;YAC5B,QAAQ,EAAE,UAAU;SACrB;QACD;YACE,aAAa,EAAE,+CAA+C;YAC9D,OAAO,EAAE,6DAA6D;YACtE,QAAQ,EAAE,iBAAiB;SAC5B;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,uCAAuC;YACnD,QAAQ,EAAE,2HAA2H;SACtI;QACD;YACE,UAAU,EAAE,2BAA2B;YACvC,QAAQ,EAAE,4EAA4E;SACvF;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;QACD;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;QACD;YACE,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,cAAc;SACtB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,mEAAmE;QAC5E,KAAK,EAAE,gHAAgH;KACxH;IACD,KAAK,EAAE,eAAe;IACtB,MAAM,EAAE,eAAe;IACvB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,eAAe;KAChB;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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