runmat 0.6.1 → 0.6.2-dev.0

package/dist/generated/builtins/kron.js

@@ -19,7 +19,7 @@ const builtinDoc = {
             "f64"
         ],
         "broadcasting": "none",
-        "notes": "Providers may implement the kron hook to execute entirely on the device; the runtime gathers and evaluates on the host when the hook is missing."
+        "notes": "Validated floating-point inputs use the owning provider's kron hook when available. Unsupported provider cases gather to the host for exact evaluation and restore the result to the source provider when its class can be preserved."
     },
     "fusion": {
         "elementwise": false,
@@ -34,9 +34,10 @@ const builtinDoc = {
     },
     "description": "`kron(A, B)` forms the Kronecker (tensor) product of `A` and `B`. Output sizing and column-major block ordering follow MATLAB semantics.",
     "behaviors": [
-        "Works with scalars, vectors, matrices, and higher-rank tensors; trailing singleton dimensions are honoured.",
+        "Works with scalars, vectors, and matrices. Higher-rank tensor inputs are a RunMat extension and are rejected while strict compatibility mode disables extensions.",
         "If either input is complex, the output is complex and uses MATLAB's complex arithmetic rules.",
         "Logical and char inputs are promoted to double precision before multiplication.",
+        "All eight integer classes are supported. Integer operands must have the same class, or the other operand must be a scalar double; multiplication preserves the integer class and saturates on overflow. Complex integer arithmetic is rejected.",
         "Scalar arguments act as uniform scalars (`kron(a, B)` behaves like `a * B`).",
         "Empty dimensions propagate; if any replicated dimension is zero, the result is empty along that axis.",
         "Invalid inputs (non-numeric/non-logical, or values that would overflow the maximum size) raise descriptive MATLAB-style errors."
@@ -102,7 +103,7 @@ const builtinDoc = {
         },
         {
             "question": "Does the GPU path always stay on-device?",
-            "answer": "When the provider supplies a `kron` hook, execution stays on-device. Otherwise RunMat gathers to the host, computes the product, and re-uploads the result when a provider is available."
+            "answer": "Supported real floating-point operands stay on-device when their exact owning provider supplies a valid `kron` result. Unsupported cases gather automatically, compute on the host, and restore the class-preserving result to the source provider. Explicit `gpuArray` inputs either produce a resident result or raise an error; the source handles are not consumed."
         }
     ],
     "links": [
@@ -189,7 +190,7 @@ const builtinDoc = {
     },
     "gpu_residency": "You usually do **not** need to call `gpuArray` explicitly. RunMat's planner keeps values resident on the GPU whenever it is profitable. Explicit `gpuArray` calls remain supported for MATLAB compatibility and for users who want direct control over residency.",
     "gpu_behavior": [
-        "When a GPU provider is active, RunMat first consults the provider's `kron` hook so the operation can run entirely on the device. Providers that have not implemented this hook fall back to a safe path: the runtime gathers both operands to host memory, performs the Kronecker product in Rust, and then attempts to upload the result back to the originating device so downstream GPU work can continue without additional copies."
+        "For real floating-point operands, RunMat uses the exact owning provider's `kron` hook when the operands share a compatible device and precision; mixed host/resident floating inputs may upload the host operand temporarily and use the same path. Provider outputs are validated for shape, ownership, device, storage, precision, and non-aliasing. Typed-integer and otherwise unsupported cases gather automatically, compute with class-preserving host semantics, and restore the result to the source provider when possible. An explicit `gpuArray` source must remain resident or the call errors, while automatically resident values may return to host only when their class cannot be represented safely."
     ],
     "key": "kron",
     "slug": "kron",

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

@@ -1 +1 @@
-{"version":3,"file":"kron.js","sourceRoot":"","sources":["../../../src/generated/builtins/kron.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"kron.js","sourceRoot":"","sources":["../../../src/generated/builtins/kron.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,MAAM;IACf,UAAU,EAAE,aAAa;IACzB,UAAU,EAAE;QACV,MAAM;QACN,mBAAmB;QACnB,gBAAgB;QAChB,cAAc;QACd,KAAK;KACN;IACD,SAAS,EAAE,kDAAkD;IAC7D,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,uOAAuO;KACjP;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,qCAAqC;QAC7C,aAAa,EAAE,yDAAyD;KACzE;IACD,aAAa,EAAE,0IAA0I;IACzJ,WAAW,EAAE;QACX,mKAAmK;QACnK,+FAA+F;QAC/F,iFAAiF;QACjF,iPAAiP;QACjP,8EAA8E;QAC9E,uGAAuG;QACvG,iIAAiI;KAClI;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,iDAAiD;YAChE,OAAO,EAAE,kDAAkD;YAC3D,QAAQ,EAAE,6GAA6G;SACxH;QACD;YACE,aAAa,EAAE,+CAA+C;YAC9D,OAAO,EAAE,6DAA6D;YACtE,QAAQ,EAAE,qBAAqB;SAChC;QACD;YACE,aAAa,EAAE,6CAA6C;YAC5D,OAAO,EAAE,iCAAiC;YAC1C,QAAQ,EAAE,iCAAiC;SAC5C;QACD;YACE,aAAa,EAAE,6CAA6C;YAC5D,OAAO,EAAE,uDAAuD;SACjE;QACD;YACE,aAAa,EAAE,uCAAuC;YACtD,OAAO,EAAE,yDAAyD;SACnE;QACD;YACE,aAAa,EAAE,iCAAiC;YAChD,OAAO,EAAE,yDAAyD;SACnE;QACD;YACE,aAAa,EAAE,wCAAwC;YACvD,OAAO,EAAE,qFAAqF;YAC9F,QAAQ,EAAE,iBAAiB;SAC5B;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,qEAAqE;YACjF,QAAQ,EAAE,8JAA8J;SACzK;QACD;YACE,UAAU,EAAE,gCAAgC;YAC5C,QAAQ,EAAE,4JAA4J;SACvK;QACD;YACE,UAAU,EAAE,oCAAoC;YAChD,QAAQ,EAAE,6GAA6G;SACxH;QACD;YACE,UAAU,EAAE,8CAA8C;YAC1D,QAAQ,EAAE,+GAA+G;SAC1H;QACD;YACE,UAAU,EAAE,iCAAiC;YAC7C,QAAQ,EAAE,iHAAiH;SAC5H;QACD;YACE,UAAU,EAAE,4BAA4B;YACxC,QAAQ,EAAE,wLAAwL;SACnM;QACD;YACE,UAAU,EAAE,0CAA0C;YACtD,QAAQ,EAAE,yWAAyW;SACpX;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,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;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;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;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,wDAAwD;QACjE,KAAK,EAAE,wDAAwD;KAChE;IACD,eAAe,EAAE,mQAAmQ;IACpR,cAAc,EAAE;QACd,yrBAAyrB;KAC1rB;IACD,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IACd,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,OAAO;KACR;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/kstest.js

@@ -18,7 +18,7 @@ const builtinDoc = {
             "f64"
         ],
         "broadcasting": "none",
-        "notes": "gpuArray inputs are gathered to the CPU reference path."
+        "notes": "Automatic internal residency gathers transparently. Explicit gpuArray input is a mode-gated RunMat extension and uses the CPU reference path when enabled."
     },
     "fusion": {
         "elementwise": false,
@@ -29,7 +29,7 @@ const builtinDoc = {
     "requires_feature": null,
     "tested": {
         "unit": "builtins::stats::summary::hypothesis::tests",
-        "integration": "crates/runmat-vm/tests/stats_ml.rs"
+        "integration": "crates/runmat-vm/tests/stats_ml.rs; crates/runmat-vm/tests/integer_json_join_and_statistical_semantics.rs"
     },
     "description": "`kstest(x)` performs a one-sample Kolmogorov-Smirnov test of whether the sample in `x` could come from a standard normal distribution. `[h,p,ksstat,cv] = kstest(...)` also returns an approximate p-value, the KS statistic, and an approximate critical value.",
     "behaviors": [
@@ -39,7 +39,8 @@ const builtinDoc = {
         "`kstest(x,\"CDF\",cdf)` accepts a two-column numeric matrix whose first column contains sample points and whose second column contains CDF probabilities in `[0,1]`. Rows are sorted by sample point, duplicate sample points are collapsed to the largest probability at that point, and probabilities must be nondecreasing after normalization. Sample values must lie inside the table's x range. Values are linearly interpolated between table rows.",
         "`\"CDF\"` also accepts `\"normcdf\"`, `\"normal\"`, `\"norm\"`, or a `@normcdf` function handle for the standard normal CDF.",
         "The p-values use standard large-sample approximations. For two-sided tests, `cv` is returned for `Alpha` in `[0.01,0.20]`; for one-sided tests, `cv` is returned for `Alpha` in `[0.005,0.10]`. Outside those ranges, `cv` is `NaN`, matching MATLAB's documented critical-value limitations.",
-        "Continuous probability distribution objects for `\"CDF\"` are not supported until RunMat's `makedist`/`fitdist` distribution object surface exists."
+        "Continuous probability distribution objects for `\"CDF\"` are not supported until RunMat's `makedist`/`fitdist` distribution object surface exists.",
+        "Typed-integer sample and CDF-table data are RunMat-only extensions. Admitted values must be exactly representable as double before the statistical boundary; integer `Alpha` has no valid value in the required open interval `(0,1)` and is rejected."
     ],
     "examples": [
         {

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

@@ -1 +1 @@
-{"version":3,"file":"kstest.js","sourceRoot":"","sources":["../../../src/generated/builtins/kstest.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,oBAAoB;QACpB,iBAAiB;QACjB,KAAK;QACL,YAAY;KACb;IACD,SAAS,EAAE,+CAA+C;IAC1D,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,IAAI;QACjB,YAAY,EAAE;YACZ,KAAK;SACN;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,yDAAyD;KACnE;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,6CAA6C;QACrD,aAAa,EAAE,oCAAoC;KACpD;IACD,aAAa,EAAE,kQAAkQ;IACjR,WAAW,EAAE;QACX,kHAAkH;QAClH,kGAAkG;QAClG,8FAA8F;QAC9F,4bAA4b;QAC5b,8HAA8H;QAC9H,+RAA+R;QAC/R,qJAAqJ;KACtJ;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,wDAAwD;YACvE,OAAO,EAAE,iCAAiC;SAC3C;QACD;YACE,aAAa,EAAE,kDAAkD;YACjE,OAAO,EAAE,oDAAoD;SAC9D;QACD;YACE,aAAa,EAAE,2BAA2B;YAC1C,OAAO,EAAE,yDAAyD;SACnE;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,oDAAoD;YAChE,QAAQ,EAAE,oHAAoH;SAC/H;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,kEAAkE;QAC3E,KAAK,EAAE,+GAA+G;KACvH;IACD,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"kstest.js","sourceRoot":"","sources":["../../../src/generated/builtins/kstest.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,oBAAoB;QACpB,iBAAiB;QACjB,KAAK;QACL,YAAY;KACb;IACD,SAAS,EAAE,+CAA+C;IAC1D,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,IAAI;QACjB,YAAY,EAAE;YACZ,KAAK;SACN;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,4JAA4J;KACtK;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,6CAA6C;QACrD,aAAa,EAAE,2GAA2G;KAC3H;IACD,aAAa,EAAE,kQAAkQ;IACjR,WAAW,EAAE;QACX,kHAAkH;QAClH,kGAAkG;QAClG,8FAA8F;QAC9F,4bAA4b;QAC5b,8HAA8H;QAC9H,+RAA+R;QAC/R,qJAAqJ;QACrJ,wPAAwP;KACzP;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,wDAAwD;YACvE,OAAO,EAAE,iCAAiC;SAC3C;QACD;YACE,aAAa,EAAE,kDAAkD;YACjE,OAAO,EAAE,oDAAoD;SAC9D;QACD;YACE,aAAa,EAAE,2BAA2B;YAC1C,OAAO,EAAE,yDAAyD;SACnE;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,oDAAoD;YAChE,QAAQ,EAAE,oHAAoH;SAC/H;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,kEAAkE;QAC3E,KAAK,EAAE,+GAA+G;KACvH;IACD,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/lab2rgb.js

@@ -17,7 +17,7 @@ const builtinDoc = {
         "reduction": false,
         "precisions": [],
         "broadcasting": "none",
-        "notes": "Host implementation uses the default D65/sRGB conversion path and clips out-of-gamut RGB values."
+        "notes": "Host implementation uses the default D65/sRGB conversion path. Floating output retains out-of-gamut values; integer OutputType clips during class conversion."
     },
     "fusion": {
         "elementwise": false,
@@ -29,11 +29,11 @@ const builtinDoc = {
     "tested": {
         "unit": "builtins::image::color::lab2rgb::tests"
     },
-    "description": "`lab2rgb(LAB)` converts L*a*b* image or colormap data to sRGB values under D65 assumptions. It follows MATLAB-compatible channel and output-shape behavior for supported numeric inputs.",
+    "description": "`lab2rgb(LAB)` converts single or double L*a*b* image or colormap data to sRGB values under D65 assumptions. `OutputType` selects double, single, uint8, or uint16 output.",
     "behaviors": [
         "Accepts MxNx3 Lab images and Nx3 Lab colormaps.",
-        "Out-of-gamut RGB values are clipped to [0,1].",
-        "Name-value options are not implemented in this Tier 1 version."
+        "Floating output preserves out-of-gamut RGB values; uint8 and uint16 output clips to [0,1] while converting to native integer storage.",
+        "The OutputType name-value option accepts double, single, uint8, or uint16."
     ],
     "examples": [
         {

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

@@ -1 +1 @@
-{"version":3,"file":"lab2rgb.js","sourceRoot":"","sources":["../../../src/generated/builtins/lab2rgb.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,aAAa;IACzB,UAAU,EAAE;QACV,SAAS;QACT,KAAK;QACL,QAAQ;QACR,KAAK;QACL,OAAO;QACP,OAAO;KACR;IACD,SAAS,EAAE,oFAAoF;IAC/F,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,wCAAwC;KACjD;IACD,aAAa,EAAE,0LAA0L;IACzM,WAAW,EAAE;QACX,iDAAiD;QACjD,+CAA+C;QAC/C,gEAAgE;KACjE;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,YAAY;YAC3B,OAAO,EAAE,qBAAqB;YAC9B,QAAQ,EAAE,yCAAyC;SACpD;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,2DAA2D;QACpE,KAAK,EAAE,0GAA0G;KAClH;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,OAAO;KACR;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"lab2rgb.js","sourceRoot":"","sources":["../../../src/generated/builtins/lab2rgb.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,aAAa;IACzB,UAAU,EAAE;QACV,SAAS;QACT,KAAK;QACL,QAAQ;QACR,KAAK;QACL,OAAO;QACP,OAAO;KACR;IACD,SAAS,EAAE,oFAAoF;IAC/F,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,+JAA+J;KACzK;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,wCAAwC;KACjD;IACD,aAAa,EAAE,4KAA4K;IAC3L,WAAW,EAAE;QACX,iDAAiD;QACjD,uIAAuI;QACvI,4EAA4E;KAC7E;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,YAAY;YAC3B,OAAO,EAAE,qBAAqB;YAC9B,QAAQ,EAAE,yCAAyC;SACpD;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,2DAA2D;QACpE,KAAK,EAAE,0GAA0G;KAClH;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,OAAO;KACR;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

@@ -19,7 +19,7 @@ const builtinDoc = {
             "f64"
         ],
         "broadcasting": "none",
-        "notes": "GPU inputs are gathered to host. The coordinate-descent solver runs on CPU."
+        "notes": "Automatic internal residency gathers transparently. Explicit gpuArray input is a mode-gated RunMat extension; the coordinate-descent solver runs on CPU."
     },
     "fusion": {
         "elementwise": false,
@@ -30,7 +30,7 @@ const builtinDoc = {
     "requires_feature": null,
     "tested": {
         "unit": "builtins::stats::ml::lasso::tests",
-        "integration": null
+        "integration": "crates/runmat-vm/tests/integer_json_join_and_statistical_semantics.rs"
     },
     "description": "`lasso(X,y)` fits regularized linear regression coefficients for predictor matrix `X` and response vector `y`. Columns of `B` correspond to ascending `Lambda` values, and `[B,FitInfo] = lasso(...)` returns MATLAB-compatible fit metadata.",
     "behaviors": [
@@ -42,7 +42,8 @@ const builtinDoc = {
         "`Weights` accepts a nonnegative observation-weight vector with positive total weight. Weights are normalized internally.",
         "`RelTol` and `MaxIter` control coordinate-descent convergence. The `Iterations` FitInfo field records iterations per Lambda value.",
         "`CV` supports `\"resubstitution\"` and positive integer K-fold cross-validation. K-fold fits add `SE`, `LambdaMinMSE`, `Lambda1SE`, `IndexMinMSE`, and `Index1SE` fields to `FitInfo`.",
-        "`PredictorNames`, `DFmax`, `UseCovariance`, `CacheSize`, `MCReps=1`, `AbsTol`, `B0`, `U0`, `Rho`, and `Options` are accepted for script compatibility. Tall-array ADMM behavior and covariance-matrix acceleration are not implemented; `FitInfo.UseCovariance` is false because RunMat uses direct coordinate descent."
+        "`PredictorNames`, `DFmax`, `UseCovariance`, and `MCReps=1` are accepted for script compatibility. Tall-array ADMM behavior, covariance-matrix acceleration, and the currently unimplemented `CacheSize`, `AbsTol`, `B0`, `U0`, `Rho`, and `Options` forms reject explicitly; `FitInfo.UseCovariance` is false because RunMat uses direct coordinate descent.",
+        "Typed-integer X, y, floating parameters, and structural or logical controls are independently classified RunMat-only extensions. Integer data remains exact until a checked double solver boundary; values not exactly representable as double reject rather than round."
     ],
     "examples": [
         {

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

@@ -1 +1 @@
-{"version":3,"file":"lasso.js","sourceRoot":"","sources":["../../../src/generated/builtins/lasso.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,aAAa;QACb,gBAAgB;QAChB,YAAY;QACZ,YAAY;QACZ,kBAAkB;KACnB;IACD,SAAS,EAAE,gEAAgE;IAC3E,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;SACN;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,6EAA6E;KACvF;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,mCAAmC;QAC3C,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,+OAA+O;IAC9P,WAAW,EAAE;QACX,kKAAkK;QAClK,2JAA2J;QAC3J,qKAAqK;QACrK,0IAA0I;QAC1I,iJAAiJ;QACjJ,0HAA0H;QAC1H,oIAAoI;QACpI,wLAAwL;QACxL,yTAAyT;KAC1T;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,kDAAkD;YACjE,OAAO,EAAE,8GAA8G;YACvH,QAAQ,EAAE,yEAAyE;SACpF;QACD;YACE,aAAa,EAAE,wCAAwC;YACvD,OAAO,EAAE,oGAAoG;YAC7G,QAAQ,EAAE,4FAA4F;SACvG;QACD;YACE,aAAa,EAAE,6BAA6B;YAC5C,OAAO,EAAE,oFAAoF;YAC7F,QAAQ,EAAE,yEAAyE;SACpF;QACD;YACE,aAAa,EAAE,qBAAqB;YACpC,OAAO,EAAE,4EAA4E;YACrF,QAAQ,EAAE,mFAAmF;SAC9F;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,gCAAgC;YAC5C,QAAQ,EAAE,wIAAwI;SACnJ;QACD;YACE,UAAU,EAAE,uDAAuD;YACnE,QAAQ,EAAE,wJAAwJ;SACnK;QACD;YACE,UAAU,EAAE,gCAAgC;YAC5C,QAAQ,EAAE,iHAAiH;SAC5H;QACD;YACE,UAAU,EAAE,iEAAiE;YAC7E,QAAQ,EAAE,iLAAiL;SAC5L;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;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,OAAO;QACP,IAAI;KACL;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"lasso.js","sourceRoot":"","sources":["../../../src/generated/builtins/lasso.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,aAAa;QACb,gBAAgB;QAChB,YAAY;QACZ,YAAY;QACZ,kBAAkB;KACnB;IACD,SAAS,EAAE,gEAAgE;IAC3E,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;SACN;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,0JAA0J;KACpK;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,mCAAmC;QAC3C,aAAa,EAAE,uEAAuE;KACvF;IACD,aAAa,EAAE,+OAA+O;IAC9P,WAAW,EAAE;QACX,kKAAkK;QAClK,2JAA2J;QAC3J,qKAAqK;QACrK,0IAA0I;QAC1I,iJAAiJ;QACjJ,0HAA0H;QAC1H,oIAAoI;QACpI,wLAAwL;QACxL,8VAA8V;QAC9V,0QAA0Q;KAC3Q;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,kDAAkD;YACjE,OAAO,EAAE,8GAA8G;YACvH,QAAQ,EAAE,yEAAyE;SACpF;QACD;YACE,aAAa,EAAE,wCAAwC;YACvD,OAAO,EAAE,oGAAoG;YAC7G,QAAQ,EAAE,4FAA4F;SACvG;QACD;YACE,aAAa,EAAE,6BAA6B;YAC5C,OAAO,EAAE,oFAAoF;YAC7F,QAAQ,EAAE,yEAAyE;SACpF;QACD;YACE,aAAa,EAAE,qBAAqB;YACpC,OAAO,EAAE,4EAA4E;YACrF,QAAQ,EAAE,mFAAmF;SAC9F;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,gCAAgC;YAC5C,QAAQ,EAAE,wIAAwI;SACnJ;QACD;YACE,UAAU,EAAE,uDAAuD;YACnE,QAAQ,EAAE,wJAAwJ;SACnK;QACD;YACE,UAAU,EAAE,gCAAgC;YAC5C,QAAQ,EAAE,iHAAiH;SAC5H;QACD;YACE,UAAU,EAAE,iEAAiE;YAC7E,QAAQ,EAAE,iLAAiL;SAC5L;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;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,OAAO;QACP,IAAI;KACL;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

@@ -22,7 +22,7 @@ const builtinDoc = {
             "f64"
         ],
         "broadcasting": "none",
-        "notes": "GPU inputs are gathered to host. The regularized GLM solver runs on CPU."
+        "notes": "Automatic internal residency gathers transparently. Explicit gpuArray input is a mode-gated RunMat extension; the regularized GLM solver runs on CPU."
     },
     "fusion": {
         "elementwise": false,
@@ -33,7 +33,7 @@ const builtinDoc = {
     "requires_feature": null,
     "tested": {
         "unit": "builtins::stats::ml::lassoglm::tests",
-        "integration": "runmat-vm stats_ml::lassoglm_surface_executes_from_scripts"
+        "integration": "runmat-vm stats_ml::lassoglm_surface_executes_from_scripts; crates/runmat-vm/tests/integer_json_join_and_statistical_semantics.rs"
     },
     "description": "`lassoglm(X,Y,distr)` fits a regularized generalized linear model for predictor matrix `X`, response `Y`, and distribution `distr`. Columns of `B` correspond to ascending `Lambda` values, and `[B,FitInfo] = lassoglm(...)` returns MATLAB-compatible fit metadata.",
     "behaviors": [
@@ -45,7 +45,8 @@ const builtinDoc = {
         "`Standardize` and `Intercept` follow MATLAB's model form. `Weights` accepts a nonnegative observation-weight vector with positive total weight, and `Offset` accepts one finite offset per observation.",
         "`RelTol`, `MaxIter`, and statset-style `Options` control solver convergence. `Options.MaxIter`, `Options.TolX`, and `Options.TolFun` are honored; enabled parallel options are rejected because RunMat's solver is CPU-local.",
         "`CV` supports `\"resubstitution\"` and positive integer K-fold cross-validation. K-fold fits add `SE`, `LambdaMinDeviance`, `Lambda1SE`, `IndexMinDeviance`, and `Index1SE` fields to `FitInfo`.",
-        "`BinomialSize` supports scalar or per-observation trial counts for binomial probability responses. `Link` is accepted only for canonical supported links (`identity`, `logit`, or `log` according to distribution), `EstDisp` currently accepts `\"off\"`, and unsupported values are rejected instead of silently changing the model."
+        "`BinomialSize` supports scalar or per-observation trial counts for binomial probability responses. `Link` is accepted only for canonical supported links (`identity`, `logit`, or `log` according to distribution), `EstDisp` currently accepts `\"off\"`, and unsupported values are rejected instead of silently changing the model.",
+        "Typed-integer X, Y, numeric parameters, direct controls, and honored nested `Options` fields are independently classified RunMat-only extensions. Integer values remain exact until a checked double solver boundary; values not exactly representable as double reject rather than round."
     ],
     "examples": [
         {

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

@@ -1 +1 @@
-{"version":3,"file":"lassoglm.js","sourceRoot":"","sources":["../../../src/generated/builtins/lassoglm.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,UAAU;IACnB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,UAAU;QACV,OAAO;QACP,aAAa;QACb,0BAA0B;QAC1B,KAAK;QACL,UAAU;QACV,SAAS;QACT,YAAY;QACZ,kBAAkB;KACnB;IACD,SAAS,EAAE,iEAAiE;IAC5E,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;SACN;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,0EAA0E;KACpF;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,sCAAsC;QAC9C,aAAa,EAAE,4DAA4D;KAC5E;IACD,aAAa,EAAE,uQAAuQ;IACtR,WAAW,EAAE;QACX,+FAA+F;QAC/F,yOAAyO;QACzO,2JAA2J;QAC3J,mJAAmJ;QACnJ,0IAA0I;QAC1I,yMAAyM;QACzM,+NAA+N;QAC/N,kMAAkM;QAClM,wUAAwU;KACzU;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,+BAA+B;YAC9C,OAAO,EAAE,mHAAmH;YAC5H,QAAQ,EAAE,kGAAkG;SAC7G;QACD;YACE,aAAa,EAAE,0CAA0C;YACzD,OAAO,EAAE,oHAAoH;YAC7H,QAAQ,EAAE,8EAA8E;SACzF;QACD;YACE,aAAa,EAAE,6BAA6B;YAC5C,OAAO,EAAE,4FAA4F;YACrG,QAAQ,EAAE,8EAA8E;SACzF;QACD;YACE,aAAa,EAAE,6BAA6B;YAC5C,OAAO,EAAE,kFAAkF;YAC3F,QAAQ,EAAE,gEAAgE;SAC3E;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,gCAAgC;YAC5C,QAAQ,EAAE,wIAAwI;SACnJ;QACD;YACE,UAAU,EAAE,8BAA8B;YAC1C,QAAQ,EAAE,gPAAgP;SAC3P;QACD;YACE,UAAU,EAAE,gCAAgC;YAC5C,QAAQ,EAAE,iHAAiH;SAC5H;QACD;YACE,UAAU,EAAE,iEAAiE;YAC7E,QAAQ,EAAE,iLAAiL;SAC5L;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,2DAA2D;QACpE,KAAK,EAAE,wGAAwG;KAChH;IACD,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,IAAI;KACL;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"lassoglm.js","sourceRoot":"","sources":["../../../src/generated/builtins/lassoglm.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,UAAU;IACnB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,UAAU;QACV,OAAO;QACP,aAAa;QACb,0BAA0B;QAC1B,KAAK;QACL,UAAU;QACV,SAAS;QACT,YAAY;QACZ,kBAAkB;KACnB;IACD,SAAS,EAAE,iEAAiE;IAC5E,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;SACN;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,uJAAuJ;KACjK;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,sCAAsC;QAC9C,aAAa,EAAE,mIAAmI;KACnJ;IACD,aAAa,EAAE,uQAAuQ;IACtR,WAAW,EAAE;QACX,+FAA+F;QAC/F,yOAAyO;QACzO,2JAA2J;QAC3J,mJAAmJ;QACnJ,0IAA0I;QAC1I,yMAAyM;QACzM,+NAA+N;QAC/N,kMAAkM;QAClM,wUAAwU;QACxU,4RAA4R;KAC7R;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,+BAA+B;YAC9C,OAAO,EAAE,mHAAmH;YAC5H,QAAQ,EAAE,kGAAkG;SAC7G;QACD;YACE,aAAa,EAAE,0CAA0C;YACzD,OAAO,EAAE,oHAAoH;YAC7H,QAAQ,EAAE,8EAA8E;SACzF;QACD;YACE,aAAa,EAAE,6BAA6B;YAC5C,OAAO,EAAE,4FAA4F;YACrG,QAAQ,EAAE,8EAA8E;SACzF;QACD;YACE,aAAa,EAAE,6BAA6B;YAC5C,OAAO,EAAE,kFAAkF;YAC3F,QAAQ,EAAE,gEAAgE;SAC3E;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,gCAAgC;YAC5C,QAAQ,EAAE,wIAAwI;SACnJ;QACD;YACE,UAAU,EAAE,8BAA8B;YAC1C,QAAQ,EAAE,gPAAgP;SAC3P;QACD;YACE,UAAU,EAAE,gCAAgC;YAC5C,QAAQ,EAAE,iHAAiH;SAC5H;QACD;YACE,UAAU,EAAE,iEAAiE;YAC7E,QAAQ,EAAE,iLAAiL;SAC5L;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,2DAA2D;QACpE,KAAK,EAAE,wGAAwG;KAChH;IACD,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,IAAI;KACL;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/ldivide.js

@@ -19,7 +19,7 @@ const builtinDoc = {
             "f64"
         ],
         "broadcasting": "matlab",
-        "notes": "Prefers provider elem_div/scalar_div/scalar_rdiv hooks; gathers to host when shapes require implicit expansion or operands are unsupported."
+        "notes": "Uses validated exact-owner elem_div/scalar_div/scalar_rdiv paths for supported resident inputs, including provider-supported broadcasting and exact typed-integer cases. Unsupported cases gather automatically and restore class and residency."
     },
     "fusion": {
         "elementwise": true,
@@ -43,8 +43,8 @@ const builtinDoc = {
         "Implicit expansion follows MATLAB rules: singleton dimensions expand automatically, while mismatched non-singleton extents raise MATLAB-compatible size errors.",
         "Complex operands use the analytic continuation `B ./ A`, propagating `NaN` and `Inf` exactly as MATLAB does.",
         "Empty shapes propagate cleanly—if the broadcasted output has a zero dimension, the result is empty with the expected shape.",
-        "Integer inputs promote to double precision, mirroring MATLAB’s numeric tower.",
-        "The optional `'like'` prototype makes the result adopt the residency (host or GPU) and numeric flavour of the prototype. Complex prototypes are honoured on the host today; real gpuArray prototypes keep the result on the device."
+        "All eight integer classes are supported. Integer operands must share a class, or the other operand must be scalar double; the result preserves the integer class, rounds to nearest with half ties away from zero, and saturates on overflow. Complex integer arithmetic is rejected.",
+        "The optional `'like'` prototype makes the result adopt the residency (host or GPU) and numeric flavour of the prototype. This form is a RunMat extension and is rejected while strict compatibility mode disables extensions."
     ],
     "examples": [
         {
@@ -85,7 +85,7 @@ const builtinDoc = {
         },
         {
             "question": "What numeric type does `ldivide` return?",
-            "answer": "Real inputs return doubles; mixed or complex inputs return complex doubles. Logical and character inputs promote to double before division."
+            "answer": "Floating inputs preserve their supported floating flavour, mixed or complex inputs return the corresponding complex result, and logical and character inputs promote before division. Typed-integer division preserves the integer class under the documented same-class/scalar-double rules."
         },
         {
             "question": "How does `ldivide` handle division by zero?",
@@ -97,7 +97,7 @@ const builtinDoc = {
         },
         {
             "question": "Does `ldivide` preserve gpuArray residency after a fallback?",
-            "answer": "If the runtime gathers to host (for example, due to implicit expansion), the intermediate stays on the host. Later computations may move it back when auto-offload deems it profitable, or you can request GPU residency explicitly with `'like'`."
+            "answer": "Yes. Unsupported provider cases gather automatically, compute with MATLAB-compatible semantics, and restore the class-preserving result to the original provider. Explicit `gpuArray` inputs must produce resident output or the call errors; automatic residency may return to host only when safe class preservation on the provider is unavailable."
         },
         {
             "question": "How do I keep the result on the GPU?",
@@ -109,7 +109,7 @@ const builtinDoc = {
         },
         {
             "question": "Are integers and logicals supported?",
-            "answer": "Yes. Both promote to double precision before division so you get MATLAB-compatible numeric results (including `Inf` when dividing by zero)."
+            "answer": "Yes. Logical inputs promote before division. Typed integers preserve their integer class, use nearest rounding with half ties away from zero, and saturate; incompatible integer classes and complex integer arithmetic are rejected."
         },
         {
             "question": "Can I mix real and complex operands?",
@@ -230,9 +230,9 @@ const builtinDoc = {
         "label": "`crates/runmat-runtime/src/builtins/math/elementwise/ldivide.rs`",
         "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/math/elementwise/ldivide.rs"
     },
-    "gpu_residency": "You usually do not need to call `gpuArray` manually. RunMat’s auto-offload planner keeps tensors on the GPU whenever provider kernels cover the operation. Explicit `gpuArray` / `gather` calls remain available for MATLAB compatibility; when a provider fallback happens, the runtime gathers to host, computes the MATLAB-accurate answer, and reapplies `'like'` residency requests automatically.",
+    "gpu_residency": "You usually do not need to call `gpuArray` manually. RunMat’s auto-offload planner keeps tensors on the GPU whenever provider kernels cover the operation. When a provider fallback happens, the runtime gathers automatically, computes the class-preserving answer, and restores it to the original provider. Explicit `gpuArray` inputs must remain resident; the optional `'like'` form is a separately gated RunMat extension.",
     "gpu_behavior": [
-        "When a gpuArray provider is active:\n\n1. If both operands are gpuArrays with identical shapes, RunMat calls the provider’s `elem_div` hook with `(B, A)` so the division runs entirely on the GPU. 2. If the divisor `A` is scalar (host or device) and the numerator `B` is a gpuArray, the runtime uses `scalar_div` to evaluate `B ./ a` on device memory. 3. If the numerator `B` is scalar and the divisor `A` is a gpuArray, `scalar_rdiv` performs `b ./ A` without leaving the GPU. 4. When shapes require implicit expansion—or the provider lacks the necessary kernels—RunMat gathers to the host, computes the MATLAB-accurate result, then reapplies `'like'` residency rules (including re-uploading to a gpuArray when requested). 5. The fusion planner treats `ldivide` as a fusible elementwise node, so adjacent elementwise producers and consumers can execute inside a single GPU pipeline or WGSL kernel, minimising redundant host↔device transfers."
+        "RunMat first validates integer admission and operand metadata, then uses the exact common owner’s `elem_div(B, A)` path for compatible resident floating-point or same-class integer pairs, including provider-supported implicit expansion. A resident tensor with a host double scalar uses `scalar_div` or `scalar_rdiv` for floating data; an exactly representable integral scalar paired with resident integer data is uploaded in that integer class and evaluated through `elem_div`. Every provider result is checked for shape, owner, device, storage, class, precision, and non-aliasing. Unsupported or mixed cases gather automatically, execute on the host, and restore the class-preserving result to the original provider; explicit residency must be preserved. The fusion planner can still fuse supported floating elementwise expressions."
     ],
     "key": "ldivide",
     "slug": "ldivide",

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

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

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

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

package/dist/generated/builtins/le.js

@@ -19,7 +19,7 @@ const builtinDoc = {
             "f64"
         ],
         "broadcasting": "matlab",
-        "notes": "Uses provider elem_le kernels when available; otherwise inputs gather back to host memory transparently."
+        "notes": "Uses a validated exact-owner elem_le path for compatible resident pairs; mixed or unsupported cases gather transparently and restore a logical result to the source provider."
     },
     "fusion": {
         "elementwise": true,
@@ -38,7 +38,9 @@ const builtinDoc = {
         "Numeric, logical, and character inputs compare element-wise using MATLAB's implicit expansion rules.",
         "Character arrays compare by Unicode code point; mixing them with numeric arrays behaves like comparing numeric codes (`'A' <= 65`).",
         "String scalars and string arrays compare lexically; implicit expansion works across string dimensions.",
-        "Complex inputs are not supported, matching MATLAB's behaviour.",
+        "Complex numeric inputs are ordered by their real components and return logical results.",
+        "All integer classes can be compared, including mixed numeric classes, without first collapsing exact integer values through double precision.",
+        "Categorical values use their categorical ordering when the categorical comparison path applies.",
         "Mixed numeric/string inputs raise MATLAB-compatible type errors."
     ],
     "examples": [
@@ -84,7 +86,7 @@ const builtinDoc = {
         },
         {
             "question": "Can I compare complex numbers with `le`?",
-            "answer": "No. MATLAB does not define relational ordering for complex numbers, so RunMat raises a MATLAB-compatible error when complex inputs are supplied."
+            "answer": "Yes. Relational ordering uses the real components of complex numeric values and returns logical results."
         },
         {
             "question": "How are strings compared?",
@@ -96,7 +98,7 @@ const builtinDoc = {
         },
         {
             "question": "Do I need to gather results manually after a GPU comparison?",
-            "answer": "No. When both inputs are `gpuArray` values and the provider supports `elem_le`, the result stays on the GPU. Otherwise, RunMat gathers inputs transparently and returns a host logical array."
+            "answer": "No. Compatible resident pairs use the provider's validated `elem_le` result. Mixed or unsupported cases gather transparently, compare on the host, and restore the logical result to the source provider; explicit `gpuArray` residency must be preserved."
         },
         {
             "question": "Does implicit expansion apply to string arrays?",
@@ -139,7 +141,7 @@ const builtinDoc = {
     },
     "gpu_residency": "You usually do **not** need to call `gpuArray` explicitly. RunMat's native auto-offload planner keeps intermediate results on the GPU when fused expressions benefit from device execution. Explicit `gpuArray` and `gather` calls remain available for compatibility with MATLAB code that manages residency manually.",
     "gpu_behavior": [
-        "When both operands are `gpuArray` values and the active acceleration provider implements the `elem_le` hook, RunMat executes the comparison entirely on the device and returns a `gpuArray` logical result. If the provider does not expose this hook, the runtime gathers the inputs to host memory automatically and performs the CPU comparison instead of failing."
+        "Compatible resident operand pairs use the exact common owner's validated `elem_le` path and return a resident logical result. If either operand is host-resident, the owners differ, or the provider path cannot represent the comparison safely, RunMat gathers resident inputs automatically, evaluates the full comparison semantics on the host, and restores the logical result to the first resident source provider. Explicit `gpuArray` inputs must remain resident or the call errors."
     ],
     "key": "le",
     "slug": "le",

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

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

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

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

package/dist/generated/builtins/length.js

@@ -16,7 +16,7 @@ const builtinDoc = {
         "reduction": false,
         "precisions": [],
         "broadcasting": "none",
-        "notes": "Reads tensor metadata from handles; falls back to host when provider metadata is incomplete."
+        "notes": "Reads shape metadata directly from resident handles and returns a host double scalar without provider access, downloads, kernels, or allocations."
     },
     "fusion": {
         "elementwise": false,
@@ -35,7 +35,8 @@ const builtinDoc = {
         "Empty arrays report `0` when every dimension is zero; otherwise the maximum non-zero dimension is reported (e.g., `0×5` arrays have length `5`).",
         "Character arrays and string arrays follow their array dimensions, not the number of code points.",
         "Cell arrays use their MATLAB array shape (`rows × cols`) with the maximum dimension returned.",
-        "GPU-resident arrays are inspected without gathering when the provider populates shape metadata on the tensor handle; otherwise, RunMat gathers once to recover the correct dimensions.",
+        "GPU-resident arrays are inspected entirely through shape metadata already carried by the tensor handle; `length` never gathers the payload.",
+        "Tables and timetables are rejected; use `height`, `width`, or `size` for tabular values.",
         "Arguments that are not arrays (scalars, logicals, strings, handle objects) are treated as `1×1`."
     ],
     "examples": [
@@ -80,7 +81,7 @@ const builtinDoc = {
         },
         {
             "question": "Does `length` gather GPU data?",
-            "answer": "No. The runtime relies on shape metadata stored in the GPU tensor handle. Only when that metadata is missing does RunMat gather the tensor to maintain correctness."
+            "answer": "No. The runtime reads shape metadata stored in the GPU tensor handle and never accesses the provider or downloads the tensor payload."
         },
         {
             "question": "Can I use `length` on cell arrays and structs?",
@@ -142,7 +143,7 @@ const builtinDoc = {
         "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/array/introspection/length.rs"
     },
     "gpu_behavior": [
-        "`length` is a metadata query. When the input is a GPU tensor, RunMat looks at the shape embedded in the GPU handle (`GpuTensorHandle.shape`). If the active provider leaves that metadata empty, the runtime invokes `provider.download(handle)` a single time to recover the shape, ensuring MATLAB-compatible behaviour. No GPU kernels are launched and no device buffers are allocated by this builtin."
+        "`length` is a metadata-only query. For a resident tensor, RunMat reads `GpuTensorHandle.shape` directly and returns a host double scalar. It does not consult the provider, gather or download the payload, launch a kernel, or allocate a device buffer."
     ],
     "key": "length",
     "slug": "length",

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

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

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

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

package/dist/generated/builtins/lettersPattern.js

@@ -16,7 +16,7 @@ const builtinDoc = {
         "reduction": false,
         "precisions": [],
         "broadcasting": "none",
-        "notes": "No GPU kernel is registered for this compatibility builtin; GPU-resident inputs are gathered to host memory before evaluation."
+        "notes": "The returned pattern is host metadata. Automatically resident numeric count controls gather transparently; explicit gpuArray count controls are unsupported."
     },
     "fusion": {
         "elementwise": false,
@@ -30,40 +30,75 @@ const builtinDoc = {
         "unit": "builtins::strings::core::compat::tests",
         "integration": null
     },
-    "description": "pat = lettersPattern(N) - Create a pattern matching letter characters.",
+    "description": "`lettersPattern` creates a greedy pattern for one or more Unicode letters by default, or for an exact or inclusive bounded count.",
     "signatures": [
+        {
+            "label": "pat = lettersPattern",
+            "inputs": [],
+            "outputs": [
+                {
+                    "name": "pat",
+                    "ty": "Any",
+                    "arity": "Required",
+                    "default": null,
+                    "description": "Host pattern object."
+                }
+            ]
+        },
         {
             "label": "pat = lettersPattern(N)",
             "inputs": [
                 {
-                    "name": "text",
+                    "name": "N",
+                    "ty": "NumericScalar",
+                    "arity": "Required",
+                    "default": null,
+                    "description": "Exact nonnegative number of letters to match."
+                }
+            ],
+            "outputs": [
+                {
+                    "name": "pat",
                     "ty": "Any",
                     "arity": "Required",
                     "default": null,
-                    "description": "Input text."
+                    "description": "Host pattern object."
+                }
+            ]
+        },
+        {
+            "label": "pat = lettersPattern(minCharacters, maxCharacters)",
+            "inputs": [
+                {
+                    "name": "minCharacters",
+                    "ty": "NumericScalar",
+                    "arity": "Required",
+                    "default": null,
+                    "description": "Inclusive nonnegative minimum."
                 },
                 {
-                    "name": "arg",
-                    "ty": "Any",
-                    "arity": "Variadic",
+                    "name": "maxCharacters",
+                    "ty": "NumericScalar",
+                    "arity": "Required",
                     "default": null,
-                    "description": "Additional arguments."
+                    "description": "Inclusive nonnegative maximum, or positive infinity."
                 }
             ],
             "outputs": [
                 {
-                    "name": "out",
+                    "name": "pat",
                     "ty": "Any",
                     "arity": "Required",
                     "default": null,
-                    "description": "Output value."
+                    "description": "Host pattern object."
                 }
             ]
         }
     ],
     "behaviors": [
-        "Create a pattern matching letter characters.",
-        "Creates a regular-expression-backed pattern for Unicode alphabetic runs, with optional exact count."
+        "Without a count, the greedy pattern matches one or more Unicode alphabetic characters.",
+        "Exact and bounded counts accept single, double, and all eight integer classes without routing typed values through floating compatibility storage.",
+        "The bounded form accepts positive infinity as the maximum and rejects negative, fractional, nonscalar, reversed, or platform-oversized counts."
     ],
     "examples": [
         "startsWith(\"abc1\", lettersPattern) can match the leading letters."

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

@@ -1 +1 @@
-{"version":3,"file":"lettersPattern.js","sourceRoot":"","sources":["../../../src/generated/builtins/lettersPattern.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,gBAAgB;IACzB,UAAU,EAAE,iBAAiB;IAC7B,UAAU,EAAE;QACV,gBAAgB;QAChB,SAAS;QACT,SAAS;QACT,QAAQ;QACR,eAAe;KAChB;IACD,SAAS,EAAE,8CAA8C;IACzD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,gIAAgI;KAC1I;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,IAAI;QAClB,WAAW,EAAE,gBAAgB;QAC7B,OAAO,EAAE,kFAAkF;KAC5F;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,wCAAwC;QAChD,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,wEAAwE;IACvF,YAAY,EAAE;QACZ;YACE,OAAO,EAAE,yBAAyB;YAClC,QAAQ,EAAE;gBACR;oBACE,MAAM,EAAE,MAAM;oBACd,IAAI,EAAE,KAAK;oBACX,OAAO,EAAE,UAAU;oBACnB,SAAS,EAAE,IAAI;oBACf,aAAa,EAAE,aAAa;iBAC7B;gBACD;oBACE,MAAM,EAAE,KAAK;oBACb,IAAI,EAAE,KAAK;oBACX,OAAO,EAAE,UAAU;oBACnB,SAAS,EAAE,IAAI;oBACf,aAAa,EAAE,uBAAuB;iBACvC;aACF;YACD,SAAS,EAAE;gBACT;oBACE,MAAM,EAAE,KAAK;oBACb,IAAI,EAAE,KAAK;oBACX,OAAO,EAAE,UAAU;oBACnB,SAAS,EAAE,IAAI;oBACf,aAAa,EAAE,eAAe;iBAC/B;aACF;SACF;KACF;IACD,WAAW,EAAE;QACX,8CAA8C;QAC9C,qGAAqG;KACtG;IACD,UAAU,EAAE;QACV,qEAAqE;KACtE;IACD,MAAM,EAAE,EAAE;IACV,OAAO,EAAE;QACP;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,6DAA6D;QACtE,KAAK,EAAE,0GAA0G;KAClH;IACD,KAAK,EAAE,gBAAgB;IACvB,MAAM,EAAE,gBAAgB;IACxB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,SAAS;QACT,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"lettersPattern.js","sourceRoot":"","sources":["../../../src/generated/builtins/lettersPattern.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,gBAAgB;IACzB,UAAU,EAAE,iBAAiB;IAC7B,UAAU,EAAE;QACV,gBAAgB;QAChB,SAAS;QACT,SAAS;QACT,QAAQ;QACR,eAAe;KAChB;IACD,SAAS,EAAE,8CAA8C;IACzD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,8JAA8J;KACxK;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,IAAI;QAClB,WAAW,EAAE,gBAAgB;QAC7B,OAAO,EAAE,kFAAkF;KAC5F;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,wCAAwC;QAChD,aAAa,EAAE,IAAI;KACpB;IACD,aAAa,EAAE,mIAAmI;IAClJ,YAAY,EAAE;QACZ;YACE,OAAO,EAAE,sBAAsB;YAC/B,QAAQ,EAAE,EAAE;YACZ,SAAS,EAAE;gBACT;oBACE,MAAM,EAAE,KAAK;oBACb,IAAI,EAAE,KAAK;oBACX,OAAO,EAAE,UAAU;oBACnB,SAAS,EAAE,IAAI;oBACf,aAAa,EAAE,sBAAsB;iBACtC;aACF;SACF;QACD;YACE,OAAO,EAAE,yBAAyB;YAClC,QAAQ,EAAE;gBACR;oBACE,MAAM,EAAE,GAAG;oBACX,IAAI,EAAE,eAAe;oBACrB,OAAO,EAAE,UAAU;oBACnB,SAAS,EAAE,IAAI;oBACf,aAAa,EAAE,+CAA+C;iBAC/D;aACF;YACD,SAAS,EAAE;gBACT;oBACE,MAAM,EAAE,KAAK;oBACb,IAAI,EAAE,KAAK;oBACX,OAAO,EAAE,UAAU;oBACnB,SAAS,EAAE,IAAI;oBACf,aAAa,EAAE,sBAAsB;iBACtC;aACF;SACF;QACD;YACE,OAAO,EAAE,oDAAoD;YAC7D,QAAQ,EAAE;gBACR;oBACE,MAAM,EAAE,eAAe;oBACvB,IAAI,EAAE,eAAe;oBACrB,OAAO,EAAE,UAAU;oBACnB,SAAS,EAAE,IAAI;oBACf,aAAa,EAAE,gCAAgC;iBAChD;gBACD;oBACE,MAAM,EAAE,eAAe;oBACvB,IAAI,EAAE,eAAe;oBACrB,OAAO,EAAE,UAAU;oBACnB,SAAS,EAAE,IAAI;oBACf,aAAa,EAAE,sDAAsD;iBACtE;aACF;YACD,SAAS,EAAE;gBACT;oBACE,MAAM,EAAE,KAAK;oBACb,IAAI,EAAE,KAAK;oBACX,OAAO,EAAE,UAAU;oBACnB,SAAS,EAAE,IAAI;oBACf,aAAa,EAAE,sBAAsB;iBACtC;aACF;SACF;KACF;IACD,WAAW,EAAE;QACX,wFAAwF;QACxF,oJAAoJ;QACpJ,gJAAgJ;KACjJ;IACD,UAAU,EAAE;QACV,qEAAqE;KACtE;IACD,MAAM,EAAE,EAAE;IACV,OAAO,EAAE;QACP;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,6DAA6D;QACtE,KAAK,EAAE,0GAA0G;KAClH;IACD,KAAK,EAAE,gBAAgB;IACvB,MAAM,EAAE,gBAAgB;IACxB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,SAAS;QACT,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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