runmat 0.5.4-dev.5 → 0.5.4-dev.6

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

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

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

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

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

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

@@ -0,0 +1,111 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "pskmod",
+    "category": "comms/modulation",
+    "keywords": [
+        "pskmod",
+        "psk",
+        "modulation",
+        "communications",
+        "gray",
+        "binary",
+        "phaseoffset",
+        "constellation",
+        "gpu"
+    ],
+    "summary": "Map integers or bit groups to PSK constellation points in MATLAB and RunMat.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f32",
+            "f64",
+            "i32",
+            "bool"
+        ],
+        "broadcasting": "none",
+        "notes": "Integer-symbol and bit-input gpuArrays use the active provider's modulation hooks to produce complex-interleaved GPU storage directly. Providers without those hooks fall back to host-compatible validation and re-upload."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 1,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::comms::pskmod::tests"
+    },
+    "description": "`pskmod(X, M)` maps integer symbols or bit groups to unit-magnitude M-PSK complex-baseband samples. Phase offset, Gray ordering, binary ordering, custom symbol ordering, bit input, and output precision follow the MATLAB Communications Toolbox surface.",
+    "behaviors": [
+        "`X` must contain finite integer symbols in the inclusive range `[0, M-1]` when `InputType` is `'integer'`.",
+        "`M` must be an integer greater than one. Bit input additionally requires `M` to be a power of two.",
+        "The default phase offset is zero radians.",
+        "The default symbol order is `'gray'`; `'bin'` maps symbol `k` to angle `phaseoffset + 2*pi*k/M`.",
+        "Custom symbol order vectors must have length `M`, contain each integer in `[0, M-1]` exactly once, and label constellation points counter-clockwise starting at `phaseoffset`.",
+        "`InputType='bit'` groups rows by `log2(M)` bits per symbol with the first bit as the MSB, preserving remaining dimensions as independent channels.",
+        "`OutputDataType='single'` rounds real and imaginary samples through single precision before returning the complex tensor or resident complex gpuArray output.",
+        "`PlotConstellation=true` is accepted as a recognized option but raises an explicit not-implemented error."
+    ],
+    "examples": [
+        {
+            "description": "Default 8-PSK Gray mapping",
+            "input": "y = pskmod(0:7, 8)"
+        },
+        {
+            "description": "QPSK with a phase offset",
+            "input": "y = pskmod(0:3, 4, pi/4)"
+        },
+        {
+            "description": "Binary symbol ordering",
+            "input": "y = pskmod(0:3, 4, 0, 'bin')"
+        },
+        {
+            "description": "Bit input",
+            "input": "bits = [0 0; 0 1; 1 0; 1 1];\ny = pskmod(bits, 4, InputType='bit')"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Does pskmod execute on the GPU?",
+            "answer": "Yes when the active provider implements the modulation hooks. Integer-symbol and bit-input gpuArrays can produce resident complex-interleaved outputs directly."
+        },
+        {
+            "question": "Is custom symbol ordering supported?",
+            "answer": "Yes. Supply a vector whose first element labels the constellation point at `phaseoffset`; later elements label points counter-clockwise around the unit circle."
+        }
+    ],
+    "links": [
+        {
+            "label": "qammod",
+            "url": "./qammod"
+        },
+        {
+            "label": "gpuArray",
+            "url": "./gpuarray"
+        },
+        {
+            "label": "gather",
+            "url": "./gather"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/comms/pskmod.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/comms/pskmod.rs"
+    },
+    "gpu_residency": "The builtin declares `NewHandle` residency for gpuArray inputs. Integer-symbol and bit-input gpuArray inputs stay resident through provider-side constellation modulation and produce a complex-interleaved GPU handle when provider support is available.",
+    "gpu_behavior": [
+        "RunMat represents complex GPU tensors as interleaved real/imaginary buffers with complex storage metadata, so downstream GPU-aware FFT and signal paths can consume the modulation output without a host result.",
+        "The provider hooks receive a validated constellation table and write the complex output on device. They read back only a compact validation state for MATLAB-compatible symbol or bit errors."
+    ],
+    "key": "pskmod",
+    "slug": "pskmod",
+    "aliases": [],
+    "categoryPath": [
+        "comms",
+        "modulation"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=pskmod.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pskmod.js","sourceRoot":"","sources":["../../../src/generated/builtins/pskmod.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,QAAQ;IACjB,UAAU,EAAE,kBAAkB;IAC9B,UAAU,EAAE;QACV,QAAQ;QACR,KAAK;QACL,YAAY;QACZ,gBAAgB;QAChB,MAAM;QACN,QAAQ;QACR,aAAa;QACb,eAAe;QACf,KAAK;KACN;IACD,SAAS,EAAE,8EAA8E;IACzF,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;YACL,KAAK;YACL,KAAK;YACL,MAAM;SACP;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,6NAA6N;KACvO;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;KACzC;IACD,aAAa,EAAE,6PAA6P;IAC5Q,WAAW,EAAE;QACX,4GAA4G;QAC5G,oGAAoG;QACpG,2CAA2C;QAC3C,kGAAkG;QAClG,gLAAgL;QAChL,oJAAoJ;QACpJ,+JAA+J;QAC/J,2GAA2G;KAC5G;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,4BAA4B;YAC3C,OAAO,EAAE,oBAAoB;SAC9B;QACD;YACE,aAAa,EAAE,0BAA0B;YACzC,OAAO,EAAE,0BAA0B;SACpC;QACD;YACE,aAAa,EAAE,wBAAwB;YACvC,OAAO,EAAE,8BAA8B;SACxC;QACD;YACE,aAAa,EAAE,WAAW;YAC1B,OAAO,EAAE,oEAAoE;SAC9E;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,iCAAiC;YAC7C,QAAQ,EAAE,iKAAiK;SAC5K;QACD;YACE,UAAU,EAAE,sCAAsC;YAClD,QAAQ,EAAE,iKAAiK;SAC5K;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,sDAAsD;QAC/D,KAAK,EAAE,mGAAmG;KAC3G;IACD,eAAe,EAAE,4PAA4P;IAC7Q,cAAc,EAAE;QACd,kNAAkN;QAClN,+LAA+L;KAChM;IACD,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,YAAY;KACb;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/pulstran.js

@@ -12,9 +12,6 @@ const builtinDoc = {
         "signal processing"
     ],
     "summary": "Generate pulse trains from named pulse functions, function handles, or sampled prototype pulses.",
-    "references": [
-        "title: \"MATLAB pulstran documentation\""
-    ],
     "gpu_support": {
         "elementwise": false,
         "reduction": false,

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

@@ -1 +1 @@
-{"version":3,"file":"pulstran.js","sourceRoot":"","sources":["../../../src/generated/builtins/pulstran.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,UAAU;IACnB,UAAU,EAAE,aAAa;IACzB,UAAU,EAAE;QACV,UAAU;QACV,aAAa;QACb,UAAU;QACV,SAAS;QACT,UAAU;QACV,mBAAmB;KACpB;IACD,SAAS,EAAE,kGAAkG;IAC7G,YAAY,EAAE;QACZ,0CAA0C;KAC3C;IACD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;SACN;QACD,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,2EAA2E;KACrF;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,yCAAyC;QACjD,aAAa,EAAE,sFAAsF;KACtG;IACD,aAAa,EAAE,wRAAwR;IACvS,WAAW,EAAE;QACX,+BAA+B;QAC/B,uMAAuM;QACvM,qDAAqD;QACrD,8EAA8E;QAC9E,oHAAoH;QACpH,iFAAiF;KAClF;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,oCAAoC;YACnD,OAAO,EAAE,sEAAsE;YAC/E,QAAQ,EAAE,iBAAiB;SAC5B;QACD;YACE,aAAa,EAAE,sBAAsB;YACrC,OAAO,EAAE,mEAAmE;YAC5E,QAAQ,EAAE,WAAW;SACtB;QACD;YACE,aAAa,EAAE,yBAAyB;YACxC,OAAO,EAAE,kEAAkE;YAC3E,QAAQ,EAAE,iBAAiB;SAC5B;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,gDAAgD;YAC5D,QAAQ,EAAE,6JAA6J;SACxK;QACD;YACE,UAAU,EAAE,kDAAkD;YAC9D,QAAQ,EAAE,wGAAwG;SACnH;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,8DAA8D;QACvE,KAAK,EAAE,2GAA2G;KACnH;IACD,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,QAAQ;KACT;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"pulstran.js","sourceRoot":"","sources":["../../../src/generated/builtins/pulstran.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,UAAU;IACnB,UAAU,EAAE,aAAa;IACzB,UAAU,EAAE;QACV,UAAU;QACV,aAAa;QACb,UAAU;QACV,SAAS;QACT,UAAU;QACV,mBAAmB;KACpB;IACD,SAAS,EAAE,kGAAkG;IAC7G,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;SACN;QACD,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,2EAA2E;KACrF;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,yCAAyC;QACjD,aAAa,EAAE,sFAAsF;KACtG;IACD,aAAa,EAAE,wRAAwR;IACvS,WAAW,EAAE;QACX,+BAA+B;QAC/B,uMAAuM;QACvM,qDAAqD;QACrD,8EAA8E;QAC9E,oHAAoH;QACpH,iFAAiF;KAClF;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,oCAAoC;YACnD,OAAO,EAAE,sEAAsE;YAC/E,QAAQ,EAAE,iBAAiB;SAC5B;QACD;YACE,aAAa,EAAE,sBAAsB;YACrC,OAAO,EAAE,mEAAmE;YAC5E,QAAQ,EAAE,WAAW;SACtB;QACD;YACE,aAAa,EAAE,yBAAyB;YACxC,OAAO,EAAE,kEAAkE;YAC3E,QAAQ,EAAE,iBAAiB;SAC5B;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,gDAAgD;YAC5D,QAAQ,EAAE,6JAA6J;SACxK;QACD;YACE,UAAU,EAAE,kDAAkD;YAC9D,QAAQ,EAAE,wGAAwG;SACnH;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,8DAA8D;QACvE,KAAK,EAAE,2GAA2G;KACnH;IACD,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,QAAQ;KACT;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/pwd.js

@@ -10,7 +10,6 @@ const builtinDoc = {
         "present working directory"
     ],
     "summary": "Return the current working folder path in MATLAB and RunMat.",
-    "references": [],
     "gpu_support": {
         "elementwise": false,
         "reduction": false,

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

@@ -1 +1 @@
-{"version":3,"file":"pwd.js","sourceRoot":"","sources":["../../../src/generated/builtins/pwd.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,mBAAmB;QACnB,gBAAgB;QAChB,2BAA2B;KAC5B;IACD,SAAS,EAAE,8DAA8D;IACzE,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,gGAAgG;KAC1G;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,mEAAmE;KACnF;IACD,aAAa,EAAE,8HAA8H;IAC7I,WAAW,EAAE;QACX,kEAAkE;QAClE,yEAAyE;QACzE,oKAAoK;QACpK,mFAAmF;QACnF,0IAA0I;KAC3I;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,iCAAiC;YAChD,OAAO,EAAE,+BAA+B;YACxC,QAAQ,EAAE,GAAG;SACd;QACD;YACE,aAAa,EAAE,gDAAgD;YAC/D,OAAO,EAAE,yJAAyJ;YAClK,QAAQ,EAAE,qDAAqD;SAChE;QACD;YACE,aAAa,EAAE,iDAAiD;YAChE,OAAO,EAAE,sEAAsE;YAC/E,QAAQ,EAAE,+HAA+H;SAC1I;QACD;YACE,aAAa,EAAE,mCAAmC;YAClD,OAAO,EAAE,2CAA2C;YACpD,QAAQ,EAAE,4CAA4C;SACvD;QACD;YACE,aAAa,EAAE,8CAA8C;YAC7D,OAAO,EAAE,kHAAkH;YAC3H,QAAQ,EAAE,gEAAgE;SAC3E;QACD;YACE,aAAa,EAAE,sDAAsD;YACrE,OAAO,EAAE,kEAAkE;YAC3E,QAAQ,EAAE,+JAA+J;SAC1K;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,+DAA+D;YAC3E,QAAQ,EAAE,uKAAuK;SAClL;QACD;YACE,UAAU,EAAE,4CAA4C;YACxD,QAAQ,EAAE,oGAAoG;SAC/G;QACD;YACE,UAAU,EAAE,iBAAiB;YAC7B,QAAQ,EAAE,iKAAiK;SAC5K;QACD;YACE,UAAU,EAAE,gCAAgC;YAC5C,QAAQ,EAAE,iFAAiF;SAC5F;QACD;YACE,UAAU,EAAE,+CAA+C;YAC3D,QAAQ,EAAE,oFAAoF;SAC/F;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,MAAM;SACd;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,MAAM;SACd;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,wDAAwD;QACjE,KAAK,EAAE,qGAAqG;KAC7G;IACD,eAAe,EAAE,4NAA4N;IAC7O,cAAc,EAAE;QACd,+aAA+a;KAChb;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"}
+{"version":3,"file":"pwd.js","sourceRoot":"","sources":["../../../src/generated/builtins/pwd.ts"],"names":[],"mappings":"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"}

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

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

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

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

@@ -0,0 +1,118 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "pwelch",
+    "category": "math/signal",
+    "keywords": [
+        "pwelch",
+        "Welch",
+        "PSD",
+        "periodogram",
+        "spectral density",
+        "signal processing"
+    ],
+    "summary": "Estimate power spectral density using Welch's method.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [
+            "f32",
+            "f64"
+        ],
+        "broadcasting": "none",
+        "notes": "Uniform-grid Welch spectral estimation keeps GPU-resident signals on device through segment framing, FFTs, power scaling, averaging, and frequency-grid generation. Explicit-frequency forms fall back to host execution."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 6,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::math::signal::pwelch::tests",
+        "integration": "crates/runmat-vm/tests/basics.rs"
+    },
+    "description": "`pwelch(x)` estimates the power spectral density of a signal by averaging modified periodograms of overlapped, windowed segments. Optional arguments select the window, overlap, FFT length, sampling frequency, frequency range, and spectrum scale.",
+    "behaviors": [
+        "`pxx = pwelch(x)` returns a one-sided PSD estimate for real inputs and a two-sided estimate for complex inputs.",
+        "Matrix inputs are processed column-wise; `pxx` has one output column per input column.",
+        "`[pxx, f] = pwelch(...)` also returns the frequency grid. Without `fs`, frequencies are in radians/sample; with `fs`, frequencies are in Hz.",
+        "The `window` argument may be a vector or a scalar segment length. A scalar creates a Hamming window of that length; `[]` uses a default Hamming window sized for roughly eight 50%-overlapped sections, capped at 256 samples.",
+        "`noverlap` defaults to half the window length and must be less than the window length.",
+        "`nfft` defaults to `max(256, length(window))`, must be at least the window length, and controls the FFT grid. A real frequency vector may be supplied in the same position to evaluate the PSD at explicit frequencies.",
+        "The optional range selector accepts `'onesided'`, `'twosided'`, or `'centered'`.",
+        "The optional spectrum type accepts `'psd'` (default) or `'power'`; `'power'` omits the density bandwidth normalization."
+    ],
+    "examples": [
+        {
+            "description": "PSD of a sine wave",
+            "input": "fs = 1000;\nt = (0:999) / fs;\nx = sin(2*pi*100*t);\n[pxx, f] = pwelch(x, hamming(256), 128, 512, fs);"
+        },
+        {
+            "description": "Use a scalar window length",
+            "input": "[pxx, w] = pwelch(randn(1,1024), 128, 64, 256);"
+        },
+        {
+            "description": "Two-sided spectrum",
+            "input": "x = exp(1i*2*pi*(0:127)/16);\n[pxx, w] = pwelch(x, 64, 32, 128, 'twosided');"
+        },
+        {
+            "description": "Centered spectrum in Hz",
+            "input": "[pxx, f] = pwelch(randn(1,512), [], [], 512, 2000, 'centered');"
+        },
+        {
+            "description": "Column-wise spectra for a matrix",
+            "input": "x = [sin(2*pi*(0:255)'/16), cos(2*pi*(0:255)'/32)];\n[pxx, f] = pwelch(x, 64, 32, 128, 'power');"
+        },
+        {
+            "description": "Evaluate at explicit normalized frequencies",
+            "input": "w = linspace(0, pi, 64);\n[pxx, wout] = pwelch(randn(1,512), hamming(128), 64, w);"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Can I pass a Hamming window from the `hamming` builtin?",
+            "answer": "Yes. `pwelch(x, hamming(n), noverlap, nfft, fs)` uses the provided window directly. Passing the scalar `n` instead creates the same kind of Hamming segment window internally."
+        },
+        {
+            "question": "Does `pwelch` include the Nyquist bin?",
+            "answer": "For one-sided output and even `nfft`, yes. The output length is `nfft/2 + 1`, with DC first and the Nyquist bin last."
+        },
+        {
+            "question": "Does `pwelch` plot when no outputs are requested?",
+            "answer": "RunMat currently returns values using normal output-count semantics instead of opening a plot. Use the returned `pxx` and frequency vector with plotting functions explicitly."
+        }
+    ],
+    "links": [
+        {
+            "label": "periodogram",
+            "url": "./periodogram"
+        },
+        {
+            "label": "spectrogram",
+            "url": "./spectrogram"
+        },
+        {
+            "label": "fft",
+            "url": "./fft"
+        },
+        {
+            "label": "hamming",
+            "url": "./hamming"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/math/signal/pwelch.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/math/signal/pwelch.rs"
+    },
+    "key": "pwelch",
+    "slug": "pwelch",
+    "aliases": [],
+    "categoryPath": [
+        "math",
+        "signal"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=pwelch.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pwelch.js","sourceRoot":"","sources":["../../../src/generated/builtins/pwelch.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,OAAO;QACP,KAAK;QACL,aAAa;QACb,kBAAkB;QAClB,mBAAmB;KACpB;IACD,SAAS,EAAE,uDAAuD;IAClE,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,2NAA2N;KACrO;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,kCAAkC;KAClD;IACD,aAAa,EAAE,uPAAuP;IACtQ,WAAW,EAAE;QACX,iHAAiH;QACjH,wFAAwF;QACxF,8IAA8I;QAC9I,gOAAgO;QAChO,wFAAwF;QACxF,yNAAyN;QACzN,kFAAkF;QAClF,yHAAyH;KAC1H;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,oBAAoB;YACnC,OAAO,EAAE,wGAAwG;SAClH;QACD;YACE,aAAa,EAAE,4BAA4B;YAC3C,OAAO,EAAE,iDAAiD;SAC3D;QACD;YACE,aAAa,EAAE,oBAAoB;YACnC,OAAO,EAAE,8EAA8E;SACxF;QACD;YACE,aAAa,EAAE,yBAAyB;YACxC,OAAO,EAAE,iEAAiE;SAC3E;QACD;YACE,aAAa,EAAE,kCAAkC;YACjD,OAAO,EAAE,kGAAkG;SAC5G;QACD;YACE,aAAa,EAAE,6CAA6C;YAC5D,OAAO,EAAE,oFAAoF;SAC9F;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,yDAAyD;YACrE,QAAQ,EAAE,gLAAgL;SAC3L;QACD;YACE,UAAU,EAAE,wCAAwC;YACpD,QAAQ,EAAE,uHAAuH;SAClI;QACD;YACE,UAAU,EAAE,mDAAmD;YAC/D,QAAQ,EAAE,gLAAgL;SAC3L;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,aAAa;YACtB,KAAK,EAAE,eAAe;SACvB;QACD;YACE,OAAO,EAAE,aAAa;YACtB,KAAK,EAAE,eAAe;SACvB;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,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/qammod.d.ts.map

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

@@ -13,8 +13,7 @@ const builtinDoc = {
         "constellation",
         "gpu"
     ],
-    "summary": "Map integers to QAM constellation points in MATLAB and RunMat.",
-    "references": [],
+    "summary": "Map integer or bit symbols to QAM constellation points in MATLAB and RunMat.",
     "gpu_support": {
         "elementwise": false,
         "reduction": false,
@@ -25,7 +24,7 @@ const builtinDoc = {
             "bool"
         ],
         "broadcasting": "none",
-        "notes": "gpuArray inputs are gathered through the active provider and modulated on the host because RunMat does not yet represent complex-valued GPU tensor handles. The result is a host ComplexTensor."
+        "notes": "Integer-symbol and bit-input gpuArrays use the active provider's modulation hooks to produce complex-interleaved GPU storage directly. Providers without those hooks fall back to host-compatible validation and re-upload."
     },
     "fusion": {
         "elementwise": false,
@@ -37,16 +36,17 @@ const builtinDoc = {
     "tested": {
         "unit": "builtins::comms::qammod::tests"
     },
-    "description": "`qammod(X, M)` maps integer symbols `X` to complex QAM constellation points for modulation order `M`. Gray, binary, and custom symbol-ordering behavior follow MATLAB semantics.",
+    "description": "`qammod(X, M)` maps integer symbols or bit groups `X` to complex QAM constellation points for modulation order `M`. Gray, binary, and custom symbol-ordering behavior follow MATLAB semantics.",
     "behaviors": [
         "`X` must contain finite integer values in the inclusive range `[0, M-1]`.",
+        "`InputType='bit'` groups rows of `X` in `log2(M)` chunks per column/channel and maps each bit group to one symbol.",
         "`M` must be a power-of-two integer greater than one.",
         "Square QAM orders such as 4, 16, 64, and 256 use symmetric odd integer amplitudes with minimum distance two.",
         "Non-square power-of-two orders use a rectangular grid with the larger dimension on the in-phase axis.",
         "The default `'gray'` order applies Gray coding independently to the in-phase and quadrature grid indexes.",
         "`'UnitAveragePower', true` scales the complete constellation so its average power is one.",
-        "`'OutputDataType', 'single'` rounds the real and imaginary samples through single precision before returning the host complex tensor.",
-        "`'PlotConstellation', true` and `InputType='bit'` are not implemented yet."
+        "`'OutputDataType', 'single'` rounds the real and imaginary samples through single precision before returning the complex tensor or resident complex gpuArray output.",
+        "`'PlotConstellation', true` is not implemented yet."
     ],
     "examples": [
         {
@@ -63,16 +63,21 @@ const builtinDoc = {
             "description": "Unit-average-power 16-QAM",
             "input": "y = qammod(0:15, 16, 'UnitAveragePower', true);\nmean(abs(y).^2)",
             "output": "ans = 1"
+        },
+        {
+            "description": "Bit input for 16-QAM",
+            "input": "bits = [0 1; 0 1; 0 1; 0 1];\ny = qammod(bits, 16, 'InputType', 'bit')",
+            "output": "y = [-3+3i 1-1i]"
         }
     ],
     "faqs": [
         {
             "question": "Does qammod execute on the GPU?",
-            "answer": "It accepts gpuArray inputs, but the current runtime gathers them to host memory and returns a host ComplexTensor because complex GPU tensor handles are not yet part of RunMat's value model."
+            "answer": "Yes when the active provider implements the modulation hooks. It maps resident integer-symbol and bit-input gpuArrays directly to complex-interleaved gpuArray outputs."
         },
         {
             "question": "Is bit input supported?",
-            "answer": "Not in this first implementation. Use integer symbols or convert bit groups to integer symbols before calling qammod."
+            "answer": "Yes. `InputType='bit'` accepts numeric 0/1 or logical inputs and groups rows in `log2(M)` chunks for each column/channel."
         }
     ],
     "links": [
@@ -89,10 +94,10 @@ const builtinDoc = {
         "label": "`crates/runmat-runtime/src/builtins/comms/qammod.rs`",
         "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/comms/qammod.rs"
     },
-    "gpu_residency": "The builtin declares `GatherImmediately` residency. A gpuArray input is downloaded once through the dispatcher and then mapped to complex host output.",
+    "gpu_residency": "The builtin declares `NewHandle` residency for gpuArray inputs. Integer-symbol and bit-input gpuArrays stay resident through provider-side constellation modulation when provider support is available.",
     "gpu_behavior": [
-        "RunMat's current accelerator API stores real-valued GPU buffers. Since `qammod` necessarily produces complex-valued samples, the GPU-aware implementation preserves correctness by gathering device input and producing a `ComplexTensor` on the host.",
-        "The registered GPU metadata advertises the supported input scalar classes and the provider hook name future accelerators can use once complex GPU outputs are represented."
+        "RunMat represents complex GPU tensors as interleaved real/imaginary buffers with complex storage metadata, so downstream GPU-aware FFT and signal paths can consume the modulation output without a host result.",
+        "The provider hooks receive a validated constellation table and write the complex output on device. They read back only a compact validation state for MATLAB-compatible symbol or bit errors."
     ],
     "key": "qammod",
     "slug": "qammod",

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

@@ -1 +1 @@
-{"version":3,"file":"qammod.js","sourceRoot":"","sources":["../../../src/generated/builtins/qammod.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,QAAQ;IACjB,UAAU,EAAE,kBAAkB;IAC9B,UAAU,EAAE;QACV,QAAQ;QACR,KAAK;QACL,YAAY;QACZ,gBAAgB;QAChB,MAAM;QACN,QAAQ;QACR,eAAe;QACf,KAAK;KACN;IACD,SAAS,EAAE,gEAAgE;IAC3E,YAAY,EAAE,EAAE;IAChB,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;YACL,KAAK;YACL,KAAK;YACL,MAAM;SACP;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,gCAAgC;KACzC;IACD,aAAa,EAAE,kLAAkL;IACjM,WAAW,EAAE;QACX,2EAA2E;QAC3E,sDAAsD;QACtD,8GAA8G;QAC9G,uGAAuG;QACvG,2GAA2G;QAC3G,2FAA2F;QAC3F,uIAAuI;QACvI,4EAA4E;KAC7E;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,6BAA6B;YAC5C,OAAO,EAAE,sBAAsB;YAC/B,QAAQ,EAAE,+FAA+F;SAC1G;QACD;YACE,aAAa,EAAE,wBAAwB;YACvC,OAAO,EAAE,4BAA4B;YACrC,QAAQ,EAAE,qCAAqC;SAChD;QACD;YACE,aAAa,EAAE,2BAA2B;YAC1C,OAAO,EAAE,kEAAkE;YAC3E,QAAQ,EAAE,SAAS;SACpB;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,iCAAiC;YAC7C,QAAQ,EAAE,+LAA+L;SAC1M;QACD;YACE,UAAU,EAAE,yBAAyB;YACrC,QAAQ,EAAE,uHAAuH;SAClI;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,sDAAsD;QAC/D,KAAK,EAAE,mGAAmG;KAC3G;IACD,eAAe,EAAE,wJAAwJ;IACzK,cAAc,EAAE;QACd,wPAAwP;QACxP,4KAA4K;KAC7K;IACD,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,YAAY;KACb;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"qammod.js","sourceRoot":"","sources":["../../../src/generated/builtins/qammod.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,QAAQ;IACjB,UAAU,EAAE,kBAAkB;IAC9B,UAAU,EAAE;QACV,QAAQ;QACR,KAAK;QACL,YAAY;QACZ,gBAAgB;QAChB,MAAM;QACN,QAAQ;QACR,eAAe;QACf,KAAK;KACN;IACD,SAAS,EAAE,8EAA8E;IACzF,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;YACL,KAAK;YACL,KAAK;YACL,MAAM;SACP;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,6NAA6N;KACvO;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;KACzC;IACD,aAAa,EAAE,gMAAgM;IAC/M,WAAW,EAAE;QACX,2EAA2E;QAC3E,oHAAoH;QACpH,sDAAsD;QACtD,8GAA8G;QAC9G,uGAAuG;QACvG,2GAA2G;QAC3G,2FAA2F;QAC3F,sKAAsK;QACtK,qDAAqD;KACtD;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,6BAA6B;YAC5C,OAAO,EAAE,sBAAsB;YAC/B,QAAQ,EAAE,+FAA+F;SAC1G;QACD;YACE,aAAa,EAAE,wBAAwB;YACvC,OAAO,EAAE,4BAA4B;YACrC,QAAQ,EAAE,qCAAqC;SAChD;QACD;YACE,aAAa,EAAE,2BAA2B;YAC1C,OAAO,EAAE,kEAAkE;YAC3E,QAAQ,EAAE,SAAS;SACpB;QACD;YACE,aAAa,EAAE,sBAAsB;YACrC,OAAO,EAAE,wEAAwE;YACjF,QAAQ,EAAE,kBAAkB;SAC7B;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,iCAAiC;YAC7C,QAAQ,EAAE,yKAAyK;SACpL;QACD;YACE,UAAU,EAAE,yBAAyB;YACrC,QAAQ,EAAE,2HAA2H;SACtI;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,sDAAsD;QAC/D,KAAK,EAAE,mGAAmG;KAC3G;IACD,eAAe,EAAE,yMAAyM;IAC1N,cAAc,EAAE;QACd,kNAAkN;QAClN,+LAA+L;KAChM;IACD,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,YAAY;KACb;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/qr.js

@@ -11,7 +11,6 @@ const builtinDoc = {
         "pivoting"
     ],
     "summary": "Compute QR factorizations in MATLAB and RunMat.",
-    "references": [],
     "gpu_support": {
         "elementwise": false,
         "reduction": false,

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

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

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

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

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

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

package/dist/generated/builtins/quad.js

@@ -0,0 +1,101 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "quad",
+    "category": "math/optim",
+    "keywords": [
+        "quad",
+        "numerical integration",
+        "adaptive simpson",
+        "quadrature",
+        "function handle"
+    ],
+    "summary": "Approximate finite scalar definite integrals with MATLAB's legacy quad interface.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "The adaptive Simpson loop runs on the host. Callback functions may still call GPU-aware builtins."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 6,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::math::optim::quad::tests",
+        "integration": null
+    },
+    "description": "`q = quad(fun, a, b)` approximates the definite integral of scalar integrand `fun` from `a` to `b` using adaptive Simpson quadrature. It supports the legacy MATLAB call forms with optional tolerance, trace output, forwarded parameters, and `[q, fcnt]` output.",
+    "behaviors": [
+        "The function may be a named function handle such as `@sin`, an anonymous function such as `@(x) x.^2`, or a function-handle string.",
+        "The integration loop evaluates the integrand at scalar sample points and adapts subintervals using Simpson error estimates.",
+        "`tol` is an absolute positive scalar tolerance and defaults to `1e-6`; an empty `tol` uses the default.",
+        "`trace` prints legacy adaptive subdivision rows as `[fcnEvals, a, b-a, Q]` when nonzero; an empty `trace` disables tracing.",
+        "Arguments after `trace` are forwarded to the integrand as `fun(x, p1, p2, ...)`.",
+        "The integrand must return a finite real scalar. Array-valued and complex-valued integrands are not supported by `quad`.",
+        "Finite reversed bounds are accepted and negate the result. Equal bounds return zero with a function count of zero.",
+        "Requests for more than two outputs are rejected."
+    ],
+    "examples": [
+        {
+            "description": "Integrate sine over one half-period",
+            "input": "q = quad(@sin, 0, pi)",
+            "output": "q =\n    2.0000"
+        },
+        {
+            "description": "Return the function evaluation count",
+            "input": "[q, fcnt] = quad(@(x) x.^2, 0, 1)",
+            "output": "q =\n    0.3333"
+        },
+        {
+            "description": "Forward an extra argument to the integrand",
+            "input": "q = quad(@(x,a) a.*x, 0, 2, [], [], 3)",
+            "output": "q =\n    6.0000"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "Should new code use quad or integral?",
+            "answer": "Use `integral` for new code when possible. `quad` exists for legacy MATLAB script compatibility."
+        },
+        {
+            "question": "Does quad support extra parameters?",
+            "answer": "Yes. Values after `trace` are forwarded to the function handle after the scalar sample point."
+        },
+        {
+            "question": "Does quad run on the GPU?",
+            "answer": "The adaptive solver runs on the host because it repeatedly invokes user code through function-handle dispatch. The callback itself may call GPU-aware builtins."
+        }
+    ],
+    "links": [
+        {
+            "label": "integral",
+            "url": "./integral"
+        },
+        {
+            "label": "trapz",
+            "url": "./trapz"
+        },
+        {
+            "label": "cumtrapz",
+            "url": "./cumtrapz"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/math/optim/quad.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/math/optim/quad.rs"
+    },
+    "key": "quad",
+    "slug": "quad",
+    "aliases": [],
+    "categoryPath": [
+        "math",
+        "optim"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=quad.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"quad.js","sourceRoot":"","sources":["../../../src/generated/builtins/quad.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,MAAM;IACf,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE;QACV,MAAM;QACN,uBAAuB;QACvB,kBAAkB;QAClB,YAAY;QACZ,iBAAiB;KAClB;IACD,SAAS,EAAE,mFAAmF;IAC9F,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,oCAAoC;QAC5C,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,qQAAqQ;IACpR,WAAW,EAAE;QACX,qIAAqI;QACrI,6HAA6H;QAC7H,yGAAyG;QACzG,6HAA6H;QAC7H,kFAAkF;QAClF,yHAAyH;QACzH,oHAAoH;QACpH,kDAAkD;KACnD;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,qCAAqC;YACpD,OAAO,EAAE,uBAAuB;YAChC,QAAQ,EAAE,iBAAiB;SAC5B;QACD;YACE,aAAa,EAAE,sCAAsC;YACrD,OAAO,EAAE,mCAAmC;YAC5C,QAAQ,EAAE,iBAAiB;SAC5B;QACD;YACE,aAAa,EAAE,4CAA4C;YAC3D,OAAO,EAAE,wCAAwC;YACjD,QAAQ,EAAE,iBAAiB;SAC5B;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,uCAAuC;YACnD,QAAQ,EAAE,kGAAkG;SAC7G;QACD;YACE,UAAU,EAAE,qCAAqC;YACjD,QAAQ,EAAE,+FAA+F;SAC1G;QACD;YACE,UAAU,EAAE,2BAA2B;YACvC,QAAQ,EAAE,iKAAiK;SAC5K;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;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,yDAAyD;QAClE,KAAK,EAAE,sGAAsG;KAC9G;IACD,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IACd,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,OAAO;KACR;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/rad2deg.js

@@ -12,7 +12,6 @@ const builtinDoc = {
         "elementwise"
     ],
     "summary": "Convert angle values from radians to degrees with MATLAB-compatible array behavior.",
-    "references": [],
     "gpu_support": {
         "elementwise": true,
         "reduction": false,

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

@@ -1 +1 @@
-{"version":3,"file":"rad2deg.js","sourceRoot":"","sources":["../../../src/generated/builtins/rad2deg.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,mBAAmB;IAC/B,UAAU,EAAE;QACV,SAAS;QACT,SAAS;QACT,SAAS;QACT,OAAO;QACP,cAAc;QACd,aAAa;KACd;IACD,SAAS,EAAE,qFAAqF;IAChG,YAAY,EAAE,EAAE;IAChB,aAAa,EAAE;QACb,aAAa,EAAE,IAAI;QACnB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;YACL,KAAK;SACN;QACD,cAAc,EAAE,QAAQ;QACxB,OAAO,EAAE,qJAAqJ;KAC/J;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,IAAI;QACnB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;KACtB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,8CAA8C;QACtD,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,iNAAiN;IAChO,WAAW,EAAE;QACX,uEAAuE;QACvE,gFAAgF;QAChF,yFAAyF;QACzF,uCAAuC;QACvC,iEAAiE;KAClE;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,2BAA2B;YAC1C,OAAO,EAAE,iBAAiB;YAC1B,QAAQ,EAAE,SAAS;SACpB;QACD;YACE,aAAa,EAAE,+BAA+B;YAC9C,OAAO,EAAE,wDAAwD;YACjE,QAAQ,EAAE,qBAAqB;SAChC;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,2CAA2C;YACvD,QAAQ,EAAE,mEAAmE;SAC9E;QACD;YACE,UAAU,EAAE,sCAAsC;YAClD,QAAQ,EAAE,mFAAmF;SAC9F;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,mEAAmE;QAC5E,KAAK,EAAE,gHAAgH;KACxH;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,cAAc;KACf;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"rad2deg.js","sourceRoot":"","sources":["../../../src/generated/builtins/rad2deg.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,mBAAmB;IAC/B,UAAU,EAAE;QACV,SAAS;QACT,SAAS;QACT,SAAS;QACT,OAAO;QACP,cAAc;QACd,aAAa;KACd;IACD,SAAS,EAAE,qFAAqF;IAChG,aAAa,EAAE;QACb,aAAa,EAAE,IAAI;QACnB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;YACL,KAAK;SACN;QACD,cAAc,EAAE,QAAQ;QACxB,OAAO,EAAE,qJAAqJ;KAC/J;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,IAAI;QACnB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;KACtB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,8CAA8C;QACtD,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,iNAAiN;IAChO,WAAW,EAAE;QACX,uEAAuE;QACvE,gFAAgF;QAChF,yFAAyF;QACzF,uCAAuC;QACvC,iEAAiE;KAClE;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,2BAA2B;YAC1C,OAAO,EAAE,iBAAiB;YAC1B,QAAQ,EAAE,SAAS;SACpB;QACD;YACE,aAAa,EAAE,+BAA+B;YAC9C,OAAO,EAAE,wDAAwD;YACjE,QAAQ,EAAE,qBAAqB;SAChC;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,2CAA2C;YACvD,QAAQ,EAAE,mEAAmE;SAC9E;QACD;YACE,UAAU,EAAE,sCAAsC;YAClD,QAAQ,EAAE,mFAAmF;SAC9F;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,mEAAmE;QAC5E,KAAK,EAAE,gHAAgH;KACxH;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,cAAc;KACf;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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