runmat 0.4.9-dev.1 → 0.4.9

package/dist/generated/builtins/sinc.js

@@ -0,0 +1,142 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "sinc",
+    "category": "math/signal",
+    "keywords": [
+        "sinc",
+        "normalized sinc",
+        "signal processing",
+        "elementwise",
+        "complex"
+    ],
+    "summary": "Normalized sinc, sin(pi*x)/(pi*x), evaluated element-wise.",
+    "references": [
+        "title: \"MATLAB sinc documentation\""
+    ],
+    "gpu_support": {
+        "elementwise": true,
+        "reduction": false,
+        "precisions": [
+            "f32",
+            "f64"
+        ],
+        "broadcasting": "matlab",
+        "notes": "Providers may execute sinc on-device through unary_sinc. The runtime gathers to the host only when a provider lacks that hook or cannot service the input."
+    },
+    "fusion": {
+        "elementwise": true,
+        "reduction": false,
+        "max_inputs": 1,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::math::signal::sinc::tests",
+        "integration": "builtins::math::signal::sinc::tests::sinc_gpu_input_stays_resident_when_provider_supports_sinc"
+    },
+    "description": "`y = sinc(x)` evaluates the normalized sinc function element-wise using MATLAB's definition `sin(pi*x)/(pi*x)`, with `sinc(0)` defined as `1`.",
+    "behaviors": [
+        "Accepts real or complex scalars, vectors, matrices, and N-D tensors.",
+        "Preserves the input shape for vector, matrix, and N-D tensor inputs.",
+        "Returns `1` for exactly zero real inputs.",
+        "Returns exact `0` for finite nonzero integer-valued real inputs, matching MATLAB's `sinpi`-style integer accuracy where practical.",
+        "Logical and integer inputs are promoted to double precision before evaluation.",
+        "Complex inputs use the analytic extension `sin(pi*z)/(pi*z)` and return `1 + 0i` for `z == 0`.",
+        "GPU inputs stay resident when the active provider supports `unary_sinc`; otherwise RunMat gathers automatically and evaluates with the host implementation."
+    ],
+    "examples": [
+        {
+            "description": "Evaluate sinc at zero",
+            "input": "y = sinc(0)",
+            "output": "y = 1"
+        },
+        {
+            "description": "Evaluate sinc at integer inputs",
+            "input": "x = 1:5;\ny = sinc(x)",
+            "output": "y = [0 0 0 0 0]"
+        },
+        {
+            "description": "Evaluate normalized sinc values",
+            "input": "x = [-1 0 1 0.5];\ny = sinc(x)",
+            "output": "y = [0 1 0 0.6366]"
+        },
+        {
+            "description": "Preserve matrix shape",
+            "input": "A = [0 0.5; 1.5 2];\nY = sinc(A)",
+            "output": "Y =\n    1.0000    0.6366\n   -0.2122         0"
+        },
+        {
+            "description": "Evaluate sinc for a complex value",
+            "input": "z = sinc(0.5 + 0.25i)"
+        },
+        {
+            "description": "Use gpuArray input",
+            "input": "g = gpuArray([0 0.5 1]);\ny = sinc(g);\nresult = gather(y)",
+            "output": "result = [1 0.6366 0]"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Which sinc definition does RunMat use?",
+            "answer": "RunMat uses MATLAB's normalized definition, `sin(pi*x)/(pi*x)`, with the removable singularity at zero defined as `1`."
+        },
+        {
+            "question": "Why does `sinc(1:5)` return exact zeros?",
+            "answer": "The implementation detects finite nonzero integer-valued real inputs before evaluating the trigonometric expression. This avoids floating-point residuals from `sin(pi*x)` and matches MATLAB's practical `sinpi` behaviour."
+        },
+        {
+            "question": "Does `sinc` support complex values?",
+            "answer": "Yes. Complex scalars and complex tensors use the analytic extension `sin(pi*z)/(pi*z)` and preserve tensor shape."
+        },
+        {
+            "question": "Will `sinc(gpuArray(...))` stay on the GPU?",
+            "answer": "Yes when the active provider implements `unary_sinc`. Providers without that hook fall back to host evaluation so zero and integer cases still use the exact MATLAB-compatible path."
+        }
+    ],
+    "links": [
+        {
+            "label": "sin",
+            "url": "./sin"
+        },
+        {
+            "label": "fft",
+            "url": "./fft"
+        },
+        {
+            "label": "filter",
+            "url": "./filter"
+        },
+        {
+            "label": "conv",
+            "url": "./conv"
+        },
+        {
+            "label": "gpuArray",
+            "url": "./gpuarray"
+        },
+        {
+            "label": "gather",
+            "url": "./gather"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/math/signal/sinc.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/math/signal/sinc.rs"
+    },
+    "gpu_residency": "`sinc` keeps real GPU tensors resident when the active provider exposes `unary_sinc`. The runtime preserves a host fallback for providers that do not support the hook.",
+    "gpu_behavior": [
+        "Provider-backed execution uses the same normalized sinc semantics, including `sinc(0) == 1` and exact zeros for finite nonzero integer-valued real inputs.",
+        "If the provider declines the operation, RunMat gathers through the active provider and evaluates with the host implementation.",
+        "Fusion emits a guarded normalized sinc expression with explicit zero and integer branches for real elementwise graphs."
+    ],
+    "key": "sinc",
+    "slug": "sinc",
+    "aliases": [],
+    "categoryPath": [
+        "math",
+        "signal"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=sinc.js.map

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

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

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

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

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

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

package/dist/generated/builtins/sind.js

@@ -0,0 +1,109 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "sind",
+    "category": "math/trigonometry",
+    "keywords": [
+        "sind",
+        "sine",
+        "degrees",
+        "angle",
+        "trigonometry",
+        "elementwise"
+    ],
+    "summary": "Sine of angles expressed in degrees with MATLAB-exact values at canonical multiples.",
+    "references": [],
+    "gpu_support": {
+        "elementwise": true,
+        "reduction": false,
+        "precisions": [
+            "f64"
+        ],
+        "broadcasting": "elementwise",
+        "notes": "GPU inputs are gathered to the host so the reference implementation can guarantee MATLAB-exact values at canonical multiples of 30, 90, 150, and 180 degrees."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 1,
+        "constants": "inline",
+        "notes": "Fusion is intentionally disabled for v1 because the WGSL `sin(x*pi/180)` form would lose MATLAB's exact-value guarantees at canonical angles."
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::math::trigonometry::sind::tests",
+        "integration": null
+    },
+    "description": "`y = sind(x)` evaluates the sine of each angle in `x`, interpreting the values in degrees rather than radians. The implementation reduces the angle modulo 360 and special-cases 0, 30, 90, 150, and 180 (and their negative/wrapped counterparts) so the result matches MATLAB's exact 0, ±0.5, and ±1 values without floating-point noise.",
+    "behaviors": [
+        "Operates element-wise on scalars, vectors, matrices, and N-D tensors.",
+        "Integer and logical inputs are promoted to double precision before evaluation.",
+        "Returns exactly 0 at multiples of 180 and exactly ±1 at the odd multiples of 90 (±90 + 360k).",
+        "Returns exactly ±0.5 at angles congruent to ±30 or ±150 modulo 360.",
+        "Complex inputs delegate to the analytic extension of `sin` after scaling by `pi/180`; exact-value treatment for complex operands is deferred.",
+        "Output shape matches the input shape; non-finite inputs propagate as `NaN`.",
+        "String inputs are unsupported and raise a builtin-scoped error."
+    ],
+    "examples": [
+        {
+            "description": "Sine of a canonical degree angle",
+            "input": "y = sind(30)",
+            "output": "y = 0.5"
+        },
+        {
+            "description": "Sine of multiples of 180 returns exactly zero",
+            "input": "y = sind([0 180 360])",
+            "output": "y = [0 0 0]"
+        },
+        {
+            "description": "Sine of a vector of common angles",
+            "input": "angles = [0 30 45 60 90];\ny = sind(angles)",
+            "output": "y = [0 0.5 0.7071 0.8660 1]"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Why does `sind(180)` return exactly zero?",
+            "answer": "MATLAB guarantees an exact zero at multiples of 180 to avoid floating-point noise from `pi`. RunMat reduces the angle modulo 360 and short-circuits the canonical cases before delegating to `sin`."
+        },
+        {
+            "question": "Is `sind(x)` equivalent to `sin(x*pi/180)`?",
+            "answer": "Mathematically yes, but the floating-point result differs at canonical angles because `pi/180` is not exact in binary floating point. `sind` returns the exact MATLAB values at multiples of 30, 90, 150, and 180."
+        },
+        {
+            "question": "Does `sind` support arrays?",
+            "answer": "Yes. Scalars, vectors, matrices, and N-D tensors are all handled element-wise; the shape of the input is preserved."
+        }
+    ],
+    "links": [
+        {
+            "label": "cosd",
+            "url": "./cosd"
+        },
+        {
+            "label": "tand",
+            "url": "./tand"
+        },
+        {
+            "label": "sin",
+            "url": "./sin"
+        },
+        {
+            "label": "deg2rad",
+            "url": "./deg2rad"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/math/trigonometry/sind.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/math/trigonometry/sind.rs"
+    },
+    "key": "sind",
+    "slug": "sind",
+    "aliases": [],
+    "categoryPath": [
+        "math",
+        "trigonometry"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=sind.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sind.js","sourceRoot":"","sources":["../../../src/generated/builtins/sind.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,MAAM;QACN,SAAS;QACT,OAAO;QACP,cAAc;QACd,aAAa;KACd;IACD,SAAS,EAAE,sFAAsF;IACjG,YAAY,EAAE,EAAE;IAChB,aAAa,EAAE;QACb,aAAa,EAAE,IAAI;QACnB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;SACN;QACD,cAAc,EAAE,aAAa;QAC7B,OAAO,EAAE,+JAA+J;KACzK;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;QACrB,OAAO,EAAE,+IAA+I;KACzJ;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,2CAA2C;QACnD,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,8UAA8U;IAC7V,WAAW,EAAE;QACX,uEAAuE;QACvE,gFAAgF;QAChF,+FAA+F;QAC/F,qEAAqE;QACrE,+IAA+I;QAC/I,6EAA6E;QAC7E,iEAAiE;KAClE;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,kCAAkC;YACjD,OAAO,EAAE,cAAc;YACvB,QAAQ,EAAE,SAAS;SACpB;QACD;YACE,aAAa,EAAE,+CAA+C;YAC9D,OAAO,EAAE,uBAAuB;YAChC,QAAQ,EAAE,aAAa;SACxB;QACD;YACE,aAAa,EAAE,mCAAmC;YAClD,OAAO,EAAE,6CAA6C;YACtD,QAAQ,EAAE,6BAA6B;SACxC;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,2CAA2C;YACvD,QAAQ,EAAE,qMAAqM;SAChN;QACD;YACE,UAAU,EAAE,6CAA6C;YACzD,QAAQ,EAAE,oNAAoN;SAC/N;QACD;YACE,UAAU,EAAE,6BAA6B;YACzC,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,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,gEAAgE;QACzE,KAAK,EAAE,6GAA6G;KACrH;IACD,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IACd,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,cAAc;KACf;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/square.js

@@ -0,0 +1,110 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "square",
+    "category": "math/signal",
+    "keywords": [
+        "square",
+        "waveform",
+        "signal processing",
+        "duty cycle",
+        "periodic",
+        "elementwise"
+    ],
+    "summary": "Generate a periodic square wave with optional duty cycle.",
+    "references": [],
+    "gpu_support": {
+        "elementwise": true,
+        "reduction": false,
+        "precisions": [
+            "f64"
+        ],
+        "broadcasting": "elementwise",
+        "notes": "GPU inputs are gathered to the host so the reference implementation can guarantee MATLAB-compatible half-open duty-cycle semantics at the period boundary."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 1,
+        "constants": "inline",
+        "notes": "Fusion is intentionally disabled for v1 because the duty-cycle comparison is cheap on the host and would not materially benefit from kernel fusion."
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::math::signal::square::tests",
+        "integration": null
+    },
+    "description": "`y = square(t)` generates a square wave with period `2*pi` at the sample times in `t`, with values in `{-1, +1}`. `y = square(t, duty)` accepts an explicit duty cycle as a percentage in `[0, 100]`: the output is `+1` over the first `duty/100 * 2*pi` of every period and `-1` for the remainder. The default duty cycle is 50% so that `square` produces the standard symmetric square wave.",
+    "behaviors": [
+        "Operates element-wise on scalars, vectors, matrices, and N-D tensors; preserves input shape.",
+        "Reduces input modulo `2*pi` so the waveform is periodic across negative and positive sample times.",
+        "Uses half-open interval semantics: `+1` for `phi/(2*pi) < duty/100`, `-1` otherwise.",
+        "`duty = 0` produces a constant `-1` waveform; `duty = 100` produces a constant `+1` waveform.",
+        "Integer and logical inputs are promoted to double precision before evaluation.",
+        "Non-finite sample times (`NaN`, `+Inf`, `-Inf`) propagate as `NaN` element-wise, matching MATLAB.",
+        "Complex and text inputs are rejected with a builtin-scoped error.",
+        "Rejects `duty` values outside `[0, 100]` and non-scalar `duty` arguments."
+    ],
+    "examples": [
+        {
+            "description": "Default 50% duty cycle square wave",
+            "input": "t = 0:pi/4:2*pi;\ny = square(t)",
+            "output": "y = [1 1 1 1 -1 -1 -1 -1 1]"
+        },
+        {
+            "description": "25% duty cycle square wave",
+            "input": "t = 0:pi/4:2*pi;\ny = square(t, 25)",
+            "output": "y = [1 1 -1 -1 -1 -1 -1 -1 1]"
+        },
+        {
+            "description": "Constant outputs at the boundaries",
+            "input": "y = square([0 pi 2*pi], 100)",
+            "output": "y = [1 1 1]"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "What happens exactly at the duty-cycle boundary?",
+            "answer": "RunMat uses half-open semantics: the boundary phase belongs to the negative half. With the default 50% duty cycle, `square(pi)` returns `-1`. This matches MATLAB's documented behaviour."
+        },
+        {
+            "question": "How do I produce a constant `+1` or `-1`?",
+            "answer": "Pass `duty = 100` for a constant `+1` waveform and `duty = 0` for a constant `-1` waveform."
+        },
+        {
+            "question": "Can `square` accept complex inputs?",
+            "answer": "No. `square` is defined on real samples and rejects complex inputs with a builtin-scoped error to match MATLAB."
+        }
+    ],
+    "links": [
+        {
+            "label": "sawtooth",
+            "url": "./sawtooth"
+        },
+        {
+            "label": "sin",
+            "url": "./sin"
+        },
+        {
+            "label": "cos",
+            "url": "./cos"
+        },
+        {
+            "label": "linspace",
+            "url": "./linspace"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/math/signal/square.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/math/signal/square.rs"
+    },
+    "key": "square",
+    "slug": "square",
+    "aliases": [],
+    "categoryPath": [
+        "math",
+        "signal"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=square.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"square.js","sourceRoot":"","sources":["../../../src/generated/builtins/square.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,UAAU;QACV,mBAAmB;QACnB,YAAY;QACZ,UAAU;QACV,aAAa;KACd;IACD,SAAS,EAAE,2DAA2D;IACtE,YAAY,EAAE,EAAE;IAChB,aAAa,EAAE;QACb,aAAa,EAAE,IAAI;QACnB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;SACN;QACD,cAAc,EAAE,aAAa;QAC7B,OAAO,EAAE,4JAA4J;KACtK;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;QACrB,OAAO,EAAE,qJAAqJ;KAC/J;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,uCAAuC;QAC/C,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,mYAAmY;IAClZ,WAAW,EAAE;QACX,8FAA8F;QAC9F,oGAAoG;QACpG,sFAAsF;QACtF,+FAA+F;QAC/F,gFAAgF;QAChF,mGAAmG;QACnG,mEAAmE;QACnE,2EAA2E;KAC5E;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,oCAAoC;YACnD,OAAO,EAAE,iCAAiC;YAC1C,QAAQ,EAAE,6BAA6B;SACxC;QACD;YACE,aAAa,EAAE,4BAA4B;YAC3C,OAAO,EAAE,qCAAqC;YAC9C,QAAQ,EAAE,+BAA+B;SAC1C;QACD;YACE,aAAa,EAAE,oCAAoC;YACnD,OAAO,EAAE,8BAA8B;YACvC,QAAQ,EAAE,aAAa;SACxB;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,kDAAkD;YAC9D,QAAQ,EAAE,2LAA2L;SACtM;QACD;YACE,UAAU,EAAE,2CAA2C;YACvD,QAAQ,EAAE,6FAA6F;SACxG;QACD;YACE,UAAU,EAAE,qCAAqC;YACjD,QAAQ,EAAE,iHAAiH;SAC5H;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;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/step.d.ts

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

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

@@ -0,0 +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"}

package/dist/generated/builtins/step.js

@@ -0,0 +1,125 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "step",
+    "category": "control",
+    "keywords": [
+        "step",
+        "step response",
+        "control system",
+        "transfer function",
+        "tf"
+    ],
+    "summary": "Compute or plot the step response of a SISO transfer-function model.",
+    "references": [
+        "title: \"MATLAB step documentation\""
+    ],
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "`step` simulates host-side transfer-function metadata. GPU inputs are not part of the initial `tf` object response path."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "inline",
+        "notes": "`step` is not fused; it simulates a dynamic system and may render a plot."
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::control::step::tests",
+        "integration": "crates/runmat-vm/tests/control.rs"
+    },
+    "description": "`step(sys)` plots the unit-step response of a SISO transfer-function object created by `tf`. `[y, tOut] = step(sys)` returns sampled response data and the time vector. `step(sys, tFinal)` uses a scalar final time, while `step(sys, t)` evaluates at an explicit time vector.",
+    "behaviors": [
+        "Supports SISO `tf` objects with real coefficients.",
+        "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.",
+        "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.",
+        "Discrete-time models use the stored `Ts` sample time."
+    ],
+    "examples": [
+        {
+            "description": "Returning response data for a first-order system",
+            "input": "sys = tf(1, [1 1]);\n[y, t] = step(sys);",
+            "output": "y and t are column vectors."
+        },
+        {
+            "description": "Using a scalar final time",
+            "input": "sys = tf(1, [1 1]);\n[y, t] = step(sys, 5);",
+            "output": "t(end) = 5"
+        },
+        {
+            "description": "Using an explicit time vector",
+            "input": "sys = tf(1, [1 1]);\nt = 0:0.5:2;\ny = step(sys, t);",
+            "output": "y is sampled at the values in t."
+        },
+        {
+            "description": "Plotting the step response",
+            "input": "sys = tf(1, [1 1]);\nstep(sys);",
+            "output": "A step-response plot is rendered."
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does `step` support MIMO models?",
+            "answer": "Not yet. This implementation starts with SISO transfer-function objects."
+        },
+        {
+            "question": "Does `step` support state-space models?",
+            "answer": "Not yet. The initial implementation supports transfer-function objects produced by `tf`."
+        },
+        {
+            "question": "Can transfer-function coefficients be complex?",
+            "answer": "Not in this first implementation. Complex coefficients return a clear unsupported-input error."
+        }
+    ],
+    "links": [
+        {
+            "label": "tf",
+            "url": "./tf"
+        },
+        {
+            "label": "plot",
+            "url": "./plot"
+        }
+    ],
+    "source": {
+        "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"
+    },
+    "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)",
+            "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."
+        ]
+    },
+    "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.",
+        "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"
+        }
+    },
+    "gpu_residency": "`step` computes on the host from `tf` metadata and returns host tensors.",
+    "key": "step",
+    "slug": "step",
+    "aliases": [],
+    "categoryPath": [
+        "control"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=step.js.map

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

@@ -0,0 +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,sEAAsE;IACjF,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,kRAAkR;IACjS,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"}

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

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

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

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