runmat 0.5.2-dev.4 → 0.5.2-dev.6

package/dist/generated/builtins/pole.js

@@ -0,0 +1,96 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "pole",
+    "category": "control",
+    "keywords": [
+        "pole",
+        "poles",
+        "stability",
+        "control system",
+        "tf"
+    ],
+    "summary": "Return poles of SISO transfer-function models.",
+    "references": [
+        "title: \"MATLAB pole documentation\""
+    ],
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "`pole` computes roots from host-side denominator metadata."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "inline",
+        "notes": "`pole` is model analysis and is not fused."
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::control::pole::tests",
+        "integration": "crates/runmat-vm/tests/control.rs"
+    },
+    "description": "`pole(sys)` returns the roots of the denominator polynomial for a supported SISO `tf` model.",
+    "behaviors": [
+        "Supports SISO `tf` objects.",
+        "Returns an `N x 1` real vector when all poles are real.",
+        "Returns an `N x 1` complex vector when any pole has a nonzero imaginary part.",
+        "Static-gain models return an empty pole vector."
+    ],
+    "examples": [
+        {
+            "description": "Second-order poles",
+            "input": "H = tf(1, [1 3 2]);\npole(H)",
+            "output": "ans = [-1; -2]"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does `pole` cancel pole-zero pairs?",
+            "answer": "No. It returns roots of the stored denominator polynomial for the supplied model."
+        }
+    ],
+    "links": [
+        {
+            "label": "roots",
+            "url": "./roots"
+        },
+        {
+            "label": "isstable",
+            "url": "./isstable"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/control/pole.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/control/pole.rs"
+    },
+    "syntax": {
+        "example": {
+            "description": "Supported form",
+            "input": "p = pole(sys)",
+            "output": "p is a column vector."
+        },
+        "points": [
+            "`sys` must be a SISO `tf` object."
+        ]
+    },
+    "validation": {
+        "summary": "`pole` validates the input model and computes denominator roots through the shared control polynomial root path. Tests cover real poles and VM integration.",
+        "implementation": {
+            "label": "`crates/runmat-runtime/src/builtins/control/pole.rs`",
+            "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/control/pole.rs"
+        }
+    },
+    "gpu_residency": "`pole` returns host-resident vectors.",
+    "key": "pole",
+    "slug": "pole",
+    "aliases": [],
+    "categoryPath": [
+        "control"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=pole.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pole.js","sourceRoot":"","sources":["../../../src/generated/builtins/pole.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,MAAM;IACf,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE;QACV,MAAM;QACN,OAAO;QACP,WAAW;QACX,gBAAgB;QAChB,IAAI;KACL;IACD,SAAS,EAAE,gDAAgD;IAC3D,YAAY,EAAE;QACZ,sCAAsC;KACvC;IACD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,4DAA4D;KACtE;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;QACrB,OAAO,EAAE,4CAA4C;KACtD;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,gCAAgC;QACxC,aAAa,EAAE,mCAAmC;KACnD;IACD,aAAa,EAAE,8FAA8F;IAC7G,WAAW,EAAE;QACX,6BAA6B;QAC7B,yDAAyD;QACzD,+EAA+E;QAC/E,iDAAiD;KAClD;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,oBAAoB;YACnC,OAAO,EAAE,8BAA8B;YACvC,QAAQ,EAAE,gBAAgB;SAC3B;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,qCAAqC;YACjD,QAAQ,EAAE,mFAAmF;SAC9F;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,sDAAsD;QAC/D,KAAK,EAAE,mGAAmG;KAC3G;IACD,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,aAAa,EAAE,gBAAgB;YAC/B,OAAO,EAAE,eAAe;YACxB,QAAQ,EAAE,uBAAuB;SAClC;QACD,QAAQ,EAAE;YACR,mCAAmC;SACpC;KACF;IACD,YAAY,EAAE;QACZ,SAAS,EAAE,6JAA6J;QACxK,gBAAgB,EAAE;YAChB,OAAO,EAAE,sDAAsD;YAC/D,KAAK,EAAE,mGAAmG;SAC3G;KACF;IACD,eAAe,EAAE,uCAAuC;IACxD,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IACd,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"rref.d.ts","sourceRoot":"","sources":["../../../src/generated/builtins/rref.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,QAAA,MAAM,UAAU,EAAE,UAgIjB,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"rref.d.ts","sourceRoot":"","sources":["../../../src/generated/builtins/rref.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/rref.js

@@ -6,12 +6,11 @@ const builtinDoc = {
     "keywords": [
         "rref",
         "reduced row echelon form",
+        "row reduction",
         "pivot columns",
-        "Gaussian elimination",
-        "tolerance",
-        "gpu"
+        "rank"
     ],
-    "summary": "Compute reduced row echelon form and MATLAB-style pivot column indices.",
+    "summary": "Compute reduced row echelon form and pivot columns.",
     "references": [],
     "gpu_support": {
         "elementwise": false,
@@ -21,73 +20,57 @@ const builtinDoc = {
             "f64"
         ],
         "broadcasting": "none",
-        "notes": "Invokes the acceleration provider's rref hook when available; the current WGPU backend gathers to the host, runs the shared elimination implementation, and re-uploads R and pivcol to keep downstream residency intact."
+        "notes": "GPU inputs are gathered to the shared host row-reduction implementation. Real reduced matrices are re-uploaded when a provider is available; upload failures surface as `RunMat:rref:Internal`."
     },
     "fusion": {
         "elementwise": false,
         "reduction": false,
-        "max_inputs": 1,
+        "max_inputs": 2,
         "constants": "inline"
     },
     "requires_feature": null,
     "tested": {
         "unit": "builtins::math::linalg::solve::rref::tests",
-        "gpu": "builtins::math::linalg::solve::rref::tests::rref_gpu_provider_round_trip",
-        "wgpu": "builtins::math::linalg::solve::rref::tests::rref_wgpu_matches_cpu"
+        "integration": "bytecode::compile::tests::compile_interprets_rref_rank_workflow"
     },
-    "description": "`rref(A)` returns the reduced row echelon form of matrix `A`. `[R, pivcol] = rref(A)` also returns the 1-based pivot column indices as a row vector.",
+    "description": "`rref(A)` returns the reduced row echelon form of a real or complex numeric matrix. `[R, pivots] = rref(A)` also returns the one-based pivot column indices. An optional tolerance controls which entries are considered zero during pivot selection.",
     "behaviors": [
-        "Supports real numeric, logical, integer, scalar, vector, matrix, and complex matrix inputs. Logical and integer inputs are promoted to double precision before elimination.",
-        "The optional second argument `rref(A, tol)` overrides the pivot tolerance. Tolerance must be a finite, non-negative real scalar.",
-        "When tolerance is omitted, RunMat uses MATLAB-compatible scaling: `max(size(A)) * eps(norm(A, inf))`.",
-        "Pivot search proceeds left to right and chooses the largest-magnitude entry in the remaining rows of the active column.",
-        "Pivot column indices in `pivcol` are MATLAB-style 1-based double values. If no pivots are found, `pivcol` has shape `1 x 0`.",
-        "Empty matrices and all-zero matrices return unchanged matrix-shaped output with no pivot columns.",
-        "Complex inputs use complex division and magnitudes during pivot selection and elimination."
+        "Inputs must behave like 2-D matrices. Trailing singleton dimensions are accepted; other higher-rank inputs raise `RunMat:rref:InvalidInput`.",
+        "The default tolerance is `max(size(A)) * eps(norm(A, inf))`, matching MATLAB row-reduction conventions.",
+        "`rref(A, tol)` uses a caller-provided finite, non-negative scalar pivot tolerance.",
+        "Logical and integer inputs are promoted to double precision before row reduction.",
+        "Complex inputs use complex Gauss-Jordan elimination with pivot selection by complex magnitude.",
+        "The second output is a row vector of one-based pivot column indices.",
+        "Non-finite values are accepted. The default tolerance still follows `max(size(A)) * eps(norm(A, inf))`; `Inf` and `NaN` therefore follow the runtime's IEEE floating-point tolerance and pivot arithmetic."
     ],
     "examples": [
         {
-            "description": "Computing reduced row echelon form",
-            "input": "A = [1 2; 3 4];\nR = rref(A)",
-            "output": "R =\n     1     0\n     0     1"
+            "description": "Finding dependent columns",
+            "input": "A = [1 2 3; 2 4 6; 1 1 1];\n[R, pivots] = rref(A)",
+            "output": "R = [1 0 -1; 0 1 2; 0 0 0]\npivots = [1 2]"
         },
         {
-            "description": "Returning pivot columns",
-            "input": "A = [1 2; 2 4];\n[R, pivcol] = rref(A)",
-            "output": "R =\n     1     2\n     0     0\npivcol =\n     1"
+            "description": "Using a custom tolerance",
+            "input": "A = diag([1, 1e-12]);\nR = rref(A, 1e-6)",
+            "output": "R = [1 0; 0 0]"
         },
         {
-            "description": "Applying an explicit tolerance",
-            "input": "A = diag([1, 1e-10]);\n[R, pivcol] = rref(A, 1e-9)",
-            "output": "R =\n     1     0\n     0     0\npivcol =\n     1"
-        },
-        {
-            "description": "Reducing a row vector",
-            "input": "v = [2 4 6];\nR = rref(v)",
-            "output": "R =\n     1     2     3"
-        },
-        {
-            "description": "Using rref with gpuArray data",
-            "input": "G = gpuArray([1 2; 3 4]);\n[R, pivcol] = rref(G);\nR_host = gather(R)\npiv_host = gather(pivcol)",
-            "output": "R_host =\n     1     0\n     0     1\npiv_host =\n     1     2"
+            "description": "Row-reducing an augmented system",
+            "input": "A = [2 -1 3; 4 -2 6; 1 0 1];\nb = [5; 10; 2];\nRAug = rref([A b])"
         }
     ],
     "faqs": [
         {
-            "question": "How is the default tolerance chosen?",
-            "answer": "RunMat follows MATLAB's dense-matrix rule: `max(size(A)) * eps(norm(A, inf))`. Larger or more highly scaled matrices therefore receive a larger pivot cutoff."
+            "question": "How does `rref` choose pivots?",
+            "answer": "RunMat scans columns left to right, picks the largest available pivot by magnitude below the current pivot row, normalizes the pivot row, and eliminates the pivot column above and below the pivot."
         },
         {
-            "question": "What shape is `pivcol`?",
-            "answer": "`pivcol` is always a row vector of 1-based double indices. No pivots returns an empty row vector with shape `1 x 0`."
+            "question": "Is the pivot vector one-based?",
+            "answer": "Yes. The second output uses MATLAB's one-based column indices."
         },
         {
-            "question": "Does `rref` support complex matrices?",
-            "answer": "Yes. Complex values use magnitude-based pivoting and complex arithmetic for row normalization and elimination."
-        },
-        {
-            "question": "Will calling `rref` move GPU data back to the CPU?",
-            "answer": "Only when the active provider lacks a native implementation. The current WGPU backend gathers, computes on the host, and re-uploads both outputs so later GPU work can continue with resident tensors."
+            "question": "Does `rref` use the same tolerance as `rank`?",
+            "answer": "No. `rank` uses an SVD tolerance. `rref` uses the MATLAB row-reduction tolerance based on the matrix infinity norm."
         }
     ],
     "links": [
@@ -100,25 +83,21 @@ const builtinDoc = {
             "url": "./pinv"
         },
         {
-            "label": "lu",
-            "url": "./lu"
-        },
-        {
-            "label": "qr",
-            "url": "./qr"
+            "label": "linsolve",
+            "url": "./linsolve"
         },
         {
-            "label": "gather",
-            "url": "./gather"
+            "label": "mldivide",
+            "url": "./mldivide"
         }
     ],
     "source": {
-        "label": "crates/runmat-runtime/src/builtins/math/linalg/solve/rref.rs",
-        "url": "crates/runmat-runtime/src/builtins/math/linalg/solve/rref.rs"
+        "label": "`crates/runmat-runtime/src/builtins/math/linalg/solve/rref.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/math/linalg/solve/rref.rs"
     },
-    "gpu_residency": "RunMat first offers `rref` to the active acceleration provider through the `rref` hook. Providers without a native implementation gather the input, run the shared host RREF algorithm, and upload both `R` and `pivcol` so downstream GPU kernels can continue without an explicit user-managed transfer.",
+    "gpu_residency": "When the input is a real gpuArray, RunMat gathers it, computes the row-reduced matrix on the host, and re-uploads the reduced matrix if a provider is available. If that re-upload fails, the builtin raises `RunMat:rref:Internal` rather than silently changing residency. Pivot-column metadata is returned as a host vector.",
     "gpu_behavior": [
-        "The current WGPU backend implements `rref` as a provider hook backed by host fallback and re-upload. The builtin is not fused into elementwise kernels; producers flush before `rref` runs, and both outputs are new resident GPU handles when the provider path is active."
+        "`rref` is an eager solve-style operation. It terminates fusion plans, gathers GPU-resident inputs for numerical row reduction, and returns ordinary MATLAB-compatible values."
     ],
     "key": "rref",
     "slug": "rref",

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

@@ -1 +1 @@
-{"version":3,"file":"rref.js","sourceRoot":"","sources":["../../../src/generated/builtins/rref.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,MAAM;IACf,UAAU,EAAE,mBAAmB;IAC/B,UAAU,EAAE;QACV,MAAM;QACN,0BAA0B;QAC1B,eAAe;QACf,sBAAsB;QACtB,WAAW;QACX,KAAK;KACN;IACD,SAAS,EAAE,yEAAyE;IACpF,YAAY,EAAE,EAAE;IAChB,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;YACL,KAAK;SACN;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,0NAA0N;KACpO;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,KAAK,EAAE,0EAA0E;QACjF,MAAM,EAAE,mEAAmE;KAC5E;IACD,aAAa,EAAE,sJAAsJ;IACrK,WAAW,EAAE;QACX,6KAA6K;QAC7K,kIAAkI;QAClI,uGAAuG;QACvG,yHAAyH;QACzH,8HAA8H;QAC9H,mGAAmG;QACnG,4FAA4F;KAC7F;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,oCAAoC;YACnD,OAAO,EAAE,8BAA8B;YACvC,QAAQ,EAAE,iCAAiC;SAC5C;QACD;YACE,aAAa,EAAE,yBAAyB;YACxC,OAAO,EAAE,wCAAwC;YACjD,QAAQ,EAAE,mDAAmD;SAC9D;QACD;YACE,aAAa,EAAE,gCAAgC;YAC/C,OAAO,EAAE,oDAAoD;YAC7D,QAAQ,EAAE,mDAAmD;SAC9D;QACD;YACE,aAAa,EAAE,uBAAuB;YACtC,OAAO,EAAE,2BAA2B;YACpC,QAAQ,EAAE,yBAAyB;SACpC;QACD;YACE,aAAa,EAAE,+BAA+B;YAC9C,OAAO,EAAE,kGAAkG;YAC3G,QAAQ,EAAE,gEAAgE;SAC3E;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,sCAAsC;YAClD,QAAQ,EAAE,+JAA+J;SAC1K;QACD;YACE,UAAU,EAAE,yBAAyB;YACrC,QAAQ,EAAE,sHAAsH;SACjI;QACD;YACE,UAAU,EAAE,uCAAuC;YACnD,QAAQ,EAAE,gHAAgH;SAC3H;QACD;YACE,UAAU,EAAE,oDAAoD;YAChE,QAAQ,EAAE,wMAAwM;SACnN;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,MAAM;SACd;QACD;YACE,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,MAAM;SACd;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,8DAA8D;QACvE,KAAK,EAAE,8DAA8D;KACtE;IACD,eAAe,EAAE,4SAA4S;IAC7T,cAAc,EAAE;QACd,6QAA6Q;KAC9Q;IACD,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IACd,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,QAAQ;QACR,OAAO;KACR;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"rref.js","sourceRoot":"","sources":["../../../src/generated/builtins/rref.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,MAAM;IACf,UAAU,EAAE,mBAAmB;IAC/B,UAAU,EAAE;QACV,MAAM;QACN,0BAA0B;QAC1B,eAAe;QACf,eAAe;QACf,MAAM;KACP;IACD,SAAS,EAAE,qDAAqD;IAChE,YAAY,EAAE,EAAE;IAChB,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;YACL,KAAK;SACN;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,iMAAiM;KAC3M;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,iEAAiE;KACjF;IACD,aAAa,EAAE,uPAAuP;IACtQ,WAAW,EAAE;QACX,8IAA8I;QAC9I,yGAAyG;QACzG,oFAAoF;QACpF,mFAAmF;QACnF,gGAAgG;QAChG,sEAAsE;QACtE,4MAA4M;KAC7M;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,2BAA2B;YAC1C,OAAO,EAAE,mDAAmD;YAC5D,QAAQ,EAAE,4CAA4C;SACvD;QACD;YACE,aAAa,EAAE,0BAA0B;YACzC,OAAO,EAAE,0CAA0C;YACnD,QAAQ,EAAE,gBAAgB;SAC3B;QACD;YACE,aAAa,EAAE,kCAAkC;YACjD,OAAO,EAAE,mEAAmE;SAC7E;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,gCAAgC;YAC5C,QAAQ,EAAE,sMAAsM;SACjN;QACD;YACE,UAAU,EAAE,gCAAgC;YAC5C,QAAQ,EAAE,gEAAgE;SAC3E;QACD;YACE,UAAU,EAAE,+CAA+C;YAC3D,QAAQ,EAAE,qHAAqH;SAChI;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,gEAAgE;QACzE,KAAK,EAAE,6GAA6G;KACrH;IACD,eAAe,EAAE,kUAAkU;IACnV,cAAc,EAAE;QACd,+KAA+K;KAChL;IACD,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IACd,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,QAAQ;QACR,OAAO;KACR;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/run.js

@@ -0,0 +1,118 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "run",
+    "category": "io/repl_fs",
+    "keywords": [
+        "run",
+        "script",
+        "matlab script",
+        "workspace",
+        "path"
+    ],
+    "summary": "Execute a MATLAB script file in the caller workspace.",
+    "references": [],
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "Script resolution and execution run on the host. gpuArray text inputs are gathered before lookup."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 1,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::io::repl_fs::run::tests",
+        "integration": [
+            "run_executes_script_file_in_current_workspace",
+            "run_exposes_script_variables_to_following_call_syntax",
+            "run_script_variables_shadow_builtin_constants",
+            "run_replays_script_stdout_to_request_streams",
+            "run_command_syntax_resolves_scripts_on_search_path",
+            "run_preserves_script_source_context",
+            "run_missing_file_and_output_errors_are_catchable"
+        ]
+    },
+    "description": "`run` locates a `.m` script by file name, relative path, absolute path, or active MATLAB search path entry, then executes that script in the caller workspace. Variables assigned by the script are visible to following statements in the caller.",
+    "behaviors": [
+        "`run('script')` resolves `script.m` when no extension is supplied. Bare `.m` filenames also search the active MATLAB path. `run('folder/script.m')` executes the file at that path.",
+        "Command syntax is supported: `run script_name` is equivalent to `run('script_name')`.",
+        "The target file is executed as a script, not as a function. Assignments mutate the caller workspace and local functions in the script remain available to that script.",
+        "`mfilename` inside the executed script reports the executed file name and full path, matching the script source context.",
+        "`run` has no outputs. Requesting an output raises `RunMat:run:TooManyOutputs` before executing the file.",
+        "If the script throws an error, the error is catchable by the caller and assignments performed before that error remain in the caller workspace.",
+        "Names that may be introduced by a script are tracked as dynamic workspace bindings. Bare reads of names the script did not assign raise `RunMat:UndefinedVariable` at runtime unless the name is a builtin constant; call syntax such as `name(...)` checks the caller workspace first, then falls back to normal function or builtin resolution."
+    ],
+    "examples": [
+        {
+            "description": "Execute a script in the current folder",
+            "input": "run('setup_experiment');\nresult = configured_gain * 2;"
+        },
+        {
+            "description": "Execute a script found on the search path",
+            "input": "addpath('examples');\nrun fm_demo\nplot(t, demodulated)"
+        },
+        {
+            "description": "Catch script execution errors",
+            "input": "try\n    run('maybe_missing_script');\ncatch e\n    disp(e.identifier)\nend"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does `run` call functions?",
+            "answer": "No. `run` executes script files. Function files should be called by their function name."
+        },
+        {
+            "question": "Can `run` return a value?",
+            "answer": "No. MATLAB's `run` executes for side effects in the caller workspace and does not return outputs."
+        },
+        {
+            "question": "Where does `run` search?",
+            "answer": "RunMat first resolves the provided file or relative path, then searches the active MATLAB path. It appends `.m` when the supplied name has no extension, and a bare filename that already ends in `.m` is also searched on the active path."
+        },
+        {
+            "question": "What happens if the script creates variables?",
+            "answer": "Assignments made by the script are visible in the caller workspace after `run`. Subsequent call syntax uses MATLAB variable precedence, so a script-created array can be indexed with `x(...)` and can shadow a builtin name."
+        },
+        {
+            "question": "What happens if the script fails?",
+            "answer": "The error propagates to the caller and can be caught with `try`/`catch`. Assignments made before the error remain visible in the caller workspace, matching script execution semantics."
+        }
+    ],
+    "links": [
+        {
+            "label": "addpath",
+            "url": "./addpath"
+        },
+        {
+            "label": "path",
+            "url": "./path"
+        },
+        {
+            "label": "which",
+            "url": "./which"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/io/repl_fs/run.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/io/repl_fs/run.rs"
+    },
+    "gpu_residency": "No manual action is required. `run` always executes on the host. Any GPU-resident text argument is gathered before path resolution.",
+    "gpu_behavior": [
+        "`run` is a host-side script execution boundary. It does not create GPU kernels or participate in fusion. Values created by the executed script can still be promoted by downstream acceleration heuristics."
+    ],
+    "key": "run",
+    "slug": "run",
+    "aliases": [],
+    "categoryPath": [
+        "io",
+        "repl_fs"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=run.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../src/generated/builtins/run.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,KAAK;IACd,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE;QACV,KAAK;QACL,QAAQ;QACR,eAAe;QACf,WAAW;QACX,MAAM;KACP;IACD,SAAS,EAAE,uDAAuD;IAClE,YAAY,EAAE,EAAE;IAChB,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,mGAAmG;KAC7G;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;KACtB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,mCAAmC;QAC3C,aAAa,EAAE;YACb,+CAA+C;YAC/C,uDAAuD;YACvD,+CAA+C;YAC/C,8CAA8C;YAC9C,oDAAoD;YACpD,qCAAqC;YACrC,kDAAkD;SACnD;KACF;IACD,aAAa,EAAE,oPAAoP;IACnQ,WAAW,EAAE;QACX,qLAAqL;QACrL,uFAAuF;QACvF,wKAAwK;QACxK,0HAA0H;QAC1H,0GAA0G;QAC1G,iJAAiJ;QACjJ,mVAAmV;KACpV;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,wCAAwC;YACvD,OAAO,EAAE,yDAAyD;SACnE;QACD;YACE,aAAa,EAAE,2CAA2C;YAC1D,OAAO,EAAE,yDAAyD;SACnE;QACD;YACE,aAAa,EAAE,+BAA+B;YAC9C,OAAO,EAAE,6EAA6E;SACvF;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,4BAA4B;YACxC,QAAQ,EAAE,0FAA0F;SACrG;QACD;YACE,UAAU,EAAE,2BAA2B;YACvC,QAAQ,EAAE,mGAAmG;SAC9G;QACD;YACE,UAAU,EAAE,0BAA0B;YACtC,QAAQ,EAAE,6OAA6O;SACxP;QACD;YACE,UAAU,EAAE,+CAA+C;YAC3D,QAAQ,EAAE,+NAA+N;SAC1O;QACD;YACE,UAAU,EAAE,mCAAmC;YAC/C,QAAQ,EAAE,yLAAyL;SACpM;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,wDAAwD;QACjE,KAAK,EAAE,qGAAqG;KAC7G;IACD,eAAe,EAAE,qIAAqI;IACtJ,cAAc,EAAE;QACd,6MAA6M;KAC9M;IACD,KAAK,EAAE,KAAK;IACZ,MAAM,EAAE,KAAK;IACb,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,IAAI;QACJ,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/step.js

@@ -39,6 +39,7 @@ const builtinDoc = {
         "Returns the response `y` as a column vector for single-output calls.",
         "Returns `[y, tOut]` for two-output calls.",
         "Plots the response for no-output calls.",
+        "No-output calls accept common multi-system plot syntax such as `step(sys1, 'b', sys2, 'r--', tFinal)`; style tokens are accepted for compatibility.",
         "Chooses an automatic time vector when no time input is supplied.",
         "Accepts a positive finite scalar final time.",
         "Accepts a finite, nonnegative, nondecreasing explicit time vector.",
@@ -64,6 +65,11 @@ const builtinDoc = {
             "description": "Plotting the step response",
             "input": "sys = tf(1, [1 1]);\nstep(sys);",
             "output": "A step-response plot is rendered."
+        },
+        {
+            "description": "Plotting multiple systems",
+            "input": "s = tf('s');\nH1 = 1/(s + 1);\nH2 = 2/(s + 2);\nstep(H1, 'b', H2, 'r--', 5);",
+            "output": "Both responses are plotted over the same final time."
         }
     ],
     "faqs": [
@@ -88,6 +94,10 @@ const builtinDoc = {
         {
             "label": "plot",
             "url": "./plot"
+        },
+        {
+            "label": "stepinfo",
+            "url": "./stepinfo"
         }
     ],
     "source": {
@@ -97,17 +107,18 @@ const builtinDoc = {
     "syntax": {
         "example": {
             "description": "Supported forms",
-            "input": "step(sys)\ny = step(sys)\n[y, tOut] = step(sys)\n[y, tOut] = step(sys, tFinal)\n[y, tOut] = step(sys, t)",
+            "input": "step(sys)\nstep(sys1, style1, sys2, style2, tFinal)\ny = step(sys)\n[y, tOut] = step(sys)\n[y, tOut] = step(sys, tFinal)\n[y, tOut] = step(sys, t)",
             "output": "Response data is returned when outputs are requested; otherwise a plot is rendered."
         },
         "points": [
             "`sys` must be a SISO `tf` object.",
             "`tFinal` is a positive finite scalar final time.",
-            "`t` is a finite, nonnegative, nondecreasing numeric time vector."
+            "`t` is a finite, nonnegative, nondecreasing numeric time vector.",
+            "Multiple-system style arguments are supported only for no-output plotting calls."
         ]
     },
     "validation": {
-        "summary": "`step` validates object class, coefficient type, properness, sample time, and time-vector inputs before simulation. Unit and integration tests cover first-order response values, scalar final time, explicit vectors, discrete sample-time behavior, multi-output ordering, and VM dispatch.",
+        "summary": "`step` validates object class, coefficient type, properness, sample time, and time-vector inputs before simulation. Unit and integration tests cover first-order response values, scalar final time, explicit vectors, discrete sample-time behavior, multi-output ordering, multi-system statement-form plotting syntax, and VM dispatch.",
         "implementation": {
             "label": "`crates/runmat-runtime/src/builtins/control/step.rs`",
             "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/control/step.rs"

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

@@ -1 +1 @@
-{"version":3,"file":"step.js","sourceRoot":"","sources":["../../../src/generated/builtins/step.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,MAAM;IACf,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE;QACV,MAAM;QACN,eAAe;QACf,gBAAgB;QAChB,mBAAmB;QACnB,IAAI;KACL;IACD,SAAS,EAAE,sGAAsG;IACjH,YAAY,EAAE;QACZ,sCAAsC;KACvC;IACD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,0HAA0H;KACpI;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;QACrB,OAAO,EAAE,2EAA2E;KACrF;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,gCAAgC;QACxC,aAAa,EAAE,mCAAmC;KACnD;IACD,aAAa,EAAE,uKAAuK;IACtL,WAAW,EAAE;QACX,oDAAoD;QACpD,sEAAsE;QACtE,2CAA2C;QAC3C,yCAAyC;QACzC,kEAAkE;QAClE,8CAA8C;QAC9C,oEAAoE;QACpE,uDAAuD;KACxD;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,kDAAkD;YACjE,OAAO,EAAE,0CAA0C;YACnD,QAAQ,EAAE,6BAA6B;SACxC;QACD;YACE,aAAa,EAAE,2BAA2B;YAC1C,OAAO,EAAE,6CAA6C;YACtD,QAAQ,EAAE,YAAY;SACvB;QACD;YACE,aAAa,EAAE,+BAA+B;YAC9C,OAAO,EAAE,sDAAsD;YAC/D,QAAQ,EAAE,kCAAkC;SAC7C;QACD;YACE,aAAa,EAAE,4BAA4B;YAC3C,OAAO,EAAE,iCAAiC;YAC1C,QAAQ,EAAE,mCAAmC;SAC9C;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,kCAAkC;YAC9C,QAAQ,EAAE,0EAA0E;SACrF;QACD;YACE,UAAU,EAAE,yCAAyC;YACrD,QAAQ,EAAE,0FAA0F;SACrG;QACD;YACE,UAAU,EAAE,gDAAgD;YAC5D,QAAQ,EAAE,gGAAgG;SAC3G;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,MAAM;SACd;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,sDAAsD;QAC/D,KAAK,EAAE,mGAAmG;KAC3G;IACD,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,aAAa,EAAE,iBAAiB;YAChC,OAAO,EAAE,0GAA0G;YACnH,QAAQ,EAAE,qFAAqF;SAChG;QACD,QAAQ,EAAE;YACR,mCAAmC;YACnC,kDAAkD;YAClD,kEAAkE;SACnE;KACF;IACD,YAAY,EAAE;QACZ,SAAS,EAAE,+RAA+R;QAC1S,gBAAgB,EAAE;YAChB,OAAO,EAAE,sDAAsD;YAC/D,KAAK,EAAE,mGAAmG;SAC3G;KACF;IACD,eAAe,EAAE,0EAA0E;IAC3F,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IACd,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"step.js","sourceRoot":"","sources":["../../../src/generated/builtins/step.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,MAAM;IACf,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE;QACV,MAAM;QACN,eAAe;QACf,gBAAgB;QAChB,mBAAmB;QACnB,IAAI;KACL;IACD,SAAS,EAAE,sGAAsG;IACjH,YAAY,EAAE;QACZ,sCAAsC;KACvC;IACD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,0HAA0H;KACpI;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;QACrB,OAAO,EAAE,2EAA2E;KACrF;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,gCAAgC;QACxC,aAAa,EAAE,mCAAmC;KACnD;IACD,aAAa,EAAE,uKAAuK;IACtL,WAAW,EAAE;QACX,oDAAoD;QACpD,sEAAsE;QACtE,2CAA2C;QAC3C,yCAAyC;QACzC,qJAAqJ;QACrJ,kEAAkE;QAClE,8CAA8C;QAC9C,oEAAoE;QACpE,uDAAuD;KACxD;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,kDAAkD;YACjE,OAAO,EAAE,0CAA0C;YACnD,QAAQ,EAAE,6BAA6B;SACxC;QACD;YACE,aAAa,EAAE,2BAA2B;YAC1C,OAAO,EAAE,6CAA6C;YACtD,QAAQ,EAAE,YAAY;SACvB;QACD;YACE,aAAa,EAAE,+BAA+B;YAC9C,OAAO,EAAE,sDAAsD;YAC/D,QAAQ,EAAE,kCAAkC;SAC7C;QACD;YACE,aAAa,EAAE,4BAA4B;YAC3C,OAAO,EAAE,iCAAiC;YAC1C,QAAQ,EAAE,mCAAmC;SAC9C;QACD;YACE,aAAa,EAAE,2BAA2B;YAC1C,OAAO,EAAE,8EAA8E;YACvF,QAAQ,EAAE,sDAAsD;SACjE;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,kCAAkC;YAC9C,QAAQ,EAAE,0EAA0E;SACrF;QACD;YACE,UAAU,EAAE,yCAAyC;YACrD,QAAQ,EAAE,0FAA0F;SACrG;QACD;YACE,UAAU,EAAE,gDAAgD;YAC5D,QAAQ,EAAE,gGAAgG;SAC3G;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,sDAAsD;QAC/D,KAAK,EAAE,mGAAmG;KAC3G;IACD,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,aAAa,EAAE,iBAAiB;YAChC,OAAO,EAAE,oJAAoJ;YAC7J,QAAQ,EAAE,qFAAqF;SAChG;QACD,QAAQ,EAAE;YACR,mCAAmC;YACnC,kDAAkD;YAClD,kEAAkE;YAClE,kFAAkF;SACnF;KACF;IACD,YAAY,EAAE;QACZ,SAAS,EAAE,4UAA4U;QACvV,gBAAgB,EAAE;YAChB,OAAO,EAAE,sDAAsD;YAC/D,KAAK,EAAE,mGAAmG;SAC3G;KACF;IACD,eAAe,EAAE,0EAA0E;IAC3F,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IACd,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/stepinfo.js

@@ -0,0 +1,111 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "stepinfo",
+    "category": "control",
+    "keywords": [
+        "stepinfo",
+        "step response",
+        "rise time",
+        "settling time",
+        "overshoot",
+        "control system"
+    ],
+    "summary": "Compute step-response metrics from SISO models or sampled responses.",
+    "references": [
+        "title: \"MATLAB stepinfo documentation\""
+    ],
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "`stepinfo` gathers sampled data and computes metrics on the host."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "inline",
+        "notes": "`stepinfo` returns a metrics struct and is not fused."
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::control::stepinfo::tests",
+        "integration": "crates/runmat-vm/tests/control.rs"
+    },
+    "description": "`stepinfo(sys)` simulates the step response for a supported SISO `tf` model and returns response metrics. `stepinfo(y, t, yfinal)` computes metrics from sampled response data.",
+    "behaviors": [
+        "Supports `stepinfo(sys)` for SISO `tf` models supported by `step`.",
+        "Supports sampled forms `stepinfo(y)`, `stepinfo(y, t)`, and `stepinfo(y, t, yfinal)`.",
+        "Returns a struct with `RiseTime`, `TransientTime`, `SettlingTime`, `SettlingMin`, `SettlingMax`, `Overshoot`, `Undershoot`, `Peak`, `PeakTime`, and `SteadyStateValue`.",
+        "Uses a default settling-time threshold of 2%.",
+        "Accepts the name-value option `'SettlingTimeThreshold'` with a scalar value between 0 and 1.",
+        "Rise-time crossings are linearly interpolated between adjacent samples."
+    ],
+    "examples": [
+        {
+            "description": "Metrics from a transfer function",
+            "input": "s = tf('s');\nT = feedback(2/(s + 1), 1);\ninfo = stepinfo(T);\ninfo.Overshoot",
+            "output": "ans = 0"
+        },
+        {
+            "description": "Metrics from sampled data",
+            "input": "t = 0:0.1:5;\ny = 1 - exp(-t);\ninfo = stepinfo(y, t, 1);\ninfo.SteadyStateValue",
+            "output": "ans = 1"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does `stepinfo` require a transfer-function model?",
+            "answer": "No. It can also operate on sampled response vectors."
+        },
+        {
+            "question": "Are the metrics exact analytical values?",
+            "answer": "For model inputs, metrics are computed from the sampled `step` response. Crossings are linearly interpolated from those samples."
+        }
+    ],
+    "links": [
+        {
+            "label": "step",
+            "url": "./step"
+        },
+        {
+            "label": "dcgain",
+            "url": "./dcgain"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/control/stepinfo.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/control/stepinfo.rs"
+    },
+    "syntax": {
+        "example": {
+            "description": "Supported forms",
+            "input": "info = stepinfo(sys)\ninfo = stepinfo(y)\ninfo = stepinfo(y, t)\ninfo = stepinfo(y, t, yfinal)\ninfo = stepinfo(..., 'SettlingTimeThreshold', tol)",
+            "output": "info is a scalar struct of response metrics."
+        },
+        "points": [
+            "`sys` must be a supported SISO `tf` object.",
+            "`y` and `t` must be finite real vectors with the same number of samples.",
+            "`t` must be nondecreasing.",
+            "`yfinal` must be a finite scalar when supplied."
+        ]
+    },
+    "validation": {
+        "summary": "`stepinfo` validates system inputs, sampled data shape, finite values, time ordering, final value, and settling-threshold options. Tests cover sampled metrics, system metrics through `step` and `dcgain`, and VM control workflows.",
+        "implementation": {
+            "label": "`crates/runmat-runtime/src/builtins/control/stepinfo.rs`",
+            "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/control/stepinfo.rs"
+        }
+    },
+    "gpu_residency": "`stepinfo` returns a host struct.",
+    "key": "stepinfo",
+    "slug": "stepinfo",
+    "aliases": [],
+    "categoryPath": [
+        "control"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=stepinfo.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stepinfo.js","sourceRoot":"","sources":["../../../src/generated/builtins/stepinfo.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,eAAe;QACf,WAAW;QACX,eAAe;QACf,WAAW;QACX,gBAAgB;KACjB;IACD,SAAS,EAAE,sEAAsE;IACjF,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,mEAAmE;KAC7E;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,iLAAiL;IAChM,WAAW,EAAE;QACX,oEAAoE;QACpE,uFAAuF;QACvF,yKAAyK;QACzK,+CAA+C;QAC/C,8FAA8F;QAC9F,yEAAyE;KAC1E;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,kCAAkC;YACjD,OAAO,EAAE,gFAAgF;YACzF,QAAQ,EAAE,SAAS;SACpB;QACD;YACE,aAAa,EAAE,2BAA2B;YAC1C,OAAO,EAAE,kFAAkF;YAC3F,QAAQ,EAAE,SAAS;SACpB;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,oDAAoD;YAChE,QAAQ,EAAE,sDAAsD;SACjE;QACD;YACE,UAAU,EAAE,0CAA0C;YACtD,QAAQ,EAAE,kIAAkI;SAC7I;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;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,oJAAoJ;YAC7J,QAAQ,EAAE,8CAA8C;SACzD;QACD,QAAQ,EAAE;YACR,6CAA6C;YAC7C,0EAA0E;YAC1E,4BAA4B;YAC5B,iDAAiD;SAClD;KACF;IACD,YAAY,EAAE;QACZ,SAAS,EAAE,uOAAuO;QAClP,gBAAgB,EAAE;YAChB,OAAO,EAAE,0DAA0D;YACnE,KAAK,EAAE,uGAAuG;SAC/G;KACF;IACD,eAAe,EAAE,mCAAmC;IACpD,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/tf.d.ts.map

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