runmat 0.6.1 → 0.6.2-dev.1

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

@@ -1 +1 @@
-{"version":3,"file":"filewrite.js","sourceRoot":"","sources":["../../../src/generated/builtins/filewrite.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,WAAW;IACpB,UAAU,EAAE,aAAa;IACzB,UAAU,EAAE;QACV,WAAW;QACX,IAAI;QACJ,YAAY;QACZ,WAAW;QACX,QAAQ;QACR,UAAU;KACX;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,wJAAwJ;KAClK;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,aAAa,EAAE,yEAAyE;KACzF;IACD,aAAa,EAAE,+PAA+P;IAC9Q,WAAW,EAAE;QACX,4FAA4F;QAC5F,8LAA8L;QAC9L,4GAA4G;QAC5G,8MAA8M;QAC9M,+JAA+J;QAC/J,wFAAwF;QACxF,0HAA0H;KAC3H;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,0BAA0B;YACzC,OAAO,EAAE,sDAAsD;YAC/D,QAAQ,EAAE,YAAY;SACvB;QACD;YACE,aAAa,EAAE,iCAAiC;YAChD,OAAO,EAAE,uHAAuH;YAChI,QAAQ,EAAE,YAAY;SACvB;QACD;YACE,aAAa,EAAE,+BAA+B;YAC9C,OAAO,EAAE,0FAA0F;YACnG,QAAQ,EAAE,WAAW;SACtB;QACD;YACE,aAAa,EAAE,sCAAsC;YACrD,OAAO,EAAE,qFAAqF;YAC9F,QAAQ,EAAE,WAAW;SACtB;QACD;YACE,aAAa,EAAE,iDAAiD;YAChE,OAAO,EAAE,oFAAoF;YAC7F,QAAQ,EAAE,YAAY;SACvB;QACD;YACE,aAAa,EAAE,iCAAiC;YAChD,OAAO,EAAE,0HAA0H;YACnI,QAAQ,EAAE,8DAA8D;SACzE;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,+BAA+B;YAC3C,QAAQ,EAAE,4HAA4H;SACvI;QACD;YACE,UAAU,EAAE,gCAAgC;YAC5C,QAAQ,EAAE,8NAA8N;SACzO;QACD;YACE,UAAU,EAAE,+CAA+C;YAC3D,QAAQ,EAAE,8JAA8J;SACzK;QACD;YACE,UAAU,EAAE,8BAA8B;YAC1C,QAAQ,EAAE,wJAAwJ;SACnK;QACD;YACE,UAAU,EAAE,4CAA4C;YACxD,QAAQ,EAAE,gIAAgI;SAC3I;QACD;YACE,UAAU,EAAE,sCAAsC;YAClD,QAAQ,EAAE,oHAAoH;SAC/H;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,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;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;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,+DAA+D;QACxE,KAAK,EAAE,4GAA4G;KACpH;IACD,cAAc,EAAE;QACd,oSAAoS;KACrS;IACD,KAAK,EAAE,WAAW;IAClB,MAAM,EAAE,WAAW;IACnB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,IAAI;QACJ,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"filewrite.js","sourceRoot":"","sources":["../../../src/generated/builtins/filewrite.ts"],"names":[],"mappings":"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"}

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

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

@@ -2,229 +2,86 @@
 // Do not edit by hand.
 const builtinDoc = {
     "title": "fill",
-    "category": "array/creation",
+    "category": "plotting",
     "keywords": [
         "fill",
-        "constant",
-        "array",
-        "gpu",
-        "like"
+        "patch",
+        "polygon",
+        "2-D"
+    ],
+    "summary": "Create filled 2-D polygon patches.",
+    "description": "`fill(X,Y,C)` creates filled polygonal regions as Patch graphics. Integer coordinate and CData classes remain authoritative on the Patch object; conversion to renderer geometry is an explicit client-side boundary.",
+    "behaviors": [
+        "Equal-length row or column vector X and Y inputs create one region regardless of orientation; matrix inputs create independently addressable regions from columns.",
+        "When either coordinate is a matrix, an equal-length coordinate vector matching the matrix row count is shared across every matrix column; square matrices are grouped by columns.",
+        "Multiple X,Y,C groups create multiple Patch graphics.",
+        "C accepts color text, RGB triples, or numeric indexed color data.",
+        "XData, YData, and CData preserve the original numeric class and shape.",
+        "A leading axes handle targets an existing axes; typed-integer numeric aliases are available only when RunMat extensions are enabled."
     ],
-    "summary": "Create arrays filled with a constant value in MATLAB and RunMat.",
     "gpu_support": {
         "elementwise": false,
         "reduction": false,
-        "precisions": [
-            "f32",
-            "f64"
-        ],
+        "precisions": [],
         "broadcasting": "none",
-        "notes": "Uses provider fill hooks for constant buffers; falls back to host upload when unavailable."
+        "notes": "GPU-resident inputs gather exactly through their owning provider and Patch construction executes on the client."
     },
     "fusion": {
-        "elementwise": true,
+        "elementwise": false,
         "reduction": false,
-        "max_inputs": 1,
-        "constants": "uniform"
+        "max_inputs": 3,
+        "constants": "inline"
     },
     "requires_feature": null,
     "tested": {
-        "unit": "builtins::array::creation::fill::tests",
-        "integration": "builtins::array::creation::fill::tests::fill_gpu_like_alloc"
+        "unit": "builtins::plotting::fill::tests"
     },
-    "description": "`fill(value, size, ...)` creates dense arrays whose elements are all set to `value`. Scalar, size-vector, and variadic-dimension forms match MATLAB semantics. `'logical'` and `'like'` options control output type and residency.",
-    "behaviors": [
-        "`fill(v)` returns the scalar `v`.",
-        "`fill(v, n)` returns an `n × n` matrix with every element equal to `v`.",
-        "`fill(v, m, n, ...)` supports arbitrary N-D dimensions.",
-        "`fill(v, sz)` accepts a size vector (row or column).",
-        "`fill(v, A)` uses the shape (and default type) of `A`.",
-        "`fill(v, ___, 'logical')` produces a logical array where each element is `v ~= 0`.",
-        "`fill(v, ___, 'like', prototype)` matches the type, device residency, and shape of `prototype`.",
-        "When a GPU prototype or `'like'` argument is provided, RunMat keeps the result on the device. When provider hooks are incomplete, it falls back to uploading a host tensor to guarantee correctness."
-    ],
     "examples": [
         {
-            "description": "Creating a 3x3 matrix of 2.5s",
-            "input": "A = fill(2.5, 3)",
-            "output": "A = [2.5 2.5 2.5; 2.5 2.5 2.5; 2.5 2.5 2.5]"
-        },
-        {
-            "description": "Filling a rectangular matrix with -4",
-            "input": "B = fill(-4, 2, 5)",
-            "output": "B = [-4 -4 -4 -4 -4; -4 -4 -4 -4 -4]"
-        },
-        {
-            "description": "Filling using a size vector",
-            "input": "sz = [2 3 4];\nC = fill(10, sz)",
-            "output": "size(C)  % 2-by-3-by-4"
-        },
-        {
-            "description": "Creating a logical mask with `fill`",
-            "input": "mask = fill(3, 4, 1, 'logical')",
-            "output": "mask = [1; 1; 1; 1]"
-        },
-        {
-            "description": "Matching an existing array with `'like'`",
-            "input": "prototype = rand(2, 3, 'like', gpuArray(1));\nD = fill(pi, 2, 3, 'like', prototype);\ngather(D)",
-            "output": "3.1416 3.1416 3.1416 3.1416 3.1416 3.1416"
-        },
-        {
-            "description": "Filling a complex array",
-            "input": "E = fill(1 + 2i, 2, 2, 'complex')",
-            "output": "E = [1+2i 1+2i; 1+2i 1+2i]"
-        },
-        {
-            "description": "Using a prototype to infer shape automatically",
-            "input": "F = rand(4, 2);\nG = fill(7, F)",
-            "output": "isequal(size(G), [4 2])  % true"
+            "description": "Create a filled triangle",
+            "input": "h = fill([0 1 0], [0 0 1], 'red');",
+            "output": "h is a Patch graphics handle"
         },
         {
-            "description": "Filling an empty matrix",
-            "input": "H = fill(0, 0, 5)",
-            "output": "size(H)  % 0-by-5"
+            "description": "Use exact integer coordinates and indexed color data",
+            "input": "h = fill(uint64([0 1 0]), uint64([0 0 1]), uint8(1));",
+            "output": "get(h,'XData') retains class uint64"
         },
         {
-            "description": "Keeping GPU residency without explicit `gpuArray`",
-            "input": "A = rand(512, 512);\nJ = fill(0.5, size(A), 'like', gpuArray(A))",
-            "output": "isa(J, 'gpuArray')  % true"
-        },
-        {
-            "description": "Filling with boolean semantics",
-            "input": "K = fill(false, [2 2], 'logical')",
-            "output": "K = [0 0; 0 0]"
+            "description": "Create one independently addressable Patch per matrix column",
+            "input": "X = uint64([0 2; 1 3; 0 2]);\nY = uint64([0 0; 0 0; 1 1]);\nC = uint16([1 4; 2 5; 3 6]);\nh = fill(X,Y,C);",
+            "output": "h is a two-element Patch handle vector; each handle retains its column's typed XData, YData, and CData"
         }
     ],
     "faqs": [
         {
-            "question": "Which argument order does `fill` support?",
-            "answer": "The first argument is always the scalar value. Remaining arguments specify dimensions, size vectors, or options (`'logical'`, `'like'`, `'double'`, `'complex'`)."
-        },
-        {
-            "question": "Does `fill` accept non-scalar values?",
-            "answer": "No. The fill value must be numeric, logical, or complex scalar. Use `repmat` when you need to tile an array."
-        },
-        {
-            "question": "How does `fill` behave with complex values?",
-            "answer": "If you request complex output (explicitly or via `'like'`), the real and imaginary parts are copied verbatim. Otherwise the imaginary component must be zero."
-        },
-        {
-            "question": "How do logical arrays handle nonzero values?",
-            "answer": "Logical outputs treat any nonzero real or complex magnitude as `true`, matching MATLAB semantics."
-        },
-        {
-            "question": "Can I match GPU residency automatically?",
-            "answer": "Yes. Pass a GPU prototype via `'like'` and `fill` will allocate on the device. It falls back to host allocation and upload when the provider cannot construct the constant directly."
-        },
-        {
-            "question": "What happens when I omit dimensions?",
-            "answer": "If you only pass the value, `fill` returns a scalar. When you pass a prototype (e.g., `fill(v, A)`), the prototype shape is reused. Otherwise RunMat follows MATLAB's default of `1 × 1`."
-        },
-        {
-            "question": "Are string or char outputs supported?",
-            "answer": "Not yet. `fill` currently targets numeric, logical, and complex arrays. Use string-manipulation functions for text."
-        },
-        {
-            "question": "How do I create empty outputs?",
-            "answer": "Include a zero dimension (`fill(value, 0, n)` or `fill(value, [0 n])`). RunMat returns an empty array of the requested size and type."
-        },
-        {
-            "question": "Does `fill` honour `'single'` outputs?",
-            "answer": "Single precision outputs are not implemented yet. The function returns an error mirroring other array creation builtins."
-        },
-        {
-            "question": "Is the GPU path deterministic?",
-            "answer": "Yes. Providers either execute the constant fill entirely on the GPU or RunMat uploads a deterministic host tensor, ensuring identical results."
+            "question": "Is fill an array-construction function?",
+            "answer": "No. MATLAB-compatible fill creates Patch graphics. Use createArray to construct constant-valued arrays."
         }
     ],
     "links": [
         {
-            "label": "zeros",
-            "url": "./zeros"
-        },
-        {
-            "label": "ones",
-            "url": "./ones"
-        },
-        {
-            "label": "repmat",
-            "url": "./repmat"
-        },
-        {
-            "label": "gpuArray",
-            "url": "./gpuarray"
-        },
-        {
-            "label": "gather",
-            "url": "./gather"
-        },
-        {
-            "label": "colon",
-            "url": "./colon"
-        },
-        {
-            "label": "eye",
-            "url": "./eye"
-        },
-        {
-            "label": "false",
-            "url": "./false"
+            "label": "fill3",
+            "url": "./fill3"
         },
         {
-            "label": "linspace",
-            "url": "./linspace"
+            "label": "patch",
+            "url": "./patch"
         },
         {
-            "label": "logspace",
-            "url": "./logspace"
-        },
-        {
-            "label": "magic",
-            "url": "./magic"
-        },
-        {
-            "label": "meshgrid",
-            "url": "./meshgrid"
-        },
-        {
-            "label": "rand",
-            "url": "./rand"
-        },
-        {
-            "label": "randi",
-            "url": "./randi"
-        },
-        {
-            "label": "randn",
-            "url": "./randn"
-        },
-        {
-            "label": "randperm",
-            "url": "./randperm"
-        },
-        {
-            "label": "range",
-            "url": "./range"
-        },
-        {
-            "label": "true",
-            "url": "./true"
+            "label": "createArray",
+            "url": "./createArray"
         }
     ],
     "source": {
-        "label": "`crates/runmat-runtime/src/builtins/array/creation/fill.rs`",
-        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/array/creation/fill.rs"
+        "label": "`crates/runmat-runtime/src/builtins/plotting/ops/fill.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/plotting/ops/fill.rs"
     },
-    "gpu_residency": "```matlab:runnable\nA = rand(512, 512);\nJ = fill(0.5, size(A), 'like', gpuArray(A));\n```\n\nExpected output:\n\n```matlab\nisa(J, 'gpuArray')  % true\n```",
-    "gpu_behavior": [
-        "RunMat asks the active acceleration provider to materialise the constant directly via the dedicated `fill` hook. Providers that do not supply this capability fall back to a zero buffer plus scalar add or, as a last resort, upload the fully materialised host tensor. This guarantees MATLAB-compatible results while still benefiting from GPU residency whenever possible."
-    ],
     "key": "fill",
     "slug": "fill",
     "aliases": [],
     "categoryPath": [
-        "array",
-        "creation"
+        "plotting"
     ]
 };
 export default builtinDoc;

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

@@ -1 +1 @@
-{"version":3,"file":"fill.js","sourceRoot":"","sources":["../../../src/generated/builtins/fill.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fill.js","sourceRoot":"","sources":["../../../src/generated/builtins/fill.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,OAAO;QACP,SAAS;QACT,KAAK;KACN;IACD,SAAS,EAAE,oCAAoC;IAC/C,aAAa,EAAE,uNAAuN;IACtO,WAAW,EAAE;QACX,oKAAoK;QACpK,mLAAmL;QACnL,uDAAuD;QACvD,mEAAmE;QACnE,wEAAwE;QACxE,sIAAsI;KACvI;IACD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,iHAAiH;KAC3H;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,iCAAiC;KAC1C;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,0BAA0B;YACzC,OAAO,EAAE,oCAAoC;YAC7C,QAAQ,EAAE,8BAA8B;SACzC;QACD;YACE,aAAa,EAAE,sDAAsD;YACrE,OAAO,EAAE,uDAAuD;YAChE,QAAQ,EAAE,qCAAqC;SAChD;QACD;YACE,aAAa,EAAE,8DAA8D;YAC7E,OAAO,EAAE,4GAA4G;YACrH,QAAQ,EAAE,wGAAwG;SACnH;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,yCAAyC;YACrD,QAAQ,EAAE,yGAAyG;SACpH;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,aAAa;YACtB,KAAK,EAAE,eAAe;SACvB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,2DAA2D;QACpE,KAAK,EAAE,wGAAwG;KAChH;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/fill3.d.ts.map

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

package/dist/generated/builtins/fill3.js

@@ -20,7 +20,7 @@ const builtinDoc = {
             "double"
         ],
         "broadcasting": "none",
-        "notes": "`fill3` is a plotting sink. It lowers coordinate and color argument groups to `patch` objects, gathering GPU-resident coordinate inputs through the shared patch path."
+        "notes": "`fill3` is a plotting sink. It gathers GPU-resident coordinate and CData inputs exactly through their owning providers, then lowers each vector or matrix column to an independent Patch object."
     },
     "fusion": {
         "elementwise": false,
@@ -35,15 +35,17 @@ const builtinDoc = {
     "description": "`fill3` creates filled polygon patch objects from X, Y, and Z coordinate data in 3-D axes. It reuses the shared patch pipeline, so handle behavior and patch name-value properties follow MATLAB semantics.",
     "behaviors": [
         "`fill3(X, Y, Z, C)` creates one or more 3-D filled polygons from matching coordinate arrays.",
-        "Vector coordinate inputs create one polygon.",
-        "Matrix coordinate inputs create one polygon per column through the underlying `patch` parser.",
+        "Equal-length row or column vector coordinate inputs create one polygon regardless of orientation.",
+        "When any coordinate is a matrix, coordinate vectors matching its row count are shared across its columns; square matrices are deterministically grouped by columns.",
+        "Matrix coordinate inputs create one independently addressable Patch object per column and return one handle per column.",
         "Multiple `X,Y,Z,C` groups in one call create multiple patch objects and return a row vector of patch handles.",
         "A single polygon group returns a scalar patch handle.",
         "`fill3` initializes the target axes with the standard 3-D view, so even polygons in the z=0 plane render as 3-D patch content.",
         "Trailing patch property name-value pairs are applied to every polygon group in the call.",
         "The returned patch handles work with `get`, `set`, `ishandle`, and `isgraphics`.",
         "Color strings and RGB triples are supported through the shared patch color parser.",
-        "Indexed or interpolated CData behavior is currently limited by the underlying `patch` implementation; concrete color strings, RGB triples, and common patch properties are the supported color path."
+        "Numeric C is retained as authoritative CData for indexed color mapping; color strings and RGB triples use the shared Patch color parser.",
+        "Integer XData, YData, ZData, and CData preserve their original class, exact values, and shape independently of renderer geometry."
     ],
     "options": [
         "`FaceColor` accepts color names, RGB triples, `flat`, or `none` through `patch`.",
@@ -90,7 +92,7 @@ const builtinDoc = {
         },
         {
             "question": "Does fill3 support indexed CData?",
-            "answer": "The current implementation is constrained by `patch`: color strings and RGB triples are supported, while full MATLAB indexed/interpolated CData behavior is deferred."
+            "answer": "Yes. Numeric scalar, vector, and matrix C inputs are retained as Patch CData. Renderer colormap fidelity continues to share the Patch renderer implementation."
         }
     ],
     "links": [

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

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

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

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

package/dist/generated/builtins/fillmissing.js

@@ -33,13 +33,16 @@ const builtinDoc = {
         "unit": "builtins::missing::tests",
         "integration": "crates/runmat-vm/tests/missing_values.rs"
     },
-    "description": "`fillmissing(A, method, ...)` replaces missing values while preserving the input shape.",
+    "description": "`fillmissing(A, method, ...)` replaces supported missing values while preserving the input shape. Typed-integer input is a mode-gated RunMat extension: integer classes have no standard missing value, so the result is an exact same-class no-op and the optional filled-entry mask is all false. Integer data nested in table variables or cell contents is a separately declared aggregate extension and is classified before resident children are gathered.",
     "behaviors": [
         "Numeric arrays support `\"constant\"`, `\"previous\"`, `\"next\"`, `\"nearest\"`, `\"linear\"`, `\"mean\"`, and `\"median\"`.",
         "String arrays support `\"constant\"`, `\"previous\"`, `\"next\"`, and `\"nearest\"`.",
         "Cell arrays support `\"constant\"` replacement.",
         "Tables apply filling variable-by-variable and return a table plus an optional logical mask; incompatible variable/method combinations report an error.",
-        "The optional dimension argument may be supplied as `1`, `2`, or as a `\"dim\", value` pair. Without an explicit dimension, the first non-singleton dimension is used."
+        "The optional dimension argument may be supplied as `1`, `2`, or as a `\"dim\", value` pair. Without an explicit dimension, the first non-singleton dimension is used.",
+        "The optional logical mask marks entries that were actually filled; missing endpoints left unchanged by a neighbor method are false.",
+        "Complex and sparse array filling is not implemented and is rejected instead of replacing an aggregate value.",
+        "Current general gaps include `\"spline\"`, `\"pchip\"`, `\"makima\"`, `\"mode\"`, moving-window, KNN, custom-function, sample-point, known-location, maximum-gap, variable-selection, and append forms."
     ],
     "examples": [
         {

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

@@ -1 +1 @@
-{"version":3,"file":"fillmissing.js","sourceRoot":"","sources":["../../../src/generated/builtins/fillmissing.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,aAAa;IACtB,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE;QACV,aAAa;QACb,SAAS;QACT,KAAK;QACL,QAAQ;QACR,OAAO;QACP,UAAU;QACV,UAAU;QACV,MAAM;QACN,QAAQ;KACT;IACD,SAAS,EAAE,mFAAmF;IAC9F,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,yCAAyC;KACnD;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,0BAA0B;QAClC,aAAa,EAAE,0CAA0C;KAC1D;IACD,aAAa,EAAE,yFAAyF;IACxG,WAAW,EAAE;QACX,+HAA+H;QAC/H,sFAAsF;QACtF,iDAAiD;QACjD,wJAAwJ;QACxJ,uKAAuK;KACxK;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,uBAAuB;YACtC,OAAO,EAAE,sCAAsC;YAC/C,QAAQ,EAAE,aAAa;SACxB;QACD;YACE,aAAa,EAAE,sBAAsB;YACrC,OAAO,EAAE,2CAA2C;YACpD,QAAQ,EAAE,aAAa;SACxB;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;QACD;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;QACD;YACE,OAAO,EAAE,oBAAoB;YAC7B,KAAK,EAAE,sBAAsB;SAC9B;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,qDAAqD;QAC9D,KAAK,EAAE,kGAAkG;KAC1G;IACD,KAAK,EAAE,aAAa;IACpB,MAAM,EAAE,aAAa;IACrB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"fillmissing.js","sourceRoot":"","sources":["../../../src/generated/builtins/fillmissing.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,aAAa;IACtB,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE;QACV,aAAa;QACb,SAAS;QACT,KAAK;QACL,QAAQ;QACR,OAAO;QACP,UAAU;QACV,UAAU;QACV,MAAM;QACN,QAAQ;KACT;IACD,SAAS,EAAE,mFAAmF;IAC9F,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,yCAAyC;KACnD;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,0BAA0B;QAClC,aAAa,EAAE,0CAA0C;KAC1D;IACD,aAAa,EAAE,mcAAmc;IACld,WAAW,EAAE;QACX,+HAA+H;QAC/H,sFAAsF;QACtF,iDAAiD;QACjD,wJAAwJ;QACxJ,uKAAuK;QACvK,qIAAqI;QACrI,8GAA8G;QAC9G,yMAAyM;KAC1M;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,uBAAuB;YACtC,OAAO,EAAE,sCAAsC;YAC/C,QAAQ,EAAE,aAAa;SACxB;QACD;YACE,aAAa,EAAE,sBAAsB;YACrC,OAAO,EAAE,2CAA2C;YACpD,QAAQ,EAAE,aAAa;SACxB;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;QACD;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;QACD;YACE,OAAO,EAAE,oBAAoB;YAC7B,KAAK,EAAE,sBAAsB;SAC9B;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,qDAAqD;QAC9D,KAAK,EAAE,kGAAkG;KAC1G;IACD,KAAK,EAAE,aAAa;IACpB,MAAM,EAAE,aAAa;IACrB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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

package/dist/generated/builtins/filloutliers.js

@@ -20,13 +20,16 @@ const builtinDoc = {
         "[B,TF] = filloutliers(___)",
         "[B,TF,L,U,C] = filloutliers(___)"
     ],
-    "description": "`filloutliers` detects numeric outliers and replaces them using a requested fill method. RunMat supports numeric arrays, default dimension reduction, the common outlier detection methods shared with `isoutlier`, array `OutlierLocations`, and scalar threshold outputs.",
+    "description": "`filloutliers` detects outliers in supported dense real arrays and replaces them using a requested fill method. Documented single and double inputs preserve their class. Typed-integer input is a mode-gated RunMat extension with a deliberate double statistics/result boundary. Integer arrays are admitted only when their exact value span is at most 2^53; wider spans are rejected instead of collapsing distinct observations.",
     "notes": [
         "Supported fill methods are `\"center\"`, `\"clip\"`, `\"previous\"`, `\"next\"`, `\"nearest\"`, `\"linear\"`, and numeric scalar constants.",
         "Supported detection methods are `\"median\"`, `\"mean\"`, `\"quartiles\"`, `\"percentiles\"`, `\"movmedian\"`, and `\"movmean\"`.",
-        "`[B,TF,L,U,C]` returns the filled array, detected outlier mask, lower threshold, upper threshold, and center value.",
-        "`OutlierLocations` accepts a logical or numeric array mask with the same number of elements as the input.",
-        "Spline-like interpolation methods, `SamplePoints`, and table/timetable-specific options are reported as unsupported instead of approximated."
+        "`[B,TF,L,U,C]` returns the filled array, actually filled-entry mask, lower threshold, upper threshold, and center value.",
+        "Documented `OutlierLocations` logical masks must have exactly the same shape as the input. Numeric masks are a separately mode-gated RunMat extension.",
+        "Typed-integer constant fill scalars and direct provider-resident inputs or arguments are independent mode-gated extensions and are classified before gather.",
+        "`OutlierLocations` cannot be combined with an explicitly specified outlier detection method.",
+        "Integer input produces double `B`, `L`, `U`, and `C` and logical `TF`. Authoritative storage is anchored before conversion, and the exact span guard ensures every admitted integer observation remains distinct at that boundary.",
+        "Spline-like interpolation methods, Grubbs/GESD detection, vector or duration windows, `SamplePoints`, `MaxNumOutliers`, and table/timetable-specific options are reported as unsupported instead of approximated."
     ],
     "examples": [
         {

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

@@ -1 +1 @@
-{"version":3,"file":"filloutliers.js","sourceRoot":"","sources":["../../../src/generated/builtins/filloutliers.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,MAAM;QACN,QAAQ;QACR,WAAW;QACX,MAAM;QACN,YAAY;KACb;IACD,SAAS,EAAE,kCAAkC;IAC7C,YAAY,EAAE;QACZ,gCAAgC;QAChC,2CAA2C;QAC3C,+CAA+C;QAC/C,4BAA4B;QAC5B,kCAAkC;KACnC;IACD,aAAa,EAAE,6QAA6Q;IAC5R,OAAO,EAAE;QACP,6IAA6I;QAC7I,mIAAmI;QACnI,qHAAqH;QACrH,2GAA2G;QAC3G,8IAA8I;KAC/I;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,0BAA0B;YACzC,OAAO,EAAE,4CAA4C;SACtD;QACD;YACE,aAAa,EAAE,+BAA+B;YAC9C,OAAO,EAAE,uBAAuB;SACjC;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;QACD;YACE,OAAO,EAAE,aAAa;YACtB,KAAK,EAAE,eAAe;SACvB;KACF;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":"filloutliers.js","sourceRoot":"","sources":["../../../src/generated/builtins/filloutliers.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,MAAM;QACN,QAAQ;QACR,WAAW;QACX,MAAM;QACN,YAAY;KACb;IACD,SAAS,EAAE,kCAAkC;IAC7C,YAAY,EAAE;QACZ,gCAAgC;QAChC,2CAA2C;QAC3C,+CAA+C;QAC/C,4BAA4B;QAC5B,kCAAkC;KACnC;IACD,aAAa,EAAE,yaAAya;IACxb,OAAO,EAAE;QACP,6IAA6I;QAC7I,mIAAmI;QACnI,0HAA0H;QAC1H,wJAAwJ;QACxJ,8JAA8J;QAC9J,8FAA8F;QAC9F,oOAAoO;QACpO,mNAAmN;KACpN;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,0BAA0B;YACzC,OAAO,EAAE,4CAA4C;SACtD;QACD;YACE,aAAa,EAAE,+BAA+B;YAC9C,OAAO,EAAE,uBAAuB;SACjC;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,aAAa;SACrB;QACD;YACE,OAAO,EAAE,aAAa;YACtB,KAAK,EAAE,eAAe;SACvB;KACF;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/filter.js

@@ -37,8 +37,8 @@ const builtinDoc = {
     "behaviors": [
         "`filter(b, a, X)` applies the filter along the first non-singleton dimension of `X` (column-wise for matrices).",
         "The numerator `b` and denominator `a` must be non-empty vectors. `a(1)` must be non-zero; the runtime divides both coefficient vectors by `a(1)` automatically.",
-        "Optional initial conditions `zi` must have the same size as the output `zf` (the dimension being filtered is replaced by `max(numel(b), numel(a)) - 1`). Use `[]` to indicate zero initial state.",
-        "`filter(b, a, X, zi, dim)` processes `X` along dimension `dim`. Dimensions beyond `ndims(X)` are treated as length-one axes, exactly as in MATLAB.",
+        "Optional initial conditions `zi` must have the same size as the output `zf`: filter order first, followed by the non-operated dimensions of `X`. Use `[]` to indicate zero initial state.",
+        "`filter(b, a, X, zi, dim)` processes `X` along dimension `dim`. Dimensions beyond `ndims(X)` are treated as length-one axes. Filter states place filter order first, followed by the non-operated dimensions of `X`.",
         "Complex coefficients or inputs are supported; results follow MATLAB semantics for real/imaginary propagation.",
         "The function returns a single output `y` by default. Request two outputs (`[y, zf] = filter(...)`) to obtain the final internal states `zf`."
     ],
@@ -81,7 +81,7 @@ const builtinDoc = {
         },
         {
             "question": "How large should `zi` be?",
-            "answer": "`zi` must have the same size as `zf` (the returned final state). Replace the filtered dimension with `max(numel(b), numel(a)) - 1`; all other dimensions match `X`. Use `[]` for a zero state."
+            "answer": "`zi` must have the same size as `zf` (the returned final state). Its leading dimension is `max(numel(b), numel(a)) - 1`, followed by the non-operated dimensions of `X`. For vector input, `zf` is a column vector. Use `[]` for a zero state."
         },
         {
             "question": "Can I filter along a dimension greater than `ndims(X)`?",
@@ -93,11 +93,11 @@ const builtinDoc = {
         },
         {
             "question": "Do I need to initialise the GPU path manually?",
-            "answer": "No. If the signal is a `gpuArray` value and the active provider supports `iir_filter`, RunMat keeps the entire computation on the device. Otherwise, the runtime gathers operands to the host, ensuring MATLAB-compatible results without extra user code."
+            "answer": "No. If the signal is a `gpuArray` value, its owning provider supports `iir_filter`, and filtering uses the leading dimension, RunMat keeps the computation on the device. Other dimensions currently use the host fallback so final-state layout remains MATLAB-compatible."
         },
         {
             "question": "What shape does `zf` have?",
-            "answer": "`zf` matches `zi` (or the default zero state). The filtered dimension is replaced by `max(numel(b), numel(a)) - 1`; other dimensions mirror the input."
+            "answer": "`zf` matches `zi` (or the default zero state). Filter order is the leading dimension; remaining dimensions correspond to the non-operated dimensions of the input."
         },
         {
             "question": "How are empty signals handled?",

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

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

package/dist/generated/builtins/filter2.js

@@ -32,14 +32,14 @@ const builtinDoc = {
         "unit": "builtins::image::filters::filter2::tests",
         "integration": "builtins::image::filters::filter2::tests::filter2_gpu_matches_cpu"
     },
-    "description": "`filter2(H, X)` performs 2-D correlation of matrix or image data `X` with kernel `H`. By default it returns a result the same size as `X`, and shape/convolution-mode options follow MATLAB semantics. It matches `conv2(X, rot90(H, 2), 'same')` in default mode.",
+    "description": "`filter2(H, X)` performs 2-D correlation of matrix or image data `X` with kernel `H`. The documented compatibility surface accepts the `same`, `full`, and `valid` shape options. RunMat mode additionally exposes explicit `conv` and `corr` flags. The default matches `conv2(X, rot90(H, 2), 'same')`.",
     "behaviors": [
         "The first argument is the kernel and the second is the image or matrix being filtered.",
         "The default configuration performs correlation with zero padding and `'same'` output sizing.",
         "Passing `'full'` or `'valid'` as the third argument switches the output size to the full convolution result or the strictly valid interior, respectively.",
-        "Supplying `'conv'` rotates the kernel by 180° so the operation matches MATLAB convolution. Use `'corr'` for an explicit correlation request; it is the default.",
+        "In RunMat extension mode, supplying `'conv'` rotates the kernel by 180° and `'corr'` explicitly requests the default correlation behavior. These flags are not part of MATLAB's `filter2` signature.",
         "Inputs may be numeric or logical. Logical arrays are promoted to double precision prior to filtering.",
-        "Both arguments may be gpuArray handles; RunMat keeps them on the device whenever the active acceleration provider exposes the `imfilter` hook."
+        "Single- and double-precision arguments may be gpuArray handles. Integer and logical gpuArray inputs are separately gated RunMat extensions and gather before floating filtering; they never enter floating provider shaders as native integer buffers."
     ],
     "examples": [
         {
@@ -83,7 +83,7 @@ const builtinDoc = {
         },
         {
             "question": "Can I combine `filter2` with gpuArray inputs?",
-            "answer": "Yes. If either argument is a gpuArray, RunMat forwards the computation to the active acceleration provider and only gathers the data when the provider hook is unavailable."
+            "answer": "Yes. A resident image selects its owning provider. RunMat uploads or transfers the kernel to that provider when possible and gathers operands only when the provider hook cannot execute the operation."
         },
         {
             "question": "Does `filter2` support higher-dimensional arrays?",

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

@@ -1 +1 @@
-{"version":3,"file":"filter2.js","sourceRoot":"","sources":["../../../src/generated/builtins/filter2.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,eAAe;IAC3B,UAAU,EAAE;QACV,SAAS;QACT,aAAa;QACb,aAAa;QACb,iBAAiB;QACjB,KAAK;KACN;IACD,SAAS,EAAE,iEAAiE;IAC5E,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,mHAAmH;KAC7H;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,aAAa,EAAE,mEAAmE;KACnF;IACD,aAAa,EAAE,oQAAoQ;IACnR,WAAW,EAAE;QACX,wFAAwF;QACxF,8FAA8F;QAC9F,2JAA2J;QAC3J,iKAAiK;QACjK,uGAAuG;QACvG,gJAAgJ;KACjJ;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,sCAAsC;YACrD,OAAO,EAAE,iEAAiE;YAC1E,QAAQ,EAAE,qGAAqG;SAChH;QACD;YACE,aAAa,EAAE,wCAAwC;YACvD,OAAO,EAAE,6DAA6D;YACtE,QAAQ,EAAE,iEAAiE;SAC5E;QACD;YACE,aAAa,EAAE,8CAA8C;YAC7D,OAAO,EAAE,yDAAyD;YAClE,QAAQ,EAAE,iEAAiE;SAC5E;QACD;YACE,aAAa,EAAE,+BAA+B;YAC9C,OAAO,EAAE,wEAAwE;YACjF,QAAQ,EAAE,iEAAiE;SAC5E;QACD;YACE,aAAa,EAAE,mCAAmC;YAClD,OAAO,EAAE,uHAAuH;YAChI,QAAQ,EAAE,sEAAsE;SACjF;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,kDAAkD;YAC9D,QAAQ,EAAE,mJAAmJ;SAC9J;QACD;YACE,UAAU,EAAE,wCAAwC;YACpD,QAAQ,EAAE,iIAAiI;SAC5I;QACD;YACE,UAAU,EAAE,wDAAwD;YACpE,QAAQ,EAAE,qNAAqN;SAChO;QACD;YACE,UAAU,EAAE,+CAA+C;YAC3D,QAAQ,EAAE,6KAA6K;SACxL;QACD;YACE,UAAU,EAAE,mDAAmD;YAC/D,QAAQ,EAAE,2KAA2K;SACtL;QACD;YACE,UAAU,EAAE,yCAAyC;YACrD,QAAQ,EAAE,8FAA8F;SACzG;QACD;YACE,UAAU,EAAE,mDAAmD;YAC/D,QAAQ,EAAE,4HAA4H;SACvI;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,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,6DAA6D;QACtE,KAAK,EAAE,6DAA6D;KACrE;IACD,eAAe,EAAE,mXAAmX;IACpY,cAAc,EAAE;QACd,meAAme;KACpe;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"filter2.js","sourceRoot":"","sources":["../../../src/generated/builtins/filter2.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,eAAe;IAC3B,UAAU,EAAE;QACV,SAAS;QACT,aAAa;QACb,aAAa;QACb,iBAAiB;QACjB,KAAK;KACN;IACD,SAAS,EAAE,iEAAiE;IAC5E,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,mHAAmH;KAC7H;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,aAAa,EAAE,mEAAmE;KACnF;IACD,aAAa,EAAE,2SAA2S;IAC1T,WAAW,EAAE;QACX,wFAAwF;QACxF,8FAA8F;QAC9F,2JAA2J;QAC3J,sMAAsM;QACtM,uGAAuG;QACvG,wPAAwP;KACzP;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,sCAAsC;YACrD,OAAO,EAAE,iEAAiE;YAC1E,QAAQ,EAAE,qGAAqG;SAChH;QACD;YACE,aAAa,EAAE,wCAAwC;YACvD,OAAO,EAAE,6DAA6D;YACtE,QAAQ,EAAE,iEAAiE;SAC5E;QACD;YACE,aAAa,EAAE,8CAA8C;YAC7D,OAAO,EAAE,yDAAyD;YAClE,QAAQ,EAAE,iEAAiE;SAC5E;QACD;YACE,aAAa,EAAE,+BAA+B;YAC9C,OAAO,EAAE,wEAAwE;YACjF,QAAQ,EAAE,iEAAiE;SAC5E;QACD;YACE,aAAa,EAAE,mCAAmC;YAClD,OAAO,EAAE,uHAAuH;YAChI,QAAQ,EAAE,sEAAsE;SACjF;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,kDAAkD;YAC9D,QAAQ,EAAE,mJAAmJ;SAC9J;QACD;YACE,UAAU,EAAE,wCAAwC;YACpD,QAAQ,EAAE,iIAAiI;SAC5I;QACD;YACE,UAAU,EAAE,wDAAwD;YACpE,QAAQ,EAAE,qNAAqN;SAChO;QACD;YACE,UAAU,EAAE,+CAA+C;YAC3D,QAAQ,EAAE,yMAAyM;SACpN;QACD;YACE,UAAU,EAAE,mDAAmD;YAC/D,QAAQ,EAAE,2KAA2K;SACtL;QACD;YACE,UAAU,EAAE,yCAAyC;YACrD,QAAQ,EAAE,8FAA8F;SACzG;QACD;YACE,UAAU,EAAE,mDAAmD;YAC/D,QAAQ,EAAE,4HAA4H;SACvI;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,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,6DAA6D;QACtE,KAAK,EAAE,6DAA6D;KACrE;IACD,eAAe,EAAE,mXAAmX;IACpY,cAAc,EAAE;QACd,meAAme;KACpe;IACD,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,SAAS;KACV;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/filtfilt.js

@@ -36,9 +36,9 @@ const builtinDoc = {
     "description": "`filtfilt(b, a, x)` filters a vector forward and backward to remove phase delay. Coefficients follow the same digital-filter convention as `filter`: `b` is the numerator, `a` is the denominator, and `a(1)` is normalized internally.",
     "behaviors": [
         "The v1 implementation supports vector signals and preserves row or column orientation.",
-        "RunMat uses odd reflection at both signal edges with `3 * (max(numel(a), numel(b)) - 1)` samples, matching the common MATLAB-compatible zero-phase filtering path.",
+        "The three-argument path uses constant steady-state initialization and linear endpoint continuation with `3 * (max(numel(a), numel(b)) - 1)` transient samples, matching the compatibility target's defaults for the implemented coefficient-vector/vector-signal form.",
         "Input length must be greater than the reflection length unless the filter has zero state.",
-        "Real gpuArray inputs use provider-backed filter passes when available; complex inputs fall back to the host reference path."
+        "Real floating gpuArray inputs use provider-backed filter passes when available; complex inputs fall back to the host reference path. Typed-integer and logical inputs are independently gated RunMat-only extensions. Calls containing a single input retain single output; integer/logical-only calls produce double output."
     ],
     "examples": [
         {

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

@@ -1 +1 @@
-{"version":3,"file":"filtfilt.js","sourceRoot":"","sources":["../../../src/generated/builtins/filtfilt.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,UAAU;IACnB,UAAU,EAAE,aAAa;IACzB,UAAU,EAAE;QACV,UAAU;QACV,QAAQ;QACR,YAAY;QACZ,KAAK;QACL,KAAK;QACL,KAAK;KACN;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,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,yCAAyC;QACjD,KAAK,EAAE,0DAA0D;KAClE;IACD,aAAa,EAAE,yOAAyO;IACxP,WAAW,EAAE;QACX,wFAAwF;QACxF,oKAAoK;QACpK,2FAA2F;QAC3F,6HAA6H;KAC9H;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,oDAAoD;YACnE,OAAO,EAAE,oJAAoJ;YAC7J,QAAQ,EAAE,eAAe;SAC1B;QACD;YACE,aAAa,EAAE,wCAAwC;YACvD,OAAO,EAAE,+DAA+D;SACzE;QACD;YACE,aAAa,EAAE,wCAAwC;YACvD,OAAO,EAAE,0FAA0F;SACpG;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,4CAA4C;YACxD,QAAQ,EAAE,6KAA6K;SACxL;QACD;YACE,UAAU,EAAE,mCAAmC;YAC/C,QAAQ,EAAE,kJAAkJ;SAC7J;QACD;YACE,UAAU,EAAE,4CAA4C;YACxD,QAAQ,EAAE,qHAAqH;SAChI;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,8DAA8D;QACvE,KAAK,EAAE,2GAA2G;KACnH;IACD,cAAc,EAAE;QACd,wIAAwI;QACxI,4IAA4I;KAC7I;IACD,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,QAAQ;KACT;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"filtfilt.js","sourceRoot":"","sources":["../../../src/generated/builtins/filtfilt.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,UAAU;IACnB,UAAU,EAAE,aAAa;IACzB,UAAU,EAAE;QACV,UAAU;QACV,QAAQ;QACR,YAAY;QACZ,KAAK;QACL,KAAK;QACL,KAAK;KACN;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,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,yCAAyC;QACjD,KAAK,EAAE,0DAA0D;KAClE;IACD,aAAa,EAAE,yOAAyO;IACxP,WAAW,EAAE;QACX,wFAAwF;QACxF,wQAAwQ;QACxQ,2FAA2F;QAC3F,+TAA+T;KAChU;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,oDAAoD;YACnE,OAAO,EAAE,oJAAoJ;YAC7J,QAAQ,EAAE,eAAe;SAC1B;QACD;YACE,aAAa,EAAE,wCAAwC;YACvD,OAAO,EAAE,+DAA+D;SACzE;QACD;YACE,aAAa,EAAE,wCAAwC;YACvD,OAAO,EAAE,0FAA0F;SACpG;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,4CAA4C;YACxD,QAAQ,EAAE,6KAA6K;SACxL;QACD;YACE,UAAU,EAAE,mCAAmC;YAC/C,QAAQ,EAAE,kJAAkJ;SAC7J;QACD;YACE,UAAU,EAAE,4CAA4C;YACxD,QAAQ,EAAE,qHAAqH;SAChI;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,UAAU;SAClB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,8DAA8D;QACvE,KAAK,EAAE,2GAA2G;KACnH;IACD,cAAc,EAAE;QACd,wIAAwI;QACxI,4IAA4I;KAC7I;IACD,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,MAAM;QACN,QAAQ;KACT;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

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