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

package/dist/generated/builtins/groupsummary.js

@@ -0,0 +1,81 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "groupsummary",
+    "category": "table",
+    "keywords": [
+        "groupsummary",
+        "group",
+        "table",
+        "array",
+        "statistics",
+        "groupbins"
+    ],
+    "summary": "Compute summary statistics by group for table or array data.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "Grouping runs on the host. Automatic internal residency gathers transparently; explicit interactive gpuArray input is a declared RunMat-only extension."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 0,
+        "constants": "none"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::table::builtins::analytics::integer_compatibility_tests",
+        "integration": "crates/runmat-vm/tests/integer_statistical_semantics.rs"
+    },
+    "description": "`groupsummary` groups table rows or array observations and computes per-group statistics. Table input returns a table; array input returns the concatenated summary array and can additionally return grouping vectors and counts.",
+    "behaviors": [
+        "Table forms support grouping-variable selectors, selected data variables, and the implemented mean, sum, median, min, max, count, and numel methods.",
+        "Array forms support numeric vectors, matrices, and cell arrays of numeric arrays. Matrix columns become independent data or grouping columns, and `[B,BG,BC]` returns summaries, exact group values, and double counts.",
+        "All eight integer classes are supported as documented grouping and numeric data. Group comparison, integer extrema, and array/table output reconstruction use authoritative typed storage, including distinct uint64 values above flintmax.",
+        "Floating summary methods deliberately enter a checked binary64 computation boundary. Wide integer values that cannot be represented exactly reject instead of silently merging or rounding.",
+        "The one-group numeric-edge and positive-bin-count forms support IncludedEdge, IncludeEmptyGroups, and IncludeMissingGroups, with exact integer comparisons. Multi-group bin specifications and time bins are not currently supported.",
+        "Native typed-integer bin counts and boolean controls are independently gated RunMat extensions; equivalent scalar-double and logical controls remain available in MATLAB-compatible mode.",
+        "Additional named methods, function-handle methods, and some table selector forms are not currently supported."
+    ],
+    "examples": [
+        {
+            "description": "Summarize an array and return groups",
+            "input": "[B,BG,BC] = groupsummary([10;20;30],[1;1;2],'mean')",
+            "output": "B = [15;30], BG = [1;2], and BC = [2;1]."
+        },
+        {
+            "description": "Preserve wide integer groups",
+            "input": "base=uint64(9007199254740992); [B,BG]=groupsummary([base+3;base+1;base+4],[base;base+1;base],'max')",
+            "output": "B and BG remain uint64 and preserve adjacent values above flintmax."
+        }
+    ],
+    "links": [
+        {
+            "label": "groupcounts",
+            "url": "./groupcounts"
+        },
+        {
+            "label": "findgroups",
+            "url": "./findgroups"
+        },
+        {
+            "label": "splitapply",
+            "url": "./splitapply"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/table/builtins/analytics.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/table/builtins/analytics.rs"
+    },
+    "key": "groupsummary",
+    "slug": "groupsummary",
+    "aliases": [],
+    "categoryPath": [
+        "table"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=groupsummary.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"groupsummary.js","sourceRoot":"","sources":["../../../src/generated/builtins/groupsummary.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,cAAc;IACvB,UAAU,EAAE,OAAO;IACnB,UAAU,EAAE;QACV,cAAc;QACd,OAAO;QACP,OAAO;QACP,OAAO;QACP,YAAY;QACZ,WAAW;KACZ;IACD,SAAS,EAAE,8DAA8D;IACzE,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,yJAAyJ;KACnK;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,mEAAmE;QAC3E,aAAa,EAAE,yDAAyD;KACzE;IACD,aAAa,EAAE,oOAAoO;IACnP,WAAW,EAAE;QACX,sJAAsJ;QACtJ,yNAAyN;QACzN,6OAA6O;QAC7O,6LAA6L;QAC7L,uOAAuO;QACvO,2LAA2L;QAC3L,+GAA+G;KAChH;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,sCAAsC;YACrD,OAAO,EAAE,qDAAqD;YAC9D,QAAQ,EAAE,0CAA0C;SACrD;QACD;YACE,aAAa,EAAE,8BAA8B;YAC7C,OAAO,EAAE,qGAAqG;YAC9G,QAAQ,EAAE,qEAAqE;SAChF;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,aAAa;YACtB,KAAK,EAAE,eAAe;SACvB;QACD;YACE,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,cAAc;SACtB;QACD;YACE,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,cAAc;SACtB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,kEAAkE;QAC3E,KAAK,EAAE,+GAA+G;KACvH;IACD,KAAK,EAAE,cAAc;IACrB,MAAM,EAAE,cAAc;IACtB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;KACR;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/hann.js

@@ -11,7 +11,7 @@ const builtinDoc = {
         "fft"
     ],
     "summary": "Generate Hann windows in MATLAB and RunMat.",
-    "description": "`hann(L)` returns an L-by-1 Hann window. Symmetric/periodic forms and optional single-precision output follow MATLAB semantics.",
+    "description": "`hann(L)` returns an L-by-1 Hann window using the compatibility target's `cospi` formulation. `L` accepts floating input and every integer class; logical scalar lengths are available only when RunMat extensions are enabled. Symmetric/periodic forms and optional single-precision output follow MATLAB semantics.",
     "behaviors": [
         "`hann(L)` returns an `L x 1` symmetric Hann window.",
         "`hann(L, 'periodic')` returns the periodic form used in spectral-analysis workflows.",
@@ -19,7 +19,7 @@ const builtinDoc = {
         "If `L` is noninteger, RunMat rounds it to the nearest integer before constructing the window.",
         "`hann(0)` returns an empty `0 x 1` tensor.",
         "`hann(1)` returns `1`.",
-        "For the symmetric case and `L > 1`, coefficients follow `0.5 - 0.5*cos(2*pi*n/(L-1))`.",
+        "For the symmetric case and `L > 1`, coefficients use the compatibility target's `cospi` form `0.5 - 0.5*cospi(2*n/(L-1))`.",
         "The periodic form is constructed by evaluating a symmetric window of length `L + 1` and dropping the final sample."
     ],
     "examples": [

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

@@ -1 +1 @@
-{"version":3,"file":"hann.js","sourceRoot":"","sources":["../../../src/generated/builtins/hann.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,QAAQ;QACR,mBAAmB;QACnB,KAAK;QACL,KAAK;KACN;IACD,SAAS,EAAE,6CAA6C;IACxD,aAAa,EAAE,iIAAiI;IAChJ,WAAW,EAAE;QACX,qDAAqD;QACrD,sFAAsF;QACtF,qFAAqF;QACrF,+FAA+F;QAC/F,4CAA4C;QAC5C,wBAAwB;QACxB,wFAAwF;QACxF,oHAAoH;KACrH;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,8BAA8B;YAC7C,OAAO,EAAE,wBAAwB;SAClC;QACD;YACE,aAAa,EAAE,uDAAuD;YACtE,OAAO,EAAE,oCAAoC;SAC9C;QACD;YACE,aAAa,EAAE,yCAAyC;YACxD,OAAO,EAAE,kCAAkC;SAC5C;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,wEAAwE;YACpF,QAAQ,EAAE,6QAA6Q;SACxR;QACD;YACE,UAAU,EAAE,mCAAmC;YAC/C,QAAQ,EAAE,oFAAoF;SAC/F;QACD;YACE,UAAU,EAAE,uCAAuC;YACnD,QAAQ,EAAE,6HAA6H;SACxI;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;KACF;IACD,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IACd,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,QAAQ;KACT;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"hann.js","sourceRoot":"","sources":["../../../src/generated/builtins/hann.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,QAAQ;QACR,mBAAmB;QACnB,KAAK;QACL,KAAK;KACN;IACD,SAAS,EAAE,6CAA6C;IACxD,aAAa,EAAE,wTAAwT;IACvU,WAAW,EAAE;QACX,qDAAqD;QACrD,sFAAsF;QACtF,qFAAqF;QACrF,+FAA+F;QAC/F,4CAA4C;QAC5C,wBAAwB;QACxB,4HAA4H;QAC5H,oHAAoH;KACrH;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,8BAA8B;YAC7C,OAAO,EAAE,wBAAwB;SAClC;QACD;YACE,aAAa,EAAE,uDAAuD;YACtE,OAAO,EAAE,oCAAoC;SAC9C;QACD;YACE,aAAa,EAAE,yCAAyC;YACxD,OAAO,EAAE,kCAAkC;SAC5C;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,wEAAwE;YACpF,QAAQ,EAAE,6QAA6Q;SACxR;QACD;YACE,UAAU,EAAE,mCAAmC;YAC/C,QAAQ,EAAE,oFAAoF;SAC/F;QACD;YACE,UAAU,EAAE,uCAAuC;YACnD,QAAQ,EAAE,6HAA6H;SACxI;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;KACF;IACD,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IACd,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,QAAQ;KACT;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/head.js

@@ -16,7 +16,7 @@ const builtinDoc = {
         "reduction": false,
         "precisions": [],
         "broadcasting": "none",
-        "notes": "Inputs are gathered before row selection."
+        "notes": "GPU-resident array input is supported. It is downloaded non-destructively and the selected value is restored to the owning provider with its class preserved. A GPU-resident row-count control is a separately gated RunMat extension."
     },
     "fusion": {
         "elementwise": false,
@@ -27,12 +27,14 @@ const builtinDoc = {
     "requires_feature": null,
     "tested": {
         "unit": "builtins::table::tests",
-        "integration": "crates/runmat-vm/tests/tables_timetables.rs"
+        "integration": "crates/runmat-vm/tests/integer_multidimensional_fft_and_table_selection.rs"
     },
-    "description": "`head(A, n)` selects the first `n` rows. The default row count is 8.",
+    "description": "`head(A, n)` selects the first `n` rows. The default row count is 8. All eight integer array classes preserve exact storage and trailing dimensions.",
     "behaviors": [
         "Table/timetable variable metadata is preserved.",
-        "Array inputs use the same row-selection helper as table variables."
+        "Real, complex, logical, and integer arrays preserve every trailing dimension while selecting along dimension one.",
+        "Typed integer row counts are decoded exactly and must be positive.",
+        "GPU-resident data is supported in MATLAB-compatible modes; a GPU-resident row-count control remains gated before provider access."
     ],
     "examples": [
         {
@@ -52,8 +54,8 @@ const builtinDoc = {
         }
     ],
     "source": {
-        "label": "`crates/runmat-runtime/src/builtins/table/mod.rs`",
-        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/table/mod.rs"
+        "label": "`crates/runmat-runtime/src/builtins/table/builtins/selectors.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/table/builtins/selectors.rs"
     },
     "key": "head",
     "slug": "head",

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

@@ -1 +1 @@
-{"version":3,"file":"head.js","sourceRoot":"","sources":["../../../src/generated/builtins/head.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,MAAM;IACf,UAAU,EAAE,OAAO;IACnB,UAAU,EAAE;QACV,MAAM;QACN,OAAO;QACP,WAAW;QACX,SAAS;QACT,MAAM;KACP;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,2CAA2C;KACrD;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,wBAAwB;QAChC,aAAa,EAAE,6CAA6C;KAC7D;IACD,aAAa,EAAE,sEAAsE;IACrF,WAAW,EAAE;QACX,iDAAiD;QACjD,oEAAoE;KACrE;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,WAAW;YAC1B,OAAO,EAAE,gBAAgB;YACzB,QAAQ,EAAE,oBAAoB;SAC/B;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,mDAAmD;QAC5D,KAAK,EAAE,gGAAgG;KACxG;IACD,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IACd,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;KACR;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"head.js","sourceRoot":"","sources":["../../../src/generated/builtins/head.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,MAAM;IACf,UAAU,EAAE,OAAO;IACnB,UAAU,EAAE;QACV,MAAM;QACN,OAAO;QACP,WAAW;QACX,SAAS;QACT,MAAM;KACP;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,wOAAwO;KAClP;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,wBAAwB;QAChC,aAAa,EAAE,4EAA4E;KAC5F;IACD,aAAa,EAAE,sJAAsJ;IACrK,WAAW,EAAE;QACX,iDAAiD;QACjD,mHAAmH;QACnH,oEAAoE;QACpE,mIAAmI;KACpI;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,WAAW;YAC1B,OAAO,EAAE,gBAAgB;YACzB,QAAQ,EAAE,oBAAoB;SAC/B;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,kEAAkE;QAC3E,KAAK,EAAE,+GAA+G;KACvH;IACD,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IACd,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;KACR;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

@@ -19,7 +19,7 @@ const builtinDoc = {
             "double"
         ],
         "broadcasting": "none",
-        "notes": "`heatmap` is a plotting sink. Inputs are gathered to build labeled chart state, then rendered through the scaled-image surface path."
+        "notes": "`heatmap` is a host plotting sink. GPU-resident CData is a gated RunMat extension and is downloaded non-destructively only after compatibility admission."
     },
     "fusion": {
         "elementwise": false,
@@ -31,12 +31,13 @@ const builtinDoc = {
     "tested": {
         "unit": "builtins::plotting::heatmap::tests"
     },
-    "description": "`heatmap` creates heatmap charts from numeric matrix data. Supported call forms, returned handle behavior, and chart properties follow MATLAB semantics.",
+    "description": "`heatmap` creates heatmap charts from numeric matrix data. All eight integer classes remain exact in chart `ColorData`; a separate normalized renderer representation preserves distinctions between adjacent wide integers.",
     "behaviors": [
-        "`heatmap(CData)` displays matrix values using default row and column labels.",
+        "`heatmap(CData)` and `heatmap(CData, Name, Value, ...)` display matrix values using default row and column labels.",
         "`heatmap(XValues, YValues, CData)` uses text, string-array, cell-array, or numeric labels for the displayed columns and rows.",
         "The returned heatmap handle participates in RunMat's plotting property system.",
-        "Color rendering uses the shared scaled-image and colormap path."
+        "Integer ColorData is retained authoritatively on the chart while exact range-relative normalization supplies the floating renderer boundary.",
+        "ColorLimits, FontSize, ColorbarVisible, and GridVisible accept documented integer values with exact structural validation; ColorLimits remain public in the source data domain."
     ],
     "examples": [
         {

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

@@ -1 +1 @@
-{"version":3,"file":"heatmap.js","sourceRoot":"","sources":["../../../src/generated/builtins/heatmap.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,cAAc;QACd,sBAAsB;QACtB,UAAU;QACV,UAAU;KACX;IACD,SAAS,EAAE,6CAA6C;IACxD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,QAAQ;YACR,QAAQ;SACT;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,sIAAsI;KAChJ;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;KACtB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,oCAAoC;KAC7C;IACD,aAAa,EAAE,0JAA0J;IACzK,WAAW,EAAE;QACX,8EAA8E;QAC9E,+HAA+H;QAC/H,gFAAgF;QAChF,iEAAiE;KAClE;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,gCAAgC;YAC/C,OAAO,EAAE,iPAAiP;SAC3P;QACD;YACE,aAAa,EAAE,mCAAmC;YAClD,OAAO,EAAE,gFAAgF;SAC1F;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,oCAAoC;YAChD,QAAQ,EAAE,2LAA2L;SACtM;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,wBAAwB;YACjC,KAAK,EAAE,uCAAuC;SAC/C;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,8DAA8D;QACvE,KAAK,EAAE,2GAA2G;KACnH;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"heatmap.js","sourceRoot":"","sources":["../../../src/generated/builtins/heatmap.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,cAAc;QACd,sBAAsB;QACtB,UAAU;QACV,UAAU;KACX;IACD,SAAS,EAAE,6CAA6C;IACxD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE;YACZ,QAAQ;YACR,QAAQ;SACT;QACD,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,2JAA2J;KACrK;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;KACtB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,oCAAoC;KAC7C;IACD,aAAa,EAAE,8NAA8N;IAC7O,WAAW,EAAE;QACX,oHAAoH;QACpH,+HAA+H;QAC/H,gFAAgF;QAChF,8IAA8I;QAC9I,iLAAiL;KAClL;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,gCAAgC;YAC/C,OAAO,EAAE,iPAAiP;SAC3P;QACD;YACE,aAAa,EAAE,mCAAmC;YAClD,OAAO,EAAE,gFAAgF;SAC1F;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,oCAAoC;YAChD,QAAQ,EAAE,2LAA2L;SACtM;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,wBAAwB;YACjC,KAAK,EAAE,uCAAuC;SAC/C;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,8DAA8D;QACvE,KAAK,EAAE,2GAA2G;KACnH;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/heaviside.js

@@ -19,7 +19,7 @@ const builtinDoc = {
             "f64"
         ],
         "broadcasting": "matlab",
-        "notes": "Keeps real GPU tensors resident when the active provider implements unary_heaviside; otherwise RunMat gathers and evaluates the host implementation."
+        "notes": "GPU-resident input is a RunMat extension. Admitted inputs use their owning provider and remain resident after an explicit unsupported-hook fallback; provider execution and contract failures are terminal."
     },
     "fusion": {
         "elementwise": true,
@@ -32,14 +32,14 @@ const builtinDoc = {
         "unit": "builtins::math::elementwise::heaviside::tests",
         "integration": "builtins::math::elementwise::heaviside::tests::heaviside_gpu_provider_roundtrip"
     },
-    "description": "`Y = heaviside(X)` returns the Heaviside step function applied element by element. Negative real values map to `0`, zero maps to `0.5`, and positive values map to `1`.",
+    "description": "`Y = heaviside(X)` returns the Heaviside step function applied element by element. Negative real values map to `0`, zero maps to `0.5`, and positive values map to `1`. Integer, logical, character, and GPU-resident numeric inputs are conservative RunMat extensions and require extension mode.",
     "behaviors": [
         "Real scalars, vectors, matrices, and higher-dimensional tensors are evaluated elementwise.",
         "Both `0.0` and `-0.0` map to `0.5`.",
         "`Inf` maps to `1`, `-Inf` maps to `0`, and `NaN` remains `NaN`.",
         "CPU, provider, WGPU, and fusion paths all use the same real scalar mapping.",
-        "Logical inputs are promoted to doubles, so `heaviside(false)` returns `0.5` and `heaviside(true)` returns `1`.",
-        "Character arrays are treated as their numeric code points and return doubles of the same shape.",
+        "In RunMat extension mode, logical inputs are promoted to doubles, so `heaviside(false)` returns `0.5` and `heaviside(true)` returns `1`.",
+        "In RunMat extension mode, character arrays are treated as their numeric code points and return doubles of the same shape.",
         "Symbolic scalar inputs return symbolic `heaviside(...)` expressions.",
         "Complex and string inputs are rejected with a stable invalid-input identifier."
     ],
@@ -59,7 +59,7 @@ const builtinDoc = {
             "output": "Y = [0 0.5; 1 NaN]"
         },
         {
-            "description": "Use logical inputs",
+            "description": "Evaluating logical step inputs",
             "input": "mask = [false true];\ny = heaviside(mask)",
             "output": "y = [0.5 1]"
         },
@@ -69,7 +69,7 @@ const builtinDoc = {
             "output": "y = heaviside(x)"
         },
         {
-            "description": "Execute on a GPU-resident tensor",
+            "description": "Evaluating resident step inputs",
             "input": "G = gpuArray([-1 0 1]);\nY = heaviside(G);\nhost = gather(Y)"
         }
     ],

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

@@ -1 +1 @@
-{"version":3,"file":"heaviside.js","sourceRoot":"","sources":["../../../src/generated/builtins/heaviside.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,WAAW;IACpB,UAAU,EAAE,kBAAkB;IAC9B,UAAU,EAAE;QACV,WAAW;QACX,WAAW;QACX,eAAe;QACf,aAAa;QACb,KAAK;KACN;IACD,SAAS,EAAE,mDAAmD;IAC9D,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,sJAAsJ;KAChK;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,+CAA+C;QACvD,aAAa,EAAE,iFAAiF;KACjG;IACD,aAAa,EAAE,yKAAyK;IACxL,WAAW,EAAE;QACX,4FAA4F;QAC5F,qCAAqC;QACrC,iEAAiE;QACjE,6EAA6E;QAC7E,gHAAgH;QAChH,iGAAiG;QACjG,sEAAsE;QACtE,gFAAgF;KACjF;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,mDAAmD;YAClE,OAAO,EAAE,8BAA8B;YACvC,QAAQ,EAAE,oBAAoB;SAC/B;QACD;YACE,aAAa,EAAE,mCAAmC;YAClD,OAAO,EAAE,+CAA+C;SACzD;QACD;YACE,aAAa,EAAE,kCAAkC;YACjD,OAAO,EAAE,sCAAsC;YAC/C,QAAQ,EAAE,oBAAoB;SAC/B;QACD;YACE,aAAa,EAAE,oBAAoB;YACnC,OAAO,EAAE,2CAA2C;YACpD,QAAQ,EAAE,aAAa;SACxB;QACD;YACE,aAAa,EAAE,+BAA+B;YAC9C,OAAO,EAAE,2BAA2B;YACpC,QAAQ,EAAE,kBAAkB;SAC7B;QACD;YACE,aAAa,EAAE,kCAAkC;YACjD,OAAO,EAAE,8DAA8D;SACxE;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,qCAAqC;YACjD,QAAQ,EAAE,2HAA2H;SACtI;QACD;YACE,UAAU,EAAE,2CAA2C;YACvD,QAAQ,EAAE,4JAA4J;SACvK;QACD;YACE,UAAU,EAAE,gDAAgD;YAC5D,QAAQ,EAAE,8EAA8E;SACzF;QACD;YACE,UAAU,EAAE,uCAAuC;YACnD,QAAQ,EAAE,+EAA+E;SAC1F;QACD;YACE,UAAU,EAAE,kDAAkD;YAC9D,QAAQ,EAAE,sIAAsI;SACjJ;QACD;YACE,UAAU,EAAE,wCAAwC;YACpD,QAAQ,EAAE,mGAAmG;SAC9G;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,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,oEAAoE;QAC7E,KAAK,EAAE,iHAAiH;KACzH;IACD,eAAe,EAAE,2MAA2M;IAC5N,KAAK,EAAE,WAAW;IAClB,MAAM,EAAE,WAAW;IACnB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,aAAa;KACd;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"heaviside.js","sourceRoot":"","sources":["../../../src/generated/builtins/heaviside.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,WAAW;IACpB,UAAU,EAAE,kBAAkB;IAC9B,UAAU,EAAE;QACV,WAAW;QACX,WAAW;QACX,eAAe;QACf,aAAa;QACb,KAAK;KACN;IACD,SAAS,EAAE,mDAAmD;IAC9D,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,6MAA6M;KACvN;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,+CAA+C;QACvD,aAAa,EAAE,iFAAiF;KACjG;IACD,aAAa,EAAE,qSAAqS;IACpT,WAAW,EAAE;QACX,4FAA4F;QAC5F,qCAAqC;QACrC,iEAAiE;QACjE,6EAA6E;QAC7E,0IAA0I;QAC1I,2HAA2H;QAC3H,sEAAsE;QACtE,gFAAgF;KACjF;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,mDAAmD;YAClE,OAAO,EAAE,8BAA8B;YACvC,QAAQ,EAAE,oBAAoB;SAC/B;QACD;YACE,aAAa,EAAE,mCAAmC;YAClD,OAAO,EAAE,+CAA+C;SACzD;QACD;YACE,aAAa,EAAE,kCAAkC;YACjD,OAAO,EAAE,sCAAsC;YAC/C,QAAQ,EAAE,oBAAoB;SAC/B;QACD;YACE,aAAa,EAAE,gCAAgC;YAC/C,OAAO,EAAE,2CAA2C;YACpD,QAAQ,EAAE,aAAa;SACxB;QACD;YACE,aAAa,EAAE,+BAA+B;YAC9C,OAAO,EAAE,2BAA2B;YACpC,QAAQ,EAAE,kBAAkB;SAC7B;QACD;YACE,aAAa,EAAE,iCAAiC;YAChD,OAAO,EAAE,8DAA8D;SACxE;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,qCAAqC;YACjD,QAAQ,EAAE,2HAA2H;SACtI;QACD;YACE,UAAU,EAAE,2CAA2C;YACvD,QAAQ,EAAE,4JAA4J;SACvK;QACD;YACE,UAAU,EAAE,gDAAgD;YAC5D,QAAQ,EAAE,8EAA8E;SACzF;QACD;YACE,UAAU,EAAE,uCAAuC;YACnD,QAAQ,EAAE,+EAA+E;SAC1F;QACD;YACE,UAAU,EAAE,kDAAkD;YAC9D,QAAQ,EAAE,sIAAsI;SACjJ;QACD;YACE,UAAU,EAAE,wCAAwC;YACpD,QAAQ,EAAE,mGAAmG;SAC9G;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,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,oEAAoE;QAC7E,KAAK,EAAE,iHAAiH;KACzH;IACD,eAAe,EAAE,2MAA2M;IAC5N,KAAK,EAAE,WAAW;IAClB,MAAM,EAAE,WAAW;IACnB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,aAAa;KACd;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

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

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

package/dist/generated/builtins/height.js

@@ -0,0 +1,72 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "height",
+    "category": "table",
+    "keywords": [
+        "height",
+        "rows",
+        "table",
+        "timetable",
+        "array"
+    ],
+    "summary": "Return the number of rows in a table, timetable, or array.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "For GPU-resident arrays, `height` reads shape metadata without provider lookup, download, or data conversion."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 1,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::table::tests::height_reads_resident_shape_without_provider_or_data_access",
+        "integration": "crates/runmat-vm/tests/integer_multidimensional_fft_and_table_selection.rs"
+    },
+    "description": "`height(A)` returns the size of the first dimension as a scalar double. Integer array contents remain untouched because only authoritative shape metadata is inspected.",
+    "behaviors": [
+        "Tables and timetables return their row count.",
+        "Numeric, complex, logical, character, cell, datetime, duration, and categorical arrays return the size of dimension one.",
+        "Every integer class has the same structural contract; values are not materialized or converted.",
+        "The result is scalar double. Counts outside exact binary64 range are explicitly outside the current representable contract."
+    ],
+    "examples": [
+        {
+            "description": "Count matrix rows",
+            "input": "n = height(uint64(zeros(5, 3)))",
+            "output": "n = 5"
+        }
+    ],
+    "links": [
+        {
+            "label": "width",
+            "url": "./width"
+        },
+        {
+            "label": "size",
+            "url": "./size"
+        },
+        {
+            "label": "head",
+            "url": "./head"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/table/builtins/predicates.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/table/builtins/predicates.rs"
+    },
+    "key": "height",
+    "slug": "height",
+    "aliases": [],
+    "categoryPath": [
+        "table"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=height.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"height.js","sourceRoot":"","sources":["../../../src/generated/builtins/height.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,QAAQ;IACjB,UAAU,EAAE,OAAO;IACnB,UAAU,EAAE;QACV,QAAQ;QACR,MAAM;QACN,OAAO;QACP,WAAW;QACX,OAAO;KACR;IACD,SAAS,EAAE,4DAA4D;IACvE,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,+GAA+G;KACzH;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,qFAAqF;QAC7F,aAAa,EAAE,4EAA4E;KAC5F;IACD,aAAa,EAAE,yKAAyK;IACxL,WAAW,EAAE;QACX,+CAA+C;QAC/C,0HAA0H;QAC1H,iGAAiG;QACjG,6HAA6H;KAC9H;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,mBAAmB;YAClC,OAAO,EAAE,iCAAiC;YAC1C,QAAQ,EAAE,OAAO;SAClB;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,mEAAmE;QAC5E,KAAK,EAAE,gHAAgH;KACxH;IACD,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;KACR;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

@@ -32,7 +32,8 @@ const builtinDoc = {
     "behaviors": [
         "`hgload(filename)` appends `.fig` when the filename has no extension and returns a scalar handle or row vector of handles.",
         "`[h, old] = hgload(filename, property_structure)` applies recognized top-level figure property overrides after import.",
-        "Unrecognized override fields are ignored and omitted from `old`, matching MATLAB's documented top-level override behavior."
+        "Unrecognized override fields are ignored and omitted from `old`, matching MATLAB's documented top-level override behavior.",
+        "Numeric and GPU-resident arguments are rejected without gathering; this file-loading surface has no integer computation contract."
     ],
     "examples": [
         {

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

@@ -1 +1 @@
-{"version":3,"file":"hgload.js","sourceRoot":"","sources":["../../../src/generated/builtins/hgload.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,QAAQ;IACjB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,QAAQ;QACR,eAAe;QACf,KAAK;QACL,UAAU;KACX;IACD,SAAS,EAAE,yDAAyD;IACpE,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,kDAAkD;KAC5D;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,8CAA8C;KAC9D;IACD,aAAa,EAAE,8KAA8K;IAC7L,WAAW,EAAE;QACX,4HAA4H;QAC5H,wHAAwH;QACxH,4HAA4H;KAC7H;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,+BAA+B;YAC9C,OAAO,EAAE,0GAA0G;SACpH;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,yEAAyE;QAClF,KAAK,EAAE,sHAAsH;KAC9H;IACD,eAAe,EAAE,gFAAgF;IACjG,cAAc,EAAE;QACd,oCAAoC;QACpC,wEAAwE;KACzE;IACD,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"hgload.js","sourceRoot":"","sources":["../../../src/generated/builtins/hgload.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,QAAQ;IACjB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,QAAQ;QACR,eAAe;QACf,KAAK;QACL,UAAU;KACX;IACD,SAAS,EAAE,yDAAyD;IACpE,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,kDAAkD;KAC5D;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,8CAA8C;KAC9D;IACD,aAAa,EAAE,8KAA8K;IAC7L,WAAW,EAAE;QACX,4HAA4H;QAC5H,wHAAwH;QACxH,4HAA4H;QAC5H,mIAAmI;KACpI;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,+BAA+B;YAC9C,OAAO,EAAE,0GAA0G;SACpH;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,yEAAyE;QAClF,KAAK,EAAE,sHAAsH;KAC9H;IACD,eAAe,EAAE,gFAAgF;IACjG,cAAc,EAAE;QACd,oCAAoC;QACpC,wEAAwE;KACzE;IACD,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

@@ -31,7 +31,8 @@ const builtinDoc = {
     "description": "`hgsave` saves the current figure, a figure handle, or the parent figures of graphics handles to RunMat FIG files. RunMat FIG persistence is figure-scene based; arbitrary graphics-subtree FIG files are not emitted yet.",
     "behaviors": [
         "`hgsave(filename)` saves the current figure and appends `.fig` when needed.",
-        "`hgsave(h, filename)` accepts scalar handles and handle arrays, deduplicating handles that resolve to the same parent figure.",
+        "`hgsave(h, filename)` accepts scalar double graphics handles and handle arrays, deduplicating handles that resolve to the same parent figure.",
+        "Typed integer handle spellings and GPU-resident numeric arguments are rejected without conversion or gather; this persistence surface has no integer computation contract.",
         "Version options `-v6`, `-v7`, and `-v7.3` are accepted for MATLAB compatibility and map to RunMat's FIG scene format."
     ],
     "examples": [

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

@@ -1 +1 @@
-{"version":3,"file":"hgsave.js","sourceRoot":"","sources":["../../../src/generated/builtins/hgsave.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,QAAQ;IACjB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,QAAQ;QACR,eAAe;QACf,KAAK;QACL,UAAU;KACX;IACD,SAAS,EAAE,2EAA2E;IACtF,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,gGAAgG;KAC1G;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;KACtB;IACD,kBAAkB,EAAE,WAAW;IAC/B,QAAQ,EAAE;QACR,MAAM,EAAE,+CAA+C;QACvD,aAAa,EAAE,gCAAgC;KAChD;IACD,aAAa,EAAE,4NAA4N;IAC3O,WAAW,EAAE;QACX,6EAA6E;QAC7E,+HAA+H;QAC/H,uHAAuH;KACxH;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,2BAA2B;YAC1C,OAAO,EAAE,+CAA+C;SACzD;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,yEAAyE;QAClF,KAAK,EAAE,sHAAsH;KAC9H;IACD,eAAe,EAAE,4DAA4D;IAC7E,cAAc,EAAE;QACd,oCAAoC;QACpC,yDAAyD;KAC1D;IACD,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"hgsave.js","sourceRoot":"","sources":["../../../src/generated/builtins/hgsave.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,QAAQ;IACjB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,QAAQ;QACR,eAAe;QACf,KAAK;QACL,UAAU;KACX;IACD,SAAS,EAAE,2EAA2E;IACtF,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,gGAAgG;KAC1G;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;KACtB;IACD,kBAAkB,EAAE,WAAW;IAC/B,QAAQ,EAAE;QACR,MAAM,EAAE,+CAA+C;QACvD,aAAa,EAAE,gCAAgC;KAChD;IACD,aAAa,EAAE,4NAA4N;IAC3O,WAAW,EAAE;QACX,6EAA6E;QAC7E,+IAA+I;QAC/I,4KAA4K;QAC5K,uHAAuH;KACxH;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,2BAA2B;YAC1C,OAAO,EAAE,+CAA+C;SACzD;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,yEAAyE;QAClF,KAAK,EAAE,sHAAsH;KAC9H;IACD,eAAe,EAAE,4DAA4D;IAC7E,cAAc,EAAE;QACd,oCAAoC;QACpC,yDAAyD;KAC1D;IACD,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/hilbert.js

@@ -19,7 +19,7 @@ const builtinDoc = {
             "f64"
         ],
         "broadcasting": "none",
-        "notes": "Providers can execute real GPU inputs through the resident `signal_hilbert` hook. Unsupported providers gather to host, compute the FFT-domain analytic signal, and return a complex host tensor."
+        "notes": "Providers can execute real GPU inputs through the resident `signal_hilbert` hook. An explicitly unsupported hook falls back through the input's owning provider and restores the complex result to that provider; provider execution and contract failures are terminal."
     },
     "fusion": {
         "elementwise": false,
@@ -32,14 +32,14 @@ const builtinDoc = {
         "unit": "builtins::math::signal::hilbert::tests",
         "integration": "runmat-vm basics hilbert_builtin_executes_for_fm_demod_shape"
     },
-    "description": "`z = hilbert(x)` returns the analytic signal associated with a real signal `x`. The real part of `z` is the original signal, and the imaginary part is the Hilbert transform of `x`.",
+    "description": "`z = hilbert(x)` returns the analytic signal associated with `x`. For complex single/double input, the imaginary part is ignored before the transform. Integer/logical signal data, typed or logical lengths, zero or empty lengths, and inputs beyond matrices are RunMat extensions.",
     "behaviors": [
-        "Accepts real numeric, logical, integer, vector, matrix, and N-D tensor inputs.",
+        "Accepts documented single/double vectors and matrices; integer, logical, and N-D inputs require RunMat extension mode.",
         "Operates along the first non-singleton dimension, matching MATLAB's column-wise behavior for matrices and row-wise behavior for row vectors.",
         "`hilbert(x, N)` pads with zeros or truncates along the transform dimension before constructing the analytic signal.",
         "Returns complex scalar or complex tensor output; output shape follows the input shape except that the transform dimension becomes `N` when supplied.",
         "The FFT-domain multiplier preserves DC and, for even lengths, Nyquist bins; positive-frequency bins are doubled and negative-frequency bins are zeroed.",
-        "Complex inputs are rejected because MATLAB's `hilbert` expects a real signal."
+        "For complex single/double input, the imaginary component is ignored and the real component is transformed."
     ],
     "examples": [
         {
@@ -76,11 +76,11 @@ const builtinDoc = {
         },
         {
             "question": "Can I pass complex input?",
-            "answer": "No. `hilbert` is defined for real input signals and returns a complex analytic signal."
+            "answer": "Yes for single and double input. MATLAB-compatible behavior ignores the input's imaginary component, transforms its real component, and returns the complex analytic signal. Typed complex-integer input is not supported."
         },
         {
             "question": "Does `hilbert` run on GPU tensors?",
-            "answer": "Yes. Providers with `signal_hilbert` support keep real GPU tensor inputs resident and return a complex GPU tensor. Providers without that hook fall back to the host FFT path."
+            "answer": "Yes. Providers with `signal_hilbert` support keep real GPU tensor inputs resident and return a complex GPU tensor. An explicitly unsupported hook downloads non-destructively through the input owner, computes on the host, and restores the result to that owner when its precision can be preserved."
         }
     ],
     "links": [
@@ -113,7 +113,7 @@ const builtinDoc = {
         "label": "`crates/runmat-runtime/src/builtins/math/signal/hilbert.rs`",
         "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/math/signal/hilbert.rs"
     },
-    "gpu_residency": "`hilbert` keeps real GPU tensors resident when the active provider implements `signal_hilbert`, returning a complex-interleaved GPU tensor. Unsupported providers retain the host fallback path.",
+    "gpu_residency": "`hilbert` keeps real GPU tensors resident when the active provider implements `signal_hilbert`, returning a complex-interleaved GPU tensor. An explicitly unsupported hook uses a non-destructive owner download and restores the complex result when the owner can preserve its precision; the source handle remains resident.",
     "gpu_behavior": [
         "The WGPU provider computes FFT, analytic-signal weighting, and inverse FFT without gathering the source tensor to host.",
         "The output handle is marked as complex-interleaved GPU storage for downstream resident complex operations.",

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

@@ -1 +1 @@
-{"version":3,"file":"hilbert.js","sourceRoot":"","sources":["../../../src/generated/builtins/hilbert.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,iBAAiB;QACjB,mBAAmB;QACnB,KAAK;QACL,SAAS;KACV;IACD,SAAS,EAAE,wDAAwD;IACnE,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,mMAAmM;KAC7M;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;QAChD,aAAa,EAAE,8DAA8D;KAC9E;IACD,aAAa,EAAE,sLAAsL;IACrM,WAAW,EAAE;QACX,gFAAgF;QAChF,8IAA8I;QAC9I,qHAAqH;QACrH,sJAAsJ;QACtJ,yJAAyJ;QACzJ,+EAA+E;KAChF;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,qCAAqC;YACpD,OAAO,EAAE,iCAAiC;YAC1C,QAAQ,EAAE,+EAA+E;SAC1F;QACD;YACE,aAAa,EAAE,2CAA2C;YAC1D,OAAO,EAAE,kHAAkH;SAC5H;QACD;YACE,aAAa,EAAE,uBAAuB;YACtC,OAAO,EAAE,8CAA8C;YACvD,QAAQ,EAAE,aAAa;SACxB;QACD;YACE,aAAa,EAAE,6BAA6B;YAC5C,OAAO,EAAE,8CAA8C;SACxD;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,6BAA6B;YACzC,QAAQ,EAAE,0HAA0H;SACrI;QACD;YACE,UAAU,EAAE,iCAAiC;YAC7C,QAAQ,EAAE,+MAA+M;SAC1N;QACD;YACE,UAAU,EAAE,gCAAgC;YAC5C,QAAQ,EAAE,sHAAsH;SACjI;QACD;YACE,UAAU,EAAE,2BAA2B;YACvC,QAAQ,EAAE,wFAAwF;SACnG;QACD;YACE,UAAU,EAAE,oCAAoC;YAChD,QAAQ,EAAE,gLAAgL;SAC3L;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,6DAA6D;QACtE,KAAK,EAAE,0GAA0G;KAClH;IACD,eAAe,EAAE,kMAAkM;IACnN,cAAc,EAAE;QACd,yHAAyH;QACzH,4GAA4G;QAC5G,4JAA4J;KAC7J;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,QAAQ;KACT;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"hilbert.js","sourceRoot":"","sources":["../../../src/generated/builtins/hilbert.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,iBAAiB;QACjB,mBAAmB;QACnB,KAAK;QACL,SAAS;KACV;IACD,SAAS,EAAE,wDAAwD;IACnE,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,0QAA0Q;KACpR;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;QAChD,aAAa,EAAE,8DAA8D;KAC9E;IACD,aAAa,EAAE,wRAAwR;IACvS,WAAW,EAAE;QACX,wHAAwH;QACxH,8IAA8I;QAC9I,qHAAqH;QACrH,sJAAsJ;QACtJ,yJAAyJ;QACzJ,4GAA4G;KAC7G;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,qCAAqC;YACpD,OAAO,EAAE,iCAAiC;YAC1C,QAAQ,EAAE,+EAA+E;SAC1F;QACD;YACE,aAAa,EAAE,2CAA2C;YAC1D,OAAO,EAAE,kHAAkH;SAC5H;QACD;YACE,aAAa,EAAE,uBAAuB;YACtC,OAAO,EAAE,8CAA8C;YACvD,QAAQ,EAAE,aAAa;SACxB;QACD;YACE,aAAa,EAAE,6BAA6B;YAC5C,OAAO,EAAE,8CAA8C;SACxD;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,6BAA6B;YACzC,QAAQ,EAAE,0HAA0H;SACrI;QACD;YACE,UAAU,EAAE,iCAAiC;YAC7C,QAAQ,EAAE,+MAA+M;SAC1N;QACD;YACE,UAAU,EAAE,gCAAgC;YAC5C,QAAQ,EAAE,sHAAsH;SACjI;QACD;YACE,UAAU,EAAE,2BAA2B;YACvC,QAAQ,EAAE,4NAA4N;SACvO;QACD;YACE,UAAU,EAAE,oCAAoC;YAChD,QAAQ,EAAE,ySAAyS;SACpT;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,6DAA6D;QACtE,KAAK,EAAE,0GAA0G;KAClH;IACD,eAAe,EAAE,iUAAiU;IAClV,cAAc,EAAE;QACd,yHAAyH;QACzH,4GAA4G;QAC5G,4JAA4J;KAC7J;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,QAAQ;KACT;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/hold.js

@@ -34,7 +34,8 @@ const builtinDoc = {
         "`hold('on')` enables appending to the current axes.",
         "`hold('off')` disables appending so later plots replace the axes contents.",
         "`hold('all')` is currently treated the same as `hold('on')`.",
-        "Logical and numeric scalar inputs are accepted: zero means off and nonzero means on."
+        "Logical and numeric scalar inputs are accepted: zero means off and one means on.",
+        "An axes handle can be supplied before the mode to update that axes."
     ],
     "examples": [
         {
@@ -48,9 +49,9 @@ const builtinDoc = {
             "output": "% the new plot replaces the previous axes contents"
         },
         {
-            "description": "Toggle hold state programmatically",
-            "input": "state1 = hold();\nstate2 = hold();",
-            "output": "% state1 and state2 reflect the toggled boolean state"
+            "description": "Toggle hold state",
+            "input": "hold();\nhold();",
+            "output": "% each call toggles the current axes hold state"
         }
     ],
     "faqs": [
@@ -63,8 +64,8 @@ const builtinDoc = {
             "answer": "RunMat currently treats `'all'` the same as `'on'`."
         },
         {
-            "question": "What does the return value mean?",
-            "answer": "It is the resulting boolean hold state after applying the command."
+            "question": "Does hold return the current state?",
+            "answer": "No. `hold` mutates axes state and has no public output."
         }
     ],
     "links": [

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

@@ -1 +1 @@
-{"version":3,"file":"hold.js","sourceRoot":"","sources":["../../../src/generated/builtins/hold.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,MAAM;IACf,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,MAAM;QACN,SAAS;QACT,UAAU;QACV,UAAU;QACV,cAAc;KACf;IACD,SAAS,EAAE,iEAAiE;IAC5E,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,8EAA8E;KACxF;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,aAAa,EAAE,qCAAqC;KACrD;IACD,aAAa,EAAE,2KAA2K;IAC1L,WAAW,EAAE;QACX,0CAA0C;QAC1C,qDAAqD;QACrD,4EAA4E;QAC5E,8DAA8D;QAC9D,sFAAsF;KACvF;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,uCAAuC;YACtD,OAAO,EAAE,qDAAqD;YAC9D,QAAQ,EAAE,iDAAiD;SAC5D;QACD;YACE,aAAa,EAAE,yBAAyB;YACxC,OAAO,EAAE,oCAAoC;YAC7C,QAAQ,EAAE,oDAAoD;SAC/D;QACD;YACE,aAAa,EAAE,oCAAoC;YACnD,OAAO,EAAE,oCAAoC;YAC7C,QAAQ,EAAE,uDAAuD;SAClE;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,uCAAuC;YACnD,QAAQ,EAAE,kFAAkF;SAC7F;QACD;YACE,UAAU,EAAE,6BAA6B;YACzC,QAAQ,EAAE,qDAAqD;SAChE;QACD;YACE,UAAU,EAAE,kCAAkC;YAC9C,QAAQ,EAAE,oEAAoE;SAC/E;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,2DAA2D;QACpE,KAAK,EAAE,wGAAwG;KAChH;IACD,eAAe,EAAE,yEAAyE;IAC1F,cAAc,EAAE;QACd,qGAAqG;KACtG;IACD,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IACd,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"hold.js","sourceRoot":"","sources":["../../../src/generated/builtins/hold.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,MAAM;IACf,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,MAAM;QACN,SAAS;QACT,UAAU;QACV,UAAU;QACV,cAAc;KACf;IACD,SAAS,EAAE,iEAAiE;IAC5E,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,8EAA8E;KACxF;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,aAAa,EAAE,qCAAqC;KACrD;IACD,aAAa,EAAE,2KAA2K;IAC1L,WAAW,EAAE;QACX,0CAA0C;QAC1C,qDAAqD;QACrD,4EAA4E;QAC5E,8DAA8D;QAC9D,kFAAkF;QAClF,qEAAqE;KACtE;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,uCAAuC;YACtD,OAAO,EAAE,qDAAqD;YAC9D,QAAQ,EAAE,iDAAiD;SAC5D;QACD;YACE,aAAa,EAAE,yBAAyB;YACxC,OAAO,EAAE,oCAAoC;YAC7C,QAAQ,EAAE,oDAAoD;SAC/D;QACD;YACE,aAAa,EAAE,mBAAmB;YAClC,OAAO,EAAE,kBAAkB;YAC3B,QAAQ,EAAE,iDAAiD;SAC5D;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,uCAAuC;YACnD,QAAQ,EAAE,kFAAkF;SAC7F;QACD;YACE,UAAU,EAAE,6BAA6B;YACzC,QAAQ,EAAE,qDAAqD;SAChE;QACD;YACE,UAAU,EAAE,qCAAqC;YACjD,QAAQ,EAAE,yDAAyD;SACpE;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACf;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,2DAA2D;QACpE,KAAK,EAAE,wGAAwG;KAChH;IACD,eAAe,EAAE,yEAAyE;IAC1F,cAAc,EAAE;QACd,qGAAqG;KACtG;IACD,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IACd,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/hour.js

@@ -15,24 +15,26 @@ const builtinDoc = {
         "reduction": false,
         "precisions": [],
         "broadcasting": "none",
-        "notes": "datetime values are host-side objects; `hour` extracts the hour on the CPU."
+        "notes": "Documented datetime and legacy serial/text inputs execute on the host. RunMat-only resident inputs gather through their owning provider after compatibility admission."
     },
     "fusion": {
         "elementwise": false,
         "reduction": false,
-        "max_inputs": 1,
+        "max_inputs": 2,
         "constants": "inline"
     },
     "requires_feature": null,
     "tested": {
-        "integration": "runmat-ignition/tests/datetime.rs"
+        "unit": "builtins::datetime::tests::hour_minute_and_month_typed_legacy_serials_cover_every_integer_class",
+        "integration": "crates/runmat-vm/tests/integer_datetime_metadata_and_nonzero_semantics.rs"
     },
-    "description": "`hour(dt)` extracts hour-of-day values from datetime scalars or arrays and returns doubles with matching shape. Extraction behavior follows MATLAB semantics.",
+    "description": "`hour(t)` extracts hour-of-day values from datetime input. The documented legacy forms also accept serial date numbers or date text, with an optional input format for legacy non-datetime input.",
     "behaviors": [
         "`hour(t)` accepts datetime scalars and datetime arrays.",
         "The output shape matches the input shape.",
         "Hour values are returned in 24-hour clock form.",
-        "Passing a non-datetime value raises a datetime-specific error."
+        "Documented legacy binary64 serial date numbers and date text return double hour values with matching shape.",
+        "Single-precision and all eight typed-integer legacy serial inputs are a gated RunMat extension; exact native values are range-checked before one binary64 serial-date conversion."
     ],
     "examples": [
         {
@@ -78,9 +80,9 @@ const builtinDoc = {
         "label": "`crates/runmat-runtime/src/builtins/datetime/mod.rs`",
         "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/datetime/mod.rs"
     },
-    "gpu_residency": "No. `hour` reads datetime objects on the CPU and returns ordinary host-side numeric arrays.",
+    "gpu_residency": "Documented `hour` forms are host-side. RunMat can admit resident legacy numeric input as an extension, gathers it non-destructively through the exact owner, and returns the documented host double result.",
     "gpu_behavior": [
-        "`hour` does not dispatch GPU kernels; it extracts the hour component from CPU-side datetime objects."
+        "`hour` does not dispatch a GPU kernel. Explicit resident input is a separately gated RunMat extension, while internal automatic residency can gather transparently."
     ],
     "key": "hour",
     "slug": "hour",

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

@@ -1 +1 @@
-{"version":3,"file":"hour.js","sourceRoot":"","sources":["../../../src/generated/builtins/hour.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,MAAM;IACf,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,MAAM;QACN,UAAU;QACV,gBAAgB;QAChB,YAAY;KACb;IACD,SAAS,EAAE,oEAAoE;IAC/E,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,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,QAAQ;KACtB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,aAAa,EAAE,mCAAmC;KACnD;IACD,aAAa,EAAE,+JAA+J;IAC9K,WAAW,EAAE;QACX,yDAAyD;QACzD,2CAA2C;QAC3C,iDAAiD;QACjD,gEAAgE;KACjE;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,yCAAyC;YACxD,OAAO,EAAE,mDAAmD;YAC5D,QAAQ,EAAE,QAAQ;SACnB;QACD;YACE,aAAa,EAAE,qCAAqC;YACpD,OAAO,EAAE,+EAA+E;YACxF,QAAQ,EAAE,mBAAmB;SAC9B;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,wCAAwC;YACpD,QAAQ,EAAE,6DAA6D;SACxE;QACD;YACE,UAAU,EAAE,uCAAuC;YACnD,QAAQ,EAAE,wEAAwE;SACnF;QACD;YACE,UAAU,EAAE,6BAA6B;YACzC,QAAQ,EAAE,2EAA2E;SACtF;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,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,sDAAsD;QAC/D,KAAK,EAAE,mGAAmG;KAC3G;IACD,eAAe,EAAE,6FAA6F;IAC9G,cAAc,EAAE;QACd,sGAAsG;KACvG;IACD,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IACd,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"hour.js","sourceRoot":"","sources":["../../../src/generated/builtins/hour.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,MAAM;IACf,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,MAAM;QACN,UAAU;QACV,gBAAgB;QAChB,YAAY;KACb;IACD,SAAS,EAAE,oEAAoE;IAC/E,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,wKAAwK;KAClL;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,iGAAiG;QACzG,aAAa,EAAE,2EAA2E;KAC3F;IACD,aAAa,EAAE,mMAAmM;IAClN,WAAW,EAAE;QACX,yDAAyD;QACzD,2CAA2C;QAC3C,iDAAiD;QACjD,6GAA6G;QAC7G,mLAAmL;KACpL;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,yCAAyC;YACxD,OAAO,EAAE,mDAAmD;YAC5D,QAAQ,EAAE,QAAQ;SACnB;QACD;YACE,aAAa,EAAE,qCAAqC;YACpD,OAAO,EAAE,+EAA+E;YACxF,QAAQ,EAAE,mBAAmB;SAC9B;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,wCAAwC;YACpD,QAAQ,EAAE,6DAA6D;SACxE;QACD;YACE,UAAU,EAAE,uCAAuC;YACnD,QAAQ,EAAE,wEAAwE;SACnF;QACD;YACE,UAAU,EAAE,6BAA6B;YACzC,QAAQ,EAAE,2EAA2E;SACtF;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,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,sDAAsD;QAC/D,KAAK,EAAE,mGAAmG;KAC3G;IACD,eAAe,EAAE,6MAA6M;IAC9N,cAAc,EAAE;QACd,qKAAqK;KACtK;IACD,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IACd,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}