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

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

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

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

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

package/dist/generated/builtins/gammaln.js

@@ -0,0 +1,129 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "gammaln",
+    "category": "math/elementwise",
+    "keywords": [
+        "gammaln",
+        "gamma",
+        "log gamma",
+        "special function",
+        "elementwise",
+        "gpu"
+    ],
+    "summary": "Compute the natural logarithm of the gamma function element-wise in MATLAB and RunMat.",
+    "gpu_support": {
+        "elementwise": true,
+        "reduction": false,
+        "precisions": [
+            "f32",
+            "f64"
+        ],
+        "broadcasting": "matlab",
+        "notes": "Uses the provider unary_gammaln hook after proving real GPU inputs are nonnegative; falls back to host evaluation when the hook is unavailable."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 1,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::math::elementwise::gammaln::tests",
+        "integration": "builtins::math::elementwise::gammaln::tests::gammaln_gpu_provider_roundtrip"
+    },
+    "description": "`Y = gammaln(A)` evaluates `log(gamma(A))` for real nonnegative inputs while avoiding the overflow that can occur when computing `gamma(A)` first.",
+    "behaviors": [
+        "`gammaln(A)` applies the log-gamma function element-by-element while preserving the input tensor shape.",
+        "Double inputs return double results; single tensors preserve single dtype metadata with single-rounded output values.",
+        "`gammaln(0)` returns `Inf`; `gammaln(Inf)` returns `Inf`; `gammaln(NaN)` returns `NaN`.",
+        "Scalar integer, logical, and character inputs are promoted through RunMat's ordinary numeric coercion path for compatibility with existing elementwise builtins.",
+        "Negative, complex, string, and sparse inputs produce stable typed errors.",
+        "Real GPU tensors stay on device when the provider implements `unary_gammaln`; otherwise RunMat gathers the tensor, evaluates on the host, and returns a host value with the computed results."
+    ],
+    "examples": [
+        {
+            "description": "Evaluate the log-gamma function at a scalar",
+            "input": "y = gammaln(5)",
+            "output": "y = 3.1781"
+        },
+        {
+            "description": "Evaluate a half-integer input",
+            "input": "y = gammaln(0.5)",
+            "output": "y = 0.5724"
+        },
+        {
+            "description": "Apply gammaln element-wise to an array",
+            "input": "A = [0.5 1 2 5];\nY = gammaln(A)",
+            "output": "Y = [0.5724 0 0 3.1781]"
+        },
+        {
+            "description": "Avoid gamma overflow for large inputs",
+            "input": "y = gammaln(171)",
+            "output": "y = 706.5731"
+        },
+        {
+            "description": "Run gammaln on GPU data",
+            "input": "G = gpuArray([0.5 1 5]);\nout = gammaln(G);\nresult = gather(out)",
+            "output": "result = [0.5724 0 3.1781]"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Why use `gammaln(A)` instead of `log(gamma(A))`?",
+            "answer": "`gammaln` evaluates the logarithm directly, so large positive inputs can remain finite even when `gamma(A)` would overflow before the logarithm is taken."
+        },
+        {
+            "question": "Does `gammaln` support complex or negative inputs?",
+            "answer": "No. MATLAB documents `gammaln` for real nonnegative input, and RunMat reports typed errors for complex and negative values."
+        },
+        {
+            "question": "Can `gammaln` run on GPU arrays?",
+            "answer": "Yes for real nonnegative tensors. The WGPU backend evaluates `gammaln` on device; other providers may fall back to host evaluation if they do not expose `unary_gammaln`."
+        }
+    ],
+    "related": [
+        {
+            "label": "gamma",
+            "url": "./gamma"
+        },
+        {
+            "label": "log",
+            "url": "./log"
+        },
+        {
+            "label": "factorial",
+            "url": "./factorial"
+        },
+        {
+            "label": "gpuArray",
+            "url": "./gpuarray"
+        },
+        {
+            "label": "gather",
+            "url": "./gather"
+        }
+    ],
+    "source": [
+        {
+            "label": "`crates/runmat-runtime/src/builtins/math/elementwise/gammaln.rs`",
+            "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/math/elementwise/gammaln.rs"
+        }
+    ],
+    "gpu_residency": "Yes when the active provider implements `unary_gammaln` for real-valued gpuArray inputs. Providers without that hook trigger a host fallback, so the computed result is returned as a host tensor rather than a resident gpuArray.",
+    "implementation_notes": [
+        "CPU evaluation uses a log-Lanczos approximation and the reflection identity for positive inputs below 0.5.",
+        "The WGPU backend uses the same log-Lanczos form for f32 and f64 precision.",
+        "RunMat validates the real nonnegative domain before executing provider kernels so negative inputs produce stable domain errors."
+    ],
+    "key": "gammaln",
+    "slug": "gammaln",
+    "aliases": [],
+    "categoryPath": [
+        "math",
+        "elementwise"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=gammaln.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gammaln.js","sourceRoot":"","sources":["../../../src/generated/builtins/gammaln.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,kBAAkB;IAC9B,UAAU,EAAE;QACV,SAAS;QACT,OAAO;QACP,WAAW;QACX,kBAAkB;QAClB,aAAa;QACb,KAAK;KACN;IACD,SAAS,EAAE,wFAAwF;IACnG,aAAa,EAAE;QACb,aAAa,EAAE,IAAI;QACnB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;YACL,KAAK;SACN;QACD,cAAc,EAAE,QAAQ;QACxB,OAAO,EAAE,iJAAiJ;KAC3J;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,6CAA6C;QACrD,aAAa,EAAE,6EAA6E;KAC7F;IACD,aAAa,EAAE,oJAAoJ;IACnK,WAAW,EAAE;QACX,yGAAyG;QACzG,uHAAuH;QACvH,yFAAyF;QACzF,kKAAkK;QAClK,2EAA2E;QAC3E,+LAA+L;KAChM;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,6CAA6C;YAC5D,OAAO,EAAE,gBAAgB;YACzB,QAAQ,EAAE,YAAY;SACvB;QACD;YACE,aAAa,EAAE,+BAA+B;YAC9C,OAAO,EAAE,kBAAkB;YAC3B,QAAQ,EAAE,YAAY;SACvB;QACD;YACE,aAAa,EAAE,wCAAwC;YACvD,OAAO,EAAE,kCAAkC;YAC3C,QAAQ,EAAE,yBAAyB;SACpC;QACD;YACE,aAAa,EAAE,uCAAuC;YACtD,OAAO,EAAE,kBAAkB;YAC3B,QAAQ,EAAE,cAAc;SACzB;QACD;YACE,aAAa,EAAE,yBAAyB;YACxC,OAAO,EAAE,mEAAmE;YAC5E,QAAQ,EAAE,4BAA4B;SACvC;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,kDAAkD;YAC9D,QAAQ,EAAE,2JAA2J;SACtK;QACD;YACE,UAAU,EAAE,oDAAoD;YAChE,QAAQ,EAAE,6HAA6H;SACxI;QACD;YACE,UAAU,EAAE,kCAAkC;YAC9C,QAAQ,EAAE,2KAA2K;SACtL;KACF;IACD,SAAS,EAAE;QACT;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;KACF;IACD,QAAQ,EAAE;QACR;YACE,OAAO,EAAE,kEAAkE;YAC3E,KAAK,EAAE,+GAA+G;SACvH;KACF;IACD,eAAe,EAAE,oOAAoO;IACrP,sBAAsB,EAAE;QACtB,4GAA4G;QAC5G,4EAA4E;QAC5E,iIAAiI;KAClI;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,aAAa;KACd;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/gamrnd.js

@@ -0,0 +1,75 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "gamrnd",
+    "category": "stats/random",
+    "keywords": [
+        "gamrnd",
+        "gamma",
+        "random",
+        "statistics"
+    ],
+    "summary": "Generate gamma-distributed random samples.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f64"
+        ],
+        "broadcasting": "matlab",
+        "notes": "RunMat currently generates samples on the host RNG path."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 4,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::stats::random::distribution_random::tests",
+        "integration": "crates/runmat-vm/tests/stats_ml.rs"
+    },
+    "description": "`gamrnd(a,b)` generates gamma random samples with shape parameter `a` and scale parameter `b`. Size-vector and dimension-list forms are supported.",
+    "behaviors": [
+        "`a` and `b` support scalar expansion and matching array shapes.",
+        "Without explicit size arguments, the output shape is the scalar-expanded parameter shape.",
+        "With explicit size arguments, nonscalar parameters must match the requested shape.",
+        "`a` must be nonnegative and `b` must be positive."
+    ],
+    "examples": [
+        {
+            "description": "Generate a 2-by-3 gamma sample array",
+            "input": "r = gamrnd(3,7,2,3)"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Which RNG does gamrnd use?",
+            "answer": "It uses RunMat's shared deterministic RNG state, so `rng('default')` resets subsequent `gamrnd` output."
+        }
+    ],
+    "links": [
+        {
+            "label": "rng",
+            "url": "./rng"
+        },
+        {
+            "label": "normrnd",
+            "url": "./normrnd"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/stats/random/distribution_random.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/stats/random/distribution_random.rs"
+    },
+    "key": "gamrnd",
+    "slug": "gamrnd",
+    "aliases": [],
+    "categoryPath": [
+        "stats",
+        "random"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=gamrnd.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gamrnd.js","sourceRoot":"","sources":["../../../src/generated/builtins/gamrnd.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,QAAQ;IACjB,UAAU,EAAE,cAAc;IAC1B,UAAU,EAAE;QACV,QAAQ;QACR,OAAO;QACP,QAAQ;QACR,YAAY;KACb;IACD,SAAS,EAAE,4CAA4C;IACvD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;SACN;QACD,cAAc,EAAE,QAAQ;QACxB,OAAO,EAAE,0DAA0D;KACpE;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,qDAAqD;QAC7D,aAAa,EAAE,oCAAoC;KACpD;IACD,aAAa,EAAE,oJAAoJ;IACnK,WAAW,EAAE;QACX,iEAAiE;QACjE,2FAA2F;QAC3F,oFAAoF;QACpF,mDAAmD;KACpD;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,sCAAsC;YACrD,OAAO,EAAE,qBAAqB;SAC/B;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,4BAA4B;YACxC,QAAQ,EAAE,yGAAyG;SACpH;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,0EAA0E;QACnF,KAAK,EAAE,uHAAuH;KAC/H;IACD,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,QAAQ;KACT;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/genvarname.js

@@ -0,0 +1,115 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "genvarname",
+    "category": "strings/core",
+    "keywords": [
+        "genvarname",
+        "variable name",
+        "identifier",
+        "legacy",
+        "makeValidName",
+        "makeUniqueStrings"
+    ],
+    "summary": "Construct valid, unique MATLAB variable names from text.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "Host-only text conversion. GPU inputs are gathered before processing."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 2,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::strings::core::genvarname::tests",
+        "integration": null
+    },
+    "description": "`genvarname(str)` converts text into valid MATLAB variable names and makes names unique within the returned set. `genvarname(str, exclusions)` also avoids names listed in `exclusions`.",
+    "behaviors": [
+        "Character row-vector input returns a character row vector.",
+        "String scalar input returns a string scalar.",
+        "String arrays preserve their shape and return string arrays.",
+        "Cell arrays of character vectors or string scalars preserve their shape and return cell arrays of character row vectors.",
+        "Character array input must be a character vector; use a string array or cell array to generate multiple names.",
+        "Whitespace is removed and the following alphabetic character is capitalized.",
+        "Nonalphanumeric, non-underscore characters are replaced by their hexadecimal code.",
+        "Names that do not start with a letter are prefixed with `x`, and MATLAB keywords are repaired with the legacy `xKeyword` form such as `xFor`.",
+        "Names are truncated to the current `namelengthmax` compatibility length.",
+        "Duplicate generated names and names present in `exclusions` receive numeric suffixes."
+    ],
+    "examples": [
+        {
+            "description": "Generate Unique Names",
+            "input": "v = genvarname({'A','A','A','A'})",
+            "output": "v = {'A','A1','A2','A3'}"
+        },
+        {
+            "description": "Avoid Excluded Names",
+            "input": "v = genvarname('A', {'A','A1'})",
+            "output": "v = 'A2'"
+        },
+        {
+            "description": "Normalize Invalid Text",
+            "input": "v = genvarname('1 a-b')",
+            "output": "v = 'x1A0x2Db'"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Is `genvarname` a modern MATLAB API?",
+            "answer": "No. MATLAB marks `genvarname` for removal and recommends `matlab.lang.makeValidName` with `matlab.lang.makeUniqueStrings`. RunMat supports it for backward compatibility with older MATLAB code."
+        },
+        {
+            "question": "Does `genvarname` create variables?",
+            "answer": "No. It only returns text that can be used as variable names."
+        },
+        {
+            "question": "Are exclusions normalized first?",
+            "answer": "No. Exclusions are treated as already-specified names to avoid, matching the documented role of excluding existing variable names."
+        }
+    ],
+    "links": [
+        {
+            "label": "isvarname",
+            "url": "./isvarname"
+        },
+        {
+            "label": "cellstr",
+            "url": "./cellstr"
+        },
+        {
+            "label": "string",
+            "url": "./string"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/strings/core/genvarname.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/strings/core/genvarname.rs"
+    },
+    "syntax": {
+        "example": {
+            "description": "Syntax",
+            "input": "varname = genvarname(str)\nvarname = genvarname(str, exclusions)"
+        },
+        "points": [
+            "`str` can be a character array, string scalar/array, or cell array of character vectors/string scalars.",
+            "`exclusions` can be text or a text container of names that generated results must avoid.",
+            "The output preserves the input text container shape where applicable."
+        ]
+    },
+    "key": "genvarname",
+    "slug": "genvarname",
+    "aliases": [],
+    "categoryPath": [
+        "strings",
+        "core"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=genvarname.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"genvarname.js","sourceRoot":"","sources":["../../../src/generated/builtins/genvarname.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,YAAY;IACrB,UAAU,EAAE,cAAc;IAC1B,UAAU,EAAE;QACV,YAAY;QACZ,eAAe;QACf,YAAY;QACZ,QAAQ;QACR,eAAe;QACf,mBAAmB;KACpB;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,uEAAuE;KACjF;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,4CAA4C;QACpD,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,0LAA0L;IACzM,WAAW,EAAE;QACX,4DAA4D;QAC5D,8CAA8C;QAC9C,8DAA8D;QAC9D,0HAA0H;QAC1H,gHAAgH;QAChH,8EAA8E;QAC9E,oFAAoF;QACpF,+IAA+I;QAC/I,0EAA0E;QAC1E,uFAAuF;KACxF;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,uBAAuB;YACtC,OAAO,EAAE,mCAAmC;YAC5C,QAAQ,EAAE,0BAA0B;SACrC;QACD;YACE,aAAa,EAAE,sBAAsB;YACrC,OAAO,EAAE,iCAAiC;YAC1C,QAAQ,EAAE,UAAU;SACrB;QACD;YACE,aAAa,EAAE,wBAAwB;YACvC,OAAO,EAAE,yBAAyB;YAClC,QAAQ,EAAE,gBAAgB;SAC3B;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,sCAAsC;YAClD,QAAQ,EAAE,kMAAkM;SAC7M;QACD;YACE,UAAU,EAAE,qCAAqC;YACjD,QAAQ,EAAE,8DAA8D;SACzE;QACD;YACE,UAAU,EAAE,kCAAkC;YAC9C,QAAQ,EAAE,oIAAoI;SAC/I;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,iEAAiE;QAC1E,KAAK,EAAE,8GAA8G;KACtH;IACD,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,aAAa,EAAE,QAAQ;YACvB,OAAO,EAAE,kEAAkE;SAC5E;QACD,QAAQ,EAAE;YACR,yGAAyG;YACzG,0FAA0F;YAC1F,uEAAuE;SACxE;KACF;IACD,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,YAAY;IACpB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,SAAS;QACT,MAAM;KACP;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/geomean.js

@@ -0,0 +1,75 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "geomean",
+    "category": "stats/summary",
+    "keywords": [
+        "geomean",
+        "geometric mean",
+        "statistics",
+        "summary"
+    ],
+    "summary": "Compute the geometric mean of numeric data.",
+    "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": "`geomean(X)` computes the geometric mean along the first non-singleton dimension. `geomean(X,dim)`, `geomean(X,vecdim)`, and `geomean(X,\"all\")` select the reduction axes.",
+    "behaviors": [
+        "NaNs are included by default.",
+        "`\"omitnan\"` skips NaNs in each slice; empty slices return `NaN`.",
+        "Zero values produce a zero geometric mean for that slice.",
+        "Negative values produce `NaN` for the affected slice."
+    ],
+    "examples": [
+        {
+            "description": "Column geometric means",
+            "input": "m = geomean([1 9; 4 16])"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "How do I ignore missing values?",
+            "answer": "Pass `\"omitnan\"`, for example `geomean(X,1,\"omitnan\")`."
+        }
+    ],
+    "links": [
+        {
+            "label": "harmmean",
+            "url": "./harmmean"
+        },
+        {
+            "label": "mean",
+            "url": "./mean"
+        }
+    ],
+    "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": "geomean",
+    "slug": "geomean",
+    "aliases": [],
+    "categoryPath": [
+        "stats",
+        "summary"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=geomean.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"geomean.js","sourceRoot":"","sources":["../../../src/generated/builtins/geomean.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,eAAe;IAC3B,UAAU,EAAE;QACV,SAAS;QACT,gBAAgB;QAChB,YAAY;QACZ,SAAS;KACV;IACD,SAAS,EAAE,6CAA6C;IACxD,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,8KAA8K;IAC7L,WAAW,EAAE;QACX,+BAA+B;QAC/B,oEAAoE;QACpE,2DAA2D;QAC3D,uDAAuD;KACxD;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,wBAAwB;YACvC,OAAO,EAAE,0BAA0B;SACpC;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,iCAAiC;YAC7C,QAAQ,EAAE,6DAA6D;SACxE;KACF;IACD,OAAO,EAAE;QACP;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,mEAAmE;QAC5E,KAAK,EAAE,gHAAgH;KACxH;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/getAttribute.js

@@ -0,0 +1,104 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "getAttribute",
+    "category": "strings/text_analytics",
+    "keywords": [
+        "getAttribute",
+        "htmlTree",
+        "HTML",
+        "DOM",
+        "attribute",
+        "text analytics"
+    ],
+    "summary": "Read an HTML attribute from htmlTree objects.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "`getAttribute` reads host-resident HTML metadata and does not use provider kernels."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 2,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::strings::text_analytics::html::tests",
+        "integration": null
+    },
+    "description": "`getAttribute(tree, attr)` returns the value of an HTML attribute from a scalar RunMat `htmlTree` object or from each object in a cell array of `htmlTree` objects.",
+    "behaviors": [
+        "`tree` must be a scalar RunMat `htmlTree` object or a cell array of `htmlTree` objects, such as the output of `findElement`.",
+        "`attr` must be a nonempty string scalar or character vector.",
+        "Attribute names are normalized to lowercase and matched against the parser's lowercase attribute map.",
+        "A scalar `htmlTree` input returns a string scalar.",
+        "A cell array of `htmlTree` objects returns a string array with the same shape unless there is only one cell element.",
+        "If the requested attribute is absent, RunMat returns `<missing>` for that element.",
+        "Full MATLAB missing-string scalar representation for `htmlTree` attributes remains tied to broader missing/object-array compatibility work."
+    ],
+    "examples": [
+        {
+            "description": "Read Link Attributes",
+            "input": "tree = htmlTree(\"<a href='/home'>Home</a>\");\nhref = getAttribute(tree, \"href\")",
+            "output": "href = \"/home\""
+        },
+        {
+            "description": "Read Attributes From Matches",
+            "input": "tree = htmlTree(\"<div><a href='/home'>Home</a><a>Docs</a></div>\");\nlinks = findElement(tree, \"a\");\nhrefs = getAttribute(links, \"href\")",
+            "output": "hrefs = [\"/home\"; \"<missing>\"]"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "What does RunMat return for a missing attribute?",
+            "answer": "RunMat returns the string `<missing>` for that element. A first-class MATLAB missing-string scalar for this object path remains tracked with broader missing/object compatibility work."
+        },
+        {
+            "question": "Does `getAttribute` execute on the GPU?",
+            "answer": "No. Attribute lookup is host HTML metadata access and has no `runmat-accelerate` provider path."
+        }
+    ],
+    "links": [
+        {
+            "label": "htmlTree",
+            "url": "./htmlTree"
+        },
+        {
+            "label": "findElement",
+            "url": "./findElement"
+        },
+        {
+            "label": "extractHTMLText",
+            "url": "./extractHTMLText"
+        }
+    ],
+    "syntax": {
+        "example": {
+            "description": "Supported form",
+            "input": "str = getAttribute(tree, attr)",
+            "output": "`str` is a string scalar or string array."
+        },
+        "points": [
+            "`tree` must be an `htmlTree` object or a cell array of `htmlTree` objects.",
+            "`attr` must name one HTML attribute."
+        ]
+    },
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/strings/text_analytics/html.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/strings/text_analytics/html.rs"
+    },
+    "gpu_residency": "`getAttribute` reads host-resident HTML metadata and has no provider kernel.",
+    "key": "getattribute",
+    "slug": "getattribute",
+    "aliases": [],
+    "categoryPath": [
+        "strings",
+        "text_analytics"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=getAttribute.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getAttribute.js","sourceRoot":"","sources":["../../../src/generated/builtins/getAttribute.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,cAAc;IACvB,UAAU,EAAE,wBAAwB;IACpC,UAAU,EAAE;QACV,cAAc;QACd,UAAU;QACV,MAAM;QACN,KAAK;QACL,WAAW;QACX,gBAAgB;KACjB;IACD,SAAS,EAAE,+CAA+C;IAC1D,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,qFAAqF;KAC/F;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,gDAAgD;QACxD,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,qKAAqK;IACpL,WAAW,EAAE;QACX,8HAA8H;QAC9H,8DAA8D;QAC9D,uGAAuG;QACvG,oDAAoD;QACpD,sHAAsH;QACtH,oFAAoF;QACpF,6IAA6I;KAC9I;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,sBAAsB;YACrC,OAAO,EAAE,qFAAqF;YAC9F,QAAQ,EAAE,kBAAkB;SAC7B;QACD;YACE,aAAa,EAAE,8BAA8B;YAC7C,OAAO,EAAE,gJAAgJ;YACzJ,QAAQ,EAAE,oCAAoC;SAC/C;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,kDAAkD;YAC9D,QAAQ,EAAE,yLAAyL;SACpM;QACD;YACE,UAAU,EAAE,yCAAyC;YACrD,QAAQ,EAAE,iGAAiG;SAC5G;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,aAAa;YACtB,KAAK,EAAE,eAAe;SACvB;QACD;YACE,OAAO,EAAE,iBAAiB;YAC1B,KAAK,EAAE,mBAAmB;SAC3B;KACF;IACD,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,aAAa,EAAE,gBAAgB;YAC/B,OAAO,EAAE,gCAAgC;YACzC,QAAQ,EAAE,2CAA2C;SACtD;QACD,QAAQ,EAAE;YACR,4EAA4E;YAC5E,sCAAsC;SACvC;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,qEAAqE;QAC9E,KAAK,EAAE,kHAAkH;KAC1H;IACD,eAAe,EAAE,8EAA8E;IAC/F,KAAK,EAAE,cAAc;IACrB,MAAM,EAAE,cAAc;IACtB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,SAAS;QACT,gBAAgB;KACjB;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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