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

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

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

package/dist/generated/builtins/lqr.js

@@ -0,0 +1,117 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "lqr",
+    "category": "control",
+    "keywords": [
+        "lqr",
+        "linear quadratic regulator",
+        "state feedback",
+        "riccati",
+        "control system",
+        "ss"
+    ],
+    "summary": "Compute linear quadratic regulator state-feedback gains.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "`lqr` gathers GPU-resident matrices and solves the dense Riccati equation on the host."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "inline",
+        "notes": "`lqr` is a control solver and is not fused."
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::control::lqr::tests",
+        "integration": "crates/runmat-vm/tests/control.rs"
+    },
+    "description": "`lqr(A,B,Q,R)` and `lqr(A,B,Q,R,N)` solve the continuous-time algebraic Riccati equation and return the optimal gain `K` for the feedback law `u = -K*x`. `lqr(sys,Q,R)` and `lqr(sys,Q,R,N)` use the `A` and `B` matrices from an `ss` model and choose the continuous-time or discrete-time Riccati equation from `sys.Ts`.",
+    "behaviors": [
+        "`A` must be square with one row per state.",
+        "`B` must have one row per state and one column per control input.",
+        "`Q` must be a finite real symmetric `n`-by-`n` matrix.",
+        "`R` must be a finite real symmetric positive-definite `m`-by-`m` matrix.",
+        "`N`, when supplied, must be a finite real `n`-by-`m` cross-weight matrix.",
+        "The block weighting matrix `[Q N; N' R]` must be positive semidefinite.",
+        "With one output, `lqr` returns `K`; with two outputs, it returns `K` and the Riccati solution `S`; with three outputs, it also returns the closed-loop poles of `A-B*K`.",
+        "Matrix-input forms are continuous-time. State-space object forms solve continuous-time models when `Ts = 0` and discrete-time models when `Ts > 0`."
+    ],
+    "examples": [
+        {
+            "description": "Double-integrator regulator",
+            "input": "A = [0 1; 0 0];\nB = [0; 1];\nQ = eye(2);\nR = 1;\n[K, S, e] = lqr(A, B, Q, R)",
+            "output": "K is approximately [1 1.7321], S is the stabilizing Riccati solution, and e contains stable closed-loop poles."
+        },
+        {
+            "description": "State-space object form",
+            "input": "sys = ss([0 1; 0 0], [0; 1], [1 0], 0);\nK = lqr(sys, eye(2), 1)",
+            "output": "K is approximately [1 1.7321]."
+        },
+        {
+            "description": "Discrete state-space object form",
+            "input": "sysd = ss([1 0.1; 0 1], [0.005; 0.1], [1 0], 0, 0.1);\n[K, S, e] = lqr(sysd, eye(2), 1)",
+            "output": "K is a stabilizing discrete-time feedback gain and abs(e) is less than 1."
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does `lqr` support a cross-weight matrix?",
+            "answer": "Yes. Pass `N` as the fifth matrix argument or fourth `ss`-form argument."
+        },
+        {
+            "question": "Does `lqr` run on the GPU?",
+            "answer": "No. It gathers numeric GPU inputs and computes the control synthesis on the host because the operation is a dense Riccati solve rather than an elementwise or provider-level array operation."
+        }
+    ],
+    "links": [
+        {
+            "label": "ss",
+            "url": "./ss"
+        },
+        {
+            "label": "eig",
+            "url": "./eig"
+        },
+        {
+            "label": "pole",
+            "url": "./pole"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/control/lqr.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/control/lqr.rs"
+    },
+    "syntax": {
+        "example": {
+            "description": "Supported forms",
+            "input": "K = lqr(A, B, Q, R)\nK = lqr(A, B, Q, R, N)\n[K, S, e] = lqr(A, B, Q, R)\nK = lqr(sys, Q, R)\n[K, S, e] = lqr(sys, Q, R, N)",
+            "output": "Gain matrix, Riccati solution, and closed-loop poles."
+        },
+        "points": [
+            "At most three output arguments are supported.",
+            "`sys` must be an `ss` object."
+        ]
+    },
+    "validation": {
+        "summary": "`lqr` validates state, input, and weighting dimensions, enforces finite real symmetric weights with positive-definite `R` and positive-semidefinite `[Q N; N' R]`, solves continuous-time Riccati equations through a Hamiltonian matrix-sign method, solves discrete-time `ss` models through an iterative DARE path, and verifies Riccati residuals before materializing outputs.",
+        "implementation": {
+            "label": "`crates/runmat-runtime/src/builtins/control/lqr.rs`",
+            "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/control/lqr.rs"
+        }
+    },
+    "gpu_residency": "`lqr` returns host-resident matrices and pole vectors.",
+    "key": "lqr",
+    "slug": "lqr",
+    "aliases": [],
+    "categoryPath": [
+        "control"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=lqr.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lqr.js","sourceRoot":"","sources":["../../../src/generated/builtins/lqr.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,KAAK;IACd,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE;QACV,KAAK;QACL,4BAA4B;QAC5B,gBAAgB;QAChB,SAAS;QACT,gBAAgB;QAChB,IAAI;KACL;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,wFAAwF;KAClG;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;QACrB,OAAO,EAAE,6CAA6C;KACvD;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,+BAA+B;QACvC,aAAa,EAAE,mCAAmC;KACnD;IACD,aAAa,EAAE,+TAA+T;IAC9U,WAAW,EAAE;QACX,4CAA4C;QAC5C,mEAAmE;QACnE,wDAAwD;QACxD,0EAA0E;QAC1E,2EAA2E;QAC3E,yEAAyE;QACzE,0KAA0K;QAC1K,qJAAqJ;KACtJ;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,6BAA6B;YAC5C,OAAO,EAAE,gFAAgF;YACzF,QAAQ,EAAE,gHAAgH;SAC3H;QACD;YACE,aAAa,EAAE,yBAAyB;YACxC,OAAO,EAAE,kEAAkE;YAC3E,QAAQ,EAAE,gCAAgC;SAC3C;QACD;YACE,aAAa,EAAE,kCAAkC;YACjD,OAAO,EAAE,yFAAyF;YAClG,QAAQ,EAAE,2EAA2E;SACtF;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,2CAA2C;YACvD,QAAQ,EAAE,0EAA0E;SACrF;QACD;YACE,UAAU,EAAE,4BAA4B;YACxC,QAAQ,EAAE,+LAA+L;SAC1M;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,MAAM;SACd;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,qDAAqD;QAC9D,KAAK,EAAE,kGAAkG;KAC1G;IACD,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,aAAa,EAAE,iBAAiB;YAChC,OAAO,EAAE,6HAA6H;YACtI,QAAQ,EAAE,uDAAuD;SAClE;QACD,QAAQ,EAAE;YACR,+CAA+C;YAC/C,+BAA+B;SAChC;KACF;IACD,YAAY,EAAE;QACZ,SAAS,EAAE,qXAAqX;QAChY,gBAAgB,EAAE;YAChB,OAAO,EAAE,qDAAqD;YAC9D,KAAK,EAAE,kGAAkG;SAC1G;KACF;IACD,eAAe,EAAE,wDAAwD;IACzE,KAAK,EAAE,KAAK;IACZ,MAAM,EAAE,KAAK;IACb,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/lscov.js

@@ -0,0 +1,92 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "lscov",
+    "category": "stats/ml",
+    "keywords": [
+        "lscov",
+        "least squares",
+        "weighted least squares",
+        "generalized least squares",
+        "statistics"
+    ],
+    "summary": "Solve linear least-squares systems with observation covariance weighting.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f64"
+        ],
+        "broadcasting": "none",
+        "notes": "GPU-resident numeric inputs are gathered to host. Provider-native dense least-squares acceleration is deferred to the eval-loop GPU fast-path audit."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 4,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::stats::ml::lscov::tests",
+        "integration": null
+    },
+    "description": "`lscov(A,B)` solves the linear least-squares system `A*x = B`. `lscov(A,B,V)` treats `V` as an observation covariance matrix, or as a vector of observation weights. `lscov(A,B,V,alg)` accepts `\"chol\"` and `\"orth\"` algorithm selectors.",
+    "behaviors": [
+        "`A` must be a nonempty 2-D numeric design matrix. `B` must be a vector with one value per row of `A`, or a matrix with the same number of rows as `A`.",
+        "The primary output has shape `size(A,2) x size(B,2)` for matrix right-hand sides, and `size(A,2) x 1` for vector right-hand sides.",
+        "`V` may be omitted, empty, a scalar weight, a weight vector with one value per observation, or a dense square covariance matrix matching the observation count. Weights must be finite and nonnegative with at least one positive value.",
+        "The default `\"chol\"` algorithm uses Cholesky transformation for positive-definite covariance matrices when possible. Singular positive semidefinite covariance matrices fall back to the SVD-backed `\"orth\"` transformation.",
+        "Requested outputs follow MATLAB's `[x,stdx,mse,S]` form. `stdx` matches the coefficient shape, `mse` is a `1 x size(B,2)` row, and `S` is available only when `B` is a vector.",
+        "Real and complex dense `A`/`B` are supported. Sparse inputs and provider-native GPU solves are not implemented in this slice."
+    ],
+    "examples": [
+        {
+            "description": "Fit an unweighted line",
+            "input": "A = [ones(3,1) (0:2)']; B = [1;3;5]; [x,stdx,mse,S] = lscov(A,B)",
+            "output": "x is approximately [1; 2] and mse is 0."
+        },
+        {
+            "description": "Use observation weights",
+            "input": "A = [ones(3,1) (0:2)']; B = [1;2;10]; w = [1;1;100]; x = lscov(A,B,w)",
+            "output": "The high-weight third observation has more influence on x."
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does `lscov` add an intercept automatically?",
+            "answer": "No. Include a column of ones in `A` when the model should include an intercept."
+        },
+        {
+            "question": "Does `lscov` run on the GPU?",
+            "answer": "No. The current implementation gathers GPU inputs and runs the dense weighted least-squares solve on the host."
+        }
+    ],
+    "links": [
+        {
+            "label": "regress",
+            "url": "./regress"
+        },
+        {
+            "label": "mldivide",
+            "url": "./mldivide"
+        },
+        {
+            "label": "pinv",
+            "url": "./pinv"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/stats/ml/lscov.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/stats/ml/lscov.rs"
+    },
+    "key": "lscov",
+    "slug": "lscov",
+    "aliases": [],
+    "categoryPath": [
+        "stats",
+        "ml"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=lscov.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lscov.js","sourceRoot":"","sources":["../../../src/generated/builtins/lscov.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,OAAO;IAChB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,OAAO;QACP,eAAe;QACf,wBAAwB;QACxB,2BAA2B;QAC3B,YAAY;KACb;IACD,SAAS,EAAE,2EAA2E;IACtF,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;SACN;QACD,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,mCAAmC;QAC3C,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,gPAAgP;IAC/P,WAAW,EAAE;QACX,wJAAwJ;QACxJ,oIAAoI;QACpI,0OAA0O;QAC1O,kOAAkO;QAClO,gLAAgL;QAChL,+HAA+H;KAChI;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,wBAAwB;YACvC,OAAO,EAAE,kEAAkE;YAC3E,QAAQ,EAAE,yCAAyC;SACpD;QACD;YACE,aAAa,EAAE,yBAAyB;YACxC,OAAO,EAAE,uEAAuE;YAChF,QAAQ,EAAE,4DAA4D;SACvE;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,8CAA8C;YAC1D,QAAQ,EAAE,iFAAiF;SAC5F;QACD;YACE,UAAU,EAAE,8BAA8B;YAC1C,QAAQ,EAAE,gHAAgH;SAC3H;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,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,wDAAwD;QACjE,KAAK,EAAE,qGAAqG;KAC7G;IACD,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,OAAO;IACf,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,IAAI;KACL;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/lsline.js

@@ -0,0 +1,93 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "lsline",
+    "category": "stats/summary",
+    "keywords": [
+        "lsline",
+        "least squares",
+        "fit line",
+        "statistics",
+        "plotting"
+    ],
+    "summary": "Add least-squares fit lines to scatter-style plots.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "`lsline` inspects existing graphics objects and adds line graphics objects. It does not perform numeric GPU computation or mutate GPU-resident tensors."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "none"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::stats::summary::lsline::tests",
+        "integration": "crates/runmat-vm/tests/stats_ml.rs"
+    },
+    "description": "`lsline` appends least-squares fit lines to eligible scatter-style series in the current or specified axes. It matches MATLAB's compatibility surface for adding fit lines to scatter plots and marker-only line plots, returning the created line handle or handles when requested.",
+    "behaviors": [
+        "`lsline()` scans the current axes and adds one least-squares line for each visible eligible scatter-style plot.",
+        "`lsline(ax)` targets the specified axes without changing other axes.",
+        "Eligible plots include scatter plots and marker-only line plots. Ordinary line plots with a visible connecting line are ignored.",
+        "Non-finite X/Y pairs are skipped when computing the fit. A vertical or constant-X eligible series produces a horizontal least-squares line at the mean Y value.",
+        "If no eligible plots are present, RunMat returns an empty `0x0` handle array.",
+        "The returned line handle is compatible with `get` and `set` for line properties such as `XData`, `YData`, `Color`, `LineStyle`, `LineWidth`, and `DisplayName`."
+    ],
+    "examples": [
+        {
+            "description": "Add a least-squares line to a scatter plot",
+            "input": "x = [1 2 3 4];\ny = [1.2 1.9 3.1 3.8];\nscatter(x, y);\nh = lsline;"
+        },
+        {
+            "description": "Target a specific axes",
+            "input": "ax = subplot(1,2,2);\nscatter(ax, [1 2 3], [2 4 6]);\nh = lsline(ax);"
+        },
+        {
+            "description": "Inspect the generated line data",
+            "input": "scatter([1 2 3], [2 4 6]);\nh = lsline;\nget(h, 'YData')",
+            "output": "ans =\n     2     6"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "How is lsline related to refline?",
+            "answer": "`lsline` only computes least-squares fit lines for eligible scatter-style plots. `refline` can do the same when called without coefficients, but it also accepts explicit slope/intercept coefficients for drawing arbitrary reference lines."
+        },
+        {
+            "question": "Does lsline fit every plot in the axes?",
+            "answer": "No. MATLAB-style `lsline` is intended for scatter-style data. RunMat fits scatter plots and marker-only line plots and ignores connected line plots, surfaces, bars, and other graphics objects."
+        }
+    ],
+    "links": [
+        {
+            "label": "refline",
+            "url": "./refline"
+        },
+        {
+            "label": "scatter",
+            "url": "./scatter"
+        },
+        {
+            "label": "plot",
+            "url": "./plot"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/stats/summary/lsline.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/stats/summary/lsline.rs"
+    },
+    "key": "lsline",
+    "slug": "lsline",
+    "aliases": [],
+    "categoryPath": [
+        "stats",
+        "summary"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=lsline.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lsline.js","sourceRoot":"","sources":["../../../src/generated/builtins/lsline.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,QAAQ;IACjB,UAAU,EAAE,eAAe;IAC3B,UAAU,EAAE;QACV,QAAQ;QACR,eAAe;QACf,UAAU;QACV,YAAY;QACZ,UAAU;KACX;IACD,SAAS,EAAE,qDAAqD;IAChE,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,yJAAyJ;KACnK;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,yCAAyC;QACjD,aAAa,EAAE,oCAAoC;KACpD;IACD,aAAa,EAAE,sRAAsR;IACrS,WAAW,EAAE;QACX,iHAAiH;QACjH,sEAAsE;QACtE,kIAAkI;QAClI,iKAAiK;QACjK,+EAA+E;QAC/E,iKAAiK;KAClK;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,4CAA4C;YAC3D,OAAO,EAAE,qEAAqE;SAC/E;QACD;YACE,aAAa,EAAE,wBAAwB;YACvC,OAAO,EAAE,uEAAuE;SACjF;QACD;YACE,aAAa,EAAE,iCAAiC;YAChD,OAAO,EAAE,0DAA0D;YACnE,QAAQ,EAAE,qBAAqB;SAChC;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,mCAAmC;YAC/C,QAAQ,EAAE,+OAA+O;SAC1P;QACD;YACE,UAAU,EAAE,yCAAyC;YACrD,QAAQ,EAAE,kMAAkM;SAC7M;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,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,8DAA8D;QACvE,KAAK,EAAE,2GAA2G;KACnH;IACD,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/lsqnonlin.js

@@ -0,0 +1,102 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "lsqnonlin",
+    "category": "math/optim",
+    "keywords": [
+        "lsqnonlin",
+        "least squares",
+        "optimization",
+        "bounds",
+        "jacobian"
+    ],
+    "introduced": "eval-loop",
+    "status": "supported",
+    "tests": {
+        "unit": "builtins::math::optim::lsqnonlin::tests",
+        "integration": "runmat-vm/tests/closures.rs::lsqnonlin_accepts_anonymous_residual_function"
+    },
+    "description": "`lsqnonlin` minimizes the squared 2-norm of a vector-valued residual callback `fun(x)` using RunMat's shared finite-difference Levenberg-Marquardt least-squares solver. Scalar, vector, and matrix `x0` inputs are supported and the returned solution preserves the shape of `x0`.",
+    "syntax": [
+        "x = lsqnonlin(fun, x0)",
+        "x = lsqnonlin(fun, x0, lb, ub)",
+        "x = lsqnonlin(fun, x0, lb, ub, options)",
+        "x = lsqnonlin(problem)",
+        "[x, resnorm] = lsqnonlin(___)",
+        "[x, resnorm, residual] = lsqnonlin(___)",
+        "[x, resnorm, residual, exitflag] = lsqnonlin(___)",
+        "[x, resnorm, residual, exitflag, output] = lsqnonlin(___)",
+        "[x, resnorm, residual, exitflag, output, lambda] = lsqnonlin(___)",
+        "[x, resnorm, residual, exitflag, output, lambda, jacobian] = lsqnonlin(___)",
+        "x = lsqnonlin(fun, x0, lb, ub, [], [], [], [], [], options)"
+    ],
+    "notes": [
+        "The residual callback is evaluated as `fun(x)` and must return a finite real numeric scalar, vector, or array. The residual output preserves the callback's initial shape.",
+        "Lower and upper bounds may be empty or contain up to `numel(x0)` elements. Supplied bounds apply to the leading variables; omitted trailing entries are unbounded, matching MATLAB's partial-bound convention.",
+        "`optimset` and `optimoptions` structs are accepted, and `[]` option placeholders are treated as defaults. `TolX`, `TolFun`, `MaxIter`, `MaxFunEvals`, `Display`, and `Algorithm` are recognized.",
+        "RunMat accepts `Algorithm` values `trust-region-reflective` and `levenberg-marquardt` for compatibility metadata, but both execute through the shared finite-difference Levenberg-Marquardt host solver.",
+        "Linear and nonlinear constraints require MATLAB's newer interior-point constrained least-squares path. RunMat accepts empty placeholders in those argument positions but rejects non-empty constraints with a deterministic error.",
+        "Problem structs are supported when they provide `solver`, `objective` or `fun`, `x0`, optional `lb`, optional `ub`, and optional `options`. Constraint fields including `A`, `b`, `Aineq`, `bineq`, `Aeq`, `beq`, and `nonlcon` must be absent or empty.",
+        "The `output` struct includes `iterations`, `funcCount`, `firstorderopt`, `stepsize`, `cgiterations`, `lssteplength`, `algorithm`, and `message`."
+    ],
+    "examples": [
+        {
+            "label": "Fit a vector residual",
+            "input": "r = @(x) [x(1)-2; x(2)-3; x(1)+x(2)-5];\nx = lsqnonlin(r, [0; 0])",
+            "output": "x = [2; 3]"
+        },
+        {
+            "label": "Use bounds",
+            "input": "x = lsqnonlin(@(x) [x-2, x-2], 0, -1, 1)",
+            "output": "x = 1"
+        },
+        {
+            "label": "Request diagnostics",
+            "input": "opts = optimoptions(\"lsqnonlin\", \"Algorithm\", \"levenberg-marquardt\", \"Display\", \"off\");\n[x, resnorm, residual, exitflag, output, lambda, jacobian] = lsqnonlin(@(x) [x(1)-1, 2*x(2)-4], [0 0], [], [], opts)",
+            "output": "x approaches [1 2], resnorm approaches 0, and jacobian is 2-by-2."
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does lsqnonlin support linear or nonlinear constraints?",
+            "answer": "Not yet. Empty A, b, Aineq, bineq, Aeq, beq, and nonlcon placeholders are accepted so common option-forwarding scripts run, but non-empty constraints are rejected because RunMat does not yet have the interior-point constrained least-squares infrastructure."
+        },
+        {
+            "question": "Does lsqnonlin run on the GPU?",
+            "answer": "The solver is host iterative work. Callback code may call GPU-aware builtins, but residuals and bounds are gathered for the solver. Provider-native nonlinear least-squares execution belongs to the queued GPU fast-path audit rather than this compatibility slice."
+        }
+    ],
+    "related": [
+        {
+            "label": "lsqcurvefit",
+            "url": "./lsqcurvefit"
+        },
+        {
+            "label": "fsolve",
+            "url": "./fsolve"
+        },
+        {
+            "label": "optimoptions",
+            "url": "./optimoptions"
+        },
+        {
+            "label": "optimset",
+            "url": "./optimset"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/math/optim/lsqnonlin.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/math/optim/lsqnonlin.rs"
+    },
+    "gpu_residency": "`lsqnonlin` gathers residuals and bounds to the host for iterative solving. Callback bodies can still use GPU-aware builtins; provider-native nonlinear least-squares is deferred to the GPU fast-path audit.",
+    "key": "lsqnonlin",
+    "slug": "lsqnonlin",
+    "aliases": [],
+    "categoryPath": [
+        "math",
+        "optim"
+    ],
+    "summary": ""
+};
+export default builtinDoc;
+//# sourceMappingURL=lsqnonlin.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lsqnonlin.js","sourceRoot":"","sources":["../../../src/generated/builtins/lsqnonlin.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,WAAW;IACpB,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE;QACV,WAAW;QACX,eAAe;QACf,cAAc;QACd,QAAQ;QACR,UAAU;KACX;IACD,YAAY,EAAE,WAAW;IACzB,QAAQ,EAAE,WAAW;IACrB,OAAO,EAAE;QACP,MAAM,EAAE,yCAAyC;QACjD,aAAa,EAAE,4EAA4E;KAC5F;IACD,aAAa,EAAE,sRAAsR;IACrS,QAAQ,EAAE;QACR,wBAAwB;QACxB,gCAAgC;QAChC,yCAAyC;QACzC,wBAAwB;QACxB,+BAA+B;QAC/B,yCAAyC;QACzC,mDAAmD;QACnD,2DAA2D;QAC3D,mEAAmE;QACnE,6EAA6E;QAC7E,6DAA6D;KAC9D;IACD,OAAO,EAAE;QACP,4KAA4K;QAC5K,gNAAgN;QAChN,kMAAkM;QAClM,0MAA0M;QAC1M,oOAAoO;QACpO,0PAA0P;QAC1P,kJAAkJ;KACnJ;IACD,UAAU,EAAE;QACV;YACE,OAAO,EAAE,uBAAuB;YAChC,OAAO,EAAE,mEAAmE;YAC5E,QAAQ,EAAE,YAAY;SACvB;QACD;YACE,OAAO,EAAE,YAAY;YACrB,OAAO,EAAE,0CAA0C;YACnD,QAAQ,EAAE,OAAO;SAClB;QACD;YACE,OAAO,EAAE,qBAAqB;YAC9B,OAAO,EAAE,yNAAyN;YAClO,QAAQ,EAAE,mEAAmE;SAC9E;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,yDAAyD;YACrE,QAAQ,EAAE,kQAAkQ;SAC7Q;QACD;YACE,UAAU,EAAE,gCAAgC;YAC5C,QAAQ,EAAE,uQAAuQ;SAClR;KACF;IACD,SAAS,EAAE;QACT;YACE,OAAO,EAAE,aAAa;YACtB,KAAK,EAAE,eAAe;SACvB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,cAAc;YACvB,KAAK,EAAE,gBAAgB;SACxB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,8DAA8D;QACvE,KAAK,EAAE,2GAA2G;KACnH;IACD,eAAe,EAAE,+MAA+M;IAChO,KAAK,EAAE,WAAW;IAClB,MAAM,EAAE,WAAW;IACnB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,OAAO;KACR;IACD,SAAS,EAAE,EAAE;CACd,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/lstmLayer.js

@@ -0,0 +1,41 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "lstmLayer",
+    "category": "deep_learning",
+    "keywords": [
+        "lstmLayer",
+        "deep learning",
+        "LSTM"
+    ],
+    "summary": "Create an LSTM layer compatibility object.",
+    "description": "`lstmLayer(numHiddenUnits)` creates metadata for LSTM recurrent layers.",
+    "behaviors": [
+        "`numHiddenUnits` must be a positive integer.",
+        "`OutputMode` defaults to `last` and can be overridden with a name-value option.",
+        "Common recurrent-layer options are preserved as properties."
+    ],
+    "examples": [
+        {
+            "description": "Create LSTM Layer",
+            "input": "layer = lstmLayer(64, 'OutputMode', 'sequence', 'Name', 'lstm')",
+            "output": "LSTM layer compatibility object."
+        }
+    ],
+    "syntax": {
+        "example": {
+            "description": "Supported forms",
+            "input": "layer = lstmLayer(numHiddenUnits)\nlayer = lstmLayer(numHiddenUnits, Name, Value)",
+            "output": "Layer compatibility object."
+        }
+    },
+    "gpu_residency": "Layer construction is host metadata work and has no provider kernel.",
+    "key": "lstmlayer",
+    "slug": "lstmlayer",
+    "aliases": [],
+    "categoryPath": [
+        "deep_learning"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=lstmLayer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lstmLayer.js","sourceRoot":"","sources":["../../../src/generated/builtins/lstmLayer.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,WAAW;IACpB,UAAU,EAAE,eAAe;IAC3B,UAAU,EAAE;QACV,WAAW;QACX,eAAe;QACf,MAAM;KACP;IACD,SAAS,EAAE,4CAA4C;IACvD,aAAa,EAAE,yEAAyE;IACxF,WAAW,EAAE;QACX,8CAA8C;QAC9C,iFAAiF;QACjF,6DAA6D;KAC9D;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,mBAAmB;YAClC,OAAO,EAAE,iEAAiE;YAC1E,QAAQ,EAAE,kCAAkC;SAC7C;KACF;IACD,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,aAAa,EAAE,iBAAiB;YAChC,OAAO,EAAE,mFAAmF;YAC5F,QAAQ,EAAE,6BAA6B;SACxC;KACF;IACD,eAAe,EAAE,sEAAsE;IACvF,KAAK,EAAE,WAAW;IAClB,MAAM,EAAE,WAAW;IACnB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,eAAe;KAChB;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

@@ -0,0 +1,71 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "macd",
+    "category": "finance",
+    "keywords": [
+        "macd",
+        "finance",
+        "technical indicator",
+        "moving average",
+        "ema"
+    ],
+    "summary": "Compute the Moving Average Convergence/Divergence indicator.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f64"
+        ],
+        "broadcasting": "none",
+        "notes": "GPU inputs are gathered to host because MACD is a sequential financial indicator."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "none"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::finance::macd::tests",
+        "integration": null
+    },
+    "description": "`macd(Data)` computes the 12-period minus 26-period exponential moving-average line and the 9-period exponential signal line.",
+    "behaviors": [
+        "Matrix input must be M-by-4 with High, Low, Open, and Close prices in columns 1 through 4.",
+        "Table and timetable inputs must contain High, Low, Open, and Close variables, matched case-insensitively.",
+        "Table and timetable High, Low, Open, and Close variables must be numeric M-by-1 vectors.",
+        "The returned MACDLine and SignalLine preserve the input row count and container type.",
+        "For table and timetable inputs, outputs contain a Close variable with the computed series.",
+        "Empty M-by-4 inputs return empty M-by-1 outputs; NaNs propagate through the exponential moving-average recurrence."
+    ],
+    "examples": [
+        {
+            "description": "Compute MACD and signal line",
+            "input": "[m,s] = macd(priceData)"
+        }
+    ],
+    "links": [
+        {
+            "label": "timetable",
+            "url": "./timetable"
+        },
+        {
+            "label": "table",
+            "url": "./table"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/finance/macd.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/finance/macd.rs"
+    },
+    "key": "macd",
+    "slug": "macd",
+    "aliases": [],
+    "categoryPath": [
+        "finance"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=macd.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"macd.js","sourceRoot":"","sources":["../../../src/generated/builtins/macd.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,MAAM;IACf,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE;QACV,MAAM;QACN,SAAS;QACT,qBAAqB;QACrB,gBAAgB;QAChB,KAAK;KACN;IACD,SAAS,EAAE,8DAA8D;IACzE,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;SACN;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,mFAAmF;KAC7F;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,gCAAgC;QACxC,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,+HAA+H;IAC9I,WAAW,EAAE;QACX,4FAA4F;QAC5F,2GAA2G;QAC3G,0FAA0F;QAC1F,uFAAuF;QACvF,4FAA4F;QAC5F,oHAAoH;KACrH;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,8BAA8B;YAC7C,OAAO,EAAE,yBAAyB;SACnC;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,sDAAsD;QAC/D,KAAK,EAAE,mGAAmG;KAC3G;IACD,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IACd,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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