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

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

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

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

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

package/dist/generated/builtins/saveas.js

@@ -0,0 +1,81 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "saveas",
+    "category": "plotting",
+    "keywords": [
+        "saveas",
+        "figure export",
+        "figure save",
+        "png",
+        "fig"
+    ],
+    "summary": "Save a figure to a file.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "`saveas` gathers handle, filename, and format metadata only. PNG exports use RunMat's shared plotting renderer; FIG exports serialize the figure scene payload."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 3,
+        "constants": "inline"
+    },
+    "requires_feature": "plot-core",
+    "tested": {
+        "unit": "builtins::plotting::figure_persistence::tests",
+        "integration": "figure persistence round-trip and PNG export regression coverage"
+    },
+    "description": "`saveas(fig, filename)` saves the specified figure or graphics object parent figure. RunMat supports RunMat FIG scene files and PNG image export.",
+    "behaviors": [
+        "`saveas(fig, filename)` infers the output format from `.fig` or `.png`; names without an extension save as `.fig`.",
+        "`saveas(fig, filename, formattype)` uses the explicit format. If `filename` has no extension, RunMat appends the standard extension for that format.",
+        "Figure, axes, text, legend, ruler, and plot-child handles save their parent figure.",
+        "PDF, EPS, SVG, JPEG, TIFF, and MATLAB code-generation formats are recognized as unsupported until those exporters exist."
+    ],
+    "examples": [
+        {
+            "description": "Save a figure scene",
+            "input": "plot(1:5, [1 4 2 5 3]);\nsaveas(gcf, \"plot_state.fig\");"
+        },
+        {
+            "description": "Save a PNG image",
+            "input": "plot(0:0.1:1, (0:0.1:1).^2);\nsaveas(gcf, \"quadratic\", \"png\");"
+        }
+    ],
+    "links": [
+        {
+            "label": "savefig",
+            "url": "./savefig"
+        },
+        {
+            "label": "openfig",
+            "url": "./openfig"
+        },
+        {
+            "label": "print",
+            "url": "./print"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/plotting/ops/figure_persistence.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/plotting/ops/figure_persistence.rs"
+    },
+    "gpu_residency": "`saveas` is an I/O sink. It returns a host logical status and does not launch numeric GPU kernels.",
+    "gpu_behavior": [
+        "PNG export uses the same renderer path as `print`.",
+        "FIG export serializes plotting state through the replay scene exporter.",
+        "Unsupported export formats fail before any partial output is written."
+    ],
+    "key": "saveas",
+    "slug": "saveas",
+    "aliases": [],
+    "categoryPath": [
+        "plotting"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=saveas.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"saveas.js","sourceRoot":"","sources":["../../../src/generated/builtins/saveas.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,eAAe;QACf,aAAa;QACb,KAAK;QACL,KAAK;KACN;IACD,SAAS,EAAE,0BAA0B;IACrC,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,iKAAiK;KAC3K;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;KACtB;IACD,kBAAkB,EAAE,WAAW;IAC/B,QAAQ,EAAE;QACR,MAAM,EAAE,+CAA+C;QACvD,aAAa,EAAE,kEAAkE;KAClF;IACD,aAAa,EAAE,mJAAmJ;IAClK,WAAW,EAAE;QACX,oHAAoH;QACpH,sJAAsJ;QACtJ,qFAAqF;QACrF,0HAA0H;KAC3H;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,qBAAqB;YACpC,OAAO,EAAE,2DAA2D;SACrE;QACD;YACE,aAAa,EAAE,kBAAkB;YACjC,OAAO,EAAE,oEAAoE;SAC9E;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,yEAAyE;QAClF,KAAK,EAAE,sHAAsH;KAC9H;IACD,eAAe,EAAE,oGAAoG;IACrH,cAAc,EAAE;QACd,oDAAoD;QACpD,yEAAyE;QACzE,uEAAuE;KACxE;IACD,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"savefig.d.ts","sourceRoot":"","sources":["../../../src/generated/builtins/savefig.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/savefig.js

@@ -0,0 +1,75 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "savefig",
+    "category": "plotting",
+    "keywords": [
+        "savefig",
+        "figure save",
+        "fig",
+        "plotting"
+    ],
+    "summary": "Save one or more figures as RunMat FIG files.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "`savefig` serializes figure scene state and gathers only metadata arguments."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 3,
+        "constants": "inline"
+    },
+    "requires_feature": "plot-core",
+    "tested": {
+        "unit": "builtins::plotting::figure_persistence::tests",
+        "integration": "single and multiple figure round-trip tests"
+    },
+    "description": "`savefig` writes RunMat FIG files that can be reopened by `openfig` and `hgload`.",
+    "behaviors": [
+        "`savefig(filename)` saves the current figure and appends `.fig` when no extension is present.",
+        "`savefig(fig, filename)` accepts a scalar figure handle or an array of figure handles.",
+        "`savefig(fig, filename, version)` accepts MATLAB version tokens `-v6`, `-v7`, `-v7.3`, and `compact` as compatibility options for the RunMat FIG scene format.",
+        "Non-`.fig` extensions are rejected for `savefig`."
+    ],
+    "examples": [
+        {
+            "description": "Save and reopen the current figure",
+            "input": "plot(1:4, [1 3 2 4]);\nsavefig(\"session_plot.fig\");\nfig = openfig(\"session_plot.fig\");"
+        }
+    ],
+    "links": [
+        {
+            "label": "openfig",
+            "url": "./openfig"
+        },
+        {
+            "label": "saveas",
+            "url": "./saveas"
+        },
+        {
+            "label": "hgsave",
+            "url": "./hgsave"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/plotting/ops/figure_persistence.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/plotting/ops/figure_persistence.rs"
+    },
+    "gpu_residency": "`savefig` writes host or virtual-filesystem bytes and returns a host logical status.",
+    "gpu_behavior": [
+        "No numeric GPU kernel is launched.",
+        "The figure scene exporter preserves existing plotting state without routing through scalar plotting loops."
+    ],
+    "key": "savefig",
+    "slug": "savefig",
+    "aliases": [],
+    "categoryPath": [
+        "plotting"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=savefig.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"savefig.js","sourceRoot":"","sources":["../../../src/generated/builtins/savefig.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,SAAS;QACT,aAAa;QACb,KAAK;QACL,UAAU;KACX;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,8EAA8E;KACxF;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;KACtB;IACD,kBAAkB,EAAE,WAAW;IAC/B,QAAQ,EAAE;QACR,MAAM,EAAE,+CAA+C;QACvD,aAAa,EAAE,6CAA6C;KAC7D;IACD,aAAa,EAAE,mFAAmF;IAClG,WAAW,EAAE;QACX,+FAA+F;QAC/F,wFAAwF;QACxF,gKAAgK;QAChK,mDAAmD;KACpD;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,oCAAoC;YACnD,OAAO,EAAE,6FAA6F;SACvG;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,yEAAyE;QAClF,KAAK,EAAE,sHAAsH;KAC9H;IACD,eAAe,EAAE,sFAAsF;IACvG,cAAc,EAAE;QACd,oCAAoC;QACpC,4GAA4G;KAC7G;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/saveobj.js

@@ -0,0 +1,98 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "saveobj",
+    "category": "oop/serialization",
+    "keywords": [
+        "saveobj",
+        "loadobj",
+        "object serialization",
+        "mat",
+        "classdef"
+    ],
+    "summary": "Return the MAT-file serialization payload for an object.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "Object serialization is host-side metadata and property traversal. GPU-resident property values are gathered later by MAT-file encoding when needed."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 1,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::introspection::object_serialization::tests",
+        "integration": "crates/runmat-vm/tests/functions.rs::object_saveobj_loadobj_script_surface"
+    },
+    "description": "`saveobj(a)` returns the payload that `save` should write for object `a`. If the object's class registers a `saveobj` method, RunMat dispatches to that method. Otherwise RunMat returns a scalar struct containing the object's stored public runtime properties.",
+    "behaviors": [
+        "The public signature is `b = saveobj(a)`.",
+        "Object and handle-object inputs dispatch to a registered `Class.saveobj` method when one is available.",
+        "When no registered overload exists, RunMat serializes the object's stored property map as a scalar struct.",
+        "Nested objects inside structs or cells are serialized recursively before MAT-file encoding.",
+        "`save` automatically applies this object serialization path before writing MAT-file variables.",
+        "Recursion is bounded and reports `RunMat:ObjectSerialization:RecursionLimit` for cyclic or excessively nested object graphs.",
+        "Non-object inputs to direct `saveobj` raise `RunMat:ObjectSerialization:InvalidArgument`."
+    ],
+    "examples": [
+        {
+            "description": "Return a default property payload",
+            "input": "obj = new_object('Point');\npayload = saveobj(obj)"
+        },
+        {
+            "description": "Save an object through MAT-file serialization",
+            "input": "obj = new_object('Point');\nsave('object_state.mat', 'obj')"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does `save` call `saveobj` automatically?",
+            "answer": "Yes. Before MAT-file encoding, RunMat walks selected values and applies registered `saveobj` methods for object and handle-object values."
+        },
+        {
+            "question": "What is saved when no class-specific method exists?",
+            "answer": "RunMat writes the current runtime property map in an internal object envelope so `load` can reconstruct an object with the same class name and stored properties."
+        },
+        {
+            "question": "Are handle identities preserved?",
+            "answer": "No. Current support serializes the referenced object's properties. It does not preserve handle identity, listener state, or aliasing relationships across save/load."
+        }
+    ],
+    "links": [
+        {
+            "label": "loadobj",
+            "url": "./loadobj"
+        },
+        {
+            "label": "save",
+            "url": "./save"
+        },
+        {
+            "label": "load",
+            "url": "./load"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/introspection/object_serialization.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/introspection/object_serialization.rs"
+    },
+    "gpu_residency": "`saveobj` itself is host-side object metadata work. If a serialized payload contains GPU-resident numeric properties, `save` gathers those values when it converts the payload to MAT-file arrays.",
+    "gpu_behavior": [
+        "`saveobj` does not launch provider kernels.",
+        "`save` remains the residency sink for any GPU values that appear inside the serialized payload."
+    ],
+    "key": "saveobj",
+    "slug": "saveobj",
+    "aliases": [],
+    "categoryPath": [
+        "oop",
+        "serialization"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=saveobj.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"saveobj.js","sourceRoot":"","sources":["../../../src/generated/builtins/saveobj.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,mBAAmB;IAC/B,UAAU,EAAE;QACV,SAAS;QACT,SAAS;QACT,sBAAsB;QACtB,KAAK;QACL,UAAU;KACX;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,sJAAsJ;KAChK;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,sDAAsD;QAC9D,aAAa,EAAE,4EAA4E;KAC5F;IACD,aAAa,EAAE,oQAAoQ;IACnR,WAAW,EAAE;QACX,2CAA2C;QAC3C,wGAAwG;QACxG,4GAA4G;QAC5G,6FAA6F;QAC7F,gGAAgG;QAChG,8HAA8H;QAC9H,2FAA2F;KAC5F;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,mCAAmC;YAClD,OAAO,EAAE,oDAAoD;SAC9D;QACD;YACE,aAAa,EAAE,+CAA+C;YAC9D,OAAO,EAAE,6DAA6D;SACvE;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,2CAA2C;YACvD,QAAQ,EAAE,2IAA2I;SACtJ;QACD;YACE,UAAU,EAAE,qDAAqD;YACjE,QAAQ,EAAE,mKAAmK;SAC9K;QACD;YACE,UAAU,EAAE,kCAAkC;YAC9C,QAAQ,EAAE,sKAAsK;SACjL;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,4EAA4E;QACrF,KAAK,EAAE,yHAAyH;KACjI;IACD,eAAe,EAAE,oMAAoM;IACrN,cAAc,EAAE;QACd,6CAA6C;QAC7C,iGAAiG;KAClG;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,KAAK;QACL,eAAe;KAChB;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/scatterhist.js

@@ -0,0 +1,59 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "scatterhist",
+    "slug": "scatterhist",
+    "keywords": [
+        "scatterhist",
+        "scatter",
+        "histogram",
+        "marginal",
+        "statistics",
+        "plotting"
+    ],
+    "summary": "Create a scatter plot with marginal histograms.",
+    "description": "`scatterhist(x,y)` creates a scatter plot with marginal distributions for vector inputs `x` and `y`. `scatterhist(x,y,Name,Value)` supports common MATLAB-compatible controls including `NBins`, `Group`, `PlotGroup`, `Kernel`, `Style`, `Bandwidth`, `Legend`, `Location`, `Direction`, `Color`, `Marker`, `MarkerSize`, `LineStyle`, `LineWidth`, and `Parent`. The return value is a three-element axes-handle vector for the scatter axes, x marginal axes, and y marginal axes.",
+    "notes": [
+        "RunMat renders the chart using a 2-by-2 subplot grid. MATLAB's exact linked-axes geometry and UI container positioning are not modeled.",
+        "Default `NBins` values use Scott-rule estimates capped at 100 bins per marginal. Explicit `NBins` entries must be integers from 2 through 250.",
+        "The default `Location` is `southwest`, meaning the marginal histograms are below and left of the scatter axes. `Direction` controls whether marginal counts/densities extend toward (`in`) or away from (`out`) the scatter axes.",
+        "`Group` accepts numeric labels, character matrices, string arrays, cell labels, or categorical labels and renders one scatter/marginal series per group. Legends default on for grouped charts unless `Legend` is set to `off`, and grouped histograms default to stair outlines unless `Style` is set explicitly.",
+        "`Color`, `Marker`, `MarkerSize`, `LineStyle`, `LineWidth`, and `Bandwidth` accept scalar/single-value forms or cyclic per-group forms such as color-character sequences, string/cell style arrays, numeric vectors, and RGB or bandwidth matrices.",
+        "`Kernel` set to `on` renders Gaussian kernel-density marginal lines using Scott bandwidth estimates or `Bandwidth`. `Kernel` set to `overlay` renders both binned counts and kernel lines.",
+        "`Style` supports `bar` and `stairs`. Use `Kernel` to select kernel-density marginal lines or count/kernel overlays. `PlotGroup` set to `off` pools grouped observations for plotting."
+    ],
+    "examples": [
+        {
+            "description": "Create a scatter plot with marginal histograms",
+            "input": "h = scatterhist([0; 0.2; 0.8; 1], [0; 0.1; 0.9; 1], 'NBins', [2 2])",
+            "output": "h is a 3-by-1 vector of axes handles."
+        },
+        {
+            "description": "Group observations and show kernel marginals",
+            "input": "g = [\"a\"; \"b\"; \"a\"; \"b\"];\nh = scatterhist(x, y, 'Group', g, 'Kernel', 'overlay', 'Legend', 'on');",
+            "output": "RunMat renders grouped scatter series with marginal density lines."
+        }
+    ],
+    "errors": [
+        {
+            "identifier": "RunMat:scatterhist:InvalidArgument",
+            "message": "scatterhist: invalid argument"
+        },
+        {
+            "identifier": "RunMat:scatterhist:Internal",
+            "message": "scatterhist: internal error"
+        }
+    ],
+    "links": [
+        {
+            "label": "Source",
+            "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/stats/summary/scatterhist.rs"
+        }
+    ],
+    "key": "scatterhist",
+    "aliases": [],
+    "category": "",
+    "categoryPath": []
+};
+export default builtinDoc;
+//# sourceMappingURL=scatterhist.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scatterhist.js","sourceRoot":"","sources":["../../../src/generated/builtins/scatterhist.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,aAAa;IACtB,MAAM,EAAE,aAAa;IACrB,UAAU,EAAE;QACV,aAAa;QACb,SAAS;QACT,WAAW;QACX,UAAU;QACV,YAAY;QACZ,UAAU;KACX;IACD,SAAS,EAAE,iDAAiD;IAC5D,aAAa,EAAE,udAAud;IACte,OAAO,EAAE;QACP,yIAAyI;QACzI,gJAAgJ;QAChJ,mOAAmO;QACnO,oTAAoT;QACpT,oPAAoP;QACpP,4LAA4L;QAC5L,uLAAuL;KACxL;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,gDAAgD;YAC/D,OAAO,EAAE,qEAAqE;YAC9E,QAAQ,EAAE,uCAAuC;SAClD;QACD;YACE,aAAa,EAAE,8CAA8C;YAC7D,OAAO,EAAE,4GAA4G;YACrH,QAAQ,EAAE,oEAAoE;SAC/E;KACF;IACD,QAAQ,EAAE;QACR;YACE,YAAY,EAAE,oCAAoC;YAClD,SAAS,EAAE,+BAA+B;SAC3C;QACD;YACE,YAAY,EAAE,6BAA6B;YAC3C,SAAS,EAAE,6BAA6B;SACzC;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,gHAAgH;SACxH;KACF;IACD,KAAK,EAAE,aAAa;IACpB,SAAS,EAAE,EAAE;IACb,UAAU,EAAE,EAAE;IACd,cAAc,EAAE,EAAE;CACnB,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/secondordercone.js

@@ -0,0 +1,70 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "secondordercone",
+    "category": "math/optim",
+    "keywords": [
+        "secondordercone",
+        "coneprog",
+        "second-order cone",
+        "SOCP",
+        "optimization"
+    ],
+    "summary": "Create a second-order cone constraint descriptor for coneprog.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "This builtin constructs host solver metadata. GPU-resident numeric inputs are gathered before validation."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 4,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::math::optim::coneprog::tests",
+        "integration": null
+    },
+    "description": "`secondordercone(A,b,d,gamma)` creates a descriptor for `norm(A*x + b) <= d'*x + gamma`.",
+    "behaviors": [
+        "`A` must be a nonempty numeric matrix.",
+        "`b` must match the rows of `A`; `d` must match the columns of `A`; `gamma` must be finite.",
+        "The returned host struct can be passed directly to `coneprog`."
+    ],
+    "examples": [
+        {
+            "description": "Create a unit-disk cone",
+            "input": "soc = secondordercone(eye(2), [0; 0], [0; 0], 1)",
+            "output": "soc =\n  struct with fields: A, b, d, gamma, Type"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Can I pass multiple cones to coneprog?",
+            "answer": "Yes. Pass a cell array containing multiple `secondordercone` descriptors."
+        }
+    ],
+    "links": [
+        {
+            "label": "coneprog",
+            "url": "./coneprog"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/math/optim/coneprog.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/math/optim/coneprog.rs"
+    },
+    "key": "secondordercone",
+    "slug": "secondordercone",
+    "aliases": [],
+    "categoryPath": [
+        "math",
+        "optim"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=secondordercone.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"secondordercone.js","sourceRoot":"","sources":["../../../src/generated/builtins/secondordercone.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,iBAAiB;IAC1B,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE;QACV,iBAAiB;QACjB,UAAU;QACV,mBAAmB;QACnB,MAAM;QACN,cAAc;KACf;IACD,SAAS,EAAE,gEAAgE;IAC3E,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,2GAA2G;KACrH;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;KACtB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,wCAAwC;QAChD,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,0FAA0F;IACzG,WAAW,EAAE;QACX,wCAAwC;QACxC,4FAA4F;QAC5F,gEAAgE;KACjE;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,yBAAyB;YACxC,OAAO,EAAE,kDAAkD;YAC3D,QAAQ,EAAE,mDAAmD;SAC9D;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,wCAAwC;YACpD,QAAQ,EAAE,2EAA2E;SACtF;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,6DAA6D;QACtE,KAAK,EAAE,0GAA0G;KAClH;IACD,KAAK,EAAE,iBAAiB;IACxB,MAAM,EAAE,iBAAiB;IACzB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,OAAO;KACR;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/sendmail.js

@@ -0,0 +1,47 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "sendmail",
+    "category": "io/http",
+    "keywords": [
+        "sendmail"
+    ],
+    "summary": "Create an email message using MATLAB sendmail-compatible arguments.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "Host-side compatibility builtin; GPU-resident inputs are gathered before execution."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": null,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::io::http::compat::tests",
+        "integration": null
+    },
+    "description": "Creates and sends a plain-text email message through a configured local transport or outbox capture path.",
+    "behaviors": [
+        "Accepts scalar, string-array, or cell-array recipients plus subject and body text.",
+        "Writes RFC822-style messages to RUNMAT_SENDMAIL_OUTBOX when configured.",
+        "On native hosts, uses RUNMAT_SENDMAIL_COMMAND or /usr/sbin/sendmail when available.",
+        "Reports a clear error when only SMTP preferences are configured because direct TLS SMTP transport is not available in this build."
+    ],
+    "examples": [],
+    "faqs": [],
+    "links": [],
+    "key": "sendmail",
+    "slug": "sendmail",
+    "aliases": [],
+    "categoryPath": [
+        "io",
+        "http"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=sendmail.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sendmail.js","sourceRoot":"","sources":["../../../src/generated/builtins/sendmail.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,UAAU;IACnB,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE;QACV,UAAU;KACX;IACD,SAAS,EAAE,qEAAqE;IAChF,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,qFAAqF;KAC/F;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,mCAAmC;QAC3C,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,2GAA2G;IAC1H,WAAW,EAAE;QACX,oFAAoF;QACpF,yEAAyE;QACzE,qFAAqF;QACrF,mIAAmI;KACpI;IACD,UAAU,EAAE,EAAE;IACd,MAAM,EAAE,EAAE;IACV,OAAO,EAAE,EAAE;IACX,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,IAAI;QACJ,MAAM;KACP;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/sequenceInputLayer.js

@@ -0,0 +1,40 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "sequenceInputLayer",
+    "category": "deep_learning",
+    "keywords": [
+        "sequenceInputLayer",
+        "deep learning",
+        "sequence"
+    ],
+    "summary": "Create a sequence input layer compatibility object.",
+    "description": "`sequenceInputLayer(inputSize)` creates metadata for sequence network definitions.",
+    "behaviors": [
+        "`inputSize` may be a positive integer scalar or numeric vector of positive integers.",
+        "Common name-value options are preserved as properties."
+    ],
+    "examples": [
+        {
+            "description": "Create Sequence Input",
+            "input": "layer = sequenceInputLayer(12, 'Name', 'tokens')",
+            "output": "`layer` stores input-size and name metadata."
+        }
+    ],
+    "syntax": {
+        "example": {
+            "description": "Supported forms",
+            "input": "layer = sequenceInputLayer(inputSize)\nlayer = sequenceInputLayer(inputSize, Name, Value)",
+            "output": "Layer compatibility object."
+        }
+    },
+    "gpu_residency": "Layer construction is host metadata work and has no provider kernel.",
+    "key": "sequenceinputlayer",
+    "slug": "sequenceinputlayer",
+    "aliases": [],
+    "categoryPath": [
+        "deep_learning"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=sequenceInputLayer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sequenceInputLayer.js","sourceRoot":"","sources":["../../../src/generated/builtins/sequenceInputLayer.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,oBAAoB;IAC7B,UAAU,EAAE,eAAe;IAC3B,UAAU,EAAE;QACV,oBAAoB;QACpB,eAAe;QACf,UAAU;KACX;IACD,SAAS,EAAE,qDAAqD;IAChE,aAAa,EAAE,oFAAoF;IACnG,WAAW,EAAE;QACX,sFAAsF;QACtF,wDAAwD;KACzD;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,uBAAuB;YACtC,OAAO,EAAE,kDAAkD;YAC3D,QAAQ,EAAE,8CAA8C;SACzD;KACF;IACD,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,aAAa,EAAE,iBAAiB;YAChC,OAAO,EAAE,2FAA2F;YACpG,QAAQ,EAAE,6BAA6B;SACxC;KACF;IACD,eAAe,EAAE,sEAAsE;IACvF,KAAK,EAAE,oBAAoB;IAC3B,MAAM,EAAE,oBAAoB;IAC5B,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,eAAe;KAChB;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/setpref.js

@@ -0,0 +1,46 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "setpref",
+    "category": "io/repl_fs",
+    "keywords": [
+        "setpref"
+    ],
+    "summary": "Set RunMat session preferences.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "Host-side compatibility builtin; GPU-resident inputs are gathered before execution."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": null,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::io::repl_fs::compat::tests",
+        "integration": null
+    },
+    "description": "Set RunMat session preferences.",
+    "behaviors": [
+        "Accepts MATLAB text inputs such as string scalars and character row vectors for path, name, or URL arguments where applicable.",
+        "Runs on the host using the active RunMat filesystem, environment, or HTTP abstraction as appropriate.",
+        "Reports MATLAB-style runtime errors for unsupported argument shapes or unavailable host capabilities."
+    ],
+    "examples": [],
+    "faqs": [],
+    "links": [],
+    "key": "setpref",
+    "slug": "setpref",
+    "aliases": [],
+    "categoryPath": [
+        "io",
+        "repl_fs"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=setpref.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"setpref.js","sourceRoot":"","sources":["../../../src/generated/builtins/setpref.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE;QACV,SAAS;KACV;IACD,SAAS,EAAE,iCAAiC;IAC5C,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,qFAAqF;KAC/F;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,sCAAsC;QAC9C,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,iCAAiC;IAChD,WAAW,EAAE;QACX,gIAAgI;QAChI,uGAAuG;QACvG,uGAAuG;KACxG;IACD,UAAU,EAAE,EAAE;IACd,MAAM,EAAE,EAAE;IACV,OAAO,EAAE,EAAE;IACX,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,IAAI;QACJ,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}