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

package/dist/generated/builtins/kurtosis.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"kurtosis.js","sourceRoot":"","sources":["../../../src/generated/builtins/kurtosis.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,UAAU;IACnB,UAAU,EAAE,eAAe;IAC3B,UAAU,EAAE;QACV,UAAU;QACV,eAAe;QACf,YAAY;QACZ,SAAS;KACV;IACD,SAAS,EAAE,0BAA0B;IACrC,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;SACN;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,yFAAyF;KACnG;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,MAAM;KACpB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,8CAA8C;QACtD,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,oMAAoM;IACnN,WAAW,EAAE;QACX,kDAAkD;QAClD,oHAAoH;QACpH,yCAAyC;QACzC,qEAAqE;KACtE;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,4BAA4B;YAC3C,OAAO,EAAE,6BAA6B;SACvC;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,uCAAuC;YACnD,QAAQ,EAAE,oFAAoF;SAC/F;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,mEAAmE;QAC5E,KAAK,EAAE,gHAAgH;KACxH;IACD,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/lasso.js

@@ -0,0 +1,110 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "lasso",
+    "category": "stats/ml",
+    "keywords": [
+        "lasso",
+        "elastic net",
+        "regularization",
+        "regression",
+        "statistics",
+        "machine learning"
+    ],
+    "summary": "Fit lasso or elastic-net regularized linear regression models.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f64"
+        ],
+        "broadcasting": "none",
+        "notes": "GPU inputs are gathered to host. The coordinate-descent solver runs on CPU."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "none"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::stats::ml::lasso::tests",
+        "integration": null
+    },
+    "description": "`lasso(X,y)` fits regularized linear regression coefficients for predictor matrix `X` and response vector `y`. Columns of `B` correspond to ascending `Lambda` values, and `[B,FitInfo] = lasso(...)` returns MATLAB-compatible fit metadata.",
+    "behaviors": [
+        "`X` must be a finite real numeric matrix with observations in rows and predictors in columns. `y` must be a finite real vector whose length matches `size(X,1)`.",
+        "`Lambda` accepts a nonnegative scalar or vector. RunMat sorts Lambda values in ascending order for output, matching MATLAB's `FitInfo.Lambda` convention.",
+        "When `Lambda` is omitted, RunMat computes a geometric regularization path using `NumLambda` and `LambdaRatio` from the largest lambda that gives an all-zero model.",
+        "`Alpha` supports lasso and elastic-net fits for values in `(0,1]`. `Alpha=1` is lasso; smaller positive values mix in the ridge penalty.",
+        "`Standardize` and `Intercept` follow MATLAB's model form. If `Intercept` is false, RunMat disables standardization and returns zero intercepts.",
+        "`Weights` accepts a nonnegative observation-weight vector with positive total weight. Weights are normalized internally.",
+        "`RelTol` and `MaxIter` control coordinate-descent convergence. The `Iterations` FitInfo field records iterations per Lambda value.",
+        "`CV` supports `\"resubstitution\"` and positive integer K-fold cross-validation. K-fold fits add `SE`, `LambdaMinMSE`, `Lambda1SE`, `IndexMinMSE`, and `Index1SE` fields to `FitInfo`.",
+        "`PredictorNames`, `DFmax`, `UseCovariance`, `CacheSize`, `MCReps=1`, `AbsTol`, `B0`, `U0`, `Rho`, and `Options` are accepted for script compatibility. Tall-array ADMM behavior and covariance-matrix acceleration are not implemented; `FitInfo.UseCovariance` is false because RunMat uses direct coordinate descent."
+    ],
+    "examples": [
+        {
+            "description": "Fit a sparse linear model for an explicit Lambda",
+            "input": "X = [0 1; 1 1; 2 1; 3 1; 4 1];\ny = [1; 3; 5; 7; 9];\nB = lasso(X, y, \"Lambda\", 0, \"Standardize\", false)",
+            "output": "B is approximately [2; 0]. Use FitInfo.Intercept for the constant term."
+        },
+        {
+            "description": "Return FitInfo for an elastic-net path",
+            "input": "[B,FitInfo] = lasso(X, y, \"Alpha\", 0.5, \"Lambda\", [0 0.01 0.1]);\ncoef0 = FitInfo.Intercept(1)",
+            "output": "B has one column per Lambda value; FitInfo contains Lambda, Alpha, Intercept, DF, and MSE."
+        },
+        {
+            "description": "Use K-fold cross-validation",
+            "input": "[B,FitInfo] = lasso(X, y, \"CV\", 5);\nidx = FitInfo.IndexMinMSE;\ncoef = B(:,idx)",
+            "output": "FitInfo includes cross-validation MSE, SE, and Lambda selection fields."
+        },
+        {
+            "description": "Weight observations",
+            "input": "w = ones(size(y));\nw(1:5) = 2;\n[B,FitInfo] = lasso(X, y, \"Weights\", w)",
+            "output": "Rows with larger weights contribute more to the weighted least-squares objective."
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Where is the intercept stored?",
+            "answer": "The coefficient matrix `B` contains only predictor coefficients. Intercepts are returned in `FitInfo.Intercept`, one value per Lambda."
+        },
+        {
+            "question": "Does RunMat implement covariance-matrix acceleration?",
+            "answer": "No. RunMat accepts `UseCovariance` for script compatibility, but fitting uses the direct coordinate-descent path and `FitInfo.UseCovariance` is false."
+        },
+        {
+            "question": "How are Lambda values ordered?",
+            "answer": "RunMat returns Lambda values in ascending order in `FitInfo.Lambda`, and the columns of `B` use the same order."
+        },
+        {
+            "question": "Does cross-validation match MATLAB's random partitions exactly?",
+            "answer": "No. RunMat currently uses deterministic round-robin K-fold partitions. The returned fields and selection semantics are MATLAB-compatible, but fold assignment is deterministic."
+        }
+    ],
+    "links": [
+        {
+            "label": "corr",
+            "url": "./corr"
+        },
+        {
+            "label": "normalize",
+            "url": "./normalize"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/stats/ml/lasso.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/stats/ml/lasso.rs"
+    },
+    "key": "lasso",
+    "slug": "lasso",
+    "aliases": [],
+    "categoryPath": [
+        "stats",
+        "ml"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=lasso.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lasso.js","sourceRoot":"","sources":["../../../src/generated/builtins/lasso.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,aAAa;QACb,gBAAgB;QAChB,YAAY;QACZ,YAAY;QACZ,kBAAkB;KACnB;IACD,SAAS,EAAE,gEAAgE;IAC3E,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;SACN;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,6EAA6E;KACvF;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,mCAAmC;QAC3C,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,+OAA+O;IAC9P,WAAW,EAAE;QACX,kKAAkK;QAClK,2JAA2J;QAC3J,qKAAqK;QACrK,0IAA0I;QAC1I,iJAAiJ;QACjJ,0HAA0H;QAC1H,oIAAoI;QACpI,wLAAwL;QACxL,yTAAyT;KAC1T;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,kDAAkD;YACjE,OAAO,EAAE,8GAA8G;YACvH,QAAQ,EAAE,yEAAyE;SACpF;QACD;YACE,aAAa,EAAE,wCAAwC;YACvD,OAAO,EAAE,oGAAoG;YAC7G,QAAQ,EAAE,4FAA4F;SACvG;QACD;YACE,aAAa,EAAE,6BAA6B;YAC5C,OAAO,EAAE,oFAAoF;YAC7F,QAAQ,EAAE,yEAAyE;SACpF;QACD;YACE,aAAa,EAAE,qBAAqB;YACpC,OAAO,EAAE,4EAA4E;YACrF,QAAQ,EAAE,mFAAmF;SAC9F;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,gCAAgC;YAC5C,QAAQ,EAAE,wIAAwI;SACnJ;QACD;YACE,UAAU,EAAE,uDAAuD;YACnE,QAAQ,EAAE,wJAAwJ;SACnK;QACD;YACE,UAAU,EAAE,gCAAgC;YAC5C,QAAQ,EAAE,iHAAiH;SAC5H;QACD;YACE,UAAU,EAAE,iEAAiE;YAC7E,QAAQ,EAAE,iLAAiL;SAC5L;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;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/lassoglm.d.ts

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

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

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

@@ -0,0 +1,117 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "lassoglm",
+    "category": "stats/ml",
+    "keywords": [
+        "lassoglm",
+        "lasso",
+        "elastic net",
+        "generalized linear model",
+        "glm",
+        "binomial",
+        "poisson",
+        "statistics",
+        "machine learning"
+    ],
+    "summary": "Fit lasso or elastic-net regularized generalized linear models.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f64"
+        ],
+        "broadcasting": "none",
+        "notes": "GPU inputs are gathered to host. The regularized GLM solver runs on CPU."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "none"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::stats::ml::lassoglm::tests",
+        "integration": "runmat-vm stats_ml::lassoglm_surface_executes_from_scripts"
+    },
+    "description": "`lassoglm(X,Y,distr)` fits a regularized generalized linear model for predictor matrix `X`, response `Y`, and distribution `distr`. Columns of `B` correspond to ascending `Lambda` values, and `[B,FitInfo] = lassoglm(...)` returns MATLAB-compatible fit metadata.",
+    "behaviors": [
+        "`X` must be a finite real numeric matrix with observations in rows and predictors in columns.",
+        "`distr` supports `\"normal\"`/`\"gaussian\"`, `\"binomial\"`, and `\"poisson\"`. Normal and poisson responses are numeric vectors. Binomial responses may be a probability/logical vector or an `N`-by-2 successes/trials count matrix.",
+        "`Lambda` accepts a nonnegative scalar or vector. RunMat sorts Lambda values in ascending order for output, matching MATLAB's `FitInfo.Lambda` convention.",
+        "When `Lambda` is omitted, RunMat computes a geometric regularization path using `NumLambda` and `LambdaRatio` from an all-zero coefficient model.",
+        "`Alpha` supports lasso and elastic-net fits for values in `(0,1]`. `Alpha=1` is lasso; smaller positive values mix in the ridge penalty.",
+        "`Standardize` and `Intercept` follow MATLAB's model form. `Weights` accepts a nonnegative observation-weight vector with positive total weight, and `Offset` accepts one finite offset per observation.",
+        "`RelTol`, `MaxIter`, and statset-style `Options` control solver convergence. `Options.MaxIter`, `Options.TolX`, and `Options.TolFun` are honored; enabled parallel options are rejected because RunMat's solver is CPU-local.",
+        "`CV` supports `\"resubstitution\"` and positive integer K-fold cross-validation. K-fold fits add `SE`, `LambdaMinDeviance`, `Lambda1SE`, `IndexMinDeviance`, and `Index1SE` fields to `FitInfo`.",
+        "`BinomialSize` supports scalar or per-observation trial counts for binomial probability responses. `Link` is accepted only for canonical supported links (`identity`, `logit`, or `log` according to distribution), `EstDisp` currently accepts `\"off\"`, and unsupported values are rejected instead of silently changing the model."
+    ],
+    "examples": [
+        {
+            "description": "Fit a binomial logistic model",
+            "input": "X = [0; 1; 2; 3; 4; 5];\ny = [0; 0; 0; 1; 1; 1];\n[B,FitInfo] = lassoglm(X, y, \"binomial\", \"Lambda\", [0 0.1])",
+            "output": "B has one row and two columns. FitInfo contains Intercept, Lambda, Deviance, DF, and Iterations."
+        },
+        {
+            "description": "Fit a poisson model with statset options",
+            "input": "opts = statset(\"lassoglm\", \"MaxIter\", 400);\n[B,FitInfo] = lassoglm(X, counts, \"poisson\", \"Options\", opts)",
+            "output": "The solver uses the supplied maximum iteration count and canonical log link."
+        },
+        {
+            "description": "Use K-fold cross-validation",
+            "input": "[B,FitInfo] = lassoglm(X, y, \"normal\", \"CV\", 5);\ncoef = B(:,FitInfo.IndexMinDeviance)",
+            "output": "FitInfo includes cross-validation deviance, SE, and Lambda selection fields."
+        },
+        {
+            "description": "Use grouped binomial counts",
+            "input": "Y = [8 10; 3 10; 1 8];\nB = lassoglm(X, Y, \"binomial\", \"Weights\", [1; 2; 1])",
+            "output": "The first column is successes and the second column is trials."
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Where is the intercept stored?",
+            "answer": "The coefficient matrix `B` contains only predictor coefficients. Intercepts are returned in `FitInfo.Intercept`, one value per Lambda."
+        },
+        {
+            "question": "Which links are implemented?",
+            "answer": "RunMat uses canonical links for supported distributions: identity for normal, logit for binomial, and log for poisson. Other `Link` values are rejected because returning a canonical-link fit for a noncanonical request would be misleading."
+        },
+        {
+            "question": "How are Lambda values ordered?",
+            "answer": "RunMat returns Lambda values in ascending order in `FitInfo.Lambda`, and the columns of `B` use the same order."
+        },
+        {
+            "question": "Does cross-validation match MATLAB's random partitions exactly?",
+            "answer": "No. RunMat currently uses deterministic round-robin K-fold partitions. The returned fields and selection semantics are MATLAB-compatible, but fold assignment is deterministic."
+        }
+    ],
+    "links": [
+        {
+            "label": "lasso",
+            "url": "./lasso"
+        },
+        {
+            "label": "mnrfit",
+            "url": "./mnrfit"
+        },
+        {
+            "label": "statset",
+            "url": "./statset"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/stats/ml/lassoglm.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/stats/ml/lassoglm.rs"
+    },
+    "key": "lassoglm",
+    "slug": "lassoglm",
+    "aliases": [],
+    "categoryPath": [
+        "stats",
+        "ml"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=lassoglm.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lassoglm.js","sourceRoot":"","sources":["../../../src/generated/builtins/lassoglm.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,UAAU;IACnB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,UAAU;QACV,OAAO;QACP,aAAa;QACb,0BAA0B;QAC1B,KAAK;QACL,UAAU;QACV,SAAS;QACT,YAAY;QACZ,kBAAkB;KACnB;IACD,SAAS,EAAE,iEAAiE;IAC5E,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;SACN;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,0EAA0E;KACpF;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,MAAM;KACpB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,sCAAsC;QAC9C,aAAa,EAAE,4DAA4D;KAC5E;IACD,aAAa,EAAE,uQAAuQ;IACtR,WAAW,EAAE;QACX,+FAA+F;QAC/F,yOAAyO;QACzO,2JAA2J;QAC3J,mJAAmJ;QACnJ,0IAA0I;QAC1I,yMAAyM;QACzM,+NAA+N;QAC/N,kMAAkM;QAClM,wUAAwU;KACzU;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,+BAA+B;YAC9C,OAAO,EAAE,mHAAmH;YAC5H,QAAQ,EAAE,kGAAkG;SAC7G;QACD;YACE,aAAa,EAAE,0CAA0C;YACzD,OAAO,EAAE,oHAAoH;YAC7H,QAAQ,EAAE,8EAA8E;SACzF;QACD;YACE,aAAa,EAAE,6BAA6B;YAC5C,OAAO,EAAE,4FAA4F;YACrG,QAAQ,EAAE,8EAA8E;SACzF;QACD;YACE,aAAa,EAAE,6BAA6B;YAC5C,OAAO,EAAE,kFAAkF;YAC3F,QAAQ,EAAE,gEAAgE;SAC3E;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,gCAAgC;YAC5C,QAAQ,EAAE,wIAAwI;SACnJ;QACD;YACE,UAAU,EAAE,8BAA8B;YAC1C,QAAQ,EAAE,gPAAgP;SAC3P;QACD;YACE,UAAU,EAAE,gCAAgC;YAC5C,QAAQ,EAAE,iHAAiH;SAC5H;QACD;YACE,UAAU,EAAE,iEAAiE;YAC7E,QAAQ,EAAE,iLAAiL;SAC5L;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,2DAA2D;QACpE,KAAK,EAAE,wGAAwG;KAChH;IACD,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,IAAI;KACL;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

@@ -0,0 +1,41 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "layerGraph",
+    "category": "deep_learning",
+    "keywords": [
+        "layerGraph",
+        "deep learning",
+        "network graph"
+    ],
+    "summary": "Create a layer graph compatibility object.",
+    "description": "`layerGraph` creates a host metadata graph object from zero inputs or a layer collection.",
+    "behaviors": [
+        "Accepts zero inputs, a layer object, a cell array of layer objects, or an object list.",
+        "Stores `Layers`, `LayerNames`, and an empty `Connections` structure.",
+        "Connection editing helpers such as `addLayers` and `connectLayers` remain outside this slice."
+    ],
+    "examples": [
+        {
+            "description": "Create Graph From Layers",
+            "input": "layers = {featureInputLayer(4,'Name','in'); fullyConnectedLayer(2,'Name','fc')};\ngraph = layerGraph(layers)",
+            "output": "Layer graph compatibility object."
+        }
+    ],
+    "syntax": {
+        "example": {
+            "description": "Supported forms",
+            "input": "graph = layerGraph\ngraph = layerGraph(layers)",
+            "output": "Layer graph compatibility object."
+        }
+    },
+    "gpu_residency": "Layer graph construction is host metadata work and has no provider kernel.",
+    "key": "layergraph",
+    "slug": "layergraph",
+    "aliases": [],
+    "categoryPath": [
+        "deep_learning"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=layerGraph.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"layerGraph.js","sourceRoot":"","sources":["../../../src/generated/builtins/layerGraph.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,YAAY;IACrB,UAAU,EAAE,eAAe;IAC3B,UAAU,EAAE;QACV,YAAY;QACZ,eAAe;QACf,eAAe;KAChB;IACD,SAAS,EAAE,4CAA4C;IACvD,aAAa,EAAE,2FAA2F;IAC1G,WAAW,EAAE;QACX,wFAAwF;QACxF,sEAAsE;QACtE,+FAA+F;KAChG;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,0BAA0B;YACzC,OAAO,EAAE,8GAA8G;YACvH,QAAQ,EAAE,mCAAmC;SAC9C;KACF;IACD,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,aAAa,EAAE,iBAAiB;YAChC,OAAO,EAAE,gDAAgD;YACzD,QAAQ,EAAE,mCAAmC;SAC9C;KACF;IACD,eAAe,EAAE,4EAA4E;IAC7F,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,YAAY;IACpB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,eAAe;KAChB;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

@@ -0,0 +1,40 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "layerNormalizationLayer",
+    "category": "deep_learning",
+    "keywords": [
+        "layerNormalizationLayer",
+        "deep learning",
+        "normalization"
+    ],
+    "summary": "Create a layer normalization layer compatibility object.",
+    "description": "`layerNormalizationLayer` creates metadata for layer-normalization layers.",
+    "behaviors": [
+        "`Epsilon` defaults to `1e-5`.",
+        "Name-value options such as learn-rate factors and initializers are preserved as properties."
+    ],
+    "examples": [
+        {
+            "description": "Create Layer Normalization",
+            "input": "layer = layerNormalizationLayer('Name', 'ln')",
+            "output": "Layer normalization compatibility object."
+        }
+    ],
+    "syntax": {
+        "example": {
+            "description": "Supported forms",
+            "input": "layer = layerNormalizationLayer\nlayer = layerNormalizationLayer(Name, Value)",
+            "output": "Layer compatibility object."
+        }
+    },
+    "gpu_residency": "Layer construction is host metadata work and has no provider kernel.",
+    "key": "layernormalizationlayer",
+    "slug": "layernormalizationlayer",
+    "aliases": [],
+    "categoryPath": [
+        "deep_learning"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=layerNormalizationLayer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"layerNormalizationLayer.js","sourceRoot":"","sources":["../../../src/generated/builtins/layerNormalizationLayer.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,yBAAyB;IAClC,UAAU,EAAE,eAAe;IAC3B,UAAU,EAAE;QACV,yBAAyB;QACzB,eAAe;QACf,eAAe;KAChB;IACD,SAAS,EAAE,0DAA0D;IACrE,aAAa,EAAE,4EAA4E;IAC3F,WAAW,EAAE;QACX,+BAA+B;QAC/B,6FAA6F;KAC9F;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,4BAA4B;YAC3C,OAAO,EAAE,+CAA+C;YACxD,QAAQ,EAAE,2CAA2C;SACtD;KACF;IACD,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,aAAa,EAAE,iBAAiB;YAChC,OAAO,EAAE,+EAA+E;YACxF,QAAQ,EAAE,6BAA6B;SACxC;KACF;IACD,eAAe,EAAE,sEAAsE;IACvF,KAAK,EAAE,yBAAyB;IAChC,MAAM,EAAE,yBAAyB;IACjC,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,eAAe;KAChB;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/lcm.js

@@ -0,0 +1,99 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "lcm",
+    "category": "math/discrete",
+    "keywords": [
+        "lcm",
+        "least common multiple",
+        "integer",
+        "number theory",
+        "discrete math"
+    ],
+    "summary": "Compute least common multiples for positive integer inputs.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "matlab",
+        "notes": "gpuArray inputs are gathered to the host. RunMat preserves supported host output classes rather than dispatching to a GPU provider."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 2,
+        "constants": "none"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::math::discrete::lcm::tests",
+        "integration": null
+    },
+    "description": "`lcm(A,B)` returns the least common multiples of corresponding elements of `A` and `B`. Inputs must be real positive integer values, and the inputs must be the same size or one input must be scalar.",
+    "behaviors": [
+        "Accepts exactly two inputs.",
+        "Inputs must contain finite, real, positive integer values.",
+        "Inputs must have the same size or one input must be scalar-expanded.",
+        "Double inputs return double results; single inputs mixed with double return single results.",
+        "Supported unsigned integer array inputs (`uint8`, `uint16`, and `uint32`) preserve their output class when paired with the same class or a double scalar.",
+        "Scalar signed integer and `uint64` inputs preserve their scalar integer class when the result is representable.",
+        "Mixed integer classes are rejected, matching MATLAB's requirement that integer inputs use the same class unless paired with a double scalar.",
+        "Logical, complex, zero, negative, fractional, non-finite, shape-mismatched, and overflowing inputs raise errors."
+    ],
+    "examples": [
+        {
+            "description": "Least common multiples of a double array and a scalar",
+            "input": "A = [5 17; 10 60];\nL = lcm(A,45)",
+            "output": "L = [45 765; 90 180]"
+        },
+        {
+            "description": "Preserve unsigned integer output class",
+            "input": "A = uint16([255 511 15]);\nB = uint16([15 127 1023]);\nL = lcm(A,B)",
+            "output": "L = uint16([255 64897 5115])"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does lcm support implicit expansion?",
+            "answer": "RunMat supports MATLAB-compatible scalar expansion. Non-scalar inputs must have the same size."
+        },
+        {
+            "question": "Why does lcm reject mixed integer classes?",
+            "answer": "MATLAB requires integer inputs to have the same class unless the other input is a double scalar. RunMat follows that rule to avoid silently returning the wrong integer class."
+        },
+        {
+            "question": "Why does lcm raise overflow errors for integer outputs?",
+            "answer": "The result must fit the output class. RunMat rejects overflowing integer results instead of silently truncating them."
+        }
+    ],
+    "links": [
+        {
+            "label": "primes",
+            "url": "./primes"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/math/discrete/lcm.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/math/discrete/lcm.rs"
+    },
+    "syntax": {
+        "example": {
+            "description": "Syntax",
+            "input": "L = lcm(A,B)"
+        },
+        "points": [
+            "`A` and `B` must be positive integer numeric values.",
+            "`A` and `B` must be the same size, unless one input is scalar.",
+            "`L` has the same size as the non-scalar input, or scalar size when both inputs are scalar."
+        ]
+    },
+    "key": "lcm",
+    "slug": "lcm",
+    "aliases": [],
+    "categoryPath": [
+        "math",
+        "discrete"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=lcm.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lcm.js","sourceRoot":"","sources":["../../../src/generated/builtins/lcm.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,KAAK;IACd,UAAU,EAAE,eAAe;IAC3B,UAAU,EAAE;QACV,KAAK;QACL,uBAAuB;QACvB,SAAS;QACT,eAAe;QACf,eAAe;KAChB;IACD,SAAS,EAAE,6DAA6D;IACxE,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,QAAQ;QACxB,OAAO,EAAE,qIAAqI;KAC/I;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,MAAM;KACpB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,sCAAsC;QAC9C,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,wMAAwM;IACvN,WAAW,EAAE;QACX,6BAA6B;QAC7B,4DAA4D;QAC5D,sEAAsE;QACtE,6FAA6F;QAC7F,2JAA2J;QAC3J,iHAAiH;QACjH,8IAA8I;QAC9I,kHAAkH;KACnH;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,uDAAuD;YACtE,OAAO,EAAE,mCAAmC;YAC5C,QAAQ,EAAE,sBAAsB;SACjC;QACD;YACE,aAAa,EAAE,wCAAwC;YACvD,OAAO,EAAE,qEAAqE;YAC9E,QAAQ,EAAE,8BAA8B;SACzC;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,sCAAsC;YAClD,QAAQ,EAAE,gGAAgG;SAC3G;QACD;YACE,UAAU,EAAE,4CAA4C;YACxD,QAAQ,EAAE,gLAAgL;SAC3L;QACD;YACE,UAAU,EAAE,yDAAyD;YACrE,QAAQ,EAAE,uHAAuH;SAClI;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,2DAA2D;QACpE,KAAK,EAAE,wGAAwG;KAChH;IACD,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,aAAa,EAAE,QAAQ;YACvB,OAAO,EAAE,cAAc;SACxB;QACD,QAAQ,EAAE;YACR,sDAAsD;YACtD,gEAAgE;YAChE,4FAA4F;SAC7F;KACF;IACD,KAAK,EAAE,KAAK;IACZ,MAAM,EAAE,KAAK;IACb,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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