runmat 0.5.7-dev.3 → 0.5.7-dev.4

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

@@ -0,0 +1 @@
+{"version":3,"file":"istriu.js","sourceRoot":"","sources":["../../../src/generated/builtins/istriu.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,QAAQ;IACjB,UAAU,EAAE,uBAAuB;IACnC,UAAU,EAAE;QACV,QAAQ;QACR,kBAAkB;QAClB,kBAAkB;QAClB,QAAQ;QACR,KAAK;KACN;IACD,SAAS,EAAE,sEAAsE;IACjF,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;YACL,KAAK;SACN;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,2KAA2K;KACrL;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,+DAA+D;QACvE,aAAa,EAAE,oHAAoH;KACpI;IACD,aAAa,EAAE,4FAA4F;IAC3G,WAAW,EAAE;QACX,+BAA+B;QAC/B,sDAAsD;QACtD,qCAAqC;QACrC,0EAA0E;QAC1E,iFAAiF;QACjF,4DAA4D;QAC5D,oHAAoH;KACrH;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,qCAAqC;YACpD,OAAO,EAAE,4CAA4C;YACrD,QAAQ,EAAE,oBAAoB;SAC/B;QACD;YACE,aAAa,EAAE,2CAA2C;YAC1D,OAAO,EAAE,iCAAiC;YAC1C,QAAQ,EAAE,oBAAoB;SAC/B;QACD;YACE,aAAa,EAAE,+BAA+B;YAC9C,OAAO,EAAE,qCAAqC;YAC9C,QAAQ,EAAE,oBAAoB;SAC/B;QACD;YACE,aAAa,EAAE,kCAAkC;YACjD,OAAO,EAAE,8CAA8C;YACvD,QAAQ,EAAE,oBAAoB;SAC/B;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,qCAAqC;YACjD,QAAQ,EAAE,oEAAoE;SAC/E;QACD;YACE,UAAU,EAAE,yCAAyC;YACrD,QAAQ,EAAE,sFAAsF;SACjG;QACD;YACE,UAAU,EAAE,kCAAkC;YAC9C,QAAQ,EAAE,qIAAqI;SAChJ;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,mFAAmF;QAC5F,KAAK,EAAE,gIAAgI;KACxI;IACD,eAAe,EAAE,4SAA4S;IAC7T,cAAc,EAAE;QACd,+MAA+M;KAChN;IACD,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,QAAQ;QACR,WAAW;KACZ;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/isvarname.js

@@ -0,0 +1,53 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "isvarname",
+    "category": "argument-validation",
+    "keywords": [
+        "isvarname",
+        "name-value arguments",
+        "MATLAB compatibility"
+    ],
+    "summary": "Return true when text is a valid MATLAB variable name.",
+    "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": "crates/runmat-runtime/src/builtins/common/validation.rs varname positive and negative tests",
+        "integration": "crates/runmat-vm/tests/functions.rs::argument_validation_helpers_are_callable_builtins"
+    },
+    "description": "`isvarname(S)` returns a logical scalar indicating whether text is a valid MATLAB variable name: nonempty, starts with a letter, is at most `namelengthmax` characters, contains only letters, digits, and underscores after the first character, and is not a MATLAB keyword.",
+    "behaviors": [
+        "Returns a normal logical value and does not mutate inputs.",
+        "Accepts MATLAB text representations supported by RunMat.",
+        "Rejects names that start with underscores or digits, MATLAB keywords such as `for` and `end`, and names longer than `namelengthmax` characters."
+    ],
+    "examples": [
+        {
+            "description": "Basic use",
+            "input": "isvarname(x)",
+            "output": "Result depends on input value."
+        }
+    ],
+    "faqs": [],
+    "links": [],
+    "key": "isvarname",
+    "slug": "isvarname",
+    "aliases": [],
+    "categoryPath": [
+        "argument-validation"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=isvarname.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"isvarname.js","sourceRoot":"","sources":["../../../src/generated/builtins/isvarname.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,WAAW;IACpB,UAAU,EAAE,qBAAqB;IACjC,UAAU,EAAE;QACV,WAAW;QACX,sBAAsB;QACtB,sBAAsB;KACvB;IACD,SAAS,EAAE,wDAAwD;IACnE,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,6FAA6F;QACrG,aAAa,EAAE,wFAAwF;KACxG;IACD,aAAa,EAAE,gRAAgR;IAC/R,WAAW,EAAE;QACX,4DAA4D;QAC5D,0DAA0D;QAC1D,iJAAiJ;KAClJ;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,WAAW;YAC1B,OAAO,EAAE,cAAc;YACvB,QAAQ,EAAE,gCAAgC;SAC3C;KACF;IACD,MAAM,EAAE,EAAE;IACV,OAAO,EAAE,EAAE;IACX,KAAK,EAAE,WAAW;IAClB,MAAM,EAAE,WAAW;IACnB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,qBAAqB;KACtB;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/keyboard.js

@@ -0,0 +1,69 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "keyboard",
+    "category": "introspection",
+    "keywords": [
+        "keyboard",
+        "debug",
+        "breakpoint"
+    ],
+    "summary": "Compatibility no-op for MATLAB keyboard debugging stops.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "Host-side debugger control only."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": null,
+        "integration": "debugger_compat_commands_execute_through_core"
+    },
+    "description": "`keyboard` is accepted so MATLAB scripts containing manual debug stops continue to run under RunMat.",
+    "behaviors": [
+        "`keyboard` accepts no inputs and returns no outputs.",
+        "RunMat currently treats it as a deterministic no-op. It does not enter MATLAB's interactive `K>>` debug prompt.",
+        "Interactive debugger suspension is a broader runtime/REPL feature and is not implemented by this builtin."
+    ],
+    "examples": [
+        {
+            "description": "Accept a manual debug stop without halting batch execution",
+            "input": "keyboard"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does RunMat enter an interactive debugger for `keyboard`?",
+            "answer": "No. The command is accepted as a no-op until interactive debugger infrastructure exists."
+        }
+    ],
+    "links": [
+        {
+            "label": "dbstack",
+            "url": "./dbstack"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/introspection/debugging.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/introspection/debugging.rs"
+    },
+    "gpu_behavior": [
+        "`keyboard` is control-flow debugger compatibility and has no GPU/provider behavior."
+    ],
+    "key": "keyboard",
+    "slug": "keyboard",
+    "aliases": [],
+    "categoryPath": [
+        "introspection"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=keyboard.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.js","sourceRoot":"","sources":["../../../src/generated/builtins/keyboard.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,OAAO;QACP,YAAY;KACb;IACD,SAAS,EAAE,0DAA0D;IACrE,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,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,QAAQ;KACtB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,IAAI;QACZ,aAAa,EAAE,+CAA+C;KAC/D;IACD,aAAa,EAAE,sGAAsG;IACrH,WAAW,EAAE;QACX,sDAAsD;QACtD,iHAAiH;QACjH,2GAA2G;KAC5G;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,4DAA4D;YAC3E,OAAO,EAAE,UAAU;SACpB;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,2DAA2D;YACvE,QAAQ,EAAE,0FAA0F;SACrG;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,iEAAiE;QAC1E,KAAK,EAAE,8GAA8G;KACtH;IACD,cAAc,EAAE;QACd,qFAAqF;KACtF;IACD,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,eAAe;KAChB;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/kmeans.js

@@ -0,0 +1,107 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "kmeans",
+    "category": "stats/ml",
+    "keywords": [
+        "kmeans",
+        "k-means",
+        "clustering",
+        "statistics",
+        "machine learning"
+    ],
+    "summary": "Partition observations into k clusters with k-means clustering.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f64"
+        ],
+        "broadcasting": "none",
+        "notes": "GPU inputs are gathered to host. Clustering runs on CPU because it is iterative and metadata-heavy."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "none"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::stats::ml::kmeans::tests",
+        "integration": "crates/runmat-vm/tests/stats_ml.rs"
+    },
+    "description": "`kmeans(X,k)` clusters the rows of a numeric observation matrix into `k` clusters. It supports MATLAB-style multi-output use: `[idx,C,sumd,D] = kmeans(...)`.",
+    "behaviors": [
+        "`X` must be a real numeric vector or 2-D matrix. Matrix rows are observations; row and column vectors are treated as one-dimensional observations.",
+        "Rows containing `NaN` are omitted from fitting and receive `NaN` in the returned `idx` and `D` outputs. `Inf` values are rejected.",
+        "The default distance is `\"sqeuclidean\"`. Supported distances are `\"sqeuclidean\"`, `\"cityblock\"`, `\"cosine\"`, `\"correlation\"`, and `\"hamming\"`.",
+        "`Start` supports `\"plus\"`, `\"sample\"`, `\"uniform\"`, `\"cluster\"`, a numeric `k`-by-`p` start matrix, or a numeric `k`-by-`p`-by-`r` array of replicate starts.",
+        "When `Start` is numeric, `k` can be `[]`; RunMat infers the cluster count from the first dimension of the start matrix or array.",
+        "`Replicates` runs multiple starts and returns the result with the smallest finite within-cluster objective. Numeric 3-D starts set the replicate count from their third dimension.",
+        "`MaxIter` limits Lloyd iterations. `EmptyAction` supports `\"singleton\"`, `\"error\"`, and `\"drop\"`.",
+        "`Display` is accepted for script compatibility. `OnlinePhase=\"on\"` runs an additional bounded batch-refinement phase in the CPU runtime.",
+        "`Options` accepts statset-style structs. `MaxIter` and `Display` fields are honored; parallel stream fields are rejected when enabled because RunMat's CPU implementation is single-process.",
+        "For `\"cityblock\"` and `\"hamming\"`, RunMat updates centroids with component-wise medians. Other distances use mean centroids in the metric's transformed space.",
+        "Outputs are `idx`, centroid matrix `C`, per-cluster distance sums `sumd`, and the observation-by-cluster distance matrix `D`."
+    ],
+    "examples": [
+        {
+            "description": "Cluster a two-group data set",
+            "input": "X = [0 0; 0.2 0.1; 9.8 9.9; 10 10.1];\n[idx,C,sumd,D] = kmeans(X, 2, 'Start', [0 0; 10 10])",
+            "output": "`idx` assigns the first two rows to one cluster and the last two rows to the other; `C` contains two centroids."
+        },
+        {
+            "description": "Use cityblock distance",
+            "input": "idx = kmeans(X, 2, 'Distance', 'cityblock', 'Replicates', 3)",
+            "output": "RunMat runs three starts and returns the best cityblock clustering."
+        },
+        {
+            "description": "Infer k from numeric starts",
+            "input": "[idx,C] = kmeans(X, [], 'Start', [0 0; 10 10])",
+            "output": "RunMat infers two clusters from the two rows of the start matrix."
+        },
+        {
+            "description": "Treat missing rows consistently",
+            "input": "idx = kmeans([1; 2; NaN; 20], 2)",
+            "output": "The third `idx` element is `NaN`; the complete rows are clustered normally."
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does RunMat match MATLAB's exact random starts?",
+            "answer": "No. RunMat uses its own deterministic RNG stream behind `rng`, so output shapes and semantics match MATLAB but stochastic starts are not bit-for-bit identical."
+        },
+        {
+            "question": "Are custom distance functions supported?",
+            "answer": "No. RunMat supports the common named distances and rejects custom function-handle distances explicitly."
+        }
+    ],
+    "links": [
+        {
+            "label": "pdist",
+            "url": "./pdist"
+        },
+        {
+            "label": "pdist2",
+            "url": "./pdist2"
+        },
+        {
+            "label": "fitctree",
+            "url": "./fitctree"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/stats/ml/kmeans.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/stats/ml/kmeans.rs"
+    },
+    "key": "kmeans",
+    "slug": "kmeans",
+    "aliases": [],
+    "categoryPath": [
+        "stats",
+        "ml"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=kmeans.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"kmeans.js","sourceRoot":"","sources":["../../../src/generated/builtins/kmeans.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,SAAS;QACT,YAAY;QACZ,YAAY;QACZ,kBAAkB;KACnB;IACD,SAAS,EAAE,iEAAiE;IAC5E,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;SACN;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,qGAAqG;KAC/G;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,oCAAoC;QAC5C,aAAa,EAAE,oCAAoC;KACpD;IACD,aAAa,EAAE,+JAA+J;IAC9K,WAAW,EAAE;QACX,oJAAoJ;QACpJ,oIAAoI;QACpI,4JAA4J;QAC5J,uKAAuK;QACvK,kIAAkI;QAClI,oLAAoL;QACpL,yGAAyG;QACzG,4IAA4I;QAC5I,8LAA8L;QAC9L,oKAAoK;QACpK,+HAA+H;KAChI;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,8BAA8B;YAC7C,OAAO,EAAE,6FAA6F;YACtG,QAAQ,EAAE,iHAAiH;SAC5H;QACD;YACE,aAAa,EAAE,wBAAwB;YACvC,OAAO,EAAE,8DAA8D;YACvE,QAAQ,EAAE,qEAAqE;SAChF;QACD;YACE,aAAa,EAAE,6BAA6B;YAC5C,OAAO,EAAE,gDAAgD;YACzD,QAAQ,EAAE,mEAAmE;SAC9E;QACD;YACE,aAAa,EAAE,iCAAiC;YAChD,OAAO,EAAE,kCAAkC;YAC3C,QAAQ,EAAE,6EAA6E;SACxF;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,iDAAiD;YAC7D,QAAQ,EAAE,iKAAiK;SAC5K;QACD;YACE,UAAU,EAAE,0CAA0C;YACtD,QAAQ,EAAE,yGAAyG;SACpH;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,yDAAyD;QAClE,KAAK,EAAE,sGAAsG;KAC9G;IACD,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,IAAI;KACL;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/knnsearch.js

@@ -0,0 +1,95 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "knnsearch",
+    "category": "stats/ml",
+    "keywords": [
+        "knnsearch",
+        "nearest neighbor",
+        "k nearest",
+        "statistics",
+        "machine learning",
+        "distance"
+    ],
+    "summary": "Find k-nearest neighbors in an observation matrix.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f64"
+        ],
+        "broadcasting": "none",
+        "notes": "GPU inputs are gathered to host. Nearest-neighbor search runs on CPU."
+    },
+    "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": "`knnsearch(X,Y)` returns one-based row indices in `X` for the nearest neighbors of each row in `Y`.",
+    "behaviors": [
+        "`X` and `Y` must be real numeric vectors or 2-D matrices with the same number of columns.",
+        "The default search is exhaustive with `K=1` and Euclidean distance.",
+        "`[Idx,D] = knnsearch(...)` returns indices first and distances second. Without `IncludeTies`, both outputs are `size(Y,1)` by `K` numeric matrices.",
+        "Supported distance metrics are `\"euclidean\"`, `\"squaredeuclidean\"`, `\"cityblock\"`, `\"chebychev\"`, `\"minkowski\"`, `\"seuclidean\"`, `\"mahalanobis\"`, `\"cosine\"`, `\"correlation\"`, `\"hamming\"`, `\"jaccard\"`, and `\"spearman\"`. Fast Euclidean aliases are accepted and evaluated with the exact Euclidean implementation.",
+        "`\"P\"`, `\"Scale\"`, and `\"Cov\"` provide metric parameters for Minkowski, standardized Euclidean, and Mahalanobis distances respectively.",
+        "`\"IncludeTies\",true` returns `size(Y,1)` by 1 cell arrays whose elements contain all neighbors tied at the K-th distance. Tied outputs are sorted by distance even when `\"SortIndices\",false` is supplied.",
+        "`\"NSMethod\"`, `\"BucketSize\"`, `\"CacheSize\"`, and `\"SortIndices\"` are parsed for compatibility. `\"NSMethod\",\"kdtree\"` is accepted only for Euclidean, cityblock, Chebychev, and Minkowski distances. RunMat currently evaluates nearest neighbors exhaustively and returns sorted neighbors."
+    ],
+    "examples": [
+        {
+            "description": "Find nearest rows",
+            "input": "X = [0 0; 2 0; 5 0];\nY = [1 0; 4 0];\nIdx = knnsearch(X,Y)",
+            "output": "Idx is a 2-by-1 matrix of row indices from X."
+        },
+        {
+            "description": "Request distances and two neighbors",
+            "input": "[Idx,D] = knnsearch(X,Y,\"K\",2)",
+            "output": "Idx and D are size(Y,1)-by-2 matrices."
+        },
+        {
+            "description": "Include tied neighbors",
+            "input": "Idx = knnsearch([0; 1; -1],0,\"K\",2,\"IncludeTies\",true)",
+            "output": "Idx is a cell array; each cell contains all tied neighbor indices."
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does RunMat build a kd-tree?",
+            "answer": "No. RunMat accepts kd-tree-related options for compatibility but currently uses exhaustive search so results stay exact."
+        },
+        {
+            "question": "Are custom distance functions supported?",
+            "answer": "No. RunMat currently supports the standard named numeric distance metrics."
+        }
+    ],
+    "links": [
+        {
+            "label": "pdist2",
+            "url": "./pdist2"
+        },
+        {
+            "label": "pdist",
+            "url": "./pdist"
+        }
+    ],
+    "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": "knnsearch",
+    "slug": "knnsearch",
+    "aliases": [],
+    "categoryPath": [
+        "stats",
+        "ml"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=knnsearch.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"knnsearch.js","sourceRoot":"","sources":["../../../src/generated/builtins/knnsearch.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,WAAW;IACpB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,WAAW;QACX,kBAAkB;QAClB,WAAW;QACX,YAAY;QACZ,kBAAkB;QAClB,UAAU;KACX;IACD,SAAS,EAAE,oDAAoD;IAC/D,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;SACN;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,uEAAuE;KACjF;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,qGAAqG;IACpH,WAAW,EAAE;QACX,2FAA2F;QAC3F,qEAAqE;QACrE,qJAAqJ;QACrJ,+UAA+U;QAC/U,8IAA8I;QAC9I,gNAAgN;QAChN,ySAAyS;KAC1S;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,mBAAmB;YAClC,OAAO,EAAE,6DAA6D;YACtE,QAAQ,EAAE,+CAA+C;SAC1D;QACD;YACE,aAAa,EAAE,qCAAqC;YACpD,OAAO,EAAE,kCAAkC;YAC3C,QAAQ,EAAE,wCAAwC;SACnD;QACD;YACE,aAAa,EAAE,wBAAwB;YACvC,OAAO,EAAE,4DAA4D;YACrE,QAAQ,EAAE,oEAAoE;SAC/E;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,8BAA8B;YAC1C,QAAQ,EAAE,0HAA0H;SACrI;QACD;YACE,UAAU,EAAE,0CAA0C;YACtD,QAAQ,EAAE,4EAA4E;SACvF;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,2DAA2D;QACpE,KAAK,EAAE,wGAAwG;KAChH;IACD,KAAK,EAAE,WAAW;IAClB,MAAM,EAAE,WAAW;IACnB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,IAAI;KACL;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/kstest.js

@@ -0,0 +1,87 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "kstest",
+    "category": "stats/summary",
+    "keywords": [
+        "kstest",
+        "kolmogorov-smirnov",
+        "hypothesis test",
+        "cdf",
+        "statistics"
+    ],
+    "summary": "Perform a one-sample Kolmogorov-Smirnov test.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": true,
+        "precisions": [
+            "f64"
+        ],
+        "broadcasting": "none",
+        "notes": "gpuArray inputs are gathered to the CPU reference path."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "none"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::stats::summary::hypothesis::tests",
+        "integration": "crates/runmat-vm/tests/stats_ml.rs"
+    },
+    "description": "`kstest(x)` performs a one-sample Kolmogorov-Smirnov test of whether the sample in `x` could come from a standard normal distribution. `[h,p,ksstat,cv] = kstest(...)` also returns an approximate p-value, the KS statistic, and an approximate critical value.",
+    "behaviors": [
+        "`kstest(x)` requires numeric vector input, omits `NaN` sample values, and tests against the standard normal CDF.",
+        "`kstest(x,\"Alpha\",alpha)` changes the significance level. `alpha` must be a scalar in `(0,1)`.",
+        "`kstest(x,\"Tail\",tail)` accepts `\"unequal\"`/`\"both\"`, `\"larger\"`, and `\"smaller\"`.",
+        "`kstest(x,\"CDF\",cdf)` accepts a two-column numeric matrix whose first column contains sample points and whose second column contains CDF probabilities in `[0,1]`. Rows are sorted by sample point, duplicate sample points are collapsed to the largest probability at that point, and probabilities must be nondecreasing after normalization. Sample values must lie inside the table's x range. Values are linearly interpolated between table rows.",
+        "`\"CDF\"` also accepts `\"normcdf\"`, `\"normal\"`, `\"norm\"`, or a `@normcdf` function handle for the standard normal CDF.",
+        "The p-values use standard large-sample approximations. For two-sided tests, `cv` is returned for `Alpha` in `[0.01,0.20]`; for one-sided tests, `cv` is returned for `Alpha` in `[0.005,0.10]`. Outside those ranges, `cv` is `NaN`, matching MATLAB's documented critical-value limitations.",
+        "Continuous probability distribution objects for `\"CDF\"` are not supported until RunMat's `makedist`/`fitdist` distribution object surface exists."
+    ],
+    "examples": [
+        {
+            "description": "Test a centered sample against the standard normal CDF",
+            "input": "h = kstest([-1 -0.25 0 0.25 1])"
+        },
+        {
+            "description": "Request all outputs with a one-sided alternative",
+            "input": "[h,p,ksstat,cv] = kstest(x, \"Tail\", \"smaller\")"
+        },
+        {
+            "description": "Use an explicit CDF table",
+            "input": "cdf = [0 0; 0.5 0.5; 1 1];\nh = kstest(x, \"CDF\", cdf)"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does kstest accept arbitrary CDF function handles?",
+            "answer": "Only `@normcdf` is recognized as a function handle. Use a two-column CDF table for custom reference distributions."
+        }
+    ],
+    "links": [
+        {
+            "label": "ttest2",
+            "url": "./ttest2"
+        },
+        {
+            "label": "normcdf",
+            "url": "./normcdf"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/stats/summary/hypothesis.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/stats/summary/hypothesis.rs"
+    },
+    "key": "kstest",
+    "slug": "kstest",
+    "aliases": [],
+    "categoryPath": [
+        "stats",
+        "summary"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=kstest.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"kstest.js","sourceRoot":"","sources":["../../../src/generated/builtins/kstest.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,QAAQ;IACjB,UAAU,EAAE,eAAe;IAC3B,UAAU,EAAE;QACV,QAAQ;QACR,oBAAoB;QACpB,iBAAiB;QACjB,KAAK;QACL,YAAY;KACb;IACD,SAAS,EAAE,+CAA+C;IAC1D,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,IAAI;QACjB,YAAY,EAAE;YACZ,KAAK;SACN;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,yDAAyD;KACnE;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,6CAA6C;QACrD,aAAa,EAAE,oCAAoC;KACpD;IACD,aAAa,EAAE,kQAAkQ;IACjR,WAAW,EAAE;QACX,kHAAkH;QAClH,kGAAkG;QAClG,8FAA8F;QAC9F,4bAA4b;QAC5b,8HAA8H;QAC9H,+RAA+R;QAC/R,qJAAqJ;KACtJ;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,wDAAwD;YACvE,OAAO,EAAE,iCAAiC;SAC3C;QACD;YACE,aAAa,EAAE,kDAAkD;YACjE,OAAO,EAAE,oDAAoD;SAC9D;QACD;YACE,aAAa,EAAE,2BAA2B;YAC1C,OAAO,EAAE,yDAAyD;SACnE;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,oDAAoD;YAChE,QAAQ,EAAE,oHAAoH;SAC/H;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,kEAAkE;QAC3E,KAAK,EAAE,+GAA+G;KACvH;IACD,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/kurtosis.js

@@ -0,0 +1,75 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "kurtosis",
+    "category": "stats/summary",
+    "keywords": [
+        "kurtosis",
+        "fourth moment",
+        "statistics",
+        "summary"
+    ],
+    "summary": "Compute sample kurtosis.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f64"
+        ],
+        "broadcasting": "none",
+        "notes": "GPU inputs are gathered to host for compatibility until provider reduction hooks exist."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "none"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::stats::summary::descriptive::tests",
+        "integration": null
+    },
+    "description": "`kurtosis(X)` computes biased sample kurtosis, not excess kurtosis. `kurtosis(X,0,...)` applies the finite-sample bias correction. Dimension, vector-dimension, and `\"all\"` forms are supported.",
+    "behaviors": [
+        "Flag `1` is the default biased moment estimator.",
+        "Flag `0` applies the usual finite-sample bias correction and returns `NaN` for slices with fewer than four values.",
+        "Slices with zero variance return `NaN`.",
+        "NaNs are treated as missing and omitted from each slice by default."
+    ],
+    "examples": [
+        {
+            "description": "Kurtosis across all values",
+            "input": "k = kurtosis(x, 1, \"all\")"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does kurtosis return excess kurtosis?",
+            "answer": "No. The returned value is kurtosis with the normal distribution centered around 3."
+        }
+    ],
+    "links": [
+        {
+            "label": "skewness",
+            "url": "./skewness"
+        },
+        {
+            "label": "std",
+            "url": "./std"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/stats/summary/descriptive.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/stats/summary/descriptive.rs"
+    },
+    "key": "kurtosis",
+    "slug": "kurtosis",
+    "aliases": [],
+    "categoryPath": [
+        "stats",
+        "summary"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=kurtosis.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"kurtosis.js","sourceRoot":"","sources":["../../../src/generated/builtins/kurtosis.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,eAAe;QACf,YAAY;QACZ,SAAS;KACV;IACD,SAAS,EAAE,0BAA0B;IACrC,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;SACN;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,yFAAyF;KACnG;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,oMAAoM;IACnN,WAAW,EAAE;QACX,kDAAkD;QAClD,oHAAoH;QACpH,yCAAyC;QACzC,qEAAqE;KACtE;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,4BAA4B;YAC3C,OAAO,EAAE,6BAA6B;SACvC;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,uCAAuC;YACnD,QAAQ,EAAE,oFAAoF;SAC/F;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,mEAAmE;QAC5E,KAAK,EAAE,gHAAgH;KACxH;IACD,KAAK,EAAE,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/lasso.d.ts

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

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

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