runmat 0.6.1 → 0.6.2-dev.1

package/dist/generated/builtins/normpdf.js

@@ -15,10 +15,11 @@ const builtinDoc = {
         "elementwise": false,
         "reduction": false,
         "precisions": [
+            "f32",
             "f64"
         ],
         "broadcasting": "elementwise",
-        "notes": "GPU inputs are gathered to host for compatibility until a provider hook exists."
+        "notes": "Resident inputs use checked host fallback and return through the exact owner only when it can preserve the required single/double class. Incompatible automatic residency may finish on host; incompatible explicit gpuArray intent errors."
     },
     "fusion": {
         "elementwise": false,
@@ -29,11 +30,13 @@ const builtinDoc = {
     "requires_feature": null,
     "tested": {
         "unit": "builtins::stats::summary::distributions::tests",
-        "integration": null
+        "integration": "crates/runmat-vm/tests/integer_normal_distribution_and_regression_semantics.rs"
     },
     "description": "`normpdf(x)` evaluates the standard normal density. `normpdf(x,mu)` and `normpdf(x,mu,sigma)` evaluate a normal distribution with mean `mu` and standard deviation `sigma`.",
     "behaviors": [
         "`x`, `mu`, and `sigma` may be scalars or matching-size numeric arrays.",
+        "MATLAB-compatible numeric inputs are single or double. Typed integers and logical values in any numeric role are independently gated RunMat extensions.",
+        "Admitted integer values must be exactly representable as double. Any single floating input selects single output; otherwise output is double.",
         "Nonpositive `sigma` values produce `NaN` elementwise."
     ],
     "examples": [

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

@@ -1 +1 @@
-{"version":3,"file":"normpdf.js","sourceRoot":"","sources":["../../../src/generated/builtins/normpdf.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,eAAe;IAC3B,UAAU,EAAE;QACV,SAAS;QACT,QAAQ;QACR,UAAU;QACV,KAAK;QACL,YAAY;KACb;IACD,SAAS,EAAE,mDAAmD;IAC9D,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;SACN;QACD,cAAc,EAAE,aAAa;QAC7B,OAAO,EAAE,iFAAiF;KAC3F;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,MAAM;KACpB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,gDAAgD;QACxD,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,6KAA6K;IAC5L,WAAW,EAAE;QACX,wEAAwE;QACxE,uDAAuD;KACxD;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,yBAAyB;YACxC,OAAO,EAAE,gBAAgB;SAC1B;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,mCAAmC;YAC/C,QAAQ,EAAE,gFAAgF;SAC3F;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,qEAAqE;QAC9E,KAAK,EAAE,kHAAkH;KAC1H;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"normpdf.js","sourceRoot":"","sources":["../../../src/generated/builtins/normpdf.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,eAAe;IAC3B,UAAU,EAAE;QACV,SAAS;QACT,QAAQ;QACR,UAAU;QACV,KAAK;QACL,YAAY;KACb;IACD,SAAS,EAAE,mDAAmD;IAC9D,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;YACL,KAAK;SACN;QACD,cAAc,EAAE,aAAa;QAC7B,OAAO,EAAE,6OAA6O;KACvP;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,MAAM;KACpB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,gDAAgD;QACxD,aAAa,EAAE,gFAAgF;KAChG;IACD,aAAa,EAAE,6KAA6K;IAC5L,WAAW,EAAE;QACX,wEAAwE;QACxE,yJAAyJ;QACzJ,+IAA+I;QAC/I,uDAAuD;KACxD;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,yBAAyB;YACxC,OAAO,EAAE,gBAAgB;SAC1B;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,mCAAmC;YAC/C,QAAQ,EAAE,gFAAgF;SAC3F;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,qEAAqE;QAC9E,KAAK,EAAE,kHAAkH;KAC1H;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/normrnd.js

@@ -16,10 +16,11 @@ const builtinDoc = {
         "elementwise": false,
         "reduction": false,
         "precisions": [
+            "f32",
             "f64"
         ],
         "broadcasting": "none",
-        "notes": "Uses the provider random_normrnd hook (Philox CSPRNG + Box-Muller sampling) when an F64-precision provider is active. F32 providers and providers without the hook fall back to host generation."
+        "notes": "A resident floating mu or sigma selects its exact owning provider. A validated matching-precision random_normrnd hook stays resident; otherwise host generation restores only when the owner can preserve the required class. Incompatible automatic residency may finish on host and incompatible explicit gpuArray intent errors. Host parameters do not opportunistically use a global provider."
     },
     "fusion": {
         "elementwise": false,
@@ -30,17 +31,19 @@ const builtinDoc = {
     "requires_feature": null,
     "tested": {
         "unit": "builtins::stats::random::normrnd::tests",
-        "integration": null
+        "integration": "crates/runmat-vm/tests/integer_normal_distribution_and_regression_semantics.rs"
     },
-    "description": "`normrnd(mu, sigma, ...)` draws pseudorandom samples from normal distributions with mean `mu` and standard deviation `sigma`. Size forms, broadcasting, and parameter validation follow MATLAB semantics.",
+    "description": "`normrnd(mu, sigma, ...)` draws pseudorandom samples from a normal distribution with scalar mean `mu` and standard deviation `sigma`. Scalar and vector size forms control the output shape.",
     "behaviors": [
-        "`normrnd(mu, sigma)` returns a scalar double drawn from `N(mu, sigma^2)`.",
+        "`normrnd(mu, sigma)` returns a scalar drawn from `N(mu, sigma^2)`.",
         "`normrnd(mu, sigma, n)` returns an `n × n` matrix of samples.",
         "`normrnd(mu, sigma, m, n)` returns an `m × n` matrix of samples.",
         "`normrnd(mu, sigma, sz)` accepts a size vector and returns an array with shape `sz`.",
         "`mu` and `sigma` must be scalar numeric values.",
+        "Current MATLAB documents single and double mu, sigma, and size values. Typed-integer and logical inputs are independently gated RunMat extensions; integer parameters must be exactly representable at the binary64 sampling boundary.",
+        "Integer size controls are parsed structurally and do not select output class or residency. Explicit resident size controls are a separate RunMat extension.",
         "`sigma` must be non-negative; `normrnd` errors if `sigma < 0`.",
-        "All outputs are double precision regardless of input type."
+        "Any single mu or sigma selects single output; otherwise output is double. A resident data parameter preserves output residency through its exact owner."
     ],
     "examples": [
         {

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

@@ -1 +1 @@
-{"version":3,"file":"normrnd.js","sourceRoot":"","sources":["../../../src/generated/builtins/normrnd.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,cAAc;IAC1B,UAAU,EAAE;QACV,SAAS;QACT,QAAQ;QACR,UAAU;QACV,QAAQ;QACR,cAAc;QACd,YAAY;KACb;IACD,SAAS,EAAE,oEAAoE;IAC/E,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;SACN;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,kMAAkM;KAC5M;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,MAAM;KACpB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,yCAAyC;QACjD,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,2MAA2M;IAC1N,WAAW,EAAE;QACX,2EAA2E;QAC3E,+DAA+D;QAC/D,kEAAkE;QAClE,sFAAsF;QACtF,iDAAiD;QACjD,gEAAgE;QAChE,4DAA4D;KAC7D;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,4BAA4B;YAC3C,OAAO,EAAE,4BAA4B;SACtC;QACD;YACE,aAAa,EAAE,gEAAgE;YAC/E,OAAO,EAAE,mCAAmC;SAC7C;QACD;YACE,aAAa,EAAE,oDAAoD;YACnE,OAAO,EAAE,6FAA6F;SACvG;QACD;YACE,aAAa,EAAE,0CAA0C;YACzD,OAAO,EAAE,qCAAqC;SAC/C;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,4BAA4B;YACxC,QAAQ,EAAE,sJAAsJ;SACjK;QACD;YACE,UAAU,EAAE,mDAAmD;YAC/D,QAAQ,EAAE,qJAAqJ;SAChK;QACD;YACE,UAAU,EAAE,oBAAoB;YAChC,QAAQ,EAAE,6IAA6I;SACxJ;QACD;YACE,UAAU,EAAE,sCAAsC;YAClD,QAAQ,EAAE,+KAA+K;SAC1L;QACD;YACE,UAAU,EAAE,0CAA0C;YACtD,QAAQ,EAAE,4FAA4F;SACvG;QACD;YACE,UAAU,EAAE,mCAAmC;YAC/C,QAAQ,EAAE,kEAAkE;SAC7E;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;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;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,8DAA8D;QACvE,KAAK,EAAE,2GAA2G;KACnH;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,QAAQ;KACT;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"normrnd.js","sourceRoot":"","sources":["../../../src/generated/builtins/normrnd.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,cAAc;IAC1B,UAAU,EAAE;QACV,SAAS;QACT,QAAQ;QACR,UAAU;QACV,QAAQ;QACR,cAAc;QACd,YAAY;KACb;IACD,SAAS,EAAE,oEAAoE;IAC/E,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,qYAAqY;KAC/Y;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,MAAM;KACpB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,yCAAyC;QACjD,aAAa,EAAE,gFAAgF;KAChG;IACD,aAAa,EAAE,8LAA8L;IAC7M,WAAW,EAAE;QACX,oEAAoE;QACpE,+DAA+D;QAC/D,kEAAkE;QAClE,sFAAsF;QACtF,iDAAiD;QACjD,wOAAwO;QACxO,6JAA6J;QAC7J,gEAAgE;QAChE,yJAAyJ;KAC1J;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,4BAA4B;YAC3C,OAAO,EAAE,4BAA4B;SACtC;QACD;YACE,aAAa,EAAE,gEAAgE;YAC/E,OAAO,EAAE,mCAAmC;SAC7C;QACD;YACE,aAAa,EAAE,oDAAoD;YACnE,OAAO,EAAE,6FAA6F;SACvG;QACD;YACE,aAAa,EAAE,0CAA0C;YACzD,OAAO,EAAE,qCAAqC;SAC/C;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,4BAA4B;YACxC,QAAQ,EAAE,sJAAsJ;SACjK;QACD;YACE,UAAU,EAAE,mDAAmD;YAC/D,QAAQ,EAAE,qJAAqJ;SAChK;QACD;YACE,UAAU,EAAE,oBAAoB;YAChC,QAAQ,EAAE,6IAA6I;SACxJ;QACD;YACE,UAAU,EAAE,sCAAsC;YAClD,QAAQ,EAAE,+KAA+K;SAC1L;QACD;YACE,UAAU,EAAE,0CAA0C;YACtD,QAAQ,EAAE,4FAA4F;SACvG;QACD;YACE,UAAU,EAAE,mCAAmC;YAC/C,QAAQ,EAAE,kEAAkE;SAC7E;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;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;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,8DAA8D;QACvE,KAAK,EAAE,2GAA2G;KACnH;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,QAAQ;KACT;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/not.js

@@ -38,7 +38,7 @@ const builtinDoc = {
         "Works on scalars, vectors, matrices, and N-D tensors with MATLAB broadcasting semantics.",
         "Accepts logical, numeric, complex, and character arrays. Character code points equal to zero become `true`, all others become `false`.",
         "Returns a logical scalar when the input has exactly one element; otherwise the result is a logical array matching the input shape.",
-        "Honors gpuArray residency. If the active acceleration provider exposes `logical_not`, the entire operation runs on the GPU; otherwise RunMat falls back to the CPU path automatically.",
+        "If the active acceleration provider exposes a compatible floating `logical_not` hook, the operation runs on the GPU. Native integer handles use exact gather fallback; automatic residency may return to host, while explicit gpuArray inputs restore a logical gpuArray result.",
         "`NaN` evaluates to `true`, so `not(NaN)` produces `false`, consistent with MATLAB."
     ],
     "examples": [
@@ -79,7 +79,7 @@ const builtinDoc = {
         },
         {
             "question": "Can I pass a `gpuArray` to `not`?",
-            "answer": "Absolutely. If the provider implements `logical_not`, the negation runs entirely on the GPU. Otherwise the runtime gathers to the host, performs the operation, and returns a logical array."
+            "answer": "Yes. Compatible floating providers run the negation on the GPU. Exact fallback gathers automatically; explicitly requested gpuArray inputs are re-uploaded as logical gpuArrays, while internal automatic residency may remain on host."
         },
         {
             "question": "What happens with empty arrays?",

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

@@ -1 +1 @@
-{"version":3,"file":"not.js","sourceRoot":"","sources":["../../../src/generated/builtins/not.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,KAAK;IACd,UAAU,EAAE,aAAa;IACzB,UAAU,EAAE;QACV,aAAa;QACb,kBAAkB;QAClB,cAAc;QACd,YAAY;QACZ,gBAAgB;KACjB;IACD,SAAS,EAAE,6DAA6D;IACxE,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,oHAAoH;KAC9H;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,oCAAoC;QAC5C,aAAa,EAAE,uDAAuD;QACtE,KAAK,EAAE,gEAAgE;KACxE;IACD,aAAa,EAAE,qIAAqI;IACpJ,WAAW,EAAE;QACX,0FAA0F;QAC1F,wIAAwI;QACxI,oIAAoI;QACpI,wLAAwL;QACxL,oFAAoF;KACrF;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,oCAAoC;YACnD,OAAO,EAAE,iBAAiB;YAC1B,QAAQ,EAAE,kBAAkB;SAC7B;QACD;YACE,aAAa,EAAE,gDAAgD;YAC/D,OAAO,EAAE,oDAAoD;YAC7D,QAAQ,EAAE,wDAAwD;SACnE;QACD;YACE,aAAa,EAAE,mDAAmD;YAClE,OAAO,EAAE,4BAA4B;YACrC,QAAQ,EAAE,oDAAoD;SAC/D;QACD;YACE,aAAa,EAAE,2CAA2C;YAC1D,OAAO,EAAE,0CAA0C;YACnD,QAAQ,EAAE,kDAAkD;SAC7D;QACD;YACE,aAAa,EAAE,4CAA4C;YAC3D,OAAO,EAAE,qFAAqF;YAC9F,QAAQ,EAAE,qIAAqI;SAChJ;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,mCAAmC;YAC/C,QAAQ,EAAE,yIAAyI;SACpJ;QACD;YACE,UAAU,EAAE,gDAAgD;YAC5D,QAAQ,EAAE,yHAAyH;SACpI;QACD;YACE,UAAU,EAAE,mCAAmC;YAC/C,QAAQ,EAAE,8LAA8L;SACzM;QACD;YACE,UAAU,EAAE,iCAAiC;YAC7C,QAAQ,EAAE,kHAAkH;SAC7H;QACD;YACE,UAAU,EAAE,kDAAkD;YAC9D,QAAQ,EAAE,mJAAmJ;SAC9J;QACD;YACE,UAAU,EAAE,uCAAuC;YACnD,QAAQ,EAAE,kJAAkJ;SAC7J;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,MAAM;SACd;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;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,yDAAyD;QAClE,KAAK,EAAE,sGAAsG;KAC9G;IACD,eAAe,EAAE,mbAAmb;IACpc,cAAc,EAAE;QACd,6YAA6Y;KAC9Y;IACD,KAAK,EAAE,KAAK;IACZ,MAAM,EAAE,KAAK;IACb,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,SAAS;QACT,KAAK;KACN;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"not.js","sourceRoot":"","sources":["../../../src/generated/builtins/not.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,KAAK;IACd,UAAU,EAAE,aAAa;IACzB,UAAU,EAAE;QACV,aAAa;QACb,kBAAkB;QAClB,cAAc;QACd,YAAY;QACZ,gBAAgB;KACjB;IACD,SAAS,EAAE,6DAA6D;IACxE,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,oHAAoH;KAC9H;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,oCAAoC;QAC5C,aAAa,EAAE,uDAAuD;QACtE,KAAK,EAAE,gEAAgE;KACxE;IACD,aAAa,EAAE,qIAAqI;IACpJ,WAAW,EAAE;QACX,0FAA0F;QAC1F,wIAAwI;QACxI,oIAAoI;QACpI,kRAAkR;QAClR,oFAAoF;KACrF;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,oCAAoC;YACnD,OAAO,EAAE,iBAAiB;YAC1B,QAAQ,EAAE,kBAAkB;SAC7B;QACD;YACE,aAAa,EAAE,gDAAgD;YAC/D,OAAO,EAAE,oDAAoD;YAC7D,QAAQ,EAAE,wDAAwD;SACnE;QACD;YACE,aAAa,EAAE,mDAAmD;YAClE,OAAO,EAAE,4BAA4B;YACrC,QAAQ,EAAE,oDAAoD;SAC/D;QACD;YACE,aAAa,EAAE,2CAA2C;YAC1D,OAAO,EAAE,0CAA0C;YACnD,QAAQ,EAAE,kDAAkD;SAC7D;QACD;YACE,aAAa,EAAE,4CAA4C;YAC3D,OAAO,EAAE,qFAAqF;YAC9F,QAAQ,EAAE,qIAAqI;SAChJ;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,mCAAmC;YAC/C,QAAQ,EAAE,yIAAyI;SACpJ;QACD;YACE,UAAU,EAAE,gDAAgD;YAC5D,QAAQ,EAAE,yHAAyH;SACpI;QACD;YACE,UAAU,EAAE,mCAAmC;YAC/C,QAAQ,EAAE,yOAAyO;SACpP;QACD;YACE,UAAU,EAAE,iCAAiC;YAC7C,QAAQ,EAAE,kHAAkH;SAC7H;QACD;YACE,UAAU,EAAE,kDAAkD;YAC9D,QAAQ,EAAE,mJAAmJ;SAC9J;QACD;YACE,UAAU,EAAE,uCAAuC;YACnD,QAAQ,EAAE,kJAAkJ;SAC7J;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,MAAM;SACd;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;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,yDAAyD;QAClE,KAAK,EAAE,sGAAsG;KAC9G;IACD,eAAe,EAAE,mbAAmb;IACpc,cAAc,EAAE;QACd,6YAA6Y;KAC9Y;IACD,KAAK,EAAE,KAAK;IACZ,MAAM,EAAE,KAAK;IACb,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,SAAS;QACT,KAAK;KACN;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/notify.js

@@ -0,0 +1,58 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "notify",
+    "category": "introspection",
+    "keywords": [
+        "notify",
+        "events",
+        "listeners",
+        "handle"
+    ],
+    "summary": "Notify listeners that a handle-object event is occurring.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "Event dispatch operates on host object metadata and does not inspect or gather numeric payloads."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::introspection::notify::tests and runtime event-registry tests",
+        "integration": null
+    },
+    "description": "`notify(H, EventName)` notifies listeners registered for the named event on a handle object. An optional event-data object is passed to listener callbacks.",
+    "behaviors": [
+        "The documented target is a handle object and the event name is case-sensitive text defined by its class.",
+        "The documented optional data argument is an `event.EventData` subclass object. Application integer fields nested inside that object remain ordinary exact object payloads.",
+        "Integer scalars, arrays, and resident numeric handles have no direct target, event-name, data-control, output-class, or backend role; `notify` is therefore explicitly integer-inapplicable.",
+        "RunMat's current event subsystem retains broader callback-argument and status-return conveniences as general compatibility work; they are not treated as MATLAB integer forms."
+    ],
+    "examples": [
+        {
+            "description": "Notify listeners of an event",
+            "input": "notify(source, 'Changed')"
+        }
+    ],
+    "faqs": [],
+    "links": [],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/introspection/notify.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/introspection/notify.rs"
+    },
+    "key": "notify",
+    "slug": "notify",
+    "aliases": [],
+    "categoryPath": [
+        "introspection"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=notify.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"notify.js","sourceRoot":"","sources":["../../../src/generated/builtins/notify.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,QAAQ;IACjB,UAAU,EAAE,eAAe;IAC3B,UAAU,EAAE;QACV,QAAQ;QACR,QAAQ;QACR,WAAW;QACX,QAAQ;KACT;IACD,SAAS,EAAE,2DAA2D;IACtE,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,kGAAkG;KAC5G;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,yEAAyE;QACjF,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,6JAA6J;IAC5K,WAAW,EAAE;QACX,0GAA0G;QAC1G,4KAA4K;QAC5K,8LAA8L;QAC9L,gLAAgL;KACjL;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,8BAA8B;YAC7C,OAAO,EAAE,2BAA2B;SACrC;KACF;IACD,MAAM,EAAE,EAAE;IACV,OAAO,EAAE,EAAE;IACX,QAAQ,EAAE;QACR,OAAO,EAAE,8DAA8D;QACvE,KAAK,EAAE,2GAA2G;KACnH;IACD,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,eAAe;KAChB;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/null.js

@@ -21,7 +21,7 @@ const builtinDoc = {
             "f64"
         ],
         "broadcasting": "none",
-        "notes": "GPU inputs are gathered to the host null-space implementation. Real bases are re-uploaded when a provider is available; upload failures return the host result."
+        "notes": "Real floating GPU inputs are gathered through their exact owning provider and the basis is restored to that same owner with its computed floating class and source provenance. The rational basis form rejects GPU input before fallback."
     },
     "fusion": {
         "elementwise": false,
@@ -34,13 +34,15 @@ const builtinDoc = {
         "unit": "builtins::math::linalg::solve::null::tests",
         "integration": "core::tests::null_row_reduction_builtin_uses_semantic_vm"
     },
-    "description": "`null(A)` returns an orthonormal basis for the null space of a real or complex numeric matrix. `null(A, tol)` uses a caller-provided finite, non-negative rank tolerance. `null(A, 'r')` returns a row-reduction basis useful for simple exact-looking dependencies.",
+    "description": "`null(A)` returns an orthonormal basis for the null space of a real or complex numeric matrix. `null(A, tol)` uses a caller-provided finite, non-negative rank tolerance. `null(A, \"rational\")` returns a row-reduction basis useful for simple exact-looking dependencies; RunMat also accepts `\"r\"` as a legacy alias.",
     "behaviors": [
         "Inputs must behave like 2-D matrices. Trailing singleton dimensions are accepted; other higher-rank inputs raise `RunMat:null:InvalidInput`.",
         "`null(A)` computes the default rank tolerance from the singular values as `max(size(A)) * eps(max(svd(A)))`, then returns an orthonormal basis for singular directions at or below that cutoff.",
         "`null(A, tol)` uses `tol` as the rank threshold and returns the corresponding orthonormal null-space basis.",
-        "`null(A, 'r')` accepts either char or string scalar options and returns the free-variable basis derived from reduced row echelon form.",
-        "Logical and integer inputs are promoted to double precision before null-space evaluation.",
+        "`null(A, \"rational\")` accepts either char or string scalar options and returns the free-variable basis derived from reduced row echelon form; `\"r\"` is retained as a legacy alias.",
+        "The documented matrix domain is single or double. Native integer and logical matrices are separately gated RunMat extensions; integer values must be exactly representable before the double SVD or row-reduction boundary.",
+        "A native integer tolerance is a documented real numeric scalar control and must be exactly representable before the floating rank comparison.",
+        "Real and complex single inputs return single bases. Double and accepted integer/logical inputs return double bases.",
         "Real and complex orthonormal bases use SVD rank decisions and right singular vectors where available; wide matrices complete the orthogonal complement so the full nullity is returned even when the underlying SVD implementation is thin.",
         "Complex inputs return complex null-space bases and use complex row reduction for the `'r'` option.",
         "Full-rank matrices return an empty `n x 0` basis where `n` is the input column count. A `0 x n` matrix returns an `n x n` identity basis."
@@ -53,7 +55,7 @@ const builtinDoc = {
         },
         {
             "description": "Row-reduction basis",
-            "input": "A = [1 2 3; 2 4 6];\nZ = null(A, 'r')",
+            "input": "A = [1 2 3; 2 4 6];\nZ = null(A, \"rational\")",
             "output": "Z = [-2 -3; 1 0; 0 1]"
         },
         {
@@ -64,12 +66,12 @@ const builtinDoc = {
     ],
     "faqs": [
         {
-            "question": "What is the difference between `null(A)` and `null(A, 'r')`?",
-            "answer": "`null(A)` returns an orthonormal basis. `null(A, 'r')` returns a row-reduction basis where free variables are set to identity columns, so the result is often easier to read for simple dependent systems."
+            "question": "What is the difference between `null(A)` and `null(A, \"rational\")`?",
+            "answer": "`null(A)` returns an orthonormal basis. `null(A, \"rational\")` returns a row-reduction basis where free variables are set to identity columns, so the result is often easier to read for simple dependent systems."
         },
         {
             "question": "Does `null` preserve GPU residency?",
-            "answer": "When the input is a real gpuArray, RunMat gathers it to the host, computes the basis, and re-uploads the real result if a provider is available."
+            "answer": "For the orthonormal form, RunMat gathers a real gpuArray through its exact owner and restores the result to that owner with matching explicit or automatic provenance. The rational form does not support gpuArray input."
         },
         {
             "question": "How is the default tolerance chosen?",
@@ -98,9 +100,9 @@ const builtinDoc = {
         "label": "`crates/runmat-runtime/src/builtins/math/linalg/solve/null.rs`",
         "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/math/linalg/solve/null.rs"
     },
-    "gpu_residency": "When the input is a real gpuArray, RunMat gathers it, computes the null-space basis on the host, and re-uploads the basis if a provider is available. If upload fails, the host tensor is returned.",
+    "gpu_residency": "The orthonormal form gathers a real gpuArray non-destructively through its exact owner and restores a class-correct basis to that owner. Automatic residency may fall back to a host value when the computed floating class cannot be represented; explicit gpuArray intent is terminal instead of being silently lost.",
     "gpu_behavior": [
-        "`null` is an eager solve-style operation. It terminates fusion plans and gathers GPU-resident inputs for null-space evaluation."
+        "`null` is an eager solve-style operation. It terminates fusion plans and gathers supported GPU-resident inputs for null-space evaluation without consulting an unrelated ambient provider."
     ],
     "key": "null",
     "slug": "null",

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

@@ -1 +1 @@
-{"version":3,"file":"null.js","sourceRoot":"","sources":["../../../src/generated/builtins/null.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,YAAY;QACZ,QAAQ;QACR,MAAM;QACN,KAAK;QACL,MAAM;QACN,aAAa;KACd;IACD,SAAS,EAAE,0CAA0C;IACrD,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,iKAAiK;KAC3K;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,0DAA0D;KAC1E;IACD,aAAa,EAAE,sQAAsQ;IACrR,WAAW,EAAE;QACX,8IAA8I;QAC9I,iMAAiM;QACjM,6GAA6G;QAC7G,wIAAwI;QACxI,2FAA2F;QAC3F,6OAA6O;QAC7O,oGAAoG;QACpG,2IAA2I;KAC5I;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,8BAA8B;YAC7C,OAAO,EAAE,8BAA8B;YACvC,QAAQ,EAAE,gEAAgE;SAC3E;QACD;YACE,aAAa,EAAE,qBAAqB;YACpC,OAAO,EAAE,uCAAuC;YAChD,QAAQ,EAAE,uBAAuB;SAClC;QACD;YACE,aAAa,EAAE,0BAA0B;YACzC,OAAO,EAAE,yCAAyC;YAClD,QAAQ,EAAE,YAAY;SACvB;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,8DAA8D;YAC1E,QAAQ,EAAE,4MAA4M;SACvN;QACD;YACE,UAAU,EAAE,qCAAqC;YACjD,QAAQ,EAAE,kJAAkJ;SAC7J;QACD;YACE,UAAU,EAAE,sCAAsC;YAClD,QAAQ,EAAE,oIAAoI;SAC/I;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,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,gEAAgE;QACzE,KAAK,EAAE,6GAA6G;KACrH;IACD,eAAe,EAAE,qMAAqM;IACtN,cAAc,EAAE;QACd,iIAAiI;KAClI;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":"null.js","sourceRoot":"","sources":["../../../src/generated/builtins/null.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,YAAY;QACZ,QAAQ;QACR,MAAM;QACN,KAAK;QACL,MAAM;QACN,aAAa;KACd;IACD,SAAS,EAAE,0CAA0C;IACrD,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,2OAA2O;KACrP;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,0DAA0D;KAC1E;IACD,aAAa,EAAE,8TAA8T;IAC7U,WAAW,EAAE;QACX,8IAA8I;QAC9I,iMAAiM;QACjM,6GAA6G;QAC7G,wLAAwL;QACxL,6NAA6N;QAC7N,+IAA+I;QAC/I,qHAAqH;QACrH,6OAA6O;QAC7O,oGAAoG;QACpG,2IAA2I;KAC5I;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,8BAA8B;YAC7C,OAAO,EAAE,8BAA8B;YACvC,QAAQ,EAAE,gEAAgE;SAC3E;QACD;YACE,aAAa,EAAE,qBAAqB;YACpC,OAAO,EAAE,gDAAgD;YACzD,QAAQ,EAAE,uBAAuB;SAClC;QACD;YACE,aAAa,EAAE,0BAA0B;YACzC,OAAO,EAAE,yCAAyC;YAClD,QAAQ,EAAE,YAAY;SACvB;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,uEAAuE;YACnF,QAAQ,EAAE,qNAAqN;SAChO;QACD;YACE,UAAU,EAAE,qCAAqC;YACjD,QAAQ,EAAE,2NAA2N;SACtO;QACD;YACE,UAAU,EAAE,sCAAsC;YAClD,QAAQ,EAAE,oIAAoI;SAC/I;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,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,gEAAgE;QACzE,KAAK,EAAE,6GAA6G;KACrH;IACD,eAAe,EAAE,yTAAyT;IAC1U,cAAc,EAAE;QACd,4LAA4L;KAC7L;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/num2str.d.ts.map

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

package/dist/generated/builtins/num2str.js

@@ -16,7 +16,7 @@ const builtinDoc = {
         "reduction": false,
         "precisions": [],
         "broadcasting": "none",
-        "notes": "Always formats on the CPU. GPU tensors are gathered to host memory before conversion."
+        "notes": "Formatting runs on the CPU. Automatic residency gathers transparently; explicit gpuArray host fallback is a declared RunMat extension."
     },
     "fusion": {
         "elementwise": false,
@@ -27,7 +27,7 @@ const builtinDoc = {
     "requires_feature": null,
     "tested": {
         "unit": "builtins::strings::core::num2str::tests",
-        "integration": "builtins::strings::core::num2str::tests::num2str_gpu_tensor_roundtrip"
+        "integration": "crates/runmat-vm/tests/integer_label_and_text_control_semantics.rs"
     },
     "description": "`num2str(X, ...)` converts numeric values to character arrays using default or custom formatting. Precision, complex formatting, and row-wise matrix output behavior follow MATLAB semantics.",
     "behaviors": [
@@ -37,6 +37,8 @@ const builtinDoc = {
         "A trailing `'local'` argument switches the decimal separator to the one inferred from the active locale (or the `RUNMAT_DECIMAL_SEPARATOR` environment variable).",
         "Vector inputs return single-row character arrays; matrices return one textual row per numeric row.",
         "Empty matrices return empty character arrays that match MATLAB's dimension rules.",
+        "All eight integer classes and logical input are accepted. Integer values are formatted from native storage, including values outside the exact binary64 range.",
+        "The numeric precision argument accepts every integer class and is validated exactly before conversion to a formatting control.",
         "Non-numeric types raise MATLAB-compatible errors."
     ],
     "examples": [

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

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

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

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

package/dist/generated/builtins/numArgumentsFromSubscript.js

@@ -38,6 +38,7 @@ const builtinDoc = {
         "Scalar structs describe one indexing level. Compound substruct arrays are accepted through RunMat's struct-array cell representation, where each cell element is a scalar struct with `type` and `subs` fields.",
         "Object and handle-object targets dispatch to the receiver class's `numArgumentsFromSubscript` method when it is registered. If no overload exists, RunMat falls back to default array behavior.",
         "For ordinary arrays, parentheses and dot indexing report one argument. Brace indexing reports the number of selected elements, including validated numeric vector selectors, logical selectors, `':'`, and multidimensional selector products.",
+        "All eight integer target classes and integer scalar/vector subscripts use authoritative shape or typed element storage. Wide positive `uint64` selectors are validated without binary64 conversion, and the structural result crosses to the documented double scalar only when exactly representable.",
         "`matlab.indexing.IndexingContext.Statement`, `.Expression`, and `.Assignment` are registered lazily when used through `classref`, and the legacy `matlab.mixin.util.IndexingContext` class name resolves to equivalent enum members.",
         "RunMat also accepts compatible text tokens such as `'Statement'` and `'matlab.indexing.IndexingContext.Expression'` for integration with code that constructs context values dynamically.",
         "Invalid substructs and unsupported context values raise stable `RunMat:numArgumentsFromSubscript:*` identifiers."

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

@@ -1 +1 @@
-{"version":3,"file":"numArgumentsFromSubscript.js","sourceRoot":"","sources":["../../../src/generated/builtins/numArgumentsFromSubscript.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,2BAA2B;IACpC,UAAU,EAAE,cAAc;IAC1B,UAAU,EAAE;QACV,2BAA2B;QAC3B,WAAW;QACX,SAAS;QACT,UAAU;QACV,iBAAiB;QACjB,iBAAiB;KAClB;IACD,SAAS,EAAE,wFAAwF;IACnG,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,mIAAmI;KAC7I;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,iDAAiD;QACzD,aAAa,EAAE,kFAAkF;KAClG;IACD,aAAa,EAAE,qZAAqZ;IACpa,WAAW,EAAE;QACX,iFAAiF;QACjF,6FAA6F;QAC7F,wGAAwG;QACxG,iNAAiN;QACjN,iMAAiM;QACjM,gPAAgP;QAChP,sOAAsO;QACtO,2LAA2L;QAC3L,kHAAkH;KACnH;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,mCAAmC;YAClD,OAAO,EAAE,kIAAkI;YAC3I,QAAQ,EAAE,OAAO;SAClB;QACD;YACE,aAAa,EAAE,8BAA8B;YAC7C,OAAO,EAAE,sLAAsL;YAC/L,QAAQ,EAAE,OAAO;SAClB;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,sDAAsD;YAClE,QAAQ,EAAE,kJAAkJ;SAC7J;QACD;YACE,UAAU,EAAE,uCAAuC;YACnD,QAAQ,EAAE,mKAAmK;SAC9K;QACD;YACE,UAAU,EAAE,iCAAiC;YAC7C,QAAQ,EAAE,8MAA8M;SACzN;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;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,uEAAuE;QAChF,KAAK,EAAE,oHAAoH;KAC5H;IACD,eAAe,EAAE,+IAA+I;IAChK,cAAc,EAAE;QACd,kGAAkG;QAClG,mJAAmJ;KACpJ;IACD,KAAK,EAAE,2BAA2B;IAClC,MAAM,EAAE,2BAA2B;IACnC,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,KAAK;QACL,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"numArgumentsFromSubscript.js","sourceRoot":"","sources":["../../../src/generated/builtins/numArgumentsFromSubscript.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,2BAA2B;IACpC,UAAU,EAAE,cAAc;IAC1B,UAAU,EAAE;QACV,2BAA2B;QAC3B,WAAW;QACX,SAAS;QACT,UAAU;QACV,iBAAiB;QACjB,iBAAiB;KAClB;IACD,SAAS,EAAE,wFAAwF;IACnG,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,mIAAmI;KAC7I;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,iDAAiD;QACzD,aAAa,EAAE,kFAAkF;KAClG;IACD,aAAa,EAAE,qZAAqZ;IACpa,WAAW,EAAE;QACX,iFAAiF;QACjF,6FAA6F;QAC7F,wGAAwG;QACxG,iNAAiN;QACjN,iMAAiM;QACjM,gPAAgP;QAChP,wSAAwS;QACxS,sOAAsO;QACtO,2LAA2L;QAC3L,kHAAkH;KACnH;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,mCAAmC;YAClD,OAAO,EAAE,kIAAkI;YAC3I,QAAQ,EAAE,OAAO;SAClB;QACD;YACE,aAAa,EAAE,8BAA8B;YAC7C,OAAO,EAAE,sLAAsL;YAC/L,QAAQ,EAAE,OAAO;SAClB;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,sDAAsD;YAClE,QAAQ,EAAE,kJAAkJ;SAC7J;QACD;YACE,UAAU,EAAE,uCAAuC;YACnD,QAAQ,EAAE,mKAAmK;SAC9K;QACD;YACE,UAAU,EAAE,iCAAiC;YAC7C,QAAQ,EAAE,8MAA8M;SACzN;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;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,uEAAuE;QAChF,KAAK,EAAE,oHAAoH;KAC5H;IACD,eAAe,EAAE,+IAA+I;IAChK,cAAc,EAAE;QACd,kGAAkG;QAClG,mJAAmJ;KACpJ;IACD,KAAK,EAAE,2BAA2B;IAClC,MAAM,EAAE,2BAA2B;IACnC,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,KAAK;QACL,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/numel.js

@@ -32,11 +32,11 @@ const builtinDoc = {
     "description": "`numel(A)` returns the number of elements contained in `A`. Supported value classes and return-type behavior follow MATLAB semantics.",
     "behaviors": [
         "`numel(A)` counts every stored element; for matrices this is `prod(size(A))`.",
-        "`numel(A, dim1, dim2, ...)` multiplies the extents of the requested dimensions. Each dimension argument must be a positive integer. Dimensions beyond the array rank contribute a factor of `1`.",
-        "Passing a numeric vector of dimensions (for example `numel(A, [1 3])`) is equivalent to listing them separately.",
+        "MATLAB's public syntax is `numel(A)` only. RunMat's additional `numel(A, dim1, dim2, ...)` and dimension-vector forms are one named RunMat extension and reject in MATLAB-compatible modes.",
+        "When the RunMat dimension extension is enabled, all eight typed integer dimension classes parse exactly as positive structural selectors; dimensions beyond the array rank contribute a factor of `1`.",
         "Scalars return `1`, character arrays report `rows × cols`, and cell arrays count the number of cells.",
         "Empty arrays return `0` when any dimension is zero.",
-        "GPU-resident arrays use metadata stored on the device handle; when unavailable, RunMat gathers the data to maintain correctness."
+        "GPU-resident arrays use coherent shape metadata stored on the device handle; payload elements are not gathered for the documented form. The exact structural count is returned as a host double only when representable without rounding."
     ],
     "examples": [
         {
@@ -72,7 +72,7 @@ const builtinDoc = {
         },
         {
             "question": "What happens when I specify dimensions?",
-            "answer": "`numel(A, dim1, dim2, ...)` multiplies the lengths of the listed dimensions. Missing dimensions (for example, requesting the fourth dimension of a matrix) contribute a factor of `1`, matching MATLAB."
+            "answer": "MATLAB documents only `numel(A)`. RunMat can multiply selected extents with `numel(A, dim1, dim2, ...)` when RunMat extensions are enabled; missing dimensions contribute a factor of `1`."
         },
         {
             "question": "Does `numel` gather GPU data?",
@@ -92,7 +92,7 @@ const builtinDoc = {
         },
         {
             "question": "Does `numel` accept non-integer dimensions?",
-            "answer": "No. Dimension arguments must be positive integers. Fractional, negative, or non-numeric values raise an error that mirrors MATLAB."
+            "answer": "Dimension arguments belong to a RunMat-only syntax. When extensions are enabled they must be positive integers; fractional, negative, or non-numeric values raise an error."
         },
         {
             "question": "What does numel do in MATLAB?",
@@ -167,7 +167,7 @@ const builtinDoc = {
         },
         "points": [
             "`A` is the input array. Any class is accepted: numeric, logical, char, string, cell, struct, or table.",
-            "`dim1, dim2, ...` are optional positive-integer subscripts. When supplied, `numel` returns the number of elements of the selected submatrix, equivalent to `numel(A(index1, index2, ...))`. This form is rarely used and is included for MathWorks parity.",
+            "`dim1, dim2, ...` are optional positive-integer structural selectors in a compatibility-gated RunMat extension; they are not part of the current public MATLAB `numel` syntax.",
             "Returns `n`, a double-precision scalar giving the total element count (or the element count of the requested subregion)."
         ]
     },

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

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

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

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

package/dist/generated/builtins/ode15s.js

@@ -16,7 +16,7 @@ const builtinDoc = {
         "reduction": false,
         "precisions": [],
         "broadcasting": "none",
-        "notes": "The stiff integrator runs on the host. RHS callback functions may still call GPU-aware builtins."
+        "notes": "The stiff integrator runs on the host. Automatic residency gathers transparently; explicit gpuArray host fallback is a gated RunMat extension. RHS callback functions may still call GPU-aware builtins."
     },
     "fusion": {
         "elementwise": false,
@@ -32,6 +32,10 @@ const builtinDoc = {
     "behaviors": [
         "Supports scalar, vector, and matrix-valued initial conditions.",
         "Accepts options as a struct, including `RelTol`, `AbsTol`, `InitialStep`, and `MaxStep`.",
+        "The documented tspan, y0, and derivative domains are single or double. Native integer and logical solver values are independently gated RunMat extensions, and every integer-to-double solver boundary requires exact representability.",
+        "Typed integer `MaxSteps` is parsed as an exact structural count; integer floating controls are checked before conversion.",
+        "The current RunMat integration loop and outputs are double even when all floating inputs are single; native-single output propagation remains a general compatibility gap rather than an integer extension.",
+        "Event outputs and solution-structure forms are not implemented by the current core solver surface.",
         "When `tspan` has more than two points, the solver returns values at each requested time.",
         "With one output, returns only the `y` trajectory matrix."
     ],

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

@@ -1 +1 @@
-{"version":3,"file":"ode15s.js","sourceRoot":"","sources":["../../../src/generated/builtins/ode15s.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,QAAQ;IACjB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,QAAQ;QACR,KAAK;QACL,OAAO;QACP,UAAU;QACV,eAAe;KAChB;IACD,SAAS,EAAE,yGAAyG;IACpH,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,kGAAkG;KAC5G;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;KAC7C;IACD,aAAa,EAAE,4KAA4K;IAC3L,WAAW,EAAE;QACX,gEAAgE;QAChE,0FAA0F;QAC1F,0FAA0F;QAC1F,0DAA0D;KAC3D;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,uCAAuC;YACtD,OAAO,EAAE,0CAA0C;YACnD,QAAQ,EAAE,8BAA8B;SACzC;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,yDAAyD;QAClE,KAAK,EAAE,sGAAsG;KAC9G;IACD,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,KAAK;KACN;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"ode15s.js","sourceRoot":"","sources":["../../../src/generated/builtins/ode15s.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,QAAQ;IACjB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,QAAQ;QACR,KAAK;QACL,OAAO;QACP,UAAU;QACV,eAAe;KAChB;IACD,SAAS,EAAE,yGAAyG;IACpH,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,0MAA0M;KACpN;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;KAC7C;IACD,aAAa,EAAE,4KAA4K;IAC3L,WAAW,EAAE;QACX,gEAAgE;QAChE,0FAA0F;QAC1F,yOAAyO;QACzO,2HAA2H;QAC3H,6MAA6M;QAC7M,oGAAoG;QACpG,0FAA0F;QAC1F,0DAA0D;KAC3D;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,uCAAuC;YACtD,OAAO,EAAE,0CAA0C;YACnD,QAAQ,EAAE,8BAA8B;SACzC;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,yDAAyD;QAClE,KAAK,EAAE,sGAAsG;KAC9G;IACD,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,KAAK;KACN;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/ode23.js

@@ -16,7 +16,7 @@ const builtinDoc = {
         "reduction": false,
         "precisions": [],
         "broadcasting": "none",
-        "notes": "The adaptive integrator runs on the host. RHS callback functions may still call GPU-aware builtins."
+        "notes": "The adaptive integrator runs on the host. Automatic residency gathers transparently; explicit gpuArray host fallback is a gated RunMat extension. RHS callback functions may still call GPU-aware builtins."
     },
     "fusion": {
         "elementwise": false,
@@ -32,6 +32,10 @@ const builtinDoc = {
     "behaviors": [
         "Supports scalar, vector, and matrix-valued initial conditions.",
         "Accepts options as a struct, including `RelTol`, `AbsTol`, `InitialStep`, and `MaxStep`.",
+        "The documented tspan, y0, and derivative domains are single or double. Native integer and logical solver values are independently gated RunMat extensions, and every integer-to-double solver boundary requires exact representability.",
+        "Typed integer `MaxSteps` is parsed as an exact structural count; integer floating controls are checked before conversion.",
+        "The current RunMat integration loop and outputs are double even when all floating inputs are single; native-single output propagation remains a general compatibility gap rather than an integer extension.",
+        "Event outputs and solution-structure forms are not implemented by the current core solver surface.",
         "When `tspan` has more than two points, the solver returns values at each requested time.",
         "With one output, returns only the `y` trajectory matrix."
     ],

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

@@ -1 +1 @@
-{"version":3,"file":"ode23.js","sourceRoot":"","sources":["../../../src/generated/builtins/ode23.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,OAAO;IAChB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,OAAO;QACP,KAAK;QACL,UAAU;QACV,kBAAkB;QAClB,eAAe;KAChB;IACD,SAAS,EAAE,8EAA8E;IACzF,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,qGAAqG;KAC/G;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;KAC5C;IACD,aAAa,EAAE,0JAA0J;IACzK,WAAW,EAAE;QACX,gEAAgE;QAChE,0FAA0F;QAC1F,0FAA0F;QAC1F,0DAA0D;KAC3D;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,kDAAkD;YACjE,OAAO,EAAE,mDAAmD;YAC5D,QAAQ,EAAE,oCAAoC;SAC/C;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,wDAAwD;QACjE,KAAK,EAAE,qGAAqG;KAC7G;IACD,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,OAAO;IACf,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,KAAK;KACN;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"ode23.js","sourceRoot":"","sources":["../../../src/generated/builtins/ode23.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,OAAO;IAChB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,OAAO;QACP,KAAK;QACL,UAAU;QACV,kBAAkB;QAClB,eAAe;KAChB;IACD,SAAS,EAAE,8EAA8E;IACzF,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,6MAA6M;KACvN;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;KAC5C;IACD,aAAa,EAAE,0JAA0J;IACzK,WAAW,EAAE;QACX,gEAAgE;QAChE,0FAA0F;QAC1F,yOAAyO;QACzO,2HAA2H;QAC3H,6MAA6M;QAC7M,oGAAoG;QACpG,0FAA0F;QAC1F,0DAA0D;KAC3D;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,kDAAkD;YACjE,OAAO,EAAE,mDAAmD;YAC5D,QAAQ,EAAE,oCAAoC;SAC/C;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,wDAAwD;QACjE,KAAK,EAAE,qGAAqG;KAC7G;IACD,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,OAAO;IACf,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,KAAK;KACN;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/ode45.js

@@ -16,7 +16,7 @@ const builtinDoc = {
         "reduction": false,
         "precisions": [],
         "broadcasting": "none",
-        "notes": "The adaptive integrator runs on the host. RHS callback functions may still call GPU-aware builtins."
+        "notes": "The adaptive integrator runs on the host. Automatic residency gathers transparently; explicit gpuArray host fallback is a gated RunMat extension. RHS callback functions may still call GPU-aware builtins."
     },
     "fusion": {
         "elementwise": false,
@@ -32,6 +32,10 @@ const builtinDoc = {
     "behaviors": [
         "Supports scalar, vector, and matrix-valued initial conditions.",
         "Accepts options as a struct, including `RelTol`, `AbsTol`, `InitialStep`, and `MaxStep`.",
+        "The documented tspan, y0, and derivative domains are single or double. Native integer and logical solver values are independently gated RunMat extensions, and every integer-to-double solver boundary requires exact representability.",
+        "Typed integer `MaxSteps` is parsed as an exact structural count; integer floating controls are checked before conversion.",
+        "The current RunMat integration loop and outputs are double even when all floating inputs are single; native-single output propagation remains a general compatibility gap rather than an integer extension.",
+        "Event outputs and solution-structure forms are not implemented by the current core solver surface.",
         "When `tspan` has more than two points, the solver returns values at each requested time.",
         "With one output, returns only the `y` trajectory matrix."
     ],

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

@@ -1 +1 @@
-{"version":3,"file":"ode45.js","sourceRoot":"","sources":["../../../src/generated/builtins/ode45.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,OAAO;IAChB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,OAAO;QACP,KAAK;QACL,UAAU;QACV,gBAAgB;QAChB,eAAe;KAChB;IACD,SAAS,EAAE,4EAA4E;IACvF,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,qGAAqG;KAC/G;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;KAC5C;IACD,aAAa,EAAE,iJAAiJ;IAChK,WAAW,EAAE;QACX,gEAAgE;QAChE,0FAA0F;QAC1F,0FAA0F;QAC1F,0DAA0D;KAC3D;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,6BAA6B;YAC5C,OAAO,EAAE,sCAAsC;YAC/C,QAAQ,EAAE,kBAAkB;SAC7B;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,wDAAwD;QACjE,KAAK,EAAE,qGAAqG;KAC7G;IACD,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,OAAO;IACf,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,KAAK;KACN;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"ode45.js","sourceRoot":"","sources":["../../../src/generated/builtins/ode45.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,OAAO;IAChB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,OAAO;QACP,KAAK;QACL,UAAU;QACV,gBAAgB;QAChB,eAAe;KAChB;IACD,SAAS,EAAE,4EAA4E;IACvF,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,6MAA6M;KACvN;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;KAC5C;IACD,aAAa,EAAE,iJAAiJ;IAChK,WAAW,EAAE;QACX,gEAAgE;QAChE,0FAA0F;QAC1F,yOAAyO;QACzO,2HAA2H;QAC3H,6MAA6M;QAC7M,oGAAoG;QACpG,0FAA0F;QAC1F,0DAA0D;KAC3D;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,6BAA6B;YAC5C,OAAO,EAAE,sCAAsC;YAC/C,QAAQ,EAAE,kBAAkB;SAC7B;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,wDAAwD;QACjE,KAAK,EAAE,qGAAqG;KAC7G;IACD,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,OAAO;IACf,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,KAAK;KACN;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/onehotdecode.js

@@ -18,7 +18,7 @@ const builtinDoc = {
             "f64"
         ],
         "broadcasting": "none",
-        "notes": "GPU inputs are gathered to host. Decoding runs on CPU."
+        "notes": "Decoding runs on the CPU. Automatic residency gathers transparently; explicit gpuArray host fallback is a declared RunMat extension."
     },
     "fusion": {
         "elementwise": false,
@@ -29,17 +29,17 @@ const builtinDoc = {
     "requires_feature": null,
     "tested": {
         "unit": "builtins::stats::summary::encoding::tests",
-        "integration": "crates/runmat-vm/tests/stats_ml.rs"
+        "integration": "crates/runmat-vm/tests/integer_label_and_text_control_semantics.rs"
     },
     "description": "`onehotdecode(B,classes,featureDim)` chooses the maximum value along `featureDim` and maps the index to `classes`.",
     "behaviors": [
         "The length of `classes` must match the size of `B` along `featureDim`.",
-        "`B` must be numeric or logical with non-`NaN` values in the range `[0,1]`; `NaN` entries are ignored while choosing the maximum class.",
+        "The documented encoded array `B` accepts single or double values in `[0,1]`; a checked integer or logical zero-one array is a declared RunMat extension.",
         "Ties are resolved by the first class along `featureDim`, matching MATLAB-style first-maximum behavior.",
         "The decoded output keeps the encoded shape with the feature dimension set to 1.",
         "By default the decoded output is categorical and preserves the supplied class order as the category order.",
-        "An optional typename can request `double`, `logical`, `string`, `cellstr`, or `categorical` output; `OutputType` is also accepted as a RunMat extension.",
-        "Numeric output requires numeric classes, and logical output requires logical classes."
+        "A positional typename can request `double`, `single`, any of the eight integer classes, `string`, or `categorical`. Logical and cell-string output are declared RunMat extensions, as are `OutputType` and `Typename` name-value aliases.",
+        "Numeric classes retain exact native values through class selection and requested native output conversion, including adjacent 64-bit labels above `flintmax`."
     ],
     "examples": [
         {

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

@@ -1 +1 @@
-{"version":3,"file":"onehotdecode.js","sourceRoot":"","sources":["../../../src/generated/builtins/onehotdecode.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,cAAc;IACvB,UAAU,EAAE,eAAe;IAC3B,UAAU,EAAE;QACV,cAAc;QACd,SAAS;QACT,gBAAgB;QAChB,aAAa;QACb,YAAY;KACb;IACD,SAAS,EAAE,2CAA2C;IACtD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;SACN;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,wDAAwD;KAClE;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,MAAM;KACpB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,2CAA2C;QACnD,aAAa,EAAE,oCAAoC;KACpD;IACD,aAAa,EAAE,oHAAoH;IACnI,WAAW,EAAE;QACX,wEAAwE;QACxE,wIAAwI;QACxI,wGAAwG;QACxG,iFAAiF;QACjF,4GAA4G;QAC5G,0JAA0J;QAC1J,uFAAuF;KACxF;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,6BAA6B;YAC5C,OAAO,EAAE,wEAAwE;YACjF,QAAQ,EAAE,6BAA6B;SACxC;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,gDAAgD;YAC5D,QAAQ,EAAE,8DAA8D;SACzE;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,cAAc;YACvB,KAAK,EAAE,gBAAgB;SACxB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,gEAAgE;QACzE,KAAK,EAAE,6GAA6G;KACrH;IACD,KAAK,EAAE,cAAc;IACrB,MAAM,EAAE,cAAc;IACtB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"onehotdecode.js","sourceRoot":"","sources":["../../../src/generated/builtins/onehotdecode.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,cAAc;IACvB,UAAU,EAAE,eAAe;IAC3B,UAAU,EAAE;QACV,cAAc;QACd,SAAS;QACT,gBAAgB;QAChB,aAAa;QACb,YAAY;KACb;IACD,SAAS,EAAE,2CAA2C;IACtD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;SACN;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,sIAAsI;KAChJ;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,MAAM;KACpB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,2CAA2C;QACnD,aAAa,EAAE,oEAAoE;KACpF;IACD,aAAa,EAAE,oHAAoH;IACnI,WAAW,EAAE;QACX,wEAAwE;QACxE,0JAA0J;QAC1J,wGAAwG;QACxG,iFAAiF;QACjF,4GAA4G;QAC5G,2OAA2O;QAC3O,+JAA+J;KAChK;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,6BAA6B;YAC5C,OAAO,EAAE,wEAAwE;YACjF,QAAQ,EAAE,6BAA6B;SACxC;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,gDAAgD;YAC5D,QAAQ,EAAE,8DAA8D;SACzE;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,cAAc;YACvB,KAAK,EAAE,gBAAgB;SACxB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,gEAAgE;QACzE,KAAK,EAAE,6GAA6G;KACrH;IACD,KAAK,EAAE,cAAc;IACrB,MAAM,EAAE,cAAc;IACtB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}