runmat 0.4.5-dev.1 → 0.4.5-dev.3

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

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

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

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

@@ -0,0 +1,81 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "fsolve",
+    "category": "math/optim",
+    "keywords": [
+        "fsolve",
+        "nonlinear solve",
+        "root finding",
+        "Jacobian",
+        "Levenberg-Marquardt"
+    ],
+    "summary": "Solve scalar or vector nonlinear equation systems using finite-difference Levenberg-Marquardt iterations.",
+    "references": [
+        "https://www.mathworks.com/help/optim/ug/fsolve.html"
+    ],
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "The nonlinear solver runs on the host. Callback functions may still call GPU-aware builtins."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 3,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::math::optim::fsolve::tests",
+        "integration": "runmat-vm/tests/closures.rs::fsolve_accepts_anonymous_vector_function"
+    },
+    "description": "`x = fsolve(fun, x0)` solves `fun(x) = 0` starting from `x0`. Scalar guesses return scalars; vector and matrix guesses return a result with the same shape as `x0`.",
+    "behaviors": [
+        "The function handle must return a finite real scalar or vector.",
+        "Jacobians are estimated with forward finite differences.",
+        "The step is chosen with a Levenberg-Marquardt damping parameter and accepted only when it reduces the residual norm.",
+        "Options are supplied as a struct, usually created with `optimset`. `TolX`, `TolFun`, `MaxIter`, `MaxFunEvals`, and `Display` are accepted."
+    ],
+    "examples": [
+        {
+            "description": "Solve a two-variable nonlinear system",
+            "input": "F = @(x) [x(1)^2 + x(2)^2 - 4; x(1)*x(2) - 1];\nx = fsolve(F, [1; 1])",
+            "output": "x =\n    1.9319\n    0.5176"
+        },
+        {
+            "description": "Solve a scalar equation",
+            "input": "x = fsolve(@sin, 3)",
+            "output": "x =\n    3.1416"
+        }
+    ],
+    "links": [
+        {
+            "label": "fzero",
+            "url": "./fzero"
+        },
+        {
+            "label": "optimset",
+            "url": "./optimset"
+        },
+        {
+            "label": "linsolve",
+            "url": "./linsolve"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/math/optim/fsolve.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/math/optim/fsolve.rs"
+    },
+    "key": "fsolve",
+    "slug": "fsolve",
+    "aliases": [],
+    "categoryPath": [
+        "math",
+        "optim"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=fsolve.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fsolve.js","sourceRoot":"","sources":["../../../src/generated/builtins/fsolve.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,QAAQ;IACjB,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE;QACV,QAAQ;QACR,iBAAiB;QACjB,cAAc;QACd,UAAU;QACV,qBAAqB;KACtB;IACD,SAAS,EAAE,2GAA2G;IACtH,YAAY,EAAE;QACZ,qDAAqD;KACtD;IACD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,8FAA8F;KACxG;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,sCAAsC;QAC9C,aAAa,EAAE,uEAAuE;KACvF;IACD,aAAa,EAAE,qKAAqK;IACpL,WAAW,EAAE;QACX,iEAAiE;QACjE,0DAA0D;QAC1D,sHAAsH;QACtH,4IAA4I;KAC7I;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,uCAAuC;YACtD,OAAO,EAAE,uEAAuE;YAChF,QAAQ,EAAE,6BAA6B;SACxC;QACD;YACE,aAAa,EAAE,yBAAyB;YACxC,OAAO,EAAE,qBAAqB;YAC9B,QAAQ,EAAE,iBAAiB;SAC5B;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,2DAA2D;QACpE,KAAK,EAAE,wGAAwG;KAChH;IACD,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,OAAO;KACR;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/fzero.js

@@ -0,0 +1,86 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "fzero",
+    "category": "math/optim",
+    "keywords": [
+        "fzero",
+        "root finding",
+        "zero",
+        "brent",
+        "optimization"
+    ],
+    "summary": "Find a zero of a scalar nonlinear function using bracket expansion and Brent's method.",
+    "references": [
+        "https://www.mathworks.com/help/matlab/ref/fzero.html"
+    ],
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "The solver runs on the host. Callback functions may still call GPU-aware builtins."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 3,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::math::optim::fzero::tests",
+        "integration": "runmat-vm/tests/closures.rs::fzero_accepts_anonymous_function"
+    },
+    "description": "`x = fzero(fun, x0)` searches near the scalar initial point `x0` for a sign-changing bracket, then refines the zero. `x = fzero(fun, [a b])` uses the supplied two-element bracket directly.",
+    "behaviors": [
+        "The function handle must return a finite real scalar.",
+        "Bracket endpoints must have opposite signs unless one endpoint is already a root.",
+        "Options are supplied as a struct, usually created with `optimset`. `TolX`, `MaxIter`, `MaxFunEvals`, and `Display` are accepted.",
+        "Anonymous functions, named function handles, and function-handle strings work through RunMat's existing `feval` dispatch path."
+    ],
+    "examples": [
+        {
+            "description": "Find the fixed point of cosine",
+            "input": "f = @(x) cos(x) - x;\nx = fzero(f, 0.5)",
+            "output": "x =\n    0.7391"
+        },
+        {
+            "description": "Use an explicit bracket",
+            "input": "x = fzero(@sin, [3 4])",
+            "output": "x =\n    3.1416"
+        },
+        {
+            "description": "Set a tighter tolerance",
+            "input": "opts = optimset('TolX', 1e-10, 'Display', 'off');\nx = fzero(@sin, [3 4], opts)",
+            "output": "x =\n    3.1416"
+        }
+    ],
+    "links": [
+        {
+            "label": "fsolve",
+            "url": "./fsolve"
+        },
+        {
+            "label": "optimset",
+            "url": "./optimset"
+        },
+        {
+            "label": "roots",
+            "url": "./roots"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/math/optim/fzero.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/math/optim/fzero.rs"
+    },
+    "key": "fzero",
+    "slug": "fzero",
+    "aliases": [],
+    "categoryPath": [
+        "math",
+        "optim"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=fzero.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fzero.js","sourceRoot":"","sources":["../../../src/generated/builtins/fzero.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,OAAO;IAChB,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE;QACV,OAAO;QACP,cAAc;QACd,MAAM;QACN,OAAO;QACP,cAAc;KACf;IACD,SAAS,EAAE,wFAAwF;IACnG,YAAY,EAAE;QACZ,sDAAsD;KACvD;IACD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,oFAAoF;KAC9F;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;KACtB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,qCAAqC;QAC7C,aAAa,EAAE,+DAA+D;KAC/E;IACD,aAAa,EAAE,8LAA8L;IAC7M,WAAW,EAAE;QACX,uDAAuD;QACvD,mFAAmF;QACnF,kIAAkI;QAClI,gIAAgI;KACjI;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,gCAAgC;YAC/C,OAAO,EAAE,yCAAyC;YAClD,QAAQ,EAAE,iBAAiB;SAC5B;QACD;YACE,aAAa,EAAE,yBAAyB;YACxC,OAAO,EAAE,wBAAwB;YACjC,QAAQ,EAAE,iBAAiB;SAC5B;QACD;YACE,aAAa,EAAE,yBAAyB;YACxC,OAAO,EAAE,iFAAiF;YAC1F,QAAQ,EAAE,iBAAiB;SAC5B;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,0DAA0D;QACnE,KAAK,EAAE,uGAAuG;KAC/G;IACD,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,OAAO;IACf,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,OAAO;KACR;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/interp1.js

@@ -0,0 +1,90 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "interp1",
+    "category": "math/interpolation",
+    "keywords": [
+        "interp1",
+        "interpolation",
+        "linear",
+        "nearest",
+        "spline",
+        "pchip"
+    ],
+    "summary": "Interpolate one-dimensional sampled data at query points.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f32",
+            "f64"
+        ],
+        "broadcasting": "matlab",
+        "notes": "GPU inputs are gathered to the CPU reference implementation in this release. Linear and nearest interpolation are good future provider-kernel candidates."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 3,
+        "constants": "inline"
+    },
+    "description": "`interp1(x, y, xq)` estimates values of a one-dimensional data set at query points `xq`. The default method is linear interpolation; `nearest`, `spline`, and `pchip` are also accepted.",
+    "behaviors": [
+        "`interp1(y, xq)` uses implicit sample points `1:numel(y)`.",
+        "`interp1(x, y, xq, method)` supports `linear`, `nearest`, `spline`, and `pchip`.",
+        "Out-of-range query points return `NaN` unless an extrapolation value or `'extrap'` is supplied.",
+        "Dense real numeric arrays are supported. GPU inputs gather to the host reference path."
+    ],
+    "examples": [
+        {
+            "description": "Linear interpolation",
+            "input": "x = [1 2 3];\ny = [10 20 40];\nyq = interp1(x, y, [1.5 2.5])",
+            "output": "yq = [15 30]"
+        },
+        {
+            "description": "Spline interpolation",
+            "input": "x = [1 2 3];\ny = [1 4 9];\nyq = interp1(x, y, [1.5 2.5], 'spline')",
+            "output": "yq = [2.25 6.25]"
+        }
+    ],
+    "syntax": {
+        "example": {
+            "description": "Syntax",
+            "input": "yq = interp1(y, xq)\nyq = interp1(x, y, xq)\nyq = interp1(x, y, xq, method)\nyq = interp1(x, y, xq, method, 'extrap')"
+        },
+        "points": [
+            "`x` is a strictly increasing vector of sample locations. When omitted, RunMat uses `1:numel(y)`.",
+            "`y` contains the sampled values. Vector inputs produce vector outputs; matrix inputs are interpolated along the sample dimension.",
+            "`xq` contains query points. Scalar queries return scalars, and array queries preserve their shape.",
+            "`method` may be `linear`, `nearest`, `spline`, or `pchip`. The default is `linear`.",
+            "Out-of-range queries return `NaN` by default. Pass `'extrap'` to extrapolate or pass a scalar fill value."
+        ]
+    },
+    "links": [
+        {
+            "label": "spline",
+            "url": "./spline"
+        },
+        {
+            "label": "pchip",
+            "url": "./pchip"
+        },
+        {
+            "label": "interp2",
+            "url": "./interp2"
+        }
+    ],
+    "source": {
+        "label": "Open an issue",
+        "url": "https://github.com/runmat-org/runmat/issues/new/choose"
+    },
+    "key": "interp1",
+    "slug": "interp1",
+    "aliases": [],
+    "categoryPath": [
+        "math",
+        "interpolation"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=interp1.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interp1.js","sourceRoot":"","sources":["../../../src/generated/builtins/interp1.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,oBAAoB;IAChC,UAAU,EAAE;QACV,SAAS;QACT,eAAe;QACf,QAAQ;QACR,SAAS;QACT,QAAQ;QACR,OAAO;KACR;IACD,SAAS,EAAE,2DAA2D;IACtE,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;YACL,KAAK;SACN;QACD,cAAc,EAAE,QAAQ;QACxB,OAAO,EAAE,2JAA2J;KACrK;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;KACtB;IACD,aAAa,EAAE,0LAA0L;IACzM,WAAW,EAAE;QACX,4DAA4D;QAC5D,kFAAkF;QAClF,iGAAiG;QACjG,wFAAwF;KACzF;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,sBAAsB;YACrC,OAAO,EAAE,8DAA8D;YACvE,QAAQ,EAAE,cAAc;SACzB;QACD;YACE,aAAa,EAAE,sBAAsB;YACrC,OAAO,EAAE,qEAAqE;YAC9E,QAAQ,EAAE,kBAAkB;SAC7B;KACF;IACD,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,aAAa,EAAE,QAAQ;YACvB,OAAO,EAAE,uHAAuH;SACjI;QACD,QAAQ,EAAE;YACR,kGAAkG;YAClG,mIAAmI;YACnI,oGAAoG;YACpG,qFAAqF;YACrF,2GAA2G;SAC5G;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,eAAe;QACxB,KAAK,EAAE,wDAAwD;KAChE;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,eAAe;KAChB;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/interp2.js

@@ -0,0 +1,88 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "interp2",
+    "category": "math/interpolation",
+    "keywords": [
+        "interp2",
+        "2-D interpolation",
+        "bilinear",
+        "nearest",
+        "meshgrid"
+    ],
+    "summary": "Interpolate values over a two-dimensional gridded surface.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f32",
+            "f64"
+        ],
+        "broadcasting": "matlab",
+        "notes": "GPU inputs are gathered to the CPU reference implementation in this release. Bilinear and nearest interpolation are intended future provider-kernel targets."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 5,
+        "constants": "inline"
+    },
+    "description": "`interp2(X, Y, Z, Xq, Yq)` estimates surface values at query points from gridded data. Vector axes and meshgrid-style coordinate matrices are accepted. `interp2(Z, Xq, Yq)` uses implicit axes based on the rows and columns of `Z`.",
+    "behaviors": [
+        "Supports `linear` and `nearest` methods in the initial implementation.",
+        "Out-of-range query points return `NaN` unless an extrapolation value or `'extrap'` is supplied.",
+        "Dense real numeric inputs are supported. GPU inputs gather to the host reference path."
+    ],
+    "examples": [
+        {
+            "description": "Bilinear interpolation with implicit axes",
+            "input": "Z = [1 2; 3 4];\nzq = interp2(Z, 1.5, 1.5)",
+            "output": "zq = 2.5"
+        },
+        {
+            "description": "Interpolation with meshgrid axes",
+            "input": "[X, Y] = meshgrid([10 20], [100 200]);\nZ = [1 2; 3 4];\nzq = interp2(X, Y, Z, 15, 150)",
+            "output": "zq = 2.5"
+        }
+    ],
+    "syntax": {
+        "example": {
+            "description": "Syntax",
+            "input": "Zq = interp2(Z, Xq, Yq)\nZq = interp2(X, Y, Z, Xq, Yq)\nZq = interp2(X, Y, Z, Xq, Yq, method)"
+        },
+        "points": [
+            "`Z` is a dense 2-D matrix of sampled surface values.",
+            "`X` and `Y` may be vector axes or meshgrid-style coordinate matrices matching `Z`. When omitted, implicit column and row axes are used.",
+            "`Xq` and `Yq` are scalar or same-size query arrays. Scalar queries broadcast against array queries.",
+            "`method` may be `linear` or `nearest` in the initial implementation. The default is `linear`.",
+            "Out-of-range queries return `NaN` by default. Pass `'extrap'` to extrapolate or pass a scalar fill value."
+        ]
+    },
+    "links": [
+        {
+            "label": "interp1",
+            "url": "./interp1"
+        },
+        {
+            "label": "meshgrid",
+            "url": "./meshgrid"
+        },
+        {
+            "label": "peaks",
+            "url": "./peaks"
+        }
+    ],
+    "source": {
+        "label": "Open an issue",
+        "url": "https://github.com/runmat-org/runmat/issues/new/choose"
+    },
+    "key": "interp2",
+    "slug": "interp2",
+    "aliases": [],
+    "categoryPath": [
+        "math",
+        "interpolation"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=interp2.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interp2.js","sourceRoot":"","sources":["../../../src/generated/builtins/interp2.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,oBAAoB;IAChC,UAAU,EAAE;QACV,SAAS;QACT,mBAAmB;QACnB,UAAU;QACV,SAAS;QACT,UAAU;KACX;IACD,SAAS,EAAE,4DAA4D;IACvE,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;YACL,KAAK;SACN;QACD,cAAc,EAAE,QAAQ;QACxB,OAAO,EAAE,8JAA8J;KACxK;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;KACtB;IACD,aAAa,EAAE,uOAAuO;IACtP,WAAW,EAAE;QACX,wEAAwE;QACxE,iGAAiG;QACjG,wFAAwF;KACzF;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,2CAA2C;YAC1D,OAAO,EAAE,4CAA4C;YACrD,QAAQ,EAAE,UAAU;SACrB;QACD;YACE,aAAa,EAAE,kCAAkC;YACjD,OAAO,EAAE,yFAAyF;YAClG,QAAQ,EAAE,UAAU;SACrB;KACF;IACD,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,aAAa,EAAE,QAAQ;YACvB,OAAO,EAAE,+FAA+F;SACzG;QACD,QAAQ,EAAE;YACR,sDAAsD;YACtD,yIAAyI;YACzI,qGAAqG;YACrG,+FAA+F;YAC/F,2GAA2G;SAC5G;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,eAAe;QACxB,KAAK,EAAE,wDAAwD;KAChE;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,eAAe;KAChB;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/optimset.js

@@ -0,0 +1,71 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "optimset",
+    "category": "math/optim",
+    "keywords": [
+        "optimset",
+        "options",
+        "TolX",
+        "TolFun",
+        "MaxIter",
+        "Display"
+    ],
+    "summary": "Create or update an optimization options structure for fzero and fsolve.",
+    "references": [
+        "https://www.mathworks.com/help/matlab/ref/optimset.html"
+    ],
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "Options are host metadata."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::math::optim::optimset::tests"
+    },
+    "description": "`opts = optimset(name, value, ...)` creates a struct of optimization options. `opts = optimset(old, name, value, ...)` copies an existing options struct and applies overrides.",
+    "behaviors": [
+        "Option names are case-insensitive for the builtins that consume them.",
+        "`TolX`, `TolFun`, `MaxIter`, `MaxFunEvals`, and `Display` are canonicalized when constructed with `optimset`.",
+        "Unknown option names are preserved so future solvers can read them."
+    ],
+    "examples": [
+        {
+            "description": "Create options for fzero",
+            "input": "opts = optimset('TolX', 1e-10, 'Display', 'off');\nx = fzero(@sin, [3 4], opts)",
+            "output": "x =\n    3.1416"
+        }
+    ],
+    "links": [
+        {
+            "label": "fzero",
+            "url": "./fzero"
+        },
+        {
+            "label": "fsolve",
+            "url": "./fsolve"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/math/optim/optimset.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/math/optim/optimset.rs"
+    },
+    "key": "optimset",
+    "slug": "optimset",
+    "aliases": [],
+    "categoryPath": [
+        "math",
+        "optim"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=optimset.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"optimset.js","sourceRoot":"","sources":["../../../src/generated/builtins/optimset.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,UAAU;IACnB,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE;QACV,UAAU;QACV,SAAS;QACT,MAAM;QACN,QAAQ;QACR,SAAS;QACT,SAAS;KACV;IACD,SAAS,EAAE,0EAA0E;IACrF,YAAY,EAAE;QACZ,yDAAyD;KAC1D;IACD,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,wCAAwC;KACjD;IACD,aAAa,EAAE,iLAAiL;IAChM,WAAW,EAAE;QACX,uEAAuE;QACvE,+GAA+G;QAC/G,qEAAqE;KACtE;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,0BAA0B;YACzC,OAAO,EAAE,iFAAiF;YAC1F,QAAQ,EAAE,iBAAiB;SAC5B;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,6DAA6D;QACtE,KAAK,EAAE,0GAA0G;KAClH;IACD,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,OAAO;KACR;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/pchip.js

@@ -0,0 +1,78 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "pchip",
+    "category": "math/interpolation",
+    "keywords": [
+        "pchip",
+        "piecewise cubic hermite",
+        "shape preserving",
+        "interpolation"
+    ],
+    "summary": "Shape-preserving piecewise cubic Hermite interpolation.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f32",
+            "f64"
+        ],
+        "broadcasting": "matlab",
+        "notes": "GPU inputs are gathered to the CPU reference implementation."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 3,
+        "constants": "inline"
+    },
+    "description": "`pchip(x, y)` builds a shape-preserving cubic Hermite interpolant. `pchip(x, y, xq)` evaluates it at query points.",
+    "behaviors": [
+        "Returns the same pp-structure shape used by `spline`.",
+        "Uses monotonicity-preserving slopes so monotone data does not overshoot between samples.",
+        "Dense real numeric inputs are supported in the initial implementation."
+    ],
+    "examples": [
+        {
+            "description": "Shape-preserving interpolation",
+            "input": "x = [1 2 3];\ny = [1 4 9];\nyq = pchip(x, y, [1.5 2.5])",
+            "output": "yq = [2.21875 6.21875]"
+        }
+    ],
+    "syntax": {
+        "example": {
+            "description": "Syntax",
+            "input": "pp = pchip(x, y)\nyq = pchip(x, y, xq)"
+        },
+        "points": [
+            "`x` is a strictly increasing vector of sample locations.",
+            "`y` contains the sampled values to interpolate.",
+            "`pchip(x, y)` returns a piecewise-polynomial structure compatible with `ppval`.",
+            "`pchip(x, y, xq)` evaluates the shape-preserving interpolant directly at query points.",
+            "PCHIP is usually preferred over spline interpolation when monotonicity and avoiding overshoot matter."
+        ]
+    },
+    "links": [
+        {
+            "label": "interp1",
+            "url": "./interp1"
+        },
+        {
+            "label": "ppval",
+            "url": "./ppval"
+        }
+    ],
+    "source": {
+        "label": "Open an issue",
+        "url": "https://github.com/runmat-org/runmat/issues/new/choose"
+    },
+    "key": "pchip",
+    "slug": "pchip",
+    "aliases": [],
+    "categoryPath": [
+        "math",
+        "interpolation"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=pchip.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pchip.js","sourceRoot":"","sources":["../../../src/generated/builtins/pchip.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,OAAO;IAChB,UAAU,EAAE,oBAAoB;IAChC,UAAU,EAAE;QACV,OAAO;QACP,yBAAyB;QACzB,kBAAkB;QAClB,eAAe;KAChB;IACD,SAAS,EAAE,yDAAyD;IACpE,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;YACL,KAAK;SACN;QACD,cAAc,EAAE,QAAQ;QACxB,OAAO,EAAE,8DAA8D;KACxE;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;KACtB;IACD,aAAa,EAAE,oHAAoH;IACnI,WAAW,EAAE;QACX,uDAAuD;QACvD,0FAA0F;QAC1F,wEAAwE;KACzE;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,gCAAgC;YAC/C,OAAO,EAAE,yDAAyD;YAClE,QAAQ,EAAE,wBAAwB;SACnC;KACF;IACD,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,aAAa,EAAE,QAAQ;YACvB,OAAO,EAAE,wCAAwC;SAClD;QACD,QAAQ,EAAE;YACR,0DAA0D;YAC1D,iDAAiD;YACjD,iFAAiF;YACjF,wFAAwF;YACxF,uGAAuG;SACxG;KACF;IACD,OAAO,EAAE;QACP;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,eAAe;QACxB,KAAK,EAAE,wDAAwD;KAChE;IACD,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,OAAO;IACf,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,eAAe;KAChB;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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