runmat 0.6.1-dev.1 → 0.6.2-dev.0

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

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

package/dist/generated/builtins/onehotencode.js

@@ -18,7 +18,7 @@ const builtinDoc = {
             "f64"
         ],
         "broadcasting": "none",
-        "notes": "GPU inputs are gathered to host. Class discovery and label matching run on CPU."
+        "notes": "Class discovery and label matching run on the CPU. Automatic residency gathers transparently; explicit gpuArray host fallback is a declared RunMat extension."
     },
     "fusion": {
         "elementwise": false,
@@ -29,16 +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": "`onehotencode(A,featureDim)` expands labels in `A` into one-hot vectors along `featureDim`.",
     "behaviors": [
         "`featureDim` must identify a singleton dimension in `A`; dimensions beyond `ndims(A)` are padded with singleton dimensions.",
         "Categorical inputs infer classes from the full category order, including categories not observed in the input values.",
         "Noncategorical inputs require `ClassNames`; class names must be unique and match the input label type.",
-        "`OutputType` supports `double`, `single`, and `logical`; `single` is represented with RunMat's numeric tensor storage.",
+        "The positional typename supports `double`, `single`, `logical`, and all eight integer output classes. `OutputType` and `Typename` name-value aliases are declared RunMat extensions.",
+        "Numeric labels and `ClassNames` retain exact native identity, so adjacent `int64` and `uint64` labels above `flintmax` do not collapse.",
         "Missing labels and labels not listed in `ClassNames` encode as all-`NaN` feature vectors for numeric output.",
-        "Logical output cannot represent missing labels or labels excluded by `ClassNames` and raises an error in those cases."
+        "Logical and integer output cannot represent missing labels or labels excluded by `ClassNames` and raises an error in those cases."
     ],
     "examples": [
         {

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

@@ -1 +1 @@
-{"version":3,"file":"onehotencode.js","sourceRoot":"","sources":["../../../src/generated/builtins/onehotencode.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,yCAAyC;IACpD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;SACN;QACD,cAAc,EAAE,MAAM;QACtB,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,2CAA2C;QACnD,aAAa,EAAE,oCAAoC;KACpD;IACD,aAAa,EAAE,6FAA6F;IAC5G,WAAW,EAAE;QACX,6HAA6H;QAC7H,uHAAuH;QACvH,wGAAwG;QACxG,wHAAwH;QACxH,8GAA8G;QAC9G,uHAAuH;KACxH;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,oCAAoC;YACnD,OAAO,EAAE,4GAA4G;YACrH,QAAQ,EAAE,8BAA8B;SACzC;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,gCAAgC;YAC5C,QAAQ,EAAE,6HAA6H;SACxI;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":"onehotencode.js","sourceRoot":"","sources":["../../../src/generated/builtins/onehotencode.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,yCAAyC;IACpD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;SACN;QACD,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,MAAM;KACpB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,2CAA2C;QACnD,aAAa,EAAE,oEAAoE;KACpF;IACD,aAAa,EAAE,6FAA6F;IAC5G,WAAW,EAAE;QACX,6HAA6H;QAC7H,uHAAuH;QACvH,wGAAwG;QACxG,sLAAsL;QACtL,yIAAyI;QACzI,8GAA8G;QAC9G,mIAAmI;KACpI;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,oCAAoC;YACnD,OAAO,EAAE,4GAA4G;YACrH,QAAQ,EAAE,8BAA8B;SACzC;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,gCAAgC;YAC5C,QAAQ,EAAE,6HAA6H;SACxI;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"}

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

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

package/dist/generated/builtins/openfig.js

@@ -31,6 +31,7 @@ const builtinDoc = {
     "description": "`openfig(filename)` loads a RunMat FIG scene file and returns the imported figure handle or a row vector of handles.",
     "behaviors": [
         "The `.fig` extension is appended when the filename has no extension.",
+        "Filename, copy mode, and visibility are textual roles; numeric and resident numeric arguments are rejected before provider access or file I/O.",
         "`openfig(filename, 'new')` imports a new copy of the saved scene. `reuse` mode is rejected until RunMat tracks figure-file reuse relationships.",
         "`openfig(..., 'visible')` and `openfig(..., 'invisible')` override the loaded figure visibility."
     ],

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

@@ -1 +1 @@
-{"version":3,"file":"openfig.js","sourceRoot":"","sources":["../../../src/generated/builtins/openfig.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,SAAS;QACT,aAAa;QACb,KAAK;QACL,UAAU;KACX;IACD,SAAS,EAAE,yCAAyC;IACpD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,mDAAmD;KAC7D;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;KACtB;IACD,kBAAkB,EAAE,WAAW;IAC/B,QAAQ,EAAE;QACR,MAAM,EAAE,+CAA+C;QACvD,aAAa,EAAE,6CAA6C;KAC7D;IACD,aAAa,EAAE,sHAAsH;IACrI,WAAW,EAAE;QACX,sEAAsE;QACtE,iJAAiJ;QACjJ,kGAAkG;KACnG;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,2CAA2C;YAC1D,OAAO,EAAE,8HAA8H;SACxI;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,yEAAyE;QAClF,KAAK,EAAE,sHAAsH;KAC9H;IACD,eAAe,EAAE,6FAA6F;IAC9G,cAAc,EAAE;QACd,oCAAoC;QACpC,8EAA8E;KAC/E;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"openfig.js","sourceRoot":"","sources":["../../../src/generated/builtins/openfig.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,SAAS;QACT,aAAa;QACb,KAAK;QACL,UAAU;KACX;IACD,SAAS,EAAE,yCAAyC;IACpD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,mDAAmD;KAC7D;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;KACtB;IACD,kBAAkB,EAAE,WAAW;IAC/B,QAAQ,EAAE;QACR,MAAM,EAAE,+CAA+C;QACvD,aAAa,EAAE,6CAA6C;KAC7D;IACD,aAAa,EAAE,sHAAsH;IACrI,WAAW,EAAE;QACX,sEAAsE;QACtE,gJAAgJ;QAChJ,iJAAiJ;QACjJ,kGAAkG;KACnG;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,2CAA2C;YAC1D,OAAO,EAAE,8HAA8H;SACxI;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,yEAAyE;QAClF,KAAK,EAAE,sHAAsH;KAC9H;IACD,eAAe,EAAE,6FAA6F;IAC9G,cAAc,EAAE;QACd,oCAAoC;QACpC,8EAA8E;KAC/E;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/opentoline.js

@@ -17,7 +17,7 @@ const builtinDoc = {
         "reduction": false,
         "precisions": [],
         "broadcasting": "none",
-        "notes": "Host-side editor navigation request. gpuArray scalar position inputs are gathered before validation."
+        "notes": "Host-side editor navigation request. Ordinary integer-valued double positions are the compatibility form; native typed-integer positions and explicitly resident positions are independently gated RunMat extensions, while automatically resident compatible values gather transparently."
     },
     "fusion": {
         "elementwise": false,
@@ -34,6 +34,8 @@ const builtinDoc = {
     "behaviors": [
         "`opentoline(filename,line)` accepts a string scalar, row character vector, or scalar string array filename plus a positive integer line number.",
         "`opentoline(filename,line,column)` also validates a positive integer column number.",
+        "Native typed-integer line and column spellings are RunMat extensions because the public contract establishes structural positions without enumerating native numeric classes.",
+        "Explicit `gpuArray` positions are a separate RunMat extension; automatically resident compatible scalars still gather through their owning provider in MATLAB-compatible mode.",
         "`opentoline(filename,line,column,'select')` accepts MATLAB-style selection intent as a no-op navigation option in noninteractive hosts.",
         "Command-style numeric line and column arguments passed as text, such as `opentoline file.m 10 4`, are accepted when they parse as positive integers.",
         "File names are resolved using the RunMat search path and the same general MATLAB-style file extensions used by `open`.",
@@ -87,7 +89,7 @@ const builtinDoc = {
         "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/io/repl_fs/opentoline.rs"
     },
     "gpu_behavior": [
-        "`opentoline` is a host-side editor navigation operation and does not participate in GPU fusion or provider-native execution."
+        "`opentoline` is a host-side editor navigation operation and does not participate in GPU fusion or provider-native computation; an admitted automatically resident position is downloaded through its owning provider before validation."
     ],
     "key": "opentoline",
     "slug": "opentoline",

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

@@ -1 +1 @@
-{"version":3,"file":"opentoline.js","sourceRoot":"","sources":["../../../src/generated/builtins/opentoline.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,YAAY;IACrB,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE;QACV,YAAY;QACZ,MAAM;QACN,QAAQ;QACR,MAAM;QACN,MAAM;QACN,QAAQ;KACT;IACD,SAAS,EAAE,mEAAmE;IAC9E,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,sGAAsG;KAChH;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,0CAA0C;QAClD,IAAI,EAAE,yDAAyD;KAChE;IACD,aAAa,EAAE,gMAAgM;IAC/M,WAAW,EAAE;QACX,iJAAiJ;QACjJ,qFAAqF;QACrF,yIAAyI;QACzI,sJAAsJ;QACtJ,wHAAwH;QACxH,yDAAyD;QACzD,wHAAwH;QACxH,wEAAwE;KACzE;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,yBAAyB;YACxC,OAAO,EAAE,2BAA2B;YACpC,QAAQ,EAAE,2FAA2F;SACtG;QACD;YACE,aAAa,EAAE,oCAAoC;YACnD,OAAO,EAAE,8BAA8B;YACvC,QAAQ,EAAE,gDAAgD;SAC3D;QACD;YACE,aAAa,EAAE,gCAAgC;YAC/C,OAAO,EAAE,yBAAyB;YAClC,QAAQ,EAAE,mEAAmE;SAC9E;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,4CAA4C;YACxD,QAAQ,EAAE,oLAAoL;SAC/L;QACD;YACE,UAAU,EAAE,6DAA6D;YACzE,QAAQ,EAAE,yLAAyL;SACpM;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;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,+DAA+D;QACxE,KAAK,EAAE,4GAA4G;KACpH;IACD,cAAc,EAAE;QACd,8HAA8H;KAC/H;IACD,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,YAAY;IACpB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,IAAI;QACJ,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"opentoline.js","sourceRoot":"","sources":["../../../src/generated/builtins/opentoline.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,YAAY;IACrB,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE;QACV,YAAY;QACZ,MAAM;QACN,QAAQ;QACR,MAAM;QACN,MAAM;QACN,QAAQ;KACT;IACD,SAAS,EAAE,mEAAmE;IAC9E,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,4RAA4R;KACtS;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,0CAA0C;QAClD,IAAI,EAAE,yDAAyD;KAChE;IACD,aAAa,EAAE,gMAAgM;IAC/M,WAAW,EAAE;QACX,iJAAiJ;QACjJ,qFAAqF;QACrF,+KAA+K;QAC/K,gLAAgL;QAChL,yIAAyI;QACzI,sJAAsJ;QACtJ,wHAAwH;QACxH,yDAAyD;QACzD,wHAAwH;QACxH,wEAAwE;KACzE;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,yBAAyB;YACxC,OAAO,EAAE,2BAA2B;YACpC,QAAQ,EAAE,2FAA2F;SACtG;QACD;YACE,aAAa,EAAE,oCAAoC;YACnD,OAAO,EAAE,8BAA8B;YACvC,QAAQ,EAAE,gDAAgD;SAC3D;QACD;YACE,aAAa,EAAE,gCAAgC;YAC/C,OAAO,EAAE,yBAAyB;YAClC,QAAQ,EAAE,mEAAmE;SAC9E;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,4CAA4C;YACxD,QAAQ,EAAE,oLAAoL;SAC/L;QACD;YACE,UAAU,EAAE,6DAA6D;YACzE,QAAQ,EAAE,yLAAyL;SACpM;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;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,+DAA+D;QACxE,KAAK,EAAE,4GAA4G;KACpH;IACD,cAAc,EAAE;QACd,yOAAyO;KAC1O;IACD,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,YAAY;IACpB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,IAAI;QACJ,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/optimoptions.js

@@ -0,0 +1,74 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "optimoptions",
+    "category": "math/optim",
+    "keywords": [
+        "optimoptions",
+        "optimization",
+        "options",
+        "TolX",
+        "MaxIter",
+        "Display"
+    ],
+    "summary": "Create or update solver-specific optimization options.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "Options are host metadata. Automatically resident option values gather transparently; explicit gpuArray option values are a gated RunMat extension."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::math::optim::optimoptions::tests"
+    },
+    "description": "`optimoptions(solver, name, value, ...)` builds solver-specific optimization metadata, and `optimoptions(existing, ...)` copies and updates an existing RunMat options struct.",
+    "behaviors": [
+        "RunMat implements a compatibility subset for its optimization solvers and currently returns a struct rather than MATLAB's solver-options object class.",
+        "Recognized option names, defaults, aliases, and validation depend on the selected solver.",
+        "Native integer option values are independently gated RunMat extensions because documented numeric options use floating classes.",
+        "Integer tolerances must be exactly representable before normalization to double. Integer iteration and evaluation limits are parsed as exact structural counts, and accepted 0/1 flag values become logical fields.",
+        "Automatically resident option values gather into host metadata. Explicit gpuArray option values are rejected in compatibility mode before gather."
+    ],
+    "examples": [
+        {
+            "description": "Create options for a nonlinear solver",
+            "input": "opts = optimoptions(\"fsolve\", \"TolX\", 1e-8, \"Display\", \"off\")",
+            "output": "opts is a RunMat options struct for fsolve"
+        }
+    ],
+    "links": [
+        {
+            "label": "optimset",
+            "url": "./optimset"
+        },
+        {
+            "label": "fsolve",
+            "url": "./fsolve"
+        },
+        {
+            "label": "lsqcurvefit",
+            "url": "./lsqcurvefit"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/math/optim/optimoptions.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/math/optim/optimoptions.rs"
+    },
+    "key": "optimoptions",
+    "slug": "optimoptions",
+    "aliases": [],
+    "categoryPath": [
+        "math",
+        "optim"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=optimoptions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"optimoptions.js","sourceRoot":"","sources":["../../../src/generated/builtins/optimoptions.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,cAAc;IACvB,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE;QACV,cAAc;QACd,cAAc;QACd,SAAS;QACT,MAAM;QACN,SAAS;QACT,SAAS;KACV;IACD,SAAS,EAAE,wDAAwD;IACnE,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,qJAAqJ;KAC/J;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;KACrD;IACD,aAAa,EAAE,gLAAgL;IAC/L,WAAW,EAAE;QACX,wJAAwJ;QACxJ,2FAA2F;QAC3F,iIAAiI;QACjI,qNAAqN;QACrN,mJAAmJ;KACpJ;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,uCAAuC;YACtD,OAAO,EAAE,uEAAuE;YAChF,QAAQ,EAAE,4CAA4C;SACvD;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,aAAa;YACtB,KAAK,EAAE,eAAe;SACvB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,iEAAiE;QAC1E,KAAK,EAAE,8GAA8G;KACtH;IACD,KAAK,EAAE,cAAc;IACrB,MAAM,EAAE,cAAc;IACtB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,OAAO;KACR;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/optimset.js

@@ -18,7 +18,7 @@ const builtinDoc = {
         "reduction": false,
         "precisions": [],
         "broadcasting": "none",
-        "notes": "Options are host metadata."
+        "notes": "Options are host metadata. Automatically resident payloads gather transparently; preserving explicit gpuArray payloads is a gated RunMat extension."
     },
     "fusion": {
         "elementwise": false,
@@ -35,6 +35,8 @@ const builtinDoc = {
         "Option names are case-insensitive for the builtins that consume them.",
         "`TolX`, `TolFun`, `MaxIter`, `MaxFunEvals`, `Display`, `Algorithm`, and `SpecifyObjectiveGradient` are canonicalized when constructed with `optimset`.",
         "`GradObj` is accepted as a MATLAB-compatible alias for `SpecifyObjectiveGradient`.",
+        "Documented numeric option values use single or double. Native integer payloads are a gated RunMat extension and retain their exact classes and values in the returned struct.",
+        "Automatically resident payloads gather into host metadata. Explicitly resident payloads are rejected in compatibility mode and preserved only when RunMat extensions are enabled.",
         "Unknown option names are preserved so future solvers can read them."
     ],
     "examples": [

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

@@ -1 +1 @@
-{"version":3,"file":"optimset.js","sourceRoot":"","sources":["../../../src/generated/builtins/optimset.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,UAAU;IACnB,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE;QACV,UAAU;QACV,SAAS;QACT,MAAM;QACN,QAAQ;QACR,SAAS;QACT,SAAS;QACT,0BAA0B;KAC3B;IACD,SAAS,EAAE,8FAA8F;IACzG,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,4BAA4B;KACtC;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,6KAA6K;IAC5L,WAAW,EAAE;QACX,uEAAuE;QACvE,wJAAwJ;QACxJ,oFAAoF;QACpF,qEAAqE;KACtE;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,4BAA4B;YAC3C,OAAO,EAAE,mFAAmF;YAC5F,QAAQ,EAAE,iBAAiB;SAC5B;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;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,6DAA6D;QACtE,KAAK,EAAE,0GAA0G;KAClH;IACD,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,OAAO;KACR;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"optimset.js","sourceRoot":"","sources":["../../../src/generated/builtins/optimset.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,UAAU;IACnB,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE;QACV,UAAU;QACV,SAAS;QACT,MAAM;QACN,QAAQ;QACR,SAAS;QACT,SAAS;QACT,0BAA0B;KAC3B;IACD,SAAS,EAAE,8FAA8F;IACzG,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,qJAAqJ;KAC/J;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,6KAA6K;IAC5L,WAAW,EAAE;QACX,uEAAuE;QACvE,wJAAwJ;QACxJ,oFAAoF;QACpF,+KAA+K;QAC/K,mLAAmL;QACnL,qEAAqE;KACtE;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,4BAA4B;YAC3C,OAAO,EAAE,mFAAmF;YAC5F,QAAQ,EAAE,iBAAiB;SAC5B;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;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,6DAA6D;QACtE,KAAK,EAAE,0GAA0G;KAClH;IACD,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,OAAO;KACR;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/or.js

@@ -35,11 +35,11 @@ const builtinDoc = {
     },
     "description": "`or(A, B)` returns logical true where either operand is nonzero, using MATLAB-compatible implicit expansion and logical conversion rules.",
     "behaviors": [
-        "Accepts logical, numeric, complex, and character arrays; character code points of zero evaluate to `false`.",
+        "MATLAB-compatible mode accepts logical and real numeric arrays, including every integer class with exact zero/nonzero truth semantics. RunMat compatibility mode additionally accepts complex and character arrays.",
         "Supports MATLAB-style implicit expansion so scalars and singleton dimensions broadcast automatically.",
         "Propagates empty dimensions: if a broadcasted axis has length `0`, the output is an empty logical array with the same shape.",
         "Treats `NaN` values as `true`, matching MATLAB's element-wise logical semantics.",
-        "Keeps `gpuArray` inputs on device when the active provider exposes the `logical_or` hook; otherwise the runtime gathers to host transparently."
+        "Uses a validated floating `logical_or` hook when available. Native integer handles bypass floating hooks and gather exactly; automatic residency may return to host, while explicit gpuArray inputs restore a logical gpuArray result."
     ],
     "examples": [
         {
@@ -83,7 +83,7 @@ const builtinDoc = {
         },
         {
             "question": "Can I use `or` with complex numbers?",
-            "answer": "Yes. Real or complex inputs return `true` when either the real or imaginary component is non-zero. For example, `or(0 + 0i, 0 + 2i)` returns `true`."
+            "answer": "Only in RunMat compatibility mode. Complex input is a classified RunMat extension where either nonzero component is true; MATLAB-compatible mode rejects it before dispatch. Character input is gated the same way."
         },
         {
             "question": "How does `or` differ from the `|` operator?",
@@ -91,7 +91,7 @@ const builtinDoc = {
         },
         {
             "question": "What happens when only one input is a `gpuArray`?",
-            "answer": "RunMat promotes the other input to the GPU before dispatch when the auto-offload planner decides it is profitable. If the provider lacks a device implementation, both operands gather to host automatically and the logical result executes on the CPU."
+            "answer": "The runtime may use provider execution when compatible. Otherwise it gathers transparently and computes exactly on the host; explicit gpuArray intent restores the logical result to the owning provider, while automatic residency may remain on host."
         }
     ],
     "links": [

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

@@ -1 +1 @@
-{"version":3,"file":"or.js","sourceRoot":"","sources":["../../../src/generated/builtins/or.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,IAAI;IACb,UAAU,EAAE,aAAa;IACzB,UAAU,EAAE;QACV,YAAY;QACZ,gBAAgB;QAChB,YAAY;QACZ,WAAW;QACX,aAAa;KACd;IACD,SAAS,EAAE,iGAAiG;IAC5G,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,oIAAoI;KAC9I;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,mCAAmC;QAC3C,aAAa,EAAE,qDAAqD;QACpE,KAAK,EAAE,8DAA8D;KACtE;IACD,aAAa,EAAE,2IAA2I;IAC1J,WAAW,EAAE;QACX,6GAA6G;QAC7G,uGAAuG;QACvG,8HAA8H;QAC9H,kFAAkF;QAClF,gJAAgJ;KACjJ;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,wCAAwC;YACvD,OAAO,EAAE,0BAA0B;YACnC,QAAQ,EAAE,kBAAkB;SAC7B;QACD;YACE,aAAa,EAAE,qDAAqD;YACpE,OAAO,EAAE,8CAA8C;YACvD,QAAQ,EAAE,oDAAoD;SAC/D;QACD;YACE,aAAa,EAAE,kDAAkD;YACjE,OAAO,EAAE,0CAA0C;YACnD,QAAQ,EAAE,6DAA6D;SACxE;QACD;YACE,aAAa,EAAE,sCAAsC;YACrD,OAAO,EAAE,8DAA8D;YACvE,QAAQ,EAAE,kDAAkD;SAC7D;QACD;YACE,aAAa,EAAE,oCAAoC;YACnD,OAAO,EAAE,oHAAoH;YAC7H,QAAQ,EAAE,qIAAqI;SAChJ;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,kCAAkC;YAC9C,QAAQ,EAAE,wRAAwR;SACnS;QACD;YACE,UAAU,EAAE,+BAA+B;YAC3C,QAAQ,EAAE,sHAAsH;SACjI;QACD;YACE,UAAU,EAAE,kCAAkC;YAC9C,QAAQ,EAAE,iLAAiL;SAC5L;QACD;YACE,UAAU,EAAE,sCAAsC;YAClD,QAAQ,EAAE,sJAAsJ;SACjK;QACD;YACE,UAAU,EAAE,6CAA6C;YACzD,QAAQ,EAAE,sOAAsO;SACjP;QACD;YACE,UAAU,EAAE,mDAAmD;YAC/D,QAAQ,EAAE,0PAA0P;SACrQ;KACF;IACD,OAAO,EAAE;QACP;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,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,wDAAwD;QACjE,KAAK,EAAE,qGAAqG;KAC7G;IACD,eAAe,EAAE,+YAA+Y;IACha,cAAc,EAAE;QACd,seAAse;KACve;IACD,KAAK,EAAE,IAAI;IACX,MAAM,EAAE,IAAI;IACZ,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,SAAS;QACT,KAAK;KACN;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"or.js","sourceRoot":"","sources":["../../../src/generated/builtins/or.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,IAAI;IACb,UAAU,EAAE,aAAa;IACzB,UAAU,EAAE;QACV,YAAY;QACZ,gBAAgB;QAChB,YAAY;QACZ,WAAW;QACX,aAAa;KACd;IACD,SAAS,EAAE,iGAAiG;IAC5G,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,oIAAoI;KAC9I;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,mCAAmC;QAC3C,aAAa,EAAE,qDAAqD;QACpE,KAAK,EAAE,8DAA8D;KACtE;IACD,aAAa,EAAE,2IAA2I;IAC1J,WAAW,EAAE;QACX,qNAAqN;QACrN,uGAAuG;QACvG,8HAA8H;QAC9H,kFAAkF;QAClF,wOAAwO;KACzO;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,wCAAwC;YACvD,OAAO,EAAE,0BAA0B;YACnC,QAAQ,EAAE,kBAAkB;SAC7B;QACD;YACE,aAAa,EAAE,qDAAqD;YACpE,OAAO,EAAE,8CAA8C;YACvD,QAAQ,EAAE,oDAAoD;SAC/D;QACD;YACE,aAAa,EAAE,kDAAkD;YACjE,OAAO,EAAE,0CAA0C;YACnD,QAAQ,EAAE,6DAA6D;SACxE;QACD;YACE,aAAa,EAAE,sCAAsC;YACrD,OAAO,EAAE,8DAA8D;YACvE,QAAQ,EAAE,kDAAkD;SAC7D;QACD;YACE,aAAa,EAAE,oCAAoC;YACnD,OAAO,EAAE,oHAAoH;YAC7H,QAAQ,EAAE,qIAAqI;SAChJ;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,kCAAkC;YAC9C,QAAQ,EAAE,wRAAwR;SACnS;QACD;YACE,UAAU,EAAE,+BAA+B;YAC3C,QAAQ,EAAE,sHAAsH;SACjI;QACD;YACE,UAAU,EAAE,kCAAkC;YAC9C,QAAQ,EAAE,iLAAiL;SAC5L;QACD;YACE,UAAU,EAAE,sCAAsC;YAClD,QAAQ,EAAE,qNAAqN;SAChO;QACD;YACE,UAAU,EAAE,6CAA6C;YACzD,QAAQ,EAAE,sOAAsO;SACjP;QACD;YACE,UAAU,EAAE,mDAAmD;YAC/D,QAAQ,EAAE,yPAAyP;SACpQ;KACF;IACD,OAAO,EAAE;QACP;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,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,wDAAwD;QACjE,KAAK,EAAE,qGAAqG;KAC7G;IACD,eAAe,EAAE,+YAA+Y;IACha,cAAc,EAAE;QACd,seAAse;KACve;IACD,KAAK,EAAE,IAAI;IACX,MAAM,EAAE,IAAI;IACZ,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,SAAS;QACT,KAAK;KACN;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

@@ -33,12 +33,13 @@ const builtinDoc = {
     "description": "`orderfields(S, ...)` reorders struct-field definitions using alphabetical order, another struct's field order, explicit field-name lists, or permutation vectors, following MATLAB-compatible behavior.",
     "behaviors": [
         "Works with scalar structs and struct arrays (RunMat stores struct arrays internally as cell arrays of structs).",
-        "The default behaviour `orderfields(S)` sorts field names alphabetically using MATLAB's case-insensitive ordering.",
+        "The default behavior `orderfields(S)` sorts valid field names in documented ASCII order, with uppercase letters before lowercase letters.",
         "`orderfields(S, referenceStruct)` matches the order of `referenceStruct`. Both structs must contain the same field names.",
         "`orderfields(S, {'b','a','c'})` or `orderfields(S, string(['b','a','c']))` uses the supplied list of field names.",
         "`orderfields(S, [2 1 3])` reorders fields using a permutation vector that references the current field order.",
+        "Permutation scalars and vectors accept all eight integer classes and are validated exactly; a one-field structure therefore accepts an exact typed scalar `1`.",
         "`[T, P] = orderfields(S, ___)` returns the reordered struct (or struct array) `T` and a permutation vector `P` whose elements are the original 1-based field positions. Reuse `P` to apply the same order to other structs that share the field set.",
-        "The function never copies field contents unnecessarily—values (including GPU handles) are re-used and remain resident.",
+        "Integer field contents retain exact class, shape, and value, and nested GPU handles retain residency/provenance; field reordering performs no payload gather or floating materialization.",
         "Errors are raised when requested field names do not match the struct, when indices are invalid, or when the input is not a struct."
     ],
     "examples": [

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

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

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

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

package/dist/generated/builtins/ordinal.js

@@ -15,7 +15,7 @@ const builtinDoc = {
         "reduction": false,
         "precisions": [],
         "broadcasting": "none",
-        "notes": "Ordinal categorical arrays are host metadata objects."
+        "notes": "Ordinal compatibility objects are host metadata. Automatic residency gathers transparently; explicit gpuArray host construction is a declared RunMat extension."
     },
     "fusion": {
         "elementwise": false,
@@ -26,14 +26,16 @@ const builtinDoc = {
     "requires_feature": null,
     "tested": {
         "unit": "builtins::table::tests::ordinal_constructor_sets_ordered_categorical_semantics",
-        "integration": "crates/runmat-vm/tests/tables_timetables.rs"
+        "integration": "crates/runmat-vm/tests/integer_label_and_text_control_semantics.rs"
     },
-    "description": "`ordinal(A)` creates a categorical object whose categories are ordered. It is a compatibility constructor equivalent to `categorical(..., 'Ordinal', true)`.",
+    "description": "`ordinal(X)` creates an ordered compatibility object from the sorted unique levels of `X`. Labels, explicit levels, and numeric bin edges follow the public ordinal argument order.",
     "behaviors": [
         "String, char, cellstr, numeric, and logical inputs are accepted through the same label conversion path as `categorical`.",
-        "`ordinal(A)` derives sorted unique categories from non-missing labels.",
-        "`ordinal(A, categories)` uses the supplied category order and marks labels not present in that list as missing.",
-        "`ordinal(A, valueset, catnames)` maps source values through `valueset` and stores the corresponding category names from `catnames`.",
+        "`ordinal(X)` derives sorted unique levels from non-missing values and creates default labels.",
+        "`ordinal(X, labels)` assigns the supplied text labels to the sorted unique levels; duplicate labels merge levels.",
+        "`ordinal(X, labels, levels)` uses the explicit comparable level vector and marks source values absent from it as undefined.",
+        "`ordinal(X, labels, [], edges)` bins numeric source values into left-closed, right-open intervals, with the final edge included in the last bin.",
+        "Integer source values, explicit levels, and edges use exact native comparison across all eight classes. Default numeric display labels retain the established five-significant-digit formatting and collision rejection.",
         "The returned object has class `categorical`, stores one-based category codes, and has its `Ordinal` metadata flag set to true.",
         "Equality and relational operators compare category order; categorical-to-categorical comparisons require matching category lists.",
         "`min` and `max` reduce ordinal categorical arrays by category order and return categorical results; undefined elements follow the numeric `NaN` behavior of `includenan` and `omitnan`, and multi-output forms return numeric indices."

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

@@ -1 +1 @@
-{"version":3,"file":"ordinal.js","sourceRoot":"","sources":["../../../src/generated/builtins/ordinal.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,OAAO;IACnB,UAAU,EAAE;QACV,SAAS;QACT,aAAa;QACb,YAAY;QACZ,YAAY;KACb;IACD,SAAS,EAAE,6CAA6C;IACxD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,uDAAuD;KACjE;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,gFAAgF;QACxF,aAAa,EAAE,6CAA6C;KAC7D;IACD,aAAa,EAAE,8JAA8J;IAC7K,WAAW,EAAE;QACX,0HAA0H;QAC1H,wEAAwE;QACxE,iHAAiH;QACjH,qIAAqI;QACrI,gIAAgI;QAChI,mIAAmI;QACnI,wOAAwO;KACzO;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,qCAAqC;YACpD,OAAO,EAAE,yDAAyD;YAClE,QAAQ,EAAE,wBAAwB;SACnC;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,gDAAgD;YAC5D,QAAQ,EAAE,gKAAgK;SAC3K;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,aAAa;YACtB,KAAK,EAAE,eAAe;SACvB;QACD;YACE,OAAO,EAAE,eAAe;YACxB,KAAK,EAAE,iBAAiB;SACzB;QACD;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;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;KACR;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"ordinal.js","sourceRoot":"","sources":["../../../src/generated/builtins/ordinal.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,OAAO;IACnB,UAAU,EAAE;QACV,SAAS;QACT,aAAa;QACb,YAAY;QACZ,YAAY;KACb;IACD,SAAS,EAAE,6CAA6C;IACxD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,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,gFAAgF;QACxF,aAAa,EAAE,oEAAoE;KACpF;IACD,aAAa,EAAE,qLAAqL;IACpM,WAAW,EAAE;QACX,0HAA0H;QAC1H,+FAA+F;QAC/F,mHAAmH;QACnH,6HAA6H;QAC7H,kJAAkJ;QAClJ,0NAA0N;QAC1N,gIAAgI;QAChI,mIAAmI;QACnI,wOAAwO;KACzO;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,qCAAqC;YACpD,OAAO,EAAE,yDAAyD;YAClE,QAAQ,EAAE,wBAAwB;SACnC;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,gDAAgD;YAC5D,QAAQ,EAAE,gKAAgK;SAC3K;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,aAAa;YACtB,KAAK,EAAE,eAAe;SACvB;QACD;YACE,OAAO,EAAE,eAAe;YACxB,KAAK,EAAE,iBAAiB;SACzB;QACD;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;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;KACR;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/pad.js

@@ -17,7 +17,7 @@ const builtinDoc = {
         "reduction": false,
         "precisions": [],
         "broadcasting": "none",
-        "notes": "Executes on the CPU; GPU-resident inputs are gathered before padding so behaviour matches MATLAB."
+        "notes": "Text inputs are host-only. Automatically placed numeric length controls gather transparently; explicit gpuArray length controls are unsupported."
     },
     "fusion": {
         "elementwise": false,
@@ -28,12 +28,12 @@ const builtinDoc = {
     "requires_feature": null,
     "tested": {
         "unit": "builtins::strings::transform::pad::tests",
-        "integration": "builtins::strings::transform::pad::tests::pad_cell_array_mixed_content"
+        "integration": "integer_pattern_and_string_transform_semantics"
     },
     "description": "`pad` extends string/char/cellstr text values to requested lengths by adding fill characters on left, right, or both sides, using MATLAB-compatible defaults and option parsing.",
     "behaviors": [
         "Without a target length, `pad` extends each element to match the longest text in the input.",
-        "Providing a numeric target guarantees a minimum length; existing text that already meets or exceeds the target is returned unchanged.",
+        "Providing a nonnegative scalar target guarantees a minimum length; single, double, and all eight integer classes are accepted from authoritative native storage, and existing text that already meets or exceeds the target is returned unchanged.",
         "Direction keywords (`'left'`, `'right'`, `'both'`) are case-insensitive; `'right'` is the default. When an odd number of pad characters is required for `'both'`, the extra character is appended to the end.",
         "`padChar` must be a single character (string scalar or 1×1 char array). The default is a space.",
         "Character arrays remain rectangular. Each row is padded independently and then widened with spaces so the array keeps MATLAB’s column-major layout.",
@@ -103,7 +103,7 @@ const builtinDoc = {
         },
         {
             "question": "Will `pad` run on the GPU in the future?",
-            "answer": "Possibly, but today it always gathers to the CPU. Providers may add device-side implementations later, and the behaviour documented here will remain the reference."
+            "answer": "The text operation is host-only. Automatically placed numeric length controls gather transparently, while explicit gpuArray length controls reject."
         }
     ],
     "links": [
@@ -164,9 +164,9 @@ const builtinDoc = {
         "label": "`crates/runmat-runtime/src/builtins/strings/transform/pad.rs`",
         "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/strings/transform/pad.rs"
     },
-    "gpu_residency": "No. Text data in RunMat lives on the host today. If text happens to originate from a GPU computation, `pad` automatically gathers it before padding, so you never have to manage residency manually for this builtin.",
+    "gpu_residency": "Text data is host-only. Automatically placed numeric length controls gather transparently; explicit gpuArray length controls reject before gather.",
     "gpu_behavior": [
-        "`pad` always executes on the CPU. When an argument (or a value nested inside a cell array) lives on the GPU, RunMat gathers it, performs the padding step, and produces a host result or re-wraps the padded value inside the cell. No provider hooks exist yet for string padding, so providers and fusion planners treat `pad` as a sink that terminates device residency."
+        "`pad` executes on the CPU. Numeric resident values in the text role reject without provider access, while an admitted automatic length control gathers through its owning provider."
     ],
     "key": "pad",
     "slug": "pad",

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

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

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

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

package/dist/generated/builtins/pagefun.js

@@ -34,10 +34,12 @@ const builtinDoc = {
     },
     "description": "`pagefun(func, A, B, ...)` applies supported operators independently across pages indexed by third-and-higher dimensions, following MATLAB-compatible pagewise execution semantics.",
     "behaviors": [
-        "Accepts function handles, builtin names (character vectors or string scalars), and validates that the requested operator is supported.",
+        "MATLAB-compatible calls require a function handle. In `runmat` compatibility mode, builtin names supplied as character vectors or string scalars are accepted as a RunMat extension.",
         "The first two dimensions of each input form the matrix operated on by the builtin. Dimensions three and up identify individual pages. Inputs with fewer pages are broadcast so long as the page extent is `1`.",
         "Any combination of empty matrices and empty page extents produces empty results with MATLAB-compatible shapes.",
-        "When all operands are `gpuArray` values the builtin gathers data to the host if the registered acceleration provider cannot satisfy the request. Uniform numeric results are uploaded back to the GPU so later operations retain residency."
+        "MATLAB-compatible calls require at least one distributed or `gpuArray` input. In `runmat` compatibility mode, all-host operands are accepted as a RunMat extension and return host results.",
+        "When any operand is a `gpuArray`, provider fallback gathers inputs through the provider that owns them and restores supported results to that same provider. Automatic residency remains transparent, while an explicit `gpuArray` remains resident whenever its class can be represented by the owner.",
+        "Integer operands inherit the selected function's contract. For `@mtimes`, one operand must be scalar when either operand is an integer class; each page uses exact native integer storage, applies the class-preserving saturation rules of `mtimes`, and never passes through a floating copy."
     ],
     "examples": [
         {
@@ -74,7 +76,7 @@ const builtinDoc = {
         },
         {
             "question": "Are results always uploaded back to the GPU?",
-            "answer": "Numeric results are uploaded when every operand started as a `gpuArray` and an acceleration provider is registered. Complex results remain on the host today, matching MATLAB's behaviour when complex GPU buffers are not available."
+            "answer": "When any operand is a `gpuArray` and an acceleration provider is registered, supported uniform real or complex numeric results are uploaded back to the device. An all-host RunMat-extension call returns a host result."
         },
         {
             "question": "Does `pagefun` participate in fusion?",
@@ -107,9 +109,9 @@ const builtinDoc = {
         "label": "`crates/runmat-runtime/src/builtins/acceleration/gpu/pagefun.rs`",
         "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/acceleration/gpu/pagefun.rs"
     },
-    "gpu_residency": "No. RunMat's auto-offload planner migrates tensors to the GPU when beneficial. When you explicitly pass `gpuArray` inputs, `pagefun` keeps numeric results on the device whenever all operands were device-resident and the provider can accept uploads. Complex outputs remain host-resident until device buffers for complex doubles ship.",
+    "gpu_residency": "No. RunMat's auto-offload planner migrates tensors to the GPU when beneficial. When you explicitly pass any `gpuArray` input, `pagefun` returns supported real or complex numeric results on the device whenever the provider can accept the upload.",
     "gpu_behavior": [
-        "RunMat Accelerate exposes a custom `pagefun` provider hook. When the active provider implements it (the WGPU backend does for `@mtimes`), pages stay on the device and execute via a tiled compute shader. If the provider does not support the requested operator the runtime gathers the data to the host, evaluates using the CPU builtin, and re-uploads numeric outputs so subsequent GPU work can stay resident."
+        "RunMat Accelerate exposes a custom `pagefun` provider hook. When every operand is a floating `gpuArray` and the owning provider implements the operation (the WGPU backend does for `@mtimes`), pages stay on the device and execute via a tiled compute shader. Mixed host/GPU inputs, integer pages, and unsupported provider operations use owner-aware host fallback; exact native storage is retained and supported outputs are restored to the original provider."
     ],
     "key": "pagefun",
     "slug": "pagefun",

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

@@ -1 +1 @@
-{"version":3,"file":"pagefun.js","sourceRoot":"","sources":["../../../src/generated/builtins/pagefun.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,kBAAkB;IAC9B,UAAU,EAAE;QACV,SAAS;QACT,UAAU;QACV,yBAAyB;QACzB,QAAQ;QACR,OAAO;KACR;IACD,SAAS,EAAE,uEAAuE;IAClF,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;YACL,KAAK;SACN;QACD,cAAc,EAAE,QAAQ;QACxB,OAAO,EAAE,6IAA6I;KACvJ;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,6CAA6C;QACrD,aAAa,EAAE,2EAA2E;KAC3F;IACD,aAAa,EAAE,qLAAqL;IACpM,WAAW,EAAE;QACX,wIAAwI;QACxI,gNAAgN;QAChN,gHAAgH;QAChH,6OAA6O;KAC9O;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,4CAA4C;YAC3D,OAAO,EAAE,uFAAuF;YAChG,QAAQ,EAAE,4HAA4H;SACvI;QACD;YACE,aAAa,EAAE,mDAAmD;YAClE,OAAO,EAAE,iHAAiH;SAC3H;QACD;YACE,aAAa,EAAE,gCAAgC;YAC/C,OAAO,EAAE,6KAA6K;SACvL;QACD;YACE,aAAa,EAAE,gCAAgC;YAC/C,OAAO,EAAE,2DAA2D;YACpE,QAAQ,EAAE,2BAA2B;SACtC;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,+CAA+C;YAC3D,QAAQ,EAAE,+IAA+I;SAC1J;QACD;YACE,UAAU,EAAE,mCAAmC;YAC/C,QAAQ,EAAE,qOAAqO;SAChP;QACD;YACE,UAAU,EAAE,6CAA6C;YACzD,QAAQ,EAAE,+NAA+N;SAC1O;QACD;YACE,UAAU,EAAE,8CAA8C;YAC1D,QAAQ,EAAE,uOAAuO;SAClP;QACD;YACE,UAAU,EAAE,uCAAuC;YACnD,QAAQ,EAAE,qJAAqJ;SAChK;KACF;IACD,OAAO,EAAE;QACP;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;QACD;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;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,eAAe,EAAE,8UAA8U;IAC/V,cAAc,EAAE;QACd,wZAAwZ;KACzZ;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,cAAc;QACd,KAAK;KACN;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"pagefun.js","sourceRoot":"","sources":["../../../src/generated/builtins/pagefun.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,kBAAkB;IAC9B,UAAU,EAAE;QACV,SAAS;QACT,UAAU;QACV,yBAAyB;QACzB,QAAQ;QACR,OAAO;KACR;IACD,SAAS,EAAE,uEAAuE;IAClF,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;YACL,KAAK;SACN;QACD,cAAc,EAAE,QAAQ;QACxB,OAAO,EAAE,6IAA6I;KACvJ;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,6CAA6C;QACrD,aAAa,EAAE,2EAA2E;KAC3F;IACD,aAAa,EAAE,qLAAqL;IACpM,WAAW,EAAE;QACX,sLAAsL;QACtL,gNAAgN;QAChN,gHAAgH;QAChH,6LAA6L;QAC7L,ySAAyS;QACzS,iSAAiS;KAClS;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,4CAA4C;YAC3D,OAAO,EAAE,uFAAuF;YAChG,QAAQ,EAAE,4HAA4H;SACvI;QACD;YACE,aAAa,EAAE,mDAAmD;YAClE,OAAO,EAAE,iHAAiH;SAC3H;QACD;YACE,aAAa,EAAE,gCAAgC;YAC/C,OAAO,EAAE,6KAA6K;SACvL;QACD;YACE,aAAa,EAAE,gCAAgC;YAC/C,OAAO,EAAE,2DAA2D;YACpE,QAAQ,EAAE,2BAA2B;SACtC;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,+CAA+C;YAC3D,QAAQ,EAAE,+IAA+I;SAC1J;QACD;YACE,UAAU,EAAE,mCAAmC;YAC/C,QAAQ,EAAE,qOAAqO;SAChP;QACD;YACE,UAAU,EAAE,6CAA6C;YACzD,QAAQ,EAAE,+NAA+N;SAC1O;QACD;YACE,UAAU,EAAE,8CAA8C;YAC1D,QAAQ,EAAE,0NAA0N;SACrO;QACD;YACE,UAAU,EAAE,uCAAuC;YACnD,QAAQ,EAAE,qJAAqJ;SAChK;KACF;IACD,OAAO,EAAE;QACP;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;QACD;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;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,eAAe,EAAE,sPAAsP;IACvQ,cAAc,EAAE;QACd,ycAAyc;KAC1c;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,cAAc;QACd,KAAK;KACN;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/pagemtimes.js

@@ -38,7 +38,8 @@ const builtinDoc = {
         "`transpX` and `transpY` must both be present in the four-argument form and each must be `none`, `transpose`, or `ctranspose`.",
         "The first two dimensions of each input form the matrix multiplied on each page. Page dimensions are dimensions three and higher and are expanded by position when one side has extent `1` or omits the trailing dimension.",
         "If either operand is scalar, the result uses the first two dimensions of the nonscalar operand and performs page-wise scalar multiplication.",
-        "Dense `double`, `single`, and complex double arrays are supported. Integer, logical, sparse, cell, struct, object, and text inputs are rejected.",
+        "Dense `double`, `single`, and complex double arrays are supported. MATLAB-compatible modes reject integer, logical, sparse, cell, struct, object, and text inputs.",
+        "RunMat mode additionally accepts real arrays in all eight integer classes when every value is exactly representable as binary64. This named extension returns double and rejects wider values instead of rounding them; resident integer inputs use an exact owner-aware gather and restore path rather than a floating provider kernel.",
         "Complex `ctranspose` conjugates each page before multiplication; `transpose` only swaps the first two dimensions."
     ],
     "examples": [

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

@@ -1 +1 @@
-{"version":3,"file":"pagemtimes.js","sourceRoot":"","sources":["../../../src/generated/builtins/pagemtimes.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,YAAY;IACrB,UAAU,EAAE,iBAAiB;IAC7B,UAAU,EAAE;QACV,YAAY;QACZ,iCAAiC;QACjC,yBAAyB;QACzB,gBAAgB;QAChB,UAAU;KACX;IACD,SAAS,EAAE,sDAAsD;IACjE,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;YACL,KAAK;SACN;QACD,cAAc,EAAE,QAAQ;QACxB,OAAO,EAAE,0JAA0J;KACpK;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,gDAAgD;QACxD,aAAa,EAAE,oFAAoF;KACpG;IACD,aAAa,EAAE,4LAA4L;IAC3M,WAAW,EAAE;QACX,2EAA2E;QAC3E,+HAA+H;QAC/H,4NAA4N;QAC5N,8IAA8I;QAC9I,kJAAkJ;QAClJ,mHAAmH;KACpH;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,yBAAyB;YACxC,OAAO,EAAE,+EAA+E;SACzF;QACD;YACE,aAAa,EAAE,qCAAqC;YACpD,OAAO,EAAE,8DAA8D;SACxE;QACD;YACE,aAAa,EAAE,uBAAuB;YACtC,OAAO,EAAE,sFAAsF;YAC/F,QAAQ,EAAE,2BAA2B;SACtC;QACD;YACE,aAAa,EAAE,uCAAuC;YACtD,OAAO,EAAE,yEAAyE;YAClF,QAAQ,EAAE,iCAAiC;SAC5C;QACD;YACE,aAAa,EAAE,mCAAmC;YAClD,OAAO,EAAE,iFAAiF;SAC3F;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,6CAA6C;YACzD,QAAQ,EAAE,+MAA+M;SAC1N;QACD;YACE,UAAU,EAAE,0CAA0C;YACtD,QAAQ,EAAE,kIAAkI;SAC7I;QACD;YACE,UAAU,EAAE,iDAAiD;YAC7D,QAAQ,EAAE,yHAAyH;SACpI;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;QACD;YACE,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,cAAc;SACtB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,oEAAoE;QAC7E,KAAK,EAAE,iHAAiH;KACzH;IACD,eAAe,EAAE,mLAAmL;IACpM,cAAc,EAAE;QACd,6IAA6I;QAC7I,uKAAuK;KACxK;IACD,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,YAAY;IACpB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,QAAQ;QACR,KAAK;KACN;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"pagemtimes.js","sourceRoot":"","sources":["../../../src/generated/builtins/pagemtimes.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,YAAY;IACrB,UAAU,EAAE,iBAAiB;IAC7B,UAAU,EAAE;QACV,YAAY;QACZ,iCAAiC;QACjC,yBAAyB;QACzB,gBAAgB;QAChB,UAAU;KACX;IACD,SAAS,EAAE,sDAAsD;IACjE,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;YACL,KAAK;SACN;QACD,cAAc,EAAE,QAAQ;QACxB,OAAO,EAAE,0JAA0J;KACpK;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,gDAAgD;QACxD,aAAa,EAAE,oFAAoF;KACpG;IACD,aAAa,EAAE,4LAA4L;IAC3M,WAAW,EAAE;QACX,2EAA2E;QAC3E,+HAA+H;QAC/H,4NAA4N;QAC5N,8IAA8I;QAC9I,oKAAoK;QACpK,0UAA0U;QAC1U,mHAAmH;KACpH;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,yBAAyB;YACxC,OAAO,EAAE,+EAA+E;SACzF;QACD;YACE,aAAa,EAAE,qCAAqC;YACpD,OAAO,EAAE,8DAA8D;SACxE;QACD;YACE,aAAa,EAAE,uBAAuB;YACtC,OAAO,EAAE,sFAAsF;YAC/F,QAAQ,EAAE,2BAA2B;SACtC;QACD;YACE,aAAa,EAAE,uCAAuC;YACtD,OAAO,EAAE,yEAAyE;YAClF,QAAQ,EAAE,iCAAiC;SAC5C;QACD;YACE,aAAa,EAAE,mCAAmC;YAClD,OAAO,EAAE,iFAAiF;SAC3F;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,6CAA6C;YACzD,QAAQ,EAAE,+MAA+M;SAC1N;QACD;YACE,UAAU,EAAE,0CAA0C;YACtD,QAAQ,EAAE,kIAAkI;SAC7I;QACD;YACE,UAAU,EAAE,iDAAiD;YAC7D,QAAQ,EAAE,yHAAyH;SACpI;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;QACD;YACE,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,cAAc;SACtB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,oEAAoE;QAC7E,KAAK,EAAE,iHAAiH;KACzH;IACD,eAAe,EAAE,mLAAmL;IACpM,cAAc,EAAE;QACd,6IAA6I;QAC7I,uKAAuK;KACxK;IACD,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,YAAY;IACpB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,QAAQ;QACR,KAAK;KACN;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/pagetranspose.js

@@ -38,10 +38,10 @@ const builtinDoc = {
         "Equivalent to `permute(X,[2 1 3:ndims(X)])` for dense arrays.",
         "Works for scalars, vectors, matrices, and N-D arrays; only the first two axes are swapped.",
         "Complex values are not conjugated. Compose with `conj` when Hermitian page transpose semantics are needed.",
-        "Logical, character, string, and cell arrays preserve their element type while their first two dimensions are swapped.",
+        "All eight integer classes, logical, character, string, and cell arrays preserve their element type while their first two dimensions are swapped. Integer payloads, including values above `flintmax`, are permuted without a floating conversion.",
         "Sparse matrices transpose through RunMat's sparse CSC transpose path.",
         "Scalar structs are treated as 1-by-1 values and round-trip unchanged; true struct-array permutation will follow RunMat's struct-array representation when that lands.",
-        "gpuArray inputs remain device-resident when a provider is available; otherwise they fall back to host execution."
+        "gpuArray inputs remain device-resident when a provider is available; unsupported integer layouts use transparent exact-owner gather and class-preserving restoration."
     ],
     "examples": [
         {

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

@@ -1 +1 @@
-{"version":3,"file":"pagetranspose.js","sourceRoot":"","sources":["../../../src/generated/builtins/pagetranspose.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,eAAe;IACxB,UAAU,EAAE,iBAAiB;IAC7B,UAAU,EAAE;QACV,eAAe;QACf,qBAAqB;QACrB,yBAAyB;QACzB,SAAS;QACT,UAAU;KACX;IACD,SAAS,EAAE,oEAAoE;IAC/E,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;YACL,KAAK;YACL,KAAK;YACL,MAAM;SACP;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,oMAAoM;KAC9M;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,mDAAmD;KAC5D;IACD,aAAa,EAAE,qNAAqN;IACpO,WAAW,EAAE;QACX,+DAA+D;QAC/D,4FAA4F;QAC5F,4GAA4G;QAC5G,uHAAuH;QACvH,uEAAuE;QACvE,uKAAuK;QACvK,kHAAkH;KACnH;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,oCAAoC;YACnD,OAAO,EAAE,6DAA6D;YACtE,QAAQ,EAAE,eAAe;SAC1B;QACD;YACE,aAAa,EAAE,6CAA6C;YAC5D,OAAO,EAAE,0DAA0D;YACnE,QAAQ,EAAE,+CAA+C;SAC1D;QACD;YACE,aAAa,EAAE,0DAA0D;YACzE,OAAO,EAAE,qDAAqD;YAC9D,QAAQ,EAAE,gBAAgB;SAC3B;QACD;YACE,aAAa,EAAE,qDAAqD;YACpE,OAAO,EAAE,oEAAoE;YAC7E,QAAQ,EAAE,iBAAiB;SAC5B;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,mDAAmD;YAC/D,QAAQ,EAAE,uKAAuK;SAClL;QACD;YACE,UAAU,EAAE,iDAAiD;YAC7D,QAAQ,EAAE,iDAAiD;SAC5D;QACD;YACE,UAAU,EAAE,8CAA8C;YAC1D,QAAQ,EAAE,gFAAgF;SAC3F;QACD;YACE,UAAU,EAAE,uBAAuB;YACnC,QAAQ,EAAE,wGAAwG;SACnH;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;QACD;YACE,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,cAAc;SACtB;QACD;YACE,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,cAAc;SACtB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,uEAAuE;QAChF,KAAK,EAAE,oHAAoH;KAC5H;IACD,eAAe,EAAE,gFAAgF;IACjG,cAAc,EAAE;QACd,yFAAyF;QACzF,iJAAiJ;KAClJ;IACD,KAAK,EAAE,eAAe;IACtB,MAAM,EAAE,eAAe;IACvB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,QAAQ;QACR,KAAK;KACN;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"pagetranspose.js","sourceRoot":"","sources":["../../../src/generated/builtins/pagetranspose.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,eAAe;IACxB,UAAU,EAAE,iBAAiB;IAC7B,UAAU,EAAE;QACV,eAAe;QACf,qBAAqB;QACrB,yBAAyB;QACzB,SAAS;QACT,UAAU;KACX;IACD,SAAS,EAAE,oEAAoE;IAC/E,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,KAAK;YACL,KAAK;YACL,KAAK;YACL,MAAM;SACP;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,oMAAoM;KAC9M;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,mDAAmD;KAC5D;IACD,aAAa,EAAE,qNAAqN;IACpO,WAAW,EAAE;QACX,+DAA+D;QAC/D,4FAA4F;QAC5F,4GAA4G;QAC5G,mPAAmP;QACnP,uEAAuE;QACvE,uKAAuK;QACvK,uKAAuK;KACxK;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,oCAAoC;YACnD,OAAO,EAAE,6DAA6D;YACtE,QAAQ,EAAE,eAAe;SAC1B;QACD;YACE,aAAa,EAAE,6CAA6C;YAC5D,OAAO,EAAE,0DAA0D;YACnE,QAAQ,EAAE,+CAA+C;SAC1D;QACD;YACE,aAAa,EAAE,0DAA0D;YACzE,OAAO,EAAE,qDAAqD;YAC9D,QAAQ,EAAE,gBAAgB;SAC3B;QACD;YACE,aAAa,EAAE,qDAAqD;YACpE,OAAO,EAAE,oEAAoE;YAC7E,QAAQ,EAAE,iBAAiB;SAC5B;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,mDAAmD;YAC/D,QAAQ,EAAE,uKAAuK;SAClL;QACD;YACE,UAAU,EAAE,iDAAiD;YAC7D,QAAQ,EAAE,iDAAiD;SAC5D;QACD;YACE,UAAU,EAAE,8CAA8C;YAC1D,QAAQ,EAAE,gFAAgF;SAC3F;QACD;YACE,UAAU,EAAE,uBAAuB;YACnC,QAAQ,EAAE,wGAAwG;SACnH;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;QACD;YACE,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,cAAc;SACtB;QACD;YACE,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,cAAc;SACtB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,uEAAuE;QAChF,KAAK,EAAE,oHAAoH;KAC5H;IACD,eAAe,EAAE,gFAAgF;IACjG,cAAc,EAAE;QACd,yFAAyF;QACzF,iJAAiJ;KAClJ;IACD,KAAK,EAAE,eAAe;IACtB,MAAM,EAAE,eAAe;IACvB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,QAAQ;QACR,KAAK;KACN;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/pan.js

@@ -55,7 +55,8 @@ const builtinDoc = {
     ],
     "notes": [
         "Statement-form `pan()` toggles pan mode. Output-form `p = pan()` returns a pan handle object.",
-        "The pan object supports `Enable`, `Motion`, `UIContextMenu`, `ButtonDownFilter`, `ActionPreCallback`, `ActionPostCallback`, and `FigureHandle` properties."
+        "The pan object supports `Enable`, `Motion`, `UIContextMenu`, `ButtonDownFilter`, `ActionPreCallback`, `ActionPostCallback`, and `FigureHandle` properties.",
+        "`Enable` accepts exact numeric or logical scalar 0 and 1, including all native integer classes. Typed-integer numeric aliases for figure or axes objects are a separately gated RunMat graphics-handle extension."
     ],
     "gpu_residency": "`pan` mutates plotting interaction metadata only. It does not gather or copy GPU-resident plot data.",
     "related": [