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

package/dist/generated/builtins/digitsPattern.js

@@ -0,0 +1,95 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "digitsPattern",
+    "category": "strings/pattern",
+    "keywords": [
+        "digitsPattern",
+        "strings",
+        "pattern",
+        "matlab",
+        "compatibility"
+    ],
+    "summary": "Create a pattern matching digit characters.",
+    "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": "pat = digitsPattern(N) - Create a pattern matching digit characters.",
+    "signatures": [
+        {
+            "label": "pat = digitsPattern(N)",
+            "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": [
+        "Create a pattern matching digit characters.",
+        "Creates a regular-expression-backed pattern for digit runs, with optional exact count."
+    ],
+    "examples": [
+        "contains(\"A12\", digitsPattern) can match the digit run through pattern-aware string APIs."
+    ],
+    "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": "digitspattern",
+    "slug": "digitspattern",
+    "aliases": [],
+    "categoryPath": [
+        "strings",
+        "pattern"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=digitsPattern.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"digitsPattern.js","sourceRoot":"","sources":["../../../src/generated/builtins/digitsPattern.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,eAAe;IACxB,UAAU,EAAE,iBAAiB;IAC7B,UAAU,EAAE;QACV,eAAe;QACf,SAAS;QACT,SAAS;QACT,QAAQ;QACR,eAAe;KAChB;IACD,SAAS,EAAE,6CAA6C;IACxD,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,sEAAsE;IACrF,YAAY,EAAE;QACZ;YACE,OAAO,EAAE,wBAAwB;YACjC,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,6CAA6C;QAC7C,wFAAwF;KACzF;IACD,UAAU,EAAE;QACV,6FAA6F;KAC9F;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,eAAe;IACtB,MAAM,EAAE,eAAe;IACvB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,SAAS;QACT,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/digraph.js

@@ -0,0 +1,45 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "digraph",
+    "category": "graph",
+    "keywords": [
+        "digraph",
+        "directed graph",
+        "nodes",
+        "edges",
+        "network"
+    ],
+    "summary": "Create a directed graph object.",
+    "status": "implemented",
+    "tested": {
+        "unit": "builtins::graph::tests"
+    },
+    "description": "`digraph` creates a directed graph compatibility object with `Nodes` and `Edges` tables. It supports edge-list construction with numeric or named nodes, optional weights, optional node names, and dense adjacency matrices.",
+    "signatures": [
+        {
+            "label": "G = digraph(s, t)",
+            "description": "Create a directed graph from source and target node vectors."
+        },
+        {
+            "label": "G = digraph(A)",
+            "description": "Create a directed graph from a square dense adjacency matrix where `A(i,j)` is edge `i -> j`."
+        }
+    ],
+    "notes": [
+        "Direction is preserved by `successors`, `predecessors`, `indegree`, `outdegree`, `shortestpath`, `distances`, `bfsearch`, `dfsearch`, and `toposort`."
+    ],
+    "gpu_residency": "No. Directed graph construction and traversal are host metadata/control-flow operations.",
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/graph/mod.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/graph/mod.rs"
+    },
+    "key": "digraph",
+    "slug": "digraph",
+    "aliases": [],
+    "categoryPath": [
+        "graph"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=digraph.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"digraph.js","sourceRoot":"","sources":["../../../src/generated/builtins/digraph.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,OAAO;IACnB,UAAU,EAAE;QACV,SAAS;QACT,gBAAgB;QAChB,OAAO;QACP,OAAO;QACP,SAAS;KACV;IACD,SAAS,EAAE,iCAAiC;IAC5C,QAAQ,EAAE,aAAa;IACvB,QAAQ,EAAE;QACR,MAAM,EAAE,wBAAwB;KACjC;IACD,aAAa,EAAE,+NAA+N;IAC9O,YAAY,EAAE;QACZ;YACE,OAAO,EAAE,mBAAmB;YAC5B,aAAa,EAAE,8DAA8D;SAC9E;QACD;YACE,OAAO,EAAE,gBAAgB;YACzB,aAAa,EAAE,+FAA+F;SAC/G;KACF;IACD,OAAO,EAAE;QACP,uJAAuJ;KACxJ;IACD,eAAe,EAAE,0FAA0F;IAC3G,QAAQ,EAAE;QACR,OAAO,EAAE,mDAAmD;QAC5D,KAAK,EAAE,gGAAgG;KACxG;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;KACR;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/discretize.js

@@ -0,0 +1,48 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "discretize",
+    "category": "array/grouping",
+    "keywords": [
+        "discretize",
+        "bins",
+        "edges",
+        "grouping"
+    ],
+    "summary": "Group numeric data into bins.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "Binning runs on the host."
+    },
+    "tested": {
+        "unit": "builtins::array::grouping::tests"
+    },
+    "description": "`discretize(X,edges)` returns one-based bin numbers for values in `X` using numeric bin edges.",
+    "behaviors": [
+        "Supports explicit edge vectors, positive scalar bin counts, string labels, and the `IncludedEdge` name-value option; the default is left-inclusive/right-exclusive with the final edge included.",
+        "Out-of-range and NaN inputs return NaN for numeric bin output or missing strings for labeled output."
+    ],
+    "examples": [
+        {
+            "description": "Bin values",
+            "input": "Y = discretize([0.2 1.5],[0 1 2])",
+            "output": "Y = [1 2]"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/array/grouping.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/array/grouping.rs"
+    },
+    "key": "discretize",
+    "slug": "discretize",
+    "aliases": [],
+    "categoryPath": [
+        "array",
+        "grouping"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=discretize.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discretize.js","sourceRoot":"","sources":["../../../src/generated/builtins/discretize.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,YAAY;IACrB,UAAU,EAAE,gBAAgB;IAC5B,UAAU,EAAE;QACV,YAAY;QACZ,MAAM;QACN,OAAO;QACP,UAAU;KACX;IACD,SAAS,EAAE,+BAA+B;IAC1C,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,2BAA2B;KACrC;IACD,QAAQ,EAAE;QACR,MAAM,EAAE,kCAAkC;KAC3C;IACD,aAAa,EAAE,gGAAgG;IAC/G,WAAW,EAAE;QACX,kMAAkM;QAClM,sGAAsG;KACvG;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,YAAY;YAC3B,OAAO,EAAE,mCAAmC;YAC5C,QAAQ,EAAE,WAAW;SACtB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,wDAAwD;QACjE,KAAK,EAAE,qGAAqG;KAC7G;IACD,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,YAAY;IACpB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/display.js

@@ -0,0 +1,112 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "display",
+    "category": "io",
+    "keywords": [
+        "display",
+        "disp",
+        "object display",
+        "command window",
+        "print"
+    ],
+    "summary": "Display a value with a MATLAB-style variable-name header.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "`display` is a side-effecting output sink. GPU-resident inputs are gathered to host memory before formatting, matching `disp`."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": null,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::io::display::tests",
+        "vm": "crates/runmat-vm/tests/functions.rs"
+    },
+    "description": "`display(X)` prints a MATLAB-style display block for `X`. When the callsite argument is a simple variable name, RunMat uses that name as the header. Expression and literal arguments use `ans` as the header. For classdef objects that define or inherit a registered `display` method, RunMat dispatches the object method first; otherwise it falls back to the generic formatter shared with `disp`.",
+    "behaviors": [
+        "`display(X)` prints `X = ...` for simple variable arguments.",
+        "`display(expr)` prints `ans = ...` when the argument text is an expression, literal, or otherwise unavailable.",
+        "Single-line values are printed on the same line as the header.",
+        "Multi-line values such as matrices, structs, tables, datetime arrays, duration arrays, and N-D pages are printed below the header.",
+        "Objects and handle objects with a registered or inherited `display` method are dispatched through the class method surface before generic formatting.",
+        "`display` returns an empty numeric matrix placeholder internally and suppresses automatic output."
+    ],
+    "limitations": [
+        "RunMat does not yet implement the full `matlab.mixin.CustomDisplay` override protocol. Class-specific output currently requires a registered or inherited `display` method.",
+        "Object-array display customization remains bounded by RunMat's current object-array and classdef infrastructure.",
+        "The generic fallback formatter is the same host-side formatter used by `disp`; unsupported object families fall back to their runtime summary string."
+    ],
+    "examples": [
+        {
+            "description": "Display a named variable",
+            "input": "A = [1 2; 3 4];\ndisplay(A)",
+            "output": "A =\n     1       2\n     3       4"
+        },
+        {
+            "description": "Display an expression",
+            "input": "display(1 + 2)",
+            "output": "ans = 3"
+        },
+        {
+            "description": "Display a string",
+            "input": "msg = \"ready\";\ndisplay(msg)",
+            "output": "msg = ready"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "How is `display` different from `disp`?",
+            "answer": "`disp(X)` prints only the value. `display(X)` prints a variable-name header such as `X =` before the value."
+        },
+        {
+            "question": "Does `display` support class-specific output?",
+            "answer": "Yes for classes with a registered `display` method. The full `matlab.mixin.CustomDisplay` protocol is not yet modeled."
+        },
+        {
+            "question": "Does `display` gather GPU arrays?",
+            "answer": "Yes. Like `disp`, `display` formats on the CPU and gathers provider-resident data through the active acceleration provider."
+        }
+    ],
+    "links": [
+        {
+            "label": "disp",
+            "url": "./disp"
+        },
+        {
+            "label": "inputname",
+            "url": "./inputname"
+        },
+        {
+            "label": "class",
+            "url": "./class"
+        },
+        {
+            "label": "ismethod",
+            "url": "./ismethod"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/io/display.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/io/display.rs"
+    },
+    "gpu_residency": "`display` is a sink. Provider-resident inputs are gathered to host memory for formatting and the returned placeholder is host-side.",
+    "gpu_behavior": [
+        "`display` performs no provider kernel dispatch and is excluded from fusion planning.",
+        "Gather behavior is inherited from the same runtime gather path used by `disp`."
+    ],
+    "key": "display",
+    "slug": "display",
+    "aliases": [],
+    "categoryPath": [
+        "io"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=display.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"display.js","sourceRoot":"","sources":["../../../src/generated/builtins/display.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,IAAI;IAChB,UAAU,EAAE;QACV,SAAS;QACT,MAAM;QACN,gBAAgB;QAChB,gBAAgB;QAChB,OAAO;KACR;IACD,SAAS,EAAE,2DAA2D;IACtE,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,QAAQ;KACtB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,8BAA8B;QACtC,IAAI,EAAE,qCAAqC;KAC5C;IACD,aAAa,EAAE,2YAA2Y;IAC1Z,WAAW,EAAE;QACX,8DAA8D;QAC9D,gHAAgH;QAChH,gEAAgE;QAChE,oIAAoI;QACpI,uJAAuJ;QACvJ,mGAAmG;KACpG;IACD,aAAa,EAAE;QACb,6KAA6K;QAC7K,kHAAkH;QAClH,uJAAuJ;KACxJ;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,0BAA0B;YACzC,OAAO,EAAE,6BAA6B;YACtC,QAAQ,EAAE,qCAAqC;SAChD;QACD;YACE,aAAa,EAAE,uBAAuB;YACtC,OAAO,EAAE,gBAAgB;YACzB,QAAQ,EAAE,SAAS;SACpB;QACD;YACE,aAAa,EAAE,kBAAkB;YACjC,OAAO,EAAE,gCAAgC;YACzC,QAAQ,EAAE,aAAa;SACxB;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,yCAAyC;YACrD,QAAQ,EAAE,6GAA6G;SACxH;QACD;YACE,UAAU,EAAE,+CAA+C;YAC3D,QAAQ,EAAE,wHAAwH;SACnI;QACD;YACE,UAAU,EAAE,mCAAmC;YAC/C,QAAQ,EAAE,6HAA6H;SACxI;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,oDAAoD;QAC7D,KAAK,EAAE,iGAAiG;KACzG;IACD,eAAe,EAAE,qIAAqI;IACtJ,cAAc,EAAE;QACd,sFAAsF;QACtF,gFAAgF;KACjF;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,IAAI;KACL;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/distances.js

@@ -0,0 +1,39 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "distances",
+    "category": "graph",
+    "keywords": [
+        "distances",
+        "graph",
+        "dijkstra"
+    ],
+    "summary": "Compute shortest-path distance matrices.",
+    "status": "implemented",
+    "tested": {
+        "unit": "builtins::graph::tests"
+    },
+    "description": "`distances(G)` computes all-pairs shortest-path distances. Optional source and target node lists restrict the rows and columns.",
+    "signatures": [
+        {
+            "label": "D = distances(G)",
+            "description": "Return all-pairs shortest-path distances."
+        },
+        {
+            "label": "D = distances(G, s, t)",
+            "description": "Return distances from source nodes `s` to target nodes `t`."
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/graph/mod.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/graph/mod.rs"
+    },
+    "key": "distances",
+    "slug": "distances",
+    "aliases": [],
+    "categoryPath": [
+        "graph"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=distances.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"distances.js","sourceRoot":"","sources":["../../../src/generated/builtins/distances.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,WAAW;IACpB,UAAU,EAAE,OAAO;IACnB,UAAU,EAAE;QACV,WAAW;QACX,OAAO;QACP,UAAU;KACX;IACD,SAAS,EAAE,0CAA0C;IACrD,QAAQ,EAAE,aAAa;IACvB,QAAQ,EAAE;QACR,MAAM,EAAE,wBAAwB;KACjC;IACD,aAAa,EAAE,iIAAiI;IAChJ,YAAY,EAAE;QACZ;YACE,OAAO,EAAE,kBAAkB;YAC3B,aAAa,EAAE,2CAA2C;SAC3D;QACD;YACE,OAAO,EAAE,wBAAwB;YACjC,aAAa,EAAE,6DAA6D;SAC7E;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,mDAAmD;QAC5D,KAAK,EAAE,gGAAgG;KACxG;IACD,KAAK,EAAE,WAAW;IAClB,MAAM,EAAE,WAAW;IACnB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;KACR;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/dividerand.js

@@ -0,0 +1,85 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "dividerand",
+    "category": "stats/random",
+    "keywords": [
+        "dividerand",
+        "random",
+        "partition",
+        "train",
+        "validation",
+        "test",
+        "statistics",
+        "machine-learning"
+    ],
+    "summary": "Divide target indices randomly into training, validation, and test sets.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f64"
+        ],
+        "broadcasting": "none",
+        "notes": "dividerand produces host-side index partitions and uses RunMat's global random generator state."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "none"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::stats::random::sampling::tests",
+        "integration": "crates/runmat-vm/tests/stats_ml.rs"
+    },
+    "description": "`dividerand(Q,trainRatio,valRatio,testRatio)` randomly permutes the one-based target indices `1:Q` and divides them into training, validation, and test row vectors. `dividerand(Q)` uses the documented default ratios `0.7`, `0.15`, and `0.15`.",
+    "behaviors": [
+        "`Q` must be a nonnegative integer scalar.",
+        "`Q` is capped at 10,000,000 so index partitions fail cleanly before excessive host allocation.",
+        "Ratios must be finite nonnegative scalar values, and at least one ratio must be positive.",
+        "Ratios are normalized before allocation, so they do not need to sum to one.",
+        "Returned indices are one-based row vectors and together form a random permutation of `1:Q`.",
+        "Empty partitions are returned as `1-by-0` numeric tensors."
+    ],
+    "examples": [
+        {
+            "description": "Default split",
+            "input": "[trainInd,valInd,testInd] = dividerand(100)"
+        },
+        {
+            "description": "Explicit split ratios",
+            "input": "[trainInd,valInd,testInd] = dividerand(3000, 0.6, 0.2, 0.2)"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does dividerand respect rng?",
+            "answer": "Yes. The random permutation is drawn from RunMat's global random generator, so `rng('default')` and numeric seeds make results reproducible."
+        }
+    ],
+    "links": [
+        {
+            "label": "rng",
+            "url": "./rng"
+        },
+        {
+            "label": "randperm",
+            "url": "./randperm"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/stats/random/sampling.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/stats/random/sampling.rs"
+    },
+    "key": "dividerand",
+    "slug": "dividerand",
+    "aliases": [],
+    "categoryPath": [
+        "stats",
+        "random"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=dividerand.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dividerand.js","sourceRoot":"","sources":["../../../src/generated/builtins/dividerand.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,YAAY;IACrB,UAAU,EAAE,cAAc;IAC1B,UAAU,EAAE;QACV,YAAY;QACZ,QAAQ;QACR,WAAW;QACX,OAAO;QACP,YAAY;QACZ,MAAM;QACN,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,iGAAiG;KAC3G;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,MAAM;KACpB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,0CAA0C;QAClD,aAAa,EAAE,oCAAoC;KACpD;IACD,aAAa,EAAE,oPAAoP;IACnQ,WAAW,EAAE;QACX,2CAA2C;QAC3C,gGAAgG;QAChG,2FAA2F;QAC3F,6EAA6E;QAC7E,6FAA6F;QAC7F,4DAA4D;KAC7D;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,eAAe;YAC9B,OAAO,EAAE,6CAA6C;SACvD;QACD;YACE,aAAa,EAAE,uBAAuB;YACtC,OAAO,EAAE,6DAA6D;SACvE;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,8BAA8B;YAC1C,QAAQ,EAAE,8IAA8I;SACzJ;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,+DAA+D;QACxE,KAAK,EAAE,4GAA4G;KACpH;IACD,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,YAAY;IACpB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,QAAQ;KACT;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/dlarray.js

@@ -0,0 +1,42 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "dlarray",
+    "category": "deep_learning",
+    "keywords": [
+        "dlarray",
+        "deep learning",
+        "array labels"
+    ],
+    "summary": "Create a dlarray compatibility object around host or gpuArray data.",
+    "description": "`dlarray(X)` wraps host or provider-resident gpuArray data and optional dimension labels in a RunMat compatibility object.",
+    "behaviors": [
+        "The underlying `Data` value is preserved without conversion, including provider-resident `gpuArray` handles.",
+        "A second text argument is stored as `Format` and `Labels`.",
+        "Additional constructor options are rejected with explicit compatibility errors.",
+        "Inside `dlfeval`, host `dlarray` values become traced leaves for the bounded `dlgradient` tape. Supported arithmetic preserves the wrapper and dimension-label metadata."
+    ],
+    "examples": [
+        {
+            "description": "Wrap Data",
+            "input": "X = dlarray(rand(3,4), 'CB')",
+            "output": "dlarray compatibility object."
+        }
+    ],
+    "syntax": {
+        "example": {
+            "description": "Supported forms",
+            "input": "X = dlarray(data)\nX = dlarray(data, fmt)",
+            "output": "dlarray compatibility object."
+        }
+    },
+    "gpu_residency": "`dlarray` preserves provider-resident `gpuArray` data as wrapper metadata outside autodiff. GPU-backed `dlarray` tracing is rejected with an explicit provider-gap error until Deep Learning tape kernels are available in the acceleration provider.",
+    "key": "dlarray",
+    "slug": "dlarray",
+    "aliases": [],
+    "categoryPath": [
+        "deep_learning"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=dlarray.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dlarray.js","sourceRoot":"","sources":["../../../src/generated/builtins/dlarray.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,eAAe;QACf,cAAc;KACf;IACD,SAAS,EAAE,qEAAqE;IAChF,aAAa,EAAE,4HAA4H;IAC3I,WAAW,EAAE;QACX,8GAA8G;QAC9G,4DAA4D;QAC5D,iFAAiF;QACjF,0KAA0K;KAC3K;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,WAAW;YAC1B,OAAO,EAAE,8BAA8B;YACvC,QAAQ,EAAE,+BAA+B;SAC1C;KACF;IACD,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,aAAa,EAAE,iBAAiB;YAChC,OAAO,EAAE,2CAA2C;YACpD,QAAQ,EAAE,+BAA+B;SAC1C;KACF;IACD,eAAe,EAAE,uPAAuP;IACxQ,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,eAAe;KAChB;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/dlfeval.js

@@ -0,0 +1,43 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "dlfeval",
+    "category": "deep_learning",
+    "keywords": [
+        "dlfeval",
+        "deep learning",
+        "automatic differentiation",
+        "function handle"
+    ],
+    "summary": "Evaluate a function handle in Deep Learning compatibility context.",
+    "description": "`dlfeval(fun,args...)` invokes a function handle through RunMat's function-handle dispatch and forwards requested outputs.",
+    "behaviors": [
+        "`fun` must be a function handle value, including named handles, method handles, bound handles, and closures.",
+        "Requested output count is preserved, so bracketed multi-output calls forward to the invoked function.",
+        "A bounded automatic-differentiation tape is installed for the call. Host `dlarray` inputs, supported `dlnetwork` learnables, dlarray arithmetic, scalar sums, and supported `forward` layer chains can be differentiated with `dlgradient` inside `fun`.",
+        "Text function names and callable objects are rejected by `dlfeval`; use `feval` for those RunMat extension forms."
+    ],
+    "examples": [
+        {
+            "description": "Evaluate Function",
+            "input": "[loss,gradients] = dlfeval(@modelLoss, net, X, T)",
+            "output": "Outputs returned by `modelLoss`, including traced losses and gradients from `dlgradient`."
+        }
+    ],
+    "syntax": {
+        "example": {
+            "description": "Supported form",
+            "input": "varargout = dlfeval(fun, args...)",
+            "output": "Outputs returned by `fun`."
+        }
+    },
+    "gpu_residency": "`dlfeval` preserves callable dispatch behavior. GPU-backed `dlarray` values are rejected for automatic differentiation with an explicit provider-gap error because provider-resident tape kernels are not implemented yet.",
+    "key": "dlfeval",
+    "slug": "dlfeval",
+    "aliases": [],
+    "categoryPath": [
+        "deep_learning"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=dlfeval.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dlfeval.js","sourceRoot":"","sources":["../../../src/generated/builtins/dlfeval.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,eAAe;QACf,2BAA2B;QAC3B,iBAAiB;KAClB;IACD,SAAS,EAAE,oEAAoE;IAC/E,aAAa,EAAE,4HAA4H;IAC3I,WAAW,EAAE;QACX,8GAA8G;QAC9G,uGAAuG;QACvG,0PAA0P;QAC1P,mHAAmH;KACpH;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,mBAAmB;YAClC,OAAO,EAAE,mDAAmD;YAC5D,QAAQ,EAAE,2FAA2F;SACtG;KACF;IACD,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,aAAa,EAAE,gBAAgB;YAC/B,OAAO,EAAE,mCAAmC;YAC5C,QAAQ,EAAE,4BAA4B;SACvC;KACF;IACD,eAAe,EAAE,4NAA4N;IAC7O,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,eAAe;KAChB;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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