runmat 0.5.2-dev.5 → 0.5.2-dev.6

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

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

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

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

package/dist/generated/builtins/butter.js

@@ -0,0 +1,112 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "butter",
+    "category": "math/signal",
+    "keywords": [
+        "butter",
+        "Butterworth",
+        "IIR",
+        "lowpass",
+        "highpass",
+        "bandpass",
+        "bandstop",
+        "signal processing"
+    ],
+    "summary": "Design Butterworth IIR filters.",
+    "references": [
+        "title: \"MATLAB butter documentation\""
+    ],
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f64"
+        ],
+        "broadcasting": "none",
+        "notes": "Filter design is host-side coefficient generation. The resulting coefficients can be passed to `filter`, which uses the provider `iir_filter` hook for real gpuArray signals when available."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 4,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::math::signal::butter::tests",
+        "integration": "bytecode::compile::tests::compile_interprets_butter_filter_workflow"
+    },
+    "description": "`butter(n, Wn)` designs an order-`n` Butterworth filter. Digital designs use MATLAB's normalized convention where `Wn = 1` is Nyquist. Scalar `Wn` produces a lowpass filter by default; a two-element `Wn` produces a bandpass filter by default. Add an `ftype` string for `low`, `high`, `bandpass`, or `stop`, and add `'s'` for analog transfer functions.",
+    "behaviors": [
+        "`b = butter(n, Wn)` returns numerator coefficients as a row vector.",
+        "`[b, a] = butter(...)` returns numerator and denominator coefficient row vectors suitable for `filter(b, a, x)` in digital mode.",
+        "`[z, p, k] = butter(...)` returns zero-pole-gain form.",
+        "`[A, B, C, D] = butter(...)` returns a controllable-canonical state-space realization.",
+        "Digital cutoff frequencies must be finite, greater than 0, and less than 1. Analog cutoff frequencies must be finite and greater than 0.",
+        "Bandpass and bandstop designs require a strictly increasing two-element `Wn` vector."
+    ],
+    "examples": [
+        {
+            "description": "Low-pass filtering a noisy signal",
+            "input": "fs = 1000;\nt = (0:999) / fs;\nx = sin(2*pi*25*t) + 0.2*sin(2*pi*200*t);\n[b, a] = butter(4, 80/(fs/2), 'low');\ny = filter(b, a, x);",
+            "output": "y contains the low-pass filtered signal."
+        },
+        {
+            "description": "High-pass filter coefficients",
+            "input": "[b, a] = butter(2, 0.25, 'high')",
+            "output": "b and a are row-vector IIR coefficients."
+        },
+        {
+            "description": "Band-pass filter coefficients",
+            "input": "[b, a] = butter(3, [0.2 0.4], 'bandpass')",
+            "output": "b and a each contain 7 coefficients."
+        },
+        {
+            "description": "Analog low-pass prototype",
+            "input": "[b, a] = butter(1, 2, 's')",
+            "output": "b = [0 2]\na = [1 2]"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "What does `Wn` mean for digital filters?",
+            "answer": "RunMat follows MATLAB's normalized digital convention: `Wn = 1` is the Nyquist frequency, so a 600 Hz low-pass filter at a 4800 Hz sample rate uses `butter(n, 600/(4800/2))`."
+        },
+        {
+            "question": "Can I use the result directly with `filter`?",
+            "answer": "Yes. Digital `[b, a]` outputs are ordinary row vectors and can be passed directly to `filter(b, a, x)`."
+        },
+        {
+            "question": "Does `butter` execute on the GPU?",
+            "answer": "No. It generates small coefficient arrays on the host. GPU acceleration applies when those coefficients are used by `filter` with a real gpuArray signal and a provider that implements `iir_filter`."
+        }
+    ],
+    "links": [
+        {
+            "label": "filter",
+            "url": "./filter"
+        },
+        {
+            "label": "conv",
+            "url": "./conv"
+        },
+        {
+            "label": "fft",
+            "url": "./fft"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/math/signal/butter.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/math/signal/butter.rs"
+    },
+    "key": "butter",
+    "slug": "butter",
+    "aliases": [],
+    "categoryPath": [
+        "math",
+        "signal"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=butter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"butter.js","sourceRoot":"","sources":["../../../src/generated/builtins/butter.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,QAAQ;IACjB,UAAU,EAAE,aAAa;IACzB,UAAU,EAAE;QACV,QAAQ;QACR,aAAa;QACb,KAAK;QACL,SAAS;QACT,UAAU;QACV,UAAU;QACV,UAAU;QACV,mBAAmB;KACpB;IACD,SAAS,EAAE,iCAAiC;IAC5C,YAAY,EAAE;QACZ,wCAAwC;KACzC;IACD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;SACN;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,8LAA8L;KACxM;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,uCAAuC;QAC/C,aAAa,EAAE,qEAAqE;KACrF;IACD,aAAa,EAAE,iWAAiW;IAChX,WAAW,EAAE;QACX,qEAAqE;QACrE,kIAAkI;QAClI,wDAAwD;QACxD,wFAAwF;QACxF,0IAA0I;QAC1I,sFAAsF;KACvF;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,mCAAmC;YAClD,OAAO,EAAE,uIAAuI;YAChJ,QAAQ,EAAE,0CAA0C;SACrD;QACD;YACE,aAAa,EAAE,+BAA+B;YAC9C,OAAO,EAAE,kCAAkC;YAC3C,QAAQ,EAAE,0CAA0C;SACrD;QACD;YACE,aAAa,EAAE,+BAA+B;YAC9C,OAAO,EAAE,2CAA2C;YACpD,QAAQ,EAAE,sCAAsC;SACjD;QACD;YACE,aAAa,EAAE,2BAA2B;YAC1C,OAAO,EAAE,4BAA4B;YACrC,QAAQ,EAAE,sBAAsB;SACjC;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,0CAA0C;YACtD,QAAQ,EAAE,gLAAgL;SAC3L;QACD;YACE,UAAU,EAAE,8CAA8C;YAC1D,QAAQ,EAAE,yGAAyG;SACpH;QACD;YACE,UAAU,EAAE,mCAAmC;YAC/C,QAAQ,EAAE,uMAAuM;SAClN;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,4DAA4D;QACrE,KAAK,EAAE,yGAAyG;KACjH;IACD,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,QAAQ;KACT;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/dcgain.js

@@ -0,0 +1,96 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "dcgain",
+    "category": "control",
+    "keywords": [
+        "dcgain",
+        "steady state",
+        "control system",
+        "transfer function",
+        "tf"
+    ],
+    "summary": "Evaluate steady-state gain of SISO transfer-function models.",
+    "references": [
+        "title: \"MATLAB dcgain documentation\""
+    ],
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "`dcgain` evaluates host-side transfer-function metadata."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "inline",
+        "notes": "`dcgain` is scalar model analysis and is not fused."
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::control::dcgain::tests",
+        "integration": "crates/runmat-vm/tests/control.rs"
+    },
+    "description": "`dcgain(sys)` evaluates a SISO transfer function at `s = 0` for continuous-time models or `z = 1` for discrete-time models.",
+    "behaviors": [
+        "Supports SISO `tf` objects.",
+        "Returns a real scalar for real-valued gains and a complex scalar for complex-valued gains.",
+        "Continuous-time models are evaluated at zero frequency.",
+        "Discrete-time models are evaluated at `z = 1`."
+    ],
+    "examples": [
+        {
+            "description": "Continuous-time DC gain",
+            "input": "H = tf(2, [1 3]);\ndcgain(H)",
+            "output": "ans = 0.6667"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does `dcgain` simulate a step response?",
+            "answer": "No. It evaluates the transfer-function polynomials directly at the steady-state point."
+        }
+    ],
+    "links": [
+        {
+            "label": "tf",
+            "url": "./tf"
+        },
+        {
+            "label": "stepinfo",
+            "url": "./stepinfo"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/control/dcgain.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/control/dcgain.rs"
+    },
+    "syntax": {
+        "example": {
+            "description": "Supported form",
+            "input": "gain = dcgain(sys)",
+            "output": "gain is a scalar."
+        },
+        "points": [
+            "`sys` must be a SISO `tf` object."
+        ]
+    },
+    "validation": {
+        "summary": "`dcgain` validates the input model and evaluates numerator and denominator polynomials at the steady-state point. Tests cover real continuous-time gains and VM integration.",
+        "implementation": {
+            "label": "`crates/runmat-runtime/src/builtins/control/dcgain.rs`",
+            "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/control/dcgain.rs"
+        }
+    },
+    "gpu_residency": "`dcgain` returns a host scalar.",
+    "key": "dcgain",
+    "slug": "dcgain",
+    "aliases": [],
+    "categoryPath": [
+        "control"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=dcgain.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dcgain.js","sourceRoot":"","sources":["../../../src/generated/builtins/dcgain.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,QAAQ;IACjB,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE;QACV,QAAQ;QACR,cAAc;QACd,gBAAgB;QAChB,mBAAmB;QACnB,IAAI;KACL;IACD,SAAS,EAAE,8DAA8D;IACzE,YAAY,EAAE;QACZ,wCAAwC;KACzC;IACD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,0DAA0D;KACpE;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;QACrB,OAAO,EAAE,qDAAqD;KAC/D;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,kCAAkC;QAC1C,aAAa,EAAE,mCAAmC;KACnD;IACD,aAAa,EAAE,6HAA6H;IAC5I,WAAW,EAAE;QACX,6BAA6B;QAC7B,4FAA4F;QAC5F,yDAAyD;QACzD,gDAAgD;KACjD;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,yBAAyB;YACxC,OAAO,EAAE,8BAA8B;YACvC,QAAQ,EAAE,cAAc;SACzB;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,yCAAyC;YACrD,QAAQ,EAAE,wFAAwF;SACnG;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,MAAM;SACd;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,wDAAwD;QACjE,KAAK,EAAE,qGAAqG;KAC7G;IACD,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,aAAa,EAAE,gBAAgB;YAC/B,OAAO,EAAE,oBAAoB;YAC7B,QAAQ,EAAE,mBAAmB;SAC9B;QACD,QAAQ,EAAE;YACR,mCAAmC;SACpC;KACF;IACD,YAAY,EAAE;QACZ,SAAS,EAAE,8KAA8K;QACzL,gBAAgB,EAAE;YAChB,OAAO,EAAE,wDAAwD;YACjE,KAAK,EAAE,qGAAqG;SAC7G;KACF;IACD,eAAe,EAAE,iCAAiC;IAClD,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/feedback.js

@@ -0,0 +1,114 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "feedback",
+    "category": "control",
+    "keywords": [
+        "feedback",
+        "closed loop",
+        "control system",
+        "transfer function",
+        "tf"
+    ],
+    "summary": "Form SISO feedback interconnections for transfer-function models.",
+    "references": [
+        "title: \"MATLAB feedback documentation\""
+    ],
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "`feedback` combines host-side transfer-function metadata. GPU-resident coefficient inputs are gathered when the source `tf` object is constructed."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "inline",
+        "notes": "`feedback` constructs a new model object and terminates numeric fusion chains."
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::control::feedback::tests",
+        "integration": "crates/runmat-vm/tests/control.rs"
+    },
+    "description": "`feedback(sys1, sys2)` returns the closed-loop SISO transfer function for negative feedback. `sys2` may be another compatible `tf` object or a scalar gain.",
+    "behaviors": [
+        "Supports real or complex SISO `tf` objects represented by numerator and denominator coefficient vectors.",
+        "`feedback(sys1)` uses unity negative feedback.",
+        "`feedback(sys1, sys2)` computes `sys1/(1 + sys1*sys2)`.",
+        "`feedback(sys1, sys2, +1)` computes positive feedback as `sys1/(1 - sys1*sys2)`.",
+        "Scalar gains are promoted to constant transfer functions using the other operand's variable and sample time.",
+        "Input systems must have compatible sample times.",
+        "Nonzero input or output delays are rejected with a clear unsupported-model diagnostic."
+    ],
+    "examples": [
+        {
+            "description": "Unity negative feedback",
+            "input": "s = tf('s');\nG = 2/(s + 3);\nT = feedback(G, 1);\nT.Denominator",
+            "output": "ans = [1 5]"
+        },
+        {
+            "description": "Positive feedback",
+            "input": "G = tf(2, [1 3]);\nT = feedback(G, 1, +1);\nT.Denominator",
+            "output": "ans = [1 1]"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does `feedback` support MIMO systems?",
+            "answer": "Not yet. This implementation supports SISO transfer-function objects and scalar gains."
+        },
+        {
+            "question": "Does it support state-space models?",
+            "answer": "Not yet. The current model-family support is SISO `tf`."
+        }
+    ],
+    "links": [
+        {
+            "label": "tf",
+            "url": "./tf"
+        },
+        {
+            "label": "step",
+            "url": "./step"
+        },
+        {
+            "label": "isstable",
+            "url": "./isstable"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/control/feedback.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/control/feedback.rs"
+    },
+    "syntax": {
+        "example": {
+            "description": "Supported forms",
+            "input": "T = feedback(sys1)\nT = feedback(sys1, sys2)\nT = feedback(sys1, sys2, sign)",
+            "output": "T is a SISO tf object."
+        },
+        "points": [
+            "`sign` must be `-1` for negative feedback or `+1` for positive feedback.",
+            "`sys1` and `sys2` must be compatible SISO `tf` models or scalar gains.",
+            "Sample times must match when both operands are transfer functions."
+        ]
+    },
+    "validation": {
+        "summary": "`feedback` validates argument count, feedback sign, sample-time compatibility, zero-delay support, and transfer-function model shape. Tests cover unity negative feedback, positive feedback, scalar gains, and VM workflows using `tf('s')`.",
+        "implementation": {
+            "label": "`crates/runmat-runtime/src/builtins/control/feedback.rs`",
+            "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/control/feedback.rs"
+        }
+    },
+    "gpu_residency": "`feedback` returns a host-side `tf` object. It does not preserve gpuArray residency.",
+    "key": "feedback",
+    "slug": "feedback",
+    "aliases": [],
+    "categoryPath": [
+        "control"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=feedback.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.js","sourceRoot":"","sources":["../../../src/generated/builtins/feedback.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,UAAU;IACnB,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE;QACV,UAAU;QACV,aAAa;QACb,gBAAgB;QAChB,mBAAmB;QACnB,IAAI;KACL;IACD,SAAS,EAAE,mEAAmE;IAC9E,YAAY,EAAE;QACZ,0CAA0C;KAC3C;IACD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,oJAAoJ;KAC9J;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;QACrB,OAAO,EAAE,gFAAgF;KAC1F;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,oCAAoC;QAC5C,aAAa,EAAE,mCAAmC;KACnD;IACD,aAAa,EAAE,6JAA6J;IAC5K,WAAW,EAAE;QACX,0GAA0G;QAC1G,gDAAgD;QAChD,yDAAyD;QACzD,kFAAkF;QAClF,8GAA8G;QAC9G,kDAAkD;QAClD,wFAAwF;KACzF;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,yBAAyB;YACxC,OAAO,EAAE,kEAAkE;YAC3E,QAAQ,EAAE,aAAa;SACxB;QACD;YACE,aAAa,EAAE,mBAAmB;YAClC,OAAO,EAAE,2DAA2D;YACpE,QAAQ,EAAE,aAAa;SACxB;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,uCAAuC;YACnD,QAAQ,EAAE,wFAAwF;SACnG;QACD;YACE,UAAU,EAAE,qCAAqC;YACjD,QAAQ,EAAE,yDAAyD;SACpE;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,MAAM;SACd;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,0DAA0D;QACnE,KAAK,EAAE,uGAAuG;KAC/G;IACD,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,aAAa,EAAE,iBAAiB;YAChC,OAAO,EAAE,8EAA8E;YACvF,QAAQ,EAAE,wBAAwB;SACnC;QACD,QAAQ,EAAE;YACR,0EAA0E;YAC1E,wEAAwE;YACxE,oEAAoE;SACrE;KACF;IACD,YAAY,EAAE;QACZ,SAAS,EAAE,+OAA+O;QAC1P,gBAAgB,EAAE;YAChB,OAAO,EAAE,0DAA0D;YACnE,KAAK,EAAE,uGAAuG;SAC/G;KACF;IACD,eAAe,EAAE,sFAAsF;IACvG,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/imhist.js

@@ -0,0 +1,123 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "imhist",
+    "category": "image",
+    "keywords": [
+        "imhist",
+        "image histogram",
+        "grayscale image",
+        "indexed image",
+        "colormap",
+        "matlab imhist"
+    ],
+    "summary": "Compute or display grayscale and indexed-image histograms.",
+    "references": [],
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "single",
+            "double"
+        ],
+        "broadcasting": "none",
+        "notes": "`imhist` gathers gpuArray inputs before binning so image-class validation, bin locations, and output shapes remain MATLAB-compatible."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 2,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::image::imhist::tests",
+        "integration": "runmat_vm::bytecode::compile::tests::compile_interprets_imhist_uint8_workflow"
+    },
+    "description": "`imhist` returns histogram counts for grayscale images and indexed images. Statement-form calls render a bar-chart histogram when plotting is available.",
+    "behaviors": [
+        "`imhist(I)` returns a 256-by-1 count vector for numeric grayscale images.",
+        "`imhist(I, n)` returns counts using `n` positive integer bins.",
+        "`[counts, binLocations] = imhist(I)` also returns the image-class bin centers.",
+        "Floating-point grayscale images must be finite normalized `single` or `double` data in `[0, 1]`.",
+        "`uint8` and `uint16` grayscale images use class ranges `[0, 255]` and `[0, 65535]` respectively.",
+        "Logical grayscale images use two bins for false and true values.",
+        "`imhist(X, map)` treats `X` as an indexed image and returns one bin per row of the Nx3 colormap.",
+        "Indexed images reject non-finite, non-integer, and out-of-range indices. Colormap values must be finite RGB values in `[0, 1]`.",
+        "Statement-form `imhist(...)` displays the histogram and returns no value. Builds without plotting support complete successfully without rendering."
+    ],
+    "examples": [
+        {
+            "description": "Count Intensities In A Byte Image",
+            "input": "I = uint8([0 1 1; 2 2 2]);\n[counts, bins] = imhist(I);\n[peak, idx] = max(counts);\n[bins(idx), peak]",
+            "output": "ans =\n     2     3"
+        },
+        {
+            "description": "Use Fewer Bins For A Normalized Image",
+            "input": "I = [0 0.25 0.5 1.0];\n[counts, bins] = imhist(I, 3);",
+            "output": "counts =\n     1\n     2\n     1"
+        },
+        {
+            "description": "Histogram An Indexed Image",
+            "input": "X = [1 2; 3 2];\nmap = [1 0 0; 0 1 0; 0 0 1];\n[counts, bins] = imhist(X, map);",
+            "output": "counts =\n     1\n     2\n     1"
+        },
+        {
+            "description": "Display A Histogram",
+            "input": "I = uint8([0 64 128; 128 192 255]);\nimhist(I);"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Why does `imhist` reject double values greater than 1?",
+            "answer": "MATLAB-style floating-point grayscale images are normalized image data. Use `uint8` or `uint16` when the values represent byte or word intensities."
+        },
+        {
+            "question": "How are indexed image offsets handled?",
+            "answer": "Double and single indexed images use one-based indices into the colormap. `uint8`, `uint16`, and logical indexed images use zero-based indices."
+        },
+        {
+            "question": "Does statement-form `imhist` always render a plot?",
+            "answer": "It renders when the plotting backend is available. Headless, no-plot, or non-main-thread contexts complete successfully without producing a value."
+        }
+    ],
+    "links": [
+        {
+            "label": "image",
+            "url": "./image"
+        },
+        {
+            "label": "imshow",
+            "url": "./imshow"
+        },
+        {
+            "label": "imread",
+            "url": "./imread"
+        },
+        {
+            "label": "histogram",
+            "url": "./histogram"
+        },
+        {
+            "label": "histcounts",
+            "url": "./histcounts"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/image/imhist.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/image/imhist.rs"
+    },
+    "gpu_residency": "`imhist` returns host-resident count and bin-location tensors because histogram assembly currently runs on the host.",
+    "gpu_behavior": [
+        "`imhist` gathers gpuArray inputs before validating image shape and class-specific ranges.",
+        "`imhist` terminates fusion chains because histogram counts depend on all image elements."
+    ],
+    "key": "imhist",
+    "slug": "imhist",
+    "aliases": [],
+    "categoryPath": [
+        "image"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=imhist.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"imhist.js","sourceRoot":"","sources":["../../../src/generated/builtins/imhist.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,QAAQ;IACjB,UAAU,EAAE,OAAO;IACnB,UAAU,EAAE;QACV,QAAQ;QACR,iBAAiB;QACjB,iBAAiB;QACjB,eAAe;QACf,UAAU;QACV,eAAe;KAChB;IACD,SAAS,EAAE,4DAA4D;IACvE,YAAY,EAAE,EAAE;IAChB,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,QAAQ;YACR,QAAQ;SACT;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,uIAAuI;KACjJ;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,gCAAgC;QACxC,aAAa,EAAE,+EAA+E;KAC/F;IACD,aAAa,EAAE,0JAA0J;IACzK,WAAW,EAAE;QACX,2EAA2E;QAC3E,gEAAgE;QAChE,gFAAgF;QAChF,kGAAkG;QAClG,kGAAkG;QAClG,kEAAkE;QAClE,kGAAkG;QAClG,iIAAiI;QACjI,oJAAoJ;KACrJ;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,mCAAmC;YAClD,OAAO,EAAE,wGAAwG;YACjH,QAAQ,EAAE,qBAAqB;SAChC;QACD;YACE,aAAa,EAAE,uCAAuC;YACtD,OAAO,EAAE,uDAAuD;YAChE,QAAQ,EAAE,kCAAkC;SAC7C;QACD;YACE,aAAa,EAAE,4BAA4B;YAC3C,OAAO,EAAE,iFAAiF;YAC1F,QAAQ,EAAE,kCAAkC;SAC7C;QACD;YACE,aAAa,EAAE,qBAAqB;YACpC,OAAO,EAAE,iDAAiD;SAC3D;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,wDAAwD;YACpE,QAAQ,EAAE,qJAAqJ;SAChK;QACD;YACE,UAAU,EAAE,wCAAwC;YACpD,QAAQ,EAAE,iJAAiJ;SAC5J;QACD;YACE,UAAU,EAAE,oDAAoD;YAChE,QAAQ,EAAE,oJAAoJ;SAC/J;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,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;QACD;YACE,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,cAAc;SACtB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,sDAAsD;QAC/D,KAAK,EAAE,mGAAmG;KAC3G;IACD,eAAe,EAAE,sHAAsH;IACvI,cAAc,EAAE;QACd,2FAA2F;QAC3F,0FAA0F;KAC3F;IACD,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;KACR;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/isstable.js

@@ -0,0 +1,96 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "isstable",
+    "category": "control",
+    "keywords": [
+        "isstable",
+        "stability",
+        "poles",
+        "control system",
+        "tf"
+    ],
+    "summary": "Test stability of SISO transfer-function models.",
+    "references": [
+        "title: \"MATLAB isstable documentation\""
+    ],
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "`isstable` analyzes host-side transfer-function metadata."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "inline",
+        "notes": "`isstable` is scalar model analysis and is not fused."
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::control::isstable::tests",
+        "integration": "crates/runmat-vm/tests/control.rs"
+    },
+    "description": "`isstable(sys)` returns true when all continuous-time poles are in the open left-half plane, or all discrete-time poles are inside the unit circle.",
+    "behaviors": [
+        "Supports SISO `tf` objects.",
+        "Continuous-time stability requires `real(pole) < 0`.",
+        "Discrete-time stability requires `abs(pole) < 1`.",
+        "Static-gain models are stable."
+    ],
+    "examples": [
+        {
+            "description": "Stable first-order model",
+            "input": "H = tf(1, [1 1]);\nisstable(H)",
+            "output": "ans = logical\n   1"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does marginal stability return true?",
+            "answer": "No. Poles on the imaginary axis or unit circle are not considered stable by this predicate."
+        }
+    ],
+    "links": [
+        {
+            "label": "pole",
+            "url": "./pole"
+        },
+        {
+            "label": "tf",
+            "url": "./tf"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/control/isstable.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/control/isstable.rs"
+    },
+    "syntax": {
+        "example": {
+            "description": "Supported form",
+            "input": "tf = isstable(sys)",
+            "output": "tf is a logical scalar."
+        },
+        "points": [
+            "`sys` must be a SISO `tf` object."
+        ]
+    },
+    "validation": {
+        "summary": "`isstable` validates the input model, computes poles, and applies continuous or discrete stability rules. Tests cover stable continuous-time models and VM integration.",
+        "implementation": {
+            "label": "`crates/runmat-runtime/src/builtins/control/isstable.rs`",
+            "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/control/isstable.rs"
+        }
+    },
+    "gpu_residency": "`isstable` returns a host logical scalar.",
+    "key": "isstable",
+    "slug": "isstable",
+    "aliases": [],
+    "categoryPath": [
+        "control"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=isstable.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"isstable.js","sourceRoot":"","sources":["../../../src/generated/builtins/isstable.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,UAAU;IACnB,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE;QACV,UAAU;QACV,WAAW;QACX,OAAO;QACP,gBAAgB;QAChB,IAAI;KACL;IACD,SAAS,EAAE,kDAAkD;IAC7D,YAAY,EAAE;QACZ,0CAA0C;KAC3C;IACD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,2DAA2D;KACrE;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;QACrB,OAAO,EAAE,uDAAuD;KACjE;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,oCAAoC;QAC5C,aAAa,EAAE,mCAAmC;KACnD;IACD,aAAa,EAAE,qJAAqJ;IACpK,WAAW,EAAE;QACX,6BAA6B;QAC7B,sDAAsD;QACtD,mDAAmD;QACnD,gCAAgC;KACjC;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,0BAA0B;YACzC,OAAO,EAAE,gCAAgC;YACzC,QAAQ,EAAE,qBAAqB;SAChC;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,sCAAsC;YAClD,QAAQ,EAAE,6FAA6F;SACxG;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,MAAM;SACd;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,0DAA0D;QACnE,KAAK,EAAE,uGAAuG;KAC/G;IACD,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,aAAa,EAAE,gBAAgB;YAC/B,OAAO,EAAE,oBAAoB;YAC7B,QAAQ,EAAE,yBAAyB;SACpC;QACD,QAAQ,EAAE;YACR,mCAAmC;SACpC;KACF;IACD,YAAY,EAAE;QACZ,SAAS,EAAE,yKAAyK;QACpL,gBAAgB,EAAE;YAChB,OAAO,EAAE,0DAA0D;YACnE,KAAK,EAAE,uGAAuG;SAC/G;KACF;IACD,eAAe,EAAE,2CAA2C;IAC5D,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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